playwright-director 0.2.0

package/dist/postinstall.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { outdated, packageVersion } from './skill-stamp.js';
+/**
+ * Prints a one-line reminder when a project's copied skill/agent no longer
+ * matches the installed package. It never writes anything: a dependency has no
+ * business editing a project's `.claude/` directory unasked.
+ *
+ * Silent unless there is something to say, and it must never fail an install —
+ * every path exits 0.
+ */
+try {
+    const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+    // npm sets INIT_CWD to the directory the install was launched from.
+    const projectRoot = process.env.INIT_CWD || process.cwd();
+    const claudeDir = join(projectRoot, '.claude');
+    const installed = {
+        skill: existsSync(join(claudeDir, 'skills', 'tutorialize')),
+        agent: existsSync(join(claudeDir, 'agents', 'tutorial-crafter.md'))
+    };
+    // Nothing installed means the project never opted in — stay quiet.
+    if (installed.skill || installed.agent) {
+        const version = packageVersion(packageRoot);
+        const stale = outdated(claudeDir, version, installed);
+        if (stale.length > 0) {
+            const what = stale.join(' and ');
+            const verb = stale.length > 1 ? 'are' : 'is';
+            console.log(`\nplaywright-director ${version}: your ${what} in .claude/ ${verb} out of date.` +
+                `\n  Run: npx playwright-director init\n`);
+        }
+    }
+}
+catch {
+    // A reminder is never worth breaking an install over.
+}
+//# sourceMappingURL=postinstall.js.map

package/dist/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;GAOG;AACH,IAAI,CAAC;IACJ,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxE,oEAAoE;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG;QACjB,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC3D,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;KACnE,CAAC;IAEF,mEAAmE;IACnE,IAAI,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAEtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7C,OAAO,CAAC,GAAG,CACV,yBAAyB,OAAO,UAAU,IAAI,gBAAgB,IAAI,eAAe;gBAChF,yCAAyC,CAC1C,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC;AAAC,MAAM,CAAC;IACR,sDAAsD;AACvD,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,22 @@
+import type { Reporter, TestCase, TestResult } from '@playwright/test/reporter';
+export interface TutorialReporterOptions {
+    mappingFile?: string;
+    tutorialsJson?: string;
+}
+declare class TutorialMergeReporter implements Reporter {
+    private mappingFile;
+    private tutorialsJson;
+    constructor(options?: TutorialReporterOptions);
+    onBegin(): void;
+    onTestEnd(test: TestCase, result: TestResult): void;
+    /**
+     * Find the full-screen black sync marker in the source video and return
+     * the timestamp (seconds) of its END — the exact video time of timeline
+     * zero. Returns null when no black interval is found.
+     */
+    private detectSyncMarker;
+    private patchTutorialsDuration;
+    private findTimelineByTitle;
+}
+export default TutorialMergeReporter;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAOhF,MAAM,WAAW,uBAAuB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,cAAM,qBAAsB,YAAW,QAAQ;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,uBAA4B;IAKjD,OAAO,IAAI,IAAI;IAIf,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IA+DnD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,sBAAsB;IA+C9B,OAAO,CAAC,mBAAmB;CAwB3B;AAED,eAAe,qBAAqB,CAAC"}

package/dist/reporter.js

