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

package/lib/Avatar.d.ts

@@ -5,11 +5,27 @@ interface AvatarJson<D = unknown> {
     readonly svg: string;
     readonly options: StyleOptions<UnwrapStyle<D>>;
 }
+/**
+ * Top-level entry point for rendering an avatar from a style and options.
+ *
+ * Construction immediately resolves and renders the SVG; the various
+ * accessor methods return different serializations of that result.
+ */
 export declare class Avatar<D = unknown> {
     #private;
-    constructor(style: D, options?: StyleOptions<UnwrapStyle<D>>);
+    constructor(styleInput: D, optionsInput?: StyleOptions<UnwrapStyle<D>>);
+    /**
+     * Returns the rendered SVG markup.
+     */
     toString(): string;
+    /**
+     * Returns the avatar as a JSON-serializable object containing the SVG and
+     * the fully resolved options used to render it.
+     */
     toJSON(): AvatarJson<D>;
+    /**
+     * Returns the SVG encoded as a `data:image/svg+xml` URI.
+     */
     toDataUri(): string;
 }
 export {};

package/lib/Avatar.js

@@ -12,25 +12,43 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _Avatar_svg, _Avatar_resolvedOptions;
 import { Style } from './Style.js';
 import { Options } from './Options.js';
+import { Resolver } from './Resolver.js';
 import { Renderer } from './Renderer.js';
