@dicebear/schema 0.13.0 → 0.14.0

package/README.md

@@ -66,8 +66,8 @@ composer require dicebear/schema
 The schemas are available directly via CDN — no installation required. We recommend using a specific version to ensure stability:
 
 ```
-https://cdn.hopjs.net/npm/@dicebear/schema@0.13.0/dist/definition.min.json
-https://cdn.hopjs.net/npm/@dicebear/schema@0.13.0/dist/options.min.json
+https://cdn.hopjs.net/npm/@dicebear/schema@0.14.0/dist/definition.min.json
+https://cdn.hopjs.net/npm/@dicebear/schema@0.14.0/dist/options.min.json
 ```
 
 ## Usage

package/dist/definition.min.json

@@ -1 +1 @@
-{"$id":"https://cdn.hopjs.net/npm/@dicebear/schema@0.13.0/dist/definition.min.json","$schema":"http://json-schema.org/draft-07/schema#","definitions":{"camelCaseName":{"description":"A camelCase identifier used for named things defined in the definition (colors, components, variants). Must start with a lowercase letter and may contain letters and digits.","type":"string","pattern":"^[a-z][a-zA-Z0-9]*$","maxLength":64},"colorName":{"description":"A reference to a color palette defined in the top-level `colors` section.","allOf":[{"$ref":"#/definitions/camelCaseName"}]},"componentName":{"description":"A reference to a component defined in the top-level `components` section.","allOf":[{"$ref":"#/definitions/camelCaseName"}]},"translateValue":{"description":"A translation value expressed as a percentage of the component's width (for `x`) or height (for `y`). A single value fixes the translation; two values define a range the PRNG picks from.","type":"array","items":{"type":"number","minimum":-1000,"maximum":1000},"minItems":1,"maxItems":2},"hexColor":{"description":"A hex color with leading `#`, in 3, 4, 6, or 8 digit form.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$","maxLength":9},"colorValue":{"description":"A color value for `fill`, `stroke`, `stop-color`, and other color attributes. Either a plain string (any CSS color format — named color, hex, `rgb()`, `oklch()`, `color-mix()`, local paint server reference `url(#id)`, etc.) or an object referencing a named color palette defined in the top-level `colors` section. CSS color syntax is not validated; invalid colors are the browser's problem.","anyOf":[{"$ref":"#/definitions/attributeString"},{"description":"A reference to a named color palette. At render time, the PRNG selects a color value from the referenced palette.","type":"object","properties":{"type":{"const":"color"},"name":{"description":"The name of the color palette to reference.","$ref":"#/definitions/colorName"}},"required":["type","name"],"additionalProperties":false}]},"safeUrl":{"description":"A URL restricted to HTTP and HTTPS protocols.","type":"string","pattern":"^https?://","maxLength":2048},"filteredString":{"description":"Base definition for the filtered-string family (`attributeString`, `cssString`). Blocks a shared set of known-dangerous patterns: external `url(...)` references (local `url(#id)` is allowed), `expression()`, `behavior:`, `-moz-binding`, `javascript:` / `vbscript:` URI schemes, and backslash escape sequences. This is not a general CSS sanitizer — it is a defense-in-depth injection filter, so substring matches of blocked tokens will reject otherwise-harmless strings (e.g. a plain text containing the literal word `javascript:`). The `maxLength` here acts as an absolute ceiling for all derivatives; callers narrow it further.","type":"string","maxLength":16384,"not":{"type":"string","anyOf":[{"type":"string","pattern":"[uU][rR][lL]\\s*\\(\\s*[^#)\\s]"},{"type":"string","pattern":"[eE][xX][pP][rR][eE][sS][sS][iI][oO][nN]\\s*\\("},{"type":"string","pattern":"[bB][eE][hH][aA][vV][iI][oO][rR]\\s*:"},{"type":"string","pattern":"-[mM][oO][zZ]-[bB][iI][nN][dD][iI][nN][gG]"},{"type":"string","pattern":"[jJ][aA][vV][aA][sS][cC][rR][iI][pP][tT]\\s*:"},{"type":"string","pattern":"[vV][bB][sS][cC][rR][iI][pP][tT]\\s*:"},{"type":"string","pattern":"\\\\"}]}},"attributeString":{"description":"The default value type for generic SVG attribute values — transform lists, numeric values, keywords, and so on. No syntactic validation; only the common `filteredString` injection filter applies.","type":"string","allOf":[{"$ref":"#/definitions/filteredString"}],"maxLength":1024},"pathDataString":{"description":"Used for the `d` attribute of `<path>`. Same filter as `attributeString`, but with a much larger length budget to accommodate complex path geometry.","type":"string","allOf":[{"$ref":"#/definitions/filteredString"}],"maxLength":16384},"cssString":{"description":"Used for inline `style` attribute content and `<style>` element bodies. `@`-rules (`@import`, `@font-face`, `@keyframes`, etc.) are rejected in addition to the common `filteredString` injection filter. This is not a general CSS sanitizer.","type":"string","allOf":[{"$ref":"#/definitions/filteredString"}],"maxLength":4096,"not":{"type":"string","pattern":"@"}},"element":{"description":"An SVG node. One of four mutually exclusive forms, discriminated by `type` (and `name` for the `<style>` special case): a text element, a component reference, a `<style>` element, or any other SVG element.","anyOf":[{"$ref":"#/definitions/textElement"},{"$ref":"#/definitions/componentReference"},{"$ref":"#/definitions/styleElement"},{"$ref":"#/definitions/genericElement"}]},"textElement":{"description":"A raw text node. Its `value` becomes the text content rendered into the parent element.","type":"object","properties":{"type":{"const":"text"},"value":{"description":"Either a plain string, or a `variable` reference resolved at render time to the seed's initials.","anyOf":[{"type":"string","maxLength":4096},{"type":"object","properties":{"type":{"const":"variable"},"name":{"enum":["initial","initials"]}},"required":["type","name"],"additionalProperties":false}]}},"required":["type","value"],"additionalProperties":false},"componentReference":{"description":"A reference to a named component defined in the top-level `components` section. At render time, the PRNG selects one of the component's variants.","type":"object","properties":{"type":{"const":"component"},"name":{"$ref":"#/definitions/componentName"}},"required":["type","name"],"additionalProperties":false},"styleElement":{"description":"An SVG `<style>` element. Its CSS content must be provided as `text` children; each child's value is validated as a CSS string with a stricter content policy than generic SVG attribute values.","type":"object","properties":{"type":{"const":"element"},"name":{"const":"style"},"attributes":{"$ref":"#/definitions/attributes"},"children":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"value":{"$ref":"#/definitions/cssString"}},"required":["type","value"],"additionalProperties":false},"maxItems":64}},"required":["type","name"],"additionalProperties":false},"genericElement":{"description":"Any SVG element other than `<style>`, which has its own stricter content policy.","type":"object","properties":{"type":{"const":"element"},"name":{"description":"The SVG tag name. Only a safe subset of SVG elements is permitted; dangerous elements such as `script`, `foreignObject`, or `a` are excluded.","enum":["circle","clipPath","defs","desc","ellipse","feBlend","feColorMatrix","feComponentTransfer","feComposite","feConvolveMatrix","feDiffuseLighting","feDisplacementMap","feDistantLight","feDropShadow","feFlood","feFuncA","feFuncB","feFuncG","feFuncR","feGaussianBlur","feImage","feMerge","feMergeNode","feMorphology","feOffset","fePointLight","feSpecularLighting","feSpotLight","feTile","feTurbulence","filter","g","image","line","linearGradient","marker","mask","metadata","mpath","path","pattern","polygon","polyline","radialGradient","rect","stop","svg","switch","symbol","text","textPath","title","tspan","use","view"]},"attributes":{"$ref":"#/definitions/attributes"},"children":{"type":"array","items":{"$ref":"#/definitions/element"},"maxItems":1024}},"required":["type","name"],"additionalProperties":false},"attributes":{"description":"A map of allowed SVG presentation attributes. Only a safe subset is permitted; event handlers (e.g. `onclick`) and namespace attributes (e.g. `xlink:href`) are not allowed.","type":"object","properties":{"alignment-baseline":{"$ref":"#/definitions/attributeString"},"amplitude":{"$ref":"#/definitions/attributeString"},"azimuth":{"$ref":"#/definitions/attributeString"},"baseFrequency":{"$ref":"#/definitions/attributeString"},"baseline-shift":{"$ref":"#/definitions/attributeString"},"bias":{"$ref":"#/definitions/attributeString"},"class":{"$ref":"#/definitions/attributeString"},"clipPathUnits":{"$ref":"#/definitions/attributeString"},"clip-path":{"$ref":"#/definitions/attributeString"},"clip-rule":{"$ref":"#/definitions/attributeString"},"color":{"$ref":"#/definitions/colorValue"},"color-interpolation":{"$ref":"#/definitions/attributeString"},"color-interpolation-filters":{"$ref":"#/definitions/attributeString"},"crossorigin":{"$ref":"#/definitions/attributeString"},"cx":{"$ref":"#/definitions/attributeString"},"cy":{"$ref":"#/definitions/attributeString"},"d":{"$ref":"#/definitions/pathDataString"},"decoding":{"$ref":"#/definitions/attributeString"},"diffuseConstant":{"$ref":"#/definitions/attributeString"},"direction":{"$ref":"#/definitions/attributeString"},"display":{"$ref":"#/definitions/attributeString"},"divisor":{"$ref":"#/definitions/attributeString"},"dx":{"$ref":"#/definitions/attributeString"},"dy":{"$ref":"#/definitions/attributeString"},"edgeMode":{"$ref":"#/definitions/attributeString"},"elevation":{"$ref":"#/definitions/attributeString"},"exponent":{"$ref":"#/definitions/attributeString"},"fill":{"$ref":"#/definitions/colorValue"},"fill-opacity":{"$ref":"#/definitions/attributeString"},"fill-rule":{"$ref":"#/definitions/attributeString"},"filter":{"$ref":"#/definitions/attributeString"},"filterUnits":{"$ref":"#/definitions/attributeString"},"flood-color":{"$ref":"#/definitions/colorValue"},"flood-opacity":{"$ref":"#/definitions/attributeString"},"font-family":{"anyOf":[{"$ref":"#/definitions/attributeString"},{"type":"object","properties":{"type":{"const":"variable"},"name":{"const":"fontFamily"}},"required":["type","name"],"additionalProperties":false}]},"font-size":{"$ref":"#/definitions/attributeString"},"font-size-adjust":{"$ref":"#/definitions/attributeString"},"font-style":{"$ref":"#/definitions/attributeString"},"font-variant":{"$ref":"#/definitions/attributeString"},"font-weight":{"anyOf":[{"$ref":"#/definitions/attributeString"},{"type":"object","properties":{"type":{"const":"variable"},"name":{"const":"fontWeight"}},"required":["type","name"],"additionalProperties":false}]},"fx":{"$ref":"#/definitions/attributeString"},"fy":{"$ref":"#/definitions/attributeString"},"gradientTransform":{"$ref":"#/definitions/attributeString"},"gradientUnits":{"$ref":"#/definitions/attributeString"},"height":{"$ref":"#/definitions/attributeString"},"href":{"anyOf":[{"type":"string","pattern":"^#[a-zA-Z_][a-zA-Z0-9_.-]*$","maxLength":128},{"type":"string","pattern":"^data:image/(png|gif|jpeg|webp|avif);base64,[a-zA-Z0-9+/=]+$","maxLength":262144}]},"id":{"$ref":"#/definitions/attributeString"},"image-rendering":{"$ref":"#/definitions/attributeString"},"in":{"$ref":"#/definitions/attributeString"},"in2":{"$ref":"#/definitions/attributeString"},"intercept":{"$ref":"#/definitions/attributeString"},"k1":{"$ref":"#/definitions/attributeString"},"k2":{"$ref":"#/definitions/attributeString"},"k3":{"$ref":"#/definitions/attributeString"},"k4":{"$ref":"#/definitions/attributeString"},"kernelMatrix":{"$ref":"#/definitions/attributeString"},"kernelUnitLength":{"$ref":"#/definitions/attributeString"},"lang":{"$ref":"#/definitions/attributeString"},"lengthAdjust":{"$ref":"#/definitions/attributeString"},"letter-spacing":{"$ref":"#/definitions/attributeString"},"lighting-color":{"$ref":"#/definitions/colorValue"},"marker-end":{"$ref":"#/definitions/attributeString"},"marker-mid":{"$ref":"#/definitions/attributeString"},"marker-start":{"$ref":"#/definitions/attributeString"},"markerHeight":{"$ref":"#/definitions/attributeString"},"markerUnits":{"$ref":"#/definitions/attributeString"},"markerWidth":{"$ref":"#/definitions/attributeString"},"mask":{"$ref":"#/definitions/attributeString"},"maskContentUnits":{"$ref":"#/definitions/attributeString"},"maskUnits":{"$ref":"#/definitions/attributeString"},"media":{"$ref":"#/definitions/attributeString"},"method":{"$ref":"#/definitions/attributeString"},"mode":{"$ref":"#/definitions/attributeString"},"numOctaves":{"$ref":"#/definitions/attributeString"},"offset":{"$ref":"#/definitions/attributeString"},"opacity":{"$ref":"#/definitions/attributeString"},"operator":{"$ref":"#/definitions/attributeString"},"order":{"$ref":"#/definitions/attributeString"},"orient":{"$ref":"#/definitions/attributeString"},"overflow":{"$ref":"#/definitions/attributeString"},"paint-order":{"$ref":"#/definitions/attributeString"},"path":{"$ref":"#/definitions/attributeString"},"pathLength":{"$ref":"#/definitions/attributeString"},"patternContentUnits":{"$ref":"#/definitions/attributeString"},"patternTransform":{"$ref":"#/definitions/attributeString"},"patternUnits":{"$ref":"#/definitions/attributeString"},"points":{"$ref":"#/definitions/attributeString"},"preserveAlpha":{"$ref":"#/definitions/attributeString"},"preserveAspectRatio":{"$ref":"#/definitions/attributeString"},"primitiveUnits":{"$ref":"#/definitions/attributeString"},"r":{"$ref":"#/definitions/attributeString"},"radius":{"$ref":"#/definitions/attributeString"},"refX":{"$ref":"#/definitions/attributeString"},"refY":{"$ref":"#/definitions/attributeString"},"result":{"$ref":"#/definitions/attributeString"},"rx":{"$ref":"#/definitions/attributeString"},"ry":{"$ref":"#/definitions/attributeString"},"scale":{"$ref":"#/definitions/attributeString"},"seed":{"$ref":"#/definitions/attributeString"},"shape-rendering":{"$ref":"#/definitions/attributeString"},"slope":{"$ref":"#/definitions/attributeString"},"specularConstant":{"$ref":"#/definitions/attributeString"},"specularExponent":{"$ref":"#/definitions/attributeString"},"spreadMethod":{"$ref":"#/definitions/attributeString"},"startOffset":{"$ref":"#/definitions/attributeString"},"stdDeviation":{"$ref":"#/definitions/attributeString"},"stitchTiles":{"$ref":"#/definitions/attributeString"},"stop-color":{"$ref":"#/definitions/colorValue"},"stop-opacity":{"$ref":"#/definitions/attributeString"},"stroke":{"$ref":"#/definitions/colorValue"},"stroke-dasharray":{"$ref":"#/definitions/attributeString"},"stroke-dashoffset":{"$ref":"#/definitions/attributeString"},"stroke-linecap":{"$ref":"#/definitions/attributeString"},"stroke-linejoin":{"$ref":"#/definitions/attributeString"},"stroke-miterlimit":{"$ref":"#/definitions/attributeString"},"stroke-opacity":{"$ref":"#/definitions/attributeString"},"stroke-width":{"$ref":"#/definitions/attributeString"},"style":{"$ref":"#/definitions/cssString"},"surfaceScale":{"$ref":"#/definitions/attributeString"},"systemLanguage":{"$ref":"#/definitions/attributeString"},"tabindex":{"$ref":"#/definitions/attributeString"},"tableValues":{"$ref":"#/definitions/attributeString"},"targetX":{"$ref":"#/definitions/attributeString"},"targetY":{"$ref":"#/definitions/attributeString"},"text-anchor":{"$ref":"#/definitions/attributeString"},"text-decoration":{"$ref":"#/definitions/attributeString"},"text-rendering":{"$ref":"#/definitions/attributeString"},"textLength":{"$ref":"#/definitions/attributeString"},"transform":{"$ref":"#/definitions/attributeString"},"transform-origin":{"$ref":"#/definitions/attributeString"},"type":{"$ref":"#/definitions/attributeString"},"values":{"$ref":"#/definitions/attributeString"},"viewBox":{"$ref":"#/definitions/attributeString"},"visibility":{"$ref":"#/definitions/attributeString"},"width":{"$ref":"#/definitions/attributeString"},"word-spacing":{"$ref":"#/definitions/attributeString"},"writing-mode":{"$ref":"#/definitions/attributeString"},"x":{"$ref":"#/definitions/attributeString"},"x1":{"$ref":"#/definitions/attributeString"},"x2":{"$ref":"#/definitions/attributeString"},"xChannelSelector":{"$ref":"#/definitions/attributeString"},"y":{"$ref":"#/definitions/attributeString"},"y1":{"$ref":"#/definitions/attributeString"},"y2":{"$ref":"#/definitions/attributeString"},"yChannelSelector":{"$ref":"#/definitions/attributeString"},"z":{"$ref":"#/definitions/attributeString"}},"additionalProperties":false},"componentProbability":{"description":"The probability, expressed as a percentage, that this component is rendered at all.","type":"number","minimum":0,"maximum":100},"componentRotate":{"description":"A rotation in degrees. A single value fixes the angle; two values define a range the PRNG picks from.","type":"array","items":{"type":"number","minimum":-360,"maximum":360},"minItems":1,"maxItems":2},"componentScale":{"description":"A scale factor around the component's own center. A single value fixes the scale; two values define a range the PRNG picks from. A value of `1` corresponds to the original size.","type":"array","items":{"type":"number","minimum":0,"maximum":10},"minItems":1,"maxItems":2},"componentTranslate":{"description":"A positional translation applied to the component after placement. Values are interpreted as a percentage of the component's size.","type":"object","properties":{"x":{"$ref":"#/definitions/translateValue"},"y":{"$ref":"#/definitions/translateValue"}},"additionalProperties":false},"componentBase":{"description":"A base component definition with its own dimensions and variants. The PRNG selects one variant per render based on the seed.","type":"object","properties":{"width":{"description":"The natural width of the component canvas in pixels.","type":"number","minimum":1},"height":{"description":"The natural height of the component canvas in pixels.","type":"number","minimum":1},"probability":{"$ref":"#/definitions/componentProbability"},"rotate":{"$ref":"#/definitions/componentRotate"},"scale":{"$ref":"#/definitions/componentScale"},"translate":{"$ref":"#/definitions/componentTranslate"},"variants":{"description":"The available visual variants of this component. The PRNG selects one variant per render. Keys must be `camelCaseName` identifiers.","type":"object","propertyNames":{"$ref":"#/definitions/camelCaseName"},"additionalProperties":{"type":"object","properties":{"elements":{"description":"The SVG elements that make up this variant.","type":"array","items":{"$ref":"#/definitions/element"},"maxItems":1024},"weight":{"description":"A weight that influences how likely the PRNG is to select this variant. Higher values make the variant more likely. When omitted, defaults to 1 (equal weighting). A value of 0 means the variant is not selected unless all available variants have a weight of 0.","type":"number","minimum":0,"maximum":1000000}},"required":["elements"],"additionalProperties":false},"maxProperties":512}},"required":["width","height","variants"],"additionalProperties":false},"componentAlias":{"description":"An alias that inherits its dimensions and variants from another component referenced by `extends`. Per-instance overrides for `probability`, `rotate`, `scale`, and `translate` are supported.","type":"object","properties":{"extends":{"description":"The name of an existing, non-alias component in this `components` map.","$ref":"#/definitions/componentName"},"probability":{"$ref":"#/definitions/componentProbability"},"rotate":{"$ref":"#/definitions/componentRotate"},"scale":{"$ref":"#/definitions/componentScale"},"translate":{"$ref":"#/definitions/componentTranslate"}},"required":["extends"],"additionalProperties":false}},"type":"object","properties":{"$id":{"type":"string","maxLength":256},"$schema":{"type":"string","maxLength":256},"$comment":{"type":"string","maxLength":4096},"meta":{"description":"Metadata about the avatar style, such as license information, creator details, and source references.","type":"object","properties":{"license":{"description":"License information for the avatar style.","type":"object","properties":{"name":{"description":"The name of the license, e.g. `CC BY 4.0`.","type":"string","maxLength":128},"url":{"description":"A link to the full license text.","$ref":"#/definitions/safeUrl"},"text":{"description":"The full license text.","type":"string","maxLength":32768}},"additionalProperties":false},"creator":{"description":"Information about the creator of the avatar style.","type":"object","properties":{"name":{"description":"The name of the creator.","type":"string","maxLength":128},"url":{"description":"A link to the creator's website or profile.","$ref":"#/definitions/safeUrl"}},"additionalProperties":false},"source":{"description":"Information about the original source of the artwork.","type":"object","properties":{"name":{"description":"The name of the original source.","type":"string","maxLength":128},"url":{"description":"A link to the original source.","$ref":"#/definitions/safeUrl"}},"additionalProperties":false}},"additionalProperties":false},"attributes":{"description":"Global SVG presentation attributes applied to the root `<svg>` element.","$ref":"#/definitions/attributes"},"canvas":{"description":"The main content of the avatar, defining the SVG structure, canvas dimensions, and element tree.","type":"object","properties":{"elements":{"description":"The list of SVG elements that make up the avatar.","type":"array","items":{"$ref":"#/definitions/element"},"maxItems":1024},"width":{"description":"The natural width of the avatar canvas in pixels.","type":"number","minimum":1},"height":{"description":"The natural height of the avatar canvas in pixels.","type":"number","minimum":1}},"required":["elements","width","height"],"additionalProperties":false},"components":{"description":"Named, reusable SVG components. Each component defines a set of variants that the PRNG can select from at render time, or aliases another component to render an additional, independently-randomized instance of it. Keys must be `camelCaseName` identifiers.","type":"object","propertyNames":{"$ref":"#/definitions/camelCaseName"},"additionalProperties":{"anyOf":[{"$ref":"#/definitions/componentBase"},{"$ref":"#/definitions/componentAlias"}]},"maxProperties":512},"colors":{"description":"Named color palettes used by the avatar. The PRNG selects colors from these groups at render time. Color groups can define constraints such as contrast or exclusion rules. Keys must be `camelCaseName` identifiers.","type":"object","propertyNames":{"$ref":"#/definitions/camelCaseName"},"additionalProperties":{"type":"object","properties":{"values":{"description":"The list of hex color values the PRNG can choose from.","type":"array","items":{"$ref":"#/definitions/hexColor"},"minItems":1,"maxItems":128},"notEqualTo":{"description":"A list of other color names. The selected color value must differ from the color values selected in those colors. The schema does not prevent cycles (e.g. `a` notEqualTo `b` and `b` notEqualTo `a`); renderers resolve palettes in definition order and must reject unsatisfiable configurations at load time.","type":"array","items":{"$ref":"#/definitions/colorName"},"maxItems":64},"contrastTo":{"description":"The name of another color. When specified, the PRNG is not used for selection — instead, the color value with the highest contrast against the selected color value of the referenced color is chosen. The schema does not prevent cycles (e.g. `a` contrastTo `b` and `b` contrastTo `a`); renderers resolve palettes in definition order and must reject unsatisfiable configurations at load time.","$ref":"#/definitions/colorName"}},"required":["values"],"additionalProperties":false},"maxProperties":512}},"required":["canvas"],"additionalProperties":false}
+{"$id":"https://cdn.hopjs.net/npm/@dicebear/schema@0.14.0/dist/definition.min.json","$schema":"http://json-schema.org/draft-07/schema#","definitions":{"camelCaseName":{"description":"A camelCase identifier used for named things defined in the definition (colors, components, variants). Must start with a lowercase letter and may contain letters and digits.","type":"string","pattern":"^[a-z][a-zA-Z0-9]*$","maxLength":64},"colorName":{"description":"A reference to a color palette defined in the top-level `colors` section.","allOf":[{"$ref":"#/definitions/camelCaseName"}]},"componentName":{"description":"A reference to a component defined in the top-level `components` section.","allOf":[{"$ref":"#/definitions/camelCaseName"}]},"translateValue":{"description":"A translation value expressed as a percentage of the component's width (for `x`) or height (for `y`). A single value fixes the translation; two values define a range the PRNG picks from.","type":"array","items":{"type":"number","minimum":-1000,"maximum":1000},"minItems":1,"maxItems":2},"hexColor":{"description":"A hex color with leading `#`, in 3, 4, 6, or 8 digit form.","type":"string","pattern":"^#([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$","maxLength":9},"colorValue":{"description":"A color value for `fill`, `stroke`, `stop-color`, and other color attributes. Either a plain string (any CSS color format — named color, hex, `rgb()`, `oklch()`, `color-mix()`, local paint server reference `url(#id)`, etc.) or an object referencing a named color palette defined in the top-level `colors` section. CSS color syntax is not validated; invalid colors are the browser's problem.","anyOf":[{"$ref":"#/definitions/attributeString"},{"description":"A reference to a named color palette. At render time, the PRNG selects a color value from the referenced palette.","type":"object","properties":{"type":{"const":"color"},"name":{"description":"The name of the color palette to reference.","$ref":"#/definitions/colorName"}},"required":["type","name"],"additionalProperties":false}]},"safeUrl":{"description":"A URL restricted to HTTP and HTTPS protocols.","type":"string","pattern":"^https?://","maxLength":2048},"filteredString":{"description":"Base definition for the filtered-string family (`attributeString`, `cssString`). Blocks a shared set of known-dangerous patterns: external `url(...)` references (local `url(#id)` is allowed), `expression()`, `behavior:`, `-moz-binding`, `javascript:` / `vbscript:` URI schemes, and backslash escape sequences. This is not a general CSS sanitizer — it is a defense-in-depth injection filter, so substring matches of blocked tokens will reject otherwise-harmless strings (e.g. a plain text containing the literal word `javascript:`). The `maxLength` here acts as an absolute ceiling for all derivatives; callers narrow it further.","type":"string","maxLength":16384,"not":{"type":"string","anyOf":[{"type":"string","pattern":"[uU][rR][lL]\\s*\\(\\s*[^#)\\s]"},{"type":"string","pattern":"[eE][xX][pP][rR][eE][sS][sS][iI][oO][nN]\\s*\\("},{"type":"string","pattern":"[bB][eE][hH][aA][vV][iI][oO][rR]\\s*:"},{"type":"string","pattern":"-[mM][oO][zZ]-[bB][iI][nN][dD][iI][nN][gG]"},{"type":"string","pattern":"[jJ][aA][vV][aA][sS][cC][rR][iI][pP][tT]\\s*:"},{"type":"string","pattern":"[vV][bB][sS][cC][rR][iI][pP][tT]\\s*:"},{"type":"string","pattern":"\\\\"}]}},"attributeString":{"description":"The default value type for generic SVG attribute values — transform lists, numeric values, keywords, and so on. No syntactic validation; only the common `filteredString` injection filter applies.","type":"string","allOf":[{"$ref":"#/definitions/filteredString"}],"maxLength":1024},"pathDataString":{"description":"Used for the `d` attribute of `<path>`. Same filter as `attributeString`, but with a much larger length budget to accommodate complex path geometry.","type":"string","allOf":[{"$ref":"#/definitions/filteredString"}],"maxLength":16384},"cssString":{"description":"Used for inline `style` attribute content and `<style>` element bodies. `@`-rules (`@import`, `@font-face`, `@keyframes`, etc.) are rejected in addition to the common `filteredString` injection filter. This is not a general CSS sanitizer.","type":"string","allOf":[{"$ref":"#/definitions/filteredString"}],"maxLength":4096,"not":{"type":"string","pattern":"@"}},"element":{"description":"An SVG node. One of four mutually exclusive forms, discriminated by `type` (and `name` for the `<style>` special case): a text element, a component reference, a `<style>` element, or any other SVG element.","anyOf":[{"$ref":"#/definitions/textElement"},{"$ref":"#/definitions/componentReference"},{"$ref":"#/definitions/styleElement"},{"$ref":"#/definitions/genericElement"}]},"textElement":{"description":"A raw text node. Its `value` becomes the text content rendered into the parent element.","type":"object","properties":{"type":{"const":"text"},"value":{"description":"Either a plain string, or a `variable` reference resolved at render time to the seed's initials.","anyOf":[{"type":"string","maxLength":4096},{"type":"object","properties":{"type":{"const":"variable"},"name":{"enum":["initial","initials"]}},"required":["type","name"],"additionalProperties":false}]}},"required":["type","value"],"additionalProperties":false},"componentReference":{"description":"A reference to a named component defined in the top-level `components` section. At render time, the PRNG selects one of the component's variants.","type":"object","properties":{"type":{"const":"component"},"name":{"$ref":"#/definitions/componentName"}},"required":["type","name"],"additionalProperties":false},"styleElement":{"description":"An SVG `<style>` element. Its CSS content must be provided as `text` children; each child's value is validated as a CSS string with a stricter content policy than generic SVG attribute values.","type":"object","properties":{"type":{"const":"element"},"name":{"const":"style"},"attributes":{"$ref":"#/definitions/attributes"},"children":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"value":{"$ref":"#/definitions/cssString"}},"required":["type","value"],"additionalProperties":false},"maxItems":64}},"required":["type","name"],"additionalProperties":false},"genericElement":{"description":"Any SVG element other than `<style>`, which has its own stricter content policy.","type":"object","properties":{"type":{"const":"element"},"name":{"description":"The SVG tag name. Only a safe subset of SVG elements is permitted; dangerous elements such as `script`, `foreignObject`, or `a` are excluded.","enum":["circle","clipPath","defs","desc","ellipse","feBlend","feColorMatrix","feComponentTransfer","feComposite","feConvolveMatrix","feDiffuseLighting","feDisplacementMap","feDistantLight","feDropShadow","feFlood","feFuncA","feFuncB","feFuncG","feFuncR","feGaussianBlur","feImage","feMerge","feMergeNode","feMorphology","feOffset","fePointLight","feSpecularLighting","feSpotLight","feTile","feTurbulence","filter","g","image","line","linearGradient","marker","mask","metadata","mpath","path","pattern","polygon","polyline","radialGradient","rect","stop","svg","switch","symbol","text","textPath","title","tspan","use","view"]},"attributes":{"$ref":"#/definitions/attributes"},"children":{"type":"array","items":{"$ref":"#/definitions/element"},"maxItems":1024}},"required":["type","name"],"additionalProperties":false},"attributes":{"description":"A map of allowed SVG presentation attributes. Only a safe subset is permitted; event handlers (e.g. `onclick`) and namespace attributes (e.g. `xlink:href`) are not allowed.","type":"object","properties":{"alignment-baseline":{"$ref":"#/definitions/attributeString"},"amplitude":{"$ref":"#/definitions/attributeString"},"azimuth":{"$ref":"#/definitions/attributeString"},"baseFrequency":{"$ref":"#/definitions/attributeString"},"baseline-shift":{"$ref":"#/definitions/attributeString"},"bias":{"$ref":"#/definitions/attributeString"},"class":{"$ref":"#/definitions/attributeString"},"clipPathUnits":{"$ref":"#/definitions/attributeString"},"clip-path":{"$ref":"#/definitions/attributeString"},"clip-rule":{"$ref":"#/definitions/attributeString"},"color":{"$ref":"#/definitions/colorValue"},"color-interpolation":{"$ref":"#/definitions/attributeString"},"color-interpolation-filters":{"$ref":"#/definitions/attributeString"},"crossorigin":{"$ref":"#/definitions/attributeString"},"cx":{"$ref":"#/definitions/attributeString"},"cy":{"$ref":"#/definitions/attributeString"},"d":{"$ref":"#/definitions/pathDataString"},"decoding":{"$ref":"#/definitions/attributeString"},"diffuseConstant":{"$ref":"#/definitions/attributeString"},"direction":{"$ref":"#/definitions/attributeString"},"display":{"$ref":"#/definitions/attributeString"},"divisor":{"$ref":"#/definitions/attributeString"},"dx":{"$ref":"#/definitions/attributeString"},"dy":{"$ref":"#/definitions/attributeString"},"edgeMode":{"$ref":"#/definitions/attributeString"},"elevation":{"$ref":"#/definitions/attributeString"},"exponent":{"$ref":"#/definitions/attributeString"},"fill":{"$ref":"#/definitions/colorValue"},"fill-opacity":{"$ref":"#/definitions/attributeString"},"fill-rule":{"$ref":"#/definitions/attributeString"},"filter":{"$ref":"#/definitions/attributeString"},"filterUnits":{"$ref":"#/definitions/attributeString"},"flood-color":{"$ref":"#/definitions/colorValue"},"flood-opacity":{"$ref":"#/definitions/attributeString"},"font-family":{"anyOf":[{"$ref":"#/definitions/attributeString"},{"type":"object","properties":{"type":{"const":"variable"},"name":{"const":"fontFamily"}},"required":["type","name"],"additionalProperties":false}]},"font-size":{"$ref":"#/definitions/attributeString"},"font-size-adjust":{"$ref":"#/definitions/attributeString"},"font-style":{"$ref":"#/definitions/attributeString"},"font-variant":{"$ref":"#/definitions/attributeString"},"font-weight":{"anyOf":[{"$ref":"#/definitions/attributeString"},{"type":"object","properties":{"type":{"const":"variable"},"name":{"const":"fontWeight"}},"required":["type","name"],"additionalProperties":false}]},"fx":{"$ref":"#/definitions/attributeString"},"fy":{"$ref":"#/definitions/attributeString"},"gradientTransform":{"$ref":"#/definitions/attributeString"},"gradientUnits":{"$ref":"#/definitions/attributeString"},"height":{"$ref":"#/definitions/attributeString"},"href":{"anyOf":[{"type":"string","pattern":"^#[a-zA-Z_][a-zA-Z0-9_.-]*$","maxLength":128},{"type":"string","pattern":"^data:image/(png|gif|jpeg|webp|avif);base64,[a-zA-Z0-9+/=]+$","maxLength":262144}]},"id":{"$ref":"#/definitions/attributeString"},"image-rendering":{"$ref":"#/definitions/attributeString"},"in":{"$ref":"#/definitions/attributeString"},"in2":{"$ref":"#/definitions/attributeString"},"intercept":{"$ref":"#/definitions/attributeString"},"k1":{"$ref":"#/definitions/attributeString"},"k2":{"$ref":"#/definitions/attributeString"},"k3":{"$ref":"#/definitions/attributeString"},"k4":{"$ref":"#/definitions/attributeString"},"kernelMatrix":{"$ref":"#/definitions/attributeString"},"kernelUnitLength":{"$ref":"#/definitions/attributeString"},"lang":{"$ref":"#/definitions/attributeString"},"lengthAdjust":{"$ref":"#/definitions/attributeString"},"letter-spacing":{"$ref":"#/definitions/attributeString"},"lighting-color":{"$ref":"#/definitions/colorValue"},"marker-end":{"$ref":"#/definitions/attributeString"},"marker-mid":{"$ref":"#/definitions/attributeString"},"marker-start":{"$ref":"#/definitions/attributeString"},"markerHeight":{"$ref":"#/definitions/attributeString"},"markerUnits":{"$ref":"#/definitions/attributeString"},"markerWidth":{"$ref":"#/definitions/attributeString"},"mask":{"$ref":"#/definitions/attributeString"},"maskContentUnits":{"$ref":"#/definitions/attributeString"},"maskUnits":{"$ref":"#/definitions/attributeString"},"media":{"$ref":"#/definitions/attributeString"},"method":{"$ref":"#/definitions/attributeString"},"mode":{"$ref":"#/definitions/attributeString"},"numOctaves":{"$ref":"#/definitions/attributeString"},"offset":{"$ref":"#/definitions/attributeString"},"opacity":{"$ref":"#/definitions/attributeString"},"operator":{"$ref":"#/definitions/attributeString"},"order":{"$ref":"#/definitions/attributeString"},"orient":{"$ref":"#/definitions/attributeString"},"overflow":{"$ref":"#/definitions/attributeString"},"paint-order":{"$ref":"#/definitions/attributeString"},"path":{"$ref":"#/definitions/attributeString"},"pathLength":{"$ref":"#/definitions/attributeString"},"patternContentUnits":{"$ref":"#/definitions/attributeString"},"patternTransform":{"$ref":"#/definitions/attributeString"},"patternUnits":{"$ref":"#/definitions/attributeString"},"points":{"$ref":"#/definitions/attributeString"},"preserveAlpha":{"$ref":"#/definitions/attributeString"},"preserveAspectRatio":{"$ref":"#/definitions/attributeString"},"primitiveUnits":{"$ref":"#/definitions/attributeString"},"r":{"$ref":"#/definitions/attributeString"},"radius":{"$ref":"#/definitions/attributeString"},"refX":{"$ref":"#/definitions/attributeString"},"refY":{"$ref":"#/definitions/attributeString"},"result":{"$ref":"#/definitions/attributeString"},"rx":{"$ref":"#/definitions/attributeString"},"ry":{"$ref":"#/definitions/attributeString"},"scale":{"$ref":"#/definitions/attributeString"},"seed":{"$ref":"#/definitions/attributeString"},"shape-rendering":{"$ref":"#/definitions/attributeString"},"slope":{"$ref":"#/definitions/attributeString"},"specularConstant":{"$ref":"#/definitions/attributeString"},"specularExponent":{"$ref":"#/definitions/attributeString"},"spreadMethod":{"$ref":"#/definitions/attributeString"},"startOffset":{"$ref":"#/definitions/attributeString"},"stdDeviation":{"$ref":"#/definitions/attributeString"},"stitchTiles":{"$ref":"#/definitions/attributeString"},"stop-color":{"$ref":"#/definitions/colorValue"},"stop-opacity":{"$ref":"#/definitions/attributeString"},"stroke":{"$ref":"#/definitions/colorValue"},"stroke-dasharray":{"$ref":"#/definitions/attributeString"},"stroke-dashoffset":{"$ref":"#/definitions/attributeString"},"stroke-linecap":{"$ref":"#/definitions/attributeString"},"stroke-linejoin":{"$ref":"#/definitions/attributeString"},"stroke-miterlimit":{"$ref":"#/definitions/attributeString"},"stroke-opacity":{"$ref":"#/definitions/attributeString"},"stroke-width":{"$ref":"#/definitions/attributeString"},"style":{"$ref":"#/definitions/cssString"},"surfaceScale":{"$ref":"#/definitions/attributeString"},"systemLanguage":{"$ref":"#/definitions/attributeString"},"tabindex":{"$ref":"#/definitions/attributeString"},"tableValues":{"$ref":"#/definitions/attributeString"},"targetX":{"$ref":"#/definitions/attributeString"},"targetY":{"$ref":"#/definitions/attributeString"},"text-anchor":{"$ref":"#/definitions/attributeString"},"text-decoration":{"$ref":"#/definitions/attributeString"},"text-rendering":{"$ref":"#/definitions/attributeString"},"textLength":{"$ref":"#/definitions/attributeString"},"transform":{"$ref":"#/definitions/attributeString"},"transform-origin":{"$ref":"#/definitions/attributeString"},"type":{"$ref":"#/definitions/attributeString"},"values":{"$ref":"#/definitions/attributeString"},"viewBox":{"$ref":"#/definitions/attributeString"},"visibility":{"$ref":"#/definitions/attributeString"},"width":{"$ref":"#/definitions/attributeString"},"word-spacing":{"$ref":"#/definitions/attributeString"},"writing-mode":{"$ref":"#/definitions/attributeString"},"x":{"$ref":"#/definitions/attributeString"},"x1":{"$ref":"#/definitions/attributeString"},"x2":{"$ref":"#/definitions/attributeString"},"xChannelSelector":{"$ref":"#/definitions/attributeString"},"y":{"$ref":"#/definitions/attributeString"},"y1":{"$ref":"#/definitions/attributeString"},"y2":{"$ref":"#/definitions/attributeString"},"yChannelSelector":{"$ref":"#/definitions/attributeString"},"z":{"$ref":"#/definitions/attributeString"}},"additionalProperties":false},"componentProbability":{"description":"The probability, expressed as a percentage, that this component is rendered at all.","type":"number","minimum":0,"maximum":100},"componentRotate":{"description":"A rotation in degrees. A single value fixes the angle; two values define a range the PRNG picks from.","type":"array","items":{"type":"number","minimum":-360,"maximum":360},"minItems":1,"maxItems":2},"componentScale":{"description":"A scale factor around the component's own center. A single value fixes the scale; two values define a range the PRNG picks from. A value of `1` corresponds to the original size.","type":"array","items":{"type":"number","minimum":0,"maximum":10},"minItems":1,"maxItems":2},"componentTranslate":{"description":"A positional translation applied to the component after placement. Values are interpreted as a percentage of the component's size.","type":"object","properties":{"x":{"$ref":"#/definitions/translateValue"},"y":{"$ref":"#/definitions/translateValue"}},"additionalProperties":false},"componentBase":{"description":"A base component definition with its own dimensions and variants. The PRNG selects one variant per render based on the seed.","type":"object","properties":{"width":{"description":"The natural width of the component canvas in pixels.","type":"number","minimum":1},"height":{"description":"The natural height of the component canvas in pixels.","type":"number","minimum":1},"probability":{"$ref":"#/definitions/componentProbability"},"rotate":{"$ref":"#/definitions/componentRotate"},"scale":{"$ref":"#/definitions/componentScale"},"translate":{"$ref":"#/definitions/componentTranslate"},"variants":{"description":"The available visual variants of this component. The PRNG selects one variant per render. Keys must be `camelCaseName` identifiers.","type":"object","propertyNames":{"$ref":"#/definitions/camelCaseName"},"additionalProperties":{"type":"object","properties":{"elements":{"description":"The SVG elements that make up this variant.","type":"array","items":{"$ref":"#/definitions/element"},"maxItems":1024},"weight":{"description":"A weight that influences how likely the PRNG is to select this variant. Higher values make the variant more likely. When omitted, defaults to 1 (equal weighting). A value of 0 means the variant is not selected unless all available variants have a weight of 0.","type":"number","minimum":0,"maximum":1000000}},"required":["elements"],"additionalProperties":false},"maxProperties":512}},"required":["width","height","variants"],"additionalProperties":false},"componentAlias":{"description":"An alias that inherits its dimensions, variants, and transforms from another component referenced by `extends`. Aliases have no per-instance overrides — they are pure references.","type":"object","properties":{"extends":{"description":"The name of an existing, non-alias component in this `components` map.","$ref":"#/definitions/componentName"}},"required":["extends"],"additionalProperties":false}},"type":"object","properties":{"$id":{"type":"string","maxLength":256},"$schema":{"type":"string","maxLength":256},"$comment":{"type":"string","maxLength":4096},"meta":{"description":"Metadata about the avatar style, such as license information, creator details, and source references.","type":"object","properties":{"license":{"description":"License information for the avatar style.","type":"object","properties":{"name":{"description":"The name of the license, e.g. `CC BY 4.0`.","type":"string","maxLength":128},"url":{"description":"A link to the full license text.","$ref":"#/definitions/safeUrl"},"text":{"description":"The full license text.","type":"string","maxLength":32768}},"additionalProperties":false},"creator":{"description":"Information about the creator of the avatar style.","type":"object","properties":{"name":{"description":"The name of the creator.","type":"string","maxLength":128},"url":{"description":"A link to the creator's website or profile.","$ref":"#/definitions/safeUrl"}},"additionalProperties":false},"source":{"description":"Information about the original source of the artwork.","type":"object","properties":{"name":{"description":"The name of the original source.","type":"string","maxLength":128},"url":{"description":"A link to the original source.","$ref":"#/definitions/safeUrl"}},"additionalProperties":false}},"additionalProperties":false},"attributes":{"description":"Global SVG presentation attributes applied to the root `<svg>` element.","$ref":"#/definitions/attributes"},"canvas":{"description":"The main content of the avatar, defining the SVG structure, canvas dimensions, and element tree.","type":"object","properties":{"elements":{"description":"The list of SVG elements that make up the avatar.","type":"array","items":{"$ref":"#/definitions/element"},"maxItems":1024},"width":{"description":"The natural width of the avatar canvas in pixels.","type":"number","minimum":1},"height":{"description":"The natural height of the avatar canvas in pixels.","type":"number","minimum":1}},"required":["elements","width","height"],"additionalProperties":false},"components":{"description":"Named, reusable SVG components. Each component defines a set of variants that the PRNG can select from at render time, or aliases another component to render an additional, independently-randomized instance of it. Keys must be `camelCaseName` identifiers.","type":"object","propertyNames":{"$ref":"#/definitions/camelCaseName"},"additionalProperties":{"anyOf":[{"$ref":"#/definitions/componentBase"},{"$ref":"#/definitions/componentAlias"}]},"maxProperties":512},"colors":{"description":"Named color palettes used by the avatar. The PRNG selects colors from these groups at render time. Color groups can define constraints such as contrast or exclusion rules. Keys must be `camelCaseName` identifiers.","type":"object","propertyNames":{"$ref":"#/definitions/camelCaseName"},"additionalProperties":{"type":"object","properties":{"values":{"description":"The list of hex color values the PRNG can choose from.","type":"array","items":{"$ref":"#/definitions/hexColor"},"minItems":1,"maxItems":128},"notEqualTo":{"description":"A list of other color names. The selected color value must differ from the color values selected in those colors. The schema does not prevent cycles (e.g. `a` notEqualTo `b` and `b` notEqualTo `a`); renderers resolve palettes in definition order and must reject unsatisfiable configurations at load time.","type":"array","items":{"$ref":"#/definitions/colorName"},"maxItems":64},"contrastTo":{"description":"The name of another color. When specified, the PRNG is not used for selection — instead, the color value with the highest contrast against the selected color value of the referenced color is chosen. The schema does not prevent cycles (e.g. `a` contrastTo `b` and `b` contrastTo `a`); renderers resolve palettes in definition order and must reject unsatisfiable configurations at load time.","$ref":"#/definitions/colorName"}},"required":["values"],"additionalProperties":false},"maxProperties":512}},"required":["canvas"],"additionalProperties":false}

