@lingjingai/script-editor 0.0.1 → 0.1.1

package/INTEGRATION.md

@@ -20,12 +20,7 @@
   ```ts
   import "@lingjingai/script-editor/style.css";
   ```
-- **构建条件**:
-  - 默认走 `dist`(`tsup` 产物,编译好的 JS + d.ts),消费方无需编译包内 TS。
-  - 想直接吃 `src` + HMR(monorepo 开发)→ 打包器加 `development` 解析条件。Vite:
-    ```ts
-    resolve: { conditions: ["development"] }
-    ```
+- **构建产物**:消费方一律走 `dist`(`tsup` 编译好的 JS + d.ts + style.css + paper-fibers.png),无需编译包内 TS。`exports` 不带 `development` 条件(早期版本带过,会让 Vite **dev 模式**去找未发布的 `src/` 而报 `Failed to resolve import .../style.css` —— `0.1.1+` 已修)。
 
 ---
 

package/dist/index.d.ts

@@ -264,6 +264,36 @@ type ScriptFormat = "standard" | "asian";
 
 type SaveStatus = "idle" | "saving" | "saved" | "error";
 
+/**
+ * Reference focus — the INVERSE of "quote to chat". The host pushes a
+ * ScriptReferenceFocusRequest (e.g. when a chat message / comment that quotes
+ * the script is clicked); the editor maps the reference's `source` to a
+ * StudioSelection and scrolls/selects it. `requestId` is a nonce so re-focusing
+ * the same target re-triggers.
+ */
+
+/** Where a quoted reference points INTO the script. All fields optional/loose
+ *  to tolerate host payloads (numbers may arrive as strings). */
+interface ScriptReferenceLocator {
+    id?: string;
+    text?: string;
+    source?: {
+        kind?: string;
+        id?: string;
+        episodeIdx?: number | string;
+        sceneIdx?: number | string;
+        itemIdx?: number | string;
+        field?: string;
+    } | null;
+}
+interface ScriptReferenceFocusRequest {
+    /** nonce — bump to re-focus the same target */
+    requestId: number;
+    reference: ScriptReferenceLocator;
+}
+/** Map a reference locator → the selection the editor should focus, or null. */
+declare function selectionFromScriptReference(reference: ScriptReferenceLocator): StudioSelection | null;
+
 /**
  * Coarse, pure diff between a baseline ScriptProject (pre-AI-revision) and the
  * current one. Surfaces changed top-level fields and changed/added scenes so
@@ -310,6 +340,15 @@ interface AssetDeleteRequest {
 interface DiffAdapter {
     /** the script as it was BEFORE the AI revision (null = no pending diff) */
     baseline: ScriptProject | null;
+    /** whether the baseline is durably persisted ("ok") or only in memory
+     *  ("memory", e.g. localStorage write failed → lost on reload). Surfaced as a
+     *  hint in the diff capsule. Optional. */
+    baselineStatus?: "ok" | "memory";
+    /** advance the baseline by a patch — drives PER-CHANGE "accept": the editor
+     *  rewrites the baseline so one scene matches current, dropping just that
+     *  change from the diff. When provided, per-scene accept/reject affordances
+     *  appear on each changed scene. */
+    onPatchBaseline?: (patch: (prev: ScriptProject) => ScriptProject) => void;
     /** accept all AI changes — host drops the baseline */
     onAcceptAll?: () => void;
     /** reject all AI changes — restore the baseline as the working value */
@@ -328,10 +367,6 @@ interface AssetAdapter {
     }) => void;
     refresh?: () => void;
 }
