solfaces 1.0.2 → 2.1.0

package/dist/themes/index.cjs

@@ -1,48 +1,60 @@
 'use strict';
 
-var chunkCVFO7YHY_cjs = require('../chunk-CVFO7YHY.cjs');
+var chunk6QRDULAO_cjs = require('../chunk-6QRDULAO.cjs');
 
 
 
 Object.defineProperty(exports, "PRESET_THEMES", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.PRESET_THEMES; }
+  get: function () { return chunk6QRDULAO_cjs.PRESET_THEMES; }
 });
-Object.defineProperty(exports, "circleTheme", {
+Object.defineProperty(exports, "darkTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.circleTheme; }
+  get: function () { return chunk6QRDULAO_cjs.darkTheme; }
 });
-Object.defineProperty(exports, "darkTheme", {
+Object.defineProperty(exports, "defaultTheme", {
+  enumerable: true,
+  get: function () { return chunk6QRDULAO_cjs.defaultTheme; }
+});
+Object.defineProperty(exports, "flatTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.darkTheme; }
+  get: function () { return chunk6QRDULAO_cjs.flatTheme; }
 });
 Object.defineProperty(exports, "getPresetTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.getPresetTheme; }
+  get: function () { return chunk6QRDULAO_cjs.getPresetTheme; }
 });
-Object.defineProperty(exports, "jupiterTheme", {
+Object.defineProperty(exports, "glassDarkTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.jupiterTheme; }
+  get: function () { return chunk6QRDULAO_cjs.glassDarkTheme; }
+});
+Object.defineProperty(exports, "glassTheme", {
+  enumerable: true,
+  get: function () { return chunk6QRDULAO_cjs.glassTheme; }
 });
 Object.defineProperty(exports, "lightTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.lightTheme; }
+  get: function () { return chunk6QRDULAO_cjs.lightTheme; }
 });
 Object.defineProperty(exports, "monoTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.monoTheme; }
+  get: function () { return chunk6QRDULAO_cjs.monoTheme; }
+});
+Object.defineProperty(exports, "pixelCleanTheme", {
+  enumerable: true,
+  get: function () { return chunk6QRDULAO_cjs.pixelCleanTheme; }
 });
