playhead-cli 0.1.0

package/dist/compose/camera/interpolate.d.ts

@@ -0,0 +1,9 @@
+import type { CameraKeyframe } from '../types.js';
+import type { CameraState } from '../../shared/geometry.js';
+/**
+ * Sample the camera path at an output time. Keyframes are (time, state, ease-from-previous);
+ * holds are expressed as consecutive keyframes with identical states. Zoom interpolates in
+ * log space (linear zoom feels like it accelerates).
+ */
+export declare function sampleCamera(keyframes: CameraKeyframe[], tOut: number): CameraState;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/compose/camera/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../../src/compose/camera/interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAsBnF"}

package/dist/compose/camera/planner.d.ts

@@ -0,0 +1,19 @@
+import type { CameraKeyframe, OutputProfile, StepMapEntry } from '../types.js';
+import type { EventLog } from '../../capture/events.js';
+import { type Rect } from '../../shared/geometry.js';
+export interface CameraPlanResult {
+    keyframes: CameraKeyframe[];
+    fallbacks: string[];
+}
+/**
+ * Plan the camera path from measured step geometry. Craft rules: quantized zoom levels,
+ * legibility-driven zoom selection, caption-safe-area bias, pull-backs on navigation and
+ * long pans, and an analytic constraint pass that guarantees each target stays framed.
+ */
+export declare function planCamera(steps: StepMapEntry[], log: EventLog, profile: OutputProfile, durationMs: number, opts?: {
+    emphasis?: boolean;
+}): CameraPlanResult;
+/** The safe area, expressed in PLANE space (stage content coords when a stage is set): frame
+ *  margins translated into the content rect, with a small floor so it never collapses. */
+export declare function contentArea(profile: OutputProfile): Rect;
+//# sourceMappingURL=planner.d.ts.map

package/dist/compose/camera/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/compose/camera/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAGL,KAAK,IAAI,EASV,MAAM,0BAA0B,CAAC;AA6BlC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,gBAAgB,CA+ClB;AAwLD;0FAC0F;AAC1F,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAOxD"}

package/dist/compose/captions.d.ts

@@ -0,0 +1,22 @@
+import type { ActionEvent } from '../capture/events.js';
+/** Per-step text overrides from a LIVE spec, keyed by stepRef — the compose-time source of
+ *  truth for caption/narration text. The copies baked into events.json are only the record of
+ *  what was captured; preferring the live spec makes text edits a sub-second re-compose, never
+ *  a re-capture (capture once, compose forever — including the words). */
+export interface StepTexts {
+    caption?: string;
+    narration?: string;
+}
+/**
+ * Deterministic caption writer: turns a step + its recorded accessible label into
+ * instruction text. Text resolution: live-spec caption ?? captured caption ?? auto-written.
+ * Returns null for steps that produce no caption (expect/wait without caption).
+ */
+export declare function writeCaption(event: ActionEvent, texts?: StepTexts): string | null;
+/**
+ * The SPOKEN line for a step: live-spec narration ?? live-spec caption ?? captured narration ??
+ * the caption. Narration is unconstrained by the caption card, so a spec can show a terse
+ * on-screen label while the voice says the full sentence.
+ */
+export declare function writeNarration(event: ActionEvent, texts?: StepTexts): string | null;
+//# sourceMappingURL=captions.d.ts.map

package/dist/compose/captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.d.ts","sourceRoot":"","sources":["../../src/compose/captions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;0EAG0E;AAC1E,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BjF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAEnF"}

package/dist/compose/cursor/path.d.ts

@@ -0,0 +1,17 @@
+import type { CursorSegment, ClickRipple, StepMapEntry } from '../types.js';
+import type { EventLog } from '../../capture/events.js';
+import { type Point } from '../../shared/geometry.js';
+export interface CursorPlan {
+    segments: CursorSegment[];
+    ripples: ClickRipple[];
+    restStart: Point;
+}
+/**
+ * Re-synthesize cursor motion on the output clock: recorded waypoints give the path SHAPE,
+ * arrival is re-timed so the cursor lands on the target exactly at the action beat with a
+ * minimum-jerk profile.
+ */
+export declare function planCursor(steps: StepMapEntry[], log: EventLog): CursorPlan;
+/** Position of the cursor at an output time (viewport space). */
+export declare function sampleCursor(plan: CursorPlan, tOut: number): Point;
+//# sourceMappingURL=path.d.ts.map

