@bitefoundry/retrieviewer 0.0.2 → 0.0.4

package/vendor/procedural-animals/src/species/eagle/coat.js

@@ -1,250 +0,0 @@
-// The eagle's plumage and bare parts, baked per vertex: contour-feather shingles (material 9), a short
-// down haze (shells), yellow keratin bill and waxy cere, scaled yellow tarsi and toes, black talons.
-// Adult bald eagle: dark chocolate body and wings, white head, neck and tail with a ragged hood edge.
-// Juvenile bald eagle: brown with white mottling (belly, underwing, armpits), dark head, dark bill.
-// Golden eagle: dark brown with a golden crown and nape, pale-edged wing coverts, grey-barred tail,
-// dark-tipped blue-grey bill, legs feathered to the toes; juveniles with a white tail base and black
-// band. Colours sampled from the reference photos. Seeded variation shifts tones, wear and
-// the juvenile mottling.
-import { SDFModel } from '../../core/sdf/sdf.js';
-import { norm, sub, dot, cross, add, mul, clamp, smoothstep, mix, fbm3 } from '../../core/math/vec.js';
-import { srgb, mix3, MAT } from '../../core/build/coatKit.js';
-import { HEAD_O } from './rig.js';
-
-export function eagleColours(p = {}) {
-  const golden = p.variant === 'golden', juv = p.age === 'juvenile';
-  const warm = p.warm || 0, wear = p.wear || 0;
-  const tone = (c) => mix3(c, srgb(0x5a4430), wear * 0.25 + warm * 0.1);
-  if (golden) {
-    return {
-      golden, juv,
-      body: tone(srgb(juv ? 0x33251b : 0x3a2a1e)), under: tone(srgb(juv ? 0x2e2118 : 0x34261b)),
-      head: srgb(0x3a2a1e), nape: mix3(srgb(0xc08a3e), srgb(0xd9a650), p.goldK ?? 0.5), face: srgb(0x33251b),
-      covertEdge: srgb(0x8a6a48), white: srgb(0xe6e1d6), mottle: 0,
-      tail: srgb(0x4a3e34), tailBar: srgb(0x6e665c), tailBase: srgb(0xedeae2), tailBand: srgb(0x1e1a18),
-      bill: srgb(0x4c5258), billTip: srgb(0x141416), cere: srgb(0xe8c040), gape: srgb(0xd8b040),
-      leg: srgb(0xe8c040), boot: tone(srgb(0x6a4a30)), claw: srgb(0x161616), ring: srgb(0x4a3a2a),
-      hoodWhite: false, whiteTail: false,
-    };
-  }
-  const bill = juv ? mix3(srgb(0x2e2a28), srgb(0xb89a58), p.billAge || 0) : srgb(0xecc46f);
-  return {
-    golden, juv,
-    body: tone(srgb(juv ? 0x3a2a1e : 0x2b1e16)), under: tone(srgb(juv ? 0x3a2b20 : 0x2a1d15)),
-    head: juv ? srgb(0x2e2218) : srgb(0xf2f0ea), nape: juv ? srgb(0x3a2a1e) : srgb(0xf2f0ea), face: juv ? srgb(0x3a2c20) : srgb(0xeeece6),
-    covertEdge: srgb(0x4a3828), white: srgb(0xe0d8c8), mottle: juv ? (p.mottle ?? 0.5) : 0,
-    tail: juv ? srgb(0x4a3a2c) : srgb(0xf4f2ec), tailBar: srgb(0x4a3a2c), tailBase: srgb(0xf4f2ec), tailBand: srgb(0x2a1e16),
-    bill, billTip: bill, cere: juv ? mix3(srgb(0x7a6a50), srgb(0xd8b450), p.billAge || 0) : srgb(0xedc45a),
-    gape: juv ? srgb(0x8a7a60) : srgb(0xe8c060),
-    leg: srgb(juv ? 0xe8b840 : 0xf0b830), boot: null, claw: srgb(0x161616), ring: juv ? srgb(0x5a4a38) : srgb(0xd8c078),
-    hoodWhite: !juv, whiteTail: !juv,
-  };
-}
-
-export function eagleCoat(ctx) {
-  const { model, rig, pos, nrm, regionOf, regionNames, weights, nV, params } = ctx;
-  const { BONES, J } = rig;
-  const C = eagleColours(params);
-  const comb = new Float32Array(nV * 3), tint = new Float32Array(nV * 4), surf = new Float32Array(nV * 4);
-  const furLen = new Float32Array(nV), mark = new Float32Array(nV).fill(1), pattern = new Float32Array(nV).fill(1);
-  const patternColor = new Float32Array(nV * 4);
-  const boneName = BONES.map((b) => b.name);
-  const tagged = (...t) => model.prims.filter((p) => t.includes(p.tag));
-  const billP = tagged('bill'), cereP = tagged('cere'), nostrilP = tagged('nostril'), mandP = model.forPart('jaw');
-  const eyeP = tagged('eyesocket'), clawP = tagged('claw'), bareP = tagged('tarsus', 'toe', 'pad'), featherLegP = tagged('cuff', 'boot', 'trousers');
-  const minD = (list, p) => { let d = 1e9; for (const q of list) d = Math.min(d, SDFModel.dist(q, p[0], p[1], p[2])); return d; };
-  const H = HEAD_O;
-  const axialPts = rig.AXIAL.points;
-  const axialDir = (p) => {
-    let best = 1e9, dir = [0, 0, -1];
-    for (let i = 0; i < axialPts.length - 1; i++) {
-      const a = axialPts[i], b = axialPts[i + 1], ab = sub(b, a), l2 = dot(ab, ab);
-      const t = clamp(dot(sub(p, a), ab) / l2, 0, 1);
-      const q = add(a, mul(ab, t)), d = Math.hypot(p[0] - q[0], p[1] - q[1], p[2] - q[2]);
-      if (d < best) { best = d; dir = norm(ab); }
-    }
-    return dir;
-  };
-  // hood edge (bald adult): along the neck from the neck base (0) to the occiput (1), ragged
-  const nb = J.neckBase, nd = sub(J.occiput, J.neckBase), nl2 = dot(nd, nd);
-  const hoodT = (p) => dot(sub(p, nb), nd) / nl2;
-  // bald adult white hood: everything within a ragged radius of a point at the back of the skull, so the
-  // white ends at the base of the neck all round, the throat as cleanly as the nape (a plane across the
-  // neck, t above, left the throat white far down onto the breast once the body is levelled in flight).
-  // Flight photos: the white reaches ~0.21 m back from the bill tip, the dark breast
-  // begins where the neck meets the body.
-  const hoodC = add(J.occiput, [0, -0.008, 0.01]);
-  const hoodR = 0.1 - ((params.hood ?? 0.26) - 0.26) * 0.15;
-  const tailDir = norm(sub(J.tailTip, J.tailBase));
-  const seed = (params.seed || 1) * 0.37;
-  for (let v = 0; v < nV; v++) {
-    const p = [pos[v * 3], pos[v * 3 + 1], pos[v * 3 + 2]], n = [nrm[v * 3], nrm[v * 3 + 1], nrm[v * 3 + 2]];
-    const bn = boneName[weights.dominant[v]] || '';
-    const region = regionNames[regionOf[v]];
-    let col = C.body, mat = MAT.FEATHER, fl = 0.006, gloss = 0.35, size = 0.022;
-    let flow = axialDir(p);
-    const h = [p[0] - H[0], p[1] - H[1], p[2] - H[2]];
-    const up = n[1];
-    let mottleOK = 0; // where juvenile white mottling may appear
-    if (region === 'jaw' || bn === 'jaw') {
-      mat = MAT.KERATIN; col = mix3(C.bill, C.billTip, smoothstep(0.05, 0.085, h[2])); fl = 0; gloss = C.golden || C.juv ? 0.26 : 0.4; size = 0;
-      flow = [0, 0, 1];
-      if (h[2] < 0.012) { mat = MAT.SKIN; col = C.gape; gloss = 0.35; }
-    } else if (bn === 'head' || region === 'head') {
-      col = C.head; size = 0.0055; gloss = 0.3; fl = 0.006;
-      flow = norm([0, -0.2, -1]);
-      if (Math.abs(h[0]) > 0.01) flow = norm([h[0] * 6, -0.35, -1]);
-      if (C.golden) {
-        col = C.face; // (the golden crown and nape are laid on below, continuous with the neck)
-      } else if (C.juv) {
-        // juvenile: dark head with a paler, streaky cheek and throat
-        col = mix3(C.head, C.face, smoothstep(0.0, -0.03, h[1]));
-      }
-      if (h[2] < -0.04) fl = 0.009; // lanceolate hackles on the nape
-      const db = minD(billP, p), dc = minD(cereP, p), dn = minD(nostrilP, p), dm = minD(mandP, p);
-      // (surface points on the smooth-union blend lie up to ~3 mm from the nearest primitive)
-      const bare = Math.min(db, dc) < 0.003 && h[2] > 0.024;
-      if (bare && db < dc - 0.0005 && h[2] > 0.045) {
-        mat = MAT.KERATIN; fl = 0; gloss = C.golden || C.juv ? 0.26 : 0.4; flow = [0, 0, 1]; size = 0;
-        col = mix3(C.bill, C.billTip, smoothstep(0.07, 0.098, h[2]));
-      } else if (bare) {
-        mat = MAT.SKIN; col = C.cere; fl = 0; gloss = 0.45; flow = [0, 0, 1]; size = 0;
-        if (dn < 0.0025) col = mul(C.cere, 0.25);
-      } else if (dm < 0.0015 && h[2] > 0.0) { mat = MAT.SKIN; col = C.gape; fl = 0; }
-      else if (h[2] > 0.012 && h[1] < 0.004 && Math.abs(h[0]) < 0.022) {
-        // lores: short bristly feathers between eye and cere
-        fl = 0.0025; size = 0.004; flow = norm([h[0] * 4, -0.1, -1]);
-      }
-      // eye ring: narrow bare skin at the lid margin, very short feathers around it
-      for (const e of eyeP) {
-        const de = SDFModel.dist(e, p[0], p[1], p[2]);
-        if (Math.abs(de) < 0.0012) { mat = MAT.SKIN; col = C.ring; fl = 0; gloss = 0.4; }
-        else if (Math.abs(de) < 0.004) { fl = Math.min(fl, 0.0015); size = 0.004; }
-      }
-    } else if (/^(tarsus|toe)/.test(bn) || (bn.startsWith('tibia') && minD(bareP, p) < 0.001)) {
-      const dFeather = minD(featherLegP, p), dBare = minD(bareP, p);
-      if (dFeather < dBare - 0.0015 && /^tarsus/.test(bn)) {
-        // feathered tarsus: the cuff below the trousers (bald) or the golden eagle's boot
-        col = C.boot || C.under; fl = 0.007; size = 0.012; gloss = 0.3; flow = [0, -1, 0.1];
-        mottleOK = 0.5;
-      } else {
-        mat = MAT.SCALES; col = C.leg; fl = 0; gloss = 0.4; size = 0.006; flow = [0, -1, 0];
-        if (minD(clawP, p) < 0.0008) { mat = MAT.KERATIN; col = C.claw; gloss = 0.7; size = 0; }
-        if (/^toe/.test(bn)) { const b = BONES[weights.dominant[v]]; flow = norm(sub(b.tail, b.head)); size = 0.0045; }
-      }
-    } else if (bn.startsWith('tibia') || bn.startsWith('femur')) {
-      // feathered "trousers": soft, loose, pointing down the leg
-      col = C.golden ? mix3(C.under, C.boot, 0.5) : C.under; fl = 0.009; size = 0.016; gloss = 0.28;
-      flow = [0, -1, -0.15]; mottleOK = 0.7;
-    } else if (/^(humerus|ulna|hand)/.test(bn)) {
-      // wing coverts: lie toward the trailing edge
-      const b = BONES[weights.dominant[v]];
-      const S = b.side === 'R' ? 'R' : 'L';
-      const d = norm(sub(b.tail, b.head));
-      let wn = norm(cross(sub(J['elbow' + S], J['shoulder' + S]), sub(J['wrist' + S], J['elbow' + S])));
-      if (wn[1] < 0) wn = mul(wn, -1);
-      const s = S === 'R' ? -1 : 1;
-      flow = mul(norm(cross(wn, d)), s);
-      size = 0.018; fl = 0.005;
-      const top = dot(n, wn);
-      if (top < 0) { col = C.under; mottleOK = 1; } // underwing coverts / armpits
-      else if (C.golden) col = mix3(C.body, C.covertEdge, 0.22 * smoothstep(0.2, 0.8, top));
-    } else if (bn === 'tail') {
-      // tail coverts: white on the adult bald eagle from ~3 cm behind the base of the tail (where the
-      // rectrices emerge) back; the rump and vent in front of it stay dark, as in the flight photos (the
-      // white used to start at the tail joint and read as a pale wedge in front of the tail)
-      const dorsal = smoothstep(-0.2, 0.5, up);
-      col = mix3(C.under, C.body, dorsal); size = 0.02; fl = 0.006;
-      if (C.whiteTail) {
-        const u = dot(sub(p, J.tailBase), tailDir) + (fbm3(p[0] * 70 + seed, p[1] * 70, p[2] * 70, 2) - 0.5) * 0.012;
-        col = mix3(col, C.tail, smoothstep(0.02, 0.036, u));
-      } else mottleOK = 0.6;
-    } else {
-      // body: dark back and mantle, the breast and belly a shade warmer
-      const dorsal = smoothstep(-0.2, 0.5, up);
-      col = mix3(C.under, C.body, dorsal);
-      size = 0.024; fl = 0.007;
-      mottleOK = 1 - dorsal * 0.7;
-      if (bn === 'chest' && up < 0.2) flow = norm(add(flow, [0, -0.7, 0]));
-    }
-    // hood: bald adult white head and upper neck with a ragged edge; golden eagle golden crown, nape and
-    // hind neck (one rule for the head and the neck meshes, so the colour is continuous across the cut)
-    if ((bn.startsWith('neck') || bn === 'chest' || bn === 'head' || region === 'head') && mat === MAT.FEATHER) {
-      const t = hoodT(p);
-      const jag = (fbm3(p[0] * 60 + seed, p[1] * 60, p[2] * 60, 3) - 0.5) * 0.35;
-      const h0 = params.hood ?? 0.26;
-      let hood = smoothstep(h0, h0 + 0.1, t + jag);
-      if (C.hoodWhite) {
-        const r = Math.hypot(p[0] - hoodC[0], p[1] - hoodC[1], p[2] - hoodC[2]) + jag * 0.05;
-        hood = smoothstep(hoodR + 0.008, hoodR - 0.004, r);
-        col = mix3(col, mix3(C.head, srgb(0xd4d2cc), 0.3 * smoothstep(-0.1, -0.7, n[1]) * smoothstep(0.9, 1.2, t)), hood);
-      }
-      else if (C.golden) {
-        const gw = smoothstep(0.45, 0.8, t + jag * 0.5) * smoothstep(-0.25, 0.45, -0.8 * n[2] + 0.6 * n[1]) * smoothstep(0.035, 0.0, h[2]);
-        col = mix3(col, C.nape, gw);
-      } else if (bn !== 'head' && region !== 'head') col = mix3(col, C.head, hood * 0.7);
-      if (hood > 0.5 && bn !== 'head' && region !== 'head') { fl = 0.008; size = 0.012; }
-      mottleOK *= 1 - smoothstep(0.2, 0.5, t);
-    }
-    // juvenile mottling: irregular white blotches on the underparts, armpits and trousers
-    if (C.mottle > 0 && mottleOK > 0 && mat === MAT.FEATHER) {
-      const m = fbm3(p[0] * 48 + seed * 3, p[1] * 48, p[2] * 48, 4);
-      const thr = 0.68 - 0.2 * C.mottle * mottleOK;
-      const d = (thr - m) * 0.04; // metres-ish (< 0 inside a blotch)
-      pattern[v] = clamp(d, -0.02, 0.02);
-      patternColor[v * 4] = C.white[0]; patternColor[v * 4 + 1] = C.white[1]; patternColor[v * 4 + 2] = C.white[2];
-      patternColor[v * 4 + 3] = 0.6 * mottleOK;
-    }
-    // low-frequency variation (wear, sun-bleached feather tips)
-    const cv = fbm3(p[0] * 18, p[1] * 18, p[2] * 18, 3) - 0.5;
-    const kk = mat === MAT.FEATHER ? 0.3 : 0.08;
-    col = [col[0] * (1 + kk * cv), col[1] * (1 + kk * cv), col[2] * (1 + kk * 0.9 * cv)];
-    const f = sub(flow, mul(n, dot(flow, n)));
-    const fN = norm(Math.hypot(...f) > 1e-6 ? f : cross(n, [1, 0, 0]));
-    comb.set(fN, v * 3);
-    tint[v * 4] = col[0]; tint[v * 4 + 1] = col[1]; tint[v * 4 + 2] = col[2]; tint[v * 4 + 3] = mat;
-    furLen[v] = fl;
-    surf[v * 4] = gloss; surf[v * 4 + 1] = size; surf[v * 4 + 2] = 0; surf[v * 4 + 3] = mat === MAT.FEATHER ? 0.03 : 0;
-  }
-  return { comb, tint, pattern, mark, furLen, surf, patternColor };
-}
-
-// flight-feather card colours
-export function eagleFeatherColour(params) {
-  const C = eagleColours(params);
-  const mot = C.mottle;
-  return (kind, i, side, t, c, layer) => {
-    const top = layer > 0;
-    const covert = kind.endsWith('Covert');
-    const hsh = (a) => { const x = Math.sin(a * 12.9898 + i * 78.233 + side * 3.1) * 43758.5453; return x - Math.floor(x); };
-    let rgb = top ? mul(C.body, 0.68) : mix3(C.under, srgb(0x4a3e36), 0.3);
-    if (kind === 'rectrix' || kind === 'tailCovert') {
-      if (C.whiteTail) rgb = top ? C.tail : mix3(C.tail, srgb(0xc8c6c0), 0.3);
-      else if (C.golden && C.juv) rgb = t < 0.62 ? C.tailBase : mix3(C.tailBase, C.tailBand, smoothstep(0.62, 0.7, t));
-      else if (C.golden) {
-        // greyish bands across the tail
-        const bar = smoothstep(0.35, 0.5, Math.sin(t * 5 * Math.PI + 0.6) * 0.5 + 0.5) * (1 - smoothstep(0.8, 0.95, t));
-        rgb = mix3(C.tail, C.tailBar, bar * (top ? 0.8 : 0.6));
-      } else {
-        // juvenile bald: brown, mottled white toward the base and inner webs
-        rgb = C.tail;
-        const w = (1 - smoothstep(0.35, 0.85, t)) * mot * (0.4 + 0.6 * hsh(Math.floor(t * 9) + c));
-        rgb = mix3(rgb, C.white, clamp(w, 0, 0.8));
-        rgb = mix3(rgb, srgb(0x2a1e16), smoothstep(0.85, 0.97, t) * 0.6);
-      }
-    } else if (kind === 'primary' || kind === 'secondary') {
-      // flight feathers: slightly greyer below, darker tips
-      if (!top) rgb = mix3(rgb, srgb(0x5a5048), 0.25);
-      rgb = mix3(rgb, srgb(0x16110d), smoothstep(0.7, 1, t) * 0.35);
-      if (C.golden && kind === 'secondary' && top) rgb = mix3(rgb, C.tailBar, 0.25 * (Math.sin(t * 14) * 0.5 + 0.5) * (1 - t));
-      if (C.golden && C.juv && kind === 'primary' && i < 6) rgb = mix3(rgb, C.tailBase, (1 - smoothstep(0.2, 0.45, t)) * 0.9);
-      if (!C.golden && C.juv && !top) rgb = mix3(rgb, C.white, mot * 0.5 * (1 - smoothstep(0.3, 0.6, t)) * (0.5 + 0.5 * hsh(c * 3)));
-    } else if (covert) {
-      if (C.golden && top) rgb = mix3(mul(C.body, 0.8), C.covertEdge, smoothstep(0.6, 1, t) * 0.45);
-      if (!C.golden && C.juv && !top) rgb = mix3(rgb, C.white, mot * 0.7);
-      if (!C.golden && C.juv && top) rgb = mix3(rgb, C.white, mot * 0.25 * smoothstep(0.6, 1, t) * hsh(1));
-    }
-    const k = 1 + 0.07 * Math.sin(i * 12.9898 + side * 3.1 + t * 2.1);
-    return { rgb: [rgb[0] * k, rgb[1] * k, rgb[2] * k], gloss: top ? 0.25 : 0.2, irid: 0 };
-  };
-}

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

