@bitefoundry/retrieviewer 0.0.3 → 0.0.4

package/vendor/procedural-animals/src/species/goat/index.js

@@ -1,149 +0,0 @@
-// Domestic goat (Capra hircus). Cloven-hoofed browser: the horse's hoof rig (pastern + hoof bone)
-// with two claws per foot, scimitar horns (a rigid keratin surface on the skull), beard and wattles,
-// horizontal bar pupils in pale amber irises, the short tail carried up, cud chewing, browsing on the
-// hind legs and the rearing head clash.
-import { goatRig, goatJoints, HEAD_O } from './rig.js';
-import { add, sub, mul } from '../../core/math/vec.js';
-import { sculptGoat, EYE } from './sculpt.js';
-import { goatRegions } from './regions.js';
-import { goatCoat } from './coat.js';
-import { srgb } from '../../core/build/coatKit.js';
-import { rng } from '../../core/math/vec.js';
-import { motion } from './motion.js';
-import { QUALITY } from '../../core/build/pipeline.js';
-
-// a kid's short neck: the head and the upper neck move down the neck by 20 % of its length (12 % for lop ears: further,
-// the hanging ear's tip ran into the throat), shortening the neck above its lowest 15 % (from the neck base the shift
-// reached the scapulae, and the Nubian kid's sprint jittered at the wrist, p99 0.084 % S)
-const J0 = goatJoints();
-const NECK_BASE = add(J0.neckBase, mul(sub(J0.occiput, J0.neckBase), 0.15));
-const kidNeck = (lop) => mul(sub(J0.occiput, J0.neckBase), lop ? -0.12 : -0.2);
-
-const pick = (R, table) => {
-  let x = R() * table.reduce((s, [, w]) => s + w, 0);
-  for (const [k, w] of table) { x -= w; if (x <= 0) return k; }
-  return table[table.length - 1][0];
-};
-
-// Breeds (variants) and their coats (coat.js COATS). salt: the breed's own seed stream, so a seed gives
-// a different animal in every breed (with one stream, seed N was the same individual in five coats and
-// seeds 1-2 were kids in every breed); picked so that seed 1 is a horned adult doe (the reference
-// individual, the tools' default) and seeds 2-4 hold a horned buck, a kid and a doe
-const BREEDS = {
-  saanen: { salt: 158, coats: [['saanen', 1]], polled: 0.4, ear: 'erect', roman: 0, legs: 1, girth: 1, horn: 0xb4a07c },
-  alpine: { salt: 746, coats: [['chamoisee', 40], ['coublanc', 25], ['toggenburg', 20], ['britishalpine', 15]], polled: 0.35, ear: 'erect', roman: 0, legs: 1.0, girth: 0.98, horn: 0x8a7050 },
-  pied: { salt: 208, coats: [['pied', 60], ['piedbrown', 40]], polled: 0.3, ear: 'erect', roman: 0.15, legs: 0.98, girth: 1.02, horn: 0x9e8058 },
-  nubian: { salt: 398, coats: [['nubianred', 40], ['nubiantan', 35], ['nubianblack', 25]], polled: 0.5, ear: 'lop', roman: 1, legs: 1.06, girth: 0.97, horn: 0x7a6248 },
-  boer: { salt: 165, coats: [['boer', 1]], polled: 0.05, ear: 'lop', roman: 0.7, legs: 0.9, girth: 1.1, horn: 0x5e4c3a },
-};
-
-export default {
-  id: 'goat',
-  name: 'Goat',
-  latin: 'Capra hircus',
-  group: 'hooves',
-  plan: 'quadruped',
-  covering: 'fur',
-  variants: Object.keys(BREEDS),
-
-  // Seeded individual. Breed (o.variant: saanen, alpine, pied, nubian, boer) sets coat colours, ears,
-  // Roman nose and build; sex: doe (udder) or buck (heavier, broader, a mane and "pants", big horns,
-  // long beard); age: adult or kid (juvenile: long legs, short body, big head, horn buds, fluffy
-  // coat). Horns (scimitar, larger in bucks) or polled; beard (bucks, many does); wattles (some).
-  variation(R0, o) {
-    // (a re-mixed stream: the early draws of neighbouring seeds were correlated, e.g. 16 of seeds 1-20
-    // came out polled)
-    const salt = BREEDS[o.variant] ? BREEDS[o.variant].salt : 0;
-    const R = rng(Math.floor(R0() * 4294967296) ^ Math.imul(o.seed ?? 1, 0x9e3779b1) ^ 0x2545f491 ^ Math.imul(salt, 0x85ebca6b));
-    const variant = BREEDS[o.variant] ? o.variant : pick(R, [['saanen', 30], ['alpine', 30], ['pied', 20], ['nubian', 15], ['boer', 5]]);
-    const Bd = BREEDS[variant];
-    const sex = o.sex || (R() < 0.45 ? 'male' : 'female');
-    const age = o.age || (R() < 0.15 ? 'juvenile' : 'adult');
-    const kid = age === 'juvenile';
-    const buck = sex === 'male' && !kid;
-    const g = () => (R() + R() + R() - 1.5) / 1.5; // ~[-1, 1], peaked
-    const coat = pick(R, Bd.coats);
-    const polled = R() < Bd.polled;
-    let horns = null;
-    if (!polled) {
-      if (kid) horns = { len: 0.02 + 0.01 * R(), base: 0.008, curve: 0.2, spread: 0.12, upright: 0.3 };
-      else if (buck) horns = { len: 0.3 + 0.18 * R(), base: 0.024 + 0.006 * R(), curve: 1.6 + 0.5 * R(), spread: 0.18 + 0.16 * R(), upright: 0.1 * R() };
-      else horns = { len: 0.14 + 0.1 * R(), base: 0.0125 + 0.0035 * R(), curve: 0.9 + 0.45 * R(), spread: 0.08 + 0.1 * R(), upright: 0.2 * R() };
-    }
-    const beardP = variant === 'nubian' || variant === 'boer' ? 0.3 : 0.65;
-    const beard = kid ? 0 : buck ? 0.12 + 0.1 * R() : R() < beardP ? 0.05 + 0.07 * R() : 0;
-    const size = (buck ? 1.12 : 1) * (1 + 0.045 * g()) * (variant === 'nubian' ? 1.04 : 1) * (kid ? 0.58 : 1);
-    return {
-      sex, age, size, variant, coat,
-      horns, beard,
-      wattles: R() < 0.3,
-      earLift: R(),
-      ear: Bd.ear,
-      // (a kid's face is straight: the Roman arch grows in with age, and on a kid's short face it swelled)
-      roman: Bd.roman * (0.75 + 0.25 * R()) * (kid ? 0.35 : 1),
-      udder: sex === 'female' && !kid ? 0.2 + 0.8 * R() : 0,
-      heavy: buck ? 0.7 + 0.3 * R() : 0,
-      mane: buck ? 0.4 + 0.6 * R() : 0,
-      // (the long-haired landrace roll only: every buck had a 0.25 share of its skirt, which made every buck's barrel
-      // a sheep's fleece; a dairy buck's body coat is as short and sleek as a doe's)
-      shaggy: (variant === 'alpine' && R() < 0.25 ? 0.4 : 0),
-      hornColor: Bd.horn,
-      coatShade: g(), coatLightness: 0.05 * g(),
-      coatSeed: Math.floor(R() * 1e6),
-      // (the quality tier's mesh scale: the horns' cells, their least thickness and their sculpted growth ridges follow it)
-      tierRes: (QUALITY[o.quality] || QUALITY.high).res,
-      minThick: 0.005, // (thin parts at the coarse tiers: at 8 mm the erect ear's floor under its cup showed pinholes at medium)
-      warps: [
-        // a kid's neck is short (kid_side, front2: the head carried forward at about the height of the withers; with
-        // the adult's neck its upright neck and high head read as a llama)
-        ...(kid ? [{ type: 'shift', a: NECK_BASE, b: J0.occiput, d: kidNeck(Bd.ear === 'lop') }] : []),
-        // (the head scale next: its centre is the head origin, where the shift has moved it)
-        { type: 'scaleAbout', c: kid ? add(HEAD_O, kidNeck(Bd.ear === 'lop')) : HEAD_O, k: (1 + 0.035 * g()) * (kid ? 1.18 : 1) * (buck ? 1.06 : 1), r0: 0.1, r1: 0.2 },
-        { type: 'legs', k: (1 + 0.035 * g()) * Bd.legs * (kid ? 1.18 : 1), top: 0.46 },
-        { type: 'length', k: (1 + 0.035 * g()) * (kid ? 0.84 : 1), z0: -0.32, z1: 0.32 },
-        { type: 'girth', k: (1 + 0.04 * g()) * Bd.girth * (buck ? 1.06 : 1) * (kid ? 0.92 : 1), cy: 0.56, z0: -0.4, z1: 0.38 },
-      ],
-    };
-  },
-  rig: (params) => goatRig(params),
-  sculpt: (m, rig, params) => sculptGoat(m, rig, params),
-  regions: goatRegions,
-  coat: goatCoat,
-  eyeSpecs: (params) => [1, -1].map((side) => ({ side, spec: EYE, headOrigin: HEAD_O, bone: 'head', look: eyeLook(params) })),
-  motion,
-  // (marks are the lash lines: soft brown-grey on pink-skinned white coats, dark otherwise)
-  // (clumpDensity is the density of the tufts, not the clumping strength: lower means bigger tufts. At 0.6
-  // the 9-11 mm coat broke into 6-14 mm tufts that read as astrakhan curls, and a buck's back at 0.45 as a
-  // pebbled rug; side2 / side3 / walk1 show a sleek coat of fine lengthwise hair. finWidth 0.4 gave the
-  // outline a regular zipper hem at hero)
-  // (a buck's sleek body takes the does' fine tufts, 1.5: his long mane clumps through its length anyway; 1.1 on every
-  // buck read as a fleece)
-  render: (params) => ({ markColor: srgb(pinkSkinned(params) ? 0x4a3934 : 0x241f1d), strandDensity: 1400, clumpDensity: longHair(params) ? 1.1 : params.sex === 'male' && params.age !== 'juvenile' ? 1.5 : 1.6, shellScale: 0.9, finWidth: 0.3, matBorders: true }),
-};
-
-// The goat's signature eye: a strongly elongated horizontal bar pupil in a pale golden / amber iris
-//, sclera hidden, dark lids. Some lines have blue-grey irises.
-// (mid / hi lightened ~15 %: under the cornea they rendered darker than their hex, a dark bead)
-const IRISES = [
-  { inner: 0xb88f30, mid: 0xdcb24a, hi: 0xf0d284, outer: 0x6a4a18 }, // golden
-  { inner: 0xa87f3c, mid: 0xe8d28a, hi: 0xf6e8b0, outer: 0x7a6030 }, // pale yellow
-  { inner: 0x74501e, mid: 0xb08238, hi: 0xd49e52, outer: 0x3e2810 }, // brown-amber
-  { inner: 0x5e7280, mid: 0xa2bccb, hi: 0xc8dae2, outer: 0x3a4650 }, // blue
-];
-// shaggy (long-haired landrace) goats: long coarse hair lies in bigger locks (small tight tufts read as a lamb's wool)
-const longHair = (params) => (params.shaggy || 0) > 0.3;
-// white-coated goats (and the white areas of pied / Boer coats) have pink skin: nose, lips, lids
-const pinkSkinned = (params) => ['saanen', 'pied', 'piedbrown'].includes(params.coat);
-function eyeLook(params) {
-  const s = ((params.coatSeed || 0) % 100) / 100;
-  const ir = IRISES[s < 0.45 ? 0 : s < 0.75 ? 1 : s < 0.96 ? 2 : 3];
-  return {
-    pupil: 'bar',
-    lids: 'mammal',
-    iris: { inner: srgb(ir.inner), mid: srgb(ir.mid), hi: srgb(ir.hi), outer: srgb(ir.outer) },
-    sclera: { color: [0.55, 0.5, 0.45], visible: false },
-    // (pink-grey lids on white goats: side2, face3; dark on the others)
-    lidColor: pinkSkinned(params) ? srgb(0x8a6a62) : [0.03, 0.025, 0.022],
-    pupilSize: [0.09, 0.32],
-  };
-}

