@cardstack/choreo 0.0.0 → 0.1.0-unstable.0

package/declarations/film/schedule.d.ts

@@ -0,0 +1,93 @@
+import type { Beat, Cam, Chapter, Join, JoinName } from './types.ts';
+/** one tick of the shot list, in seconds: a beat's `ticks` × this is its length */
+export declare const TICK = 2;
+/** the whole film, in seconds, leads included */
+export declare function totalSecs(beats: Beat[]): number;
+/** film seconds before a beat's nominal head, leads included */
+export declare function secsBefore(beats: Beat[], index: number): number;
+/**
+ * FILM SECONDS AT WHICH A BEAT'S OWN SHOT BEGINS. The cues fire one tick
+ * after the beat table says, because the pose-in-force seed occupies the
+ * spline's first slot — so the windows the exact clock derives carry the
+ * same offset, and the picture and the type agree with the cut film to
+ * the frame. This is the single most load-bearing constant in the film.
+ */
+export declare function beatStart(beats: Beat[], i: number): number;
+/** one cue per beat (and an `air` cue ahead of a led beat), as delays into the score */
+export interface Cue {
+    action: 'air' | 'beat';
+    delay: number;
+    index: string;
+}
+export declare function cues(beats: Beat[]): Cue[];
+/** the first beat of each chapter, in whole-film indices */
+export declare function chapterHeads(beats: Beat[]): number[];
+/** the chapter menu's rows: head index, numeral, title, shot count, running time */
+export interface Content {
+    head: number;
+    n: string;
+    secs: number;
+    shots: number;
+    title: string;
+}
+export declare function contents(beats: Beat[], chapters: Chapter[]): Content[];
+/** the seam a beat is entered through, or none when it neither cuts nor names one */
+export declare function joinInto(beats: Beat[], i: number, defaultJoin: Join): JoinName | null;
+/**
+ * WHERE A SHOT ENDS — the beat's authored tail, floored so it always reads
+ * as a move, and clamped so it never travels past the pose the next shot
+ * begins on. Shared by the path (which lerps its waypoints across it) and
+ * by the launch: a cut hands the chaser this shot's own speed.
+ *
+ * A shot must move on screen, not on paper: frame-differencing a capture
+ * of the cut showed authored tails of a few degrees reading as stills, so
+ * a tail is a DIRECTION and a floor, not a distance — what the beat asks
+ * for is honoured, and anything slower than a real slow move is stretched
+ * up to one. The floors are per second. And it never travels past where
+ * the next shot begins: at a cut that jumped BACKWARDS into the successor.
+ */
+export declare function tailFor(beats: Beat[], bi: number): Cam;
+/** one waypoint of the camera spline, in the terms `c.Camera3D @through` takes */
+export interface Waypoint {
+    cut?: boolean;
+    dolly: number;
+    look: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    pitch: number;
+    x: number;
+    y: number;
+    yaw: number;
+}
+/**
+ * THE PATH. Every beat contributes `ticks` waypoints, lerped from its
+ * head to its tail, so waypoint count is screen time; a led beat first
+ * contributes `lead` waypoints travelling in from the previous tail; a
+ * `cut` beat splices the spline. `recut` marks the first beat as a splice
+ * too — a cut film re-cut from a chapter's head has nothing behind it.
+ */
+export declare function waypoints(beats: Beat[], recut?: boolean): Waypoint[];
+/**
+ * THE GOLDEN SCHEDULE: one object per film, everything above at once, in
+ * the shape the fixtures are written in. A refactor of the engine that
+ * changes any number in here has changed the film.
+ */
+export interface Schedule {
+    beats: {
+        ch: number;
+        id: string;
+        join: JoinName | null;
+        lead: number;
+        secsBefore: number;
+        start: number;
+        ticks: number;
+    }[];
+    contents: Content[];
+    cues: Cue[];
+    total: number;
+    waypoints: Waypoint[];
+}
+export declare function schedule(beats: Beat[], chapters: Chapter[], defaultJoin: Join): Schedule;
+//# sourceMappingURL=schedule.d.ts.map

package/declarations/film/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/film/schedule.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErE,mFAAmF;AACnF,eAAO,MAAM,IAAI,IAAI,CAAC;AAEtB,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAK/C;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wFAAwF;AACxF,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,CAmBzC;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAQpD;AAED,oFAAoF;AACpF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAatE;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,EAAE,EACb,CAAC,EAAE,MAAM,EACT,WAAW,EAAE,IAAI,GAChB,QAAQ,GAAG,IAAI,CAGjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,GAAG,CAgDtD;AAED,kFAAkF;AAClF,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,UAAQ,GAAG,QAAQ,EAAE,CA0ClE;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,EAAE,IAAI,GAChB,QAAQ,CAgBV"}

package/declarations/film/seam.d.ts

@@ -0,0 +1,38 @@
+/**
+ * THE SEAM'S GATE: hold the cut until its still can be PAINTED.
+ *
+ * Every join that carries the outgoing frame carries it as a JPEG data
+ * URL in the DOM, and a full-resolution JPEG handed to the DOM is not
+ * paintable on the frame it is handed over — the browser decodes it off
+ * the main thread. The lens, meanwhile, moves on that frame. So the seam
+ * used to play backwards: three frames of the incoming shot at 60 Hz,
+ * then the still of the outgoing one, then the transition over it.
+ *
+ * The gate decodes the frame into the memory cache first and holds the
+ * whole cut — the lens snap, the overlay, an iris's projection — until
+ * it is ready; the DOM image then paints from that decode on the frame
+ * it is inserted. The outgoing shot stays live and moving for those few
+ * milliseconds, which nobody can see: a cut two frames late reads as a
+ * cut, a cut that shows the wrong picture does not.
+ *
+ * Three rules the film depends on:
+ *
+ * - **Nothing to decode, nothing to wait for.** A seam with no still (a
+ *   cut, a flash, a dissolve the page held in its own glass) runs
+ *   SYNCHRONOUSLY, on the caller's stack, exactly as it always did.
+ * - **One seam at a time.** A cut that arrives while an earlier one is
+ *   still waiting retires it; the earlier one never runs.
+ * - **No seam waits for ever.** A decode that never comes back (a
+ *   truncated capture, a browser without `HTMLImageElement.decode`) is
+ *   given `cap` milliseconds and then the cut goes anyway.
+ */
+export declare class Seam {
+    /** which cut is in hand; a later one retires an earlier one */
+    private turn;
+    /**
+     * Hold `cut` until `still` can be painted, or run it now if there is
+     * no still. `cap` is the longest the film will wait on a decode.
+     */
+    hold(still: string, cut: () => void, cap?: number): void;
+}
+//# sourceMappingURL=seam.d.ts.map

package/declarations/film/seam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seam.d.ts","sourceRoot":"","sources":["../../src/film/seam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,IAAI;IACf,+DAA+D;IAC/D,OAAO,CAAC,IAAI,CAAK;IAEjB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,GAAG,SAAM,GAAG,IAAI;CAwBtD"}

package/declarations/film/titles.d.ts

@@ -0,0 +1,37 @@
+import Component from '@glimmer/component';
+import type { FilmHandle } from './types.ts';
+export interface GateSignature {
+    Args: {
+        film: FilmHandle;
+    };
+    Blocks: {
+        default: [FilmHandle];
+    };
+}
+/**
+ * THE GATE — the front door. The film is narrated, so the door asks; and
+ * the click that answers is the same gesture autoplay policy wants. The
+ * scene stands behind it, already seated on the opening frame and
+ * turning. What the door SAYS is the film's: the block is the front
+ * matter, set in the title package (`cf-matter`, `cf-mg-*`), and the
+ * shell here is the museum frame and the wash the type stands on.
+ */
+export declare class Gate extends Component<GateSignature> {
+}
+export interface EndCardSignature {
+    Args: {
+        film: FilmHandle;
+    };
+    Blocks: {
+        default: [FilmHandle];
+    };
+}
+/**
+ * THE END CARD. It arrives a moment after the last line has settled, over
+ * the held final frame — the film does not loop past its own ending;
+ * watching again is the viewer's choice. Back matter is the same package
+ * as the front, run in reverse order of importance.
+ */
+export declare class EndCard extends Component<EndCardSignature> {
+}
+//# sourceMappingURL=titles.d.ts.map

package/declarations/film/titles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"titles.d.ts","sourceRoot":"","sources":["../../src/film/titles.gts"],"names":[],"mappings":"AA8EA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAI3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;KACvB,CAAC;CACH;AAED;;;;;;;GAOG;AAEH,qBAAa,IAAK,SAAQ,SAAS,CAAC,aAAa,CAAC;CAuBjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;KACvB,CAAC;CACH;AAED;;;;;GAKG;AAEH,qBAAa,OAAQ,SAAQ,SAAS,CAAC,gBAAgB,CAAC;CAyCvD"}