@dicebear/core 10.0.0-rc.4 → 10.0.0-rc.5

package/README.md

@@ -27,7 +27,8 @@ Playground, your next avatar is always just a stone's throw away!
 
 ## Sponsors
 
-Advertisement: Many thanks to our sponsors who provide us with free or discounted products.
+Advertisement: Many thanks to our sponsors who provide us with free or
+discounted products.
 
 <a href="https://bunny.net/" target="_blank" rel="noopener noreferrer">
     <picture>

package/lib/Options.d.ts

@@ -1,3 +1,4 @@
+import type { Range } from './StyleDefinition.js';
 import type { StyleOptions, StyleOptionsFlipValue, StyleOptionsColorFillValue } from './StyleOptions.js';
 /**
  * Validates the raw user-supplied options and exposes them through typed
@@ -19,11 +20,11 @@ export declare class Options<D = unknown> {
     flip(): readonly StyleOptionsFlipValue[];
     fontFamily(): readonly string[];
     fontWeight(): readonly number[];
-    scale(): readonly number[];
-    borderRadius(): readonly number[];
-    rotate(): readonly number[];
-    translateX(): readonly number[];
-    translateY(): readonly number[];
+    scale(): Range | undefined;
+    borderRadius(): Range | undefined;
+    rotate(): Range | undefined;
+    translateX(): Range | undefined;
+    translateY(): Range | undefined;
     /**
      * Returns the user-set variant constraint for `name`:
      * - `undefined` when the user did not set `${name}Variant`,
@@ -39,6 +40,6 @@ export declare class Options<D = unknown> {
      */
     color(name: string): readonly string[] | undefined;
     colorFill(name: string): readonly StyleOptionsColorFillValue[];
-    colorAngle(name: string): readonly number[];
-    colorFillStops(name: string): readonly number[];
+    colorAngle(name: string): Range | undefined;
+    colorFillStops(name: string): Range | undefined;
 }

