@nodaro/prompts 1.21.0 → 1.25.0

package/dist/index.d.ts

@@ -1121,6 +1121,297 @@ interface StructuredPromptFields {
  */
 declare function renderStructuredFields(fields: StructuredPromptFields): string;
 
+/**
+ * Canonical catalog of cinematic transitions for AI-video generation.
+ *
+ * Shared between frontend (picker UI, prompt hint injection) and backend
+ * (orchestrator payload builder). The `promptHint` is a natural-language
+ * cue that gets composed into the user prompt when a transition node is
+ * connected to a video consumer.
+ *
+ * Multi-pick supported: value field accepts `string | string[]` (cap 2).
+ * Graph-aware: `startState` / `endState` input handles accept upstream
+ * parameter nodes whose hints are folded into the composed clause as
+ * "starting from <X>, ending at <Y>".
+ */
+
+type TransitionCategory = "standard" | "time" | "element" | "morph" | "portal" | "physics" | "light" | "glitch";
+interface Transition {
+    readonly id: string;
+    readonly label: string;
+    readonly category: TransitionCategory;
+    readonly description: string;
+    readonly promptHint: string;
+    /**
+     * Optional authored compact term (see `term.ts`). Authored where the
+     * lowercased label is not what an editor would write in a prompt — a UI
+     * compound ("None / Hard Cut" → "hard cut"), an annotation the derivation
+     * drops ("Fast-Forward (Day → Night)" → "day-to-night time-lapse"), a bare
+     * word that collides with another meaning ("Melt Down", "Channel Flip",
+     * "Roll"), or a coinage that is not the trade term ("Seamless Match" →
+     * "invisible cut"). Everywhere else the label IS the term.
+     */
+    readonly term?: string;
+    /**
+     * `true` on rows whose mechanism IS A CUT — the change happens between two
+     * frames, so it has no duration to time. A duration clause ("lasting
+     * approximately 1 second") on such a row tells the video model to spend a
+     * second on the change, and it obliges with a dissolve: a match cut rendered
+     * as a 1.75 s cross-dissolve in QA. The composer therefore skips the duration
+     * lever when every picked transition is instant, and consumers (the picker
+     * UI, Studio) read `isInstantTransition` to hide that lever.
+     *
+     * The same holds for INTENSITY: every intensity clause describes how the
+     * change PERFORMS over time ("natural unhurried timing", "wild flourishes and
+     * dramatic distortion"), and a cut has no performance to shape — "unhurried"
+     * on a match cut is another invitation to blend. So the composer drops the
+     * intensity clause too when every pick is instant. Position still applies —
+     * WHERE the cut lands is a real choice — except `full`: a single-frame cut
+     * cannot "span the entire clip", so that clause is dropped on an all-instant
+     * pick (start / middle / end still place the cut).
+     *
+     * The bare term is not enough on its own either: "match cut" still came back
+     * as a ~1 s superimposition in prod QA (seedance-2-5). The composer therefore
+     * puts `INSTANT_CUT_CLAUSE` inside an all-instant pick's parentheses, once — the explicit
+     * anti-blend instruction that made the model render a true single-frame cut.
+     */
+    readonly instant?: boolean;
+}
+/**
+ * The three timing scales, each derived from the catalog that defines it (see
+ * `TRANSITION_POSITIONS` and friends below).
+ *
+ * The direction matters. These used to be hand-written unions with the clause
+ * tables written out separately beside them, so the two could disagree: add a
+ * step to the union, forget the clause, and the composer indexed a missing key
+ * — pushing `undefined` into the parts list, which `join(", ")` renders as a
+ * dangling separator on a prompt that then ships to a provider with the user's
+ * chosen parameter silently dropped. Deriving the union FROM the catalog makes
+ * that unrepresentable: one array is the source of the type, the option list
+ * the API serves, and the clause table, so a new step reaches all three or
+ * none. The exact id sets are pinned by `transition-timing-catalogs.test.ts`.
+ */
+type TransitionPosition = (typeof TRANSITION_POSITIONS)[number]["id"];
+type TransitionDuration = (typeof TRANSITION_DURATIONS)[number]["id"];
+type TransitionIntensity = (typeof TRANSITION_INTENSITIES)[number]["id"];
+interface TransitionTiming {
+    position?: TransitionPosition;
+    duration?: TransitionDuration;
+    intensity?: TransitionIntensity;
+}
+declare const TRANSITIONS: ReadonlyArray<Transition>;
+declare const TRANSITION_CATEGORY_ORDER: ReadonlyArray<TransitionCategory>;
+declare const TRANSITION_CATEGORY_LABELS: Readonly<Record<TransitionCategory, string>>;
+declare function getTransition(id: string | undefined | null): Transition | undefined;
+declare function getTransitionLabel(id: string | undefined | null, fallback?: string): string;
+declare function getTransitionPromptHint(id: string | undefined | null): string;
+/**
+ * Compact professional TERM for an id — the short phrase an editor would write
+ * in a prompt ("hard cut", "invisible cut", "day-to-night time-lapse"), as
+ * opposed to the paragraph-length `promptHint`.
+ *
+ * Same lookup and same empty-string-on-miss behavior as
+ * `getTransitionPromptHint`, so the two can never disagree about which entry
+ * they describe. The no-op "Auto" entry resolves to `""` in both.
+ */
+declare function getTransitionTerm(id: string | undefined | null): string;
+declare const TRANSITION_IDS: ReadonlyArray<string>;
+/**
+ * Whether a transition is a CUT — instantaneous by nature, so it takes no
+ * duration (see `Transition.instant`). Reads through `getTransition`, so it
+ * answers for the same entry every other getter describes; an unknown id, the
+ * no-op "auto" and an empty value are all `false`.
+ *
+ * A multi-pick (`string[]`) is instant only when EVERY picked id is: a cut
+ * paired with a dissolve still has a dissolve to time.
+ */
+declare function isInstantTransition(id: string | ReadonlyArray<string> | undefined | null): boolean;
+/**
+ * The anti-blend instruction an all-instant transition pick carries — the ONE
+ * place this sentence lives (see `Transition.instant`). Each row keeps its own
+ * meaning in its own hint (a match cut still matches shapes, snap to black
+ * still holds black for a beat); this clause only forbids the blend a video
+ * model otherwise puts between the two images. Measured on prod with
+ * seedance-2-5: with it, a match cut renders as a true single-frame hard cut,
+ * with and without an end frame; without it, as a ~1 s dissolve.
+ */
+declare const INSTANT_CUT_CLAUSE = "an abrupt single-frame hard cut, no dissolve, crossfade or superimposition; the two images never blend";
+/**
+ * The transition BASE fragments for a pick — one `<term> (<hint body>)` per id
+ * that resolves to a term, in pick order. When EVERY contributing id is
+ * instant, the FIRST fragment's parentheses also carry `; INSTANT_CUT_CLAUSE`
+ * (once per pick — two cuts picked together are still one cut). FIRST, not
+ * last: the direction fold sheds fragments from the TAIL under a provider cap,
+ * so the clause rides the fragment that survives longest. A mixed pick carries
+ * no clause: its non-cut is meant to blend.
+ *
+ * The same text in both hint modes. A transition only ever reaches a VIDEO
+ * prompt (the registry row is `surface: "video"`; the canvas node is in
+ * `VIDEO_ONLY_PARAMETER_NODE_TYPES`), and there the bare compact term was not
+ * enough to steer the model, so the mode no longer changes a transition.
+ *
+ * Each fragment is ONE string, parentheses included: the cap-aware assemblers
+ * shed whole fragments from the tail, so a fragment is kept or dropped whole
+ * and can never lose its hint or its clause on its own.
+ *
+ * Shared by `composeTransitionHintFromConnections` (the canvas transition node,
+ * Studio's transition clauses) and the direction registry's `transition` row
+ * (the server fold of `direction.transition`), so both paths word a transition
+ * identically.
+ */
+declare function renderTransitionBases(ids: ReadonlyArray<string>, _mode?: PickerHintMode): string[];
+/**
+ * The transition node's three timing parameters, as catalogs.
+ *
+ * These are graded scales, not free numbers — the same shape as
+ * `exposure-settings`' aperture or `temporal`'s speed — so a consumer that can
+ * only send ids (Studio, the SDK, MCP) can offer them without composing prompt
+ * text of its own. `auto` is the no-op head of each scale: an empty
+ * `promptHint`, so an unset parameter contributes nothing and the model is left
+ * to decide, exactly as before these were enumerable.
+ *
+ * `POSITION_CLAUSES` / `DURATION_CLAUSES` / `INTENSITY_CLAUSES` below are
+ * DERIVED from these arrays, so the clause the composer injects and the hint
+ * the catalog advertises are the same string by construction and cannot drift.
+ */
+interface TransitionTimingOption {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    readonly promptHint: string;
+    readonly term?: string;
+}
+declare const TRANSITION_POSITIONS: readonly [{
+    readonly id: "auto";
+    readonly label: "Auto";
+    readonly description: "Let the model place it";
+    readonly promptHint: "";
+    readonly term: "";
+}, {
+    readonly id: "start";
+    readonly label: "Start";
+    readonly description: "At the opening of the clip";
+    readonly promptHint: "the transition occurs at the opening of the clip";
+    readonly term: "at the opening of the clip";
+}, {
+    readonly id: "middle";
+    readonly label: "Middle";
+    readonly description: "In the middle of the clip";
+    readonly promptHint: "the transition occurs in the middle of the clip";
+    readonly term: "mid-clip";
+}, {
+    readonly id: "end";
+    readonly label: "End";
+    readonly description: "At the end of the clip";
+    readonly promptHint: "the transition occurs at the end of the clip";
+    readonly term: "at the end of the clip";
+}, {
+    readonly id: "full";
+    readonly label: "Full";
+    readonly description: "Spans the entire clip";
+    readonly promptHint: "the transition spans the entire clip";
+    readonly term: "across the whole clip";
+}];
+declare const TRANSITION_DURATIONS: readonly [{
+    readonly id: "auto";
+    readonly label: "Auto";
+    readonly description: "Let the model time it";
+    readonly promptHint: "";
+    readonly term: "";
+}, {
+    readonly id: "instant";
+    readonly label: "Instant";
+    readonly description: "No perceptible duration";
+    readonly promptHint: "occurring instantaneously";
+    readonly term: "instantaneous";
+}, {
+    readonly id: "short";
+    readonly label: "Short (~1s)";
+    readonly description: "Approximately 1 second";
+    readonly promptHint: "lasting approximately 1 second";
+    readonly term: "about 1 second";
+}, {
+    readonly id: "medium";
+    readonly label: "Medium (~2s)";
+    readonly description: "Approximately 2 seconds";
+    readonly promptHint: "lasting approximately 2 seconds";
+    readonly term: "about 2 seconds";
+}, {
+    readonly id: "long";
+    readonly label: "Long (~3s)";
+    readonly description: "Approximately 3 seconds";
+    readonly promptHint: "lasting approximately 3 seconds";
+    readonly term: "about 3 seconds";
+}];
+declare const TRANSITION_INTENSITIES: readonly [{
+    readonly id: "auto";
+    readonly label: "Auto";
+    readonly description: "Let the model judge it";
+    readonly promptHint: "";
+    readonly term: "";
+}, {
+    readonly id: "subtle";
+    readonly label: "Subtle";
+    readonly description: "Restrained, minimal flourish";
+    readonly promptHint: "with subtle restrained energy and minimal flourish";
+    readonly term: "subtly";
+}, {
+    readonly id: "natural";
+    readonly label: "Natural";
+    readonly description: "Unhurried, unforced timing";
+    readonly promptHint: "with natural timing";
+    readonly term: "at a natural pace";
+}, {
+    readonly id: "dynamic";
+    readonly label: "Dynamic";
+    readonly description: "Assertive, energetic";
+    readonly promptHint: "with dynamic energy and assertive flourish";
+    readonly term: "energetically";
+}, {
+    readonly id: "crazy";
+    readonly label: "Crazy";
+    readonly description: "Extreme, wild, distorted";
+    readonly promptHint: "with extreme exaggerated energy, wild flourishes, and dramatic distortion";
+    readonly term: "wildly exaggerated";
+}];
+/**
+ * Where the composed hint lands. `"clip"` (the default) is a whole video's
+ * prompt, so a position is placed within "the clip". `"shot"` is one shot's
+ * time window inside a multi-shot prompt (`0-2s — …`, `2-4s — …`): there "the
+ * middle of the clip" points the model at the wrong span, so the position
+ * clause says "of this shot" instead.
+ */
+type TransitionHintScope = "clip" | "shot";
+interface TransitionHintOptions {
+    readonly scope?: TransitionHintScope;
+}
+/**
+ * Compose a structural prompt-hint sentence from a transition id (or array
+ * of 1-2 ids for multi-pick) plus optional start-state/end-state hints
+ * (collected by walking the source node's startState / endState input
+ * handle edges upstream) and optional timing fields.
+ *
+ * Behavior:
+ * - 0 hints (no transition, empty array, or all-empty hints) → ""
+ * - each pick rendered `<term> (<hint body>)` (`renderTransitionBases`),
+ *   n picks joined with ", and "
+ * - Timing/start/end clauses apply ONCE at the outer layer, not per-id
+ * - When every picked id is instant (a cut — see `isInstantTransition`) the
+ *   first base's parentheses carry `INSTANT_CUT_CLAUSE` once, and the
+ *   duration and intensity clauses are dropped; position still applies,
+ *   except `full` — a single-frame cut spans nothing, so it adds no clause
+ * - null input is treated like undefined (falsy short-circuit → returns "")
+ *
+ * @param mode Accepted for the picker-hint signature; a transition composes
+ *   the same text in both modes — each pick as `<term> (<hint body>)`, see
+ *   `renderTransitionBases`.
+ * @param options `scope: "shot"` when the hint is folded into one shot's time
+ *   window of a multi-shot prompt — the position clause then says "of this
+ *   shot" instead of "of the clip" (and `full`, on a non-cut, "spans this
+ *   entire shot"). Omitted, the wording is the clip's.
+ */
+declare function composeTransitionHintFromConnections(transitionId: string | ReadonlyArray<string> | undefined, startHints: ReadonlyArray<string>, endHints: ReadonlyArray<string>, timing?: TransitionTiming, mode?: PickerHintMode, options?: TransitionHintOptions): string;
+
 /**
  * THE DIRECTION REGISTRY — the single, ordered table of every cinematic
  * dimension the flat `direction` channel carries, plus the one renderer that
@@ -1468,7 +1759,7 @@ declare const DIRECTION_FIELDS: readonly [{
     readonly surface: "video";
     readonly family: "motion";
     readonly maxPicks: 2;
-    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+    readonly render: typeof renderTransitionBases;
 }, {
     readonly key: "loopSubject";
     readonly surface: "video";
@@ -2115,6 +2406,19 @@ declare const REF_BINDING: {
     readonly ordinal: (n: number) => string;
     readonly frame: (n: number, role: "opening" | "closing") => string;
 };
+/**
+ * The instruction that makes Seedance EDIT a wired clip rather than use it as a
+ * style reference — the Video to Video node's Seedance lane prepends it to the
+ * user's own sentence. Written with the EDITOR token (`{video:1}`) so it goes
+ * through the same reference resolver as any prompt: the source clip is the
+ * run's first reference video, so it resolves to `@video_1` on the wire. The
+ * instruction lands on its own line after it.
+ */
+declare const SEEDANCE_VIDEO_EDIT_PREFIX = "edit {video:1} as follows:\n";
+/** The user's sentence, framed as an edit of the source clip. Idempotent: a
+ *  prompt that already opens with the instruction (a preset's pre text, a
+ *  hand-written one, either token spelling) is left alone. */
+declare function buildSeedanceVideoEditPrompt(prompt: string | undefined): string;
 
 /**
  * `{ref:<id>}` / `{ref:<id>:<label>}` — id-addressed reference tokens.
@@ -3398,6 +3702,16 @@ interface PickerOption {
      * `label` and inject `term`; they never derive it themselves.
      */
     readonly term: string;
+    /**
+     * Transitions only: present (`true`) on a row whose mechanism is a CUT, so
+     * it takes no duration and no intensity — see `Transition.instant` /
+     * `isInstantTransition`. A consumer that only reads this wire catalog
+     * (Studio builds the transition Duration lever from
+     * `getPickerCatalog("transition")`) hides those levers for such a row. Carried from the base catalog; a row a catalog pack ADDS has
+     * it only when the pack's own option says so, and absent means "has a
+     * duration" — the safe reading, since the composer then behaves as before.
+     */
+    readonly instant?: true;
     /** Only present if the source catalog entry already carries a data icon/emoji/thumbnail field. */
     readonly icon?: string;
 }