@@ -1,76 +0,0 @@
-// Eagle (bald eagle Haliaeetus leucocephalus; golden eagle Aquila chrysaetos as `variant: 'golden'`).
-// A soaring raptor on the bird body plan (core/motion/bird.js): upright perching carriage, massive
-// hooked bill under a heavy brow, huge talons, broad plank wings with deeply slotted primaries.
-import { eagleRig, HEAD_O } from './rig.js';
-import { sculptEagle, EYE } from './sculpt.js';
-import { eagleRegions } from './regions.js';
-import { eagleCoat, eagleFeatherColour } from './coat.js';
-import { motion, WING, FEATHERS } from './motion.js';
-import { featherCards } from '../../core/build/featherCards.js';
-import { srgb } from '../../core/build/coatKit.js';
-
-export default {
-  id: 'eagle',
-  name: 'Eagle',
-  latin: 'Haliaeetus leucocephalus',
-  group: 'birds',
-  plan: 'bird',
-  covering: 'feathers',
-  variants: ['bald', 'golden'],
-
-  // Seeded individual. Reversed size dimorphism: females ~25-35 % heavier, ~8-10 % larger linearly.
-  // Age: ~30 % of seeds are juveniles (bald: brown with white mottling, dark head and bill, brown
-  // iris; golden: white tail base with a black band and white wing patches). Individuals differ in
-  // size, bill size, leg length, head size, girth, plumage tone, wear and mottling.
-  variation(R, o) {
-    const g = () => (R() + R() + R() - 1.5) / 1.5;
-    const variant = o.variant === 'golden' ? 'golden' : 'bald';
-    const sex = o.sex || (R() < 0.5 ? 'male' : 'female');
-    const age = o.age || (R() < 0.3 ? 'juvenile' : 'adult');
-    const juv = age === 'juvenile';
-    const size = (sex === 'female' ? 1.04 : 0.94) * (1 + 0.035 * g()) * (variant === 'golden' ? 0.96 : 1);
-    const bill = (sex === 'female' ? 1.03 : 0.98) * (1 + 0.05 * g()) * (variant === 'golden' ? 0.94 : 1);
-    return {
-      sex, age, size, variant,
-      warps: [
-        { type: 'legs', k: 1 + 0.035 * g(), top: 0.24 },
-        // bill length / depth about the bill base (golden eagle: a smaller bill)
-        { type: 'scaleAbout', c: [HEAD_O[0], HEAD_O[1] - 0.012, HEAD_O[2] + 0.045], k: bill, r0: 0.05, r1: 0.1 },
-        { type: 'scaleAbout', c: HEAD_O, k: (1 + 0.03 * g()) * (variant === 'golden' ? 0.95 : 1), r0: 0.06, r1: 0.12 },
-        // (girth: +-3.5 %, juveniles +1 % for their looser plumage - they read heavy at +3 %)
-        { type: 'girth', k: 1 + 0.035 * g() + (juv ? 0.01 : 0), cy: 0.32, z0: -0.14, z1: 0.1, fade: 0.06 },
-      ],
-      wear: Math.max(0, 0.3 * g() + (juv ? 0.35 : 0.1)),
-      warm: 0.5 + 0.5 * g(),
-      mottle: juv ? 0.55 + 0.35 * g() : 0,
-      billAge: juv ? Math.max(0, 0.25 * g()) : 1,
-      goldK: 0.5 + 0.4 * g(),
-      hood: 0.26 + 0.07 * g(), // how far down the neck the white hood reaches
-    };
-  },
-  rig: () => eagleRig(),
-  sculpt: (m, rig, params) => sculptEagle(m, rig, params),
-  regions: eagleRegions,
-  coat: eagleCoat,
-  surfaces: (ctx) => featherCards({ ...ctx, wing: WING, feathers: FEATHERS, tail: { bindFan: 0.2 }, colour: eagleFeatherColour(ctx.params), thickness: 0.0009 }),
-  eyeSpecs: (params) => [1, -1].map((side) => ({ side, spec: EYE, headOrigin: HEAD_O, bone: 'head', look: eyeLook(params) })),
-  motion,
-  render: { markColor: srgb(0x1a140f), strandDensity: 700, clumpDensity: 1.2, shellScale: 1, finWidth: 0.3 },
-};
-
-// Round pupil; bald adult: pale yellow iris; juveniles and golden eagles: brown. Bird lids with a
-// nictitating membrane.
-const EYE_BASE = {
-  pupil: 'round',
-  lids: 'bird',
-  sclera: { visible: false, color: [0.02, 0.02, 0.02] },
-  pupilSize: [0.34, 0.5],
-};
-export function eyeLook(p = {}) {
-  const golden = p.variant === 'golden', juv = p.age === 'juvenile';
-  let iris;
-  if (!golden && !juv) iris = { inner: srgb(0xd9c878), mid: srgb(0xf2e6a0), hi: srgb(0xfaf2c8), outer: srgb(0xa89048) };
-  else if (golden && !juv) iris = { inner: srgb(0x5a3414), mid: srgb(0x8a5a28), hi: srgb(0xb07a3c), outer: srgb(0x3a2410) };
-  else iris = { inner: srgb(0x241408), mid: srgb(0x4a2c14), hi: srgb(0x6a4424), outer: srgb(0x1c1008) };
-  return { ...EYE_BASE, iris, lidColor: golden || juv ? srgb(0x4a3a2a) : srgb(0xc8b070) };
-}

