kasaframe 0.1.3 → 0.1.4

package/packages/plan/src/index.ts

@@ -7,7 +7,7 @@ export type { Detection, Ranked, DetectInput } from "./detect.ts";
 export { pickDuration, layoutScenes } from "./layout.ts";
 export type { Layout, LaidScene } from "./layout.ts";
 export { makePlan, refuses3d, wantsMotionCut, wantsVideo } from "./plan.ts";
-export { applyAnswers, planQuestions, WAIT } from "./asks.ts";
+export { applyAnswers, planQuestions, THEME_PICKS, usableTheme, WAIT } from "./asks.ts";
 export type { PlanQuestions } from "./asks.ts";
 export type { PlanInput } from "./plan.ts";
 export { chat, codeBlock, jsonBlock, ledger, premiumBlock, spend, spentLine, writeStats } from "./llm.ts";
@@ -17,7 +17,7 @@ export type { ProjectFile, ProjectScene } from "./brief.ts";
 export { toCues, srt, vtt, writeCaptions } from "./captions.ts";
 export type { CaptionLine, Cue } from "./captions.ts";
 export { suggestThemes, pickTheme, themeFromRequest } from "./themes.ts";
-export type { ThemePick } from "./themes.ts";
+export type { LookInput, ThemePick } from "./themes.ts";
 export { look, lookSheet, formatLook, DEFAULT_EYES } from "./look.ts";
 export type { LookSheet } from "./look.ts";
 export type { LookReport, LookScene } from "./look.ts";

package/packages/plan/src/plan.ts

@@ -3,7 +3,7 @@ import { layoutScenes, pickDuration } from "./layout.ts";
 import { parseAspect, parseDuration, parseStyle, parseTitle } from "./request.ts";
 import { frameFor, listTemplates, loadTemplate } from "./templates.ts";
 import { loadSeries, type Series, seriesFromRequest } from "./series.ts";
-import { pickTheme, suggestThemes, themeFromRequest } from "./themes.ts";
+import { type LookInput, pickTheme, suggestThemes, themeFromRequest } from "./themes.ts";
 import { basename } from "node:path";
 import type { Aspect, BeatsLike, GenSpec, Plan, PlannedScene, Purpose, ShotSpec, Template } from "./types.ts";
 
