@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/domain/script/v3/parse.js.map

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

package/dist/domain/script/v3/patch/apply.d.ts

@@ -0,0 +1,2 @@
+import { type Dict } from "../../shared.js";
+export declare function applyPatchOperations(script: Dict, sourceText: string, operations: Dict[]): string[];

package/dist/domain/script/v3/patch/apply.js

@@ -0,0 +1,31 @@
+// Patch op engine driver. Replaces the former 1300-line if/else chain with a
+// lookup-and-invoke dispatch over OP_REGISTRY (Replace Conditional Dispatcher
+// with Command). Per-op logic lives in ops-*.ts; this file only loops and
+// dispatches. Scene IDs are stable identities and are never rewritten as a
+// side effect of structural edits. Any op throwing aborts the whole batch
+// (callers persist only after this returns).
+import { opErr, strOf } from "../../shared.js";
+import { V3_OP_REGISTRY } from "./registry.js";
+export function applyPatchOperations(script, sourceText, operations) {
+    const applied = [];
+    for (const op of operations) {
+        const kind = strOf(op["op"]);
+        const handler = V3_OP_REGISTRY[kind];
+        if (!handler) {
+            throw opErr("PATCH BLOCKED: Unsupported operation", "Unsupported patch operation.", {
+                required: [
+                    "dot-style op: meta.{worldview,synopsis}.set / episode.{add,synopsis.set} / asset.{rename,describe,alias.set,alias.add,alias.remove,states.set,role.set,merge,delete} / importance.set / state.{add,rename,describe,delete} / scene.ref.{set,clear,remove} / action.{type.set,actor.set,emotion.set,emotion.clear,delete,insert,move,transition.set,transition.clear,content.replace,content.regex-replace} / scene.{split,merge,delete,move,insert} / dialogue.speaker.set / extend.{set,clear}",
+                ],
+                received: [kind],
+                nextSteps: [
+                    "Use a supported dot-style patch operation.",
+                    "Removed in v3: context.* (use scene.ref.*), dialogue.speakers/dialogue.overlap (use dialogue.speaker.set — single inline speaker), speaker.add/speaker.delete (v3 has no speaker roster), action.state.change/remove (state lives on scene.ref.*).",
+                ],
+                errorCode: "OP_UNSUPPORTED",
+            });
+        }
+        handler({ script, op, sourceText, applied, kind, runOps: (subOps) => applyPatchOperations(script, sourceText, subOps) });
+    }
+    return applied;
+}
+//# sourceMappingURL=apply.js.map

package/dist/domain/script/v3/patch/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../../src/domain/script/v3/patch/apply.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,6CAA6C;AAC7C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAa,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,UAAU,oBAAoB,CAAC,MAAY,EAAE,UAAkB,EAAE,UAAkB;IACvF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,CAAC,sCAAsC,EAAE,8BAA8B,EAAE;gBAClF,QAAQ,EAAE;oBACR,ieAAie;iBACle;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;gBAChB,SAAS,EAAE;oBACT,4CAA4C;oBAC5C,oPAAoP;iBACrP;gBACD,SAAS,EAAE,gBAAgB;aAC5B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3H,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/domain/script/v3/patch/helpers.d.ts

@@ -0,0 +1,17 @@
+import { type Dict } from "../../shared.js";
+export declare function resolveAssetByTarget(script: Dict, kind: string, targetId: string): Dict;
+export declare function resolveState(script: Dict, kind: string, targetId: string, stateId: string): Dict;
+export declare function validateStateForTarget(script: Dict, kind: string, targetId: string, stateId: string | null): string | null;
+export declare function contextRefsForKind(refs: Dict, kind: string): Dict[];
+export declare function findContextRef(refs: Dict, kind: string, targetId: string): Dict | null;
+export declare function sceneRefOccurrence(value: unknown, op: string): number | undefined;
+export declare function matchingContextRefIndexes(refs: Dict[], idKey: string, targetId: string): number[];
+export declare function contextRefIndex(refs: Dict[], idKey: string, targetId: string, occurrence: number | undefined, op: string): number | undefined;
+export declare function assertActorReferencedByScene(script: Dict, epId: string, sceneId: string, actorId: string, op: string): void;
+export declare function assertSceneReadyForBody(script: Dict, epId: string, sceneId: string, op: string): void;
+export declare function setContextState(script: Dict, epId: string, sceneId: string, kind: string, targetId: string, stateId: string | null, options: {
+    append?: boolean;
+    occurrence?: number;
+    op: string;
+}): void;
+export declare function inferStateBeforeAction(script: Dict, epId: string, sceneId: string, _actionIndex: number, kind: string, targetId: string): string | null;

