@lingjingai/script-editor 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,596 @@
+import * as react from 'react';
+import { ReactElement, ReactNode } from 'react';
+
+declare enum ScriptContentType {
+    Action = "action",
+    Dialogue = "dialogue",
+    Narration = "narration",
+    InnerThought = "inner_thought"
+}
+interface SceneEnvironment {
+    space?: "exterior" | "interior" | string;
+    time?: "day" | "night" | "dawn" | "dusk" | string;
+}
+interface ScriptItem {
+    type?: ScriptContentType | string;
+    content?: string;
+    actor_id?: string;
+    speaker_id?: string;
+    speakers?: Array<{
+        speaker_id?: string;
+    }>;
+    delivery?: "single" | "simultaneous" | "overlap" | "group" | string;
+    lines?: Array<{
+        speaker_id?: string;
+        content?: string;
+    }>;
+    emotion?: string;
+    state_changes?: StateChange[];
+    transition_prompt?: TransitionPrompt;
+}
+interface AssetState {
+    state_id?: string;
+    state_name?: string;
+    name?: string;
+    description?: string;
+}
+type ScriptTargetKind = "actor" | "location" | "prop";
+interface StateChange {
+    target_kind?: ScriptTargetKind | string;
+    target_id?: string;
+    from_state_id?: string | null;
+    to_state_id?: string | null;
+    effective_from?: "before_action" | "after_action" | string;
+}
+interface TransitionPrompt {
+    target_kind?: ScriptTargetKind | string;
+    target_id?: string;
+    process?: string;
+    contrast?: string;
+}
+interface SceneContext {
+    actors?: Array<{
+        actor_id?: string;
+        state_id?: string | null;
+    }>;
+    locations?: Array<{
+        location_id?: string;
+        state_id?: string | null;
+    }>;
+    props?: Array<{
+        prop_id?: string;
+        state_id?: string | null;
+    }>;
+}
+interface Scene {
+    scene_id?: string;
+    environment?: SceneEnvironment;
+    location_ids?: string[];
+    context?: SceneContext;
+    actors?: Array<{
+        actor_id?: string;
+        state_id?: string | null;
+    }>;
+    locations?: Array<{
+        location_id?: string;
+        state_id?: string | null;
+    }>;
+    props?: Array<{
+        prop_id?: string;
+        state_id?: string | null;
+    }>;
+    actions?: ScriptItem[];
+}
+interface ScriptActor {
+    actor_id?: string;
+    actor_name?: string;
+    name?: string;
+    description?: string;
+    states?: AssetState[];
+}
+interface ScriptLocation {
+    location_id?: string;
+    location_name?: string;
+    name?: string;
+    description?: string;
+    states?: AssetState[];
+}
+interface ScriptProp {
+    prop_id?: string;
+    prop_name?: string;
+    name?: string;
+    description?: string;
+    states?: AssetState[];
+}
+interface ScriptEpisode {
+    episode_id?: string;
+    title?: string | null;
+    scenes?: Scene[];
+}
+interface ScriptSpeaker {
+    speaker_id?: string;
+    display_name?: string;
+    source_kind?: "actor" | "location" | "prop" | "system" | "broadcast" | "group" | "other" | string;
+    source_id?: string | null;
+    voice_desc?: string;
+}
+interface ScriptProject {
+    version?: number | string;
+    title?: string;
+    worldview?: string;
+    worldview_raw?: string;
+    style?: string;
+    actors?: ScriptActor[];
+    locations?: ScriptLocation[];
+    props?: ScriptProp[];
+    speakers?: ScriptSpeaker[];
+    episodes?: ScriptEpisode[];
+}
+type ScriptData = ScriptProject;
+
+/**
+ * Studio 页的选中状态。
+ * 剧集编辑是"一集一页"：episode 选中打开集页、scene 选中打开同集并滚到对应场。
+ */
+/**
+ * Studio 主工作区视图：
+ * - script  剧本写作（默认）
+ * - review  审片：分镜 / Prompt / 视频对照表
+ * - files   项目文件浏览器（不依赖剧集，由 StudioHeader 上的"文件"按钮切换）
+ *
+ * 历史上还有 storyboard / assets / prompt / video 等独立 tab，已合入 review。
+ */
+type EpisodeWorkspaceView = "script" | "review" | "files";
+/**
+ * 跨页跳转的来源标记。点击资产详情底部的"出现在 X 处"跳到 scene 时带上，
+ * 让目标页可以渲染"返回 XX"入口并把用户送回原资产。
+ */
+type StudioSelectionFrom = {
+    kind: "actor";
+    actorId: string;
+} | {
+    kind: "location";
+    locationId: string;
+} | {
+    kind: "prop";
+    propId: string;
+};
+/**
+ * selection 变化的驱动源。在 ScriptStream 中用于区分"该不该触发滚动"：
+ * - 'scroll'  来自滚动 spy（视口里出现新 item 自动上抛），收到时 ScriptStream 不再调 scrollToIndex
+ * - 'sidebar' / 'diff' / 'reference' / 'chat' / 'init' / 'episode-toggle'
+ *            来自人为/外部驱动，需要 ScriptStream 主动滚到目标 item
+ *
+ * 不打 origin 时按 'sidebar' 等价处理（保守滚动）。
+ */
+type StudioSelectionOrigin = "sidebar" | "scroll" | "reference" | "diff" | "chat" | "init" | "episode-toggle";
+declare function buildSelectionFrom(kind: StudioSelectionFrom["kind"], id: string): StudioSelectionFrom | undefined;
+declare function fromToSelection(from: StudioSelectionFrom): StudioSelection;
+/** 公共字段：所有 selection variant 都可携带（origin 防双向联动死循环；from 资产回链）。 */
+type SelectionMeta = {
+    origin?: StudioSelectionOrigin;
+};
+type SelectionMetaWithFrom = SelectionMeta & {
+    from?: StudioSelectionFrom;
+};
+type StudioSelection = (SelectionMeta & {
+    kind: "empty";
+}) | (SelectionMeta & {
+    kind: "worldview";
+}) | (SelectionMetaWithFrom & {
+    kind: "episode";
+    episodeIdx: number;
+}) | (SelectionMetaWithFrom & {
+    kind: "scene";
+    episodeIdx: number;
+    sceneIdx: number;
+}) | (SelectionMetaWithFrom & {
+    kind: "clip";
+    episodeIdx: number;
+    sceneIdx?: number;
+    sceneId: string;
+    clipId: string;
+}) | (SelectionMeta & {
+    kind: "actor";
+    actorId: string;
+}) | (SelectionMeta & {
+    kind: "location";
+    locationId: string;
+}) | (SelectionMeta & {
+    kind: "prop";
+    propId: string;
+});
+declare const EMPTY_SELECTION: StudioSelection;
+/** 把 selection 复制一份并打上 origin 标记。 */
+declare function withOrigin<T extends StudioSelection>(sel: T, origin: StudioSelectionOrigin): T;
+/**
+ * 一个 selection「目标」的稳定字符串 key（忽略 origin / from）。既用于 scroll 同步
+ * 去重，也是 isSameSelectionTarget 的唯一判定依据 —— 两者不再各写一套。
+ */
+declare function selectionTargetKey(s: StudioSelection): string;
+/** 判定两个 selection 是否指向同一个目标（忽略 origin / from）。 */
+declare function isSameSelectionTarget(a: StudioSelection, b: StudioSelection): boolean;
+declare function isSceneSelected(selection: StudioSelection, episodeIdx: number, sceneIdx: number): boolean;
+declare function isClipSelected(selection: StudioSelection, episodeIdx: number, sceneId: string, clipId: string): boolean;
+declare function getSelectionEpisodeIdx(selection: StudioSelection): number | null;
+/** 该剧集当前是否处于"打开"状态（集页或集内某场被选中）。 */
+declare function isEpisodeOpen(selection: StudioSelection, episodeIdx: number): boolean;
+
+declare function getActorMap(actors?: ScriptActor[]): Map<string, ScriptActor>;
+declare function getLocationMap(locations?: ScriptLocation[]): Map<string, ScriptLocation>;
+declare function getPropMap(props?: ScriptProp[]): Map<string, ScriptProp>;
+declare function getSpeakerMap(speakers?: ScriptSpeaker[]): Map<string, ScriptSpeaker>;
+/**
+ * Reconcile the dual context storage. The refs live in BOTH scene.context.*
+ * and the legacy mirror scene.* — prefer whichever has entries so an EMPTY
+ * `context.actors: []` (e.g. from a partial upstream payload) does NOT shadow a
+ * populated mirror (which would silently drop the scene's cast/props).
+ */
+declare function getSceneContext(scene: Scene): {
+    actors: {
+        actor_id?: string;
+        state_id?: string | null;
+    }[];
+    locations: {
+        location_id?: string;
+        state_id?: string | null;
+    }[];
+    props: {
+        prop_id?: string;
+        state_id?: string | null;
+    }[];
+};
+declare function getEpisodeTitle(episode: ScriptEpisode, index: number): string;
+
+interface SelectOption {
+    value: string;
+    label: string;
+}
+declare function SelectField({ value, options, onChange, disabled, title, placeholder, mono, className, style, emptyOptionLabel, }: {
+    value: string;
+    options: SelectOption[];
+    onChange: (next: string) => void;
+    disabled?: boolean;
+    title?: string;
+    placeholder?: string;
+    mono?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    /** shown as a leading disabled option when value is empty */
+    emptyOptionLabel?: string;
+}): react.JSX.Element;
+
+type ScriptFormat = "standard" | "asian";
+
+type SaveStatus = "idle" | "saving" | "saved" | "error";
+
+/**
+ * Coarse, pure diff between a baseline ScriptProject (pre-AI-revision) and the
+ * current one. Surfaces changed top-level fields and changed/added scenes so
+ * the overlay can show counts, navigate to changes, and accept/reject all.
+ * Scenes are matched by scene_id within an episode.
+ */
+
+interface FieldChange {
+    before: string;
+    after: string;
+}
+type SceneChangeKind = "added" | "modified";
+interface ChangeSet {
+    title?: FieldChange;
+    worldview?: FieldChange;
+    style?: FieldChange;
+    /** "epIdx:sceneId" → kind, for scenes present in the current value */
+    changedScenes: Map<string, SceneChangeKind>;
+    /** scenes present in baseline but gone from current */
+    removedCount: number;
+    /** total surfaced changes */
+    count: number;
+}
+declare function sceneChangeKey(episodeIdx: number, sceneId: string | undefined): string;
+declare function computeChangeSet(baseline: ScriptProject | null, current: ScriptProject): ChangeSet;
+
+interface AssetDeleteRequest {
+    kind: "actor" | "location" | "prop";
+    id: string;
+    name: string;
+    description?: string;
+    /** -1 when the request originates from the asset library card (no scene) */
+    episodeIndex: number;
+    sceneIndex: number;
+}
+
+/**
+ * Adapter contracts — business is injected here so the editor stays pure (no
+ * direct API/fetch). The host (apps/web) implements these against its own
+ * services (script-output, chat, asset generation, comments).
+ */
+
+/** AI revision overlay: host supplies the pre-revision baseline; editor diffs. */
+interface DiffAdapter {
+    /** the script as it was BEFORE the AI revision (null = no pending diff) */
+    baseline: ScriptProject | null;
+    /** accept all AI changes — host drops the baseline */
+    onAcceptAll?: () => void;
+    /** reject all AI changes — restore the baseline as the working value */
+    onRejectAll?: () => void;
+}
+/** Asset display + side-effecting generation/upload (kept in the host). */
+interface AssetAdapter {
+    /** opaque payload the host uses to render thumbnails / connect galleries */
+    payload?: unknown;
+    isConnected?: boolean;
+    /** trigger generation/upload for an asset state (host side-effect) */
+    postAction?: (action: {
+        kind: "actor" | "location" | "prop";
+        id: string;
+        stateId?: string | null;
+    }) => 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;
+    label: string;
+    text: string;
+}
+interface ScriptEditorAdapters {
+    diff?: DiffAdapter;
+    asset?: AssetAdapter;
+    agent?: AgentAdapter;
+    onAddChatReferences?: (refs: ChatReference[]) => void;
+    onRequestAssetDelete?: (target: AssetDeleteRequest) => void;
+}
+
+interface ScriptEditorProps extends ScriptEditorAdapters {
+    value: ScriptProject;
+    onEdit: (patch: (prev: ScriptProject) => ScriptProject) => void;
+    selection?: StudioSelection;
+    onSelectionChange?: (next: StudioSelection) => void;
+    format?: ScriptFormat;
+    onFormatChange?: (format: ScriptFormat) => void;
+    disabled?: boolean;
+    className?: string;
+    dark?: boolean;
+    saveStatus?: SaveStatus;
+    canUndo?: boolean;
+    canRedo?: boolean;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    /** fires true when an in-editor field opens for editing and false when the
+     *  last one closes — lets the host pause adopting external revisions without
+     *  reaching into the package's DOM / class names. */
+    onEditingChange?: (editing: boolean) => void;
+}
+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;
+
+/**
+ * Pure ScriptProject mutations.
+ *
+ * ⚠️ INVARIANT — every mutation here MUST be immutable: never write into an
+ * existing scene / item / array in place; always return fresh spread-copied
+ * objects along the path from the root to the change (see cloneEpisodes /
+ * withSceneUpdated). Two things silently depend on it:
+ *   1. diff-engine's `base === scene` fast path — it treats a scene that keeps
+ *      its baseline-snapshot reference as unchanged and skips serializing it; an
+ *      in-place edit would keep the reference and the change would vanish from
+ *      the diff overlay.
+ *   2. AssetCard / SceneEditor React.memo — they skip re-render when their slice
+ *      keeps the same reference; an in-place edit would render stale UI.
+ * If you add a mutation, return new objects — do NOT `scene.actions.push(...)`
+ * or `Object.assign(scene, …)`.
+ */
+
+interface SceneDraft {
+    sceneId: string;
+    location: string;
+    space: string;
+    time: string;
+    actors: string;
+}
+interface ItemDraft {
+    kind: "dialogue" | "action";
+    actorName: string;
+    emotion: string;
+    content: string;
+    actionType: string;
+}
+declare function getSceneActorsText(scene: Scene): string;
+declare function getPrimarySceneLocationId(scene: Scene): string;
+declare function buildSceneDraft(sceneId: string, fallbackSceneIndex: number): SceneDraft;
+declare function incrementSceneId(sceneId: string | undefined, fallbackEpisodeIndex: number, fallbackSceneIndex: number): string;
+declare function nextEpisodeSceneId(data: ScriptProject, episodeIndex: number): string;
+/**
+ * 基于 prev 递增，并在 existingScenes 里做冲突检测；若建议 id 已占用，继续递增直到不冲突。
+ * 上限 1000 次避免异常 id 格式引起死循环。
+ */
+declare function nextAvailableSceneId(prevSceneId: string | undefined, existingScenes: Scene[], fallbackEpisodeIndex: number, fallbackSceneIndex: number): string;
+declare function decrementSceneId(sceneId: string | undefined, fallbackEpisodeIndex: number, fallbackSceneIndex: number): string;
+declare function createSceneFromDraft(draft: SceneDraft): Scene;
+declare function createItemFromDraft(draft: ItemDraft): ScriptItem;
+declare function updateSceneField(data: ScriptProject, episodeIndex: number, sceneIndex: number, field: "scene_id" | "space" | "time" | "location" | "actors" | "props", value: string): ScriptProject;
+declare function updateSceneActorState(data: ScriptProject, episodeIndex: number, sceneIndex: number, actorId: string, stateId: string | null): ScriptProject;
+declare function updateSceneLocationState(data: ScriptProject, episodeIndex: number, sceneIndex: number, locationId: string, stateId: string | null): ScriptProject;
+declare function updateScenePropState(data: ScriptProject, episodeIndex: number, sceneIndex: number, propId: string, stateId: string | null): ScriptProject;
+declare function updateSceneItemContent(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number, content: string): ScriptProject;
+declare function updateSceneItemActor(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number, actorId: string): ScriptProject;
+declare function updateSceneItemEmotion(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number, emotion: string): ScriptProject;
+declare function replaceSceneItem(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number, item: ScriptItem): ScriptProject;
+/**
+ * Append a new (empty) episode at the end, or insert at `atIndex`. The new
+ * episode starts with no scenes — the empty-episode affordance lets the user
+ * add the first scene.
+ */
+declare function addEpisode(data: ScriptProject, atIndex?: number): ScriptProject;
+/** Append a fresh blank scene to an episode (used by the empty-episode CTA). */
+declare function addBlankScene(data: ScriptProject, episodeIndex: number): ScriptProject;
+declare function insertScene(data: ScriptProject, episodeIndex: number, sceneIndex: number, scene: Scene): ScriptProject;
+declare function splitScene(data: ScriptProject, episodeIndex: number, sceneIndex: number, splitAtItemIndex: number): ScriptProject;
+/**
+ * 把 sceneIndex 对应的场并入 sceneIndex - 1。
+ * - actions 顺序拼接
+ * - actors / locations / props 按 id 去重合并（保留前场已有的 state_id）
+ * - 保留前场 scene_id 和 environment
+ * - **不再**对后续 scene_id 链式 -1：下游（video_map / asset state / 参考素材目录等）按
+ *   scene_id 做主键，扰动 scene_id 会让已生成资产 / 视频孤立，代价远大于"id 连续"的收益。
+ * - sceneIndex <= 0 时无效，返回原 data
+ */
+declare function mergeSceneIntoPrev(data: ScriptProject, episodeIndex: number, sceneIndex: number): ScriptProject;
+declare function deleteScene(data: ScriptProject, episodeIndex: number, sceneIndex: number): ScriptProject;
+declare function insertSceneItem(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number, item: ScriptItem): ScriptProject;
+declare function deleteSceneItem(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number): ScriptProject;
+/**
+ * Reorder a row within a scene: pull the item at `fromIndex` out and re-insert
+ * it so it lands at insertion slot `toIndex` (0..length). No-op when the move
+ * wouldn't change order.
+ */
+declare function moveSceneItem(data: ScriptProject, episodeIndex: number, sceneIndex: number, fromIndex: number, toIndex: number): ScriptProject;
+interface ItemLocation {
+    episodeIndex: number;
+    sceneIndex: number;
+    itemIndex: number;
+}
+/**
+ * Move a row to a target insertion slot, within the same scene OR across
+ * scenes. Cross-scene moves pull the item from the source scene's actions and
+ * splice it into the target scene's actions (the row's actor/emotion/etc. ride
+ * along unchanged). scene_id is never touched.
+ */
+declare function moveScriptItem(data: ScriptProject, from: ItemLocation, to: {
+    episodeIndex: number;
+    sceneIndex: number;
+    slot: number;
+}): ScriptProject;
+/** Remove an entire episode. */
+declare function deleteEpisode(data: ScriptProject, episodeIndex: number): ScriptProject;
+
+/**
+ * 切换某条行的 type，静默清理不相关字段：
+ * - 切到 dialogue / inner_thought：保留或继承 actor_id
+ * - 切到非人物行：删 actor_id / emotion
+ * - 切到 inner_thought：删 dialogue 专用的 emotion
+ */
+declare function updateSceneItemType(data: ScriptProject, episodeIndex: number, sceneIndex: number, itemIndex: number, type: ScriptContentType): ScriptProject;
+/**
+ * 为 TypePicker 选完类型后构建一条空 item。新建对白/心声时可继承上一条人物行。
+ */
+declare function buildNewScriptItem(type: ScriptContentType, inheritedActorId?: string): ScriptItem;
+/**
+ * 从 scene.actions 中取距离 beforeIndex 最近的上一条对白/心声 actor_id，没有则返回空串。
+ */
+declare function pickInheritedActorId(scene: Scene, beforeIndex: number): string;
+
+/**
+ * Pure mutations for the entity dictionary (actors / locations / props) and
+ * their asset states. Operate directly on ScriptProject; identity-preserving
+ * for untouched entries.
+ */
+
+type EntityKind = "actor" | "location" | "prop";
+declare function updateEntityName(data: ScriptProject, kind: EntityKind, id: string, name: string): ScriptProject;
+declare function updateEntityDescription(data: ScriptProject, kind: EntityKind, id: string, description: string): ScriptProject;
+declare function updateEntityStateField(data: ScriptProject, kind: EntityKind, id: string, stateId: string, field: "state_name" | "description", value: string): ScriptProject;
+declare function addEntityState(data: ScriptProject, kind: EntityKind, id: string, state: AssetState): ScriptProject;
+declare function removeEntityState(data: ScriptProject, kind: EntityKind, id: string, stateId: string): ScriptProject;
+
+type index_EntityKind = EntityKind;
+type index_ItemDraft = ItemDraft;
+type index_ItemLocation = ItemLocation;
+type index_SceneDraft = SceneDraft;
+declare const index_addBlankScene: typeof addBlankScene;
+declare const index_addEntityState: typeof addEntityState;
+declare const index_addEpisode: typeof addEpisode;
+declare const index_buildNewScriptItem: typeof buildNewScriptItem;
+declare const index_buildSceneDraft: typeof buildSceneDraft;
+declare const index_createItemFromDraft: typeof createItemFromDraft;
+declare const index_createSceneFromDraft: typeof createSceneFromDraft;
+declare const index_decrementSceneId: typeof decrementSceneId;
+declare const index_deleteEpisode: typeof deleteEpisode;
+declare const index_deleteScene: typeof deleteScene;
+declare const index_deleteSceneItem: typeof deleteSceneItem;
+declare const index_getPrimarySceneLocationId: typeof getPrimarySceneLocationId;
+declare const index_getSceneActorsText: typeof getSceneActorsText;
+declare const index_incrementSceneId: typeof incrementSceneId;
+declare const index_insertScene: typeof insertScene;
+declare const index_insertSceneItem: typeof insertSceneItem;
+declare const index_mergeSceneIntoPrev: typeof mergeSceneIntoPrev;
+declare const index_moveSceneItem: typeof moveSceneItem;
+declare const index_moveScriptItem: typeof moveScriptItem;
+declare const index_nextAvailableSceneId: typeof nextAvailableSceneId;
+declare const index_nextEpisodeSceneId: typeof nextEpisodeSceneId;
+declare const index_pickInheritedActorId: typeof pickInheritedActorId;
+declare const index_removeEntityState: typeof removeEntityState;
+declare const index_replaceSceneItem: typeof replaceSceneItem;
+declare const index_splitScene: typeof splitScene;
+declare const index_updateEntityDescription: typeof updateEntityDescription;
+declare const index_updateEntityName: typeof updateEntityName;
+declare const index_updateEntityStateField: typeof updateEntityStateField;
+declare const index_updateSceneActorState: typeof updateSceneActorState;
+declare const index_updateSceneField: typeof updateSceneField;
+declare const index_updateSceneItemActor: typeof updateSceneItemActor;
+declare const index_updateSceneItemContent: typeof updateSceneItemContent;
+declare const index_updateSceneItemEmotion: typeof updateSceneItemEmotion;
+declare const index_updateSceneItemType: typeof updateSceneItemType;
+declare const index_updateSceneLocationState: typeof updateSceneLocationState;
+declare const index_updateScenePropState: typeof updateScenePropState;
+declare namespace index {
+  export { type index_EntityKind as EntityKind, type index_ItemDraft as ItemDraft, type index_ItemLocation as ItemLocation, type index_SceneDraft as SceneDraft, index_addBlankScene as addBlankScene, index_addEntityState as addEntityState, index_addEpisode as addEpisode, index_buildNewScriptItem as buildNewScriptItem, index_buildSceneDraft as buildSceneDraft, index_createItemFromDraft as createItemFromDraft, index_createSceneFromDraft as createSceneFromDraft, index_decrementSceneId as decrementSceneId, index_deleteEpisode as deleteEpisode, index_deleteScene as deleteScene, index_deleteSceneItem as deleteSceneItem, index_getPrimarySceneLocationId as getPrimarySceneLocationId, index_getSceneActorsText as getSceneActorsText, index_incrementSceneId as incrementSceneId, index_insertScene as insertScene, index_insertSceneItem as insertSceneItem, index_mergeSceneIntoPrev as mergeSceneIntoPrev, index_moveSceneItem as moveSceneItem, index_moveScriptItem as moveScriptItem, index_nextAvailableSceneId as nextAvailableSceneId, index_nextEpisodeSceneId as nextEpisodeSceneId, index_pickInheritedActorId as pickInheritedActorId, index_removeEntityState as removeEntityState, index_replaceSceneItem as replaceSceneItem, index_splitScene as splitScene, index_updateEntityDescription as updateEntityDescription, index_updateEntityName as updateEntityName, index_updateEntityStateField as updateEntityStateField, index_updateSceneActorState as updateSceneActorState, index_updateSceneField as updateSceneField, index_updateSceneItemActor as updateSceneItemActor, index_updateSceneItemContent as updateSceneItemContent, index_updateSceneItemEmotion as updateSceneItemEmotion, index_updateSceneItemType as updateSceneItemType, index_updateSceneLocationState as updateSceneLocationState, index_updateScenePropState as updateScenePropState };
+}
+
+/**
+ * 角色对话名色板：按 actor_id 稳定 hash 到 8 色之一。
+ * 色板定义在 globals.css 的 --actor-cue-1..8（亮/暗各一份），
+ * 已调过亮度与饱和度，保证在牛皮纸底色上可读且互相错开。
+ *
+ * 没有 actor_id 时退回 --paper-cue-dialogue / --paper-cue-inner。
+ */
+declare function getActorCueVar(actorId: string | null | undefined, tone?: "dialogue" | "inner"): string;
+
+interface EditableTextProps {
+    value: string;
+    onSave: (next: string) => void;
+    placeholder?: string;
+    /** multiline → <textarea> (auto-grow); else single-line <input>. */
+    multiline?: boolean;
+    disabled?: boolean;
+    className?: string;
+    /** start in edit mode + focus (for newly inserted rows) */
+    autoEdit?: boolean;
+    /** fires whenever edit mode is left (commit OR cancel) — lets the parent
+     *  clear a one-shot autoEdit flag so a later row reshuffle can't re-trigger it. */
+    onEditEnd?: () => void;
+    /** forwarded to the display span (e.g. data-quote-target) */
+    spanProps?: React.HTMLAttributes<HTMLSpanElement>;
+}
+declare function EditableText({ value, onSave, placeholder, multiline, disabled, className, autoEdit, onEditEnd, spanProps, }: EditableTextProps): ReactElement;
+
+interface PopoverProps {
+    trigger: (args: {
+        open: boolean;
+        toggle: () => void;
+    }) => ReactNode;
+    children: (args: {
+        close: () => void;
+    }) => ReactNode;
+    align?: "start" | "center" | "end";
+    side?: "bottom" | "top";
+    className?: string;
+    panelClassName?: string;
+}
+declare function Popover({ trigger, children, align, side, className, panelClassName, }: PopoverProps): react.JSX.Element;
+
+declare function DeleteConfirmButton({ onConfirm, disabled, targetScope, title, }: {
+    onConfirm: () => void | Promise<void>;
+    disabled?: boolean;
+    /** drives the parent's hover-tint via data-delete-target */
+    targetScope?: "row" | "scene";
+    title?: string;
+    /** legacy prop, no longer rendered (kept for call-site compat) */
+    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 };