adyou 0.3.0 → 0.5.0

package/dist/core/creatives/playbook.d.ts

@@ -0,0 +1,40 @@
+export type VideoFormat = 'ugc_selfie' | 'ui_demo' | 'cinematic' | 'product_hero' | 'lifestyle' | 'text_hook';
+export declare const FORMAT_LABEL: Record<VideoFormat, string>;
+export declare const FORMAT_DESC: Record<VideoFormat, string>;
+export type Tone = 'calm' | 'lively' | 'bold';
+export declare const TONE_LABEL: Record<Tone, string>;
+export declare const TONE_WORDS: Record<Tone, {
+    camera: string;
+    music: string;
+    caption: string;
+}>;
+export type Playbook = {
+    key: string;
+    label: string;
+    /** 우선순위 포맷(앞이 먼저) */
+    formats: VideoFormat[];
+    /** 훅 패턴(콘티 LLM 에 예시로) */
+    hooks: string[];
+    /** 기본 비주얼 장르 */
+    genres: string[];
+    /** 꼭 보여줄 것 */
+    musts: string[];
+    /** 피할 것(정책·상식) */
+    avoid: string[];
+    /** 기본 톤 */
+    tone: Tone;
+};
+export declare const INDUSTRIES: Record<string, Playbook>;
+export declare const INDUSTRY_KEYS: string[];
+export declare function playbookFor(industry?: string | null): Playbook;
+/** 이 브리프에 맞는 영상 포맷 n개 — 플레이북 순서를 따르되 장르(anime 등)·화면 유무를 반영 · 항상 서로 다른 포맷 */
+export declare function pickFormats(o: {
+    industry?: string | null;
+    genres?: string[];
+    hasScreens: boolean;
+    count: number;
+    requested?: VideoFormat[];
+}): VideoFormat[];
+/** 장르 → 이미지/영상 프롬프트 스타일 토큰 */
+export declare const GENRE_STYLE: Record<string, string>;
+export declare const genreStyle: (g?: string) => string;

package/dist/core/creatives/playbook.js

