@lingjingai/script-editor 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -265,6 +265,15 @@ declare function getSceneContext(scene: Scene): {
         state_id?: string | null;
     }[];
 };
+/**
+ * Count how many scenes each asset appears in (its scene-cast / location / prop
+ * refs), in one pass. Drives the TOC's "出现次数" sort. v3-aware via getSceneContext.
+ */
+declare function countAssetAppearances(data: ScriptProject): {
+    actors: Map<string, number>;
+    locations: Map<string, number>;
+    props: Map<string, number>;
+};
 declare function getEpisodeTitle(episode: ScriptEpisode, index: number): string;
 
 interface SelectOption {
@@ -289,6 +298,27 @@ type ScriptFormat = "standard" | "asian";
 
 type SaveStatus = "idle" | "saving" | "saved" | "error";
 
+/**
+ * Flattens a ScriptProject into ONE continuous, stable-keyed item list for the
+ * virtualized stream — mirroring agent-frontend's single global scroll:
+ *   each episode (episode-header → scene → scene → …)
+ *   → asset groups (角色 / 场景 / 道具: group-header → asset-card × N)
+ * Plus selection ↔ flatIndex lookups (two-way) for scroll/scrollspy sync.
+ * (世界观 & 风格 is edited in a dialog now, not inline — see ScriptEditor.)
+ */
+
+type AssetGroup = "actors" | "locations" | "props";
+/** An asset as seen by `assetSort` — enough to reproduce any TOC ordering
+ *  (by name / importance / appearance count) host-side. */
+interface AssetSortItem {
+    group: AssetGroup;
+    id: string;
+    name: string;
+    importance?: string;
+    /** appearance count (scenes referencing this asset). */
+    count: number;
+}
+
 /**
  * Reference focus — the INVERSE of "quote to chat". The host pushes a
  * ScriptReferenceFocusRequest (e.g. when a chat message / comment that quotes
@@ -563,6 +593,23 @@ interface ScriptEditorProps extends ScriptEditorAdapters {
     /** the floating bottom-center capsule (save status + AI-diff + 返回 breadcrumb).
      *  Default true. Set false for a pure display surface with no floating chrome. */
     showSaveCapsule?: boolean;
+    /** per-action hover (target on enter, null on leave) — pair with `highlights`
+     *  to build a hover-to-highlight effect entirely host-side. */
+    onActionHover?: (target: {
+        episodeIdx: number;
+        sceneId: string;
+        actionIndex: number;
+    } | null) => void;
+    /** per-action click, with full address. */
+    onActionClick?: (target: {
+        episodeIdx: number;
+        sceneId: string;
+        actionIndex: number;
+    }) => void;
+    /** order assets within each group in the preview (角色/场景/道具). Feed the SAME
+     *  comparator your TOC uses so the left nav and right preview stay in lockstep.
+     *  Omit → script.json array order. */
+    assetSort?: (a: AssetSortItem, b: AssetSortItem) => number;
 }
 /** A host range highlight targeting one action (same coords as DiffActionMark). */
 interface ScriptHighlight {
@@ -574,7 +621,7 @@ interface ScriptHighlight {
     className?: string;
     style?: React.CSSProperties;
 }
-declare function ScriptEditor({ value, onEdit: onEditProp, selection: controlledSelection, onSelectionChange, format: controlledFormat, onFormatChange, disabled, className, dark, toc, onTitleChange, topBarActions, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, referenceFocusRequest, scrollScopeKey, showAssets, showTitle, showFormatToggle, paper, showTimestamp, highlights, contentWidth, showSaveCapsule, diff, asset, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
+declare function ScriptEditor({ value, onEdit: onEditProp, selection: controlledSelection, onSelectionChange, format: controlledFormat, onFormatChange, disabled, className, dark, toc, onTitleChange, topBarActions, saveStatus, canUndo, canRedo, onUndo, onRedo, onEditingChange, referenceFocusRequest, scrollScopeKey, showAssets, showTitle, showFormatToggle, paper, showTimestamp, highlights, contentWidth, showSaveCapsule, onActionHover, onActionClick, assetSort, diff, asset, onAddChatReferences, onRequestAssetDelete, }: ScriptEditorProps): react.JSX.Element;
 
 /**
  * Action timestamps live at `action.extend.timestamp` as an in-episode
@@ -885,4 +932,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, type Importance, type ParsedTimestamp, 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 ScriptHighlight, 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, type V3Speaker, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, formatTimestamp, 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 AssetSortItem, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffActionMark, type DiffAdapter, type DiffSceneMark, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, type Importance, type ParsedTimestamp, 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 ScriptHighlight, 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, type V3Speaker, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, countAssetAppearances, findBaselineScene, formatTimestamp, 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

@@ -618,6 +618,29 @@ function StudioToc({
     )
   ] });
 }
+function TocLabel({ text, className }) {
+  const ref = useRef(null);
+  const [tip, setTip] = useState(null);
+  const onEnter = () => {
+    const el = ref.current;
+    if (!el || el.scrollWidth <= el.clientWidth) return;
+    const r = el.getBoundingClientRect();
+    setTip({ x: r.right, y: r.top + r.height / 2 });
+  };
+  return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+    /* @__PURE__ */ jsx(
+      "span",
+      {
+        ref,
+        className,
+        onMouseEnter: onEnter,
+        onMouseLeave: () => setTip(null),
+        children: text
+      }
+    ),
+    tip ? /* @__PURE__ */ jsx("span", { className: "lj-se-toc-tip", style: { left: tip.x, top: tip.y }, role: "tooltip", children: text }) : null
+  ] });
+}
 function EntityGroup({
   icon: Icon,
   label,
@@ -641,7 +664,7 @@ function EntityGroup({
       onClick: () => onPick(i.id),
       children: [
         /* @__PURE__ */ jsx(Icon, { className: "lj-se-tocitem-icon lj-se-ic-3", strokeWidth: 1.5 }),
-        /* @__PURE__ */ jsx("span", { className: "lj-se-tocitem-label", children: i.name }),
+        /* @__PURE__ */ jsx(TocLabel, { className: "lj-se-tocitem-label", text: i.name }),
         i.count > 0 ? /* @__PURE__ */ jsx("span", { className: "lj-se-tocitem-meta", children: i.count }) : null
       ]
     },
@@ -2650,6 +2673,8 @@ function SceneEditorImpl({
   actionDiff,
   showTimestamp = false,
   highlights,
+  onActionHover,
+  onActionClick,
   onEdit,
   onNavigateAsset,
   onRequestAssetDelete
@@ -2657,6 +2682,7 @@ function SceneEditorImpl({
   const [pendingEdit, setPendingEdit] = useState(null);
   const { actorMap, speakerMap, locationMap, propMap } = maps;
   const actions = scene.actions ?? [];
+  const sceneId = scene.scene_id ?? "";
   const actorOptions = useMemo(() => {
     const out = [];
     for (const a of actorMap.values()) {
@@ -2769,6 +2795,9 @@ function SceneEditorImpl({
               style: hl?.style,
               onDragOver: (e) => onSlotDragOver(e, idx),
               onDrop: onSlotDrop,
+              onMouseEnter: onActionHover ? () => onActionHover({ episodeIdx: episodeIndex, sceneId, actionIndex: idx }) : void 0,
+              onMouseLeave: onActionHover ? () => onActionHover(null) : void 0,
+              onClick: onActionClick ? () => onActionClick({ episodeIdx: episodeIndex, sceneId, actionIndex: idx }) : void 0,
               children: [
                 ts ? /* @__PURE__ */ jsx("span", { className: "lj-se-ts", title: ts.full, children: ts.mmss }) : null,
                 mark ? /* @__PURE__ */ jsx(
@@ -2906,6 +2935,20 @@ function buildFlatStream(data, opts = {}) {
       { group: "locations", ids: (data.locations ?? []).map((l, i) => safeId(l.location_id, `__idx:${i}`)) },
       { group: "props", ids: (data.props ?? []).map((p, i) => safeId(p.prop_id, `__idx:${i}`)) }
     ];
+    if (opts.assetSort) {
+      const counts = countAssetAppearances(data);
+      const actorMap = getActorMap(data.actors ?? []);
+      const locationMap = getLocationMap(data.locations ?? []);
+      const propMap = getPropMap(data.props ?? []);
+      const enrich = (group, id) => {
+        if (group === "actors") return { group, id, name: getActorDisplayName(actorMap.get(id)) || id, importance: actorMap.get(id)?.importance, count: counts.actors.get(id) ?? 0 };
+        if (group === "locations") return { group, id, name: getLocationDisplayName(locationMap.get(id)) || id, importance: locationMap.get(id)?.importance, count: counts.locations.get(id) ?? 0 };
+        return { group, id, name: getPropDisplayName(propMap.get(id)) || id, importance: propMap.get(id)?.importance, count: counts.props.get(id) ?? 0 };
+      };
+      for (const spec of specs) {
+        spec.ids = spec.ids.map((id) => enrich(spec.group, id)).sort(opts.assetSort).map((it) => it.id);
+      }
+    }
     for (const { group, ids } of specs) {
       push({ key: `asset-group:${group}`, kind: "asset-group-header", group });
       ids.forEach((assetId) => push({ key: `asset:${group}:${assetId}`, kind: "asset-card", group, assetId }));
@@ -3653,14 +3696,17 @@ function ScriptStream({
   onRejectAction,
   scrollScopeKey,
   includeAssets = true,
+  assetSort,
   paper = true,
   showTimestamp = false,
   highlights,
+  onActionHover,
+  onActionClick,
   onEdit,
   onSelectionChange,
   onRequestAssetDelete
 }) {
-  const stream = useMemo(() => buildFlatStream(value, { includeAssets }), [value, includeAssets]);
+  const stream = useMemo(() => buildFlatStream(value, { includeAssets, assetSort }), [value, includeAssets, assetSort]);
   const highlightsByScene = useMemo(() => {
     const m = /* @__PURE__ */ new Map();
     for (const h of highlights ?? []) {
@@ -3857,6 +3903,8 @@ function ScriptStream({
                   focused,
                   showTimestamp,
                   highlights: highlightsByScene.get(diffKey),
+                  onActionHover,
+                  onActionClick,
                   onEdit,
                   onNavigateAsset: select,
                   onRequestAssetDelete
@@ -4628,6 +4676,9 @@ function ScriptEditor({
   highlights,
   contentWidth,
   showSaveCapsule = true,
+  onActionHover,
+  onActionClick,
+  assetSort,
   diff,
   asset,
   onAddChatReferences,
@@ -4789,9 +4840,12 @@ function ScriptEditor({
       onRejectAction: diff?.onRejectAction,
       scrollScopeKey,
       includeAssets: showAssets,
+      assetSort,
       paper,
       showTimestamp,
       highlights: streamHighlights,
+      onActionHover,
+      onActionClick,
       onEdit,
       onSelectionChange: setSelection,
       onRequestAssetDelete
@@ -5063,6 +5117,6 @@ function DeleteConfirmButton({
   );
 }
 
-export { DeleteConfirmButton, EMPTY_SELECTION, EditableText, Popover, ScriptContentType, ScriptEditor, SelectField, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, formatTimestamp, 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, countAssetAppearances, findBaselineScene, formatTimestamp, 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