solfaces 1.0.1 → 2.0.0

package/dist/{chunk-VMNATBH3.cjs → chunk-23XJ5VDX.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkH3SK3MNX_cjs = require('./chunk-H3SK3MNX.cjs');
-var chunk2DIKGLXZ_cjs = require('./chunk-2DIKGLXZ.cjs');
-var chunkCVFO7YHY_cjs = require('./chunk-CVFO7YHY.cjs');
+var chunk46ZEFA6R_cjs = require('./chunk-46ZEFA6R.cjs');
+var chunk6UWILY7E_cjs = require('./chunk-6UWILY7E.cjs');
+var chunk6QRDULAO_cjs = require('./chunk-6QRDULAO.cjs');
 
 // src/agent/tools.ts
 var generateSolfaceSvg = {
   name: "generate_solface_svg",
-  description: "Generate a deterministic SVG avatar for a Solana wallet address. Returns an SVG string that can be embedded in HTML, saved as a file, or converted to a data URI. The same wallet always produces the same face.",
+  description: "Generate a deterministic SVG avatar for a Solana wallet address. Returns an SVG string with gradient-rich rendering, skin-luminance-driven colors, and 10 accessory types. The same wallet always produces the same face. ~2.56 billion unique combinations.",
   parameters: {
     type: "object",
     properties: {
@@ -17,16 +17,21 @@ var generateSolfaceSvg = {
       },
       size: {
         type: "number",
-        description: "SVG width/height in pixels. Default: 64"
+        description: "SVG width/height in pixels. Default: 64. Sizes >= 48 use full detail (gradients, specular highlights, cheek blush)."
       },
       theme: {
         type: "string",
-        description: "Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle",
-        enum: ["solana", "dark", "light", "mono", "neon", "jupiter", "phantom", "circle"]
+        description: "Preset theme name. 'flat' and 'transparent' work everywhere. 'glass', 'glassDark', 'pixel', 'pixelRetro', 'pixelClean' are React-only.",
+        enum: ["default", "dark", "light", "mono", "flat", "transparent", "glass", "glassDark", "pixel", "pixelRetro", "pixelClean"]
       },
       enableBlink: {
         type: "boolean",
         description: "Enable CSS blink animation on the eyes. Default: false"
+      },
+      detail: {
+        type: "string",
+        description: "Detail level: 'full' (gradients, cheeks, specular), 'simplified' (flat shapes), 'auto' (full if size >= 48). Default: auto",
+        enum: ["full", "simplified", "auto"]
       }
     },
     required: ["wallet"]
@@ -35,14 +40,15 @@ var generateSolfaceSvg = {
     const wallet = params.wallet;
     const size = params.size ?? 64;
     const enableBlink = params.enableBlink ?? false;
+    const detail = params.detail ?? "auto";
     const themeName = params.theme;
-    const theme = themeName ? chunkCVFO7YHY_cjs.getPresetTheme(themeName) : void 0;
-    return chunkH3SK3MNX_cjs.renderSolFaceSVG(wallet, { size, theme, enableBlink });
+    const theme = themeName ? chunk6QRDULAO_cjs.getPresetTheme(themeName) : void 0;
+    return chunk6UWILY7E_cjs.renderSolFaceSVG(wallet, { size, theme, enableBlink, detail });
   }
 };
 var describeSolface = {
   name: "describe_solface",
-  description: "Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility.",
+  description: "Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility. Describes squircle face, skin tone, eye style/color, hair, accessories, and expression.",
   parameters: {
     type: "object",
     properties: {
@@ -68,7 +74,7 @@ var describeSolface = {
     required: ["wallet"]
   },
   handler(params) {
-    return chunkH3SK3MNX_cjs.describeAppearance(params.wallet, {
+    return chunk46ZEFA6R_cjs.describeAppearance(params.wallet, {
       format: params.format ?? "paragraph",
       perspective: params.perspective ?? "third",
       name: params.name
@@ -90,9 +96,9 @@ var getSolfaceTraits = {
   },
   handler(params) {
     const wallet = params.wallet;
-    const traits = chunk2DIKGLXZ_cjs.generateTraits(wallet);
-    const labels = chunk2DIKGLXZ_cjs.getTraitLabels(traits);
-    const hash = chunk2DIKGLXZ_cjs.traitHash(wallet);
+    const traits = chunk6UWILY7E_cjs.generateTraits(wallet);
+    const labels = chunk6UWILY7E_cjs.getTraitLabels(traits);
+    const hash = chunk6UWILY7E_cjs.traitHash(wallet);
     return { traits, labels, hash };
   }
 };
@@ -114,33 +120,37 @@ var getAgentIdentity = {
     required: ["wallet"]
   },
   handler(params) {
-    return chunkH3SK3MNX_cjs.agentAppearancePrompt(
+    return chunk46ZEFA6R_cjs.agentAppearancePrompt(
       params.wallet,
       params.agentName
     );
   }
 };
 var THEME_DESCRIPTIONS = {
-  solana: "Vibrant Solana brand colors (#14F195, #9945FF)",
-  dark: "Dark backgrounds with muted tones",
-  light: "Soft pastel backgrounds",
+  default: "Base look with gradient-rich rendering \u2014 no overrides",
+  dark: "Dark backgrounds with muted tones and subtle border",
+  light: "Soft pastel backgrounds with rounded corners",
   mono: "Full grayscale \u2014 all colors replaced with grays",
-  neon: "Cyberpunk high-contrast with neon accents and green border",
-  jupiter: "Jupiter aggregator dark blue palette with subtle border",
-  phantom: "Phantom wallet purple tones with subtle border",
-  circle: "Full circular border-radius (999px) for round avatars"
+  flat: "Disables all gradients \u2014 uses flat fill colors only",
+  transparent: "Transparent background with flat rendering",
+  glass: "Liquid glass effect with backdrop blur and specular highlights (React-only)",
+  glassDark: "Dark variant of liquid glass with deeper blur (React-only)",
+  pixel: "Pixel art mode at 16px density with rounded corners (React-only)",
+  pixelRetro: "Retro pixel art with scanlines and drop shadow (React-only)",
+  pixelClean: "Clean pixel art at 24px density (React-only)"
 };
 var listSolfaceThemes = {
   name: "list_solface_themes",
-  description: "List all available SolFace preset themes with descriptions. Themes control colors, borders, backgrounds, and border-radius of generated avatars.",
+  description: "List all available SolFace preset themes with descriptions. Themes control colors, gradients, borders, and rendering modes. Some themes (glass, pixel) are React-only.",
   parameters: {
     type: "object",
     properties: {}
   },
   handler() {
-    return Object.keys(chunkCVFO7YHY_cjs.PRESET_THEMES).map((name) => ({
+    return Object.keys(chunk6QRDULAO_cjs.PRESET_THEMES).map((name) => ({
       name,
-      description: THEME_DESCRIPTIONS[name] ?? ""
+      description: THEME_DESCRIPTIONS[name] ?? "",
+      reactOnly: name.startsWith("glass") || name.startsWith("pixel")
     }));
   }
 };
@@ -218,5 +228,5 @@ exports.toAnthropic = toAnthropic;
 exports.toMCP = toMCP;
 exports.toOpenAI = toOpenAI;
 exports.toVercelAI = toVercelAI;
-//# sourceMappingURL=chunk-VMNATBH3.cjs.map
-//# sourceMappingURL=chunk-VMNATBH3.cjs.map
+//# sourceMappingURL=chunk-23XJ5VDX.cjs.map
+//# sourceMappingURL=chunk-23XJ5VDX.cjs.map

package/dist/chunk-23XJ5VDX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":["getPresetTheme","renderSolFaceSVG","describeAppearance","generateTraits","getTraitLabels","traitHash","agentAppearancePrompt","PRESET_THEMES"],"mappings":"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","file":"chunk-23XJ5VDX.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — AI Agent Tool Definitions\n// Canonical, framework-agnostic tool schemas with handlers.\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG } from \"../core/renderer\";\nimport { describeAppearance, agentAppearancePrompt } from \"../core/describe\";\nimport {\n  generateTraits,\n  getTraitLabels,\n  traitHash,\n} from \"../core/traits\";\nimport { PRESET_THEMES, getPresetTheme } from \"../themes/presets\";\nimport type { SolFaceTheme } from \"../core/traits\";\n\n// ─── Types ───────────────────────────────────────\n\nexport interface JSONSchema {\n  type: string;\n  properties?: Record<string, JSONSchema & { description?: string; enum?: string[] }>;\n  required?: string[];\n  items?: JSONSchema;\n  description?: string;\n  enum?: string[];\n  default?: unknown;\n}\n\nexport interface SolFaceTool {\n  name: string;\n  description: string;\n  parameters: JSONSchema;\n  handler: (params: Record<string, unknown>) => unknown;\n}\n\n// ─── Tool: generate_solface_svg ──────────────────\n\nconst generateSolfaceSvg: SolFaceTool = {\n  name: \"generate_solface_svg\",\n  description:\n    \"Generate a deterministic SVG avatar for a Solana wallet address. Returns an SVG string with gradient-rich rendering, skin-luminance-driven colors, and 10 accessory types. The same wallet always produces the same face. ~2.56 billion unique combinations.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n      size: {\n        type: \"number\",\n        description: \"SVG width/height in pixels. Default: 64. Sizes >= 48 use full detail (gradients, specular highlights, cheek blush).\",\n      },\n      theme: {\n        type: \"string\",\n        description:\n          \"Preset theme name. 'flat' and 'transparent' work everywhere. 'glass', 'glassDark', 'pixel', 'pixelRetro', 'pixelClean' are React-only.\",\n        enum: [\"default\", \"dark\", \"light\", \"mono\", \"flat\", \"transparent\", \"glass\", \"glassDark\", \"pixel\", \"pixelRetro\", \"pixelClean\"],\n      },\n      enableBlink: {\n        type: \"boolean\",\n        description: \"Enable CSS blink animation on the eyes. Default: false\",\n      },\n      detail: {\n        type: \"string\",\n        description: \"Detail level: 'full' (gradients, cheeks, specular), 'simplified' (flat shapes), 'auto' (full if size >= 48). Default: auto\",\n        enum: [\"full\", \"simplified\", \"auto\"],\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const size = (params.size as number) ?? 64;\n    const enableBlink = (params.enableBlink as boolean) ?? false;\n    const detail = (params.detail as \"full\" | \"simplified\" | \"auto\") ?? \"auto\";\n    const themeName = params.theme as string | undefined;\n    const theme: SolFaceTheme | undefined = themeName\n      ? getPresetTheme(themeName)\n      : undefined;\n\n    return renderSolFaceSVG(wallet, { size, theme, enableBlink, detail });\n  },\n};\n\n// ─── Tool: describe_solface ──────────────────────\n\nconst describeSolface: SolFaceTool = {\n  name: \"describe_solface\",\n  description:\n    \"Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility. Describes squircle face, skin tone, eye style/color, hair, accessories, and expression.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n      format: {\n        type: \"string\",\n        description:\n          \"Output format: paragraph (flowing text), structured (labeled lines), compact (short comma-separated). Default: paragraph\",\n        enum: [\"paragraph\", \"structured\", \"compact\"],\n      },\n      perspective: {\n        type: \"string\",\n        description:\n          'Narrative perspective: \"first\" for self-description (\"I have...\"), \"third\" for external (\"This SolFace has...\"). Default: third',\n        enum: [\"first\", \"third\"],\n      },\n      name: {\n        type: \"string\",\n        description:\n          'Optional name to use instead of \"This SolFace\" or \"I\". E.g. \"Atlas\"',\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    return describeAppearance(params.wallet as string, {\n      format: (params.format as \"paragraph\" | \"structured\" | \"compact\") ?? \"paragraph\",\n      perspective: (params.perspective as \"first\" | \"third\") ?? \"third\",\n      name: params.name as string | undefined,\n    });\n  },\n};\n\n// ─── Tool: get_solface_traits ────────────────────\n\nconst getSolfaceTraits: SolFaceTool = {\n  name: \"get_solface_traits\",\n  description:\n    \"Get the raw numeric trait values, human-readable labels, and deterministic hash for a wallet's SolFace avatar. Returns structured data useful for programmatic decisions about appearance.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const traits = generateTraits(wallet);\n    const labels = getTraitLabels(traits);\n    const hash = traitHash(wallet);\n    return { traits, labels, hash };\n  },\n};\n\n// ─── Tool: get_agent_identity ────────────────────\n\nconst getAgentIdentity: SolFaceTool = {\n  name: \"get_agent_identity\",\n  description:\n    \"Generate a system prompt snippet that gives an AI agent a visual identity based on its Solana wallet. The snippet describes the agent's appearance in first person and explains the deterministic nature of SolFace avatars.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"The agent's Solana wallet address (base58 public key)\",\n      },\n      agentName: {\n        type: \"string\",\n        description: 'Optional agent name to personalize the description. E.g. \"Atlas\"',\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    return agentAppearancePrompt(\n      params.wallet as string,\n      params.agentName as string | undefined,\n    );\n  },\n};\n\n// ─── Tool: list_solface_themes ───────────────────\n\nconst THEME_DESCRIPTIONS: Record<string, string> = {\n  default: \"Base look with gradient-rich rendering — no overrides\",\n  dark: \"Dark backgrounds with muted tones and subtle border\",\n  light: \"Soft pastel backgrounds with rounded corners\",\n  mono: \"Full grayscale — all colors replaced with grays\",\n  flat: \"Disables all gradients — uses flat fill colors only\",\n  transparent: \"Transparent background with flat rendering\",\n  glass: \"Liquid glass effect with backdrop blur and specular highlights (React-only)\",\n  glassDark: \"Dark variant of liquid glass with deeper blur (React-only)\",\n  pixel: \"Pixel art mode at 16px density with rounded corners (React-only)\",\n  pixelRetro: \"Retro pixel art with scanlines and drop shadow (React-only)\",\n  pixelClean: \"Clean pixel art at 24px density (React-only)\",\n};\n\nconst listSolfaceThemes: SolFaceTool = {\n  name: \"list_solface_themes\",\n  description:\n    \"List all available SolFace preset themes with descriptions. Themes control colors, gradients, borders, and rendering modes. Some themes (glass, pixel) are React-only.\",\n  parameters: {\n    type: \"object\",\n    properties: {},\n  },\n  handler() {\n    return Object.keys(PRESET_THEMES).map((name) => ({\n      name,\n      description: THEME_DESCRIPTIONS[name] ?? \"\",\n      reactOnly: name.startsWith(\"glass\") || name.startsWith(\"pixel\"),\n    }));\n  },\n};\n\n// ─── Export All Tools ────────────────────────────\n\nexport const SOLFACE_TOOLS: SolFaceTool[] = [\n  generateSolfaceSvg,\n  describeSolface,\n  getSolfaceTraits,\n  getAgentIdentity,\n  listSolfaceThemes,\n];\n","// ═══════════════════════════════════════════════════════════════\n// SOLFACES — Agent Integration Barrel + Format Adapters\n// Convert SolFace tools to any AI agent framework format.\n// ═══════════════════════════════════════════════════════════════\n\nexport { SOLFACE_TOOLS } from \"./tools\";\nexport type { SolFaceTool, JSONSchema } from \"./tools\";\n\nimport { SOLFACE_TOOLS } from \"./tools\";\nimport type { SolFaceTool, JSONSchema } from \"./tools\";\n\n// ─── Unified Dispatcher ─────────────────────────\n\n/**\n * Handle a tool call by name. Works as a universal dispatcher for\n * any framework — just pass the tool name and parameters.\n *\n * @example\n * ```ts\n * const svg = await handleToolCall(\"generate_solface_svg\", {\n *   wallet: \"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\"\n * });\n * ```\n */\nexport async function handleToolCall(\n  name: string,\n  params: Record<string, unknown>,\n): Promise<unknown> {\n  const tool = SOLFACE_TOOLS.find((t) => t.name === name);\n  if (!tool) {\n    throw new Error(`Unknown SolFace tool: \"${name}\". Available: ${SOLFACE_TOOLS.map((t) => t.name).join(\", \")}`);\n  }\n  return tool.handler(params);\n}\n\n// ─── MCP Format ─────────────────────────────────\n// Model Context Protocol (Claude Code, Cursor, Windsurf)\n\nexport interface MCPTool {\n  name: string;\n  description: string;\n  inputSchema: JSONSchema;\n}\n\nexport function toMCP(tool: SolFaceTool): MCPTool {\n  return {\n    name: tool.name,\n    description: tool.description,\n    inputSchema: tool.parameters,\n  };\n}\n\nexport function allToolsMCP(): MCPTool[] {\n  return SOLFACE_TOOLS.map(toMCP);\n}\n\n// ─── OpenAI Format ──────────────────────────────\n// OpenAI function calling / GPT Actions\n\nexport interface OpenAITool {\n  type: \"function\";\n  function: {\n    name: string;\n    description: string;\n    parameters: JSONSchema;\n  };\n}\n\nexport function toOpenAI(tool: SolFaceTool): OpenAITool {\n  return {\n    type: \"function\",\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: tool.parameters,\n    },\n  };\n}\n\nexport function allToolsOpenAI(): OpenAITool[] {\n  return SOLFACE_TOOLS.map(toOpenAI);\n}\n\n// ─── Anthropic Format ───────────────────────────\n// Anthropic tool use (Claude API)\n\nexport interface AnthropicTool {\n  name: string;\n  description: string;\n  input_schema: JSONSchema;\n}\n\nexport function toAnthropic(tool: SolFaceTool): AnthropicTool {\n  return {\n    name: tool.name,\n    description: tool.description,\n    input_schema: tool.parameters,\n  };\n}\n\nexport function allToolsAnthropic(): AnthropicTool[] {\n  return SOLFACE_TOOLS.map(toAnthropic);\n}\n\n// ─── Vercel AI SDK Format ───────────────────────\n// For use with Vercel AI SDK's `tool()` helper\n\nexport interface VercelAITool {\n  description: string;\n  parameters: JSONSchema;\n  execute: (params: Record<string, unknown>) => Promise<unknown>;\n}\n\nexport function toVercelAI(tool: SolFaceTool): VercelAITool {\n  return {\n    description: tool.description,\n    parameters: tool.parameters,\n    execute: async (params) => tool.handler(params),\n  };\n}\n\nexport function allToolsVercelAI(): Record<string, VercelAITool> {\n  const result: Record<string, VercelAITool> = {};\n  for (const tool of SOLFACE_TOOLS) {\n    result[tool.name] = toVercelAI(tool);\n  }\n  return result;\n}\n"]}

package/dist/chunk-46ZEFA6R.cjs

@@ -0,0 +1,243 @@
+'use strict';
+
+var chunk6UWILY7E_cjs = require('./chunk-6UWILY7E.cjs');
+
+// src/core/describe.ts
+var SKIN_TONES = {
+  0: "porcelain",
+  1: "ivory",
+  2: "fair",
+  3: "light",
+  4: "sand",
+  5: "golden",
+  6: "warm",
+  7: "caramel",
+  8: "brown",
+  9: "deep"
+};
+var EYE_STYLES = {
+  0: "round, wide-open",
+  1: "small and minimal",
+  2: "almond-shaped",
+  3: "wide and expressive",
+  4: "relaxed, half-lidded",
+  5: "joyful, crescent-shaped",
+  6: "bright and sparkling",
+  7: "gentle and narrow"
+};
+var EYE_COLORS_DESC = {
+  0: "dark brown",
+  1: "blue",
+  2: "green",
+  3: "hazel",
+  4: "gray"
+};
+var EYEBROW_STYLES = {
+  0: "wispy",
+  1: "straight",
+  2: "natural",
+  3: "elegantly arched",
+  4: "sharply angled"
+};
+var NOSE_STYLES = {
+  0: "a subtle shadow nose",
+  1: "a small button nose",
+  2: "a soft curved nose",
+  3: "a button nose with visible nostrils"
+};
+var MOUTH_STYLES = {
+  0: "a gentle smile",
+  1: "a calm, neutral expression",
+  2: "a happy grin",
+  3: "a surprised O-shaped mouth",
+  4: "a confident smirk",
+  5: "a wide, toothy grin",
+  6: "a flat, straight expression",
+  7: "a soft pout"
+};
+var HAIR_STYLES = {
+  0: "bald, with no hair",
+  1: "short, neatly cropped hair",
+  2: "bouncy, curly hair",
+  3: "side-swept hair",
+  4: "a voluminous puff",
+  5: "long hair that falls past the shoulders",
+  6: "a clean bob cut",
+  7: "a close buzz cut",
+  8: "flowing, wavy hair",
+  9: "a neat topknot"
+};
+var HAIR_COLORS_DESC = {
+  0: "jet black",
+  1: "espresso brown",
+  2: "walnut",
+  3: "honey blonde",
+  4: "copper red",
+  5: "silver",
+  6: "charcoal",
+  7: "burgundy",
+  8: "strawberry",
+  9: "ginger"
+};
+var ACCESSORY_DESC = {
+  0: "",
+  1: "a beauty mark",
+  2: "round glasses",
+  3: "rectangular glasses",
+  4: "a dangling earring",
+  5: "a headband",
+  6: "freckles",
+  7: "stud earrings",
+  8: "aviator sunglasses",
+  9: "a band-aid"
+};
+var BG_COLORS_DESC = {
+  0: "rose",
+  1: "olive",
+  2: "sage",
+  3: "fern",
+  4: "mint",
+  5: "ocean",
+  6: "sky",
+  7: "lavender",
+  8: "orchid",
+  9: "blush"
+};
+function describeAppearance(walletAddress, options) {
+  const traits = chunk6UWILY7E_cjs.generateTraits(walletAddress);
+  const {
+    includeBackground = true,
+    format = "paragraph",
+    perspective = "third",
+    name
+  } = options ?? {};
+  if (format === "structured") return buildStructured(traits, includeBackground);
+  if (format === "compact") return buildCompact(traits);
+  return buildParagraph(traits, perspective, name, includeBackground);
+}
+function describeTraits(traits, options) {
+  const {
+    includeBackground = true,
+    format = "paragraph",
+    perspective = "third",
+    name
+  } = options ?? {};
+  if (format === "structured") return buildStructured(traits, includeBackground);
+  if (format === "compact") return buildCompact(traits);
+  return buildParagraph(traits, perspective, name, includeBackground);
+}
+function buildParagraph(t, perspective, name, includeBg) {
+  const parts = [];
+  const ai = chunk6UWILY7E_cjs.effectiveAccessory(t);
+  const subject = perspective === "first" ? name ? `I'm ${name}. I have` : "I have" : name ? `${name} has` : "This SolFace has";
+  const im = perspective === "first" ? "I'm" : "They're";
+  parts.push(`${subject} a squircle face with ${SKIN_TONES[t.skinColor] ?? "warm"} skin`);
+  const eyeStyle = EYE_STYLES[t.eyeStyle] ?? "round";
+  const eyeColor = EYE_COLORS_DESC[t.eyeColor] ?? "dark";
+  parts.push(`${eyeStyle} ${eyeColor} eyes`);
+  const brows = EYEBROW_STYLES[t.eyebrows];
+  if (brows) parts.push(`${brows} eyebrows`);
+  const hairStyle = HAIR_STYLES[t.hairStyle] ?? "";
+  const hairColor = HAIR_COLORS_DESC[t.hairColor] ?? "";
+  if (t.hairStyle === 0) {
+    parts.push("and is bald");
+  } else if (hairStyle.startsWith("a ")) {
+    parts.push(`and a ${hairColor} ${hairStyle.slice(2)}`);
+  } else {
+    parts.push(`and ${hairColor} ${hairStyle}`);
+  }
+  let desc = parts[0];
+  if (parts.length > 2) {
+    desc += ", " + parts.slice(1, -1).join(", ") + ", " + parts[parts.length - 1];
+  } else if (parts.length === 2) {
+    desc += " and " + parts[1];
+  }
+  desc += ".";
+  const nose = NOSE_STYLES[t.nose];
+  if (nose) {
+    const noseSubject = perspective === "first" ? "I have" : (name ?? "They") + (name ? " has" : " have");
+    desc += ` ${noseSubject} ${nose}.`;
+  }
+  const acc = ACCESSORY_DESC[ai];
+  if (acc) {
+    desc += ` ${im} wearing ${acc}.`;
+  }
+  const mouth = MOUTH_STYLES[t.mouth] ?? "a smile";
+  const mouthVerb = perspective === "first" ? "I have" : (name ?? "They") + (name ? " has" : " have");
+  desc += ` ${mouthVerb} ${mouth}.`;
+  if (includeBg) {
+    const bg = BG_COLORS_DESC[t.bgColor] ?? "colorful";
+    desc += ` The background is ${bg}.`;
+  }
+  return desc;
+}
+function buildStructured(t, includeBg) {
+  const ai = chunk6UWILY7E_cjs.effectiveAccessory(t);
+  const lines = [
+    `Face: squircle`,
+    `Skin: ${SKIN_TONES[t.skinColor] ?? "warm"}`,
+    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? "round"}, ${EYE_COLORS_DESC[t.eyeColor] ?? "dark"}`,
+    `Eyebrows: ${EYEBROW_STYLES[t.eyebrows] ?? "wispy"}`
+  ];
+  const nose = NOSE_STYLES[t.nose];
+  if (nose) lines.push(`Nose: ${nose.replace(/^a /, "")}`);
+  lines.push(`Mouth: ${MOUTH_STYLES[t.mouth] ?? "smile"}`);
+  if (t.hairStyle === 0) {
+    lines.push("Hair: bald");
+  } else {
+    const hs = HAIR_STYLES[t.hairStyle] ?? "";
+    const hc = HAIR_COLORS_DESC[t.hairColor] ?? "";
+    lines.push(`Hair: ${hc} ${hs.startsWith("a ") ? hs.slice(2) : hs}`);
+  }
+  const acc = ACCESSORY_DESC[ai];
+  if (acc) lines.push(`Accessory: ${acc}`);
+  if (includeBg) {
+    lines.push(`Background: ${BG_COLORS_DESC[t.bgColor] ?? "colorful"}`);
+  }
+  return lines.join("\n");
+}
+function buildCompact(t) {
+  const ai = chunk6UWILY7E_cjs.effectiveAccessory(t);
+  const parts = [];
+  parts.push(`squircle face`);
+  parts.push(`${SKIN_TONES[t.skinColor] ?? "warm"} skin`);
+  parts.push(`${EYE_COLORS_DESC[t.eyeColor] ?? "dark"} ${EYE_STYLES[t.eyeStyle] ?? "round"} eyes`);
+  if (t.hairStyle === 0) {
+    parts.push("bald");
+  } else {
+    const hs = (HAIR_STYLES[t.hairStyle] ?? "hair").replace(/,.*/, "");
+    const hc = HAIR_COLORS_DESC[t.hairColor] ?? "";
+    parts.push(`${hc} ${hs.startsWith("a ") ? hs.slice(2) : hs}`);
+  }
+  const acc = ACCESSORY_DESC[ai];
+  if (acc) parts.push(acc);
+  parts.push((MOUTH_STYLES[t.mouth] ?? "smiling").replace(/^a /, ""));
+  return parts.join(", ");
+}
+function solFaceAltText(walletAddress) {
+  return `SolFace avatar: ${describeAppearance(walletAddress, { format: "compact", includeBackground: false })}`;
+}
+function agentAppearancePrompt(walletAddress, agentName) {
+  const desc = describeAppearance(walletAddress, {
+    perspective: "first",
+    name: agentName,
+    includeBackground: false,
+    format: "paragraph"
+  });
+  const hash = (djb2Simple(walletAddress) >>> 0).toString(16).padStart(8, "0");
+  return `My visual identity is a SolFace avatar (ID: ${hash}) derived from my wallet address. ${desc} This appearance is deterministic \u2014 anyone who looks up my wallet will see the same face.`;
+}
+function djb2Simple(str) {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) + hash + str.charCodeAt(i) | 0;
+  }
+  return hash >>> 0;
+}
+
+exports.agentAppearancePrompt = agentAppearancePrompt;
+exports.describeAppearance = describeAppearance;
+exports.describeTraits = describeTraits;
+exports.solFaceAltText = solFaceAltText;
+//# sourceMappingURL=chunk-46ZEFA6R.cjs.map
+//# sourceMappingURL=chunk-46ZEFA6R.cjs.map

package/dist/chunk-46ZEFA6R.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/describe.ts"],"names":["generateTraits","effectiveAccessory"],"mappings":"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","file":"chunk-46ZEFA6R.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — AI Agent Description Generator\n// Produces natural language descriptions of a wallet's SolFace\n// for use in system prompts, bios, and self-reference.\n// ═══════════════════════════════════════════════════════════════\n\nimport { generateTraits, effectiveAccessory, type SolFaceTraits } from \"./traits\";\n\n// ─── Vocabulary Maps ─────────────────────────────────────────\n\nconst SKIN_TONES: Record<number, string> = {\n  0: \"porcelain\",\n  1: \"ivory\",\n  2: \"fair\",\n  3: \"light\",\n  4: \"sand\",\n  5: \"golden\",\n  6: \"warm\",\n  7: \"caramel\",\n  8: \"brown\",\n  9: \"deep\",\n};\n\nconst EYE_STYLES: Record<number, string> = {\n  0: \"round, wide-open\",\n  1: \"small and minimal\",\n  2: \"almond-shaped\",\n  3: \"wide and expressive\",\n  4: \"relaxed, half-lidded\",\n  5: \"joyful, crescent-shaped\",\n  6: \"bright and sparkling\",\n  7: \"gentle and narrow\",\n};\n\nconst EYE_COLORS_DESC: Record<number, string> = {\n  0: \"dark brown\",\n  1: \"blue\",\n  2: \"green\",\n  3: \"hazel\",\n  4: \"gray\",\n};\n\nconst EYEBROW_STYLES: Record<number, string> = {\n  0: \"wispy\",\n  1: \"straight\",\n  2: \"natural\",\n  3: \"elegantly arched\",\n  4: \"sharply angled\",\n};\n\nconst NOSE_STYLES: Record<number, string> = {\n  0: \"a subtle shadow nose\",\n  1: \"a small button nose\",\n  2: \"a soft curved nose\",\n  3: \"a button nose with visible nostrils\",\n};\n\nconst MOUTH_STYLES: Record<number, string> = {\n  0: \"a gentle smile\",\n  1: \"a calm, neutral expression\",\n  2: \"a happy grin\",\n  3: \"a surprised O-shaped mouth\",\n  4: \"a confident smirk\",\n  5: \"a wide, toothy grin\",\n  6: \"a flat, straight expression\",\n  7: \"a soft pout\",\n};\n\nconst HAIR_STYLES: Record<number, string> = {\n  0: \"bald, with no hair\",\n  1: \"short, neatly cropped hair\",\n  2: \"bouncy, curly hair\",\n  3: \"side-swept hair\",\n  4: \"a voluminous puff\",\n  5: \"long hair that falls past the shoulders\",\n  6: \"a clean bob cut\",\n  7: \"a close buzz cut\",\n  8: \"flowing, wavy hair\",\n  9: \"a neat topknot\",\n};\n\nconst HAIR_COLORS_DESC: Record<number, string> = {\n  0: \"jet black\",\n  1: \"espresso brown\",\n  2: \"walnut\",\n  3: \"honey blonde\",\n  4: \"copper red\",\n  5: \"silver\",\n  6: \"charcoal\",\n  7: \"burgundy\",\n  8: \"strawberry\",\n  9: \"ginger\",\n};\n\nconst ACCESSORY_DESC: Record<number, string> = {\n  0: \"\",\n  1: \"a beauty mark\",\n  2: \"round glasses\",\n  3: \"rectangular glasses\",\n  4: \"a dangling earring\",\n  5: \"a headband\",\n  6: \"freckles\",\n  7: \"stud earrings\",\n  8: \"aviator sunglasses\",\n  9: \"a band-aid\",\n};\n\nconst BG_COLORS_DESC: Record<number, string> = {\n  0: \"rose\",\n  1: \"olive\",\n  2: \"sage\",\n  3: \"fern\",\n  4: \"mint\",\n  5: \"ocean\",\n  6: \"sky\",\n  7: \"lavender\",\n  8: \"orchid\",\n  9: \"blush\",\n};\n\n// ─── Description Builder ─────────────────────────────────────\n\nexport interface DescribeOptions {\n  includeBackground?: boolean;\n  format?: \"paragraph\" | \"structured\" | \"compact\";\n  perspective?: \"first\" | \"third\";\n  name?: string;\n}\n\nexport function describeAppearance(\n  walletAddress: string,\n  options?: DescribeOptions,\n): string {\n  const traits = generateTraits(walletAddress);\n  const {\n    includeBackground = true,\n    format = \"paragraph\",\n    perspective = \"third\",\n    name,\n  } = options ?? {};\n\n  if (format === \"structured\") return buildStructured(traits, includeBackground);\n  if (format === \"compact\") return buildCompact(traits);\n  return buildParagraph(traits, perspective, name, includeBackground);\n}\n\nexport function describeTraits(\n  traits: SolFaceTraits,\n  options?: DescribeOptions,\n): string {\n  const {\n    includeBackground = true,\n    format = \"paragraph\",\n    perspective = \"third\",\n    name,\n  } = options ?? {};\n\n  if (format === \"structured\") return buildStructured(traits, includeBackground);\n  if (format === \"compact\") return buildCompact(traits);\n  return buildParagraph(traits, perspective, name, includeBackground);\n}\n\n// ─── Builders ────────────────────────────────────────────────\n\nfunction buildParagraph(\n  t: SolFaceTraits,\n  perspective: \"first\" | \"third\",\n  name?: string,\n  includeBg?: boolean,\n): string {\n  const parts: string[] = [];\n  const ai = effectiveAccessory(t);\n\n  const subject = perspective === \"first\"\n    ? (name ? `I'm ${name}. I have` : \"I have\")\n    : (name ? `${name} has` : \"This SolFace has\");\n\n  const im = perspective === \"first\" ? \"I'm\" : \"They're\";\n\n  // Face + skin (all squircle now)\n  parts.push(`${subject} a squircle face with ${SKIN_TONES[t.skinColor] ?? \"warm\"} skin`);\n\n  // Eyes\n  const eyeStyle = EYE_STYLES[t.eyeStyle] ?? \"round\";\n  const eyeColor = EYE_COLORS_DESC[t.eyeColor] ?? \"dark\";\n  parts.push(`${eyeStyle} ${eyeColor} eyes`);\n\n  // Eyebrows\n  const brows = EYEBROW_STYLES[t.eyebrows];\n  if (brows) parts.push(`${brows} eyebrows`);\n\n  // Hair\n  const hairStyle = HAIR_STYLES[t.hairStyle] ?? \"\";\n  const hairColor = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n  if (t.hairStyle === 0) {\n    parts.push(\"and is bald\");\n  } else if (hairStyle.startsWith(\"a \")) {\n    parts.push(`and a ${hairColor} ${hairStyle.slice(2)}`);\n  } else {\n    parts.push(`and ${hairColor} ${hairStyle}`);\n  }\n\n  // Build main sentence\n  let desc = parts[0];\n  if (parts.length > 2) {\n    desc += \", \" + parts.slice(1, -1).join(\", \") + \", \" + parts[parts.length - 1];\n  } else if (parts.length === 2) {\n    desc += \" and \" + parts[1];\n  }\n  desc += \".\";\n\n  // Nose\n  const nose = NOSE_STYLES[t.nose];\n  if (nose) {\n    const noseSubject = perspective === \"first\"\n      ? \"I have\"\n      : (name ?? \"They\") + (name ? \" has\" : \" have\");\n    desc += ` ${noseSubject} ${nose}.`;\n  }\n\n  // Accessory\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) {\n    desc += ` ${im} wearing ${acc}.`;\n  }\n\n  // Mouth\n  const mouth = MOUTH_STYLES[t.mouth] ?? \"a smile\";\n  const mouthVerb = perspective === \"first\"\n    ? \"I have\"\n    : (name ?? \"They\") + (name ? \" has\" : \" have\");\n  desc += ` ${mouthVerb} ${mouth}.`;\n\n  // Background\n  if (includeBg) {\n    const bg = BG_COLORS_DESC[t.bgColor] ?? \"colorful\";\n    desc += ` The background is ${bg}.`;\n  }\n\n  return desc;\n}\n\nfunction buildStructured(t: SolFaceTraits, includeBg: boolean): string {\n  const ai = effectiveAccessory(t);\n  const lines: string[] = [\n    `Face: squircle`,\n    `Skin: ${SKIN_TONES[t.skinColor] ?? \"warm\"}`,\n    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? \"round\"}, ${EYE_COLORS_DESC[t.eyeColor] ?? \"dark\"}`,\n    `Eyebrows: ${EYEBROW_STYLES[t.eyebrows] ?? \"wispy\"}`,\n  ];\n\n  const nose = NOSE_STYLES[t.nose];\n  if (nose) lines.push(`Nose: ${nose.replace(/^a /, \"\")}`);\n\n  lines.push(`Mouth: ${MOUTH_STYLES[t.mouth] ?? \"smile\"}`);\n\n  if (t.hairStyle === 0) {\n    lines.push(\"Hair: bald\");\n  } else {\n    const hs = HAIR_STYLES[t.hairStyle] ?? \"\";\n    const hc = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n    lines.push(`Hair: ${hc} ${hs.startsWith(\"a \") ? hs.slice(2) : hs}`);\n  }\n\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) lines.push(`Accessory: ${acc}`);\n\n  if (includeBg) {\n    lines.push(`Background: ${BG_COLORS_DESC[t.bgColor] ?? \"colorful\"}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction buildCompact(t: SolFaceTraits): string {\n  const ai = effectiveAccessory(t);\n  const parts: string[] = [];\n\n  parts.push(`squircle face`);\n  parts.push(`${SKIN_TONES[t.skinColor] ?? \"warm\"} skin`);\n  parts.push(`${EYE_COLORS_DESC[t.eyeColor] ?? \"dark\"} ${EYE_STYLES[t.eyeStyle] ?? \"round\"} eyes`);\n\n  if (t.hairStyle === 0) {\n    parts.push(\"bald\");\n  } else {\n    const hs = (HAIR_STYLES[t.hairStyle] ?? \"hair\").replace(/,.*/, \"\");\n    const hc = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n    parts.push(`${hc} ${hs.startsWith(\"a \") ? hs.slice(2) : hs}`);\n  }\n\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) parts.push(acc);\n\n  parts.push((MOUTH_STYLES[t.mouth] ?? \"smiling\").replace(/^a /, \"\"));\n\n  return parts.join(\", \");\n}\n\n// ─── Alt Text Helper ─────────────────────────────────────────\n\nexport function solFaceAltText(walletAddress: string): string {\n  return `SolFace avatar: ${describeAppearance(walletAddress, { format: \"compact\", includeBackground: false })}`;\n}\n\n// ─── System Prompt Helper ────────────────────────────────────\n\nexport function agentAppearancePrompt(\n  walletAddress: string,\n  agentName?: string,\n): string {\n  const desc = describeAppearance(walletAddress, {\n    perspective: \"first\",\n    name: agentName,\n    includeBackground: false,\n    format: \"paragraph\",\n  });\n\n  const hash = (djb2Simple(walletAddress) >>> 0).toString(16).padStart(8, \"0\");\n\n  return `My visual identity is a SolFace avatar (ID: ${hash}) derived from my wallet address. ${desc} This appearance is deterministic — anyone who looks up my wallet will see the same face.`;\n}\n\n// Inline djb2 to avoid circular dependency\nfunction djb2Simple(str: string): number {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash + str.charCodeAt(i)) | 0;\n  }\n  return hash >>> 0;\n}\n"]}

package/dist/{chunk-A6N3RPEA.cjs → chunk-546TBMAR.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkH3SK3MNX_cjs = require('./chunk-H3SK3MNX.cjs');
+var chunk6UWILY7E_cjs = require('./chunk-6UWILY7E.cjs');
 
 // src/core/rasterize.ts
 async function renderSolFacePNG(walletAddress, options) {
   const { pngSize = 256, ...renderOpts } = options ?? {};
-  const svg = chunkH3SK3MNX_cjs.renderSolFaceSVG(walletAddress, {
+  const svg = chunk6UWILY7E_cjs.renderSolFaceSVG(walletAddress, {
     ...renderOpts,
     size: pngSize
   });
@@ -30,7 +30,7 @@ async function renderSolFacePNG(walletAddress, options) {
 }
 async function renderSolFacePNGBrowser(walletAddress, options) {
   const { pngSize = 256, ...renderOpts } = options ?? {};
-  const svg = chunkH3SK3MNX_cjs.renderSolFaceSVG(walletAddress, {
+  const svg = chunk6UWILY7E_cjs.renderSolFaceSVG(walletAddress, {
     ...renderOpts,
     size: pngSize
   });
@@ -75,7 +75,7 @@ async function renderSolFacePNGBrowser(walletAddress, options) {
 }
 async function renderSolFacePNGDataURL(walletAddress, options) {
   const { pngSize = 256, ...renderOpts } = options ?? {};
-  const svg = chunkH3SK3MNX_cjs.renderSolFaceSVG(walletAddress, {
+  const svg = chunk6UWILY7E_cjs.renderSolFaceSVG(walletAddress, {
     ...renderOpts,
     size: pngSize
   });
@@ -107,5 +107,5 @@ async function renderSolFacePNGDataURL(walletAddress, options) {
 exports.renderSolFacePNG = renderSolFacePNG;
 exports.renderSolFacePNGBrowser = renderSolFacePNGBrowser;
 exports.renderSolFacePNGDataURL = renderSolFacePNGDataURL;
-//# sourceMappingURL=chunk-A6N3RPEA.cjs.map
-//# sourceMappingURL=chunk-A6N3RPEA.cjs.map
+//# sourceMappingURL=chunk-546TBMAR.cjs.map
+//# sourceMappingURL=chunk-546TBMAR.cjs.map

package/dist/{chunk-A6N3RPEA.cjs.map → chunk-546TBMAR.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/rasterize.ts"],"names":["renderSolFaceSVG"],"mappings":"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","file":"chunk-A6N3RPEA.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — PNG Rasterizer\n// Converts SolFace SVGs to PNG buffers for use in bots, APIs,\n// Discord embeds, Telegram, emails, and non-SVG contexts.\n//\n// Works in:\n//   - Node.js (via sharp or canvas fallback)\n//   - Browser (via OffscreenCanvas or <canvas>)\n//   - Edge functions (via resvg-wasm)\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, type RenderOptions } from \"./renderer\";\n\nexport interface PNGOptions extends RenderOptions {\n  /** Output pixel size (both width and height). Default: 256 */\n  pngSize?: number;\n  /** PNG quality (0-1, only affects some renderers). Default: 1 */\n  quality?: number;\n}\n\n// ─── Node.js Rasterization ───────────────────────────────────\n\n/**\n * Render a SolFace as a PNG Buffer using `sharp`.\n * Requires: `npm install sharp`\n *\n * @returns PNG buffer\n *\n * @example\n * ```ts\n * import { renderSolFacePNG } from \"solfaces/core/rasterize\";\n *\n * const png = await renderSolFacePNG(\"7xKXq...\", { pngSize: 256 });\n * fs.writeFileSync(\"avatar.png\", png);\n * ```\n */\nexport async function renderSolFacePNG(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<Buffer> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  // Generate SVG at the target resolution\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n  const svgBuffer = Buffer.from(svg);\n\n  // Try sharp first (best quality, most common in Node)\n  try {\n    const sharp = await import(\"sharp\");\n    return await sharp\n      .default(svgBuffer)\n      .resize(pngSize, pngSize)\n      .png()\n      .toBuffer();\n  } catch {\n    // sharp not installed — fall through\n  }\n\n  // Try @resvg/resvg-js (good for edge/serverless)\n  try {\n    const { Resvg } = await import(\"@resvg/resvg-js\");\n    const resvg = new Resvg(svg, {\n      fitTo: { mode: \"width\", value: pngSize },\n    });\n    const pngData = resvg.render();\n    return Buffer.from(pngData.asPng());\n  } catch {\n    // resvg not installed\n  }\n\n  throw new Error(\n    \"[SolFaces] PNG rasterization requires either `sharp` or `@resvg/resvg-js`. \" +\n    \"Install one: npm install sharp  OR  npm install @resvg/resvg-js\"\n  );\n}\n\n// ─── Browser Rasterization ───────────────────────────────────\n\n/**\n * Render a SolFace as a PNG Blob in the browser.\n * Uses Canvas API — works in all modern browsers.\n *\n * @returns PNG Blob\n *\n * @example\n * ```ts\n * const blob = await renderSolFacePNGBrowser(\"7xKXq...\", { pngSize: 256 });\n * const url = URL.createObjectURL(blob);\n * img.src = url;\n * ```\n */\nexport async function renderSolFacePNGBrowser(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<Blob> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n\n  // Create image from SVG data URI\n  const svgBlob = new Blob([svg], { type: \"image/svg+xml;charset=utf-8\" });\n  const url = URL.createObjectURL(svgBlob);\n\n  return new Promise<Blob>((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      // Use OffscreenCanvas if available (better perf)\n      let canvas: HTMLCanvasElement | OffscreenCanvas;\n      let ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D | null;\n\n      if (typeof OffscreenCanvas !== \"undefined\") {\n        canvas = new OffscreenCanvas(pngSize, pngSize);\n        ctx = canvas.getContext(\"2d\");\n      } else {\n        canvas = document.createElement(\"canvas\");\n        canvas.width = pngSize;\n        canvas.height = pngSize;\n        ctx = canvas.getContext(\"2d\");\n      }\n\n      if (!ctx) {\n        URL.revokeObjectURL(url);\n        reject(new Error(\"[SolFaces] Could not get canvas context\"));\n        return;\n      }\n\n      ctx.drawImage(img, 0, 0, pngSize, pngSize);\n      URL.revokeObjectURL(url);\n\n      if (canvas instanceof OffscreenCanvas) {\n        canvas.convertToBlob({ type: \"image/png\" }).then(resolve).catch(reject);\n      } else {\n        canvas.toBlob((blob) => {\n          if (blob) resolve(blob);\n          else reject(new Error(\"[SolFaces] Canvas toBlob failed\"));\n        }, \"image/png\");\n      }\n    };\n\n    img.onerror = () => {\n      URL.revokeObjectURL(url);\n      reject(new Error(\"[SolFaces] Failed to load SVG into image\"));\n    };\n\n    img.src = url;\n  });\n}\n\n/**\n * Render a SolFace as a PNG data URL in the browser.\n * Convenient for directly setting img.src without blob URLs.\n */\nexport async function renderSolFacePNGDataURL(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<string> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n\n  const svgBlob = new Blob([svg], { type: \"image/svg+xml;charset=utf-8\" });\n  const url = URL.createObjectURL(svgBlob);\n\n  return new Promise<string>((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      const canvas = document.createElement(\"canvas\");\n      canvas.width = pngSize;\n      canvas.height = pngSize;\n      const ctx = canvas.getContext(\"2d\");\n      if (!ctx) {\n        reject(new Error(\"[SolFaces] No canvas context\"));\n        return;\n      }\n      ctx.drawImage(img, 0, 0, pngSize, pngSize);\n      URL.revokeObjectURL(url);\n      resolve(canvas.toDataURL(\"image/png\"));\n    };\n    img.onerror = () => {\n      URL.revokeObjectURL(url);\n      reject(new Error(\"[SolFaces] SVG load failed\"));\n    };\n    img.src = url;\n  });\n}\n"]}
+{"version":3,"sources":["../src/core/rasterize.ts"],"names":["renderSolFaceSVG"],"mappings":"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","file":"chunk-546TBMAR.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — PNG Rasterizer\n// Converts SolFace SVGs to PNG buffers for use in bots, APIs,\n// Discord embeds, Telegram, emails, and non-SVG contexts.\n//\n// Works in:\n//   - Node.js (via sharp or canvas fallback)\n//   - Browser (via OffscreenCanvas or <canvas>)\n//   - Edge functions (via resvg-wasm)\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, type RenderOptions } from \"./renderer\";\n\nexport interface PNGOptions extends RenderOptions {\n  /** Output pixel size (both width and height). Default: 256 */\n  pngSize?: number;\n  /** PNG quality (0-1, only affects some renderers). Default: 1 */\n  quality?: number;\n}\n\n// ─── Node.js Rasterization ───────────────────────────────────\n\n/**\n * Render a SolFace as a PNG Buffer using `sharp`.\n * Requires: `npm install sharp`\n *\n * @returns PNG buffer\n *\n * @example\n * ```ts\n * import { renderSolFacePNG } from \"solfaces/core/rasterize\";\n *\n * const png = await renderSolFacePNG(\"7xKXq...\", { pngSize: 256 });\n * fs.writeFileSync(\"avatar.png\", png);\n * ```\n */\nexport async function renderSolFacePNG(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<Buffer> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  // Generate SVG at the target resolution\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n  const svgBuffer = Buffer.from(svg);\n\n  // Try sharp first (best quality, most common in Node)\n  try {\n    const sharp = await import(\"sharp\");\n    return await sharp\n      .default(svgBuffer)\n      .resize(pngSize, pngSize)\n      .png()\n      .toBuffer();\n  } catch {\n    // sharp not installed — fall through\n  }\n\n  // Try @resvg/resvg-js (good for edge/serverless)\n  try {\n    const { Resvg } = await import(\"@resvg/resvg-js\");\n    const resvg = new Resvg(svg, {\n      fitTo: { mode: \"width\", value: pngSize },\n    });\n    const pngData = resvg.render();\n    return Buffer.from(pngData.asPng());\n  } catch {\n    // resvg not installed\n  }\n\n  throw new Error(\n    \"[SolFaces] PNG rasterization requires either `sharp` or `@resvg/resvg-js`. \" +\n    \"Install one: npm install sharp  OR  npm install @resvg/resvg-js\"\n  );\n}\n\n// ─── Browser Rasterization ───────────────────────────────────\n\n/**\n * Render a SolFace as a PNG Blob in the browser.\n * Uses Canvas API — works in all modern browsers.\n *\n * @returns PNG Blob\n *\n * @example\n * ```ts\n * const blob = await renderSolFacePNGBrowser(\"7xKXq...\", { pngSize: 256 });\n * const url = URL.createObjectURL(blob);\n * img.src = url;\n * ```\n */\nexport async function renderSolFacePNGBrowser(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<Blob> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n\n  // Create image from SVG data URI\n  const svgBlob = new Blob([svg], { type: \"image/svg+xml;charset=utf-8\" });\n  const url = URL.createObjectURL(svgBlob);\n\n  return new Promise<Blob>((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      // Use OffscreenCanvas if available (better perf)\n      let canvas: HTMLCanvasElement | OffscreenCanvas;\n      let ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D | null;\n\n      if (typeof OffscreenCanvas !== \"undefined\") {\n        canvas = new OffscreenCanvas(pngSize, pngSize);\n        ctx = canvas.getContext(\"2d\");\n      } else {\n        canvas = document.createElement(\"canvas\");\n        canvas.width = pngSize;\n        canvas.height = pngSize;\n        ctx = canvas.getContext(\"2d\");\n      }\n\n      if (!ctx) {\n        URL.revokeObjectURL(url);\n        reject(new Error(\"[SolFaces] Could not get canvas context\"));\n        return;\n      }\n\n      ctx.drawImage(img, 0, 0, pngSize, pngSize);\n      URL.revokeObjectURL(url);\n\n      if (canvas instanceof OffscreenCanvas) {\n        canvas.convertToBlob({ type: \"image/png\" }).then(resolve).catch(reject);\n      } else {\n        canvas.toBlob((blob) => {\n          if (blob) resolve(blob);\n          else reject(new Error(\"[SolFaces] Canvas toBlob failed\"));\n        }, \"image/png\");\n      }\n    };\n\n    img.onerror = () => {\n      URL.revokeObjectURL(url);\n      reject(new Error(\"[SolFaces] Failed to load SVG into image\"));\n    };\n\n    img.src = url;\n  });\n}\n\n/**\n * Render a SolFace as a PNG data URL in the browser.\n * Convenient for directly setting img.src without blob URLs.\n */\nexport async function renderSolFacePNGDataURL(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<string> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n\n  const svgBlob = new Blob([svg], { type: \"image/svg+xml;charset=utf-8\" });\n  const url = URL.createObjectURL(svgBlob);\n\n  return new Promise<string>((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      const canvas = document.createElement(\"canvas\");\n      canvas.width = pngSize;\n      canvas.height = pngSize;\n      const ctx = canvas.getContext(\"2d\");\n      if (!ctx) {\n        reject(new Error(\"[SolFaces] No canvas context\"));\n        return;\n      }\n      ctx.drawImage(img, 0, 0, pngSize, pngSize);\n      URL.revokeObjectURL(url);\n      resolve(canvas.toDataURL(\"image/png\"));\n    };\n    img.onerror = () => {\n      URL.revokeObjectURL(url);\n      reject(new Error(\"[SolFaces] SVG load failed\"));\n    };\n    img.src = url;\n  });\n}\n"]}