package/vendor/procedural-animals/src/species/goat/motion.js

@@ -1,95 +0,0 @@
-// Goat motion data for the quadruped engine (schema: src/core/motion/quadruped.js).
-// Numbers are for the reference individual (params.size = 1, a 0.78 m Saanen doe); the engine
-// scales them by dynamic similarity for kids, pygmies and big bucks.
-//
-// Gaits: lateral-sequence 4-beat walk (duty 0.72 -> 0.62), 2-beat
-// diagonal trot (hind lands ~2 % before its diagonal fore, duty 0.45 -> 0.36) and the transverse
-// gallop (LH, RH, LF, RF). Crossovers sit at the predicted transitions: walk -> trot at Froude
-// ~0.45 (1.85 m/s for a 0.78 m goat), trot -> gallop 4.2 m/s at ~2.5 Hz (Heglund et al. 1974:
-// v = 1.535 M^0.24, f = 4.48 M^-0.14 for 65 kg).
-import { hooks } from './behaviour.js';
-
-const G = (name, v, f, D, off, o) => ({ name, v, f, D, off, ...o });
-
-export const motion = {
-  maxSpeed: 8.5,
-  accel: [3.5, 7],
-  decel: 7,
-  turnRate: 1.7, // agile: pivots on the hind legs
-  latAccelMax: 4.5,
-  gears: { walk: 1.0, trot: 2.7, gallop: 5.6 },
-  gallopBlend: [3.8, 6.5],
-  //    name      v     f     D     [FL,   FR,   HL,  HR]
-  gaits: [
-    G('walk', 0.0, 0.85, 0.72, [0.25, 0.75, 0.0, 0.5], { liftF: 0.045, liftH: 0.04, bobF: 0.012, bobH: 0.012, flex: 0, lat: 0.02, fold: 0.7, heel: 30, tail: 0, drop: 0 }),
-    G('walk', 1.5, 1.35, 0.62, [0.25, 0.75, 0.0, 0.5], { liftF: 0.055, liftH: 0.048, bobF: 0.025, bobH: 0.025, flex: 0, lat: 0.025, fold: 0.85, heel: 40, tail: 0.1, drop: 0 }),
-    G('trot', 2.2, 2.05, 0.45, [0.52, 0.02, 0.0, 0.5], { liftF: 0.08, liftH: 0.065, bobF: 0.028, bobH: 0.028, flex: 0.01, lat: 0.0, fold: 1.05, heel: 50, tail: 0.3, drop: 0.006 }),
-    G('trot', 3.4, 2.4, 0.37, [0.52, 0.02, 0.0, 0.5], { liftF: 0.095, liftH: 0.08, bobF: 0.032, bobH: 0.032, flex: 0.015, lat: 0.0, fold: 1.15, heel: 55, tail: 0.4, drop: 0.01 }),
-    G('gallop', 4.8, 2.7, 0.3, [0.55, 0.65, 0.0, 0.1], { liftF: 0.11, liftH: 0.1, bobF: 0.022, bobH: 0.03, flex: 0.1, lat: 0, fold: 1.15, heel: 45, tail: 0.7, drop: 0.02 }),
-    G('gallop', 8.5, 3.0, 0.23, [0.56, 0.66, 0.0, 0.1], { liftF: 0.13, liftH: 0.12, bobF: 0.024, bobH: 0.034, flex: 0.14, lat: 0, fold: 1.4, heel: 40, tail: 1.0, drop: 0.035 }),
-  ],
-  feet: {
-    // cloven hooves: the fetlock sinks a little under load, the digit flips in swing, breakover
-    // about the claw tips; pointed hard claws plant precisely (contact near the toe)
-    front: { type: 'unguligrade', contact: 0.9, curl: 70, flex: 4, sink: 14, hoofFlex: 20, swingBack: 0.07 },
-    hind: { type: 'unguligrade', contact: 0.9, curl: 70, flex: 4, sink: 12, hoofFlex: 20, swingBack: 0.02 },
-  },
-  stance: { width: 1, gallopWidth: 0.8, sprawl: 0, crouch: 0, scuff: [10, 20, 0] },
-  // torso cross-sections (bind pose, reference size): centre height, half height, half width
-  // (half heights include the legs folded under the chest and thighs when lying down)
-  body: {
-    // (0.28 with the pelvis's 0.36: the body lies level on its folded legs; the chest at 0.25 under the higher rump
-    // pitched forward onto the folded forelegs, a Boer buck's forearm 5 cm in the ground asleep)
-    chest: { y: 0.56, hh: 0.28, hw: 0.15 },
-    mid: { y: 0.55, hh: 0.23, hw: 0.17 },
-    // (the hindquarters rest on the folded hind legs: lying at 0.3 the stifles folded in against the belly and the skin
-    // between the thigh and the flank crumpled into a pocket in front of the stifle, a light torn knob from the side)
-    pelvis: { y: 0.63, hh: 0.36, hw: 0.16 },
-    back: 0.06,
-  },
-  head: {
-    // [speed, raise (m), reach (m), pitch (rad, + = nose down)]: head high and alert at rest, a
-    // little lower and forward at the walk, stretched forward in the gallop
-    carriage: [[0, 0.03, -0.015, -0.05], [1.0, 0.0, 0.01, 0.02], [2.7, -0.01, 0.03, 0.02], [5, -0.06, 0.06, 0.1], [8, -0.1, 0.09, 0.14]],
-    stab: [[0, 0], [1.0, 0.15], [2.7, 0.45], [5, 0.35], [8, 0.4]],
-    neckBend: 34, neckPivot: 0.55, yaw: 0.9, pitchUp: 0.7, pitchDown: 0.9, mouth: 'jawTip',
-  },
-  tail: {
-    // [speed, pitch per segment from horizontal (deg), base -> tip]: carried up, higher when running
-    carriage: [
-      [0.0, [28, 42, 55, 62, 66]],
-      [1.5, [30, 45, 58, 64, 68]],
-      [3.5, [36, 52, 64, 70, 72]],
-      [7, [42, 58, 70, 74, 76]],
-    ],
-    stiffness: 1.2, sway: 4, flick: 1, wag: 0, swish: 0, curl: 0, balance: 0,
-    radius: [0.03, 0.02],
-  },
-  ears: { rest: [0, 0], mobility: 1.3, speedFlatten: 0.3, twitch: 1.6, prick: 0.5 },
-  breath: { rate: 0.32, amp: 0.006, pant: false, pantRate: 2, pantAmp: 0.015, heatSpeed: 6 },
-  actions: {
-    // grazing: the long face already hangs 60 deg nose-down in the bind pose
-    // (the face nearly vertical, 77 deg nose-down: at 1.1 rad the head was cocked back against the lowered neck, the
-    // poll extended 120 deg from its standing angle and the nape's skin folded to 0.65 of its length, its hair standing
-    // apart in a frayed band; the throat stretched more too: > 3x 1.37 -> 0.98 % of the kid's mesh in eat and drink)
-    eat: { style: 'graze', dropF: 0.1, dropH: 0, pitch: 1.35, ahead: 0.5 },
-    drink: { dropF: 0.1, dropH: 0, pitch: 1.3, ahead: 0.5 },
-    // sure-footed: a high standing jump, landing on four feet close together (opts.target lands
-    // exactly there)
-    jump: { height: 0.75, distance: 1.3, land: [0.16, 0.14] },
-    sit: { dropH: 0.8 },
-    // kneels on the carpi first, then drops the hindquarters; rises hind end first
-    lie: { down: 'front', up: 'hind' },
-    sleep: { down: 'front', up: 'hind' },
-    // lying sternal: forelegs folded under the chest (carpus flexed, cannons back along the ground)
-    fold: { front: { z: -0.2, k: 1.45, beta: 0.9 } },
-  },
-  hooks,
-  // the long lop ears of Nubians and Boers hang and swing with the head; they barely prick or twist
-  // (the engine swivels a pinna about its own long axis toward what the goat looks at: a hanging ear
-  // twisted 25 deg about its root)
-  variants: {
-    nubian: { ears: { mobility: 0.5, speedFlatten: 0.15, twitch: 0.4, prick: 0.06 } },
-    boer: { ears: { mobility: 0.5, speedFlatten: 0.15, twitch: 0.4, prick: 0.06 } },
-  },
-};

