recordable 0.1.0

package/dist/formats/markdown/parse.js

@@ -0,0 +1,143 @@
+import matter from "gray-matter";
+import MarkdownIt from "markdown-it";
+import { callToAction } from "../../actions.js";
+import { parseVoiceover } from "../../validate.js";
+import { isMethodCall, parseMethodCall, parseMethodCalls, } from "./method.js";
+// ─── Markdown authoring surface ──────────────────────────────────────────────
+//
+// A recording can be authored as Markdown: fluent-API calls as inline backtick
+// spans inside narration prose (voiceover/timed), or a fenced block of one call
+// per line (a pure action list, no narration). It's a *surface* over the same
+// keyed-action IR the JSON layer uses — every call goes through `callToAction`.
+//
+// markdown-it tokenises the document, so the awkward cases (blank-line
+// boundaries, indented/`~~~` fences, code spans with commas or parens) are the
+// library's problem; we only interpret the tokens.
+//
+// Pure and browser-free: no TTS, ffmpeg or runtime. The voiceover add-on consumes
+// the offset-bearing narration blocks for timing; the core path extracts markers
+// to a plain action list, exactly as JSON would run.
+const md = new MarkdownIt();
+// Sentinel marking a removed call-span while we normalise narration whitespace.
+// A NUL never appears in prose and survives `\s+` collapsing (it isn't \s).
+const SENTINEL = "\u0000";
+/**
+ * Parse a Markdown document into config + ordered blocks. Pure: no audio, no
+ * network. Frontmatter (YAML, via gray-matter) carries recording config and an
+ * optional `voiceover` block; everything else is body content.
+ */
+export function parseMarkdown(md) {
+    const { data, content } = matter(md);
+    const { voiceover, ...config } = (data ?? {});
+    // `voiceover: true` opts in with everything from the environment (provider,
+    // voice, model); `false`/absent stays a plain, audio-free recording. An object
+    // is validated so a typo'd key (e.g. `voicId`) fails clearly here.
+    const vo = voiceover === true
+        ? {}
+        : voiceover === false || voiceover === undefined
+            ? undefined
+            : parseVoiceover(voiceover);
+    return {
+        config: config,
+        voiceover: vo,
+        blocks: parseBlocks(content),
+    };
+}
+/**
+ * Tokenise the body and emit a block per top-level token: any fenced/indented
+ * code block becomes an action list (the language tag is a visual aid only and is
+ * ignored), and each paragraph becomes a narration block.
+ */
+function parseBlocks(content) {
+    const blocks = [];
+    for (const t of md.parse(content, {})) {
+        if (t.type === "fence" || t.type === "code_block") {
+            const actions = parseMethodCalls(t.content).map((c) => callToAction(c.name, c.args));
+            if (actions.length)
+                blocks.push({ type: "actions", actions });
+        }
+        else if (t.type === "inline") {
+            // The `inline` token carries a paragraph's (or heading's) content.
+            const block = narrationFromInline(t.children ?? []);
+            if (block.narration || block.markers.length)
+                blocks.push(block);
+        }
+    }
+    return blocks;
+}
+/**
+ * Turn one prose paragraph into narration + markers. Call-shaped backtick spans
+ * are lifted out as markers; their character offset into the *stripped*
+ * narration (what TTS reads) is preserved for the compiler. Non-call backtick
+ * spans stay in the prose verbatim. Whitespace is collapsed without shifting any
+ * recorded offset.
+ */
+export function narrationBlock(raw) {
+    return narrationFromInline(md.parseInline(raw, {})[0]?.children ?? []);
+}
+/** Build a narration block from a paragraph's inline tokens (markdown-it). */
+function narrationFromInline(children) {
+    const calls = [];
+    // Flatten the inline tokens to text, replacing each method-call span with a
+    // single sentinel and keeping non-call code spans (and other prose) verbatim.
+    // Each span holds at most one call, so a call span maps to exactly one marker.
+    let s = "";
+    for (const tok of children) {
+        if (tok.type === "code_inline" && isMethodCall(tok.content)) {
+            calls.push(parseMethodCall(tok.content));
+            s += SENTINEL;
+        }
+        else if (tok.type === "code_inline") {
+            s += "`" + tok.content + "`";
+        }
+        else if (tok.type === "softbreak" || tok.type === "hardbreak") {
+            s += " ";
+        }
+        else if (tok.type === "text") {
+            s += tok.content;
+        }
+        // Emphasis/link wrappers (em_open, link_open, …) carry no text of their own;
+        // their text arrives as separate `text` children, so they're skipped here.
+    }
+    // Collapse all whitespace to single spaces, then drop a space immediately
+    // after a sentinel so removing it later never leaves a double space (a single
+    // leading space before the sentinel is kept as the word boundary).
+    s = s.replace(/\s+/g, " ").trim();
+    s = s.replace(new RegExp(SENTINEL + " ", "g"), SENTINEL);
+    let narration = "";
+    const markers = [];
+    let ci = 0;
+    for (const ch of s) {
+        if (ch === SENTINEL) {
+            const c = calls[ci++];
+            markers.push({
+                step: callToAction(c.name, c.args),
+                offset: narration.length,
+            });
+        }
+        else {
+            narration += ch;
+        }
+    }
+    // A trailing marker leaves a dangling space ("Lumen. ▮"); drop it and clamp
+    // any offset that now points past the end so it fires after the last word.
+    narration = narration.replace(/\s+$/, "");
+    for (const m of markers)
+        if (m.offset > narration.length)
+            m.offset = narration.length;
+    return { type: "narration", narration, markers };
+}
+/** Extract a plain action list from parsed blocks (markers in order, narration
+ *  and timing discarded; no audio). */
+export function extractActions(blocks) {
+    const actions = [];
+    for (const b of blocks) {
+        if (b.type === "actions")
+            actions.push(...b.actions);
+        else
+            for (const m of b.markers)
+                actions.push(m.step);
+    }
+    return actions;
+}
+//# sourceMappingURL=parse.js.map

