@dreadwood-types/types 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# @dreadwood-types/types
+
+Public wire protocol and client-safe constants for Dreadwoods.
+
+## Publish (once)
+
+Org on npm: `@dreadwood-types`. Package must exist before Render can use `npm ci` without cloning this repo.
+
+```bash
+npm login
+npm publish
+```
+
+Verify: `npm view @dreadwood-types/types version` should print `0.1.0`.
+
+## Install (published)
+
+After publish, consumers on Render or CI install from the registry:
+
+```bash
+npm install @dreadwood-types/types@^0.1.0
+```
+
+## Local monorepo
+
+Backend, frontend, and website depend on the sibling repo via `file:../dreadwoods-types`.
+From the workspace root:
+
+```powershell
+# After npm install in at least one consumer (or if npm is broken on your machine):
+.\scripts\setup-local-types.ps1
+```
+
+Or manually:
+
+```bash
+cd dreadwoods-types
+npm install   # or use tsc from a sibling node_modules
+npm run build
+cd ../dreadwoods-backend && npm install
+```
+
+Publishes `dist/` with TypeScript declarations. Contains message types, tile enums, and display constants only — no server simulation logic.

package/dist/appearance.d.ts

@@ -0,0 +1,80 @@
+export type CharacterSex = 'male' | 'female';
+export type HairStyleId = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
+export declare const HAIR_STYLE_IDS: HairStyleId[];
+export type HeadPresetId = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export declare const HEAD_PRESET_IDS: HeadPresetId[];
+export type BodyTypeId = 'slim' | 'average' | 'athletic' | 'stocky';
+export declare const BODY_TYPE_IDS: BodyTypeId[];
+export type EyebrowStyleId = 0 | 1;
+export declare const EYEBROW_STYLE_IDS: EyebrowStyleId[];
+export type FacialHairId = 0 | 1;
+export declare const FACIAL_HAIR_IDS: FacialHairId[];
+/**
+ * Modular outfit worn over the base body. Sex-neutral: the part list for each
+ * sex is resolved from the outfit manifest at render time
+ * (public/assets/models/outfits/manifest.json, built by scripts/build-outfits.mjs).
+ *
+ * `null` means no outfit — the character renders with the legacy painted-on
+ * top/trousers/boots zones instead.
+ */
+export type OutfitId = 'peasant' | 'ranger';
+export declare const OUTFIT_IDS: OutfitId[];
+export declare const OUTFIT_LABELS: Record<OutfitId, string>;
+export type CharacterAppearance = {
+    sex: CharacterSex;
+    /**
+     * Optional so that omitting it means "no outfit" — the character keeps the
+     * legacy painted-on look. That is the safe default for the many NPC
+     * appearance literals that predate the outfit system.
+     */
+    outfit?: OutfitId | null;
+    hairStyle: HairStyleId;
+    headPreset: HeadPresetId;
+    bodyType: BodyTypeId;
+    eyebrowStyle: EyebrowStyleId;
+    facialHair: FacialHairId;
+    hairColor: string;
+    beardColor: string;
+    browColor: string;
+    topColor: string;
+    trousersColor: string;
+    skinTone: string;
+    bootColor: string;
+    handsColor: string;
+    eyeColor: string;
+};
+export declare const HAIR_STYLE_LABELS: Record<HairStyleId, string>;
+export declare const BODY_TYPE_LABELS: Record<BodyTypeId, string>;
+export declare const EYEBROW_STYLE_LABELS: Record<EyebrowStyleId, string>;
+export declare const FACIAL_HAIR_LABELS: Record<FacialHairId, string>;
+export declare const HEAD_PRESET_LABELS: Record<HeadPresetId, string>;
+export declare const COLOR_PRESETS: readonly ['#f6d7c3', '#e8b98a', '#c98a5c', '#8d5524', '#3b2214', '#1a1a1a', '#2b2b2b', '#2c3340', '#dfe7ef', '#1f1812', '#3d6b4f', '#2f4d7a', '#8b3a3a', '#c4a35a', '#c65d2e', '#6b4d8f', '#e8e4dc', '#5a6673', '#2e8b6e', '#7fa8c9', '#a8742f', '#4a2c1a', '#f2c14e', '#c9502e', '#7d6f52', '#5c4a34', '#8a7a5c', '#6b6152'];
+export declare const EYE_COLOR_PRESETS: readonly ['#2a1a10', '#4a2c1a', '#7a5230', '#a8742f', '#3d6b4f', '#2e8b6e', '#3b6ea5', '#7fa8c9', '#5a6673', '#6b4d8f', '#1a1a1a', '#c4a35a'];
+/**
+ * Skin runs as an even light-to-dark ramp rather than sharing the generic
+ * colour bag — picking a skin tone should feel like moving along a scale, not
+ * hunting for the believable entries among greens and purples.
+ */
+export declare const SKIN_TONE_PRESETS: readonly ['#f7e2d2', '#f2d4bd', '#ebc4a5', '#e0b088', '#d19a6f', '#bf8459', '#a86d45', '#8f5734', '#754427', '#5c341c', '#452614', '#311b0e'];
+/** Natural hair only, ordered fair to black, with greys and reds grouped. */
+export declare const HAIR_COLOR_PRESETS: readonly ['#efe3c2', '#e2c684', '#c9a04e', '#b8862f', '#8f5a20', '#6d4320', '#523118', '#3a2211', '#241510', '#12100f', '#c1512a', '#8f3a20', '#b9b3a6', '#e6e3dc'];
+/** Muted, hard-wearing cloth and leather — adventurer kit, not carnival. */
+export declare const CLOTH_COLOR_PRESETS: readonly ['#e8e4dc', '#b9b2a2', '#8a7a5c', '#6b6152', '#5c4a34', '#4a2c1a', '#3b2214', '#2b2b2b', '#1f1812', '#3d6b4f', '#2e6b52', '#4a5a3a', '#2f4d7a', '#3b6ea5', '#5a6673', '#8b3a3a', '#a8452e', '#c4a35a', '#a8742f', '#6b4d8f'];
+export declare const COLOR_PALETTE: readonly ["#e8e4dc", "#b9b2a2", "#8a7a5c", "#6b6152", "#5c4a34", "#4a2c1a", "#3b2214", "#2b2b2b", "#1f1812", "#3d6b4f", "#2e6b52", "#4a5a3a", "#2f4d7a", "#3b6ea5", "#5a6673", "#8b3a3a", "#a8452e", "#c4a35a", "#a8742f", "#6b4d8f"];
+export declare const EYE_COLORS: readonly ["#2a1a10", "#4a2c1a", "#7a5230", "#a8742f", "#3d6b4f", "#2e8b6e", "#3b6ea5", "#7fa8c9", "#5a6673", "#6b4d8f", "#1a1a1a", "#c4a35a"];
+export declare const SKIN_TONES: readonly ["#f7e2d2", "#f2d4bd", "#ebc4a5", "#e0b088", "#d19a6f", "#bf8459", "#a86d45", "#8f5734", "#754427", "#5c341c", "#452614", "#311b0e"];
+export declare const HAIR_COLORS: readonly ["#efe3c2", "#e2c684", "#c9a04e", "#b8862f", "#8f5a20", "#6d4320", "#523118", "#3a2211", "#241510", "#12100f", "#c1512a", "#8f3a20", "#b9b3a6", "#e6e3dc"];
+export declare const TOP_COLORS: readonly ["#e8e4dc", "#b9b2a2", "#8a7a5c", "#6b6152", "#5c4a34", "#4a2c1a", "#3b2214", "#2b2b2b", "#1f1812", "#3d6b4f", "#2e6b52", "#4a5a3a", "#2f4d7a", "#3b6ea5", "#5a6673", "#8b3a3a", "#a8452e", "#c4a35a", "#a8742f", "#6b4d8f"];
+export declare const TROUSER_COLORS: readonly ["#e8e4dc", "#b9b2a2", "#8a7a5c", "#6b6152", "#5c4a34", "#4a2c1a", "#3b2214", "#2b2b2b", "#1f1812", "#3d6b4f", "#2e6b52", "#4a5a3a", "#2f4d7a", "#3b6ea5", "#5a6673", "#8b3a3a", "#a8452e", "#c4a35a", "#a8742f", "#6b4d8f"];
+export declare const BOOT_COLORS: readonly ["#e8e4dc", "#b9b2a2", "#8a7a5c", "#6b6152", "#5c4a34", "#4a2c1a", "#3b2214", "#2b2b2b", "#1f1812", "#3d6b4f", "#2e6b52", "#4a5a3a", "#2f4d7a", "#3b6ea5", "#5a6673", "#8b3a3a", "#a8452e", "#c4a35a", "#a8742f", "#6b4d8f"];
+export declare const HANDS_COLORS: readonly ["#e8e4dc", "#b9b2a2", "#8a7a5c", "#6b6152", "#5c4a34", "#4a2c1a", "#3b2214", "#2b2b2b", "#1f1812", "#3d6b4f", "#2e6b52", "#4a5a3a", "#2f4d7a", "#3b6ea5", "#5a6673", "#8b3a3a", "#a8452e", "#c4a35a", "#a8742f", "#6b4d8f"];
+export type HslColor = {
+    h: number;
+    s: number;
+    l: number;
+};
+export declare function hexToHsl(hex: string): HslColor;
+export declare function hslToHex(h: number, s: number, l: number): string;
+export declare function defaultAppearance(sex?: CharacterSex): CharacterAppearance;
+export declare function normalizeAppearance(raw: unknown): CharacterAppearance;
+//# sourceMappingURL=appearance.d.ts.map

package/dist/appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../src/appearance.ts"],"names":[],"mappings":"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"}

package/dist/appearance.js

@@ -0,0 +1,319 @@
+export const HAIR_STYLE_IDS = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
+export const HEAD_PRESET_IDS = [0, 1, 2, 3, 4, 5, 6, 7];
+export const BODY_TYPE_IDS = ['slim', 'average', 'athletic', 'stocky'];
+export const EYEBROW_STYLE_IDS = [0, 1];
+export const FACIAL_HAIR_IDS = [0, 1];
+export const OUTFIT_IDS = ['peasant', 'ranger'];
+export const OUTFIT_LABELS = {
+    peasant: 'Peasant',
+    ranger: 'Ranger',
+};
+export const HAIR_STYLE_LABELS = {
+    0: 'Parted',
+    1: 'Parted+',
+    2: 'Long',
+    3: 'Buns',
+    4: 'Buzz',
+    5: 'Buzz+',
+    6: 'Long soft',
+    7: 'Crop',
+    8: 'Twin buns',
+    9: 'Full buns',
+    10: 'Side part',
+    11: 'Long+',
+};
+export const BODY_TYPE_LABELS = {
+    slim: 'Slim',
+    average: 'Average',
+    athletic: 'Athletic',
+    stocky: 'Stocky',
+};
+export const EYEBROW_STYLE_LABELS = {
+    0: 'Straight',
+    1: 'Arched',
+};
+export const FACIAL_HAIR_LABELS = {
+    0: 'None',
+    1: 'Beard',
+};
+export const HEAD_PRESET_LABELS = {
+    0: 'Round',
+    1: 'Oval',
+    2: 'Square',
+    3: 'Heart',
+    4: 'Angular',
+    5: 'Broad',
+    6: 'Narrow',
+    7: 'Chiseled',
+};
+export const COLOR_PRESETS = [
+    '#f6d7c3',
+    '#e8b98a',
+    '#c98a5c',
+    '#8d5524',
+    '#3b2214',
+    '#1a1a1a',
+    '#2b2b2b',
+    '#2c3340',
+    '#dfe7ef',
+    '#1f1812',
+    '#3d6b4f',
+    '#2f4d7a',
+    '#8b3a3a',
+    '#c4a35a',
+    '#c65d2e',
+    '#6b4d8f',
+    '#e8e4dc',
+    '#5a6673',
+    '#2e8b6e',
+    '#7fa8c9',
+    '#a8742f',
+    '#4a2c1a',
+    '#f2c14e',
+    '#c9502e',
+    '#7d6f52',
+    '#5c4a34',
+    '#8a7a5c',
+    '#6b6152',
+];
+export const EYE_COLOR_PRESETS = [
+    '#2a1a10',
+    '#4a2c1a',
+    '#7a5230',
+    '#a8742f',
+    '#3d6b4f',
+    '#2e8b6e',
+    '#3b6ea5',
+    '#7fa8c9',
+    '#5a6673',
+    '#6b4d8f',
+    '#1a1a1a',
+    '#c4a35a',
+];
+/**
+ * Skin runs as an even light-to-dark ramp rather than sharing the generic
+ * colour bag — picking a skin tone should feel like moving along a scale, not
+ * hunting for the believable entries among greens and purples.
+ */
+export const SKIN_TONE_PRESETS = [
+    '#f7e2d2',
+    '#f2d4bd',
+    '#ebc4a5',
+    '#e0b088',
+    '#d19a6f',
+    '#bf8459',
+    '#a86d45',
+    '#8f5734',
+    '#754427',
+    '#5c341c',
+    '#452614',
+    '#311b0e',
+];
+/** Natural hair only, ordered fair to black, with greys and reds grouped. */
+export const HAIR_COLOR_PRESETS = [
+    '#efe3c2',
+    '#e2c684',
+    '#c9a04e',
+    '#b8862f',
+    '#8f5a20',
+    '#6d4320',
+    '#523118',
+    '#3a2211',
+    '#241510',
+    '#12100f',
+    '#c1512a',
+    '#8f3a20',
+    '#b9b3a6',
+    '#e6e3dc',
+];
+/** Muted, hard-wearing cloth and leather — adventurer kit, not carnival. */
+export const CLOTH_COLOR_PRESETS = [
+    '#e8e4dc',
+    '#b9b2a2',
+    '#8a7a5c',
+    '#6b6152',
+    '#5c4a34',
+    '#4a2c1a',
+    '#3b2214',
+    '#2b2b2b',
+    '#1f1812',
+    '#3d6b4f',
+    '#2e6b52',
+    '#4a5a3a',
+    '#2f4d7a',
+    '#3b6ea5',
+    '#5a6673',
+    '#8b3a3a',
+    '#a8452e',
+    '#c4a35a',
+    '#a8742f',
+    '#6b4d8f',
+];
+export const COLOR_PALETTE = CLOTH_COLOR_PRESETS;
+export const EYE_COLORS = EYE_COLOR_PRESETS;
+export const SKIN_TONES = SKIN_TONE_PRESETS;
+export const HAIR_COLORS = HAIR_COLOR_PRESETS;
+export const TOP_COLORS = CLOTH_COLOR_PRESETS;
+export const TROUSER_COLORS = CLOTH_COLOR_PRESETS;
+export const BOOT_COLORS = CLOTH_COLOR_PRESETS;
+export const HANDS_COLORS = CLOTH_COLOR_PRESETS;
+function clamp01(n) {
+    return Math.min(1, Math.max(0, n));
+}
+export function hexToHsl(hex) {
+    const raw = hex.replace('#', '');
+    if (!/^[0-9a-fA-F]{6}$/.test(raw))
+        return { h: 0, s: 0, l: 0.5 };
+    const r = parseInt(raw.slice(0, 2), 16) / 255;
+    const g = parseInt(raw.slice(2, 4), 16) / 255;
+    const b = parseInt(raw.slice(4, 6), 16) / 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min)
+        return { h: 0, s: 0, l };
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h = 0;
+    if (max === r)
+        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    else if (max === g)
+        h = ((b - r) / d + 2) / 6;
+    else
+        h = ((r - g) / d + 4) / 6;
+    return { h, s, l };
+}
+function hueToRgb(p, q, t) {
+    let tt = t;
+    if (tt < 0)
+        tt += 1;
+    if (tt > 1)
+        tt -= 1;
+    if (tt < 1 / 6)
+        return p + (q - p) * 6 * tt;
+    if (tt < 1 / 2)
+        return q;
+    if (tt < 2 / 3)
+        return p + (q - p) * (2 / 3 - tt) * 6;
+    return p;
+}
+export function hslToHex(h, s, l) {
+    const hh = ((h % 1) + 1) % 1;
+    const ss = clamp01(s);
+    const ll = clamp01(l);
+    let r;
+    let g;
+    let b;
+    if (ss === 0) {
+        r = g = b = ll;
+    }
+    else {
+        const q = ll < 0.5 ? ll * (1 + ss) : ll + ss - ll * ss;
+        const p = 2 * ll - q;
+        r = hueToRgb(p, q, hh + 1 / 3);
+        g = hueToRgb(p, q, hh);
+        b = hueToRgb(p, q, hh - 1 / 3);
+    }
+    const to = (n) => Math.round(clamp01(n) * 255)
+        .toString(16)
+        .padStart(2, '0');
+    return `#${to(r)}${to(g)}${to(b)}`;
+}
+export function defaultAppearance(sex = 'male') {
+    if (sex === 'female') {
+        return {
+            sex: 'female',
+            outfit: null,
+            hairStyle: 2,
+            headPreset: 3,
+            bodyType: 'average',
+            eyebrowStyle: 1,
+            facialHair: 0,
+            hairColor: '#c1512a',
+            beardColor: '#c1512a',
+            browColor: '#c1512a',
+            topColor: '#3d6b4f',
+            trousersColor: '#3b2214',
+            skinTone: '#f2d4bd',
+            bootColor: '#4a2c1a',
+            handsColor: '#f2d4bd',
+            eyeColor: '#3b6ea5',
+        };
+    }
+    return {
+        sex: 'male',
+        outfit: null,
+        hairStyle: 0,
+        headPreset: 1,
+        bodyType: 'average',
+        eyebrowStyle: 0,
+        facialHair: 0,
+        hairColor: '#241510',
+        beardColor: '#241510',
+        browColor: '#241510',
+        topColor: '#4a5a3a',
+        trousersColor: '#3b2214',
+        skinTone: '#e0b088',
+        bootColor: '#4a2c1a',
+        handsColor: '#e0b088',
+        eyeColor: '#3b6ea5',
+    };
+}
+export function normalizeAppearance(raw) {
+    if (!raw || typeof raw !== 'object')
+        return defaultAppearance();
+    const a = raw;
+    const sex = a.sex === 'female' ? 'female' : 'male';
+    const base = defaultAppearance(sex);
+    const hairStyle = HAIR_STYLE_IDS.includes(a.hairStyle)
+        ? a.hairStyle
+        : base.hairStyle;
+    const headPreset = HEAD_PRESET_IDS.includes(a.headPreset)
+        ? a.headPreset
+        : base.headPreset;
+    const eyebrowStyle = EYEBROW_STYLE_IDS.includes(a.eyebrowStyle)
+        ? a.eyebrowStyle
+        : base.eyebrowStyle;
+    let facialHair = 0;
+    if (sex !== 'female') {
+        facialHair = FACIAL_HAIR_IDS.includes(a.facialHair)
+            ? a.facialHair
+            : hairStyle === 1 || hairStyle === 5 || hairStyle === 11
+                ? 1
+                : 0;
+    }
+    const pick = (v, fallback) => typeof v === 'string' && /^#[0-9a-fA-F]{6}$/.test(v) ? v : fallback;
+    const skinTone = pick(a.skinTone, base.skinTone);
+    const hairColor = pick(a.hairColor, base.hairColor);
+    return {
+        sex,
+        // Preserved deliberately. Every player-facing path runs through this
+        // function, so a field that is not copied here is silently discarded —
+        // which would leave players undressed while NPCs (who bypass
+        // normalisation) rendered correctly.
+        outfit: OUTFIT_IDS.includes(a.outfit) ? a.outfit : null,
+        hairStyle,
+        headPreset,
+        bodyType: 'average',
+        eyebrowStyle,
+        facialHair,
+        hairColor,
+        beardColor: pick(a.beardColor, hairColor),
+        browColor: pick(a.browColor, hairColor),
+        topColor: pick(a.topColor, base.topColor),
+        trousersColor: pick(a.trousersColor, base.trousersColor),
+        skinTone,
+        // Boots were pinned to skinTone back when "boots" meant the painted foot
+        // zone of a bare body — tinting them anything else produced odd-looking
+        // socks. Real boot geometry arrives with outfits, so the choice has to
+        // survive; without this every outfitted character wears flesh-coloured
+        // leather. Characters saved before this change still carry a skin-toned
+        // bootColor, which stays correct for them precisely because they are barefoot.
+        bootColor: pick(a.bootColor, base.bootColor),
+        // Hands stay tied to skin: this drives the bare-hand zone and the
+        // procedural mitten hands. Gloves override it later via applyWornGear.
+        handsColor: skinTone,
+        eyeColor: pick(a.eyeColor, base.eyeColor),
+    };
+}
+//# sourceMappingURL=appearance.js.map

package/dist/appearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../src/appearance.ts"],"names":[],"mappings":"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"}

package/dist/bank.d.ts

@@ -0,0 +1,15 @@
+import type { InventorySlot } from './messages.js';
+export declare const BANK_TAB_COUNT = 6;
+export declare const BANK_SLOTS_PER_TAB = 20;
+export declare const BANK_MOVE_MAX = 50;
+export declare const BANK_QTY_PRESETS: readonly [1, 5, 10, 50];
+export declare const BANK_RANGE = 3;
+export type BankSlot = InventorySlot;
+export type BankTab = Array<BankSlot | null>;
+export type BankState = {
+    tabs: BankTab[];
+};
+export declare function emptyBankTab(): BankTab;
+export declare function emptyBank(): BankState;
+export declare function normalizeBank(raw: unknown): BankState;
+//# sourceMappingURL=bank.d.ts.map

package/dist/bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank.d.ts","sourceRoot":"","sources":["../src/bank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,gBAAgB,YAAI,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AACxD,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC;AACrC,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAE5C,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,SAAS,IAAI,SAAS,CAErC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CA0BrD"}

package/dist/bank.js

@@ -0,0 +1,45 @@
+export const BANK_TAB_COUNT = 6;
+export const BANK_SLOTS_PER_TAB = 20;
+export const BANK_MOVE_MAX = 50;
+export const BANK_QTY_PRESETS = [1, 5, 10, 50];
+export const BANK_RANGE = 3;
+export function emptyBankTab() {
+    return Array.from({ length: BANK_SLOTS_PER_TAB }, () => null);
+}
+export function emptyBank() {
+    return { tabs: Array.from({ length: BANK_TAB_COUNT }, () => emptyBankTab()) };
+}
+export function normalizeBank(raw) {
+    const empty = emptyBank();
+    if (!raw || typeof raw !== 'object')
+        return empty;
+    const tabsRaw = raw.tabs;
+    if (!Array.isArray(tabsRaw))
+        return empty;
+    const tabs = empty.tabs.map((fallback, ti) => {
+        const src = tabsRaw[ti];
+        if (!Array.isArray(src))
+            return fallback;
+        const tab = emptyBankTab();
+        for (let i = 0; i < BANK_SLOTS_PER_TAB; i++) {
+            const slot = src[i];
+            if (!slot || typeof slot !== 'object')
+                continue;
+            const kind = slot.kind;
+            const qty = slot.qty;
+            if (typeof kind !== 'string' || !kind)
+                continue;
+            if (typeof qty !== 'number' || !Number.isFinite(qty) || qty < 1)
+                continue;
+            const precision = slot.precision;
+            tab[i] = {
+                kind,
+                qty: Math.floor(qty),
+                ...(typeof precision === 'number' && Number.isFinite(precision) ? { precision } : {}),
+            };
+        }
+        return tab;
+    });
+    return { tabs };
+}
+//# sourceMappingURL=bank.js.map

package/dist/bank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank.js","sourceRoot":"","sources":["../src/bank.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAM5B,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,OAAO,GAAI,GAA0B,CAAC,IAAI,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAc,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE;QACtD,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC;QACzC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAChD,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;YAC/C,MAAM,GAAG,GAAI,IAA0B,CAAC,GAAG,CAAC;YAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI;gBAAE,SAAS;YAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;gBAAE,SAAS;YAC1E,MAAM,SAAS,GAAI,IAAgC,CAAC,SAAS,CAAC;YAC9D,GAAG,CAAC,CAAC,CAAC,GAAG;gBACP,IAAI;gBACJ,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBACpB,GAAG,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/clientConfig.d.ts

@@ -0,0 +1,103 @@
+export declare const CAMERA_ZOOM_MIN = 8;
+export declare const CAMERA_ZOOM_MAX = 24;
+/**
+ * Slightly elevated 3/4 view: character and ground ahead, not RTS top-down
+ * (old default 14) and not cramped over-the-shoulder.
+ */
+export declare const CAMERA_ZOOM_DEFAULT = 11;
+/**
+ * Radians from the horizon. ~0.92 is a 3/4 look-down; 1.42 was nearly
+ * straight top-down.
+ */
+export declare const CAMERA_PITCH_DEFAULT = 0.92;
+export declare const CAMERA_PITCH_MIN = 0.35;
+export declare const CAMERA_PITCH_MAX = 1.48;
+/**
+ * Bump when the default view changes so old saved bird's-eye zooms migrate.
+ * Saved configs with a lower revision get the new pitch/zoom pair.
+ */
+export declare const CAMERA_VIEW_REVISION = 3;
+export declare const CHAT_WIDTH_MIN = 200;
+export declare const CHAT_WIDTH_MAX = 640;
+export declare const CHAT_WIDTH_DEFAULT = 340;
+export declare const CHAT_HEIGHT_MIN = 64;
+export declare const CHAT_HEIGHT_MAX = 420;
+export declare const CHAT_HEIGHT_DEFAULT = 112;
+/** Compact / phone chat has no resize grip; keep the log short by default. */
+export declare const CHAT_HEIGHT_COMPACT_DEFAULT = 72;
+/** Match MeshHud compact chat and the HUD CSS breakpoint. */
+export declare const CHAT_COMPACT_MAX_WIDTH = 720;
+export declare const CHAT_FONT_SIZE_MIN = 9;
+export declare const CHAT_FONT_SIZE_MAX = 18;
+export declare const CHAT_FONT_SIZE_DEFAULT = 12;
+export declare const HUD_BAR_SIZE_MIN = 32;
+export declare const HUD_BAR_SIZE_MAX = 64;
+export declare const HUD_BAR_SIZE_DEFAULT = 38;
+export declare const QUEST_LOG_POS_UNSET = -1;
+export declare const PANEL_POS_UNSET = -1;
+/** 5th panel swatch (see THEME_PANEL_SWATCHES in the client's ui/colors.ts). */
+export declare const THEME_PANEL_DEFAULT = "#2e2620";
+export declare const THEME_INK_DEFAULT = "#f2f5e9";
+export type ClientConfig = {
+    showNames: boolean;
+    showHealth: boolean;
+    hideRoofs: boolean;
+    hideAvatar: boolean;
+    soundEnabled: boolean;
+    musicEnabled: boolean;
+    minimapZoom: number;
+    cameraZoom: number;
+    cameraViewRevision: number;
+    chat: {
+        width: number;
+        height: number;
+        fontSize: number;
+    };
+    questLog: {
+        x: number;
+        y: number;
+    };
+    playerCard: {
+        x: number;
+        y: number;
+    };
+    theme: {
+        panel: string;
+        ink: string;
+    };
+    hudBarSize: number;
+};
+export type PartialClientConfig = {
+    showNames?: boolean;
+    showHealth?: boolean;
+    hideRoofs?: boolean;
+    hideAvatar?: boolean;
+    soundEnabled?: boolean;
+    musicEnabled?: boolean;
+    minimapZoom?: number;
+    cameraZoom?: number;
+    cameraViewRevision?: number;
+    chat?: {
+        width?: number;
+        height?: number;
+        fontSize?: number;
+    };
+    questLog?: {
+        x?: number;
+        y?: number;
+    };
+    playerCard?: {
+        x?: number;
+        y?: number;
+    };
+    theme?: {
+        panel?: string;
+        ink?: string;
+    };
+    hudBarSize?: number;
+};
+export declare function clampHudBarSize(size: number): number;
+export declare function defaultClientConfig(): ClientConfig;
+export declare function normalizeClientConfig(raw: unknown): ClientConfig;
+export declare function mergeClientConfig(current: ClientConfig, patch: PartialClientConfig | null | undefined): ClientConfig;
+//# sourceMappingURL=clientConfig.d.ts.map

package/dist/clientConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientConfig.d.ts","sourceRoot":"","sources":["../src/clientConfig.ts"],"names":[],"mappings":"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"}