@dicebear/core 10.0.0-rc.1 → 10.0.0-rc.3

package/lib/Prng/Mulberry32.d.ts

@@ -1,7 +1,29 @@
+/**
+ * Mulberry32 PRNG — stateful, matching the C reference by Tommy Ettinger.
+ *
+ * C original:
+ * ```c
+ * uint32_t z = (x += 0x6D2B79F5UL);
+ * z = (z ^ (z >> 15)) * (z | 1UL);
+ * z ^= z + (z ^ (z >> 7)) * (z | 61UL);
+ * return z ^ (z >> 14);
+ * ```
+ *
+ * @see https://gist.github.com/tommyettinger/46a874533244883189143505d203312c
+ */
 export declare class Mulberry32 {
     #private;
     constructor(seed: number);
+    /**
+     * Advances the state and returns the next unsigned 32-bit value.
+     */
     next(): number;
+    /**
+     * Advances the state and returns the next value in `[0, 1)`.
+     */
     nextFloat(): number;
+    /**
+     * Returns the current internal state, useful for snapshotting.
+     */
     state(): number;
 }

package/lib/Prng/Mulberry32.js

@@ -10,29 +10,43 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _Mulberry32_state;
-// Mulberry32 PRNG — stateful, matching the C reference by Tommy Ettinger.
-// https://gist.github.com/tommyettinger/46a874533244883189143505d203312c
-//
-// C original:
-//   uint32_t z = (x += 0x6D2B79F5UL);
-//   z = (z ^ (z >> 15)) * (z | 1UL);
-//   z ^= z + (z ^ (z >> 7)) * (z | 61UL);
-//   return z ^ (z >> 14);
 const UINT32_MAX_PLUS_1 = 2 ** 32;
+/**
+ * Mulberry32 PRNG — stateful, matching the C reference by Tommy Ettinger.
+ *
+ * C original:
+ * ```c
+ * uint32_t z = (x += 0x6D2B79F5UL);
+ * z = (z ^ (z >> 15)) * (z | 1UL);
+ * z ^= z + (z ^ (z >> 7)) * (z | 61UL);
+ * return z ^ (z >> 14);
+ * ```
+ *
+ * @see https://gist.github.com/tommyettinger/46a874533244883189143505d203312c
+ */
 export class Mulberry32 {
     constructor(seed) {
         _Mulberry32_state.set(this, void 0);
         __classPrivateFieldSet(this, _Mulberry32_state, seed, "f");
     }
+    /**
+     * Advances the state and returns the next unsigned 32-bit value.
+     */
     next() {
         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);
     }
+    /**
+     * Advances the state and returns the next value in `[0, 1)`.
+     */
     nextFloat() {
         return this.next() / UINT32_MAX_PLUS_1;
     }
+    /**
+     * Returns the current internal state, useful for snapshotting.
+     */
     state() {
         return __classPrivateFieldGet(this, _Mulberry32_state, "f");
     }

package/lib/Prng.d.ts

@@ -1,11 +1,46 @@
+/**
+ * Key-based pseudorandom number generator.
+ *
+ * Each method takes a key that, combined with the seed, produces a
+ * deterministic value. The same seed + key always yields the same result,
+ * regardless of call order.
+ */
 export declare class Prng {
     #private;
     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.
+     */
     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.
+     */
     weightedPick<T>(key: string, entries: readonly (readonly [T, number])[]): T | undefined;
+    /**
+     * Returns `true` with the given probability (0–100, default 50).
+     */
     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.
+     */
     float(key: string, values: readonly number[]): number | undefined;
+    /**
+     * Returns a deterministic integer in the closed range
+     * `[min(values), max(values)]`. Returns `undefined` for an empty list.
+     */
     integer(key: string, values: readonly number[]): number | undefined;
+    /**
+     * Fisher-Yates shuffle with chained Mulberry32 state.
+     */
     shuffle<T>(key: string, items: readonly T[]): T[];
+    /**
+     * Returns a single float in `[0, 1)` derived from `seed:key`. The same
+     * seed/key pair always produces the same value.
+     */
     getValue(key: string): number;
 }

package/lib/Prng.js