package/dist/compose/cursor/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/compose/cursor/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,0BAA0B,CAAC;AAOnE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,UAAU,CAgC3E;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAsBlE"}

package/dist/compose/cursor/render.d.ts

@@ -0,0 +1,10 @@
+import type { SKRSContext2D } from '@napi-rs/canvas';
+import type { Point } from '../../shared/geometry.js';
+import type { ClickRipple } from '../types.js';
+import type { ResolvedTheme } from '../../theme/index.js';
+export type CursorGlyph = 'arrow' | 'ibeam';
+/** Draw the vector cursor at an output-space point.
+ *  `baseScale` (output px per viewport px) keeps the cursor proportioned to the UI it points
+ *  at — without it the cursor renders 1.5× too small against upscaled content. */
+export declare function drawCursor(ctx: SKRSContext2D, p: Point, zoom: number, tOut: number, ripples: ClickRipple[], rippleCenters: Point[], theme: ResolvedTheme, baseScale?: number, glyph?: CursorGlyph): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/compose/cursor/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/compose/cursor/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C;;kFAEkF;AAClF,wBAAgB,UAAU,CACxB,GAAG,EAAE,aAAa,EAClB,CAAC,EAAE,KAAK,EACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EAAE,EACtB,aAAa,EAAE,KAAK,EAAE,EACtB,KAAK,EAAE,aAAa,EACpB,SAAS,SAAI,EACb,KAAK,GAAE,WAAqB,GAC3B,IAAI,CAoEN"}

package/dist/compose/index.d.ts

