wobnimo 0.1.4 → 0.2.0

package/skill/examples/hop.ts

@@ -0,0 +1,66 @@
+import type { CharacterSpec } from 'wobnimo';
+
+/** A white bunny with long floppy ears. */
+export const hop: CharacterSpec = {
+  id: 'hop',
+  name: 'Hop',
+  tagline: 'A soft white bunny whose long floppy ears swing with every hop',
+  accent: '#ff8fb1',
+  frame: { target: 0.57, radius: 0.76 },
+  bound: { y: 0.56, radius: 0.66 },
+  motion: { hop: 0.22, squash: 1.3, snap: 1.15, talkSquash: 0.4 },
+  materials: {
+    fur: { color: '#fbf8f4', f0: 0.03, spec: 0.4, shininess: 20, rim: 1, sheen: 0.7, surface: { kind: 'fur', scale: 110, strength: 0.3, bone: 'head' } },
+    bodyFur: { color: '#fbf8f4', shadeOf: 'fur', f0: 0.03, spec: 0.4, shininess: 20, rim: 1, sheen: 0.7, surface: { kind: 'fur', scale: 110, strength: 0.3 } },
+    earFur: { color: '#fbf8f4', shadeOf: 'fur', f0: 0.03, spec: 0.4, shininess: 20, rim: 1.2, sheen: 0.7, sss: 0.35, sssColor: '#ffc4d4' },
+    nose: { color: '#ff7fa5', f0: 0.06, spec: 1.6, shininess: 160, rim: 0.3, gloss: 0.8 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, 0, 0], drive: { ry: [['yaw', 0.2]], rz: [['roll', 0.35]] } },
+    { name: 'head', parent: 'body', pivot: [0, 0.42, 0.02], drive: { rx: [['pitch', -1]], ry: [['yaw', 0.8]], rz: [['roll', 0.7]] } },
+    /* long ears that flop down and swing */
+    { name: 'earL', parent: 'head', pivot: [-0.1, 0.3, -0.02], rest: { rz: 0.35, rx: 0.2 }, jiggle: { axis: [0, 1, 0], length: 0.32, freq: 2, damping: 0.14, maxAngle: 0.8 } },
+    { name: 'earR', parent: 'head', pivot: [0.1, 0.3, -0.02], rest: { rz: -1.2, rx: 0.2 }, jiggle: { axis: [0, 1, 0], length: 0.32, freq: 2, damping: 0.14, maxAngle: 0.8 } },
+    { name: 'tail', parent: 'body', pivot: [0, 0.14, -0.2], jiggle: { axis: [0, 0, -1], length: 0.06, freq: 4, damping: 0.2 } },
+  ],
+  parts: [
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.22, 0], radii: [0.22, 0.22, 0.21], material: 'bodyFur' },
+    { bone: 'body', shape: 'ellipsoid', at: [-0.12, 0.05, 0.1], radii: [0.08, 0.05, 0.13], blend: 0.04, material: 'bodyFur' },
+    { bone: 'body', shape: 'ellipsoid', at: [0.12, 0.05, 0.1], radii: [0.08, 0.05, 0.13], blend: 0.04, material: 'bodyFur' },
+    { bone: 'tail', shape: 'sphere', at: [0, 0, -0.03], radius: 0.07, blend: 0.03, material: 'bodyFur' },
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.14, 0], radii: [0.25, 0.22, 0.22], blend: 0.1, material: 'fur' },
+    { bone: 'head', shape: 'ellipsoid', at: [-0.06, 0.06, 0.17], radii: [0.07, 0.055, 0.06], blend: 0.04, material: 'fur' },
+    { bone: 'head', shape: 'ellipsoid', at: [0.06, 0.06, 0.17], radii: [0.07, 0.055, 0.06], blend: 0.04, material: 'fur' },
+    { bone: 'head', shape: 'ellipsoid', at: [0, 0.1, 0.22], radii: [0.028, 0.02, 0.018], material: 'nose' },
+    { bone: 'earL', shape: 'ellipsoid', at: [0, 0.2, 0], radii: [0.065, 0.22, 0.03], material: 'earFur' },
+    { bone: 'earR', shape: 'ellipsoid', at: [0, 0.2, 0], radii: [0.065, 0.22, 0.03], material: 'earFur' },
+  ],
+  paints: [
+    { bone: 'earL', on: ['earFur'], kind: 'ellipse', at: [0, 0.2, 0.03], radii: [0.035, 0.16], color: '#ffc2d3', soft: 0.4 },
+    { bone: 'earR', on: ['earFur'], kind: 'ellipse', at: [0, 0.2, 0.03], radii: [0.035, 0.16], color: '#ffc2d3', soft: 0.4 },
+    { bone: 'head', on: ['fur'], kind: 'sphere', at: [-0.16, 0.07, 0.16], radius: 0.045, color: '#ffb3c8', soft: 0.6, opacity: 0.8 },
+    { bone: 'head', on: ['fur'], kind: 'sphere', at: [0.16, 0.07, 0.16], radius: 0.045, color: '#ffb3c8', soft: 0.6, opacity: 0.8 },
+  ],
+  eyes: { kind: 'ball', bone: 'head', at: [[-0.1, 0.17, 0.17], [0.1, 0.17, 0.17]], radius: 0.05, iris: '#3b1f2b', irisSize: 0.85, pupilSize: 0.55, lid: 'fur' },
+  face: { kind: 'mouth', bone: 'head', on: ['fur'], at: [0, 0.035, 0.21], width: 0.035, color: '#5a2a3a', tongue: '#ff8fa3' },
+  anchors: {
+    top: { bone: 'head', at: [0.15, 0.5, 0.05] },
+    mouth: { bone: 'head', at: [0, 0.035, 0.24] },
+    ear: { bone: 'earL', at: [0, 0.2, 0] },
+    feet: { bone: 'root', at: [0, 0.02, 0.15] },
+  },
+  acting: {
+    thinking: { earR: { rz: -0.4 }, head: { rz: 0.1 } },
+    listening: { earL: { rz: 0, rx: -0.2 }, earR: { rz: 0, rx: -0.2 } },
+    sleeping: { earL: { rz: 1.2, rx: 0.5 }, earR: { rz: -1.4, rx: 0.5 } },
+    error: { earL: { rz: [0.6, 0.2, 9, 0] }, earR: { rz: [-0.6, 0.2, 9, 1] } },
+    surprised: { earL: { rz: 0.05, rx: -0.1 }, earR: { rz: -0.05, rx: -0.1 } },
+    celebrating: { earL: { rz: [0.2, 0.3, 4, 0] }, earR: { rz: [-0.2, 0.3, 4, Math.PI] } },
+    sad: { earL: { rz: 1.4, rx: 0.6 }, earR: { rz: -1.4, rx: 0.6 } },
+  },
+  fx: {
+    happy: [{ glyph: 'heart', anchor: 'top', rate: 1.2, velocity: [0, 0.22, 0.04], jitter: 0.1, life: [1, 1.3], size: [0.04, 0.06], color: '#ff8fb1' }],
+  },
+};
+
+export default hop;

package/skill/examples/inky.ts

@@ -0,0 +1,168 @@
+import type { BoneSpec, CharacterSpec, Expression, Motion, PartSpec } from 'wobnimo';
+
+/* Six tentacles, each a chain of three jiggle bones: every segment lags
+   behind the one before it, so they trail and curl with no animation of
+   their own beyond a slow wave. Generated here, but the result is plain
+   data like any other spec. */
+const TENTACLES = 6;
+const SEGMENT = 0.17;
+const RADII = [0.085, 0.064, 0.044, 0.016];
+const CURL = [-0.6, -0.42, -0.62];
+
+type Acting = Partial<Record<Expression, Record<string, { rx?: Motion; rz?: Motion }>>>;
+
+/* How the tentacles act. Each state sets every segment's curl; a couple of
+   tentacles get their own business (one to the chin, one to the ear). */
+function tentacleActing(): Acting {
+  const acting: Required<Acting> = {
+    idle: {}, thinking: {}, listening: {}, speaking: {}, sleeping: {}, working: {}, error: {}, surprised: {}, celebrating: {}, sad: {}, happy: {},
+  };
+  for (let i = 0; i < TENTACLES; i++) {
+    const phase = i * 1.05;
+    acting.speaking[`t${i}s0`] = { rx: [0, 0.2, 1.1, phase] };
+    acting.speaking[`t${i}s2`] = { rx: [0, 0.35, 1.6, phase + 1] };
+    acting.sleeping[`t${i}s0`] = { rx: 0.3 };
+    acting.sleeping[`t${i}s1`] = { rx: 0.35 };
+    acting.sleeping[`t${i}s2`] = { rx: 0.55 };
+    acting.happy[`t${i}s0`] = { rx: [-0.45, 0.35, 2.4, phase] };
+    acting.happy[`t${i}s1`] = { rx: [0, 0.3, 2.4, phase + 1] };
+    /* a jolt: every tentacle splays and trembles */
+    acting.error[`t${i}s0`] = { rx: -0.35 };
+    acting.error[`t${i}s1`] = { rx: [0.35, 0.18, 9, phase] };
+    acting.error[`t${i}s2`] = { rx: [0.2, 0.22, 11, phase + 2] };
+    /* a fright flings them all up and out */
+    acting.surprised[`t${i}s0`] = { rx: -0.85 };
+    acting.surprised[`t${i}s1`] = { rx: -0.25 };
+    acting.surprised[`t${i}s2`] = { rx: -0.3 };
+    acting.celebrating[`t${i}s0`] = { rx: [-0.5, 0.3, 3, phase] };
+    acting.celebrating[`t${i}s1`] = { rx: [0.15, 0.3, 3, phase + 1] };
+    acting.celebrating[`t${i}s2`] = { rx: [0.2, 0.3, 3, phase + 2] };
+    /* limp, hanging straight down */
+    acting.sad[`t${i}s0`] = { rx: 0.45 };
+    acting.sad[`t${i}s1`] = { rx: 0.42 };
+    acting.sad[`t${i}s2`] = { rx: [0.55, 0.06, 0.4, phase] };
+    acting.working[`t${i}s0`] = { rx: [-0.15, 0.08, 1.2, phase] };
+  }
+  /* the two front tentacles type, in turn */
+  acting.working.t0s0 = { rx: [-1.25, 0.22, 5.5, 0] };
+  acting.working.t0s1 = { rx: [0.7, 0.2, 5.5, 0.6] };
+  acting.working.t5s0 = { rx: [-1.25, 0.22, 5.5, Math.PI] };
+  acting.working.t5s1 = { rx: [0.7, 0.2, 5.5, Math.PI + 0.6] };
+  /* and cheer, the front pair flung out to the sides (a swing across the
+     tentacle, rz), never forward and up where they would cross the face */
+  acting.celebrating.t0s0 = { rx: -0.3, rz: [1.05, 0.25, 3.2, 0] };
+  acting.celebrating.t0s1 = { rx: [0.5, 0.15, 3.2, 1] };
+  acting.celebrating.t0s2 = { rx: [0.6, 0.2, 3.2, 2] };
+  acting.celebrating.t5s0 = { rx: -0.3, rz: [-1.05, 0.25, 3.2, Math.PI] };
+  acting.celebrating.t5s1 = { rx: [0.5, 0.15, 3.2, Math.PI + 1] };
+  acting.celebrating.t5s2 = { rx: [0.6, 0.2, 3.2, Math.PI + 2] };
+  /* tentacle 0 sits front-right: it curls up to the chin */
+  acting.thinking.t0s0 = { rx: -1.75 };
+  acting.thinking.t0s1 = { rx: 0.95 };
+  acting.thinking.t0s2 = { rx: [1.0, 0.12, 1.6, 0] };
+  /* tentacle 5 sits front-left: it cups by the side of the head */
+  acting.listening.t5s0 = { rx: -1.6 };
+  acting.listening.t5s1 = { rx: -0.2 };
+  acting.listening.t5s2 = { rx: 0.7 };
+  return acting;
+}
+
+const bones: BoneSpec[] = [
+  { name: 'mantle', pivot: [0, 0.42, 0], drive: { rx: [['pitch', -0.6]], ry: [['yaw', 0.6]], rz: [['roll', 0.6]] } },
+];
+const parts: PartSpec[] = [];
+
+for (let i = 0; i < TENTACLES; i++) {
+  const a = ((i + 0.5) / TENTACLES) * Math.PI * 2;
+  for (let s = 0; s < 3; s++) {
+    const name = `t${i}s${s}`;
+    bones.push({
+      name,
+      parent: s === 0 ? 'mantle' : `t${i}s${s - 1}`,
+      pivot: s === 0 ? [0.26 * Math.sin(a), 0.02, 0.26 * Math.cos(a)] : [0, -SEGMENT, 0],
+      rest: s === 0 ? { rx: CURL[0], ry: a } : { rx: CURL[s] },
+      wave: { rx: [0.12 + s * 0.1, 0.32, i * 1.3 + s * 0.8], rz: [0.06 + s * 0.05, 0.21, i * 2.1 + s] },
+      jiggle: { axis: [0, -1, 0], length: SEGMENT, freq: 2.4 - s * 0.4, damping: 0.25, maxAngle: 0.8 },
+    });
+    parts.push({
+      bone: name,
+      shape: 'roundCone',
+      from: [0, 0, 0],
+      to: [0, -SEGMENT, 0],
+      r1: RADII[s],
+      r2: RADII[s + 1],
+      blend: s === 0 ? 0.1 : 0.04,
+      material: 'skin',
+    });
+  }
+}
+
+/** A floating octopus: a glossy mantle and six trailing tentacles. */
+export const inky: CharacterSpec = {
+  id: 'inky',
+  name: 'Inky',
+  tagline: 'Floats, with six tentacles that trail on spring chains',
+  accent: '#e04f7d',
+  frame: { target: 0.86, radius: 0.98 },
+  bound: { y: 0.64, radius: 1.0 },
+  motion: { float: 0.32, hop: 0.12, squash: 1.1, snap: 0.85, look: 0.8, talkSquash: 0.5 },
+  materials: {
+    skin: { color: '#f2647f', f0: 0.05, spec: 1.1, shininess: 90, rim: 0.8, sss: 0.35, sssColor: '#ffb0c4', gloss: 0.7 },
+  },
+  bones,
+  parts: [
+    { bone: 'mantle', shape: 'ellipsoid', at: [0, 0.38, -0.04], radii: [0.43, 0.45, 0.41], material: 'skin' },
+    { bone: 'mantle', shape: 'ellipsoid', at: [0, 0.04, 0], radii: [0.35, 0.15, 0.35], blend: 0.16, material: 'skin' },
+    ...parts,
+  ],
+  paints: [
+    ...([
+      [0.14, 0.78, 0.12, 0.07],
+      [-0.2, 0.72, 0.16, 0.055],
+      [0.33, 0.6, 0.12, 0.05],
+      [-0.04, 0.83, -0.05, 0.06],
+      [-0.36, 0.52, 0.1, 0.05],
+      [0.06, 0.62, 0.33, 0.045],
+      [0.338, 0.425, -0.291, 0.045],
+    ] as const).map(([x, y, z, r]) => ({
+      bone: 'mantle', on: ['skin'], kind: 'sphere' as const, at: [x, y, z] as [number, number, number], radius: r, color: '#d23f6c', soft: 0.2,
+    })),
+    { bone: 'mantle', on: ['skin'], kind: 'sphere', at: [-0.27, 0.18, 0.31], radius: 0.065, color: '#ff9db0', soft: 0.6, opacity: 0.7 },
+    { bone: 'mantle', on: ['skin'], kind: 'sphere', at: [0.27, 0.18, 0.31], radius: 0.065, color: '#ff9db0', soft: 0.6, opacity: 0.7 },
+  ],
+  eyes: {
+    kind: 'ball',
+    bone: 'mantle',
+    at: [[-0.16, 0.27, 0.3], [0.16, 0.27, 0.3]],
+    radius: 0.098,
+    iris: '#f2b33d',
+    irisSize: 0.66,
+    pupilSize: 0.3,
+    pupilAspect: 1.9,
+    lid: 'skin',
+  },
+  face: {
+    kind: 'mouth',
+    bone: 'mantle',
+    on: ['skin'],
+    at: [0, 0.13, 0.3],
+    width: 0.062,
+    color: '#5a1430',
+    tongue: '#ff8fa8',
+  },
+  anchors: {
+    top: { bone: 'mantle', at: [0.16, 0.86, 0.1] },
+    mouth: { bone: 'mantle', at: [0, 0.13, 0.33] },
+    ear: { bone: 'mantle', at: [-0.46, 0.4, 0] },
+    skirt: { bone: 'mantle', at: [0, 0.0, 0] },
+  },
+  acting: tentacleActing(),
+  fx: {
+    replace: ['syllable'],
+    /* it lives underwater: bubbles rise all the time, and it talks in bubbles */
+    ambient: [{ glyph: 'bubble', anchor: 'skirt', rate: 0.7, spread: 0.35, velocity: [0, 0.18, 0], jitter: 0.05, wobble: 0.06, life: [2.4, 3.2], size: [0.02, 0.045], color: '#8fcfff' }],
+    syllable: [{ glyph: 'bubble', anchor: 'mouth', rate: 2, offset: [0, 0, 0.04], velocity: [0.05, 0.2, 0.1], jitter: 0.1, wobble: 0.05, life: [1, 1.4], size: [0.014, 0.034], color: '#9ad7ff' }],
+  },
+};
+
+export default inky;

