@nodaro/prompts 1.7.3 → 1.8.0

package/src/styling.ts

@@ -46,6 +46,8 @@
  * fields for specifics the catalog can't express.
  */
 
+import { resolveTerm, type PickerHintMode } from "./term.js"
+
 export type StylingDimension =
   | "makeup"
   | "eyewear"
@@ -71,25 +73,45 @@ export interface Styling {
   readonly dimension: StylingDimension
   readonly description: string
   readonly promptHint: string
+  /**
+   * Compact professional term for hint-compact mode (see `term.ts`).
+   *
+   * The line this catalog authors on: a label that NAMES a garment, material
+   * or accessory ("Beanie", "Trench Coat", "Silk", "Hoop Earrings", "Doc
+   * Martens") already IS the term a stylist writes, and gets nothing. A label
+   * that is a bare MODIFIER — the whole of `hair-state`, `wardrobe-state`,
+   * `nails`, and the adjective half of `makeup` / `jewelry` — means nothing
+   * stripped of its category noun, so "Wet" becomes "wet hair" and "Gold"
+   * becomes "gold jewelry".
+   *
+   * The same rule resolves this catalog's internal collisions, where two
+   * dimensions share a label and would otherwise derive one indistinguishable
+   * fragment: `hair-wet` / `state-wet` (both "Wet"), `jewelry-layered` /
+   * `state-layered`, `makeup-goth` / `outfit-goth`. Homonym traps outside the
+   * catalog get the same treatment — "Highlights" is a lighting word before it
+   * is a hair word, "Cat-Eye" is eyeliner before it is eyewear, "Hood" is a
+   * car part, "Bun" is bread.
+   */
+  readonly term?: string
 }
 
 export const STYLINGS: ReadonlyArray<Styling> = [
   // -------------------- Makeup --------------------
-  { id: "makeup-natural",   label: "Natural",       dimension: "makeup",     description: "Subtle, no-makeup makeup",  promptHint: "with natural, subtle no-makeup makeup" },
-  { id: "makeup-glamour",   label: "Glamour",       dimension: "makeup",     description: "Full polished glam look",   promptHint: "with full glamour makeup, polished and editorial" },
+  { id: "makeup-natural",   label: "Natural",       dimension: "makeup",     description: "Subtle, no-makeup makeup",  promptHint: "with natural, subtle no-makeup makeup", term: "natural no-makeup makeup" },
+  { id: "makeup-glamour",   label: "Glamour",       dimension: "makeup",     description: "Full polished glam look",   promptHint: "with full glamour makeup, polished and editorial", term: "full glamour makeup" },
   { id: "makeup-smoky",     label: "Smoky Eye",     dimension: "makeup",     description: "Dark dramatic eye makeup",  promptHint: "with smoky eye makeup, dark and dramatic" },
   { id: "makeup-bold-lips", label: "Bold Lips",     dimension: "makeup",     description: "Strong red or dark lipstick", promptHint: "with bold lips, a strong red or dark lipstick as the focal point" },
-  { id: "makeup-editorial", label: "Editorial",     dimension: "makeup",     description: "Avant-garde fashion makeup", promptHint: "with avant-garde editorial makeup, artistic and unconventional" },
-  { id: "makeup-goth",      label: "Goth",          dimension: "makeup",     description: "Dark goth aesthetic",       promptHint: "with goth makeup — pale skin, black eyeliner, dark lips" },
-  { id: "makeup-dewy",      label: "Dewy Glow",     dimension: "makeup",     description: "Glowing fresh-skin focus",  promptHint: "with dewy makeup, glowing fresh skin and minimal coverage" },
+  { id: "makeup-editorial", label: "Editorial",     dimension: "makeup",     description: "Avant-garde fashion makeup", promptHint: "with avant-garde editorial makeup, artistic and unconventional", term: "editorial makeup" },
+  { id: "makeup-goth",      label: "Goth",          dimension: "makeup",     description: "Dark goth aesthetic",       promptHint: "with goth makeup — pale skin, black eyeliner, dark lips", term: "goth makeup" },
+  { id: "makeup-dewy",      label: "Dewy Glow",     dimension: "makeup",     description: "Glowing fresh-skin focus",  promptHint: "with dewy makeup, glowing fresh skin and minimal coverage", term: "dewy makeup" },
 
   // -------------------- Eyewear --------------------
   { id: "eyewear-sunglasses",      label: "Sunglasses",      dimension: "eyewear", description: "Generic dark sunglasses", promptHint: "wearing sunglasses" },
-  { id: "eyewear-aviators",        label: "Aviators",        dimension: "eyewear", description: "Classic aviator shades",  promptHint: "wearing classic aviator sunglasses with a metal frame" },
-  { id: "eyewear-cat-eye",         label: "Cat-Eye",         dimension: "eyewear", description: "Vintage cat-eye frames",  promptHint: "wearing cat-eye glasses with vintage upswept frames" },
-  { id: "eyewear-round",           label: "Round / John Lennon", dimension: "eyewear", description: "Round wire-frame glasses", promptHint: "wearing round wire-frame glasses, John Lennon style" },
+  { id: "eyewear-aviators",        label: "Aviators",        dimension: "eyewear", description: "Classic aviator shades",  promptHint: "wearing classic aviator sunglasses with a metal frame", term: "aviator sunglasses" },
+  { id: "eyewear-cat-eye",         label: "Cat-Eye",         dimension: "eyewear", description: "Vintage cat-eye frames",  promptHint: "wearing cat-eye glasses with vintage upswept frames", term: "cat-eye glasses" },
+  { id: "eyewear-round",           label: "Round / John Lennon", dimension: "eyewear", description: "Round wire-frame glasses", promptHint: "wearing round wire-frame glasses, John Lennon style", term: "round wire-frame glasses" },
   { id: "eyewear-fashion",         label: "Fashion Glasses", dimension: "eyewear", description: "Bold designer frames",    promptHint: "wearing bold fashion glasses with designer frames" },
-  { id: "eyewear-sport",           label: "Sport Goggles",   dimension: "eyewear", description: "Wraparound sport eyewear", promptHint: "wearing wraparound sport sunglasses" },
+  { id: "eyewear-sport",           label: "Sport Goggles",   dimension: "eyewear", description: "Wraparound sport eyewear", promptHint: "wearing wraparound sport sunglasses", term: "wraparound sport sunglasses" },
 
   // -------------------- Headwear --------------------
   { id: "headwear-beanie",       label: "Beanie",        dimension: "headwear", description: "Knit beanie hat",        promptHint: "wearing a knit beanie" },
@@ -98,7 +120,7 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "headwear-sun-hat",      label: "Sun Hat",       dimension: "headwear", description: "Wide-brimmed sun hat",    promptHint: "wearing a wide-brimmed sun hat" },
   { id: "headwear-headband",     label: "Headband",      dimension: "headwear", description: "Hair headband",           promptHint: "wearing a headband" },
   { id: "headwear-bandana",      label: "Bandana",       dimension: "headwear", description: "Bandana tied around head", promptHint: "wearing a bandana tied around the head" },
-  { id: "headwear-hood",         label: "Hood",          dimension: "headwear", description: "Hooded sweatshirt up",    promptHint: "with a hood pulled up over the head" },
+  { id: "headwear-hood",         label: "Hood",          dimension: "headwear", description: "Hooded sweatshirt up",    promptHint: "with a hood pulled up over the head", term: "hood pulled up" },
   { id: "headwear-crown",        label: "Crown",         dimension: "headwear", description: "Royal or decorative crown", promptHint: "wearing a crown atop the head" },
   { id: "headwear-nemes",        label: "Nemes Headdress", dimension: "headwear", description: "Striped pharaonic nemes with uraeus", promptHint: "wearing a striped pharaonic nemes headdress with a golden uraeus cobra at the brow" },
   { id: "headwear-helmet",       label: "Helmet",        dimension: "headwear", description: "Protective helmet",       promptHint: "wearing a helmet" },