package/vendor/procedural-animals/src/species/eagle/joints.js

@@ -1,3 +0,0 @@
-// Reference-pose joints of the eagle (see rig.js), exported for modules that need fixed landmarks.
-import { eagleJoints } from './rig.js';
-export const J = eagleJoints();

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

@@ -1,137 +0,0 @@
-// Eagle motion data for the bird engine (schema: src/core/motion/bird.js). Numbers are for the
-// reference individual (params.size = 1: ~4.7 kg adult bald eagle, 0.86 m bill to tail, span ~2.1 m);
-// the engine scales them by dynamic similarity.
-//
-// Ground: eagles walk rarely and awkwardly (a rolling, wide-footed waddle with the talons lifted high)
-// and hop with a wing flap to close on prey or reposition [research 4].
-// Flight: soaring and gliding almost all the time (95-100 % flap-gliding, Pennycuick 1990): a few slow
-// deep beats (2.72 Hz at 11.2 m/s, amplitude ~85 deg) then long glides on flat (bald) or slightly
-// raised (golden) wings with the outer primaries splayed into 6-7 upturned fingers; banked thermal
-// circles; take-off with 3-6 heavy beats; landing: long shallow approach, swoop up, body pitched up,
-// wings raised and swept forward for braking beats, tail fanned and depressed, talons thrown forward.
-const G = (name, v, f, D, off, o) => ({ name, v, f, D, off, ...o });
-
-export const WING = {
-  // humerus, ulna, hand (carpometacarpus + digit II) in metres (bald eagle osteometry)
-  lengths: [0.19, 0.22, 0.15],
-  // the wing root frame follows the upright body axis (standing tilt 48, see body.tilt), so the glide
-  // chord and the stroke plane are level when the body is levelled in flight (2 deg short of it, with
-  // glide.pitch 6: the folded / dead wing stays as it was tuned for the ground contact of a fly-death)
-  tilt: 46,
-  // degrees: elev (+ tip up), pitch (+ leading edge up), alpha (humerus, + back), elbow / wrist flexion
-  bind: { elev: -5, pitch: 0, alpha: 50, elbow: 95, wrist: 100, bend: 0, twist: 0 },
-  fold: { elev: -84, pitch: 2, alpha: 100, elbow: 152, wrist: 160, bend: 0, twist: 0 },
-  // soaring glide: long flat "plank" wings, leading edge nearly straight, hand slightly swept back
-  glide: { elev: 3, pitch: 6, alpha: 2, elbow: 18, wrist: 16, bend: 3, twist: 1 },
-  // cruise stroke: slow and deep, flexed upstroke
-  flap: { freq: 2.72, amp: 84, mid: 4, down: 0.56, upFlex: 30, upWrist: 36, sweep: 10, twist: 12 },
-  // take-off / climb / braking beats (heavy, full amplitude; reduced from the research estimate of
-  // ~3.5 Hz / 130 deg so the long primaries stay smooth at 60 fps)
-  power: { freq: 3.2, amp: 98, mid: 6, down: 0.52, upFlex: 46, upWrist: 56, sweep: 16, twist: 16 },
-  // flap-gliding: most of level flight is spent gliding; soaring birds take long glides
-  glideShare: 0.6,
-  soar: 0.8,
-  // soaring: the slotted outer primaries bend up into separate fingers
-  fingerLift: 12,
-  // part-open wings on the ground are carried raised (the long primaries would drag)
-  groundLift: 45,
-  // thick feathered forearm: wrist / tip clearance above the ground
-  skin: 0.04,
-};
-
-// Primaries: 10, p10 short, p5-p10 emarginated (6-7 "fingers" in flight), longest p7-p8.
-// Secondaries + tertials 12 per wing, rectrices 12 (bald: slightly wedge-shaped tail).
-export const FEATHERS = {
-  primaries: [
-    { u: 0.05, len: 0.33, width: 0.066, spread: 78, fold: 8, droop: 0.008 },
-    { u: 0.15, len: 0.345, width: 0.066, spread: 70, fold: 7, droop: 0.008 },
-    { u: 0.26, len: 0.36, width: 0.065, spread: 62, fold: 6, droop: 0.008 },
-    { u: 0.37, len: 0.38, width: 0.064, spread: 54, fold: 5.5, emarg: 0.35, droop: 0.008 },
-    { u: 0.48, len: 0.405, width: 0.062, spread: 46, fold: 5, emarg: 0.8, droop: 0.008 },
-    { u: 0.59, len: 0.43, width: 0.06, spread: 38, fold: 4, emarg: 1, bend: 2, droop: 0.008 },
-    { u: 0.70, len: 0.45, width: 0.058, spread: 30, fold: 3, emarg: 1, bend: 3, droop: 0.008 },
-    { u: 0.80, len: 0.45, width: 0.055, spread: 21, fold: 2, emarg: 1, bend: 4, droop: 0.008 },
-    { u: 0.90, len: 0.43, width: 0.052, spread: 12, fold: 1, emarg: 1, bend: 5, droop: 0.008 },
-    { u: 1.00, len: 0.35, width: 0.046, spread: 3, fold: 0.5, emarg: 1, bend: 5, droop: 0.008 },
-  ],
-  secondaries: [
-    { u: 0.03, len: 0.32, width: 0.072, spread: 84, fold: 144 },
-    { u: 0.11, len: 0.325, width: 0.072, spread: 86, fold: 144 },
-    { u: 0.19, len: 0.325, width: 0.072, spread: 88, fold: 144.5 },
-    { u: 0.27, len: 0.325, width: 0.072, spread: 90, fold: 145 },
-    { u: 0.35, len: 0.322, width: 0.072, spread: 92, fold: 145 },
-    { u: 0.43, len: 0.318, width: 0.072, spread: 94, fold: 145.5 },
-    { u: 0.51, len: 0.312, width: 0.071, spread: 96, fold: 146 },
-    { u: 0.59, len: 0.304, width: 0.07, spread: 99, fold: 146 },
-    { u: 0.67, len: 0.295, width: 0.069, spread: 104, fold: 146.5 },
-    { u: 0.75, len: 0.29, width: 0.068, spread: 112, fold: 147 },
-    { u: 0.84, len: 0.28, width: 0.068, spread: 124, fold: 147.5 },
-    { u: 0.93, len: 0.265, width: 0.068, spread: 140, fold: 148 },
-  ],
-  rectrices: [
-    { x: 0.004, len: 0.31, width: 0.075, fan: 4, fold: 0.5, bend: 0 },
-    { x: 0.008, len: 0.305, width: 0.074, fan: 13, fold: 1, bend: -1 },
-    { x: 0.012, len: 0.298, width: 0.073, fan: 23, fold: 1.5, bend: -2 },
-    { x: 0.016, len: 0.29, width: 0.072, fan: 33, fold: 2, bend: -3 },
-    { x: 0.020, len: 0.28, width: 0.07, fan: 43, fold: 2.5, bend: -4 },
-    { x: 0.024, len: 0.268, width: 0.068, fan: 53, fold: 3, bend: -5 },
-  ],
-  coverts: { primary: 0.32, secondary: 0.46, tail: 0.5 },
-};
-
-// Cruise-flight carriage (bird engine flight.shape; flight photos): the head carried
-// forward and low on an extended neck, in line with the body (bill and tail tip on one line, the belly
-// ~0.06 of the bill-to-tail length below it, the back ~0.12 above), the neck sleeked (cross-section x0.6:
-// ~0.55 of the torso's depth, the throat flush with the breast), the contour plumage sleeked (torso depth x0.82 about a centre 10 cm up on the back: the belly
-// rises toward the back), the thigh and trouser feathers drawn in, the tail fanned into a broad wedge.
-const FLIGHT_SHAPE = { reach: 0.1, drop: 0.5, neck: 0.4, body: [0.95, 1, 0.82], back: 0.1, legs: 0.3, fan: 0.6 };
-
-export const motion = {
-  gears: { walk: 0.4, hop: 1.1, run: 2.2, fly: 11.2 },
-  maxSpeed: 19,
-  ground: { maxSpeed: 3, accel: [1.8, 3], decel: 4, turnRate: 3 },
-  gaits: [
-    // waddling walk: wide feet, big roll toward the stance leg, talons lifted high
-    G('walk', 0.0, 0.8, 0.74, [0, 0.5], { lift: 0.05, bob: 0.008, sway: 0.02, pitch: 0, headBob: 0.25, wings: 0.05, tail: 0.3 }),
-    G('walk', 0.35, 1.0, 0.7, [0, 0.5], { lift: 0.055, bob: 0.01, sway: 0.022, pitch: -4, headBob: 0.25, wings: 0.1, tail: 0.4 }),
-    G('walk', 0.6, 1.2, 0.66, [0, 0.5], { lift: 0.06, bob: 0.012, sway: 0.02, pitch: -8, headBob: 0.2, wings: 0.15, tail: 0.4 }),
-    // hop: both feet together (closing on prey, repositioning)
-    G('hop', 0.9, 1.5, 0.36, [0, 0], { lift: 0.04, bob: 0.006, hop: 0.06, sway: 0, pitch: -14, headBob: 0.1, wings: 0, tail: 0.5 }),
-    G('hop', 1.3, 1.7, 0.34, [0, 0], { lift: 0.045, bob: 0.006, hop: 0.07, sway: 0, pitch: -18, headBob: 0.05, wings: 0, tail: 0.5 }),
-    // run: short alternating take-off run (2-4 steps, 1-3 m/s, 2-3 Hz, duty 0.4-0.5)
-    G('run', 1.7, 2.2, 0.46, [0, 0.5], { lift: 0.05, bob: 0.01, sway: 0.012, pitch: -20, headBob: 0.05, wings: 0, tail: 0.5 }),
-    G('run', 2.8, 2.6, 0.4, [0, 0.5], { lift: 0.055, bob: 0.012, sway: 0.01, pitch: -26, headBob: 0.0, wings: 0, tail: 0.5 }),
-  ],
-  // (hock: the intertarsal joint's skin radius - the feathered cuff and the end of the trousers, ~2 cm)
-  feet: { spread: [0, 20, 0, -22], curl: 10, grip: 1, pad: 0.016, toeClear: 0.0075, sitPad: 0.011, hock: 0.02 },
-  body: { tilt: 48, belly: { y: 0.26, hh: 0.13, hw: 0.2 } },
-  head: { bob: 0.25, yaw: 1.8, pitchUp: 0.5, pitchDown: 1.0, saccade: 1, cock: 0.25, jawRest: 0 },
-  // (flight 2.4: in flight the tail droops ~14 deg below the body axis, its underside continuing the
-  // belly line, as in the flight photos)
-  tail: { pitch: -4, walkBob: 4, sway: 4, flick: 0.5, fanRest: 0.04, soarFan: 0.35, flight: 2.4 },
-  wing: WING,
-  feathers: FEATHERS,
-  flight: {
-    minSpeed: 7, cruise: 11.2, maxSpeed: 19, climb: [2.2, -6], bankMax: 45, turnRate: 1.2,
-    clearance: 3, glideRatio: 12, sustained: true,
-    // legs folded back along the belly, the feet tight under the tail coverts (flight photos)
-    legTuck: { back: 0.82, down: 0.07, side: 0.5 },
-    shape: FLIGHT_SHAPE,
-  },
-  takeoff: { crouch: 0.3, jump: 2.4, angle: 25, beats: 5, open: 0.8 },
-  landing: { approach: 8, flare: 0.8, touch: 1.0 },
-  actions: {
-    attack: { style: 'talons', mantle: 1 },
-    eat: { style: 'tear', rate: 0.8 },
-    drink: {},
-    jump: { height: 0.3, distance: 0.8 },
-    sleep: { style: 'sink' },
-    // preening the breast / shoulder: the upright eagle's breast is well forward of the hips
-    preen: { spot: [0.035, 0.27, 0.19], pitch: 0.9 },
-  },
-  // golden eagle: soars with the wings raised in a shallow V (dihedral); its smaller head projects less
-  // in flight (less than half the tail's length, a field mark against the bald eagle's)
-  variants: {
-    golden: { wing: { glide: { ...WING.glide, elev: 3, bend: 10 } }, flight: { shape: { ...FLIGHT_SHAPE, reach: 0 } } },
-  },
-};

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

