@nodaro/prompts 1.21.0 → 1.25.0

package/dist/index.cjs

@@ -166,8 +166,11 @@ function applyExtend(c, pack) {
 }
 function applyDeny(c, denyIds) {
   const deny = new Set(denyIds);
-  if (c.kind === "single") return { ...c, options: (c.options ?? []).filter((o) => !deny.has(o.id)) };
-  return { ...c, dimensions: (c.dimensions ?? []).map((d) => ({ ...d, options: d.options.filter((o) => !deny.has(o.id)) })) };
+  return {
+    ...c,
+    options: c.options?.filter((o) => !deny.has(o.id)),
+    dimensions: c.dimensions?.map((d) => ({ ...d, options: d.options.filter((o) => !deny.has(o.id)) }))
+  };
 }
 function composePickerCatalogs(base, activePacks) {
   const known = new Set(base.map((c) => c.catalogId));
@@ -182,6 +185,12 @@ function composePickerCatalogs(base, activePacks) {
       else if (pack.mode === "extend") out = applyExtend(out, pack);
       else if (pack.mode === "deny") out = applyDeny(out, pack.denyIds ?? []);
     }
+    if (activePacks.some((p) => p.catalogId === c.catalogId) && out.defaultValue) {
+      const options = [...out.options ?? [], ...(out.dimensions ?? []).flatMap((d) => d.options)];
+      if (!options.some((o) => o.id === out.defaultValue)) {
+        out = { ...out, defaultValue: out.options?.[0]?.id };
+      }
+    }
     return out;
   });
 }
@@ -4276,7 +4285,7 @@ var CAMERA_MOTIONS = [
     label: "Static",
     category: "default",
     description: "Fixed camera, no movement",
-    promptHint: "locked off static camera, no camera movement",
+    promptHint: "The camera is locked on a solid tripod and does not move at all for the entire shot: it never travels, never rotates, never tilts, never changes focal length. The viewpoint is completely fixed and the framing stays exactly the same from the first frame to the last.\nLife within the scene carries on naturally, but the camera holds perfectly still throughout.\nNo camera movement of any kind, no drift, no sway, no zoom.",
     term: "locked-off static camera"
   },
   {
@@ -4284,7 +4293,7 @@ var CAMERA_MOTIONS = [
     label: "Handheld",
     category: "default",
     description: "Natural handheld shake",
-    promptHint: "handheld camera with subtle natural shake and micro movements",
+    promptHint: "The camera is HANDHELD, held in an operator's hands rather than on any support, so it carries the constant small live motion of a real person holding it: a continuous gentle shake and wobble, tiny irregular drifts and corrections in every direction, a slight bob in time with breathing, never settling completely still even for a moment.\nThe motion is small and organic, never a large or deliberate move: the camera stays roughly where it is and keeps roughly the same framing, it simply never locks off. It does not travel toward anything, away from anything, or off to any side; it holds its position and only jitters around it. The unsteadiness is human and slightly random, not a smooth mechanical sway and not a rhythmic loop.\nThe lens does not change and the camera does not travel anywhere, orbit, or turn to a new direction; it just floats and jitters in place as if held.\nThe framing stays broadly the same across the shot, loosely on the subject, wandering by only small amounts.\nNo zoom, no deliberate camera move, no forward or backward travel, no rotation to a new angle, no smooth glide.",
     term: "handheld camera"
   },
   {
@@ -4292,7 +4301,7 @@ var CAMERA_MOTIONS = [
     label: "Steadicam",
     category: "default",
     description: "Smooth stabilized walking shot",
-    promptHint: "smooth steadicam shot, gliding stabilized movement through the scene",
+    promptHint: "The camera moves with the perfectly smooth, floating quality of a Steadicam or gimbal: it glides gently and continuously, with none of the shake, jitter or bob of a handheld rig. Every bit of movement is buttery, damped and stabilised, as if the camera were floating on air.\nThe motion is a slow, graceful drift through the scene \u2014 easing a little forward and around with fluid, gliding ease \u2014 always even and controlled, never abrupt, never trembling, never correcting.\nThe lens does not change. The framing stays loosely on the subject throughout, the glide being gentle enough that the composition holds.\nThe single defining quality is SMOOTHNESS: this is the opposite of handheld \u2014 no shake whatsoever, only silky stabilised floating motion.\nNo zoom, no jitter, no handheld shake, no abrupt moves.",
     term: "smooth steadicam shot"
   },
   // Pan — rotation on vertical axis
@@ -4487,14 +4496,14 @@ var CAMERA_MOTIONS = [
     label: "Dutch Angle",
     category: "roll",
     description: "Static tilted frame for tension",
-    promptHint: "dutch angle, canted tilted frame for tension"
+    promptHint: "The shot begins level, then the camera rolls a little way around its own lens axis and STOPS at a fixed cant, holding that tilted Dutch-angle framing for the rest of the shot. It is a single small settling roll into a tilt, not a continuous spin: the frame tips perhaps fifteen or twenty degrees off level and then stays there, canted and still, for an uneasy, tense feeling.\nOnly the roll axis is involved: the camera stays in the same position, does not travel, does not pan or tilt its aim up or down, and the lens does not change. The horizon starts level and ends clearly canted, then holds.\nBecause it is a pure roll, there is no parallax: the whole frame turns as one flat picture, near and far together.\nLife in the scene carries on gently while the framing holds its tilt.\nNo zoom, no travel, no continuous spinning, no returning to level once canted."
   },
   {
     id: "spin-360",
     label: "Full 360 Spin",
     category: "roll",
     description: "Camera rotates a full 360\xB0 on its axis",
-    promptHint: "full 360 degree spin, the camera rotates a complete revolution on its own lens axis",
+    promptHint: "The camera rotates a FULL 360 degrees around its own lens axis in one continuous even spin, and keeps turning the same way without pausing until the picture has come all the way back to level exactly as it started. The horizon sweeps from level, round through fully sideways on one side, through completely upside-down, through fully sideways on the other side, and back to level \u2014 one complete unbroken revolution.\nOnly the roll axis is involved: the camera stays in exactly the same position, does not travel, does not pan or tilt its aim, and the lens does not change. It spins about the axis running straight out through the lens.\nBecause it is a pure roll, there is no parallax: the whole frame turns as one flat picture, near and far rotating together by the same amount.\nThe spin is smooth and continuous at an even speed, going round only once and ending back at level.\nNo zoom, no travel, no pan, no tilt of the aim, no reversal of the spin direction.",
     term: "full 360 degree camera roll"
   },
   // Orbit / Arc
@@ -4616,7 +4625,7 @@ var CAMERA_MOTIONS = [
     label: "Ronin Glide",
     category: "tracking",
     description: "Slow gliding move on a Ronin/Movi gimbal",
-    promptHint: "ronin glide, slow gliding move on a Ronin or Movi gimbal, cinematic float without any shake",
+    promptHint: "ronin gimbal glide, ultra-smooth floating tracking movement following the subject",
     term: "slow gliding gimbal move"
   },
   {
@@ -4624,7 +4633,7 @@ var CAMERA_MOTIONS = [
     label: "Serpentine Track",
     category: "tracking",
     description: "Camera weaves through obstacles in S-curves",
-    promptHint: "serpentine track, the camera weaves through obstacles in S-curves, snaking forward along a winding path",
+    promptHint: "serpentine tracking shot, camera weaves smoothly side to side while following the subject",
     term: "serpentine tracking shot"
   },
   // Special angles / rigs
@@ -4633,7 +4642,7 @@ var CAMERA_MOTIONS = [
     label: "POV",
     category: "special",
     description: "First person point of view",
-    promptHint: "POV shot, first person perspective as seen through the subject's eyes",
+    promptHint: "POV shot, first person perspective as seen through the subject's eyes. The viewpoint moves forward at a calm, unhurried walking pace \u2014 steady and gentle, never a fast rush or a vehicle-like travel speed. No body parts, hands or feet ever enter the frame; only the point of view itself drifts smoothly forward.",
     term: "first person pov shot"
   },
   {
@@ -4641,7 +4650,7 @@ var CAMERA_MOTIONS = [
     label: "Over The Shoulder",
     category: "special",
     description: "Frame past a character's shoulder",
-    promptHint: "over the shoulder shot, framing past one character's shoulder onto another",
+    promptHint: "Over the shoulder shot: the camera is already framed past the near character's shoulder onto the second character from the very first frame, with no push-in or approach - the framing and distance stay constant throughout, at most a very small handheld-style settle. No camera travel toward or away from either character. No dialogue, no spoken words, no lip movement suggesting speech - completely silent, ambient sound only if any.",
     term: "over-the-shoulder shot"
   },
   {
@@ -4665,7 +4674,7 @@ var CAMERA_MOTIONS = [
     label: "Aerial",
     category: "special",
     description: "High altitude drone-style shot",
-    promptHint: "aerial drone shot, high altitude slow forward movement over the landscape",
+    promptHint: "The camera is airborne and sinks straight downward through the air, losing altitude like an aircraft lowering itself vertically. Its aim is completely fixed: the horizon line stays at exactly the same height across the frame from the first moment to the last, and the camera never dips or tips its view downward at all \u2014 what it points at does not change, only where it is in space.\nAs the camera drops in height, everything in view slides UPWARD through the frame together because the viewpoint is lower: whatever stands tall rises up the frame and grows, and more of what lies far below climbs into view from the bottom. This vertical sliding of the whole scene is the ONLY change; the angle of view is frozen.\nNo tilting, no dipping the aim down, no looking further down, no rotation, no forward travel \u2014 the horizon must remain pinned at its starting height while the camera simply loses altitude.",
     term: "high altitude aerial drone shot"
   },
   {
@@ -4673,7 +4682,7 @@ var CAMERA_MOTIONS = [
     label: "Helicopter",
     category: "special",
     description: "Wide high-altitude sweeping aerial",
-    promptHint: "helicopter shot, high altitude wide sweeping aerial pass with strong lateral movement",
+    promptHint: "helicopter shot, sweeping aerial movement banking around the scene",
     term: "sweeping helicopter aerial shot"
   },
   {
@@ -4681,7 +4690,7 @@ var CAMERA_MOTIONS = [
     label: "Fly Over",
     category: "special",
     description: "Low fast aerial pass over the scene",
-    promptHint: "fly over shot, low altitude drone passing quickly over the scene with strong forward motion",
+    promptHint: "The camera flies steadily FORWARD through the air at a constant height, cruising ahead toward what lies in front of it without ever changing altitude. Its height stays exactly the same from start to finish \u2014 it does not descend, does not climb, does not dip its aim; it simply travels forward at cruising speed.\nBecause it moves forward, whatever lies ahead grows closer and sweeps toward the camera and past it on both sides, near things rushing by faster than far things. The horizon holds at exactly the same height in the frame the whole time.\nNo descending, no climbing, no tilting the aim, no rotation \u2014 only steady level forward flight at a fixed altitude.",
     term: "low aerial fly-over pass"
   },
   {
@@ -4713,7 +4722,7 @@ var CAMERA_MOTIONS = [
     label: "Rack Focus",
     category: "special",
     description: "Pull focus between foreground and background",
-    promptHint: "rack focus, lens focus shifts from a foreground subject to a background subject (or vice versa), the unfocused plane blurs"
+    promptHint: "The camera itself never moves, never zooms and never changes its framing \u2014 it is completely locked in place for the whole shot. Only the lens's focus plane shifts. It starts sharply focused on the nearest element in the frame, with everything further back a soft out-of-focus blur. Then the focus pulls smoothly across to the far background, which becomes crisp and sharp, while the near foreground that was sharp a moment ago now falls out of focus and blurs instead. The two states \u2014 near-sharp/far-blurred, then near-blurred/far-sharp \u2014 must read as clearly opposite. No camera travel, no zoom, no change in composition \u2014 only which plane is sharp changes."
   },
   // Modern / social-video vocabulary
   {
@@ -4721,7 +4730,7 @@ var CAMERA_MOTIONS = [
     label: "Handheld Vlog",
     category: "default",
     description: "Casual vlog-style handheld",
-    promptHint: "casual handheld vlog-style camera, slight wandering and natural shake, talking-to-camera framing",
+    promptHint: "The camera is a casual handheld vlog camera, held at arm's length by the subject or a companion, with the loose, informal quality of someone filming themselves. It has clear handheld shake and small bobbing motion, but looser and more wandering than a careful operator: it drifts around a bit, reframes casually, bobs as if the holder is shifting their weight or gesturing.\nThe framing sits fairly close and personal, roughly on the subject, wandering by moderate amounts as a vlogger's arm naturally would \u2014 informal and lively, not locked or composed.\nThe motion has personality and looseness: more movement than a careful handheld, unpolished and spontaneous, but it stays broadly in place rather than travelling off anywhere.\nThe lens does not change; the camera does not glide smoothly (that would be a steadicam) and does not travel deliberately in any direction.\nNo zoom, no smooth stabilised glide, no deliberate directional move, no tripod stillness.",
     term: "handheld vlog-style camera"
   },
   {
@@ -4729,7 +4738,7 @@ var CAMERA_MOTIONS = [
     label: "POV Walk",
     category: "tracking",
     description: "First-person walking POV",
-    promptHint: "first-person POV walking camera, GoPro-style head-mounted perspective with natural footstep movement",
+    promptHint: "first-person POV walking shot, camera as the subject's eyes with natural head-bob as they walk forward",
     term: "first person walking pov"
   },
   {
@@ -4752,23 +4761,23 @@ var CAMERA_MOTIONS = [
     label: "Screen Tap",
     category: "special",
     description: "On-screen finger-tap transition",
-    promptHint: "camera transition triggered by an on-screen finger tap, TikTok-native pacing with snap to the next subject",
-    term: "on-screen finger-tap transition"
+    promptHint: "An abrupt hard snap-cut transition: the camera instantly jumps to a new framing of the scene with no gradual movement in between, a fast decisive jolt rather than any smooth pan, push or travel. No object, hand, finger, or UI element ever appears in the frame. TikTok-native snap pacing.",
+    term: "abrupt snap-cut transition"
   },
   {
     id: "phone-flip",
     label: "Phone Flip",
     category: "special",
     description: "Front/rear camera flip",
-    promptHint: "camera-flip transition where the phone visibly rotates between the front and rear sensors, brief blur during the swap",
-    term: "front-to-rear phone camera flip"
+    promptHint: "A rapid flip-transition, functioning as a hard cut rather than a smooth continuous rotation: the entire frame snaps through one quick full rotation in a fraction of a second, with strong motion blur through the spin, then lands upright again immediately on a new framing of the scene. This is abrupt and near-instant, never a slow, smooth, or continuously spinning carousel-like rotation. No object, hand, phone, or UI element ever appears in the frame.",
+    term: "fast flip-cut transition"
   },
   {
     id: "gentle-drift",
     label: "Gentle Drift",
     category: "default",
     description: "Slow ambient floating motion",
-    promptHint: "gentle camera drift, a slow ambient floating motion with no specific direction, the camera barely moves but never sits perfectly still, evocative of contemplative atmospheric shots",
+    promptHint: "The camera drifts with an extremely slow, gentle, ambient floating motion, as if suspended and barely stirring in still air. There is no shake and no deliberate direction: it simply floats, drifting a tiny amount one way and then easing another, aimless and dreamlike.\nThe movement is minimal and continuous \u2014 the camera never sits perfectly still, but it never travels anywhere either; it hovers almost in place, wandering by only the smallest amounts, smooth and weightless throughout.\nThe pace is contemplative and calm, the drift so slow it is only just perceptible. The picture stays sharp; there is no motion blur.\nThe lens does not change and the framing stays broadly the same, resting loosely on the subject.\nNo zoom, no shake, no jitter, no deliberate directional move, no travel across the scene.",
     term: "slow gentle camera drift"
   },
   {
@@ -4776,7 +4785,7 @@ var CAMERA_MOTIONS = [
     label: "Parallax",
     category: "default",
     description: "Lateral motion with foreground/background depth separation",
-    promptHint: "parallax camera motion, lateral movement that emphasizes the depth separation between foreground and background elements, foreground objects appearing to move faster than distant ones",
+    promptHint: "The camera makes a small, smooth sideways move that shows off the depth of the scene through parallax. It eases gently a short way across, staying at the same distance and keeping its aim forward.\nThe defining quality is a STRONG parallax gradient: the nearest foreground elements slide across noticeably and quickly, the mid-distance elements shift more gently, and the most distant elements barely move at all \u2014 one smooth continuous gradient of speed from near to far that makes the separation between the layers obvious. Nothing is frozen; everything shifts, just by very different amounts according to its distance.\nThe move is modest and ambient rather than a full travelling shot: a gentle reveal of depth, not a journey across the scene.\nThe lens does not change; the camera does not push in, pull back, rotate, or shake.\nNo zoom, no forward or backward travel, no rotation, no handheld shake.",
     term: "lateral parallax camera move"
   }
 ];
@@ -4864,7 +4873,8 @@ var TRANSITIONS = [
     category: "standard",
     description: "Instantaneous switch, no transition",
     promptHint: "no transition, hard cut, instantaneous switch from first shot to second shot",
-    term: "hard cut"
+    term: "hard cut",
+    instant: true
   },
   {
     id: "cross-dissolve",
@@ -4893,21 +4903,24 @@ var TRANSITIONS = [
     category: "standard",
     description: "Instant cut to full black for a beat, then the next shot",
     promptHint: "snap to black: the first shot cuts instantly to full black with no fade, the frame holds pure black for a single beat, then the second shot cuts in at full brightness",
-    term: "snap to black"
+    term: "snap to black",
+    instant: true
   },
   {
     id: "match-cut",
     label: "Match Cut",
     category: "standard",
     description: "Shape or motion match across shots",
-    promptHint: "match cut: the final composition of the first shot matches the opening composition of the second shot in shape, color, and motion, so the cut feels like a visual rhyme"
+    promptHint: "match cut: the final composition of the first shot matches the opening composition of the second shot in shape, color, and motion, so the cut feels like a visual rhyme",
+    instant: true
   },
   {
     id: "smash-cut",
     label: "Smash Cut",
     category: "standard",
     description: "Jarring abrupt cut between contrasting shots",
-    promptHint: "smash cut: an abrupt jarring transition between two visually or tonally contrasting shots with no fade, on a beat"
+    promptHint: "smash cut: an abrupt jarring transition between two visually or tonally contrasting shots with no fade, on a beat",
+    instant: true
   },
   {
     id: "iris",
@@ -4939,7 +4952,8 @@ var TRANSITIONS = [
     category: "standard",
     description: "Hidden cut disguised by matched motion and color",
     promptHint: "hidden seamless transition: the camera motion, color palette, and on-screen motion at the end of the first shot continue exactly across the cut into the second shot, so the boundary is invisible and the two shots feel like one unbroken take",
-    term: "invisible cut"
+    term: "invisible cut",
+    instant: true
   },
   {
     id: "whip-pan",
@@ -4955,7 +4969,8 @@ var TRANSITIONS = [
     category: "standard",
     description: "Same framing, time skips forward",
     promptHint: "jump cut: the framing, lens, and camera position stay identical across the cut while time skips abruptly forward, so the subject snaps to a new position inside what still reads as one continuous shot",
-    term: "jump cut"
+    term: "jump cut",
+    instant: true
   },
   // ============================================================================
   // TIME — 8 entries — temporal shifts (same or related scene, different time, or memory)
@@ -4989,7 +5004,7 @@ var TRANSITIONS = [
     label: "Aging",
     category: "time",
     description: "Subject visibly ages forward in time",
-    promptHint: "accelerated aging transition: the subject visibly ages forward \u2014 skin develops fine lines then deeper wrinkles, hair lightens to silver, posture shifts subtly, while the framing holds steady on the face",
+    promptHint: "accelerated aging transition: the subject visibly ages forward - fine lines deepen into wrinkles, hair greys to silver, posture settles - while the framing stays unchanged",
     term: "accelerated aging"
   },
   {
@@ -5005,7 +5020,7 @@ var TRANSITIONS = [
     label: "Freeze-Frame Jump",
     category: "time",
     description: "Action freezes, jumps forward in time",
-    promptHint: "freeze-frame transition: motion arrests mid-action, the frame holds frozen for a beat, then snaps to a new moment hours or days later in the same scene with subjects in different positions",
+    promptHint: "freeze-frame transition: all motion stops mid-action and the picture holds still for a beat; only then does it jump to the same view hours or days later, everything in new positions, and motion resumes",
     term: "freeze-frame time jump"
   },
   {
@@ -5217,7 +5232,7 @@ var TRANSITIONS = [
     label: "Zoom Into Screen",
     category: "portal",
     description: "Push into TV/phone screen",
-    promptHint: "the camera pushes toward a screen visible in the scene (TV, phone, monitor), the screen's image fills the frame, and the camera passes through into that image which becomes the new scene"
+    promptHint: "the camera pushes toward a screen visible in the scene, such as a TV, phone or monitor, the screen's image fills the frame, and the camera passes through into that image which becomes the new scene"
   },
   {
     id: "zoom-into-book",
@@ -5253,7 +5268,7 @@ var TRANSITIONS = [
     label: "Zoom Into Mouth",
     category: "portal",
     description: "Push into open mouth, emerges in new world inside",
-    promptHint: "the camera pushes into the subject's open mouth, the dark interior fills the frame, and the camera passes through the throat into the new scene which materialises as if emerging from inside the body"
+    promptHint: "the camera pushes into the subject's open mouth, the dark interior fills the frame, and the camera passes through into the new scene which materialises as if emerging from inside the body"
   },
   {
     id: "push-through-glass",
@@ -5344,7 +5359,8 @@ var TRANSITIONS = [
     category: "physics",
     description: "Subject jumps, landing matches into new scene",
     promptHint: "the subject jumps upward and out of frame at the end of the first shot, with matched velocity the camera follows the arc, and on landing the subject is in a new location seamlessly continuing the same jump",
-    term: "match cut on a jump"
+    term: "match cut on a jump",
+    instant: true
   },
   {
     id: "hand-swipe",
@@ -5359,7 +5375,8 @@ var TRANSITIONS = [
     category: "physics",
     description: "Subject exits on an action and lands in the new scene mid-move",
     promptHint: "match cut on action: the subject exits the frame on a committed action \u2014 a stride, a throw, a turn \u2014 and enters the new scene on the same beat continuing that movement at matched speed and direction, so the action carries unbroken across the cut",
-    term: "match cut on action"
+    term: "match cut on action",
+    instant: true
   },
   // ============================================================================
   // LIGHT — 8 entries — flash and lens FX
@@ -5515,6 +5532,30 @@ function getTransitionTerm(id) {
   return resolveTerm(getTransition(id));
 }
 var TRANSITION_IDS = TRANSITIONS.map((t) => t.id);
+function isInstantTransition(id) {
+  const ids = typeof id === "string" ? [id] : id ? [...id] : [];
+  if (ids.length === 0) return false;
+  return ids.every((one) => getTransition(one)?.instant === true);
+}
+var INSTANT_CUT_CLAUSE = "an abrupt single-frame hard cut, no dissolve, crossfade or superimposition; the two images never blend";
+var LEADING_LABEL = /^\s*((?:[^\s:,;.()]+\s+){0,4}[^\s:,;.()]+)\s*:\s+/;
+var normalizePhrase = (s) => s.trim().toLowerCase().replace(/\s+/g, " ");
+function transitionHintBody(id, term) {
+  const hint = getTransitionPromptHint(id).replace(LEADING_LABEL, "").trim();
+  const t = normalizePhrase(term);
+  return hint.split(/,\s*/).filter((item) => normalizePhrase(item) !== t).join(", ").trim();
+}
+function transitionFragment(id, withCutClause) {
+  const term = getTransitionTerm(id);
+  if (!term) return "";
+  const inner = [transitionHintBody(id, term), withCutClause ? INSTANT_CUT_CLAUSE : ""].filter((part) => part.length > 0).join("; ");
+  return inner.length > 0 && normalizePhrase(inner) !== normalizePhrase(term) ? `${term} (${inner})` : term;
+}
+function renderTransitionBases(ids, _mode = "full") {
+  const picked = ids.filter((id) => getTransitionTerm(id).length > 0);
+  const instant = isInstantTransition(picked);
+  return picked.map((id, i) => transitionFragment(id, instant && i === 0));
+}
 var TRANSITION_POSITIONS = [
   { id: "auto", label: "Auto", description: "Let the model place it", promptHint: "", term: "" },
   { id: "start", label: "Start", description: "At the opening of the clip", promptHint: "the transition occurs at the opening of the clip", term: "at the opening of the clip" },
@@ -5532,7 +5573,7 @@ var TRANSITION_DURATIONS = [
 var TRANSITION_INTENSITIES = [
   { id: "auto", label: "Auto", description: "Let the model judge it", promptHint: "", term: "" },
   { id: "subtle", label: "Subtle", description: "Restrained, minimal flourish", promptHint: "with subtle restrained energy and minimal flourish", term: "subtly" },
-  { id: "natural", label: "Natural", description: "Unhurried, unforced timing", promptHint: "with natural unhurried timing", term: "at a natural pace" },
+  { id: "natural", label: "Natural", description: "Unhurried, unforced timing", promptHint: "with natural timing", term: "at a natural pace" },
   { id: "dynamic", label: "Dynamic", description: "Assertive, energetic", promptHint: "with dynamic energy and assertive flourish", term: "energetically" },
   { id: "crazy", label: "Crazy", description: "Extreme, wild, distorted", promptHint: "with extreme exaggerated energy, wild flourishes, and dramatic distortion", term: "wildly exaggerated" }
 ];
@@ -5542,22 +5583,29 @@ function clausesOf(options) {
   );
 }
 var POSITION_CLAUSES = clausesOf(TRANSITION_POSITIONS);
+var SHOT_POSITION_CLAUSES = Object.fromEntries(
+  Object.entries(POSITION_CLAUSES).map(([id, clause]) => [
+    id,
+    clause.replace(/ of the clip\b/g, " of this shot").replace(/ the entire clip\b/g, " this entire shot")
+  ])
+);
 var DURATION_CLAUSES = clausesOf(TRANSITION_DURATIONS);
 var INTENSITY_CLAUSES = clausesOf(TRANSITION_INTENSITIES);
-function composeTransitionHintFromConnections(transitionId, startHints, endHints, timing, mode = "full") {
+function composeTransitionHintFromConnections(transitionId, startHints, endHints, timing, mode = "full", options) {
   const ids = Array.isArray(transitionId) ? Array.from(new Set(transitionId)).slice(0, 2) : transitionId ? [transitionId] : [];
-  const resolveBase = mode === "compact" ? getTransitionTerm : getTransitionPromptHint;
-  const baseHints = ids.map(resolveBase).filter((h) => h.length > 0);
+  const baseHints = renderTransitionBases(ids, mode);
   if (baseHints.length === 0) return "";
+  const instant = isInstantTransition(ids.filter((id) => getTransitionTerm(id).length > 0));
   const combinedBase = baseHints.join(", and ");
   const parts = [combinedBase];
-  if (timing?.position && timing.position !== "auto") {
-    parts.push(POSITION_CLAUSES[timing.position]);
+  if (timing?.position && timing.position !== "auto" && !(instant && timing.position === "full")) {
+    const clauses = options?.scope === "shot" ? SHOT_POSITION_CLAUSES : POSITION_CLAUSES;
+    parts.push(clauses[timing.position]);
   }
-  if (timing?.duration && timing.duration !== "auto") {
+  if (timing?.duration && timing.duration !== "auto" && !instant) {
     parts.push(DURATION_CLAUSES[timing.duration]);
   }
-  if (timing?.intensity && timing.intensity !== "auto") {
+  if (timing?.intensity && timing.intensity !== "auto" && !instant) {
     parts.push(INTENSITY_CLAUSES[timing.intensity]);
   }
   const startClause = startHints.filter((h) => h && h.length > 0).join(" and ");
@@ -18607,6 +18655,7 @@ function toOptions(arr, categoryField) {
     if (e.description) opt.description = e.description;
     if (categoryField) opt.category = e[categoryField];
     if (e.adultOnly) opt.adultOnly = true;
+    if (e.instant) opt.instant = true;
     return opt;
   });
 }
@@ -19862,7 +19911,7 @@ var DIRECTION_FIELDS = [
   { key: "temporalFreeze", surface: "video", family: "motion", maxPicks: 1, render: temporal },
   { key: "temporalDirection", surface: "video", family: "motion", maxPicks: 1, render: temporal },
   { key: "temporalShutter", surface: "video", family: "motion", maxPicks: 1, render: temporal },
-  { key: "transition", surface: "video", family: "motion", maxPicks: 2, render: perId(getTransitionPromptHint, getTransitionTerm) },
+  { key: "transition", surface: "video", family: "motion", maxPicks: 2, render: renderTransitionBases },
   { key: "loopSubject", surface: "video", family: "motion", maxPicks: 1, render: perId(getLoopSubjectPromptHint, getLoopSubjectTerm) },
   // ── LEGACY BLOCK — see the table doc above. Placed LAST, in today's exact
   //    `composePromptText` order, so every pre-registry caller is byte-identical.
@@ -21881,6 +21930,12 @@ var REF_BINDING = {
   ordinal: (n) => `@image_${n}`,
   frame: (n, role) => `Use @image_${n} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`
 };
+var SEEDANCE_VIDEO_EDIT_PREFIX = "edit {video:1} as follows:\n";
+function buildSeedanceVideoEditPrompt(prompt) {
+  const body = (prompt ?? "").trim();
+  if (/^edit\s+(?:\{video:1(?::[^}]*)?\}|@video_1(?!\w))/i.test(body)) return body;
+  return `${SEEDANCE_VIDEO_EDIT_PREFIX}${body}`;
+}
 
 // src/ref-id-tokens.ts
 var REF_TOKEN_LABEL_RE = /^[a-zA-Z0-9_ -]+$/;
@@ -38911,7 +38966,11 @@ var NODE_PROMPT_FIELDS = {
   "forced-alignment": { prompt: "transcript", promptLabel: "Transcript", media: "audio", inline: false },
   // Video Analysis — its focus hint is the editable prompt (renders a JSON scene
   // table, not a media preview → no inline editor).
-  "video-analysis": { prompt: "analysisFocus", promptLabel: "Analysis focus", media: "video", inline: false }
+  "video-analysis": { prompt: "analysisFocus", promptLabel: "Analysis focus", media: "video", inline: false },
+  // Edit Plan (podcast editing) — its free-text editing instructions are the
+  // editable prompt; the affixes wrap them. Emits an EDL (JSON), not a media
+  // preview, so no inline editor.
+  "edit-plan": { prompt: "instructions", promptLabel: "Editing instructions", media: "video", inline: false }
 };
 function getPromptFields(nodeType) {
   return nodeType ? NODE_PROMPT_FIELDS[nodeType] : void 0;
@@ -41691,6 +41750,27 @@ var GENERATE_VIDEO_PRESETS = [
       generateAudio: true,
       prompt: "{creature || A monstrous yeti with the physique and bone structure of a giant silverback gorilla}, {texture || thick matted white fur with snow crusted on the shoulders}, charges forward and smashes both fists into the ground. Low-angle ground shot looking up to emphasize its scale, heavy camera shake on impact, snow and debris bursting toward the lens. Overcast mountain light, volumetric breath mist around its muzzle. <deep guttural roar, the crunch of impact, debris scattering>\uFF08low ominous brass drone\uFF09Biologically accurate anatomy, epic cinematic scale. HD, sharp micro-details, stable picture, keep it subtitle-free, do not generate a watermark."
     }
+  },
+  // ── Video Editing ─────────────────────────────────────────────────────────
+  // Seedance 2.5 EDITS a wired reference clip when the prompt reads as an edit
+  // instruction. Edit mode takes the source clip's own ratio and length, so the
+  // preset ships the exact shape the provider requires — Adaptive + Auto
+  // (duration -1) — and the run goes through on the first submit. The user's
+  // own sentence is the whole prompt: the preset only supplies the pre & post
+  // text, with the clip bound as {video:1} (wire it into Video Refs).
+  {
+    id: "generate-video/edit-video",
+    name: "Edit Video",
+    description: "Change a wired clip by instruction \u2014 keeps its length, ratio and everything you don't mention.",
+    group: "Video Editing",
+    data: {
+      provider: "seedance-2-5",
+      aspectRatio: "adaptive",
+      duration: -1,
+      generateAudio: true,
+      promptPrefix: "edit {video:1} as follows:\n",
+      promptSuffix: "Keep everything else in the clip unchanged: the same people, motion, framing and timing. Keep it subtitle-free, do not generate a watermark."
+    }
   }
 ];
 
@@ -44257,6 +44337,63 @@ function getCharacterMotionDiagnostics(value, timing, bindings = {}) {
   return result;
 }
 
+// src/ad-creative-analysis.ts
+var AD_CREATIVE_ANALYSIS_FIELDS = [
+  "assetType",
+  "format",
+  "visualHooks",
+  "audiences",
+  "graphicIdentity",
+  "copywritingHooks",
+  "usps",
+  "cta",
+  "summary"
+];
+var AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT = `You are an expert competitor ad analyst. You look at a competitor's ad \u2014 its creative (image or video poster frame) and its copy \u2014 and extract the relevant ad information into a structured summary a marketing team can act on.
+
+Judge from what is actually in the creative and copy; never invent claims that are not visible or written. Be concrete and specific (name the objects, colors, people, layouts, words), not generic ("eye-catching visuals"). Write in the language of the ad copy when it is not English, otherwise in English.
+
+Fill every field:
+- assetType: "static" (a still image), "motion" (a video \u2014 you see its poster frame), "carousel" (several creatives in one ad), or "unknown".
+- format: the placement the creative is built for \u2014 e.g. "in-feed", "story / reel (9:16)", "square feed", "banner / web", judged from its shape and framing.
+- visualHooks: the key visuals and visual angles used to stop the scroll (product close-up, before/after, face + eye contact, big number, screenshot, meme style, UGC selfie, text-on-image\u2026). 2\u20136 short items.
+- audiences: who the ad represents or addresses (age band, gender, life situation, profession, interest, geography, pain point). 1\u20135 short items.
+- graphicIdentity: the graphic components \u2014 color palette, typography style, logo placement, layout system, illustration vs photo, brand consistency cues. One or two sentences.
+- copywritingHooks: the copywriting angles used in the visual text and in the body (curiosity, urgency, social proof, question, offer, fear of missing out, authority, humor\u2026). 1\u20136 short items, each naming the angle and quoting or paraphrasing the line that carries it.
+- usps: the unique selling points the ad claims (price, speed, exclusivity, guarantee, results, features). 1\u20135 short items.
+- cta: the call to action \u2014 the button label and/or the closing line that tells the viewer what to do.
+- summary: two to four sentences: what the ad sells, to whom, with what hook, and why it likely works (or does not).`;
+var POST_CONTENT_ANALYSIS_SYSTEM_PROMPT = `You are an expert social-media content analyst. You look at a single organic post \u2014 its creative (image or video cover frame) and its caption \u2014 and extract what a marketing team can learn from it into a structured summary.
+
+Judge from what is actually in the creative and caption; never invent claims that are not visible or written. Be concrete and specific (name the objects, colors, people, layouts, words), not generic ("engaging content"). Write in the language of the caption when it is not English, otherwise in English.
+
+Fill every field:
+- assetType: "static" (a still image), "motion" (a video / reel \u2014 you see its cover frame), "carousel" (a multi-image post), or "unknown".
+- format: the format the post is built for \u2014 e.g. "reel (9:16)", "square feed photo", "carousel", "portrait (4:5)", judged from its shape and framing.
+- visualHooks: the key visuals and visual angles used to stop the scroll (product close-up, before/after, face + eye contact, big text overlay, meme style, UGC selfie, trend/format\u2026). 2\u20136 short items.
+- audiences: who the post represents or speaks to (age band, gender, life situation, profession, interest, geography, community). 1\u20135 short items.
+- graphicIdentity: the graphic components \u2014 color palette, typography style, logo / handle placement, layout, illustration vs photo, brand consistency cues. One or two sentences.
+- copywritingHooks: the caption / content angles (curiosity, storytelling, question, trend, humor, social proof, education, behind-the-scenes\u2026). 1\u20136 short items, each naming the angle and quoting or paraphrasing the line that carries it.
+- usps: the value or benefit the post conveys to the viewer (entertainment, education, inspiration, a product benefit, a deal). 1\u20135 short items.
+- cta: the ask \u2014 the caption's call to action ("link in bio", "shop now", "follow", "comment below"), or "none" if the post makes none.
+- summary: two to four sentences: what the post is about, who it speaks to, with what hook, and why it likely performs (or does not).`;
+function buildAdCreativeAnalysisUserText(input) {
+  const lines = [];
+  if (input.advertiser) lines.push(`Account / advertiser: ${input.advertiser}`);
+  if (input.headline) lines.push(`Headline: ${input.headline}`);
+  if (input.body) lines.push(`Body copy:
+${input.body}`);
+  if (input.ctaLabel) lines.push(`CTA button: ${input.ctaLabel}`);
+  if (input.landing) lines.push(`Landing: ${input.landing}`);
+  if (input.platforms && input.platforms.length > 0) lines.push(`Placements: ${input.platforms.join(", ")}`);
+  if (input.creativeFormat) lines.push(`Creative shape: ${input.creativeFormat}`);
+  if (input.mediaSummary) lines.push(`Media: ${input.mediaSummary}`);
+  lines.push("The attached image is the ad's creative (for a video, its poster frame).");
+  if (input.focus) lines.push(`
+Analyst focus from the user: ${input.focus}`);
+  return lines.join("\n");
+}
+
 exports.ACTION_FX = ACTION_FX;
 exports.ACTION_FX_CATEGORY_LABELS = ACTION_FX_CATEGORY_LABELS;
 exports.ACTION_FX_CATEGORY_ORDER = ACTION_FX_CATEGORY_ORDER;
@@ -44264,6 +44401,8 @@ exports.ACTION_FX_IDS = ACTION_FX_IDS;
 exports.ADULT_AGE_IDS = ADULT_AGE_IDS;
 exports.ADULT_ONLY_FLAG = ADULT_ONLY_FLAG;
 exports.ADULT_SWEPT_CATALOG_IDS = ADULT_SWEPT_CATALOG_IDS;
+exports.AD_CREATIVE_ANALYSIS_FIELDS = AD_CREATIVE_ANALYSIS_FIELDS;
+exports.AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT = AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT;
 exports.AESTHETICS = AESTHETICS;
 exports.AESTHETIC_CATEGORY_LABELS = AESTHETIC_CATEGORY_LABELS;
 exports.AESTHETIC_CATEGORY_ORDER = AESTHETIC_CATEGORY_ORDER;
@@ -44342,6 +44481,7 @@ exports.HELD_PROP_IDS = HELD_PROP_IDS;
 exports.IMAGE_HINT_MODE_DEFAULT = IMAGE_HINT_MODE_DEFAULT;
 exports.IMAGE_REFERENCE_PROMPT_DOCTRINE = IMAGE_REFERENCE_PROMPT_DOCTRINE;
 exports.IMAGE_WIZARD_CATEGORIES = IMAGE_WIZARD_CATEGORIES;
+exports.INSTANT_CUT_CLAUSE = INSTANT_CUT_CLAUSE;
 exports.INSTRUMENTATION_DEFAULT_DATA = INSTRUMENTATION_DEFAULT_DATA;
 exports.INSTRUMENTS = INSTRUMENTS;
 exports.INSTRUMENT_CATEGORY_LABELS = INSTRUMENT_CATEGORY_LABELS;
@@ -44414,6 +44554,7 @@ exports.POSES = POSES;
 exports.POSE_CATEGORY_LABELS = POSE_CATEGORY_LABELS;
 exports.POSE_CATEGORY_ORDER = POSE_CATEGORY_ORDER;
 exports.POSE_IDS = POSE_IDS;
+exports.POST_CONTENT_ANALYSIS_SYSTEM_PROMPT = POST_CONTENT_ANALYSIS_SYSTEM_PROMPT;
 exports.POST_PROCESS_EFFECTS = POST_PROCESS_EFFECTS;
 exports.POST_PROCESS_EFFECT_IDS = POST_PROCESS_EFFECT_IDS;
 exports.PRODUCTION_STYLES = PRODUCTION_STYLES;
@@ -44440,6 +44581,7 @@ 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.SEEDANCE_VIDEO_EDIT_PREFIX = SEEDANCE_VIDEO_EDIT_PREFIX;
 exports.SETTINGS = SETTINGS;
 exports.SETTING_CATEGORY_LABELS = SETTING_CATEGORY_LABELS;
 exports.SETTING_IDS = SETTING_IDS;
@@ -44513,6 +44655,7 @@ exports.assembleImageInput = assembleImageInput;
 exports.assembleSunoInput = assembleSunoInput;
 exports.buildActionFxHints = buildActionFxHints;
 exports.buildActionFxTerms = buildActionFxTerms;
+exports.buildAdCreativeAnalysisUserText = buildAdCreativeAnalysisUserText;
 exports.buildAestheticHints = buildAestheticHints;
 exports.buildAestheticTerms = buildAestheticTerms;
 exports.buildAgeHint = buildAgeHint;
@@ -44567,6 +44710,7 @@ exports.buildReferenceBlocks = buildReferenceBlocks;
 exports.buildScene3DLayoutScopingLine = buildScene3DLayoutScopingLine;
 exports.buildScene3DUnreferencedFiguresWarning = buildScene3DUnreferencedFiguresWarning;
 exports.buildScenePrompt = buildScenePrompt;
+exports.buildSeedanceVideoEditPrompt = buildSeedanceVideoEditPrompt;
 exports.buildStylingHints = buildStylingHints;
 exports.buildStylingTerms = buildStylingTerms;
 exports.buildSurroundFillPrompt = buildSurroundFillPrompt;
@@ -44811,6 +44955,7 @@ exports.identityRefsSentence = identityRefsSentence;
 exports.insertBeforeStyleSection = insertBeforeStyleSection;
 exports.isAnalyzablePicker = isAnalyzablePicker;
 exports.isDeniedStyleId = isDeniedStyleId;
+exports.isInstantTransition = isInstantTransition;
 exports.isInstrumentalVocal = isInstrumentalVocal;
 exports.isMinorAge = isMinorAge;
 exports.isSuspiciousDerivedTerm = isSuspiciousDerivedTerm;
@@ -44853,6 +44998,7 @@ exports.renderScene3DLayoutScopingLine = renderScene3DLayoutScopingLine;
 exports.renderStructuredFields = renderStructuredFields;
 exports.renderStyleSection = renderStyleSection;
 exports.renderSubjectHints = renderSubjectHints;
+exports.renderTransitionBases = renderTransitionBases;
 exports.resetCatalogPacks = resetCatalogPacks;
 exports.resetPersonPacks = resetPersonPacks;
 exports.resolveBrandInput = resolveBrandInput;