@@ -114,22 +136,22 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   // Natural texture + length live in Person.hair-base. This is what the
   // stylist did with it. 45 entries — the picker uses a modal browser.
   // ---- Short cuts ----
-  { id: "cut-pixie",           label: "Pixie",           dimension: "hair-cut", description: "Short, cropped pixie cut",         promptHint: "styled in a short pixie cut" },
+  { id: "cut-pixie",           label: "Pixie",           dimension: "hair-cut", description: "Short, cropped pixie cut",         promptHint: "styled in a short pixie cut", term: "pixie cut" },
   { id: "cut-buzz-cut",        label: "Buzz Cut",        dimension: "hair-cut", description: "Very short buzz cut",              promptHint: "buzzed short" },
   { id: "cut-crew-cut",        label: "Crew Cut",        dimension: "hair-cut", description: "Short tapered classic crew cut",   promptHint: "styled in a short tapered crew cut" },
-  { id: "cut-shaved",          label: "Shaved",          dimension: "hair-cut", description: "Fully shaved",                     promptHint: "shaved bald" },
+  { id: "cut-shaved",          label: "Shaved",          dimension: "hair-cut", description: "Fully shaved",                     promptHint: "shaved bald", term: "shaved head" },
   { id: "cut-undercut",        label: "Undercut",        dimension: "hair-cut", description: "Short sides, longer top",          promptHint: "with an undercut — short sides and longer hair on top" },
   { id: "cut-faux-hawk",       label: "Faux Hawk",       dimension: "hair-cut", description: "Center strip raised, sides faded", promptHint: "styled in a faux hawk with a raised center strip and faded sides" },
   { id: "cut-mohawk",          label: "Mohawk",          dimension: "hair-cut", description: "Shaved sides, tall center strip",  promptHint: "styled in a mohawk with shaved sides and a tall center strip" },
   { id: "cut-pompadour",       label: "Pompadour",       dimension: "hair-cut", description: "Swept up and back, volume in front", promptHint: "styled in a pompadour with hair swept up and back from the forehead" },
-  { id: "cut-short",           label: "Short",           dimension: "hair-cut", description: "Generic short cut",                promptHint: "cut short" },
+  { id: "cut-short",           label: "Short",           dimension: "hair-cut", description: "Generic short cut",                promptHint: "cut short", term: "short haircut" },
   { id: "cut-short-curly",     label: "Short Curly Cut", dimension: "hair-cut", description: "Short layered curly shape",        promptHint: "cut short with curls left out" },
 
   // ---- Bob family ----
   { id: "cut-micro-bob",       label: "Micro Bob",       dimension: "hair-cut", description: "Very short ear-length bob",        promptHint: "styled in a very short ear-length bob cut" },
   { id: "cut-french-bob",      label: "French Bob",      dimension: "hair-cut", description: "Jaw-length blunt bob, often with bangs", promptHint: "styled in a jaw-length blunt French bob with soft bangs" },
-  { id: "cut-bob",             label: "Bob",             dimension: "hair-cut", description: "Chin-length bob cut",              promptHint: "styled in a chin-length bob cut" },
-  { id: "cut-lob",             label: "Lob",             dimension: "hair-cut", description: "Long bob, collarbone-length",      promptHint: "styled in a long bob falling to the collarbone" },
+  { id: "cut-bob",             label: "Bob",             dimension: "hair-cut", description: "Chin-length bob cut",              promptHint: "styled in a chin-length bob cut", term: "bob cut" },
+  { id: "cut-lob",             label: "Lob",             dimension: "hair-cut", description: "Long bob, collarbone-length",      promptHint: "styled in a long bob falling to the collarbone", term: "long bob" },
 
   // ---- Layered / shag family ----
   { id: "cut-mullet",          label: "Mullet",          dimension: "hair-cut", description: "Short on top and sides, long in back", promptHint: "styled in a mullet with short top and long back" },
@@ -139,22 +161,22 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "cut-bangs",           label: "Blunt Bangs",     dimension: "hair-cut", description: "Straight bangs across forehead",   promptHint: "with blunt bangs across the forehead" },
   { id: "cut-curtain-bangs",   label: "Curtain Bangs",   dimension: "hair-cut", description: "Center-parted face-framing bangs", promptHint: "with center-parted curtain bangs framing the face" },
   { id: "cut-wispy-bangs",     label: "Wispy Bangs",     dimension: "hair-cut", description: "Thin, piecey, airy fringe",        promptHint: "with thin wispy piecey bangs" },
-  { id: "cut-side-swept",      label: "Side-Swept",      dimension: "hair-cut", description: "Falls across face over one eye",   promptHint: "side-swept across the face with strands falling over one eye" },
+  { id: "cut-side-swept",      label: "Side-Swept",      dimension: "hair-cut", description: "Falls across face over one eye",   promptHint: "side-swept across the face with strands falling over one eye", term: "side-swept hair" },
 
   // ---- Pulled back / updos ----
-  { id: "cut-slicked-back",    label: "Slicked Back",    dimension: "hair-cut", description: "Pulled straight back, polished",   promptHint: "slicked straight back with a polished finish" },
-  { id: "cut-bardot-tendrils", label: "Bardot Tendrils", dimension: "hair-cut", description: "Pulled back with face-framing strands", promptHint: "pulled back with thin face-framing tendrils falling loose at the temples" },
-  { id: "cut-ponytail",        label: "Ponytail (Low)",  dimension: "hair-cut", description: "Low pulled-back ponytail",         promptHint: "in a low pulled-back ponytail" },
+  { id: "cut-slicked-back",    label: "Slicked Back",    dimension: "hair-cut", description: "Pulled straight back, polished",   promptHint: "slicked straight back with a polished finish", term: "slicked-back hair" },
+  { id: "cut-bardot-tendrils", label: "Bardot Tendrils", dimension: "hair-cut", description: "Pulled back with face-framing strands", promptHint: "pulled back with thin face-framing tendrils falling loose at the temples", term: "pulled back with face-framing tendrils" },
+  { id: "cut-ponytail",        label: "Ponytail (Low)",  dimension: "hair-cut", description: "Low pulled-back ponytail",         promptHint: "in a low pulled-back ponytail", term: "low ponytail" },
   { id: "cut-high-ponytail",   label: "High Ponytail",   dimension: "hair-cut", description: "Ponytail tied high on the crown",  promptHint: "in a high ponytail tied at the crown" },
   { id: "cut-half-up",         label: "Half-Up Half-Down", dimension: "hair-cut", description: "Top pulled back, rest flows down", promptHint: "in a half-up half-down style, top pulled back with the rest flowing down" },
-  { id: "cut-bun",             label: "Bun",             dimension: "hair-cut", description: "Classic low or mid bun",           promptHint: "in a bun" },
+  { id: "cut-bun",             label: "Bun",             dimension: "hair-cut", description: "Classic low or mid bun",           promptHint: "in a bun", term: "hair bun" },
   { id: "cut-top-knot",        label: "Top Knot",        dimension: "hair-cut", description: "Bun tied high on the crown",       promptHint: "in a top knot on the crown" },
   { id: "cut-space-buns",      label: "Space Buns",      dimension: "hair-cut", description: "Two symmetric buns either side",   promptHint: "in two symmetric space buns" },
 
   // ---- Braids ----
   { id: "cut-braids",          label: "Braids",          dimension: "hair-cut", description: "Multiple loose woven braids",      promptHint: "styled in multiple loose braids" },
   { id: "cut-single-braid",    label: "Single Braid",    dimension: "hair-cut", description: "One long braid down the back",     promptHint: "in a single long braid down the back" },
