@aicut/core 0.1.0 → 0.2.0

package/README.md

@@ -1,9 +1,17 @@
 # @aicut/core
 
-Framework-agnostic video editor engine. Owns the project data model, the HTML5 playback engine, the canvas timeline (ruler, tracks, clips, thumbnails, playhead, snap, in-canvas scrollbars), and a vanilla DOM toolbar.
+> Framework-agnostic engine for the AiCut video editor — canvas timeline, plain-JSON projects, zero runtime deps.
+
+[![npm](https://img.shields.io/npm/v/@aicut/core.svg)](https://www.npmjs.com/package/@aicut/core)
+[![License](https://img.shields.io/npm/l/@aicut/core.svg)](./LICENSE)
+[![GitHub](https://img.shields.io/badge/repo-ziqiangai/AiCut-181717?logo=github)](https://github.com/ziqiangai/AiCut)
+
+![AiCut editor](https://raw.githubusercontent.com/ziqiangai/AiCut/main/docs/screenshots/editor-dark.png)
 
 For React or Vue apps, prefer **[@aicut/react](https://www.npmjs.com/package/@aicut/react)** or **[@aicut/vue](https://www.npmjs.com/package/@aicut/vue)** — they wrap this same engine.
 
+## Install
+
 ```bash
 pnpm add @aicut/core
 ```
@@ -21,91 +29,79 @@ const editor = Editor.create({
     sources: [
       { id: "s1", url: "/media/a.mp4", kind: "video", name: "a.mp4" },
     ],
-    tracks: [
-      {
-        id: "t1",
-        kind: "video",
-        clips: [{ id: "c1", sourceId: "s1", in: 0, out: 5000, start: 0 }],
-      },
-    ],
+    tracks: [{
+      id: "t1",
+      kind: "video",
+      clips: [{ id: "c1", sourceId: "s1", in: 0, out: 5000, start: 0 }],
+    }],
   },
 });
 
-editor.on("change", ({ project }) => localStorage.setItem("aicut", JSON.stringify(project)));
-editor.on("export", ({ project }) => fetch("/api/export", {
-  method: "POST",
-  headers: { "content-type": "application/json" },
-  body: JSON.stringify({ project }),
-}));
-```
-
-The editor renders into your `container`. Call methods on the returned `editor` instance to drive it imperatively.
+editor.on("change", ({ project }) => {
+  localStorage.setItem("aicut", JSON.stringify(project));
+});
 
-## API surface
+editor.on("export", ({ project }) => {
+  fetch("/api/export", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ project }),
+  });
+});
+```
 
-### Playback & editing
+## API at a glance
 
 ```ts
-editor.play(); editor.pause(); editor.togglePlay(); editor.seek(timeMs);
-editor.split();           // split at playhead
-editor.trimLeft();        // trim selected clip's left edge to playhead
+// Playback
+editor.play(); editor.pause(); editor.togglePlay();
+editor.seek(timeMs);
+
+// Editing
+editor.split();          // at playhead
+editor.trimLeft();
 editor.trimRight();
 editor.removeClip(clipId);
 editor.setClipSpeed(clipId, 2);
-
 editor.undo(); editor.redo();
-editor.canUndo(); editor.canRedo();
-```
 
-### Project, sources, tracks
-
-```ts
-editor.getProject();              // deep clone of current state
-editor.setProject(p);             // replace, preserves auto-fit etc.
-editor.reset();                   // empty single-track project
+// Project state
+editor.getProject();
+editor.setProject(project);
+editor.reset();
 editor.addSource({ id, url, kind: "video" });
 editor.addTrack("video");
-editor.removeTrack(trackId);
 editor.moveClip(clipId, { start, trackId, newTrack });
-editor.resizeClip(clipId, { in, out, start });
-```
 
-### Viewport
+// Viewport
+editor.setScale(80);     // px per second
+editor.setSnap(false);
+editor.setSelection(clipId);
 
-```ts
-editor.getScale(); editor.setScale(80);    // px per second
-editor.getSnap(); editor.setSnap(false);
-editor.getSelection(); editor.setSelection(clipId);
-editor.enterFullscreen(); editor.exitFullscreen();
+// UI
+editor.setTheme({ controlsBg: "#fff" });
+editor.setLocale({ undo: "Annuler" });
+editor.requestExport();  // → fires "export" event
 ```
 
-### Events
+## Events
 
 ```ts
-const off = editor.on("change", ({ project }) => /* … */);
-editor.on("time", ({ timeMs }) => /* playback tick */);
-editor.on("export", ({ project }) => /* host-triggered export */);
+editor.on("change",          ({ project }) => /* … */);
+editor.on("time",            ({ timeMs }) => /* … */);
+editor.on("export",          ({ project }) => /* … */);
 editor.on("selectionChange", ({ clipId }) => /* … */);
-editor.on("historyChange", ({ canUndo, canRedo }) => /* … */);
-editor.on("ready", ({ sourceId }) => /* per-source metadata loaded */);
-editor.on("scaleChange", ({ pxPerSec }) => /* … */);
-editor.on("snapChange", ({ snap }) => /* … */);
-editor.on("error", ({ error }) => /* … */);
-off();                                       // unsubscribe
+editor.on("historyChange",   ({ canUndo, canRedo }) => /* … */);
+editor.on("ready",           ({ sourceId }) => /* … */);
+editor.on("scaleChange",     ({ pxPerSec }) => /* … */);
+editor.on("snapChange",      ({ snap }) => /* … */);
+editor.on("error",           ({ error }) => /* … */);
 ```
 
-### Triggering export
-
-The library never calls a backend on its own — `requestExport()` fires the `export` event with the current project JSON; your handler decides what to do.
-
-```ts
-editor.requestExport();        // → emits "export" with project
-```
+Each `on` returns an unsubscribe function.
 
 ## Theming
 
-CSS variables; pass any subset via `theme` and the rest fall back to the defaults.
-
 ```ts
 Editor.create({
   container,
@@ -116,16 +112,14 @@ Editor.create({
     controlsBorder: "rgba(255, 255, 255, 0.08)",
     controlsHover: "rgba(255, 255, 255, 0.08)",
     controlsActive: "rgba(255, 255, 255, 0.12)",
-    previewBg: "#000",                          // letterbox colour
+    previewBg: "#000",                 // letterbox colour
   },
 });
-
-editor.setTheme({ controlsBg: "#f6f6f8", previewBg: "#e4e4e7" });   // runtime swap
 ```
 
-Every variable is also a plain CSS custom property — `.aicut-root { --aicut-controls-bg: …; }` works too.
+Every key is also a plain CSS custom property — `.aicut-root { --aicut-controls-bg: …; }` works too. Call `editor.setTheme(…)` to swap at runtime.
 
-## Internationalisation
+## i18n
 
 English by default. Bundled `localeZh` covers the whole editor (toolbar tooltips, exit-fullscreen overlay, canvas track headers).
 
@@ -134,42 +128,65 @@ import { Editor, localeZh } from "@aicut/core";
 
 Editor.create({ container, project, locale: localeZh });
 
-// Partial override + runtime swap
-editor.setLocale({ undo: "Annuler", redo: "Refaire" });
+editor.setLocale({ undo: "Annuler" });   // partial override
 ```
 
-`Locale` is exported as a type if you need to typecheck a custom pack.
-
 ## Toolbar slots
 
-Both the editor's built-in toolbar and the standalone `Timeline`'s optional toolbar reserve `toolbarLeft` / `toolbarRight` slot DOM elements for host-supplied controls.
+Both the editor's toolbar and the standalone `Timeline`'s optional toolbar expose `toolbarLeft` / `toolbarRight` slot DOM elements. The library renders nothing into them — append your own buttons.
 
 ```ts
-const editor = Editor.create({ container, project });
 const exportBtn = document.createElement("button");
 exportBtn.textContent = "Export";
 exportBtn.onclick = () => editor.requestExport();
 editor.toolbarRight.appendChild(exportBtn);
 ```
 
-The library paints nothing into either slot and renders no separator until they're populated.
+## Lighting picker (opt-in sub-entry)
 
-## Standalone Timeline
+A separate component for AI relighting workflows — drag a light dot around a 3D sphere wrapping a subject frame, control brightness / color / direction. Three.js is bundled only on this sub-entry, so consumers of the video editor pay zero bytes for it.
 
-Use the canvas timeline without the rest of the editor — useful for a frame-picker, thumbnail strip, or a read-only preview.
+```ts
+import { LightingEditor } from "@aicut/core/lighting";
+import "@aicut/core/styles.css";
+
+const ed = LightingEditor.create({
+  container: document.getElementById("light")!,
+  subjectImageUrl: "/frames/subject.jpg",
+  smartEnabled: true,        // default; false → no slot column at all
+  smartOpen: true,           // default; user can toggle via × / header pill
+  onChange: (cfg) => console.log(cfg),
+  onGenerate: (cfg) => fetch("/relight", { method: "POST", body: JSON.stringify(cfg) }),
+});
+
+// Host appends UI into the smart slot (prompt textarea, presets, generate btn, …).
+ed.smartSlot.appendChild(myAiUI);
+
+// Runtime control:
+ed.setSmartOpen(false);
+ed.setSmartEnabled(false);
+ed.setView("front");
+ed.setConfig({ brightness: 0.8, color: "#ffaa3a" });
+```
+
+Locale extension `LightingLocale` (separate from the video editor's `Locale`) is also exported with `lightingLocaleEn` / `lightingLocaleZh`.
+
+## Standalone Timeline
 
 ```ts
 import { Timeline } from "@aicut/core";
 
 const tl = Timeline.create({
   container: document.getElementById("strip")!,
-  project: { /* one-clip project */ },
+  project: singleClipProject,
   showHeader: false,
   readOnly: true,
   onSeek: (ms) => console.log("picked", ms),
 });
 ```
 
+Useful for a frame-picker, thumbnail strip, or read-only preview.
+
 ## Data model
 
 ```ts
@@ -188,14 +205,14 @@ interface Track { id: string; kind: "video" | "audio"; clips: Clip[]; }
 
 interface Clip {
   id: string; sourceId: string;
-  in: Ms; out: Ms;       // window into the source (exclusive at `out`)
-  start: Ms;              // position on the timeline
+  in: Ms; out: Ms;     // window into the source (exclusive at `out`)
+  start: Ms;            // position on the timeline
   speed?: number;
 }
 
-type Ms = number;         // integer milliseconds; no frame-rate coupling
+type Ms = number;       // integer milliseconds; no frame-rate coupling
 ```
 
-## License
+---
 
-MIT
+[Full docs & demo](https://github.com/ziqiangai/AiCut) · [@aicut/react](https://www.npmjs.com/package/@aicut/react) · [@aicut/vue](https://www.npmjs.com/package/@aicut/vue)

package/dist/chunk-CCDON7CU.js

@@ -0,0 +1,87 @@
+// src/i18n.ts
+var localeEn = {
+  undo: "Undo",
+  redo: "Redo",
+  split: "Split",
+  trimLeft: "Trim left edge",
+  trimRight: "Trim right edge",
+  speedComingSoon: "Speed (coming soon)",
+  playPause: "Play / Pause (Space)",
+  fullscreen: "Fullscreen preview",
+  snap: "Snap",
+  snapOnTitle: "Turn off snap",
+  snapOffTitle: "Turn on snap",
+  zoomOut: "Zoom out",
+  zoomIn: "Zoom in",
+  reset: "Reset edits (keep sources)",
+  exitFullscreen: "Exit fullscreen",
+  exitFullscreenTitle: "Exit fullscreen (Esc)",
+  newTrack: "+ New track",
+  videoTrackLabel: "Video {n}",
+  audioTrackLabel: "Audio {n}"
+};
+var localeZh = {
+  undo: "\u64A4\u9500",
+  redo: "\u91CD\u505A",
+  split: "\u5206\u5272",
+  trimLeft: "\u5411\u5DE6\u88C1\u526A",
+  trimRight: "\u5411\u53F3\u88C1\u526A",
+  speedComingSoon: "\u53D8\u901F\uFF08\u5373\u5C06\u5230\u6765\uFF09",
+  playPause: "\u64AD\u653E / \u6682\u505C (Space)",
+  fullscreen: "\u5168\u5C4F\u9884\u89C8",
+  snap: "\u5438\u9644",
+  snapOnTitle: "\u5173\u95ED\u5438\u9644",
+  snapOffTitle: "\u5F00\u542F\u5438\u9644",
+  zoomOut: "\u7F29\u5C0F",
+  zoomIn: "\u653E\u5927",
+  reset: "\u91CD\u7F6E\u7F16\u8F91\uFF08\u4FDD\u7559\u89C6\u9891\u6E90\uFF09",
+  exitFullscreen: "\u9000\u51FA\u5168\u5C4F",
+  exitFullscreenTitle: "\u9000\u51FA\u5168\u5C4F (Esc)",
+  newTrack: "+ \u65B0\u8F68\u9053",
+  videoTrackLabel: "\u89C6\u9891 {n}",
+  audioTrackLabel: "\u97F3\u9891 {n}"
+};
+function mergeLocale(partial) {
+  return partial ? { ...localeEn, ...partial } : localeEn;
+}
+function formatLabel(template, vars) {
+  return template.replace(
+    /\{(\w+)\}/g,
+    (_, k) => k in vars ? String(vars[k]) : `{${k}}`
+  );
+}
+
+// src/theme.ts
+var THEME_VARS = {
+  brand: "--color-brand",
+  secondary: "--color-secondary",
+  surface: "--color-surface",
+  dark: "--color-dark",
+  muted: "--color-muted",
+  card: "--color-card",
+  success: "--color-success",
+  warning: "--color-warning",
+  info: "--color-info",
+  error: "--color-error",
+  controlsBg: "--aicut-controls-bg",
+  controlsBorder: "--aicut-controls-border",
+  controlsText: "--aicut-controls-text",
+  controlsHover: "--aicut-controls-hover",
+  controlsActive: "--aicut-controls-active",
+  previewBg: "--aicut-preview-bg",
+  radiusSm: "--aicut-radius-sm",
+  radiusMd: "--aicut-radius-md",
+  radiusLg: "--aicut-radius-lg"
+};
+function applyTheme(root, theme) {
+  if (!theme) return;
+  for (const key of Object.keys(theme)) {
+    const cssVar = THEME_VARS[key];
+    const value = theme[key];
+    if (cssVar && value) root.style.setProperty(cssVar, value);
+  }
+}
+
+export { applyTheme, formatLabel, localeEn, localeZh, mergeLocale };
+//# sourceMappingURL=chunk-CCDON7CU.js.map
+//# sourceMappingURL=chunk-CCDON7CU.js.map

package/dist/chunk-CCDON7CU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n.ts","../src/theme.ts"],"names":[],"mappings":"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","file":"chunk-CCDON7CU.js","sourcesContent":["/**\n * UI strings the editor paints into the DOM (toolbar tooltips, the\n * fullscreen exit button) and onto the timeline canvas (phantom new-\n * track label, track header labels). Every user-visible literal in\n * `@aicut/core` flows through this interface — there are no hidden\n * hard-coded translations elsewhere in the library.\n *\n * Defaults to English. Hosts that want Chinese (or any other locale)\n * pass `locale: localeZh` to `Editor.create` / `Timeline.create`, or\n * override individual keys with `locale: { undo: \"撤销\" }`.\n */\nexport interface Locale {\n  // Toolbar tooltips\n  undo: string;\n  redo: string;\n  split: string;\n  trimLeft: string;\n  trimRight: string;\n  speedComingSoon: string;\n  playPause: string;\n  fullscreen: string;\n  snap: string;\n  /** Title shown on the snap button when snap is ON (clicking turns OFF). */\n  snapOnTitle: string;\n  /** Title shown when snap is OFF (clicking turns ON). */\n  snapOffTitle: string;\n  zoomOut: string;\n  zoomIn: string;\n  reset: string;\n\n  // Fullscreen exit overlay\n  exitFullscreen: string;\n  exitFullscreenTitle: string;\n\n  // Timeline canvas labels\n  /** Phantom row that appears under the last track during a drag. */\n  newTrack: string;\n  /** Track header — `{n}` is replaced with the 1-based track index. */\n  videoTrackLabel: string;\n  /** Same template format as videoTrackLabel. */\n  audioTrackLabel: string;\n}\n\n/** English. The library default — chosen over Chinese as the OSS norm. */\nexport const localeEn: Locale = {\n  undo: \"Undo\",\n  redo: \"Redo\",\n  split: \"Split\",\n  trimLeft: \"Trim left edge\",\n  trimRight: \"Trim right edge\",\n  speedComingSoon: \"Speed (coming soon)\",\n  playPause: \"Play / Pause (Space)\",\n  fullscreen: \"Fullscreen preview\",\n  snap: \"Snap\",\n  snapOnTitle: \"Turn off snap\",\n  snapOffTitle: \"Turn on snap\",\n  zoomOut: \"Zoom out\",\n  zoomIn: \"Zoom in\",\n  reset: \"Reset edits (keep sources)\",\n  exitFullscreen: \"Exit fullscreen\",\n  exitFullscreenTitle: \"Exit fullscreen (Esc)\",\n  newTrack: \"+ New track\",\n  videoTrackLabel: \"Video {n}\",\n  audioTrackLabel: \"Audio {n}\",\n};\n\n/** Simplified Chinese. */\nexport const localeZh: Locale = {\n  undo: \"撤销\",\n  redo: \"重做\",\n  split: \"分割\",\n  trimLeft: \"向左裁剪\",\n  trimRight: \"向右裁剪\",\n  speedComingSoon: \"变速（即将到来）\",\n  playPause: \"播放 / 暂停 (Space)\",\n  fullscreen: \"全屏预览\",\n  snap: \"吸附\",\n  snapOnTitle: \"关闭吸附\",\n  snapOffTitle: \"开启吸附\",\n  zoomOut: \"缩小\",\n  zoomIn: \"放大\",\n  reset: \"重置编辑（保留视频源）\",\n  exitFullscreen: \"退出全屏\",\n  exitFullscreenTitle: \"退出全屏 (Esc)\",\n  newTrack: \"+ 新轨道\",\n  videoTrackLabel: \"视频 {n}\",\n  audioTrackLabel: \"音频 {n}\",\n};\n\n/** Spread defaults under host overrides — host can supply a partial. */\nexport function mergeLocale(partial: Partial<Locale> | undefined): Locale {\n  return partial ? { ...localeEn, ...partial } : localeEn;\n}\n\n/**\n * Replace `{key}` placeholders in a template. We only need `{n}`\n * substitution today; the implementation is generic so additional\n * keys (e.g. `{name}`) won't need a second pass.\n */\nexport function formatLabel(\n  template: string,\n  vars: Record<string, string | number>,\n): string {\n  return template.replace(/\\{(\\w+)\\}/g, (_, k) =>\n    k in vars ? String(vars[k]) : `{${k}}`,\n  );\n}\n","import type { Theme } from \"./types.js\";\n\n/**\n * Map `Theme` keys to the CSS custom property they write.\n *\n * Brand/palette keys share names with iqvise's globals.css so hosts\n * that already define `--color-brand` etc. at the page level get the\n * editor in their palette for free — `theme` props ONLY needed when\n * scoping to this editor instance.\n *\n * Chrome keys keep the `--aicut-controls-*` prefix because they have\n * no analogue in the host palette.\n */\nconst THEME_VARS: Record<keyof Theme, string> = {\n  brand: \"--color-brand\",\n  secondary: \"--color-secondary\",\n  surface: \"--color-surface\",\n  dark: \"--color-dark\",\n  muted: \"--color-muted\",\n  card: \"--color-card\",\n  success: \"--color-success\",\n  warning: \"--color-warning\",\n  info: \"--color-info\",\n  error: \"--color-error\",\n  controlsBg: \"--aicut-controls-bg\",\n  controlsBorder: \"--aicut-controls-border\",\n  controlsText: \"--aicut-controls-text\",\n  controlsHover: \"--aicut-controls-hover\",\n  controlsActive: \"--aicut-controls-active\",\n  previewBg: \"--aicut-preview-bg\",\n  radiusSm: \"--aicut-radius-sm\",\n  radiusMd: \"--aicut-radius-md\",\n  radiusLg: \"--aicut-radius-lg\",\n};\n\nexport function applyTheme(root: HTMLElement, theme: Theme | undefined): void {\n  if (!theme) return;\n  for (const key of Object.keys(theme) as Array<keyof Theme>) {\n    const cssVar = THEME_VARS[key];\n    const value = theme[key];\n    if (cssVar && value) root.style.setProperty(cssVar, value);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -1,121 +1,5 @@
-/**
- * UI strings the editor paints into the DOM (toolbar tooltips, the
- * fullscreen exit button) and onto the timeline canvas (phantom new-
- * track label, track header labels). Every user-visible literal in
- * `@aicut/core` flows through this interface — there are no hidden
- * hard-coded translations elsewhere in the library.
- *
- * Defaults to English. Hosts that want Chinese (or any other locale)
- * pass `locale: localeZh` to `Editor.create` / `Timeline.create`, or
- * override individual keys with `locale: { undo: "撤销" }`.
- */
-interface Locale {
-    undo: string;
-    redo: string;
-    split: string;
-    trimLeft: string;
-    trimRight: string;
-    speedComingSoon: string;
-    playPause: string;
-    fullscreen: string;
-    snap: string;
-    /** Title shown on the snap button when snap is ON (clicking turns OFF). */
-    snapOnTitle: string;
-    /** Title shown when snap is OFF (clicking turns ON). */
-    snapOffTitle: string;
-    zoomOut: string;
-    zoomIn: string;
-    reset: string;
-    exitFullscreen: string;
-    exitFullscreenTitle: string;
-    /** Phantom row that appears under the last track during a drag. */
-    newTrack: string;
-    /** Track header — `{n}` is replaced with the 1-based track index. */
-    videoTrackLabel: string;
-    /** Same template format as videoTrackLabel. */
-    audioTrackLabel: string;
-}
-/** English. The library default — chosen over Chinese as the OSS norm. */
-declare const localeEn: Locale;
-/** Simplified Chinese. */
-declare const localeZh: Locale;
-/** Spread defaults under host overrides — host can supply a partial. */
-declare function mergeLocale(partial: Partial<Locale> | undefined): Locale;
-/**
- * Replace `{key}` placeholders in a template. We only need `{n}`
- * substitution today; the implementation is generic so additional
- * keys (e.g. `{name}`) won't need a second pass.
- */
-declare function formatLabel(template: string, vars: Record<string, string | number>): string;
-
-/**
- * Milliseconds. All timing in the project is expressed as integer ms to
- * keep JSON serialization unambiguous (no frame-rate coupling in the
- * data model — the renderer can present time as frames if it wants).
- */
-type Ms = number;
-interface MediaSource {
-    id: string;
-    url: string;
-    kind: "video" | "audio";
-    /** Optional — probed lazily from the <video> element if absent. */
-    duration?: Ms;
-    name?: string;
-}
-interface Clip {
-    id: string;
-    sourceId: string;
-    /** Window into the source — `in` inclusive, `out` exclusive. */
-    in: Ms;
-    out: Ms;
-    /** Position on the timeline. */
-    start: Ms;
-    /**
-     * Playback rate. 1 = normal, 2 = 2× speed. Default 1.
-     * Persisted in the project JSON so a host can restore exactly.
-     */
-    speed?: number;
-}
-interface Track {
-    id: string;
-    kind: "video" | "audio";
-    /** Clips on this track. Must be kept sorted by `start` and non-overlapping. */
-    clips: Clip[];
-}
-interface Project {
-    /** Schema version — bump when breaking the JSON shape. */
-    version: 1;
-    sources: MediaSource[];
-    tracks: Track[];
-}
-/**
- * Subset of CSS variables the editor honors. Pass any custom values
- * via `Editor` options; everything is forwarded as `--aicut-*` on the
- * editor's root container, so a host can also override via plain CSS.
- */
-interface Theme {
-    brand?: string;
-    secondary?: string;
-    surface?: string;
-    dark?: string;
-    muted?: string;
-    card?: string;
-    success?: string;
-    warning?: string;
-    info?: string;
-    error?: string;
-    /** Toolbar / ruler chrome. Background of the editor frame. */
-    controlsBg?: string;
-    controlsBorder?: string;
-    controlsText?: string;
-    controlsHover?: string;
-    controlsActive?: string;
-    /** Letterbox color around the preview video. Defaults to black. */
-    previewBg?: string;
-    radiusSm?: string;
-    radiusMd?: string;
-    radiusLg?: string;
-}
+import { M as Ms, T as Track, C as Clip, a as MediaSource, P as Project, b as Theme, L as Locale } from './types-C95koNwJ.cjs';
+export { f as formatLabel, l as localeEn, c as localeZh, m as mergeLocale } from './types-C95koNwJ.cjs';
 
 interface EditorOptions {
     /** Host element to mount the editor into. Will be wiped on init. */
@@ -637,4 +521,4 @@ declare class Timeline {
     private applySnap;
 }
 
-export { type Clip, Editor, type EditorApi, type EditorEventMap, type EditorEventName, type EditorOptions, HEADER_WIDTH, type Locale, type MediaSource, type Ms, type Project, RULER_HEIGHT, TRACK_HEIGHT, type Theme, Timeline, type TimelineOptions, type Track, createEmptyProject, createId, formatLabel, localeEn, localeZh, mergeLocale, normalizeProject };
+export { Clip, Editor, type EditorApi, type EditorEventMap, type EditorEventName, type EditorOptions, HEADER_WIDTH, Locale, MediaSource, Ms, Project, RULER_HEIGHT, TRACK_HEIGHT, Theme, Timeline, type TimelineOptions, Track, createEmptyProject, createId, normalizeProject };

package/dist/index.d.ts

@@ -1,121 +1,5 @@
-/**
- * UI strings the editor paints into the DOM (toolbar tooltips, the
- * fullscreen exit button) and onto the timeline canvas (phantom new-
- * track label, track header labels). Every user-visible literal in
- * `@aicut/core` flows through this interface — there are no hidden
- * hard-coded translations elsewhere in the library.
- *
- * Defaults to English. Hosts that want Chinese (or any other locale)
- * pass `locale: localeZh` to `Editor.create` / `Timeline.create`, or
- * override individual keys with `locale: { undo: "撤销" }`.
- */
-interface Locale {
-    undo: string;
-    redo: string;
-    split: string;
-    trimLeft: string;
-    trimRight: string;
-    speedComingSoon: string;
-    playPause: string;
-    fullscreen: string;
-    snap: string;
-    /** Title shown on the snap button when snap is ON (clicking turns OFF). */
-    snapOnTitle: string;
-    /** Title shown when snap is OFF (clicking turns ON). */
-    snapOffTitle: string;
-    zoomOut: string;
-    zoomIn: string;
-    reset: string;
-    exitFullscreen: string;
-    exitFullscreenTitle: string;
-    /** Phantom row that appears under the last track during a drag. */
-    newTrack: string;
-    /** Track header — `{n}` is replaced with the 1-based track index. */
-    videoTrackLabel: string;
-    /** Same template format as videoTrackLabel. */
-    audioTrackLabel: string;
-}
-/** English. The library default — chosen over Chinese as the OSS norm. */
-declare const localeEn: Locale;
-/** Simplified Chinese. */
-declare const localeZh: Locale;
-/** Spread defaults under host overrides — host can supply a partial. */
-declare function mergeLocale(partial: Partial<Locale> | undefined): Locale;
-/**
- * Replace `{key}` placeholders in a template. We only need `{n}`
- * substitution today; the implementation is generic so additional
- * keys (e.g. `{name}`) won't need a second pass.
- */
-declare function formatLabel(template: string, vars: Record<string, string | number>): string;
-
-/**
- * Milliseconds. All timing in the project is expressed as integer ms to
- * keep JSON serialization unambiguous (no frame-rate coupling in the
- * data model — the renderer can present time as frames if it wants).
- */
-type Ms = number;
-interface MediaSource {
-    id: string;
-    url: string;
-    kind: "video" | "audio";
-    /** Optional — probed lazily from the <video> element if absent. */
-    duration?: Ms;
-    name?: string;
-}
-interface Clip {
-    id: string;
-    sourceId: string;
-    /** Window into the source — `in` inclusive, `out` exclusive. */
-    in: Ms;
-    out: Ms;
-    /** Position on the timeline. */
-    start: Ms;
-    /**
-     * Playback rate. 1 = normal, 2 = 2× speed. Default 1.
-     * Persisted in the project JSON so a host can restore exactly.
-     */
-    speed?: number;
-}
-interface Track {
-    id: string;
-    kind: "video" | "audio";
-    /** Clips on this track. Must be kept sorted by `start` and non-overlapping. */
-    clips: Clip[];
-}
-interface Project {
-    /** Schema version — bump when breaking the JSON shape. */
-    version: 1;
-    sources: MediaSource[];
-    tracks: Track[];
-}
-/**
- * Subset of CSS variables the editor honors. Pass any custom values
- * via `Editor` options; everything is forwarded as `--aicut-*` on the
- * editor's root container, so a host can also override via plain CSS.
- */
-interface Theme {
-    brand?: string;
-    secondary?: string;
-    surface?: string;
-    dark?: string;
-    muted?: string;
-    card?: string;
-    success?: string;
-    warning?: string;
-    info?: string;
-    error?: string;
-    /** Toolbar / ruler chrome. Background of the editor frame. */
-    controlsBg?: string;
-    controlsBorder?: string;
-    controlsText?: string;
-    controlsHover?: string;
-    controlsActive?: string;
-    /** Letterbox color around the preview video. Defaults to black. */
-    previewBg?: string;
-    radiusSm?: string;
-    radiusMd?: string;
-    radiusLg?: string;
-}
+import { M as Ms, T as Track, C as Clip, a as MediaSource, P as Project, b as Theme, L as Locale } from './types-C95koNwJ.js';
+export { f as formatLabel, l as localeEn, c as localeZh, m as mergeLocale } from './types-C95koNwJ.js';
 
 interface EditorOptions {
     /** Host element to mount the editor into. Will be wiped on init. */
@@ -637,4 +521,4 @@ declare class Timeline {
     private applySnap;
 }
 
-export { type Clip, Editor, type EditorApi, type EditorEventMap, type EditorEventName, type EditorOptions, HEADER_WIDTH, type Locale, type MediaSource, type Ms, type Project, RULER_HEIGHT, TRACK_HEIGHT, type Theme, Timeline, type TimelineOptions, type Track, createEmptyProject, createId, formatLabel, localeEn, localeZh, mergeLocale, normalizeProject };
+export { Clip, Editor, type EditorApi, type EditorEventMap, type EditorEventName, type EditorOptions, HEADER_WIDTH, Locale, MediaSource, Ms, Project, RULER_HEIGHT, TRACK_HEIGHT, Theme, Timeline, type TimelineOptions, Track, createEmptyProject, createId, normalizeProject };