@vosjs/studio-core 0.43.0 → 0.45.0

package/dist/index.d.ts

@@ -284,6 +284,15 @@ type DocSegment = Segment & {
     anim?: Anim;
     /** @deprecated migrated on read into a `FreezeSpan` at this segment's `out`. */
     hold?: number;
+    /**
+     * `'rest'`: the camera rests through this clip's pass. No source-anchored
+     * camera move applies there (zoom, tilt, cam move, a follow zoom's
+     * recenters), even over seconds another pass zooms on; the cursor, the
+     * click effects, the speed spans and the freezes are the footage's and
+     * still play. A span that runs into or out of the pass ramps at its edge
+     * as at any span's. Absent = the camera plays here as everywhere.
+     */
+    camera?: 'rest';
 };
 /** A single input event captured in the page, relative to the recording's t0. */
 interface CursorEvent {
@@ -464,6 +473,14 @@ interface RecordingMeta {
      * has no script and carries none.
      */
     steps?: StepSpan[];
+    /**
+     * The other people on the page while the take ran (`peers` in
+     * actions.json): each a browser of its own, OFF CAMERA, its steps placed
+     * in the take's SOURCE seconds. Information only: no cursor event, zoom
+     * or anchor is ever made from a peer's step; what a peer did reaches the
+     * footage through the app itself. Absent on a take with no peers.
+     */
+    peers?: PeerTrack[];
     /**
      * The recorder did not land where it was asked: a sign-in, an identity
      * provider, a 401/403, or a redirect to somewhere else. Present only when
@@ -495,6 +512,13 @@ interface RecordingMeta {
         };
         seen: number;
     }[];
+    /**
+     * INFORMATION the recorder noticed in the frame, never a failure: the
+     * signed-in account's own name (every place it showed, never the name
+     * itself) and a list of the account's recent items. Listed once, at the
+     * first step it was seen; `seen` counts the scans that saw it.
+     */
+    notices?: RecordingNotice[];
     /**
      * What the script asked the recorder to hide before the camera rolled, and
      * how many elements each selector reached. `hits: 0` is a mask that hid
@@ -509,6 +533,64 @@ interface RecordingMeta {
     skips?: RecordingSkip[];
     /** The files `download` steps kept (CLI takes only). */
     outputs?: RecordingOutput[];
+    /**
+     * Sound the page played during the take: every `<video>` or `<audio>`
+     * (the page's own and its same-origin frames') that played audibly,
+     * with the footage stretches it was heard (CLI takes only).
+     */
+    media?: RecordingPageMedia[];
+}
+/** Something the recorder noticed in the frame (`meta.notices`): information, never a failure. */
+interface RecordingNotice {
+    /** the first step it was seen at; -1 = as the page opened */
+    step: number;
+    kind: 'account-name' | 'personal-list';
+    /** account-name: every place in the frame the name was seen (viewport CSS px); never the name */
+    places?: {
+        selector: string;
+        rect: Rect;
+    }[];
+    /** account-name: read from a line that says whose account it is; false = it may be the name */
+    sure?: boolean;
+    /** personal-list: the page's own heading over it (`Recents`, `History`) */
+    heading?: string;
+    /** personal-list: the list, as a selector a mask can take */
+    selector?: string;
+    rect?: Rect;
+    /** personal-list: how many items it showed */
+    items?: number;
+    seen: number;
+}
+/** A media element the page played during the take (`meta.media`). */
+interface RecordingPageMedia {
+    /** the step during which it first played audibly */
+    step?: number;
+    /** what it played: its `currentSrc`, query and hash kept off */
+    src: string;
+    /** `video` or `audio` */
+    tag?: 'video' | 'audio';
+    /** the element's own length, seconds, when it knew one */
+    duration?: number;
+    /** its volume while heard, 0..1 */
+    volume?: number;
+    /**
+     * The stretches it was heard: footage seconds `at` while it played media
+     * seconds `from`..`to`. An off-camera wait splits a stretch.
+     */
+    intervals: {
+        at: number;
+        from: number;
+        to: number;
+    }[];
+    /** it played, but never with sound: nothing to place */
+    muted?: boolean;
+    /**
+     * Where the fetched source landed, take-relative (`page-sound/voice.mp3`):
+     * what the plan's clips are keyed to. Absent when nothing was fetched
+     * (a hosted take, or a fetch that failed: `fetchError` says why).
+     */
+    file?: string;
+    fetchError?: string;
 }
 /**
  * A span's tie to an actions.json step: metadata for `vos plan
@@ -547,6 +629,37 @@ interface RejectedSpan {
     /** Why, in the deleter's words. Optional. */
     note?: string;
 }
