@lingjingai/scriptctl 0.49.15 → 0.50.0

package/dist/domain/script/v4/from-v3.js

@@ -0,0 +1,307 @@
+import { createHash } from "node:crypto";
+import { parseAssetTarget } from "../v3/address.js";
+import { sortDeep } from "../text-util.js";
+import { generateV4Id, isV4Id } from "./ids.js";
+export function emptyV4IdentityMap() {
+    return {
+        version: 3,
+        actor: {},
+        location: {},
+        prop: {},
+        state: {},
+        episode: {},
+        scene: {},
+        action: {},
+    };
+}
+function requiredMapped(map, oldId) {
+    const value = map.get(oldId);
+    if (value === undefined)
+        throw new Error(`Missing mapped ID for ${oldId}`);
+    return value;
+}
+export function newScriptV4FromV3WithIdentity(script, prior = emptyV4IdentityMap(), sourceKeys = {}) {
+    if (prior.version !== 3)
+        throw new Error(`Unsupported v4 identity map version: ${String(prior.version)}`);
+    const identityMap = structuredClone(prior);
+    const ids = {
+        actor: new Map(),
+        location: new Map(),
+        prop: new Map(),
+    };
+    const used = {
+        actor: new Set(),
+        location: new Set(),
+        prop: new Set(),
+        episode: new Set(),
+        scene: new Set(),
+        action: new Set(),
+    };
+    const allocate = (kind, key, map, existing) => {
+        const saved = map[key];
+        if (saved !== undefined) {
+            if (!isV4Id(kind, saved))
+                throw new Error(`Invalid persisted ${kind} ID for ${key}: ${saved}`);
+            if (existing.has(saved))
+                throw new Error(`Duplicate persisted ${kind} ID: ${saved}`);
+            existing.add(saved);
+            return saved;
+        }
+        const generated = generateV4Id(kind, existing);
+        existing.add(generated);
+        map[key] = generated;
+        return generated;
+    };
+    const assetSourceKey = (kind, id) => sourceKeys[kind]?.[id] ?? id;
+    for (const actor of script.actors) {
+        const id = allocate("actor", assetSourceKey("actor", actor.actor_id), identityMap.actor, used.actor);
+        ids.actor.set(actor.actor_id, id);
+    }
+    for (const location of script.locations) {
+        const id = allocate("location", assetSourceKey("location", location.location_id), identityMap.location, used.location);
+        ids.location.set(location.location_id, id);
+    }
+    for (const prop of script.props) {
+        const id = allocate("prop", assetSourceKey("prop", prop.prop_id), identityMap.prop, used.prop);
+        ids.prop.set(prop.prop_id, id);
+    }
+    const stateMaps = new Map();
+    const convertStates = (ownerKind, ownerId, states) => {
+        const map = new Map();
+        const usedStates = new Set();
+        const ownerSourceKey = assetSourceKey(ownerKind, ownerId);
+        const persisted = identityMap.state[ownerSourceKey] ?? {};
+        identityMap.state[ownerSourceKey] = persisted;
+        const converted = states.map((state) => {
+            let stateId;
+            if (state.state_id === "default") {
+                stateId = "default";
+            }
+            else {
+                const sourceKey = sourceKeys.state?.[ownerId]?.[state.state_id] ?? state.state_id;
+                const saved = persisted[sourceKey];
+                if (saved !== undefined) {
+                    if (!isV4Id("state", saved))
+                        throw new Error(`Invalid persisted state ID for ${ownerId}/${state.state_id}: ${saved}`);
+                    if (usedStates.has(saved))
+                        throw new Error(`Duplicate persisted state ID on ${ownerId}: ${saved}`);
+                    stateId = saved;
+                }
+                else {
+                    stateId = generateV4Id("state", usedStates);
+                    persisted[sourceKey] = stateId;
+                }
+            }
+            usedStates.add(stateId);
+            map.set(state.state_id, stateId);
+            return { ...state, state_id: stateId };
+        });
+        stateMaps.set(ownerId, map);
+        return converted;
+    };
+    const stateId = (ownerId, oldStateId) => oldStateId === undefined ? undefined : requiredMapped(stateMaps.get(ownerId) ?? new Map(), oldStateId);
+    const actors = script.actors.map((actor) => ({
+        ...actor,
+        actor_id: requiredMapped(ids.actor, actor.actor_id),
+        states: convertStates("actor", actor.actor_id, actor.states),
+    }));
+    const locations = script.locations.map((location) => ({
+        ...location,
+        location_id: requiredMapped(ids.location, location.location_id),
+        states: convertStates("location", location.location_id, location.states),
+    }));
+    const props = script.props.map((prop) => ({
+        ...prop,
+        prop_id: requiredMapped(ids.prop, prop.prop_id),
+        states: convertStates("prop", prop.prop_id, prop.states),
+    }));
+    const speaker = (value) => {
+        if ("actor_id" in value) {
+            const mappedState = stateId(value.actor_id, value.state_id);
+            return {
+                actor_id: requiredMapped(ids.actor, value.actor_id),
+                ...(mappedState === undefined ? {} : { state_id: mappedState }),
+            };
+        }
+        return value.label === undefined
+            ? { kind: value.kind }
+            : { kind: value.kind, label: value.label };
+    };
+    const transitionTarget = (target) => {
+        if (target.includes(":")) {
+            const [kind, oldId] = parseAssetTarget(target);
+            if (kind === "actor")
+                return requiredMapped(ids.actor, oldId);
+            if (kind === "location")
+                return requiredMapped(ids.location, oldId);
+            return requiredMapped(ids.prop, oldId);
+        }
+        const mapped = ids.actor.get(target) ?? ids.location.get(target) ?? ids.prop.get(target);
+        if (mapped === undefined)
+            throw new Error(`Missing transition target mapping for ${target}`);
+        return mapped;
+    };
+    const action = (value, key) => {
+        const actionId = allocate("action", key, identityMap.action, used.action);
+        const transition = value.transition_prompt === undefined
+            ? {}
+            : {
+                transition_prompt: {
+                    ...value.transition_prompt,
+                    target: transitionTarget(value.transition_prompt.target),
+                },
+            };
+        if (value.type === "dialogue" || value.type === "inner_thought") {
+            if (value.speaker === undefined) {
+                throw new Error(`Speaking action ${value.content.slice(0, 40)} has no speaker`);
+            }
+            return {
+                action_id: actionId,
+                type: value.type,
+                content: value.content,
+                speaker: speaker(value.speaker),
+                ...(value.emotion === undefined ? {} : { parenthetical: value.emotion }),
+                ...transition,
+                ...(value.extend === undefined ? {} : { extend: value.extend }),
+            };
+        }
+        return {
+            action_id: actionId,
+            type: value.type,
+            content: value.content,
+            ...transition,
+            ...(value.extend === undefined ? {} : { extend: value.extend }),
+        };
+    };
+    const refStates = (ownerId, oldStateId) => [stateId(ownerId, oldStateId ?? "default") ?? "default"];
+    const actorRefs = (refs, actions) => {
+        const merged = new Map();
+        for (const ref of refs) {
+            const id = requiredMapped(ids.actor, ref.actor_id);
+            const states = merged.get(id) ?? new Set();
+            refStates(ref.actor_id, ref.state_id).forEach((item) => states.add(item));
+            merged.set(id, states);
+        }
+        for (const candidate of actions) {
+            if (candidate.speaker === undefined || !("actor_id" in candidate.speaker))
+                continue;
+            const oldActorId = candidate.speaker.actor_id;
+            const id = requiredMapped(ids.actor, oldActorId);
+            const states = merged.get(id) ?? new Set();
+            refStates(oldActorId, candidate.speaker.state_id).forEach((item) => states.add(item));
+            merged.set(id, states);
+        }
+        return [...merged].map(([actor_id, states]) => ({
+            actor_id,
+            state_ids: [...states].sort(),
+        }));
+    };
+    const propRefs = (refs) => {
+        const merged = new Map();
+        for (const ref of refs) {
+            const id = requiredMapped(ids.prop, ref.prop_id);
+            const states = merged.get(id) ?? new Set();
+            refStates(ref.prop_id, ref.state_id).forEach((item) => states.add(item));
+            merged.set(id, states);
+        }
+        return [...merged].map(([prop_id, states]) => ({
+            prop_id,
+            state_ids: [...states].sort(),
+        }));
+    };
+    const liveEpisodeKeys = new Set();
+    const liveSceneKeys = new Set();
+    const liveActionKeys = new Set();
+    const converted = {
+        version: 4,
+        title: script.title,
+        worldview: script.worldview,
+        style: script.style,
+        ...(script.worldview_raw === undefined ? {} : { worldview_raw: script.worldview_raw }),
+        ...(script.synopsis === undefined ? {} : { synopsis: script.synopsis }),
+        ...(script.logline === undefined ? {} : { logline: script.logline }),
+        ...(script.theme === undefined ? {} : { theme: script.theme }),
+        ...(script.main_characters === undefined ? {} : { main_characters: script.main_characters }),
+        ...(script.extend === undefined ? {} : { extend: script.extend }),
+        actors,
+        locations,
+        props,
+        episodes: script.episodes.map((episode) => {
+            const episodeKey = sourceKeys.episode?.[episode.episode_id] ?? episode.episode_id;
+            liveEpisodeKeys.add(episodeKey);
+            const episodeId = allocate("episode", episodeKey, identityMap.episode, used.episode);
+            return {
+                ...episode,
+                episode_id: episodeId,
+                scenes: episode.scenes.map((scene) => {
+                    const sceneAddress = `${episode.episode_id}/${scene.scene_id}`;
+                    const sceneKey = sourceKeys.scene?.[sceneAddress] ?? sceneAddress;
+                    liveSceneKeys.add(sceneKey);
+                    const sceneId = allocate("scene", sceneKey, identityMap.scene, used.scene);
+                    const fallbackOccurrences = new Map();
+                    return {
+                        ...scene,
+                        scene_id: sceneId,
+                        location: scene.location === null
+                            ? null
+                            : {
+                                location_id: requiredMapped(ids.location, scene.location.location_id),
+                                state_ids: refStates(scene.location.location_id, scene.location.state_id),
+                            },
+                        actors: actorRefs(scene.actors, scene.actions),
+                        props: propRefs(scene.props),
+                        actions: scene.actions.map((candidate, index) => {
+                            const actionAddress = `${sceneAddress}#${index}`;
+                            const signature = JSON.stringify(sortDeep(candidate));
+                            const occurrence = (fallbackOccurrences.get(signature) ?? 0) + 1;
+                            fallbackOccurrences.set(signature, occurrence);
+                            const signatureHash = createHash("sha256").update(signature).digest("hex");
+                            const actionKey = sourceKeys.action?.[actionAddress]
+                                ?? `${sceneKey}:action:${signatureHash}:${occurrence}`;
+                            liveActionKeys.add(actionKey);
+                            return action(candidate, actionKey);
+                        }),
+                    };
+                }),
+            };
+        }),
+    };
+    const keepOnly = (record, keys) => {
+        for (const key of Object.keys(record)) {
+            if (!keys.has(key))
+                delete record[key];
+        }
+    };
+    keepOnly(identityMap.actor, new Set(script.actors.map((asset) => assetSourceKey("actor", asset.actor_id))));
+    keepOnly(identityMap.location, new Set(script.locations.map((asset) => assetSourceKey("location", asset.location_id))));
+    keepOnly(identityMap.prop, new Set(script.props.map((asset) => assetSourceKey("prop", asset.prop_id))));
+    keepOnly(identityMap.episode, liveEpisodeKeys);
+    keepOnly(identityMap.scene, liveSceneKeys);
+    keepOnly(identityMap.action, liveActionKeys);
+    const owners = [
+        ...script.actors.map((asset) => ({
+            id: assetSourceKey("actor", asset.actor_id),
+            oldId: asset.actor_id,
+            states: asset.states,
+        })),
+        ...script.locations.map((asset) => ({
+            id: assetSourceKey("location", asset.location_id),
+            oldId: asset.location_id,
+            states: asset.states,
+        })),
+        ...script.props.map((asset) => ({
+            id: assetSourceKey("prop", asset.prop_id),
+            oldId: asset.prop_id,
+            states: asset.states,
+        })),
+    ];
+    keepOnly(identityMap.state, new Set(owners.map((owner) => owner.id)));
+    for (const owner of owners) {
+        keepOnly(identityMap.state[owner.id] ?? {}, new Set(owner.states.map((state) => sourceKeys.state?.[owner.oldId]?.[state.state_id] ?? state.state_id)));
+    }
+    return { script: converted, identityMap };
+}
+export function newScriptV4FromV3(script) {
+    return newScriptV4FromV3WithIdentity(script).script;
+}
+//# sourceMappingURL=from-v3.js.map

