@lingjingai/scriptctl 0.20.0 → 0.21.0

package/dist/domain/script/lookups.js

@@ -0,0 +1,309 @@
+import { CliError, EXIT_USAGE, SCRIPT_SCHEMA_VERSION, fmtId, } from "../../common.js";
+import { cleanName, stateLabelError, } from "../direct-core.js";
+import { asList, isDict, isList, opErr, strOf } from "./shared.js";
+export function findAction(script, epId, sceneId, actionIndex) {
+    for (const ep of asList(script["episodes"])) {
+        if (ep["episode_id"] !== epId)
+            continue;
+        for (const scene of asList(ep["scenes"])) {
+            if (scene["scene_id"] === sceneId) {
+                const actions = asList(scene["actions"]);
+                if (actionIndex >= 0 && actionIndex < actions.length)
+                    return actions[actionIndex];
+            }
+        }
+    }
+    throw new CliError("PATCH BLOCKED: Action not found", "Action not found.", {
+        exitCode: EXIT_USAGE,
+        required: ["existing episode_id, scene_id, action_index"],
+        received: [`${epId} ${sceneId} ${actionIndex}`],
+        nextSteps: ["Inspect episodes and fix the patch."],
+    });
+}
+export function findEpisode(script, epId) {
+    for (const ep of asList(script["episodes"])) {
+        if (ep["episode_id"] === epId)
+            return ep;
+    }
+    throw new CliError("PATCH BLOCKED: Episode not found", "Episode not found.", {
+        exitCode: EXIT_USAGE,
+        required: ["existing episode_id"],
+        received: [epId],
+        nextSteps: ["Inspect episodes and fix the patch."],
+    });
+}
+export function findScene(script, epId, sceneId) {
+    const ep = findEpisode(script, epId);
+    for (const scene of asList(ep["scenes"])) {
+        if (scene["scene_id"] === sceneId)
+            return scene;
+    }
+    throw new CliError("PATCH BLOCKED: Scene not found", "Scene not found.", {
+        exitCode: EXIT_USAGE,
+        required: ["existing episode_id and scene_id"],
+        received: [`${epId} ${sceneId}`],
+        nextSteps: ["Inspect episodes and fix the patch."],
+    });
+}
+// ---------------------------------------------------------------------------
+// blank scaffold
+// ---------------------------------------------------------------------------
+/**
+ * Minimal schema-v2 script skeleton: every required top-level field present,
+ * all collections empty. It is the starting point for building a script
+ * bottom-up with the atomic add/insert verbs instead of assembling it from
+ * source material (direct) or md (parse). `worldview`/`style`/`title` are
+ * present-but-empty so the field-presence checks pass; they get filled in
+ * later via `worldview` / `patch`. A blank script validates clean: NO_EPISODES
+ * is a completeness warning (`incomplete_ok`), not a blocker.
+ */
+export function blankScript(title = "") {
+    return {
+        version: SCRIPT_SCHEMA_VERSION,
+        title: title,
+        worldview: "",
+        style: "",
+        actors: [],
+        locations: [],
+        props: [],
+        speakers: [],
+        episodes: [],
+    };
+}
+// Completeness vs. integrity. A script can be structurally sound but unfinished
+// (no episodes yet, an empty episode/scene, a scene without a location, an asset
+// without a description). Those gaps are emitted as `severity: "warning"` with
+// `incomplete_ok: true` directly at their source below — they never block, so an
+// unfinished-but-sound script is editable AND publishable. Only integrity
+// violations (dangling refs, duplicate ids, invalid enums, missing ids/names —
+// things that would corrupt the normalized DB graph) are `severity: "error"`.
+// One SCHEMA_ENTITY_FIELD_MISSING issue for a missing asset field. A missing
+// description is a completeness gap (warning); a missing id/name is an identity
+export function resolveAsset(items, idKey, nameKey, raw) {
+    for (const item of items) {
+        if (raw === item[idKey] || raw === item[nameKey])
+            return item;
+    }
+    return null;
+}
+export const ASSET_KEY_MAP = {
+    actor: ["actors", "actor_id", "actor_name"],
+    location: ["locations", "location_id", "location_name"],
+    prop: ["props", "prop_id", "prop_name"],
+};
+export function assetKeys(assetType) {
+    const entry = ASSET_KEY_MAP[assetType];
+    if (!entry) {
+        throw new CliError("PATCH BLOCKED: Asset type invalid", "Asset type invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["asset_type: actor, location, or prop"],
+            received: [`asset_type: ${assetType}`],
+            nextSteps: ["Fix the patch operation and rerun patch."],
+        });
+    }
+    return entry;
+}
+export function resolvePatchAsset(script, op, assetType = null) {
+    const kind = strOf(assetType || op["asset_type"]);
+    const [key, idKey, nameKey] = assetKeys(kind);
+    const raw = op[idKey] ?? op["id"] ?? op["name"] ?? op[nameKey];
+    const asset = resolveAsset(asList(script[key]), idKey, nameKey, strOf(raw));
+    if (!asset) {
+        throw new CliError("PATCH BLOCKED: Asset not found", "Asset not found.", {
+            exitCode: EXIT_USAGE,
+            required: [`existing ${idKey} or ${nameKey}`],
+            received: [JSON.stringify(op)],
+            nextSteps: ["Inspect assets and fix the patch."],
+        });
+    }
+    return [asset, idKey, nameKey];
+}
+export function nextStateId(script) {
+    const ids = [];
+    for (const key of ["actors", "locations", "props"]) {
+        for (const asset of asList(script[key])) {
+            for (const state of asList(asset["states"]))
+                ids.push(state["state_id"]);
+        }
+    }
+    return nextSeqId(ids, "st");
+}
+export function normalizeStates(script, rawStates, assetKind = "") {
+    if (!isList(rawStates)) {
+        throw new CliError("PATCH BLOCKED: States invalid", "States invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["states: array of state names or {state_id,state_name} objects"],
+            received: [typeof rawStates],
+            nextSteps: ["Fix the patch operation and rerun patch."],
+        });
+    }
+    let maxSeen = 0;
+    for (const key of ["actors", "locations", "props"]) {
+        for (const asset of asList(script[key])) {
+            for (const state of asList(asset["states"])) {
+                const m = /^st_(\d+)$/.exec(strOf(state["state_id"]));
+                if (m)
+                    maxSeen = Math.max(maxSeen, parseInt(m[1], 10));
+            }
+        }
+    }
+    const states = [];
+    const seenNames = new Set();
+    for (const raw of rawStates) {
+        let name = "";
+        let sid = "";
+        if (typeof raw === "string") {
+            name = raw.trim();
+            maxSeen += 1;
+            sid = fmtId("st", maxSeen);
+        }
+        else if (isDict(raw)) {
+            name = strOf(raw["state_name"] || raw["name"]).trim();
+            sid = strOf(raw["state_id"] || raw["id"]).trim();
+            if (!sid) {
+                maxSeen += 1;
+                sid = fmtId("st", maxSeen);
+            }
+        }
+        else
+            continue;
+        if (!name || seenNames.has(name))
+            continue;
+        if (assetKind === "actor") {
+            const reason = stateLabelError(name);
+            if (reason) {
+                throw new CliError("PATCH BLOCKED: State label invalid", "State label invalid.", {
+                    exitCode: EXIT_USAGE,
+                    required: ["one clear state label"],
+                    received: [name],
+                    nextSteps: ["Do not combine multiple states into one label."],
+                    errorCode: "STATE_LABEL_INVALID",
+                });
+            }
+        }
+        seenNames.add(name);
+        states.push({ state_id: sid, state_name: name });
+    }
+    return states;
+}
+export function ensureRefId(script, assetType, rawId, opts = {}) {
+    const allowNone = opts.allowNone ?? false;
+    if (rawId === null && allowNone)
+        return null;
+    const value = strOf(rawId).trim();
+    if (!value && allowNone)
+        return null;
+    const [key, idKey] = assetKeys(assetType);
+    const valid = new Set();
+    for (const item of asList(script[key]))
+        valid.add(strOf(item[idKey]));
+    if (!valid.has(value)) {
+        throw new CliError("PATCH BLOCKED: Reference target not found", "Reference target not found.", {
+            exitCode: EXIT_USAGE,
+            required: [`existing ${idKey}`],
+            received: [`${idKey}: ${value || "<empty>"}`],
+            nextSteps: ["Inspect assets and fix the patch."],
+        });
+    }
+    return value;
+}
+export function idKeyForKind(kind) {
+    const map = { actor: "actor_id", location: "location_id", prop: "prop_id" };
+    return map[kind];
+}
+export function pluralForKind(kind) {
+    const map = { actor: "actors", location: "locations", prop: "props" };
+    return map[kind];
+}
+// Asset id prefixes. props use `prp_` (not `prop_`); mirrors direct-init output.
+export const ASSET_ID_PREFIX = { actor: "act", location: "loc", prop: "prp" };
+// Next free `<prefix>_NNN` id given the existing ids in a collection. Scans for
+// the max NNN so a manually-chosen id (e.g. act_007) never collides with a later
+// auto-id. The single id-allocation routine behind nextScene/Asset/Episode/State.
+export function nextSeqId(existingIds, prefix) {
+    const re = new RegExp(`^${prefix}_(\\d+)$`);
+    let maxSeen = 0;
+    for (const raw of existingIds) {
+        const m = re.exec(strOf(raw));
+        if (m)
+            maxSeen = Math.max(maxSeen, parseInt(m[1], 10));
+    }
+    return fmtId(prefix, maxSeen + 1);
+}
+export function nextSceneId(script) {
+    const ids = asList(script["episodes"]).flatMap((ep) => asList(ep["scenes"]).map((s) => s["scene_id"]));
+    return nextSeqId(ids, "scn");
+}
+export function nextAssetId(script, kind) {
+    const [key, idKey] = assetKeys(kind);
+    return nextSeqId(asList(script[key]).map((item) => item[idKey]), ASSET_ID_PREFIX[kind]);
+}
+export function nextEpisodeId(script) {
+    return nextSeqId(asList(script["episodes"]).map((ep) => ep["episode_id"]), "ep");
+}
+export function sceneIdExists(script, sceneId) {
+    for (const ep of asList(script["episodes"])) {
+        for (const scene of asList(ep["scenes"])) {
+            if (scene["scene_id"] === sceneId)
+                return true;
+        }
+    }
+    return false;
+}
+// Shared body for actor.add / location.add / prop.add: validate the name,
+// allocate or accept an id, reject duplicates, and append a minimal entity
+// ({id, name, description, states:[]}). The caller layers on kind-specific
+// fields (actor role_type/aliases). Returns the pushed entity so the caller can
+// extend it. description defaults to "" — an empty description is a completeness
+// warning, not a hard error, so you can register an asset now and describe it
+// later.
+export function pushAsset(script, kind, op) {
+    const [collKey, idKey, nameKey] = assetKeys(kind);
+    const name = strOf(op["name"] ?? op[nameKey]).trim();
+    if (!name) {
+        throw opErr("SCRIPT OP BLOCKED: Asset name empty", "Asset name empty.", {
+            required: ["name"], received: [JSON.stringify(op)],
+            nextSteps: [`Provide a ${kind} name.`], op: `${kind}.add`, errorCode: "ASSET_NAME_EMPTY",
+        });
+    }
+    // name is already whitespace-trimmed; cleanName additionally strips trailing/
+    // leading punctuation (：，、…) and embedded 【】（） state annotations. Reuse the
+    // same errorCode validateScript uses for this rule (ASSET_NAME_HAS_STATE_ANNOTATION)
+    // so op-time and validate-time speak one vocabulary; the message stays accurate
+    // for the punctuation-only case too. Suggest the canonical form when there is one
+    // (a name that is entirely punctuation/annotation reduces to "").
+    const canonical = cleanName(name);
+    if (canonical !== name) {
+        const suggestion = canonical
+            ? `Use "${canonical}", and register durable looks with state-add instead of putting them in the name.`
+            : "Provide a real name (this one is only punctuation/annotation); register durable looks with state-add.";
+        throw opErr("SCRIPT OP BLOCKED: Asset name not canonical", "Asset name is not canonical (trailing/leading punctuation or an embedded state annotation).", {
+            required: [canonical ? `canonical name, e.g. "${canonical}"` : "a canonical name without punctuation/annotation"],
+            received: [name],
+            nextSteps: [suggestion], op: `${kind}.add`, errorCode: "ASSET_NAME_HAS_STATE_ANNOTATION",
+        });
+    }
+    const id = strOf(op[idKey] ?? op["id"]).trim() || nextAssetId(script, kind);
+    if (!isList(script[collKey]))
+        script[collKey] = [];
+    const coll = script[collKey];
+    if (coll.some((a) => strOf(a[idKey]) === id)) {
+        throw opErr("SCRIPT OP BLOCKED: Asset id exists", "Asset id exists.", {
+            required: ["unused id"], received: [id],
+            nextSteps: ["Use another --id or omit it to auto-allocate."], op: `${kind}.add`, errorCode: "ASSET_ID_EXISTS",
+        });
+    }
+    const entity = { [idKey]: id, [nameKey]: name, description: strOf(op["description"]).trim(), states: [] };
+    coll.push(entity);
+    return entity;
+}
+export function renumberSceneIds(script) {
+    let counter = 0;
+    for (const ep of asList(script["episodes"])) {
+        for (const scene of asList(ep["scenes"])) {
+            counter += 1;
+            scene["scene_id"] = fmtId("scn", counter);
+        }
+    }
+}
+//# sourceMappingURL=lookups.js.map

