@nodaro/prompts 1.10.0 → 1.12.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, VIDEO_REF_LIMITS_BY_PROVIDER, SOCIAL_POST_NODE_TYPES, FURNITURE, WEAPONS, VEHICLES, ANIMALS, PASSTHROUGH_TYPES, registerCatalogSidecars, resetCatalogSidecars, 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, NON_EN_LOCALE_IDS, readPromptAffixes, setRegisteredPersonPackFields, 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, VIDEO_REF_LIMITS_BY_PROVIDER, SOCIAL_POST_NODE_TYPES, FURNITURE, WEAPONS, VEHICLES, ANIMALS, PASSTHROUGH_TYPES, registerCatalogSidecars, resetCatalogSidecars, pickIds, getAnimalPromptHint, getFurniture, getWeapon, getVehicle, DEFAULT_USAGE_MODE, usageModeDirective, DEFAULT_LOCATION_USAGE_MODE, imageReferenceLimit, knownImageSlugsFromRefs, findImageMentionTokens, knownEntitySlugsFromRefs, findEntityMentionTokens, findCharacterMentionTokens, findLocationMentionTokens, NATIVE_NEGATIVE_PROMPT_MODELS, getMaxNegativePromptChars, getMaxImagePromptChars, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, getAnimalTerm, roleToPhrase, resolveDefaultRole, SEEDANCE_2_REF_LIMITS, NON_EN_LOCALE_IDS, readPromptAffixes, setRegisteredPersonPackFields, PLACEHOLDER_CHARACTER_NAME, REFERENCE_ROLE_PRESETS, imageMentionSlugForRef, entityMentionSlugForRef, defaultRoleForSource, locationReferencePhotoKindLabel, resolveNodeRefs, normalizeRoleSlug } from '@nodaro/shared';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -9239,7 +9239,7 @@ function objectOptions(arr, phrase) {
     label: e.label,
     description: e.description,
     category: e.subcategory,
-    promptHint: phrase(e.label.toLowerCase(), e.description),
+    promptHint: phrase(e),
     // Object entities have no `promptHint` field of their own (it is
     // synthesized above), so the term cannot come from `resolveTerm`'s
     // empty-hint rule: an authored `term` wins, and otherwise the label IS the
@@ -9571,7 +9571,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "dog-golden-retriever",
     categoryOrder: ANIMAL_SUBCATEGORY_ORDER,
     categoryLabels: ANIMAL_SUBCATEGORY_LABELS,
-    options: objectOptions(ANIMALS, (label, description) => `featuring a ${label}, ${description}`)
+    options: objectOptions(ANIMALS, (e) => getAnimalPromptHint(e.id))
   },
   {
     nodeType: "vehicle",
@@ -9582,7 +9582,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "sedan",
     categoryOrder: VEHICLE_SUBCATEGORY_ORDER,
     categoryLabels: VEHICLE_SUBCATEGORY_LABELS,
-    options: objectOptions(VEHICLES, (label, description) => `featuring a ${label}, ${description}`)
+    options: objectOptions(VEHICLES, (e) => `featuring a ${e.label.toLowerCase()}, ${e.description}`)
   },
   {
     nodeType: "weapon",
@@ -9593,7 +9593,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "katana",
     categoryOrder: WEAPON_SUBCATEGORY_ORDER,
     categoryLabels: WEAPON_SUBCATEGORY_LABELS,
-    options: objectOptions(WEAPONS, (label, description) => `with a ${label}, ${description}`)
+    options: objectOptions(WEAPONS, (e) => `with a ${e.label.toLowerCase()}, ${e.description}`)
   },
   {
     nodeType: "furniture",
@@ -9604,7 +9604,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "sofa",
     categoryOrder: FURNITURE_SUBCATEGORY_ORDER,
     categoryLabels: FURNITURE_SUBCATEGORY_LABELS,
-    options: objectOptions(FURNITURE, (label, description) => `including a ${label}, ${description}`)
+    options: objectOptions(FURNITURE, (e) => `including a ${e.label.toLowerCase()}, ${e.description}`)
   },
   {
     nodeType: "held-prop",
@@ -9972,13 +9972,16 @@ function resolveBaseHint(type, data, mode = "full") {
       return withCustomText(data, byMode(mode, getLoopSubjectPromptHint, getLoopSubjectTerm)(asStr(data.loopSubject)));
     case "material":
       return withCustomText(data, buildMaterialHints(data.material, mode));
-    case "animal": {
-      const animal = getAnimal(asStr(data.animal));
+    // Animal is the one Object-entity catalog whose phrasing has a single
+    // owner: `@nodaro/shared`'s `getAnimalPromptHint` / `getAnimalTerm`, which
+    // the picker-catalog funnel calls too. Both getters already return "" on a
+    // miss, so the entry lookup and the `animal ? … : ""` guard are the
+    // getters' job now, not this switch's.
+    case "animal":
       return withCustomText(
         data,
-        animal ? byMode(mode, `featuring a ${animal.label.toLowerCase()}, ${animal.description}`, objectEntityTerm(animal)) : ""
+        byMode(mode, getAnimalPromptHint, getAnimalTerm)(asStr(data.animal))
       );
-    }
     case "vehicle": {
       const vehicle = getVehicle(asStr(data.vehicle));
       return withCustomText(
@@ -10282,6 +10285,11 @@ ${resolvedPrompt}`;
   }
   return { prompt: resolvedPrompt, additionalUrls, mentionedCharacterSlugs };
 }
+function spliceMentionPhrase(prompt, offset, tokenLength, phrase) {
+  const before = prompt.slice(0, offset).replace(/(?<=\S)[^\S\r\n]{2,}$/, " ");
+  const after = prompt.slice(offset + tokenLength).replace(/^[^\S\r\n]{2,}/, " ");
+  return before + phrase + after;
+}
 function resolveCharacterMentionsHybrid(prompt, tokens, refs, existingUrls) {
   const bySlug = /* @__PURE__ */ new Map();
   const byVariant = /* @__PURE__ */ new Map();
@@ -10320,7 +10328,7 @@ function resolveCharacterMentionsHybrid(prompt, tokens, refs, existingUrls) {
   let resolvedPrompt = prompt;
   for (const m of [...matched].sort((a, b) => b.offset - a.offset)) {
     const phrase = roleToPhrase(m.role, bindingFor(m.url));
-    resolvedPrompt = resolvedPrompt.slice(0, m.offset) + phrase + resolvedPrompt.slice(m.offset + m.token.length);
+    resolvedPrompt = spliceMentionPhrase(resolvedPrompt, m.offset, m.token.length, phrase);
   }
   const lockLines = [];
   const elementDirectives = [];
@@ -10351,16 +10359,21 @@ function locationModeDirective(mode) {
   }
 }
 function locationModeToRole(mode) {
-  switch (mode) {
-    case "identical":
-      return "background";
-    case "style":
-      return "style";
-    case "layout":
-      return "layout";
-    default:
-      return defaultRoleForSource("wired-location");
-  }
+  return roleBearingLocationMode(mode) ?? defaultRoleForSource("wired-location");
+}
+function roleBearingLocationMode(mode) {
+  const m = mode?.trim();
+  if (!m) return null;
+  return REFERENCE_ROLE_PRESETS["wired-location"].includes(m) ? m : null;
+}
+function resolveLocationRole(tokenRole, tokenUsageMode, ref) {
+  const explicitRole = tokenRole?.trim();
+  if (explicitRole) return normalizeRoleSlug(explicitRole);
+  const modeRole = roleBearingLocationMode(tokenUsageMode);
+  if (modeRole) return modeRole;
+  const nodeRole = ref.defaultRole?.trim();
+  if (nodeRole) return normalizeRoleSlug(nodeRole);
+  return locationModeToRole(ref.defaultUsageMode ?? DEFAULT_LOCATION_USAGE_MODE);
 }
 function resolveLocationMentions(prompt, tokens, refs) {
   const bySlug = /* @__PURE__ */ new Map();
@@ -10442,8 +10455,7 @@ function resolveLocationMentionsHybrid(prompt, tokens, refs, existingUrls) {
     mentionedLocationSlugs.add(t.locationSlug);
     refByUrl.set(match.url, match);
     if (t.lock !== void 0) lockOverrideByUrl.set(match.url, t.lock);
-    const mode = t.usageMode ?? match.defaultUsageMode ?? DEFAULT_LOCATION_USAGE_MODE;
-    const role = t.role ? normalizeRoleSlug(t.role) : locationModeToRole(mode);
+    const role = resolveLocationRole(t.role, t.usageMode, match);
     matched.push({ token: t.token, offset: t.offset, url: match.url, role });
   }
   const slotByUrl = /* @__PURE__ */ new Map();
@@ -10457,7 +10469,7 @@ function resolveLocationMentionsHybrid(prompt, tokens, refs, existingUrls) {
   let resolvedPrompt = prompt;
   for (const m of [...matched].sort((a, b) => b.offset - a.offset)) {
     const phrase = roleToPhrase(m.role, bindingFor(m.url));
-    resolvedPrompt = resolvedPrompt.slice(0, m.offset) + phrase + resolvedPrompt.slice(m.offset + m.token.length);
+    resolvedPrompt = spliceMentionPhrase(resolvedPrompt, m.offset, m.token.length, phrase);
   }
   const lockLines = [];
   const elementDirectives = [];
@@ -10475,6 +10487,109 @@ function resolveLocationMentionsHybrid(prompt, tokens, refs, existingUrls) {
   }
   return { prompt: resolvedPrompt, additionalUrls, mentionedLocationSlugs, lockLines, elementDirectives };
 }
+function resolveImageMentionsHybrid(prompt, tokens, refs, existingUrls) {
+  const bySlug = /* @__PURE__ */ new Map();
+  for (const r of refs) {
+    const slug = imageMentionSlugForRef(r);
+    if (!slug) continue;
+    if (!bySlug.has(slug)) bySlug.set(slug, r);
+  }
+  const additionalUrls = [];
+  const refByUrl = /* @__PURE__ */ new Map();
+  const lockOverrideByUrl = /* @__PURE__ */ new Map();
+  const matched = [];
+  for (const t of tokens) {
+    const match = bySlug.get(t.imageSlug);
+    if (!match || !match.url) continue;
+    additionalUrls.push(match.url);
+    refByUrl.set(match.url, match);
+    if (t.lock !== void 0) lockOverrideByUrl.set(match.url, t.lock);
+    const role = (t.role ?? "").trim() || resolveDefaultRole(match.defaultRole, match.defaultUsageMode, match.source);
+    matched.push({ token: t.token, offset: t.offset, url: match.url, role });
+  }
+  const slotByUrl = /* @__PURE__ */ new Map();
+  for (const u of [...existingUrls, ...additionalUrls]) {
+    if (!slotByUrl.has(u)) slotByUrl.set(u, slotByUrl.size + 1);
+  }
+  const bindingFor = (url2) => {
+    const slot = slotByUrl.get(url2);
+    return slot ? `reference image ${slotToLetter(slot)}` : "the reference image";
+  };
+  let resolvedPrompt = prompt;
+  for (const m of [...matched].sort((a, b) => b.offset - a.offset)) {
+    const phrase = roleToPhrase(m.role, bindingFor(m.url));
+    resolvedPrompt = spliceMentionPhrase(resolvedPrompt, m.offset, m.token.length, phrase);
+  }
+  const lockLines = [];
+  const elementDirectives = [];
+  const seenUrls = /* @__PURE__ */ new Set();
+  for (const m of matched) {
+    if (seenUrls.has(m.url)) continue;
+    seenUrls.add(m.url);
+    const ref = refByUrl.get(m.url);
+    if (!ref) continue;
+    const binding = bindingFor(m.url);
+    const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
+    if (lock) lockLines.push(lock);
+    const inject = ref.elementInjection?.trim();
+    if (inject) elementDirectives.push(inject);
+  }
+  return { prompt: resolvedPrompt, additionalUrls, lockLines, elementDirectives };
+}
+function resolveEntityMentionsHybrid(prompt, tokens, refs, existingUrls) {
+  const bySlug = /* @__PURE__ */ new Map();
+  for (const source of ["wired-creature", "wired-object"]) {
+    for (const r of refs) {
+      if (r.source !== source) continue;
+      const slug = entityMentionSlugForRef(r);
+      if (!slug) continue;
+      if (!bySlug.has(slug)) bySlug.set(slug, r);
+    }
+  }
+  const additionalUrls = [];
+  const mentionedUrls = /* @__PURE__ */ new Set();
+  const refByUrl = /* @__PURE__ */ new Map();
+  const lockOverrideByUrl = /* @__PURE__ */ new Map();
+  const matched = [];
+  for (const t of tokens) {
+    const match = bySlug.get(t.entitySlug);
+    if (!match || !match.url) continue;
+    additionalUrls.push(match.url);
+    mentionedUrls.add(match.url);
+    refByUrl.set(match.url, match);
+    if (t.lock !== void 0) lockOverrideByUrl.set(match.url, t.lock);
+    const role = (t.role ?? "").trim() || resolveDefaultRole(match.defaultRole, match.defaultUsageMode, match.source);
+    matched.push({ token: t.token, offset: t.offset, url: match.url, role });
+  }
+  const slotByUrl = /* @__PURE__ */ new Map();
+  for (const u of [...existingUrls, ...additionalUrls]) {
+    if (!slotByUrl.has(u)) slotByUrl.set(u, slotByUrl.size + 1);
+  }
+  const bindingFor = (url2) => {
+    const slot = slotByUrl.get(url2);
+    return slot ? `reference image ${slotToLetter(slot)}` : "the reference image";
+  };
+  let resolvedPrompt = prompt;
+  for (const m of [...matched].sort((a, b) => b.offset - a.offset)) {
+    const phrase = roleToPhrase(m.role, bindingFor(m.url));
+    resolvedPrompt = spliceMentionPhrase(resolvedPrompt, m.offset, m.token.length, phrase);
+  }
+  const lockLines = [];
+  const elementDirectives = [];
+  const seenUrls = /* @__PURE__ */ new Set();
+  for (const m of matched) {
+    if (seenUrls.has(m.url)) continue;
+    seenUrls.add(m.url);
+    const ref = refByUrl.get(m.url);
+    if (!ref) continue;
+    const binding = bindingFor(m.url);
+    const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
+    if (lock) lockLines.push(lock);
+    const inject = ref.elementInjection?.trim();
+    if (inject) elementDirectives.push(inject);
+  }
+  return { prompt: resolvedPrompt, additionalUrls, mentionedUrls, lockLines, elementDirectives };
+}
 function buildCanonicalFallback(refs, mentionedSlugs, startIndex) {
   const directiveLines = [];
   const urls = [];
@@ -10633,7 +10748,7 @@ function renderLocationCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, covere
     if (!slot) continue;
     seenUrls.add(r.url);
     const binding = `reference image ${slotToLetter(slot)}`;
-    phrases.push(roleToPhrase(locationModeToRole(r.defaultUsageMode), binding));
+    phrases.push(roleToPhrase(resolveLocationRole(null, null, r), binding));
     const lock = buildIdentityLockLine(r, binding);
     if (lock) lockLines.push(lock);
     const inject = r.elementInjection?.trim();
@@ -10792,6 +10907,20 @@ function reconcileBodySegments(body, bodySegments) {
 function buildImagePrompt(config2) {
   return buildImagePromptInternal(config2);
 }
+function buildImagePromptWithOverflow(config2) {
+  const marks = newAssemblyMarks();
+  const result = buildImagePromptInternal(config2, marks);
+  return { ...result, overflowChars: marks.overflowChars };
+}
+function newAssemblyMarks() {
+  return {
+    directivesPrefix: "",
+    bodyBeforeSuffixes: "",
+    styleSuffix: "",
+    avoidSuffix: "",
+    overflowChars: 0
+  };
+}
 function buildImagePromptInternal(config2, marks) {
   let {
     provider,
@@ -10813,6 +10942,7 @@ function buildImagePromptInternal(config2, marks) {
   const suppressedCanonicalLocationIds = config2.suppressedCanonicalLocationIds ?? [];
   const isHybrid = config2.referenceFormat === "hybrid";
   let hybridBodyConverged = false;
+  const mentionedEntityUrls = /* @__PURE__ */ new Set();
   if (config2.skipCharacterMentions) {
     config2 = {
       ...config2,
@@ -10857,7 +10987,11 @@ function buildImagePromptInternal(config2, marks) {
         connectedReferences.map((r) => r.locationSlug).filter((s) => typeof s === "string" && s.length > 0)
       )
     );
-    if (knownCharacterSlugs.length > 0 || hasExtraRefs || knownLocationSlugs.length > 0) {
+    const knownImageSlugs = knownImageSlugsFromRefs(connectedReferences);
+    const hasImageMentionTokens = isHybrid && knownImageSlugs.length > 0 && findImageMentionTokens(config2.prompt, knownImageSlugs).length > 0;
+    const knownEntitySlugs = knownEntitySlugsFromRefs(connectedReferences);
+    const hasEntityMentionTokens = isHybrid && knownEntitySlugs.length > 0 && findEntityMentionTokens(config2.prompt, knownEntitySlugs).length > 0;
+    if (knownCharacterSlugs.length > 0 || hasExtraRefs || knownLocationSlugs.length > 0 || hasImageMentionTokens || hasEntityMentionTokens) {
       const mentionTokens = knownCharacterSlugs.length > 0 ? findCharacterMentionTokens(config2.prompt, knownCharacterSlugs) : [];
       let hybridLockLines = [];
       let hybridElementDirectives = [];
@@ -10911,6 +11045,43 @@ function buildImagePromptInternal(config2, marks) {
         if (r.locationVariantBucket) return false;
         return !mentionedLocationSlugs.has(r.locationSlug);
       });
+      let hybridImageLockLines = [];
+      let hybridImageElementDirectives = [];
+      if (hasImageMentionTokens) {
+        const imageTokens = findImageMentionTokens(resolved.prompt, knownImageSlugs);
+        if (imageTokens.length > 0) {
+          const hi = resolveImageMentionsHybrid(
+            resolved.prompt,
+            imageTokens,
+            connectedReferences,
+            [...referenceImageUrls || [], ...resolved.additionalUrls]
+          );
+          resolved.prompt = hi.prompt;
+          resolved.additionalUrls = [...resolved.additionalUrls, ...hi.additionalUrls];
+          hybridImageLockLines = hi.lockLines;
+          hybridImageElementDirectives = hi.elementDirectives;
+          if (hi.additionalUrls.length > 0) hybridBodyConverged = true;
+        }
+      }
+      let hybridEntityLockLines = [];
+      let hybridEntityElementDirectives = [];
+      if (hasEntityMentionTokens) {
+        const entityTokens = findEntityMentionTokens(resolved.prompt, knownEntitySlugs);
+        if (entityTokens.length > 0) {
+          const he = resolveEntityMentionsHybrid(
+            resolved.prompt,
+            entityTokens,
+            connectedReferences,
+            [...referenceImageUrls || [], ...resolved.additionalUrls]
+          );
+          resolved.prompt = he.prompt;
+          resolved.additionalUrls = [...resolved.additionalUrls, ...he.additionalUrls];
+          hybridEntityLockLines = he.lockLines;
+          hybridEntityElementDirectives = he.elementDirectives;
+          for (const u of he.mentionedUrls) mentionedEntityUrls.add(u);
+          if (he.additionalUrls.length > 0) hybridBodyConverged = true;
+        }
+      }
       const prefixDedupedLength = [
         ...referenceImageUrls || [],
         ...resolved.additionalUrls
@@ -10991,12 +11162,16 @@ ${promptForNext}`;
         const allLockLines = [.../* @__PURE__ */ new Set([
           ...hybridLockLines,
           ...hybridLocationLockLines,
+          ...hybridImageLockLines,
+          ...hybridEntityLockLines,
           ...canonical.lockLines,
           ...extrasRendered.lockLines
         ])];
         const trailingLines = [
           ...hybridElementDirectives,
           ...hybridLocationElementDirectives,
+          ...hybridImageElementDirectives,
+          ...hybridEntityElementDirectives,
           ...canonical.phrases,
           ...canonical.elementDirectives,
           ...extrasRendered.bodyLines,
@@ -11043,7 +11218,8 @@ ${trailingLines.join("\n")}` : "";
         if (coveredUrl) tokenCoveredUrls.add(coveredUrl);
       }
       const locCanon = renderLocationCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, tokenCoveredUrls);
-      const objCanon = renderObjectCreatureCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, tokenCoveredUrls);
+      const objCoveredUrls = mentionedEntityUrls.size > 0 ? /* @__PURE__ */ new Set([...tokenCoveredUrls, ...mentionedEntityUrls]) : tokenCoveredUrls;
+      const objCanon = renderObjectCreatureCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, objCoveredUrls);
       const canonLockLines = [...locCanon.lockLines, ...objCanon.lockLines];
       const canonLockBlock = canonLockLines.length > 0 ? `${canonLockLines.join("\n")}
 
@@ -11102,11 +11278,13 @@ Avoid: ${negPrompt2}`;
     const maxLen2 = getMaxImagePromptChars(provider);
     const reserved2 = styleSuffix2.length + avoidSuffix2.length;
     if (prompt2.length + reserved2 > maxLen2) {
+      if (marks) marks.overflowChars += prompt2.length + reserved2 - maxLen2;
       prompt2 = prompt2.slice(0, Math.max(0, maxLen2 - reserved2 - 3)) + "...";
     }
     if (marks) marks.bodyBeforeSuffixes = prompt2.slice(marks.directivesPrefix.length);
     prompt2 = prompt2 + styleSuffix2 + avoidSuffix2;
     if (prompt2.length > maxLen2) {
+      if (marks) marks.overflowChars += prompt2.length - maxLen2;
       prompt2 = prompt2.slice(0, maxLen2 - 3) + "...";
     }
     if (!isHybrid) {
@@ -11180,11 +11358,13 @@ Avoid: ${negPrompt}`;
   const maxLen = getMaxImagePromptChars(provider);
   const reserved = styleSuffix.length + avoidSuffix.length;
   if (prompt.length + reserved > maxLen) {
+    if (marks) marks.overflowChars += prompt.length + reserved - maxLen;
     prompt = prompt.slice(0, Math.max(0, maxLen - reserved - 3)) + "...";
   }
   if (marks) marks.bodyBeforeSuffixes = prompt;
   prompt = prompt + styleSuffix + avoidSuffix;
   if (prompt.length > maxLen) {
+    if (marks) marks.overflowChars += prompt.length - maxLen;
     prompt = prompt.slice(0, maxLen - 3) + "...";
   }
   const allRefs = referenceImageUrls.length > 0 ? referenceImageUrls : ancestorRefs;
@@ -11194,12 +11374,7 @@ Avoid: ${negPrompt}`;
   return { prompt, nativeNegativePrompt, referenceImageUrls: refsToSend };
 }
 function buildImagePromptSegments(config2, bodySegments) {
-  const marks = {
-    directivesPrefix: "",
-    bodyBeforeSuffixes: "",
-    styleSuffix: "",
-    avoidSuffix: ""
-  };
+  const marks = newAssemblyMarks();
   const result = buildImagePromptInternal(config2, marks);
   let segments = [
     ...marks.directivesPrefix ? [{ text: marks.directivesPrefix, origin: "mention" }] : [],
@@ -11389,13 +11564,24 @@ function hybridRolePhrase(label, letter) {
   return `the ${label} from reference image ${letter}`;
 }
 function expandImageRefTokensHybrid(prompt, refs, finalIndexByUrl) {
-  return prompt.replace(IMAGE_TOKEN_PATTERN, (match, num, label) => {
-    const n = parseInt(num, 10);
+  const splices = [];
+  for (const m of prompt.matchAll(IMAGE_TOKEN_PATTERN)) {
+    const n = parseInt(m[1], 10);
     const ref = refs[n - 1];
     const finalIdx = ref?.url ? finalIndexByUrl.get(ref.url) : void 0;
-    if (!finalIdx) return match;
-    return hybridRolePhrase((label ?? "").trim(), slotToLetter(finalIdx));
-  });
+    if (!finalIdx) continue;
+    splices.push({
+      offset: m.index ?? 0,
+      length: m[0].length,
+      phrase: hybridRolePhrase((m[2] ?? "").trim(), slotToLetter(finalIdx))
+    });
+  }
+  let resolved = prompt;
+  for (let i = splices.length - 1; i >= 0; i--) {
+    const s = splices[i];
+    resolved = spliceMentionPhrase(resolved, s.offset, s.length, s.phrase);
+  }
+  return resolved;
 }
 function capitalizeLineInitial(line) {
   return line.replace(/[a-zA-Z]/, (c) => c.toUpperCase());
@@ -11620,6 +11806,266 @@ function renderLens(l) {
   return bits.length > 0 ? `Lens: ${bits.join(", ")}.` : "";
 }
 
+// src/direction-registry.ts
+var perId = (full, compact) => (ids, mode) => {
+  const out = [];
+  for (const id of ids) {
+    const frag = mode === "compact" ? compact(id) : full(id);
+    if (frag.length > 0) out.push(frag);
+  }
+  return out;
+};
+var viaListBuilder = (build) => (ids, mode) => build(ids.length === 1 ? ids[0] : [...ids], mode).filter((s) => s.length > 0);
+var viaStringBuilder = (build) => (ids, mode) => {
+  const s = build(ids.length === 1 ? ids[0] : [...ids], mode);
+  return s.length > 0 ? [s] : [];
+};
+var viaMood = (ids, mode) => buildMoodHints({ mood: ids.length === 1 ? ids[0] : [...ids] }, mode).filter(
+  (s) => s.length > 0
+);
+var framing = perId(getFramingPromptHint, getFramingTerm);
+var lighting = perId(getLightingPromptHint, getLightingTerm);
+var exposure = perId(getExposurePromptHint, getExposureTerm);
+var temporal = perId(getTemporalPromptHint, getTemporalTerm);
+var DIRECTION_FIELDS = [
+  { key: "cameraMotion", surface: "video", family: "motion", maxPicks: 1, render: perId(getCameraMotionPromptHint, getCameraMotionTerm) },
+  // Composition (the Framing catalog, one row per category).
+  { key: "shotSize", surface: "both", family: "look", maxPicks: 1, render: framing },
+  { key: "angle", surface: "both", family: "look", maxPicks: 1, render: framing },
+  { key: "coverage", surface: "both", family: "look", maxPicks: 1, render: framing },
+  { key: "composition", surface: "both", family: "look", maxPicks: 2, render: framing },
+  { key: "vantage", surface: "both", family: "look", maxPicks: 1, render: framing },
+  { key: "pose", surface: "both", family: "look", maxPicks: 1, render: perId(getPosePromptHint, getPoseTerm) },
+  { key: "compositionEffect", surface: "both", family: "look", maxPicks: 1, render: perId(getCompositionEffectPromptHint, getCompositionEffectTerm) },
+  // Camera.
+  { key: "cameraFormat", surface: "both", family: "look", maxPicks: 1, render: perId(getCameraFormatPromptHint, getCameraFormatTerm) },
+  { key: "lens", surface: "both", family: "look", maxPicks: 1, render: perId(getLensPromptHint, getLensTerm) },
+  // Exposure (stills only — a video's exposure rides its own temporal levers).
+  { key: "aperture", surface: "image", family: "look", maxPicks: 1, render: exposure },
+  { key: "shutterSpeed", surface: "image", family: "look", maxPicks: 1, render: exposure },
+  { key: "isoValue", surface: "image", family: "look", maxPicks: 1, render: exposure },
+  // Light (the Lighting catalog, one row per category).
+  { key: "timeOfDay", surface: "both", family: "look", maxPicks: 1, render: lighting },
+  { key: "lightingStyle", surface: "both", family: "look", maxPicks: 2, render: lighting },
+  { key: "lightingDirection", surface: "both", family: "look", maxPicks: 1, render: lighting },
+  { key: "lightingRatio", surface: "both", family: "look", maxPicks: 1, render: lighting },
+  { key: "colorTemperature", surface: "both", family: "look", maxPicks: 1, render: lighting },
+  { key: "colorLook", surface: "both", family: "look", maxPicks: 1, render: perId(getColorLookPromptHint, getColorLookTerm) },
+  { key: "atmosphere", surface: "both", family: "look", maxPicks: 2, render: viaListBuilder(buildAtmosphereHints) },
+  { key: "postProcess", surface: "image", family: "look", maxPicks: 2, render: viaListBuilder(buildPostProcessHints) },
+  // Style.
+  { key: "style", surface: "both", family: "look", maxPicks: 1, render: perId(getStylePromptHint, getStyleTerm) },
+  { key: "mood", surface: "both", family: "look", maxPicks: 2, render: viaMood },
+  { key: "aesthetic", surface: "both", family: "look", maxPicks: 2, render: viaStringBuilder(buildAestheticHints) },
+  { key: "photoGenre", surface: "image", family: "look", maxPicks: 1, render: perId(getPhotoGenrePromptHint, getPhotoGenreTerm) },
+  { key: "photographer", surface: "image", family: "look", maxPicks: 2, render: viaStringBuilder(buildPhotographerHints) },
+  { key: "renderQuality", surface: "image", family: "look", maxPicks: 1, render: perId(getRenderQualityPromptHint, getRenderQualityTerm) },
+  // Scene.
+  { key: "setting", surface: "both", family: "look", maxPicks: 1, render: perId(getSettingPromptHint, getSettingTerm) },
+  { key: "era", surface: "both", family: "look", maxPicks: 1, render: perId(getEraPromptHint, getEraTerm) },
+  { key: "backdrop", surface: "both", family: "look", maxPicks: 1, render: perId(getBackdropPromptHint, getBackdropTerm) },
+  // Motion & time.
+  { key: "actionFx", surface: "video", family: "motion", maxPicks: 2, render: viaListBuilder(buildActionFxHints) },
+  { key: "temporalSpeed", surface: "video", family: "motion", maxPicks: 1, render: temporal },
+  { key: "temporalFreeze", surface: "video", family: "motion", maxPicks: 1, render: temporal },
+  { key: "temporalDirection", surface: "video", family: "motion", maxPicks: 1, render: temporal },
+  { key: "temporalShutter", surface: "video", family: "motion", maxPicks: 1, render: temporal },
+  { key: "transition", surface: "video", family: "motion", maxPicks: 2, render: perId(getTransitionPromptHint, getTransitionTerm) },
+  { key: "loopSubject", surface: "video", family: "motion", maxPicks: 1, render: perId(getLoopSubjectPromptHint, getLoopSubjectTerm) },
+  // ── LEGACY BLOCK — see the table doc above. Placed LAST, in today's exact
+  //    `composePromptText` order, so every pre-registry caller is byte-identical.
+  { key: "framingId", surface: "both", family: "look", maxPicks: 1, render: framing },
+  { key: "framingAngleId", surface: "both", family: "look", maxPicks: 1, render: framing },
+  { key: "lightingId", surface: "both", family: "look", maxPicks: 1, render: lighting },
+  { key: "lensId", surface: "both", family: "look", maxPicks: 1, render: perId(getLensPromptHint, getLensTerm) },
+  { key: "cameraFormatId", surface: "both", family: "look", maxPicks: 1, render: perId(getCameraFormatPromptHint, getCameraFormatTerm) }
+];
+var DIRECTION_KEYS = DIRECTION_FIELDS.map((f) => f.key);
+var IMAGE_HINT_MODE_DEFAULT = "full";
+var VIDEO_HINT_MODE_DEFAULT = { look: "full", motion: "compact" };
+function modeForFamily(mode, family) {
+  return typeof mode === "string" ? mode : family === "motion" ? mode.motion : mode.look;
+}
+var DIRECTION_ARRAY_CEILING = 8;
+var DIRECTION_ID_MAX_CHARS = 100;
+function normalizeDirectionIds(value, maxPicks) {
+  const ids = [];
+  if (typeof value === "string") {
+    if (value) ids.push(value);
+  } else if (Array.isArray(value)) {
+    for (const v of value) {
+      if (ids.length >= maxPicks) break;
+      if (typeof v === "string" && v && !ids.includes(v)) ids.push(v);
+    }
+  }
+  return ids.slice(0, maxPicks);
+}
+function directionFieldsForSurface(surface) {
+  return DIRECTION_FIELDS.filter((f) => f.surface === "both" || f.surface === surface);
+}
+function renderDirectionHints(direction, opts) {
+  if (!direction) return [];
+  const mode = opts.mode ?? "full";
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const spec of DIRECTION_FIELDS) {
+    if (spec.surface !== "both" && spec.surface !== opts.surface) continue;
+    const ids = normalizeDirectionIds(
+      direction[spec.key],
+      spec.maxPicks
+    );
+    if (ids.length === 0) continue;
+    for (const hint of spec.render(ids, modeForFamily(mode, spec.family))) {
+      if (hint.length > 0 && !seen.has(hint)) {
+        seen.add(hint);
+        out.push(hint);
+      }
+    }
+  }
+  return out;
+}
+var viaFragmentBuilder = (build) => (subject, mode) => {
+  const clause = build(subject, mode).filter((s) => s.length > 0).join(", ");
+  return clause.length > 0 ? [clause] : [];
+};
+var viaListBuilder2 = (build) => (ids, mode) => build(ids.length === 1 ? ids[0] : [...ids], mode).filter((s) => s.length > 0);
+var viaStringBuilder2 = (build) => (ids, mode) => {
+  const s = build(ids.length === 1 ? ids[0] : [...ids], mode);
+  return s.length > 0 ? [s] : [];
+};
+var perId2 = (full, compact) => (ids, mode) => {
+  const out = [];
+  for (const id of ids) {
+    const frag = mode === "compact" ? compact(id) : full(id);
+    if (frag.length > 0) out.push(frag);
+  }
+  return out;
+};
+var SUBJECT_FIELDS = [
+  { key: "person", kind: "group", surface: "both", render: viaFragmentBuilder(buildPersonHints) },
+  { key: "styling", kind: "group", surface: "both", render: viaFragmentBuilder(buildStylingHints) },
+  { key: "heldProp", kind: "ids", surface: "both", maxPicks: 2, render: viaListBuilder2(buildHeldPropHints) },
+  { key: "material", kind: "ids", surface: "both", maxPicks: 2, render: viaStringBuilder2(buildMaterialHints) },
+  { key: "animal", kind: "ids", surface: "both", maxPicks: 1, render: perId2(getAnimalPromptHint, getAnimalTerm) }
+];
+var SUBJECT_FOLD_KEYS = SUBJECT_FIELDS.map((f) => f.key);
+var IDS_ROWS = SUBJECT_FIELDS.filter((f) => f.kind === "ids");
+var SUBJECT_CUSTOM_AGE_KEY = "customAge";
+var CUSTOM_AGE_MIN = 0;
+var CUSTOM_AGE_MAX = 120;
+var SUBJECT_KEYS = [
+  ...PERSON_DIMENSION_ORDER.map((d) => PERSON_FIELD_BY_DIMENSION[d]),
+  SUBJECT_CUSTOM_AGE_KEY,
+  ...STYLING_DIMENSION_ORDER.map((d) => STYLING_FIELD_BY_DIMENSION[d]),
+  ...IDS_ROWS.map((f) => f.key)
+];
+function getRegisteredSubjectKeys() {
+  const fieldByDimension = getRegisteredPersonFieldByDimension();
+  const personFields = [];
+  for (const dimension of getRegisteredPersonDimensionOrder()) {
+    const field = fieldByDimension[dimension];
+    if (field) personFields.push(field);
+  }
+  return [
+    ...personFields,
+    SUBJECT_CUSTOM_AGE_KEY,
+    ...STYLING_DIMENSION_ORDER.map((d) => STYLING_FIELD_BY_DIMENSION[d]),
+    ...IDS_ROWS.map((f) => f.key)
+  ];
+}
+var SUBJECT_IMAGE_HINT_MODE_DEFAULT = "full";
+var SUBJECT_VIDEO_HINT_MODE_DEFAULT = "compact";
+var SUBJECT_ARRAY_CEILING = DIRECTION_ARRAY_CEILING;
+var SUBJECT_ID_MAX_CHARS = DIRECTION_ID_MAX_CHARS;
+var MAX_SUBJECT_KEYS = 128;
+var SUBJECT_KEY_MAX_CHARS = 64;
+function normalizeIds(value, maxPicks) {
+  const ids = [];
+  if (typeof value === "string") {
+    if (value) ids.push(value);
+  } else if (Array.isArray(value)) {
+    for (const v of value) {
+      if (ids.length >= maxPicks) break;
+      if (typeof v === "string" && v && !ids.includes(v)) ids.push(v);
+    }
+  }
+  return ids.slice(0, maxPicks);
+}
+function limitByField() {
+  const out = /* @__PURE__ */ new Map();
+  const personFieldByDimension = getRegisteredPersonFieldByDimension();
+  for (const dimension of getRegisteredPersonDimensionOrder()) {
+    const field = personFieldByDimension[dimension];
+    if (field) out.set(field, getPersonDimensionLimit(dimension));
+  }
+  for (const dimension of STYLING_DIMENSION_ORDER) {
+    out.set(
+      STYLING_FIELD_BY_DIMENSION[dimension],
+      getStylingDimensionLimit(dimension)
+    );
+  }
+  for (const row of IDS_ROWS) out.set(row.key, row.maxPicks);
+  return out;
+}
+function normalizeSubjectFields(subject) {
+  if (!subject || typeof subject !== "object" || Array.isArray(subject)) return void 0;
+  const src = subject;
+  const limits = limitByField();
+  const out = {};
+  const rawAge = src[SUBJECT_CUSTOM_AGE_KEY];
+  if (typeof rawAge === "number" && Number.isFinite(rawAge)) {
+    out[SUBJECT_CUSTOM_AGE_KEY] = Math.max(
+      CUSTOM_AGE_MIN,
+      Math.min(CUSTOM_AGE_MAX, Math.round(rawAge))
+    );
+  }
+  for (const [field, limit] of limits) {
+    const ids = normalizeIds(src[field], limit);
+    if (ids.length === 0) continue;
+    out[field] = ids.length === 1 ? ids[0] : ids;
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function subjectFieldsForSurface(surface) {
+  return SUBJECT_FIELDS.filter((f) => f.surface === "both" || f.surface === surface);
+}
+function renderSubjectHints(subject, opts) {
+  const bag = normalizeSubjectFields(subject);
+  if (!bag) return [];
+  const mode = opts.mode ?? "full";
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const spec of SUBJECT_FIELDS) {
+    if (spec.surface !== "both" && spec.surface !== opts.surface) continue;
+    const hints = spec.kind === "group" ? spec.render(bag, mode) : spec.render(normalizeIds(bag[spec.key], spec.maxPicks), mode);
+    for (const hint of hints) {
+      if (hint.length > 0 && !seen.has(hint)) {
+        seen.add(hint);
+        out.push(hint);
+      }
+    }
+  }
+  return out;
+}
+
+// src/prompt-hint-join.ts
+var PROMPT_HINT_SEPARATOR = ". ";
+function joinPromptHints(userPrompt, hints) {
+  if (hints.length === 0) return userPrompt;
+  return [userPrompt.trim(), ...hints].filter((p) => p.length > 0).join(PROMPT_HINT_SEPARATOR);
+}
+
+// src/hint-shedding.ts
+function keepableDirectionHints(hintClauses, kept, deficit) {
+  let remaining = deficit;
+  let next = kept;
+  while (next > 0 && remaining > 0) {
+    next -= 1;
+    remaining -= hintClauses[next].length + PROMPT_HINT_SEPARATOR.length;
+  }
+  return next;
+}
+
 // src/ref-binding.ts
 function identityRefsSentence(firstOrdinal, lastOrdinal) {
   return firstOrdinal === lastOrdinal ? `${REF_BINDING.ordinal(firstOrdinal)} is an identity reference for this shot's subjects \u2014 match its subject's exact appearance; it is not a frame.` : `${REF_BINDING.ordinal(firstOrdinal)} through ${REF_BINDING.ordinal(lastOrdinal)} are identity references for this shot's subjects \u2014 match each subject's exact appearance; they are not frames.`;
@@ -12205,22 +12651,32 @@ function assembleSunoInput(input) {
 }
 
 // src/assemble-image-input.ts
-function composePromptText(userPrompt, direction, structured) {
+function renderImageHintPieces(subject, direction, structured) {
+  return {
+    hintClauses: [
+      ...renderSubjectHints(subject, {
+        surface: "image",
+        mode: SUBJECT_IMAGE_HINT_MODE_DEFAULT
+      }),
+      ...renderDirectionHints(direction, {
+        surface: "image",
+        mode: IMAGE_HINT_MODE_DEFAULT
+      })
+    ].filter((p) => p.length > 0),
+    structuredFragment: structured ? renderStructuredFields(structured) : ""
+  };
+}
+function composePromptText(userPrompt, pieces, keptHintClauses) {
   const hints = [
-    getFramingPromptHint(direction?.framingId),
-    getFramingPromptHint(direction?.framingAngleId),
-    getLightingPromptHint(direction?.lightingId),
-    getLensPromptHint(direction?.lensId),
-    getCameraFormatPromptHint(direction?.cameraFormatId),
-    structured ? renderStructuredFields(structured) : ""
+    ...pieces.hintClauses.slice(0, keptHintClauses),
+    pieces.structuredFragment
   ].filter((p) => p.length > 0);
-  if (hints.length === 0) return userPrompt;
-  return [userPrompt.trim(), ...hints].filter((p) => p.length > 0).join(". ");
+  return joinPromptHints(userPrompt, hints);
 }
 function assembleImageInput(input) {
-  const prompt = composePromptText(input.userPrompt, input.direction, input.structured);
-  const result = buildImagePrompt({
-    prompt,
+  const pieces = renderImageHintPieces(input.subject, input.direction, input.structured);
+  const assembleWith = (keptHintClauses) => buildImagePromptWithOverflow({
+    prompt: composePromptText(input.userPrompt, pieces, keptHintClauses),
     provider: input.provider,
     ...input.connectedReferences !== void 0 ? { connectedReferences: input.connectedReferences } : {},
     // Manual uploads / direct refs ride the builder's reference-URL channel so
@@ -12243,6 +12699,13 @@ function assembleImageInput(input) {
     ...input.sourceNodeIdById !== void 0 ? { sourceNodeIdById: input.sourceNodeIdById } : {},
     ...input.skipCharacterMentions !== void 0 ? { skipCharacterMentions: input.skipCharacterMentions } : {}
   });
+  let kept = pieces.hintClauses.length;
+  let fitted = assembleWith(kept);
+  while (fitted.overflowChars > 0 && kept > 0) {
+    kept = keepableDirectionHints(pieces.hintClauses, kept, fitted.overflowChars);
+    fitted = assembleWith(kept);
+  }
+  const { overflowChars, ...result } = fitted;
   if (input.throwOnEmpty && !result.prompt.trim()) {
     throw new Error(
       "No prompt \u2014 type one, bind a character, or pick a cinematography direction"
@@ -12250,6 +12713,152 @@ function assembleImageInput(input) {
   }
   return result;
 }
+
+// src/assemble-video-input.ts
+function composeVideoPromptText(userPrompt, direction, structured, opts) {
+  const hintClauses = [
+    ...renderSubjectHints(opts?.subject, {
+      surface: "video",
+      mode: opts?.subjectHintMode ?? SUBJECT_VIDEO_HINT_MODE_DEFAULT
+    }),
+    ...renderDirectionHints(direction, {
+      surface: "video",
+      mode: opts?.hintMode ?? VIDEO_HINT_MODE_DEFAULT
+    })
+  ].filter((p) => p.length > 0);
+  const structuredFragment = structured ? renderStructuredFields(structured) : "";
+  const composeWith = (kept2) => {
+    const hints = [...hintClauses.slice(0, kept2), structuredFragment].filter(
+      (p) => p.length > 0
+    );
+    if (hints.length === 0) return userPrompt;
+    return joinPromptHints(userPrompt ?? "", hints);
+  };
+  const cap = opts?.cap;
+  if (cap === void 0) return composeWith(hintClauses.length);
+  const frame = opts?.frame ?? ((body2) => body2);
+  let kept = hintClauses.length;
+  let body = composeWith(kept);
+  let framedLength = frame(body)?.length ?? 0;
+  while (framedLength > cap && kept > 0) {
+    kept = keepableDirectionHints(hintClauses, kept, framedLength - cap);
+    body = composeWith(kept);
+    framedLength = frame(body)?.length ?? 0;
+  }
+  return body;
+}
+
+// src/read-node-direction.ts
+function readDirectionFields(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const src = value;
+  const out = {};
+  for (const spec of DIRECTION_FIELDS) {
+    const v = src[spec.key];
+    if (typeof v === "string") {
+      if (v.length > 0 && v.length <= DIRECTION_ID_MAX_CHARS) out[spec.key] = v;
+    } else if (Array.isArray(v)) {
+      const kept = [];
+      for (const x of v) {
+        if (kept.length >= DIRECTION_ARRAY_CEILING) break;
+        if (typeof x === "string" && x.length > 0 && x.length <= DIRECTION_ID_MAX_CHARS) {
+          kept.push(x);
+        }
+      }
+      if (kept.length > 0) out[spec.key] = kept;
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function readSubjectFields(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const src = value;
+  const out = {};
+  for (const key of getRegisteredSubjectKeys()) {
+    const v = src[key];
+    if (key === SUBJECT_CUSTOM_AGE_KEY) {
+      if (typeof v === "number" && Number.isFinite(v)) out[key] = v;
+      continue;
+    }
+    if (typeof v === "string") {
+      if (v.length > 0 && v.length <= SUBJECT_ID_MAX_CHARS) out[key] = v;
+    } else if (Array.isArray(v)) {
+      const kept = [];
+      for (const x of v) {
+        if (kept.length >= SUBJECT_ARRAY_CEILING) break;
+        if (typeof x === "string" && x.length > 0 && x.length <= SUBJECT_ID_MAX_CHARS) {
+          kept.push(x);
+        }
+      }
+      if (kept.length > 0) out[key] = kept;
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+var GENDERS = ["man", "woman", "child", "non-binary"];
+var MAX_STRUCTURED_VALUE_CHARS = 200;
+var PERSON_FIELDS2 = {
+  age: "number",
+  gender: "gender",
+  hair: "string",
+  eyes: "string",
+  expression: "string",
+  profession: "string",
+  warriorType: "string"
+};
+var STYLING_FIELDS2 = {
+  mood: "string",
+  lighting: "string",
+  aesthetic: "string",
+  colorLook: "string"
+};
+var SETTING_FIELDS = {
+  era: "string",
+  atmosphere: "string",
+  backdrop: "string"
+};
+var CAMERA_FIELDS = {
+  framing: "string",
+  motion: "string",
+  format: "string"
+};
+var LENS_FIELDS = { focalLength: "string", aperture: "string" };
+var STRUCTURED_GROUPS = {
+  person: PERSON_FIELDS2,
+  styling: STYLING_FIELDS2,
+  setting: SETTING_FIELDS,
+  camera: CAMERA_FIELDS,
+  lens: LENS_FIELDS
+};
+function readField(v, kind) {
+  if (kind === "number") return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+  if (typeof v !== "string" || v.length === 0 || v.length > MAX_STRUCTURED_VALUE_CHARS) {
+    return void 0;
+  }
+  if (kind === "gender") return GENDERS.includes(v) ? v : void 0;
+  return v;
+}
+function readStructuredFields(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const src = value;
+  const out = {};
+  for (const group of Object.keys(STRUCTURED_GROUPS)) {
+    const raw = src[group];
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) continue;
+    const rawRec = raw;
+    const kept = {};
+    for (const [field, kind] of Object.entries(
+      STRUCTURED_GROUPS[group]
+    )) {
+      const v = readField(rawRec[field], kind);
+      if (v !== void 0) kept[field] = v;
+    }
+    if (Object.keys(kept).length > 0) out[group] = kept;
+  }
+  const mood = readField(src.mood, "string");
+  if (mood !== void 0) out.mood = mood;
+  return Object.keys(out).length > 0 ? out : void 0;
+}
 var clean = (u) => {
   const t = u?.trim();
   return t && t.length > 0 ? t : void 0;
@@ -33266,8 +33875,8 @@ var SINGLE_PICKER_WIRING = [
   { 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 STYLING_FIELDS3 = STYLING_DIMENSION_ORDER.map((d) => STYLING_FIELD_BY_DIMENSION[d]);
+var PERSON_FIELDS3 = 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",
@@ -33303,7 +33912,7 @@ var MULTI_PICKER_WIRING = [
     kind: "multi",
     nodeType: "person",
     label: "Person",
-    fields: PERSON_FIELDS2,
+    fields: PERSON_FIELDS3,
     catalogId: "person",
     catalogEntries: flatCat(PEOPLE),
     fieldOptions: optionsByDiscriminator(PEOPLE, (e) => e.dimension, PERSON_FIELD_BY_DIMENSION)
@@ -33312,7 +33921,7 @@ var MULTI_PICKER_WIRING = [
     kind: "multi",
     nodeType: "styling",
     label: "Styling",
-    fields: STYLING_FIELDS2,
+    fields: STYLING_FIELDS3,
     catalogId: "styling",
     catalogEntries: flatCat(STYLINGS),
     fieldOptions: optionsByDiscriminator(STYLINGS, (e) => e.dimension, STYLING_FIELD_BY_DIMENSION)
@@ -33450,6 +34059,6 @@ function buildSurroundFillPrompt(direction, userPrompt) {
   return `${scene}This is a partial frame: the ${carried} portion contains real, finished pixels and the ${painted} portion is flat gray that MUST be painted in. Paint ONLY the ${painted} gray region as a natural, seamless continuation of the ${carried} portion \u2014 same scene, same perspective, continuing the horizon, geometry, and content across the boundary with no break. Keep the ${carried} portion completely unchanged. CRITICAL: do NOT change the lighting, exposure, white balance, or time of day. Match the ${carried} portion's EXACT light, color temperature, and contrast across the whole frame \u2014 if it is flat overcast daylight, keep flat overcast daylight. No golden hour, no sunset, no warm relight, no cinematic regrade. The seam between the ${carried} and ${painted} portions must be invisible. No people, no text, no labels, no watermarks.`;
 }
 
-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_DURATIONS, CHARACTER_FX_IDS, CHARACTER_FX_INTENSITIES, CHARACTER_FX_POSITIONS, 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_REFERENCE_PROMPT_DOCTRINE, 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, NODE_PROMPT_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, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, 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, TERM_MAX_CHARS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_DURATIONS, TRANSITION_IDS, TRANSITION_INTENSITIES, TRANSITION_POSITIONS, 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, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeNegative, composePickerCatalogs, composeSoundHintFromConnections, composeTransitionHintFromConnections, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, deriveTerm, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAestheticTerm, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getAtmosphereTerm, getBackdrop, getBackdropLabel, getBackdropPromptHint, getBackdropTerm, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraFormatTerm, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCameraMotionTerm, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getCharacterFxTerm, getColorLook, getColorLookLabel, getColorLookPromptHint, getColorLookTerm, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getCompositionEffectTerm, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getEraTerm, getExposure, getExposureLabel, getExposurePromptHint, getExposureTerm, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getFramingTerm, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getHeldPropTerm, getIdentityLockClause, getInstrument, getInstrumentTerm, getLens, getLensLabel, getLensPromptHint, getLensTerm, getLighting, getLightingLabel, getLightingPromptHint, getLightingTerm, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getLoopSubjectTerm, getMaterial, getMaterialLabel, getMaterialPromptHint, getMaterialTerm, getMood, getMoodLabel, getMoodPromptHint, getMoodTerm, getMusicEmotion, getMusicEmotionTerm, getMusicEnergy, getMusicEnergyTerm, getMusicEra, getMusicEraTerm, getMusicGenre, getMusicGenreLabel, getMusicGenreTerm, getMusicSubgenre, getMusicSubgenreTerm, getMusicVibe, getMusicVibeTerm, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPersonTerm, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotoGenreTerm, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPhotographerTerm, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPoseTerm, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getPostProcessEffectTerm, getProductionStyle, getProductionStyleTerm, getPromptDoctrine, getPromptFields, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, getSnippetMedia, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyleTerm, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getStylingTerm, getTemporal, getTemporalLabel, getTemporalPromptHint, getTemporalTerm, getTransition, getTransitionLabel, getTransitionPromptHint, getTransitionTerm, getVocalPresence, getVocalPresenceTerm, getVoiceAccent, getVoiceAccentTerm, getVoiceAge, getVoiceAgeTerm, getVoiceArchetype, getVoiceArchetypeTerm, getVoiceEmotion, getVoiceEmotionTerm, getVoiceGender, getVoiceGenderTerm, getVoiceLanguage, getVoiceLanguageTerm, getVoicePace, getVoicePaceTerm, getVoiceTimbre, getVoiceTimbreTerm, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasUpstreamCharacter, identityRefsSentence, isAnalyzablePicker, isInstrumentalVocal, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinPromptParts, listPickerCatalogs, migratePersonValue, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderStructuredFields, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, 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_DURATIONS, CHARACTER_FX_IDS, CHARACTER_FX_INTENSITIES, CHARACTER_FX_POSITIONS, 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, DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, 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_HINT_MODE_DEFAULT, IMAGE_REFERENCE_PROMPT_DOCTRINE, 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, MAX_SUBJECT_KEYS, 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, NODE_PROMPT_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, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, PROMPT_HINT_SEPARATOR, 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, SUBJECT_ARRAY_CEILING, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_FIELDS, SUBJECT_FOLD_KEYS, SUBJECT_ID_MAX_CHARS, SUBJECT_IMAGE_HINT_MODE_DEFAULT, SUBJECT_KEYS, SUBJECT_KEY_MAX_CHARS, SUBJECT_VIDEO_HINT_MODE_DEFAULT, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TERM_MAX_CHARS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_DURATIONS, TRANSITION_IDS, TRANSITION_INTENSITIES, TRANSITION_POSITIONS, VIDEO_HINT_MODE_DEFAULT, 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, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildImagePromptWithOverflow, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeNegative, composePickerCatalogs, composeSoundHintFromConnections, composeTransitionHintFromConnections, composeVideoPromptText, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, deriveTerm, directionFieldsForSurface, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAestheticTerm, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getAtmosphereTerm, getBackdrop, getBackdropLabel, getBackdropPromptHint, getBackdropTerm, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraFormatTerm, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCameraMotionTerm, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getCharacterFxTerm, getColorLook, getColorLookLabel, getColorLookPromptHint, getColorLookTerm, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getCompositionEffectTerm, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getEraTerm, getExposure, getExposureLabel, getExposurePromptHint, getExposureTerm, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getFramingTerm, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getHeldPropTerm, getIdentityLockClause, getInstrument, getInstrumentTerm, getLens, getLensLabel, getLensPromptHint, getLensTerm, getLighting, getLightingLabel, getLightingPromptHint, getLightingTerm, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getLoopSubjectTerm, getMaterial, getMaterialLabel, getMaterialPromptHint, getMaterialTerm, getMood, getMoodLabel, getMoodPromptHint, getMoodTerm, getMusicEmotion, getMusicEmotionTerm, getMusicEnergy, getMusicEnergyTerm, getMusicEra, getMusicEraTerm, getMusicGenre, getMusicGenreLabel, getMusicGenreTerm, getMusicSubgenre, getMusicSubgenreTerm, getMusicVibe, getMusicVibeTerm, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPersonTerm, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotoGenreTerm, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPhotographerTerm, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPoseTerm, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getPostProcessEffectTerm, getProductionStyle, getProductionStyleTerm, getPromptDoctrine, getPromptFields, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRegisteredSubjectKeys, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, getSnippetMedia, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyleTerm, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getStylingTerm, getTemporal, getTemporalLabel, getTemporalPromptHint, getTemporalTerm, getTransition, getTransitionLabel, getTransitionPromptHint, getTransitionTerm, getVocalPresence, getVocalPresenceTerm, getVoiceAccent, getVoiceAccentTerm, getVoiceAge, getVoiceAgeTerm, getVoiceArchetype, getVoiceArchetypeTerm, getVoiceEmotion, getVoiceEmotionTerm, getVoiceGender, getVoiceGenderTerm, getVoiceLanguage, getVoiceLanguageTerm, getVoicePace, getVoicePaceTerm, getVoiceTimbre, getVoiceTimbreTerm, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasUpstreamCharacter, identityRefsSentence, isAnalyzablePicker, isInstrumentalVocal, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinPromptHints, joinPromptParts, keepableDirectionHints, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, normalizeSubjectFields, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, readSubjectFields, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDirectionHints, renderStructuredFields, renderSubjectHints, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, subjectFieldsForSurface, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map