@polycode-projects/the-mechanical-code-talker 4.0.0 → 4.0.1

package/data/sprites/cabinet-icon.toml

@@ -1,13 +1,18 @@
 # 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.
+# wardrobe silhouette, the gap between the doors reading as the seam. Each
+# door carries a recessed raised-panel outline, the classic wardrobe-door
+# cue, plus a cornice band above and a plinth below so it reads as a
+# standing piece of furniture rather than a wall panel.
 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"/>
+  <rect x="4.5" y="2.5" width="15" height="1.6" fill="color-mix(in srgb, currentColor 70%, black)"/>
+  <rect x="4.5" y="20.1" width="15" height="1.4" fill="color-mix(in srgb, currentColor 70%, black)"/>
+  <rect x="6" y="5.4" width="4.2" height="13.4" rx="0.4" fill="none" stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="0.6"/>
+  <rect x="13.8" y="5.4" width="4.2" height="13.4" rx="0.4" fill="none" stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="0.6"/>
+  <circle cx="10.6" cy="12" r="1" fill="color-mix(in srgb, currentColor 65%, black)"/>
+  <circle cx="13.4" cy="12" r="1" fill="color-mix(in srgb, currentColor 65%, black)"/>
 </svg>
 """

package/data/sprites/cellar-icon.toml

@@ -1,12 +1,22 @@
-# cellar — an underground space: a room box with a stair stepping down and
-# stone coursing, so the room-kind icon reads as below ground rather than a
-# plain room, matching the underground border.
+# cellar — an underground space: a room box with a stair stepping down into
+# it and stone coursing on the back wall, so the room-kind icon reads as
+# below ground rather than a plain room, matching the underground border.
+# The wash is a fixed white/black tint rather than currentColor-mixed (the
+# same reason room.toml's own wash is fixed): a tint built from currentColor
+# reverses direction between a light and a dark theme, a plain white/black
+# one never does.
 classes = ["cellar"]
 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"/>
+  <defs>
+    <linearGradient id="cellar-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.06"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.22"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#cellar-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
-  <path d="M6 8 H10 V11 H14 V14 H18 V18 H6 Z" fill="currentColor" opacity="0.55"/>
-  <path d="M3 12 H21 M3 16.5 H21" stroke="currentColor" stroke-width="0.5" opacity="0.4"/>
+  <path d="M8 3 V21 M14 3 V21" stroke="currentColor" stroke-width="0.4" opacity="0.25"/>
+  <path d="M6 7.5 H10 V10.5 H14 V13.5 H18 V17.5 H6 Z" fill="currentColor"/>
 </svg>
 """

package/data/sprites/container-icon.toml

@@ -1,12 +1,16 @@
 # 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.
+# chest silhouette with a carved lid-seam and a latch plate with its own
+# keyhole cut into it, so "container" reads as a locked chest rather than
+# a plain crate.
 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"/>
