@nodaro/prompts 1.9.0 → 1.11.0

package/dist/index.d.cts

@@ -859,6 +859,12 @@ interface BuildImagePromptConfig {
      * (`flux-lora-character`) — the trigger word + LoRA carries identity, so
      * the directive bullets are redundant and the wired-character refs
      * shouldn't be injected as `Image N`.
+     *
+     * The strip regex is grammar-agnostic — it eats LOCATION and named-IMAGE
+     * mentions (`@town:3:background`) as well as character ones. That is
+     * INTENDED, not an oversight: this path drops `connectedReferences` outright,
+     * so there is no reference left for any mention to bind to and a surviving
+     * token would reach the model as literal noise. Do not narrow it.
      */
     skipCharacterMentions?: boolean;
 }
@@ -1000,34 +1006,457 @@ 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.
+ * THE DIRECTION REGISTRY — the single, ordered table of every cinematic
+ * dimension the flat `direction` channel carries, plus the one renderer that
+ * folds it into prompt text.
+ *
+ * WHY IT EXISTS: before this module, five of the ~35 cinematic dimensions rode
+ * the `direction` wire channel and every other dimension was folded into prompt
+ * TEXT by the client. A production copied between clients therefore froze stale
+ * catalog wording, and each client re-implemented the fold. The table below is
+ * the platform-owned replacement: the wire carries ids, the platform renders
+ * the clauses, and the fold ORDER is exported so a client preview cannot drift
+ * from what the server actually emits.
+ *
+ * WIRE VOCABULARY: the keys are the platform's OWN node-data field names — the
+ * ones `SINGLE_PICKER_WIRING[].valueField` and the four `*_FIELD_BY_CATEGORY`
+ * maps already use (`shotSize`, `lightingStyle`, `isoValue`, `style`, `mood`,
+ * `cameraMotion`, …). A Studio-emitted graph and a hand-built canvas node
+ * therefore speak ONE vocabulary for one catalog, and every `build*Hints`
+ * already consumes these names.
+ *
+ * IMPORT RULE (hard): this module imports only `get*PromptHint` / `get*Term` /
+ * `build*Hints` FUNCTIONS — never a raw UPPERCASE catalog array.
+ * `catalog-funnel-ratchet.test.ts` derives its watch set from
+ * `picker-catalogs.ts`'s uppercase value imports and can only SHRINK, so a raw
+ * array import here would be a new offender. Nothing here reads an environment
+ * variable either (`content-free-contract.test.ts`) — verbosity and surface are
+ * threaded parameters, never deployment state.
+ *
+ * DELIBERATELY EXCLUDED, so neither is filed as a gap:
+ *  - `characterFx` — a per-shot composer with catalog timing levers
+ *    (`composeCharacterFxHintFromConnections`) positioned at an in-prose effect
+ *    token, not a bare id. A single-id channel cannot carry it.
+ *  - Subject / Styling / prop dimensions (`animal`, `heldProp`, `material`,
+ *    Person, Styling) — a separate `subject` channel, deliberately out of scope
+ *    here.
+ *
+ * PACK BLINDNESS (parity, not a regression): `get*PromptHint` reads the frozen
+ * base arrays, so ids added by a deployment-registered catalog pack resolve to
+ * `""` and contribute no clause. This is identical to the behavior of the five
+ * keys that shipped before this table; routing through `getPickerCatalog` is a
+ * deliberate non-goal.
+ */
+
+/** Which generation stages fold a dimension. */
+type DirectionSurface = "image" | "video" | "both";
+/** Verbosity family — the video policy folds `motion` compact, `look` full. */
+type DirectionFamily = "look" | "motion";
+interface DirectionFieldSpec {
+    /**
+     * Wire key — also the `DirectionFields` property name and the canvas
+     * node-data field name for the same catalog.
+     */
+    readonly key: string;
+    /**
+     * Which generation stages fold this dimension. Filtering happens in the
+     * RENDERER, never in the wire schema: an image-only key sent to
+     * `/v1/generate-video` is accepted and simply contributes no hint.
+     */
+    readonly surface: DirectionSurface;
+    /** Verbosity family. The video policy folds `motion` compact, `look` full. */
+    readonly family: DirectionFamily;
+    /** Ids honored per dimension. Extras are SLICED at render, never a 400. */
+    readonly maxPicks: number;
+    /**
+     * Render selected ids in this catalog's own doctrine: per-id for independent
+     * catalogs, ONE blended clause for Mood / Aesthetic / Photographer, the
+     * catalog's own multi builder where it has one. `[]` when nothing resolves.
+     */
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}
+/**
+ * THE TABLE. Declaration order IS fold order (`DIRECTION_KEYS`), pinned by
+ * `__tests__/direction-registry.test.ts`.
+ *
+ * Group order: camera motion leads (matching the video hint order the canvas
+ * and Studio both emit today), then composition → camera → exposure → light →
+ * style → scene → motion, then the LEGACY BLOCK last.
+ *
+ * THE LEGACY BLOCK (the last five rows) is the pre-registry published
+ * `DirectionFields`, placed LAST in today's exact `composePromptText` order so
+ * every existing caller's fold is byte-identical. They are WHOLE-CATALOG keys —
+ * `framingId` accepts ANY `FRAMINGS` id and `lightingId` ANY `LIGHTINGS` id —
+ * so they are NOT aliases of `shotSize` / `lightingStyle`, and an alias table
+ * would wrongly suppress a legal second selection. Overlap is handled instead
+ * by the exact-string dedupe in `renderDirectionHints`.
+ */
+declare const DIRECTION_FIELDS: readonly [{
+    readonly key: "cameraMotion";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "shotSize";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "angle";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "coverage";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "composition";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "vantage";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "pose";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "compositionEffect";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "cameraFormat";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "lens";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "aperture";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "shutterSpeed";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "isoValue";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "timeOfDay";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "lightingStyle";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "lightingDirection";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "lightingRatio";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "colorTemperature";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "colorLook";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "atmosphere";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "postProcess";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "style";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "mood";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "aesthetic";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "photoGenre";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "photographer";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "renderQuality";
+    readonly surface: "image";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "setting";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "era";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "backdrop";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "actionFx";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "temporalSpeed";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "temporalFreeze";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "temporalDirection";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "temporalShutter";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "transition";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 2;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "loopSubject";
+    readonly surface: "video";
+    readonly family: "motion";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "framingId";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "framingAngleId";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "lightingId";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "lensId";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}, {
+    readonly key: "cameraFormatId";
+    readonly surface: "both";
+    readonly family: "look";
+    readonly maxPicks: 1;
+    readonly render: (ids: readonly string[], mode: PickerHintMode) => string[];
+}];
+type DirectionFieldRow = (typeof DIRECTION_FIELDS)[number];
+type DirectionKey = DirectionFieldRow["key"];
+type ImageDirectionKey = Extract<DirectionFieldRow, {
+    surface: "image" | "both";
+}>["key"];
+type VideoDirectionKey = Extract<DirectionFieldRow, {
+    surface: "video" | "both";
+}>["key"];
+/**
+ * Flat cinematic-direction ids (Studio / MCP / canvas node data).
+ *
+ * Every key accepts a single id OR an array: multi-pick dimensions always carry
+ * an array, and a single-pick key may legitimately carry one (a client's
+ * partition writer preserving legacy out-of-catalog ids). Absent ≠ empty — a
+ * missing key means "no hint", never a default.
+ */
+type DirectionFields = {
+    readonly [K in DirectionKey]?: string | readonly string[];
+};
+/**
+ * Table order — THE canonical fold order. Exported so a client's "will inject
+ * into prompt" preview folds in the exact order the server does instead of
+ * re-deriving one.
+ */
+declare const DIRECTION_KEYS: ReadonlyArray<DirectionKey>;
+/** Verbosity for a whole fold, or split per family. */
+type DirectionHintMode = PickerHintMode | {
+    readonly look: PickerHintMode;
+    readonly motion: PickerHintMode;
+};
+/** Image policy: full clause for every dimension (today's behavior). */
+declare const IMAGE_HINT_MODE_DEFAULT: DirectionHintMode;
+/** Video policy: full look clauses, compact motion terms. */
+declare const VIDEO_HINT_MODE_DEFAULT: DirectionHintMode;
+declare function modeForFamily(mode: DirectionHintMode, family: DirectionFamily): PickerHintMode;
+/**
+ * Wire tolerance ceiling for an array-valued direction key. The SEMANTIC cap is
+ * the per-row render-time slice (`maxPicks`) — this is only the point past
+ * which a body is malformed rather than merely over-generous.
+ */
+declare const DIRECTION_ARRAY_CEILING = 8;
+/**
+ * Tolerance ceiling for the LENGTH of a single direction id. Catalog ids are
+ * short slugs (<= ~40 chars); 100 is generous and closes an otherwise unbounded
+ * string channel that lands verbatim in `jobs.input_data`.
+ *
+ * ONE literal for BOTH doors into the fold — the route's `directionSchema`
+ * (`backend/src/lib/direction-schema.ts`) and the persisted-node reader
+ * (`read-node-direction.ts`) — so the wire and the canvas cannot start
+ * disagreeing about which strings are ids at all.
+ */
+declare const DIRECTION_ID_MAX_CHARS = 100;
+/** The rows a given generation stage folds, in table order. */
+declare function directionFieldsForSurface(surface: "image" | "video"): ReadonlyArray<DirectionFieldSpec>;
+/**
+ * Every clause the `direction` channel injects, in canonical table order.
+ *
+ * Iterates the TABLE (never the caller's object), so unknown wire keys are
+ * ignored, the order is platform-owned, and off-surface dimensions are inert.
+ * Unknown IDS are silently skipped too — every `get*PromptHint` returns `""` on
+ * a miss, so a retired or pack-only id contributes no clause rather than a 400.
+ *
+ * DEDUPE: the result is de-duplicated by exact clause string, FIRST OCCURRENCE
+ * WINS (order-preserving). This is what lets the five legacy whole-catalog keys
+ * (`framingId`, `lightingId`, …) coexist with their canonical counterparts
+ * without an alias table: a caller sending `framingId` and `shotSize` with the
+ * SAME id emits the clause once, while `lightingId: "golden-hour"` alongside
+ * `lightingStyle: "rembrandt"` correctly emits BOTH (they are different ids in
+ * the same catalog — an alias table would have wrongly suppressed one).
+ * A caller sending two DIFFERENT ids for the same dimension gets both clauses,
+ * exactly as two wired picker nodes of one family behave today.
+ *
+ * Exported so a client's "will inject into prompt" preview renders the exact
+ * server output instead of re-implementing the fold.
+ */
+declare function renderDirectionHints(direction: DirectionFields | undefined, opts: {
+    surface: "image" | "video";
+    mode?: DirectionHintMode;
+}): string[];
+
+/**
+ * The measured hint join, shared by the image (`composePromptText`) and video
+ * (`composeVideoPromptText`) composers so the two can never drift.
  *
- * 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.
+ * EXACT NO-OP: zero hints → the user's prompt back VERBATIM AND UNTRIMMED (the
+ * platform-caller byte-parity contract — the old platform path passed the
+ * prompt straight to `buildImagePrompt`, which never trims, so trimming here
+ * would change the assembled prompt and the recorded `jobs.input_data`
+ * byte-for-byte). With hints → trim the body so the join reads cleanly
+ * ("prompt. hint", not "prompt . hint"), and drop a blank body so the result
+ * never starts with ". ".
  *
- * 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`).
+ * Never mutates its inputs.
+ */
+/** The measured separator between the user's prompt and each folded hint. */
+declare const PROMPT_HINT_SEPARATOR = ". ";
+/**
+ * Join a user prompt with its folded hint clauses.
  *
- * 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 trailing `.filter((p) => p.length > 0)` on the join array is
+ * parity-critical — do NOT remove it as "redundant": `hints` arrives
+ * pre-filtered but `userPrompt` does not, so a blank user prompt would
+ * otherwise make the result start with ". ".
  */
+declare function joinPromptHints(userPrompt: string, hints: readonly string[]): string;
 
+/**
+ * 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 +1488,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 +1614,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 +1726,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
@@ -1377,13 +1905,17 @@ declare function assembleSunoInput(input: AssembleSunoInput): AssembleSunoResult
  * This wrapper collapses them into one.
  *
  * THE NO-OP CONTRACT (load-bearing — the platform-caller parity relies on it):
- * the two platform callers (`execute-node` / `payload-builder`) compose their
- * prompt from the canvas graph themselves and pass NO cinematic `direction`
- * ids and NO `structured` fields. In that case `composePromptText` MUST return
- * the caller's `userPrompt` byte-for-byte unchanged, so the wrapper degenerates
- * to exactly the `buildImagePrompt(...)` call those sites make today. Studio
- * (and the MCP route) supply `direction` / `structured` and get the id-hint
- * composition on top.
+ * a node that carries NO stored `direction` / `structured` (every workflow
+ * authored before the canvas honored them) still reaches here with both absent,
+ * and `composePromptText` MUST return the caller's `userPrompt` byte-for-byte
+ * unchanged, so the wrapper degenerates to exactly the `buildImagePrompt(...)`
+ * call those sites made before. The platform callers (`execute-node` /
+ * `payload-builder`) compose their prompt from the canvas GRAPH themselves and
+ * ALSO forward a node's STORED `direction` / `structured` when it carries them
+ * (`readDirectionFields` / `readStructuredFields`); those nodes get the id-hint
+ * composition on top, ADDITIVE to the graph-wired cinematography hints the
+ * caller already folded into `userPrompt`. Studio and the MCP route supply the
+ * same two levers directly.
  *
  * THE EMPTY-CHECK FLAG (also load-bearing for parity): `execute-node` rejects a
  * truly-empty assembled prompt (its "type one, mention a character, or connect
@@ -1393,21 +1925,6 @@ declare function assembleSunoInput(input: AssembleSunoInput): AssembleSunoResult
  * guard (frontend, Studio, route) pass `throwOnEmpty: true`.
  */
 
