@hadoku/prefs-client 1.1.14 → 1.1.16

package/dist/avatar.d.ts

@@ -1,5 +1,5 @@
-import { A as AvatarCosmetics, C as CosmeticsView, L as LoadoutUpdate } from './cosmetics-contract-CfWEWT9I.js';
-export { a as CosmeticSlot, b as Loadout, P as Placement } from './cosmetics-contract-CfWEWT9I.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-CfWEWT9I.d.ts → cosmetics-contract-CzRH-ZG0.d.ts}

@@ -132,6 +132,14 @@ 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 {
     /** What the person can wear: free items and the earned ones granted, in catalogue order. */
@@ -171,4 +179,4 @@ interface CosmeticGrantList {
     }[];
 }
 
-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, emptyLoadout as n, fitPlacement as o, overlayBounds as p, ownedFrom as q, 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-CfWEWT9I.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 emptyLoadout, o as fitPlacement, p as overlayBounds, q as ownedFrom, w as wornCosmetics } from './cosmetics-contract-CfWEWT9I.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
@@ -55,9 +55,16 @@ declare function avatarHtml(o: {
 declare function messageHtml(text: string, worn?: AvatarCosmetics, opts?: {
     keep?: boolean;
 }): string;
+/**
+ * When a reveal's last piece finishes, put the plain text back. An
+ * `animationend` handler: ensureCosmeticsStyles installs it on the document;
+ * a page that ships the stylesheet statically (and must not touch the
+ * document) attaches it to its own container instead.
+ */
+declare function finishReveal(e: AnimationEvent): void;
 /** The whole stylesheet, with asset URLs under `assetBase`. */
 declare function cosmeticsCss(assetBase?: string): string;
 /** Add the stylesheet and the reveal clean-up to a document, once. */
 declare function ensureCosmeticsStyles(doc?: Document, assetBase?: string): void;
 
-export { AvatarCosmetics, COSMETICS_ASSET_BASE, Placement, avatarHtml, colourStyle, cosmeticsCss, decorHtml, ensureCosmeticsStyles, messageHtml, nameHtml, placementTransform };
+export { AvatarCosmetics, COSMETICS_ASSET_BASE, Placement, avatarHtml, colourStyle, cosmeticsCss, decorHtml, ensureCosmeticsStyles, finishReveal, messageHtml, nameHtml, placementTransform };

package/dist/cosmetics.js

@@ -179,6 +179,21 @@ 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 : {};
@@ -510,11 +525,13 @@ export {
   PLACEMENT_ZONE,
   avatarHtml,
   cleanLoadout,
+  cleanWorn,
   colourStyle,
   cosmeticsCss,
   decorHtml,
   emptyLoadout,
   ensureCosmeticsStyles,
+  finishReveal,
   fitPlacement,
   messageHtml,
   nameHtml,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hadoku/prefs-client",
-  "version": "1.1.14",
-  "gitHead": "f2f471f8417ec144486c7cf530f87a632e0653b6",
+  "version": "1.1.16",
+  "gitHead": "1870f7b16a89299f75df81e0fc3b0dda3af35798",
   "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",