wobnimo 0.1.4 → 0.2.0

package/skill/examples/rex.ts

@@ -0,0 +1,193 @@
+import type { BoneSpec, CharacterSpec, PaintSpec, PartSpec } from 'wobnimo';
+
+/* The soft back spikes: one jiggling bone each, running from the crown down the tail. */
+const SPIKES: Array<{ parent: string; at: [number, number, number]; tilt: number; size: number }> = [
+  { parent: 'head', at: [0, 0.43, 0.05], tilt: -0.1, size: 0.075 },
+  { parent: 'head', at: [0, 0.41, -0.1], tilt: -0.5, size: 0.09 },
+  { parent: 'head', at: [0, 0.3, -0.24], tilt: -1.0, size: 0.085 },
+  { parent: 'body', at: [0, 0.5, -0.24], tilt: -1.2, size: 0.08 },
+  { parent: 'body', at: [0, 0.34, -0.3], tilt: -1.45, size: 0.07 },
+  { parent: 'tail0', at: [0, 0.12, 0.07], tilt: 0, size: 0.06 },
+  { parent: 'tail1', at: [0, 0.1, 0.05], tilt: 0, size: 0.045 },
+];
+
+/** A baby T. rex: pebbly scales, a toothless grin, tiny arms and a tail that wags. */
+export const rex: CharacterSpec = {
+  id: 'rex',
+  name: 'Rex',
+  tagline: 'A baby T. rex with pebbly scales, wobbly back spikes, tiny arms and a wagging tail',
+  accent: '#4fb86a',
+  frame: { target: 0.52, radius: 0.76 },
+  bound: { y: 0.46, radius: 0.86 },
+  motion: { hop: 0.15, squash: 1.15, snap: 1.05, talkSquash: 0.35 },
+  materials: {
+    /* a soft vinyl-toy hide: satin, with pebbled scales and darker seams */
+    hide: {
+      color: '#78cf7f', f0: 0.04, spec: 0.7, shininess: 40, rim: 0.7, gloss: 0.35, sss: 0.2, sssColor: '#c8ffb0',
+      surface: { kind: 'scales', scale: 24, strength: 0.5, color: '#4b9f5d', bone: 'head' },
+    },
+    bodyHide: {
+      color: '#78cf7f', shadeOf: 'hide', f0: 0.04, spec: 0.7, shininess: 40, rim: 0.7, gloss: 0.35, sss: 0.2, sssColor: '#c8ffb0',
+      surface: { kind: 'scales', scale: 24, strength: 0.5, color: '#4b9f5d' },
+    },
+    belly: { color: '#fff0c4', f0: 0.04, spec: 0.5, shininess: 30, rim: 0.5, gloss: 0.3, sss: 0.25, sssColor: '#fff6d8' },
+    spike: { color: '#ff9b4a', f0: 0.05, spec: 0.9, shininess: 60, rim: 0.5, gloss: 0.5, sss: 0.35, sssColor: '#ffc58f' },
+    claw: { color: '#fff6e2', f0: 0.05, spec: 1, shininess: 80, rim: 0.3, gloss: 0.6 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { ry: [['yaw', 0.25]], rz: [['roll', 0.3]] } },
+    { name: 'head', parent: 'body', pivot: [0, 0.56, 0.06], drive: { rx: [['pitch', -1]], ry: [['yaw', 0.8]], rz: [['roll', 0.7]] } },
+    /* tiny arms, held up in front of the chest */
+    { name: 'armL', parent: 'body', pivot: [-0.15, 0.42, 0.25], rest: { rx: -0.6 }, drive: { rx: [['flap', -0.9]], rz: [['flap', -0.5]] } },
+    { name: 'armR', parent: 'body', pivot: [0.15, 0.42, 0.25], rest: { rx: -0.6 }, drive: { rx: [['flap', -0.9]], rz: [['flap', 0.5]] } },
+    /* the tail sweeps out behind and to the side, so it shows from the front */
+    { name: 'tail0', parent: 'body', pivot: [0.08, 0.17, -0.24], rest: { rx: -1.25, rz: -0.6 }, wave: { rz: [0.2, 0.5, 0] }, jiggle: { axis: [0, 1, 0], length: 0.18, freq: 2.2, damping: 0.25, maxAngle: 0.6 } },
+    { name: 'tail1', parent: 'tail0', pivot: [0, 0.18, 0], rest: { rx: 0.2 }, wave: { rz: [0.2, 0.5, 0.8] }, jiggle: { axis: [0, 1, 0], length: 0.15, freq: 2, damping: 0.22, maxAngle: 0.7 } },
+    { name: 'tail2', parent: 'tail1', pivot: [0, 0.15, 0], rest: { rx: 0.15 }, wave: { rz: [0.25, 0.5, 1.6] }, jiggle: { axis: [0, 1, 0], length: 0.12, freq: 1.8, damping: 0.2, maxAngle: 0.8 } },
+    ...SPIKES.map(({ parent, at, tilt }, i): BoneSpec => ({
+      name: `spike${i}`, parent, pivot: at, rest: { rx: tilt },
+      jiggle: { axis: [0, 1, 0], length: 0.08, freq: 4 + i * 0.3, damping: 0.12, maxAngle: 0.45 },
+    })),
+  ],
+  parts: [
+    /* a pear of a body on two chunky thighs */
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.3, -0.02], radii: [0.3, 0.3, 0.28], material: 'bodyHide' },
+    { bone: 'body', shape: 'ellipsoid', at: [-0.19, 0.15, -0.02], radii: [0.13, 0.15, 0.17], blend: 0.08, material: 'bodyHide' },
+    { bone: 'body', shape: 'ellipsoid', at: [0.19, 0.15, -0.02], radii: [0.13, 0.15, 0.17], blend: 0.08, material: 'bodyHide' },
+    /* feet with three blunt claws each */
+    ...[-1, 1].flatMap((s): PartSpec[] => [
+      { bone: 'body', shape: 'ellipsoid', at: [s * 0.2, 0.045, 0.1], radii: [0.1, 0.05, 0.13], blend: 0.05, material: 'bodyHide' },
+      ...[-1, 0, 1].map((t): PartSpec => ({
+        bone: 'body', shape: 'ellipsoid', at: [s * 0.2 + t * 0.05, 0.03, 0.225 - Math.abs(t) * 0.015], radii: [0.022, 0.022, 0.026], blend: 0.012, material: 'claw',
+      })),
+    ]),
+    /* a big round head with a wide, soft snout */
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.2, -0.02], radii: [0.29, 0.25, 0.27], blend: 0.12, material: 'hide' },
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.1, 0.17], radii: [0.23, 0.14, 0.18], blend: 0.1, material: 'hide' },
+    /* nostrils */
+    { bone: 'head', shape: 'sphere', at: [-0.047, 0.162, 0.322], radius: 0.014, op: 'sub', blend: 0.01, material: 'hide' },
+    { bone: 'head', shape: 'sphere', at: [0.047, 0.162, 0.322], radius: 0.014, op: 'sub', blend: 0.01, material: 'hide' },
+    /* tiny arms with two little claws */
+    ...([['armL', -1], ['armR', 1]] as const).flatMap(([bone, s]): PartSpec[] => [
+      { bone, shape: 'capsule', from: [0, 0, 0], to: [s * 0.01, -0.1, 0.03], radius: 0.042, blend: 0.04, material: 'bodyHide' },
+      { bone, shape: 'sphere', at: [s * -0.014, -0.135, 0.05], radius: 0.015, blend: 0.01, material: 'claw' },
+      { bone, shape: 'sphere', at: [s * 0.02, -0.135, 0.045], radius: 0.015, blend: 0.01, material: 'claw' },
+    ]),
+    /* the tail, tapering */
+    { bone: 'tail0', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.18, 0], r1: 0.12, r2: 0.09, blend: 0.06, material: 'bodyHide' },
+    { bone: 'tail1', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.15, 0], r1: 0.09, r2: 0.06, blend: 0.03, material: 'bodyHide' },
+    { bone: 'tail2', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.12, 0], r1: 0.06, r2: 0.03, blend: 0.03, material: 'bodyHide' },
+    /* soft orange spikes */
+    ...SPIKES.map(({ size }, i): PartSpec => ({
+      bone: `spike${i}`, shape: 'roundCone', from: [0, -0.02, 0], to: [0, size * 1.1, 0], r1: size * 0.65, r2: size * 0.15, blend: 0.025, material: 'spike',
+    })),
+  ],
+  paints: [
+    /* a cream belly and chin, freckles on the snout, blushing cheeks */
+    { bone: 'body', on: ['bodyHide'], kind: 'ellipse', at: [0, 0.24, 0.08], radii: [0.16, 0.2], color: '#fff0c4', soft: 0.2 },
+    { bone: 'head', on: ['hide'], kind: 'ellipse', at: [0, -0.01, 0.15], radii: [0.17, 0.06], color: '#fff0c4', soft: 0.35 },
+    { bone: 'head', on: ['hide'], kind: 'sphere', at: [-0.2, 0.12, 0.24], radius: 0.055, color: '#ff9a9a', soft: 0.6, opacity: 0.7 },
+    { bone: 'head', on: ['hide'], kind: 'sphere', at: [0.2, 0.12, 0.24], radius: 0.055, color: '#ff9a9a', soft: 0.6, opacity: 0.7 },
+    ...[[-0.083, 0.204, 0.289], [-0.109, 0.181, 0.297], [0.083, 0.204, 0.289], [0.109, 0.181, 0.297]].map(([x, y, z]): PaintSpec => ({
+      bone: 'head', on: ['hide'], kind: 'sphere', at: [x, y, z], radius: 0.009, color: '#3f8a4f', soft: 0.3,
+    })),
+  ],
+  eyes: {
+    kind: 'ball',
+    bone: 'head',
+    at: [[-0.13, 0.26, 0.19], [0.13, 0.26, 0.19]],
+    radius: 0.085,
+    iris: '#e0942f',
+    irisSize: 0.78,
+    pupilSize: 0.46,
+    pupilAspect: 0.75,
+    lid: 'hide',
+  },
+  /* a wide, toothless grin across the snout */
+  face: {
+    kind: 'mouth',
+    bone: 'head',
+    on: ['hide'],
+    at: [0, 0.06, 0.34],
+    width: 0.1,
+    color: '#5b1f2b',
+    tongue: '#ff7f93',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.16, 0.44, 0.06] },
+    mouth: { bone: 'head', at: [0, 0.06, 0.37] },
+    ear: { bone: 'head', at: [-0.3, 0.22, 0] },
+    feet: { bone: 'root', at: [0, 0.02, 0.15] },
+    tail: { bone: 'tail2', at: [0, 0.12, 0] },
+  },
+  acting: {
+    idle: { tail0: { rz: [-0.6, 0.12, 0.45, 0] } },
+    /* a tiny claw tapping the chin, which it can't quite reach */
+    thinking: {
+      armR: { rx: [-1.3, 0.08, 2.5, 0], rz: 0.3 },
+      tail2: { rx: [0.15, 0.3, 1.4, 0] },
+    },
+    listening: {
+      armL: { rx: -1.1, rz: -0.6 },
+      tail0: { rz: -0.4 },
+    },
+    speaking: {
+      armL: { rx: [-0.6, 0.25, 1.6, 0] },
+      armR: { rx: [-0.6, 0.25, 1.6, 2] },
+      tail0: { rz: [-0.6, 0.18, 0.9, 0] },
+    },
+    /* curled up: arms tucked, the tail wrapped round the front */
+    sleeping: {
+      armL: { rx: 0.1, rz: 0.2 },
+      armR: { rx: 0.1, rz: -0.2 },
+      tail0: { rz: -1.3, rx: -1.0 },
+      tail1: { rx: 0.4 },
+    },
+    /* scribbling with both little hands */
+    working: {
+      armL: { rx: [-0.9, 0.15, 7, 0] },
+      armR: { rx: [-0.9, 0.15, 7, Math.PI] },
+      head: { rx: 0.12 },
+      tail2: { rx: [0.15, 0.2, 2, 0] },
+    },
+    /* arms flailing, tail stiff, every spike on end */
+    error: {
+      armL: { rx: [-1.6, 0.35, 9, 0], rz: -0.4 },
+      armR: { rx: [-1.6, 0.35, 9, 1.4], rz: 0.4 },
+      tail0: { rz: [-0.5, 0.06, 12, 0], rx: -1.45 },
+      spike1: { rx: -0.2 },
+      spike2: { rx: -0.6 },
+      spike3: { rx: -0.8 },
+    },
+    surprised: {
+      armL: { rx: -1.9, rz: -0.6 },
+      armR: { rx: -1.9, rz: 0.6 },
+      tail0: { rx: -1.5 },
+    },
+    /* a happy stomp with tiny arms in the air and a wagging tail */
+    celebrating: {
+      armL: { rx: [-2.2, 0.3, 4, 0], rz: -0.5 },
+      armR: { rx: [-2.2, 0.3, 4, Math.PI], rz: 0.5 },
+      tail0: { rz: [-0.6, 0.55, 3, 0] },
+    },
+    sad: {
+      armL: { rx: 0.2 },
+      armR: { rx: 0.2 },
+      tail0: { rx: -0.95, rz: -0.4 },
+      tail1: { rx: 0.35 },
+    },
+    happy: {
+      armL: { rx: [-1.4, 0.4, 6, 0] },
+      armR: { rx: [-1.4, 0.4, 6, 1.4] },
+      tail0: { rz: [-0.6, 0.5, 4, 0] },
+    },
+  },
+  fx: {
+    /* a little roar on surprise */
+    'enter:surprised': [
+      { glyph: 'arc', anchor: 'mouth', rate: 3, offset: [0.08, 0, 0.05], mirror: true, velocity: [0.3, 0.05, 0.1], jitter: 0.04, life: [0.5, 0.6], size: [0.04, 0.11], color: '#7fd18a' },
+    ],
+  },
+};
+
+export default rex;

package/skill/examples/swirl.ts

@@ -0,0 +1,69 @@
+import type { CharacterSpec, PartSpec } from 'wobnimo';
+
+/** A snail whose shell looks like a cinnamon roll. */
+export const swirl: CharacterSpec = {
+  id: 'swirl',
+  name: 'Swirl',
+  tagline: 'A slow, sweet snail carrying a glazed cinnamon roll for a shell',
+  accent: '#c27a3e',
+  frame: { target: 0.38, radius: 0.59 },
+  bound: { y: 0.35, radius: 0.6 },
+  motion: { hop: 0.03, squash: 1.4, snap: 0.7, talkSquash: 0.6 },
+  materials: {
+    skin: { color: '#b9d97a', f0: 0.06, spec: 1.4, shininess: 110, rim: 0.7, sss: 0.45, sssColor: '#e6ffb0', gloss: 0.8, surface: { kind: 'ripple', scale: 18, strength: 0.25 } },
+    dough: { color: '#d9944f', f0: 0.03, spec: 0.5, shininess: 30, rim: 0.5, sheen: 0.3 },
+    cinnamon: { color: '#8a4b22', shadeOf: 'dough', f0: 0.03, spec: 0.5, shininess: 30, rim: 0.4 },
+    glaze: { color: '#fff4e4', f0: 0.08, spec: 1.6, shininess: 160, rim: 0.6, sss: 0.4, sssColor: '#ffffff', gloss: 0.9 },
+    bead: { color: '#1a1410', f0: 0.06, spec: 2.2, shininess: 400, rim: 0.2, gloss: 1 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0.053, 0], drive: { ry: [['yaw', 0.3]], rz: [['roll', 0.3]] }, wave: { rz: [0.02, 0.4, 0] } },
+    /* the head rises out of the foot at the front */
+    { name: 'head', parent: 'body', pivot: [0.24, 0.12, 0.08], drive: { rx: [['pitch', -0.7]], ry: [['yaw', 0.7]], rz: [['roll', 0.6]] } },
+    { name: 'stalkL', parent: 'head', pivot: [-0.06, 0.3, 0.02], rest: { rz: 0.3 }, jiggle: { axis: [0, 1, 0], length: 0.16, freq: 2.4, damping: 0.12 } },
+    { name: 'stalkR', parent: 'head', pivot: [0.06, 0.3, 0.02], rest: { rz: -0.3 }, jiggle: { axis: [0, 1, 0], length: 0.16, freq: 2.4, damping: 0.12 } },
+    { name: 'shell', parent: 'body', pivot: [-0.08, 0.12, -0.04], wave: { rz: [0.015, 0.4, 1] } },
+  ],
+  parts: [
+    /* a long soft foot */
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.07, 0], radii: [0.42, 0.08, 0.2], material: 'skin' },
+    /* the head and neck */
+    { bone: 'head', shape: 'capsule', from: [0, -0.05, 0], to: [0, 0.2, 0.02], radius: 0.13, blend: 0.08, material: 'skin' },
+    { bone: 'stalkL', shape: 'capsule', from: [0, 0, 0], to: [0, 0.14, 0], radius: 0.02, material: 'skin' },
+    { bone: 'stalkL', shape: 'sphere', at: [0, 0.15, 0], radius: 0.035, material: 'skin' },
+    { bone: 'stalkR', shape: 'capsule', from: [0, 0, 0], to: [0, 0.14, 0], radius: 0.02, material: 'skin' },
+    { bone: 'stalkR', shape: 'sphere', at: [0, 0.15, 0], radius: 0.035, material: 'skin' },
+    /* the shell: a cinnamon roll on its side, a spiral of dough and a lick of glaze */
+    { bone: 'shell', shape: 'cylinder', at: [0, 0.27, 0], rot: [Math.PI / 2, 0, 0], radius: 0.27, half: 0.13, round: 0.07, material: 'dough' },
+    /* the spiral: alternately carve a groove and fill the next ring back in, outside to centre
+       (a subtraction only cuts what comes before it, so the order is the pattern) */
+    ...[0.21, 0.15, 0.09].flatMap((r, i): PartSpec[] => [
+      { bone: 'shell', shape: 'cylinder', at: [0.01 * i, 0.27 + 0.01 * i, 0.12], rot: [Math.PI / 2, 0, 0], radius: r, half: 0.03, round: 0.02, op: 'sub', blend: 0.015, material: 'cinnamon' },
+      { bone: 'shell', shape: 'cylinder', at: [0.01 * i, 0.27 + 0.01 * i, 0.1], rot: [Math.PI / 2, 0, 0], radius: r - 0.03, half: 0.03, round: 0.025, blend: 0.01, material: 'dough' },
+    ]),
+    { bone: 'shell', shape: 'ellipsoid', at: [-0.04, 0.47, 0.03], radii: [0.2, 0.06, 0.15], blend: 0.03, material: 'glaze' },
+  ],
+  paints: [
+    { bone: 'head', on: ['skin'], kind: 'sphere', at: [-0.09, 0.06, 0.1], radius: 0.035, color: '#ff9eb0', soft: 0.6, opacity: 0.8 },
+    { bone: 'head', on: ['skin'], kind: 'sphere', at: [0.09, 0.06, 0.1], radius: 0.035, color: '#ff9eb0', soft: 0.6, opacity: 0.8 },
+  ],
+  eyes: { kind: 'bead', bone: 'head', at: [[-0.055, 0.14, 0.128], [0.055, 0.14, 0.128]], radii: [0.026, 0.038, 0.018], material: 'bead' },
+  face: { kind: 'mouth', bone: 'head', on: ['skin'], at: [0, 0.05, 0.14], width: 0.04, color: '#3d4f1c', tongue: '#ff8a9a' },
+  anchors: {
+    top: { bone: 'shell', at: [0, 0.58, 0] },
+    mouth: { bone: 'head', at: [0, 0.05, 0.16] },
+    ear: { bone: 'head', at: [-0.14, 0.15, 0] },
+    feet: { bone: 'root', at: [0.3, 0.02, 0.12] },
+  },
+  acting: {
+    thinking: { head: { rz: 0.2 }, stalkL: { rz: 0.6 } },
+    listening: { stalkL: { rx: -0.4 }, stalkR: { rx: -0.4 } },
+    sleeping: { head: { rx: 0.5 }, stalkL: { rx: 1.1 }, stalkR: { rx: 1.1 } },
+    error: { stalkL: { rz: [0.3, 0.3, 8, 0] }, stalkR: { rz: [-0.3, 0.3, 8, 1] } },
+    surprised: { stalkL: { rz: 0.05 }, stalkR: { rz: -0.05 }, head: { rx: -0.2 } },
+    celebrating: { stalkL: { rz: [0.4, 0.3, 4, 0] }, stalkR: { rz: [-0.4, 0.3, 4, Math.PI] } },
+    sad: { head: { rx: 0.3 }, stalkL: { rx: 1.2, rz: 0.5 }, stalkR: { rx: 1.2, rz: -0.5 } },
+  },
+};
+
+export default swirl;

