kasaframe 0.1.1 → 0.1.4

package/themes/water-works/style.json

@@ -0,0 +1,105 @@
+{
+  "name": "water-works",
+  "label": "배관 — 요청이 물이 되어 관을 흐른다",
+  "scheme": "light",
+  "colors": {
+    "bg": "#DCE5E0",
+    "surface": "#F7F4EA",
+    "raised": "#EEE6D2",
+    "line": "#B7C4BD",
+    "ink": "#1C2522",
+    "inkSoft": "#2A3531",
+    "dim": "#4C5A55",
+    "accent": "#C8352B",
+    "accentSoft": "#F0C4BE",
+    "accentText": "#A82A22",
+    "onAccent": "#FFFFFF",
+    "success": "#2E8A4E",
+    "danger": "#C8352B",
+    "warning": "#B5822C",
+    "pipe": "#1F5E4A",
+    "pipeDeep": "#14402F",
+    "brass": "#C59A45",
+    "steel": "#B9C0C4",
+    "water": "#2F8BD8",
+    "dial": "#F7F4EA",
+    "tile": "#CFDAD4",
+    "floor": "#B9B2A3"
+  },
+  "fonts": {
+    "sans": "\"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": "\"Space Mono\", ui-monospace, \"SF Mono\", \"Pretendard Variable\", \"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": "Space Mono",
+        "src": "https://cdn.jsdelivr.net/gh/google/fonts@main/ofl/spacemono/SpaceMono-Bold.ttf",
+        "weight": "700"
+      }
+    ]
+  },
+  "type": {
+    "hero": 180,
+    "title": 96,
+    "body": 42,
+    "caption": 30,
+    "weightDisplay": 850,
+    "weightBody": 600,
+    "tracking": "-0.02em"
+  },
+  "radius": {
+    "sm": 6,
+    "md": 10,
+    "lg": 16,
+    "pill": 999
+  },
+  "shadow": {
+    "soft": "0 6px 0 rgba(28, 37, 34, 0.18)",
+    "lift": "0 10px 0 rgba(28, 37, 34, 0.22)"
+  },
+  "motion": {
+    "beatPulse": "drops-only",
+    "shake": {
+      "on": [
+        "drop"
+      ],
+      "maxPerPhrase": 1,
+      "maxPx": 10
+    },
+    "cameraMove": "once-per-phrase",
+    "repeatSameMove": false,
+    "maxFreezeSec": 0.1,
+    "enter": "pop",
+    "ease": "outBack",
+    "durations": {
+      "fast": 0.12,
+      "base": 0.3,
+      "slow": 0.6
+    }
+  },
+  "theme": {
+    "inks": [
+      "#DCE5E0 청자 유약 타일 벽",
+      "#1F5E4A 펌프장 초록 관 · #C59A45 놋쇠 · #B9C0C4 강철",
+      "#C8352B 밸브 바퀴·바늘 빨강 — 강조",
+      "#2F8BD8 관 속 물"
+    ],
+    "texture": "반광 페인트 관과 닦은 강철, 놋쇠 테 계기. 관은 투명해 속 물덩이가 보인다. 벽은 옅은 타일 줄눈, 바닥은 돌. 따뜻한 빛 한 방향, 그림자 하나",
+    "movement": "기계는 서 있고 물이 흐른다 — 관 속 물덩이가 같은 빠르기로 줄지어 가고(유량), 밸브 바퀴가 돌면 그 갈래 흐름이 열리고 닫힌다. 계기 바늘은 값으로 가서 한 번 넘쳤다 선다. 마디마다 다른 관 선반으로 컷, 카메라는 드러낼 것에 다가갈 때만 움직인다"
+  },
+  "notes": [
+    "출처: Crossness 펌프장(Geograph CC BY-SA)·수압계(Wikimedia) — refs/NOTES.md",
+    "pipe·brass·steel·water 는 재료 색이라 변주에서 색상을 지킨다(fixedHue).",
+    "3D 안 글(이름판·계기)은 검사가 못 읽는다 — 끝 카드는 DOM 으로 겹친다."
+  ]
+}

package/themes/water-works/theme.json

