@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/domain/script/v4/patch/registry.js

@@ -0,0 +1,50 @@
+import { op_action_content_regex_replace, op_action_content_replace, op_action_actor_set, op_action_delete, op_action_insert, op_action_move, op_action_parenthetical_remove, op_action_parenthetical_set, op_action_transition_clear, op_action_transition_set, op_action_type_set, op_dialogue_speaker_set, } from "./ops-action.js";
+import { op_scene_ref_remove, op_scene_ref_set, } from "./ops-scene-ref.js";
+import { op_actor_add, op_asset_alias_add, op_asset_alias_remove, op_asset_alias_set, op_asset_delete, op_asset_describe, op_asset_merge, op_asset_rename, op_asset_role_set, op_importance_set, op_location_add, op_prop_add, op_state_add, op_state_describe, op_state_delete, op_state_rename, } from "./ops-asset.js";
+import { op_episode_add, op_episode_synopsis_set, op_meta_synopsis_set, op_meta_worldview_set, } from "./ops-meta.js";
+import { op_scene_delete, op_scene_insert, op_scene_merge, op_scene_move, op_scene_split, } from "./ops-structure.js";
+import { op_extend_clear, op_extend_set, } from "./ops-extend.js";
+export const V4_OP_REGISTRY = {
+    "action.parenthetical.set": op_action_parenthetical_set,
+    "action.parenthetical.remove": op_action_parenthetical_remove,
+    "action.content.replace": op_action_content_replace,
+    "action.content.regex-replace": op_action_content_regex_replace,
+    "action.type.set": op_action_type_set,
+    "action.actor.set": op_action_actor_set,
+    "action.delete": op_action_delete,
+    "action.insert": op_action_insert,
+    "action.move": op_action_move,
+    "action.transition.set": op_action_transition_set,
+    "action.transition.clear": op_action_transition_clear,
+    "dialogue.speaker.set": op_dialogue_speaker_set,
+    "scene.ref.set": op_scene_ref_set,
+    "scene.ref.remove": op_scene_ref_remove,
+    "actor.add": op_actor_add,
+    "location.add": op_location_add,
+    "prop.add": op_prop_add,
+    "state.add": op_state_add,
+    "state.rename": op_state_rename,
+    "state.describe": op_state_describe,
+    "state.delete": op_state_delete,
+    "asset.rename": op_asset_rename,
+    "asset.describe": op_asset_describe,
+    "asset.role.set": op_asset_role_set,
+    "asset.alias.set": op_asset_alias_set,
+    "asset.alias.add": op_asset_alias_add,
+    "asset.alias.remove": op_asset_alias_remove,
+    "asset.merge": op_asset_merge,
+    "asset.delete": op_asset_delete,
+    "importance.set": op_importance_set,
+    "episode.add": op_episode_add,
+    "episode.synopsis.set": op_episode_synopsis_set,
+    "meta.worldview.set": op_meta_worldview_set,
+    "meta.synopsis.set": op_meta_synopsis_set,
+    "scene.insert": op_scene_insert,
+    "scene.move": op_scene_move,
+    "scene.delete": op_scene_delete,
+    "scene.split": op_scene_split,
+    "scene.merge": op_scene_merge,
+    "extend.set": op_extend_set,
+    "extend.clear": op_extend_clear,
+};
+//# sourceMappingURL=registry.js.map

package/dist/domain/script/v4/patch/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../src/domain/script/v4/patch/registry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,cAAc,GAA0C;IACnE,0BAA0B,EAAE,2BAA2B;IACvD,6BAA6B,EAAE,8BAA8B;IAC7D,wBAAwB,EAAE,yBAAyB;IACnD,8BAA8B,EAAE,+BAA+B;IAC/D,iBAAiB,EAAE,kBAAkB;IACrC,kBAAkB,EAAE,mBAAmB;IACvC,eAAe,EAAE,gBAAgB;IACjC,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,uBAAuB,EAAE,wBAAwB;IACjD,yBAAyB,EAAE,0BAA0B;IACrD,sBAAsB,EAAE,uBAAuB;IAC/C,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,iBAAiB,EAAE,kBAAkB;IACrC,iBAAiB,EAAE,kBAAkB;IACrC,oBAAoB,EAAE,qBAAqB;IAC3C,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,aAAa,EAAE,cAAc;IAC7B,sBAAsB,EAAE,uBAAuB;IAC/C,oBAAoB,EAAE,qBAAqB;IAC3C,mBAAmB,EAAE,oBAAoB;IACzC,cAAc,EAAE,eAAe;IAC/B,YAAY,EAAE,aAAa;IAC3B,cAAc,EAAE,eAAe;IAC/B,aAAa,EAAE,cAAc;IAC7B,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,aAAa;IAC3B,cAAc,EAAE,eAAe;CAChC,CAAC"}