@@ -44,6 +44,7 @@ export interface PlanInput {
   title?: string;
   theme?: string; // 테마 id · "auto" · "none"(프리셋만)
   series?: string; // 시리즈 id · "none". 안 주면 요청 글이 짚은 시리즈(series/<id>.json 의 match)
+  look?: LookInput; // 테마 고르기에 사람이 준 분위기 한 마디·레퍼런스 생김새
 }
 
 export function makePlan(input: PlanInput): Plan {
@@ -65,7 +66,7 @@ export function makePlan(input: PlanInput): Plan {
   // none 은 프리셋만 — 시리즈 테마도 쓰지 않는다
   const themeIn = input.theme === "none" ? undefined : (input.theme === undefined || input.theme === "auto") && series?.theme ? series.theme : input.theme;
   const named = themeIn === "auto" ? themeFromRequest(input.request, tpl.id) : null;
-  const themeCandidates = themeIn === "auto" ? [...(named ? [named] : []), ...suggestThemes(input.request, tpl.id, frame.aspect).filter((c) => c.id !== named?.id)].slice(0, 3) : undefined;
+  const themeCandidates = themeIn === "auto" ? [...(named ? [named] : []), ...suggestThemes(input.request, tpl.id, frame.aspect, 3, input.look).filter((c) => c.id !== named?.id)].slice(0, 3) : undefined;
   const theme = themeIn === "auto" ? (themeCandidates?.[0]?.id ?? null) : themeIn ? pickTheme(themeIn).id : null;
   // 테마를 고르면 그 테마의 style 이 프리셋을 대신한다(kf new 가 themeStyle 로 쓴다)
   const style = theme ?? input.style ?? series?.style ?? parseStyle(input.request) ?? tpl.style;
@@ -115,6 +116,7 @@ export function makePlan(input: PlanInput): Plan {
     shots,
     theme,
     ...(themeCandidates ? { themeCandidates } : {}),
+    ...(input.look && (input.look.mood || input.look.ref) ? { themeLook: input.look } : {}),
     ...(series ? { series: series.id, ...(series.music?.mood ? { mood: series.music.mood } : {}) } : {}),
   };
   if (det.ambiguous) {

package/packages/plan/src/themes.ts

@@ -1,4 +1,5 @@
 import { listThemes, loadTheme, type Theme } from "@kasaframe/themes";
+import { hasLook, lookDistance, lookScore, type RefLook, textWords, wantsOf } from "@kasaframe/themes/look";
 import { parseTitle } from "./request.ts";
 import type { Aspect, Purpose } from "./types.ts";
 
@@ -7,25 +8,80 @@ export interface ThemePick {
   why: string;
 }
 
-const words = (s: string) => s.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((w) => w.length >= 2);
+/** 사람이 테마 고르기에 덧붙인 것 — 분위기 한 마디·레퍼런스 그림의 생김새 */
+export interface LookInput {
+  mood?: string;
+  ref?: RefLook | null;
+}
+
+// 어느 테마 글에나 나오는 낱말 — 맞음 점수를 부풀리기만 한다
+const STOP = new Set(["영상", "느낌", "분위기", "스타일", "테마", "쇼츠", "릴스", "만들어", "만들어줘", "으로", "처럼", "같은", "video"]);
+/** 요청 글의 내용 낱말 — 조사를 뗀 낱말(textWords — 「압축이」 = 압축) 가운데 두 글자 넘는 것, 어디에나 나오는 낱말·숫자로 시작하는 것은 뺀다 */
+export const requestWords = (s: string): string[] => textWords(s).filter((w) => w.length >= 2 && !STOP.has(w) && !/^\d/.test(w));
+
+// 같은 점수의 차례 — 요청 글로 섞는다. 승인 날짜·id 차례면 내용 낱말이 없는 요청마다 같은 넷(알파벳 앞)이 나와 그것대로 양산형이 된다.
+// 같은 요청이면 늘 같은 차례(FNV-1a)
+function tieKey(text: string, id: string): number {
+  let h = 0x811c9dc5;
+  for (const ch of `${text}\0${id}`) h = Math.imul(h ^ ch.codePointAt(0)!, 0x01000193) >>> 0;
+  return h;
+}
 
-// 자동 추천은 approved 테마만(SPEC 9). 요청 낱말이 테마 이름·비유·THEME.md 에 얼마나 나오나로 줄 세우고, 같으면 최근에 승인된 쪽
-export function suggestThemes(request: string, purpose: Purpose, aspect?: Aspect, n = 3): ThemePick[] {
-  const pool = listThemes({ status: "approved", purpose, ...(aspect ? { aspect } : {}) });
-  const ask = new Set(words(request));
+// 자동 추천은 approved 만(SPEC 9 — 세계가 approved 면 검사를 넘은 변주도). 내용 맞음(요청 낱말이 세계 이름·비유·THEME.md·태그에 나오나)과
+// 생김새 맞음(분위기 낱말·레퍼런스 → 밝기·색상·채도·질감·글꼴)을 더해 줄 세운다. 생김새를 바란 말이 없으면 세계 기본 판끼리만 견준다.
+// 고른 n 개는 서로 겹치지 않게 — 한 세계는 둘까지(생김새를 바라지 않았으면 하나), 생김새가 아주 가까운 판은 뒤로.
+// use: 부르는 쪽의 쓰임 낱말(용도보다 잘게 나눈 쓰임 — 쇼츠 스킬의 「업데이트 소식」 = 소식·발표·출시). 테마 tags.use 와 맞으면 다 합쳐도
+// 요청 낱말 하나보다 가볍게 더한다 — 요청이 남긴 동점끼리 줄을 세운다
+export function suggestThemes(request: string, purpose: Purpose, aspect?: Aspect, n = 3, look: LookInput = {}, use: string[] = []): ThemePick[] {
+  const text = `${request} ${look.mood ?? ""}`;
+  const { want, hits: moodHits } = wantsOf(text);
+  const lookOn = hasLook(want) || !!look.ref;
+  const pool = listThemes({ status: "approved", purpose, ...(aspect ? { aspect } : {}), variants: lookOn });
+  const ask = new Set(requestWords(text));
   const scored = pool.map((t) => {
-    const hay = `${t.name} ${t.metaphor} ${t.guide}`.toLowerCase();
+    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));
-    return { t, score: hit.length, hit };
+    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) };
+  });
+  scored.sort((a, b) => b.score - a.score || a.tie - b.tie || a.t.id.localeCompare(b.t.id));
+  const picked: typeof scored = [];
+  const perWorld = (w: string) => picked.filter((p) => p.t.world === w).length;
+  for (const strict of [true, false]) {
+    for (const c of scored) {
+      if (picked.length >= n) break;
+      if (picked.includes(c)) continue;
+      if (strict && (perWorld(c.t.world) >= (lookOn ? 2 : 1) || picked.some((p) => lookDistance(p.t, c.t) < 0.06))) continue;
+      picked.push(c);
+    }
+  }
+  return picked.map(({ t, hit, used, why }) => {
+    const reasons = [
+      ...(hit.length ? [`요청의 ${hit.slice(0, 3).map((w) => `「${w}」`).join("·")} 이(가) 테마와 맞는다`] : []),
+      ...(why.length ? [`${look.ref ? "레퍼런스·" : ""}${moodHits.length ? `분위기 ${moodHits.slice(0, 3).map((w) => `「${w}」`).join("·")}` : "분위기"}에 맞는 ${why.slice(0, 3).join("·")}`] : []),
+      ...(used.length ? [`쓰임 ${used.slice(0, 3).join("·")}`] : []),
+    ];
+    return { id: t.id, why: `${reasons.length ? reasons.join(", ") : `${purpose} 에 쓰는 승인 테마`} — ${t.variant ? `${t.variant.desc}(${t.metaphor})` : t.metaphor}` };
   });
-  scored.sort((a, b) => b.score - a.score || (b.t.approvedAt ?? "").localeCompare(a.t.approvedAt ?? ""));
-  return scored.slice(0, n).map(({ t, hit }) => ({ id: t.id, why: hit.length ? `요청의 ${hit.slice(0, 3).map((w) => `「${w}」`).join("·")} 이(가) 테마 비유와 맞는다 — ${t.metaphor}` : `${purpose} 에 쓰는 승인 테마 — ${t.metaphor}` }));
 }
 
 // 「리소 느낌으로」처럼 사람이 말로 테마를 짚었는지 — 테마 이름 낱말(두 글자 넘게)·id 조각(세 글자 넘게)이 요청에 나오면 그 테마.
 // 사람이 짚은 것이라 review 까지 받는다(draft 는 빼고)
 export function themeFromRequest(request: string, purpose?: Purpose): ThemePick | null {
   const t = request.toLowerCase();
+  // 변주를 이름으로 짚었으면(「og-measure/night-amber 로」) 그 판
+  const full = /([a-z0-9-]+)\/([a-z0-9-]+)/.exec(t);
+  if (full) {
+    try {
+      const v = loadTheme(full[0]);
+      if (v.status !== "draft") return { id: v.id, why: `요청이 변주 ${v.id} 를 짚었다 — ${v.variant?.desc ?? v.metaphor}` };
+    } catch {
+      // 테마 이름이 아닌 경로·주소 조각이면 아래 낱말 짚기로
+    }
+  }
   let best: { th: Theme; score: number; hit: string[] } | null = null;
   for (const th of listThemes({ status: ["approved", "review"] })) {
     const keys = [...th.name.split(/\s+/).filter((w) => w.length >= 2), ...th.id.split("-").filter((w) => w.length >= 3)].map((w) => w.toLowerCase());

package/packages/plan/src/types.ts

@@ -1,5 +1,6 @@
 import type { Question } from "@kasaframe/gen";
 import type { Bundle } from "@kasaframe/motion/menu";
+import type { RefLook } from "@kasaframe/themes/look";
 export type Aspect = "16:9" | "9:16" | "1:1";
 export type Purpose = "promo" | "shorts" | "explainer" | "launch" | "demo" | "ad" | "square" | "mv";
 export const PURPOSES: Purpose[] = ["promo", "shorts", "explainer", "launch", "demo", "ad", "square", "mv"];
@@ -146,6 +147,8 @@ export interface Plan {
   // 고른 테마(themes/<id>). auto 면 approved 후보 셋을 themeCandidates 에 남기고 첫째를 쓴다
   theme?: string | null;
   themeCandidates?: { id: string; why: string }[];
+  /** 테마 고르기에 사람이 준 분위기 한 마디·레퍼런스 생김새 — 테마 질문의 후보 넷을 이걸로 다시 고른다 */
+  themeLook?: { mood?: string; ref?: RefLook | null };
   questions?: { id: string; ask: string; choices: string[] }[];
   shots?: ShotSpec[];
   // 시리즈 묶음(series/<id>.json)으로 세운 계획이면 그 id, 곡 분위기는 시리즈가 틀 mood 를 덮는다

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

@@ -25,6 +25,7 @@
 - 비유 한 줄: 「무엇이 무엇처럼 되며 화면이 찍힌다/드러난다」. 내용(정보가 화면에 오르는 방식)에서 나온 개념이어야 한다 — 장식 이름이 아니라 동사가 있는 문장.
 - `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` 를 글로.
 - `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` 로 읽어야 변주 색이 실린다 — 색을 코드에 박지 않는다.
 - 글자 대비는 찍힌 픽셀로 3:1 이상 — 옅은 잉크로 작은 글을 쓰지 않는다.
 
 ## 4. 효과 — `effects.ts` (5–10개)