@lingjingai/script-editor 0.1.17 → 0.1.18

package/INTEGRATION.md

@@ -64,6 +64,7 @@ function Host({ script, setScript }) {
 - `selection` / `onSelectionChange`(`StudioSelection`,不传则内部自管)
 - `format` / `onFormatChange`(`"standard" | "asian"`)
 - `disabled`、`dark`、`className`
+- `toc?: "sidebar" | "none"`:内置左侧目录。默认 `"sidebar"` 渲染自带 256px 目录列;`"none"` = **无目录模式**——只渲染顶栏 + 画布(占满宽度),宿主自建导航。见 §10。`0.1.18+`
 
 **HUD(顶栏)**
 - `onTitleChange?(next: string)`：顶栏左侧常驻**剧本标题**(取 `value.title`)。传了它,标题变**点击即改**;不传则只读展示(`value.title` 为空时不显示)。包**不碰存储**——拿到新标题宿主自己持久化(可 `onEdit(p => ({...p, title}))` 写回 `script.json`,或另调重命名接口)。`0.1.16+`
@@ -127,3 +128,61 @@ function Host({ script, setScript }) {
 - `apps/web/src/features/script-editor/useScriptDocument.ts` —— 自动保存 + undo/redo + 8s 轮询探测
 - `apps/web/src/features/script-editor/script-output-api.ts` —— 后端存取
 - `apps/web/src/main.tsx` / `apps/web/vite.config.ts` —— CSS 引入 + `development` 解析条件
+
+---
+
+## 10. 无目录模式 / 自建导航(`toc="none"`)`0.1.18+`
+
+把内置左侧目录关掉、导航**透出**给宿主自己渲染(嵌进已有全局导航、或做成面包屑下拉 / ⌘K 命令面板 / 移动端 sheet 等完全不同的形态)。包只给**纯数据模型**,不给 UI。
+
+```tsx
+import {
+  ScriptEditor,
+  buildScriptNav,
+  selectionTargetKey,
+  withOrigin,
+  type StudioSelection,
+} from "@lingjingai/script-editor";
+
+function Host({ script, onEdit }) {
+  // 无目录模式下 selection 必须受控(宿主自己的导航要驱动它)
+  const [sel, setSel] = useState<StudioSelection>({ kind: "empty" });
+  const nav = buildScriptNav(script);          // 派生导航树(纯函数)
+  const active = selectionTargetKey(sel);       // 当前激活节点的 key
+
+  return (
+    <>
+      {/* 宿主自建的任意导航 UI —— 这里是最朴素的列表 */}
+      <MyNav>
+        {nav.episodes.flatMap((e) => e.scenes).map((s) => (
+          <button
+            key={s.key}
+            data-active={s.key === active}
+            onClick={() => setSel(withOrigin(s.selection, "sidebar"))}
+          >
+            {s.label} · {s.meta}
+          </button>
+        ))}
+      </MyNav>
+
+      <ScriptEditor
+        value={script}
+        onEdit={onEdit}
+        toc="none"                 {/* ← 关掉内置目录,画布占满 */}
+        selection={sel}
+        onSelectionChange={setSel} {/* ← 编辑器内滚动 spy 也会回吐 selection */}
+      />
+    </>
+  );
+}
+```
+
+`buildScriptNav(value): ScriptNav` 返回:
+- `worldview` / `episodes[]` / `actors[]` / `locations[]` / `props[]`,`episodes[].scenes[]` 内嵌。
+- 每个节点都带 **`key`**(= `selectionTargetKey(node.selection)`,拿去和 `selectionTargetKey(当前selection)` 比对即判激活)和 **`selection`**(即用型 `StudioSelection`,**不带 origin**;点击时 `withOrigin(node.selection, "sidebar")` 再喂 `onSelectionChange`)。
+- 标签字段(`label`/`title`/`meta`/`name`)与内置目录**同 helper 派生**,长相一致。
+
+要点:
+- selection 同时也是**回吐**通道:编辑器画布滚动时会上抛 `onSelectionChange`(origin `"scroll"`),宿主导航据此高亮当前位置。
+- 无目录模式下内置「新增一集」按钮消失——宿主可自行调 `mutations.addEpisode`(已从包导出:`mutations.addEpisode(prev)`)接到自己的按钮上。
+- 形态对照交互演示:`toc-modes-demo.html`(本包根目录,不随包发布)「形态 B」tab,演示用同一个 `buildScriptNav` 模型同时驱动面包屑下拉 + ⌘K 两种 UI。

package/dist/index.d.ts

@@ -488,6 +488,12 @@ interface ScriptEditorProps extends ScriptEditorAdapters {
     disabled?: boolean;
     className?: string;
     dark?: boolean;
+    /** built-in left directory. Default "sidebar" renders the bundled 256px TOC
+     *  column; "none" → directory-less mode: the editor renders top bar + canvas
+     *  only (full width) and the host drives navigation via controlled
+     *  selection/onSelectionChange + the exported buildScriptNav(value) model.
+     *  0.1.18+ */
+    toc?: "sidebar" | "none";
     /** when provided, the script title (value.title) becomes click-to-edit in the
      *  top bar; the host persists the new value (the editor never touches storage,
      *  matching the value + onEdit contract — just one more delegated hook). Omit →
@@ -512,7 +518,65 @@ interface ScriptEditorProps extends ScriptEditorAdapters {
      *  scroll position across editor unmount/remount (tab switch / project nav). */
     scrollScopeKey?: string;
 }
-declare function ScriptEditor({ value, onEdit, selection: controlledSelection, onSelectionChange, format: controlledFormat, onFormatChange, disabled, className, dark, onTitleChange, topBarActions, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, referenceFocusRequest, scrollScopeKey, diff, asset, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
+declare function ScriptEditor({ value, onEdit, selection: controlledSelection, onSelectionChange, format: controlledFormat, onFormatChange, disabled, className, dark, toc, onTitleChange, topBarActions, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, referenceFocusRequest, scrollScopeKey, diff, asset, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
+
+/**
+ * Headless navigation model — surfaces the script's TOC tree (the same
+ * episodes/scenes/entity structure `StudioToc` renders) as plain data so a host
+ * in directory-less mode (`<ScriptEditor toc="none" />`) can build its OWN
+ * navigation UI: breadcrumb dropdown, ⌘K command palette, mobile sheet, etc.
+ *
+ * Each node carries:
+ *   - `key`       — `selectionTargetKey` of its selection; compare against
+ *                   `selectionTargetKey(currentSelection)` to mark the active node.
+ *   - `selection` — a ready-to-use `StudioSelection` (no origin). On click do
+ *                   `onSelectionChange(withOrigin(node.selection, "sidebar"))`.
+ *
+ * Labels reuse the exact same helpers as `StudioToc`, so a custom nav stays
+ * label-identical to the built-in one. Pure function, zero side effects.
+ */
+
+interface ScriptNavScene {
+    key: string;
+    episodeIdx: number;
+    sceneIdx: number;
+    sceneId: string;
+    /** e.g. "场 7" */
+    label: string;
+    /** e.g. "scn_007 · 夜内" */
+    meta: string;
+    selection: StudioSelection;
+}
+interface ScriptNavEpisode {
+    key: string;
+    episodeIdx: number;
+    /** zero-padded episode number, e.g. "01" */
+    label: string;
+    /** human title (falls back to "第 NN 集") */
+    title: string;
+    sceneCount: number;
+    scenes: ScriptNavScene[];
+    selection: StudioSelection;
+}
+interface ScriptNavEntity {
+    key: string;
+    id: string;
+    name: string;
+    selection: StudioSelection;
+}
+interface ScriptNav {
+    worldview: {
+        key: string;
+        label: string;
+        selection: StudioSelection;
+    };
+    episodes: ScriptNavEpisode[];
+    actors: ScriptNavEntity[];
+    locations: ScriptNavEntity[];
+    props: ScriptNavEntity[];
+}
+/** Derive the navigation tree from a ScriptProject (see file header). */
+declare function buildScriptNav(value: ScriptProject): ScriptNav;
 
 /**
  * Pure ScriptProject mutations.
@@ -739,4 +803,4 @@ declare function DeleteConfirmButton({ onConfirm, disabled, targetScope, title,
     description?: string;
 }): react.JSX.Element;
 
-export { type AssetAdapter, type AssetDeleteRequest, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffActionMark, type DiffAdapter, type DiffSceneMark, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, Popover, type SaveStatus, type Scene, type SceneActionDiff, type SceneChangeKind, type SceneContext, type SceneEnvironment, type ScriptActor, ScriptContentType, type ScriptData, ScriptEditor, type ScriptEditorAdapters, type ScriptEditorProps, type ScriptEpisode, type ScriptFormat, type ScriptItem, type ScriptLocation, type ScriptProject, type ScriptProp, type ScriptReferenceFocusRequest, type ScriptReferenceLocator, type ScriptSpeaker, type ScriptTargetKind, SelectField, type StateChange, type StudioSelection, type StudioSelectionFrom, type StudioSelectionOrigin, type TransitionPrompt, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, index as mutations, rejectActionToBaseline, rejectSceneToBaseline, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };
+export { type AssetAdapter, type AssetDeleteRequest, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffActionMark, type DiffAdapter, type DiffSceneMark, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, Popover, type SaveStatus, type Scene, type SceneActionDiff, type SceneChangeKind, type SceneContext, type SceneEnvironment, type ScriptActor, ScriptContentType, type ScriptData, ScriptEditor, type ScriptEditorAdapters, type ScriptEditorProps, type ScriptEpisode, type ScriptFormat, type ScriptItem, type ScriptLocation, type ScriptNav, type ScriptNavEntity, type ScriptNavEpisode, type ScriptNavScene, type ScriptProject, type ScriptProp, type ScriptReferenceFocusRequest, type ScriptReferenceLocator, type ScriptSpeaker, type ScriptTargetKind, SelectField, type StateChange, type StudioSelection, type StudioSelectionFrom, type StudioSelectionOrigin, type TransitionPrompt, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, index as mutations, rejectActionToBaseline, rejectSceneToBaseline, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };

package/dist/index.js

@@ -3989,6 +3989,7 @@ function ScriptEditor({
   disabled = false,
   className,
   dark,
+  toc = "sidebar",
   onTitleChange,
   topBarActions,
   saveStatus = "idle",
@@ -4152,7 +4153,7 @@ function ScriptEditor({
     }
   );
   return /* @__PURE__ */ jsx(EditingSignalContext.Provider, { value: editingSignal, children: /* @__PURE__ */ jsxs("div", { className: rootClass, children: [
-    /* @__PURE__ */ jsx(
+    toc === "sidebar" ? /* @__PURE__ */ jsx(
       StudioToc,
       {
         data: value,
@@ -4160,7 +4161,7 @@ function ScriptEditor({
         onSelect: setSelection,
         onAddEpisode: disabled ? void 0 : () => onEdit((p) => addEpisode(p))
       }
-    ),
+    ) : null,
     /* @__PURE__ */ jsxs("div", { className: "lj-se-main", children: [
       /* @__PURE__ */ jsx(
         CanvasTopBar,
@@ -4258,6 +4259,54 @@ function resolveReturnTarget(value, selection) {
   return { label, selection: withOrigin(fromToSelection(from), "reference") };
 }
 
+// src/toc/nav-model.ts
+function nav(selection) {
+  return { key: selectionTargetKey(selection), selection };
+}
+function buildScriptNav(value) {
+  const episodes = (value.episodes ?? []).map((episode, episodeIdx) => {
+    const scenes = (episode.scenes ?? []).map((scene, sceneIdx) => {
+      const selection2 = { kind: "scene", episodeIdx, sceneIdx };
+      return {
+        ...nav(selection2),
+        episodeIdx,
+        sceneIdx,
+        sceneId: scene.scene_id ?? "",
+        label: getSceneNumberLabel(scene, sceneIdx),
+        meta: getSceneSidebarLabel(scene, sceneIdx)
+      };
+    });
+    const selection = { kind: "episode", episodeIdx };
+    return {
+      ...nav(selection),
+      episodeIdx,
+      label: getEpisodeNumberLabel(episode, episodeIdx),
+      title: getEpisodeTitle(episode, episodeIdx),
+      sceneCount: scenes.length,
+      scenes
+    };
+  });
+  const actors = (value.actors ?? []).map((a) => {
+    const id = (a.actor_id ?? "").trim();
+    return { ...nav({ kind: "actor", actorId: id }), id, name: getActorDisplayName(a) };
+  }).filter((e) => e.id);
+  const locations = (value.locations ?? []).map((l) => {
+    const id = (l.location_id ?? "").trim();
+    return { ...nav({ kind: "location", locationId: id }), id, name: getLocationDisplayName(l) };
+  }).filter((e) => e.id);
+  const props = (value.props ?? []).map((p) => {
+    const id = (p.prop_id ?? "").trim();
+    return { ...nav({ kind: "prop", propId: id }), id, name: getPropDisplayName(p) };
+  }).filter((e) => e.id);
+  return {
+    worldview: { ...nav({ kind: "worldview" }), label: "\u4E16\u754C\u89C2 & \u98CE\u683C" },
+    episodes,
+    actors,
+    locations,
+    props
+  };
+}
+
 // src/mutations/index.ts
 var mutations_exports = {};
 __export(mutations_exports, {
@@ -4299,6 +4348,6 @@ __export(mutations_exports, {
   updateScenePropState: () => updateScenePropState
 });
 
-export { DeleteConfirmButton, EMPTY_SELECTION, EditableText, Popover, ScriptContentType, ScriptEditor, SelectField, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, mutations_exports as mutations, rejectActionToBaseline, rejectSceneToBaseline, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };
+export { DeleteConfirmButton, EMPTY_SELECTION, EditableText, Popover, ScriptContentType, ScriptEditor, SelectField, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, mutations_exports as mutations, rejectActionToBaseline, rejectSceneToBaseline, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map