@nodaro/prompts 1.11.0 → 1.13.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, knownImageSlugsFromRefs, findImageMentionTokens, 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, imageMentionSlugForRef, 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(
@@ -10212,6 +10215,218 @@ function applyTemplate(template, vars) {
     template
   );
 }
+
+// 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/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", styleGroup: "film", 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", styleGroup: "film", 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", styleGroup: "film", 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", styleGroup: "film", 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", styleGroup: "film", maxPicks: 1, render: perId(getCameraFormatPromptHint, getCameraFormatTerm) }
+];
+var DIRECTION_SPECS = DIRECTION_FIELDS;
+var DIRECTION_KEYS = DIRECTION_FIELDS.map((f) => f.key);
+var FILM_STYLE_KEYS = DIRECTION_SPECS.filter(
+  (f) => f.styleGroup === "film"
+).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_SPECS.filter((f) => f.surface === "both" || f.surface === surface);
+}
+function renderDirectionHintClauses(direction, opts) {
+  if (!direction) return [];
+  const mode = opts.mode ?? "full";
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const spec of DIRECTION_SPECS) {
+    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({
+          key: spec.key,
+          family: spec.family,
+          ...spec.styleGroup !== void 0 ? { styleGroup: spec.styleGroup } : {},
+          text: hint
+        });
+      }
+    }
+  }
+  return out;
+}
+function renderDirectionHints(direction, opts) {
+  return renderDirectionHintClauses(direction, opts).map((c) => c.text);
+}
+
+// src/prompt-style-section.ts
+var STYLE_SECTION_HEADER = "[style]:";
+var STYLE_SECTION_GAP = "\n\n";
+var STYLE_SECTION_OPENING = `${STYLE_SECTION_GAP}${STYLE_SECTION_HEADER}
+`;
+function splitStyleSection(prompt) {
+  const at = prompt.lastIndexOf(STYLE_SECTION_OPENING);
+  if (at >= 0) {
+    return { body: prompt.slice(0, at), section: prompt.slice(at + STYLE_SECTION_GAP.length) };
+  }
+  return prompt.startsWith(`${STYLE_SECTION_HEADER}
+`) ? { body: "", section: prompt } : { body: prompt, section: "" };
+}
+function insertBeforeStyleSection(prompt, lines) {
+  if (lines.length === 0) return prompt;
+  const block = lines.join("\n");
+  const { body, section } = splitStyleSection(prompt);
+  if (section.length === 0) return `${prompt}
+${block}`;
+  return `${body.length > 0 ? `${body}
+${block}` : block}${STYLE_SECTION_GAP}${section}`;
+}
+function endsInsideStyleSection(prompt) {
+  const at = prompt.lastIndexOf(STYLE_SECTION_GAP);
+  const lastBlock = at >= 0 ? prompt.slice(at + STYLE_SECTION_GAP.length) : prompt;
+  return lastBlock.startsWith(`${STYLE_SECTION_HEADER}
+`);
+}
+function styleSlotFor(row) {
+  if (row.family === "motion") return "body";
+  return row.styleGroup === "film" ? "film" : "scene";
+}
+function asBodyClauses(texts) {
+  return texts.map((text) => ({ text, slot: "body" }));
+}
+function partitionStyleClauses(direction, opts) {
+  return renderDirectionHintClauses(direction, opts).map((clause) => ({
+    text: clause.text,
+    slot: styleSlotFor(clause)
+  }));
+}
+function styleSectionFromClauses(clauses) {
+  const line = (slot) => clauses.filter((c) => c.slot === slot).map((c) => c.text).join(PROMPT_HINT_SEPARATOR);
+  const lines = [line("film"), line("scene")].filter((l) => l.length > 0);
+  return lines.length === 0 ? "" : `${STYLE_SECTION_HEADER}
+${lines.join("\n")}`;
+}
+function renderStyleSection(direction, opts) {
+  return styleSectionFromClauses(partitionStyleClauses(direction, opts));
+}
+function composeSectionedPrompt(userPrompt, clauses, structuredFragment) {
+  const bodyHints = [
+    ...clauses.filter((c) => c.slot === "body").map((c) => c.text),
+    structuredFragment
+  ].filter((p) => p.length > 0);
+  const section = styleSectionFromClauses(clauses);
+  if (section.length === 0) {
+    return bodyHints.length === 0 ? userPrompt : joinPromptHints(userPrompt ?? "", bodyHints);
+  }
+  const body = bodyHints.length > 0 ? joinPromptHints(userPrompt ?? "", bodyHints) : (userPrompt ?? "").trim();
+  return body.length > 0 ? `${body}${STYLE_SECTION_GAP}${section}` : section;
+}
+function sectionedClauseCosts(userPrompt, clauses, structuredFragment) {
+  const lengthAt = (kept) => composeSectionedPrompt(userPrompt, clauses.slice(0, kept), structuredFragment)?.length ?? 0;
+  const costs = [];
+  let below = lengthAt(0);
+  for (let i = 0; i < clauses.length; i++) {
+    const at = lengthAt(i + 1);
+    costs.push(at - below);
+    below = at;
+  }
+  return costs;
+}
 function composeIdentityDescPart(subject, canonicalDesc, elementInjection) {
   const parts = [];
   const c = canonicalDesc?.trim();
@@ -10282,6 +10497,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 +10540,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 +10571,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 +10667,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 +10681,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 = [];
@@ -10506,7 +10730,7 @@ function resolveImageMentionsHybrid(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 = [];
@@ -10524,6 +10748,60 @@ function resolveImageMentionsHybrid(prompt, tokens, refs, existingUrls) {
   }
   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 = [];
@@ -10682,7 +10960,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();
@@ -10838,9 +11116,29 @@ function reconcileBodySegments(body, bodySegments) {
   }
   return [{ text: body, origin: "user" }];
 }
+function controlSuffixes(body, styleLine, avoidLine) {
+  const separator = (text) => endsInsideStyleSection(text) ? STYLE_SECTION_GAP : "\n";
+  const styleSuffix = styleLine ? `${separator(body)}${styleLine}` : "";
+  const avoidSuffix = avoidLine ? `${separator(body + styleSuffix)}${avoidLine}` : "";
+  return { styleSuffix, avoidSuffix };
+}
 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,
@@ -10862,6 +11160,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,
@@ -10908,7 +11207,9 @@ function buildImagePromptInternal(config2, marks) {
     );
     const knownImageSlugs = knownImageSlugsFromRefs(connectedReferences);
     const hasImageMentionTokens = isHybrid && knownImageSlugs.length > 0 && findImageMentionTokens(config2.prompt, knownImageSlugs).length > 0;
-    if (knownCharacterSlugs.length > 0 || hasExtraRefs || knownLocationSlugs.length > 0 || hasImageMentionTokens) {
+    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 = [];
@@ -10980,6 +11281,25 @@ function buildImagePromptInternal(config2, marks) {
           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
@@ -11061,6 +11381,7 @@ ${promptForNext}`;
           ...hybridLockLines,
           ...hybridLocationLockLines,
           ...hybridImageLockLines,
+          ...hybridEntityLockLines,
           ...canonical.lockLines,
           ...extrasRendered.lockLines
         ])];
@@ -11068,6 +11389,7 @@ ${promptForNext}`;
           ...hybridElementDirectives,
           ...hybridLocationElementDirectives,
           ...hybridImageElementDirectives,
+          ...hybridEntityElementDirectives,
           ...canonical.phrases,
           ...canonical.elementDirectives,
           ...extrasRendered.bodyLines,
@@ -11076,9 +11398,7 @@ ${promptForNext}`;
         const lockBlock = allLockLines.length > 0 ? `${allLockLines.join("\n")}
 
 ` : "";
-        const trailingBlock = trailingLines.length > 0 ? `
-${trailingLines.join("\n")}` : "";
-        promptForNext = `${lockBlock}${promptForNext}${trailingBlock}`;
+        promptForNext = `${lockBlock}${insertBeforeStyleSection(promptForNext, trailingLines)}`;
       }
       config2 = {
         ...config2,
@@ -11114,7 +11434,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")}
 
@@ -11125,9 +11446,7 @@ ${trailingLines.join("\n")}` : "";
         ...locCanon.elementDirectives,
         ...objCanon.elementDirectives
       ];
-      const canonTrailingBlock = canonTrailingLines.length > 0 ? `
-${canonTrailingLines.join("\n")}` : "";
-      const composedScene = `${canonLockBlock}${scene}${canonTrailingBlock}`;
+      const composedScene = `${canonLockBlock}${insertBeforeStyleSection(scene, canonTrailingLines)}`;
       prompt2 = config2.referenceLockSnippet ? `${config2.referenceLockSnippet}
 ${composedScene}` : composedScene;
       if (marks) marks.directivesPrefix = "";
@@ -11153,31 +11472,33 @@ ${directives}`;
       }
     }
     const styleText2 = style?.trim();
-    const styleSuffix2 = styleText2 ? `
-Style: ${getStylePromptHint(styleText2) || styleText2}` : "";
+    const styleLine2 = styleText2 ? `Style: ${getStylePromptHint(styleText2) || styleText2}` : "";
     const negPrompt2 = negativePrompt?.trim();
     let nativeNegativePrompt2;
-    let avoidSuffix2 = "";
+    let avoidLine2 = "";
     if (negPrompt2) {
       if (NATIVE_NEGATIVE_PROMPT_MODELS.has(provider)) {
         nativeNegativePrompt2 = negPrompt2.slice(0, getMaxNegativePromptChars(provider));
       } else {
-        avoidSuffix2 = `
-Avoid: ${negPrompt2}`;
+        avoidLine2 = `Avoid: ${negPrompt2}`;
       }
     }
-    if (marks) {
-      marks.styleSuffix = styleSuffix2;
-      marks.avoidSuffix = avoidSuffix2;
-    }
     const maxLen2 = getMaxImagePromptChars(provider);
-    const reserved2 = styleSuffix2.length + avoidSuffix2.length;
+    const preCut2 = controlSuffixes(prompt2, styleLine2, avoidLine2);
+    const reserved2 = preCut2.styleSuffix.length + preCut2.avoidSuffix.length;
     if (prompt2.length + reserved2 > maxLen2) {
+      if (marks) marks.overflowChars += prompt2.length + reserved2 - maxLen2;
       prompt2 = prompt2.slice(0, Math.max(0, maxLen2 - reserved2 - 3)) + "...";
     }
+    const { styleSuffix: styleSuffix2, avoidSuffix: avoidSuffix2 } = controlSuffixes(prompt2, styleLine2, avoidLine2);
+    if (marks) {
+      marks.styleSuffix = styleSuffix2;
+      marks.avoidSuffix = avoidSuffix2;
+    }
     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) {
@@ -11225,37 +11546,41 @@ Avoid: ${negPrompt2}`;
   let prompt = config2.prompt;
   if (charDescs.length > 0) {
     const wrapperTemplate = resolveTemplate("generate-image-wrapper", userTemplates, flowTemplates);
-    prompt = applyTemplate(wrapperTemplate, {
-      userPrompt: prompt,
+    const { body, section } = splitStyleSection(prompt);
+    const wrapped = applyTemplate(wrapperTemplate, {
+      userPrompt: body,
       assetDescriptions: charDescs.join(" ")
     });
+    prompt = section.length > 0 ? `${wrapped}${STYLE_SECTION_GAP}${section}` : wrapped;
   }
   const styleText = style?.trim();
-  const styleSuffix = styleText ? `
-Style: ${getStylePromptHint(styleText) || styleText}` : "";
+  const styleLine = styleText ? `Style: ${getStylePromptHint(styleText) || styleText}` : "";
   const negPrompt = negativePrompt?.trim();
   let nativeNegativePrompt;
-  let avoidSuffix = "";
+  let avoidLine = "";
   if (negPrompt) {
     if (NATIVE_NEGATIVE_PROMPT_MODELS.has(provider)) {
       nativeNegativePrompt = negPrompt.slice(0, getMaxNegativePromptChars(provider));
     } else {
-      avoidSuffix = `
-Avoid: ${negPrompt}`;
+      avoidLine = `Avoid: ${negPrompt}`;
     }
   }
-  if (marks) {
-    marks.styleSuffix = styleSuffix;
-    marks.avoidSuffix = avoidSuffix;
-  }
   const maxLen = getMaxImagePromptChars(provider);
-  const reserved = styleSuffix.length + avoidSuffix.length;
+  const preCut = controlSuffixes(prompt, styleLine, avoidLine);
+  const reserved = preCut.styleSuffix.length + preCut.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)) + "...";
   }
+  const { styleSuffix, avoidSuffix } = controlSuffixes(prompt, styleLine, avoidLine);
+  if (marks) {
+    marks.styleSuffix = styleSuffix;
+    marks.avoidSuffix = avoidSuffix;
+  }
   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;
@@ -11265,12 +11590,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" }] : [],
@@ -11460,19 +11780,35 @@ 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());
 }
 function buildHybridScene(prompt, refs, finalIndexByUrl) {
-  return prompt.split("\n").map((line) => capitalizeLineInitial(expandImageRefTokensHybrid(line, refs, finalIndexByUrl))).join("\n");
+  const lines = prompt.split("\n");
+  const sectionAt = lines.indexOf(STYLE_SECTION_HEADER);
+  return lines.map((line, i) => {
+    const expanded = expandImageRefTokensHybrid(line, refs, finalIndexByUrl);
+    return sectionAt >= 0 && i >= sectionAt ? expanded : capitalizeLineInitial(expanded);
+  }).join("\n");
 }
 function buildIdentityDirectives(prompt, refs, meta3 = [], suppressedCanonicalLocationIds) {
   return collectIdentities(prompt, refs, meta3).map((id) => buildIdentityDirective(id, suppressedCanonicalLocationIds)).filter((s) => s.length > 0).join("\n");
@@ -11690,9 +12026,16 @@ function renderLens(l) {
   if (l.aperture) bits.push(`f/${l.aperture}`);
   return bits.length > 0 ? `Lens: ${bits.join(", ")}.` : "";
 }
-
-// src/direction-registry.ts
-var perId = (full, compact) => (ids, mode) => {
+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);
@@ -11700,80 +12043,45 @@ var perId = (full, compact) => (ids, mode) => {
   }
   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 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 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 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 DIRECTION_ARRAY_CEILING = 8;
-var DIRECTION_ID_MAX_CHARS = 100;
-function normalizeDirectionIds(value, maxPicks) {
+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);
@@ -11785,22 +12093,54 @@ function normalizeDirectionIds(value, maxPicks) {
   }
   return ids.slice(0, maxPicks);
 }