@@ -0,0 +1,61 @@
+export const FORMAT_LABEL = { ugc_selfie: '셀카 후기(UGC)', ui_demo: '화면 데모', cinematic: '시네마틱', product_hero: '제품 히어로', lifestyle: '라이프스타일', text_hook: '큰 글자 훅' };
+export const FORMAT_DESC = {
+    ugc_selfie: '실제 고객처럼 보이는 인물이 셀카로 한마디 — 네이티브 톤, 소비재·앱에서 CPM 낮고 CTR 높음',
+    ui_demo: '실제 사이트/앱 화면이 폰 안에서 움직임 — 앱·SaaS·쇼핑몰에서 「무엇인지」를 3초 안에 보여줌(생성 비용 0)',
+    cinematic: '장르(실사·애니·3D)에 맞는 연출 컷 2개(훅 → 보상) — 브랜드 무드·세계관',
+    product_hero: '제품/결과물이 주인공인 클로즈업·회전·질감 — 뷰티·식품·패션',
+    lifestyle: '타겟이 제품을 쓰는 장면 — 여행·피트니스·가전',
+    text_hook: '큰 글자 질문/숫자로 시작해 증거로 이어가는 텍스트 중심 — B2B·교육·서비스',
+};
+export const TONE_LABEL = { calm: '차분하게', lively: '활기차게', bold: '강하게' };
+export const TONE_WORDS = {
+    calm: { camera: 'smooth, steady camera, gentle motion, soft natural light', music: 'soft, warm, understated background music', caption: '차분한 서술형' },
+    lively: { camera: 'energetic handheld feel, quick push-ins, dynamic motion in the first second, bright lighting', music: 'upbeat, modern, rhythmic music with a clear beat', caption: '짧고 리듬 있는 구어체' },
+    bold: { camera: 'punchy fast cuts, dramatic close-ups, strong contrast, high energy from frame one', music: 'driving, bold, high-energy music with impact hits', caption: '짧고 강한 선언형' },
+};
+const P = (key, label, formats, hooks, genres, musts, avoid, tone = 'lively') => ({ key, label, formats, hooks, genres, musts, avoid, tone });
+export const INDUSTRIES = {
+    app_game: P('app_game', '앱·게임·엔터·웹툰', ['ugc_selfie', 'ui_demo', 'cinematic'], ['「이거 해봤어?」 반응 셀카', '캐릭터/세계관 컷 → 실제 화면', '선택지 두 개를 보여주고 결말 예고'], ['anime', 'ugc', '3d'], ['실제 앱 화면 3초 안에', '재미·몰입의 순간'], ['현금·보상 과장', '성인 암시', '타사 IP·실존 인물'], 'lively'),
+    saas: P('saas', 'SaaS·업무 도구', ['ui_demo', 'text_hook', 'ugc_selfie'], ['「아직 이걸 손으로 하세요?」', '숫자 훅(「하루 3시간 절약」은 근거 있을 때만)', '전/후 업무 화면(건강 아님·허용)'], ['photoreal', 'motion_graphics', 'ugc'], ['핵심 화면·결과물', '누구를 위한 도구인지'], ['검증 없는 수치', '경쟁사 비방'], 'lively'),
+    ecommerce_beauty: P('ecommerce_beauty', '화장품·뷰티', ['ugc_selfie', 'product_hero', 'lifestyle'], ['텍스처·발림 클로즈업', '「이거 하나로」 루틴 셀카', '성분 하나 강조'], ['photoreal', 'product_shot', 'ugc'], ['제품 질감·사용 장면', '피부 톤 다양'], ['전후 비교 사진', '효능 단정(「완치」「100%」)', '신체 부위 클로즈업 과다'], 'lively'),
+    ecommerce_health: P('ecommerce_health', '건강기능식품·헬스 보조', ['ugc_selfie', 'product_hero', 'text_hook'], ['「아침에 이거 하나」 루틴', '성분·인증 마크(실제 있는 것만)', '「이런 분께」 타겟 지칭 없이 상황으로'], ['photoreal', 'product_shot', 'ugc'], ['제품·성분·인증(사이트 근거)', '복용 장면'], ['질병 치료·예방 표현', '전후 비교', '개인 건강상태 지칭(「당신은 비만」)', '의사 연출'], 'calm'),
+    ecommerce_fashion: P('ecommerce_fashion', '패션·잡화', ['lifestyle', 'product_hero', 'ugc_selfie'], ['핏·움직임(걷기·돌기)', '코디 3가지 빠른 컷', '가격/한정(사이트에 있으면)'], ['photoreal', 'ugc'], ['착용 실루엣', '소재·디테일'], ['비현실적 몸매 묘사', '타사 로고'], 'lively'),
+    ecommerce_food: P('ecommerce_food', '식품·음료·농산물', ['product_hero', 'ugc_selfie', 'lifestyle'], ['한 입·시즐(김·소리)', '산지/생산 장면 → 식탁', '「오늘 주문 → 내일 도착」(사이트 근거)'], ['photoreal', 'product_shot', 'ugc'], ['먹는 장면·질감', '원산지·신선함'], ['건강 효능 단정', '가격 오표기'], 'lively'),
+    education: P('education', '교육·강의·학원', ['text_hook', 'ugc_selfie', 'ui_demo'], ['「이 문제 풀 수 있어요?」', '수강생 셀카 후기(합격·성과는 근거 있을 때만)', '커리큘럼 첫 장면'], ['photoreal', 'motion_graphics', 'ugc'], ['무엇을 배우는지 3초', '강사/교재 실제 화면'], ['합격 보장', '타 기관 비교'], 'lively'),
+    travel: P('travel', '여행·숙박·투어', ['lifestyle', 'cinematic', 'ugc_selfie'], ['목적지 첫 장면 3개 빠른 컷', '「이 가격에?」(실제 가격만)', '여행자 셀카 리액션'], ['photoreal', 'ugc'], ['목적지·숙소·경험 장면', '가격·기간(사이트 근거)'], ['가짜 「마감 임박」', '타사 항공·호텔 로고'], 'lively'),
+    airline: P('airline', '항공', ['cinematic', 'lifestyle', 'text_hook'], ['이륙/창밖 → 도착지', '좌석·서비스 디테일', '「○○행 ○○원부터」(실제 운임만)'], ['photoreal'], ['노선·좌석·서비스', '운임 조건'], ['안전 관련 과장', '경쟁사 언급'], 'calm'),
+    realestate_construction: P('realestate_construction', '건설·부동산·인테리어', ['cinematic', 'text_hook', 'lifestyle'], ['완공 드론 → 내부 워크스루', '「이 동네에 이런 집?」', '시공 전→후(주거 허용·정직하게)'], ['photoreal', '3d'], ['실제 조감·평면·위치', '시공 품질'], ['수익률·시세 상승 단정', '허위 분양 조건'], 'calm'),
+    finance: P('finance', '금융·보험·투자', ['text_hook', 'ugc_selfie'], ['「매달 이만큼 새나가요」(근거 있을 때만)', '한 줄 질문'], ['photoreal', 'motion_graphics'], ['상품 조건·수수료'], ['수익 보장', '공포 소구'], 'calm'),
+    medical: P('medical', '의료·병원·시술', ['text_hook', 'cinematic'], ['시설·의료진(실존 인물 초상 동의 필요)'], ['photoreal'], ['진료 과목·위치'], ['전후 비교', '치료 효과 단정', '환자 후기 연출'], 'calm'),
+    b2b_service: P('b2b_service', 'B2B 서비스·컨설팅·제조', ['text_hook', 'ui_demo', 'cinematic'], ['「담당자님, 이거 아직도?」', '숫자 훅(근거)', '결과물 실물/화면'], ['photoreal', 'motion_graphics'], ['누구의 어떤 문제를 푸는지', '결과물·레퍼런스(공개 가능한 것)'], ['고객사 로고 무단 사용'], 'calm'),
+    local_service: P('local_service', '지역 서비스(음식점·미용·학원·병원 외)', ['ugc_selfie', 'lifestyle', 'product_hero'], ['매장 첫 장면 + 대표 메뉴/서비스', '사장님 한마디', '「○○역 3분」(사이트 근거)'], ['photoreal', 'ugc'], ['실제 매장·서비스 장면', '위치·영업시간'], ['가짜 후기'], 'lively'),
+    automotive: P('automotive', '자동차·모빌리티', ['cinematic', 'product_hero', 'lifestyle'], ['주행 첫 컷 → 디테일', '「월 ○○원」(실제 조건)'], ['photoreal', '3d'], ['외관·실내·주행'], ['안전 과장', '경쟁 모델 비방'], 'bold'),
+    fitness: P('fitness', '피트니스·운동·다이어트', ['ugc_selfie', 'lifestyle', 'text_hook'], ['운동 동작 첫 컷', '루틴 셀카', '「하루 10분」(프로그램 근거)'], ['photoreal', 'ugc'], ['운동 장면·프로그램'], ['전후 몸매 비교', '체중 감량 단정', '신체 수치 지칭'], 'bold'),
+    other: P('other', '기타', ['ugc_selfie', 'cinematic', 'text_hook'], ['질문 훅', '결과물 첫 장면', '한 문장 약속(근거)'], ['photoreal', 'ugc'], ['무엇을 파는지 3초 안에'], ['과장·최상급'], 'lively'),
+};
+export const INDUSTRY_KEYS = Object.keys(INDUSTRIES);
+export function playbookFor(industry) { return INDUSTRIES[industry || ''] || INDUSTRIES.other; }
+/** 이 브리프에 맞는 영상 포맷 n개 — 플레이북 순서를 따르되 장르(anime 등)·화면 유무를 반영 · 항상 서로 다른 포맷 */
+export function pickFormats(o) {
+    if (o.requested?.length)
+        return [...new Set(o.requested)].slice(0, Math.max(1, o.count));
+    const pb = playbookFor(o.industry);
+    let order = [...pb.formats, 'cinematic', 'ugc_selfie', 'text_hook', 'product_hero', 'lifestyle'];
+    if (!o.hasScreens)
+        order = order.filter((f) => f !== 'ui_demo');
+    const anime = (o.genres || []).includes('anime') || (o.genres || []).includes('3d');
+    if (anime && !order.slice(0, 2).includes('cinematic'))
+        order = ['cinematic', ...order.filter((f) => f !== 'cinematic')];
+    return [...new Set(order)].slice(0, Math.max(1, o.count));
+}
+/** 장르 → 이미지/영상 프롬프트 스타일 토큰 */
+export const GENRE_STYLE = {
+    photoreal: 'photorealistic, natural skin and materials, shot on a modern mirrorless camera, realistic lighting',
+    ugc: 'authentic user-generated smartphone footage look, handheld, natural indoor light, real-person casual vibe, no studio polish',
+    anime: 'high-quality Japanese anime style, clean linework, vivid cel shading, dramatic sky and light, studio-quality animation',
+    '3d': 'stylized 3D render, soft global illumination, Pixar-like character appeal, clean materials',
+    illustration: 'flat editorial illustration, bold shapes, limited palette, tasteful texture',
+    motion_graphics: 'kinetic typography and motion graphics, clean vector shapes, brand colors, smooth easing',
+    product_shot: 'studio product photography, macro detail, controlled lighting, clean backdrop',
+};
+export const genreStyle = (g) => GENRE_STYLE[g || ''] || GENRE_STYLE.photoreal;

package/dist/core/creatives/render.d.ts

@@ -1,11 +1,16 @@
 import type { Brief, Concept, CreativeAsset } from '../state.js';
 import { type Size } from './specs.js';
