@nodaro/prompts 1.8.1 → 1.10.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ConnectedReference, GenericNode, GenericEdge, HintNodeLike, HintGraphContext, EntityStyle, SupportedFontName, CharacterDef, IdentityMeta, SceneData, CharacterMentionTokenInfo, LocationMentionTokenInfo, UsageMode, ProjectedCatalog, ProjectedCatalogDimension, ProjectedCatalogOption, LocaleId, LocaleCatalogMap, StyleDirectives, I18nCatalogId, SurroundDirection } from '@nodaro/shared';
+import { ConnectedReference, GenericNode, GenericEdge, HintNodeLike, HintGraphContext, EntityStyle, SupportedFontName, CharacterDef, IdentityMeta, SceneData, CharacterMentionTokenInfo, LocationMentionTokenInfo, UsageMode, ProjectedCatalog, ProjectedCatalogDimension, ProjectedCatalogOption, LocaleId, LocaleCatalogMap, PromptAffixes, StyleDirectives, I18nCatalogId, SurroundDirection } from '@nodaro/shared';
 export { HintEdgeLike, HintGraphContext, HintNodeLike } from '@nodaro/shared';
 import { z } from 'zod';
 
@@ -1000,34 +1000,12 @@ interface StructuredPromptFields {
 declare function renderStructuredFields(fields: StructuredPromptFields): string;
 
 /**
- * Shared video-reference resolver CORE — the ONE pure implementation of the
- * video-prompt `@-mention` + canonical-fallback + extras assembly that BOTH the
- * frontend (`frontend/src/lib/video-prompt-assembly.ts`) and backend
- * (`backend/src/services/workflow-engine/payload-builder.ts`) resolvers delegate
- * to.
- *
- * Historically the FE and BE each hand-rolled a byte-for-byte copy of this logic
- * (they had to stay in lock-step or single-node FE runs and orchestrator runs
- * would diverge). This module is the lift-and-shift of the FRONTEND resolver's
- * post-expansion body into one place so there is a single source of truth.
- *
- * Purity contract: NO FE/BE-only dependencies. The caller is responsible for the
- * layer-specific work BEFORE calling in:
- *   - expanding wired Character upstreams into `ConnectedReference[]`
- *     (`wiredCharRefs`), and
- *   - looking up an extra-ref's character metadata by slug
- *     (`lookupCharacterBySlug` — FE: `nodes.find(...)`, BE: `buildCtx`).
- *
- * Behavior-preserving when first extracted (the FE resolver's post-expansion
- * body was lifted verbatim). The ONE intended output change since is the
- * reference-binding surface string: the per-image subject phrasing, the bullet
- * ordinals, and the frame directive now emit `@image_N` / `@video_N` /
- * `@audio_N` (the legacy form was `Image N`) — all routed through the single
- * `REF_BINDING` swap-point below. The structural strings ("Use these
- * characters:", the bullet layout, "… is the same subject as …") are otherwise
- * unchanged.
+ * The reference-binding surface string — `@image_N` / `@video_N` / `@audio_N`
+ * — and the one identity sentence built on it. Split out of
+ * `video-reference-resolver.ts` so the id-addressed token resolver
+ * (`ref-id-tokens.ts`) can bind through the same arrows without a module
+ * cycle; the resolver re-exports both, so importers are unaffected.
  */
-
 /**
  * The SINGLE swap-point for the reference-binding surface-string (design D1/D7).
  *
@@ -1059,6 +1037,89 @@ declare const REF_BINDING: {
     readonly ordinal: (n: number) => string;
     readonly frame: (n: number, role: "opening" | "closing") => string;
 };
+
+/**
+ * `{ref:<id>}` / `{ref:<id>:<label>}` — id-addressed reference tokens.
+ *
+ * The API/Studio form of the positional `{image:N}` token: the client names a
+ * reference by its OWN `connectedReferences[].id` and the platform substitutes
+ * the `@image_N` seat after IT has done the numbering. Without it a client that
+ * wanted the binding inline had to mirror the numbering walk client-side — a
+ * duplicated rule that misbinds pictures the moment the walk changes.
+ *
+ * `resolveVideoReferenceCore` builds the `RefIdTokenContext` DURING its walk
+ * and calls `resolveRefIdTokens` before the `referenceOrder` reorder (so the
+ * binding follows the reference to its final seat); the video routes call it
+ * standalone on their no-image-reference early return (nothing seated, so
+ * every token degrades).
+ */
+/** What `resolveRefIdTokens` resolves against — the numbering walk's output. */
+interface RefIdTokenContext {
+    /** Reference id → the 1-based `@image_N` seat the walk gave it. */
+    readonly slotById: ReadonlyMap<string, number>;
+    /** Reference id → display name, the degrade target of a token that cannot bind. */
+    readonly nameById: ReadonlyMap<string, string>;
+    /**
+     * How many image references actually ship — the same range gate `{image:N}`
+     * uses. A seat past it (a capped-out or duplicate-URL ref) must not bind.
+     */
+    readonly imageCount: number;
+}
+/**
+ * Rewrite id-addressed reference tokens into the `@image_N` binding of the
+ * reference the caller sent under that id.
+ *
+ * Ids are matched by IDENTITY against the known ids (seated or named), never
+ * parsed by character class: the whole content is tried as an id first (the
+ * longest reading — an id may itself end in something label-shaped), then
+ * `<id>:<label>` split at the last colon, then the token is unknown. The label
+ * class is the one `REFERENCE_TOKEN_RE` uses. An id containing `{`, `}`, an
+ * `@name:N` mention or a `{image:N}` token is unsupported (the mention pass
+ * runs first and would rewrite it; a brace ends the token).
+ *
+ * Per token:
+ *   - id seated in range → `REF_BINDING.image(label, N)` when labeled, else the
+ *     bare `REF_BINDING.ordinal(N)` — exactly what `{image:N[:label]}` emits.
+ *   - otherwise (unknown id, ref skipped by the walk, capped out, or no image
+ *     references at all) → the label if given, else the ref's display name if
+ *     the id is known, else "". A token never ships raw — a malformed one is
+ *     dropped by the last-resort net.
+ *
+ * No whitespace tidy here: every caller runs `resolveReferenceTokens` after
+ * this (the core does at every return), and that collapses the gap a dropped
+ * token leaves. Returns the input untouched when it carries no `{ref:` at all.
+ */
+declare function resolveRefIdTokens(prompt: string | undefined, ctx: RefIdTokenContext): string | undefined;
+
+/**
+ * Shared video-reference resolver CORE — the ONE pure implementation of the
+ * video-prompt `@-mention` + canonical-fallback + extras assembly that BOTH the
+ * frontend (`frontend/src/lib/video-prompt-assembly.ts`) and backend
+ * (`backend/src/services/workflow-engine/payload-builder.ts`) resolvers delegate
+ * to.
+ *
+ * Historically the FE and BE each hand-rolled a byte-for-byte copy of this logic
+ * (they had to stay in lock-step or single-node FE runs and orchestrator runs
+ * would diverge). This module is the lift-and-shift of the FRONTEND resolver's
+ * post-expansion body into one place so there is a single source of truth.
+ *
+ * Purity contract: NO FE/BE-only dependencies. The caller is responsible for the
+ * layer-specific work BEFORE calling in:
+ *   - expanding wired Character upstreams into `ConnectedReference[]`
+ *     (`wiredCharRefs`), and
+ *   - looking up an extra-ref's character metadata by slug
+ *     (`lookupCharacterBySlug` — FE: `nodes.find(...)`, BE: `buildCtx`).
+ *
+ * Behavior-preserving when first extracted (the FE resolver's post-expansion
+ * body was lifted verbatim). The ONE intended output change since is the
+ * reference-binding surface string: the per-image subject phrasing, the bullet
+ * ordinals, and the frame directive now emit `@image_N` / `@video_N` /
+ * `@audio_N` (the legacy form was `Image N`) — all routed through the single
+ * `REF_BINDING` swap-point below. The structural strings ("Use these
+ * characters:", the bullet layout, "… is the same subject as …") are otherwise
+ * unchanged.
+ */
+
 /**
  * Positional reference counts the editor tokens are resolved against — how many
  * image / video / audio references are wired into the node, in worker-payload
@@ -1102,6 +1163,13 @@ declare function resolveReferenceTokens(prompt: string | undefined, counts: Refe
  * frontend `ExtraRef` / backend extras: only the fields this core reads.
  */
 interface VideoExtraRef {
+    /**
+     * The caller's own id for this reference (`connectedReferences[].id` on the
+     * route, `extraRefs[].id` on the canvas) — what a `{ref:<id>}` token in the
+     * prompt names. Slot-map only: the reorder's tile id stays `wired:<url>`.
+     * Absent → the extra cannot be addressed by id (it still numbers normally).
+     */
+    id?: string;
     url: string;
     description?: string;
     characterSlug?: string;
@@ -1207,6 +1275,15 @@ interface ResolveVideoReferenceCoreArgs {
      * Wired in Phase B Tasks 2-3.
      */
     hybridRoles?: boolean;
+    /**
+     * Display names for EVERY reference the caller knows by id — including the
+     * ones it did NOT hand to this walk (the route caps `connectedReferences` to
+     * the provider's image budget before calling in). A `{ref:<id>}` token that
+     * cannot bind degrades to `label ?? refNamesById[id] ?? ""`, so a capped-out
+     * or skipped reference keeps its name in the prose instead of vanishing.
+     * The wired character refs' `defaultName`s are known without this.
+     */
+    refNamesById?: ReadonlyMap<string, string>;
 }
 /**
  * Resolve `@kira:N` / `@kira:N:smile` mentions in a video-node prompt against
@@ -1961,7 +2038,10 @@ interface PickerCatalog {
     readonly options?: readonly PickerOption[];
     /** multi-dim: the dimension keys (no single catalog to flatten). */
     readonly fields?: readonly string[];
-    /** multi-dim: one self-describing entry per dimension field, in `fields` order. */
+    /** Per-field option lists. Multi-dim catalogs always carry these, one per
+     *  `fields` entry in order; a single-dim catalog carries them when it has
+     *  secondary parameter fields beside its main picker (transition
+     *  position/duration/intensity). */
     readonly dimensions?: readonly PickerDimension[];
 }
 /**
@@ -3011,9 +3091,23 @@ interface CharacterFx {
     /** Optional authored compact term (see `term.ts` for the convention). */
     readonly term?: string;
 }
-type CharacterFxPosition = "auto" | "start" | "middle" | "end" | "full";
-type CharacterFxDuration = "auto" | "instant" | "short" | "medium" | "long";
-type CharacterFxIntensity = "auto" | "subtle" | "natural" | "dynamic" | "crazy";
+/**
+ * The three timing scales, each derived from the catalog that defines it (see
+ * `CHARACTER_FX_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 `character-fx-timing-catalogs.test.ts`.
+ */
+type CharacterFxPosition = (typeof CHARACTER_FX_POSITIONS)[number]["id"];
+type CharacterFxDuration = (typeof CHARACTER_FX_DURATIONS)[number]["id"];
+type CharacterFxIntensity = (typeof CHARACTER_FX_INTENSITIES)[number]["id"];
 interface CharacterFxTiming {
     position?: CharacterFxPosition;
     duration?: CharacterFxDuration;
@@ -3034,6 +3128,125 @@ declare function getCharacterFxPromptHint(id: string | undefined | null): string
  */
 declare function getCharacterFxTerm(id: string | undefined | null): string;
 declare const CHARACTER_FX_IDS: ReadonlyArray<string>;
+/**
+ * The character-fx node's three timing parameters, as catalogs.
+ *
+ * Graded scales in the standard option shape, so a consumer that can only send
+ * ids (Studio, the SDK, MCP) can offer Position / Duration / Intensity 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.
+ *
+ * These are NOT the transition node's scales, even though the ids match. The
+ * wording is deliberately different — a transition OCCURS and SPANS the clip,
+ * an effect MANIFESTS and PERSISTS — and the three intensity clauses coincide
+ * by accident, not by shared definition. Keep the two catalogs separate; do
+ * not fold one into the other.
+ *
+ * `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 CharacterFxTimingOption {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    readonly promptHint: string;
+    readonly term?: string;
+}
+declare const CHARACTER_FX_POSITIONS: readonly [{
+    readonly id: "auto";
+    readonly label: "Auto";
+    readonly description: "Let the model place the effect";
+    readonly promptHint: "";
+    readonly term: "";
+}, {
+    readonly id: "start";
+    readonly label: "Start";
+    readonly description: "Occurs at the opening of the clip";
+    readonly promptHint: "the effect occurs at the opening of the clip";
+    readonly term: "at the opening of the clip";
+}, {
+    readonly id: "middle";
+    readonly label: "Middle";
+    readonly description: "Occurs in the middle of the clip";
+    readonly promptHint: "the effect occurs in the middle of the clip";
+    readonly term: "mid-clip";
+}, {
+    readonly id: "end";
+    readonly label: "End";
+    readonly description: "Occurs at the end of the clip";
+    readonly promptHint: "the effect occurs at the end of the clip";
+    readonly term: "at the end of the clip";
+}, {
+    readonly id: "full";
+    readonly label: "Full";
+    readonly description: "Persists for the entire clip";
+    readonly promptHint: "the effect persists for the entire clip";
+    readonly term: "persisting for the whole clip";
+}];
+declare const CHARACTER_FX_DURATIONS: readonly [{
+    readonly id: "auto";
+    readonly label: "Auto";
+    readonly description: "Let the model time the effect";
+    readonly promptHint: "";
+    readonly term: "";
+}, {
+    readonly id: "instant";
+    readonly label: "Instant";
+    readonly description: "Manifests instantaneously";
+    readonly promptHint: "manifesting instantaneously";
+    readonly term: "manifesting instantly";
+}, {
+    readonly id: "short";
+    readonly label: "Short (~1s)";
+    readonly description: "Manifests over approximately 1 second";
+    readonly promptHint: "manifesting over approximately 1 second";
+    readonly term: "manifesting over about 1 second";
+}, {
+    readonly id: "medium";
+    readonly label: "Medium (~2s)";
+    readonly description: "Manifests over approximately 2 seconds";
+    readonly promptHint: "manifesting over approximately 2 seconds";
+    readonly term: "manifesting over about 2 seconds";
+}, {
+    readonly id: "long";
+    readonly label: "Long (~3s)";
+    readonly description: "Manifests over approximately 3 seconds";
+    readonly promptHint: "manifesting over approximately 3 seconds";
+    readonly term: "manifesting over about 3 seconds";
+}];
+declare const CHARACTER_FX_INTENSITIES: readonly [{
+    readonly id: "auto";
+    readonly label: "Auto";
+    readonly description: "Let the model judge the effect's energy";
+    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 character-fx prompt-hint sentence from an effect id (or array
  * of 1-2 ids for multi-pick) plus target-ref display names (from upstream
@@ -4802,9 +5015,23 @@ interface Transition {
      */
     readonly term?: string;
 }
-type TransitionPosition = "auto" | "start" | "middle" | "end" | "full";
-type TransitionDuration = "auto" | "instant" | "short" | "medium" | "long";
-type TransitionIntensity = "auto" | "subtle" | "natural" | "dynamic" | "crazy";
+/**
+ * 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;
@@ -4827,6 +5054,120 @@ declare function getTransitionPromptHint(id: string | undefined | null): string;
  */
 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
@@ -5205,13 +5546,33 @@ interface ResolvePromptArgs {
      *  Off/undefined = exact legacy precedence (override > typed > wired) for every
      *  other node type. */
     appendWired?: boolean;
+    /** Pre/post text wrapped around WHICHEVER core precedence produced (override,
+     *  typed, wired, or the appendWired combination). Applied last. */
+    affixes?: PromptAffixes;
 }
+/** The ONE join rule between two non-blank prompt parts: a single space unless
+ *  the boundary already has whitespace on either side or the right part opens
+ *  with sentence punctuation. Shared by `joinPromptParts` and the editor's
+ *  Final-view segment builder so preview and run agree byte-for-byte. */
+declare function promptPartSeparator(left: string, right: string): "" | " ";
+/** Join prompt parts with `promptPartSeparator`; blank parts are dropped,
+ *  non-blank parts are used verbatim (no trimming). */
+declare function joinPromptParts(parts: ReadonlyArray<string | undefined>): string;
+/**
+ * Wrap `core` with the node's pre/post text. `{Label}` refs are resolved in the
+ * AFFIXES only — the core arrives exactly as the caller's precedence produced it.
+ * NO-OP GUARANTEE: with no non-blank affix the core is returned unchanged (same
+ * reference) — every existing workflow stays byte-identical.
+ * EMPTY CORE: a blank core with affixes yields the joined affixes alone.
+ */
+declare function applyPromptAffixes(core: string, affixes: PromptAffixes | undefined, refMap: ReadonlyMap<string, string>): string;
+declare function applyPromptAffixes(core: string | undefined, affixes: PromptAffixes | undefined, refMap: ReadonlyMap<string, string>): string | undefined;
 /** SINGLE SOURCE OF TRUTH for prompt precedence across both DAG engines:
  *  override (list fan-out) > first present typed candidate > wired > "".
  *  "present" = non-empty after trim. {Label} refs are resolved on the chosen
  *  branch via the shared resolveNodeRefs. With `appendWired`, the chosen base
- *  AND the wired value are both emitted (joined ". "). */
-declare function resolvePrompt({ override, typed, wired, refMap, appendWired }: ResolvePromptArgs): string;
+ *  AND the wired value are both emitted (joined ". "). Affixes wrap the result. */
+declare function resolvePrompt({ override, typed, wired, refMap, appendWired, affixes }: ResolvePromptArgs): string;
 /** Compose a final NEGATIVE prompt from a TYPED base + a WIRED (connected
  *  negative-handle) value: both are emitted, joined ". " (mirrors `appendWired`
  *  for the positive prompt). Pure join — the caller resolves `{label}` refs on
@@ -5245,6 +5606,145 @@ declare function computeLlmChatFields(data: Record<string, unknown>, { override,
     systemPrompt: string;
 };
 
+/** Which prompt field a snippet belongs to. Negative-target snippets only
+ *  surface in negative-prompt fields, and are bare comma lists by convention
+ *  (per Google's Veo guidance, a negative FIELD must name the unwanted thing,
+ *  never "no X"). */
+type SnippetTarget = "prompt" | "negative";
+/** Node modality a snippet applies to. A node declares its modality once in
+ *  the frontend's NODE_PROMPT_FIELDS; the menu shows snippets whose `media`
+ *  contains it. */
+type SnippetMedia = "image" | "video" | "audio" | "text";
+declare const SNIPPET_MEDIA_VALUES: readonly SnippetMedia[];
+interface FactorySnippet {
+    /** Stable kebab slug, e.g. "identity-lock". Unique across the catalog. */
+    readonly id: string;
+    readonly name: string;
+    /** One-liner shown in the menu and matched by search. */
+    readonly description?: string;
+    /** The exact fragment inserted into the prompt. Single line; never contains
+     *  `{`, `}`, or `@` (guard-tested) so it can never form a mention/variable
+     *  token in the editor. */
+    readonly text: string;
+    readonly target: SnippetTarget;
+    readonly media: readonly SnippetMedia[];
+    /** Menu group AND the pill-swap sibling pool (swap lists same-category). */
+    readonly category: string;
+}
+
+/**
+ * Single source of truth: which data field(s) hold a node's user-editable
+ * prompt text. Drives the quick-edit Prompt modal so it can work generically
+ * across every AI node without each call site hardcoding a field name.
+ *
+ * The registry LIVES HERE (`@nodaro/prompts`) so the backend orchestrator, the
+ * `/v1/nodes` registry, the prompt-affix totality tests and the docs tooling
+ * read the SAME list the editor does. `frontend/src/lib/prompt-fields.ts` is a
+ * pure re-export of this module — frontend code keeps importing
+ * `@/lib/prompt-fields` unchanged.
+ *
+ * Most nodes store the prompt in `data.prompt`, but several don't
+ * (`text-prompt` → `text`, `image-to-text` → `customPrompt`, …) — this map is
+ * where that knowledge lives, once.
+ *
+ * INVARIANT: every node that exposes a user-editable prompt MUST have an entry
+ * here, or the quick-edit modal silently does nothing for it. A guard test
+ * (`prompt-fields.test.ts`) keeps this in sync with the node set.
+ *
+ * This module is intentionally pure data (no React/lucide imports) so it can be
+ * pulled into the app-runtime bundle and any test without dragging in the icon
+ * library. The string `icon` kind is mapped to a concrete lucide component in
+ * `prompt-edit-button.tsx` (`getPromptIcon`), the only place that renders it.
+ */
+
+/** Which lucide glyph a node's prompt affordance uses. Kept as a string so this
+ *  module stays icon-library-free; mapped to a component in the strip button. */
+type PromptIconKind = "pencil" | "paintbrush";
+interface PromptFieldSpec {
+    /** Data key holding the primary prompt (e.g. "prompt", "text", "customPrompt"). */
+    readonly prompt: string;
+    /** Data key holding the negative prompt, when the node supports one. */
+    readonly negative?: string;
+    /** Label override for the primary field (defaults to "Prompt"). */
+    readonly promptLabel?: string;
+    /** Icon for the prompt affordance (strip button + modal title). Defaults to a
+     *  pencil; image-editing nodes use a paintbrush to read as "edit". */
+    readonly icon?: PromptIconKind;
+    /** Node modality for prompt-snippet scoping — drives which snippet pool the
+     *  "/" menu and Snippets button show for this node's prompt fields. REQUIRED
+     *  so a new node cannot forget to declare it (compile error). */
+    readonly media: SnippetMedia;
+    /** True when this node renders a media-result preview body and therefore
+     *  participates in inline-prompt mode (the `InlineNodePrompt` editor on the
+     *  node face, centralized in `BaseNode`). REQUIRED (like `media`) so a new
+     *  prompt node must consciously choose — compile error if omitted. The set of
+     *  `inline: true` types is guarded in `prompt-fields.test.ts`. */
+    readonly inline: boolean;
+    /** Some nodes only READ their prompt field when a sibling discriminator
+     *  selects it — TTS keeps `directText` but resolves it only while
+     *  `textSource === "direct"`, defaulting to `"connected"`. Writing the text
+     *  without flipping the discriminator saved the value and then failed with
+     *  "no text found" (founder hit it live, 2026-08-14). Declare the pair here
+     *  and every writer flips it automatically. */
+    readonly promptGate?: {
+        readonly field: string;
+        readonly value: string;
+    };
+    /** Prompt pre/post text (`promptPrefix` / `promptSuffix`) support. Defaults to
+     *  ON for every prompt node; set `false` ONLY for a node whose "prompt" is not
+     *  a model prompt (the plain Text input node). Read via `nodeSupportsPromptAffixes`. */
+    readonly affixes?: false;
+}
+declare const NODE_PROMPT_FIELDS: Readonly<Record<string, PromptFieldSpec>>;
+/** The prompt-field spec for a node type, or undefined if it has none. */
+declare function getPromptFields(nodeType: string | undefined): PromptFieldSpec | undefined;
+/** True when this node type has a registered, quick-editable prompt field. */
+declare function nodeHasPromptField(nodeType: string | undefined): boolean;
+/** Snippet modality for a node type (drives the snippet pool), or undefined
+ *  when the node has no prompt field. */
+declare function getSnippetMedia(nodeType: string | undefined): SnippetMedia | undefined;
+/** True when this node type renders the inline on-node prompt editor — the
+ *  media-preview nodes (image/video/audio result body). Single source for
+ *  BaseNode's centralized `InlineNodePrompt` rendering and the gold nodes'
+ *  `showInline` derivation (`useInlinePromptActive`). */
+declare function nodeHasInlinePrompt(nodeType: string | undefined): boolean;
+/** True when the node type carries `promptPrefix` / `promptSuffix` — every
+ *  registered prompt node except explicit opt-outs (`affixes: false`). The single
+ *  predicate the config panel, Final view, `/v1/nodes` registry, totality tests
+ *  and docs tooling all gate on. */
+declare function nodeSupportsPromptAffixes(nodeType: string | undefined): boolean;
+/**
+ * Where the RUN-TIME prompt lives when it differs from the editor's prompt
+ * field (spec §7). `generate-script`'s editable prompt is its `styleGuide`, but
+ * the run wraps the topic `prompt` with the affixes — so previewing the style
+ * guide must NOT show them.
+ */
+declare const PROMPT_AFFIX_CORE_FIELD_OVERRIDES: Readonly<Record<string, string>>;
+/** The data key whose value the run wraps with promptPrefix/promptSuffix, or
+ *  undefined when the node has no affixes. */
+declare function promptAffixCoreField(nodeType: string | undefined): string | undefined;
+/**
+ * True when a preview of `promptField` on this node must show the affixes —
+ * i.e. that key is what the run actually wraps. THE gate for the editor's Final
+ * view, so a sibling field (llm-chat's `systemPrompt`, generate-script's
+ * `styleGuide`) never renders a wrap the run doesn't perform.
+ *
+ * Two ways a key qualifies:
+ *  - it IS the core field ({@link promptAffixCoreField}), or
+ *  - it is a run-time FALLBACK candidate for the type
+ *    ({@link NODE_PROMPT_CANDIDATE_FIELDS}) — `computeNodePrompt` picks the
+ *    first present candidate and wraps THAT, so i2v's legacy `motionPrompt`
+ *    genuinely receives the affixes when `data.prompt` is empty.
+ *
+ * The two rules never collide: no override type declares candidates (guarded in
+ * `node-prompt-fields.test.ts`).
+ *
+ * `undefined` means "the node's primary prompt field" — the common call.
+ */
+declare function promptFieldCarriesAffixes(nodeType: string | undefined, promptField: string | undefined): boolean;
+/** The affix-capable node types, derived from the registry (never hand-listed). */
+declare const PROMPT_AFFIX_NODE_TYPES: ReadonlySet<string>;
+
 interface FactoryPreset {
     /** Stable slug "<nodeType>/<kebab-name>" — used as a React key and in exports. */
     readonly id: string;
@@ -5334,32 +5834,6 @@ declare const OBJECT_ASSET_PRESETS: Record<ObjectPresetAssetType, readonly strin
 /** Prompt-fragment maps per asset type — backend buildVariantPrompt reads this. */
 declare const OBJECT_ASSET_PROMPTS: Record<ObjectPresetAssetType, Record<string, string>>;
 
-/** Which prompt field a snippet belongs to. Negative-target snippets only
- *  surface in negative-prompt fields, and are bare comma lists by convention
- *  (per Google's Veo guidance, a negative FIELD must name the unwanted thing,
- *  never "no X"). */
-type SnippetTarget = "prompt" | "negative";
-/** Node modality a snippet applies to. A node declares its modality once in
- *  the frontend's NODE_PROMPT_FIELDS; the menu shows snippets whose `media`
- *  contains it. */
-type SnippetMedia = "image" | "video" | "audio" | "text";
-declare const SNIPPET_MEDIA_VALUES: readonly SnippetMedia[];
-interface FactorySnippet {
-    /** Stable kebab slug, e.g. "identity-lock". Unique across the catalog. */
-    readonly id: string;
-    readonly name: string;
-    /** One-liner shown in the menu and matched by search. */
-    readonly description?: string;
-    /** The exact fragment inserted into the prompt. Single line; never contains
-     *  `{`, `}`, or `@` (guard-tested) so it can never form a mention/variable
-     *  token in the editor. */
-    readonly text: string;
-    readonly target: SnippetTarget;
-    readonly media: readonly SnippetMedia[];
-    /** Menu group AND the pill-swap sibling pool (swap lists same-category). */
-    readonly category: string;
-}
-
 /** Factory snippet catalog (v1: image + video; audio/text follow later).
  *  Order within a category = menu order = pill quick-cycle order. */
 
@@ -5450,4 +5924,4 @@ declare function getPickerWiring(nodeType: string | undefined | null): PickerWir
  */
 declare function buildSurroundFillPrompt(direction: SurroundDirection, userPrompt?: string): string;
 
-export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_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 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 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_IDS, 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 CharacterMeta, type CharacterMotionPromptInput, type CharacterPromptInput, type ColorLook, type ColorLookCategory, type CompositionEffect, type ComputeNodePromptArgs, type CreaturePromptInput, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, type DirectionFields, 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, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, type FacePromptInput, type FactoryPreset, type FactoryPresetGroup, type FactorySnippet, 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_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, type IdentityLockMode, 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, 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, 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, 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 PromptSegment, type PromptSegmentOrigin, type ProviderPromptDoctrine, REFERENCE_IMAGE_ROLES, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, type RecommendedModel, type ReferenceCounts, type RegisteredPersonEntry, type RenderQuality, type ResolveCharacterMentionsResult, type ResolveLocationMentionsResult, type ResolvePromptArgs, type ResolveVideoReferenceCoreArgs, 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, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type Setting, type SettingCategory, type SidecarCoverageReport, type SingleDimPickerWiring, type SnippetMedia, type SnippetTarget, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, type StructuredPromptFields, type Style, type StylePreset, type Styling, type StylingDimension, type StylingValue, 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_IDS, type Temporal, type TemporalCategory, type TemporalValue, type TermCarrier, type Transition, type TransitionCategory, type TransitionDuration, type TransitionIntensity, type TransitionPosition, type TransitionTiming, 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 VideoExtraRef, 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, appendField, appendMusicMeta, applyPickerJson, applyReferenceOrderToVideo, applyTemplate, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeNegative, composePickerCatalogs, composeSoundHintFromConnections, composeTransitionHintFromConnections, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, deriveTerm, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, 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, 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, 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, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, 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, hasUpstreamCharacter, identityRefsSentence, isAnalyzablePicker, isInstrumentalVocal, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, listPickerCatalogs, migratePersonValue, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptBindsFirstFrame, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderStructuredFields, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
+export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_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 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 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, 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 CharacterMotionPromptInput, type CharacterPromptInput, type ColorLook, type ColorLookCategory, type CompositionEffect, type ComputeNodePromptArgs, type CreaturePromptInput, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, type DirectionFields, 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, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, type FacePromptInput, type FactoryPreset, type FactoryPresetGroup, type FactorySnippet, 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_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, type IdentityLockMode, 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, 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, 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 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, type RecommendedModel, type RefIdTokenContext, type ReferenceCounts, type RegisteredPersonEntry, type RenderQuality, type ResolveCharacterMentionsResult, type ResolveLocationMentionsResult, type ResolvePromptArgs, type ResolveVideoReferenceCoreArgs, 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, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type Setting, type SettingCategory, type SidecarCoverageReport, type SingleDimPickerWiring, type SnippetMedia, type SnippetTarget, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, type StructuredPromptFields, type Style, type StylePreset, type Styling, type StylingDimension, type StylingValue, 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_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 VideoExtraRef, 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, appendField, appendMusicMeta, applyPickerJson, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeNegative, composePickerCatalogs, composeSoundHintFromConnections, composeTransitionHintFromConnections, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, deriveTerm, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, 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, 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, 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, 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, hasUpstreamCharacter, identityRefsSentence, isAnalyzablePicker, isInstrumentalVocal, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinPromptParts, listPickerCatalogs, migratePersonValue, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderStructuredFields, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };