@bitefoundry/retrieviewer 0.0.3 → 0.0.5

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

@@ -1,341 +0,0 @@
-// The brown rat's coat: coarse agouti fur (grey base, buff band, black tip; long sparse dark guard
-// hairs on the back), countershaded to a grey-buff belly with a fairly sharp flank line; short sleek
-// fur on the face; nearly bare pink-brown ears (skin with a haze of fine hair); pink feet (bare skin,
-// sparse pale hair on top, keratin claws); the long tail as ring scales (material 6 scutes across the
-// tail axis), dark above, paler below; pink nose leather; yellow-orange incisors.
-// Colour variants: agouti (wild), dark (urban melanic), albino (white, pink skin), hooded (black hood
-// over head and shoulders plus a dorsal stripe on white, grown as a pattern SDF on the surface).
-// Works in the reference space of rig.js; colours sampled from the reference photos.
-import { HEAD_O, HK } from './rig.js';
-import { neckS } from './regions.js';
-import { SDFModel } from '../../core/sdf/sdf.js';
-import { norm, sub, dot, cross, len, add, mul, smoothstep, clamp, mix, fbm3 } from '../../core/math/vec.js';
-import { srgb, mix3, MAT } from '../../core/build/coatKit.js';
-
-// palette per colour variant (sRGB hex, literature + photo samples)
-const PALETTES = {
-  agouti: {
-    back: 0x615446, flank: 0x5a4f45, low: 0x756b61, belly: 0xa39a8c, head: 0x605244, cheek: 0x6b5e50,
-    muzzle: 0x716558, earSkin: 0xa07c6e, earIn: 0xb88c80, feet: 0xcfaea2, tailTop: 0x4a3e38, tailUnder: 0x7e6e66,
-    nose: 0xb9868a, claw: 0xd8c8b4, agouti: 0.95, undercoat: 0.55,
-  },
-  dark: {
-    back: 0x3e3833, flank: 0x3a3430, low: 0x4a433d, belly: 0x7a746c, head: 0x3c3632, cheek: 0x423b36,
-    muzzle: 0x4a423c, earSkin: 0x6e5a56, earIn: 0x86706a, feet: 0xb89a92, tailTop: 0x36302c, tailUnder: 0x5a504a,
-    nose: 0x9a7276, claw: 0xc8b8a8, agouti: 0.45, undercoat: 0.35,
-  },
-  albino: {
-    back: 0xf0ece4, flank: 0xf2eee6, low: 0xf2eee8, belly: 0xf5f2ec, head: 0xf2eee6, cheek: 0xf4f0ea,
-    muzzle: 0xf4efe8, earSkin: 0xe8b9b0, earIn: 0xeab4ac, feet: 0xebbfb6, tailTop: 0xe4b8ae, tailUnder: 0xe8c2b8,
-    nose: 0xeaafaf, claw: 0xf0e6dc, agouti: 0.0, undercoat: 0.1,
-  },
-  hooded: {
-    // base white; the hood / stripe colour is the pattern colour
-    back: 0xf0ede6, flank: 0xf0ede6, low: 0xf2efe8, belly: 0xf2efe8, head: 0xf0ede6, cheek: 0xf0ede6,
-    muzzle: 0xf2eee8, earSkin: 0xa88480, earIn: 0xc49a94, feet: 0xebbfb6, tailTop: 0x8a7872, tailUnder: 0xd8b4aa,
-    nose: 0xd89a9a, claw: 0xf0e6dc, agouti: 0.0, undercoat: 0.15,
-  },
-};
-const HOOD = 0x221e1e;
-
-function coatColours(p) {
-  const base = PALETTES[p.colour] || PALETTES.agouti;
-  const k = p.coatWarmth || 0, l = p.coatLightness || 0;
-  const fixed = ['belly', 'earSkin', 'earIn', 'feet', 'nose', 'claw', 'tailUnder'];
-  const tweak = (h) => { const c = srgb(h); return [c[0] * (1 + 0.12 * k + l), c[1] * (1 + 0.03 * k + l), c[2] * (1 - 0.12 * k + l)]; };
-  const C = {};
-  for (const [key, v] of Object.entries(base)) {
-    if (key === 'agouti' || key === 'undercoat') C[key] = v;
-    else C[key] = p.colour === 'albino' || p.colour === 'hooded' || fixed.includes(key) ? srgb(v) : tweak(v);
-  }
-  // juveniles: softer, greyer (less rufous) fur
-  if (p.juv && p.colour !== 'albino' && p.colour !== 'hooded') for (const key of ['back', 'flank', 'low', 'head', 'cheek']) { const c = C[key], g = (c[0] + c[1] + c[2]) / 3; C[key] = mix3(c, [g, g, g * 1.03], 0.35); }
-  return C;
-}
-
-export function ratCoat(ctx) {
-  const { model, rig, pos, nrm, regionOf: partOf, regionNames, weights, nV, params } = ctx;
-  const { BONES, AXIAL } = rig;
-  const COL = coatColours(params);
-  const { dominant, axialS, skinIndex, skinWeight, limbMember } = weights;
-  const AX = weights.axialLengths;
-  const P = (v) => [pos[v * 3], pos[v * 3 + 1], pos[v * 3 + 2]];
-  const N = (v) => [nrm[v * 3], nrm[v * 3 + 1], nrm[v * 3 + 2]];
-  const sOcc = AX[1], sNeckBase = AX[3], sTailBase = AX[8];
-  const isLimb = BONES.map((b) => /^(scapula|humerus|radius|metacarpus|fpaw|femur|tibia|metatarsus|hpaw)/.test(b.name));
-  const isFoot = BONES.map((b) => /^(fpaw|hpaw|metacarpus|metatarsus)/.test(b.name));
-  const eyePrims = model.prims.filter((p) => p.tag === 'eyesocket');
-  const nosePrim = model.prims.find((p) => p.tag === 'nose');
-  const cleftPrim = model.prims.find((p) => p.tag === 'lipcleft');
-  const earPrims = model.prims.filter((p) => p.tag === 'ear');
-  const clawPrims = model.prims.filter((p) => p.tag === 'claw');
-  const jawPrims = model.forPart('jaw');
-  const headPrims = model.forPart('body').filter((p) => (p.bone === 'head' || p.bone === 'snout') && !p.carve);
-  const hooded = params.colour === 'hooded';
-  const albino = params.colour === 'albino';
-  const teethPart = regionNames.map((n) => n === 'uteeth' || n === 'lteeth');
-  const jawPart = regionNames.map((n) => n === 'jaw');
-  const headPart = regionNames.map((n) => n === 'head');
-
-  const region = new Uint8Array(nV); // 0 torso, 1 neck, 2 head, 3 teeth, 4 tail, 5 ear, 6 jaw, 7 snout
-  const legness = new Float32Array(nV);
-  const legBone = new Int16Array(nV).fill(-1);
-  for (let v = 0; v < nV; v++) {
-    const bn = BONES[dominant[v]].name;
-    const p = P(v);
-    let lb = -1, lw = 0;
-    for (let k = 0; k < 4; k++) {
-      const b = skinIndex[v * 4 + k], w = skinWeight[v * 4 + k];
-      if (isLimb[b] && w > lw) { lw = w; lb = b; }
-    }
-    legBone[v] = lb;
-    legness[v] = lb >= 0 ? smoothstep(0.15, 0.85, limbMember[v]) : 0;
-    if (teethPart[partOf[v]]) region[v] = 3;
-    else if (jawPart[partOf[v]]) region[v] = 6;
-    else if (bn.startsWith('ear')) region[v] = 5;
-    else if (bn === 'snout') region[v] = 7;
-    else if (axialS[v] > sTailBase + 0.003 && bn.startsWith('tail')) region[v] = 4;
-    else if (axialS[v] < sOcc + 0.002 || (headPart[partOf[v]] && neckS(p[0], p[1], p[2]) > 0.006)) region[v] = 2;
-    else if (axialS[v] < sNeckBase) region[v] = 1;
-    else region[v] = 0;
-    if (region[v] === 2 || region[v] >= 3) legness[v] = 0;
-  }
-
-  // hooded pattern: signed distance (m, < 0 = coloured) of the hood (head, neck, shoulders and chest
-  // down to the elbows) and the dorsal stripe to the tail root
-  const hoodSDF = (p, n, r, v) => {
-    if (r === 2 || r === 5 || r === 6 || r === 7) {
-      // an optional blaze: a white wedge up the face from the nose (the berkshire / blazed fancy)
-      if (params.blaze) {
-        const h = mul(sub(p, HEAD_O), 1 / HK);
-        const b = Math.abs(h[0]) - (0.0012 + 0.16 * Math.max(0, h[2] + 0.012)) * params.blaze;
-        if (h[1] > -0.02) return clamp(-b, -0.004, 0.004) * (h[2] > -0.014 ? 1 : -1) - (h[2] > -0.014 ? 0 : 0.004);
-      }
-      return -0.006;
-    }
-    if (r === 4) return 0.006;
-    // hood: behind the ears to the shoulders, slanting back over the withers
-    const zc = 0.004 + 0.3 * (p[1] - 0.04) + 0.0012 * Math.sin(p[0] * 700);
-    let d = zc - p[2];
-    // the forelegs below the elbow stay white
-    if (legness[v] > 0.5 && legBone[v] >= 0 && /radius|metacarpus|fpaw/.test(BONES[legBone[v]].name)) d = Math.max(d, 0.003);
-    // the belly behind the chest stays white
-    if (n[1] < -0.3) d = Math.max(d, -0.002 + (0.03 - p[1]) * 0.4);
-    // dorsal stripe: ~16 mm wide down the back to the tail root, a little ragged
-    const w = 0.0085 * (1 + 0.15 * Math.sin(p[2] * 180)) * smoothstep(-0.095, -0.075, p[2]) + 0.002;
-    const up = smoothstep(0.1, 0.5, n[1]);
-    const stripe = up > 0 ? Math.abs(p[0]) - w * up : 0.01;
-    d = Math.min(d, stripe);
-    return clamp(d, -0.006, 0.006);
-  };
-
-  const comb = new Float32Array(nV * 3);
-  const tint = new Float32Array(nV * 4);
-  const furLen = new Float32Array(nV);
-  const markSDF = new Float32Array(nV).fill(1);
-  const pattern = new Float32Array(nV).fill(1);
-  const patternColor = new Float32Array(nV * 4);
-  const surf = new Float32Array(nV * 4);
-  const hoodC = srgb(params.hoodColour || HOOD);
-  const tooth = srgb(0xd4a050), toothTip = srgb(0xeed8a8);
-  const juvK = params.juv ? 0.75 : 1;
-
-  for (let v = 0; v < nV; v++) {
-    const p = P(v), n = N(v), r = region[v];
-    const h = mul(sub(p, HEAD_O), 1 / HK);
-    const bone = BONES[dominant[v]];
-    const L = legness[v];
-    let col, fl, mat = MAT.FUR, mark = 1, ag = COL.agouti, uc = COL.undercoat, gloss = 0, feat = 0, sz = 0;
-
-    // ---- comb
-    let d;
-    if (r === 5) d = norm(sub(bone.tail, bone.head));
-    else if (r === 2 || r === 6 || r === 7 || r === 3) d = norm(add(norm(sub(h, [0, -0.008, 0.026])), [0, -0.1, -0.5]));
-    else if (r === 4) d = norm(sub(bone.tail, bone.head));
-    else {
-      const seg = weights.segT[v * 2] | 0;
-      const a = AXIAL.points[seg], b = AXIAL.points[Math.min(seg + 1, AXIAL.points.length - 1)];
-      d = norm(add(norm(sub(b, a)), [0, -0.5 * Math.abs(n[0]), 0]));
-      if (L > 0 && legBone[v] >= 0) {
-        const lbn = BONES[legBone[v]];
-        let dl = norm(sub(lbn.tail, lbn.head));
-        if (isFoot[legBone[v]]) dl = norm(add(dl, [0, 0, 0.4]));
-        else dl = norm(add(dl, [0, -0.3, -0.2]));
-        d = norm(add(mul(d, 1 - L), mul(dl, L)));
-      }
-    }
-    let t = sub(d, mul(n, dot(d, n)));
-    if (len(t) < 1e-4) t = cross(n, [1, 0, 0]);
-    t = norm(t);
-    comb[v * 3] = t[0]; comb[v * 3 + 1] = t[1]; comb[v * 3 + 2] = t[2];
-
-    // ---- colour, fur length, marks
-    if (r === 3) {
-      // incisors: orange-yellow enamel on the front face, paler toward the chisel tip
-      mat = MAT.KERATIN; fl = 0; gloss = 0.8;
-      const tipK = partOf[v] >= 0 && regionNames[partOf[v]] === 'uteeth' ? smoothstep(-0.016, -0.019, h[1]) : smoothstep(-0.019, -0.0165, h[1]);
-      col = albino ? mix3(tooth, toothTip, 0.5) : mix3(tooth, toothTip, tipK * 0.6);
-    } else if (r === 0 || r === 1) {
-      const up = clamp(n[1], -1, 1);
-      col = mix3(COL.low, COL.flank, smoothstep(-0.35, 0.2, up));
-      col = mix3(col, COL.back, smoothstep(0.25, 0.85, up));
-      // belly: grey-buff, a fairly sharp flank line (blended by normal and height)
-      const ventral = smoothstep(-0.2, -0.55, n[1]) * smoothstep(0.045, 0.02, p[1]);
-      const chest = smoothstep(0.0, 0.03, p[2]) * smoothstep(0.2, 0.6, n[2]) * smoothstep(0.045, 0.02, p[1]);
-      col = mix3(col, COL.belly, clamp(Math.max(ventral, chest * 0.8, smoothstep(0.4, 0.8, -n[1])), 0, 1));
-      // coarse coat: long dorsal guard hairs, shorter on the flanks, dense short belly fur
-      fl = mix(0.0068, 0.0095, smoothstep(-0.4, 0.3, n[1]));
-      fl = Math.max(fl, 0.0115 * smoothstep(0.5, 0.95, n[1]) * smoothstep(0.02, -0.02, p[2]) + 0.0098 * smoothstep(0.5, 0.95, n[1]) * smoothstep(-0.02, 0.02, p[2])); // longest over the loins
-      fl = mix(fl, 0.0055, smoothstep(-0.3, -0.8, n[1]));
-      ag *= 1 - smoothstep(0.1, 0.6, -n[1]);
-      if (L > 0) {
-        const lb = legBone[v] >= 0 ? BONES[legBone[v]].name : '';
-        let lc = mix3(COL.flank, COL.belly, smoothstep(0.0, -0.8, n[0] * Math.sign(p[0] || 1)) * 0.6), lf = mix(0.003, 0.006, smoothstep(0.01, 0.04, p[1]));
-        if (isFoot[legBone[v]] && p[1] < 0.013) {
-          // pink feet: bare skin, sparse short pale hair on the top of the foot
-          lc = COL.feet; lf = 0; mat = MAT.SKIN; gloss = 0.25;
-        } else if (/radius|tibia/.test(lb)) {
-          // lower legs: short fur, pinkish skin showing near the wrist and the heel
-          const sk = smoothstep(0.016, 0.006, p[1]);
-          lc = mix3(mix3(COL.flank, COL.belly, 0.35), COL.feet, sk * 0.6); lf = mix(0.0035, 0.0016, sk);
-        }
-        if (/femur/.test(lb)) { lc = mix3(col, lc, smoothstep(0.035, 0.015, p[1])); lf = mix(fl, lf, 0.4); }
-        col = mix3(col, lc, L);
-        fl = mix(fl, lf, L);
-        if (mat === MAT.SKIN) { col = COL.feet; fl = lf; }
-        ag *= 1 - 0.8 * L * (/radius|tibia|metacarpus|fpaw|metatarsus|hpaw/.test(lb) ? 1 : 0);
-        // claws: pale keratin
-        for (const c of clawPrims) if (SDFModel.dist(c, p[0], p[1], p[2]) < 0.00025) { mat = MAT.KERATIN; col = COL.claw; fl = 0; gloss = 0.7; }
-        // soles: the bare pads, a little darker and glossier
-        if (mat === MAT.SKIN && n[1] < -0.5) { col = mix3(col, [col[0] * 0.85, col[1] * 0.78, col[2] * 0.78], 0.6); fl = 0; gloss = 0.4; }
-      }
-      // the anus / scrotum region: short sparse hair
-      if (p[2] < -0.078 && p[1] < 0.045 && n[2] < -0.3) fl = Math.min(fl, 0.004);
-    } else if (r === 4) {
-      // tail: ring scales (scutes across the tail axis, ~1 mm), dark above, paler below, a little
-      // paler toward the tip; sparse short bristles are the scute relief
-      const bb = BONES[dominant[v]];
-      const ax = norm(sub(bb.tail, bb.head));
-      const dorsal = norm(cross([1, 0, 0], ax));
-      const top = dot(n, dorsal);
-      const along = clamp((axialS[v] - sTailBase) / Math.max(1e-4, AX[AX.length - 1] - sTailBase), 0, 1);
-      col = mix3(COL.tailUnder, COL.tailTop, smoothstep(-0.45, 0.35, top));
-      col = mix3(col, COL.tailUnder, 0.25 * along);
-      mat = MAT.SCALES; fl = 0; gloss = 0.3;
-      sz = 0.00095 * (1 - 0.35 * along) * juvK;
-      feat = -1; // scutes: rings across the comb
-      // the fur of the rump runs a little way onto the tail root
-      if (axialS[v] < sTailBase + 0.009) { mat = MAT.FUR; col = mix3(COL.flank, COL.tailTop, 0.4); fl = 0.004; sz = 0; feat = 0; }
-    } else if (r === 5) {
-      // ears: thin, nearly bare skin (fine short hair haze), pinker in the cup, a darker rim
-      const side = p[0] >= 0 ? 0 : 1;
-      const ep = earPrims[side];
-      const face = [ep.P[9], ep.P[10], ep.P[11]];
-      const upE = [ep.P[6], ep.P[7], ep.P[8]], latE = [ep.P[3], ep.P[4], ep.P[5]];
-      const c = [ep.P[0], ep.P[1], ep.P[2]];
-      const q = sub(p, c);
-      const along = dot(q, upE) / ep.P[13], across = dot(q, latE) / ep.P[12];
-      const rim = 1 - Math.hypot(along, across);
-      const inner = smoothstep(0.0, 0.4, dot(n, face)) * smoothstep(0.02, 0.12, rim);
-      col = mix3(COL.earSkin, COL.earIn, inner);
-      mat = MAT.FUR; gloss = 0;
-      fl = 0.0004;
-      // the ear root is furred like the head
-      const root = smoothstep(-0.2, -0.75, along);
-      if (root > 0) { col = mix3(col, COL.head, root); fl = mix(fl, 0.003, root); }
-      ag = 0; uc = 0.6;
-    } else {
-      // head, snout and jaw: short sleek fur, paler on the lips and chin
-      col = COL.head;
-      const g3 = (cc, rr) => Math.exp(-(((Math.abs(h[0]) - cc[0]) / rr[0]) ** 2 + ((h[1] - cc[1]) / rr[1]) ** 2 + ((h[2] - cc[2]) / rr[2]) ** 2));
-      col = mix3(col, COL.cheek, g3([0.009, -0.01, -0.006], [0.005, 0.006, 0.01]));
-      col = mix3(col, COL.muzzle, smoothstep(0.004, 0.018, h[2]) * 0.8);
-      const chinW = r === 6 ? 0.7 : smoothstep(-0.015, -0.019, h[1]) * smoothstep(-0.2, -0.7, n[1]);
-      col = mix3(col, COL.belly, clamp(chinW, 0, 1) * 0.8);
-      fl = mix(0.0045, 0.0018, smoothstep(-0.01, 0.02, h[2]));
-      if (Math.abs(h[0]) > 0.008 && h[1] < -0.004 && h[2] < 0.004) fl = Math.max(fl, 0.0048); // cheek fur
-      if (h[2] < -0.02) fl = mix(fl, 0.0068, smoothstep(-0.02, -0.03, h[2])); // nape
-      ag *= 0.75;
-      // eye rims: dark bare lid margin
-      for (const e of eyePrims) {
-        const de = SDFModel.dist(e, p[0], p[1], p[2]);
-        if (Math.abs(de) < 0.0008) mark = Math.min(mark, Math.abs(de) - 0.0003);
-        if (Math.abs(de) < 0.0003) { mat = MAT.DARK_SKIN; fl = 0; }
-        else fl = Math.min(fl, mix(0.0004, fl, smoothstep(0.0009, 0.0045, Math.abs(de))));
-      }
-      // nose leather (pink rhinarium) and the split upper lip
-      if (nosePrim && SDFModel.dist(nosePrim, p[0], p[1], p[2]) < 0.00035 && h[2] > 0.0205 && h[1] > -0.0145) { mat = MAT.SKIN; col = COL.nose; fl = 0; gloss = 0.65; }
-      if (cleftPrim) {
-        const dc = SDFModel.dist(cleftPrim, p[0], p[1], p[2]);
-        if (dc < 0.0005) { mark = Math.min(mark, dc - 0.0003); fl = Math.min(fl, 0.0004); }
-      }
-      if (r === 7) fl = Math.min(fl, 0.0022); // whisker pads: short dense fur
-      // lips / mouth lining: head vertices touching the jaw surface, jaw vertices inside the head
-      if (partOf[v] >= 0 && !jawPart[partOf[v]]) {
-        const dj = SDFModel.evalList(jawPrims, p[0], p[1], p[2]);
-        if (dj < 0.00025) { mat = MAT.MOUTH; col = [0.3, 0.12, 0.12]; fl = 0; }
-      } else {
-        const dh = SDFModel.evalList(headPrims, p[0], p[1], p[2]);
-        if (dh < 0.0) { mat = MAT.MOUTH; col = [0.3, 0.12, 0.12]; fl = 0; }
-      }
-    }
-    if (params.juv && mat === MAT.FUR) fl *= 0.8;
-
-    // ---- hooded: hood and dorsal stripe (pattern SDF, crisp but hair-ragged edges)
-    if (hooded && (mat === MAT.FUR || mat === MAT.DARK_SKIN)) pattern[v] = hoodSDF(p, n, r, v);
-
-    // low-frequency colour variation
-    const cv = fbm3(p[0] * 90, p[1] * 90, p[2] * 90, 3) - 0.5;
-    if (mat === MAT.FUR) col = [col[0] * (1 + 0.16 * cv), col[1] * (1 + 0.13 * cv), col[2] * (1 + 0.1 * cv)];
-
-    tint[v * 4] = col[0]; tint[v * 4 + 1] = col[1]; tint[v * 4 + 2] = col[2]; tint[v * 4 + 3] = mat;
-    furLen[v] = mat === MAT.FUR || mat === MAT.SKIN ? fl : 0;
-    markSDF[v] = mark;
-    patternColor[v * 4] = hoodC[0]; patternColor[v * 4 + 1] = hoodC[1]; patternColor[v * 4 + 2] = hoodC[2]; patternColor[v * 4 + 3] = hooded ? 1 : 0;
-    if (mat === MAT.SCALES) { surf[v * 4] = gloss; surf[v * 4 + 1] = sz; surf[v * 4 + 2] = feat; surf[v * 4 + 3] = -0.4; }
-    else { surf[v * 4] = gloss; surf[v * 4 + 1] = 0; surf[v * 4 + 2] = mat === MAT.FUR ? clamp(ag, 0, 1) : 0; surf[v * 4 + 3] = mat === MAT.FUR ? uc : 0; }
-  }
-
-  // smooth fur length, agouti banding and colour across the fur so region boundaries (head / neck,
-  // body / legs) never show as a line in the coat
-  const nb = weights.neighbors;
-  const tmp = new Float32Array(nV), tmpA = new Float32Array(nV), tmpC = new Float32Array(nV * 3);
-  for (let it = 0; it < 8; it++) {
-    for (let v = 0; v < nV; v++) {
-      const ns = nb[v];
-      tmp[v] = furLen[v]; tmpA[v] = surf[v * 4 + 2];
-      tmpC[v * 3] = tint[v * 4]; tmpC[v * 3 + 1] = tint[v * 4 + 1]; tmpC[v * 3 + 2] = tint[v * 4 + 2];
-      if (!ns || !ns.length || tint[v * 4 + 3] !== MAT.FUR) continue;
-      let a = 0, g = 0, n = 0, c0 = 0, c1 = 0, c2 = 0;
-      for (const q of ns) {
-        if (tint[q * 4 + 3] !== MAT.FUR) continue;
-        a += furLen[q]; g += surf[q * 4 + 2]; c0 += tint[q * 4]; c1 += tint[q * 4 + 1]; c2 += tint[q * 4 + 2]; n++;
-      }
-      if (!n) continue;
-      tmp[v] = 0.5 * furLen[v] + (0.5 * a) / n;
-      tmpA[v] = 0.5 * surf[v * 4 + 2] + (0.5 * g) / n;
-      if (it < 3) { tmpC[v * 3] = 0.5 * tint[v * 4] + 0.5 * c0 / n; tmpC[v * 3 + 1] = 0.5 * tint[v * 4 + 1] + 0.5 * c1 / n; tmpC[v * 3 + 2] = 0.5 * tint[v * 4 + 2] + 0.5 * c2 / n; }
-    }
-    furLen.set(tmp);
-    for (let v = 0; v < nV; v++) { surf[v * 4 + 2] = tmpA[v]; tint[v * 4] = tmpC[v * 3]; tint[v * 4 + 1] = tmpC[v * 3 + 1]; tint[v * 4 + 2] = tmpC[v * 3 + 2]; }
-  }
-  // smooth the hair flow (the axial segment directions change at the joints: no seams in the coat)
-  const cb = new Float32Array(nV * 3);
-  for (let it = 0; it < 6; it++) {
-    for (let v = 0; v < nV; v++) {
-      const ns = nb[v];
-      let x = comb[v * 3], y = comb[v * 3 + 1], z = comb[v * 3 + 2];
-      if (ns && ns.length && tint[v * 4 + 3] === MAT.FUR && region[v] !== 5) {
-        for (const q of ns) { if ((region[q] <= 1 ? 0 : region[q]) !== (region[v] <= 1 ? 0 : region[v])) continue; x += comb[q * 3]; y += comb[q * 3 + 1]; z += comb[q * 3 + 2]; }
-        const nx = nrm[v * 3], ny = nrm[v * 3 + 1], nz = nrm[v * 3 + 2];
-        const dn = x * nx + y * ny + z * nz;
-        x -= dn * nx; y -= dn * ny; z -= dn * nz;
-        const l = Math.hypot(x, y, z) || 1;
-        x /= l; y /= l; z /= l;
-      }
-      cb[v * 3] = x; cb[v * 3 + 1] = y; cb[v * 3 + 2] = z;
-    }
-    comb.set(cb);
-  }
-  return { comb, tint, pattern, mark: markSDF, furLen, patternColor, surf, region };
-}

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

