@nodaro/prompts 1.12.0 → 1.13.0

package/dist/index.cjs

@@ -10217,6 +10217,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();
@@ -10906,6 +11118,12 @@ 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);
 }
@@ -11182,9 +11400,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,
@@ -11232,9 +11448,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 = "";
@@ -11260,29 +11474,29 @@ ${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 (shared.NATIVE_NEGATIVE_PROMPT_MODELS.has(provider)) {
         nativeNegativePrompt2 = negPrompt2.slice(0, shared.getMaxNegativePromptChars(provider));
       } else {
-        avoidSuffix2 = `
-Avoid: ${negPrompt2}`;
+        avoidLine2 = `Avoid: ${negPrompt2}`;
       }
     }
-    if (marks) {
-      marks.styleSuffix = styleSuffix2;
-      marks.avoidSuffix = avoidSuffix2;
-    }
     const maxLen2 = shared.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) {
@@ -11334,35 +11548,37 @@ 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 (shared.NATIVE_NEGATIVE_PROMPT_MODELS.has(provider)) {
       nativeNegativePrompt = negPrompt.slice(0, shared.getMaxNegativePromptChars(provider));
     } else {
-      avoidSuffix = `
-Avoid: ${negPrompt}`;
+      avoidLine = `Avoid: ${negPrompt}`;
     }
   }
-  if (marks) {
-    marks.styleSuffix = styleSuffix;
-    marks.avoidSuffix = avoidSuffix;
-  }
   const maxLen = shared.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) {
@@ -11589,7 +11805,12 @@ 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");
@@ -11807,125 +12028,6 @@ 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) => {
-  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] : [];
@@ -12050,20 +12152,13 @@ function renderSubjectHints(subject, 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) {
+function keepableDirectionHints(hintClauses, kept, deficit, clauseCosts) {
   let remaining = deficit;
   let next = kept;
   while (next > 0 && remaining > 0) {
     next -= 1;
-    remaining -= hintClauses[next].length + PROMPT_HINT_SEPARATOR.length;
+    remaining -= clauseCosts?.[next] ?? hintClauses[next].length + PROMPT_HINT_SEPARATOR.length;
   }
   return next;
 }
@@ -12417,9 +12512,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) {
@@ -12656,24 +12749,26 @@ function assembleSunoInput(input) {
 function renderImageHintPieces(subject, direction, structured) {
   return {
     hintClauses: [
-      ...renderSubjectHints(subject, {
-        surface: "image",
-        mode: SUBJECT_IMAGE_HINT_MODE_DEFAULT
-      }),
-      ...renderDirectionHints(direction, {
+      ...asBodyClauses(
+        renderSubjectHints(subject, {
+          surface: "image",
+          mode: SUBJECT_IMAGE_HINT_MODE_DEFAULT
+        })
+      ),
+      ...partitionStyleClauses(direction, {
         surface: "image",
         mode: IMAGE_HINT_MODE_DEFAULT
       })
-    ].filter((p) => p.length > 0),
+    ].filter((c) => c.text.length > 0),
     structuredFragment: structured ? renderStructuredFields(structured) : ""
   };
 }
 function composePromptText(userPrompt, pieces, keptHintClauses) {
-  const hints = [
-    ...pieces.hintClauses.slice(0, keptHintClauses),
+  return composeSectionedPrompt(
+    userPrompt,
+    pieces.hintClauses.slice(0, keptHintClauses),
     pieces.structuredFragment
-  ].filter((p) => p.length > 0);
-  return joinPromptHints(userPrompt, hints);
+  );
 }
 function assembleImageInput(input) {
   const pieces = renderImageHintPieces(input.subject, input.direction, input.structured);
@@ -12703,9 +12798,17 @@ function assembleImageInput(input) {
   });
   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);
+  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()) {
@@ -12719,31 +12822,30 @@ function assembleImageInput(input) {
 // 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, {
+    ...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
     })
-  ].filter((p) => p.length > 0);
+  ].filter((c) => c.text.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 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(hintClauses, kept, framedLength - cap);
+    kept = keepableDirectionHints(texts, kept, framedLength - cap, costs);
     body = composeWith(kept);
     framedLength = frame(body)?.length ?? 0;
   }
@@ -34121,6 +34223,7 @@ exports.EXPOSURE_SETTINGS = EXPOSURE_SETTINGS;
 exports.FACTORY_PRESETS = FACTORY_PRESETS;
 exports.FACTORY_SNIPPETS = FACTORY_SNIPPETS;
 exports.FILM_STILL_PREFIX = FILM_STILL_PREFIX;
+exports.FILM_STYLE_KEYS = FILM_STYLE_KEYS;
 exports.FRAMINGS = FRAMINGS;
 exports.FRAMING_CATEGORY_LABELS = FRAMING_CATEGORY_LABELS;
 exports.FRAMING_CATEGORY_ORDER = FRAMING_CATEGORY_ORDER;
