@hadoku/prefs-client 1.1.13 → 1.1.15

package/dist/avatar.d.ts

@@ -1,5 +1,5 @@
-import { A as AvatarCosmetics, C as CosmeticsView, L as LoadoutUpdate } from './cosmetics-contract-Cqim3RuG.js';
-export { a as CosmeticSlot, b as Loadout, P as Placement } from './cosmetics-contract-Cqim3RuG.js';
+import { A as AvatarCosmetics, C as CosmeticsView, L as LoadoutUpdate } from './cosmetics-contract-CzRH-ZG0.js';
+export { a as CosmeticSlot, b as Loadout, P as Placement } from './cosmetics-contract-CzRH-ZG0.js';
 
 /**
  * Avatars — the wire contract, shared by prefs-api and the client.

package/dist/{cosmetics-contract-Cqim3RuG.d.ts → cosmetics-contract-CzRH-ZG0.d.ts}

@@ -7,7 +7,11 @@
  *
  * Rules the catalogue keeps (operator, 2026-11-01; design:
  * docs/planning/avatar-cosmetics-2026-11-02.md):
- * - Earned by achievement or gifted by the operator, never bought; no levels.
+ * - Almost everything is free to everyone. Three items are earned, and kept for
+ *   good once earned: Twinkle (bronze or better in a Major), Decode (silver or
+ *   better) and the Crown (winning one). Never bought; no levels.
+ * - At most six items show per slot. The rest are archived (`hidden`): kept
+ *   in the catalogue, shown to nobody but admins, and selectable by nobody.
  * - One item per slot.
  * - Name effects, gradients and message reveals derive every colour from the
  *   person's character colour. Overlays may bring their own (the crown is gold).
@@ -35,8 +39,13 @@ interface CosmeticItem {
     id: string;
     slot: CosmeticSlot;
     label: string;
-    /** How it is earned, as the inventory shows it to someone who has not. */
-    earn: string;
+    /**
+     * How it is earned, as the inventory shows it to someone who has not.
+     * Absent: free, owned by everyone.
+     */
+    earn?: string;
+    /** Archived: shown to nobody but admins, and selectable by nobody. */
+    hidden?: true;
     art?: OverlayArt;
 }
 /**
@@ -47,6 +56,13 @@ interface CosmeticItem {
  */
 declare const COSMETICS: readonly CosmeticItem[];
 declare const COSMETICS_BY_ID: ReadonlyMap<string, CosmeticItem>;
+/** Earned items: the only ones a grant can give. */
+declare const EARNED_COSMETICS: readonly CosmeticItem[];
+/**
+ * What a person can wear: every visible free item, and the earned items they
+ * were granted. A grant of an archived item gives nothing.
+ */
+declare function ownedFrom(granted: Iterable<string>): Set<string>;
 /**
  * A person's adjustment of an overlay image, relative to its default spot:
  * x/y in % of the avatar's size, r in degrees, s in % of the default size.
@@ -116,9 +132,17 @@ interface AvatarCosmetics {
     message?: string;
     placement?: Placement;
 }
+/**
+ * What someone wears, as an app relays it over its own wire (a room's presence),
+ * made safe to render: known, shown items in their own slots only, and the
+ * placement refitted to the allowed area. Ownership was decided by prefs-api,
+ * which only ever serves what a person owns; this guards the shape, not the
+ * inventory. Undefined when nothing valid is worn.
+ */
+declare function cleanWorn(raw: unknown): AvatarCosmetics | undefined;
 /** In AvatarSettings: what the owner has earned and what they wear. */
 interface CosmeticsView {
-    /** Item ids, in catalogue order. */
+    /** What the person can wear: free items and the earned ones granted, in catalogue order. */
     owned: string[];
     loadout: Loadout;
 }
@@ -155,4 +179,4 @@ interface CosmeticGrantList {
     }[];
 }
 
