npm - screenci - Versions diffs - 0.0.68 → 0.0.70 - Mend

screenci 0.0.68 → 0.0.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (161) hide show

package/README.md +45 -122
package/dist/cli.d.ts +3 -18
package/dist/cli.d.ts.map +1 -1
package/dist/cli.js +117 -158
package/dist/cli.js.map +1 -1
package/dist/docs/manifest.d.ts +66 -35
package/dist/docs/manifest.d.ts.map +1 -1
package/dist/docs/manifest.js +22 -11
package/dist/docs/manifest.js.map +1 -1
package/dist/docs/video-sources/cli.screenci.d.ts +2 -0
package/dist/docs/video-sources/cli.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/{cli.video.js → cli.screenci.js} +1 -1
package/dist/docs/video-sources/cli.screenci.js.map +1 -0
package/dist/docs/video-sources/installation.screenci.d.ts +2 -0
package/dist/docs/video-sources/installation.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/{installation.video.js → installation.screenci.js} +1 -1
package/dist/docs/video-sources/installation.screenci.js.map +1 -0
package/dist/docs/video-sources/landing.screenci.d.ts +2 -0
package/dist/docs/video-sources/landing.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/{landing.video.js → landing.screenci.js} +1 -1
package/dist/docs/video-sources/landing.screenci.js.map +1 -0
package/dist/docs/video-sources/locator-highlight-animated.screenci.d.ts +2 -0
package/dist/docs/video-sources/locator-highlight-animated.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/locator-highlight-animated.screenci.js +53 -0
package/dist/docs/video-sources/locator-highlight-animated.screenci.js.map +1 -0
package/dist/docs/video-sources/locator-highlight-still.screenci.d.ts +2 -0
package/dist/docs/video-sources/locator-highlight-still.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/locator-highlight-still.screenci.js +24 -0
package/dist/docs/video-sources/locator-highlight-still.screenci.js.map +1 -0
package/dist/docs/video-sources/product-pitch.screenci.d.ts +2 -0
package/dist/docs/video-sources/product-pitch.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/product-pitch.screenci.js +136 -0
package/dist/docs/video-sources/product-pitch.screenci.js.map +1 -0
package/dist/docs/video-sources/public-urls.screenci.d.ts +2 -0
package/dist/docs/video-sources/public-urls.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/public-urls.screenci.js +34 -0
package/dist/docs/video-sources/public-urls.screenci.js.map +1 -0
package/dist/docs/video-sources/studio.screenci.d.ts +2 -0
package/dist/docs/video-sources/studio.screenci.d.ts.map +1 -0
package/dist/docs/video-sources/studio.screenci.js +57 -0
package/dist/docs/video-sources/studio.screenci.js.map +1 -0
package/dist/docs/videos.d.ts +36 -15
package/dist/docs/videos.d.ts.map +1 -1
package/dist/docs/videos.js +27 -2
package/dist/docs/videos.js.map +1 -1
package/dist/e2e/htmlRasterizer.e2e.d.ts +2 -0
package/dist/e2e/htmlRasterizer.e2e.d.ts.map +1 -0
package/dist/e2e/htmlRasterizer.e2e.js +107 -0
package/dist/e2e/htmlRasterizer.e2e.js.map +1 -0
package/dist/e2e/screenshot.e2e.d.ts +2 -0
package/dist/e2e/screenshot.e2e.d.ts.map +1 -0
package/dist/e2e/screenshot.e2e.js +73 -0
package/dist/e2e/screenshot.e2e.js.map +1 -0
package/dist/index.d.ts +10 -4
package/dist/index.d.ts.map +1 -1
package/dist/index.js +5 -2
package/dist/index.js.map +1 -1
package/dist/src/asset.d.ts +245 -53
package/dist/src/asset.d.ts.map +1 -1
package/dist/src/asset.js +718 -77
package/dist/src/asset.js.map +1 -1
package/dist/src/audio.d.ts +127 -0
package/dist/src/audio.d.ts.map +1 -0
package/dist/src/audio.js +207 -0
package/dist/src/audio.js.map +1 -0
package/dist/src/config.d.ts.map +1 -1
package/dist/src/config.js +9 -3
package/dist/src/config.js.map +1 -1
package/dist/src/contextOptions.d.ts +48 -0
package/dist/src/contextOptions.d.ts.map +1 -0
package/dist/src/contextOptions.js +71 -0
package/dist/src/contextOptions.js.map +1 -0
package/dist/src/crop.d.ts +93 -0
package/dist/src/crop.d.ts.map +1 -0
package/dist/src/crop.js +133 -0
package/dist/src/crop.js.map +1 -0
package/dist/src/cue.d.ts +17 -4
package/dist/src/cue.d.ts.map +1 -1
package/dist/src/cue.js +31 -3
package/dist/src/cue.js.map +1 -1
package/dist/src/defaults.d.ts +13 -1
package/dist/src/defaults.d.ts.map +1 -1
package/dist/src/defaults.js +13 -0
package/dist/src/defaults.js.map +1 -1
package/dist/src/dimensions.d.ts +6 -0
package/dist/src/dimensions.d.ts.map +1 -1
package/dist/src/dimensions.js +15 -0
package/dist/src/dimensions.js.map +1 -1
package/dist/src/events.d.ts +283 -13
package/dist/src/events.d.ts.map +1 -1
package/dist/src/events.js +134 -5
package/dist/src/events.js.map +1 -1
package/dist/src/htmlRasterizer.d.ts +153 -0
package/dist/src/htmlRasterizer.d.ts.map +1 -0
package/dist/src/htmlRasterizer.js +386 -0
package/dist/src/htmlRasterizer.js.map +1 -0
package/dist/src/init.d.ts +17 -0
package/dist/src/init.d.ts.map +1 -1
package/dist/src/init.js +131 -11
package/dist/src/init.js.map +1 -1
package/dist/src/linkSession.d.ts +36 -0
package/dist/src/linkSession.d.ts.map +1 -0
package/dist/src/linkSession.js +122 -0
package/dist/src/linkSession.js.map +1 -0
package/dist/src/overlayFlush.d.ts +18 -0
package/dist/src/overlayFlush.d.ts.map +1 -0
package/dist/src/overlayFlush.js +56 -0
package/dist/src/overlayFlush.js.map +1 -0
package/dist/src/overlayRect.d.ts +69 -0
package/dist/src/overlayRect.d.ts.map +1 -0
package/dist/src/overlayRect.js +55 -0
package/dist/src/overlayRect.js.map +1 -0
package/dist/src/performance.d.ts +1 -3
package/dist/src/performance.d.ts.map +1 -1
package/dist/src/performance.js +0 -12
package/dist/src/performance.js.map +1 -1
package/dist/src/recording.d.ts +3 -2
package/dist/src/recording.d.ts.map +1 -1
package/dist/src/recordingData.d.ts +22 -2
package/dist/src/recordingData.d.ts.map +1 -1
package/dist/src/runtimeContext.d.ts +57 -1
package/dist/src/runtimeContext.d.ts.map +1 -1
package/dist/src/runtimeContext.js +40 -0
package/dist/src/runtimeContext.js.map +1 -1
package/dist/src/screenshot.d.ts +105 -0
package/dist/src/screenshot.d.ts.map +1 -0
package/dist/src/screenshot.js +188 -0
package/dist/src/screenshot.js.map +1 -0
package/dist/src/stillCapture.d.ts +68 -0
package/dist/src/stillCapture.d.ts.map +1 -0
package/dist/src/stillCapture.js +119 -0
package/dist/src/stillCapture.js.map +1 -0
package/dist/src/studio.d.ts +8 -11
package/dist/src/studio.d.ts.map +1 -1
package/dist/src/studio.js +2 -25
package/dist/src/studio.js.map +1 -1
package/dist/src/types.d.ts +125 -15
package/dist/src/types.d.ts.map +1 -1
package/dist/src/types.js.map +1 -1
package/dist/src/video.d.ts +54 -1
package/dist/src/video.d.ts.map +1 -1
package/dist/src/video.js +190 -42
package/dist/src/video.js.map +1 -1
package/dist/src/voices.d.ts +22 -9
package/dist/src/voices.d.ts.map +1 -1
package/dist/src/voices.js +6 -24
package/dist/src/voices.js.map +1 -1
package/dist/tsconfig.tsbuildinfo +1 -1
package/package.json +16 -2
package/skills/screenci/SKILL.md +37 -15
package/skills/screenci/references/init.md +3 -1
package/skills/screenci/references/record.md +8 -3
package/dist/docs/video-sources/cli.video.d.ts +0 -2
package/dist/docs/video-sources/cli.video.d.ts.map +0 -1
package/dist/docs/video-sources/cli.video.js.map +0 -1
package/dist/docs/video-sources/installation.video.d.ts +0 -2
package/dist/docs/video-sources/installation.video.d.ts.map +0 -1
package/dist/docs/video-sources/installation.video.js.map +0 -1
package/dist/docs/video-sources/landing.video.d.ts +0 -2
package/dist/docs/video-sources/landing.video.d.ts.map +0 -1
package/dist/docs/video-sources/landing.video.js.map +0 -1

package/dist/src/htmlRasterizer.js ADDED Viewed

@@ -0,0 +1,386 @@
+import { spawn } from 'child_process';
+import { createHash } from 'crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { mkdtemp, readFile, rm, writeFile } from 'fs/promises';
+import { tmpdir } from 'os';
+import { dirname, join } from 'path';
+import ffmpegStatic from 'ffmpeg-static';
+import { getRuntimePage, getRuntimeRecordingDir } from './runtimeContext.js';
+const ffmpegPath = ffmpegStatic;
+const OVERLAY_ROOT_ID = 'screenci-overlay-root';
+// Render overlays at 2x pixel density so the PNG carries more detail than the
+// on-screen overlay size. The renderer then downscales it to the placement box,
+// which keeps text and edges crisp. 2x keeps overlays sharp at typical sizes
+// while roughly quartering the byte cost of the previous 4x density. Overlay
+// content is bounded by the off-screen page viewport, so the screenshot stays
+// well under GPU texture limits.
+export const DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR = 2;
+// Bump when anything that affects rasterized output changes (the HTML wrapper,
+// screenshot options, default density) so stale cache entries are invalidated.
+const RASTERIZE_CACHE_VERSION = 2;
+let rasterizer = playwrightHtmlRasterizer;
+// Cache only the real (browser) rasterizer. Injected rasterizers are used by
+// tests, where caching across a shared tmp dir would leak between cases.
+let cacheEnabled = true;
+export function setHtmlRasterizer(fn) {
+    rasterizer = fn;
+    cacheEnabled = false;
+}
+/** Test hook: re-enable caching after injecting a (counting) rasterizer. */
+export function setOverlayCacheEnabled(enabled) {
+    cacheEnabled = enabled;
+}
+// CSS injected into every overlay document, on top of the minimal reset. Set it
+// once (e.g. to your compiled Tailwind stylesheet) so overlays can be styled
+// with `className`. Per-overlay `css` is merged on top of this.
+let defaultOverlayCss = '';
+/**
+ * Sets CSS injected into every HTML/React overlay document. Pass a compiled
+ * stylesheet (for example Tailwind's output) so overlays can use `className`.
+ * Per-overlay `css` is appended after this.
+ */
+export function setOverlayCss(css) {
+    defaultOverlayCss = css;
+}
+/** Merges the global default overlay CSS with a per-overlay override. */
+export function resolveOverlayCss(css) {
+    return [defaultOverlayCss, css]
+        .filter((part) => part !== undefined && part.length > 0)
+        .join('\n');
+}
+/**
+ * Content hash that uniquely identifies a rasterized overlay's output. The
+ * single source of truth for both the on-disk cache key and the in-run dedupe
+ * key, so the two can never drift apart.
+ */
+export function overlayInputHash(input) {
+    const body = input.kind === 'image'
+        ? `${RASTERIZE_CACHE_VERSION} ${input.deviceScaleFactor} ${input.capturePadding} ${input.css} ${input.html}`
+        : `${RASTERIZE_CACHE_VERSION} anim ${input.deviceScaleFactor} ${input.capturePadding} ${input.fps} ${input.durationMs} ${input.css} ${input.html}`;
+    return createHash('sha256').update(body).digest('hex');
+}
+function wrapOverlayHtml(html, options = {}) {
+    const { css, capturePadding } = options;
+    // capturePadding is transparent padding on the root, so the captured box (the
+    // element/clip bounding box) grows by it on every side. Animations can then
+    // translate/scale/rotate within that margin without being clipped, replacing
+    // the manual "stage" wrapper.
+    const padding = capturePadding !== undefined && capturePadding > 0
+        ? `;padding:${capturePadding}px`
+        : '';
+    const userStyle = css !== undefined && css.length > 0 ? `<style>${css}</style>` : '';
+    return ('<!doctype html><html><head><meta charset="utf-8"><style>' +
+        'html,body{margin:0;padding:0;background:transparent}' +
+        `#${OVERLAY_ROOT_ID}{display:inline-block${padding}}` +
+        `</style>${userStyle}</head><body><div id="${OVERLAY_ROOT_ID}">${html}</div></body></html>`);
+}
+async function playwrightHtmlRasterizer(request) {
+    const page = getRuntimePage();
+    if (page === null) {
+        throw new Error('[screenci] Cannot rasterize an HTML overlay without an active recording page.');
+    }
+    const browser = page.context().browser();
+    if (browser === null) {
+        throw new Error('[screenci] Cannot rasterize an HTML overlay: the browser is not available.');
+    }
+    // A dedicated context with no video recording so the overlay render never
+    // leaks into the recording page or its captured video.
+    const overlayContext = await browser.newContext({
+        deviceScaleFactor: request.deviceScaleFactor ?? DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR,
+    });
+    try {
+        const overlayPage = await overlayContext.newPage();
+        await overlayPage.setContent(wrapOverlayHtml(request.html, {
+            ...(request.css !== undefined && { css: request.css }),
+            ...(request.capturePadding !== undefined && {
+                capturePadding: request.capturePadding,
+            }),
+        }), { waitUntil: 'load' });
+        const root = overlayPage.locator(`#${OVERLAY_ROOT_ID}`);
+        const box = await root.boundingBox();
+        const buffer = await root.screenshot({ omitBackground: true, type: 'png' });
+        return {
+            buffer,
+            width: box ? Math.round(box.width) : 0,
+            height: box ? Math.round(box.height) : 0,
+        };
+    }
+    finally {
+        await overlayContext.close().catch(() => { });
+    }
+}
+function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+/**
+ * Renders the overlay, reusing a cached PNG when the same input (markup +
+ * density) was already rendered in a previous run. The per-recording directory
+ * is wiped each run, so the cache lives one level up (`.screenci/.overlay-cache`)
+ * and survives across runs. Rendering an overlay launches a browser context, so
+ * skipping unchanged ones speeds up the author loop noticeably.
+ */
+async function renderOverlay(recordingDir, deviceScaleFactor, html, css, capturePadding) {
+    const request = {
+        html,
+        deviceScaleFactor,
+        ...(css.length > 0 && { css }),
+        ...(capturePadding > 0 && { capturePadding }),
+    };
+    if (!cacheEnabled) {
+        return rasterizer(request);
+    }
+    const inputHash = overlayInputHash({
+        kind: 'image',
+        deviceScaleFactor,
+        capturePadding,
+        css,
+        html,
+    });
+    const cacheDir = join(dirname(recordingDir), '.overlay-cache');
+    const pngPath = join(cacheDir, `${inputHash}.png`);
+    const metaPath = join(cacheDir, `${inputHash}.json`);
+    if (existsSync(pngPath) && existsSync(metaPath)) {
+        const { width, height } = JSON.parse(readFileSync(metaPath, 'utf-8'));
+        return { buffer: readFileSync(pngPath), width, height };
+    }
+    const result = await rasterizer(request);
+    mkdirSync(cacheDir, { recursive: true });
+    writeFileSync(pngPath, result.buffer);
+    writeFileSync(metaPath, JSON.stringify({ width: result.width, height: result.height }));
+    return result;
+}
+/**
+ * Rasterizes overlay HTML to a transparent PNG written into the per-recording
+ * directory so the upload step picks it up alongside the recording. Returns the
+ * path, content hash, and intrinsic pixel size. Unchanged overlays are served
+ * from a cross-run cache instead of re-rendering.
+ */
+export async function rasterizeHtmlOverlay(opts) {
+    const recordingDir = getRuntimeRecordingDir();
+    if (recordingDir === null) {
+        throw new Error('[screenci] Cannot write a generated overlay: no active recording directory.');
+    }
+    const deviceScaleFactor = opts.deviceScaleFactor ?? DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR;
+    const css = opts.cssResolved === true ? (opts.css ?? '') : resolveOverlayCss(opts.css);
+    const { buffer, width, height } = await renderOverlay(recordingDir, deviceScaleFactor, opts.html, css, opts.capturePadding ?? 0);
+    const fileHash = createHash('sha256').update(buffer).digest('hex');
+    const dir = join(recordingDir, 'generated');
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${sanitizeName(opts.name)}-${fileHash.slice(0, 16)}.png`);
+    writeFileSync(path, buffer);
+    return { path, fileHash, width, height };
+}
+// ─── Animated overlays ────────────────────────────────────────────────────────
+export const DEFAULT_ANIMATION_FPS = 30;
+/**
+ * Number of frames captured for an animation of `durationMs` at `fps`. At least
+ * one frame so a zero-length capture still produces a valid clip. Pure so the
+ * sampling math can be unit-tested without a browser.
+ */
+export function framesForDuration(durationMs, fps) {
+    if (!Number.isFinite(durationMs) || durationMs < 0) {
+        throw new Error(`[screenci] Animated overlay durationMs must be a finite number >= 0. Received: ${String(durationMs)}`);
+    }
+    if (!Number.isFinite(fps) || fps <= 0) {
+        throw new Error(`[screenci] Animated overlay fps must be a finite number > 0. Received: ${String(fps)}`);
+    }
+    return Math.max(1, Math.round(durationMs / (1000 / fps)));
+}
+let animatedRasterizer = playwrightAnimatedHtmlRasterizer;
+export function setAnimatedHtmlRasterizer(fn) {
+    animatedRasterizer = fn;
+    cacheEnabled = false;
+}
+// Single ffmpeg graph that turns the RGBA PNG sequence into one MP4 carrying two
+// NVDEC-decodable H.264 streams: stream 0 is the opaque color, stream 1 is the
+// alpha matte (its luma IS the alpha plane). Dimensions are padded to even so
+// yuv420p is valid. The matte is converted full-range then tagged tv (a
+// metadata-only label) so the renderer's CUDA graph never range-converts it and
+// the alpha reaches full opacity — the same recipe NarrationRenderer uses for
+// its shape mask (a limited-range matte caps opacity at ~92%).
+const ANIMATION_FILTER_COMPLEX = '[0:v]pad=ceil(iw/2)*2:ceil(ih/2)*2:0:0:color=black@0,split=2[a][b];' +
+    '[a]format=yuv420p[col];' +
+    '[b]alphaextract,scale=in_range=full:out_range=full,format=yuv420p,setparams=range=tv[alp]';
+async function captureAnimationFrames(request) {
+    const page = getRuntimePage();
+    if (page === null) {
+        throw new Error('[screenci] Cannot rasterize an animated overlay without an active recording page.');
+    }
+    const browser = page.context().browser();
+    if (browser === null) {
+        throw new Error('[screenci] Cannot rasterize an animated overlay: the browser is not available.');
+    }
+    const overlayContext = await browser.newContext({
+        deviceScaleFactor: request.deviceScaleFactor ?? DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR,
+    });
+    try {
+        const overlayPage = await overlayContext.newPage();
+        // Install a virtual clock at t=0 before loading so the animation starts from
+        // its first frame; advancing the clock deterministically samples each frame.
+        await overlayPage.clock.install({ time: 0 });
+        await overlayPage.setContent(wrapOverlayHtml(request.html, {
+            ...(request.css !== undefined && { css: request.css }),
+            ...(request.capturePadding !== undefined && {
+                capturePadding: request.capturePadding,
+            }),
+        }), { waitUntil: 'load' });
+        const root = overlayPage.locator(`#${OVERLAY_ROOT_ID}`);
+        const box = await root.boundingBox();
+        // Capture a fixed clip (the initial layout box) for every frame so the
+        // encoded stream has constant dimensions. Animate transform/opacity rather
+        // than layout size to stay within the box.
+        const clip = box !== null
+            ? { x: box.x, y: box.y, width: box.width, height: box.height }
+            : undefined;
+        const frames = [];
+        const frameCount = framesForDuration(request.durationMs, request.fps);
+        let elapsed = 0;
+        for (let i = 0; i < frameCount; i++) {
+            frames.push(await overlayPage.screenshot({
+                omitBackground: true,
+                type: 'png',
+                ...(clip !== undefined && { clip }),
+            }));
+            // Advance to the next exact frame timestamp (integer ms, no drift).
+            const next = Math.round(((i + 1) * 1000) / request.fps);
+            await overlayPage.clock.runFor(next - elapsed);
+            elapsed = next;
+        }
+        return {
+            frames,
+            width: box ? Math.round(box.width) : 0,
+            height: box ? Math.round(box.height) : 0,
+        };
+    }
+    finally {
+        await overlayContext.close().catch(() => { });
+    }
+}
+function runFfmpeg(args) {
+    return new Promise((resolve, reject) => {
+        if (ffmpegPath === null) {
+            reject(new Error('[screenci] ffmpeg binary not found; cannot encode an animated overlay.'));
+            return;
+        }
+        const child = spawn(ffmpegPath, args, {
+            stdio: ['ignore', 'ignore', 'pipe'],
+        });
+        let stderr = '';
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`[screenci] ffmpeg exited with code ${String(code)} while encoding an animated overlay.\n${stderr.slice(-2000)}`));
+        });
+    });
+}
+async function encodeAnimationFrames(frames, fps) {
+    const tmp = await mkdtemp(join(tmpdir(), 'screenci-anim-'));
+    try {
+        await Promise.all(frames.map((buffer, i) => writeFile(join(tmp, `frame_${String(i + 1).padStart(5, '0')}.png`), buffer)));
+        const outPath = join(tmp, 'overlay.mp4');
+        await runFfmpeg([
+            '-y',
+            '-framerate',
+            String(fps),
+            '-i',
+            join(tmp, 'frame_%05d.png'),
+            '-filter_complex',
+            ANIMATION_FILTER_COMPLEX,
+            '-map',
+            '[col]',
+            '-map',
+            '[alp]',
+            '-c:v',
+            'libx264',
+            '-pix_fmt',
+            'yuv420p',
+            '-preset',
+            'veryfast',
+            '-movflags',
+            '+faststart',
+            outPath,
+        ]);
+        return await readFile(outPath);
+    }
+    finally {
+        await rm(tmp, { recursive: true, force: true });
+    }
+}
+async function playwrightAnimatedHtmlRasterizer(request) {
+    const { frames, width, height } = await captureAnimationFrames(request);
+    const buffer = await encodeAnimationFrames(frames, request.fps);
+    return { buffer, width, height };
+}
+/**
+ * Renders an animated overlay, reusing a cached clip when the same input
+ * (markup + density + fps + duration) was already rendered in a previous run.
+ * Mirrors {@link renderOverlay} but caches the encoded .mp4.
+ */
+async function renderAnimatedOverlay(recordingDir, request) {
+    if (!cacheEnabled) {
+        return animatedRasterizer(request);
+    }
+    const deviceScaleFactor = request.deviceScaleFactor ?? DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR;
+    const inputHash = overlayInputHash({
+        kind: 'animation',
+        deviceScaleFactor,
+        capturePadding: request.capturePadding ?? 0,
+        fps: request.fps,
+        durationMs: request.durationMs,
+        css: request.css ?? '',
+        html: request.html,
+    });
+    const cacheDir = join(dirname(recordingDir), '.overlay-cache');
+    const clipPath = join(cacheDir, `${inputHash}.mp4`);
+    const metaPath = join(cacheDir, `${inputHash}.anim.json`);
+    if (existsSync(clipPath) && existsSync(metaPath)) {
+        const { width, height } = JSON.parse(readFileSync(metaPath, 'utf-8'));
+        return { buffer: readFileSync(clipPath), width, height };
+    }
+    const result = await animatedRasterizer(request);
+    mkdirSync(cacheDir, { recursive: true });
+    writeFileSync(clipPath, result.buffer);
+    writeFileSync(metaPath, JSON.stringify({ width: result.width, height: result.height }));
+    return result;
+}
+/**
+ * Rasterizes an animated HTML/React overlay to a transparent clip (a single
+ * .mp4 with a color stream and an alpha-matte stream) written into the
+ * per-recording directory for upload. Returns the path, content hash, intrinsic
+ * size, and capture duration. Unchanged overlays are served from the cross-run
+ * cache instead of re-rendering.
+ */
+export async function rasterizeAnimatedHtmlOverlay(opts) {
+    const recordingDir = getRuntimeRecordingDir();
+    if (recordingDir === null) {
+        throw new Error('[screenci] Cannot write a generated overlay: no active recording directory.');
+    }
+    const fps = opts.fps ?? DEFAULT_ANIMATION_FPS;
+    const deviceScaleFactor = opts.deviceScaleFactor ?? DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR;
+    // Validate sampling parameters up front (also exercised by the real capture).
+    framesForDuration(opts.durationMs, fps);
+    const css = opts.cssResolved === true ? (opts.css ?? '') : resolveOverlayCss(opts.css);
+    const { buffer, width, height } = await renderAnimatedOverlay(recordingDir, {
+        html: opts.html,
+        durationMs: opts.durationMs,
+        fps,
+        deviceScaleFactor,
+        ...(css.length > 0 && { css }),
+        ...(opts.capturePadding !== undefined && {
+            capturePadding: opts.capturePadding,
+        }),
+    });
+    const fileHash = createHash('sha256').update(buffer).digest('hex');
+    const dir = join(recordingDir, 'generated');
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${sanitizeName(opts.name)}-${fileHash.slice(0, 16)}.mp4`);
+    writeFileSync(path, buffer);
+    return { path, fileHash, width, height, durationMs: opts.durationMs };
+}
+//# sourceMappingURL=htmlRasterizer.js.map

package/dist/src/htmlRasterizer.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/src/init.d.ts CHANGED Viewed

@@ -28,10 +28,27 @@ export declare function parsePackageManager(value: string | undefined, cwd?: str
  * when the slug is empty or would collide with `screenci`.
  */
 export declare function toIslandPackageName(projectName: string): string;
+export declare function generateIslandTsconfig(withReact?: boolean): string;
 export declare function generateIslandReadme(projectName: string, packageManager: PackageManager): string;
 export declare function parsePnpmVersionSupport(versionOutput: string): PnpmVersionSupport;
 export declare function parseYarnVersionSupport(versionOutput: string): YarnVersionSupport;
+/**
+ * Pre-creates a CLI sign-in link during init and persists it into the new
+ * project's `.screenci/link-session.json`, so the user can sign in while their
+ * first video is being authored and a later `screenci record` reuses the same
+ * link (it just polls and continues once sign-in completes).
+ *
+ * Best-effort: a network failure here must never fail `init`. If a secret is
+ * already configured there is nothing to sign in for, so we skip silently.
+ *
+ * Returns the sign-in URL when one was created, otherwise null.
+ */
+export declare function createInitLinkSession(islandDir: string, options?: {
+    env?: NodeJS.ProcessEnv;
+}): Promise<string | null>;
 export declare function generateExampleVideo(): string;
+export declare function generateReactExampleVideo(): string;
 export declare function runInit(projectNameArg: string | undefined, options: InitOptions): Promise<void>;
 export declare function runCreateScreenciCli(argv?: string[]): Promise<void>;
+export declare function generateConfig(projectName: string): string;
 //# sourceMappingURL=init.d.ts.map

package/dist/src/init.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"~~AAeA~~,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,OAAO,CAAA;IACZ,cAAc,EAAE,cAAc,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAKD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,EACF,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,EACF,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,CAAA;CACtB,CAAA;AAED,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,IAAI,CAUvB;AAED,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,IAAI,CAavB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAwBpE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASxD;AAmSD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,CAUhB;AAoID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAS/D;~~AA4ED~~,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,MAAM,CAiBR;AA4DD,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,GACpB,kBAAkB,CA6BpB;AA0ED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,GACpB,kBAAkB,CAapB;~~AA0SD~~,wBAAgB,oBAAoB,IAAI,MAAM,CA+B7C;~~AAkGD~~,wBAAsB,OAAO,CAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,~~CAwOf~~;AAeD,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,MAAM,EAAiB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqCf"}
1	+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,OAAO,CAAA;IACZ,cAAc,EAAE,cAAc,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAKD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,EACF,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,EACF,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,CAAA;CACtB,CAAA;AAED,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,IAAI,CAUvB;AAED,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,IAAI,CAavB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAwBpE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASxD;AAmSD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,CAUhB;AAoID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAS/D;AAoBD,wBAAgB,sBAAsB,CAAC,SAAS,UAAQ,GAAG,MAAM,CA6BhE;AAiCD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B,MAAM,CAiBR;AA4DD,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,GACpB,kBAAkB,CA6BpB;AA0ED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,GACpB,kBAAkB,CAapB;AA0MD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2BxB;AA+HD,wBAAgB,oBAAoB,IAAI,MAAM,CA+B7C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CA0ClD;AAyGD,wBAAsB,OAAO,CAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAwPf;AAeD,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,MAAM,EAAiB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgC1D"}