@nodaro/prompts 1.7.2 → 1.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/prompts",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "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",

package/src/index.ts

@@ -68,3 +68,4 @@ export * from "./style-presets.js"
 export * from "./object-asset-presets.js"
 export * from "./factory-snippets/index.js"
 export * from "./picker-wiring.js"
+export * from "./surround-fill.js"

package/src/picker-wiring.ts

@@ -6,7 +6,7 @@
  * Pure data, no React. Extracted from the app's parameter-picker-registry so
  * THREE consumers share one definition and cannot drift:
  *   1. The app's community fallback registry (chip pickers, no rich previews).
- *   2. `@nodaroai/picker-ui`'s rich registry (attaches preview/Picker renderers).
+ *   2. `@nodaro/picker-ui`'s registry (attaches preview/Picker renderers).
  *   3. Nodaro Cine's builder panels.
  *
  * Renderers (preview components, multi-dim Picker components) deliberately do

package/src/provider-prompt-doctrine.ts

@@ -87,8 +87,7 @@ precise subject → action details → scene/environment → lighting & color to
 - More than 4 referenced people gets unstable: group people into composite images of ≤4 first (image generation), then reference those composites.
 - Repeated extension degrades quality: prefer high-definition reference assets and avoid stacking many continuations.
 
-**Auto-path formula (community-sourced enrichment — apiyi.com Seedance 2.0 prompt guide,
-higgsfield.ai 4K breakdown; captured 2026-08-09)**
+**Auto-path formula (community-sourced enrichment; captured 2026-08-09)**
 - Six steps IN ORDER, 60-100 words total (longer measurably degrades): Subject → Action → Environment → Camera → Style → Constraints.
 - ONE primary camera instruction per shot. Compound moves chain with "then": "camera slow tracking then subtle rise" — never two competing verbs. The 8 reliable camera types: push-in, pull-out, pan, tracking, orbit/arc, aerial, handheld, locked-off.
 - SEPARATE camera movement from subject movement — the single biggest quality lever: "The dancer spins slowly. Camera holds fixed framing." — never "spinning camera around a dancing person".

package/src/style-presets.ts

@@ -1,7 +1,7 @@
 import type { StyleDirectives } from "@nodaro/shared"
 
 /**
- * Style Gallery presets (north-star §6 ①).
+ * Style Gallery presets.
  *
  * Each preset is a named "look" the user picks at Start. Picking one sets the
  * pipeline's `style_directives`, which the Showrunner folds into the plan's

package/src/surround-fill.ts

@@ -0,0 +1,67 @@
+/**
+ * Surround continuation — the fill prompt.
+ *
+ * Prompt engineering, so it lives here and not in `@nodaro/shared`: that
+ * package is published to npm under Apache-2.0, where every release is an
+ * irrevocable grant. This package is never published (`"private": true`).
+ * `@nodaro/shared` keeps only the wire contract — the direction enum and the
+ * carried-fraction defaults the route Zod schema and the SDK input type need.
+ */
+import type { SurroundDirection } from "@nodaro/shared"
+
+/** Which edge of the NEW frame holds the carried pixels vs the painted region. */
+const EDGE: Record<SurroundDirection, { carried: string; painted: string }> = {
+  right: { carried: "left", painted: "right" },
+  left: { carried: "right", painted: "left" },
+  up: { carried: "bottom", painted: "top" },
+  down: { carried: "top", painted: "bottom" },
+}
+
+/** What a tilt must actually render (NOT a continuation of the landscape). */
+const TILT_SUBJECT: Record<"up" | "down", { word: string; subject: string; where: string }> = {
+  up: {
+    word: "up",
+    subject: "the open sky directly overhead — sky, clouds, or (for an interior) the canopy or ceiling",
+    where: "overhead",
+  },
+  down: {
+    word: "down",
+    subject: "the ground directly below — terrain, floor, or water surface",
+    where: "below",
+  },
+}
+
+/**
+ * Build the fill prompt the model receives alongside the half-carry composite.
+ *
+ * `userPrompt` (an optional scene hint from the caller) is woven in front. PAN
+ * directions get the seamless-continuation prompt (with the anti-golden-hour
+ * negative that fights the documented warm-regrade drift). TILT directions get a
+ * subject-forcing prompt — render the sky / ground overhead / below, explicitly
+ * NOT a mirrored landscape — which is what stops the vertical echo.
+ */
+export function buildSurroundFillPrompt(direction: SurroundDirection, userPrompt?: string): string {
+  const scene = userPrompt && userPrompt.trim() ? `${userPrompt.trim()}. ` : ""
+  const { carried, painted } = EDGE[direction]
+
+  if (direction === "up" || direction === "down") {
+    const t = TILT_SUBJECT[direction]
+    return (
+      `${scene}` +
+      `This is a camera tilted straight ${t.word} from the same scene. The ${carried} strip holds real, finished pixels from the edge of the horizon view; the ${painted} region is flat gray and MUST be painted as ${t.subject}. ` +
+      `Render what is genuinely ${t.where} — do NOT repeat, mirror, or continue the landscape, and do NOT draw a horizon line or distant scenery in the painted region. ` +
+      `CRITICAL: keep the ${carried} strip unchanged and match the scene's EXACT lighting, time of day, white balance, and color grade — the same light as the ${carried} strip; no golden hour, no sunset, no warm relight, no cinematic regrade. ` +
+      `Blend smoothly into the ${carried} strip with no visible seam. No people, no text, no labels, no watermarks.`
+    )
+  }
+
+  // pan (right / left)
+  return (
+    `${scene}` +
+    `This is a partial frame: the ${carried} portion contains real, finished pixels and the ${painted} portion is flat gray that MUST be painted in. ` +
+    `Paint ONLY the ${painted} gray region as a natural, seamless continuation of the ${carried} portion — same scene, same perspective, continuing the horizon, geometry, and content across the boundary with no break. ` +
+    `Keep the ${carried} portion completely unchanged. ` +
+    `CRITICAL: do NOT change the lighting, exposure, white balance, or time of day. Match the ${carried} portion's EXACT light, color temperature, and contrast across the whole frame — if it is flat overcast daylight, keep flat overcast daylight. No golden hour, no sunset, no warm relight, no cinematic regrade. ` +
+    `The seam between the ${carried} and ${painted} portions must be invisible. No people, no text, no labels, no watermarks.`
+  )
+}