@@ -0,0 +1,166 @@
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'fs';
+import { join } from 'path';
+const OUTPUT_DIR = process.env.TUTORIAL_OUTPUT_DIR || 'tutorials/output';
+class TutorialMergeReporter {
+    mappingFile;
+    tutorialsJson;
+    constructor(options = {}) {
+        this.mappingFile = options.mappingFile ?? process.env.TUTORIAL_MAPPING_FILE ?? 'tutorial-mapping.txt';
+        this.tutorialsJson = options.tutorialsJson ?? process.env.TUTORIAL_TUTORIALS_JSON ?? 'tutorials.json';
+    }
+    onBegin() {
+        console.log('[TutorialMerge] Reporter loaded — will merge videos after each tutorial test');
+    }
+    onTestEnd(test, result) {
+        if (result.status !== 'passed')
+            return;
+        if (!test.tags.includes('@tutorial'))
+            return;
+        const timelinePath = this.findTimelineByTitle(test.title);
+        if (!timelinePath) {
+            console.log(`[TutorialMerge] No timeline for "${test.title}", skipping`);
+            return;
+        }
+        try {
+            const timeline = JSON.parse(readFileSync(timelinePath, 'utf-8'));
+            const mergeCmd = timeline.mergeCommand;
+            if (!mergeCmd) {
+                console.log(`[TutorialMerge] No merge command for "${test.title}"`);
+                return;
+            }
+            const videoPath = mergeCmd.match(/-i "([^"]*\.webm)"/)?.[1];
+            if (videoPath) {
+                if (!existsSync(videoPath)) {
+                    console.log(`[TutorialMerge] Waiting for video: ${videoPath}`);
+                    for (let i = 0; i < 30; i++) {
+                        execSync('sleep 1');
+                        if (existsSync(videoPath))
+                            break;
+                    }
+                }
+                if (existsSync(videoPath)) {
+                    let prevSize = -1;
+                    for (let i = 0; i < 15; i++) {
+                        const { size } = statSync(videoPath);
+                        if (size > 0 && size === prevSize)
+                            break;
+                        prevSize = size;
+                        execSync('sleep 0.5');
+                    }
+                }
+            }
+            let finalCmd = mergeCmd;
+            if (timeline.syncMarker && videoPath && existsSync(videoPath)) {
+                const exactTrim = this.detectSyncMarker(videoPath);
+                if (exactTrim !== null) {
+                    const declared = (timeline.videoTrimMs ?? 0) / 1000;
+                    console.log(`[TutorialMerge] Sync marker at ${exactTrim.toFixed(3)}s (wall-clock trim was ${declared.toFixed(3)}s)`);
+                    const ss = `-ss ${exactTrim.toFixed(3)}`;
+                    finalCmd = /-ss [\d.]+/.test(finalCmd)
+                        ? finalCmd.replace(/-ss [\d.]+/, ss)
+                        : finalCmd.replace('ffmpeg -y', `ffmpeg -y ${ss}`);
+                }
+                else {
+                    console.log('[TutorialMerge] Sync marker not found on tape — using wall-clock trim');
+                }
+            }
+            console.log(`[TutorialMerge] Merging: ${test.title}`);
+            execSync(finalCmd, { stdio: 'inherit' });
+            console.log(`[TutorialMerge] Done: ${test.title}`);
+            this.patchTutorialsDuration(timeline);
+        }
+        catch (e) {
+            console.error(`[TutorialMerge] Failed for "${test.title}": ${e.message}`);
+        }
+    }
+    /**
+     * Find the full-screen black sync marker in the source video and return
+     * the timestamp (seconds) of its END — the exact video time of timeline
+     * zero. Returns null when no black interval is found.
+     */
+    detectSyncMarker(videoPath) {
+        try {
+            const out = execSync(`ffmpeg -hide_banner -i "${videoPath}" -vf "blackdetect=d=0.2:pic_th=0.95" -an -f null - 2>&1`, { encoding: 'utf-8', maxBuffer: 32 * 1024 * 1024 });
+            const m = out.match(/black_end:([\d.]+)/);
+            return m ? parseFloat(m[1]) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    patchTutorialsDuration(timeline) {
+        const { testName, lang, totalDurationMs } = timeline;
+        const mins = Math.floor(totalDurationMs / 60000);
+        const secs = Math.floor((totalDurationMs % 60000) / 1000);
+        const duration = `${mins}:${secs.toString().padStart(2, '0')}`;
+        if (!existsSync(this.mappingFile)) {
+            console.log(`[TutorialMerge] ${this.mappingFile} not found, skipping duration patch`);
+            return;
+        }
+        const mappingLines = readFileSync(this.mappingFile, 'utf-8').split('\n');
+        const videoId = mappingLines
+            .filter(line => !line.startsWith('#') && line.trim())
+            .map(line => line.split(':'))
+            .find(([name]) => name === testName)?.[1];
+        if (!videoId) {
+            console.log(`[TutorialMerge] No mapping for "${testName}", add to ${this.mappingFile} + ${this.tutorialsJson}`);
+            return;
+        }
+        if (!existsSync(this.tutorialsJson)) {
+            console.log(`[TutorialMerge] ${this.tutorialsJson} not found, skipping duration patch`);
+            return;
+        }
+        const tutorialsData = JSON.parse(readFileSync(this.tutorialsJson, 'utf-8'));
+        const video = (tutorialsData.videos ?? []).find((v) => v.id === videoId);
+        if (!video) {
+            console.log(`[TutorialMerge] "${videoId}" not in ${this.tutorialsJson}, add it manually`);
+            return;
+        }
+        if (typeof video.duration === 'string') {
+            video.duration = { fr: video.duration };
+        }
+        video.duration[lang] = duration;
+        if (timeline.feature) {
+            video.feature = timeline.feature;
+        }
+        const today = new Date().toISOString().slice(0, 10);
+        if (!video.uploadDate)
+            video.uploadDate = today;
+        video.dateModified = today;
+        writeFileSync(this.tutorialsJson, JSON.stringify(tutorialsData, null, 2) + '\n');
+        console.log(`[TutorialMerge] Duration[${lang}] ${duration} → ${this.tutorialsJson} (${videoId})`);
+    }
+    findTimelineByTitle(testTitle) {
+        if (!existsSync(OUTPUT_DIR))
+            return null;
+        // The same test recorded in several variants leaves one timeline per
+        // variant with the same testTitle: keep the one matching this run's
+        // TUTORIAL_VARIANT (older JSONs without the field count as no-variant),
+        // and break remaining ties by most recent mtime.
+        const runVariant = process.env.TUTORIAL_VARIANT || undefined;
+        const candidates = [];
+        for (const entry of readdirSync(OUTPUT_DIR)) {
+            if (!entry.endsWith('_timeline.json'))
+                continue;
+            const path = join(OUTPUT_DIR, entry);
+            try {
+                const data = JSON.parse(readFileSync(path, 'utf-8'));
+                if (data.testTitle !== testTitle)
+                    continue;
+                if ((data.variant || undefined) !== runVariant)
+                    continue;
+                candidates.push({ path, mtimeMs: statSync(path).mtimeMs });
+            }
+            catch {
+                // ignore malformed
+            }
+        }
+        if (candidates.length === 0)
+            return null;
+        candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        return candidates[0].path;
+    }
+}
+export default TutorialMergeReporter;
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/site/build-site.d.ts

@@ -0,0 +1,2 @@
+export declare function buildSite(configPath?: string): Promise<void>;
+//# sourceMappingURL=build-site.d.ts.map

package/dist/site/build-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-site.d.ts","sourceRoot":"","sources":["../../src/site/build-site.ts"],"names":[],"mappings":"AAiCA,wBAAsB,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,iBAkElD"}

package/dist/site/build-site.js

@@ -0,0 +1,82 @@
+import { existsSync, writeFileSync, cpSync, rmSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { pathToFileURL, fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import { createInterface } from 'readline';
+import { scanTutorials } from './scan-tutorials.js';
+import { generateManifest } from './generate-manifest.js';
+import { scaffold } from './scaffold.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DEFAULT_CONFIG = {
+    title: 'Tutorials',
+    primaryColor: '#6366f1',
+    font: 'system-ui, -apple-system, sans-serif',
+    input: 'tutorials/',
+    output: 'tutorial-site-dist/',
+    baseUrl: '/',
+    lang: 'fr'
+};
+function ask(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((res) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            res(answer.trim().toLowerCase());
+        });
+    });
+}
+export async function buildSite(configPath) {
+    const resolvedConfigPath = resolve(configPath || join(process.cwd(), 'tutorial-site.config.js'));
+    let config;
+    if (existsSync(resolvedConfigPath)) {
+        console.log(`  Using config: ${resolvedConfigPath}`);
+        const imported = await import(pathToFileURL(resolvedConfigPath).href);
+        config = { ...DEFAULT_CONFIG, ...imported.default };
+    }
+    else {
+        console.log('  No config file found. Generating tutorial-site.config.js with defaults...');
+        const configContent = `/** @type {import('playwright-director/site').SiteConfig} */
+export default ${JSON.stringify(DEFAULT_CONFIG, null, 2)};
+`;
+        writeFileSync(resolvedConfigPath, configContent);
+        console.log(`  Created ${resolvedConfigPath}`);
+        const answer = await ask('  Continue with defaults? [Y/n] ');
+        if (answer && answer !== 'y' && answer !== 'yes') {
+            console.log('  Edit the config file, then re-run build-site.');
+            return;
+        }
+        config = { ...DEFAULT_CONFIG };
+    }
+    config.input = resolve(config.input);
+    config.output = resolve(config.output);
+    console.log(`\n  Scanning ${config.input} for tutorials...`);
+    const tutorials = scanTutorials(config.input);
+    if (tutorials.length === 0) {
+        console.error('  No tutorials found. Make sure you have _timeline.json files in the output/ subdirectory and .webm files in the videos/ subdirectory.');
+        process.exit(1);
+    }
+    console.log(`  Found ${tutorials.length} tutorial(s).`);
+    const manifest = generateManifest(tutorials, config);
+    console.log(`  Generated manifest: ${manifest.videos.length} videos, ${Object.keys(manifest.categories).length} categories.`);
+    const tempDir = join(config.output, '.astro-build');
+    console.log('  Scaffolding Astro project...');
+    scaffold(config, manifest, tempDir);
+    console.log('  Building static site...');
+    try {
+        execSync('npx astro build', {
+            cwd: tempDir,
+            stdio: 'inherit',
+            env: { ...process.env, NODE_ENV: 'production' }
+        });
+    }
+    catch {
+        console.error('  Astro build failed.');
+        process.exit(1);
+    }
+    cpSync(join(tempDir, 'dist'), config.output, { recursive: true });
+    rmSync(tempDir, { recursive: true, force: true });
+    console.log(`\n  ✓ Site built to ${config.output}`);
+    console.log(`  Open ${join(config.output, 'index.html')} to preview.\n`);
+}
+//# sourceMappingURL=build-site.js.map

