@skinhub/viewer 0.1.1

package/dist/item.d.ts

@@ -0,0 +1,118 @@
+/**
+ * *** THE BRIDGE - an integrator's item into the frame's item, and back out again. ***
+ *
+ * This is the package's actual work. Everything else is an `<iframe>` and a message listener.
+ *
+ * ═════════════════════════════════════════════════════════════════════════════════════════════
+ * *** THE TWO VOCABULARIES, AND WHY WE DO NOT JUST PICK ONE. ***
+ *
+ * The frame speaks the renderer's names (`weaponType`) and the GAME's names (`sticker_id`,
+ * `offset_x`, `pattern`), because those are what the shader parameters, the WeaponPaints columns and
+ * the inspect codec all call the same six slots. That is right for the wire and wrong for a prop: an
+ * integrator writing `offset_x` in a React tree is writing protobuf into their view layer.
+ *
+ * So there are two, and exactly one file that knows both. A field renamed on either side breaks HERE,
+ * at compile time, rather than becoming a picture that is quietly missing a sticker.
+ *
+ * ═════════════════════════════════════════════════════════════════════════════════════════════
+ * *** AND THE PIECE THE FRAME CANNOT DO FOR ITSELF: AN INSPECT LINK'S IDENTITY. ***
+ *
+ * `?i=` carries an item's CONFIGURATION - float, seed, StatTrak, the plate, five stickers and the
+ * charm - and the frame decodes all of it. What it does not carry, for the frame, is WHICH WEAPON: a
+ * link says `defindex: 7` and the renderer wants `weapon_ak47`, and the app's own `SkinViewer`
+ * says so in a comment naming this package as the place the table lives:
+ *
+ *     "the 63-row table between them lives in `@skinhub/viewer`'s `src/weapons.ts` - an in-flight file
+ *      outside this app's dependency graph."
+ *
+ * Which makes `inspectLink` a first-class prop rather than a documented gap. This file resolves the
+ * identity here, on the host, and hands the frame both halves. An integrator never decodes a link to
+ * use us - That is stated as a requirement and it is the path the product exists for.
+ */
+import { type SkinPlacement } from '@skinhub/cdn/placement';
+import type { FrameItem, PlacementSlots } from './protocol.js';
+import type { SkinViewerCharm, SkinViewerError, SkinViewerItem, SkinViewerSticker, ViewerSubject } from './types.js';
+/**
+ * The public sticker list and charm as the six-slot tuple the frame validates.
+ *
+ * *** ARRAY POSITION IS THE SLOT UNLESS A STICKER NAMES ITS OWN, *** which is what makes
+ * `stickers={[a, null, b]}` mean slots 0 and 2 - the shape a marketplace's own UI produces when a user
+ * has filled two of five holders. A sticker naming a slot outside `0..4` is dropped rather than
+ * wrapped, because a sixth sticker slot is the charm's and putting a sticker there would be a picture
+ * nobody asked for.
+ *
+ * RETURNS `undefined` WHEN THERE IS NOTHING PLACED, so an item with no stickers sends no `stickers`
+ * key at all and cannot disturb the frame's sticker draft. See `patch.ts`.
+ */
+export declare const toSlots: (stickers: readonly (SkinViewerSticker | null)[] | undefined, charm: SkinViewerCharm | null | undefined) => PlacementSlots | undefined;
+/** The six-slot tuple back into the public shape - what `onChange` hands an integrator. */
+export declare const fromSlots: (slots: PlacementSlots | undefined) => {
+    stickers: SkinViewerSticker[];
+    charm: SkinViewerCharm | null;
+};
+export type ResolvedSubject = {
+    item: FrameItem;
+    inspectPayload: string | null;
+    error: null;
+}
+/**
+ * *** NO ITEM AND NO GUESS. *** Every failure here produces a null item, and `SkinViewer` then asks
+ * the frame for its instruction card rather than letting it fall back to our default AK - which
+ * would look exactly like a successful render of the wrong gun, and is the one outcome worth more
+ * than all the rest of this file to avoid.
+ */
+ | {
+    item: null;
+    inspectPayload: null;
+    error: SkinViewerError;
+};
+/**
+ * *** THE ONE FUNCTION THE WHOLE PROP SURFACE FUNNELS THROUGH. *** Either arm of
+ * {@link ViewerSubject}, plus the runtime cases the types were supposed to prevent, into one item.
+ *
+ * IT IS PURE AND SYNCHRONOUS - no fetch, no React, no catalogue - which is what lets the component
+ * build the frame's URL in a `useState` initialiser and have the FIRST PAINT be the integrator's item
+ * rather than ours swapped a tick later.
+ */
+export declare const resolveSubject: (subject: Partial<ViewerSubject>) => ResolvedSubject;
+/**
+ * The frame's item as the public one - what {@link SkinViewerProps.onChange} hands back.
+ *
+ * *** ALWAYS THE `{ weapon }` FORM, NEVER `{ defindex }`. *** The frame reports a `weaponType`, and
+ * turning it back into a number is a lookup that can fail for a weapon shipped after this package
+ * was built. An integrator who needs the number has `defindexForWeaponId` exported for it, where the
+ * failure is theirs to see rather than ours to hide.
+ */
+export declare const toPublicItem: (item: FrameItem) => SkinViewerItem;
+/**
+ * A viewer item as a `SkinPlacement` — `@skinhub/cdn`'s decoded-inspect-link shape.
+ *
+ * Reach for this when you want the placement itself: to write WeaponPaints rows, to diff against a
+ * link you already hold, or to hand to another `@skinhub/cdn` helper. If you just want the link, use
+ * {@link toInspectLink}.
+ *
+ * *** THROWS ON A WEAPON WITH NO DEFINDEX, and that is the only honest answer. *** An inspect link
+ * identifies its item by number, so an id this build has no row for cannot be encoded at all. Returning
+ * a link with `defindex: 0` in it would produce a string that looks like a link, copies like a link and
+ * opens an empty CS2 inspect screen.
+ */
+export declare const toPlacement: (item: SkinViewerItem) => SkinPlacement;
+/**
+ * A viewer item as a masked Steam inspect link — the string a user pastes into the game.
+ *
+ *     <button onClick={() => navigator.clipboard.writeText(toInspectLink(item))}>Copy inspect link</button>
+ *
+ * The inverse of passing `inspectLink` to `<SkinViewer>`, and it round-trips: a link built here decodes
+ * back to the same item through {@link fromInspectLink}.
+ */
+export declare const toInspectLink: (item: SkinViewerItem) => string;
+/**
+ * A masked inspect link as a viewer item — what `<SkinViewer inspectLink={…} />` does internally,
+ * exposed for a host that wants the fields rather than the picture (to seed an editor from a link, or
+ * to read a float out of one).
+ *
+ * *** RETURNS `null` RATHER THAN THROWING ON A LINK IT CANNOT READ, *** because the input is usually
+ * something a user pasted, and a paste being wrong is an ordinary event rather than an exception.
+ */
+export declare const fromInspectLink: (link: string) => SkinViewerItem | null;
+//# sourceMappingURL=item.d.ts.map