-/**
- * Flat cinematic-direction ids the Studio framing UI (and the MCP route)
- * expose — all optional. Promoted here from Studio's `assembly.ts` so the
- * id → hint composition lives in one place. The platform callers pass none of
- * these (they fold their hints from the graph into `userPrompt` themselves).
- */
-interface DirectionFields {
-    /** Shot Type — the FRAMINGS shot-size/coverage/composition/vantage dimensions. */
-    framingId?: string;
-    /** Angle — the FRAMINGS angle dimension (separate pill, so it can coexist with Shot Type). */
-    framingAngleId?: string;
-    lightingId?: string;
-    lensId?: string;
-    cameraFormatId?: string;
-}
 /**
  * Input to `assembleImageInput`. A faithful SUPERSET of what the two platform
  * callers pass to `buildImagePrompt` today (so they can route through this
@@ -1427,8 +1944,9 @@ interface AssembleImageInput {
     connectedReferences?: ConnectedReference[];
     /**
      * Flat cinematic-direction ids → folded into the prompt as hints. Studio /
-     * MCP-route use; the platform callers pass none (so `composePromptText` is a
-     * no-op for them and the result is byte-identical to today).
+     * MCP-route use, and the platform callers' narrow-read of a node's STORED
+     * `data.direction`; absent on a node that carries none (so `composePromptText`
+     * is a no-op for it and the result is byte-identical to today).
      */
     direction?: DirectionFields;
     /** Path-1 structured fields → composed fragment appended to the prompt. */