package/skill/examples/tad.ts

@@ -0,0 +1,117 @@
+import type { CharacterSpec } from 'wobnimo';
+
+/** A tree frog: wet, glossy and spotted, with eyes on top and a throat that puffs when it talks. */
+export const tad: CharacterSpec = {
+  id: 'tad',
+  name: 'Tad',
+  tagline: 'A glossy tree frog with a wet sheen, eyes on top and a throat that puffs as it talks',
+  accent: '#3fae4a',
+  frame: { target: 0.42, radius: 0.66 },
+  bound: { y: 0.4, radius: 0.72 },
+  motion: { hop: 0.26, squash: 1.6, snap: 1.2, look: 0.8, talkSquash: 0.45 },
+  materials: {
+    /* wet skin: a strong, sharp clear coat over a little translucency */
+    skin: {
+      color: '#5fc24e', f0: 0.07, spec: 2, shininess: 260, rim: 0.7, gloss: 0.95, sss: 0.3, sssColor: '#c6ff8f',
+      surface: { kind: 'speckle', scale: 9, strength: 0.85, color: '#2f8a3a', bone: 'head' },
+    },
+    bodySkin: {
+      color: '#5fc24e', shadeOf: 'skin', f0: 0.07, spec: 2, shininess: 260, rim: 0.7, gloss: 0.95, sss: 0.3, sssColor: '#c6ff8f',
+      surface: { kind: 'speckle', scale: 9, strength: 0.85, color: '#2f8a3a' },
+    },
+    belly: { color: '#f3f0b6', f0: 0.06, spec: 1.6, shininess: 200, rim: 0.5, gloss: 0.9, sss: 0.45, sssColor: '#fffbd0' },
+    toe: { color: '#ffb54a', f0: 0.06, spec: 1.4, shininess: 160, rim: 0.4, gloss: 0.8, sss: 0.3, sssColor: '#ffd99a' },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { ry: [['yaw', 0.25]], rz: [['roll', 0.3]] } },
+    /* frogs have no neck: the whole top of the body tips and turns */
+    { name: 'head', parent: 'body', pivot: [0, 0.3, 0.02], drive: { rx: [['pitch', -0.8]], ry: [['yaw', 0.7]], rz: [['roll', 0.6]] } },
+    /* the throat sac swings forward and out from under the chin as it talks */
+    { name: 'throat', parent: 'head', pivot: [0, 0.02, 0.12], drive: { rx: [['talk', 0.9]] } },
+    { name: 'armL', parent: 'body', pivot: [-0.22, 0.2, 0.18], drive: { rz: [['flap', -1.3]], rx: [['flap', -0.4]] } },
+    { name: 'armR', parent: 'body', pivot: [0.22, 0.2, 0.18], drive: { rz: [['flap', 1.3]], rx: [['flap', -0.4]] } },
+  ],
+  parts: [
+    /* a squat, pear-shaped body with folded back legs */
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.22, -0.03], radii: [0.36, 0.22, 0.32], material: 'bodySkin' },
+    { bone: 'body', shape: 'ellipsoid', at: [-0.3, 0.12, -0.04], rot: [0, 0.25, 0], radii: [0.13, 0.11, 0.22], blend: 0.09, material: 'bodySkin' },
+    { bone: 'body', shape: 'ellipsoid', at: [0.3, 0.12, -0.04], rot: [0, -0.25, 0], radii: [0.13, 0.11, 0.22], blend: 0.09, material: 'bodySkin' },
+    /* webbed back feet, splayed */
+    { bone: 'body', shape: 'ellipsoid', at: [-0.33, 0.025, 0.16], rot: [0, 0.5, 0], radii: [0.08, 0.025, 0.13], blend: 0.03, material: 'bodySkin' },
+    { bone: 'body', shape: 'ellipsoid', at: [0.33, 0.025, 0.16], rot: [0, -0.5, 0], radii: [0.08, 0.025, 0.13], blend: 0.03, material: 'bodySkin' },
+    /* the wide head, with two domes for the eyes */
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.1, 0.05], radii: [0.38, 0.19, 0.31], blend: 0.14, material: 'skin' },
+    { bone: 'head', shape: 'sphere', at: [-0.19, 0.24, 0.1], radius: 0.13, blend: 0.07, material: 'skin' },
+    { bone: 'head', shape: 'sphere', at: [0.19, 0.24, 0.1], radius: 0.13, blend: 0.07, material: 'skin' },
+    /* the throat sac: hidden under the chin at rest */
+    { bone: 'throat', shape: 'ellipsoid', at: [0, -0.04, 0.1], radii: [0.14, 0.1, 0.12], blend: 0.05, material: 'belly' },
+    /* little arms with round toe pads */
+    { bone: 'armL', shape: 'capsule', from: [0, 0, 0], to: [-0.03, -0.17, 0.08], radius: 0.045, blend: 0.05, material: 'bodySkin' },
+    { bone: 'armL', shape: 'sphere', at: [-0.07, -0.19, 0.12], radius: 0.026, blend: 0.02, material: 'toe' },
+    { bone: 'armL', shape: 'sphere', at: [-0.02, -0.19, 0.15], radius: 0.026, blend: 0.02, material: 'toe' },
+    { bone: 'armL', shape: 'sphere', at: [0.03, -0.19, 0.13], radius: 0.026, blend: 0.02, material: 'toe' },
+    { bone: 'armR', shape: 'capsule', from: [0, 0, 0], to: [0.03, -0.17, 0.08], radius: 0.045, blend: 0.05, material: 'bodySkin' },
+    { bone: 'armR', shape: 'sphere', at: [0.07, -0.19, 0.12], radius: 0.026, blend: 0.02, material: 'toe' },
+    { bone: 'armR', shape: 'sphere', at: [0.02, -0.19, 0.15], radius: 0.026, blend: 0.02, material: 'toe' },
+    { bone: 'armR', shape: 'sphere', at: [-0.03, -0.19, 0.13], radius: 0.026, blend: 0.02, material: 'toe' },
+  ],
+  paints: [
+    { bone: 'body', on: ['bodySkin'], kind: 'ellipse', at: [0, 0.16, 0.28], radii: [0.22, 0.13], color: '#f3f0b6', soft: 0.3 },
+    { bone: 'head', on: ['skin'], kind: 'ellipse', at: [0, -0.01, 0.34], radii: [0.2, 0.06], color: '#f3f0b6', soft: 0.4 },
+    { bone: 'head', on: ['skin'], kind: 'sphere', at: [-0.24, 0.07, 0.27], radius: 0.055, color: '#ff8f9c', soft: 0.6, opacity: 0.7 },
+    { bone: 'head', on: ['skin'], kind: 'sphere', at: [0.24, 0.07, 0.27], radius: 0.055, color: '#ff8f9c', soft: 0.6, opacity: 0.7 },
+  ],
+  eyes: {
+    kind: 'ball',
+    bone: 'head',
+    at: [[-0.19, 0.27, 0.15], [0.19, 0.27, 0.15]],
+    radius: 0.1,
+    iris: '#e7b93a',
+    irisSize: 0.74,
+    pupilSize: 0.36,
+    pupilAspect: 1.8,
+    lid: 'skin',
+  },
+  /* a frog's mouth runs nearly ear to ear */
+  face: {
+    kind: 'mouth',
+    bone: 'head',
+    on: ['skin'],
+    at: [0, 0.06, 0.34],
+    width: 0.12,
+    color: '#5a1f2e',
+    tongue: '#ff7b93',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.2, 0.36, 0.05] },
+    mouth: { bone: 'head', at: [0, 0.05, 0.37] },
+    ear: { bone: 'head', at: [-0.38, 0.12, 0] },
+    feet: { bone: 'root', at: [0, 0.03, 0.22] },
+  },
+  acting: {
+    idle: { throat: { rx: [0, 0.12, 1.1, 0] } },
+    /* a toe to the chin */
+    thinking: { armR: { rz: 0.6, rx: -1.5 } },
+    listening: { armL: { rz: -1.6, rx: -0.4 } },
+    speaking: {
+      armL: { rx: [-0.25, 0.2, 1.3, 0] },
+      armR: { rx: [-0.25, 0.2, 1.3, 2] },
+    },
+    sleeping: { armL: { rx: 0.2 }, armR: { rx: 0.2 }, throat: { rx: [0.2, 0.25, 0.18, 0] } },
+    /* drumming its toes */
+    working: { armL: { rx: [-0.5, 0.2, 7, 0] }, armR: { rx: [-0.5, 0.2, 7, Math.PI] }, throat: { rx: [0, 0.15, 3.5, 0] } },
+    error: { armL: { rz: [-1.2, 0.15, 12, 0] }, armR: { rz: [1.2, 0.15, 12, 1] }, throat: { rx: 0.6 } },
+    surprised: { armL: { rz: -1.8 }, armR: { rz: 1.8 }, throat: { rx: 0.9 } },
+    celebrating: { armL: { rz: [-2, 0.4, 4, 0] }, armR: { rz: [2, 0.4, 4, Math.PI] }, throat: { rx: [0.4, 0.4, 4, 0] } },
+    sad: { armL: { rz: 0.2, rx: 0.3 }, armR: { rz: -0.2, rx: 0.3 } },
+    happy: { armL: { rz: [-1.5, 0.4, 5, 0] }, armR: { rz: [1.5, 0.4, 5, 1] }, throat: { rx: [0.4, 0.4, 5, 0] } },
+  },
+  fx: {
+    replace: ['land'],
+    /* a splash every time it lands, and a ribbit of bubbles */
+    land: [{ glyph: 'drop', anchor: 'feet', rate: 8, spread: 0.2, velocity: [0, 0.7, 0.05], jitter: 0.7, gravity: 3.2, life: [0.45, 0.6], size: [0.035, 0.022], color: '#7fd0ff', align: true }],
+    syllable: [{ glyph: 'bubble', anchor: 'mouth', rate: 1, offset: [0.1, 0, 0.02], velocity: [0.08, 0.18, 0.05], jitter: 0.08, wobble: 0.05, life: [0.9, 1.2], size: [0.016, 0.036], color: '#a6e8ff' }],
+  },
+};
+
+export default tad;

