@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/usecases/script/lib.d.ts

@@ -1,4 +1,5 @@
-import { CliError, type Report } from "../../common.js";
+import { CliError, type CommandOutput } from "../../common.js";
+import { validateScriptV4 } from "../../domain/script/v4/validation.js";
 import { type InSelector } from "../../domain/script/selector.js";
 import { sortDeep } from "../../domain/script/text-util.js";
 import { type Dict } from "../../domain/script/shared.js";
@@ -44,7 +45,7 @@ export declare function dialogueTemplate(f: {
     kind?: unknown;
     label?: unknown;
 }): Dict;
-export declare function lineToOp(verb: string, args: string[], flags: Dict): Dict;
+export declare function lineToOp(verb: string, args: string[], flags: Dict, scriptVersion?: 3 | 4): Dict;
 export declare function actionAddress(epId: string, sceneId: string, idx: number): string;
 export declare function actionTimestamp(action: Dict): string;
 export declare function sceneTimeSpan(scene: Dict): {
@@ -54,16 +55,70 @@ export declare function sceneTimeSpan(scene: Dict): {
 export declare function actionDisplayFields(epId: string, sceneId: string, idx: number, action: Dict): Record<string, unknown>;
 export declare function formatInspectAction(epId: string, sceneId: string, idx: number, action: Dict): string;
 export declare const SKIPPABLE_EDIT_CODES: Set<string>;
-export declare function applySingleScriptOp(opts: Dict, op: Dict): Promise<[Report, number]>;
+export declare function applyPatchOperationsForSession(session: ScriptEditSession, source: string, operations: Dict[]): string[];
+export interface V4MutationCounts {
+    episodes: number;
+    scenes: number;
+    actions: number;
+    actors: number;
+    locations: number;
+    props: number;
+    states: number;
+}
+export interface V4MutationPlanStep {
+    index: number;
+    operation: Dict;
+    targets: string[];
+    status: "applied" | "skipped";
+    before: V4MutationCounts;
+    after: V4MutationCounts;
+    created_ids: string[];
+    removed_ids: string[];
+    retained_ids: string[];
+}
+export interface V4MutationPlan {
+    version: 1;
+    script_version: 4;
+    baseline: string;
+    operations: Dict[];
+    targets: string[];
+    steps: V4MutationPlanStep[];
+    before: V4MutationCounts;
+    after: V4MutationCounts;
+    created_ids: string[];
+    removed_ids: string[];
+    retained_ids: string[];
+    untouched_ids: string[];
+    validation: ReturnType<typeof validateScriptV4>;
+}
+export interface V4MutationPlanResult {
+    plan: V4MutationPlan;
+    digest: string;
+    applied: string[];
+}
+export declare function buildV4MutationPlan(session: ScriptEditSession, operations: Dict[], options?: {
+    skipCodes?: ReadonlySet<string>;
+}): V4MutationPlanResult;
+export declare function assertV4PlanHasExplicitNewIds(operations: Dict[]): void;
+export declare function applySingleScriptOpToSession(session: ScriptEditSession, opts: Dict, op: Dict): Promise<[CommandOutput, number]>;
+export declare function applyScriptOpsToSession(session: ScriptEditSession, opts: Dict, operations: Dict[]): Promise<[CommandOutput, number]>;
+export declare function applySingleScriptOp(opts: Dict, op: Dict): Promise<[CommandOutput, number]>;
 export declare function summarizeScriptOp(_script: Dict, op: Dict): string;
 export declare function regexPattern(raw: string): string;
-export declare function applySelectorEdits(opts: Dict, template: Dict, verbLabel: string): Promise<[Report, number]>;
+export declare function applySelectorEditsToSession(session: ScriptEditSession, opts: Dict, template: Dict, verbLabel: string): Promise<[CommandOutput, number]>;
+export declare function applySelectorEdits(opts: Dict, template: Dict, verbLabel: string): Promise<[CommandOutput, number]>;
 export { sortDeep };
 export declare function actionActorId(action: Dict): string;
 export declare function actionSpeakerLabel(action: Dict, actorNames?: Map<string, string>): string;
 export declare function actorIdsInAction(action: Dict): Set<string>;
 export declare function buildGrepMatcher(raw: string): ((hay: string) => boolean) | null;
-export declare function buildReport(op: string, title: string, lines: string[], artifactLabel: string): Report;
+export interface TableQueryResult {
+    lines: string[];
+    rows: Array<Record<string, unknown>>;
+    rowColumns: string[];
+}
+export declare function buildReport(op: string, lines: string[]): CommandOutput;
+export declare function buildTableReport(op: string, lines: string[], rowColumns: string[], rows: Array<Record<string, unknown>>): CommandOutput;
 export declare function synopsisPreview(text: string, limit: number): string;
 export declare function episodeInSelector(selector: InSelector, epId: string, scenes: Dict[]): boolean;
 export declare function nameMaps(script: Dict): {
@@ -91,7 +146,7 @@ export declare function listAssetsByKind(script: Dict, kind: "actor" | "location
     name: string;
     selector: InSelector;
     counts?: boolean;
-}): string[];
+}): TableQueryResult;
 export declare function splitSpeakerList(raw: unknown): string[];
-export declare function blankCreateReport(session: ScriptEditSession, validation: Dict, idempotent: boolean | null): Report;
+export declare function blankCreateReport(session: ScriptEditSession, validation: Dict, idempotent: boolean | null): CommandOutput;
 export declare function requireNameArg(opts: Dict, verb: string, example: string): string;