@@ -1,111 +0,0 @@
-// Brown rat (Rattus norvegicus). A small plantigrade quadruped on the rabbit / bear templates: a
-// hunched pear-shaped body, pointed snout with whiskers (real geometry) and yellow incisors, dark
-// bulging eyes, thin rounded ears, pink hands and feet with separate toes, and a long scaly tail.
-// Colours are variants (createAnimal('rat', { variant: 'hooded' })): 'wild' (default: agouti, ~15 %
-// of seeds the dark urban form), 'agouti', 'dark', 'albino' (white, pink skin, red eyes), 'hooded'
-// (fancy: black hood and dorsal stripe on white, sometimes a blaze); pups with { age: 'juvenile' }.
-import { ratRig, HEAD_O, hl } from './rig.js';
-import { sculptRat, eyeOf } from './sculpt.js';
-import { ratRegions } from './regions.js';
-import { ratCoat } from './coat.js';
-import { ratWhiskers } from './whiskers.js';
-import { motion } from './motion.js';
-import { rng } from '../../core/math/vec.js';
-
-const VARIANTS = [
-  ['wild', 'Wild brown rat'],
-  ['agouti', 'Agouti'],
-  ['dark', 'Dark (urban)'],
-  ['albino', 'Albino (PEW)'],
-  ['hooded', 'Hooded (fancy)'],
-];
-
-// Seeded individual. Size: males 350-500 g, females 250-350 g (length ~ mass^1/3 against the
-// ~330 g reference); juveniles (~4-5 weeks, ~70 g): 0.6 x, big head, eyes, ears and feet, shorter
-// tail. Proportions per seed: legs, body length, girth, head width, muzzle, ears, tail length.
-function variation(R, o) {
-  const g = () => (R() + R() + R() - 1.5) / 1.5; // ~[-1, 1], peaked
-  // the coat from its own hashed stream so consecutive seeds do not correlate
-  const M = rng(Math.imul((o.seed ?? 1) + 0x5bd1e995, 0x297a2d39) ^ 0x1b873593);
-  for (let i = 0; i < 3; i++) M();
-  let variant = o.variant && VARIANTS.some((v) => v[0] === o.variant) ? o.variant : 'wild';
-  const colour = variant === 'wild' ? (M() < 0.15 ? 'dark' : 'agouti') : variant;
-  const sex = o.sex || (R() < 0.5 ? 'male' : 'female');
-  const age = o.age || 'adult';
-  const juv = age === 'juvenile' ? 1 : 0;
-  const male = sex === 'male' ? 1 : 0;
-  const fancy = colour === 'albino' || colour === 'hooded';
-  const size = (male ? 1.07 : 0.965) * (1 + 0.045 * g()) * (juv ? 0.6 : 1);
-  const head = (male ? 1.03 : 0.99) * (1 + 0.025 * g()) * (juv ? 1.22 : 1);
-  const params = {
-    sex, age, size, variant, colour, juv,
-    tail: (1 + 0.05 * g()) * (juv ? 0.86 : 1),
-    tailThick: (1 + 0.06 * g()) * (male ? 1.05 : 1) * (juv ? 0.9 : 1),
-    ear: (1 + 0.06 * g()) * (juv ? 1.14 : 1) * (fancy ? 1.04 : 1),
-    earWidth: 1 + 0.05 * g(),
-    headWidth: (male ? 1.05 : 1) * (1 + 0.03 * g()),
-    muzzle: (1 + 0.04 * g()) * (juv ? 0.86 : 1) * (fancy ? 0.97 : 1),
-    whisker: (1 + 0.06 * g()) * (juv ? 0.8 : 1),
-    blaze: colour === 'hooded' && M() < 0.35 ? 0.7 + 0.5 * M() : 0,
-    coatWarmth: colour === 'agouti' ? 0.9 * g() : 0.3 * g(),
-    coatLightness: 0.09 * g(),
-    coatSeed: Math.floor(R() * 1e6),
-    minThick: 0.0005,
-    warps: [
-      { type: 'legs', k: 1 + 0.035 * g() - 0.04 * juv, top: 0.03 },
-      { type: 'length', k: 1 + 0.03 * g() - 0.07 * juv + 0.01 * male, z0: -0.07, z1: 0.03 },
-      { type: 'girth', k: 1 + 0.06 * g() + 0.03 * male - 0.04 * juv + (fancy ? 0.02 : 0), cy: 0.05, z0: -0.085, z1: 0.04, fade: 0.012 },
-      { type: 'scaleAbout', c: HEAD_O, k: head, r0: 0.016, r1: 0.034 },
-      // pups: big feet
-      ...(juv ? [[0.019, 0.037], [-0.019, 0.037], [0.024, -0.028], [-0.024, -0.028]].map(([x, z]) => ({ type: 'scaleAbout', c: [x, 0.003, z], k: 1.15, r0: 0.006, r1: 0.014 })) : []),
-    ],
-  };
-  return params;
-}
-
-export default {
-  id: 'rat',
-  name: 'Brown rat',
-  latin: 'Rattus norvegicus',
-  group: 'paws',
-  plan: 'quadruped',
-  covering: 'fur',
-  variants: VARIANTS.map(([id, name]) => ({ id, name, latin: 'Rattus norvegicus' })),
-  variation,
-  rig: (params) => ratRig(params),
-  sculpt: (m, rig, params) => sculptRat(m, rig, params),
-  regions: ratRegions,
-  coat: ratCoat,
-  surfaces: ratWhiskers,
-  eyeSpecs: (params) => [1, -1].map((side) => ({ side, spec: eyeOf(params), headOrigin: HEAD_O, bone: 'head', look: params.colour === 'albino' ? EYE_ALBINO : EYE_LOOK })),
-  motion,
-  render: (params = {}) => ({
-    markColor: params.colour === 'albino' ? [0.5, 0.25, 0.25] : [0.02, 0.015, 0.013],
-    strandDensity: 2600,
-    clumpDensity: 2.2,
-    shellScale: 1,
-    // (no silhouette fins: on this short coat their inset edge drew a dark line along the outline)
-    fins: false,
-    raiseLen: [0.004, 0.009],
-  }),
-};
-
-// Wild type: a glossy near-black bead (very dark brown iris, the round pupil barely distinguishable)
-export const EYE_LOOK = {
-  pupil: 'round',
-  lids: 'mammal',
-  iris: { inner: [0.006, 0.003, 0.0025], mid: [0.011, 0.006, 0.005], hi: [0.03, 0.017, 0.012], outer: [0.004, 0.0025, 0.002] },
-  sclera: { color: [0.01, 0.007, 0.006], visible: false },
-  lidColor: [0.03, 0.02, 0.018],
-  pupilSize: [0.55, 0.7],
-};
-// Albino: red (the fundus through an unpigmented iris), a pale pink tinge at the rim
-export const EYE_ALBINO = {
-  pupil: 'round',
-  lids: 'mammal',
-  iris: { inner: [0.35, 0.02, 0.03], mid: [0.45, 0.04, 0.05], hi: [0.7, 0.3, 0.3], outer: [0.3, 0.05, 0.06] },
-  sclera: { color: [0.4, 0.1, 0.1], visible: false },
-  lidColor: [0.7, 0.42, 0.4],
-  pupilSize: [0.45, 0.6],
-};
-void hl;

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

