@vosjs/studio-core 0.36.0 → 0.38.0

package/dist/index.d.ts

@@ -3,6 +3,91 @@ export { Segment } from '@vosjs/timeline';
 import { TimelineEdit } from '@vosjs/shared/timelineEdits';
 import { LaneAdapter } from '@vosjs/editor';
 
+/** How a run departs from its layer's style. Absent = the layer's own. */
+interface TextRunStyle {
+    /** Font weight, snapped to the family's hosted steps like the layer's. */
+    weight?: number;
+    /** Italic on, or (on an italic layer) off. */
+    italic?: boolean;
+    /** Fill colour. */
+    color?: string;
+    underline?: boolean;
+    strike?: boolean;
+    /** A colour behind the run. */
+    highlight?: string;
+}
+interface TextRun extends TextRunStyle {
+    /** The words. May hold line breaks. */
+    text: string;
+}
+/** A text layer's words: plain, or styled. */
+type RichText = string | TextRun[];
+declare const RUN_STYLE_KEYS: readonly ["weight", "italic", "color", "underline", "strike", "highlight"];
+type RunStyleKey = (typeof RUN_STYLE_KEYS)[number];
+/** A style field's value over a selection that does not agree on it. */
+declare const MIXED = "mixed";
+/** The words alone: what a person reads, and what every label shows. */
+declare function plainText(text: RichText): string;
+/** The list form of either shape (a string is one unstyled run). */
+declare function runsOf(text: RichText): TextRun[];
+/** A run's style alone, without fields that say nothing. */
+declare function styleOf(run: TextRunStyle): TextRunStyle;
+/**
+ * The canonical form: empty runs dropped, fields that say nothing dropped,
+ * neighbours set alike merged, and a string when no style is left.
+ */
+declare function normalizeRuns(text: RichText): RichText;
+/** The nearest grapheme boundary at or before (`-1`) or after (`1`) an offset. */
+declare function snapOffset(plain: string, offset: number, dir: -1 | 1): number;
+/** The runs between two offsets (unnormalized: for building, not storing). */
+declare function sliceRuns(text: RichText, start: number, end: number): TextRun[];
+/**
+ * The style typing at a caret takes: the character before it, or the one
+ * after it at the very start.
+ */
+declare function styleAt(text: RichText, offset: number): TextRunStyle;
+/**
+ * Replace `[start, end)` with `insert`: every keystroke, paste and
+ * composition. The new text is set in `style` when one is given (the
+ * pending style at a caret), else as the first character it replaces, else
+ * as the character before it.
+ */
+declare function replaceRange(text: RichText, start: number, end: number, insert: string, style?: TextRunStyle): RichText;
+/**
+ * Set style fields over `[start, end)`. A field given as `undefined` is
+ * REMOVED there (the words go back to the layer's own).
+ */
+declare function setStyle(text: RichText, start: number, end: number, patch: {
+    [K in RunStyleKey]?: TextRunStyle[K] | undefined;
+}): RichText;
+/** Every style off `[start, end)`. */
+declare function clearStyle(text: RichText, start: number, end: number): RichText;
+/**
+ * What a selection agrees on, field by field: the value every character
+ * has, `undefined` when none has one, MIXED when they differ. The format
+ * bar's state.
+ */
+declare function commonStyle(text: RichText, start: number, end: number): {
+    [K in RunStyleKey]?: TextRunStyle[K] | typeof MIXED;
+};
+/**
+ * The toggle a format key makes: when the whole selection already has the
+ * field at `value`, take it off; otherwise put it on all of it.
+ */
+declare function toggleStyle<K extends RunStyleKey>(text: RichText, start: number, end: number, key: K, value: NonNullable<TextRunStyle[K]>): RichText;
+/**
+ * What a text field's change did, as one replacement of the old value:
+ * the longest common tail (never past the caret, which sits at the end of
+ * what was typed) and then the longest common head. Reads a keystroke, a
+ * paste, an autocorrect, a dictation and a composition the same way, and
+ * the caret settles a repeated character (`aa|` typed into `a|a`).
+ */
+declare function diffInput(prev: string, next: string, caretAfter: number): {
+    start: number;
+    end: number;
+    insert: string;
+};
+
 /**
  * Zoom/pan camera styles — named strategy
  * presets covering the whole auto-zoom pipeline: how the planner turns clicks
@@ -1397,8 +1482,13 @@ interface OverlayClipBase {
 }
 interface TextOverlayClip extends OverlayClipBase {
     kind: 'text';
-    /** Text content; '\n' breaks lines. */
-    text: string;
+    /**
+     * The words; '\n' breaks lines. A string, or a list of RUNS when parts of
+     * it are set differently: each run is a piece of text and the fields in
+     * which it departs from this layer's style (`weight`, `italic`, `color`,
+     * `underline`, `strike`, `highlight`). There is no markup in the words.
+     */
+    text: RichText;
     preset: TextOverlayPreset;
     /** Font size override in design px (preset default when absent). */
     size?: number;
@@ -1411,17 +1501,6 @@ interface TextOverlayClip extends OverlayClipBase {
     family?: string;
     /** Weight override — snapped to the nearest weight the catalog hosts. */
     weight?: number;
-    /**
-     * Turns emphasis ON for this clip (`{}` is enough), and says how
-     * `*marked*` words in `text` are set: their weight (snapped like `weight`;
-     * absent = the family's bold step, 700 or the nearest hosted) and colour
-     * (absent = the clip's). OPT-IN: without this field asterisks are text as
-     * typed. With it, `\*` is a literal asterisk.
-     */
-    emphasis?: {
-        weight?: number;
-        color?: string;
-    };
     /** Synthesized oblique (no italic files are hosted). */
     italic?: boolean;
     /** Multi-line alignment within the block (default center). */
@@ -2371,6 +2450,8 @@ declare function zipEntryBytes(bytes: Uint8Array, entry: ZipEntry): Uint8Array;
 declare function playwrightTraceEntry(entries: ZipEntry[]): ZipEntry | null;
 
 /**
+ * 6 = the runs era: a text layer's `emphasis` and its `*marked*` words are
+ * read into runs (`migrateText`); a layer without `emphasis` is untouched.
  * 5 = the six-style era: the retired camera styles `keynote` and `drift`
  * are read into their live style plus the tilt intensity the name carried
  * (`glide` + medium, `cinema` + subtle; an explicit `tiltStyle` wins). The
@@ -2384,7 +2465,7 @@ declare function playwrightTraceEntry(entries: ZipEntry[]): ZipEntry | null;
  * 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 = 5;
+declare const DOC_SCHEMA_VERSION = 6;
 /**
  * Upgrade a hosted doc.json payload to the current schema version.
  * Unstamped docs are v0 — the pre-stamp era. v0 → v2 were stamps; v2 → v3
@@ -3756,7 +3837,7 @@ declare function objectMotionPoseAt(o: ObjectClip, t: number, clipDur: number):
  * is absent — data byte parity for docs that never touched it. Both anchors
  * call this with their own output duration.
  */
-declare function studioLayerData(layers: {
+declare function studioLayerData(input: {
     overlays?: OverlayClip[];
     objects?: ObjectClip[];
     audio?: AudioClip[];
@@ -4678,6 +4759,110 @@ declare function cardPointToScreen(u: number, v: number): {
     sy: number;
 };
 
+/**
+ * Styled-text layout, once.
+ *
+ * A text layer is lines of RUNS (a piece of text and how it is set). This
+ * module turns them into what a painter draws and what an editor points at:
+ * visual lines after the wrap, each a list of same-style FRAGMENTS at
+ * measured positions, plus the UNITS a per-unit entrance animates.
+ *
+ * It imports nothing and touches no DOM: measurement is handed in, so the
+ * page that paints, the host that picks and a plain node test all run the
+ * same function over the same rules.
+ *
+ * The rules are the text layer's own, unchanged:
+ *  - a line breaks only between word tokens (`\S+\s*`, trailing whitespace
+ *    kept with its word), greedily, at measured widths; a token wider than
+ *    the budget takes a line of its own; explicit lines wrap independently;
+ *  - a fragment is measured whole, so kerning holds inside a style and
+ *    stops at a style boundary (as it does in CSS);
+ *  - a unit places by the advance of what precedes it in its fragment, so
+ *    the settled frame of an entrance is the frame without one.
+ */
+/** How one piece of text is set. Absent fields are the layer's own. */
+interface RunStyle {
+    /** Index into the layout's `fonts` (0, the layer's font, when absent). */
+    f?: number;
+    /** Fill colour. */
+    c?: string;
+    /** Underline. */
+    u?: 1;
+    /** Strikethrough. */
+    s?: 1;
+    /** A colour behind the text. */
+    h?: string;
+}
+interface LayoutRun extends RunStyle {
+    /** The text. Never holds a line break: lines are split before layout. */
+    t: string;
+}
+type LayoutUnit = 'char' | 'word' | 'line';
+interface LayoutInput {
+    /** Source lines, each a list of runs. */
+    lines: LayoutRun[][];
+    /** Wrap budget in the measure's own px; absent or 0 = no wrap. */
+    maxWidth?: number;
+    /** Cut each visual line into units for a per-unit entrance. */
+    unit?: LayoutUnit;
+}
+/** `measure(text, fontIndex)`: the advance of `text` set in that font. */
+type Measure = (text: string, font: number) => number;
+/** A same-style stretch of one visual line. */
+interface Fragment extends RunStyle {
+    t: string;
+    /** Left edge, from the line's left edge. */
+    x: number;
+    /** Advance. */
+    w: number;
+    /** Offset of its first character in the visual line. */
+    o: number;
+}
+/** One animated unit: the fragments (or parts of them) it draws. */
+interface Unit {
+    x: number;
+    w: number;
+    parts: Fragment[];
+}
+interface LayoutLine {
+    /** Advance of the whole line (trailing whitespace included). */
+    w: number;
+    frags: Fragment[];
+    /** Present only when the input asked for a unit. */
+    units?: Unit[];
+    /** Offset of the line's first character in the whole plain text. */
+    a: number;
+    /** Characters on the line (its break, when it ends in one, not counted). */
+    n: number;
+}
+interface TextLayout {
+    lines: LayoutLine[];
+    /** The widest line. */
+    width: number;
+}
+/** `[start, end)` of each word token in a line: `\S+\s*`, or the line whole. */
+declare function tokenRanges(line: string): [number, number][];
+declare function layoutText(input: LayoutInput, measure: Measure): TextLayout;
+/** Top of the underline, below the em box's middle. */
+declare const UNDERLINE_OFFSET_EM = 0.42;
+/** Thickness of the underline and the strikethrough. */
+declare const DECORATION_THICKNESS_EM = 0.065;
+/** Top of the strikethrough, relative to the em box's middle. */
+declare const STRIKE_OFFSET_EM = 0.02;
+/** The highlight's box, above and below the em box's middle. */
+declare const HIGHLIGHT_HALF_EM = 0.58;
+/**
+ * A decoration's rectangle for a stretch at `x`, `w` on a line whose em
+ * middle is `y`, at paint size `px`. Edges land on whole pixels, so the
+ * stretches of neighbouring units meet without a seam.
+ */
+declare function decorationRect(kind: 'u' | 's' | 'h', x: number, w: number, y: number, px: number): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+
 /** Baked pill geometry: design px at the clip's resolved font size. */
 interface ResolvedOverlayBox {
     color: string;
@@ -4750,35 +4935,45 @@ declare function overlayFaceFor(clip: TextOverlayClip): OverlayFontFace | null;
  */
 declare function overlayFontFaces(doc: Pick<ProjectDoc, 'overlays'>): OverlayFontFace[];
 declare function overlayLines(text: string): string[];
-/** Opens an emphasized word in the displayed text. */
-declare const EM_OPEN = "\u0001";
-/** Closes an emphasized word in the displayed text. */
-declare const EM_CLOSE = "\u0002";
-/**
- * The displayed text of `*marked*` source, with EM_OPEN/EM_CLOSE around each
- * emphasized word, or null when nothing is marked (the caller keeps the
- * source as it is). A `*` pairs with the next `*` on the same line around
- * non-blank words; `\*` is a literal asterisk; a lone `*` stays literal.
- */
-declare function parseEmphasis(text: string): string | null;
-/** The text a layer paints: its emphasis marks applied, else its source. */
-declare function overlayDisplayText(clip: Pick<TextOverlayClip, 'text' | 'emphasis'>): string;
-/** A displayed text without its marks: what a person reads. */
-declare function stripEmphasis(text: string): string;
-/** The emphasis set a text layer resolves to, when its text marks any word. */
-interface ResolvedEmphasis {
-    weight: number;
-    color?: string;
-    /** The hosted face to load for the weight, when it is not a base face. */
-    face?: OverlayFontFace;
+/** The words a layer shows, whatever shape its text is in. */
+declare function overlayPlainText(clip: Pick<TextOverlayClip, 'text'>): string;
+/**
+ * A run's weight as it will paint: snapped to the family's hosted steps,
+ * exactly as the layer's own weight is. An unhosted family takes it as is.
+ */
+declare function snapRunWeight(clip: TextOverlayClip, weight: number): number;
+/**
+ * The weight Bold puts on a run of this layer: the family's bold step, 700
+ * or the nearest hosted, never lighter than the layer itself. When that is
+ * the layer's own weight the family has nothing bolder to offer.
+ */
+declare function boldWeightFor(clip: TextOverlayClip): number;
+/** The styled payload a text layer bakes: what the layout module lays out. */
+interface StyledText {
+    /** Source lines, each a list of runs (`f` indexes `fs`). */
+    l: LayoutRun[][];
+    /** The fonts the runs are set in; 0 is the layer's own. */
+    fs: {
+        w: number;
+        i?: 1;
+    }[];
+    /** Hosted faces to load beyond the layer's own. */
+    faces?: {
+        f: string;
+        w: number;
+        u: string;
+    }[];
+    /** A hash of `l` and `fs`: the layout's cache key and the dirty signature. */
+    h: string;
 }
-declare function resolveEmphasis(clip: TextOverlayClip): ResolvedEmphasis | null;
 /**
- * The width of a displayed text with emphasis marks, measured run by run
- * in the normal and the emphasis font. MIRRORS ON_FRAME's `olMeasure`
- * (change together). `bold` is the state the text starts in.
+ * A text layer as STYLED text (lines of runs resolved against the layer's
+ * style), or null when it is set in one style throughout and takes the
+ * plain painter. A run's weight snaps like the layer's; its italic is the
+ * layer's unless it says otherwise; colour, underline, strikethrough and
+ * highlight ride as they are.
  */
-declare function measureEmphasized(text: string, measure: (run: string, font: string) => number, font: string, emFont: string, bold?: boolean): number;
+declare function styledTextOf(clip: TextOverlayClip): StyledText | null;
 /**
  * The canvas font string at a given comp scale — MIRRORS ON_FRAME's
  * `olW + ' ' + olPx + 'px ' + olStack` (pinned by test).
@@ -4808,6 +5003,44 @@ mediaAspect?: number | null): OverlayRect;
 /** Point-in-overlay test (design px), rotation-aware (point → local space). */
 declare function overlayHit(rect: OverlayRect, px: number, py: number, padPx?: number): boolean;
 
+interface CaretStop {
+    /** Offset in the whole plain text. */
+    o: number;
+    /** Distance from the line's left edge. */
+    x: number;
+}
+/** Every place a caret can stand on a line, left to right. */
+declare function caretStops(line: LayoutLine, measure: Measure): CaretStop[];
+/**
+ * The line an offset is on. An offset at a wrap point belongs to the line
+ * that STARTS there (the caret sits before the next word, not after the
+ * trailing space), except at the very end of the text.
+ */
+declare function lineOfOffset(layout: TextLayout, offset: number): number;
+declare function caretAt(layout: TextLayout, offset: number, measure: Measure): {
+    line: number;
+    x: number;
+};
+/** The offset nearest to `x` on a line (a press lands on the closer edge). */
+declare function offsetAtX(line: LayoutLine, x: number, measure: Measure): number;
+/**
+ * The stretches a selection `[start, end)` covers, one per line it touches.
+ * A line whose break the selection takes gets a small tail, so a selected
+ * line break is visible.
+ */
+declare function rangeRects(layout: TextLayout, start: number, end: number, measure: Measure, breakTail?: number): {
+    line: number;
+    x: number;
+    w: number;
+}[];
+
+/** Does a legacy text mark any word? (The CLI's lint asks.) */
+declare function marksEmphasis(text: string): boolean;
+/** One layer: its `emphasis` read into runs. Others come back as they are. */
+declare function migrateTextClip(clip: TextOverlayClip): TextOverlayClip;
+/** A document's text layers, each read out of the old spelling. */
+declare function migrateText<T extends Pick<ProjectDoc, 'overlays'>>(doc: T): T;
+
 declare const TEXT3D_DEPTH_DEFAULT = 0.25;
 declare const TEXT3D_DEPTH_MIN = 0.02;
 declare const TEXT3D_DEPTH_MAX = 1;
@@ -5216,4 +5449,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, 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 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, EM_CLOSE, EM_OPEN, 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, 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, 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, anchorKindOf, anchorSourceDuration, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, buildDigest, calloutBox, calloutClip, calloutGroundOf, calloutLook, calloutSource, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cameraCentring, cameraModel, cardEnter, cardExit, cardFields, cardInset, cardPointToScreen, cardPoseTrack, 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, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layoutOf, levelForFocusFraction, liveZoomStyleName, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, measureEmphasized, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, migrateZoomStyle, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayDisplayText, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayPinPoseAt, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parseCssColour, parseEmphasis, parsePoseId, 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, resolveEmphasis, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, spanOutputExtent, speedLane, stripEmphasis, studioAudioPlan, studioEntry, studioLayerData, 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 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, 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 CaretStop, type ClickFxStyle, type CopiedLayout, type CopyLayoutOptions, type CopyStyleOptions, type CursorEvent, type CursorFadeKey, type CursorIdleOptions, type CursorStyle, type CursorTrack, DARK_GROUND, DECORATION_THICKNESS_EM, 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 Fragment, type FrameEntrance, type FrameGeometry, type FrameStyle, type FreezeExtent, type FreezeSpan, HIGHLIGHT_HALF_EM, 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 LayoutInput, type LayoutLine, type LayoutParts, type LayoutRun, type LayoutUnit, type Unit as LayoutUnitBox, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MEDIA_FRAME_KEYS, MEDIA_KEY_PREFIX, MINIMAL_BAR_THEMES, MIXED, 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, RUN_STYLE_KEYS, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, type Rgb, type RichText, type RunStyle, type RunStyleKey, SCENE_MOTION, SCENE_QUIET, SEGMENT_ENTER_KINDS, SEGMENT_EXIT_KINDS, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STILL_DEFAULT, STRIKE_OFFSET_EM, 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 TextLayout, type Measure as TextMeasure, type TextOverlayBox, type TextOverlayClip, type TextOverlayPreset, type TextOverlayStroke, type TextRun, type TextRunStyle, type TiltPersonality, type TiltSpan, type TiltStyleName, type TraceFileKind, type TraceOptions, type TraceResult, type TranscriptSegment, type Transition, type TransitionKind, type TransitionMove, type TransitionOut, type TransitionSpeed, UNDERLINE_OFFSET_EM, 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, 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, caretAt, caretStops, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clearStyle, clipEnvelope, clipLength, clipsFrom, commonStyle, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cssFamilies, cssWeights, cursorFromCsv, cursorFromPlaywrightTrace, cursorFromRecords, cursorFromTrace, cursorIdleFade, decorationRect, deltaE, deriveViewportCrop, destinationById, destinationsForChannel, diffInput, 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, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layoutOf, layoutText, levelForFocusFraction, lineOfOffset, 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, normalizeRuns, objectMotionBase, objectMotionPoseAt, objectsLane, offsetAtX, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayPinPoseAt, overlayPlainText, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parseCssColour, parsePoseId, pickStyle, pinBox, pinCandidates, pinPlacement, pinRectOnScreen, pinReferent, pinReferentAt, placeFreezes, plainText, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, playwrightTraceEntry, programDuration, programStillTime, projectFromArtifact, pumpFreeChainGap, rangeRects, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, relativeLuminance, removeSourceRange, removeSpeedInRange, replaceRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, runsOf, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, setStyle, sliceRuns, slideSide, smoothCursor, snapOffset, snapRunWeight, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, styleAt, styleOf, styledTextOf, tiltLane, tiltTrackFromDoc, toggleStyle, tokenRanges, traceKindOf, transitionMult, transitionSeconds, unionFitLevel, unionRect, videoLane, voiceKey, wellFormedXml, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zipEntries, zipEntryBytes, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomView, zoomViewport, zoomWindow };