@@ -6960,211 +7274,6 @@ declare function buildTemporalTerms(data: Record<string, unknown> & {
     temporalShutter?: unknown;
 }): string[];
 
-/**
- * Canonical catalog of cinematic transitions for AI-video generation.
- *
- * Shared between frontend (picker UI, prompt hint injection) and backend
- * (orchestrator payload builder). The `promptHint` is a natural-language
- * cue that gets composed into the user prompt when a transition node is
- * connected to a video consumer.
- *
- * Multi-pick supported: value field accepts `string | string[]` (cap 2).
- * Graph-aware: `startState` / `endState` input handles accept upstream
- * parameter nodes whose hints are folded into the composed clause as
- * "starting from <X>, ending at <Y>".
- */
-
-type TransitionCategory = "standard" | "time" | "element" | "morph" | "portal" | "physics" | "light" | "glitch";
-interface Transition {
-    readonly id: string;
-    readonly label: string;
-    readonly category: TransitionCategory;
-    readonly description: string;
-    readonly promptHint: string;
-    /**
-     * Optional authored compact term (see `term.ts`). Authored where the
-     * lowercased label is not what an editor would write in a prompt — a UI
-     * compound ("None / Hard Cut" → "hard cut"), an annotation the derivation
-     * drops ("Fast-Forward (Day → Night)" → "day-to-night time-lapse"), a bare
-     * word that collides with another meaning ("Melt Down", "Channel Flip",
-     * "Roll"), or a coinage that is not the trade term ("Seamless Match" →
-     * "invisible cut"). Everywhere else the label IS the term.
-     */
-    readonly term?: string;
-}
-/**
- * The three timing scales, each derived from the catalog that defines it (see
- * `TRANSITION_POSITIONS` and friends below).
- *
- * The direction matters. These used to be hand-written unions with the clause
- * tables written out separately beside them, so the two could disagree: add a
- * step to the union, forget the clause, and the composer indexed a missing key
- * — pushing `undefined` into the parts list, which `join(", ")` renders as a
- * dangling separator on a prompt that then ships to a provider with the user's
- * chosen parameter silently dropped. Deriving the union FROM the catalog makes
- * that unrepresentable: one array is the source of the type, the option list
- * the API serves, and the clause table, so a new step reaches all three or
- * none. The exact id sets are pinned by `transition-timing-catalogs.test.ts`.
- */
-type TransitionPosition = (typeof TRANSITION_POSITIONS)[number]["id"];
-type TransitionDuration = (typeof TRANSITION_DURATIONS)[number]["id"];
-type TransitionIntensity = (typeof TRANSITION_INTENSITIES)[number]["id"];
-interface TransitionTiming {
-    position?: TransitionPosition;
-    duration?: TransitionDuration;
-    intensity?: TransitionIntensity;
-}
-declare const TRANSITIONS: ReadonlyArray<Transition>;
-declare const TRANSITION_CATEGORY_ORDER: ReadonlyArray<TransitionCategory>;
-declare const TRANSITION_CATEGORY_LABELS: Readonly<Record<TransitionCategory, string>>;
-declare function getTransition(id: string | undefined | null): Transition | undefined;
-declare function getTransitionLabel(id: string | undefined | null, fallback?: string): string;
-declare function getTransitionPromptHint(id: string | undefined | null): string;
-/**
- * Compact professional TERM for an id — the short phrase an editor would write
- * in a prompt ("hard cut", "invisible cut", "day-to-night time-lapse"), as
- * opposed to the paragraph-length `promptHint`.
- *
- * Same lookup and same empty-string-on-miss behavior as
- * `getTransitionPromptHint`, so the two can never disagree about which entry
- * they describe. The no-op "Auto" entry resolves to `""` in both.
- */
-declare function getTransitionTerm(id: string | undefined | null): string;
-declare const TRANSITION_IDS: ReadonlyArray<string>;
-/**
- * The transition node's three timing parameters, as catalogs.
- *
- * These are graded scales, not free numbers — the same shape as
- * `exposure-settings`' aperture or `temporal`'s speed — so a consumer that can
- * only send ids (Studio, the SDK, MCP) can offer them without composing prompt
- * text of its own. `auto` is the no-op head of each scale: an empty
- * `promptHint`, so an unset parameter contributes nothing and the model is left
- * to decide, exactly as before these were enumerable.
- *
- * `POSITION_CLAUSES` / `DURATION_CLAUSES` / `INTENSITY_CLAUSES` below are
- * DERIVED from these arrays, so the clause the composer injects and the hint
- * the catalog advertises are the same string by construction and cannot drift.
- */
-interface TransitionTimingOption {
-    readonly id: string;
-    readonly label: string;
-    readonly description: string;
-    readonly promptHint: string;
-    readonly term?: string;
-}
-declare const TRANSITION_POSITIONS: readonly [{
-    readonly id: "auto";
-    readonly label: "Auto";
-    readonly description: "Let the model place it";
-    readonly promptHint: "";
-    readonly term: "";
-}, {
-    readonly id: "start";
-    readonly label: "Start";
-    readonly description: "At the opening of the clip";
-    readonly promptHint: "the transition occurs at the opening of the clip";
-    readonly term: "at the opening of the clip";
-}, {
-    readonly id: "middle";
-    readonly label: "Middle";
-    readonly description: "In the middle of the clip";
-    readonly promptHint: "the transition occurs in the middle of the clip";
-    readonly term: "mid-clip";
-}, {
-    readonly id: "end";
-    readonly label: "End";
-    readonly description: "At the end of the clip";
-    readonly promptHint: "the transition occurs at the end of the clip";
-    readonly term: "at the end of the clip";
-}, {
-    readonly id: "full";
-    readonly label: "Full";
-    readonly description: "Spans the entire clip";
-    readonly promptHint: "the transition spans the entire clip";
-    readonly term: "across the whole clip";
-}];
-declare const TRANSITION_DURATIONS: readonly [{
-    readonly id: "auto";
-    readonly label: "Auto";
-    readonly description: "Let the model time it";
-    readonly promptHint: "";
-    readonly term: "";
-}, {
-    readonly id: "instant";
-    readonly label: "Instant";
-    readonly description: "No perceptible duration";
-    readonly promptHint: "occurring instantaneously";
-    readonly term: "instantaneous";
-}, {
-    readonly id: "short";
-    readonly label: "Short (~1s)";
-    readonly description: "Approximately 1 second";
-    readonly promptHint: "lasting approximately 1 second";
-    readonly term: "about 1 second";
-}, {
-    readonly id: "medium";
-    readonly label: "Medium (~2s)";
-    readonly description: "Approximately 2 seconds";
-    readonly promptHint: "lasting approximately 2 seconds";
-    readonly term: "about 2 seconds";
-}, {
-    readonly id: "long";
-    readonly label: "Long (~3s)";
-    readonly description: "Approximately 3 seconds";
-    readonly promptHint: "lasting approximately 3 seconds";
-    readonly term: "about 3 seconds";
-}];
-declare const TRANSITION_INTENSITIES: readonly [{
-    readonly id: "auto";
-    readonly label: "Auto";
-    readonly description: "Let the model judge it";
-    readonly promptHint: "";
-    readonly term: "";
-}, {
-    readonly id: "subtle";
-    readonly label: "Subtle";
-    readonly description: "Restrained, minimal flourish";
-    readonly promptHint: "with subtle restrained energy and minimal flourish";
-    readonly term: "subtly";
-}, {
-    readonly id: "natural";
-    readonly label: "Natural";
-    readonly description: "Unhurried, unforced timing";
-    readonly promptHint: "with natural unhurried timing";
-    readonly term: "at a natural pace";
-}, {
-    readonly id: "dynamic";
-    readonly label: "Dynamic";
-    readonly description: "Assertive, energetic";
-    readonly promptHint: "with dynamic energy and assertive flourish";
-    readonly term: "energetically";
-}, {
-    readonly id: "crazy";
-    readonly label: "Crazy";
-    readonly description: "Extreme, wild, distorted";
-    readonly promptHint: "with extreme exaggerated energy, wild flourishes, and dramatic distortion";
-    readonly term: "wildly exaggerated";
-}];
-/**
- * Compose a structural prompt-hint sentence from a transition id (or array
- * of 1-2 ids for multi-pick) plus optional start-state/end-state hints
- * (collected by walking the source node's startState / endState input
- * handle edges upstream) and optional timing fields.
- *
- * Behavior:
- * - 0 hints (no transition, empty array, or all-empty hints) → ""
- * - n base hints joined with ", and "
- * - Timing/start/end clauses apply ONCE at the outer layer, not per-id
- * - null input is treated like undefined (falsy short-circuit → returns "")
- *
- * @param mode `"compact"` builds the base from each transition's short
- *   professional `term` ("hard cut") instead of its full mechanism paragraph.
- *   Everything else — the ", and " multi-pick join, the position/duration/
- *   intensity clauses, and the "starting from"/"ending at" clauses — is
- *   emitted identically in both modes.
- */
-declare function composeTransitionHintFromConnections(transitionId: string | ReadonlyArray<string> | undefined, startHints: ReadonlyArray<string>, endHints: ReadonlyArray<string>, timing?: TransitionTiming, mode?: PickerHintMode): string;
-
 /**
  * Voice-character catalog: age + gender + language + accent + timbre. Feeds
  * Voice Design's voiceDescription field via the Sound aggregator.
@@ -8184,4 +8293,50 @@ interface CharacterMotionBindings {
  * unknown; this never certifies a sequence or predicts clip duration. */
 declare function getCharacterMotionDiagnostics(value: string | readonly string[] | null | undefined, timing?: CharacterMotionTiming, bindings?: CharacterMotionBindings): readonly CharacterMotionDiagnostic[];
 
-export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_IDS, ADULT_AGE_IDS, ADULT_ONLY_FLAG, ADULT_SWEPT_CATALOG_IDS, AESTHETICS, AESTHETIC_CATEGORY_LABELS, AESTHETIC_CATEGORY_ORDER, AESTHETIC_IDS, ALL_PICKER_WIRING, ANALYZABLE_PICKER_TYPES, ANGLE_LABELS, ASPECT_RATIO_LABELS, ATMOSPHERES, ATMOSPHERE_IDS, AUDIO_WIZARD_CATEGORIES, type ActionFx, type ActionFxCategory, type AdultOnlyEntry, type Aesthetic, type AestheticCategory, type AssembleImageInput, type AssembleSunoInput, type AssembleSunoResult, type Atmosphere, BACKDROPS, BACKDROP_CATEGORY_LABELS, BACKDROP_CATEGORY_ORDER, BACKDROP_IDS, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, type Backdrop, type BackdropCategory, type BrandCasing, type BrandFonts, type BrandLogo, type BrandPalette, type BrandPresetId, type BrandPresetMeta, type BrandTokens, type BrandTypeSpec, type BuildImagePromptConfig, type BuildImagePromptOverflowResult, type BuildImagePromptResult, type BuildImagePromptSegmentsResult, CAMERA_FORMATS, CAMERA_FORMAT_IDS, CAMERA_MOTIONS, CAMERA_MOTION_CATEGORY_LABELS, CAMERA_MOTION_CATEGORY_ORDER, CAMERA_MOTION_IDS, CHARACTER_FX, CHARACTER_FX_CATEGORY_LABELS, CHARACTER_FX_CATEGORY_ORDER, CHARACTER_FX_DURATIONS, CHARACTER_FX_IDS, CHARACTER_FX_INTENSITIES, CHARACTER_FX_POSITIONS, CHARACTER_MOTIONS, CHARACTER_MOTION_CATEGORY_LABELS, CHARACTER_MOTION_CATEGORY_ORDER, CHARACTER_MOTION_IDS, CHARACTER_MOTION_MAX_PICKS, CHARACTER_MOTION_PACES, CHARACTER_MOTION_POSITIONS, CINEMATIC_LOOK_TAIL, COLOR_LOOKS, COLOR_LOOK_CATEGORY_LABELS, COLOR_LOOK_CATEGORY_ORDER, COLOR_LOOK_IDS, COMPOSITION_EFFECTS, COMPOSITION_EFFECT_IDS, type CameraFormat, type CameraMotion, type CameraMotionCategory, type CatalogPack, type CatalogPackMode, type CategorizedInstrument, type CharacterFx, type CharacterFxCategory, type CharacterFxDuration, type CharacterFxIntensity, type CharacterFxPosition, type CharacterFxTiming, type CharacterFxTimingOption, type CharacterMeta, type CharacterMotion, type CharacterMotionBindings, type CharacterMotionCategory, type CharacterMotionDiagnostic, type CharacterMotionFloor, type CharacterMotionPace, type CharacterMotionPosition, type CharacterMotionPromptInput, type CharacterMotionTiming, type CharacterMotionTimingOption, type CharacterPromptInput, type ColorLook, type ColorLookCategory, type CompositionEffect, type ComputeNodePromptArgs, type CreaturePromptInput, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, type DirectionFamily, type DirectionFieldRow, type DirectionFieldSpec, type DirectionFields, type DirectionHintClause, type DirectionHintMode, type DirectionKey, type DirectionStyleGroup, type DirectionSurface, ERAS, ERA_CATEGORY_LABELS, ERA_CATEGORY_ORDER, ERA_IDS, EXPOSURE_CATEGORY_LABELS, EXPOSURE_CATEGORY_ORDER, EXPOSURE_FIELD_BY_CATEGORY, EXPOSURE_IDS, EXPOSURE_SETTINGS, type Era, type EraCategory, type ExposureCategory, type ExposureSettings, type ExposureValue, FACTORY_PRESETS, FACTORY_SNIPPETS, FILM_STILL_PREFIX, FILM_STYLE_KEYS, FLOORED_PICKER_KEYS, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, type FacePromptInput, type FactoryPreset, type FactoryPresetGroup, type FactorySnippet, type ForeignCatalogId, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type Framing, type FramingCategory, type FramingValue, GAPS_SCHEMA, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, HELD_PROPS, HELD_PROP_CATEGORY_LABELS, HELD_PROP_CATEGORY_ORDER, HELD_PROP_IDS, type HeldProp, type HeldPropCategory, IMAGE_HINT_MODE_DEFAULT, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, type IdentityLockMode, type ImageDirectionKey, type ImageReferenceDoctrine, type InstrumentCategory, type InstrumentationEntry, LENSES, LENS_IDS, LIGHTINGS, LIGHTING_CATEGORY_LABELS, LIGHTING_CATEGORY_ORDER, LIGHTING_FIELD_BY_CATEGORY, LIGHTING_IDS, LLM_CHAT_WIZARD_CATEGORIES, LOOP_SUBJECTS, LOOP_SUBJECT_CATEGORY_LABELS, LOOP_SUBJECT_CATEGORY_ORDER, type Lens, type Lighting, type LightingCategory, type LightingValue, type LlmChatFieldArgs, type LocationMotionPromptInput, type LocationPromptInput, type LocationRefinePromptInput, type LoopSubject, type LoopSubjectCategory, MATERIALS, MATERIAL_CATEGORY_LABELS, MATERIAL_CATEGORY_ORDER, MATERIAL_IDS, MAX_SELECTED_BY_DIMENSION, MAX_SELECTED_BY_FRAMING_CATEGORY, MAX_SELECTED_BY_STYLING_DIMENSION, MAX_SUBJECT_KEYS, MINOR_IMPLYING_TYPE_IDS, MOODS, MOOD_CATEGORY_LABELS, MOOD_CATEGORY_ORDER, MOOD_IDS, MOVEMENT_LABELS, MULTI_PICKER_WIRING, MUSIC_EMOTIONS, MUSIC_ENERGIES, MUSIC_ERAS, MUSIC_GENRES, MUSIC_GENRE_CATEGORY_LABELS, MUSIC_GENRE_CATEGORY_ORDER, MUSIC_GENRE_DEFAULT_DATA, MUSIC_MOOD_DEFAULT_DATA, MUSIC_VIBES, MUSIC_WIZARD_CATEGORIES, type Material, type MaterialCategory, type ModelChange, type Mood, type MoodCategory, type MoodValue, type MultiDimPickerWiring, type MultiPickerAnalyzerSpec, type MusicEra, type MusicGenre, type MusicGenreCategory, type MusicMoodData, type MusicMoodEntry, type MusicSubgenre, NODE_PROMPT_CANDIDATE_FIELDS, NODE_PROMPT_FIELDS, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, type ObjectMotionPromptInput, type ObjectPresetAssetType, type ObjectPromptInput, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_SECTIONS, PERSON_FIELD_BY_DIMENSION, PERSON_IDS, PHOTOGRAPHERS, PHOTOGRAPHER_CATEGORY_LABELS, PHOTOGRAPHER_CATEGORY_ORDER, PHOTOGRAPHER_IDS, PHOTO_GENRES, PHOTO_GENRE_CATEGORY_LABELS, PHOTO_GENRE_CATEGORY_ORDER, PHOTO_GENRE_IDS, PICKER_ANALYZER_FAMILIES, PICKER_ANALYZER_REGISTRY, PICKER_CATALOGS, PICKER_TYPES, POSES, POSE_CATEGORY_LABELS, POSE_CATEGORY_ORDER, POSE_IDS, POST_PROCESS_EFFECTS, POST_PROCESS_EFFECT_IDS, PRODUCTION_STYLES, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, PROMPT_HINT_SEPARATOR, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, type Person, type PersonDimension, type PersonDimensionSection, type PersonPack, type PersonValue, type PhotoGenre, type PhotoGenreCategory, type Photographer, type PhotographerCategory, type PickerAnalyzer, type PickerAnalyzerDescriptor, type PickerAnalyzerSpec, type PickerApplyMode, type PickerCatalog, type PickerCatalogDetail, type PickerCatalogInput, type PickerCatalogSummary, type PickerDimension, type PickerDimensionInput, type PickerDimensionSpec, type PickerGaps, type PickerHintMode, type PickerOption, type PickerOptionInput, type PickerType, type PickerWiring, type PickerWiringEntry, type Pose, type PoseCategory, type PoseValue, type PostProcessEffect, type ProjectPickerCatalogOptions, type ProjectedPickerCatalog, type ProjectedPickerDimension, type ProjectedPickerOption, type PromptClauseSlot, type PromptFieldSpec, type PromptIconKind, type PromptSegment, type PromptSegmentOrigin, type ProviderPromptDoctrine, REFERENCE_IMAGE_ROLES, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, RETIRED_ADULT_ONLY_HINT_STRINGS, type RecommendedModel, type RefIdTokenContext, type ReferenceCounts, type ReferenceLineFormat, type RegisteredPersonEntry, type RenderQuality, type ResolveCharacterMentionsResult, type ResolveLocationMentionsResult, type ResolvePromptArgs, type ResolveVideoReferenceCoreArgs, SCENE3D_FIGURE_REFERENCE_RULE, SCENE3D_FREE_PLATE_SLOTS, SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE, SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE, SCENE3D_LAYOUT_SCOPING_FOR, SCENE3D_LAYOUT_SCOPING_IGNORE, SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE, SCENE3D_LAYOUT_SCOPING_MARKER, SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE, SCENE_FRAME_RULE, SCENE_PROMPT_MAX_LENGTH, SETTINGS, SETTING_CATEGORY_LABELS, SETTING_IDS, SHOT_LABELS, SINGING_STYLES, SINGLE_PICKER_WIRING, SNIPPET_MEDIA_VALUES, STYLES, STYLE_IDS, STYLE_PRESETS, STYLE_SECTION_GAP, STYLE_SECTION_HEADER, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, SUBJECT_ARRAY_CEILING, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_FIELDS, SUBJECT_FOLD_KEYS, SUBJECT_ID_MAX_CHARS, SUBJECT_IMAGE_HINT_MODE_DEFAULT, SUBJECT_KEYS, SUBJECT_KEY_MAX_CHARS, SUBJECT_VIDEO_HINT_MODE_DEFAULT, type Scene3DFigureReferenceCheck, type Scene3DLayoutReferenceCarrier, type Scene3DLayoutReferenceSeat, type Scene3DLayoutScopingSpec, type Scene3DUnreferencedFiguresWarning, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type Setting, type SettingCategory, type SidecarCoverageReport, type SingleDimPickerWiring, type SlottedPromptClause, type SnippetMedia, type SnippetTarget, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, type StructuredPromptFields, type Style, type StylePreset, type Styling, type StylingDimension, type StylingValue, type SubjectFieldRow, type SubjectFieldSpec, type SubjectFields, type SubjectGroupFieldSpec, type SubjectHintMode, type SubjectIdsFieldSpec, type SubjectSurface, type SuspiciousTermOptions, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TERM_MAX_CHARS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_DURATIONS, TRANSITION_IDS, TRANSITION_INTENSITIES, TRANSITION_POSITIONS, type Temporal, type TemporalCategory, type TemporalValue, type TermCarrier, type Transition, type TransitionCategory, type TransitionDuration, type TransitionIntensity, type TransitionPosition, type TransitionTiming, type TransitionTimingOption, VIDEO_HINT_MODE_DEFAULT, VIDEO_WIZARD_CATEGORIES, VOCAL_PRESENCE, VOCAL_PRESENCE_INSTRUMENTAL_ID, VOICE_ACCENTS, VOICE_AGES, VOICE_ARCHETYPES, VOICE_CHARACTER_DEFAULT_DATA, VOICE_DELIVERY_DEFAULT_DATA, VOICE_EMOTIONS, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_PACES, VOICE_TIMBRES, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoDirectionKey, type VideoExtraRef, type VideoPromptCapOptions, type VoiceCharacterEntry, type VoiceDeliveryEntry, WARDROBE, WARDROBE_CATEGORY_LABELS, WARDROBE_DIMENSION_ORDER, WARDROBE_FIELD_BY_DIMENSION, type WardrobeDimension, type WardrobeEntry, type WardrobeValue, type WizardCategory, type WizardNodeContext, type WizardOption, type WizardQuestion, type WizardSelection, __resetCatalogIdGuardForTests, appendField, appendMusicMeta, appendReferenceLines, appendScene3DStillScopingLines, applyMinorAgeFloorToPickerValues, applyPickerJson, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, asBodyClauses, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildImagePromptWithOverflow, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildNeedleAlternationSource, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScene3DLayoutScopingLine, buildScene3DUnreferencedFiguresWarning, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogGuardActive, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeCharacterMotionHintFromConnections, composeNegative, composePickerCatalogs, composeSectionedPrompt, composeSoundHintFromConnections, composeTransitionHintFromConnections, composeVideoPromptText, composedHas, composedOption, composedOptionIndex, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, containsMinorAgeHint, curateEntries, curatedAnimalPromptHint, curatedAnimalTerm, curatedFurnitureText, curatedVehicleText, curatedWeaponText, deriveTerm, directionFieldsForSurface, endsInsideStyleSection, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, findForeignCatalogIds, findForeignCatalogIdsInBody, foreignCatalogIdMessage, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, getAdultOnlyEntries, getAdultOnlyHintStrings, getAdultOnlyIds, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAestheticTerm, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getAtmosphereTerm, getBackdrop, getBackdropLabel, getBackdropPromptHint, getBackdropTerm, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraFormatTerm, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCameraMotionTerm, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getCharacterFxTerm, getCharacterMotion, getCharacterMotionBindings, getCharacterMotionDiagnostics, getCharacterMotionLabel, getCharacterMotionPromptHint, getCharacterMotionTerm, getColorLook, getColorLookLabel, getColorLookPromptHint, getColorLookTerm, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getCompositionEffectTerm, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getEraTerm, getExposure, getExposureLabel, getExposurePromptHint, getExposureTerm, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getFramingTerm, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getHeldPropTerm, getIdentityLockClause, getInstrument, getInstrumentTerm, getLens, getLensLabel, getLensPromptHint, getLensTerm, getLighting, getLightingLabel, getLightingPromptHint, getLightingTerm, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getLoopSubjectTerm, getMaterial, getMaterialLabel, getMaterialPromptHint, getMaterialTerm, getMinorAgeHintStrings, getMood, getMoodLabel, getMoodPromptHint, getMoodTerm, getMusicEmotion, getMusicEmotionTerm, getMusicEnergy, getMusicEnergyTerm, getMusicEra, getMusicEraTerm, getMusicGenre, getMusicGenreLabel, getMusicGenreTerm, getMusicSubgenre, getMusicSubgenreTerm, getMusicVibe, getMusicVibeTerm, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPersonTerm, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotoGenreTerm, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPhotographerTerm, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPoseTerm, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getPostProcessEffectTerm, getProductionStyle, getProductionStyleTerm, getPromptDoctrine, getPromptFields, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRegisteredSubjectKeys, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, getSnippetMedia, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyleTerm, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getStylingTerm, getTemporal, getTemporalLabel, getTemporalPromptHint, getTemporalTerm, getTransition, getTransitionLabel, getTransitionPromptHint, getTransitionTerm, getVocalPresence, getVocalPresenceTerm, getVoiceAccent, getVoiceAccentTerm, getVoiceAge, getVoiceAgeTerm, getVoiceArchetype, getVoiceArchetypeTerm, getVoiceEmotion, getVoiceEmotionTerm, getVoiceGender, getVoiceGenderTerm, getVoiceLanguage, getVoiceLanguageTerm, getVoicePace, getVoicePaceTerm, getVoiceTimbre, getVoiceTimbreTerm, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasCatalogPacksFor, hasScene3DLayoutScopingLine, hasUpstreamCharacter, identityRefsSentence, insertBeforeStyleSection, isAnalyzablePicker, isDeniedStyleId, isInstrumentalVocal, isMinorAge, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinHintFragments, joinPromptHints, joinPromptParts, keepableDirectionHints, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, normalizeSubjectFields, overlayEntry, partitionStyleClauses, personPacksVersion, pickerFanoutTargets, planFrameDelivery, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, readSubjectFields, referenceDescriptionLine, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDescribedReferenceLines, renderDirectionHintClauses, renderDirectionHints, renderReferenceCaptionLines, renderScene3DLayoutScopingLine, renderStructuredFields, renderStyleSection, renderSubjectHints, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, scene3DLayoutVideoCaptions, sectionedClauseCosts, setComposedCatalogResolver, splitStyleSection, styleSectionFromClauses, styleSlotFor, subjectFieldsForSurface, subscribeCatalogPacks, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
+/**
+ * Per-ad creative analysis — the "expert competitor ad analyst" pass the
+ * social scraper nodes (Meta Ads first; TikTok / Instagram / LinkedIn next)
+ * can run on every ad they return. Node-agnostic on purpose: the input is
+ * "one creative + its copy + a little context", never a Meta-shaped ad.
+ *
+ * The model answers in a fixed JSON shape (the schema lives with the backend
+ * call site); this file owns the WORDS — what each field means and how to
+ * judge it — so the prompt can be tuned without touching the wire contract.
+ */
+/** The fields the analysis returns, in the order a reader wants them. */
+declare const AD_CREATIVE_ANALYSIS_FIELDS: readonly ["assetType", "format", "visualHooks", "audiences", "graphicIdentity", "copywritingHooks", "usps", "cta", "summary"];
+type AdCreativeAnalysisField = (typeof AD_CREATIVE_ANALYSIS_FIELDS)[number];
+declare const 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.\n\nJudge 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.\n\nFill every field:\n- assetType: \"static\" (a still image), \"motion\" (a video \u2014 you see its poster frame), \"carousel\" (several creatives in one ad), or \"unknown\".\n- 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.\n- 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.\n- audiences: who the ad represents or addresses (age band, gender, life situation, profession, interest, geography, pain point). 1\u20135 short items.\n- graphicIdentity: the graphic components \u2014 color palette, typography style, logo placement, layout system, illustration vs photo, brand consistency cues. One or two sentences.\n- 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.\n- usps: the unique selling points the ad claims (price, speed, exclusivity, guarantee, results, features). 1\u20135 short items.\n- cta: the call to action \u2014 the button label and/or the closing line that tells the viewer what to do.\n- summary: two to four sentences: what the ad sells, to whom, with what hook, and why it likely works (or does not).";
+/**
+ * The organic-content twin of the ad prompt — for scraped social POSTS
+ * (Instagram / TikTok / LinkedIn), not paid ads. SAME output fields (so one
+ * schema and one UI serve both), read for organic content: hooks, audience,
+ * the value/benefit the post conveys (`usps`), and its ask (`cta` — "link in
+ * bio", "follow", a comment prompt, or none).
+ */
+declare const 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.\n\nJudge 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.\n\nFill every field:\n- assetType: \"static\" (a still image), \"motion\" (a video / reel \u2014 you see its cover frame), \"carousel\" (a multi-image post), or \"unknown\".\n- 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.\n- 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.\n- audiences: who the post represents or speaks to (age band, gender, life situation, profession, interest, geography, community). 1\u20135 short items.\n- graphicIdentity: the graphic components \u2014 color palette, typography style, logo / handle placement, layout, illustration vs photo, brand consistency cues. One or two sentences.\n- 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.\n- usps: the value or benefit the post conveys to the viewer (entertainment, education, inspiration, a product benefit, a deal). 1\u20135 short items.\n- 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.\n- 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).";
+interface AdCreativeAnalysisInput {
+    /** Who is advertising (the Page / account name). */
+    readonly advertiser?: string;
+    readonly headline?: string;
+    readonly body?: string;
+    readonly ctaLabel?: string;
+    /** Where the ad points (the landing domain is enough). */
+    readonly landing?: string;
+    /** Placements the ad ran on (Facebook, Instagram, TikTok…). */
+    readonly platforms?: readonly string[];
+    /** Creative shape already classified by the caller ("vertical", "square", "horizontal"). */
+    readonly creativeFormat?: string;
+    /** "1 video, 2 images" — what the ad carries beyond the one frame the model sees. */
+    readonly mediaSummary?: string;
+    /** The user's optional focus ("we sell running shoes — compare against our positioning"). */
+    readonly focus?: string;
+}
+/**
+ * The user turn's text. The creative itself travels as a separate image
+ * block; this is everything else the analyst should know, one labelled
+ * line per fact, blanks left out.
+ */
+declare function buildAdCreativeAnalysisUserText(input: AdCreativeAnalysisInput): string;
+
+export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_IDS, ADULT_AGE_IDS, ADULT_ONLY_FLAG, ADULT_SWEPT_CATALOG_IDS, AD_CREATIVE_ANALYSIS_FIELDS, AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT, AESTHETICS, AESTHETIC_CATEGORY_LABELS, AESTHETIC_CATEGORY_ORDER, AESTHETIC_IDS, ALL_PICKER_WIRING, ANALYZABLE_PICKER_TYPES, ANGLE_LABELS, ASPECT_RATIO_LABELS, ATMOSPHERES, ATMOSPHERE_IDS, AUDIO_WIZARD_CATEGORIES, type ActionFx, type ActionFxCategory, type AdCreativeAnalysisField, type AdCreativeAnalysisInput, type AdultOnlyEntry, type Aesthetic, type AestheticCategory, type AssembleImageInput, type AssembleSunoInput, type AssembleSunoResult, type Atmosphere, BACKDROPS, BACKDROP_CATEGORY_LABELS, BACKDROP_CATEGORY_ORDER, BACKDROP_IDS, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, type Backdrop, type BackdropCategory, type BrandCasing, type BrandFonts, type BrandLogo, type BrandPalette, type BrandPresetId, type BrandPresetMeta, type BrandTokens, type BrandTypeSpec, type BuildImagePromptConfig, type BuildImagePromptOverflowResult, type BuildImagePromptResult, type BuildImagePromptSegmentsResult, CAMERA_FORMATS, CAMERA_FORMAT_IDS, CAMERA_MOTIONS, CAMERA_MOTION_CATEGORY_LABELS, CAMERA_MOTION_CATEGORY_ORDER, CAMERA_MOTION_IDS, CHARACTER_FX, CHARACTER_FX_CATEGORY_LABELS, CHARACTER_FX_CATEGORY_ORDER, CHARACTER_FX_DURATIONS, CHARACTER_FX_IDS, CHARACTER_FX_INTENSITIES, CHARACTER_FX_POSITIONS, CHARACTER_MOTIONS, CHARACTER_MOTION_CATEGORY_LABELS, CHARACTER_MOTION_CATEGORY_ORDER, CHARACTER_MOTION_IDS, CHARACTER_MOTION_MAX_PICKS, CHARACTER_MOTION_PACES, CHARACTER_MOTION_POSITIONS, CINEMATIC_LOOK_TAIL, COLOR_LOOKS, COLOR_LOOK_CATEGORY_LABELS, COLOR_LOOK_CATEGORY_ORDER, COLOR_LOOK_IDS, COMPOSITION_EFFECTS, COMPOSITION_EFFECT_IDS, type CameraFormat, type CameraMotion, type CameraMotionCategory, type CatalogPack, type CatalogPackMode, type CategorizedInstrument, type CharacterFx, type CharacterFxCategory, type CharacterFxDuration, type CharacterFxIntensity, type CharacterFxPosition, type CharacterFxTiming, type CharacterFxTimingOption, type CharacterMeta, type CharacterMotion, type CharacterMotionBindings, type CharacterMotionCategory, type CharacterMotionDiagnostic, type CharacterMotionFloor, type CharacterMotionPace, type CharacterMotionPosition, type CharacterMotionPromptInput, type CharacterMotionTiming, type CharacterMotionTimingOption, type CharacterPromptInput, type ColorLook, type ColorLookCategory, type CompositionEffect, type ComputeNodePromptArgs, type CreaturePromptInput, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, type DirectionFamily, type DirectionFieldRow, type DirectionFieldSpec, type DirectionFields, type DirectionHintClause, type DirectionHintMode, type DirectionKey, type DirectionStyleGroup, type DirectionSurface, ERAS, ERA_CATEGORY_LABELS, ERA_CATEGORY_ORDER, ERA_IDS, EXPOSURE_CATEGORY_LABELS, EXPOSURE_CATEGORY_ORDER, EXPOSURE_FIELD_BY_CATEGORY, EXPOSURE_IDS, EXPOSURE_SETTINGS, type Era, type EraCategory, type ExposureCategory, type ExposureSettings, type ExposureValue, FACTORY_PRESETS, FACTORY_SNIPPETS, FILM_STILL_PREFIX, FILM_STYLE_KEYS, FLOORED_PICKER_KEYS, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, type FacePromptInput, type FactoryPreset, type FactoryPresetGroup, type FactorySnippet, type ForeignCatalogId, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type Framing, type FramingCategory, type FramingValue, GAPS_SCHEMA, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, HELD_PROPS, HELD_PROP_CATEGORY_LABELS, HELD_PROP_CATEGORY_ORDER, HELD_PROP_IDS, type HeldProp, type HeldPropCategory, IMAGE_HINT_MODE_DEFAULT, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, INSTANT_CUT_CLAUSE, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, type IdentityLockMode, type ImageDirectionKey, type ImageReferenceDoctrine, type InstrumentCategory, type InstrumentationEntry, LENSES, LENS_IDS, LIGHTINGS, LIGHTING_CATEGORY_LABELS, LIGHTING_CATEGORY_ORDER, LIGHTING_FIELD_BY_CATEGORY, LIGHTING_IDS, LLM_CHAT_WIZARD_CATEGORIES, LOOP_SUBJECTS, LOOP_SUBJECT_CATEGORY_LABELS, LOOP_SUBJECT_CATEGORY_ORDER, type Lens, type Lighting, type LightingCategory, type LightingValue, type LlmChatFieldArgs, type LocationMotionPromptInput, type LocationPromptInput, type LocationRefinePromptInput, type LoopSubject, type LoopSubjectCategory, MATERIALS, MATERIAL_CATEGORY_LABELS, MATERIAL_CATEGORY_ORDER, MATERIAL_IDS, MAX_SELECTED_BY_DIMENSION, MAX_SELECTED_BY_FRAMING_CATEGORY, MAX_SELECTED_BY_STYLING_DIMENSION, MAX_SUBJECT_KEYS, MINOR_IMPLYING_TYPE_IDS, MOODS, MOOD_CATEGORY_LABELS, MOOD_CATEGORY_ORDER, MOOD_IDS, MOVEMENT_LABELS, MULTI_PICKER_WIRING, MUSIC_EMOTIONS, MUSIC_ENERGIES, MUSIC_ERAS, MUSIC_GENRES, MUSIC_GENRE_CATEGORY_LABELS, MUSIC_GENRE_CATEGORY_ORDER, MUSIC_GENRE_DEFAULT_DATA, MUSIC_MOOD_DEFAULT_DATA, MUSIC_VIBES, MUSIC_WIZARD_CATEGORIES, type Material, type MaterialCategory, type ModelChange, type Mood, type MoodCategory, type MoodValue, type MultiDimPickerWiring, type MultiPickerAnalyzerSpec, type MusicEra, type MusicGenre, type MusicGenreCategory, type MusicMoodData, type MusicMoodEntry, type MusicSubgenre, NODE_PROMPT_CANDIDATE_FIELDS, NODE_PROMPT_FIELDS, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, type ObjectMotionPromptInput, type ObjectPresetAssetType, type ObjectPromptInput, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_SECTIONS, PERSON_FIELD_BY_DIMENSION, PERSON_IDS, PHOTOGRAPHERS, PHOTOGRAPHER_CATEGORY_LABELS, PHOTOGRAPHER_CATEGORY_ORDER, PHOTOGRAPHER_IDS, PHOTO_GENRES, PHOTO_GENRE_CATEGORY_LABELS, PHOTO_GENRE_CATEGORY_ORDER, PHOTO_GENRE_IDS, PICKER_ANALYZER_FAMILIES, PICKER_ANALYZER_REGISTRY, PICKER_CATALOGS, PICKER_TYPES, POSES, POSE_CATEGORY_LABELS, POSE_CATEGORY_ORDER, POSE_IDS, POST_CONTENT_ANALYSIS_SYSTEM_PROMPT, POST_PROCESS_EFFECTS, POST_PROCESS_EFFECT_IDS, PRODUCTION_STYLES, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, PROMPT_HINT_SEPARATOR, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, type Person, type PersonDimension, type PersonDimensionSection, type PersonPack, type PersonValue, type PhotoGenre, type PhotoGenreCategory, type Photographer, type PhotographerCategory, type PickerAnalyzer, type PickerAnalyzerDescriptor, type PickerAnalyzerSpec, type PickerApplyMode, type PickerCatalog, type PickerCatalogDetail, type PickerCatalogInput, type PickerCatalogSummary, type PickerDimension, type PickerDimensionInput, type PickerDimensionSpec, type PickerGaps, type PickerHintMode, type PickerOption, type PickerOptionInput, type PickerType, type PickerWiring, type PickerWiringEntry, type Pose, type PoseCategory, type PoseValue, type PostProcessEffect, type ProjectPickerCatalogOptions, type ProjectedPickerCatalog, type ProjectedPickerDimension, type ProjectedPickerOption, type PromptClauseSlot, type PromptFieldSpec, type PromptIconKind, type PromptSegment, type PromptSegmentOrigin, type ProviderPromptDoctrine, REFERENCE_IMAGE_ROLES, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, RETIRED_ADULT_ONLY_HINT_STRINGS, type RecommendedModel, type RefIdTokenContext, type ReferenceCounts, type ReferenceLineFormat, type RegisteredPersonEntry, type RenderQuality, type ResolveCharacterMentionsResult, type ResolveLocationMentionsResult, type ResolvePromptArgs, type ResolveVideoReferenceCoreArgs, SCENE3D_FIGURE_REFERENCE_RULE, SCENE3D_FREE_PLATE_SLOTS, SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE, SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE, SCENE3D_LAYOUT_SCOPING_FOR, SCENE3D_LAYOUT_SCOPING_IGNORE, SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE, SCENE3D_LAYOUT_SCOPING_MARKER, SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE, SCENE_FRAME_RULE, SCENE_PROMPT_MAX_LENGTH, SEEDANCE_VIDEO_EDIT_PREFIX, SETTINGS, SETTING_CATEGORY_LABELS, SETTING_IDS, SHOT_LABELS, SINGING_STYLES, SINGLE_PICKER_WIRING, SNIPPET_MEDIA_VALUES, STYLES, STYLE_IDS, STYLE_PRESETS, STYLE_SECTION_GAP, STYLE_SECTION_HEADER, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, SUBJECT_ARRAY_CEILING, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_FIELDS, SUBJECT_FOLD_KEYS, SUBJECT_ID_MAX_CHARS, SUBJECT_IMAGE_HINT_MODE_DEFAULT, SUBJECT_KEYS, SUBJECT_KEY_MAX_CHARS, SUBJECT_VIDEO_HINT_MODE_DEFAULT, type Scene3DFigureReferenceCheck, type Scene3DLayoutReferenceCarrier, type Scene3DLayoutReferenceSeat, type Scene3DLayoutScopingSpec, type Scene3DUnreferencedFiguresWarning, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type Setting, type SettingCategory, type SidecarCoverageReport, type SingleDimPickerWiring, type SlottedPromptClause, type SnippetMedia, type SnippetTarget, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, type StructuredPromptFields, type Style, type StylePreset, type Styling, type StylingDimension, type StylingValue, type SubjectFieldRow, type SubjectFieldSpec, type SubjectFields, type SubjectGroupFieldSpec, type SubjectHintMode, type SubjectIdsFieldSpec, type SubjectSurface, type SuspiciousTermOptions, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TERM_MAX_CHARS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_DURATIONS, TRANSITION_IDS, TRANSITION_INTENSITIES, TRANSITION_POSITIONS, type Temporal, type TemporalCategory, type TemporalValue, type TermCarrier, type Transition, type TransitionCategory, type TransitionDuration, type TransitionHintOptions, type TransitionHintScope, type TransitionIntensity, type TransitionPosition, type TransitionTiming, type TransitionTimingOption, VIDEO_HINT_MODE_DEFAULT, VIDEO_WIZARD_CATEGORIES, VOCAL_PRESENCE, VOCAL_PRESENCE_INSTRUMENTAL_ID, VOICE_ACCENTS, VOICE_AGES, VOICE_ARCHETYPES, VOICE_CHARACTER_DEFAULT_DATA, VOICE_DELIVERY_DEFAULT_DATA, VOICE_EMOTIONS, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_PACES, VOICE_TIMBRES, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoDirectionKey, type VideoExtraRef, type VideoPromptCapOptions, type VoiceCharacterEntry, type VoiceDeliveryEntry, WARDROBE, WARDROBE_CATEGORY_LABELS, WARDROBE_DIMENSION_ORDER, WARDROBE_FIELD_BY_DIMENSION, type WardrobeDimension, type WardrobeEntry, type WardrobeValue, type WizardCategory, type WizardNodeContext, type WizardOption, type WizardQuestion, type WizardSelection, __resetCatalogIdGuardForTests, appendField, appendMusicMeta, appendReferenceLines, appendScene3DStillScopingLines, applyMinorAgeFloorToPickerValues, applyPickerJson, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, asBodyClauses, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAdCreativeAnalysisUserText, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildImagePromptWithOverflow, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildNeedleAlternationSource, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScene3DLayoutScopingLine, buildScene3DUnreferencedFiguresWarning, buildScenePrompt, buildSeedanceVideoEditPrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogGuardActive, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeCharacterMotionHintFromConnections, composeNegative, composePickerCatalogs, composeSectionedPrompt, composeSoundHintFromConnections, composeTransitionHintFromConnections, composeVideoPromptText, composedHas, composedOption, composedOptionIndex, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, containsMinorAgeHint, curateEntries, curatedAnimalPromptHint, curatedAnimalTerm, curatedFurnitureText, curatedVehicleText, curatedWeaponText, deriveTerm, directionFieldsForSurface, endsInsideStyleSection, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, findForeignCatalogIds, findForeignCatalogIdsInBody, foreignCatalogIdMessage, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, getAdultOnlyEntries, getAdultOnlyHintStrings, getAdultOnlyIds, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAestheticTerm, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getAtmosphereTerm, getBackdrop, getBackdropLabel, getBackdropPromptHint, getBackdropTerm, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraFormatTerm, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCameraMotionTerm, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getCharacterFxTerm, getCharacterMotion, getCharacterMotionBindings, getCharacterMotionDiagnostics, getCharacterMotionLabel, getCharacterMotionPromptHint, getCharacterMotionTerm, getColorLook, getColorLookLabel, getColorLookPromptHint, getColorLookTerm, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getCompositionEffectTerm, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getEraTerm, getExposure, getExposureLabel, getExposurePromptHint, getExposureTerm, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getFramingTerm, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getHeldPropTerm, getIdentityLockClause, getInstrument, getInstrumentTerm, getLens, getLensLabel, getLensPromptHint, getLensTerm, getLighting, getLightingLabel, getLightingPromptHint, getLightingTerm, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getLoopSubjectTerm, getMaterial, getMaterialLabel, getMaterialPromptHint, getMaterialTerm, getMinorAgeHintStrings, getMood, getMoodLabel, getMoodPromptHint, getMoodTerm, getMusicEmotion, getMusicEmotionTerm, getMusicEnergy, getMusicEnergyTerm, getMusicEra, getMusicEraTerm, getMusicGenre, getMusicGenreLabel, getMusicGenreTerm, getMusicSubgenre, getMusicSubgenreTerm, getMusicVibe, getMusicVibeTerm, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPersonTerm, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotoGenreTerm, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPhotographerTerm, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPoseTerm, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getPostProcessEffectTerm, getProductionStyle, getProductionStyleTerm, getPromptDoctrine, getPromptFields, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRegisteredSubjectKeys, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, getSnippetMedia, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyleTerm, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getStylingTerm, getTemporal, getTemporalLabel, getTemporalPromptHint, getTemporalTerm, getTransition, getTransitionLabel, getTransitionPromptHint, getTransitionTerm, getVocalPresence, getVocalPresenceTerm, getVoiceAccent, getVoiceAccentTerm, getVoiceAge, getVoiceAgeTerm, getVoiceArchetype, getVoiceArchetypeTerm, getVoiceEmotion, getVoiceEmotionTerm, getVoiceGender, getVoiceGenderTerm, getVoiceLanguage, getVoiceLanguageTerm, getVoicePace, getVoicePaceTerm, getVoiceTimbre, getVoiceTimbreTerm, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasCatalogPacksFor, hasScene3DLayoutScopingLine, hasUpstreamCharacter, identityRefsSentence, insertBeforeStyleSection, isAnalyzablePicker, isDeniedStyleId, isInstantTransition, isInstrumentalVocal, isMinorAge, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinHintFragments, joinPromptHints, joinPromptParts, keepableDirectionHints, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, normalizeSubjectFields, overlayEntry, partitionStyleClauses, personPacksVersion, pickerFanoutTargets, planFrameDelivery, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, readSubjectFields, referenceDescriptionLine, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDescribedReferenceLines, renderDirectionHintClauses, renderDirectionHints, renderReferenceCaptionLines, renderScene3DLayoutScopingLine, renderStructuredFields, renderStyleSection, renderSubjectHints, renderTransitionBases, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, scene3DLayoutVideoCaptions, sectionedClauseCosts, setComposedCatalogResolver, splitStyleSection, styleSectionFromClauses, styleSlotFor, subjectFieldsForSurface, subscribeCatalogPacks, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };