kasaframe 0.1.5 → 0.1.7

package/sfx/tags.json

@@ -0,0 +1,545 @@
+{
+ "sets": {
+  "pop": {
+   "label": "뽁·통",
+   "desc": "물방울 뽁·나무 통·둥근 쿵에 또렷한 톡 어택 — 스티커·캐릭터·발랄한 세계"
+  },
+  "click": {
+   "label": "딸깍·째깍",
+   "desc": "역할마다 아주 작은 스위치·시계 소리만 — 계측·데이터·차분한 세계"
+  },
+  "ui": {
+   "label": "기본",
+   "desc": "가벼운 UI 소리 — 퉁김·휙·주먹 쿵에 또렷한 어택. 결을 안 고른 세계"
+  }
+ },
+ "packs": {
+  "ui": {
+   "name": "Kenney UI SFX Set",
+   "url": "https://kenney.nl/assets/ui-audio",
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "interface": {
+   "name": "Kenney Interface Sounds (1.0)",
+   "url": "https://kenney.nl/assets/interface-sounds",
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "impact": {
+   "name": "Kenney Impact Sounds (1.0)",
+   "url": "https://kenney.nl/assets/impact-sounds",
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "digital": {
+   "name": "Kenney Digital Audio",
+   "url": "https://kenney.nl/assets/digital-audio",
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "rpg": {
+   "name": "Kenney RPG Audio",
+   "url": "https://kenney.nl/assets/rpg-audio",
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "casino": {
+   "name": "Kenney Casino Audio (1.1)",
+   "url": "https://kenney.nl/assets/casino-audio",
+   "license": "CC0 1.0 (License.txt)"
+  }
+ },
+ "files": {
+  "pop/appear.wav": {
+   "set": "pop",
+   "role": "appear",
+   "dur": 0.152,
+   "lead": 0,
+   "level": -19.3,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "drop_004.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "select_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds",
+    "db": -6
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/stick.wav": {
+   "set": "pop",
+   "role": "stick",
+   "dur": 0.147,
+   "lead": 0.03,
+   "level": -20.2,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "drop_002.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "tick_004.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds",
+    "db": -4
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/land.wav": {
+   "set": "pop",
+   "role": "land",
+   "dur": 0.123,
+   "lead": 0,
+   "level": -20.7,
+   "source": {
+    "pack": "Kenney Impact Sounds (1.0)",
+    "file": "impactWood_light_000.ogg",
+    "url": "https://kenney.nl/assets/impact-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Casino Audio (1.1)",
+    "file": "chip-lay-1.ogg",
+    "url": "https://kenney.nl/assets/casino-audio",
+    "db": -4
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/hop.wav": {
+   "set": "pop",
+   "role": "hop",
+   "dur": 0.3,
+   "lead": 0.015,
+   "level": -12.5,
+   "source": {
+    "pack": "Kenney Digital Audio",
+    "file": "phaseJump1.ogg",
+    "url": "https://kenney.nl/assets/digital-audio"
+   },
+   "layer": {
+    "pack": "Kenney UI SFX Set",
+    "file": "click5.ogg",
+    "url": "https://kenney.nl/assets/ui-audio",
+    "db": -6
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/whoosh.wav": {
+   "set": "pop",
+   "role": "whoosh",
+   "dur": 0.255,
+   "lead": 0.24,
+   "level": -7.3,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "maximize_002.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/tick.wav": {
+   "set": "pop",
+   "role": "tick",
+   "dur": 0.02,
+   "lead": 0,
+   "level": -24,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "tick_002.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/select.wav": {
+   "set": "pop",
+   "role": "select",
+   "dur": 0.04,
+   "lead": 0,
+   "level": -21.6,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "select_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/type.wav": {
+   "set": "pop",
+   "role": "type",
+   "dur": 0.035,
+   "lead": 0.01,
+   "level": -21.5,
+   "source": {
+    "pack": "Kenney UI SFX Set",
+    "file": "click5.ogg",
+    "url": "https://kenney.nl/assets/ui-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/drop.wav": {
+   "set": "pop",
+   "role": "drop",
+   "dur": 0.516,
+   "lead": 0,
+   "level": -14.3,
+   "source": {
+    "pack": "Kenney Impact Sounds (1.0)",
+    "file": "impactSoft_heavy_000.ogg",
+    "url": "https://kenney.nl/assets/impact-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Impact Sounds (1.0)",
+    "file": "impactMetal_light_000.ogg",
+    "url": "https://kenney.nl/assets/impact-sounds",
+    "db": -3
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/burst.wav": {
+   "set": "pop",
+   "role": "burst",
+   "dur": 0.194,
+   "lead": 0.08,
+   "level": -16.7,
+   "source": {
+    "pack": "Kenney Digital Audio",
+    "file": "powerUp2.ogg",
+    "url": "https://kenney.nl/assets/digital-audio"
+   },
+   "layer": {
+    "pack": "Kenney Casino Audio (1.1)",
+    "file": "chips-collide-1.ogg",
+    "url": "https://kenney.nl/assets/casino-audio",
+    "db": -4
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "pop/end.wav": {
+   "set": "pop",
+   "role": "end",
+   "dur": 0.322,
+   "lead": 0,
+   "level": -10.6,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "confirmation_003.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/appear.wav": {
+   "set": "click",
+   "role": "appear",
+   "dur": 0.091,
+   "lead": 0.015,
+   "level": -23.2,
+   "source": {
+    "pack": "Kenney UI SFX Set",
+    "file": "click1.ogg",
+    "url": "https://kenney.nl/assets/ui-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/stick.wav": {
+   "set": "click",
+   "role": "stick",
+   "dur": 0.007,
+   "lead": 0,
+   "level": -24.1,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "click_003.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/land.wav": {
+   "set": "click",
+   "role": "land",
+   "dur": 0.143,
+   "lead": 0.105,
+   "level": -20.4,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "switch_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/hop.wav": {
+   "set": "click",
+   "role": "hop",
+   "dur": 0.063,
+   "lead": 0.005,
+   "level": -13,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "toggle_004.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/whoosh.wav": {
+   "set": "click",
+   "role": "whoosh",
+   "dur": 0.22,
+   "lead": 0.1,
+   "level": -20.3,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "scroll_004.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/tick.wav": {
+   "set": "click",
+   "role": "tick",
+   "dur": 0.021,
+   "lead": 0,
+   "level": -27.1,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "tick_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/select.wav": {
+   "set": "click",
+   "role": "select",
+   "dur": 0.04,
+   "lead": 0,
+   "level": -21.6,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "select_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/type.wav": {
+   "set": "click",
+   "role": "type",
+   "dur": 0.05,
+   "lead": 0.005,
+   "level": -24.1,
+   "source": {
+    "pack": "Kenney UI SFX Set",
+    "file": "switch12.ogg",
+    "url": "https://kenney.nl/assets/ui-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/drop.wav": {
+   "set": "click",
+   "role": "drop",
+   "dur": 0.206,
+   "lead": 0.03,
+   "level": -18.9,
+   "source": {
+    "pack": "Kenney RPG Audio",
+    "file": "metalLatch.ogg",
+    "url": "https://kenney.nl/assets/rpg-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/burst.wav": {
+   "set": "click",
+   "role": "burst",
+   "dur": 0.125,
+   "lead": 0.005,
+   "level": -23.1,
+   "source": {
+    "pack": "Kenney Casino Audio (1.1)",
+    "file": "chip-lay-1.ogg",
+    "url": "https://kenney.nl/assets/casino-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "click/end.wav": {
+   "set": "click",
+   "role": "end",
+   "dur": 0.11,
+   "lead": 0.005,
+   "level": -10.8,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "toggle_002.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/appear.wav": {
+   "set": "ui",
+   "role": "appear",
+   "dur": 0.126,
+   "lead": 0.03,
+   "level": -23.6,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "pluck_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "tick_004.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds",
+    "db": -6
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/stick.wav": {
+   "set": "ui",
+   "role": "stick",
+   "dur": 0.151,
+   "lead": 0.03,
+   "level": -22.4,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "drop_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "tick_004.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds",
+    "db": -6
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/land.wav": {
+   "set": "ui",
+   "role": "land",
+   "dur": 0.152,
+   "lead": 0,
+   "level": -21.5,
+   "source": {
+    "pack": "Kenney Impact Sounds (1.0)",
+    "file": "impactGeneric_light_000.ogg",
+    "url": "https://kenney.nl/assets/impact-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Casino Audio (1.1)",
+    "file": "chip-lay-1.ogg",
+    "url": "https://kenney.nl/assets/casino-audio",
+    "db": -4
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/hop.wav": {
+   "set": "ui",
+   "role": "hop",
+   "dur": 0.141,
+   "lead": 0.01,
+   "level": -20.5,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "pluck_002.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "layer": {
+    "pack": "Kenney UI SFX Set",
+    "file": "click5.ogg",
+    "url": "https://kenney.nl/assets/ui-audio",
+    "db": -6
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/whoosh.wav": {
+   "set": "ui",
+   "role": "whoosh",
+   "dur": 0.255,
+   "lead": 0.24,
+   "level": -9.9,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "maximize_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/tick.wav": {
+   "set": "ui",
+   "role": "tick",
+   "dur": 0.007,
+   "lead": 0,
+   "level": -24.1,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "click_003.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/select.wav": {
+   "set": "ui",
+   "role": "select",
+   "dur": 0.227,
+   "lead": 0.01,
+   "level": -13.2,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "select_003.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/type.wav": {
+   "set": "ui",
+   "role": "type",
+   "dur": 0.035,
+   "lead": 0.01,
+   "level": -21.5,
+   "source": {
+    "pack": "Kenney UI SFX Set",
+    "file": "click5.ogg",
+    "url": "https://kenney.nl/assets/ui-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/drop.wav": {
+   "set": "ui",
+   "role": "drop",
+   "dur": 0.453,
+   "lead": 0.03,
+   "level": -14.2,
+   "source": {
+    "pack": "Kenney Impact Sounds (1.0)",
+    "file": "impactPunch_heavy_000.ogg",
+    "url": "https://kenney.nl/assets/impact-sounds"
+   },
+   "layer": {
+    "pack": "Kenney Impact Sounds (1.0)",
+    "file": "impactMetal_light_000.ogg",
+    "url": "https://kenney.nl/assets/impact-sounds",
+    "db": -3
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/burst.wav": {
+   "set": "ui",
+   "role": "burst",
+   "dur": 0.16,
+   "lead": 0.005,
+   "level": -24,
+   "source": {
+    "pack": "Kenney Casino Audio (1.1)",
+    "file": "chips-collide-1.ogg",
+    "url": "https://kenney.nl/assets/casino-audio"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  },
+  "ui/end.wav": {
+   "set": "ui",
+   "role": "end",
+   "dur": 0.143,
+   "lead": 0.105,
+   "level": -20.4,
+   "source": {
+    "pack": "Kenney Interface Sounds (1.0)",
+    "file": "switch_001.ogg",
+    "url": "https://kenney.nl/assets/interface-sounds"
+   },
+   "license": "CC0 1.0 (License.txt)"
+  }
+ }
+}

package/themes/kawaii-sticker/effects.ts

@@ -1,4 +1,4 @@
-import { applyStyle, clamp, combine, emit, ease, progress, rand, safeTime, type Beats, type MotionRules, type Style } from "@kasaframe/core";
+import { applyStyle, clamp, combine, cue, emit, ease, progress, rand, safeTime, type Beats, type MotionRules, type Style } from "@kasaframe/core";
 import { dropBurst } from "@kasaframe/motion";
 
 // 비유: 오려 붙인 스티커 앨범. 무엇이든 흰 테두리를 두른 스티커가 되어 톡 붙고, 모서리가 살짝 들리고, 떼어진다.
@@ -42,11 +42,13 @@ function shadowOf(lift: number, k: number): string {
 }
 
 /** 톡 붙기 — 들린 채 내려와 눌리며(납작) 붙고, 짧게 출렁인 뒤 멈춘다. at 전에는 안 보인다 */
-export function stickOn(t: number, o: { at: number; dur?: number; rotate?: number; fall?: number; seed?: string | number }): Lifted {
+export function stickOn(t: number, o: { at: number; dur?: number; rotate?: number; fall?: number; seed?: string | number; minor?: boolean }): Lifted {
   t = safeTime(t);
   const dur = o.dur ?? 0.36;
   const u = (t - o.at) / dur;
   if (u < 0) return { opacity: 0, lift: 1 };
+  // 눌려 붙는 순간(내려오기 끝)에 톡
+  cue("stick", t - o.at - 0.45 * dur, { source: `stickOn:${o.seed ?? "stick"}@${o.at.toFixed(3)}`, minor: o.minor });
   const tilt = (rand(o.seed ?? "stick", 1) - 0.5) * 22;
   if (u < 0.45) {
     const p = ease.inQuad(u / 0.45);
@@ -68,6 +70,7 @@ export function peelOff(t: number, o: { at?: number; dur?: number; dir?: 1 | -1
   t = safeTime(t);
   if (o.at === undefined || t < o.at) return nil;
   const dur = o.dur ?? 0.6;
+  cue("whoosh", t - o.at, { source: `peelOff@${o.at.toFixed(3)}`, weight: 0.7, minor: true });
   const u = (t - o.at) / dur;
   const dir = o.dir ?? 1;
   const curl = ease.outCubic(clamp(u / 0.3));
@@ -98,6 +101,7 @@ export function cornerLift(t: number, o: { seed?: string | number; amount?: numb
 function hop(t: number, at: number): Lifted {
   const u = (t - at) / 0.34;
   if (u < 0 || u > 1) return nil;
+  cue("hop", t - at, { source: `hop@${at.toFixed(3)}`, weight: 0.8, minor: true });
   const up = Math.sin(Math.PI * Math.min(1, u / 0.7));
   const land = u > 0.7 ? Math.exp(-(u - 0.7) * 10) * Math.cos((u - 0.7) * 40) : 0;
   return { y: -70 * up, scale: 1 + 0.14 * up, rotate: 8 * up * (rand(at, 1) - 0.5) * 2, scaleX: 1 + 0.1 * land, scaleY: 1 - 0.1 * land, lift: up };
@@ -158,6 +162,7 @@ export function shotCam(t: number, o: { shots: Shot[]; whip?: number; drift?: nu
   let i = 0;
   for (let k = 0; k < shots.length; k++) if (shots[k].at <= t) i = k;
   let f = frame(i, t);
+  if (i > 0) cue("whoosh", t - shots[i].at, { source: `shotCam@${shots[i].at.toFixed(3)}`, scene: o.scene });
   if (i > 0 && t < shots[i].at + whip) {
     const p = ease.outQuart(progress(t, shots[i].at, whip));
     const a = frame(i - 1, shots[i].at);
@@ -222,6 +227,9 @@ function shineLayer(doc: Document, mask?: string): HTMLElement {
   return s;
 }
 
+/** 이 폭(무대 px) 넘는 스티커가 주인공 — 붙는 소리를 기본으로 낸다 */
+const HERO_W = 400;
+
 export interface StickerOpts {
   /** 투명 배경 그림(PNG·WebP). 없으면 text 로 이름표 스티커 */
   src?: string;
@@ -261,8 +269,10 @@ export function sticker(el: HTMLElement, o: StickerOpts): (t: number) => void {
   const shine = o.shine?.length ? shineLayer(el.ownerDocument, o.src) : null;
   if (shine) p.mov.append(shine);
   const seed = o.seed ?? o.src ?? o.text ?? "sticker";
+  // 주인공 스티커(아이콘·제품·이름)만 톡 소리를 기본으로 낸다 — 이름표·작은 조각까지 다 내면 곡에 묻히고 시끄럽다
+  const minor = o.w < HERO_W;
   return (t: number) => {
-    const on = o.at === undefined ? nil : stickOn(t, { at: o.at, rotate: 0, seed });
+    const on = o.at === undefined ? nil : stickOn(t, { at: o.at, rotate: 0, seed, minor });
     const idle = cornerLift(t + (o.phase ?? 0), { seed });
     const off = peelOff(t, { at: o.peelAt, dir: o.peelDir });
     const jumps = (o.hops ?? []).map((h) => hop(t, h));
@@ -335,6 +345,7 @@ export function washiTape(
       return `${x + dx}px ${yy}%`;
     });
   return (t: number) => {
+    cue("whoosh", t - o.at, { source: `washiTape@${o.at.toFixed(3)}`, weight: 0.6, minor: true });
     const p = ease.outCubic(progress(t, o.at, o.dur ?? 0.24));
     const shown = Math.max(0, o.len * p);
     if (shown <= 0) {
@@ -367,6 +378,7 @@ export function stickerBurst(
   });
   return (t: number) => {
     const s = safeTime(t) - o.at;
+    cue("burst", s, { source: `stickerBurst@${o.at.toFixed(3)}` });
     for (const b of bits) {
       if (s < 0 || s > 1.4) {
         b.img.style.opacity = "0";

package/themes/kawaii-sticker/theme.json

@@ -82,6 +82,7 @@
     ],
     "dims": "2D"
   },
+  "sfx": { "set": "pop", "db": 0, "perSec": 1 },
   "effects": [
     {
       "name": "sticker",