-  { id: "cut-two-braids",      label: "Two Braids",      dimension: "hair-cut", description: "Pigtail braids either side",       promptHint: "in two pigtail braids" },
+  { id: "cut-two-braids",      label: "Two Braids",      dimension: "hair-cut", description: "Pigtail braids either side",       promptHint: "in two pigtail braids", term: "pigtail braids" },
   { id: "cut-french-braid",    label: "French Braid",    dimension: "hair-cut", description: "Woven flat against the scalp",     promptHint: "in a French braid woven flat against the scalp" },
   { id: "cut-dutch-braid",     label: "Dutch Braid",     dimension: "hair-cut", description: "Inverted raised French braid",     promptHint: "in a raised Dutch braid" },
   { id: "cut-fishtail-braid",  label: "Fishtail Braid",  dimension: "hair-cut", description: "Fine two-strand weave",            promptHint: "in a fishtail braid" },
@@ -167,36 +189,36 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "cut-sisterlocks",     label: "Sisterlocks",     dimension: "hair-cut", description: "Thin, neatly sectioned micro-locs", promptHint: "in thin neat sisterlocks" },
 
   // -------------------- Hair State (motion / condition — distinct from cut shape and treatment color) --------------------
-  { id: "hair-wet",         label: "Wet",          dimension: "hair-state", description: "Soaked, water-clinging hair",  promptHint: "with hair soaked and wet, strands clinging together and dripping water" },
-  { id: "hair-damp",        label: "Damp",         dimension: "hair-state", description: "Just-washed damp hair",        promptHint: "with hair freshly damp, slightly weighted and softly clumped" },
-  { id: "hair-messy",       label: "Messy",        dimension: "hair-state", description: "Disheveled, unkempt",          promptHint: "with hair messy and disheveled, unkempt strands going every direction" },
-  { id: "hair-tousled",     label: "Tousled",      dimension: "hair-state", description: "Lightly mussed, lived-in",     promptHint: "with hair softly tousled and lived-in, casual undone movement" },
-  { id: "hair-bedhead",     label: "Bedhead",      dimension: "hair-state", description: "Just-woken-up flattened side", promptHint: "with bedhead — hair flattened on one side, fluffed on the other, like just woken up" },
-  { id: "hair-windswept",   label: "Windswept",    dimension: "hair-state", description: "Wind-blown, hair in motion",   promptHint: "with hair caught mid-motion in wind, strands streaming sideways across and away from the face" },
-  { id: "hair-voluminous",  label: "Voluminous",   dimension: "hair-state", description: "Big, blown-out volume",        promptHint: "with hair full of volume, blown out and bouncy with body and lift at the roots" },
-  { id: "hair-sleek",       label: "Sleek",        dimension: "hair-state", description: "Glassy smooth straight",       promptHint: "with hair sleek and glass-smooth, every strand pressed flat with a polished sheen" },
-  { id: "hair-frizzy",      label: "Frizzy",       dimension: "hair-state", description: "Halo of frizz",                promptHint: "with hair frizzy, fine flyaway strands forming a soft halo around the head" },
-  { id: "hair-strands-on-face", label: "Strands on Face", dimension: "hair-state", description: "Loose strands across face", promptHint: "with loose hair strands falling across the face, partially covering one eye" },
-  { id: "hair-tucked-behind-ear", label: "Tucked Behind Ear", dimension: "hair-state", description: "Pushed behind one ear", promptHint: "with hair pushed back and tucked behind one ear, exposing the side of the face" },
-  { id: "hair-flowing",     label: "Flowing",      dimension: "hair-state", description: "Long flowing motion",          promptHint: "with hair flowing freely, strands cascading and rippling with subtle movement" },
+  { id: "hair-wet",         label: "Wet",          dimension: "hair-state", description: "Soaked, water-clinging hair",  promptHint: "with hair soaked and wet, strands clinging together and dripping water", term: "wet hair" },
+  { id: "hair-damp",        label: "Damp",         dimension: "hair-state", description: "Just-washed damp hair",        promptHint: "with hair freshly damp, slightly weighted and softly clumped", term: "damp hair" },
+  { id: "hair-messy",       label: "Messy",        dimension: "hair-state", description: "Disheveled, unkempt",          promptHint: "with hair messy and disheveled, unkempt strands going every direction", term: "messy hair" },
+  { id: "hair-tousled",     label: "Tousled",      dimension: "hair-state", description: "Lightly mussed, lived-in",     promptHint: "with hair softly tousled and lived-in, casual undone movement", term: "tousled hair" },
+  { id: "hair-bedhead",     label: "Bedhead",      dimension: "hair-state", description: "Just-woken-up flattened side", promptHint: "with bedhead — hair flattened on one side, fluffed on the other, like just woken up", term: "bedhead hair" },
+  { id: "hair-windswept",   label: "Windswept",    dimension: "hair-state", description: "Wind-blown, hair in motion",   promptHint: "with hair caught mid-motion in wind, strands streaming sideways across and away from the face", term: "windswept hair" },
+  { id: "hair-voluminous",  label: "Voluminous",   dimension: "hair-state", description: "Big, blown-out volume",        promptHint: "with hair full of volume, blown out and bouncy with body and lift at the roots", term: "voluminous blown-out hair" },
+  { id: "hair-sleek",       label: "Sleek",        dimension: "hair-state", description: "Glassy smooth straight",       promptHint: "with hair sleek and glass-smooth, every strand pressed flat with a polished sheen", term: "sleek straight hair" },
+  { id: "hair-frizzy",      label: "Frizzy",       dimension: "hair-state", description: "Halo of frizz",                promptHint: "with hair frizzy, fine flyaway strands forming a soft halo around the head", term: "frizzy hair" },
+  { id: "hair-strands-on-face", label: "Strands on Face", dimension: "hair-state", description: "Loose strands across face", promptHint: "with loose hair strands falling across the face, partially covering one eye", term: "loose strands across the face" },
+  { id: "hair-tucked-behind-ear", label: "Tucked Behind Ear", dimension: "hair-state", description: "Pushed behind one ear", promptHint: "with hair pushed back and tucked behind one ear, exposing the side of the face", term: "hair tucked behind one ear" },
+  { id: "hair-flowing",     label: "Flowing",      dimension: "hair-state", description: "Long flowing motion",          promptHint: "with hair flowing freely, strands cascading and rippling with subtle movement", term: "flowing hair" },
 
   // -------------------- Hair Treatment (salon coloring techniques) --------------------
   { id: "treatment-babylights",  label: "Babylights",    dimension: "hair-treatment", description: "Ultra-fine, delicate highlights", promptHint: "with babylights — ultra-fine, delicate highlights that mimic natural sun-kissed hair" },
   { id: "treatment-balayage",    label: "Balayage",      dimension: "hair-treatment", description: "Hand-painted highlights",         promptHint: "with balayage — hand-painted highlights with a soft, sun-kissed gradient" },
   { id: "treatment-ombre",       label: "Ombré",         dimension: "hair-treatment", description: "Gradient dark roots to light ends", promptHint: "with ombré — a smooth gradient from dark roots to lighter ends" },
   { id: "treatment-sombre",      label: "Sombré",        dimension: "hair-treatment", description: "Subtle soft ombré",               promptHint: "with sombré — a subtle, soft ombré gradient" },