-export declare function loadFonts(): Promise<{
+export declare const FONT_FAMILY = "Pretendard, PretendardJP, NotoCJKtc, NotoCJKsc, NotoThai";
+export declare function loadFonts(lang?: string): Promise<{
     name: string;
     data: ArrayBuffer;
     weight: 400 | 500 | 700 | 800;
     style: 'normal';
 }[]>;
+/** 🔴 확장자가 아니라 바이트로 MIME 판별 — Gemini 이미지 API 는 .png 요청에도 JPEG 를 돌려준다(2026-09-16 실측 · 잘못된 MIME 이면 satori 가 배경을 조용히 버림) */
+export declare function sniffMime(buf: Buffer): string;
+declare const dataUri: (file: string) => string;
+export { dataUri };
 type El = {
     type: string;
     props: Record<string, unknown>;
@@ -22,4 +27,20 @@ export declare function renderConcept(dir: string, brief: Brief, concept: Concep
 }): Promise<CreativeAsset[]>;
 /** 구글 RDA 로고 자산 — 사이트 로고가 있으면 그것을, 없으면 회사명 텍스트 로고를 1:1(512)·4:1(1200×300)로 만든다 */
 export declare function renderLogo(dir: string, brief: Brief): Promise<CreativeAsset[]>;
-export {};
+/** 영상 자막 오버레이 — 투명 PNG(영상 크기) 에 하단 자막 알약 또는 CTA 버튼. ffmpeg drawtext(폰트 빌드 의존) 대신 satori 로 그린다. */
+export declare function renderOverlay(file: string, w: number, hh: number, text: string, o: {
+    kind: 'line' | 'cta' | 'hook';
+    primary: string;
+    lang?: string;
+}): Promise<string>;
+/** UI 데모용 배경(브랜드 그래디언트 · 영상 크기) + 폰 프레임(투명 화면 영역) — ffmpeg 가 스크린샷을 그 사이에 끼운다 */
+export declare function renderPhoneStage(dir: string, w: number, hh: number, primary: string, dark: string): Promise<{
+    bg: string;
+    frame: string;
+    screen: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}>;

package/dist/core/creatives/render.js

@@ -9,7 +9,35 @@ import { HOME } from '../state.js';
 import { SIZES } from './specs.js';
 const FONT_CDN = 'https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard/dist/public/static';
 const WEIGHTS = [['Pretendard-ExtraBold', 800], ['Pretendard-Bold', 700], ['Pretendard-Medium', 500]];
-export async function loadFonts() {
+/** 언어별 글꼴 폴백 — Pretendard 는 한글·라틴만. 일본어=Pretendard JP(가나·한자) · 중국어=Noto Sans TC/SC · 태국어=Noto Sans Thai. 같은 family 이름으로 넣어 satori 가 빠진 글리프를 다음 글꼴에서 찾게 한다. */
+// 🔴 satori 는 같은 family 이름 안에서는 글리프 폴백을 안 한다(2026-09-16 실측 · 한자 tofu) → 언어별 글꼴은 다른 family 이름으로 넣고 fontFamily 목록으로 폴백
+const EXTRA_FONTS = {
+    ja: [['https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard-jp/dist/public/static/PretendardJP-ExtraBold.otf', 'PretendardJP-ExtraBold.otf', 800, 'PretendardJP'], ['https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard-jp/dist/public/static/PretendardJP-Bold.otf', 'PretendardJP-Bold.otf', 700, 'PretendardJP'], ['https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard-jp/dist/public/static/PretendardJP-Medium.otf', 'PretendardJP-Medium.otf', 500, 'PretendardJP']],
+    'zh-TW': [['https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/OTF/TraditionalChinese/NotoSansCJKtc-Bold.otf', 'NotoSansCJKtc-Bold.otf', 700, 'NotoCJKtc']],
+    zh: [['https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/OTF/SimplifiedChinese/NotoSansCJKsc-Bold.otf', 'NotoSansCJKsc-Bold.otf', 700, 'NotoCJKsc']],
+    th: [['https://cdn.jsdelivr.net/gh/notofonts/notofonts.github.io@main/fonts/NotoSansThai/full/ttf/NotoSansThai-Bold.ttf', 'NotoSansThai-Bold.ttf', 700, 'NotoThai']],
+};
+export const FONT_FAMILY = 'Pretendard, PretendardJP, NotoCJKtc, NotoCJKsc, NotoThai';
+const fontCache = new Map();
+async function fetchFont(dir, url, file) {
+    const p = path.join(dir, file);
+    if (!fs.existsSync(p)) {
+        try {
+            const res = await fetch(url, { signal: AbortSignal.timeout(90_000) });
+            if (!res.ok)
+                return null;
+            fs.writeFileSync(p, Buffer.from(await res.arrayBuffer()));
+        }
+        catch {
+            return null;
+        }
+    }
+    return fs.readFileSync(p);
+}
+export async function loadFonts(lang) {
+    const key = lang ? (EXTRA_FONTS[lang] ? lang : EXTRA_FONTS[lang.split('-')[0]] ? lang.split('-')[0] : '') : '';
+    if (fontCache.has(key))
+        return fontCache.get(key);
     const dir = path.join(HOME, 'fonts');
     fs.mkdirSync(dir, { recursive: true });
     const out = [];
@@ -26,9 +54,22 @@ export async function loadFonts() {
         const buf = fs.readFileSync(p);
         out.push({ name: 'Pretendard', data: buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength), weight: weight, style: 'normal' });
     }
+    for (const [url, file, weight, family] of EXTRA_FONTS[key] || []) {
+        const buf = await fetchFont(dir, url, file);
+        if (buf)
+            out.push({ name: family, data: buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength), weight: weight, style: 'normal' });
+    }
+    fontCache.set(key, out);
     return out;
 }
-const dataUri = (file) => { const ext = path.extname(file).slice(1).toLowerCase(); return `data:image/${ext === 'jpg' ? 'jpeg' : ext};base64,${fs.readFileSync(file).toString('base64')}`; };
+/** 🔴 확장자가 아니라 바이트로 MIME 판별 — Gemini 이미지 API 는 .png 요청에도 JPEG 를 돌려준다(2026-09-16 실측 · 잘못된 MIME 이면 satori 가 배경을 조용히 버림) */
+export function sniffMime(buf) { if (buf[0] === 0x89 && buf[1] === 0x50)
+    return 'image/png'; if (buf[0] === 0xff && buf[1] === 0xd8)
+    return 'image/jpeg'; if (buf.subarray(0, 4).toString() === 'RIFF' && buf.subarray(8, 12).toString() === 'WEBP')
+    return 'image/webp'; if (/^\s*<(\?xml|svg)/.test(buf.subarray(0, 100).toString()))
+    return 'image/svg+xml'; return 'image/png'; }
+const dataUri = (file) => { const buf = fs.readFileSync(file); return `data:${sniffMime(buf)};base64,${buf.toString('base64')}`; };
+export { dataUri };
 async function fetchLogo(url, dir) {
     if (!url)
         return null;
@@ -107,7 +148,7 @@ export function tree(size, concept, brief, bg, logo, ctaText) {
             banner ? h('div', {}, '') : h('div', { display: 'flex', justifyContent: 'space-between', fontSize: Math.round(headFs * 0.28), fontWeight: 500, color: sub }, [h('div', {}, brief.company), h('div', {}, domain)]),
         ]));
     }
