@lingjingai/scriptctl 0.49.16 → 0.50.0

package/dist/domain/script/selector.js

@@ -1,185 +1,2 @@
-import { CliError, EXIT_USAGE, } from "../../common.js";
-import { asList, idNum, strOf } from "./shared.js";
-import { parseAnyAddress } from "./address.js";
-export const MAX_GREP_PATTERN_LEN = 256;
-export function isDangerousRegex(pattern) {
-    if (pattern.length > MAX_GREP_PATTERN_LEN)
-        return true;
-    return /\([^)]*[*+?{][^)]*\)[*+?{]/.test(pattern);
-}
-export function cmpAction(a, b) {
-    return a.scn - b.scn || a.idx - b.idx;
-}
-export function regionMatchesScene(r, ep, scn) {
-    switch (r.level) {
-        case "episode": return ep >= r.lo && ep <= r.hi;
-        case "scene": return scn >= r.lo && scn <= r.hi;
-        case "action": return scn >= r.lo.scn && scn <= r.hi.scn;
-    }
-}
-export function regionMatchesAction(r, ep, scn, idx) {
-    switch (r.level) {
-        case "episode": return ep >= r.lo && ep <= r.hi;
-        case "scene": return scn >= r.lo && scn <= r.hi;
-        case "action": {
-            const p = { scn, idx };
-            // Lexicographic (scn, idx) containment covers same-scene, cross-scene
-            // start/internal/end in one comparison.
-            return cmpAction(r.lo, p) <= 0 && cmpAction(p, r.hi) <= 0;
-        }
-    }
-}
-export class RegionSelector {
-    regions;
-    constructor(regions) {
-        this.regions = regions;
-    }
-    get isEmpty() {
-        return this.regions.length === 0;
-    }
-    matchesScene(epId, sceneId) {
-        if (this.regions.length === 0)
-            return true;
-        const ep = idNum(epId, "ep");
-        const scn = idNum(sceneId, "scn");
-        return this.regions.some((r) => regionMatchesScene(r, ep, scn));
-    }
-    matchesAction(epId, sceneId, idx) {
-        if (this.regions.length === 0)
-            return true;
-        const ep = idNum(epId, "ep");
-        const scn = idNum(sceneId, "scn");
-        return this.regions.some((r) => regionMatchesAction(r, ep, scn, idx));
-    }
-}
-export function inSelectorError(detail, received) {
-    return new CliError("QUERY BLOCKED: --in address invalid", "--in address invalid.", {
-        exitCode: EXIT_USAGE,
-        required: ["--in: ep_NNN | ep_NNN/scn_NNN | ep_NNN/scn_NNN#idx; ranges via '..'; multiple regions comma-separated"],
-        received: [`${received} (${detail})`],
-        nextSteps: ["Example: ep_003..ep_007,ep_010/scn_001..ep_010/scn_004"],
-        errorCode: "IN_ADDRESS_INVALID",
-    });
-}
-export function parseRegion(region, full) {
-    const parts = region.split("..");
-    if (parts.length > 2)
-        throw inSelectorError(`too many '..' in "${region}"`, full);
-    const loRaw = parts[0].trim();
-    const hiRaw = (parts.length === 2 ? parts[1] : parts[0]).trim();
-    if (!loRaw || !hiRaw)
-        throw inSelectorError(`empty range endpoint in "${region}"`, full);
-    let loAddr;
-    let hiAddr;
-    try {
-        loAddr = parseAnyAddress(loRaw);
-        hiAddr = parseAnyAddress(hiRaw);
-    }
-    catch {
-        throw inSelectorError(`endpoint not a valid address in "${region}"`, full);
-    }
-    if (loAddr.kind !== hiAddr.kind) {
-        throw new CliError("QUERY BLOCKED: --in range endpoints mismatch", "Range endpoints must be the same address kind.", {
-            exitCode: EXIT_USAGE,
-            required: ["both endpoints episode | scene | action"],
-            received: [`${loRaw}(${loAddr.kind})..${hiRaw}(${hiAddr.kind})`],
-            nextSteps: ["Make both endpoints the same kind, e.g. ep_003..ep_007 or ep_001/scn_002..ep_003/scn_009."],
-            errorCode: "IN_RANGE_KIND_MISMATCH",
-        });
-    }
-    if (loAddr.kind === "episode" && hiAddr.kind === "episode") {
-        const a = idNum(loAddr.episodeId, "ep");
-        const b = idNum(hiAddr.episodeId, "ep");
-        if (Number.isNaN(a) || Number.isNaN(b))
-            throw inSelectorError(`malformed episode id in "${region}"`, full);
-        return a <= b ? { level: "episode", lo: a, hi: b } : { level: "episode", lo: b, hi: a };
-    }
-    if (loAddr.kind === "scene" && hiAddr.kind === "scene") {
-        const a = idNum(loAddr.sceneId, "scn");
-        const b = idNum(hiAddr.sceneId, "scn");
-        if (Number.isNaN(a) || Number.isNaN(b))
-            throw inSelectorError(`malformed scene id in "${region}"`, full);
-        return a <= b ? { level: "scene", lo: a, hi: b } : { level: "scene", lo: b, hi: a };
-    }
-    if (loAddr.kind === "action" && hiAddr.kind === "action") {
-        const a = { scn: idNum(loAddr.sceneId, "scn"), idx: loAddr.actionIndex };
-        const b = { scn: idNum(hiAddr.sceneId, "scn"), idx: hiAddr.actionIndex };
-        if (Number.isNaN(a.scn) || Number.isNaN(b.scn))
-            throw inSelectorError(`malformed scene id in "${region}"`, full);
-        return cmpAction(a, b) <= 0 ? { level: "action", lo: a, hi: b } : { level: "action", lo: b, hi: a };
-    }
-    // asset / state / speaker addresses are not valid scope anchors for --in.
-    throw inSelectorError(`address kind '${loAddr.kind}' not valid in --in`, full);
-}
-// Whole-script selector: `--in '*'`. Distinct from an empty selector — it
-// matches everything but `isEmpty` is false, so writes can tell "scope is
-// intentionally the whole script" apart from "no scope given" (a bare,
-// dangerous dump that callers refuse).
-export const WHOLE_SCRIPT = {
-    isEmpty: false,
-    matchesScene: () => true,
-    matchesAction: () => true,
-};
-export function parseInSelector(raw) {
-    const value = strOf(raw).trim();
-    if (!value)
-        return new RegionSelector([]);
-    if (value === "*")
-        return WHOLE_SCRIPT;
-    const regions = [];
-    for (const seg of value.split(",")) {
-        const region = seg.trim();
-        if (!region)
-            throw inSelectorError("empty region (stray comma?)", value);
-        regions.push(parseRegion(region, value));
-    }
-    return new RegionSelector(regions);
-}
-// When the entire selector is a single action point (e.g. `ep_001/scn_003#2`),
-// asset queries preserve their legacy "narrow to that one action's refs"
-// behavior. Any range or multi-region selector falls back to the union over
-// matched scenes. Returns the global scn number + action index, or null.
-export function selectorSingleActionPoint(sel) {
-    if (!(sel instanceof RegionSelector))
-        return null;
-    if (sel.regions.length !== 1)
-        return null;
-    const r = sel.regions[0];
-    if (r.level !== "action")
-        return null;
-    if (r.lo.scn !== r.hi.scn || r.lo.idx !== r.hi.idx)
-        return null;
-    return { scn: r.lo.scn, idx: r.lo.idx };
-}
-// Expand a selector into the concrete action refs (`ep/scn#idx`, 0-based) it
-// matches, in document order. The batch-edit framework feeds these straight
-// into parseActionRef-based ops. Scene IDs remain stable throughout.
-export function expandSelectorToActionRefs(script, selector) {
-    const refs = [];
-    for (const ep of asList(script["episodes"])) {
-        const epId = strOf(ep["episode_id"]);
-        for (const scene of asList(ep["scenes"])) {
-            const sceneId = strOf(scene["scene_id"]);
-            if (!selector.matchesScene(epId, sceneId))
-                continue;
-            const actions = asList(scene["actions"]);
-            for (let i = 0; i < actions.length; i++) {
-                if (!selector.matchesAction(epId, sceneId, i))
-                    continue;
-                refs.push(`${epId}/${sceneId}#${i}`);
-            }
-        }
-    }
-    return refs;
-}
-// Reverse lookup for asset / speaker references. Parallel to collectStateRefs
-// but tracks where an actor/location/prop/speaker is mentioned rather than
-// where a specific state is mentioned. Returns one `{target, location, role}`
-// entry per reference site. Walks the same edges the validator does
-// (script-core.ts validateScript) so coverage is complete:
-//   - scene.context.{actors|locations|props}[]
-//   - action.actor_id (actor only)
-//   - action.speaker_id + action.speakers[] + action.lines[].speaker_id (speaker only)
-//   - action.state_changes[].target_{kind,id}
-//   - action.transition_prompt.target_{kind,id}
+export * from "./v3/selector.js";
 //# sourceMappingURL=selector.js.map

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

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