@@ -1496,6 +2014,134 @@ interface AssembleImageInput {
  */
 declare function assembleImageInput(input: AssembleImageInput): BuildImagePromptResult;
 
+/**
+ * `composeVideoPromptText` — the video twin of `assemble-image-input.ts`'s
+ * `composePromptText`: fold cinematic-direction picker IDS into the prompt BODY,
+ * server-side, at the model call.
+ *
+ * WHY THIS EXISTS: `/v1/generate-video` had no structured direction channel, so
+ * every client baked the hint TEXT itself. A copied scene then carried stale
+ * catalog wording forever, a re-generate double-baked it, and each client
+ * re-implemented the fold with its own separator and its own order. The wire
+ * now carries ids; the platform renders the clauses.
+ *
+ * WHERE IT RUNS (load-bearing): on the prompt BODY, BEFORE
+ * `resolveVideoReferenceCore`. That resolver FRAMES the body — legacy prepends
+ * its `Use these characters:` block, hybrid prepends the lock lines and APPENDS
+ * the canonical role phrases and extras. Folding afterwards would push the
+ * scene/look description PAST the identity directives, a worse version of the
+ * bug this channel exists to fix. The image side is structurally identical
+ * (`assembleImageInput` = `composePromptText` → `buildImagePrompt`).
+ *
+ * THE VERBOSITY POLICY LIVES HERE, NOT IN THE CLIENT: motion dimensions render
+ * their compact professional term, look dimensions their full clause
+ * (`VIDEO_HINT_MODE_DEFAULT`, resolved per row's `family` by the registry).
+ * It is a threaded PARAMETER with a pure default — never deployment state:
+ * `__tests__/content-free-contract.test.ts` hard-fails any environment read
+ * under `packages/prompts/src`, and this module has nothing to read anyway.
+ *
+ * EXACT NO-OP CONTRACT: with no direction and no structured fields the caller's
+ * `userPrompt` comes back VERBATIM AND UNTRIMMED — `undefined` included, since
+ * a video prompt is optional on the route. That is what keeps every existing
+ * caller byte-identical (the "backward-compatible: no connectedReferences →
+ * prompt + flat refs pass through unchanged" oracle in
+ * `backend/src/routes/__tests__/generate-video.test.ts`, restated locally in
+ * `__tests__/assemble-video-input.test.ts`).
+ *
+ * WHAT IS DELIBERATELY NOT HERE: the dimension table, the fold order, the
+ * dedupe and the surface filter all live in `direction-registry.ts` — ONE
+ * renderer serves both surfaces, so the image and video folds cannot drift.
+ * Clients render their "will inject into prompt" preview by importing
+ * `renderDirectionHints` + `joinPromptHints` directly.
+ */
+
+/**
+ * Fold a video run's cinematic-direction ids (and optional structured fields)
+ * into its prompt body.
+ *
+ * The direction hints land first, in the registry's canonical table order
+ * (camera motion leads), and the structured fragment lands LAST — the same
+ * ordering `composePromptText` uses for stills.
+ *
+ * @param userPrompt The user's prompt. Optional: an image-to-video run may
+ *   legitimately have none, and it is returned as-is when nothing folds.
+ * @param direction Flat catalog ids. Unknown keys, off-surface keys (an
+ *   image-only dimension sent to a video run) and unknown ids all contribute
+ *   nothing — never a throw.
+ * @param structured Path-1 structured fields. Not a `/v1/generate-video` wire
+ *   field today; the canvas orchestrator passes it directly.
+ * @param opts.hintMode Override the verbosity policy (a whole-fold
+ *   `PickerHintMode`, or a `{ look, motion }` split).
+ */
+declare function composeVideoPromptText(userPrompt: string | undefined, direction: DirectionFields | undefined, structured?: StructuredPromptFields, opts?: {
+    readonly hintMode?: DirectionHintMode;
+}): string | undefined;
+
+/**
+ * Narrow readers turning UNTRUSTED persisted node data (`workflows.nodes`
+ * JSONB — import, MCP write, node preset, a Studio-emitted graph) into the
+ * typed `direction` / `structured` levers `assembleImageInput` accepts.
+ * `buildPayload` has no zod and workflow writes are
+ * `z.record(z.string(), z.unknown())`, so this blob may have been written years
+ * ago by any client.
+ *
+ * Used by ALL THREE image-assembly sites so what the canvas accepts cannot
+ * drift between them: the frontend single-node executor (`execute-node.ts`),
+ * the orchestrator (`payload-builder.ts`), and the config-panel final-prompt
+ * preview (`build-image-assemble-input.ts`).
+ *
+ * `readDirectionFields` is DERIVED FROM `DIRECTION_FIELDS`, never a hand list:
+ * a dimension added to the registry is honored here by construction, so the
+ * reader can never silently drop a key the wire schema and the renderer both
+ * know about. Anything unrecognised is DROPPED, never thrown on — a malformed
+ * blob must not fail a canvas run, and an unknown catalog ID already degrades
+ * to `""` inside each `get*PromptHint`, so this validates SHAPE only.
+ *
+ * BOUNDS MATCH THE WIRE SCHEMA where both exist, by SHARED CONSTANT:
+ * `DIRECTION_ID_MAX_CHARS` and `DIRECTION_ARRAY_CEILING` are the same two
+ * literals the `generate-image` route's `directionSchema` enforces, imported
+ * from the registry rather than re-typed here — a body the route accepts and a
+ * node the canvas re-runs must not disagree about which strings are ids.
+ *
+ * DELIBERATELY STRICTER THAN THE WIRE SCHEMA on `structured` values: the
+ * route's `structuredPromptFieldsSchema` declares every field as a bare
+ * `z.string().optional()` (unbounded), while `MAX_STRUCTURED_VALUE_CHARS` below
+ * bounds them at 200. Do not "fix" that asymmetry by loosening HERE — this
+ * reads a blob any client may have written years ago, and the values land
+ * verbatim in `jobs.input_data.prompt`. Tightening the ROUTE instead would be a
+ * new 400 on currently-accepted input, so a >200-char structured value stored
+ * on a node is dropped on a canvas run while `POST /v1/generate-image` still
+ * renders it. That is the one known divergence; it is bounded to a field the
+ * canvas UI never writes that long.
+ *
+ * RETURNS `undefined`, NEVER `{}`: an empty object would still be a *defined*
+ * `direction`, and the call sites' `...(x !== undefined ? { x } : {})` spread
+ * would then hand `assembleImageInput` a defined-but-empty lever. Returning
+ * `undefined` keeps that spread honest and the exact no-op branch taken.
+ */
+
+/**
+ * Read a node's stored cinematic-direction ids. Accepts a single id OR an array
+ * on every key (multi-pick dimensions carry arrays; a single-pick key may
+ * legitimately carry one).
+ *
+ * The SEMANTIC per-dimension cap stays the renderer's slice (`maxPicks`) — this
+ * reader does not know a row's pick budget and must not guess it. But it DOES
+ * bound cardinality at `DIRECTION_ARRAY_CEILING`, the same ceiling the wire
+ * schema enforces: the value is untrusted persisted JSONB (a node blob is
+ * validated only as `z.record(z.string(), z.unknown())` on write), and handing
+ * an unbounded array to `renderDirectionHints` would put an `includes`-dedupe
+ * scan in front of that slice. Keeping the FIRST `DIRECTION_ARRAY_CEILING`
+ * survivors is what the wire door already does to the same input.
+ *
+ * Junk is filtered BEFORE the cap, so valid ids sitting behind malformed
+ * entries survive rather than being crowded out by them.
+ */
+declare function readDirectionFields(value: unknown): DirectionFields | undefined;
+/** Read a node's stored Path-1 structured prompt fields. Same drop-never-throw
+ *  and `undefined`-never-`{}` contract as `readDirectionFields`. */
+declare function readStructuredFields(value: unknown): StructuredPromptFields | undefined;
+
 type Seedance2Mode = "first-frame" | "first-last-frame" | "reference";
 interface Seedance2InputsArgs {
     /** The generation prompt — used ONLY to detect an existing first-frame
@@ -3014,9 +3660,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;
@@ -3037,6 +3697,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
@@ -5714,4 +6493,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, 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 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, 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, DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, type DirectionFamily, type DirectionFieldRow, type DirectionFieldSpec, type DirectionFields, type DirectionHintMode, type DirectionKey, 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, 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_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, 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 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_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 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, composeVideoPromptText, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, deriveTerm, directionFieldsForSurface, 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, joinPromptHints, joinPromptParts, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDirectionHints, renderStructuredFields, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };