@dotcraft/avatar 0.7.1 → 0.7.3

package/src/accessories.css

@@ -9,6 +9,6 @@
 .dca-robot[data-gesture='blink'] .dca-part-caret { animation: none !important; }
 
 /* Lift an upright tool beside the face rather than sweeping it across the screen. */
-.dca-robot[data-held-state='holding'] .dca-action-celebrate :is(.dca-part-arm-l-w, .dca-part-arm-l) {
+.dca-robot[data-held-state='holding'] .dca-action-celebrate :is(.dca-part-arm-l-w, .dca-part-arm-l-b, .dca-part-arm-l) {
   transform: translate(30px, -65px) rotate(20deg);
 }

package/src/appearanceModel.ts

@@ -1,38 +1,20 @@
-// Frozen v1 draw order. IDs are serialized; positions are only sampling weights.
-export const primaryIds = ['none', 'baseball-cap', 'bucket-hat', 'beret', 'beanie', 'top-hat', 'wizard-hat', 'chef-hat', 'party-hat', 'crown', 'hard-hat', 'nightcap', 'straw-hat', 'poop', 'banana', 'fried-egg', 'rubber-duck', 'paper-boat', 'traffic-cone', 'sprout', 'donut'] as const
-export const heldIds = ['task-board', 'wrench', 'shield', 'magnifier', 'control-panel'] as const
-export type HeldId = typeof heldIds[number]
-export const secondaryIds = ['none', 'forehead-goggles', ...heldIds] as const
-export type PrimaryId = typeof primaryIds[number]
-export type SecondaryId = typeof secondaryIds[number]
-export type DecorationId = Exclude<PrimaryId | SecondaryId, 'none'>
+import { conflicts, itemOf, items, rarities, slots, type BackId, type FaceId, type HandId, type HeadId, type ItemId, type ItemOf, type Rarity, type SkinId, type Slot, type Zone } from './items.js'
+
 export interface Appearance {
-  version: 2
+  version: 1
   palette: number
   baseFace: number
-  primary: PrimaryId
-  secondary: SecondaryId
+  head: HeadId | 'none'
+  face: FaceId | 'none'
+  hand: HandId | 'none'
+  back: BackId | 'none'
+  skin: SkinId | 'none'
 }
+export type SlotValue<S extends Slot> = ItemOf<S> | 'none'
+
+export const slotPresence: Record<Slot, number> = { head: .85, face: .35, hand: .4, back: .25, skin: .3 }
+export const rarityWeights: Record<Rarity, number> = { common: 55, uncommon: 27, rare: 12, epic: 5, legendary: 1 }
 
-// Explicit allow-list, including the undecorated head. No cartesian-product fallback.
-const faceAccessories = ['none', ...heldIds] as const
-export const compatibility: Record<PrimaryId, readonly SecondaryId[]> = {
-  none: [...faceAccessories, 'forehead-goggles'],
-  'baseball-cap': faceAccessories, 'bucket-hat': faceAccessories, beret: faceAccessories,
-  beanie: faceAccessories, 'top-hat': faceAccessories, 'wizard-hat': faceAccessories,
-  'chef-hat': faceAccessories, 'party-hat': faceAccessories, crown: faceAccessories,
-  'hard-hat': faceAccessories, nightcap: faceAccessories, 'straw-hat': faceAccessories,
-  poop: [...faceAccessories, 'forehead-goggles'], banana: [...faceAccessories, 'forehead-goggles'],
-  'fried-egg': [...faceAccessories, 'forehead-goggles'], 'rubber-duck': [...faceAccessories, 'forehead-goggles'],
-  'paper-boat': [...faceAccessories, 'forehead-goggles'], 'traffic-cone': [...faceAccessories, 'forehead-goggles'],
-  sprout: [...faceAccessories, 'forehead-goggles'], donut: [...faceAccessories, 'forehead-goggles'],
-}
-export function isCompatible(primary: PrimaryId, secondary: SecondaryId) {
-  return compatibility[primary].includes(secondary)
-}
-export function withPrimary(appearance: Appearance, primary: PrimaryId): Appearance {
-  return { ...appearance, primary, secondary: isCompatible(primary, appearance.secondary) ? appearance.secondary : 'none' }
-}
 export function hashSeed(seed: string): number {
   let value = 0x811c9dc5
   for (let index = 0; index < seed.length; index++) value = Math.imul(value ^ seed.charCodeAt(index), 0x01000193)
@@ -41,18 +23,56 @@ export function hashSeed(seed: string): number {
   value ^= value >>> 15; value = Math.imul(value, 0x846ca68b)
   return (value ^ (value >>> 16)) >>> 0
 }
-export function isHeld(id: SecondaryId): id is HeldId { return (heldIds as readonly string[]).includes(id) }
-export const originalAppearance: Appearance = { version: 2, palette: -1, baseFace: 0, primary: 'none', secondary: 'none' }
+export const originalAppearance: Appearance = { version: 1, palette: -1, baseFace: 0, head: 'none', face: 'none', hand: 'none', back: 'none', skin: 'none' }
 export function normalizeName(name: string): string { return name.trim().normalize('NFC') }
+
+export function equippedIds(appearance: Appearance): ItemId[] {
+  return slots.map(slot => appearance[slot]).filter((id): id is ItemId => id !== 'none')
+}
+export function occupiedZones(appearance: Appearance): Set<Zone> {
+  return new Set(equippedIds(appearance).flatMap(id => [...itemOf(id).zones]))
+}
+export function canEquip<S extends Slot>(appearance: Appearance, slot: S, id: SlotValue<S>): boolean {
+  if (id === 'none') return true
+  if (itemOf(id).slot !== slot) return false
+  return slots.every(other => other === slot || appearance[other] === 'none' || !conflicts(appearance[other] as ItemId, id))
+}
+export function equip<S extends Slot>(appearance: Appearance, slot: S, id: SlotValue<S>): { appearance: Appearance; cleared: Slot[] } {
+  if (id !== 'none' && itemOf(id).slot !== slot) throw new TypeError(`Cannot equip ${id} in the ${slot} slot`)
+  const next: Appearance = { ...appearance, [slot]: id }
+  const cleared: Slot[] = []
+  if (id !== 'none') for (const other of slots) {
+    const current = next[other]
+    if (other !== slot && current !== 'none' && conflicts(current, id)) { (next as Record<Slot, string>)[other] = 'none'; cleared.push(other) }
+  }
+  return { appearance: next, cleared }
+}
+export function hasConflicts(appearance: Appearance): boolean {
+  const ids = equippedIds(appearance)
+  return ids.some((a, index) => ids.slice(index + 1).some(b => conflicts(a, b)))
+}
+
 export function deriveAppearance(name: string): Appearance {
   const seed = normalizeName(name)
   if (!seed) return { ...originalAppearance }
   const draw = (dimension: string) => hashSeed(JSON.stringify(['dotcraft-avatar', 1, seed, dimension])) / 0x100000000
-  const primary = primaryIds[Math.floor(draw('primary') * primaryIds.length)]
-  const choices = compatibility[primary].filter(id => id !== 'none')
-  const secondaryDraw = (dimension: string) => hashSeed(JSON.stringify(['dotcraft-avatar', 2, seed, dimension])) / 0x100000000
-  const secondary = secondaryDraw('secondary-presence') < .5 ? 'none' : choices[Math.floor(secondaryDraw('secondary-item') * choices.length)]
-  return { version: 2, palette: Math.floor(draw('palette') * 12), baseFace: Math.floor(draw('face') * 5), primary, secondary }
+  const appearance: Appearance = { ...originalAppearance, palette: Math.floor(draw('palette') * 12), baseFace: Math.floor(draw('face') * 5) }
+  const occupied = new Set<Zone>()
+  for (const slot of slots) {
+    if (draw(`${slot}-presence`) >= slotPresence[slot]) continue
+    const slotItems = items.filter(item => item.slot === slot)
+    const tiers = rarities.filter(rarity => slotItems.some(item => item.rarity === rarity))
+    let roll = draw(`${slot}-rarity`) * tiers.reduce((sum, rarity) => sum + rarityWeights[rarity], 0)
+    let rarity: Rarity = tiers[tiers.length - 1]
+    for (const tier of tiers) { roll -= rarityWeights[tier]; if (roll < 0) { rarity = tier; break } }
+    // A tier with no zone-compatible item leaves the slot empty, so rare combinations stay rare.
+    const pool = slotItems.filter(item => item.rarity === rarity && item.zones.every(zone => !occupied.has(zone)))
+    if (!pool.length) continue
+    const pick = pool[Math.floor(draw(`${slot}-item`) * pool.length)]
+    ;(appearance as Record<Slot, string>)[slot] = pick.id
+    for (const zone of pick.zones) occupied.add(zone)
+  }
+  return appearance
 }
 export function sampleSeed(seed: string, round: number, index: number) {
   return JSON.stringify([seed, round, index])

package/src/composer/styles/energy.css

@@ -72,11 +72,45 @@
       calc(h + 27.55)) 36%, transparent));
 }
 