package/dist/domain/script/v4/patch/schema.d.ts

@@ -0,0 +1,7 @@
+export type V4PatchFieldType = "string" | "boolean" | "string[]" | "string|string[]" | "json";
+export interface V4PatchOpSchema {
+    required: string[];
+    optional: string[];
+    field_types: Readonly<Record<string, V4PatchFieldType>>;
+}
+export declare const V4_PATCH_OP_SCHEMA: Readonly<Record<string, V4PatchOpSchema>>;

package/dist/domain/script/v4/patch/schema.js

@@ -0,0 +1,75 @@
+function stringFields(...names) {
+    const fields = {};
+    for (const name of names)
+        fields[name] = "string";
+    return fields;
+}
+function defineSchema(required, optional = {}) {
+    return {
+        required: Object.keys(required),
+        optional: Object.keys(optional),
+        field_types: { ...required, ...optional },
+    };
+}
+export const V4_PATCH_OP_SCHEMA = {
+    "action.parenthetical.set": defineSchema(stringFields("at", "parenthetical")),
+    "action.parenthetical.remove": defineSchema(stringFields("at")),
+    "action.content.replace": defineSchema(stringFields("at", "from"), { ...stringFields("to"), all: "boolean" }),
+    "action.content.regex-replace": defineSchema(stringFields("at", "pattern"), { ...stringFields("to"), all: "boolean" }),
+    "action.type.set": defineSchema(stringFields("at", "type")),
+    "action.actor.set": defineSchema(stringFields("at", "actor_id"), stringFields("state_id")),
+    "action.delete": defineSchema(stringFields("at")),
+    "action.insert": defineSchema(stringFields("at", "action_id"), stringFields("type", "content", "parenthetical", "before", "after", "actor_id", "state_id", "kind", "label")),
+    "action.move": defineSchema(stringFields("at", "to"), stringFields("before", "after")),
+    "action.transition.set": defineSchema(stringFields("at", "target", "process", "contrast")),
+    "action.transition.clear": defineSchema(stringFields("at")),
+    "dialogue.speaker.set": defineSchema(stringFields("at"), stringFields("actor_id", "state_id", "kind", "label")),
+    "scene.ref.set": defineSchema({
+        ...stringFields("at", "target"),
+        state_ids: "string[]",
+    }),
+    "scene.ref.remove": defineSchema(stringFields("at", "target")),
+    "actor.add": defineSchema(stringFields("name", "actor_id"), { ...stringFields("role_type", "description", "importance"), aliases: "string[]" }),
+    "location.add": defineSchema(stringFields("name", "location_id"), stringFields("description", "importance")),
+    "prop.add": defineSchema(stringFields("name", "prop_id"), stringFields("description", "importance")),
+    "state.add": defineSchema(stringFields("target", "name", "state_id"), stringFields("description")),
+    "state.rename": defineSchema(stringFields("target", "name")),
+    "state.describe": defineSchema(stringFields("target", "description")),
+    "state.delete": defineSchema(stringFields("target", "strategy"), stringFields("replacement")),
+    "asset.rename": defineSchema(stringFields("target", "name")),
+    "asset.describe": defineSchema(stringFields("target", "description")),
+    "asset.role.set": defineSchema(stringFields("target", "role_type")),
+    "asset.alias.set": defineSchema({
+        ...stringFields("target"),
+        aliases: "string[]",
+    }),
+    "asset.alias.add": defineSchema({
+        ...stringFields("target"),
+        alias: "string|string[]",
+    }),
+    "asset.alias.remove": defineSchema({
+        ...stringFields("target"),
+        alias: "string|string[]",
+    }),
+    "asset.merge": defineSchema(stringFields("from", "into")),
+    "asset.delete": defineSchema(stringFields("target"), stringFields("strategy", "replacement")),
+    "importance.set": defineSchema(stringFields("target", "importance")),
+    "episode.add": defineSchema(stringFields("episode_id"), stringFields("title")),
+    "episode.synopsis.set": defineSchema(stringFields("episode_id", "synopsis")),
+    "meta.worldview.set": defineSchema(stringFields("worldview")),
+    "meta.synopsis.set": defineSchema(stringFields("synopsis")),
+    "scene.insert": defineSchema(stringFields("at", "scene_id"), {
+        ...stringFields("location", "time", "space", "before", "after"),
+        location_state_ids: "string[]",
+    }),
+    "scene.move": defineSchema(stringFields("at", "to"), stringFields("before", "after")),
+    "scene.delete": defineSchema(stringFields("at"), { force: "boolean" }),
+    "scene.split": defineSchema(stringFields("at", "at_action", "new_scene_id")),
+    "scene.merge": defineSchema(stringFields("from", "into")),
+    "extend.set": defineSchema({
+        ...stringFields("at", "key"),
+        value: "json",
+    }),
+    "extend.clear": defineSchema(stringFields("at"), stringFields("key")),
+};
+//# sourceMappingURL=schema.js.map