package/vendor/procedural-animals/src/species/goat/regions.js

@@ -1,98 +0,0 @@
-// Meshing plan: body at 5.4 mm (0.7 % of the withers height, like the cheetah), head at 2.6 mm
-// overlapping the body across the upper neck and cross-faded, eyelid patches at 0.9 mm, the lower
-// lip / chin / beard as its own rigid surface (the mouth opens) and the horns as a rigid keratin
-// surface on the skull.
-import { EYE, hornPath, hornCell, hornSplit, hornTipCell } from './sculpt.js';
-import { HEAD_O, hqOf, goatJoints } from './rig.js';
-import { eyeFrameOf } from '../../core/sdf/eyeSocket.js';
-import { norm, smoothstep, clamp } from '../../core/math/vec.js';
-
-const J = goatJoints();
-// The head mesh takes over across a plane through the upper neck, 30 % of the way from the mid neck
-// to the occiput, its normal the upper neck axis turned 45 deg forward (toward the head): it crosses
-// the nape ~6 cm behind the poll and the throat ~9 cm below the jaw angle, both where the neck is a
-// smooth tube and the fine and coarse meshes agree. (The first cut ran behind the poll and into the
-// concave jaw angle / throat junction, where they did not: a crack from the poll to the throat. A
-// plane square to the upright neck cut through the lower face, which hangs forward below the throat.)
-const NECK_U = norm([0, J.occiput[1] - J.neckMid[1], J.occiput[2] - J.neckMid[2]]);
-const NECK_A = Math.atan2(NECK_U[1], NECK_U[2]) - Math.PI / 4;
-export const NECK_CUT = {
-  c: [0, J.neckMid[1] + 0.3 * (J.occiput[1] - J.neckMid[1]), J.neckMid[2] + 0.3 * (J.occiput[2] - J.neckMid[2])],
-  d: [0, Math.sin(NECK_A), Math.cos(NECK_A)], band: 0.014,
-};
-export const neckS = (x, y, z) => (x - NECK_CUT.c[0]) * NECK_CUT.d[0] + (y - NECK_CUT.c[1]) * NECK_CUT.d[1] + (z - NECK_CUT.c[2]) * NECK_CUT.d[2];
-
-export const EYE_PATCH = { R: 0.024, B: 0.004, h: 0.0011, centres: [1, -1].map((s) => eyeFrameOf(EYE, HEAD_O, s).c) };
-export function eyePatchWeight(x, y, z) {
-  let dmin = 1e9;
-  for (const c of EYE_PATCH.centres) dmin = Math.min(dmin, Math.hypot(x - c[0], y - c[1], z - c[2]));
-  return 1 - smoothstep(EYE_PATCH.R - EYE_PATCH.B, EYE_PATCH.R + EYE_PATCH.B, dmin);
-}
-
-export function goatRegions(rig, params, Q) {
-  // (the band: wider than a body cell, so the body's cut edge, which lies up to a cell into the band,
-  // stays in its hidden half: at the crowd tier a 25 mm cell left it on the visible side of a 14 mm band,
-  // at the low tier 0.95 of a cell left one edge of a buck's neck uncovered)
-  const r = Q.res, B = Math.max(NECK_CUT.band, 0.0059 * r * 1.2);
-  const Ho = HEAD_O;
-  // eyelid patches at hero, high and medium (what Safari and phones show): without them the 24 x 16 mm aperture's lid
-  // margin fell on the medium tier's 5.6 mm face cells and tore into pale and dark flakes round every eye
-  // (the full 24 mm patch: the face mesh stops a cell inside it, and at 21.5 mm that cut reached the lid margin, 19-22
-  // exposed edges round the eyes at medium)
-  const patches = (Q.eyePatches || r <= 2) ? EYE_PATCH.centres.map((c) => ({ c, R: EYE_PATCH.R, B: EYE_PATCH.B, h: EYE_PATCH.h * Math.max(1, r) })) : [];
-  const head = [
-    // (the long, broad lop ears of Nubians and Boers are meshed with the head: its cells 6 % coarser keep a
-    // lop-eared buck inside the hero budget, 133k -> 128k vertices)
-    { name: 'head', part: 'body', bmin: [-0.3, 0.6, 0.33], bmax: [0.3, Ho[1] + 0.14, Ho[2] + 0.24], h: 0.0028 * r * (params.ear === 'lop' ? (params.sex === 'male' && params.age !== 'juvenile' ? (r === 2 ? 1.13 : 1.12) : 1.06) : 1), F: 6, clip: (x, y, z) => neckS(x, y, z) > -B, patches },
-    { name: 'jaw', part: 'jaw', bmin: [-0.06, Ho[1] - 0.27, Ho[2] - 0.09], bmax: [0.06, Ho[1] - 0.03, Ho[2] + 0.22], h: 0.0028 * r, F: 6, rigidBone: 'jaw' },
-  ];
-  // (the beard's locks are 7-12 mm thick: at the medium tier's 6.8 mm cells their tips folded over, back faces showing;
-  // 5.4 mm there)
-  if ((params.beard || 0) > 0.01) head.push({ name: 'beard', part: 'beard', bmin: [-0.07, Ho[1] - 0.46, Ho[2] - 0.16], bmax: [0.07, Ho[1] - 0.06, Ho[2] + 0.18], h: 0.0034 * (r === 2 ? 1.6 : r), F: 6, rigidBone: 'beard' });
-  if (params.wattles) head.push({ name: 'wattle', part: 'wattle', bmin: [-0.06, Ho[1] - 0.2, Ho[2] - 0.18], bmax: [0.06, Ho[1] + 0.03, Ho[2] + 0.02], h: 0.0022 * r, F: 6, rigidBone: 'neck2' });
-  // the udder / a buck's scrotum: its own closed surface, rigid on the udder bone (sculpt.js) (the scrotum
-  // coarser: a horned, bearded lop-eared buck was 200 vertices over the hero budget)
-  const adult = params.age !== 'juvenile', male = params.sex === 'male', HQ = hqOf(params);
-  if (adult && (male || (params.udder ?? 0.5) > 0.05)) head.push({ name: 'udder', part: 'udder', bmin: [-0.11, 0.17, -0.44 + HQ], bmax: [0.11, male ? 0.62 : 0.56, -0.2 + HQ], h: (male ? 0.005 : 0.0042) * r, F: 6, rigidBone: 'udder' });
-  if (params.horns && params.horns.len > 0) {
-    // the box from the horn centre lines (both sides) plus the horn radius and two cells: a fixed box
-    // cut the horn bases off (they start at the poll, z 0.65, and a doe's horns reach z 0.68)
-    // (cells with the horn's girth: a buck's longest, thickest horns took 18k vertices at 3.2 mm, and a
-    // lop-eared buck with them and a long beard came to 137k at hero, over the 130k budget)
-    // (at most the low tier's cells at the crowd tier too: 16 mm cells left a buck's horn a chain of ragged lumps;
-    // the horn is also kept ~0.45 of a cell thick there, sculpt.js hornPath)
-    // (at the low and crowd tiers the tapering outer part is its own solid at the medium tier's cells, sculpt.js hornSplit)
-    const h = hornCell(params, r), hT = hornTipCell(params);
-    const box = (part, hh, from, to) => {
-      const bmin = [1e9, 1e9, 1e9], bmax = [-1e9, -1e9, -1e9];
-      for (const s of [1, -1]) {
-        const pth = hornPath(params, s), J = hornSplit(params, pth);
-        pth.forEach((q, i) => {
-          if (J >= 0 && (i < from(J) || i > to(J, pth.length))) return;
-          const m = q.r * 1.25 + 2 * hh + 0.004;
-          for (let k = 0; k < 3; k++) { bmin[k] = Math.min(bmin[k], q.p[k] - m); bmax[k] = Math.max(bmax[k], q.p[k] + m); }
-        });
-      }
-      head.push({ name: part, part, bmin, bmax, h: hh, F: 6, rigidBone: 'head' });
-    };
-    const split = hornSplit(params, hornPath(params, 1)) >= 0;
-    box('horn', h, () => 0, (J, n) => (split ? J : n));
-    if (split) box('horntip', hT, (J) => J - 2, (J, n) => n);
-  }
-  return {
-    jobs: [
-      [{ name: 'body', part: 'body', bmin: [-0.26, -0.01, -0.66], bmax: [0.26, 1.0, 0.7], h: 0.0059 * r, F: 4, clip: (x, y, z) => neckS(x, y, z) < B }],
-      head,
-    ],
-    fade(x, y, z, name, patch) {
-      const sN = neckS(x, y, z);
-      if (name === 'body') return 1 - smoothstep(-B, B, sN);
-      if (name === 'head') {
-        let f = smoothstep(-B, B, sN);
-        if (patches.length) { const ew = eyePatchWeight(x, y, z); f *= patch ? ew : 1 - ew; }
-        return f;
-      }
-      return 1;
-    },
-  };
-}

