@nodaro/prompts 1.25.1 → 1.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/prompts",
-  "version": "1.25.1",
+  "version": "1.26.0",
   "description": "Nodaro's prompt-engineering layer — person/picker catalogs with prompt hints, identity-lock clauses, entity prompt builders, brand presets, and prompt/reference assembly shared by the Nodaro platform and SDK.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",
@@ -20,7 +20,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nodaro/shared": "^3.12.1"
+    "@nodaro/shared": "^3.13.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",

package/src/__tests__/fixtures/parameter-hint-golden.json

@@ -1831,7 +1831,7 @@
           "hairColor": "hair-platinum",
           "eyebrows": "brows-natural",
           "skinTone": "skin-very-fair",
-          "skinTexture": "texture-smooth",
+          "skinTexture": "texture-natural",
           "eyeColor": "eyes-brown",
           "eyeState": "eye-state-closed",
           "facialHair": "face-clean-shaven",
@@ -1839,7 +1839,7 @@
         }
       },
       "ctx": null,
-      "expected": "a man, a baby under 1 year old, of Asian descent, a California beach aesthetic — laid-back beach-town vibe, golden-hour sun-warmed energy, easy carefree mood, petite, lean build, an oval face shape, a strong, sharply defined jawline, almond-shaped eyes, a straight nose, thin lips, with chapped, cracked, weather-worn dry lips, a shaved bald head, platinum blonde hair, very pale and icy, natural eyebrows, very fair pale skin, with flawless, silky smooth skin, brown eyes, with eyes fully closed in a peaceful expression, clean-shaven, wearing glasses"
+      "expected": "a man, a baby under 1 year old, of Asian descent, a California beach aesthetic — laid-back beach-town vibe, golden-hour sun-warmed energy, easy carefree mood, petite, lean build, an oval face shape, a strong, sharply defined jawline, almond-shaped eyes, a straight nose, thin lips, with chapped, cracked, weather-worn dry lips, a shaved bald head, platinum blonde hair, very pale and icy, natural eyebrows, very fair pale skin, with natural, unretouched skin — visible pores and small, even variation in tone, brown eyes, with eyes fully closed in a peaceful expression, clean-shaven, wearing glasses"
     },
     {
       "key": "person/last-of-each",
@@ -2518,17 +2518,17 @@
       "expected": "set in a cozy coffee shop interior with warm pendant lights, exposed brick walls and steam drifting over espresso machines"
     },
     {
-      "key": "setting/id:park",
+      "key": "setting/id:neon-alley",
       "note": "single-dim catalog id",
       "node": {
         "id": "n1",
         "type": "setting",
         "data": {
-          "setting": "park"
+          "setting": "neon-alley"
         }
       },
       "ctx": null,
-      "expected": "set in a leafy urban park with winding footpaths, wooden benches, tall shade trees, people lounging on grass and sunlight filtering through leaves"
+      "expected": "set in a rain-soaked neon-lit alley in a Tokyo-style nightlife district with glowing kanji signs, steam vents and reflective puddles"
     },
     {
       "key": "setting/id:wasteland",
@@ -2674,7 +2674,7 @@
         "id": "n1",
         "type": "styling",
         "data": {
-          "makeup": "makeup-dewy",
+          "makeup": "makeup-bare",
           "hairCut": "cut-sisterlocks",
           "hairTreatment": "treatment-rooted",
           "hairState": "hair-flowing",
@@ -2694,7 +2694,7 @@
         }
       },
       "ctx": null,
