@nodaro/shared 3.10.0 → 3.11.0

package/dist/index.cjs

@@ -8243,7 +8243,9 @@ var VIDEO_ONLY_PARAMETER_NODE_TYPES = /* @__PURE__ */ new Set([
 ]);
 var EXECUTION_GRAPH_COMPOSED_PARAMETER_TYPES = /* @__PURE__ */ new Set([
   "camera-motion",
-  "character-motion"
+  "character-motion",
+  "transition",
+  "character-fx"
 ]);
 var registeredPersonPackFields = [];
 function setRegisteredPersonPackFields(fields) {
@@ -14689,7 +14691,21 @@ var entitySlotSchema = zod.z.object({
    */
   refRejectedReason: zod.z.string().optional(),
   /** NON-default looks only; present only when at least one exists. */
-  variations: zod.z.array(slotVariationSchema).max(VIDEO_ANALYSIS_MAX_VARIATIONS).optional()
+  variations: zod.z.array(slotVariationSchema).max(VIDEO_ANALYSIS_MAX_VARIATIONS).optional(),
+  /**
+   * WHOSE THIS OBJECT IS (2026-09-17). An object slot that is worn, held,
+   * carried, driven or ridden by a cast person or creature names that slot
+   * here, with the relation as a short passive phrase ending in "by" ("worn
+   * by", "held by", "driven by"). The link says the object slot IS the one on
+   * that person — not a second one: a recast that saw "Man in Blue Silk
+   * Shirt" AND "Blue Silk Shirt" as unrelated slots rendered two shirts.
+   * Object slots only; a free-standing prop, the product on a table, a place
+   * or a person never carries it. Optional/additive: producers may omit it.
+   */
+  owner: zod.z.object({
+    slotId: zod.z.string().min(1).regex(/^[a-z0-9-]+$/),
+    relation: zod.z.string().min(1)
+  }).optional()
 });
 var VIDEO_ANALYSIS_AUDIO_MODES = ["speech", "music", "sfx", "ambience"];
 var audioLayerSchema = zod.z.object({
@@ -17495,6 +17511,168 @@ function unavailable(engine) {
 }
 var SCENE3D_BASIC_SCHEMA_VERSION = SCENE3D_SCHEMA_VERSION;
 
+// src/video-output-canvas.ts
+var VIDEO_OUTPUT_CANVAS = {
+  "seedance-2-5": {
+    "480p": { "16:9": [854, 480], "9:16": [480, 854] },
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280], "1:1": [960, 960] },
+    "1080p": { "16:9": [1920, 1080] }
+  },
+  // The 2.0 family is NOT the same as 2.5 at 480p — 864x496 vs 854x480.
+  "seedance-2": {
+    "480p": { "16:9": [864, 496], "9:16": [496, 864] },
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280] }
+  },
+  "seedance-2-fast": {
+    "480p": { "16:9": [864, 496], "9:16": [496, 864] },
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280] }
+  },
+  "seedance-2-mini": {
+    "480p": { "16:9": [864, 496], "9:16": [496, 864] },
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280] }
+  },
+  "gemini-omni-video": {
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280] },
+    "1080p": { "16:9": [1920, 1080] }
+  },
+  "gemini-omni-flash": {
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280] }
+  },
+  "veo3.1": {
+    "720p": { "9:16": [720, 1280] },
+    "1080p": { "16:9": [1920, 1080] }
+  },
+  "wan-3": {
+    "480p": { "16:9": [832, 480] },
+    "720p": { "16:9": [1280, 720], "9:16": [720, 1280] }
+  },
+  "wan-3-prime": {
+    "720p": { "16:9": [1280, 720] }
+  },
+  // 768P's "9:16" is 0.5714, not 0.5625 — the single clearest reason this table
+  // exists.
+  "minimax-h3": {
+    "768p": { "9:16": [768, 1344] },
+    "2k": { "16:9": [2560, 1440], "9:16": [1440, 2560] }
+  },
+  seedance: {
+    "1080p": {
+      "16:9": [1920, 1080],
+      "9:16": [1080, 1920],
+      "1:1": [1440, 1440],
+      "3:4": [1248, 1664]
+    }
+  }
+};
+function resolveOutputCanvas(provider, resolution, aspect) {
+  if (!provider || !resolution || !aspect) return void 0;
+  return VIDEO_OUTPUT_CANVAS[provider]?.[resolution.toLowerCase()]?.[aspect];
+}
+function measuredCanvasCombinations() {
+  const out = [];
+  for (const [provider, byResolution] of Object.entries(VIDEO_OUTPUT_CANVAS)) {
+    for (const [resolution, byAspect] of Object.entries(byResolution)) {
+      for (const [aspect, canvas] of Object.entries(byAspect)) {
+        out.push({ provider, resolution, aspect, canvas });
+      }
+    }
+  }
+  return out;
+}
+
+// src/video-frame-fit.ts
+var FRAME_FITS = ["original", "ratio", "resolution"];
+var DEFAULT_FRAME_FIT = "resolution";
+var FRAME_DELIVERIES = ["auto", "frame", "reference"];
+var DEFAULT_FRAME_DELIVERY = "auto";
+var FRAME_FIT_STRETCH_TOLERANCE = 0.05;
+var FRAME_DELIVERY_BY_PROVIDER = {
+  "seedance-2": "reference",
+  "seedance-2-fast": "reference",
+  "seedance-2-mini": "reference"
+};
+var OPEN_ASPECT_TOKENS = /* @__PURE__ */ new Set(["adaptive", "auto"]);
+function parseAspectToken(token) {
+  if (!token) return void 0;
+  const m = /^(\d+(?:\.\d+)?)\s*[:x/]\s*(\d+(?:\.\d+)?)$/.exec(token.trim());
+  if (!m) return void 0;
+  const w = Number(m[1]);
+  const h = Number(m[2]);
+  if (!(w > 0) || !(h > 0)) return void 0;
+  return w / h;
+}
+function resolveFrameFitAspect(args) {
+  const requested = args.requestedAspect?.trim();
+  if (requested && !OPEN_ASPECT_TOKENS.has(requested.toLowerCase())) return requested;
+  const ratios = args.provider ? getModel(args.provider)?.aspectRatios : void 0;
+  if (!ratios?.length || !(args.sourceWidth > 0) || !(args.sourceHeight > 0)) return void 0;
+  const source = args.sourceWidth / args.sourceHeight;
+  let best;
+  for (const token of ratios) {
+    const value = parseAspectToken(token);
+    if (value === void 0) continue;
+    const gap = Math.abs(Math.log(value / source));
+    if (!best || gap < best.gap) best = { token, gap };
+  }
+  return best?.token;
+}
+function even(value) {
+  return Math.max(2, Math.round(value / 2) * 2);
+}
+function minimalRatioDimensions(width, height, aspect) {
+  const current = width / height;
+  if (current > aspect) {
+    return { width: even(width), height: even(width / aspect) };
+  }
+  return { width: even(height * aspect), height: even(height) };
+}
+function centreCropToAspect(width, height, aspect) {
+  const current = width / height;
+  if (current > aspect) {
+    const w = even(height * aspect);
+    return { left: Math.max(0, Math.round((width - w) / 2)), top: 0, width: Math.min(width, w), height };
+  }
+  const h = even(width / aspect);
+  return { left: 0, top: Math.max(0, Math.round((height - h) / 2)), width, height: Math.min(height, h) };
+}
+function computeFrameFitPlan(args) {
+  const { fit, sourceWidth, sourceHeight } = args;
+  if (fit === "original") return null;
+  if (!(sourceWidth > 0) || !(sourceHeight > 0)) return null;
+  const aspectToken = resolveFrameFitAspect({
+    provider: args.provider,
+    requestedAspect: args.aspect,
+    sourceWidth,
+    sourceHeight
+  });
+  const canvas = fit === "resolution" ? args.canvas ?? resolveOutputCanvas(args.provider, args.resolution, aspectToken) : void 0;
+  const targetAspect = canvas ? canvas[0] / canvas[1] : parseAspectToken(aspectToken);
+  if (targetAspect === void 0 || !(targetAspect > 0)) return null;
+  const sourceAspect = sourceWidth / sourceHeight;
+  const gap = Math.abs(sourceAspect - targetAspect) / targetAspect;
+  const tolerance = args.tolerance ?? FRAME_FIT_STRETCH_TOLERANCE;
+  const crop = gap > tolerance ? centreCropToAspect(sourceWidth, sourceHeight, targetAspect) : void 0;
+  const target = canvas ? { width: canvas[0], height: canvas[1] } : minimalRatioDimensions(
+    crop ? crop.width : sourceWidth,
+    crop ? crop.height : sourceHeight,
+    targetAspect
+  );
+  const unchanged = target.width === sourceWidth && target.height === sourceHeight && !crop;
+  if (unchanged) return null;
+  return {
+    width: target.width,
+    height: target.height,
+    ...crop ? { crop } : {},
+    reason: canvas ? "resolution" : "ratio"
+  };
+}
+function resolveFrameDelivery(args) {
+  const requested = args.requested ?? DEFAULT_FRAME_DELIVERY;
+  const wanted = requested === "auto" ? args.provider ? FRAME_DELIVERY_BY_PROVIDER[args.provider] ?? "frame" : "frame" : requested;
+  if (wanted === "reference" && !args.supportsReferenceImages) return "frame";
+  return wanted;
+}
+
 exports.ACCESS_LEVELS = ACCESS_LEVELS;
 exports.ACTIVE_SCENE_HELPERS = ACTIVE_SCENE_HELPERS;
 exports.ADVANCED_MODE_UNAVAILABLE_REASON = ADVANCED_MODE_UNAVAILABLE_REASON;