package/dist/options.min.json

@@ -1 +1 @@
-{"$id":"https://cdn.hopjs.net/npm/@dicebear/schema@0.13.0/dist/options.min.json","$schema":"http://json-schema.org/draft-07/schema#","title":"DiceBear options schema","type":"object","definitions":{"flip":{"type":"string","enum":["none","horizontal","vertical","both"]},"rotate":{"type":"number","minimum":-360,"maximum":360},"scale":{"type":"number","minimum":0,"maximum":10},"translate":{"type":"number","minimum":-1000,"maximum":1000},"borderRadius":{"type":"number","minimum":0,"maximum":50},"color":{"type":"string","pattern":"^#?([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$"},"colorFill":{"type":"string","enum":["solid","linear","radial"]},"colorFillStops":{"type":"integer","minimum":2},"fontFamilyName":{"type":"string","pattern":"^[a-zA-Z0-9_\\-]+( [a-zA-Z0-9_\\-]+)*(, ?[a-zA-Z0-9_\\-]+( [a-zA-Z0-9_\\-]+)*)*$","maxLength":256},"fontWeight":{"type":"integer","minimum":1,"maximum":1000},"variantName":{"type":"string","pattern":"^[a-z][a-zA-Z0-9]*$","maxLength":64},"rotateOption":{"anyOf":[{"$ref":"#/definitions/rotate"},{"type":"array","items":{"$ref":"#/definitions/rotate"},"minItems":0,"maxItems":2}]},"translateOption":{"anyOf":[{"$ref":"#/definitions/translate"},{"type":"array","items":{"$ref":"#/definitions/translate"},"minItems":0,"maxItems":2}]},"scaleOption":{"anyOf":[{"$ref":"#/definitions/scale"},{"type":"array","items":{"$ref":"#/definitions/scale"},"minItems":0,"maxItems":2}]}},"properties":{"seed":{"type":"string","description":"The starting value for the pseudorandom number generator (PRNG) used in the avatar generation process. This option is essential for creating unique and consistent avatars. By setting a specific seed, you ensure that the same sequence of random characteristics is applied, allowing identical avatars to be reproduced. This is especially valuable for maintaining consistency across sessions and allowing users to share or recreate their personalized avatars.","maxLength":1024},"size":{"type":"integer","description":"Specifies the dimensions of the avatar in pixels. If no size is specified, the avatar defaults to a responsive design or scales to 100% of its container. This flexibility allows the avatar to seamlessly adapt to different screen sizes and layouts, ensuring optimal display across devices and environments.","minimum":1,"maximum":4096},"idRandomization":{"type":"boolean","description":"Generates random values for all IDs present in the SVG. This process ensures that while the avatar appears visually identical, the underlying code remains unique. This is particularly useful for embedding the same avatar multiple times in a document without running into duplicate ID conflicts that can interfere with styles and scripts."},"title":{"type":"string","description":"Specifies an accessible title for the avatar. When set, the SVG will include a <title> element and an aria-label attribute, allowing screen readers and other assistive technologies to describe the avatar to users.","maxLength":256},"flip":{"description":"Specifies how the avatar will be flipped. Options include `none` for no flip, `horizontal` for a left-to-right flip, `vertical` for an upside-down flip, and `both` for a complete flip. If specified as an array, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/flip"},{"type":"array","items":{"$ref":"#/definitions/flip"},"minItems":0,"maxItems":128}]},"fontFamily":{"description":"Specifies the font family used for text rendering. If specified as an array, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/fontFamilyName"},{"type":"array","items":{"$ref":"#/definitions/fontFamilyName"},"minItems":0,"maxItems":128}]},"fontWeight":{"description":"Specifies the font weight used for text rendering. The value must be an integer between 1 and 1000. If specified as an array, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/fontWeight"},{"type":"array","items":{"$ref":"#/definitions/fontWeight"},"minItems":0,"maxItems":128}]},"scale":{"description":"Sets the scaling of the avatar. A value of `1` corresponds to the original size of the avatar. This setting affects the size of the avatar itself, but not the size of the avatar container; any excess content will be clipped. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/scaleOption"}]},"borderRadius":{"description":"This is the radius of the corners of the avatar. This value can be a float or an integer. A value of 0 means that the avatar has sharp corners, while larger values result in more rounded corners. The maximum value is 50, which turns the avatar into a complete circle. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","anyOf":[{"$ref":"#/definitions/borderRadius"},{"type":"array","items":{"$ref":"#/definitions/borderRadius"},"minItems":0,"maxItems":2}]}},"patternProperties":{"^[a-z][a-zA-Z0-9]*Probability$":{"type":"number","description":"Represents the probability that a component of the avatar will be displayed. The value can be either a float or an integer, but is interpreted as a percentage. For example, a value of 0 means the part will never be displayed, while a value of 100 means it will always be displayed.","minimum":0,"maximum":100},"^[a-z][a-zA-Z0-9]*Variant$":{"description":"Specifies which variants of the avatar part can be selected by the PRNG and their relative weights. A string or array of strings filters which variants the PRNG can choose from. An object maps variant names to non-negative weights, simultaneously filtering and weighting selection. Variant names must be camelCase identifiers.","anyOf":[{"$ref":"#/definitions/variantName"},{"type":"array","items":{"$ref":"#/definitions/variantName"},"minItems":0,"maxItems":128},{"type":"object","propertyNames":{"$ref":"#/definitions/variantName"},"additionalProperties":{"type":"number","minimum":0},"minProperties":1,"maxProperties":512}]},"^[a-z][a-zA-Z0-9]*Color$":{"description":"Specifies which colors for the avatar component can be selected by the PRNG. If specified as a string or array with only one value, the value is fixed. However, if specified as an array with multiple values, the PRNG will choose from the available options. The color must be specified as a hex value.","anyOf":[{"$ref":"#/definitions/color"},{"type":"array","items":{"$ref":"#/definitions/color"},"minItems":0,"maxItems":128}]},"^[a-z][a-zA-Z0-9]*ColorFill$":{"description":"Specifies the color fill method for the avatar component. Options include `solid` for a flat color, `linear` for a linear gradient, and `radial` for a radial gradient. If specified as a string or array with only one value, the value is fixed. However, if specified as an array with multiple values, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/colorFill"},{"type":"array","items":{"$ref":"#/definitions/colorFill"},"minItems":0,"maxItems":128}]},"^[a-z][a-zA-Z0-9]*ColorFillStops$":{"description":"Specifies the number of color stops for gradient fills. This value is only relevant when the color fill method is set to `linear` or `radial`. The minimum value is 2. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","anyOf":[{"$ref":"#/definitions/colorFillStops"},{"type":"array","items":{"$ref":"#/definitions/colorFillStops"},"minItems":0,"maxItems":2}]},"^[a-z][a-zA-Z0-9]*ColorAngle$":{"description":"Specifies the angle for the color gradient. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/rotateOption"}]},"^rotate$":{"description":"This is the rotation angle for the entire avatar. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation in both directions. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/rotateOption"}]},"^[a-z][a-zA-Z0-9]*Rotate$":{"description":"This is the rotation angle for a specific avatar part, prefixed with the part name in camelCase. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation in both directions. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/rotateOption"}]},"^translateY$":{"description":"This is the vertical translation of the entire avatar. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the avatar down and negative values move it up. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/translateOption"}]},"^[a-z][a-zA-Z0-9]*TranslateY$":{"description":"This is the vertical translation of a specific avatar part, prefixed with the part name in camelCase. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the part down and negative values move it up. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/translateOption"}]},"^translateX$":{"description":"This is the horizontal translation of the entire avatar. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the avatar to the right and negative values move it to the left. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/translateOption"}]},"^[a-z][a-zA-Z0-9]*TranslateX$":{"description":"This is the horizontal translation of a specific avatar part, prefixed with the part name in camelCase. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the part to the right and negative values move it to the left. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/translateOption"}]},"^[a-z][a-zA-Z0-9]*Scale$":{"description":"This is the scale factor for a specific avatar part, prefixed with the part name in camelCase. A value of `1` corresponds to the original size of the part. This setting scales the part around its own center independently of the global `scale` option. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/scaleOption"}]}},"propertyNames":{"maxLength":128},"additionalProperties":false,"maxProperties":512}
+{"$id":"https://cdn.hopjs.net/npm/@dicebear/schema@0.14.0/dist/options.min.json","$schema":"http://json-schema.org/draft-07/schema#","title":"DiceBear options schema","type":"object","definitions":{"flip":{"type":"string","enum":["none","horizontal","vertical","both"]},"rotate":{"type":"number","minimum":-360,"maximum":360},"scale":{"type":"number","minimum":0,"maximum":10},"translate":{"type":"number","minimum":-1000,"maximum":1000},"borderRadius":{"type":"number","minimum":0,"maximum":50},"color":{"type":"string","pattern":"^#?([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$"},"colorFill":{"type":"string","enum":["solid","linear","radial"]},"colorFillStops":{"type":"integer","minimum":2},"fontFamilyName":{"type":"string","pattern":"^[a-zA-Z0-9_\\-]+( [a-zA-Z0-9_\\-]+)*(, ?[a-zA-Z0-9_\\-]+( [a-zA-Z0-9_\\-]+)*)*$","maxLength":256},"fontWeight":{"type":"integer","minimum":1,"maximum":1000},"variantName":{"type":"string","pattern":"^[a-z][a-zA-Z0-9]*$","maxLength":64},"rotateOption":{"anyOf":[{"$ref":"#/definitions/rotate"},{"type":"array","items":{"$ref":"#/definitions/rotate"},"minItems":0,"maxItems":2}]},"translateOption":{"anyOf":[{"$ref":"#/definitions/translate"},{"type":"array","items":{"$ref":"#/definitions/translate"},"minItems":0,"maxItems":2}]},"scaleOption":{"anyOf":[{"$ref":"#/definitions/scale"},{"type":"array","items":{"$ref":"#/definitions/scale"},"minItems":0,"maxItems":2}]}},"properties":{"seed":{"type":"string","description":"The starting value for the pseudorandom number generator (PRNG) used in the avatar generation process. This option is essential for creating unique and consistent avatars. By setting a specific seed, you ensure that the same sequence of random characteristics is applied, allowing identical avatars to be reproduced. This is especially valuable for maintaining consistency across sessions and allowing users to share or recreate their personalized avatars.","maxLength":1024},"size":{"type":"integer","description":"Specifies the dimensions of the avatar in pixels. If no size is specified, the avatar defaults to a responsive design or scales to 100% of its container. This flexibility allows the avatar to seamlessly adapt to different screen sizes and layouts, ensuring optimal display across devices and environments.","minimum":1,"maximum":4096},"idRandomization":{"type":"boolean","description":"Generates random values for all IDs present in the SVG. This process ensures that while the avatar appears visually identical, the underlying code remains unique. This is particularly useful for embedding the same avatar multiple times in a document without running into duplicate ID conflicts that can interfere with styles and scripts."},"title":{"type":"string","description":"Specifies an accessible title for the avatar. When set, the SVG will include a <title> element and an aria-label attribute, allowing screen readers and other assistive technologies to describe the avatar to users.","maxLength":256},"flip":{"description":"Specifies how the avatar will be flipped. Options include `none` for no flip, `horizontal` for a left-to-right flip, `vertical` for an upside-down flip, and `both` for a complete flip. If specified as an array, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/flip"},{"type":"array","items":{"$ref":"#/definitions/flip"},"minItems":0,"maxItems":128}]},"fontFamily":{"description":"Specifies the font family used for text rendering. If specified as an array, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/fontFamilyName"},{"type":"array","items":{"$ref":"#/definitions/fontFamilyName"},"minItems":0,"maxItems":128}]},"fontWeight":{"description":"Specifies the font weight used for text rendering. The value must be an integer between 1 and 1000. If specified as an array, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/fontWeight"},{"type":"array","items":{"$ref":"#/definitions/fontWeight"},"minItems":0,"maxItems":128}]},"scale":{"description":"Sets the scaling of the avatar. A value of `1` corresponds to the original size of the avatar. This setting affects the size of the avatar itself, but not the size of the avatar container; any excess content will be clipped. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/scaleOption"}]},"borderRadius":{"description":"This is the radius of the corners of the avatar. This value can be a float or an integer. A value of 0 means that the avatar has sharp corners, while larger values result in more rounded corners. The maximum value is 50, which turns the avatar into a complete circle. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","anyOf":[{"$ref":"#/definitions/borderRadius"},{"type":"array","items":{"$ref":"#/definitions/borderRadius"},"minItems":0,"maxItems":2}]}},"patternProperties":{"^[a-z][a-zA-Z0-9]*Probability$":{"type":"number","description":"Represents the probability that a component of the avatar will be displayed. The value can be either a float or an integer, but is interpreted as a percentage. For example, a value of 0 means the part will never be displayed, while a value of 100 means it will always be displayed.","minimum":0,"maximum":100},"^[a-z][a-zA-Z0-9]*Variant$":{"description":"Specifies which variants of the avatar part can be selected by the PRNG and their relative weights. A string or array of strings filters which variants the PRNG can choose from. An object maps variant names to non-negative weights, simultaneously filtering and weighting selection. Variant names must be camelCase identifiers.","anyOf":[{"$ref":"#/definitions/variantName"},{"type":"array","items":{"$ref":"#/definitions/variantName"},"minItems":0,"maxItems":128},{"type":"object","propertyNames":{"$ref":"#/definitions/variantName"},"additionalProperties":{"type":"number","minimum":0},"minProperties":1,"maxProperties":512}]},"^[a-z][a-zA-Z0-9]*Color$":{"description":"Specifies which colors for the avatar component can be selected by the PRNG. If specified as a string or array with only one value, the value is fixed. However, if specified as an array with multiple values, the PRNG will choose from the available options. The color must be specified as a hex value.","anyOf":[{"$ref":"#/definitions/color"},{"type":"array","items":{"$ref":"#/definitions/color"},"minItems":0,"maxItems":128}]},"^[a-z][a-zA-Z0-9]*ColorFill$":{"description":"Specifies the color fill method for the avatar component. Options include `solid` for a flat color, `linear` for a linear gradient, and `radial` for a radial gradient. If specified as a string or array with only one value, the value is fixed. However, if specified as an array with multiple values, the PRNG will choose from the available options.","anyOf":[{"$ref":"#/definitions/colorFill"},{"type":"array","items":{"$ref":"#/definitions/colorFill"},"minItems":0,"maxItems":128}]},"^[a-z][a-zA-Z0-9]*ColorFillStops$":{"description":"Specifies the number of color stops for gradient fills. This value is only relevant when the color fill method is set to `linear` or `radial`. The minimum value is 2. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","anyOf":[{"$ref":"#/definitions/colorFillStops"},{"type":"array","items":{"$ref":"#/definitions/colorFillStops"},"minItems":0,"maxItems":2}]},"^[a-z][a-zA-Z0-9]*ColorAngle$":{"description":"Specifies the angle for the color gradient. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/rotateOption"}]},"^rotate$":{"description":"This is the rotation angle for the entire avatar. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation in both directions. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/rotateOption"}]},"^translateY$":{"description":"This is the vertical translation of the entire avatar. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the avatar down and negative values move it up. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/translateOption"}]},"^translateX$":{"description":"This is the horizontal translation of the entire avatar. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the avatar to the right and negative values move it to the left. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.","allOf":[{"$ref":"#/definitions/translateOption"}]}},"propertyNames":{"maxLength":128},"additionalProperties":false,"maxProperties":512}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dicebear/schema",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "JSON Schema definitions for DiceBear avatar styles and options",
   "keywords": [
     "dicebear",

package/src/definition.json

@@ -537,17 +537,13 @@
       "additionalProperties": false
     },
     "componentAlias": {
-      "description": "An alias that inherits its dimensions and variants from another component referenced by `extends`. Per-instance overrides for `probability`, `rotate`, `scale`, and `translate` are supported.",
+      "description": "An alias that inherits its dimensions, variants, and transforms from another component referenced by `extends`. Aliases have no per-instance overrides — they are pure references.",
       "type": "object",
       "properties": {
         "extends": {
           "description": "The name of an existing, non-alias component in this `components` map.",
           "$ref": "#/definitions/componentName"
-        },
-        "probability": { "$ref": "#/definitions/componentProbability" },
-        "rotate": { "$ref": "#/definitions/componentRotate" },
-        "scale": { "$ref": "#/definitions/componentScale" },
-        "translate": { "$ref": "#/definitions/componentTranslate" }
+        }
       },
       "required": ["extends"],
       "additionalProperties": false