package/lib/Options.js

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Options_instances, _Options_data, _Options_dynamic, _Options_asArray;
+var _Options_instances, _Options_data, _Options_dynamic, _Options_asArray, _Options_toRange;
 import { OptionsValidator } from './Validator/OptionsValidator.js';
 /**
  * Validates the raw user-supplied options and exposes them through typed
@@ -50,19 +50,19 @@ export class Options {
         return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").fontWeight);
     }
     scale() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").scale);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_data, "f").scale);
     }
     borderRadius() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").borderRadius);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_data, "f").borderRadius);
     }
     rotate() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").rotate);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_data, "f").rotate);
     }
     translateX() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").translateX);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_data, "f").translateX);
     }
     translateY() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").translateY);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_data, "f").translateY);
     }
     /**
      * Returns the user-set variant constraint for `name`:
@@ -98,10 +98,10 @@ export class Options {
         return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorFill`));
     }
     colorAngle(name) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorAngle`));
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorAngle`));
     }
     colorFillStops(name) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorFillStops`));
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_toRange).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorFillStops`));
     }
 }
 _Options_data = new WeakMap(), _Options_instances = new WeakSet(), _Options_dynamic = function _Options_dynamic(key) {
@@ -114,4 +114,12 @@ _Options_data = new WeakMap(), _Options_instances = new WeakSet(), _Options_dyna
         return value;
     }
     return [value];
+}, _Options_toRange = function _Options_toRange(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === 'number') {
+        return { min: value, max: value };
+    }
+    return { min: value[0], max: value[1] };
 };

package/lib/Prng/Mulberry32.js

@@ -36,7 +36,7 @@ export class Mulberry32 {
         const z = (__classPrivateFieldSet(this, _Mulberry32_state, (__classPrivateFieldGet(this, _Mulberry32_state, "f") + 0x6d2b79f5) | 0, "f"));
         let t = Math.imul(z ^ (z >>> 15), z | 1);
         t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
-        return ((t ^ (t >>> 14)) >>> 0);
+        return (t ^ (t >>> 14)) >>> 0;
     }
     /**
      * Advances the state and returns the next value in `[0, 1)`.

package/lib/Prng.d.ts

@@ -1,3 +1,4 @@
+import type { Range } from './StyleDefinition.js';
 /**
  * Key-based pseudorandom number generator.
  *
@@ -10,14 +11,17 @@ export declare class Prng {
     constructor(seed: string);
     /**
      * Picks a single item from `items` deterministically. Returns `undefined`
-     * for an empty list. Items are sorted by their string representation
-     * before picking so that input order does not affect the result.
+     * for an empty list. Duplicate values (by string representation) are
+     * collapsed before picking so that input order and duplication do not
+     * affect the result.
      */
     pick<T>(key: string, items: readonly T[]): T | undefined;
     /**
-     * Picks an item from `entries` proportional to its weight. When all weights
-     * are zero, falls back to an unweighted {@link pick}. Returns `undefined`
-     * for an empty list.
+     * Picks an item from `entries` proportional to its weight. Duplicate items
+     * (by string representation) are collapsed before picking — only the
+     * first occurrence's weight is kept. When all weights are zero, falls
+     * back to an unweighted {@link pick}. Returns `undefined` for an empty
+     * list.
      */
     weightedPick<T>(key: string, entries: readonly (readonly [T, number])[]): T | undefined;
     /**
@@ -25,17 +29,25 @@ export declare class Prng {
      */
     bool(key: string, likelihood?: number): boolean;
     /**
-     * Returns a deterministic float in the closed range `[min(values), max(values)]`,
-     * rounded to four decimal places. Returns `undefined` for an empty list.
+     * Returns a deterministic float in `range`, rounded to four decimal places.
+     * With `range.step > 0`, the result is drawn uniformly from
+     * `{ min + i*step | 0 ≤ i ≤ floor((max - min) / step) }`, so both endpoints
+     * of an evenly-divisible range are equally likely. Non-positive or absent
+     * step means continuous. `min`/`max` are sorted internally, so a reversed
+     * pair is tolerated.
      */
-    float(key: string, values: readonly number[]): number | undefined;
+    float(key: string, range: Range): number;
     /**
-     * Returns a deterministic integer in the closed range
-     * `[min(values), max(values)]`. Returns `undefined` for an empty list.
+     * Returns a deterministic integer in `range`. `min`/`max` are sorted
+     * internally, so a reversed pair is tolerated. `range.step` is accepted
+     * for symmetry with {@link float} but ignored — integers already step by 1.
      */
