@clipkit/editor-core 1.0.0

package/dist/node-graph.js

@@ -0,0 +1,123 @@
+// Node-graph derivation — a LENS over the Source (never serialized).
+//
+// A Clipkit Source is a tree painted in track/z order, where each element
+// carries an ordered `effects[]` chain. A node graph is just a different
+// drawing of that same tree: element → node, effects → a chain of nodes,
+// `group` → a merge node fed by its children, and the whole composite
+// flows into one Output node. Everything here is DERIVED from the Source
+// (the lens rule), so the editor can show/edit it without any protocol
+// change. UI-free on purpose: colors/icons live in the renderer.
+import { elementLabel } from './timeline-utils.js';
+export const NODE_W = 152;
+export const NODE_H = 38;
+const COL_W = 196;
+const ROW_GAP = 58;
+const MARGIN = 28;
+export const OUTPUT_ID = '__output__';
+/**
+ * Derive the node graph for a Source. Deterministic: same Source → same
+ * layout. The graph is an anti-arborescence (every node has exactly one
+ * downstream edge, all flowing into Output), so ranks and a tidy layered
+ * layout fall out of a single longest-path pass.
+ */
+export function buildNodeGraph(source) {
+    const b = { nodes: new Map(), edges: [], out: new Map() };
+    b.nodes.set(OUTPUT_ID, {
+        id: OUTPUT_ID, kind: 'output', label: 'Output', rank: 0,
+        x: 0, y: 0, w: NODE_W, h: NODE_H,
+    });
+    let counter = 0;
+    const elements = Array.isArray(source.elements) ? source.elements : [];
+    // Higher track / z paints later (in front) → list it nearer the top so
+    // the vertical stack reads back-to-front top-down, matching the layers tree.
+    const ordered = [...elements];
+    for (const el of ordered)
+        addElement(el, OUTPUT_ID);
+    function addElement(el, consumer) {
+        const key = `el:${el.id ?? `_${counter++}`}`;
+        b.nodes.set(key, {
+            id: key, kind: 'element', elType: el.type,
+            label: elementLabel(el), elementId: el.id, rank: 0,
+            x: 0, y: 0, w: NODE_W, h: NODE_H,
+        });
+        // Effects chain hangs to the RIGHT of the element, between it and its
+        // consumer: element → fx0 → fx1 → … → consumer.
+        let tail = key;
+        const fx = el.effects;
+        if (Array.isArray(fx)) {
+            fx.forEach((e, i) => {
+                const fid = `fx:${key}:${i}`;
+                b.nodes.set(fid, {
+                    id: fid, kind: 'effect', effectType: e?.type ?? 'effect',
+                    label: e?.type ?? 'effect', elementId: el.id, rank: 0,
+                    x: 0, y: 0, w: NODE_W, h: NODE_H,
+                });
+                link(tail, fid);
+                tail = fid;
+            });
+        }
+        link(tail, consumer);
+        // Group children composite INTO the group node (before its effects).
+        if (el.type === 'group') {
+            const kids = el.elements;
+            if (Array.isArray(kids))
+                for (const child of kids)
+                    addElement(child, key);
+        }
+    }
+    function link(from, to) {
+        b.edges.push({ from, to });
+        b.out.set(from, to);
+    }
+    layout(b);
+    const nodes = [...b.nodes.values()];
+    const width = Math.max(...nodes.map((n) => n.x + n.w), COL_W) + MARGIN;
+    const height = Math.max(...nodes.map((n) => n.y + n.h), ROW_GAP) + MARGIN;
+    return { nodes, edges: b.edges, width, height };
+}
+/** Longest-path ranks + a tidy per-column vertical order (DFS pre-order). */
+function layout(b) {
+    const rankMemo = new Map();
+    const rankOf = (id) => {
+        if (rankMemo.has(id))
+            return rankMemo.get(id);
+        const t = b.out.get(id);
+        const r = t === undefined ? 0 : 1 + rankOf(t);
+        rankMemo.set(id, r);
+        return r;
+    };
+    for (const n of b.nodes.values())
+        n.rank = rankOf(n.id);
+    const maxRank = Math.max(0, ...[...b.nodes.values()].map((n) => n.rank));
+    // Incoming adjacency, in insertion order, for a stable DFS.
+    const incoming = new Map();
+    for (const e of b.edges) {
+        const list = incoming.get(e.to) ?? [];
+        list.push(e.from);
+        incoming.set(e.to, list);
+    }
+    // DFS from Output over incoming edges assigns a vertical order index so
+    // siblings cluster and subtrees stay contiguous.
+    const order = new Map();
+    let k = 0;
+    const dfs = (id) => {
+        order.set(id, k++);
+        for (const src of incoming.get(id) ?? [])
+            dfs(src);
+    };
+    dfs(OUTPUT_ID);
+    const perRank = new Map();
+    for (const n of b.nodes.values()) {
+        const list = perRank.get(n.rank) ?? [];
+        list.push(n);
+        perRank.set(n.rank, list);
+    }
+    for (const [rank, list] of perRank) {
+        list.sort((a, c) => (order.get(a.id) ?? 0) - (order.get(c.id) ?? 0));
+        list.forEach((n, i) => {
+            n.x = (maxRank - rank) * COL_W + MARGIN;
+            n.y = i * ROW_GAP + MARGIN;
+        });
+    }
+}
+//# sourceMappingURL=node-graph.js.map

