recordable 0.1.0

package/dist/voiceover/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/voiceover/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAYvE,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,WAAgB;IAE7C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;CAgB7E;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,SAAO,GAAG,MAAM,CAmBvE"}

package/dist/voiceover/mock.js

@@ -0,0 +1,41 @@
+export class MockTTSProvider {
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async synthesize(text, _opts = {}) {
+        const msPerChar = this.opts.msPerChar ?? 55;
+        const sampleRate = this.opts.sampleRate ?? 8000;
+        const chars = [...text];
+        const startMs = chars.map((_, i) => i * msPerChar);
+        const endMs = chars.map((_, i) => (i + 1) * msPerChar);
+        const durationMs = chars.length * msPerChar;
+        return {
+            audio: silentWav(durationMs, sampleRate),
+            format: "wav",
+            durationMs,
+            alignment: { chars, startMs, endMs },
+        };
+    }
+}
+/** Build a valid silent 16-bit mono WAV of `durationMs` — ffmpeg-compatible. */
+export function silentWav(durationMs, sampleRate = 8000) {
+    const numSamples = Math.max(0, Math.round((durationMs / 1000) * sampleRate));
+    const dataSize = numSamples * 2; // 16-bit mono
+    const buf = Buffer.alloc(44 + dataSize); // samples already zero = silence
+    buf.write("RIFF", 0, "ascii");
+    buf.writeUInt32LE(36 + dataSize, 4);
+    buf.write("WAVE", 8, "ascii");
+    buf.write("fmt ", 12, "ascii");
+    buf.writeUInt32LE(16, 16); // PCM fmt chunk size
+    buf.writeUInt16LE(1, 20); // audioFormat = PCM
+    buf.writeUInt16LE(1, 22); // channels = mono
+    buf.writeUInt32LE(sampleRate, 24);
+    buf.writeUInt32LE(sampleRate * 2, 28); // byteRate
+    buf.writeUInt16LE(2, 32); // blockAlign
+    buf.writeUInt16LE(16, 34); // bitsPerSample
+    buf.write("data", 36, "ascii");
+    buf.writeUInt32LE(dataSize, 40);
+    return buf;
+}
+//# sourceMappingURL=mock.js.map

package/dist/voiceover/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../src/voiceover/mock.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,OAAoB,EAAE;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,QAAsB,EAAE;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;QAEhD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QAE5C,OAAO;YACL,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;YACxC,MAAM,EAAE,KAAK;YACb,UAAU;YACV,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;SACrC,CAAC;IACJ,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,UAAU,GAAG,IAAI;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,cAAc;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,iCAAiC;IAE1E,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,aAAa,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB;IAChD,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB;IAC9C,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;IAC5C,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,aAAa,CAAC,UAAU,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW;IAClD,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;IACvC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB;IAC3C,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/voiceover/types.d.ts

@@ -0,0 +1,31 @@
+/** Provider-agnostic, normalised character alignment (all times in ms). */
+export interface Alignment {
+    /** One entry per character of the synthesized text. */
+    chars: string[];
+    /** Per-character start time, ms from the clip start. */
+    startMs: number[];
+    /** Per-character end time, ms from the clip start. */
+    endMs: number[];
+}
+/** The product of one synthesis: decoded audio bytes plus timing. */
+export interface TTSResult {
+    /** Decoded audio bytes (already base64-decoded). */
+    audio: Buffer;
+    /** Encoded format, e.g. "mp3_44100_128". */
+    format: string;
+    /** Clip duration in ms (alignment-derived when available). */
+    durationMs: number;
+    /** Character alignment, if the provider returned it. Degrade gracefully if absent. */
+    alignment?: Alignment;
+}
+/** Per-call synthesis options (reserved for future per-block overrides). */
+export interface SynthOptions {
+    format?: string;
+}
+/** Turns narration text into audio + timing. The one thing add-ons implement. */
+export interface TTSProvider {
+    synthesize(text: string, opts?: SynthOptions): Promise<TTSResult>;
+}
+/** File extension for an encoded format string, e.g. "mp3_44100_128" → "mp3". */
+export declare function extFor(format: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/voiceover/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/voiceover/types.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,uDAAuD;IACvD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACnE;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/voiceover/types.js

@@ -0,0 +1,10 @@
+// ─── TTS adapter contract ────────────────────────────────────────────────────
+//
+// The swappable boundary between narration text and audio+timing. A provider
+// knows nothing about ffmpeg, the queue, or scheduling — it only turns text into
+// sound plus optional character alignment. ElevenLabs is the first implementation.
+/** File extension for an encoded format string, e.g. "mp3_44100_128" → "mp3". */
+export function extFor(format) {
+    return format.split("_")[0] || "mp3";
+}
+//# sourceMappingURL=types.js.map

package/dist/voiceover/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/voiceover/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,mFAAmF;AAkCnF,iFAAiF;AACjF,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "recordable",
+  "version": "0.1.0",
+  "description": "Programmatic, repeatable browser screen recording. Script a walkthrough as a fluent chain of actions — clicks, typing, smooth zoom/scroll, an animated cursor, and manual steps like logins — and capture it to MP4.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/paragramagency/recordable.git"
+  },
+  "homepage": "https://github.com/paragramagency/recordable#readme",
+  "bugs": {
+    "url": "https://github.com/paragramagency/recordable/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "recordable": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./voiceover": {
+      "types": "./dist/voiceover/index.d.ts",
+      "import": "./dist/voiceover/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "recordable.schema.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "tsx --test test/**/*.test.ts",
+    "clean": "rm -rf dist",
+    "gen:schema": "tsx scripts/gen-schema.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run clean && npm run gen:schema && npm run build"
+  },
+  "keywords": [
+    "screen-recording",
+    "screencast",
+    "screen-capture",
+    "recorder",
+    "puppeteer",
+    "automation",
+    "browser",
+    "scripted",
+    "video",
+    "mp4"
+  ],
+  "author": "Cam Parry <hello@camparry.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ffmpeg-installer/ffmpeg": "^1.1.0",
+    "gray-matter": "^4.0.3",
+    "json5": "^2.2.3",
+    "markdown-it": "^14.2.0",
+    "puppeteer": "^22.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^20.0.0",
+    "eslint": "^10.5.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.4",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.62.0"
+  },
+  "optionalDependencies": {
+    "@elevenlabs/elevenlabs-js": "^2.0.0"
+  }
+}