@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/domain/script/v3/patch/ops-state.js.map

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

package/dist/domain/script/v3/patch/registry.d.ts

@@ -0,0 +1,2 @@
+import type { OpHandler } from "./types.js";
+export declare const V3_OP_REGISTRY: Record<string, OpHandler>;

package/dist/domain/script/v3/patch/registry.js

@@ -0,0 +1,53 @@
+import { op_action_transition_set, op_action_transition_clear, op_action_content_replace, op_action_content_regex_replace, op_action_type_set, op_action_actor_set, op_action_emotion_set, op_action_emotion_clear, op_action_delete, op_action_insert, op_action_move } from "./ops-action.js";
+import { op_actor_add, op_location_add, op_prop_add, op_asset_role_set, op_importance_set, op_asset_rename, op_asset_describe, op_asset_alias_set, op_asset_alias_add, op_asset_alias_remove, op_asset_states_set, op_asset_merge, op_asset_delete } from "./ops-asset.js";
+import { op_dialogue_speaker_set } from "./ops-dialogue.js";
+import { op_episode_add, op_episode_synopsis_set, op_meta_worldview_set, op_meta_synopsis_set } from "./ops-meta.js";
+import { op_scene_insert, op_scene_split, op_scene_merge, op_scene_delete, op_scene_move } from "./ops-scene.js";
+import { op_state_add, op_state_rename, op_state_describe, op_state_delete, op_scene_ref_set, op_scene_ref_clear, op_scene_ref_remove } from "./ops-state.js";
+import { op_extend_set, op_extend_clear } from "./ops-extend.js";
+export const V3_OP_REGISTRY = {
+    "state.add": op_state_add,
+    "state.rename": op_state_rename,
+    "state.describe": op_state_describe,
+    "state.delete": op_state_delete,
+    "scene.ref.set": op_scene_ref_set,
+    "scene.ref.clear": op_scene_ref_clear,
+    "scene.ref.remove": op_scene_ref_remove,
+    "action.transition.set": op_action_transition_set,
+    "action.transition.clear": op_action_transition_clear,
+    "action.content.replace": op_action_content_replace,
+    "action.content.regex-replace": op_action_content_regex_replace,
+    "dialogue.speaker.set": op_dialogue_speaker_set,
+    "actor.add": op_actor_add,
+    "location.add": op_location_add,
+    "prop.add": op_prop_add,
+    "episode.add": op_episode_add,
+    "episode.synopsis.set": op_episode_synopsis_set,
+    "meta.worldview.set": op_meta_worldview_set,
+    "meta.synopsis.set": op_meta_synopsis_set,
+    "asset.role.set": op_asset_role_set,
+    "importance.set": op_importance_set,
+    "asset.rename": op_asset_rename,
+    "asset.describe": op_asset_describe,
+    "asset.alias.set": op_asset_alias_set,
+    "asset.alias.add": op_asset_alias_add,
+    "asset.alias.remove": op_asset_alias_remove,
+    "asset.states.set": op_asset_states_set,
+    "asset.merge": op_asset_merge,
+    "asset.delete": op_asset_delete,
+    "action.type.set": op_action_type_set,
+    "action.actor.set": op_action_actor_set,
+    "action.emotion.set": op_action_emotion_set,
+    "action.emotion.clear": op_action_emotion_clear,
+    "action.delete": op_action_delete,
+    "action.insert": op_action_insert,
+    "action.move": op_action_move,
+    "scene.insert": op_scene_insert,
+    "scene.split": op_scene_split,
+    "scene.merge": op_scene_merge,
+    "scene.delete": op_scene_delete,
+    "scene.move": op_scene_move,
+    "extend.set": op_extend_set,
+    "extend.clear": op_extend_clear,
+};
+//# sourceMappingURL=registry.js.map

