@nodaro/prompts 1.28.0 → 1.29.0

package/dist/index.cjs

@@ -5159,7 +5159,8 @@ var TRANSITIONS = [
     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",
-    instant: true
+    instant: true,
+    blendable: true
   },
   {
     id: "whip-pan",
@@ -5572,7 +5573,8 @@ var TRANSITIONS = [
     description: "Subject jumps, landing matches into new scene",
     promptHint: "the subject launches into a jump, and at the height of the leap the picture cuts to a new place. The camera follows the arc of the jump at the same speed on both sides of the cut, and the subject stays at the same place in the frame. In the second shot the same jump carries on without a break, and the subject comes down and lands in the new place. The shot ends on the subject landed in the second shot, fully resolved",
     term: "match cut on a jump",
-    instant: true
+    instant: true,
+    blendable: true
   },
   {
     id: "hand-swipe",
@@ -5769,6 +5771,14 @@ function isInstantTransition(id) {
   if (ids.length === 0) return false;
   return ids.every((one) => getTransition(one)?.instant === true);
 }
+function isBlendableTransition(id) {
+  const ids = typeof id === "string" ? [id] : id ? [...id] : [];
+  if (ids.length === 0) return false;
+  return ids.every((one) => {
+    const t = getTransition(one);
+    return t?.instant === true && t.blendable === 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, " ");
@@ -5777,16 +5787,23 @@ function transitionHintBody(id, term, values2) {
   const t = normalizePhrase(term);
   return hint.split(/,\s*/).filter((item) => normalizePhrase(item) !== t).join(", ").trim();
 }
-function transitionFragment(id, withCutClause, values2) {
+function transitionFragment(id, cutClause, values2) {
   const term = getTransitionTerm(id);
   if (!term) return "";
-  const inner = [transitionHintBody(id, term, values2), withCutClause ? INSTANT_CUT_CLAUSE : ""].filter((part) => part.length > 0).join("; ");
+  const inner = [transitionHintBody(id, term, values2), cutClause].filter((part) => part.length > 0).join("; ");
   return inner.length > 0 && normalizePhrase(inner) !== normalizePhrase(term) ? `${term} (${inner})` : term;
 }
 function renderTransitionBases(ids, _mode = "full", values2) {
+  return renderBasesWith(ids, INSTANT_CUT_CLAUSE, values2);
+}
+function renderBasesWith(ids, cutClause, values2) {
   const picked = ids.filter((id) => getTransitionTerm(id).length > 0);
   const instant = isInstantTransition(picked);
-  return picked.map((id, i) => transitionFragment(id, instant && i === 0, values2));
+  return picked.map((id, i) => transitionFragment(id, instant && i === 0 ? cutClause : "", values2));
+}
+function blendedCutClause(duration3) {
+  const row = TRANSITION_DURATIONS.find((d) => d.id === duration3);
+  return row?.blendsCut ? `instead of a hard cut, the two shots blend into each other over ${row.term}` : "";
 }
 var TRANSITION_POSITIONS = [
   { id: "auto", label: "Auto", description: "Let the model place it", promptHint: "", term: "" },
@@ -5798,7 +5815,7 @@ var TRANSITION_POSITIONS = [
 var TRANSITION_DURATIONS = [
   { id: "auto", label: "Auto", description: "Let the model time it", promptHint: "", term: "" },
   { id: "instant", label: "Instant", description: "No perceptible duration", promptHint: "occurring instantaneously", term: "instantaneous" },
-  { id: "short", label: "Short (~1s)", description: "Approximately 1 second", promptHint: "lasting approximately 1 second", term: "about 1 second" },
+  { id: "short", label: "Short (~1s)", description: "Approximately 1 second", promptHint: "lasting approximately 1 second", term: "about 1 second", blendsCut: true },
   { id: "medium", label: "Medium (~2s)", description: "Approximately 2 seconds", promptHint: "lasting approximately 2 seconds", term: "about 2 seconds" },
   { id: "long", label: "Long (~3s)", description: "Approximately 3 seconds", promptHint: "lasting approximately 3 seconds", term: "about 3 seconds" }
 ];
@@ -5823,11 +5840,13 @@ var SHOT_POSITION_CLAUSES = Object.fromEntries(
 );
 var DURATION_CLAUSES = clausesOf(TRANSITION_DURATIONS);
 var INTENSITY_CLAUSES = clausesOf(TRANSITION_INTENSITIES);
-function composeTransitionHintFromConnections(transitionId, startHints, endHints, timing, mode = "full", options) {
+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 baseHints = renderTransitionBases(ids, mode, options?.optionValues);
+  const contributing = ids.filter((id) => getTransitionTerm(id).length > 0);
+  const instant = isInstantTransition(contributing);
+  const blend = instant && isBlendableTransition(contributing) ? blendedCutClause(timing?.duration) : "";
+  const baseHints = renderBasesWith(ids, blend || INSTANT_CUT_CLAUSE, options?.optionValues);
   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" && !(instant && timing.position === "full")) {
@@ -21588,6 +21607,8 @@ function toOptions(arr, categoryField) {
     if (categoryField) opt.category = e[categoryField];
     if (e.adultOnly) opt.adultOnly = true;
     if (e.instant) opt.instant = true;
+    if (e.blendable) opt.blendable = true;
+    if (e.blendsCut) opt.blendsCut = true;
     if (e.options?.length) {
       opt.params = e.options.map((o) => ({
         field: o.field,
@@ -47680,6 +47701,7 @@ exports.applyTemplate = applyTemplate;
 exports.asBodyClauses = asBodyClauses;
 exports.assembleImageInput = assembleImageInput;
 exports.assembleSunoInput = assembleSunoInput;
+exports.blendedCutClause = blendedCutClause;
 exports.buildActionFxHints = buildActionFxHints;
 exports.buildActionFxTerms = buildActionFxTerms;
 exports.buildAdCreativeAnalysisUserText = buildAdCreativeAnalysisUserText;
@@ -47986,6 +48008,7 @@ exports.hasUpstreamCharacter = hasUpstreamCharacter;
 exports.identityRefsSentence = identityRefsSentence;
 exports.insertBeforeStyleSection = insertBeforeStyleSection;
 exports.isAnalyzablePicker = isAnalyzablePicker;
+exports.isBlendableTransition = isBlendableTransition;
 exports.isDeniedStyleId = isDeniedStyleId;
 exports.isInstantTransition = isInstantTransition;
 exports.isInstrumentalVocal = isInstrumentalVocal;