package/dist/domain/script/lookups.js.map

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

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

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

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

@@ -0,0 +1,38 @@
+// 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, dispatches,
+// and renumbers scene ids once at the end. Behavior is identical to the prior
+// single-function applyPatchOperations: ops mutate in place, any op throwing
+// aborts the whole batch (callers persist only after this returns).
+import { opErr, strOf } from "../shared.js";
+import { renumberSceneIds } from "../lookups.js";
+import { OP_REGISTRY } from "./registry.js";
+// `opts.renumber === false` skips the trailing scene-id renumber — used by the
+// selector sweep, which applies one op per matched action in a loop and would
+// otherwise re-walk the whole document on every iteration; it renumbers once
+// itself after the loop.
+export function applyPatchOperations(script, sourceText, operations, opts = {}) {
+    const applied = [];
+    for (const op of operations) {
+        const kind = strOf(op["op"]);
+        const handler = OP_REGISTRY[kind];
+        if (!handler) {
+            throw opErr("PATCH BLOCKED: Unsupported operation", "Unsupported patch operation.", {
+                required: [
+                    "dot-style op: meta.worldview.set / asset.{rename,describe,alias.set,alias.add,alias.remove,states.set,role.set,merge,delete} / state.{add,rename,describe,delete} / context.{set,clear,ref.remove} / action.{type.set,actor.set,delete,insert,move,state.change,state.remove,transition.set,transition.clear,content.replace,content.regex-replace} / scene.{split,merge,delete,move} / dialogue.{speakers,overlap} / speaker.add",
+                ],
+                received: [kind],
+                nextSteps: [
+                    "Use a supported dot-style patch operation.",
+                    "Legacy snake-style ops (set_worldview / rename_actor / set_action_type / merge_scenes / split_scene / set_scene_*_ref / set_action_actor / set_asset_aliases / set_asset_states / set_action_content_from_span etc.) were removed in 0.6.0; use the new dot-style equivalents.",
+                ],
+                errorCode: "OP_UNSUPPORTED",
+            });
+        }
+        handler({ script, op, sourceText, applied, kind, runOps: (subOps) => applyPatchOperations(script, sourceText, subOps) });
+    }
+    if (opts.renumber !== false)
+        renumberSceneIds(script);
+    return applied;
+}
+//# sourceMappingURL=apply.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../src/domain/script/patch/apply.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,mFAAmF;AACnF,8EAA8E;AAC9E,6EAA6E;AAC7E,oEAAoE;AACpE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAa,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,yBAAyB;AACzB,MAAM,UAAU,oBAAoB,CAAC,MAAY,EAAE,UAAkB,EAAE,UAAkB,EAAE,OAA+B,EAAE;IAC1H,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,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,CAAC,sCAAsC,EAAE,8BAA8B,EAAE;gBAClF,QAAQ,EAAE;oBACR,maAAma;iBACpa;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;gBAChB,SAAS,EAAE;oBACT,4CAA4C;oBAC5C,gRAAgR;iBACjR;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,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,11 @@
+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 nextSpeakerId(script: Dict, sourceKind: string, sourceId?: string | null): string;
+export declare function speakerSourceActorId(script: Dict, speakerId: string): string | null;
+export declare function ensureSpeakerId(script: Dict, speakerId: string): string;
+export declare function contextRefsForKind(context: Dict, kind: string): Dict[];
+export declare function findContextRef(context: Dict, kind: string, targetId: string): Dict | null;
+export declare function setContextState(script: Dict, epId: string, sceneId: string, kind: string, targetId: string, stateId: string | null): void;
+export declare function inferStateBeforeAction(script: Dict, epId: string, sceneId: string, actionIndex: number, kind: string, targetId: string): string | null;

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

