kasaframe 0.1.4 → 0.1.6

package/packages/patterns/src/sfx.ts

@@ -0,0 +1,80 @@
+import { cue } from "@kasaframe/core";
+import type { ThemeSlots } from "./types.ts";
+
+// 패턴이 부르는 테마 슬롯에 소리 자리를 단다 — 테마 슬롯도 패턴 기본 슬롯도 같은 자리에서 소리가 나고, 장면·테마 코드는 그대로다
+
+/** 글 찍기 소리 간격(초) — 글자마다 내면 1초에 열 번이 넘어 밀도 상한에 다 잘린다 */
+const TYPE_EVERY = 0.09;
+const TYPE_MAX = 10;
+
+export function withSfx<S extends ThemeSlots>(s: S): S {
+  const out: ThemeSlots = { ...s };
+  if (s.panel)
+    out.panel = (el, o) => {
+      const paint = s.panel!(el, o);
+      return (t) => {
+        cue("appear", t - o.at, { source: `panel:${o.seed}@${o.at.toFixed(3)}`, scene: o.ctx.id, weight: 0.8, minor: true });
+        paint(t);
+      };
+    };
+  if (s.land)
+    out.land = (el, o) => {
+      const style = s.land!(el, o);
+      return (t) => {
+        cue("land", t - o.at, { source: `land:${o.seed}@${o.at.toFixed(3)}`, scene: o.ctx.id });
+        return style(t);
+      };
+    };
+  if (s.write)
+    out.write = (el, o) => {
+      const paint = s.write!(el, o);
+      const n = Math.min(TYPE_MAX, Math.max(1, Math.floor(o.dur / TYPE_EVERY)));
+      return (t) => {
+        const k = Math.floor((t - o.at) / TYPE_EVERY);
+        for (const j of [k - 1, k]) if (j >= 0 && j < n) cue("type", t - o.at - j * TYPE_EVERY, { source: `write:${o.seed}:${j}@${o.at.toFixed(3)}`, scene: o.ctx.id, minor: true });
+        paint(t);
+      };
+    };
+  if (s.drop)
+    out.drop = (el, o) => {
+      const burst = s.drop!(el, o);
+      const at = o.ctx.beats.drop(o.drop);
+      return (t) => {
+        cue("drop", t - at, { source: `slot-drop:${o.drop}`, scene: o.ctx.id });
+        return burst(t);
+      };
+    };
+  return out as S;
+}
+
+/** 쾅 앉는 순간 — kit slam 이 부른다 */
+export const slamCue = (t: number, at: number): void => cue("land", t - at, { source: `slam@${at.toFixed(3)}` });
+
+/** 짚개가 요점(핵심 값)으로 옮겨 가는 순간 딸깍 — 요점만 짚으니 잔소리가 아니다 */
+export const keyCue = (t: number, at: number): void => cue("select", t - at, { source: `glider@${at.toFixed(3)}`, weight: 0.8 });
+
+/** 박마다 훑는 짚개가 주인공(핵심 값)에 닿는 순간 딸깍 — 곁가지에 닿는 것은 잔소리. 첫 정지점은 짚개가 나타나는 자리라 빼고 */
+export function stopCues(t: number, stops: readonly number[], key: (k: number) => boolean = () => true): void {
+  for (let j = 1; j < stops.length - 1; j++)
+    if (t >= stops[j] && t < stops[j] + 0.2) cue("select", t - stops[j], { source: `glider@${stops[j].toFixed(3)}`, weight: 0.8, minor: !key(j) });
+}
+
+/**
+ * 숫자 굴림이 째깍거리는 시각 — 진행도 p(x)(감속)가 k/n 을 지나는 x 에. 빨리 구르는 앞은 촘촘, 앉기 전은 띄엄띄엄(슬롯 머신처럼).
+ * p 는 단조라 이분법으로 거꾸로 푼다
+ */
+export function rollCues(t: number, o: { at: number; dur: number; p: (x: number) => number; n?: number }): void {
+  if (t < o.at || t > o.at + o.dur + 0.2) return;
+  const n = o.n ?? Math.max(3, Math.min(10, Math.round(o.dur / 0.12)));
+  for (let k = 1; k <= n; k++) {
+    let lo = 0;
+    let hi = 1;
+    for (let i = 0; i < 24; i++) {
+      const mid = (lo + hi) / 2;
+      if (o.p(mid) < k / n) lo = mid;
+      else hi = mid;
+    }
+    const at = o.at + hi * o.dur;
+    cue(k === n ? "land" : "tick", t - at, { source: `roll:${k}@${o.at.toFixed(3)}`, weight: k === n ? 0.8 : 0.7, minor: k !== n });
+  }
+}

package/packages/patterns/src/term-reveal/chips.ts

@@ -1,12 +1,13 @@
 import { applyStyle, clamp, spring } from "@kasaframe/core";
 import { fitSize, textEm } from "@kasaframe/motion/moves";
-import { ACCENT_TEXT, area, inverseOver, moving, node, slotsOf } from "../kit.ts";
+import { ACCENT_TEXT, area, dwells, followSpoken, glider, inverseOver, markOf, moving, node, sayTimes, slotsOf } from "../kit.ts";
 import type { TermContent } from "./expand.ts";
 import type { Pattern } from "../types.ts";
 
 /**
  * 용어 해부 — 약자가 큰 판 위에 서고, 풀이 낱말이 박마다 하나씩 판 아래 칩으로 톡 붙는다(첫 글자는 강조색 — 약자 글자와 같은 글자).
  * 다 붙으면 한국어 이름이 판 아래에 찍히고, 판이 아래부터 강조색으로 차올라 장면 끝까지 그 용어를 짚는다.
+ * 테마가 짚는 칸 모양을 정했으면 판을 칠하지 않는다 — 짚개가 약자부터 짚는다(머무는 테마는 목소리가 풀이·한국어 이름을 말할 때만 그리로).
  */
 const pattern: Pattern<TermContent> = {
   id: "term-reveal.chips",
@@ -42,11 +43,15 @@ const pattern: Pattern<TermContent> = {
     const col = node(host, `display:flex;flex-direction:column;align-items:center;gap:${Math.round(h * 0.035)}px`);
     const board = node(col, `position:relative;width:${boardW}px;height:${boardH}px`);
     const panel = slots.panel(board, { ctx, at: 0, seed: `${kit.seed}:board` });
-    const fill = node(board, "position:absolute;inset:0;background:var(--kf-accent);border-radius:var(--kf-radius-md)");
+    const mark = markOf(kit, ctx);
+    const fill = mark ? null : node(board, "position:absolute;inset:0;background:var(--kf-accent);border-radius:var(--kf-radius-md)");
     const face = (lit: boolean) =>
       node(board, `position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-family:var(--kf-font-display);font-size:${termPx}px;font-weight:${ctx.style.type?.weightDisplay ?? 800};letter-spacing:0.04em;color:${lit ? "var(--kf-on-accent)" : "var(--kf-ink)"}`, c.term);
-    face(false);
-    const lit = face(true);
+    const plain = face(false);
+    const lit = mark ? null : face(true);
+    // 짚개가 잴 약자 글 상자 — 판 전체가 아니라 글자에 칸이 앉게
+    const termText = mark ? node(plain, "position:relative", c.term) : null;
+    if (termText) plain.firstChild!.remove();
     kit.stage?.hero(board);
     const row = words.length ? node(col, `display:flex;flex-direction:${vertical ? "column" : "row"};align-items:center;gap:${Math.round(chipPx * 0.35)}px;min-height:${Math.round(chipPx * 1.5)}px`) : null;
     const chips = words.map((wd) => {
@@ -57,17 +62,25 @@ const pattern: Pattern<TermContent> = {
     });
     const koBox = c.ko ? node(col, `position:relative;font-family:var(--kf-font-sans);font-size:${koPx}px;font-weight:700;white-space:nowrap;line-height:1.3;height:1.3em`) : null;
     const ko = koBox ? node(koBox, "color:var(--kf-ink)") : null;
-    const koMark = koBox ? inverseOver(koBox, c.ko!) : null;
+    const koMark = koBox && !mark ? inverseOver(koBox, c.ko!) : null;
+    // 짚개가 이름 자리를 찍히기 전부터 짚는다 — 빈 상자는 폭이 0 이라 칸이 점으로 줄어든다
+    if (koBox && mark) koBox.style.cssText += `;min-width:${Math.round(textEm(c.ko!) * koPx)}px;text-align:center`;
 
-    const hits = kit.hits.length ? kit.hits : [0];
     const boardAt = kit.first ? -0.3 : 0;
-    const chipAt = words.map((_, i) => hits.find((b) => b >= 0.12 + i * 0.3) ?? 0.2 + i * 0.3);
-    const koAt = (chipAt[chipAt.length - 1] ?? 0.2) + 0.3;
+    // 머무는 짚개 테마는 풀이 칩·한국어 이름을 목소리가 그것을 말할 때 붙인다(못 들으면 판이 열린 뒤부터 장면 끝 무렵까지 박에 붙여 고르게) —
+    // 처음에 몰아 띄우면 남은 시간이 빈다. 붙을 때마다 카메라가 그쪽으로 다가간다. 훑는 테마는 0.3초 간격 박에 붙인다(판 차오름이 끝까지 간다)
+    const hits = kit.hits.length ? kit.hits : [0];
+    const times = dwells(kit, ctx) ? sayTimes(kit, [...words, c.ko], 0.12, Math.max(0.6, ctx.dur - 0.9)) : null;
+    const chipAt = words.map((_, i) => times?.[i] ?? hits.find((b) => b >= 0.12 + i * 0.3) ?? 0.2 + i * 0.3);
+    const koAt = c.ko && times ? times[words.length] : (chipAt[chipAt.length - 1] ?? 0.2) + 0.3;
+    followSpoken(kit, ctx, [...chips.map((el, i) => ({ at: chipAt[i], el })), ...(koBox ? [{ at: koAt, el: koBox }] : [])]);
     const koDur = c.ko ? clamp([...c.ko].length * 0.05, 0.25, 0.6) : 0;
     // 판이 열리는 것만으로는 밝은 바탕에서 화면이 바뀐 것으로 안 읽힌다 — 차오름을 곧바로 시작한다
     const fillFrom = 0;
     const writeKo = ko ? slots.write(ko, { ctx, text: c.ko!, at: koAt, dur: koDur, seed: `${kit.seed}:ko` }) : null;
     const lands = chips.map((ch, i) => slots.land(ch, { ctx, at: chipAt[i], seed: `${kit.seed}:c${i}` }));
+    // 판이 열리면 짚개가 약자부터 짚고, 머무는 테마는 목소리가 풀이·한국어 이름을 말할 때만 그리로 옮긴다 — 칠한 판이 차오르던 몫
+    const point = termText ? glider(host, [{ el: termText, text: c.term }, ...(row ? [{ el: row, text: words.join(" ") }] : []), ...(koBox ? [{ el: koBox, text: c.ko }] : [])], { kit, ctx, from: boardAt + 0.2 }) : null;
 
     return (t: number) => {
       moving("term-reveal.chips", ctx);
@@ -81,8 +94,9 @@ const pattern: Pattern<TermContent> = {
       // 판은 칩이 붙기 시작할 때부터 장면 끝까지 차오른다 — 용어를 짚는 몫
       const k = clamp((t - fillFrom) / Math.max(0.3, ctx.dur - fillFrom - 0.05));
       const clip = `inset(${((1 - k) * 100).toFixed(2)}% 0 0 0)`;
-      fill.style.clipPath = clip;
-      lit.style.clipPath = clip;
+      if (fill) fill.style.clipPath = clip;
+      if (lit) lit.style.clipPath = clip;
+      point?.(t);
       writeKo?.(t);
       koMark?.((t - koAt - koDur) / Math.max(0.2, ctx.dur - koAt - koDur - 0.05));
     };

package/packages/patterns/src/term-reveal/expand.ts

@@ -1,6 +1,6 @@
 import { applyStyle, clamp, ease, progress } from "@kasaframe/core";
 import { fitSize, textEm } from "@kasaframe/motion/moves";
-import { ACCENT_TEXT, area, beatStops, fitOnce, glider, moving, node, slotsOf } from "../kit.ts";
+import { ACCENT_TEXT, area, dwells, fitOnce, followSpoken, glider, moving, node, sayTimes, slotsOf } from "../kit.ts";
 import type { Pattern } from "../types.ts";
 
 export interface TermContent {
@@ -21,12 +21,12 @@ function spell(term: string, full: string | undefined): string[] | null {
 
 /**
  * 용어 공개 — 약자가 크게 서고, 약자 글자마다 풀이 낱말이 그 글자에서 아래로 펴져 나온다(글자 → 낱말이 같은 첫 글자로 이어진다).
- * 풀이가 약자와 안 맞으면 풀이 한 줄이 펴진다. 그다음 한국어 이름이 찍히고, 짚개가 약자와 풀이 낱말을 번갈아 박마다 짚는다.
+ * 풀이가 약자와 안 맞으면 풀이 한 줄이 펴진다. 그다음 한국어 이름이 찍히고, 짚개가 약자부터 짚는다(머무는 테마는 목소리가 풀이 낱말·이름을 말할 때만 그리로).
  */
 const pattern: Pattern<TermContent> = {
   id: "term-reveal.expand",
   type: "term-reveal",
-  does: "약자가 서고 글자마다 풀이 낱말이 펴진다, 한국어 이름이 찍히고 짚개가 약자와 풀이를 번갈아 짚는다",
+  does: "약자가 서고 글자마다 풀이 낱말이 펴진다, 한국어 이름이 찍히고 짚개가 약자부터 짚는다",
   energy: ["mid"],
   family: "mask",
   camera: ["none"],
@@ -83,17 +83,21 @@ const pattern: Pattern<TermContent> = {
     // 펴기는 약자가 서자마자 낱말마다 이어서 — 사이에 빈 틈이 있으면 화면이 선 것으로 읽힌다
     const unfoldAt = termAt + 0.06 * Math.max(0, chars.length - 1) + 0.2;
     const each = parts.length > 1 ? 0.3 : 0;
-    const unfoldEnd = unfoldAt + each * Math.max(0, parts.length - 1) + 0.35;
-    const koAt = parts.length ? unfoldEnd : termAt + 0.2;
     const koDur = c.ko ? clamp([...c.ko].length * 0.05, 0.25, 0.6) : 0;
-    const meanAt = koAt + koDur;
+    // 머무는 짚개 테마는 풀이 낱말·한국어 이름·뜻을 목소리가 그것을 말할 때 펴고 찍는다(못 들으면 약자가 선 뒤부터 장면 끝 무렵까지 박에 붙여 고르게).
+    // 펴지고 찍힐 때마다 카메라가 그쪽으로 다가간다. 훑는 테마는 약자가 서자마자 낱말마다 0.3초 간격으로 이어 편다
+    const said = dwells(kit, ctx) ? sayTimes(kit, [...parts.map((_, i) => (words ?? [fullText])[i]), c.ko, c.meaning], unfoldAt, Math.max(unfoldAt + 0.3, ctx.dur - 0.9)) : null;
+    const partAt = parts.map((_, i) => said?.[i] ?? unfoldAt + i * each);
+    const unfoldEnd = unfoldAt + each * Math.max(0, parts.length - 1) + 0.35;
+    const koAt = said && (parts.length || kit.say.length || kit.lines.length) ? said[parts.length] : parts.length ? unfoldEnd : termAt + 0.2;
+    const meanAt = Math.max(koAt + koDur, said?.[parts.length + 1] ?? 0);
+    followSpoken(kit, ctx, [...parts.map((p, i) => ({ at: partAt[i], el: p.box })), ...(ko ? [{ at: koAt, el: ko }] : []), ...(meaning ? [{ at: meanAt, el: meaning }] : [])]);
     const meanDur = meaning ? clamp([...c.meaning!].length * 0.035, 0.4, 1.2) : 0;
     // 짚음은 첫 낱말이 다 펴지자마자 — 펴기와 겹쳐 장면 끝까지 이어진다
     // 풀이 낱말이 없으면(약자가 아닌 용어) 펼 것이 없다 — 용어가 서자마자 짚기 시작한다
-    const markFrom = parts.length ? unfoldAt + Math.max(each, 0.3) : termAt + 0.06 * Math.max(0, chars.length - 1) + 0.12;
-    // 짚개 — 약자와 풀이 낱말·한국어 이름을 번갈아 짚는다(약자 → 낱말 → 약자 → 다음 낱말 …). 빠르기는 박이 정한다
-    const point = glider(host, [termEl, ...parts.map((p) => p.box), ...(ko ? [ko] : [])], { hub: true });
-    const stops = beatStops(kit.hits, markFrom, ctx.dur);
+    const markFrom = parts.length ? partAt[0] + Math.max(each, 0.3) : termAt + 0.06 * Math.max(0, chars.length - 1) + 0.12;
+    // 짚개 — 약자부터 짚고, 머무는 테마는 목소리가 풀이 낱말·한국어 이름(풀이·이름이 없으면 뜻)을 말할 때만 그리로 옮긴다
+    const point = glider(host, [{ el: termEl, text: c.term }, ...parts.map((p, i) => ({ el: p.box, text: (words ?? [fullText])[i] })), ...(ko ? [{ el: ko, text: c.ko }] : []), ...(meaning && !parts.length && !ko ? [{ el: meaning, text: c.meaning }] : [])], { kit, ctx, from: markFrom });
 
     const writeKo = ko ? slots.write(ko, { ctx, text: c.ko!, at: koAt, dur: koDur, seed: `${kit.seed}:ko` }) : null;
     const writeMeaning = meaning ? slots.write(meaning, { ctx, text: c.meaning!, at: meanAt, dur: meanDur, seed: `${kit.seed}:m` }) : null;
@@ -106,18 +110,18 @@ const pattern: Pattern<TermContent> = {
         const p = ease.outExpo(progress(t, termAt + i * 0.06, 0.3));
         applyStyle(ch, { y: (1 - p) * termPx * 0.4, opacity: p });
         // 약자 글자는 제 낱말이 펴질 때 강조색으로 — 글자와 낱말이 이어진다
-        const k = words ? clamp((t - (unfoldAt + i * each)) / 0.2) : 0;
+        const k = words ? clamp((t - ((partAt[i] ?? unfoldAt))) / 0.2) : 0;
         ch.style.color = k > 0.5 ? ACCENT_TEXT : "var(--kf-ink)";
       });
       applyStyle(termEl, landed(t));
       parts.forEach((pt, i) => {
         // 고른 빠르기로 편다 — 감속 끝자락이 길면 그 사이가 멈춘 화면이 된다
-        const p = progress(t, unfoldAt + i * each, 0.3);
+        const p = progress(t, (partAt[i] ?? unfoldAt), 0.3);
         pt.box.style.width = `${(p * pt.em * fullPx * 1.02).toFixed(1)}px`;
         pt.box.style.visibility = p > 0 ? "visible" : "hidden";
       });
       // 풀이를 낱말 차례로 반전해 짚는다 — 펴기가 끝난 뒤 장면 끝까지
-      point(t, stops);
+      point(t);
       writeKo?.(t);
       writeMeaning?.(t);
     };

package/packages/patterns/src/title/mask.ts

@@ -1,7 +1,7 @@
 import { applyStyle, clamp } from "@kasaframe/core";
 import { sweep } from "@kasaframe/motion";
 import { fitSize } from "@kasaframe/motion/moves";
-import { ACCENT_TEXT, area, beatStops, cameraOk, glider, node, riseName, slotsOf, moving } from "../kit.ts";
+import { ACCENT_TEXT, area, beatStops, cameraOk, dwells, glider, moving, node, reread, riseName, slotsOf } from "../kit.ts";
 import type { Pattern } from "../types.ts";
 
 export interface TitleContent {
@@ -12,12 +12,12 @@ export interface TitleContent {
 
 /**
  * 이름이 글자마다 아래에서 가림막을 뚫고 올라와 서고(드러냄), 카메라가 그 이름으로 한 번 다가간다 — 다가감의 이유가 드러냄이다.
- * 다가가는 동안 밑줄·부제가 서고, 짚개가 이름과 작은 글을 박마다 번갈아 짚는다.
+ * 다가가는 동안 밑줄·부제가 서고, 작은 글이 있으면 짚개가 이름부터 짚는다(머무는 테마는 목소리가 작은 글을 말할 때만 그리로).
  */
 const pattern: Pattern<TitleContent> = {
   id: "title.mask",
   type: "title",
-  does: "이름이 글자마다 가림막을 뚫고 서고, 다가가는 동안 짚개가 이름과 작은 글을 번갈아 짚는다",
+  does: "이름이 글자마다 가림막을 뚫고 서고, 다가가는 동안 짚개가 이름부터 짚는다",
   energy: ["mid"],
   family: "mask",
   camera: ["pushIn"],
@@ -61,17 +61,18 @@ const pattern: Pattern<TitleContent> = {
     const subAt = sweepAt + 0.3;
     const subDur = Math.max(0.3, ctx.dur - subAt - 0.08);
     if (cameraOk(ctx)) kit.stage?.camera.pushIn(settle, { to: name, scale: 1.07, dur: Math.max(0.6, ctx.dur - settle) });
-    // 이름이 선 뒤엔 짚개가 이름 ↔ 위 작은 글·부제를 박마다 번갈아 짚는다(카메라를 끈 영상에서도 쉬지 않는 몫, 장면이 길어도 박이 빠르기를 정한다)
-    const point = glider(host, [name, ...(kicker ? [kicker] : []), ...(sub ? [sub] : [])], { hub: true });
-    const stops = beatStops(kit.hits, Math.min(settle, nameAt + 0.35), ctx.dur);
+    // 이름이 서면 짚개가 이름과 위 작은 글·부제를 짚는다(짚기 방식은 테마 짚음). 작은 글이 없고 훑는 테마면 이름 글자를 박마다 다시 짚는다
+    const markFrom = Math.min(settle, nameAt + 0.35);
+    const point = glider(host, [{ el: name, text: c.title }, ...(kicker ? [{ el: kicker, text: c.kicker }] : []), ...(sub ? [{ el: sub, text: c.sub }] : [])], { kit, ctx, from: markFrom });
+    const again = !kicker && !sub && !dwells(kit, ctx) ? beatStops(kit.hits, markFrom, ctx.dur) : null;
     const writeKicker = kicker ? slots.write(kicker, { ctx, text: c.kicker!, at: 0, dur: Math.min(0.35, nameEnd * 0.6), seed: `${kit.seed}:kicker` }) : null;
     const writeSub = sub ? slots.write(sub, { ctx, text: c.sub!, at: subAt, dur: subDur, seed: `${kit.seed}:sub` }) : null;
     const landed = slots.land(name, { ctx, at: nameEnd, seed: `${kit.seed}:land` });
 
     return (t: number) => {
       moving("title.mask", ctx);
-      paintName(t, { riseAt: nameAt, each, fill: 0 });
-      point(t, stops);
+      paintName(t, { riseAt: nameAt, each, fill: 0, up: again ? reread(t, again) : undefined });
+      point(t);
       applyStyle(name, landed(t));
 
       applyStyle(bar, sweep(t, { at: sweepAt, dur: 0.3 }));

package/packages/patterns/src/title/slam.ts

@@ -7,7 +7,7 @@ const pattern: Pattern<TitleContent> = {
   ...endSlam,
   id: "title.slam",
   type: "title",
-  does: "옅은 자리표 이름이 먼저 서고 드롭에 꽉 찬 이름이 쾅 내려앉는다, 부제·작은 글이 붙고 짚개가 번갈아 짚는다",
+  does: "옅은 자리표 이름이 먼저 서고 드롭에 꽉 찬 이름이 쾅 내려앉는다, 부제·작은 글이 붙고 짚개가 이름부터 짚는다",
   purposes: { prefer: ["promo", "launch", "ad", "mv"] },
   fits(c, info) {
     if (typeof c?.title !== "string" || !c.title.trim() || [...c.title].length > 16) return "title 이 비었거나 16자를 넘는다";

package/packages/patterns/src/types.ts

@@ -40,6 +40,7 @@ export interface Kit {
   seed: string;
   hits: number[];
   say: SpokenWord[];
+  lines: SpokenWord[];
   slots: ThemeSlots;
   stage: StageLike;
   policy: TextPolicy;

package/packages/plan/src/asks.ts

@@ -153,7 +153,7 @@ function voicePart(plan: Plan, caps: CapabilityReport): { q?: Question; auto?: s
   };
 }
 
-// 테마 — 시리즈가 정했거나 요청이 「리소 느낌」·「og-measure/night-amber」처럼 짚었으면 묻지 않는다(kf new 의 auto 가 그대로 짚은 판을 쓴다).
+// 테마 — 시리즈가 정했거나 요청이 「리소 느낌」·「og-measure/snow-blue」처럼 짚었으면 묻지 않는다(kf new 의 auto 가 그대로 짚은 판을 쓴다).
 // 보기는 「알아서」(= auto, 권장)와 요청·용도·분위기 낱말(사람이 준 한 마디·레퍼런스까지)에 맞는 approved 세계·변주 넷 — 수백 판을 다 늘어놓지 않는다.
 // 사람이 보기 밖으로 분위기 한 마디나 그림·주소를 주면 그걸로 넷을 다시 고른다(kf make --theme-mood·--theme-ref)
 export const THEME_PICKS = 4;

package/packages/plan/src/brief.ts

@@ -1,8 +1,9 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { freezeLimits } from "@kasaframe/core";
 import { captionMode } from "@kasaframe/motion/captions";
 import { bundleFor, MENU, type Dress } from "@kasaframe/motion/menu";
 import { questionsMarkdown, type Question } from "@kasaframe/gen";
-import { loadTheme } from "@kasaframe/themes";
+import { loadTheme, themeFreezeSec } from "@kasaframe/themes";
 import type { GenSpec, ShotSpec } from "./types.ts";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -125,6 +126,8 @@ export function projectBrief(dir: string): string {
   const rules = purposeRules(kf.template);
   const tplFile = join(repo, "templates", kf.template, "template.json");
   const tplMotion = existsSync(tplFile) ? (JSON.parse(readFileSync(tplFile, "utf8")).motion ?? {}) : {};
+  // kf check 와 같은 기준 — 틀이 style.json 을 덮고, 테마는 오류 기준을 늘리기만 한다(늘린 만큼은 경고로 남는다)
+  const freeze = freezeLimits({ ...(style.motion ?? {}), ...tplMotion }.maxFreezeSec, themeFreezeSec(kf.theme));
   const colors = Object.keys(style.colors ?? {}).map((k: string) => `--kf-${k.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}`);
   const core = signatures("core");
   const motion = signatures("motion");
@@ -135,7 +138,7 @@ export function projectBrief(dir: string): string {
     ...questionsMarkdown(plan.asks ?? [], (flags) => `npx kf make --answer ${dir} ${flags}`),
     ...narrationSection(dir, kf, plan),
     `**이 영상의 규칙 — 용도 ${kf.template}(틀이 기본값을 덮는다, kf check 가 같은 값으로 잡는다)**`,
-    `1. 화면은 ${rules.maxFreezeSec}초(60fps 6프레임) 넘게 멈추지 않는다 — 끝 카드·큰 숫자·로고도 예외 없이 화면 안 움직임(숫자 굴러가기·칸 채우기·반짝임·글자 흐름·바탕 흐름)으로 계속 살아 있게.`,
+    `1. 화면은 ${freeze.error}초(60fps ${Math.round(freeze.error * 60)}프레임) 넘게 멈추지 않는다${freeze.error > freeze.warn ? `(테마 ${kf.theme} 가 늘린 기준 — ${freeze.warn}초 넘는 멈춤도 경고로 남는다)` : ""} — 끝 카드·큰 숫자·로고도 예외 없이 화면 안 움직임(숫자 굴러가기·칸 채우기·반짝임·글자 흐름·바탕 흐름)으로 계속 살아 있게.`,
     `2. 같은 구도는 ${rules.staticSec.warn}초 넘기지 않는다(${rules.staticSec.error}초 넘으면 오류) — 새 요소·칸 채우기·숫자 키우기·컷·전환으로 바꾼다.`,
     rules.beatMove === "every-beat"
       ? "3. 미세하게 흔들리는 것만으로 때우지 않는다 — 눈에 보이는 큰 움직임이 박마다 하나 이상."

package/packages/plan/src/themes.ts

@@ -38,14 +38,20 @@ export function suggestThemes(request: string, purpose: Purpose, aspect?: Aspect
   const lookOn = hasLook(want) || !!look.ref;
   const pool = listThemes({ status: "approved", purpose, ...(aspect ? { aspect } : {}), variants: lookOn });
   const ask = new Set(requestWords(text));
+  const tagsOf = (t: Theme) => (t.tags?.use ?? []).map((u) => u.toLowerCase());
+  // 드물게 적힌 낱말일수록 그 세계를 짚는다 — 「소개」처럼 여러 세계가 적은 낱말보다 「OpenGateway」처럼 한 세계만 적은 낱말이 무겁다
+  const tagShare = (w: string) => pool.filter((t) => tagsOf(t).some((u) => u.includes(w))).length / Math.max(1, pool.length);
   const scored = pool.map((t) => {
     const hay = `${t.name} ${t.metaphor} ${t.guide} ${(t.tags?.use ?? []).join(" ")} ${(t.tags?.mood ?? []).join(" ")} ${t.variant?.desc ?? ""}`.toLowerCase();
     const hit = [...ask].filter((w) => hay.includes(w));
+    // 세계가 tags.use 에 일부러 적은 낱말은 본문에 우연히 나온 낱말보다 무겁다 — 공통 견본 브리프(「OpenGateway 소개」)의 낱말은 모든 세계 THEME.md 에 있어
+    // 본문 맞음만으로는 그 제품 전용 세계가 다른 세계와 동점이 된다
+    const tagged = hit.filter((w) => tagsOf(t).some((u) => u.includes(w)));
     const l = lookOn ? lookScore(t, want, look.ref) : { score: 0, why: [] };
     const used = use.filter((w) => (t.tags?.use ?? []).some((u) => u.includes(w)));
     const fit = use.length ? (0.9 * used.length) / use.length : 0;
     // 같은 점수면 세계 기본 판이 앞 — 바란 생김새가 없을 때 변주를 굳이 고르지 않게
-    return { t, score: hit.length + fit + l.score + (t.variant ? 0 : 0.3), hit, used, why: l.why, tie: tieKey(text, t.id) };
+    return { t, score: hit.length + tagged.reduce((s, w) => s + 0.5 * (1 - tagShare(w)), 0) + fit + l.score + (t.variant ? 0 : 0.3), hit, used, why: l.why, tie: tieKey(text, t.id) };
   });
   scored.sort((a, b) => b.score - a.score || a.tie - b.tie || a.t.id.localeCompare(b.t.id));
   const picked: typeof scored = [];
@@ -72,7 +78,7 @@ export function suggestThemes(request: string, purpose: Purpose, aspect?: Aspect
 // 사람이 짚은 것이라 review 까지 받는다(draft 는 빼고)
 export function themeFromRequest(request: string, purpose?: Purpose): ThemePick | null {
   const t = request.toLowerCase();
-  // 변주를 이름으로 짚었으면(「og-measure/night-amber 로」) 그 판
+  // 변주를 이름으로 짚었으면(「og-measure/snow-blue 로」) 그 판
   const full = /([a-z0-9-]+)\/([a-z0-9-]+)/.exec(t);
   if (full) {
     try {

package/packages/themes/kit/THEME-MAKE.md

@@ -23,9 +23,9 @@
 ## 3. 비유·스타일 — `THEME.md` 앞부분 · `style.json` · `theme.json`
 
 - 비유 한 줄: 「무엇이 무엇처럼 되며 화면이 찍힌다/드러난다」. 내용(정보가 화면에 오르는 방식)에서 나온 개념이어야 한다 — 장식 이름이 아니라 동사가 있는 문장.
-- `style.json`: 프리셋과 같은 KfStyle 꼴 통째, `name` = `{{id}}`. 잉크 2–3색 + 그 어두운 단(`colors`), 바탕 `bg`, 글 `ink`, 강조 `accent`. 글꼴 셋(`sans`·`display`·`mono`)은 **한글이 서는 글꼴로 끝나게**(Pretendard 를 마지막에), `faces` 는 **한 파일 주소**(jsdelivr `gh/google/fonts@main/ofl/<이름>/<파일>.ttf` 나 `npm/pretendard@1.3.9/.../PretendardVariable.woff2`). 구글 폰트 CSS(unicode-range 조각)는 글이 투명하게 찍히니 쓰지 않는다. `theme` 칸에 `inks`·`texture`·`movement` 를 글로.
+- `style.json`: 프리셋과 같은 KfStyle 꼴 통째, `name` = `{{id}}`. 잉크 2–3색 + 그 어두운 단(`colors`), 바탕 `bg`, 글 `ink`, 강조 `accent`. 글꼴 셋(`sans`·`display`·`mono`)은 **한글이 서는 글꼴로 끝나게**(Pretendard 를 마지막에), `faces` 는 **판을 박은 한 파일 주소**(jsdelivr `gh/google/fonts@<커밋 40자>/ofl/<이름>/<파일>.ttf` 나 `npm/pretendard@1.3.9/.../PretendardVariable.woff2` — `@main`·`@latest`·`@5` 처럼 바뀌는 판은 같은 영상이 다르게 구워진다). 구글 폰트 CSS(unicode-range 조각)는 글이 투명하게 찍히니 쓰지 않는다. 글꼴은 상업·영상·웹 임베딩이 허용된 OFL·Apache 만, 한 굵기뿐인 글꼴을 더 굵게 부르면 가짜 굵기가 된다 — 짝 목록에 있는 글꼴이면 `kf fonts list`·`kf fonts sheet` 에서 고르는 게 가장 빠르다. `theme` 칸에 `inks`·`texture`·`movement` 를 글로.
 - `theme.json`: `name`·`metaphor`·`purposes`·`aspect`. status 는 draft 그대로.
-- `theme.json` 의 `vary`·`tags`(SPEC 9 「변주」): 이 세계가 approved 되면 `kf theme vary {{id}}` 가 겉모습만 바꾼 판 15개를 뽑는다. 비유를 깨지 않는 축과 범위만 적는다 — 밝기(`scheme`), 강조 색상 범위(`hue`, OKLCH 도), 글꼴 짝(`fonts` — `packages/themes/kit/fonts.json` 의 id·`tag:<태그>`·`base`), 질감(`texture`), 선 굵기(`stroke` — 슬롯 `trace` 가 `slotkit.traceCanvas` 를 쓰면 실린다), 모서리(`radius`), 빠르기(`tempo`), 밀도(`density` — 효과가 `ctx.style.look?.density` 를 읽을 때만). 금지에 적은 것과 부딪히는 축은 빼고(「밝은 바탕 금지」면 `scheme: ["dark"]`), 재료처럼 색상이 뜻인 색 열쇠는 `fixedHue`, 늘 같은 색은 `keep`. `tags` 는 `{ mood, light, use, dims }`. 효과·슬롯 색은 `var(--kf-*)`·`ctx.style.colors` 로 읽어야 변주 색이 실린다 — 색을 코드에 박지 않는다.
+- `theme.json` 의 `vary`·`tags`(SPEC 9 「변주」): 이 세계가 approved 되면 `kf theme vary {{id}}` 가 겉모습만 바꾼 판 15개를 뽑는다. 비유를 깨지 않는 축과 범위만 적는다 — 밝기(`scheme`), 강조 색상 범위(`hue`, OKLCH 도), 글꼴 짝(`fonts` — 짝 id·`tag:<태그>`·`tag:<태그>+<태그>`(둘 다 가진 짝 — 짝이 수백이라 결이 다른 무리가 딸려 오지 않게)·`base`. 목록은 `kf fonts list`(`packages/themes/kit/fonts.json`·`kit/fonts/<무리>.json`), 견본은 `kf fonts sheet`), 질감(`texture`), 선 굵기(`stroke` — 슬롯 `trace` 가 `slotkit.traceCanvas` 를 쓰면 실린다), 모서리(`radius`), 빠르기(`tempo`), 밀도(`density` — 효과가 `ctx.style.look?.density` 를 읽을 때만). 금지에 적은 것과 부딪히는 축은 빼고(「밝은 바탕 금지」면 `scheme: ["dark"]`), 재료처럼 색상이 뜻인 색 열쇠는 `fixedHue`, 늘 같은 색은 `keep`. 브랜드 가이드가 라이트·다크 두 벌을 따로 정해 뒀으면 다른 밝기 한 벌을 `palettes.<light|dark>` 에(그 밝기 판은 뒤집어 옮기지 않고 그 벌에서 시작한다). `tags` 는 `{ mood, light, use, dims }` — `use` 에는 그 세계가 맞는 제품·주제 이름도(공통 견본 브리프 낱말은 모든 THEME.md 에 있어 `use` 가 고르기를 가른다). 효과·슬롯 색은 `var(--kf-*)`·`ctx.style.colors` 로 읽어야 변주 색이 실린다 — 색을 코드에 박지 않는다.
 - 글자 대비는 찍힌 픽셀로 3:1 이상 — 옅은 잉크로 작은 글을 쓰지 않는다.
 
 ## 4. 효과 — `effects.ts` (5–10개)