@vosjs/studio-core 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -1022,7 +1022,7 @@ interface EndCard {
  * The first slice ships `kind: 'text'`; image/video kinds are the next slice and extend this
  * union without changing the anchoring or transform model.
  */
-type OverlayKind = 'text' | 'image' | 'video';
+type OverlayKind = 'text' | 'image' | 'video' | 'html';
 /** Named house text styles — resolved to concrete font/size/color at lowering. */
 type TextOverlayPreset = 'title' | 'caption' | 'label';
 /** Enter/exit transition presets — pure f(t), evaluated in ON_FRAME. */
@@ -1291,7 +1291,82 @@ interface MediaOverlayClip extends OverlayClipBase {
     /** Video only: loop while the clip is active. Absent = hold the last frame. */
     loop?: boolean;
 }
-type OverlayClip = TextOverlayClip | MediaOverlayClip;
+/**
+ * A face an HTML layer sets type in that the CATALOG does not host, named by
+ * URL. A catalog family needs no entry here: the lowering finds it from the
+ * family the CSS names (`htmlLayerFaces`). The bytes are never stored: an SVG
+ * loaded through `<img>` may fetch nothing, so the page fetches the face by
+ * ordinary `fetch` at setup and inlines it into the picture.
+ */
+interface HtmlOverlayFont {
+    family: string;
+    url: string;
+    weight?: number;
+    style?: 'normal' | 'italic';
+}
+/**
+ * A layer authored as DOM: markup and CSS, laid out and painted by the
+ * browser itself, composited over the footage like any other picture.
+ *
+ * WHY IT IS SOURCE AND NOT A PICTURE. A product video points at a piece of
+ * UI, and the camera is the only pointing device a recording has: a zoom
+ * magnifies recorded pixels, so the thing the video is about becomes the
+ * blurriest thing on screen. A layer rasterized FROM SOURCE at the size each
+ * frame asks for has no such ceiling.
+ *
+ * WHY THE SOURCE CANNOT BE BAKED INTO A KEY. An SVG carrying a
+ * `<foreignObject>` is origin-clean ONLY as a `data:` URI (served from a URL
+ * it taints the canvas even same-origin, and a tainted frame cannot be
+ * uploaded as a WebGL texture, so every layer disappears), and a `data:` URI
+ * in the document costs tens of kilobytes per face per layer. Keeping the
+ * SOURCE here and building the picture in the page is small in the
+ * document, inline at draw time, and vector at any export size.
+ *
+ * It draws its OWN chrome: shadow, radius, border and any bar are the CSS's,
+ * so the compositor adds none (`shadow`, `radius`, `border`, `frame` are
+ * refused by the lint). It rides every other layer gesture unchanged: the
+ * timing, the fractional transform, `anim`, `motion`, z-order.
+ */
+interface HtmlOverlayClip extends OverlayClipBase {
+    kind: 'html';
+    /** The markup. Well-formed XML: `foreignObject` is XML, not HTML. */
+    html: string;
+    /** The CSS. Scoped by the layer's own wrapper, so plain selectors are fine. */
+    css?: string;
+    /** The design box the markup is laid out in, in 1080p design px. */
+    box: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Design px of room around the box for what paints OUTSIDE it: a shadow,
+     * a glow, a blur. The SVG viewport clips hard, so without room a shadow is
+     * sliced square at the edge. Absent = derived from the CSS at lowering
+     * (`htmlLayerBleedFor`); stated, it wins.
+     */
+    bleed?: number;
+    /** Faces the CSS names that the catalog does not host, by URL. */
+    fonts?: HtmlOverlayFont[];
+    /**
+     * Base width as a fraction of the FRAME width. Absent = the design size,
+     * the picture box (the design box plus its bleed) over 1920, so a
+     * component designed at 452 px lands at 452 px in a 1080p frame.
+     */
+    width?: number;
+    /** Opacity 0..1. Absent = 1. */
+    opacity?: number;
+}
+type OverlayClip = TextOverlayClip | MediaOverlayClip | HtmlOverlayClip;
+/**
+ * Does this layer's picture come from a KEY? True for an asset, a take-dir
+ * file or a document media; false for words and for an HTML layer, which
+ * carry their own content.
+ *
+ * A predicate rather than `kind !== 'text'`, because that test silently
+ * became wrong the moment a second contentful kind existed, and the way it
+ * goes wrong is that a re-host tries to re-host something that has no key.
+ */
+declare function isKeyedOverlay(c: OverlayClip): c is MediaOverlayClip;
 /**
  * A layer's own card. The bar is ALLOWED on any card and opens off; its
  * address defaults to the media's recorded page when the layer shows a
@@ -3009,6 +3084,204 @@ interface StudioEntry {
     onFrame: string;
 }
 declare function studioEntry(data: Record<string, unknown>): StudioEntry;
+/**
+ * The HTML layer's SVG document, as page JS. This is the MIRROR of
+ * `htmlLayerSvg` in `../htmlLayer.ts`: SETUP is a function string and cannot
+ * import, so the composer is carried twice and `htmlOverlay.test.ts` pins
+ * the two byte-for-byte. Change them together.
+ */
+declare const HTML_LAYER_SVG_CODE = "(src, faces) => {\n  const bleed = Math.max(0, Math.round(src.bleed || 0))\n  const boxW = src.box.width + bleed * 2\n  const boxH = src.box.height + bleed * 2\n  let fontCss = ''\n  for (const f of faces || []) fontCss += \"@font-face{font-family:'\" + f.family + \"';src:url(\" + f.dataUri + \") format('woff2');font-weight:\" + f.weight + \";font-style:\" + f.style + \";font-display:block}\"\n  const wrapper = '.vos-html-layer{width:' + boxW + 'px;height:' + boxH + 'px;box-sizing:border-box;margin:0;padding:' + bleed + 'px;font-family:-apple-system,system-ui,sans-serif;-webkit-font-smoothing:antialiased;text-rendering:geometricPrecision}'\n  return '<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"' + boxW + '\" height=\"' + boxH + '\" viewBox=\"0 0 ' + boxW + ' ' + boxH + '\">' +\n    '<foreignObject x=\"0\" y=\"0\" width=\"' + boxW + '\" height=\"' + boxH + '\">' +\n    '<div xmlns=\"http://www.w3.org/1999/xhtml\" class=\"vos-html-layer\">' +\n    '<style>' + fontCss + wrapper + (src.css || '') + '</style>' + src.html +\n    '</div></foreignObject></svg>'\n}";
+
+/** The design frame an HTML layer's `box` is measured against (1080p). */
+declare const DESIGN_FRAME_WIDTH = 1920;
+/** Past this many bytes of markup plus CSS the lint warns, and past the max it refuses. */
+declare const HTML_LAYER_WARN_BYTES = 32000;
+declare const HTML_LAYER_MAX_BYTES = 128000;
+/** A face the page inlines: a URL the builder fetches, or already bytes. */
+interface HtmlLayerFace {
+    family: string;
+    url: string;
+    weight: number;
+    style: 'normal' | 'italic';
+}
+/** What the composer takes: the source and the faces AS BYTES. */
+interface HtmlLayerSource {
+    html: string;
+    css?: string;
+    box: {
+        width: number;
+        height: number;
+    };
+    bleed?: number;
+}
+interface HtmlLayerInlineFace {
+    family: string;
+    weight: number;
+    style: 'normal' | 'italic';
+    dataUri: string;
+}
+declare function cssFamilies(css: string | undefined): string[];
+/**
+ * The weights the CSS and the markup ask for: `font-weight` numbers and
+ * keywords (`bold` is 700, `normal` 400), plus 700 when the markup carries a
+ * `<b>`, `<strong>` or a heading, because the browser sets those bold. 400
+ * is always in the list: it is what an unweighted run sets.
+ */
+declare function cssWeights(css: string | undefined, html?: string): number[];
+/**
+ * The faces the page inlines for a layer: every family the CSS names that
+ * the CATALOG hosts, at every weight the source asks for (snapped to the
+ * steps the catalog hosts, deduped), then the clip's explicit `fonts` for a
+ * face outside the catalog. Nobody types a catalog URL: the CSS names the
+ * family and this finds it, the same way a text clip's `family` resolves.
+ * A family the catalog does not host resolves to nothing here and falls back
+ * to the wrapper's system stack in the page, which is what `vos validate`
+ * warns about.
+ */
+declare function htmlLayerFaces(clip: Pick<HtmlOverlayClip, 'html' | 'css' | 'fonts'>): HtmlLayerFace[];
+/** The families the CSS names that the catalog does NOT host and no explicit font covers. */
+declare function htmlLayerUnhostedFamilies(clip: Pick<HtmlOverlayClip, 'css' | 'fonts'>): string[];
+/**
+ * How much room the CSS's shadows need outside the component's box, in
+ * design px: the furthest any shadow reaches (offset plus blur plus spread),
+ * rounded up with a margin.
+ *
+ * The SVG viewport clips hard. A card that fills its box exactly gets its
+ * shadow sliced off at the edge, and because a shadow is usually offset
+ * downward it pools in the lower corners, so the layer's rounded corners
+ * come out as a grey square instead of transparency (measured: corner alpha
+ * 6, 6 and 32 with no bleed, 0 everywhere with it). A rough upper bound read
+ * off the declarations, not a CSS parser: over-reserving costs a few
+ * transparent pixels, under-reserving is the clipped-corner bug.
+ */
+declare function htmlLayerBleedFor(css: string | undefined): number;
+/** The bleed a layer renders with: the stated one, else what its CSS needs. */
+declare function htmlLayerBleed(clip: Pick<HtmlOverlayClip, 'css' | 'bleed'>): number;
+/**
+ * The picture's box: the component plus its bleed on every side. This is
+ * what `width` sizes and what the hit rect measures, because the bleed is
+ * part of the rasterized picture (transparent, but there).
+ */
+declare function htmlLayerPictureBox(clip: Pick<HtmlOverlayClip, 'box' | 'css' | 'bleed'>): {
+    width: number;
+    height: number;
+    bleed: number;
+};
+/**
+ * The layer's width as a fraction of the FRAME width (the media overlay
+ * convention; ON_FRAME paints `w · W`). Absent, the DESIGN SIZE: the picture
+ * box over 1920, so a component designed at 452 px lands at 452 px in a
+ * 1080p frame and scales with the export. The bleed is in the picture, so it
+ * is in the default too, or a shadowed component would land narrower than
+ * it was designed.
+ */
+declare function htmlLayerWidth(clip: Pick<HtmlOverlayClip, 'width' | 'box' | 'css' | 'bleed'>): number;
+/** The words the markup carries, for a lane label: tags stripped, entities read. */
+declare function htmlLayerText(html: string): string;
+/** The timeline item's label: the first words, else the kind. */
+declare function htmlLayerLabel(clip: Pick<HtmlOverlayClip, 'html'>): string;
+type HtmlLayerProblemCode = 'empty' | 'unclosed-void' | 'bare-ampersand' | 'unquoted-attr' | 'too-large' | 'foreign-field' | 'shadow-clipped' | 'external-resource' | 'wall-clock' | 'unhosted-family';
+interface HtmlLayerProblem {
+    code: HtmlLayerProblemCode;
+    /** A problem stops the layer painting; a warning is a layer that paints wrong. */
+    level: 'problem' | 'warning';
+    message: string;
+}
+/** Media-clip fields an HTML layer refuses: its CSS is its chrome. */
+declare const HTML_LAYER_FOREIGN_FIELDS: readonly ["key", "radius", "shadow", "border", "loop", "frame", "fx", "text", "preset"];
+/**
+ * Everything wrong with a layer that can be seen in its source, in words. A
+ * malformed document does not warn in the page: the `<img>` fails to decode,
+ * the layer never paints, and nothing anywhere says why. Checked here so an
+ * author is told instead, the same answer in the studio, in `vos validate`
+ * and in a test.
+ */
+declare function htmlLayerProblems(clip: Pick<HtmlOverlayClip, 'html' | 'css' | 'bleed' | 'fonts'>): HtmlLayerProblem[];
+/**
+ * The real XML question, asked of a real parser: the studio hands in
+ * `DOMParser`, a test hands in a stub. The CLI does not call this (Node
+ * ships no parser) and relies on the heuristics above plus the page's own
+ * decode report.
+ */
+declare function wellFormedXml(svg: string, parseXml: (text: string) => {
+    getElementsByTagName: (name: string) => ArrayLike<{
+        textContent: string | null;
+    }>;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The SVG document for a layer: self-contained, laid out in DESIGN units
+ * (the viewBox), so the browser rasterizes it at whatever size a frame asks
+ * for. The wrapper fixes the box, insets the component by its bleed and
+ * resets the two properties an SVG document does not inherit sensibly;
+ * everything else is the author's.
+ *
+ * MIRRORED by `HTML_LAYER_SVG_CODE` in `lower/studioEntry.ts`. Change both.
+ */
+declare function htmlLayerSvg(src: HtmlLayerSource, faces?: readonly HtmlLayerInlineFace[]): string;
+/**
+ * The layer's CACHE KEY: content-addressed over everything the picture is
+ * made of (markup, CSS, box, bleed, the resolved faces), so an edit to the
+ * source lands on a new key and invalidates the picture cache, the build
+ * guard and the overlay canvas's dirty signature at once. Moving, retiming,
+ * scaling or animating the clip does not re-key it: none of those repaint.
+ * The key is a handle, never a URL: nothing may fetch it.
+ */
+declare function htmlLayerKey(clip: Pick<HtmlOverlayClip, 'id' | 'html' | 'css' | 'box'>, faces: readonly HtmlLayerFace[], bleed: number): string;
+/** The shape the page is handed for a layer: the source plus resolved faces. */
+interface HtmlLayerPayload {
+    markup: string;
+    css: string;
+    box: {
+        width: number;
+        height: number;
+    };
+    bleed: number;
+    faces: HtmlLayerFace[];
+}
+/** Everything the lowering emits for a layer, from the clip alone. */
+declare function htmlLayerPayload(clip: HtmlOverlayClip): {
+    key: string;
+    width: number;
+    html: HtmlLayerPayload;
+};
+
+/**
+ * The house starters for an HTML layer: what one press of the studio's HTML
+ * verb puts on the canvas, and what its panel's Starter select swaps in.
+ * Product defaults the way the three text presets are (code, not shelf
+ * data), five and not fifty: a LIBRARY of components is an official project
+ * on the shelf that an agent applies as a template.
+ *
+ * Each is real, readable markup and CSS a person can retune, in the house
+ * look (a dark card, Inter for words, JetBrains Mono for code, both hosted so
+ * the faces resolve from the CSS alone), with a `box-shadow` so the derived
+ * bleed is exercised. `htmlStarters.test.ts` proves every one passes the
+ * gate with no problem and no warning.
+ */
+
+interface HtmlStarter {
+    id: 'callout' | 'code' | 'terminal' | 'keys' | 'badge';
+    name: string;
+    html: string;
+    css: string;
+    box: {
+        width: number;
+        height: number;
+    };
+}
+declare const HTML_STARTERS: readonly HtmlStarter[];
+/**
+ * A starter as a clip at a moment: the studio's verb and the panel's Starter
+ * select both call this, so what a press creates and what a swap replaces
+ * are one shape. `bleed` is left absent (derived), `width` absent (the
+ * design size), the transform centred.
+ */
+declare function htmlStarterClip(starter: HtmlStarter, id: string, start: number, duration: number): HtmlOverlayClip;
 
 interface EnvelopePoint {
     /** output-timeline seconds. */
@@ -4026,4 +4299,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, 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, 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, HOUSE_GRADIENT, 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 OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, 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, 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 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 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, cardFields, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docStillTime, docToCropSpace, docToFullSpace, docTransitions, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, hexToRgbTriplet, houseLook, idleGaps, idleKey, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layoutOf, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parsePoseId, pickStyle, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, transitionSeconds, videoLane, voiceKey, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, 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, 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, DESIGN_FRAME_WIDTH, 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, 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, HOUSE_GRADIENT, 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 OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, 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, 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 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 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, cardFields, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cssFamilies, cssWeights, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docStillTime, docToCropSpace, docToFullSpace, docTransitions, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, 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, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parsePoseId, pickStyle, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, transitionSeconds, videoLane, voiceKey, wellFormedXml, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };