kasaframe 0.1.1 → 0.1.4

package/themes/paper-cutout/variants/sand-blue.json

@@ -0,0 +1,123 @@
+{
+  "id": "sand-blue",
+  "world": "paper-cutout",
+  "name": "Sand Blue",
+  "desc": "모래빛 바탕에 파랑 강조 · 꽉 찬 검은 고딕 제목",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9572,
+    "tint": {
+      "h": 76.2286,
+      "c": 0.0304
+    },
+    "inkL": 0.2879,
+    "hue": 260.6279,
+    "chroma": 1.1227,
+    "fonts": "black-han",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 1.09,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#FDEFDB",
+      "surface": "#FFF8EF",
+      "raised": "#F1E0C8",
+      "line": "#D9C7AC",
+      "ink": "#003601",
+      "inkSoft": "#06480F",
+      "dim": "#3C5B3F",
+      "accent": "#307CFF",
+      "accentSoft": "#B2C9FF",
+      "accentText": "#1D5ED2",
+      "onAccent": "#060606",
+      "success": "#003601",
+      "danger": "#307CFF",
+      "warning": "#E9AA25",
+      "paper": "#FDEFDB",
+      "sheet1": "#307CFF",
+      "sheet2": "#E9AA25",
+      "sheet3": "#003601",
+      "sheet1Deep": "#1C59C6",
+      "sheet2Deep": "#A372CF",
+      "sheet3Deep": "#002000",
+      "shade": "#3B2615"
+    },
+    "fonts": {
+      "sans": "\"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"Black Han Sans\", \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "mono": "\"JetBrains Mono\", ui-monospace, \"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", monospace",
+      "faces": [
+        {
+          "family": "Black Han Sans",
+          "src": "https://cdn.jsdelivr.net/gh/google/fonts@bd8f81ddb5c74d5c8897b36ad88b440266245103/ofl/blackhansans/BlackHanSans-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": "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": 400,
+      "weightBody": 500,
+      "tracking": "-0.01em"
+    },
+    "look": {
+      "tempo": 1.09
+    }
+  },
+  "tags": {
+    "mood": [
+      "손맛",
+      "따뜻한",
+      "차분한",
+      "아날로그",
+      "입체감",
+      "밝은",
+      "차가운",
+      "선명한"
+    ],
+    "light": "light",
+    "use": [
+      "구조",
+      "단계",
+      "층",
+      "흐름",
+      "소개",
+      "설명"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 12.13,
+      "inkSoft": 9.55,
+      "dim": 6.7,
+      "accentText": 5.16,
+      "accent": 3.39,
+      "onAccent": 5.27,
+      "success~danger": 0.353,
+      "success~warning": 0.445,
+      "danger~warning": 0.276,
+      "accent~ink": 0.353
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.roll"
+  }
+}

package/themes/paper-cutout/variants/sand-green.json

@@ -0,0 +1,121 @@
+{
+  "id": "sand-green",
+  "world": "paper-cutout",
+  "name": "Sand Green",
+  "desc": "모래빛 바탕에 초록 강조 · 폭 넓고 힘 있는 브랜드 고딕",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9002,
+    "tint": {
+      "h": 54.0316,
+      "c": 0.0123
+    },
+    "inkL": 0.2879,
+    "hue": 142.1699,
+    "chroma": 0.9938,
+    "fonts": "wanted",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 0.96,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#E5DCD7",
+      "surface": "#EBE3E1",
+      "raised": "#DBCFC5",
+      "line": "#C5B8AA",
+      "ink": "#4E1313",
+      "inkSoft": "#61211E",
+      "dim": "#68443E",
+      "accent": "#0A9300",
+      "accentSoft": "#9BC9A1",
+      "accentText": "#007302",
+      "onAccent": "#060606",
+      "success": "#4E1313",
+      "danger": "#0A9300",
+      "warning": "#D99B00",
+      "paper": "#E5DCD7",
+      "sheet1": "#0A9300",
+      "sheet2": "#D99B00",
+      "sheet3": "#4E1313",
+      "sheet1Deep": "#017102",
+      "sheet2Deep": "#00978F",
+      "sheet3Deep": "#33090A",
+      "shade": "#3B2615"
+    },
+    "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": {
+      "tempo": 0.96
+    }
+  },
+  "tags": {
+    "mood": [
+      "손맛",
+      "따뜻한",
+      "차분한",
+      "아날로그",
+      "입체감",
+      "밝은"
+    ],
+    "light": "light",
+    "use": [
+      "구조",
+      "단계",
+      "층",
+      "흐름",
+      "소개",
+      "설명"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 10.9,
+      "inkSoft": 8.93,
+      "dim": 6.26,
+      "accentText": 4.5,
+      "accent": 3,
+      "onAccent": 5.01,
+      "success~danger": 0.291,
+      "success~warning": 0.445,
+      "danger~warning": 0.085,
+      "accent~ink": 0.291
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.roll"
+  }
+}

