@nodaro/prompts 1.28.0 → 1.30.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,
@@ -45622,6 +45643,20 @@ var VOICE_DESIGN_PRESETS = [
     group: "Narration & Character",
     data: { voiceDescription: "A calm, soft-spoken meditation guide with a slow, breathy, reassuring delivery." }
   },
+  {
+    id: "voice-design/casual-creator-female",
+    name: "Casual Creator (female)",
+    description: "Relaxed, warm, everyday.",
+    group: "Narration & Character",
+    data: { voiceDescription: "An adult woman in her late twenties talking casually to the viewer as if telling a friend about something she tried: relaxed, warm and upbeat, a natural conversational pace with small pauses, a light neutral American accent, recorded close and dry in a quiet room, never polished or announcer-like." }
+  },
+  {
+    id: "voice-design/casual-creator-male",
+    name: "Casual Creator (male)",
+    description: "Relaxed, warm, everyday.",
+    group: "Narration & Character",
+    data: { voiceDescription: "An adult man in his late twenties talking casually to the viewer as if telling a friend about something he tried: relaxed, warm and upbeat, a natural conversational pace with small pauses, a light neutral American accent, recorded close and dry in a quiet room, never polished or announcer-like." }
+  },
   // ── Professional & Assistant ─────────────────────────────────────────────
   {
     id: "voice-design/hype-announcer",
@@ -45729,6 +45764,27 @@ var TEXT_TO_AUDIO_PRESETS = [
     group: "Ambiences (loopable)",
     data: { provider: "elevenlabs-sfx", duration: 22, loop: true, promptInfluence: 0.5, prompt: "low sci-fi ambient drone, ominous spaceship hum" }
   },
+  {
+    id: "text-to-audio/living-room-tone",
+    name: "Living Room Tone",
+    description: "Quiet, lived-in room.",
+    group: "Ambiences (loopable)",
+    data: { provider: "elevenlabs-sfx", duration: 22, loop: true, promptInfluence: 0.4, prompt: "quiet living room room tone, faint air and a soft distant household hum, steady and even, an empty room at rest" }
+  },
+  {
+    id: "text-to-audio/kitchen-hum",
+    name: "Kitchen Hum",
+    description: "Fridge hum in a still kitchen.",
+    group: "Ambiences (loopable)",
+    data: { provider: "elevenlabs-sfx", duration: 22, loop: true, promptInfluence: 0.4, prompt: "home kitchen room tone, a low steady refrigerator hum with faint air, calm and continuous, an empty kitchen at rest" }
+  },
+  {
+    id: "text-to-audio/cafe-murmur",
+    name: "Caf\xE9 Murmur",
+    description: "Soft, indistinct caf\xE9 chatter.",
+    group: "Ambiences (loopable)",
+    data: { provider: "elevenlabs-sfx", duration: 22, loop: true, promptInfluence: 0.4, prompt: "caf\xE9 background ambience, a soft indistinct murmur of distant conversation and the occasional faint cup clink, steady and even, no clear words" }
+  },
   // ── UI & Stingers ────────────────────────────────────────────────────────
   {
     id: "text-to-audio/ui-click",
@@ -45884,6 +45940,16 @@ var LLM_CHAT_PRESETS = [
       temperature: 0.7
     }
   },
+  {
+    id: "llm-chat/hook-generator",
+    name: "Hook Generator",
+    description: "10 opening lines for a talking-to-camera video.",
+    group: "Writing & Marketing",
+    data: {
+      systemPrompt: "You write opening lines for short vertical videos in which one person talks straight to the camera about a product, a site or an idea. Given the user's topic, write 10 different opening lines.\n\nEvery line:\n- is one short spoken clause of at most 8 words;\n- leads with the payload the viewer can check: a number, a price, a time saved, a before and after, a contrast with the usual way, or a named result;\n- opens on the claim itself \u2014 no greeting, no filler word, no introduction of the product before the claim;\n- sounds said, not written: plain words, contractions welcome, no hashtags, no emoji, no stage directions;\n- spells the product or brand exactly as the user gives it and writes numbers as digits.\n\nVary the angle across the 10: a surprising number, a price, time saved, a mistake to avoid, a before and after, a contrast, a named result, a direct question. Write in the language the user writes in. Return only the numbered list, one line each.",
+      temperature: 0.9
+    }
+  },
   // ── Utility ──────────────────────────────────────────────────────────────
   {
     id: "llm-chat/prompt-enhancer",
@@ -46065,6 +46131,16 @@ var IMAGE_TO_TEXT_PRESETS = [
     group: "Extraction",
     data: { detailLevel: "detailed", customPrompt: "Write a compelling e-commerce product description based on this product image." }
   },
+  {
+    id: "image-to-text/site-screenshot-summary",
+    name: "Site Screenshot Summary",
+    description: "Section, headings and figures from a web page.",
+    group: "Extraction",
+    data: {
+      detailLevel: "structured",
+      customPrompt: 'Describe this website screenshot as five labelled lines. Section: which part of the site it is (for example the top of the home page, a feature, how it works, reviews, pricing, sign-up, navigation or footer). Headings: every heading exactly as written. Figures: every number, price, rating and date exactly as written, each with what it refers to. Brand: the product or company name exactly as spelled. First look: what a viewer notices first, in one sentence. Write "none" on a line with nothing to report.'
+    }
+  },
   // ── Creative ─────────────────────────────────────────────────────────────
   {
     id: "image-to-text/scene-description",
@@ -46176,6 +46252,20 @@ var ADD_CAPTIONS_PRESETS = [
     description: "Subtitles along the top.",
     group: "Caption Styles",
     data: { style: "subtitle", position: "top", fontSize: 36, color: "#FFFFFF", autoTranscribe: true }
+  },
+  {
+    id: "add-captions/hook-plate",
+    name: "Hook Plate",
+    description: "Your opening line as a bold plate near the top.",
+    group: "Caption Styles",
+    data: { style: "subtitle", look: "clean", position: "top", positionY: 20, fontSize: 32, fontWeight: 800, maxWordsPerLine: 4, color: "#111111", backgroundColor: "#FFFFFF", autoTranscribe: false }
+  },
+  {
+    id: "add-captions/body-captions",
+    name: "Body Captions",
+    description: "Word-by-word captions under the face.",
+    group: "Caption Styles",
+    data: { style: "word-highlight", look: "outline", position: "bottom", positionY: 72, fontSize: 32, maxWordsPerLine: 3, color: "#FFFFFF", autoTranscribe: true }
   }
 ];
 var COMBINE_VIDEOS_PRESETS = [
@@ -46737,6 +46827,80 @@ function getFactoryPresets(nodeType) {
   return FACTORY_PRESETS[nodeType] ?? [];
 }
 
+// src/caption-treatments.ts
+var HOOK_PLATE_PRESET_ID = "add-captions/hook-plate";
+var BODY_CAPTIONS_PRESET_ID = "add-captions/body-captions";
+var CAPTION_LEVERS_BY_LANGUAGE = {
+  he: { fontFamily: "Rubik", uppercase: false }
+};
+var CAPTION_SEGMENT_LEVER_KEYS = [
+  "style",
+  "position",
+  "fontSize",
+  "color",
+  "backgroundColor",
+  "look",
+  "fontFamily",
+  "fontWeight",
+  "strokeColor",
+  "strokeWidth",
+  "highlightColor",
+  "uppercase",
+  "positionY",
+  "animate",
+  "maxWordsPerLine"
+];
+var LEVER_KEYS = new Set(CAPTION_SEGMENT_LEVER_KEYS);
+function pickLevers(source) {
+  const out = {};
+  if (!source) return out;
+  for (const [k, v] of Object.entries(source)) if (LEVER_KEYS.has(k) && v !== void 0 && v !== null) out[k] = v;
+  return out;
+}
+function presetLevers(id) {
+  const preset = ADD_CAPTIONS_PRESETS.find((p) => p.id === id);
+  if (!preset) throw new Error(`The ${id} caption preset is missing from the catalog.`);
+  return pickLevers(preset.data);
+}
+var PLATE_LEVERS = presetLevers(HOOK_PLATE_PRESET_ID);
+var BODY_LEVERS = presetLevers(BODY_CAPTIONS_PRESET_ID);
+function languageLevers(tag) {
+  if (typeof tag !== "string") return {};
+  const primary = tag.trim().split(/[-_]/)[0].toLowerCase();
+  return Object.hasOwn(CAPTION_LEVERS_BY_LANGUAGE, primary) ? CAPTION_LEVERS_BY_LANGUAGE[primary] : {};
+}
+var isTime = (n) => typeof n === "number" && Number.isFinite(n);
+function hookPlateCaptionSegments(plan, opts = {}) {
+  const hookEnd = plan.hookEndMs;
+  if (!isTime(hookEnd) || hookEnd < 0) return { segments: [], dropped: ["hook", "body"] };
+  const language = languageLevers(plan.language);
+  const limit = typeof plan.videoDurationMs === "number" ? plan.videoDurationMs : Number.POSITIVE_INFINITY;
+  const segments = [];
+  const dropped = [];
+  const plateEnd = Math.min(hookEnd, limit);
+  if (plateEnd > 0 && typeof plan.hookText === "string" && /\S/.test(plan.hookText)) {
+    segments.push({ startMs: 0, endMs: plateEnd, text: plan.hookText, ...PLATE_LEVERS, ...language });
+  } else {
+    dropped.push("hook");
+  }
+  const bodyEnd = Math.min(plan.bodyEndMs, limit);
+  const words = Array.isArray(plan.captions) ? plan.captions : [];
+  const chosen = pickLevers(opts.bodyLevers);
+  const bodyLevers = Object.keys(chosen).length > 0 ? chosen : BODY_LEVERS;
+  if (bodyEnd > hookEnd && words.length > 0) {
+    segments.push({
+      startMs: hookEnd,
+      endMs: bodyEnd,
+      captions: words.map((w) => ({ text: w.text, startMs: w.startMs, endMs: w.endMs })),
+      ...bodyLevers,
+      ...language
+    });
+  } else {
+    dropped.push("body");
+  }
+  return { segments, dropped };
+}
+
 // src/style-presets.ts
 var STYLE_PRESETS = [
   {
@@ -47425,6 +47589,7 @@ exports.BACKDROPS = BACKDROPS;
 exports.BACKDROP_CATEGORY_LABELS = BACKDROP_CATEGORY_LABELS;
 exports.BACKDROP_CATEGORY_ORDER = BACKDROP_CATEGORY_ORDER;
 exports.BACKDROP_IDS = BACKDROP_IDS;
+exports.BODY_CAPTIONS_PRESET_ID = BODY_CAPTIONS_PRESET_ID;
 exports.BRAND_PRESETS = BRAND_PRESETS;
 exports.BRAND_PRESET_IDS = BRAND_PRESET_IDS;
 exports.BRAND_PRESET_META = BRAND_PRESET_META;
@@ -47434,6 +47599,8 @@ exports.CAMERA_MOTIONS = CAMERA_MOTIONS;
 exports.CAMERA_MOTION_CATEGORY_LABELS = CAMERA_MOTION_CATEGORY_LABELS;
 exports.CAMERA_MOTION_CATEGORY_ORDER = CAMERA_MOTION_CATEGORY_ORDER;
 exports.CAMERA_MOTION_IDS = CAMERA_MOTION_IDS;
+exports.CAPTION_LEVERS_BY_LANGUAGE = CAPTION_LEVERS_BY_LANGUAGE;
+exports.CAPTION_SEGMENT_LEVER_KEYS = CAPTION_SEGMENT_LEVER_KEYS;
 exports.CHARACTER_ART_FAMILIES = CHARACTER_ART_FAMILIES;
 exports.CHARACTER_ART_FILES = CHARACTER_ART_FILES;
 exports.CHARACTER_ART_PATH = CHARACTER_ART_PATH;
@@ -47491,6 +47658,7 @@ exports.HELD_PROPS = HELD_PROPS;
 exports.HELD_PROP_CATEGORY_LABELS = HELD_PROP_CATEGORY_LABELS;
 exports.HELD_PROP_CATEGORY_ORDER = HELD_PROP_CATEGORY_ORDER;
 exports.HELD_PROP_IDS = HELD_PROP_IDS;
+exports.HOOK_PLATE_PRESET_ID = HOOK_PLATE_PRESET_ID;
 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;
@@ -47680,6 +47848,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;
@@ -47983,9 +48152,11 @@ exports.groupFactoryPresets = groupFactoryPresets;
 exports.hasCatalogPacksFor = hasCatalogPacksFor;
 exports.hasScene3DLayoutScopingLine = hasScene3DLayoutScopingLine;
 exports.hasUpstreamCharacter = hasUpstreamCharacter;
+exports.hookPlateCaptionSegments = hookPlateCaptionSegments;
 exports.identityRefsSentence = identityRefsSentence;
 exports.insertBeforeStyleSection = insertBeforeStyleSection;
 exports.isAnalyzablePicker = isAnalyzablePicker;
+exports.isBlendableTransition = isBlendableTransition;
 exports.isDeniedStyleId = isDeniedStyleId;
 exports.isInstantTransition = isInstantTransition;
 exports.isInstrumentalVocal = isInstrumentalVocal;