package/dist/site/build-site.js.map

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

package/dist/site/embed.d.ts

@@ -0,0 +1,48 @@
+import type { SiteConfig, VideoManifest, VideoManifestEntry } from './types.js';
+/** One step of a widget payload. Display numbers are precomputed
+ *  (sequential, contexts don't count) so the widget stays dumb. */
+export interface EmbedStep {
+    num?: number;
+    title?: string;
+    text?: string;
+    /** Site-relative path, e.g. "videos/demo-step-1.webp" */
+    image?: string;
+    context?: boolean;
+}
+/** Payload served at embed/<id>.json — everything the in-app widget needs
+ *  to render one tutorial. All paths are relative to the site base URL,
+ *  which the widget derives from its own script src. */
+export interface EmbedTutorial {
+    id: string;
+    title: string;
+    description?: string;
+    duration: string;
+    variant?: string;
+    lang: string;
+    /** Site primary color — the widget's default accent */
+    accent: string;
+    /** Site-relative video path ("videos/<file>") */
+    video: string;
+    /** First step screenshot, used as the video poster */
+    poster?: string;
+    /** Site-relative path of the full tutorial page ("<id>/") */
+    page: string;
+    steps: EmbedStep[];
+}
+export interface EmbedIndex {
+    tutorials: {
+        id: string;
+        title: string;
+        duration: string;
+        variant?: string;
+    }[];
+}
+export declare function buildEmbedTutorial(video: VideoManifestEntry, config: SiteConfig): EmbedTutorial;
+/** All the JSON files the widget consumes: one payload per tutorial plus a
+ *  small index (slug discovery / debugging). Paths are relative to the site
+ *  root — scaffold writes them under public/. */
+export declare function buildEmbedFiles(manifest: VideoManifest, config: SiteConfig): {
+    path: string;
+    data: EmbedTutorial | EmbedIndex;
+}[];
+//# sourceMappingURL=embed.d.ts.map

