@nodaro/prompts 1.17.2 → 1.19.0

package/dist/index.cjs

@@ -4246,6 +4246,21 @@ function buildTemporalTerms(data) {
   return collectTemporalFragments(data, getTemporalTerm);
 }
 
+// src/hint-join.ts
+var ENDS_SENTENCE = /[.!?]$/;
+function joinHintFragments(fragments) {
+  let out = "";
+  for (const fragment of fragments) {
+    if (!fragment) continue;
+    if (!out) {
+      out = fragment;
+      continue;
+    }
+    out += ENDS_SENTENCE.test(out) ? ` ${fragment}` : `, ${fragment}`;
+  }
+  return out;
+}
+
 // src/camera-motions.ts
 var CAMERA_MOTIONS = [
   // Basic
@@ -4286,28 +4301,28 @@ var CAMERA_MOTIONS = [
     label: "Pan Left",
     category: "pan",
     description: "Rotate camera horizontally to the left",
-    promptHint: "slow camera pan left, rotating horizontally"
+    promptHint: "The camera stays in exactly the same position and slowly pivots on the spot, rotating its aim to the left like a head turning, sweeping across the scene.\nThe camera does not travel anywhere: its position, its height and its distance to everything in the scene all stay constant, and only its aiming direction changes.\nBecause the camera is rotating rather than moving, there is no parallax at all: near and distant elements slide across the frame together at the same rate, from left to right, with no shift between them.\nThe subject drifts out toward the right edge of the frame as the camera turns away, and new parts of the scene enter from the left.\nNo zoom, no push-in, no sideways travel, no orbiting."
   },
   {
     id: "pan-right",
     label: "Pan Right",
     category: "pan",
     description: "Rotate camera horizontally to the right",
-    promptHint: "slow camera pan right, rotating horizontally"
+    promptHint: "The camera stays in exactly the same position and slowly pivots on the spot, rotating its aim to the right like a head turning, sweeping across the scene.\nThe camera does not travel anywhere: its position, its height and its distance to everything in the scene all stay constant, and only its aiming direction changes.\nBecause the camera is rotating rather than moving, there is no parallax at all: near and distant elements slide across the frame together at the same rate, from right to left, with no shift between them.\nThe subject drifts out toward the left edge of the frame as the camera turns away, and new parts of the scene enter from the right.\nNo zoom, no push-in, no sideways travel, no orbiting."
   },
   {
     id: "whip-pan-left",
     label: "Whip Pan Left",
     category: "pan",
     description: "Fast whip pan left with motion blur",
-    promptHint: "fast whip pan to the left with heavy motion blur"
+    promptHint: "The camera stays in exactly the same position and whips violently fast on the spot, snapping its aim to the left in one abrupt blurred sweep across the scene.\nThe camera does not travel anywhere: its position, its height and its distance to everything in the scene all stay constant, and only its aiming direction changes.\nThe rotation is so fast that the whole frame smears into heavy horizontal motion blur and the scene becomes briefly unreadable mid-sweep.\nBecause the camera is rotating rather than moving, there is no parallax at all: near and distant elements streak across the frame together at the same rate, from left to right.\nThe subject is flung out past the right edge of the frame almost immediately.\nNo zoom, no push-in, no sideways travel, no orbiting."
   },
   {
     id: "whip-pan-right",
     label: "Whip Pan Right",
     category: "pan",
     description: "Fast whip pan right with motion blur",
-    promptHint: "fast whip pan to the right with heavy motion blur"
+    promptHint: "The camera stays in exactly the same position and whips violently fast on the spot, snapping its aim to the right in one abrupt blurred sweep across the scene.\nThe camera does not travel anywhere: its position, its height and its distance to everything in the scene all stay constant, and only its aiming direction changes.\nThe rotation is so fast that the whole frame smears into heavy horizontal motion blur and the scene becomes briefly unreadable mid-sweep.\nBecause the camera is rotating rather than moving, there is no parallax at all: near and distant elements streak across the frame together at the same rate, from right to left.\nThe subject is flung out past the left edge of the frame almost immediately.\nNo zoom, no push-in, no sideways travel, no orbiting."
   },
   // Tilt — rotation on horizontal axis
   {
@@ -4315,14 +4330,14 @@ var CAMERA_MOTIONS = [
     label: "Tilt Up",
     category: "tilt",
     description: "Tilt camera upward",
-    promptHint: "camera tilts upward, revealing upward from the ground"
+    promptHint: "The camera is locked to a tripod head at a fixed point in space and pivots on that head, tilting its aim upward like a head lifting to look higher.\nThe camera's height stays exactly the same for the entire shot, and the tripod stays planted in the same spot: the lens sweeps upward while the camera body itself never rises, never lowers and never travels.\nBecause the camera is rotating rather than moving, there is no parallax at all: near and distant elements slide down the frame together at the same rate, with no shift between them.\nWhatever occupied the bottom of the opening frame slides down and out past the bottom edge, and whatever lay above the top edge is progressively revealed as the aim rises.\nNo zoom, no push-in."
   },
   {
     id: "tilt-down",
     label: "Tilt Down",
     category: "tilt",
     description: "Tilt camera downward",
-    promptHint: "camera tilts downward, revealing downward from above"
+    promptHint: "The camera is locked to a tripod head at a fixed point in space and pivots on that head, tilting its aim downward like a head lowering to look lower.\nThe camera's height stays exactly the same for the entire shot, and the tripod stays planted in the same spot: the lens sweeps downward while the camera body itself never rises, never lowers and never travels.\nBecause the camera is rotating rather than moving, there is no parallax at all: near and distant elements slide up the frame together at the same rate, with no shift between them.\nWhatever occupied the top of the opening frame slides up and out past the top edge, and whatever lay below the bottom edge is progressively revealed as the aim lowers.\nNo zoom, no push-in."
   },
   // Zoom — lens only
   {
@@ -4330,28 +4345,28 @@ var CAMERA_MOTIONS = [
     label: "Zoom In",
     category: "zoom",
     description: "Lens zoom toward subject",
-    promptHint: "slow zoom in on the subject, fixed camera position"
+    promptHint: "The camera is locked to a tripod planted in one spot and never moves at all. Only the lens changes: its focal length slowly increases, magnifying the image so the frame closes in on the subject.\nBecause the camera body does not travel, the perspective of the scene never changes: there is NO parallax whatsoever, nothing slides past anything else, and the spatial relationship between near and distant elements stays exactly as it was.\nEverything in the frame simply grows larger together at the same rate and the edges of the picture crop away, as if the whole photograph were being enlarged from its centre.\nThe subject fills progressively more of the frame while the background behind it flattens and compresses.\nNo camera travel, no dolly, no push-in, no walking forward, no orbiting."
   },
   {
     id: "zoom-out",
     label: "Zoom Out",
     category: "zoom",
     description: "Lens zoom away from subject",
-    promptHint: "slow zoom out, fixed camera position"
+    promptHint: "The camera is locked to a tripod planted in one spot and never moves at all. Only the lens changes: its focal length slowly decreases, widening the view so the frame opens out away from the subject.\nBecause the camera body does not travel, the perspective of the scene never changes: there is NO parallax whatsoever, nothing slides past anything else, and the spatial relationship between near and distant elements stays exactly as it was.\nEverything in the frame simply shrinks together at the same rate and more of the surroundings enters from all four edges, as if the whole photograph were being reduced towards its centre.\nThe subject fills progressively less of the frame while more and more of the wider environment is revealed around it.\nNo camera travel, no dolly, no pull-back, no walking backward, no orbiting."
   },
   {
     id: "crash-zoom-in",
     label: "Crash Zoom In",
     category: "zoom",
     description: "Snappy whip-style zoom in",
-    promptHint: "fast crash zoom in, snappy whip-style sudden dramatic zoom toward subject"
+    promptHint: "The camera is locked to a tripod planted in one spot and never moves at all. Only the lens changes: its focal length rockets up in one violent instant, snapping the frame hard onto the subject.\nThe zoom is so abrupt that the image judders and smears with motion blur during the snap, and the magnification slams to a stop rather than easing in.\nBecause the camera body does not travel, the perspective of the scene never changes: there is NO parallax whatsoever, nothing slides past anything else, and the spatial relationship between near and distant elements stays exactly as it was.\nEverything in the frame simply explodes larger together at the same rate and the edges of the picture crop violently away, as if the photograph were being blown up from its centre in a single jolt.\nNo camera travel, no dolly, no push-in, no walking forward, no orbiting."
   },
   {
     id: "crash-zoom-out",
     label: "Crash Zoom Out",
     category: "zoom",
     description: "Snappy whip-style zoom out",
-    promptHint: "fast crash zoom out, snappy whip-style sudden dramatic pull back"
+    promptHint: "The camera is locked to a tripod planted in one spot and never moves at all. Only the lens changes: its focal length drops away in one violent instant, snapping the frame wide open away from the subject.\nThe zoom is so abrupt that the image judders and smears with motion blur during the snap, and the widening slams to a stop rather than easing out.\nBecause the camera body does not travel, the perspective of the scene never changes: there is NO parallax whatsoever, nothing slides past anything else, and the spatial relationship between near and distant elements stays exactly as it was.\nEverything in the frame simply collapses smaller together at the same rate and a great deal more of the surroundings floods in from all four edges at once, as if the photograph were being shrunk towards its centre in a single jolt.\nNo camera travel, no dolly, no pull-back, no walking backward, no orbiting."
   },
   // Dolly — physical forward/back
   {
@@ -4359,51 +4374,51 @@ var CAMERA_MOTIONS = [
     label: "Dolly In",
     category: "dolly",
     description: "Push camera toward subject (parallax)",
-    promptHint: "dolly in, camera pushes forward toward the subject with natural parallax"
+    promptHint: "The camera glides steadily FORWARD through the scene, physically travelling deeper into it and closing the distance to the subject. Nothing new is added to the scene; the viewpoint simply advances.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The image changes only because the camera has moved to a new place.\nThe gap between the camera and the subject SHRINKS continuously: the subject grows steadily larger in the frame as the camera gets closer, and by the end it is much nearer and much bigger than at the start.\nEVERY part of the scene is in motion together, all of it expanding outward from the centre of the frame as the viewpoint advances, and the only difference between them is how fast: the closer something is to the camera the faster it grows and spreads toward the edges, and the further away it is the more gently and slowly it grows. It is one smooth continuous gradient of speed across every depth in the picture. Nothing anywhere in the frame is frozen or static, and nothing slides forward independently of the rest.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no holding a constant distance, no following alongside."
   },
   {
     id: "dolly-out",
     label: "Dolly Out",
     category: "dolly",
     description: "Pull camera away (parallax)",
-    promptHint: "dolly out, camera pulls back away from the subject with natural parallax"
+    promptHint: "The camera glides steadily BACKWARD through the scene, physically retreating and opening up the distance to the subject. Nothing new is added to the scene; the viewpoint simply withdraws.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is shrunk optically. The image changes only because the camera has moved to a new place.\nThe gap between the camera and the subject GROWS continuously: the subject becomes steadily smaller in the frame as the camera pulls further away, and by the end it is much further off and much smaller than at the start.\nEVERY part of the scene is in motion together, all of it contracting inward toward the centre of the frame as the viewpoint retreats, and the only difference between them is how fast: the closer something is to the camera the faster it shrinks and slides in from the edges, and the further away it is the more gently and slowly it shrinks. It is one smooth continuous gradient of speed across every depth in the picture. Nothing anywhere in the frame is frozen or static, and nothing slides backward independently of the rest.\nNew foreground elements keep entering from behind the camera at the edges of the frame as it retreats.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no holding a constant distance, no following alongside."
   },
   {
     id: "dolly-zoom",
     label: "Dolly Zoom",
     category: "dolly",
     description: "Vertigo effect: dolly opposes zoom",
-    promptHint: "dolly zoom vertigo effect, background scale changes while subject stays the same size"
+    promptHint: "Two opposite things happen at once, in perfect balance, and the tension between them IS the shot.\nFIRST, the camera body travels steadily FORWARD, physically advancing deeper into the scene and closing the distance to the subject.\nSECOND, at exactly the same time and at exactly the matching rate, the lens widens: the focal length decreases continuously throughout the move.\nBecause the two exactly cancel each other, THE SUBJECT NEVER CHANGES SIZE. It stays locked at the same scale and the same position in the frame from the first moment to the last, as if pinned there, and nothing about it grows or shrinks.\nWhat changes instead is DEPTH. As the camera advances and the lens widens, everything behind the subject appears to travel away from it and settle further and further off, so the distance between the subject and the far background stretches open and keeps stretching. What was close behind the subject ends up looking far behind it. The space reads as progressively deeper and longer, as though it were being drawn out lengthwise, while the subject itself stays exactly as it was.\nThe frame stays perfectly upright and level throughout. The camera never rolls, never tilts, never turns; the horizontal and vertical lines of the scene stay horizontal and vertical the whole time.\nNo cuts, no sideways travel, no orbiting, no rolling, no rotation of the frame, no tilting, and above all no change in the size of the subject."
   },
   {
     id: "push-in",
     label: "Push In",
     category: "dolly",
-    description: "Slow subtle push toward subject",
-    promptHint: "slow push in, gentle forward movement toward the subject",
-    term: "slow push-in"
+    description: "Fast forceful push toward subject",
+    promptHint: "The camera surges FORWARD hard and fast, driving deep into the scene and closing the distance to the subject in one assertive rush. Nothing new is added to the scene; the viewpoint simply advances.\nThe move is quick and forceful enough to be felt: the picture takes on a slight motion blur as it rushes in, and the advance carries real momentum rather than drifting gently.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The image changes only because the camera has moved to a new place.\nThe gap between the camera and the subject SHRINKS rapidly: the subject swells quickly larger in the frame, and by the end it is far nearer and far bigger than at the start.\nEVERY part of the scene is in motion together, all of it expanding outward from the centre of the frame as the viewpoint advances, and the only difference between them is how fast: the closer something is to the camera the faster it grows and spreads toward the edges, and the further away it is the more gently and slowly it grows. It is one smooth continuous gradient of speed across every depth in the picture. Nothing anywhere in the frame is frozen or static, and nothing slides forward independently of the rest.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no holding a constant distance, no following alongside.",
+    term: "fast push-in"
   },
   {
     id: "pull-out",
     label: "Pull Out",
     category: "dolly",
-    description: "Slow subtle pull back from subject",
-    promptHint: "slow pull out, gentle backward movement away from the subject",
-    term: "slow pull-out"
+    description: "Fast forceful pull back from subject",
+    promptHint: "The camera pulls BACKWARD hard and fast, tearing away from the subject and opening up the distance in one decisive rush. Nothing new is added to the scene; the viewpoint simply withdraws.\nThe move is quick and forceful enough to be felt: the picture takes on a slight motion blur as it rushes back, and the retreat carries real momentum rather than drifting gently.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is shrunk optically. The image changes only because the camera has moved to a new place.\nThe gap between the camera and the subject GROWS rapidly: the subject shrinks quickly in the frame, and by the end it is far away and far smaller than at the start.\nEVERY part of the scene is in motion together, all of it contracting inward toward the centre of the frame as the viewpoint retreats, and the only difference between them is how fast: the closer something is to the camera the faster it shrinks and slides in from the edges, and the further away it is the more gently and slowly it shrinks. It is one smooth continuous gradient of speed across every depth in the picture. Nothing anywhere in the frame is frozen or static, and nothing slides backward independently of the rest.\nNew foreground elements keep entering from behind the camera at the edges of the frame as it retreats.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no holding a constant distance, no following alongside.",
+    term: "fast pull-out"
   },
   {
     id: "breathing",
     label: "Breathing Camera",
     category: "dolly",
     description: "Subtle continuous push/pull oscillation",
-    promptHint: "breathing camera, subtle continuous breathing-like push-in and pull-out oscillation with an organic handheld feel"
+    promptHint: "The camera breathes: it drifts gently FORWARD a small way, then eases back BACKWARD to about where it began, then forward again, in a slow continuous cycle that repeats several times across the shot, like the rise and fall of quiet breathing. Nothing new is added to the scene; only the viewpoint sways in and out.\nThis reversal is deliberate and is the whole point of the move. There is no pause and no hard stop at either end: the forward drift slows, turns over smoothly, and becomes the backward drift, then turns over again. The cycle is soft and rhythmic, never sharp.\nThe travel each way is small and the pace is slow and organic, never mechanical: the picture stays sharp with no motion blur, and it feels like a handheld operator quietly breathing behind the camera rather than a rig being driven.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The image changes only because the camera has swayed to a slightly different place.\nThe gap between the camera and the subject accordingly shrinks a little, then opens a little, then shrinks again: the subject swells and settles gently in the frame in time with the cycle.\nEVERY part of the scene moves together with it, all of it expanding outward from the centre on each drift forward and contracting inward on each drift back, and the only difference between them is how fast: what is closest sways most, what is furthest hardly changes. It is one smooth continuous gradient across every depth. Nothing anywhere is frozen or static.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no cuts."
   },
   {
     id: "push-pull",
     label: "Push-Pull / Swing",
     category: "dolly",
     description: "Camera swings toward subject then away",
-    promptHint: "push-pull swing, the camera moves toward the subject then back away in a single move, a swinging approach-and-retreat that creates emphasis or hesitation",
+    promptHint: "The camera drives decisively FORWARD a good distance, then reverses and pulls back BACKWARD past where it began, then drives forward again, in a deliberate push-and-pull cycle repeated across the shot. Nothing new is added to the scene; only the viewpoint swings in and out.\nThis reversal is deliberate and is the whole point of the move. Each stroke is firm and purposeful, with real travel behind it and a clear change of direction at each end, as if a rig were being driven in and hauled out again by hand. It is emphatic and mechanical, not gentle or organic, and the swing is far larger and more forceful than a quiet drift.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The image changes only because the camera has travelled to a different place.\nThe gap between the camera and the subject accordingly closes sharply, opens up wide, then closes again: the subject looms noticeably larger, falls well back, and looms again in time with the cycle.\nEVERY part of the scene moves together with it, all of it expanding outward from the centre on each drive forward and rushing inward on each pull back, and the only difference between them is how fast: what is closest sweeps most, what is furthest shifts least. It is one smooth continuous gradient across every depth. Nothing anywhere is frozen or static.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no cuts.",
     term: "push-pull swing"
   },
   {
@@ -4411,7 +4426,7 @@ var CAMERA_MOTIONS = [
     label: "Creep-In",
     category: "dolly",
     description: "Imperceptibly slow push-in over time",
-    promptHint: "creep-in, imperceptibly slow push-in over many seconds, building dread or tension",
+    promptHint: "The camera creeps FORWARD almost imperceptibly slowly, edging deeper into the scene by the smallest amount and closing the distance to the subject only very slightly. Nothing new is added to the scene; the viewpoint simply inches forward.\nThe move is so gradual it is barely noticeable moment to moment: the picture stays completely sharp with no motion blur at all, the advance never accelerates, and only by comparing the end against the beginning is it clear the camera moved at all. It creates a slow, quiet, unsettling drift rather than any sense of momentum.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The image changes only because the camera has crept to a slightly new place.\nThe gap between the camera and the subject SHRINKS very slightly and very steadily: the subject grows just a little larger in the frame across the whole shot.\nEVERY part of the scene is in motion together, all of it expanding outward from the centre of the frame by tiny degrees as the viewpoint edges forward, and the only difference between them is how fast: what is closest creeps outward most, what is furthest hardly changes at all. It is one smooth continuous gradient across every depth in the picture. Nothing anywhere is frozen or static, and nothing slides forward independently of the rest.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no acceleration, no holding a constant distance.",
     term: "slow creeping push-in"
   },
   {
@@ -4419,7 +4434,7 @@ var CAMERA_MOTIONS = [
     label: "Creep-Out",
     category: "dolly",
     description: "Imperceptibly slow pull-out over time",
-    promptHint: "creep-out, imperceptibly slow pull-out over many seconds, isolating the subject in space",
+    promptHint: "The camera creeps BACKWARD almost imperceptibly slowly, easing away from the scene by the smallest amount and opening the distance to the subject only very slightly. Nothing new is added to the scene; the viewpoint simply inches back.\nThe move is so gradual it is barely noticeable moment to moment: the picture stays completely sharp with no motion blur at all, the retreat never accelerates, and only by comparing the end against the beginning is it clear the camera moved at all. It creates a slow, quiet, unsettling drift rather than any sense of momentum.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is shrunk optically. The image changes only because the camera has crept to a slightly new place.\nThe gap between the camera and the subject GROWS very slightly and very steadily: the subject becomes just a little smaller in the frame across the whole shot.\nEVERY part of the scene is in motion together, all of it contracting inward toward the centre of the frame by tiny degrees as the viewpoint edges back, and the only difference between them is how fast: what is closest creeps inward most, what is furthest hardly changes at all. It is one smooth continuous gradient across every depth in the picture. Nothing anywhere is frozen or static, and nothing slides backward independently of the rest.\nNo zoom, no change of focal length, no sideways travel, no orbiting, no acceleration, no holding a constant distance.",
     term: "slow creeping pull-out"
   },
   // Truck — lateral slide
@@ -4428,14 +4443,14 @@ var CAMERA_MOTIONS = [
     label: "Truck Left",
     category: "truck",
     description: "Slide camera body laterally left",
-    promptHint: "truck left, camera slides laterally to the left"
+    promptHint: "The camera glides steadily SIDEWAYS to the left, physically travelling laterally across the scene while continuing to aim straight ahead in exactly the same direction the whole time. It never turns or pivots; its aim stays locked forward and only its position slides left.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The camera is passing across the scene, not approaching or retreating.\nThe framing is NOT locked onto anything: nothing is kept centred or held in place. EVERY single thing visible in the opening frame, including whatever sits at its very centre, slides steadily to the right across the picture and eventually passes out past the right edge as the viewpoint travels on past it.\nThe only difference between them is how fast: whatever is closest to the camera sweeps across and off the right edge quickly, things further back drift right more gently, and the most distant parts ease right slowest of all. It is one smooth continuous gradient of speed across every depth. Nothing anywhere is frozen, and nothing travels along with the camera.\nNew elements keep entering from the left edge as the camera advances sideways past them.\nNo zoom, no change of focal length, no turning, no pivoting, no rotation of the aim, no forward or backward travel, no tracking or following."
   },
   {
     id: "truck-right",
     label: "Truck Right",
     category: "truck",
     description: "Slide camera body laterally right",
-    promptHint: "truck right, camera slides laterally to the right"
+    promptHint: "The camera glides steadily SIDEWAYS to the right, physically travelling laterally across the scene while continuing to aim straight ahead in exactly the same direction the whole time. It never turns or pivots; its aim stays locked forward and only its position slides right.\nThe lens never changes: the focal length is fixed for the entire shot, so nothing is magnified. The camera is passing across the scene, not approaching or retreating.\nThe framing is NOT locked onto anything: nothing is kept centred or held in place. EVERY single thing visible in the opening frame, including whatever sits at its very centre, slides steadily to the left across the picture and eventually passes out past the left edge as the viewpoint travels on past it.\nThe only difference between them is how fast: whatever is closest to the camera sweeps across and off the left edge quickly, things further back drift left more gently, and the most distant parts ease left slowest of all. It is one smooth continuous gradient of speed across every depth. Nothing anywhere is frozen, and nothing travels along with the camera.\nNew elements keep entering from the right edge as the camera advances sideways past them.\nNo zoom, no change of focal length, no turning, no pivoting, no rotation of the aim, no forward or backward travel, no tracking or following."
   },
   // Pedestal — vertical slide
   {
@@ -4443,14 +4458,14 @@ var CAMERA_MOTIONS = [
     label: "Pedestal Up",
     category: "pedestal",
     description: "Raise camera body vertically",
-    promptHint: "pedestal up, camera rises vertically while keeping the horizon level"
+    promptHint: "The camera is mounted on a column that raises it straight UPWARD, and it rises vertically, climbing steadily higher. The scene itself is entirely unchanged; nothing in it moves, falls, appears or is added. Only the viewpoint ascends.\nThe camera's aim never changes: it keeps pointing straight ahead at exactly the same angle for the entire shot, perfectly level, never tipping up or down as it climbs. Only its height changes.\nThe lens never changes either: the focal length is fixed, so nothing is magnified.\nBecause the camera physically travels upward, there is STRONG parallax: EVERY part of the scene is in motion together, all of it sliding downward through the frame as the viewpoint climbs, and the only difference between them is how fast. What is nearest the camera sinks and passes out of the bottom edge quickly, what is further back drifts down more gently, and the most distant parts ease down slowest of all. It is one smooth continuous gradient of speed across every depth. Nothing anywhere in the frame is frozen or static.\nWhatever lay above the top edge of the opening frame is revealed as the camera reaches its height, entering from the top and settling into view.\nNo zoom, no change of focal length, no tilting, no tipping the aim upward, no forward or sideways travel."
   },
   {
     id: "pedestal-down",
     label: "Pedestal Down",
     category: "pedestal",
     description: "Lower camera body vertically",
-    promptHint: "pedestal down, camera descends vertically while keeping the horizon level"
+    promptHint: "The camera is mounted on a column that lowers it straight DOWNWARD, and it descends vertically, sinking steadily lower. The scene itself is entirely unchanged; nothing in it moves, falls, appears or is added. Only the viewpoint descends.\nThe camera's aim never changes: it keeps pointing straight ahead at exactly the same angle for the entire shot, perfectly level, never tipping up or down as it sinks. Only its height changes.\nThe lens never changes either: the focal length is fixed, so nothing is magnified.\nBecause the camera physically travels downward, there is STRONG parallax: EVERY part of the scene is in motion together, all of it sliding upward through the frame as the viewpoint sinks, and the only difference between them is how fast. What is nearest the camera climbs and passes out of the top edge quickly, what is further back drifts up more gently, and the most distant parts ease up slowest of all. It is one smooth continuous gradient of speed across every depth. Nothing anywhere in the frame is frozen or static.\nWhatever lay below the bottom edge of the opening frame is revealed as the camera sinks to its level, entering from the bottom and settling into view.\nNo zoom, no change of focal length, no tilting, no tipping the aim downward, no forward or sideways travel."
   },
   // Roll — rotation on lens axis
   {
@@ -4487,37 +4502,37 @@ var CAMERA_MOTIONS = [
     id: "orbit-left",
     label: "Orbit Left",
     category: "orbit",
-    description: "Full circle around subject to the left",
-    promptHint: "camera orbits around the subject to the left in a circular path"
+    description: "Large partial orbit around subject to the left",
+    promptHint: "camera orbits around the subject in a circular path, the background sliding to the left across the frame"
   },
   {
     id: "orbit-right",
     label: "Orbit Right",
     category: "orbit",
-    description: "Full circle around subject to the right",
-    promptHint: "camera orbits around the subject to the right in a circular path"
+    description: "Large partial orbit around subject to the right",
+    promptHint: "camera orbits around the subject in a circular path, the background sliding to the right across the frame"
   },
   {
     id: "arc-left",
     label: "Arc Left",
     category: "orbit",
     description: "Partial arc around subject left",
-    promptHint: "camera arcs to the left around the subject"
+    promptHint: "slow camera arc around the subject through a partial arc, the background sliding to the left across the frame"
   },
   {
     id: "arc-right",
     label: "Arc Right",
     category: "orbit",
     description: "Partial arc around subject right",
-    promptHint: "camera arcs to the right around the subject"
+    promptHint: "The camera slowly moves sideways to the right while curving around the subject, continuously turning toward the subject to keep the same centered framing.\nThe camera maintains constant distance from the subject.\nAs the viewpoint changes, strong natural parallax is visible: nearby environmental elements shift right noticeably while distant background elements shift right more slowly.\nThe shot ends from a slightly different three-quarter viewing angle.\nNo zoom, no push-in, no pull-out."
   },
   {
     id: "orbit-360",
     label: "Full 360 Orbit",
     category: "orbit",
     description: "Full circular arc around subject",
-    promptHint: "full 360 degree orbit, the camera arcs a complete revolution around the subject",
-    term: "full 360 degree orbit"
+    promptHint: "The camera moves sideways to the right while curving around the subject, continuously turning toward the subject to keep the same centered framing, and keeps travelling in the same direction without pausing until it has passed the subject's right side, then behind it, then its left side, and comes back to where it began.\nThe camera maintains constant distance and constant height from the subject throughout.\nAs the viewpoint changes, strong natural parallax is visible: nearby environmental elements sweep right past the frame edge while distant background elements shift right more slowly, and every part of the surroundings passes behind the subject in turn, until whatever was behind it at the start is behind it again at the end.\nThe shot ends on the exact same viewpoint and composition it started from, having circled the subject completely.\nNo zoom, no push-in, no pull-out, no reversal of direction.",
+    term: "full orbit, one complete circle around the subject"
   },
   // Crane / Jib
   {
@@ -4525,14 +4540,14 @@ var CAMERA_MOTIONS = [
     label: "Crane Up",
     category: "crane",
     description: "Sweeping crane rise revealing scene",
-    promptHint: "crane up, camera rises on a jib revealing the wider scene"
+    promptHint: "The camera is carried on the end of a long jib arm that swings it UPWARD and OUTWARD through a rising arc, so it climbs steadily higher and at the same time draws back and away from where it started. The scene itself is entirely unchanged; nothing in it moves, falls, appears or is added. Only the viewpoint travels.\nUnlike a straight vertical lift, the aim DOES change: as the camera rises it tips gradually downward, angling more and more steeply so that what began level with it is now looked down upon from above. The rise and the tilt happen together as one continuous sweeping arc.\nThe lens never changes: the focal length is fixed, so nothing is magnified.\nBecause the camera physically travels, there is STRONG parallax: EVERY part of the scene is in motion together, sliding downward and outward through the frame as the viewpoint climbs and pulls back, and the only difference between them is how fast. What is nearest the camera sweeps down and out of the bottom edge quickly, what is further back drifts more gently, and the most distant parts ease slowest of all. It is one smooth continuous gradient of speed across every depth. Nothing anywhere in the frame is frozen or static.\nThe shot ends on a high, wide, elevated vantage looking down over the whole scene, far above and behind where it began.\nNo zoom, no change of focal length, no sideways drift, no orbiting."
   },
   {
     id: "crane-down",
     label: "Crane Down",
     category: "crane",
     description: "Sweeping crane descent",
-    promptHint: "crane down, camera descends from above toward the subject"
+    promptHint: "The camera is carried on the end of a long jib arm that swings it DOWNWARD and INWARD through a descending arc, so it drops steadily lower and at the same time closes in toward what lay beneath it. The scene itself is entirely unchanged; nothing in it moves, falls, appears or is added. Only the viewpoint travels.\nUnlike a straight vertical descent, the aim DOES change: as the camera drops it tips gradually upward, levelling out more and more, so that what was looked down upon from above is now met at its own level. The fall and the tilt happen together as one continuous sweeping arc.\nThe lens never changes: the focal length is fixed, so nothing is magnified.\nBecause the camera physically travels, there is STRONG parallax: EVERY part of the scene is in motion together, sliding upward and inward through the frame as the viewpoint drops and closes in, and the only difference between them is how fast. What is nearest the camera sweeps up and out of the top edge quickly, what is further back drifts more gently, and the most distant parts ease slowest of all. It is one smooth continuous gradient of speed across every depth. Nothing anywhere in the frame is frozen or static.\nThe shot ends on a low, close vantage, far below and ahead of where it began.\nNo zoom, no change of focal length, no sideways drift, no orbiting."
   },
   {
     id: "boom-up",
@@ -4729,9 +4744,8 @@ var CAMERA_MOTIONS = [
     id: "match-cut-zoom",
     label: "Match Cut Zoom",
     category: "zoom",
-    description: "Beat-timed zoom for cuts",
-    promptHint: "rapid zoom timed to a beat, suggesting a match cut to the next shot",
-    term: "rapid beat-timed zoom"
+    description: "Fast zoom that hard-cuts to a matching shape",
+    promptHint: "A match cut built on a zoom, in two shots joined by one hard cut.\nShot one: the camera is locked to a tripod and never travels; only the lens changes, its focal length rapidly increasing so the frame rushes in and closes tightly on a single round shape at the centre of the picture, until that circular shape fills almost the whole frame.\nAt the moment the round shape fills the frame there is one HARD CUT.\nShot two: a completely different place and time, but a round shape of the same size sits in exactly the same position at the centre of the frame, so the two shots lock together on that shape and the eye reads it as one continuous movement. The camera continues the same inward push for a moment before settling.\nThe two shots share only the shape and its position; the location, the light and everything else are entirely different.\nNo camera travel in either shot, no dolly, no orbiting."
   },
   {
     id: "screen-tap",
@@ -4825,7 +4839,7 @@ function composeCameraMotionHintFromConnections(motionId, startHints, endHints,
   const endClause = endHints.filter((h) => h && h.length > 0).join(" and ");
   if (startClause) parts.push(`beginning with ${startClause}`);
   if (endClause) parts.push(`ending with ${endClause}`);
-  return parts.join(", ");
+  return joinHintFragments(parts);
 }
 function composeCameraMotionTermFromConnections(motionId, startTerms, endTerms) {
   const base = getCameraMotionTerm(motionId);
@@ -10006,7 +10020,7 @@ function withCustomText(data, mainHint) {
   if (mainHint) fragments.push(mainHint);
   const post = typeof data.postText === "string" ? data.postText.trim() : "";
   if (post) fragments.push(post);
-  return fragments.join(", ");
+  return joinHintFragments(fragments);
 }
 function readHintMode(data) {
   const raw = data.hintMode;
@@ -29071,6 +29085,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 +29277,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 +29304,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 +29329,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",
@@ -29324,11 +29445,17 @@ var PROVIDER_CAPABILITIES = {
     "minimax": "General music generation, multiple genres"
   },
   "suno-generate": {
-    "V4": "Standard Suno generation",
-    "V4_5": "Improved quality and coherence",
+    // Current generation first (V6 = default), then the earlier ones — all
+    // offered in the picker; mirrors SUNO_MODELS order in @nodaro/shared.
+    "V6": "Flagship \u2014 greater musical expression, more natural vocals, richer details",
+    "V6_WILD": "Bolder, more distinctive, less predictable results for exploration",
+    "V6_MINI": "Lightweight and fast \u2014 quality/speed balance",
+    "V5_5": "Custom-model tuning with strong vocal quality",
+    "V5": "Superior musical expression, faster generation",
     "V4_5PLUS": "Enhanced V4.5 with better production",
     "V4_5ALL": "Full-featured V4.5",
-    "V5": "Latest Suno with highest quality"
+    "V4_5": "Improved quality and coherence",
+    "V4": "Standard Suno generation"
   },
   "text-to-audio": {
     "elevenlabs-sfx": "High quality sound effects and ambient audio"
@@ -29481,6 +29608,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 },
@@ -32671,7 +32799,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Mellow focus beat.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "lo-fi hip-hop, chill and mellow, jazzy Rhodes chords, vinyl crackle, soft boom-bap drums, Andante 80 BPM, instrumental"
     }
@@ -32682,7 +32810,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Short confident opener.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "modern podcast intro, upbeat and confident, catchy synth hook, punchy beat, Allegro, instrumental"
     }
@@ -32693,7 +32821,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Epic orchestral build.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "epic cinematic trailer, dramatic and intense, full orchestra, taiko drums, brass swells, crescendo into a powerful hit, instrumental"
     }
@@ -32704,7 +32832,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Bright, motivational.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "upbeat corporate, optimistic and motivational, bright piano, claps, clean electronic beat, Allegro 120 BPM, instrumental"
     }
@@ -32715,7 +32843,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Feel-good acoustic bed.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "feel-good vlog background, light and breezy, acoustic guitar, claps, warm and unobtrusive, Andante, instrumental"
     }
@@ -32726,7 +32854,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Calm meditative pads.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "ambient soundscape, calm and meditative, soft evolving synth pads, gentle textures, reverb-heavy, Adagio, instrumental"
     }
@@ -32737,7 +32865,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Festival build and drop.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "festival EDM, euphoric and energetic, big supersaw leads, sidechain bass, build-up and powerful drop, Allegro 128 BPM, instrumental"
     }
@@ -32748,7 +32876,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Playful 8-bit loop.",
     group: "By Use-Case",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "video game chiptune, playful and adventurous, 8-bit synths, catchy melody, energetic, instrumental"
     }
@@ -32760,7 +32888,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Dusty laid-back groove.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "lo-fi hip-hop, jazzy and mellow, dusty Rhodes chords, vinyl warmth, laid-back boom-bap groove, instrumental"
     }
@@ -32771,7 +32899,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Club-energy four-on-the-floor.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "house EDM, energetic and euphoric, four-on-the-floor beat, catchy plucky synths, club energy, Allegro 124 BPM, instrumental"
     }
@@ -32782,7 +32910,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Driving anthemic guitars.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "rock anthem, energetic and driving, distorted electric guitars, pounding drums, anthemic, instrumental"
     }
@@ -32793,7 +32921,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Late-night sophistication.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "smooth jazz, relaxed and sophisticated, warm saxophone, brushed drums, walking bass, late-night, instrumental"
     }
@@ -32804,7 +32932,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Spacious and serene.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "ambient, serene and spacious, lush synth pads, field-recording textures, slow and meditative, instrumental"
     }