package/dist/formats/markdown/parse.js.map

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

package/dist/fs.d.ts

@@ -0,0 +1,9 @@
+/** Move a file, falling back to copy+unlink across filesystem boundaries. */
+export declare function moveFile(src: string, dest: string): void;
+/** Build the timestamped output path and ensure its directory exists. */
+export declare function getOutputPath(opts: {
+    outputDir: string;
+    outputName: string;
+    outputTimestamp: boolean;
+}): string;
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAYxD;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,MAAM,CAQT"}

package/dist/fs.js

@@ -0,0 +1,30 @@
+// Filesystem helpers: cross-device-safe move and timestamped output-path build.
+import { mkdirSync, renameSync, copyFileSync, unlinkSync } from "node:fs";
+import { dirname } from "node:path";
+/** Move a file, falling back to copy+unlink across filesystem boundaries. */
+export function moveFile(src, dest) {
+    try {
+        renameSync(src, dest);
+    }
+    catch {
+        // Cross-device (tmp on a different filesystem) — copy then unlink.
+        copyFileSync(src, dest);
+        try {
+            unlinkSync(src);
+        }
+        catch {
+            /* best effort */
+        }
+    }
+}
+/** Build the timestamped output path and ensure its directory exists. */
+export function getOutputPath(opts) {
+    const { outputDir, outputName, outputTimestamp } = opts;
+    const timestamp = outputTimestamp
+        ? "-" + new Date().toISOString().replace(/\D/g, "").slice(0, 14)
+        : "";
+    const out = `${outputDir}/${outputName}${timestamp}.mp4`;
+    mkdirSync(dirname(out), { recursive: true });
+    return out;
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY;IAChD,IAAI,CAAC;QACH,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC;YACH,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,IAI7B;IACC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACxD,MAAM,SAAS,GAAG,eAAe;QAC/B,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAChE,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,UAAU,GAAG,SAAS,MAAM,CAAC;IACzD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Recordable } from "./compose/recordable.js";
+export { ACTIONS, callToAction, validateAction } from "./actions.js";
+export type { Action } from "./actions.js";
+export type { Script } from "./script.js";
+export { fromJSON, runScript } from "./formats/json.js";
+export { buildSchema } from "./schema.js";
+export { parseMarkdown } from "./formats/markdown/parse.js";
+export type { ParsedMarkdown, MarkdownBlock, NarrationBlock, ActionsBlock, } from "./formats/markdown/parse.js";
+export type { RecordableConfig, VoiceoverConfig, AudioOptions, InsertOptions, WaitForOptions, ResolvedConfig, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Recordable } from "./compose/recordable.js";
+export { ACTIONS, callToAction, validateAction } from "./actions.js";
+export { fromJSON, runScript } from "./formats/json.js";
+export { buildSchema } from "./schema.js";
+export { parseMarkdown } from "./formats/markdown/parse.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A callable logger. Call it for a normal progress line — a padded `name` label
+ * plus an optional value — and use `.success` / `.warn` / `.error` for status,
+ * conveyed by the colour of the `[Recordable]` prefix: blue progress, green
+ * success, yellow warn, red error. Stream + `silent` behaviour per method below.
+ */
+export interface Logger {
+    (name: string, value?: string): void;
+    /** Completion line, green prefix → stdout. Suppressed when `silent`. */
+    success(name: string, value?: string): void;
+    /** Non-fatal diagnostic → stderr. Suppressed when `silent`. */
+    warn(message: string): void;
+    /** Failure → stderr. Always printed, even when `silent`. */
+    error(message: string): void;
+}
+/**
+ * Build a logger. `isSilent` is read on every call so runtime `silent` changes
+ * (via `setConfig`) take effect immediately.
+ */
+export declare function createLogger(isSilent: () => boolean): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,+DAA+D;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4DAA4D;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AA6BD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,MAAM,CAiB5D"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+// Console logger: a status-coloured `[Recordable]` prefix plus a message body.
+const PREFIX = "[Recordable]";
+// 256-colour codes for the prefix, keyed by status.
+const COLOR = {
+    info: "38;5;111",
+    success: "38;5;114",
+    warn: "38;5;221",
+    error: "38;5;203",
+};
+/** Colour is on only for TTY streams, and never when NO_COLOR is set. */
+function colorEnabled(stream) {
+    return !process.env.NO_COLOR && Boolean(stream.isTTY);
+}
+/** Format a line: a status-coloured prefix followed by the message body. */
+function format(code, stream, label, value) {
+    const prefix = colorEnabled(stream) ? `\x1b[${code}m${PREFIX}\x1b[0m` : PREFIX;
+    const body = value !== undefined ? `${label.padEnd(8)}${value}` : label;
+    return `${prefix} ${body}`;
+}
+/**
+ * Build a logger. `isSilent` is read on every call so runtime `silent` changes
+ * (via `setConfig`) take effect immediately.
+ */
+export function createLogger(isSilent) {
+    const log = ((name, value) => {
+        if (isSilent())
+            return;
+        console.log(format(COLOR.info, process.stdout, name, value));
+    });
+    log.success = (name, value) => {
+        if (isSilent())
+            return;
+        console.log(format(COLOR.success, process.stdout, name, value));
+    };
+    log.warn = (message) => {
+        if (isSilent())
+            return;
+        console.warn(format(COLOR.warn, process.stderr, message));
+    };
+    log.error = (message) => {
+        console.error(format(COLOR.error, process.stderr, message));
+    };
+    return log;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAkB/E,MAAM,MAAM,GAAG,cAAc,CAAC;AAE9B,oDAAoD;AACpD,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;CAClB,CAAC;AAEF,yEAAyE;AACzE,SAAS,YAAY,CAAC,MAA0B;IAC9C,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,4EAA4E;AAC5E,SAAS,MAAM,CACb,IAAY,EACZ,MAA0B,EAC1B,KAAa,EACb,KAAc;IAEd,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,MAAM,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACxE,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAuB;IAClD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QAC5C,IAAI,QAAQ,EAAE;YAAE,OAAO;QACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAW,CAAC;IACb,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,IAAI,QAAQ,EAAE;YAAE,OAAO;QACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC;IACF,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE;QACrB,IAAI,QAAQ,EAAE;YAAE,OAAO;QACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC;IACF,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;QACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,5 @@
+type JSONSchema = Record<string, unknown>;
+/** Build the full JSON Schema for a Recordable script file. */
+export declare function buildSchema(): JSONSchema;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAYA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA6E1C,+DAA+D;AAC/D,wBAAgB,WAAW,IAAI,UAAU,CA+BxC"}

package/dist/schema.js

@@ -0,0 +1,100 @@
+import * as z from "zod";
+import { ACTIONS } from "./actions.js";
+import { ConfigSchema } from "./config.js";
+const SCHEMA_URL = "https://json-schema.org/draft/2020-12/schema";
+/** Recursively delete every `key` from a JSON Schema object tree. */
+function stripKey(node, key) {
+    if (Array.isArray(node)) {
+        node.forEach((n) => stripKey(n, key));
+    }
+    else if (node && typeof node === "object") {
+        delete node[key];
+        Object.values(node).forEach((v) => stripKey(v, key));
+    }
+}
+/** The properties + required keys an action contributes (beyond `action`),
+ *  read from its Zod schema. `setConfig`'s nested config points at the shared
+ *  `$defs/config` rather than inlining the whole config schema. */
+function actionShape(name) {
+    const js = z.toJSONSchema(ACTIONS[name], {
+        io: "input",
+    });
+    const properties = (js.properties ?? {});
+    const required = (js.required ?? []);
+    if ("config" in properties)
+        properties.config = { $ref: "#/$defs/config" };
+    return { properties, required };
+}
+/**
+ * The `action` schema: a single object whose `action` key enumerates every action,
+ * with one `if/then` per action applying that action's keys.
+ *
+ * This shape (rather than a `oneOf` of per-action objects) is what makes editor
+ * autocomplete offer *all* action names: VS Code only suggests `const` values
+ * from `oneOf` branches the current object already satisfies, so a `oneOf` lists
+ * just the no-arg actions until you've typed the other keys. The `enum` + `then`
+ * form keeps full autocomplete while preserving required-key and typo checks.
+ */
+function actionSchema() {
+    const actions = Object.keys(ACTIONS);
+    const allOf = actions.map((action) => {
+        const { properties, required } = actionShape(action);
+        return {
+            if: { properties: { action: { const: action } }, required: ["action"] },
+            then: {
+                properties: { action: { const: action }, ...properties },
+                required: ["action", ...required],
+                additionalProperties: false,
+            },
+        };
+    });
+    return {
+        type: "object",
+        required: ["action"],
+        properties: {
+            action: { enum: actions, description: "The action to perform." },
+        },
+        allOf,
+    };
+}
+/** Schema for the `config` block — derived from the Zod {@link ConfigSchema}.
+ *  Uses the input view (every field optional) and strips the emitted defaults so
+ *  the authoring schema stays type-only. `baseDir` is set by the CLI/runtime, not
+ *  authored in script files, so it's omitted. */
+function configSchema() {
+    const schema = z.toJSONSchema(ConfigSchema, { io: "input" });
+    delete schema.$schema;
+    stripKey(schema, "default");
+    delete schema.properties.baseDir;
+    return schema;
+}
+/** Build the full JSON Schema for a Recordable script file. */
+export function buildSchema() {
+    const action = actionSchema();
+    const objectForm = {
+        type: "object",
+        required: ["actions"],
+        additionalProperties: false,
+        properties: {
+            $schema: { type: "string" },
+            config: { $ref: "#/$defs/config" },
+            actions: { type: "array", items: { $ref: "#/$defs/action" } },
+        },
+    };
+    const arrayForm = {
+        type: "array",
+        items: { $ref: "#/$defs/action" },
+    };
+    return {
+        $schema: SCHEMA_URL,
+        $id: "https://raw.githubusercontent.com/paragramagency/recordable/main/recordable.schema.json",
+        title: "Recordable script",
+        description: "A declarative recording script: config + an array of actions.",
+        oneOf: [objectForm, arrayForm],
+        $defs: {
+            config: configSchema(),
+            action,
+        },
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/script.d.ts

@@ -0,0 +1,21 @@
+import type { Action } from "./actions.js";
+import type { RecordableConfig } from "./config.js";
+/** A whole script: a bare array of actions, or an object pairing config + actions. */
+export type Script = Action[] | {
+    $schema?: string;
+    config?: RecordableConfig;
+    actions: Action[];
+};
+/** Split a `Script` into its optional config and action array. */
+export declare function splitScript(script: Script): {
+    config?: RecordableConfig;
+    actions: Action[];
+};
+/**
+ * Resolve relative `visit` URLs (`./`, `../`) against `baseDir` so a script and
+ * its pages travel together regardless of cwd: each becomes a `file://` URL.
+ * Mutates the actions in place; a no-op when `baseDir` is empty.
+ * (Relative `outputDir`/`assetsDir` are resolved alongside, in the config.)
+ */
+export declare function resolveVisitUrls(actions: Action[], baseDir: string): void;
+//# sourceMappingURL=script.d.ts.map

package/dist/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../src/script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAsBpD,sFAAsF;AACtF,MAAM,MAAM,MAAM,GACd,MAAM,EAAE,GACR;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvE,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAGA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAWzE"}

package/dist/script.js

@@ -0,0 +1,26 @@
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+/** Split a `Script` into its optional config and action array. */
+export function splitScript(script) {
+    if (Array.isArray(script))
+        return { actions: script };
+    return { config: script.config, actions: script.actions };
+}
+/**
+ * Resolve relative `visit` URLs (`./`, `../`) against `baseDir` so a script and
+ * its pages travel together regardless of cwd: each becomes a `file://` URL.
+ * Mutates the actions in place; a no-op when `baseDir` is empty.
+ * (Relative `outputDir`/`assetsDir` are resolved alongside, in the config.)
+ */
+export function resolveVisitUrls(actions, baseDir) {
+    if (!baseDir)
+        return;
+    for (const step of actions) {
+        if (step.action === "visit" &&
+            typeof step.url === "string" &&
+            /^\.\.?\//.test(step.url)) {
+            step.url = pathToFileURL(resolve(baseDir, step.url)).href;
+        }
+    }
+}
+//# sourceMappingURL=script.js.map

package/dist/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../src/script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA6BzC,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,MAAc;IAIxC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACtD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiB,EAAE,OAAe;IACjE,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IACE,IAAI,CAAC,MAAM,KAAK,OAAO;YACvB,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;YAC5B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EACzB,CAAC;YACD,IAAI,CAAC,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/targets.d.ts

@@ -0,0 +1,6 @@
+/** Resolve a target string to a Puppeteer selector.
+ *  Prefix with `text:` for plain-text matching; everything else is a CSS selector. */
+export declare function resolveTarget(target: string): string;
+/** Returns true if the string is a CSS position keyword or percentage. */
+export declare function isPositionValue(value: string): boolean;
+//# sourceMappingURL=targets.d.ts.map

package/dist/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAGA;sFACsF;AACtF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGtD"}

package/dist/targets.js

@@ -0,0 +1,13 @@
+// Target resolution: author-facing target strings → Puppeteer selectors, plus
+// the position-keyword test used by zoom/scroll origins.
+/** Resolve a target string to a Puppeteer selector.
+ *  Prefix with `text:` for plain-text matching; everything else is a CSS selector. */
+export function resolveTarget(target) {
+    return target.startsWith("text:") ? `::-p-text(${target.slice(5)})` : target;
+}
+/** Returns true if the string is a CSS position keyword or percentage. */
+export function isPositionValue(value) {
+    const token = "(top|bottom|left|right|center|\\d+%)";
+    return new RegExp(`^${token}(\\s+${token})?$`, "i").test(value.trim());
+}
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yDAAyD;AAEzD;sFACsF;AACtF,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/E,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,KAAK,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/timing.d.ts

@@ -0,0 +1,41 @@
+import type { RecordableConfig } from "./config.js";
+import type { Action } from "./actions.js";
+/** Cursor "press" dip on click — scale down… */
+export declare const PRESS_DOWN_MS = 120;
+/** …then settle back. clickEffect spends their sum. */
+export declare const PRESS_SETTLE_MS = 60;
+/** Settle beat between arriving at a target and pressing (jitter base). */
+export declare const PRE_CLICK_MS = 100;
+/** Post-click probe: how long a click waits for a possible navigation to begin. */
+export declare const NAV_PROBE_MS = 200;
+/** Cursor-move duration for a known pixel distance — eased, clamped. */
+export declare function cursorMoveMs(dist: number): number;
+/** Estimated wall-clock an interactive action spends getting the cursor to its
+ *  target and pressing — *before* its payload (the keystrokes of a `type`, the
+ *  value-set of a `select`). The compiler adds this to elapsed so the next
+ *  narrated word is placed after the gesture, not on top of it. With the cursor
+ *  overlay off, only the real (non-animated) costs remain. */
+export declare function gestureLeadMs(step: Action, cfg: RecordableConfig): number;
+/** How long an action occupies the timeline, so the next wait measures from its end.
+ *  Omitted durations use the config default, never an elastic fit. The cursor's
+ *  travel-and-press to a target (`gestureLeadMs`) is added on top, so a click/type
+ *  doesn't silently push the rest of the paragraph late. */
+export declare function actionDurationMs(step: Action, cfg: RecordableConfig): Promise<number>;
+/** Returns `base` ± `variance` (defaults to ±50% of base). */
+export declare function jitter(base: number, variance?: number): number;
+/** Deterministic 32-bit string hash (FNV-1a). Seeds the typing PRNG so the same
+ *  text always types with the same rhythm (reproducible recordings). */
+export declare function hashString(s: string): number;
+/** mulberry32 PRNG → a function yielding floats in [0, 1). Pure integer math,
+ *  platform-independent, so a given seed reproduces the same sequence anywhere. */
+export declare function rng(seed: number): () => number;
+/** Total time (ms) a `type` action occupies — a pure function of text length and
+ *  speed (cps). This is the contract the voiceover compiler estimates against, so
+ *  it MUST stay identical to the compiler's `type` estimate. Jitter never alters it. */
+export declare function typingDuration(text: string, speed: number): number;
+/** Per-keystroke delays (ms) that sum to exactly `total`, with seeded, zero-sum
+ *  jitter. Returns `[leadPause, delayAfterChar1, …]` (lead beat + one per code
+ *  point). Punctuation gets a heavier structural weight (a natural micro-pause),
+ *  but all weights are normalised back onto `total` so the sum is invariant. */
+export declare function typingGaps(text: string, speed: number, total?: number, amount?: number): number[];
+//# sourceMappingURL=timing.d.ts.map

package/dist/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../src/timing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAW3C,gDAAgD;AAChD,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,uDAAuD;AACvD,eAAO,MAAM,eAAe,KAAK,CAAC;AAIlC,2EAA2E;AAC3E,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,mFAAmF;AACnF,eAAO,MAAM,YAAY,MAAM,CAAC;AAMhC,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAQD;;;;8DAI8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAmBzE;AAED;;;4DAG4D;AAC5D,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAID,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAE3D;AAQD;wEACwE;AACxE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;mFACmF;AACnF,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CAQ9C;AAED;;wFAEwF;AACxF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;gFAGgF;AAChF,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAoC,EAC3C,MAAM,SAAO,GACZ,MAAM,EAAE,CAgBV"}