@@ -1,57 +0,0 @@
-// Meshing plan: body (incl. wing arms and legs) at 3.2 mm, head + the top of the neck at 1.5 mm
-// (overlapping the body at the cut and cross-faded), eyelid patches at 0.6 mm, and the lower mandible
-// as its own rigid surface so the bill can open. Cells scale with the quality tier (Q.res).
-import { J } from './joints.js';
-import { EYE } from './sculpt.js';
-import { HEAD_O, NECK_SEGS } from './rig.js';
-import { eyeFrameOf } from '../../core/sdf/eyeSocket.js';
-import { lerp, norm, sub, smoothstep } from '../../core/math/vec.js';
-
-export const NECK_CUT = (() => {
-  const d = norm(sub(J.occiput, J['neck' + (NECK_SEGS - 1)]));
-  const c = lerp(J['neck' + (NECK_SEGS - 1)], J.occiput, 0.65);
-  return { c, d, band: 0.008 };
-})();
-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.0205, B: 0.0035, h: 0.0006, 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 eagleRegions(rig, params, Q) {
-  const B = NECK_CUT.band, r = Q.res;
-  const patches = Q.eyePatches ? EYE_PATCH.centres.map((c) => ({ c, R: EYE_PATCH.R, B: EYE_PATCH.B, h: EYE_PATCH.h * Math.max(1, r) })) : [];
-  const [hx, hy, hz] = HEAD_O;
-  const hBody = 0.0038 * r, hHead = 0.0018 * r;
-  // Each surface is cut two of its cells past the far edge of the band, not at the edge: the mesher
-  // keeps a cell by its centre and its vertex may sit ~1.5 cells from there, so at the coarse tiers
-  // (a 16 mm crowd cell vs the +-8 mm band) a cut at the band edge landed on the visible side of the
-  // cross-fade and left an open rim under the head (the head's fade midline is 3 mm below the body's).
-  const cutBody = B + 2 * hBody, cutHead = B + 0.003 + 2 * hHead;
-  return {
-    jobs: [
-      [
-        { name: 'body', part: 'body', bmin: [-0.44, -0.006, -0.28], bmax: [0.44, 0.62, 0.26], h: hBody, F: 4, clip: (x, y, z) => neckS(x, y, z) < cutBody },
-      ],
-      [
-        { name: 'head', part: 'body', bmin: [hx - 0.1, hy - 0.23, hz - 0.18], bmax: [hx + 0.1, hy + 0.06, hz + 0.125], h: hHead, F: 6, clip: (x, y, z) => neckS(x, y, z) > -cutHead, patches },
-        { name: 'jaw', part: 'jaw', bmin: [hx - 0.022, hy - 0.05, hz - 0.02], bmax: [hx + 0.022, hy - 0.015, hz + 0.1], h: 0.0012 * r, F: 6, rigidBone: 'jaw' },
-      ],
-    ],
-    fade(x, y, z, name, patch) {
-      const sN = neckS(x, y, z);
-      if (name === 'body') return 1 - smoothstep(-B, B, sN);
-      if (name === 'head') {
-        // (the head surface reaches 3 mm past the body's cut: the two overlap instead of leaving a
-        // see-through crack where the meshes do not coincide exactly)
-        let f = smoothstep(-B - 0.003, B - 0.003, 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/eagle/rig.js

@@ -1,107 +0,0 @@
-// Eagle skeleton in bind pose (metres). Forward = +Z, up = +Y, the bird's left = +X; ground at y = 0,
-// the feet under the centre of mass at z ~ 0. Reference individual: adult bald eagle, ~4.7 kg,
-// crown ~0.66 m above the feet when standing upright (body axis 48 deg above horizontal, side1 /
-// golden_side1 photos: 45-55 deg), bill tip to tail tip 0.86 m. Bones from raptor osteometry scaled to a 95 mm
-// tarsometatarsus: femur 100, tibiotarsus 160, tarsometatarsus 95 mm; humerus 190, ulna 220,
-// hand 150 mm; long thick toes with huge talons (hallux and inner toe the largest).
-// Wings are bound half open (drooped out to the side) so the arm skin deforms evenly toward both the
-// folded and the spread wing; the flight feathers are separate bones (see core/rig/bird.js).
-import { buildRig } from '../../core/rig/rig.js';
-import { birdBones, birdLimbs, neckChain, wingJoints, featherJoints } from '../../core/rig/bird.js';
-import { WING, FEATHERS } from './motion.js';
-
-export const NECK_SEGS = 4;
-export const TILT = 48; // standing body axis above horizontal (deg)
-export const HEAD_O = [0, 0.595, 0.205]; // head-local origin: between the eyes
-
-const n2 = (y, z) => { const l = Math.hypot(y, z); return [0, y / l, z / l]; };
-// body-axis frame: a along the axis (forward-up), b dorsal
-const ct = Math.cos((TILT * Math.PI) / 180), st = Math.sin((TILT * Math.PI) / 180);
-export const SYN = [0, 0.285, -0.03];
-export const AX = (a, b, x = 0) => [x, SYN[1] + a * st + b * ct, SYN[2] + a * ct - b * st];
-export const U_AX = [0, st, ct];
-export const V_AX = [0, ct, -st];
-
-// leg bones (m): femur, tibiotarsus (the tarsometatarsus is ankle -> MTP)
-const FEMUR = 0.098, TIBIA = 0.1595;
-// knee of a hip -> knee -> ankle chain with the given lengths, bent toward `pole`
-function kneeOf(hip, ankle, l1, l2, pole) {
-  const d = [ankle[0] - hip[0], ankle[1] - hip[1], ankle[2] - hip[2]], L = Math.hypot(...d);
-  const e1 = d.map((v) => v / L), pd = pole[0] * e1[0] + pole[1] * e1[1] + pole[2] * e1[2];
-  let e2 = pole.map((v, i) => v - pd * e1[i]);
-  const l = Math.hypot(...e2);
-  e2 = e2.map((v) => v / l);
-  const c = (l1 * l1 + L * L - l2 * l2) / (2 * l1 * L), sn = Math.sqrt(Math.max(0, 1 - c * c));
-  return hip.map((h, i) => h + e1[i] * l1 * c + e2[i] * l1 * sn);
-}
-
-export function eagleJoints() {
-  const hl = (x, y, z) => [HEAD_O[0] + x, HEAD_O[1] + y, HEAD_O[2] + z];
-  const J = {
-    synsacrum: SYN,
-    tailBase: AX(-0.06, 0.05),
-    tailTip: null,
-    neckBase: AX(0.19, -0.03),
-    occiput: hl(0, -0.026, -0.058),
-    bill: hl(0, -0.046, 0.109),
-    jawHinge: hl(0, -0.027, -0.002),
-    jawTip: hl(0, -0.04, 0.094),
-    // the shoulder at the front of the thorax, level with the neck's root (flight photos: the wing's
-    // leading edge meets the body right behind the white hood)
-    shoulderL: AX(0.2, 0.045, 0.056),
-    // the hip (acetabulum) high in the body, ~6 cm under the back; the knee hidden in the flank
-    // feathers (solved below from the femur and tibiotarsus lengths)
-    hipL: AX(0, 0.015, 0.055),
-    ankleL: [0.064, 0.108, -0.03],
-    mtpL: [0.05, 0.016, 0.0],
-  };
-  // the tail points 38 deg below the horizontal standing (10 deg above the body axis; in flight it
-  // droops below the body axis, see motion tail.flight)
-  J.tailTip = [0, J.tailBase[1] - 0.042 * Math.sin(38 * Math.PI / 180), J.tailBase[2] - 0.042 * Math.cos(38 * Math.PI / 180)];
-  J.kneeL = kneeOf(J.hipL, J.ankleL, FEMUR, TIBIA, [0, 0, 1]);
-  // toes: III (middle) forward, II inner, IV outer, I (hallux) back; two segments each (phalanges +
-  // talon in the distal one), lying on the ground
-  const toe = (j, yawDeg, a, b, back = false) => {
-    const y = (yawDeg * Math.PI) / 180, m = J.mtpL;
-    const dir = back ? [Math.sin(y), 0, -Math.cos(y)] : [Math.sin(y), 0, Math.cos(y)];
-    J[`t${j}mL`] = [m[0] + dir[0] * a, 0.011, m[2] + dir[2] * a];
-    J[`t${j}tL`] = [m[0] + dir[0] * (a + b), 0.0085, m[2] + dir[2] * (a + b)];
-  };
-  toe(3, 3, 0.046, 0.05);
-  toe(2, -24, 0.036, 0.048);
-  toe(4, 28, 0.037, 0.04);
-  toe(1, -8, 0.03, 0.05, true);
-  neckChain(J, NECK_SEGS, n2(1, 0.15), n2(1, 0.7), 0.35);
-  wingJoints(J, WING);
-  featherJoints(J, WING, FEATHERS, { bindFan: 0.2 });
-  return J;
-}
-
-export function eagleRig() {
-  const J = eagleJoints();
-  const neck = Array.from({ length: NECK_SEGS - 1 }, (_, i) => 'neck' + (NECK_SEGS - 1 - i));
-  const neckBones = Array.from({ length: NECK_SEGS }, (_, i) => 'neck' + (NECK_SEGS - 1 - i));
-  return buildRig({
-    joints: J,
-    unit: 0.5,
-    headOrigin: HEAD_O,
-    bones: birdBones({ neckSegs: NECK_SEGS, jaw: true, primaries: FEATHERS.primaries.length, secondaries: FEATHERS.secondaries.length, rectrices: FEATHERS.rectrices.length }),
-    axial: {
-      points: ['bill', 'occiput', ...neck, 'neckBase', 'synsacrum', 'tailBase', 'tailTip'],
-      bones: ['head', ...neckBones, 'chest', 'pelvis', 'tail'],
-      // wide blends along the thick feathered neck (see the crow): the skull's influence runs down the
-      // neck and the neck base blends into the breast
-      blend: Object.fromEntries([
-        [1, [-0.2, 0.1]],
-        ...Array.from({ length: NECK_SEGS - 1 }, (_, k) => [2 + k, [-0.03, 0.03]]),
-        [1 + NECK_SEGS, [-0.45, 0.03]],
-      ]),
-    },
-    limbs: birdLimbs({
-      leg: { tCore: 0.95, aCore: 0.07, aBody: -0.05, midX: 0.012 },
-      wing: { tCore: 0.4, aCore: 0.16, aBody: -0.24, midX: 0.02 },
-    }),
-    appendages: [],
-    webTags: ['flankfold', 'scapular'],
-  });
-}