wobnimo 0.1.4 → 0.2.0

package/skill/examples/miso.ts

@@ -0,0 +1,182 @@
+import type { CharacterSpec } from 'wobnimo';
+
+/** A plush cat: soft fur, big green eyes, ears that talk and a tail that never stops. */
+export const miso: CharacterSpec = {
+  id: 'miso',
+  name: 'Miso',
+  tagline: 'A plush tabby with velvet fur, swivelling ears and a tail that never sits still',
+  accent: '#e38b3c',
+  frame: { target: 0.56, radius: 0.72 },
+  bound: { y: 0.52, radius: 0.88 },
+  motion: { hop: 0.14, squash: 1.2, snap: 1.1, talkSquash: 0.3 },
+  materials: {
+    /* matte plush: almost no highlight, a velvet glow at the edges where
+       the fibres catch the light, and a little light through the fluff */
+    fur: { color: '#eaa15c', f0: 0.015, spec: 0.06, shininess: 6, rim: 1.1, sheen: 0.95, gloss: 0, sss: 0.18, sssColor: '#ffcf9e' },
+    cream: { color: '#fbe8d0', f0: 0.015, spec: 0.06, shininess: 6, rim: 1, sheen: 0.9, gloss: 0, sss: 0.18, sssColor: '#ffe6cc' },
+    pink: { color: '#ff9fb2', f0: 0.04, spec: 0.5, shininess: 40, rim: 0.4, sss: 0.4, sssColor: '#ffc4cf' },
+    nose: { color: '#f27a93', f0: 0.06, spec: 1.6, shininess: 160, rim: 0.3, gloss: 0.8 },
+    whisker: { color: '#fff8ee', f0: 0.04, spec: 0.6, shininess: 60, rim: 0.5 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { ry: [['yaw', 0.2]], rz: [['roll', 0.25]] } },
+    { name: 'head', parent: 'body', pivot: [0, 0.5, 0.02], drive: { rx: [['pitch', -1]], ry: [['yaw', 0.85]], rz: [['roll', 0.8]] } },
+    /* ears twitch on their own every so often, and flick with every hop */
+    {
+      name: 'earL', parent: 'head', pivot: [-0.19, 0.38, -0.02], rest: { rz: 0.32 }, wave: { rx: [0.06, 0.37, 0] },
+      jiggle: { axis: [0, 1, 0], length: 0.16, freq: 3.2, damping: 0.16, maxAngle: 0.5 },
+    },
+    {
+      name: 'earR', parent: 'head', pivot: [0.19, 0.38, -0.02], rest: { rz: -0.32 }, wave: { rx: [0.06, 0.29, 2] },
+      jiggle: { axis: [0, 1, 0], length: 0.16, freq: 3.2, damping: 0.16, maxAngle: 0.5 },
+    },
+    { name: 'pawL', parent: 'body', pivot: [-0.13, 0.22, 0.17], drive: { rx: [['flap', -1.2]], rz: [['flap', -0.4]] } },
+    { name: 'pawR', parent: 'body', pivot: [0.13, 0.22, 0.17], drive: { rx: [['flap', -1.2]], rz: [['flap', 0.4]] } },
+    /* the tail: three links, each lagging the one before */
+    { name: 'tail0', parent: 'body', pivot: [0.12, 0.1, -0.24], rest: { rx: -0.5, rz: -0.5 }, wave: { rz: [0.25, 0.45, 0] }, jiggle: { axis: [0, 1, 0], length: 0.16, freq: 2, damping: 0.25, maxAngle: 0.7 } },
+    { name: 'tail1', parent: 'tail0', pivot: [0, 0.16, 0], rest: { rx: -0.3 }, wave: { rz: [0.2, 0.45, 0.8] }, jiggle: { axis: [0, 1, 0], length: 0.15, freq: 1.8, damping: 0.22, maxAngle: 0.8 } },
+    { name: 'tail2', parent: 'tail1', pivot: [0, 0.15, 0], rest: { rx: 0.25 }, wave: { rz: [0.3, 0.45, 1.6] }, jiggle: { axis: [0, 1, 0], length: 0.13, freq: 1.6, damping: 0.2, maxAngle: 0.9 } },
+  ],
+  parts: [
+    /* a round sitting body with haunches and big back feet */
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.25, -0.02], radii: [0.29, 0.26, 0.26], material: 'fur' },
+    { bone: 'body', shape: 'ellipsoid', at: [-0.17, 0.13, -0.02], radii: [0.14, 0.13, 0.19], blend: 0.08, material: 'fur' },
+    { bone: 'body', shape: 'ellipsoid', at: [0.17, 0.13, -0.02], radii: [0.14, 0.13, 0.19], blend: 0.08, material: 'fur' },
+    { bone: 'body', shape: 'ellipsoid', at: [-0.17, 0.04, 0.14], radii: [0.085, 0.05, 0.11], blend: 0.03, material: 'cream' },
+    { bone: 'body', shape: 'ellipsoid', at: [0.17, 0.04, 0.14], radii: [0.085, 0.05, 0.11], blend: 0.03, material: 'cream' },
+    /* a big head with chubby cheeks and a muzzle */
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.2, 0], radii: [0.34, 0.28, 0.29], blend: 0.1, material: 'fur' },
+    { bone: 'head', shape: 'sphere', at: [-0.17, 0.1, 0.12], radius: 0.15, blend: 0.1, material: 'fur' },
+    { bone: 'head', shape: 'sphere', at: [0.17, 0.1, 0.12], radius: 0.15, blend: 0.1, material: 'fur' },
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.09, 0.22], radii: [0.12, 0.075, 0.08], blend: 0.05, material: 'cream' },
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.135, 0.3], rot: [0.3, 0, 0], radii: [0.032, 0.02, 0.018], blend: 0.01, material: 'nose' },
+    /* ears, with pink insides */
+    { bone: 'earL', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.15, 0], r1: 0.1, r2: 0.022, blend: 0.05, material: 'fur' },
+    { bone: 'earL', shape: 'ellipsoid', at: [0, 0.055, 0.045], radii: [0.05, 0.075, 0.03], material: 'pink' },
+    { bone: 'earR', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.15, 0], r1: 0.1, r2: 0.022, blend: 0.05, material: 'fur' },
+    { bone: 'earR', shape: 'ellipsoid', at: [0, 0.055, 0.045], radii: [0.05, 0.075, 0.03], material: 'pink' },
+    /* front paws, cream mittens */
+    { bone: 'pawL', shape: 'capsule', from: [0, 0, 0], to: [0, -0.15, 0.03], radius: 0.065, blend: 0.05, material: 'fur' },
+    { bone: 'pawL', shape: 'ellipsoid', at: [0, -0.17, 0.05], radii: [0.07, 0.05, 0.075], blend: 0.03, material: 'cream' },
+    { bone: 'pawR', shape: 'capsule', from: [0, 0, 0], to: [0, -0.15, 0.03], radius: 0.065, blend: 0.05, material: 'fur' },
+    { bone: 'pawR', shape: 'ellipsoid', at: [0, -0.17, 0.05], radii: [0.07, 0.05, 0.075], blend: 0.03, material: 'cream' },
+    /* the tail, thick at the root, with a cream tip */
+    { bone: 'tail0', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.16, 0], r1: 0.055, r2: 0.05, blend: 0.04, material: 'fur' },
+    { bone: 'tail1', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.15, 0], r1: 0.05, r2: 0.047, blend: 0.02, material: 'fur' },
+    { bone: 'tail2', shape: 'roundCone', from: [0, 0, 0], to: [0, 0.12, 0], r1: 0.047, r2: 0.04, blend: 0.02, material: 'cream' },
+    /* whiskers */
+    { bone: 'head', shape: 'capsule', from: [-0.13, 0.1, 0.27], to: [-0.33, 0.13, 0.24], radius: 0.005, material: 'whisker' },
+    { bone: 'head', shape: 'capsule', from: [-0.13, 0.08, 0.27], to: [-0.33, 0.06, 0.23], radius: 0.005, material: 'whisker' },
+    { bone: 'head', shape: 'capsule', from: [0.13, 0.1, 0.27], to: [0.33, 0.13, 0.24], radius: 0.005, material: 'whisker' },
+    { bone: 'head', shape: 'capsule', from: [0.13, 0.08, 0.27], to: [0.33, 0.06, 0.23], radius: 0.005, material: 'whisker' },
+  ],
+  paints: [
+    /* tabby stripes on the forehead and a cream belly */
+    { bone: 'head', on: ['fur'], kind: 'ellipse', at: [0, 0.4, 0.2], radii: [0.022, 0.08], color: '#c4733a', soft: 0.5 },
+    { bone: 'head', on: ['fur'], kind: 'ellipse', at: [-0.075, 0.38, 0.2], radii: [0.018, 0.065], color: '#c4733a', soft: 0.5 },
+    { bone: 'head', on: ['fur'], kind: 'ellipse', at: [0.075, 0.38, 0.2], radii: [0.018, 0.065], color: '#c4733a', soft: 0.5 },
+    { bone: 'body', on: ['fur'], kind: 'ellipse', at: [0, 0.24, 0.2], radii: [0.17, 0.2], color: '#fbe8d0', soft: 0.35 },
+    { bone: 'head', on: ['fur'], kind: 'sphere', at: [-0.21, 0.1, 0.24], radius: 0.06, color: '#ff9db0', soft: 0.6, opacity: 0.75 },
+    { bone: 'head', on: ['fur'], kind: 'sphere', at: [0.21, 0.1, 0.24], radius: 0.06, color: '#ff9db0', soft: 0.6, opacity: 0.75 },
+  ],
+  eyes: {
+    kind: 'ball',
+    bone: 'head',
+    at: [[-0.125, 0.22, 0.2], [0.125, 0.22, 0.2]],
+    radius: 0.088,
+    iris: '#8ccf4d',
+    irisSize: 0.78,
+    pupilSize: 0.42,
+    pupilAspect: 0.5,
+    lid: 'fur',
+  },
+  face: {
+    kind: 'mouth',
+    bone: 'head',
+    on: ['cream'],
+    at: [0, 0.06, 0.29],
+    width: 0.045,
+    color: '#5b2630',
+    tongue: '#ff8ea3',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.2, 0.42, 0.08] },
+    mouth: { bone: 'head', at: [0, 0.06, 0.32] },
+    ear: { bone: 'head', at: [-0.34, 0.25, 0] },
+    feet: { bone: 'root', at: [0, 0.03, 0.18] },
+    tail: { bone: 'tail2', at: [0, 0.12, 0] },
+  },
+  acting: {
+    idle: { tail0: { rz: [-0.5, 0.15, 0.4, 0] } },
+    /* a paw up to the chin, the tail tip tapping */
+    thinking: {
+      pawR: { rx: -1.75, rz: 0.35 },
+      tail2: { rx: [0.25, 0.3, 1.6, 0] },
+      earL: { ry: 0.5 },
+    },
+    /* both ears swivel forward, one turned to catch the sound */
+    listening: {
+      earL: { rx: -0.35, ry: -0.6 },
+      earR: { rx: -0.35 },
+      tail0: { rz: -0.35 },
+    },
+    speaking: {
+      pawL: { rx: [-0.4, 0.25, 1.2, 0] },
+      pawR: { rx: [-0.3, 0.25, 1.2, 1.9] },
+      tail0: { rz: [-0.5, 0.2, 0.9, 0] },
+    },
+    /* ears folded flat, tail wrapped round the front */
+    sleeping: {
+      earL: { rz: 0.5, rx: 0.4 },
+      earR: { rz: -0.5, rx: 0.4 },
+      tail0: { rx: 0.4, rz: -1.2 },
+      tail1: { rx: 0.5 },
+    },
+    /* kneading: making biscuits, paw after paw */
+    working: {
+      pawL: { rx: [-0.35, 0.3, 3.4, 0] },
+      pawR: { rx: [-0.35, 0.3, 3.4, Math.PI] },
+      earL: { rx: -0.25 },
+      earR: { rx: -0.25 },
+      tail2: { rx: [0.25, 0.2, 1.7, 0] },
+    },
+    /* airplane ears and a tail stood straight up, bristling */
+    error: {
+      earL: { rz: 1.1, rx: 0.3 },
+      earR: { rz: -1.1, rx: 0.3 },
+      tail0: { rx: [-0.9, 0.05, 12, 0], rz: 0 },
+      tail1: { rx: 0.3 },
+      tail2: { rx: 0.2 },
+    },
+    surprised: {
+      earL: { rz: -0.1, rx: -0.2 },
+      earR: { rz: 0.1, rx: -0.2 },
+      pawL: { rx: -1.4, rz: -0.4 },
+      pawR: { rx: -1.4, rz: 0.4 },
+      tail0: { rx: -0.9, rz: 0 },
+    },
+    celebrating: {
+      pawL: { rx: [-2.2, 0.35, 4, 0], rz: -0.5 },
+      pawR: { rx: [-2.2, 0.35, 4, Math.PI], rz: 0.5 },
+      tail0: { rz: [-0.4, 0.5, 2.6, 0] },
+    },
+    /* ears droop out to the sides, the tail lies flat on the floor */
+    sad: {
+      earL: { rz: 0.95, rx: 0.35 },
+      earR: { rz: -0.95, rx: 0.35 },
+      tail0: { rx: 0.7, rz: -0.8 },
+      tail1: { rx: 0.3 },
+      tail2: { rx: 0.1 },
+    },
+    happy: {
+      pawL: { rx: [-1.6, 0.3, 5, 0] },
+      pawR: { rx: [-1.6, 0.3, 5, 1.4] },
+      tail0: { rz: [-0.5, 0.45, 3, 0] },
+    },
+  },
+  fx: {
+    happy: [{ glyph: 'heart', anchor: 'top', rate: 1.2, spread: 0.15, velocity: [0, 0.22, 0.05], jitter: 0.12, wobble: 0.06, life: [1, 1.3], size: [0.04, 0.07], color: '#ff86a2' }],
+  },
+};
+
+export default miso;

package/skill/examples/mochi.ts

@@ -0,0 +1,78 @@
+import type { CharacterSpec } from 'wobnimo';
+
+/** A drop of jelly with a sprout on top: all squash, stretch and wobble. */
+export const mochi: CharacterSpec = {
+  id: 'mochi',
+  name: 'Mochi',
+  tagline: 'Translucent jelly that squashes and splashes, with a propeller sprout',
+  accent: '#1fae8a',
+  frame: { target: 0.56, radius: 0.8 },
+  bound: { y: 0.5, radius: 0.82 },
+  motion: { hop: 0.17, squash: 1.9, snap: 0.9, talkSquash: 1.3 },
+  materials: {
+    jelly: { color: '#3fcf9f', f0: 0.06, spec: 1.6, shininess: 140, rim: 0.7, sss: 0.55, sssColor: '#9effd9', gloss: 0.9 },
+    bead: { color: '#120d18', f0: 0.06, spec: 2.2, shininess: 400, rim: 0.2, gloss: 1 },
+    leaf: { color: '#5bbf3a', f0: 0.04, spec: 0.7, shininess: 50, rim: 0.6, sss: 0.25, sssColor: '#c8ff7a' },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { rx: [['pitch', -0.35]], ry: [['yaw', 0.55]], rz: [['roll', 0.6]] } },
+    { name: 'sprout', parent: 'body', pivot: [0, 0.83, -0.02], jiggle: { axis: [0, 1, 0], length: 0.16, freq: 2.2, damping: 0.09 } },
+  ],
+  parts: [
+    { bone: 'body', shape: 'sphere', at: [0, 0.41, 0], radius: 0.42, material: 'jelly' },
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.17, 0], radii: [0.5, 0.17, 0.47], blend: 0.24, material: 'jelly' },
+    { bone: 'body', shape: 'roundCone', from: [0, 0.62, 0], to: [0, 0.83, -0.02], r1: 0.17, r2: 0.035, blend: 0.22, material: 'jelly' },
+    { bone: 'sprout', shape: 'capsule', from: [0, -0.02, 0], to: [0, 0.09, 0], radius: 0.014, material: 'leaf' },
+    { bone: 'sprout', shape: 'ellipsoid', at: [-0.065, 0.11, 0], rot: [0, 0.3, 0.5], radii: [0.075, 0.018, 0.042], blend: 0.015, material: 'leaf' },
+    { bone: 'sprout', shape: 'ellipsoid', at: [0.07, 0.12, 0], rot: [0, -0.3, -0.45], radii: [0.08, 0.018, 0.045], blend: 0.015, material: 'leaf' },
+  ],
+  paints: [
+    { bone: 'body', on: ['jelly'], kind: 'sphere', at: [-0.25, 0.32, 0.31], radius: 0.07, color: '#ff8fa8', soft: 0.6, opacity: 0.8 },
+    { bone: 'body', on: ['jelly'], kind: 'sphere', at: [0.25, 0.32, 0.31], radius: 0.07, color: '#ff8fa8', soft: 0.6, opacity: 0.8 },
+  ],
+  eyes: {
+    kind: 'bead',
+    bone: 'body',
+    at: [[-0.14, 0.43, 0.385], [0.14, 0.43, 0.385]],
+    radii: [0.045, 0.066, 0.03],
+    material: 'bead',
+  },
+  face: {
+    kind: 'mouth',
+    bone: 'body',
+    on: ['jelly'],
+    at: [0, 0.32, 0.4],
+    width: 0.065,
+    color: '#173528',
+    tongue: '#ff7d97',
+  },
+  anchors: {
+    top: { bone: 'body', at: [0.16, 0.86, 0.1] },
+    mouth: { bone: 'body', at: [0, 0.32, 0.42] },
+    ear: { bone: 'body', at: [-0.42, 0.45, 0] },
+    feet: { bone: 'root', at: [0, 0.05, 0.25] },
+  },
+  acting: {
+    idle: { sprout: { rz: [0, 0.1, 0.6, 0] } },
+    /* the sprout spins like a propeller while it thinks */
+    thinking: { sprout: { rx: -0.15, ry: [0, 0, 0, 0, 7] } },
+    listening: { sprout: { rx: -0.4, rz: 0.15 } },
+    speaking: { sprout: { rz: [0, 0.2, 2.4, 0] } },
+    sleeping: { sprout: { rx: 0.85, rz: 0.35 } },
+    working: { sprout: { ry: [0, 0, 0, 0, 3] } },
+    error: { sprout: { rx: 0.45, rz: [0.3, 0.15, 12, 0] } },
+    surprised: { sprout: { rx: -0.3 } },
+    celebrating: { sprout: { ry: [0, 0, 0, 0, 18] } },
+    /* the sprout wilts */
+    sad: { sprout: { rx: 1.1, rz: 0.5 } },
+    happy: { sprout: { ry: [0, 0, 0, 0, 16] } },
+  },
+  fx: {
+    replace: ['land'],
+    /* it splashes when it lands */
+    land: [{ glyph: 'drop', anchor: 'feet', rate: 7, spread: 0.18, velocity: [0, 0.65, 0.05], jitter: 0.7, gravity: 3.2, life: [0.45, 0.6], size: [0.035, 0.022], color: '#55d6ad', align: true }],
+    'enter:happy': [{ glyph: 'drop', anchor: 'top', rate: 5, velocity: [0, 0.7, 0.05], jitter: 0.9, gravity: 3, life: [0.5, 0.7], size: [0.035, 0.02], color: '#6fe3bd', align: true }],
+  },
+};
+
+export default mochi;

