kasaframe 0.1.1 → 0.1.4

package/themes/manga-panel/variants/snow-magenta.json

@@ -0,0 +1,116 @@
+{
+  "id": "snow-magenta",
+  "world": "manga-panel",
+  "name": "Snow Magenta",
+  "desc": "새하얀 바탕에 자홍 강조 · 획이 꽉 들어찬 초굵은 제목",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9881,
+    "tint": {
+      "h": 177.4739,
+      "c": 0.0069
+    },
+    "inkL": 0.1611,
+    "hue": 341.3264,
+    "chroma": 0.9664,
+    "fonts": "gasoek",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1.29,
+    "radius": null,
+    "tempo": 1.09,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#F7FDFB",
+      "surface": "#FFFFFF",
+      "raised": "#EBF0EC",
+      "line": "#0B0E11",
+      "ink": "#0B0E11",
+      "inkSoft": "#25292C",
+      "dim": "#595A56",
+      "accent": "#CB35A2",
+      "accentSoft": "#F0C8E4",
+      "accentText": "#AE2B8A",
+      "onAccent": "#FFFFFF",
+      "success": "#0B0E11",
+      "danger": "#CB35A2",
+      "warning": "#CB35A2",
+      "paper": "#F7FDFB",
+      "tone": "#0B0E11",
+      "spot": "#CB35A2"
+    },
+    "fonts": {
+      "sans": "\"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"Gasoek One\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "mono": "\"Geist Mono\", ui-monospace, \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "Gasoek One",
+          "src": "https://cdn.jsdelivr.net/gh/google/fonts@bd8f81ddb5c74d5c8897b36ad88b440266245103/ofl/gasoekone/GasoekOne-Regular.ttf",
+          "weight": "400"
+        },
+        {
+          "family": "Pretendard Variable",
+          "src": "https://cdn.jsdelivr.net/npm/pretendard@1.3.9/dist/web/variable/woff2/PretendardVariable.woff2",
+          "weight": "45 920"
+        },
+        {
+          "family": "Geist Mono",
+          "src": "https://cdn.jsdelivr.net/npm/geist@1.3.1/dist/fonts/geist-mono/GeistMono-Variable.woff2",
+          "weight": "100 900"
+        }
+      ]
+    },
+    "type": {
+      "weightDisplay": 400,
+      "weightBody": 500,
+      "tracking": "-0.01em"
+    },
+    "look": {
+      "stroke": 1.29,
+      "tempo": 1.09
+    }
+  },
+  "tags": {
+    "mood": [
+      "극적",
+      "역동적",
+      "대담한",
+      "만화",
+      "흑백",
+      "밝은"
+    ],
+    "light": "light",
+    "use": [
+      "공개",
+      "홍보",
+      "결정타",
+      "순서",
+      "이야기",
+      "숫자"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 18.77,
+      "inkSoft": 14.24,
+      "dim": 6.74,
+      "accentText": 5.78,
+      "accent": 4.47,
+      "onAccent": 4.62,
+      "success~danger": 0.363,
+      "success~warning": 0.363,
+      "accent~ink": 0.363
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.slam"
+  }
+}

package/themes/manga-panel/variants/snow-rose-dots.json