package/dist/site/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/site/embed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhF;mEACmE;AACnE,MAAM,WAAW,SAAS;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;wDAEwD;AACxD,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IAC1B,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,CA0B/F;AAED;;iDAEiD;AACjD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAA;CAAE,EAAE,CAiBjI"}

package/dist/site/embed.js

@@ -0,0 +1,45 @@
+export function buildEmbedTutorial(video, config) {
+    let counter = 0;
+    const steps = (video.stepsDetail ?? []).map((s) => ({
+        ...(s.context ? {} : { num: ++counter }),
+        ...(s.title ? { title: s.title } : {}),
+        ...(s.text ? { text: s.text } : {}),
+        ...(s.image ? { image: `videos/${s.image}` } : {}),
+        ...(s.context ? { context: true } : {})
+    }));
+    const poster = (video.stepsDetail ?? []).find((s) => s.image)?.image;
+    return {
+        id: video.id,
+        title: video.title,
+        ...(video.description ? { description: video.description } : {}),
+        duration: video.duration,
+        ...(video.variant ? { variant: video.variant } : {}),
+        // config.lang may be a comma-separated list — the first entry is the site default
+        lang: (config.lang || 'en').split(',')[0].trim(),
+        accent: config.primaryColor || '#6366f1',
+        video: `videos/${video.file}`,
+        ...(poster ? { poster: `videos/${poster}` } : {}),
+        page: `${video.id}/`,
+        steps
+    };
+}
+/** All the JSON files the widget consumes: one payload per tutorial plus a
+ *  small index (slug discovery / debugging). Paths are relative to the site
+ *  root — scaffold writes them under public/. */
+export function buildEmbedFiles(manifest, config) {
+    const files = manifest.videos.map((v) => ({
+        path: `embed/${v.id}.json`,
+        data: buildEmbedTutorial(v, config)
+    }));
+    const index = {
+        tutorials: manifest.videos.map((v) => ({
+            id: v.id,
+            title: v.title,
+            duration: v.duration,
+            ...(v.variant ? { variant: v.variant } : {})
+        }))
+    };
+    files.push({ path: 'embed/index.json', data: index });
+    return files;
+}
+//# sourceMappingURL=embed.js.map