-Object.defineProperty(exports, "neonTheme", {
+Object.defineProperty(exports, "pixelRetroTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.neonTheme; }
+  get: function () { return chunk6QRDULAO_cjs.pixelRetroTheme; }
 });
-Object.defineProperty(exports, "phantomTheme", {
+Object.defineProperty(exports, "pixelTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.phantomTheme; }
+  get: function () { return chunk6QRDULAO_cjs.pixelTheme; }
 });
-Object.defineProperty(exports, "solanaTheme", {
+Object.defineProperty(exports, "transparentTheme", {
   enumerable: true,
-  get: function () { return chunkCVFO7YHY_cjs.solanaTheme; }
+  get: function () { return chunk6QRDULAO_cjs.transparentTheme; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/themes/index.d.cts

@@ -1,14 +1,17 @@
-import { a as SolFaceTheme } from '../traits-DAFZnXeS.cjs';
+import { a as SolFaceTheme } from '../traits-QlWuxZDD.cjs';
 
-declare const solanaTheme: SolFaceTheme;
+declare const defaultTheme: SolFaceTheme;
 declare const darkTheme: SolFaceTheme;
 declare const lightTheme: SolFaceTheme;
 declare const monoTheme: SolFaceTheme;
-declare const neonTheme: SolFaceTheme;
-declare const jupiterTheme: SolFaceTheme;
-declare const phantomTheme: SolFaceTheme;
-declare const circleTheme: SolFaceTheme;
+declare const flatTheme: SolFaceTheme;
+declare const transparentTheme: SolFaceTheme;
+declare const glassTheme: SolFaceTheme;
+declare const glassDarkTheme: SolFaceTheme;
+declare const pixelTheme: SolFaceTheme;
+declare const pixelRetroTheme: SolFaceTheme;
+declare const pixelCleanTheme: SolFaceTheme;
 declare const PRESET_THEMES: Record<string, SolFaceTheme>;
 declare function getPresetTheme(name: string, overrides?: Partial<SolFaceTheme>): SolFaceTheme;
 
-export { PRESET_THEMES, circleTheme, darkTheme, getPresetTheme, jupiterTheme, lightTheme, monoTheme, neonTheme, phantomTheme, solanaTheme };
+export { PRESET_THEMES, darkTheme, defaultTheme, flatTheme, getPresetTheme, glassDarkTheme, glassTheme, lightTheme, monoTheme, pixelCleanTheme, pixelRetroTheme, pixelTheme, transparentTheme };

package/dist/themes/index.d.ts

@@ -1,14 +1,17 @@
-import { a as SolFaceTheme } from '../traits-DAFZnXeS.js';
+import { a as SolFaceTheme } from '../traits-QlWuxZDD.js';
 
-declare const solanaTheme: SolFaceTheme;
+declare const defaultTheme: SolFaceTheme;
 declare const darkTheme: SolFaceTheme;
 declare const lightTheme: SolFaceTheme;
 declare const monoTheme: SolFaceTheme;
-declare const neonTheme: SolFaceTheme;
-declare const jupiterTheme: SolFaceTheme;
-declare const phantomTheme: SolFaceTheme;
-declare const circleTheme: SolFaceTheme;
+declare const flatTheme: SolFaceTheme;
+declare const transparentTheme: SolFaceTheme;
+declare const glassTheme: SolFaceTheme;
+declare const glassDarkTheme: SolFaceTheme;
+declare const pixelTheme: SolFaceTheme;
+declare const pixelRetroTheme: SolFaceTheme;
+declare const pixelCleanTheme: SolFaceTheme;
 declare const PRESET_THEMES: Record<string, SolFaceTheme>;
 declare function getPresetTheme(name: string, overrides?: Partial<SolFaceTheme>): SolFaceTheme;
 
-export { PRESET_THEMES, circleTheme, darkTheme, getPresetTheme, jupiterTheme, lightTheme, monoTheme, neonTheme, phantomTheme, solanaTheme };
+export { PRESET_THEMES, darkTheme, defaultTheme, flatTheme, getPresetTheme, glassDarkTheme, glassTheme, lightTheme, monoTheme, pixelCleanTheme, pixelRetroTheme, pixelTheme, transparentTheme };

package/dist/themes/index.js

@@ -1,3 +1,3 @@
-export { PRESET_THEMES, circleTheme, darkTheme, getPresetTheme, jupiterTheme, lightTheme, monoTheme, neonTheme, phantomTheme, solanaTheme } from '../chunk-LQWJRHGC.js';
+export { PRESET_THEMES, darkTheme, defaultTheme, flatTheme, getPresetTheme, glassDarkTheme, glassTheme, lightTheme, monoTheme, pixelCleanTheme, pixelRetroTheme, pixelTheme, transparentTheme } from '../chunk-DRUSCLEF.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{traits-DAFZnXeS.d.cts → traits-QlWuxZDD.d.cts}

@@ -21,12 +21,53 @@ interface SolFaceTheme {
     accessoryColor?: string;
     eyeWhiteColor?: string;
     noseColor?: string;
+    glassesColor?: string;
+    earringColor?: string;
+    headbandColor?: string;
     bgOpacity?: number;
     bgRadius?: number;
     border?: {
         color: string;
         width: number;
     };
+    flat?: boolean;
+    cheekEnabled?: boolean;
+    cheekColor?: string;
+    cheekOpacity?: number;
+    skinOpacity?: number;
+    shadowEnabled?: boolean;
+    _pixel?: boolean;
+    _pixelDensity?: number;
+    _pixelRounded?: boolean;
+    _pixelOutline?: boolean;
+    _pixelOutlineColor?: string;
+    _pixelOutlineWidth?: number;
+    _pixelContrast?: number;
+    _pixelSaturation?: number;
+    _pixelBrightness?: number;
+    _pixelScanlines?: boolean;
+    _pixelScanlineOpacity?: number;
+    _pixelScanlineSpacing?: number;
+    _pixelGrid?: boolean;
+    _pixelGridOpacity?: number;
+    _pixelGridColor?: string;
+    _pixelShadow?: boolean;
+    _pixelShadowColor?: string;
+    _pixelShadowOffset?: number;
+    _glass?: boolean;
+    _blurRadius?: number;
+    _saturate?: number;
+    _tintOpacity?: number;
+    _tintColor?: string;
+    _borderOpacity?: number;
+    _borderWidth?: number;
+    _borderColor?: string;
+    _specularOpacity?: number;
+    _specularColor?: string;
+    _specularEnd?: number;
+    _lightAngle?: number;
+    _rimIntensity?: number;
+    _shadow?: string;
 }
 interface RenderOptions {
     size?: number;
@@ -37,6 +78,7 @@ interface RenderOptions {
         delay?: number;
     };
     className?: string;
+    detail?: "full" | "simplified" | "auto";
     colorOverrides?: {
         skin?: string;
         eyes?: string;
@@ -54,8 +96,10 @@ declare const EYE_COLORS: string[];
 declare const HAIR_COLORS: string[];
 declare const BG_COLORS: string[];
 declare function generateTraits(walletAddress: string, overrides?: Partial<SolFaceTraits>): SolFaceTraits;
+declare function effectiveAccessory(traits: SolFaceTraits): number;
 declare function getTraitLabels(traits: SolFaceTraits): Record<string, string>;
 declare function traitHash(walletAddress: string): string;
 declare function resolveTheme(themeName?: string, themes?: Record<string, SolFaceTheme>): SolFaceTheme | undefined;
+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, generateTraits as g, resolveTheme as r, traitHash as t };
+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/{traits-DAFZnXeS.d.ts → traits-QlWuxZDD.d.ts}

@@ -21,12 +21,53 @@ interface SolFaceTheme {
     accessoryColor?: string;
     eyeWhiteColor?: string;
     noseColor?: string;
+    glassesColor?: string;
+    earringColor?: string;
+    headbandColor?: string;
     bgOpacity?: number;
     bgRadius?: number;
     border?: {
         color: string;
         width: number;
     };
+    flat?: boolean;
+    cheekEnabled?: boolean;
+    cheekColor?: string;
+    cheekOpacity?: number;
+    skinOpacity?: number;
+    shadowEnabled?: boolean;
+    _pixel?: boolean;
+    _pixelDensity?: number;
+    _pixelRounded?: boolean;
+    _pixelOutline?: boolean;
+    _pixelOutlineColor?: string;
+    _pixelOutlineWidth?: number;
+    _pixelContrast?: number;
+    _pixelSaturation?: number;
+    _pixelBrightness?: number;
+    _pixelScanlines?: boolean;
+    _pixelScanlineOpacity?: number;
+    _pixelScanlineSpacing?: number;
+    _pixelGrid?: boolean;
+    _pixelGridOpacity?: number;
+    _pixelGridColor?: string;
+    _pixelShadow?: boolean;
+    _pixelShadowColor?: string;
+    _pixelShadowOffset?: number;
+    _glass?: boolean;
+    _blurRadius?: number;
+    _saturate?: number;
+    _tintOpacity?: number;
+    _tintColor?: string;
+    _borderOpacity?: number;
+    _borderWidth?: number;
+    _borderColor?: string;
+    _specularOpacity?: number;
+    _specularColor?: string;
+    _specularEnd?: number;
+    _lightAngle?: number;
+    _rimIntensity?: number;
+    _shadow?: string;
 }
 interface RenderOptions {
     size?: number;
@@ -37,6 +78,7 @@ interface RenderOptions {
         delay?: number;
     };
     className?: string;
+    detail?: "full" | "simplified" | "auto";
     colorOverrides?: {
         skin?: string;
         eyes?: string;
@@ -54,8 +96,10 @@ declare const EYE_COLORS: string[];
 declare const HAIR_COLORS: string[];
 declare const BG_COLORS: string[];
 declare function generateTraits(walletAddress: string, overrides?: Partial<SolFaceTraits>): SolFaceTraits;
+declare function effectiveAccessory(traits: SolFaceTraits): number;
 declare function getTraitLabels(traits: SolFaceTraits): Record<string, string>;
 declare function traitHash(walletAddress: string): string;
 declare function resolveTheme(themeName?: string, themes?: Record<string, SolFaceTheme>): SolFaceTheme | undefined;
+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, generateTraits as g, resolveTheme as r, traitHash as t };
+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,8 @@
 'use strict';
 
-var chunkH3SK3MNX_cjs = require('../chunk-H3SK3MNX.cjs');
-require('../chunk-2DIKGLXZ.cjs');
-var chunkCVFO7YHY_cjs = require('../chunk-CVFO7YHY.cjs');
+var chunkCXRVPOTI_cjs = require('../chunk-CXRVPOTI.cjs');
+var chunkHVPGR6G5_cjs = require('../chunk-HVPGR6G5.cjs');
+var chunk6QRDULAO_cjs = require('../chunk-6QRDULAO.cjs');
 
 // src/vanilla/index.ts
 function mountSolFace(element, walletAddress, options) {
@@ -12,7 +12,7 @@ function mountSolFace(element, walletAddress, options) {
     return () => {
     };
   }
-  el.innerHTML = chunkH3SK3MNX_cjs.renderSolFaceSVG(walletAddress, options);
+  el.innerHTML = chunkHVPGR6G5_cjs.renderSolFaceSVG(walletAddress, options);
   return () => {
     el.innerHTML = "";
   };
@@ -20,8 +20,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 = chunkH3SK3MNX_cjs.renderSolFaceDataURI(walletAddress, options);
-  el.alt = chunkH3SK3MNX_cjs.solFaceAltText(walletAddress);
+  el.src = chunkHVPGR6G5_cjs.renderSolFaceDataURI(walletAddress, options);
+  el.alt = chunkCXRVPOTI_cjs.solFaceAltText(walletAddress);
 }
 function autoInit(root = document) {
   const elements = root.querySelectorAll("[data-solface]");
@@ -31,8 +31,20 @@ function autoInit(root = document) {
     const size = parseInt(el.getAttribute("data-solface-size") ?? "64", 10);
     const blink = el.getAttribute("data-solface-blink") === "true";
     const themeName = el.getAttribute("data-solface-theme");
-    const theme = themeName && themeName in chunkCVFO7YHY_cjs.PRESET_THEMES ? chunkCVFO7YHY_cjs.PRESET_THEMES[themeName] : void 0;
-    mountSolFace(el, wallet, { size, enableBlink: blink, 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;
+    if (flat && theme) {
+      theme = { ...theme, flat: true };
+    } else if (flat) {
+      theme = { flat: true };
+    }
+    mountSolFace(el, wallet, {
+      size,
+      enableBlink: blink,
+      theme,
+      detail: detail ?? "auto"
+    });
   });
 }
 

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;AAEtD,IAAA,MAAM,QAAQ,SAAA,IAAa,SAAA,IAAaC,+BAAA,GACpCA,+BAAA,CAAc,SAAuC,CAAA,GACrD,MAAA;AAEJ,IAAA,YAAA,CAAa,IAAI,MAAA,EAAQ,EAAE,MAAM,WAAA,EAAa,KAAA,EAAO,OAAO,CAAA;AAAA,EAC9D,CAAC,CAAA;AACH","file":"index.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — 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\n    const theme = themeName && themeName in PRESET_THEMES\n      ? PRESET_THEMES[themeName as keyof typeof PRESET_THEMES]\n      : undefined;\n\n    mountSolFace(el, wallet, { size, enableBlink: blink, theme });\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-DAFZnXeS.cjs';
+import { R as RenderOptions } from '../traits-QlWuxZDD.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-DAFZnXeS.js';
+import { R as RenderOptions } from '../traits-QlWuxZDD.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,6 @@
-import { renderSolFaceSVG, renderSolFaceDataURI, solFaceAltText } from '../chunk-KSGFMW33.js';
-import '../chunk-WURY4QGH.js';
-import { PRESET_THEMES } from '../chunk-LQWJRHGC.js';
+import { solFaceAltText } from '../chunk-CQWXUU7P.js';
+import { renderSolFaceSVG, renderSolFaceDataURI } from '../chunk-SWML743U.js';
+import { PRESET_THEMES } from '../chunk-DRUSCLEF.js';
 
 // src/vanilla/index.ts
 function mountSolFace(element, walletAddress, options) {
@@ -29,8 +29,20 @@ function autoInit(root = document) {
     const size = parseInt(el.getAttribute("data-solface-size") ?? "64", 10);
     const blink = el.getAttribute("data-solface-blink") === "true";
     const themeName = el.getAttribute("data-solface-theme");
-    const theme = themeName && themeName in PRESET_THEMES ? PRESET_THEMES[themeName] : void 0;
-    mountSolFace(el, wallet, { size, enableBlink: blink, theme });
+    const flat = el.getAttribute("data-solface-flat") === "true";
+    const detail = el.getAttribute("data-solface-detail");
+    let theme = themeName && themeName in PRESET_THEMES ? PRESET_THEMES[themeName] : void 0;
+    if (flat && theme) {
+      theme = { ...theme, flat: true };
+    } else if (flat) {
+      theme = { flat: true };
+    }
+    mountSolFace(el, wallet, {
+      size,
+      enableBlink: blink,
+      theme,
+      detail: detail ?? "auto"
+    });
   });
 }
 

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;AAEtD,IAAA,MAAM,QAAQ,SAAA,IAAa,SAAA,IAAa,aAAA,GACpC,aAAA,CAAc,SAAuC,CAAA,GACrD,MAAA;AAEJ,IAAA,YAAA,CAAa,IAAI,MAAA,EAAQ,EAAE,MAAM,WAAA,EAAa,KAAA,EAAO,OAAO,CAAA;AAAA,EAC9D,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — 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\n    const theme = themeName && themeName in PRESET_THEMES\n      ? PRESET_THEMES[themeName as keyof typeof PRESET_THEMES]\n      : undefined;\n\n    mountSolFace(el, wallet, { size, enableBlink: blink, theme });\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,13 +1,14 @@
 {
   "name": "solfaces",
-  "version": "1.0.2",
-  "description": "Deterministic wallet avatars for the Solana ecosystem. Zero-dependency trait engine with React, vanilla JS, and server-side rendering support.",
+  "version": "2.1.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",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jorger3301/solfaces.git"
   },
+  "homepage": "https://github.com/jorger3301/SolFaces#readme",
   "keywords": [
     "solana",
     "avatar",
@@ -24,7 +25,11 @@
     "ai-agent",
     "mcp",
     "tool-use",
-    "function-calling"
+    "function-calling",
+    "name-generator",
+    "deterministic-name",
+    "sha256",
+    "solnames"
   ],
   "type": "module",
   "main": "./dist/index.cjs",
@@ -61,6 +66,11 @@
       "import": "./dist/agent/index.js",
       "require": "./dist/agent/index.cjs"
     },
+    "./names": {
+      "types": "./dist/names/index.d.ts",
+      "import": "./dist/names/index.js",
+      "require": "./dist/names/index.cjs"
+    },
     "./cdn": "./dist/solfaces.cdn.global.js"
   },
   "bin": {
@@ -69,7 +79,8 @@
   "files": [
     "dist",
     "python",
-    "skill.md",
+    "SKILL.md",
+    "reference",
     "README.md",
     "LICENSE"
   ],
@@ -77,15 +88,21 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "lint": "eslint src/",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/node": "^25.3.2",
     "@types/react": "^19.0.0",
+    "eslint": "^10.0.2",
     "react": "^19.0.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.5.0"
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.56.1",
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
     "react": ">=18.0.0"