+/**
+ * Top-level entry point for rendering an avatar from a style and options.
+ *
+ * Construction immediately resolves and renders the SVG; the various
+ * accessor methods return different serializations of that result.
+ */
 export class Avatar {
-    constructor(style, options) {
+    constructor(styleInput, optionsInput) {
         _Avatar_svg.set(this, void 0);
         _Avatar_resolvedOptions.set(this, void 0);
-        const resolvedStyle = style instanceof Style ? style : new Style(style);
-        const resolvedOptions = new Options(resolvedStyle, options ?? {});
-        __classPrivateFieldSet(this, _Avatar_svg, new Renderer(resolvedStyle, resolvedOptions).render(), "f");
-        __classPrivateFieldSet(this, _Avatar_resolvedOptions, resolvedOptions.resolved(), "f");
+        const style = styleInput instanceof Style ? styleInput : new Style(styleInput);
+        const options = new Options(optionsInput);
+        const resolver = new Resolver(style, options);
+        __classPrivateFieldSet(this, _Avatar_svg, new Renderer(style, resolver).render(), "f");
+        __classPrivateFieldSet(this, _Avatar_resolvedOptions, resolver.resolved(), "f");
     }
+    /**
+     * Returns the rendered SVG markup.
+     */
     toString() {
         return __classPrivateFieldGet(this, _Avatar_svg, "f");
     }
+    /**
+     * Returns the avatar as a JSON-serializable object containing the SVG and
+     * the fully resolved options used to render it.
+     */
     toJSON() {
         return {
             svg: __classPrivateFieldGet(this, _Avatar_svg, "f"),
             options: structuredClone(__classPrivateFieldGet(this, _Avatar_resolvedOptions, "f")),
         };
     }
+    /**
+     * Returns the SVG encoded as a `data:image/svg+xml` URI.
+     */
     toDataUri() {
         return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(__classPrivateFieldGet(this, _Avatar_svg, "f"))}`;
     }

package/lib/Error/CircularColorReferenceError.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Thrown when a color in the style definition references itself, directly or
+ * indirectly. The {@link chain} field reproduces the resolution path.
+ */
 export declare class CircularColorReferenceError extends Error {
     readonly chain: readonly string[];
     constructor(chain: readonly string[]);

package/lib/Error/CircularColorReferenceError.js

@@ -1,3 +1,7 @@
+/**
+ * Thrown when a color in the style definition references itself, directly or
+ * indirectly. The {@link chain} field reproduces the resolution path.
+ */
 export class CircularColorReferenceError extends Error {
     constructor(chain) {
         const path = chain.join(' → ');

package/lib/Error/OptionsValidationError.d.ts

@@ -1,5 +1,8 @@
 import { ValidationError } from './ValidationError.js';
 import type { ValidationErrorDetail } from './ValidationError.js';
+/**
+ * Thrown when avatar options fail schema validation.
+ */
 export declare class OptionsValidationError extends ValidationError {
     constructor(details: readonly ValidationErrorDetail[]);
 }

package/lib/Error/OptionsValidationError.js

@@ -1,4 +1,7 @@
 import { ValidationError } from './ValidationError.js';
+/**
+ * Thrown when avatar options fail schema validation.
+ */
 export class OptionsValidationError extends ValidationError {
     constructor(details) {
         super('Invalid options', details);

package/lib/Error/StyleValidationError.d.ts

@@ -1,5 +1,8 @@
 import { ValidationError } from './ValidationError.js';
 import type { ValidationErrorDetail } from './ValidationError.js';
+/**
+ * Thrown when a style definition fails schema validation.
+ */
 export declare class StyleValidationError extends ValidationError {
     constructor(details: readonly ValidationErrorDetail[]);
 }

package/lib/Error/StyleValidationError.js

@@ -1,4 +1,7 @@
 import { ValidationError } from './ValidationError.js';
+/**
+ * Thrown when a style definition fails schema validation.
+ */
 export class StyleValidationError extends ValidationError {
     constructor(details) {
         super('Invalid style definition', details);

package/lib/Error/ValidationError.d.ts

@@ -2,6 +2,10 @@ export interface ValidationErrorDetail {
     readonly message?: string;
     readonly instancePath?: string;
 }
+/**
+ * Base class for schema validation errors. Carries the prefix in `message`
+ * and the per-field failures in {@link details}.
+ */
 export declare class ValidationError extends Error {
     readonly details: readonly ValidationErrorDetail[];
     constructor(prefix: string, details: readonly ValidationErrorDetail[]);

package/lib/Error/ValidationError.js

@@ -1,3 +1,7 @@
+/**
+ * Base class for schema validation errors. Carries the prefix in `message`
+ * and the per-field failures in {@link details}.
+ */
 export class ValidationError extends Error {
     constructor(prefix, details) {
         const parts = [];

package/lib/Options.d.ts

@@ -1,23 +1,44 @@
-import type { Style } from './Style.js';
-import type { StyleOptionsFlipValue, StyleOptionsColorFillValue, StyleOptions } from './StyleOptions.js';
+import type { StyleOptions, StyleOptionsFlipValue, StyleOptionsColorFillValue } from './StyleOptions.js';
+/**
+ * Validates the raw user-supplied options and exposes them through typed
+ * accessors. Each accessor returns the user's input in a normalized form
+ * (always an array for options that accept either a scalar or an array, or
+ * `undefined` when the option is not set), so consumers — chiefly
+ * {@link Resolver} — never have to do their own normalization.
+ *
+ * Resolution against the style definition and the PRNG happens in
+ * {@link Resolver}; this class is purely about reading user input.
+ */
 export declare class Options<D = unknown> {
     #private;
-    constructor(style: Style<D>, data: StyleOptions<D>);
-    seed(): string;
+    constructor(data?: StyleOptions<D>);
+    seed(): string | undefined;
     size(): number | undefined;
-    idRandomization(): boolean;
+    idRandomization(): boolean | undefined;
     title(): string | undefined;
-    flip(): StyleOptionsFlipValue;
-    fontFamily(): string;
-    fontWeight(): number;
-    scale(): number;
-    borderRadius(): number;
-    variant(name: string): string | undefined;
-    color(name: string): readonly string[];
-    colorFill(name: string): StyleOptionsColorFillValue;
-    colorAngle(name: string): number;
-    rotate(name?: string): number;
-    translateX(name?: string): number;
-    translateY(name?: string): number;
-    resolved(): StyleOptions<D>;
+    flip(): readonly StyleOptionsFlipValue[];
+    fontFamily(): readonly string[];
+    fontWeight(): readonly number[];
+    scale(): readonly number[];
+    borderRadius(): readonly number[];
+    rotate(): readonly number[];
+    translateX(): readonly number[];
+    translateY(): readonly number[];
+    /**
+     * Returns the user-set variant constraint for `name`:
+     * - `undefined` when the user did not set `${name}Variant`,
+     * - `string[]` when the user gave a string or string list (each weighted 1),
+     * - `Record<string, number>` when the user gave a weighted map.
+     */
+    componentVariant(name: string): readonly string[] | Readonly<Record<string, number>> | undefined;
+    componentProbability(name: string): number | undefined;
+    /**
+     * Asymmetric on purpose: returns `undefined` (rather than `[]`) when
+     * `${name}Color` is unset so the resolver can fall back to the style
+     * definition's color values.
+     */
+    color(name: string): readonly string[] | undefined;
+    colorFill(name: string): readonly StyleOptionsColorFillValue[];
+    colorAngle(name: string): readonly number[];
+    colorFillStops(name: string): readonly number[];
 }

package/lib/Options.js

@@ -9,204 +9,104 @@ 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_style, _Options_prng, _Options_colorResolving, _Options_result, _Options_numericComponentOption, _Options_probability, _Options_isVisible, _Options_colorFillStops, _Options_resolveColor, _Options_get, _Options_memo, _Options_toArray;
+var _Options_instances, _Options_data, _Options_dynamic, _Options_asArray;
 import { OptionsValidator } from './Validator/OptionsValidator.js';
-import { Prng } from './Prng.js';
-import { Color } from './Utils/Color.js';
-import { CircularColorReferenceError } from './Error/CircularColorReferenceError.js';
+/**
+ * Validates the raw user-supplied options and exposes them through typed
+ * accessors. Each accessor returns the user's input in a normalized form
+ * (always an array for options that accept either a scalar or an array, or
+ * `undefined` when the option is not set), so consumers — chiefly
+ * {@link Resolver} — never have to do their own normalization.
+ *
+ * Resolution against the style definition and the PRNG happens in
+ * {@link Resolver}; this class is purely about reading user input.
+ */
 export class Options {
-    constructor(style, data) {
+    constructor(data = {}) {
         _Options_instances.add(this);
         _Options_data.set(this, void 0);
-        _Options_style.set(this, void 0);
-        _Options_prng.set(this, void 0);
-        _Options_colorResolving.set(this, []);
-        _Options_result.set(this, {});
         OptionsValidator.validate(data);
         __classPrivateFieldSet(this, _Options_data, structuredClone(data), "f");
-        __classPrivateFieldSet(this, _Options_style, style, "f");
-        __classPrivateFieldSet(this, _Options_prng, new Prng(this.seed()), "f");
     }
     seed() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'seed', () => __classPrivateFieldGet(this, _Options_data, "f").seed ?? '');
+        return __classPrivateFieldGet(this, _Options_data, "f").seed;
     }
     size() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'size', () => __classPrivateFieldGet(this, _Options_data, "f").size);
+        return __classPrivateFieldGet(this, _Options_data, "f").size;
     }
     idRandomization() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'idRandomization', () => __classPrivateFieldGet(this, _Options_data, "f").idRandomization ?? false);
+        return __classPrivateFieldGet(this, _Options_data, "f").idRandomization;
     }
     title() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'title', () => __classPrivateFieldGet(this, _Options_data, "f").title);
+        return __classPrivateFieldGet(this, _Options_data, "f").title;
     }
     flip() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'flip', () => __classPrivateFieldGet(this, _Options_prng, "f").pick('flip', __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").flip)) ?? 'none');
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").flip);
     }
     fontFamily() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'fontFamily', () => __classPrivateFieldGet(this, _Options_prng, "f").pick('fontFamily', __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").fontFamily)) ??
-            'system-ui');
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").fontFamily);
     }
     fontWeight() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'fontWeight', () => __classPrivateFieldGet(this, _Options_prng, "f").pick('fontWeight', __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").fontWeight)) ??
-            400);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").fontWeight);
     }
     scale() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'scale', () => __classPrivateFieldGet(this, _Options_prng, "f").float('scale', __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").scale)) ?? 1);
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").scale);
     }
     borderRadius() {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, 'borderRadius', () => __classPrivateFieldGet(this, _Options_prng, "f").float('borderRadius', __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, __classPrivateFieldGet(this, _Options_data, "f").borderRadius)) ?? 0);
-    }
-    // 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) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, `${name}Variant`, () => {
-            if (!__classPrivateFieldGet(this, _Options_instances, "m", _Options_isVisible).call(this, name)) {
-                return undefined;
-            }
-            const component = __classPrivateFieldGet(this, _Options_style, "f").components().get(name);
-            if (!component) {
-                return undefined;
-            }
-            const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, `${name}Variant`);
-            const variants = component.variants();
-            let entries;
-            if (raw === undefined) {
-                entries = Array.from(variants).map(([v, variant]) => [
-                    v,
-                    variant.weight(),
-                ]);
-            }
-            else if (typeof raw === 'string' || Array.isArray(raw)) {
-                entries = __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, raw)
-                    .filter((v) => variants.has(v))
-                    .map((v) => [v, 1]);
-            }
-            else {
-                entries = Object.entries(raw).filter(([v]) => variants.has(v));
-            }
-            return __classPrivateFieldGet(this, _Options_prng, "f").weightedPick(`${name}Variant`, entries);
-        });
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).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);
+    }
+    translateX() {
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).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);
+    }
+    /**
+     * Returns the user-set variant constraint for `name`:
+     * - `undefined` when the user did not set `${name}Variant`,
+     * - `string[]` when the user gave a string or string list (each weighted 1),
+     * - `Record<string, number>` when the user gave a weighted map.
+     */
+    componentVariant(name) {
+        const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}Variant`);
+        if (raw === undefined) {
+            return undefined;
+        }
+        if (typeof raw === 'string' || Array.isArray(raw)) {
+            return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, raw);
+        }
+        return raw;
+    }
+    componentProbability(name) {
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}Probability`);
     }
+    /**
+     * Asymmetric on purpose: returns `undefined` (rather than `[]`) when
+     * `${name}Color` is unset so the resolver can fall back to the style
+     * definition's color values.
+     */
     color(name) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, `${name}Color`, () => __classPrivateFieldGet(this, _Options_instances, "m", _Options_resolveColor).call(this, name));
+        const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}Color`);
+        return raw === undefined
+            ? undefined
+            : __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, raw);
     }
     colorFill(name) {
-        const key = `${name}ColorFill`;
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, key, () => {
-            const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, key);
-            return __classPrivateFieldGet(this, _Options_prng, "f").pick(key, __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, raw)) ?? 'solid';
-        });
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorFill`));
     }
     colorAngle(name) {
-        const key = `${name}ColorAngle`;
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, key, () => {
-            const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, key);
-            return __classPrivateFieldGet(this, _Options_prng, "f").float(key, __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, raw)) ?? 0;
-        });
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorAngle`));
     }