package/themes/paper-cutout/variants/sand-plum.json

@@ -0,0 +1,120 @@
+{
+  "id": "sand-plum",
+  "world": "paper-cutout",
+  "name": "Sand Plum",
+  "desc": "모래빛 바탕에 자두색 강조 · 통통하고 말랑한 팝 제목체",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.9071,
+    "tint": {
+      "h": 72.7892,
+      "c": 0.0124
+    },
+    "inkL": 0.1657,
+    "hue": 321.8228,
+    "chroma": 0.8153,
+    "fonts": "bagel",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 1,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#E6DFD8",
+      "surface": "#EDE8E3",
+      "raised": "#D9D0C3",
+      "line": "#BFB4A4",
+      "ink": "#001214",
+      "inkSoft": "#002327",
+      "dim": "#183C41",
+      "accent": "#9444A1",
+      "accentSoft": "#CCA9CA",
+      "accentText": "#6D2B77",
+      "onAccent": "#EDE8E3",
+      "success": "#001214",
+      "danger": "#9444A1",
+      "warning": "#DB9D00",
+      "paper": "#E6DFD8",
+      "sheet1": "#9444A1",
+      "sheet2": "#DB9D00",
+      "sheet3": "#001214",
+      "sheet1Deep": "#65276F",
+      "sheet2Deep": "#A65767",
+      "sheet3Deep": "#000303",
+      "shade": "#3B2615"
+    },
+    "fonts": {
+      "sans": "\"Pretendard Variable\", Pretendard, \"Noto Sans KR\", \"Apple SD Gothic Neo\", sans-serif",
+      "display": "\"Bagel Fat 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": "Bagel Fat One",
+          "src": "https://cdn.jsdelivr.net/gh/google/fonts@bd8f81ddb5c74d5c8897b36ad88b440266245103/ofl/bagelfatone/BagelFatOne-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": {}
+  },
+  "tags": {
+    "mood": [
+      "손맛",
+      "따뜻한",
+      "차분한",
+      "아날로그",
+      "입체감",
+      "밝은",
+      "귀여운"
+    ],
+    "light": "light",
+    "use": [
+      "구조",
+      "단계",
+      "층",
+      "흐름",
+      "소개",
+      "설명"
+    ],
+    "dims": "2D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 14.51,
+      "inkSoft": 12.51,
+      "dim": 9.02,
+      "accentText": 7.03,
+      "accent": 4.42,
+      "onAccent": 4.8,
+      "success~danger": 0.334,
+      "success~warning": 0.546,
+      "danger~warning": 0.224,
+      "accent~ink": 0.334
+    },
+    "frame": "kf check 통과 — 표준 장면 0–4초",
+    "pattern": "hook-number.roll"
+  }
+}

package/themes/pixel-quest/THEME.md