package/skill/examples/volt.ts

@@ -0,0 +1,214 @@
+import type { BoneSpec, CharacterSpec, PartSpec } from 'wobnimo';
+
+/* A jointed arm: shoulder, elbow, and a claw hand. `side` is -1 for the
+   arm on screen left, 1 for screen right. */
+function arm(side: -1 | 1): BoneSpec[] {
+  const s = side < 0 ? 'L' : 'R';
+  return [
+    { name: `shoulder${s}`, parent: 'body', pivot: [0.385 * side, 0.47, 0.02], drive: { rz: [['flap', 0.5 * side]] } },
+    {
+      name: `fore${s}`, parent: `shoulder${s}`, pivot: [0, -0.17, 0],
+      jiggle: { axis: [0, -1, 0], length: 0.16, freq: 3.2, damping: 0.35, maxAngle: 0.3 },
+    },
+  ];
+}
+
+function armParts(side: -1 | 1): PartSpec[] {
+  const s = side < 0 ? 'L' : 'R';
+  return [
+    { bone: `shoulder${s}`, shape: 'sphere', radius: 0.074, material: 'trim' },
+    { bone: `shoulder${s}`, shape: 'capsule', from: [0, -0.02, 0], to: [0, -0.15, 0], radius: 0.058, material: 'shell' },
+    { bone: `fore${s}`, shape: 'sphere', radius: 0.052, material: 'trim' },
+    { bone: `fore${s}`, shape: 'capsule', from: [0, -0.02, 0], to: [0, -0.12, 0], radius: 0.052, material: 'shell' },
+    /* a claw: a ball with a bite out of it */
+    { bone: `fore${s}`, shape: 'sphere', at: [0, -0.175, 0], radius: 0.066, material: 'trim' },
+    { bone: `fore${s}`, shape: 'sphere', op: 'sub', blend: 0.012, at: [0, -0.235, 0.012], radius: 0.036, material: 'trim' },
+  ];
+}
+
+/* knob ears that spin like gears when it thinks; two studs make the turn readable */
+function earParts(side: -1 | 1): PartSpec[] {
+  const s = side < 0 ? 'L' : 'R';
+  return [
+    { bone: `ear${s}`, shape: 'cylinder', rot: [0, 0, 1.5708], radius: 0.112, half: 0.03, round: 0.018, material: 'trim' },
+    { bone: `ear${s}`, shape: 'cylinder', at: [0.045 * side, 0, 0], rot: [0, 0, 1.5708], radius: 0.058, half: 0.035, round: 0.018, material: 'trim' },
+    { bone: `ear${s}`, shape: 'sphere', at: [0.035 * side, 0.078, 0], radius: 0.02, material: 'metal' },
+    { bone: `ear${s}`, shape: 'sphere', at: [0.035 * side, -0.078, 0], radius: 0.02, material: 'metal' },
+  ];
+}
+
+/** A glossy TV-headed robot: LED face, jointed arms with claws, gear ears, sprung antenna. */
+export const volt: CharacterSpec = {
+  id: 'volt',
+  name: 'Volt',
+  tagline: 'LED face, claw hands, gear ears, a sprung antenna',
+  accent: '#3b63d9',
+  frame: { target: 0.86, radius: 1.02 },
+  bound: { y: 0.86, radius: 1.12 },
+  motion: { hop: 0.16, squash: 1, snap: 1 },
+  glowPool: 0.35,
+  materials: {
+    shell: { color: '#2f56c4', f0: 0.05, spec: 0.7, shininess: 70, rim: 0.55, gloss: 0.55 },
+    trim: { color: '#c3cce3', f0: 0.07, spec: 0.8, shininess: 90, metal: 0.25, rim: 0.4, gloss: 0.5 },
+    metal: { color: '#8f98ae', f0: 0.45, spec: 1, shininess: 120, metal: 0.85, rim: 0.3, gloss: 0.7 },
+    rubber: { color: '#151a28', f0: 0.03, spec: 0.15, shininess: 12, rim: 0.2 },
+    screen: { color: '#03060c', f0: 0.045, spec: 1.6, shininess: 260, rim: 0.1, gloss: 1 },
+    bulb: { color: '#f2f5ff', f0: 0.04, spec: 0.6, shininess: 40, rim: 0.3, glows: true, emitStrength: 1.4, sss: 0.4, sssColor: '#ffffff' },
+    lamp: { color: '#e9eeff', f0: 0.05, spec: 1, shininess: 80, glows: true, emitStrength: 1.1, gloss: 0.9 },
+    ring: { color: '#d8e4ff', f0: 0.04, spec: 0.4, shininess: 30, glows: true, emitStrength: 1.6 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { ry: [['yaw', 0.2]], rz: [['roll', 0.25]] } },
+    { name: 'head', parent: 'body', pivot: [0, 0.64, 0], drive: { rx: [['pitch', -1]], ry: [['yaw', 0.8]], rz: [['roll', 0.75]] } },
+    { name: 'antenna', parent: 'head', pivot: [0, 0.755, 0], jiggle: { axis: [0, 1, 0], length: 0.26, freq: 2.3, damping: 0.11 } },
+    { name: 'earL', parent: 'head', pivot: [-0.585, 0.37, 0] },
+    { name: 'earR', parent: 'head', pivot: [0.585, 0.37, 0] },
+    ...arm(-1),
+    ...arm(1),
+  ],
+  parts: [
+    /* the body: a soft puck on two feet, a lamp and a speaker grille in the chest */
+    { bone: 'body', shape: 'roundBox', at: [0, 0.32, 0], half: [0.35, 0.27, 0.28], round: 0.22, material: 'shell' },
+    { bone: 'body', shape: 'roundBox', at: [0, 0.38, 0.27], half: [0.15, 0.08, 0.03], round: 0.06, material: 'rubber' },
+    { bone: 'body', shape: 'sphere', at: [0, 0.38, 0.285], radius: 0.04, material: 'lamp' },
+    { bone: 'body', shape: 'plate', op: 'sub', blend: 0.006, at: [0, 0.225, 0.3], half: [0.075, 0.009], corner: 0.009, depth: 0.03, material: 'shell' },
+    { bone: 'body', shape: 'plate', op: 'sub', blend: 0.006, at: [0, 0.19, 0.295], half: [0.075, 0.009], corner: 0.009, depth: 0.03, material: 'shell' },
+    { bone: 'body', shape: 'plate', op: 'sub', blend: 0.006, at: [0, 0.155, 0.27], half: [0.06, 0.009], corner: 0.009, depth: 0.03, material: 'shell' },
+    { bone: 'body', shape: 'roundBox', at: [-0.17, 0.035, 0.05], half: [0.11, 0.035, 0.14], round: 0.035, material: 'trim' },
+    { bone: 'body', shape: 'roundBox', at: [0.17, 0.035, 0.05], half: [0.11, 0.035, 0.14], round: 0.035, material: 'trim' },
+    { bone: 'body', shape: 'cylinder', at: [0, 0.62, 0], radius: 0.075, half: 0.06, round: 0.02, material: 'metal' },
+
+    /* the head: a shell with a rolled lip into the screen, and the glass */
+    { bone: 'head', shape: 'roundBox', at: [0, 0.37, 0], half: [0.56, 0.37, 0.35], round: 0.17, material: 'shell' },
+    { bone: 'head', shape: 'roundBox', op: 'sub', blend: 0.035, at: [0, 0.37, 0.41], half: [0.45, 0.28, 0.1], round: 0.12, material: 'shell' },
+    { bone: 'head', shape: 'plate', at: [0, 0.37, 0.31], half: [0.45, 0.28], corner: 0.12, depth: 0.012, material: 'screen' },
+    /* glowing rings where the ears meet the head */
+    { bone: 'head', shape: 'cylinder', at: [-0.555, 0.37, 0], rot: [0, 0, 1.5708], radius: 0.122, half: 0.012, round: 0.006, material: 'ring' },
+    { bone: 'head', shape: 'cylinder', at: [0.555, 0.37, 0], rot: [0, 0, 1.5708], radius: 0.122, half: 0.012, round: 0.006, material: 'ring' },
+    ...earParts(-1),
+    ...earParts(1),
+    /* the antenna's collar, stem and bulb */
+    { bone: 'head', shape: 'cylinder', at: [0, 0.745, 0], radius: 0.065, half: 0.025, round: 0.012, material: 'trim' },
+    { bone: 'antenna', shape: 'capsule', from: [0, 0, 0], to: [0, 0.2, 0], radius: 0.016, material: 'metal' },
+    { bone: 'antenna', shape: 'sphere', at: [0, 0.25, 0], radius: 0.055, material: 'bulb' },
+
+    ...armParts(-1),
+    ...armParts(1),
+  ],
+  face: {
+    kind: 'screen',
+    bone: 'head',
+    material: 'screen',
+    center: [0, 0.37],
+    half: [0.44, 0.27],
+    corner: 0.11,
+    cell: 0.034,
+    color: '#c4ecff',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.3, 0.78, 0.1] },
+    mouth: { bone: 'head', at: [0, 0.22, 0.34] },
+    ear: { bone: 'head', at: [-0.66, 0.37, 0] },
+    feet: { bone: 'root', at: [0, 0.02, 0.06] },
+    antenna: { bone: 'antenna', at: [0, 0.25, 0] },
+  },
+  acting: {
+    idle: {
+      shoulderL: { rz: [-0.08, 0.04, 0.45, 0], rx: [0, 0.06, 0.35, 1] },
+      shoulderR: { rz: [0.08, 0.04, 0.45, 1.6], rx: [0, 0.06, 0.35, 2.4] },
+      foreL: { rx: -0.25 },
+      foreR: { rx: -0.25 },
+    },
+    /* the thinker: one claw up to the chin and tapping, the other arm across the belly */
+    thinking: {
+      shoulderR: { rx: -1.5, ry: -0.8, rz: -0.1 },
+      foreR: { rx: [-0.95, 0.1, 1.8, 0] },
+      shoulderL: { rx: -1.0, ry: 0.8, rz: -0.3 },
+      foreL: { rx: -0.8 },
+      earL: { rx: [0, 0, 0, 0, 5] },
+      earR: { rx: [0, 0, 0, 0, -5] },
+    },
+    /* a claw cupped up by the ear */
+    listening: {
+      shoulderL: { rx: 0.1, ry: 0.3, rz: -2.8 },
+      foreL: { rx: -0.6 },
+      shoulderR: { rz: 0.14, rx: 0.05 },
+      foreR: { rx: -0.3 },
+      earL: { rx: [0.3, 0.15, 0.8, 0] },
+    },
+    /* talking with its hands */
+    speaking: {
+      shoulderL: { rx: [-0.55, 0.32, 0.72, 0], rz: [-0.28, 0.12, 0.5, 0] },
+      foreL: { rx: [-0.85, 0.38, 1.44, 0.6] },
+      shoulderR: { rx: [-0.45, 0.32, 0.72, 2.2], rz: [0.28, 0.12, 0.5, 1] },
+      foreR: { rx: [-0.95, 0.38, 1.44, 2.8] },
+      earL: { rx: [0, 0, 0, 0, 1.4] },
+      earR: { rx: [0, 0, 0, 0, -1.4] },
+    },
+    sleeping: {
+      shoulderL: { rz: -0.03, rx: -0.3 },
+      shoulderR: { rz: 0.03, rx: -0.3 },
+      foreL: { rx: -0.4 },
+      foreR: { rx: -0.4 },
+    },
+    /* typing: arms forward, claws tapping in turn, ears turning like drives */
+    working: {
+      shoulderL: { rx: -0.85, rz: -0.12 },
+      shoulderR: { rx: -0.85, rz: 0.12 },
+      foreL: { rx: [-0.95, 0.2, 6, 0] },
+      foreR: { rx: [-0.95, 0.2, 6, Math.PI] },
+      earL: { rx: [0, 0, 0, 0, 3] },
+      earR: { rx: [0, 0, 0, 0, -3] },
+    },
+    /* arms thrown out, shaking; the ears seize up */
+    error: {
+      shoulderL: { rz: [-0.95, 0.1, 11, 0], rx: -0.2 },
+      shoulderR: { rz: [0.95, 0.1, 11, 1], rx: -0.2 },
+      foreL: { rx: -1.1 },
+      foreR: { rx: -1.1 },
+    },
+    surprised: {
+      shoulderL: { rz: -1.55, rx: -0.3 },
+      shoulderR: { rz: 1.55, rx: -0.3 },
+      foreL: { rx: -0.35 },
+      foreR: { rx: -0.35 },
+    },
+    /* fists pumping overhead, ears spinning */
+    celebrating: {
+      shoulderL: { rz: [-2.55, 0.28, 4, 0] },
+      shoulderR: { rz: [2.55, 0.28, 4, Math.PI] },
+      foreL: { rz: [0.2, 0.4, 8, 0] },
+      foreR: { rz: [-0.2, 0.4, 8, Math.PI] },
+      earL: { rx: [0, 0, 0, 0, 12] },
+      earR: { rx: [0, 0, 0, 0, -12] },
+    },
+    /* arms hanging, a little behind the body */
+    sad: {
+      shoulderL: { rz: 0.04, rx: 0.22 },
+      shoulderR: { rz: -0.04, rx: 0.22 },
+      foreL: { rx: -0.05 },
+      foreR: { rx: -0.05 },
+    },
+    /* both arms up, claws waving */
+    happy: {
+      shoulderL: { rz: [-2.5, 0.22, 2.2, 0] },
+      foreL: { rz: [0.1, 0.5, 4.2, 0] },
+      shoulderR: { rz: [2.5, 0.22, 2.2, 1.5] },
+      foreR: { rz: [-0.1, 0.5, 4.2, 2] },
+      earL: { rx: [0, 0, 0, 0, 10] },
+      earR: { rx: [0, 0, 0, 0, -10] },
+    },
+  },
+  fx: {
+    replace: ['syllable'],
+    /* sound comes out of the sides of the screen */
+    syllable: [{ glyph: 'arc', anchor: 'mouth', rate: 2, offset: [0.5, 0.1, -0.1], mirror: true, velocity: [0.26, 0.02, 0.02], jitter: 0.02, life: [0.55, 0.7], size: [0.04, 0.1], rotation: 0, color: '#6aaee6' }],
+    /* signal rings off the antenna while it thinks and listens */
+    thinking: [{ glyph: 'ring', anchor: 'antenna', rate: 1.3, velocity: [0, 0.02, 0], life: [0.9, 1.1], size: [0.03, 0.17], color: '#ffb347', glow: true }],
+    listening: [{ glyph: 'ring', anchor: 'antenna', rate: 1.1, velocity: [0, 0, 0], life: [1, 1.2], size: [0.2, 0.03], color: '#62e39a', glow: true }],
+    land: [{ glyph: 'spark', anchor: 'feet', rate: 6, spread: 0.12, velocity: [0, 0.6, 0], jitter: 1.1, gravity: 3, life: [0.25, 0.42], size: [0.035, 0.02], color: '#ffd27a', glow: true, align: true }],
+    'enter:happy': [{ glyph: 'spark', anchor: 'antenna', rate: 8, velocity: [0, 0.5, 0], jitter: 1.4, gravity: 2, life: [0.3, 0.5], size: [0.04, 0.02], color: '#ffe08a', glow: true, align: true }],
+  },
+};
+
+export default volt;