@nodaro/prompts 1.52.0 → 1.53.1

package/dist/entries/assembly.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkM6EXNY42_cjs = require('../chunk-M6EXNY42.cjs');
+var chunkEKRO42T3_cjs = require('../chunk-EKRO42T3.cjs');
 require('../chunk-PWYASBX2.cjs');
 require('../chunk-4GKTOVFM.cjs');
 require('../chunk-XUZXBY75.cjs');
@@ -19,95 +19,95 @@ require('../chunk-Q7SFCCGT.cjs');
 
 Object.defineProperty(exports, "REF_BINDING", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.REF_BINDING; }
+  get: function () { return chunkEKRO42T3_cjs.REF_BINDING; }
 });
 Object.defineProperty(exports, "SEEDANCE_VIDEO_EDIT_PREFIX", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.SEEDANCE_VIDEO_EDIT_PREFIX; }
+  get: function () { return chunkEKRO42T3_cjs.SEEDANCE_VIDEO_EDIT_PREFIX; }
 });
 Object.defineProperty(exports, "appendField", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.appendField; }
+  get: function () { return chunkEKRO42T3_cjs.appendField; }
 });
 Object.defineProperty(exports, "appendMusicMeta", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.appendMusicMeta; }
+  get: function () { return chunkEKRO42T3_cjs.appendMusicMeta; }
 });
 Object.defineProperty(exports, "assembleImageInput", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.assembleImageInput; }
+  get: function () { return chunkEKRO42T3_cjs.assembleImageInput; }
 });
 Object.defineProperty(exports, "assembleSunoInput", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.assembleSunoInput; }
+  get: function () { return chunkEKRO42T3_cjs.assembleSunoInput; }
 });
 Object.defineProperty(exports, "buildSeedanceVideoEditPrompt", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.buildSeedanceVideoEditPrompt; }
+  get: function () { return chunkEKRO42T3_cjs.buildSeedanceVideoEditPrompt; }
 });
 Object.defineProperty(exports, "buildSurroundFillPrompt", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.buildSurroundFillPrompt; }
+  get: function () { return chunkEKRO42T3_cjs.buildSurroundFillPrompt; }
 });
 Object.defineProperty(exports, "composeSoundHintFromConnections", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.composeSoundHintFromConnections; }
+  get: function () { return chunkEKRO42T3_cjs.composeSoundHintFromConnections; }
 });
 Object.defineProperty(exports, "composeVideoPromptText", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.composeVideoPromptText; }
+  get: function () { return chunkEKRO42T3_cjs.composeVideoPromptText; }
 });
 Object.defineProperty(exports, "getEffectiveSunoCustomMode", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.getEffectiveSunoCustomMode; }
+  get: function () { return chunkEKRO42T3_cjs.getEffectiveSunoCustomMode; }
 });
 Object.defineProperty(exports, "identityRefsSentence", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.identityRefsSentence; }
+  get: function () { return chunkEKRO42T3_cjs.identityRefsSentence; }
 });
 Object.defineProperty(exports, "imageBindingFor", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.imageBindingFor; }
+  get: function () { return chunkEKRO42T3_cjs.imageBindingFor; }
 });
 Object.defineProperty(exports, "placeFramesAfterReferences", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.placeFramesAfterReferences; }
+  get: function () { return chunkEKRO42T3_cjs.placeFramesAfterReferences; }
 });
 Object.defineProperty(exports, "planFrameDelivery", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.planFrameDelivery; }
+  get: function () { return chunkEKRO42T3_cjs.planFrameDelivery; }
 });
 Object.defineProperty(exports, "promptBindsFirstFrame", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.promptBindsFirstFrame; }
+  get: function () { return chunkEKRO42T3_cjs.promptBindsFirstFrame; }
 });
 Object.defineProperty(exports, "resolveGeminiOmniI2vInputs", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveGeminiOmniI2vInputs; }
+  get: function () { return chunkEKRO42T3_cjs.resolveGeminiOmniI2vInputs; }
 });
 Object.defineProperty(exports, "resolveRefIdTokens", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveRefIdTokens; }
+  get: function () { return chunkEKRO42T3_cjs.resolveRefIdTokens; }
 });
 Object.defineProperty(exports, "resolveReferenceTokens", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveReferenceTokens; }
+  get: function () { return chunkEKRO42T3_cjs.resolveReferenceTokens; }
 });
 Object.defineProperty(exports, "resolveSeedance2Inputs", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveSeedance2Inputs; }
+  get: function () { return chunkEKRO42T3_cjs.resolveSeedance2Inputs; }
 });
 Object.defineProperty(exports, "resolveVeoI2vInputs", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveVeoI2vInputs; }
+  get: function () { return chunkEKRO42T3_cjs.resolveVeoI2vInputs; }
 });
 Object.defineProperty(exports, "resolveVideoReferenceCore", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveVideoReferenceCore; }
+  get: function () { return chunkEKRO42T3_cjs.resolveVideoReferenceCore; }
 });
 Object.defineProperty(exports, "truncateForField", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.truncateForField; }
+  get: function () { return chunkEKRO42T3_cjs.truncateForField; }
 });
 //# sourceMappingURL=assembly.cjs.map
 //# sourceMappingURL=assembly.cjs.map

package/dist/entries/assembly.d.cts

@@ -42,18 +42,33 @@ declare const REF_BINDING: {
     readonly ordinal: (n: number) => string;
     readonly frame: (n: number, role: "opening" | "closing") => string;
 };
-/** A binding sentence's ordinal + frame directive in one provider syntax. */
+/** How a video provider addresses its images in the prompt, by array order
+ *  (`VideoReferenceSyntax` in @nodaro/shared). */
+type ImageReferenceSyntax = "@image_N" | "@image(n)" | "[Image N]" | "image N";
+/** The binding sentences — frames and identity references — in one provider syntax. */
 interface ImageBinding {
     ordinal: (n: number) => string;
+    /** One frame: the opening or the closing one. */
     frame: (n: number, role: "opening" | "closing") => string;
+    /** A start and an end frame together. */
+    frames: (first: number, last: number) => string;
+    /** Seats `first`..`last` are references, not frames. */
+    identities: (first: number, last: number) => string;
 }
 /**
  * The image binding in a provider's OWN reference syntax
  * (`videoProviderReferenceSyntax` in @nodaro/shared). `@image_N` IS
- * {@link REF_BINDING} — the platform swap point, byte for byte; the other two
- * spell the same sentence in the form the provider documents.
+ * {@link REF_BINDING} — the platform swap point, byte for byte; `@image(n)` and
+ * `[Image N]` spell the same sentences in the form the provider documents.
+ *
+ * `image N` (Gemini Omni Flash 1.2) is plain words, each sentence stating what
+ * an image IS: "image 3 is the opening (first) frame of the video. image 1 and
+ * image 2 are references for the subject; they are not frames." It is the form
+ * KIE's own example uses. In staging runs neither wording made 1.2 open on the
+ * frame: beside references the frame is one more reference, so the sentence
+ * guides the clip and never makes the frame exact.
  */
-declare function imageBindingFor(syntax: "@image_N" | "@image(n)" | "[Image N]"): ImageBinding;
+declare function imageBindingFor(syntax: ImageReferenceSyntax): ImageBinding;
 /**
  * The instruction that makes Seedance EDIT a wired clip rather than use it as a
  * style reference — the Video to Video node's Seedance lane prepends it to the
@@ -886,7 +901,7 @@ interface FrameReferenceSlotsArgs {
     /** The provider's image cap — frames and references together. */
     imageCap: number;
     /** The provider's reference syntax (`videoProviderReferenceSyntax`). */
-    syntax?: "@image_N" | "@image(n)" | "[Image N]";
+    syntax?: ImageReferenceSyntax;
     bindIdentities?: boolean;
 }
 interface FrameReferenceSlotsResult {
@@ -1103,4 +1118,4 @@ interface FrameDeliveryPlan {
  */
 declare function planFrameDelivery(args: FrameDeliveryPlanArgs): FrameDeliveryPlan;
 
-export { type AssembleImageInput, type AssembleImageResult, type AssembleSunoInput, type AssembleSunoResult, type CharacterMeta, DirectionFields, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type FrameReferenceSlotsArgs, type FrameReferenceSlotsResult, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, type ImageBinding, REF_BINDING, type RefIdTokenContext, type ReferenceCounts, type ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, SubjectFields, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoExtraRef, type VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };
+export { type AssembleImageInput, type AssembleImageResult, type AssembleSunoInput, type AssembleSunoResult, type CharacterMeta, DirectionFields, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type FrameReferenceSlotsArgs, type FrameReferenceSlotsResult, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, type ImageBinding, type ImageReferenceSyntax, REF_BINDING, type RefIdTokenContext, type ReferenceCounts, type ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, SubjectFields, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoExtraRef, type VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };

package/dist/entries/assembly.d.ts

@@ -42,18 +42,33 @@ declare const REF_BINDING: {
     readonly ordinal: (n: number) => string;
     readonly frame: (n: number, role: "opening" | "closing") => string;
 };
-/** A binding sentence's ordinal + frame directive in one provider syntax. */
+/** How a video provider addresses its images in the prompt, by array order
+ *  (`VideoReferenceSyntax` in @nodaro/shared). */
+type ImageReferenceSyntax = "@image_N" | "@image(n)" | "[Image N]" | "image N";
+/** The binding sentences — frames and identity references — in one provider syntax. */
 interface ImageBinding {
     ordinal: (n: number) => string;
+    /** One frame: the opening or the closing one. */
     frame: (n: number, role: "opening" | "closing") => string;
+    /** A start and an end frame together. */
+    frames: (first: number, last: number) => string;
+    /** Seats `first`..`last` are references, not frames. */
+    identities: (first: number, last: number) => string;
 }
 /**
  * The image binding in a provider's OWN reference syntax
  * (`videoProviderReferenceSyntax` in @nodaro/shared). `@image_N` IS
- * {@link REF_BINDING} — the platform swap point, byte for byte; the other two
- * spell the same sentence in the form the provider documents.
+ * {@link REF_BINDING} — the platform swap point, byte for byte; `@image(n)` and
+ * `[Image N]` spell the same sentences in the form the provider documents.
+ *
+ * `image N` (Gemini Omni Flash 1.2) is plain words, each sentence stating what
+ * an image IS: "image 3 is the opening (first) frame of the video. image 1 and
+ * image 2 are references for the subject; they are not frames." It is the form
+ * KIE's own example uses. In staging runs neither wording made 1.2 open on the
+ * frame: beside references the frame is one more reference, so the sentence
+ * guides the clip and never makes the frame exact.
  */
-declare function imageBindingFor(syntax: "@image_N" | "@image(n)" | "[Image N]"): ImageBinding;
+declare function imageBindingFor(syntax: ImageReferenceSyntax): ImageBinding;
 /**
  * The instruction that makes Seedance EDIT a wired clip rather than use it as a
  * style reference — the Video to Video node's Seedance lane prepends it to the
@@ -886,7 +901,7 @@ interface FrameReferenceSlotsArgs {
     /** The provider's image cap — frames and references together. */
     imageCap: number;
     /** The provider's reference syntax (`videoProviderReferenceSyntax`). */
-    syntax?: "@image_N" | "@image(n)" | "[Image N]";
+    syntax?: ImageReferenceSyntax;
     bindIdentities?: boolean;
 }
 interface FrameReferenceSlotsResult {
@@ -1103,4 +1118,4 @@ interface FrameDeliveryPlan {
  */
 declare function planFrameDelivery(args: FrameDeliveryPlanArgs): FrameDeliveryPlan;
 
-export { type AssembleImageInput, type AssembleImageResult, type AssembleSunoInput, type AssembleSunoResult, type CharacterMeta, DirectionFields, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type FrameReferenceSlotsArgs, type FrameReferenceSlotsResult, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, type ImageBinding, REF_BINDING, type RefIdTokenContext, type ReferenceCounts, type ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, SubjectFields, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoExtraRef, type VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };
+export { type AssembleImageInput, type AssembleImageResult, type AssembleSunoInput, type AssembleSunoResult, type CharacterMeta, DirectionFields, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type FrameReferenceSlotsArgs, type FrameReferenceSlotsResult, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, type ImageBinding, type ImageReferenceSyntax, REF_BINDING, type RefIdTokenContext, type ReferenceCounts, type ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, SubjectFields, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoExtraRef, type VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };

package/dist/entries/assembly.js

@@ -1,4 +1,4 @@
-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 } from '../chunk-HETYHGGW.js';
+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 } from '../chunk-XR7RAHZI.js';
 import '../chunk-YAIPYPMM.js';
 import '../chunk-GILUVQQJ.js';
 import '../chunk-JZOPMVGY.js';

package/dist/entries/picker-art.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGJV7KTDX_cjs = require('../chunk-GJV7KTDX.cjs');
+var chunkTYRIHUID_cjs = require('../chunk-TYRIHUID.cjs');
 var chunkFFPFBNXH_cjs = require('../chunk-FFPFBNXH.cjs');
 require('../chunk-Q7SFCCGT.cjs');
 
@@ -8,11 +8,11 @@ require('../chunk-Q7SFCCGT.cjs');
 
 Object.defineProperty(exports, "RESTYLE_PREVIEWS", {
   enumerable: true,
-  get: function () { return chunkGJV7KTDX_cjs.RESTYLE_PREVIEWS; }
+  get: function () { return chunkTYRIHUID_cjs.RESTYLE_PREVIEWS; }
 });
 Object.defineProperty(exports, "restylePreviewStillUrl", {
   enumerable: true,
-  get: function () { return chunkGJV7KTDX_cjs.restylePreviewStillUrl; }
+  get: function () { return chunkTYRIHUID_cjs.restylePreviewStillUrl; }
 });
 Object.defineProperty(exports, "CHARACTER_ART_FAMILIES", {
   enumerable: true,

package/dist/entries/picker-art.js

@@ -1,4 +1,4 @@
-export { RESTYLE_PREVIEWS, restylePreviewStillUrl } from '../chunk-CDTEETF3.js';
+export { RESTYLE_PREVIEWS, restylePreviewStillUrl } from '../chunk-RBRCJTDJ.js';
 export { CHARACTER_ART_FAMILIES, CHARACTER_ART_FILES, CHARACTER_ART_PATH, LOOK_PREVIEW_SETS, PICKER_ART_PATH, RENDER_WIDTH_LADDER, SOUND_ART, SOUND_ART_FILES, SOUND_RENDER_SETS, characterArtPath, characterSectionArtPath, characterSectionSlug, lookPreviewStillUrl, pickerOptionImage, pickerOptionImageUrl, pickerSectionImageUrl, soundArtFilePath, soundArtPath } from '../chunk-5XPELUES.js';
 import '../chunk-PZ5AY32C.js';
 //# sourceMappingURL=picker-art.js.map

package/dist/index.cjs

@@ -4,7 +4,7 @@ var chunkGRSKB3P7_cjs = require('./chunk-GRSKB3P7.cjs');
 var chunkP4BXE4OA_cjs = require('./chunk-P4BXE4OA.cjs');
 var chunk2EW5B7ZV_cjs = require('./chunk-2EW5B7ZV.cjs');
 var chunkLXPKTI2K_cjs = require('./chunk-LXPKTI2K.cjs');
-var chunkM6EXNY42_cjs = require('./chunk-M6EXNY42.cjs');
+var chunkEKRO42T3_cjs = require('./chunk-EKRO42T3.cjs');
 var chunkPWYASBX2_cjs = require('./chunk-PWYASBX2.cjs');
 require('./chunk-4GKTOVFM.cjs');
 var chunkXUZXBY75_cjs = require('./chunk-XUZXBY75.cjs');
@@ -14,7 +14,7 @@ var chunkXRCK3BCF_cjs = require('./chunk-XRCK3BCF.cjs');
 var chunkNAFD6MGH_cjs = require('./chunk-NAFD6MGH.cjs');
 var chunk2NJTFCKQ_cjs = require('./chunk-2NJTFCKQ.cjs');
 require('./chunk-TUHVGM6V.cjs');
-var chunkGJV7KTDX_cjs = require('./chunk-GJV7KTDX.cjs');
+var chunkTYRIHUID_cjs = require('./chunk-TYRIHUID.cjs');
 var chunk7BWDATUZ_cjs = require('./chunk-7BWDATUZ.cjs');
 var chunkOQ3J7OGR_cjs = require('./chunk-OQ3J7OGR.cjs');
 var chunkKTNCB2IE_cjs = require('./chunk-KTNCB2IE.cjs');
@@ -274,95 +274,95 @@ Object.defineProperty(exports, "resolvePrompt", {
 });
 Object.defineProperty(exports, "REF_BINDING", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.REF_BINDING; }
+  get: function () { return chunkEKRO42T3_cjs.REF_BINDING; }
 });
 Object.defineProperty(exports, "SEEDANCE_VIDEO_EDIT_PREFIX", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.SEEDANCE_VIDEO_EDIT_PREFIX; }
+  get: function () { return chunkEKRO42T3_cjs.SEEDANCE_VIDEO_EDIT_PREFIX; }
 });
 Object.defineProperty(exports, "appendField", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.appendField; }
+  get: function () { return chunkEKRO42T3_cjs.appendField; }
 });
 Object.defineProperty(exports, "appendMusicMeta", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.appendMusicMeta; }
+  get: function () { return chunkEKRO42T3_cjs.appendMusicMeta; }
 });
 Object.defineProperty(exports, "assembleImageInput", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.assembleImageInput; }
+  get: function () { return chunkEKRO42T3_cjs.assembleImageInput; }
 });
 Object.defineProperty(exports, "assembleSunoInput", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.assembleSunoInput; }
+  get: function () { return chunkEKRO42T3_cjs.assembleSunoInput; }
 });
 Object.defineProperty(exports, "buildSeedanceVideoEditPrompt", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.buildSeedanceVideoEditPrompt; }
+  get: function () { return chunkEKRO42T3_cjs.buildSeedanceVideoEditPrompt; }
 });
 Object.defineProperty(exports, "buildSurroundFillPrompt", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.buildSurroundFillPrompt; }
+  get: function () { return chunkEKRO42T3_cjs.buildSurroundFillPrompt; }
 });
 Object.defineProperty(exports, "composeSoundHintFromConnections", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.composeSoundHintFromConnections; }
+  get: function () { return chunkEKRO42T3_cjs.composeSoundHintFromConnections; }
 });
 Object.defineProperty(exports, "composeVideoPromptText", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.composeVideoPromptText; }
+  get: function () { return chunkEKRO42T3_cjs.composeVideoPromptText; }
 });
 Object.defineProperty(exports, "getEffectiveSunoCustomMode", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.getEffectiveSunoCustomMode; }
+  get: function () { return chunkEKRO42T3_cjs.getEffectiveSunoCustomMode; }
 });
 Object.defineProperty(exports, "identityRefsSentence", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.identityRefsSentence; }