@@ -0,0 +1,141 @@
+import { CliError, EXIT_USAGE, } from "../../../common.js";
+import { sceneContext, setSceneContext, } from "../../direct-core.js";
+import { asList, strOf } from "../shared.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("SCRIPT OP BLOCKED: Asset not found", "Asset not found.", {
+        exitCode: EXIT_USAGE,
+        required: [`existing ${kind} id`],
+        received: [`${kind}:${targetId}`],
+        nextSteps: ["Inspect assets and fix the target."],
+        errorCode: "ASSET_NOT_FOUND",
+    });
+}
+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("SCRIPT OP BLOCKED: State not found", "State not found.", {
+        exitCode: EXIT_USAGE,
+        required: ["existing state_id on the target asset"],
+        received: [`${kind}:${targetId}/${stateId}`],
+        nextSteps: ["Inspect states and fix the target."],
+        errorCode: "STATE_NOT_FOUND",
+    });
+}
+export function validateStateForTarget(script, kind, targetId, stateId) {
+    const value = strOf(stateId).trim();
+    if (!value)
+        return null;
+    resolveState(script, kind, targetId, value);
+    return value;
+}
+export function nextSpeakerId(script, sourceKind, sourceId = null) {
+    const existing = new Set();
+    for (const item of asList(script["speakers"]))
+        existing.add(strOf(item["speaker_id"]));
+    if (sourceKind === "actor" && sourceId) {
+        const candidate = `spk_${sourceId}`;
+        if (!existing.has(candidate))
+            return candidate;
+    }
+    let maxSeen = 0;
+    const prefix = `spk_${sourceKind}_`;
+    for (const id of existing) {
+        if (id.startsWith(prefix)) {
+            const m = new RegExp(`^${prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(\\d+)$`).exec(id);
+            if (m)
+                maxSeen = Math.max(maxSeen, parseInt(m[1], 10));
+        }
+    }
+    return `${prefix}${String(maxSeen + 1).padStart(3, "0")}`;
+}
+export function speakerSourceActorId(script, speakerId) {
+    for (const speaker of asList(script["speakers"])) {
+        if (strOf(speaker["speaker_id"]) === speakerId && speaker["source_kind"] === "actor") {
+            return strOf(speaker["source_id"]).trim() || null;
+        }
+    }
+    return null;
+}
+export function ensureSpeakerId(script, speakerId) {
+    const value = strOf(speakerId).trim();
+    const valid = new Set();
+    for (const item of asList(script["speakers"]))
+        valid.add(strOf(item["speaker_id"]));
+    if (!valid.has(value)) {
+        throw new CliError("SCRIPT OP BLOCKED: Speaker not found", "Speaker not found.", {
+            exitCode: EXIT_USAGE,
+            required: ["existing speaker_id"],
+            received: [value || "<empty>"],
+            nextSteps: ["Add a speaker first, or fix the dialogue patch."],
+            errorCode: "SPEAKER_NOT_FOUND",
+        });
+    }
+    return value;
+}
+export function contextRefsForKind(context, kind) {
+    return asList(context[pluralForKind(kind)]);
+}
+export function findContextRef(context, kind, targetId) {
+    const idKey = idKeyForKind(kind);
+    for (const ref of contextRefsForKind(context, kind)) {
+        if (strOf(ref[idKey]) === targetId)
+            return ref;
+    }
+    return null;
+}
+export function setContextState(script, epId, sceneId, kind, targetId, stateId) {
+    ensureRefId(script, kind, targetId);
+    const normalizedState = validateStateForTarget(script, kind, targetId, stateId);
+    const scene = findScene(script, epId, sceneId);
+    const ctx = sceneContext(scene);
+    const idKey = idKeyForKind(kind);
+    // location is single-valued per scene by direct-init invariant; the legacy
+    // set_scene_location_ref op replaced the whole locations[] array to preserve
+    // that. Mirror it here: for location kind, context.set REPLACES (one entry
+    // total). actor/prop stay upsert because multi-actor / multi-prop per scene
+    // is intentional.
+    if (kind === "location") {
+        ctx[pluralForKind(kind)] = [{ [idKey]: targetId, state_id: normalizedState }];
+        setSceneContext(scene, ctx);
+        return;
+    }
+    const refs = [...contextRefsForKind(ctx, kind)];
+    const existing = refs.find((ref) => strOf(ref[idKey]) === targetId);
+    if (existing) {
+        existing["state_id"] = normalizedState;
+    }
+    else {
+        refs.push({ [idKey]: targetId, state_id: normalizedState });
+    }
+    ctx[pluralForKind(kind)] = refs;
+    setSceneContext(scene, ctx);
+}
+export function inferStateBeforeAction(script, epId, sceneId, actionIndex, kind, targetId) {
+    const scene = findScene(script, epId, sceneId);
+    const ctx = sceneContext(scene);
+    let current = null;
+    const ref = findContextRef(ctx, kind, targetId);
+    if (ref)
+        current = strOf(ref["state_id"]).trim() || null;
+    const actions = asList(scene["actions"]);
+    for (let i = 0; i < actionIndex && i < actions.length; i++) {
+        for (const change of asList(actions[i]["state_changes"])) {
+            if (strOf(change["target_kind"]) === kind && strOf(change["target_id"]) === targetId) {
+                const toState = strOf(change["to_state_id"]).trim();
+                if (toState)
+                    current = toState;
+            }
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=helpers.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { OpCtx } from "./types.js";
+export declare function op_action_state_change(__ctx: OpCtx): void;
+export declare function op_action_state_remove(__ctx: OpCtx): void;
+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_delete(__ctx: OpCtx): void;
+export declare function op_action_insert(__ctx: OpCtx): void;
+export declare function op_action_move(__ctx: OpCtx): void;