@clipkit/editor 1.0.0

package/dist/frame/Section.js

@@ -0,0 +1,23 @@
+// Section — THE flat inspector primitive per design/refs/README.md:
+// a hairline-separated block with an uppercase micro-label header,
+// collapsible by clicking the header, optional `+`/action slot on the
+// right. No cards, no backgrounds — tight vertical rhythm.
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { cn } from './../lib/utils.js';
+export function Section({ title, action, defaultOpen = true, children, className, }) {
+    const [open, setOpen] = useState(defaultOpen);
+    return (_jsxs("div", { className: cn('border-b border-border', className), children: [_jsxs("div", { className: "flex items-center justify-between px-3 h-8 select-none", children: [_jsxs("button", { type: "button", className: "flex items-center gap-1.5 text-[11px] font-medium text-foreground/90 hover:text-foreground", onClick: () => setOpen((v) => !v), "aria-expanded": open, children: [_jsx("svg", { width: "7", height: "7", viewBox: "0 0 8 8", "aria-hidden": "true", className: cn('text-muted-foreground transition-transform', open ? 'rotate-90' : ''), children: _jsx("path", { d: "M2 1 L6 4 L2 7 Z", fill: "currentColor" }) }), title] }), action && _jsx("div", { className: "flex items-center gap-1", children: action })] }), open && children && _jsx("div", { className: "px-3 pb-2.5", children: children })] }));
+}
+/** A label-left / value-right row inside a Section.
+ *
+ * THE GRID RHYTHM (ruled by Ian 2026-06-11): every row is 32px — a
+ * 24px well + 8px breathing room. The label column is FIXED (64px,
+ * matching the reference HTML) and the value area is FLUID — controls
+ * stretch to fill it, so every well's left and right edges align
+ * panel-wide regardless of panel width. */
+export function FieldRow({ label, children, }) {
+    return (_jsxs("div", { className: "flex items-center gap-2 h-8", children: [_jsx("span", { className: "w-16 shrink-0 text-[11px] text-muted-foreground truncate", children: label }), _jsx("div", { className: "flex-1 flex items-center gap-2 min-w-0", children: children })] }));
+}
+//# sourceMappingURL=Section.js.map

package/dist/frame/Section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.js","sourceRoot":"","sources":["../../src/frame/Section.tsx"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mEAAmE;AACnE,sEAAsE;AACtE,2DAA2D;AAE3D,YAAY,CAAC;;AAEb,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAWvC,MAAM,UAAU,OAAO,CAAC,EACtB,KAAK,EACL,MAAM,EACN,WAAW,GAAG,IAAI,EAClB,QAAQ,EACR,SAAS,GACH;IACN,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9C,OAAO,CACL,eAAK,SAAS,EAAE,EAAE,CAAC,wBAAwB,EAAE,SAAS,CAAC,aACrD,eAAK,SAAS,EAAC,wDAAwD,aACrE,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,4FAA4F,EACtG,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,mBAClB,IAAI,aAEnB,cACE,KAAK,EAAC,GAAG,EACT,MAAM,EAAC,GAAG,EACV,OAAO,EAAC,SAAS,iBACL,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,4CAA4C,EAC5C,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CACxB,YAED,eAAM,CAAC,EAAC,kBAAkB,EAAC,IAAI,EAAC,cAAc,GAAG,GAC7C,EACL,KAAK,IACC,EACR,MAAM,IAAI,cAAK,SAAS,EAAC,yBAAyB,YAAE,MAAM,GAAO,IAC9D,EACL,IAAI,IAAI,QAAQ,IAAI,cAAK,SAAS,EAAC,aAAa,YAAE,QAAQ,GAAO,IAC9D,CACP,CAAC;AACJ,CAAC;AAED;;;;;;2CAM2C;AAC3C,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,CACL,eAAK,SAAS,EAAC,6BAA6B,aAC1C,eAAM,SAAS,EAAC,0DAA0D,YACvE,KAAK,GACD,EAEP,cAAK,SAAS,EAAC,wCAAwC,YAAE,QAAQ,GAAO,IACpE,CACP,CAAC;AACJ,CAAC"}

package/dist/frame/ZoomControl.d.ts

