kasaframe 0.1.1 → 0.1.4

package/themes/orbit-system/variants/wine-amber.json

@@ -0,0 +1,127 @@
+{
+  "id": "wine-amber",
+  "world": "orbit-system",
+  "name": "Wine Amber",
+  "desc": "포도주빛 바탕에 호박색 강조 · 또렷한 기하 고딕 · 고운 필름 입자",
+  "params": {
+    "scheme": "dark",
+    "bgL": 0.1224,
+    "tint": {
+      "h": 42.9126,
+      "c": 0.0506
+    },
+    "inkL": 0.9383,
+    "hue": 58.576,
+    "chroma": 1.0112,
+    "fonts": "suit",
+    "texture": {
+      "kind": "grain",
+      "amount": 0.55
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 0.99,
+    "density": 1
+  },
+  "style": {
+    "scheme": "dark",
+    "colors": {
+      "bg": "#120200",
+      "surface": "#210702",
+      "raised": "#2C110D",
+      "line": "#472928",
+      "ink": "#FFE6C9",
+      "inkSoft": "#E4C6A4",
+      "dim": "#AB8B8C",
+      "accent": "#FFAB67",
+      "accentSoft": "#FFD1A5",
+      "accentText": "#FFBC82",
+      "onAccent": "#120200",
+      "success": "#7FD8B4",
+      "danger": "#FF7A5C",
+      "warning": "#F2D16B",
+      "orbit": "#F5D6AC",
+      "night": "#133D6B",
+      "teal": "#62B29A",
+      "rust": "#D66861",
+      "sand": "#D0B08B",
+      "lilac": "#8290DB",
+      "ice": "#71A8D5"
+    },
+    "fonts": {
+      "sans": "\"SUIT Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"SUIT Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "mono": "\"JetBrains Mono\", ui-monospace, \"SUIT Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "SUIT Variable",
+          "src": "https://cdn.jsdelivr.net/gh/sun-typeface/SUIT@2.0.5/fonts/variable/ttf/SUIT-Variable.ttf",
+          "weight": "100 900"
+        },
+        {
+          "family": "Pretendard Variable",
+          "src": "https://cdn.jsdelivr.net/npm/pretendard@1.3.9/dist/web/variable/woff2/PretendardVariable.woff2",
+          "weight": "45 920"
+        },
+        {
+          "family": "JetBrains Mono",
+          "src": "https://cdn.jsdelivr.net/npm/@fontsource-variable/jetbrains-mono@5/files/jetbrains-mono-latin-wght-normal.woff2",
+          "weight": "100 800"
+        }
+      ]
+    },
+    "type": {
+      "weightDisplay": 800,
+      "weightBody": 500,
+      "tracking": "-0.02em"
+    },
+    "look": {
+      "texture": {
+        "kind": "grain",
+        "amount": 0.55
+      },
+      "tempo": 0.99
+    }
+  },
+  "tags": {
+    "mood": [
+      "우주",
+      "차분한",
+      "미래적",
+      "신비로운",
+      "어두운",
+      "따뜻한",
+      "아날로그"
+    ],
+    "light": "dark",
+    "use": [
+      "게이트웨이",
+      "라우팅",
+      "지연 비교",
+      "시간대 가격",
+      "캐시",
+      "인프라",
+      "설명"
+    ],
+    "dims": "3D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 16.88,
+      "inkSoft": 12.5,
+      "dim": 6.58,
+      "accentText": 12.35,
+      "accent": 10.91,
+      "onAccent": 10.91,
+      "success~danger": 0.115,
+      "success~warning": 0.094,
+      "danger~warning": 0.136,
+      "accent~danger": 0.078,
+      "accent~ink": 0.141
+    },
+    "frame": "kf check 통과 — 끝 구간 3.183–4초(입체라 가볍게)·끝 프레임 한 장",
+    "pattern": "hook-number.counter"
+  }
+}