@@ -1,90 +0,0 @@
-// Brown rat motion data for the quadruped engine (schema: src/core/motion/quadruped.js).
-// Numbers are for the reference individual (params.size = 1, ~330 g, hip joint ~56 mm); the engine
-// scales them by dynamic similarity for pups and big males.
-//
-// Gaits (overground runway data for intact rats, Górska et al. / Koopmans et al.;
-// hindlimb kinematics, Sci. Rep. 2022): an exploratory walk (lateral-sequence "alternate" pattern,
-// LF ~0.3 after LH, duty 0.64-0.75, 1.5-2.5 Hz), a fast walk (4 Hz, duty 0.52), the trot (4.5 Hz,
-// duty 0.43, diagonal pairs), a transverse gallop (5.1 Hz), the half-bound (5.6 Hz: the hind feet
-// land almost together, the forefeet staggered) and the bound (5.7 Hz, pairs synchronous), mean duty
-// 0.40 when running; bursts to ~3 m/s. Offsets [FL, FR, HL, HR] relative to HL touchdown.
-import { hooks } from './behaviour.js';
-
-const G = (name, v, f, D, off, o) => ({ name, v, f, D, off, ...o });
-const WALK = [0.3, 0.8, 0.0, 0.5];
-const TROT = [0.5, 0.02, 0.0, 0.5];
-const GALLOP = [0.46, 0.58, 0.0, 0.12];
-const HALFB = [0.6, 0.48, 0.0, 0.06];
-const BOUND = [0.5, 0.52, 0.0, 0.02];
-
-export const motion = {
-  maxSpeed: 3.0,
-  accel: [7, 12],
-  decel: 6,
-  turnRate: 5,
-  latAccelMax: 6,
-  gears: { walk: 0.3, trot: 0.95, gallop: 1.25, halfbound: 1.45, bound: 1.75 },
-  gallopBlend: [1.1, 1.8],
-  flexBlend: [1.0, 1.7],
-  hooks,
-  gaits: [
-    G('walk', 0.0, 1.6, 0.74, WALK, { liftF: 0.006, liftH: 0.007, bobF: 0.0012, bobH: 0.0015, flex: 0.0, lat: 0.07, fold: 0.5, heel: 25, tail: 0, drop: 0 }),
-    G('walk', 0.3, 2.5, 0.64, WALK, { liftF: 0.007, liftH: 0.008, bobF: 0.0015, bobH: 0.002, flex: 0.0, lat: 0.08, fold: 0.55, heel: 35, tail: 0.1, drop: 0 }),
-    G('walk', 0.7, 4.0, 0.52, WALK, { liftF: 0.008, liftH: 0.009, bobF: 0.002, bobH: 0.0025, flex: 0.02, lat: 0.06, fold: 0.6, heel: 45, tail: 0.2, drop: 0.001 }),
-    G('trot', 0.9, 4.5, 0.43, TROT, { liftF: 0.009, liftH: 0.01, bobF: 0.0025, bobH: 0.003, flex: 0.03, lat: 0.03, fold: 0.7, heel: 55, tail: 0.3, drop: 0.002 }),
-    G('trot', 1.05, 4.6, 0.43, TROT, { liftF: 0.009, liftH: 0.01, bobF: 0.0025, bobH: 0.003, flex: 0.04, lat: 0.03, fold: 0.7, heel: 55, tail: 0.3, drop: 0.002 }),
-    G('gallop', 1.15, 5.0, 0.4, GALLOP, { liftF: 0.011, liftH: 0.012, bobF: 0.003, bobH: 0.004, flex: 0.14, lat: 0, fold: 0.8, heel: 60, tail: 0.5, drop: 0.003 }),
-    G('gallop', 1.3, 5.2, 0.39, GALLOP, { liftF: 0.011, liftH: 0.012, bobF: 0.003, bobH: 0.004, flex: 0.16, lat: 0, fold: 0.8, heel: 60, tail: 0.5, drop: 0.003 }),
-    G('halfbound', 1.4, 5.6, 0.38, HALFB, { liftF: 0.012, liftH: 0.013, bobF: 0.0035, bobH: 0.0045, flex: 0.2, lat: 0, fold: 0.85, heel: 62, tail: 0.6, drop: 0.003 }),
-    G('halfbound', 1.6, 5.65, 0.36, HALFB, { liftF: 0.012, liftH: 0.013, bobF: 0.0035, bobH: 0.0045, flex: 0.22, lat: 0, fold: 0.85, heel: 62, tail: 0.6, drop: 0.003 }),
-    G('bound', 1.75, 5.7, 0.34, BOUND, { liftF: 0.013, liftH: 0.014, bobF: 0.004, bobH: 0.005, flex: 0.25, lat: 0, fold: 0.72, heel: 64, tail: 0.7, drop: 0.004 }),
-    G('bound', 3.0, 6.2, 0.28, BOUND, { liftF: 0.014, liftH: 0.015, bobF: 0.0045, bobH: 0.0055, flex: 0.28, lat: 0, fold: 0.75, heel: 66, tail: 0.8, drop: 0.004 }),
-  ],
-  feet: {
-    // plantigrade: the palm and the whole hind sole flat in stance, the heel lifting first
-    front: { type: 'plantigrade', curl: 20, heelStrike: 0, flex: 6, couple: 0.6, toeOut: 0.12, elbowDown: 0, retract: 0.5, liftBehind: 0.4 },
-    hind: { type: 'plantigrade', curl: 35, heelStrike: 0, lead: 0.35, toeOut: 0.22, retract: 0.35, liftBehind: 0.3 },
-  },
-  stance: { width: 1, gallopWidth: 0.85, sprawl: 0, crouch: 0, scuff: [2, 3, 0] },
-  body: {
-    // sections of the bind mesh at the girdles, fur included (measured on the bind mesh: chest bottom
-    // ~25 mm, belly ~22 mm (the sections reach a little lower, to 19-22 mm: with the measured 23 mm a
-    // curled sleeping rat pushed a forearm into the ground), the rump over the tail root ~21 mm above the ground; the back
-    // (long and low) ~91 mm over the withers, ~96 mm over the loins, ~85 mm over the tail root)
-    chest: { y: 0.0565, hh: 0.0345, hw: 0.033 },
-    pelvis: { y: 0.059, hh: 0.037, hw: 0.047 },
-    mid: { y: 0.0575, hh: 0.0385, hw: 0.048 },
-    rump: { z: -0.08, y: 0.0545, hh: 0.038, hw: 0.029 },
-    back: 0.024,
-  },
-  head: {
-    // [speed, raise (m), reach (m), pitch (rad, + = nose down)]: nose low, sniffing the ground
-    carriage: [[0, -0.002, 0.002, 0.18], [0.3, -0.004, 0.004, 0.2], [1.0, -0.004, 0.006, 0.12], [2, -0.004, 0.008, 0.08]],
-    stab: [[0, 0], [0.3, 0.15], [1, 0.25], [2, 0.35]],
-    neckBend: 35, neckPivot: 0.5, yaw: 0.9, pitchUp: 0.6, pitchDown: 0.6,
-  },
-  tail: {
-    // slopes down from the rump and trails along the ground at rest; carried straight out behind,
-    // just off the ground, when running
-    carriage: [
-      [0.0, [-38, -30, -20, -12, -6, -3, -1, 0, 0, 0, 0, 0]],
-      [0.5, [-30, -22, -14, -8, -4, -2, 0, 0, 0, 0, 0, 0]],
-      [1.3, [-18, -10, -5, -2, 0, 0, 1, 1, 1, 1, 1, 1]],
-      [3.0, [-12, -5, -1, 1, 2, 2, 2, 2, 2, 2, 2, 2]],
-    ],
-    stiffness: 1.1, sway: 6, flick: 0, wag: 0, swish: 0, curl: 0, balance: 0.4,
-    radius: [0.0065, 0.0014],
-  },
-  ears: { mobility: 0.5, speedFlatten: 0.5, flattenSpeeds: [1.2, 3], twitch: 1.2, prick: 0.3 },
-  breath: { rate: 1.4, amp: 0.02, pant: false, heatSpeed: 3 },
-  actions: {
-    attack: { style: 'bite-lunge' },
-    eat: { style: 'graze', dropF: 0.1, dropH: 0.0 },
-    drink: { dropF: 0.12, dropH: 0.0 },
-    jump: { height: 0.25, distance: 0.45 },
-    idle: { shift: 0.5 },
-    sit: {},
-    lie: {},
-    sleep: { style: 'curl' },
-  },
-};

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

