@lingjingai/script-editor 0.1.1 → 0.1.14

package/INTEGRATION.md

@@ -67,7 +67,7 @@ function Host({ script, setScript }) {
 
 **HUD(顶栏)**
 - `saveStatus`：`"idle" | "saving" | "saved" | "error"`
-- `canUndo` / `canRedo` / `onUndo` / `onRedo`
+- `canUndo` / `canRedo` / `onUndo` / `onRedo` —— **Cmd/Ctrl+Z 撤销、Cmd/Ctrl+Shift+Z(或 Ctrl+Y)重做 已内建**(输入框内放行原生撤回),宿主**不要再自己接键盘监听**,否则会双触发(撤销两步)。`0.1.2+`
 
 **编辑信号**
 - `onEditingChange(editing: boolean)`：有外部改稿(AI / 协同)时,用它在"正编辑某字段"期间暂停采纳远端,避免覆盖。见 §6。

package/dist/index.d.ts

@@ -306,6 +306,14 @@ interface FieldChange {
     after: string;
 }
 type SceneChangeKind = "added" | "modified";
+/** A host-flagged changed scene the editor should render (highlight + per-scene
+ *  accept/reject). The host decides WHICH scenes are marked (provenance: e.g.
+ *  only agent-changed scenes, not the user's own manual edits). */
+interface DiffSceneMark {
+    episodeIdx: number;
+    sceneId: string;
+    kind: SceneChangeKind;
+}
 interface ChangeSet {
     title?: FieldChange;
     worldview?: FieldChange;
@@ -319,6 +327,78 @@ interface ChangeSet {
 }
 declare function sceneChangeKey(episodeIdx: number, sceneId: string | undefined): string;
 declare function computeChangeSet(baseline: ScriptProject | null, current: ScriptProject): ChangeSet;
+/** Convert a ChangeSet's changed-scene map into the editor's DiffSceneMark[]
+ *  (the `diff.scenes` render descriptor). Keys are `${episodeIdx}:${sceneId}`. */
+declare function changeSetToDiffScenes(changeSet: ChangeSet): DiffSceneMark[];
+/** Convenience for hosts using the simple "baseline vs current" diff model:
+ *  returns the render-descriptor data (scenes + counts) the `diff` adapter wants.
+ *  Hosts wanting provenance (user vs agent) compute `scenes` themselves instead. */
+declare function buildDiffFromBaseline(baseline: ScriptProject | null, current: ScriptProject): {
+    scenes: DiffSceneMark[];
+    removedCount: number;
+    count: number;
+};
+/** PER-SCENE ACCEPT — return a baseline patched so its matching scene equals
+ *  `scene` (the current version), dropping just that scene from the diff. Matches
+ *  the episode by episode_id (fallback index) and the scene by scene_id; inserts
+ *  when the baseline lacked it (an added scene). Immutable. */
+declare function acceptSceneIntoBaseline(baseline: ScriptProject, episodeId: string | undefined, episodeIdx: number, scene: Scene): ScriptProject;
+/** PER-SCENE REJECT — return current with the scene at (episodeIdx, sceneIdx)
+ *  reverted to its baseline version, or removed if it was added (no baseline
+ *  counterpart). Immutable. */
+declare function rejectSceneToBaseline(current: ScriptProject, episodeIdx: number, sceneIdx: number, baselineScene: Scene | null): ScriptProject;
+/** Look up the baseline scene matching (episodeId/idx, sceneId), or null. */
+declare function findBaselineScene(baseline: ScriptProject | null, episodeId: string | undefined, episodeIdx: number, sceneId: string): Scene | null;
+/** One changed action (line) the editor renders: highlight + ✓/✗.
+ *  - added/modified: `itemIdx` is the index in the CURRENT scene.
+ *  - removed: `itemIdx` is the position the ghost row sits BEFORE in the current list.
+ *  `item` is the OLD baseline action (set for "modified" and "removed") so the
+ *  editor can render the deleted line above the new one (unified-diff view). */
+interface DiffActionMark {
+    episodeIdx: number;
+    sceneId: string;
+    kind: "added" | "modified" | "removed";
+    itemIdx: number;
+    baselineItemIdx?: number;
+    item?: ScriptItem;
+}
+interface SceneActionDiff {
+    changed: Array<{
+        itemIdx: number;
+        kind: "added" | "modified";
+        baselineItemIdx?: number;
+    }>;
+    removed: Array<{
+        beforeItemIdx: number;
+        baselineItemIdx: number;
+    }>;
+}
+/** LCS-align two action lists → per-line added / modified / removed. Adjacent
+ *  delete+insert runs are paired as "modified" (so an in-place line edit shows
+ *  as one modified row, not remove+add); LCS keeps insertions from shifting all
+ *  following lines into false "modified"s. */
+declare function computeSceneActionDiff(baseline: ScriptItem[], current: ScriptItem[]): SceneActionDiff;
+/** Apply an action ACCEPT onto a baseline scene (returns a new scene): the
+ *  baseline catches up to current for that line, so it stops being a diff. */
+declare function applyActionAccept(baselineScene: Scene, currentScene: Scene, mark: DiffActionMark): Scene;
+/** Apply an action REJECT onto a current scene (returns a new scene): the
+ *  working value reverts to the baseline for that line (or drops an added line /
+ *  restores a removed one). */
+declare function applyActionReject(currentScene: Scene, baselineScene: Scene | null, mark: DiffActionMark): Scene;
+/** Project-level action ACCEPT — advance the baseline for one line. Thin for
+ *  hosts: `patchBaseline(prev => acceptActionIntoBaseline(prev, current, mark))`. */
+declare function acceptActionIntoBaseline(baseline: ScriptProject, current: ScriptProject, mark: DiffActionMark): ScriptProject;
+/** Project-level action REJECT — revert the working value for one line. Thin:
+ *  `onEdit(cur => rejectActionToBaseline(cur, baseline, mark))`. */
+declare function rejectActionToBaseline(current: ScriptProject, baseline: ScriptProject | null, mark: DiffActionMark): ScriptProject;
+/** Convenience for the simple baseline model: full action-level descriptor data
+ *  (whole-scene marks for added scenes; per-line marks for modified scenes). */
+declare function buildActionDiff(baseline: ScriptProject | null, current: ScriptProject): {
+    scenes: DiffSceneMark[];
+    actions: DiffActionMark[];
+    removedCount: number;
+    count: number;
+};
 
 interface AssetDeleteRequest {
     kind: "actor" | "location" | "prop";
@@ -336,22 +416,40 @@ interface AssetDeleteRequest {
  * services (script-output, chat, asset generation, comments).
  */
 
-/** AI revision overlay: host supplies the pre-revision baseline; editor diffs. */
+/**
+ * Diff overlay — a pure RENDER descriptor. The editor does NOT compute the diff;
+ * the HOST decides which scenes count as changed (provenance: e.g. only the
+ * agent's edits, not the user's manual ones — see `buildDiffFromBaseline` /
+ * `changeSetToDiffScenes` for the simple baseline model, or compute it yourself)
+ * and supplies the accept/reject side-effects. The editor highlights the marked
+ * scenes, shows per-scene + all accept/reject affordances, and the change count.
+ */
 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. */
+    /** WHOLE-scene marks (e.g. a brand-new scene) — editor highlights the whole
+     *  scene + offers scene-level accept/reject */
+    scenes: DiffSceneMark[];
+    /** ACTION-level marks (added / modified / removed lines within a scene) —
+     *  editor highlights those rows, renders ghost rows for removed, and offers
+     *  per-line accept/reject. A scene appears in `scenes` OR has entries here. */
+    actions?: DiffActionMark[];
+    /** scenes removed vs the host's baseline — shown only as a count (the editor
+     *  can't render scenes absent from `value`) */
+    removedCount?: number;
+    /** capsule total; defaults to `scenes.length + (removedCount ?? 0)` */
+    count?: number;
+    /** "memory" → baseline only in memory (lost on reload); shows a hint */
     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 */
+    /** accept one scene's change — host advances its baseline (resolves it) */
+    onAcceptScene?: (mark: DiffSceneMark) => void;
+    /** reject one scene's change — host reverts the working value to baseline */
+    onRejectScene?: (mark: DiffSceneMark) => void;
+    /** accept one line — host advances its baseline for that action */
+    onAcceptAction?: (mark: DiffActionMark) => void;
+    /** reject one line — host reverts the working value for that action */
+    onRejectAction?: (mark: DiffActionMark) => void;
+    /** accept everything */
     onAcceptAll?: () => void;
-    /** reject all AI changes — restore the baseline as the working value */
+    /** reject everything */
     onRejectAll?: () => void;
 }
 /** Asset display + side-effecting generation/upload (kept in the host). */
@@ -402,8 +500,11 @@ interface ScriptEditorProps extends ScriptEditorAdapters {
     /** 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;
+    /** stable per-scope key (e.g. projectGroupNo) — remembers & restores the
+     *  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, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, referenceFocusRequest, diff, asset, 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, scrollScopeKey, diff, asset, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
 
 /**
  * Pure ScriptProject mutations.
@@ -630,4 +731,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 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 };
+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 };