-export { type AvatarCosmetics as A, type Box as B, type CosmeticsView as C, type LoadoutUpdate as L, type OverlayArt as O, type Placement as P, type CosmeticSlot as a, type Loadout as b, COSMETICS as c, COSMETICS_BY_ID as d, COSMETIC_ID_PATTERN as e, COSMETIC_SLOTS as f, type CosmeticGrantList as g, type CosmeticGrantRequest as h, type CosmeticItem as i, PLACEMENT_DEFAULT as j, PLACEMENT_LIMITS as k, PLACEMENT_ZONE as l, cleanLoadout as m, emptyLoadout as n, fitPlacement as o, overlayBounds as p, wornCosmetics as w };
+export { type AvatarCosmetics as A, type Box as B, type CosmeticsView as C, EARNED_COSMETICS as E, type LoadoutUpdate as L, type OverlayArt as O, type Placement as P, type CosmeticSlot as a, type Loadout as b, COSMETICS as c, COSMETICS_BY_ID as d, COSMETIC_ID_PATTERN as e, COSMETIC_SLOTS as f, type CosmeticGrantList as g, type CosmeticGrantRequest as h, type CosmeticItem as i, PLACEMENT_DEFAULT as j, PLACEMENT_LIMITS as k, PLACEMENT_ZONE as l, cleanLoadout as m, cleanWorn as n, emptyLoadout as o, fitPlacement as p, overlayBounds as q, ownedFrom as r, wornCosmetics as w };

package/dist/cosmetics.d.ts