package/dist/domain/script/v4/from-v3.js.map

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

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

@@ -0,0 +1,27 @@
+import type { ActionIdV4, ActorIdV4, EpisodeIdV4, LocationIdV4, PropIdV4, SceneIdV4 } from "./types.js";
+export declare const V4_ID_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+export declare const V4_ID_RANDOM_LENGTH = 6;
+export declare const V4_ID_PREFIXES: {
+    readonly episode: "ep";
+    readonly scene: "scn";
+    readonly action: "ac";
+    readonly actor: "act";
+    readonly location: "loc";
+    readonly prop: "prp";
+    readonly state: "st";
+};
+export type V4IdKind = keyof typeof V4_ID_PREFIXES;
+export type V4IdByKind = {
+    episode: EpisodeIdV4;
+    scene: SceneIdV4;
+    action: ActionIdV4;
+    actor: ActorIdV4;
+    location: LocationIdV4;
+    prop: PropIdV4;
+    state: `st${string}`;
+};
+export declare const V4_ID_PATTERNS: Readonly<Record<V4IdKind, RegExp>>;
+export declare function isV4Id<K extends V4IdKind>(kind: K, value: unknown): value is V4IdByKind[K];
+export declare function requireV4Id<K extends V4IdKind>(kind: K, value: unknown, path: string): V4IdByKind[K];
+export declare function generateV4Id<K extends V4IdKind>(kind: K, existing?: ReadonlySet<string>, generateSuffix?: () => string): V4IdByKind[K];
+export declare function generateV4Ids<K extends V4IdKind>(kind: K, count: number, existing?: ReadonlySet<string>): V4IdByKind[K][];

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

