@polycode-projects/the-mechanical-code-talker 2.7.25 → 2.8.0

package/data/sprites/adventurer-icon.toml

@@ -0,0 +1,13 @@
+# adventurer — the player's own sprite: the person silhouette plus a
+# strap-and-satchel, so the one individual the player controls always
+# reads as visually distinct from the room's own cast of NPCs.
+classes = ["adventurer"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <circle cx="12" cy="6.6" r="3.3" fill="currentColor"/>
+  <path d="M6 21 C6 15.3 8.7 12.8 12 12.8 C15.3 12.8 18 15.3 18 21 Z" fill="currentColor"/>
+  <path d="M8.4 13.4 L17 17.6" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" opacity="0.85"/>
+  <rect x="14.6" y="15.8" width="5" height="4.6" rx="1" fill="currentColor" opacity="0.6"/>
+  <rect x="16.3" y="16.6" width="1.6" height="1.2" rx="0.3" fill="currentColor" opacity="0.9"/>
+</svg>
+"""

package/data/sprites/animal-icon.toml

@@ -0,0 +1,15 @@
+# animal — the deliberately plainest shape in the set: an unadorned
+# four-legged blob, so an unregistered species reads as "some animal"
+# rather than suggesting one the taxonomy never named. The declared root
+# fallback for the spider-and-fly world.
+classes = ["animal"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="12" cy="13" rx="7" ry="4.4" fill="currentColor"/>
+  <circle cx="12" cy="7" r="3.4" fill="currentColor"/>
+  <g stroke="currentColor" stroke-width="1.6" stroke-linecap="round">
+    <line x1="7" y1="17" x2="7" y2="21"/>
+    <line x1="17" y1="17" x2="17" y2="21"/>
+  </g>
+</svg>
+"""

package/data/sprites/butler-icon.toml

@@ -0,0 +1,16 @@
+# butler — Ashcombe Hall's own butler: the person silhouette plus a stiff
+# wing-collar flaring OUT past the shoulder line (changing the outer
+# silhouette, not an internal opacity knockout — an internal light-on-dark
+# accent was tried first and proved invisible once shrunk to 44px; a
+# silhouette change survives shrinking the way gardener.toml's wide brim
+# does) and a bow-tie.
+classes = ["butler"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <circle cx="12" cy="6.6" r="3.3" fill="currentColor"/>
+  <path d="M6 21 C6 15.3 8.7 12.8 12 12.8 C15.3 12.8 18 15.3 18 21 Z" fill="currentColor"/>
+  <path d="M7.6 11.6 L11.3 13.2 L8.6 15.4 Z" fill="currentColor"/>
+  <path d="M16.4 11.6 L12.7 13.2 L15.4 15.4 Z" fill="currentColor"/>
+  <path d="M10.6 14.2 L12 16.1 L13.4 14.2 L12 18.6 Z" fill="currentColor" opacity="0.95"/>
+</svg>
+"""

package/data/sprites/cabinet-icon.toml

@@ -0,0 +1,13 @@
+# cabinet — Ashcombe Hall's own locked cabinet (a container): a two-door
+# wardrobe silhouette, the gap between the doors reading as the seam, with
+# two knobs and a cornice band.
+classes = ["cabinet"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <rect x="4.5" y="2.5" width="7.2" height="19" rx="1" fill="currentColor"/>
+  <rect x="12.3" y="2.5" width="7.2" height="19" rx="1" fill="currentColor"/>
+  <rect x="4.5" y="2.5" width="15" height="1.4" fill="currentColor" opacity="0.4"/>
+  <circle cx="10.6" cy="12" r="0.9" fill="currentColor" opacity="0.35"/>
+  <circle cx="13.4" cy="12" r="0.9" fill="currentColor" opacity="0.35"/>
+</svg>
+"""

package/data/sprites/container-icon.toml

@@ -0,0 +1,12 @@
+# container — the generic fallback for any container with no sprite of
+# its own (see cabinet/portrait for Ashcombe Hall's own two): a solid
+# chest silhouette with a carved lid-seam and a latch highlight.
+classes = ["container"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <path d="M3 10 L5 5 H19 L21 10 Z" fill="currentColor"/>
+  <rect x="3" y="10" width="18" height="10" rx="1.2" fill="currentColor"/>
+  <rect x="3" y="10" width="18" height="1.6" fill="currentColor" opacity="0.35"/>
+  <rect x="10.6" y="9.2" width="2.8" height="2.6" rx="0.5" fill="currentColor" opacity="0.85"/>
+</svg>
+"""

package/data/sprites/{cook.toml → cook-icon.toml}

@@ -4,4 +4,11 @@
 # housekeeper.toml's cap use — a same-width tall hat read as just an
 # elongated head once shrunk, tried and rejected first).
 classes = ["cook"]
-svg = """<svg viewBox="0 0 24 24" aria-hidden="true"><ellipse cx="12" cy="3.4" rx="5.4" ry="3" fill="currentColor"/><rect x="8.6" y="5.6" width="6.8" height="2.2" rx="0.6" fill="currentColor"/><circle cx="12" cy="10" r="3.1" fill="currentColor"/><path d="M6 21 C6 15.6 8.7 13.2 12 13.2 C15.3 13.2 18 15.6 18 21 Z" fill="currentColor"/></svg>"""
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="12" cy="3.4" rx="5.4" ry="3" fill="currentColor"/>
+  <rect x="8.6" y="5.6" width="6.8" height="2.2" rx="0.6" fill="currentColor"/>
+  <circle cx="12" cy="10" r="3.1" fill="currentColor"/>
+  <path d="M6 21 C6 15.6 8.7 13.2 12 13.2 C15.3 13.2 18 15.6 18 21 Z" fill="currentColor"/>
+</svg>
+"""

package/data/sprites/desk-icon.toml

@@ -0,0 +1,14 @@
+# desk — Ashcombe Hall's own study desk: a tabletop bar over two drawer
+# blocks with pull-knobs, on tapered legs.
+classes = ["desk"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <rect x="3" y="7" width="18" height="2.6" rx="0.6" fill="currentColor"/>
+  <rect x="4.4" y="9.6" width="6.6" height="5.6" rx="0.6" fill="currentColor" opacity="0.85"/>
+  <rect x="13" y="9.6" width="6.6" height="5.6" rx="0.6" fill="currentColor" opacity="0.85"/>
+  <circle cx="9.6" cy="12.4" r="0.55" fill="currentColor" opacity="0.4"/>
+  <circle cx="16.4" cy="12.4" r="0.55" fill="currentColor" opacity="0.4"/>
+  <path d="M4.6 15.2 L3.8 20.5 L5.6 20.5 L6.2 15.2 Z" fill="currentColor"/>
+  <path d="M17.8 15.2 L17.2 20.5 L19 20.5 L18.2 15.2 Z" fill="currentColor"/>
+</svg>
+"""

package/data/sprites/dog-icon.toml

@@ -0,0 +1,17 @@
+# dog — the plain-class sprite a taxonomy hop away from poodle/sheepdog.
+# Same body language as poodle's, without the pompom cut, so the family
+# reads as one dog rather than two unrelated animals.
+classes = ["dog"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="13" cy="15" rx="6.4" ry="4.3" fill="currentColor"/>
+  <circle cx="7" cy="9" r="3.6" fill="currentColor"/>
+  <ellipse cx="6.1" cy="8" rx="1" ry="1.3" fill="currentColor" opacity="0.3"/>
+  <path d="M4.5 6.5 L2 3 L6 5 Z" fill="currentColor"/>
+  <path d="M19 13 C22 12 22.5 15 20 16 Z" fill="currentColor"/>
+  <g stroke="currentColor" stroke-width="1.6" stroke-linecap="round">
+    <line x1="9" y1="19" x2="9" y2="22"/>
+    <line x1="17" y1="19" x2="17" y2="22"/>
+  </g>
+</svg>
+"""

package/data/sprites/dog-with-colour-icon.toml

@@ -0,0 +1,31 @@
+# dog-with-colour — the parameterized-property worked example: "a dog that
+# is black". Same silhouette as dog.toml, but every filled shape takes its
+# color from the instance's OWN observed
+# mgx:hasProperty value rather than the page's currentColor accent, with a
+# thin currentColor stroke kept on each shape so a light value (white)
+# still reads against a light card background. A property value with no
+# entry in [parameters.colour.values] is not a match for this template at
+# all (see sprite-templates.mjs's own header for the naming/specificity
+# convention) — it falls through to the plain dog.toml sprite, never a
+# guessed color.
+classes = ["dog"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="13" cy="15" rx="6.4" ry="4.3" fill="{{FILL}}" stroke="currentColor" stroke-width="0.9"/>
+  <circle cx="7" cy="9" r="3.6" fill="{{FILL}}" stroke="currentColor" stroke-width="0.9"/>
+  <path d="M4.5 6.5 L2 3 L6 5 Z" fill="{{FILL}}" stroke="currentColor" stroke-width="0.9"/>
+  <path d="M19 13 C22 12 22.5 15 20 16 Z" fill="{{FILL}}" stroke="currentColor" stroke-width="0.9"/>
+  <g stroke="currentColor" stroke-width="1.6" stroke-linecap="round">
+    <line x1="9" y1="19" x2="9" y2="22"/>
+    <line x1="17" y1="19" x2="17" y2="22"/>
+  </g>
+</svg>
+"""
+
+[parameters.colour]
+property = "mgx:hasProperty"
+placeholder = "{{FILL}}"
+
+[parameters.colour.values]
+black = "#22201d"
+white = "#f5f2ea"

package/data/sprites/egg-icon.toml

@@ -0,0 +1,9 @@
+# egg — the spider-and-fly board's laid egg. The plain shell silhouette
+# plus one small carved highlight.
+classes = ["egg"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <path d="M12 2 C7 2 4 10 4 15.5 C4 20 7.6 22 12 22 C16.4 22 20 20 20 15.5 C20 10 17 2 12 2 Z" fill="currentColor"/>
+  <ellipse cx="9.6" cy="9.5" rx="1.7" ry="2.4" fill="currentColor" opacity="0.28"/>
+</svg>
+"""

package/data/sprites/fly-icon.toml

@@ -0,0 +1,19 @@
+# fly — the spider-and-fly board's other agent. A round head, a tapered
+# body with a carved highlight, translucent wings, and two thin trailing
+# legs for a touch of character at rest.
+classes = ["fly"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="12" cy="13.6" rx="3.4" ry="5.2" fill="currentColor"/>
+  <circle cx="12" cy="7" r="2.7" fill="currentColor"/>
+  <ellipse cx="11.1" cy="12" rx="1.1" ry="1.7" fill="currentColor" opacity="0.3"/>
+  <g fill="currentColor" opacity="0.55">
+    <path d="M9 10 C3 6 2 4 3 2 C6 2 9 6 10.5 10 Z"/>
+    <path d="M15 10 C21 6 22 4 21 2 C18 2 15 6 13.5 10 Z"/>
+  </g>
+  <g stroke="currentColor" stroke-width="1" stroke-linecap="round">
+    <path d="M9.6 17 L7.4 19.4"/>
+    <path d="M14.4 17 L16.6 19.4"/>
+  </g>
+</svg>
+"""

package/data/sprites/furniture-icon.toml

@@ -0,0 +1,12 @@
+# furniture — the generic fallback for any furniture piece with no sprite
+# of its own: a solid console-table silhouette (tapered legs, a carved
+# highlight along the top edge), replacing the old hollow-shelf outline.
+classes = ["furniture"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <rect x="3.5" y="6.5" width="17" height="3.2" rx="0.8" fill="currentColor"/>
+  <rect x="3.5" y="6.5" width="17" height="1" fill="currentColor" opacity="0.35"/>
+  <path d="M5.6 9.7 L4.6 20 L6.7 20 L7.2 9.7 Z" fill="currentColor"/>
+  <path d="M18.4 9.7 L16.8 20 L18.9 20 L19.4 9.7 Z" fill="currentColor"/>
+</svg>
+"""

package/data/sprites/gardener-icon.toml

@@ -0,0 +1,11 @@
+# gardener — Ashcombe Hall's own gardener: the person silhouette under a
+# wide sunhat brim.
+classes = ["gardener"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="12" cy="5.6" rx="7.4" ry="2" fill="currentColor"/>
+  <path d="M8.8 5.2 C8.8 3.1 10.2 1.6 12 1.6 C13.8 1.6 15.2 3.1 15.2 5.2 C15.2 5.6 15.1 6 15 6.3 L9 6.3 C8.9 6 8.8 5.6 8.8 5.2 Z" fill="currentColor" opacity="0.85"/>
+  <circle cx="12" cy="8.6" r="3.1" fill="currentColor"/>
+  <path d="M6 21 C6 15.5 8.7 13.1 12 13.1 C15.3 13.1 18 15.5 18 21 Z" fill="currentColor"/>
+</svg>
+"""

package/data/sprites/housekeeper-icon.toml

@@ -0,0 +1,14 @@
+# housekeeper — Ashcombe Hall's own housekeeper: the person silhouette
+# under a wide mob-cap brim (deliberately WIDER than the head, the same
+# "wide silhouette reads at 44px" move gardener.toml's sunhat uses) and a
+# tied apron line.
+classes = ["housekeeper"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="12" cy="4.6" rx="5.6" ry="2.1" fill="currentColor"/>
+  <path d="M8.6 5 C8.6 3 10 1.7 12 1.7 C14 1.7 15.4 3 15.4 5 L15.4 5.6 L8.6 5.6 Z" fill="currentColor" opacity="0.9"/>
+  <circle cx="12" cy="7.6" r="3.1" fill="currentColor"/>
+  <path d="M6 21 C6 15.5 8.7 13.1 12 13.1 C15.3 13.1 18 15.5 18 21 Z" fill="currentColor"/>
+  <path d="M9 16 C10 15.4 14 15.4 15 16" fill="none" stroke="currentColor" stroke-width="1" opacity="0.45" stroke-linecap="round"/>
+</svg>
+"""

package/data/sprites/key-icon.toml

@@ -0,0 +1,12 @@
+# key — Ashcombe Hall's own key (hidden in the portrait, unlocks the
+# cabinet): a classic round-bow skeleton key, bold strokes so it stays
+# legible at a 44px render.
+classes = ["key"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <circle cx="7" cy="9" r="4.4" fill="none" stroke="currentColor" stroke-width="2.4"/>
+  <path d="M10.4 12 L19.5 21.1" stroke="currentColor" stroke-width="2.2" stroke-linecap="round"/>
+  <path d="M16.4 17.1 L18.6 14.9" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+  <path d="M18.6 19.3 L20.6 17.3" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>
+</svg>
+"""

package/data/sprites/lamp-icon.toml

@@ -0,0 +1,11 @@
+# lamp — Ashcombe Hall's own study lamp: a Victorian hurricane-lamp
+# silhouette — base, glass globe, a neck, and a small carved flame.
+classes = ["lamp"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <path d="M9 21 H15 L14 18 H10 Z" fill="currentColor"/>
+  <path d="M8.4 18 C7 15.6 7 12.6 8.6 10.4 H15.4 C17 12.6 17 15.6 15.6 18 Z" fill="currentColor"/>
+  <rect x="10.6" y="6.4" width="2.8" height="4.4" fill="currentColor" opacity="0.85"/>
+  <path d="M12 3.2 C13.4 4.6 13.8 6 12 7.4 C10.2 6 10.6 4.6 12 3.2 Z" fill="currentColor" opacity="0.55"/>
+</svg>
+"""

package/data/sprites/letter-icon.toml

@@ -0,0 +1,11 @@
+# letter — Ashcombe Hall's own objective (hidden in the cabinet): an
+# envelope with a folded flap (a lighter overlay, the same carved-highlight
+# trick as the lid on container.toml) and a small wax seal.
+classes = ["letter"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <rect x="3" y="6" width="18" height="13" rx="1.2" fill="currentColor"/>
+  <path d="M3 6 L21 6 L21 6.8 L12 13.8 L3 6.8 Z" fill="currentColor" opacity="0.32"/>
+  <circle cx="12" cy="12.4" r="1.15" fill="currentColor" opacity="0.8"/>
+</svg>
+"""

package/data/sprites/person-icon.toml

@@ -0,0 +1,10 @@
+# person — the generic fallback for anyone with no NPC sprite of their own
+# (see butler/housekeeper/cook/gardener for the named Ashcombe Hall staff).
+classes = ["person"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <circle cx="12" cy="6.6" r="3.3" fill="currentColor"/>
+  <path d="M6 21 C6 15.3 8.7 12.8 12 12.8 C15.3 12.8 18 15.3 18 21 Z" fill="currentColor"/>
+  <path d="M12 12.8 C13.1 12.8 14.1 13 15 13.4" fill="none" stroke="currentColor" stroke-width="0.9" opacity="0.4" stroke-linecap="round"/>
+</svg>
+"""

package/data/sprites/poodle-icon.toml

@@ -0,0 +1,22 @@
+# poodle — the seed taxonomy's worked example (poodle IsA dog): its own
+# pompom-cut head and tail, distinct from the plain dog sprite it would
+# otherwise fall back to.
+classes = ["poodle"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="13" cy="15" rx="6.4" ry="4.6" fill="currentColor"/>
+  <ellipse cx="10.8" cy="13.2" rx="1.8" ry="1.3" fill="currentColor" opacity="0.28"/>
+  <circle cx="7" cy="8.5" r="4" fill="currentColor"/>
+  <g fill="currentColor">
+    <circle cx="4" cy="6" r="1.6"/>
+    <circle cx="7" cy="4.2" r="1.7"/>
+    <circle cx="10" cy="6" r="1.6"/>
+  </g>
+  <rect x="18.5" y="14" width="2.2" height="6" rx="1.1" fill="currentColor"/>
+  <circle cx="19.6" cy="13" r="1.5" fill="currentColor"/>
+  <g stroke="currentColor" stroke-width="1.6" stroke-linecap="round">
+    <line x1="9" y1="19.5" x2="9" y2="22"/>
+    <line x1="17" y1="19.5" x2="17" y2="22"/>
+  </g>
+</svg>
+"""

package/data/sprites/portable-icon.toml

@@ -0,0 +1,12 @@
+# portable — the generic fallback for any carryable object with no sprite
+# of its own: a drawstring parcel silhouette, replacing the old
+# generic-gift-box outline so it reads as "an unspecified small thing"
+# rather than a gift.
+classes = ["portable"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <path d="M12 6 C7.5 6 5 9.4 5 13.4 C5 17.7 8.1 20 12 20 C15.9 20 19 17.7 19 13.4 C19 9.4 16.5 6 12 6 Z" fill="currentColor"/>
+  <path d="M9.4 6.4 C9.9 4.6 10.8 3.4 12 3.4 C13.2 3.4 14.1 4.6 14.6 6.4" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"/>
+  <ellipse cx="9.8" cy="11.6" rx="1.6" ry="2.1" fill="currentColor" opacity="0.28"/>
+</svg>
+"""

package/data/sprites/portrait-icon.toml

@@ -0,0 +1,12 @@
+# portrait — Ashcombe Hall's own drawing-room portrait (a container, hiding
+# the key): a gilt arched frame around a lighter canvas, with a bust
+# silhouette so it reads as a picture of someone, not an empty frame.
+classes = ["portrait"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <path d="M4 21 V7 C4 4 6.8 2 12 2 C17.2 2 20 4 20 7 V21 Z" fill="currentColor"/>
+  <path d="M6.3 19.4 V8.3 C6.3 6.2 8.4 4.8 12 4.8 C15.6 4.8 17.7 6.2 17.7 8.3 V19.4 Z" fill="currentColor" opacity="0.28"/>
+  <circle cx="12" cy="10.4" r="2.3" fill="currentColor" opacity="0.7"/>
+  <path d="M8 18.4 C8 15.2 9.6 13.4 12 13.4 C14.4 13.4 16 15.2 16 18.4 Z" fill="currentColor" opacity="0.7"/>
+</svg>
+"""

package/data/sprites/room-icon.toml

@@ -0,0 +1,11 @@
+# room — a schematic floor plan: a washed interior (a solid tint, not a
+# hollow box) plus a doorway arch, kept abstract since a room is a space
+# to draw, not an object to render literally.
+classes = ["room"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="currentColor" opacity="0.14"/>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M9 21 L9 13 A3 3 0 0 1 15 13 L15 21" fill="none" stroke="currentColor" stroke-width="1.6"/>
+</svg>
+"""

package/data/sprites/spider-icon.toml

@@ -0,0 +1,21 @@
+# spider — the spider-and-fly board's own agent. A confident two-lobe body
+# (a lighter carved patch on the abdomen for shading) and eight thin
+# outward legs.
+classes = ["spider"]
+svg = """
+<svg viewBox="0 0 24 24" aria-hidden="true">
+  <ellipse cx="12" cy="16" rx="5.2" ry="4.8" fill="currentColor"/>
+  <ellipse cx="10.3" cy="14.3" rx="1.8" ry="1.4" fill="currentColor" opacity="0.3"/>
+  <circle cx="12" cy="9.6" r="3.2" fill="currentColor"/>
+  <g stroke="currentColor" stroke-width="1.1" fill="none" stroke-linecap="round">
+    <path d="M9.4 8 L2.2 4.4"/>
+    <path d="M9 10.2 L1.4 9.4"/>
+    <path d="M9.2 12.6 L2 14.2"/>
+    <path d="M10 15.4 L3.4 19"/>
+    <path d="M14.6 8 L21.8 4.4"/>
+    <path d="M15 10.2 L22.6 9.4"/>
+    <path d="M14.8 12.6 L22 14.2"/>
+    <path d="M14 15.4 L20.6 19"/>
+  </g>
+</svg>
+"""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "2.7.25",
+  "version": "2.8.0",
   "private": false,
   "type": "module",
   "description": "The Mechanical Code Talker (tmct) — a tolerant, offline, $0 chat surface that guides you toward precision queries about a software repository. ELIZA/PARRY-style but domain-obsessed with code. No model calls; no codebase index of its own.",
@@ -67,7 +67,8 @@
     "corpus/",
     "!corpus/wordnet/generate.mjs",
     "!corpus/namenet/generate.mjs",
-    "data/"
+    "data/",
+    "!data/sprites-large/"
   ],
   "publishConfig": {
     "access": "public"
@@ -139,6 +140,7 @@
     "build:chat-seed": "node scripts/build-chat-seed.mjs",
     "build:demo-graph": "node scripts/build-demo-graph.mjs",
     "build:demo-pack": "node scripts/build-demo-pack.mjs",
+    "build:demo-sprites-pack": "node scripts/build-demo-sprites-pack.mjs",
     "build:demo-memory": "node scripts/build-demo-memory.mjs",
     "gen:tool-docs": "node scripts/generate-tool-docs.mjs",
     "gen:collisions": "node scripts/generate-real-word-collisions.mjs",

package/src/adapters/corpus/sprite-large-template-files.mjs

@@ -0,0 +1,62 @@
+// sprite-large-template-files.mjs — the filesystem side of the sprite TIER
+// meant to be looked at closely (400px target, gradient/highlight shading):
+// read data/sprites-large/*.toml and expand each file's by-name material
+// references (sprite-materials.mjs's own `expandMaterialReferences`) before
+// handing the templates to the SAME pure resolver the icon tier already
+// uses (src/domain/sprite-templates.mjs). Mirrors sprite-template-files.mjs's
+// own readSpriteTemplateFiles idiom exactly (same directory-of-toml-files
+// shape, same per-file-defensive load) — the two loaders stay separate
+// files, never merged into one, because they point at different directories
+// and this one carries the extra material-expansion step the icon tier has
+// no use for.
+//
+// Node-only (readdirSync/readFileSync), and — per package.json's own
+// "!data/sprites-large/" exclusion — never reachable from an npm-installed
+// consumer at all: only this git checkout (dev) or the deployed site's own
+// fetched pack (scripts/build-demo-site.mjs's sprites-pack build step, which
+// calls this loader once, in Node, at build time) can read this tier. The
+// browser bundle never imports this module directly, the same reason
+// sprite-template-files.mjs's own header gives for the icon tier.
+
+import { readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { join, dirname } from "node:path";
+import { parse as parseToml } from "smol-toml";
+import { expandMaterialReferences } from "../../domain/sprite-materials.mjs";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+/** The sprite-tier template directory (data, not code) — every *.toml file
+ *  inside is loaded, in filename order, except `_materials.toml` itself
+ *  (that file is a shared reference table, not a template — see
+ *  sprite-materials.mjs, its palette is a plain JS constant, not read from
+ *  here; a stray `_materials.toml` is tolerated defensively if one is ever
+ *  added back, simply by never matching a real `classes` list). */
+export const SPRITE_LARGE_TEMPLATES_DIR = join(HERE, "..", "..", "..", "data", "sprites-large");
+
+/** Read every *.toml file in `dir` (sorted, deterministic), expand each
+ *  file's material references against sprite-materials.mjs's shared
+ *  palette, and return the flat array of fully-expanded template objects. A
+ *  missing directory or an unparseable file is DEFENSIVE (per-file: a broken
+ *  file is skipped, not fatal to the others) — a production page load can
+ *  never go blank because one hand-authored sprite has a typo.
+ *  test/adapters/sprite-large-template-files.test.mjs parses the real files
+ *  directly (not through this lenient loader) so a broken file still fails a
+ *  test loudly. */
+export function readSpriteLargeTemplateFiles(dir = SPRITE_LARGE_TEMPLATES_DIR) {
+  let files;
+  try {
+    files = readdirSync(dir).filter((f) => f.endsWith(".toml") && !f.startsWith("_")).sort();
+  } catch {
+    return [];
+  }
+  const templates = [];
+  for (const file of files) {
+    try {
+      const parsed = parseToml(readFileSync(join(dir, file), "utf8"));
+      templates.push(parsed);
+    } catch {
+      continue; // one malformed file never takes the others down
+    }
+  }
+  return expandMaterialReferences(templates);
+}

package/src/domain/sprite-materials.mjs

@@ -0,0 +1,73 @@
+// sprite-materials.mjs — the shared {light, base, dark} colour-triple palette
+// the sprite tier's gradient-shaded materials draw from, one treatment per
+// key. It exists so a hex triple is written ONCE and referenced by name from
+// every data/sprites-large/*.toml file that uses it, rather than the same
+// three hex values being hand-copied into six or more files (the drift this
+// project's own conventions already try to avoid elsewhere, e.g.
+// SOURCE_PRIOR/SPRITE_REGISTRY's single-frozen-table idiom).
+//
+// A raw taught mgx:madeOf value maps to a TREATMENT here, not one-for-one:
+// "gold" and "metal" both read as the same warm shiny-metal treatment,
+// "paper" and "cardboard" both read as the same matte-paper treatment — a
+// per-file [parameters.material.values] table names which of ITS OWN
+// plausible raw values map to which treatment (see data/sprites-large/*.toml),
+// this module only owns the treatments themselves.
+//
+// expandMaterialReferences is the one place that indirection gets resolved:
+// it turns a short by-name reference (`gold = "metal"`, valid TOML, safe to
+// repeat across files) into the full triple object sprite-templates.mjs's
+// resolver actually substitutes into an svg's three gradient stops. Domain
+// code downstream of this never needs to know the palette exists at all — it
+// only ever sees a [parameters.*.values] entry that is already either a
+// plain string (single-placeholder fill) or a complete {light,base,dark}
+// object (multi-placeholder fill), the same two shapes a hand-built test
+// fixture can supply directly with no palette involved.
+
+/** The 8 rendering treatments this pass covers (the operator's own read of
+ *  init's 17 raw mgx:madeOf strings: 8 are distinct shiny/matte/finish
+ *  treatments, the remaining 9 food/organic materials are a different
+ *  rendering problem and out of scope here). Every value is a real, plain
+ *  frozen {light, base, dark} hex triple — no computed shades — so the
+ *  gradient a sprite draws is exactly the three stops this table names. */
+export const MATERIAL_PALETTE = Object.freeze({
+  metal: Object.freeze({ light: "#f0dfa0", base: "#c9a24b", dark: "#8a6a1e" }),
+  paper: Object.freeze({ light: "#fdfaf1", base: "#e8dcbf", dark: "#b7a47c" }),
+  glass: Object.freeze({ light: "#eaf6f7", base: "#bfe2e7", dark: "#7fb6c1" }),
+  ceramic: Object.freeze({ light: "#fefefe", base: "#e6e1d8", dark: "#aba69c" }),
+  wood: Object.freeze({ light: "#c98f56", base: "#8a5a2e", dark: "#5a3a1c" }),
+  plastic: Object.freeze({ light: "#f3f3f3", base: "#c8c8c8", dark: "#8a8a8a" }),
+  wax: Object.freeze({ light: "#fff6de", base: "#f0d98c", dark: "#c9a94a" }),
+  "woven material": Object.freeze({ light: "#e8d9b7", base: "#c9a869", dark: "#8a6c3d" }),
+});
+
+/**
+ * Every [parameters.*.values] string entry, in every template, expanded from
+ * a treatment KEY (e.g. "metal") to that treatment's full {light,base,dark}
+ * object from `palette` — but only for a parameter that declares
+ * `placeholders` (the multi-placeholder shape); a parameter with only the
+ * older singular `placeholder` is left alone, since its values are literal
+ * fills, never palette references. A values entry that is already an object
+ * (a one-off hand-authored triple, not drawn from the shared palette) is
+ * left alone too. A string naming no known treatment is left as the plain
+ * string it was — spriteTemplateProblems then flags the leftover reference
+ * rather than this function silently rendering the wrong colour. Pure;
+ * `templates` is read only.
+ */
+export function expandMaterialReferences(templates, palette = MATERIAL_PALETTE) {
+  return (templates || []).map((t) => {
+    if (!t?.parameters) return t;
+    const parameters = {};
+    for (const [name, param] of Object.entries(t.parameters)) {
+      if (!param?.placeholders || !param?.values) {
+        parameters[name] = param;
+        continue;
+      }
+      const values = {};
+      for (const [key, value] of Object.entries(param.values)) {
+        values[key] = typeof value === "string" && palette[value] ? palette[value] : value;
+      }
+      parameters[name] = { ...param, values };
+    }
+    return { ...t, parameters };
+  });
+}

package/src/domain/sprite-size.mjs

@@ -0,0 +1,34 @@
+// sprite-size.mjs — a taught size-descriptive property (small/large/long/
+// tall — words the corpus's own WordNet-derived property vocabulary already
+// carries under mgx:hasProperty) resolved to a plain numeric render scale,
+// NOT a new template file: vector sprite art scales for free, so this
+// dimension costs nothing extra in the pack. The same "prove the mechanism,
+// no live consumer required yet" posture the icon tier's dog-with-colour
+// demo already established — no shipped world currently carries a size
+// property on a real object, so nothing calls this yet.
+
+const SIZE_PROPERTY_PREDICATE = "mgx:hasProperty";
+
+/** Closed vocabulary only: a size word absent from this table never moves
+ *  the scale, it simply doesn't match — the same never-guess posture every
+ *  other property lookup in this pack takes. */
+const SIZE_SCALE = Object.freeze({
+  small: 0.8,
+  large: 1.3,
+  long: 1.2,
+  tall: 1.25,
+});
+
+/**
+ * The render scale factor for `propertyFacts` (an instance's own small
+ * `{predicate, object}` fact set): the first mgx:hasProperty value found in
+ * SIZE_SCALE, else 1 (no size fact at all => the sprite's own natural size).
+ * Pure; `propertyFacts` is read only, never required to be non-empty.
+ */
+export function sizeScaleFor(propertyFacts) {
+  for (const f of propertyFacts || []) {
+    if (f?.predicate !== SIZE_PROPERTY_PREDICATE) continue;
+    if (Object.prototype.hasOwnProperty.call(SIZE_SCALE, f.object)) return SIZE_SCALE[f.object];
+  }
+  return 1;
+}