package/dist/item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../src/item.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3G,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAgBpH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,GACnB,UAAU,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,EAC3D,OAAO,eAAe,GAAG,IAAI,GAAG,SAAS,KACvC,cAAc,GAAG,SAkCnB,CAAA;AAED,2FAA2F;AAC3F,eAAO,MAAM,SAAS,GACrB,OAAO,cAAc,GAAG,SAAS,KAC/B;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CAyBhE,CAAA;AAMD,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE;AACjE;;;;;GAKG;GACD;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAA;AA+B/D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,CAAC,aAAa,CAAC,KAAG,eAwFhE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,SAAS,KAAG,cAa9C,CAAA;AAqBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,cAAc,KAAG,aAqBlD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,cAAc,KAAG,MAA4C,CAAA;AAEjG;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,cAAc,GAAG,IAG/D,CAAA"}

package/dist/item.js

@@ -0,0 +1,319 @@
+/**
+ * *** THE BRIDGE - an integrator's item into the frame's item, and back out again. ***
+ *
+ * This is the package's actual work. Everything else is an `<iframe>` and a message listener.
+ *
+ * ═════════════════════════════════════════════════════════════════════════════════════════════
+ * *** THE TWO VOCABULARIES, AND WHY WE DO NOT JUST PICK ONE. ***
+ *
+ * The frame speaks the renderer's names (`weaponType`) and the GAME's names (`sticker_id`,
+ * `offset_x`, `pattern`), because those are what the shader parameters, the WeaponPaints columns and
+ * the inspect codec all call the same six slots. That is right for the wire and wrong for a prop: an
+ * integrator writing `offset_x` in a React tree is writing protobuf into their view layer.
+ *
+ * So there are two, and exactly one file that knows both. A field renamed on either side breaks HERE,
+ * at compile time, rather than becoming a picture that is quietly missing a sticker.
+ *
+ * ═════════════════════════════════════════════════════════════════════════════════════════════
+ * *** AND THE PIECE THE FRAME CANNOT DO FOR ITSELF: AN INSPECT LINK'S IDENTITY. ***
+ *
+ * `?i=` carries an item's CONFIGURATION - float, seed, StatTrak, the plate, five stickers and the
+ * charm - and the frame decodes all of it. What it does not carry, for the frame, is WHICH WEAPON: a
+ * link says `defindex: 7` and the renderer wants `weapon_ak47`, and the app's own `SkinViewer`
+ * says so in a comment naming this package as the place the table lives:
+ *
+ *     "the 63-row table between them lives in `@skinhub/viewer`'s `src/weapons.ts` - an in-flight file
+ *      outside this app's dependency graph."
+ *
+ * Which makes `inspectLink` a first-class prop rather than a documented gap. This file resolves the
+ * identity here, on the host, and hands the frame both halves. An integrator never decodes a link to
+ * use us - That is stated as a requirement and it is the path the product exists for.
+ */
+import { buildInspectUrl, readInspectUrl } from '@skinhub/cdn/inspect';
+import { emptyKeychain, emptySticker, makeSkinPlacement } from '@skinhub/cdn/placement';
+import { defindexForWeaponId, normalizeWeaponId, weaponIdForDefindex } from './weapons.js';
+/** `sticker_id === 0` is how the wire says "this slot is empty". */
+const isPlaced = (placement) => placement.sticker_id > 0;
+/** Six empty slots. Rebuilt per call because the caller mutates the copy it is handed. */
+const emptySlots = () => [
+    emptySticker(0),
+    emptySticker(1),
+    emptySticker(2),
+    emptySticker(3),
+    emptySticker(4),
+    emptyKeychain(),
+];
+/**
+ * The public sticker list and charm as the six-slot tuple the frame validates.
+ *
+ * *** ARRAY POSITION IS THE SLOT UNLESS A STICKER NAMES ITS OWN, *** which is what makes
+ * `stickers={[a, null, b]}` mean slots 0 and 2 - the shape a marketplace's own UI produces when a user
+ * has filled two of five holders. A sticker naming a slot outside `0..4` is dropped rather than
+ * wrapped, because a sixth sticker slot is the charm's and putting a sticker there would be a picture
+ * nobody asked for.
+ *
+ * RETURNS `undefined` WHEN THERE IS NOTHING PLACED, so an item with no stickers sends no `stickers`
+ * key at all and cannot disturb the frame's sticker draft. See `patch.ts`.
+ */
+export const toSlots = (stickers, charm) => {
+    if ((!stickers || stickers.length === 0) && !charm)
+        return undefined;
+    const slots = emptySlots();
+    stickers?.forEach((sticker, index) => {
+        if (!sticker)
+            return;
+        const slot = sticker.slot ?? index;
+        if (slot < 0 || slot > 4)
+            return;
+        slots[slot] = {
+            slot,
+            sticker_id: sticker.id,
+            wear: sticker.wear ?? 0,
+            // The game treats an unset scale as 1 and an inspect link cannot carry `scale <= 0`. It is not
+            // on the public surface because nothing in CS2 sets it per sticker.
+            scale: 1,
+            rotation: sticker.rotation ?? 0,
+            offset_x: sticker.offsetX ?? 0,
+            offset_y: sticker.offsetY ?? 0,
+        };
+    });
+    if (charm)
+        slots[5] = {
+            slot: 0,
+            sticker_id: charm.id,
+            // `pattern` IS the charm's seed - the keychain message is the sticker message reused, so the
+            // field it lands in is the one a sticker calls its pattern index.
+            pattern: charm.seed ?? 0,
+            offset_x: charm.offset?.[0] ?? 0,
+            offset_y: charm.offset?.[1] ?? 0,
+            offset_z: charm.offset?.[2] ?? 0,
+        };
+    return slots;
+};
+/** The six-slot tuple back into the public shape - what `onChange` hands an integrator. */
+export const fromSlots = (slots) => {
+    if (!slots)
+        return { stickers: [], charm: null };
+    const stickers = slots.slice(0, 5).flatMap((placement) => {
+        const sticker = placement;
+        if (!isPlaced(sticker))
+            return [];
+        return [
+            {
+                id: sticker.sticker_id,
+                slot: sticker.slot,
+                wear: sticker.wear,
+                rotation: sticker.rotation,
+                offsetX: sticker.offset_x,
+                offsetY: sticker.offset_y,
+            },
+        ];
+    });
+    const keychain = slots[5];
+    const charm = isPlaced(keychain)
+        ? {
+            id: keychain.sticker_id,
+            seed: keychain.pattern,
+            offset: [keychain.offset_x, keychain.offset_y, keychain.offset_z],
+        }
+        : null;
+    return { stickers, charm };
+};
+/**
+ * A `SkinPlacement` (whatever produced it) as the frame's item.
+ *
+ * Every field maps 1:1 with no rescaling: `g_vStickerNOffset` is `Range2(-0.5,-0.5, 0.5,0.5)` and the
+ * protobuf carries that range verbatim, so the offsets really are the same numbers.
+ */
+const fromPlacement = (placement, weaponType) => {
+    const slots = emptySlots();
+    for (const sticker of placement.stickers ?? []) {
+        if (!isPlaced(sticker))
+            continue;
+        const slot = sticker.slot;
+        if (slot < 0 || slot > 4)
+            continue;
+        slots[slot] = sticker;
+    }
+    if (placement.keychain && isPlaced(placement.keychain))
+        slots[5] = placement.keychain;
+    return {
+        weaponType,
+        paintIndex: placement.paintindex,
+        float: placement.paintwear,
+        seed: placement.paintseed,
+        // `stattrak` present is what makes an item StatTrak and `0` is a real count - see the prop's own
+        // doc for why this collapses to one field rather than two.
+        statTrak: placement.stattrak ? (placement.stattrak_count ?? 0) : false,
+        nameTag: placement.nametag ?? null,
+        stickers: slots,
+    };
+};
+/**
+ * *** THE ONE FUNCTION THE WHOLE PROP SURFACE FUNNELS THROUGH. *** Either arm of
+ * {@link ViewerSubject}, plus the runtime cases the types were supposed to prevent, into one item.
+ *
+ * IT IS PURE AND SYNCHRONOUS - no fetch, no React, no catalogue - which is what lets the component
+ * build the frame's URL in a `useState` initialiser and have the FIRST PAINT be the integrator's item
+ * rather than ours swapped a tick later.
+ */
+export const resolveSubject = (subject) => {
+    const fail = (code, message) => ({
+        item: null,
+        inspectPayload: null,
+        error: { code, message },
+    });
+    if (typeof subject.inspectLink === 'string' && subject.inspectLink.length > 0) {
+        let placement;
+        try {
+            placement = readInspectUrl(subject.inspectLink);
+        }
+        catch (cause) {
+            /*
+             * MASKED LINKS ONLY, and this is where an integrator finds that out. The `S…A…D…` / `M…`
+             * inventory and market forms carry no item data at all - they needed a Game Coordinator round
+             * trip Valve has shut down - so there is nothing in them to render and no partial answer to
+             * fall back to.
+             */
+            return fail('bad-inspect-link', `The inspect link did not decode: ${cause instanceof Error ? cause.message : String(cause)}. Only MASKED links (the long hex payload) carry item data; the S…A…D… and M… inventory forms needed a Game Coordinator round trip Valve has shut down and cannot be rendered by anyone.`);
+        }
+        const weaponType = weaponIdForDefindex(placement.defindex);
+        if (!weaponType)
+            return fail('unknown-weapon', `The inspect link decoded, but defindex ${placement.defindex} is not a weapon this build of @skinhub/viewer has an id for. Pass \`item={{ weapon: '…', paintIndex: ${placement.paintindex} }}\` instead, or update the package.`);
+        return {
+            item: fromPlacement(placement, weaponType),
+            /*
+             * THE ORIGINAL STRING IS KEPT AND FORWARDED AS `?i=` RATHER THAN RE-ENCODED. A round trip
+             * through our own encoder would be a second implementation of the codec in the URL path, free
+             * to disagree with the one the frame decodes with; forwarding the customer's own bytes means
+             * the frame reads exactly what Valve wrote.
+             */
+            inspectPayload: subject.inspectLink,
+            error: null,
+        };
+    }
+    const item = subject.item;
+    if (!item || typeof item !== 'object')
+        return fail('no-item', 'No item. <SkinViewer> needs exactly one of `inspectLink` or `item` - in TypeScript that is a compile error, so this is JavaScript, an `any`, or data that had not arrived yet.');
+    const weapon = item.weapon ?? (typeof item.defindex === 'number' ? weaponIdForDefindex(item.defindex) : undefined);
+    if (!weapon)
+        return typeof item.defindex === 'number'
+            ? fail('unknown-weapon', `defindex ${item.defindex} is not a weapon this build of @skinhub/viewer has an id for. Pass \`weapon\` instead, or update the package.`)
+            : fail('no-item', '`item` named no weapon. Pass either `weapon: "weapon_ak47"` (from `skin.weapon.id` on a @skinhub/cdn row) or `defindex: 7`.');
+    if (typeof item.paintIndex !== 'number')
+        return fail('no-item', '`item.paintIndex` is required. `0` is the correct value for a vanilla item and renders the bare model.');
+    return {
+        item: {
+            // HUD aliases folded here rather than at the frame: `skins.json` gives the twenty VANILLA knife
+            // rows an `sfui_wpnhud_*` id, so `row.weapon.id` off a vanilla Bayonet is a HUD string. The
+            // renderer resolves both to the same GLB; folding here also makes the value we echo back in
+            // `onChange` the item id rather than the alias.
+            weaponType: normalizeWeaponId(weapon),
+            paintIndex: item.paintIndex,
+            ...(item.legacyModel !== undefined && { legacyModel: item.legacyModel }),
+            ...(item.float !== undefined && { float: item.float }),
+            ...(item.seed !== undefined && { seed: item.seed }),
+            ...(item.statTrak !== undefined && { statTrak: item.statTrak }),
+            ...(item.nameTag !== undefined && { nameTag: item.nameTag }),
+            ...(() => {
+                const slots = toSlots(item.stickers, item.charm);
+                return slots ? { stickers: slots } : {};
+            })(),
+        },
+        inspectPayload: null,
+        error: null,
+    };
+};
+/**
+ * The frame's item as the public one - what {@link SkinViewerProps.onChange} hands back.
+ *
+ * *** ALWAYS THE `{ weapon }` FORM, NEVER `{ defindex }`. *** The frame reports a `weaponType`, and
+ * turning it back into a number is a lookup that can fail for a weapon shipped after this package
+ * was built. An integrator who needs the number has `defindexForWeaponId` exported for it, where the
+ * failure is theirs to see rather than ours to hide.
+ */
+export const toPublicItem = (item) => {
+    const { stickers, charm } = fromSlots(item.stickers);
+    return {
+        weapon: item.weaponType,
+        paintIndex: item.paintIndex,
+        ...(item.legacyModel !== undefined && { legacyModel: item.legacyModel }),
+        ...(item.float !== undefined && { float: item.float }),
+        ...(item.seed !== undefined && { seed: item.seed }),
+        ...(item.statTrak !== undefined && { statTrak: item.statTrak }),
+        ...(item.nameTag !== undefined && { nameTag: item.nameTag }),
+        stickers,
+        charm,
+    };
+};
+/* ═════════════════════════════════════════════════════════════════════════════════════════════
+ * BACK OUT AGAIN — AN ITEM AS AN INSPECT LINK
+ *
+ * *** THE RETURN JOURNEY, AND IT IS THE HALF THAT WAS MISSING. *** Everything above turns an
+ * integrator's item INTO a picture. A skin picker is not finished when it can show you the item; it is
+ * finished when it can hand you the link. Without these two functions every integrator writes the same
+ * forty lines against `@skinhub/cdn`'s placement API - and writes them from the same three facts that
+ * are easy to get wrong and silent when you do:
+ *
+ *   - `stattrak: 0` is a REAL, freshly-minted counter and `false` is no module. One boolean and one
+ *     count, not one nullable number.
+ *   - an unset sticker `scale` is `1`, not `0`. The WeaponPaints row default is `0` meaning "default",
+ *     and an encoder rejects `scale <= 0`, so passing it through produces a link that will not build.
+ *   - a charm's seed rides in `pattern`, because the keychain message is the sticker message reused.
+ *
+ * That list is the argument for these living here rather than in a docs snippet: they are the same
+ * three facts `toSlots` already encodes, and having them written twice is how the two copies disagree.
+ * ═══════════════════════════════════════════════════════════════════════════════════════════ */
+/**
+ * A viewer item as a `SkinPlacement` — `@skinhub/cdn`'s decoded-inspect-link shape.
+ *
+ * Reach for this when you want the placement itself: to write WeaponPaints rows, to diff against a
+ * link you already hold, or to hand to another `@skinhub/cdn` helper. If you just want the link, use
+ * {@link toInspectLink}.
+ *
+ * *** THROWS ON A WEAPON WITH NO DEFINDEX, and that is the only honest answer. *** An inspect link
+ * identifies its item by number, so an id this build has no row for cannot be encoded at all. Returning
+ * a link with `defindex: 0` in it would produce a string that looks like a link, copies like a link and
+ * opens an empty CS2 inspect screen.
+ */
+export const toPlacement = (item) => {
+    const weapon = 'weapon' in item && item.weapon ? item.weapon : undefined;
+    const defindex = weapon ? defindexForWeaponId(weapon) : item.defindex;
+    if (typeof defindex !== 'number')
+        throw new Error(`@skinhub/viewer: cannot build an inspect link for ${JSON.stringify(weapon)} — this build has no defindex for it. Pass \`defindex\` on the item, or update the package.`);
+    const slots = toSlots(item.stickers, item.charm) ?? emptySlots();
+    return makeSkinPlacement({
+        defindex,
+        paintindex: item.paintIndex,
+        paintseed: item.seed ?? 0,
+        paintwear: item.float ?? 0,
+        ...(item.nameTag ? { nametag: item.nameTag } : {}),
+        // `statTrak: 0` is a counter that has not counted yet. `false` is no module at all.
+        stattrak: item.statTrak !== undefined && item.statTrak !== false,
+        stattrak_count: typeof item.statTrak === 'number' ? item.statTrak : 0,
+        stickers: slots.slice(0, 5),
+        keychain: slots[5],
+    });
+};
+/**
+ * A viewer item as a masked Steam inspect link — the string a user pastes into the game.
+ *
+ *     <button onClick={() => navigator.clipboard.writeText(toInspectLink(item))}>Copy inspect link</button>
+ *
+ * The inverse of passing `inspectLink` to `<SkinViewer>`, and it round-trips: a link built here decodes
+ * back to the same item through {@link fromInspectLink}.
+ */
+export const toInspectLink = (item) => buildInspectUrl(toPlacement(item));
+/**
+ * A masked inspect link as a viewer item — what `<SkinViewer inspectLink={…} />` does internally,
+ * exposed for a host that wants the fields rather than the picture (to seed an editor from a link, or
+ * to read a float out of one).
+ *
+ * *** RETURNS `null` RATHER THAN THROWING ON A LINK IT CANNOT READ, *** because the input is usually
+ * something a user pasted, and a paste being wrong is an ordinary event rather than an exception.
+ */
+export const fromInspectLink = (link) => {
+    const resolved = resolveSubject({ inspectLink: link });
+    return resolved.item ? toPublicItem(resolved.item) : null;
+};
+//# sourceMappingURL=item.js.map

