@lingjingai/scriptctl 0.19.2 → 0.21.0

package/dist/domain/script/address.d.ts

@@ -0,0 +1,30 @@
+export declare function parseAssetTarget(raw: unknown): [string, string];
+export declare function parseStateTarget(raw: unknown): [string, string, string];
+export declare function parseSceneRef(raw: unknown): [string, string];
+export declare function parseActionRef(raw: unknown): [string, string, number];
+export type AnyAddress = {
+    kind: "action";
+    episodeId: string;
+    sceneId: string;
+    actionIndex: number;
+} | {
+    kind: "scene";
+    episodeId: string;
+    sceneId: string;
+} | {
+    kind: "asset";
+    assetKind: string;
+    assetId: string;
+} | {
+    kind: "state";
+    assetKind: string;
+    assetId: string;
+    stateId: string;
+} | {
+    kind: "episode";
+    episodeId: string;
+} | {
+    kind: "speaker";
+    speakerId: string;
+};
+export declare function parseAnyAddress(raw: unknown): AnyAddress;

package/dist/domain/script/address.js

@@ -0,0 +1,141 @@
+import { CliError, EXIT_USAGE, SCRIPT_TARGET_KINDS, } from "../../common.js";
+import { strOf } from "./shared.js";
+export function parseAssetTarget(raw) {
+    const value = strOf(raw).trim();
+    if (!value.includes(":")) {
+        throw new CliError("SCRIPT OP BLOCKED: Target invalid", "Target invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["target: actor:<id>, location:<id>, or prop:<id>"],
+            received: [value || "<empty>"],
+            nextSteps: ["Use a concrete asset target."],
+            errorCode: "TARGET_INVALID",
+        });
+    }
+    const idx = value.indexOf(":");
+    const kind = value.slice(0, idx).trim();
+    const targetId = value.slice(idx + 1).trim();
+    if (!SCRIPT_TARGET_KINDS.has(kind) || !targetId) {
+        throw new CliError("SCRIPT OP BLOCKED: Target invalid", "Target invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["target: actor:<id>, location:<id>, or prop:<id>"],
+            received: [value],
+            nextSteps: ["Use actor, location, or prop with a non-empty id."],
+            errorCode: "TARGET_INVALID",
+        });
+    }
+    return [kind, targetId];
+}
+export function parseStateTarget(raw) {
+    const value = strOf(raw).trim();
+    if (!value.includes("/")) {
+        throw new CliError("SCRIPT OP BLOCKED: State target invalid", "State target invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["state target: actor:<id>/<state_id>"],
+            received: [value || "<empty>"],
+            nextSteps: ["Use a concrete state target."],
+            errorCode: "STATE_TARGET_INVALID",
+        });
+    }
+    const lastSlash = value.lastIndexOf("/");
+    const assetRaw = value.slice(0, lastSlash);
+    const stateId = value.slice(lastSlash + 1).trim();
+    const [kind, targetId] = parseAssetTarget(assetRaw);
+    if (!stateId) {
+        throw new CliError("SCRIPT OP BLOCKED: State target invalid", "State target invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["state_id after '/'"],
+            received: [value],
+            nextSteps: ["Use a non-empty state_id."],
+            errorCode: "STATE_TARGET_INVALID",
+        });
+    }
+    return [kind, targetId, stateId];
+}
+export function parseSceneRef(raw) {
+    const value = strOf(raw).trim();
+    if (!value.includes("/")) {
+        throw new CliError("SCRIPT OP BLOCKED: Scene ref invalid", "Scene ref invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["scene ref: ep_001/scn_001"],
+            received: [value || "<empty>"],
+            nextSteps: ["Use ep_id/scn_id."],
+            errorCode: "SCENE_REF_INVALID",
+        });
+    }
+    const idx = value.indexOf("/");
+    return [value.slice(0, idx).trim(), value.slice(idx + 1).trim()];
+}
+export function parseActionRef(raw) {
+    const value = strOf(raw).trim();
+    if (!value.includes("#")) {
+        throw new CliError("SCRIPT OP BLOCKED: Action ref invalid", "Action ref invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["action ref: ep_001/scn_001#4"],
+            received: [value || "<empty>"],
+            nextSteps: ["Use ep_id/scn_id#action_index."],
+            errorCode: "ACTION_REF_INVALID",
+        });
+    }
+    const lastHash = value.lastIndexOf("#");
+    const sceneRaw = value.slice(0, lastHash);
+    const indexRaw = value.slice(lastHash + 1);
+    const [epId, sceneId] = parseSceneRef(sceneRaw);
+    const actionIndex = parseInt(indexRaw, 10);
+    if (Number.isNaN(actionIndex)) {
+        throw new CliError("SCRIPT OP BLOCKED: Action index invalid", "Action index invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["integer action index after '#'"],
+            received: [value],
+            nextSteps: ["Use a zero-based action index."],
+            errorCode: "ACTION_INDEX_INVALID",
+        });
+    }
+    return [epId, sceneId, actionIndex];
+}
+// Try each format in order. The order matters: action (has `#`) is checked
+// before scene (just `/`), and asset+state (has `:`) is checked before scene.
+// Episode and speaker are bare ids (no separators) distinguished by prefix.
+export function parseAnyAddress(raw) {
+    const value = strOf(raw).trim();
+    if (!value) {
+        throw new CliError("ADDRESS BLOCKED: Address empty", "Address empty.", {
+            exitCode: EXIT_USAGE,
+            required: ["one of the supported address formats"],
+            received: ["<empty>"],
+            nextSteps: ["Pass an address like ep_001/scn_001#3, ep_001/scn_001, actor:act_001, actor:act_001/st_001, ep_001, or spk_001."],
+            errorCode: "ADDRESS_EMPTY",
+        });
+    }
+    if (value.includes("#")) {
+        const [episodeId, sceneId, actionIndex] = parseActionRef(value);
+        return { kind: "action", episodeId, sceneId, actionIndex };
+    }
+    if (value.includes(":")) {
+        if (value.slice(value.indexOf(":") + 1).includes("/")) {
+            const [assetKind, assetId, stateId] = parseStateTarget(value);
+            return { kind: "state", assetKind, assetId, stateId };
+        }
+        const [assetKind, assetId] = parseAssetTarget(value);
+        return { kind: "asset", assetKind, assetId };
+    }
+    if (value.includes("/")) {
+        const [episodeId, sceneId] = parseSceneRef(value);
+        return { kind: "scene", episodeId, sceneId };
+    }
+    if (/^ep_/.test(value)) {
+        return { kind: "episode", episodeId: value };
+    }
+    if (/^spk_/.test(value)) {
+        return { kind: "speaker", speakerId: value };
+    }
+    throw new CliError("ADDRESS BLOCKED: Address invalid", "Address invalid.", {
+        exitCode: EXIT_USAGE,
+        required: [
+            "address: ep_NNN/scn_NNN#idx (action) | ep_NNN/scn_NNN (scene) | actor|location|prop:id (asset) | actor|location|prop:id/state_id (state) | ep_NNN (episode) | spk_XXX (speaker)",
+        ],
+        received: [value],
+        nextSteps: ["Use a recognized address format."],
+        errorCode: "ADDRESS_INVALID",
+    });
+}
+//# sourceMappingURL=address.js.map

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

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

