tutorial-forge 0.1.0

package/dist/post/subtitles.js

@@ -0,0 +1,47 @@
+/**
+ * One SRT cue per narrated step: text = narration, range = narration playback
+ * window. Cue times are relative to the trimmed video, so trimStartMs (manifest
+ * clock) is subtracted.
+ */
+export function generateSrt(manifest, opts) {
+    const max = opts.maxLineChars ?? 42;
+    const cues = [];
+    let n = 0;
+    for (const step of manifest.steps) {
+        if (!step.narration.trim() || step.audioDurationMs <= 0)
+            continue;
+        n += 1;
+        const start = step.startMs + opts.leadInMs - opts.trimStartMs;
+        const end = start + step.audioDurationMs;
+        cues.push(`${n}\n${srtTime(start)} --> ${srtTime(end)}\n${wrapText(step.narration, max)}\n`);
+    }
+    return cues.join('\n');
+}
+export function srtTime(ms) {
+    const clamped = Math.max(0, Math.round(ms));
+    const h = Math.floor(clamped / 3_600_000);
+    const m = Math.floor((clamped % 3_600_000) / 60_000);
+    const s = Math.floor((clamped % 60_000) / 1000);
+    const f = clamped % 1000;
+    const pad = (v, len = 2) => String(v).padStart(len, '0');
+    return `${pad(h)}:${pad(m)}:${pad(s)},${pad(f, 3)}`;
+}
+/** Greedy word wrap at ~max chars/line. */
+export function wrapText(text, max) {
+    const words = text.trim().split(/\s+/);
+    const lines = [];
+    let line = '';
+    for (const word of words) {
+        if (line && line.length + 1 + word.length > max) {
+            lines.push(line);
+            line = word;
+        }
+        else {
+            line = line ? `${line} ${word}` : word;
+        }
+    }
+    if (line)
+        lines.push(line);
+    return lines.join('\n');
+}
+//# sourceMappingURL=subtitles.js.map

package/dist/post/subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.js","sourceRoot":"","sources":["../../src/post/subtitles.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,QAAwB,EACxB,IAAsE;IAEtE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC;YAAE,SAAS;QAClE,CAAC,IAAI,CAAC,CAAC;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC;QAC9D,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAW;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,CAAC;IACH,CAAC;IACD,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/spec.d.ts

@@ -0,0 +1,7 @@
+import type { Step, Tutorial } from './types.js';
+export declare function step(narration: string, run: Step['run'], opts?: Partial<Step>): Step;
+export declare function tutorial(idOrTitle: string, steps: Step[], meta?: Partial<Tutorial>): Tutorial;
+export declare function validateTutorial(t: Tutorial): void;
+/** Resolve a step's stable id: explicit id, or its zero-padded index. */
+export declare function stepId(s: Step, index: number): string;
+export declare function slugify(s: string): string;

package/dist/spec.js

@@ -0,0 +1,51 @@
+import { logger } from './util/logger.js';
+const SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
+// SSML tags or ASCII control chars in narration usually mean copy-paste from
+// another TTS system; providers read them literally, so warn at load time.
+const SUSPICIOUS_NARRATION_RE = /<[a-z][^>]*>|[\x00-\x08\x0b\x0c\x0e-\x1f]/i;
+export function step(narration, run, opts) {
+    return { narration, run, ...opts };
+}
+export function tutorial(idOrTitle, steps, meta) {
+    const id = meta?.id ?? slugify(idOrTitle);
+    const title = meta?.title ?? idOrTitle;
+    const t = { ...meta, id, title, steps };
+    validateTutorial(t);
+    return t;
+}
+export function validateTutorial(t) {
+    if (!t.id || !SLUG_RE.test(t.id)) {
+        throw new Error(`Tutorial id "${t.id}" must be a lowercase slug (a-z, 0-9, hyphens)`);
+    }
+    if (!Array.isArray(t.steps) || t.steps.length === 0) {
+        throw new Error(`Tutorial "${t.id}" has no steps`);
+    }
+    const seen = new Set();
+    t.steps.forEach((s, i) => {
+        if (typeof s.narration !== 'string') {
+            throw new Error(`Tutorial "${t.id}" step ${i}: narration must be a string`);
+        }
+        if (typeof s.run !== 'function') {
+            throw new Error(`Tutorial "${t.id}" step ${i}: run must be a function`);
+        }
+        const id = stepId(s, i);
+        if (seen.has(id)) {
+            throw new Error(`Tutorial "${t.id}" step ${i}: duplicate step id "${id}"`);
+        }
+        seen.add(id);
+        if (SUSPICIOUS_NARRATION_RE.test(s.narration)) {
+            logger.warn(`Tutorial "${t.id}" step ${i} ("${id}"): narration contains markup or control characters; TTS providers will read these literally`);
+        }
+    });
+}
+/** Resolve a step's stable id: explicit id, or its zero-padded index. */
+export function stepId(s, index) {
+    return s.id ?? `step-${String(index + 1).padStart(2, '0')}`;
+}
+export function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

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

