@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/domain/script/v3/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-v3 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. v3 has no speaker
+ * roster (dialogue speakers are inline on each action).
+ */
+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;

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

@@ -0,0 +1,316 @@
+import { CliError, EXIT_USAGE, fmtId, } from "../../../common.js";
+import { cleanName, stateLabelError } from "../text-util.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("Action not found.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "PATCH_BLOCKED_ACTION_NOT_FOUND",
+        hint: "Inspect episodes and fix the patch.",
+        data: { expected: ["existing episode_id, scene_id, action_index"], actual: [`${epId} ${sceneId} ${actionIndex}`] },
+    });
+}
+export function findEpisode(script, epId) {
+    for (const ep of asList(script["episodes"])) {
+        if (ep["episode_id"] === epId)
+            return ep;
+    }
+    throw new CliError("Episode not found.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "PATCH_BLOCKED_EPISODE_NOT_FOUND",
+        hint: "Inspect episodes and fix the patch.",
+        data: { expected: ["existing episode_id"], actual: [epId] },
+    });
+}
+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("Scene not found.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "PATCH_BLOCKED_SCENE_NOT_FOUND",
+        hint: "Inspect episodes and fix the patch.",
+        data: { expected: ["existing episode_id and scene_id"], actual: [`${epId} ${sceneId}`] },
+    });
+}
+// ---------------------------------------------------------------------------
+// blank scaffold
+// ---------------------------------------------------------------------------
+/**
+ * Minimal schema-v3 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. v3 has no speaker
+ * roster (dialogue speakers are inline on each action).
+ */
+export function blankScript(title = "") {
+    return {
+        version: 3,
+        title: title,
+        worldview: "",
+        style: "",
+        actors: [],
+        locations: [],
+        props: [],
+        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("Asset type invalid.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "PATCH_BLOCKED_ASSET_TYPE_INVALID",
+            hint: "Fix the patch operation and rerun patch.",
+            data: { expected: ["asset_type: actor, location, or prop"], actual: [`asset_type: ${assetType}`] },
+        });
+    }
+    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("Asset not found.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "PATCH_BLOCKED_ASSET_NOT_FOUND",
+            hint: "Inspect assets and fix the patch.",
+            data: { expected: [`existing ${idKey} or ${nameKey}`], actual: [JSON.stringify(op)] },
+        });
+    }
+    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("States invalid.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "PATCH_BLOCKED_STATES_INVALID",
+            hint: "Fix the patch operation and rerun patch.",
+            data: { expected: ["states: array of state names or {state_id,state_name} objects"], actual: [typeof rawStates] },
+        });
+    }
+    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("State label invalid.", {
+                    exitCode: EXIT_USAGE,
+                    errorCode: "STATE_LABEL_INVALID",
+                    hint: "Do not combine multiple states into one label.",
+                    data: { expected: ["one clear state label"], actual: [name] },
+                });
+            }
+        }
+        seenNames.add(name);
+        states.push({ state_id: sid, state_name: name, description: "" });
+    }
+    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("Reference target not found.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "PATCH_BLOCKED_REFERENCE_TARGET_NOT_FOUND",
+            hint: "Inspect assets and fix the patch.",
+            data: { expected: [`existing ${idKey}`], actual: [`${idKey}: ${value || "<empty>"}`] },
+        });
+    }
+    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",
+        });
+    }
+    // v3 requires an importance tier and exactly one 'default' state per asset;
+    // seed both so a freshly-added asset validates clean. importance defaults to
+    // featured (a manually-registered asset is presumed a real character/place/
+    // prop); pass importance: background for a 龙套/背景.
+    const rawImp = strOf(op["importance"]).trim();
+    if (rawImp && rawImp !== "featured" && rawImp !== "background") {
+        throw opErr("SCRIPT OP BLOCKED: Importance invalid", "Importance invalid.", {
+            required: ["importance: featured or background"], received: [rawImp],
+            nextSteps: ["Use featured (主角/配角) or background (龙套/背景)."], op: `${kind}.add`, errorCode: "IMPORTANCE_INVALID",
+        });
+    }
+    const entity = {
+        [idKey]: id,
+        [nameKey]: name,
+        importance: rawImp || "featured",
+        description: strOf(op["description"]).trim(),
+        states: [{ state_id: "default", state_name: "default", description: "" }],
+    };
+    coll.push(entity);
+    return entity;
+}
+//# sourceMappingURL=lookups.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { type Dict } from "../shared.js";
+import { type InSelector } from "./selector.js";
+import type { ScriptV3 } from "../types.js";
+type V3QueryScript = ScriptV3 | Dict;
+export declare function resolveV3Ordinal(script: V3QueryScript, raw: string): string;
+export declare function normalizeV3QuerySelector(script: V3QueryScript, rawValue: unknown): string;
+export declare function parseV3QuerySelector(script: V3QueryScript, rawValue: unknown): InSelector;
+export {};

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