-    return h('div', { width: w, height: hh, display: 'flex', position: 'relative', overflow: 'hidden', fontFamily: 'Pretendard', backgroundColor: dark ? brief.palette.dark : brief.palette.light, ...bgStyle }, children);
+    return h('div', { width: w, height: hh, display: 'flex', position: 'relative', overflow: 'hidden', fontFamily: FONT_FAMILY, backgroundColor: dark ? brief.palette.dark : brief.palette.light, ...bgStyle }, children);
 }
 export const CTA_LABEL = {
     ko: { LEARN_MORE: '자세히 보기', SIGN_UP: '지금 시작하기', SHOP_NOW: '지금 구매', CONTACT_US: '문의하기', DOWNLOAD: '내려받기', GET_OFFER: '혜택 받기', GET_QUOTE: '견적 받기', SUBSCRIBE: '구독하기', APPLY_NOW: '지금 신청', ORDER_NOW: '지금 주문', BUY_NOW: '지금 구매', BOOK_TRAVEL: '예약하기' },
@@ -117,7 +158,7 @@ export const CTA_LABEL = {
 export function ctaLabel(cta, lang) { return CTA_LABEL[lang]?.[cta] || CTA_LABEL.en[cta] || CTA_LABEL.en.LEARN_MORE; }
 /** 컨셉 하나를 12규격으로 렌더 → 파일 목록. 이미 있는 파일은 건너뜀(--force로 다시). */
 export async function renderConcept(dir, brief, concept, backgrounds, opts = {}) {
-    const fonts = await loadFonts();
+    const fonts = await loadFonts(brief.language);
     const logo = await fetchLogo(brief.logoUrl, dir);
     const out = [];
     const ctaText = ctaLabel(concept.cta, brief.language);
@@ -145,7 +186,7 @@ export async function renderLogo(dir, brief) {
     for (const [w, hh] of [[512, 512], [1200, 300]]) {
         const file = path.join(dir, `_logo_${w}x${hh}.png`);
         if (!fs.existsSync(file)) {
-            const el = h('div', { width: w, height: hh, display: 'flex', alignItems: 'center', justifyContent: 'center', backgroundColor: brief.palette.primary, fontFamily: 'Pretendard' }, [
+            const el = h('div', { width: w, height: hh, display: 'flex', alignItems: 'center', justifyContent: 'center', backgroundColor: brief.palette.primary, fontFamily: FONT_FAMILY }, [
                 logo ? h('img', { height: Math.round(hh * 0.5) }, undefined, { src: logo }) : h('div', { fontSize: Math.round(Math.min(w, hh) * (w === hh ? 0.16 : 0.42)), fontWeight: 800, color: '#fff', letterSpacing: -1, whiteSpace: 'nowrap' }, brief.company.slice(0, 16)),
             ]);
             const svg = await satori(el, { width: w, height: hh, fonts });
@@ -155,3 +196,37 @@ export async function renderLogo(dir, brief) {
     }
     return out;
 }
+/** 영상 자막 오버레이 — 투명 PNG(영상 크기) 에 하단 자막 알약 또는 CTA 버튼. ffmpeg drawtext(폰트 빌드 의존) 대신 satori 로 그린다. */
+export async function renderOverlay(file, w, hh, text, o) {
+    const fonts = await loadFonts(o.lang);
+    const base = Math.min(w, hh);
+    const fs1 = Math.round(base * (o.kind === 'cta' ? 0.055 : 0.068));
+    const pill = o.kind === 'cta'
+        ? h('div', { display: 'flex', fontSize: fs1, fontWeight: 700, color: '#fff', backgroundColor: o.primary, borderRadius: 999, padding: `${Math.round(fs1 * 0.55)}px ${Math.round(fs1 * 1.3)}px`, boxShadow: `0 10px 30px ${hexA(o.primary, 0.45)}` }, text)
+        : h('div', { display: 'flex', fontSize: fs1, fontWeight: 800, color: '#fff', backgroundColor: 'rgba(11,21,38,.62)', borderRadius: Math.round(fs1 * 0.4), padding: `${Math.round(fs1 * 0.35)}px ${Math.round(fs1 * 0.6)}px`, lineHeight: 1.25, letterSpacing: -1, textAlign: 'center', maxWidth: Math.round(w * 0.86), wordBreak: 'keep-all' }, text);
+    // 안전영역: 릴스·쇼츠 UI 가 하단 ~20%·우측 ~10% 를 가린다 → 자막은 상단 1/3(훅) 또는 하단 25~30% 선. 훅은 크고 브랜드색 하이라이트.
+    const hook = o.kind === 'hook';
+    const hookEl = h('div', { display: 'flex', fontSize: Math.round(base * 0.095), fontWeight: 800, color: '#fff', lineHeight: 1.12, letterSpacing: -1.5, textAlign: 'center', maxWidth: Math.round(w * 0.86), wordBreak: 'keep-all', textShadow: '0 4px 24px rgba(0,0,0,.65), 0 1px 2px rgba(0,0,0,.8)', backgroundColor: hexA(o.primary, 0.92), padding: `${Math.round(base * 0.035)}px ${Math.round(base * 0.05)}px`, borderRadius: Math.round(base * 0.03), transform: 'rotate(-2deg)' }, text);
+    const el = hook
+        ? h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-start', justifyContent: 'center', paddingTop: Math.round(hh * 0.14), fontFamily: FONT_FAMILY }, [hookEl])
+        : h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-end', justifyContent: 'center', paddingBottom: Math.round(hh * (o.kind === 'cta' ? 0.12 : 0.24)), fontFamily: FONT_FAMILY }, [pill]);
+    const svg = await satori(el, { width: w, height: hh, fonts });
+    fs.writeFileSync(file, new Resvg(svg, { fitTo: { mode: 'width', value: w } }).render().asPng());
+    return file;
+}
+/** UI 데모용 배경(브랜드 그래디언트 · 영상 크기) + 폰 프레임(투명 화면 영역) — ffmpeg 가 스크린샷을 그 사이에 끼운다 */
+export async function renderPhoneStage(dir, w, hh, primary, dark) {
+    const fonts = await loadFonts();
+    const sw = Math.round(w * 0.62);
+    const sh = Math.round(sw * 2.05);
+    const sx = Math.round((w - sw) / 2);
+    const sy = Math.round((hh - sh) / 2);
+    const bgSvg = await satori(h('div', { width: w, height: hh, display: 'flex', backgroundImage: `linear-gradient(160deg, ${dark} 0%, ${hexA(primary, 0.75)} 100%)`, fontFamily: FONT_FAMILY }, ''), { width: w, height: hh, fonts });
+    const bg = path.join(dir, `stage_bg_${w}x${hh}.png`);
+    fs.writeFileSync(bg, new Resvg(bgSvg).render().asPng());
+    const bezel = Math.round(sw * 0.045);
+    const frameSvg = `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${hh}"><defs><mask id="m"><rect width="${w}" height="${hh}" fill="#fff"/><rect x="${sx}" y="${sy}" width="${sw}" height="${sh}" rx="${Math.round(sw * 0.11)}" fill="#000"/></mask></defs><rect x="${sx - bezel}" y="${sy - bezel}" width="${sw + bezel * 2}" height="${sh + bezel * 2}" rx="${Math.round(sw * 0.14)}" fill="#0b0f18" mask="url(#m)"/><rect x="${sx - bezel}" y="${sy - bezel}" width="${sw + bezel * 2}" height="${sh + bezel * 2}" rx="${Math.round(sw * 0.14)}" fill="none" stroke="rgba(255,255,255,.18)" stroke-width="3"/><rect x="${sx + sw * 0.32}" y="${sy + bezel * 0.35}" width="${sw * 0.36}" height="${bezel * 0.9}" rx="${bezel * 0.45}" fill="#0b0f18"/></svg>`;
+    const frame = path.join(dir, `stage_frame_${w}x${hh}.png`);
+    fs.writeFileSync(frame, new Resvg(frameSvg).render().asPng());
+    return { bg, frame, screen: { x: sx, y: sy, w: sw, h: sh } };
+}

package/dist/core/creatives/siteshots.d.ts

@@ -0,0 +1,9 @@
+export declare function chromeBin(): string | null;
+/** 모바일 폭(390) 긴 스크린샷 PNG. 실패하면 null(호출자가 이미지 폴백). */
+export declare function screenshotSite(url: string, file: string, o?: {
+    width?: number;
+    height?: number;
+    timeoutMs?: number;
+}): Promise<string | null>;
+/** 사이트 이미지 URL 들을 내려받아 유효한(≥300px 추정 · png/jpg/webp) 파일만 반환 */
+export declare function downloadSiteImages(urls: string[], dir: string, max?: number): Promise<string[]>;

package/dist/core/creatives/siteshots.js

@@ -0,0 +1,53 @@
+// 사이트 실제 화면·이미지 확보 — ui_demo 포맷과 참고 이미지(제품 일관성)에 쓴다.
+//   1) 헤드리스 크로미움 스크린샷(모바일 폭 · 긴 페이지) — 바이너리: CHROME_BIN > alpine chromium-browser/chromium > macOS Chrome. 없으면 건너뜀.
+//   2) 사이트 본문 이미지(og:image·큰 <img>) 내려받기 — 생성 이미지의 참고(/edits)로.
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { sniffMime } from './render.js';
+const execFileP = promisify(execFile);
+export function chromeBin() {
+    const cands = [process.env.CHROME_BIN, '/usr/bin/chromium-browser', '/usr/bin/chromium', '/usr/bin/google-chrome', '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Chromium.app/Contents/MacOS/Chromium'].filter(Boolean);
+    return cands.find((c) => fs.existsSync(c)) || null;
+}
+/** 모바일 폭(390) 긴 스크린샷 PNG. 실패하면 null(호출자가 이미지 폴백). */
+export async function screenshotSite(url, file, o = {}) {
+    const bin = chromeBin();
+    if (!bin)
+        return null;
+    const w = o.width || 390, h = o.height || 2200;
+    try {
+        await execFileP(bin, ['--headless=new', '--disable-gpu', '--no-sandbox', '--disable-dev-shm-usage', '--hide-scrollbars', '--force-device-scale-factor=2', `--window-size=${w},${h}`, '--virtual-time-budget=8000', `--screenshot=${file}`, url], { timeout: o.timeoutMs || 45_000, maxBuffer: 8 << 20 });
+        if (!fs.existsSync(file) || fs.statSync(file).size < 5000)
+            return null;
+        return file;
+    }
+    catch {
+        return null;
+    }
+}
+/** 사이트 이미지 URL 들을 내려받아 유효한(≥300px 추정 · png/jpg/webp) 파일만 반환 */
+export async function downloadSiteImages(urls, dir, max = 4) {
+    const out = [];
+    for (const u of urls) {
+        if (out.length >= max)
+            break;
+        try {
+            const r = await fetch(u, { signal: AbortSignal.timeout(15_000), headers: { 'user-agent': 'Mozilla/5.0 (compatible; ADYou/0.4)' } });
+            if (!r.ok)
+                continue;
+            const buf = Buffer.from(await r.arrayBuffer());
+            if (buf.length < 8_000 || buf.length > 15_000_000)
+                continue;
+            const mime = sniffMime(buf);
+            if (!/png|jpeg|webp/.test(mime))
+                continue;
+            const f = path.join(dir, `site_${out.length}.${mime.split('/')[1] === 'jpeg' ? 'jpg' : mime.split('/')[1]}`);
+            fs.writeFileSync(f, buf);
+            out.push(f);
+        }
+        catch { /* 다음 */ }
+    }
+    return out;
+}

package/dist/core/creatives/storyboard.d.ts

@@ -0,0 +1,70 @@
+import type { Brief, Concept, Goal } from '../state.js';
+import { type Tone, type VideoFormat } from './playbook.js';
+export type Clip = {
+    sec: number;
+    kind: 'gen' | 'ui_demo';
+    prompt: string;
+    speech?: string;
+};
+export type Storyboard = {
+    id: string;
+    format: VideoFormat;
+    genre: string;
+    hook: string;
+    captions: string[];
+    voice?: string;
+    music: string;
+    cta: string;
+    durationSec: number;
+    clips: Clip[];
+    score?: number;
+    scoreNote?: string;
+    lang: string;
+};
+export type LocalizedBoard = {
+    hook: string;
+    captions: string[];
+    voice?: string;
+};
+export type LocalizedCopy = {
+    headlines: string[];
+    bodies: string[];
+    descriptions: string[];
+    boards?: Record<string, LocalizedBoard>;
+};
+export type I18n = Record<string, LocalizedCopy>;
+export declare const langName: (l: string) => string;
+/** 훅 길이 제한 — 한글·전각 12자(wlen 24) · 라틴은 단어 경계에서 자른다(잘린 단어 금지) */
+export declare function fitHook(t: string): string;
+/** 포맷별 클립 구성 규칙 — 8초: UGC 1×8(발화) · 시네마틱/라이프스타일 2×4(훅→보상) · ui_demo 4(훅 gen)+4(화면) · 제품 1×8 · text_hook 2×4. 15/30초는 1클립 다중 장면 */
+export declare function clipPlan(format: VideoFormat, durationSec: number, hasScreens: boolean): {
+    sec: number;
+    kind: 'gen' | 'ui_demo';
+}[];
+export declare function generateStoryboards(brief: Brief, concept: Concept, o: {
+    formats: VideoFormat[];
+    durationSec: number;
+    tone: Tone;
+    goal: Goal;
+    hasScreens: boolean;
+    lang?: string;
+}): Promise<Storyboard[]>;
+/** 채점 — 훅 강도·3초 명료성·정책 위험·브랜드 적합·타겟 적합(각 0~10) → 평균. 정책 위험은 규칙 검사(policyIssues)로 먼저 깎는다. */
+export declare function judgeStoryboards(brief: Brief, boards: Storyboard[]): Promise<Storyboard[]>;
+/** 콘티 생성 + 채점 + 약한 포맷 1회 재작성 → 점수순 */
+export declare function planStoryboards(brief: Brief, concept: Concept, o: {
+    formats: VideoFormat[];
+    durationSec: number;
+    tone: Tone;
+    goal: Goal;
+    hasScreens: boolean;
+    lang?: string;
+    log?: (s: string) => void;
+    minScore?: number;
+}): Promise<Storyboard[]>;
+/** 시장 언어별 문구·자막·훅·대사 번역 — 뜻·사실 유지 · 규격 맞춤 */
+export declare function translateCopy(brief: Brief, concept: Concept, boards: Storyboard[], langs: string[]): Promise<I18n>;
+/** 언어별 콘티 자막/훅 꺼내기(없으면 원문) */
+export declare function localizedBoard(b: Storyboard, i18n: I18n | undefined, lang: string): LocalizedBoard;
+/** 언어별 컨셉(문구 치환) — 이미지 렌더·매체 카피에 */
+export declare function localizedConcept(c: Concept, i18n: I18n | undefined, lang: string): Concept;

package/dist/core/creatives/storyboard.js

@@ -0,0 +1,149 @@
+// 콘티(스토리보드) — 컨셉 × 포맷마다 「훅(0~2초) → 증명/보상 → 행동」 3박자 대본을 LLM 이 쓰고, 채점(훅 강도·명료성·정책·브랜드 적합)으로 약한 것을 걸러낸다.
+// 영상 크레딧을 쓰기 전 텍스트 단계에서 품질을 올리는 것이 목적(비용 거의 0). 시장 언어별 번역(i18n)도 여기서.
+import { z } from 'zod';
+import { aiAvailable, completeJson } from '../llm.js';
+import { ctaLabel } from './render.js';
+import { FORMAT_DESC, genreStyle, playbookFor, TONE_WORDS } from './playbook.js';
+import { fit, GOOGLE_LIMITS, policyIssues, wlen } from './specs.js';
+const BoardSchema = z.object({
+    format: z.string(), genre: z.string().optional(), hook: z.string(), captions: z.array(z.string()).min(1).max(5), voice: z.string().optional().nullable(), music: z.string().optional(),
+    clips: z.array(z.object({ sec: z.number(), kind: z.enum(['gen', 'ui_demo']).default('gen'), prompt: z.string(), speech: z.string().optional().nullable() })).min(1).max(3),
+});
+const LANG_NAME = { ko: 'Korean', en: 'English', ja: 'Japanese', 'zh-TW': 'Traditional Chinese', zh: 'Chinese', de: 'German', fr: 'French', es: 'Spanish', vi: 'Vietnamese', th: 'Thai', id: 'Indonesian', pt: 'Portuguese', it: 'Italian', nl: 'Dutch' };
+export const langName = (l) => LANG_NAME[l] || LANG_NAME[l.split('-')[0]] || l;
+/** 훅 길이 제한 — 한글·전각 12자(wlen 24) · 라틴은 단어 경계에서 자른다(잘린 단어 금지) */
+export function fitHook(t) {
+    const s = t.trim().replace(/\s+/g, ' ');
+    if (wlen(s) <= 26)
+        return s;
+    if (/[\u3000-\u9fff\uac00-\ud7af]/.test(s))
+        return fit(s, 26);
+    const words = s.split(' ');
+    let out = '';
+    for (const w of words) {
+        if ((out + ' ' + w).trim().length > 34)
+            break;
+        out = (out + ' ' + w).trim();
+    }
+    return out || fit(s, 30);
+}
+/** 포맷별 클립 구성 규칙 — 8초: UGC 1×8(발화) · 시네마틱/라이프스타일 2×4(훅→보상) · ui_demo 4(훅 gen)+4(화면) · 제품 1×8 · text_hook 2×4. 15/30초는 1클립 다중 장면 */
+export function clipPlan(format, durationSec, hasScreens) {
+    if (durationSec > 8)
+        return [{ sec: durationSec, kind: 'gen' }];
+    if (format === 'ugc_selfie' || format === 'product_hero')
+        return [{ sec: 8, kind: 'gen' }];
+    if (format === 'ui_demo')
+        return hasScreens ? [{ sec: 4, kind: 'gen' }, { sec: 4, kind: 'ui_demo' }] : [{ sec: 8, kind: 'gen' }];
+    return [{ sec: 4, kind: 'gen' }, { sec: 4, kind: 'gen' }];
+}
+export async function generateStoryboards(brief, concept, o) {
+    const lang = o.lang || brief.language;
+    const cta = ctaLabel(concept.cta, lang);
+    const pb = playbookFor(brief.industry);
+    const genres = brief.visualGenres?.length ? brief.visualGenres : pb.genres;
+    const tone = TONE_WORDS[o.tone];
+    const plans = o.formats.map((f) => ({ format: f, clips: clipPlan(f, o.durationSec, o.hasScreens) }));
+    if (!aiAvailable())
+        return plans.map((p) => fallbackBoard(brief, concept, p.format, p.clips, genres[0], cta, lang, o.durationSec));
+    const out = await completeJson({
+        schema: z.object({ boards: z.array(BoardSchema).min(1) }), maxTokens: 7000, timeoutMs: 150_000,
+        system: `너는 퍼포먼스 광고 크리에이티브 디렉터다. 주어진 광고 컨셉을 포맷별 짧은 영상 콘티로 만든다. 목표: 첫 1~2초 안에 손가락을 멈추게 하고(훅), 3초 안에 무엇인지 보이고, 마지막에 행동을 시킨다.
+업종 플레이북(${pb.label}): 포맷 우선 ${pb.formats.join('·')} · 훅 패턴 ${pb.hooks.join(' / ')} · 꼭 보일 것 ${pb.musts.join('·')} · 피할 것 ${pb.avoid.join('·')}.
+비주얼 장르(우선순위): ${genres.join(' > ')} — ${genres.map((g) => `${g}=${genreStyle(g)}`).join(' | ')}. 애니(anime)는 브랜드가 애니·게임·웹툰일 때만 쓴다.
+톤: ${o.tone} → 카메라 「${tone.camera}」 · 음악 「${tone.music}」 · 자막 ${tone.caption}.
+포맷 정의: ${o.formats.map((f) => `${f}=${FORMAT_DESC[f]}`).join(' | ')}.
+클립 구성(포맷별 고정 · 초 수를 지켜라): ${plans.map((p) => `${p.format}: ${p.clips.map((c) => `${c.sec}s ${c.kind}`).join(' + ')}`).join(' / ')}.
+규칙:
+- boards 는 요청 포맷마다 정확히 1개. 각 board: format · genre(위 장르 중 하나) · hook(첫 프레임 큰 글자 · ${lang} · 6단어/12자 이내 · 질문/숫자/반전) · captions(화면 자막 3줄 · ${lang} · 각 18자 이내 · 훅→가치/증명→행동 순 · 마지막 줄은 행동 유도) · voice(선택 · ${lang} 한 문장 내레이션/대사) · music(영어 한 줄).
+- clips[].prompt 는 영어 영상 생성 프롬프트(80~160단어): 피사체·동작·카메라·조명·장르 스타일 토큰·첫 프레임에서 바로 움직임이 시작됨. 사람은 브리프 타겟(${JSON.stringify(brief.audienceProfile || {})})과 어울리는 가상의 인물로, 실존 인물·유명인·타사 로고·화면 글자·자막 금지("no on-screen text, no subtitles, no logos" 로 끝낸다). 소리 지시(음악·효과음) 한 줄 포함.
+- ugc_selfie 클립: 인물이 스마트폰 셀카로 카메라를 보며 ${langName(lang)} 로 speech 를 말한다 — speech 는 8초에 맞는 한 문장(${lang}) · 프롬프트에 "speaking to camera in ${langName(lang)}: '<speech>'" 형태로 포함 · 립싱크 자연스럽게 · 실제 후기 톤(대본 읽는 느낌 금지).
+- ui_demo 클립(kind=ui_demo)은 prompt 대신 화면에 얹을 설명 한 줄(${lang})만 쓴다(실제 사이트 화면을 우리가 넣는다).
+- 사실은 브리프(usp·proofPoints·offer)에 있는 것만. 과장·최상급·보장·전후비교·개인 속성 지칭 금지. ${brief.notes ? `주의: ${brief.notes}` : ''}
+- 출력 JSON: {"boards":[{format,genre,hook,captions[],voice,music,clips:[{sec,kind,prompt,speech}]}]}`,
+        user: JSON.stringify({ brief: { company: brief.company, offer: brief.offer, category: brief.category, industry: brief.industry, audience: brief.audience, audienceProfile: brief.audienceProfile, usp: brief.usp, proofPoints: brief.proofPoints, tone: brief.tone, language: lang, palette: brief.palette }, concept: { key: concept.key, name: concept.name, angle: concept.angle, headline: concept.headlines[0], body: concept.bodies[0], imagePrompt: concept.imagePrompt }, goal: o.goal, cta, durationSec: o.durationSec, formats: o.formats }),
+    });
+    const boards = [];
+    for (const p of plans) {
+        const b = out.boards.find((x) => x.format === p.format) || out.boards[boards.length];
+        if (!b) {
+            boards.push(fallbackBoard(brief, concept, p.format, p.clips, genres[0], cta, lang, o.durationSec));
+            continue;
+        }
+        const clips = p.clips.map((pc, i) => { const src = b.clips[i] || b.clips[b.clips.length - 1]; return { sec: pc.sec, kind: pc.kind, prompt: (src?.prompt || '').trim(), speech: src?.speech || undefined }; });
+        boards.push({ id: `${concept.key}_${p.format}`, format: p.format, genre: p.format === 'ugc_selfie' ? 'ugc' : (b.genre && genres.includes(b.genre) ? b.genre : genres[0]) || 'photoreal', hook: fitHook(b.hook), captions: b.captions.map((c) => c.trim()).filter(Boolean).slice(0, 3), voice: b.voice || undefined, music: b.music || tone.music, cta, durationSec: o.durationSec, clips, lang });
+    }
+    return boards;
+}
+function fallbackBoard(brief, concept, format, plan, genre, cta, lang, durationSec) {
+    const style = genreStyle(genre);
+    const base = concept.videoPrompt || `A short advertisement scene inspired by: ${concept.imagePrompt}.`;
+    const clips = plan.map((p, i) => p.kind === 'ui_demo' ? { sec: p.sec, kind: 'ui_demo', prompt: concept.headlines[0] } : { sec: p.sec, kind: 'gen', prompt: `${i === 0 ? 'Opening hook shot with immediate motion: ' : 'Payoff shot: '}${base} ${style}. Upbeat modern music. No on-screen text, no subtitles, no logos.` });
+    return { id: `${concept.key}_${format}`, format, genre: format === 'ugc_selfie' ? 'ugc' : genre, hook: fitHook(concept.headlines[0] || brief.company), captions: (concept.videoLines?.length ? concept.videoLines : [concept.headlines[0], concept.bodies[0]?.slice(0, 18) || '', cta]).filter(Boolean).slice(0, 3), music: 'upbeat modern music', cta, durationSec, clips, lang };
+}
+/** 채점 — 훅 강도·3초 명료성·정책 위험·브랜드 적합·타겟 적합(각 0~10) → 평균. 정책 위험은 규칙 검사(policyIssues)로 먼저 깎는다. */
+export async function judgeStoryboards(brief, boards) {
+    const ruleHit = (b) => policyIssues([b.hook, ...b.captions, b.voice || ''].join(' ')).length;
+    if (!aiAvailable())
+        return boards.map((b) => ({ ...b, score: Math.max(0, 7 - ruleHit(b) * 3), scoreNote: ruleHit(b) ? '정책 표현 감지' : '규칙 채점' }));
+    const out = await completeJson({
+        schema: z.object({ scores: z.array(z.object({ id: z.string(), hook: z.number(), clarity: z.number(), policy: z.number(), fit: z.number(), target: z.number(), note: z.string().optional() })) }), maxTokens: 2500, timeoutMs: 90_000,
+        system: `너는 퍼포먼스 광고 심사관이다. 각 콘티를 0~10 으로 채점한다: hook(첫 1~2초에 멈추게 하나 · 질문/숫자/반전/움직임) · clarity(3초 안에 무엇을 파는지 보이나) · policy(10=안전 · 과장·보장·전후비교·개인속성 지칭·성인 암시가 있으면 크게 깎음) · fit(브랜드 톤·업종·장르 적합 · 애니 브랜드가 아닌데 애니면 깎음) · target(타겟(${JSON.stringify(brief.audienceProfile || brief.audience)})에게 말이 되나). note 는 20자 이내 한 줄. 출력 JSON {"scores":[{id,hook,clarity,policy,fit,target,note}]}`,
+        user: JSON.stringify({ brief: { company: brief.company, offer: brief.offer, industry: brief.industry, usp: brief.usp, tone: brief.tone }, boards: boards.map((b) => ({ id: b.id, format: b.format, genre: b.genre, hook: b.hook, captions: b.captions, voice: b.voice, clips: b.clips.map((c) => c.prompt.slice(0, 300)) })) }),
+    });
+    return boards.map((b) => { const s = out.scores.find((x) => x.id === b.id); const avg = s ? (s.hook + s.clarity + s.policy + s.fit + s.target) / 5 : 6; const pen = ruleHit(b) * 2; return { ...b, score: Math.round(Math.max(0, avg - pen) * 10) / 10, scoreNote: `${s?.note || ''}${pen ? ' · 정책 표현' : ''}`.trim() }; });
+}
+/** 콘티 생성 + 채점 + 약한 포맷 1회 재작성 → 점수순 */
+export async function planStoryboards(brief, concept, o) {
+    const min = o.minScore ?? 6.5;
+    let boards = await judgeStoryboards(brief, await generateStoryboards(brief, concept, o));
+    const weak = boards.filter((b) => (b.score ?? 0) < min);
+    if (weak.length && aiAvailable()) {
+        o.log?.(`  콘티 채점: ${boards.map((b) => `${b.format} ${b.score}`).join(' · ')} → 약한 ${weak.length}개 다시 씀`);
+        const redo = await judgeStoryboards(brief, await generateStoryboards(brief, concept, { ...o, formats: weak.map((w) => w.format) }));
+        boards = boards.map((b) => { const r = redo.find((x) => x.format === b.format); return r && (r.score ?? 0) > (b.score ?? 0) ? r : b; });
+    }
+    o.log?.(`  콘티: ${boards.map((b) => `${b.format}(${b.genre}) ${b.score}점 「${b.hook}」`).join(' · ')}`);
+    return boards.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+}
+/** 시장 언어별 문구·자막·훅·대사 번역 — 뜻·사실 유지 · 규격 맞춤 */
+export async function translateCopy(brief, concept, boards, langs) {
+    const targets = [...new Set(langs.map((l) => l).filter((l) => l.split('-')[0] !== (brief.language || 'ko').split('-')[0]))];
+    const out = {};
+    if (!targets.length)
+        return out;
+    if (!aiAvailable()) {
+        for (const l of targets)
+            out[l] = { headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions };
+        return out;
+    }
+    const r = await completeJson({
+        schema: z.object({ translations: z.record(z.string(), z.object({ headlines: z.array(z.string()), bodies: z.array(z.string()), descriptions: z.array(z.string()), boards: z.array(z.object({ id: z.string(), hook: z.string(), captions: z.array(z.string()), voice: z.string().optional().nullable() })).optional() })) }), maxTokens: 6000, timeoutMs: 150_000,
+        system: `너는 광고 현지화 카피라이터다. 아래 문구·자막·훅·대사를 각 언어로 옮긴다. 직역이 아니라 그 시장 광고에서 자연스러운 표현으로, 뜻·사실·숫자는 그대로. 헤드라인 ≤ ${GOOGLE_LIMITS.headline}자(한글·전각 2자) · 설명 ≤ ${GOOGLE_LIMITS.description}자 · 자막 각 18자(영문 32자) 이내 · 훅 6단어 이내. 브랜드명(${brief.company})은 번역하지 않는다. 출력 JSON {"translations":{"<lang>":{headlines[],bodies[],descriptions[],boards:[{id,hook,captions[],voice}]}}}`,
+        user: JSON.stringify({ sourceLanguage: brief.language, targets: targets.map((t) => `${t} (${langName(t)})`), headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions, boards: boards.map((b) => ({ id: b.id, hook: b.hook, captions: b.captions, voice: b.voice })) }),
+    });
+    for (const l of targets) {
+        const t = r.translations[l] || r.translations[l.split('-')[0]];
+        if (!t)
+            continue;
+        out[l] = { headlines: t.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean), bodies: t.bodies.map((b) => b.trim()).filter(Boolean), descriptions: t.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean) };
+        for (const b of boards) {
+            const tb = t.boards?.find((x) => x.id === b.id);
+            if (tb)
+                out[l].boards = { ...(out[l].boards || {}), [b.id]: { hook: fitHook(tb.hook), captions: tb.captions.slice(0, 3), voice: tb.voice || undefined } };
+        }
+    }
+    return out;
+}
+/** 언어별 콘티 자막/훅 꺼내기(없으면 원문) */
+export function localizedBoard(b, i18n, lang) {
+    const t = i18n?.[lang]?.boards?.[b.id];
+    return t ? { hook: t.hook, captions: t.captions, voice: t.voice } : { hook: b.hook, captions: b.captions, voice: b.voice };
+}
+/** 언어별 컨셉(문구 치환) — 이미지 렌더·매체 카피에 */
+export function localizedConcept(c, i18n, lang) {
+    const t = i18n?.[lang];
+    if (!t)
+        return c;
+    return { ...c, headlines: t.headlines.length ? t.headlines : c.headlines, bodies: t.bodies.length ? t.bodies : c.bodies, descriptions: t.descriptions.length ? t.descriptions : c.descriptions };
+}

package/dist/core/creatives/video.d.ts

@@ -0,0 +1,35 @@
+import { type VideoRatio } from './media.js';
+export type VideoGenInput = {
+    file: string;
+    prompt: string;
+    ratio: VideoRatio;
+    durationSec: number;
+    model: string;
+    resolution?: '720p' | '1080p';
+    audio?: boolean;
+    firstFrame?: string;
+    refs?: string[];
+    negative?: string;
+    log?: (s: string) => void;
+};
+export type VideoGenResult = {
+    file: string;
+    costKrw: number;
+    provider: 'veo' | 'seedance' | 'mock';
+    model: string;
+    durationSec: number;
+    opId?: string;
+};
+export declare function videoConfig(): {
+    veo?: {
+        base: string;
+        key: string;
+    };
+    seedance?: {
+        key: string;
+        base: string;
+    };
+};
+export declare function videoAvailable(provider?: 'veo' | 'seedance'): boolean;
+/** 영상 한 편 — 모델의 공급자로 라우팅. 실패는 예외(fatal 이면 재시도 없이 · costKrw 가 붙어 오면 그만큼은 원가 발생). */
+export declare function generateVideo(i: VideoGenInput): Promise<VideoGenResult>;