-    integer(key: string, values: readonly number[]): number | undefined;
+    integer(key: string, range: Range): number;
     /**
-     * Fisher-Yates shuffle with chained Mulberry32 state.
+     * Fisher-Yates shuffle with chained Mulberry32 state. Duplicate values
+     * (by string representation) are collapsed before shuffling, so a
+     * caller's slice off the front cannot accidentally produce a repeated
+     * value.
      */
     shuffle<T>(key: string, items: readonly T[]): T[];
     /**

package/lib/Prng.js

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Prng_instances, _Prng_seed, _Prng_compareByCodePoint;
+var _Prng_instances, _Prng_seed, _Prng_uniqueByCodePoint, _Prng_compareByCodePoint;
 import { Fnv1a } from './Prng/Fnv1a.js';
 import { Mulberry32 } from './Prng/Mulberry32.js';
 /**
@@ -27,8 +27,9 @@ export class Prng {
     }
     /**
      * Picks a single item from `items` deterministically. Returns `undefined`
-     * for an empty list. Items are sorted by their string representation
-     * before picking so that input order does not affect the result.
+     * for an empty list. Duplicate values (by string representation) are
+     * collapsed before picking so that input order and duplication do not
+     * affect the result.
      */
     pick(key, items) {
         if (items.length === 0) {
@@ -37,20 +38,30 @@ export class Prng {
         if (items.length === 1) {
             return items[0];
         }
-        const sorted = Array.from(items).sort(__classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint));
+        const unique = __classPrivateFieldGet(this, _Prng_instances, "m", _Prng_uniqueByCodePoint).call(this, items);
+        if (unique.length === 1) {
+            return unique[0];
+        }
+        const sorted = unique.sort(__classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint));
         const index = Math.floor(this.getValue(key) * sorted.length);
         return sorted[index];
     }
     /**
-     * Picks an item from `entries` proportional to its weight. When all weights
-     * are zero, falls back to an unweighted {@link pick}. Returns `undefined`
-     * for an empty list.
+     * Picks an item from `entries` proportional to its weight. Duplicate items
+     * (by string representation) are collapsed before picking — only the
+     * first occurrence's weight is kept. When all weights are zero, falls
+     * back to an unweighted {@link pick}. Returns `undefined` for an empty
+     * list.
      */
     weightedPick(key, entries) {
         if (entries.length === 0) {
             return undefined;
         }
-        const sorted = Array.from(entries).sort((a, b) => __classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint).call(this, a[0], b[0]));
+        if (entries.length === 1) {
+            return entries[0][0];
+        }
+        const unique = __classPrivateFieldGet(this, _Prng_instances, "m", _Prng_uniqueByCodePoint).call(this, entries, (e) => String(e[0]));
+        const sorted = unique.sort((a, b) => __classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint).call(this, a[0], b[0]));
         const totalWeight = sorted.reduce((sum, e) => sum + e[1], 0);
         if (totalWeight === 0) {
             return this.pick(key, sorted.map((e) => e[0]));
@@ -72,34 +83,49 @@ export class Prng {
         return this.getValue(key) * 100 < likelihood;
     }
     /**
-     * Returns a deterministic float in the closed range `[min(values), max(values)]`,
-     * rounded to four decimal places. Returns `undefined` for an empty list.
+     * Returns a deterministic float in `range`, rounded to four decimal places.
+     * With `range.step > 0`, the result is drawn uniformly from
+     * `{ min + i*step | 0 ≤ i ≤ floor((max - min) / step) }`, so both endpoints
+     * of an evenly-divisible range are equally likely. Non-positive or absent
+     * step means continuous. `min`/`max` are sorted internally, so a reversed
+     * pair is tolerated.
      */
-    float(key, values) {
-        if (values.length === 0) {
-            return undefined;
+    float(key, range) {
+        const min = Math.min(range.min, range.max);
+        const max = Math.max(range.min, range.max);
+        const step = range.step ?? 0;
+        let value;
+        if (step > 0) {
+            const buckets = Math.floor((max - min) / step) + 1;
+            const i = Math.floor(this.getValue(key) * buckets);
+            value = min + i * step;
         }
-        const min = Math.min(...values);
-        const max = Math.max(...values);
-        return Math.round((min + this.getValue(key) * (max - min)) * 10000) / 10000;
+        else {
+            value = min + this.getValue(key) * (max - min);
+        }
+        return Math.round(value * 10000) / 10000;
     }
     /**
-     * Returns a deterministic integer in the closed range
-     * `[min(values), max(values)]`. Returns `undefined` for an empty list.
+     * Returns a deterministic integer in `range`. `min`/`max` are sorted
+     * internally, so a reversed pair is tolerated. `range.step` is accepted
+     * for symmetry with {@link float} but ignored — integers already step by 1.
      */
-    integer(key, values) {
-        if (values.length === 0) {
-            return undefined;
-        }
-        const min = Math.min(...values);
-        const max = Math.max(...values);
+    integer(key, range) {
+        const min = Math.min(range.min, range.max);
+        const max = Math.max(range.min, range.max);
         return Math.floor(this.getValue(key) * (max - min + 1)) + min;
     }
     /**
-     * Fisher-Yates shuffle with chained Mulberry32 state.
+     * Fisher-Yates shuffle with chained Mulberry32 state. Duplicate values
+     * (by string representation) are collapsed before shuffling, so a
+     * caller's slice off the front cannot accidentally produce a repeated
+     * value.
      */
     shuffle(key, items) {
-        const result = Array.from(items).sort(__classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint));
+        if (items.length <= 1) {
+            return [...items];
+        }
+        const result = __classPrivateFieldGet(this, _Prng_instances, "m", _Prng_uniqueByCodePoint).call(this, items).sort(__classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint));
         const prng = new Mulberry32(Fnv1a.hash(__classPrivateFieldGet(this, _Prng_seed, "f") + ':' + key));
         for (let i = result.length - 1; i > 0; i--) {
             const j = Math.floor(prng.nextFloat() * (i + 1));
@@ -117,7 +143,18 @@ export class Prng {
         return new Mulberry32(Fnv1a.hash(__classPrivateFieldGet(this, _Prng_seed, "f") + ':' + key)).nextFloat();
     }
 }
-_Prng_seed = new WeakMap(), _Prng_instances = new WeakSet(), _Prng_compareByCodePoint = function _Prng_compareByCodePoint(a, b) {
+_Prng_seed = new WeakMap(), _Prng_instances = new WeakSet(), _Prng_uniqueByCodePoint = function _Prng_uniqueByCodePoint(items, keyFn = String) {
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        const repr = keyFn(item);
+        if (!seen.has(repr)) {
+            seen.add(repr);
+            result.push(item);
+        }
+    }
+    return result;
+}, _Prng_compareByCodePoint = function _Prng_compareByCodePoint(a, b) {
     const sa = String(a);
     const sb = String(b);
     if (sa < sb) {

package/lib/Renderer.js

@@ -208,8 +208,17 @@ _Renderer_style = new WeakMap(), _Renderer_resolver = new WeakMap(), _Renderer_d
         __classPrivateFieldGet(this, _Renderer_defs, "f").set(id, `<g id="${id}">${body}</g>`);
     }
     const transforms = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_buildTransforms).call(this, component);
-    const transformAttr = transforms.length > 0 ? ` transform="${transforms.join(' ')}"` : '';
-    return `<use${transformAttr} href="#${id}"/>`;
+    const userAttributes = element.attributes();
+    let mergedAttributes = userAttributes;
+    if (transforms.length > 0) {
+        const userTransform = userAttributes?.transform;
+        const allParts = typeof userTransform === 'string' && userTransform.length > 0
+            ? [userTransform, ...transforms]
+            : transforms;
+        mergedAttributes = { ...userAttributes, transform: allParts.join(' ') };
+    }
+    const attrs = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_renderAttributes).call(this, mergedAttributes);
+    return `<use${attrs} href="#${id}"/>`;
 }, _Renderer_buildTransforms = function _Renderer_buildTransforms(component) {
     const { rotate, translateX, translateY, scale } = __classPrivateFieldGet(this, _Renderer_resolver, "f").componentTransform(component.name());
     if (translateX === 0 && translateY === 0 && rotate === 0 && scale === 1) {

package/lib/Resolver.d.ts

@@ -5,8 +5,10 @@ import type { StyleOptionsFlipValue, StyleOptionsColorFillValue, StyleOptions }
  * Bundles the three inputs needed to derive any deterministic value for an
  * avatar — the {@link Style}, the validated user {@link Options}, and a
  * seeded {@link Prng} — and exposes them as named accessors. Each accessor
- * memoizes its result so that repeated calls cannot drift, and the memo
- * doubles as the snapshot returned by {@link resolved}.
+ * memoizes its result so that repeated calls cannot drift. The memo also
+ * serves as the informational snapshot returned by {@link resolved} — every
+ * value the resolver picks during one resolution lands there, except for
+ * the raw seed.
  */
 export declare class Resolver<D = unknown> {
     #private;
@@ -38,9 +40,10 @@ export declare class Resolver<D = unknown> {
     colorFill(name: string): StyleOptionsColorFillValue;
     colorAngle(name: string): number;
     /**
-     * Per-component transform values are render-time decorations derived per
-     * `<use>` reference, not user-input options that should round-trip. They
-     * are intentionally not memoized and so never appear in {@link resolved}.
+     * Picks the rotate/translateX/translateY/scale values for a single
+     * component. Memoized per `name`, so the four values land in
+     * {@link resolved} as `${name}Rotate` / `${name}TranslateX` /
+     * `${name}TranslateY` / `${name}Scale` for downstream introspection.
      */
     componentTransform(name: string): {
         rotate: number;
@@ -49,11 +52,16 @@ export declare class Resolver<D = unknown> {
         scale: number;
     };
     /**
-     * Returns every value that has been touched during this resolution. Only
-     * memoized entries are included; unset options remain `undefined` and
-     * disappear on `JSON.stringify()`. Per-component transform values from
-     * {@link componentTransform} and the user-supplied {@link seed} are
-     * intentionally not memoized and therefore do not appear in the snapshot.
+     * Returns an informational snapshot of every value the resolver picked.
+     * Includes top-level options (scale/rotate/translate/…), per-component
+     * variants/probabilities/colors, and per-component transform picks. The
+     * raw seed is deliberately excluded.
+     *
+     * The snapshot is NOT a round-trip-able options object — extra keys like
+     * `${name}Rotate` are not part of {@link StyleOptions} and feeding the
+     * snapshot back into a new {@link Avatar} is not supported. Callers that
+     * need to reproduce an avatar should pass the original `seed` and
+     * user-supplied options.
      *
      * The returned object aliases the internal cache; callers that need
      * isolation (e.g. {@link Avatar.toJSON}) clone it themselves.

package/lib/Resolver.js

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Resolver_instances, _Resolver_style, _Resolver_options, _Resolver_prng, _Resolver_colorResolving, _Resolver_result, _Resolver_probability, _Resolver_isVisible, _Resolver_resolveColor, _Resolver_colorFillStops, _Resolver_pickFloat, _Resolver_memo;
+var _Resolver_instances, _Resolver_style, _Resolver_options, _Resolver_prng, _Resolver_colorResolving, _Resolver_result, _Resolver_probability, _Resolver_isVisible, _Resolver_resolveColor, _Resolver_colorFillStops, _Resolver_memoFloat, _Resolver_memo;
 import { Prng } from './Prng.js';
 import { Color } from './Utils/Color.js';
 import { CircularColorReferenceError } from './Error/CircularColorReferenceError.js';
@@ -17,8 +17,10 @@ import { CircularColorReferenceError } from './Error/CircularColorReferenceError
  * Bundles the three inputs needed to derive any deterministic value for an
  * avatar — the {@link Style}, the validated user {@link Options}, and a
  * seeded {@link Prng} — and exposes them as named accessors. Each accessor
- * memoizes its result so that repeated calls cannot drift, and the memo
- * doubles as the snapshot returned by {@link resolved}.
+ * memoizes its result so that repeated calls cannot drift. The memo also
+ * serves as the informational snapshot returned by {@link resolved} — every
+ * value the resolver picks during one resolution lands there, except for
+ * the raw seed.
  */
 export class Resolver {
     constructor(style, options) {
@@ -33,7 +35,8 @@ export class Resolver {
         __classPrivateFieldSet(this, _Resolver_prng, new Prng(this.seed()), "f");
     }
     seed() {
-        // Not memoized so the raw seed stays out of {@link resolved}.
+        // Deliberately not memoized — the seed is the only input we keep out of
+        // the {@link resolved} snapshot, so a serialized avatar never leaks it.
         return __classPrivateFieldGet(this, _Resolver_options, "f").seed() ?? '';
     }
     size() {
@@ -49,25 +52,26 @@ export class Resolver {
         return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'flip', () => __classPrivateFieldGet(this, _Resolver_prng, "f").pick('flip', __classPrivateFieldGet(this, _Resolver_options, "f").flip()) ?? 'none');
     }
     fontFamily() {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'fontFamily', () => __classPrivateFieldGet(this, _Resolver_prng, "f").pick('fontFamily', __classPrivateFieldGet(this, _Resolver_options, "f").fontFamily()) ?? 'system-ui');
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'fontFamily', () => __classPrivateFieldGet(this, _Resolver_prng, "f").pick('fontFamily', __classPrivateFieldGet(this, _Resolver_options, "f").fontFamily()) ??
+            'system-ui');
     }
     fontWeight() {
         return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'fontWeight', () => __classPrivateFieldGet(this, _Resolver_prng, "f").pick('fontWeight', __classPrivateFieldGet(this, _Resolver_options, "f").fontWeight()) ?? 400);
     }
     scale() {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'scale', () => __classPrivateFieldGet(this, _Resolver_prng, "f").float('scale', __classPrivateFieldGet(this, _Resolver_options, "f").scale()) ?? 1);
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, 'scale', __classPrivateFieldGet(this, _Resolver_options, "f").scale(), 1);
     }
     borderRadius() {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'borderRadius', () => __classPrivateFieldGet(this, _Resolver_prng, "f").float('borderRadius', __classPrivateFieldGet(this, _Resolver_options, "f").borderRadius()) ?? 0);
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, 'borderRadius', __classPrivateFieldGet(this, _Resolver_options, "f").borderRadius(), 0);
     }
     rotate() {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'rotate', () => __classPrivateFieldGet(this, _Resolver_prng, "f").float('rotate', __classPrivateFieldGet(this, _Resolver_options, "f").rotate()) ?? 0);
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, 'rotate', __classPrivateFieldGet(this, _Resolver_options, "f").rotate(), 0);
     }
     translateX() {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'translateX', () => __classPrivateFieldGet(this, _Resolver_prng, "f").float('translateX', __classPrivateFieldGet(this, _Resolver_options, "f").translateX()) ?? 0);
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, 'translateX', __classPrivateFieldGet(this, _Resolver_options, "f").translateX(), 0);
     }
     translateY() {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, 'translateY', () => __classPrivateFieldGet(this, _Resolver_prng, "f").float('translateY', __classPrivateFieldGet(this, _Resolver_options, "f").translateY()) ?? 0);
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, 'translateY', __classPrivateFieldGet(this, _Resolver_options, "f").translateY(), 0);
     }
     /**
      * Selects a variant for the given component. Depending on what was passed
@@ -113,28 +117,34 @@ export class Resolver {
             'solid');
     }
     colorAngle(name) {
-        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, `${name}ColorAngle`, () => __classPrivateFieldGet(this, _Resolver_prng, "f").float(`${name}ColorAngle`, __classPrivateFieldGet(this, _Resolver_options, "f").colorAngle(name)) ?? 0);
+        return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, `${name}ColorAngle`, __classPrivateFieldGet(this, _Resolver_options, "f").colorAngle(name), 0);
     }
     /**
-     * Per-component transform values are render-time decorations derived per
-     * `<use>` reference, not user-input options that should round-trip. They
-     * are intentionally not memoized and so never appear in {@link resolved}.
+     * Picks the rotate/translateX/translateY/scale values for a single
+     * component. Memoized per `name`, so the four values land in
+     * {@link resolved} as `${name}Rotate` / `${name}TranslateX` /
+     * `${name}TranslateY` / `${name}Scale` for downstream introspection.
      */
     componentTransform(name) {
         const component = __classPrivateFieldGet(this, _Resolver_style, "f").components().get(name);
         return {
-            rotate: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_pickFloat).call(this, name, 'Rotate', component?.rotate() ?? [], 0),
-            translateX: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_pickFloat).call(this, name, 'TranslateX', component?.translate().x() ?? [], 0),
-            translateY: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_pickFloat).call(this, name, 'TranslateY', component?.translate().y() ?? [], 0),
-            scale: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_pickFloat).call(this, name, 'Scale', component?.scale() ?? [], 1),
+            rotate: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, `${name}Rotate`, component?.rotate(), 0),
+            translateX: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, `${name}TranslateX`, component?.translate().x(), 0),
+            translateY: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, `${name}TranslateY`, component?.translate().y(), 0),
+            scale: __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memoFloat).call(this, `${name}Scale`, component?.scale(), 1),
         };
     }
     /**
-     * Returns every value that has been touched during this resolution. Only
-     * memoized entries are included; unset options remain `undefined` and
-     * disappear on `JSON.stringify()`. Per-component transform values from
-     * {@link componentTransform} and the user-supplied {@link seed} are
-     * intentionally not memoized and therefore do not appear in the snapshot.
+     * Returns an informational snapshot of every value the resolver picked.
+     * Includes top-level options (scale/rotate/translate/…), per-component
+     * variants/probabilities/colors, and per-component transform picks. The
+     * raw seed is deliberately excluded.
+     *
+     * The snapshot is NOT a round-trip-able options object — extra keys like
+     * `${name}Rotate` are not part of {@link StyleOptions} and feeding the
+     * snapshot back into a new {@link Avatar} is not supported. Callers that
+     * need to reproduce an avatar should pass the original `seed` and
+     * user-supplied options.
      *
      * The returned object aliases the internal cache; callers that need
      * isolation (e.g. {@link Avatar.toJSON}) clone it themselves.
@@ -191,9 +201,10 @@ _Resolver_style = new WeakMap(), _Resolver_options = new WeakMap(), _Resolver_pr
         : __classPrivateFieldGet(this, _Resolver_prng, "f").shuffle(`${name}Color`, candidates);
     return ordered.slice(0, stops);
 }, _Resolver_colorFillStops = function _Resolver_colorFillStops(name) {
-    return (__classPrivateFieldGet(this, _Resolver_prng, "f").integer(`${name}ColorFillStops`, __classPrivateFieldGet(this, _Resolver_options, "f").colorFillStops(name)) ?? 2);
-}, _Resolver_pickFloat = function _Resolver_pickFloat(name, suffix, range, fallback) {
-    return __classPrivateFieldGet(this, _Resolver_prng, "f").float(`${name}${suffix}`, range) ?? fallback;
+    const range = __classPrivateFieldGet(this, _Resolver_options, "f").colorFillStops(name);
+    return range ? __classPrivateFieldGet(this, _Resolver_prng, "f").integer(`${name}ColorFillStops`, range) : 2;
+}, _Resolver_memoFloat = function _Resolver_memoFloat(key, range, fallback) {
+    return __classPrivateFieldGet(this, _Resolver_instances, "m", _Resolver_memo).call(this, key, () => range ? __classPrivateFieldGet(this, _Resolver_prng, "f").float(key, range) : fallback);
 }, _Resolver_memo = function _Resolver_memo(key, compute) {
     if (key in __classPrivateFieldGet(this, _Resolver_result, "f")) {
         return __classPrivateFieldGet(this, _Resolver_result, "f")[key];

package/lib/Style/Component.d.ts

@@ -1,4 +1,4 @@
-import type { StyleDefinitionComponent } from '../StyleDefinition.js';
+import type { Range, StyleDefinitionComponent } from '../StyleDefinition.js';
 import { ComponentTranslate } from './ComponentTranslate.js';
 import { ComponentVariant } from './ComponentVariant.js';
 /**
@@ -43,13 +43,15 @@ export declare class Component {
      */
     probability(): number;
     /**
-     * Returns the rotation range definition. Aliases delegate to the source.
+     * Returns the rotation range, or `undefined` when unset.
+     * Aliases delegate to the source.
      */