-      "expected": "with dewy makeup, glowing fresh skin and minimal coverage, in thin neat sisterlocks, with a rooted look — visible darker roots blending into lighter lengths, with hair flowing freely, strands cascading and rippling with subtle movement, wearing wraparound sport sunglasses, wearing a wide-brim Western cowboy hat with a creased crown, wearing a thin metallic body chain draped across the torso, with classic French tip manicure, with warrior war paint streaked across the face, dressed in a long flowing caftan robe, a full-length garment worn across the Middle East and North Africa, wearing a strapless bandeau top wrapped across the chest, in fitted lycra bike shorts ending mid-thigh, wearing a plush fur coat with a deep textured pile, with bunched knit leg warmers stacked over the calves, in woven jute-sole espadrilles with a canvas upper, a casual summer shoe, wearing glossy latex with a high-shine liquid look clinging to the body, the outfit composed of multiple stacked layers, each piece visible at the edges"
+      "expected": "with a completely bare face, no makeup at all, in thin neat sisterlocks, with a rooted look — visible darker roots blending into lighter lengths, with hair flowing freely, strands cascading and rippling with subtle movement, wearing wraparound sport sunglasses, wearing a wide-brim Western cowboy hat with a creased crown, wearing a thin metallic body chain draped across the torso, with classic French tip manicure, with warrior war paint streaked across the face, dressed in a long flowing caftan robe, a full-length garment worn across the Middle East and North Africa, wearing a strapless bandeau top wrapped across the chest, in fitted lycra bike shorts ending mid-thigh, wearing a plush fur coat with a deep textured pile, with bunched knit leg warmers stacked over the calves, in woven jute-sole espadrilles with a canvas upper, a casual summer shoe, wearing glossy latex with a high-shine liquid look clinging to the body, the outfit composed of multiple stacked layers, each piece visible at the edges"
     },
     {
       "key": "styling/mid-of-each",
@@ -2703,7 +2703,7 @@
         "id": "n1",
         "type": "styling",
         "data": {
-          "makeup": "makeup-bold-lips",
+          "makeup": "makeup-editorial",
           "hairCut": "cut-side-swept",
           "hairTreatment": "treatment-sombre",
           "hairState": "hair-voluminous",
@@ -2723,7 +2723,7 @@
         }
       },
       "ctx": null,
-      "expected": "with bold lips, a strong red or dark lipstick as the focal point, side-swept across the face with strands falling over one eye, with sombré — a subtle, soft ombré gradient, with hair full of volume, blown out and bouncy with body and lift at the roots, wearing round wire-frame glasses, John Lennon style, wearing a striped pharaonic nemes headdress with a golden uraeus cobra at the brow, wearing a black leather choker fitted close around the throat, with dark black nail polish, with tribal-inspired face markings, wrapped in a plush terrycloth bathrobe tied at the waist, wearing a thin satin camisole with delicate spaghetti straps, in casual mid-thigh shorts, wearing a quilted puffer jacket with horizontal baffles and a stand-up collar, with lace-topped thigh-high stockings cinched mid-thigh, in polished leather penny loafers, wearing warm woven wool with a soft matte surface and visible fibers, the top neatly tucked into the bottom"
+      "expected": "with avant-garde editorial makeup, artistic and unconventional, side-swept across the face with strands falling over one eye, with sombré — a subtle, soft ombré gradient, with hair full of volume, blown out and bouncy with body and lift at the roots, wearing round wire-frame glasses, John Lennon style, wearing a striped pharaonic nemes headdress with a golden uraeus cobra at the brow, wearing a black leather choker fitted close around the throat, with dark black nail polish, with tribal-inspired face markings, wrapped in a plush terrycloth bathrobe tied at the waist, wearing a thin satin camisole with delicate spaghetti straps, in casual mid-thigh shorts, wearing a quilted puffer jacket with horizontal baffles and a stand-up collar, with lace-topped thigh-high stockings cinched mid-thigh, in polished leather penny loafers, wearing warm woven wool with a soft matte surface and visible fibers, the top neatly tucked into the bottom"
     },
     {
       "key": "styling/one-dimension",

package/src/__tests__/transitions-scope.test.ts

@@ -65,6 +65,64 @@ describe("approved row bodies", () => {
   })
 })
 