-  { id: "treatment-highlights",  label: "Highlights",    dimension: "hair-treatment", description: "Classic foil highlights",         promptHint: "with highlights — lighter streaks throughout the hair" },
-  { id: "treatment-lowlights",   label: "Lowlights",     dimension: "hair-treatment", description: "Darker shade streaks",            promptHint: "with lowlights — darker streaks woven through for dimension" },
-  { id: "treatment-rooted",      label: "Rooted",        dimension: "hair-treatment", description: "Visible root regrowth look",      promptHint: "with a rooted look — visible darker roots blending into lighter lengths" },
+  { id: "treatment-highlights",  label: "Highlights",    dimension: "hair-treatment", description: "Classic foil highlights",         promptHint: "with highlights — lighter streaks throughout the hair", term: "hair highlights" },
+  { id: "treatment-lowlights",   label: "Lowlights",     dimension: "hair-treatment", description: "Darker shade streaks",            promptHint: "with lowlights — darker streaks woven through for dimension", term: "hair lowlights" },
+  { id: "treatment-rooted",      label: "Rooted",        dimension: "hair-treatment", description: "Visible root regrowth look",      promptHint: "with a rooted look — visible darker roots blending into lighter lengths", term: "rooted color with dark roots" },
 
   // -------------------- Jewelry --------------------
-  { id: "jewelry-subtle",     label: "Subtle",     dimension: "jewelry", description: "Minimal, delicate jewelry", promptHint: "wearing subtle, minimal jewelry" },
-  { id: "jewelry-statement",  label: "Statement",  dimension: "jewelry", description: "Bold statement piece",      promptHint: "wearing a bold statement jewelry piece" },
-  { id: "jewelry-gold",       label: "Gold",       dimension: "jewelry", description: "Gold necklace + earrings",  promptHint: "wearing gold jewelry — a necklace and earrings" },
-  { id: "jewelry-silver",     label: "Silver",     dimension: "jewelry", description: "Silver necklace + earrings", promptHint: "wearing silver jewelry — a necklace and earrings" },
-  { id: "jewelry-layered",    label: "Layered",    dimension: "jewelry", description: "Layered necklaces / chains", promptHint: "wearing layered necklaces of varying lengths" },
-  { id: "jewelry-pearl",      label: "Pearl",      dimension: "jewelry", description: "Pearl necklace / earrings", promptHint: "wearing a pearl necklace and pearl earrings" },
-  { id: "jewelry-chunky",     label: "Chunky",     dimension: "jewelry", description: "Chunky chains and rings",   promptHint: "wearing chunky chains and oversized rings" },
+  { id: "jewelry-subtle",     label: "Subtle",     dimension: "jewelry", description: "Minimal, delicate jewelry", promptHint: "wearing subtle, minimal jewelry", term: "delicate minimal jewelry" },
+  { id: "jewelry-statement",  label: "Statement",  dimension: "jewelry", description: "Bold statement piece",      promptHint: "wearing a bold statement jewelry piece", term: "statement jewelry" },
+  { id: "jewelry-gold",       label: "Gold",       dimension: "jewelry", description: "Gold necklace + earrings",  promptHint: "wearing gold jewelry — a necklace and earrings", term: "gold jewelry" },
+  { id: "jewelry-silver",     label: "Silver",     dimension: "jewelry", description: "Silver necklace + earrings", promptHint: "wearing silver jewelry — a necklace and earrings", term: "silver jewelry" },
+  { id: "jewelry-layered",    label: "Layered",    dimension: "jewelry", description: "Layered necklaces / chains", promptHint: "wearing layered necklaces of varying lengths", term: "layered necklaces" },
+  { id: "jewelry-pearl",      label: "Pearl",      dimension: "jewelry", description: "Pearl necklace / earrings", promptHint: "wearing a pearl necklace and pearl earrings", term: "pearl jewelry" },
+  { id: "jewelry-chunky",     label: "Chunky",     dimension: "jewelry", description: "Chunky chains and rings",   promptHint: "wearing chunky chains and oversized rings", term: "chunky chains and rings" },
   { id: "jewelry-smart-watch", label: "Smart Watch", dimension: "jewelry", description: "Modern smart watch on wrist", promptHint: "wearing a modern smart watch on the wrist with a sleek digital face and silicone band" },
   { id: "jewelry-choker-leather", label: "Leather Choker", dimension: "jewelry", description: "Black leather choker close to throat", promptHint: "wearing a black leather choker fitted close around the throat" },
   { id: "jewelry-choker-velvet", label: "Velvet Choker", dimension: "jewelry", description: "Velvet ribbon choker, dressy and vintage", promptHint: "wearing a velvet ribbon choker around the throat, a dressy vintage touch with a small pendant at the front" },
@@ -208,16 +230,16 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "jewelry-body-chain", label: "Body Chain", dimension: "jewelry", description: "Thin metallic chain across torso", promptHint: "wearing a thin metallic body chain draped across the torso" },
 
   // -------------------- Nails --------------------
-  { id: "nails-polished",     label: "Polished",     dimension: "nails", description: "Clear or nude polished nails", promptHint: "with polished nude nails" },
-  { id: "nails-red",          label: "Red",          dimension: "nails", description: "Bright red nail polish",       promptHint: "with bright red nail polish" },
-  { id: "nails-dark",         label: "Dark",         dimension: "nails", description: "Dark / black nails",           promptHint: "with dark black nail polish" },
-  { id: "nails-long-acrylic", label: "Long Acrylic", dimension: "nails", description: "Long acrylic nails",           promptHint: "with long acrylic nails" },
-  { id: "nails-french",       label: "French Tips",  dimension: "nails", description: "Classic French manicure",      promptHint: "with classic French tip manicure" },
+  { id: "nails-polished",     label: "Polished",     dimension: "nails", description: "Clear or nude polished nails", promptHint: "with polished nude nails", term: "polished nude nails" },
+  { id: "nails-red",          label: "Red",          dimension: "nails", description: "Bright red nail polish",       promptHint: "with bright red nail polish", term: "red nail polish" },
+  { id: "nails-dark",         label: "Dark",         dimension: "nails", description: "Dark / black nails",           promptHint: "with dark black nail polish", term: "black nail polish" },
+  { id: "nails-long-acrylic", label: "Long Acrylic", dimension: "nails", description: "Long acrylic nails",           promptHint: "with long acrylic nails", term: "long acrylic nails" },
+  { id: "nails-french",       label: "French Tips",  dimension: "nails", description: "Classic French manicure",      promptHint: "with classic French tip manicure", term: "french tip manicure" },
 
   // -------------------- Face Paint --------------------
   { id: "face-paint-subtle",   label: "Subtle Body Paint", dimension: "face-paint", description: "Subtle body / face paint accents", promptHint: "with subtle body paint accents on the skin" },
   { id: "face-paint-dramatic", label: "Dramatic Face Paint", dimension: "face-paint", description: "Bold artistic face paint",       promptHint: "with dramatic, artistic face paint covering portions of the face" },