@@ -32815,7 +32943,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Grand cinematic ensemble.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "epic orchestral, grand and cinematic, sweeping strings, brass, woodwinds, timpani, dramatic, instrumental"
     }
@@ -32826,7 +32954,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "80s neon nostalgia.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "80s synthwave, nostalgic and cool, retro analog synths, pulsing bass, gated drums, neon, Andante 110 BPM, instrumental"
     }
@@ -32837,7 +32965,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Groovy and danceable.",
     group: "By Genre",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: true,
       style: "funk and soul, groovy and fun, slap bass, wah guitar, tight horn section, danceable, instrumental"
     }
@@ -32849,7 +32977,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Catchy vocal pop \u2014 add lyrics.",
     group: "Vocals & Songs",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: false,
       style: "upbeat pop, catchy and bright, shimmering synths, four-on-the-floor, female vocals, Allegro 120 BPM, verse-chorus-verse with bridge"
     }
@@ -32860,7 +32988,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Hard-hitting verses \u2014 add bars.",
     group: "Vocals & Songs",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: false,
       style: "modern hip-hop, confident, hard-hitting 808s, trap hi-hats, male rap vocals, verse-hook-verse"
     }
@@ -32871,7 +32999,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Heartfelt vocals \u2014 add lyrics.",
     group: "Vocals & Songs",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: false,
       style: "emotional ballad, tender and heartfelt, piano and strings, soulful vocals, Adagio, verse-chorus with a big bridge"
     }