+describe("F1 bodies — the subject becomes the material and reforms (2026-09-25 A/B, arm B won)", () => {
+  // The approved drafts, tidied to read like every other row inside `term (…)`:
+  // first letter lower-cased, final full stop dropped. Nothing else differs from the draft.
+  const F1_BODIES: Record<string, { term: string; body: string }> = {
+    "dissolve-to-mist": {
+      term: "dissolve to mist",
+      body:
+        "the first subject loses its solid form and turns into a soft cloud of fine mist, starting at its " +
+        "edges and working inward. The camera stays where it is and the framing does not change. The mist " +
+        "drifts through the frame and thins until the first shot is gone, then gathers again at the same " +
+        "place in the frame and condenses into the second subject as the second shot appears behind it. The " +
+        "shot ends on the second subject, solid and fully resolved, with no mist left. The second subject " +
+        "forms only out of the gathered mist",
+    },
+    "water-splash": {
+      term: "water splash",
+      body:
+        "the first subject turns to water and collapses into a splashing cascade that spreads across the " +
+        "lower part of the frame. The camera stays where it is and the framing does not change. The water " +
+        "surges upward at the same place in the frame and takes the shape of the second subject, while the " +
+        "second shot appears behind it as the spray falls away. The shot ends on the second subject, solid " +
+        "and fully resolved, with no water left on it. The second subject forms only out of the rising water",
+    },
+    "pixelate-reform": {
+      term: "pixelate and reform",
+      body:
+        "the first subject breaks into large square mosaic blocks, and the blocks scatter outward across the " +
+        "frame. The camera stays where it is and the framing does not change. The blocks fly back, lock " +
+        "together at the same place in the frame and sharpen into the second subject, while the second shot " +
+        "appears behind them. The shot ends on the second subject, fully sharp, with no blocks left. Only the " +
+        "subject turns into blocks; the surroundings change as the blocks clear",
+    },
+    "polygon-shatter": {
+      term: "polygon shatter",
+      body:
+        "the first subject fractures into large opaque flat-shaded chunks, like the facets of a low-polygon " +
+        "model, and the chunks burst outward in slow motion. The camera stays where it is and the framing " +
+        "does not change. The chunks turn around mid-flight and fly back along clean straight paths, locking " +
+        "together at the same place in the frame into the shape of the second subject, while the second shot " +
+        "appears behind them. The shot ends on the second subject, solid and fully resolved, with no loose " +
+        "chunks left. The chunks stay opaque and matte throughout, like painted blocks",
+    },
+  }
+
+  it.each(Object.keys(F1_BODIES))("%s renders `term (body)` at the tile-default levers", (id) => {
+    const { term, body } = F1_BODIES[id]!
+    expect(getTransitionPromptHint(id)).toBe(body)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+  })
+
+  it.each(Object.keys(F1_BODIES))("%s at middle / short / natural", (id) => {
+    const { term, body } = F1_BODIES[id]!
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
 describe("L1 — a cut spans nothing, so `full` adds no clause", () => {
   it.each(INSTANT_IDS)("%s + full renders no position clause", (id) => {
     const out = composeTransitionHintFromConnections(id, [], [], { position: "full", duration: "short", intensity: "natural" })

package/src/person.ts

@@ -694,6 +694,7 @@ export const PEOPLE: ReadonlyArray<Person> = [
   { id: "face-five-oclock-shadow", label: "Five-O'Clock Shadow", dimension: "facial-hair", description: "Heavier daily growth — denser than light stubble", promptHint: "a five-o'clock shadow, daily growth heavier than light stubble" },
 
   // -------------------- Skin Texture --------------------
+  { id: "texture-natural",    label: "Natural",     dimension: "skin-texture", description: "Real pores and natural variation", promptHint: "with natural, unretouched skin — visible pores and small, even variation in tone", term: "natural unretouched skin" },
   { id: "texture-smooth",     label: "Smooth",      dimension: "skin-texture", description: "Flawless, silky smooth skin", promptHint: "with flawless, silky smooth skin", term: "flawless smooth skin" },
   { id: "texture-wrinkled",   label: "Wrinkled",    dimension: "skin-texture", description: "Aged, deeply lined skin",     promptHint: "with deep wrinkles and aged skin texture", term: "deeply wrinkled aged skin" },
   { id: "texture-goosebumps", label: "Goosebumps",  dimension: "skin-texture", description: "Raised goosebumps on skin",   promptHint: "with goosebumps raised on the skin" },

package/src/setting.ts

@@ -50,6 +50,7 @@ export const SETTINGS: ReadonlyArray<Setting> = [
   { id: "bedroom",         label: "Bedroom",              category: "indoor",      description: "Intimate bedroom",                       promptHint: "set in an intimate bedroom with soft diffused window light, rumpled linen bedding and warm wood floors" },
   { id: "living-room",     label: "Living Room",          category: "indoor",      description: "Cozy residential living room",           promptHint: "set in a cozy residential living room with a plush sofa, wooden coffee table, soft lamplight, bookshelves and a warm family-home atmosphere" },
   { id: "kitchen",         label: "Kitchen",              category: "indoor",      description: "Warm home kitchen with morning light",   term: "home kitchen", promptHint: "set in a warm home kitchen with morning light, wood cabinets, a marble island with fresh produce and steam rising from a stovetop" },
+  { id: "bathroom",        label: "Bathroom",             category: "indoor",      description: "Bright everyday home bathroom",          promptHint: "set in a bright everyday home bathroom with a tiled wall, a mirror and a towel on a hook", term: "home bathroom" },
   { id: "hotel-room",      label: "Hotel Room",           category: "indoor",      description: "Elegant hotel room with city view",      promptHint: "set in an elegant hotel room with a neatly made king bed, heavy drapes, a panoramic city view through the window, minimalist desk and soft warm lamplight" },
   { id: "restaurant",      label: "Restaurant",           category: "indoor",      description: "Intimate candlelit restaurant",          promptHint: "set in an intimate restaurant interior with candlelit tables, white linen, leather booths, wine glasses catching warm light and a softly bustling dining room" },
   { id: "nightclub",       label: "Nightclub",            category: "indoor",      description: "Dark club with lasers and smoke",        promptHint: "set in a dark nightclub interior with a packed dance floor, laser and strobe lighting, thumping bass energy, silhouetted bodies and hazy atmospheric smoke" },
@@ -61,6 +62,7 @@ export const SETTINGS: ReadonlyArray<Setting> = [
   { id: "warehouse",       label: "Industrial Warehouse", category: "indoor",      description: "Cavernous warehouse with skylights",     promptHint: "set in a cavernous industrial warehouse with steel rafters, concrete floors and dust motes in shafts of light from skylights above" },
   { id: "subway-car",      label: "Subway Car",           category: "indoor",      description: "Moving subway interior",                 term: "subway car interior", promptHint: "set inside a moving subway car with fluorescent strip lights, graffiti-scarred windows and empty blue plastic seats" },
   { id: "taxi",            label: "Taxi Interior",        category: "indoor",      description: "Back seat of a city taxi at night",      promptHint: "set inside the back seat of a city taxi at night with rain-streaked windows, neon reflections sliding across the dashboard, the driver silhouetted against the windshield and the dim green glow of the fare meter" },
+  { id: "car-interior",    label: "Car Interior",         category: "indoor",      description: "Front seat of a parked car",             promptHint: "set in the front seat of a parked car, daylight through the side window", term: "parked car interior" },
   { id: "cathedral",       label: "Cathedral",            category: "indoor",      description: "Gothic cathedral interior",              term: "gothic cathedral interior", promptHint: "set in a vast gothic cathedral interior with vaulted stone ceilings, stained-glass kaleidoscopes and candlelit side chapels" },
   { id: "art-gallery",     label: "Art Gallery",          category: "indoor",      description: "Minimalist white-cube gallery",          promptHint: "set in a minimalist white-cube art gallery with polished concrete floor, precision track lighting and framed canvases on bare walls" },
   { id: "balcony",         label: "Balcony",              category: "indoor",      description: "Apartment balcony with urban view",      term: "apartment balcony", promptHint: "set on an apartment balcony with potted plants along the railing, a sweeping urban view beyond, soft daylight and a candid intimate atmosphere of a private outdoor pocket above the city" },

package/src/styling.ts

@@ -123,6 +123,7 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { 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" },
+  { id: "makeup-bare",      label: "Bare Face",     dimension: "makeup",     description: "No makeup at all",          promptHint: "with a completely bare face, no makeup at all", term: "bare face, no makeup" },
 
   // -------------------- Eyewear --------------------
   { id: "eyewear-sunglasses",      label: "Sunglasses",      dimension: "eyewear", description: "Generic dark sunglasses", promptHint: "wearing sunglasses" },
@@ -303,6 +304,7 @@ export const STYLINGS: ReadonlyArray<Styling> = [
   { id: "outfit-one-piece-swim",   label: "One-Piece Swimsuit", dimension: "outfit", description: "Fitted one-piece swimsuit",       promptHint: "in a fitted one-piece swimsuit" , adultOnly: true },
   { id: "outfit-lingerie",         label: "Lingerie Set",     dimension: "outfit", description: "Matching lingerie set",             promptHint: "in a matching lingerie set" , adultOnly: true },
   { 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-casual-home",      label: "At-Home Casual",   dimension: "outfit", description: "Soft tee or knit with relaxed trousers", promptHint: "wearing relaxed at-home clothes — a soft tee or knit top with comfortable trousers", term: "at-home casual clothes" },
   { 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", term: "ballerina leotard and tutu" },

package/src/transitions.ts

@@ -147,9 +147,9 @@ export const TRANSITIONS: ReadonlyArray<Transition> = [
   // ELEMENT — 14 entries — teleport via natural element
   // ============================================================================
   { id: "dissolve-to-mist",  label: "Dissolve to Mist",   category: "element", description: "Subject turns to mist, drifts, reforms",
-    promptHint: "the subject gradually dissolves into a soft cloud of mist that swirls and drifts across the frame, then the mist re-condenses into the new subject in the new setting" },
+    promptHint: "the first subject loses its solid form and turns into a soft cloud of fine mist, starting at its edges and working inward. The camera stays where it is and the framing does not change. The mist drifts through the frame and thins until the first shot is gone, then gathers again at the same place in the frame and condenses into the second subject as the second shot appears behind it. The shot ends on the second subject, solid and fully resolved, with no mist left. The second subject forms only out of the gathered mist" },
   { id: "water-splash",      label: "Water Splash",       category: "element", description: "Subject becomes water, splashes, reforms",
-    promptHint: "the subject liquefies into a cascade of water that splashes and pools, the water then surges upward and re-forms into the new subject in a new setting" },
+    promptHint: "the first subject turns to water and collapses into a splashing cascade that spreads across the lower part of the frame. The camera stays where it is and the framing does not change. The water surges upward at the same place in the frame and takes the shape of the second subject, while the second shot appears behind it as the spray falls away. The shot ends on the second subject, solid and fully resolved, with no water left on it. The second subject forms only out of the rising water" },
   { id: "sand-scatter",      label: "Sand Scatter",       category: "element", description: "Subject becomes sand, blown away, reforms",
     promptHint: "the subject crumbles into fine sand that is swept away by a gust of wind in a swirling vortex, then the sand particles converge and re-form into the new subject" },
   { id: "fire-burnup",       label: "Burn-Up",            category: "element", description: "Subject burns to embers, embers reform",
@@ -181,7 +181,7 @@ export const TRANSITIONS: ReadonlyArray<Transition> = [
   { id: "liquid-morph",      label: "Liquid Morph",       category: "morph", description: "Subject melts and reforms as new subject",
     promptHint: "smooth liquid morph: the first subject's surface becomes fluid and continuously deforms, flowing without breaks into the silhouette and details of the second subject" },
   { id: "pixelate-reform",   label: "Pixelate & Reform",  category: "morph", description: "Pixelates, scatters, reforms as new",
-    promptHint: "the first subject pixelates into large mosaic blocks that scatter outward across the frame, then the blocks converge and resolve into the new subject", term: "pixelate and reform" },
+    promptHint: "the first subject breaks into large square mosaic blocks, and the blocks scatter outward across the frame. The camera stays where it is and the framing does not change. The blocks fly back, lock together at the same place in the frame and sharpen into the second subject, while the second shot appears behind them. The shot ends on the second subject, fully sharp, with no blocks left. Only the subject turns into blocks; the surroundings change as the blocks clear", term: "pixelate and reform" },
   { id: "shatter-glass",     label: "Shatter & Reform",   category: "morph", description: "Subject shatters like glass, reforms",
     promptHint: "the first subject shatters like glass into hundreds of shards that fly outward, then the shards reverse direction in reverse time and reassemble into the new subject", term: "shatter like glass and reform" },
   { id: "origami-fold",      label: "Origami Fold",       category: "morph", description: "Subject folds like paper into new subject",
@@ -193,7 +193,7 @@ export const TRANSITIONS: ReadonlyArray<Transition> = [
   { id: "wireframe-morph",   label: "Wireframe Morph",    category: "morph", description: "Subject reduces to wireframe, reforms as new subject",
     promptHint: "the first subject's surface peels away to reveal a glowing geometric wireframe of polygons and edges, the wireframe flexes and re-tessellates into the topology of the new subject, then the new surface skins over the wireframe" },
   { id: "polygon-shatter",   label: "Polygon Shatter",    category: "morph", description: "Subject fragments into low-poly chunks, reassembles",
-    promptHint: "the first subject fractures into low-polygon faceted chunks that explode outward in slow motion, the polygons then reverse course and re-assemble in clean geometric flight paths into the silhouette of the new subject" },
+    promptHint: "the first subject fractures into large opaque flat-shaded chunks, like the facets of a low-polygon model, and the chunks burst outward in slow motion. The camera stays where it is and the framing does not change. The chunks turn around mid-flight and fly back along clean straight paths, locking together at the same place in the frame into the shape of the second subject, while the second shot appears behind them. The shot ends on the second subject, solid and fully resolved, with no loose chunks left. The chunks stay opaque and matte throughout, like painted blocks" },
   { id: "melt-down",         label: "Melt Down",          category: "morph", description: "Subject melts into puddle, reforms as new",
     promptHint: "the first subject's form softens and melts downward like wax, collapsing into a glossy puddle on the ground, the puddle then surges upward and re-solidifies into the new subject standing in the new scene", term: "melt into a puddle and reform" },