Internals

Slides rendering flow

GitHub Edit page

Slides Rendering Flow

Two main paths.

#CLI / terminal

  • src/run/flows/url/slides-output.ts

    • Public construction + orchestration only.

  • slides-output-state.ts

    • Slide timeline state. Waiters. Finalization.

  • slides-output-render.ts

    • Terminal rendering. Inline-image policy. Debug path.

  • slides-output-stream.ts

    • Summary-stream parsing glue.

Rule: keep terminal I/O in render helpers; keep state mutations in the state store.

#Chrome extension

  • apps/chrome-extension/src/entrypoints/sidepanel/stream-controller.ts

    • Transport lifecycle.

  • stream-controller-policy.ts

    • Chunk/status terminal state rules.

  • apps/chrome-extension/src/lib/extension-logs.ts

    • Storage queue + flush only.

  • extension-log-format.ts

    • Pure log serialization/truncation.

Rule: push pure status/log logic out of adapters first.

#When debugging

  1. Check state transitions before DOM issues.
  2. Check stream policy before transport retry logic.
  3. Check cache/hydration helpers before blaming rendering.