package/dist/domain/script/v3/patch/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../src/domain/script/v3/patch/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAC,0BAA0B,EAAC,yBAAyB,EAAC,+BAA+B,EAAC,kBAAkB,EAAC,mBAAmB,EAAC,qBAAqB,EAAC,uBAAuB,EAAC,gBAAgB,EAAC,gBAAgB,EAAC,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtR,OAAO,EAAE,YAAY,EAAC,eAAe,EAAC,WAAW,EAAC,iBAAiB,EAAC,iBAAiB,EAAC,eAAe,EAAC,iBAAiB,EAAC,kBAAkB,EAAC,kBAAkB,EAAC,qBAAqB,EAAC,mBAAmB,EAAC,cAAc,EAAC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/P,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAC,uBAAuB,EAAC,qBAAqB,EAAC,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,eAAe,EAAC,cAAc,EAAC,cAAc,EAAC,eAAe,EAAC,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAC,eAAe,EAAC,iBAAiB,EAAC,eAAe,EAAC,gBAAgB,EAAC,kBAAkB,EAAC,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACxJ,OAAO,EAAE,aAAa,EAAC,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAA8B;IACvD,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,gBAAgB;IACjC,iBAAiB,EAAE,kBAAkB;IACrC,kBAAkB,EAAE,mBAAmB;IACvC,uBAAuB,EAAE,wBAAwB;IACjD,yBAAyB,EAAE,0BAA0B;IACrD,wBAAwB,EAAE,yBAAyB;IACnD,8BAA8B,EAAE,+BAA+B;IAC/D,sBAAsB,EAAE,uBAAuB;IAC/C,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,cAAc;IAC7B,sBAAsB,EAAE,uBAAuB;IAC/C,oBAAoB,EAAE,qBAAqB;IAC3C,mBAAmB,EAAE,oBAAoB;IACzC,gBAAgB,EAAE,iBAAiB;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,iBAAiB,EAAE,kBAAkB;IACrC,iBAAiB,EAAE,kBAAkB;IACrC,oBAAoB,EAAE,qBAAqB;IAC3C,kBAAkB,EAAE,mBAAmB;IACvC,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,iBAAiB,EAAE,kBAAkB;IACrC,kBAAkB,EAAE,mBAAmB;IACvC,oBAAoB,EAAE,qBAAqB;IAC3C,sBAAsB,EAAE,uBAAuB;IAC/C,eAAe,EAAE,gBAAgB;IACjC,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,aAAa,EAAE,cAAc;IAC7B,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,YAAY,EAAE,aAAa;IAC3B,YAAY,EAAE,aAAa;IAC3B,cAAc,EAAE,eAAe;CAChC,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { Dict } from "../../shared.js";
+export interface OpCtx {
+    script: Dict;
+    op: Dict;
+    sourceText: string;
+    applied: string[];
+    kind: string;
+    runOps: (operations: Dict[]) => string[];
+}
+export type OpHandler = (ctx: OpCtx) => void;

package/dist/domain/script/v3/patch/types.js

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

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

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

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

@@ -0,0 +1,4 @@
+import { type Dict } from "../shared.js";
+export declare function stateRefSummary(kind: string, targetId: string, stateId: string, location: string, role: string): Dict;
+export declare function collectStateRefs(script: Dict, kind: string, targetId: string, stateId: string): Dict[];
+export declare function collectAssetRefs(script: Dict, kind: string, targetId: string): Dict[];

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