package/dist/domain/script/shared/regex.d.ts

@@ -0,0 +1,2 @@
+export declare const MAX_GREP_PATTERN_LEN = 256;
+export declare function isDangerousRegex(pattern: string): boolean;

package/dist/domain/script/shared/regex.js

@@ -0,0 +1,7 @@
+export const MAX_GREP_PATTERN_LEN = 256;
+export function isDangerousRegex(pattern) {
+    if (pattern.length > MAX_GREP_PATTERN_LEN)
+        return true;
+    return /\([^)]*[*+?{][^)]*\)[*+?{]/.test(pattern);
+}
+//# sourceMappingURL=regex.js.map

package/dist/domain/script/shared/regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../../../src/domain/script/shared/regex.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,oBAAoB;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/domain/script/shared/types.d.ts

@@ -0,0 +1,18 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ExtensionMap = Record<string, JsonValue>;
+export declare const ACTION_TYPES: readonly ["action", "dialogue", "inner_thought", "transition"];
+export type ActionType = (typeof ACTION_TYPES)[number];
+export declare const ACTION_TYPE_SET: ReadonlySet<string>;
+export declare const NON_ACTOR_SPEAKER_KINDS: readonly ["system", "broadcast", "offscreen", "group"];
+export type NonActorSpeakerKind = (typeof NON_ACTOR_SPEAKER_KINDS)[number];
+export declare const NON_ACTOR_SPEAKER_KIND_SET: ReadonlySet<string>;
+export declare const IMPORTANCE_TIERS: readonly ["featured", "background"];
+export type Importance = (typeof IMPORTANCE_TIERS)[number];
+export declare const IMPORTANCE_TIER_SET: ReadonlySet<string>;
+export declare const ROLE_TYPES: readonly ["主角", "配角"];
+export type RoleType = (typeof ROLE_TYPES)[number];
+export declare const ROLE_TYPE_SET: ReadonlySet<string>;
+export type AssetKind = "actor" | "location" | "prop";