package/dist/domain/script/v4/patch/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../src/domain/script/v4/patch/schema.ts"],"names":[],"mappings":"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"}

package/dist/domain/script/v4/patch/types.d.ts

@@ -0,0 +1,10 @@
+import type { Dict } from "../../shared.js";
+import type { ScriptV4 } from "../types.js";
+export interface V4OpContext {
+    script: ScriptV4;
+    op: Dict;
+    applied: string[];
+    kind: string;
+    runOps: (operations: Dict[]) => string[];
+}
+export type V4OpHandler = (context: V4OpContext) => void;

package/dist/domain/script/v4/patch/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/script/v4/patch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/domain/script/v4/patch/types.ts"],"names":[],"mappings":""}

package/dist/domain/script/v4/selector.d.ts

@@ -0,0 +1,11 @@
+import type { ScriptV4 } from "./types.js";
+export interface V4Selector {
+    readonly isEmpty: boolean;
+    readonly isWholeScript: boolean;
+    matchesEpisode(id: string): boolean;
+    matchesScene(id: string): boolean;
+    matchesAction(id: string): boolean;
+}
+export declare function parseV4Selector(script: ScriptV4, rawValue: unknown, options: {
+    allowOrdinals: boolean;
+}): V4Selector;

package/dist/domain/script/v4/selector.js

