@nodaro/shared 1.5.0 → 1.6.0

package/dist/index.cjs

@@ -4,8 +4,11 @@ var zod = require('zod');
 
 // src/types.ts
 var DEFAULT_LABEL_BY_SOURCE = {
-  "manual": "object",
-  "wired-image": "object",
+  // Media references default to "ref-only" — the empty label, i.e. a bare
+  // {image:N} token that injects only "reference image A" (image) / "@image_N"
+  // (video) with no descriptive role phrase. Pick a role on the pill to change.
+  "manual": "",
+  "wired-image": "",
   "wired-character": "person",
   "wired-face": "face",
   "wired-object": "object",
@@ -8565,8 +8568,11 @@ function parseCharacterMentionToken(text, _knownCharacterSlugs) {
   }
   if (parts.length === 4) {
     if (!/^[a-z][a-z0-9-]*$/.test(third)) return null;
-    if (!isUsageMode(fourth)) return null;
-    return { characterSlug, imageIndex, variantSlug: third, usageMode: fourth, ...lockField };
+    if (!/^[a-z][a-z0-9-]*$/.test(fourth)) return null;
+    if (isUsageMode(fourth)) {
+      return { characterSlug, imageIndex, variantSlug: third, usageMode: fourth, ...lockField };
+    }
+    return { characterSlug, imageIndex, variantSlug: third, usageMode: null, role: fourth, ...lockField };
   }
   return null;
 }
@@ -8641,6 +8647,35 @@ function characterMentionableAssetArrays(data) {
     boards: characterBoardItems(data)
   };
 }
+var CHARACTER_PICKER_DISPLAY_ORDER = [
+  "boards",
+  "sheets",
+  ...CHARACTER_VARIANT_ASSET_BUCKETS
+];
+function characterBucketDisplayRank(bucket) {
+  if (bucket === void 0) return -1;
+  const i = CHARACTER_PICKER_DISPLAY_ORDER.indexOf(bucket);
+  return i === -1 ? CHARACTER_PICKER_DISPLAY_ORDER.length : i;
+}
+function sortCharacterEntriesForDisplay(items) {
+  const out = [];
+  let i = 0;
+  while (i < items.length) {
+    const slug = items[i].characterSlug;
+    if (!slug) {
+      out.push(items[i]);
+      i++;
+      continue;
+    }
+    let j = i;
+    while (j < items.length && items[j].characterSlug === slug) j++;
+    const run = items.slice(i, j);
+    const ranked = run.map((it, k) => ({ it, k, r: characterBucketDisplayRank(it.bucket) })).sort((a, b) => a.r - b.r || a.k - b.k).map((x) => x.it);
+    out.push(...ranked);
+    i = j;
+  }
+  return out;
+}
 
 // src/location-mention-slug.ts
 var LOCATION_USAGE_MODES = [
@@ -8734,8 +8769,11 @@ function parseLocationMentionToken(text) {
     const variant = third.slice(slashAt + 1);
     if (!/^[a-z][a-z0-9-]*$/.test(bucket)) return null;
     if (!/^[a-z][a-z0-9-]*$/.test(variant)) return null;
-    if (!isLocationUsageMode(fourth)) return null;
-    return { locationSlug, imageIndex, bucket, variant, usageMode: fourth, ...lockField };
+    if (!/^[a-z][a-z0-9-]*$/.test(fourth)) return null;
+    if (isLocationUsageMode(fourth)) {
+      return { locationSlug, imageIndex, bucket, variant, usageMode: fourth, ...lockField };
+    }
+    return { locationSlug, imageIndex, bucket, variant, usageMode: null, role: fourth, ...lockField };
   }
   return null;
 }