package/dist/site/embed.js.map

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

package/dist/site/generate-manifest.d.ts

@@ -0,0 +1,15 @@
+import type { ManifestStep, SiteConfig, VideoManifest } from './types.js';
+import type { ScannedTutorial } from './scan-tutorials.js';
+/**
+ * Merge a tutorial's timeline narration with its step screenshots into the
+ * step-by-step guide shown on the video page. Leading context narrations
+ * become the page description; mid-flow contexts stay in the list as
+ * unnumbered entries; screenshots of non-voiced steps (absent from the
+ * timeline) are inserted at their step position with no text.
+ */
+export declare function buildStepsDetail(t: ScannedTutorial): {
+    description?: string;
+    stepsDetail: ManifestStep[];
+};
+export declare function generateManifest(tutorials: ScannedTutorial[], config: SiteConfig): VideoManifest;
+//# sourceMappingURL=generate-manifest.d.ts.map

package/dist/site/generate-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../src/site/generate-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAiB3D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,YAAY,EAAE,CAAA;CAAE,CAiC1G;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,CAkDhG"}

package/dist/site/generate-manifest.js

@@ -0,0 +1,106 @@
+const DEFAULT_CATEGORY_ICONS = {
+    'getting-started': '⭐',
+    premium: '💎',
+    portal: '👥',
+    accountant: '🧾',
+    payroll: '💰',
+    accounting: '📊',
+    settings: '⚙️'
+};
+function humanize(slug) {
+    const s = slug.replace(/[-_]/g, ' ').trim();
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * Merge a tutorial's timeline narration with its step screenshots into the
+ * step-by-step guide shown on the video page. Leading context narrations
+ * become the page description; mid-flow contexts stay in the list as
+ * unnumbered entries; screenshots of non-voiced steps (absent from the
+ * timeline) are inserted at their step position with no text.
+ */
+export function buildStepsDetail(t) {
+    const shotByN = new Map(t.stepScreenshots.map((s) => [s.n, s.file]));
+    const usedShots = new Set();
+    const stepsDetail = [];
+    const leadingContext = [];
+    let seenStep = false;
+    for (const s of t.timeline.steps) {
+        if (s.step === 0 && s.title === 'Context') {
+            if (!s.text)
+                continue;
+            if (seenStep)
+                stepsDetail.push({ text: s.text, context: true });
+            else
+                leadingContext.push(s.text);
+            continue;
+        }
+        if (s.title === 'Complete')
+            continue;
+        seenStep = true;
+        const image = shotByN.get(s.step);
+        if (image !== undefined)
+            usedShots.add(s.step);
+        stepsDetail.push({ n: s.step, title: s.title, ...(s.text ? { text: s.text } : {}), ...(image ? { image } : {}) });
+    }
+    for (const shot of t.stepScreenshots) {
+        if (usedShots.has(shot.n))
+            continue;
+        const at = stepsDetail.findIndex((d) => d.n !== undefined && d.n > shot.n);
+        const entry = { n: shot.n, image: shot.file };
+        if (at === -1)
+            stepsDetail.push(entry);
+        else
+            stepsDetail.splice(at, 0, entry);
+    }
+    return {
+        description: leadingContext.length > 0 ? leadingContext.join(' ') : undefined,
+        stepsDetail
+    };
+}
+export function generateManifest(tutorials, config) {
+    const detectedCategories = new Set();
+    for (const t of tutorials) {
+        detectedCategories.add(t.timeline.feature || 'general');
+    }
+    const categories = {};
+    for (const cat of detectedCategories) {
+        categories[cat] = {
+            icon: DEFAULT_CATEGORY_ICONS[cat] || '📹',
+            label: cat.charAt(0).toUpperCase() + cat.slice(1).replace(/-/g, ' ')
+        };
+    }
+    if (config.tutorials?.categories) {
+        Object.assign(categories, config.tutorials.categories);
+    }
+    const videos = tutorials.map((t) => {
+        const durationSec = Math.round(t.timeline.totalDurationMs / 1000);
+        const minutes = Math.floor(durationSec / 60);
+        const seconds = durationSec % 60;
+        const { description, stepsDetail } = buildStepsDetail(t);
+        return {
+            id: t.timeline.testName,
+            category: t.timeline.feature || 'general',
+            // Older timelines don't carry `title` (the Tutorial display title) —
+            // fall back to the Playwright test title, then the slug.
+            title: t.timeline.title || t.timeline.testTitle || humanize(t.timeline.testName),
+            duration: durationSec > 0 ? `${minutes}:${seconds.toString().padStart(2, '0')}` : '',
+            premium: false,
+            file: t.videoFile,
+            feature: t.timeline.feature,
+            variant: t.timeline.variant,
+            uploadDate: new Date().toISOString().slice(0, 10),
+            steps: t.stepScreenshots.length,
+            description,
+            stepsDetail: stepsDetail.length > 0 ? stepsDetail : undefined
+        };
+    });
+    return {
+        categories,
+        videos,
+        ui: {
+            heroTitle: config.tutorials?.ui?.heroTitle || config.title,
+            heroSubtitle: config.tutorials?.ui?.heroSubtitle || 'Video tutorials'
+        }
+    };
+}
+//# sourceMappingURL=generate-manifest.js.map

package/dist/site/generate-manifest.js.map

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

package/dist/site/scaffold.d.ts

@@ -0,0 +1,3 @@
+import type { SiteConfig, VideoManifest } from './types.js';
+export declare function scaffold(config: SiteConfig, manifest: VideoManifest, tempDir: string): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/site/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/site/scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK5D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmF7F"}