@@ -0,0 +1,124 @@
+import { CliError, EXIT_USAGE } from "../../../common.js";
+import { listActionLocationsV4, listEpisodeLocationsV4, listSceneLocationsV4, parseV4Address, } from "./address.js";
+import { resolveV4Ordinal } from "./ordinal.js";
+function selectorError(message, received) {
+    throw new CliError(message, {
+        exitCode: EXIT_USAGE,
+        errorCode: "V4_SELECTOR_INVALID",
+        data: { expected: ["typed v4 ID or same-kind inclusive range; comma joins regions"], actual: [received] },
+    });
+}
+function orderedKind(address, raw) {
+    if (address.kind === "episode" || address.kind === "scene" || address.kind === "action")
+        return address.kind;
+    return selectorError("Asset and state addresses are not narrative range anchors.", raw);
+}
+function addressId(address) {
+    if (address.kind === "state")
+        return `${address.assetId}/${address.stateId}`;
+    return address.id;
+}
+function resolveAnchor(script, raw, allowOrdinals) {
+    if (raw.startsWith("@")) {
+        if (!allowOrdinals)
+            selectorError("Ordinal anchors are query-only.", raw);
+        return resolveV4Ordinal(script, raw);
+    }
+    return parseV4Address(raw);
+}
+function between(ids, left, right, raw) {
+    const leftIndex = ids.indexOf(left);
+    const rightIndex = ids.indexOf(right);
+    if (leftIndex < 0 || rightIndex < 0)
+        selectorError("Range endpoint does not exist in the current script.", raw);
+    const start = Math.min(leftIndex, rightIndex);
+    const end = Math.max(leftIndex, rightIndex);
+    return ids.slice(start, end + 1);
+}
+export function parseV4Selector(script, rawValue, options) {
+    const raw = typeof rawValue === "string" ? rawValue.trim() : "";
+    if (!raw) {
+        return {
+            isEmpty: true,
+            isWholeScript: false,
+            matchesEpisode: () => true,
+            matchesScene: () => true,
+            matchesAction: () => true,
+        };
+    }
+    if (raw === "*") {
+        return {
+            isEmpty: false,
+            isWholeScript: true,
+            matchesEpisode: () => true,
+            matchesScene: () => true,
+            matchesAction: () => true,
+        };
+    }
+    const episodeRows = listEpisodeLocationsV4(script);
+    const sceneRows = listSceneLocationsV4(script);
+    const actionRows = listActionLocationsV4(script);
+    const episodeIds = episodeRows.map((row) => row.episode.episode_id);
+    const sceneIds = sceneRows.map((row) => row.scene.scene_id);
+    const actionIds = actionRows.map((row) => row.action.action_id);
+    const selectedEpisodes = new Set();
+    const selectedScenes = new Set();
+    const selectedActions = new Set();
+    const includeEpisode = (id) => {
+        selectedEpisodes.add(id);
+        const episode = episodeRows.find((row) => row.episode.episode_id === id)?.episode;
+        if (!episode)
+            return;
+        episode.scenes.forEach((scene) => {
+            selectedScenes.add(scene.scene_id);
+            scene.actions.forEach((action) => selectedActions.add(action.action_id));
+        });
+    };
+    const includeScene = (id) => {
+        selectedScenes.add(id);
+        const row = sceneRows.find((candidate) => candidate.scene.scene_id === id);
+        if (!row)
+            return;
+        selectedEpisodes.add(row.episode.episode_id);
+        row.scene.actions.forEach((action) => selectedActions.add(action.action_id));
+    };
+    const includeAction = (id) => {
+        selectedActions.add(id);
+        const row = actionRows.find((candidate) => candidate.action.action_id === id);
+        if (!row)
+            return;
+        selectedEpisodes.add(row.episode.episode_id);
+        selectedScenes.add(row.scene.scene_id);
+    };
+    for (const segmentValue of raw.split(",")) {
+        const segment = segmentValue.trim();
+        if (!segment)
+            selectorError("Selector contains an empty region.", raw);
+        const parts = segment.split("..");
+        if (parts.length > 2)
+            selectorError("Selector region has too many range delimiters.", segment);
+        const left = resolveAnchor(script, parts[0].trim(), options.allowOrdinals);
+        const right = resolveAnchor(script, (parts[1] ?? parts[0]).trim(), options.allowOrdinals);
+        const kind = orderedKind(left, segment);
+        if (orderedKind(right, segment) !== kind)
+            selectorError("Range endpoints must have the same kind.", segment);
+        const leftId = addressId(left);
+        const rightId = addressId(right);
+        const ids = kind === "episode" ? episodeIds : kind === "scene" ? sceneIds : actionIds;
+        const selected = between(ids, leftId, rightId, segment);
+        if (kind === "episode")
+            selected.forEach(includeEpisode);
+        else if (kind === "scene")
+            selected.forEach(includeScene);
+        else
+            selected.forEach(includeAction);
+    }
+    return {
+        isEmpty: false,
+        isWholeScript: false,
+        matchesEpisode: (id) => selectedEpisodes.has(id),
+        matchesScene: (id) => selectedScenes.has(id),
+        matchesAction: (id) => selectedActions.has(id),
+    };
+}
+//# sourceMappingURL=selector.js.map

package/dist/domain/script/v4/selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../../../../src/domain/script/v4/selector.ts"],"names":[],"mappings":"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"}

package/dist/domain/script/v4/types.d.ts