@@ -0,0 +1,57 @@
+# 8비트 퀘스트 `pixel-quest`
+
+**비유: 요청 한 번이 8비트 게임 한 판이 되어 화면이 찍힌다 — 용사(요청)가 칸칸이 걸어 관문(게이트웨이)에 들어가고, 비용은 코인 카운터로 정산되고, 한도는 하트 칸으로 깎인다.** 화면은 게임기 화면 한 장(1920 폭에 320칸, 한 칸 6px)이고 PICO-8 16색 안에서만 칠한다. 정보는 HUD·대화창·명령 메뉴·아이템 창으로 오른다.
+
+| 기술 개념 | 이 세계에서 |
+|---|---|
+| 요청 | 용사 — 땅을 칸칸이 걸어 관문으로 뛰어든다 |
+| 공급자(회사) | 보물상자 — 열면 그 회사의 보석이 솟는다 |
+| 모델 | 보석(아이템) — 회사마다 색, 명령 메뉴에서 하나를 고른다 |
+| 게이트웨이 한 주소 | 관문 하나와 그 위 팻말(주소). 어떤 보석을 골라도 같은 문으로 |
+| 비용 | 코인 — `coinCounter` 가 정가에서 할인값까지 틱으로 깎는다 |
+| 한도(요청 수·예산) | 하트 칸·마디 게이지 — 하나씩 깜빡이며 깎이고 찬다 |
+| 지연 | 경주와 TIME — 첫 토큰 ms 비율대로 결승선에 닿는다 |
+| 캐시 | 세이브 포인트 — 저장해 둔 판을 불러오면 코인이 안 든다 |
+| 폴백 | 1UP — 한 목숨을 잃으면 다른 레인(공급자)에서 다시 출발 |
+| 응답 | 대화창에 한 자씩 찍히는 글 |
+| 드롭·결과 | 레벨 업 — 팔레트가 한 번 번쩍이고 별이 여덟 방향으로 튄다 |
+
+## 맞는 내용·용도
+
+- 개수·가격·비용 정산·한도·순위처럼 「세고 깎이는」 숫자, 고르는 목록(모델·메뉴·옵션), 지연 비교(경주) — 개발자 도구·API·게임·인디 제품 소개.
+- 용도: 홍보(promo)·쇼츠(shorts)·공개(launch)·피드(square)·설명(explainer). 마디마다 화면(창·지도·상점) 하나, 드롭에 `levelUp`.
+- 화면 글은 모델 ID·주소·숫자·짧은 낱말(회사 이름·입력/출력·KST)만. 큰 글은 네오둥근모(16px 격자), 라벨은 Galmuri11, 목록·주소는 GalmuriMono11. 글 크기는 16·12의 배수.
+
+## 금지
+
+- PICO-8 16색(style.json 색 칸) 밖의 색, 반투명으로 만든 옅은 색, 그라데이션·흐림·둥근 모서리·부드러운 그림자 — 모서리는 한 칸 깎기, 그림자는 검정 한 칸 어긋남.
+- 칸 사이를 미끄러지는 60fps 보간. 위치는 `pixelMove`(초당 30틱, 한 칸 6px)로, 장 넘김은 `sprite`(초당 12장)로.
+- 화면 전체 빨강 섬광, 박마다 번쩍임. 번쩍임은 드롭의 `levelUp` 한 번(흰색 → 노랑).
+- 바탕 스크롤·떠다니는 장식. `tileField` 는 서 있고, 움직이는 것은 용사·코인·보석·창·글자처럼 정보를 실은 것뿐이다.
+- 실제 게임 캐릭터·로고(마리오·드래곤 퀘스트) 베끼기 — 꼴만 빌리고 스프라이트는 `kit.ts` 의 것이나 새로 찍는다.
+- 「PRESS START」「GAME OVER」 같은 게임 문구·슬로건·감성 문장.
+
+## 움직임
+
+- 쉬지 않는다: 용사가 땅을 걷고(장 두 장 + 칸 걸음), 글이 한 자씩 찍히고, 카운터가 틱으로 구른다. 다 찍힌 끝 카드도 용사가 걸어와 로고 아래에서 뛴다.
+- 구도는 마디마다 바꾼다: 지도 → 아이템 창 → 관문 → 명령 메뉴 → 형식 창 → 레벨 업 → 하루 시계 → 상점 → 경주 → 끝 카드. 장면 사이는 `tileWipe`(검정 타일이 깔렸다 걷힌다).
+- 박마다 큰 사건 하나: 상자가 떨어지고·열리고, 커서가 다음 줄로 뛰고 보석이 관문으로 날아들고, 게이지가 두 칸씩 차고, 값이 깎이고, 블록 로고가 한 줄씩 쌓인다.
+
+## 효과
+
+같은 레포 안에서는 `effects.ts` 를 바로, 프로젝트에서는 `fx("pixel-quest")`. layer 는 `build` 에서 만들고 `(t) => …` 에서 부른다. 스프라이트 그림(`SPRITES`)·격자(`unitOf`·`snap`)·창 그리기(`drawWindow`)는 `kit.ts`. 장면 하나는 보통 `tileField`(맨 아래) → 창·스프라이트·카운터 → `levelUp`·`tileWipe`(맨 위) 순서로 쌓는다.
+
+| 효과 | 꼴 | 하는 일 |
+|---|---|---|
+| `pixelMove` | value | from → to 를 한 칸씩 뚝뚝(초당 30틱), `hop` 이면 한 번 뛰어 넘는다 |
+| `sprite` | layer | 픽셀 스프라이트(hero·coin·heart·chest·chestOpen·gem·cursor·star·sun·moon) — 장 초당 12장, `swap` 으로 팔레트 칸 바꾸기, `move` 에 pixelMove |
+| `questWindow` | layer | 검정 면 흰 계단 테두리 창이 위에서부터 네 번에 열리고 줄이 한 자씩 찍힌다, 다 찍으면 ▼ |
+| `menuCursor` | layer | 명령 메뉴 — ▶ 커서가 stops 시각마다 다음 줄로 뛰고, 고른 줄이 한 번 뒤집혀 깜빡인 뒤 노랑 |
+| `coinCounter` | layer | HUD 아이콘 × 숫자 — 숫자가 틱으로 오르내리고 그동안 코인이 돈다(비용 정산) |
+| `heartGauge` | layer | 하트 칸·마디 막대가 한 칸씩 차고 깎인다, 바뀌는 칸은 깜빡인다(한도) |
+| `tileWipe` | layer | 검정 타일이 대각·줄·소용돌이 순으로 깔려 덮거나 걷힌다(화면 바꿈) |
+| `levelUp` | layer | 드롭 — 팔레트 번쩍임 한 번과 별 열여섯, 칸에 붙은 흔들림을 돌려준다 |
+| `blockBuild` | layer | 칸 지도(로고·기호)를 블록 하나씩 떨어뜨려 쌓는다 |
+| `tileField` | layer | 서 있는 바탕 — 짙은 파랑 하늘·별 점·땅 타일 두 줄, 원하면 HUD 띠 |
+
+견본: `sample/` — 공통 주제 「OpenGateway 소개 15초」, kawaii-friends 4.0–19.0초(드롭 7.34초). 보물상자 아홉이 열려 회사 보석이 솟고 → 아이템 창에 회사별 모델 수 → 블록 관문과 주소 팻말, 용사가 뛰어든다 → 명령 메뉴에서 모델 ID 를 박마다 골라 같은 관문으로 → OpenAI·Anthropic 형식 창과 차는 게이지 → 드롭 레벨 업 102 → 하루 24칸 시계 위 밤 칸 -90% → 상점 창의 deepseek 값 정산 → 첫 토큰 경주 → 블록 OG 로고와 opengateway.ai.