@nodaro/prompts 1.38.0 → 1.40.0

package/dist/{chunk-QBEZMR2F.js → chunk-HQTHDTHN.js}

@@ -1,15 +1,16 @@
-import { tidyReferenceTokenGaps, unboundReferenceTokenText, renderDescribedReferenceLines, renderReferenceCaptionLines, appendReferenceLines, resolveCharacterMentions, referenceDescriptionLine, insertBeforeStyleSection, applyReferenceOrderToVideo, sectionedClauseCosts, asBodyClauses, renderSubjectHints, SUBJECT_VIDEO_HINT_MODE_DEFAULT, partitionStyleClauses, VIDEO_HINT_MODE_DEFAULT, renderStructuredFields, buildImagePromptWithOverflow, composeSectionedPrompt, SUBJECT_IMAGE_HINT_MODE_DEFAULT, IMAGE_HINT_MODE_DEFAULT } from './chunk-QDEWBBUR.js';
+import { tidyReferenceTokenGaps, unboundReferenceTokenText, renderDescribedReferenceLines, renderReferenceCaptionLines, appendReferenceLines, resolveCharacterMentions, referenceDescriptionLine, insertBeforeStyleSection, applyReferenceOrderToVideo, sectionedClauseCosts, asBodyClauses, renderSubjectHints, SUBJECT_VIDEO_HINT_MODE_DEFAULT, partitionStyleClauses, renderStructuredFields, composeSectionedPrompt, buildImagePromptWithOverflow, SUBJECT_IMAGE_HINT_MODE_DEFAULT } from './chunk-DUXX6CBX.js';
 import { keepableDirectionHints } from './chunk-JZOPMVGY.js';
 import { buildIdentityLockLine, withForcedIdentityLock } from './chunk-BQWIPLLR.js';
-import { getParameterPromptHint } from './chunk-N7TOWXDJ.js';
+import { getParameterPromptHint } from './chunk-QDUTMOF4.js';
+import { styleReferenceDescription, VIDEO_HINT_MODE_DEFAULT, IMAGE_HINT_MODE_DEFAULT } from './chunk-EAYEZXWT.js';
 import { getMusicEra, getMusicGenre, buildMusicMoodHints } from './chunk-SXXW4LCR.js';
 import { findCharacterMentionTokens, roleToPhrase, resolveDefaultRole, DEFAULT_USAGE_MODE, usageModeDirective, REFERENCE_ROLE_PRESETS } from '@nodaro/shared/entities';
-import { SEEDANCE_2_REF_LIMITS, VIDEO_REF_LIMITS_BY_PROVIDER } from '@nodaro/shared/models';
+import { imageReferenceLimit, SEEDANCE_2_REF_LIMITS, VIDEO_REF_LIMITS_BY_PROVIDER } from '@nodaro/shared/models';
 import { resolveFrameDelivery } from '@nodaro/shared/video';
 
 // src/ref-binding.ts