package/skill/examples/pebble.ts

@@ -0,0 +1,174 @@
+import type { CharacterSpec, PartSpec } from 'wobnimo';
+
+/** A penguin chick in a knitted scarf: a satin coat, a white face, flippers that flap. */
+export const pebble: CharacterSpec = {
+  id: 'pebble',
+  name: 'Pebble',
+  tagline: 'A penguin chick in a knitted scarf: satin coat, waddling walk, flippers that flap when it is happy',
+  accent: '#3d5a9e',
+  frame: { target: 0.56, radius: 0.76 },
+  bound: { y: 0.52, radius: 0.74 },
+  motion: { hop: 0.12, squash: 1.2, snap: 1.05, talkSquash: 0.45 },
+  materials: {
+    /* a short, dense coat: a satin sheen over very fine down */
+    coat: {
+      color: '#27324f', f0: 0.04, spec: 0.7, shininess: 46, rim: 1, sheen: 0.55, gloss: 0.35,
+      surface: { kind: 'fur', scale: 130, strength: 0.28, bone: 'head' },
+    },
+    bodyCoat: {
+      color: '#27324f', shadeOf: 'coat', f0: 0.04, spec: 0.7, shininess: 46, rim: 1, sheen: 0.55, gloss: 0.35,
+      surface: { kind: 'fur', scale: 130, strength: 0.28 },
+    },
+    flipper: { color: '#222b45', shadeOf: 'coat', f0: 0.04, spec: 0.8, shininess: 50, rim: 0.9, sheen: 0.5, gloss: 0.4 },
+    beak: { color: '#ffa53d', f0: 0.05, spec: 1, shininess: 80, rim: 0.4, gloss: 0.6 },
+    mouth: { color: '#5d1a22', f0: 0.04, spec: 0.5, shininess: 30, rim: 0 },
+    feet: { color: '#ff9b3d', f0: 0.04, spec: 0.7, shininess: 50, rim: 0.35, gloss: 0.4, sss: 0.25, sssColor: '#ffc68a' },
+    /* chunky red knit: a pebbled surface with dark seams reads as stitches */
+    knit: {
+      color: '#e8433f', f0: 0.02, spec: 0.15, shininess: 10, rim: 0.7, sheen: 0.7,
+      surface: { kind: 'scales', scale: 42, strength: 0.75, color: '#a8242a' },
+    },
+    knitStripe: { color: '#fff2e6', f0: 0.02, spec: 0.15, shininess: 10, rim: 0.6, sheen: 0.7 },
+  },
+  bones: [
+    /* the body rolls side to side as it shifts its weight: the waddle */
+    { name: 'body', pivot: [0, 0, 0], drive: { ry: [['yaw', 0.2]], rz: [['roll', 0.35]] }, wave: { rz: [0.035, 0.9, 0] } },
+    { name: 'head', parent: 'body', pivot: [0, 0.6, 0.01], drive: { rx: [['pitch', -1]], ry: [['yaw', 0.8]], rz: [['roll', 0.7]] } },
+    { name: 'beak', parent: 'head', pivot: [0, 0.12, 0.27], drive: { rx: [['talk', -0.22]] } },
+    { name: 'jaw', parent: 'head', pivot: [0, 0.12, 0.27], drive: { rx: [['talk', 0.75]] } },
+    /* a little crest of down on top */
+    { name: 'tuft', parent: 'head', pivot: [0, 0.42, 0.02], rest: { rx: -0.2 }, jiggle: { axis: [0, 1, 0], length: 0.1, freq: 3.4, damping: 0.15 } },
+    {
+      name: 'flipperL', parent: 'body', pivot: [-0.3, 0.5, 0], rest: { rz: -0.2 },
+      drive: { rz: [['flap', -1.4]] }, jiggle: { axis: [0, -1, 0], length: 0.26, freq: 3.4, damping: 0.3, maxAngle: 0.45 },
+    },
+    {
+      name: 'flipperR', parent: 'body', pivot: [0.3, 0.5, 0], rest: { rz: 0.2 },
+      drive: { rz: [['flap', 1.4]] }, jiggle: { axis: [0, -1, 0], length: 0.26, freq: 3.4, damping: 0.3, maxAngle: 0.45 },
+    },
+    /* the scarf's loose end hangs over the shoulder and swings */
+    { name: 'scarf', parent: 'body', pivot: [0.13, 0.56, 0.25], rest: { rz: 0.12, rx: -0.15 }, jiggle: { axis: [0, -1, 0], length: 0.2, freq: 2.4, damping: 0.16, maxAngle: 0.7 } },
+    { name: 'tail', parent: 'body', pivot: [0, 0.1, -0.27], rest: { rx: -1.2 }, jiggle: { axis: [0, 1, 0], length: 0.08, freq: 3, damping: 0.2 } },
+  ],
+  parts: [
+    /* an egg of a body and a big round head, blended into one */
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.34, -0.01], radii: [0.32, 0.34, 0.29], material: 'bodyCoat' },
+    { bone: 'head', shape: 'sphere', at: [0, 0.16, 0], radius: 0.28, blend: 0.14, material: 'coat' },
+    /* the scarf: a fat knitted collar and a striped end */
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.575, 0.005], radii: [0.3, 0.078, 0.28], material: 'knit' },
+    { bone: 'scarf', shape: 'roundBox', at: [0, -0.1, 0.01], half: [0.05, 0.1, 0.018], round: 0.016, material: 'knit' },
+    { bone: 'scarf', shape: 'roundBox', at: [0, -0.195, 0.01], half: [0.052, 0.018, 0.02], round: 0.012, material: 'knitStripe' },
+    /* a small beak in two halves */
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.12, 0.29], radii: [0.035, 0.02, 0.025], material: 'mouth' },
+    { bone: 'beak', shape: 'ellipsoid', at: [0, 0, 0.035], rot: [0.15, 0, 0], radii: [0.05, 0.034, 0.05], clip: { normal: [0, -1, 0] }, material: 'beak' },
+    { bone: 'beak', shape: 'ellipsoid', at: [0, 0, 0.035], rot: [0.15, 0, 0], radii: [0.041, 0.028, 0.042], clip: { normal: [0, -1, 0], offset: 0.003 }, material: 'mouth' },
+    { bone: 'jaw', shape: 'ellipsoid', at: [0, 0, 0.026], radii: [0.043, 0.025, 0.044], clip: { normal: [0, 1, 0] }, material: 'beak' },
+    { bone: 'jaw', shape: 'ellipsoid', at: [0, 0, 0.026], radii: [0.035, 0.019, 0.036], clip: { normal: [0, 1, 0], offset: 0.003 }, material: 'mouth' },
+    { bone: 'tuft', shape: 'roundCone', from: [0, -0.03, 0], to: [0.01, 0.07, 0.02], r1: 0.035, r2: 0.008, blend: 0.03, material: 'coat' },
+    { bone: 'tuft', shape: 'roundCone', from: [0, -0.03, 0], to: [-0.04, 0.05, -0.02], r1: 0.028, r2: 0.007, blend: 0.03, material: 'coat' },
+    /* flippers: flat, tapered, lying against the sides */
+    { bone: 'flipperL', shape: 'ellipsoid', at: [-0.02, -0.16, 0.02], rot: [0, 0, -0.12], radii: [0.045, 0.2, 0.11], blend: 0.02, material: 'flipper' },
+    { bone: 'flipperR', shape: 'ellipsoid', at: [0.02, -0.16, 0.02], rot: [0, 0, 0.12], radii: [0.045, 0.2, 0.11], blend: 0.02, material: 'flipper' },
+    { bone: 'tail', shape: 'ellipsoid', at: [0, 0.05, 0], radii: [0.08, 0.07, 0.025], blend: 0.03, material: 'bodyCoat' },
+    /* big orange feet, three soft toes each */
+    ...[-1, 1].flatMap((s): PartSpec[] => [
+      { bone: 'root', shape: 'ellipsoid', at: [s * 0.13, 0.03, 0.17], rot: [0, s * 0.25, 0], radii: [0.1, 0.03, 0.11], material: 'feet' },
+      ...[-1, 0, 1].map((t): PartSpec => ({
+        bone: 'root', shape: 'sphere', at: [s * 0.16 + t * 0.055, 0.03, 0.26 - Math.abs(t) * 0.02], radius: 0.034, blend: 0.03, material: 'feet',
+      })),
+    ]),
+  ],
+  paints: [
+    /* a white belly and a heart-shaped white face */
+    { bone: 'body', on: ['bodyCoat'], kind: 'ellipse', at: [0, 0.3, 0.08], radii: [0.24, 0.27], color: '#f8f6f0', soft: 0.12 },
+    { bone: 'head', on: ['coat'], kind: 'sphere', at: [-0.1, 0.13, 0.22], radius: 0.14, color: '#f8f6f0', soft: 0.12 },
+    { bone: 'head', on: ['coat'], kind: 'sphere', at: [0.1, 0.13, 0.22], radius: 0.14, color: '#f8f6f0', soft: 0.12 },
+    { bone: 'head', on: ['coat'], kind: 'ellipse', at: [0, 0.02, 0.1], radii: [0.17, 0.08], color: '#f8f6f0', soft: 0.2 },
+    { bone: 'head', on: ['coat'], kind: 'sphere', at: [-0.17, 0.06, 0.2], radius: 0.05, color: '#ff9eb0', soft: 0.6, opacity: 0.8 },
+    { bone: 'head', on: ['coat'], kind: 'sphere', at: [0.17, 0.06, 0.2], radius: 0.05, color: '#ff9eb0', soft: 0.6, opacity: 0.8 },
+    /* a white stripe across the scarf's end, knitted in */
+    { bone: 'scarf', on: ['knit'], kind: 'ellipse', at: [0, -0.12, 0], radii: [0.08, 0.018], color: '#fff2e6', soft: 0.15 },
+  ],
+  eyes: {
+    kind: 'ball',
+    bone: 'head',
+    at: [[-0.1, 0.18, 0.23], [0.1, 0.18, 0.23]],
+    radius: 0.066,
+    iris: '#1d2233',
+    irisSize: 0.8,
+    pupilSize: 0.5,
+    lid: 'coat',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.12, 0.44, 0.06] },
+    mouth: { bone: 'head', at: [0, 0.11, 0.36] },
+    ear: { bone: 'head', at: [-0.3, 0.18, 0] },
+    feet: { bone: 'root', at: [0, 0.02, 0.17] },
+    chest: { bone: 'body', at: [0, 0.4, 0.3] },
+  },
+  acting: {
+    idle: { tail: { rz: [0, 0.2, 0.9, 0] } },
+    /* a flipper tip to the beak */
+    thinking: {
+      flipperR: { rz: 1.2, rx: -1.1, ry: -0.3 },
+      head: { rz: 0.1 },
+    },
+    listening: {
+      flipperL: { rz: -0.9, rx: -0.3 },
+      tuft: { rx: -0.35 },
+    },
+    speaking: {
+      flipperL: { rz: [-0.15, 0.15, 1.8, 0] },
+      flipperR: { rz: [0.15, 0.15, 1.8, 1.5] },
+    },
+    /* flippers folded over the belly, tucked into the scarf */
+    sleeping: {
+      flipperL: { ry: 0.6, rz: 0.2 },
+      flipperR: { ry: -0.6, rz: -0.2 },
+      tuft: { rx: 0.5 },
+    },
+    /* tapping away with both flipper tips */
+    working: {
+      flipperL: { rx: [-0.7, 0.15, 6, 0], rz: 0.2 },
+      flipperR: { rx: [-0.7, 0.15, 6, Math.PI], rz: -0.2 },
+      head: { rx: 0.12 },
+    },
+    /* flippers stuck straight out, trembling */
+    error: {
+      flipperL: { rz: [-1.25, 0.08, 13, 0] },
+      flipperR: { rz: [1.25, 0.08, 13, 1] },
+      tuft: { rx: -0.6 },
+    },
+    surprised: {
+      flipperL: { rz: -1.6, rx: -0.3 },
+      flipperR: { rz: 1.6, rx: -0.3 },
+      tuft: { rx: -0.7 },
+    },
+    /* penguins flap when they are delighted */
+    celebrating: {
+      flipperL: { rz: [-1.1, 0.55, 8, 0] },
+      flipperR: { rz: [1.1, 0.55, 8, 0] },
+      tail: { rz: [0, 0.4, 4, 0] },
+    },
+    /* flippers hang, the crest flops */
+    sad: {
+      flipperL: { rz: 0.18 },
+      flipperR: { rz: -0.18 },
+      tuft: { rx: 0.8 },
+      scarf: { rx: 0.1 },
+    },
+    happy: {
+      flipperL: { rz: [-0.8, 0.6, 9, 0] },
+      flipperR: { rz: [0.8, 0.6, 9, 0] },
+      tail: { rz: [0, 0.35, 5, 0] },
+    },
+  },
+  fx: {
+    replace: ['land'],
+    /* it lands in snow */
+    land: [{ glyph: 'puff', anchor: 'feet', rate: 8, spread: 0.12, velocity: [0, 0.06, 0], jitter: 0.34, drag: 3.5, life: [0.5, 0.75], size: [0.05, 0.12], color: '#eef4ff' }],
+    celebrating: [{ glyph: 'sparkle', anchor: 'top', rate: 3, spread: 0.4, velocity: [0, -0.05, 0], jitter: 0.08, wobble: 0.08, life: [1.4, 1.8], size: [0.04, 0.01], spin: 1.2, color: '#dff0ff' }],
+  },
+};
+
+export default pebble;

