@nodaro/prompts 1.5.0 → 1.7.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, SOCIAL_POST_NODE_TYPES, PASSTHROUGH_TYPES, pickIds, getFurniture, getWeapon, getVehicle, getAnimal, DEFAULT_USAGE_MODE, usageModeDirective, DEFAULT_LOCATION_USAGE_MODE, imageReferenceLimit, findCharacterMentionTokens, findLocationMentionTokens, NATIVE_NEGATIVE_PROMPT_MODELS, getMaxNegativePromptChars, getMaxImagePromptChars, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, roleToPhrase, resolveDefaultRole, SEEDANCE_2_REF_LIMITS, ANIMALS, VEHICLES, WEAPONS, FURNITURE, PLACEHOLDER_CHARACTER_NAME, REFERENCE_ROLE_PRESETS, normalizeRoleSlug, defaultRoleForSource, locationReferencePhotoKindLabel, resolveNodeRefs } from '@nodaro/shared';
+import { ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, SOCIAL_POST_NODE_TYPES, FURNITURE, WEAPONS, VEHICLES, ANIMALS, PASSTHROUGH_TYPES, pickIds, getFurniture, getWeapon, getVehicle, getAnimal, DEFAULT_USAGE_MODE, usageModeDirective, DEFAULT_LOCATION_USAGE_MODE, imageReferenceLimit, findCharacterMentionTokens, findLocationMentionTokens, NATIVE_NEGATIVE_PROMPT_MODELS, getMaxNegativePromptChars, getMaxImagePromptChars, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, roleToPhrase, resolveDefaultRole, SEEDANCE_2_REF_LIMITS, PLACEHOLDER_CHARACTER_NAME, REFERENCE_ROLE_PRESETS, normalizeRoleSlug, defaultRoleForSource, locationReferencePhotoKindLabel, resolveNodeRefs } from '@nodaro/shared';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -67,6 +67,25 @@ function buildIdentityLockLine(ref, binding) {
   return text ? interpolate(text) : null;
 }
 
