@amaster.ai/pi-video-gen 0.1.2-beta.48

package/dist/text-layer.js

@@ -0,0 +1,168 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import sharp from 'sharp';
+import { VideoGenError } from './errors.js';
+/**
+ * Text overlay rendering (C1): SVG template → PNG overlay via sharp.
+ *
+ * Chinese text is rendered by the LOCAL font stack (model never writes
+ * pixels — that's the Codex/hypeframes lesson: model-generated CJK text
+ * comes out garbled). Positioning follows Remotion's video-layout rule of a
+ * ~8% safe margin.
+ */
+const FONT_STACK = 'PingFang SC, Hiragana Sans GB, Microsoft YaHei, Noto Sans CJK SC, sans-serif';
+const SAFE_MARGIN_RATIO = 0.08;
+export function hasCjkFont() {
+    const listed = spawnSync('fc-list', [':lang=zh-cn', 'family'], {
+        encoding: 'utf-8',
+        timeout: 2_000,
+    });
+    if (listed.status === 0 && listed.stdout.trim())
+        return true;
+    const windowsFonts = process.env.WINDIR ? join(process.env.WINDIR, 'Fonts') : '';
+    return [
+        '/System/Library/Fonts/PingFang.ttc',
+        '/System/Library/Fonts/STHeiti Light.ttc',
+        '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc',
+        '/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc',
+        windowsFonts && join(windowsFonts, 'msyh.ttc'),
+        windowsFonts && join(windowsFonts, 'simsun.ttc'),
+    ].some((path) => path !== '' && existsSync(path));
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function estimatedTextWidth(text, fontSize) {
+    return Array.from(text).reduce((width, char) => {
+        if (/\s/u.test(char))
+            return width + fontSize * 0.33;
+        if (/[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Extended_Pictographic}]/u.test(char) ||
+            /[MWmw@%&]/u.test(char)) {
+            return width + fontSize;
+        }
+        if (/[A-Z0-9]/u.test(char))
+            return width + fontSize * 0.75;
+        return width + fontSize * 0.62;
+    }, 0);
+}
+function wrapSubtitleLines(text, fontSize, maxWidth) {
+    const lines = [];
+    for (const paragraph of text.split('\n')) {
+        let line = '';
+        for (const token of paragraph.match(/\s+|[^\s]+/gu) ?? []) {
+            const candidate = line + token;
+            if (line.trim() && estimatedTextWidth(candidate, fontSize) > maxWidth) {
+                lines.push(line.trim());
+                line = token.trimStart();
+            }
+            else {
+                line = candidate;
+            }
+            while (estimatedTextWidth(line, fontSize) > maxWidth) {
+                const chars = Array.from(line);
+                let cut = 1;
+                while (cut < chars.length &&
+                    estimatedTextWidth(chars.slice(0, cut + 1).join(''), fontSize) <= maxWidth) {
+                    cut += 1;
+                }
+                lines.push(chars.slice(0, cut).join('').trim());
+                line = chars.slice(cut).join('').trimStart();
+            }
+        }
+        if (line.trim())
+            lines.push(line.trim());
+    }
+    return lines;
+}
+function positionFor(pos, width, height, blockH) {
+    const marginX = Math.round(width * SAFE_MARGIN_RATIO);
+    const marginY = Math.round(height * SAFE_MARGIN_RATIO);
+    if (pos === 'bottom-center') {
+        return { x: Math.round(width / 2), y: height - marginY - blockH, anchor: 'middle' };
+    }
+    if (pos === 'top-left') {
+        return { x: marginX, y: marginY, anchor: 'start' };
+    }
+    if (pos === 'center') {
+        return { x: Math.round(width / 2), y: Math.round((height - blockH) / 2), anchor: 'middle' };
+    }
+    return { x: marginX, y: height - marginY - blockH, anchor: 'start' };
+}
+function overlaySvg(overlay, width, height) {
+    const titleSize = Math.max(28, Math.round(height * 0.055));
+    const subtitleSize = Math.max(20, Math.round(height * 0.032));
+    const lineGap = Math.round(titleSize * 0.5);
+    const blockH = (overlay.title ? titleSize : 0) +
+        (overlay.title && overlay.subtitle ? lineGap : 0) +
+        (overlay.subtitle ? subtitleSize : 0);
+    const { x, y, anchor } = positionFor(overlay.position, width, height, blockH);
+    const lines = [];
+    let cursorY = y + titleSize;
+    if (overlay.title) {
+        lines.push(`<text x="${x}" y="${cursorY}" font-size="${titleSize}" font-weight="700" fill="#ffffff" text-anchor="${anchor}" font-family="${FONT_STACK}">${escapeXml(overlay.title)}</text>`);
+        cursorY += lineGap + (overlay.subtitle ? subtitleSize : 0);
+    }
+    if (overlay.subtitle) {
+        lines.push(`<text x="${x}" y="${cursorY}" font-size="${subtitleSize}" font-weight="400" fill="rgba(255,255,255,0.85)" text-anchor="${anchor}" font-family="${FONT_STACK}">${escapeXml(overlay.subtitle)}</text>`);
+    }
+    // Soft dark plate behind the text block for legibility over any image.
+    const platePad = Math.round(titleSize * 0.45);
+    const plateY = y - platePad;
+    const plateH = blockH + platePad * 2;
+    const plate = `<rect x="0" y="${plateY}" width="${width}" height="${plateH}" fill="rgba(0,0,0,0.32)"/>`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}">${plate}${lines.join('')}</svg>`;
+}
+/** Render an overlay to a PNG with alpha, sized to the video frame. */
+export async function renderTextOverlay(opts) {
+    if (!opts.overlay.title && !opts.overlay.subtitle)
+        return null;
+    const text = `${opts.overlay.title ?? ''}${opts.overlay.subtitle ?? ''}`;
+    if (/\p{Script=Han}/u.test(text) && !hasCjkFont()) {
+        throw new VideoGenError('A CJK font is required for Chinese text overlays. Install PingFang, Microsoft YaHei, Noto Sans CJK, or WenQuanYi, then retry.', 'text-layer: CJK font missing');
+    }
+    const svg = overlaySvg(opts.overlay, opts.width, opts.height);
+    // Render the SVG at ~2x density for crisp text, then downscale to frame size.
+    await sharp(Buffer.from(svg, 'utf-8'), { density: 150 })
+        .resize(opts.width, opts.height)
+        .png()
+        .toFile(opts.outPath);
+    return opts.outPath;
+}
+/** Render one narration cue as a branded, bottom-centered burned subtitle. */
+export async function renderBurnedSubtitle(opts) {
+    if (/\p{Script=Han}/u.test(opts.text) && !hasCjkFont()) {
+        throw new VideoGenError('A CJK font is required for burned Chinese subtitles. Install PingFang, Microsoft YaHei, Noto Sans CJK, or WenQuanYi, then retry.', 'text-layer: CJK font missing');
+    }
+    const fontSize = opts.style.fontSize ?? Math.max(20, Math.round(opts.height * 0.032));
+    const lineHeight = Math.round(fontSize * 1.35);
+    const margin = Math.round(opts.height * SAFE_MARGIN_RATIO);
+    const padding = Math.round(fontSize * 0.5);
+    const lines = wrapSubtitleLines(opts.text, fontSize, opts.width - margin * 2 - padding * 2);
+    const blockHeight = Math.max(1, lines.length) * lineHeight;
+    if (blockHeight + padding * 2 > opts.height - margin * 2) {
+        throw new VideoGenError('Burned subtitle text is too long to fit the video frame. Shorten the narration or reduce subtitles.fontSize.', 'text-layer: subtitle too long');
+    }
+    const plateY = opts.height - margin - blockHeight - padding;
+    const textY = plateY + padding + fontSize;
+    const textColor = opts.style.textColor ?? '#ffffff';
+    const backgroundColor = opts.style.backgroundColor ?? '#000000';
+    const backgroundOpacity = opts.style.backgroundOpacity ?? 0.55;
+    const tspans = lines
+        .map((line, index) => `<tspan x="${Math.round(opts.width / 2)}" y="${textY + index * lineHeight}">${escapeXml(line)}</tspan>`)
+        .join('');
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${opts.width}" height="${opts.height}">
+    <rect x="0" y="${plateY}" width="${opts.width}" height="${blockHeight + padding * 2}" fill="${backgroundColor}" fill-opacity="${backgroundOpacity}"/>
+    <text font-size="${fontSize}" font-weight="500" fill="${textColor}" text-anchor="middle" font-family="${FONT_STACK}">${tspans}</text>
+  </svg>`;
+    await sharp(Buffer.from(svg, 'utf-8'), { density: 150 })
+        .resize(opts.width, opts.height)
+        .png()
+        .toFile(opts.outPath);
+    return opts.outPath;
+}
+//# sourceMappingURL=text-layer.js.map

package/dist/text-layer.js.map

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

package/dist/timeline-render.d.ts

@@ -0,0 +1,33 @@
+import { type ActiveJobs } from './jobs/store.js';
+import { type TtsProvider } from './tts/edge-tts.js';
+import type { VideoGenSettings } from './types.js';
+/**
+ * Timeline compose pipeline (C1–C4): promo/explainer videos from images/video
+ * clips + text overlays + TTS narration + motion, rendered LOCALLY with the
+ * vendored ffmpeg — no video-generation model, near-zero marginal cost.
+ *
+ * Pipeline (all stages are artifact-cached in the job dir, so a rerun after
+ * interruption resumes where it stopped):
+ *   timeline-input.json → overlays/subtitles (sharp) → narration (Edge TTS) →
+ *   normalized segment mp4s → xfade/concat video track →
+ *   source/narration audio (+BGM ducking) → optional mov_text subtitles →
+ *   ffprobe duration + QC frame extraction.
+ */
+export type TimelineRunResult = {
+    jobId: string;
+    finalVideoPath: string;
+    segments: number;
+    durationSec: number;
+    subtitlePath?: string | undefined;
+    qcFrames: string[];
+};
+export declare function runTimeline(opts: {
+    timelineSpecPath: string;
+    cwd: string;
+    settings: VideoGenSettings;
+    activeJobs: ActiveJobs;
+    tts?: TtsProvider | undefined;
+    signal?: AbortSignal | undefined;
+    onUpdate?: ((msg: string) => void) | undefined;
+}): Promise<TimelineRunResult>;
+//# sourceMappingURL=timeline-render.d.ts.map

package/dist/timeline-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-render.d.ts","sourceRoot":"","sources":["../src/timeline-render.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,KAAK,UAAU,EAOhB,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAwNF,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,GAAG,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAChD,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8iC7B"}