@scenar/cli 0.0.2

package/src/tts/resolve-provider.ts

@@ -0,0 +1,61 @@
+import type { TtsProvider } from "./types.js";
+import { createEchogardenProvider, isEchogardenAvailable } from "./echogarden.js";
+import { createEdgeTtsProvider, isEdgeTtsAvailable } from "./edge-tts.js";
+import { createOpenAIProvider } from "./openai.js";
+
+export type TtsProviderName = "echogarden" | "edge-tts" | "openai";
+
+const KNOWN_PROVIDERS: ReadonlySet<string> = new Set<TtsProviderName>([
+  "echogarden",
+  "edge-tts",
+  "openai",
+]);
+
+/**
+ * Resolve a TTS provider by name.
+ *
+ * When `providerName` is `"echogarden"` (the default), verifies
+ * the optional peer dependency is installed before returning it.
+ * Falls back to a clear error message guiding the user.
+ */
+export async function resolveProvider(providerName: string): Promise<TtsProvider> {
+  if (!KNOWN_PROVIDERS.has(providerName)) {
+    throw new Error(
+      `Unknown TTS provider: "${providerName}". ` +
+      `Supported providers: ${[...KNOWN_PROVIDERS].join(", ")}.`,
+    );
+  }
+
+  if (providerName === "openai") {
+    return createOpenAIProvider();
+  }
+
+  if (providerName === "edge-tts") {
+    const available = await isEdgeTtsAvailable();
+    if (!available) {
+      throw new Error(
+        "edge-tts-universal is not installed. To use free online TTS:\n\n" +
+        "  pnpm add edge-tts-universal\n\n" +
+        "Or use a different provider:\n\n" +
+        "  scenar narrate <file> --tts echogarden   (offline, pnpm add echogarden)\n" +
+        "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)",
+      );
+    }
+    return createEdgeTtsProvider();
+  }
+
+  const available = await isEchogardenAvailable();
+  if (!available) {
+    throw new Error(
+      "Echogarden is not installed. To use free offline TTS:\n\n" +
+      "  pnpm add echogarden\n\n" +
+      "Or use free online TTS (requires network):\n\n" +
+      "  scenar narrate <file> --tts edge-tts\n" +
+      "  pnpm add edge-tts-universal\n\n" +
+      "Or use OpenAI TTS (requires API key):\n\n" +
+      "  scenar narrate <file> --tts openai",
+    );
+  }
+
+  return createEchogardenProvider();
+}