package/skill/examples/latte.ts

@@ -0,0 +1,73 @@
+import type { CharacterSpec } from 'wobnimo';
+
+/** A coffee cup with a foam-art heart and a curl of steam for hair. */
+export const latte: CharacterSpec = {
+  id: 'latte',
+  name: 'Latte',
+  tagline: 'A cheerful coffee cup with latte-art foam and a curl of steam for hair',
+  accent: '#b7794b',
+  frame: { target: 0.43, radius: 0.68 },
+  bound: { y: 0.41, radius: 0.57 },
+  motion: { hop: 0.1, squash: 0.7, snap: 1, talkSquash: 0.4 },
+  materials: {
+    cup: { color: '#f4efe6', f0: 0.06, spec: 1.6, shininess: 140, rim: 0.6, gloss: 0.85 },
+    band: { color: '#c9854f', f0: 0.05, spec: 1, shininess: 80, rim: 0.5, gloss: 0.6 },
+    coffee: { color: '#6b3f22', f0: 0.04, spec: 1.2, shininess: 90, rim: 0.3, gloss: 0.7 },
+    foam: { color: '#f2dcc0', f0: 0.03, spec: 0.4, shininess: 20, rim: 0.4, sss: 0.3, sssColor: '#fff3e2' },
+    steam: { color: '#ffffff', f0: 0.02, spec: 0.2, shininess: 10, rim: 1.4, sss: 0.7, sssColor: '#ffffff', emit: '#ffffff', emitStrength: 0.08 },
+    bead: { color: '#2a1a10', f0: 0.06, spec: 2.2, shininess: 400, rim: 0.2, gloss: 1 },
+  },
+  bones: [
+    { name: 'body', pivot: [0, -0.08, 0], drive: { rx: [['pitch', -0.3]], ry: [['yaw', 0.6]], rz: [['roll', 0.5]] }, wave: { rz: [0.02, 0.5, 0] } },
+    { name: 'handle', parent: 'body', pivot: [0.31, 0.36, 0], drive: { rz: [['flap', 0.4]] } },
+    /* the steam curls and sways like a tuft of hair */
+    { name: 'steam', parent: 'body', pivot: [0, 0.58, 0], wave: { rz: [0.12, 0.6, 0] }, jiggle: { axis: [0, 1, 0], length: 0.2, freq: 1.6, damping: 0.12, maxAngle: 0.6 } },
+  ],
+  parts: [
+    /* a straight-sided mug with a flat rim, hollowed at the top and filled with coffee and foam */
+    { bone: 'body', shape: 'cylinder', at: [0, 0.33, 0], radius: 0.3, half: 0.25, round: 0.05, material: 'cup' },
+    { bone: 'body', shape: 'cylinder', at: [0, 0.64, 0], radius: 0.25, half: 0.1, round: 0.02, op: 'sub', blend: 0.015, material: 'cup' },
+    { bone: 'body', shape: 'cylinder', at: [0, 0.55, 0], radius: 0.255, half: 0.012, round: 0.008, material: 'coffee' },
+    { bone: 'body', shape: 'ellipsoid', at: [0, 0.562, 0], radii: [0.2, 0.022, 0.2], material: 'foam' },
+    /* a cardboard sleeve low on the cup, leaving room for the face */
+    { bone: 'body', shape: 'cylinder', at: [0, 0.2, 0], radius: 0.305, half: 0.05, round: 0.012, material: 'band' },
+    /* a ring handle on the right */
+    { bone: 'handle', shape: 'frame', at: [0.07, -0.02, 0], half: [0.08, 0.1], corner: 0.08, width: 0.025, depth: 0.03, rot: [Math.PI / 2, 0, 0], material: 'cup' },
+    /* a curl of steam */
+    { bone: 'steam', shape: 'capsule', from: [0, 0, 0], to: [-0.05, 0.12, 0], radius: 0.045, material: 'steam' },
+    { bone: 'steam', shape: 'capsule', from: [-0.05, 0.12, 0], to: [0.03, 0.22, 0], radius: 0.035, blend: 0.04, material: 'steam' },
+    { bone: 'steam', shape: 'capsule', from: [0.03, 0.22, 0], to: [-0.01, 0.3, 0], radius: 0.022, blend: 0.03, material: 'steam' },
+  ],
+  paints: [
+    /* a latte-art heart in the foam */
+    { bone: 'body', on: ['foam'], kind: 'sphere', at: [-0.035, 0.584, 0.02], radius: 0.05, color: '#b98257', soft: 0.25 },
+    { bone: 'body', on: ['foam'], kind: 'sphere', at: [0.035, 0.584, 0.02], radius: 0.05, color: '#b98257', soft: 0.25 },
+    { bone: 'body', on: ['foam'], kind: 'sphere', at: [0, 0.584, 0.08], radius: 0.035, color: '#b98257', soft: 0.3 },
+    { bone: 'body', on: ['cup'], kind: 'sphere', at: [-0.19, 0.34, 0.24], radius: 0.05, color: '#ffa4a4', soft: 0.6, opacity: 0.7 },
+    { bone: 'body', on: ['cup'], kind: 'sphere', at: [0.19, 0.34, 0.24], radius: 0.05, color: '#ffa4a4', soft: 0.6, opacity: 0.7 },
+  ],
+  eyes: { kind: 'bead', bone: 'body', at: [[-0.1, 0.42, 0.3], [0.1, 0.42, 0.3]], radii: [0.032, 0.048, 0.02], material: 'bead' },
+  face: { kind: 'mouth', bone: 'body', on: ['cup'], at: [0, 0.33, 0.305], width: 0.05, color: '#4a2a18', tongue: '#ff8a8a' },
+  anchors: {
+    top: { bone: 'steam', at: [0, 0.34, 0] },
+    mouth: { bone: 'body', at: [0, 0.33, 0.32] },
+    ear: { bone: 'body', at: [-0.32, 0.45, 0] },
+    feet: { bone: 'root', at: [0, 0.02, 0.2] },
+  },
+  acting: {
+    thinking: { steam: { rz: 0.4 } },
+    listening: { steam: { rz: -0.3 } },
+    speaking: { handle: { rz: [0.1, 0.15, 1.4, 0] } },
+    sleeping: { steam: { rz: 0.9, rx: 0.3 } },
+    working: { steam: { ry: [0, 0, 0, 0, 6] } },
+    error: { steam: { rz: [0, 0.4, 9, 0] } },
+    surprised: { steam: { rx: -0.3 } },
+    celebrating: { steam: { ry: [0, 0, 0, 0, 12] } },
+    sad: { steam: { rz: 1.1, rx: 0.5 } },
+  },
+  fx: {
+    ambient: [{ glyph: 'puff', anchor: 'top', rate: 0.8, velocity: [0, 0.15, 0], jitter: 0.04, wobble: 0.06, life: [1.2, 1.6], size: [0.03, 0.07], color: '#ffffff' }],
+  },
+};
+
+export default latte;

package/skill/examples/microduck.ts

@@ -0,0 +1,222 @@
+import type { CharacterSpec, PaintSpec, PartSpec } from 'wobnimo';
+
+/* a quarter turn: servo axles and side plates are mostly turned by one */
+const R = Math.PI / 2;
+
+/**
+ * A little bipedal robot duck: a white helmet head with an orange bill and
+ * camera-lens eyes, a stack of servos for a neck, bracket legs and chunky
+ * orange boots. Everything moves on servos, so it snaps and holds.
+ */
+export const microduck: CharacterSpec = {
+  id: 'microduck',
+  name: 'Microduck',
+  tagline: 'A bipedal robot duck: servo neck, lens eyes, a bill that clacks when it talks, and boots it marches in',
+  accent: '#ff6a1f',
+  frame: { target: 0.57, radius: 0.8 },
+  bound: { y: 0.58, radius: 0.88 },
+  motion: { hop: 0.12, squash: 0.45, snap: 1.4, look: 0.9, snapLook: 1, talkSquash: 0.12 },
+  materials: {
+    /* injection-moulded plastic: satin, with a faint printed grain */
+    shell: {
+      color: '#f3f1ec', f0: 0.04, spec: 1.1, shininess: 70, rim: 0.55, gloss: 0.5, sss: 0.12, sssColor: '#ffffff',
+      surface: { kind: 'ripple', scale: 70, strength: 0.12, bone: 'head' },
+    },
+    bodyShell: {
+      color: '#f3f1ec', shadeOf: 'shell', f0: 0.04, spec: 1.1, shininess: 70, rim: 0.55, gloss: 0.5, sss: 0.12, sssColor: '#ffffff',
+      surface: { kind: 'ripple', scale: 70, strength: 0.12, bone: 'body' },
+    },
+    bill: { color: '#ff5f1f', f0: 0.05, spec: 1.3, shininess: 90, rim: 0.45, gloss: 0.65, sss: 0.2, sssColor: '#ffb27a' },
+    ring: { color: '#ff8410', f0: 0.05, spec: 1.3, shininess: 90, rim: 0.4, gloss: 0.65, sss: 0.15, sssColor: '#ffd08a' },
+    boot: { color: '#ff5a24', f0: 0.04, spec: 0.9, shininess: 50, rim: 0.4, gloss: 0.4, sss: 0.15, sssColor: '#ffb08a' },
+    sole: { color: '#ffb12e', f0: 0.04, spec: 0.7, shininess: 40, rim: 0.3, gloss: 0.3 },
+    /* anodised servo housings and brackets */
+    servo: { color: '#2a2d33', f0: 0.06, spec: 1.2, shininess: 80, rim: 0.5, gloss: 0.55, metal: 0.25 },
+    horn: { color: '#a3a9b1', f0: 0.3, spec: 1.6, shininess: 120, rim: 0.4, gloss: 0.7, metal: 0.8 },
+    /* glass camera lenses */
+    lens: { color: '#101318', f0: 0.12, spec: 2.6, shininess: 420, rim: 0.3, gloss: 1 },
+    mouth: { color: '#3b1510', f0: 0.04, spec: 0.5, shininess: 30, rim: 0 },
+    /* a status light on the chest that takes the state's colour */
+    led: { color: '#ffffff', f0: 0.05, spec: 1, shininess: 120, rim: 0, glows: true },
+  },
+  bones: [
+    /* it stands three-quarters on, like the photos of the real thing, so
+       one lens looks straight out and the long head reads in profile */
+    { name: 'hips', pivot: [0, 0, 0], rest: { ry: 0.55 } },
+    /* the legs hang from the hips, not the body, so the boots stay planted
+       when the body turns and rolls */
+    { name: 'legL', parent: 'hips', pivot: [-0.12, 0.36, 0] },
+    { name: 'shinL', parent: 'legL', pivot: [0, -0.15, 0] },
+    { name: 'legR', parent: 'hips', pivot: [0.12, 0.36, 0] },
+    { name: 'shinR', parent: 'legR', pivot: [0, -0.15, 0] },
+    { name: 'body', parent: 'hips', pivot: [0, 0.39, 0], drive: { ry: [['yaw', 0.2]], rz: [['roll', 0.4]] } },
+    /* a two-servo neck shares the nod and the turn with the head */
+    { name: 'neck0', parent: 'body', pivot: [0, 0.19, 0.04], drive: { rx: [['pitch', -0.15]], ry: [['yaw', 0.25]] } },
+    {
+      name: 'neck1', parent: 'neck0', pivot: [0, 0.09, 0], drive: { rx: [['pitch', -0.1]], ry: [['yaw', 0.2]] },
+      jiggle: { axis: [0, 1, 0], length: 0.2, freq: 3.4, damping: 0.35, maxAngle: 0.16 },
+    },
+    { name: 'head', parent: 'neck1', pivot: [0, 0.09, 0], drive: { rx: [['pitch', -0.35]], ry: [['yaw', 0.55]], rz: [['roll', 0.6]] } },
+    /* the lower bill hinges at the back and drops to talk */
+    { name: 'jaw', parent: 'head', pivot: [0, 0.063, -0.18], drive: { rx: [['talk', 0.24]] } },
+  ],
+  parts: [
+    /* ── head: a rounded hood over a bill of two flat plates ── */
+    { bone: 'head', shape: 'roundBox', at: [0, 0.245, 0.05], half: [0.2, 0.17, 0.3], round: 0.16, clip: { normal: [0, -1, 0], offset: 0.145 }, material: 'shell' },
+    /* the bill is two flat orange plates, like the real one: the top plate
+       is fixed under the hood and runs out past it, the lower one hinges
+       at the back and drops to talk. Behind them, a dark throat */
+    { bone: 'head', shape: 'roundBox', at: [0, 0.085, 0.1], half: [0.208, 0.022, 0.32], round: 0.016, material: 'bill' },
+    { bone: 'head', shape: 'roundBox', at: [0, 0.045, -0.06], half: [0.17, 0.035, 0.12], round: 0.02, material: 'mouth' },
+    { bone: 'jaw', shape: 'roundBox', at: [0, -0.017, 0.27], half: [0.192, 0.018, 0.285], round: 0.014, material: 'bill' },
+    /* lens eyes in orange rings on the flat sides of the hood, turned a little to the front */
+    { bone: 'head', shape: 'cylinder', at: [-0.205, 0.225, 0.15], rot: [R, -1.05, 0], radius: 0.08, half: 0.026, round: 0.016, material: 'ring' },
+    { bone: 'head', shape: 'cylinder', at: [0.205, 0.225, 0.15], rot: [R, 1.05, 0], radius: 0.08, half: 0.026, round: 0.016, material: 'ring' },
+    /* a dark sensor hole above and ahead of each eye */
+    { bone: 'head', shape: 'sphere', at: [-0.2, 0.31, 0.25], radius: 0.016, material: 'servo' },
+    { bone: 'head', shape: 'sphere', at: [0.2, 0.31, 0.25], radius: 0.016, material: 'servo' },
+    /* the bracket the neck bolts into */
+    { bone: 'head', shape: 'roundBox', at: [0, 0.01, 0], half: [0.07, 0.035, 0.07], round: 0.016, material: 'servo' },
+
+    /* ── neck: two stacked servos with silver horns ── */
+    { bone: 'neck0', shape: 'roundBox', at: [0, 0.045, 0], half: [0.048, 0.047, 0.042], round: 0.016, material: 'servo' },
+    { bone: 'neck0', shape: 'cylinder', at: [0, 0.02, 0], rot: [0, 0, R], radius: 0.026, half: 0.057, round: 0.01, material: 'horn' },
+    { bone: 'neck1', shape: 'roundBox', at: [0, 0.045, 0], half: [0.045, 0.047, 0.04], round: 0.016, material: 'servo' },
+    { bone: 'neck1', shape: 'cylinder', at: [0, 0.02, 0], rot: [0, 0, R], radius: 0.024, half: 0.053, round: 0.01, material: 'horn' },
+
+    /* ── body: a rounded box on a servo hip block ── */
+    { bone: 'body', shape: 'roundBox', at: [0, 0.1, -0.01], half: [0.19, 0.1, 0.15], round: 0.085, material: 'bodyShell' },
+    { bone: 'body', shape: 'capsule', from: [-0.03, 0.12, 0.14], to: [0.03, 0.12, 0.14], radius: 0.014, material: 'led' },
+    { bone: 'hips', shape: 'roundBox', at: [0, 0.37, 0], half: [0.15, 0.04, 0.09], round: 0.02, material: 'servo' },
+    { bone: 'hips', shape: 'cylinder', at: [-0.16, 0.36, 0], rot: [0, 0, R], radius: 0.045, half: 0.026, round: 0.012, material: 'horn' },
+    { bone: 'hips', shape: 'cylinder', at: [0.16, 0.36, 0], rot: [0, 0, R], radius: 0.045, half: 0.026, round: 0.012, material: 'horn' },
+
+    /* ── legs: brackets, knee servos with white guards, chunky boots ── */
+    ...([['legL', 'shinL', -1], ['legR', 'shinR', 1]] as const).flatMap(([leg, shin, s]): PartSpec[] => [
+      { bone: leg, shape: 'roundBox', at: [0, -0.075, 0], half: [0.038, 0.07, 0.042], round: 0.015, material: 'servo' },
+      { bone: leg, shape: 'cylinder', at: [0, -0.15, 0], rot: [0, 0, R], radius: 0.036, half: 0.05, round: 0.012, material: 'horn' },
+      { bone: leg, shape: 'plate', at: [s * 0.056, -0.1, -0.005], rot: [s * R, s * Math.PI / 4, R], half: [0.058, 0.058], corner: 0.034, depth: 0.012, material: 'bodyShell' },
+      { bone: shin, shape: 'roundBox', at: [0, -0.06, 0], half: [0.034, 0.055, 0.038], round: 0.014, material: 'servo' },
+      { bone: shin, shape: 'roundBox', at: [0, -0.135, 0.005], half: [0.048, 0.036, 0.052], round: 0.016, material: 'servo' },
+      { bone: shin, shape: 'roundBox', at: [0, -0.17, 0.045], half: [0.074, 0.04, 0.108], round: 0.038, material: 'boot' },
+      { bone: shin, shape: 'roundBox', at: [0, -0.196, 0.045], half: [0.079, 0.014, 0.113], round: 0.012, material: 'sole' },
+    ]),
+  ],
+  paints: [
+    /* little red rivets on the bill and vent dots on the boots */
+    ...[-1, 1].flatMap((s): PaintSpec[] => [
+      { bone: 'head', on: ['bill'], kind: 'sphere', at: [s * 0.208, 0.085, -0.13], radius: 0.013, color: '#c8261a', soft: 0.2 },
+      { bone: 'head', on: ['bill'], kind: 'sphere', at: [s * 0.208, 0.085, -0.18], radius: 0.013, color: '#c8261a', soft: 0.2 },
+    ]),
+    ...['shinL', 'shinR'].flatMap((bone) =>
+      [[-0.03, 0.1], [0.03, 0.1], [0, 0.13], [-0.03, 0.06], [0.03, 0.06]].map(([x, z]): PaintSpec => ({
+        bone, on: ['boot'], kind: 'sphere', at: [x, -0.13, z], radius: 0.011, color: '#c23a14', soft: 0.25,
+      })),
+    ),
+    /* screw heads at the corners of the body */
+    ...[-1, 1].map((s): PaintSpec => ({ bone: 'body', on: ['bodyShell'], kind: 'sphere', at: [s * 0.142, 0.04, 0.117], radius: 0.009, color: '#8d9198', soft: 0.2 })),
+  ],
+  /* the dark lens behind each ring: it narrows to blink */
+  eyes: {
+    kind: 'bead',
+    bone: 'head',
+    at: [[-0.228, 0.225, 0.165], [0.228, 0.225, 0.165]],
+    radii: [0.048, 0.048, 0.048],
+    material: 'lens',
+  },
+  anchors: {
+    top: { bone: 'head', at: [0.1, 0.42, 0.08] },
+    mouth: { bone: 'head', at: [0, 0.06, 0.45] },
+    ear: { bone: 'head', at: [-0.24, 0.2, 0.05] },
+    feet: { bone: 'root', at: [0, 0.02, 0.08] },
+    chest: { bone: 'body', at: [0, 0.12, 0.16] },
+    neck: { bone: 'neck0', at: [0.05, 0.08, 0.05] },
+  },
+  acting: {
+    /* weight shifting from boot to boot, the head bobbing on its servos */
+    idle: {
+      body: { rz: [0, 0.03, 0.45, 0] },
+      neck0: { rx: [0, 0.04, 0.9, 0] },
+    },
+    /* head cocked, bill ajar, one boot tapping */
+    thinking: {
+      head: { rz: 0.22, rx: -0.1 },
+      jaw: { rx: 0.06 },
+      legR: { rx: [-0.05, 0.05, 2.4, 0] },
+      shinR: { rx: [0.05, 0.05, 2.4, Math.PI] },
+    },
+    /* one lens turned to the sound */
+    listening: {
+      head: { rz: -0.24, ry: 0.2 },
+      neck0: { rx: 0.1 },
+    },
+    speaking: {
+      neck0: { rx: [0, 0.05, 1.6, 0] },
+      body: { rz: [0, 0.03, 0.8, 0] },
+    },
+    /* powered down: the neck folds and the head rests on its chest */
+    sleeping: {
+      neck0: { rx: 0.08 },
+      neck1: { rx: 0.05 },
+      head: { rz: 0.12 },
+      legL: { rx: -0.12 },
+      shinL: { rx: 0.24 },
+      legR: { rx: -0.12 },
+      shinR: { rx: 0.24 },
+    },
+    /* pecking at a keyboard */
+    working: {
+      neck0: { rx: [0.1, 0.06, 4.2, 0] },
+      neck1: { rx: [0.04, 0.04, 4.2, 0.6] },
+      jaw: { rx: [0.03, 0.03, 8.4, 0] },
+    },
+    /* a fault: knock-kneed, bill hanging, head twitching on a stuck servo */
+    error: {
+      head: { rz: [0.2, 0.06, 9, 0] },
+      jaw: { rx: 0.06 },
+      legL: { rz: 0.1 },
+      legR: { rz: -0.1 },
+      neck0: { rx: 0.12 },
+    },
+    /* the neck shoots up and the bill drops open */
+    surprised: {
+      neck0: { rx: -0.15 },
+      head: { rx: 0.05 },
+    },
+    /* marching in place, head bopping side to side */
+    celebrating: {
+      legL: { rx: [-0.25, 0.25, 2.4, 0] },
+      shinL: { rx: [0.25, 0.25, 2.4, Math.PI] },
+      legR: { rx: [-0.25, 0.25, 2.4, Math.PI] },
+      shinR: { rx: [0.25, 0.25, 2.4, 0] },
+      head: { rz: [0, 0.2, 1.2, 0] },
+    },
+    /* the neck sinks and the knees give a little */
+    sad: {
+      head: { rz: -0.1 },
+      legL: { rx: -0.08 },
+      shinL: { rx: 0.16 },
+      legR: { rx: -0.08 },
+      shinR: { rx: 0.16 },
+    },
+    /* a happy stomp and a clack of the bill */
+    happy: {
+      legL: { rx: [-0.2, 0.2, 4, 0] },
+      shinL: { rx: [0.2, 0.2, 4, Math.PI] },
+      legR: { rx: [-0.2, 0.2, 4, Math.PI] },
+      shinR: { rx: [0.2, 0.2, 4, 0] },
+      jaw: { rx: [0.08, 0.08, 8, 0] },
+    },
+  },
+  fx: {
+    /* a robot shorts out with sparks from its neck */
+    error: [
+      { glyph: 'spark', anchor: 'neck', rate: 5, spread: 0.03, velocity: [0.25, 0.3, 0.1], jitter: 0.8, gravity: 2, life: [0.2, 0.35], size: [0.03, 0.012], color: '#ffd166', glow: true, align: true },
+    ],
+    working: [
+      { glyph: 'dot', anchor: 'chest', rate: 1.6, offset: [0, 0.02, 0.02], spread: 0.03, velocity: [0, 0.1, 0.06], jitter: 0.02, life: [0.7, 0.9], size: [0.012, 0.004], color: '#ffb27a', glow: true },
+    ],
+  },
+};
+
+export default microduck;