@@ -0,0 +1,64 @@
+import { asList, isDict, strOf } from "../shared.js";
+import { sceneRefs } from "./scene-refs.js";
+import { idKeyForKind, pluralForKind } from "./lookups.js";
+export function stateRefSummary(kind, targetId, stateId, location, role) {
+    return { target: `${kind}:${targetId}/${stateId}`, location, role };
+}
+// v3: a state is referenced only where a scene's cast/props/location ref carries
+// it (scene.actors[]/props[]/location.state_id). There are no per-action
+// state_changes in v3, so scene refs are the whole surface.
+export function collectStateRefs(script, kind, targetId, stateId) {
+    const refs = [];
+    const idKey = idKeyForKind(kind);
+    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"]);
+            const refsList = asList(sceneRefs(scene)[pluralForKind(kind)]);
+            for (let idx = 0; idx < refsList.length; idx++) {
+                const ref = refsList[idx];
+                if (strOf(ref[idKey]) === targetId && strOf(ref["state_id"]) === stateId) {
+                    refs.push(stateRefSummary(kind, targetId, stateId, `${epId}/${sceneId}.${pluralForKind(kind)}[${idx}]`, "scene_state"));
+                }
+            }
+        }
+    }
+    return refs;
+}
+// v3: an asset is referenced by scene cast/props/location refs, by a dialogue
+// line's inline speaker (action.speaker.actor_id, actors only), and by an
+// action.transition_prompt.target. No speaker roster, no state_changes.
+export function collectAssetRefs(script, kind, targetId) {
+    const refs = [];
+    const target = `${kind}:${targetId}`;
+    const idKey = idKeyForKind(kind);
+    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"]);
+            const refsList = asList(sceneRefs(scene)[pluralForKind(kind)]);
+            for (let i = 0; i < refsList.length; i++) {
+                if (strOf(refsList[i][idKey]) === targetId) {
+                    refs.push({ target, location: `${epId}/${sceneId}.${pluralForKind(kind)}[${i}]`, role: `scene_${pluralForKind(kind)}` });
+                }
+            }
+            const actions = asList(scene["actions"]);
+            for (let actionIdx = 0; actionIdx < actions.length; actionIdx++) {
+                const action = actions[actionIdx];
+                const speaker = action["speaker"];
+                if (kind === "actor" && isDict(speaker) && strOf(speaker["actor_id"]) === targetId) {
+                    refs.push({ target, location: `${epId}/${sceneId}#${actionIdx}.speaker`, role: "dialogue_speaker" });
+                }
+                const transition = action["transition_prompt"];
+                if (isDict(transition)) {
+                    const t = strOf(transition["target"]).trim();
+                    if (t === targetId || t === target) {
+                        refs.push({ target, location: `${epId}/${sceneId}#${actionIdx}.transition_prompt`, role: "transition_target" });
+                    }
+                }
+            }
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=refs.js.map

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

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

package/dist/domain/script/v3/scene-refs.d.ts

@@ -0,0 +1,3 @@
+import { type Dict } from "../shared.js";
+export declare function sceneRefs(scene: Dict): Dict;
+export declare function setSceneRefs(scene: Dict, refs: Dict): void;

package/dist/domain/script/v3/scene-refs.js

@@ -0,0 +1,35 @@
+// v3 scene-ref accessors. In Script v3 a scene's cast/props/location live as
+// top-level scene fields — scene.actors[] / scene.props[] (arrays of
+// {actor_id|prop_id, state_id?}) and scene.location ({location_id, state_id?} |
+// null, single-valued) — NOT the legacy scene.context{} bag. These two functions
+// are the ONLY place the patch ops touch that storage, so the whole context.*
+// op family operates on v3 through the same {actors,locations,props} bag shape
+// the ops already expect. `locations` is synthesized as a 0-or-1 array from the
+// single scene.location so multi-location callers keep working (location stays
+// single-valued: setSceneRefs writes locations[0] back as scene.location).
+import { asList, isDict, isList } from "../shared.js";
+export function sceneRefs(scene) {
+    const loc = isDict(scene["location"]) ? scene["location"] : null;
+    return {
+        actors: isList(scene["actors"]) ? scene["actors"] : [],
+        props: isList(scene["props"]) ? scene["props"] : [],
+        locations: loc && String(loc["location_id"] ?? "").trim() ? [loc] : [],
+    };
+}
+// Clean a single ref to v3 shape: keep the id key, keep state_id ONLY when it is
+// a real (non-null, non-empty) materialized id — v3 validation rejects a
+// state_id: null (it reads as "declared but not materialized").
+function cleanRef(ref, idKey) {
+    const out = { [idKey]: ref[idKey] };
+    const state = ref["state_id"];
+    if (state != null && String(state).trim())
+        out["state_id"] = state;
+    return out;
+}
+export function setSceneRefs(scene, refs) {
+    scene["actors"] = asList(refs["actors"]).map((r) => cleanRef(r, "actor_id"));
+    scene["props"] = asList(refs["props"]).map((r) => cleanRef(r, "prop_id"));
+    const loc = asList(refs["locations"])[0];
+    scene["location"] = loc && String(loc["location_id"] ?? "").trim() ? cleanRef(loc, "location_id") : null;
+}
+//# sourceMappingURL=scene-refs.js.map

package/dist/domain/script/v3/scene-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-refs.js","sourceRoot":"","sources":["../../../../src/domain/script/v3/scene-refs.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qEAAqE;AACrE,gFAAgF;AAChF,iFAAiF;AACjF,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,OAAO,EAAE,MAAM,EAAa,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,UAAU,SAAS,CAAC,KAAW;IACnC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,UAAU,CAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,EAAE;QAClE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,OAAO,CAAY,CAAC,CAAC,CAAC,EAAE;QAC/D,SAAS,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;KACvE,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,yEAAyE;AACzE,gEAAgE;AAChE,SAAS,QAAQ,CAAC,GAAS,EAAE,KAAa;IACxC,MAAM,GAAG,GAAS,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;IACnE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAW,EAAE,IAAU;IAClD,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACnF,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAChF,MAAM,GAAG,GAAG,MAAM,CAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3G,CAAC"}

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

@@ -0,0 +1,6 @@
+export interface PatchOpFieldSchema {
+    required: string[];
+    optional: string[];
+    description: string;
+}
+export declare const PATCH_OP_SCHEMA: Record<string, PatchOpFieldSchema>;

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

@@ -0,0 +1,56 @@
+// Script v3 schema for every supported patch op. Used by `scriptctl patch --schema` to
+// dump field definitions agents can introspect without reading source.
+export const PATCH_OP_SCHEMA = {
+    // meta
+    "meta.worldview.set": { required: ["worldview"], optional: ["worldview_raw"], description: "Set the script.worldview enum." },
+    "meta.synopsis.set": { required: ["synopsis"], optional: [], description: "Set the whole-script synopsis." },
+    // state
+    "state.add": { required: ["target", "name"], optional: ["description", "state_id"], description: "Add a state to an asset's states[]." },
+    "state.rename": { required: ["target", "name"], optional: [], description: "Rename an asset state." },
+    "state.describe": { required: ["target", "description"], optional: [], description: "Set a state's description." },
+    "state.delete": { required: ["target", "strategy"], optional: ["replacement"], description: "Delete a state. strategy: replace|remove." },
+    // asset
+    "actor.add": { required: ["name"], optional: ["actor_id", "role_type", "importance", "description", "aliases"], description: "Register a new actor (human/character). importance: featured|background (default featured)." },
+    "location.add": { required: ["name"], optional: ["location_id", "importance", "description"], description: "Register a new location. importance: featured|background." },
+    "prop.add": { required: ["name"], optional: ["prop_id", "importance", "description"], description: "Register a new prop. importance: featured|background." },
+    "episode.add": { required: [], optional: ["episode_id", "title"], description: "Append a new empty episode (no scenes)." },
+    "episode.synopsis.set": { required: ["episode_id", "synopsis"], optional: [], description: "Set one episode's synopsis." },
+    "asset.rename": { required: ["target", "name"], optional: [], description: "Rename an asset (actor / location / prop)." },
+    "asset.describe": { required: ["target", "description"], optional: [], description: "Set asset description." },
+    "asset.alias.set": { required: ["target", "aliases"], optional: [], description: "Bulk replace aliases[]." },
+    "asset.alias.add": { required: ["target", "alias"], optional: [], description: "Append alias(es)." },
+    "asset.alias.remove": { required: ["target", "alias"], optional: [], description: "Remove alias(es)." },
+    "asset.states.set": { required: ["target", "states"], optional: ["asset_type"], description: "Bulk replace states[] (the 'default' state is always preserved)." },
+    "asset.role.set": { required: ["target", "role_type"], optional: [], description: "Set actor role_type (主角|配角)." },
+    "importance.set": { required: ["target", "importance"], optional: [], description: "Set an asset's importance tier: featured (主角/配角) | background (龙套/背景)." },
+    "asset.merge": { required: ["from", "into"], optional: [], description: "Merge from asset into another; from disappears." },
+    "asset.delete": { required: ["target"], optional: ["strategy", "replacement"], description: "Delete an asset. strategy: replace|remove (required if refs exist)." },
+    // action
+    "action.type.set": { required: ["at", "type"], optional: [], description: "Set action.type (dialogue|action|inner_thought|transition)." },
+    "action.actor.set": { required: ["at"], optional: ["actor_id"], description: "Set/clear the dialogue line's speaker to an actor (action.speaker={actor_id}). Omit actor_id to clear." },
+    "action.emotion.set": { required: ["at", "emotion"], optional: [], description: "Set action.emotion." },
+    "action.emotion.clear": { required: ["at"], optional: [], description: "Clear action.emotion." },
+    "action.content.replace": { required: ["at", "from"], optional: ["to", "all"], description: "Literal substring replace in action.content." },
+    "action.content.regex-replace": { required: ["at", "pattern"], optional: ["to", "all"], description: "Regex (/re/flags) replace in action.content. ReDoS-guarded." },
+    "action.transition.set": { required: ["at", "target", "process", "contrast"], optional: [], description: "Set transition_prompt {target, process, contrast}." },
+    "action.transition.clear": { required: ["at"], optional: [], description: "Clear transition_prompt." },
+    "action.delete": { required: ["at"], optional: [], description: "Remove an action; later indices shift." },
+    "action.insert": { required: ["at", "type"], optional: ["content", "emotion", "at_index", "before", "after", "actor_id", "kind", "label"], description: "Insert body into a scene after its asset refs and states are ready. dialogue/inner_thought requires actor_id or a non-actor kind." },
+    "action.move": { required: ["at", "to"], optional: [], description: "Move an action (within or across scenes)." },
+    // scene
+    "scene.split": { required: ["at", "at_index"], optional: ["new_scene_id"], description: "Split a scene at an action boundary." },
+    "scene.merge": { required: ["from", "into"], optional: [], description: "Merge two scenes within the same episode." },
+    "scene.delete": { required: ["at"], optional: ["force"], description: "Delete a scene; empty by default, force=true for non-empty." },
+    "scene.move": { required: ["at", "to"], optional: ["at_index"], description: "Move a scene to another episode." },
+    "scene.insert": { required: ["at", "location"], optional: ["time", "space", "at_index", "before", "after", "scene_id"], description: "Insert a new empty scene." },
+    // scene refs (v3: cast/props/location live directly on the scene, no context{})
+    "scene.ref.set": { required: ["at", "target"], optional: ["state", "state_id", "append", "occurrence"], description: "Set a scene ref state. append=true adds another actor ref; occurrence is the 1-based matching ref to update. Location remains single-valued." },
+    "scene.ref.clear": { required: ["at", "target"], optional: ["occurrence"], description: "Keep the scene ref and clear its state_id. occurrence is the 1-based matching ref." },
+    "scene.ref.remove": { required: ["at", "target"], optional: ["occurrence"], description: "Remove a scene ref. occurrence is required when the target appears more than once." },
+    // dialogue speaker (v3: single inline speaker per line — actor or non-actor kind)
+    "dialogue.speaker.set": { required: ["at"], optional: ["actor_id", "kind", "label"], description: "Set the dialogue line's inline speaker: actor_id (an actor) OR kind (system|broadcast|offscreen|group) + optional label." },
+    // extend (free-form namespace, any dimension)
+    "extend.set": { required: ["at", "key", "value"], optional: [], description: "Set a free-form key on a node's extend{} namespace. at: action(ep/scn#i)|scene(ep/scn)|episode(ep)|asset(kind:id)|state(kind:id/st)|speaker(spk_x)|global. key is a flat name (dots are literal, not traversed). value is any JSON." },
+    "extend.clear": { required: ["at"], optional: ["key"], description: "Delete one extend key (key set) or clear the whole extend{} container (key omitted). Empty container is removed; deleting a missing key is a no-op." },
+};
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { CliError } from "../../../common.js";
+import { type Dict } from "../shared.js";
+export { MAX_GREP_PATTERN_LEN, isDangerousRegex } from "../shared/regex.js";
+export type ActionCoord = {
+    scn: number;
+    idx: number;
+};
+export type SelectorRegion = {
+    level: "episode";
+    lo: number;
+    hi: number;
+} | {
+    level: "scene";
+    lo: number;
+    hi: number;
+} | {
+    level: "action";
+    lo: ActionCoord;
+    hi: ActionCoord;
+};
+export interface InSelector {
+    readonly isEmpty: boolean;
+    matchesScene(epId: string, sceneId: string): boolean;
+    matchesAction(epId: string, sceneId: string, idx: number): boolean;
+}
+export declare function cmpAction(a: ActionCoord, b: ActionCoord): number;
+export declare function regionMatchesScene(r: SelectorRegion, ep: number, scn: number): boolean;
+export declare function regionMatchesAction(r: SelectorRegion, ep: number, scn: number, idx: number): boolean;
+export declare class RegionSelector implements InSelector {
+    readonly regions: SelectorRegion[];
+    constructor(regions: SelectorRegion[]);
+    get isEmpty(): boolean;
+    matchesScene(epId: string, sceneId: string): boolean;
+    matchesAction(epId: string, sceneId: string, idx: number): boolean;
+}
+export declare function inSelectorError(detail: string, received: string): CliError;
+export declare function parseRegion(region: string, full: string): SelectorRegion;
+export declare const WHOLE_SCRIPT: InSelector;
+export declare function parseInSelector(raw: unknown): InSelector;
+export declare function selectorSingleActionPoint(sel: InSelector): {
+    scn: number;
+    idx: number;
+} | null;
+export declare function expandSelectorToActionRefs(script: Dict, selector: InSelector): string[];

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

@@ -0,0 +1,178 @@
+import { CliError, EXIT_USAGE, } from "../../../common.js";
+import { asList, idNum, strOf } from "../shared.js";
+import { parseAnyAddress } from "./address.js";
+export { MAX_GREP_PATTERN_LEN, isDangerousRegex } from "../shared/regex.js";
+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("--in address invalid.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "IN_ADDRESS_INVALID",
+        hint: "Example: ep_003..ep_007,ep_010/scn_001..ep_010/scn_004",
+        data: { expected: ["--in: ep_NNN | ep_NNN/scn_NNN | ep_NNN/scn_NNN#idx; ranges via '..'; multiple regions comma-separated"], actual: [`${received} (${detail})`] },
+    });
+}
+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("Range endpoints must be the same address kind.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "IN_RANGE_KIND_MISMATCH",
+            hint: "Make both endpoints the same kind, e.g. ep_003..ep_007 or ep_001/scn_002..ep_003/scn_009.",
+            data: { expected: ["both endpoints episode | scene | action"], actual: [`${loRaw}(${loAddr.kind})..${hiRaw}(${hiAddr.kind})`] },
+        });
+    }
+    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}
+//# sourceMappingURL=selector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../../../../src/domain/script/v3/selector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAAc,UAAU,GACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAa,KAAK,EAAyB,KAAK,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,eAAe,EAAmB,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAyB5E,MAAM,UAAU,SAAS,CAAC,CAAc,EAAE,CAAc;IACtD,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAiB,EAAE,EAAU,EAAE,GAAW;IAC3E,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAChD,KAAK,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;QAChD,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAiB,EAAE,EAAU,EAAE,GAAW,EAAE,GAAW;IACzF,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAChD,KAAK,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;QAChD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;YACvB,sEAAsE;YACtE,wCAAwC;YACxC,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,cAAc;IACJ;IAArB,YAAqB,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAClD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,YAAY,CAAC,IAAY,EAAE,OAAe;QACxC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,aAAa,CAAC,IAAY,EAAE,OAAe,EAAE,GAAW;QACtD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACxE,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,QAAgB;IAC9D,OAAO,IAAI,QAAQ,CAAC,uBAAuB,EAAE;QACpC,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,oBAAoB;QAC/B,IAAI,EAAE,wDAAwD;QAC9D,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,uGAAuG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,KAAK,MAAM,GAAG,CAAC,EAAE;KACnK,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAY;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,eAAe,CAAC,qBAAqB,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,MAAM,eAAe,CAAC,4BAA4B,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;IACzF,IAAI,MAAkB,CAAC;IACvB,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,eAAe,CAAC,oCAAoC,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,gDAAgD,EAAE;YAC7D,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,wBAAwB;YACnC,IAAI,EAAE,2FAA2F;YACjG,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,yCAAyC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE;SAChI,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,MAAM,eAAe,CAAC,4BAA4B,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,MAAM,eAAe,CAAC,0BAA0B,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;QACzG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzD,MAAM,CAAC,GAAgB,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QACtF,MAAM,CAAC,GAAgB,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QACtF,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,MAAM,eAAe,CAAC,0BAA0B,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC;QACjH,OAAO,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACtG,CAAC;IACD,0EAA0E;IAC1E,MAAM,eAAe,CAAC,iBAAiB,MAAM,CAAC,IAAI,qBAAqB,EAAE,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,uCAAuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,OAAO,EAAE,KAAK;IACd,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;IACxB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;CAC1B,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,YAAY,CAAC;IACvC,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM;YAAE,MAAM,eAAe,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,+EAA+E;AAC/E,yEAAyE;AACzE,4EAA4E;AAC5E,yEAAyE;AACzE,MAAM,UAAU,yBAAyB,CAAC,GAAe;IACvD,IAAI,CAAC,CAAC,GAAG,YAAY,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAChE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AAC1C,CAAC;AAED,6EAA6E;AAC7E,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,UAAU,0BAA0B,CAAC,MAAY,EAAE,QAAoB;IAC3E,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAO,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;gBAAE,SAAS;YACpD,MAAM,OAAO,GAAG,MAAM,CAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;oBAAE,SAAS;gBACxD,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,oEAAoE;AACpE,2DAA2D;AAC3D,+CAA+C;AAC/C,mCAAmC;AACnC,uFAAuF;AACvF,8CAA8C;AAC9C,gDAAgD"}