-    rotate(name) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_numericComponentOption).call(this, 'rotate', name, (c) => c.rotate());
-    }
-    translateX(name) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_numericComponentOption).call(this, 'translateX', name, (c) => c.translate().x());
-    }
-    translateY(name) {
-        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_numericComponentOption).call(this, 'translateY', name, (c) => c.translate().y());
-    }
-    resolved() {
-        return structuredClone(__classPrivateFieldGet(this, _Options_result, "f"));
+    colorFillStops(name) {
+        return __classPrivateFieldGet(this, _Options_instances, "m", _Options_asArray).call(this, __classPrivateFieldGet(this, _Options_instances, "m", _Options_dynamic).call(this, `${name}ColorFillStops`));
     }
 }
-_Options_data = new WeakMap(), _Options_style = new WeakMap(), _Options_prng = new WeakMap(), _Options_colorResolving = new WeakMap(), _Options_result = new WeakMap(), _Options_instances = new WeakSet(), _Options_numericComponentOption = function _Options_numericComponentOption(option, name, componentDefault) {
-    const key = name
-        ? `${name}${option.charAt(0).toUpperCase()}${option.slice(1)}`
-        : option;
-    return __classPrivateFieldGet(this, _Options_instances, "m", _Options_memo).call(this, key, () => {
-        const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, key);
-        let values;
-        if (raw === undefined && name) {
-            const component = __classPrivateFieldGet(this, _Options_style, "f").components().get(name);
-            values = component ? componentDefault(component) : [];
-        }
-        else {
-            values = __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, raw);
-        }
-        return __classPrivateFieldGet(this, _Options_prng, "f").float(key, values) ?? 0;
-    });
-}, _Options_probability = function _Options_probability(name) {
-    const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, `${name}Probability`);
-    if (raw !== undefined) {
-        return raw;
-    }
-    return __classPrivateFieldGet(this, _Options_style, "f").components().get(name)?.probability() ?? 100;
-}, _Options_isVisible = function _Options_isVisible(name) {
-    return __classPrivateFieldGet(this, _Options_prng, "f").bool(`${name}Probability`, __classPrivateFieldGet(this, _Options_instances, "m", _Options_probability).call(this, name));
-}, _Options_colorFillStops = function _Options_colorFillStops(name) {
-    const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, `${name}ColorFillStops`);
-    const values = __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, raw);
-    return __classPrivateFieldGet(this, _Options_prng, "f").integer(`${name}ColorFillStops`, values) ?? 2;
-}, _Options_resolveColor = function _Options_resolveColor(name) {
-    const raw = __classPrivateFieldGet(this, _Options_instances, "m", _Options_get).call(this, `${name}Color`);
-    const styleColor = __classPrivateFieldGet(this, _Options_style, "f").colors().get(name);
-    let source;
-    if (raw === undefined) {
-        source = styleColor ? styleColor.values() : [];
-    }
-    else {
-        source = __classPrivateFieldGet(this, _Options_instances, "m", _Options_toArray).call(this, raw);
-    }
-    let candidates = source.map((c) => Color.toHex(c));
-    const fill = this.colorFill(name);
-    const stops = fill === 'solid' ? 1 : __classPrivateFieldGet(this, _Options_instances, "m", _Options_colorFillStops).call(this, name);
-    if (!styleColor) {
-        return __classPrivateFieldGet(this, _Options_prng, "f").shuffle(`${name}Color`, candidates).slice(0, stops);
-    }
-    // Detect circular references (e.g. a.contrastTo = b, b.contrastTo = a)
-    if (__classPrivateFieldGet(this, _Options_colorResolving, "f").includes(name)) {
-        throw new CircularColorReferenceError(__classPrivateFieldGet(this, _Options_colorResolving, "f").concat(name));
-    }
-    __classPrivateFieldGet(this, _Options_colorResolving, "f").push(name);
-    const contrastTo = styleColor.contrastTo();
-    const notEqualTo = styleColor.notEqualTo();
-    try {
-        if (contrastTo) {
-            const refColor = this.color(contrastTo)[0];
-            if (refColor) {
-                candidates = Color.sortByContrast(candidates, refColor);
-            }
-        }
-        if (notEqualTo.length > 0) {
-            const excluded = [];
-            for (const ref of notEqualTo) {
-                for (const color of this.color(ref)) {
-                    excluded.push(color);
-                }
-            }
-            candidates = Color.filterNotEqualTo(candidates, excluded);
-        }
-    }
-    finally {
-        __classPrivateFieldGet(this, _Options_colorResolving, "f").pop();
-    }
-    // Skip shuffle when sorted by contrast to preserve the ordering
-    const ordered = contrastTo
-        ? candidates
-        : __classPrivateFieldGet(this, _Options_prng, "f").shuffle(`${name}Color`, candidates);
-    return ordered.slice(0, stops);
-}, _Options_get = function _Options_get(key) {
+_Options_data = new WeakMap(), _Options_instances = new WeakSet(), _Options_dynamic = function _Options_dynamic(key) {
     return __classPrivateFieldGet(this, _Options_data, "f")[key];
-}, _Options_memo = function _Options_memo(key, compute) {
-    if (key in __classPrivateFieldGet(this, _Options_result, "f")) {
-        return __classPrivateFieldGet(this, _Options_result, "f")[key];
-    }
-    const value = compute();
-    __classPrivateFieldGet(this, _Options_result, "f")[key] = value;
-    return value;
-}, _Options_toArray = function _Options_toArray(value) {
+}, _Options_asArray = function _Options_asArray(value) {
     if (value === undefined) {
         return [];
     }

package/lib/OptionsDescriptor.d.ts

@@ -29,9 +29,17 @@ interface RangeField {
 }
 export type FieldDescriptor = StringField | NumberField | BooleanField | EnumField | ColorField | RangeField;
 export type Descriptor = Record<string, FieldDescriptor>;
+/**
+ * Builds a descriptor of every option a given style accepts. Tooling such as
+ * the editor uses the result to render form controls and validation hints
+ * without having to introspect the style itself.
+ */
 export declare class OptionsDescriptor {
     #private;
     constructor(style: Style);
+    /**
+     * Returns a deep clone of the descriptor, building it lazily on first call.
+     */
     toJSON(): Descriptor;
 }
 export {};

package/lib/OptionsDescriptor.js

@@ -10,6 +10,11 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _OptionsDescriptor_instances, _a, _OptionsDescriptor_rotateRange, _OptionsDescriptor_translateRange, _OptionsDescriptor_descriptor, _OptionsDescriptor_style, _OptionsDescriptor_build;
+/**
+ * Builds a descriptor of every option a given style accepts. Tooling such as
+ * the editor uses the result to render form controls and validation hints
+ * without having to introspect the style itself.
+ */
 export class OptionsDescriptor {
     constructor(style) {
         _OptionsDescriptor_instances.add(this);
@@ -17,6 +22,9 @@ export class OptionsDescriptor {
         _OptionsDescriptor_style.set(this, void 0);
         __classPrivateFieldSet(this, _OptionsDescriptor_style, style, "f");
     }
+    /**
+     * Returns a deep clone of the descriptor, building it lazily on first call.
+     */
     toJSON() {
         __classPrivateFieldSet(this, _OptionsDescriptor_descriptor, __classPrivateFieldGet(this, _OptionsDescriptor_descriptor, "f") ?? __classPrivateFieldGet(this, _OptionsDescriptor_instances, "m", _OptionsDescriptor_build).call(this), "f");
         return structuredClone(__classPrivateFieldGet(this, _OptionsDescriptor_descriptor, "f"));
@@ -25,7 +33,7 @@ export class OptionsDescriptor {
 _a = OptionsDescriptor, _OptionsDescriptor_descriptor = new WeakMap(), _OptionsDescriptor_style = new WeakMap(), _OptionsDescriptor_instances = new WeakSet(), _OptionsDescriptor_build = function _OptionsDescriptor_build() {
     const result = {
         seed: { type: 'string' },
-        size: { type: 'number', min: 1 },
+        size: { type: 'number', min: 1, max: 4096 },
         idRandomization: { type: 'boolean' },
         title: { type: 'string' },
         flip: {
@@ -35,13 +43,16 @@ _a = OptionsDescriptor, _OptionsDescriptor_descriptor = new WeakMap(), _OptionsD
         },
         fontFamily: { type: 'string', list: true },
         fontWeight: { type: 'number', min: 1, max: 1000, list: true },
-        scale: { type: 'range', min: 0 },
+        scale: { type: 'range', min: 0, max: 10 },
         borderRadius: { type: 'range', min: 0, max: 50 },
         rotate: __classPrivateFieldGet(_a, _a, "f", _OptionsDescriptor_rotateRange),
         translateX: __classPrivateFieldGet(_a, _a, "f", _OptionsDescriptor_translateRange),
         translateY: __classPrivateFieldGet(_a, _a, "f", _OptionsDescriptor_translateRange),
     };
     for (const [name, component] of __classPrivateFieldGet(this, _OptionsDescriptor_style, "f").components()) {
+        if (component.extendsName() !== undefined) {
+            continue;
+        }
         const variants = Array.from(component.variants().keys()).sort();
         result[`${name}Variant`] = {
             type: 'enum',
@@ -50,9 +61,6 @@ _a = OptionsDescriptor, _OptionsDescriptor_descriptor = new WeakMap(), _OptionsD
             weighted: true,
         };
         result[`${name}Probability`] = { type: 'number', min: 0, max: 100 };
-        result[`${name}Rotate`] = __classPrivateFieldGet(_a, _a, "f", _OptionsDescriptor_rotateRange);
-        result[`${name}TranslateX`] = __classPrivateFieldGet(_a, _a, "f", _OptionsDescriptor_translateRange);
-        result[`${name}TranslateY`] = __classPrivateFieldGet(_a, _a, "f", _OptionsDescriptor_translateRange);
     }
     for (const name of [...__classPrivateFieldGet(this, _OptionsDescriptor_style, "f").colors().keys(), 'background']) {
         result[`${name}Color`] = { type: 'color', list: true };
@@ -67,4 +75,4 @@ _a = OptionsDescriptor, _OptionsDescriptor_descriptor = new WeakMap(), _OptionsD
     return result;
 };
 _OptionsDescriptor_rotateRange = { value: { type: 'range', min: -360, max: 360 } };
-_OptionsDescriptor_translateRange = { value: { type: 'range', min: -100, max: 100 } };
+_OptionsDescriptor_translateRange = { value: { type: 'range', min: -1000, max: 1000 } };

package/lib/Prng/Fnv1a.d.ts

@@ -1,4 +1,18 @@
+/**
+ * FNV-1a 32-bit hash.
+ *
+ * Offset basis: 0x811c9dc5, prime: 0x01000193.
+ *
+ * @see https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function
+ */
 export declare class Fnv1a {
+    /**
+     * Returns the unsigned 32-bit FNV-1a hash of `input`. UTF-16 code units
+     * are hashed directly so the result is identical across language ports.
+     */
     static hash(input: string): number;
+    /**
+     * Returns the FNV-1a hash of `input` as an 8-character lowercase hex string.
+     */
     static hex(input: string): string;
 }

package/lib/Prng/Fnv1a.js

@@ -1,7 +1,15 @@
-// FNV-1a 32-bit hash.
-// Offset basis: 0x811c9dc5, prime: 0x01000193.
-// https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function
+/**
+ * FNV-1a 32-bit hash.
+ *
+ * Offset basis: 0x811c9dc5, prime: 0x01000193.
+ *
+ * @see https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function
+ */
 export class Fnv1a {
+    /**
+     * Returns the unsigned 32-bit FNV-1a hash of `input`. UTF-16 code units
+     * are hashed directly so the result is identical across language ports.
+     */
     static hash(input) {
         let hash = 0x811c9dc5;
         for (let i = 0; i < input.length; i++) {
@@ -10,6 +18,9 @@ export class Fnv1a {
         }
         return hash >>> 0;
     }
+    /**
+     * Returns the FNV-1a hash of `input` as an 8-character lowercase hex string.
+     */
     static hex(input) {
         return Fnv1a.hash(input).toString(16).padStart(8, '0');
     }