@@ -32882,7 +33010,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Soaring chorus \u2014 add lyrics.",
     group: "Vocals & Songs",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: false,
       style: "anthemic rock, powerful, driving guitars, big drums, male vocals, soaring chorus, verse-pre-chorus-chorus"
     }
@@ -32893,7 +33021,7 @@ var SUNO_GENERATE_PRESETS = [
     description: "Warm and intimate \u2014 add lyrics.",
     group: "Vocals & Songs",
     data: {
-      model: "V5_5",
+      model: "V6",
       instrumental: false,
       style: "acoustic singer-songwriter, warm and intimate, fingerpicked guitar, soft vocals, Andante, verse-chorus"
     }
@@ -32904,42 +33032,42 @@ var SUNO_GENERATE_PRESETS = [
     name: "Trailer Riser / Braam",
     description: "Pure rising tension hit.",
     group: "By Use-Case",
-    data: { model: "V5_5", instrumental: true, style: "cinematic trailer riser and braam, tense and building, rising whoosh into a deep brass impact, no melody, instrumental" }
+    data: { model: "V6", instrumental: true, style: "cinematic trailer riser and braam, tense and building, rising whoosh into a deep brass impact, no melody, instrumental" }
   },
   {
     id: "suno-generate/calm-corporate",
     name: "Calm Corporate / Tech",
     description: "Soft, professional bed.",
     group: "By Use-Case",
-    data: { model: "V5_5", instrumental: true, style: "calm corporate tech, professional and clean, soft synth pads, gentle pulse, Andante, instrumental" }
+    data: { model: "V6", instrumental: true, style: "calm corporate tech, professional and clean, soft synth pads, gentle pulse, Andante, instrumental" }
   },
   {
     id: "suno-generate/holiday",
     name: "Holiday / Festive",
     description: "Warm seasonal cheer.",
     group: "By Use-Case",
-    data: { model: "V5_5", instrumental: true, style: "festive holiday music, warm and cheerful, sleigh bells, warm orchestration, cozy, instrumental" }
+    data: { model: "V6", instrumental: true, style: "festive holiday music, warm and cheerful, sleigh bells, warm orchestration, cozy, instrumental" }
   },
   {
     id: "suno-generate/kids",
     name: "Kids / Children's",
     description: "Playful and simple.",
     group: "By Use-Case",
-    data: { model: "V5_5", instrumental: true, style: "children's music, playful and happy, simple cheerful melody, xylophone and ukulele, bouncy, instrumental" }
+    data: { model: "V6", instrumental: true, style: "children's music, playful and happy, simple cheerful melody, xylophone and ukulele, bouncy, instrumental" }
   },
   {
     id: "suno-generate/meditation-spa",
     name: "Meditation / Spa",
     description: "Healing singing bowls.",
     group: "By Use-Case",
-    data: { model: "V5_5", instrumental: true, style: "meditation and spa, serene and healing, singing bowls, soft drones, Adagio, reverb-heavy, instrumental" }
+    data: { model: "V6", instrumental: true, style: "meditation and spa, serene and healing, singing bowls, soft drones, Adagio, reverb-heavy, instrumental" }
   },
   {
     id: "suno-generate/workout",
     name: "Workout / Gym",
     description: "High-energy motivation.",
     group: "By Use-Case",
-    data: { model: "V5_5", instrumental: true, style: "high-energy workout, motivational and driving, pumping electronic beat, big synths, Allegro 140 BPM, instrumental" }
+    data: { model: "V6", instrumental: true, style: "high-energy workout, motivational and driving, pumping electronic beat, big synths, Allegro 140 BPM, instrumental" }
   },
   // ── More By Genre ────────────────────────────────────────────────────────
   {
@@ -32947,42 +33075,42 @@ var SUNO_GENERATE_PRESETS = [
     name: "Trap Beat",
     description: "Booming 808s, dark.",
     group: "By Genre",
-    data: { model: "V5_5", instrumental: true, style: "trap beat, dark and hard, booming 808s, crisp rapid hi-hats, moody, instrumental" }
+    data: { model: "V6", instrumental: true, style: "trap beat, dark and hard, booming 808s, crisp rapid hi-hats, moody, instrumental" }
   },
   {
     id: "suno-generate/dnb",
     name: "Drum & Bass",
     description: "Fast breakbeats, deep bass.",
     group: "By Genre",
-    data: { model: "V5_5", instrumental: true, style: "drum and bass, fast and energetic, breakbeats, deep rolling bassline, Presto 174 BPM, instrumental" }
+    data: { model: "V6", instrumental: true, style: "drum and bass, fast and energetic, breakbeats, deep rolling bassline, Presto 174 BPM, instrumental" }
   },
   {
     id: "suno-generate/afrobeats",
     name: "Afrobeats",
     description: "Warm syncopated groove.",
     group: "By Genre",
-    data: { model: "V5_5", instrumental: true, style: "afrobeats, groovy and warm, syncopated percussion, warm bass, bright melodies, danceable, instrumental" }
+    data: { model: "V6", instrumental: true, style: "afrobeats, groovy and warm, syncopated percussion, warm bass, bright melodies, danceable, instrumental" }
   },
   {
     id: "suno-generate/country",
     name: "Country / Americana",
     description: "Acoustic, heartfelt.",
     group: "By Genre",
-    data: { model: "V5_5", instrumental: true, style: "country americana, warm and heartfelt, acoustic and slide guitar, storytelling feel, instrumental" }
+    data: { model: "V6", instrumental: true, style: "country americana, warm and heartfelt, acoustic and slide guitar, storytelling feel, instrumental" }
   },
   {
     id: "suno-generate/phonk",
     name: "Phonk",
     description: "Dark drift-phonk for reels.",
     group: "By Genre",
-    data: { model: "V5_5", instrumental: true, style: "drift phonk, dark and aggressive, distorted 808 cowbell, menacing beat, lo-fi grit, instrumental" }
+    data: { model: "V6", instrumental: true, style: "drift phonk, dark and aggressive, distorted 808 cowbell, menacing beat, lo-fi grit, instrumental" }
   },
   {
     id: "suno-generate/reggae",
     name: "Reggae / Dub",
     description: "Laid-back island groove.",
     group: "By Genre",
-    data: { model: "V5_5", instrumental: true, style: "reggae dub, laid-back and sunny, off-beat skank guitar, deep dub bassline, relaxed island groove, instrumental" }
+    data: { model: "V6", instrumental: true, style: "reggae dub, laid-back and sunny, off-beat skank guitar, deep dub bassline, relaxed island groove, instrumental" }
   },
   // ── More Vocals & Songs ──────────────────────────────────────────────────
   {
@@ -32990,14 +33118,14 @@ var SUNO_GENERATE_PRESETS = [
     name: "R&B / Soul (vocal)",
     description: "Smooth soulful vocals \u2014 add lyrics.",
     group: "Vocals & Songs",
-    data: { model: "V5_5", instrumental: false, style: "smooth R&B soul, sensual and warm, lush chords, soft drums, soulful vocals, Andante, verse-chorus with ad-libs" }
+    data: { model: "V6", instrumental: false, style: "smooth R&B soul, sensual and warm, lush chords, soft drums, soulful vocals, Andante, verse-chorus with ad-libs" }
   },
   {
     id: "suno-generate/song-kpop",
     name: "K-Pop (vocal)",
     description: "Polished hook \u2014 add lyrics.",
     group: "Vocals & Songs",
-    data: { model: "V5_5", instrumental: false, style: "K-pop, polished and energetic, bright synths, punchy drums, layered vocals, Allegro 120 BPM, verse-pre-chorus-chorus" }
+    data: { model: "V6", instrumental: false, style: "K-pop, polished and energetic, bright synths, punchy drums, layered vocals, Allegro 120 BPM, verse-pre-chorus-chorus" }
   }
 ];
 
@@ -34931,6 +35059,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 +35132,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 +35194,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 +35428,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;
@@ -35298,6 +35439,7 @@ exports.isMinorAge = isMinorAge;
 exports.isSuspiciousDerivedTerm = isSuspiciousDerivedTerm;
 exports.isVantageFraming = isVantageFraming;
 exports.isWizardSupported = isWizardSupported;
+exports.joinHintFragments = joinHintFragments;
 exports.joinPromptHints = joinPromptHints;
 exports.joinPromptParts = joinPromptParts;
 exports.keepableDirectionHints = keepableDirectionHints;
@@ -35329,6 +35471,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 +35489,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;