package/themes/orbit-system/variants/wine-coral.json

@@ -0,0 +1,123 @@
+{
+  "id": "wine-coral",
+  "world": "orbit-system",
+  "name": "Wine Coral",
+  "desc": "포도주빛 바탕에 산호색 강조 · 레트로 고정폭 라틴 제목",
+  "params": {
+    "scheme": "dark",
+    "bgL": 0.1379,
+    "tint": {
+      "h": 31.6892,
+      "c": 0.0488
+    },
+    "inkL": 0.9167,
+    "hue": 24.6861,
+    "chroma": 0.9795,
+    "fonts": "space-mono",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 1.03,
+    "density": 1
+  },
+  "style": {
+    "scheme": "dark",
+    "colors": {
+      "bg": "#180100",
+      "surface": "#240908",
+      "raised": "#301314",
+      "line": "#492A2F",
+      "ink": "#F9DEC4",
+      "inkSoft": "#DFC0A2",
+      "dim": "#A8888D",
+      "accent": "#FF9D96",
+      "accentSoft": "#FFC4B9",
+      "accentText": "#FFAEA4",
+      "onAccent": "#180100",
+      "success": "#7FD8B4",
+      "danger": "#FF7A5C",
+      "warning": "#F2D16B",
+      "orbit": "#EFD0AA",
+      "night": "#004656",
+      "teal": "#83AA76",
+      "rust": "#C86695",
+      "sand": "#D5A597",
+      "lilac": "#4F9BCF",
+      "ice": "#57ADBC"
+    },
+    "fonts": {
+      "sans": "\"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"Space Mono\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "mono": "\"Space Mono\", ui-monospace, \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "Space Mono",
+          "src": "https://cdn.jsdelivr.net/gh/google/fonts@bd8f81ddb5c74d5c8897b36ad88b440266245103/ofl/spacemono/SpaceMono-Regular.ttf",
+          "weight": "400"
+        },
+        {
+          "family": "Space Mono",
+          "src": "https://cdn.jsdelivr.net/gh/google/fonts@bd8f81ddb5c74d5c8897b36ad88b440266245103/ofl/spacemono/SpaceMono-Bold.ttf",
+          "weight": "700"
+        },
+        {
+          "family": "Pretendard Variable",
+          "src": "https://cdn.jsdelivr.net/npm/pretendard@1.3.9/dist/web/variable/woff2/PretendardVariable.woff2",
+          "weight": "45 920"
+        }
+      ]
+    },
+    "type": {
+      "weightDisplay": 700,
+      "weightBody": 500,
+      "tracking": "-0.01em"
+    },
+    "look": {
+      "tempo": 1.03
+    }
+  },
+  "tags": {
+    "mood": [
+      "우주",
+      "차분한",
+      "미래적",
+      "신비로운",
+      "어두운",
+      "따뜻한",
+      "기술적"
+    ],
+    "light": "dark",
+    "use": [
+      "게이트웨이",
+      "라우팅",
+      "지연 비교",
+      "시간대 가격",
+      "캐시",
+      "인프라",
+      "설명"
+    ],
+    "dims": "3D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 15.59,
+      "inkSoft": 11.65,
+      "dim": 6.26,
+      "accentText": 11.36,
+      "accent": 10.05,
+      "onAccent": 10.05,
+      "success~danger": 0.115,
+      "success~warning": 0.094,
+      "danger~warning": 0.136,
+      "accent~danger": 0.076,
+      "accent~ink": 0.119
+    },
+    "frame": "kf check 통과 — 끝 구간 3.183–4초(입체라 가볍게)·끝 프레임 한 장",
+    "pattern": "hook-number.counter"
+  }
+}

package/themes/orbit-system/variants/wine-magenta.json

