solfaces 2.2.0 → 2.3.0

package/dist/traits-D4tbtZIr.d.ts

@@ -0,0 +1,259 @@
+/** Deterministic trait indices generated from a wallet address. Each index selects a visual variant. */
+interface SolFaceTraits {
+    /** Face shape variant (0–3). Consumed for PRNG ordering; all faces render as squircle. */
+    faceShape: number;
+    /** Skin tone index (0–9). Maps to: Porcelain, Ivory, Fair, Light, Sand, Golden, Warm, Caramel, Brown, Deep. */
+    skinColor: number;
+    /** Eye shape variant (0–8). Maps to: Round, Minimal, Almond, Wide, Relaxed, Joyful, Bright, Gentle, Side-look. */
+    eyeStyle: number;
+    /** Eye iris color index (0–7). Maps to: Chocolate, Sky, Emerald, Hazel, Storm, Amber, Violet, Gray. */
+    eyeColor: number;
+    /** Eyebrow style (0–7). Maps to: Wispy, Straight, Natural, Arched, Angled, Worried, Bushy, Thin. */
+    eyebrows: number;
+    /** Nose variant (0–7). Maps to: Shadow, Button, Soft, Nostrils, Pointed, Wide, Bridge, Snub. */
+    nose: number;
+    /** Mouth expression (0–7). Maps to: Smile, Calm, Happy, Oh, Smirk, Grin, Flat, Pout. */
+    mouth: number;
+    /** Hair style (0–9). Maps to: Bald, Crew, Curly, Side Part, Long, Buzz, Beanie, Cap, Mohawk, Bun. */
+    hairStyle: number;
+    /** Hair color index (0–9). Maps to: Black, Espresso, Walnut, Honey, Copper, Silver, Charcoal, Burgundy, Strawberry, Ginger. */
+    hairColor: number;
+    /** Accessory (0–11). Maps to: None, Beauty Mark, Round Glasses, Rect Glasses, Earring, Headband, Freckles, Stud Earrings, Aviators, Band-Aid, Left Eyebrow Slit, Right Eyebrow Slit. */
+    accessory: number;
+    /** Background color index (0–11). Maps to: Rose, Olive, Sage, Fern, Mint, Ocean, Sky, Lavender, Orchid, Blush, Lilac, Seafoam. */
+    bgColor: number;
+}
+interface SolFaceTheme {
+    /** Override the 10 skin tone colors. Default: natural palette from porcelain (#faeae5) to deep brown (#4b2d25). */
+    skinColors?: string[];
+    /** Override the 8 eye iris colors. Default: chocolate, sky, emerald, hazel, storm, amber, violet, gray. */
+    eyeColors?: string[];
+    /** Override the 10 hair colors. Default: black through ginger. */
+    hairColors?: string[];
+    /** Override the 12 background colors. Default: muted earth tones (rose, olive, sage, ..., lilac, seafoam). */
+    bgColors?: string[];
+    /** Override mouth/lip color for all faces. Default: derived from skin luminance. */
+    mouthColor?: string;
+    /** Override eyebrow color for all faces. Default: derived from skin luminance. */
+    eyebrowColor?: string;
+    /** Override accessory accent color. Default: skin-warm neutral derived from skin. */
+    accessoryColor?: string;
+    /** Override eye white (sclera) color. Default: adapted to skin luminance (#EDE8E0 → #FBF8F2). */
+    eyeWhiteColor?: string;
+    /** Override nose shadow/fill color. Default: derived from skin luminance. */
+    noseColor?: string;
+    /** Override glasses frame color. Default: "#4a4a5a". */
+    glassesColor?: string;
+    /** Override earring color. Default: skin–gold blend. */
+    earringColor?: string;
+    /** Override headband color. Default: hair–red blend. */
+    headbandColor?: string;
+    /** Override ear fill color. Default: derived blend of skin highlight and shadow. */
+    earColor?: string;
+    /** Override eyelid color. Default: derived from skin luminance. */
+    lidColor?: string;
+    /** Override freckle dot color. Default: "#a0785a". */
+    freckleColor?: string;
+    /** Override beauty mark color. Default: "#3a2a2a". */
+    beautyMarkColor?: string;
+    /** Background opacity (0 = transparent, 1 = solid). Default: 1. */
+    bgOpacity?: number;
+    /** Background corner radius in SVG units (viewBox is 64×64). Default: 4. */
+    bgRadius?: number;
+    /** Optional border around the avatar. */
+    border?: {
+        color: string;
+        width: number;
+    };
+    /** Flat rendering — disables all gradients. Default: false. */
+    flat?: boolean;
+    /** Show cheek blush overlays (full detail only). Default: true. */
+    cheekEnabled?: boolean;
+    /** Override cheek blush color. Default: derived warm blush from skin. */
+    cheekColor?: string;
+    /** Cheek blush opacity (0–1). Default: derived from skin luminance (~0.15–0.33). */
+    cheekOpacity?: number;
+    /** Face skin opacity (0–1). Default: 1. */
+    skinOpacity?: number;
+    /** Show chin shadow and glow overlays (full detail only). Default: true. */
+    shadowEnabled?: boolean;
+    /** Face glow highlight intensity (0–1). Default: 0.10. */
+    glowIntensity?: number;
+    /** Show/hide ears. Default: true. */
+    earsEnabled?: boolean;
+    /** Show/hide eyebrows. Default: true. */
+    eyebrowsEnabled?: boolean;
+    /** Show/hide nose. Default: true. */
+    noseEnabled?: boolean;
+    /** Show/hide accessories (glasses, earrings, headband, etc.). Default: true. */
+    accessoriesEnabled?: boolean;
+    /** Show/hide hair (front and back). Default: true. */
+    hairEnabled?: boolean;
+    /** Enable pixel art rendering mode. Default: false. */
+    _pixel?: boolean;
+    /** Pixel grid resolution (source canvas size). Lower = blockier. Default: 16. */
+    _pixelDensity?: number;
+    /** Round pixel art corners (12% border-radius). Default: true. */
+    _pixelRounded?: boolean;
+    /** Show pixel outline border. Default: false. */
+    _pixelOutline?: boolean;
+    /** Pixel outline color. Default: "#000". */
+    _pixelOutlineColor?: string;
+    /** Pixel outline width at 64px reference size. Scales proportionally. Default: 1. */
+    _pixelOutlineWidth?: number;
+    /** CSS contrast filter (1.0 = normal). */
+    _pixelContrast?: number;
+    /** CSS saturate filter (1.0 = normal). */
+    _pixelSaturation?: number;
+    /** CSS brightness filter (1.0 = normal). */
+    _pixelBrightness?: number;
+    /** Show CRT-style scanline overlay. Default: false. */
+    _pixelScanlines?: boolean;
+    /** Scanline overlay opacity (0–1). Default: 0.08. */
+    _pixelScanlineOpacity?: number;
+    /** Scanline spacing in px at 64px reference size. Scales proportionally. Default: 2. */
+    _pixelScanlineSpacing?: number;
+    /** Show pixel grid overlay. Default: false. */
+    _pixelGrid?: boolean;
+    /** Grid overlay opacity (0–1). Default: 0.06. */
+    _pixelGridOpacity?: number;
+    /** Grid line color. Default: "#000". */
+    _pixelGridColor?: string;
+    /** Enable drop shadow on pixel art. Default: false. */
+    _pixelShadow?: boolean;
+    /** Pixel shadow color. Default: "rgba(0,0,0,0.3)". */
+    _pixelShadowColor?: string;
+    /** Pixel shadow offset at 64px reference size. Scales proportionally. Default: 2. */
+    _pixelShadowOffset?: number;
+    /** Enable liquid glass rendering mode. Default: false. */
+    _glass?: boolean;
+    /** Backdrop blur radius at 64px reference size. Scales proportionally. Default: 12. */
+    _blurRadius?: number;
+    /** Backdrop saturation multiplier (1.0 = normal). Default: 1.8. */
+    _saturate?: number;
+    /** Color tint overlay opacity (0–1). Default: 0.12. */
+    _tintOpacity?: number;
+    /** Color tint overlay color. Default: "rgba(255,255,255,1)". */
+    _tintColor?: string;
+    /** Glass border opacity (0–1). Default: 0.25. */
+    _borderOpacity?: number;
+    /** Glass border width at 64px reference size. Scales proportionally. Min 0.5px. Default: 1. */
+    _borderWidth?: number;
+    /** Glass border color. Default: rgba(255,255,255,{_borderOpacity}). */
+    _borderColor?: string;
+    /** Specular highlight opacity (0–1). Default: 0.25. */
+    _specularOpacity?: number;
+    /** Specular highlight color. Default: "rgba(255,255,255,1)". */
+    _specularColor?: string;
+    /** Specular gradient end position (%). Default: 50. */
+    _specularEnd?: number;
+    /** Light angle for specular gradient (degrees). Default: 135. */
+    _lightAngle?: number;
+    /** Inner rim highlight intensity (0–1). Default: 0.08. */
+    _rimIntensity?: number;
+    /** @deprecated Use _shadowY, _shadowBlur, _shadowOpacity for size-proportional shadows. Raw CSS shadow string — not scaled with size. */
+    _shadow?: string;
+    /** Shadow Y offset at 64px reference size. Scales proportionally. Default: 8. */
+    _shadowY?: number;
+    /** Shadow blur radius at 64px reference size. Scales proportionally. Default: 32. */
+    _shadowBlur?: number;
+    /** Shadow opacity (0–1). Default: 0.12. */
+    _shadowOpacity?: number;
+}
+/** Options for rendering a SolFace avatar (shared by string renderer and React component). */
+interface RenderOptions {
+    /** Avatar size in CSS pixels (width and height). Default: 64. */
+    size?: number;
+    /** Theme configuration for colors, layout, and rendering style. */
+    theme?: SolFaceTheme;
+    /** Override specific trait indices. Merged on top of the deterministic traits. */
+    traitOverrides?: Partial<SolFaceTraits>;
+    /** Enable blink animation. Pass `true` for defaults, or an object for custom timing. Default: false. */
+    enableBlink?: boolean | {
+        /** Interval between blinks in seconds. Default: 4. */
+        duration?: number;
+        /** Initial delay before first blink in seconds. Default: 0. */
+        delay?: number;
+    };
+    /** CSS class name applied to the root SVG element. */
+    className?: string;
+    /** Detail level. "full" renders all overlays; "simplified" omits gradients and blush; "auto" uses full at size ≥ 48px. Default: "auto". */
+    detail?: "full" | "simplified" | "auto";
+    /** Per-instance color overrides (hex strings). Takes precedence over theme color settings and derived colors. */
+    colorOverrides?: {
+        /** Override skin color (hex). */
+        skin?: string;
+        /** Override eye iris color (hex). */
+        eyes?: string;
+        /** Override hair color (hex). */
+        hair?: string;
+        /** Override background color (hex). */
+        bg?: string;
+        /** Override mouth/lip color (hex). */
+        mouth?: string;
+        /** Override eyebrow color (hex). */
+        eyebrow?: string;
+        /** Override accessory accent color (hex). */
+        accessory?: string;
+        /** Override nose shadow/fill color (hex). */
+        nose?: string;
+        /** Override eye white (sclera) color (hex). */
+        eyeWhite?: string;
+    };
+}
+/** Default 10 skin tone hex colors, from porcelain to deep brown. */
+declare const SKIN_COLORS: string[];
+/** Default 8 eye iris hex colors: chocolate, sky, emerald, hazel, storm, amber, violet, gray. */
+declare const EYE_COLORS: string[];
+/** Default 10 hair hex colors: black, espresso, walnut, honey, copper, silver, charcoal, burgundy, strawberry, ginger. */
+declare const HAIR_COLORS: string[];
+/** Default 12 background hex colors: rose, olive, sage, fern, mint, ocean, sky, lavender, orchid, blush, lilac, seafoam. */
+declare const BG_COLORS: string[];
+/**
+ * Deterministically generate avatar traits from a wallet address using djb2 + mulberry32 PRNG.
+ * The same wallet always produces the same traits (~53M visually unique combinations).
+ *
+ * @param walletAddress  Base58 Solana wallet address.
+ * @param overrides      Optional partial traits to force specific values.
+ * @returns Complete trait set with all 11 indices (10 visual + faceShape for PRNG ordering).
+ */
+declare function generateTraits(walletAddress: string, overrides?: Partial<SolFaceTraits>): SolFaceTraits;
+/**
+ * Resolve the effective accessory index.
+ *
+ * @param traits  Complete trait set.
+ * @returns Effective accessory index (0–11).
+ */
+declare function effectiveAccessory(traits: SolFaceTraits): number;
+/**
+ * Convert numeric trait indices to human-readable label strings.
+ *
+ * @param traits  Complete trait set.
+ * @returns A record mapping each trait name to its display label (e.g. `{ skinColor: "Golden", hairStyle: "Curly" }`).
+ */
+declare function getTraitLabels(traits: SolFaceTraits): Record<string, string>;
+/**
+ * Compute a short hex hash (8 characters) from a wallet address. Useful as a compact identity fingerprint.
+ *
+ * @param walletAddress  Base58 Solana wallet address.
+ * @returns 8-character lowercase hex string.
+ */
+declare function traitHash(walletAddress: string): string;
+/**
+ * Look up a theme by name from a theme registry.
+ *
+ * @param themeName  Theme name to look up.
+ * @param themes     Registry of available themes.
+ * @returns The matching theme, or `undefined` if not found.
+ */
+declare function resolveTheme(themeName?: string, themes?: Record<string, SolFaceTheme>): SolFaceTheme | undefined;
+/**
+ * Shallow-merge two themes. Overrides take precedence over the base.
+ *
+ * @param base       Base theme (or null/undefined).
+ * @param overrides  Theme overrides (or null/undefined).
+ * @returns Merged theme, or null if both inputs are nullish.
+ */
+declare function mergeTheme(base: SolFaceTheme | null | undefined, overrides: SolFaceTheme | null | undefined): SolFaceTheme | null;
+
+export { BG_COLORS as B, EYE_COLORS as E, HAIR_COLORS as H, type RenderOptions as R, SKIN_COLORS as S, type SolFaceTheme as a, type SolFaceTraits as b, getTraitLabels as c, effectiveAccessory as e, generateTraits as g, mergeTheme as m, resolveTheme as r, traitHash as t };