package/vendor/procedural-animals/src/species/goat/rig.js

@@ -1,181 +0,0 @@
-// Goat skeleton in bind pose (metres). Forward = +Z, up = +Y, the animal's left = +X.
-// Reference individual: a Saanen-type dairy doe, 0.78 m at the withers, ~65 kg (ADGA standard). Landmarks measured on side3.jpg (4x grid, 1 px = 1.39 mm) and side2.jpg
-// (1 px = 1.84 mm), limb segments from published goat osteometry.
-//
-// Hooves: the standard quadruped bones plus a hoof bone per leg, exactly like the horse:
-// fpaw / hpaw = pastern (fetlock -> coffin joint), fhoof / hhoof = the cloven hoof (coffin joint ->
-// toe), so the engine keeps the claws flat while the fetlock sinks under load.
-//
-// The rig depends on the individual only through the ears (erect / lateral in Swiss breeds, long and
-// pendulous in the Nubian: params.ear).
-import { buildRig } from '../../core/rig/rig.js';
-import { quadrupedBones, quadrupedLimbs, tailChain } from '../../core/rig/quadruped.js';
-
-export const TAIL_SEGS = 5;
-// a lop ear's root blend: the ear takes the skin up to 3 cm onto the head and down to 5 cm along the ear (it hangs with
-// gravity, turning up to 25 deg about its root against the skull: at [-0.006, 0.02] the root and the web between the
-// blade and the cheek stretched 3x on 1 % more of the mesh when grazing)
-export const LOPBL = [-0.03, 0.05];
-
-// Head frame: modelled along its own axis (poll -> muzzle), pitched 42 degrees nose-down in the
-// bind pose. Head-local coordinates: x lateral, y dorsal (forehead side), z along the nasal line toward
-// the muzzle; origin on the axis 0.07 m in front of the poll, level with the eyes.
-// (side2 and walk1: the eye -> nose-tip line runs 33-34 deg below the horizontal and the forehead
-// 51-60 deg; the poll stands ~0.3 SH above the withers, the neck rises at ~55-64 deg. The head was
-// carried at 54 deg with the forehead profile at 68 deg, 5-7 cm low: a grazing horse's carriage)
-export const HEAD_PITCH = (42 * Math.PI) / 180;
-export const HZ = [0, -Math.sin(HEAD_PITCH), Math.cos(HEAD_PITCH)];
-export const HY = [0, Math.cos(HEAD_PITCH), Math.sin(HEAD_PITCH)];
-const POLL = [0, 0.975, 0.59]; // top of the poll (skin), bind
-export const HEAD_O = [0, POLL[1] + 0.07 * HZ[1], POLL[2] + 0.07 * HZ[2]];
-export const hl = (v) => [HEAD_O[0] + v[0], HEAD_O[1] + v[1] * HY[1] + v[2] * HZ[1], HEAD_O[2] + v[1] * HY[2] + v[2] * HZ[2]];
-// a kid's face is short: in front of the eyes the head-local z (along the nasal line) is compressed by
-// KID_FACE (front2, kid_side: a big braincase and eyes over a short, small muzzle; the whole head scaled
-// up gave a kid an adult's bulbous muzzle). faceZ maps an adult head-local z to the kid's, unFaceZ back.
-export const KID_FACE = 0.78;
-export const faceZ = (z, kid) => (kid && z > 0.02 ? 0.02 + (z - 0.02) * KID_FACE : z);
-export const unFaceZ = (z, kid) => (kid && z > 0.02 ? 0.02 + (z - 0.02) / KID_FACE : z);
-// head-local point (adult coordinates) -> world, with the kid's short face
-export const hlk = (v, kid) => hl([v[0], v[1], faceZ(v[2], kid)]);
-// head-local direction -> world
-export const hdir = (v) => [v[0], v[1] * HY[1] + v[2] * HZ[1], v[1] * HY[2] + v[2] * HZ[2]];
-// world point -> head-local
-export const toHL = (p) => { const d = [p[0] - HEAD_O[0], p[1] - HEAD_O[1], p[2] - HEAD_O[2]]; return [d[0], d[1] * HY[1] + d[2] * HY[2], d[1] * HZ[1] + d[2] * HZ[2]]; };
-
-// ear tips (head-local, left): Swiss erect / lateral ears point out, a little up and forward;
-// Nubian / Boer lop ears hang straight down beside the face (their tip is placed in world space
-// below the base, clear of the cheek: see goatJoints)
-export const EAR_BASE = [0.048, 0.026, -0.06];
-export const EAR_TIP = {
-  erect: [0.2, 0.015, -0.02],
-};
-// the hindquarters (hip joint, hind limb, pelvis, tail root, udder) sit this far further forward than
-// the first model: side1 / side2 give a body (point of shoulder -> point of buttock) of 1.06-1.09 SH,
-// the model had 1.24 SH, its hip points, tail head and buttock 10-18 cm behind side2's
-// (adults 0.07, not 0.095: the hind hooves stood 0.17 SH ahead of the rump's outline at the toe, against
-// 0.06-0.12 in side2 / side3; now 0.14 at the toe, 0.05 at the heel, the cannons under the pin bones. Kids keep
-// 0.095: their hind legs stand under the short body, kid_side, and with them further back the Nubian kid's
-// sprint jittered at the wrist, p99 0.086 % S)
-export const hqOf = (params = {}) => (params.age === 'juvenile' ? 0.095 : 0.07);
-
-export function goatJoints(params = {}) {
-  // (erect ears: carried from level-lateral (face3) to up-and-out (face1), params.earLift 0..1)
-  const lop = params.ear === 'lop';
-  const kid = params.age === 'juvenile';
-  // (kids carry their big ears up and out: front2, kid_side)
-  const lift = kid ? Math.max(0.6, params.earLift ?? 0.5) : (params.earLift ?? 0.5);
-  const HQ = hqOf(params);
-  const J = {
-    nose: hlk([0, -0.024, 0.205], kid), // (the front of the nose pad and upper lip: the engine keeps it off the ground)
-    occiput: hl([0, -0.045, -0.1]), // (behind the poll and the horn bases: the skull top is all 'head')
-    neckMid: [0, 0.8, 0.472],
-    neckBase: [0, 0.64, 0.35],
-    chestMid: [0, 0.668, 0.17],
-    thoraxRear: [0, 0.692, 0.015],
-    lumbarMid: [0, 0.702, -0.1],
-    lumbosacral: [0, 0.707, -0.215],
-    tailBase: [0, 0.71, -0.4],
-    // fore: scapula sloping ~65 deg, humerus down and back (45 deg from vertical), radius and cannon
-    // vertical, pastern ~50 deg (cloven hoof)
-    // (the elbow 1.7 cm further back: with the humerus 40 deg from vertical the shoulder -> wrist span was
-    // 93 % of humerus + radius, the engine's reach limit left the foreleg a 0.45 m stance sweep against
-    // the hind leg's 0.75 m, and it cut the fore stances short: duty 0.53 / 0.34 / 0.20 at the walk,
-    // trot and gallop against the table's 0.65 / 0.42 / 0.29, a high hackney flick and pacing walk)
-    scapTopL: [0.055, 0.745, 0.265],
-    shoulderL: [0.088, 0.53, 0.372],
-    elbowL: [0.083, 0.405, 0.245],
-    wristL: [0.07, 0.21, 0.252],
-    mcpL: [0.064, 0.07, 0.256],
-    fcoffinL: [0.064, 0.03, 0.279],
-    ftoeL: [0.064, 0.002, 0.323],
-    // hind: hip joint, stifle, hock, fetlock, coffin joint, toe (the cannon vertical: it stood 6 deg
-    // forward, sickle-hocked)
-    hipL: [0.078, 0.63, -0.36 + HQ],
-    kneeL: [0.093, 0.45, -0.24 + HQ],
-    hockL: [0.066, 0.25, -0.44 + HQ],
-    mtpL: [0.06, 0.075, -0.442 + HQ],
-    hcoffinL: [0.06, 0.031, -0.419 + HQ],
-    htoeL: [0.06, 0.002, -0.374 + HQ],
-    jawHinge: hl([0, -0.045, -0.02]),
-    jawTip: hlk([0, -0.078, 0.185], kid),
-    // (a lop ear's root sits further back on the skull: hanging from the erect ear's root, the broad blade
-    // covered the eye)
-    earBaseL: hl(lop ? [EAR_BASE[0], EAR_BASE[1] - 0.006, EAR_BASE[2] - 0.01] : EAR_BASE),
-    // udder (does): its own rigid bone below the pelvis, so it can fold up out of the ground when the
-    // doe lies down (hooks.pose)
-    // beard: its own bone below the chin (hangs from the jaw; hooks.pose swings it out of the ground)
-    beardTop: hlk([0, -0.094, 0.115], kid),
-    udderTop: [0, 0.44, -0.34 + HQ],
-    udderBot: [0, 0.3, -0.325 + HQ],
-  };
-  // lop ears (Nubian, Boer): long and broad, hanging down beside the face and jaw from the base, flaring out
-  // to 9 cm from the root at the tip and a little back of vertical, so the blade stays behind the eye (side_boer,
-  // the Nubian standard; hanging straight down with the face pitched 42 deg nose-down it covered the eye) and
-  // clear of the throat (within the 2 cm blend of the throat skin it took neck weights and stretched)
-  const eb = J.earBaseL;
-  // (a kid's lop ears are shorter: its head is scaled up as a whole, and full-length ears hung below its knees)
-  // (Nubian ears ~25 cm, reaching below the jaw; a Boer's a little shorter: at 21 cm they ended at the
-  // mouth corner, short paddles)
-  const le = (kid ? 0.82 : 1) * (params.variant === 'boer' ? 0.9 : 1);
-  J.earTipL = lop ? [eb[0] + 0.1 * le, eb[1] - 0.225 * le, eb[2] - 0.05 * le]
-    : hl([EAR_TIP.erect[0] - 0.02 * lift, EAR_TIP.erect[1] - 0.03 + 0.11 * lift, EAR_TIP.erect[2] + 0.02 * lift]);
-  // (a kid's erect ears are long for its head: as long as its face, front2)
-  if (kid && !lop) for (let i = 0; i < 3; i++) J.earTipL[i] = eb[i] + (J.earTipL[i] - eb[i]) * 1.15;
-  J.beardTip = [J.beardTop[0], J.beardTop[1] - Math.max(0.03, params.beard || 0), J.beardTop[2] - 0.01];
-  // the short flat tail is carried up (research: erect most of the time)
-  tailChain(J, 'tailBase', [28, 42, 55, 62, 66], [0.035, 0.032, 0.03, 0.028, 0.026]);
-  return J;
-}
-
-export function goatBones() {
-  const b = quadrupedBones({ tailSegs: TAIL_SEGS, ears: true, jaw: true });
-  for (const d of b) {
-    if (d[0] === 'fpaw{S}') { d[2] = 'fcoffin{S}'; d[4] = { region: 'limb', group: 'F{S}' }; }
-    if (d[0] === 'hpaw{S}') { d[2] = 'hcoffin{S}'; d[4] = { region: 'limb', group: 'H{S}' }; }
-  }
-  b.push(['udder', 'udderTop', 'udderBot', 'pelvis', { region: 'torso', group: 'udder' }]);
-  b.push(['beard', 'beardTop', 'beardTip', 'jaw', { region: 'jaw', group: 'jaw' }]);
-  b.push(
-    ['fhoof{S}', 'fcoffin{S}', 'ftoe{S}', 'fpaw{S}', { region: 'foot', group: 'F{S}' }],
-    ['hhoof{S}', 'hcoffin{S}', 'htoe{S}', 'hpaw{S}', { region: 'foot', group: 'H{S}' }],
-  );
-  return b;
-}
-
-export function goatRig(params = {}, J = goatJoints(params)) {
-  const limbs = quadrupedLimbs({
-    front: { tCore: 0.5, aCore: 0.05, aBody: -0.15, midX: 0.0 },
-    hind: { tCore: 0.45, aCore: 0.022, aBody: -0.11, midX: 0.008 },
-  });
-  for (const L of Object.values(limbs)) { L.bones.push((L.front ? 'fhoof' : 'hhoof') + L.S); L.distal.push((L.front ? 'fhoof' : 'hhoof') + L.S); }
-  return buildRig({
-    joints: J,
-    unit: 1.03,
-    headOrigin: HEAD_O,
-    bones: goatBones(),
-    axial: {
-      points: ['nose', 'occiput', 'neckMid', 'neckBase', 'chestMid', 'thoraxRear', 'lumbarMid', 'lumbosacral', 'tailBase', ...Array.from({ length: TAIL_SEGS }, (_, i) => 'tail' + (i + 1))],
-      bones: ['head', 'neck2', 'neck1', 'chest', 'spine3', 'spine2', 'spine1', 'pelvis', ...Array.from({ length: TAIL_SEGS }, (_, i) => 'tail' + i)],
-      // the skull's influence reaches back into the throat (widening with the depth below the axis)
-      // (a narrower lever, 0.5, kept the cheek out of the blend but gathered the stretch at the jaw angle:
-      // fewer triangles over 2x, more over 3x; the throat stretch is cured in the poses instead, the grazing
-      // head pitch and a kid's short face, see motion.js and rig.js faceZ)
-      // (the neck base blends over 8 cm each side: the skin over the withers stretched 3x when the head went
-      // down or round to the flank)
-      // (15 cm: at 8 cm the skin over the withers bent over a ridge when the neck went down to graze; the Boer
-      // keeps 11 cm: wider, its broad chest front took neck weights, and lying dead it rested 11 mm in the
-      // ground, and its red / white border across the lower neck stretched)
-      blend: { 1: [-0.05, 0.14, 4.5], 3: params.variant === 'boer' ? [-0.11, 0.11, 0] : [-0.15, 0.15, 0] },
-      bodyTail: 0, // (the rump and buttocks do not blend into the tail: they tore when the thighs folded to lie down)
-    },
-    limbs,
-    appendages: [
-      // (a long lop ear swings about its root as the head moves: its root blends over 2.6 cm, where an
-      // erect ear's took 6 mm and tore; reaching 1 cm onto the head it dragged the skin behind the root)
-      { group: 'earL', bone: 'earL', blend: params.ear === 'lop' ? LOPBL : [-0.002, 0.004] },
-      { group: 'earR', bone: 'earR', blend: params.ear === 'lop' ? LOPBL : [-0.002, 0.004] },
-      { group: 'udder', bone: 'udder', blend: [-0.004, 0.02] },
-    ],
-    webTags: ['flankfold', 'thighfront', 'scapmuscle', 'pectoral', 'forearmweb'],
-  });
-}