-/** Agent bridge: send a chat message to the host's assistant. */
-interface AgentAdapter {
-    sendMessage: (text: string) => void;
-}
 /** A reference (quoted text / selected block) to push into the chat composer. */
 interface ChatReference {
     id: string;
@@ -341,7 +376,6 @@ interface ChatReference {
 interface ScriptEditorAdapters {
     diff?: DiffAdapter;
     asset?: AssetAdapter;
-    agent?: AgentAdapter;
     onAddChatReferences?: (refs: ChatReference[]) => void;
     onRequestAssetDelete?: (target: AssetDeleteRequest) => void;
 }
@@ -365,8 +399,11 @@ interface ScriptEditorProps extends ScriptEditorAdapters {
      *  last one closes — lets the host pause adopting external revisions without
      *  reaching into the package's DOM / class names. */
     onEditingChange?: (editing: boolean) => void;
+    /** host-pushed "jump into the script" signal (inverse of quote-to-chat):
+     *  bump requestId + supply a reference → editor selects & scrolls to it. */
+    referenceFocusRequest?: ScriptReferenceFocusRequest | null;
 }
-declare function ScriptEditor({ value, onEdit, selection: controlledSelection, onSelectionChange, format: controlledFormat, onFormatChange, disabled, className, dark, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, diff, asset, agent, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
+declare function ScriptEditor({ value, onEdit, selection: controlledSelection, onSelectionChange, format: controlledFormat, onFormatChange, disabled, className, dark, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, referenceFocusRequest, diff, asset, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
 
 /**
  * Pure ScriptProject mutations.
@@ -593,4 +630,4 @@ declare function DeleteConfirmButton({ onConfirm, disabled, targetScope, title,
     description?: string;
 }): react.JSX.Element;
 
-export { type AgentAdapter, type AssetAdapter, type AssetDeleteRequest, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffAdapter, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, Popover, type SaveStatus, type Scene, 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 ScriptSpeaker, type ScriptTargetKind, SelectField, type StateChange, type StudioSelection, type StudioSelectionFrom, type StudioSelectionOrigin, type TransitionPrompt, buildSelectionFrom, computeChangeSet, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, index as mutations, sceneChangeKey, selectionTargetKey, withOrigin };
+export { type AssetAdapter, type AssetDeleteRequest, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffAdapter, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, Popover, type SaveStatus, type Scene, 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, buildSelectionFrom, computeChangeSet, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, index as mutations, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };

package/dist/index.js

@@ -650,6 +650,7 @@ function CanvasTopBar({
 function SaveCapsule({
   saveStatus = "idle",
   diffCount = 0,
+  baselineStatus,
   canApplyDiff,
   onDiffPrev,
   onDiffNext,
@@ -677,6 +678,7 @@ function SaveCapsule({
       ] }),
       /* @__PURE__ */ jsx("span", { className: "lj-se-capsule-count", children: diffCount }),
       /* @__PURE__ */ jsx("span", { className: "lj-se-capsule-muted", children: "\u6539\u52A8" }),
+      baselineStatus === "memory" ? /* @__PURE__ */ jsx("span", { className: "lj-se-capsule-warn", title: "\u57FA\u7EBF\u4EC5\u5B58\u4E8E\u5185\u5B58,\u5237\u65B0\u9875\u9762\u4F1A\u4E22\u5931", children: "\u4EC5\u672C\u6B21" }) : null,
       onDiffPrev ? /* @__PURE__ */ jsx("button", { type: "button", className: "lj-se-capsule-nav", title: "\u4E0A\u4E00\u5904", onClick: onDiffPrev, children: /* @__PURE__ */ jsx(ChevronLeft, { className: "lj-se-ic-3", strokeWidth: 2.25 }) }) : null,
       onDiffNext ? /* @__PURE__ */ jsx("button", { type: "button", className: "lj-se-capsule-nav", title: "\u4E0B\u4E00\u5904", onClick: onDiffNext, children: /* @__PURE__ */ jsx(ChevronRight, { className: "lj-se-ic-3", strokeWidth: 2.25 }) }) : null,
       onRejectAll ? /* @__PURE__ */ jsx("button", { type: "button", className: "lj-se-capsule-reject", disabled: !canApplyDiff, onClick: onRejectAll, children: "\u5168\u90E8\u62D2\u7EDD" }) : null,
@@ -2919,6 +2921,7 @@ function ScriptStream({
   disabled,
   selection,
   changedSceneKeys,
+  sceneDiff,
   onEdit,
   onSelectionChange,
   onRequestAssetDelete
@@ -3060,22 +3063,48 @@ function ScriptStream({
             const scene = value.episodes?.[item.episodeIdx]?.scenes?.[item.sceneIdx];
             if (!scene) return null;
             const focused = selection.kind === "scene" && selection.episodeIdx === item.episodeIdx && selection.sceneIdx === item.sceneIdx;
-            const changed = changedSceneKeys?.has(`${item.episodeIdx}:${item.sceneId}`) ?? false;
-            return /* @__PURE__ */ jsx("div", { className: "lj-se-stream-row", "data-quote-source": true, children: /* @__PURE__ */ jsx("div", { className: cn("lj-se-paper-seg", paperEdge(item.key), changed && "is-changed"), children: /* @__PURE__ */ jsx(
-              SceneEditor,
-              {
-                episodeIndex: item.episodeIdx,
-                sceneIndex: item.sceneIdx,
-                scene,
-                maps,
-                format,
-                disabled,
-                focused,
-                onEdit,
-                onNavigateAsset: select,
-                onRequestAssetDelete
-              }
-            ) }) });
+            const diffKey = `${item.episodeIdx}:${item.sceneId}`;
+            const changed = changedSceneKeys?.has(diffKey) ?? false;
+            const diffKind = !disabled ? sceneDiff?.kindByKey.get(diffKey) : void 0;
+            return /* @__PURE__ */ jsx("div", { className: "lj-se-stream-row", "data-quote-source": true, children: /* @__PURE__ */ jsxs("div", { className: cn("lj-se-paper-seg", paperEdge(item.key), changed && "is-changed"), children: [
+              diffKind ? /* @__PURE__ */ jsxs("div", { className: "lj-se-scenediff", children: [
+                /* @__PURE__ */ jsx("span", { className: cn("lj-se-scenediff-tag", diffKind === "added" && "is-added"), children: diffKind === "added" ? "AI \u65B0\u589E" : "AI \u6539\u52A8" }),
+                /* @__PURE__ */ jsx("span", { className: "lj-se-scenediff-spacer" }),
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "lj-se-scenediff-reject",
+                    onClick: () => sceneDiff.onReject(item.episodeIdx, item.sceneIdx, item.sceneId),
+                    children: "\u62D2\u7EDD"
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "lj-se-scenediff-accept",
+                    onClick: () => sceneDiff.onAccept(item.episodeIdx, item.sceneId),
+                    children: "\u63A5\u53D7"
+                  }
+                )
+              ] }) : null,
+              /* @__PURE__ */ jsx(
+                SceneEditor,
+                {
+                  episodeIndex: item.episodeIdx,
+                  sceneIndex: item.sceneIdx,
+                  scene,
+                  maps,
+                  format,
+                  disabled,
+                  focused,
+                  onEdit,
+                  onNavigateAsset: select,
+                  onRequestAssetDelete
+                }
+              )
+            ] }) });
           }
           case "add-episode":
             if (disabled) return null;
@@ -3238,6 +3267,76 @@ function computeChangeSet(baseline, current) {
   const count = (title ? 1 : 0) + (worldview ? 1 : 0) + (style ? 1 : 0) + changedScenes.size + removedCount;
   return { title, worldview, style, changedScenes, removedCount, count };
 }
+function acceptSceneIntoBaseline(baseline, episodeId, episodeIdx, scene) {
+  const episodes = (baseline.episodes ?? []).slice();
+  const id = episodeId?.trim();
+  let ei = id ? episodes.findIndex((e) => e.episode_id?.trim() === id) : -1;
+  if (ei < 0) ei = episodeIdx >= 0 && episodeIdx < episodes.length ? episodeIdx : -1;
+  if (ei < 0) {
+    episodes.push({ episode_id: episodeId, scenes: [scene] });
+    return { ...baseline, episodes };
+  }
+  const ep = episodes[ei];
+  const scenes = (ep.scenes ?? []).slice();
+  const sid = (scene.scene_id ?? "").trim();
+  const si = sid ? scenes.findIndex((s) => (s.scene_id ?? "").trim() === sid) : -1;
+  if (si >= 0) scenes[si] = scene;
+  else scenes.push(scene);
+  episodes[ei] = { ...ep, scenes };
+  return { ...baseline, episodes };
+}
+function rejectSceneToBaseline(current, episodeIdx, sceneIdx, baselineScene) {
+  const episodes = (current.episodes ?? []).slice();
+  const ep = episodes[episodeIdx];
+  if (!ep) return current;
+  const scenes = (ep.scenes ?? []).slice();
+  if (sceneIdx < 0 || sceneIdx >= scenes.length) return current;
+  if (baselineScene) scenes[sceneIdx] = baselineScene;
+  else scenes.splice(sceneIdx, 1);
+  episodes[episodeIdx] = { ...ep, scenes };
+  return { ...current, episodes };
+}
+function findBaselineScene(baseline, episodeId, episodeIdx, sceneId) {
+  if (!baseline) return null;
+  const ep = matchEpisode(baseline.episodes, { episode_id: episodeId }, episodeIdx);
+  if (!ep) return null;
+  const sid = sceneId.trim();
+  if (!sid) return null;
+  return (ep.scenes ?? []).find((s) => (s.scene_id ?? "").trim() === sid) ?? null;
+}
+
+// src/reference.ts
+function asNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return null;
+}
+function asString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function selectionFromScriptReference(reference) {
+  const source = reference.source;
+  if (!source) return null;
+  const sourceKind = asString(source.kind);
+  const sourceId = asString(source.id);
+  if (sourceKind === "actor" && sourceId) return { kind: "actor", actorId: sourceId };
+  if (sourceKind === "location" && sourceId) return { kind: "location", locationId: sourceId };
+  if (sourceKind === "prop" && sourceId) return { kind: "prop", propId: sourceId };
+  const episodeIdx = asNumber(source.episodeIdx);
+  const sceneIdx = asNumber(source.sceneIdx);
+  if (episodeIdx !== null && sceneIdx !== null) {
+    return { kind: "scene", episodeIdx, sceneIdx };
+  }
+  if (episodeIdx !== null) return { kind: "episode", episodeIdx };
+  const field = asString(source.field);
+  if (field === "title" || field === "worldview" || field === "style") {
+    return { kind: "worldview" };
+  }
+  return null;
+}
 function QuoteLayer({
   containerRef,
   onAddChatReferences
@@ -3333,9 +3432,9 @@ function ScriptEditor({
   onUndo,
   onRedo,
   onEditingChange,
+  referenceFocusRequest,
   diff,
   asset,
-  agent,
   onAddChatReferences,
   onRequestAssetDelete
 }) {
@@ -3404,6 +3503,33 @@ function ScriptEditor({
     },
     [changedSelections, diffCursor, setSelection]
   );
+  const onAcceptScene = useCallback(
+    (episodeIdx, sceneId) => {
+      if (!diff?.onPatchBaseline) return;
+      const ep = value.episodes?.[episodeIdx];
+      const scene = ep?.scenes?.find((s) => (s.scene_id ?? "").trim() === sceneId.trim());
+      if (!scene) return;
+      diff.onPatchBaseline((prev) => acceptSceneIntoBaseline(prev, ep?.episode_id, episodeIdx, scene));
+    },
+    [diff, value]
+  );
+  const onRejectScene = useCallback(
+    (episodeIdx, sceneIdx, sceneId) => {
+      const ep = value.episodes?.[episodeIdx];
+      const base = findBaselineScene(diff?.baseline ?? null, ep?.episode_id, episodeIdx, sceneId);
+      onEdit((cur) => rejectSceneToBaseline(cur, episodeIdx, sceneIdx, base));
+    },
+    [diff, value, onEdit]
+  );
+  const sceneDiff = useMemo(
+    () => diff?.onPatchBaseline && changeSet.changedScenes.size > 0 ? { kindByKey: changeSet.changedScenes, onAccept: onAcceptScene, onReject: onRejectScene } : void 0,
+    [diff?.onPatchBaseline, changeSet, onAcceptScene, onRejectScene]
+  );
+  useEffect(() => {
+    if (!referenceFocusRequest) return;
+    const sel = selectionFromScriptReference(referenceFocusRequest.reference);
+    if (sel) setSelection(withOrigin(sel, "reference"));
+  }, [referenceFocusRequest, setSelection]);
   const contextLabel = buildContextLabel(value, selection);
   const returnTarget = resolveReturnTarget(value, selection);
   const rootClass = ["lj-se-root", dark ? "dark" : "", className].filter(Boolean).join(" ");
@@ -3415,6 +3541,7 @@ function ScriptEditor({
       disabled,
       selection,
       changedSceneKeys,
+      sceneDiff,
       onEdit,
       onSelectionChange: setSelection,
       onRequestAssetDelete
@@ -3451,6 +3578,7 @@ function ScriptEditor({
           {
             saveStatus,
             diffCount: diff ? changeSet.count : 0,
+            baselineStatus: diff?.baselineStatus,
             canApplyDiff: !!(diff?.onAcceptAll || diff?.onRejectAll),
             onDiffPrev: changedSelections.length > 0 ? () => navDiff(-1) : void 0,
             onDiffNext: changedSelections.length > 0 ? () => navDiff(1) : void 0,
@@ -3563,6 +3691,6 @@ __export(mutations_exports, {
   updateScenePropState: () => updateScenePropState
 });
 
-export { DeleteConfirmButton, EMPTY_SELECTION, EditableText, Popover, ScriptContentType, ScriptEditor, SelectField, buildSelectionFrom, computeChangeSet, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, mutations_exports as mutations, sceneChangeKey, selectionTargetKey, withOrigin };
+export { DeleteConfirmButton, EMPTY_SELECTION, EditableText, Popover, ScriptContentType, ScriptEditor, SelectField, buildSelectionFrom, computeChangeSet, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, mutations_exports as mutations, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map