-function directionFieldsForSurface(surface) {
-  return DIRECTION_FIELDS.filter((f) => f.surface === "both" || f.surface === surface);
+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 renderDirectionHints(direction, opts) {
-  if (!direction) return [];
+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 DIRECTION_FIELDS) {
+  for (const spec of SUBJECT_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))) {
+    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);
@@ -11810,11 +12150,15 @@ function renderDirectionHints(direction, opts) {
   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, clauseCosts) {
+  let remaining = deficit;
+  let next = kept;
+  while (next > 0 && remaining > 0) {
+    next -= 1;
+    remaining -= clauseCosts?.[next] ?? hintClauses[next].length + PROMPT_HINT_SEPARATOR.length;
+  }
+  return next;
 }
 
 // src/ref-binding.ts
@@ -12166,9 +12510,7 @@ function resolveVideoReferenceCore(args) {
     const lockBlock = lockLines.length > 0 ? `${lockLines.join("\n")}
 
 ` : "";
-    const trailingBlock = trailingLines.length > 0 ? `
-${trailingLines.join("\n")}` : "";
-    finalPrompt = `${lockBlock}${finalPrompt}${trailingBlock}`;
+    finalPrompt = `${lockBlock}${insertBeforeStyleSection(finalPrompt, trailingLines)}`;
   } else {
     const allFallbackLines = [...fallbackDirectiveLines, ...extraDirectiveLines];
     if (allFallbackLines.length > 0) {
@@ -12402,17 +12744,34 @@ function assembleSunoInput(input) {
 }
 
 // src/assemble-image-input.ts
-function composePromptText(userPrompt, direction, structured) {
-  const hints = [
-    ...renderDirectionHints(direction, { surface: "image", mode: IMAGE_HINT_MODE_DEFAULT }),
-    structured ? renderStructuredFields(structured) : ""
-  ].filter((p) => p.length > 0);
-  return joinPromptHints(userPrompt, hints);
+function renderImageHintPieces(subject, direction, structured) {
+  return {
+    hintClauses: [
+      ...asBodyClauses(
+        renderSubjectHints(subject, {
+          surface: "image",
+          mode: SUBJECT_IMAGE_HINT_MODE_DEFAULT
+        })
+      ),
+      ...partitionStyleClauses(direction, {
+        surface: "image",
+        mode: IMAGE_HINT_MODE_DEFAULT
+      })
+    ].filter((c) => c.text.length > 0),
+    structuredFragment: structured ? renderStructuredFields(structured) : ""
+  };
+}
+function composePromptText(userPrompt, pieces, keptHintClauses) {
+  return composeSectionedPrompt(
+    userPrompt,
+    pieces.hintClauses.slice(0, keptHintClauses),
+    pieces.structuredFragment
+  );
 }
 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
@@ -12435,6 +12794,21 @@ 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);
+  if (fitted.overflowChars > 0) {
+    const costs = sectionedClauseCosts(
+      input.userPrompt,
+      pieces.hintClauses,
+      pieces.structuredFragment
+    );
+    const texts = pieces.hintClauses.map((c) => c.text);
+    while (fitted.overflowChars > 0 && kept > 0) {
+      kept = keepableDirectionHints(texts, kept, fitted.overflowChars, costs);
+      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"
@@ -12445,15 +12819,35 @@ function assembleImageInput(input) {
 
 // src/assemble-video-input.ts
 function composeVideoPromptText(userPrompt, direction, structured, opts) {
-  const hints = [
-    ...renderDirectionHints(direction, {
+  const hintClauses = [
+    ...asBodyClauses(
+      renderSubjectHints(opts?.subject, {
+        surface: "video",
+        mode: opts?.subjectHintMode ?? SUBJECT_VIDEO_HINT_MODE_DEFAULT
+      })
+    ),
+    ...partitionStyleClauses(direction, {
       surface: "video",
       mode: opts?.hintMode ?? VIDEO_HINT_MODE_DEFAULT
-    }),
-    structured ? renderStructuredFields(structured) : ""
-  ].filter((p) => p.length > 0);
-  if (hints.length === 0) return userPrompt;
-  return joinPromptHints(userPrompt ?? "", hints);
+    })
+  ].filter((c) => c.text.length > 0);
+  const structuredFragment = structured ? renderStructuredFields(structured) : "";
+  const composeWith = (kept2) => composeSectionedPrompt(userPrompt, hintClauses.slice(0, kept2), structuredFragment);
+  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;
+  if (framedLength <= cap) return body;
+  const costs = sectionedClauseCosts(userPrompt, hintClauses, structuredFragment);
+  const texts = hintClauses.map((c) => c.text);
+  while (framedLength > cap && kept > 0) {
+    kept = keepableDirectionHints(texts, kept, framedLength - cap, costs);
+    body = composeWith(kept);
+    framedLength = frame(body)?.length ?? 0;
+  }
+  return body;
 }
 
 // src/read-node-direction.ts
@@ -12478,6 +12872,31 @@ function readDirectionFields(value) {
   }
   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 = {
@@ -33742,6 +34161,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, 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, 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, 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, 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, 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, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDirectionHints, 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, FILM_STYLE_KEYS, 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, STYLE_SECTION_GAP, STYLE_SECTION_HEADER, 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, asBodyClauses, 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, composeSectionedPrompt, composeSoundHintFromConnections, composeTransitionHintFromConnections, composeVideoPromptText, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, deriveTerm, directionFieldsForSurface, endsInsideStyleSection, 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, insertBeforeStyleSection, isAnalyzablePicker, isInstrumentalVocal, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinPromptHints, joinPromptParts, keepableDirectionHints, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, normalizeSubjectFields, partitionStyleClauses, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, readSubjectFields, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDirectionHintClauses, renderDirectionHints, renderStructuredFields, renderStyleSection, renderSubjectHints, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, sectionedClauseCosts, splitStyleSection, styleSectionFromClauses, styleSlotFor, subjectFieldsForSurface, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map