@@ -0,0 +1,63 @@
+import { customAlphabet } from "nanoid";
+import { CliError, EXIT_INPUT } from "../../../common.js";
+export const V4_ID_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+export const V4_ID_RANDOM_LENGTH = 6;
+export const V4_ID_PREFIXES = {
+    episode: "ep",
+    scene: "scn",
+    action: "ac",
+    actor: "act",
+    location: "loc",
+    prop: "prp",
+    state: "st",
+};
+const randomSuffix = customAlphabet(V4_ID_ALPHABET, V4_ID_RANDOM_LENGTH);
+const alphabetClass = `[${V4_ID_ALPHABET}]`;
+export const V4_ID_PATTERNS = Object.fromEntries(Object.entries(V4_ID_PREFIXES).map(([kind, prefix]) => [
+    kind,
+    new RegExp(`^${prefix}${alphabetClass}{${V4_ID_RANDOM_LENGTH}}$`),
+]));
+export function isV4Id(kind, value) {
+    return typeof value === "string" && V4_ID_PATTERNS[kind].test(value);
+}
+export function requireV4Id(kind, value, path) {
+    if (isV4Id(kind, value))
+        return value;
+    throw new CliError("SCRIPT V4 BLOCKED: invalid ID", `${path} must be ${V4_ID_PREFIXES[kind]} plus six Base58 characters.`, {
+        exitCode: EXIT_INPUT,
+        errorCode: "SCRIPT_V4_ID_INVALID",
+        required: [`${V4_ID_PREFIXES[kind]} + 6 Bitcoin Base58 characters`],
+        received: [String(value)],
+    });
+}
+export function generateV4Id(kind, existing = new Set(), generateSuffix = randomSuffix) {
+    const prefix = V4_ID_PREFIXES[kind];
+    for (let attempt = 0; attempt < 128; attempt++) {
+        const candidate = `${prefix}${generateSuffix()}`;
+        if (!existing.has(candidate))
+            return candidate;
+    }
+    throw new CliError("ID GENERATION BLOCKED", `Could not generate an unused ${kind} ID.`, {
+        exitCode: EXIT_INPUT,
+        errorCode: "ID_SPACE_RETRY_EXHAUSTED",
+        nextSteps: ["Retry the command. If this persists, inspect the configured ID generator."],
+    });
+}
+export function generateV4Ids(kind, count, existing = new Set()) {
+    if (!Number.isSafeInteger(count) || count < 1) {
+        throw new CliError("IDS BLOCKED: count invalid", "count must be a positive integer.", {
+            exitCode: EXIT_INPUT,
+            errorCode: "ID_COUNT_INVALID",
+            received: [String(count)],
+        });
+    }
+    const seen = new Set(existing);
+    const ids = [];
+    while (ids.length < count) {
+        const id = generateV4Id(kind, seen);
+        seen.add(id);
+        ids.push(id);
+    }
+    return ids;
+}
+//# sourceMappingURL=ids.js.map

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

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

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

