@cutcraft/kit 0.1.0 → 0.2.0

package/dist/{index-CLhXqOpF.d.mts → index-BYYpzZuS.d.mts}

@@ -1,19 +1,325 @@
-import { z } from "zod";
+import { ZodObject, z } from "zod";
+/**
+ * What the ingest service knows about an asset. The model never sees pixels;
+ * it edits against this, and the resolver turns `word:`/`shot:` references
+ * into seconds with it.
+ */
+interface AssetManifest {
+  readonly assets: Readonly<Record<string, AssetEntry>>;
+}
+interface AssetEntry {
+  readonly id: string;
+  readonly kind: "video" | "audio" | "image";
+  /** Seconds. Images report 0 and may be held for any duration. */
+  readonly duration: number;
+  readonly fps?: number;
+  readonly width?: number;
+  readonly height?: number;
+  readonly audio?: {
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly streams: number;
+  };
+  readonly transcript?: {
+    readonly words: readonly TranscriptWord[];
+  };
+  readonly shots?: readonly Shot[];
+  readonly silences?: readonly Silence[];
+  readonly waveform?: WaveformSummary;
+  /** Where the subject (a face, a person) sits in the picture, sampled over time; several boxes may share a `t`. */
+  readonly subjects?: readonly SubjectBox[];
+}
+/** A subject's box at source second `t`, as fractions of the source picture (0..1 from its top left). */
+interface SubjectBox {
+  readonly t: number;
+  readonly x: number;
+  readonly y: number;
+  readonly w: number;
+  readonly h: number;
+}
+interface TranscriptWord {
+  readonly i: number;
+  readonly text: string;
+  readonly start: number;
+  readonly end: number;
+  readonly speaker?: string;
+  /**
+   * The times are shared out from a longer span (an SRT or VTT cue, a segment without word times), not measured per
+   * word: a cut on this word lands near it, not exactly on it.
+   */
+  readonly estimated?: boolean;
+}
+interface Shot {
+  readonly i: number;
+  readonly start: number;
+  readonly end: number;
+}
+interface Silence {
+  readonly i: number;
+  readonly start: number;
+  readonly end: number;
+}
+interface WaveformSummary {
+  readonly binSeconds: number;
+  readonly peaks: readonly number[];
+  readonly rms: readonly number[];
+}
+declare const EMPTY_MANIFEST: AssetManifest;
+declare function assetIdOf(ref: string): string;
+declare function lookupAsset(manifest: AssetManifest, ref: string): AssetEntry | null;
+interface ShaderDefinition {
+  readonly kind: "effect" | "transition";
+  readonly name: string;
+  /** The params `<Effect params>` or `<Transition params>` takes, validated and given defaults by this schema. */
+  readonly params: ZodObject;
+  /**
+   * GLSL ES 3.00 that defines `vec4 effect(vec2 uv)` (an effect) or `vec4 transition(vec2 uv)` (a transition). It may
+   * read `image` (an effect's picture) or `from` and `to` (a transition's two pictures) as `sampler2D`, `resolution`
+   * (vec2, pixels), `time` (seconds into the element), `progress` (0..1 through a transition), and each param by its
+   * name: a number as a float, a boolean as a bool, an array of 2 to 4 numbers as a vec, a colour string as a vec3.
+   */
+  readonly shader: string;
+}
+/** The shaders a module loaded by `loadModule` declared, stored on its exports under this key. */
+declare const MODULE_SHADERS: unique symbol;
+interface DefineOptions {
+  readonly name: string;
+  readonly params?: ZodObject;
+  readonly shader: string;
+}
+/**
+ * Declares an effect drawn by a GLSL function, and returns its name for `<Effect type>`. Call it at the top of the file.
+ *
+ *   const glitch = defineEffect({
+ *     name: "glitch",
+ *     params: z.object({ amount: z.number().min(0).max(1).default(0.3) }),
+ *     shader: `vec4 effect(vec2 uv) {
+ *       float shift = amount * 0.02 * sin(time * 40.0 + uv.y * 80.0);
+ *       return vec4(texture(image, uv + vec2(shift, 0)).r, texture(image, uv).g, texture(image, uv - vec2(shift, 0)).b,
+ *                   texture(image, uv).a);
+ *     }`,
+ *   });
+ *   <Clip id="city" src="asset:city"><Effect id="g" type={glitch} params={{ amount: 0.5 }} /></Clip>
+ */
+declare function defineEffect(options: DefineOptions): string;
+/**
+ * Declares a transition drawn by a GLSL function of the two pictures, and returns its name for `<Transition type>`.
+ *
+ *   const sweep = defineTransition({
+ *     name: "sweep",
+ *     shader: `vec4 transition(vec2 uv) { return uv.x < progress ? texture(to, uv) : texture(from, uv); }`,
+ *   });
+ */
+declare function defineTransition(options: DefineOptions): string;
+/** Runs `load` and returns the shaders declared while it ran: how `loadModule` keeps each file's apart. */
+declare function collectShaders(load: () => void): ShaderDefinition[];
+/** The shaders a module declared: those `loadModule` recorded for it, or else every one declared outside a load. */
+declare function shadersOf(mod: object): readonly ShaderDefinition[];
+/** The shader a file declares under this name for an `<Effect>` or `<Transition>`, if any. */
+declare function shaderFor(shaders: readonly ShaderDefinition[], kind: ShaderDefinition["kind"], type: unknown): ShaderDefinition | undefined;
+/** Whether a file draws anything with a shader it declares: what only a renderer with WebGL draws. */
+declare function usesShaders(state: {
+  readonly shaders: readonly ShaderDefinition[];
+  readonly items: ReadonlyMap<string, {
+    readonly kind: string;
+    readonly props: Readonly<Record<string, unknown>>;
+  }>;
+}): boolean;
+/**
+ * The font families the player ships: the preview and the export load them
+ * from `@cutcraft/player/fonts.css`. All are under the SIL
+ * Open Font License, from the `@fontsource` packages named here. Each comes in
+ * regular and bold, and italic where the family has one.
+ */
+interface BundledFont {
+  readonly family: string;
+  /** The `@fontsource` package, and the file prefix inside its `files/` directory. */
+  readonly id: string;
+  readonly italic: boolean;
+}
+declare const BUNDLED_FONTS: readonly BundledFont[];
+declare const BUNDLED_FONT_WEIGHTS: readonly [400, 700];
+declare function isBundledFont(family: string): boolean;
+type FontStyle = "normal" | "italic";
+/** Where a declared face's file comes from. */
+type FontSource =
+/** A file found the way an asset is: `<id>.ttf` (`.otf`, `.woff`, `.woff2`) in the media folder, or the player's `media`. */
+{
+  readonly kind: "asset";
+  readonly id: string;
+} |
+/** Google Fonts: the export downloads it once into a local cache; the player loads it from Google. */
+{
+  readonly kind: "google";
+};
+/** One face a file declares with `font()` or `googleFont()`. */
+interface DeclaredFont {
+  readonly family: string;
+  readonly weight: number;
+  readonly style: FontStyle;
+  readonly source: FontSource;
+}
+/** The faces a module loaded by `loadModule` declared, stored on its exports under this key. */
+declare const MODULE_FONTS: unique symbol;
+/**
+ * Declares a face from a font file and returns its family, to pass as a `font` prop, a theme font or a CSS
+ * `fontFamily`. Call it at the top of the file with literal arguments, as the editor and lint read them from the source.
+ *
+ *   const brand = font({ family: "Brand Sans", src: "asset:brand", weight: 700 });
+ *   <Title id="hello" font={brand}>Hello</Title>
+ *
+ * `src: "asset:brand"` finds `brand.ttf` (or `.otf`, `.woff`, `.woff2`) where the export finds media, and asks the
+ * player's `media` for `brand`.
+ */
+declare function font(options: {
+  readonly family: string;
+  readonly src: string;
+  readonly weight?: number;
+  readonly style?: FontStyle;
+}): string;
+/**
+ * Declares a Google Fonts family, in each weight and style given (default 400, normal), and returns the family. The
+ * export downloads the files once into `~/.cache/cutcraft/fonts` (`CUTCRAFT_FONT_CACHE` moves it) and reads them from
+ * there; the player loads them from Google.
+ *
+ *   const titan = googleFont("Titan One");
+ *   const inter = googleFont("Inter Tight", { weights: [400, 700], styles: ["normal", "italic"] });
+ */
+declare function googleFont(family: string, options?: {
+  readonly weights?: readonly number[];
+  readonly styles?: readonly FontStyle[];
+}): string;
+/** Runs `load` and returns the faces declared while it ran: how `loadModule` keeps each file's faces apart. */
+declare function collectFonts(load: () => void): DeclaredFont[];
+/** The faces a module declared: those `loadModule` recorded for it, or else every face declared outside a load. */
+declare function fontsOf(mod: object): readonly DeclaredFont[];
+type ResolveErrorCode = "DANGLING_ANCHOR" |
+/** `at` names a moment the anchor does not play: trimmed out, or the anchor is not footage. */
+"INVALID_ANCHOR" |
+/** `at` on an anchor the first version cannot map: reversed, or with speed keys or freezes. */
+"UNSUPPORTED_ANCHOR" | "CYCLE" | "TRIM_PAST_SOURCE" | "UNKNOWN_REF" | "NOT_ADJACENT" | "INSUFFICIENT_HANDLES" | "NO_VISUAL_PARENT" | "DUPLICATE_ID" | "MISSING_ASSET" | "START_ON_SEQUENCE" | "MISSING_START" | "AMBIGUOUS_DURATION" | "INVALID_CHILD" | "INVALID_TIME_RANGE" | "UNKNOWN_TOKEN" | "UNKNOWN_STYLE" | "SCHEMA";
+interface ResolveError {
+  readonly code: ResolveErrorCode;
+  readonly id: string;
+  readonly prop?: string;
+  readonly message: string;
+}
+declare function isResolveError(value: unknown): value is ResolveError;
+type Editable = "literal" | "generated" | "opaque";
+/** Prop keys under this prefix address a Layer's handles rather than the Layer's own props. */
+declare const INTERIOR_PREFIX = "interior.";
+/**
+ * One vocabulary element as collected from the React element tree, before
+ * schema parsing and before placement. `props` are the raw JSX props minus
+ * `children`.
+ */
+interface CollectedNode {
+  readonly id: string;
+  readonly kind: string;
+  readonly props: Readonly<Record<string, unknown>>;
+  readonly children: readonly CollectedNode[];
+  /** Text content for elements whose children are text (Title). */
+  readonly text?: string;
+  readonly parent: string | null;
+  readonly editable: Editable;
+  /** Props whose source value is an expression the editor cannot write (known only when a SourceIndex was supplied). */
+  readonly lockedProps: readonly string[];
+  /** Prop → `schema` key for props that read the file's props; a write to one rewrites `defaults`. */
+  readonly boundProps: Readonly<Record<string, string>>;
+  /** For helper output: which helper produced the node, under which parent, and the helper's nth use in the file. */
+  readonly origin?: {
+    readonly helper: string;
+    readonly callerId: string | null;
+    readonly callIndex: number;
+  };
+  /** A Layer's handles: the one component inside it and its props. The component's body stays opaque. */
+  readonly interior?: LayerInterior;
+}
+interface LayerInterior {
+  readonly component: string;
+  readonly props: Readonly<Record<string, unknown>>;
+}
+interface CollectedTree {
+  readonly root: CollectedNode;
+  readonly byId: ReadonlyMap<string, CollectedNode>;
+  readonly errors: readonly ResolveError[];
+  /** The faces the file declares (`font()`, `googleFont()`); set by `collectModule`. */
+  readonly fonts?: readonly DeclaredFont[];
+  /** The effects and transitions the file declares (`defineEffect()`, `defineTransition()`); set by `collectModule`. */
+  readonly shaders?: readonly ShaderDefinition[];
+}
+declare function walk(node: CollectedNode, visit: (node: CollectedNode, depth: number) => void, depth?: number): void;
+declare function findParentOf(tree: CollectedTree, id: string): CollectedNode | null;
+type Json = null | boolean | number | string | Json[] | {
+  [key: string]: Json;
+};
+/** One change recorded by an action. Patches address elements by id, never by position in the file. */
+type Patch = {
+  readonly op: "set";
+  readonly id: string;
+  readonly prop: string;
+  readonly value: Json | undefined;
+} | {
+  readonly op: "text";
+  readonly id: string;
+  readonly text: string;
+} | {
+  readonly op: "insert";
+  readonly id: string;
+  readonly parent: string;
+  readonly after: string | null;
+  readonly node: CollectedNode;
+} | {
+  readonly op: "remove";
+  readonly id: string;
+} | {
+  readonly op: "move";
+  readonly id: string;
+  readonly parent: string;
+  readonly after: string | null;
+} | {
+  readonly op: "bake";
+  readonly id: string;
+};
+type Presence = "present" | "inserted" | "removed";
+/** The reduced effect of every patch on one element. */
+interface NetPatch {
+  readonly id: string;
+  presence: Presence;
+  readonly props: Map<string, Json | undefined>;
+  text?: string;
+  place?: {
+    parent: string;
+    after: string | null;
+  };
+  node?: CollectedNode;
+  bake: boolean;
+}
+interface PatchLog {
+  readonly entries: readonly Patch[];
+  readonly net: ReadonlyMap<string, NetPatch>;
+  /** Increments on every append or truncate; resolve() memoises on it. */
+  readonly version: number;
+  append(patch: Patch): void;
+  /** Current length, for history entries to remember what they appended. */
+  mark(): number;
+  /** Drop every entry at or after `mark` and rebuild `net`. */
+  truncate(mark: number): void;
+  clear(): void;
+}
 declare const TRACK_LAYOUTS: readonly ["sequence", "free"];
 declare const TRACK_ROLES: readonly ["general", "captions", "dialogue", "music", "effects", "ambience"];
 declare const FIT_MODES: readonly ["contain", "cover", "stretch", "none"];
 declare const BLEND_MODES: readonly ["normal", "multiply", "screen", "overlay", "darken", "lighten", "color-dodge", "color-burn", "hard-light", "soft-light", "difference", "exclusion", "hue", "saturation", "color", "luminosity", "add", "linear-dodge"];
 declare const EASINGS: readonly ["linear", "ease", "ease-in", "ease-out", "ease-in-out", "hold", "bezier", "smoothstep", "smootherstep", "snappy", "smooth", "spring", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInSine", "easeOutSine", "easeInOutSine", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "easeInBack", "easeOutBack", "easeInOutBack", "easeInBackStrong", "easeOutBackStrong", "easeInOutBackStrong", "easeInElastic", "easeOutElastic", "easeInOutElastic", "easeInElasticSoft", "easeOutElasticSoft", "easeInOutElasticSoft", "easeInBounce", "easeOutBounce", "easeInOutBounce", "easeInBounceSmall", "easeOutBounceSmall", "easeInOutBounceSmall"];
 declare const MASK_EASINGS: readonly ["linear", "ease-in", "ease-out", "ease-in-out"];
-declare const TRANSITION_TYPES: readonly ["crossfade", "dipToBlack", "dipToWhite", "wipe", "slide", "zoom", "push", "circleReveal", "blur", "whipPan", "radialWipe", "pixelate", "glitch", "blinds", "diamondReveal", "spin", "flip", "splitReveal", "flash", "filmBurn", "mosaic", "ripple", "pageTurn", "colorSplit"];
-declare const VIDEO_EFFECT_TYPES: readonly ["brightness", "contrast", "saturation", "hue", "temperature", "tint", "blur", "sharpen", "vignette", "grain", "shadow", "glow", "motion-blur", "radial-blur", "chromatic-aberration", "grayscale", "sepia", "invert", "levels", "hue-saturation"];
-declare const AUDIO_EFFECT_TYPES: readonly ["gain", "pan", "eq", "compressor", "reverb", "delay", "noiseReduction", "fadeIn", "fadeOut"];
-declare const TEXT_ANIMATION_PRESETS: readonly ["none", "typewriter", "fade", "slide-up", "slide-down", "slide-left", "slide-right", "scale", "blur", "bounce", "rotate", "pop", "flip", "split", "word-by-word", "rise", "drop", "elastic", "swing", "zoom-blur", "cascade", "wave", "shake", "rainbow", "glitch"];
-declare const CAPTION_ANIMATIONS: readonly ["none", "word-highlight", "word-by-word", "karaoke", "bounce", "typewriter"];
+declare const TRANSITION_TYPES: readonly ["crossfade", "dipToBlack", "dipToWhite", "wipe", "slide", "push"];
+declare const VIDEO_EFFECT_TYPES: readonly ["brightness", "contrast", "saturation", "hue", "temperature", "tint", "blur", "vignette", "grain", "shadow", "grayscale", "sepia", "invert", "levels"];
+declare const TEXT_ANIMATION_PRESETS: readonly ["none", "typewriter", "fade", "slide-up", "slide-down", "slide-left", "slide-right", "scale", "word-by-word"];
+declare const CAPTION_ANIMATIONS: readonly ["none", "word-highlight", "word-by-word", "karaoke", "typewriter"];
 declare const GRAPHIC_ANIMATIONS: readonly ["none", "fade", "slide-left", "slide-right", "slide-up", "slide-down", "scale", "rotate", "bounce", "pop", "draw", "wipe-left", "wipe-right", "wipe-up", "wipe-down", "reveal-center", "reveal-edges", "elastic", "flip-horizontal", "flip-vertical"];
-declare const EMPHASIS_ANIMATIONS: readonly ["none", "pulse", "shake", "bounce", "float", "spin", "flash", "heartbeat", "swing", "wobble", "jello", "rubber-band", "tada", "vibrate", "flicker", "glow", "breathe", "wave", "tilt", "zoom-pulse", "focus-zoom", "pan-left", "pan-right", "pan-up", "pan-down", "ken-burns"];
 declare const SHAPE_TYPES: readonly ["rectangle", "circle", "ellipse", "triangle", "arrow", "line", "polygon", "path", "star"];
-declare const KEYFRAME_PROPERTIES: readonly ["transform.position.x", "transform.position.y", "transform.position.z", "transform.scale.x", "transform.scale.y", "transform.rotation", "transform.rotation.x", "transform.rotation.y", "transform.perspective", "transform.opacity", "transform.anchor.x", "transform.anchor.y", "transform.borderRadius", "transform.crop.x", "transform.crop.y", "transform.crop.width", "transform.crop.height", "audio.volume", "audio.pan", "colorGrade.temperature", "colorGrade.tint", "path"];
+declare const KEYFRAME_PROPERTIES: readonly ["transform.position.x", "transform.position.y", "transform.scale.x", "transform.scale.y", "transform.rotation", "transform.opacity", "transform.anchor.x", "transform.anchor.y", "transform.borderRadius", "transform.crop.x", "transform.crop.y", "transform.crop.width", "transform.crop.height", "audio.volume", "audio.pan", "colorGrade.temperature", "colorGrade.tint"];
 /** `effect.<effectId>.<param>` is also a valid keyframe property; see `isKeyframeProperty`. */
 declare const KEYFRAME_PROPERTY_PATTERN: RegExp;
 declare function isKeyframeProperty(value: string): boolean;
@@ -22,10 +328,7 @@ declare const TEXT_ALIGNS: readonly ["left", "center", "right", "justify"];
 declare const TEXT_VALIGNS: readonly ["top", "middle", "bottom"];
 declare const TEXT_DECORATIONS: readonly ["none", "underline", "line-through", "overline"];
 declare const ANIMATION_UNITS: readonly ["character", "word", "line"];
-declare const MASK_TYPES: readonly ["shape", "drawn", "matte"];
-declare const MATTE_CHANNELS: readonly ["alpha", "luminance", "bounds"];
-declare const INTERPOLATION_QUALITIES: readonly ["low", "medium", "high"];
-declare const STABILIZE_CROP_MODES: readonly ["auto", "none"];
+declare const MASK_TYPES: readonly ["shape", "drawn"];
 declare const SVG_COLOR_MODES: readonly ["none", "tint", "replace"];
 declare const AUTOMATION_LANES: readonly ["volume", "pan"];
 declare const TRACK_FLAGS: readonly ["locked", "hidden", "muted", "solo"];
@@ -132,64 +435,26 @@ declare const zTransitionType: z.ZodEnum<{
   dipToWhite: "dipToWhite";
   wipe: "wipe";
   slide: "slide";
-  zoom: "zoom";
   push: "push";
-  circleReveal: "circleReveal";
-  blur: "blur";
-  whipPan: "whipPan";
-  radialWipe: "radialWipe";
-  pixelate: "pixelate";
-  glitch: "glitch";
-  blinds: "blinds";
-  diamondReveal: "diamondReveal";
-  spin: "spin";
-  flip: "flip";
-  splitReveal: "splitReveal";
-  flash: "flash";
-  filmBurn: "filmBurn";
-  mosaic: "mosaic";
-  ripple: "ripple";
-  pageTurn: "pageTurn";
-  colorSplit: "colorSplit";
 }>;
 declare const zVideoEffectType: z.ZodEnum<{
   hue: "hue";
   saturation: "saturation";
-  blur: "blur";
   brightness: "brightness";
   contrast: "contrast";
   temperature: "temperature";
   tint: "tint";
-  sharpen: "sharpen";
+  blur: "blur";
   vignette: "vignette";
   grain: "grain";
   shadow: "shadow";
-  glow: "glow";
-  "motion-blur": "motion-blur";
-  "radial-blur": "radial-blur";
-  "chromatic-aberration": "chromatic-aberration";
   grayscale: "grayscale";
   sepia: "sepia";
   invert: "invert";
   levels: "levels";
-  "hue-saturation": "hue-saturation";
-}>;
-declare const zAudioEffectType: z.ZodEnum<{
-  gain: "gain";
-  pan: "pan";
-  eq: "eq";
-  compressor: "compressor";
-  reverb: "reverb";
-  delay: "delay";
-  noiseReduction: "noiseReduction";
-  fadeIn: "fadeIn";
-  fadeOut: "fadeOut";
 }>;
 declare const zTextAnimationPreset: z.ZodEnum<{
   none: "none";
-  blur: "blur";
-  glitch: "glitch";
-  flip: "flip";
   typewriter: "typewriter";
   fade: "fade";
   "slide-up": "slide-up";
@@ -197,25 +462,11 @@ declare const zTextAnimationPreset: z.ZodEnum<{
   "slide-left": "slide-left";
   "slide-right": "slide-right";
   scale: "scale";
-  bounce: "bounce";
-  rotate: "rotate";
-  pop: "pop";
-  split: "split";
   "word-by-word": "word-by-word";
-  rise: "rise";
-  drop: "drop";
-  elastic: "elastic";
-  swing: "swing";
-  "zoom-blur": "zoom-blur";
-  cascade: "cascade";
-  wave: "wave";
-  shake: "shake";
-  rainbow: "rainbow";
 }>;
 declare const zCaptionAnimation: z.ZodEnum<{
   none: "none";
   typewriter: "typewriter";
-  bounce: "bounce";
   "word-by-word": "word-by-word";
   "word-highlight": "word-highlight";
   karaoke: "karaoke";
@@ -228,10 +479,9 @@ declare const zGraphicAnimation: z.ZodEnum<{
   "slide-left": "slide-left";
   "slide-right": "slide-right";
   scale: "scale";
-  bounce: "bounce";
   rotate: "rotate";
+  bounce: "bounce";
   pop: "pop";
-  elastic: "elastic";
   draw: "draw";
   "wipe-left": "wipe-left";
   "wipe-right": "wipe-right";
@@ -239,37 +489,10 @@ declare const zGraphicAnimation: z.ZodEnum<{
   "wipe-down": "wipe-down";
   "reveal-center": "reveal-center";
   "reveal-edges": "reveal-edges";
+  elastic: "elastic";
   "flip-horizontal": "flip-horizontal";
   "flip-vertical": "flip-vertical";
 }>;
-declare const zEmphasisAnimation: z.ZodEnum<{
-  none: "none";
-  spin: "spin";
-  flash: "flash";
-  glow: "glow";
-  bounce: "bounce";
-  swing: "swing";
-  wave: "wave";
-  shake: "shake";
-  pulse: "pulse";
-  float: "float";
-  heartbeat: "heartbeat";
-  wobble: "wobble";
-  jello: "jello";
-  "rubber-band": "rubber-band";
-  tada: "tada";
-  vibrate: "vibrate";
-  flicker: "flicker";
-  breathe: "breathe";
-  tilt: "tilt";
-  "zoom-pulse": "zoom-pulse";
-  "focus-zoom": "focus-zoom";
-  "pan-left": "pan-left";
-  "pan-right": "pan-right";
-  "pan-up": "pan-up";
-  "pan-down": "pan-down";
-  "ken-burns": "ken-burns";
-}>;
 declare const zShapeType: z.ZodEnum<{
   rectangle: "rectangle";
   circle: "circle";
@@ -289,206 +512,7 @@ type BlendMode = (typeof BLEND_MODES)[number];
 type Easing = (typeof EASINGS)[number];
 type TransitionType = (typeof TRANSITION_TYPES)[number];
 type VideoEffectType = (typeof VIDEO_EFFECT_TYPES)[number];
-type AudioEffectType = (typeof AUDIO_EFFECT_TYPES)[number];
 type TrackFlag = (typeof TRACK_FLAGS)[number];
-/**
- * What the ingest service knows about an asset. The model never sees pixels;
- * it edits against this, and the resolver turns `word:`/`shot:` references
- * into seconds with it.
- */
-interface AssetManifest {
-  readonly assets: Readonly<Record<string, AssetEntry>>;
-}
-interface AssetEntry {
-  readonly id: string;
-  readonly kind: "video" | "audio" | "image";
-  /** Seconds. Images report 0 and may be held for any duration. */
-  readonly duration: number;
-  readonly fps?: number;
-  readonly width?: number;
-  readonly height?: number;
-  readonly audio?: {
-    readonly sampleRate: number;
-    readonly channels: number;
-    readonly streams: number;
-  };
-  readonly transcript?: {
-    readonly words: readonly TranscriptWord[];
-  };
-  readonly shots?: readonly Shot[];
-  readonly silences?: readonly Silence[];
-  readonly waveform?: WaveformSummary;
-  /** Where the subject (a face, a person) sits in the picture, sampled over time; several boxes may share a `t`. */
-  readonly subjects?: readonly SubjectBox[];
-}
-/** A subject's box at source second `t`, as fractions of the source picture (0..1 from its top left). */
-interface SubjectBox {
-  readonly t: number;
-  readonly x: number;
-  readonly y: number;
-  readonly w: number;
-  readonly h: number;
-}
-interface TranscriptWord {
-  readonly i: number;
-  readonly text: string;
-  readonly start: number;
-  readonly end: number;
-  readonly speaker?: string;
-}
-interface Shot {
-  readonly i: number;
-  readonly start: number;
-  readonly end: number;
-}
-interface Silence {
-  readonly i: number;
-  readonly start: number;
-  readonly end: number;
-}
-interface WaveformSummary {
-  readonly binSeconds: number;
-  readonly peaks: readonly number[];
-  readonly rms: readonly number[];
-}
-declare const EMPTY_MANIFEST: AssetManifest;
-declare function assetIdOf(ref: string): string;
-declare function lookupAsset(manifest: AssetManifest, ref: string): AssetEntry | null;
-type ResolveErrorCode = "DANGLING_ANCHOR" |
-/** `at` names a moment the anchor does not play: trimmed out, or the anchor is not footage. */
-"INVALID_ANCHOR" |
-/** `at` on an anchor the first version cannot map: reversed, or with speed keys or freezes. */
-"UNSUPPORTED_ANCHOR" | "CYCLE" | "TRIM_PAST_SOURCE" | "UNKNOWN_REF" | "NOT_ADJACENT" | "INSUFFICIENT_HANDLES" | "NO_VISUAL_PARENT" | "DUPLICATE_ID" | "MISSING_ASSET" | "START_ON_SEQUENCE" | "MISSING_START" | "AMBIGUOUS_DURATION" | "INVALID_CHILD" | "INVALID_TIME_RANGE" | "UNKNOWN_TOKEN" | "UNKNOWN_STYLE" | "SCHEMA";
-interface ResolveError {
-  readonly code: ResolveErrorCode;
-  readonly id: string;
-  readonly prop?: string;
-  readonly message: string;
-}
-declare function isResolveError(value: unknown): value is ResolveError;
-type TimeRef = number | `word:${number}` | `word:${number}.end` | `shot:${number}` | `shot:${number}.end` | `silence:${number}` | `silence:${number}.end` | `marker:${string}`;
-type ParsedTimeRef = {
-  readonly kind: "seconds";
-  readonly value: number;
-} | {
-  readonly kind: "word" | "shot" | "silence";
-  readonly index: number;
-  readonly edge: "start" | "end";
-} | {
-  readonly kind: "marker";
-  readonly id: string;
-} | {
-  readonly kind: "invalid";
-  readonly reason: string;
-};
-declare function isTimeRefString(value: unknown): value is string;
-declare function parseTimeRef(ref: unknown): ParsedTimeRef;
-/**
- * Turn a reference into seconds. Word, shot and silence references are source
- * times on the asset; marker references are composition times.
- */
-declare function resolveTimeRef(ref: unknown, asset: AssetEntry | null, markers: ReadonlyMap<string, number>, ctx: {
-  readonly id: string;
-  readonly prop: string;
-}): number | ResolveError;
-type Editable = "literal" | "generated" | "opaque";
-/** Prop keys under this prefix address a Layer's handles rather than the Layer's own props. */
-declare const INTERIOR_PREFIX = "interior.";
-/**
- * One vocabulary element as collected from the React element tree, before
- * schema parsing and before placement. `props` are the raw JSX props minus
- * `children`.
- */
-interface CollectedNode {
-  readonly id: string;
-  readonly kind: string;
-  readonly props: Readonly<Record<string, unknown>>;
-  readonly children: readonly CollectedNode[];
-  /** Text content for elements whose children are text (Title). */
-  readonly text?: string;
-  readonly parent: string | null;
-  readonly editable: Editable;
-  /** Props whose source value is an expression the editor cannot write (known only when a SourceIndex was supplied). */
-  readonly lockedProps: readonly string[];
-  /** Prop → `schema` key for props that read the file's props; a write to one rewrites `defaults`. */
-  readonly boundProps: Readonly<Record<string, string>>;
-  /** For helper output: which helper produced the node, under which parent, and the helper's nth use in the file. */
-  readonly origin?: {
-    readonly helper: string;
-    readonly callerId: string | null;
-    readonly callIndex: number;
-  };
-  /** A Layer's handles: the one component inside it and its props. The component's body stays opaque. */
-  readonly interior?: LayerInterior;
-}
-interface LayerInterior {
-  readonly component: string;
-  readonly props: Readonly<Record<string, unknown>>;
-}
-interface CollectedTree {
-  readonly root: CollectedNode;
-  readonly byId: ReadonlyMap<string, CollectedNode>;
-  readonly errors: readonly ResolveError[];
-}
-declare function walk(node: CollectedNode, visit: (node: CollectedNode, depth: number) => void, depth?: number): void;
-declare function findParentOf(tree: CollectedTree, id: string): CollectedNode | null;
-type Json = null | boolean | number | string | Json[] | {
-  [key: string]: Json;
-};
-/** One change recorded by an action. Patches address elements by id, never by position in the file. */
-type Patch = {
-  readonly op: "set";
-  readonly id: string;
-  readonly prop: string;
-  readonly value: Json | undefined;
-} | {
-  readonly op: "text";
-  readonly id: string;
-  readonly text: string;
-} | {
-  readonly op: "insert";
-  readonly id: string;
-  readonly parent: string;
-  readonly after: string | null;
-  readonly node: CollectedNode;
-} | {
-  readonly op: "remove";
-  readonly id: string;
-} | {
-  readonly op: "move";
-  readonly id: string;
-  readonly parent: string;
-  readonly after: string | null;
-} | {
-  readonly op: "bake";
-  readonly id: string;
-};
-type Presence = "present" | "inserted" | "removed";
-/** The reduced effect of every patch on one element. */
-interface NetPatch {
-  readonly id: string;
-  presence: Presence;
-  readonly props: Map<string, Json | undefined>;
-  text?: string;
-  place?: {
-    parent: string;
-    after: string | null;
-  };
-  node?: CollectedNode;
-  bake: boolean;
-}
-interface PatchLog {
-  readonly entries: readonly Patch[];
-  readonly net: ReadonlyMap<string, NetPatch>;
-  /** Increments on every append or truncate; resolve() memoises on it. */
-  readonly version: number;
-  append(patch: Patch): void;
-  /** Current length, for history entries to remember what they appended. */
-  mark(): number;
-  /** Drop every entry at or after `mark` and rebuild `net`. */
-  truncate(mark: number): void;
-  clear(): void;
-}
 /**
  * The built-in themes and motion styles a file can name. A theme is a palette,
  * fonts, a corner radius, a motion style and named presets per element kind;
@@ -624,11 +648,40 @@ interface ResolvedState {
   readonly log: PatchLog | undefined;
   /** The composition's theme, its base merged in; the default theme when the file declares none. */
   readonly theme: ResolvedTheme;
+  /** The faces the file declares (`font()`, `googleFont()`), which every renderer loads. */
+  readonly fonts: readonly DeclaredFont[];
+  /** The effects and transitions the file declares (`defineEffect()`, `defineTransition()`). */
+  readonly shaders: readonly ShaderDefinition[];
 }
 /** Absolute placements for every element, computed from the tree, the manifests and the patch log. Memoised per log on its version. */
 declare function resolve(tree: CollectedTree, manifest: AssetManifest, log?: PatchLog): ResolvedState;
 /** Whether two placements would render and edit the same; used to hand back the previous object. */
 declare function samePlacement(a: Placement, b: Placement): boolean;
+type TimeRef = number | `word:${number}` | `word:${number}.end` | `shot:${number}` | `shot:${number}.end` | `silence:${number}` | `silence:${number}.end` | `marker:${string}`;
+type ParsedTimeRef = {
+  readonly kind: "seconds";
+  readonly value: number;
+} | {
+  readonly kind: "word" | "shot" | "silence";
+  readonly index: number;
+  readonly edge: "start" | "end";
+} | {
+  readonly kind: "marker";
+  readonly id: string;
+} | {
+  readonly kind: "invalid";
+  readonly reason: string;
+};
+declare function isTimeRefString(value: unknown): value is string;
+declare function parseTimeRef(ref: unknown): ParsedTimeRef;
+/**
+ * Turn a reference into seconds. Word, shot and silence references are source
+ * times on the asset; marker references are composition times.
+ */
+declare function resolveTimeRef(ref: unknown, asset: AssetEntry | null, markers: ReadonlyMap<string, number>, ctx: {
+  readonly id: string;
+  readonly prop: string;
+}): number | ResolveError;
 type ActionErrorCode = "ELEMENT_NOT_FOUND" | "TRACK_LOCKED" | "LOCKED_PROP" | "OPAQUE_TARGET" | "INVALID_PARAMS" | "INVALID_TIME_RANGE" | "OUT_OF_BOUNDS" | "NOT_ADJACENT" | "INSUFFICIENT_HANDLES" | "CYCLE" | "DUPLICATE_ID" | "UNSUPPORTED_ON_LAYOUT" | "UNKNOWN_ACTION" | "NOT_IMPLEMENTED";
 interface ActionError {
   readonly code: ActionErrorCode;
@@ -844,31 +897,11 @@ interface ClipActions {
     id: Id;
     value: boolean;
   };
-  "clip/setPitchCorrection": {
-    id: Id;
-    value: boolean;
-  };
-  "clip/setSmoothSlowMo": {
-    id: Id;
-    value: boolean;
-  };
-  "clip/setStabilization": {
-    id: Id;
-    value?: Json;
-  };
-  "clip/setChromaKey": {
-    id: Id;
-    value?: Json;
-  };
   "clip/setBlend": {
     id: Id;
     mode?: string;
     opacity?: number;
   };
-  "clip/setEmphasis": {
-    id: Id;
-    value?: Json;
-  };
   "clip/setFit": {
     id: Id;
     value?: string;
@@ -946,13 +979,6 @@ interface EffectActions {
   "effect/toggle": ChildStack<string>["toggle"];
   "effect/setOrder": ChildStack<string>["setOrder"];
   "effect/setStack": ChildStack<string>["setStack"];
-  "audioEffect/add": ChildStack<string>["add"];
-  "audioEffect/remove": ChildStack<string>["remove"];
-  "audioEffect/restore": ChildStack<string>["restore"];
-  "audioEffect/update": ChildStack<string>["update"];
-  "audioEffect/toggle": ChildStack<string>["toggle"];
-  "audioEffect/setOrder": ChildStack<string>["setOrder"];
-  "audioEffect/setStack": ChildStack<string>["setStack"];
   "colorGrade/set": {
     id: Id;
     grading?: Readonly<Record<string, Json>>;
@@ -966,7 +992,6 @@ interface KeyframeActions {
     at: number;
     value: Json;
     easing?: string;
-    handles?: Json;
   };
   "keyframe/remove": {
     id: Id;
@@ -982,8 +1007,6 @@ interface KeyframeActions {
     keyId: Id;
     value?: Json;
     easing?: string;
-    handles?: Json;
-    roving?: boolean;
   };
   "keyframe/move": {
     id: Id;
@@ -1003,7 +1026,8 @@ interface TransitionActions {
       on: Id;
       edge: "in" | "out";
     };
-    type: TransitionType;
+    /** A built-in transition, or one the file declares with `defineTransition()`. */
+    type: TransitionType | (string & {});
     duration: number;
     params?: Readonly<Record<string, Json>>;
   };
@@ -1018,7 +1042,7 @@ interface TransitionActions {
   };
   "transition/update": {
     transitionId: Id;
-    type?: TransitionType;
+    type?: TransitionType | (string & {});
     duration?: number;
     params?: Readonly<Record<string, Json>>;
   };
@@ -1278,4 +1302,4 @@ declare const AUTO_GROUP_TYPES: ReadonlySet<ActionType>;
 declare const TARGET_PARAM_KEYS: readonly ["id", "leftId", "trackId", "transitionId", "childId", "keyId", "captionId", "captionsId", "cutId", "markerId"];
 declare function targetIdOf(action: ActionInput): string | null;
 declare function describeAction(action: ActionInput): string;
-export { MotionStyle as $, MASK_EASINGS as $t, ValidationResult as A, zTextAnimationPreset as An, Silence as At, ResolvedTheme as B, BLEND_MODES as Bt, TransitionActions as C, zEasing as Cn, ResolveError as Ct, ActionErrorCode as D, zKeyframeProperty as Dn, AssetManifest as Dt, ActionError as E, zGraphicAnimation as En, AssetEntry as Et, Placement as F, lookupAsset as Ft, resolveTheme as G, EMPHASIS_ANIMATIONS as Gt, ThemeOrigin as H, CAPTION_ANIMATIONS as Ht, ResolvedState as I, ANIMATION_UNITS as It, FONT_KEYS as J, FitMode as Jt, themeToken as K, Easing as Kt, ResolvedTrack as L, AUDIO_EFFECT_TYPES as Lt, nodeOfSpec as M, zTrackRole as Mn, TranscriptWord as Mt, nodeSpecOf as N, zTransitionType as Nn, WaveformSummary as Nt, NodeSpec as O, zMaskEasing as On, EMPTY_MANIFEST as Ot, ok as P, zVideoEffectType as Pn, assetIdOf as Pt, MotionName as Q, KEYFRAME_PROPERTY_PATTERN as Qt, resolve as R, AUTOMATION_LANES as Rt, TransformActions as S, zCaptionAnimation as Sn, resolveTimeRef as St, targetIdOf as T, zFitMode as Tn, isResolveError as Tt, Themed as U, CAPTION_POSITIONS as Ut, ThemeIssue as V, BlendMode as Vt, applyTheme as W, EASINGS as Wt, MOTION_NAMES as X, INTERPOLATION_QUALITIES as Xt, MOTIONS as Y, GRAPHIC_ANIMATIONS as Yt, MotionAnimation as Z, KEYFRAME_PROPERTIES as Zt, OverlayActions as _, VIDEO_EFFECT_TYPES as _n, walk as _t, ActionType as a, TEXT_ALIGNS as an, ThemeName as at, TARGET_PARAM_KEYS as b, zAudioEffectType as bn, isTimeRefString as bt, ClipActions as c, TEXT_VALIGNS as cn, Patch as ct, KeyframeActions as d, TRACK_ROLES as dn, CollectedNode as dt, MASK_TYPES as en, PALETTE_KEYS as et, LayerActions as f, TRANSITION_TYPES as fn, CollectedTree as ft, Namespace as g, TransitionType as gn, findParentOf as gt, MulticamActions as h, TrackRole as hn, LayerInterior as ht, ActionMap as i, SVG_COLOR_MODES as in, ThemeDefinition as it, invalid as j, zTrackLayout as jn, SubjectBox as jt, PlacementSpec as k, zShapeType as kn, Shot as kt, CompositionActions as l, TRACK_FLAGS as ln, PatchLog as lt, MaskActions as m, TrackLayout as mn, INTERIOR_PREFIX as mt, Action as n, SHAPE_TYPES as nn, THEMES as nt, AudioActions as o, TEXT_ANIMATION_PRESETS as on, Json as ot, MarkerActions as p, TrackFlag as pn, Editable as pt, DEFAULT_THEME as q, FIT_MODES as qt, ActionInput as r, STABILIZE_CROP_MODES as rn, THEME_NAMES as rt, CaptionActions as s, TEXT_DECORATIONS as sn, NetPatch as st, AUTO_GROUP_TYPES as t, MATTE_CHANNELS as tn, Presets as tt, EffectActions as u, TRACK_LAYOUTS as un, Presence as ut, SourceActions as v, VideoEffectType as vn, ParsedTimeRef as vt, describeAction as w, zEmphasisAnimation as wn, ResolveErrorCode as wt, TrackActions as x, zBlendMode as xn, parseTimeRef as xt, SpeedActions as y, isKeyframeProperty as yn, TimeRef as yt, samePlacement as z, AudioEffectType as zt };
+export { FONT_KEYS as $, zTrackRole as $t, ValidationResult as A, ShaderDefinition as An, TEXT_DECORATIONS as At, Placement as B, Shot as Bn, VIDEO_EFFECT_TYPES as Bt, TransitionActions as C, MODULE_FONTS as Cn, KEYFRAME_PROPERTY_PATTERN as Ct, ActionErrorCode as D, googleFont as Dn, SVG_COLOR_MODES as Dt, ActionError as E, fontsOf as En, SHAPE_TYPES as Et, ParsedTimeRef as F, shadersOf as Fn, TRANSITION_TYPES as Ft, ResolvedTheme as G, assetIdOf as Gn, zEasing as Gt, ResolvedTrack as H, SubjectBox as Hn, isKeyframeProperty as Ht, TimeRef as I, usesShaders as In, TrackFlag as It, Themed as J, zKeyframeProperty as Jt, ThemeIssue as K, lookupAsset as Kn, zFitMode as Kt, isTimeRefString as L, AssetEntry as Ln, TrackLayout as Lt, nodeOfSpec as M, defineEffect as Mn, TRACK_FLAGS as Mt, nodeSpecOf as N, defineTransition as Nn, TRACK_LAYOUTS as Nt, NodeSpec as O, isBundledFont as On, TEXT_ALIGNS as Ot, ok as P, shaderFor as Pn, TRACK_ROLES as Pt, DEFAULT_THEME as Q, zTrackLayout as Qt, parseTimeRef as R, AssetManifest as Rn, TrackRole as Rt, TransformActions as S, FontStyle as Sn, KEYFRAME_PROPERTIES as St, targetIdOf as T, font as Tn, MASK_TYPES as Tt, resolve as U, TranscriptWord as Un, zBlendMode as Ut, ResolvedState as V, Silence as Vn, VideoEffectType as Vt, samePlacement as W, WaveformSummary as Wn, zCaptionAnimation as Wt, resolveTheme as X, zShapeType as Xt, applyTheme as Y, zMaskEasing as Yt, themeToken as Z, zTextAnimationPreset as Zt, OverlayActions as _, BUNDLED_FONTS as _n, EASINGS as _t, ActionType as a, PatchLog as an, PALETTE_KEYS as at, TARGET_PARAM_KEYS as b, DeclaredFont as bn, FitMode as bt, ClipActions as c, CollectedTree as cn, THEME_NAMES as ct, KeyframeActions as d, LayerInterior as dn, ANIMATION_UNITS as dt, zTransitionType as en, MOTIONS as et, LayerActions as f, findParentOf as fn, AUTOMATION_LANES as ft, Namespace as g, isResolveError as gn, CAPTION_POSITIONS as gt, MulticamActions as h, ResolveErrorCode as hn, CAPTION_ANIMATIONS as ht, ActionMap as i, Patch as in, MotionStyle as it, invalid as j, collectShaders as jn, TEXT_VALIGNS as jt, PlacementSpec as k, MODULE_SHADERS as kn, TEXT_ANIMATION_PRESETS as kt, CompositionActions as l, Editable as ln, ThemeDefinition as lt, MaskActions as m, ResolveError as mn, BlendMode as mt, Action as n, Json as nn, MotionAnimation as nt, AudioActions as o, Presence as on, Presets as ot, MarkerActions as p, walk as pn, BLEND_MODES as pt, ThemeOrigin as q, zGraphicAnimation as qt, ActionInput as r, NetPatch as rn, MotionName as rt, CaptionActions as s, CollectedNode as sn, THEMES as st, AUTO_GROUP_TYPES as t, zVideoEffectType as tn, MOTION_NAMES as tt, EffectActions as u, INTERIOR_PREFIX as un, ThemeName as ut, SourceActions as v, BUNDLED_FONT_WEIGHTS as vn, Easing as vt, describeAction as w, collectFonts as wn, MASK_EASINGS as wt, TrackActions as x, FontSource as xn, GRAPHIC_ANIMATIONS as xt, SpeedActions as y, BundledFont as yn, FIT_MODES as yt, resolveTimeRef as z, EMPTY_MANIFEST as zn, TransitionType as zt };