@vosjs/studio-core 0.42.5 → 0.44.0

package/README.md

@@ -29,11 +29,13 @@ RecordingArtifact ──projectFromArtifact──▶ ProjectDoc ──lowerStudi
 
 `StudioDoc = ProjectDoc | ProgramAnchorDoc`, discriminated on `source`. A `ProjectDoc` is a recording: footage, `segments` (the kept source spans), `zoom`, `speed`, `tilt`, `camMotion`, the frame and cursor styles, plus the shared layers. A `ProgramAnchorDoc` is a vos program that gained the same shared layers (text, image and video overlays, 3D objects, audio clips, speed spans, a tween-retime overlay) without those being written into its config. `anchorKindOf`, `isRecordingDoc` and `isProgramDoc` read the discriminator; `lowerProgramDoc` lowers the program kind. Hosted documents carry `docSchemaVersion` (`DOC_SCHEMA_VERSION`, currently 2) and are upgraded on read with `migrateHostedDoc`.
 
-The shared layers lower as one engine `stack` entry, `STUDIO_ENTRY_ID` (`'vosso.studio'`), with its own data (`studioLayerData`), so either document kind hosts them and the engine's `SET_DATA { target }` updates them alone. `studioAudioPlan` turns the entry's audio clips and duck curve into the plan `@vosjs/core/audio` mixes.
+The shared layers lower as one engine `stack` entry, `STUDIO_ENTRY_ID` (`'vosso.studio'`), with its own data (`studioLayerData`), so either document kind hosts them and the engine's `SET_DATA { target }` updates them alone. `studioAudioPlan` turns the entry's audio clips and duck curve into the plan `@vosjs/core/audio` mixes. An audio clip's `gain` is 0..1; a clip may carry a loudness target instead, `normalize` (integrated LUFS, -30..-6), beside the file's measured `loudness` (`{ lufs, peakDb, at, src }`, written by tooling): `clipGain` derives the gain it plays at, `10^((normalize - lufs) / 20) × gain`, which may exceed 1 and is capped so the sample peak stays under -1 dBFS (and never lifts more than +24 dB). The target applies only while `loudness.src` is the clip's `key`; a clip without one lowers byte for byte as before.
+
+**What a renderer must understand.** `DOC_FEATURES` lists the document fields a host's lowering must read, each with the release that first renders it and a predicate that finds it (`docFeatures(doc)`, `featuresNewerThan(doc, version)`), so a tool that hands a document to a host on an older release can say so before it is sent. `bakeDocFeatures(doc, version)` returns a copy with each newer feature it can bake said in what that release reads: an anchored caption at the start it plays at in this cut, `{elapsed}` filled, a loudness target as its gain (up to 1), with notes for what changed.
 
 ## Time and space conventions
 
-- **Seconds everywhere.** Zoom, speed, tilt and cam-motion spans and the cursor samples are anchored in source time, so they follow footage through trims. Overlays, audio clips and click effects are anchored in output time, so a title keeps its perceived length through a speed change. `ratedSegments`, `effectiveSegments`, `docOutputDuration` and `outputRangeToSource` are the remaps.
+- **Seconds everywhere.** Zoom, speed, tilt and cam-motion spans and the cursor samples are anchored in source time, so they follow footage through trims. Overlays, audio clips and click effects are anchored in output time, so a title keeps its perceived length through a speed change. An overlay may instead name a recorder step as its time (`anchor: { step, media?, at?, offset? }`): the lowering starts it where that step plays in the cut (`resolveOverlayAnchors`, `resolveAnchor`, `sourceMomentToOutput`), its `start` the fallback, and fills a text layer's `{elapsed}` from the step's recorded off-camera wait (`formatElapsed`). `ratedSegments`, `effectiveSegments`, `docOutputDuration` and `outputRangeToSource` are the remaps.
 - **Normalized coordinates.** A zoom's `cx`/`cy` and an overlay's `transform.x`/`y` are fractions of the frame in `[0, 1]`, never pixels, so a document survives an aspect-ratio switch. `focusBounds` and `clampFocus` keep a focus inside the card at a given `level`.
 - **Camera styles.** `ZOOM_STYLES` names six camera personalities (`glide`, the default, then `focus`, `cinema`, `snappy`, `cut`, `none`); a style parametrizes the planner, the camera motion and the tilt track's tempo, and `doc.zoomParams` layers per-document overrides. `keynote` and `drift` are retired names (`RETIRED_ZOOM_STYLES`) that resolve to `glide` + medium tilt and `cinema` + subtle tilt, and `migrateHostedDoc` rewrites them on read. Every style's chain gap sits above its pump-free floor (`pumpFreeChainGap`), and the lowering fits a ramp longer than its span to the room it has, never below `RAMP_FLOOR`.
 - **The stage.** `CARD_FOV`, `CARD_Z`, `OVERLAY_Z`, `BACKGROUND_Z` and `planeSizeAtDepth` define the frustum-filling planes the program draws (background, the tiltable card, the overlay); `cardVisibleExtent` and `cardOverscanFor` are how far a posed card is seen past the frame, which is what the card layer's canvas and plane grow by (so a lean over zoomed footage never shows the texture's edge); `computeCardLayout` and `docCardLayout` are the host-side mirror of the program's card math, pinned to it by tests.
@@ -49,20 +51,20 @@ The shared layers lower as one engine `stack` entry, `STUDIO_ENTRY_ID` (`'vosso.
 
 ## Exports by area
 
-| Area           | Exports                                                                                                                                                                                                                                                           |
-| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Ingest         | `projectFromArtifact`, `normalizeCaptureSpace`, `deriveViewportCrop`, `docToCropSpace`, `docToFullSpace`, `CAPTURE_COVERAGE_MIN`, `WINDOW_FOCUS_MIN`                                                                                                              |
-| Document       | `StudioDoc`, `ProjectDoc`, `ProgramAnchorDoc`, `anchorKindOf`, `isRecordingDoc`, `isProgramDoc`, `DOC_SCHEMA_VERSION`, `migrateHostedDoc`, `DEFAULT_FRAME_STYLE`, `BASE_FRAME_STYLE`, the constants (`ZOOM_LEVELS`, `TILT_DEG_MAX`, …)                            |
-| Planners       | `planAutoZoom`, `planAutoSpeed`, `planAutoTilt`, `smoothCursor`, `idleGaps`, `scrollRuns`, `rejectSpan`, `isRejected`, `withoutRejected`                                                                                                                          |
-| Camera styles  | `ZOOM_STYLES`, `ZOOM_STYLE_OPTIONS`, `DEFAULT_ZOOM_STYLE`, `resolveZoomStyle`, `RETIRED_ZOOM_STYLES`, `pumpFreeChainGap`                                                                                                                                          |
-| Lowering       | `lowerStudioDoc`, `lowerProgramDoc`, `lowerToComposition`, `zoomTrackFromDoc`, `tiltTrackFromDoc`, `camTrackFromDoc`, `motionTrack`, `followFocusEvents`, `extractClicks`, `cursorIdleFade`, `ratedSegments`, `STUDIO_ENTRY_ID`, `studioEntry`, `studioLayerData` |
-| Layout         | `computeCardLayout`, `docCardLayout`, `focusBounds`, `clampFocus`, `camBubbleRectAt`, `overlayRect`, `overlayHit`, `CARD_FOV`, `CARD_Z`, `planeSizeAtDepth`, `recommendedExportResolution`                                                                        |
-| Text           | `TEXT_PRESETS`, `OVERLAY_FONT_FACES`, `resolveOverlayStyle`, `resolveOverlayBox`, `resolveText3dAsset`                                                                                                                                                            |
-| Audio          | `studioAudioPlan`, `clipEnvelope`, `duckCurve`, `computePeaks`, `computeMicRms`, `voiceKey`, `musicBedClip`, `refillAudioBeds`                                                                                                                                    |
-| Backdrops      | `withBackdrop`, `backdropMedia`                                                                                                                                                                                                                                   |
-| Digest         | `momentsFromDoc`, `planForDigest`, `buildDigest`, `sceneChanges`, `zoomCoversRect`, `zoomWindow`, `cropBox`, `frameGeometry`, `STYLE_FIELDS`, `copyStyle`, `pickStyle`, `DIGEST_VERSION`                                                                          |
-| Destinations   | `DESTINATIONS`, `destinationById`, `destinationsForChannel`, `exportSizeFor`, `resolveExportSize`, `ASPECT_RATIOS`                                                                                                                                                |
-| Timeline lanes | `videoLane`, `micLane`, `camLane`, `zoomLane`, `tiltLane`, `camMoveLane`, `speedLane`, `overlaysLane`, `objectsLane`, `audioLane`; range actions `outputRangeToSource`, `removeSourceRange`, `setSpeedInRange`, `zoomSpanForRange`                                |
+| Area           | Exports                                                                                                                                                                                                                                                                                    |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Ingest         | `projectFromArtifact`, `normalizeCaptureSpace`, `deriveViewportCrop`, `docToCropSpace`, `docToFullSpace`, `CAPTURE_COVERAGE_MIN`, `WINDOW_FOCUS_MIN`                                                                                                                                       |
+| Document       | `StudioDoc`, `ProjectDoc`, `ProgramAnchorDoc`, `anchorKindOf`, `isRecordingDoc`, `isProgramDoc`, `DOC_SCHEMA_VERSION`, `migrateHostedDoc`, `DEFAULT_FRAME_STYLE`, `BASE_FRAME_STYLE`, the constants (`ZOOM_LEVELS`, `TILT_DEG_MAX`, …)                                                     |
+| Planners       | `planAutoZoom`, `planAutoSpeed`, `planAutoTilt`, `smoothCursor`, `idleGaps`, `scrollRuns`, `rejectSpan`, `isRejected`, `withoutRejected`                                                                                                                                                   |
+| Camera styles  | `ZOOM_STYLES`, `ZOOM_STYLE_OPTIONS`, `DEFAULT_ZOOM_STYLE`, `resolveZoomStyle`, `RETIRED_ZOOM_STYLES`, `pumpFreeChainGap`                                                                                                                                                                   |
+| Lowering       | `lowerStudioDoc`, `lowerProgramDoc`, `lowerToComposition`, `zoomTrackFromDoc`, `tiltTrackFromDoc`, `camTrackFromDoc`, `motionTrack`, `followFocusEvents`, `extractClicks`, `cursorIdleFade`, `ratedSegments`, `resolveOverlayAnchors`, `STUDIO_ENTRY_ID`, `studioEntry`, `studioLayerData` |
+| Layout         | `computeCardLayout`, `docCardLayout`, `focusBounds`, `clampFocus`, `camBubbleRectAt`, `overlayRect`, `overlayHit`, `CARD_FOV`, `CARD_Z`, `planeSizeAtDepth`, `recommendedExportResolution`                                                                                                 |
+| Text           | `TEXT_PRESETS`, `OVERLAY_FONT_FACES`, `resolveOverlayStyle`, `resolveOverlayBox`, `resolveText3dAsset`                                                                                                                                                                                     |
+| Audio          | `studioAudioPlan`, `clipEnvelope`, `duckCurve`, `computePeaks`, `computeMicRms`, `voiceKey`, `musicBedClip`, `refillAudioBeds`                                                                                                                                                             |
+| Backdrops      | `withBackdrop`, `backdropMedia`                                                                                                                                                                                                                                                            |
+| Digest         | `momentsFromDoc`, `planForDigest`, `buildDigest`, `sceneChanges`, `zoomCoversRect`, `zoomWindow`, `cropBox`, `frameGeometry`, `STYLE_FIELDS`, `copyStyle`, `pickStyle`, `DIGEST_VERSION`                                                                                                   |
+| Destinations   | `DESTINATIONS`, `destinationById`, `destinationsForChannel`, `exportSizeFor`, `resolveExportSize`, `ASPECT_RATIOS`                                                                                                                                                                         |
+| Timeline lanes | `videoLane`, `micLane`, `camLane`, `zoomLane`, `tiltLane`, `camMoveLane`, `speedLane`, `overlaysLane`, `objectsLane`, `audioLane`; range actions `outputRangeToSource`, `removeSourceRange`, `setSpeedInRange`, `zoomSpanForRange`                                                         |
 
 The full document shape is in [`src/types.ts`](src/types.ts); the JSON Schema that ships to users is [`doc.schema.json`](../cli/schema/doc.schema.json) in `@vosjs/cli`.
 

package/dist/index.d.ts

@@ -495,6 +495,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
@@ -505,6 +512,68 @@ interface RecordingMeta {
         as: 'blur' | 'text';
         hits: number;
     }[];
+    /** The cuts `await` steps made, in order (CLI takes only). */
+    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
@@ -580,6 +649,62 @@ interface StepSpan {
      * payload, which a layer quotes instead of replaying the flow.
      */
     text?: string;
+    /**
+     * The step carries a guard (`"spend"`): `confirmed` says the recording
+     * pressed it because the command named it; a rehearsal only hovers one
+     * and leaves `confirmed` absent.
+     */
+    guard?: 'spend';
+    confirmed?: boolean;
+    /**
+     * An `await` step: the wall-clock ms it waited OFF CAMERA. The footage
+     * clock stood still meanwhile, so `tStart`..`tEnd` hold only the
+     * moments around the cut, which is at `tStart` (`meta.skips[]`).
+     */
+    offCameraMs?: number;
+    /** An `await` that gave up and let the take go on (`onTimeout: "continue"`). */
+    timedOut?: boolean;
+    /** A failed `expect`, a download that never came: why the step was skipped. */
+    reason?: string;
+    /**
+     * A rehearsal did not wait on this `expect` or `await`: it follows the
+     * guarded step at this index, which a rehearsal never presses, so what it
+     * 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
+ * footage runs straight from the moment before the wait to the moment
+ * after. `at` is the SOURCE second of the cut, `ms` the wall time that
+ * did not reach the footage. A fresh plan starts a segment there.
+ */
+interface RecordingSkip {
+    step: number;
+    id?: string;
+    at: number;
+    ms: number;
+    timedOut?: boolean;
+}
+/** A file a `download` step kept, in the take's `outputs/`. */
+interface RecordingOutput {
+    step: number;
+    id?: string;
+    /** the file name inside `outputs/` */
+    name: string;
+    bytes: number;
+    contentType?: string;
 }
 /** Everything the capture extension hands off to the studio. */
 interface RecordingArtifact {
@@ -1018,8 +1143,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;
@@ -1031,6 +1169,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;
@@ -1355,8 +1515,8 @@ type PinMark = 'none' | 'ring' | 'underline';
  * a hairline between them (a connector) and a standing mark on the subject.
  * One of `step`, `press` or `rect` names it. Resolved at lowering into the
  * clip's motion track through the frame's camera; `transform.x/y` stay the
- * author's fallback for a pin that cannot resolve. Not the re-record
- * `anchor` (a time tie the lowering never reads).
+ * author's fallback for a pin that cannot resolve. A pin is PLACE; a
+ * layer's `anchor` (OverlayAnchor) is its TIME.
  */
 interface OverlayPin {
     /** A recorder step (`meta.steps[].id`, else its index) whose element
@@ -1381,6 +1541,28 @@ interface OverlayPin {
      *  dark rim, legible on any ground). */
     color?: string;
 }
+/**
+ * A layer's TIME tie to a recorder step: the layer starts where that step
+ * plays in the cut. Unlike a span's `StepAnchor` (re-record metadata the
+ * lowering never reads), this one IS read at lowering: the step's moment
+ * on its media (`meta.steps`, SOURCE seconds) is mapped through the
+ * segments, speed spans and freezes exactly as a source-anchored span is,
+ * 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.
+ */
+interface OverlayAnchor {
+    /** The step: its `id` (`meta.steps[].id`) when it has one, else its index. */
+    step: string | number;
+    /** Whose steps: a `media[].id`; absent = the primary's. */
+    media?: string;
+    /** Which edge of the step is its moment. Default 'start'. */
+    at?: 'start' | 'end';
+    /** OUTPUT seconds after the step's moment (negative = before). Default 0. */
+    offset?: number;
+}
 interface OverlayClipBase {
     /** Stable identity for selection/editing in the timeline UI. */
     id: string;
@@ -1394,6 +1576,12 @@ interface OverlayClipBase {
      * opacity, and their x/y are ignored.
      */
     pin?: OverlayPin;
+    /**
+     * When the layer starts, as a recorder step (see OverlayAnchor): read at
+     * lowering, `start` the fallback. A text layer's `{elapsed}` fills with
+     * the anchored step's off-camera wait, when the recorder kept one.
+     */
+    anchor?: OverlayAnchor;
     /**
      * How the clip enters and leaves (see Anim). Absent = the house motion:
      * a rise in, a fade out.
@@ -4315,10 +4503,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;
 
@@ -4702,6 +4890,84 @@ interface SegmentExtent {
  */
 declare function segmentOutputExtents(doc: StudioDoc): SegmentExtent[];
 
+/** The placeholder a text layer's words may carry. */
+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).
+ */
+declare function sourceMomentToOutput(rated: readonly (Segment & {
+    media?: string;
+})[], t: number, media?: string): number | null;
+/** Why an anchor did not resolve. */
+type AnchorMiss = 'media' | 'step' | 'skipped' | 'cut';
+interface AnchorResolution {
+    /** OUTPUT seconds the layer starts at; null when the anchor did not resolve. */
+    start: number | null;
+    /** The step it names, when found. */
+    step?: StepSpan;
+    /** Why it did not resolve. */
+    miss?: AnchorMiss;
+    /**
+     * The off-camera wait `{elapsed}` fills with, in ms: the step's own, else
+     * the nearest earlier step's on the same media (see `elapsedFrom`).
+     */
+    elapsedMs?: number;
+    /**
+     * Set when the wait is an EARLIER step's: the step after an await is the
+     * natural place for "12 minutes later", and that step waited for nothing.
+     */
+    elapsedFrom?: StepSpan;
+}
+/**
+ * The off-camera wait the recorder kept for a step: the entry of
+ * `meta.skips` that names the step (by its id or its index) with an `ms`,
+ * else `offCameraMs` on the step itself. A step's own `ms` is never read:
+ * in a script it is a reading time, not a wait. Read defensively: an older
+ * take carries neither.
+ */
+declare function stepElapsedMs(meta: Pick<RecordingMeta, 'steps'> & {
+    skips?: unknown;
+}, step: StepSpan): number | null;
+/**
+ * The wait `{elapsed}` speaks of for a step: its own, else the nearest
+ * earlier step's (by script order) on the same media, so a caption on the
+ * beat that lands after an await reads that await. Null with none at all.
+ */
+declare function elapsedFor(meta: Pick<RecordingMeta, 'steps'> & {
+    skips?: unknown;
+}, step: StepSpan): {
+    ms: number;
+    from?: StepSpan;
+} | null;
+/** Resolve one anchor against the document and its rated pieces. */
+declare function resolveAnchor(doc: Pick<ProjectDoc, 'source' | 'media'>, anchor: OverlayAnchor, rated: readonly (Segment & {
+    media?: string;
+})[]): AnchorResolution;
+/**
+ * A wait as a person says it: "40 seconds", "12 minutes", "2 hours",
+ * "3 days". Rounded to the unit that reads: whole seconds under ten,
+ * fives under a minute, whole minutes under an hour, whole hours under two
+ * days.
+ */
+declare function formatElapsed(ms: number): string;
+/** Does a layer's text carry the `{elapsed}` placeholder? */
+declare function hasElapsed(text: RichText | undefined): boolean;
+/** One anchored layer as it plays: its start resolved, its `{elapsed}` filled. */
+declare function anchoredClip<C extends OverlayClip>(clip: C, doc: Pick<ProjectDoc, 'source' | 'media'>, rated: readonly (Segment & {
+    media?: string;
+})[]): C;
+/**
+ * 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.
+ */
+declare function resolveOverlayAnchors<D extends Pick<ProjectDoc, 'source' | 'media' | 'overlays'>>(doc: D, rated: readonly (Segment & {
+    media?: string;
+})[]): D;
+
 /**
  * Many media in one take, one rule: a recording is media plus the FACTS
  * only a capture has, and `doc.source` is the PRIMARY media (the subject:
@@ -5272,6 +5538,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
@@ -5391,4 +5753,4 @@ declare function rejectSpan(rejected: RejectedSpan[] | undefined, lane: Rejected
     anchor?: StepAnchor;
 }, note?: string): RejectedSpan;
 
-export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, 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, 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 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 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, 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, endCardClips, enterKey, enterOf, entranceAt, entranceEnd, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, findStep, focusBounds, focusForViewportCentre, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, 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, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, snapRunWeight, spanOutputExtent, speedLane, 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 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 RecordingNotice, type RecordingOutput, type RecordingPageMedia, 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, 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, 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, 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, loudnessMatches, 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 };