package/dist/tts/cache.d.ts

@@ -0,0 +1,10 @@
+import type { TTSProvider } from '../types.js';
+export declare function defaultCacheDir(): string;
+export declare function cacheKeyFor(provider: TTSProvider, text: string): string;
+/**
+ * Synthesize one narration line through the content-hash cache.
+ * Cached entries are already normalized to 48kHz mono WAV; on miss we
+ * synthesize to a temp file, normalize, and move into the cache atomically.
+ * Returns the path of a WAV copy at outPath.
+ */
+export declare function synthesizeCached(provider: TTSProvider, text: string, outPath: string, cacheDir?: string): Promise<void>;

package/dist/tts/cache.js

@@ -0,0 +1,43 @@
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { copyFile, rename, rm } from 'node:fs/promises';
+import { sha256 } from '../util/hash.js';
+import { ensureDir, exists } from '../util/fs.js';
+import { normalizeToWav } from '../post/ffmpeg.js';
+import { logger } from '../util/logger.js';
+export function defaultCacheDir() {
+    return join(process.env.XDG_CACHE_HOME ?? join(homedir(), '.cache'), 'tutorial-forge', 'tts');
+}
+export function cacheKeyFor(provider, text) {
+    return sha256(provider.cacheKey, text);
+}
+/**
+ * Synthesize one narration line through the content-hash cache.
+ * Cached entries are already normalized to 48kHz mono WAV; on miss we
+ * synthesize to a temp file, normalize, and move into the cache atomically.
+ * Returns the path of a WAV copy at outPath.
+ */
+export async function synthesizeCached(provider, text, outPath, cacheDir = defaultCacheDir()) {
+    const cached = join(cacheDir, `${cacheKeyFor(provider, text)}.wav`);
+    if (!(await exists(cached))) {
+        await ensureDir(cacheDir);
+        const raw = cached + '.raw.tmp';
+        const normalized = cached + '.tmp';
+        try {
+            await provider.synthesize(text, raw);
+            await normalizeToWav(raw, normalized);
+            await rename(normalized, cached);
+        }
+        finally {
+            await rm(raw, { force: true });
+            await rm(normalized, { force: true });
+        }
+        logger.debug(`tts cache miss: "${text.slice(0, 40)}…"`);
+    }
+    else {
+        logger.debug(`tts cache hit: "${text.slice(0, 40)}…"`);
+    }
+    await ensureDir(dirname(outPath));
+    await copyFile(cached, outPath);
+}
+//# sourceMappingURL=cache.js.map

package/dist/tts/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/tts/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAqB,EAAE,IAAY;IAC7D,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAqB,EACrB,IAAY,EACZ,OAAe,EACf,QAAQ,GAAG,eAAe,EAAE;IAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,MAAM,GAAG,UAAU,CAAC;QAChC,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACrC,MAAM,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/B,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/tts/elevenlabs.d.ts

@@ -0,0 +1,11 @@
+import type { TTSProvider } from '../types.js';
+export interface ElevenLabsOptions {
+    voiceId: string;
+    apiKey?: string;
+    modelId?: string;
+    /** 0..1, provider default 0.5 */
+    stability?: number;
+    /** 0..1, provider default 0.75 */
+    similarityBoost?: number;
+}
+export declare function ElevenLabs(opts: ElevenLabsOptions): TTSProvider;