@@ -0,0 +1,121 @@
+{
+  "id": "snow-rose-dots",
+  "world": "manga-panel",
+  "name": "Snow Rose Dots",
+  "desc": "새하얀 바탕에 장밋빛 강조 · 폭 넓고 힘 있는 브랜드 고딕 · 망점",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9866,
+    "tint": {
+      "h": 16.374,
+      "c": 0.0184
+    },
+    "inkL": 0.2275,
+    "hue": 0.6122,
+    "chroma": 0.9618,
+    "fonts": "wanted",
+    "texture": {
+      "kind": "halftone",
+      "amount": 0.16
+    },
+    "stroke": 1.36,
+    "radius": null,
+    "tempo": 1.11,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#FFF9F9",
+      "surface": "#FFFFFF",
+      "raised": "#FCEBE9",
+      "line": "#1F1B1E",
+      "ink": "#1F1B1E",
+      "inkSoft": "#3A3438",
+      "dim": "#6E625F",
+      "accent": "#E43880",
+      "accentSoft": "#F9C9D9",
+      "accentText": "#C7326F",
+      "onAccent": "#060606",
+      "success": "#1F1B1E",
+      "danger": "#E43880",
+      "warning": "#E43880",
+      "paper": "#FFF9F9",
+      "tone": "#1F1B1E",
+      "spot": "#E43880"
+    },
+    "fonts": {
+      "sans": "\"Wanted Sans Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"Wanted Sans Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "mono": "\"Geist Mono\", ui-monospace, \"Wanted Sans Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "Wanted Sans Variable",
+          "src": "https://cdn.jsdelivr.net/npm/wanted-sans@1.0.3/fonts/webfonts/variable/complete/woff2/WantedSansVariable.woff2",
+          "weight": "400 1000"
+        },
+        {
+          "family": "Pretendard Variable",
+          "src": "https://cdn.jsdelivr.net/npm/pretendard@1.3.9/dist/web/variable/woff2/PretendardVariable.woff2",
+          "weight": "45 920"
+        },
+        {
+          "family": "Geist Mono",
+          "src": "https://cdn.jsdelivr.net/npm/geist@1.3.1/dist/fonts/geist-mono/GeistMono-Variable.woff2",
+          "weight": "100 900"
+        }
+      ]
+    },
+    "type": {
+      "weightDisplay": 800,
+      "weightBody": 500,
+      "tracking": "-0.02em"
+    },
+    "look": {
+      "texture": {
+        "kind": "halftone",
+        "amount": 0.16
+      },
+      "stroke": 1.36,
+      "tempo": 1.11
+    }
+  },
+  "tags": {
+    "mood": [
+      "극적",
+      "역동적",
+      "대담한",
+      "만화",
+      "흑백",
+      "밝은",
+      "아날로그"
+    ],
+    "light": "light",
+    "use": [
+      "공개",
+      "홍보",
+      "결정타",
+      "순서",
+      "이야기",
+      "숫자"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 16.37,
+      "inkSoft": 11.6,
+      "dim": 5.64,
+      "accentText": 4.9,
+      "accent": 3.89,
+      "onAccent": 5.01,
+      "success~danger": 0.299,
+      "success~warning": 0.299,
+      "accent~ink": 0.299
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.slam"
+  }
+}

package/themes/manga-panel/variants/snow-rose.json

@@ -0,0 +1,116 @@
+{
+  "id": "snow-rose",
+  "world": "manga-panel",
+  "name": "Snow Rose",
+  "desc": "새하얀 바탕에 장밋빛 강조 · 손간판 같은 각진 좁은 제목체",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9798,
+    "tint": {
+      "h": 314.3532,
+      "c": 0.0033
+    },
+    "inkL": 0.249,
+    "hue": 6.5516,
+    "chroma": 1.0336,
+    "fonts": "do-hyeon",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 0.93,
+    "radius": null,
+    "tempo": 1.05,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#F9F8FA",
+      "surface": "#FFFFFF",
+      "raised": "#EFEDED",
+      "line": "#202125",
+      "ink": "#202125",
+      "inkSoft": "#3A3B3F",
+      "dim": "#6B6766",
+      "accent": "#F02B72",
+      "accentSoft": "#FCC7D4",
+      "accentText": "#D22964",
+      "onAccent": "#060606",
+      "success": "#202125",
+      "danger": "#F02B72",
+      "warning": "#F02B72",
+      "paper": "#F9F8FA",
+      "tone": "#202125",
+      "spot": "#F02B72"
+    },
+    "fonts": {
+      "sans": "\"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"Do Hyeon\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "mono": "\"Geist Mono\", ui-monospace, \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "Do Hyeon",
+          "src": "https://cdn.jsdelivr.net/gh/google/fonts@bd8f81ddb5c74d5c8897b36ad88b440266245103/ofl/dohyeon/DoHyeon-Regular.ttf",
+          "weight": "400"
+        },
+        {
+          "family": "Pretendard Variable",
+          "src": "https://cdn.jsdelivr.net/npm/pretendard@1.3.9/dist/web/variable/woff2/PretendardVariable.woff2",
+          "weight": "45 920"
+        },
+        {
+          "family": "Geist Mono",
+          "src": "https://cdn.jsdelivr.net/npm/geist@1.3.1/dist/fonts/geist-mono/GeistMono-Variable.woff2",
+          "weight": "100 900"
+        }
+      ]
+    },
+    "type": {
+      "weightDisplay": 400,
+      "weightBody": 500,
+      "tracking": "0em"
+    },
+    "look": {
+      "stroke": 0.93,
+      "tempo": 1.05
+    }
+  },
+  "tags": {
+    "mood": [
+      "극적",
+      "역동적",
+      "대담한",
+      "만화",
+      "흑백",
+      "밝은"
+    ],
+    "light": "light",
+    "use": [
+      "공개",
+      "홍보",
+      "결정타",
+      "순서",
+      "이야기",
+      "숫자"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 15.14,
+      "inkSoft": 10.59,
+      "dim": 5.25,
+      "accentText": 4.66,
+      "accent": 3.74,
+      "onAccent": 5.11,
+      "success~danger": 0.265,
+      "success~warning": 0.265,
+      "accent~ink": 0.265
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.slam"
+  }
+}

package/themes/manga-panel/variants/snow-sky.json

@@ -0,0 +1,95 @@
+{
+  "id": "snow-sky",
+  "world": "manga-panel",
+  "name": "Snow Sky",
+  "desc": "새하얀 바탕에 하늘색 강조 · 망점",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9896,
+    "tint": {
+      "h": 252.4507,
+      "c": 0.0123
+    },
+    "inkL": 0.1776,
+    "hue": 232.362,
+    "chroma": 0.9688,
+    "fonts": "base",
+    "texture": {
+      "kind": "halftone",
+      "amount": 0.16
+    },
+    "stroke": 1.4,
+    "radius": null,
+    "tempo": 0.97,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#F9FCFF",
+      "surface": "#FFFFFF",
+      "raised": "#EBF0F5",
+      "line": "#0E1117",
+      "ink": "#0E1117",
+      "inkSoft": "#282C33",
+      "dim": "#5B5D5E",
+      "accent": "#008BBC",
+      "accentSoft": "#B0DFF6",
+      "accentText": "#0077A2",
+      "onAccent": "#060606",
+      "success": "#0E1117",
+      "danger": "#008BBC",
+      "warning": "#008BBC",
+      "paper": "#F9FCFF",
+      "tone": "#0E1117",
+      "spot": "#008BBC"
+    },
+    "look": {
+      "texture": {
+        "kind": "halftone",
+        "amount": 0.16
+      },
+      "stroke": 1.4,
+      "tempo": 0.97
+    }
+  },
+  "tags": {
+    "mood": [
+      "극적",
+      "역동적",
+      "대담한",
+      "만화",
+      "흑백",
+      "밝은",
+      "차가운",
+      "아날로그"
+    ],
+    "light": "light",
+    "use": [
+      "공개",
+      "홍보",
+      "결정타",
+      "순서",
+      "이야기",
+      "숫자"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 18.34,
+      "inkSoft": 13.62,
+      "dim": 6.45,
+      "accentText": 4.87,
+      "accent": 3.75,
+      "onAccent": 5.25,
+      "success~danger": 0.422,
+      "success~warning": 0.422,
+      "accent~ink": 0.422
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.slam"
+  }
+}

package/themes/marble-run/THEME.md