@@ -12,17 +12,24 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _Prng_instances, _Prng_seed, _Prng_compareByCodePoint;
 import { Fnv1a } from './Prng/Fnv1a.js';
 import { Mulberry32 } from './Prng/Mulberry32.js';
-// Key-based pseudorandom number generator.
-//
-// Each method takes a key that, combined with the seed, produces a
-// deterministic value. The same seed + key always yields the same result,
-// regardless of call order.
+/**
+ * Key-based pseudorandom number generator.
+ *
+ * Each method takes a key that, combined with the seed, produces a
+ * deterministic value. The same seed + key always yields the same result,
+ * regardless of call order.
+ */
 export class Prng {
     constructor(seed) {
         _Prng_instances.add(this);
         _Prng_seed.set(this, void 0);
         __classPrivateFieldSet(this, _Prng_seed, seed, "f");
     }
+    /**
+     * 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.
+     */
     pick(key, items) {
         if (items.length === 0) {
             return undefined;
@@ -34,6 +41,11 @@ export class Prng {
         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.
+     */
     weightedPick(key, entries) {
         if (entries.length === 0) {
             return undefined;
@@ -53,9 +65,16 @@ export class Prng {
         }
         return sorted[sorted.length - 1][0];
     }
+    /**
+     * Returns `true` with the given probability (0–100, default 50).
+     */
     bool(key, likelihood = 50) {
         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.
+     */
     float(key, values) {
         if (values.length === 0) {
             return undefined;
@@ -64,6 +83,10 @@ export class Prng {
         const max = Math.max(...values);
         return Math.round((min + this.getValue(key) * (max - min)) * 10000) / 10000;
     }
+    /**
+     * Returns a deterministic integer in the closed range
+     * `[min(values), max(values)]`. Returns `undefined` for an empty list.
+     */
     integer(key, values) {
         if (values.length === 0) {
             return undefined;
@@ -72,7 +95,9 @@ export class Prng {
         const max = Math.max(...values);
         return Math.floor(this.getValue(key) * (max - min + 1)) + min;
     }
-    // Fisher-Yates shuffle with chained Mulberry32 state.
+    /**
+     * Fisher-Yates shuffle with chained Mulberry32 state.
+     */
     shuffle(key, items) {
         const result = Array.from(items).sort(__classPrivateFieldGet(this, _Prng_instances, "m", _Prng_compareByCodePoint));
         const prng = new Mulberry32(Fnv1a.hash(__classPrivateFieldGet(this, _Prng_seed, "f") + ':' + key));
@@ -84,6 +109,10 @@ export class Prng {
         }
         return result;
     }
+    /**
+     * Returns a single float in `[0, 1)` derived from `seed:key`. The same
+     * seed/key pair always produces the same value.
+     */
     getValue(key) {
         return new Mulberry32(Fnv1a.hash(__classPrivateFieldGet(this, _Prng_seed, "f") + ':' + key)).nextFloat();
     }

package/lib/Renderer.d.ts

@@ -1,7 +1,16 @@
 import type { Style } from './Style.js';
-import type { Options } from './Options.js';
+import type { Resolver } from './Resolver.js';
+/**
+ * Walks a style's element tree and turns it into the final SVG markup.
+ *
+ * The renderer is single-use: it accumulates `<defs>` entries and per-render
+ * caches across method calls, so a fresh instance is required per avatar.
+ */
 export declare class Renderer {
     #private;
-    constructor(style: Style, options: Options);
+    constructor(style: Style, resolver: Resolver);
+    /**
+     * Builds the complete SVG document for the avatar.
+     */
     render(): string;
 }

package/lib/Renderer.js

@@ -9,22 +9,31 @@ 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 _Renderer_instances, _Renderer_style, _Renderer_options, _Renderer_defs, _Renderer_cachedSeedHash, _Renderer_cachedInitials, _Renderer_applyFlip, _Renderer_applyScale, _Renderer_applyBorderRadius, _Renderer_applyRotate, _Renderer_applyTranslate, _Renderer_renderBackground, _Renderer_randomizeIds, _Renderer_renderElements, _Renderer_renderElement, _Renderer_renderSvgElement, _Renderer_renderTextElement, _Renderer_renderComponentElement, _Renderer_buildTransforms, _Renderer_renderAttributes, _Renderer_resolveAttributeValue, _Renderer_resolveColorReference, _Renderer_buildGradientDef, _Renderer_resolveValue, _Renderer_resolveVariable, _Renderer_initials, _Renderer_hashSeed;
+var _Renderer_instances, _Renderer_style, _Renderer_resolver, _Renderer_defs, _Renderer_cachedSeedHash, _Renderer_cachedInitials, _Renderer_applyFlip, _Renderer_applyScale, _Renderer_applyBorderRadius, _Renderer_applyRotate, _Renderer_applyTranslate, _Renderer_renderBackground, _Renderer_randomizeIds, _Renderer_renderElements, _Renderer_renderElement, _Renderer_renderSvgElement, _Renderer_renderTextElement, _Renderer_renderComponentElement, _Renderer_buildTransforms, _Renderer_renderAttributes, _Renderer_resolveAttributeValue, _Renderer_resolveColorReference, _Renderer_buildGradientDef, _Renderer_resolveValue, _Renderer_resolveVariable, _Renderer_initials, _Renderer_hashSeed;
 import { Fnv1a } from './Prng/Fnv1a.js';
 import { Initials } from './Utils/Initials.js';
 import { License } from './Utils/License.js';
 import { Xml } from './Utils/Xml.js';
+/**
+ * Walks a style's element tree and turns it into the final SVG markup.
+ *
+ * The renderer is single-use: it accumulates `<defs>` entries and per-render
+ * caches across method calls, so a fresh instance is required per avatar.
+ */
 export class Renderer {
-    constructor(style, options) {
+    constructor(style, resolver) {
         _Renderer_instances.add(this);
         _Renderer_style.set(this, void 0);
-        _Renderer_options.set(this, void 0);
+        _Renderer_resolver.set(this, void 0);
         _Renderer_defs.set(this, new Map());
         _Renderer_cachedSeedHash.set(this, void 0);
         _Renderer_cachedInitials.set(this, void 0);
         __classPrivateFieldSet(this, _Renderer_style, style, "f");
-        __classPrivateFieldSet(this, _Renderer_options, options, "f");
+        __classPrivateFieldSet(this, _Renderer_resolver, resolver, "f");
     }
+    /**
+     * Builds the complete SVG document for the avatar.
+     */
     render() {
         const canvas = __classPrivateFieldGet(this, _Renderer_style, "f").canvas();
         const background = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_renderBackground).call(this, canvas);
@@ -40,8 +49,8 @@ export class Renderer {
         const defs = __classPrivateFieldGet(this, _Renderer_defs, "f").size > 0
             ? `<defs>${Array.from(__classPrivateFieldGet(this, _Renderer_defs, "f").values()).join('')}</defs>`
             : '';
-        const size = __classPrivateFieldGet(this, _Renderer_options, "f").size();
-        const title = __classPrivateFieldGet(this, _Renderer_options, "f").title();
+        const size = __classPrivateFieldGet(this, _Renderer_resolver, "f").size();
+        const title = __classPrivateFieldGet(this, _Renderer_resolver, "f").title();
         const escapedTitle = title !== undefined ? Xml.escape(title) : undefined;
         const attrs = [
             'xmlns="http://www.w3.org/2000/svg"',
@@ -62,14 +71,14 @@ export class Renderer {
         }
         const titleElement = escapedTitle !== undefined ? `<title>${escapedTitle}</title>` : '';
         let svg = `<svg ${attrs.join(' ')}>${metadata}${defs}${titleElement}${body}</svg>`;
-        if (__classPrivateFieldGet(this, _Renderer_options, "f").idRandomization()) {
+        if (__classPrivateFieldGet(this, _Renderer_resolver, "f").idRandomization()) {
             svg = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_randomizeIds).call(this, svg);
         }
         return svg;
     }
 }
-_Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_defs = new WeakMap(), _Renderer_cachedSeedHash = new WeakMap(), _Renderer_cachedInitials = new WeakMap(), _Renderer_instances = new WeakSet(), _Renderer_applyFlip = function _Renderer_applyFlip(body, canvas) {
-    const flip = __classPrivateFieldGet(this, _Renderer_options, "f").flip();
+_Renderer_style = new WeakMap(), _Renderer_resolver = new WeakMap(), _Renderer_defs = new WeakMap(), _Renderer_cachedSeedHash = new WeakMap(), _Renderer_cachedInitials = new WeakMap(), _Renderer_instances = new WeakSet(), _Renderer_applyFlip = function _Renderer_applyFlip(body, canvas) {
+    const flip = __classPrivateFieldGet(this, _Renderer_resolver, "f").flip();
     if (flip === 'none') {
         return body;
     }
@@ -89,7 +98,7 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
     }
     return `<g transform="${transform}">${body}</g>`;
 }, _Renderer_applyScale = function _Renderer_applyScale(body, canvas) {
-    const scale = __classPrivateFieldGet(this, _Renderer_options, "f").scale();
+    const scale = __classPrivateFieldGet(this, _Renderer_resolver, "f").scale();
     if (scale === 1) {
         return body;
     }
@@ -97,17 +106,14 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
     const cy = canvas.height() / 2;
     return `<g transform="translate(${cx}, ${cy}) scale(${scale}) translate(${-cx}, ${-cy})">${body}</g>`;
 }, _Renderer_applyBorderRadius = function _Renderer_applyBorderRadius(body, canvas) {
-    const radius = __classPrivateFieldGet(this, _Renderer_options, "f").borderRadius();
-    if (radius === 0) {
-        return body;
-    }
+    const radius = __classPrivateFieldGet(this, _Renderer_resolver, "f").borderRadius();
     const id = `clip-${__classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_hashSeed).call(this)}`;
     const rx = (radius / 100) * canvas.width();
     const ry = (radius / 100) * canvas.height();
     __classPrivateFieldGet(this, _Renderer_defs, "f").set(id, `<clipPath id="${id}"><rect width="${canvas.width()}" height="${canvas.height()}" rx="${rx}" ry="${ry}"/></clipPath>`);
     return `<g clip-path="url(#${id})">${body}</g>`;
 }, _Renderer_applyRotate = function _Renderer_applyRotate(body, canvas) {
-    const rotate = __classPrivateFieldGet(this, _Renderer_options, "f").rotate();
+    const rotate = __classPrivateFieldGet(this, _Renderer_resolver, "f").rotate();
     if (rotate === 0) {
         return body;
     }
@@ -115,8 +121,8 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
     const cy = canvas.height() / 2;
     return `<g transform="rotate(${rotate}, ${cx}, ${cy})">${body}</g>`;
 }, _Renderer_applyTranslate = function _Renderer_applyTranslate(body, canvas) {
-    const tx = __classPrivateFieldGet(this, _Renderer_options, "f").translateX();
-    const ty = __classPrivateFieldGet(this, _Renderer_options, "f").translateY();
+    const tx = __classPrivateFieldGet(this, _Renderer_resolver, "f").translateX();
+    const ty = __classPrivateFieldGet(this, _Renderer_resolver, "f").translateY();
     if (tx === 0 && ty === 0) {
         return body;
     }
@@ -124,15 +130,12 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
     const y = (ty / 100) * canvas.height();
     return `<g transform="translate(${x}, ${y})">${body}</g>`;
 }, _Renderer_renderBackground = function _Renderer_renderBackground(canvas) {
-    const colors = __classPrivateFieldGet(this, _Renderer_options, "f").color('background');
+    const colors = __classPrivateFieldGet(this, _Renderer_resolver, "f").color('background');
     if (colors.length === 0) {
         return '';
     }
     return `<rect width="${canvas.width()}" height="${canvas.height()}" fill="${Xml.escape(__classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveColorReference).call(this, 'background'))}"/>`;
 }, _Renderer_randomizeIds = function _Renderer_randomizeIds(svg) {
-    // Uses Math.random() intentionally — a PRNG-based suffix would
-    // produce the same ID for the same seed, preventing two identical
-    // avatars from coexisting in the same document.
     const suffix = Math.floor(Math.random() * 0xffffff)
         .toString(16)
         .padStart(6, '0');
@@ -183,15 +186,15 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
     const value = element.value();
     return value !== undefined ? Xml.escape(__classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveValue).call(this, value)) : '';
 }, _Renderer_renderComponentElement = function _Renderer_renderComponentElement(element) {
-    const value = element.value();
-    if (typeof value !== 'string') {
+    const componentName = element.name();
+    if (typeof componentName !== 'string') {
         return '';
     }
-    const variantName = __classPrivateFieldGet(this, _Renderer_options, "f").variant(value);
+    const variantName = __classPrivateFieldGet(this, _Renderer_resolver, "f").variant(componentName);
     if (!variantName) {
         return '';
     }
-    const component = __classPrivateFieldGet(this, _Renderer_style, "f").components().get(value);
+    const component = __classPrivateFieldGet(this, _Renderer_style, "f").components().get(componentName);
     if (!component) {
         return '';
     }
@@ -199,29 +202,33 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
     if (!variant) {
         return '';
     }
-    const body = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_renderElements).call(this, variant.elements());
-    const transforms = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_buildTransforms).call(this, value);
-    if (transforms.length === 0) {
-        return body;
+    const id = `${component.sourceName()}-${variantName}-${__classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_hashSeed).call(this)}`;
+    if (!__classPrivateFieldGet(this, _Renderer_defs, "f").has(id)) {
+        const body = __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_renderElements).call(this, variant.elements());
+        __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}"/>`;
+}, _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) {
+        return [];
     }
-    return `<g transform="${transforms.join(' ')}">${body}</g>`;
-}, _Renderer_buildTransforms = function _Renderer_buildTransforms(componentName) {
     const transforms = [];
-    const translateX = __classPrivateFieldGet(this, _Renderer_options, "f").translateX(componentName);
-    const translateY = __classPrivateFieldGet(this, _Renderer_options, "f").translateY(componentName);
-    const rotate = __classPrivateFieldGet(this, _Renderer_options, "f").rotate(componentName);
+    const cx = component.width() / 2;
+    const cy = component.height() / 2;
     if (translateX !== 0 || translateY !== 0) {
-        transforms.push(`translate(${translateX}, ${translateY})`);
+        const x = Math.round((translateX / 100) * component.width() * 10000) / 10000;
+        const y = Math.round((translateY / 100) * component.height() * 10000) / 10000;
+        transforms.push(`translate(${x}, ${y})`);
     }
     if (rotate !== 0) {
-        const component = __classPrivateFieldGet(this, _Renderer_style, "f").components().get(componentName);
-        if (!component) {
-            return transforms;
-        }
-        const cx = component.width() / 2;
-        const cy = component.height() / 2;
         transforms.push(`rotate(${rotate}, ${cx}, ${cy})`);
     }
+    if (scale !== 1) {
+        transforms.push(`translate(${cx}, ${cy}) scale(${scale}) translate(${-cx}, ${-cy})`);
+    }
     return transforms;
 }, _Renderer_renderAttributes = function _Renderer_renderAttributes(attributes) {
     if (!attributes) {
@@ -243,19 +250,18 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
         return value;
     }
     if (value.type === 'color') {
-        return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveColorReference).call(this, value.value);
+        return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveColorReference).call(this, value.name);
     }
-    return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveVariable).call(this, value.value);
+    return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveVariable).call(this, value.name);
 }, _Renderer_resolveColorReference = function _Renderer_resolveColorReference(name) {
-    const colors = __classPrivateFieldGet(this, _Renderer_options, "f").color(name);
-    const fill = __classPrivateFieldGet(this, _Renderer_options, "f").colorFill(name);
+    const colors = __classPrivateFieldGet(this, _Renderer_resolver, "f").color(name);
+    const fill = __classPrivateFieldGet(this, _Renderer_resolver, "f").colorFill(name);
     if (fill === 'solid' || colors.length <= 1) {
         return colors[0] ?? 'none';
     }
-    return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_buildGradientDef).call(this, name, colors);
-}, _Renderer_buildGradientDef = function _Renderer_buildGradientDef(name, colors) {
-    const fill = __classPrivateFieldGet(this, _Renderer_options, "f").colorFill(name);
-    const rotation = __classPrivateFieldGet(this, _Renderer_options, "f").colorAngle(name);
+    return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_buildGradientDef).call(this, name, colors, fill);
+}, _Renderer_buildGradientDef = function _Renderer_buildGradientDef(name, colors, fill) {
+    const rotation = __classPrivateFieldGet(this, _Renderer_resolver, "f").colorAngle(name);
     const id = `${name}-color-${__classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_hashSeed).call(this)}`;
     const tag = fill === 'linear' ? 'linearGradient' : 'radialGradient';
     const rotateAttr = rotation !== 0
@@ -272,7 +278,7 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
         return value;
     }
     if (value.type === 'variable') {
-        return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveVariable).call(this, value.value);
+        return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_resolveVariable).call(this, value.name);
     }
     return '';
 }, _Renderer_resolveVariable = function _Renderer_resolveVariable(name) {
@@ -282,12 +288,12 @@ _Renderer_style = new WeakMap(), _Renderer_options = new WeakMap(), _Renderer_de
         case 'initials':
             return __classPrivateFieldGet(this, _Renderer_instances, "m", _Renderer_initials).call(this);
         case 'fontWeight':
-            return String(__classPrivateFieldGet(this, _Renderer_options, "f").fontWeight());
+            return String(__classPrivateFieldGet(this, _Renderer_resolver, "f").fontWeight());
         case 'fontFamily':
-            return __classPrivateFieldGet(this, _Renderer_options, "f").fontFamily();
+            return __classPrivateFieldGet(this, _Renderer_resolver, "f").fontFamily();
     }
 }, _Renderer_initials = function _Renderer_initials() {
-    return (__classPrivateFieldSet(this, _Renderer_cachedInitials, __classPrivateFieldGet(this, _Renderer_cachedInitials, "f") ?? Initials.fromSeed(__classPrivateFieldGet(this, _Renderer_options, "f").seed()), "f"));
+    return (__classPrivateFieldSet(this, _Renderer_cachedInitials, __classPrivateFieldGet(this, _Renderer_cachedInitials, "f") ?? Initials.fromSeed(__classPrivateFieldGet(this, _Renderer_resolver, "f").seed()), "f"));
 }, _Renderer_hashSeed = function _Renderer_hashSeed() {
-    return (__classPrivateFieldSet(this, _Renderer_cachedSeedHash, __classPrivateFieldGet(this, _Renderer_cachedSeedHash, "f") ?? Fnv1a.hex(__classPrivateFieldGet(this, _Renderer_options, "f").seed()), "f"));
+    return (__classPrivateFieldSet(this, _Renderer_cachedSeedHash, __classPrivateFieldGet(this, _Renderer_cachedSeedHash, "f") ?? Fnv1a.hex(__classPrivateFieldGet(this, _Renderer_resolver, "f").seed()), "f"));
 };