+  <rect x="3" y="10" width="18" height="1.8" fill="color-mix(in srgb, currentColor 70%, black)"/>
+  <rect x="10" y="9" width="4" height="3.2" rx="0.5" fill="color-mix(in srgb, currentColor 55%, black)"/>
+  <circle cx="12" cy="10.4" r="0.55" fill="color-mix(in srgb, currentColor 20%, white)"/>
+  <path d="M11.8 10.9 L12.2 10.9 L12.45 12 L11.55 12 Z" fill="color-mix(in srgb, currentColor 20%, white)"/>
 </svg>
 """

package/data/sprites/desk-icon.toml

@@ -1,13 +1,16 @@
 # desk — Ashcombe Hall's own study desk: a tabletop bar over two drawer
-# blocks with pull-knobs, on tapered legs.
+# blocks with pull-knobs and a drawer-front groove, 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"/>
+  <rect x="3.4" y="7.3" width="17.2" height="0.6" fill="color-mix(in srgb, currentColor 30%, white)"/>
+  <rect x="4.4" y="9.6" width="6.6" height="5.6" rx="0.6" fill="currentColor"/>
+  <rect x="13" y="9.6" width="6.6" height="5.6" rx="0.6" fill="currentColor"/>
+  <path d="M5.4 12.4 H10" stroke="color-mix(in srgb, currentColor 60%, black)" stroke-width="0.5"/>
+  <path d="M14 12.4 H18.6" stroke="color-mix(in srgb, currentColor 60%, black)" stroke-width="0.5"/>
+  <circle cx="9.6" cy="12.4" r="0.6" fill="color-mix(in srgb, currentColor 55%, black)"/>
+  <circle cx="16.4" cy="12.4" r="0.6" fill="color-mix(in srgb, currentColor 55%, black)"/>
   <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

@@ -1,15 +1,18 @@
 # 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.
+# reads as one dog rather than two unrelated animals. A muzzle bump breaks
+# the head silhouette and the tail curls up and alert rather than hanging,
+# so the pose itself carries the identity even before any colour is added.
 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"/>
+  <path d="M19 13.4 C22.4 11.6 23.4 14.8 21.4 16.2 C20.6 15 19.8 14.2 19 13.4 Z" 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">
+  <ellipse cx="3.3" cy="9.8" rx="1.7" ry="1.3" fill="currentColor"/>
+  <path d="M4.6 6.4 C2.8 5 1.8 3.4 2.2 2.4 C4.2 2.6 6 4.4 6.4 6.6 Z" fill="currentColor"/>
+  <circle cx="5.3" cy="8.2" r="0.45" fill="color-mix(in srgb, currentColor 20%, black)"/>
+  <g stroke="currentColor" stroke-width="1.8" stroke-linecap="round">
     <line x1="9" y1="19" x2="9" y2="22"/>
     <line x1="17" y1="19" x2="17" y2="22"/>
   </g>

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

@@ -1,21 +1,22 @@
 # 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.
+# is black". Same silhouette as dog.toml (muzzle bump, curled alert tail,
+# floppy ear), 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"/>
+  <path d="M19 13.4 C22.4 11.6 23.4 14.8 21.4 16.2 C20.6 15 19.8 14.2 19 13.4 Z" 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">
+  <ellipse cx="3.3" cy="9.8" rx="1.7" ry="1.3" fill="{{FILL}}" stroke="currentColor" stroke-width="0.9"/>
+  <path d="M4.6 6.4 C2.8 5 1.8 3.4 2.2 2.4 C4.2 2.6 6 4.4 6.4 6.6 Z" fill="{{FILL}}" stroke="currentColor" stroke-width="0.9"/>
+  <g stroke="currentColor" stroke-width="1.8" stroke-linecap="round">
     <line x1="9" y1="19" x2="9" y2="22"/>
     <line x1="17" y1="19" x2="17" y2="22"/>
   </g>

package/data/sprites/drawing-room-icon.toml

@@ -1,13 +1,22 @@
 # drawing-room — a room floor plan marked by a framed picture on the wall (the
 # portrait hangs here), so the room-kind icon reads as the drawing room rather
-# than a plain room.
+# than a plain room. The wash is a fixed white/black tint rather than
+# currentColor-mixed (see room-icon.toml's own header for why), and the
+# canvas behind the framed bust gets its own lighter tone so frame, canvas
+# and figure read as three distinct layers rather than one flat block.
 classes = ["drawing-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"/>
+  <defs>
+    <linearGradient id="drawing-room-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#drawing-room-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
-  <rect x="8.5" y="7" width="7" height="6" rx="0.4" fill="none" stroke="currentColor" stroke-width="1.3"/>
-  <circle cx="12" cy="9.4" r="1.1" fill="currentColor" opacity="0.7"/>
-  <path d="M9.6 12.4 C9.6 10.9 10.6 10 12 10 C13.4 10 14.4 10.9 14.4 12.4 Z" fill="currentColor" opacity="0.7"/>
+  <rect x="8.5" y="7" width="7" height="6" rx="0.4" fill="color-mix(in srgb, currentColor 22%, white)" stroke="currentColor" stroke-width="1.3"/>
+  <circle cx="12" cy="9.4" r="1.1" fill="currentColor"/>
+  <path d="M9.6 12.4 C9.6 10.9 10.6 10 12 10 C13.4 10 14.4 10.9 14.4 12.4 Z" fill="currentColor"/>
 </svg>
 """