package/dist/domain/script/shared/types.js

@@ -0,0 +1,9 @@
+export const ACTION_TYPES = ["action", "dialogue", "inner_thought", "transition"];
+export const ACTION_TYPE_SET = new Set(ACTION_TYPES);
+export const NON_ACTOR_SPEAKER_KINDS = ["system", "broadcast", "offscreen", "group"];
+export const NON_ACTOR_SPEAKER_KIND_SET = new Set(NON_ACTOR_SPEAKER_KINDS);
+export const IMPORTANCE_TIERS = ["featured", "background"];
+export const IMPORTANCE_TIER_SET = new Set(IMPORTANCE_TIERS);
+export const ROLE_TYPES = ["主角", "配角"];
+export const ROLE_TYPE_SET = new Set(ROLE_TYPES);
+//# sourceMappingURL=types.js.map

package/dist/domain/script/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/domain/script/shared/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,CAAU,CAAC;AAE3F,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAE9F,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAC;AAEpE,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAElF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC"}

package/dist/domain/script/shared/validation.d.ts

@@ -0,0 +1,10 @@
+export type ValidationIssue = {
+    code: string;
+    path: string;
+    message: string;
+};
+export type ValidationResult = {
+    ok: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+};

package/dist/domain/script/shared/validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.js.map

package/dist/domain/script/shared/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/domain/script/shared/validation.ts"],"names":[],"mappings":""}

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