package/dist/tts/elevenlabs.js

@@ -0,0 +1,37 @@
+import { writeFile } from 'node:fs/promises';
+export function ElevenLabs(opts) {
+    const apiKey = opts.apiKey ?? process.env.ELEVENLABS_API_KEY;
+    const modelId = opts.modelId ?? 'eleven_turbo_v2_5';
+    return {
+        cacheKey: `elevenlabs:${opts.voiceId}:${modelId}`,
+        async synthesize(text, outPath) {
+            if (!apiKey)
+                throw new Error('ElevenLabs: missing apiKey (set ELEVENLABS_API_KEY)');
+            const res = await fetch(`https://api.elevenlabs.io/v1/text-to-speech/${encodeURIComponent(opts.voiceId)}`, {
+                method: 'POST',
+                headers: { 'xi-api-key': apiKey, 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    text,
+                    model_id: modelId,
+                    voice_settings: {
+                        stability: opts.stability ?? 0.5,
+                        similarity_boost: opts.similarityBoost ?? 0.75,
+                    },
+                }),
+            });
+            if (!res.ok) {
+                throw new Error(`ElevenLabs: HTTP ${res.status} ${await safeBody(res)}`);
+            }
+            await writeFile(outPath, Buffer.from(await res.arrayBuffer()));
+        },
+    };
+}
+async function safeBody(res) {
+    try {
+        return (await res.text()).slice(0, 300);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=elevenlabs.js.map

package/dist/tts/elevenlabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.js","sourceRoot":"","sources":["../../src/tts/elevenlabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAa7C,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,mBAAmB,CAAC;IACpD,OAAO;QACL,QAAQ,EAAE,cAAc,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE;QACjD,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAe;YAC5C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACpF,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,+CAA+C,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EACjF;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,IAAI;oBACJ,QAAQ,EAAE,OAAO;oBACjB,cAAc,EAAE;wBACd,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG;wBAChC,gBAAgB,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;qBAC/C;iBACF,CAAC;aACH,CACF,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,IAAI,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tts/openai.d.ts

@@ -0,0 +1,9 @@
+import type { TTSProvider } from '../types.js';
+export interface OpenAITTSOptions {
+    voice?: string;
+    apiKey?: string;
+    model?: string;
+    /** 0.25..4.0, default 1.0 */
+    speed?: number;
+}
+export declare function OpenAITTS(opts?: OpenAITTSOptions): TTSProvider;

package/dist/tts/openai.js

@@ -0,0 +1,29 @@
+import { writeFile } from 'node:fs/promises';
+export function OpenAITTS(opts = {}) {
+    const apiKey = opts.apiKey ?? process.env.OPENAI_API_KEY;
+    const model = opts.model ?? 'gpt-4o-mini-tts';
+    const voice = opts.voice ?? 'alloy';
+    return {
+        cacheKey: `openai:${voice}:${model}:${opts.speed ?? 1}`,
+        async synthesize(text, outPath) {
+            if (!apiKey)
+                throw new Error('OpenAI TTS: missing apiKey (set OPENAI_API_KEY)');
+            const res = await fetch('https://api.openai.com/v1/audio/speech', {
+                method: 'POST',
+                headers: { authorization: `Bearer ${apiKey}`, 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    model,
+                    voice,
+                    input: text,
+                    speed: opts.speed ?? 1,
+                    response_format: 'wav',
+                }),
+            });
+            if (!res.ok) {
+                throw new Error(`OpenAI TTS: HTTP ${res.status} ${(await res.text()).slice(0, 300)}`);
+            }
+            await writeFile(outPath, Buffer.from(await res.arrayBuffer()));
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/tts/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/tts/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAW7C,MAAM,UAAU,SAAS,CAAC,OAAyB,EAAE;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,iBAAiB,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;IACpC,OAAO;QACL,QAAQ,EAAE,UAAU,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE;QACvD,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAe;YAC5C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YAChF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,wCAAwC,EAAE;gBAChE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAClF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK;oBACL,KAAK;oBACL,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;oBACtB,eAAe,EAAE,KAAK;iBACvB,CAAC;aACH,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tts/piper.d.ts

@@ -0,0 +1,10 @@
+import type { TTSProvider } from '../types.js';
+export interface PiperOptions {
+    /** Path to a piper voice .onnx model. */
+    model: string;
+    /** Piper binary, default "piper" on PATH. */
+    binary?: string;
+    speakerId?: number;
+}
+/** Local/offline TTS via the piper CLI (https://github.com/rhasspy/piper). */
+export declare function Piper(opts: PiperOptions): TTSProvider;

package/dist/tts/piper.js

@@ -0,0 +1,20 @@
+import { execa } from 'execa';
+/** Local/offline TTS via the piper CLI (https://github.com/rhasspy/piper). */
+export function Piper(opts) {
+    const binary = opts.binary ?? 'piper';
+    return {
+        cacheKey: `piper:${opts.model}:${opts.speakerId ?? 0}`,
+        async synthesize(text, outPath) {
+            const args = ['--model', opts.model, '--output_file', outPath];
+            if (opts.speakerId !== undefined)
+                args.push('--speaker', String(opts.speakerId));
+            try {
+                await execa(binary, args, { input: text });
+            }
+            catch (err) {
+                throw new Error(`Piper synthesis failed (is "${binary}" installed and the model path valid?): ${err.shortMessage ?? err}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=piper.js.map

package/dist/tts/piper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piper.js","sourceRoot":"","sources":["../../src/tts/piper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAW9B,8EAA8E;AAC9E,MAAM,UAAU,KAAK,CAAC,IAAkB;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtC,OAAO;QACL,QAAQ,EAAE,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE;QACtD,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAe;YAC5C,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YACjF,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,2CAClC,GAAiC,CAAC,YAAY,IAAI,GACrD,EAAE,CACH,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tts/provider.d.ts

@@ -0,0 +1,6 @@
+export type { TTSProvider } from '../types.js';
+/**
+ * Fallback duration estimator: average speech runs ~160 wpm; 380ms/word with a
+ * 1.2s floor. Also the deterministic duration used by SilentProvider.
+ */
+export declare function estimateDurationMs(text: string): number;

package/dist/tts/provider.js

@@ -0,0 +1,9 @@
+/**
+ * Fallback duration estimator: average speech runs ~160 wpm; 380ms/word with a
+ * 1.2s floor. Also the deterministic duration used by SilentProvider.
+ */
+export function estimateDurationMs(text) {
+    const words = text.trim().split(/\s+/).filter(Boolean).length;
+    return Math.max(1200, words * 380);
+}
+//# sourceMappingURL=provider.js.map

package/dist/tts/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/tts/provider.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/tts/silent.d.ts

@@ -0,0 +1,8 @@
+import type { TTSProvider } from '../types.js';
+/**
+ * Generates silence whose duration follows the word-count heuristic.
+ * Deterministic, offline, no ffmpeg needed — for tests and CI.
+ */
+export declare function SilentProvider(): TTSProvider;
+/** Minimal 16-bit mono PCM WAV of the given duration. */
+export declare function silentWav(durationMs: number, sampleRate?: number): Buffer;

package/dist/tts/silent.js

@@ -0,0 +1,37 @@
+import { writeFile } from 'node:fs/promises';
+import { estimateDurationMs } from './provider.js';
+const SAMPLE_RATE = 48000;
+/**
+ * Generates silence whose duration follows the word-count heuristic.
+ * Deterministic, offline, no ffmpeg needed — for tests and CI.
+ */
+export function SilentProvider() {
+    return {
+        cacheKey: 'silent:v1',
+        async synthesize(text, outPath) {
+            const ms = estimateDurationMs(text);
+            await writeFile(outPath, silentWav(ms));
+        },
+    };
+}
+/** Minimal 16-bit mono PCM WAV of the given duration. */
+export function silentWav(durationMs, sampleRate = SAMPLE_RATE) {
+    const samples = Math.round((durationMs / 1000) * sampleRate);
+    const dataSize = samples * 2;
+    const buf = Buffer.alloc(44 + dataSize);
+    buf.write('RIFF', 0);
+    buf.writeUInt32LE(36 + dataSize, 4);
+    buf.write('WAVE', 8);
+    buf.write('fmt ', 12);
+    buf.writeUInt32LE(16, 16); // fmt chunk size
+    buf.writeUInt16LE(1, 20); // PCM
+    buf.writeUInt16LE(1, 22); // mono
+    buf.writeUInt32LE(sampleRate, 24);
+    buf.writeUInt32LE(sampleRate * 2, 28); // byte rate
+    buf.writeUInt16LE(2, 32); // block align
+    buf.writeUInt16LE(16, 34); // bits per sample
+    buf.write('data', 36);
+    buf.writeUInt32LE(dataSize, 40);
+    return buf;
+}
+//# sourceMappingURL=silent.js.map

package/dist/tts/silent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"silent.js","sourceRoot":"","sources":["../../src/tts/silent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAe;YAC5C,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,UAAU,GAAG,WAAW;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IACxC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrB,GAAG,CAAC,aAAa,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrB,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtB,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB;IAC5C,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;IAChC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO;IACjC,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,aAAa,CAAC,UAAU,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY;IACnD,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc;IACxC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;IAC7C,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtB,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+import type { Page } from 'playwright';
+/** Gets the target app into a known, recordable state. The only app-specific code. */
+export interface TutorialAdapter {
+    /** Base URL of the running app, e.g. http://localhost:3000 */
+    baseURL: string;
+    /** Auth, seeding, navigation to a starting screen. Runs after page creation, before step 1. Excluded from the final video by default. */
+    setup(page: Page): Promise<void>;
+    /** Optional cleanup after recording (delete seeded data, logout). Never recorded. */
+    teardown?(page: Page): Promise<void>;
+}
+export interface Step {
+    /** Stable id, auto-derived from index if omitted. Used in manifest, cache keys, logs. */
+    id?: string;
+    /** The narration line spoken over this step. Plain text; may be ''. */
+    narration: string;
+    /** The action. Receives the raw Playwright Page. May be a no-op for pure-narration steps. */
+    run: (page: Page) => Promise<void>;
+    /** Optional readiness hook awaited after run(); use when auto-waiting isn't enough. */
+    waitFor?: (page: Page) => Promise<void>;
+    /** Extra hold time (ms) after both narration and action complete. Default 400. */
+    settleMs?: number;
+}
+export interface Tutorial {
+    /** Slug, used for output filenames. */
+    id: string;
+    title: string;
+    description?: string;
+    steps: Step[];
+}
+export interface TTSProvider {
+    /** Unique key for cache partitioning, e.g. "elevenlabs:daniel:eleven_turbo_v2" */
+    cacheKey: string;
+    /** Synthesize one narration line to a WAV/MP3 file at outPath. Duration is measured by the pipeline via ffprobe, not trusted from the provider. */
+    synthesize(text: string, outPath: string): Promise<void>;
+}
+export interface RenderOptions {
+    tts: TTSProvider;
+    /** Path to final .mp4 */
+    output: string;
+    /** Default: .forge/<tutorial-id>/ */
+    workDir?: string;
+    /** Default 1920x1080 */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Default true */
+    headless?: boolean;
+    /** Inject fake cursor, default true */
+    cursor?: boolean;
+    /** Highlight clicked elements, default true */
+    callouts?: boolean;
+    /** Default 'sidecar' (writes .srt next to mp4) */
+    subtitles?: 'burn' | 'sidecar' | 'off';
+    /** Silence before step narration starts, default 300 */
+    leadInMs?: number;
+    /** Default false on success, true on failure */
+    keepWorkDir?: boolean;
+    /** Directory for the content-hashed TTS cache. Default: ~/.cache/tutorial-forge/tts */
+    ttsCacheDir?: string;
+    /** TTS synthesis concurrency, default 4 */
+    ttsConcurrency?: number;
+    /** Which phases to run. Default 'all'. */
+    phase?: 'tts' | 'record' | 'post' | 'all';
+}
+export interface CalloutRecord {
+    atMs: number;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface ManifestStep {
+    id: string;
+    narration: string;
+    audioFile: string | null;
+    /** 0 for silent steps */
+    audioDurationMs: number;
+    /** Offset from video start */
+    startMs: number;
+    /** When run() began */
+    actionStartMs: number;
+    /** When run()+waitFor resolved */
+    actionEndMs: number;
+    /** When the step's hold completed */
+    endMs: number;
+    callouts: CalloutRecord[];
+}
+/** Written to workDir as manifest.json; the contract between record and post phases. */
+export interface TimingManifest {
+    tutorialId: string;
+    fps: number;
+    recordingStartEpochMs: number;
+    /** Offset (ms) into the raw webm where the recording clock's zero falls, derived from the calibration flash. 0 if undetected. */
+    videoClockOffsetMs?: number;
+    steps: ManifestStep[];
+    totalDurationMs: number;
+}
+/** Thrown when a step's run()/waitFor() rejects during recording. */
+export declare class StepError extends Error {
+    readonly tutorialId: string;
+    readonly stepId: string;
+    readonly cause: unknown;
+    constructor(tutorialId: string, stepId: string, cause: unknown);
+}

package/dist/types.js

@@ -0,0 +1,14 @@
+/** Thrown when a step's run()/waitFor() rejects during recording. */
+export class StepError extends Error {
+    tutorialId;
+    stepId;
+    cause;
+    constructor(tutorialId, stepId, cause) {
+        super(`Step "${stepId}" of tutorial "${tutorialId}" failed: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.tutorialId = tutorialId;
+        this.stepId = stepId;
+        this.cause = cause;
+        this.name = 'StepError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwGA,qEAAqE;AACrE,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEhB;IACA;IACS;IAH3B,YACkB,UAAkB,EAClB,MAAc,EACL,KAAc;QAEvC,KAAK,CACH,SAAS,MAAM,kBAAkB,UAAU,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjH,CAAC;QANc,eAAU,GAAV,UAAU,CAAQ;QAClB,WAAM,GAAN,MAAM,CAAQ;QACL,UAAK,GAAL,KAAK,CAAS;QAKvC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/util/fs.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function removeDir(dir: string): Promise<void>;
+export declare function exists(path: string): Promise<boolean>;
+/** Run tasks with bounded concurrency, preserving result order. */
+export declare function mapLimit<T, R>(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/util/fs.js

@@ -0,0 +1,30 @@
+import { mkdir, rm, access } from 'node:fs/promises';
+export async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true });
+}
+export async function removeDir(dir) {
+    await rm(dir, { recursive: true, force: true });
+}
+export async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Run tasks with bounded concurrency, preserving result order. */
+export async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, async () => {
+        while (next < items.length) {
+            const i = next++;
+            results[i] = await fn(items[i], i);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=fs.js.map

package/dist/util/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAU,EACV,KAAa,EACb,EAA0C;IAE1C,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC5F,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/util/hash.d.ts

@@ -0,0 +1 @@
+export declare function sha256(...parts: string[]): string;

package/dist/util/hash.js

@@ -0,0 +1,7 @@
+import { createHash } from 'node:crypto';
+export function sha256(...parts) {
+    const h = createHash('sha256');
+    h.update(parts.join('\0'));
+    return h.digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/util/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/util/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,MAAM,CAAC,GAAG,KAAe;IACvC,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/util/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    debug: (msg: string) => void;
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};

package/dist/util/logger.js

@@ -0,0 +1,21 @@
+const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
+function threshold() {
+    const env = (process.env.FORGE_LOG ?? 'info');
+    return LEVELS[env] ?? 20;
+}
+function emit(level, msg) {
+    if (LEVELS[level] < threshold())
+        return;
+    const line = `[forge] ${level === 'info' ? '' : level + ': '}${msg}`;
+    if (level === 'error' || level === 'warn')
+        process.stderr.write(line + '\n');
+    else
+        process.stdout.write(line + '\n');
+}
+export const logger = {
+    debug: (msg) => emit('debug', msg),
+    info: (msg) => emit('info', msg),
+    warn: (msg) => emit('warn', msg),
+    error: (msg) => emit('error', msg),
+};
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAA0B,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAEnF,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAU,CAAC;IACvD,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,IAAI,CAAC,KAAY,EAAE,GAAW;IACrC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,EAAE;QAAE,OAAO;IACxC,MAAM,IAAI,GAAG,WAAW,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC;IACrE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;IAC1C,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;IACxC,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;IACxC,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;CAC3C,CAAC"}