package/src/tts/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Common interface for text-to-speech providers.
+ *
+ * Each provider converts plain text into audio. The CLI resolves
+ * which provider to use at runtime based on the `--tts` flag and
+ * package availability.
+ */
+export interface TtsProvider {
+    /** Human-readable name shown in logs and the narration manifest. */
+    readonly name: string;
+    /**
+     * Generate speech audio for the given text.
+     * Returns the raw audio bytes and the audio duration.
+     */
+    synthesize(text: string, options: TtsOptions): Promise<TtsResult>;
+}
+export interface TtsOptions {
+    /** Voice identifier (provider-specific). */
+    voice?: string;
+}
+export interface TtsResult {
+    /** Raw audio content (MP3). */
+    audio: Buffer;
+    /** Duration of the generated audio clip in milliseconds. */
+    durationMs: number;
+}
+/**
+ * Shape written to `manifest.json` alongside the narration audio files.
+ */
+export interface NarrationManifest {
+    generatedAt: string;
+    ttsProvider: string;
+    steps: NarrationManifestStep[];
+}
+export interface NarrationManifestStep {
+    index: number;
+    file: string;
+    durationMs: number;
+    text: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/tts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tts/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/src/tts/types.js

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

package/src/tts/types.js.map

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

package/src/tts/types.ts

@@ -0,0 +1,45 @@
+/**
+ * Common interface for text-to-speech providers.
+ *
+ * Each provider converts plain text into audio. The CLI resolves
+ * which provider to use at runtime based on the `--tts` flag and
+ * package availability.
+ */
+export interface TtsProvider {
+  /** Human-readable name shown in logs and the narration manifest. */
+  readonly name: string;
+
+  /**
+   * Generate speech audio for the given text.
+   * Returns the raw audio bytes and the audio duration.
+   */
+  synthesize(text: string, options: TtsOptions): Promise<TtsResult>;
+}
+
+export interface TtsOptions {
+  /** Voice identifier (provider-specific). */
+  voice?: string;
+}
+
+export interface TtsResult {
+  /** Raw audio content (MP3). */
+  audio: Buffer;
+  /** Duration of the generated audio clip in milliseconds. */
+  durationMs: number;
+}
+
+/**
+ * Shape written to `manifest.json` alongside the narration audio files.
+ */
+export interface NarrationManifest {
+  generatedAt: string;
+  ttsProvider: string;
+  steps: NarrationManifestStep[];
+}
+
+export interface NarrationManifestStep {
+  index: number;
+  file: string;
+  durationMs: number;
+  text: string;
+}

package/src/util/load-yaml.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Recursively converts all object keys from snake_case to camelCase.
+ * Arrays are traversed element-by-element; primitives pass through unchanged.
+ */
+export declare function snakeToCamelKeys(value: unknown): unknown;
+/**
+ * Reads a scenario YAML file from disk, parses it, and converts
+ * snake_case field names to the camelCase convention used by the
+ * SDK's `ProtoScenario` type.
+ *
+ * @throws {Error} on file-not-found or YAML parse failure.
+ */
+export declare function loadScenarioYaml(filePath: string): Promise<unknown>;
+//# sourceMappingURL=load-yaml.d.ts.map

package/src/util/load-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-yaml.d.ts","sourceRoot":"","sources":["../../../src/util/load-yaml.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYxD;AAMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBzE"}

package/src/util/load-yaml.js

@@ -0,0 +1,55 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+/**
+ * Recursively converts all object keys from snake_case to camelCase.
+ * Arrays are traversed element-by-element; primitives pass through unchanged.
+ */
+export function snakeToCamelKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(snakeToCamelKeys);
+    }
+    if (value !== null && typeof value === "object") {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[snakeToCamel(key)] = snakeToCamelKeys(val);
+        }
+        return result;
+    }
+    return value;
+}
+function snakeToCamel(s) {
+    return s.replace(/_([a-z])/g, (_, ch) => ch.toUpperCase());
+}
+/**
+ * Reads a scenario YAML file from disk, parses it, and converts
+ * snake_case field names to the camelCase convention used by the
+ * SDK's `ProtoScenario` type.
+ *
+ * @throws {Error} on file-not-found or YAML parse failure.
+ */
+export async function loadScenarioYaml(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        throw new Error(`Failed to read file: ${filePath} (${code ?? "unknown error"})`);
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid YAML in ${filePath}: ${message}`);
+    }
+    if (parsed === null || parsed === undefined || typeof parsed !== "object") {
+        throw new Error(`Expected a YAML mapping (object) in ${filePath}, got ${parsed === null ? "null" : typeof parsed}.`);
+    }
+    return snakeToCamelKeys(parsed);
+}
+//# sourceMappingURL=load-yaml.js.map

package/src/util/load-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-yaml.js","sourceRoot":"","sources":["../../../src/util/load-yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC1E,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,KAAK,IAAI,IAAI,eAAe,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,SAAS,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,GAAG,CAAC,CAAC;IACvH,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/src/util/load-yaml.ts

@@ -0,0 +1,58 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+
+/**
+ * Recursively converts all object keys from snake_case to camelCase.
+ * Arrays are traversed element-by-element; primitives pass through unchanged.
+ */
+export function snakeToCamelKeys(value: unknown): unknown {
+  if (Array.isArray(value)) {
+    return value.map(snakeToCamelKeys);
+  }
+  if (value !== null && typeof value === "object") {
+    const result: Record<string, unknown> = {};
+    for (const [key, val] of Object.entries(value as Record<string, unknown>)) {
+      result[snakeToCamel(key)] = snakeToCamelKeys(val);
+    }
+    return result;
+  }
+  return value;
+}
+
+function snakeToCamel(s: string): string {
+  return s.replace(/_([a-z])/g, (_, ch: string) => ch.toUpperCase());
+}
+
+/**
+ * Reads a scenario YAML file from disk, parses it, and converts
+ * snake_case field names to the camelCase convention used by the
+ * SDK's `ProtoScenario` type.
+ *
+ * @throws {Error} on file-not-found or YAML parse failure.
+ */
+export async function loadScenarioYaml(filePath: string): Promise<unknown> {
+  let raw: string;
+  try {
+    raw = await readFile(filePath, "utf-8");
+  } catch (err) {
+    const code = (err as NodeJS.ErrnoException).code;
+    if (code === "ENOENT") {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    throw new Error(`Failed to read file: ${filePath} (${code ?? "unknown error"})`);
+  }
+
+  let parsed: unknown;
+  try {
+    parsed = parseYaml(raw);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`Invalid YAML in ${filePath}: ${message}`);
+  }
+
+  if (parsed === null || parsed === undefined || typeof parsed !== "object") {
+    throw new Error(`Expected a YAML mapping (object) in ${filePath}, got ${parsed === null ? "null" : typeof parsed}.`);
+  }
+
+  return snakeToCamelKeys(parsed);
+}

package/src/validate/scenario-validator.d.ts

@@ -0,0 +1,17 @@
+export interface ValidationError {
+    readonly path: string;
+    readonly reason: string;
+}
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly ValidationError[];
+}
+/**
+ * Validates a parsed scenario object against the proto schema constraints
+ * defined in `scenario.proto` via `buf.validate` annotations.
+ *
+ * The input is expected to have camelCase keys (post-YAML-loader conversion).
+ * Returns all violations found — does not stop at the first error.
+ */
+export declare function validateScenario(scenario: unknown): ValidationResult;
+//# sourceMappingURL=scenario-validator.d.ts.map

package/src/validate/scenario-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-validator.d.ts","sourceRoot":"","sources":["../../../src/validate/scenario-validator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAgBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAcpE"}

package/src/validate/scenario-validator.js

@@ -0,0 +1,174 @@
+import { PROTO_ACTION_TYPE } from "@scenar/sdk";
+const VALID_ACTION_TYPES = new Set(Object.values(PROTO_ACTION_TYPE));
+const ACTIONS_REQUIRING_TARGET = new Set([
+    PROTO_ACTION_TYPE.set_cursor,
+    PROTO_ACTION_TYPE.click,
+    PROTO_ACTION_TYPE.type,
+    PROTO_ACTION_TYPE.hover,
+    PROTO_ACTION_TYPE.drag,
+    PROTO_ACTION_TYPE.scroll_to,
+    PROTO_ACTION_TYPE.viewport_transition,
+]);
+/**
+ * Validates a parsed scenario object against the proto schema constraints
+ * defined in `scenario.proto` via `buf.validate` annotations.
+ *
+ * The input is expected to have camelCase keys (post-YAML-loader conversion).
+ * Returns all violations found — does not stop at the first error.
+ */
+export function validateScenario(scenario) {
+    const errors = [];
+    if (scenario === null || scenario === undefined || typeof scenario !== "object") {
+        errors.push({ path: "", reason: "scenario must be an object." });
+        return { valid: false, errors };
+    }
+    const obj = scenario;
+    validateViewport(obj["viewport"], errors);
+    validateSteps(obj["steps"], errors);
+    return { valid: errors.length === 0, errors };
+}
+function validateViewport(viewport, errors) {
+    if (viewport === undefined || viewport === null)
+        return;
+    if (typeof viewport !== "object") {
+        errors.push({ path: "viewport", reason: "viewport must be an object." });
+        return;
+    }
+    const vp = viewport;
+    if (typeof vp["width"] !== "number" || vp["width"] <= 0) {
+        errors.push({ path: "viewport.width", reason: "width must be a positive integer." });
+    }
+    if (typeof vp["height"] !== "number" || vp["height"] <= 0) {
+        errors.push({ path: "viewport.height", reason: "height must be a positive integer." });
+    }
+}
+function validateSteps(steps, errors) {
+    if (!Array.isArray(steps)) {
+        errors.push({ path: "steps", reason: "steps must be an array." });
+        return;
+    }
+    if (steps.length === 0) {
+        errors.push({ path: "steps", reason: "steps must contain at least one item." });
+        return;
+    }
+    for (let i = 0; i < steps.length; i++) {
+        validateStep(steps[i], `steps[${i}]`, errors);
+    }
+}
+function validateStep(step, path, errors) {
+    if (step === null || step === undefined || typeof step !== "object") {
+        errors.push({ path, reason: "step must be an object." });
+        return;
+    }
+    const s = step;
+    if (typeof s["view"] !== "string" || s["view"].length === 0) {
+        errors.push({ path: `${path}.view`, reason: "view is required and must be a non-empty string." });
+    }
+    if (s["delayMs"] !== undefined) {
+        if (typeof s["delayMs"] !== "number" || s["delayMs"] < 0) {
+            errors.push({ path: `${path}.delayMs`, reason: "delayMs must be a non-negative integer." });
+        }
+    }
+    if (s["interactions"] !== undefined) {
+        if (!Array.isArray(s["interactions"])) {
+            errors.push({ path: `${path}.interactions`, reason: "interactions must be an array." });
+        }
+        else {
+            for (let j = 0; j < s["interactions"].length; j++) {
+                validateInteraction(s["interactions"][j], `${path}.interactions[${j}]`, errors);
+            }
+        }
+    }
+}
+function validateInteraction(action, path, errors) {
+    if (action === null || action === undefined || typeof action !== "object") {
+        errors.push({ path, reason: "interaction must be an object." });
+        return;
+    }
+    const a = action;
+    if (typeof a["atPercent"] !== "number" || a["atPercent"] < 0 || a["atPercent"] > 1) {
+        errors.push({ path: `${path}.atPercent`, reason: "atPercent must be a number between 0.0 and 1.0." });
+    }
+    const actionType = a["type"];
+    if (typeof actionType !== "number" && typeof actionType !== "string") {
+        errors.push({ path: `${path}.type`, reason: "type is required." });
+    }
+    else {
+        const numericType = resolveActionType(actionType);
+        if (numericType === undefined || !VALID_ACTION_TYPES.has(numericType)) {
+            errors.push({ path: `${path}.type`, reason: `unknown action type: ${String(actionType)}.` });
+        }
+        else if (numericType === PROTO_ACTION_TYPE.unspecified) {
+            errors.push({ path: `${path}.type`, reason: "action type must not be 'unspecified'." });
+        }
+        else {
+            if (ACTIONS_REQUIRING_TARGET.has(numericType)) {
+                if (typeof a["target"] !== "string" || a["target"].length === 0) {
+                    errors.push({ path: `${path}.target`, reason: "target is required for this action type." });
+                }
+            }
+        }
+        validateActionConfig(a, numericType, path, errors);
+    }
+}
+const ACTION_TYPE_BY_NAME = {};
+for (const [name, value] of Object.entries(PROTO_ACTION_TYPE)) {
+    ACTION_TYPE_BY_NAME[name] = value;
+}
+function resolveActionType(value) {
+    if (typeof value === "number")
+        return value;
+    return ACTION_TYPE_BY_NAME[value];
+}
+function validateActionConfig(action, actionType, path, errors) {
+    if (action["typeConfig"] !== undefined) {
+        const cfg = action["typeConfig"];
+        if (typeof cfg !== "object" || cfg === null) {
+            errors.push({ path: `${path}.typeConfig`, reason: "typeConfig must be an object." });
+        }
+        else {
+            const tc = cfg;
+            if (typeof tc["text"] !== "string" || tc["text"].length === 0) {
+                errors.push({ path: `${path}.typeConfig.text`, reason: "text is required and must be a non-empty string." });
+            }
+            if (tc["typeDelayMs"] !== undefined) {
+                if (typeof tc["typeDelayMs"] !== "number" || tc["typeDelayMs"] < 0) {
+                    errors.push({ path: `${path}.typeConfig.typeDelayMs`, reason: "typeDelayMs must be a non-negative integer." });
+                }
+            }
+        }
+    }
+    else if (actionType === PROTO_ACTION_TYPE.type) {
+        errors.push({ path: `${path}.typeConfig`, reason: "typeConfig is required for 'type' actions." });
+    }
+    if (action["hoverConfig"] !== undefined) {
+        const cfg = action["hoverConfig"];
+        if (typeof cfg !== "object" || cfg === null) {
+            errors.push({ path: `${path}.hoverConfig`, reason: "hoverConfig must be an object." });
+        }
+        else {
+            const hc = cfg;
+            if (hc["hoverDurationMs"] !== undefined) {
+                if (typeof hc["hoverDurationMs"] !== "number" || hc["hoverDurationMs"] < 0) {
+                    errors.push({ path: `${path}.hoverConfig.hoverDurationMs`, reason: "hoverDurationMs must be a non-negative integer." });
+                }
+            }
+        }
+    }
+    if (action["dragConfig"] !== undefined) {
+        const cfg = action["dragConfig"];
+        if (typeof cfg !== "object" || cfg === null) {
+            errors.push({ path: `${path}.dragConfig`, reason: "dragConfig must be an object." });
+        }
+        else {
+            const dc = cfg;
+            if (typeof dc["dragTarget"] !== "string" || dc["dragTarget"].length === 0) {
+                errors.push({ path: `${path}.dragConfig.dragTarget`, reason: "dragTarget is required and must be a non-empty string." });
+            }
+        }
+    }
+    else if (actionType === PROTO_ACTION_TYPE.drag) {
+        errors.push({ path: `${path}.dragConfig`, reason: "dragConfig is required for 'drag' actions." });
+    }
+}
+//# sourceMappingURL=scenario-validator.js.map

package/src/validate/scenario-validator.js.map

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