@@ -0,0 +1,91 @@
+import { CliError, EXIT_USAGE } from "../../../common.js";
+import { asList, strOf } from "../shared.js";
+import { parseInSelector } from "./selector.js";
+function invalid(raw, message) {
+    throw new CliError(message, {
+        exitCode: EXIT_USAGE,
+        errorCode: "ORDINAL_ANCHOR_INVALID",
+        data: { actual: [raw], expected: [
+                "@ep:N | @ep:N/scn:N | @ep:N/scn:N/ac:N | @scn:N | @scn:N/ac:N | @ac:N",
+            ] },
+    });
+}
+function position(raw, anchor) {
+    if (!/^[1-9]\d*$/.test(raw))
+        invalid(anchor, "Ordinal positions are 1-based positive integers.");
+    return Number(raw) - 1;
+}
+export function resolveV3Ordinal(script, raw) {
+    const episodes = asList(script["episodes"]);
+    let match = /^@ep:(\d+)$/.exec(raw);
+    if (match) {
+        const episode = episodes[position(match[1], raw)];
+        if (!episode)
+            invalid(raw, "Episode ordinal is outside the current script.");
+        return strOf(episode["episode_id"]);
+    }
+    match = /^@ep:(\d+)\/scn:(\d+)$/.exec(raw);
+    if (match) {
+        const episode = episodes[position(match[1], raw)];
+        const scene = asList(episode?.["scenes"])[position(match[2], raw)];
+        if (!episode || !scene)
+            invalid(raw, "Episode-local scene ordinal is outside the current script.");
+        return `${strOf(episode["episode_id"])}/${strOf(scene["scene_id"])}`;
+    }
+    match = /^@ep:(\d+)\/scn:(\d+)\/ac:(\d+)$/.exec(raw);
+    if (match) {
+        const episode = episodes[position(match[1], raw)];
+        const scene = asList(episode?.["scenes"])[position(match[2], raw)];
+        const actionIndex = position(match[3], raw);
+        if (!episode || !scene || !asList(scene["actions"])[actionIndex])
+            invalid(raw, "Episode-local action ordinal is outside the current script.");
+        return `${strOf(episode["episode_id"])}/${strOf(scene["scene_id"])}#${actionIndex}`;
+    }
+    const scenes = episodes.flatMap((episode) => asList(episode["scenes"]).map((scene) => ({ episode, scene })));
+    match = /^@scn:(\d+)$/.exec(raw);
+    if (match) {
+        const row = scenes[position(match[1], raw)];
+        if (!row)
+            invalid(raw, "Global scene ordinal is outside the current script.");
+        return `${strOf(row.episode["episode_id"])}/${strOf(row.scene["scene_id"])}`;
+    }
+    match = /^@scn:(\d+)\/ac:(\d+)$/.exec(raw);
+    if (match) {
+        const row = scenes[position(match[1], raw)];
+        const actionIndex = position(match[2], raw);
+        if (!row || !asList(row.scene["actions"])[actionIndex])
+            invalid(raw, "Scene-local action ordinal is outside the current script.");
+        return `${strOf(row.episode["episode_id"])}/${strOf(row.scene["scene_id"])}#${actionIndex}`;
+    }
+    match = /^@ac:(\d+)$/.exec(raw);
+    if (match) {
+        const actions = scenes.flatMap((row) => asList(row.scene["actions"]).map((_, actionIndex) => ({ ...row, actionIndex })));
+        const row = actions[position(match[1], raw)];
+        if (!row)
+            invalid(raw, "Global action ordinal is outside the current script.");
+        return `${strOf(row.episode["episode_id"])}/${strOf(row.scene["scene_id"])}#${row.actionIndex}`;
+    }
+    return invalid(raw, "Ordinal anchor syntax is not supported.");
+}
+export function normalizeV3QuerySelector(script, rawValue) {
+    const raw = typeof rawValue === "string" ? rawValue.trim() : "";
+    if (!raw || raw === "*")
+        return raw;
+    return raw.split(",").map((segmentValue) => {
+        const segment = segmentValue.trim();
+        const parts = segment.split("..");
+        if (parts.length > 2) {
+            if (segment.includes("@"))
+                invalid(segment, "Selector region has too many range delimiters.");
+            return segment;
+        }
+        return parts.map((part) => {
+            const endpoint = part.trim();
+            return endpoint.startsWith("@") ? resolveV3Ordinal(script, endpoint) : endpoint;
+        }).join("..");
+    }).join(",");
+}
+export function parseV3QuerySelector(script, rawValue) {
+    return parseInSelector(normalizeV3QuerySelector(script, rawValue));
+}
+//# sourceMappingURL=ordinal.js.map

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

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

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

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

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