package/dist/domain/script/v3/patch/helpers.js

@@ -0,0 +1,209 @@
+import { CliError, EXIT_USAGE } from "../../../../common.js";
+import { asList, opErr, strOf } from "../../shared.js";
+import { sceneRefs, setSceneRefs } from "../scene-refs.js";
+import { assetKeys, ensureRefId, findScene, idKeyForKind, pluralForKind } from "../lookups.js";
+export function resolveAssetByTarget(script, kind, targetId) {
+    const [key, idKey] = assetKeys(kind);
+    for (const item of asList(script[key])) {
+        if (strOf(item[idKey]) === targetId)
+            return item;
+    }
+    throw new CliError("Asset not found.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "ASSET_NOT_FOUND",
+        hint: "Inspect assets and fix the target.",
+        data: { expected: [`existing ${kind} id`], actual: [`${kind}:${targetId}`] },
+    });
+}
+export function resolveState(script, kind, targetId, stateId) {
+    const asset = resolveAssetByTarget(script, kind, targetId);
+    for (const state of asList(asset["states"])) {
+        if (strOf(state["state_id"]) === stateId)
+            return state;
+    }
+    throw new CliError("State not found.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "STATE_NOT_FOUND",
+        hint: "Inspect states and fix the target.",
+        data: { expected: ["existing state_id on the target asset"], actual: [`${kind}:${targetId}/${stateId}`] },
+    });
+}
+export function validateStateForTarget(script, kind, targetId, stateId) {
+    const value = strOf(stateId).trim();
+    if (!value)
+        return null;
+    resolveState(script, kind, targetId, value);
+    return value;
+}
+// A scene's cast/props/location refs, read as the {actors,locations,props} bag
+// (v3 storage lives on scene.actors/props + scene.location — see scene-refs.ts).
+export function contextRefsForKind(refs, kind) {
+    return asList(refs[pluralForKind(kind)]);
+}
+export function findContextRef(refs, kind, targetId) {
+    const idKey = idKeyForKind(kind);
+    for (const ref of contextRefsForKind(refs, kind)) {
+        if (strOf(ref[idKey]) === targetId)
+            return ref;
+    }
+    return null;
+}
+export function sceneRefOccurrence(value, op) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const occurrence = typeof value === "number"
+        ? value
+        : typeof value === "string" && /^\d+$/.test(value)
+            ? Number(value)
+            : Number.NaN;
+    if (Number.isInteger(occurrence) && occurrence >= 1)
+        return occurrence;
+    throw opErr("SCRIPT OP BLOCKED: scene ref occurrence invalid", "Scene ref occurrence must be a positive integer.", {
+        required: ["occurrence: positive integer (1-based)"],
+        received: [strOf(value)],
+        nextSteps: ["Use 1 for the first matching scene ref, 2 for the second, and so on."],
+        op,
+        errorCode: "SCENE_REF_OCCURRENCE_INVALID",
+    });
+}
+export function matchingContextRefIndexes(refs, idKey, targetId) {
+    const indexes = [];
+    for (let index = 0; index < refs.length; index++) {
+        if (strOf(refs[index]?.[idKey]) === targetId)
+            indexes.push(index);
+    }
+    return indexes;
+}
+export function contextRefIndex(refs, idKey, targetId, occurrence, op) {
+    const indexes = matchingContextRefIndexes(refs, idKey, targetId);
+    if (occurrence !== undefined) {
+        const index = indexes[occurrence - 1];
+        if (index !== undefined)
+            return index;
+        throw opErr("SCRIPT OP BLOCKED: scene ref occurrence not found", "The requested scene ref occurrence does not exist.", {
+            required: [`occurrence: 1..${indexes.length}`],
+            received: [String(occurrence)],
+            nextSteps: ["Inspect the scene refs and choose an existing occurrence."],
+            op,
+            errorCode: "SCENE_REF_OCCURRENCE_NOT_FOUND",
+        });
+    }
+    if (indexes.length > 1) {
+        throw opErr("SCRIPT OP BLOCKED: scene ref target is ambiguous", "The target appears more than once in this scene.", {
+            required: ["occurrence: 1-based matching ref"],
+            received: [`${targetId}: ${indexes.length} refs`],
+            nextSteps: ["Pass --occurrence <n> to select one scene ref."],
+            op,
+            errorCode: "SCENE_REF_OCCURRENCE_REQUIRED",
+        });
+    }
+    return indexes[0];
+}
+export function assertActorReferencedByScene(script, epId, sceneId, actorId, op) {
+    const scene = findScene(script, epId, sceneId);
+    const actorRef = findContextRef(sceneRefs(scene), "actor", actorId);
+    if (actorRef !== null)
+        return;
+    throw opErr("SCRIPT OP BLOCKED: Actor is not in scene", "Actor is not referenced by this scene.", {
+        required: [`scene-ref ${epId}/${sceneId} actor:${actorId} --state <state_id>`],
+        received: [`actor:${actorId}`],
+        nextSteps: ["Add the actor and its materialized state to the scene before writing or assigning the line."],
+        op,
+        errorCode: "ACTOR_NOT_IN_SCENE",
+    });
+}
+export function assertSceneReadyForBody(script, epId, sceneId, op) {
+    const scene = findScene(script, epId, sceneId);
+    const refs = sceneRefs(scene);
+    const locations = contextRefsForKind(refs, "location");
+    if (locations.length === 0) {
+        throw opErr("SCRIPT OP BLOCKED: Scene location missing", "Scene needs a location reference before body can be written.", {
+            required: [`scene-ref ${epId}/${sceneId} location:<id> --state <state_id>`],
+            received: ["scene.location: null"],
+            nextSteps: ["Reference the scene location and its materialized state, then retry."],
+            op,
+            errorCode: "SCENE_LOCATION_REF_MISSING",
+        });
+    }
+    const actors = contextRefsForKind(refs, "actor");
+    const missingStateTargets = [];
+    for (const [assetKind, assetRefs] of [
+        ["location", locations],
+        ["actor", actors],
+        ["prop", contextRefsForKind(refs, "prop")],
+    ]) {
+        const idKey = idKeyForKind(assetKind);
+        for (const ref of assetRefs) {
+            const assetId = strOf(ref[idKey]).trim();
+            const stateId = strOf(ref["state_id"]).trim();
+            if (!stateId) {
+                missingStateTargets.push(`${assetKind}:${assetId}`);
+                continue;
+            }
+            resolveState(script, assetKind, assetId, stateId);
+        }
+    }
+    if (missingStateTargets.length === 0)
+        return;
+    throw opErr("SCRIPT OP BLOCKED: Scene asset state missing", "Every scene asset reference needs a materialized state before body can be written.", {
+        required: ["state_id on every scene location / actor / prop reference"],
+        received: missingStateTargets,
+        nextSteps: missingStateTargets.map((target) => `Run scene-ref ${epId}/${sceneId} ${target} --state <state_id>.`),
+        op,
+        errorCode: "SCENE_REF_STATE_MISSING",
+    });
+}
+export function setContextState(script, epId, sceneId, kind, targetId, stateId, options) {
+    ensureRefId(script, kind, targetId);
+    const normalizedState = validateStateForTarget(script, kind, targetId, stateId);
+    const scene = findScene(script, epId, sceneId);
+    const bag = sceneRefs(scene);
+    const idKey = idKeyForKind(kind);
+    // Location is single-valued per scene. Actor refs are ordered instances and
+    // may repeat; props keep id-based upsert semantics.
+    if (kind === "location") {
+        if (options.append || options.occurrence !== undefined) {
+            throw opErr("SCRIPT OP BLOCKED: location ref is single-valued", "Location refs do not support append or occurrence.", {
+                required: ["scene.ref.set without append or occurrence"],
+                received: [options.append ? "append=true" : `occurrence=${options.occurrence}`],
+                nextSteps: ["Set the scene location directly; it replaces the existing location ref."],
+                op: options.op,
+                errorCode: "SCENE_LOCATION_REF_SINGLE",
+            });
+        }
+        bag[pluralForKind(kind)] = [{ [idKey]: targetId, state_id: normalizedState }];
+        setSceneRefs(scene, bag);
+        return;
+    }
+    const refs = [...contextRefsForKind(bag, kind)];
+    if (options.append) {
+        if (kind !== "actor") {
+            throw opErr("SCRIPT OP BLOCKED: append only supports actor refs", "Only actor refs may repeat in a scene.", {
+                required: ["target: actor:<id>"],
+                received: [`${kind}:${targetId}`],
+                nextSteps: ["Use actor:<id> with append, or set the existing prop ref."],
+                op: options.op,
+                errorCode: "SCENE_REF_APPEND_KIND_INVALID",
+            });
+        }
+        refs.push({ [idKey]: targetId, state_id: normalizedState });
+    }
+    else {
+        const existingIndex = contextRefIndex(refs, idKey, targetId, options.occurrence, options.op);
+        if (existingIndex === undefined)
+            refs.push({ [idKey]: targetId, state_id: normalizedState });
+        else
+            refs[existingIndex]["state_id"] = normalizedState;
+    }
+    bag[pluralForKind(kind)] = refs;
+    setSceneRefs(scene, bag);
+}
+// v3: a scene ref's state_id IS the state at the scene (no per-action
+// state_changes to walk), so the "state before action N" is simply the scene
+// cast/location/prop ref's declared state.
+export function inferStateBeforeAction(script, epId, sceneId, _actionIndex, kind, targetId) {
+    const scene = findScene(script, epId, sceneId);
+    const ref = findContextRef(sceneRefs(scene), kind, targetId);
+    return ref ? strOf(ref["state_id"]).trim() || null : null;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/domain/script/v3/patch/helpers.js.map

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

package/dist/domain/script/v3/patch/inline-speaker.d.ts

@@ -0,0 +1,2 @@
+import { type Dict } from "../../shared.js";
+export declare function inlineSpeakerFromOp(script: Dict, op: Dict, opName: string): Dict;

package/dist/domain/script/v3/patch/inline-speaker.js

@@ -0,0 +1,50 @@
+import { opErr, strOf } from "../../shared.js";
+import { ensureRefId } from "../lookups.js";
+import { NON_ACTOR_SPEAKER_KIND_SET } from "../types.js";
+export function inlineSpeakerFromOp(script, op, opName) {
+    const actorId = strOf(op["actor_id"]).trim();
+    const speakerKind = strOf(op["kind"]).trim();
+    const label = strOf(op["label"]).trim();
+    if (actorId && speakerKind) {
+        throw opErr("SCRIPT OP BLOCKED: Speaker ambiguous", "Pass actor_id OR kind, not both.", {
+            required: ["exactly one of: actor_id (an actor) or kind (a non-actor source)"],
+            received: [`actor_id=${actorId}, kind=${speakerKind}`],
+            nextSteps: ["Set actor_id for an actor line, or kind (system|broadcast|offscreen|group) for a non-actor line."],
+            op: opName,
+            errorCode: "SPEAKER_AMBIGUOUS",
+        });
+    }
+    if (actorId) {
+        if (label) {
+            throw opErr("SCRIPT OP BLOCKED: Speaker label misplaced", "label is only valid with a non-actor speaker kind.", {
+                required: ["omit label with actor_id, or pair label with kind"],
+                received: [`actor_id=${actorId}, label=${label}`],
+                nextSteps: ["Remove label for an actor line, or use kind for a labeled non-actor source."],
+                op: opName,
+                errorCode: "SPEAKER_LABEL_WITHOUT_KIND",
+            });
+        }
+        ensureRefId(script, "actor", actorId);
+        return { actor_id: actorId };
+    }
+    if (speakerKind) {
+        if (!NON_ACTOR_SPEAKER_KIND_SET.has(speakerKind)) {
+            throw opErr("SCRIPT OP BLOCKED: Speaker kind invalid", "Speaker kind invalid.", {
+                required: ["kind: system, broadcast, offscreen, or group"],
+                received: [speakerKind],
+                nextSteps: ["Use a supported non-actor speaker kind, or pass actor_id for an actor."],
+                op: opName,
+                errorCode: "SPEAKER_KIND_INVALID",
+            });
+        }
+        return label ? { kind: speakerKind, label } : { kind: speakerKind };
+    }
+    throw opErr("SCRIPT OP BLOCKED: Speaker missing", "Speaker missing.", {
+        required: ["actor_id or kind"],
+        received: [JSON.stringify(op)],
+        nextSteps: ["Pass actor_id for an actor line, or kind for a non-actor line."],
+        op: opName,
+        errorCode: "SPEAKER_MISSING",
+    });
+}
+//# sourceMappingURL=inline-speaker.js.map

package/dist/domain/script/v3/patch/inline-speaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-speaker.js","sourceRoot":"","sources":["../../../../../src/domain/script/v3/patch/inline-speaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAC,MAAY,EAAE,EAAQ,EAAE,MAAc;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC,sCAAsC,EAAE,kCAAkC,EAAE;YACtF,QAAQ,EAAE,CAAC,kEAAkE,CAAC;YAC9E,QAAQ,EAAE,CAAC,YAAY,OAAO,UAAU,WAAW,EAAE,CAAC;YACtD,SAAS,EAAE,CAAC,kGAAkG,CAAC;YAC/G,EAAE,EAAE,MAAM;YACV,SAAS,EAAE,mBAAmB;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,CAAC,4CAA4C,EAAE,oDAAoD,EAAE;gBAC9G,QAAQ,EAAE,CAAC,mDAAmD,CAAC;gBAC/D,QAAQ,EAAE,CAAC,YAAY,OAAO,WAAW,KAAK,EAAE,CAAC;gBACjD,SAAS,EAAE,CAAC,6EAA6E,CAAC;gBAC1F,EAAE,EAAE,MAAM;gBACV,SAAS,EAAE,4BAA4B;aACxC,CAAC,CAAC;QACL,CAAC;QACD,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,CAAC,yCAAyC,EAAE,uBAAuB,EAAE;gBAC9E,QAAQ,EAAE,CAAC,8CAA8C,CAAC;gBAC1D,QAAQ,EAAE,CAAC,WAAW,CAAC;gBACvB,SAAS,EAAE,CAAC,wEAAwE,CAAC;gBACrF,EAAE,EAAE,MAAM;gBACV,SAAS,EAAE,sBAAsB;aAClC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,KAAK,CAAC,oCAAoC,EAAE,kBAAkB,EAAE;QACpE,QAAQ,EAAE,CAAC,kBAAkB,CAAC;QAC9B,QAAQ,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9B,SAAS,EAAE,CAAC,gEAAgE,CAAC;QAC7E,EAAE,EAAE,MAAM;QACV,SAAS,EAAE,iBAAiB;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/script/v3/patch/ops-action.d.ts

@@ -0,0 +1,12 @@
+import type { OpCtx } from "./types.js";
+export declare function op_action_transition_set(__ctx: OpCtx): void;
+export declare function op_action_transition_clear(__ctx: OpCtx): void;
+export declare function op_action_content_replace(__ctx: OpCtx): void;
+export declare function op_action_content_regex_replace(__ctx: OpCtx): void;
+export declare function op_action_type_set(__ctx: OpCtx): void;
+export declare function op_action_actor_set(__ctx: OpCtx): void;
+export declare function op_action_emotion_set(__ctx: OpCtx): void;
+export declare function op_action_emotion_clear(__ctx: OpCtx): void;
+export declare function op_action_delete(__ctx: OpCtx): void;
+export declare function op_action_insert(__ctx: OpCtx): void;
+export declare function op_action_move(__ctx: OpCtx): void;