package/skill/examples/pip.ts

@@ -0,0 +1,170 @@
+import type { CharacterSpec } from 'wobnimo';
+
+/** A round songbird chick: soft feathers, flapping wings, a beak that talks. */
+export const pip: CharacterSpec = {
+  id: 'pip',
+  name: 'Pip',
+  tagline: 'Sings with a real beak, snaps its head like a bird, flaps',
+  accent: '#e8892a',
+  frame: { target: 0.66, radius: 0.86 },
+  bound: { y: 0.62, radius: 0.92 },
+  motion: { hop: 0.13, squash: 1.1, snap: 1.25, snapLook: 1, talkSquash: 0.5 },
+  materials: {
+    feather: { color: '#f4a63c', f0: 0.03, spec: 0.22, shininess: 14, rim: 0.9, sheen: 0.55 },
+    wing: { color: '#d8692a', shadeOf: 'feather', f0: 0.03, spec: 0.25, shininess: 16, rim: 0.8, sheen: 0.5 },
+    beak: { color: '#ff7a45', f0: 0.05, spec: 0.9, shininess: 70, rim: 0.4, gloss: 0.6 },
+    feet: { color: '#e9683b', f0: 0.04, spec: 0.6, shininess: 40, rim: 0.3 },
+    mouth: { color: '#6b1a26', f0: 0.04, spec: 0.6, shininess: 40, rim: 0 },
+    tongue: { color: '#ff7f91', f0: 0.05, spec: 1, shininess: 60, rim: 0.2, gloss: 0.6 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { rz: [['roll', 0.3]], rx: [['pitch', -0.12]] } },
+    { name: 'head', parent: 'body', pivot: [0, 0.62, 0], drive: { rx: [['pitch', -1]], ry: [['yaw', 0.9]], rz: [['roll', 0.8]] } },
+    /* the beak opens both ways: the jaw drops and the top lifts a little */
+    { name: 'beak', parent: 'head', pivot: [0, 0.14, 0.33], drive: { rx: [['talk', -0.24]] } },
+    { name: 'jaw', parent: 'head', pivot: [0, 0.14, 0.33], drive: { rx: [['talk', 0.8]] } },
+    { name: 'tuft', parent: 'head', pivot: [0, 0.5, 0.04], rest: { rx: 0.25 }, jiggle: { axis: [0, 1, 0], length: 0.14, freq: 3, damping: 0.14 } },
+    {
+      name: 'wingL', parent: 'body', pivot: [-0.38, 0.6, -0.02],
+      drive: { rz: [['flap', -1.5]] }, wave: { rz: [0.04, 0.8, 0] },
+      jiggle: { axis: [0, -1, 0], length: 0.3, freq: 3.2, damping: 0.3, maxAngle: 0.5 },
+    },
+    {
+      name: 'wingR', parent: 'body', pivot: [0.38, 0.6, -0.02],
+      drive: { rz: [['flap', 1.5]] }, wave: { rz: [-0.04, 0.8, 1.1] },
+      jiggle: { axis: [0, -1, 0], length: 0.3, freq: 3.2, damping: 0.3, maxAngle: 0.5 },
+    },
+    { name: 'tail', parent: 'body', pivot: [0, 0.3, -0.36], rest: { rx: -0.95 }, jiggle: { axis: [0, 1, 0], length: 0.18, freq: 2.6, damping: 0.18 } },
+  ],
+  parts: [
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.42, 0], radii: [0.45, 0.41, 0.42], material: 'feather' },
+    { bone: 'head', shape: 'sphere', at: [0, 0.18, 0.03], radius: 0.35, blend: 0.18, material: 'feather' },
+    /* a chick's beak in two halves that hinge apart. Each half is lined
+       with a slightly smaller dark copy, so its cut face reads as the inside
+       of the mouth; a dark throat fills the gap behind them */
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.14, 0.37], radii: [0.05, 0.03, 0.035], material: 'mouth' },
+    { bone: 'beak', shape: 'ellipsoid', at: [0, 0, 0.06], rot: [0.12, 0, 0], radii: [0.076, 0.056, 0.1], clip: { normal: [0, -1, 0] }, material: 'beak' },
+    { bone: 'beak', shape: 'ellipsoid', at: [0, 0, 0.06], rot: [0.12, 0, 0], radii: [0.064, 0.048, 0.088], clip: { normal: [0, -1, 0], offset: 0.003 }, material: 'mouth' },
+    { bone: 'jaw', shape: 'ellipsoid', at: [0, 0, 0.045], radii: [0.064, 0.04, 0.08], clip: { normal: [0, 1, 0] }, material: 'beak' },
+    { bone: 'jaw', shape: 'ellipsoid', at: [0, 0, 0.045], radii: [0.053, 0.032, 0.068], clip: { normal: [0, 1, 0], offset: 0.003 }, material: 'mouth' },
+    { bone: 'jaw', shape: 'ellipsoid', at: [0, 0.002, 0.04], radii: [0.034, 0.01, 0.042], material: 'tongue' },
+    /* a tuft of three feathers */
+    { bone: 'tuft', shape: 'roundCone', from: [0, -0.04, 0], to: [0.015, 0.12, 0.03], r1: 0.045, r2: 0.01, blend: 0.03, material: 'feather' },
+    { bone: 'tuft', shape: 'roundCone', from: [0, -0.04, -0.02], to: [-0.05, 0.08, -0.05], r1: 0.035, r2: 0.008, blend: 0.03, material: 'feather' },
+    { bone: 'tuft', shape: 'roundCone', from: [0, -0.04, -0.02], to: [0.06, 0.07, -0.04], r1: 0.03, r2: 0.008, blend: 0.03, material: 'feather' },
+    /* wings hinge at the shoulder and lie against the body */
+    { bone: 'wingL', shape: 'ellipsoid', at: [-0.02, -0.17, 0], rot: [0, 0, -0.18], radii: [0.08, 0.23, 0.2], blend: 0.02, material: 'wing' },
+    { bone: 'wingR', shape: 'ellipsoid', at: [0.02, -0.17, 0], rot: [0, 0, 0.18], radii: [0.08, 0.23, 0.2], blend: 0.02, material: 'wing' },
+    { bone: 'tail', shape: 'ellipsoid', at: [0, 0.1, 0], radii: [0.14, 0.12, 0.035], blend: 0.04, material: 'wing' },
+    /* three toes a foot */
+    { bone: 'root', shape: 'capsule', from: [-0.15, 0.03, 0.12], to: [-0.2, 0.025, 0.25], radius: 0.026, material: 'feet' },
+    { bone: 'root', shape: 'capsule', from: [-0.15, 0.03, 0.12], to: [-0.12, 0.025, 0.26], radius: 0.026, material: 'feet' },
+    { bone: 'root', shape: 'capsule', from: [-0.15, 0.03, 0.12], to: [-0.15, 0.06, 0.02], radius: 0.03, blend: 0.02, material: 'feet' },
+    { bone: 'root', shape: 'capsule', from: [0.15, 0.03, 0.12], to: [0.2, 0.025, 0.25], radius: 0.026, material: 'feet' },
+    { bone: 'root', shape: 'capsule', from: [0.15, 0.03, 0.12], to: [0.12, 0.025, 0.26], radius: 0.026, material: 'feet' },
+    { bone: 'root', shape: 'capsule', from: [0.15, 0.03, 0.12], to: [0.15, 0.06, 0.02], radius: 0.03, blend: 0.02, material: 'feet' },
+  ],
+  paints: [
+    { bone: 'body', on: ['feather'], kind: 'ellipse', at: [0, 0.3, 0], radii: [0.29, 0.28], color: '#fde7c0', soft: 0.07 },
+    { bone: 'head', on: ['feather'], kind: 'sphere', at: [-0.22, 0.08, 0.27], radius: 0.075, color: '#ff8c8c', soft: 0.6, opacity: 0.75 },
+    { bone: 'head', on: ['feather'], kind: 'sphere', at: [0.22, 0.08, 0.27], radius: 0.075, color: '#ff8c8c', soft: 0.6, opacity: 0.75 },
+  ],
+  eyes: {
+    kind: 'ball',
+    bone: 'head',
+    at: [[-0.14, 0.24, 0.3], [0.14, 0.24, 0.3]],
+    radius: 0.078,
+    iris: '#4a2a12',
+    irisSize: 0.72,
+    pupilSize: 0.42,
+    lid: 'feather',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.14, 0.5, 0.1] },
+    mouth: { bone: 'head', at: [0, 0.13, 0.47] },
+    ear: { bone: 'head', at: [-0.32, 0.22, 0] },
+    feet: { bone: 'root', at: [0, 0.02, 0.12] },
+    chest: { bone: 'body', at: [0, 0.45, 0.32] },
+  },
+  acting: {
+    idle: {
+      tail: { rx: [0, 0.14, 1.3, 0] },
+    },
+    /* a wing tip to the chin */
+    thinking: {
+      wingR: { rz: 1.05, rx: -0.95, ry: -0.35 },
+      tuft: { rx: 0.25 },
+      tail: { rx: [0, 0.08, 0.5, 0] },
+    },
+    /* a wing cupped by the ear, the tuft perked */
+    listening: {
+      wingL: { rz: -1.1, rx: -0.55 },
+      tuft: { rx: -0.4 },
+      head: { rz: 0.12 },
+    },
+    /* singing: chin up, wings fluttering, tail keeping time */
+    speaking: {
+      head: { rx: [-0.14, 0.05, 1.1, 0] },
+      wingL: { rz: [-0.18, 0.14, 2.3, 0] },
+      wingR: { rz: [0.18, 0.14, 2.3, 1.2] },
+      tail: { rx: [0, 0.22, 2.3, 0.5] },
+    },
+    /* fluffed up, head tucked, wings folded in front */
+    sleeping: {
+      wingL: { ry: 0.5, rz: 0.12 },
+      wingR: { ry: -0.5, rz: -0.12 },
+      tuft: { rx: 0.75 },
+    },
+    /* pecking away: wing tips tapping, head bobbing over the work */
+    working: {
+      wingL: { rz: [-0.4, 0.18, 6, 0], rx: -0.6 },
+      wingR: { rz: [0.4, 0.18, 6, Math.PI], rx: -0.6 },
+      head: { rx: [0.1, 0.07, 5.2, 0] },
+    },
+    /* feathers on end: wings stiff and trembling, tuft and tail up */
+    error: {
+      wingL: { rz: [-1.0, 0.1, 12, 0] },
+      wingR: { rz: [1.0, 0.1, 12, 1] },
+      tuft: { rx: -0.5 },
+      tail: { rx: -0.45 },
+    },
+    surprised: {
+      wingL: { rz: -1.7 },
+      wingR: { rz: 1.7 },
+      tuft: { rx: -0.6 },
+      tail: { rx: -0.5 },
+    },
+    celebrating: {
+      wingL: { rz: [-1.4, 0.5, 9, 0] },
+      wingR: { rz: [1.4, 0.5, 9, 0] },
+      tail: { rx: [0, 0.3, 6, 0] },
+      tuft: { rx: [0, 0.25, 6, 0] },
+    },
+    /* everything droops: wings, tuft, tail */
+    sad: {
+      wingL: { rz: 0.25 },
+      wingR: { rz: -0.25 },
+      tuft: { rx: 0.9 },
+      tail: { rx: 0.5 },
+    },
+    happy: {
+      wingL: { rz: [-0.9, 0.75, 7, 0] },
+      wingR: { rz: [0.9, 0.75, 7, 0] },
+      tail: { rx: [0, 0.3, 5, 0] },
+      tuft: { rx: [0, 0.2, 5, 0] },
+    },
+  },
+  fx: {
+    replace: ['syllable'],
+    /* it sings: a note on every other syllable */
+    syllable: [
+      { glyph: 'note', anchor: 'mouth', rate: 1, offset: [0.12, -0.03, 0.02], velocity: [0.2, 0.13, 0.05], jitter: 0.06, wobble: 0.07, life: [1.1, 1.5], size: [0.045, 0.075], rotation: -0.15, color: '#f08a3c' },
+    ],
+    happy: [{ glyph: 'note', anchor: 'mouth', rate: 1.6, velocity: [0, 0.24, 0.05], jitter: 0.25, wobble: 0.07, life: [1, 1.3], size: [0.04, 0.07], rotation: 0.15, color: '#e8664a' }],
+    'enter:happy': [
+      { glyph: 'feather', anchor: 'chest', rate: 4, spread: 0.12, velocity: [0, 0.18, 0.12], jitter: 0.45, gravity: 0.12, drag: 1.4, wobble: 0.14, life: [1.8, 2.4], size: [0.05, 0.05], spin: 1.6, color: '#f6b04a' },
+    ],
+  },
+};
+
+export default pip;