@@ -17582,6 +17760,8 @@ exports.DEFAULT_CARRIED_FRACTION = DEFAULT_CARRIED_FRACTION;
 exports.DEFAULT_CHARACTER_ANGLE_COUNT = DEFAULT_CHARACTER_ANGLE_COUNT;
 exports.DEFAULT_CHARACTER_EXPRESSION_COUNT = DEFAULT_CHARACTER_EXPRESSION_COUNT;
 exports.DEFAULT_CHARACTER_FACET = DEFAULT_CHARACTER_FACET;
+exports.DEFAULT_FRAME_DELIVERY = DEFAULT_FRAME_DELIVERY;
+exports.DEFAULT_FRAME_FIT = DEFAULT_FRAME_FIT;
 exports.DEFAULT_LABEL_BY_SOURCE = DEFAULT_LABEL_BY_SOURCE;
 exports.DEFAULT_LOCATION_USAGE_MODE = DEFAULT_LOCATION_USAGE_MODE;
 exports.DEFAULT_OVERLAY_QR = DEFAULT_OVERLAY_QR;
@@ -17634,6 +17814,10 @@ exports.FILM_BASE_CREDITS = FILM_BASE_CREDITS;
 exports.FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS = FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS;
 exports.FLUX2_RES_MP = FLUX2_RES_MP;
 exports.FLUX_LORA_CHARACTER_MODEL_ID = FLUX_LORA_CHARACTER_MODEL_ID;