-  { id: "face-paint-costume",  label: "Costume Paint",     dimension: "face-paint", description: "Cosplay / theatrical paint",       promptHint: "with theatrical costume face paint" },
+  { id: "face-paint-costume",  label: "Costume Paint",     dimension: "face-paint", description: "Cosplay / theatrical paint",       promptHint: "with theatrical costume face paint", term: "theatrical costume face paint" },
   { id: "face-paint-tribal",   label: "Tribal Markings",   dimension: "face-paint", description: "Tribal-inspired face markings",    promptHint: "with tribal-inspired face markings" },
   { id: "face-paint-flag",     label: "Flag Face Paint",   dimension: "face-paint", description: "National flag painted on cheeks, sports-fan", promptHint: "with a national flag painted on the cheeks, sports-fan face paint" },
   { id: "face-paint-warpaint", label: "War Paint",         dimension: "face-paint", description: "Warrior war paint streaks",        promptHint: "with warrior war paint streaked across the face" },
@@ -233,13 +255,13 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "fabric-leather",  label: "Leather",  dimension: "fabric", description: "Rich supple leather",           promptHint: "wearing rich supple leather with a soft satin sheen and natural grain" },
   { id: "fabric-velvet",   label: "Velvet",   dimension: "fabric", description: "Plush velvet",                  promptHint: "wearing plush velvet with a deep soft nap and rich saturated color" },
   { id: "fabric-satin",    label: "Satin",    dimension: "fabric", description: "Glossy satin",                  promptHint: "wearing glossy satin with a lustrous mirror-like surface and fluid folds" },
-  { id: "fabric-lace",     label: "Lace",     dimension: "fabric", description: "Delicate patterned lace",       promptHint: "wearing delicate patterned lace with intricate floral openwork" },
+  { id: "fabric-lace",     label: "Lace",     dimension: "fabric", description: "Delicate patterned lace",       promptHint: "wearing delicate patterned lace with intricate floral openwork", term: "delicate patterned lace" },
   { id: "fabric-wool",     label: "Wool",     dimension: "fabric", description: "Warm woven wool",               promptHint: "wearing warm woven wool with a soft matte surface and visible fibers" },
   { id: "fabric-linen",    label: "Linen",    dimension: "fabric", description: "Natural textured linen",        promptHint: "wearing natural linen with a loose open weave, slight slubs and an airy drape" },
   { id: "fabric-tweed",    label: "Tweed",    dimension: "fabric", description: "Rustic woven tweed",            promptHint: "wearing rustic tweed with a flecked multi-color woven texture and a heritage feel" },
   { id: "fabric-cashmere", label: "Cashmere", dimension: "fabric", description: "Luxurious soft cashmere",       promptHint: "wearing luxurious cashmere with an ultra-soft matte texture" },
   { id: "fabric-chiffon",  label: "Chiffon",  dimension: "fabric", description: "Sheer flowing chiffon",         promptHint: "wearing sheer chiffon with a lightweight floating drape and soft translucent layers" },
-  { id: "fabric-fur",      label: "Fur",      dimension: "fabric", description: "Thick plush fur",               promptHint: "wearing thick plush fur with long dense strands and natural variation" },
+  { id: "fabric-fur",      label: "Fur",      dimension: "fabric", description: "Thick plush fur",               promptHint: "wearing thick plush fur with long dense strands and natural variation", term: "fur garment" },
   { id: "fabric-sequins",  label: "Sequins",  dimension: "fabric", description: "Sparkling sequin fabric",       promptHint: "wearing sparkling sequined fabric catching light with countless tiny reflective facets" },
   { id: "fabric-latex",    label: "Latex",    dimension: "fabric", description: "Glossy latex",                  promptHint: "wearing glossy latex with a high-shine liquid look clinging to the body" },
 
@@ -250,7 +272,7 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "outfit-evening-gown",     label: "Evening Gown",     dimension: "outfit", description: "Floor-length formal gown",          promptHint: "dressed in a floor-length evening gown with a fitted bodice and a flowing skirt" },
   { id: "outfit-wedding-dress",    label: "Wedding Dress",    dimension: "outfit", description: "White wedding gown",                promptHint: "dressed in a white wedding gown with intricate lace detailing and a sweeping train" },
   { id: "outfit-cocktail-dress",   label: "Cocktail Dress",   dimension: "outfit", description: "Knee-length cocktail dress",        promptHint: "dressed in a sleek knee-length cocktail dress" },
-  { id: "outfit-sundress",         label: "Sundress / Maxi",  dimension: "outfit", description: "Flowy halter-neck sundress / patterned maxi", promptHint: "dressed in a flowy halter-neck sundress with a patterned maxi-length skirt" },
+  { id: "outfit-sundress",         label: "Sundress / Maxi",  dimension: "outfit", description: "Flowy halter-neck sundress / patterned maxi", promptHint: "dressed in a flowy halter-neck sundress with a patterned maxi-length skirt", term: "flowy maxi sundress" },
   { id: "outfit-lab-coat",         label: "Lab Coat",         dimension: "outfit", description: "White medical lab coat",            promptHint: "wearing a crisp white lab coat layered over the rest of the clothing" },
   { id: "outfit-scrubs",           label: "Medical Scrubs",   dimension: "outfit", description: "Solid-color medical scrubs",        promptHint: "dressed in solid-color medical scrubs — loose-fit top and matching drawstring pants" },
   { id: "outfit-military",         label: "Military Fatigues", dimension: "outfit", description: "Olive-drab military fatigues",     promptHint: "dressed in olive-drab military fatigues with utility pockets and a sturdy belt" },
@@ -264,19 +286,19 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "outfit-pajamas",          label: "Pajamas",          dimension: "outfit", description: "Soft cotton pajama set",            promptHint: "in a soft cotton pajama set — a button-up top and matching pants" },
   { id: "outfit-bathrobe",         label: "Bathrobe",         dimension: "outfit", description: "Plush terrycloth robe",             promptHint: "wrapped in a plush terrycloth bathrobe tied at the waist" },
   { id: "outfit-kimono",           label: "Kimono",           dimension: "outfit", description: "Traditional Japanese kimono",       promptHint: "dressed in a traditional Japanese kimono with an obi sash" },
-  { id: "outfit-ballerina",        label: "Ballerina",        dimension: "outfit", description: "Classical ballerina costume",       promptHint: "dressed in a classical ballerina costume — fitted leotard and tulle tutu" },
-  { id: "outfit-flapper",          label: "1920s Flapper",    dimension: "outfit", description: "Beaded flapper dress",              promptHint: "dressed in a 1920s flapper dress — beaded fringe and a low-drop hem" },
-  { id: "outfit-goth",             label: "Goth",             dimension: "outfit", description: "Full dark goth: black lace, leather, dark makeup, chains", promptHint: "wearing a full goth outfit — black lace and leather layered together, chains and silver hardware, with dark dramatic makeup" },
-  { id: "outfit-emo",              label: "Emo",              dimension: "outfit", description: "Early-2000s emo: skinny jeans, band tee, dyed hair, eyeliner", promptHint: "wearing an early-2000s emo outfit — skinny black jeans and a band tee, with dyed side-swept hair and heavy eyeliner" },
+  { id: "outfit-ballerina",        label: "Ballerina",        dimension: "outfit", description: "Classical ballerina costume",       promptHint: "dressed in a classical ballerina costume — fitted leotard and tulle tutu", term: "ballerina leotard and tutu" },
+  { id: "outfit-flapper",          label: "1920s Flapper",    dimension: "outfit", description: "Beaded flapper dress",              promptHint: "dressed in a 1920s flapper dress — beaded fringe and a low-drop hem", term: "1920s flapper dress" },
+  { id: "outfit-goth",             label: "Goth",             dimension: "outfit", description: "Full dark goth: black lace, leather, dark makeup, chains", promptHint: "wearing a full goth outfit — black lace and leather layered together, chains and silver hardware, with dark dramatic makeup", term: "goth outfit" },
+  { id: "outfit-emo",              label: "Emo",              dimension: "outfit", description: "Early-2000s emo: skinny jeans, band tee, dyed hair, eyeliner", promptHint: "wearing an early-2000s emo outfit — skinny black jeans and a band tee, with dyed side-swept hair and heavy eyeliner", term: "emo outfit" },
   { id: "outfit-streetwear",       label: "Streetwear",       dimension: "outfit", description: "Modern streetwear: hoodie, baggy pants, sneakers, bucket hat", promptHint: "wearing a modern streetwear outfit — an oversized hoodie, baggy pants, chunky sneakers, and a bucket hat" },