package/src/options.json

@@ -267,29 +267,13 @@
       "description": "This is the rotation angle for the entire avatar. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation in both directions. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
       "allOf": [{ "$ref": "#/definitions/rotateOption" }]
     },
-    "^[a-z][a-zA-Z0-9]*Rotate$": {
-      "description": "This is the rotation angle for a specific avatar part, prefixed with the part name in camelCase. This value can be an integer or a float. A value of 0 results in no rotation, while values between -360 and 360 define the degree of rotation in both directions. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
-      "allOf": [{ "$ref": "#/definitions/rotateOption" }]
-    },
     "^translateY$": {
       "description": "This is the vertical translation of the entire avatar. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the avatar down and negative values move it up. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
       "allOf": [{ "$ref": "#/definitions/translateOption" }]
     },
-    "^[a-z][a-zA-Z0-9]*TranslateY$": {
-      "description": "This is the vertical translation of a specific avatar part, prefixed with the part name in camelCase. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the part down and negative values move it up. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
-      "allOf": [{ "$ref": "#/definitions/translateOption" }]
-    },
     "^translateX$": {
       "description": "This is the horizontal translation of the entire avatar. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the avatar to the right and negative values move it to the left. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
       "allOf": [{ "$ref": "#/definitions/translateOption" }]
-    },
-    "^[a-z][a-zA-Z0-9]*TranslateX$": {
-      "description": "This is the horizontal translation of a specific avatar part, prefixed with the part name in camelCase. This value can be an integer or a float. A value of 0 results in no translation, while positive values move the part to the right and negative values move it to the left. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
-      "allOf": [{ "$ref": "#/definitions/translateOption" }]
-    },
-    "^[a-z][a-zA-Z0-9]*Scale$": {
-      "description": "This is the scale factor for a specific avatar part, prefixed with the part name in camelCase. A value of `1` corresponds to the original size of the part. This setting scales the part around its own center independently of the global `scale` option. If specified as an array, the PRNG will select a value within the specified range, including the values themselves.",
-      "allOf": [{ "$ref": "#/definitions/scaleOption" }]
     }
   },
   "propertyNames": { "maxLength": 128 },