+// src/reference-rules.ts
+var REFERENCE_RULES = "Do not use anything from reference images unless specified explicitly. All elements taken from reference images must preserve likeness. Compose them naturally into a single image.";
+var REFERENCE_RULES_MULTI_PERSON = "Do not take anything from the reference images unless specified explicitly. Do not alter face structure. Do not blend faces. Preserve the likeness of every element taken. Compose them naturally into a single image.";
+var FILM_STILL_PREFIX = "Film still of";
+function filmStillPrefix(shotSize) {
+  const shot = shotSize?.trim();
+  return shot ? `${shot} film still of` : FILM_STILL_PREFIX;
+}
+var SCENE_FRAME_RULE = "Nobody looks at the camera.";
+var CINEMATIC_LOOK_TAIL = "Shot on Super 16mm Kodak 7298 with Canon K35 lenses, soft naturalistic window light mixed with dim tungsten practicals and muted fluorescent spill, earthy muted palette with faded greens, warm skin tones and gentle shadow fall-off";
+function referenceRulesBlock(opts) {
+  const parts = [];
+  if (opts?.referenceRules !== false) {
+    parts.push(opts?.multiPerson === true ? REFERENCE_RULES_MULTI_PERSON : REFERENCE_RULES);
+  }
+  if (opts?.sceneFrame === true) parts.push(SCENE_FRAME_RULE);
+  return parts.join(" ");
+}
+
 // src/framing.ts
 var FRAMINGS = [
   // Shot size (how much of the subject is in frame)
@@ -10511,6 +10530,7 @@ function assembleSunoInput(input) {
     styleWeight: data.styleWeight,
     weirdnessConstraint: data.weirdnessConstraint,
     audioWeight: data.audioWeight,
+    duration: data.duration,
     customMode,
     instrumental: data.instrumental ?? false,
     ...input.persona ?? {}
@@ -25672,9 +25692,10 @@ function date4(params) {
 
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
-
-// src/picker-analyzer-registry.ts
 var PERSON_EXCLUDED = /* @__PURE__ */ new Set(["age-custom"]);
+function tagDim(arr, dimension) {
+  return arr.map((e) => ({ id: e.id, label: e.label, description: e.description, dimension }));
+}
 var personCleanup = (patch, mode) => {
   if (mode === "override") {
     patch.customAge = void 0;
@@ -25729,9 +25750,148 @@ var PICKER_ANALYZER_REGISTRY = {
     field: "cameraFormat",
     label: "Camera / Film Stock",
     entries: CAMERA_FORMATS
+  },
+  // ─── Text-to-picker expansion (Cine AI Fill): every remaining catalog ─────
+  // Flat single-value pickers — field names match the picker wiring's
+  // valueField (and the node-data shape the published-app input card writes).
+  setting: { kind: "flat", toolName: "emit_setting", field: "setting", label: "Setting", entries: SETTINGS },
+  atmosphere: { kind: "flat", toolName: "emit_atmosphere", field: "atmosphere", label: "Atmosphere", entries: ATMOSPHERES },
+  style: { kind: "flat", toolName: "emit_style", field: "style", label: "Style", entries: STYLES },
+  mood: { kind: "flat", toolName: "emit_mood", field: "mood", label: "Mood", entries: MOODS },
+  "color-look": { kind: "flat", toolName: "emit_color_look", field: "colorLook", label: "Color / Look", entries: COLOR_LOOKS },
+  photographer: { kind: "flat", toolName: "emit_photographer", field: "photographer", label: "Photographer / Artist", entries: PHOTOGRAPHERS },
+  aesthetic: { kind: "flat", toolName: "emit_aesthetic", field: "aesthetic", label: "Aesthetic / Microtrend", entries: AESTHETICS },
+  era: { kind: "flat", toolName: "emit_era", field: "era", label: "Era / Period", entries: ERAS },
+  "photo-genre": { kind: "flat", toolName: "emit_photo_genre", field: "photoGenre", label: "Photo Genre", entries: PHOTO_GENRES },
+  backdrop: { kind: "flat", toolName: "emit_backdrop", field: "backdrop", label: "Backdrop", entries: BACKDROPS },
+  "render-quality": { kind: "flat", toolName: "emit_render_quality", field: "renderQuality", label: "Render Quality", entries: RENDER_QUALITIES },
+  "composition-effects": { kind: "flat", toolName: "emit_composition_effects", field: "compositionEffect", label: "Composition Effect", entries: COMPOSITION_EFFECTS },
+  "post-process-effects": { kind: "flat", toolName: "emit_post_process_effects", field: "postProcess", label: "Post-Process Effect", entries: POST_PROCESS_EFFECTS },
+  "action-fx": { kind: "flat", toolName: "emit_action_fx", field: "actionFx", label: "Action FX", entries: ACTION_FX },
+  "loop-subject": { kind: "flat", toolName: "emit_loop_subject", field: "loopSubject", label: "Loop Subject", entries: LOOP_SUBJECTS },
+  transition: { kind: "flat", toolName: "emit_transition", field: "transition", label: "Transition", entries: TRANSITIONS },
+  "character-fx": { kind: "flat", toolName: "emit_character_fx", field: "characterFx", label: "Character FX", entries: CHARACTER_FX },
+  pose: { kind: "flat", toolName: "emit_pose", field: "pose", label: "Pose", entries: POSES },
+  material: { kind: "flat", toolName: "emit_material", field: "material", label: "Material", entries: MATERIALS },
+  "held-prop": { kind: "flat", toolName: "emit_held_prop", field: "heldProp", label: "Held Prop", entries: HELD_PROPS },
+  "camera-motion": { kind: "flat", toolName: "emit_camera_motion", field: "cameraMotion", label: "Camera Motion", entries: CAMERA_MOTIONS },
+  animal: { kind: "flat", toolName: "emit_animal", field: "animal", label: "Animal", entries: ANIMALS },
+  vehicle: { kind: "flat", toolName: "emit_vehicle", field: "vehicle", label: "Vehicle", entries: VEHICLES },
+  weapon: { kind: "flat", toolName: "emit_weapon", field: "weapon", label: "Weapon", entries: WEAPONS },
+  furniture: { kind: "flat", toolName: "emit_furniture", field: "furniture", label: "Furniture", entries: FURNITURE },
+  // Discriminated multi-dim pickers. lighting/temporal/exposure discriminate
+  // on the single catalog's `category`; the sound/voice pickers span several
+  // per-field catalogs, so their entries are synthesized with an explicit
+  // `dimension` tag (tagDim below) — same wire shape either way.
+  lighting: {
+    kind: "discriminated",
+    toolName: "emit_lighting",
+    discriminator: "category",
+    order: LIGHTING_CATEGORY_ORDER,
+    fieldByKey: LIGHTING_FIELD_BY_CATEGORY,
+    labels: LIGHTING_CATEGORY_LABELS,
+    entries: LIGHTINGS,
+    limitFn: () => 1
+  },
+  temporal: {
+    kind: "discriminated",
+    toolName: "emit_temporal",
+    discriminator: "category",
+    order: ["speed", "freeze", "direction", "shutter"],
+    fieldByKey: { speed: "temporalSpeed", freeze: "temporalFreeze", direction: "temporalDirection", shutter: "temporalShutter" },
+    labels: { speed: "Playback Speed", freeze: "Freeze", direction: "Direction", shutter: "Shutter" },
+    entries: TEMPORALS,
+    limitFn: () => 1
+  },
+  "exposure-settings": {
+    kind: "discriminated",
+    toolName: "emit_exposure_settings",
+    discriminator: "category",
+    order: ["aperture", "shutter-speed", "iso"],
+    fieldByKey: { aperture: "aperture", "shutter-speed": "shutterSpeed", iso: "isoValue" },
+    labels: { aperture: "Aperture", "shutter-speed": "Shutter Speed", iso: "ISO" },
+    entries: EXPOSURE_SETTINGS,
+    limitFn: () => 1
+  },
+  "music-genre": {
+    kind: "discriminated",
+    toolName: "emit_music_genre",
+    discriminator: "dimension",
+    order: ["genre", "subgenre", "era"],
+    fieldByKey: { genre: "genre", subgenre: "subgenre", era: "era" },
+    labels: { genre: "Genre", subgenre: "Subgenre", era: "Era" },
+    entries: [
+      ...tagDim(MUSIC_GENRES, "genre"),
+      // Subgenres carry promptHint but no description — the hint doubles as
+      // the legend text (it describes the sound well enough for matching).
+      ...MUSIC_GENRES.flatMap(
+        (g) => g.subgenres.map((s) => ({ id: s.id, label: s.label, description: s.promptHint, dimension: "subgenre" }))
+      ),
+      ...tagDim(MUSIC_ERAS, "era")
+    ],
+    limitFn: (k) => k === "genre" ? 2 : 1
+  },
+  "music-mood": {
+    kind: "discriminated",
+    toolName: "emit_music_mood",
+    discriminator: "dimension",
+    order: ["energy", "emotion", "vibe"],
+    fieldByKey: { energy: "energy", emotion: "emotion", vibe: "vibe" },
+    labels: { energy: "Energy", emotion: "Emotion", vibe: "Vibe" },
+    entries: [...tagDim(MUSIC_ENERGIES, "energy"), ...tagDim(MUSIC_EMOTIONS, "emotion"), ...tagDim(MUSIC_VIBES, "vibe")],
+    limitFn: (k) => k === "energy" ? 1 : 2
+  },
+  instrumentation: {
+    kind: "discriminated",
+    toolName: "emit_instrumentation",
+    discriminator: "dimension",
+    order: ["instruments", "production", "vocalPresence", "singingStyle"],
+    fieldByKey: { instruments: "instruments", production: "production", vocalPresence: "vocalPresence", singingStyle: "singingStyle" },
+    labels: { instruments: "Instruments", production: "Production Style", vocalPresence: "Vocal Presence", singingStyle: "Singing Style" },
+    entries: [
+      ...tagDim(INSTRUMENTS, "instruments"),
+      ...tagDim(PRODUCTION_STYLES, "production"),
+      ...tagDim(VOCAL_PRESENCE, "vocalPresence"),
+      ...tagDim(SINGING_STYLES, "singingStyle")
+    ],
+    limitFn: (k) => k === "instruments" ? 3 : k === "production" ? 1 : 2
+  },
+  "voice-character": {
+    kind: "discriminated",
+    toolName: "emit_voice_character",
+    discriminator: "dimension",
+    order: ["age", "gender", "language", "accent", "timbre"],
+    fieldByKey: { age: "age", gender: "gender", language: "language", accent: "accent", timbre: "timbre" },
+    labels: { age: "Age", gender: "Gender", language: "Language", accent: "Accent", timbre: "Timbre" },
+    entries: [
+      ...tagDim(VOICE_AGES, "age"),
+      ...tagDim(VOICE_GENDERS, "gender"),
+      ...tagDim(VOICE_LANGUAGES, "language"),
+      ...tagDim(VOICE_ACCENTS, "accent"),
+      ...tagDim(VOICE_TIMBRES, "timbre")
+    ],
+    limitFn: (k) => k === "language" ? 2 : 1
+  },
+  "voice-delivery": {
+    kind: "discriminated",
+    toolName: "emit_voice_delivery",
+    discriminator: "dimension",
+    order: ["pace", "emotion", "archetype"],
+    fieldByKey: { pace: "pace", emotion: "emotion", archetype: "archetype" },
+    labels: { pace: "Pace", emotion: "Emotion", archetype: "Archetype" },
+    entries: [...tagDim(VOICE_PACES, "pace"), ...tagDim(VOICE_EMOTIONS, "emotion"), ...tagDim(VOICE_ARCHETYPES, "archetype")],
+    limitFn: () => 1
   }
 };
 var PICKER_TYPES = Object.keys(PICKER_ANALYZER_REGISTRY);
+var PICKER_ANALYZER_FAMILIES = {
+  scene: ["setting", "atmosphere", "backdrop", "era", "temporal"],
+  look: ["style", "color-look", "mood", "aesthetic", "photographer", "photo-genre", "render-quality", "composition-effects", "post-process-effects"],
+  camera: ["framing", "camera-motion", "lens", "camera-format", "lighting", "exposure-settings"],
+  character: ["person", "styling", "pose", "character-fx"],
+  elements: ["animal", "vehicle", "weapon", "furniture", "held-prop", "material", "action-fx", "loop-subject", "transition"],
+  audio: ["music-genre", "music-mood", "instrumentation", "voice-character", "voice-delivery"]
+};
 var ANALYZABLE_PICKER_TYPES = new Set(PICKER_TYPES);
 function isAnalyzablePicker(t) {
   return ANALYZABLE_PICKER_TYPES.has(t);
@@ -26038,14 +26198,16 @@ function buildWardrobeHints(value) {
 
 // src/provider-prompt-doctrine.ts
 var SEEDANCE_2_DOCTRINE = {
-  providers: ["seedance-2", "seedance-2-fast", "seedance-2-mini"],
-  heading: "Seedance 2.0 (seedance-2, seedance-2-fast, seedance-2-mini)",
+  providers: ["seedance-2", "seedance-2-fast", "seedance-2-mini", "seedance-2-5"],
+  heading: "Seedance 2 (seedance-2, seedance-2-fast, seedance-2-mini, seedance-2-5)",
   tips: [
     "Storyboard complex videos as 'Shot 1: \u2026 Shot 2: \u2026' WITHOUT timestamps \u2014 timed shots like '(0-3s)' are officially unstable and can break generation.",
     "One camera movement per shot; describe actions per body part with degree ('slowly raises a hand'); express emotion as physical detail, never abstract words.",
     "Native multi-track audio \u2014 cue it inline: \uFF08background music\uFF09, <sound effects>, and quoted dialogue.",
     "References go by ordinal (@Image 1, Video 2) in attachment order; earlier = higher priority. Identity = ONE headshot + ONE full-body (multi-view sheets cause ID drift). 4-5 assets total beats maxing the 9/3/3 caps.",
-    "No negative-prompt parameter \u2014 put constraints in the prompt: 'keep it subtitle-free, do not generate a watermark, do not generate a logo'."
+    "No negative-prompt parameter \u2014 put constraints in the prompt: 'keep it subtitle-free, do not generate a watermark, do not generate a logo'.",
+    "seedance-2-5 only: one shot runs to 30s (the 2.0 SKUs stop at 15s), so storyboard a whole beat instead of planning a stitch. Ref caps are wider (30/10/10), but 4-5 assets still gives the best identity fidelity.",
+    "Auto-path formula: Subject \u2192 Action \u2192 Environment \u2192 Camera \u2192 Style \u2192 Constraints in 60-100 words; ONE camera instruction (chain with 'then'); separate camera motion from subject motion; always add one lighting phrase."
   ],
   doctrine: `Prompt structure (front-load what matters most):
 precise subject \u2192 action details \u2192 scene/environment \u2192 lighting & color tone \u2192 camera movement \u2192 visual style \u2192 image quality \u2192 constraints.
@@ -26057,6 +26219,12 @@ precise subject \u2192 action details \u2192 scene/environment \u2192 lighting &
 - Prefer slow, gentle, continuous movements over high-burst action (sprints, big jumps, violent rolls morph). Describe actions per body part with quantified degree: "slowly raises a hand", "pushes hard off the ground". Chain actions with inertia: "uses the momentum of the turn to naturally raise an arm".
 - Express emotion as externalized physical detail, never abstract words: not "very sad" but "lowering the head, shoulders trembling slightly, eyes reddening, fingers clutching the corner of clothing".
 
+**Generation differences (seedance-2-5 vs the 2.0 SKUs)**
+- A single 2.5 shot runs to 30s, where every 2.0 SKU stops at 15s. Plan a complete 4-6 shot beat inside ONE generation instead of splitting it into two clips and stitching \u2014 no seam to hide, and continuity holds because it never leaves the model.
+- 2.5 also takes far more reference material (30 images / 10 videos / 10 audio vs 9/3/3). Treat that as room for COVERAGE \u2014 more distinct characters, locations and props in one shot \u2014 not as licence to pile refs onto one identity. The "ONE headshot + ONE full-body, 4-5 assets total" rule above still produces the best likeness on 2.5.
+- 2.5 renders at 480p/720p only: there is no 1080p or 4K tier, so route a job that needs one to seedance-2 (which has both) or upscale afterwards.
+- With a start frame, 2.5 always derives the output aspect from that frame \u2014 an explicit aspect ratio is rejected outright, so compose the frame at the ratio you want.
+
 **References (when reference media is attached)**
 - Refer to assets by ordinal in attachment order: "@Image 1", "Video 2", "Audio 1". Asset ORDER is priority \u2014 put the most identity-critical asset first. (In the editor, the \`{image:N:label}\` / \`{video:N}\` / \`{audio:N}\` prompt tokens auto-emit this binding \u2014 \`{image:1:person}\` resolves to "the person from @image_1" \u2014 so a wired reference and its mention stay in sync.)
 - Define each subject once, then reuse the label consistently: 'Define the woman in the red dress in Image 1 as the courier' \u2026 'the courier opens the door'. In multi-character scenes bind every character to its image ("the man from Image 1 hands the box to the woman from Image 2") and append: "do not generate duplicate copies of the same character".
@@ -26077,11 +26245,34 @@ precise subject \u2192 action details \u2192 scene/environment \u2192 lighting &
 **Known weaknesses \u2192 workarounds**
 - Text rendering is weak: keep on-screen text to short common words; for exact text or logos, attach the artwork as a reference image and instruct "the logo from Image N stays in the corner unchanged".
 - More than 4 referenced people gets unstable: group people into composite images of \u22644 first (image generation), then reference those composites.
-- Repeated extension degrades quality: prefer high-definition reference assets and avoid stacking many continuations.`
+- Repeated extension degrades quality: prefer high-definition reference assets and avoid stacking many continuations.
+
+**Auto-path formula (community-sourced enrichment \u2014 apiyi.com Seedance 2.0 prompt guide,
+higgsfield.ai 4K breakdown; captured 2026-08-09)**
+- Six steps IN ORDER, 60-100 words total (longer measurably degrades): Subject \u2192 Action \u2192 Environment \u2192 Camera \u2192 Style \u2192 Constraints.
+- ONE primary camera instruction per shot. Compound moves chain with "then": "camera slow tracking then subtle rise" \u2014 never two competing verbs. The 8 reliable camera types: push-in, pull-out, pan, tracking, orbit/arc, aerial, handheld, locked-off.
+- SEPARATE camera movement from subject movement \u2014 the single biggest quality lever: "The dancer spins slowly. Camera holds fixed framing." \u2014 never "spinning camera around a dancing person".
+- Pace with human words (slow / gentle / gradual / smooth / controlled) \u2014 never fps numbers or f-stops in the basic path.
+- ALWAYS add one lighting phrase (highest-impact single addition): golden hour / rim light / neon glow / backlit / overcast.
+- Bake stability constraints in: "avoid jitter and bent limbs", "avoid temporal flicker", "avoid identity drift".
+- Ban vague adjectives standing alone ("epic", "amazing", "beautiful", bare "cinematic") \u2014 every adjective needs a concrete noun.
+- Mode notes: i2v \u2014 skip subject description (the frame has it), focus on motion, append "preserve composition and colors". v2v \u2014 describe the style TRANSFORM, keep motion + identity.
+- Advanced (pro path): focal angles in degrees ("47\xB0 normal", "29\xB0 telephoto", "107\xB0 wide"); "180\xB0 shutter" for filmic motion blur; handheld texture as "organic shake, micro-drift, subtle dutch"; "white balance locked 5200K"; explicit POSITIVE LOCKS section + "100% matches the reference" for identity-critical shots.
+
+**Camera-path control \u2014 the magenta-line method (STORYBOARD community technique; the
+manual pro path for precise trajectories, NOT the auto path)**
+1. Duplicate the start frame; on the COPY draw a thick magenta line + arrowhead \u2014 the line is the camera's flight path, the arrow its end point. Keep the clean original.
+2. Attach BOTH frames and declare the guide: "Image N contains a magenta line and arrow \u2014 a hidden camera trajectory guide, NOT part of the scene. Completely remove it: no line, no arrow, no paint, no trail, no reflection." Skipping the removal order RENDERS the line.
+3. Command the path: "one continuous FPV drone glide following the S-shaped curve as closely as possible \u2014 do not shortcut. Camera motion is the priority." Lock the clean frame as first frame + scene reference; lock the destination frame if wired.
+4. Pace with timing blocks ("[00:00-00:02] rise over the rooftop \u2026 [00:07-00:09] settle on the doorway") and keep any dialogue SHORT \u2014 long lines fight the move.
+5. Assign image-input roles explicitly: first-frame/scene-ref \xB7 destination frame \xB7 path-guide \xB7 3-6 character-identity refs \u2014 and bind identities with @-mentions exactly like the platform's reference pills.`
 };
 var KLING_AUDIO_DOCTRINE = {
-  providers: ["kling", "kling-3.0", "kling-3-omni"],
-  heading: "Kling 2.6 / 3.0 / 3 Omni (kling, kling-3.0, kling-3-omni)",
+  // kling-turbo (2.5 Turbo Pro) + kling-master (2.1 Master) are SILENT tiers of
+  // the same engine: the structure/motion guidance applies, the Audio block
+  // does not (variant note in the doctrine body).
+  providers: ["kling", "kling-3.0", "kling-3-omni", "kling-turbo", "kling-master"],
+  heading: "Kling 2.1 / 2.5 / 2.6 / 3.0 / 3 Omni (kling, kling-3.0, kling-3-omni, kling-turbo, kling-master)",
   tips: [
     'Kling speaks scripted dialogue natively with lip sync \u2014 quote the line and enable sound: [Anna: warm calm voice]: "We made it." On kling/kling-3.0 audio raises the credit cost; kling-3-omni includes it.',
     "Structure prompts as Scene \u2192 character/element \u2192 Motion \u2192 Audio \u2192 style. Put ALL sound in one 'Audio:' block: dialogue in quotes, then SFX and ambience described plainly ('rain tapping on glass, no music').",
@@ -26113,11 +26304,240 @@ var KLING_AUDIO_DOCTRINE = {
 
 **Limits**
 - Kling 2.6 prompts cap at 1000 characters \u2014 front-load scene + dialogue and trim style tails first. kling-3.0 accepts long prompts.
-- Durations: 2.6 = 5/10s; 3.0/omni = 3-15s. A spoken line needs roughly 1s per 2-3 words \u2014 don't script more dialogue than the clip can hold.`
+- Durations: 2.6 = 5/10s; 3.0/omni = 3-15s. A spoken line needs roughly 1s per 2-3 words \u2014 don't script more dialogue than the clip can hold.
+
+**Variant note \u2014 kling-turbo (2.5 Turbo Pro) & kling-master (2.1 Master)**
+- SILENT tiers: no audio parameter, so the entire Audio block above does not apply \u2014 skip dialogue/SFX cues; the Scene \u2192 Character \u2192 Motion \u2192 Style structure and motion guidance carry over unchanged.
+- Durations 5/10s; kling-turbo takes an end frame (tail_image_url); kling-master is single-image i2v.`
+};
+var MINIMAX_H3_DOCTRINE = {
+  providers: ["minimax-h3"],
+  heading: "MiniMax Hailuo 3 (minimax-h3)",
+  tips: [
+    "Natural-language prompts up to 7000 chars. Front-load what matters: subject \u2192 action \u2192 scene/environment \u2192 lighting \u2192 camera move \u2192 style. One camera movement per shot.",
+    "Output 2K (default) or 768P (cheaper tier). Aspect: pure text-to-video needs a concrete ratio (21:9/16:9/4:3/1:1/3:4/9:16); reference runs default to adaptive (match the input).",
+    "References go by ordinal in attachment order (@Image 1, Video 1) \u2014 earlier = higher priority. Caps: 9 images, 3 videos (2-15s each, \u226415s total), 3 audio clips (\u226415s total).",
+    "Reference audio drives speech/lip-sync but never rides alone \u2014 pair it with an image or video reference. Audio input is free; the first 5 input images are free, extras bill per image.",
+    "No negative-prompt parameter \u2014 put constraints in the prompt text: 'keep it subtitle-free, do not generate a watermark, do not generate a logo'."
+  ],
+  doctrine: `Prompt structure (front-load what matters most):
+precise subject \u2192 action details \u2192 scene/environment \u2192 lighting & color tone \u2192 camera movement \u2192 visual style \u2192 image quality \u2192 constraints. Prompts are natural language, 1-7000 characters, across all three modes.
+
+**Modes (picked automatically from the wired inputs)**
+- First frame and/or last frame connected, nothing else \u2192 exact frame mode (image-to-video): the output opens on the first frame and/or closes on the last. The clip's aspect is inferred from the frame \u2014 there is no aspect parameter in this mode.
+- ANY reference connected (image, video, or audio) \u2192 reference mode (reference-to-video): frames ride along as reference images with a prompt directive binding them to the opening/closing position. Aspect defaults to adaptive (matches the input); a concrete ratio can be forced.
+- Nothing visual connected \u2192 text-to-video. A concrete aspect ratio is required (21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 \u2014 no adaptive); Nodaro renders 16:9 unless one is picked.
+
+**References (when reference media is attached)**
+- Refer to assets by ordinal in attachment order: "@Image 1", "Video 1", "Audio 1". Put the identity-critical asset first. (In the editor, the \`{image:N:label}\` / \`{video:N}\` / \`{audio:N}\` prompt tokens auto-emit this binding, so a wired reference and its mention stay in sync.)
+- Caps: 9 reference images; 3 reference videos, each 2-15s and \u226415s combined; 3 reference audio clips, \u226415s combined. Reference audio cannot be used alone \u2014 it must accompany an image or video reference.
+- Define each subject once, then reuse the label consistently ("the woman from @Image 1 \u2026 the woman opens the door"). A focused set of 4-5 assets beats maxing every cap.
+- Billing note: generated seconds AND reference-video input seconds bill at the same per-second rate; the first 5 input images are free and each extra image adds a small surcharge; audio input is free.
+
+**Audio**
+- Audio is always generated \u2014 there is no on/off toggle. With reference audio attached, the model syncs speech to the supplied track (the platform's lip-sync surface routes image + voice line through this mode automatically).
+- Quoted dialogue in the prompt gives the model the line to perform; describe the voice in words when no reference audio is supplied.
+
+**Duration & pacing**
+- 4-15 seconds, integer, default 6. Per-second pricing \u2014 a 15s clip costs ~3.7\xD7 a 4s clip, so pick the shortest duration that serves the shot.
+- One camera movement type per shot; chain actions with physical, quantified detail ("slowly raises a hand", "pushes hard off the ground") rather than abstract emotion words.
+
+**Constraints**
+- There is NO negative-prompt parameter \u2014 all constraints belong in the prompt text itself: "keep it subtitle-free, do not generate a watermark, do not generate a logo, stable picture".`
+};
+var VEO_31_DOCTRINE = {
+  providers: ["veo3", "veo3.1", "veo3_lite", "veo-1080p", "veo-4k", "veo-extend"],
+  heading: "VEO 3.1 \u2014 Quality / Fast / Lite (veo3, veo3.1, veo3_lite)",
+  tips: [
+    "Structure prompts as [Cinematography] + [Subject] + [Action] + [Context] + [Style & Ambiance] \u2014 lead with the camera, not the subject (Google's official formula).",
+    'Dialogue: quote the exact line with attribution \u2014 A woman says, "We have to leave now." (no subtitles). Cue sound as separate lines: SFX: thunder cracks; Ambient noise: quiet hum of a starship bridge.',
+    "Multi-shot pacing via timestamp blocks: [00:00-00:02] medium shot\u2026 [00:02-00:04] reverse shot\u2026 \u2014 VEO honors per-window actions inside one 8s generation.",
+    "Negative prompting is positive phrasing: not 'no buildings' but 'a desolate landscape with no buildings or roads'. Keep prompts under ~175 words \u2014 longer overloads the generation.",
+    "Start+end frame: pass both and describe the transition move ('smooth 180-degree arc ending on the POV behind her'). References (ingredients) keep characters/objects consistent and DO generate audio."
+  ],
+  doctrine: `Prompt structure (Google's official Veo 3.1 formula \u2014 lead with the camera):
+[Cinematography] + [Subject] + [Action] + [Context] + [Style & Ambiance].
+Example: "Medium shot, a tired corporate worker, rubbing his temples in exhaustion, in front of a bulky 1980s computer in a cluttered office late at night, lit by harsh fluorescents and the green monitor glow. Retro aesthetic, 1980s color film, slightly grainy."
+
+**Camera vocabulary (use the exact terms)**
+- Movement: dolly shot, tracking shot, crane shot, aerial view, slow pan, POV shot, 180-degree arc shot.
+- Composition: wide shot, medium shot, close-up, extreme close-up, two-shot, low angle, high angle.
+- Lens/focus: shallow depth of field, deep focus, wide-angle lens, macro lens, soft focus.
+
+**Audio (native, multi-track \u2014 dialogue / SFX / ambience)**
+- Dialogue: quote the exact line with attribution: The detective says in a weary voice, "Of all the offices in this town, you had to walk into mine." Append "(no subtitles)" \u2014 VEO otherwise tends to burn captions in.
+- Sound effects on their own line: "SFX: a crystal wine glass shatters on the marble floor". Ambient bed: "Ambient noise: rain against the window, distant traffic".
+- Sound can drive the visual ("the sound reverberating through the empty ballroom") \u2014 VEO syncs audio-visual timing.
+
+**Multi-shot timestamp prompting (inside one generation)**
+- Split the clip into [mm:ss-mm:ss] windows, one action per window:
+[00:00-00:02] Medium shot from behind a young explorer walking toward a clearing.
+[00:02-00:04] Reverse shot of her freckled face, eyes widening.
+[00:04-00:08] Wide, high-angle crane shot revealing the ruins below.
+- 4 / 6 / 8 second clips; budget ~2s per window.
+
+**Frames & references**
+- Start + end frame: wire both (imageUrls [start, end]) and describe the camera path between them \u2014 "a smooth 180-degree arc shot, starting front-facing and circling to end on the POV from behind her".
+- Reference images (ingredients): attach character/object/scene refs and name them in the prompt ("using the provided images for the detective and the office, \u2026"). Reference runs DO generate audio.
+
+**Constraints**
+- Negative prompting works by positive description: write "a desolate landscape with no buildings or roads", not "no buildings".
+- Keep prompts \u2264 ~175 words \u2014 beyond that instructions conflict and adherence drops. Resolution 720p/1080p; aspect 16:9 / 9:16.
+
+Sources: Google Cloud "Ultimate prompting guide for Veo 3.1"
+(cloud.google.com/blog/products/ai-machine-learning/ultimate-prompting-guide-for-veo-3-1),
+KIE VEO API docs (docs.kie.ai/veo3-api/generate-veo-3-video). Captured 2026-08-09.`
+};
+var GEMINI_OMNI_DOCTRINE = {
+  providers: ["gemini-omni-video"],
+  heading: "Gemini Omni Video (gemini-omni-video)",
+  tips: [
+    "Multimodal Google video with native audio: text-to-video, image-to-video, and video-edit through the same prompt surface. 4/6/8/10s; 720p/1080p or 4K tier.",
+    "Structure like the platform default: subject \u2192 action \u2192 scene \u2192 lighting \u2192 camera \u2192 style. Quote dialogue lines to have them spoken; describe SFX/ambience plainly in the prompt.",
+    "Text-to-video REQUIRES a concrete aspect ratio (the API hard-rejects a missing one); image runs infer aspect from the input.",
+    "Reference images ride along as additional imageUrls \u2014 bind them in the prompt ('the woman from the first image'). Video-edit: wire a source clip and describe the change, not the whole scene."
+  ],
+  doctrine: `Prompt structure (no public Google prompt guide exists for the Omni video endpoint \u2014
+the API contract is the doctrine source, like MiniMax H3; structure guidance mirrors the
+platform's ordinal-reference conventions):
+subject \u2192 action \u2192 scene/environment \u2192 lighting \u2192 camera movement \u2192 style \u2192 constraints.
+
+**Modes (picked from the wired inputs)**
+- Nothing visual \u2192 text-to-video. A concrete aspect ratio is REQUIRED \u2014 the API hard-rejects a missing one (Nodaro sends the node's ratio; there is no adaptive).
+- Image(s) wired \u2192 image-to-video: the first image anchors the scene; extra images are references \u2014 bind each in the prompt ("the woman from the first image", "the interior from the second image").
+- Source video wired \u2192 video-edit (served through the same handle): describe the CHANGE ("replace the daylight with dusk, keep the motion and framing"), not a full re-description.
+
+**Audio (native)**
+- Audio is generated with the clip. Quote dialogue to have it spoken; describe SFX and ambience plainly ("rain on glass, low synth bed"). State exclusions ("no music") or a bed may be invented.
+
+**Duration & tiers**
+- 4 / 6 / 8 / 10 seconds. 720p/1080p tier or the pricier 4K tier \u2014 pick 4K only when the deliverable needs it (nearly 2\xD7 the credits).
+
+Source: KIE gemini-omni-video market contract (parameters + live behavior probed for the
+aspect-ratio hard-reject, see providers/kie/video.ts). Captured 2026-08-09.`
+};
+var GROK_IMAGINE_DOCTRINE = {
+  providers: ["grok-i2v", "grok-imagine-video-1.5"],
+  heading: "Grok Imagine (grok-i2v, grok-imagine-video-1.5)",
+  tips: [
+    "Keep prompts simple and direct \u2014 Subject + Action + Setting + Camera + Mood. Grok expands the prompt itself; over-specification fights the expander.",
+    "Image-to-video: the input image IS the first frame (composition, identity, and style are preserved) \u2014 describe the MOTION, don't re-describe the still.",
+    "Video 1.5: 1-15s (default 8), 480p/720p/1080p, up to 7 input images (1080p allows only one). Native audio incl. music, SFX, and lip-synced dialogue \u2014 quote the line to have it spoken.",
+    "Aspect ratio applies to text runs (1:1/16:9/9:16/3:2/2:3/auto); a single input image locks the output to the image's own aspect."
+  ],
+  doctrine: `Prompt structure (xAI's guidance is minimal by design \u2014 the model auto-expands prompts):
+Subject + Action + Setting + Camera + Lighting/Mood, written simply and directly. Reduce
+descriptions of static/unchanged parts \u2014 spend the words on what MOVES.
+
+**Image-to-video (the primary mode)**
+- The input image is the FIRST FRAME, not a loose reference: composition, subject identity, and visual style carry over. Describe motion and camera only ("she turns toward the window as the camera slowly pushes in"); re-describing the still wastes adherence.
+- grok-imagine-video-1.5 accepts up to 7 images (identity/scene references beyond the first frame); at 1080p only ONE image is allowed.
+
+**Audio (video-1.5)**
+- Native audio generates with the clip \u2014 background music, SFX, and lip-synced dialogue. Quote the spoken line; describe the music/SFX plainly. There is no audio toggle on the KIE contract \u2014 cue (or exclude) sound in the prompt text.
+
+**Durations / tiers**
+- grok-i2v: 6 or 10 seconds. grok-imagine-video-1.5: 1-15 seconds in 1s steps (default 8), 480p (default) / 720p / 1080p. Prompt cap 4096 chars \u2014 but shorter is better here.
+
+Sources: KIE Grok Imagine contracts (docs.kie.ai/market/grok-imagine/image-to-video,
+docs.kie.ai/market/grok-imagine/1-5-preview), xAI Grok Imagine 1.5 release notes
+(x.ai/news/grok-imagine-1-5). Captured 2026-08-09.`
+};
+var WAN_DOCTRINE = {
+  providers: ["wan", "wan-i2v", "wan-turbo", "wan-flash", "wan-2.7", "wan-2.7-i2v", "wan-2.7-t2v", "wan-2.7-pro", "wan-videoedit"],
+  heading: "Wan 2.x (wan, wan-i2v, wan-turbo, wan-2.7 family)",
+  tips: [
+    "Alibaba's official formula: Entity + Scene + Motion (basic) \u2192 add Aesthetic control + Stylization (advanced). Image-to-video: Motion + Camera only \u2014 the image already defines entity and scene.",
+    "Sound (2.5+): append a sound description block \u2014 voice / sound effects / background music. Avoid scripting EXACT lip-synced lines (official anti-pattern); describe the voice and intent instead.",
+    "Multi-shot (2.6/2.7): Overall description + shot number + timestamp + per-shot content. For ONE continuous take write 'Generate single shot' (the shot_type parameter is gone in 2.7).",
+    "References go by 'Image 1' / 'Video 1' (capitalized, with a space). Anti-patterns: naming real people, demanding exact legible text, rapid scene changes in one clip, very long choreography.",
+    "Style words are strong levers: cyberpunk, claymation, pixel style, felt style, tilt-shift, time-lapse. wan-videoedit: describe the transform, keep motion + identity."
+  ],
+  doctrine: `Prompt structure (Alibaba Model Studio's official formulas):
+- Basic: Entity + Scene + Motion.
+- Advanced: Entity (description) + Scene (description) + Motion (description) + Aesthetic control + Stylization.
+- Image-to-video: Motion + Camera movement ONLY \u2014 the wired image already defines entity and scene; re-describing it fights the frame.
+- Sound (2.5/2.6/2.7): \u2026 + Sound description (voice / sound effects / background music).
+- Multi-shot (2.6/2.7): Overall description + Shot number + Timestamp + Shot content.
+- Reference-to-video (2.6/2.7): Reference identifier + Action + Scene + optional Lines + optional BGM.
+
+**Camera vocabulary**
+push-in (intimacy/tension), pull-out (scale/isolation), tracking shot, orbit, fixed camera, and compound movements chained sequentially for epic scale.
+
+**Single-shot control (2.7)**
+- The shot_type parameter no longer exists \u2014 write "Generate single shot" in the prompt to force one continuous take; otherwise 2.7's planner may cut.
+
+**References**
+- English format is "Image 1" / "Video 1" (capitalized, space-separated) \u2014 bind every wired asset by that name or it may be ignored.
+
+**Official anti-patterns (from Alibaba's guide)**
+- Do NOT name specific real people.
+- Do NOT script exact lip-synced dialogue \u2014 describe the voice and intent ("she murmurs a reassurance, warm and low") instead of demanding word-perfect lips.
+- Avoid rapid scene changes inside a single clip, very long choreographed sequences, and demands for exactly legible on-screen text.
+
+**Stylization**
+- Style words are strong levers: cyberpunk, line-art illustration, felt style, 3D cartoon, pixel style, puppet animation, claymation, black-and-white animation, tilt-shift, time-lapse.
+
+Source: Alibaba Cloud Model Studio \u2014 "Text-to-video / image-to-video prompt guide"
+(alibabacloud.com/help/en/model-studio/text-to-video-prompt). Captured 2026-08-09.`
+};
+var HAPPYHORSE_DOCTRINE = {
+  providers: ["happyhorse", "happyhorse-i2v", "happyhorse-ref2v", "happyhorse-edit"],
+  heading: "HappyHorse 1.1 (happyhorse, happyhorse-i2v, happyhorse-ref2v)",
+  tips: [
+    "Any-language prompts up to 5000 chars (2500 Chinese) \u2014 excess is silently truncated, so front-load subject \u2192 action \u2192 scene \u2192 camera \u2192 style.",
+    "3-15 seconds per second of billing; 720p or 1080p; ratios 16:9 / 9:16 / 1:1 / 4:3 / 3:4. Pick the shortest duration that serves the shot.",
+    "ref2v is one of the few true REFERENCE modes on the roster: wired refs keep identity across the clip \u2014 bind each reference explicitly in the prompt.",
+    "No published vendor style guide \u2014 the platform's standard structure applies; keep one camera move per shot and quantify motion physically."
+  ],
+  doctrine: `Prompt structure (no public HappyHorse prompt guide exists \u2014 the KIE API contract is the
+doctrine source; platform-standard structure applies):
+subject \u2192 action \u2192 scene/environment \u2192 lighting \u2192 camera movement \u2192 style \u2192 constraints.
+
+**Contract facts (KIE, per-mode pages)**
+- Prompts: any language, up to 5000 non-Chinese / 2500 Chinese characters \u2014 excess is TRUNCATED silently, so put the load-bearing content first.
+- Duration 3-15s (default 5), billed per second. Resolution 720p / 1080p (default). Aspect 16:9 (default) / 9:16 / 1:1 / 4:3 / 3:4.
+- Modes: text-to-video (happyhorse), image-to-video (happyhorse-i2v), reference-to-video (happyhorse-ref2v) \u2014 ref2v preserves wired identities; name each reference in the prompt so the binding is explicit.
+
+**Style guidance (platform-standard, honestly generic)**
+- One camera movement per shot; physical, quantified action ("slowly raises a hand") over abstract emotion words; state exclusions ("no on-screen text, no watermark") in the prompt.
+
+Source: KIE HappyHorse 1.1 contracts (docs.kie.ai/market/happyhorse/text-to-video,
+\u2026/happyhorse-1-1/image-to-video, \u2026/happyhorse-1-1/reference-to-video). Captured 2026-08-09.`
+};
+var RUNWAY_KIE_DOCTRINE = {
+  providers: ["runway-kie", "runway-extend", "runway-aleph"],
+  heading: "Runway via KIE (runway-kie)",
+  tips: [
+    "Prompt cap is 1800 chars; KIE's own guidance: be specific about subject, action, style, and setting. No native audio \u2014 plan sound as a separate pass.",
+    "Durations 5 or 10s with a hard trade-off: 10s cannot be 1080p, 1080p cannot exceed 5s \u2014 pick per deliverable.",
+    "Text runs REQUIRE an aspect ratio (16:9/4:3/1:1/3:4/9:16); image runs IGNORE it \u2014 the input image dictates output dimensions.",
+    "Image-to-video treats the image as the anchor frame: describe motion and camera, not the still."
+  ],
+  doctrine: `Prompt structure (KIE contract guidance): "be specific about subject, action, style, and
+setting" \u2014 subject \u2192 action \u2192 scene \u2192 camera \u2192 style, within the 1800-character cap.
+
+**Contract facts (KIE Runway endpoint)**
+- Duration 5 or 10 seconds; quality 720p or 1080p \u2014 10s@1080p does NOT exist (10s forces 720p; 1080p forces 5s). Choose by deliverable: crisp hero shot \u2192 5s/1080p; longer beat \u2192 10s/720p.
+- Text-to-video REQUIRES aspectRatio (16:9 / 4:3 / 1:1 / 3:4 / 9:16). Image-to-video IGNORES aspectRatio \u2014 the input image dictates output dimensions.
+- No audio is generated \u2014 score/SFX are a separate pass (merge-video-audio / video-sfx downstream).
+
+**Style guidance**
+- The image input anchors composition and identity \u2014 describe the motion ("she pushes the door open as the camera tracks left"), not the still.
+- Keep one continuous camera idea per clip; front-load the subject and action.
+
+Source: KIE Runway contract (docs.kie.ai/runway-api/generate-ai-video). Captured 2026-08-09.`
 };
 var PROVIDER_PROMPT_DOCTRINES = [
   SEEDANCE_2_DOCTRINE,
-  KLING_AUDIO_DOCTRINE
+  KLING_AUDIO_DOCTRINE,
+  MINIMAX_H3_DOCTRINE,
+  VEO_31_DOCTRINE,
+  GEMINI_OMNI_DOCTRINE,
+  GROK_IMAGINE_DOCTRINE,
+  WAN_DOCTRINE,
+  HAPPYHORSE_DOCTRINE,
+  RUNWAY_KIE_DOCTRINE
 ];
 var DOCTRINE_BY_PROVIDER = new Map(
   PROVIDER_PROMPT_DOCTRINES.flatMap((d) => d.providers.map((p) => [p, d]))
@@ -26297,6 +26717,8 @@ var PROVIDER_CAPABILITIES = {
     "seedance-2": "Seedance 2.0 \u2014 multimodal refs (9 images / 3 videos / 3 audio), native multi-track audio, multi-shot storytelling, 4-15s",
     "seedance-2-fast": "Seedance 2.0 Fast \u2014 same multimodal + audio capabilities, cheaper and quicker",
     "seedance-2-mini": "Seedance 2.0 Mini \u2014 same multimodal + audio capabilities, budget tier, 480p/720p, 4-15s",
+    "seedance-2-5": "Seedance 2.5 \u2014 up to 30s in ONE shot (no stitching), wider multimodal refs (30 images / 10 videos / 10 audio), native audio, 480p/720p",
+    "minimax-h3": "MiniMax Hailuo 3 \u2014 premium multimodal refs (9 images / 3 videos / 3 audio), always-on audio, 2K or 768P, 4-15s per-second pricing",
     "wan": "Versatile, good for animations and transformations",
     "wan-turbo": "Faster Wan generation",
     "hailuo-standard": "Standard quality, cost-effective",
@@ -26323,6 +26745,8 @@ var PROVIDER_CAPABILITIES = {
     "seedance-2": "Seedance 2.0 \u2014 start/end frame + multimodal refs, native audio, 4-15s",
     "seedance-2-fast": "Seedance 2.0 Fast \u2014 same capabilities, cheaper and quicker",
     "seedance-2-mini": "Seedance 2.0 Mini \u2014 same capabilities, budget tier, 480p/720p",
+    "seedance-2-5": "Seedance 2.5 \u2014 start/end frame + wide multimodal refs, native audio, up to 30s, 480p/720p",
+    "minimax-h3": "MiniMax Hailuo 3 \u2014 first/last frame + multimodal refs, always-on audio, 2K or 768P, 4-15s",
     "hailuo-2.3-pro": "Premium Hailuo animation",
     "hailuo-2.3": "Standard Hailuo animation",
     "hailuo-standard": "Cost-effective animation",
@@ -31333,7 +31757,24 @@ var FACTORY_SNIPPETS = [
   { id: "wardrobe-lock", name: "Wardrobe Lock", description: "Outfit continuity across shots and edits", text: "wearing exactly the same outfit as the reference \u2014 same garments, colors, fabrics, and accessories, unchanged", target: "prompt", media: B, category: "Identity & Consistency" },
   { id: "no-beautify", name: "No Beautify", description: "Stop the model 'improving' a face", text: "preserve natural skin texture, age lines, and asymmetries; do not beautify, smooth, slim, or rejuvenate the face", target: "prompt", media: I, category: "Identity & Consistency" },
   // ── Reference locks (prompt) — insert at the START of a reference prompt ──
-  { id: "reference-lock", name: "Reference Lock", description: "Default-deny + preserve likeness + compose into one image (full scenes)", text: "Do not use anything from reference images unless specified explicitly. All elements taken from reference images must preserve likeness. Compose them naturally into a single image.", target: "prompt", media: I, category: "Reference locks" },
+  // Text comes from the shared constant, not a hand-written twin. This entry used
+  // to carry its own wording — no face rules, likeness phrased as a passive —
+  // which scored 0/4 on moving a garment between references where the merged
+  // block scored 4/4 (see reference-rules.ts). A snippet is copied into the
+  // prompt at INSERT time, so changing it here only affects future insertions.
+  { id: "reference-lock", name: "Reference Lock", description: "Default-deny + preserve likeness + compose into one image (full scenes)", text: REFERENCE_RULES, target: "prompt", media: I, category: "Reference locks" },
+  // The eyeline suppressor, kept OUT of Reference Lock on purpose: a portrait
+  // or a piece to camera wants the eyeline. 4/4 on a brief where the lock alone
+  // was 0/4, at no measured cost to identity or wardrobe.
+  { id: "scene-frame", name: "Scene Frame", description: "Reads as a frame from a film, not a posed photo \u2014 nobody faces the lens", text: SCENE_FRAME_RULE, target: "prompt", media: I, category: "Reference locks" },
+  // A PREFIX, not a sentence — it swallows the scene that follows it, which is
+  // exactly why it costs nothing. The same idea written as a standalone claim
+  // ("This image is a scene start frame of a video.") lost the lead's identity
+  // in 3 of 3 draws. Goes at the very TOP, above the scene.
+  { id: "film-still-of", name: "Film Still Of", description: 'Put at the very top, before the scene \u2014 lead with the shot size, e.g. "Medium wide\u2026"', text: `Medium wide ${FILM_STILL_PREFIX.charAt(0).toLowerCase()}${FILM_STILL_PREFIX.slice(1)}`, target: "prompt", media: I, category: "Reference locks" },
+  // Goes at the very END. An example to edit — a different film wants a
+  // different stock; what generalises is that the look comes LAST.
+  { id: "cinematic-look", name: "Cinematic Look (16mm)", description: "Append at the END \u2014 film stock, lens, light and palette", text: CINEMATIC_LOOK_TAIL, target: "prompt", media: I, category: "Reference locks" },
   { id: "reference-extract", name: "Reference Extract", description: "Isolate only the specified elements \u2014 no scene, no figure", text: "Take only what is specified from the reference images. Do not take anything else.", target: "prompt", media: I, category: "Reference locks" },
   { id: "ghost-mannequin", name: "Ghost Mannequin", description: "Show worn garments without a wearer (product shot)", text: "Ghost-mannequin product shot: the garment in its natural worn shape, with no person, body, face, or mannequin visible.", target: "prompt", media: I, category: "Reference locks" },
   // ── Quality (prompt) ──
@@ -31425,7 +31866,213 @@ function getFactorySnippets(target, media) {
     (s) => s.target === target && s.media.includes(media)
   );
 }
+function mapCat(arr, groupKey) {
+  return arr.map((e) => ({
+    id: e.id,
+    label: e.label,
+    description: e.description,
+    group: groupKey ? e[groupKey] : void 0
+  }));
+}
+function flatCat(arr) {
+  return arr.map((e) => ({ id: e.id, label: e.label }));
+}
+function optionsByDiscriminator(arr, keyOf, fieldByKey) {
+  const out = {};
+  for (const e of arr) {
+    const field = fieldByKey[keyOf(e)];
+    if (!field) continue;
+    (out[field] ??= []).push({ id: e.id, label: e.label });
+  }
+  return out;
+}
+var SINGLE_PICKER_WIRING = [
+  // -------- "Look" family --------
+  { kind: "single", nodeType: "setting", label: "Setting", valueField: "setting", defaultValue: "forest", catalogId: "setting", entries: mapCat(SETTINGS, "category"), groupOrder: ["indoor", "urban", "nature", "fantastical"], groupLabels: SETTING_CATEGORY_LABELS },
+  { kind: "single", nodeType: "atmosphere", label: "Atmosphere", valueField: "atmosphere", defaultValue: "clear", catalogId: "atmosphere", entries: mapCat(ATMOSPHERES) },
+  { kind: "single", nodeType: "style", label: "Style", valueField: "style", defaultValue: "cinematic", catalogId: "style", entries: mapCat(STYLES) },
+  { kind: "single", nodeType: "color-look", label: "Color / Look", valueField: "colorLook", defaultValue: "warm", catalogId: "color-look", entries: mapCat(COLOR_LOOKS, "category"), groupOrder: COLOR_LOOK_CATEGORY_ORDER, groupLabels: COLOR_LOOK_CATEGORY_LABELS },
+  { kind: "single", nodeType: "mood", label: "Mood", valueField: "mood", defaultValue: "calm", catalogId: "mood", entries: mapCat(MOODS, "category"), groupOrder: MOOD_CATEGORY_ORDER, groupLabels: MOOD_CATEGORY_LABELS },
+  { kind: "single", nodeType: "photographer", label: "Photographer / Artist", valueField: "photographer", defaultValue: "tim-walker", catalogId: "photographer", entries: mapCat(PHOTOGRAPHERS, "category"), groupOrder: PHOTOGRAPHER_CATEGORY_ORDER, groupLabels: PHOTOGRAPHER_CATEGORY_LABELS },
+  { kind: "single", nodeType: "aesthetic", label: "Aesthetic / Microtrend", valueField: "aesthetic", defaultValue: "y2k", catalogId: "aesthetic", entries: mapCat(AESTHETICS, "category"), groupOrder: AESTHETIC_CATEGORY_ORDER, groupLabels: AESTHETIC_CATEGORY_LABELS },
+  { kind: "single", nodeType: "era", label: "Era / Period", valueField: "era", defaultValue: "1990s-mall", catalogId: "era", entries: mapCat(ERAS, "category"), groupOrder: ERA_CATEGORY_ORDER, groupLabels: ERA_CATEGORY_LABELS },
+  { kind: "single", nodeType: "photo-genre", label: "Photo Genre", valueField: "photoGenre", defaultValue: "fashion-editorial", catalogId: "photo-genre", entries: mapCat(PHOTO_GENRES, "category"), groupOrder: PHOTO_GENRE_CATEGORY_ORDER, groupLabels: PHOTO_GENRE_CATEGORY_LABELS },
+  { kind: "single", nodeType: "backdrop", label: "Backdrop", valueField: "backdrop", defaultValue: "white-seamless", catalogId: "backdrop", entries: mapCat(BACKDROPS, "category"), groupOrder: BACKDROP_CATEGORY_ORDER, groupLabels: BACKDROP_CATEGORY_LABELS },
+  { kind: "single", nodeType: "render-quality", label: "Render Quality", valueField: "renderQuality", defaultValue: "raytracing", catalogId: "render-quality", entries: mapCat(RENDER_QUALITIES) },
+  { kind: "single", nodeType: "composition-effects", label: "Composition Effect", valueField: "compositionEffect", defaultValue: "bursting-through-frame", catalogId: "composition-effects", entries: mapCat(COMPOSITION_EFFECTS) },
+  { kind: "single", nodeType: "action-fx", label: "Action FX", valueField: "actionFx", defaultValue: "earthquake-tremor", catalogId: "action-fx", entries: mapCat(ACTION_FX, "category"), groupOrder: ACTION_FX_CATEGORY_ORDER, groupLabels: ACTION_FX_CATEGORY_LABELS },
+  { kind: "single", nodeType: "loop-subject", label: "Loop Subject", valueField: "loopSubject", defaultValue: "tunnel", catalogId: "loop-subject", entries: mapCat(LOOP_SUBJECTS, "category"), groupOrder: LOOP_SUBJECT_CATEGORY_ORDER, groupLabels: LOOP_SUBJECT_CATEGORY_LABELS },
+  { kind: "single", nodeType: "post-process-effects", label: "Post-Process Effect", valueField: "postProcess", defaultValue: "vignette-soft", catalogId: "post-process-effects", entries: mapCat(POST_PROCESS_EFFECTS) },
+  // -------- "Camera" family --------
+  { kind: "single", nodeType: "camera-motion", label: "Camera Motion", valueField: "cameraMotion", defaultValue: "static", catalogId: "camera-motions", entries: mapCat(CAMERA_MOTIONS, "category"), groupOrder: CAMERA_MOTION_CATEGORY_ORDER, groupLabels: CAMERA_MOTION_CATEGORY_LABELS },
+  { kind: "single", nodeType: "lens", label: "Lens", valueField: "lens", defaultValue: "normal-50mm", catalogId: "lens", entries: mapCat(LENSES) },
+  { kind: "single", nodeType: "camera-format", label: "Camera / Film", valueField: "cameraFormat", defaultValue: "35mm-film", catalogId: "camera-format", entries: mapCat(CAMERA_FORMATS) },
+  { kind: "single", nodeType: "transition", label: "Transition", valueField: "transition", defaultValue: "auto", catalogId: "transitions", entries: mapCat(TRANSITIONS, "category"), groupOrder: TRANSITION_CATEGORY_ORDER, groupLabels: TRANSITION_CATEGORY_LABELS },
+  { kind: "single", nodeType: "character-fx", label: "Character FX", valueField: "characterFx", defaultValue: "auto", catalogId: "character-fx", entries: mapCat(CHARACTER_FX, "category"), groupOrder: CHARACTER_FX_CATEGORY_ORDER, groupLabels: CHARACTER_FX_CATEGORY_LABELS },
+  // -------- "Subject / Object" family --------
+  { kind: "single", nodeType: "pose", label: "Pose", valueField: "pose", defaultValue: "standing-upright", catalogId: "pose", entries: mapCat(POSES, "category"), groupOrder: POSE_CATEGORY_ORDER, groupLabels: POSE_CATEGORY_LABELS },
+  { kind: "single", nodeType: "material", label: "Material", valueField: "material", defaultValue: "silk", catalogId: "materials", entries: mapCat(MATERIALS, "category"), groupOrder: MATERIAL_CATEGORY_ORDER, groupLabels: MATERIAL_CATEGORY_LABELS },
+  { kind: "single", nodeType: "animal", label: "Animal", valueField: "animal", defaultValue: "dog-golden-retriever", catalogId: "animals", entries: mapCat(ANIMALS, "subcategory"), groupOrder: ANIMAL_SUBCATEGORY_ORDER, groupLabels: ANIMAL_SUBCATEGORY_LABELS },
+  { kind: "single", nodeType: "vehicle", label: "Vehicle", valueField: "vehicle", defaultValue: "sedan", catalogId: "vehicles", entries: mapCat(VEHICLES, "subcategory"), groupOrder: VEHICLE_SUBCATEGORY_ORDER, groupLabels: VEHICLE_SUBCATEGORY_LABELS },
+  { kind: "single", nodeType: "weapon", label: "Weapon", valueField: "weapon", defaultValue: "katana", catalogId: "weapons", entries: mapCat(WEAPONS, "subcategory"), groupOrder: WEAPON_SUBCATEGORY_ORDER, groupLabels: WEAPON_SUBCATEGORY_LABELS },
+  { kind: "single", nodeType: "furniture", label: "Furniture", valueField: "furniture", defaultValue: "sofa", catalogId: "furniture", entries: mapCat(FURNITURE, "subcategory"), groupOrder: FURNITURE_SUBCATEGORY_ORDER, groupLabels: FURNITURE_SUBCATEGORY_LABELS },
+  { kind: "single", nodeType: "held-prop", label: "Held Prop", valueField: "heldProp", defaultValue: "smartphone", catalogId: "held-prop", entries: mapCat(HELD_PROPS, "category"), groupOrder: HELD_PROP_CATEGORY_ORDER, groupLabels: HELD_PROP_CATEGORY_LABELS }
+];
+var STYLING_FIELDS2 = STYLING_DIMENSION_ORDER.map((d) => STYLING_FIELD_BY_DIMENSION[d]);
+var PERSON_FIELDS2 = PERSON_DIMENSION_ORDER.map((d) => PERSON_FIELD_BY_DIMENSION[d]);
+var LIGHTING_FIELDS2 = LIGHTING_CATEGORY_ORDER.map((c) => LIGHTING_FIELD_BY_CATEGORY[c]);
+var TEMPORAL_FIELD_BY_CATEGORY2 = {
+  speed: "temporalSpeed",
+  freeze: "temporalFreeze",
+  direction: "temporalDirection",
+  shutter: "temporalShutter"
+};
+var EXPOSURE_FIELD_BY_CATEGORY2 = {
+  aperture: "aperture",
+  "shutter-speed": "shutterSpeed",
+  iso: "isoValue"
+};
+var MULTI_PICKER_WIRING = [
+  {
+    kind: "multi",
+    nodeType: "framing",
+    label: "Framing",
+    fields: ["shotSize", "angle", "coverage", "composition", "vantage"],
+    catalogId: "framing",
+    catalogEntries: flatCat(FRAMINGS),
+    fieldOptions: optionsByDiscriminator(FRAMINGS, (e) => e.category, FRAMING_FIELD_BY_CATEGORY)
+  },
+  {
+    kind: "multi",
+    nodeType: "lighting",
+    label: "Lighting",
+    fields: LIGHTING_FIELDS2,
+    catalogId: "lighting",
+    catalogEntries: flatCat(LIGHTINGS),
+    fieldOptions: optionsByDiscriminator(LIGHTINGS, (e) => e.category, LIGHTING_FIELD_BY_CATEGORY)
+  },
+  {
+    kind: "multi",
+    nodeType: "person",
+    label: "Person",
+    fields: PERSON_FIELDS2,
+    catalogId: "person",
+    catalogEntries: flatCat(PEOPLE),
+    fieldOptions: optionsByDiscriminator(PEOPLE, (e) => e.dimension, PERSON_FIELD_BY_DIMENSION)
+  },
+  {
+    kind: "multi",
+    nodeType: "styling",
+    label: "Styling",
+    fields: STYLING_FIELDS2,
+    catalogId: "styling",
+    catalogEntries: flatCat(STYLINGS),
+    fieldOptions: optionsByDiscriminator(STYLINGS, (e) => e.dimension, STYLING_FIELD_BY_DIMENSION)
+  },
+  {
+    kind: "multi",
+    nodeType: "temporal",
+    label: "Temporal",
+    fields: ["temporalSpeed", "temporalFreeze", "temporalDirection", "temporalShutter"],
+    catalogId: "temporal",
+    catalogEntries: flatCat(TEMPORALS),
+    fieldOptions: optionsByDiscriminator(TEMPORALS, (e) => e.category, TEMPORAL_FIELD_BY_CATEGORY2)
+  },
+  {
+    kind: "multi",
+    nodeType: "exposure-settings",
+    label: "Exposure Settings",
+    fields: ["aperture", "shutterSpeed", "isoValue"],
+    catalogId: "exposure-settings",
+    catalogEntries: flatCat(EXPOSURE_SETTINGS),
+    fieldOptions: optionsByDiscriminator(EXPOSURE_SETTINGS, (e) => e.category, EXPOSURE_FIELD_BY_CATEGORY2)
+  },
+  // -------- "Sound" family --------
+  // Music Genre catalog is hierarchical: flatten genres + every subgenre +
+  // eras so summary chips can resolve any selected id back to a human label.
+  {
+    kind: "multi",
+    nodeType: "music-genre",
+    label: "Music Genre",
+    fields: ["genre", "subgenre", "era"],
+    catalogId: "music-genre",
+    catalogEntries: [
+      ...flatCat(MUSIC_GENRES),
+      ...MUSIC_GENRES.flatMap((g) => g.subgenres.map((s) => ({ id: s.id, label: s.label }))),
+      ...flatCat(MUSIC_ERAS)
+    ],
+    fieldOptions: {
+      genre: flatCat(MUSIC_GENRES),
+      subgenre: MUSIC_GENRES.flatMap((g) => g.subgenres.map((s) => ({ id: s.id, label: s.label }))),
+      era: flatCat(MUSIC_ERAS)
+    }
+  },
+  {
+    kind: "multi",
+    nodeType: "music-mood",
+    label: "Music Mood",
+    fields: ["energy", "emotion", "vibe"],
+    catalogId: "music-mood",
+    catalogEntries: [...flatCat(MUSIC_ENERGIES), ...flatCat(MUSIC_EMOTIONS), ...flatCat(MUSIC_VIBES)],
+    fieldOptions: {
+      energy: flatCat(MUSIC_ENERGIES),
+      emotion: flatCat(MUSIC_EMOTIONS),
+      vibe: flatCat(MUSIC_VIBES)
+    }
+  },
+  {
+    kind: "multi",
+    nodeType: "instrumentation",
+    label: "Instrumentation",
+    fields: ["instruments", "production", "vocalPresence", "singingStyle"],
+    catalogId: "instrumentation",
+    catalogEntries: [...flatCat(INSTRUMENTS), ...flatCat(PRODUCTION_STYLES), ...flatCat(VOCAL_PRESENCE), ...flatCat(SINGING_STYLES)],
+    fieldOptions: {
+      instruments: flatCat(INSTRUMENTS),
+      production: flatCat(PRODUCTION_STYLES),
+      vocalPresence: flatCat(VOCAL_PRESENCE),
+      singingStyle: flatCat(SINGING_STYLES)
+    }
+  },
+  {
+    kind: "multi",
+    nodeType: "voice-character",
+    label: "Voice Character",
+    fields: ["age", "gender", "language", "accent", "timbre"],
+    catalogId: "voice-character",
+    catalogEntries: [...flatCat(VOICE_AGES), ...flatCat(VOICE_GENDERS), ...flatCat(VOICE_LANGUAGES), ...flatCat(VOICE_ACCENTS), ...flatCat(VOICE_TIMBRES)],
+    fieldOptions: {
+      age: flatCat(VOICE_AGES),
+      gender: flatCat(VOICE_GENDERS),
+      language: flatCat(VOICE_LANGUAGES),
+      accent: flatCat(VOICE_ACCENTS),
+      timbre: flatCat(VOICE_TIMBRES)
+    }
+  },
+  {
+    kind: "multi",
+    nodeType: "voice-delivery",
+    label: "Voice Delivery",
+    fields: ["pace", "emotion", "archetype"],
+    catalogId: "voice-delivery",
+    catalogEntries: [...flatCat(VOICE_PACES), ...flatCat(VOICE_EMOTIONS), ...flatCat(VOICE_ARCHETYPES)],
+    fieldOptions: {
+      pace: flatCat(VOICE_PACES),
+      emotion: flatCat(VOICE_EMOTIONS),
+      archetype: flatCat(VOICE_ARCHETYPES)
+    }
+  }
+];
+var ALL_PICKER_WIRING = [
+  ...SINGLE_PICKER_WIRING,
+  ...MULTI_PICKER_WIRING
+];
+var WIRING_MAP = new Map(ALL_PICKER_WIRING.map((w) => [w.nodeType, w]));
+function getPickerWiring(nodeType) {
+  if (!nodeType) return void 0;
+  return WIRING_MAP.get(nodeType);
+}
 
-export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_IDS, AESTHETICS, AESTHETIC_CATEGORY_LABELS, AESTHETIC_CATEGORY_ORDER, AESTHETIC_IDS, ANALYZABLE_PICKER_TYPES, ANGLE_LABELS, ASPECT_RATIO_LABELS, ATMOSPHERES, ATMOSPHERE_IDS, AUDIO_WIZARD_CATEGORIES, BACKDROPS, BACKDROP_CATEGORY_LABELS, BACKDROP_CATEGORY_ORDER, BACKDROP_IDS, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, CAMERA_FORMATS, CAMERA_FORMAT_IDS, CAMERA_MOTIONS, CAMERA_MOTION_CATEGORY_LABELS, CAMERA_MOTION_CATEGORY_ORDER, CAMERA_MOTION_IDS, CHARACTER_FX, CHARACTER_FX_CATEGORY_LABELS, CHARACTER_FX_CATEGORY_ORDER, CHARACTER_FX_IDS, COLOR_LOOKS, COLOR_LOOK_CATEGORY_LABELS, COLOR_LOOK_CATEGORY_ORDER, COLOR_LOOK_IDS, COMPOSITION_EFFECTS, COMPOSITION_EFFECT_IDS, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, ERAS, ERA_CATEGORY_LABELS, ERA_CATEGORY_ORDER, ERA_IDS, EXPOSURE_CATEGORY_LABELS, EXPOSURE_CATEGORY_ORDER, EXPOSURE_FIELD_BY_CATEGORY, EXPOSURE_IDS, EXPOSURE_SETTINGS, FACTORY_PRESETS, FACTORY_SNIPPETS, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, GAPS_SCHEMA, HELD_PROPS, HELD_PROP_CATEGORY_LABELS, HELD_PROP_CATEGORY_ORDER, HELD_PROP_IDS, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, LENSES, LENS_IDS, LIGHTINGS, LIGHTING_CATEGORY_LABELS, LIGHTING_CATEGORY_ORDER, LIGHTING_FIELD_BY_CATEGORY, LIGHTING_IDS, LLM_CHAT_WIZARD_CATEGORIES, LOOP_SUBJECTS, LOOP_SUBJECT_CATEGORY_LABELS, LOOP_SUBJECT_CATEGORY_ORDER, MATERIALS, MATERIAL_CATEGORY_LABELS, MATERIAL_CATEGORY_ORDER, MATERIAL_IDS, MAX_SELECTED_BY_DIMENSION, MAX_SELECTED_BY_FRAMING_CATEGORY, MAX_SELECTED_BY_STYLING_DIMENSION, MOODS, MOOD_CATEGORY_LABELS, MOOD_CATEGORY_ORDER, MOOD_IDS, MOVEMENT_LABELS, MUSIC_EMOTIONS, MUSIC_ENERGIES, MUSIC_ERAS, MUSIC_GENRES, MUSIC_GENRE_CATEGORY_LABELS, MUSIC_GENRE_CATEGORY_ORDER, MUSIC_GENRE_DEFAULT_DATA, MUSIC_MOOD_DEFAULT_DATA, MUSIC_VIBES, MUSIC_WIZARD_CATEGORIES, NODE_PROMPT_CANDIDATE_FIELDS, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_SECTIONS, PERSON_FIELD_BY_DIMENSION, PERSON_IDS, PHOTOGRAPHERS, PHOTOGRAPHER_CATEGORY_LABELS, PHOTOGRAPHER_CATEGORY_ORDER, PHOTOGRAPHER_IDS, PHOTO_GENRES, PHOTO_GENRE_CATEGORY_LABELS, PHOTO_GENRE_CATEGORY_ORDER, PHOTO_GENRE_IDS, PICKER_ANALYZER_REGISTRY, PICKER_CATALOGS, PICKER_TYPES, POSES, POSE_CATEGORY_LABELS, POSE_CATEGORY_ORDER, POSE_IDS, POST_PROCESS_EFFECTS, POST_PROCESS_EFFECT_IDS, PRODUCTION_STYLES, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, SCENE_PROMPT_MAX_LENGTH, SETTINGS, SETTING_CATEGORY_LABELS, SETTING_IDS, SHOT_LABELS, SINGING_STYLES, SNIPPET_MEDIA_VALUES, STYLES, STYLE_IDS, STYLE_PRESETS, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_IDS, VIDEO_WIZARD_CATEGORIES, VOCAL_PRESENCE, VOCAL_PRESENCE_INSTRUMENTAL_ID, VOICE_ACCENTS, VOICE_AGES, VOICE_ARCHETYPES, VOICE_CHARACTER_DEFAULT_DATA, VOICE_DELIVERY_DEFAULT_DATA, VOICE_EMOTIONS, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_PACES, VOICE_TIMBRES, WARDROBE, WARDROBE_CATEGORY_LABELS, WARDROBE_DIMENSION_ORDER, WARDROBE_FIELD_BY_DIMENSION, appendField, appendMusicMeta, applyPickerJson, applyReferenceOrderToVideo, applyTemplate, assembleImageInput, assembleSunoInput, buildActionFxHints, buildAestheticHints, buildAgeHint, buildAtmosphereHints, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildFaceTemplateInputs, buildFramingHints, buildHeldPropHints, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildInstrumentationHints, buildLightingHints, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMoodHints, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicMoodHints, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPhotographerHints, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPostProcessHints, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildTemporalHints, buildVoiceCharacterHints, buildVoiceDeliveryHints, buildWardrobeHints, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCharacterFxHintFromConnections, composeNegative, composeSoundHintFromConnections, composeTransitionHintFromConnections, computeLlmChatFields, computeNodePrompt, expandImagePositionRefs, expandImageRefTokens, getActionFx, getActionFxLabel, getActionFxPromptHint, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getBackdrop, getBackdropLabel, getBackdropPromptHint, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getColorLook, getColorLookLabel, getColorLookPromptHint, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getExposure, getExposureLabel, getExposurePromptHint, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getIdentityLockClause, getInstrument, getLens, getLensLabel, getLensPromptHint, getLighting, getLightingLabel, getLightingPromptHint, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getMaterial, getMaterialLabel, getMaterialPromptHint, getMood, getMoodLabel, getMoodPromptHint, getMusicEmotion, getMusicEnergy, getMusicEra, getMusicGenre, getMusicGenreLabel, getMusicSubgenre, getMusicVibe, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPickerAnalyzer, getPickerCatalog, getPose, getPoseLabel, getPosePromptHint, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getProductionStyle, getPromptDoctrine, getPromptTips, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getSetting, getSettingLabel, getSettingPromptHint, getSingingStyle, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getTemporal, getTemporalLabel, getTemporalPromptHint, getTransition, getTransitionLabel, getTransitionPromptHint, getVocalPresence, getVoiceAccent, getVoiceAge, getVoiceArchetype, getVoiceEmotion, getVoiceGender, getVoiceLanguage, getVoicePace, getVoiceTimbre, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasUpstreamCharacter, isAnalyzablePicker, isInstrumentalVocal, isVantageFraming, isWizardSupported, listPickerCatalogs, migratePersonValue, pickerFanoutTargets, projectPickerCatalog, promptBindsFirstFrame, renderStructuredFields, resolveBrandInput, resolveCharacterMentions, resolveLocationMentions, resolvePrompt, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveVideoReferenceCore, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
+export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_IDS, AESTHETICS, AESTHETIC_CATEGORY_LABELS, AESTHETIC_CATEGORY_ORDER, AESTHETIC_IDS, ALL_PICKER_WIRING, ANALYZABLE_PICKER_TYPES, ANGLE_LABELS, ASPECT_RATIO_LABELS, ATMOSPHERES, ATMOSPHERE_IDS, AUDIO_WIZARD_CATEGORIES, BACKDROPS, BACKDROP_CATEGORY_LABELS, BACKDROP_CATEGORY_ORDER, BACKDROP_IDS, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, CAMERA_FORMATS, CAMERA_FORMAT_IDS, CAMERA_MOTIONS, CAMERA_MOTION_CATEGORY_LABELS, CAMERA_MOTION_CATEGORY_ORDER, CAMERA_MOTION_IDS, CHARACTER_FX, CHARACTER_FX_CATEGORY_LABELS, CHARACTER_FX_CATEGORY_ORDER, CHARACTER_FX_IDS, CINEMATIC_LOOK_TAIL, COLOR_LOOKS, COLOR_LOOK_CATEGORY_LABELS, COLOR_LOOK_CATEGORY_ORDER, COLOR_LOOK_IDS, COMPOSITION_EFFECTS, COMPOSITION_EFFECT_IDS, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, ERAS, ERA_CATEGORY_LABELS, ERA_CATEGORY_ORDER, ERA_IDS, EXPOSURE_CATEGORY_LABELS, EXPOSURE_CATEGORY_ORDER, EXPOSURE_FIELD_BY_CATEGORY, EXPOSURE_IDS, EXPOSURE_SETTINGS, FACTORY_PRESETS, FACTORY_SNIPPETS, FILM_STILL_PREFIX, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, GAPS_SCHEMA, HELD_PROPS, HELD_PROP_CATEGORY_LABELS, HELD_PROP_CATEGORY_ORDER, HELD_PROP_IDS, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, LENSES, LENS_IDS, LIGHTINGS, LIGHTING_CATEGORY_LABELS, LIGHTING_CATEGORY_ORDER, LIGHTING_FIELD_BY_CATEGORY, LIGHTING_IDS, LLM_CHAT_WIZARD_CATEGORIES, LOOP_SUBJECTS, LOOP_SUBJECT_CATEGORY_LABELS, LOOP_SUBJECT_CATEGORY_ORDER, MATERIALS, MATERIAL_CATEGORY_LABELS, MATERIAL_CATEGORY_ORDER, MATERIAL_IDS, MAX_SELECTED_BY_DIMENSION, MAX_SELECTED_BY_FRAMING_CATEGORY, MAX_SELECTED_BY_STYLING_DIMENSION, MOODS, MOOD_CATEGORY_LABELS, MOOD_CATEGORY_ORDER, MOOD_IDS, MOVEMENT_LABELS, MULTI_PICKER_WIRING, MUSIC_EMOTIONS, MUSIC_ENERGIES, MUSIC_ERAS, MUSIC_GENRES, MUSIC_GENRE_CATEGORY_LABELS, MUSIC_GENRE_CATEGORY_ORDER, MUSIC_GENRE_DEFAULT_DATA, MUSIC_MOOD_DEFAULT_DATA, MUSIC_VIBES, MUSIC_WIZARD_CATEGORIES, NODE_PROMPT_CANDIDATE_FIELDS, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_SECTIONS, PERSON_FIELD_BY_DIMENSION, PERSON_IDS, PHOTOGRAPHERS, PHOTOGRAPHER_CATEGORY_LABELS, PHOTOGRAPHER_CATEGORY_ORDER, PHOTOGRAPHER_IDS, PHOTO_GENRES, PHOTO_GENRE_CATEGORY_LABELS, PHOTO_GENRE_CATEGORY_ORDER, PHOTO_GENRE_IDS, PICKER_ANALYZER_FAMILIES, PICKER_ANALYZER_REGISTRY, PICKER_CATALOGS, PICKER_TYPES, POSES, POSE_CATEGORY_LABELS, POSE_CATEGORY_ORDER, POSE_IDS, POST_PROCESS_EFFECTS, POST_PROCESS_EFFECT_IDS, PRODUCTION_STYLES, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, SCENE_FRAME_RULE, SCENE_PROMPT_MAX_LENGTH, SETTINGS, SETTING_CATEGORY_LABELS, SETTING_IDS, SHOT_LABELS, SINGING_STYLES, SINGLE_PICKER_WIRING, SNIPPET_MEDIA_VALUES, STYLES, STYLE_IDS, STYLE_PRESETS, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_IDS, VIDEO_WIZARD_CATEGORIES, VOCAL_PRESENCE, VOCAL_PRESENCE_INSTRUMENTAL_ID, VOICE_ACCENTS, VOICE_AGES, VOICE_ARCHETYPES, VOICE_CHARACTER_DEFAULT_DATA, VOICE_DELIVERY_DEFAULT_DATA, VOICE_EMOTIONS, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_PACES, VOICE_TIMBRES, WARDROBE, WARDROBE_CATEGORY_LABELS, WARDROBE_DIMENSION_ORDER, WARDROBE_FIELD_BY_DIMENSION, appendField, appendMusicMeta, applyPickerJson, applyReferenceOrderToVideo, applyTemplate, assembleImageInput, assembleSunoInput, buildActionFxHints, buildAestheticHints, buildAgeHint, buildAtmosphereHints, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildFaceTemplateInputs, buildFramingHints, buildHeldPropHints, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildInstrumentationHints, buildLightingHints, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMoodHints, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicMoodHints, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPhotographerHints, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPostProcessHints, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildTemporalHints, buildVoiceCharacterHints, buildVoiceDeliveryHints, buildWardrobeHints, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCharacterFxHintFromConnections, composeNegative, composeSoundHintFromConnections, composeTransitionHintFromConnections, computeLlmChatFields, computeNodePrompt, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, getActionFx, getActionFxLabel, getActionFxPromptHint, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getBackdrop, getBackdropLabel, getBackdropPromptHint, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getColorLook, getColorLookLabel, getColorLookPromptHint, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getExposure, getExposureLabel, getExposurePromptHint, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getIdentityLockClause, getInstrument, getLens, getLensLabel, getLensPromptHint, getLighting, getLightingLabel, getLightingPromptHint, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getMaterial, getMaterialLabel, getMaterialPromptHint, getMood, getMoodLabel, getMoodPromptHint, getMusicEmotion, getMusicEnergy, getMusicEra, getMusicGenre, getMusicGenreLabel, getMusicSubgenre, getMusicVibe, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getProductionStyle, getPromptDoctrine, getPromptTips, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getSetting, getSettingLabel, getSettingPromptHint, getSingingStyle, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getTemporal, getTemporalLabel, getTemporalPromptHint, getTransition, getTransitionLabel, getTransitionPromptHint, getVocalPresence, getVoiceAccent, getVoiceAge, getVoiceArchetype, getVoiceEmotion, getVoiceGender, getVoiceLanguage, getVoicePace, getVoiceTimbre, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasUpstreamCharacter, isAnalyzablePicker, isInstrumentalVocal, isVantageFraming, isWizardSupported, listPickerCatalogs, migratePersonValue, pickerFanoutTargets, projectPickerCatalog, promptBindsFirstFrame, referenceRulesBlock, renderStructuredFields, resolveBrandInput, resolveCharacterMentions, resolveLocationMentions, resolvePrompt, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveVideoReferenceCore, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map