-    rotate(): readonly number[];
+    rotate(): Range | undefined;
     /**
-     * Returns the scale range definition. Aliases delegate to the source.
+     * Returns the scale range, or `undefined` when unset.
+     * Aliases delegate to the source.
      */
-    scale(): readonly number[];
+    scale(): Range | undefined;
     /**
      * Returns the translate descriptor. Aliases delegate to the source.
      */

package/lib/Style/Component.js

@@ -78,22 +78,18 @@ export class Component {
         return __classPrivateFieldGet(this, _Component_instances, "m", _Component_asBase).call(this).probability ?? 100;
     }
     /**
-     * Returns the rotation range definition. Aliases delegate to the source.
+     * Returns the rotation range, or `undefined` when unset.
+     * Aliases delegate to the source.
      */
     rotate() {
-        if (__classPrivateFieldGet(this, _Component_source, "f")) {
-            return __classPrivateFieldGet(this, _Component_source, "f").rotate();
-        }
-        return __classPrivateFieldGet(this, _Component_instances, "m", _Component_asBase).call(this).rotate ?? [];
+        return __classPrivateFieldGet(this, _Component_source, "f") ? __classPrivateFieldGet(this, _Component_source, "f").rotate() : __classPrivateFieldGet(this, _Component_instances, "m", _Component_asBase).call(this).rotate;
     }
     /**
-     * Returns the scale range definition. Aliases delegate to the source.
+     * Returns the scale range, or `undefined` when unset.
+     * Aliases delegate to the source.
      */
     scale() {
-        if (__classPrivateFieldGet(this, _Component_source, "f")) {
-            return __classPrivateFieldGet(this, _Component_source, "f").scale();
-        }
-        return __classPrivateFieldGet(this, _Component_instances, "m", _Component_asBase).call(this).scale ?? [];
+        return __classPrivateFieldGet(this, _Component_source, "f") ? __classPrivateFieldGet(this, _Component_source, "f").scale() : __classPrivateFieldGet(this, _Component_instances, "m", _Component_asBase).call(this).scale;
     }
     /**
      * Returns the translate descriptor. Aliases delegate to the source.

package/lib/Style/ComponentTranslate.d.ts

@@ -1,4 +1,4 @@
-import type { StyleDefinitionComponentTranslate } from '../StyleDefinition.js';
+import type { Range, StyleDefinitionComponentTranslate } from '../StyleDefinition.js';
 /**
  * Read-only view over a component's `translate` block, providing the X and Y
  * offset ranges.
@@ -6,12 +6,6 @@ import type { StyleDefinitionComponentTranslate } from '../StyleDefinition.js';
 export declare class ComponentTranslate {
     #private;
     constructor(data: StyleDefinitionComponentTranslate);
-    /**
-     * Returns the horizontal offset range, or an empty list when unset.
-     */
-    x(): readonly number[];
-    /**
-     * Returns the vertical offset range, or an empty list when unset.
-     */
-    y(): readonly number[];
+    x(): Range | undefined;
+    y(): Range | undefined;
 }

package/lib/Style/ComponentTranslate.js

@@ -19,17 +19,11 @@ export class ComponentTranslate {
         _ComponentTranslate_data.set(this, void 0);
         __classPrivateFieldSet(this, _ComponentTranslate_data, data, "f");
     }
-    /**
-     * Returns the horizontal offset range, or an empty list when unset.
-     */
     x() {
-        return __classPrivateFieldGet(this, _ComponentTranslate_data, "f").x ?? [];
+        return __classPrivateFieldGet(this, _ComponentTranslate_data, "f").x;
     }
-    /**
-     * Returns the vertical offset range, or an empty list when unset.
-     */
     y() {
-        return __classPrivateFieldGet(this, _ComponentTranslate_data, "f").y ?? [];
+        return __classPrivateFieldGet(this, _ComponentTranslate_data, "f").y;
     }
 }
 _ComponentTranslate_data = new WeakMap();