@@ -1,5 +1,5 @@
-import { A as AvatarCosmetics, P as Placement } from './cosmetics-contract-Cqim3RuG.js';
-export { B as Box, c as COSMETICS, d as COSMETICS_BY_ID, e as COSMETIC_ID_PATTERN, f as COSMETIC_SLOTS, g as CosmeticGrantList, h as CosmeticGrantRequest, i as CosmeticItem, a as CosmeticSlot, C as CosmeticsView, b as Loadout, L as LoadoutUpdate, O as OverlayArt, j as PLACEMENT_DEFAULT, k as PLACEMENT_LIMITS, l as PLACEMENT_ZONE, m as cleanLoadout, n as emptyLoadout, o as fitPlacement, p as overlayBounds, w as wornCosmetics } from './cosmetics-contract-Cqim3RuG.js';
+import { A as AvatarCosmetics, P as Placement } from './cosmetics-contract-CzRH-ZG0.js';
+export { B as Box, c as COSMETICS, d as COSMETICS_BY_ID, e as COSMETIC_ID_PATTERN, f as COSMETIC_SLOTS, g as CosmeticGrantList, h as CosmeticGrantRequest, i as CosmeticItem, a as CosmeticSlot, C as CosmeticsView, E as EARNED_COSMETICS, b as Loadout, L as LoadoutUpdate, O as OverlayArt, j as PLACEMENT_DEFAULT, k as PLACEMENT_LIMITS, l as PLACEMENT_ZONE, m as cleanLoadout, n as cleanWorn, o as emptyLoadout, p as fitPlacement, q as overlayBounds, r as ownedFrom, w as wornCosmetics } from './cosmetics-contract-CzRH-ZG0.js';
 
 /**
  * Avatar cosmetics — the renderer every app uses, so a name, an avatar and a

package/dist/cosmetics.js

@@ -1,79 +1,101 @@
 // src/cosmetics-contract.ts
 var COSMETIC_SLOTS = ["effect", "gradient", "font", "overlay", "message"];
 var COSMETIC_ID_PATTERN = /^(effect|gradient|font|overlay|message)\.[a-z0-9-]{1,32}$/;
-var item = (slot, name, label, earn, art) => ({ id: `${slot}.${name}`, slot, label, earn, ...art ? { art } : {} });
+var item = (slot, name, label, opts = {}) => ({ id: `${slot}.${name}`, slot, label, ...opts });
+var archived = { hidden: true };
 var COSMETICS = [
-  item("effect", "glint", "Glint", "Win a cardtable match"),
-  item("effect", "aura", "Aura", "Attend 10 watchparties"),
-  item("effect", "hop", "Hop", "Win 25 bomberman rounds"),
-  item("effect", "outline", "Outline", "Finish 3 tournaments"),
-  item("effect", "twinkle", "Twinkle", "Top four in a Major"),
-  item("gradient", "gild", "Gilded", "Your first win in any game"),
-  item("gradient", "gloss", "Gloss", "Win 10 games"),
-  item("gradient", "split", "Split", "Finish 5 tournaments"),
-  item("gradient", "brushed", "Brushed", "Play 100 games"),
-  item("gradient", "lumen", "Lumen", "Host 5 watchparties"),
-  item("font", "caps", "Small caps", "Finish a tournament"),
-  item("font", "wide", "Wide", "Finish 5 tournaments"),
-  item("font", "script", "Script", "Attend 25 watchparties"),
-  item("font", "surf", "Surf", "Attend a summer watchparty"),
-  item("font", "gothic", "Gothic", "Win an arcane-set game"),
-  item("font", "runic", "Runic", "Win a fantasy-set game"),
-  item("font", "corsair", "Corsair", "Win 3 matches in one night"),
-  item("font", "metal", "Metal", "Win a Major final"),
-  item("font", "comic", "Comic", "Win from behind"),
-  item("font", "circuit", "Circuit", "Play 25 cyber-set games"),
-  item("font", "hover", "Hover", "Win a race"),
-  item("font", "retro", "Retro", "Play for a year"),
-  item("font", "arcade", "Arcade", "Play 50 bomberman games"),
-  item("font", "pixel", "Pixel", "Win 10 bomberman rounds"),
-  item("overlay", "crown", "Crown", "Win a Major", {
-    file: "crown.webp",
-    top: -40,
-    width: 70,
-    tilt: -8,
-    pixel: false,
-    visible: [0.027, 0.137, 0.973, 0.863]
+  item("effect", "glint", "Glint"),
+  item("effect", "aura", "Aura"),
+  item("effect", "hop", "Hop"),
+  item("effect", "outline", "Outline"),
+  item("effect", "twinkle", "Twinkle", { earn: "Bronze or better in a Major" }),
+  item("gradient", "gild", "Gilded"),
+  item("gradient", "gloss", "Gloss"),
+  item("gradient", "split", "Split"),
+  item("gradient", "brushed", "Brushed"),
+  item("gradient", "lumen", "Lumen"),
+  item("font", "script", "Script"),
+  item("font", "surf", "Surf"),
+  item("font", "gothic", "Gothic"),
+  item("font", "runic", "Runic"),
+  item("font", "arcade", "Arcade"),
+  item("font", "caps", "Small caps", archived),
+  item("font", "wide", "Wide", archived),
+  item("font", "corsair", "Corsair", archived),
+  item("font", "metal", "Metal", archived),
+  item("font", "comic", "Comic", archived),
+  item("font", "circuit", "Circuit", archived),
+  item("font", "hover", "Hover", archived),
+  item("font", "retro", "Retro", archived),
+  item("font", "pixel", "Pixel", archived),
+  item("overlay", "crown", "Crown", {
+    earn: "Win a Major",
+    art: {
+      file: "crown.webp",
+      top: -40,
+      width: 70,
+      tilt: -8,
+      pixel: false,
+      visible: [0.027, 0.137, 0.973, 0.863]
+    }
   }),
-  item("overlay", "halo", "Halo", "Help a new player (gift)", {
-    file: "halo.webp",
-    top: -34,
-    width: 76,
-    tilt: 0,
-    pixel: true,
-    visible: [0.033, 0.333, 0.967, 0.667]
+  item("overlay", "halo", "Halo", {
+    art: {
+      file: "halo.webp",
+      top: -34,
+      width: 76,
+      tilt: 0,
+      pixel: true,
+      visible: [0.033, 0.333, 0.967, 0.667]
+    }
   }),
-  item("overlay", "horns", "Horns", "Win 10 games as the villain", {
-    file: "horns.webp",
-    top: -26,
-    width: 100,
-    tilt: 0,
-    pixel: true,
-    visible: [0.033, 0.133, 0.967, 0.867]
+  item("overlay", "flowers", "Flower crown", {
+    art: {
+      file: "flowers.webp",
+      top: -22,
+      width: 96,
+      tilt: 0,
+      pixel: false,
+      visible: [0.027, 0.258, 0.969, 0.746]
+    }
   }),
-  item("overlay", "flowers", "Flower crown", "The anniversary of joining", {
-    file: "flowers.webp",
-    top: -22,
-    width: 96,
-    tilt: 0,
-    pixel: false,
-    visible: [0.027, 0.258, 0.969, 0.746]
+  item("overlay", "petals", "Petals"),
+  item("overlay", "horns", "Horns", {
+    ...archived,
+    art: {
+      file: "horns.webp",
+      top: -26,
+      width: 100,
+      tilt: 0,
+      pixel: true,
+      visible: [0.033, 0.133, 0.967, 0.867]
+    }
   }),
-  item("overlay", "runes", "Runes", "Finish a Major"),
-  item("overlay", "comet", "Comet", "A 10-game win streak"),
-  item("overlay", "shine", "Shine", "Win a cardtable match"),
-  item("overlay", "glow", "Glow", "Attend 25 watchparties"),
-  item("overlay", "petals", "Petals", "The anniversary of joining"),
-  item("message", "type", "Typewriter", "Send 1000 chat messages"),
-  item("message", "decode", "Decode", "Win 25 cyber-set games"),
-  item("message", "cascade", "Cascade", "Win 3 games in a row"),
-  item("message", "words", "Word by word", "Send 100 chat messages"),
-  item("message", "bubble", "Bubble", "Host 3 watchparties"),
-  item("message", "drift", "Drift", "Attend 20 watchparties")
+  item("overlay", "runes", "Runes", archived),
+  item("overlay", "comet", "Comet", archived),
+  item("overlay", "shine", "Shine", archived),
+  item("overlay", "glow", "Glow", archived),
+  item("message", "type", "Typewriter"),
+  item("message", "decode", "Decode", { earn: "Silver or better in a Major" }),
+  item("message", "cascade", "Cascade"),
+  item("message", "words", "Word by word"),
+  item("message", "bubble", "Bubble", archived),
+  item("message", "drift", "Drift")
 ];
 var COSMETICS_BY_ID = new Map(
   COSMETICS.map((i) => [i.id, i])
 );
+var EARNED_COSMETICS = COSMETICS.filter(
+  (i) => i.earn !== void 0 && !i.hidden
+);
+function ownedFrom(granted) {
+  const out = new Set(COSMETICS.filter((i) => !i.hidden && i.earn === void 0).map((i) => i.id));
+  for (const id of granted) {
+    const it = COSMETICS_BY_ID.get(id);
+    if (it && !it.hidden) out.add(id);
+  }
+  return out;
+}
 var PLACEMENT_DEFAULT = { x: 0, y: 0, r: 0, s: 100, flip: false, back: false };
 var PLACEMENT_LIMITS = {
   x: [-60, 60],
@@ -157,18 +179,35 @@ function emptyLoadout() {
     placement: {}
   };
 }
+function cleanWorn(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const src = raw;
+  const worn = {};
+  for (const slot of COSMETIC_SLOTS) {
+    const id = src[slot];
+    const it = typeof id === "string" ? COSMETICS_BY_ID.get(id) : void 0;
+    if (it && !it.hidden && it.slot === slot) worn[slot] = it.id;
+  }
+  const art = worn.overlay ? COSMETICS_BY_ID.get(worn.overlay)?.art : void 0;
+  if (art && src.placement && typeof src.placement === "object") {
+    worn.placement = fitPlacement(art, src.placement);
+  }
+  return Object.keys(worn).length ? worn : void 0;
+}
 function cleanLoadout(raw, owned) {
   const out = emptyLoadout();
   const src = raw && typeof raw === "object" ? raw : {};
   for (const slot of COSMETIC_SLOTS) {
     const id = src.equipped?.[slot];
-    if (typeof id === "string" && owned.has(id) && COSMETICS_BY_ID.get(id)?.slot === slot) {
-      out.equipped[slot] = id;
+    const it = typeof id === "string" ? COSMETICS_BY_ID.get(id) : void 0;
+    if (it && !it.hidden && owned.has(it.id) && it.slot === slot) {
+      out.equipped[slot] = it.id;
     }
   }
   for (const [id, p] of Object.entries(src.placement ?? {})) {
-    const art = COSMETICS_BY_ID.get(id)?.art;
-    if (art && owned.has(id) && p && typeof p === "object") {
+    const it = COSMETICS_BY_ID.get(id);
+    const art = it?.art;
+    if (art && !it.hidden && owned.has(id) && p && typeof p === "object") {
       out.placement[id] = fitPlacement(art, p);
     }
   }
@@ -480,11 +519,13 @@ export {
   COSMETICS_BY_ID,
   COSMETIC_ID_PATTERN,
   COSMETIC_SLOTS,
+  EARNED_COSMETICS,
   PLACEMENT_DEFAULT,
   PLACEMENT_LIMITS,
   PLACEMENT_ZONE,
   avatarHtml,
   cleanLoadout,
+  cleanWorn,
   colourStyle,
   cosmeticsCss,
   decorHtml,
@@ -494,6 +535,7 @@ export {
   messageHtml,
   nameHtml,
   overlayBounds,
+  ownedFrom,
   placementTransform,
   wornCosmetics
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hadoku/prefs-client",
-  "version": "1.1.13",
-  "gitHead": "3db36ddc4955a054c1a0a6e86af00a4973bf4de9",
+  "version": "1.1.15",
+  "gitHead": "bdf1c74cc458107cf5cb7a427fbfc319cb5f5b95",
   "description": "Client SDK for the hadoku unified preferences store. Wraps /prefs/api/v1/* with localStorage caching, debounced writes, Zod-validated reads, and a usePrefs() React hook, plus match history, ratings and leaderboards for every game (./games), the one resolved avatar per user (./avatar), and the avatar cosmetics renderer (./cosmetics).",
   "type": "module",
   "main": "./dist/index.js",