@@ -0,0 +1,120 @@
+import type { ActionType, AssetKind, ExtensionMap, Importance, NonActorSpeakerKind, RoleType } from "../shared/types.js";
+export type EpisodeIdV4 = `ep${string}`;
+export type SceneIdV4 = `scn${string}`;
+export type ActionIdV4 = `ac${string}`;
+export type ActorIdV4 = `act${string}`;
+export type LocationIdV4 = `loc${string}`;
+export type PropIdV4 = `prp${string}`;
+export type StateIdV4 = "default" | `st${string}`;
+export interface ActorSpeakerV4 {
+    actor_id: ActorIdV4;
+    state_id?: StateIdV4;
+}
+export interface NonActorSpeakerV4 {
+    kind: NonActorSpeakerKind;
+    label?: string;
+}
+export type SpeakerV4 = ActorSpeakerV4 | NonActorSpeakerV4;
+export interface TransitionPromptV4 {
+    target: ActorIdV4 | LocationIdV4 | PropIdV4;
+    process: string;
+    contrast: string;
+}
+interface ActionBaseV4 {
+    action_id: ActionIdV4;
+    content: string;
+    transition_prompt?: TransitionPromptV4;
+    extend?: ExtensionMap;
+}
+export interface NarrativeActionV4 extends ActionBaseV4 {
+    type: "action" | "transition";
+}
+export interface SpeakingActionV4 extends ActionBaseV4 {
+    type: "dialogue" | "inner_thought";
+    speaker: SpeakerV4;
+    parenthetical?: string;
+}
+export type ActionV4 = NarrativeActionV4 | SpeakingActionV4;
+export interface EnvironmentV4 {
+    space?: string;
+    time?: string;
+}
+export interface ActorRefV4 {
+    actor_id: ActorIdV4;
+    state_ids: StateIdV4[];
+}
+export interface LocationRefV4 {
+    location_id: LocationIdV4;
+    state_ids: StateIdV4[];
+}
+export interface PropRefV4 {
+    prop_id: PropIdV4;
+    state_ids: StateIdV4[];
+}
+export interface SceneV4 {
+    scene_id: SceneIdV4;
+    environment?: EnvironmentV4;
+    location: LocationRefV4 | null;
+    actors: ActorRefV4[];
+    props: PropRefV4[];
+    actions: ActionV4[];
+    extend?: ExtensionMap;
+}
+export interface EpisodeV4 {
+    episode_id: EpisodeIdV4;
+    title?: string;
+    synopsis?: string;
+    scenes: SceneV4[];
+    extend?: ExtensionMap;
+}
+export interface StateV4 {
+    state_id: StateIdV4;
+    state_name: string;
+    description: string;
+    extend?: ExtensionMap;
+}
+interface AssetV4 {
+    importance: Importance;
+    aliases?: string[];
+    description: string;
+    states: StateV4[];
+    extend?: ExtensionMap;
+}
+export interface ActorV4 extends AssetV4 {
+    actor_id: ActorIdV4;
+    actor_name: string;
+    role_type?: RoleType;
+}
+export interface LocationV4 extends AssetV4 {
+    location_id: LocationIdV4;
+    location_name: string;
+}
+export interface PropV4 extends AssetV4 {
+    prop_id: PropIdV4;
+    prop_name: string;
+}
+export interface ScriptV4 extends Record<string, unknown> {
+    version: 4;
+    title: string;
+    worldview: string;
+    worldview_raw?: string;
+    style: string;
+    synopsis?: string;
+    logline?: string;
+    theme?: string;
+    main_characters?: Array<{
+        name: string;
+        role: string;
+    }>;
+    actors: ActorV4[];
+    locations: LocationV4[];
+    props: PropV4[];
+    episodes: EpisodeV4[];
+    extend?: ExtensionMap;
+}
+export type AssetV4ByKind = {
+    actor: ActorV4;
+    location: LocationV4;
+    prop: PropV4;
+};
+export type { ActionType, AssetKind, ExtensionMap, Importance, NonActorSpeakerKind, RoleType, };

package/dist/domain/script/v4/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/script/v4/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/domain/script/v4/types.ts"],"names":[],"mappings":""}

package/dist/domain/script/v4/validation.d.ts

@@ -0,0 +1,2 @@
+import type { ValidationResult } from "../shared/validation.js";
+export declare function validateScriptV4(doc: unknown): ValidationResult;