package/dist/vanilla/index.cjs

@@ -1,8 +1,7 @@
 'use strict';
 
-var chunkTYTBYDQU_cjs = require('../chunk-TYTBYDQU.cjs');
-var chunkF54WHRCE_cjs = require('../chunk-F54WHRCE.cjs');
-var chunk6QRDULAO_cjs = require('../chunk-6QRDULAO.cjs');
+var chunkW2U6ITMR_cjs = require('../chunk-W2U6ITMR.cjs');
+var chunkPCSRDAWQ_cjs = require('../chunk-PCSRDAWQ.cjs');
 
 // src/vanilla/index.ts
 function mountSolFace(element, walletAddress, options) {
@@ -12,7 +11,7 @@ function mountSolFace(element, walletAddress, options) {
     return () => {
     };
   }
-  el.innerHTML = chunkF54WHRCE_cjs.renderSolFaceSVG(walletAddress, options);
+  el.innerHTML = chunkW2U6ITMR_cjs.renderSolFaceSVG(walletAddress, options);
   return () => {
     el.innerHTML = "";
   };
@@ -20,8 +19,8 @@ function mountSolFace(element, walletAddress, options) {
 function setSolFaceImg(img, walletAddress, options) {
   const el = typeof img === "string" ? document.querySelector(img) : img;
   if (!el) return;
-  el.src = chunkF54WHRCE_cjs.renderSolFaceDataURI(walletAddress, options);
-  el.alt = chunkTYTBYDQU_cjs.solFaceAltText(walletAddress);
+  el.src = chunkW2U6ITMR_cjs.renderSolFaceDataURI(walletAddress, options);
+  el.alt = chunkW2U6ITMR_cjs.solFaceAltText(walletAddress);
 }
 function autoInit(root = document) {
   const elements = root.querySelectorAll("[data-solface]");
@@ -33,7 +32,7 @@ function autoInit(root = document) {
     const themeName = el.getAttribute("data-solface-theme");
     const flat = el.getAttribute("data-solface-flat") === "true";
     const detail = el.getAttribute("data-solface-detail");
-    let theme = themeName && themeName in chunk6QRDULAO_cjs.PRESET_THEMES ? chunk6QRDULAO_cjs.PRESET_THEMES[themeName] : void 0;
+    let theme = themeName && themeName in chunkPCSRDAWQ_cjs.PRESET_THEMES ? chunkPCSRDAWQ_cjs.PRESET_THEMES[themeName] : void 0;
     if (flat && theme) {
       theme = { ...theme, flat: true };
     } else if (flat) {

package/dist/vanilla/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vanilla/index.ts"],"names":["renderSolFaceSVG","renderSolFaceDataURI","solFaceAltText","PRESET_THEMES"],"mappings":";;;;;;;AAUO,SAAS,YAAA,CACd,OAAA,EACA,aAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM,KAAK,OAAO,OAAA,KAAY,WAC1B,QAAA,CAAS,aAAA,CAA2B,OAAO,CAAA,GAC3C,OAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACP,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,8BAAA,EAAiC,OAAO,CAAA,CAAE,CAAA;AACvD,IAAA,OAAO,MAAM;AAAA,IAAC,CAAA;AAAA,EAChB;AAEA,EAAA,EAAA,CAAG,SAAA,GAAYA,kCAAA,CAAiB,aAAA,EAAe,OAAO,CAAA;AACtD,EAAA,OAAO,MAAM;AAAE,IAAA,EAAA,CAAG,SAAA,GAAY,EAAA;AAAA,EAAI,CAAA;AACpC;AAEO,SAAS,aAAA,CACd,GAAA,EACA,aAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,KAAK,OAAO,GAAA,KAAQ,WACtB,QAAA,CAAS,aAAA,CAAgC,GAAG,CAAA,GAC5C,GAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACT,EAAA,EAAA,CAAG,GAAA,GAAMC,sCAAA,CAAqB,aAAA,EAAe,OAAO,CAAA;AACpD,EAAA,EAAA,CAAG,GAAA,GAAMC,iCAAe,aAAa,CAAA;AACvC;AAEO,SAAS,QAAA,CAAS,OAA+B,QAAA,EAAgB;AACtE,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,gBAAA,CAA8B,gBAAgB,CAAA;AACpE,EAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,EAAA,KAAO;AACvB,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,cAAc,CAAA;AAC7C,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,MAAM,OAAO,QAAA,CAAS,EAAA,CAAG,aAAa,mBAAmB,CAAA,IAAK,MAAM,EAAE,CAAA;AACtE,IAAA,MAAM,KAAA,GAAQ,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA,KAAM,MAAA;AACxD,IAAA,MAAM,SAAA,GAAY,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA;AACtD,IAAA,MAAM,IAAA,GAAO,EAAA,CAAG,YAAA,CAAa,mBAAmB,CAAA,KAAM,MAAA;AACtD,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,qBAAqB,CAAA;AAEpD,IAAA,IAAI,QAAQ,SAAA,IAAa,SAAA,IAAaC,+BAAA,GAClCA,+BAAA,CAAc,SAAuC,CAAA,GACrD,MAAA;AAGJ,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,KAAA,GAAQ,EAAE,GAAG,KAAA,EAAO,IAAA,EAAM,IAAA,EAAK;AAAA,IACjC,WAAW,IAAA,EAAM;AACf,MAAA,KAAA,GAAQ,EAAE,MAAM,IAAA,EAAK;AAAA,IACvB;AAEA,IAAA,YAAA,CAAa,IAAI,MAAA,EAAQ;AAAA,MACvB,IAAA;AAAA,MACA,WAAA,EAAa,KAAA;AAAA,MACb,KAAA;AAAA,MACA,QAAQ,MAAA,IAAU;AAAA,KACnB,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"index.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — Vanilla DOM Helpers\n// Mount avatars directly into DOM elements without React.\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, renderSolFaceDataURI } from \"../core/renderer\";\nimport { solFaceAltText } from \"../core/describe\";\nimport { PRESET_THEMES } from \"../themes/presets\";\nimport type { RenderOptions } from \"../core/traits\";\n\nexport function mountSolFace(\n  element: HTMLElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): () => void {\n  const el = typeof element === \"string\"\n    ? document.querySelector<HTMLElement>(element)\n    : element;\n\n  if (!el) {\n    console.warn(`[SolFaces] Element not found: ${element}`);\n    return () => {};\n  }\n\n  el.innerHTML = renderSolFaceSVG(walletAddress, options);\n  return () => { el.innerHTML = \"\"; };\n}\n\nexport function setSolFaceImg(\n  img: HTMLImageElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): void {\n  const el = typeof img === \"string\"\n    ? document.querySelector<HTMLImageElement>(img)\n    : img;\n\n  if (!el) return;\n  el.src = renderSolFaceDataURI(walletAddress, options);\n  el.alt = solFaceAltText(walletAddress);\n}\n\nexport function autoInit(root: HTMLElement | Document = document): void {\n  const elements = root.querySelectorAll<HTMLElement>(\"[data-solface]\");\n  elements.forEach((el) => {\n    const wallet = el.getAttribute(\"data-solface\");\n    if (!wallet) return;\n\n    const size = parseInt(el.getAttribute(\"data-solface-size\") ?? \"64\", 10);\n    const blink = el.getAttribute(\"data-solface-blink\") === \"true\";\n    const themeName = el.getAttribute(\"data-solface-theme\") as string | null;\n    const flat = el.getAttribute(\"data-solface-flat\") === \"true\";\n    const detail = el.getAttribute(\"data-solface-detail\") as \"full\" | \"simplified\" | \"auto\" | null;\n\n    let theme = themeName && themeName in PRESET_THEMES\n      ? PRESET_THEMES[themeName as keyof typeof PRESET_THEMES]\n      : undefined;\n\n    // data-solface-flat overrides theme flat setting\n    if (flat && theme) {\n      theme = { ...theme, flat: true };\n    } else if (flat) {\n      theme = { flat: true };\n    }\n\n    mountSolFace(el, wallet, {\n      size,\n      enableBlink: blink,\n      theme,\n      detail: detail ?? \"auto\",\n    });\n  });\n}\n"]}
+{"version":3,"sources":["../../src/vanilla/index.ts"],"names":["renderSolFaceSVG","renderSolFaceDataURI","solFaceAltText","PRESET_THEMES"],"mappings":";;;;;;AAUO,SAAS,YAAA,CACd,OAAA,EACA,aAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM,KAAK,OAAO,OAAA,KAAY,WAC1B,QAAA,CAAS,aAAA,CAA2B,OAAO,CAAA,GAC3C,OAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACP,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,8BAAA,EAAiC,OAAO,CAAA,CAAE,CAAA;AACvD,IAAA,OAAO,MAAM;AAAA,IAAC,CAAA;AAAA,EAChB;AAEA,EAAA,EAAA,CAAG,SAAA,GAAYA,kCAAA,CAAiB,aAAA,EAAe,OAAO,CAAA;AACtD,EAAA,OAAO,MAAM;AAAE,IAAA,EAAA,CAAG,SAAA,GAAY,EAAA;AAAA,EAAI,CAAA;AACpC;AAEO,SAAS,aAAA,CACd,GAAA,EACA,aAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,KAAK,OAAO,GAAA,KAAQ,WACtB,QAAA,CAAS,aAAA,CAAgC,GAAG,CAAA,GAC5C,GAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACT,EAAA,EAAA,CAAG,GAAA,GAAMC,sCAAA,CAAqB,aAAA,EAAe,OAAO,CAAA;AACpD,EAAA,EAAA,CAAG,GAAA,GAAMC,iCAAe,aAAa,CAAA;AACvC;AAEO,SAAS,QAAA,CAAS,OAA+B,QAAA,EAAgB;AACtE,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,gBAAA,CAA8B,gBAAgB,CAAA;AACpE,EAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,EAAA,KAAO;AACvB,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,cAAc,CAAA;AAC7C,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,MAAM,OAAO,QAAA,CAAS,EAAA,CAAG,aAAa,mBAAmB,CAAA,IAAK,MAAM,EAAE,CAAA;AACtE,IAAA,MAAM,KAAA,GAAQ,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA,KAAM,MAAA;AACxD,IAAA,MAAM,SAAA,GAAY,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA;AACtD,IAAA,MAAM,IAAA,GAAO,EAAA,CAAG,YAAA,CAAa,mBAAmB,CAAA,KAAM,MAAA;AACtD,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,qBAAqB,CAAA;AAEpD,IAAA,IAAI,QAAQ,SAAA,IAAa,SAAA,IAAaC,+BAAA,GAClCA,+BAAA,CAAc,SAAuC,CAAA,GACrD,MAAA;AAGJ,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,KAAA,GAAQ,EAAE,GAAG,KAAA,EAAO,IAAA,EAAM,IAAA,EAAK;AAAA,IACjC,WAAW,IAAA,EAAM;AACf,MAAA,KAAA,GAAQ,EAAE,MAAM,IAAA,EAAK;AAAA,IACvB;AAEA,IAAA,YAAA,CAAa,IAAI,MAAA,EAAQ;AAAA,MACvB,IAAA;AAAA,MACA,WAAA,EAAa,KAAA;AAAA,MACb,KAAA;AAAA,MACA,QAAQ,MAAA,IAAU;AAAA,KACnB,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"index.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — Vanilla DOM Helpers\n// Mount avatars directly into DOM elements without React.\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, renderSolFaceDataURI } from \"../core/renderer\";\nimport { solFaceAltText } from \"../core/describe\";\nimport { PRESET_THEMES } from \"../themes/presets\";\nimport type { RenderOptions } from \"../core/traits\";\n\nexport function mountSolFace(\n  element: HTMLElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): () => void {\n  const el = typeof element === \"string\"\n    ? document.querySelector<HTMLElement>(element)\n    : element;\n\n  if (!el) {\n    console.warn(`[SolFaces] Element not found: ${element}`);\n    return () => {};\n  }\n\n  el.innerHTML = renderSolFaceSVG(walletAddress, options);\n  return () => { el.innerHTML = \"\"; };\n}\n\nexport function setSolFaceImg(\n  img: HTMLImageElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): void {\n  const el = typeof img === \"string\"\n    ? document.querySelector<HTMLImageElement>(img)\n    : img;\n\n  if (!el) return;\n  el.src = renderSolFaceDataURI(walletAddress, options);\n  el.alt = solFaceAltText(walletAddress);\n}\n\nexport function autoInit(root: HTMLElement | Document = document): void {\n  const elements = root.querySelectorAll<HTMLElement>(\"[data-solface]\");\n  elements.forEach((el) => {\n    const wallet = el.getAttribute(\"data-solface\");\n    if (!wallet) return;\n\n    const size = parseInt(el.getAttribute(\"data-solface-size\") ?? \"64\", 10);\n    const blink = el.getAttribute(\"data-solface-blink\") === \"true\";\n    const themeName = el.getAttribute(\"data-solface-theme\") as string | null;\n    const flat = el.getAttribute(\"data-solface-flat\") === \"true\";\n    const detail = el.getAttribute(\"data-solface-detail\") as \"full\" | \"simplified\" | \"auto\" | null;\n\n    let theme = themeName && themeName in PRESET_THEMES\n      ? PRESET_THEMES[themeName as keyof typeof PRESET_THEMES]\n      : undefined;\n\n    // data-solface-flat overrides theme flat setting\n    if (flat && theme) {\n      theme = { ...theme, flat: true };\n    } else if (flat) {\n      theme = { flat: true };\n    }\n\n    mountSolFace(el, wallet, {\n      size,\n      enableBlink: blink,\n      theme,\n      detail: detail ?? \"auto\",\n    });\n  });\n}\n"]}

package/dist/vanilla/index.d.cts

@@ -1,4 +1,4 @@
-import { R as RenderOptions } from '../traits-sfe7rM9C.cjs';
+import { R as RenderOptions } from '../traits-D4tbtZIr.cjs';
 
 declare function mountSolFace(element: HTMLElement | string, walletAddress: string, options?: RenderOptions): () => void;
 declare function setSolFaceImg(img: HTMLImageElement | string, walletAddress: string, options?: RenderOptions): void;

package/dist/vanilla/index.d.ts

@@ -1,4 +1,4 @@
-import { R as RenderOptions } from '../traits-sfe7rM9C.js';
+import { R as RenderOptions } from '../traits-D4tbtZIr.js';
 
 declare function mountSolFace(element: HTMLElement | string, walletAddress: string, options?: RenderOptions): () => void;
 declare function setSolFaceImg(img: HTMLImageElement | string, walletAddress: string, options?: RenderOptions): void;

package/dist/vanilla/index.js

@@ -1,6 +1,5 @@
-import { solFaceAltText } from '../chunk-CKHLRORB.js';
-import { renderSolFaceSVG, renderSolFaceDataURI } from '../chunk-3CE7Q44S.js';
-import { PRESET_THEMES } from '../chunk-DRUSCLEF.js';
+import { renderSolFaceSVG, renderSolFaceDataURI, solFaceAltText } from '../chunk-N5GDLCCL.js';
+import { PRESET_THEMES } from '../chunk-MYUSB4LA.js';
 
 // src/vanilla/index.ts
 function mountSolFace(element, walletAddress, options) {

package/dist/vanilla/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vanilla/index.ts"],"names":[],"mappings":";;;;;AAUO,SAAS,YAAA,CACd,OAAA,EACA,aAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM,KAAK,OAAO,OAAA,KAAY,WAC1B,QAAA,CAAS,aAAA,CAA2B,OAAO,CAAA,GAC3C,OAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACP,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,8BAAA,EAAiC,OAAO,CAAA,CAAE,CAAA;AACvD,IAAA,OAAO,MAAM;AAAA,IAAC,CAAA;AAAA,EAChB;AAEA,EAAA,EAAA,CAAG,SAAA,GAAY,gBAAA,CAAiB,aAAA,EAAe,OAAO,CAAA;AACtD,EAAA,OAAO,MAAM;AAAE,IAAA,EAAA,CAAG,SAAA,GAAY,EAAA;AAAA,EAAI,CAAA;AACpC;AAEO,SAAS,aAAA,CACd,GAAA,EACA,aAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,KAAK,OAAO,GAAA,KAAQ,WACtB,QAAA,CAAS,aAAA,CAAgC,GAAG,CAAA,GAC5C,GAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACT,EAAA,EAAA,CAAG,GAAA,GAAM,oBAAA,CAAqB,aAAA,EAAe,OAAO,CAAA;AACpD,EAAA,EAAA,CAAG,GAAA,GAAM,eAAe,aAAa,CAAA;AACvC;AAEO,SAAS,QAAA,CAAS,OAA+B,QAAA,EAAgB;AACtE,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,gBAAA,CAA8B,gBAAgB,CAAA;AACpE,EAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,EAAA,KAAO;AACvB,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,cAAc,CAAA;AAC7C,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,MAAM,OAAO,QAAA,CAAS,EAAA,CAAG,aAAa,mBAAmB,CAAA,IAAK,MAAM,EAAE,CAAA;AACtE,IAAA,MAAM,KAAA,GAAQ,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA,KAAM,MAAA;AACxD,IAAA,MAAM,SAAA,GAAY,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA;AACtD,IAAA,MAAM,IAAA,GAAO,EAAA,CAAG,YAAA,CAAa,mBAAmB,CAAA,KAAM,MAAA;AACtD,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,qBAAqB,CAAA;AAEpD,IAAA,IAAI,QAAQ,SAAA,IAAa,SAAA,IAAa,aAAA,GAClC,aAAA,CAAc,SAAuC,CAAA,GACrD,MAAA;AAGJ,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,KAAA,GAAQ,EAAE,GAAG,KAAA,EAAO,IAAA,EAAM,IAAA,EAAK;AAAA,IACjC,WAAW,IAAA,EAAM;AACf,MAAA,KAAA,GAAQ,EAAE,MAAM,IAAA,EAAK;AAAA,IACvB;AAEA,IAAA,YAAA,CAAa,IAAI,MAAA,EAAQ;AAAA,MACvB,IAAA;AAAA,MACA,WAAA,EAAa,KAAA;AAAA,MACb,KAAA;AAAA,MACA,QAAQ,MAAA,IAAU;AAAA,KACnB,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — Vanilla DOM Helpers\n// Mount avatars directly into DOM elements without React.\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, renderSolFaceDataURI } from \"../core/renderer\";\nimport { solFaceAltText } from \"../core/describe\";\nimport { PRESET_THEMES } from \"../themes/presets\";\nimport type { RenderOptions } from \"../core/traits\";\n\nexport function mountSolFace(\n  element: HTMLElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): () => void {\n  const el = typeof element === \"string\"\n    ? document.querySelector<HTMLElement>(element)\n    : element;\n\n  if (!el) {\n    console.warn(`[SolFaces] Element not found: ${element}`);\n    return () => {};\n  }\n\n  el.innerHTML = renderSolFaceSVG(walletAddress, options);\n  return () => { el.innerHTML = \"\"; };\n}\n\nexport function setSolFaceImg(\n  img: HTMLImageElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): void {\n  const el = typeof img === \"string\"\n    ? document.querySelector<HTMLImageElement>(img)\n    : img;\n\n  if (!el) return;\n  el.src = renderSolFaceDataURI(walletAddress, options);\n  el.alt = solFaceAltText(walletAddress);\n}\n\nexport function autoInit(root: HTMLElement | Document = document): void {\n  const elements = root.querySelectorAll<HTMLElement>(\"[data-solface]\");\n  elements.forEach((el) => {\n    const wallet = el.getAttribute(\"data-solface\");\n    if (!wallet) return;\n\n    const size = parseInt(el.getAttribute(\"data-solface-size\") ?? \"64\", 10);\n    const blink = el.getAttribute(\"data-solface-blink\") === \"true\";\n    const themeName = el.getAttribute(\"data-solface-theme\") as string | null;\n    const flat = el.getAttribute(\"data-solface-flat\") === \"true\";\n    const detail = el.getAttribute(\"data-solface-detail\") as \"full\" | \"simplified\" | \"auto\" | null;\n\n    let theme = themeName && themeName in PRESET_THEMES\n      ? PRESET_THEMES[themeName as keyof typeof PRESET_THEMES]\n      : undefined;\n\n    // data-solface-flat overrides theme flat setting\n    if (flat && theme) {\n      theme = { ...theme, flat: true };\n    } else if (flat) {\n      theme = { flat: true };\n    }\n\n    mountSolFace(el, wallet, {\n      size,\n      enableBlink: blink,\n      theme,\n      detail: detail ?? \"auto\",\n    });\n  });\n}\n"]}
+{"version":3,"sources":["../../src/vanilla/index.ts"],"names":[],"mappings":";;;;AAUO,SAAS,YAAA,CACd,OAAA,EACA,aAAA,EACA,OAAA,EACY;AACZ,EAAA,MAAM,KAAK,OAAO,OAAA,KAAY,WAC1B,QAAA,CAAS,aAAA,CAA2B,OAAO,CAAA,GAC3C,OAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACP,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,8BAAA,EAAiC,OAAO,CAAA,CAAE,CAAA;AACvD,IAAA,OAAO,MAAM;AAAA,IAAC,CAAA;AAAA,EAChB;AAEA,EAAA,EAAA,CAAG,SAAA,GAAY,gBAAA,CAAiB,aAAA,EAAe,OAAO,CAAA;AACtD,EAAA,OAAO,MAAM;AAAE,IAAA,EAAA,CAAG,SAAA,GAAY,EAAA;AAAA,EAAI,CAAA;AACpC;AAEO,SAAS,aAAA,CACd,GAAA,EACA,aAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,KAAK,OAAO,GAAA,KAAQ,WACtB,QAAA,CAAS,aAAA,CAAgC,GAAG,CAAA,GAC5C,GAAA;AAEJ,EAAA,IAAI,CAAC,EAAA,EAAI;AACT,EAAA,EAAA,CAAG,GAAA,GAAM,oBAAA,CAAqB,aAAA,EAAe,OAAO,CAAA;AACpD,EAAA,EAAA,CAAG,GAAA,GAAM,eAAe,aAAa,CAAA;AACvC;AAEO,SAAS,QAAA,CAAS,OAA+B,QAAA,EAAgB;AACtE,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,gBAAA,CAA8B,gBAAgB,CAAA;AACpE,EAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,EAAA,KAAO;AACvB,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,cAAc,CAAA;AAC7C,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,MAAM,OAAO,QAAA,CAAS,EAAA,CAAG,aAAa,mBAAmB,CAAA,IAAK,MAAM,EAAE,CAAA;AACtE,IAAA,MAAM,KAAA,GAAQ,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA,KAAM,MAAA;AACxD,IAAA,MAAM,SAAA,GAAY,EAAA,CAAG,YAAA,CAAa,oBAAoB,CAAA;AACtD,IAAA,MAAM,IAAA,GAAO,EAAA,CAAG,YAAA,CAAa,mBAAmB,CAAA,KAAM,MAAA;AACtD,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,YAAA,CAAa,qBAAqB,CAAA;AAEpD,IAAA,IAAI,QAAQ,SAAA,IAAa,SAAA,IAAa,aAAA,GAClC,aAAA,CAAc,SAAuC,CAAA,GACrD,MAAA;AAGJ,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,KAAA,GAAQ,EAAE,GAAG,KAAA,EAAO,IAAA,EAAM,IAAA,EAAK;AAAA,IACjC,WAAW,IAAA,EAAM;AACf,MAAA,KAAA,GAAQ,EAAE,MAAM,IAAA,EAAK;AAAA,IACvB;AAEA,IAAA,YAAA,CAAa,IAAI,MAAA,EAAQ;AAAA,MACvB,IAAA;AAAA,MACA,WAAA,EAAa,KAAA;AAAA,MACb,KAAA;AAAA,MACA,QAAQ,MAAA,IAAU;AAAA,KACnB,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — Vanilla DOM Helpers\n// Mount avatars directly into DOM elements without React.\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, renderSolFaceDataURI } from \"../core/renderer\";\nimport { solFaceAltText } from \"../core/describe\";\nimport { PRESET_THEMES } from \"../themes/presets\";\nimport type { RenderOptions } from \"../core/traits\";\n\nexport function mountSolFace(\n  element: HTMLElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): () => void {\n  const el = typeof element === \"string\"\n    ? document.querySelector<HTMLElement>(element)\n    : element;\n\n  if (!el) {\n    console.warn(`[SolFaces] Element not found: ${element}`);\n    return () => {};\n  }\n\n  el.innerHTML = renderSolFaceSVG(walletAddress, options);\n  return () => { el.innerHTML = \"\"; };\n}\n\nexport function setSolFaceImg(\n  img: HTMLImageElement | string,\n  walletAddress: string,\n  options?: RenderOptions,\n): void {\n  const el = typeof img === \"string\"\n    ? document.querySelector<HTMLImageElement>(img)\n    : img;\n\n  if (!el) return;\n  el.src = renderSolFaceDataURI(walletAddress, options);\n  el.alt = solFaceAltText(walletAddress);\n}\n\nexport function autoInit(root: HTMLElement | Document = document): void {\n  const elements = root.querySelectorAll<HTMLElement>(\"[data-solface]\");\n  elements.forEach((el) => {\n    const wallet = el.getAttribute(\"data-solface\");\n    if (!wallet) return;\n\n    const size = parseInt(el.getAttribute(\"data-solface-size\") ?? \"64\", 10);\n    const blink = el.getAttribute(\"data-solface-blink\") === \"true\";\n    const themeName = el.getAttribute(\"data-solface-theme\") as string | null;\n    const flat = el.getAttribute(\"data-solface-flat\") === \"true\";\n    const detail = el.getAttribute(\"data-solface-detail\") as \"full\" | \"simplified\" | \"auto\" | null;\n\n    let theme = themeName && themeName in PRESET_THEMES\n      ? PRESET_THEMES[themeName as keyof typeof PRESET_THEMES]\n      : undefined;\n\n    // data-solface-flat overrides theme flat setting\n    if (flat && theme) {\n      theme = { ...theme, flat: true };\n    } else if (flat) {\n      theme = { flat: true };\n    }\n\n    mountSolFace(el, wallet, {\n      size,\n      enableBlink: blink,\n      theme,\n      detail: detail ?? \"auto\",\n    });\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solfaces",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Deterministic wallet avatars and names for the Solana ecosystem. SHA-256 name derivation, zero-dependency trait engine with React, vanilla JS, and server-side rendering support.",
   "author": "https://github.com/jorger3301",
   "license": "MIT",
@@ -32,6 +32,9 @@
     "solnames"
   ],
   "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",