-  { id: "outfit-cyberpunk",        label: "Cyberpunk",        dimension: "outfit", description: "Neon-lit cyberpunk: tech wear, LED accents, mesh layers", promptHint: "wearing a cyberpunk outfit — neon-lit techwear with LED accents, mesh layers, and a futuristic urban silhouette" },
-  { id: "outfit-cottagecore",      label: "Cottagecore",      dimension: "outfit", description: "Pastoral cottage aesthetic: prairie dress, apron, basket", promptHint: "wearing a cottagecore outfit — a long pastoral prairie dress with an apron and a woven basket on the arm" },
-  { id: "outfit-dark-academia",    label: "Dark Academia",    dimension: "outfit", description: "Oxford-tweed scholar: blazer, vest, oxford shoes, books", promptHint: "wearing a dark academia outfit — a tweed blazer over a knit vest, oxford shoes, with books tucked under the arm" },
+  { id: "outfit-cyberpunk",        label: "Cyberpunk",        dimension: "outfit", description: "Neon-lit cyberpunk: tech wear, LED accents, mesh layers", promptHint: "wearing a cyberpunk outfit — neon-lit techwear with LED accents, mesh layers, and a futuristic urban silhouette", term: "cyberpunk techwear outfit" },
+  { id: "outfit-cottagecore",      label: "Cottagecore",      dimension: "outfit", description: "Pastoral cottage aesthetic: prairie dress, apron, basket", promptHint: "wearing a cottagecore outfit — a long pastoral prairie dress with an apron and a woven basket on the arm", term: "cottagecore prairie dress" },
+  { id: "outfit-dark-academia",    label: "Dark Academia",    dimension: "outfit", description: "Oxford-tweed scholar: blazer, vest, oxford shoes, books", promptHint: "wearing a dark academia outfit — a tweed blazer over a knit vest, oxford shoes, with books tucked under the arm", term: "dark academia outfit" },
   { id: "outfit-anime-cosplay",    label: "Anime Cosplay",    dimension: "outfit", description: "Costume modeled on a recognizable anime character archetype", promptHint: "wearing an anime cosplay costume modeled on a recognizable anime character archetype, with stylized details and bold colors" },
-  { id: "outfit-nurse",            label: "Nurse",            dimension: "outfit", description: "Medical scrubs, stethoscope, lanyard ID", promptHint: "dressed as a nurse — fitted medical scrubs with a stethoscope around the neck and a lanyard ID badge" },
-  { id: "outfit-pirate",           label: "Pirate",           dimension: "outfit", description: "Pirate costume: tricorn hat, sash, frilly shirt, boots", promptHint: "wearing a pirate costume — a tricorn hat, a frilly shirt with a sash at the waist, and tall leather boots" },
-  { id: "outfit-fairy",            label: "Fairy",            dimension: "outfit", description: "Fantasy fairy: gauzy wings, flower crown, ethereal dress", promptHint: "wearing a fantasy fairy costume — gauzy translucent wings, a flower crown, and an ethereal flowing dress" },
-  { id: "outfit-mermaid",          label: "Mermaid",          dimension: "outfit", description: "Fantasy mermaid: scaled tail/skirt, shell top, flowing hair", promptHint: "wearing a fantasy mermaid costume — a scaled tail or fitted scaled skirt, a shell top, and long flowing hair" },
+  { id: "outfit-nurse",            label: "Nurse",            dimension: "outfit", description: "Medical scrubs, stethoscope, lanyard ID", promptHint: "dressed as a nurse — fitted medical scrubs with a stethoscope around the neck and a lanyard ID badge", term: "nurse uniform with stethoscope" },
+  { id: "outfit-pirate",           label: "Pirate",           dimension: "outfit", description: "Pirate costume: tricorn hat, sash, frilly shirt, boots", promptHint: "wearing a pirate costume — a tricorn hat, a frilly shirt with a sash at the waist, and tall leather boots", term: "pirate costume" },
+  { id: "outfit-fairy",            label: "Fairy",            dimension: "outfit", description: "Fantasy fairy: gauzy wings, flower crown, ethereal dress", promptHint: "wearing a fantasy fairy costume — gauzy translucent wings, a flower crown, and an ethereal flowing dress", term: "fairy costume with wings" },
+  { id: "outfit-mermaid",          label: "Mermaid",          dimension: "outfit", description: "Fantasy mermaid: scaled tail/skirt, shell top, flowing hair", promptHint: "wearing a fantasy mermaid costume — a scaled tail or fitted scaled skirt, a shell top, and long flowing hair", term: "mermaid costume" },
   { id: "outfit-pharaoh",          label: "Pharaoh Regalia",  dimension: "outfit", description: "Ancient Egyptian royalty: usekh collar, pectoral, pleated kilt", promptHint: "wearing ancient Egyptian pharaoh regalia — a broad beaded usekh collar, a jeweled falcon pectoral, and a pleated linen shendyt kilt with golden arm cuffs" },
 
   // -------------------- Top (upper-body garment) --------------------
@@ -287,7 +309,7 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "top-sweater",       label: "Sweater",        dimension: "top", description: "Knit pullover sweater",          promptHint: "wearing a soft knit pullover sweater with a relaxed fit" },
   { id: "top-turtleneck",    label: "Turtleneck",     dimension: "top", description: "High-neck turtleneck",           promptHint: "wearing a fitted turtleneck sweater with a high rolled neckline" },
   { id: "top-blouse",        label: "Blouse",         dimension: "top", description: "Flowing dressy blouse",          promptHint: "wearing a flowing blouse with a soft drape and a tied neckline" },
-  { id: "top-button-down",   label: "Button-Down",    dimension: "top", description: "Tailored button-down shirt",     promptHint: "wearing a tailored button-down shirt with a sharp pointed collar" },
+  { id: "top-button-down",   label: "Button-Down",    dimension: "top", description: "Tailored button-down shirt",     promptHint: "wearing a tailored button-down shirt with a sharp pointed collar", term: "button-down shirt" },
   { id: "top-polo",          label: "Polo Shirt",     dimension: "top", description: "Short-sleeve polo",              promptHint: "wearing a fitted polo shirt with a small ribbed collar and short sleeves" },
   { id: "top-tube-top",      label: "Tube Top",       dimension: "top", description: "Strapless tube top",             promptHint: "wearing a strapless tube top fitted across the chest" },
   { id: "top-camisole",      label: "Camisole",       dimension: "top", description: "Thin satin cami",                promptHint: "wearing a thin satin camisole with delicate spaghetti straps" },
@@ -343,7 +365,7 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "legwear-bare",             label: "Bare Legs",        dimension: "legwear", description: "Bare legs, no hosiery",      promptHint: "with bare legs, no hosiery" },
   { id: "legwear-sheer-tights",     label: "Sheer Tights",     dimension: "legwear", description: "Sheer nude pantyhose",       promptHint: "with sheer nude pantyhose" },
   { id: "legwear-opaque-tights",    label: "Opaque Tights",    dimension: "legwear", description: "Solid opaque tights",        promptHint: "with opaque black tights covering the legs" },
