@vosjs/studio-core 0.10.0 → 0.11.1

package/dist/index.d.ts

@@ -781,6 +781,8 @@ interface AudioClip {
     loopLen?: number;
     /** duck this clip under the mic while speech is detected. */
     duck?: boolean;
+    /** The template that placed this clip (see the overlay clip's `from`). */
+    from?: string;
 }
 /** Effective placed length of a clip on the output timeline, seconds. */
 declare function clipLength(clip: Pick<AudioClip, 'in' | 'out' | 'loop' | 'loopLen'>): number;
@@ -898,8 +900,16 @@ interface FrameStyle {
      * zoomed in and pulls out; `rise` settles up and in flat. Lowered into
      * the tilt or zoom track's head and a card-pose track, so the card's only
      * rotation is still the tilt track. Absent = none, byte-identical.
+     * @deprecated The card's `anim.enter`; migrated on read.
      */
     entrance?: FrameEntrance;
+    /**
+     * How the card ENTERS at t = 0 and LEAVES when its footage ends (`recede`
+     * settles it smaller and dimmer behind whatever plays after it; `fade`
+     * takes it out). Past its footage the card holds its last frame at the
+     * exit's end pose. Absent = neither, byte-identical.
+     */
+    anim?: Anim;
     /**
      * Under `fit:'cover'`, follow the zoom track's focus with the crop
      * (`'camera'`), so a 9:16 cut of a 16:9 take keeps the affordance in
@@ -916,6 +926,8 @@ interface FrameEntrance {
  * The end card: the last frame holds for `seconds` while the card recedes
  * and the words rise over it (the house title, caption and label presets,
  * so they lower like any overlay). The clip's last frame is its poster.
+ * @deprecated A card `anim.exit` plus clips placed after the footage
+ * (`from: 'endcard'`); migrated on read.
  */
 interface EndCard {
     seconds?: number;
@@ -950,6 +962,38 @@ type OverlayKind = 'text' | 'image' | 'video';
 type TextOverlayPreset = 'title' | 'caption' | 'label';
 /** Enter/exit transition presets — pure f(t), evaluated in ON_FRAME. */
 type OverlayTransition = 'none' | 'fade' | 'rise';
+/**
+ * THE animation vocabulary, one for every visual primitive. Which kinds a
+ * thing accepts is its own (`anim.ts` holds the tables): the card enters by
+ * `tilt-in`, `pull-out`, `rise` or `fade` and leaves by `recede` or `fade`;
+ * words enter by the block transitions or per unit (`pop`, `blur`,
+ * `typewriter`, or a `fade`/`rise` that names its unit); an image or a
+ * video clip enters and leaves by `fade` or `rise`; a prop idles by `spin`
+ * or `float`. `none` is an explicit nothing; absent is the house default.
+ */
+type AnimKind = 'none' | 'fade' | 'rise' | 'pop' | 'blur' | 'typewriter' | 'tilt-in' | 'pull-out' | 'recede';
+/** What a thing does while it stays. */
+type IdleKind = 'spin' | 'float';
+/**
+ * One step of an animation: the kind, its seconds, and for words the
+ * per-unit grammar. A bare kind is the same step with the house timing.
+ */
+interface AnimStep {
+    kind: AnimKind;
+    /** Seconds the step takes (the house length when absent). */
+    seconds?: number;
+    /** Words only: the unit the step animates by (`block` = the whole clip). */
+    unit?: TextFxUnit;
+    /** Words only: the order units animate in. */
+    direction?: TextFxDirection;
+    /** Words only: seconds between one unit's start and the next. */
+    stagger?: number;
+}
+interface Anim {
+    enter?: AnimKind | AnimStep;
+    exit?: AnimKind | AnimStep;
+    idle?: IdleKind | null;
+}
 /** Text animation vocabulary — entrance presets evaluated per unit. */
 type TextFxKind = 'fade' | 'rise' | 'pop' | 'blur' | 'typewriter';
 type TextFxUnit = 'block' | 'line' | 'word' | 'char';
@@ -1025,7 +1069,20 @@ interface OverlayClipBase {
     start: number;
     duration: number;
     transform: OverlayTransform;
-    /** Absent = 'rise' for enter, 'fade' for exit (the house default motion). */
+    /**
+     * How the clip enters and leaves (see Anim). Absent = the house motion:
+     * a rise in, a fade out.
+     */
+    anim?: Anim;
+    /**
+     * The template that placed this clip (a vos id, or a legacy marker),
+     * provenance the lowering never reads: a loop drops a template's clips,
+     * a re-apply replaces one template's and leaves the maker's.
+     */
+    from?: string;
+    /**
+     * @deprecated `anim.enter` / `anim.exit`; migrated on read.
+     */
     enter?: OverlayTransition;
     exit?: OverlayTransition;
     /**
@@ -1069,7 +1126,9 @@ interface TextOverlayClip extends OverlayClipBase {
     stroke?: TextOverlayStroke;
     /** Background pill behind the text block (absent = none). */
     box?: TextOverlayBox;
-    /** Entrance animation. Absent = the legacy `enter` transition. */
+    /**
+     * @deprecated A per-unit `anim.enter` step; migrated on read.
+     */
     fx?: TextFxSpec;
     /**
      * Wrap width as a FRACTION of the frame width [0.1..1] (the transform.x
@@ -1242,6 +1301,11 @@ interface ObjectClip {
         /** Fraction of the frame height. */
         scale: number;
     };
+    /** What the prop does while it stays (`anim.idle`), and how it comes and goes. */
+    anim?: Anim;
+    /** The template that placed this prop (see the overlay clip's `from`). */
+    from?: string;
+    /** @deprecated `anim.idle`; migrated on read. */
     animation?: ObjectAnimation | null;
     /** Pose keyframes (see MotionPose3D). Absent lowers byte-identically. */
     motion?: MotionPose3D[];
@@ -1604,28 +1668,21 @@ declare function projectFromArtifact(artifact: RecordingArtifact, videoUrl: stri
 };
 
 /**
- * Hosted-doc schema versioning: the scoped reversal of "ProjectDocs
- * are never persisted" is hosted versions only, and every persisted doc is
- * stamped `docSchemaVersion` from day one so the migration obligation the
- * old rule avoided stays bounded to one seam — migrate-on-read, here.
- *
- * Local studio sessions still never persist docs; CLI take dirs carry
- * doc.json under `schema/doc.schema.json` (which tolerates the stamp via
- * additionalProperties). Both hydration paths (studio handback, `vos
- * pull`) run through migrateHostedDoc before trusting a hosted doc.
- */
-/**
- * 2 = the document FAMILY era: a doc is a recording document (`source`)
- * or a program document (`program.config`). A v1 doc IS a recording document,
- * field for field, so 1 → 2 is a stamp; 0 → 1 was a stamp too.
+ * 3 = the one-vocabulary era: a recording document's `frame.entrance`,
+ * `endCard`, clip `enter`/`exit`/`fx` and prop `animation` are read into
+ * `anim` (and the end card into clips after the footage plus a card exit).
+ * 2 = the document FAMILY era (a recording document, or a program
+ * document); a v1 doc IS a recording document, so 1 → 2 was a stamp, and
+ * 0 → 1 was a stamp too.
  */
-declare const DOC_SCHEMA_VERSION = 2;
+declare const DOC_SCHEMA_VERSION = 3;
 /**
  * Upgrade a hosted doc.json payload to the current schema version.
- * Unstamped docs are v0 — the pre-stamp era. Every step so far is a stamp
- * (a post-v1 doc field is optional by doctrine, and v2 only widened the
- * family), so migration is structural identity. A real shape change chains
- * its step here.
+ * Unstamped docs are v0 — the pre-stamp era. v0 → v2 were stamps; v2 → v3
+ * rewrites a recording document's motion spellings into the vocabulary,
+ * and leaves a program document as it was (its layers migrate the same
+ * way when they carry the old spellings). A real shape change chains its
+ * step here.
  */
 declare function migrateHostedDoc(raw: Record<string, unknown>): Record<string, unknown>;
 
@@ -2033,7 +2090,7 @@ interface CopyStyleOptions {
  */
 declare function copyStyle(from: ProjectDoc, to: ProjectDoc, opts?: CopyStyleOptions): ProjectDoc;
 /** The frame fields a layout owns. Never `aspectRatio` or `browserBar`. */
-declare const LAYOUT_FRAME_FIELDS: readonly ["background", "padding", "radius", "shadow", "shadowContact", "shadowColor", "inset", "border", "borderWidth", "borderColor", "fit", "focus", "focusFollow", "parallax", "entrance"];
+declare const LAYOUT_FRAME_FIELDS: readonly ["background", "padding", "radius", "shadow", "shadowContact", "shadowColor", "inset", "border", "borderWidth", "borderColor", "fit", "focus", "focusFollow", "parallax", "anim"];
 /**
  * The id prefix an exemplar reserves for the clips that ARE its layout:
  * the words and the mark a poster places (`stage-title`, `stage-kicker`,
@@ -2085,6 +2142,131 @@ interface CopiedLayout {
  * aspect, the browser chrome, every clip that is not a stage clip, the cut.
  */
 declare function copyLayout(from: ProjectDoc, to: ProjectDoc, opts?: CopyLayoutOptions): CopiedLayout;
+/** Where a template's clips land on the take. */
+type TemplateAnchor = 'start' | 'end' | number;
+interface ApplyTemplateOptions {
+    /**
+     * The anchor: `start` keeps the template's times; `end` lays them
+     * relative to the take's footage end as they sat relative to the
+     * template's own (an end card); a number is an output second the
+     * template's clock starts at (a caption at a step's settle).
+     */
+    at: TemplateAnchor;
+    /** Words for the template's text clips, by clip id. */
+    words?: Record<string, string>;
+    /** Media keys for the template's image and video clips, by clip id. */
+    keys?: Record<string, string>;
+    /**
+     * What the clips say they came from (the template's vos id). Absent =
+     * `'template'`. A re-apply with the same `from` replaces its earlier
+     * clips and leaves everything else.
+     */
+    from?: string;
+    /**
+     * Carry the template's look too (the layout-owned frame fields, its
+     * backdrop, the rest lean, the trailing hold): a poster. Absent = the
+     * clips and the card's animation only.
+     */
+    look?: boolean;
+}
+interface AppliedTemplate {
+    doc: ProjectDoc;
+    notes: string[];
+}
+/**
+ * The clips a template placed on a document (by `from`), in document order.
+ */
+declare function clipsFrom(doc: Pick<ProjectDoc, 'overlays' | 'objects' | 'audio'>, from: string): {
+    overlays: OverlayClip[];
+    objects: ObjectClip[];
+    audio: AudioClip[];
+};
+/**
+ * The document without the clips a template placed. The card's `anim` is
+ * the card's own once set, so it stays; a caller that wants the card still
+ * clears it. Returns the same object when nothing came from `from`.
+ */
+declare function dropTemplate(doc: ProjectDoc, from: string): ProjectDoc;
+/**
+ * A TEMPLATE is a vos: a plain take document whose clips carry stable ids.
+ * Applying it lays those clips onto another take at an ANCHOR, stamped
+ * `from`, with the release's words and keys patched in by id; the take's
+ * own same-id clip keeps its words unless `words` names them (the layout
+ * rule); the template's card `anim` merges over the take's (an end card
+ * brings the exit, a poster the entrance); with `look`, the layout-owned
+ * frame fields, the backdrop, the rest lean and the hold come too, which
+ * is `copyLayout`. The one assembly verb; a recipe says which template and
+ * where, never the document.
+ */
+declare function applyTemplate(template: ProjectDoc, take: ProjectDoc, opts: ApplyTemplateOptions): AppliedTemplate;
+
+/**
+ * ONE animation vocabulary for every visual primitive: the card, a text,
+ * image or video clip, a prop. `anim.enter` and `anim.exit` are how a thing
+ * arrives and leaves; `anim.idle` is what it does while it stays. A kind
+ * alone is the house motion; a step object adds its seconds and, for words,
+ * the per-unit grammar (unit, direction, stagger). Pure helpers over the
+ * type; the lowering bakes them into the same ON_FRAME data the older
+ * spellings produced (`enter`, `exit`, `fx`, `anim`), so a migrated document
+ * paints the same picture.
+ */
+
+/** What the CARD can do. */
+declare const CARD_ENTER_KINDS: readonly AnimKind[];
+declare const CARD_EXIT_KINDS: readonly AnimKind[];
+/** What WORDS can do (the per-unit kinds are text-only). */
+declare const TEXT_ENTER_KINDS: readonly AnimKind[];
+declare const TEXT_EXIT_KINDS: readonly AnimKind[];
+/** What an image or a video clip can do. */
+declare const MEDIA_ENTER_KINDS: readonly AnimKind[];
+declare const MEDIA_EXIT_KINDS: readonly AnimKind[];
+/** What a prop does while it stays. */
+declare const IDLE_KINDS: readonly IdleKind[];
+/**
+ * A step as an object: a bare kind becomes `{ kind }`; absent stays null so
+ * a caller can tell "the house default" from "none".
+ */
+declare function animStep(step: AnimKind | AnimStep | null | undefined): AnimStep | null;
+/** The enter step of a thing, or null when it carries none. */
+declare function enterOf(anim: Anim | null | undefined): AnimStep | null;
+/** The exit step of a thing, or null when it carries none. */
+declare function exitOf(anim: Anim | null | undefined): AnimStep | null;
+/**
+ * Whether a text clip's enter step is a PER-UNIT animation (the baked `fx`
+ * payload ON_FRAME reads) rather than the block transition: a per-unit
+ * kind, or a fade/rise that names its unit, stagger or seconds. A bare
+ * `'rise'` stays the block transition, which is what a migrated `enter`
+ * was; a migrated `fx` always names its unit, so it stays per-unit.
+ */
+declare function isUnitStep(step: AnimStep | null): boolean;
+/**
+ * The text-fx spec a clip's enter step describes, in the shape the fx
+ * normalizer reads, or null when the clip enters by the block transition.
+ */
+declare function overlayFxSpec(clip: TextOverlayClip): TextFxSpec | null;
+/**
+ * The block transition ON_FRAME reads as `enter`: the step's kind when it
+ * is one of the three transitions, the house `rise` otherwise (a per-unit
+ * step bakes `fx` beside it, and ON_FRAME ignores `enter` while `fx` is
+ * set, exactly as before).
+ */
+declare function enterKey(clip: OverlayClip): 'none' | 'fade' | 'rise';
+/** The block transition ON_FRAME reads as `exit`. */
+declare function exitKey(clip: OverlayClip): 'none' | 'fade' | 'rise';
+/** A prop's idle motion as ON_FRAME reads it (`anim`). */
+declare function idleKey(clip: ObjectClip): IdleKind | null;
+/**
+ * Where the last VISUAL layer ends, in output seconds: a text, image or
+ * video clip's end, a prop's span end. The output lasts at least this
+ * long, so an end card is nothing but clips placed after the footage.
+ * Audio never extends the output (a sound after the last picture is not a
+ * thing to watch); a bed is trimmed to the output instead. A prop with no
+ * span is always on and extends nothing.
+ */
+declare function lastLayerEnd(doc: Pick<Partial<{
+    overlays: OverlayClip[];
+    objects: ObjectClip[];
+}>, 'overlays' | 'objects'>): number;
 
 /**
  * The digest's crop geometry, pure and shared by the CLI's page and
@@ -2809,18 +2991,34 @@ declare function applyLook(frame: FrameStyle, look: Look, size: {
  * THE REST of a take: the one output time its still is taken at. A poster
  * ends on a trailing `hold` (its last segment freezes on its last frame),
  * and the rest is where that hold BEGINS — the composed frame before
- * nothing moves. Null when the take has no trailing hold, and null with an
- * end card: the end card grows that hold at lowering and its words rise
- * over the receding card during it, so the frame where it begins is
- * footage under a fading title, not a poster. One convention for every
- * still-taking surface (an export, a thumbnail, a kit), so they agree.
+ * nothing moves. Null when the take has no trailing hold. One convention
+ * for every still-taking surface (an export, a thumbnail, a kit), so they
+ * agree. A legacy end card yields null: its words rise over a receding
+ * card, which is footage under a fading title, not a poster.
  */
 declare function docRestTime(doc: ProjectDoc): number | null;
-/** The entrance's default length, seconds. */
+/** The card entrance's default length, seconds. */
 declare const ENTRANCE_SECONDS = 1.2;
-/** The end card's default length, seconds. */
+/** The legacy end card's default length, seconds. */
 declare const END_CARD_SECONDS = 2.5;
-declare function entranceSeconds(e: FrameEntrance | null | undefined): number;
+/** How long the card takes to recede (the `recede` exit's house length). */
+declare const END_CARD_RECEDE = 0.7;
+/** The `fade` exit's house length. */
+declare const CARD_FADE_SECONDS = 0.35;
+/** The legacy marker a migrated end card's clips carry as `from`. */
+declare const END_CARD_FROM = "endcard";
+/** A step with a kind and optional seconds: the card's, or a legacy entrance. */
+type Step = {
+    kind: string;
+    seconds?: number;
+} | null | undefined;
+/** The card's enter step, from its `anim` (a migrated doc carries nothing else). */
+declare function cardEnter(frame: Pick<FrameStyle, 'anim'>): AnimStep | null;
+/** The card's exit step, from its `anim`. */
+declare function cardExit(frame: Pick<FrameStyle, 'anim'>): AnimStep | null;
+declare function entranceSeconds(e: Step): number;
+/** The exit's length: its own seconds, else the house length of its kind. */
+declare function exitSeconds(e: Step): number;
 /**
  * The rated segments with every `hold` expanded: after the last rated
  * piece of a held segment, a freeze piece whose tiny source span at the
@@ -2834,22 +3032,53 @@ declare function withHolds(docSegments: readonly (Segment & {
 /**
  * The card-pose track [scale, dy, opacity] in OUTPUT seconds: the entrance
  * settles the card in from a slightly smaller, lower, transparent pose;
- * the end card recedes it under the words. Undefined when neither
- * exists, so a doc without them lowers byte-identically.
+ * the exit takes it out as its footage ends. The exit runs FROM the
+ * footage's end when something plays after it (the card recedes under the
+ * words), and ENDS at the footage's end when nothing does (the card leaves
+ * as the cut closes). Undefined when the card carries neither, so a doc
+ * without them lowers byte-identically.
  */
-declare function cardPoseTrack(e: FrameEntrance | null | undefined, endStart: number | null, endSeconds: number): KeyframeTrack<number[]> | undefined;
+declare function cardPoseTrack(enter: Step, exit: Step, footageEnd: number, outputEnd?: number): KeyframeTrack<number[]> | undefined;
 /**
- * A doc with its end card expanded: the last segment holds for the card's
- * seconds and the card's words ride as OUTPUT-anchored text overlays over
- * the receding footage (the house presets, so they resolve at lowering like
- * any title). Returns the output second the card starts at, for the pose
- * track. A doc with no end card comes back as itself.
+ * The clips a legacy end card places after the footage: the house title,
+ * caption and label presets over the receding card, the mark above the
+ * wordmark, every one stamped `from: 'endcard'` so a loop drops them and
+ * a re-apply replaces them. Pure; the words are the card's.
+ */
+declare function endCardClips(card: EndCard, doc: Pick<ProjectDoc, 'export' | 'frame' | 'source'>, endStart: number): OverlayClip[];
+/**
+ * A doc with its legacy end card expanded the OLD way: the last segment
+ * holds for the card's seconds and the words ride over the frozen footage.
+ * Kept for a caller that still wants the hold shape; the lowering migrates
+ * instead (clips after the footage, a card exit, no hold), which paints the
+ * same picture without a scenario field.
+ * @deprecated Use `migrateMotion`.
  */
 declare function expandEndCard(doc: ProjectDoc, outputDuration: number): {
     doc: ProjectDoc;
     endStart: number | null;
     seconds: number;
 };
+/**
+ * A document in the one vocabulary: `frame.entrance` becomes the card's
+ * `anim.enter`; a clip's `enter`, `exit` and `fx` become its `anim`; a
+ * prop's `animation` becomes its `anim.idle`; and the end card becomes a
+ * card `anim.exit` of `recede` plus its clips placed after the footage
+ * (no hold: the output now lasts until the last clip, and the card holds
+ * its last frame at the exit's end pose, which is the picture the end card
+ * painted). Returns the SAME object when there is nothing to migrate, so a
+ * document already in the vocabulary lowers byte-identically and identity
+ * checks hold.
+ */
+declare function migrateMotion(doc: ProjectDoc): ProjectDoc;
+/**
+ * Where the OUTPUT ends: the footage's end (its rated segments, holds
+ * included) or the last visual clip's end, whichever is later. Past its
+ * footage the card holds its last frame (`mapTime` clamps) at the pose its
+ * exit settled into. A document that ends on its footage answers the
+ * footage's end, byte-identically to before the rule.
+ */
+declare function outputEnd(doc: Pick<ProjectDoc, 'overlays' | 'objects'>, footageEnd: number): number;
 
 /**
  * Compositor v2 — the layer stage geometry.
@@ -3410,4 +3639,4 @@ declare function rejectSpan(rejected: RejectedSpan[] | undefined, lane: Rejected
     anchor?: StepAnchor;
 }, note?: string): RejectedSpan;
 
-export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, 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, 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_FOV, CARD_Z, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, 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 CamBubbleRect, type CamPoseSpan, type CamStyle, type CaptureNormalization, type CardLayout, 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, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, type DuckOptions, END_CARD_SECONDS, ENTRANCE_SECONDS, EXPORT_RESOLUTION_OPTIONS, EXPORT_SHORT_EDGE, type EndCard, type EnvelopePoint, type ExportResolution, type ExtractClickOptions, FOLLOW_RECENTER, FOLLOW_SAFE_RATIO, FRAME_BORDER_COLOR_DEFAULT, FRAME_BORDER_DEFAULT, FRAME_BORDER_WIDTH_DEFAULT, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, HOUSE_GRADIENT, type IngestOptions, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type MediaOverlayClip, 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 OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PLATE_GROUND, PLAYBACK_ACTIVITY, PROGRAM_RETIME, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, SCENE_MOTION, SCENE_QUIET, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STUDIO_ENTRY_ID, STYLE_FIELDS, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, TEXT3D_DEPTH_DEFAULT, TEXT3D_DEPTH_MAX, TEXT3D_DEPTH_MIN, 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_SPEED_MULT, 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 TranscriptSegment, 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 ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomWindow, anchorKindOf, anchorSourceDuration, applyLook, aspectRatioValue, audioLane, backdropMedia, buildDigest, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docOutputDuration, docRestTime, docToCropSpace, docToFullSpace, duckCurve, effectiveSegments, entranceSeconds, envelopeAt, envelopeValueAt, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, hexToRgbTriplet, houseLook, idleGaps, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, layoutOf, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, micLane, migrateHostedDoc, momentsFromDoc, motionTrack, musicBedClip, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, pageDisplayUrl, parsePoseId, pickStyle, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, restLeanOf, sceneChanges, scrollRuns, setSpeedInRange, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, videoLane, voiceKey, withBackdrop, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };
+export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, type Anim, type AnimKind, 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, 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, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, 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 CamBubbleRect, type CamPoseSpan, type CamStyle, type CaptureNormalization, type CardLayout, 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, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, 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, FRAME_BORDER_COLOR_DEFAULT, FRAME_BORDER_DEFAULT, FRAME_BORDER_WIDTH_DEFAULT, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, HOUSE_GRADIENT, IDLE_KINDS, type IdleKind, type IngestOptions, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type MediaOverlayClip, 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 OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PLATE_GROUND, PLAYBACK_ACTIVITY, PROGRAM_RETIME, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, SCENE_MOTION, SCENE_QUIET, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STUDIO_ENTRY_ID, STYLE_FIELDS, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, 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_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 TranscriptSegment, 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 ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomWindow, anchorKindOf, anchorSourceDuration, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, buildDigest, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cardEnter, cardExit, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docOutputDuration, docRestTime, docToCropSpace, docToFullSpace, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, hexToRgbTriplet, houseLook, idleGaps, idleKey, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layoutOf, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, micLane, migrateHostedDoc, migrateMotion, momentsFromDoc, motionTrack, musicBedClip, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, pageDisplayUrl, parsePoseId, pickStyle, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, restLeanOf, sceneChanges, scrollRuns, setSpeedInRange, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, videoLane, voiceKey, withBackdrop, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };