@nodaro/prompts 1.52.0 → 1.53.0

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/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');
@@ -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,

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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/prompts",
-  "version": "1.52.0",
+  "version": "1.53.0",
   "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.58.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/ref-binding.ts

@@ -48,24 +48,61 @@ export const REF_BINDING = {
     `Use @image_${n} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`,
 } as const
 
-/** 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). */
+export type ImageReferenceSyntax = "@image_N" | "@image(n)" | "[Image N]" | "image N"
+
+/** The binding sentences — frames and identity references — in one provider syntax. */
 export 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
+}
+
+const roleWords = (role: "opening" | "closing") => `${role} (${role === "opening" ? "first" : "last"})`
+
+/** "image 1", "image 1 and image 2", "image 1, image 2 and image 3". */
+function plainList(first: number, last: number): string {
+  const names = Array.from({ length: last - first + 1 }, (_, i) => `image ${first + i}`)
+  return names.length === 1 ? names[0] : `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`
 }
 
 /**
  * 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.
  */
-export function imageBindingFor(syntax: "@image_N" | "@image(n)" | "[Image N]"): ImageBinding {
-  if (syntax === "@image_N") return { ordinal: REF_BINDING.ordinal, frame: REF_BINDING.frame }
-  const ordinal = syntax === "@image(n)" ? (n: number) => `@image(${n})` : (n: number) => `[Image ${n}]`
+export function imageBindingFor(syntax: ImageReferenceSyntax): ImageBinding {
+  if (syntax === "image N") {
+    return {
+      ordinal: (n) => `image ${n}`,
+      frame: (n, role) => `image ${n} is the ${roleWords(role)} frame of the video.`,
+      frames: (first, last) => `image ${first} is the ${roleWords("opening")} frame and image ${last} is the ${roleWords("closing")} frame of the video.`,
+      identities: (first, last) => first === last
+        ? `image ${first} is a reference for the subject; it is not a frame.`
+        : `${plainList(first, last)} are references for the subject; they are not frames.`,
+    }
+  }
+  const ordinal = syntax === "@image_N"
+    ? REF_BINDING.ordinal
+    : syntax === "@image(n)" ? (n: number) => `@image(${n})` : (n: number) => `[Image ${n}]`
   return {
     ordinal,
-    frame: (n, role) => `Use ${ordinal(n)} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`,
+    frame: syntax === "@image_N" ? REF_BINDING.frame : (n, role) => `Use ${ordinal(n)} as the ${roleWords(role)} frame of the video.`,
+    frames: (first, last) => `Use ${ordinal(first)} as the ${roleWords("opening")} frame and ${ordinal(last)} as the ${roleWords("closing")} frame of the video.`,
+    identities: (first, last) => identityRefsSentence(first, last, ordinal),
   }
 }
 

package/src/video-reference-resolver.ts

@@ -54,7 +54,7 @@ import { tidyReferenceTokenGaps, unboundReferenceTokenText } from "./unbound-ref
 // The binding surface string and the id-addressed token resolver live in their
 // own modules (see them for the contracts); re-exported here so every existing
 // importer of this module — and the package index's `export *` — keeps working.
-export { REF_BINDING, identityRefsSentence, imageBindingFor, SEEDANCE_VIDEO_EDIT_PREFIX, buildSeedanceVideoEditPrompt, type ImageBinding } from "./ref-binding.js"
+export { REF_BINDING, identityRefsSentence, imageBindingFor, SEEDANCE_VIDEO_EDIT_PREFIX, buildSeedanceVideoEditPrompt, type ImageBinding, type ImageReferenceSyntax } from "./ref-binding.js"
 export { resolveRefIdTokens, type RefIdTokenContext } from "./ref-id-tokens.js"