+exports.FRAME_DELIVERIES = FRAME_DELIVERIES;
+exports.FRAME_DELIVERY_BY_PROVIDER = FRAME_DELIVERY_BY_PROVIDER;
+exports.FRAME_FITS = FRAME_FITS;
+exports.FRAME_FIT_STRETCH_TOLERANCE = FRAME_FIT_STRETCH_TOLERANCE;
 exports.FRAME_MODE_ADAPTIVE_ONLY_ASPECT = FRAME_MODE_ADAPTIVE_ONLY_ASPECT;
 exports.FRAME_TARGET_HANDLES = FRAME_TARGET_HANDLES;
 exports.FREECUT_EXPORT_COMPLETE = FREECUT_EXPORT_COMPLETE;
@@ -18043,6 +18227,7 @@ exports.VIDEO_INPUT_LIP_SYNC_PROVIDERS = VIDEO_INPUT_LIP_SYNC_PROVIDERS;
 exports.VIDEO_MODEL_CAPS = VIDEO_MODEL_CAPS;
 exports.VIDEO_MODE_ALIASES = VIDEO_MODE_ALIASES;
 exports.VIDEO_ONLY_PARAMETER_NODE_TYPES = VIDEO_ONLY_PARAMETER_NODE_TYPES;
+exports.VIDEO_OUTPUT_CANVAS = VIDEO_OUTPUT_CANVAS;
 exports.VIDEO_PRODUCER_TYPES = VIDEO_PRODUCER_TYPES;
 exports.VIDEO_PROMPT_MAX = VIDEO_PROMPT_MAX;
 exports.VIDEO_PROVIDERS_REQUIRING_IMAGE = VIDEO_PROVIDERS_REQUIRING_IMAGE;