@@ -0,0 +1,3 @@
+import { type V4Address } from "./address.js";
+import type { ScriptV4 } from "./types.js";
+export declare function resolveV4Ordinal(script: ScriptV4, raw: string): V4Address;

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

@@ -0,0 +1,67 @@
+import { CliError, EXIT_USAGE } from "../../../common.js";
+import { listActionLocationsV4, listEpisodeLocationsV4, listSceneLocationsV4, } from "./address.js";
+function ordinalError(raw, detail) {
+    throw new CliError("QUERY BLOCKED: ordinal anchor invalid", detail, {
+        exitCode: EXIT_USAGE,
+        errorCode: "ORDINAL_ANCHOR_INVALID",
+        required: [
+            "@ep:N | @ep:N/scn:N | @ep:N/scn:N/ac:N | @scn:N | @scn:N/ac:N | @ac:N",
+        ],
+        received: [raw],
+    });
+}
+function positive(raw, anchor) {
+    if (!/^[1-9]\d*$/.test(raw))
+        ordinalError(anchor, "Ordinal positions are 1-based positive integers.");
+    return Number(raw);
+}
+export function resolveV4Ordinal(script, raw) {
+    let match = /^@ep:(\d+)$/.exec(raw);
+    if (match) {
+        const row = listEpisodeLocationsV4(script)[positive(match[1], raw) - 1];
+        if (!row)
+            ordinalError(raw, "Episode ordinal is outside the current script.");
+        return { kind: "episode", id: row.episode.episode_id };
+    }
+    match = /^@ep:(\d+)\/scn:(\d+)$/.exec(raw);
+    if (match) {
+        const episode = listEpisodeLocationsV4(script)[positive(match[1], raw) - 1];
+        const scene = episode?.episode.scenes[positive(match[2], raw) - 1];
+        if (!episode || !scene)
+            ordinalError(raw, "Episode-local scene ordinal is outside the current script.");
+        return { kind: "scene", id: scene.scene_id };
+    }
+    match = /^@ep:(\d+)\/scn:(\d+)\/ac:(\d+)$/.exec(raw);
+    if (match) {
+        const episode = listEpisodeLocationsV4(script)[positive(match[1], raw) - 1];
+        const scene = episode?.episode.scenes[positive(match[2], raw) - 1];
+        const action = scene?.actions[positive(match[3], raw) - 1];
+        if (!episode || !scene || !action)
+            ordinalError(raw, "Episode-local action ordinal is outside the current script.");
+        return { kind: "action", id: action.action_id };
+    }
+    match = /^@scn:(\d+)$/.exec(raw);
+    if (match) {
+        const row = listSceneLocationsV4(script)[positive(match[1], raw) - 1];
+        if (!row)
+            ordinalError(raw, "Global scene ordinal is outside the current script.");
+        return { kind: "scene", id: row.scene.scene_id };
+    }
+    match = /^@scn:(\d+)\/ac:(\d+)$/.exec(raw);
+    if (match) {
+        const row = listSceneLocationsV4(script)[positive(match[1], raw) - 1];
+        const action = row?.scene.actions[positive(match[2], raw) - 1];
+        if (!row || !action)
+            ordinalError(raw, "Scene-local action ordinal is outside the current script.");
+        return { kind: "action", id: action.action_id };
+    }
+    match = /^@ac:(\d+)$/.exec(raw);
+    if (match) {
+        const row = listActionLocationsV4(script)[positive(match[1], raw) - 1];
+        if (!row)
+            ordinalError(raw, "Global action ordinal is outside the current script.");
+        return { kind: "action", id: row.action.action_id };
+    }
+    return ordinalError(raw, "Ordinal anchor syntax is not supported.");
+}
+//# sourceMappingURL=ordinal.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { ScriptV4 } from "./types.js";
+export declare function isScriptV4(value: unknown): value is ScriptV4;
+export declare function requireScriptV4(value: unknown): ScriptV4;

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