@@ -9059,7 +9097,7 @@ var ShotSpecSchema = zod.z.object({
   // v4.1 Method 10 — parametric 3D camera path
   camera_path_directive: zod.z.object({
     path_kind: zod.z.enum(["orbit", "dolly", "crane", "arc", "reveal"]),
-    parameters: zod.z.record(zod.z.unknown()).optional()
+    parameters: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
   }).optional(),
   // ─── Execution state (engine writes; null on planning) ─────────────────────
   // Phase 1C.1: per-shot execution state lands directly on the shot record so
@@ -9804,7 +9842,7 @@ var StageAwaitingSubGateEventSchema = zod.z.object({
   pipelineId: zod.z.string().uuid(),
   stageName: zod.z.enum(["animate_audio_edit", "scene_images"]),
   subGate: SubGateNameSchema,
-  payload: zod.z.record(zod.z.unknown()).optional()
+  payload: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 });
 var PipelineMusicReadyEventSchema = zod.z.object({
   type: zod.z.literal("pipeline:music_ready"),
@@ -11060,7 +11098,10 @@ var CHARACTER_ATTACH_COLUMNS = [
   // locations don't have an outfit dimension).
   "sheets",
   "detail_closeups",
-  "outfit_variations"
+  "outfit_variations",
+  // Named composite reference boards (migration 250) — identity-collage
+  // sheets auto-attached by the ffmpeg image-collage worker.
+  "boards"
 ];
 var CHARACTER_ASSET_VARIANTS = {
   expressions: [
@@ -11658,12 +11699,15 @@ function resolveEffectiveSourceType(rawSourceType, sourceHandleId) {
   }
   return rawSourceType ?? "";
 }
+function sourceRefKey(nodeId, sourceHandleId, rawSourceType) {
+  return sourceHandleId === "image" && ENTITY_IMAGE_HANDLE_TYPES.has(rawSourceType ?? "") ? `${nodeId}::image` : nodeId;
+}
 
 // src/reference-roles.ts
 var REFERENCE_ROLE_PRESETS = {
-  "wired-character": ["person", "face", "clothes", "hair", "pose", "expression", "style"],
+  "wired-character": ["ref-only", "person", "face", "clothes", "hair", "pose", "expression", "style"],
   "wired-face": ["face", "person", "expression", "style"],
-  "wired-location": ["background", "atmosphere", "as-is", "empty background", "layout", "lighting", "style"],
+  "wired-location": ["ref-only", "background", "atmosphere", "as-is", "empty background", "layout", "lighting", "style"],
   "wired-object": ["object", "shape", "material", "color", "texture", "style"],
   "wired-creature": ["creature", "anatomy", "markings", "pose", "color", "style"],
   "wired-image": ["object", "person", "face", "clothes", "background", "style", "pose", "texture"],
@@ -11676,6 +11720,8 @@ function roleToPhrase(role, binding) {
   const r = role.trim();
   if (!r) return binding;
   switch (r) {
+    case "ref-only":
+      return binding;
     case "as-is":
       return `${binding}, used as-is`;
     case "empty background":
@@ -11872,6 +11918,7 @@ exports.CHARACTER_FACETS = CHARACTER_FACETS;
 exports.CHARACTER_FACET_IDS = CHARACTER_FACET_IDS;
 exports.CHARACTER_LORA_TRAINING_JOB_TYPE = CHARACTER_LORA_TRAINING_JOB_TYPE;
 exports.CHARACTER_MOTION_PROVIDERS = CHARACTER_MOTION_PROVIDERS;
+exports.CHARACTER_PICKER_DISPLAY_ORDER = CHARACTER_PICKER_DISPLAY_ORDER;
 exports.CHARACTER_REFERENCE_PHOTO_KINDS = CHARACTER_REFERENCE_PHOTO_KINDS;
 exports.CHARACTER_STYLES = CHARACTER_STYLES;
 exports.CHARACTER_VARIANT_ASSET_BUCKETS = CHARACTER_VARIANT_ASSET_BUCKETS;
@@ -12255,6 +12302,7 @@ exports.calculateMonetizedCost = calculateMonetizedCost;
 exports.calculateProgress = calculateProgress;
 exports.canonicalVarName = canonicalVarName;
 exports.characterBoardItems = characterBoardItems;
+exports.characterBucketDisplayRank = characterBucketDisplayRank;
 exports.characterMentionSlug = characterMentionSlug;
 exports.characterMentionableAssetArrays = characterMentionableAssetArrays;
 exports.characterSheetRefItems = characterSheetRefItems;
@@ -12468,7 +12516,9 @@ exports.selectListItems = selectListItems;
 exports.selectLoraRoutingForMentions = selectLoraRoutingForMentions;
 exports.selectRandom = selectRandom;
 exports.settledWithLimit = settledWithLimit;
+exports.sortCharacterEntriesForDisplay = sortCharacterEntriesForDisplay;
 exports.sortListItems = sortListItems;
+exports.sourceRefKey = sourceRefKey;
 exports.spliceDelimitedRows = spliceDelimitedRows;
 exports.splitByLoopDelimiter = splitByLoopDelimiter;
 exports.splitGeneratedItems = splitGeneratedItems;