@@ -18116,6 +18301,7 @@ exports.calculateMonetizedCost = calculateMonetizedCost;
 exports.calculateProgress = calculateProgress;
 exports.canonicalScene3DPlanV2Json = canonicalScene3DPlanV2Json;
 exports.canonicalVarName = canonicalVarName;
+exports.centreCropToAspect = centreCropToAspect;
 exports.characterBoardItems = characterBoardItems;
 exports.characterBucketDisplayRank = characterBucketDisplayRank;
 exports.characterMentionSlug = characterMentionSlug;
@@ -18134,6 +18320,7 @@ exports.clipLookSchema = clipLookSchema;
 exports.collectAncestorRefs = collectAncestorRefs;
 exports.combineSameLabelRefs = combineSameLabelRefs;
 exports.computeAggregateLanes = computeAggregateLanes;
+exports.computeFrameFitPlan = computeFrameFitPlan;
 exports.computeScene3DPlanV2ContentHash = computeScene3DPlanV2ContentHash;
 exports.countRefModalityEdges = countRefModalityEdges;
 exports.creditRangesAll = creditRangesAll;
@@ -18304,11 +18491,13 @@ exports.mapShotIntentToProviderDirectives = mapShotIntentToProviderDirectives;
 exports.matchVariant = matchVariant;
 exports.maxSegmentSecFor = maxSegmentSecFor;
 exports.maxSegmentsFor = maxSegmentsFor;
+exports.measuredCanvasCombinations = measuredCanvasCombinations;
 exports.mergeClipLook = mergeClipLook;
 exports.mergeExposedSettings = mergeExposedSettings;
 exports.migrateEdgeOutputMode = migrateEdgeOutputMode;
 exports.migrateToItems = migrateToItems;
 exports.minSegmentSecFor = minSegmentSecFor;
+exports.minimalRatioDimensions = minimalRatioDimensions;
 exports.modelIdsByKindMode = modelIdsByKindMode;
 exports.modelToNodeTarget = modelToNodeTarget;
 exports.modelsForInputMode = modelsForInputMode;
@@ -18336,6 +18525,7 @@ exports.overlayStrokeSchema = overlayStrokeSchema;
 exports.overlayTextStyleSchema = overlayTextStyleSchema;
 exports.overlayVariantHandle = overlayVariantHandle;
 exports.overlayVariantIdFromHandle = overlayVariantIdFromHandle;
+exports.parseAspectToken = parseAspectToken;
 exports.parseAttributedDialogue = parseAttributedDialogue;
 exports.parseCharacterMentionToken = parseCharacterMentionToken;
 exports.parseEntityMentionToken = parseEntityMentionToken;
@@ -18395,6 +18585,8 @@ exports.resolveEffectiveSourceType = resolveEffectiveSourceType;
 exports.resolveEffectiveTier = resolveEffectiveTier;
 exports.resolveEntityAspect = resolveEntityAspect;
 exports.resolveFieldMappings = resolveFieldMappings;
+exports.resolveFrameDelivery = resolveFrameDelivery;
+exports.resolveFrameFitAspect = resolveFrameFitAspect;
 exports.resolveGvpAnchorWire = resolveGvpAnchorWire;
 exports.resolveImageGenCreditIdentifier = resolveImageGenCreditIdentifier;
 exports.resolveIndex = resolveIndex;
@@ -18407,6 +18599,7 @@ exports.resolveLottieOverlaySrc = resolveLottieOverlaySrc;
 exports.resolveNodeRefs = resolveNodeRefs;
 exports.resolveNormalizedImageGen = resolveNormalizedImageGen;
 exports.resolveObjectAspectRatio = resolveObjectAspectRatio;
+exports.resolveOutputCanvas = resolveOutputCanvas;
 exports.resolvePipelineModel = resolvePipelineModel;
 exports.resolveRelativeWindowToken = resolveRelativeWindowToken;
 exports.resolveScene3DAuthoringEngine = resolveScene3DAuthoringEngine;