@nodaro/shared 3.0.0 → 3.1.0

package/dist/index.cjs

@@ -3372,7 +3372,13 @@ var ASPECT_RATIO_DIMENSIONS = {
   "16:9": { width: 1920, height: 1080 },
   "9:16": { width: 1080, height: 1920 },
   "1:1": { width: 1080, height: 1080 },
-  "4:5": { width: 1080, height: 1350 }
+  "4:5": { width: 1080, height: 1350 },
+  // Ultra-wide. 1680x720 rather than a 1920-wide pair because the Scene3D v2
+  // admission bounds require even integers on both axes and 1920/(21/9) is
+  // odd; 1680x720 is the pair the scene contract names as supported. Additive:
+  // every consumer here is a keyed lookup with a fallback, and a node only
+  // reaches this entry if its own aspect enum offers 21:9 (today, Pro 3D).
+  "21:9": { width: 1680, height: 720 }
 };
 var MOTION_TRANSFER_PROVIDERS = [
   "kling",
@@ -4138,7 +4144,11 @@ var COMPOSER_PLAN_MAP = {
   // validated `Scene3DPlan` revision on their `composition` handle, so
   // render-video routes either one to the `3d-scene` renderer unchanged.
   "generate-3d-scene": { planType: "3d-scene", planField: "scenePlan" },
-  "edit-3d-scene": { planType: "3d-scene", planField: "scenePlan" }
+  "edit-3d-scene": { planType: "3d-scene", planField: "scenePlan" },
+  // 3D Render Pro authors the SAME `scenePlan` revision (v2) alongside its
+  // MP4, so the render-only re-run reads it through this map exactly as it
+  // reads a Basic revision — no second plan lane, no second render path.
+  "pro-3d-render": { planType: "3d-scene", planField: "scenePlan" }
 };
 var COMPOSER_PLAN_FIELDS = [
   ...new Set(Object.values(COMPOSER_PLAN_MAP).map((m) => m.planField))
@@ -5016,6 +5026,157 @@ function resolveTopazUpscale(input) {
   };
 }
 
+// src/producer-types.ts
+var VIDEO_PRODUCER_TYPES = /* @__PURE__ */ new Set([
+  "image-to-video",
+  "video-to-video",
+  "switchx",
+  // Beeble SwitchX relight/composite
+  "text-to-video",
+  // Unified video node — emits videoUrl identically to i2v/t2v (its payload-builder
+  // case dispatches dynamically to "image-to-video" or "text-to-video" jobName based
+  // on whether a start frame is wired). Without this, getPrimaryOutput would fall
+  // through to the imageUrl/videoUrl/audioUrl/text default and downstream consumers
+  // could silently misroute the output.
+  "generate-video",
+  // Generate Video Pro — Seedance-2-family multi-segment stitch variant of
+  // generate-video (same "emits videoUrl" contract; a trimmed provider +
+  // handle set). Must mirror generate-video here or its output can't connect
+  // downstream (the recurring "cannot connect the outputs" bug class).
+  "generate-video-pro",
+  // Edit Video Pro — Seedance-2-family span-replace sibling of generate-
+  // video-pro (same "emits videoUrl" contract; source video + prompt in,
+  // ONE video out). Must mirror generate-video-pro here or its output can't
+  // connect downstream (the recurring "cannot connect the outputs" bug class).
+  "edit-video-pro",
+  "upload-video",
+  "youtube-video",
+  "combine-videos",
+  "lip-sync",
+  "speech-to-video",
+  "motion-transfer",
+  "video-upscale",
+  "extend-video",
+  // face-swap output is video (writes generatedVideoUrl, per-result `url`).
+  // Frontend execution-graph already includes it in VIDEO_SOURCE_TYPES; this
+  // entry brings the shared set in line so canvas typed-handle validation
+  // doesn't reject face-swap → video-consumer edges that the orchestrator
+  // would happily route at runtime.
+  "face-swap",
+  "video-retake",
+  // video-sfx: adds an SFX track to a video → emits a video URL. Belongs here so
+  // canvas handle validation accepts video-sfx → video-consumer edges and the
+  // backend routes its output as video (it was previously relying on a fallback).
+  "video-sfx",
+  "suno-music-video",
+  "merge-video-audio",
+  "add-captions",
+  "resize-video",
+  "social-media-format",
+  "trim-video",
+  "render-video",
+  "speed-ramp",
+  "loop-video",
+  "fade-video",
+  "transcode-video",
+  "manual-edit",
+  // Remove Audio: strips the audio track, emits a silent video.
+  "remove-audio",
+  // AI Avatar (HeyGen): avatar + voice/audio → video.
+  "ai-avatar",
+  // Cinematic Avatar (HeyGen cinematic_avatar): prompt + 1–3 avatar looks → video.
+  "cinematic-avatar",
+  // Assemble Narrated Video: fits N (clip, voice) blocks into one MP4 → video.
+  "assemble-narrated-video",
+  // Still to Video: one still image + one audio track → MP4 (local FFmpeg,
+  // no provider). Emits generatedVideoUrl like every other ffmpeg video node.
+  "still-to-video",
+  // Slideshow: 2-100 stills + one optional audio track → MP4 (local FFmpeg,
+  // no provider). Same contract; images arrive via the image-collage lane.
+  "slideshow",
+  // GIF to Video: animated GIF → H.264 MP4 (local FFmpeg, no provider).
+  // Emits generatedVideoUrl so it connects to any downstream video consumer
+  // (e.g. a Seedance video-reference input) by an ordinary edge.
+  "gif-to-video",
+  // 3D Render Pro: authors a scene AND exports it in one operation, settling
+  // with the standard `videoUrl` field. It is a video producer as much as it
+  // is a composition producer — omitting it here is the "cannot connect the
+  // outputs" bug, and its `composition` handle is typed separately.
+  "pro-3d-render"
+]);
+var DYNAMIC_PRODUCER_TYPES = /* @__PURE__ */ new Set([
+  "list",
+  "sub-workflow",
+  "adjust-volume",
+  // Dual-mode: audio in → audio out; video in → video out (+ revoiced audio).
+  // Listed here so canvas validators accept its output on BOTH audio and video
+  // input handles (it also stays in AUDIO_PRODUCER_TYPES as its default).
+  "voice-changer",
+  // voice-changer-pro (renamed from voice-recast in #3581) is a behavioral
+  // twin of voice-changer — identical dual-mode output. Must mirror it in
+  // EVERY producer set or its outputs can't connect (was the "cannot connect
+  // the outputs of voice-changer-pro" bug). Guarded by producer-types.test.ts.
+  "voice-changer-pro",
+  // Dubbing joined the dual-mode family with the full-surface upgrade:
+  // audio in → dubbed audio; video in (or a video sourceUrl) → dubbed VIDEO
+  // (+ audio sidecar). Same wiring contract as voice-changer; stays in
+  // AUDIO_PRODUCER_TYPES as its default. Explicitly asserted in
+  // producer-types.test.ts (the suite does not fail on omission).
+  "dubbing",
+  "reduce",
+  // Dual-output time chunker (UI label "Split into Chunks"; type id stays
+  // "split-media"): video in → video chunks, audio in → audio chunks — two
+  // independent lanes on two output handles. Like voice-changer, the canvas
+  // validator only sees the source NODE type, not which handle a wire leaves,
+  // so it lives here to be accepted on BOTH audio and video input handles. The
+  // backend routes the correct lane by sourceHandle in getPrimaryOutput
+  // (output-extractor.ts); the frontend does so in extractNodeOutput.
+  "split-media"
+]);
+var AUDIO_PRODUCER_TYPES = /* @__PURE__ */ new Set([
+  "text-to-speech",
+  "text-to-audio",
+  "generate-music",
+  "upload-audio",
+  "suno-generate",
+  "suno-cover",
+  "suno-extend",
+  "suno-separate",
+  "audio-separation",
+  "suno-mashup",
+  "suno-replace-section",
+  "suno-add-instrumental",
+  "suno-add-vocals",
+  "suno-convert-wav",
+  "suno-upload-extend",
+  "trim-audio",
+  "mix-audio",
+  "combine-audio",
+  "adjust-volume",
+  "audio-fx",
+  "reference-audio",
+  "audio-isolation",
+  "text-to-dialogue",
+  "voice-changer",
+  // Twin of voice-changer (see DYNAMIC_PRODUCER_TYPES note). Audio is its
+  // default output mode; video mode is handled via DYNAMIC membership.
+  "voice-changer-pro",
+  "dubbing",
+  "voice-remix",
+  "voice-design",
+  // Extract Audio: demuxes a video's audio track to a standalone MP3.
+  "extract-audio"
+]);
+var FAN_OUT_EACH_TYPES = /* @__PURE__ */ new Set([
+  "list",
+  "split-text",
+  "filter-list",
+  "deduplicate",
+  "merge-lists",
+  "sort-list",
+  "selector"
+]);
+
 // src/presentation-utils.ts
 var INPUT_NODE_TYPES = /* @__PURE__ */ new Set([
   "text-prompt",
@@ -5193,7 +5354,7 @@ function getOutputNodes(nodes, edges, curatedOnly = true) {
       if (n.data.presentationOutput === true) return true;
       if (n.data.presentationVisible === true) {
         if (NON_OUTPUT_TYPES.has(n.type)) return false;
-        return !nodesWithOutgoing.has(n.id) || MEDIA_PRODUCING_TYPES.has(n.type);
+        return !nodesWithOutgoing.has(n.id) || isMediaProducingType(n.type);
       }
       return false;
     }
@@ -5206,8 +5367,15 @@ function getOutputType(nodeType) {
   if (VIDEO_OUTPUT_TYPES.has(nodeType)) return "video";
   if (AUDIO_OUTPUT_TYPES.has(nodeType)) return "audio";
   if (TEXT_OUTPUT_TYPES.has(nodeType)) return "text";
+  if (VIDEO_PRODUCER_TYPES.has(nodeType)) return "video";
+  if (AUDIO_PRODUCER_TYPES.has(nodeType)) return "audio";
   return "data";
 }
+function isMediaProducingType(nodeType) {
+  if (MEDIA_PRODUCING_TYPES.has(nodeType)) return true;
+  const output = getOutputType(nodeType);
+  return output === "image" || output === "video" || output === "audio";
+}
 function getNodeResult(nodeData) {
   const previewItems = nodeData.previewItems;
   if (previewItems && previewItems.length > 0) {
@@ -8776,6 +8944,7 @@ var NODE_MAPPABLE_FIELDS = {
   "3d-title": ["titlePrompt"],
   "generate-3d-scene": ["scenePrompt"],
   "edit-3d-scene": ["editPrompt"],
+  "pro-3d-render": ["scenePrompt"],
   "motion-graphics": ["motionPrompt"],
   "generate-script": ["styleGuide"],
   "speech-to-video": ["prompt", "negativePrompt"],
@@ -12913,152 +13082,6 @@ function resolveAudioCrossfadeCurve(id) {
   return CURVES_BY_ID.get(id)?.ffmpeg ?? "tri";
 }
 
-// src/producer-types.ts
-var VIDEO_PRODUCER_TYPES = /* @__PURE__ */ new Set([
-  "image-to-video",
-  "video-to-video",
-  "switchx",
-  // Beeble SwitchX relight/composite
-  "text-to-video",
-  // Unified video node — emits videoUrl identically to i2v/t2v (its payload-builder
-  // case dispatches dynamically to "image-to-video" or "text-to-video" jobName based
-  // on whether a start frame is wired). Without this, getPrimaryOutput would fall
-  // through to the imageUrl/videoUrl/audioUrl/text default and downstream consumers
-  // could silently misroute the output.
-  "generate-video",
-  // Generate Video Pro — Seedance-2-family multi-segment stitch variant of
-  // generate-video (same "emits videoUrl" contract; a trimmed provider +
-  // handle set). Must mirror generate-video here or its output can't connect
-  // downstream (the recurring "cannot connect the outputs" bug class).
-  "generate-video-pro",
-  // Edit Video Pro — Seedance-2-family span-replace sibling of generate-
-  // video-pro (same "emits videoUrl" contract; source video + prompt in,
-  // ONE video out). Must mirror generate-video-pro here or its output can't
-  // connect downstream (the recurring "cannot connect the outputs" bug class).
-  "edit-video-pro",
-  "upload-video",
-  "youtube-video",
-  "combine-videos",
-  "lip-sync",
-  "speech-to-video",
-  "motion-transfer",
-  "video-upscale",
-  "extend-video",
-  // face-swap output is video (writes generatedVideoUrl, per-result `url`).
-  // Frontend execution-graph already includes it in VIDEO_SOURCE_TYPES; this
-  // entry brings the shared set in line so canvas typed-handle validation
-  // doesn't reject face-swap → video-consumer edges that the orchestrator
-  // would happily route at runtime.
-  "face-swap",
-  "video-retake",
-  // video-sfx: adds an SFX track to a video → emits a video URL. Belongs here so
-  // canvas handle validation accepts video-sfx → video-consumer edges and the
-  // backend routes its output as video (it was previously relying on a fallback).
-  "video-sfx",
-  "suno-music-video",
-  "merge-video-audio",
-  "add-captions",
-  "resize-video",
-  "social-media-format",
-  "trim-video",
-  "render-video",
-  "speed-ramp",
-  "loop-video",
-  "fade-video",
-  "transcode-video",
-  "manual-edit",
-  // Remove Audio: strips the audio track, emits a silent video.
-  "remove-audio",
-  // AI Avatar (HeyGen): avatar + voice/audio → video.
-  "ai-avatar",
-  // Cinematic Avatar (HeyGen cinematic_avatar): prompt + 1–3 avatar looks → video.
-  "cinematic-avatar",
-  // Assemble Narrated Video: fits N (clip, voice) blocks into one MP4 → video.
-  "assemble-narrated-video",
-  // Still to Video: one still image + one audio track → MP4 (local FFmpeg,
-  // no provider). Emits generatedVideoUrl like every other ffmpeg video node.
-  "still-to-video",
-  // Slideshow: 2-100 stills + one optional audio track → MP4 (local FFmpeg,
-  // no provider). Same contract; images arrive via the image-collage lane.
-  "slideshow",
-  // GIF to Video: animated GIF → H.264 MP4 (local FFmpeg, no provider).
-  // Emits generatedVideoUrl so it connects to any downstream video consumer
-  // (e.g. a Seedance video-reference input) by an ordinary edge.
-  "gif-to-video"
-]);
-var DYNAMIC_PRODUCER_TYPES = /* @__PURE__ */ new Set([
-  "list",
-  "sub-workflow",
-  "adjust-volume",
-  // Dual-mode: audio in → audio out; video in → video out (+ revoiced audio).
-  // Listed here so canvas validators accept its output on BOTH audio and video
-  // input handles (it also stays in AUDIO_PRODUCER_TYPES as its default).
-  "voice-changer",
-  // voice-changer-pro (renamed from voice-recast in #3581) is a behavioral
-  // twin of voice-changer — identical dual-mode output. Must mirror it in
-  // EVERY producer set or its outputs can't connect (was the "cannot connect
-  // the outputs of voice-changer-pro" bug). Guarded by producer-types.test.ts.
-  "voice-changer-pro",
-  // Dubbing joined the dual-mode family with the full-surface upgrade:
-  // audio in → dubbed audio; video in (or a video sourceUrl) → dubbed VIDEO
-  // (+ audio sidecar). Same wiring contract as voice-changer; stays in
-  // AUDIO_PRODUCER_TYPES as its default. Explicitly asserted in
-  // producer-types.test.ts (the suite does not fail on omission).
-  "dubbing",
-  "reduce",
-  // Dual-output time chunker (UI label "Split into Chunks"; type id stays
-  // "split-media"): video in → video chunks, audio in → audio chunks — two
-  // independent lanes on two output handles. Like voice-changer, the canvas
-  // validator only sees the source NODE type, not which handle a wire leaves,
-  // so it lives here to be accepted on BOTH audio and video input handles. The
-  // backend routes the correct lane by sourceHandle in getPrimaryOutput
-  // (output-extractor.ts); the frontend does so in extractNodeOutput.
-  "split-media"
-]);
-var AUDIO_PRODUCER_TYPES = /* @__PURE__ */ new Set([
-  "text-to-speech",
-  "text-to-audio",
-  "generate-music",
-  "upload-audio",
-  "suno-generate",
-  "suno-cover",
-  "suno-extend",
-  "suno-separate",
-  "audio-separation",
-  "suno-mashup",
-  "suno-replace-section",
-  "suno-add-instrumental",
-  "suno-add-vocals",
-  "suno-convert-wav",
-  "suno-upload-extend",
-  "trim-audio",
-  "mix-audio",
-  "combine-audio",
-  "adjust-volume",
-  "audio-fx",
-  "reference-audio",
-  "audio-isolation",
-  "text-to-dialogue",
-  "voice-changer",
-  // Twin of voice-changer (see DYNAMIC_PRODUCER_TYPES note). Audio is its
-  // default output mode; video mode is handled via DYNAMIC membership.
-  "voice-changer-pro",
-  "dubbing",
-  "voice-remix",
-  "voice-design",
-  // Extract Audio: demuxes a video's audio track to a standalone MP3.
-  "extract-audio"
-]);
-var FAN_OUT_EACH_TYPES = /* @__PURE__ */ new Set([
-  "list",
-  "split-text",
-  "filter-list",
-  "deduplicate",
-  "merge-lists",
-  "sort-list",
-  "selector"
-]);
-
 // src/suno-track-sources.ts
 var SUNO_TRACK_SOURCE_TYPES = /* @__PURE__ */ new Set([
   "suno-generate",
@@ -16250,8 +16273,8 @@ function scene3DCameraTrackIssues(track) {
   }
   const quaternionTolerance = SCENE3D_CAMERA_TRACK_LIMITS.quaternionTolerance;
   track.samples.forEach((sample, index) => {
-    const [x, y, z22, w] = sample.quaternion;
-    const norm = Math.sqrt(x * x + y * y + z22 * z22 + w * w);
+    const [x, y, z23, w] = sample.quaternion;
+    const norm = Math.sqrt(x * x + y * y + z23 * z23 + w * w);
     if (Math.abs(norm - 1) > quaternionTolerance) {
       issues.push({
         path: ["samples", index, "quaternion"],
@@ -16342,6 +16365,121 @@ function parseScene3DCameraTrackJson(text) {
   }
   return { ok: true, value: parsed.data };
 }
+var PRO3D_RENDER_NODE_TYPE = "pro-3d-render";
+var PRO3D_RENDER_LABEL = "3D Render Pro";
+var PRO3D_RENDER_CREDIT_ID = "pro-3d-render";
+var PRO3D_RENDER_ENGINES = ["blender-cloud", "blender-local"];
+var PRO3D_RENDER_DEFAULT_ENGINE = "blender-cloud";
+var PRO3D_RENDER_QUALITY_PROFILES = ["standard"];
+var PRO3D_RENDER_DEFAULT_QUALITY = "standard";
+var PRO3D_RENDER_STYLES = ["clay"];
+var PRO3D_RENDER_DEFAULT_STYLE = "clay";
+var PRO3D_RENDER_MIN_REPAIR_PASSES = 0;
+var PRO3D_RENDER_MAX_REPAIR_PASSES = 2;
+var PRO3D_RENDER_DEFAULT_REPAIR_PASSES = 2;
+var PRO3D_RENDER_ASPECT_RATIOS = ["16:9", "9:16", "1:1", "4:5", "21:9"];
+var PRO3D_RENDER_PROMPT_MAX = 8e3;
+var PRO3D_RENDER_LIMITS = {
+  promptMax: PRO3D_RENDER_PROMPT_MAX,
+  editPromptMax: PRO3D_RENDER_PROMPT_MAX,
+  minDurationSeconds: SCENE3D_LIMITS.minDurationSeconds,
+  maxDurationSeconds: SCENE3D_LIMITS.maxDurationSeconds,
+  minFps: SCENE3D_LIMITS.minFps,
+  maxFps: SCENE3D_LIMITS.maxFps,
+  maxReferences: SCENE3D_LIMITS.maxReferences,
+  /** Opaque ids the caller echoes back (quote, export, connection). */
+  maxIdLength: 200,
+  /** `Idempotency-Key` bounds — the platform's floor, with a ceiling so an
+   *  unbounded header can never reach a lookup or a database column. */
+  minIdempotencyKeyLength: 8,
+  maxIdempotencyKeyLength: 255
+};
+var PRO3D_RENDER_SOURCE_KINDS = ["prompt", "scene", "local-export"];
+function isPro3DRenderRenderOnly(source) {
+  return source.kind === "scene" && source.editPrompt === void 0;
+}
+function pro3DRenderProducedSchemaVersion(source) {
+  return source.kind === "scene" ? null : 2;
+}
+var pro3DRenderQuoteSchema = zod.z.object({
+  quoteId: zod.z.string().min(1),
+  expiresAt: zod.z.string().min(1),
+  maxCredits: zod.z.number(),
+  breakdown: zod.z.array(
+    zod.z.object({ code: zod.z.string(), label: zod.z.string(), credits: zod.z.number() }).passthrough()
+  ),
+  pricingVersion: zod.z.string(),
+  capabilitiesVersion: zod.z.string(),
+  normalizedInputHash: zod.z.string().min(1)
+}).passthrough();
+function isPro3DRenderQuote(value) {
+  return pro3DRenderQuoteSchema.safeParse(value).success;
+}
+var pro3DRenderJobOutputSchema = zod.z.object({
+  videoUrl: zod.z.string().min(1),
+  scenePlan: scene3DAnyPlanSchema,
+  sceneRevisionId: zod.z.string().min(1),
+  posterAssetId: zod.z.string().min(1),
+  sourceArtifactId: zod.z.string().min(1).optional(),
+  validation: zod.z.object({
+    status: zod.z.literal("passed"),
+    reportAssetId: zod.z.string().min(1),
+    warnings: zod.z.array(
+      zod.z.object({
+        code: zod.z.string(),
+        message: zod.z.string(),
+        shotId: zod.z.string().optional()
+      }).passthrough()
+    )
+  }).passthrough(),
+  renderer: zod.z.string().min(1),
+  metadata: zod.z.object({
+    width: zod.z.number().int().positive(),
+    height: zod.z.number().int().positive(),
+    fps: zod.z.number().positive(),
+    frames: zod.z.number().int().positive(),
+    duration: zod.z.number().positive()
+  }).passthrough(),
+  changeSummary: zod.z.string().optional()
+}).passthrough();
+function isPro3DRenderJobOutput(value) {
+  return pro3DRenderJobOutputSchema.safeParse(value).success;
+}
+var pro3DRenderCoreOutputSchema = zod.z.object({
+  videoUrl: zod.z.string().min(1),
+  scenePlan: scene3DAnyPlanSchema
+}).passthrough();
+function buildPro3DRenderSource(input) {
+  if (input.sourceMode === "scene") {
+    const revisionId = input.revisionId?.trim();
+    const sourceJobId = input.sourceJobId?.trim();
+    if (!revisionId) {
+      return { ok: false, message: "no scene to render \u2014 wire a 3D scene in, or run this node once." };
+    }
+    const editPrompt = input.editPrompt?.trim();
+    return {
+      ok: true,
+      source: { kind: "scene", revisionId, ...sourceJobId ? { sourceJobId } : {}, ...editPrompt ? { editPrompt } : {} }
+    };
+  }
+  const prompt = input.prompt?.trim();
+  if (!prompt) {
+    return { ok: false, message: "no brief \u2014 describe the scene, or wire a prompt in." };
+  }
+  const references = input.references ?? [];
+  return {
+    ok: true,
+    source: { kind: "prompt", prompt, ...references.length > 0 ? { references } : {} }
+  };
+}
+function pro3DRenderTimingOverrides(input) {
+  if (input.source.kind === "scene" && !input.overrideSourceTiming) return {};
+  const out = {};
+  if (typeof input.durationSeconds === "number") out.durationSeconds = input.durationSeconds;
+  if (typeof input.fps === "number") out.fps = input.fps;
+  if (typeof input.aspectRatio === "string") out.aspectRatio = input.aspectRatio;
+  return out;
+}
 
 // src/studio-transient.ts
 var STUDIO_TRANSIENT_KEYS = [
@@ -16524,6 +16662,83 @@ async function applyScene3DV2EditOperations(input, operations, options) {
   return { ok: true, plan: { ...plan, provenance: { ...plan.provenance, contentHash } }, changeSummary: `Applied ${ops.data.length} scene edit${ops.data.length === 1 ? "" : "s"}` };
 }
 
+// src/scene3d-authoring-engine.ts
+var SCENE3D_BASIC_ENGINE = "basic";
+var SCENE3D_AUTHORING_ENGINES = [SCENE3D_BASIC_ENGINE, ...SCENE3D_V2_ENGINES];
+var SCENE3D_DEFAULT_ADVANCED_ENGINE = "blender-cloud";
+function isScene3DAuthoringEngine(value) {
+  return typeof value === "string" && SCENE3D_AUTHORING_ENGINES.includes(value);
+}
+function advancedFields(engine) {
+  return { engine, acceptedSceneSchemaVersions: [...SCENE3D_SUPPORTED_SCHEMA_VERSIONS] };
+}
+function serves(available, engine) {
+  return available === void 0 || available.includes(engine);
+}
+function planAuthoringEngine(plan) {
+  const provenance = plan?.provenance;
+  const engine = provenance?.engine;
+  return typeof engine === "string" && isKnownScene3DEngine(engine) ? engine : void 0;
+}
+function resolveScene3DAuthoringEngine(input) {
+  const requested = typeof input.requested === "string" && input.requested.trim() !== "" ? input.requested.trim() : void 0;
+  if (requested !== void 0 && !isScene3DAuthoringEngine(requested)) {
+    return {
+      ok: false,
+      code: "unknown_engine",
+      message: `"${requested}" is not a 3D authoring engine \u2014 choose Basic, or an advanced engine this install offers.`
+    };
+  }
+  const version = input.plan === void 0 ? void 0 : scene3DPlanSchemaVersion(input.plan);
+  if (version !== void 0 && version !== null && !SCENE3D_SUPPORTED_SCHEMA_VERSIONS.includes(version)) {
+    return {
+      ok: false,
+      code: "unsupported_schema_version",
+      message: `This scene uses schema version ${version}, which this version of Nodaro cannot edit.`
+    };
+  }
+  const isV2 = version === SCENE3D_SCHEMA_VERSION_V2;
+  if (isV2) {
+    if (requested === SCENE3D_BASIC_ENGINE) {
+      return {
+        ok: false,
+        code: "schema_requires_advanced",
+        message: "This scene was authored by an advanced engine (schema v2) and cannot be edited on the Basic engine \u2014 switch this node's engine to the advanced one."
+      };
+    }
+    if (requested !== void 0) {
+      return serves(input.availableEngines, requested) ? { ok: true, lane: "advanced", engine: requested, fields: advancedFields(requested) } : unavailable(requested);
+    }
+    const preferred = [];
+    const authored = planAuthoringEngine(input.plan);
+    if (authored) preferred.push(authored);
+    if (!preferred.includes(SCENE3D_DEFAULT_ADVANCED_ENGINE)) preferred.push(SCENE3D_DEFAULT_ADVANCED_ENGINE);
+    const engine2 = preferred.find((candidate) => serves(input.availableEngines, candidate));
+    if (!engine2) {
+      return {
+        ok: false,
+        code: "advanced_unavailable",
+        message: "This scene needs an advanced 3D engine to edit, and this install does not have one available."
+      };
+    }
+    return { ok: true, lane: "advanced", engine: engine2, fields: advancedFields(engine2) };
+  }
+  if (requested === void 0 || requested === SCENE3D_BASIC_ENGINE) {
+    return { ok: true, lane: "basic", engine: void 0, fields: {} };
+  }
+  const engine = requested;
+  if (!serves(input.availableEngines, engine)) return unavailable(engine);
+  return { ok: true, lane: "advanced", engine, fields: advancedFields(engine) };
+}
+function unavailable(engine) {
+  return {
+    ok: false,
+    code: "engine_unavailable",
+    message: `The "${engine}" 3D authoring engine is not available on this install.`
+  };
+}
+var SCENE3D_BASIC_SCHEMA_VERSION = SCENE3D_SCHEMA_VERSION;
+
 exports.ACCESS_LEVELS = ACCESS_LEVELS;
 exports.ACTIVE_SCENE_HELPERS = ACTIVE_SCENE_HELPERS;
 exports.ADVANCED_MODE_UNAVAILABLE_REASON = ADVANCED_MODE_UNAVAILABLE_REASON;
@@ -16819,6 +17034,22 @@ exports.PRESET_LABELS = PRESET_LABELS;
 exports.PRESET_SETTING_KEYS = PRESET_SETTING_KEYS;
 exports.PRICING_DEFAULT_DURATION_SEC = PRICING_DEFAULT_DURATION_SEC;
 exports.PRICING_DEFAULT_RESOLUTION = PRICING_DEFAULT_RESOLUTION;
+exports.PRO3D_RENDER_ASPECT_RATIOS = PRO3D_RENDER_ASPECT_RATIOS;
+exports.PRO3D_RENDER_CREDIT_ID = PRO3D_RENDER_CREDIT_ID;
+exports.PRO3D_RENDER_DEFAULT_ENGINE = PRO3D_RENDER_DEFAULT_ENGINE;
+exports.PRO3D_RENDER_DEFAULT_QUALITY = PRO3D_RENDER_DEFAULT_QUALITY;
+exports.PRO3D_RENDER_DEFAULT_REPAIR_PASSES = PRO3D_RENDER_DEFAULT_REPAIR_PASSES;
+exports.PRO3D_RENDER_DEFAULT_STYLE = PRO3D_RENDER_DEFAULT_STYLE;
+exports.PRO3D_RENDER_ENGINES = PRO3D_RENDER_ENGINES;
+exports.PRO3D_RENDER_LABEL = PRO3D_RENDER_LABEL;
+exports.PRO3D_RENDER_LIMITS = PRO3D_RENDER_LIMITS;
+exports.PRO3D_RENDER_MAX_REPAIR_PASSES = PRO3D_RENDER_MAX_REPAIR_PASSES;
+exports.PRO3D_RENDER_MIN_REPAIR_PASSES = PRO3D_RENDER_MIN_REPAIR_PASSES;
+exports.PRO3D_RENDER_NODE_TYPE = PRO3D_RENDER_NODE_TYPE;
+exports.PRO3D_RENDER_PROMPT_MAX = PRO3D_RENDER_PROMPT_MAX;
+exports.PRO3D_RENDER_QUALITY_PROFILES = PRO3D_RENDER_QUALITY_PROFILES;
+exports.PRO3D_RENDER_SOURCE_KINDS = PRO3D_RENDER_SOURCE_KINDS;
+exports.PRO3D_RENDER_STYLES = PRO3D_RENDER_STYLES;
 exports.PROMPT_HARD_CEILING = PROMPT_HARD_CEILING;
 exports.PROMPT_PREFIX_KEY = PROMPT_PREFIX_KEY;
 exports.PROMPT_SUFFIX_KEY = PROMPT_SUFFIX_KEY;
@@ -16854,10 +17085,14 @@ exports.RESERVED_TEMPLATE_VARS = RESERVED_TEMPLATE_VARS;
 exports.SCENE3D_ASSET_KINDS = SCENE3D_ASSET_KINDS;
 exports.SCENE3D_ASSET_ROLES = SCENE3D_ASSET_ROLES;
 exports.SCENE3D_ASSET_ROLE_KINDS = SCENE3D_ASSET_ROLE_KINDS;
+exports.SCENE3D_AUTHORING_ENGINES = SCENE3D_AUTHORING_ENGINES;
+exports.SCENE3D_BASIC_ENGINE = SCENE3D_BASIC_ENGINE;
+exports.SCENE3D_BASIC_SCHEMA_VERSION = SCENE3D_BASIC_SCHEMA_VERSION;
 exports.SCENE3D_CAMERA_TRACK_FORMAT = SCENE3D_CAMERA_TRACK_FORMAT;
 exports.SCENE3D_CAMERA_TRACK_LIMITS = SCENE3D_CAMERA_TRACK_LIMITS;
 exports.SCENE3D_CAMERA_TRACK_VERSION = SCENE3D_CAMERA_TRACK_VERSION;
 exports.SCENE3D_CLAY_LIGHTING_PRESETS = SCENE3D_CLAY_LIGHTING_PRESETS;
+exports.SCENE3D_DEFAULT_ADVANCED_ENGINE = SCENE3D_DEFAULT_ADVANCED_ENGINE;
 exports.SCENE3D_DEFAULT_DURATION_SECONDS = SCENE3D_DEFAULT_DURATION_SECONDS;
 exports.SCENE3D_DEFAULT_ENTITY_CAPABILITIES = SCENE3D_DEFAULT_ENTITY_CAPABILITIES;
 exports.SCENE3D_DEFAULT_FPS = SCENE3D_DEFAULT_FPS;
@@ -17070,6 +17305,7 @@ exports.buildModelTree = buildModelTree;
 exports.buildMotionCreditModelIdentifier = buildMotionCreditModelIdentifier;
 exports.buildNodePresetExport = buildNodePresetExport;
 exports.buildPanelPrompt = buildPanelPrompt;
+exports.buildPro3DRenderSource = buildPro3DRenderSource;
 exports.buildProgressSegments = buildProgressSegments;
 exports.buildRangeLabel = buildRangeLabel;
 exports.buildScraperCreditId = buildScraperCreditId;
@@ -17229,6 +17465,10 @@ exports.isObjectAspectRatio = isObjectAspectRatio;
 exports.isOversizedScene = isOversizedScene;
 exports.isPaygRetentionActive = isPaygRetentionActive;
 exports.isPerSecondLipSyncProvider = isPerSecondLipSyncProvider;
+exports.isPro3DRenderJobOutput = isPro3DRenderJobOutput;
+exports.isPro3DRenderQuote = isPro3DRenderQuote;
+exports.isPro3DRenderRenderOnly = isPro3DRenderRenderOnly;
+exports.isScene3DAuthoringEngine = isScene3DAuthoringEngine;
 exports.isScene3DCameraTrack = isScene3DCameraTrack;
 exports.isScene3DHttpUrl = isScene3DHttpUrl;
 exports.isScene3DPlan = isScene3DPlan;
@@ -17304,6 +17544,11 @@ exports.presetApplyClearKeys = presetApplyClearKeys;
 exports.presetDataMatches = presetDataMatches;
 exports.presetEntries = presetEntries;
 exports.pricedVideoSelection = pricedVideoSelection;
+exports.pro3DRenderCoreOutputSchema = pro3DRenderCoreOutputSchema;
+exports.pro3DRenderJobOutputSchema = pro3DRenderJobOutputSchema;
+exports.pro3DRenderProducedSchemaVersion = pro3DRenderProducedSchemaVersion;
+exports.pro3DRenderQuoteSchema = pro3DRenderQuoteSchema;
+exports.pro3DRenderTimingOverrides = pro3DRenderTimingOverrides;
 exports.qualityOptionsByKind = qualityOptionsByKind;
 exports.readPromptAffixes = readPromptAffixes;
 exports.refHandleCategory = refHandleCategory;
@@ -17340,6 +17585,7 @@ exports.resolveNormalizedImageGen = resolveNormalizedImageGen;
 exports.resolveObjectAspectRatio = resolveObjectAspectRatio;
 exports.resolvePipelineModel = resolvePipelineModel;
 exports.resolveRelativeWindowToken = resolveRelativeWindowToken;
+exports.resolveScene3DAuthoringEngine = resolveScene3DAuthoringEngine;
 exports.resolveScraperCreditId = resolveScraperCreditId;
 exports.resolveSelectorRefs = resolveSelectorRefs;
 exports.resolveSeparator = resolveSeparator;