+  get: function () { return chunkEKRO42T3_cjs.identityRefsSentence; }
 });
 Object.defineProperty(exports, "imageBindingFor", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.imageBindingFor; }
+  get: function () { return chunkEKRO42T3_cjs.imageBindingFor; }
 });
 Object.defineProperty(exports, "placeFramesAfterReferences", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.placeFramesAfterReferences; }
+  get: function () { return chunkEKRO42T3_cjs.placeFramesAfterReferences; }
 });
 Object.defineProperty(exports, "planFrameDelivery", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.planFrameDelivery; }
+  get: function () { return chunkEKRO42T3_cjs.planFrameDelivery; }
 });
 Object.defineProperty(exports, "promptBindsFirstFrame", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.promptBindsFirstFrame; }
+  get: function () { return chunkEKRO42T3_cjs.promptBindsFirstFrame; }
 });
 Object.defineProperty(exports, "resolveGeminiOmniI2vInputs", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveGeminiOmniI2vInputs; }
+  get: function () { return chunkEKRO42T3_cjs.resolveGeminiOmniI2vInputs; }
 });
 Object.defineProperty(exports, "resolveRefIdTokens", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveRefIdTokens; }
+  get: function () { return chunkEKRO42T3_cjs.resolveRefIdTokens; }
 });
 Object.defineProperty(exports, "resolveReferenceTokens", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveReferenceTokens; }
+  get: function () { return chunkEKRO42T3_cjs.resolveReferenceTokens; }
 });
 Object.defineProperty(exports, "resolveSeedance2Inputs", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveSeedance2Inputs; }
+  get: function () { return chunkEKRO42T3_cjs.resolveSeedance2Inputs; }
 });
 Object.defineProperty(exports, "resolveVeoI2vInputs", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveVeoI2vInputs; }
+  get: function () { return chunkEKRO42T3_cjs.resolveVeoI2vInputs; }
 });
 Object.defineProperty(exports, "resolveVideoReferenceCore", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.resolveVideoReferenceCore; }