@@ -0,0 +1,164 @@
+import { CliError, EXIT_INPUT } from "../../../common.js";
+import { ACTION_TYPE_SET, IMPORTANCE_TIER_SET, NON_ACTOR_SPEAKER_KIND_SET, } from "./types.js";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function optionalString(record, key) {
+    return record[key] === undefined || typeof record[key] === "string";
+}
+function isJsonValue(value) {
+    if (value === null
+        || typeof value === "string"
+        || typeof value === "number"
+        || typeof value === "boolean")
+        return true;
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    return isRecord(value) && Object.values(value).every(isJsonValue);
+}
+function hasValidExtension(record) {
+    return record.extend === undefined
+        || (isRecord(record.extend) && Object.values(record.extend).every(isJsonValue));
+}
+function isState(value) {
+    return isRecord(value)
+        && typeof value.state_id === "string"
+        && typeof value.state_name === "string"
+        && typeof value.description === "string"
+        && hasValidExtension(value);
+}
+function isActor(value) {
+    return isRecord(value)
+        && typeof value.actor_id === "string"
+        && typeof value.actor_name === "string"
+        && typeof value.description === "string"
+        && typeof value.importance === "string"
+        && IMPORTANCE_TIER_SET.has(value.importance)
+        && (value.aliases === undefined || (Array.isArray(value.aliases) && value.aliases.every((item) => typeof item === "string")))
+        && (value.role_type === undefined || value.role_type === "主角" || value.role_type === "配角")
+        && Array.isArray(value.states)
+        && value.states.every(isState)
+        && hasValidExtension(value);
+}
+function isLocation(value) {
+    return isRecord(value)
+        && typeof value.location_id === "string"
+        && typeof value.location_name === "string"
+        && typeof value.description === "string"
+        && typeof value.importance === "string"
+        && IMPORTANCE_TIER_SET.has(value.importance)
+        && (value.aliases === undefined || (Array.isArray(value.aliases) && value.aliases.every((item) => typeof item === "string")))
+        && Array.isArray(value.states)
+        && value.states.every(isState)
+        && hasValidExtension(value);
+}
+function isProp(value) {
+    return isRecord(value)
+        && typeof value.prop_id === "string"
+        && typeof value.prop_name === "string"
+        && typeof value.description === "string"
+        && typeof value.importance === "string"
+        && IMPORTANCE_TIER_SET.has(value.importance)
+        && (value.aliases === undefined || (Array.isArray(value.aliases) && value.aliases.every((item) => typeof item === "string")))
+        && Array.isArray(value.states)
+        && value.states.every(isState)
+        && hasValidExtension(value);
+}
+function isAction(value) {
+    if (!isRecord(value)
+        || typeof value.type !== "string"
+        || !ACTION_TYPE_SET.has(value.type)
+        || typeof value.content !== "string"
+        || !optionalString(value, "emotion"))
+        return false;
+    if (value.speaker !== undefined) {
+        if (!isRecord(value.speaker))
+            return false;
+        if (typeof value.speaker.actor_id === "string") {
+            if (!optionalString(value.speaker, "state_id"))
+                return false;
+        }
+        else if (typeof value.speaker.kind === "string") {
+            if (!NON_ACTOR_SPEAKER_KIND_SET.has(value.speaker.kind) || !optionalString(value.speaker, "label"))
+                return false;
+        }
+        else {
+            return false;
+        }
+    }
+    if (value.transition_prompt !== undefined) {
+        if (!isRecord(value.transition_prompt)
+            || typeof value.transition_prompt.target !== "string"
+            || typeof value.transition_prompt.process !== "string"
+            || typeof value.transition_prompt.contrast !== "string")
+            return false;
+    }
+    return hasValidExtension(value);
+}
+function isScene(value) {
+    if (!isRecord(value)
+        || typeof value.scene_id !== "string"
+        || !Array.isArray(value.actors)
+        || !Array.isArray(value.props)
+        || !Array.isArray(value.actions)
+        || !value.actions.every(isAction))
+        return false;
+    if (!value.actors.every((ref) => isRecord(ref) && typeof ref.actor_id === "string" && optionalString(ref, "state_id")))
+        return false;
+    if (!value.props.every((ref) => isRecord(ref) && typeof ref.prop_id === "string" && optionalString(ref, "state_id")))
+        return false;
+    if (value.location !== null
+        && (!isRecord(value.location)
+            || typeof value.location.location_id !== "string"
+            || !optionalString(value.location, "state_id")))
+        return false;
+    if (value.environment !== undefined
+        && (!isRecord(value.environment)
+            || !optionalString(value.environment, "space")
+            || !optionalString(value.environment, "time")))
+        return false;
+    return hasValidExtension(value);
+}
+function isEpisode(value) {
+    return isRecord(value)
+        && typeof value.episode_id === "string"
+        && optionalString(value, "title")
+        && optionalString(value, "synopsis")
+        && Array.isArray(value.scenes)
+        && value.scenes.every(isScene)
+        && hasValidExtension(value);
+}
+export function isScriptV3(value) {
+    return isRecord(value)
+        && value.version === 3
+        && typeof value.title === "string"
+        && typeof value.worldview === "string"
+        && typeof value.style === "string"
+        && optionalString(value, "worldview_raw")
+        && optionalString(value, "synopsis")
+        && optionalString(value, "logline")
+        && optionalString(value, "theme")
+        && (value.main_characters === undefined
+            || (Array.isArray(value.main_characters)
+                && value.main_characters.every((item) => isRecord(item) && typeof item.name === "string" && typeof item.role === "string")))
+        && Array.isArray(value.actors)
+        && value.actors.every(isActor)
+        && Array.isArray(value.locations)
+        && value.locations.every(isLocation)
+        && Array.isArray(value.props)
+        && value.props.every(isProp)
+        && Array.isArray(value.episodes)
+        && value.episodes.every(isEpisode)
+        && hasValidExtension(value);
+}
+export function requireScriptV3(value) {
+    if (isScriptV3(value))
+        return value;
+    throw new CliError("The local file is not a structurally readable Script v3 document.", {
+        exitCode: EXIT_INPUT,
+        errorCode: "SCRIPT_V3_SHAPE_INVALID",
+        hint: "Repair the local Script v3 structure, then rerun authoring.",
+        data: { expected: ["Script v3 with typed assets, episodes, scenes, and actions"], actual: [Array.isArray(value) ? "array" : typeof value] },
+    });
+}
+//# sourceMappingURL=parse.js.map