package/dist/node-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-graph.js","sourceRoot":"","sources":["../src/node-graph.ts"],"names":[],"mappings":"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"}

package/dist/registry/build.d.ts

@@ -0,0 +1,3 @@
+import type { EditorRegistry } from './types.js';
+export declare function buildEditorRegistry(): EditorRegistry;
+//# sourceMappingURL=build.d.ts.map

package/dist/registry/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/registry/build.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAEV,cAAc,EAIf,MAAM,YAAY,CAAC;AAuEpB,wBAAgB,mBAAmB,IAAI,cAAc,CAsBpD"}

package/dist/registry/build.js

@@ -0,0 +1,84 @@
+// buildEditorRegistry — runs the derive → override pipeline over the
+// protocol's exported zod schemas and returns the resolved registry
+// every inspector renders from (EDITORS-PLAN D2).
+import { animationSchema, audioElementSchema, captionElementSchema, effectSchema, groupElementSchema, imageElementSchema, particlesElementSchema, shapeElementSchema, sourceSchema, textElementSchema, videoElementSchema, } from '@clipkit/protocol';
+import { deriveScope, unwrap } from './derive.js';
+import { BASE_FIELD_OVERRIDES, COMPOSITES, FIELD_OVERRIDES, } from './overrides.js';
+const ELEMENT_SCHEMAS = {
+    video: videoElementSchema,
+    image: imageElementSchema,
+    text: textElementSchema,
+    shape: shapeElementSchema,
+    audio: audioElementSchema,
+    group: groupElementSchema,
+    caption: captionElementSchema,
+    particles: particlesElementSchema,
+};
+function applyOverrides(fields, ...layers) {
+    return fields.map((f) => {
+        let merged = f;
+        for (const layer of layers) {
+            const o = layer?.[f.path];
+            if (!o)
+                continue;
+            merged = { ...merged, ...o, path: f.path, origin: 'override' };
+        }
+        return merged;
+    });
+}
+function resolveScope(scope, schema, opts = {}) {
+    const derived = deriveScope(scope, schema, opts.skip);
+    const fields = applyOverrides(derived, ...(opts.overrides ?? []));
+    const composites = opts.composites ?? [];
+    const claimed = new Set(composites.flatMap((c) => c.claims));
+    return {
+        scope,
+        // Composite claims beat field specs — claimed fields leave the
+        // flat list (their values are edited through the widget).
+        fields: fields.filter((f) => !claimed.has(f.path)),
+        composites,
+    };
+}
+/** Effect scopes from the discriminated union: one per `type` literal. */
+function effectScopes() {
+    const out = {};
+    const def = unwrap(effectSchema)._def;
+    for (const option of def.options ?? []) {
+        const shape = unwrap(option)._def.shape?.();
+        const typeLiteral = shape?.type
+            ? unwrap(shape.type)._def.value
+            : undefined;
+        if (!typeLiteral)
+            continue;
+        const scope = `effects.${typeLiteral}`;
+        out[typeLiteral] = resolveScope(scope, option, {
+            skip: new Set(['type']),
+            overrides: [FIELD_OVERRIDES[scope]],
+        });
+    }
+    return out;
+}
+export function buildEditorRegistry() {
+    const elements = {};
+    for (const [type, schema] of Object.entries(ELEMENT_SCHEMAS)) {
+        elements[type] = resolveScope(type, schema, {
+            skip: new Set(['type']),
+            overrides: [BASE_FIELD_OVERRIDES, FIELD_OVERRIDES[type]],
+            composites: [...(COMPOSITES.__element__ ?? []), ...(COMPOSITES[type] ?? [])],
+        });
+    }
+    return {
+        source: resolveScope('source', sourceSchema, {
+            skip: new Set(['elements']),
+            overrides: [FIELD_OVERRIDES.source],
+            composites: COMPOSITES.source ?? [],
+        }),
+        elements,
+        effects: effectScopes(),
+        animation: resolveScope('animation', animationSchema, {
+            skip: new Set(['type']),
+            overrides: [FIELD_OVERRIDES.animation],
+        }),
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/registry/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/registry/build.ts"],"names":[],"mappings":"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"}

package/dist/registry/configuration.d.ts

@@ -0,0 +1,51 @@
+import type { ToolId } from '../types.js';
+import type { EditorRegistry, ScopeRegistry } from './types.js';
+export interface EditorViewsConfiguration {
+    timeline: boolean;
+    /** Per-audio-track meters + master rail (advanced timeline). */
+    mixer: boolean;
+    /** Layers / element tree panel. */
+    layers: boolean;
+    /** Asset bin panel. */
+    assets: boolean;
+    /** Dockable bidirectional JSON pane. */
+    json: boolean;
+    /** Keyframe lanes under expanded clips. */
+    keyframeLanes: boolean;
+    /** Curve (graph) editor drawer. */
+    curveEditor: boolean;
+}
+export interface EditorConfiguration {
+    id: string;
+    views: EditorViewsConfiguration;
+    /** Dock tools, in order. */
+    dock: readonly ToolId[];
+    /**
+     * Knob exposure over the registry: 'all', or an allowlist of
+     * section ids and/or `scope.path` field ids. Composites are exposed
+     * when their section is allowed or any claimed field is listed.
+     */
+    knobs: 'all' | {
+        sections?: readonly string[];
+        fields?: readonly string[];
+    };
+}
+export declare const ADVANCED_CONFIGURATION: EditorConfiguration;
+/** Mirrors what today's hand-coded basic panels expose — the curated
+ * consumer surface. (The basic shell adopts the registry renderer
+ * under this configuration in a later phase.) */
+export declare const BASIC_CONFIGURATION: EditorConfiguration;
+/** Is a knob (field spec or composite) exposed under a configuration? */
+export declare function isKnobExposed(config: EditorConfiguration, scope: string, knob: {
+    path?: string;
+    section: string;
+    claims?: readonly string[];
+}): boolean;
+/** The scope's knobs filtered + sorted for one configuration. */
+export declare function exposedKnobs(config: EditorConfiguration, registry: ScopeRegistry): {
+    fields: ScopeRegistry['fields'];
+    composites: ScopeRegistry['composites'];
+};
+/** Convenience: every scope of the registry filtered by a configuration. */
+export declare function configurationView(config: EditorConfiguration, registry: EditorRegistry): Record<string, ReturnType<typeof exposedKnobs>>;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/registry/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/registry/configuration.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,wBAAwB,CAAC;IAChC,4BAA4B;IAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,KAAK,EACD,KAAK,GACL;QACE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5B,CAAC;CACP;AAED,eAAO,MAAM,sBAAsB,EAAE,mBAapC,CAAC;AAEF;;iDAEiD;AACjD,eAAO,MAAM,mBAAmB,EAAE,mBA8BjC,CAAC;AAEF,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACnE,OAAO,CAOT;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,aAAa,GACtB;IAAE,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CAAE,CAW9E;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,cAAc,GACvB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAUjD"}

package/dist/registry/configuration.js

@@ -0,0 +1,92 @@
+// EditorConfiguration (EDITORS-PLAN D2 layer 3, ruled by Ian) — a
+// declarative object that says what an editor instance IS: which
+// views are mounted, which dock tools exist, which knobs the
+// inspector exposes. The basic and advanced editors are PRESETS of
+// the same machine; embedders fork a configuration, not components.
+export const ADVANCED_CONFIGURATION = {
+    id: 'advanced',
+    views: {
+        timeline: true,
+        mixer: true,
+        layers: true,
+        assets: true,
+        json: true,
+        keyframeLanes: true,
+        curveEditor: true,
+    },
+    dock: ['text', 'shape', 'image', 'video', 'audio', 'caption'],
+    knobs: 'all',
+};
+/** Mirrors what today's hand-coded basic panels expose — the curated
+ * consumer surface. (The basic shell adopts the registry renderer
+ * under this configuration in a later phase.) */
+export const BASIC_CONFIGURATION = {
+    id: 'basic',
+    views: {
+        timeline: true,
+        mixer: false,
+        layers: false,
+        assets: false,
+        json: true,
+        keyframeLanes: false,
+        curveEditor: false,
+    },
+    dock: ['text', 'shape', 'image', 'video', 'audio', 'caption'],
+    knobs: {
+        sections: ['identity', 'timing', 'transform', 'appearance'],
+        fields: [
+            'text.text', 'text.font_family', 'text.font_size', 'text.font_weight',
+            'text.line_height', 'text.letter_spacing', 'text.text_align',
+            'text.vertical_align', 'text.fill_color', 'text.stroke_color',
+            'text.stroke_width',
+            'shape.shape', 'shape.fill_color', 'shape.stroke_color',
+            'shape.stroke_width', 'shape.border_radius',
+            'image.source', 'image.fit', 'image.brightness', 'image.contrast',
+            'image.saturation', 'image.blur_radius',
+            'video.source', 'video.volume', 'video.playback_rate', 'video.loop',
+            'video.fit',
+            'audio.source', 'audio.volume', 'audio.loop',
+            'caption.words', 'caption.style', 'caption.font_family',
+            'caption.font_size', 'caption.fill_color', 'caption.highlight_color',
+        ],
+    },
+};
+/** Is a knob (field spec or composite) exposed under a configuration? */
+export function isKnobExposed(config, scope, knob) {
+    if (config.knobs === 'all')
+        return true;
+    const { sections = [], fields = [] } = config.knobs;
+    if (sections.includes(knob.section))
+        return true;
+    if (knob.path && fields.includes(`${scope}.${knob.path}`))
+        return true;
+    if (knob.claims?.some((c) => fields.includes(`${scope}.${c}`)))
+        return true;
+    return false;
+}
+/** The scope's knobs filtered + sorted for one configuration. */
+export function exposedKnobs(config, registry) {
+    const bySection = (a, b) => a.section === b.section ? a.order - b.order : a.section.localeCompare(b.section);
+    return {
+        fields: registry.fields
+            .filter((f) => isKnobExposed(config, registry.scope, f))
+            .sort(bySection),
+        composites: registry.composites
+            .filter((c) => isKnobExposed(config, registry.scope, c))
+            .sort(bySection),
+    };
+}
+/** Convenience: every scope of the registry filtered by a configuration. */
+export function configurationView(config, registry) {
+    const out = {
+        source: exposedKnobs(config, registry.source),
+        animation: exposedKnobs(config, registry.animation),
+    };
+    for (const [k, v] of Object.entries(registry.elements))
+        out[k] = exposedKnobs(config, v);
+    for (const [k, v] of Object.entries(registry.effects)) {
+        out[`effects.${k}`] = exposedKnobs(config, v);
+    }
+    return out;
+}
+//# sourceMappingURL=configuration.js.map

package/dist/registry/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/registry/configuration.ts"],"names":[],"mappings":"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"}

package/dist/registry/derive.d.ts

@@ -0,0 +1,30 @@
+import type { FieldSpec } from './types.js';
+interface ZodDefLike {
+    typeName?: string;
+    innerType?: ZodLike;
+    schema?: ZodLike;
+    type?: ZodLike;
+    items?: ZodLike[];
+    options?: ZodLike[] | Map<string, ZodLike>;
+    values?: string[];
+    value?: unknown;
+    shape?: () => Record<string, ZodLike>;
+    checks?: Array<{
+        kind: string;
+        value?: number;
+    }>;
+}
+export interface ZodLike {
+    _def: ZodDefLike;
+}
+/** Unwrap optional/default/nullable/effects/readonly wrappers. */
+export declare function unwrap(t: ZodLike): ZodLike;
+/** Object shape of a (possibly wrapped) ZodObject, or null. */
+export declare function shapeOf(t: ZodLike): Record<string, ZodLike> | null;
+/**
+ * Derive the default knob set for one object schema. `skip` drops
+ * structural keys a scope handles elsewhere (e.g. element `type`).
+ */
+export declare function deriveScope(scope: string, schema: ZodLike, skip?: ReadonlySet<string>): FieldSpec[];
+export {};
+//# sourceMappingURL=derive.d.ts.map

package/dist/registry/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/registry/derive.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAMD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAoB1C;AAMD,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKlE;AAwJD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,SAAS,EAAE,CAsBb"}

package/dist/registry/derive.js

@@ -0,0 +1,212 @@
+// The deriver — walks the protocol's zod schemas and produces a
+// default FieldSpec for EVERY field, so the inspector grows with the
+// protocol automatically (EDITORS-PLAN D2 layer 1). Recognition is
+// STRUCTURAL (zod _def duck-typing — no zod dependency, no version
+// coupling) plus name heuristics for semantics the schema can't carry
+// (colors, urls, angles). Anything unrecognized falls back to 'json'
+// and is flagged via origin: 'derived' + note for the polish triage.
+function defOf(t) {
+    return t._def ?? {};
+}
+/** Unwrap optional/default/nullable/effects/readonly wrappers. */
+export function unwrap(t) {
+    let cur = t;
+    for (let i = 0; i < 10; i++) {
+        const def = defOf(cur);
+        const name = def.typeName;
+        if (name === 'ZodOptional' ||
+            name === 'ZodDefault' ||
+            name === 'ZodNullable' ||
+            name === 'ZodReadonly' ||
+            name === 'ZodBranded') {
+            cur = def.innerType;
+        }
+        else if (name === 'ZodEffects') {
+            cur = def.schema;
+        }
+        else {
+            return cur;
+        }
+    }
+    return cur;
+}
+function typeName(t) {
+    return defOf(unwrap(t)).typeName ?? 'unknown';
+}
+/** Object shape of a (possibly wrapped) ZodObject, or null. */
+export function shapeOf(t) {
+    const u = unwrap(t);
+    const def = defOf(u);
+    if (def.typeName !== 'ZodObject' || typeof def.shape !== 'function')
+        return null;
+    return def.shape();
+}
+function unionMembers(t) {
+    const def = defOf(unwrap(t));
+    if (def.typeName !== 'ZodUnion')
+        return [];
+    return def.options ?? [];
+}
+/** An array whose element is an object with `time` and `value` keys —
+ * structurally, a Keyframe[]. */
+function isKeyframeArray(t) {
+    const def = defOf(unwrap(t));
+    if (def.typeName !== 'ZodArray')
+        return false;
+    const el = shapeOf(def.type);
+    return el !== null && 'time' in el && 'value' in el;
+}
+function numberBounds(t) {
+    const def = defOf(unwrap(t));
+    const out = {};
+    for (const c of def.checks ?? []) {
+        if (c.kind === 'min' && typeof c.value === 'number')
+            out.min = c.value;
+        if (c.kind === 'max' && typeof c.value === 'number')
+            out.max = c.value;
+    }
+    return out;
+}
+// ── Name heuristics ─────────────────────────────────────────────────
+function looksLikeColor(path) {
+    return path === 'color' || path === 'tint' || path.endsWith('_color');
+}
+function looksLikeUrl(path) {
+    return path === 'source' || path === 'src';
+}
+function looksLikeAngle(path) {
+    // (`direction` on particles is also degrees but reads better as a
+    // plain number — override territory, not a heuristic.)
+    return path === 'angle' || path.includes('rotation') || path.endsWith('_skew');
+}
+// ── Default sections for the shared BaseElement fields ──────────────
+const SECTION_BY_FIELD = {
+    id: 'identity', name: 'identity', layer: 'identity',
+    time: 'timing', duration: 'timing',
+    // visible gates rendering (opacity's hard on/off cousin), not WHEN
+    // the element plays — re-ruled into appearance by Ian 2026-06-11.
+    visible: 'appearance',
+    x: 'transform', y: 'transform', width: 'transform', height: 'transform',
+    aspect_ratio: 'transform', x_anchor: 'transform', y_anchor: 'transform',
+    rotation: 'transform', z_rotation: 'transform', x_rotation: 'transform',
+    y_rotation: 'transform', z: 'transform', scale: 'transform',
+    x_scale: 'transform', y_scale: 'transform', x_skew: 'transform',
+    y_skew: 'transform',
+    opacity: 'appearance', blend_mode: 'appearance',
+    blur_radius: 'filters', brightness: 'filters', contrast: 'filters',
+    saturation: 'filters', hue_rotate: 'filters',
+    effects: 'effects', animations: 'animations',
+    keyframe_animations: 'keyframes',
+};
+function labelOf(path) {
+    const words = path.split('_');
+    return words
+        .map((w, i) => (i === 0 ? w.charAt(0).toUpperCase() + w.slice(1) : w))
+        .join(' ');
+}
+function classify(path, t) {
+    const u = unwrap(t);
+    const name = typeName(u);
+    if (name === 'ZodNumber') {
+        const bounds = numberBounds(u);
+        if (looksLikeAngle(path))
+            return { control: 'angle', animatable: false, ...bounds };
+        return { control: 'number', animatable: false, ...bounds };
+    }
+    if (name === 'ZodString') {
+        if (looksLikeColor(path))
+            return { control: 'color', animatable: false };
+        if (looksLikeUrl(path))
+            return { control: 'url', animatable: false };
+        return { control: 'text', animatable: false };
+    }
+    if (name === 'ZodBoolean')
+        return { control: 'toggle', animatable: false };
+    if (name === 'ZodEnum') {
+        const values = defOf(u).values ?? [];
+        return { control: 'select', animatable: false, options: [...values] };
+    }
+    if (name === 'ZodArray') {
+        if (isKeyframeArray(u))
+            return { control: 'keyframes', animatable: true };
+        return { control: 'list', animatable: false, note: 'derived list fallback' };
+    }
+    if (name === 'ZodUnion') {
+        const members = unionMembers(u);
+        const kinds = new Set(members.map((m) => typeName(m)));
+        const hasKeyframes = members.some((m) => isKeyframeArray(m));
+        const numberMember = members.find((m) => typeName(m) === 'ZodNumber');
+        const bounds = numberMember ? numberBounds(numberMember) : {};
+        // number | Keyframe[]  (effect params, volume, …)
+        if (kinds.has('ZodNumber') && hasKeyframes && !kinds.has('ZodString')) {
+            const base = looksLikeAngle(path)
+                ? { control: 'angle' }
+                : { control: 'number' };
+            return { ...base, animatable: true, ...bounds };
+        }
+        // number | string (| Keyframe[])  — length units
+        if (kinds.has('ZodNumber') && kinds.has('ZodString')) {
+            return { control: 'length', animatable: hasKeyframes, ...bounds };
+        }
+        // string | string[]  (particles color palette)
+        if (kinds.has('ZodString') && kinds.has('ZodArray') && !hasKeyframes) {
+            if (looksLikeColor(path)) {
+                return { control: 'color', animatable: false, note: 'accepts an array (palette)' };
+            }
+        }
+        // boolean | literal(s)  (loop: boolean | 'ping-pong')
+        if (kinds.has('ZodBoolean') && kinds.has('ZodLiteral')) {
+            const literals = members
+                .filter((m) => typeName(m) === 'ZodLiteral')
+                .map((m) => String(defOf(unwrap(m)).value));
+            return { control: 'select', animatable: false, options: ['off', 'on', ...literals] };
+        }
+        // number | literal('auto'/'end') (duration)
+        if (kinds.has('ZodNumber') && kinds.has('ZodLiteral')) {
+            return { control: 'length', animatable: false, note: 'accepts keyword values' };
+        }
+        return { control: 'json', animatable: hasKeyframes, note: 'union fallback' };
+    }
+    if (name === 'ZodObject')
+        return { control: 'json', animatable: false, note: 'object fallback' };
+    if (name === 'ZodTuple')
+        return { control: 'json', animatable: false, note: 'tuple fallback' };
+    if (name === 'ZodDiscriminatedUnion') {
+        return { control: 'json', animatable: false, note: 'discriminated-union fallback' };
+    }
+    if (name === 'ZodRecord')
+        return { control: 'json', animatable: false, note: 'record fallback' };
+    if (name === 'ZodLiteral')
+        return { control: 'text', animatable: false, note: 'literal' };
+    return { control: 'json', animatable: false, note: `unrecognized (${name})` };
+}
+/**
+ * Derive the default knob set for one object schema. `skip` drops
+ * structural keys a scope handles elsewhere (e.g. element `type`).
+ */
+export function deriveScope(scope, schema, skip = new Set()) {
+    const shape = shapeOf(schema);
+    if (!shape)
+        return [];
+    const out = [];
+    for (const [path, fieldSchema] of Object.entries(shape)) {
+        if (skip.has(path))
+            continue;
+        const c = classify(path, fieldSchema);
+        out.push({
+            path,
+            control: c.control,
+            label: labelOf(path),
+            section: SECTION_BY_FIELD[path] ?? scope,
+            order: 1000,
+            min: c.min,
+            max: c.max,
+            options: c.options,
+            animatable: c.animatable,
+            origin: 'derived',
+            note: c.note,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=derive.js.map