@@ -0,0 +1,73 @@
+# 구슬 레일 `marble-run`
+
+**비유: 요청이 구슬이 되어 강철 레일을 구르고, 깔때기·갈림판·관문·투명 관 같은 장치가 길과 값과 수를 정한다.** 벽에 걸린 롤링볼 조형(Kamiński·Wintergatan·Alex Schmid) — 호두나무 벽에 강철 두 가닥 레일, 회사마다 색유리 구슬, 화면 글은 놋쇠 명판에 새긴다. 정보는 「구슬이 어디로 굴러가 어디에 모이나」로 말한다.
+
+## 기술 낱말이 이 세계에서 되는 것
+
+| 기술 | 구슬 조형 | 화면에서 |
+|---|---|---|
+| 요청 | 구슬 | `marbles` — 내리막에서 빨라지며 구른다 |
+| 공급자(회사) | 구슬 색 · 그 회사 레일 | `marble1–9` 색, 레일 끝 명판 |
+| 게이트웨이 한 주소 | 깔때기 — 여러 레일이 한 구멍으로 | `funnel` |
+| 라우팅 | 갈림판 — 넘어간 쪽 갈래로 간다 | `flipper` |
+| 폴백 | 갈림판이 다른 갈래로 넘어간다 | `flipper` 의 `flips`·`aims` |
+| 캐시 | 받침 홈 — 이미 굴러온 구슬이 컵·관에 머물러 있다가 바로 나간다 | `tubes` 에 쌓인 구슬 |
+| 모델 수 · 숫자 | 투명 관에 쌓인 구슬 높이 | `tubes` + `plaque` 가 센다 |
+| 비용 | 관문 — 구슬이 지나는 값 | `tollGate` |
+| 지연 | 구르는 시간 — 평평한 레일을 같은 빠르기로 구르면 길이가 곧 시간 | `marbles` `v0` |
+| 시간대 가격 | 하루를 도는 시계 고리, 한 시간대만 다른 운임 색 | `clockWheel` |
+| 드롭(큰 수) | 방출 문이 열려 구슬 더미가 한꺼번에 쏟아진다 | `releaseGate` |
+
+## 맞는 내용·용도
+
+- 흐름·분배·누적이 있는 기술 내용 — 여러 곳에서 와서 한 곳으로(게이트웨이·큐·로드밸런서), 어디로 보낼지(라우팅·폴백), 얼마나 모였나(수·용량), 지나는 값(비용).
+- 용도: 홍보(promo)·설명(explainer)·공개(launch)·쇼츠(shorts)·피드(square). 마디마다 벽의 다른 세트로 컷, 드롭에 `releaseGate`.
+- 화면 글은 명판에 — 회사·주소·엔드포인트·모델 ID·숫자·짧은 낱말. 라틴은 Josefin Sans, 수·ID 는 DM Mono, 한글은 Pretendard.
+
+## 금지
+
+- 강철·놋쇠·호두나무 밖의 장치 색. 원색은 구슬(회사 색)에만.
+- 명판 없이 허공에 뜬 글.
+- 이유 없는 카메라 움직임(사인 흔들기·늘 미끄러지기). 카메라는 서 있거나, 드러낼 것에 다가가거나, 쏟아지는 전체를 담으려 물러난다.
+- 물리를 어긴 구슬 — 오르막을 거슬러 빨라지기, 공중에서 멈추기. 구슬은 내리막에서 빨라지고 떨어질 때는 중력으로 떨어진다.
+- 나뭇결·흠집·악기·톱니 같은 무거운 세부(헤드리스 렌더에 무겁고 정보가 아니다).
+- 슬로건·감성 문장.
+
+## 움직임
+
+- 쉬지 않는다: 구슬이 늘 구른다 — 컷마다 첫 박 안에 구슬을 굴리고 컷 끝까지 이어 굴린다(`count`·`every`·`until`). 벽은 서 있다.
+- 구도는 마디마다 바꾼다: 컷마다 벽의 다른 세트(`SET` 간격)를 본다 — 흩어진 레일 → 투명 관 → 깔때기 → 갈림판 → 방출 문 → 시계 고리 → 관문 → 첫 토큰 레일 → 고리 레일 끝 카드.
+- 박마다 큰 사건 하나: 레일이 놓이고, 명판이 톡 붙고, 갈림판이 넘어가고, 시간대 고리가 켜지고, 관문 값이 바뀌며 문이 내려앉는다.
+- 드롭은 방출 문 한 번 — 문이 젖혀지고 더미가 쏟아지며 섬광·흔들림, 카메라가 전체를 담게 한 번 물러난다.
+
+## 효과
+
+입체 테마 — 바탕은 `@kasaframe/themes/stage3d`(렌더러 하나를 장면끼리 돌려 쓴다). 첫 효과 `marbleStage`(layer)가 무대를 만들고, 나머지(rig)는 `stage.add(…)` 로 얹는다. 같은 레포 안에서는 `effects.ts` 를 바로, 프로젝트에서는 `fx("marble-run")`. 좌표는 벽 위 (x, y), 벽에서 나온 z(레일은 0.6 쯤). 카메라 거리 22 면 화면에 가로 22·세로 12.6 쯤 담긴다.
+
+| 효과 | 꼴 | 하는 일 |
+|---|---|---|
+| `marbleStage` | layer | 무대 — 호두나무 벽·키라이트·방 빛, 컷마다 다른 세트, 카메라 키 |
+| `rail` | rig | 강철 두 가닥 레일이 놓여 가고 받침대가 벽에 물린다 |
+| `marbles` | rig | 구슬 = 요청, 에너지 보존 빠르기, `arrivals` |
+| `funnel` | rig | 깔때기 = 한 주소, 소용돌이 돌아 한 구멍으로, `exits` |
+| `flipper` | rig | 갈림판 = 라우팅·폴백, `aims` 로 갈래 여럿 |
+| `tubes` | rig | 투명 관 = 쌓인 수, `landed(i, t)` |
+| `plaque` | rig | 놋쇠 명판 — 글은 늘 여기에, 함수 글이면 다시 새긴다 |
+| `tollGate` | rig | 관문 = 비용, 값이 바뀌면 한 번 내려앉는다 |
+| `clockWheel` | rig | 하루 = 시계 고리, 시간대 고리가 켜진다 |
+| `releaseGate` | rig | 드롭 = 방출 문, `fill` 이면 더미가 차오른다 |
+
+## 장면 문법 슬롯 — `slots.ts`
+
+| 슬롯 | 채운 것 |
+|---|---|
+| `surface` | 호두나무 벽 — 3D 로 한 번 그려 서 있다(`stillStage`) |
+| `panel` | 나무 명판 — 짙은 판에 놋쇠 테·나사 넷, 붙는 순간 살짝 눌렸다 선다 |
+| `land` | 구슬이 떨어져 앉듯 통통 튀다 선다(0.6초) |
+| `write` | 명판에 새기기 — 한 자씩, 막 새긴 글자는 놋쇠빛 |
+| `trace` | 강철 두 가닥이 놓이고 그 위를 구슬이 구른다 |
+| `drop` | 구슬 한 줌이 튀어 올랐다 떨어지고 섬광 한 번 |
+
+색 칸: `steel`·`brass`·`engrave`(명판 글) 은 장치, `marble1–9` 는 회사 구슬. 변주는 벽 나무(호두·자작·흑단)·금속(놋쇠·구리·크롬)·구슬 색 벌을 바꾼다.
+
+견본: `sample/` — OpenGateway 소개 15초(docs/briefs/og-intro-15s.md), 곡 kawaii-friends.mp3 4–19초(드롭 7.34초). 회사 아홉의 따로 놓인 레일 → 투명 관에 쌓인 구슬 = 모델 수 → 양쪽 레일이 깔때기(한 주소)로 모여 한 레일로 → 갈림판이 박마다 모델 ID 갈래로 → 방출 문 뒤로 102 개가 차오른다 → 드롭에 쏟아진다 → 시계 고리 00–10 −90% → 입력·출력 관문 값이 1/10 로 → 첫 토큰 셋이 그 ms 만에 닿는다 → 고리 레일이 두른 명판 끝 카드.