+/** One peer's steps as they ran during a take, in SOURCE seconds. */
+interface PeerTrack {
+    /** The peer's id from actions.json. */
+    id: string;
+    steps: PeerStepSpan[];
+    /** Steps whose trigger never fired before the take's steps were over. */
+    notRun?: number[];
+}
+/** One peer step as it ran. */
+interface PeerStepSpan {
+    /** index into the peer's own steps */
+    step: number;
+    id?: string;
+    do: string;
+    /** the take step it started with (as it started) or after (as it ended) */
+    with?: string;
+    after?: string;
+    selector?: string;
+    tStart: number;
+    tEnd: number;
+    skipped?: boolean;
+    reason?: string;
+    /** its trigger had fired before the peer reached it: it ran late */
+    late?: boolean;
+    /**
+     * What an `expect` last answered when its check reads the app's state
+     * (a `js` expression), kept as the take's own steps keep it: JSON, at
+     * most 2 KB, else that JSON cut short as a string. Absent otherwise.
+     */
+    value?: unknown;
+}
 /** One executed actions.json step's extent in the recording. */
 interface StepSpan {
     /** index into actions.steps at record time. */
@@ -584,6 +697,13 @@ interface StepSpan {
      * payload, which a layer quotes instead of replaying the flow.
      */
     text?: string;
+    /**
+     * What an `expect` or an `await` with a `js` expression last answered,
+     * as JSON (at most 2 KB, else that JSON cut short as a string): the
+     * app's own state at that moment, which the frames cannot say. Absent
+     * when the expression answered nothing JSON can hold.
+     */
+    value?: unknown;
     /**
      * The step carries a guard (`"spend"`): `confirmed` says the recording
      * pressed it because the command named it; a rehearsal only hovers one
@@ -591,6 +711,11 @@ interface StepSpan {
      */
     guard?: 'spend';
     confirmed?: boolean;
+    /**
+     * The script's `zoom` mark on the step: `true` = the beat's payoff, the
+     * step a per-beat plan keeps its zoom on; `false` = never zoom here.
+     */
+    zoom?: boolean;
     /**
      * An `await` step: the wall-clock ms it waited OFF CAMERA. The footage
      * clock stood still meanwhile, so `tStart`..`tEnd` hold only the
@@ -607,6 +732,17 @@ interface StepSpan {
      * waits for cannot come.
      */
     followsGuard?: number;
+    /**
+     * A paced gesture (a drag's travel, a drawn path, typing, a key
+     * sequence) ran this many ms past what the script planned, more than a
+     * fifth over: the page could not keep up with what it was sent.
+     */
+    overrunMs?: number;
+    /**
+     * The step waited on the app after its gesture (`settle`): the ms until
+     * the page made no DOM change and painted no new frame for a beat.
+     */
+    settleMs?: number;
 }
 /**
  * A cut the recorder made: an `await` step waited off camera, so the
@@ -1067,8 +1203,21 @@ interface AudioClip {
     out: number;
     /** full source-file length, seconds — the trim ceiling (set on add). */
     duration: number;
-    /** linear gain 0..1. */
+    /** linear gain 0..1 (a trim on top of `normalize`, when that applies). */
     gain: number;
+    /**
+     * The clip's loudness as a TARGET: integrated loudness in LUFS (-30..-6,
+     * e.g. -16). Applies only while `loudness` was measured for this `key`:
+     * the lowering plays the clip at 10^((normalize - lufs) / 20) × gain,
+     * which may exceed 1, capped so the sample peak stays under -1 dBFS.
+     * Absent = `gain` alone, as always.
+     */
+    normalize?: number;
+    /**
+     * What the file measures, written by tooling (`vos audio measure`), never
+     * by hand: the fact `normalize` is computed from.
+     */
+    loudness?: AudioLoudness;
     /** fade durations, seconds. */
     fadeIn: number;
     fadeOut: number;
@@ -1080,6 +1229,28 @@ interface AudioClip {
     duck?: boolean;
     /** The template that placed this clip (see the overlay clip's `from`). */
     from?: string;
+    /**
+     * `page`: sound the recorded page itself played (a `<video>` or `<audio>`
+     * heard during the take, `meta.media`), placed by the plan. A re-plan
+     * replaces only these; absent = a clip someone added.
+     */
+    source?: 'page';
+}
+/**
+ * A file's measured loudness (BS.1770, K-weighted, gated), stored next to
+ * the clip that plays it. `src` is the key it was measured for: a clip whose
+ * key moved to another file no longer matches, and its `normalize` is
+ * ignored until it is measured again.
+ */
+interface AudioLoudness {
+    /** Integrated loudness, LUFS. */
+    lufs: number;
+    /** Sample peak, dBFS (not oversampled); null for digital silence. */
+    peakDb: number | null;
+    /** When it was measured (ISO date). */
+    at: string;
+    /** The key it was measured for. */
+    src: string;
 }
 /** Effective placed length of a clip on the output timeline, seconds. */
 declare function clipLength(clip: Pick<AudioClip, 'in' | 'out' | 'loop' | 'loopLen'>): number;
@@ -1439,8 +1610,10 @@ interface OverlayPin {
  * and `offset` OUTPUT seconds are added. So a trim, a speed change or a
  * re-record moves the caption with its step, and nobody recomputes a
  * `start`. `start` stays the clip's fallback when the step cannot be
- * found or the cut leaves it out (validate says which); `duration` is the
- * clip's own either way.
+ * found or the cut leaves it out (validate says which), and may be left
+ * out; `duration` is the clip's own either way. On a cut that replays the
+ * step's seconds, the layer starts in the pass where the step plays the
+ * longest (the first on a tie).
  */
 interface OverlayAnchor {
     /** The step: its `id` (`meta.steps[].id`) when it has one, else its index. */
@@ -1455,8 +1628,13 @@ interface OverlayAnchor {
 interface OverlayClipBase {
     /** Stable identity for selection/editing in the timeline UI. */
     id: string;
-    /** OUTPUT-time span (seconds). */
-    start: number;
+    /**
+     * OUTPUT seconds the layer starts at. Required unless the layer carries
+     * an `anchor`, which places it; with one, `start` is only the fallback
+     * for an anchor that does not resolve, and a layer with neither plays
+     * nowhere (validate refuses it, naming the step).
+     */
+    start?: number;
     duration: number;
     transform: OverlayTransform;
     /**
@@ -1907,11 +2085,24 @@ interface ProjectDoc {
          * travels as the cut does. Absent on a human recording.
          */
         script?: Record<string, unknown>;
+        /**
+         * The files the script pastes, by the plain name it pastes them by,
+         * and where their bytes are: a hosted file (`/api/assets/<id>/file`,
+         * for a picture) or a `data:` address (a text file, carried in the
+         * document). `vos push` writes it from the take's own files and
+         * `vos fetch --media` writes each one back beside `actions.json`, so a
+         * fetched take records again with every file it pastes. Absent when
+         * the script pastes no file.
+         */
+        scriptFiles?: Record<string, string>;
     };
     /**
      * Kept SOURCE-time spans (@vosjs/timeline `Segment`s); the output timeline is
      * their concatenation — trim/split/cut are all segment edits. Canonical form
      * is one full-source segment; an empty list is tolerated and means "untrimmed".
+     * A segment may play seconds an earlier one already played (a cold open,
+     * a replay): every source-anchored span over them plays in each
+     * occurrence (see `lower/occurrences.ts`).
      */
     segments: DocSegment[];
     /**
@@ -3585,7 +3776,12 @@ declare function buildDigest(input: BuildDigestInput): Digest;
 /** OUTPUT seconds of a doc: its kept footage through the rate map. */
 declare function outputDurationOf(doc: ProjectDoc): number;
 
-/** Map an OUTPUT-time range to SOURCE seconds through the doc's rate map. */
+/**
+ * Map an OUTPUT-time range to SOURCE seconds through the doc's rate map. On
+ * a cut that replays seconds a range may run across the seam where the
+ * playhead jumps back; then `srcOut` falls before `srcIn` and every chip
+ * below reads the range as empty.
+ */
 declare function outputRangeToSource(doc: StudioDoc, t0: number, t1: number): {
     srcIn: number;
     srcOut: number;
@@ -3602,7 +3798,8 @@ declare function removeSpeedInRange(spans: readonly SpeedSpan[], srcIn: number,
  * The Cut chip: subtract a SOURCE range from the kept segments. Segment
  * order (and any reorder) is preserved; a remainder below MIN_SEGMENT is
  * dropped with its parent. Never empties the take: cutting everything
- * returns the original list unchanged.
+ * returns the original list unchanged. Source seconds are cut wherever
+ * they play: a segment that repeats them loses them too.
  */
 declare function removeSourceRange(segments: readonly Segment[], srcIn: number, srcOut: number): Segment[];
 /**
@@ -3721,6 +3918,10 @@ declare function pinBox(clip: OverlayClip, layout: CardLayout): {
  */
 declare function pinRectOnScreen(rect: Rect, t: number, layout: CardLayout, camera: CameraModel, zoomTrack?: KeyframeTrack<number[]> | null): Rect;
 interface PinPlacementInput {
+    /**
+     * The layer, placed: its `start` is where it plays (an anchored layer
+     * with none is placed first, `layerStart`; unplaced it reads from 0).
+     */
     clip: OverlayClip;
     referent: Rect;
     layout: CardLayout;
@@ -3860,7 +4061,9 @@ declare function ratedSegments(doc: StudioDoc): Segment[];
  * list: the output extent of its KEPT footage (a partially-cut span snaps its
  * edges into kept footage; a fully-cut span returns null — it follows its
  * footage, like every source-anchored feature). Rate-aware: output positions
- * accumulate each piece's (out − in) / rate.
+ * accumulate each piece's (out − in) / rate. When the cut plays the span's
+ * seconds more than once this is the FIRST occurrence (what a lane draws, a
+ * digest names); `spanOutputExtents` returns every one.
  */
 declare function spanOutputExtent(segments: readonly (Segment & {
     media?: string;
@@ -4055,6 +4258,91 @@ declare function pinCandidates(doc: ProjectDoc, clip: {
  */
 declare function overlayPinPoseAt(doc: ProjectDoc, o: OverlayClip, t: number): number[] | null;
 
+type Piece = Segment & {
+    media?: string;
+    camera?: string;
+};
+/**
+ * Does the camera rest through this piece? A segment marked
+ * `camera: 'rest'` carries the mark into every piece it is rated into.
+ */
+declare const cameraRests: (p: {
+    camera?: string;
+}) => boolean;
+/**
+ * How far before the end of its media's previous piece a piece may start
+ * and still count as continuing it. A freeze piece holds a hair of source
+ * time just before its moment (2 ms), and is never a replay.
+ */
+declare const REPLAY_EPS = 0.01;
+/**
+ * For each piece, whether it starts a new pass over its media's seconds
+ * (see the module note): it starts before the previous piece of its media
+ * ended. All false for a forward cut.
+ */
+declare function replayFlags(pieces: readonly Piece[]): boolean[];
+/** Does the rated list go back over any media's seconds? */
+declare function hasReplay(pieces: readonly Piece[]): boolean;
+/** Seconds of one media a piece plays that an earlier piece already played. */
+interface ReplayedSpan {
+    /** The piece's index. */
+    piece: number;
+    /** The media's key (`''` = the primary). */
+    media: string;
+    in: number;
+    out: number;
+}
+/**
+ * The seconds each piece plays that an earlier piece of its media already
+ * played, in piece order (a piece may replay more than one stretch). Empty
+ * for a cut that plays every second at most once, in any order.
+ */
+declare function replayedSeconds(pieces: readonly Piece[]): ReplayedSpan[];
+/** One occurrence of a source span on the output timeline. */
+interface OutputExtent {
+    start: number;
+    end: number;
+}
+/**
+ * Every occurrence of a SOURCE span of one media on the output timeline,
+ * in output order: the output extent of its kept footage in each pass (a
+ * partially-cut span snaps its edges into kept footage; a span the cut
+ * keeps nothing of has none). Rate-aware: output positions accumulate each
+ * piece's (out − in) / rate. A forward cut gives at most one.
+ */
+declare function spanOutputExtents(pieces: readonly Piece[], sIn: number, sOut: number, media?: string): OutputExtent[];
+/**
+ * Every occurrence of a camera span (zoom, tilt, cam move) the camera
+ * plays: `spanOutputExtents` without the passes of a segment whose camera
+ * rests. A span that runs into such a pass ends at its edge, and one that
+ * runs out of it starts there, so the track ramps at the edge as it does
+ * at any span's. The same as `spanOutputExtents` for a cut with no rest.
+ */
+declare function cameraSpanExtents(pieces: readonly Piece[], sIn: number, sOut: number, media?: string): OutputExtent[];
+/**
+ * Where the camera rests on the output (each run of resting pieces as
+ * `{ t, d }`): no connected move of a camera track crosses one. Empty for
+ * a cut with no rest.
+ */
+declare function cameraRestWindows(pieces: readonly Piece[]): {
+    t: number;
+    d: number;
+}[];
+/**
+ * The pass a step plays in, as ONE output extent: the occurrence of its
+ * seconds that plays the longest (a cold open of a second or two loses to
+ * the main play), the first on a tie, null when the cut keeps none of it.
+ * A forward cut has one occurrence, so this is `spanOutputExtent`.
+ */
+declare function longestOutputExtent(pieces: readonly Piece[], sIn: number, sOut: number, media?: string): OutputExtent | null;
+/**
+ * Every output second a SOURCE moment of one media plays at, one per
+ * occurrence, in output order. A moment on a piece's edges counts as held
+ * there; a moment on the boundary two pieces of one pass share is one
+ * moment, played once. Empty when the cut leaves it out.
+ */
+declare function momentOutputs(pieces: readonly Piece[], t: number, media?: string): number[];
+
 /**
  * ONE lowering for the document family: the anchor's program
  * plus the studio stack entry, on every anchor.
@@ -4392,10 +4680,10 @@ declare function htmlStarterClip(starter: HtmlStarter, id: string, start: number
 interface EnvelopePoint {
     /** output-timeline seconds. */
     t: number;
-    /** linear gain 0..1. */
+    /** linear gain (0..1, above 1 only for a clip lifted to its `normalize`). */
     g: number;
 }
-declare function clipEnvelope(clip: Pick<AudioClip, 'start' | 'in' | 'out' | 'gain' | 'fadeIn' | 'fadeOut' | 'loop' | 'loopLen'>): EnvelopePoint[];
+declare function clipEnvelope(clip: Pick<AudioClip, 'start' | 'in' | 'out' | 'gain' | 'fadeIn' | 'fadeOut' | 'loop' | 'loopLen'> & Partial<Pick<AudioClip, 'key' | 'normalize' | 'loudness'>>): EnvelopePoint[];
 /** Envelope value at output time `t` (linear interpolation; 0 outside the clip). */
 declare function envelopeValueAt(env: EnvelopePoint[], t: number): number;
 
@@ -4580,7 +4868,7 @@ declare const STILL_DEFAULT = 0.5;
  *    footage. Read from `anim` seconds, so it is the same everywhere.
  * 4. The old default, for a document with none of the above.
  */
-declare function docStillTime(doc: ProjectDoc): number;
+declare function docStillTime(input: ProjectDoc): number;
 /**
  * Where the LAST freeze of any origin begins, or null with none: the
  * poster's rest as first spelled. Prefer `docStillTime`, which ignores a
@@ -4638,14 +4926,20 @@ interface FreezeExtent {
  * before it. A freeze whose moment is on no kept footage is not placed
  * (it follows its frame, like a span). Every consumer of the rated list
  * (mapTime, the zoom remap, the audio splice, the duration) inherits the
- * freezes from this one seam. `marks` is where each placed freeze landed
- * in OUTPUT time, for the lane and the rest.
+ * freezes from this one seam. A cut that plays a freeze's moment more than
+ * once (a piece that replays seconds, see `replayFlags`) freezes it in
+ * every occurrence. `marks` is where each placed freeze FIRST landed in
+ * OUTPUT time, for the lane; `placements` is every landing, in output
+ * order, for the rest.
  */
 declare function placeFreezes(rated: readonly (Segment & {
     media?: string;
 })[], freezes: readonly FreezeSpan[]): {
     pieces: Segment[];
     marks: Map<string, FreezeExtent>;
+    placements: (FreezeExtent & {
+        id: string;
+    })[];
 };
 /** The rated segments with every freeze placed (see `placeFreezes`). */
 declare function withFreezes(rated: readonly Segment[], freezes: readonly FreezeSpan[]): Segment[];
@@ -4748,7 +5042,10 @@ declare function docTransitions(doc: ProjectDoc): Transition[];
  * head, starting where the window ends instead, and a span too short to
  * survive the cut is dropped. Spans that start before the window keep
  * their own end. The open's record (t = 0) is the entrance's business
- * (`prependEntrance`) and is skipped here.
+ * (`prependEntrance`) and is skipped here. A span is a SOURCE span, so on
+ * a cut that plays its seconds more than once it is read by its first
+ * occurrence the camera plays: the window that one starts in rests every
+ * one.
  */
 declare function restSpansThroughTransitions<T extends {
     in: number;
@@ -4785,11 +5082,24 @@ declare const ELAPSED_PLACEHOLDER = "{elapsed}";
  * Where a SOURCE moment of one media plays in the cut: the output second of
  * the first rated piece of that media that holds it, null when the cut
  * leaves it out. A moment on a piece's closing edge counts as held there
- * (the last frame of a clip is still that clip).
+ * (the last frame of a clip is still that clip). On a cut that plays the
+ * moment more than once this is its FIRST occurrence; a step's moment is
+ * read through `stepMomentToOutput`, which takes the step's longest pass.
  */
 declare function sourceMomentToOutput(rated: readonly (Segment & {
     media?: string;
 })[], t: number, media?: string): number | null;
+/**
+ * Where a step's moment (its start, or its end with `at: 'end'`) plays in
+ * the cut: in the PASS where the step plays the longest
+ * (`longestOutputExtent`; the first on a tie), so a caption about a step
+ * lands in the main play, not in a short cold open of the same seconds.
+ * Null when the cut leaves the moment out. A cut with no replay plays each
+ * moment once, and this is `sourceMomentToOutput`.
+ */
+declare function stepMomentToOutput(rated: readonly (Segment & {
+    media?: string;
+})[], step: Pick<StepSpan, 'tStart' | 'tEnd'>, at: 'start' | 'end' | undefined, media?: string): number | null;
 /** Why an anchor did not resolve. */
 type AnchorMiss = 'media' | 'step' | 'skipped' | 'cut';
 interface AnchorResolution {
@@ -4848,10 +5158,20 @@ declare function hasElapsed(text: RichText | undefined): boolean;
 declare function anchoredClip<C extends OverlayClip>(clip: C, doc: Pick<ProjectDoc, 'source' | 'media'>, rated: readonly (Segment & {
     media?: string;
 })[]): C;
+/**
+ * Where a layer starts as the document stands (OUTPUT seconds): where its
+ * anchor's step plays when it resolves, else its own `start`; null for an
+ * anchored layer that resolves nowhere and carries no `start`.
+ */
+declare function layerStart(clip: OverlayClip, doc: Pick<ProjectDoc, 'source' | 'media'>, rated: readonly (Segment & {
+    media?: string;
+})[]): number | null;
 /**
  * The document with every anchored layer resolved (its `start` where its
- * step plays, its `{elapsed}` filled). A document with no anchored layer is
- * returned as it is, the same object, so its lowering is byte-identical.
+ * step plays, its `{elapsed}` filled), and every anchored layer that has
+ * no `start` and whose step does not resolve left out: it has no time to
+ * play at. A document with no anchored layer is returned as it is, the
+ * same object, so its lowering is byte-identical.
  */
 declare function resolveOverlayAnchors<D extends Pick<ProjectDoc, 'source' | 'media' | 'overlays'>>(doc: D, rated: readonly (Segment & {
     media?: string;
@@ -5304,7 +5624,9 @@ declare const freezeLane: LaneAdapter<ProjectDoc>;
  * Zoom lane — zoom regions as clips ("1.80×"). Spans are SOURCE-anchored
  * (footage-anchored like speed spans and the cam window); the lane displays
  * the output extent of each span's KEPT footage (spanOutputExtent — partial
- * cuts snap the clip's edges, full cuts hide it until the trim is undone).
+ * cuts snap the clip's edges, full cuts hide it until the trim is undone;
+ * on a cut that replays the span's seconds it is drawn where they FIRST
+ * play, though the camera moves in every occurrence).
  * Move/resize are pointer-true through the FULL rated map — zoom never alters
  * rates, so no exclusion trick is needed (unlike speedLane). Spans never
  * overlap: create no-ops inside an existing span, move pushes out of
@@ -5427,6 +5749,102 @@ declare function computeMicRms(channels: Float32Array[], sampleRate: number, win
  */
 declare function duckCurve(rms: MicRms, segments: Segment[], durationSec: number, opts?: DuckOptions): EnvelopePoint[];
 
+/**
+ * A clip's loudness as a target. `normalize` says how loud the clip should
+ * play (integrated LUFS); `loudness` is what its file measured, a fact the
+ * tooling stores next to it. The gain the clip plays at is derived here, at
+ * lowering, so the document stays declarative: swap the file and measure
+ * again, and the same target holds.
+ *
+ *   gain = 10^((normalize - lufs) / 20) × (clip.gain ?? 1)
+ *
+ * The gain may exceed 1 (a quiet file is lifted), and is CAPPED, never
+ * limited: no gain may put the file's sample peak above -1 dBFS, and none is
+ * above +24 dB. A cap lowers the whole clip; nothing reshapes its waveform.
+ *
+ * `normalize` applies only while `loudness` was measured for the clip's own
+ * key (`loudness.src === key`). Without that the clip plays at `gain` alone,
+ * exactly as a clip with no target, so a document lowers byte-identically
+ * until it is measured.
+ */
+
+/** The targets a clip may ask for, LUFS. */
+declare const NORMALIZE_MIN_LUFS = -30;
+declare const NORMALIZE_MAX_LUFS = -6;
+/** The ceiling a normalized clip's sample peak is held under, dBFS. */
+declare const NORMALIZE_PEAK_CEILING_DB = -1;
+/** The most a target may lift a clip, dB. */
+declare const NORMALIZE_MAX_LIFT_DB = 24;
+type ClipGainBasis = 
+/** No target: `gain`, clamped to 0..1, as always. */
+'gain'
+/** The target applied. */
+ | 'normalize'
+/** A target with no measurement for this key: ignored. */
+ | 'unmeasured'
+/** A target measured for another key: ignored. */
+ | 'stale';
+interface ClipGain {
+    /** The linear gain the clip plays at. */
+    gain: number;
+    basis: ClipGainBasis;
+    /** The gain the target asked for, before the caps (when it applied). */
+    asked?: number;
+    /** Which cap held it, when one did. */
+    capped?: 'peak' | 'lift';
+}
+/** Is the clip's measurement one its target may be computed from? */
+declare function loudnessMatches(clip: Partial<Pick<AudioClip, 'key' | 'loudness'>>): boolean;
+/** The gain a clip plays at, and why. */
+declare function clipGain(clip: Pick<AudioClip, 'gain'> & Partial<Pick<AudioClip, 'key' | 'normalize' | 'loudness'>>): ClipGain;
+
+interface DocFeature {
+    /** A stable name for the feature. */
+    id: string;
+    /** The release of `@vosjs/studio-core` that first renders it. */
+    since: string;
+    /** What it is, in words, as a list of things: `caption anchors`. */
+    name: string;
+    /** What a renderer before `since` does with them, in words. */
+    before: string;
+    /** How many places in the document use it (0 = not used). */
+    uses: (doc: StudioDoc) => number;
+    /**
+     * The document with the feature said in what a renderer before `since`
+     * reads, and anything that changed how it plays. Absent: it cannot be.
+     */
+    bake?: (doc: StudioDoc) => {
+        doc: StudioDoc;
+        notes: string[];
+    };
+}
+declare const DOC_FEATURES: readonly DocFeature[];
+/** `a` against `b` as releases (`x.y.z`; a pre-release tag is ignored): -1, 0 or 1. */
+declare function compareVersions(a: string, b: string): number;
+/** A feature a document uses, and how many places use it. */
+interface UsedFeature {
+    feature: DocFeature;
+    count: number;
+}
+/** The features the document uses, in table order. */
+declare function docFeatures(doc: StudioDoc): UsedFeature[];
+/** The features the document uses that a renderer at `version` does not read. */
+declare function featuresNewerThan(doc: StudioDoc, version: string): UsedFeature[];
+interface BakeResult {
+    doc: StudioDoc;
+    /** The features baked. */
+    baked: DocFeature[];
+    /** The features newer than the renderer that cannot be baked. */
+    unbakeable: DocFeature[];
+    /** What changed in how the document plays, in words. */
+    notes: string[];
+}
+/**
+ * The document as a renderer at `version` reads it: every newer feature it
+ * uses baked into the fields it stood for. A copy; the input is untouched.
+ */
+declare function bakeDocFeatures(doc: StudioDoc, version: string): BakeResult;
+
 /** Rate-aware OUTPUT duration of a doc (what the viewer experiences). */
 /**
  * The OUTPUT length of either document: a recording's kept footage
@@ -5546,4 +5964,4 @@ declare function rejectSpan(rejected: RejectedSpan[] | undefined, lane: Rejected
     anchor?: StepAnchor;
 }, note?: string): RejectedSpan;
 
-export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, type AnchorMiss, type AnchorResolution, type Anim, type AnimKind, type AnimSide, type AnimStep, type AppliedTemplate, type ApplyTemplateOptions, type AspectRatioOption, type AudioClip, type AudioPlanPoint, type AudioPlanTrack, BACKGROUND_Z, BASE_FRAME_STYLE, type Backdrop, type BackgroundMedia, type BakedText3dAsset, type BakedText3dMaterial, type BrowserBarStyle, type BuildDigestInput, CALLOUT_DEFAULT_BODY_PX, CALLOUT_SHAPES, CALLOUT_TYPE_RATIO, CAMERA_CENTRE_RAMP, CAMERA_COVER_MIN, CAMERA_FAR, CAMERA_NEAR, CAM_CHAIN_GAP, CAM_EASE, CAM_PAN, CAM_PAN_EASE, CAM_RAMP_IN, CAM_RAMP_OUT, CAM_SIZE_MAX, CAM_SIZE_MIN, CAM_SPAN_MIN, CAPTURE_COVERAGE_MIN, CARD_EDGE_OVERDRAW, CARD_ENTER_KINDS, CARD_EXIT_KINDS, CARD_FADE_SECONDS, CARD_FOV, CARD_Z, CHANGE_FLOOR, CHANGE_GRID, CHANGE_LEAD, CHANGE_OFFSETS, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_HOLD_MS, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, CLUSTER_FILL, CROP_MAX_PX, CROP_MIN_FRAC, CROP_MIN_PX, CROP_PAD, CURSOR_IDLE_EPS_FRAC, CURSOR_IDLE_FADE_IN, CURSOR_IDLE_FADE_OUT, CURSOR_IDLE_HOLD, type CalloutBox, type CalloutClipOptions, type CalloutLook, type CalloutRegister, type CalloutShape, type CalloutWords, type CamBubbleRect, type CamPoseSpan, type CamStyle, type CameraModel, type CaptureNormalization, type CardLayout, type ChangeSample, type ChangeWitness, type ChangedRegion, type ClickFxStyle, type CopiedLayout, type CopyLayoutOptions, type CopyStyleOptions, type CursorEvent, type CursorFadeKey, type CursorIdleOptions, type CursorStyle, type CursorTrack, DARK_GROUND, DEFAULT_BROWSER_BAR, DEFAULT_CAM_POSE, DEFAULT_CAM_STYLE, DEFAULT_CLICK_FX, DEFAULT_CURSOR_STYLE, DEFAULT_DUCK, DEFAULT_FRAME_STYLE, DEFAULT_SPEED_PARAMS, DEFAULT_TILT_POSE, DEFAULT_ZOOM_LEVEL, DEFAULT_ZOOM_STYLE, DESIGN_FRAME_WIDTH, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, DRAG_MIN_S, DRAG_MIN_TRAVEL_FRAC, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, type Drag, type DuckOptions, ELAPSED_PLACEHOLDER, END_CARD_FROM, END_CARD_RECEDE, END_CARD_SECONDS, ENTRANCE_SECONDS, EXPORT_RESOLUTION_OPTIONS, EXPORT_SHORT_EDGE, type EndCard, type EnvelopePoint, type ExportResolution, type ExtractClickOptions, FOLLOW_RECENTER, FOLLOW_SAFE_RATIO, FOOTAGE_FRAME_STYLE, FRAME_BORDER_COLOR_DEFAULT, FRAME_BORDER_DEFAULT, FRAME_BORDER_WIDTH_DEFAULT, FREEZE_DEFAULT_SECONDS, FREEZE_SECONDS_MAX, FREEZE_SECONDS_MIN, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, type FreezeExtent, type FreezeSpan, HOLD_DRIFT_MAX, HOUSE_GRADIENT, HOUSE_REGISTER, HTML_LAYER_FOREIGN_FIELDS, HTML_LAYER_MAX_BYTES, HTML_LAYER_SVG_CODE, HTML_LAYER_WARN_BYTES, HTML_STARTERS, type HtmlLayerFace, type HtmlLayerInlineFace, type HtmlLayerPayload, type HtmlLayerProblem, type HtmlLayerProblemCode, type HtmlLayerSource, type HtmlOverlayClip, type HtmlOverlayFont, type HtmlStarter, IDLE_KINDS, type IdleKind, type IngestOptions, LAYER_CARD_SHADOW, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayerCard, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, type LumaGrid, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MEDIA_FRAME_KEYS, MEDIA_KEY_PREFIX, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type Media, type MediaFrame, type MediaFrameKey, type MediaOverlayClip, type MediaSegment, type MicRms, type MinimalBarTheme, type Moment, type MomentKind, type MomentsOptions, type MotionKey, type MotionPose, type MotionPose3D, type MusicBedInput, type NormRect, OBJECT_DEFAULT_SCALE, OVERLAY_FONT_FACES, OVERLAY_LINE_HEIGHT, OVERLAY_MEDIA_DEFAULT_RADIUS, OVERLAY_MEDIA_DEFAULT_WIDTH, OVERLAY_MIN_DURATION, OVERLAY_SCALE_MAX, OVERLAY_SIZE_MAX, OVERLAY_SIZE_MIN, OVERLAY_TRANSITION_DUR, OVERLAY_Z, type ObjectAnimation, type ObjectAsset, type ObjectClip, type ObjectPrimitiveShape, type OverlayAnchor, type OverlayClip, type OverlayFontFace, type OverlayKind, type OverlayPin, type OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PIN_GAP, PIN_MARGIN, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, PROGRAM_RETIME, PUMP_REST, type PinCandidate, type PinCarry, type PinMark, type PinPlacement, type PinPlacementInput, type PinReferent, type PinSide, type PinSideResolved, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, RETIRED_ZOOM_STYLES, type RecordingArtifact, type RecordingMeta, type RecordingOutput, type RecordingSkip, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, type Rgb, SCENE_MOTION, SCENE_QUIET, SEGMENT_ENTER_KINDS, SEGMENT_EXIT_KINDS, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STILL_DEFAULT, STUDIO_ENTRY_ID, STYLE_FIELDS, type SegmentExtent, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, type StyledText, TEXT3D_DEPTH_DEFAULT, TEXT3D_DEPTH_MAX, TEXT3D_DEPTH_MIN, TEXT_ENTER_KINDS, TEXT_EXIT_KINDS, TEXT_PRESETS, TILT_AUTO_DEAD_ZONE, TILT_AUTO_MIN, TILT_CHAIN_GAP, TILT_DEG_MAX, TILT_EASE, TILT_INTENSITY_MAX, TILT_PAN, TILT_PAN_EASE, TILT_RAMP_IN, TILT_RAMP_OUT, TILT_SPAN_MIN, TILT_UI_DEG_MAX, TRANSITION_SECONDS, TRANSITION_SECONDS_MAX, TRANSITION_SECONDS_MIN, TRANSITION_SPEED_MULT, type TemplateAnchor, type Text3dMaterial, type TextFxDirection, type TextFxKind, type TextFxSpec, type TextFxUnit, type TextOverlayBox, type TextOverlayClip, type TextOverlayPreset, type TextOverlayStroke, type TiltPersonality, type TiltSpan, type TiltStyleName, type TraceFileKind, type TraceOptions, type TraceResult, type TranscriptSegment, type Transition, type TransitionKind, type TransitionMove, type TransitionOut, type TransitionSpeed, WINDOW_FOCUS_MIN, ZOOM_CHAIN_GAP, ZOOM_EASE, ZOOM_LEVELS, ZOOM_LEVEL_MAX, ZOOM_LEVEL_MIN, ZOOM_PAN, ZOOM_PAN_EASE, ZOOM_RAMP_IN, ZOOM_RAMP_IN_OVERLAP, ZOOM_RAMP_OUT, ZOOM_SPAN_MIN, ZOOM_STYLES, ZOOM_STYLE_OPTIONS, type ZipEntry, type ZoomScreen, type ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomView, type ZoomWindow, ambientDrift, anchorKindOf, anchorSourceDuration, anchoredClip, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, boldWeightFor, buildDigest, calloutBox, calloutClip, calloutGroundOf, calloutLook, calloutSource, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cameraCentring, cameraModel, cardEnter, cardExit, cardFields, cardInset, cardPointToScreen, cardPoseTrack, changedRegion, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cssFamilies, cssWeights, cursorFromCsv, cursorFromPlaywrightTrace, cursorFromRecords, cursorFromTrace, cursorIdleFade, deltaE, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docStillTime, docToCropSpace, docToFullSpace, docTransitions, docZoomTrack, dragsFromTrack, dropTemplate, duckCurve, effectiveSegments, elapsedFor, endCardClips, enterKey, enterOf, entranceAt, entranceEnd, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, findStep, focusBounds, focusForViewportCentre, followFocusEvents, formatElapsed, frameGeometry, freezeLane, freezeOutputExtents, hasElapsed, hexToRgb, hexToRgbTriplet, houseLook, htmlLayerBleed, htmlLayerBleedFor, htmlLayerFaces, htmlLayerKey, htmlLayerLabel, htmlLayerPayload, htmlLayerPictureBox, htmlLayerProblems, htmlLayerSvg, htmlLayerText, htmlLayerUnhostedFamilies, htmlLayerWidth, htmlStarterClip, idleGaps, idleKey, isKeyedOverlay, isLookKind, isLoweredRecording, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layoutOf, levelForFocusFraction, liveZoomStyleName, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, marksEmphasis, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, migrateText, migrateTextClip, migrateZoomStyle, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayPinPoseAt, overlayPlainText, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parseCssColour, parsePoseId, pickChange, pickStyle, pinBox, pinCandidates, pinPlacement, pinRectOnScreen, pinReferent, pinReferentAt, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, playwrightTraceEntry, programDuration, programStillTime, projectFromArtifact, pumpFreeChainGap, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, relativeLuminance, removeSourceRange, removeSpeedInRange, resolveAnchor, resolveExportSize, resolveOverlayAnchors, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, snapRunWeight, sourceMomentToOutput, spanOutputExtent, speedLane, stepElapsedMs, studioAudioPlan, studioEntry, studioLayerData, styledTextOf, textRunsOf, tiltLane, tiltTrackFromDoc, traceKindOf, transitionMult, transitionSeconds, unionFitLevel, unionRect, videoLane, voiceKey, wellFormedXml, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zipEntries, zipEntryBytes, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomView, zoomViewport, zoomWindow };
+export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, type AnchorMiss, type AnchorResolution, type Anim, type AnimKind, type AnimSide, type AnimStep, type AppliedTemplate, type ApplyTemplateOptions, type AspectRatioOption, type AudioClip, type AudioLoudness, type AudioPlanPoint, type AudioPlanTrack, BACKGROUND_Z, BASE_FRAME_STYLE, type Backdrop, type BackgroundMedia, type BakeResult, type BakedText3dAsset, type BakedText3dMaterial, type BrowserBarStyle, type BuildDigestInput, CALLOUT_DEFAULT_BODY_PX, CALLOUT_SHAPES, CALLOUT_TYPE_RATIO, CAMERA_CENTRE_RAMP, CAMERA_COVER_MIN, CAMERA_FAR, CAMERA_NEAR, CAM_CHAIN_GAP, CAM_EASE, CAM_PAN, CAM_PAN_EASE, CAM_RAMP_IN, CAM_RAMP_OUT, CAM_SIZE_MAX, CAM_SIZE_MIN, CAM_SPAN_MIN, CAPTURE_COVERAGE_MIN, CARD_EDGE_OVERDRAW, CARD_ENTER_KINDS, CARD_EXIT_KINDS, CARD_FADE_SECONDS, CARD_FOV, CARD_Z, CHANGE_FLOOR, CHANGE_GRID, CHANGE_LEAD, CHANGE_OFFSETS, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_HOLD_MS, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, CLUSTER_FILL, CROP_MAX_PX, CROP_MIN_FRAC, CROP_MIN_PX, CROP_PAD, CURSOR_IDLE_EPS_FRAC, CURSOR_IDLE_FADE_IN, CURSOR_IDLE_FADE_OUT, CURSOR_IDLE_HOLD, type CalloutBox, type CalloutClipOptions, type CalloutLook, type CalloutRegister, type CalloutShape, type CalloutWords, type CamBubbleRect, type CamPoseSpan, type CamStyle, type CameraModel, type CaptureNormalization, type CardLayout, type ChangeSample, type ChangeWitness, type ChangedRegion, type ClickFxStyle, type ClipGain, type ClipGainBasis, type CopiedLayout, type CopyLayoutOptions, type CopyStyleOptions, type CursorEvent, type CursorFadeKey, type CursorIdleOptions, type CursorStyle, type CursorTrack, DARK_GROUND, DEFAULT_BROWSER_BAR, DEFAULT_CAM_POSE, DEFAULT_CAM_STYLE, DEFAULT_CLICK_FX, DEFAULT_CURSOR_STYLE, DEFAULT_DUCK, DEFAULT_FRAME_STYLE, DEFAULT_SPEED_PARAMS, DEFAULT_TILT_POSE, DEFAULT_ZOOM_LEVEL, DEFAULT_ZOOM_STYLE, DESIGN_FRAME_WIDTH, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_FEATURES, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, DRAG_MIN_S, DRAG_MIN_TRAVEL_FRAC, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocFeature, type DocSegment, type Drag, type DuckOptions, ELAPSED_PLACEHOLDER, END_CARD_FROM, END_CARD_RECEDE, END_CARD_SECONDS, ENTRANCE_SECONDS, EXPORT_RESOLUTION_OPTIONS, EXPORT_SHORT_EDGE, type EndCard, type EnvelopePoint, type ExportResolution, type ExtractClickOptions, FOLLOW_RECENTER, FOLLOW_SAFE_RATIO, FOOTAGE_FRAME_STYLE, FRAME_BORDER_COLOR_DEFAULT, FRAME_BORDER_DEFAULT, FRAME_BORDER_WIDTH_DEFAULT, FREEZE_DEFAULT_SECONDS, FREEZE_SECONDS_MAX, FREEZE_SECONDS_MIN, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, type FreezeExtent, type FreezeSpan, HOLD_DRIFT_MAX, HOUSE_GRADIENT, HOUSE_REGISTER, HTML_LAYER_FOREIGN_FIELDS, HTML_LAYER_MAX_BYTES, HTML_LAYER_SVG_CODE, HTML_LAYER_WARN_BYTES, HTML_STARTERS, type HtmlLayerFace, type HtmlLayerInlineFace, type HtmlLayerPayload, type HtmlLayerProblem, type HtmlLayerProblemCode, type HtmlLayerSource, type HtmlOverlayClip, type HtmlOverlayFont, type HtmlStarter, IDLE_KINDS, type IdleKind, type IngestOptions, LAYER_CARD_SHADOW, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayerCard, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, type LumaGrid, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MEDIA_FRAME_KEYS, MEDIA_KEY_PREFIX, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type Media, type MediaFrame, type MediaFrameKey, type MediaOverlayClip, type MediaSegment, type MicRms, type MinimalBarTheme, type Moment, type MomentKind, type MomentsOptions, type MotionKey, type MotionPose, type MotionPose3D, type MusicBedInput, NORMALIZE_MAX_LIFT_DB, NORMALIZE_MAX_LUFS, NORMALIZE_MIN_LUFS, NORMALIZE_PEAK_CEILING_DB, type NormRect, OBJECT_DEFAULT_SCALE, OVERLAY_FONT_FACES, OVERLAY_LINE_HEIGHT, OVERLAY_MEDIA_DEFAULT_RADIUS, OVERLAY_MEDIA_DEFAULT_WIDTH, OVERLAY_MIN_DURATION, OVERLAY_SCALE_MAX, OVERLAY_SIZE_MAX, OVERLAY_SIZE_MIN, OVERLAY_TRANSITION_DUR, OVERLAY_Z, type ObjectAnimation, type ObjectAsset, type ObjectClip, type ObjectPrimitiveShape, type OutputExtent, type OverlayAnchor, type OverlayClip, type OverlayFontFace, type OverlayKind, type OverlayPin, type OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PIN_GAP, PIN_MARGIN, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, PROGRAM_RETIME, PUMP_REST, type PeerStepSpan, type PeerTrack, type PinCandidate, type PinCarry, type PinMark, type PinPlacement, type PinPlacementInput, type PinReferent, type PinSide, type PinSideResolved, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REPLAY_EPS, REST_TILT_ID, RETIRED_ZOOM_STYLES, type RecordingArtifact, type RecordingMeta, type RecordingNotice, type RecordingOutput, type RecordingPageMedia, type RecordingSkip, type Rect, type RejectedLane, type RejectedSpan, type ReplayedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, type Rgb, SCENE_MOTION, SCENE_QUIET, SEGMENT_ENTER_KINDS, SEGMENT_EXIT_KINDS, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STILL_DEFAULT, STUDIO_ENTRY_ID, STYLE_FIELDS, type SegmentExtent, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, type StyledText, TEXT3D_DEPTH_DEFAULT, TEXT3D_DEPTH_MAX, TEXT3D_DEPTH_MIN, TEXT_ENTER_KINDS, TEXT_EXIT_KINDS, TEXT_PRESETS, TILT_AUTO_DEAD_ZONE, TILT_AUTO_MIN, TILT_CHAIN_GAP, TILT_DEG_MAX, TILT_EASE, TILT_INTENSITY_MAX, TILT_PAN, TILT_PAN_EASE, TILT_RAMP_IN, TILT_RAMP_OUT, TILT_SPAN_MIN, TILT_UI_DEG_MAX, TRANSITION_SECONDS, TRANSITION_SECONDS_MAX, TRANSITION_SECONDS_MIN, TRANSITION_SPEED_MULT, type TemplateAnchor, type Text3dMaterial, type TextFxDirection, type TextFxKind, type TextFxSpec, type TextFxUnit, type TextOverlayBox, type TextOverlayClip, type TextOverlayPreset, type TextOverlayStroke, type TiltPersonality, type TiltSpan, type TiltStyleName, type TraceFileKind, type TraceOptions, type TraceResult, type TranscriptSegment, type Transition, type TransitionKind, type TransitionMove, type TransitionOut, type TransitionSpeed, type UsedFeature, WINDOW_FOCUS_MIN, ZOOM_CHAIN_GAP, ZOOM_EASE, ZOOM_LEVELS, ZOOM_LEVEL_MAX, ZOOM_LEVEL_MIN, ZOOM_PAN, ZOOM_PAN_EASE, ZOOM_RAMP_IN, ZOOM_RAMP_IN_OVERLAP, ZOOM_RAMP_OUT, ZOOM_SPAN_MIN, ZOOM_STYLES, ZOOM_STYLE_OPTIONS, type ZipEntry, type ZoomScreen, type ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomView, type ZoomWindow, ambientDrift, anchorKindOf, anchorSourceDuration, anchoredClip, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, bakeDocFeatures, boldWeightFor, buildDigest, calloutBox, calloutClip, calloutGroundOf, calloutLook, calloutSource, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cameraCentring, cameraModel, cameraRestWindows, cameraRests, cameraSpanExtents, cardEnter, cardExit, cardFields, cardInset, cardPointToScreen, cardPoseTrack, changedRegion, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipGain, clipLength, clipsFrom, compareVersions, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cssFamilies, cssWeights, cursorFromCsv, cursorFromPlaywrightTrace, cursorFromRecords, cursorFromTrace, cursorIdleFade, deltaE, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFeatures, docFreezes, docMediaList, docOutputDuration, docRestTime, docStillTime, docToCropSpace, docToFullSpace, docTransitions, docZoomTrack, dragsFromTrack, dropTemplate, duckCurve, effectiveSegments, elapsedFor, endCardClips, enterKey, enterOf, entranceAt, entranceEnd, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, featuresNewerThan, findStep, focusBounds, focusForViewportCentre, followFocusEvents, formatElapsed, frameGeometry, freezeLane, freezeOutputExtents, hasElapsed, hasReplay, hexToRgb, hexToRgbTriplet, houseLook, htmlLayerBleed, htmlLayerBleedFor, htmlLayerFaces, htmlLayerKey, htmlLayerLabel, htmlLayerPayload, htmlLayerPictureBox, htmlLayerProblems, htmlLayerSvg, htmlLayerText, htmlLayerUnhostedFamilies, htmlLayerWidth, htmlStarterClip, idleGaps, idleKey, isKeyedOverlay, isLookKind, isLoweredRecording, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layerStart, layoutOf, levelForFocusFraction, liveZoomStyleName, longestOutputExtent, lookFromBrand, lookKindForGround, loudnessMatches, lowerProgramDoc, lowerStudioDoc, lowerToComposition, marksEmphasis, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, migrateText, migrateTextClip, migrateZoomStyle, momentOutputs, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayPinPoseAt, overlayPlainText, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parseCssColour, parsePoseId, pickChange, pickStyle, pinBox, pinCandidates, pinPlacement, pinRectOnScreen, pinReferent, pinReferentAt, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, playwrightTraceEntry, programDuration, programStillTime, projectFromArtifact, pumpFreeChainGap, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, relativeLuminance, removeSourceRange, removeSpeedInRange, replayFlags, replayedSeconds, resolveAnchor, resolveExportSize, resolveOverlayAnchors, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, snapRunWeight, sourceMomentToOutput, spanOutputExtent, spanOutputExtents, speedLane, stepElapsedMs, stepMomentToOutput, studioAudioPlan, studioEntry, studioLayerData, styledTextOf, textRunsOf, tiltLane, tiltTrackFromDoc, traceKindOf, transitionMult, transitionSeconds, unionFitLevel, unionRect, videoLane, voiceKey, wellFormedXml, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zipEntries, zipEntryBytes, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomView, zoomViewport, zoomWindow };