@@ -34231,6 +34334,8 @@ exports.SNIPPET_MEDIA_VALUES = SNIPPET_MEDIA_VALUES;
 exports.STYLES = STYLES;
 exports.STYLE_IDS = STYLE_IDS;
 exports.STYLE_PRESETS = STYLE_PRESETS;
+exports.STYLE_SECTION_GAP = STYLE_SECTION_GAP;
+exports.STYLE_SECTION_HEADER = STYLE_SECTION_HEADER;
 exports.STYLINGS = STYLINGS;
 exports.STYLING_DIMENSION_LABELS = STYLING_DIMENSION_LABELS;
 exports.STYLING_DIMENSION_ORDER = STYLING_DIMENSION_ORDER;
@@ -34283,6 +34388,7 @@ exports.applyPickerJson = applyPickerJson;
 exports.applyPromptAffixes = applyPromptAffixes;
 exports.applyReferenceOrderToVideo = applyReferenceOrderToVideo;
 exports.applyTemplate = applyTemplate;
+exports.asBodyClauses = asBodyClauses;
 exports.assembleImageInput = assembleImageInput;
 exports.assembleSunoInput = assembleSunoInput;
 exports.buildActionFxHints = buildActionFxHints;
@@ -34356,6 +34462,7 @@ exports.composeCameraMotionTermFromConnections = composeCameraMotionTermFromConn
 exports.composeCharacterFxHintFromConnections = composeCharacterFxHintFromConnections;
 exports.composeNegative = composeNegative;
 exports.composePickerCatalogs = composePickerCatalogs;
+exports.composeSectionedPrompt = composeSectionedPrompt;
 exports.composeSoundHintFromConnections = composeSoundHintFromConnections;
 exports.composeTransitionHintFromConnections = composeTransitionHintFromConnections;
 exports.composeVideoPromptText = composeVideoPromptText;
@@ -34364,6 +34471,7 @@ exports.computeNodePrompt = computeNodePrompt;
 exports.computePackSidecarCoverage = computePackSidecarCoverage;
 exports.deriveTerm = deriveTerm;
 exports.directionFieldsForSurface = directionFieldsForSurface;
+exports.endsInsideStyleSection = endsInsideStyleSection;
 exports.expandImagePositionRefs = expandImagePositionRefs;
 exports.expandImageRefTokens = expandImageRefTokens;
 exports.filmStillPrefix = filmStillPrefix;
@@ -34550,6 +34658,7 @@ exports.getWardrobePromptHint = getWardrobePromptHint;
 exports.groupFactoryPresets = groupFactoryPresets;
 exports.hasUpstreamCharacter = hasUpstreamCharacter;
 exports.identityRefsSentence = identityRefsSentence;
+exports.insertBeforeStyleSection = insertBeforeStyleSection;
 exports.isAnalyzablePicker = isAnalyzablePicker;
 exports.isInstrumentalVocal = isInstrumentalVocal;
 exports.isSuspiciousDerivedTerm = isSuspiciousDerivedTerm;
@@ -34565,6 +34674,7 @@ exports.nodeHasInlinePrompt = nodeHasInlinePrompt;
 exports.nodeHasPromptField = nodeHasPromptField;
 exports.nodeSupportsPromptAffixes = nodeSupportsPromptAffixes;
 exports.normalizeSubjectFields = normalizeSubjectFields;
+exports.partitionStyleClauses = partitionStyleClauses;
 exports.personPacksVersion = personPacksVersion;
 exports.pickerFanoutTargets = pickerFanoutTargets;
 exports.projectAllCatalogs = projectAllCatalogs;
@@ -34579,8 +34689,10 @@ exports.readSubjectFields = readSubjectFields;
 exports.referenceRulesBlock = referenceRulesBlock;
 exports.registerCatalogPack = registerCatalogPack;
 exports.registerPersonPack = registerPersonPack;
+exports.renderDirectionHintClauses = renderDirectionHintClauses;
 exports.renderDirectionHints = renderDirectionHints;
 exports.renderStructuredFields = renderStructuredFields;
+exports.renderStyleSection = renderStyleSection;
 exports.renderSubjectHints = renderSubjectHints;
 exports.resetCatalogPacks = resetCatalogPacks;
 exports.resetPersonPacks = resetPersonPacks;
@@ -34596,6 +34708,10 @@ exports.resolveTemplate = resolveTemplate;
 exports.resolveTerm = resolveTerm;
 exports.resolveVeoI2vInputs = resolveVeoI2vInputs;
 exports.resolveVideoReferenceCore = resolveVideoReferenceCore;
+exports.sectionedClauseCosts = sectionedClauseCosts;
+exports.splitStyleSection = splitStyleSection;
+exports.styleSectionFromClauses = styleSectionFromClauses;
+exports.styleSlotFor = styleSlotFor;
 exports.subjectFieldsForSurface = subjectFieldsForSurface;
 exports.summarizePickerCatalogs = summarizePickerCatalogs;
 exports.toIdentityLockMode = toIdentityLockMode;