@developerz.ai/ts23d 0.1.0 → 0.2.0

package/src/kinds/head-mouth.ts

@@ -0,0 +1,111 @@
+// Lips and mouth as edit lists, part of the skull field: upper and lower lip pads (the lower one
+// pushed forward by the underbite), then the opening — a thin scowl line when `grin` is low, or a
+// crescent cut (a wide smile, corners lifted) lined with small pointed teeth along the dental arch
+// when it is high. Head units, mirrored across Y.
+
+import type { SculptEdit } from '../primitives/index.ts';
+import { alongZ } from './head-geom.ts';
+import type { HeadLayout } from './head-layout.ts';
+import type { HeadParams } from './head-params.ts';
+
+export function mouthEdits(p: HeadParams, l: HeadLayout, teeth = true): SculptEdit[] {
+  const c = p.colors;
+  const lipT = p.mouth.lips;
+  const mw = p.mouth.width;
+  const g = p.mouth.grin;
+  const out: SculptEdit[] = [
+    {
+      shape: 'ellipsoid',
+      at: [l.mouthX - 0.01, 0, l.mouthZ + lipT * 0.7],
+      size: [0.032, mw, lipT],
+      color: c.lips,
+      blend: 0.03,
+    },
+    {
+      shape: 'ellipsoid',
+      at: [l.mouthX - 0.015 + p.jaw.underbite * 0.7, 0, l.mouthZ - lipT * 0.8],
+      size: [0.034 + p.jaw.underbite * 0.3, mw * 0.85, lipT * (1.1 + p.jaw.underbite * 4)],
+      color: c.lips,
+      blend: 0.03,
+    },
+  ];
+  // Far LODs carve a grin as a plain wide line: a crescent that thin folds over at coarse cells.
+  if (g < 0.4 || !teeth) {
+    out.push({
+      shape: 'capsule',
+      at: [l.mouthX + 0.05, 0, l.mouthZ],
+      to: [l.mouthX - 0.03 - 0.02 * g, mw * 0.98, l.mouthZ + 0.012 + g * 0.05 - p.brow.scowl * 0.4],
+      size: 0.006 + g * 0.022,
+      op: 'subtract',
+      blend: 0.012,
+      color: c.mouth,
+    });
+    return out;
+  }
+  // A grin: the part of a wide ellipsoid below a higher one — a crescent whose horns rise.
+  const h = 0.035 + g * 0.05;
+  const z0 = l.mouthZ + h * 0.45;
+  const back = mw * 0.55;
+  out.push({
+    group: [
+      { shape: 'ellipsoid', at: [l.mouthX - back, 0, z0], size: [back + 0.06, mw, h] },
+      {
+        shape: 'ellipsoid',
+        at: [l.mouthX - back + 0.02, 0, z0 + h * 0.7],
+        size: [back + 0.12, mw * 1.1, h * 0.9],
+        op: 'subtract',
+      },
+    ],
+    op: 'subtract',
+    blend: 0.012,
+    color: c.mouth,
+  });
+  // A tongue fills the floor of the open mouth (so no flat jaw cut shows through the grin).
+  if (teeth)
+    out.push({
+      shape: 'ellipsoid',
+      at: [l.mouthX - back * 0.9, 0, l.mouthZ - h * 0.4],
+      size: [back * 0.9, mw * 0.62, h * 0.45],
+      color: [0.42, 0.12, 0.12],
+      blend: 0.01,
+    });
+  // The grin bunches the cheeks up and out beside the mouth corners.
+  out.push({
+    shape: 'ellipsoid',
+    at: [l.mouthX - 0.06, mw * 0.95, z0 + h * 0.6],
+    size: [0.05, 0.045, 0.04 + g * 0.01],
+    rotate: [-30, 0, 0],
+    blend: 0.035,
+  });
+  // Teeth: pointed little cones along the arch — the upper row hangs, the lower row rises.
+  const n = teeth ? 3 : 0;
+  for (let i = 0; i < n; i++) {
+    const a = (0.25 + i) * 0.36;
+    const y = Math.sin(a) * mw * 0.82;
+    const x = l.mouthX - 0.03 - (1 - Math.cos(a)) * back * 1.3;
+    // Follow the crescent: roots just inside its upper and lower edges, corners higher.
+    const lo = z0 - h * Math.sqrt(Math.max(0, 1 - (y / mw) ** 2));
+    const hi = z0 + h * 0.7 - h * 0.9 * Math.sqrt(Math.max(0, 1 - (y / (mw * 1.1)) ** 2));
+    const len = 0.03 + g * 0.008 - i * 0.004;
+    const r = 0.014 + g * 0.004 - i * 0.0015;
+    out.push(
+      {
+        shape: 'cone',
+        at: [x, y, hi + 0.008],
+        size: [r, 0.003, len],
+        rotate: alongZ([0.15, 0, -1]),
+        color: c.teeth,
+        blend: 0.004,
+      },
+      {
+        shape: 'cone',
+        at: [x - 0.006, y * 0.97, lo - 0.008],
+        size: [r * 0.85, 0.003, len * 0.6],
+        rotate: alongZ([0.1, 0, 1]),
+        color: c.teeth,
+        blend: 0.004,
+      },
+    );
+  }
+  return out;
+}