+  get: function () { return chunkEKRO42T3_cjs.resolveVideoReferenceCore; }
 });
 Object.defineProperty(exports, "truncateForField", {
   enumerable: true,
-  get: function () { return chunkM6EXNY42_cjs.truncateForField; }
+  get: function () { return chunkEKRO42T3_cjs.truncateForField; }
 });
 Object.defineProperty(exports, "ANGLE_LABELS", {
   enumerable: true,
@@ -850,11 +850,11 @@ Object.defineProperty(exports, "withForcedIdentityLock", {
 });
 Object.defineProperty(exports, "RESTYLE_PREVIEWS", {
   enumerable: true,
-  get: function () { return chunkGJV7KTDX_cjs.RESTYLE_PREVIEWS; }
+  get: function () { return chunkTYRIHUID_cjs.RESTYLE_PREVIEWS; }
 });
 Object.defineProperty(exports, "restylePreviewStillUrl", {
   enumerable: true,
-  get: function () { return chunkGJV7KTDX_cjs.restylePreviewStillUrl; }
+  get: function () { return chunkTYRIHUID_cjs.restylePreviewStillUrl; }
 });
 Object.defineProperty(exports, "ALL_PICKER_WIRING", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 export { P as PICKER_CATALOGS, a as PickerCatalog, b as PickerCatalogDetail, c as PickerCatalogSummary, d as PickerDimension, e as PickerOption, f as ProjectPickerCatalogOptions, g as ProjectedPickerCatalog, h as ProjectedPickerDimension, i as ProjectedPickerOption, j as getPickerCatalog, k as getRegisteredPickerCatalogs, l as listPickerCatalogs, p as projectAllCatalogs, m as projectPickerCatalog, s as summarizePickerCatalogs } from './picker-catalogs-DzLCu6qQ.cjs';
-export { AssembleImageInput, AssembleImageResult, AssembleSunoInput, AssembleSunoResult, CharacterMeta, FrameDeliveryPlan, FrameDeliveryPlanArgs, FrameReferenceSlotsArgs, FrameReferenceSlotsResult, GeminiOmniI2vInputsArgs, GeminiOmniI2vInputsResult, ImageBinding, REF_BINDING, RefIdTokenContext, ReferenceCounts, ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, Seedance2InputsArgs, Seedance2InputsResult, Seedance2Mode, SoundComposition, SoundCompositionFields, SoundConsumerType, VeoI2vInputsArgs, VeoI2vInputsResult, VideoExtraRef, VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField } from './entries/assembly.cjs';
+export { AssembleImageInput, AssembleImageResult, AssembleSunoInput, AssembleSunoResult, CharacterMeta, FrameDeliveryPlan, FrameDeliveryPlanArgs, FrameReferenceSlotsArgs, FrameReferenceSlotsResult, GeminiOmniI2vInputsArgs, GeminiOmniI2vInputsResult, ImageBinding, ImageReferenceSyntax, REF_BINDING, RefIdTokenContext, ReferenceCounts, ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, Seedance2InputsArgs, Seedance2InputsResult, Seedance2Mode, SoundComposition, SoundCompositionFields, SoundConsumerType, VeoI2vInputsArgs, VeoI2vInputsResult, VideoExtraRef, VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField } from './entries/assembly.cjs';
 export { P as PickerHintMode, S as SuspiciousTermOptions, T as TERM_MAX_CHARS, a as TermCarrier, d as deriveTerm, i as isSuspiciousDerivedTerm, r as resolveTerm } from './term-C01_g6s1.cjs';
 export { C as CatalogPack, a as CatalogPackMode, P as PickerCatalogInput, b as PickerDimensionInput, c as PickerOptionInput, d as catalogPacksVersion, e as composePickerCatalogs, g as getRegisteredCatalogPacks, h as hasCatalogPacksFor, r as registerCatalogPack, f as resetCatalogPacks, s as subscribeCatalogPacks } from './catalog-packs-DeMcSVCR.cjs';
 export { SidecarCoverageReport, computePackSidecarCoverage } from './entries/catalog-packs.cjs';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { P as PICKER_CATALOGS, a as PickerCatalog, b as PickerCatalogDetail, c as PickerCatalogSummary, d as PickerDimension, e as PickerOption, f as ProjectPickerCatalogOptions, g as ProjectedPickerCatalog, h as ProjectedPickerDimension, i as ProjectedPickerOption, j as getPickerCatalog, k as getRegisteredPickerCatalogs, l as listPickerCatalogs, p as projectAllCatalogs, m as projectPickerCatalog, s as summarizePickerCatalogs } from './picker-catalogs-SDSWrufc.js';
-export { AssembleImageInput, AssembleImageResult, AssembleSunoInput, AssembleSunoResult, CharacterMeta, FrameDeliveryPlan, FrameDeliveryPlanArgs, FrameReferenceSlotsArgs, FrameReferenceSlotsResult, GeminiOmniI2vInputsArgs, GeminiOmniI2vInputsResult, ImageBinding, REF_BINDING, RefIdTokenContext, ReferenceCounts, ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, Seedance2InputsArgs, Seedance2InputsResult, Seedance2Mode, SoundComposition, SoundCompositionFields, SoundConsumerType, VeoI2vInputsArgs, VeoI2vInputsResult, VideoExtraRef, VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField } from './entries/assembly.js';
+export { AssembleImageInput, AssembleImageResult, AssembleSunoInput, AssembleSunoResult, CharacterMeta, FrameDeliveryPlan, FrameDeliveryPlanArgs, FrameReferenceSlotsArgs, FrameReferenceSlotsResult, GeminiOmniI2vInputsArgs, GeminiOmniI2vInputsResult, ImageBinding, ImageReferenceSyntax, REF_BINDING, RefIdTokenContext, ReferenceCounts, ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, Seedance2InputsArgs, Seedance2InputsResult, Seedance2Mode, SoundComposition, SoundCompositionFields, SoundConsumerType, VeoI2vInputsArgs, VeoI2vInputsResult, VideoExtraRef, VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField } from './entries/assembly.js';
 export { P as PickerHintMode, S as SuspiciousTermOptions, T as TERM_MAX_CHARS, a as TermCarrier, d as deriveTerm, i as isSuspiciousDerivedTerm, r as resolveTerm } from './term-C01_g6s1.js';
 export { C as CatalogPack, a as CatalogPackMode, P as PickerCatalogInput, b as PickerDimensionInput, c as PickerOptionInput, d as catalogPacksVersion, e as composePickerCatalogs, g as getRegisteredCatalogPacks, h as hasCatalogPacksFor, r as registerCatalogPack, f as resetCatalogPacks, s as subscribeCatalogPacks } from './catalog-packs-DjqvicAR.js';
 export { SidecarCoverageReport, computePackSidecarCoverage } from './entries/catalog-packs.js';

package/dist/index.js

@@ -2,7 +2,7 @@ export { BODY_CAPTIONS_PRESET_ID, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_
 export { readDirectionFields, readStructuredFields, readSubjectFields } from './chunk-ZRORO6OM.js';
 export { TEXT_REQUIRED_NODE_TYPES, WIRED_OUTPUT_NODE_TYPES, computeAiWriterInput, computeNodeSendText, stripAudioTags } from './chunk-YS6HOWMW.js';
 export { NODE_PROMPT_CANDIDATE_FIELDS, NODE_PROMPT_FIELDS, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, applyPromptAffixes, composeNegative, computeLlmChatFields, computeNodePrompt, computeScriptTopic, getPromptFields, getSnippetMedia, joinPromptParts, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, promptAffixCoreField, promptFieldCarriesAffixes, promptPartSeparator, resolvePrompt } from './chunk-N6VMPG5S.js';
-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 } from './chunk-HETYHGGW.js';
+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 } from './chunk-XR7RAHZI.js';
 export { ANGLE_LABELS, ASPECT_RATIO_LABELS, MAX_SUBJECT_KEYS, MOVEMENT_LABELS, SCENE_PROMPT_MAX_LENGTH, SHOT_LABELS, STYLE_SECTION_GAP, STYLE_SECTION_HEADER, 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, appendReferenceLines, applyReferenceOrderToVideo, asBodyClauses, buildIdentityDirectives, buildImagePrompt, buildImagePromptSegments, buildImagePromptWithOverflow, buildReferenceBlocks, buildScenePrompt, composeSectionedPrompt, endsInsideStyleSection, expandImagePositionRefs, expandImageRefTokens, getRegisteredSubjectKeys, insertBeforeStyleSection, normalizeSubjectFields, partitionStyleClauses, referenceDescriptionLine, renderDescribedReferenceLines, renderReferenceCaptionLines, renderStructuredFields, renderStyleSection, renderSubjectHints, resolveCharacterMentions, resolveLocationMentions, sectionedClauseCosts, splitStyleSection, styleSectionFromClauses, styleSlotFor, subjectFieldsForSurface, truncateText } from './chunk-YAIPYPMM.js';
 import './chunk-GILUVQQJ.js';
 export { keepableDirectionHints } from './chunk-JZOPMVGY.js';
@@ -12,7 +12,7 @@ export { AD_CREATIVE_ANALYSIS_FIELDS, AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT, AUDIO_
 export { CINEMATIC_LOOK_TAIL, FILM_STILL_PREFIX, NEUTRAL_PERSON, REALISM_FINISH, REALISM_PASS_INSTRUCTION, REALISM_SKIN, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, SCENE_FRAME_RULE, filmStillPrefix, realismEmptyHands, realismViewpoint, referenceRulesBlock } from './chunk-T64D26P4.js';
 export { DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, applyTemplate, buildIdentityLockLine, characterLockToRefLock, collectIdentityLockClause, getIdentityLockClause, hasUpstreamCharacter, resolveTemplate, toIdentityLockMode, withForcedIdentityLock } from './chunk-BQWIPLLR.js';
 import './chunk-ADMHDFHB.js';
-export { RESTYLE_PREVIEWS, restylePreviewStillUrl } from './chunk-CDTEETF3.js';
+export { RESTYLE_PREVIEWS, restylePreviewStillUrl } from './chunk-RBRCJTDJ.js';
 export { ALL_PICKER_WIRING, ANALYZABLE_PICKER_TYPES, GAPS_SCHEMA, MULTI_PICKER_WIRING, PICKER_ANALYZER_FAMILIES, PICKER_ANALYZER_REGISTRY, PICKER_TYPES, SINGLE_PICKER_WIRING, __resetCatalogIdGuardForTests, applyPickerJson, buildMultiPickerAnalyzerSpec, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, catalogGuardActive, findForeignCatalogIds, findForeignCatalogIdsInBody, foreignCatalogIdMessage, getPickerAnalyzer, getPickerWiring, isAnalyzablePicker, pickerFanoutTargets } from './chunk-HOZPYHRA.js';
 export { ADULT_SWEPT_CATALOG_IDS, FLOORED_PICKER_KEYS, RETIRED_ADULT_ONLY_HINT_STRINGS, applyMinorAgeFloorToPickerValues, buildNeedleAlternationSource, containsMinorAgeHint, getAdultOnlyEntries, getAdultOnlyHintStrings, getAdultOnlyIds, getCharacterMotionBindings, getMinorAgeHintStrings, getParameterPromptHint } from './chunk-EUU5W7XR.js';
 export { DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, FILM_STYLE_KEYS, IMAGE_HINT_MODE_DEFAULT, USER_DIRECTION_REF_KINDS, VIDEO_HINT_MODE_DEFAULT, curatedAnimalPromptHint, curatedAnimalTerm, curatedFurnitureText, curatedVehicleText, curatedWeaponText, directionFieldsForSurface, directionKeyForUserRef, modeForFamily, nearestColorName, parseUserDirectionRef, renderDirectionHintClauses, renderDirectionHints, renderMoodboardClause, renderPaletteClause, styleReferenceDescription, userDirectionRefValue, userRefKindOfDirectionKey } from './chunk-VBCVQPQ4.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/prompts",
-  "version": "1.52.0",
+  "version": "1.53.1",
   "description": "Nodaro's prompt-engineering layer — person/picker catalogs with prompt hints, identity-lock clauses, entity prompt builders, brand presets, and prompt/reference assembly shared by the Nodaro platform and SDK.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",
@@ -70,7 +70,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@nodaro/shared": "^3.57.0"
+    "@nodaro/shared": "^3.59.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",

package/src/__tests__/frame-reference-slots.test.ts

@@ -30,6 +30,22 @@ describe("placeFramesAfterReferences", () => {
     )
   })
 
+  it("writes plain `image N` sentences that say what each image is", () => {
+    const start = placeFramesAfterReferences({ firstFrameUrl: "F", refImageUrls: R(2), imageCap: 6, syntax: "image N", bindIdentities: true })
+    expect(start.promptSuffix).toBe(
+      "image 3 is the opening (first) frame of the video. image 1 and image 2 are references for the subject; they are not frames.",
+    )
+    const both = placeFramesAfterReferences({ firstFrameUrl: "F", lastFrameUrl: "L", refImageUrls: R(3), imageCap: 6, syntax: "image N", bindIdentities: true })
+    expect(both.promptSuffix).toBe(
+      "image 4 is the opening (first) frame and image 5 is the closing (last) frame of the video. image 1, image 2 and image 3 are references for the subject; they are not frames.",
+    )
+    const one = placeFramesAfterReferences({ lastFrameUrl: "L", refImageUrls: R(1), imageCap: 6, syntax: "image N", bindIdentities: true })
+    expect(one.promptSuffix).toBe("image 2 is the closing (last) frame of the video. image 1 is a reference for the subject; it is not a frame.")
+    // Never the platform's `@image_N` duplicate check: a prompt carrying it is not this syntax's binding.
+    const prompted = placeFramesAfterReferences({ prompt: "use @image_2 as the first frame", firstFrameUrl: "F", refImageUrls: R(1), imageCap: 6, syntax: "image N" })
+    expect(prompted.promptSuffix).toBe("image 2 is the opening (first) frame of the video.")
+  })
+
   it("skips the opening sentence when the prompt already binds it (@image_N form)", () => {
     const r = placeFramesAfterReferences({ prompt: "use @image_2 as the first frame", firstFrameUrl: "F", refImageUrls: R(1), imageCap: 9 })
     expect(r.promptSuffix).toBe("")

package/src/frame-reference-slots.ts

@@ -1,4 +1,4 @@
-import { identityRefsSentence, imageBindingFor } from "./ref-binding.js"
+import { imageBindingFor, type ImageReferenceSyntax } from "./ref-binding.js"
 
 /**
  * WHERE A START / END FRAME GOES WHEN IT SHARES A MODEL'S REFERENCE LIST — the
@@ -29,7 +29,7 @@ export interface FrameReferenceSlotsArgs {
   /** The provider's image cap — frames and references together. */
   imageCap: number
   /** The provider's reference syntax (`videoProviderReferenceSyntax`). */
-  syntax?: "@image_N" | "@image(n)" | "[Image N]"
+  syntax?: ImageReferenceSyntax
   bindIdentities?: boolean
 }
 
@@ -65,14 +65,14 @@ export function placeFramesAfterReferences(args: FrameReferenceSlotsArgs): Frame
   if (promptBindsStart && firstFrameOrdinal > 0 && lastFrameOrdinal === 0) {
     // The prompt already binds the first frame at its own (working) position.
   } 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.`
+    frameSentence = binding.frames(firstFrameOrdinal, lastFrameOrdinal)
   } 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)
+    ? binding.identities(1, kept.length)
     : ""
   const promptSuffix = [frameSentence, identitySentence].filter(Boolean).join(" ")
   return { imageUrls, promptSuffix, droppedRefImages, firstFrameOrdinal, lastFrameOrdinal }

package/src/picker-art/restyle-previews.ts

@@ -45,6 +45,9 @@ export const RESTYLE_PREVIEWS: Readonly<Record<string, RestylePreview>> = {
   // Source shot: https://cdn.nodaro.ai/picker-renders/71d9ab7a-7396-48ff-8bc3-80454b0edd07.mp4
   // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/b11ab600-ec62-4cb6-82b4-b0006374164b.mp4
   "pop-art": { url: "https://cdn.nodaro.ai/picker-renders/0659dbe5-9dfe-45d8-9abd-6ccf88481dd8.mp4", stillAtSeconds: 7 },
+  // Source shot: https://cdn.nodaro.ai/picker-renders/f832aab2-5f30-48cc-81dd-e6a4b84128b3.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/67386080-e6f5-4fba-a7bc-cfb6de462804.mp4
+  "toy-figure-3d": { url: "https://cdn.nodaro.ai/picker-renders/eaebd242-7e53-4018-ba85-00673e2a9b2b.mp4", stillAtSeconds: 7 },
   // Source shot: https://cdn.nodaro.ai/picker-renders/789f4330-660b-42bd-8d11-6e638e8c7c88.mp4
   // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/10471107-b26a-42e9-a3a5-068a42436d3c.mp4
   watercolor: { url: "https://cdn.nodaro.ai/picker-renders/61a26588-d09a-4959-b677-ee8b32e3281a.mp4" },