solfaces 2.2.0 → 2.3.0

package/dist/{chunk-F54WHRCE.cjs → chunk-W2U6ITMR.cjs}

@@ -18,7 +18,10 @@ var EYE_COLORS = [
   "#3868A8",
   "#38784C",
   "#808838",
-  "#586878"
+  "#586878",
+  "#A06830",
+  "#685898",
+  "#889898"
 ];
 var HAIR_COLORS = [
   "#1A1A24",
@@ -42,7 +45,9 @@ var BG_COLORS = [
   "#7f8bbd",
   "#8869ab",
   "#b785b3",
-  "#ab6984"
+  "#ab6984",
+  "#a07ab5",
+  "#74b5a0"
 ];
 function djb2(str) {
   let hash = 5381;
@@ -66,22 +71,20 @@ function generateTraits(walletAddress, overrides) {
   const traits = {
     faceShape: Math.floor(rand() * 4),
     skinColor: Math.floor(rand() * 10),
-    eyeStyle: Math.floor(rand() * 8),
-    eyeColor: Math.floor(rand() * 5),
-    eyebrows: Math.floor(rand() * 5),
-    nose: Math.floor(rand() * 4),
+    eyeStyle: Math.floor(rand() * 9),
+    eyeColor: Math.floor(rand() * 8),
+    eyebrows: Math.floor(rand() * 8),
+    nose: Math.floor(rand() * 8),
     mouth: Math.floor(rand() * 8),
     hairStyle: Math.floor(rand() * 10),
     hairColor: Math.floor(rand() * 10),
-    accessory: Math.floor(rand() * 10),
-    bgColor: Math.floor(rand() * 10)
+    accessory: Math.floor(rand() * 12),
+    bgColor: Math.floor(rand() * 12)
   };
   return overrides ? { ...traits, ...overrides } : traits;
 }
 function effectiveAccessory(traits) {
-  const ai = traits.accessory % 10;
-  const hi = traits.hairStyle % 10;
-  if ((ai === 4 || ai === 7) && (hi === 5 || hi === 6)) return 0;
+  const ai = traits.accessory % 12;
   return ai;
 }
 var FACE_LABELS = ["Squircle"];
@@ -97,22 +100,22 @@ var SKIN_LABELS = [
   "Brown",
   "Deep"
 ];
-var EYE_STYLE_LABELS = ["Round", "Minimal", "Almond", "Wide", "Relaxed", "Joyful", "Bright", "Gentle"];
-var EYE_COLOR_LABELS = ["Chocolate", "Sky", "Emerald", "Hazel", "Storm"];
-var BROW_LABELS = ["Wispy", "Straight", "Natural", "Arched", "Angled"];
-var NOSE_LABELS = ["Shadow", "Button", "Soft", "Nostrils"];
+var EYE_STYLE_LABELS = ["Round", "Minimal", "Almond", "Wide", "Relaxed", "Joyful", "Bright", "Gentle", "Side-look"];
+var EYE_COLOR_LABELS = ["Chocolate", "Sky", "Emerald", "Hazel", "Storm", "Amber", "Violet", "Gray"];
+var BROW_LABELS = ["Wispy", "Straight", "Natural", "Arched", "Angled", "Worried", "Bushy", "Thin"];
+var NOSE_LABELS = ["Shadow", "Button", "Soft", "Nostrils", "Pointed", "Wide", "Bridge", "Snub"];
 var MOUTH_LABELS = ["Smile", "Calm", "Happy", "Oh", "Smirk", "Grin", "Flat", "Pout"];
 var HAIR_STYLE_LABELS = [
   "Bald",
-  "Short",
+  "Crew",
   "Curly",
-  "Side Sweep",
-  "Puff",
+  "Side Part",
   "Long",
-  "Bob",
   "Buzz",
-  "Wavy",
-  "Topknot"
+  "Beanie",
+  "Cap",
+  "Mohawk",
+  "Bun"
 ];
 var HAIR_COLOR_LABELS = [
   "Black",
@@ -136,7 +139,9 @@ var ACCESSORY_LABELS = [
   "Freckles",
   "Stud Earrings",
   "Aviators",
-  "Band-Aid"
+  "Band-Aid",
+  "Left Eyebrow Slit",
+  "Right Eyebrow Slit"
 ];
 var BG_COLOR_LABELS = [
   "Rose",
@@ -148,7 +153,9 @@ var BG_COLOR_LABELS = [
   "Sky",
   "Lavender",
   "Orchid",
-  "Blush"
+  "Blush",
+  "Lilac",
+  "Seafoam"
 ];
 function getTraitLabels(traits) {
   return {
@@ -211,7 +218,21 @@ function blend(a, b, t = 0.5) {
 }
 function luminance(hex) {
   const [r, g, b] = hexToRgb(hex);
-  return (r + g + b) / 3;
+  return 0.299 * r + 0.587 * g + 0.114 * b;
+}
+function relativeLuminance(hex) {
+  const [r, g, b] = hexToRgb(hex).map((c) => {
+    const s = c / 255;
+    return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+  });
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function contrastRatio(hex1, hex2) {
+  const l1 = relativeLuminance(hex1);
+  const l2 = relativeLuminance(hex2);
+  const lighter = Math.max(l1, l2);
+  const darker = Math.min(l1, l2);
+  return (lighter + 0.05) / (darker + 0.05);
 }
 function deriveSkinColors(skin) {
   const sL = luminance(skin);
@@ -245,11 +266,20 @@ function deriveSkinColors(skin) {
   const lipRaw = blend(skin, lipBase, Math.min(0.82, lipBlend));
   const [lr, lg, lb] = hexToRgb(lipRaw);
   const lipD = Math.abs(sr - lr) + Math.abs(sg - lg) + Math.abs(sb - lb);
-  const lipColor = lipD < 60 ? blend(skin, lipBase, 0.78) : lipRaw;
-  const browColor = isDark ? lighten(skin, sL < 80 ? 0.35 : 0.25) : darken(skin, 0.55);
-  const noseFill = isDark ? lighten(skin, 0.2) : darken(skin, 0.2);
+  let lipColor = lipD < 60 ? blend(skin, lipBase, 0.78) : lipRaw;
+  let attempts = 0;
+  while (contrastRatio(lipColor, skin) < 1.8 && attempts < 12) {
+    lipColor = darken(lipColor, 0.06);
+    attempts++;
+  }
+  const browColor = isDark ? lighten(skin, sL < 80 ? 0.35 : sL < 100 ? 0.32 : 0.25) : darken(skin, 0.55);
+  const noseShift = 0.2 + 0.06 * (1 - Math.abs(sL - 100) / 140);
+  const noseFill = isDark ? lighten(skin, noseShift) : darken(skin, noseShift);
   const earT = Math.max(0, Math.min(1, (sL - 100) / 60));
-  const earFill = blend(lighten(skin, 0.08), skinMid, earT);
+  let earFill = blend(lighten(skin, 0.08), skinMid, earT);
+  if (contrastRatio(earFill, skin) < 1.05) {
+    earFill = isDark ? lighten(earFill, 0.06) : darken(earFill, 0.06);
+  }
   const earShadow = darken(skin, 0.1 + 0.06 * (1 - Math.min(1, sL / 160)));
   const lidColor = isDark ? lighten(skin, 0.18) : darken(skin, 0.15);
   const ewT = Math.max(0, Math.min(1, (sL - 60) / 180));
@@ -273,10 +303,209 @@ function deriveSkinColors(skin) {
     accessoryColor
   };
 }
-function buzzOpacity(hairCol, skin) {
-  const [hr, hg, hb] = hexToRgb(hairCol);
-  const [sr, sg, sb] = hexToRgb(skin);
-  return Math.abs(hr - sr) + Math.abs(hg - sg) + Math.abs(hb - sb) < 80 ? 0.7 : 0.5;
+
+// 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",
+  8: "side-looking, shifted"
+};
+var EYE_COLORS_DESC = {
+  0: "dark brown",
+  1: "blue",
+  2: "green",
+  3: "hazel",
+  4: "gray",
+  5: "amber",
+  6: "violet",
+  7: "steel gray"
+};
+var EYEBROW_STYLES = {
+  0: "wispy",
+  1: "straight",
+  2: "natural",
+  3: "elegantly arched",
+  4: "sharply angled",
+  5: "worried, furrowed",
+  6: "bushy",
+  7: "thin, delicate"
+};
+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",
+  4: "a pointed nose",
+  5: "a wide, broad nose",
+  6: "a nose with a visible bridge",
+  7: "a small snub nose"
+};
+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 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",
+  10: "a left eyebrow slit",
+  11: "a right eyebrow slit"
+};
+var BG_COLORS_DESC = {
+  0: "rose",
+  1: "olive",
+  2: "sage",
+  3: "fern",
+  4: "mint",
+  5: "ocean",
+  6: "sky",
+  7: "lavender",
+  8: "orchid",
+  9: "blush",
+  10: "lilac",
+  11: "seafoam"
+};
+function describeAppearance(walletAddress, options) {
+  const traits = 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 = 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`);
+  parts.push(perspective === "first" ? "and am bald" : "and is bald");
+  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 = 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"}`);
+  lines.push("Hair: bald");
+  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 = 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`);
+  parts.push("bald");
+  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;
 }
 
 // src/core/renderer.ts
@@ -292,12 +521,9 @@ function buildDefs(id, skin, skinHi, skinLo, hairCol, bgCol, cheekColor, cheekOp
   let d = "<defs>";
   d += `<linearGradient id="${id}sg" x1="0" y1="0" x2="0" y2="1">`;
   d += `<stop offset="0%" stop-color="${skinHi}"/>`;
+  d += `<stop offset="50%" stop-color="${skin}"/>`;
   d += `<stop offset="100%" stop-color="${skinLo}"/>`;
   d += `</linearGradient>`;
-  d += `<linearGradient id="${id}hg" x1="0" y1="0" x2="0" y2="1">`;
-  d += `<stop offset="0%" stop-color="${lighten(hairCol, 0.15)}"/>`;
-  d += `<stop offset="100%" stop-color="${darken(hairCol, 0.15)}"/>`;
-  d += `</linearGradient>`;
   d += `<linearGradient id="${id}bg" x1="0" y1="0" x2="1" y2="1">`;
   d += `<stop offset="0%" stop-color="${lighten(bgCol, 0.12)}"/>`;
   d += `<stop offset="100%" stop-color="${darken(bgCol, 0.12)}"/>`;
@@ -323,18 +549,8 @@ function buildDefs(id, skin, skinHi, skinLo, hairCol, bgCol, cheekColor, cheekOp
   d += "</defs>";
   return d;
 }
-function renderHairBack(hi, id, flat) {
-  const fill = flat ? "currentColor" : `url(#${id}hg)`;
-  switch (hi) {
-    case 5:
-      return `<g fill="${fill}"><rect x="10" y="14" width="44" height="42" rx="6"/></g>`;
-    case 6:
-      return `<g fill="${fill}"><rect x="12" y="14" width="40" height="32" rx="8"/></g>`;
-    case 8:
-      return `<g fill="${fill}"><rect x="11" y="14" width="42" height="38" rx="8"/></g>`;
-    default:
-      return "";
-  }
+function renderHairBack(_hi, _id, _flat) {
+  return "";
 }
 function renderEars(earFill, earShadow) {
   return `<ellipse cx="11" cy="34" rx="4" ry="5" fill="${earFill}"/><ellipse cx="11" cy="34" rx="2.5" ry="3.5" fill="${earShadow}" opacity="0.3"/><ellipse cx="53" cy="34" rx="4" ry="5" fill="${earFill}"/><ellipse cx="53" cy="34" rx="2.5" ry="3.5" fill="${earShadow}" opacity="0.3"/>`;
@@ -348,35 +564,8 @@ function renderFaceOverlays(id, flat) {
   if (flat) return "";
   return `<rect x="14" y="16" width="36" height="38" rx="12" ry="12" fill="url(#${id}glow)"/><rect x="14" y="16" width="36" height="38" rx="12" ry="12" fill="url(#${id}chin)"/><ellipse cx="22" cy="42" rx="5" ry="3.5" fill="url(#${id}cL)"/><ellipse cx="42" cy="42" rx="5" ry="3.5" fill="url(#${id}cR)"/><line x1="20" y1="50" x2="44" y2="50" stroke="currentColor" stroke-width="0.3" opacity="0.08" stroke-linecap="round"/>`;
 }
-function renderHairFront(hi, id, hairCol, skin, flat) {
-  const fill = flat ? hairCol : `url(#${id}hg)`;
-  switch (hi) {
-    case 0:
-      return "";
-    // Bald
-    case 1:
-      return `<path d="M14 28 Q14 14 32 12 Q50 14 50 28 L50 22 Q50 12 32 10 Q14 12 14 22 Z" fill="${fill}"/>`;
-    case 2:
-      return `<g fill="${fill}"><circle cx="20" cy="14" r="5"/><circle cx="28" cy="11" r="5.5"/><circle cx="36" cy="11" r="5.5"/><circle cx="44" cy="14" r="5"/><circle cx="16" cy="20" r="4"/><circle cx="48" cy="20" r="4"/></g>`;
-    case 3:
-      return `<path d="M14 26 Q14 12 32 10 Q50 12 50 26 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/><path d="M14 20 Q8 16 10 8 Q14 10 20 16 Z" fill="${fill}"/>`;
-    case 4:
-      return `<ellipse cx="32" cy="10" rx="14" ry="8" fill="${fill}"/>`;
-    case 5:
-      return `<path d="M14 28 Q14 12 32 10 Q50 12 50 28 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/>`;
-    case 6:
-      return `<path d="M14 28 Q14 12 32 10 Q50 12 50 28 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/><rect x="10" y="28" width="8" height="14" rx="4" fill="${fill}"/><rect x="46" y="28" width="8" height="14" rx="4" fill="${fill}"/>`;
-    case 7: {
-      const bOp = buzzOpacity(hairCol, skin);
-      return `<rect x="15" y="13" width="34" height="16" rx="10" ry="8" fill="${hairCol}" opacity="${bOp.toFixed(2)}"/>`;
-    }
-    case 8:
-      return `<path d="M14 28 Q14 12 32 10 Q50 12 50 28 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/><path d="M12 30 Q10 20 14 16" fill="none" stroke="${fill}" stroke-width="4" stroke-linecap="round"/><path d="M52 30 Q54 20 50 16" fill="none" stroke="${fill}" stroke-width="4" stroke-linecap="round"/>`;
-    case 9:
-      return `<path d="M14 28 Q14 14 32 12 Q50 14 50 28 L50 22 Q50 12 32 10 Q14 12 14 22 Z" fill="${fill}"/><ellipse cx="32" cy="6" rx="6" ry="5" fill="${fill}"/>`;
-    default:
-      return "";
-  }
+function renderHairFront(_hi, _id, _hairCol, _skin, _flat) {
+  return "";
 }
 function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
   const lx = 25, rx = 39, y = 33;
@@ -391,8 +580,10 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
       if (full) s += `<circle cx="${rx + 1.5}" cy="${y - 1}" r="0.7" fill="white" opacity="0.8"/>`;
       break;
     case 1:
-      s += `<circle cx="${lx}" cy="${y}" r="2" fill="${eyeCol}"/>`;
-      s += `<circle cx="${rx}" cy="${y}" r="2" fill="${eyeCol}"/>`;
+      s += `<circle cx="${lx}" cy="${y}" r="2.2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${lx + 0.5}" cy="${y - 0.5}" r="0.5" fill="white" opacity="0.4"/>`;
+      s += `<circle cx="${rx}" cy="${y}" r="2.2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${rx + 0.5}" cy="${y - 0.5}" r="0.5" fill="white" opacity="0.4"/>`;
       break;
     case 2:
       s += `<ellipse cx="${lx}" cy="${y}" rx="4.5" ry="2.8" fill="${eyeWhite}"/>`;
@@ -419,24 +610,16 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
       if (full) s += `<line x1="${rx - 4.5}" y1="${y - 0.5}" x2="${rx + 4.5}" y2="${y - 0.5}" stroke="${lidColor}" stroke-width="0.8" stroke-linecap="round"/>`;
       break;
     case 5:
-      s += `<path d="M${lx - 4} ${y} Q${lx} ${y + 4} ${lx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="1.8" stroke-linecap="round"/>`;
-      s += `<path d="M${rx - 4} ${y} Q${rx} ${y + 4} ${rx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="1.8" stroke-linecap="round"/>`;
+      s += `<path d="M${lx - 4} ${y} Q${lx} ${y + 4.5} ${lx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="2" stroke-linecap="round"/>`;
+      s += `<path d="M${rx - 4} ${y} Q${rx} ${y + 4.5} ${rx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="2" stroke-linecap="round"/>`;
       break;
     case 6:
       s += `<circle cx="${lx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
       s += `<circle cx="${lx + 0.5}" cy="${y}" r="2" fill="${eyeCol}"/>`;
       s += `<circle cx="${lx + 1.5}" cy="${y - 1}" r="1" fill="white" opacity="0.9"/>`;
-      if (full) {
-        s += `<line x1="${lx + 2.5}" y1="${y - 3.5}" x2="${lx + 4}" y2="${y - 5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-        s += `<line x1="${lx + 3.5}" y1="${y - 2.5}" x2="${lx + 5}" y2="${y - 3.5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-      }
       s += `<circle cx="${rx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
       s += `<circle cx="${rx + 0.5}" cy="${y}" r="2" fill="${eyeCol}"/>`;
       s += `<circle cx="${rx + 1.5}" cy="${y - 1}" r="1" fill="white" opacity="0.9"/>`;
-      if (full) {
-        s += `<line x1="${rx + 2.5}" y1="${y - 3.5}" x2="${rx + 4}" y2="${y - 5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-        s += `<line x1="${rx + 3.5}" y1="${y - 2.5}" x2="${rx + 5}" y2="${y - 3.5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-      }
       break;
     case 7:
       s += `<ellipse cx="${lx}" cy="${y}" rx="4.5" ry="1.5" fill="${eyeWhite}"/>`;
@@ -444,6 +627,14 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
       s += `<ellipse cx="${rx}" cy="${y}" rx="4.5" ry="1.5" fill="${eyeWhite}"/>`;
       s += `<ellipse cx="${rx + 0.5}" cy="${y}" rx="2.2" ry="1.2" fill="${eyeCol}"/>`;
       break;
+    case 8:
+      s += `<circle cx="${lx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
+      s += `<circle cx="${lx - 1}" cy="${y}" r="2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${lx - 0.3}" cy="${y - 0.8}" r="0.7" fill="white" opacity="0.8"/>`;
+      s += `<circle cx="${rx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
+      s += `<circle cx="${rx - 1}" cy="${y}" r="2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${rx - 0.3}" cy="${y - 0.8}" r="0.7" fill="white" opacity="0.8"/>`;
+      break;
     default:
       s += `<circle cx="${lx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
       s += `<circle cx="${lx + 0.8}" cy="${y}" r="2" fill="${eyeCol}"/>`;
@@ -456,7 +647,7 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
   }
   return s;
 }
-function renderEyebrows(bi, browColor) {
+function renderEyebrows(bi, browColor, full = true) {
   const lx = 25, rx = 39, y = 27;
   switch (bi) {
     case 0:
@@ -469,6 +660,14 @@ function renderEyebrows(bi, browColor) {
       return `<path d="M${lx - 4} ${y + 1} Q${lx} ${y - 3} ${lx + 4} ${y + 1}" fill="none" stroke="${browColor}" stroke-width="1" stroke-linecap="round"/><path d="M${rx - 4} ${y + 1} Q${rx} ${y - 3} ${rx + 4} ${y + 1}" fill="none" stroke="${browColor}" stroke-width="1" stroke-linecap="round"/>`;
     case 4:
       return `<polyline points="${lx - 3},${y + 1} ${lx},${y - 2} ${lx + 3},${y}" fill="none" stroke="${browColor}" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/><polyline points="${rx - 3},${y} ${rx},${y - 2} ${rx + 3},${y + 1}" fill="none" stroke="${browColor}" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>`;
+    case 5:
+      return `<line x1="${lx - 3}" y1="${y - 1}" x2="${lx + 3}" y2="${y + 1}" stroke="${browColor}" stroke-width="1.1" stroke-linecap="round"/><line x1="${rx - 3}" y1="${y + 1}" x2="${rx + 3}" y2="${y - 1}" stroke="${browColor}" stroke-width="1.1" stroke-linecap="round"/>`;
+    case 6: {
+      const bw = full ? "2.0" : "1.5";
+      return `<path d="M${lx - 4} ${y + 0.5} Q${lx} ${y - 2} ${lx + 4} ${y + 0.5}" fill="none" stroke="${browColor}" stroke-width="${bw}" stroke-linecap="round"/><path d="M${rx - 4} ${y + 0.5} Q${rx} ${y - 2} ${rx + 4} ${y + 0.5}" fill="none" stroke="${browColor}" stroke-width="${bw}" stroke-linecap="round"/>`;
+    }
+    case 7:
+      return `<path d="M${lx - 3.5} ${y} Q${lx} ${y - 1.5} ${lx + 3.5} ${y}" fill="none" stroke="${browColor}" stroke-width="0.5" stroke-linecap="round"/><path d="M${rx - 3.5} ${y} Q${rx} ${y - 1.5} ${rx + 3.5} ${y}" fill="none" stroke="${browColor}" stroke-width="0.5" stroke-linecap="round"/>`;
     default:
       return "";
   }
@@ -484,6 +683,14 @@ function renderNose(ni, noseFill) {
       return `<path d="M${cx - 2} ${y + 1} Q${cx} ${y - 2} ${cx + 2} ${y + 1}" fill="none" stroke="${noseFill}" stroke-width="1" stroke-linecap="round" opacity="0.5"/>`;
     case 3:
       return `<circle cx="${cx - 1.8}" cy="${y}" r="1.2" fill="${noseFill}" opacity="0.4"/><circle cx="${cx + 1.8}" cy="${y}" r="1.2" fill="${noseFill}" opacity="0.4"/>`;
+    case 4:
+      return `<path d="M${cx} ${y - 2} L${cx - 2} ${y + 1.5} L${cx + 2} ${y + 1.5} Z" fill="${noseFill}" opacity="0.4"/>`;
+    case 5:
+      return `<ellipse cx="${cx}" cy="${y}" rx="3.5" ry="1.5" fill="${noseFill}" opacity="0.35"/>`;
+    case 6:
+      return `<line x1="${cx}" y1="${y - 3}" x2="${cx}" y2="${y + 1}" stroke="${noseFill}" stroke-width="1.2" stroke-linecap="round" opacity="0.4"/>`;
+    case 7:
+      return `<circle cx="${cx}" cy="${y + 0.5}" r="2" fill="${noseFill}" opacity="0.35"/><ellipse cx="${cx}" cy="${y - 0.5}" rx="1" ry="0.5" fill="${noseFill}" opacity="0.15"/>`;
     default:
       return `<ellipse cx="${cx}" cy="${y}" rx="2" ry="1.2" fill="${noseFill}" opacity="0.35"/>`;
   }
@@ -505,20 +712,20 @@ function renderMouth(mi, lipColor, isDark) {
     case 5:
       return `<path d="M${cx - 5} ${y} Q${cx} ${y + 6} ${cx + 5} ${y}" fill="${teethCol}" stroke="${lipColor}" stroke-width="1"/><line x1="${cx - 4}" y1="${y + 1.5}" x2="${cx + 4}" y2="${y + 1.5}" stroke="${lipColor}" stroke-width="0.3" opacity="0.3"/>`;
     case 6:
-      return `<line x1="${cx - 4}" y1="${y + 1}" x2="${cx + 4}" y2="${y + 1}" stroke="${lipColor}" stroke-width="1.5" stroke-linecap="round"/>`;
+      return `<path d="M${cx - 4} ${y + 0.5} Q${cx} ${y + 1.5} ${cx + 4} ${y + 0.5}" fill="none" stroke="${lipColor}" stroke-width="1.4" stroke-linecap="round"/>`;
     case 7:
       return `<ellipse cx="${cx}" cy="${y + 1}" rx="3.5" ry="2" fill="${lipColor}" opacity="0.25"/><path d="M${cx - 3} ${y} Q${cx} ${y + 2.5} ${cx + 3} ${y}" fill="none" stroke="${lipColor}" stroke-width="1.2" stroke-linecap="round"/>`;
     default:
       return `<path d="M${cx - 4} ${y} Q${cx} ${y + 4} ${cx + 4} ${y}" fill="none" stroke="${lipColor}" stroke-width="1.4" stroke-linecap="round"/>`;
   }
 }
-function renderAccessory(ai, accessoryColor, glassesColor, earringColor, headbandColor) {
+function renderAccessory(ai, accessoryColor, glassesColor, earringColor, headbandColor, beautyMarkColor = "#3a2a2a", freckleColor = "#a0785a", skinColor = "#E8BA8B") {
   switch (ai) {
     case 0:
       return "";
     // None
     case 1:
-      return `<circle cx="40" cy="44" r="0.8" fill="#3a2a2a"/>`;
+      return `<circle cx="40" cy="44" r="0.8" fill="${beautyMarkColor}"/>`;
     case 2:
       return `<g fill="none" stroke="${glassesColor}" stroke-width="1"><circle cx="25" cy="33" r="5.5"/><circle cx="39" cy="33" r="5.5"/><line x1="30.5" y1="33" x2="33.5" y2="33"/><line x1="19.5" y1="33" x2="14" y2="31"/><line x1="44.5" y1="33" x2="50" y2="31"/></g>`;
     case 3:
@@ -528,13 +735,17 @@ function renderAccessory(ai, accessoryColor, glassesColor, earringColor, headban
     case 5:
       return `<rect x="13" y="20" width="38" height="3.5" rx="1.5" fill="${headbandColor}" opacity="0.85"/>`;
     case 6:
-      return `<g fill="#a0785a" opacity="0.35"><circle cx="21" cy="40" r="0.6"/><circle cx="23" cy="42" r="0.5"/><circle cx="19" cy="41.5" r="0.5"/><circle cx="43" cy="40" r="0.6"/><circle cx="41" cy="42" r="0.5"/><circle cx="45" cy="41.5" r="0.5"/></g>`;
+      return `<g fill="${freckleColor}" opacity="0.35"><circle cx="21" cy="40" r="0.6"/><circle cx="23" cy="42" r="0.5"/><circle cx="19" cy="41.5" r="0.5"/><circle cx="43" cy="40" r="0.6"/><circle cx="41" cy="42" r="0.5"/><circle cx="45" cy="41.5" r="0.5"/></g>`;
     case 7:
       return `<circle cx="10" cy="37" r="1.2" fill="${earringColor}"/><circle cx="54" cy="37" r="1.2" fill="${earringColor}"/>`;
     case 8:
       return `<g fill="none" stroke="${glassesColor}" stroke-width="1.2"><path d="M19 30 Q19 28 25 28 Q31 28 31 33 Q31 38 25 38 Q19 38 19 33 Z" fill="${glassesColor}" fill-opacity="0.15"/><path d="M33 30 Q33 28 39 28 Q45 28 45 33 Q45 38 39 38 Q33 38 33 33 Z" fill="${glassesColor}" fill-opacity="0.15"/><line x1="31" y1="32" x2="33" y2="32"/><line x1="19" y1="31" x2="14" y2="29"/><line x1="45" y1="31" x2="50" y2="29"/></g>`;
     case 9:
-      return `<g><rect x="38" y="38" width="8" height="4" rx="1" fill="#f0d0a0" transform="rotate(-15 42 40)"/><line x1="40" y1="39" x2="40" y2="41" stroke="#c0a080" stroke-width="0.4" transform="rotate(-15 42 40)"/><line x1="42" y1="39" x2="42" y2="41" stroke="#c0a080" stroke-width="0.4" transform="rotate(-15 42 40)"/><line x1="44" y1="39" x2="44" y2="41" stroke="#c0a080" stroke-width="0.4" transform="rotate(-15 42 40)"/></g>`;
+      return `<g><rect x="38" y="38" width="9" height="4.5" rx="1.2" fill="#f0d0a0" transform="rotate(-15 42 40)"/><rect x="39.5" y="38.5" width="6" height="3.5" rx="0.8" fill="#f5ddb5" transform="rotate(-15 42 40)"/><circle cx="42.5" cy="40.25" r="0.5" fill="#d4b898" transform="rotate(-15 42 40)"/></g>`;
+    case 10:
+      return `<line x1="23" y1="24.8" x2="23.8" y2="29.2" stroke="${skinColor}" stroke-width="1.3" stroke-linecap="butt"/>`;
+    case 11:
+      return `<line x1="41" y1="24.8" x2="40.2" y2="29.2" stroke="${skinColor}" stroke-width="1.3" stroke-linecap="butt"/>`;
     default:
       return "";
   }
@@ -564,14 +775,17 @@ function renderSolFaceSVG(walletAddress, options) {
   const glassesColor = theme?.glassesColor ?? "#4a4a5a";
   const earringColor = theme?.earringColor ?? blend(skin, "#d4a840", 0.4);
   const headbandColor = theme?.headbandColor ?? blend(hairCol, "#c04040", 0.5);
+  const beautyMarkColor = theme?.beautyMarkColor ?? "#3a2a2a";
+  const freckleColor = theme?.freckleColor ?? "#a0785a";
   const id = "sf" + djb22(walletAddress).toString(36);
   const cheekEnabled = theme?.cheekEnabled ?? true;
   const cheekColor = theme?.cheekColor ?? derived.cheekColor;
   const cheekOpacity = theme?.cheekOpacity ?? derived.cheekOpacity;
-  const hi = traits.hairStyle % 10;
+  traits.hairStyle % 10;
   const ai = effectiveAccessory(traits);
   const classAttr = className ? ` class="${className}"` : "";
-  let svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="${size}" height="${size}"${classAttr}>`;
+  const altText = solFaceAltText(walletAddress).replace(/"/g, "&quot;");
+  let svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="${size}" height="${size}"${classAttr} role="img" aria-label="${altText}">`;
   const glowIntensity = theme?.glowIntensity ?? 0.1;
   svg += buildDefs(id, skin, derived.skinHi, derived.skinLo, hairCol, bgCol, cheekColor, cheekOpacity, flat, full && cheekEnabled, glowIntensity);
   const blinkEnabled = !!enableBlink;
@@ -584,29 +798,29 @@ function renderSolFaceSVG(walletAddress, options) {
   }
   const bgFill = flat ? bgCol : `url(#${id}bg)`;
   svg += `<rect x="0" y="0" width="64" height="64" fill="${bgFill}" opacity="${bgOpacity}" rx="${bgRadius}"/>`;
-  svg += renderHairBack(hi, id, flat);
-  svg += renderEars(derived.earFill, derived.earShadow);
+  if (theme?.hairEnabled !== false) svg += renderHairBack();
+  if (theme?.earsEnabled !== false) svg += renderEars(theme?.earColor ?? derived.earFill, derived.earShadow);
   const skinOpacity = theme?.skinOpacity ?? 1;
   svg += renderFace(id, skin, flat, skinOpacity);
   const shadowEnabled = theme?.shadowEnabled ?? true;
   if (full && cheekEnabled && shadowEnabled) {
     svg += renderFaceOverlays(id, flat);
   }
-  if (ai === 5) {
-    svg += renderAccessory(5, accColor, glassesColor, earringColor, headbandColor);
+  if (theme?.hairEnabled !== false) svg += renderHairFront();
+  if (ai === 5 && theme?.accessoriesEnabled !== false) {
+    svg += renderAccessory(5, accColor, glassesColor, earringColor, headbandColor, beautyMarkColor, freckleColor, skin);
   }
-  svg += renderHairFront(hi, id, hairCol, skin, flat);
   if (blinkEnabled) {
     const uid = `sf-${walletAddress.slice(0, 8)}`;
     svg += `<g class="${uid}-eyes">`;
   }
-  svg += renderEyes(traits.eyeStyle % 8, eyeCol, eyeWhite, derived.lidColor, full);
+  svg += renderEyes(traits.eyeStyle % 9, eyeCol, eyeWhite, theme?.lidColor ?? derived.lidColor, full);
   if (blinkEnabled) svg += `</g>`;
-  svg += renderEyebrows(traits.eyebrows % 5, browColor);
-  svg += renderNose(traits.nose % 4, noseFill);
+  if (theme?.eyebrowsEnabled !== false) svg += renderEyebrows(traits.eyebrows % 8, browColor, full);
+  if (theme?.noseEnabled !== false) svg += renderNose(traits.nose % 8, noseFill);
   svg += renderMouth(traits.mouth % 8, lipColor, derived.isDark);
-  if (ai !== 0 && ai !== 5) {
-    svg += renderAccessory(ai, accColor, glassesColor, earringColor, headbandColor);
+  if (ai !== 0 && ai !== 5 && theme?.accessoriesEnabled !== false) {
+    svg += renderAccessory(ai, accColor, glassesColor, earringColor, headbandColor, beautyMarkColor, freckleColor, skin);
   }
   if (theme?.border) {
     svg += `<rect x="0" y="0" width="64" height="64" fill="none" stroke="${theme.border.color}" stroke-width="${theme.border.width}" rx="${bgRadius}"/>`;
@@ -627,10 +841,13 @@ exports.BG_COLORS = BG_COLORS;
 exports.EYE_COLORS = EYE_COLORS;
 exports.HAIR_COLORS = HAIR_COLORS;
 exports.SKIN_COLORS = SKIN_COLORS;
+exports.agentAppearancePrompt = agentAppearancePrompt;
 exports.blend = blend;
-exports.buzzOpacity = buzzOpacity;
+exports.contrastRatio = contrastRatio;
 exports.darken = darken;
 exports.deriveSkinColors = deriveSkinColors;
+exports.describeAppearance = describeAppearance;
+exports.describeTraits = describeTraits;
 exports.effectiveAccessory = effectiveAccessory;
 exports.generateTraits = generateTraits;
 exports.getTraitLabels = getTraitLabels;
@@ -643,6 +860,7 @@ exports.renderSolFaceDataURI = renderSolFaceDataURI;
 exports.renderSolFaceSVG = renderSolFaceSVG;
 exports.resolveTheme = resolveTheme;
 exports.rgbToHex = rgbToHex;
+exports.solFaceAltText = solFaceAltText;
 exports.traitHash = traitHash;
-//# sourceMappingURL=chunk-F54WHRCE.cjs.map
-//# sourceMappingURL=chunk-F54WHRCE.cjs.map
+//# sourceMappingURL=chunk-W2U6ITMR.cjs.map
+//# sourceMappingURL=chunk-W2U6ITMR.cjs.map