package/dist/item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.js","sourceRoot":"","sources":["../src/item.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAsB,MAAM,wBAAwB,CAAA;AAI3G,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAE1F,oEAAoE;AACpE,MAAM,QAAQ,GAAG,CAAC,SAAiC,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAA;AAEhF,0FAA0F;AAC1F,MAAM,UAAU,GAAG,GAAmB,EAAE,CAAC;IACxC,YAAY,CAAC,CAAC,CAAC;IACf,YAAY,CAAC,CAAC,CAAC;IACf,YAAY,CAAC,CAAC,CAAC;IACf,YAAY,CAAC,CAAC,CAAC;IACf,YAAY,CAAC,CAAC,CAAC;IACf,aAAa,EAAE;CACf,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACtB,QAA2D,EAC3D,KAAyC,EACZ,EAAE;IAC/B,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IACpE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAE1B,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACpC,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAA;QAClC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC;YAAE,OAAM;QAChC,KAAK,CAAC,IAAyB,CAAC,GAAG;YAClC,IAAI;YACJ,UAAU,EAAE,OAAO,CAAC,EAAE;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;YACvB,+FAA+F;YAC/F,oEAAoE;YACpE,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;YAC/B,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;YAC9B,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;SAC9B,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,IAAI,KAAK;QACR,KAAK,CAAC,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC;YACP,UAAU,EAAE,KAAK,CAAC,EAAE;YACpB,6FAA6F;YAC7F,kEAAkE;YAClE,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;YACxB,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAChC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAChC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAChC,CAAA;IAEF,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,KAAiC,EACkC,EAAE;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAuB,EAAE;QAC7E,MAAM,OAAO,GAAG,SAA8B,CAAA;QAC9C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAA;QACjC,OAAO;YACN;gBACC,EAAE,EAAE,OAAO,CAAC,UAAU;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAiC;gBAC/C,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,QAAQ;gBACzB,OAAO,EAAE,OAAO,CAAC,QAAQ;aACzB;SACD,CAAA;IACF,CAAC,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACzB,MAAM,KAAK,GAA2B,QAAQ,CAAC,QAAQ,CAAC;QACvD,CAAC,CAAC;YACA,EAAE,EAAE,QAAQ,CAAC,UAAU;YACvB,IAAI,EAAE,QAAQ,CAAC,OAAO;YACtB,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;SACjE;QACF,CAAC,CAAC,IAAI,CAAA;IACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;AAC3B,CAAC,CAAA;AAgBD;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CAAC,SAAwB,EAAE,UAAkB,EAAa,EAAE;IACjF,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAQ;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACzB,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC;YAAE,SAAQ;QAClC,KAAK,CAAC,IAAyB,CAAC,GAAG,OAAO,CAAA;IAC3C,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAA;IAErF,OAAO;QACN,UAAU;QACV,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,KAAK,EAAE,SAAS,CAAC,SAAS;QAC1B,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,iGAAiG;QACjG,2DAA2D;QAC3D,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;QACtE,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,IAAI;QAClC,QAAQ,EAAE,KAAK;KACf,CAAA;AACF,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAA+B,EAAmB,EAAE;IAClF,MAAM,IAAI,GAAG,CAAC,IAA6B,EAAE,OAAe,EAAmB,EAAE,CAAC,CAAC;QAClF,IAAI,EAAE,IAAI;QACV,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;KACxB,CAAC,CAAA;IAEF,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,IAAI,SAAwB,CAAA;QAC5B,IAAI,CAAC;YACJ,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB;;;;;eAKG;YACH,OAAO,IAAI,CACV,kBAAkB,EAClB,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,0LAA0L,CACpR,CAAA;QACF,CAAC;QACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAC1D,IAAI,CAAC,UAAU;YACd,OAAO,IAAI,CACV,gBAAgB,EAChB,0CAA0C,SAAS,CAAC,QAAQ,yGAAyG,SAAS,CAAC,UAAU,uCAAuC,CAChO,CAAA;QACF,OAAO;YACN,IAAI,EAAE,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC;YAC1C;;;;;eAKG;YACH,cAAc,EAAE,OAAO,CAAC,WAAW;YACnC,KAAK,EAAE,IAAI;SACX,CAAA;IACF,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QACpC,OAAO,IAAI,CACV,SAAS,EACT,gLAAgL,CAChL,CAAA;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAClH,IAAI,CAAC,MAAM;QACV,OAAO,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;YACvC,CAAC,CAAC,IAAI,CACJ,gBAAgB,EAChB,YAAY,IAAI,CAAC,QAAQ,+GAA+G,CACxI;YACF,CAAC,CAAC,IAAI,CACJ,SAAS,EACT,6HAA6H,CAC7H,CAAA;IAEJ,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;QACtC,OAAO,IAAI,CACV,SAAS,EACT,wGAAwG,CACxG,CAAA;IAEF,OAAO;QACN,IAAI,EAAE;YACL,gGAAgG;YAChG,4FAA4F;YAC5F,4FAA4F;YAC5F,gDAAgD;YAChD,UAAU,EAAE,iBAAiB,CAAC,MAAM,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YACxE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACnD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5D,GAAG,CAAC,GAAG,EAAE;gBACR,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;gBAChD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;YACxC,CAAC,CAAC,EAAE;SACJ;QACD,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,IAAI;KACX,CAAA;AACF,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAe,EAAkB,EAAE;IAC/D,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACpD,OAAO;QACN,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/D,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5D,QAAQ;QACR,KAAK;KACL,CAAA;AACF,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;iGAiBiG;AAEjG;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAoB,EAAiB,EAAE;IAClE,MAAM,MAAM,GAAG,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAA;IACrE,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAC/B,MAAM,IAAI,KAAK,CACd,qDAAqD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,6FAA6F,CACxK,CAAA;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,UAAU,EAAE,CAAA;IAChE,OAAO,iBAAiB,CAAC;QACxB,QAAQ;QACR,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;QACzB,SAAS,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,oFAAoF;QACpF,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAChE,cAAc,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACrE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAA8B;QACxD,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;KACD,CAAC,CAAA;AACpB,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAoB,EAAU,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;AAEjG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAyB,EAAE;IACtE,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC,CAAA"}