@@ -0,0 +1,9 @@
+export declare function ZoomControl({ readout, onZoomOut, onZoomIn, onFit, fitLabel, }: {
+    /** e.g. "54%" or "56px/s". Clicking it fits. */
+    readout: string;
+    onZoomOut: () => void;
+    onZoomIn: () => void;
+    onFit: () => void;
+    fitLabel?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ZoomControl.d.ts.map

package/dist/frame/ZoomControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZoomControl.d.ts","sourceRoot":"","sources":["../../src/frame/ZoomControl.tsx"],"names":[],"mappings":"AASA,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,EACL,QAAyB,GAC1B,EAAE;IACD,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,+BA8CA"}

package/dist/frame/ZoomControl.js

@@ -0,0 +1,15 @@
+// ZoomControl — the editor's one zoom cluster (stage corner + timeline
+// transport), styled to the Figma direction in design/refs: no card
+// pill, just quiet flat buttons with thin-stroke glyphs and a tabular
+// readout, hairline divider before fit. The readout doubles as a fit
+// button (the legacy affordance). Hosts that float it over content
+// (the stage) supply their own surface.
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ZoomControl({ readout, onZoomOut, onZoomIn, onFit, fitLabel = 'Fit to width', }) {
+    return (_jsxs("div", { className: "flex items-center text-muted-foreground select-none", children: [_jsx(ZoomButton, { label: "Zoom out", onClick: onZoomOut, children: _jsx("svg", { width: "14", height: "14", viewBox: "0 0 14 14", "aria-hidden": "true", children: _jsx("path", { d: "M3.5 7 H10.5", stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round" }) }) }), _jsx("button", { type: "button", className: "px-1 h-6 flex items-center whitespace-nowrap rounded-sm text-[11px] tabular-nums text-foreground/90 hover:text-foreground hover:bg-secondary transition-colors", onClick: onFit, title: fitLabel, children: readout }), _jsx(ZoomButton, { label: "Zoom in", onClick: onZoomIn, children: _jsx("svg", { width: "14", height: "14", viewBox: "0 0 14 14", "aria-hidden": "true", children: _jsx("path", { d: "M7 3.5 V10.5 M3.5 7 H10.5", stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round" }) }) }), _jsx("span", { className: "w-px h-3 bg-border mx-1", "aria-hidden": true }), _jsx(ZoomButton, { label: fitLabel, onClick: onFit, children: _jsx("svg", { width: "13", height: "13", viewBox: "0 0 14 14", "aria-hidden": "true", children: _jsx("path", { d: "M2 5 L2 2 L5 2 M9 2 L12 2 L12 5 M12 9 L12 12 L9 12 M5 12 L2 12 L2 9", fill: "none", stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round", strokeLinejoin: "round" }) }) })] }));
+}
+function ZoomButton({ label, onClick, children, }) {
+    return (_jsx("button", { type: "button", className: "w-6 h-6 grid place-items-center rounded-sm hover:text-foreground hover:bg-secondary transition-colors", onClick: onClick, title: label, "aria-label": label, children: children }));
+}
+//# sourceMappingURL=ZoomControl.js.map

package/dist/frame/ZoomControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZoomControl.js","sourceRoot":"","sources":["../../src/frame/ZoomControl.tsx"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,qEAAqE;AACrE,mEAAmE;AACnE,wCAAwC;AAExC,YAAY,CAAC;;AAEb,MAAM,UAAU,WAAW,CAAC,EAC1B,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,EACL,QAAQ,GAAG,cAAc,GAQ1B;IACC,OAAO,CACL,eAAK,SAAS,EAAC,qDAAqD,aAClE,KAAC,UAAU,IAAC,KAAK,EAAC,UAAU,EAAC,OAAO,EAAE,SAAS,YAC7C,cAAK,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,iBAAa,MAAM,YAChE,eACE,CAAC,EAAC,cAAc,EAChB,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,GACrB,GACE,GACK,EACb,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,gKAAgK,EAC1K,OAAO,EAAE,KAAK,EACd,KAAK,EAAE,QAAQ,YAEd,OAAO,GACD,EACT,KAAC,UAAU,IAAC,KAAK,EAAC,SAAS,EAAC,OAAO,EAAE,QAAQ,YAC3C,cAAK,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,iBAAa,MAAM,YAChE,eACE,CAAC,EAAC,2BAA2B,EAC7B,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,GACrB,GACE,GACK,EACb,eAAM,SAAS,EAAC,yBAAyB,wBAAe,EACxD,KAAC,UAAU,IAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,YACzC,cAAK,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,iBAAa,MAAM,YAChE,eACE,CAAC,EAAC,qEAAqE,EACvE,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,GACtB,GACE,GACK,IACT,CACP,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAClB,KAAK,EACL,OAAO,EACP,QAAQ,GAKT;IACC,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,uGAAuG,EACjH,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,gBACA,KAAK,YAEhB,QAAQ,GACF,CACV,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Editor } from './Editor.js';
+export { ExportDialog } from './ExportDialog.js';
+export type { EditorProps, ExportFormatOption, ExportRequest, ExportResolution, ExportQuality, } from './types.js';
+export { EDITOR_COMMANDS } from './commands.js';
+export type { EditorCommand } from './commands.js';
+export { Section, FieldRow } from './frame/Section.js';
+export { ADVANCED_CONFIGURATION, BASIC_CONFIGURATION, useEditor, useEditorStore, createLocalAssetStore, createMemoryAssetStore, } from '@clipkit/editor-core';
+export type { EditorConfiguration, EditorViewsConfiguration, AssetStore, ClipkitAsset, AssetKind, } from '@clipkit/editor-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,YAAY,EACZ,SAAS,GACV,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Public entry point for @clipkit/editor — the configurable editor.
+//
+//   import { Editor, BASIC_CONFIGURATION } from '@clipkit/editor';
+//   <Editor initialSource={source} configuration={BASIC_CONFIGURATION} />
+//
+// The data layer (store, hooks, registry, configurations) comes from
+// @clipkit/editor-core and is re-exported so embedders need one import.
+export { Editor } from './Editor.js';
+export { ExportDialog } from './ExportDialog.js';
+export { EDITOR_COMMANDS } from './commands.js';
+export { Section, FieldRow } from './frame/Section.js';
+export { ADVANCED_CONFIGURATION, BASIC_CONFIGURATION, useEditor, useEditorStore, createLocalAssetStore, createMemoryAssetStore, } from '@clipkit/editor-core';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,mEAAmE;AACnE,0EAA0E;AAC1E,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/lib/camera-gizmo.d.ts

@@ -0,0 +1,15 @@
+import type { Element, Source } from '@clipkit/protocol';
+import { projectElementQuad, unprojectToPlane, elementDepthZ, type Pt } from '@clipkit/runtime';
+export { projectElementQuad, unprojectToPlane, elementDepthZ, type Pt };
+/** True when the editor should use camera-projected gizmos: a camera is
+ *  present and the stage is in camera (not flat) view. */
+export declare function cameraGizmosActive(source: Source, stageView: string): boolean;
+/** Point-in-convex-quad test (quad corners in order). */
+export declare function pointInQuad(p: Pt, quad: readonly Pt[]): boolean;
+/**
+ * Camera-aware hit test: the front-most (nearest in camera depth) active,
+ * visual element whose PROJECTED quad contains the canvas-pixel point.
+ * Mirrors the runtime's depth ordering so clicking selects what's on top.
+ */
+export declare function cameraHitTest(source: Source, point: Pt, playhead: number, sourceDuration: number): Element | null;
+//# sourceMappingURL=camera-gizmo.d.ts.map

package/dist/lib/camera-gizmo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-gizmo.d.ts","sourceRoot":"","sources":["../../src/lib/camera-gizmo.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,KAAK,EAAE,EACR,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC;AAExE;0DAC0D;AAC1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAa/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,EAAE,EACT,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,GAAG,IAAI,CAehB"}

package/dist/lib/camera-gizmo.js

@@ -0,0 +1,57 @@
+// Camera-view gizmo helpers (CAMERA-PLAN item 6). Thin wrappers over the
+// runtime's render-consistent projection (`projectElementQuad` /
+// `unprojectToPlane`) so the editor's selection box, hit-testing, and
+// move drag line up exactly with what's drawn under the scene camera.
+//
+// All "canvas" points are in CANVAS pixels (the projected image space the
+// runtime renders into). The Stage maps canvas ⇄ screen with pan/zoom.
+import { projectElementQuad, unprojectToPlane, elementDepthZ, } from '@clipkit/runtime';
+import { isVisualElement, isElementActive } from '@clipkit/editor-core';
+export { projectElementQuad, unprojectToPlane, elementDepthZ };
+/** True when the editor should use camera-projected gizmos: a camera is
+ *  present and the stage is in camera (not flat) view. */
+export function cameraGizmosActive(source, stageView) {
+    return stageView === 'camera' && !!source.camera;
+}
+/** Point-in-convex-quad test (quad corners in order). */
+export function pointInQuad(p, quad) {
+    let sign = 0;
+    for (let i = 0; i < quad.length; i++) {
+        const a = quad[i];
+        const b = quad[(i + 1) % quad.length];
+        const cross = (b.x - a.x) * (p.y - a.y) - (b.y - a.y) * (p.x - a.x);
+        if (cross !== 0) {
+            const s = cross > 0 ? 1 : -1;
+            if (sign === 0)
+                sign = s;
+            else if (s !== sign)
+                return false;
+        }
+    }
+    return true;
+}
+/**
+ * Camera-aware hit test: the front-most (nearest in camera depth) active,
+ * visual element whose PROJECTED quad contains the canvas-pixel point.
+ * Mirrors the runtime's depth ordering so clicking selects what's on top.
+ */
+export function cameraHitTest(source, point, playhead, sourceDuration) {
+    let best = null;
+    let bestZ = -Infinity;
+    for (const el of source.elements) {
+        if (!isVisualElement(el))
+            continue;
+        if (!isElementActive(el, playhead, sourceDuration))
+            continue;
+        const quad = projectElementQuad(source, el, playhead);
+        if (!quad || !pointInQuad(point, quad))
+            continue;
+        const z = elementDepthZ(source, el, playhead);
+        if (z >= bestZ) {
+            bestZ = z;
+            best = el;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=camera-gizmo.js.map

package/dist/lib/camera-gizmo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-gizmo.js","sourceRoot":"","sources":["../../src/lib/camera-gizmo.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,iEAAiE;AACjE,sEAAsE;AACtE,sEAAsE;AACtE,EAAE;AACF,0EAA0E;AAC1E,uEAAuE;AAGvE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GAEd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAW,CAAC;AAExE;0DAC0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,SAAiB;IAClE,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;AACnD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,CAAK,EAAE,IAAmB;IACpD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAE,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,IAAI,KAAK,CAAC;gBAAE,IAAI,GAAG,CAAC,CAAC;iBACpB,IAAI,CAAC,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,KAAS,EACT,QAAgB,EAChB,cAAsB;IAEtB,IAAI,IAAI,GAAmB,IAAI,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,QAAQ,CAAC;IACtB,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,cAAc,CAAC;YAAE,SAAS;QAC7D,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,SAAS;QACjD,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YACf,KAAK,GAAG,CAAC,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/camera-tool.d.ts

@@ -0,0 +1,43 @@
+import type { Camera } from '@clipkit/protocol';
+import { resolveCameraPose, type CameraPose } from '@clipkit/runtime';
+export { resolveCameraPose, type CameraPose };
+type PoseField = 'perspective' | 'x' | 'y' | 'z' | 'x_rotation' | 'y_rotation' | 'z_rotation';
+/**
+ * Set a camera pose field to `value` at `time`. Animated field → replace
+ * the keyframe at the playhead (or insert one, keeping the curve sorted);
+ * static field → set the scalar. Returns a new Camera.
+ */
+export declare function setCameraFieldAt(camera: Camera, field: PoseField, value: number, time: number): Camera;
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Orientation (Euler degrees) that aims the camera at `target` from
+ * `eye`, about `origin`. Derived so the camera's rotation maps +z onto
+ * the target direction `u = target − origin − eye` (verified: the target
+ * then projects to screen center). Roll (z_rotation) stays 0.
+ */
+export declare function lookAtAngles(target: Vec3, origin: {
+    x: number;
+    y: number;
+}, eye: Vec3): {
+    x_rotation: number;
+    y_rotation: number;
+};
+/** Set the camera's orientation to look at `target` from `eye` (keyframe-
+ *  aware at `time`). Used by the one-shot "Look at" and the lock track. */
+export declare function cameraLookAt(camera: Camera, eye: Vec3, target: Vec3, origin: {
+    x: number;
+    y: number;
+}, time: number): Camera;
+export type CameraDragMode = 'orbit' | 'dolly' | 'pan';
+/**
+ * Apply one drag delta to the camera from a captured base pose. `dxRot`/
+ * `dyRot` are raw screen px (orbit, in degrees via sensitivity); `dxSrc`/
+ * `dySrc` are source px (dolly/pan). Only the fields the mode touches are
+ * written, so unrelated curves are never clobbered.
+ */
+export declare function cameraAfterDrag(camera: Camera, base: CameraPose, mode: CameraDragMode, dxPx: number, dyPx: number, dxSrc: number, dySrc: number, time: number): Camera;
+//# sourceMappingURL=camera-tool.d.ts.map

package/dist/lib/camera-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-tool.d.ts","sourceRoot":"","sources":["../../src/lib/camera-tool.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,CAAC;AAI9C,KAAK,SAAS,GAAG,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAaR;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,GAAG,EAAE,IAAI,GACR;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAS5C;AAED;2EAC2E;AAC3E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,IAAI,EAAE,MAAM,GACX,MAAM,CAKR;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAMvD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAcR"}

package/dist/lib/camera-tool.js

@@ -0,0 +1,80 @@
+// Stage camera tools (CAMERA-PLAN item 7). Keyframe-aware writes to the
+// scene camera's pose: when a field is animated (inline Keyframe[]) the
+// edit sets/inserts the keyframe at the playhead (auto-keyframe — build a
+// fly-through by posing at different times); when it's static it edits
+// the scalar. Pure data; the Stage drives the drag and persists via
+// patchSource.
+import { resolveCameraPose } from '@clipkit/runtime';
+export { resolveCameraPose };
+const KF_EPS = 1e-3;
+/**
+ * Set a camera pose field to `value` at `time`. Animated field → replace
+ * the keyframe at the playhead (or insert one, keeping the curve sorted);
+ * static field → set the scalar. Returns a new Camera.
+ */
+export function setCameraFieldAt(camera, field, value, time) {
+    const cur = camera[field];
+    if (Array.isArray(cur)) {
+        const arr = cur.map((k) => ({ ...k }));
+        const idx = arr.findIndex((k) => Math.abs(Number(k.time ?? 0) - time) < KF_EPS);
+        if (idx >= 0)
+            arr[idx] = { ...arr[idx], value };
+        else {
+            arr.push({ time, value });
+            arr.sort((a, b) => Number(a.time ?? 0) - Number(b.time ?? 0));
+        }
+        return { ...camera, [field]: arr };
+    }
+    return { ...camera, [field]: value };
+}
+/**
+ * Orientation (Euler degrees) that aims the camera at `target` from
+ * `eye`, about `origin`. Derived so the camera's rotation maps +z onto
+ * the target direction `u = target − origin − eye` (verified: the target
+ * then projects to screen center). Roll (z_rotation) stays 0.
+ */
+export function lookAtAngles(target, origin, eye) {
+    const ux = target.x - origin.x - eye.x;
+    const uy = target.y - origin.y - eye.y;
+    const uz = target.z - eye.z;
+    const DEG = 180 / Math.PI;
+    return {
+        y_rotation: Math.atan2(ux, uz) * DEG,
+        x_rotation: Math.atan2(-uy, Math.hypot(ux, uz)) * DEG,
+    };
+}
+/** Set the camera's orientation to look at `target` from `eye` (keyframe-
+ *  aware at `time`). Used by the one-shot "Look at" and the lock track. */
+export function cameraLookAt(camera, eye, target, origin, time) {
+    const a = lookAtAngles(target, origin, eye);
+    let c = setCameraFieldAt(camera, 'y_rotation', a.y_rotation, time);
+    c = setCameraFieldAt(c, 'x_rotation', a.x_rotation, time);
+    return c;
+}
+/** Drag sensitivities. Orbit is degrees/px; dolly/pan are in source px
+ *  (the caller pre-divides screen delta by zoom). */
+const ORBIT_DEG_PER_PX = 0.3;
+/**
+ * Apply one drag delta to the camera from a captured base pose. `dxRot`/
+ * `dyRot` are raw screen px (orbit, in degrees via sensitivity); `dxSrc`/
+ * `dySrc` are source px (dolly/pan). Only the fields the mode touches are
+ * written, so unrelated curves are never clobbered.
+ */
+export function cameraAfterDrag(camera, base, mode, dxPx, dyPx, dxSrc, dySrc, time) {
+    let c = camera;
+    if (mode === 'orbit') {
+        c = setCameraFieldAt(c, 'y_rotation', base.y_rotation + dxPx * ORBIT_DEG_PER_PX, time);
+        c = setCameraFieldAt(c, 'x_rotation', base.x_rotation - dyPx * ORBIT_DEG_PER_PX, time);
+    }
+    else if (mode === 'dolly') {
+        // Drag up = push in (z toward viewer increases).
+        c = setCameraFieldAt(c, 'z', base.z - dySrc, time);
+    }
+    else {
+        // Pan/truck: move the eye opposite the drag so content follows the cursor.
+        c = setCameraFieldAt(c, 'x', base.x - dxSrc, time);
+        c = setCameraFieldAt(c, 'y', base.y - dySrc, time);
+    }
+    return c;
+}
+//# sourceMappingURL=camera-tool.js.map

package/dist/lib/camera-tool.js.map

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

package/dist/lib/caption-segments.d.ts

@@ -0,0 +1,17 @@
+import type { CaptionWord, Element } from '@clipkit/protocol';
+import { type ToCaptionSegmentsOptions } from '@clipkit/speech-to-text/caption';
+/** The shared style fields of a caption, to clone onto each segment. */
+export declare function captionStyleTemplate(caption: Element): Record<string, unknown>;
+/** Build caption ELEMENTS from phrase segments. `baseTime` is added to each
+ *  segment's start (the media/caption start on the timeline). */
+export declare function buildSegmentCaptions(template: Record<string, unknown>, baseTime: number, segments: {
+    start: number;
+    words: CaptionWord[];
+}[]): Element[];
+/**
+ * Split ONE caption element into N phrase-sized caption segments (by words-per-
+ * segment / pauses / duration), each keeping the original's style. Returns the
+ * new caption elements (the caller replaces the original with these).
+ */
+export declare function splitCaptionIntoSegments(caption: Element, options?: ToCaptionSegmentsOptions): Element[];
+//# sourceMappingURL=caption-segments.d.ts.map

package/dist/lib/caption-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption-segments.d.ts","sourceRoot":"","sources":["../../src/lib/caption-segments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAgB,KAAK,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAW9F,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK9E;AAED;iEACiE;AACjE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,EAAE,GAClD,OAAO,EAAE,CAUX;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,EAAE,CAS5G"}

package/dist/lib/caption-segments.js

@@ -0,0 +1,50 @@
+// Caption segmentation helpers (editor side) — turn one caption's words, or a
+// transcript's segments, into N phrase-sized caption ELEMENTS sharing a style.
+// One caption element = one segment; this is how a long caption becomes many.
+import { segmentWords } from '@clipkit/speech-to-text/caption';
+// Style fields copied from the template caption onto every segment (everything
+// except the per-segment text/timing).
+const STYLE_KEYS = ['x', 'y', 'x_anchor', 'y_anchor', 'width', 'height', 'rotation', 'scale', 'opacity', 'font_family', 'font_size', 'font_weight', 'fill_color', 'text_align', 'style', 'highlight_color', 'line_height', 'letter_spacing', 'track'];
+const num = (v, d) => (typeof v === 'number' && Number.isFinite(v) ? v : d);
+const round3 = (n) => Math.round(n * 1000) / 1000;
+let segCounter = 0;
+const uid = () => `cap-${(segCounter++).toString(36)}-${Date.now().toString(36).slice(-4)}`;
+/** The shared style fields of a caption, to clone onto each segment. */
+export function captionStyleTemplate(caption) {
+    const t = {};
+    const rec = caption;
+    for (const k of STYLE_KEYS)
+        if (rec[k] !== undefined)
+            t[k] = rec[k];
+    return t;
+}
+/** Build caption ELEMENTS from phrase segments. `baseTime` is added to each
+ *  segment's start (the media/caption start on the timeline). */
+export function buildSegmentCaptions(template, baseTime, segments) {
+    return segments.map((seg) => ({
+        ...template,
+        id: uid(),
+        type: 'caption',
+        name: 'Captions',
+        time: round3(baseTime + seg.start),
+        duration: 'auto',
+        words: seg.words,
+    }));
+}
+/**
+ * Split ONE caption element into N phrase-sized caption segments (by words-per-
+ * segment / pauses / duration), each keeping the original's style. Returns the
+ * new caption elements (the caller replaces the original with these).
+ */
+export function splitCaptionIntoSegments(caption, options = {}) {
+    const words = (caption.words ?? []).filter((w) => w.text.trim().length > 0);
+    if (words.length === 0)
+        return [caption];
+    const groups = segmentWords(words, options);
+    const segments = groups.map((g) => {
+        const base = g[0].start;
+        return { start: base, words: g.map((w) => ({ text: w.text.trim(), start: Math.max(0, w.start - base), end: Math.max(0, w.end - base) })) };
+    });
+    return buildSegmentCaptions(captionStyleTemplate(caption), num(caption.time, 0), segments);
+}
+//# sourceMappingURL=caption-segments.js.map

package/dist/lib/caption-segments.js.map

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

package/dist/lib/group.d.ts

@@ -0,0 +1,12 @@
+import type { Element } from '@clipkit/protocol';
+export interface GroupResult {
+    elements: Element[];
+    groupId: string;
+}
+/**
+ * Wrap the top-level elements named by `ids` into a new group with id `newId`.
+ * Returns the new top-level elements array + the group's id, or null if fewer
+ * than two of the ids are top-level elements.
+ */
+export declare function groupElements(elements: readonly Element[], ids: readonly string[], newId: string): GroupResult | null;
+//# sourceMappingURL=group.d.ts.map

package/dist/lib/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../src/lib/group.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAK/D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA0CrH"}

package/dist/lib/group.js

@@ -0,0 +1,61 @@
+// Group — wrap the selected TOP-LEVEL elements into a new group element, the
+// inverse of ungroup (lib/ungroup.ts).
+//
+// The group takes identity spatial transform (children keep their absolute
+// coords, so the frame renders identically) and a time offset = the earliest
+// child's start, with each child's `time` made relative to it. The group's
+// `duration` spans the children when they all have numeric durations. Insertion
+// happens at the position of the first selected element.
+const numberOr = (v, d) => (typeof v === 'number' && Number.isFinite(v) ? v : d);
+const round3 = (n) => Math.round(n * 1000) / 1000;
+/**
+ * Wrap the top-level elements named by `ids` into a new group with id `newId`.
+ * Returns the new top-level elements array + the group's id, or null if fewer
+ * than two of the ids are top-level elements.
+ */
+export function groupElements(elements, ids, newId) {
+    const idSet = new Set(ids);
+    const indices = [];
+    elements.forEach((e, i) => {
+        if (typeof e.id === 'string' && idSet.has(e.id))
+            indices.push(i);
+    });
+    if (indices.length < 2)
+        return null;
+    const selected = indices.map((i) => elements[i]);
+    const groupTime = Math.min(...selected.map((e) => numberOr(e.time, 0)));
+    let maxEnd = 0;
+    let allNumericDuration = true;
+    const children = selected.map((e) => {
+        const rel = numberOr(e.time, 0) - groupTime;
+        const dur = e.duration;
+        if (typeof dur === 'number')
+            maxEnd = Math.max(maxEnd, rel + dur);
+        else
+            allNumericDuration = false;
+        return { ...e, time: round3(rel) };
+    });
+    const group = {
+        id: newId,
+        name: 'Group',
+        type: 'group',
+        time: round3(groupTime),
+        layer: numberOr(selected[0].layer, 1),
+        elements: children,
+    };
+    if (allNumericDuration && maxEnd > 0)
+        group.duration = round3(maxEnd);
+    const firstIdx = indices[0];
+    const out = [];
+    elements.forEach((e, i) => {
+        if (typeof e.id === 'string' && idSet.has(e.id)) {
+            if (i === firstIdx)
+                out.push(group);
+        }
+        else {
+            out.push(e);
+        }
+    });
+    return { elements: out, groupId: newId };
+}
+//# sourceMappingURL=group.js.map

package/dist/lib/group.js.map

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

package/dist/lib/keyframes.d.ts

@@ -0,0 +1,29 @@
+import type { Element, Keyframe, KeyframeAnimation } from '@clipkit/protocol';
+/** Find an element by id, descending into groups. */
+export declare function findElementById(elements: readonly Element[], id: string): Element | null;
+/** "On a keyframe" tolerance, seconds. */
+export declare const KF_EPS = 0.05;
+export declare const kfTime: (k: Keyframe) => number;
+/** Is there a keyframe within KF_EPS of this element-local time? */
+export declare function isOnKeyframe(anim: KeyframeAnimation, local: number): boolean;
+/**
+ * Sample the animation's value at an element-local time via the
+ * normative evaluator (scalars exact; arrays componentwise — position
+ * tangent curves are refined in the curve editor).
+ */
+export declare function sampleAnimation(anim: KeyframeAnimation, local: number): Keyframe['value'];
+/**
+ * Toggle a keyframe at an element-local time on animation `animIndex`.
+ * On a keyframe → splice it (removing the last keyframe removes the
+ * whole entry); otherwise → insert one sampled from the curve.
+ * Returns the next keyframe_animations array, or undefined when the
+ * last entry was removed (byte-clean documents).
+ */
+/**
+ * Write a VALUE into the keyframe at an element-local time: replaces
+ * the value when the playhead sits on a keyframe, otherwise inserts a
+ * new keyframe there (AE-style auto-key for animated properties).
+ */
+export declare function setKeyframeValueAt(anims: readonly KeyframeAnimation[], animIndex: number, local: number, value: Keyframe['value']): KeyframeAnimation[];
+export declare function toggleKeyframeAt(anims: readonly KeyframeAnimation[], animIndex: number, local: number): KeyframeAnimation[] | undefined;
+//# sourceMappingURL=keyframes.d.ts.map

package/dist/lib/keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/lib/keyframes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,qDAAqD;AACrD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,EAAE,EAAE,MAAM,GACT,OAAO,GAAG,IAAI,CAShB;AAED,0CAA0C;AAC1C,eAAO,MAAM,MAAM,OAAO,CAAC;AAE3B,eAAO,MAAM,MAAM,GAAI,GAAG,QAAQ,KAAG,MACkC,CAAC;AAIxE,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,OAAO,CAAC,CAoBnB;AAED;;;;;;GAMG;AACH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GACvB,iBAAiB,EAAE,CAWrB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,iBAAiB,EAAE,GAAG,SAAS,CAgBjC"}

package/dist/lib/keyframes.js

@@ -0,0 +1,92 @@
+// Shared keyframe-at-playhead logic (inspector diamond + timeline
+// lane rows). All edits are literal keyframe_animations writes;
+// insertion samples through the runtime's NORMATIVE applyEasing so a
+// new keyframe sits exactly on the existing curve.
+import { applyEasing } from '@clipkit/runtime';
+/** Find an element by id, descending into groups. */
+export function findElementById(elements, id) {
+    for (const el of elements) {
+        if (el.id === id)
+            return el;
+        if (el.type === 'group') {
+            const nested = findElementById(el.elements, id);
+            if (nested)
+                return nested;
+        }
+    }
+    return null;
+}
+/** "On a keyframe" tolerance, seconds. */
+export const KF_EPS = 0.05;
+export const kfTime = (k) => typeof k.time === 'number' ? k.time : parseFloat(String(k.time)) || 0;
+const round3 = (v) => Math.round(v * 1000) / 1000;
+/** Is there a keyframe within KF_EPS of this element-local time? */
+export function isOnKeyframe(anim, local) {
+    return anim.keyframes.some((k) => Math.abs(kfTime(k) - local) <= KF_EPS);
+}
+/**
+ * Sample the animation's value at an element-local time via the
+ * normative evaluator (scalars exact; arrays componentwise — position
+ * tangent curves are refined in the curve editor).
+ */
+export function sampleAnimation(anim, local) {
+    const sorted = [...anim.keyframes].sort((a, b) => kfTime(a) - kfTime(b));
+    if (sorted.length === 0)
+        return 0;
+    if (local <= kfTime(sorted[0]))
+        return sorted[0].value;
+    const last = sorted[sorted.length - 1];
+    if (local >= kfTime(last))
+        return last.value;
+    const bi = sorted.findIndex((k) => kfTime(k) > local);
+    const a = sorted[bi - 1];
+    const b = sorted[bi];
+    const p = (local - kfTime(a)) / (kfTime(b) - kfTime(a));
+    if (typeof a.value === 'number' && typeof b.value === 'number') {
+        return round3(a.value + (b.value - a.value) * applyEasing(b.easing, p));
+    }
+    if (Array.isArray(a.value) && Array.isArray(b.value)) {
+        const eased = applyEasing(b.easing, p);
+        return a.value.map((av, i) => round3(av + ((b.value[i] ?? av) - av) * eased));
+    }
+    return a.value;
+}
+/**
+ * Toggle a keyframe at an element-local time on animation `animIndex`.
+ * On a keyframe → splice it (removing the last keyframe removes the
+ * whole entry); otherwise → insert one sampled from the curve.
+ * Returns the next keyframe_animations array, or undefined when the
+ * last entry was removed (byte-clean documents).
+ */
+/**
+ * Write a VALUE into the keyframe at an element-local time: replaces
+ * the value when the playhead sits on a keyframe, otherwise inserts a
+ * new keyframe there (AE-style auto-key for animated properties).
+ */
+export function setKeyframeValueAt(anims, animIndex, local, value) {
+    const anim = anims[animIndex];
+    if (!anim)
+        return [...anims];
+    const hit = anim.keyframes.findIndex((k) => Math.abs(kfTime(k) - local) <= KF_EPS);
+    const keyframes = hit >= 0
+        ? anim.keyframes.map((k, i) => (i === hit ? { ...k, value } : k))
+        : [...anim.keyframes, { time: round3(local), value }].sort((a, b) => kfTime(a) - kfTime(b));
+    return anims.map((a, i) => (i === animIndex ? { ...a, keyframes } : a));
+}
+export function toggleKeyframeAt(anims, animIndex, local) {
+    const anim = anims[animIndex];
+    if (!anim)
+        return [...anims];
+    const hit = anim.keyframes.findIndex((k) => Math.abs(kfTime(k) - local) <= KF_EPS);
+    if (hit >= 0) {
+        const remaining = anim.keyframes.filter((_, i) => i !== hit);
+        if (remaining.length === 0) {
+            const next = anims.filter((_, i) => i !== animIndex);
+            return next.length > 0 ? next : undefined;
+        }
+        return anims.map((a, i) => (i === animIndex ? { ...a, keyframes: remaining } : a));
+    }
+    const inserted = [...anim.keyframes, { time: round3(local), value: sampleAnimation(anim, local) }].sort((a, b) => kfTime(a) - kfTime(b));
+    return anims.map((a, i) => (i === animIndex ? { ...a, keyframes: inserted } : a));
+}
+//# sourceMappingURL=keyframes.js.map