playwright-director 0.2.0

package/dist/site/scaffold.js

@@ -0,0 +1,70 @@
+import { cpSync, mkdirSync, writeFileSync, existsSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { buildEmbedFiles } from './embed.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export function scaffold(config, manifest, tempDir) {
+    const templateDir = join(__dirname, '..', '..', 'templates', 'site');
+    mkdirSync(tempDir, { recursive: true });
+    cpSync(templateDir, tempDir, { recursive: true });
+    const siteConfigData = {
+        title: config.title,
+        logo: config.logo,
+        primaryColor: config.primaryColor,
+        font: config.font,
+        baseUrl: config.baseUrl,
+        lang: config.lang,
+        stepsLayout: config.tutorials?.stepsLayout || 'text',
+        showStrip: config.tutorials?.showStrip !== false
+    };
+    if (config.logo && existsSync(config.logo)) {
+        const logoExt = config.logo.split('.').pop();
+        mkdirSync(join(tempDir, 'public'), { recursive: true });
+        cpSync(config.logo, join(tempDir, 'public', `logo.${logoExt}`));
+        siteConfigData.logo = `/logo.${logoExt}`;
+    }
+    mkdirSync(join(tempDir, 'src', 'data'), { recursive: true });
+    writeFileSync(join(tempDir, 'src', 'data', 'site-config.json'), JSON.stringify(siteConfigData, null, 2));
+    writeFileSync(join(tempDir, 'src', 'data', 'tutorials.json'), JSON.stringify(manifest, null, 2));
+    // In-app widget data: one JSON payload per tutorial + an index, served
+    // next to widget.js (template public/) so any app can embed tutorials.
+    const embedDir = join(tempDir, 'public', 'embed');
+    mkdirSync(embedDir, { recursive: true });
+    for (const file of buildEmbedFiles(manifest, config)) {
+        writeFileSync(join(tempDir, 'public', file.path), JSON.stringify(file.data, null, 2));
+    }
+    const videosDir = join(resolve(config.input), 'videos');
+    const publicVideos = join(tempDir, 'public', 'videos');
+    if (existsSync(videosDir)) {
+        mkdirSync(publicVideos, { recursive: true });
+        cpSync(videosDir, publicVideos, { recursive: true });
+    }
+    let siteDirective = '';
+    let baseDirective = '';
+    if (config.baseUrl && config.baseUrl.startsWith('http')) {
+        siteDirective = `site: ${JSON.stringify(config.baseUrl)},`;
+        try {
+            const basePath = new URL(config.baseUrl).pathname;
+            if (basePath && basePath !== '/') {
+                baseDirective = `base: ${JSON.stringify(basePath)},`;
+            }
+        }
+        catch { /* invalid URL, skip */ }
+    }
+    const astroConfig = `import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  srcDir: './src',
+  publicDir: './public',
+  outDir: './dist',
+  ${siteDirective}
+  ${baseDirective}
+  build: { assets: 'assets' },
+});
+`;
+    writeFileSync(join(tempDir, 'astro.config.mjs'), astroConfig);
+    writeFileSync(join(tempDir, 'package.json'), JSON.stringify({ name: 'tutorial-site-build', type: 'module', private: true }, null, 2));
+    return tempDir;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/site/scaffold.js.map

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

package/dist/site/scan-tutorials.d.ts

@@ -0,0 +1,12 @@
+import type { TimelineData } from '../timeline.js';
+export interface ScannedTutorial {
+    timeline: TimelineData;
+    videoFile: string;
+    /** Screenshot filenames with their step number, sorted by step number */
+    stepScreenshots: {
+        n: number;
+        file: string;
+    }[];
+}
+export declare function scanTutorials(inputDir: string): ScannedTutorial[];
+//# sourceMappingURL=scan-tutorials.d.ts.map

package/dist/site/scan-tutorials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-tutorials.d.ts","sourceRoot":"","sources":["../../src/site/scan-tutorials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,eAAe,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAqDjE"}

package/dist/site/scan-tutorials.js

@@ -0,0 +1,54 @@
+import { readdirSync, readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+export function scanTutorials(inputDir) {
+    const outputDir = join(inputDir, 'output');
+    const videosDir = join(inputDir, 'videos');
+    const results = [];
+    if (!existsSync(videosDir))
+        return results;
+    const videoFiles = readdirSync(videosDir).filter((f) => f.endsWith('.webm'));
+    const allVideoDirFiles = readdirSync(videosDir);
+    // Index timelines by testName
+    const timelinesByName = new Map();
+    if (existsSync(outputDir)) {
+        for (const tf of readdirSync(outputDir).filter((f) => f.endsWith('_timeline.json'))) {
+            const timeline = JSON.parse(readFileSync(join(outputDir, tf), 'utf-8'));
+            timelinesByName.set(timeline.testName, timeline);
+        }
+    }
+    for (const videoFileName of videoFiles) {
+        const baseName = videoFileName.replace(/\.webm$/, '');
+        const timeline = timelinesByName.get(baseName);
+        const stepPattern = new RegExp(`^${escapeRegex(baseName)}-step-(\\d+)\\.(png|jpe?g|webp|avif)$`);
+        const steps = [];
+        for (const file of allVideoDirFiles) {
+            const m = file.match(stepPattern);
+            if (m)
+                steps.push({ n: parseInt(m[1], 10), file });
+        }
+        const syntheticTimeline = timeline ?? {
+            testName: baseName,
+            testTitle: baseName,
+            testFile: '',
+            projectName: '',
+            lang: 'fr',
+            totalDurationMs: 0,
+            videoTrimMs: 0,
+            steps: [],
+            videoPath: '',
+            mergeCommand: '',
+            // No timeline to read the variant from — recognize the common suffixes.
+            variant: baseName.match(/-(mobile|tablet)$/)?.[1]
+        };
+        results.push({
+            timeline: syntheticTimeline,
+            videoFile: videoFileName,
+            stepScreenshots: steps.sort((a, b) => a.n - b.n)
+        });
+    }
+    return results;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=scan-tutorials.js.map

package/dist/site/scan-tutorials.js.map

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

package/dist/site/types.d.ts

@@ -0,0 +1,75 @@
+export interface SiteConfig {
+    title: string;
+    logo?: string;
+    primaryColor: string;
+    font: string;
+    input: string;
+    output: string;
+    baseUrl: string;
+    /** Single lang or comma-separated list, e.g. "fr,en,ar" */
+    lang: string;
+    tutorials?: {
+        categories?: Record<string, {
+            icon: string;
+            label: string;
+        }>;
+        ui?: {
+            heroTitle?: string;
+            heroSubtitle?: string;
+        };
+        /** Video page step guide layout:
+         *  - 'text':  text-only cards, click to reveal the screenshot (default)
+         *  - 'cards': numbered text cards with a small screenshot, click to enlarge
+         *  - 'full':  full-width screenshot under each step's text
+         *  - 'none':  no step guide */
+        stepsLayout?: 'text' | 'cards' | 'full' | 'none';
+        /** Horizontal thumbnail strip under the video info (default true).
+         *  Independent of stepsLayout; clicking a thumbnail opens the screenshot
+         *  with its step's title + text. */
+        showStrip?: boolean;
+    };
+}
+/** One entry of a video page's step-by-step guide, built from the timeline
+ *  narration merged with the step screenshots. */
+export interface ManifestStep {
+    /** Timeline step number; absent for mid-flow context narrations */
+    n?: number;
+    title?: string;
+    /** Narration text spoken during this step */
+    text?: string;
+    /** Screenshot filename relative to videos/ */
+    image?: string;
+    /** True for a context narration shown between steps (no number, no image) */
+    context?: boolean;
+}
+export interface VideoManifestEntry {
+    id: string;
+    category: string;
+    title: string;
+    duration: string;
+    premium: boolean;
+    /** Filename relative to videos/ */
+    file: string;
+    feature?: string;
+    /** Recording variant (e.g. 'mobile'); absent = regular/desktop */
+    variant?: string;
+    uploadDate: string;
+    dateModified?: string;
+    steps: number;
+    /** Intro narration (leading context steps), shown under the video title */
+    description?: string;
+    /** Step-by-step guide rendered on the video page */
+    stepsDetail?: ManifestStep[];
+}
+export interface VideoManifest {
+    categories: Record<string, {
+        icon: string;
+        label: string;
+    }>;
+    videos: VideoManifestEntry[];
+    ui: {
+        heroTitle: string;
+        heroSubtitle: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/site/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE;QACX,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7D,EAAE,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnD;;;;uCAI+B;QAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;QACjD;;4CAEoC;QACpC,SAAS,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACF;AAED;kDACkD;AAClD,MAAM,WAAW,YAAY;IAC5B,mEAAmE;IACnE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD"}

package/dist/site/types.js

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

package/dist/site/types.js.map

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

package/dist/skill-stamp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The skill and agent are copied into a project's `.claude/` directory, so they
+ * are snapshots — a package upgrade cannot reach them. This stamp records which
+ * version produced each copy, which is what makes staleness detectable instead
+ * of silent.
+ */
+export interface SkillStamp {
+    skill?: string;
+    agent?: string;
+}
+export declare const STAMP_FILE = ".playwright-director.json";
+export declare function stampPath(claudeDir: string): string;
+export declare function readStamp(claudeDir: string): SkillStamp;
+export declare function writeStamp(claudeDir: string, stamp: SkillStamp): void;
+export declare function packageVersion(packageRoot: string): string;
+/** What `init` would bring up to date, given what is on disk. */
+export declare function outdated(claudeDir: string, version: string, installed: {
+    skill: boolean;
+    agent: boolean;
+}): string[];
+//# sourceMappingURL=skill-stamp.d.ts.map

package/dist/skill-stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-stamp.d.ts","sourceRoot":"","sources":["../src/skill-stamp.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,UAAU,8BAA8B,CAAC;AAEtD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAQvD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAErE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3C,MAAM,EAAE,CAMV"}

package/dist/skill-stamp.js

@@ -0,0 +1,39 @@
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+export const STAMP_FILE = '.playwright-director.json';
+export function stampPath(claudeDir) {
+    return join(claudeDir, STAMP_FILE);
+}
+export function readStamp(claudeDir) {
+    const path = stampPath(claudeDir);
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeStamp(claudeDir, stamp) {
+    writeFileSync(stampPath(claudeDir), `${JSON.stringify(stamp, null, 2)}\n`);
+}
+export function packageVersion(packageRoot) {
+    try {
+        return JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf-8')).version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/** What `init` would bring up to date, given what is on disk. */
+export function outdated(claudeDir, version, installed) {
+    const stamp = readStamp(claudeDir);
+    const stale = [];
+    if (installed.skill && stamp.skill !== version)
+        stale.push('skill');
+    if (installed.agent && stamp.agent !== version)
+        stale.push('agent');
+    return stale;
+}
+//# sourceMappingURL=skill-stamp.js.map

package/dist/skill-stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-stamp.js","sourceRoot":"","sources":["../src/skill-stamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAa5B,MAAM,CAAC,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAEtD,MAAM,UAAU,SAAS,CAAC,SAAiB;IAC1C,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAe,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,KAAiB;IAC9D,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IACjD,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC;IAChB,CAAC;AACF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CACvB,SAAiB,EACjB,OAAe,EACf,SAA6C;IAE7C,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,SAAS,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/slugify.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Build an SEO-friendly filename slug from a human-readable string.
+ *
+ * - NFD-normalize then drop every Unicode combining mark — this strips Latin
+ *   diacritics (é→e) AND the hamza marks that NFD splits off Arabic letters
+ *   (إ → ا + U+0655 → ا). Without the Arabic pass, titles like
+ *   "إنشاء أول فاتورة" would emit stray dashes where the marks were.
+ * - Lowercase (no-op on Arabic).
+ * - Any run of non-letter/non-number → single dash.
+ * - Leading / trailing dashes trimmed; consecutive dashes collapsed.
+ *
+ * Examples:
+ *   "Créer votre première facture"  → "creer-votre-premiere-facture"
+ *   "Set Up Your Company"           → "set-up-your-company"
+ *   "إنشاء أول فاتورة"              → "انشاء-اول-فاتورة"
+ *   "S'abonner avec BaridPay"       → "s-abonner-avec-baridpay"
+ */
+export declare function slugify(input: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../src/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7C"}

package/dist/slugify.js

@@ -0,0 +1,29 @@
+/**
+ * Build an SEO-friendly filename slug from a human-readable string.
+ *
+ * - NFD-normalize then drop every Unicode combining mark — this strips Latin
+ *   diacritics (é→e) AND the hamza marks that NFD splits off Arabic letters
+ *   (إ → ا + U+0655 → ا). Without the Arabic pass, titles like
+ *   "إنشاء أول فاتورة" would emit stray dashes where the marks were.
+ * - Lowercase (no-op on Arabic).
+ * - Any run of non-letter/non-number → single dash.
+ * - Leading / trailing dashes trimmed; consecutive dashes collapsed.
+ *
+ * Examples:
+ *   "Créer votre première facture"  → "creer-votre-premiere-facture"
+ *   "Set Up Your Company"           → "set-up-your-company"
+ *   "إنشاء أول فاتورة"              → "انشاء-اول-فاتورة"
+ *   "S'abonner avec BaridPay"       → "s-abonner-avec-baridpay"
+ */
+export function slugify(input) {
+    if (!input)
+        return '';
+    return input
+        .normalize('NFD')
+        .replace(/\p{M}+/gu, '') // strip ALL combining marks (Latin + Arabic hamza marks)
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, '-') // any non-letter/number → dash
+        .replace(/-{2,}/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=slugify.js.map

package/dist/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../src/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK;SACV,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,yDAAyD;SACjF,WAAW,EAAE;SACb,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,+BAA+B;SAChE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/stage-presets.d.ts

@@ -0,0 +1,51 @@
+export interface MobileStageOptions {
+    /** Video oversampling factor (default 2). Playwright records video at *window*
+     *  pixels and never upscales, so a phone-sized viewport yields a blurry ~400px-wide
+     *  video. The scale is applied as `--force-device-scale-factor` + matching
+     *  `deviceScaleFactor`, and the video size is multiplied accordingly — the page
+     *  layout (CSS viewport) is unchanged. Set to 1 to record at native CSS pixels. */
+    scale?: number;
+    /** Extra Chromium args. `test.use()` REPLACES the config's `launchOptions`
+     *  wholesale, so any arg your playwright.config sets for tutorial runs
+     *  (e.g. `--autoplay-policy=no-user-gesture-required`) must be repeated here. */
+    launchArgs?: string[];
+}
+/**
+ * Playwright `test.use()` options for recording the mobile variant of a
+ * tutorial: N phone-sized panes side by side. Inert unless
+ * `TUTORIAL_VARIANT=mobile`, so the same spec records desktop and mobile.
+ *
+ * Must be passed to `test.use()` at the top of the spec — the video size is
+ * frozen when the browser context is created, a later `setViewportSize`
+ * would not resize the recording.
+ *
+ * The viewport is widened to N phones; in tutorial mode the video is recorded
+ * oversampled (see {@link MobileStageOptions.scale}) for a sharp result. Other
+ * device traits (userAgent, isMobile…) stay whatever the consuming
+ * playwright.config sets.
+ *
+ * @param scenes number of phones side by side (1 for a single-scene tutorial)
+ * @param device a Playwright device name (default 'Pixel 7') or an explicit viewport
+ * @param options scale / extra launch args, see {@link MobileStageOptions}
+ */
+export declare function mobileStage(scenes?: number, device?: string | {
+    width: number;
+    height: number;
+}, options?: MobileStageOptions): {
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    deviceScaleFactor?: number;
+    video?: {
+        mode: 'on';
+        size: {
+            width: number;
+            height: number;
+        };
+    };
+    launchOptions?: {
+        args: string[];
+    };
+};
+//# sourceMappingURL=stage-presets.d.ts.map

package/dist/stage-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-presets.d.ts","sourceRoot":"","sources":["../src/stage-presets.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAClC;;;;uFAImF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;qFAEiF;IACjF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAC1B,MAAM,SAAI,EACV,MAAM,GAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAc,EAC9D,OAAO,GAAE,kBAAuB,GAC9B;IACF,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAChE,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACnC,CAwBA"}

package/dist/stage-presets.js

@@ -0,0 +1,45 @@
+import { devices } from '@playwright/test';
+/**
+ * Playwright `test.use()` options for recording the mobile variant of a
+ * tutorial: N phone-sized panes side by side. Inert unless
+ * `TUTORIAL_VARIANT=mobile`, so the same spec records desktop and mobile.
+ *
+ * Must be passed to `test.use()` at the top of the spec — the video size is
+ * frozen when the browser context is created, a later `setViewportSize`
+ * would not resize the recording.
+ *
+ * The viewport is widened to N phones; in tutorial mode the video is recorded
+ * oversampled (see {@link MobileStageOptions.scale}) for a sharp result. Other
+ * device traits (userAgent, isMobile…) stay whatever the consuming
+ * playwright.config sets.
+ *
+ * @param scenes number of phones side by side (1 for a single-scene tutorial)
+ * @param device a Playwright device name (default 'Pixel 7') or an explicit viewport
+ * @param options scale / extra launch args, see {@link MobileStageOptions}
+ */
+export function mobileStage(scenes = 1, device = 'Pixel 7', options = {}) {
+    if (process.env.TUTORIAL_VARIANT !== 'mobile')
+        return {};
+    const base = typeof device === 'string' ? devices[device]?.viewport : device;
+    if (!base)
+        throw new Error(`[Tutorial] Unknown Playwright device "${device}"`);
+    const scale = options.scale ?? 2;
+    const viewport = { width: base.width * scenes, height: base.height };
+    if (process.env.TUTORIAL_MODE !== 'true')
+        return { viewport };
+    return {
+        viewport,
+        // The window must actually render at `scale`× — Playwright pastes frames onto
+        // the video canvas without upscaling (gray padding otherwise). The emulated
+        // deviceScaleFactor is aligned with the window's so screenshots match.
+        deviceScaleFactor: scale,
+        launchOptions: {
+            args: [`--force-device-scale-factor=${scale}`, ...(options.launchArgs ?? [])]
+        },
+        video: {
+            mode: 'on',
+            size: { width: viewport.width * scale, height: viewport.height * scale }
+        }
+    };
+}
+//# sourceMappingURL=stage-presets.js.map

package/dist/stage-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-presets.js","sourceRoot":"","sources":["../src/stage-presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAe3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAC1B,MAAM,GAAG,CAAC,EACV,SAAqD,SAAS,EAC9D,UAA8B,EAAE;IAOhC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzD,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7E,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,GAAG,CAAC,CAAC;IAE/E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAE9D,OAAO;QACN,QAAQ;QACR,8EAA8E;QAC9E,4EAA4E;QAC5E,uEAAuE;QACvE,iBAAiB,EAAE,KAAK;QACxB,aAAa,EAAE;YACd,IAAI,EAAE,CAAC,+BAA+B,KAAK,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;SAC7E;QACD,KAAK,EAAE;YACN,IAAI,EAAE,IAAa;YACnB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE;SACxE;KACD,CAAC;AACH,CAAC"}