+@keyframes dca-skin-energy {
+  0%, 100% { opacity: 0; }
+  50% { opacity: var(--dca-skin-energy-peak); }
+}
+
+[data-mascot-effort='medium'] .dca-robot[data-effects='live'] .dca-skin-energy {
+  --dca-skin-energy-peak: .16;
+  animation: dca-skin-energy 6s ease-in-out infinite;
+}
+
+[data-mascot-effort='high'] .dca-robot[data-effects='live'] .dca-skin-energy {
+  --dca-skin-energy-peak: .26;
+  animation: dca-skin-energy 3.8s ease-in-out infinite;
+}
+
+[data-mascot-effort='extraHigh'] .dca-robot[data-effects='live'] .dca-skin-energy {
+  --dca-skin-energy-peak: .38;
+  animation: dca-skin-energy 2.8s ease-in-out infinite;
+}
+
+[data-mascot-effort='medium'] .dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy, .dca-skin-holo) stop { animation-duration: 4.6s; }
+[data-mascot-effort='high'] .dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy, .dca-skin-holo) stop { animation-duration: 3.2s; }
+[data-mascot-effort='extraHigh'] .dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy, .dca-skin-holo) stop { animation-duration: 2.2s; }
+[data-mascot-effort='medium'] .dca-robot[data-effects='live'] .dca-fx-sheen { animation-duration: 3.4s; }
+[data-mascot-effort='high'] .dca-robot[data-effects='live'] .dca-fx-sheen { animation-duration: 2.4s; }
+[data-mascot-effort='extraHigh'] .dca-robot[data-effects='live'] .dca-fx-sheen { animation-duration: 1.6s; }
+[data-mascot-effort='high'] .dca-robot[data-effects='live'] [data-skin-overlay='galaxy'] .dca-fx-node { animation-duration: 1.1s; }
+[data-mascot-effort='extraHigh'] .dca-robot[data-effects='live'] [data-skin-overlay='galaxy'] .dca-fx-node { animation-duration: .7s; }
+
 [data-mascot-context='max'] .dca-robot {
   animation: composer-mascot-max-overdrive-edge 3.8s ease-in-out infinite;
   will-change: filter;
 }
 
+[data-mascot-context='max'] .dca-robot[data-effects='live'] .dca-skin-energy {
+  --dca-skin-energy-peak: .3;
+  animation: dca-skin-energy 3.8s ease-in-out infinite;
+}
+
 [data-mascot-context='max'] .dca-robot .dca-paint-body stop:nth-child(1) {
   animation: composer-mascot-max-coat-dark 3.8s ease-in-out infinite;
 }

package/src/decorationCatalog.ts

@@ -1,45 +1,110 @@
-import { compatibility, primaryIds, type DecorationId, type PrimaryId, type SecondaryId } from './appearanceModel.js'
+import { itemOf, items, rarities, seriesIds, slots, type Item, type ItemId, type Rarity, type Series, type Slot } from './items.js'
 