package/lib/Resolver.d.ts

@@ -0,0 +1,62 @@
+import { Options } from './Options.js';
+import type { Style } from './Style.js';
+import type { StyleOptionsFlipValue, StyleOptionsColorFillValue, StyleOptions } from './StyleOptions.js';
+/**
+ * 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}.
+ */
+export declare class Resolver<D = unknown> {
+    #private;
+    constructor(style: Style<D>, options: Options<D>);
+    seed(): string;
+    size(): number | undefined;
+    idRandomization(): boolean;
+    title(): string | undefined;
+    flip(): StyleOptionsFlipValue;
+    fontFamily(): string;
+    fontWeight(): number;
+    scale(): number;
+    borderRadius(): number;
+    rotate(): number;
+    translateX(): number;
+    translateY(): number;
+    /**
+     * Selects a variant for the given component. Depending on what was passed
+     * as `${name}Variant` in the input data:
+     *
+     * - `undefined`: PRNG picks from all style variants using their weights.
+     * - `string` or `string[]`: PRNG picks from the given subset (weight 1 each).
+     * - `Record<string, number>`: PRNG picks using the provided weights.
+     *
+     * Only variants that exist in the style definition are considered.
+     */
+    variant(name: string): string | undefined;
+    color(name: string): readonly string[];
+    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}.
+     */
+    componentTransform(name: string): {
+        rotate: number;
+        translateX: number;
+        translateY: number;
+        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} are intentionally not memoized and therefore
+     * do not appear in the snapshot.
+     *
+     * The returned object aliases the internal cache; callers that need
+     * isolation (e.g. {@link Avatar.toJSON}) clone it themselves.
+     */
+    resolved(): StyleOptions<D>;
+}