@@ -0,0 +1,126 @@
+{
+  "id": "wine-magenta",
+  "world": "orbit-system",
+  "name": "Wine Magenta",
+  "desc": "포도주빛 바탕에 자홍 강조 · 또렷한 기하 고딕 · 고운 필름 입자",
+  "params": {
+    "scheme": "dark",
+    "bgL": 0.2187,
+    "tint": {
+      "h": 359.6466,
+      "c": 0.0246
+    },
+    "inkL": 0.9157,
+    "hue": 334.3026,
+    "chroma": 0.948,
+    "fonts": "suit",
+    "texture": {
+      "kind": "grain",
+      "amount": 0.55
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 0.94,
+    "density": 1
+  },
+  "style": {
+    "scheme": "dark",
+    "colors": {
+      "bg": "#24151A",
+      "surface": "#2F1F26",
+      "raised": "#392832",
+      "line": "#503D4B",
+      "ink": "#F0E1CE",
+      "inkSoft": "#D9C5B0",
+      "dim": "#A792A0",
+      "accent": "#F79CE5",
+      "accentSoft": "#FDC0E7",
+      "accentText": "#FAABE5",
+      "onAccent": "#24151A",
+      "success": "#7FD8B4",
+      "danger": "#FF7A5C",
+      "warning": "#F2D16B",
+      "orbit": "#E7D3B6",
+      "night": "#005C45",
+      "teal": "#B9A167",
+      "rust": "#A380D7",
+      "sand": "#D4A8BE",
+      "lilac": "#35AFAA",
+      "ice": "#75B594"
+    },
+    "fonts": {
+      "sans": "\"SUIT Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"SUIT Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "mono": "\"JetBrains Mono\", ui-monospace, \"SUIT Variable\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "SUIT Variable",
+          "src": "https://cdn.jsdelivr.net/gh/sun-typeface/SUIT@2.0.5/fonts/variable/ttf/SUIT-Variable.ttf",
+          "weight": "100 900"
+        },
+        {
+          "family": "Pretendard Variable",
+          "src": "https://cdn.jsdelivr.net/npm/pretendard@1.3.9/dist/web/variable/woff2/PretendardVariable.woff2",
+          "weight": "45 920"
+        },
+        {
+          "family": "JetBrains Mono",
+          "src": "https://cdn.jsdelivr.net/npm/@fontsource-variable/jetbrains-mono@5/files/jetbrains-mono-latin-wght-normal.woff2",
+          "weight": "100 800"
+        }
+      ]
+    },
+    "type": {
+      "weightDisplay": 800,
+      "weightBody": 500,
+      "tracking": "-0.02em"
+    },
+    "look": {
+      "texture": {
+        "kind": "grain",
+        "amount": 0.55
+      },
+      "tempo": 0.94
+    }
+  },
+  "tags": {
+    "mood": [
+      "우주",
+      "차분한",
+      "미래적",
+      "신비로운",
+      "어두운",
+      "아날로그"
+    ],
+    "light": "dark",
+    "use": [
+      "게이트웨이",
+      "라우팅",
+      "지연 비교",
+      "시간대 가격",
+      "캐시",
+      "인프라",
+      "설명"
+    ],
+    "dims": "3D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 13.59,
+      "inkSoft": 10.49,
+      "dim": 6.07,
+      "accentText": 10.05,
+      "accent": 9,
+      "onAccent": 9,
+      "success~danger": 0.115,
+      "success~warning": 0.094,
+      "danger~warning": 0.136,
+      "accent~danger": 0.135,
+      "accent~ink": 0.139
+    },
+    "frame": "kf check 통과 — 끝 구간 3.183–4초(입체라 가볍게)·끝 프레임 한 장",
+    "pattern": "hook-number.counter"
+  }
+}

package/themes/origami-fold/THEME.md