@@ -0,0 +1,138 @@
+{
+  "id": "water-works",
+  "name": "배관",
+  "metaphor": "요청이 물이 되어 관을 흐른다 — 처리량은 유량, 한도는 관 굵기, 지연은 물이 관 끝에 닿는 시간",
+  "status": "approved",
+  "approvedAt": "2026-10-11",
+  "purposes": [
+    "promo",
+    "explainer",
+    "launch",
+    "demo"
+  ],
+  "aspect": [
+    "16:9",
+    "9:16",
+    "1:1"
+  ],
+  "effects": [
+    {
+      "name": "pumpHall",
+      "kind": "layer",
+      "does": "펌프장 무대 — 청자 타일 벽 앞 관 선반을 정면 약간 위에서(망원 렌즈), 따뜻한 빛 한 방향·그림자 하나. 컷마다 다른 세트, 카메라는 키를 둘 때만 다가간다",
+      "use": "const hall = pumpHall(root, { ctx, shots: [{ from: 0, to: 1.41, keys: [{ t: 0, look: [0, 0, 0], dist: 17 }] }] }); /* (t) => hall(t) */"
+    },
+    {
+      "name": "pipeRun",
+      "kind": "rig",
+      "does": "관 = 요청 길. 초록이 비치는 투명 관 속 물덩이가 같은 빠르기로 줄지어 간다(유량 = 처리량), 굵기 = 한도. at 에 관이 앞에서부터 놓이고 fillAt 에 물머리가 나아간다(끝에 닿는 시간 = 지연). flow 를 함수로 주면 밸브가 흐름을 바꾼다",
+      "use": "hall.add(pipeRun(hall, { ctx, points: [[-9, 0.6, 0], [9, 0.6, 0]], r: 0.46, at: 0, flow: 3.4, fillAt: 0.1 }))"
+    },
+    {
+      "name": "valve",
+      "kind": "rig",
+      "does": "밸브 — 관 위 빨간 바퀴가 open(t) 만큼 돌며 줄기가 오른다. 모델 고르기 = 그 갈래만 열기, 값 줄이기 = 조이기",
+      "use": "hall.add(valve(hall, { ctx, pos: [x, 0.4, 0], size: 0.62, open: (t) => (t > 1.4 ? 1 : 0) }))"
+    },
+    {
+      "name": "gauge",
+      "kind": "rig",
+      "does": "수압계 — 놋쇠 테 미색 눈금판에 빨간 바늘이 value(t)(0..1) 를 가리킨다, 초록 띠 = 좋은 구간. sweep 360 이면 하루 시계(00 이 위)",
+      "use": "hall.add(gauge(hall, { ctx, pos: [0, 1, 0.1], size: 2, value: (t) => needle(t, { at: 0.5, to: 0.8 }), ticks: [\"0\", \"200\", \"400\"], band: [0, 0.7], unit: \"ms\" }))"
+    },
+    {
+      "name": "needle",
+      "kind": "value",
+      "does": "바늘 곡선 — 값으로 가서 한 번 넘쳤다 선다(gauge·tank 의 값에)",
+      "use": "value: (t) => needle(t, { at: 1.2, from: 0, to: 0.76, dur: 0.4 })"
+    },
+    {
+      "name": "tank",
+      "kind": "rig",
+      "does": "탱크 = 공급자. 강철 테 투명 통 속 수위가 level(t) 로 차오른다 — 수위가 그 회사의 값",
+      "use": "hall.add(tank(hall, { ctx, pos: [-6, -2.3, 0], at: 0.3, level: (t) => 0.9 * needle(t, { at: 0.45, to: 1 }) }))"
+    },
+    {
+      "name": "nameplate",
+      "kind": "rig",
+      "does": "이름판·계수기(plate·brass·counter) — 굵은 글자 판이 아래에서 「텅」 서고, text 가 함수면 글이 바뀔 때 넘김판처럼 한 번 넘어온다",
+      "use": "hall.add(nameplate(hall, { ctx, text: (t) => (t > 2 ? \"$0.03\" : \"$0.30\"), pos: [3, 1, 0.3], height: 1, look: \"counter\", font: \"mono\" }))"
+    },
+    {
+      "name": "surge",
+      "kind": "rig",
+      "does": "드롭 — 밸브가 한꺼번에 열려 수압이 터진다: 물보라 알갱이가 튀고 파문 고리 셋이 번진다. shake·punch 를 돌려준다(shake 는 hall.el 에)",
+      "use": "const s = burst(t); applyStyle(hall.el, s.shake)  // burst = surge(hall, { ctx, drop: 0, pos: [0, 0.4, 0.4] })"
+    },
+    {
+      "name": "brassCard",
+      "kind": "layer",
+      "does": "끝 카드 — 놋쇠 테·나사의 미색 이름판(DOM — 검사가 읽는다)이 서고 로고 → 이름 → 주소 차례로 박힌다",
+      "use": "const card = brassCard(root, { ctx, rect: { x: 520, y: 170, w: 880, h: 640 }, logo: svg, title: \"opengateway.ai\", sub: \"https://apis.opengateway.ai/v1\", at: 1.5 })"
+    }
+  ],
+  "vary": {
+    "scheme": [
+      "light"
+    ],
+    "hue": [
+      [
+        0,
+        360
+      ]
+    ],
+    "chroma": [
+      0.8,
+      1.15
+    ],
+    "tint": [
+      0.005,
+      0.03
+    ],
+    "bg": {
+      "light": [
+        0.88,
+        0.95
+      ]
+    },
+    "fixedHue": [
+      "water",
+      "brass",
+      "steel"
+    ],
+    "fonts": [
+      "base",
+      "suit",
+      "wanted",
+      "plex",
+      "space-mono"
+    ],
+    "texture": [
+      "none"
+    ],
+    "tempo": [
+      0.9,
+      1.15
+    ]
+  },
+  "tags": {
+    "mood": [
+      "기계적",
+      "단단한",
+      "산업",
+      "정밀",
+      "묵직한"
+    ],
+    "light": "light",
+    "use": [
+      "처리량",
+      "흐름",
+      "인프라",
+      "한도",
+      "파이프라인",
+      "시스템",
+      "설명"
+    ],
+    "dims": "3D"
+  }
+}

package/themes/water-works/variants/blush-rose.json

@@ -0,0 +1,123 @@
+{
+  "id": "blush-rose",
+  "world": "water-works",
+  "name": "Blush Rose",
+  "desc": "연분홍 바탕에 장밋빛 강조 · 레트로 고정폭 라틴 제목",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.8945,
+    "tint": {
+      "h": 349.1968,
+      "c": 0.028
+    },
+    "inkL": 0.2355,
+    "hue": 3.4386,
+    "chroma": 0.9933,
+    "fonts": "space-mono",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 0.91,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#ECD5DF",
+      "surface": "#FFE7EA",
+      "raised": "#FCD6D1",
+      "line": "#C5B5BC",
+      "ink": "#221C20",
+      "inkSoft": "#312B2F",
+      "dim": "#554F53",
+      "accent": "#AE1957",
+      "accentSoft": "#E8BDC7",
+      "accentText": "#9D2050",
+      "onAccent": "#FFF6FA",
+      "success": "#2E8A4E",
+      "danger": "#AE1957",
+      "warning": "#B07E27",
+      "pipe": "#335632",
+      "pipeDeep": "#22391C",
+      "brass": "#BF943F",
+      "steel": "#C7B1C3",
+      "water": "#2985D1",
+      "dial": "#FFE7EA",
+      "tile": "#DECAD3",
+      "floor": "#C5A3A2"
+    },
+    "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": 0.91
+    }
+  },
+  "tags": {
+    "mood": [
+      "기계적",
+      "단단한",
+      "산업",
+      "정밀",
+      "묵직한",
+      "밝은",
+      "기술적"
+    ],
+    "light": "light",
+    "use": [
+      "처리량",
+      "흐름",
+      "인프라",
+      "한도",
+      "파이프라인",
+      "시스템",
+      "설명"
+    ],
+    "dims": "3D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 12.05,
+      "inkSoft": 9.94,
+      "dim": 5.76,
+      "accentText": 5.49,
+      "accent": 4.14,
+      "onAccent": 5.42,
+      "success~danger": 0.065,
+      "danger~warning": 0.159,
+      "success~warning": 0.043,
+      "accent~ink": 0.173
+    },
+    "frame": "kf check 통과 — 끝 구간 3.183–4초(입체라 가볍게)·끝 프레임 한 장",
+    "pattern": "hook-number.roll"
+  }
+}

package/themes/water-works/variants/chalk-blue.json