@@ -0,0 +1,25 @@
+import type { BundleData } from '../bundle/types.js';
+import type { Spec } from '../spec/schema.js';
+import { type ResolvedTheme } from '../theme/index.js';
+import type { ComposeManifest, OutputProfile } from './types.js';
+import { type StepTexts } from './captions.js';
+export interface ComposeResult {
+    videoPath: string;
+    manifestPath: string;
+    manifest: ComposeManifest;
+}
+/** Pure planning: bundle + spec + theme → compose manifest. No rendering. */
+/** Per-step caption/narration text from the LIVE spec, keyed by stepRef — so text edits are a
+ *  re-compose, never a re-capture. */
+export declare function specStepTexts(spec: Spec): Map<string, StepTexts>;
+export declare function plan(bundle: BundleData, spec: Spec, theme?: ResolvedTheme, profile?: OutputProfile, audioMs?: Map<string, number>): ComposeManifest;
+export interface ComposeOptions {
+    outDir: string;
+    fileName?: string;
+    theme?: ResolvedTheme;
+    profile?: OutputProfile;
+}
+/** Full composition: plan + render + write manifest. Never touches the live app. */
+export declare function compose(bundle: BundleData, spec: Spec, opts: ComposeOptions): Promise<ComposeResult>;
+export declare function renderFromManifest(bundle: BundleData, manifest: ComposeManifest, videoPath: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/compose/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compose/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAsB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAYrF,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAK7E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,6EAA6E;AAC7E;sCACsC;AACtC,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAYhE;AAED,wBAAgB,IAAI,CAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,IAAI,EACV,KAAK,CAAC,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,eAAe,CA2HjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,oFAAoF;AACpF,wBAAsB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiE1G;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExH"}

package/dist/compose/kinds.d.ts

@@ -0,0 +1,27 @@
+import type { OutputKind } from '../spec/schema.js';
+export type CaptionStyle = 'instruction' | 'factual' | 'chapter';
+/** How a given output kind is composed — the same capture, a different treatment. */
+export interface KindProfile {
+    kind: OutputKind;
+    /** Default pacing when the spec doesn't set one. */
+    pacing: 'relaxed' | 'normal' | 'brisk';
+    /** Caption phrasing: instructional ("Click X"), factual repro ("Step 1 — click X"), or narrative. */
+    captionStyle: CaptionStyle;
+    /** Prefix each caption with its number ("1.", "2." …). */
+    numberedCaptions: boolean;
+    /** Draw a running elapsed-time clock (bug evidence). */
+    elapsedClock: boolean;
+    /** Insert a full-frame chapter card at each new scene (demo narrative structure). */
+    chapterCards: boolean;
+    /** Hold on the final state this long (ms) — bug-repro dwells on the defect. */
+    outroMs: number;
+    /** Typed input is shown as evidence even in fields that look sensitive (repro needs the values). */
+    showTypedInput: boolean;
+    /** Composition-driven camera emphasis + click spotlights. Off for bug-repro, which must stay
+     *  a literal record of the screen. */
+    cameraEmphasis: boolean;
+    /** Render footage on a stage (matte + rounded card + browser chrome) instead of edge-to-edge. */
+    stage: boolean;
+}
+export declare function kindProfile(kind: OutputKind): KindProfile;
+//# sourceMappingURL=kinds.d.ts.map

package/dist/compose/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/compose/kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,qGAAqG;IACrG,YAAY,EAAE,YAAY,CAAC;IAC3B,0DAA0D;IAC1D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,YAAY,EAAE,OAAO,CAAC;IACtB,qFAAqF;IACrF,YAAY,EAAE,OAAO,CAAC;IACtB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,cAAc,EAAE,OAAO,CAAC;IACxB;0CACsC;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,iGAAiG;IACjG,KAAK,EAAE,OAAO,CAAC;CAChB;AA0CD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAEzD"}

package/dist/compose/overlays/build.d.ts

@@ -0,0 +1,7 @@
+import type { CameraKeyframe, ComposeDiagnostics, OutputProfile, OverlayEntry, StepMapEntry } from '../types.js';
+import type { EventLog } from '../../capture/events.js';
+import type { ResolvedTheme } from '../../theme/index.js';
+import type { KindProfile } from '../kinds.js';
+import { type StepTexts } from '../captions.js';
+export declare function buildOverlays(steps: StepMapEntry[], log: EventLog, theme: ResolvedTheme, profile: OutputProfile, title: string, subtitle: string, titleCardEndMs: number, diagnostics: ComposeDiagnostics, kind: KindProfile, sceneTitles?: Map<string, string>, camera?: CameraKeyframe[], specTexts?: Map<string, StepTexts>): OverlayEntry[];
+//# sourceMappingURL=build.d.ts.map

package/dist/compose/overlays/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/compose/overlays/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkB9D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,WAAW,EACjB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,CAAC,EAAE,cAAc,EAAE,EACzB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GACjC,YAAY,EAAE,CAgGhB"}

package/dist/compose/overlays/draw.d.ts

@@ -0,0 +1,12 @@
+import type { SKRSContext2D } from '@napi-rs/canvas';
+import type { OutputProfile, OverlayEntry, TitleCardOverlay } from '../types.js';
+import type { ResolvedTheme } from '../../theme/index.js';
+export declare function drawOverlays(ctx: SKRSContext2D, overlays: OverlayEntry[], tOut: number, theme: ResolvedTheme, profile: OutputProfile): void;
+/** The failure clip's closing card: what step broke and why, in evidence red. */
+export declare function drawFailureCard(ctx: SKRSContext2D, card: {
+    stepRef: string;
+    message: string;
+    tStart: number;
+}, tOut: number, theme: ResolvedTheme, profile: OutputProfile): void;
+export declare function drawTitleCard(ctx: SKRSContext2D, card: TitleCardOverlay, tOut: number, theme: ResolvedTheme, profile: OutputProfile): void;
+//# sourceMappingURL=draw.d.ts.map

package/dist/compose/overlays/draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draw.d.ts","sourceRoot":"","sources":["../../../src/compose/overlays/draw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAkB,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,wBAAgB,YAAY,CAC1B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,aAAa,GACrB,IAAI,CAgDN;AAyHD,iFAAiF;AACjF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1D,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,aAAa,GACrB,IAAI,CA8CN;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,aAAa,GACrB,IAAI,CAyCN"}

package/dist/compose/overlays/text.d.ts

@@ -0,0 +1,18 @@
+import { type SKRSContext2D } from '@napi-rs/canvas';
+export declare function measureText(text: string, font: string): number;
+export interface WrapResult {
+    lines: string[];
+    fontPx: number;
+    widest: number;
+    shrunk: boolean;
+    truncated: boolean;
+}
+/**
+ * Greedy word-wrap with overflow as a first-class fact: try at fontPx; if the text needs
+ * more than maxLines, shrink once to minFontPx; if it still overflows, truncate the last
+ * line with an ellipsis AND report it — never silently clip.
+ */
+export declare function wrapText(text: string, fontFor: (px: number) => string, maxWidth: number, fontPx: number, minFontPx: number, maxLines: number): WrapResult;
+/** Rounded-rect path helper shared by overlay drawing. */
+export declare function roundRect(c: SKRSContext2D, x: number, y: number, w: number, h: number, r: number): void;
+//# sourceMappingURL=text.d.ts.map

package/dist/compose/overlays/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/compose/overlays/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AASnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,CAiBZ;AAuBD,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CASvG"}

package/dist/compose/render/encoder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Streaming H.264 encoder: raw RGBA frames in on stdin, MP4 out. Backpressure is
+ * respected — write() resolves only when the pipe can take more.
+ */
+export declare class Encoder {
+    private child;
+    private stderrTail;
+    private exit;
+    constructor(outPath: string, width: number, height: number, fps: number);
+    write(rgba: Buffer): Promise<void>;
+    finish(): Promise<void>;
+}
+//# sourceMappingURL=encoder.d.ts.map

package/dist/compose/render/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/compose/render/encoder.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,IAAI,CAAkB;IAE9B,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAoCtE;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvC;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAM5B;CACF"}

package/dist/compose/render/frameStore.d.ts

@@ -0,0 +1,27 @@
+import { type Canvas } from '@napi-rs/canvas';
+import type { BundleData } from '../../bundle/types.js';
+/**
+ * Timestamp-indexed source-frame store with an LRU of decoded frames and one-ahead
+ * prefetch. Access during a render is monotonic in time, so a small cache wins.
+ */
+export declare class FrameStore {
+    private readonly bundle;
+    private cache;
+    constructor(bundle: BundleData);
+    /** Decoded canvas for the frame that should be on screen at capture-relative tMs. */
+    frameForTime(tMs: number): Promise<Canvas>;
+    /**
+     * The frame at tMs plus its successor with a blend factor: the capture is ~20fps but output
+     * is 30fps, so nearest-frame playback holds each source frame in a 2-1-2-1 judder pattern.
+     * Blending adjacent frames during real motion smooths it without optical flow.
+     */
+    framePairForTime(tMs: number): Promise<{
+        a: Canvas;
+        b: Canvas | null;
+        mix: number;
+        gapMs: number;
+    }>;
+    private get;
+    private decode;
+}
+//# sourceMappingURL=frameStore.d.ts.map

package/dist/compose/render/frameStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameStore.d.ts","sourceRoot":"","sources":["../../../src/compose/render/frameStore.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD;;;GAGG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,KAAK,CAAsC;IAEnD,YAA6B,MAAM,EAAE,UAAU,EAAI;IAEnD,qFAAqF;IAC/E,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/C;IAED;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAUxG;IAED,OAAO,CAAC,GAAG;YAiBG,MAAM;CAUrB"}

package/dist/compose/render/renderer.d.ts

@@ -0,0 +1,5 @@
+import type { BundleData } from '../../bundle/types.js';
+import type { ComposeManifest } from '../types.js';
+/** Render the full output from a bundle + compose manifest. Pure playback of the plan. */
+export declare function renderVideo(bundle: BundleData, manifest: ComposeManifest, outPath: string): Promise<void>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/compose/render/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/compose/render/renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAkC,MAAM,aAAa,CAAC;AAmBnF,0FAA0F;AAC1F,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAoJf"}

package/dist/compose/timeline/pacing.d.ts

@@ -0,0 +1,36 @@
+import type { EventLog, ActionEvent, ActionKind } from '../../capture/events.js';
+import type { TimeSegment, StepMapEntry } from '../types.js';
+export interface PacingConfig {
+    factor: number;
+    titleCardMs: number;
+    introMaxMs: number;
+    outroMs: number;
+    idleGapMaxMs: number;
+    idleGapOutMs: number;
+    minStepMs: number;
+    maxTypeOutMs: number;
+    holds: Record<ActionKind, number>;
+}
+export declare function pacingConfig(mode: 'relaxed' | 'normal' | 'brisk', kind?: {
+    outroMs: number;
+}): PacingConfig;
+export interface TimelinePlan {
+    segments: TimeSegment[];
+    steps: StepMapEntry[];
+    durationMs: number;
+}
+/**
+ * Build the output timeline: title card, per-step source spans with compose-time
+ * pacing (idle-gap trimming, post-action freezes, min-step extension), and an
+ * outro hold on the final state.
+ */
+export declare function buildTimeline(log: EventLog, cfg: PacingConfig, audioMs?: Map<string, number>): TimelinePlan;
+/** Map an output time to a source time (null on card segments). */
+export declare function sampleSource(segments: TimeSegment[], tOut: number): {
+    srcAt: number | null;
+    segment: TimeSegment;
+};
+export declare function segmentAt(segments: TimeSegment[], tOut: number): TimeSegment;
+/** Events keyed by stepRef, for callers pairing steps back to their events. */
+export declare function eventByStepRef(log: EventLog): Map<string, ActionEvent>;
+//# sourceMappingURL=pacing.d.ts.map

package/dist/compose/timeline/pacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pacing.d.ts","sourceRoot":"","sources":["../../../src/compose/timeline/pacing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAwB3G;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CA6E3G;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAYlH;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAW5E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAItE"}

package/dist/compose/types.d.ts

@@ -0,0 +1,236 @@
+import type { Rect, Point, CameraState } from '../shared/geometry.js';
+import type { BezierParams } from '../shared/easing.js';
+import type { ResolvedTheme } from '../theme/index.js';
+import type { ActionKind } from '../capture/events.js';
+export interface OutputProfile {
+    width: number;
+    height: number;
+    fps: number;
+    /** Output-px margins content must respect; bottom includes the caption band. */
+    safeArea: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    zoomQuantums: number[];
+    /** Minimum rendered size (output px) of a focus rect's smaller dimension. */
+    minFocusPx: number;
+    captionMaxWidth: number;
+    /**
+     * The stage: footage renders inside `content` (a matte with rounded corners, shadow, and an
+     * optional browser-chrome bar above it) instead of edge-to-edge. ALL camera math — planner,
+     * renderer, cursor projection, verification — runs in content space via `stageContent()`,
+     * so plan and pixels can never disagree about where footage lives. Absent = full-frame.
+     */
+    stage?: {
+        /** Output-px rect the footage is drawn into. */
+        content: Rect;
+        /** Height of the browser-chrome bar drawn directly above `content` (0 = none). */
+        chromeH: number;
+        radius: number;
+    };
+}
+/** The rect footage renders into: the stage's content when present, else the full frame. */
+export declare function stageContent(profile: OutputProfile): Rect;
+/** Compute a stage for the profile: uniform matte margins + a chrome bar, preserving the
+ *  content's aspect (= the capture viewport's), so camera math scales cleanly. */
+export declare function withStage(profile: OutputProfile, chrome: boolean): OutputProfile;
+export declare const PROFILE_16x9: OutputProfile;
+/** Portrait: reserve more top/bottom for platform UI chrome; captions span most of the width. */
+export declare const PROFILE_9x16: OutputProfile;
+export declare const PROFILE_1x1: OutputProfile;
+/** Resolve the output profile for an aspect, overlaying the spec's resolution + fps. */
+export declare function profileForAspect(aspect: '16:9' | '9:16' | '1:1', resolution: {
+    w: number;
+    h: number;
+}, fps: number): OutputProfile;
+export type TimeSegment = {
+    kind: 'source';
+    outStart: number;
+    outEnd: number;
+    srcStart: number;
+    srcEnd: number;
+} | {
+    kind: 'freeze';
+    outStart: number;
+    outEnd: number;
+    srcAt: number;
+} | {
+    kind: 'card';
+    outStart: number;
+    outEnd: number;
+    cardId: string;
+};
+export interface CameraKeyframe {
+    tOut: number;
+    state: CameraState;
+    /** Ease applied travelling from the previous keyframe to this one. */
+    ease: BezierParams;
+}
+export interface CursorSegment {
+    tStart: number;
+    tEnd: number;
+    /** Arc-length-resampled polyline in viewport space. */
+    path: Point[];
+    clickAtEnd: boolean;
+}
+export interface ClickRipple {
+    tOut: number;
+    /** Viewport space. */
+    x: number;
+    y: number;
+}
+export interface CaptionOverlay {
+    kind: 'caption';
+    stepRef: string;
+    ordinal: number;
+    totalSteps: number;
+    /** Whether to draw the numbered step badge (off for demo/release/social/factual styles). */
+    showBadge: boolean;
+    text: string;
+    lines: string[];
+    fontPx: number;
+    /** Output-space card rect as rendered. */
+    box: Rect;
+    tStart: number;
+    tEnd: number;
+    shrunk: boolean;
+    truncated: boolean;
+}
+export interface TitleCardOverlay {
+    kind: 'titleCard';
+    cardId: string;
+    title: string;
+    subtitle?: string;
+    tStart: number;
+    tEnd: number;
+}
+export interface DipTransition {
+    kind: 'dip';
+    tStart: number;
+    tEnd: number;
+    /** 'in' fades FROM the theme background into footage (post-title); 'out' fades footage
+     *  INTO the background (pre-end-card). Default 'in'. */
+    direction?: 'in' | 'out';
+}
+/**
+ * Act→react camera windows for a step that clicks one place and focuses another ("click here,
+ * LOOK there"): the camera frames the action target around the beat, then hands off to the
+ * focused payoff for the settled hold. Shared by the planner (to emit the handoff) and the
+ * verifier (to assert each rect during ITS window) so plan and checks agree by construction.
+ * Returns null when the step has no handoff (single rect, or too little hold to travel in).
+ */
+export declare function actReactWindows(step: StepMapEntry): {
+    act: {
+        rect: Rect;
+        from: number;
+        to: number;
+    };
+    react: {
+        rect: Rect;
+        from: number;
+        to: number;
+    };
+} | null;
+/** A persistent elapsed-time readout (bug-repro evidence). Rendered against the output clock. */
+export interface ElapsedClockOverlay {
+    kind: 'elapsedClock';
+    tStart: number;
+    tEnd: number;
+    /** Output ms to subtract so the clock reads 0 at the first real action, not the title card. */
+    zeroAtMs: number;
+}
+/** A brief scene-title label at each new scene (demo/before-after narrative structure). */
+export interface ChapterLabelOverlay {
+    kind: 'chapterLabel';
+    title: string;
+    ordinal: number;
+    tStart: number;
+    tEnd: number;
+}
+/** Closing card for a FAILED capture: the failure clip ends on what broke and why. */
+export interface FailureCardOverlay {
+    kind: 'failureCard';
+    stepRef: string;
+    message: string;
+    tStart: number;
+    tEnd: number;
+}
+export type OverlayEntry = CaptionOverlay | TitleCardOverlay | DipTransition | ElapsedClockOverlay | ChapterLabelOverlay | FailureCardOverlay;
+export interface StepMapEntry {
+    stepRef: string;
+    sceneId: string;
+    ordinal: number;
+    kind: ActionKind;
+    locator?: string;
+    /** True for masked type steps — their visible effect is intentionally suppressed. */
+    masked?: boolean;
+    /** Viewport-space target rect at action time (bboxPre), when the step had a target. */
+    targetRectVp?: Rect;
+    /** Camera hint from the spec: 'target' | 'wide' | a locator string. */
+    focus?: string;
+    /** Shot-boundary control from the spec: 'cut' | 'continue'. */
+    shot?: string;
+    /** Measured rect of a locator-valued focus hint at the settled moment — the payoff the
+     *  camera should frame instead of the action target ("click here, look there"). */
+    focusRectVp?: Rect;
+    outStart: number;
+    /** Output-clock moment the action lands. */
+    outBeat: number;
+    outEnd: number;
+    srcAction: number;
+    srcSettled: number;
+}
+export interface ComposeDiagnostics {
+    overflows: {
+        stepRef: string;
+        text: string;
+        action: 'shrunk' | 'truncated';
+    }[];
+    cameraFallbacks: string[];
+    clockWarnings: string[];
+}
+export interface ComposeManifest {
+    schema: 'playhead/compose@1';
+    profile: OutputProfile;
+    viewport: {
+        w: number;
+        h: number;
+    };
+    durationMs: number;
+    totalFrames: number;
+    segments: TimeSegment[];
+    camera: CameraKeyframe[];
+    cursor: CursorSegment[];
+    ripples: ClickRipple[];
+    overlays: OverlayEntry[];
+    /** Cross-dissolve windows at scene boundaries: old footage (held at srcFrom) fades into new. */
+    transitions?: {
+        tStart: number;
+        tEnd: number;
+        srcFrom: number;
+    }[];
+    steps: StepMapEntry[];
+    theme: ResolvedTheme;
+    diagnostics: ComposeDiagnostics;
+    bundleHashes: {
+        events: string;
+        framesIndex: string;
+    };
+    videoSha256?: string;
+    /** Present when voice narration was muxed in. `clips` records where each spoken line landed
+     *  on the output clock, so verification can reason about voice-covered windows. */
+    audio?: {
+        narrated: boolean;
+        provider: string;
+        voice: string;
+        lines: number;
+        clips?: {
+            stepRef: string;
+            tStart: number;
+            durMs: number;
+        }[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/compose/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compose/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QACN,gDAAgD;QAChD,OAAO,EAAE,IAAI,CAAC;QACd,kFAAkF;QAClF,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEzD;AAED;kFACkF;AAClF,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAYhF;AAED,eAAO,MAAM,YAAY,EAAE,aAQ1B,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,YAAY,EAAE,aAQ1B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,aAQzB,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,EAC/B,UAAU,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACpC,GAAG,EAAE,MAAM,GACV,aAAa,CAiBf;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,sEAAsE;IACtE,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,GAAG,EAAE,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;4DACwD;IACxD,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG;IACnD,GAAG,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD,GAAG,IAAI,CAQP;AAED,iGAAiG;AACjG,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;uFACmF;IACnF,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAA;KAAE,EAAE,CAAC;IAC/E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gGAAgG;IAChG,WAAW,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;uFACmF;IACnF,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC9D,CAAC;CACH"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Playhead — product video as a build artifact.
+ * spec + live product → capture bundle → composed, verified video.
+ */
+export { parseSpec, loadSpec, SpecError } from './spec/parse.js';
+export { specSchema, flattenSteps } from './spec/schema.js';
+export type { Spec, Scene, Step, AddressedStep, OutputSettings } from './spec/schema.js';
+export { parseLocator, locatorDisplayName } from './spec/locators.js';
+export type { ParsedLocator } from './spec/locators.js';
+export { capture } from './capture/executor.js';
+export type { CaptureOptions } from './capture/executor.js';
+export type { Driver } from './capture/driver-api.js';
+export type { EventLog, ActionEvent, CaptureEvent, TargetInfo } from './capture/events.js';
+export { openBundle } from './bundle/reader.js';
+export type { BundleData, BundleManifest } from './bundle/types.js';
+export { compose, plan, renderFromManifest } from './compose/index.js';
+export type { ComposeResult } from './compose/index.js';
+export type { ComposeManifest, OutputProfile, TimeSegment, CameraKeyframe } from './compose/types.js';
+export { PROFILE_16x9 } from './compose/types.js';
+export { writeCaption } from './compose/captions.js';
+export { verify } from './verify/runner.js';
+export type { Verdict, CheckResult } from './verify/types.js';
+export { resolveTheme, registerFonts } from './theme/index.js';
+export type { ResolvedTheme } from './theme/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}