package/src/kinds/head-params.ts

@@ -7,7 +7,7 @@ import { Ts23dError, type Vec3 } from '../core/index.ts';
 export type EarShape = 'round' | 'pointed';
 export type HairStyle = 'none' | 'topknot' | 'mohawk' | 'swept' | 'tufts' | 'braids';
 export type BeardStyle = 'none' | 'short' | 'braided' | 'goatee';
-export type BustStyle = 'pauldrons' | 'hood' | 'tunic';
+export type BustStyle = 'pauldrons' | 'hood' | 'tunic' | 'vest';
 
 export interface HeadColors {
   readonly skin: Vec3;
@@ -29,6 +29,10 @@ export interface HeadColors {
   readonly fur?: Vec3;
   /** War paint / tattoo stripes (orc), or none. */
   readonly paint?: Vec3;
+  /** The bust's plinth (stone/wood socle); default a dark slate. */
+  readonly plinth?: Vec3;
+  /** Scarf / sash cloth (vest style); default `cloth`. */
+  readonly scarf?: Vec3;
 }
 
 export interface HeadParams {
@@ -88,11 +92,14 @@ export interface HeadParams {
     readonly flare: number;
   } | null;
   readonly neck: { readonly radius: number };
-  readonly bust: { readonly shoulders: number; readonly style: BustStyle };
+  /** Shoulder half-span, gear style, muscle mass (0 = bony and narrow … 1 = brute; default 0.5). */
+  readonly bust: { readonly shoulders: number; readonly style: BustStyle; readonly mass?: number };
   readonly hair: HairStyle;
   readonly beard: BeardStyle;
   /** Wart / bump count scattered on the skin (seeded). */
   readonly warts: number;
+  /** Forehead creases (0 = smooth; a goblin's worried brow has 3). */
+  readonly wrinkles?: number;
   readonly colors: HeadColors;
 }
 
@@ -122,6 +129,8 @@ const ZERO_OK = new Set([
   'jaw.muzzle',
   'brow.overhang',
   'brow.hair',
+  'bust.mass',
+  'wrinkles',
 ]);
 
 /** Throws T3D_RECIPE_INVALID (with a fix) when `p` cannot make a head. */

package/src/kinds/head-presets.ts

@@ -43,33 +43,33 @@ export const human: HeadParams = {
 /** Massive underbitten jaw, tusks, heavy brow over small deep eyes, flat broad nose, thick neck. */
 export const orc: HeadParams = {
   height: 0.3,
-  cranium: { width: 0.7, depth: 0.8, height: 0.34 },
-  brow: { ridge: 0.065, overhang: 0.075, scowl: 0.035 },
-  cheeks: { size: 1.35, width: 1.15 },
-  jaw: { muzzle: 0.1, width: 0.37, chin: 1.6, underbite: 0.07, drop: 0.1 },
-  nose: { length: 0.15, width: 0.09, tip: 0.04, hook: -0.01, bridge: -0.045 },
-  ears: { shape: 'pointed', length: 0.3, width: 0.17, sweep: 25, lift: 8 },
-  eyes: { radius: 0.05, spacing: 0.155, line: 0.56, lid: 16, lowerLid: 26 },
-  mouth: { width: 0.17, lips: 0.03, grin: 0 },
-  tusks: { length: 0.27, radius: 0.05, spread: 0.14, flare: 0.35 },
-  neck: { radius: 0.32 },
-  bust: { shoulders: 1.05, style: 'pauldrons' },
+  cranium: { width: 0.7, depth: 0.74, height: 0.31 },
+  brow: { ridge: 0.075, overhang: 0.06, scowl: 0.04 },
+  cheeks: { size: 1.3, width: 1.15 },
+  jaw: { muzzle: 0.1, width: 0.4, chin: 1.3, underbite: 0.1, drop: 0.1 },
+  nose: { length: 0.15, width: 0.1, tip: 0.042, hook: -0.01, bridge: -0.05 },
+  ears: { shape: 'pointed', length: 0.38, width: 0.19, sweep: 30, lift: 10 },
+  eyes: { radius: 0.054, spacing: 0.155, line: 0.56, lid: 10, lowerLid: 22 },
+  mouth: { width: 0.17, lips: 0.034, grin: 0 },
+  tusks: { length: 0.22, radius: 0.055, spread: 0.15, flare: 0.35 },
+  neck: { radius: 0.38 },
+  bust: { shoulders: 1.0, style: 'pauldrons', mass: 1 },
   hair: 'topknot',
   beard: 'none',
   warts: 6,
   colors: {
-    skin: hex('#5f8b3a'),
-    shade: hex('#3c5c24'),
+    skin: hex('#5c8034'),
+    shade: hex('#33501e'),
     lips: hex('#4f6f30'),
     sclera: hex('#8a5a1a'),
     iris: hex('#ffb030'),
     pupil: hex('#140a06'),
     teeth: hex('#e2d6b0'),
     mouth: hex('#2a0e0c'),
-    hair: hex('#1c1714'),
+    hair: hex('#231a14'),
     cloth: hex('#6b2a20'),
     leather: hex('#5a3a22'),
-    metal: hex('#6e6a62'),
+    metal: hex('#55524d'),
     fur: hex('#5e4a34'),
     paint: hex('#8a1c12'),
   },
@@ -79,19 +79,20 @@ export const orc: HeadParams = {
 export const goblin: HeadParams = {
   height: 0.19,
   cranium: { width: 0.66, depth: 0.84, height: 0.5 },
-  brow: { ridge: 0.03, overhang: 0.015, scowl: 0.025 },
-  cheeks: { size: 1.15, width: 1.1 },
-  jaw: { muzzle: 0.06, width: 0.2, chin: 0.85, underbite: 0, drop: 0 },
-  nose: { length: 0.2, width: 0.07, tip: 0.05, hook: 0.07, bridge: 0.12 },
-  ears: { shape: 'pointed', length: 0.62, width: 0.3, sweep: 22, lift: 18 },
-  eyes: { radius: 0.072, spacing: 0.15, line: 0.5, lid: 16, lowerLid: 26 },
-  mouth: { width: 0.2, lips: 0.016, grin: 0.75 },
+  brow: { ridge: 0.032, overhang: 0.02, scowl: 0.03 },
+  cheeks: { size: 1.05, width: 1.05 },
+  jaw: { muzzle: 0.05, width: 0.19, chin: 0.72, underbite: 0, drop: 0 },
+  nose: { length: 0.2, width: 0.06, tip: 0.046, hook: 0.065, bridge: 0.13 },
+  ears: { shape: 'pointed', length: 0.66, width: 0.3, sweep: 24, lift: 6 },
+  eyes: { radius: 0.08, spacing: 0.155, line: 0.5, lid: 30, lowerLid: 20 },
+  mouth: { width: 0.21, lips: 0.014, grin: 0.8 },
   tusks: null,
-  neck: { radius: 0.2 },
-  bust: { shoulders: 0.75, style: 'hood' },
+  neck: { radius: 0.14 },
+  bust: { shoulders: 0.52, style: 'vest', mass: 0 },
   hair: 'tufts',
   beard: 'none',
   warts: 4,
+  wrinkles: 3,
   colors: {
     skin: hex('#9cb84a'),
     shade: hex('#6a8a2c'),
@@ -101,10 +102,12 @@ export const goblin: HeadParams = {
     pupil: hex('#120c04'),
     teeth: hex('#e8dcae'),
     mouth: hex('#3a1010'),
-    hair: hex('#3a3024'),
-    cloth: hex('#6a4a7a'),
-    leather: hex('#5a3a22'),
+    hair: hex('#c8c0b0'),
+    cloth: hex('#b8a47c'),
+    cape: hex('#4e5e3a'),
+    leather: hex('#6b4428'),
     metal: hex('#a88a4a'),
+    scarf: hex('#9a3a24'),
   },
 };
 

package/src/kinds/head-tone.ts

@@ -0,0 +1,52 @@
+// Hand-painted tone for sculpted head/bust vertex colour: the painter's three passes done from the
+// distance field itself — cavity (crevices, folds, sockets go darker and a touch more saturated),
+// a warm key from above (top planes lifted and warmed), and a cool bounce underneath. Pure field
+// sampling at the surface point, so it is deterministic and costs ~9 field evaluations per vertex.
+
+import type { Vec3 } from '../core/index.ts';
+import type { Field } from '../primitives/index.ts';
+
+export interface ToneOptions {
+  /** Probe distance for the cavity test, head units (≈ the size of a fold). */
+  readonly reach: number;
+  /** 0 = flat colour, 1 = full painted tone. */
+  readonly strength?: number;
+}
+
+/** Wraps `colorAt` with cavity darkening and a warm-top / cool-under gradient. */
+export function toned(field: Field, colorAt: (q: Vec3) => Vec3, o: ToneOptions): (q: Vec3) => Vec3 {
+  const k = o.strength ?? 1;
+  const d = o.reach;
+  const e = d * 0.25;
+  return (q) => {
+    const c = colorAt(q);
+    const [x, y, z] = q;
+    const gx = field([x + e, y, z]) - field([x - e, y, z]);
+    const gy = field([x, y + e, z]) - field([x, y - e, z]);
+    const gz = field([x, y, z + e]) - field([x, y, z - e]);
+    const gl = Math.hypot(gx, gy, gz) || 1;
+    const n: Vec3 = [gx / gl, gy / gl, gz / gl];
+    // Cavity: walk out along the normal; a crevice brings other surface closer than the walk.
+    let occ = 0;
+    for (let i = 1; i <= 3; i++) {
+      const t = (d * i) / 3;
+      occ += Math.max(0, t - field([x + n[0] * t, y + n[1] * t, z + n[2] * t])) / t / i;
+    }
+    const cav = Math.min(1, occ * 2.5) * k;
+    const up = n[2] * k;
+    const lift = up > 0 ? 1 + up * 0.22 : 1 + up * 0.3;
+    const warm: Vec3 =
+      up > 0 ? [1 + up * 0.12, 1 + up * 0.05, 1 - up * 0.15] : [1 + up * 0.1, 1, 1 - up * 0.12];
+    const dark = 1 - cav * 0.55;
+    const lum = (c[0] + c[1] + c[2]) / 3;
+    // Saturate into the crevice: push each channel away from the grey by the cavity.
+    const sat = 1 + cav * 0.35;
+    return [
+      clamp((lum + (c[0] - lum) * sat) * dark * lift * warm[0]),
+      clamp((lum + (c[1] - lum) * sat) * dark * lift * warm[1]),
+      clamp((lum + (c[2] - lum) * sat) * dark * lift * warm[2]),
+    ];
+  };
+}
+
+const clamp = (v: number): number => Math.min(Math.max(v, 0), 1);

package/src/kinds/head-torso.ts

@@ -0,0 +1,230 @@
+// The bust's anatomy, cut and plinth: ribcage, pectorals, deltoids, the trapezius sloping from
+// behind the ear to the shoulder (it is what joins a head to a body), clavicles and the sternal
+// notch — all scaled by `bust.mass` (0 bony … 1 brute) — trimmed by the classic collectible-bust
+// cut (a U under the chest rising to the arms) and set on a turned socle + disc plinth.
+// Head units, mirrored across Y; `torsoForms(f, g)` grows every form by g for clothing shells.
+
+import type { Vec3 } from '../core/index.ts';
+import { type Field, type SculptEdit, sd } from '../primitives/index.ts';
+import { alongX } from './head-geom.ts';
+import type { HeadLayout } from './head-layout.ts';
+import type { HeadParams } from './head-params.ts';
+
+/** Where the bust sits relative to the head: centre x, shoulder half-span, base, neck root… */
+export interface BustFrame {
+  readonly cx: number;
+  readonly s: number;
+  /** Reference z the torso is laid out from (the floor lifted by the build's hunch). */
+  readonly b: number;
+  /** The asset's floor: bottom of the plinth. */
+  readonly floor: number;
+  /** Neck root (top of the sternum), z. */
+  readonly nz: number;
+  readonly m: number;
+  /** Neck radius. */
+  readonly n: number;
+  /** Where the trapezius meets the neck, z (high behind the ear on a brute). */
+  readonly trapZ: number;
+  /** Top of the plinth = bottom of the chest cut, z. */
+  readonly cutZ: number;
+}
+
+const sub = (a: Vec3, b: Vec3): Vec3 => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const mid = (a: Vec3, b: Vec3): Vec3 => [(a[0] + b[0]) / 2, (a[1] + b[1]) / 2, (a[2] + b[2]) / 2];
+const dist = (a: Vec3, b: Vec3): number => Math.hypot(...sub(a, b));
+
+/** Plinth height, head units. */
+const PLINTH = 0.17;
+
+export function frameOf(p: HeadParams, l: HeadLayout): BustFrame {
+  const m = p.bust.mass ?? 0.5;
+  // A brute's shoulders ride up round its ears (the hunch): lift the torso, lengthen the socle.
+  const b = l.base + 0.06 + 0.1 * m;
+  const nz = b + 0.6;
+  return {
+    cx: l.cranium.at[0] + p.jaw.muzzle * 0.3,
+    s: p.bust.shoulders,
+    b,
+    floor: l.base,
+    nz,
+    m,
+    n: p.neck.radius,
+    trapZ: nz + 0.12 + (l.hinge[1] - 0.2 - nz - 0.12) * m,
+    cutZ: l.base + PLINTH + 0.06 + 0.1 * m,
+  };
+}
+
+/** Anatomy volumes (plain adds), every one grown by `g`. */
+export function torsoForms(f: BustFrame, g = 0): SculptEdit[] {
+  const { cx, s, b, m, n } = f;
+  const grow = (r: Vec3): Vec3 => [r[0] + g, r[1] + g, r[2] + g];
+  const top: Vec3 = [cx - 0.12, n * 0.5, f.trapZ];
+  const acromion: Vec3 = [cx - 0.05, s * 0.78, b + 0.62 + 0.05 * m];
+  return [
+    // Ribcage: the barrel everything hangs on.
+    {
+      shape: 'ellipsoid',
+      at: [cx - 0.05, 0, b + 0.36],
+      size: grow([0.25 + 0.07 * m, s * 0.66, 0.38]),
+    },
+    // Pectorals: two slabs angled up to the shoulder; their lower edge is the chest's shadow line.
+    {
+      shape: 'ellipsoid',
+      at: [cx + 0.1 + 0.05 * m, s * 0.27, b + 0.46 + 0.02 * m],
+      size: grow([0.09 + 0.06 * m, s * 0.27, 0.11 + 0.03 * m]),
+      rotate: [-12, 0, 16],
+      blend: 0.05,
+    },
+    // Deltoids: a cap over each shoulder joint.
+    {
+      shape: 'ellipsoid',
+      at: [cx - 0.03, s * 0.8, b + 0.5 + 0.03 * m],
+      size: grow([0.13 + 0.06 * m, 0.11 + 0.05 * m, 0.16 + 0.05 * m]),
+      rotate: [-18, 0, 0],
+      blend: 0.08,
+    },
+    // Trapezius: a broad flat sheet from the neck behind the ear down to the acromion — the slope
+    // of a brute (local X along the slope, Y front-back, Z its thickness).
+    {
+      shape: 'ellipsoid',
+      at: mid(top, acromion),
+      size: [dist(top, acromion) / 2 + 0.08 + g, 0.11 + 0.12 * m + g, 0.05 + 0.1 * m + g],
+      rotate: alongX(sub(acromion, top)),
+      blend: 0.08 + 0.08 * m,
+    },
+    // Upper arm: a stump the bust cut ends, filling the shoulder under any pauldron.
+    {
+      shape: 'capsule',
+      at: [cx - 0.04, s * 0.8, b + 0.55],
+      to: [cx - 0.02, s * 0.9, b + 0.05],
+      size: 0.12 + 0.05 * m + g,
+      blend: 0.06,
+    },
+    // Clavicles: a bony ridge from the sternal notch out to the shoulder (clothes drape over it).
+    {
+      shape: 'capsule',
+      at: [cx + 0.2 + 0.04 * m, 0.045, f.nz - 0.03],
+      to: [cx + 0.0, s * 0.68, b + 0.6 + 0.04 * m],
+      size: 0.02 + 0.006 * (1 - m) + g,
+      blend: 0.035,
+    },
+    // Latissimus: widens the back under the armpit (a V-taper on a brute).
+    {
+      shape: 'ellipsoid',
+      at: [cx - 0.1, s * 0.55, b + 0.3],
+      size: grow([0.17 + 0.05 * m, 0.12 + 0.1 * m, 0.2]),
+      blend: 0.08,
+    },
+    // Upper back: the hump of trapezius and rhomboids behind the neck.
+    {
+      shape: 'ellipsoid',
+      at: [cx - 0.18, 0, f.nz + 0.04 + 0.08 * m],
+      size: grow([0.12 + 0.06 * m, s * 0.32, 0.16 + 0.12 * m]),
+      blend: 0.1,
+    },
+  ];
+}
+
+/** Signed distance to the bust-cut region (negative inside): ≈ 0 on the cut faces. */
+export function cutField(f: BustFrame): Field {
+  const rz = 0.64;
+  const ry = f.s * 1.08;
+  const cz = f.cutZ + rz;
+  const e = sd.ellipsoid([f.cx, 0, cz], [1.6, ry, rz]);
+  const box = sd.box([f.cx, 0, cz + 1], [3.2, ry * 2, 2]);
+  return (q) => Math.min(e(q), box(q));
+}
+
+/** Keeps a group to the bust silhouette: the U-cut under the chest, rising to cut the arms. */
+export function bustCut(f: BustFrame, g = 0): SculptEdit {
+  const rz = 0.64;
+  const ry = f.s * 1.08 + g;
+  // (cutField mirrors these numbers.)
+  const cz = f.cutZ + rz - g;
+  return {
+    group: [
+      { shape: 'ellipsoid', at: [f.cx, 0, cz], size: [1.6, ry, rz] },
+      { shape: 'roundBox', at: [f.cx, 0, cz + 1], size: [3.2, ry * 2, 2] },
+    ],
+    op: 'intersect',
+    blend: 0.012,
+  };
+}
+
+/** The bare body: anatomy in `color`, sternal notch and groove, then the bust cut. */
+export function bodyEdits(p: HeadParams, f: BustFrame, color: Vec3): SculptEdit[] {
+  const { cx, b, m, nz } = f;
+  const shade = p.colors.shade;
+  return [
+    {
+      group: [
+        ...torsoForms(f),
+        {
+          shape: 'sphere',
+          at: [cx + 0.24 + 0.04 * m, 0, nz - 0.04],
+          size: 0.035,
+          op: 'subtract',
+          blend: 0.04,
+          color: shade,
+        },
+        {
+          shape: 'capsule',
+          at: [cx + 0.26 + 0.06 * m, 0, b + 0.5],
+          to: [cx + 0.26 + 0.05 * m, 0, b + 0.22],
+          size: 0.01 + 0.006 * m,
+          op: 'subtract',
+          blend: 0.04,
+          color: shade,
+        },
+        bustCut(f),
+      ],
+      color,
+    },
+  ];
+}
+
+/** Solid cylinder about Z from z0 to z1 (a capsule cut by a slab). */
+const cylinder = (at: Vec3, r: number, z0: number, z1: number): SculptEdit => ({
+  group: [
+    { shape: 'capsule', at: [at[0], at[1], z0 - r], to: [at[0], at[1], z1 + r], size: r },
+    {
+      shape: 'roundBox',
+      at: [at[0], at[1], (z0 + z1) / 2],
+      size: [4, 4, z1 - z0],
+      op: 'intersect',
+    },
+  ],
+});
+
+/** A turned plinth: wide disc with a bead moulding, then a narrower socle up to the chest cut.
+ *  Both start below the floor, so the bust's flat base cut alone makes the underside. */
+/** `minT`: floor for the disc's thickness (≈ a cell), so far LODs keep the bust on the ground. */
+export function plinthEdits(p: HeadParams, f: BustFrame, minT = 0): SculptEdit[] {
+  const c = p.colors.plinth ?? ([0.16, 0.15, 0.15] as Vec3);
+  const light: Vec3 = [c[0] * 1.35, c[1] * 1.35, c[2] * 1.35];
+  const x = f.cx - 0.04;
+  const R = 0.3 + 0.08 * f.s;
+  // Coarse cells would lose a thin disc: one solid drum from the floor to the chest cut instead.
+  if (minT > 0.07)
+    return [
+      { ...cylinder([x, 0, 0], R * 1.05, f.floor - 0.1, f.cutZ + 0.02), color: c, mirror: false },
+    ];
+  const disc = f.floor + 0.07;
+  return [
+    { ...cylinder([x, 0, 0], R, f.floor - 0.1, disc), color: c, mirror: false },
+    {
+      shape: 'torus',
+      at: [x, 0, disc],
+      size: [R - 0.03, 0.025],
+      color: light,
+      blend: 0.01,
+      mirror: false,
+    },
+    {
+      ...cylinder([x, 0, 0], R * 0.62, disc, f.cutZ + 0.02),
+      color: c,
+      blend: 0.02,
+      mirror: false,
+    },
+  ];
+}

package/src/kinds/head.ts

@@ -26,6 +26,7 @@ import { type HeadLayout, headLayout } from './head-layout.ts';
 import { bustMesh, eyeMesh, type HeadEditSet, headAndJaw } from './head-mesh.ts';
 import { checkHead, type HeadParams } from './head-params.ts';
 import { HEADS, type HeadPreset } from './head-presets.ts';
+import { cutField, frameOf } from './head-torso.ts';
 
 /** Overrides: top-level keys replace, nested objects merge one level (`{ jaw: { underbite: 0.1 } }`). */
 export type HeadOverrides = { readonly [K in keyof HeadParams]?: Partial<HeadParams[K]> };
@@ -78,6 +79,9 @@ function seatEyes(p: HeadParams, l: HeadLayout): HeadLayout {
   return { ...l, eye: [x - r * 0.7 - p.brow.overhang * 0.3, ey, ez] };
 }
 
+/** The bust's cell as a multiple of the head's (the bust carries less detail). */
+const BUST_CELL = 1.6;
+
 /** Sculpt cell edge per LOD, in head units (× height = metres). */
 export const HEAD_RES = [0.02, 0.045, 0.14] as const;
 
@@ -94,7 +98,7 @@ export function headEdits(
   return {
     layout: l,
     skull: [
-      ...skullEdits(p, l),
+      ...skullEdits(p, l, res),
       ...hair,
       ...browEdits(p, l),
       ...beardEdits(p, l),
@@ -103,7 +107,8 @@ export function headEdits(
     ],
     ears: earEdits(p, l, res * 0.7),
     tusks: tuskEdits(p, l, res * 0.45),
-    bust: bustEdits(p, l),
+    bust: bustEdits(p, l, res * BUST_CELL),
+    bustCut: cutField(frameOf(p, l)),
   };
 }
 
@@ -114,7 +119,7 @@ export function head(ctx: BuildContext, o: HeadOptions = {}): HeadInfo {
   const H = p.height;
   const res = HEAD_RES[ctx.lod];
   const { head: hm, jaw: jm } = headAndJaw(p, l, set, res);
-  const bm = bustMesh(p, set, res * 1.6);
+  const bm = bustMesh(p, set, res * BUST_CELL);
   const eye = eyeMesh(p, l.eyeR, l.eyeR / ctx.pick([7, 3.5, 2.2]));
   const [ox, oy, oz] = o.at ?? [0, 0, 0];
   const toWorld = (m: Mesh, at: Vec3 = [0, 0, 0]): Mesh =>

package/src/material/cc0.ts

@@ -0,0 +1,41 @@
+// Ready-made CC0 image materials (opt-in, never registered by default, so the repo paints offline).
+// Register with `defineMaterial(CC0_WOOD_PLANKS_GREY)`, fetch once with `bun run textures`, then
+// `provideTextures(await loadTextureCache())` before painting. Hashes pin the exact bytes.
+
+import type { MaterialDef } from './material-def.ts';
+
+const PH = 'https://dl.polyhaven.org/file/ph-assets/Textures/png/1k/wood_planks_grey';
+
+/** Poly Haven "Wood Planks Grey" by Rob Tuytel (CC0), 1.5 m square, 1k PNG maps. */
+export const CC0_WOOD_PLANKS_GREY: MaterialDef = {
+  id: 'ph_wood_planks_grey',
+  kind: 'flat',
+  scaleMetres: 0.6,
+  roughness: 0.85,
+  description: 'Photo-scanned weathered grey planks (Poly Haven, CC0).',
+  sources: ['https://polyhaven.com/a/wood_planks_grey'],
+  texture: {
+    source: 'polyhaven',
+    id: 'wood_planks_grey',
+    license: 'CC0-1.0',
+    page: 'https://polyhaven.com/a/wood_planks_grey',
+    author: 'Rob Tuytel',
+    metres: [1.5, 1.5],
+    maps: {
+      albedo: {
+        url: `${PH}/wood_planks_grey_diff_1k.png`,
+        sha256: '3e6aeb842edd813759fdc96a6ffe6b695c888280f42501de589442311749ac5d',
+      },
+      normal: {
+        url: `${PH}/wood_planks_grey_nor_gl_1k.png`,
+        sha256: 'a9f2ad602eca2d59e84f203b1087e819e62ae517532bb25f7eb02a13c826e08b',
+      },
+      arm: {
+        url: `${PH}/wood_planks_grey_arm_1k.png`,
+        sha256: '9b81e9a0b4f9db0a920c4c2ce8ff13e0411b3624d4de455acdabe41e3fafe20e',
+      },
+    },
+  },
+};
+
+export const CC0_MATERIALS: readonly MaterialDef[] = [CC0_WOOD_PLANKS_GREY];