@pieai/swimmer-avatar-kit 0.1.0

package/vendor/kindergrimm/src/gloss/gspecies.js

@@ -0,0 +1,338 @@
+// ---------------------------------------------------------------
+// THE CASTING — the third copy of the project's oldest idea, and on
+// purpose the third copy of the code: the gloss generator shares an
+// idea with the drawn and voxel ones, not a runtime.
+//
+// A species is a table of loaded dice per part id:
+//
+//   { style: { bear: 90, none: 10 } }   an object → weighted pick, and
+//                                       what you leave out CANNOT happen
+//   { size: [.9, 1.2] }                 an array  → a number in range
+//   { teeth: .85 }                      a number  → a probability
+//
+// Anything a profile does not mention keeps the part's own default, so
+// a profile states only what makes that species different. A species
+// may also bias the BODY form (sphere vs cube) — but never the palette
+// or the material: what a character is made of is a separate lever, and a
+// lavender bear is still a bear. The EARS do the species work, and
+// after the eye patch and the muzzle were both cut they do nearly all
+// of it — which is worth knowing before adding a species: if it cannot
+// be told apart by its silhouette, it has nothing to be told apart by.
+//
+// A species may also NAME the body forms it may be poured as, and the
+// two BENT ones (`rock`, `slime`) are where that matters most: a lumpy
+// rock is a creature and a humanoid is not one, so the humanoid's
+// profile lists the two forms a person can be.
+//
+// `wildcard` is the free roll — the sheet the lab had before species
+// existed. It stays the biggest slice on purpose: the casting is there
+// to make the compound characters (bunny, robot) arrive assembled, not
+// to turn the generator into eight fixed characters.
+// ---------------------------------------------------------------
+
+// A species may also weight the STANCE (none / biped) the same way it
+// weights the body form. Head-only stays everyone's biggest slice — it
+// is the house look — and the lump species pin it, because a slime
+// with legs contradicts what a slime is.
+
+export const GSPECIES = {
+  wildcard: { label: 'wildcard', cast: {} },
+
+  bear: {
+    label: 'bear',
+    stance: { none: 56, biped: 44 },
+    cast: {
+      crest:  { style: { bear: 90, none: 10 }, size: [.72, .95], spread: [.5, .72] },
+      eyes:   { style: { bead: 38, pupil: 24, oval: 20, sleepy: 18 },
+                size: [.125, .165] },
+      nose:   { style: { none: 84, button: 10, dot: 6 } },
+      mouth:  { style: { smile: 30, open: 24, flat: 20, cat: 16, frown: 10 }, teeth: .3 },
+      brows:  { style: { none: 90, flat: 10 } },
+    },
+  },
+
+  bunny: {
+    label: 'bunny',
+    stance: { none: 56, biped: 44 },
+    cast: {
+      body:   { tall: [.94, 1] },
+      crest:  { style: { bunny: 95, none: 5 }, size: [.82, 1] },
+      eyes:   { style: { pupil: 32, bead: 20, googly: 16, slab: 16, happy: 16 } },
+      // the big front teeth: grins often, and the line mouths carry
+      // the single fang (teeth + tongue on a line is the fang roll)
+      mouth:  { style: { grin: 26, smile: 24, cat: 20, open: 14, zig: 16 },
+                teeth: .75, tongue: .4 },
+      nose:   { style: { none: 88, dot: 8, heart: 4 } },
+    },
+  },
+
+  cat: {
+    label: 'cat',
+    stance: { none: 65, biped: 35 },
+    cast: {
+      crest:  { style: { cat: 95, none: 5 } },
+      // set WIDE, and winking more than anybody else
+      eyes:   { style: { bead: 28, pupil: 22, sleepy: 18, happy: 16, cross: 16 },
+                wink: .15, x: [.54, .72] },
+      mouth:  { style: { cat: 44, smile: 20, zig: 16, flat: 20 }, teeth: .5, tongue: .5 },
+      nose:   { style: { none: 86, cat: 9, dot: 5 } },
+      brows:  { style: { none: 94, sad: 6 } },
+    },
+  },
+
+  monster: {
+    label: 'monster',
+    body: { cube: 34, sphere: 26, rock: 24, slime: 16 },
+    cast: {
+      crest:  { style: { horns: 68, stubs: 16, none: 16 } },
+      eyes:   { style: { cross: 18, angry: 18, slab: 16, googly: 14, ring: 12,
+                         spiral: 10, wobble: 12 }, wink: .1 },
+      mouth:  { style: { grin: 30, open: 28, holler: 22, zig: 20 },
+                teeth: .85, tongue: .5, size: [.58, .85] },
+      brows:  { style: { none: 50, angry: 34, thick: 16 } },
+      blush:  { style: { none: 80, stripes: 20 } },
+    },
+  },
+
+  // THE LUMPS — a rock and a slime as whole characters, not just body
+  // forms a wildcard can roll. Same name as the form on purpose: the
+  // species IS the shape. Head only (the form's foot or base is
+  // already its bottom), no hair, no extras — a rock in spectacles is
+  // a gag, and one gag per sheet is the mark part's job, not a
+  // species'. The silhouette does all the species work here, so the
+  // crest stays off it too.
+  rock: {
+    label: 'rock',
+    body: { rock: 100 },
+    stance: { none: 100 },
+    cast: {
+      crest:  { style: { none: 100 } },
+      // heavy-lidded and unimpressed: a rock has been here a while
+      eyes:   { style: { bead: 30, sleepy: 24, pupil: 18, oval: 14, cross: 7, angry: 7 },
+                size: [.11, .15] },
+      mouth:  { style: { flat: 30, frown: 22, smile: 18, zig: 16, open: 14 }, teeth: .15 },
+      nose:   { style: { none: 100 } },
+      brows:  { style: { none: 55, flat: 25, angry: 20 } },
+      blush:  { style: { none: 75, oval: 15, round: 10 } },
+      specs:  { style: { none: 100 } },
+      mark:   { style: { none: 100 } },
+    },
+  },
+
+  slime: {
+    label: 'slime',
+    body: { slime: 100 },
+    stance: { none: 100 },
+    cast: {
+      crest:  { style: { none: 100 } },
+      // wide awake and delighted about it — the drop shape reads sad
+      // on its own, so the face pulls the other way
+      eyes:   { style: { googly: 22, bead: 20, happy: 16, pupil: 14, oval: 12,
+                         wobble: 8, spiral: 8 } },
+      mouth:  { style: { open: 26, smile: 24, grin: 18, cat: 12, zig: 10, holler: 10 },
+                tongue: .5, teeth: .3 },
+      nose:   { style: { none: 100 } },
+      brows:  { style: { none: 85, worry: 15 } },
+      blush:  { style: { none: 55, round: 25, oval: 20 } },
+      specs:  { style: { none: 100 } },
+      mark:   { style: { none: 100 } },
+    },
+  },
+
+  humanoid: {
+    label: 'humanoid',
+    // A PERSON STANDS. Head-only is the house look for a creature, but
+    // a floating humanoid head with no body reads as a decapitation,
+    // not a character — so this is the one species pinned to biped.
+    stance: { biped: 100 },
+    // A humanoid is a CHARACTER like the rest of the sheet — a ball or a
+    // block with a face and a haircut. It had a modeled skull for a
+    // while and the skull was the wrong object. It is NOT a rock or a
+    // slime: those two are creature shapes, and naming the two forms a
+    // person may be is what keeps them off this species.
+    body: { sphere: 62, cube: 38 },
+    // the one species that names its own palette and material — see
+    // the note in `ensureGParams`. A humanoid is made of SKIN.
+    palette: 'skin',
+    material: 'skin',
+    cast: {
+      // near-square and softly cornered: the head is the stage the
+      // face and the hair are set on, so it stays out of the way
+      body:   { wide: [1, 1.12], tall: [.92, 1], corner: [2.6, 3.6] },
+      // ALWAYS DRESSED. A skin-coloured torso on a person reads as
+      // naked, not as a blank — the one biped that cannot go bare.
+      frame:  { dressed: 1 },
+      // NO CREST. Ears and horns are the other species' silhouette
+      // work; a humanoid's is its HAIR, which is a part of its own now
+      // (`hair.js`) and owns the whole crown. The three ink plates that
+      // stood in for hair here — tuft, mop, curl — were a placeholder
+      // and are not dealt to anybody any more.
+      crest:  { style: { none: 100 } },
+      // HATS ARE HUMAN. The part's own default is `none` at 100, so a
+      // bear cannot turn up in a beanie; this is the only table that
+      // deals them. `beanie` and `band` are worn on a bare head (see
+      // `hatBare`), so between them they also carry most of the sheet's
+      // bald characters — which is why they are not the rarest here.
+      hat:    { style: { none: 82, beanie: 6, band: 4, bow: 4, flower: 3, crown: 1 } },
+      // THE HAIRCUT, and it is most of the character. Weighted the way
+      // a room of people is: short and medium carry it, the very long
+      // cuts and the tied-up ones are the ones you notice. `bald` stays
+      // in at a few percent because a bald chibi is a real character
+      // and the skull is good enough to show off.
+      // Weighted so the SHEET has styling, not one haircut in fourteen
+      // lengths. The blunt bowl is deliberately small — it was most of
+      // the sheet, and a blunt fringe is the one shape that makes every
+      // head look like the same head. The upswept group and the media
+      // melena carry it instead, which is roughly how a room of people
+      // actually looks.
+      hair:   { style: { midi: 8, layers: 7, bob: 7, wavy: 5, long: 5, hime: 2,
+                         side: 8, pixie: 8, curtain: 7, quiff: 7, swept: 7,
+                         crop: 6, curly: 5, spiky: 4, bowl: 3,
+                         twin: 4, pony: 4, buns: 3, bald: 3 } },
+      // THE WHOLE CATALOGUE ROLLS. The orb is the humanoid's signature
+      // and keeps the biggest slice, but every other eye in the table
+      // is reachable — a face this simple gets its variety from the
+      // features, and casting three styles gave three characters.
+      // Only the placement is opinionated: chibi eyes sit LOW, at or
+      // under the centreline, down in the wide cheeks with all that
+      // cranium empty above — the opposite of the characters' upper-half
+      // rule, and it is what the reference sheets all do.
+      // Listed in full because a cast style table is EXCLUSIVE — what
+      // you leave out cannot happen — so "all of them, orb first" has
+      // to be written out rather than implied.
+      //
+      // THE PROPORTIONS ARE THE SPECIES, measured off the chibi
+      // reference sheet and checked against the build (`__probe` in
+      // the lab): the eye's CENTRE lands ~63% down the head and its
+      // top ~50%, which is what "frente despejada, ojos a mitad de
+      // cara" actually means — the forehead is the whole top half and
+      // the eyes hang off the midline. Each eye is ~26% of the head's
+      // width. Guessing these put the face too high and too small
+      // twice; the numbers came off the sheet in the end.
+      eyes:   { style: { orb: 22, pupil: 12, bead: 7, googly: 7,
+                         slab: 6, oval: 5,
+                         sleepy: 5, happy: 5, box: 3, round: 3, square: 3,
+                         sparkle: 2, diamond: 2, cross: 2,
+                         crescent: 1, star: 1, heart: 1, ring: 1,
+                         flower: 1, angry: 1, wobble: 1, spiral: 1 },
+                size: [.15, .185], x: [.58, .70], y: [-.38, -.24], lid: .3 },
+      // a face with a real nose more often than the characters get one
+      nose:   { style: { none: 62, button: 14, dot: 12, cat: 4, heart: 4, beak: 2, snout: 2 },
+                warm: .6 },
+      // SMALL, and a line rather than a maw. Two jobs: the reference
+      // mouth is a stroke a fraction of an eye wide, and a small
+      // mouth also REACHES less — the layout pushes a mouth clear of
+      // the eyes, so a maw under eyes this big lands on the chin.
+      mouth:  { style: { smile: 26, cat: 16, flat: 14, zig: 10, frown: 8, none: 12,
+                         open: 8, grin: 6 },
+                y: [-.52, -.36], size: [.32, .5] },
+      // the most browed species on the sheet, and the only one where
+      // brows are the RULE rather than an anecdote: the reference
+      // faces nearly all have a pair, high on that clear forehead,
+      // and on a face this plain they carry the whole expression
+      brows:  { style: { none: 30, flat: 20, round: 16, sad: 12, angry: 12, worry: 10 },
+                lift: [.3, .5] },
+      blush:  { style: { round: 28, oval: 22, none: 50 } },
+    },
+  },
+
+  robot: {
+    label: 'robot',
+    body: { cube: 90, sphere: 10 },
+    stance: { none: 40, biped: 60 },
+    cast: {
+      body:   { corner: [3.4, 5.5] },
+      // a robot's torso is its own chassis — the pour, chrome and all —
+      // not a jumper pulled over it
+      frame:  { dressed: .1 },
+      crest:  { style: { stubs: 52, none: 36, horns: 12 }, size: [.58, .8] },
+      eyes:   { style: { box: 38, square: 26, slab: 20, ring: 16 }, lid: .15 },
+      // mostly bare: a robot's face is the grid grin and the screen
+      mouth:  { style: { grin: 44, flat: 28, zig: 28 } },
+      nose:   { style: { none: 90, dot: 10 } },
+      brows:  { style: { none: 86, flat: 14 } },
+      blush:  { style: { none: 85, round: 15 } },
+    },
+  },
+};
+
+export const GSPECIES_IDS = Object.keys(GSPECIES);
+
+// how the sheet deals them. Wildcard stays the biggest slice — see the
+// header — and the compound species split the rest about evenly.
+// `panda` used to sit here. Its whole identity was the ink eye patch,
+// so when that went it cast a bear with different weights — a species
+// you cannot tell from another is not a species. Its share went back
+// to the bear it had become. `pig` is gone too, and its share went
+// back to the wildcard.
+// The lumps are dealt THIN because their body forms also still turn up
+// through the wildcard and the monster, so their species share plus
+// those rolls is the real rate of geology on a sheet.
+export const GSPECIES_WEIGHTS = [
+  ['wildcard', 32], ['bear', 16], ['bunny', 12], ['cat', 12],
+  ['monster', 10], ['humanoid', 9], ['robot', 8],
+  ['rock', 5], ['slime', 4],
+];
+
+const wpick = (rng, pairs) => {
+  let t = 0; for (const p of pairs) t += p[1];
+  let x = rng.r(0, t);
+  for (const p of pairs) { if ((x -= p[1]) < 0) return p[0]; }
+  return pairs[pairs.length - 1][0];
+};
+
+/** the species' opinion on which body form, if it has one — otherwise
+ *  the sheet's own weighted deal. Weighted on BOTH sides: a uniform
+ *  default made the two bent forms 40% of a sheet. */
+export function pickGBody(speciesId, rng, defaultPairs, { without = null } = {}) {
+  const w = GSPECIES[speciesId]?.body;
+  let pairs = w ? Object.entries(w) : defaultPairs;
+  // a PINNED stance excludes the modeled forms before the roll — a
+  // rock cannot take a frame, and a biped-pinned sheet full of
+  // head-only lumps is the filter quietly not filtering
+  if (without) {
+    pairs = pairs.filter(([id]) => !without(id));
+    // a species whose whole table is excluded (a rock pinned to biped)
+    // falls back to the sheet's deal, still filtered
+    if (!pairs.length) pairs = defaultPairs.filter(([id]) => !without(id));
+  }
+  return wpick(rng, pairs);
+}
+
+/** the same deal for the STANCE — head-only or biped. */
+export function pickGStance(speciesId, rng, defaultPairs) {
+  const w = GSPECIES[speciesId]?.stance;
+  return wpick(rng, w ? Object.entries(w) : defaultPairs);
+}
+
+/**
+ * The casting helper handed to every part's gen(). Three questions,
+ * and in each the species wins if it has an opinion and the part's own
+ * default applies if it does not.
+ */
+export function gcastingFor(speciesId) {
+  const SP = GSPECIES[speciesId] ?? GSPECIES.wildcard;
+  return partId => {
+    const t = SP.cast?.[partId] ?? {};
+    return {
+      species: speciesId,
+      /** one of a weighted list: C.pick(rng, 'style', DEFAULT_PAIRS) */
+      pick(rng, k, pairs) {
+        const w = t[k];
+        const list = (w && typeof w === 'object' && !Array.isArray(w))
+          ? Object.entries(w).filter(([, n]) => n > 0) : pairs;
+        return wpick(rng, list);
+      },
+      /** a number: C.range(rng, 'size', .9, 1.4) */
+      range(rng, k, lo, hi) {
+        const r = t[k];
+        return Array.isArray(r) ? rng.r(r[0], r[1]) : rng.r(lo, hi);
+      },
+      /** a yes/no: C.chance(rng, 'teeth', .6) */
+      chance(rng, k, p) {
+        const c = t[k];
+        return rng.chance(typeof c === 'number' ? c : p);
+      },
+    };
+  };
+}