@nodaro/prompts 1.17.1 → 1.18.0

package/dist/index.cjs

@@ -29071,6 +29071,107 @@ var IMAGE_REFERENCE_PROMPT_DOCTRINE = {
 - Person+face composition intermittently trips provider content filters ("Content policy violation"). Keep wording neutral (no glamor/body emphasis), and on a rejection rephrase the glue words or swap provider rather than retrying unchanged.`
 };
 
+// src/scene3d-reference-doctrine.ts
+var SCENE3D_LAYOUT_SCOPING_MARKER = "LAYOUT reference only";
+var SCENE3D_LAYOUT_SCOPING_FOR = {
+  /** Always: where the subjects are and what is in front of what. */
+  layout: "its subject positions and blocking",
+  occlusion: "its foreground occlusion",
+  framing: "its framing",
+  cameraAngle: "its camera angle",
+  /** Clips only. */
+  cameraMotion: "its camera motion",
+  timing: "its timing",
+  /** Clips with more than one shot. */
+  cuts: (shots) => `its ${shots} shots and where they cut`
+};
+var SCENE3D_LAYOUT_SCOPING_IGNORE = "Ignore its untextured grey clay placeholder look, its flat placeholder colours, its materials, its lighting and its empty background; none of that is the target look";
+var SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE = "Take the look from the prompt and from the other references";
+function buildScene3DLayoutScopingLine(spec) {
+  const matches = [
+    SCENE3D_LAYOUT_SCOPING_FOR.layout,
+    SCENE3D_LAYOUT_SCOPING_FOR.occlusion,
+    SCENE3D_LAYOUT_SCOPING_FOR.framing,
+    SCENE3D_LAYOUT_SCOPING_FOR.cameraAngle
+  ];
+  if (spec.carries === "clip") {
+    if (spec.includesCameraMotion) matches.push(SCENE3D_LAYOUT_SCOPING_FOR.cameraMotion);
+    if (typeof spec.shots === "number" && Number.isFinite(spec.shots) && spec.shots > 1) {
+      matches.push(SCENE3D_LAYOUT_SCOPING_FOR.cuts(Math.floor(spec.shots)));
+    }
+    matches.push(SCENE3D_LAYOUT_SCOPING_FOR.timing);
+  }
+  return `${SCENE3D_LAYOUT_SCOPING_MARKER} \u2014 match ${joinWithAnd(matches)}. ${SCENE3D_LAYOUT_SCOPING_IGNORE}. ${SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE}`;
+}
+function joinWithAnd(parts) {
+  if (parts.length <= 1) return parts[0] ?? "";
+  return `${parts.slice(0, -1).join(", ")} and ${parts[parts.length - 1]}`;
+}
+function renderScene3DLayoutScopingLine(binding, spec) {
+  return `${binding.trim()}: ${buildScene3DLayoutScopingLine(spec)}.`;
+}
+function hasScene3DLayoutScopingLine(prompt, binding) {
+  if (!prompt) return false;
+  const b = binding.trim().replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`${b}(?::| is an?)\\s+${SCENE3D_LAYOUT_SCOPING_MARKER}`).test(prompt);
+}
+var SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE = buildScene3DLayoutScopingLine({
+  carries: "clip",
+  includesCameraMotion: true
+});
+var SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE = {
+  clip: SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE,
+  clipRendered: renderScene3DLayoutScopingLine("@video_1", { carries: "clip", includesCameraMotion: true }),
+  clipWithCuts: buildScene3DLayoutScopingLine({ carries: "clip", shots: 4, includesCameraMotion: true }),
+  still: buildScene3DLayoutScopingLine({ carries: "still" }),
+  stillRendered: renderScene3DLayoutScopingLine("@image_1", { carries: "still" })
+};
+function scene3DLayoutVideoCaptions(seats, prompt) {
+  const clips = seats.filter((r) => r.carries === "clip" && !hasScene3DLayoutScopingLine(prompt, r.binding));
+  if (clips.length === 0) return void 0;
+  const captions = [];
+  for (const clip of clips) {
+    while (captions.length <= clip.index) captions.push("");
+    captions[clip.index] = buildScene3DLayoutScopingLine(clip.spec);
+  }
+  return captions;
+}
+function appendScene3DStillScopingLines(prompt, seats) {
+  const stills = seats.filter((r) => r.carries === "still" && !hasScene3DLayoutScopingLine(prompt, r.binding));
+  if (stills.length === 0) return prompt;
+  const lines = stills.map((still) => renderScene3DLayoutScopingLine(still.binding, still.spec));
+  return prompt ? `${prompt}
+${lines.join("\n")}` : lines.join("\n");
+}
+var SCENE3D_FIGURE_REFERENCE_RULE = "Every figure that must look real needs its own character reference; a figure without one takes the clay look of the layout reference. Keep two reference slots free for a location or style plate.";
+var SCENE3D_FREE_PLATE_SLOTS = 2;
+var SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE = "scene3d_unreferenced_figures";
+function buildScene3DUnreferencedFiguresWarning(check2) {
+  const figures = check2.figureCount;
+  if (figures === void 0 || !Number.isFinite(figures) || figures <= 0) return void 0;
+  const refs = Math.max(0, Math.floor(check2.characterReferenceCount));
+  const missing = Math.floor(figures) - refs;
+  if (missing <= 0) return void 0;
+  const figureWord = figures === 1 ? "figure" : "figures";
+  const refWord = refs === 1 ? "character reference is" : "character references are";
+  let message = `The layout reference shows ${figures} ${figureWord} but ${refs} ${refWord} attached. A figure without its own character reference takes the clay look of the layout reference. Attach one character reference per figure (${missing} more)`;
+  const cap = check2.imageReferenceCap;
+  if (typeof cap === "number" && Number.isFinite(cap) && cap > 0) {
+    const seats = Math.max(0, Math.floor(check2.layoutReferenceImageSeats ?? 0));
+    const spare = cap - seats - figures;
+    message += spare >= SCENE3D_FREE_PLATE_SLOTS ? `; this model takes ${cap} image references, which leaves ${spare} for a location or style plate.` : `; this model takes ${cap} image references, so one per figure plus ${SCENE3D_FREE_PLATE_SLOTS} free slots for a location or style plate does not fit \u2014 reference the figures that matter most first.`;
+  } else {
+    message += ".";
+  }
+  return {
+    code: SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE,
+    message,
+    figureCount: figures,
+    characterReferenceCount: refs,
+    missing
+  };
+}
+
 // src/prompt-wizard-categories.ts
 var IMAGE_WIZARD_CATEGORIES = [
   { key: "subject", label: "Subject" },
@@ -29162,6 +29263,8 @@ var PROVIDER_CAPABILITIES = {
     "nano-banana-2-lite": "Fast, low-cost 1K generation for drafts and iteration",
     "gpt-image": "Creative concepts, illustration, variable quality tiers",
     "gpt-image-2": "Latest GPT Image \u2014 sharp text, photorealism, 1K/2K/4K resolution",
+    "gpt-image-2-5-flare": "Fast everyday GPT Image 2.5 \u2014 higher quality than GPT Image 2 at ~half the latency; default for iteration, social, high volume",
+    "gpt-image-2-5-sunburst": "Precision GPT Image 2.5 \u2014 slower, tighter control and detail fidelity; brand-sensitive, packaging, diagrams, final creative",
     "grok": "General purpose, good text understanding",
     "grok-2": "Grok Imagine 2 \u2014 expressive, high-contrast, stylized output",
     "imagen4": "Google's latest, strong photorealism and text rendering",
@@ -29187,6 +29290,8 @@ var PROVIDER_CAPABILITIES = {
     "flux-pro-i2i": "Premium Flux transformation",
     "gpt-image-i2i": "Creative reinterpretation of source images",
     "gpt-image-2-i2i": "Latest GPT Image \u2014 pixel-level edits with original lighting/texture preservation, up to 4K",
+    "gpt-image-2-5-flare-i2i": "Fast GPT Image 2.5 edits \u2014 up to 16 sources; use while iterating",
+    "gpt-image-2-5-sunburst-i2i": "Precision GPT Image 2.5 edits \u2014 up to 16 sources, tightest control on demanding retouches; slower",
     "ideogram-edit": "Instruction-based editing with text preservation",
     "ideogram-remix": "Style remixing while preserving structure",
     "ideogram-reframe": "Aspect ratio changes with AI fill",
@@ -29210,6 +29315,8 @@ var PROVIDER_CAPABILITIES = {
     "flux-pro-i2i": "Premium Flux transformation",
     "gpt-image-i2i": "Creative reinterpretation of source images",
     "gpt-image-2-i2i": "Latest GPT Image \u2014 pixel-level edits with original lighting/texture preservation, up to 4K",
+    "gpt-image-2-5-flare-i2i": "Fast GPT Image 2.5 edits \u2014 up to 16 sources; use while iterating",
+    "gpt-image-2-5-sunburst-i2i": "Precision GPT Image 2.5 edits \u2014 up to 16 sources, tightest control on demanding retouches; slower",
     "ideogram-edit": "Instruction-based editing with text preservation",
     "ideogram-remix": "Style remixing while preserving structure",
     "ideogram-reframe": "Aspect ratio changes with AI fill",
@@ -29481,6 +29588,7 @@ var NODE_PROMPT_FIELDS = {
   // ── Composition / FX (compact, no media-result preview → no inline editor) ──
   "image-critic": { prompt: "prompt", promptLabel: "Criteria", media: "image", inline: false },
   "motion-graphics": { prompt: "motionPrompt", promptLabel: "Motion prompt", media: "video", inline: false },
+  "pro-3d-render": { prompt: "scenePrompt", promptLabel: "Scene", media: "text", inline: false },
   "generate-3d-scene": { prompt: "scenePrompt", promptLabel: "Scene", media: "text", inline: false },
   "edit-3d-scene": { prompt: "editPrompt", promptLabel: "Edit instruction", media: "text", inline: false },
   "3d-title": { prompt: "titlePrompt", promptLabel: "Title", media: "text", inline: false },
@@ -34931,6 +35039,15 @@ exports.REF_BINDING = REF_BINDING;
 exports.RENDER_QUALITIES = RENDER_QUALITIES;
 exports.RENDER_QUALITY_IDS = RENDER_QUALITY_IDS;
 exports.RETIRED_ADULT_ONLY_HINT_STRINGS = RETIRED_ADULT_ONLY_HINT_STRINGS;
+exports.SCENE3D_FIGURE_REFERENCE_RULE = SCENE3D_FIGURE_REFERENCE_RULE;
+exports.SCENE3D_FREE_PLATE_SLOTS = SCENE3D_FREE_PLATE_SLOTS;
+exports.SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE = SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE;
+exports.SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE = SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE;
+exports.SCENE3D_LAYOUT_SCOPING_FOR = SCENE3D_LAYOUT_SCOPING_FOR;
+exports.SCENE3D_LAYOUT_SCOPING_IGNORE = SCENE3D_LAYOUT_SCOPING_IGNORE;
+exports.SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE = SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE;
+exports.SCENE3D_LAYOUT_SCOPING_MARKER = SCENE3D_LAYOUT_SCOPING_MARKER;
+exports.SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE = SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE;
 exports.SCENE_FRAME_RULE = SCENE_FRAME_RULE;
 exports.SCENE_PROMPT_MAX_LENGTH = SCENE_PROMPT_MAX_LENGTH;
 exports.SETTINGS = SETTINGS;
@@ -34995,6 +35112,7 @@ exports.__resetCatalogIdGuardForTests = __resetCatalogIdGuardForTests;
 exports.appendField = appendField;
 exports.appendMusicMeta = appendMusicMeta;
 exports.appendReferenceLines = appendReferenceLines;
+exports.appendScene3DStillScopingLines = appendScene3DStillScopingLines;
 exports.applyMinorAgeFloorToPickerValues = applyMinorAgeFloorToPickerValues;
 exports.applyPickerJson = applyPickerJson;
 exports.applyPromptAffixes = applyPromptAffixes;
@@ -35056,6 +35174,8 @@ exports.buildPoseTerms = buildPoseTerms;
 exports.buildPostProcessHints = buildPostProcessHints;
 exports.buildPostProcessTerms = buildPostProcessTerms;
 exports.buildReferenceBlocks = buildReferenceBlocks;
+exports.buildScene3DLayoutScopingLine = buildScene3DLayoutScopingLine;
+exports.buildScene3DUnreferencedFiguresWarning = buildScene3DUnreferencedFiguresWarning;
 exports.buildScenePrompt = buildScenePrompt;
 exports.buildStylingHints = buildStylingHints;
 exports.buildStylingTerms = buildStylingTerms;
@@ -35288,6 +35408,7 @@ exports.getWardrobeEntry = getWardrobeEntry;
 exports.getWardrobePromptHint = getWardrobePromptHint;
 exports.groupFactoryPresets = groupFactoryPresets;
 exports.hasCatalogPacksFor = hasCatalogPacksFor;
+exports.hasScene3DLayoutScopingLine = hasScene3DLayoutScopingLine;
 exports.hasUpstreamCharacter = hasUpstreamCharacter;
 exports.identityRefsSentence = identityRefsSentence;
 exports.insertBeforeStyleSection = insertBeforeStyleSection;
@@ -35329,6 +35450,7 @@ exports.renderDescribedReferenceLines = renderDescribedReferenceLines;
 exports.renderDirectionHintClauses = renderDirectionHintClauses;
 exports.renderDirectionHints = renderDirectionHints;
 exports.renderReferenceCaptionLines = renderReferenceCaptionLines;
+exports.renderScene3DLayoutScopingLine = renderScene3DLayoutScopingLine;
 exports.renderStructuredFields = renderStructuredFields;
 exports.renderStyleSection = renderStyleSection;
 exports.renderSubjectHints = renderSubjectHints;
@@ -35346,6 +35468,7 @@ exports.resolveTemplate = resolveTemplate;
 exports.resolveTerm = resolveTerm;
 exports.resolveVeoI2vInputs = resolveVeoI2vInputs;
 exports.resolveVideoReferenceCore = resolveVideoReferenceCore;
+exports.scene3DLayoutVideoCaptions = scene3DLayoutVideoCaptions;
 exports.sectionedClauseCosts = sectionedClauseCosts;
 exports.setComposedCatalogResolver = setComposedCatalogResolver;
 exports.splitStyleSection = splitStyleSection;