@cutcraft/kit 0.1.0 → 0.2.0

package/dist/index.mjs

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

@@ -1,8 +1,8 @@
-import { Dt as AssetManifest, I as ResolvedState, O as NodeSpec, lt as PatchLog, ot as Json } from "../index-CLhXqOpF.mjs";
+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 { ParseResult } from "@babel/parser";
 import * as t from "@babel/types";
+import { ParseResult } from "@babel/parser";
 interface ParsedSource {
   readonly text: string;
   readonly ast: ParseResult<t.File>;
@@ -13,6 +13,48 @@ 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. */
@@ -123,55 +165,12 @@ export declare function literalOf(node: t.Node | null | undefined): {
   value: Json | undefined;
 };
 export declare function indentOf(text: string, pos: number): string;
-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;
-/** 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;
+/**
+ * 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[];
@@ -194,12 +193,6 @@ export declare function fold(log: PatchLog, index: SourceIndex, state: ResolvedS
 };
 /** 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;
-/**
- * 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 Rule {
   readonly name: string;
   check(index: SourceIndex, options: LintOptions): Diagnostic[];
@@ -233,4 +226,11 @@ interface LoadOptions {
   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 };

package/dist/source/index-public.mjs

@@ -1,12 +1,49 @@
-import { $ as resolveTheme, Dn as NOT_RENDERED, En as MASK_NOT_RENDERED, Fn as RENDERED_VALUES, J as isBundledFont, Kt as ELEMENTS, Ln as capabilitiesOf, Tn as MASKED_KINDS, dt as INTERIOR_PREFIX, et as themeToken, gt as resolveTimeRef, mn as TOKEN_PATTERN, n as src_exports, pn as STYLED_KINDS, yt as lookupAsset, z as nodeSpecOf } from "../src-BsBU2JLf.mjs";
-import * as zod from "zod";
+import { Bt as resolveTheme, C as RENDERED_VALUES, Fr as capabilitiesOf, In as STYLED_KINDS, Jt as MODULE_SHADERS, Ln as TOKEN_PATTERN, S as NOT_RENDERED, Vt as themeToken, Wt as lookupAsset, Yt as collectShaders, b as MASKED_KINDS, d as collectFonts, dn as ENGINE_LAYERS, h as isBundledFont, ht as nodeSpecOf, n as src_exports, qt as resolveTimeRef, u as MODULE_FONTS, un as ELEMENTS, x as MASK_NOT_RENDERED, yt as INTERIOR_PREFIX } from "../src-CcFjz_DV.mjs";
 import { GRAPHIC_BASE_PROPS, GRAPHIC_KINDS, GRAPHIC_KIND_NAMES, isIcon } from "@cutcraft/graphics";
+import * as zod from "zod";
 import * as React from "react";
-import { parse } from "@babel/parser";
 import traverseModule from "@babel/traverse";
 import * as t from "@babel/types";
+import { parse } from "@babel/parser";
 import * as jsxRuntime from "react/jsx-runtime";
 import { transform } from "sucrase";
+// src/source/edits.ts
+/** Splice edits into the text, last range first, refusing overlaps. */
+function applyEdits(text, edits) {
+	const splices = [];
+	for (const e of edits) if (e.kind === "move") {
+		splices.push({
+			range: e.from,
+			text: ""
+		});
+		splices.push({
+			range: e.range,
+			text: e.text
+		});
+	} else splices.push({
+		range: e.range,
+		text: e.text
+	});
+	splices.sort((a, b) => b.range[0] - a.range[0] || b.range[1] - a.range[1]);
+	let out = text;
+	let lastStart = Number.POSITIVE_INFINITY;
+	for (const s of splices) {
+		if (s.range[1] > lastStart) throw new Error(`overlapping edits at ${s.range[0]}..${s.range[1]}`);
+		out = out.slice(0, s.range[0]) + s.text + out.slice(s.range[1]);
+		lastStart = s.range[0];
+	}
+	return out;
+}
+/** Widen an element range to swallow its own line(s): leading indentation and the trailing newline. */
+function lineRange(text, range) {
+	let start = range[0];
+	const lineStart = text.lastIndexOf("\n", start - 1) + 1;
+	if (/^\s*$/.test(text.slice(lineStart, start))) start = lineStart;
+	let end = range[1];
+	const rest = text.slice(end).match(/^[ \t]*\r?\n/);
+	if (rest) end += rest[0].length;
+	return [start, end];
+}
 // src/source/parse.ts
 function parseSource(text) {
 	return {
@@ -24,7 +61,7 @@ function rangeOf(node) {
 }
 // src/source/index.ts
 const traverse$1 = traverseModule.default ?? traverseModule;
-const KIND_BY_NAME = new Map(Object.entries(ELEMENTS).map(([name, c]) => [name, c.kind]));
+const KIND_BY_NAME = new Map([...Object.entries(ELEMENTS), ...Object.entries(ENGINE_LAYERS)].map(([name, c]) => [name, c.kind]));
 /**
 * Index every vocabulary JSX element with a literal id so patches can be
 * written back as text edits. Elements inside helper functions are indexed
@@ -185,7 +222,7 @@ function buildSourceIndex(text) {
 			});
 			const closing = path.node.closingElement;
 			const childrenRange = closing ? [opening.end ?? 0, closing.start ?? 0] : null;
-			const interior = kind === "layer" ? interiorOf(path.node, inSchemaFn) : null;
+			const interior = name === "Layer" ? interiorOf(path.node, inSchemaFn) : null;
 			if (interior) {
 				for (const prop of interior.lockedProps) locked.push(`${INTERIOR_PREFIX}${prop}`);
 				for (const [prop, key] of Object.entries(interior.boundProps)) bound[`${INTERIOR_PREFIX}${prop}`] = key;
@@ -447,43 +484,6 @@ function indentOf(text, pos) {
 	const prefix = text.slice(lineStart, pos);
 	return /^\s*$/.test(prefix) ? prefix : "";
 }
-// src/source/edits.ts
-/** Splice edits into the text, last range first, refusing overlaps. */
-function applyEdits(text, edits) {
-	const splices = [];
-	for (const e of edits) if (e.kind === "move") {
-		splices.push({
-			range: e.from,
-			text: ""
-		});
-		splices.push({
-			range: e.range,
-			text: e.text
-		});
-	} else splices.push({
-		range: e.range,
-		text: e.text
-	});
-	splices.sort((a, b) => b.range[0] - a.range[0] || b.range[1] - a.range[1]);
-	let out = text;
-	let lastStart = Number.POSITIVE_INFINITY;
-	for (const s of splices) {
-		if (s.range[1] > lastStart) throw new Error(`overlapping edits at ${s.range[0]}..${s.range[1]}`);
-		out = out.slice(0, s.range[0]) + s.text + out.slice(s.range[1]);
-		lastStart = s.range[0];
-	}
-	return out;
-}
-/** Widen an element range to swallow its own line(s): leading indentation and the trailing newline. */
-function lineRange(text, range) {
-	let start = range[0];
-	const lineStart = text.lastIndexOf("\n", start - 1) + 1;
-	if (/^\s*$/.test(text.slice(lineStart, start))) start = lineStart;
-	let end = range[1];
-	const rest = text.slice(end).match(/^[ \t]*\r?\n/);
-	if (rest) end += rest[0].length;
-	return [start, end];
-}
 // src/source/print.ts
 const NAME_BY_KIND = new Map(Object.entries(ELEMENTS).map(([name, c]) => [c.kind, name]));
 const IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
@@ -514,7 +514,7 @@ function elementName(kind) {
 function printElement(spec, indent = "", step = "  ") {
 	const name = elementName(spec.kind);
 	const attrs = Object.entries(spec.props).filter(([k, v]) => v !== void 0 && true).map(([k, v]) => printProp(k, v)).filter(Boolean);
-	const open = `${indent}<${name}${attrs.length ? " " + attrs.join(" ") : ""}`;
+	const open = `${indent}<${name}${attrs.length ? ` ${attrs.join(" ")}` : ""}`;
 	const children = spec.children ?? [];
 	if (children.length === 0 && spec.text === void 0) return `${open} />`;
 	if (children.length === 0) return `${open}>${escapeText(spec.text ?? "")}</${name}>`;
@@ -933,7 +933,7 @@ function bindingEdit(index, id, prop, key, value, skipped) {
 		});
 		return null;
 	}
-	if (!target || !target.valueRange) {
+	if (!target?.valueRange) {
 		skipped.push({
 			id,
 			reason: `"${prop}" is bound to defaults.${key}, which has no literal`
@@ -1035,6 +1035,97 @@ function reindent(source, from, to) {
 	if (from === to) return source;
 	return source.split("\n").map((line, i) => i === 0 ? line : line.startsWith(from) ? to + line.slice(from.length) : line).join("\n");
 }
+// src/source/lint/rules/fonts.ts
+const DECLARERS = /* @__PURE__ */ new Set([
+	"font",
+	"googleFont",
+	"defineEffect",
+	"defineTransition"
+]);
+/** Declarations whose arguments hold code (a zod schema): only their name and shader need be literal. */
+const SHADERS = /* @__PURE__ */ new Set(["defineEffect", "defineTransition"]);
+/** Calls to the kit's declarations (`font()`, `googleFont()`, `defineEffect()`, `defineTransition()`), under whatever local names the file imports them as. */
+function declarations(index) {
+	const local = /* @__PURE__ */ new Map();
+	for (const node of index.ast.program.body) {
+		if (!t.isImportDeclaration(node) || node.source.value !== "@cutcraft/kit") continue;
+		for (const spec of node.specifiers) {
+			if (!t.isImportSpecifier(spec)) continue;
+			const imported = t.isIdentifier(spec.imported) ? spec.imported.name : spec.imported.value;
+			if (DECLARERS.has(imported)) local.set(spec.local.name, imported);
+		}
+	}
+	if (local.size === 0) return [];
+	const top = /* @__PURE__ */ new Set();
+	for (const node of index.ast.program.body) {
+		const decl = t.isExportNamedDeclaration(node) ? node.declaration : node;
+		if (t.isVariableDeclaration(decl)) {
+			for (const d of decl.declarations) if (d.init) top.add(d.init);
+		}
+	}
+	const out = [];
+	t.traverseFast(index.ast.program, (node) => {
+		if (t.isCallExpression(node) && t.isIdentifier(node.callee) && local.has(node.callee.name)) out.push({
+			call: node,
+			topLevel: top.has(node),
+			declarer: local.get(node.callee.name)
+		});
+	});
+	return out;
+}
+/** A value written out in the source: a string, number or boolean, or an array or object of them. */
+function literal(node) {
+	if (t.isStringLiteral(node) || t.isNumericLiteral(node) || t.isBooleanLiteral(node)) return true;
+	if (t.isTemplateLiteral(node)) return node.expressions.length === 0;
+	if (t.isArrayExpression(node)) return node.elements.every((e) => e !== null && literal(e));
+	if (t.isObjectExpression(node)) return node.properties.every((p) => t.isObjectProperty(p) && !p.computed && (t.isIdentifier(p.key) || t.isStringLiteral(p.key)) && literal(p.value));
+	return false;
+}
+/** The families a file declares with literal arguments: `font({ family: "…" })` and `googleFont("…")`. */
+function declaredFamilies(index) {
+	const out = /* @__PURE__ */ new Set();
+	for (const { call, declarer } of declarations(index)) {
+		if (SHADERS.has(declarer)) continue;
+		const [first] = call.arguments;
+		if (t.isStringLiteral(first)) out.add(first.value);
+		else if (t.isObjectExpression(first)) {
+			for (const p of first.properties) if (t.isObjectProperty(p) && t.isIdentifier(p.key, { name: "family" }) && t.isStringLiteral(p.value)) out.add(p.value.value);
+		}
+	}
+	return out;
+}
+/** A `name` and `shader` written out in a `defineEffect()` / `defineTransition()` call's options. */
+function literalShader(call) {
+	const [options] = call.arguments;
+	if (!t.isObjectExpression(options)) return false;
+	const field = (key) => options.properties.find((p) => t.isObjectProperty(p) && t.isIdentifier(p.key, { name: key }))?.value;
+	const name = field("name");
+	const shader = field("shader");
+	return !!name && !!shader && literal(name) && literal(shader);
+}
+/**
+* The kit's declarations (`font()`, `googleFont()`, `defineEffect()`, `defineTransition()`) at the top of the file,
+* with what names them written out, where the editor and lint can read them.
+*/
+const declaration = {
+	name: "declaration",
+	check: (index) => declarations(index).flatMap(({ call, topLevel, declarer }) => {
+		const name = call.callee.name;
+		if (!topLevel) return [{
+			rule: "declaration",
+			severity: "warning",
+			range: rangeOf(call),
+			message: `${name}() inside a function or expression is hidden from the editor; declare it at the top of the file: const x = ${name}(…)`
+		}];
+		if (SHADERS.has(declarer) ? !literalShader(call) : !call.arguments.every(literal)) return [{
+			rule: "declaration",
+			severity: "warning",
+			range: rangeOf(call),
+			message: SHADERS.has(declarer) ? `${name}() takes a literal name and shader, so the editor and lint can read them from the source` : `${name}() takes literal arguments, so the editor and lint can read the font from the source`
+		}];
+		return [];
+	})
+};
 // src/source/lint/rules/free-code.ts
 /** HTML straight in a `<Track>` or `<Composition>`: the resolver walks past it and nothing draws it. */
 const strayHtml = {
@@ -1050,6 +1141,27 @@ const strayHtml = {
 * Free code renders frame by frame against the video's own clock. `useT()`, requestAnimationFrame, Date, performance
 * and CSS animations follow it; timers, media elements playing on their own and canvases kept on the CPU do not.
 */
+/** Libraries with a clock of their own, by module: the imports that run on it, and the adapter that puts them on the video's. */
+const OWN_CLOCK = {
+	"@react-three/fiber": {
+		names: ["Canvas"],
+		use: "<ThreeScene> from @cutcraft/graphics/three"
+	},
+	motion: {
+		names: ["animate"],
+		use: "useTimeline from @cutcraft/graphics/motion"
+	},
+	"motion/react": {
+		names: ["animate", "useAnimate"],
+		use: "useTimeline or useLayerTime from @cutcraft/graphics/motion"
+	},
+	"framer-motion": {
+		names: ["animate", "useAnimate"],
+		use: "useTimeline or useLayerTime from @cutcraft/graphics/motion"
+	}
+};
+/** Props that start a Motion component's own animation. */
+const MOTION_PLAYS = /* @__PURE__ */ new Set(["animate", "whileInView"]);
 const freeCodeClock = {
 	name: "free-code-clock",
 	check: (index) => {
@@ -1062,13 +1174,38 @@ const freeCodeClock = {
 				message
 			});
 		};
+		const ownClock = /* @__PURE__ */ new Map();
+		const motionFactories = /* @__PURE__ */ new Set();
+		for (const node of index.ast.program.body) {
+			if (!t.isImportDeclaration(node)) continue;
+			const lib = OWN_CLOCK[node.source.value];
+			if (!lib) continue;
+			for (const spec of node.specifiers) {
+				if (!t.isImportSpecifier(spec)) continue;
+				const imported = t.isIdentifier(spec.imported) ? spec.imported.name : spec.imported.value;
+				if (lib.names.includes(imported)) ownClock.set(spec.local.name, {
+					imported,
+					use: lib.use
+				});
+				if (node.source.value !== "motion" && (imported === "motion" || imported === "m")) motionFactories.add(spec.local.name);
+			}
+		}
 		t.traverseFast(index.ast.program, (node) => {
 			if (t.isCallExpression(node)) {
 				const callee = node.callee;
 				const name = t.isIdentifier(callee) ? callee.name : t.isMemberExpression(callee) && t.isIdentifier(callee.property) ? callee.property.name : null;
 				if (name === "setTimeout" || name === "setInterval") warn(node, `${name} runs on the wall clock, so an export would not repeat it frame for frame; derive the change from useT() instead`);
-			} else if (t.isJSXOpeningElement(node) && t.isJSXIdentifier(node.name) && (node.name.name === "video" || node.name.name === "audio")) warn(node, `<${node.name.name}> plays on its own clock and its sound is not in the export; use a <Clip> or <Audio>, and useClipFrame for a clip's picture in free code`);
-			else if (t.isObjectProperty(node) && t.isIdentifier(node.key) && node.key.name === "willReadFrequently" && t.isBooleanLiteral(node.value, { value: true })) warn(node, "a canvas with willReadFrequently is kept on the CPU and the export does not capture it; leave the option out");
+				const own = t.isIdentifier(callee) ? ownClock.get(callee.name) : void 0;
+				if (own) warn(node, `${own.imported}() plays on its library's own clock, so a scrub or an export does not follow it; use ${own.use}`);
+			} else if (t.isJSXOpeningElement(node)) {
+				const el = node.name;
+				if (t.isJSXIdentifier(el) && (el.name === "video" || el.name === "audio")) warn(node, `<${el.name}> plays on its own clock and its sound is not in the export; use a <Clip> or <Audio>, and useClipFrame for a clip's picture in free code`);
+				else if (t.isJSXIdentifier(el) && ownClock.has(el.name)) warn(node, `<${el.name}> draws on its own clock, so a scrub or an export does not follow it; use ${ownClock.get(el.name).use}`);
+				else if (t.isJSXMemberExpression(el) && t.isJSXIdentifier(el.object) && motionFactories.has(el.object.name)) {
+					const plays = node.attributes.find((a) => t.isJSXAttribute(a) && t.isJSXIdentifier(a.name) && MOTION_PLAYS.has(a.name.name));
+					if (plays) warn(plays, `<${el.object.name}.${el.property.name}> animates on Motion's own clock, so a scrub or an export does not follow it; drive it with useTimeline or useLayerTime from @cutcraft/graphics/motion`);
+				}
+			} else if (t.isObjectProperty(node) && t.isIdentifier(node.key) && node.key.name === "willReadFrequently" && t.isBooleanLiteral(node.value, { value: true })) warn(node, "a canvas with willReadFrequently is kept on the CPU and the export does not capture it; leave the option out");
 		});
 		return out;
 	}
@@ -1136,6 +1273,25 @@ const graphicProps = {
 		return out;
 	}
 };
+/** `<Graphic>` is deprecated: each one warns, pointing to the free code that replaces it. */
+const deprecatedGraphic = {
+	name: "deprecated-graphic",
+	check: (index) => {
+		const out = [];
+		for (const site of index.elements.values()) {
+			if (site.kind !== "graphic") continue;
+			const kind = site.props.get("kind")?.literal;
+			out.push({
+				rule: "deprecated-graphic",
+				severity: "warning",
+				message: `"${site.id}": <Graphic${typeof kind === "string" ? ` kind="${kind}"` : ""}> is deprecated and will be removed; draw it with <Motion>, <Three> or a <Layer> (see the examples)`,
+				range: site.openingTag,
+				id: site.id
+			});
+		}
+		return out;
+	}
+};
 // src/source/lint/rules/not-rendered.ts
 /** Values that ask for nothing, so writing them is never reported. */
 const OFF = [
@@ -1431,20 +1587,21 @@ const themeLiterals = {
 		return out;
 	}
 };
-/** Fonts no renderer ships: the export sets them in Inter unless the fonts are passed to it. */
+/** Fonts no renderer ships and the file does not declare (`font()`, `googleFont()`): the export sets them in Inter. */
 const fontAvailable = {
 	name: "font-available",
 	check: (index) => {
 		const theme = fileTheme(index) ?? resolveTheme(void 0);
+		const listed = declaredFamilies(index);
 		const out = [];
 		const seen = /* @__PURE__ */ new Set();
 		const check = (family, site, prop, name, path) => {
-			if (isBundledFont(family) || seen.has(`${site.id}.${path}`)) return;
+			if (isBundledFont(family) || listed.has(family) || seen.has(`${site.id}.${path}`)) return;
 			seen.add(`${site.id}.${path}`);
 			out.push({
 				rule: "font-available",
 				severity: "warning",
-				message: `"${site.id}.${path}" uses font "${family}", which is not bundled; the export sets it in Inter unless the font is passed to it`,
+				message: `"${site.id}.${path}" uses font "${family}", which is neither bundled nor declared with font() or googleFont(); the export sets it in Inter`,
 				range: [prop.range[0], prop.range[1]],
 				id: site.id,
 				prop: name
@@ -1710,7 +1867,9 @@ const rules = [
 	themeRefs,
 	themeLiterals,
 	fontAvailable,
+	declaration,
 	graphicProps,
+	deprecatedGraphic,
 	notRendered
 ];
 /** The composition's first track in document order that lays out as a sequence and is not hidden: the one under everything else. */
@@ -1761,8 +1920,13 @@ function loadModule(source, options = {}) {
 		if (!(name in offered)) throw new Error(`The file imports “${name}”, which this host does not offer (it offers ${Object.keys(offered).join(", ")}).`);
 		return offered[name];
 	};
-	new Function("require", "exports", "module", code)(require, module.exports, module);
+	let shaders = [];
+	const fonts = collectFonts(() => {
+		shaders = collectShaders(() => new Function("require", "exports", "module", code)(require, module.exports, module));
+	});
 	if (typeof module.exports.default !== "function") throw new Error("The file has no default export (the video).");
+	Object.defineProperty(module.exports, MODULE_FONTS, { value: fonts });
+	Object.defineProperty(module.exports, MODULE_SHADERS, { value: shaders });
 	return module.exports;
 }
 export { ALLOWED_IMPORTS, applyEdits, bake, buildSourceIndex, elementName, fold, foldToSource, indentOf, lineRange, lint, literalOf, loadModule, parseSource, printElement, printLiteral, printProp, rangeOf, rules };