-export interface Decoration {
-  id: DecorationId
+export interface DecorationCopy {
   name: string
-  category: 'Hats' | 'Novelty' | 'Accessories'
   feature: string
   colors: readonly string[]
   mount: string
 }
-export const decorations: Decoration[] = [
-  { id: 'baseball-cap', name: 'Baseball cap', category: 'Hats', feature: 'Rounded crown with a short right-facing brim', colors: ['#e87967', '#b94f50', '#f5a18c'], mount: 'Crown overlaps the top edge; the brim stays inside the body' },
-  { id: 'bucket-hat', name: 'Bucket hat', category: 'Hats', feature: 'Flat top with a continuous downward brim', colors: ['#94bda6', '#5b887a', '#bed8c1'], mount: 'Brim follows the top edge with a slight center overlap' },
-  { id: 'beret', name: 'Beret', category: 'Hats', feature: 'Soft left-leaning crown with a short stem', colors: ['#b17498', '#784c71', '#cf9db5'], mount: 'Narrow band rests on top; the crown leans left' },
-  { id: 'beanie', name: 'Beanie', category: 'Hats', feature: 'Rounded crown and wide folded cuff with minimal texture', colors: ['#e9a653', '#bc753d', '#f7c676'], mount: 'Folded cuff sits on the top edge; crown stays centered' },
-  { id: 'top-hat', name: 'Top hat', category: 'Hats', feature: 'Tall crown, narrow brim, and burgundy band', colors: ['#465069', '#293247', '#c96e85'], mount: 'Narrow brim rests flat on top; crown tapers at its base' },
-  { id: 'wizard-hat', name: 'Wizard hat', category: 'Hats', feature: 'Curved point, wide brim, and gold star', colors: ['#8773c1', '#594b93', '#f4cc75'], mount: 'Wide brim rests on top; point curves into the center safe area' },
-  { id: 'chef-hat', name: 'Chef hat', category: 'Hats', feature: 'Three-lobed puff with an upright band', colors: ['#f5eee3', '#d7caba', '#fffaf1'], mount: 'Band rests at the center of the top edge' },
-  { id: 'party-hat', name: 'Party hat', category: 'Hats', feature: 'Cone with two colored bands and a pom-pom', colors: ['#ea9baf', '#8075b7', '#f5d07b'], mount: 'Shallow curved base follows the top of the body' },
-  { id: 'crown', name: 'Crown', category: 'Hats', feature: 'Three rounded points with a central sapphire', colors: ['#efc65c', '#c99139', '#73b8cc'], mount: 'Curved gold band wraps the top edge; all points face up' },
-  { id: 'hard-hat', name: 'Hard hat', category: 'Hats', feature: 'Rounded shell, center ridge, and short front brim', colors: ['#f5bd48', '#d68d32', '#ffdc79'], mount: 'Short brim overlaps the top edge; ridge stays centered' },
-  { id: 'nightcap', name: 'Nightcap', category: 'Hats', feature: 'Soft drooping point with a pom-pom', colors: ['#789cc9', '#4c709f', '#dce8f4'], mount: 'Soft band follows the top edge; pom-pom stays upper right' },
-  { id: 'straw-hat', name: 'Straw hat', category: 'Hats', feature: 'Low round crown, wide oval brim, and red band', colors: ['#e8c78a', '#c49b5e', '#c57568'], mount: 'Wide brim rests flat without entering the arm areas' },
-  { id: 'poop', name: 'Poop', category: 'Novelty', feature: 'Three rounded layers with a playful curled tip', colors: ['#a97b5f', '#805840', '#c49976'], mount: 'Wide bottom layer rests directly on top; color separates each layer' },
-  { id: 'banana', name: 'Banana', category: 'Novelty', feature: 'Crescent fruit with stems and an inner color plane', colors: ['#f3cf62', '#dbaa40', '#89705a'], mount: 'Outer curve touches the top; both stems point up' },
-  { id: 'fried-egg', name: 'Fried egg', category: 'Novelty', feature: 'Irregular rounded white with a raised golden yolk', colors: ['#fff9e8', '#e6d9bb', '#f3be43'], mount: 'White spreads across the top; raised yolk defines the silhouette' },
-  { id: 'rubber-duck', name: 'Rubber duck', category: 'Novelty', feature: 'Round head, flat orange bill, and short raised tail', colors: ['#f6d05e', '#e4ae3e', '#e58b4b'], mount: 'Belly rests flat on top, with bill left and tail right' },
-  { id: 'paper-boat', name: 'Paper boat', category: 'Novelty', feature: 'Folded hull with a central triangular plane', colors: ['#d6e7eb', '#92b5c1', '#f1f7f5'], mount: 'Folded hull edge rests on top; main fold stays centered' },
-  { id: 'traffic-cone', name: 'Traffic cone', category: 'Novelty', feature: 'Orange cone with a white band and flat base', colors: ['#ed985f', '#c96c43', '#fff0dd'], mount: 'Flat base rests on top; cone tapers upward' },
-  { id: 'sprout', name: 'Sprout', category: 'Novelty', feature: 'Short stem with two leaves pointing in different directions', colors: ['#89b875', '#537f59', '#b5d38f'], mount: 'Stem grows directly from the top edge without a pot or base' },
-  { id: 'donut', name: 'Donut', category: 'Novelty', feature: 'Clear center hole, half-ring of icing, and a few sprinkles', colors: ['#dbab70', '#bf8456', '#e5a0b3'], mount: 'Lower curve touches the top; center remains an open cutout' },
-  { id: 'forehead-goggles', name: 'Forehead goggles', category: 'Accessories', feature: 'Two blue-gray lenses with a center bridge', colors: ['#8b7568', '#a2c5d1', '#dec8ae'], mount: 'Fits within the forehead band; bridge anchors above the screen' },
-  {"id":"task-board","name":"Task board","category":"Accessories","feature":"White planning board with connected role-color markers and a yellow accent","colors":["#ffffff","#3161f7","#f6b500"],"mount":"Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores"},
-  {"id":"wrench","name":"Wrench","category":"Accessories","feature":"White open-ended wrench with role-color outlines and a yellow handle inset","colors":["#ffffff","#3161f7","#f6b500"],"mount":"Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores"},
-  {"id":"shield","name":"Shield","category":"Accessories","feature":"White shield with a role-color outline and upright check","colors":["#ffffff","#3161f7","#f6b500"],"mount":"Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores"},
-  {"id":"magnifier","name":"Magnifier","category":"Accessories","feature":"Upright white lens frame with a role-color outline and a lower grip","colors":["#ffffff","#3161f7","#f6b500"],"mount":"Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores"},
-  {"id":"control-panel","name":"Control panel","category":"Accessories","feature":"White control panel with dark rails and role-color and yellow knobs","colors":["#ffffff","#3161f7","#f6b500"],"mount":"Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores"},
-]
-export const decorationOf = (id: DecorationId) => decorations.find(item => item.id === id)!
-export const decorationName = (id: PrimaryId | SecondaryId) => id === 'none' ? 'None' : decorationOf(id).name
-export function compatibleNames(item: Decoration) {
-  return item.category === 'Accessories'
-    ? primaryIds.filter(id => compatibility[id].includes(item.id as SecondaryId)).map(decorationName).join(', ')
-    : compatibility[item.id as PrimaryId].map(decorationName).join(', ')
+export type Decoration = Item & DecorationCopy
+
+export const slotLabels: Record<Slot, string> = { head: 'Head', face: 'Face', hand: 'Hand', back: 'Back', skin: 'Skin' }
+export const rarityMeta: Record<Rarity, { label: string; color: string }> = {
+  common: { label: 'Common', color: '#8a94a6' },
+  uncommon: { label: 'Uncommon', color: '#3f9d5b' },
+  rare: { label: 'Rare', color: '#3b7be8' },
+  epic: { label: 'Epic', color: '#8b5cf6' },
+  legendary: { label: 'Legendary', color: '#e0962c' },
+}
+export const seriesLabels: Record<Series, string> = {
+  everyday: 'Everyday', dev: 'Dev culture', tech: 'Tech & cyber', fantasy: 'Fantasy', nature: 'Nature', snack: 'Snack', critters: 'Critters',
 }
+
+const held = 'Screen-left hand; shares the arm pivot, stows for laptop and question sign, then restores'
+const copy: Record<ItemId, DecorationCopy> = {
+  'baseball-cap': { name: 'Baseball cap', feature: 'Rounded crown with a short right-facing brim', colors: ['#e87967', '#b94f50', '#f5a18c'], mount: 'Crown overlaps the top edge; the brim stays inside the body' },
+  'bucket-hat': { name: 'Bucket hat', feature: 'Flat top with a continuous downward brim', colors: ['#94bda6', '#5b887a', '#bed8c1'], mount: 'Brim follows the top edge with a slight center overlap' },
+  beret: { name: 'Beret', feature: 'Soft left-leaning crown with a short stem', colors: ['#b17498', '#784c71', '#cf9db5'], mount: 'Narrow band rests on top; the crown leans left' },
+  beanie: { name: 'Beanie', feature: 'Rounded crown and wide folded cuff with minimal texture', colors: ['#e9a653', '#bc753d', '#f7c676'], mount: 'Folded cuff sits on the top edge; crown stays centered' },
+  'top-hat': { name: 'Top hat', feature: 'Tall crown, narrow brim, and burgundy band', colors: ['#465069', '#293247', '#c96e85'], mount: 'Narrow brim rests flat on top; crown tapers at its base' },
+  'wizard-hat': { name: 'Wizard hat', feature: 'Curved point, wide brim, and gold star', colors: ['#8773c1', '#594b93', '#f4cc75'], mount: 'Wide brim rests on top; point curves into the center safe area' },
+  'chef-hat': { name: 'Chef hat', feature: 'Three-lobed puff with an upright band', colors: ['#f5eee3', '#d7caba', '#fffaf1'], mount: 'Band rests at the center of the top edge' },
+  'party-hat': { name: 'Party hat', feature: 'Cone with two colored bands and a pom-pom', colors: ['#ea9baf', '#8075b7', '#f5d07b'], mount: 'Shallow curved base follows the top of the body' },
+  crown: { name: 'Crown', feature: 'Three rounded points with a central sapphire', colors: ['#efc65c', '#c99139', '#73b8cc'], mount: 'Curved gold band wraps the top edge; all points face up' },
+  'hard-hat': { name: 'Hard hat', feature: 'Rounded shell, center ridge, and short front brim', colors: ['#f5bd48', '#d68d32', '#ffdc79'], mount: 'Short brim overlaps the top edge; ridge stays centered' },
+  nightcap: { name: 'Nightcap', feature: 'Soft drooping point with a pom-pom', colors: ['#789cc9', '#4c709f', '#dce8f4'], mount: 'Soft band follows the top edge; pom-pom stays upper right' },
+  'straw-hat': { name: 'Straw hat', feature: 'Low round crown, wide oval brim, and red band', colors: ['#e8c78a', '#c49b5e', '#c57568'], mount: 'Wide brim rests flat without entering the arm areas' },
+  poop: { name: 'Poop', feature: 'Three rounded layers with a playful curled tip', colors: ['#a97b5f', '#805840', '#c49976'], mount: 'Wide bottom layer rests directly on top; color separates each layer' },
+  banana: { name: 'Banana', feature: 'Crescent fruit with stems and an inner color plane', colors: ['#f3cf62', '#dbaa40', '#89705a'], mount: 'Outer curve touches the top; both stems point up' },
+  'fried-egg': { name: 'Fried egg', feature: 'Irregular rounded white with a raised golden yolk', colors: ['#fff9e8', '#e6d9bb', '#f3be43'], mount: 'White spreads across the top; raised yolk defines the silhouette' },
+  'rubber-duck': { name: 'Rubber duck', feature: 'Round head, flat orange bill, and short raised tail', colors: ['#f6d05e', '#e4ae3e', '#e58b4b'], mount: 'Belly rests flat on top, with bill left and tail right' },
+  'paper-boat': { name: 'Paper boat', feature: 'Folded hull with a central triangular plane', colors: ['#d6e7eb', '#92b5c1', '#f1f7f5'], mount: 'Folded hull edge rests on top; main fold stays centered' },
+  'traffic-cone': { name: 'Traffic cone', feature: 'Orange cone with a white band and flat base', colors: ['#ed985f', '#c96c43', '#fff0dd'], mount: 'Flat base rests on top; cone tapers upward' },
+  sprout: { name: 'Sprout', feature: 'Short stem with two leaves pointing in different directions', colors: ['#89b875', '#537f59', '#b5d38f'], mount: 'Stem grows directly from the top edge without a pot or base' },
+  donut: { name: 'Donut', feature: 'Clear center hole, half-ring of icing, and a few sprinkles', colors: ['#dbab70', '#bf8456', '#e5a0b3'], mount: 'Lower curve touches the top; center remains an open cutout' },
+  'ringed-planet': { name: 'Ringed planet', feature: 'Banded sand-colored planet inside a tilted pale ring with a soft glow', colors: ['#d9b07a', '#b8875a', '#f1e3c8'], mount: 'Ring underside touches the top edge; the planet floats above the center' },
+  'cat-ears': { name: 'Cat ears', feature: 'Two tan triangular ears with pink inner planes', colors: ['#c9a27e', '#f2a0b4'], mount: 'Ears rise from the top corners; nothing sits between them' },
+  'cowboy-hat': { name: 'Cowboy hat', feature: 'Tall creased crown over a wide curved brim with a dark band', colors: ['#b98352', '#a8734a', '#6e4a2e'], mount: 'Brim rests across the top edge and stays clear of the arms' },
+  mushroom: { name: 'Mushroom', feature: 'Red cap with cream spots on a short cream stem', colors: ['#e8654f', '#fff4ef', '#fff1dc'], mount: 'Stem stands on the top edge; the cap overhangs both sides' },
+  'shark-fin': { name: 'Shark fin', feature: 'Gray dorsal fin with a lighter leading plane', colors: ['#8b95a5', '#a7b1c0'], mount: 'Fin base spans the top edge center' },
+  'propeller-cap': { name: 'Propeller cap', feature: 'Yellow and red cap dome with a spinning propeller on a button', colors: ['#f6b500', '#e8654f', '#c9d2ff'], mount: 'Dome overlaps the top edge; the propeller spins flat at full size' },
+  'graduation-cap': { name: 'Graduation cap', feature: 'Black mortarboard with a gold button and a swinging tassel', colors: ['#2b2f3a', '#3c4658', '#f6b500'], mount: 'Skull cap rests on the top edge; the board floats above it' },
+  'ice-cream': { name: 'Ice cream', feature: 'Strawberry scoop with an upright cone and a cherry', colors: ['#f2a0b4', '#e0ad84', '#e8654f'], mount: 'Scoop rests on the top edge; the cone points up' },
+  'flower-crown': { name: 'Flower crown', feature: 'Green wreath with alternating pink and yellow blossoms', colors: ['#89b875', '#f2a0b4', '#f6b500'], mount: 'Wreath follows the top edge without a brim' },
+  'pirate-hat': { name: 'Pirate hat', feature: 'Black tricorn with an upturned brim and a white skull mark', colors: ['#2b2f3a', '#3c4658', '#ffffff'], mount: 'Brim rests on the top edge; points stay clear of the arms' },
+  lightning: { name: 'Lightning', feature: 'Yellow bolt standing upright with a breathing glow', colors: ['#ffcf11', '#fff3c4'], mount: 'Lower tip touches the top edge center' },
+  'crystal-cluster': { name: 'Crystal cluster', feature: 'Three violet crystals with a lighter facet and a breathing glow', colors: ['#8b5cf6', '#a78bfa', '#c4b5fd'], mount: 'Crystal bases sit on the top edge' },
+  ufo: { name: 'UFO', feature: 'Hovering saucer with a glass dome, blinking lights and a tractor beam', colors: ['#8b95a5', '#a2c5d1', '#c7f6ff'], mount: 'Saucer floats above the head; the beam lands on the top edge' },
+
+  shades: { name: 'Shades', feature: 'Two dark lenses with a short bridge pushed up on the brow', colors: ['#2b2f3a', '#6b7280'], mount: 'Fits within the forehead band above the screen' },
+  'forehead-goggles': { name: 'Forehead goggles', feature: 'Two blue-gray lenses with a center bridge', colors: ['#8b7568', '#a2c5d1', '#dec8ae'], mount: 'Fits within the forehead band; bridge anchors above the screen' },
+  'mecha-faceplate': { name: 'Mecha faceplate', feature: 'White face armor with a dark visor band, angular yellow-green eyes, a red chin plate and two vents', colors: ['#f4f6fb', '#1d2433', '#d94a3a'], mount: 'Replaces the face inside the white screen frame; the eyes change light, not shape' },
+  'pixel-screen': { name: 'Pixel screen', feature: 'Dark monitor with phosphor-green pixel eyes: blocks, a blocky smile, a loading bar and dim dashes', colors: ['#1f2a3a', '#7dff8a'], mount: 'Replaces the face inside the white screen frame; pixel glyphs carry all four expressions' },
+  'gold-faceplate': { name: 'Gold faceplate', feature: 'Armored gold plate whose fixed eye slits change light, not shape: cyan idle, warm flare, amber scan, dim ember', colors: ['#efc04a', '#bf8a2a', '#6fdcff'], mount: 'Replaces the face inside the white screen frame; light carries all four expressions' },
+  'neon-visor': { name: 'Neon visor', feature: 'Full smoked visor with a pair of LED eyes that lid, squint and rest, plus a passing scan line', colors: ['#1d2433', '#4de3ff', '#c7f6ff'], mount: 'Replaces the face inside the white screen frame; the LED pair carries all four expressions' },
+
+  'task-board': { name: 'Task board', feature: 'White planning board with connected role-color markers and a yellow accent', colors: ['#ffffff', '#3161f7', '#f6b500'], mount: held },
+  wrench: { name: 'Wrench', feature: 'White open-ended wrench with role-color outlines and a yellow handle inset', colors: ['#ffffff', '#3161f7', '#f6b500'], mount: held },
+  'coffee-mug': { name: 'Coffee mug', feature: 'White mug with a role-color band and rising steam', colors: ['#ffffff', '#3161f7', '#5a3c2a'], mount: held },
+  shield: { name: 'Shield', feature: 'White shield with a role-color outline and upright check', colors: ['#ffffff', '#3161f7', '#f6b500'], mount: held },
+  magnifier: { name: 'Magnifier', feature: 'Upright white lens frame with a role-color outline and a lower grip', colors: ['#ffffff', '#3161f7', '#f6b500'], mount: held },
+  'control-panel': { name: 'Control panel', feature: 'White control panel with dark rails and role-color and yellow knobs', colors: ['#ffffff', '#3161f7', '#f6b500'], mount: held },
+  'magic-wand': { name: 'Magic wand', feature: 'Dark wand tipped with a gold star and drifting sparkles', colors: ['#3b2f5c', '#f6b500', '#fff3c4'], mount: held },
+  'energy-blade': { name: 'Energy blade', feature: 'Compact hilt with a blade that cycles cyan, magenta and green while it extends and retracts', colors: ['#2a3140', '#4de3ff', '#e6fbff'], mount: `${held}; the blade rises beside the body, never across the screen` },
+  paintbrush: { name: 'Paintbrush', feature: 'Wooden brush with a steel ferrule and a role-color paint tip', colors: ['#e0ad84', '#8b95a5', '#3161f7'], mount: held },
+  'boba-tea': { name: 'Boba tea', feature: 'White cup of milk tea with dark pearls and a yellow straw', colors: ['#ffffff', '#e0ad84', '#3c4658'], mount: held },
+  gamepad: { name: 'Gamepad', feature: 'White controller with a role-color d-pad and two buttons', colors: ['#ffffff', '#3161f7', '#f6b500'], mount: held },
+  flag: { name: 'Flag', feature: 'Steel pole with a waving role-color pennant', colors: ['#8b95a5', '#3161f7'], mount: `${held}; the pennant rises beside the body` },
+  lantern: { name: 'Lantern', feature: 'Red paper lantern with dark caps and a warm breathing glow', colors: ['#e8654f', '#3c4658', '#ffd970'], mount: held },
+  staff: { name: 'Staff', feature: 'Wooden staff topped with a glowing orb that shifts violet, cyan and pink', colors: ['#8a6520', '#8b5cf6', '#c4b5fd'], mount: `${held}; the orb rises beside the body` },
+
+  cape: { name: 'Cape', feature: 'Crimson cape that flares wide below the body with a lighter lining', colors: ['#b23a48', '#d65a68'], mount: 'Collar sits at the shoulders behind the body; the flares show beside and below the base' },
+  'crescent-moon': { name: 'Crescent moon', feature: 'Yellow crescent rising behind the head with a small star', colors: ['#f6d365', '#fff3c4'], mount: 'Moon shows behind the upper-left of the head' },
+  jetpack: { name: 'Jetpack', feature: 'Two steel tanks with red caps and flickering flames', colors: ['#8b95a5', '#e8654f', '#ffb347'], mount: 'Tanks show beside both arms behind the body; flames flicker below' },
+  'star-trail': { name: 'Star trail', feature: 'Three gold four-point stars twinkling beside the body', colors: ['#f6b500', '#fff3c4'], mount: 'Stars float beside the body and twinkle at full size' },
+  balloons: { name: 'Balloons', feature: 'Three balloons on strings rising beside the head', colors: ['#e8654f', '#f6b500', '#4f7cf6'], mount: 'Strings meet behind the left shoulder; the bunch bobs at full size' },
+  'bat-wings': { name: 'Bat wings', feature: 'Two scalloped violet wings with darker membranes that flap', colors: ['#5b3a8c', '#3d2563'], mount: 'Wings spread from behind the shoulders and stay clear of the head' },
+  'butterfly-wings': { name: 'Butterfly wings', feature: 'Two pink two-lobed wings with cream inner planes that flap', colors: ['#f2a0b4', '#fff3c4'], mount: 'Wings spread from behind the shoulders' },
+  halo: { name: 'Halo', feature: 'Flat golden aureole centered on the antenna light with a breathing glow', colors: ['#f6b500', '#ffe08a', '#fff7dc'], mount: 'Ring sits behind the light and hats; the light disc covers its center' },
+  'angel-wings': { name: 'Angel wings', feature: 'Two white feathered wings with a soft glow and a slow flap', colors: ['#ffffff', '#eef1ff', '#c9d2ff'], mount: 'Wings spread from behind the shoulders' },
+  'sun-rays': { name: 'Sun rays', feature: 'Twelve alternating gold rays turning slowly behind the body', colors: ['#f6b500', '#ffcf11'], mount: 'Rays radiate from the body center' },
+  'orbit-ring': { name: 'Orbit ring', feature: 'Tilted orbit belt with three bodies that circle in front of and behind the robot', colors: ['#b9c4ff', '#f6b500', '#ff9ad9'], mount: 'Belt crosses low around the body; bodies pass in front below the screen' },
+  'dragon-wings': { name: 'Dragon wings', feature: 'Two large crimson wings with dark membranes and ember tips that flap', colors: ['#b23a48', '#7f2634', '#ffb347'], mount: 'Wings spread wide from behind the shoulders' },
+
+  stripes: { name: 'Stripes', feature: 'Diagonal light stripes across the body and arms', colors: ['#ffffff'], mount: 'One continuous overlay across the body and arms; reads through every palette' },
+  chrome: { name: 'Chrome', feature: 'Mirror steel with a horizon line and a sweeping sheen', colors: ['#f4f7fb', '#9aa6b8', '#3c4658'], mount: 'Replaces the body and arm paint; face marks keep the palette' },
+  gold: { name: 'Gold', feature: 'Polished gold with a sweeping sheen', colors: ['#f6d365', '#b8862c', '#fff3c4'], mount: 'Replaces the body and arm paint; face marks keep the palette' },
+  lava: { name: 'Lava', feature: 'Molten rock whose glow flows between ember red and bright orange', colors: ['#e8451f', '#ffb347', '#4a1208'], mount: 'Replaces the body and arm paint; face marks keep the palette' },
+  holographic: { name: 'Holographic', feature: 'Iridescent foil whose colors flow across the body', colors: ['#ff8ad4', '#8ad8ff', '#c9ff8a'], mount: 'Replaces the body and arm paint; face marks keep the palette' },
+  galaxy: { name: 'Galaxy', feature: 'Deep space nebula that drifts between violet and blue with twinkling stars', colors: ['#4c1d95', '#2563eb', '#ffffff'], mount: 'Replaces the body and arm paint; stars twinkle on the surface' },
+}
+
+export const decorations: Decoration[] = items.map(item => ({ ...item, ...copy[item.id] }))
+export const decorationOf = (id: ItemId): Decoration => ({ ...itemOf(id), ...copy[id] })
+export const decorationName = (id: ItemId | 'none') => id === 'none' ? 'None' : copy[id].name
+export function decorationsOf(slot: Slot): Decoration[] { return decorations.filter(item => item.slot === slot) }
+export function decorationsByRarity(rarity: Rarity): Decoration[] { return decorations.filter(item => item.rarity === rarity) }
+export function decorationsBySeries(series: Series): Decoration[] { return decorations.filter(item => item.series === series) }
+export const rarityOrder = (rarity: Rarity) => rarities.indexOf(rarity)
+export const slotOrder = (slot: Slot) => slots.indexOf(slot)
+export const seriesOrder = (series: Series) => seriesIds.indexOf(series)

package/src/decorationMotion.ts

@@ -1,4 +1,4 @@
-import type { PrimaryId } from './appearanceModel.js'
+import type { HeadId } from './items.js'
 import type { AvatarPose } from './characters.js'
 
 export type MotionKind = 'lift' | 'fitted' | 'bounce' | 'rock' | 'squish' | 'sprout'
@@ -6,10 +6,13 @@ export interface MotionProfile { kind: MotionKind; x: number; y: number; height:
 const lift = (x = 512, y = 400): MotionProfile => ({ kind: 'lift', x, y, height: .05, angle: 3, shadow: 95 })
 const fitted = (x = 512): MotionProfile => ({ kind: 'fitted', x, y: 400, height: 0, angle: 3, shadow: 0 })
 const bounce = (x = 512): MotionProfile => ({ kind: 'bounce', x, y: 400, height: .06, angle: 5, shadow: 64 })
-export const decorationMotionProfiles: Record<Exclude<PrimaryId, 'none'>, MotionProfile> = {
+export const decorationMotionProfiles: Record<HeadId, MotionProfile> = {
   'baseball-cap': lift(478), 'bucket-hat': lift(), beret: lift(494), beanie: fitted(),
   'top-hat': lift(), 'wizard-hat': lift(), 'chef-hat': lift(), 'party-hat': lift(), crown: lift(),
-  'hard-hat': fitted(), nightcap: fitted(493), 'straw-hat': lift(),
+  'hard-hat': fitted(), nightcap: fitted(493), 'straw-hat': lift(), 'ringed-planet': { ...lift(512, 335), shadow: 110 },
+  'cowboy-hat': lift(), 'graduation-cap': lift(), 'pirate-hat': lift(), lightning: { ...lift(), shadow: 40 }, ufo: { ...lift(512, 300), shadow: 120 },
+  'cat-ears': fitted(), 'shark-fin': fitted(), 'propeller-cap': fitted(), 'flower-crown': fitted(), 'crystal-cluster': fitted(),
+  mushroom: bounce(), 'ice-cream': bounce(),
   poop: bounce(), 'rubber-duck': bounce(520), donut: { ...bounce(), shadow: 40 },
   banana: { kind: 'rock', x: 487, y: 402, height: 0, angle: 5, shadow: 0 },
   'paper-boat': { kind: 'rock', x: 512, y: 399, height: 0, angle: 5, shadow: 0 },

package/src/effects.css

@@ -0,0 +1,86 @@
+.dca-robot[data-effects='off'] .dca-fx { display: none; }
+
+.dca-fx-sheen { transform: translateX(120px); }
+.dca-fx-orbit-a { transform: translate(450px, 0); }
+.dca-fx-orbit-b { transform: translate(-450px, 0); }
+.dca-fx-orbit-c { transform: translate(0, 104px); }
+.dca-fx-orbit-back { opacity: 0; }
+.dca-fx-sparkle > path { transform-box: fill-box; transform-origin: center; }
+
+@keyframes dca-fx-pulse { 0%, 100% { opacity: .5; } 50% { opacity: 1; } }
+@keyframes dca-fx-flare { 0%, 100% { opacity: .8; } 12% { opacity: 1; } 20% { opacity: .7; } 28% { opacity: 1; } 60% { opacity: .9; } }
+@keyframes dca-fx-breathe { 0%, 100% { opacity: .2; } 50% { opacity: .45; } }
+@keyframes dca-fx-scan-eyes { 0% { transform: translateX(0); } 100% { transform: translateX(300px); } }
+@keyframes dca-fx-flap { 0% { transform: rotate(-12deg); } 100% { transform: rotate(12deg); } }
+@keyframes dca-fx-sway { 0% { transform: rotate(-1.6deg); } 100% { transform: rotate(1.6deg); } }
+@keyframes dca-fx-blade-length { 0%, 100% { transform: scaleY(1); } 38% { transform: scaleY(.58); } 56% { transform: scaleY(1.08); } }
+@keyframes dca-fx-blade-color { 0%, 100% { fill: #4de3ff; } 33% { fill: #ff6bd6; } 66% { fill: #8dff9a; } }
+@keyframes dca-fx-orb-color { 0%, 100% { fill: #8b5cf6; } 33% { fill: #4de3ff; } 66% { fill: #ff6bd6; } }
+@keyframes dca-fx-spin-flat { 0% { transform: scaleX(1); } 50% { transform: scaleX(.08); } 100% { transform: scaleX(1); } }
+@keyframes dca-fx-swing { 0% { transform: rotate(-10deg); } 100% { transform: rotate(10deg); } }
+@keyframes dca-fx-hover { 0% { transform: translateY(0); } 100% { transform: translateY(-14px); } }
+@keyframes dca-fx-wave { 0% { transform: skewY(-6deg); } 100% { transform: skewY(6deg); } }
+@keyframes dca-fx-rotate { to { transform: rotate(360deg); } }
+@keyframes dca-fx-lava {
+  0%, 100% { stop-color: #4a1208; } 20% { stop-color: #e8451f; } 40% { stop-color: #ffb347; } 60% { stop-color: #ff6a2a; } 80% { stop-color: #7a1f0e; }
+}
+@keyframes dca-fx-galaxy {
+  0%, 100% { stop-color: #1b1040; } 20% { stop-color: #4c1d95; } 40% { stop-color: #2563eb; } 60% { stop-color: #0b3d62; } 80% { stop-color: #7c3aed; }
+}
+@keyframes dca-fx-scan { 0% { transform: translateX(-30px); } 100% { transform: translateX(290px); } }
+@keyframes dca-fx-steam { 0% { opacity: 0; transform: translateY(12px); } 35% { opacity: .8; } 100% { opacity: 0; transform: translateY(-28px); } }
+@keyframes dca-fx-sparkle { 0%, 100% { opacity: .15; transform: scale(.55); } 50% { opacity: 1; transform: scale(1.15); } }
+@keyframes dca-fx-flame { 0% { transform: scaleY(.82) scaleX(.94); opacity: .85; } 100% { transform: scaleY(1.12) scaleX(1.04); opacity: 1; } }
+@keyframes dca-fx-node { 0%, 100% { opacity: .3; } 50% { opacity: 1; } }
+@keyframes dca-fx-sheen { 0% { transform: translateX(-440px); } 55% { transform: translateX(740px); } 100% { transform: translateX(740px); } }
+@keyframes dca-fx-holo {
+  0% { stop-color: #ff8ad4; } 20% { stop-color: #ffd28a; } 40% { stop-color: #c9ff8a; }
+  60% { stop-color: #8ad8ff; } 80% { stop-color: #c98aff; } 100% { stop-color: #ff8ad4; }
+}
+@keyframes dca-fx-orbit {
+  0% { transform: translate(450px, 0); } 8.33% { transform: translate(390px, 52px); } 16.67% { transform: translate(225px, 90px); }
+  25% { transform: translate(0, 104px); } 33.33% { transform: translate(-225px, 90px); } 41.67% { transform: translate(-390px, 52px); }
+  50% { transform: translate(-450px, 0); } 58.33% { transform: translate(-390px, -52px); } 66.67% { transform: translate(-225px, -90px); }
+  75% { transform: translate(0, -104px); } 83.33% { transform: translate(225px, -90px); } 91.67% { transform: translate(390px, -52px); }
+  100% { transform: translate(450px, 0); }
+}
+/* The lower half of the orbit (0–50%) is in front of the body, the upper half behind it. */
+@keyframes dca-fx-orbit-show-front { 0%, 49.99% { opacity: 1; } 50%, 100% { opacity: 0; } }
+@keyframes dca-fx-orbit-show-back { 0%, 49.99% { opacity: 0; } 50%, 100% { opacity: 1; } }
+
+.dca-robot[data-effects='live'] .dca-fx-pulse { animation: dca-fx-pulse 2.8s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-flare { animation: dca-fx-flare 2.2s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-breathe { animation: dca-fx-breathe 3.2s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-scan-eyes { animation: dca-fx-scan-eyes 1.6s cubic-bezier(.45, 0, .55, 1) infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-flap { animation: dca-fx-flap 1.3s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-sway { animation: dca-fx-sway 3.4s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-blade { animation: dca-fx-blade-length 4.4s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-blade-color { animation: dca-fx-blade-color 6s linear infinite; }
+.dca-robot[data-effects='live'] .dca-fx-orb-color { animation: dca-fx-orb-color 5s linear infinite; }
+.dca-robot[data-effects='live'] .dca-fx-spin-flat { animation: dca-fx-spin-flat .5s linear infinite; }
+.dca-robot[data-effects='live'] .dca-fx-swing { animation: dca-fx-swing 1.4s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-hover { animation: dca-fx-hover 2.2s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-wave { animation: dca-fx-wave 1.1s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-rotate { animation: dca-fx-rotate 28s linear infinite; }
+.dca-robot[data-effects='live'] .dca-fx-flap-slow { animation: dca-fx-flap 2.6s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-skin-lava stop { animation: dca-fx-lava 7s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-skin-galaxy stop { animation: dca-fx-galaxy 9s ease-in-out infinite; }
+.dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy) stop:nth-child(2) { animation-delay: -1.4s; }
+.dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy) stop:nth-child(3) { animation-delay: -2.8s; }
+.dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy) stop:nth-child(4) { animation-delay: -4.2s; }
+.dca-robot[data-effects='live'] :is(.dca-skin-lava, .dca-skin-galaxy) stop:nth-child(5) { animation-delay: -5.6s; }
+.dca-robot[data-effects='live'] .dca-fx-scan { animation: dca-fx-scan 2.4s cubic-bezier(.45, 0, .55, 1) infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-steam { animation: dca-fx-steam 2.6s ease-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-sparkle > path { animation: dca-fx-sparkle 1.8s ease-in-out infinite; }
+.dca-fx-sparkle-solo { transform-box: fill-box; transform-origin: center; }
+.dca-robot[data-effects='live'] .dca-fx-sparkle-solo { animation: dca-fx-sparkle 2.4s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-flame { animation: dca-fx-flame .42s ease-in-out infinite alternate; }
+.dca-robot[data-effects='live'] .dca-fx-node { animation: dca-fx-node 1.8s ease-in-out infinite; }
+.dca-robot[data-effects='live'] .dca-fx-sheen { animation: dca-fx-sheen 4.8s cubic-bezier(.5, .05, .5, .95) infinite; }
+.dca-robot[data-effects='live'] .dca-fx-orbit-front { animation: dca-fx-orbit 8s linear infinite, dca-fx-orbit-show-front 8s linear infinite; }
+.dca-robot[data-effects='live'] .dca-fx-orbit-back { animation: dca-fx-orbit 8s linear infinite, dca-fx-orbit-show-back 8s linear infinite; }
+.dca-robot[data-effects='live'] .dca-skin-holo stop { animation: dca-fx-holo 6s linear infinite; }
+.dca-robot[data-effects='live'] .dca-skin-holo stop:nth-child(2) { animation-delay: -1.2s; }
+.dca-robot[data-effects='live'] .dca-skin-holo stop:nth-child(3) { animation-delay: -2.4s; }
+.dca-robot[data-effects='live'] .dca-skin-holo stop:nth-child(4) { animation-delay: -3.6s; }
+.dca-robot[data-effects='live'] .dca-skin-holo stop:nth-child(5) { animation-delay: -4.8s; }

package/src/index.ts

@@ -1,5 +1,7 @@
+export * from './items.js'
 export * from './appearanceModel.js'
 export * from './characters.js'
 export * from './palette.js'
+export * from './paintMaterials.js'
 export * from './decorationCatalog.js'
 export * from './decorationMotion.js'

package/src/items.ts

@@ -0,0 +1,86 @@
+export const slots = ['head', 'face', 'hand', 'back', 'skin'] as const
+export type Slot = typeof slots[number]
+export const rarities = ['common', 'uncommon', 'rare', 'epic', 'legendary'] as const
+export type Rarity = typeof rarities[number]
+export const seriesIds = ['everyday', 'dev', 'tech', 'fantasy', 'nature', 'snack', 'critters'] as const
+export type Series = typeof seriesIds[number]
+export const zones = ['top', 'brow', 'rim', 'screen', 'hand', 'back', 'body'] as const
+export type Zone = typeof zones[number]
+
+export interface ItemSpec<S extends Slot = Slot, I extends string = string> {
+  id: I
+  slot: S
+  rarity: Rarity
+  series: Series
+  zones: readonly Zone[]
+}
+
+const hat = <I extends string>(id: I, rarity: Rarity, series: Series = 'everyday') =>
+  ({ id, slot: 'head', rarity, series, zones: ['top', 'brow'] }) as const satisfies ItemSpec<'head', I>
+const object = <I extends string>(id: I, rarity: Rarity, series: Series) =>
+  ({ id, slot: 'head', rarity, series, zones: ['top'] }) as const satisfies ItemSpec<'head', I>
+const brow = <I extends string>(id: I, rarity: Rarity, series: Series) =>
+  ({ id, slot: 'face', rarity, series, zones: ['brow'] }) as const satisfies ItemSpec<'face', I>
+const faceplate = <I extends string>(id: I, rarity: Rarity, series: Series) =>
+  ({ id, slot: 'face', rarity, series, zones: ['screen'] }) as const satisfies ItemSpec<'face', I>
+const hand = <I extends string>(id: I, rarity: Rarity, series: Series) =>
+  ({ id, slot: 'hand', rarity, series, zones: ['hand'] }) as const satisfies ItemSpec<'hand', I>
+const back = <I extends string>(id: I, rarity: Rarity, series: Series) =>
+  ({ id, slot: 'back', rarity, series, zones: ['back'] }) as const satisfies ItemSpec<'back', I>
+const skin = <I extends string>(id: I, rarity: Rarity, series: Series) =>
+  ({ id, slot: 'skin', rarity, series, zones: ['body'] }) as const satisfies ItemSpec<'skin', I>
+
+// Registry order is presentation order only; sampling is weighted by rarity, then uniform.
+export const items = [
+  hat('baseball-cap', 'common'), hat('bucket-hat', 'common'), hat('beret', 'uncommon'), hat('beanie', 'common'),
+  hat('top-hat', 'rare'), hat('wizard-hat', 'rare', 'fantasy'), hat('chef-hat', 'uncommon', 'snack'), hat('party-hat', 'uncommon'),
+  hat('crown', 'epic', 'fantasy'), hat('hard-hat', 'common'), hat('nightcap', 'uncommon'), hat('straw-hat', 'common'),
+  object('poop', 'uncommon', 'everyday'), object('banana', 'common', 'snack'), object('fried-egg', 'common', 'snack'),
+  object('rubber-duck', 'uncommon', 'critters'), object('paper-boat', 'common', 'everyday'), object('traffic-cone', 'common', 'everyday'),
+  object('sprout', 'common', 'nature'), object('donut', 'uncommon', 'snack'), object('ringed-planet', 'legendary', 'tech'),
+  object('cat-ears', 'common', 'critters'), hat('cowboy-hat', 'common'), object('mushroom', 'common', 'nature'),
+  object('shark-fin', 'uncommon', 'critters'), hat('propeller-cap', 'uncommon'), hat('graduation-cap', 'uncommon', 'dev'),
+  object('ice-cream', 'uncommon', 'snack'), object('flower-crown', 'rare', 'nature'), hat('pirate-hat', 'rare', 'fantasy'),
+  object('lightning', 'epic', 'tech'), object('crystal-cluster', 'epic', 'fantasy'), object('ufo', 'legendary', 'tech'),
+
+  brow('shades', 'common', 'everyday'), brow('forehead-goggles', 'uncommon', 'tech'),
+  faceplate('mecha-faceplate', 'rare', 'tech'), faceplate('pixel-screen', 'rare', 'dev'),
+  faceplate('gold-faceplate', 'epic', 'tech'), faceplate('neon-visor', 'legendary', 'tech'),
+
+  hand('task-board', 'common', 'dev'), hand('wrench', 'common', 'dev'), hand('coffee-mug', 'common', 'dev'),
+  hand('paintbrush', 'common', 'everyday'), hand('boba-tea', 'common', 'snack'),
+  hand('shield', 'uncommon', 'dev'), hand('magnifier', 'uncommon', 'dev'), hand('gamepad', 'uncommon', 'dev'), hand('flag', 'uncommon', 'everyday'),
+  hand('control-panel', 'rare', 'tech'), hand('lantern', 'rare', 'fantasy'),
+  hand('magic-wand', 'epic', 'fantasy'), hand('staff', 'epic', 'fantasy'), hand('energy-blade', 'legendary', 'tech'),
+
+  back('cape', 'common', 'fantasy'), back('crescent-moon', 'common', 'nature'),
+  back('jetpack', 'uncommon', 'tech'), back('star-trail', 'uncommon', 'fantasy'), back('balloons', 'uncommon', 'everyday'),
+  back('bat-wings', 'rare', 'critters'), back('butterfly-wings', 'rare', 'critters'),
+  back('halo', 'epic', 'fantasy'), back('angel-wings', 'epic', 'fantasy'), back('sun-rays', 'epic', 'nature'),
+  back('orbit-ring', 'legendary', 'tech'), back('dragon-wings', 'legendary', 'fantasy'),
+
+  skin('stripes', 'common', 'everyday'),
+  skin('chrome', 'epic', 'tech'), skin('gold', 'epic', 'fantasy'), skin('lava', 'epic', 'nature'),
+  skin('holographic', 'legendary', 'tech'), skin('galaxy', 'legendary', 'fantasy'),
+] as const
+
+export type Item = typeof items[number]
+export type ItemId = Item['id']
+export type ItemOf<S extends Slot> = Extract<Item, { slot: S }>['id']
+export type HeadId = ItemOf<'head'>
+export type FaceId = ItemOf<'face'>
+export type HandId = ItemOf<'hand'>
+export type BackId = ItemOf<'back'>
+export type SkinId = ItemOf<'skin'>
+
+const byId = new Map<string, Item>(items.map(item => [item.id, item]))
+export function itemOf(id: ItemId): Item { return byId.get(id)! }
+export function isItemId(id: string): id is ItemId { return byId.has(id) }
+export function itemsOf<S extends Slot>(slot: S): Extract<Item, { slot: S }>[] {
+  return items.filter((item): item is Extract<Item, { slot: S }> => item.slot === slot)
+}
+export function slotIds<S extends Slot>(slot: S): ItemOf<S>[] { return itemsOf(slot).map(item => item.id) as ItemOf<S>[] }
+export function conflicts(a: ItemId, b: ItemId): boolean {
+  const right: readonly Zone[] = itemOf(b).zones
+  return itemOf(a).zones.some(zone => right.includes(zone))
+}

package/src/paintMaterials.ts

@@ -0,0 +1,18 @@
+import type { SkinId } from './items.js'
+
+export interface PaintMaterial {
+  shadow: string
+  accent: string
+}
+
+export const paintMaterials = {
+  chrome: { shadow: '#1f2733', accent: '#c3ccd8' },
+  holographic: { shadow: '#5b3a8c', accent: '#c98aff' },
+  gold: { shadow: '#5a3a10', accent: '#f6d365' },
+  lava: { shadow: '#3a0a05', accent: '#ff6a2a' },
+  galaxy: { shadow: '#0b0620', accent: '#7c3aed' },
+} as const satisfies Partial<Record<SkinId, PaintMaterial>>
+
+export type PaintSkinId = keyof typeof paintMaterials
+export function isPaintSkin(id: SkinId | 'none'): id is PaintSkinId { return id in paintMaterials }
+export function paintMaterialOf(id: SkinId | 'none'): PaintMaterial | undefined { return isPaintSkin(id) ? paintMaterials[id] : undefined }

package/src/palette.ts

@@ -1,3 +1,6 @@
+import type { SkinId } from './items.js'
+import { paintMaterialOf } from './paintMaterials.js'
+
 export interface PaletteEntry {
   key: string
   bodyD: string
@@ -46,7 +49,8 @@ export const PALETTE: PaletteEntry[] = [
 
 
 export function paletteOf(spec: { palette: number }): PaletteEntry { return PALETTE[spec.palette] ?? DEFAULT_MASCOT_PALETTE }
-export function mascotPaletteOf(spec?: { palette: number }): MascotPaintPalette {
- if (!spec || spec.palette === -1) return DEFAULT_MASCOT_PALETTE
- const paint = paletteOf(spec); return { ...paint, markM: paint.markL }
+export function mascotPaletteOf(spec?: { palette: number; skin?: SkinId | 'none' }): MascotPaintPalette {
+  const material = paintMaterialOf(spec?.skin ?? 'none')
+  const paint: MascotPaintPalette = !spec || spec.palette === -1 ? DEFAULT_MASCOT_PALETTE : { ...paletteOf(spec), markM: paletteOf(spec).markL }
+  return material ? { ...paint, ...material } : paint
 }