@nodaro/prompts 1.38.0 → 1.39.0

package/dist/{chunk-7XKHDXCL.cjs → chunk-3U7X6JZN.cjs}

@@ -1,21 +1,22 @@
 'use strict';
 
-var chunkMENBHEAY_cjs = require('./chunk-MENBHEAY.cjs');
+var chunkWRM52ZBN_cjs = require('./chunk-WRM52ZBN.cjs');
+var chunk2P26SZX5_cjs = require('./chunk-2P26SZX5.cjs');
 
 // src/read-node-direction.ts
 function readDirectionFields(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
   const src = value;
   const out = {};
-  for (const spec of chunkMENBHEAY_cjs.DIRECTION_FIELDS) {
+  for (const spec of chunk2P26SZX5_cjs.DIRECTION_FIELDS) {
     const v = src[spec.key];
     if (typeof v === "string") {
-      if (v.length > 0 && v.length <= chunkMENBHEAY_cjs.DIRECTION_ID_MAX_CHARS) out[spec.key] = v;
+      if (v.length > 0 && v.length <= chunk2P26SZX5_cjs.DIRECTION_ID_MAX_CHARS) out[spec.key] = v;
     } else if (Array.isArray(v)) {
       const kept = [];
       for (const x of v) {
-        if (kept.length >= chunkMENBHEAY_cjs.DIRECTION_ARRAY_CEILING) break;
-        if (typeof x === "string" && x.length > 0 && x.length <= chunkMENBHEAY_cjs.DIRECTION_ID_MAX_CHARS) {
+        if (kept.length >= chunk2P26SZX5_cjs.DIRECTION_ARRAY_CEILING) break;
+        if (typeof x === "string" && x.length > 0 && x.length <= chunk2P26SZX5_cjs.DIRECTION_ID_MAX_CHARS) {
           kept.push(x);
         }
       }
@@ -28,19 +29,19 @@ function readSubjectFields(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
   const src = value;
   const out = {};
-  for (const key of chunkMENBHEAY_cjs.getRegisteredSubjectKeys()) {
+  for (const key of chunkWRM52ZBN_cjs.getRegisteredSubjectKeys()) {
     const v = src[key];
-    if (key === chunkMENBHEAY_cjs.SUBJECT_CUSTOM_AGE_KEY) {
+    if (key === chunkWRM52ZBN_cjs.SUBJECT_CUSTOM_AGE_KEY) {
       if (typeof v === "number" && Number.isFinite(v)) out[key] = v;
       continue;
     }
     if (typeof v === "string") {
-      if (v.length > 0 && v.length <= chunkMENBHEAY_cjs.SUBJECT_ID_MAX_CHARS) out[key] = v;
+      if (v.length > 0 && v.length <= chunkWRM52ZBN_cjs.SUBJECT_ID_MAX_CHARS) out[key] = v;
     } else if (Array.isArray(v)) {
       const kept = [];
       for (const x of v) {
-        if (kept.length >= chunkMENBHEAY_cjs.SUBJECT_ARRAY_CEILING) break;
-        if (typeof x === "string" && x.length > 0 && x.length <= chunkMENBHEAY_cjs.SUBJECT_ID_MAX_CHARS) {
+        if (kept.length >= chunkWRM52ZBN_cjs.SUBJECT_ARRAY_CEILING) break;
+        if (typeof x === "string" && x.length > 0 && x.length <= chunkWRM52ZBN_cjs.SUBJECT_ID_MAX_CHARS) {
           kept.push(x);
         }
       }
@@ -117,5 +118,5 @@ function readStructuredFields(value) {
 exports.readDirectionFields = readDirectionFields;
 exports.readStructuredFields = readStructuredFields;
 exports.readSubjectFields = readSubjectFields;
-//# sourceMappingURL=chunk-7XKHDXCL.cjs.map
-//# sourceMappingURL=chunk-7XKHDXCL.cjs.map
+//# sourceMappingURL=chunk-3U7X6JZN.cjs.map
+//# sourceMappingURL=chunk-3U7X6JZN.cjs.map

package/dist/chunk-3U7X6JZN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/read-node-direction.ts"],"names":["DIRECTION_FIELDS","DIRECTION_ID_MAX_CHARS","DIRECTION_ARRAY_CEILING","getRegisteredSubjectKeys","SUBJECT_CUSTOM_AGE_KEY","SUBJECT_ID_MAX_CHARS","SUBJECT_ARRAY_CEILING"],"mappings":"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","file":"chunk-3U7X6JZN.cjs","sourcesContent":["/**\n * Narrow readers turning UNTRUSTED persisted node data (`workflows.nodes`\n * JSONB — import, MCP write, node preset, a Studio-emitted graph) into the\n * typed `subject` / `direction` / `structured` levers `assembleImageInput`\n * accepts.\n * `buildPayload` has no zod and workflow writes are\n * `z.record(z.string(), z.unknown())`, so this blob may have been written years\n * ago by any client.\n *\n * Used by ALL THREE image-assembly sites so what the canvas accepts cannot\n * drift between them: the frontend single-node executor (`execute-node.ts`),\n * the orchestrator (`payload-builder.ts`), and the config-panel final-prompt\n * preview (`build-image-assemble-input.ts`).\n *\n * `readDirectionFields` is DERIVED FROM `DIRECTION_FIELDS`, never a hand list:\n * a dimension added to the registry is honored here by construction, so the\n * reader can never silently drop a key the wire schema and the renderer both\n * know about. Anything unrecognised is DROPPED, never thrown on — a malformed\n * blob must not fail a canvas run, and an unknown catalog ID already degrades\n * to `\"\"` inside each `get*PromptHint`, so this validates SHAPE only.\n *\n * BOUNDS MATCH THE WIRE SCHEMA where both exist, by SHARED CONSTANT:\n * `DIRECTION_ID_MAX_CHARS` and `DIRECTION_ARRAY_CEILING` are the same two\n * literals the `generate-image` route's `directionSchema` enforces, imported\n * from the registry rather than re-typed here — a body the route accepts and a\n * node the canvas re-runs must not disagree about which strings are ids.\n *\n * DELIBERATELY STRICTER THAN THE WIRE SCHEMA on `structured` values: the\n * route's `structuredPromptFieldsSchema` declares every field as a bare\n * `z.string().optional()` (unbounded), while `MAX_STRUCTURED_VALUE_CHARS` below\n * bounds them at 200. Do not \"fix\" that asymmetry by loosening HERE — this\n * reads a blob any client may have written years ago, and the values land\n * verbatim in `jobs.input_data.prompt`. Tightening the ROUTE instead would be a\n * new 400 on currently-accepted input, so a >200-char structured value stored\n * on a node is dropped on a canvas run while `POST /v1/generate-image` still\n * renders it. That is the one known divergence; it is bounded to a field the\n * canvas UI never writes that long.\n *\n * RETURNS `undefined`, NEVER `{}`: an empty object would still be a *defined*\n * `direction`, and the call sites' `...(x !== undefined ? { x } : {})` spread\n * would then hand `assembleImageInput` a defined-but-empty lever. Returning\n * `undefined` keeps that spread honest and the exact no-op branch taken.\n */\nimport {\n  DIRECTION_ARRAY_CEILING,\n  DIRECTION_FIELDS,\n  DIRECTION_ID_MAX_CHARS,\n  type DirectionFields,\n} from \"./direction-registry.js\"\nimport {\n  SUBJECT_ARRAY_CEILING,\n  SUBJECT_CUSTOM_AGE_KEY,\n  SUBJECT_ID_MAX_CHARS,\n  getRegisteredSubjectKeys,\n  type SubjectFields,\n} from \"./subject-registry.js\"\nimport type { StructuredPromptFields } from \"./prompt-builder-structured-fields.js\"\n\n/**\n * Read a node's stored cinematic-direction ids. Accepts a single id OR an array\n * on every key (multi-pick dimensions carry arrays; a single-pick key may\n * legitimately carry one).\n *\n * The SEMANTIC per-dimension cap stays the renderer's slice (`maxPicks`) — this\n * reader does not know a row's pick budget and must not guess it. But it DOES\n * bound cardinality at `DIRECTION_ARRAY_CEILING`, the same ceiling the wire\n * schema enforces: the value is untrusted persisted JSONB (a node blob is\n * validated only as `z.record(z.string(), z.unknown())` on write), and handing\n * an unbounded array to `renderDirectionHints` would put an `includes`-dedupe\n * scan in front of that slice. Keeping the FIRST `DIRECTION_ARRAY_CEILING`\n * survivors is what the wire door already does to the same input.\n *\n * Junk is filtered BEFORE the cap, so valid ids sitting behind malformed\n * entries survive rather than being crowded out by them.\n */\nexport function readDirectionFields(value: unknown): DirectionFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, string | string[]> = {}\n  for (const spec of DIRECTION_FIELDS) {\n    const v = src[spec.key]\n    if (typeof v === \"string\") {\n      if (v.length > 0 && v.length <= DIRECTION_ID_MAX_CHARS) out[spec.key] = v\n    } else if (Array.isArray(v)) {\n      const kept: string[] = []\n      for (const x of v) {\n        if (kept.length >= DIRECTION_ARRAY_CEILING) break\n        if (typeof x === \"string\" && x.length > 0 && x.length <= DIRECTION_ID_MAX_CHARS) {\n          kept.push(x)\n        }\n      }\n      if (kept.length > 0) out[spec.key] = kept\n    }\n  }\n  return Object.keys(out).length > 0 ? (out as DirectionFields) : undefined\n}\n\n// ── subject ──────────────────────────────────────────────────────────────────\n\n/**\n * Read a node's stored SUBJECT ids — the flat Person / Styling / prop bag the\n * `subject` channel carries. Same three contracts as `readDirectionFields`:\n * drop-never-throw, `undefined` never `{}`, and bounds shared with the wire\n * door by CONSTANT (`SUBJECT_ID_MAX_CHARS` / `SUBJECT_ARRAY_CEILING`, which are\n * defined AS the direction constants) so a body the route accepts and the same\n * node re-run from the canvas cannot disagree about which strings are ids.\n *\n * DERIVED from `getRegisteredSubjectKeys()`, never a hand-authored field list —\n * that is the whole lesson of `readStructuredFields` below, whose hand table is\n * only viable because `StructuredPromptFields` is a small hand-authored type.\n * The subject vocabulary is ~54 catalog-derived fields PLUS deployment-registered\n * pack dimensions unknown at compile time, so it is read from the registry at\n * call time. Iterating the KEY SET (never `Object.keys(value)`) is also what\n * keeps an adversarial blob's key count off the hot path.\n *\n * The SEMANTIC per-dimension cap stays the renderer's job\n * (`normalizeSubjectFields`), exactly as `maxPicks` does for direction: this\n * reader bounds cardinality only. `customAge` is the one number on the wire and\n * is passed through finite-only — the renderer clamps it.\n */\nexport function readSubjectFields(value: unknown): SubjectFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, string | string[] | number> = {}\n  for (const key of getRegisteredSubjectKeys()) {\n    const v = src[key]\n    if (key === SUBJECT_CUSTOM_AGE_KEY) {\n      if (typeof v === \"number\" && Number.isFinite(v)) out[key] = v\n      continue\n    }\n    if (typeof v === \"string\") {\n      if (v.length > 0 && v.length <= SUBJECT_ID_MAX_CHARS) out[key] = v\n    } else if (Array.isArray(v)) {\n      // Junk is filtered BEFORE the cap, so valid ids sitting behind malformed\n      // entries survive rather than being crowded out by them.\n      const kept: string[] = []\n      for (const x of v) {\n        if (kept.length >= SUBJECT_ARRAY_CEILING) break\n        if (typeof x === \"string\" && x.length > 0 && x.length <= SUBJECT_ID_MAX_CHARS) {\n          kept.push(x)\n        }\n      }\n      if (kept.length > 0) out[key] = kept\n    }\n  }\n  return Object.keys(out).length > 0 ? (out as SubjectFields) : undefined\n}\n\n// ── structured ───────────────────────────────────────────────────────────────\n\ntype FieldKind = \"string\" | \"number\" | \"gender\"\nconst GENDERS = [\"man\", \"woman\", \"child\", \"non-binary\"] as const\nconst MAX_STRUCTURED_VALUE_CHARS = 200\n\ntype Group = Exclude<keyof StructuredPromptFields, \"mood\">\ntype GroupFields<K extends Group> = Record<keyof NonNullable<StructuredPromptFields[K]>, FieldKind>\n\n/**\n * A FIELD-BY-FIELD table (not a registry walk) on purpose:\n * `StructuredPromptFields` is a small HAND-AUTHORED type, not catalog-derived,\n * and the table is what blocks `person: { age: \"drop table\" }` from rendering\n * verbatim into `jobs.input_data.prompt` — `renderStructuredFields` never\n * throws on junk, but it does render it. Totality is enforced by the\n * `GroupFields<K>` / `{ [K in Group]: … }` mapped types: a new field or group\n * on the published type fails to typecheck here.\n */\nconst PERSON_FIELDS: GroupFields<\"person\"> = {\n  age: \"number\",\n  gender: \"gender\",\n  hair: \"string\",\n  eyes: \"string\",\n  expression: \"string\",\n  profession: \"string\",\n  warriorType: \"string\",\n}\nconst STYLING_FIELDS: GroupFields<\"styling\"> = {\n  mood: \"string\",\n  lighting: \"string\",\n  aesthetic: \"string\",\n  colorLook: \"string\",\n}\nconst SETTING_FIELDS: GroupFields<\"setting\"> = {\n  era: \"string\",\n  atmosphere: \"string\",\n  backdrop: \"string\",\n}\nconst CAMERA_FIELDS: GroupFields<\"camera\"> = {\n  framing: \"string\",\n  motion: \"string\",\n  format: \"string\",\n}\nconst LENS_FIELDS: GroupFields<\"lens\"> = { focalLength: \"string\", aperture: \"string\" }\n\nconst STRUCTURED_GROUPS: { [K in Group]: GroupFields<K> } = {\n  person: PERSON_FIELDS,\n  styling: STYLING_FIELDS,\n  setting: SETTING_FIELDS,\n  camera: CAMERA_FIELDS,\n  lens: LENS_FIELDS,\n}\n\nfunction readField(v: unknown, kind: FieldKind): string | number | undefined {\n  if (kind === \"number\") return typeof v === \"number\" && Number.isFinite(v) ? v : undefined\n  if (typeof v !== \"string\" || v.length === 0 || v.length > MAX_STRUCTURED_VALUE_CHARS) {\n    return undefined\n  }\n  if (kind === \"gender\") return (GENDERS as readonly string[]).includes(v) ? v : undefined\n  return v\n}\n\n/** Read a node's stored Path-1 structured prompt fields. Same drop-never-throw\n *  and `undefined`-never-`{}` contract as `readDirectionFields`. */\nexport function readStructuredFields(value: unknown): StructuredPromptFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, unknown> = {}\n  for (const group of Object.keys(STRUCTURED_GROUPS) as Group[]) {\n    const raw = src[group]\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) continue\n    const rawRec = raw as Record<string, unknown>\n    const kept: Record<string, unknown> = {}\n    for (const [field, kind] of Object.entries(\n      STRUCTURED_GROUPS[group] as Record<string, FieldKind>,\n    )) {\n      const v = readField(rawRec[field], kind)\n      if (v !== undefined) kept[field] = v\n    }\n    if (Object.keys(kept).length > 0) out[group] = kept\n  }\n  const mood = readField(src.mood, \"string\")\n  if (mood !== undefined) out.mood = mood\n  return Object.keys(out).length > 0 ? (out as StructuredPromptFields) : undefined\n}\n"]}

package/dist/chunk-4GKTOVFM.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+// src/image-token-pattern.ts
+var IMAGE_TOKEN_PATTERN = /\{image:(\d+)(?::([^}\n]+))?\}/gi;
+
+exports.IMAGE_TOKEN_PATTERN = IMAGE_TOKEN_PATTERN;
+//# sourceMappingURL=chunk-4GKTOVFM.cjs.map
+//# sourceMappingURL=chunk-4GKTOVFM.cjs.map

package/dist/chunk-4GKTOVFM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/image-token-pattern.ts"],"names":[],"mappings":";;;AAYO,IAAM,mBAAA,GAAsB","file":"chunk-4GKTOVFM.cjs","sourcesContent":["/**\n * The `{image:N}` / `{image:N:label}` reference-token grammar — one pattern for\n * the image prompt assembly (`prompt-builder.ts`) and for the preset metadata\n * that reads which references a template names (`factory-presets/references.ts`).\n *\n * Group 1 = position (1-based), group 2 = optional label. The label allows\n * spaces (multi-word labels like \"clothes and shoes\") but never a newline or\n * `}`, so a match can't run away across lines or token boundaries.\n *\n * Global on purpose (callers use `.replace` / `.matchAll`, which never leave a\n * `lastIndex` behind); never call `.test` / `.exec` on it.\n */\nexport const IMAGE_TOKEN_PATTERN = /\\{image:(\\d+)(?::([^}\\n]+))?\\}/gi\n"]}

package/dist/{chunk-HRBBNODV.js → chunk-6GVFJLDL.js}

@@ -1,4 +1,5 @@
-import { DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_ARRAY_CEILING, getRegisteredSubjectKeys, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_ID_MAX_CHARS, SUBJECT_ARRAY_CEILING } from './chunk-QDEWBBUR.js';
+import { getRegisteredSubjectKeys, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_ID_MAX_CHARS, SUBJECT_ARRAY_CEILING } from './chunk-DUXX6CBX.js';
+import { DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_ARRAY_CEILING } from './chunk-EAYEZXWT.js';
 
 // src/read-node-direction.ts
 function readDirectionFields(value) {
@@ -113,5 +114,5 @@ function readStructuredFields(value) {
 }
 
 export { readDirectionFields, readStructuredFields, readSubjectFields };
-//# sourceMappingURL=chunk-HRBBNODV.js.map
-//# sourceMappingURL=chunk-HRBBNODV.js.map
+//# sourceMappingURL=chunk-6GVFJLDL.js.map
+//# sourceMappingURL=chunk-6GVFJLDL.js.map

package/dist/chunk-6GVFJLDL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/read-node-direction.ts"],"names":[],"mappings":"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","file":"chunk-6GVFJLDL.js","sourcesContent":["/**\n * Narrow readers turning UNTRUSTED persisted node data (`workflows.nodes`\n * JSONB — import, MCP write, node preset, a Studio-emitted graph) into the\n * typed `subject` / `direction` / `structured` levers `assembleImageInput`\n * accepts.\n * `buildPayload` has no zod and workflow writes are\n * `z.record(z.string(), z.unknown())`, so this blob may have been written years\n * ago by any client.\n *\n * Used by ALL THREE image-assembly sites so what the canvas accepts cannot\n * drift between them: the frontend single-node executor (`execute-node.ts`),\n * the orchestrator (`payload-builder.ts`), and the config-panel final-prompt\n * preview (`build-image-assemble-input.ts`).\n *\n * `readDirectionFields` is DERIVED FROM `DIRECTION_FIELDS`, never a hand list:\n * a dimension added to the registry is honored here by construction, so the\n * reader can never silently drop a key the wire schema and the renderer both\n * know about. Anything unrecognised is DROPPED, never thrown on — a malformed\n * blob must not fail a canvas run, and an unknown catalog ID already degrades\n * to `\"\"` inside each `get*PromptHint`, so this validates SHAPE only.\n *\n * BOUNDS MATCH THE WIRE SCHEMA where both exist, by SHARED CONSTANT:\n * `DIRECTION_ID_MAX_CHARS` and `DIRECTION_ARRAY_CEILING` are the same two\n * literals the `generate-image` route's `directionSchema` enforces, imported\n * from the registry rather than re-typed here — a body the route accepts and a\n * node the canvas re-runs must not disagree about which strings are ids.\n *\n * DELIBERATELY STRICTER THAN THE WIRE SCHEMA on `structured` values: the\n * route's `structuredPromptFieldsSchema` declares every field as a bare\n * `z.string().optional()` (unbounded), while `MAX_STRUCTURED_VALUE_CHARS` below\n * bounds them at 200. Do not \"fix\" that asymmetry by loosening HERE — this\n * reads a blob any client may have written years ago, and the values land\n * verbatim in `jobs.input_data.prompt`. Tightening the ROUTE instead would be a\n * new 400 on currently-accepted input, so a >200-char structured value stored\n * on a node is dropped on a canvas run while `POST /v1/generate-image` still\n * renders it. That is the one known divergence; it is bounded to a field the\n * canvas UI never writes that long.\n *\n * RETURNS `undefined`, NEVER `{}`: an empty object would still be a *defined*\n * `direction`, and the call sites' `...(x !== undefined ? { x } : {})` spread\n * would then hand `assembleImageInput` a defined-but-empty lever. Returning\n * `undefined` keeps that spread honest and the exact no-op branch taken.\n */\nimport {\n  DIRECTION_ARRAY_CEILING,\n  DIRECTION_FIELDS,\n  DIRECTION_ID_MAX_CHARS,\n  type DirectionFields,\n} from \"./direction-registry.js\"\nimport {\n  SUBJECT_ARRAY_CEILING,\n  SUBJECT_CUSTOM_AGE_KEY,\n  SUBJECT_ID_MAX_CHARS,\n  getRegisteredSubjectKeys,\n  type SubjectFields,\n} from \"./subject-registry.js\"\nimport type { StructuredPromptFields } from \"./prompt-builder-structured-fields.js\"\n\n/**\n * Read a node's stored cinematic-direction ids. Accepts a single id OR an array\n * on every key (multi-pick dimensions carry arrays; a single-pick key may\n * legitimately carry one).\n *\n * The SEMANTIC per-dimension cap stays the renderer's slice (`maxPicks`) — this\n * reader does not know a row's pick budget and must not guess it. But it DOES\n * bound cardinality at `DIRECTION_ARRAY_CEILING`, the same ceiling the wire\n * schema enforces: the value is untrusted persisted JSONB (a node blob is\n * validated only as `z.record(z.string(), z.unknown())` on write), and handing\n * an unbounded array to `renderDirectionHints` would put an `includes`-dedupe\n * scan in front of that slice. Keeping the FIRST `DIRECTION_ARRAY_CEILING`\n * survivors is what the wire door already does to the same input.\n *\n * Junk is filtered BEFORE the cap, so valid ids sitting behind malformed\n * entries survive rather than being crowded out by them.\n */\nexport function readDirectionFields(value: unknown): DirectionFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, string | string[]> = {}\n  for (const spec of DIRECTION_FIELDS) {\n    const v = src[spec.key]\n    if (typeof v === \"string\") {\n      if (v.length > 0 && v.length <= DIRECTION_ID_MAX_CHARS) out[spec.key] = v\n    } else if (Array.isArray(v)) {\n      const kept: string[] = []\n      for (const x of v) {\n        if (kept.length >= DIRECTION_ARRAY_CEILING) break\n        if (typeof x === \"string\" && x.length > 0 && x.length <= DIRECTION_ID_MAX_CHARS) {\n          kept.push(x)\n        }\n      }\n      if (kept.length > 0) out[spec.key] = kept\n    }\n  }\n  return Object.keys(out).length > 0 ? (out as DirectionFields) : undefined\n}\n\n// ── subject ──────────────────────────────────────────────────────────────────\n\n/**\n * Read a node's stored SUBJECT ids — the flat Person / Styling / prop bag the\n * `subject` channel carries. Same three contracts as `readDirectionFields`:\n * drop-never-throw, `undefined` never `{}`, and bounds shared with the wire\n * door by CONSTANT (`SUBJECT_ID_MAX_CHARS` / `SUBJECT_ARRAY_CEILING`, which are\n * defined AS the direction constants) so a body the route accepts and the same\n * node re-run from the canvas cannot disagree about which strings are ids.\n *\n * DERIVED from `getRegisteredSubjectKeys()`, never a hand-authored field list —\n * that is the whole lesson of `readStructuredFields` below, whose hand table is\n * only viable because `StructuredPromptFields` is a small hand-authored type.\n * The subject vocabulary is ~54 catalog-derived fields PLUS deployment-registered\n * pack dimensions unknown at compile time, so it is read from the registry at\n * call time. Iterating the KEY SET (never `Object.keys(value)`) is also what\n * keeps an adversarial blob's key count off the hot path.\n *\n * The SEMANTIC per-dimension cap stays the renderer's job\n * (`normalizeSubjectFields`), exactly as `maxPicks` does for direction: this\n * reader bounds cardinality only. `customAge` is the one number on the wire and\n * is passed through finite-only — the renderer clamps it.\n */\nexport function readSubjectFields(value: unknown): SubjectFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, string | string[] | number> = {}\n  for (const key of getRegisteredSubjectKeys()) {\n    const v = src[key]\n    if (key === SUBJECT_CUSTOM_AGE_KEY) {\n      if (typeof v === \"number\" && Number.isFinite(v)) out[key] = v\n      continue\n    }\n    if (typeof v === \"string\") {\n      if (v.length > 0 && v.length <= SUBJECT_ID_MAX_CHARS) out[key] = v\n    } else if (Array.isArray(v)) {\n      // Junk is filtered BEFORE the cap, so valid ids sitting behind malformed\n      // entries survive rather than being crowded out by them.\n      const kept: string[] = []\n      for (const x of v) {\n        if (kept.length >= SUBJECT_ARRAY_CEILING) break\n        if (typeof x === \"string\" && x.length > 0 && x.length <= SUBJECT_ID_MAX_CHARS) {\n          kept.push(x)\n        }\n      }\n      if (kept.length > 0) out[key] = kept\n    }\n  }\n  return Object.keys(out).length > 0 ? (out as SubjectFields) : undefined\n}\n\n// ── structured ───────────────────────────────────────────────────────────────\n\ntype FieldKind = \"string\" | \"number\" | \"gender\"\nconst GENDERS = [\"man\", \"woman\", \"child\", \"non-binary\"] as const\nconst MAX_STRUCTURED_VALUE_CHARS = 200\n\ntype Group = Exclude<keyof StructuredPromptFields, \"mood\">\ntype GroupFields<K extends Group> = Record<keyof NonNullable<StructuredPromptFields[K]>, FieldKind>\n\n/**\n * A FIELD-BY-FIELD table (not a registry walk) on purpose:\n * `StructuredPromptFields` is a small HAND-AUTHORED type, not catalog-derived,\n * and the table is what blocks `person: { age: \"drop table\" }` from rendering\n * verbatim into `jobs.input_data.prompt` — `renderStructuredFields` never\n * throws on junk, but it does render it. Totality is enforced by the\n * `GroupFields<K>` / `{ [K in Group]: … }` mapped types: a new field or group\n * on the published type fails to typecheck here.\n */\nconst PERSON_FIELDS: GroupFields<\"person\"> = {\n  age: \"number\",\n  gender: \"gender\",\n  hair: \"string\",\n  eyes: \"string\",\n  expression: \"string\",\n  profession: \"string\",\n  warriorType: \"string\",\n}\nconst STYLING_FIELDS: GroupFields<\"styling\"> = {\n  mood: \"string\",\n  lighting: \"string\",\n  aesthetic: \"string\",\n  colorLook: \"string\",\n}\nconst SETTING_FIELDS: GroupFields<\"setting\"> = {\n  era: \"string\",\n  atmosphere: \"string\",\n  backdrop: \"string\",\n}\nconst CAMERA_FIELDS: GroupFields<\"camera\"> = {\n  framing: \"string\",\n  motion: \"string\",\n  format: \"string\",\n}\nconst LENS_FIELDS: GroupFields<\"lens\"> = { focalLength: \"string\", aperture: \"string\" }\n\nconst STRUCTURED_GROUPS: { [K in Group]: GroupFields<K> } = {\n  person: PERSON_FIELDS,\n  styling: STYLING_FIELDS,\n  setting: SETTING_FIELDS,\n  camera: CAMERA_FIELDS,\n  lens: LENS_FIELDS,\n}\n\nfunction readField(v: unknown, kind: FieldKind): string | number | undefined {\n  if (kind === \"number\") return typeof v === \"number\" && Number.isFinite(v) ? v : undefined\n  if (typeof v !== \"string\" || v.length === 0 || v.length > MAX_STRUCTURED_VALUE_CHARS) {\n    return undefined\n  }\n  if (kind === \"gender\") return (GENDERS as readonly string[]).includes(v) ? v : undefined\n  return v\n}\n\n/** Read a node's stored Path-1 structured prompt fields. Same drop-never-throw\n *  and `undefined`-never-`{}` contract as `readDirectionFields`. */\nexport function readStructuredFields(value: unknown): StructuredPromptFields | undefined {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined\n  const src = value as Record<string, unknown>\n  const out: Record<string, unknown> = {}\n  for (const group of Object.keys(STRUCTURED_GROUPS) as Group[]) {\n    const raw = src[group]\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) continue\n    const rawRec = raw as Record<string, unknown>\n    const kept: Record<string, unknown> = {}\n    for (const [field, kind] of Object.entries(\n      STRUCTURED_GROUPS[group] as Record<string, FieldKind>,\n    )) {\n      const v = readField(rawRec[field], kind)\n      if (v !== undefined) kept[field] = v\n    }\n    if (Object.keys(kept).length > 0) out[group] = kept\n  }\n  const mood = readField(src.mood, \"string\")\n  if (mood !== undefined) out.mood = mood\n  return Object.keys(out).length > 0 ? (out as StructuredPromptFields) : undefined\n}\n"]}

package/dist/{chunk-NO6XHX4R.js → chunk-6MPZHFIS.js}

@@ -1,5 +1,7 @@
+import { getPromptFields, NODE_PROMPT_CANDIDATE_FIELDS, promptAffixCoreField, nodeSupportsPromptAffixes } from './chunk-7XMTVYS5.js';
+import { IMAGE_TOKEN_PATTERN } from './chunk-GILUVQQJ.js';
 import { realismEmptyHands, NEUTRAL_PERSON, realismViewpoint, REFERENCE_RULES, SCENE_FRAME_RULE, CINEMATIC_LOOK_TAIL, FILM_STILL_PREFIX, REALISM_PASS_INSTRUCTION, REALISM_FINISH, REALISM_SKIN } from './chunk-T64D26P4.js';
-import { T2I_TO_I2I_VARIANT } from '@nodaro/shared/models';
+import { MODELS_WITH_REFERENCE_IMAGE_SUPPORT, imageReferenceLimit, T2I_TO_I2I_VARIANT } from '@nodaro/shared/models';
 
 // src/brand-tokens.ts
 var BRAND_PRESET_IDS = [
@@ -135,7 +137,9 @@ function stylizedSubjectFor(nodeType) {
     name: p.name,
     description: p.description,
     group: "Stylized Subject",
-    data: { provider: editProviderFor(nodeType), ...p.data }
+    data: { provider: editProviderFor(nodeType), ...p.data },
+    // Restyles the person in the connected photo ("the reference image").
+    minReferences: 1
   }));
 }
 var IMAGE_EDITS = [
@@ -259,7 +263,9 @@ function editsFor(nodeType) {
     name: p.name,
     description: p.description,
     group: "Edits",
-    data: { provider: editProviderFor(nodeType), ...p.data }
+    data: { provider: editProviderFor(nodeType), ...p.data },
+    // Every edit operates on the connected photo.
+    minReferences: 1
   }));
 }
 
@@ -268,12 +274,17 @@ var sentences = (...parts) => parts.join(" ");
 var REALISM_MODEL = { provider: "gpt-image-2", resolution: "2K" };
 var SKIN_STUDY_MODEL = { provider: "seedream-5-pro", quality: "high" };
 var GENERATE_IMAGE_PRESETS = [
+  // `minReferences` marks a preset that works from connected photos its prompt
+  // describes in words ("the attached photo"); `{image:N}` tokens count on their
+  // own, so a tokenized preset declares nothing. The groups stay all-or-nothing
+  // (factory-preset-references.test.ts), so a new preset copies the line along.
   // ── Reference Sheet ──────────────────────────────────────────────────────
   {
     id: "generate-image/character-board",
     name: "Character Board",
     description: "Connect a sharp, well-lit photo \u2192 dense character sheet; reuse it as a reference for consistent shots.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -288,6 +299,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Pose Board",
     description: "Connect a sharp photo \u2192 animation-ready pose & expression sheet; reuse it as a reference for consistent action.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -302,6 +314,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Location Board",
     description: "Connect a photo \u2192 dense location sheet; reuse it as a reference for consistent scenes.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -316,6 +329,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Product Board",
     description: "Connect a photo \u2192 dense product sheet; reuse it as a reference for consistent shots.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -330,6 +344,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Outfit Board",
     description: "Connect a photo \u2192 dense wardrobe sheet; reuse it as a reference for consistent looks.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -344,6 +359,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Scene Board",
     description: "Connect a photo \u2192 set-dressing & props study; reuse it as a reference for consistent sets.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -358,6 +374,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Creature Board",
     description: "Connect a sharp photo \u2192 dense creature sheet; reuse it as a reference for consistent shots.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -372,6 +389,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Vehicle Board",
     description: "Connect a photo \u2192 dense vehicle sheet; reuse it as a reference for consistent shots.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -386,6 +404,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Food Board",
     description: "Connect a photo \u2192 dense dish sheet; reuse it as a reference for consistent food shots.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -400,6 +419,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Mascot Board",
     description: "Connect a mascot image \u2192 brand-character sheet with brand applications; reuse it for a consistent mascot.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -414,6 +434,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Pet Board",
     description: "Connect a sharp photo \u2192 dense pet sheet; reuse it as a reference for consistent shots.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -428,6 +449,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Skin Detail Sheet",
     description: "Connect a sharp face photo \u2192 a six-panel skin reference.",
     group: "Reference Sheet",
+    minReferences: 1,
     data: {
       ...SKIN_STUDY_MODEL,
       aspectRatio: "3:2",
@@ -450,6 +472,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Character Reference Grid",
     description: "Connect a photo \u2192 clean 4-angle identity grid (no decorations) \u2014 the strongest consistency anchor.",
     group: "Cast & Consistency",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -464,6 +487,8 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Cast Mega Grid",
     description: "Connect 2\u20134 character refs \u2192 one labeled cast sheet; then reference cast members by name in scenes.",
     group: "Cast & Consistency",
+    // A cast sheet is two characters or more ("Connect 2–4 character refs").
+    minReferences: 2,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -477,6 +502,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Cast Scene (by name)",
     description: "Connect a cast grid \u2192 stage a scene naming the characters; never re-describe their looks.",
     group: "Cast & Consistency",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "16:9",
@@ -491,6 +517,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Label Elements",
     description: "Step 1 \xB7 connect a photo \u2192 the same image with a numbered label on each changeable element.",
     group: "Edit by Name",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       quality: "high",
@@ -503,6 +530,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Apply Named Edit",
     description: 'Step 2 \xB7 connect the labeled sheet \u2192 type your change in the prompt (e.g. change "drink 1" to blue); the labels are removed from the result.',
     group: "Edit by Name",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       quality: "high",
@@ -1711,6 +1739,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Five Ages (Timeless Soul)",
     description: "One person at 5 ages, studio line-up. Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -1723,6 +1752,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Three-Age Triptych",
     description: "Same person at 3 ages (~10 / 40 / 75). Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -1735,6 +1765,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Five Ages \u2014 B&W",
     description: "Monochrome age line-up. Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -1747,6 +1778,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Decade Timeline",
     description: "Same person across the '80s\u20132020s. Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -1759,6 +1791,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Four Seasons",
     description: "Same person in spring / summer / autumn / winter. Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -1771,6 +1804,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Times of Day",
     description: "Same person at dawn / midday / golden hour / night. Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "gpt-image-2",
       aspectRatio: "3:4",
@@ -1783,6 +1817,7 @@ var GENERATE_IMAGE_PRESETS = [
     name: "Sports Jersey Portrait",
     description: "You in an oversized team jersey, studio editorial. Needs a reference photo.",
     group: "Portrait Transformations",
+    minReferences: 1,
     data: {
       provider: "nano-banana-2-1",
       aspectRatio: "4:5",
@@ -5114,6 +5149,64 @@ function groupFactoryPresets(presets) {
   }
   return buckets;
 }
+var MAX_PRESET_REFERENCES = Math.max(
+  1,
+  ...[...MODELS_WITH_REFERENCE_IMAGE_SUPPORT].map((provider) => imageReferenceLimit(provider))
+);
+function promptFieldsOf(nodeType) {
+  const spec = getPromptFields(nodeType);
+  const candidates = NODE_PROMPT_CANDIDATE_FIELDS[nodeType] ?? [];
+  if (!spec && candidates.length === 0) return [];
+  const fields = new Set(candidates);
+  if (spec) {
+    fields.add(spec.prompt);
+    if (spec.negative) fields.add(spec.negative);
+  }
+  const core = promptAffixCoreField(nodeType);
+  if (core) fields.add(core);
+  if (nodeSupportsPromptAffixes(nodeType)) {
+    fields.add("promptPrefix");
+    fields.add("promptSuffix");
+  }
+  return [...fields];
+}
+function highestImageToken(text) {
+  let highest = 0;
+  for (const match of text.matchAll(IMAGE_TOKEN_PATTERN)) {
+    const n = Number.parseInt(match[1] ?? "", 10);
+    if (Number.isInteger(n) && n > highest) highest = n;
+  }
+  return highest;
+}
+function presetMinReferences(nodeType, data, declared) {
+  let count = typeof declared === "number" && Number.isInteger(declared) && declared > 0 ? declared : 0;
+  for (const field of promptFieldsOf(nodeType)) {
+    const value = data[field];
+    if (typeof value === "string") count = Math.max(count, highestImageToken(value));
+  }
+  return Math.min(count, MAX_PRESET_REFERENCES);
+}
+
+// src/factory-presets/preview-files.generated.ts
+var FACTORY_PRESET_PREVIEW_FILES = {};
+
+// src/factory-presets/previews.ts
+var PRESET_PREVIEW_PATH = "/preset-previews/";
+function originOf(baseUrl) {
+  try {
+    const url = new URL(baseUrl);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
+    return url.origin + url.pathname.replace(/\/+$/, "");
+  } catch {
+    return void 0;
+  }
+}
+function factoryPresetPreviewUrl(presetId, baseUrl, files = FACTORY_PRESET_PREVIEW_FILES) {
+  const file = Object.prototype.hasOwnProperty.call(files, presetId) ? files[presetId] : void 0;
+  if (!file) return null;
+  const origin = originOf(baseUrl);
+  return origin ? `${origin}${PRESET_PREVIEW_PATH}${file}` : null;
+}
 
 // src/factory-presets/index.ts
 function forModifyImage(p) {
@@ -5523,6 +5616,6 @@ function getFactorySnippets(target, media) {
   );
 }
 
-export { BODY_CAPTIONS_PRESET_ID, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, CAPTION_LEVERS_BY_LANGUAGE, CAPTION_SEGMENT_LEVER_KEYS, FACTORY_PRESETS, FACTORY_SNIPPETS, HOOK_PLATE_PRESET_ID, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, SNIPPET_MEDIA_VALUES, STYLE_PRESETS, getFactoryPresets, getFactorySnippets, getStylePreset, groupFactoryPresets, hookPlateCaptionSegments, resolveBrandInput };
-//# sourceMappingURL=chunk-NO6XHX4R.js.map
-//# sourceMappingURL=chunk-NO6XHX4R.js.map
+export { BODY_CAPTIONS_PRESET_ID, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, CAPTION_LEVERS_BY_LANGUAGE, CAPTION_SEGMENT_LEVER_KEYS, FACTORY_PRESETS, FACTORY_PRESET_PREVIEW_FILES, FACTORY_SNIPPETS, HOOK_PLATE_PRESET_ID, MAX_PRESET_REFERENCES, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, PRESET_PREVIEW_PATH, SNIPPET_MEDIA_VALUES, STYLE_PRESETS, factoryPresetPreviewUrl, getFactoryPresets, getFactorySnippets, getStylePreset, groupFactoryPresets, hookPlateCaptionSegments, presetMinReferences, resolveBrandInput };
+//# sourceMappingURL=chunk-6MPZHFIS.js.map
+//# sourceMappingURL=chunk-6MPZHFIS.js.map