@mevdragon/vidfarm-devcli 0.2.14 → 0.3.0

package/templates/vidfarm_template_0000/src/lib/images.js

@@ -1,221 +0,0 @@
-import sharp from "sharp";
-export async function normalizeToPortraitFrame(input, target = { width: 1080, height: 1920 }) {
-    const buffer = Buffer.isBuffer(input) ? input : Buffer.from(input);
-    const oriented = await materializeSharp(sharp(buffer, { density: 144 }).rotate());
-    const trimmed = await trimFlatBorders(oriented);
-    const targetAspect = target.width / target.height;
-    const shouldPreserveFraming = await isCloseToAspect(trimmed, targetAspect, 0.025);
-    const cropped = shouldPreserveFraming ? trimmed : await cropToActiveImageRegion(trimmed);
-    const normalized = await resizeWithBlurredContain(cropped, target, targetAspect);
-    return {
-        bytes: normalized,
-        contentType: "image/png",
-        width: target.width,
-        height: target.height
-    };
-}
-async function resizeWithBlurredContain(image, target, targetAspect) {
-    const metadata = await image.metadata();
-    const width = metadata.width ?? 0;
-    const height = metadata.height ?? 0;
-    if (!width || !height) {
-        return image
-            .resize(target.width, target.height, {
-            fit: "cover",
-            position: sharp.strategy.attention
-        })
-            .png()
-            .toBuffer();
-    }
-    const aspect = width / height;
-    if (Math.abs(aspect - targetAspect) <= 0.015) {
-        return image
-            .resize(target.width, target.height, {
-            fit: "fill"
-        })
-            .png()
-            .toBuffer();
-    }
-    const foreground = await image
-        .clone()
-        .resize(target.width, target.height, {
-        fit: "contain",
-        background: { r: 0, g: 0, b: 0, alpha: 0 }
-    })
-        .png()
-        .toBuffer();
-    const background = await image
-        .clone()
-        .resize(target.width, target.height, {
-        fit: "cover",
-        position: sharp.strategy.attention
-    })
-        .blur(20)
-        .modulate({ brightness: 0.92, saturation: 0.9 })
-        .png()
-        .toBuffer();
-    return sharp(background)
-        .composite([{ input: foreground }])
-        .png()
-        .toBuffer();
-}
-async function isCloseToAspect(image, targetAspect, tolerance) {
-    const metadata = await image.metadata();
-    const width = metadata.width ?? 0;
-    const height = metadata.height ?? 0;
-    if (!width || !height) {
-        return false;
-    }
-    return Math.abs(width / height - targetAspect) <= tolerance;
-}
-async function trimFlatBorders(image) {
-    const metadata = await image.metadata();
-    const sourceWidth = metadata.width ?? 0;
-    const sourceHeight = metadata.height ?? 0;
-    if (!sourceWidth || !sourceHeight || sourceWidth < 3 || sourceHeight < 3) {
-        return image;
-    }
-    const { data, info } = await image
-        .clone()
-        .trim({ threshold: 16 })
-        .png()
-        .toBuffer({ resolveWithObject: true });
-    const widthRatio = info.width / sourceWidth;
-    const heightRatio = info.height / sourceHeight;
-    if (widthRatio > 0.985 && heightRatio > 0.985) {
-        return image;
-    }
-    return materializeSharp(sharp(data).rotate());
-}
-async function cropToActiveImageRegion(image) {
-    const metadata = await image.metadata();
-    const sourceWidth = metadata.width ?? 0;
-    const sourceHeight = metadata.height ?? 0;
-    if (!sourceWidth || !sourceHeight) {
-        return image;
-    }
-    const sampleWidth = 96;
-    const sampleHeight = 170;
-    const sample = await image
-        .clone()
-        .resize(sampleWidth, sampleHeight, { fit: "fill" })
-        .grayscale()
-        .raw()
-        .toBuffer();
-    const bounds = detectActiveBounds(sample, sampleWidth, sampleHeight);
-    if (!bounds) {
-        return image;
-    }
-    const left = Math.max(0, Math.floor((bounds.left / sampleWidth) * sourceWidth));
-    const top = Math.max(0, Math.floor((bounds.top / sampleHeight) * sourceHeight));
-    const width = Math.min(sourceWidth - left, Math.max(1, Math.ceil((bounds.width / sampleWidth) * sourceWidth)));
-    const height = Math.min(sourceHeight - top, Math.max(1, Math.ceil((bounds.height / sampleHeight) * sourceHeight)));
-    return extractOrFallback(image, { left, top, width, height }, { width: sourceWidth, height: sourceHeight });
-}
-async function materializeSharp(image) {
-    const buffer = await image.png().toBuffer();
-    return sharp(buffer);
-}
-async function extractOrFallback(image, area, source) {
-    if (source.width <= 0 || source.height <= 0) {
-        return image;
-    }
-    const left = clamp(Math.floor(area.left), 0, source.width - 1);
-    const top = clamp(Math.floor(area.top), 0, source.height - 1);
-    const width = clamp(Math.floor(area.width), 1, source.width - left);
-    const height = clamp(Math.floor(area.height), 1, source.height - top);
-    try {
-        return await materializeSharp(image.extract({ left, top, width, height }));
-    }
-    catch {
-        return image;
-    }
-}
-function detectActiveBounds(sample, width, height) {
-    const rowActivity = new Array(height).fill(0);
-    const colActivity = new Array(width).fill(0);
-    for (let y = 0; y < height; y += 1) {
-        for (let x = 0; x < width; x += 1) {
-            const index = y * width + x;
-            const current = sample[index] ?? 0;
-            const left = x > 0 ? sample[index - 1] ?? current : current;
-            const up = y > 0 ? sample[index - width] ?? current : current;
-            const right = x < width - 1 ? sample[index + 1] ?? current : current;
-            const down = y < height - 1 ? sample[index + width] ?? current : current;
-            const energy = Math.abs(current - left) +
-                Math.abs(current - right) +
-                Math.abs(current - up) +
-                Math.abs(current - down);
-            rowActivity[y] += energy;
-            colActivity[x] += energy;
-        }
-    }
-    const smoothedRows = smoothSeries(rowActivity.map((value) => value / width), 9);
-    const smoothedCols = smoothSeries(colActivity.map((value) => value / height), 7);
-    const rowBounds = findActiveRange(smoothedRows, Math.round(height * 0.18));
-    const colBounds = findActiveRange(smoothedCols, Math.round(width * 0.16));
-    if (!rowBounds || !colBounds) {
-        return null;
-    }
-    const topMargin = rowBounds.start / height;
-    const bottomMargin = (height - rowBounds.end - 1) / height;
-    const leftMargin = colBounds.start / width;
-    const rightMargin = (width - colBounds.end - 1) / width;
-    const croppedWidth = colBounds.end - colBounds.start + 1;
-    const croppedHeight = rowBounds.end - rowBounds.start + 1;
-    const croppedAreaRatio = (croppedWidth * croppedHeight) / (width * height);
-    const significantMargins = topMargin > 0.11 || bottomMargin > 0.11 || leftMargin > 0.08 || rightMargin > 0.08;
-    if (!significantMargins && croppedAreaRatio > 0.9) {
-        return null;
-    }
-    return {
-        left: colBounds.start,
-        top: rowBounds.start,
-        width: croppedWidth,
-        height: croppedHeight
-    };
-}
-function findActiveRange(values, minSpan) {
-    const mean = values.reduce((sum, value) => sum + value, 0) / Math.max(values.length, 1);
-    const max = values.reduce((best, value) => Math.max(best, value), 0);
-    if (max <= 0) {
-        return null;
-    }
-    const threshold = mean + (max - mean) * 0.18;
-    let start = 0;
-    while (start < values.length && values[start] < threshold) {
-        start += 1;
-    }
-    let end = values.length - 1;
-    while (end >= 0 && values[end] < threshold) {
-        end -= 1;
-    }
-    if (start >= end) {
-        return null;
-    }
-    const desiredSpan = Math.max(minSpan, end - start + 1);
-    const extra = desiredSpan - (end - start + 1);
-    const expandStart = Math.floor(extra / 2);
-    const expandEnd = extra - expandStart;
-    start = Math.max(0, start - expandStart - 4);
-    end = Math.min(values.length - 1, end + expandEnd + 4);
-    return { start, end };
-}
-function smoothSeries(values, radius) {
-    return values.map((_, index) => {
-        let total = 0;
-        let count = 0;
-        for (let offset = -radius; offset <= radius; offset += 1) {
-            const value = values[index + offset];
-            if (value === undefined) {
-                continue;
-            }
-            total += value;
-            count += 1;
-        }
-        return total / Math.max(count, 1);
-    });
-}
-function clamp(value, min, max) {
-    return Math.min(Math.max(value, min), max);
-}