package/data/sprites/egg-icon.toml

@@ -1,9 +1,12 @@
-# egg — the spider-and-fly board's laid egg. The plain shell silhouette
-# plus one small carved highlight.
+# egg — the spider-and-fly board's laid egg: the plain shell silhouette,
+# lit from the upper left with a lighter highlight and a darker shadow
+# side so the round shell reads as three-dimensional rather than a flat
+# tinted disc.
 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"/>
+  <path d="M12 2 C16 2 19 8.6 19.9 14 C18.4 15.2 16.6 15.8 15 14.6 C16.2 11 15.6 5.4 12 2 Z" fill="color-mix(in srgb, currentColor 65%, black)"/>
+  <ellipse cx="9.4" cy="8.8" rx="1.9" ry="2.8" fill="color-mix(in srgb, currentColor 25%, white)"/>
 </svg>
 """

package/data/sprites/fly-icon.toml

@@ -1,17 +1,22 @@
-# 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.
+# fly — the spider-and-fly board's other agent. A round head with a pair
+# of large compound eyes, a tapered body with a carved highlight,
+# translucent wings (opacity carries real translucency here, not a
+# decorative wash, so it stays), and two thin trailing legs.
 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"/>
+  <ellipse cx="11.1" cy="12" rx="1.1" ry="1.7" fill="color-mix(in srgb, currentColor 70%, black)"/>
   <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">
+  <g fill="color-mix(in srgb, currentColor 70%, black)">
+    <ellipse cx="10.1" cy="6.1" rx="1.5" ry="1.9" transform="rotate(-18 10.1 6.1)"/>
+    <ellipse cx="13.9" cy="6.1" rx="1.5" ry="1.9" transform="rotate(18 13.9 6.1)"/>
+  </g>
+  <g stroke="currentColor" stroke-width="1.1" stroke-linecap="round">
     <path d="M9.6 17 L7.4 19.4"/>
     <path d="M14.4 17 L16.6 19.4"/>
   </g>

package/data/sprites/furniture-icon.toml

@@ -1,12 +1,14 @@
 # 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.
+# of its own: a solid console-table silhouette with a stretcher bar joining
+# the tapered legs low down, the structural cue that reads as "a table"
+# rather than "a shelf on the wall".
 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"/>
+  <rect x="3.5" y="6.5" width="17" height="1" fill="color-mix(in srgb, currentColor 30%, white)"/>
   <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"/>
+  <rect x="6.4" y="15.6" width="11.2" height="1.3" rx="0.4" fill="color-mix(in srgb, currentColor 70%, black)"/>
 </svg>
 """

package/data/sprites/garden-icon.toml

@@ -1,12 +1,19 @@
 # garden — an outdoor space, so no room box: a tree over a ground line reads
 # as open air rather than an interior, matching the outdoor room-kind border.