@@ -0,0 +1,124 @@
+{
+  "id": "chalk-blue",
+  "world": "water-works",
+  "name": "Chalk Blue",
+  "desc": "분필빛 바탕에 파랑 강조 · 레트로 고정폭 라틴 제목",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.8857,
+    "tint": {
+      "h": 23.6349,
+      "c": 0.0084
+    },
+    "inkL": 0.2546,
+    "hue": 252.9712,
+    "chroma": 0.886,
+    "fonts": "space-mono",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 1.13,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#DFD7D7",
+      "surface": "#F9E5E0",
+      "raised": "#F0D8C8",
+      "line": "#BBB8B5",
+      "ink": "#232223",
+      "inkSoft": "#313231",
+      "dim": "#535453",
+      "accent": "#056FCA",
+      "accentSoft": "#B3CAE5",
+      "accentText": "#015CAA",
+      "onAccent": "#FFF0F4",
+      "success": "#2E8A4E",
+      "danger": "#056FCA",
+      "warning": "#AF7C25",
+      "pipe": "#6E4238",
+      "pipeDeep": "#4D2B27",
+      "brass": "#BB954D",
+      "steel": "#BDB4BC",
+      "water": "#3A86CA",
+      "dial": "#F9E5E0",
+      "tile": "#D2CDCB",
+      "floor": "#BCA79C"
+    },
+    "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.13
+    }
+  },
+  "tags": {
+    "mood": [
+      "기계적",
+      "단단한",
+      "산업",
+      "정밀",
+      "묵직한",
+      "밝은",
+      "차가운",
+      "기술적"
+    ],
+    "light": "light",
+    "use": [
+      "처리량",
+      "흐름",
+      "인프라",
+      "한도",
+      "파이프라인",
+      "시스템",
+      "설명"
+    ],
+    "dims": "3D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 11.17,
+      "inkSoft": 9.15,
+      "dim": 5.36,
+      "accentText": 4.76,
+      "accent": 3.6,
+      "onAccent": 4.62,
+      "success~danger": 0.04,
+      "success~warning": 0.043,
+      "danger~warning": 0.209,
+      "accent~ink": 0.317
+    },
+    "frame": "kf check 통과 — 끝 구간 3.183–4초(입체라 가볍게)·끝 프레임 한 장",
+    "pattern": "hook-number.roll"
+  }
+}

package/themes/water-works/variants/chalk-cyan-2.json

@@ -0,0 +1,96 @@
+{
+  "id": "chalk-cyan-2",
+  "world": "water-works",
+  "name": "Chalk Cyan 2",
+  "desc": "분필빛 바탕에 하늘빛 청록 강조",
+  "params": {
+    "scheme": "light",
+    "bgL": 0.8845,
+    "tint": {
+      "h": 199.765,
+      "c": 0.0091
+    },
+    "inkL": 0.1644,
+    "hue": 213.8206,
+    "chroma": 0.924,
+    "fonts": "base",
+    "texture": {
+      "kind": "none",
+      "amount": 0
+    },
+    "stroke": 1,
+    "radius": null,
+    "tempo": 1.05,
+    "density": 1
+  },
+  "style": {
+    "scheme": "light",
+    "colors": {
+      "bg": "#D2DBDB",
+      "surface": "#EFEBE7",
+      "raised": "#E5DCCE",
+      "line": "#ABB7B5",
+      "ink": "#0A0F10",
+      "inkSoft": "#181F1F",
+      "dim": "#3B4545",
+      "accent": "#006D7E",
+      "accentSoft": "#A2CED7",
+      "accentText": "#005664",
+      "onAccent": "#F8F7FD",
+      "success": "#2E8A4E",
+      "danger": "#006D7E",
+      "warning": "#AF7C25",
+      "pipe": "#592E40",
+      "pipeDeep": "#351726",
+      "brass": "#B38C3F",
+      "steel": "#ADB3BC",
+      "water": "#267ABF",
+      "dial": "#EFEBE7",
+      "tile": "#C5CFCE",
+      "floor": "#ACA49A"
+    },
+    "look": {
+      "tempo": 1.05
+    }
+  },
+  "tags": {
+    "mood": [
+      "기계적",
+      "단단한",
+      "산업",
+      "정밀",
+      "묵직한",
+      "밝은",
+      "차가운"
+    ],
+    "light": "light",
+    "use": [
+      "처리량",
+      "흐름",
+      "인프라",
+      "한도",
+      "파이프라인",
+      "시스템",
+      "설명"
+    ],
+    "dims": "3D"
+  },
+  "check": {
+    "ok": true,
+    "at": "2026-10-12",
+    "colors": {
+      "ink": 13.66,
+      "inkSoft": 11.85,
+      "dim": 6.99,
+      "accentText": 5.93,
+      "accent": 4.28,
+      "onAccent": 5.67,
+      "success~danger": 0.063,
+      "success~warning": 0.043,
+      "danger~warning": 0.169,
+      "accent~ink": 0.325
+    },
+    "frame": "kf check 통과 — 끝 구간 3.183–4초(입체라 가볍게)·끝 프레임 한 장",
+    "pattern": "hook-number.roll"
+  }
+}