@@ -0,0 +1,18 @@
+import { CliError, EXIT_INPUT } from "../../../common.js";
+import { validateScriptV4 } from "./validation.js";
+export function isScriptV4(value) {
+    return validateScriptV4(value).ok;
+}
+export function requireScriptV4(value) {
+    const validation = validateScriptV4(value);
+    if (validation.ok)
+        return value;
+    throw new CliError("SCRIPT V4 BLOCKED: local script invalid", "The local file is not a valid Script v4 document.", {
+        exitCode: EXIT_INPUT,
+        errorCode: "SCRIPT_V4_INVALID",
+        required: ["A valid Script v4 document"],
+        received: validation.errors.slice(0, 20).map((issue) => `${issue.path}: ${issue.message}`),
+        nextSteps: ["Run `scriptctl validate --script-path <path>` and repair the reported v4 fields."],
+    });
+}
+//# sourceMappingURL=parse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/domain/script/v4/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,EAAE;QAAE,OAAO,KAAiB,CAAC;IAC5C,MAAM,IAAI,QAAQ,CAAC,yCAAyC,EAAE,mDAAmD,EAAE;QACjH,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,CAAC,4BAA4B,CAAC;QACxC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1F,SAAS,EAAE,CAAC,kFAAkF,CAAC;KAChG,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1,24 @@
+import { CliError, EXIT_USAGE } from "../../../../common.js";
+import { strOf } from "../../shared.js";
+import { V4_OP_REGISTRY } from "./registry.js";
+export function applyPatchOperationsV4(script, operations) {
+    const applied = [];
+    const run = (ops) => {
+        for (const op of ops) {
+            const kind = strOf(op.op);
+            const handler = V4_OP_REGISTRY[kind];
+            if (!handler) {
+                throw new CliError("SCRIPT V4 PATCH BLOCKED: unsupported operation", `Operation ${kind} is not supported by Script v4.`, {
+                    exitCode: EXIT_USAGE,
+                    errorCode: "V4_OP_UNSUPPORTED",
+                    received: [kind || "<empty>"],
+                    nextSteps: ["Run `scriptctl patch --schema` and use an operation supported by the target script version."],
+                });
+            }
+            handler({ script, op, applied, kind, runOps: run });
+        }
+        return applied;
+    };
+    return run(operations);
+}
+//# sourceMappingURL=apply.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../../src/domain/script/v4/patch/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAa,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,MAAgB,EAAE,UAAkB;IACzE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,CAAC,GAAW,EAAY,EAAE;QACpC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,QAAQ,CAAC,gDAAgD,EAAE,aAAa,IAAI,iCAAiC,EAAE;oBACvH,QAAQ,EAAE,UAAU;oBACpB,SAAS,EAAE,mBAAmB;oBAC9B,QAAQ,EAAE,CAAC,IAAI,IAAI,SAAS,CAAC;oBAC7B,SAAS,EAAE,CAAC,6FAA6F,CAAC;iBAC3G,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IACF,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,32 @@
+import { type Dict } from "../../shared.js";
+import type { ActionLocationV4 } from "../address.js";
+import type { ActorV4, ActorIdV4, LocationV4, LocationIdV4, PropV4, PropIdV4, SceneV4, ScriptV4, StateIdV4, StateV4 } from "../types.js";
+export declare function opUsage(title: string, message: string, opts: {
+    code: string;
+    required?: string[];
+    received?: string[];
+    next?: string[];
+    input?: boolean;
+}): never;
+export declare function requireAction(script: ScriptV4, raw: unknown): ActionLocationV4;
+export declare function requireScene(script: ScriptV4, raw: unknown): SceneV4;
+export declare function requireAsset(script: ScriptV4, raw: unknown): {
+    kind: "actor";
+    id: ActorIdV4;
+    asset: ActorV4;
+} | {
+    kind: "location";
+    id: LocationIdV4;
+    asset: LocationV4;
+} | {
+    kind: "prop";
+    id: PropIdV4;
+    asset: PropV4;
+};
+export declare function requireState(script: ScriptV4, raw: unknown): {
+    owner: ReturnType<typeof requireAsset>;
+    state: StateV4;
+    stateIndex: number;
+};
+export declare function normalizedStateIds(asset: ActorV4 | LocationV4 | PropV4, raw: unknown): StateIdV4[];
+export declare function stringField(op: Dict, key: string): string;