@nodaro/prompts 1.39.0 → 1.41.0

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

@@ -9,8 +9,8 @@ import { imageReferenceLimit, SEEDANCE_2_REF_LIMITS, VIDEO_REF_LIMITS_BY_PROVIDE
 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}`,
@@ -20,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();
@@ -763,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);
@@ -787,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,
@@ -827,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
@@ -851,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
   };
 }
 
@@ -927,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-XU54YJXQ.js.map
-//# sourceMappingURL=chunk-XU54YJXQ.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