package/dist/domain/script/lookups.d.ts

@@ -0,0 +1,33 @@
+import { type Dict } from "./shared.js";
+export declare function findAction(script: Dict, epId: string, sceneId: string, actionIndex: number): Dict;
+export declare function findEpisode(script: Dict, epId: string): Dict;
+export declare function findScene(script: Dict, epId: string, sceneId: string): Dict;
+/**
+ * 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 declare function blankScript(title?: string): Dict;
+export declare function resolveAsset(items: Dict[], idKey: string, nameKey: string, raw: string): Dict | null;
+export declare const ASSET_KEY_MAP: Record<string, [string, string, string]>;
+export declare function assetKeys(assetType: string): [string, string, string];
+export declare function resolvePatchAsset(script: Dict, op: Dict, assetType?: string | null): [Dict, string, string];
+export declare function nextStateId(script: Dict): string;
+export declare function normalizeStates(script: Dict, rawStates: unknown, assetKind?: string): Dict[];
+export declare function ensureRefId(script: Dict, assetType: string, rawId: unknown, opts?: {
+    allowNone?: boolean;
+}): string | null;
+export declare function idKeyForKind(kind: string): string;
+export declare function pluralForKind(kind: string): string;
+export declare const ASSET_ID_PREFIX: Record<string, string>;
+export declare function nextSeqId(existingIds: Iterable<unknown>, prefix: string): string;
+export declare function nextSceneId(script: Dict): string;
+export declare function nextAssetId(script: Dict, kind: string): string;
+export declare function nextEpisodeId(script: Dict): string;
+export declare function sceneIdExists(script: Dict, sceneId: string): boolean;
+export declare function pushAsset(script: Dict, kind: string, op: Dict): Dict;
+export declare function renumberSceneIds(script: Dict): void;

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;