-function identityRefsSentence(firstOrdinal, lastOrdinal) {
-  return firstOrdinal === lastOrdinal ? `${REF_BINDING.ordinal(firstOrdinal)} is an identity reference for this shot's subjects \u2014 match its subject's exact appearance; it is not a frame.` : `${REF_BINDING.ordinal(firstOrdinal)} through ${REF_BINDING.ordinal(lastOrdinal)} are identity references for this shot's subjects \u2014 match each subject's exact appearance; they are not frames.`;
+function identityRefsSentence(firstOrdinal, lastOrdinal, ordinal = REF_BINDING.ordinal) {
+  return firstOrdinal === lastOrdinal ? `${ordinal(firstOrdinal)} is an identity reference for this shot's subjects \u2014 match its subject's exact appearance; it is not a frame.` : `${ordinal(firstOrdinal)} through ${ordinal(lastOrdinal)} are identity references for this shot's subjects \u2014 match each subject's exact appearance; they are not frames.`;
 }
 var REF_BINDING = {
   image: (label, n) => `the ${label} from @image_${n}`,
@@ -19,6 +20,14 @@ var REF_BINDING = {
   ordinal: (n) => `@image_${n}`,
   frame: (n, role) => `Use @image_${n} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`
 };
+function imageBindingFor(syntax) {
+  if (syntax === "@image_N") return { ordinal: REF_BINDING.ordinal, frame: REF_BINDING.frame };
+  const ordinal = syntax === "@image(n)" ? (n) => `@image(${n})` : (n) => `[Image ${n}]`;
+  return {
+    ordinal,
+    frame: (n, role) => `Use ${ordinal(n)} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`
+  };
+}
 var SEEDANCE_VIDEO_EDIT_PREFIX = "edit {video:1} as follows:\n";
 function buildSeedanceVideoEditPrompt(prompt) {
   const body = (prompt ?? "").trim();
@@ -616,9 +625,7 @@ function assembleSunoInput(input) {
     ...input.persona ?? {}
   };
 }
-
-// src/assemble-image-input.ts
-function renderImageHintPieces(subject, direction, structured) {
+function renderImageHintPieces(subject, direction, structured, directionRefs) {
   return {
     hintClauses: [
       ...asBodyClauses(
@@ -629,7 +636,8 @@ function renderImageHintPieces(subject, direction, structured) {
       ),
       ...partitionStyleClauses(direction, {
         surface: "image",
-        mode: IMAGE_HINT_MODE_DEFAULT
+        mode: IMAGE_HINT_MODE_DEFAULT,
+        ...directionRefs !== void 0 ? { refs: directionRefs } : {}
       })
     ].filter((c) => c.text.length > 0),
     structuredFragment: structured ? renderStructuredFields(structured) : ""
@@ -643,7 +651,51 @@ function composePromptText(userPrompt, pieces, keptHintClauses) {
   );
 }
 function assembleImageInput(input) {
-  const pieces = renderImageHintPieces(input.subject, input.direction, input.structured);
+  const style = input.styleReferences;
+  const result = style !== void 0 && style.length > 0 ? fillStyleReferences(input, style) : assembleOnce(input);
+  if (input.throwOnEmpty && !result.prompt.trim()) {
+    throw new Error(
+      "No prompt \u2014 type one, bind a character, or pick a cinematography direction"
+    );
+  }
+  return result;
+}
+function fillStyleReferences(input, style) {
+  const base = assembleOnce(input);
+  const own = base.referenceImageUrls ?? [];
+  const seats = imageReferenceLimit(input.provider) - own.length;
+  const seen = new Set(own);
+  const candidates = [];
+  for (const s of style) {
+    if (typeof s.url !== "string" || s.url.length === 0 || seen.has(s.url)) continue;
+    seen.add(s.url);
+    candidates.push(s);
+  }
+  for (let k = Math.min(seats, candidates.length); k > 0; k--) {
+    const extras = candidates.slice(0, k).map(styleConnectedReference);
+    const filled = assembleOnce({
+      ...input,
+      connectedReferences: [...input.connectedReferences ?? [], ...extras]
+    });
+    const urls = filled.referenceImageUrls ?? [];
+    const keepsOwn = urls.length === own.length + k && own.every((url, i) => urls[i] === url) && extras.every((ref, j) => urls[own.length + j] === ref.url);
+    if (keepsOwn) return { ...filled, styleReferencesSent: k };
+  }
+  return { ...base, styleReferencesSent: 0 };
+}
+function styleConnectedReference(s, index) {
+  return {
+    id: `style-reference-${index + 1}`,
+    defaultName: `Style reference ${index + 1}`,
+    source: "manual",
+    url: s.url,
+    isExtraRef: true,
+    defaultRole: "style",
+    description: styleReferenceDescription(index, s.caption)
+  };
+}
+function assembleOnce(input) {
+  const pieces = renderImageHintPieces(input.subject, input.direction, input.structured, input.directionRefs);
   const assembleWith = (keptHintClauses) => buildImagePromptWithOverflow({
     prompt: composePromptText(input.userPrompt, pieces, keptHintClauses),
     provider: input.provider,
@@ -684,11 +736,6 @@ function assembleImageInput(input) {
     }
   }
   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"
-    );
-  }
   return result;
 }
 
@@ -724,15 +771,50 @@ function composeVideoPromptText(userPrompt, direction, structured, opts) {
   }
   return body;
 }
+
+// src/frame-reference-slots.ts
+function placeFramesAfterReferences(args) {
+  const refs = (args.refImageUrls ?? []).filter((u) => typeof u === "string" && u.trim().length > 0);
+  const frameCount = (args.firstFrameUrl ? 1 : 0) + (args.lastFrameUrl ? 1 : 0);
+  const kept = refs.slice(0, Math.max(0, args.imageCap - frameCount));
+  const droppedRefImages = refs.length - kept.length;
+  const imageUrls = [...kept];
+  let firstFrameOrdinal = 0;
+  let lastFrameOrdinal = 0;
+  if (args.firstFrameUrl) {
+    imageUrls.push(args.firstFrameUrl);
+    firstFrameOrdinal = imageUrls.length;
+  }
+  if (args.lastFrameUrl) {
+    imageUrls.push(args.lastFrameUrl);
+    lastFrameOrdinal = imageUrls.length;
+  }
+  const syntax = args.syntax ?? "@image_N";
+  const binding = imageBindingFor(syntax);
+  const promptBindsStart = syntax === "@image_N" && promptBindsFirstFrame(args.prompt);
+  let frameSentence = "";
+  if (promptBindsStart && firstFrameOrdinal > 0 && lastFrameOrdinal === 0) ; else if (firstFrameOrdinal > 0 && lastFrameOrdinal > 0) {
+    frameSentence = `Use ${binding.ordinal(firstFrameOrdinal)} as the opening (first) frame and ${binding.ordinal(lastFrameOrdinal)} as the closing (last) frame of the video.`;
+  } else if (firstFrameOrdinal > 0) {
+    frameSentence = binding.frame(firstFrameOrdinal, "opening");
+  } else if (lastFrameOrdinal > 0) {
+    frameSentence = binding.frame(lastFrameOrdinal, "closing");
+  }
+  const identitySentence = args.bindIdentities && kept.length > 0 && frameCount > 0 ? identityRefsSentence(1, kept.length, binding.ordinal) : "";
+  const promptSuffix = [frameSentence, identitySentence].filter(Boolean).join(" ");
+  return { imageUrls, promptSuffix, droppedRefImages, firstFrameOrdinal, lastFrameOrdinal };
+}
+function promptBindsFirstFrame(prompt) {
+  if (!prompt) return false;
+  return /@image_\d+\s+as\s+the\s+(first|opening)\s*(\(first\))?\s*frame/i.test(prompt);
+}
+
+// src/seedance-2-inputs.ts
 var clean = (u) => {
   const t = u?.trim();
   return t && t.length > 0 ? t : void 0;
 };
 var cleanList = (xs) => (xs ?? []).map(clean).filter((x) => x !== void 0);
-function promptBindsFirstFrame(prompt) {
-  if (!prompt) return false;
-  return /@image_\d+\s+as\s+the\s+(first|opening)\s*(\(first\))?\s*frame/i.test(prompt);
-}
 function resolveSeedance2Inputs(args) {
   const limits = args.limits ?? SEEDANCE_2_REF_LIMITS;
   const firstFrameUrl = clean(args.firstFrameUrl);
@@ -748,30 +830,16 @@ function resolveSeedance2Inputs(args) {
     }
     return { mode: "first-frame", firstFrameUrl, lastFrameUrl: void 0, referenceImageUrls: [], referenceVideoUrls: [], referenceAudioUrls: [], promptSuffix: "", droppedRefImages: 0 };
   }
-  const frameCount = (firstFrameUrl ? 1 : 0) + (lastFrameUrl ? 1 : 0);
-  const userImageSlots = Math.max(0, limits.images - frameCount);
-  const keptUserImages = refImages.slice(0, userImageSlots);
-  const droppedRefImages = refImages.length - keptUserImages.length;
-  const referenceImageUrls = [...keptUserImages];
-  let firstOrdinal = 0;
-  let lastOrdinal = 0;
-  if (firstFrameUrl) {
-    referenceImageUrls.push(firstFrameUrl);
-    firstOrdinal = referenceImageUrls.length;
-  }
-  if (lastFrameUrl) {
-    referenceImageUrls.push(lastFrameUrl);
-    lastOrdinal = referenceImageUrls.length;
-  }
-  let promptSuffix = "";
-  const suppressFrameSentence = promptBindsFirstFrame(args.prompt);
-  if (suppressFrameSentence && firstOrdinal > 0 && lastOrdinal === 0) ; else if (firstOrdinal > 0 && lastOrdinal > 0) {
-    promptSuffix = `Use ${REF_BINDING.ordinal(firstOrdinal)} as the opening (first) frame and ${REF_BINDING.ordinal(lastOrdinal)} as the closing (last) frame of the video.`;
-  } else if (firstOrdinal > 0) {
-    promptSuffix = REF_BINDING.frame(firstOrdinal, "opening");
-  } else if (lastOrdinal > 0) {
-    promptSuffix = REF_BINDING.frame(lastOrdinal, "closing");
-  }
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl,
+    lastFrameUrl,
+    refImageUrls: refImages,
+    imageCap: limits.images
+  });
+  const referenceImageUrls = placed.imageUrls;
+  const promptSuffix = placed.promptSuffix;
+  const droppedRefImages = placed.droppedRefImages;
   return {
     mode: "reference",
     firstFrameUrl: void 0,
@@ -788,16 +856,18 @@ function geminiOmniInputSlots(provider) {
   return VIDEO_REF_LIMITS_BY_PROVIDER[provider ?? DEFAULT_GEMINI_OMNI_PROVIDER]?.images ?? 7;
 }
 function resolveGeminiOmniI2vInputs(args) {
-  const refs = (args.refImageUrls ?? []).filter((u) => typeof u === "string" && u.length > 0);
   const slots = geminiOmniInputSlots(args.provider) - (args.videoConnected ? 2 : 0);
-  const refSlots = Math.max(0, slots - 1);
-  const kept = refs.slice(0, refSlots);
-  const droppedRefImages = refs.length - kept.length;
-  const imageUrls = [args.firstFrameUrl, ...kept];
-  if (kept.length === 0) return { imageUrls, promptSuffix: "", droppedRefImages };
-  const frameSentence = promptBindsFirstFrame(args.prompt) ? "" : REF_BINDING.frame(1, "opening");
-  const promptSuffix = [frameSentence, identityRefsSentence(2, kept.length + 1)].filter(Boolean).join(" ");
-  return { imageUrls, promptSuffix, droppedRefImages };
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl: args.firstFrameUrl,
+    refImageUrls: args.refImageUrls,
+    imageCap: Math.max(1, slots),
+    bindIdentities: true
+  });
+  if (placed.imageUrls.length === 1) {
+    return { imageUrls: placed.imageUrls, promptSuffix: "", droppedRefImages: placed.droppedRefImages };
+  }
+  return { imageUrls: placed.imageUrls, promptSuffix: placed.promptSuffix, droppedRefImages: placed.droppedRefImages };
 }
 
 // src/veo-i2v-inputs.ts
@@ -812,15 +882,20 @@ function resolveVeoI2vInputs(args) {
       droppedEndFrame: false
     };
   }
-  const kept = refs.slice(0, VEO_INGREDIENT_SLOTS - 1);
-  const droppedRefImages = refs.length - kept.length;
-  const frameSentence = promptBindsFirstFrame(args.prompt) ? "" : REF_BINDING.frame(1, "opening");
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl: args.firstFrameUrl,
+    lastFrameUrl: args.endFrameUrl,
+    refImageUrls: refs,
+    imageCap: VEO_INGREDIENT_SLOTS,
+    bindIdentities: true
+  });
   return {
-    imageUrls: [args.firstFrameUrl, ...kept],
+    imageUrls: placed.imageUrls,
     generationType: "REFERENCE_2_VIDEO",
-    promptSuffix: [frameSentence, identityRefsSentence(2, kept.length + 1)].filter(Boolean).join(" "),
-    droppedRefImages,
-    droppedEndFrame: Boolean(args.endFrameUrl)
+    promptSuffix: placed.promptSuffix,
+    droppedRefImages: placed.droppedRefImages,
+    droppedEndFrame: false
   };
 }
 
@@ -888,6 +963,6 @@ function planFrameDelivery(args) {
   return { delivery: "reference", referenceImageUrls, promptSuffix: sentences.join(" ") };
 }
 
-export { REF_BINDING, SEEDANCE_VIDEO_EDIT_PREFIX, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };
-//# sourceMappingURL=chunk-QBEZMR2F.js.map
-//# sourceMappingURL=chunk-QBEZMR2F.js.map
+export { REF_BINDING, SEEDANCE_VIDEO_EDIT_PREFIX, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };
+//# sourceMappingURL=chunk-HQTHDTHN.js.map
+//# sourceMappingURL=chunk-HQTHDTHN.js.map