package/dist/link.d.ts

@@ -0,0 +1,30 @@
+/**
+ * *** THE PRIVATE CHANNEL BETWEEN THE HOOK AND THE COMPONENT. ***
+ *
+ * `useSkinViewer()` returns a handle; `<SkinViewer handle={…} />` fills it in. Something has to carry
+ * `reload` from the component that can do it to the object that exposes it, and carry `status` back
+ * the other way.
+ *
+ * *** A SYMBOL KEY RATHER THAN `__internal`, *** for one practical reason: a symbol does not appear in
+ * an editor's autocomplete on the handle, so the only members an integrator ever sees are the four
+ * documented ones. It is not hiding - anyone can reach it - it is keeping the public surface exactly
+ * as large as the documentation says it is.
+ *
+ * *** AND IT IS A MUTABLE OBJECT RATHER THAN A CALLBACK PROP, *** because the identity of the thing
+ * passed as `handle` must never change: it is a plain prop on a component that re-renders on every
+ * frame of a float drag, and a fresh object there would be one more thing to compare per frame.
+ */
+import type { SkinViewerError, ViewerStatus } from './types.js';
+export declare const LINK: unique symbol;
+export type ViewerSnapshot = {
+    status: ViewerStatus;
+    error: SkinViewerError | null;
+    problems: readonly string[];
+};
+export type ViewerLink = {
+    /** Replaced by the mounted component; a no-op before mount and after unmount. */
+    reload: () => void;
+    /** The component pushing its state up. Bails when nothing moved - see `useSkinViewer`. */
+    publish: (snapshot: ViewerSnapshot) => void;
+};
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE/D,eAAO,MAAM,IAAI,EAAE,OAAO,MAAuC,CAAA;AAEjE,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,iFAAiF;IACjF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,0FAA0F;IAC1F,OAAO,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAA;CAC3C,CAAA"}

package/dist/link.js

@@ -0,0 +1,18 @@
+/**
+ * *** THE PRIVATE CHANNEL BETWEEN THE HOOK AND THE COMPONENT. ***
+ *
+ * `useSkinViewer()` returns a handle; `<SkinViewer handle={…} />` fills it in. Something has to carry
+ * `reload` from the component that can do it to the object that exposes it, and carry `status` back
+ * the other way.
+ *
+ * *** A SYMBOL KEY RATHER THAN `__internal`, *** for one practical reason: a symbol does not appear in
+ * an editor's autocomplete on the handle, so the only members an integrator ever sees are the four
+ * documented ones. It is not hiding - anyone can reach it - it is keeping the public surface exactly
+ * as large as the documentation says it is.
+ *
+ * *** AND IT IS A MUTABLE OBJECT RATHER THAN A CALLBACK PROP, *** because the identity of the thing
+ * passed as `handle` must never change: it is a plain prop on a component that re-renders on every
+ * frame of a float drag, and a fresh object there would be one more thing to compare per frame.
+ */
+export const LINK = Symbol('@skinhub/viewer/link');
+//# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAkB,MAAM,CAAC,sBAAsB,CAAC,CAAA"}