-  { id: "legwear-fishnets",         label: "Fishnets",         dimension: "legwear", description: "Diamond-mesh fishnets",      promptHint: "with fishnet stockings, the skin showing through the diamond mesh" },
+  { id: "legwear-fishnets",         label: "Fishnets",         dimension: "legwear", description: "Diamond-mesh fishnets",      promptHint: "with fishnet stockings, the skin showing through the diamond mesh", term: "fishnet stockings" },
   { id: "legwear-thigh-highs",      label: "Thigh-High Stockings", dimension: "legwear", description: "Thigh-high stockings",   promptHint: "with thigh-high stockings stopping mid-thigh" },
   { id: "legwear-lace-top-stockings", label: "Lace-Top Stockings", dimension: "legwear", description: "Lace-banded thigh-highs", promptHint: "with lace-topped thigh-high stockings cinched mid-thigh" },
   { id: "legwear-knee-highs",       label: "Knee-High Socks",  dimension: "legwear", description: "Knee-high socks",            promptHint: "with knee-high socks pulled up the calf" },
@@ -367,34 +389,34 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "footwear-loafers",         label: "Loafers",          dimension: "footwear", description: "Polished penny loafers",   promptHint: "in polished leather penny loafers" },
   { id: "footwear-oxfords",         label: "Oxfords",          dimension: "footwear", description: "Laced leather oxfords",    promptHint: "in laced leather oxford shoes with a polished finish" },
   { id: "footwear-sandals",         label: "Sandals",          dimension: "footwear", description: "Flat strappy sandals",     promptHint: "in flat strappy sandals" },
-  { id: "footwear-mules",           label: "Mules",            dimension: "footwear", description: "Backless slip-on mules",   promptHint: "in slip-on backless mules" },
+  { id: "footwear-mules",           label: "Mules",            dimension: "footwear", description: "Backless slip-on mules",   promptHint: "in slip-on backless mules", term: "backless slip-on mules" },
   { id: "footwear-flip-flops",      label: "Flip-Flops",       dimension: "footwear", description: "Casual rubber flip-flops", promptHint: "in casual rubber flip-flops" },
   { id: "footwear-ballet-flats",    label: "Ballet Flats",     dimension: "footwear", description: "Slip-on ballet flats",     promptHint: "in slip-on ballet flats with a soft rounded toe" },
   { id: "footwear-barefoot",        label: "Barefoot",         dimension: "footwear", description: "No shoes — barefoot",      promptHint: "barefoot, no shoes" },
-  { id: "footwear-crocs",           label: "Crocs",            dimension: "footwear", description: "Colorful resin clogs, casual and divisive", promptHint: "in colorful resin Crocs clogs with the signature perforated upper" },
+  { id: "footwear-crocs",           label: "Crocs",            dimension: "footwear", description: "Colorful resin clogs, casual and divisive", promptHint: "in colorful resin Crocs clogs with the signature perforated upper", term: "crocs resin clogs" },
   { id: "footwear-birkenstocks",    label: "Birkenstocks",     dimension: "footwear", description: "Cork-footbed sandals",     promptHint: "in cork-footbed Birkenstock sandals with twin leather straps" },
   { id: "footwear-doc-martens",     label: "Doc Martens",      dimension: "footwear", description: "Chunky leather combat boots", promptHint: "in chunky leather Doc Martens boots with yellow welt stitching and an air-cushioned sole" },
-  { id: "footwear-converse",        label: "Converse",         dimension: "footwear", description: "Canvas high-top sneakers, classic Chuck Taylor", promptHint: "in classic Converse Chuck Taylor canvas high-top sneakers with a rubber toe cap" },
-  { id: "footwear-vans",            label: "Vans",             dimension: "footwear", description: "Slip-on or low-top skater sneakers", promptHint: "in classic Vans skater sneakers with the signature waffle sole" },
+  { id: "footwear-converse",        label: "Converse",         dimension: "footwear", description: "Canvas high-top sneakers, classic Chuck Taylor", promptHint: "in classic Converse Chuck Taylor canvas high-top sneakers with a rubber toe cap", term: "converse chuck taylor sneakers" },
+  { id: "footwear-vans",            label: "Vans",             dimension: "footwear", description: "Slip-on or low-top skater sneakers", promptHint: "in classic Vans skater sneakers with the signature waffle sole", term: "vans skater sneakers" },
   { id: "footwear-espadrilles",     label: "Espadrilles",      dimension: "footwear", description: "Woven jute-sole canvas summer shoe", promptHint: "in woven jute-sole espadrilles with a canvas upper, a casual summer shoe" },
 
   // -------------------- Wardrobe State (modifier — composes with any garment) --------------------
-  { id: "state-oversized",     label: "Oversized",       dimension: "wardrobe-state", description: "Loose, oversized fit",      promptHint: "the clothing loose and oversized, draping freely well past the body" },
-  { id: "state-fitted",        label: "Fitted",          dimension: "wardrobe-state", description: "Form-fitting silhouette",   promptHint: "the clothing fitted and form-conscious, hugging the contours of the body" },
-  { id: "state-cropped",       label: "Cropped",         dimension: "wardrobe-state", description: "Top cropped at midriff",    promptHint: "the top cropped above the midriff with the stomach visible" },
-  { id: "state-sheer",         label: "Sheer",           dimension: "wardrobe-state", description: "Translucent fabric",        promptHint: "the fabric translucent and sheer, hinting at the silhouette underneath" },
-  { id: "state-wet",           label: "Wet",             dimension: "wardrobe-state", description: "Soaked, water-clinging",    promptHint: "the clothing soaked and wet, the fabric clinging to the body and dripping water" },
-  { id: "state-ripped",        label: "Ripped",          dimension: "wardrobe-state", description: "Torn and frayed",           promptHint: "the fabric torn and ripped at the seams, with frayed edges" },
-  { id: "state-distressed",    label: "Distressed",      dimension: "wardrobe-state", description: "Worn, faded, weathered",    promptHint: "the clothing distressed and weathered, with faded color and worn-down edges" },
-  { id: "state-vintage",       label: "Vintage",         dimension: "wardrobe-state", description: "Worn, retro character",     promptHint: "the clothing carrying vintage character — softened color, broken-in fit, retro silhouette" },
-  { id: "state-tucked-in",     label: "Tucked In",       dimension: "wardrobe-state", description: "Top tucked into bottom",    promptHint: "the top neatly tucked into the bottom" },
-  { id: "state-half-tucked",   label: "Half-Tucked",     dimension: "wardrobe-state", description: "Front-tucked, back loose",  promptHint: "the top half-tucked — front neatly tucked in, back hanging loose" },
-  { id: "state-off-shoulder",  label: "Off-Shoulder",    dimension: "wardrobe-state", description: "Slipped off one shoulder",  promptHint: "the top slipped off one shoulder, baring the skin and collarbone" },
-  { id: "state-halter-neck",   label: "Halter Neck",     dimension: "wardrobe-state", description: "Straps tied behind the neck", promptHint: "the top cut as a halter — straps tied behind the neck, shoulders and upper back bare" },
+  { id: "state-oversized",     label: "Oversized",       dimension: "wardrobe-state", description: "Loose, oversized fit",      promptHint: "the clothing loose and oversized, draping freely well past the body", term: "oversized fit" },
+  { id: "state-fitted",        label: "Fitted",          dimension: "wardrobe-state", description: "Form-fitting silhouette",   promptHint: "the clothing fitted and form-conscious, hugging the contours of the body", term: "form-fitting clothing" },
+  { id: "state-cropped",       label: "Cropped",         dimension: "wardrobe-state", description: "Top cropped at midriff",    promptHint: "the top cropped above the midriff with the stomach visible", term: "cropped top" },
+  { id: "state-sheer",         label: "Sheer",           dimension: "wardrobe-state", description: "Translucent fabric",        promptHint: "the fabric translucent and sheer, hinting at the silhouette underneath", term: "sheer clothing" },
+  { id: "state-wet",           label: "Wet",             dimension: "wardrobe-state", description: "Soaked, water-clinging",    promptHint: "the clothing soaked and wet, the fabric clinging to the body and dripping water", term: "wet clothing" },
+  { id: "state-ripped",        label: "Ripped",          dimension: "wardrobe-state", description: "Torn and frayed",           promptHint: "the fabric torn and ripped at the seams, with frayed edges", term: "ripped clothing" },
+  { id: "state-distressed",    label: "Distressed",      dimension: "wardrobe-state", description: "Worn, faded, weathered",    promptHint: "the clothing distressed and weathered, with faded color and worn-down edges", term: "distressed clothing" },
+  { id: "state-vintage",       label: "Vintage",         dimension: "wardrobe-state", description: "Worn, retro character",     promptHint: "the clothing carrying vintage character — softened color, broken-in fit, retro silhouette", term: "vintage clothing" },
+  { id: "state-tucked-in",     label: "Tucked In",       dimension: "wardrobe-state", description: "Top tucked into bottom",    promptHint: "the top neatly tucked into the bottom", term: "top tucked in" },
+  { id: "state-half-tucked",   label: "Half-Tucked",     dimension: "wardrobe-state", description: "Front-tucked, back loose",  promptHint: "the top half-tucked — front neatly tucked in, back hanging loose", term: "top half-tucked" },
+  { id: "state-off-shoulder",  label: "Off-Shoulder",    dimension: "wardrobe-state", description: "Slipped off one shoulder",  promptHint: "the top slipped off one shoulder, baring the skin and collarbone", term: "off-the-shoulder top" },
+  { id: "state-halter-neck",   label: "Halter Neck",     dimension: "wardrobe-state", description: "Straps tied behind the neck", promptHint: "the top cut as a halter — straps tied behind the neck, shoulders and upper back bare", term: "halter neckline" },
   { id: "state-plunging-neck", label: "Plunging Neckline", dimension: "wardrobe-state", description: "Deep plunging V neckline",  promptHint: "the neckline cut in a deep plunging V" },
-  { id: "state-unbuttoned",    label: "Unbuttoned",      dimension: "wardrobe-state", description: "Open / unbuttoned",         promptHint: "the outerwear hanging open and unbuttoned, falling loose at the sides" },
-  { id: "state-rolled-sleeves", label: "Rolled Sleeves", dimension: "wardrobe-state", description: "Sleeves rolled up forearm", promptHint: "the sleeves rolled up to the forearm" },
-  { id: "state-layered",       label: "Layered",         dimension: "wardrobe-state", description: "Multiple stacked layers",   promptHint: "the outfit composed of multiple stacked layers, each piece visible at the edges" },
+  { id: "state-unbuttoned",    label: "Unbuttoned",      dimension: "wardrobe-state", description: "Open / unbuttoned",         promptHint: "the outerwear hanging open and unbuttoned, falling loose at the sides", term: "worn open and unbuttoned" },
+  { id: "state-rolled-sleeves", label: "Rolled Sleeves", dimension: "wardrobe-state", description: "Sleeves rolled up forearm", promptHint: "the sleeves rolled up to the forearm", term: "rolled-up sleeves" },
+  { id: "state-layered",       label: "Layered",         dimension: "wardrobe-state", description: "Multiple stacked layers",   promptHint: "the outfit composed of multiple stacked layers, each piece visible at the edges", term: "layered outfit" },
 ] as const
 
 export const STYLING_DIMENSION_ORDER: ReadonlyArray<StylingDimension> = [
@@ -558,15 +580,33 @@ export function getStylingPromptHint(id: string | undefined | null): string {
   return getStyling(id)?.promptHint ?? ""
 }
 
+/**
+ * The COMPACT counterpart of `getStylingPromptHint`: the same lookup, same
+ * arity, same empty-string-on-miss, returning the entry's short professional
+ * term ("wet hair", "gold jewelry", "low ponytail") instead of its full
+ * mechanism clause.
+ */
+export function getStylingTerm(id: string | undefined | null): string {
+  return resolveTerm(getStyling(id))
+}
+
 export const STYLING_IDS: ReadonlyArray<string> = STYLINGS.map((s) => s.id)
 
-export function buildStylingHints(
+/**
+ * The one walk BOTH `buildStylingHints` (verbose) and `buildStylingTerms`
+ * (compact) delegate to: free-text pre-field, every dimension in canonical
+ * order, free-text post-field. `fragmentFor` is the only difference between
+ * the two modes, so they can never disagree about WHICH ids contribute or in
+ * what order — only about how each one is phrased.
+ */
+function collectStylingFragments(
   data: Record<string, unknown> & StylingValue,
+  fragmentFor: (id: string) => string,
 ): string[] {
-  const hints: string[] = []
+  const out: string[] = []
 
   const pre = typeof data.preText === "string" ? data.preText.trim() : ""
-  if (pre) hints.push(pre)
+  if (pre) out.push(pre)
 
   // The Person catalog's `lip-state-bold-red` and this catalog's
   // `makeup-bold-lips` say the same thing; consumers that fold BOTH pickers
@@ -584,21 +624,42 @@ export function buildStylingHints(
     const raw = data[field]
     if (dimension === "makeup" && boldRedAlready && raw === "makeup-bold-lips") continue
     // jewelry / wardrobe-state / hair-state are multi-pick (string | string[]);
-    // emit each id's hint independently and let the comma-join compose.
+    // emit each id's fragment independently and let the comma-join compose.
     if (typeof raw === "string" && raw.length > 0) {
-      const hint = getStylingPromptHint(raw)
-      if (hint) hints.push(hint)
+      const fragment = fragmentFor(raw)
+      if (fragment) out.push(fragment)
     } else if (Array.isArray(raw)) {
       for (const item of raw) {
         if (typeof item !== "string" || item.length === 0) continue
-        const hint = getStylingPromptHint(item)
-        if (hint) hints.push(hint)
+        const fragment = fragmentFor(item)
+        if (fragment) out.push(fragment)
       }
     }
   }
 
   const post = typeof data.postText === "string" ? data.postText.trim() : ""
-  if (post) hints.push(post)
+  if (post) out.push(post)
+
+  return out
+}
 
-  return hints
+export function buildStylingHints(
+  data: Record<string, unknown> & StylingValue,
+  mode: PickerHintMode = "full",
+): string[] {
+  if (mode === "compact") return buildStylingTerms(data)
+  return collectStylingFragments(data, getStylingPromptHint)
+}
+
+/**
+ * The COMPACT counterpart of `buildStylingHints`: the same dimension walk in
+ * the same canonical order, under the same `makeup-bold-lips` dedupe, emitting
+ * each selection's short professional term ("wet hair", "leather jacket",
+ * "gold jewelry") instead of its full mechanism clause. Free-text pre/post
+ * fields are user prose and pass through unchanged in both modes.
+ */
+export function buildStylingTerms(
+  data: Record<string, unknown> & StylingValue,
+): string[] {
+  return collectStylingFragments(data, getStylingTerm)
 }