@@ -0,0 +1,74 @@
+# 종이접기 `origami-fold`
+
+**비유: 정보가 종이에 찍혀 접혔다 펴지며 드러나고, 접으면 줄어든다 — 압축은 아코디언 접기, 요청은 종이비행기, 개수는 쌓이는 종이.** 초록 커팅 매트 위의 탁자. 카드가 펼쳐지면 안쪽에 찍힌 글이 드러나고, 값이 바뀔 땐 접었다 다시 편다. 줄어드는 것(압축·할인)은 아코디언으로 접혀 1/N 이 된다. 종이는 늘어나지 않는다 — 모든 움직임이 실제로 접을 수 있는 경첩이다.
+
+## 기술 개념이 이 세계에서 되는 것
+
+| 개념 | 종이접기에서 | 효과 |
+|---|---|---|
+| 압축·캐시 압축 | 아코디언 접기 — 띠가 산·골로 접혀 길이가 1/N(57× 면 57 분의 1) | `pleatFold` |
+| 비용·할인 | 값 막대(세운 종이)가 접혀 1/10 이 된다(−90%) | `pleatFold` axis y |
+| 요청 | 종이비행기 — 날아가 앉는다 | `paperPlane` |
+| 지연 | 나는 시간 — 빠른 비행기가 먼저 앉는다 | `paperPlane` dur |
+| 모델·회사 | 색종이 한 장(회사 색), 펼친 카드 안의 이름 | `foldCard` · `sheetStack` |
+| 개수 | 쌓이는 종이 — 한 장 = 하나 | `sheetStack` |
+| 게이트웨이·한 주소 | 세운 큰 카드 — 모든 비행기가 그 앞에 앉는다 | `popUp` · `paperPlane` |
+| 바뀌는 값·폴백 | 카드를 접었다 다시 펴면 다른 글 — 같은 카드, 다른 값 | `foldCard` steps |
+| 캐시 적중 | 이미 접힌 자국 — 다시 접으면 빨리 접힌다(같은 경첩) | `pleatFold` keys |
+
+## 맞는 내용·용도
+
+- 줄이고 접고 모으는 이야기 — 압축·캐시·비용 절감·요청 흐름·개수. 「무엇이 얼마나 줄었나」를 접은 횟수와 길이로.
+- 용도: 설명(explainer)·홍보(promo)·쇼츠(shorts)·공개(launch)·피드(square). 드롭에 `foldBurst`.
+- 화면 글: 종이에 찍힌 글(짙은 print 잉크) — 주소·모델 ID·숫자·짧은 낱말. 매트 위 2D 글은 크림 ink.
+
+## 금지
+
+- 늘어나는 종이·말랑한 변형(젤리·풍선) — 접기는 경첩 회전뿐, 길이가 그대로다.
+- 학·인형 같은 복잡한 작품 모양 — 정보가 안 담긴다. 카드·띠·막대·비행기·더미만.
+- 광택·금속·유리 재질, 회백·회청 바탕(다른 3D 세계의 결) — 매트한 종이와 초록 매트.
+- 이유 없이 떠도는 카메라. 카메라는 박에 떠나 박에 내려앉는다.
+- 슬로건·감성 문장.
+
+## 움직임
+
+- 쉬지 않는다: 종이가 접히고 펴지고, 비행기가 날고, 종이가 한 장씩 쌓인다. 한 컷에 늘 하나는 움직이게 박을 이어 둔다.
+- 구도는 마디마다 바꾼다: 컷마다 탁자 위 다른 세트(세트를 120 떨어뜨린다 — 빛·매트는 지금 세트를 따라간다).
+- 박마다 큰 사건 하나: 카드가 펼쳐지거나 다시 접히고, 막대가 접혀 내려앉고, 비행기가 앉고, 카드가 일어선다.
+- 카메라는 키 하나가 움직임 하나 — 드러낼 것에 다가가기, 전체를 담게 물러나기, 드롭에 낮은 자리에서 확 물러나기.
+
+## 효과
+
+입체 테마 — 바탕은 `@kasaframe/themes/stage3d`. 첫 효과(layer)가 무대를 만들고 나머지(rig)는 `stage.add(…)` 로 얹는다. 같은 레포 안에서는 `effects.ts` 를 바로, 프로젝트에서는 `fx("origami-fold")`. 장면 끝에서 `return (t) => stage(t)`.
+
+| 효과 | 꼴 | 하는 일 |
+|---|---|---|
+| `paperStage` | layer | 공작 탁자 — 초록 커팅 매트, 빛 하나와 그림자, 박에 맞춘 카메라 키 |
+| `foldCard` | rig | 접힌 카드 — 펼치면 안쪽 글, `steps` 로 접었다 펴며 값이 바뀐다, `draw` 로 그림 |
+| `popUp` | rig | 세우는 카드 — 엎드렸다 일어선다, `until` 로 눕는다, 함수 글 |
+| `pleatFold` | rig | 아코디언 접기 — 길이 1/ratio, `axis` x·y, `tip(t)` |
+| `paperPlane` | rig | 종이비행기 — 휜 길로 날아 앉는다(`stay`), `rest` |
+| `sheetStack` | rig | 종이 더미 — 한 장씩 쌓인다, `shown(t)`·`top(t)` |
+| `foldBurst` | rig | 드롭 — 네 날개 종이가 펼쳐져 숫자가 드러나고 비행기가 사방으로, 흔들림(dropBurst) |
+
+- 종이에 찍는 글은 캔버스 텍스처라 검사의 화면 글 훑기가 못 읽는다 — 꼭 읽혀야 하는 글은 크게, 카드 폭 안에(넘치면 줄여 찍는다).
+- 아코디언 접기의 ratio 는 원래 길이의 몇 분의 1 인가 — 칸 수(panels)보다 커도 된다(cos φ = 1/ratio).
+
+## 장면 문법 슬롯 — `slots.ts`
+
+패턴이 테마 이름 없이 부르는 자리(`themeSlots("origami-fold")`). 전부 DOM·캔버스 2D.
+
+| 슬롯 | 채운 것 |
+|---|---|
+| `surface` | 초록 커팅 매트 — 반 칸·두 칸 눈금, 서 있다 |
+| `panel` | 색종이 판 — 반으로 접힌 인디고 종이의 오른쪽 장이 넘어오며 펼쳐진다(가운데 접선 그늘). 강조면 주홍 |
+| `land` | 세워 붙인다 — 아래 접선을 축으로 일어선다(0.6초) |
+| `write` | 글자 접어 세우기 — 글자마다 눕혀 있던 종이가 차례로 일어선다 |
+| `trace` | 종이비행기 길 — 접는 선 점선이 꼬리를 따라 그어지고, 비행기가 그 길을 되풀이해 난다 |
+| `drop` | 종이 조각이 흩날리며 떨어지고 옅은 섬광(dropBurst) |
+
+견본: `sample/` — 공통 주제 「OpenGateway 소개 15초」(docs/briefs/og-intro-15s.md), kawaii-friends 4.0–19.0초(드롭 7.34초), 장면 넷 × 마디마다 컷. 흩어진 카드 아홉이 펼쳐져 회사 이름 → 종이비행기가 제각각 → 회사별 종이 더미(장 수 = 모델 수) → 주소 카드 앞에 비행기 넷(엔드포인트) → 같은 카드가 접혔다 펴지며 모델 ID 가 바뀐다 → 종이 102 장이 쌓인다 → 드롭: 네 날개 종이가 펼쳐져 102 → 시마다 세운 막대 중 00–10 시가 아코디언으로 1/10 → 정가 막대가 1/10 로 접힌다 → 첫 토큰 비행기 셋이 빠른 순서로 → 펼쳐지는 OG 카드.
+
+## 변주가 바꿔도 되는 것
+
+매트 바탕은 어두운 쪽이 기본이고 밝은 탁자도 된다. 색종이·강조 색상은 함께 같은 각도로 돌고, 글꼴은 손맛 나는 제목·돋움 짝까지, 질감은 없음·종이·알갱이.