@@ -1,123 +1 @@
-export type JsonPrimitive = string | number | boolean | null;
-export type JsonValue = JsonPrimitive | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-export type ExtensionMap = Record<string, JsonValue>;
-export declare const ACTION_TYPES: readonly ["action", "dialogue", "inner_thought", "transition"];
-export type ActionType = (typeof ACTION_TYPES)[number];
-export declare const ACTION_TYPE_SET: ReadonlySet<string>;
-export declare const NON_ACTOR_SPEAKER_KINDS: readonly ["system", "broadcast", "offscreen", "group"];
-export type NonActorSpeakerKind = (typeof NON_ACTOR_SPEAKER_KINDS)[number];
-export declare const NON_ACTOR_SPEAKER_KIND_SET: ReadonlySet<string>;
-export declare const IMPORTANCE_TIERS: readonly ["featured", "background"];
-export type Importance = (typeof IMPORTANCE_TIERS)[number];
-export declare const IMPORTANCE_TIER_SET: ReadonlySet<string>;
-export declare const ROLE_TYPES: readonly ["主角", "配角"];
-export type RoleType = (typeof ROLE_TYPES)[number];
-export declare const ROLE_TYPE_SET: ReadonlySet<string>;
-export interface ActorSpeakerV3 {
-    actor_id: string;
-    state_id?: string;
-}
-export interface NonActorSpeakerV3 {
-    kind: NonActorSpeakerKind;
-    label?: string;
-}
-export type SpeakerV3 = ActorSpeakerV3 | NonActorSpeakerV3;
-export interface TransitionPromptV3 {
-    target: string;
-    process: string;
-    contrast: string;
-}
-export interface ActionV3 {
-    type: ActionType;
-    content: string;
-    speaker?: SpeakerV3;
-    emotion?: string;
-    transition_prompt?: TransitionPromptV3;
-    extend?: ExtensionMap;
-}
-export interface EnvironmentV3 {
-    space?: string;
-    time?: string;
-}
-export interface ActorRefV3 {
-    actor_id: string;
-    state_id?: string;
-}
-export interface LocationRefV3 {
-    location_id: string;
-    state_id?: string;
-}
-export interface PropRefV3 {
-    prop_id: string;
-    state_id?: string;
-}
-export interface SceneV3 {
-    scene_id: string;
-    environment?: EnvironmentV3;
-    location: LocationRefV3 | null;
-    actors: ActorRefV3[];
-    props: PropRefV3[];
-    actions: ActionV3[];
-    extend?: ExtensionMap;
-}
-export interface EpisodeV3 {
-    episode_id: string;
-    title?: string;
-    synopsis?: string;
-    scenes: SceneV3[];
-    extend?: ExtensionMap;
-}
-export interface StateV3 {
-    state_id: string;
-    state_name: string;
-    description: string;
-    extend?: ExtensionMap;
-}
-interface AssetV3 {
-    importance: Importance;
-    aliases?: string[];
-    description: string;
-    states: StateV3[];
-    extend?: ExtensionMap;
-}
-export interface ActorV3 extends AssetV3 {
-    actor_id: string;
-    actor_name: string;
-    role_type?: RoleType;
-}
-export interface LocationV3 extends AssetV3 {
-    location_id: string;
-    location_name: string;
-}
-export interface PropV3 extends AssetV3 {
-    prop_id: string;
-    prop_name: string;
-}
-export interface ScriptV3 {
-    version: 3;
-    title: string;
-    worldview: string;
-    worldview_raw?: string;
-    style: string;
-    synopsis?: string;
-    logline?: string;
-    theme?: string;
-    main_characters?: Array<{
-        name: string;
-        role: string;
-    }>;
-    actors: ActorV3[];
-    locations: LocationV3[];
-    props: PropV3[];
-    episodes: EpisodeV3[];
-    extend?: ExtensionMap;
-}
-export type AssetKind = "actor" | "location" | "prop";
-export type AssetV3ByKind = {
-    actor: ActorV3;
-    location: LocationV3;
-    prop: PropV3;
-};
-export {};
+export * from "./v3/types.js";

package/dist/domain/script/types.js

@@ -1,9 +1,2 @@
-export const ACTION_TYPES = ["action", "dialogue", "inner_thought", "transition"];
-export const ACTION_TYPE_SET = new Set(ACTION_TYPES);
-export const NON_ACTOR_SPEAKER_KINDS = ["system", "broadcast", "offscreen", "group"];
-export const NON_ACTOR_SPEAKER_KIND_SET = new Set(NON_ACTOR_SPEAKER_KINDS);
-export const IMPORTANCE_TIERS = ["featured", "background"];
-export const IMPORTANCE_TIER_SET = new Set(IMPORTANCE_TIERS);
-export const ROLE_TYPES = ["主角", "配角"];
-export const ROLE_TYPE_SET = new Set(ROLE_TYPES);
+export * from "./v3/types.js";
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/script/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,CAAU,CAAC;AAE3F,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAE9F,MAAM,CAAC,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAC;AAEpE,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAElF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/script/types.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,32 @@
+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;
+} | {
+    kind: "global";
+};
+export declare function parseAnyAddress(raw: unknown): AnyAddress;

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

@@ -0,0 +1,145 @@
+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;
+// `global` is the literal script-level sentinel.
+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, spk_001, or global."],
+            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 (value === "global") {
+        return { kind: "global" };
+    }
+    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) | global (script-level)",
+        ],
+        received: [value],
+        nextSteps: ["Use a recognized address format."],
+        errorCode: "ADDRESS_INVALID",
+    });
+}
+//# sourceMappingURL=address.js.map

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

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

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;