@@ -1,92 +0,0 @@
-// Meshing plan: body at 1 mm, the thin tail at 0.7 mm, head (with the thin ears) at 0.6 mm overlapping across the nape and
-// cross-faded, the four feet (separate toes, ~1.7 mm thick) at 0.5 mm cross-faded above the wrist and
-// the heel, eyelid patches at 0.2 mm, the lower jaw as its own rigid surface, and the incisors as
-// rigid parts (hero .. medium; sub-pixel below).
-import { ratJoints, HEAD_O } from './rig.js';
-import { EYE } from './sculpt.js';
-import { eyeFrameOf } from '../../core/sdf/eyeSocket.js';
-import { lerp, norm, sub, smoothstep } from '../../core/math/vec.js';
-
-const J0 = ratJoints();
-export const NECK_CUT = (() => {
-  const d = norm(sub(J0.occiput, J0.neckBase));
-  const c = lerp(J0.neckMid, J0.occiput, 0.5);
-  return { c, d, band: 0.003 };
-})();
-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];
-
-// feet: below this height (and inside the foot boxes) the fine foot mesh takes over
-// tail: behind this plane the tail region takes over
-export const TAIL_Z = -0.104, TAIL_B = 0.002;
-export const FOOT_Y = 0.0105, FOOT_B = 0.0018;
-const FOOT_BOX = {
-  F: { x0: 0.006, x1: 0.036, z0: 0.012, z1: 0.058 },
-  H: { x0: 0.006, x1: 0.04, z0: -0.058, z1: 0.01 },
-};
-export const inFoot = (x, z) => {
-  const ax = Math.abs(x);
-  for (const b of Object.values(FOOT_BOX)) if (ax > b.x0 && ax < b.x1 && z > b.z0 && z < b.z1) return true;
-  return false;
-};
-// > 0 inside the foot region (signed height below the cut)
-const footS = (x, y, z) => (inFoot(x, z) ? FOOT_Y - y : -1);
-
-export const EYE_PATCH = { R: 0.0056, B: 0.0008, h: 0.0002, centres: [1, -1].map((c) => eyeFrameOf(EYE, HEAD_O, c).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 ratRegions(rig, params, Q) {
-  // (the crowd tier's ~4 mm body cells need a wider overlap across the nape, or a slit opens there)
-  const r = Q.res, B = NECK_CUT.band * Math.max(1, r / 2.6);
-  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 feet = r < 2.5; // low / crowd: the feet stay in the body mesh
-  const fine = r < 2.5; // the thin tail in its own finer region (hero .. medium)
-  const jobs = [
-    [{ name: 'body', part: 'body', bmin: [-0.055, -0.006, -0.3], bmax: [0.055, 0.15, 0.08], h: 0.00103 * r, F: 4, clip: (x, y, z) => neckS(x, y, z) < B && (!feet || footS(x, y, z) < FOOT_B) && (!fine || z > TAIL_Z - TAIL_B) }],
-    [
-      { name: 'head', part: 'body', bmin: [-0.04, 0.026, 0.035], bmax: [0.04, 0.108, 0.114], h: 0.00062 * r, F: 6, clip: (x, y, z) => neckS(x, y, z) > -B, patches },
-      { name: 'jaw', part: 'jaw', bmin: [-0.013, 0.032, 0.053], bmax: [0.013, 0.062, 0.106], h: 0.00055 * r, F: 6, rigidBone: 'jaw' },
-    ],
-  ];
-  if (feet) {
-    const fj = [];
-    for (const [k, b] of Object.entries(FOOT_BOX)) {
-      for (const s of [1, -1]) {
-        const x0 = s > 0 ? b.x0 : -b.x1, x1 = s > 0 ? b.x1 : -b.x0;
-        fj.push({ name: 'foot' + k + (s > 0 ? 'L' : 'R'), part: 'body', bmin: [x0, -0.004, b.z0], bmax: [x1, FOOT_Y + 0.004, b.z1], h: 0.0005 * r, F: 6, clip: (x, y, z) => footS(x, y, z) > -FOOT_B });
-      }
-    }
-    jobs.push(fj);
-  }
-  if (fine) jobs[0].push({ name: 'tail', part: 'body', bmin: [-0.02, -0.004, -0.32], bmax: [0.02, 0.05, TAIL_Z + 0.004], h: 0.0007 * r, F: 4, clip: (x, y, z) => z < TAIL_Z + TAIL_B });
-  if (r < 2.5) {
-    const ht = 0.00022 * Math.min(r, 1.6);
-    jobs.push([
-      { name: 'uteeth', part: 'uteeth', bmin: [-0.004, 0.042, 0.09], bmax: [0.004, 0.056, 0.106], h: ht, F: 4, rigidBone: 'head' },
-      { name: 'lteeth', part: 'lteeth', bmin: [-0.004, 0.04, 0.088], bmax: [0.004, 0.052, 0.104], h: ht, F: 4, rigidBone: 'jaw' },
-    ]);
-  }
-  return {
-    jobs,
-    fade(x, y, z, name, patch) {
-      const sN = neckS(x, y, z);
-      if (name === 'body') {
-        let f = 1 - smoothstep(-B, B, sN);
-        if (feet && inFoot(x, z)) f *= 1 - smoothstep(-FOOT_B, FOOT_B, FOOT_Y - y);
-        if (fine) f *= smoothstep(TAIL_Z - TAIL_B, TAIL_Z + TAIL_B, z);
-        return f;
-      }
-      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;
-      }
-      if (name === 'tail') return 1 - smoothstep(TAIL_Z - TAIL_B, TAIL_Z + TAIL_B, z);
-      if (name.startsWith('foot')) return smoothstep(-FOOT_B, FOOT_B, FOOT_Y - y);
-      return 1;
-    },
-  };
-}