package/templates/vidfarm_template_0000/src/remotion/Root.js

@@ -1,33 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { AbsoluteFill, Composition, Img, Sequence, interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion";
-export const RemotionRoot = () => {
-    return (_jsx(Composition, { id: "template-0000", component: TemplateVideo, width: 1080, height: 1920, fps: 30, durationInFrames: 120, defaultProps: { slides: [] }, calculateMetadata: ({ props }) => ({
-            width: 1080,
-            height: 1920,
-            durationInFrames: Math.max(1, sumSlideFrames(props.slides, 30))
-        }) }));
-};
-const TemplateVideo = ({ slides }) => {
-    const { fps } = useVideoConfig();
-    let currentFrame = 0;
-    return (_jsx(AbsoluteFill, { style: { backgroundColor: "#120f0b" }, children: slides.map((slide, index) => {
-            const durationInFrames = msToFrames(slide.durationMs, fps);
-            const sequence = (_jsx(Sequence, { from: currentFrame, durationInFrames: durationInFrames, children: _jsx(SlideFrame, { slide: slide }) }, `${slide.imageUrl}-${index}`));
-            currentFrame += durationInFrames;
-            return sequence;
-        }) }));
-};
-const SlideFrame = ({ slide }) => {
-    const frame = useCurrentFrame();
-    const { fps } = useVideoConfig();
-    const entrance = spring({ fps, frame, config: { damping: 200, stiffness: 140 } });
-    const opacity = interpolate(entrance, [0, 1], [0.35, 1]);
-    const lift = interpolate(entrance, [0, 1], [22, 0]);
-    return (_jsxs(AbsoluteFill, { children: [_jsx(AbsoluteFill, { style: { opacity, transform: `translateY(${lift}px)` }, children: _jsx(Img, { src: slide.imageUrl, style: { width: "100%", height: "100%", objectFit: "fill" } }) }), _jsx(AbsoluteFill, { style: { background: "linear-gradient(180deg, rgba(0,0,0,0.18) 0%, rgba(0,0,0,0.06) 36%, rgba(0,0,0,0.34) 100%)" } })] }));
-};
-function msToFrames(durationMs, fps) {
-    return Math.max(1, Math.round((durationMs / 1000) * fps));
-}
-function sumSlideFrames(slides, fps) {
-    return slides.reduce((total, slide) => total + msToFrames(slide.durationMs, fps), 0);
-}

package/templates/vidfarm_template_0000/src/remotion/index.js

@@ -1,3 +0,0 @@
-import { registerRoot } from "remotion";
-import { RemotionRoot } from "./Root.js";
-registerRoot(RemotionRoot);

package/templates/vidfarm_template_0000/src/sdk.js

@@ -1,3 +0,0 @@
-export function defineTemplate(definition) {
-    return definition;
-}

package/templates/vidfarm_template_0000/src/style-options.js

@@ -1,200 +0,0 @@
-export const CAPTION_STANDARD_VERSION = "2026-05-31";
-export const TEMPLATE_FONT_OPTIONS = [
-    {
-        id: "tiktok_sans_semibold",
-        label: "TikTok Sans SemiBold",
-        family: "TikTok Sans",
-        weight: 600,
-        assetFile: "TikTokSans-SemiBold.ttf",
-        fontsourceFile: "@fontsource/tiktok-sans/files/tiktok-sans-latin-600-normal.woff",
-        source: "fontsource_or_bundled_asset",
-        role: "tiktok_native_default",
-    },
-    {
-        id: "montserrat_semibold",
-        label: "Montserrat SemiBold",
-        family: "Montserrat",
-        weight: 600,
-        assetFile: "Montserrat[wght].ttf",
-        fontsourceFile: "@fontsource/montserrat/files/montserrat-latin-600-normal.woff",
-        source: "fontsource_or_bundled_asset",
-        role: "rounded_modern_caption",
-    },
-    {
-        id: "source_code_pro_bold",
-        label: "Source Code Pro Bold",
-        family: "Source Code Pro",
-        weight: 700,
-        assetFile: "SourceCodePro[wght].ttf",
-        fontsourceFile: "@fontsource/source-code-pro/files/source-code-pro-latin-700-normal.woff",
-        source: "fontsource_or_bundled_asset",
-        role: "monospace_caption",
-    },
-    {
-        id: "yesteryear",
-        label: "Yesteryear",
-        family: "Yesteryear",
-        weight: 400,
-        assetFile: "Yesteryear-Regular.ttf",
-        source: "bundled_asset",
-        role: "script_caption",
-    },
-    {
-        id: "georgia_bold",
-        label: "Georgia-style Bold",
-        family: "Libre Baskerville",
-        weight: 700,
-        fontsourceFile: "@fontsource/libre-baskerville/files/libre-baskerville-latin-700-normal.woff",
-        source: "fontsource",
-        role: "serif_caption",
-    },
-    {
-        id: "abel",
-        label: "Abel",
-        family: "Abel",
-        weight: 400,
-        assetFile: "Abel-Regular.ttf",
-        source: "bundled_asset",
-        role: "condensed_caption",
-    },
-    {
-        id: "source_code_pro",
-        label: "Source Code Pro",
-        family: "Source Code Pro",
-        weight: 700,
-        assetFile: "SourceCodePro[wght].ttf",
-        fontsourceFile: "@fontsource/source-code-pro/files/source-code-pro-latin-700-normal.woff",
-        source: "fontsource_or_bundled_asset",
-        role: "legacy_alias",
-        aliasOf: "source_code_pro_bold",
-    },
-    {
-        id: "montserrat",
-        label: "Montserrat",
-        family: "Montserrat",
-        weight: 600,
-        assetFile: "Montserrat[wght].ttf",
-        fontsourceFile: "@fontsource/montserrat/files/montserrat-latin-600-normal.woff",
-        source: "fontsource_or_bundled_asset",
-        role: "legacy_alias",
-        aliasOf: "montserrat_semibold",
-    },
-];
-export const TEMPLATE_TEXT_BACKGROUND_COLOR_OPTIONS = [
-    { id: "black", label: "Black", hex: "#000000" },
-    { id: "red", label: "Red", hex: "#EA403F" },
-    { id: "orange", label: "Orange", hex: "#FF933D" },
-    { id: "yellow", label: "Yellow", hex: "#F2CD46" },
-    { id: "lime_green", label: "Lime Green", hex: "#78C25E" },
-    { id: "teal", label: "Teal", hex: "#77C8A6" },
-    { id: "light_blue", label: "Light Blue", hex: "#3496F0" },
-    { id: "dark_blue", label: "Dark Blue", hex: "#3496F0" },
-    { id: "violet", label: "Violet", hex: "#5756D4" },
-    { id: "pink", label: "Pink", hex: "#F7D7E9" },
-    { id: "brown", label: "Brown", hex: "#A3895B" },
-    { id: "dark_green", label: "Dark Green", hex: "#32523B" },
-    { id: "blue_gray", label: "Blue Gray", hex: "#2F688C" },
-    { id: "light_gray", label: "Light Gray", hex: "#92979E" },
-    { id: "dark_gray", label: "Dark Gray", hex: "#333333" },
-];
-export const TEMPLATE_TEXT_BACKGROUND_RENDERING = {
-    mode: "inline_highlight_chip",
-    rule: "Text background colors must render as inline highlight chips that hug the text only.",
-    padding: "Use visible per-line padding around measured glyph bounds; do not render full-width bars, paragraph washes, or loose caption boxes.",
-    shape: "Use slightly curved corners, similar to native TikTok text highlight chips.",
-    implementation: "Wrap and measure the full caption block first. For every rendered line, draw one chip from that line's measured text bounds plus padding. The chip width must vary with the text line; it must not use the caption block width.",
-    strengths: {
-        none: {
-            paddingX: 0,
-            paddingY: 0,
-            radius: 0,
-            opacity: 0,
-        },
-        subtle: {
-            paddingX: 14,
-            paddingY: 8,
-            radius: 9,
-            opacity: 0.72,
-        },
-        standard: {
-            paddingX: 20,
-            paddingY: 12,
-            radius: 12,
-            opacity: 0.86,
-        },
-        strong: {
-            paddingX: 26,
-            paddingY: 14,
-            radius: 14,
-            opacity: 0.94,
-        },
-    },
-};
-export const TEMPLATE_CAPTION_SHADOWS = {
-    native_black_shadow: {
-        mode: "radial_micro_shadow",
-        rule: "Native TikTok-style white captions need a soft black halo/outline around the glyphs, not a strong directional web drop shadow.",
-        cssTextShadow: "0 0 2px rgba(0,0,0,0.85), 0 0 4px rgba(0,0,0,0.72), 0 0 8px rgba(0,0,0,0.48)",
-        sharpCompositing: "Build shadow layers from the full multiline text block alpha mask, blur them, and composite them centered at the text block origin. Do not offset the shadow down/right except for source formats that explicitly require directional lighting.",
-        maxDirectionalOffsetPx: 1,
-        validation: "On a solid mid-gray background, the caption edge should darken evenly around all sides of each glyph. A shadow visible mainly below the text is a failure.",
-    },
-    none: {
-        mode: "none",
-        rule: "Use no shadow only when the source format uses dark text on a light inline chip or another high-contrast container.",
-    },
-};
-export const TEMPLATE_CAPTION_RENDERING_RULES = {
-    multilineText: {
-        rule: "Render each caption as one multiline text block after wrapping, not as independently trimmed per-line text images.",
-        reason: "Per-line trimmed rendering makes line height, trim bounds, and shadow placement vary per line, which can make shorter wrapped lines look heavier or larger at the same nominal font size.",
-        implementation: "Choose the font size, line height, wrap width, and line breaks once for the whole caption; render the full block on a stable canvas; apply the native radial shadow/outline to the whole text block; then place optional line chips from measured line bounds.",
-        validation: "Test a wrapped caption with one short line and one long line; both lines must keep the same glyph scale, weight, baseline rhythm, and shadow strength."
-    },
-    inlineHighlightChips: {
-        rule: "If a caption has a text background color, render inline highlight chips per wrapped line from measured glyph bounds.",
-        implementation: "Draw chips behind each measured line before the shadow and text layers. Chip geometry comes from measured line width plus standard padding; never draw a full-width caption panel or one rectangle behind the whole paragraph.",
-        validation: "Test a two-line caption where one line is much shorter. The shorter line's background must be visibly shorter too."
-    },
-    nativeShadow: {
-        rule: "Use a radial black halo/outline for native white TikTok captions. Avoid one-direction CSS or canvas shadows such as only 0 8px 24px.",
-        implementation: "Use multiple centered low-radius shadows or blurred alpha masks around the full multiline text block. Keep directional offsets at 0-1 px.",
-        validation: "The shadow must radiate around left, right, top, and bottom glyph edges; it must not read as a web card drop shadow."
-    },
-    tiktokSansSizing: {
-        rule: "Tune TikTok Sans wrapping, font size, and line spacing separately from Montserrat or generic sans defaults.",
-        reason: "TikTok Sans metrics differ enough from Montserrat that reused sizing assumptions can produce wrong wrap points, cramped leading, or off-weight captions."
-    }
-};
-export const TEMPLATE_CAPTION_STYLE_PRESETS = [
-    {
-        id: "tiktok_native_white",
-        label: "TikTok Native White",
-        fontId: "tiktok_sans_semibold",
-        fill: "#ffffff",
-        backgroundColorId: "none",
-        shadow: "native_black_shadow",
-    },
-    {
-        id: "tiktok_native_chip",
-        label: "TikTok Native Color Chip",
-        fontId: "tiktok_sans_semibold",
-        fill: "#ffffff",
-        defaultBackgroundColorId: "red",
-        backgroundRendering: "inline_highlight_chip",
-        chipStrength: "standard",
-        shadow: "native_black_shadow",
-    },
-    {
-        id: "tiktok_editor_gray",
-        label: "TikTok Editor Gray",
-        fontId: "tiktok_sans_semibold",
-        fill: "#111111",
-        defaultBackgroundColorId: "light_gray",
-        backgroundRendering: "inline_highlight_chip",
-        chipStrength: "subtle",
-        shadow: "none",
-    },
-];
-export const TEMPLATE_FONT_IDS = TEMPLATE_FONT_OPTIONS.map((option) => option.id);
-export const TEMPLATE_TEXT_BACKGROUND_COLOR_IDS = TEMPLATE_TEXT_BACKGROUND_COLOR_OPTIONS.map((option) => option.id);

package/templates/vidfarm_template_0000/src/template-dna.js

@@ -1,9 +0,0 @@
-// Generated by `vidfarm analyze-viral-dna` and `vidfarm analyze-visual-dna`.
-// Keep source notes in `research/source_notes.md` and reference media in `research/preview/`.
-export const templateLinkToOriginal = "";
-export const templateSourceNotesPath = "research/source_notes.md";
-export const templatePreviewMediaRelativePaths = [];
-export const templateViralDna = "Run `vidfarm analyze-viral-dna --template-dir .` after adding source notes and preview media.";
-export const templateVisualDna = "Run `vidfarm analyze-visual-dna --template-dir .` after adding source notes and preview media.";
-export const templateViralDnaAnalysis = null;
-export const templateVisualDnaAnalysis = null;