@cutcraft/kit 0.0.0-stage → 0.2.0

package/dist/index.mjs

@@ -0,0 +1 @@
+export { Jn as ANIMATION_UNITS, Yn as AUTOMATION_LANES, lt as AUTO_GROUP_TYPES, ct as ActionHistory, tn as Adjustment, nn as Angle, rn as Audio, Xn as BLEND_MODES, c as BUNDLED_FONTS, l as BUNDLED_FONT_WEIGHTS, Zn as CAPTION_ANIMATIONS, Qn as CAPTION_POSITIONS, in as Caption, an as Captions, on as Clip, sn as ColorGrade, cn as Composition, ln as Cut, St as DEFAULT_CUE_OPTIONS, Vn as DEFAULT_THEME, $n as EASINGS, kt as EASING_FN, un as ELEMENTS, Ht as EMPTY_MANIFEST, dn as ENGINE_LAYERS, fn as ENGINE_SCHEMAS, pn as Effect, rt as Executor, er as FIT_MODES, Hn as FONT_KEYS, mn as Freeze, tr as GRAPHIC_ANIMATIONS, hn as Gap, gn as Graphic, yt as INTERIOR_PREFIX, nr as KEYFRAME_PROPERTIES, rr as KEYFRAME_PROPERTY_PATTERN, Pr as KIND_CAPABILITIES, _n as Keyframe, vn as Layer, b as MASKED_KINDS, ir as MASK_EASINGS, x as MASK_NOT_RENDERED, ar as MASK_TYPES, u as MODULE_FONTS, Jt as MODULE_SHADERS, Un as MOTIONS, Wn as MOTION_NAMES, yn as Marker, bn as Mask, xn as Motion, Sn as Multicam, S as NOT_RENDERED, Cn as Nested, N as NotImplemented, Gn as PALETTE_KEYS, C as RENDERED_VALUES, wn as SCHEMAS_BY_KIND, or as SHAPE_TYPES, In as STYLED_KINDS, sr as SVG_COLOR_MODES, Tn as Shape, En as SpeedKey, Dn as Sticker, On as Svg, ut as TARGET_PARAM_KEYS, cr as TEXT_ALIGNS, lr as TEXT_ANIMATION_PRESETS, ur as TEXT_DECORATIONS, dr as TEXT_VALIGNS, Kn as THEMES, qn as THEME_NAMES, Ln as TOKEN_PATTERN, fr as TRACK_FLAGS, pr as TRACK_LAYOUTS, mr as TRACK_ROLES, Pn as TRANSITION_PARAMS, hr as TRANSITION_TYPES, kn as Three, An as Title, jn as Track, Mn as Transition, gr as VIDEO_EFFECT_TYPES, zt as applyTheme, Ir as asJson, Ut as assetIdOf, Fr as capabilitiesOf, P as childAt, F as childIndex, o as collect, I as collectErrors, d as collectFonts, s as collectModule, Yt as collectShaders, Lr as createPatchLog, Ct as cueNodes, Fn as defaultTransitionParams, L as define, Xt as defineEffect, jr as defineElement, Zt as defineTransition, dt as describeAction, Nn as engineOf, bt as findParentOf, f as font, p as fontsOf, At as freezeHoldsOf, jt as freezeShift, Mt as freezeUnshift, it as getHandler, m as googleFont, t as graphicControls, E as holdLayerFrame, Nt as holdTotal, R as insertNode, _ as installLayerClock, D as installLayerEngine, A as interpolate, pt as invalid, at as inverseOf, h as isBundledFont, z as isError, _r as isKeyframeProperty, a as isResolveError, Gt as isTimeRefString, Mr as isVocabulary, Nr as kindOf, B as lastChildId, O as layerEngine, k as layerFramesPending, ot as listHandlers, Wt as lookupAsset, V as makePropHandler, w as motionBlurOf, Rn as motionStyleSchema, mt as nodeOfSpec, ht as nodeSpecOf, Rr as nodesEqual, gt as ok, wt as onTimeline, Kt as parseTimeRef, g as parseTranscript, H as placeNode, U as placementOf, W as placementProps, Tt as planCues, Et as playsKey, Pt as rampAdvance, Ft as rampInverse, It as rampSpeed, j as random, G as rawNode, K as rawProp, zr as reduceInto, st as registerHandler, q as requireElement, J as requireLayout, Y as requireLiteralProp, X as requireNotOpaque, Z as requireUnlocked, _t as resolve, i as resolveScene, Bt as resolveTheme, qt as resolveTimeRef, Dt as sameAsset, vt as samePlacement, Q as setProps, Qt as shaderFor, $t as shadersOf, T as shutterTimes, $ as siblingAfter, Lt as speedKeysOf, M as spring, Rt as springAt, Br as stableJson, et as stub, r as subtitles, ft as targetIdOf, zn as themeSchema, Vt as themeToken, Ot as timelineWords, Bn as tokenSchema, tt as uniqueId, v as useLayer, y as useT, en as usesShaders, nt as validateTarget, xt as walk, vr as zBlendMode, yr as zCaptionAnimation, br as zEasing, xr as zFitMode, Sr as zGraphicAnimation, Cr as zKeyframeProperty, wr as zMaskEasing, Tr as zShapeType, Er as zTextAnimationPreset, Dr as zTrackLayout, Or as zTrackRole, kr as zTransitionType, Ar as zVideoEffectType } from "./src-CcFjz_DV.mjs";

