@nodaro/prompts 1.10.0 → 1.12.0

package/dist/index.cjs

@@ -9241,7 +9241,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
@@ -9573,7 +9573,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "dog-golden-retriever",
     categoryOrder: shared.ANIMAL_SUBCATEGORY_ORDER,
     categoryLabels: shared.ANIMAL_SUBCATEGORY_LABELS,
-    options: objectOptions(shared.ANIMALS, (label, description) => `featuring a ${label}, ${description}`)
+    options: objectOptions(shared.ANIMALS, (e) => shared.getAnimalPromptHint(e.id))
   },
   {
     nodeType: "vehicle",
@@ -9584,7 +9584,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "sedan",
     categoryOrder: shared.VEHICLE_SUBCATEGORY_ORDER,
     categoryLabels: shared.VEHICLE_SUBCATEGORY_LABELS,
-    options: objectOptions(shared.VEHICLES, (label, description) => `featuring a ${label}, ${description}`)
+    options: objectOptions(shared.VEHICLES, (e) => `featuring a ${e.label.toLowerCase()}, ${e.description}`)
   },
   {
     nodeType: "weapon",
@@ -9595,7 +9595,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "katana",
     categoryOrder: shared.WEAPON_SUBCATEGORY_ORDER,
     categoryLabels: shared.WEAPON_SUBCATEGORY_LABELS,
-    options: objectOptions(shared.WEAPONS, (label, description) => `with a ${label}, ${description}`)
+    options: objectOptions(shared.WEAPONS, (e) => `with a ${e.label.toLowerCase()}, ${e.description}`)
   },
   {
     nodeType: "furniture",
@@ -9606,7 +9606,7 @@ var SINGLE_CATALOGS = [
     defaultValue: "sofa",
     categoryOrder: shared.FURNITURE_SUBCATEGORY_ORDER,
     categoryLabels: shared.FURNITURE_SUBCATEGORY_LABELS,
-    options: objectOptions(shared.FURNITURE, (label, description) => `including a ${label}, ${description}`)
+    options: objectOptions(shared.FURNITURE, (e) => `including a ${e.label.toLowerCase()}, ${e.description}`)
   },
   {
     nodeType: "held-prop",
@@ -9974,13 +9974,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 = shared.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, shared.getAnimalPromptHint, shared.getAnimalTerm)(asStr(data.animal))
       );
-    }
     case "vehicle": {
       const vehicle = shared.getVehicle(asStr(data.vehicle));
       return withCustomText(
@@ -10284,6 +10287,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();
@@ -10322,7 +10330,7 @@ function resolveCharacterMentionsHybrid(prompt, tokens, refs, existingUrls) {
   let resolvedPrompt = prompt;
   for (const m of [...matched].sort((a, b) => b.offset - a.offset)) {
     const phrase = shared.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 = [];
@@ -10353,16 +10361,21 @@ function locationModeDirective(mode) {
   }
 }
 function locationModeToRole(mode) {
-  switch (mode) {
-    case "identical":
-      return "background";
-    case "style":
-      return "style";
-    case "layout":
-      return "layout";
-    default:
-      return shared.defaultRoleForSource("wired-location");
-  }
+  return roleBearingLocationMode(mode) ?? shared.defaultRoleForSource("wired-location");
+}
+function roleBearingLocationMode(mode) {
+  const m = mode?.trim();
+  if (!m) return null;
+  return shared.REFERENCE_ROLE_PRESETS["wired-location"].includes(m) ? m : null;
+}
+function resolveLocationRole(tokenRole, tokenUsageMode, ref) {
+  const explicitRole = tokenRole?.trim();
+  if (explicitRole) return shared.normalizeRoleSlug(explicitRole);
+  const modeRole = roleBearingLocationMode(tokenUsageMode);
+  if (modeRole) return modeRole;
+  const nodeRole = ref.defaultRole?.trim();
+  if (nodeRole) return shared.normalizeRoleSlug(nodeRole);
+  return locationModeToRole(ref.defaultUsageMode ?? shared.DEFAULT_LOCATION_USAGE_MODE);
 }
 function resolveLocationMentions(prompt, tokens, refs) {
   const bySlug = /* @__PURE__ */ new Map();
@@ -10444,8 +10457,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 ?? shared.DEFAULT_LOCATION_USAGE_MODE;
-    const role = t.role ? shared.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();
@@ -10459,7 +10471,7 @@ function resolveLocationMentionsHybrid(prompt, tokens, refs, existingUrls) {
   let resolvedPrompt = prompt;
   for (const m of [...matched].sort((a, b) => b.offset - a.offset)) {
     const phrase = shared.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 = [];
@@ -10477,6 +10489,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 = shared.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() || shared.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 = shared.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 = shared.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() || shared.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 = shared.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 = [];
@@ -10635,7 +10750,7 @@ function renderLocationCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, covere
     if (!slot) continue;
     seenUrls.add(r.url);
     const binding = `reference image ${slotToLetter(slot)}`;
-    phrases.push(shared.roleToPhrase(locationModeToRole(r.defaultUsageMode), binding));
+    phrases.push(shared.roleToPhrase(resolveLocationRole(null, null, r), binding));
     const lock = buildIdentityLockLine(r, binding);
     if (lock) lockLines.push(lock);
     const inject = r.elementInjection?.trim();
@@ -10794,6 +10909,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,
@@ -10815,6 +10944,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,
@@ -10859,7 +10989,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 = shared.knownImageSlugsFromRefs(connectedReferences);
+    const hasImageMentionTokens = isHybrid && knownImageSlugs.length > 0 && shared.findImageMentionTokens(config2.prompt, knownImageSlugs).length > 0;
+    const knownEntitySlugs = shared.knownEntitySlugsFromRefs(connectedReferences);
+    const hasEntityMentionTokens = isHybrid && knownEntitySlugs.length > 0 && shared.findEntityMentionTokens(config2.prompt, knownEntitySlugs).length > 0;
+    if (knownCharacterSlugs.length > 0 || hasExtraRefs || knownLocationSlugs.length > 0 || hasImageMentionTokens || hasEntityMentionTokens) {
       const mentionTokens = knownCharacterSlugs.length > 0 ? shared.findCharacterMentionTokens(config2.prompt, knownCharacterSlugs) : [];
       let hybridLockLines = [];
       let hybridElementDirectives = [];
@@ -10913,6 +11047,43 @@ function buildImagePromptInternal(config2, marks) {
         if (r.locationVariantBucket) return false;
         return !mentionedLocationSlugs.has(r.locationSlug);
       });
+      let hybridImageLockLines = [];
+      let hybridImageElementDirectives = [];
+      if (hasImageMentionTokens) {
+        const imageTokens = shared.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 = shared.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
@@ -10993,12 +11164,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,
@@ -11045,7 +11220,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")}
 
@@ -11104,11 +11280,13 @@ Avoid: ${negPrompt2}`;
     const maxLen2 = shared.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) {
@@ -11182,11 +11360,13 @@ Avoid: ${negPrompt}`;
   const maxLen = shared.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;
@@ -11196,12 +11376,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" }] : [],
@@ -11391,13 +11566,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());
@@ -11622,6 +11808,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(shared.getAnimalPromptHint, shared.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.`;
@@ -12207,22 +12653,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
@@ -12245,6 +12701,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"
@@ -12252,6 +12715,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;
@@ -33268,8 +33877,8 @@ var SINGLE_PICKER_WIRING = [
   { kind: "single", nodeType: "furniture", label: "Furniture", valueField: "furniture", defaultValue: "sofa", catalogId: "furniture", entries: mapCat(shared.FURNITURE, "subcategory"), groupOrder: shared.FURNITURE_SUBCATEGORY_ORDER, groupLabels: shared.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",
@@ -33305,7 +33914,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)
@@ -33314,7 +33923,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)
@@ -33496,6 +34105,10 @@ exports.COMPOSITION_EFFECTS = COMPOSITION_EFFECTS;
 exports.COMPOSITION_EFFECT_IDS = COMPOSITION_EFFECT_IDS;
 exports.DEFAULT_IDENTITY_LOCK = DEFAULT_IDENTITY_LOCK;
 exports.DEFAULT_TEMPLATES = DEFAULT_TEMPLATES;
+exports.DIRECTION_ARRAY_CEILING = DIRECTION_ARRAY_CEILING;
+exports.DIRECTION_FIELDS = DIRECTION_FIELDS;
+exports.DIRECTION_ID_MAX_CHARS = DIRECTION_ID_MAX_CHARS;
+exports.DIRECTION_KEYS = DIRECTION_KEYS;
 exports.ERAS = ERAS;
 exports.ERA_CATEGORY_LABELS = ERA_CATEGORY_LABELS;
 exports.ERA_CATEGORY_ORDER = ERA_CATEGORY_ORDER;
@@ -33518,6 +34131,7 @@ exports.HELD_PROPS = HELD_PROPS;
 exports.HELD_PROP_CATEGORY_LABELS = HELD_PROP_CATEGORY_LABELS;
 exports.HELD_PROP_CATEGORY_ORDER = HELD_PROP_CATEGORY_ORDER;
 exports.HELD_PROP_IDS = HELD_PROP_IDS;
+exports.IMAGE_HINT_MODE_DEFAULT = IMAGE_HINT_MODE_DEFAULT;
 exports.IMAGE_REFERENCE_PROMPT_DOCTRINE = IMAGE_REFERENCE_PROMPT_DOCTRINE;
 exports.IMAGE_WIZARD_CATEGORIES = IMAGE_WIZARD_CATEGORIES;
 exports.INSTRUMENTATION_DEFAULT_DATA = INSTRUMENTATION_DEFAULT_DATA;
@@ -33542,6 +34156,7 @@ exports.MATERIAL_IDS = MATERIAL_IDS;
 exports.MAX_SELECTED_BY_DIMENSION = MAX_SELECTED_BY_DIMENSION;
 exports.MAX_SELECTED_BY_FRAMING_CATEGORY = MAX_SELECTED_BY_FRAMING_CATEGORY;
 exports.MAX_SELECTED_BY_STYLING_DIMENSION = MAX_SELECTED_BY_STYLING_DIMENSION;
+exports.MAX_SUBJECT_KEYS = MAX_SUBJECT_KEYS;
 exports.MOODS = MOODS;
 exports.MOOD_CATEGORY_LABELS = MOOD_CATEGORY_LABELS;
 exports.MOOD_CATEGORY_ORDER = MOOD_CATEGORY_ORDER;
@@ -33595,6 +34210,7 @@ exports.POST_PROCESS_EFFECT_IDS = POST_PROCESS_EFFECT_IDS;
 exports.PRODUCTION_STYLES = PRODUCTION_STYLES;
 exports.PROMPT_AFFIX_CORE_FIELD_OVERRIDES = PROMPT_AFFIX_CORE_FIELD_OVERRIDES;
 exports.PROMPT_AFFIX_NODE_TYPES = PROMPT_AFFIX_NODE_TYPES;
+exports.PROMPT_HINT_SEPARATOR = PROMPT_HINT_SEPARATOR;
 exports.PROVIDER_CAPABILITIES = PROVIDER_CAPABILITIES;
 exports.PROVIDER_PROMPT_DOCTRINES = PROVIDER_PROMPT_DOCTRINES;
 exports.REFERENCE_IMAGE_ROLES = REFERENCE_IMAGE_ROLES;
@@ -33620,6 +34236,15 @@ exports.STYLING_DIMENSION_LABELS = STYLING_DIMENSION_LABELS;
 exports.STYLING_DIMENSION_ORDER = STYLING_DIMENSION_ORDER;
 exports.STYLING_FIELD_BY_DIMENSION = STYLING_FIELD_BY_DIMENSION;
 exports.STYLING_IDS = STYLING_IDS;
+exports.SUBJECT_ARRAY_CEILING = SUBJECT_ARRAY_CEILING;
+exports.SUBJECT_CUSTOM_AGE_KEY = SUBJECT_CUSTOM_AGE_KEY;
+exports.SUBJECT_FIELDS = SUBJECT_FIELDS;
+exports.SUBJECT_FOLD_KEYS = SUBJECT_FOLD_KEYS;
+exports.SUBJECT_ID_MAX_CHARS = SUBJECT_ID_MAX_CHARS;
+exports.SUBJECT_IMAGE_HINT_MODE_DEFAULT = SUBJECT_IMAGE_HINT_MODE_DEFAULT;
+exports.SUBJECT_KEYS = SUBJECT_KEYS;
+exports.SUBJECT_KEY_MAX_CHARS = SUBJECT_KEY_MAX_CHARS;
+exports.SUBJECT_VIDEO_HINT_MODE_DEFAULT = SUBJECT_VIDEO_HINT_MODE_DEFAULT;
 exports.TEMPORALS = TEMPORALS;
 exports.TEMPORAL_CATEGORY_LABELS = TEMPORAL_CATEGORY_LABELS;
 exports.TEMPORAL_CATEGORY_ORDER = TEMPORAL_CATEGORY_ORDER;
@@ -33634,6 +34259,7 @@ exports.TRANSITION_DURATIONS = TRANSITION_DURATIONS;
 exports.TRANSITION_IDS = TRANSITION_IDS;
 exports.TRANSITION_INTENSITIES = TRANSITION_INTENSITIES;
 exports.TRANSITION_POSITIONS = TRANSITION_POSITIONS;
+exports.VIDEO_HINT_MODE_DEFAULT = VIDEO_HINT_MODE_DEFAULT;
 exports.VIDEO_WIZARD_CATEGORIES = VIDEO_WIZARD_CATEGORIES;
 exports.VOCAL_PRESENCE = VOCAL_PRESENCE;
 exports.VOCAL_PRESENCE_INSTRUMENTAL_ID = VOCAL_PRESENCE_INSTRUMENTAL_ID;
@@ -33679,6 +34305,7 @@ exports.buildIdentityDirectives = buildIdentityDirectives;
 exports.buildIdentityLockLine = buildIdentityLockLine;
 exports.buildImagePrompt = buildImagePrompt;
 exports.buildImagePromptSegments = buildImagePromptSegments;
+exports.buildImagePromptWithOverflow = buildImagePromptWithOverflow;
 exports.buildInstrumentationHints = buildInstrumentationHints;
 exports.buildInstrumentationTerms = buildInstrumentationTerms;
 exports.buildLightingHints = buildLightingHints;
@@ -33731,10 +34358,12 @@ exports.composeNegative = composeNegative;
 exports.composePickerCatalogs = composePickerCatalogs;
 exports.composeSoundHintFromConnections = composeSoundHintFromConnections;
 exports.composeTransitionHintFromConnections = composeTransitionHintFromConnections;
+exports.composeVideoPromptText = composeVideoPromptText;
 exports.computeLlmChatFields = computeLlmChatFields;
 exports.computeNodePrompt = computeNodePrompt;
 exports.computePackSidecarCoverage = computePackSidecarCoverage;
 exports.deriveTerm = deriveTerm;
+exports.directionFieldsForSurface = directionFieldsForSurface;
 exports.expandImagePositionRefs = expandImagePositionRefs;
 exports.expandImageRefTokens = expandImageRefTokens;
 exports.filmStillPrefix = filmStillPrefix;
@@ -33867,6 +34496,7 @@ exports.getRegisteredPersonDimensionLabels = getRegisteredPersonDimensionLabels;
 exports.getRegisteredPersonDimensionOrder = getRegisteredPersonDimensionOrder;
 exports.getRegisteredPersonFieldByDimension = getRegisteredPersonFieldByDimension;
 exports.getRegisteredPickerCatalogs = getRegisteredPickerCatalogs;
+exports.getRegisteredSubjectKeys = getRegisteredSubjectKeys;
 exports.getRenderQuality = getRenderQuality;
 exports.getRenderQualityLabel = getRenderQualityLabel;
 exports.getRenderQualityPromptHint = getRenderQualityPromptHint;
@@ -33925,12 +34555,16 @@ exports.isInstrumentalVocal = isInstrumentalVocal;
 exports.isSuspiciousDerivedTerm = isSuspiciousDerivedTerm;
 exports.isVantageFraming = isVantageFraming;
 exports.isWizardSupported = isWizardSupported;
+exports.joinPromptHints = joinPromptHints;
 exports.joinPromptParts = joinPromptParts;
+exports.keepableDirectionHints = keepableDirectionHints;
 exports.listPickerCatalogs = listPickerCatalogs;
 exports.migratePersonValue = migratePersonValue;
+exports.modeForFamily = modeForFamily;
 exports.nodeHasInlinePrompt = nodeHasInlinePrompt;
 exports.nodeHasPromptField = nodeHasPromptField;
 exports.nodeSupportsPromptAffixes = nodeSupportsPromptAffixes;
+exports.normalizeSubjectFields = normalizeSubjectFields;
 exports.personPacksVersion = personPacksVersion;
 exports.pickerFanoutTargets = pickerFanoutTargets;
 exports.projectAllCatalogs = projectAllCatalogs;
@@ -33939,10 +34573,15 @@ exports.promptAffixCoreField = promptAffixCoreField;
 exports.promptBindsFirstFrame = promptBindsFirstFrame;
 exports.promptFieldCarriesAffixes = promptFieldCarriesAffixes;
 exports.promptPartSeparator = promptPartSeparator;
+exports.readDirectionFields = readDirectionFields;
+exports.readStructuredFields = readStructuredFields;
+exports.readSubjectFields = readSubjectFields;
 exports.referenceRulesBlock = referenceRulesBlock;
 exports.registerCatalogPack = registerCatalogPack;
 exports.registerPersonPack = registerPersonPack;
+exports.renderDirectionHints = renderDirectionHints;
 exports.renderStructuredFields = renderStructuredFields;
+exports.renderSubjectHints = renderSubjectHints;
 exports.resetCatalogPacks = resetCatalogPacks;
 exports.resetPersonPacks = resetPersonPacks;
 exports.resolveBrandInput = resolveBrandInput;
@@ -33957,6 +34596,7 @@ exports.resolveTemplate = resolveTemplate;
 exports.resolveTerm = resolveTerm;
 exports.resolveVeoI2vInputs = resolveVeoI2vInputs;
 exports.resolveVideoReferenceCore = resolveVideoReferenceCore;
+exports.subjectFieldsForSurface = subjectFieldsForSurface;
 exports.summarizePickerCatalogs = summarizePickerCatalogs;
 exports.toIdentityLockMode = toIdentityLockMode;
 exports.truncateForField = truncateForField;