+# The canopy is built from three overlapping lobes rather than one plain
+# circle so it reads as foliage, and a couple of grass tufts at the base
+# ground it as cultivated planting rather than bare earth.
 classes = ["garden"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <path d="M3 20 H21" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
   <path d="M12 20 V12" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
-  <circle cx="12" cy="8.5" r="5" fill="currentColor" opacity="0.7"/>
-  <circle cx="7.5" cy="17" r="1" fill="currentColor" opacity="0.5"/>
-  <circle cx="16.5" cy="17" r="1" fill="currentColor" opacity="0.5"/>
+  <circle cx="8.4" cy="9.4" r="3.6" fill="currentColor"/>
+  <circle cx="15.6" cy="9.4" r="3.6" fill="currentColor"/>
+  <circle cx="12" cy="6.6" r="4.2" fill="currentColor"/>
+  <g stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="1" stroke-linecap="round">
+    <path d="M5.4 20 C5.4 18.6 6.2 17.8 6.2 17.8"/>
+    <path d="M18.2 20 C18.2 18.6 17.4 17.8 17.4 17.8"/>
+  </g>
 </svg>
 """

package/data/sprites/key-icon.toml

@@ -1,6 +1,7 @@
 # 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.
+# legible at a 44px render, plus a thin specular arc tracing the bow's own
+# upper-left curve so the ring reads as metal rather than a flat ring.
 classes = ["key"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
@@ -8,5 +9,6 @@ svg = """
   <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"/>
+  <path d="M5 6.6 A4.4 4.4 0 0 1 8.6 4.8" fill="none" stroke="color-mix(in srgb, currentColor 25%, white)" stroke-width="1" stroke-linecap="round"/>
 </svg>
 """

package/data/sprites/kitchen-icon.toml

@@ -1,13 +1,22 @@
-# kitchen — a room floor plan marked by a stove with two burners, the same
-# distinguishing cue the large tier uses, so the room-kind icon reads as a
-# kitchen rather than a plain room.
+# kitchen — a room floor plan marked by a stove with two burners and an
+# oven-door handle, the same distinguishing cue the large tier uses, so
+# the room-kind icon reads as a kitchen rather than a plain room. The wash
+# is a fixed white/black tint rather than currentColor-mixed (see
+# room-icon.toml's own header for why).
 classes = ["kitchen"]
 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"/>
+  <defs>
+    <linearGradient id="kitchen-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#kitchen-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
   <rect x="8" y="10" width="8" height="7" rx="0.6" fill="none" stroke="currentColor" stroke-width="1.2"/>
-  <circle cx="10.5" cy="12.6" r="1" fill="currentColor" opacity="0.7"/>
-  <circle cx="13.5" cy="12.6" r="1" fill="currentColor" opacity="0.7"/>
+  <circle cx="10.5" cy="12.4" r="1" fill="currentColor"/>
+  <circle cx="13.5" cy="12.4" r="1" fill="currentColor"/>
+  <path d="M9.4 15.8 H14.6" stroke="currentColor" stroke-width="0.9" stroke-linecap="round"/>
 </svg>
 """

package/data/sprites/lamp-icon.toml

@@ -1,11 +1,16 @@
 # lamp — Ashcombe Hall's own study lamp: a Victorian hurricane-lamp
-# silhouette — base, glass globe, a neck, and a small carved flame.
+# silhouette — base, glass globe, a neck, and a small flame. The globe gets
+# its own lighter glass tone plus a specular streak so it reads as glass
+# distinct from the solid metal base and neck, and the flame is a fixed
+# warm amber regardless of theme — a flame's colour comes from what's
+# burning, not from CSS.
 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"/>
+  <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="color-mix(in srgb, currentColor 55%, white)"/>
+  <path d="M9.2 11.4 C9 13.4 9.1 15.6 9.9 17.4" fill="none" stroke="color-mix(in srgb, currentColor 20%, white)" stroke-width="0.8" stroke-linecap="round"/>
+  <rect x="10.6" y="6.4" width="2.8" height="4.4" rx="0.4" fill="currentColor"/>
+  <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="#f4b73f"/>
 </svg>
 """

package/data/sprites/letter-icon.toml

@@ -1,11 +1,14 @@
 # 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.
+# envelope with a folded flap (a darker overlay, the same carved-seam trick
+# as the lid on container.toml) and a wax seal. The seal is a fixed red —
+# a wax seal's colour comes from the wax pressed into it, not the paper
+# underneath, the same reasoning as the flame on lamp.toml.
 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"/>
+  <path d="M3 6 L21 6 L21 6.8 L12 13.8 L3 6.8 Z" fill="color-mix(in srgb, currentColor 78%, black)"/>
+  <path d="M4 7.6 L11 12.9" stroke="color-mix(in srgb, currentColor 25%, white)" stroke-width="0.5" opacity="0.6"/>
+  <circle cx="12" cy="12.4" r="1.15" fill="#8a2e2e"/>
 </svg>
 """

package/data/sprites/library-icon.toml

@@ -1,12 +1,23 @@
 # library — a room floor plan marked by an open book, so the room-kind icon
 # reads as a library rather than a plain room: the washed square is room.toml's
 # own shape, the two-page V is the same open-book cue the large tier uses.
+# One page is shaded a touch darker than the other so the spine reads as a
+# fold rather than a seam drawn on a flat card. The wash is a fixed
+# white/black tint rather than currentColor-mixed (see room-icon.toml's own
+# header for why).
 classes = ["library"]
 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"/>
+  <defs>
+    <linearGradient id="library-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#library-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
-  <path d="M12 9 C10.4 7.9 8.2 7.6 6.4 8.1 V15.6 C8.2 15.1 10.4 15.4 12 16.5 C13.6 15.4 15.8 15.1 17.6 15.6 V8.1 C15.8 7.6 13.6 7.9 12 9 Z" fill="currentColor" opacity="0.75"/>
-  <path d="M12 9 V16.5" stroke="currentColor" stroke-width="0.5" opacity="0.5"/>
+  <path d="M12 9 C10.4 7.9 8.2 7.6 6.4 8.1 V15.6 C8.2 15.1 10.4 15.4 12 16.5 Z" fill="currentColor"/>
+  <path d="M12 9 C13.6 7.9 15.8 7.6 17.6 8.1 V15.6 C15.8 15.1 13.6 15.4 12 16.5 Z" fill="color-mix(in srgb, currentColor 78%, black)"/>
+  <path d="M12 9 V16.5" stroke="color-mix(in srgb, currentColor 30%, white)" stroke-width="0.4"/>
 </svg>
 """

package/data/sprites/pan-icon.toml

@@ -1,11 +1,15 @@
 # pan — the kitchen's default portable: a frying pan seen from above with a
-# long handle, so a taken pan reads as its own thing rather than the generic
-# portable box.
+# long handle. The cooking surface reads darker than the rim (a pan's own
+# interior is seasoned/scorched, its rim stays brighter metal) and the
+# handle carries a rivet, so a taken pan reads as its own thing rather than
+# the generic portable box.
 classes = ["pan"]
 svg = """
 <svg viewBox="0 0 24 24" aria-hidden="true">
   <circle cx="10" cy="14" r="6" fill="currentColor"/>
-  <circle cx="10" cy="14" r="3.6" fill="currentColor" opacity="0.35"/>
+  <circle cx="10" cy="14" r="4.8" fill="color-mix(in srgb, currentColor 70%, black)"/>
+  <path d="M6.6 11 A4.8 4.8 0 0 1 13 10" fill="none" stroke="color-mix(in srgb, currentColor 20%, white)" stroke-width="0.6" stroke-linecap="round" opacity="0.6"/>
   <rect x="15" y="13" width="7" height="2" rx="1" fill="currentColor"/>
+  <circle cx="16.4" cy="14" r="0.5" fill="color-mix(in srgb, currentColor 55%, black)"/>
 </svg>
 """

package/data/sprites/person-icon.toml

@@ -1,10 +1,14 @@
 # person — the generic fallback for anyone with no NPC sprite of their own
-# (see butler/housekeeper/cook/gardener for the named Ashcombe Hall staff).
+# (see butler/housekeeper/cook/gardener for the named Ashcombe Hall staff):
+# two shoulder notches break the torso silhouette where sleeves would seam,
+# so it reads as a clothed figure rather than a bare blob-with-a-head, while
+# staying deliberately unadorned next to the named staff's own props.
 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"/>
+  <path d="M7.6 14.4 L9.4 13" stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="0.7" opacity="0.6" stroke-linecap="round"/>
+  <path d="M16.4 14.4 L14.6 13" stroke="color-mix(in srgb, currentColor 55%, black)" stroke-width="0.7" opacity="0.6" stroke-linecap="round"/>
 </svg>
 """

package/data/sprites/poodle-icon.toml

@@ -5,7 +5,7 @@ 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"/>
+  <ellipse cx="10.8" cy="13.2" rx="1.8" ry="1.3" fill="color-mix(in srgb, currentColor 70%, black)"/>
   <circle cx="7" cy="8.5" r="4" fill="currentColor"/>
   <g fill="currentColor">
     <circle cx="4" cy="6" r="1.6"/>

package/data/sprites/portable-icon.toml

@@ -1,12 +1,14 @@
 # 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.
+# of its own: a drawstring parcel silhouette with a small tag hanging from
+# the neck, so it reads as "an unspecified small thing someone packed"
+# rather than a gift or a sack of grain.
 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"/>
+  <ellipse cx="9.8" cy="11.6" rx="1.6" ry="2.1" fill="color-mix(in srgb, currentColor 25%, white)"/>
+  <path d="M14.4 6.6 L17.4 8.8 L15.6 10.4 L14 8 Z" fill="color-mix(in srgb, currentColor 65%, black)"/>
+  <circle cx="16.1" cy="8.5" r="0.35" fill="color-mix(in srgb, currentColor 20%, white)"/>
 </svg>
 """

package/data/sprites/portrait-icon.toml

@@ -1,12 +1,15 @@
 # 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.
+# silhouette so it reads as a picture of someone, not an empty frame. Canvas
+# and figure use fixed cream/sepia tones rather than currentColor opacity —
+# a painting's own palette doesn't belong to the page theme, and a flat
+# opacity wash would shift between a light and a dark backdrop anyway.
 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"/>
+  <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="#f4ecd8"/>
+  <circle cx="12" cy="10.4" r="2.3" fill="#8a6a52"/>
+  <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="#8a6a52"/>
 </svg>
 """

package/data/sprites/room-icon.toml

@@ -1,10 +1,19 @@
 # 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.
+# to draw, not an object to render literally. The wash is a fixed
+# white/black tint rather than currentColor-mixed: a tint built from
+# currentColor reverses which side looks lighter between a light and a
+# dark theme, a plain white/black one never does.
 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"/>
+  <defs>
+    <linearGradient id="room-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#room-wash)"/>
   <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

@@ -1,12 +1,18 @@
 # 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.
+# (a darker carved patch on the abdomen for shading), two small fixed-dark
+# eye dots (the same restrained fixed-accent technique the large tier's
+# badger/vole use for an identity marking, not a coat colour) 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"/>
+  <ellipse cx="10.3" cy="14.3" rx="1.8" ry="1.4" fill="color-mix(in srgb, currentColor 70%, black)"/>
   <circle cx="12" cy="9.6" r="3.2" fill="currentColor"/>
+  <g fill="#1c1c1c">
+    <circle cx="10.7" cy="8.7" r="0.5"/>
+    <circle cx="13.3" cy="8.7" r="0.5"/>
+  </g>
   <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"/>

package/data/sprites/study-icon.toml

@@ -1,11 +1,19 @@
 # study — a room floor plan marked by a writing desk against one wall, so the
 # room-kind icon reads as the study you start in rather than a plain room.
+# The wash is a fixed white/black tint rather than currentColor-mixed (see
+# room-icon.toml's own header for why).
 classes = ["study"]
 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"/>
+  <defs>
+    <linearGradient id="study-wash" x1="0" y1="0" x2="0.4" y2="1">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#000000" stop-opacity="0.14"/>
+    </linearGradient>
+  </defs>
+  <rect x="3" y="3" width="18" height="18" rx="1" fill="url(#study-wash)"/>
   <rect x="3" y="3" width="18" height="18" rx="1" fill="none" stroke="currentColor" stroke-width="1.6"/>
-  <rect x="7" y="11" width="10" height="2.4" fill="currentColor" opacity="0.7"/>
+  <rect x="7" y="11" width="10" height="2.4" fill="currentColor"/>
   <path d="M8 13.4 V17 M16 13.4 V17" stroke="currentColor" stroke-width="1.2"/>
   <rect x="9.6" y="7.6" width="4.8" height="3" fill="none" stroke="currentColor" stroke-width="1"/>
 </svg>