package/dist/source/index-public.d.mts

@@ -0,0 +1,236 @@
+import { O as NodeSpec, Rn as AssetManifest, V as ResolvedState, an as PatchLog, nn as Json } from "../index-BYYpzZuS.mjs";
+import { ZodObject } from "zod";
+import { ReactNode } from "react";
+import * as t from "@babel/types";
+import { ParseResult } from "@babel/parser";
+interface ParsedSource {
+  readonly text: string;
+  readonly ast: ParseResult<t.File>;
+}
+export declare function parseSource(text: string): ParsedSource;
+type Range = readonly [start: number, end: number];
+export declare function rangeOf(node: {
+  start?: number | null;
+  end?: number | null;
+}): Range;
+type SourceEdit = {
+  readonly kind: "prop";
+  readonly id: string;
+  readonly prop: string;
+  readonly range: Range;
+  readonly text: string;
+} | {
+  readonly kind: "text";
+  readonly id: string;
+  readonly range: Range;
+  readonly text: string;
+} | {
+  readonly kind: "insert";
+  readonly id: string;
+  readonly range: Range;
+  readonly text: string;
+} | {
+  readonly kind: "remove";
+  readonly id: string;
+  readonly range: Range;
+  readonly text: "";
+} | {
+  readonly kind: "move";
+  readonly id: string;
+  readonly range: Range;
+  readonly text: string;
+  readonly from: Range;
+} | {
+  readonly kind: "bake";
+  readonly id: string;
+  readonly range: Range;
+  readonly text: string;
+} | {
+  readonly kind: "defaults";
+  readonly id: string;
+  readonly range: Range;
+  readonly text: string;
+};
+/** Splice edits into the text, last range first, refusing overlaps. */
+export declare function applyEdits(text: string, edits: readonly SourceEdit[]): string;
+/** Widen an element range to swallow its own line(s): leading indentation and the trailing newline. */
+export declare function lineRange(text: string, range: Range): Range;
+interface PropSite {
+  readonly name: string;
+  /** The whole attribute, including the name. */
+  readonly range: Range;
+  /** The value token: the string literal, or the expression inside `{}`. Null for a bare attribute. */
+  readonly valueRange: Range | null;
+  /** The value when it is a literal (or a bare attribute, which is `true`). */
+  readonly literal: Json | undefined;
+  readonly isExpression: boolean;
+  /** The `schema` key this prop reads, when the expression is a plain reference to one of the file's props. */
+  readonly binding?: string;
+}
+/** The one component inside a Layer: its props are the Layer's handles, its body is opaque. */
+interface InteriorSite {
+  readonly component: string;
+  readonly range: Range;
+  readonly openingTag: Range;
+  readonly props: ReadonlyMap<string, PropSite>;
+  readonly lockedProps: readonly string[];
+  readonly boundProps: Readonly<Record<string, string>>;
+}
+interface ElementSite {
+  readonly generated: false;
+  readonly id: string;
+  readonly kind: string;
+  readonly name: string;
+  readonly range: Range;
+  readonly openingTag: Range;
+  readonly closingTag: Range | null;
+  /** Between the opening and closing tags; null when self-closing. */
+  readonly childrenRange: Range | null;
+  readonly props: ReadonlyMap<string, PropSite>;
+  readonly parent: string | null;
+  readonly siblingIndex: number;
+  /** Expression props with no binding: the editor cannot write them without baking. */
+  readonly lockedProps: readonly string[];
+  /** Prop → schema key for props that reference the file's props; edits to them rewrite `defaults`. */
+  readonly boundProps: Readonly<Record<string, string>>;
+  readonly indent: string;
+  /** Set on a Layer whose interior is exactly one component element; its props also appear on the Layer as `interior.<name>`. */
+  readonly interior?: InteriorSite;
+}
+interface HelperCallSite {
+  readonly helper: string;
+  /** The helper's nth use in the file, in source order; matches `CollectedNode.origin.callIndex`. */
+  readonly callIndex: number;
+  readonly range: Range;
+  readonly parent: string | null;
+  readonly siblingIndex: number;
+  readonly indent: string;
+}
+interface HelperSite {
+  readonly name: string;
+  readonly range: Range;
+  readonly pure: boolean;
+  readonly hooks: readonly string[];
+  /** Whether its JSX names vocabulary elements: such a helper is expanded by the resolver, not mounted by React. */
+  readonly producesElements: boolean;
+}
+interface SourceIndex {
+  readonly text: string;
+  readonly ast: t.File;
+  readonly elements: ReadonlyMap<string, ElementSite>;
+  readonly calls: readonly HelperCallSite[];
+  readonly helpers: ReadonlyMap<string, HelperSite>;
+  /** The `export const defaults = {...}` object literal. */
+  readonly defaults: {
+    readonly range: Range;
+    readonly props: ReadonlyMap<string, PropSite>;
+  } | null;
+  readonly hasSchema: boolean;
+  readonly hasDefaultExport: boolean;
+  readonly compositionId: string | null;
+  /** Vocabulary elements without a literal id, for the lint. */
+  readonly anonymous: readonly {
+    readonly kind: string;
+    readonly range: Range;
+    readonly reason: string;
+  }[];
+  /** Every vocabulary element's literal `id` attribute, in source order, duplicates included. */
+  readonly idSites: readonly {
+    readonly id: string;
+    readonly range: Range;
+  }[];
+  /** HTML (`<div>`, `<span>`…) placed straight in a `<Track>` or `<Composition>`, where nothing draws it. */
+  readonly strays: readonly {
+    readonly name: string;
+    readonly range: Range;
+    readonly parent: string;
+  }[];
+  /** Vocabulary elements whose id is an expression (`id={id}` in a helper, `` id={`dot-${i}`} `` in a loop): the JSX that makes them, with the id's source text. */
+  readonly dynamic: readonly {
+    readonly kind: string;
+    readonly range: Range;
+    readonly idText: string;
+  }[];
+}
+/**
+ * Index every vocabulary JSX element with a literal id so patches can be
+ * written back as text edits. Elements inside helper functions are indexed
+ * too; whether they are literal or generated at runtime is decided by
+ * `collect`, which sees how often the helper is used.
+ */
+export declare function buildSourceIndex(text: string): SourceIndex;
+/** Evaluate a literal expression (numbers, strings, booleans, null, arrays and objects of literals, template strings without holes). */
+export declare function literalOf(node: t.Node | null | undefined): {
+  ok: boolean;
+  value: Json | undefined;
+};
+export declare function indentOf(text: string, pos: number): string;
+/**
+ * Replace the helper call that produced a generated element with the literal
+ * elements that call produced, so the editor can address them. Multicam cuts
+ * are baked by appending their generated clips after the generator.
+ */
+export declare function bake(text: string, id: string, state: ResolvedState, index?: SourceIndex): SourceEdit[];
+interface FoldResult {
+  readonly text: string;
+  readonly edits: readonly SourceEdit[];
+  readonly baked: readonly string[];
+  /** Ids whose patches could not be written (opaque interiors, missing sites). */
+  readonly skipped: readonly {
+    readonly id: string;
+    readonly reason: string;
+  }[];
+}
+/**
+ * Turn the patch log's net effect into text edits against the index.
+ * Targets without a literal site are reported, not folded; `foldToSource`
+ * bakes them first and folds again.
+ */
+export declare function fold(log: PatchLog, index: SourceIndex, state: ResolvedState): {
+  edits: SourceEdit[];
+  needsBake: string[];
+  skipped: FoldResult["skipped"];
+};
+/** Fold with baking: generated targets are baked into literals, the file is re-indexed, and the fold is retried. */
+export declare function foldToSource(text: string, log: PatchLog, state: ResolvedState, maxRounds?: number): FoldResult;
+interface Rule {
+  readonly name: string;
+  check(index: SourceIndex, options: LintOptions): Diagnostic[];
+}
+export declare const rules: readonly Rule[];
+interface Diagnostic {
+  readonly rule: string;
+  readonly severity: "error" | "warning";
+  readonly message: string;
+  readonly range: Range;
+  readonly id?: string;
+  readonly prop?: string;
+}
+interface LintOptions {
+  readonly manifest?: AssetManifest;
+  readonly rules?: readonly string[];
+}
+type LintRule = (index: SourceIndex, options: LintOptions) => Diagnostic[];
+/** Static checks on a video file: the conventions that keep it editable by the UI. */
+export declare function lint(text: string, options?: LintOptions): Diagnostic[];
+/** What a cut file exports: the schema of its tweakable values, their defaults, and the video itself. */
+interface CutModule {
+  schema?: ZodObject;
+  defaults?: Record<string, unknown>;
+  default: (props: Record<string, unknown>) => ReactNode;
+}
+/** The modules a cut file may import. `@cut/kit` is the kit's old name, still accepted from older files. */
+export declare const ALLOWED_IMPORTS: Readonly<Record<string, unknown>>;
+interface LoadOptions {
+  /** Modules the host offers beyond `ALLOWED_IMPORTS`, by import name: the libraries free code in a Layer may use. */
+  readonly imports?: Readonly<Record<string, unknown>>;
+}
+export declare function loadModule(source: string, options?: LoadOptions): CutModule;
+/** JavaScript source for a JSON value, compact, double-quoted. */
+export declare function printLiteral(value: Json | undefined): string;
+/** One JSX attribute. Strings as `name="…"`, everything else as `name={…}`, `true` as a bare attribute. */
+export declare function printProp(name: string, value: Json | undefined): string;
+export declare function elementName(kind: string): string;
+/** A whole element as JSX text, indented with `indent`, children on their own lines. */
+export declare function printElement(spec: NodeSpec, indent?: string, step?: string): string;
+export type { CutModule, Diagnostic, ElementSite, FoldResult, HelperCallSite, HelperSite, LintOptions, LintRule, LoadOptions, PropSite, Range, SourceEdit, SourceIndex };