@nodaro/shared 2.26.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -4131,7 +4131,12 @@ var COMPOSER_PLAN_MAP = {
4131
4131
  "lottie-overlay": { planType: "lottie-overlay", planField: "overlayPlan" },
4132
4132
  "3d-title": { planType: "3d-title", planField: "titlePlan" },
4133
4133
  "motion-graphics": { planType: "motion-graphics", planField: "motionPlan" },
4134
- "composite": { planType: "composite", planField: "compositePlan" }
4134
+ "composite": { planType: "composite", planField: "compositePlan" },
4135
+ // Scene3D previz (v1) — both the generator and the editor emit the SAME
4136
+ // validated `Scene3DPlan` revision on their `composition` handle, so
4137
+ // render-video routes either one to the `3d-scene` renderer unchanged.
4138
+ "generate-3d-scene": { planType: "3d-scene", planField: "scenePlan" },
4139
+ "edit-3d-scene": { planType: "3d-scene", planField: "scenePlan" }
4135
4140
  };
4136
4141
  var COMPOSER_PLAN_FIELDS = [
4137
4142
  ...new Set(Object.values(COMPOSER_PLAN_MAP).map((m) => m.planField))
@@ -5880,6 +5885,7 @@ var LLM_FEATURE_DEFAULTS = {
5880
5885
  "motion-graphics-lottie": "claude-sonnet-4.6",
5881
5886
  "lottie-overlay": "claude-sonnet-4.6",
5882
5887
  "3d-title": "claude-sonnet-4.6",
5888
+ "3d-scene": "claude-sonnet-4.6",
5883
5889
  "image-to-text": "claude-sonnet-4.6",
5884
5890
  "describe-to-picker": "claude-opus-5",
5885
5891
  "qa-check": "gemini-3.6-flash",
@@ -5980,7 +5986,10 @@ var LLM_ROUTE_DEFAULTS = {
5980
5986
  "lottie-overlay": { temperature: 0.3, maxTokens: 2048, structuredOutput: true },
5981
5987
  "motion-graphics": { temperature: 0.3, maxTokens: 2048, structuredOutput: true },
5982
5988
  "motion-graphics-lottie": { temperature: 0.3, maxTokens: 8192, structuredOutput: true },
5983
- "3d-title": { temperature: 0.4, maxTokens: 3072, structuredOutput: true }
5989
+ "3d-title": { temperature: 0.4, maxTokens: 3072, structuredOutput: true },
5990
+ // A 100-object plan with keyframe tracks is the biggest structured payload
5991
+ // any composer feature emits — 3072 (3d-title's cap) truncates it mid-array.
5992
+ "3d-scene": { temperature: 0.3, maxTokens: 8192, structuredOutput: true }
5984
5993
  };
5985
5994
  function llmRouteDefaults(feature) {
5986
5995
  return feature && LLM_ROUTE_DEFAULTS[feature] || {};
@@ -8763,6 +8772,8 @@ var NODE_MAPPABLE_FIELDS = {
8763
8772
  "after-effects": ["effectPrompt"],
8764
8773
  "lottie-overlay": ["overlayPrompt"],
8765
8774
  "3d-title": ["titlePrompt"],
8775
+ "generate-3d-scene": ["scenePrompt"],
8776
+ "edit-3d-scene": ["editPrompt"],
8766
8777
  "motion-graphics": ["motionPrompt"],
8767
8778
  "generate-script": ["styleGuide"],
8768
8779
  "speech-to-video": ["prompt", "negativePrompt"],
@@ -13140,8 +13151,22 @@ function readPromptAffixes(data) {
13140
13151
  }
13141
13152
 
13142
13153
  // src/node-preset-extract.ts
13143
- var PRESET_APPLY_CLEAR_KEYS = [...COMPOSER_PLAN_FIELDS, "lottieUrl"];
13144
- var PROMPT_CONTENT_KEYS = ["prompt", PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY];
13154
+ var PRESET_APPLY_CLEAR_KEYS = [
13155
+ ...COMPOSER_PLAN_FIELDS,
13156
+ "lottieUrl",
13157
+ // Scene revision history contains old plans and their reference/prompt context.
13158
+ // Preserve it in workflows, never capture or resurrect it through a preset.
13159
+ "sceneHistory",
13160
+ "scenePendingPlan",
13161
+ "sceneJobBaseRevisionId",
13162
+ "expectedRevisionId",
13163
+ "changeSummary",
13164
+ "selectedObjectIds",
13165
+ "lockedObjectIds",
13166
+ "referenceObjectIds",
13167
+ "referenceRoles"
13168
+ ];
13169
+ var PROMPT_CONTENT_KEYS = ["prompt", "scenePrompt", "editPrompt", PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY];
13145
13170
  function presetApplyClearKeys(presetData) {
13146
13171
  const ownsPromptContent = PROMPT_CONTENT_KEYS.some((k) => presetData[k] !== void 0);
13147
13172
  return ownsPromptContent ? [...PRESET_APPLY_CLEAR_KEYS, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY] : PRESET_APPLY_CLEAR_KEYS;
@@ -14676,6 +14701,1645 @@ function entityHydrationColumns(kind) {
14676
14701
  function entityScalarFields(kind) {
14677
14702
  return [...ENTITY_SCALAR_FIELDS, ...ENTITY_KIND_SCALAR_FIELDS[kind]];
14678
14703
  }
14704
+ var SCENE3D_PLAN_TYPE = "3d-scene";
14705
+ var SCENE3D_SCHEMA_VERSION = 1;
14706
+ var SCENE3D_DEFAULT_FPS = 24;
14707
+ var SCENE3D_DEFAULT_DURATION_SECONDS = 4;
14708
+ var SCENE3D_LIMITS = {
14709
+ minDimensionPx: 100,
14710
+ maxDimensionPx: 1920,
14711
+ minFps: 15,
14712
+ maxFps: 60,
14713
+ minDurationInFrames: 1,
14714
+ maxDurationInFrames: 3600,
14715
+ /** Shortest scene an authoring request may ask for, in seconds. One second
14716
+ * is the frozen v1 floor the SDK/MCP surface and the public docs state; the
14717
+ * route Zod and the canvas path both quote it from here so they cannot
14718
+ * drift below it. */
14719
+ minDurationSeconds: 1,
14720
+ /** Hard ceiling on wall-clock length, checked against fps × frames. */
14721
+ maxDurationSeconds: 60,
14722
+ minObjects: 1,
14723
+ maxObjects: 100,
14724
+ /** Per-object and per-camera track length. */
14725
+ maxKeyframes: 240,
14726
+ maxReferences: 8,
14727
+ maxOperations: 100,
14728
+ /** |x|, |y|, |z| ceiling for positions and camera/target coordinates. */
14729
+ maxCoordinate: 1e3,
14730
+ minSize: 1e-3,
14731
+ maxSize: 1e3,
14732
+ minScale: 1e-3,
14733
+ maxScale: 1e3,
14734
+ minFocalLengthMm: 10,
14735
+ maxFocalLengthMm: 200,
14736
+ defaultSensorWidthMm: 36,
14737
+ minSensorWidthMm: 1,
14738
+ maxSensorWidthMm: 200,
14739
+ maxIntensity: 100,
14740
+ /** How deep a parent chain may nest. Bounds the renderer's transform walk. */
14741
+ maxHierarchyDepth: 8,
14742
+ maxIdLength: 64,
14743
+ maxNameLength: 120,
14744
+ maxUrlLength: 2048,
14745
+ maxChangeSummaryLength: 2e3
14746
+ };
14747
+ var SCENE3D_PRIMITIVES = [
14748
+ "box",
14749
+ "sphere",
14750
+ "cylinder",
14751
+ "cone",
14752
+ "plane",
14753
+ "capsule",
14754
+ "group"
14755
+ ];
14756
+ function boundedVec3(max, label) {
14757
+ return z.tuple([
14758
+ z.number().min(-max).max(max),
14759
+ z.number().min(-max).max(max),
14760
+ z.number().min(-max).max(max)
14761
+ ]).describe(label);
14762
+ }
14763
+ var vec3Schema = boundedVec3(SCENE3D_LIMITS.maxCoordinate, "position triple (meters)");
14764
+ var sizeVec3Schema = z.tuple([
14765
+ z.number().min(SCENE3D_LIMITS.minSize).max(SCENE3D_LIMITS.maxSize),
14766
+ z.number().min(SCENE3D_LIMITS.minSize).max(SCENE3D_LIMITS.maxSize),
14767
+ z.number().min(SCENE3D_LIMITS.minSize).max(SCENE3D_LIMITS.maxSize)
14768
+ ]);
14769
+ var scaleVec3Schema = z.tuple([
14770
+ z.number().min(SCENE3D_LIMITS.minScale).max(SCENE3D_LIMITS.maxScale),
14771
+ z.number().min(SCENE3D_LIMITS.minScale).max(SCENE3D_LIMITS.maxScale),
14772
+ z.number().min(SCENE3D_LIMITS.minScale).max(SCENE3D_LIMITS.maxScale)
14773
+ ]);
14774
+ var rotationVec3Schema = boundedVec3(1e3, "euler XYZ (radians)");
14775
+ var HEX_COLOR = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
14776
+ var scene3DColorSchema = z.string().regex(HEX_COLOR, "color must be an opaque hex string such as #4f8ef7 (3 or 6 digits; alpha is not supported)");
14777
+ var SCENE3D_ID = /^[A-Za-z0-9][A-Za-z0-9_.-]*$/;
14778
+ var scene3DIdSchema = z.string().min(1).max(SCENE3D_LIMITS.maxIdLength).regex(SCENE3D_ID, "id must start alphanumeric and contain only letters, digits, '_', '-' or '.'");
14779
+ function isScene3DHttpUrl(value) {
14780
+ try {
14781
+ const parsed = new URL(value);
14782
+ return parsed.protocol === "http:" || parsed.protocol === "https:";
14783
+ } catch {
14784
+ return false;
14785
+ }
14786
+ }
14787
+ var scene3DUrlSchema = z.string().min(1).max(SCENE3D_LIMITS.maxUrlLength).refine(isScene3DHttpUrl, "url must be an http(s) URL");
14788
+ var scene3DEasingSchema = z.enum(["linear", "easeInOut"]);
14789
+ var scene3DPrimitiveSchema = z.enum([
14790
+ "box",
14791
+ "sphere",
14792
+ "cylinder",
14793
+ "cone",
14794
+ "plane",
14795
+ "capsule",
14796
+ "group"
14797
+ ]);
14798
+ var frameSchema = z.number().int().min(0).max(SCENE3D_LIMITS.maxDurationInFrames);
14799
+ var scene3DObjectKeyframeSchema = z.object({
14800
+ frame: frameSchema,
14801
+ position: vec3Schema.optional(),
14802
+ rotation: rotationVec3Schema.optional(),
14803
+ scale: scaleVec3Schema.optional(),
14804
+ easing: scene3DEasingSchema.optional()
14805
+ }).strict();
14806
+ var scene3DCameraKeyframeSchema = z.object({
14807
+ frame: frameSchema,
14808
+ position: vec3Schema.optional(),
14809
+ target: vec3Schema.optional(),
14810
+ focalLengthMm: z.number().min(SCENE3D_LIMITS.minFocalLengthMm).max(SCENE3D_LIMITS.maxFocalLengthMm).optional(),
14811
+ easing: scene3DEasingSchema.optional()
14812
+ }).strict();
14813
+ var scene3DObjectSchema = z.object({
14814
+ id: scene3DIdSchema,
14815
+ name: z.string().min(1).max(SCENE3D_LIMITS.maxNameLength),
14816
+ primitive: scene3DPrimitiveSchema,
14817
+ parentId: scene3DIdSchema.optional(),
14818
+ dimensions: sizeVec3Schema,
14819
+ position: vec3Schema,
14820
+ rotation: rotationVec3Schema,
14821
+ scale: scaleVec3Schema,
14822
+ color: scene3DColorSchema,
14823
+ keyframes: z.array(scene3DObjectKeyframeSchema).max(SCENE3D_LIMITS.maxKeyframes).optional()
14824
+ }).strict();
14825
+ var scene3DCameraSchema = z.object({
14826
+ position: vec3Schema,
14827
+ target: vec3Schema,
14828
+ focalLengthMm: z.number().min(SCENE3D_LIMITS.minFocalLengthMm).max(SCENE3D_LIMITS.maxFocalLengthMm),
14829
+ sensorWidthMm: z.number().min(SCENE3D_LIMITS.minSensorWidthMm).max(SCENE3D_LIMITS.maxSensorWidthMm).default(SCENE3D_LIMITS.defaultSensorWidthMm),
14830
+ keyframes: z.array(scene3DCameraKeyframeSchema).max(SCENE3D_LIMITS.maxKeyframes).optional()
14831
+ }).strict();
14832
+ var scene3DLightingSchema = z.object({
14833
+ ambientIntensity: z.number().min(0).max(SCENE3D_LIMITS.maxIntensity),
14834
+ keyIntensity: z.number().min(0).max(SCENE3D_LIMITS.maxIntensity),
14835
+ keyPosition: vec3Schema
14836
+ }).strict();
14837
+ var scene3DReferenceSchema = z.object({
14838
+ id: scene3DIdSchema,
14839
+ url: scene3DUrlSchema,
14840
+ kind: z.enum(["image", "video"]),
14841
+ role: z.enum(["appearance", "layout", "motion"]),
14842
+ objectId: scene3DIdSchema.optional(),
14843
+ startSeconds: z.number().min(0).max(86400).optional(),
14844
+ endSeconds: z.number().min(0).max(86400).optional()
14845
+ }).strict();
14846
+ function checkKeyframeTrack(frames, durationInFrames, path, issues) {
14847
+ let previous = -1;
14848
+ frames.forEach((kf, index) => {
14849
+ if (kf.frame > durationInFrames - 1) {
14850
+ issues.push({
14851
+ path: [...path, index, "frame"],
14852
+ message: `frame ${kf.frame} is past the scene's last frame (${durationInFrames - 1})`
14853
+ });
14854
+ }
14855
+ if (kf.frame === previous) {
14856
+ issues.push({ path: [...path, index, "frame"], message: `duplicate keyframe at frame ${kf.frame}` });
14857
+ } else if (kf.frame < previous) {
14858
+ issues.push({
14859
+ path: [...path, index, "frame"],
14860
+ message: `keyframes must be sorted by frame (${kf.frame} follows ${previous})`
14861
+ });
14862
+ }
14863
+ previous = kf.frame;
14864
+ });
14865
+ }
14866
+ function scene3DPlanV1Issues(plan) {
14867
+ const issues = [];
14868
+ const seconds = plan.durationInFrames / plan.fps;
14869
+ if (seconds > SCENE3D_LIMITS.maxDurationSeconds) {
14870
+ issues.push({
14871
+ path: ["durationInFrames"],
14872
+ message: `scene is ${seconds.toFixed(2)}s; the limit is ${SCENE3D_LIMITS.maxDurationSeconds}s`
14873
+ });
14874
+ }
14875
+ const byId = /* @__PURE__ */ new Map();
14876
+ plan.objects.forEach((object, index) => {
14877
+ if (byId.has(object.id)) {
14878
+ issues.push({ path: ["objects", index, "id"], message: `duplicate object id "${object.id}"` });
14879
+ return;
14880
+ }
14881
+ byId.set(object.id, object);
14882
+ });
14883
+ plan.objects.forEach((object, index) => {
14884
+ if (object.parentId === void 0) return;
14885
+ if (object.parentId === object.id) {
14886
+ issues.push({ path: ["objects", index, "parentId"], message: `object "${object.id}" cannot parent itself` });
14887
+ return;
14888
+ }
14889
+ if (!byId.has(object.parentId)) {
14890
+ issues.push({
14891
+ path: ["objects", index, "parentId"],
14892
+ message: `object "${object.id}" references unknown parent "${object.parentId}"`
14893
+ });
14894
+ return;
14895
+ }
14896
+ const seen = /* @__PURE__ */ new Set([object.id]);
14897
+ let cursor = byId.get(object.parentId);
14898
+ let depth = 1;
14899
+ while (cursor) {
14900
+ if (seen.has(cursor.id)) {
14901
+ issues.push({
14902
+ path: ["objects", index, "parentId"],
14903
+ message: `parent cycle through object "${cursor.id}"`
14904
+ });
14905
+ break;
14906
+ }
14907
+ seen.add(cursor.id);
14908
+ depth += 1;
14909
+ if (depth > SCENE3D_LIMITS.maxHierarchyDepth) {
14910
+ issues.push({
14911
+ path: ["objects", index, "parentId"],
14912
+ message: `hierarchy deeper than ${SCENE3D_LIMITS.maxHierarchyDepth} levels`
14913
+ });
14914
+ break;
14915
+ }
14916
+ cursor = cursor.parentId === void 0 ? void 0 : byId.get(cursor.parentId);
14917
+ }
14918
+ });
14919
+ plan.objects.forEach((object, index) => {
14920
+ if (object.keyframes && object.keyframes.length > 0) {
14921
+ checkKeyframeTrack(object.keyframes, plan.durationInFrames, ["objects", index, "keyframes"], issues);
14922
+ }
14923
+ });
14924
+ if (plan.camera.keyframes && plan.camera.keyframes.length > 0) {
14925
+ checkKeyframeTrack(plan.camera.keyframes, plan.durationInFrames, ["camera", "keyframes"], issues);
14926
+ }
14927
+ const referenceIds = /* @__PURE__ */ new Set();
14928
+ (plan.references ?? []).forEach((reference, index) => {
14929
+ if (referenceIds.has(reference.id)) {
14930
+ issues.push({ path: ["references", index, "id"], message: `duplicate reference id "${reference.id}"` });
14931
+ }
14932
+ referenceIds.add(reference.id);
14933
+ if (reference.objectId !== void 0 && !byId.has(reference.objectId)) {
14934
+ issues.push({
14935
+ path: ["references", index, "objectId"],
14936
+ message: `reference "${reference.id}" points at unknown object "${reference.objectId}"`
14937
+ });
14938
+ }
14939
+ if (reference.startSeconds !== void 0 && reference.endSeconds !== void 0 && reference.endSeconds <= reference.startSeconds) {
14940
+ issues.push({
14941
+ path: ["references", index, "endSeconds"],
14942
+ message: `reference "${reference.id}" ends at or before it starts`
14943
+ });
14944
+ }
14945
+ if (reference.kind === "image" && (reference.startSeconds !== void 0 || reference.endSeconds !== void 0)) {
14946
+ issues.push({
14947
+ path: ["references", index, "startSeconds"],
14948
+ message: `reference "${reference.id}" is an image; a time window applies to video only`
14949
+ });
14950
+ }
14951
+ });
14952
+ return issues;
14953
+ }
14954
+ var scene3DPlanV1ObjectSchema = z.object({
14955
+ planType: z.literal(SCENE3D_PLAN_TYPE),
14956
+ schemaVersion: z.literal(SCENE3D_SCHEMA_VERSION),
14957
+ revisionId: z.uuid(),
14958
+ parentRevisionId: z.uuid().optional(),
14959
+ width: z.number().int().min(SCENE3D_LIMITS.minDimensionPx).max(SCENE3D_LIMITS.maxDimensionPx),
14960
+ height: z.number().int().min(SCENE3D_LIMITS.minDimensionPx).max(SCENE3D_LIMITS.maxDimensionPx),
14961
+ fps: z.number().int().min(SCENE3D_LIMITS.minFps).max(SCENE3D_LIMITS.maxFps),
14962
+ durationInFrames: z.number().int().min(SCENE3D_LIMITS.minDurationInFrames).max(SCENE3D_LIMITS.maxDurationInFrames),
14963
+ backgroundColor: scene3DColorSchema,
14964
+ camera: scene3DCameraSchema,
14965
+ objects: z.array(scene3DObjectSchema).min(SCENE3D_LIMITS.minObjects).max(SCENE3D_LIMITS.maxObjects),
14966
+ lighting: scene3DLightingSchema,
14967
+ references: z.array(scene3DReferenceSchema).max(SCENE3D_LIMITS.maxReferences).optional()
14968
+ }).strict();
14969
+ var scene3DPlanV1Schema = scene3DPlanV1ObjectSchema.superRefine((plan, ctx) => {
14970
+ for (const issue2 of scene3DPlanV1Issues(plan)) {
14971
+ ctx.addIssue({ code: "custom", path: issue2.path, message: issue2.message });
14972
+ }
14973
+ });
14974
+ var scene3DPlanSchema = scene3DPlanV1Schema;
14975
+ var scene3DPlanIssues = scene3DPlanV1Issues;
14976
+ function scene3DDeepEqual(a, b) {
14977
+ if (a === b) return true;
14978
+ if (typeof a !== typeof b) return false;
14979
+ if (a === null || b === null || typeof a !== "object") return false;
14980
+ if (Array.isArray(a) !== Array.isArray(b)) return false;
14981
+ if (Array.isArray(a) && Array.isArray(b)) {
14982
+ if (a.length !== b.length) return false;
14983
+ return a.every((item, i) => scene3DDeepEqual(item, b[i]));
14984
+ }
14985
+ const aObj = a;
14986
+ const bObj = b;
14987
+ const aKeys = Object.keys(aObj);
14988
+ const bKeys = Object.keys(bObj);
14989
+ if (aKeys.length !== bKeys.length) return false;
14990
+ return aKeys.every((key) => key in bObj && scene3DDeepEqual(aObj[key], bObj[key]));
14991
+ }
14992
+ function newScene3DRevisionId() {
14993
+ const webCrypto = globalThis.crypto;
14994
+ if (webCrypto && typeof webCrypto.randomUUID === "function") return webCrypto.randomUUID();
14995
+ const bytes = new Uint8Array(16);
14996
+ if (webCrypto && typeof webCrypto.getRandomValues === "function") {
14997
+ webCrypto.getRandomValues(bytes);
14998
+ } else {
14999
+ for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
15000
+ }
15001
+ bytes[6] = bytes[6] & 15 | 64;
15002
+ bytes[8] = bytes[8] & 63 | 128;
15003
+ const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
15004
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
15005
+ }
15006
+ function isScene3DPlanV1(value) {
15007
+ return scene3DPlanV1Schema.safeParse(value).success;
15008
+ }
15009
+ var SCENE3D_PLAN_FIELD = "scenePlan";
15010
+ var SCENE3D_GENERATE_NODE_TYPE = "generate-3d-scene";
15011
+ var SCENE3D_EDIT_NODE_TYPE = "edit-3d-scene";
15012
+ var scene3DObjectChangesSchema = z.object({
15013
+ name: z.string().min(1).max(SCENE3D_LIMITS.maxNameLength).optional(),
15014
+ primitive: scene3DPrimitiveSchema.optional(),
15015
+ /** `null` detaches from the parent; omitted leaves it as-is. */
15016
+ parentId: scene3DIdSchema.nullable().optional(),
15017
+ dimensions: sizeVec3Schema.optional(),
15018
+ position: vec3Schema.optional(),
15019
+ rotation: rotationVec3Schema.optional(),
15020
+ scale: scaleVec3Schema.optional(),
15021
+ color: scene3DColorSchema.optional(),
15022
+ keyframes: z.array(scene3DObjectKeyframeSchema).max(SCENE3D_LIMITS.maxKeyframes).optional()
15023
+ }).strict();
15024
+ var scene3DCameraChangesSchema = z.object({
15025
+ position: vec3Schema.optional(),
15026
+ target: vec3Schema.optional(),
15027
+ focalLengthMm: z.number().min(SCENE3D_LIMITS.minFocalLengthMm).max(SCENE3D_LIMITS.maxFocalLengthMm).optional(),
15028
+ sensorWidthMm: z.number().min(SCENE3D_LIMITS.minSensorWidthMm).max(SCENE3D_LIMITS.maxSensorWidthMm).optional(),
15029
+ keyframes: z.array(scene3DCameraKeyframeSchema).max(SCENE3D_LIMITS.maxKeyframes).optional()
15030
+ }).strict();
15031
+ var scene3DLightingChangesSchema = z.object({
15032
+ ambientIntensity: z.number().min(0).max(SCENE3D_LIMITS.maxIntensity).optional(),
15033
+ keyIntensity: z.number().min(0).max(SCENE3D_LIMITS.maxIntensity).optional(),
15034
+ keyPosition: vec3Schema.optional()
15035
+ }).strict();
15036
+ var scene3DEditOperationSchema = z.discriminatedUnion("op", [
15037
+ z.object({ op: z.literal("set-object"), objectId: scene3DIdSchema, changes: scene3DObjectChangesSchema }).strict(),
15038
+ z.object({ op: z.literal("add-object"), object: scene3DObjectSchema }).strict(),
15039
+ z.object({ op: z.literal("remove-object"), objectId: scene3DIdSchema }).strict(),
15040
+ z.object({ op: z.literal("set-camera"), changes: scene3DCameraChangesSchema }).strict(),
15041
+ z.object({ op: z.literal("set-lighting"), changes: scene3DLightingChangesSchema }).strict(),
15042
+ z.object({ op: z.literal("set-background"), color: scene3DColorSchema }).strict()
15043
+ ]);
15044
+ var scene3DEditOperationsSchema = z.array(scene3DEditOperationSchema).min(1).max(SCENE3D_LIMITS.maxOperations);
15045
+ function clonePlan(plan) {
15046
+ return JSON.parse(JSON.stringify(plan));
15047
+ }
15048
+ function summarizeScene3DOperations(operations) {
15049
+ const lines = operations.map((operation) => {
15050
+ switch (operation.op) {
15051
+ case "set-object": {
15052
+ const fields = Object.keys(operation.changes);
15053
+ return `Updated ${fields.length > 0 ? fields.join(", ") : "nothing"} on "${operation.objectId}"`;
15054
+ }
15055
+ case "add-object":
15056
+ return `Added ${operation.object.primitive} "${operation.object.name}" (${operation.object.id})`;
15057
+ case "remove-object":
15058
+ return `Removed "${operation.objectId}"`;
15059
+ case "set-camera":
15060
+ return `Updated camera ${Object.keys(operation.changes).join(", ") || "nothing"}`;
15061
+ case "set-lighting":
15062
+ return `Updated lighting ${Object.keys(operation.changes).join(", ") || "nothing"}`;
15063
+ case "set-background":
15064
+ return `Set background to ${operation.color}`;
15065
+ }
15066
+ });
15067
+ return lines.join("; ").slice(0, SCENE3D_LIMITS.maxChangeSummaryLength);
15068
+ }
15069
+ function firstIssueMessage(error) {
15070
+ const issue2 = error.issues[0];
15071
+ if (!issue2) return "invalid";
15072
+ const path = issue2.path.join(".");
15073
+ return path ? `${path}: ${issue2.message}` : issue2.message;
15074
+ }
15075
+ function applyScene3DEditOperations(plan, operations, options = {}) {
15076
+ const parsedPlan = scene3DPlanV1Schema.safeParse(plan);
15077
+ if (!parsedPlan.success) {
15078
+ return { ok: false, code: "invalid_plan", message: `scenePlan is invalid \u2014 ${firstIssueMessage(parsedPlan.error)}` };
15079
+ }
15080
+ const source = parsedPlan.data;
15081
+ if (options.expectedRevisionId !== void 0 && options.expectedRevisionId !== source.revisionId) {
15082
+ return {
15083
+ ok: false,
15084
+ code: "stale_revision",
15085
+ message: `This scene has moved on \u2014 expected revision ${options.expectedRevisionId}, the plan is at ${source.revisionId}.`
15086
+ };
15087
+ }
15088
+ const parsedOps = scene3DEditOperationsSchema.safeParse(operations);
15089
+ if (!parsedOps.success) {
15090
+ const issue2 = parsedOps.error.issues[0];
15091
+ const index = typeof issue2?.path[0] === "number" ? issue2.path[0] : void 0;
15092
+ return {
15093
+ ok: false,
15094
+ code: "invalid_operations",
15095
+ message: `operations are invalid \u2014 ${firstIssueMessage(parsedOps.error)}`,
15096
+ ...index === void 0 ? {} : { operationIndex: index }
15097
+ };
15098
+ }
15099
+ const ops = parsedOps.data;
15100
+ const next = clonePlan(source);
15101
+ const changed = /* @__PURE__ */ new Set();
15102
+ for (let index = 0; index < ops.length; index++) {
15103
+ const operation = ops[index];
15104
+ switch (operation.op) {
15105
+ case "set-object": {
15106
+ const target = next.objects.findIndex((o) => o.id === operation.objectId);
15107
+ if (target === -1) {
15108
+ return {
15109
+ ok: false,
15110
+ code: "unknown_object",
15111
+ message: `no object "${operation.objectId}" in this scene`,
15112
+ operationIndex: index
15113
+ };
15114
+ }
15115
+ const { parentId, ...rest } = operation.changes;
15116
+ const updated = { ...next.objects[target], ...rest };
15117
+ if (parentId !== void 0) {
15118
+ if (parentId === null) delete updated.parentId;
15119
+ else updated.parentId = parentId;
15120
+ }
15121
+ next.objects = next.objects.map((o, i) => i === target ? updated : o);
15122
+ changed.add(operation.objectId);
15123
+ break;
15124
+ }
15125
+ case "add-object": {
15126
+ if (next.objects.some((o) => o.id === operation.object.id)) {
15127
+ return {
15128
+ ok: false,
15129
+ code: "duplicate_object",
15130
+ message: `an object with id "${operation.object.id}" already exists`,
15131
+ operationIndex: index
15132
+ };
15133
+ }
15134
+ next.objects = [...next.objects, operation.object];
15135
+ changed.add(operation.object.id);
15136
+ break;
15137
+ }
15138
+ case "remove-object": {
15139
+ if (!next.objects.some((o) => o.id === operation.objectId)) {
15140
+ return {
15141
+ ok: false,
15142
+ code: "unknown_object",
15143
+ message: `no object "${operation.objectId}" in this scene`,
15144
+ operationIndex: index
15145
+ };
15146
+ }
15147
+ next.objects = next.objects.filter((o) => o.id !== operation.objectId);
15148
+ changed.add(operation.objectId);
15149
+ break;
15150
+ }
15151
+ case "set-camera":
15152
+ next.camera = { ...next.camera, ...operation.changes };
15153
+ break;
15154
+ case "set-lighting":
15155
+ next.lighting = { ...next.lighting, ...operation.changes };
15156
+ break;
15157
+ case "set-background":
15158
+ next.backgroundColor = operation.color;
15159
+ break;
15160
+ }
15161
+ }
15162
+ for (const lockedId of options.lockedObjectIds ?? []) {
15163
+ const before = source.objects.find((o) => o.id === lockedId);
15164
+ const after = next.objects.find((o) => o.id === lockedId);
15165
+ if (before === void 0) continue;
15166
+ if (after === void 0) {
15167
+ return { ok: false, code: "locked_object", message: `object "${lockedId}" is locked and cannot be removed` };
15168
+ }
15169
+ if (!scene3DDeepEqual(before, after)) {
15170
+ return { ok: false, code: "locked_object", message: `object "${lockedId}" is locked and cannot be modified` };
15171
+ }
15172
+ }
15173
+ next.parentRevisionId = source.revisionId;
15174
+ next.revisionId = options.revisionId ?? newScene3DRevisionId();
15175
+ const validated = scene3DPlanV1Schema.safeParse(next);
15176
+ if (!validated.success) {
15177
+ return {
15178
+ ok: false,
15179
+ code: "invalid_plan",
15180
+ message: `the edit would leave the scene invalid \u2014 ${firstIssueMessage(validated.error)}`
15181
+ };
15182
+ }
15183
+ return {
15184
+ ok: true,
15185
+ plan: validated.data,
15186
+ changedObjectIds: [...changed],
15187
+ changeSummary: summarizeScene3DOperations(ops)
15188
+ };
15189
+ }
15190
+ var SCENE3D_SCHEMA_VERSION_V2 = 2;
15191
+ var SCENE3D_SUPPORTED_SCHEMA_VERSIONS = [1, 2];
15192
+ var SCENE3D_V2_ENGINES = ["blender-cloud", "blender-local"];
15193
+ var SCENE3D_V2_LIMITS = {
15194
+ /** Both the seconds and the frame ceiling apply; neither waives the other. */
15195
+ maxDurationSeconds: 60,
15196
+ minDurationInFrames: 1,
15197
+ maxDurationInFrames: 3600,
15198
+ minFps: 15,
15199
+ maxFps: 60,
15200
+ defaultFps: 24,
15201
+ /** Even integers only — an odd axis breaks H.264 chroma subsampling. */
15202
+ minDimensionPx: 100,
15203
+ maxDimensionPx: 1920,
15204
+ minEntities: 1,
15205
+ /** SEMANTIC entities, not exported mesh nodes. */
15206
+ maxEntities: 100,
15207
+ /** Enforced during asset normalization, after decode — see
15208
+ * `scene3DV2NormalizationIssues` in `scene3d-v2-resources.ts`. */
15209
+ maxMeshNodes: 2e3,
15210
+ maxTriangles: 2e5,
15211
+ maxHierarchyDepth: 16,
15212
+ /** Decoded manifest JSON. Measured on the bytes, before `JSON.parse`. */
15213
+ maxManifestBytes: 512 * 1024,
15214
+ /** Decoded camera-track JSON. */
15215
+ maxCameraTrackBytes: 8 * 1024 * 1024,
15216
+ /** Total DECLARED bytes of the assets the renderer downloads. Compression
15217
+ * does not waive the decoded geometry limits above. */
15218
+ maxRendererAssetBytes: 64 * 1024 * 1024,
15219
+ /** A `blend-source` is a separately authorized download, never handed to the
15220
+ * browser renderer, and therefore not part of the renderer budget. */
15221
+ maxBlendSourceBytes: 512 * 1024 * 1024,
15222
+ maxAssets: 64,
15223
+ maxShots: 32,
15224
+ maxShotEntityIds: 16,
15225
+ /** v1's reference limit, unchanged until deliberately expanded. */
15226
+ maxReferences: SCENE3D_LIMITS.maxReferences,
15227
+ maxAnchorsPerEntity: 32,
15228
+ maxMaterialBindingsPerEntity: 16,
15229
+ maxOverrides: 200,
15230
+ minPosterDimensionPx: 16,
15231
+ maxPosterDimensionPx: 4096,
15232
+ maxIdLength: SCENE3D_LIMITS.maxIdLength,
15233
+ maxAssetIdLength: 128,
15234
+ maxNodeIdLength: 128,
15235
+ maxNameLength: SCENE3D_LIMITS.maxNameLength,
15236
+ maxLabelLength: SCENE3D_LIMITS.maxNameLength,
15237
+ maxMaterialNameLength: 120,
15238
+ maxVersionLength: 64,
15239
+ maxCoordinate: SCENE3D_LIMITS.maxCoordinate,
15240
+ minSize: SCENE3D_LIMITS.minSize,
15241
+ maxSize: SCENE3D_LIMITS.maxSize,
15242
+ maxIntensity: SCENE3D_LIMITS.maxIntensity
15243
+ };
15244
+ var SCENE3D_V2_OVERRIDE_OPERATION_VERSION = 1;
15245
+ var SCENE3D_GLB_EXTRAS_ENTITY_ID = "nodaroEntityId";
15246
+ var SCENE3D_GLB_EXTRAS_SUBPART_ID = "nodaroSubpartId";
15247
+ var SCENE3D_GLB_EXTRAS_MATERIAL_ROLE = "nodaroMaterialRole";
15248
+ var SCENE3D_GLB_EXTRAS_ALLOWLIST = [
15249
+ SCENE3D_GLB_EXTRAS_ENTITY_ID,
15250
+ SCENE3D_GLB_EXTRAS_SUBPART_ID,
15251
+ SCENE3D_GLB_EXTRAS_MATERIAL_ROLE
15252
+ ];
15253
+ var SCENE3D_ENTITY_ROLES = [
15254
+ "person",
15255
+ "vehicle",
15256
+ "prop",
15257
+ "environment",
15258
+ "other"
15259
+ ];
15260
+ var SCENE3D_V2_PRIMITIVES = [
15261
+ "box",
15262
+ "sphere",
15263
+ "cylinder",
15264
+ "cone",
15265
+ "plane",
15266
+ "capsule"
15267
+ ];
15268
+ var SCENE3D_ENTITY_CAPABILITIES = [
15269
+ "transform",
15270
+ "color",
15271
+ "visibility"
15272
+ ];
15273
+ var SCENE3D_DEFAULT_ENTITY_CAPABILITIES = SCENE3D_ENTITY_CAPABILITIES;
15274
+ var SCENE3D_ASSET_KINDS = [
15275
+ "glb",
15276
+ "camera-track-json",
15277
+ "poster",
15278
+ "validation-report",
15279
+ "blend-source"
15280
+ ];
15281
+ var SCENE3D_ASSET_ROLES = [
15282
+ "scene-geometry",
15283
+ "entity-geometry",
15284
+ "camera-track",
15285
+ "poster",
15286
+ "validation-report",
15287
+ "source"
15288
+ ];
15289
+ var SCENE3D_ASSET_ROLE_KINDS = {
15290
+ "scene-geometry": "glb",
15291
+ "entity-geometry": "glb",
15292
+ "camera-track": "camera-track-json",
15293
+ poster: "poster",
15294
+ "validation-report": "validation-report",
15295
+ source: "blend-source"
15296
+ };
15297
+ var SCENE3D_RENDERER_ASSET_KINDS = [
15298
+ "glb",
15299
+ "camera-track-json",
15300
+ "poster"
15301
+ ];
15302
+ var SCENE3D_PRIMITIVE_MATERIAL_ROLE = "identity";
15303
+ var SCENE3D_CLAY_LIGHTING_PRESETS = ["clay-studio-v1"];
15304
+ var scene3DAssetIdSchema = z.string().min(1).max(SCENE3D_V2_LIMITS.maxAssetIdLength).regex(/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/, "assetId must be an opaque id (letters, digits, '_', '-', '.', ':')").refine((value) => !value.includes(".."), "assetId must not contain '..'");
15305
+ var scene3DNodeIdSchema = z.string().min(1).max(SCENE3D_V2_LIMITS.maxNodeIdLength).regex(/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/, "node id must be an exporter-generated stable id");
15306
+ var scene3DSha256Schema = z.string().regex(/^[0-9a-f]{64}$/, "sha256 must be 64 lowercase hex characters");
15307
+ var scene3DVersionTokenSchema = z.string().min(1).max(SCENE3D_V2_LIMITS.maxVersionLength).regex(
15308
+ /^[A-Za-z0-9][A-Za-z0-9_.+-]*$/,
15309
+ "version must be a bounded token (letters, digits, '_', '-', '.', '+') \u2014 never a path or prose"
15310
+ );
15311
+ var scene3DEngineIdSchema = z.string().min(1).max(SCENE3D_V2_LIMITS.maxVersionLength).regex(/^[a-z0-9][a-z0-9-]*$/, "engine must be a lowercase slug such as blender-cloud");
15312
+ var scene3DAnchorNameSchema = scene3DIdSchema;
15313
+ var scene3DMaterialRoleSchema = scene3DIdSchema;
15314
+ var scene3DMaterialNameSchema = z.string().min(1).max(SCENE3D_V2_LIMITS.maxMaterialNameLength).regex(/^[^\u0000-\u001f\u007f]+$/, "material name must not contain control characters");
15315
+ var v2FrameSchema = z.number().int().min(0).max(SCENE3D_V2_LIMITS.maxDurationInFrames);
15316
+ var scene3DEntityCapabilitySchema = z.enum(["transform", "color", "visibility"]);
15317
+ var scene3DAnchorSchema = z.object({
15318
+ name: scene3DAnchorNameSchema,
15319
+ position: vec3Schema,
15320
+ rotation: rotationVec3Schema.optional()
15321
+ }).strict();
15322
+ var scene3DMaterialBindingSchema = z.object({
15323
+ role: scene3DMaterialRoleSchema,
15324
+ materialName: scene3DMaterialNameSchema,
15325
+ color: scene3DColorSchema.optional(),
15326
+ roughness: z.number().min(0).max(1).optional()
15327
+ }).strict();
15328
+ var scene3DAssetAnimationSchema = z.object({
15329
+ clipName: z.string().min(1).max(SCENE3D_V2_LIMITS.maxNameLength),
15330
+ startFrame: v2FrameSchema,
15331
+ endFrameExclusive: z.number().int().min(1).max(SCENE3D_V2_LIMITS.maxDurationInFrames),
15332
+ loop: z.boolean().optional()
15333
+ }).strict();
15334
+ var scene3DEntityVisualSchema = z.discriminatedUnion("kind", [
15335
+ z.object({ kind: z.literal("group") }).strict(),
15336
+ z.object({
15337
+ kind: z.literal("primitive"),
15338
+ primitive: z.enum(["box", "sphere", "cylinder", "cone", "plane", "capsule"]),
15339
+ dimensions: sizeVec3Schema,
15340
+ color: scene3DColorSchema
15341
+ }).strict(),
15342
+ z.object({
15343
+ kind: z.literal("asset"),
15344
+ assetId: scene3DAssetIdSchema,
15345
+ rootNodeId: scene3DNodeIdSchema,
15346
+ animation: scene3DAssetAnimationSchema.optional()
15347
+ }).strict()
15348
+ ]);
15349
+ var scene3DEntityV2Schema = z.object({
15350
+ id: scene3DIdSchema,
15351
+ name: z.string().min(1).max(SCENE3D_V2_LIMITS.maxNameLength),
15352
+ parentId: scene3DIdSchema.optional(),
15353
+ role: z.enum(["person", "vehicle", "prop", "environment", "other"]).optional(),
15354
+ position: vec3Schema.optional(),
15355
+ rotation: rotationVec3Schema.optional(),
15356
+ scale: scaleVec3Schema.optional(),
15357
+ identityColor: scene3DColorSchema.optional(),
15358
+ anchors: z.array(scene3DAnchorSchema).max(SCENE3D_V2_LIMITS.maxAnchorsPerEntity).optional(),
15359
+ capabilities: z.array(scene3DEntityCapabilitySchema).max(SCENE3D_ENTITY_CAPABILITIES.length).optional(),
15360
+ locks: z.array(scene3DEntityCapabilitySchema).max(SCENE3D_ENTITY_CAPABILITIES.length).optional(),
15361
+ materialBindings: z.array(scene3DMaterialBindingSchema).max(SCENE3D_V2_LIMITS.maxMaterialBindingsPerEntity).optional(),
15362
+ visual: scene3DEntityVisualSchema
15363
+ }).strict();
15364
+ var scene3DAssetRefSchema = z.object({
15365
+ assetId: scene3DAssetIdSchema,
15366
+ kind: z.enum(["glb", "camera-track-json", "poster", "validation-report", "blend-source"]),
15367
+ role: z.enum(["scene-geometry", "entity-geometry", "camera-track", "poster", "validation-report", "source"]),
15368
+ byteLength: z.number().int().min(1).max(SCENE3D_V2_LIMITS.maxBlendSourceBytes),
15369
+ sha256: scene3DSha256Schema,
15370
+ originRevisionId: z.uuid().optional()
15371
+ }).strict();
15372
+ var scene3DShotSchema = z.object({
15373
+ id: scene3DIdSchema,
15374
+ startFrame: v2FrameSchema,
15375
+ endFrameExclusive: z.number().int().min(1).max(SCENE3D_V2_LIMITS.maxDurationInFrames),
15376
+ label: z.string().min(1).max(SCENE3D_V2_LIMITS.maxLabelLength).optional(),
15377
+ subjectEntityIds: z.array(scene3DIdSchema).max(SCENE3D_V2_LIMITS.maxShotEntityIds).optional(),
15378
+ foregroundEntityIds: z.array(scene3DIdSchema).max(SCENE3D_V2_LIMITS.maxShotEntityIds).optional()
15379
+ }).strict();
15380
+ var scene3DClayLightingSchema = z.object({
15381
+ preset: z.enum(SCENE3D_CLAY_LIGHTING_PRESETS),
15382
+ ambientIntensity: z.number().min(0).max(SCENE3D_V2_LIMITS.maxIntensity),
15383
+ keyIntensity: z.number().min(0).max(SCENE3D_V2_LIMITS.maxIntensity),
15384
+ keyPosition: vec3Schema
15385
+ }).strict();
15386
+ var overrideProvenanceShape = {
15387
+ id: scene3DIdSchema,
15388
+ sourceRevisionId: z.uuid(),
15389
+ sourceContentHash: scene3DSha256Schema,
15390
+ operationVersion: z.number().int().min(1).max(255)
15391
+ };
15392
+ var scene3DOverrideSchema = z.discriminatedUnion("kind", [
15393
+ z.object({
15394
+ ...overrideProvenanceShape,
15395
+ kind: z.literal("entity-transform"),
15396
+ entityId: scene3DIdSchema,
15397
+ space: z.enum(["local", "world"]),
15398
+ position: vec3Schema.optional(),
15399
+ rotation: rotationVec3Schema.optional(),
15400
+ scale: scaleVec3Schema.optional()
15401
+ }).strict(),
15402
+ z.object({
15403
+ ...overrideProvenanceShape,
15404
+ kind: z.literal("entity-color"),
15405
+ entityId: scene3DIdSchema,
15406
+ materialRole: scene3DMaterialRoleSchema,
15407
+ color: scene3DColorSchema
15408
+ }).strict(),
15409
+ z.object({
15410
+ ...overrideProvenanceShape,
15411
+ kind: z.literal("entity-visibility"),
15412
+ entityId: scene3DIdSchema,
15413
+ visible: z.boolean()
15414
+ }).strict(),
15415
+ z.object({
15416
+ ...overrideProvenanceShape,
15417
+ kind: z.literal("camera-shot-offset"),
15418
+ shotId: scene3DIdSchema,
15419
+ positionOffset: vec3Schema.optional(),
15420
+ targetOffset: vec3Schema.optional()
15421
+ }).strict()
15422
+ ]);
15423
+ var scene3DProvenanceSchema = z.object({
15424
+ engine: scene3DEngineIdSchema,
15425
+ engineVersion: scene3DVersionTokenSchema,
15426
+ recipeVersion: scene3DVersionTokenSchema,
15427
+ compilerVersion: scene3DVersionTokenSchema,
15428
+ exporterVersion: scene3DVersionTokenSchema,
15429
+ rendererVersion: scene3DVersionTokenSchema,
15430
+ sourceRevisionId: z.uuid().optional(),
15431
+ sourceArtifactId: scene3DAssetIdSchema.optional(),
15432
+ contentHash: scene3DSha256Schema
15433
+ }).strict();
15434
+ function scene3DJsonByteLength(text) {
15435
+ return new TextEncoder().encode(text).length;
15436
+ }
15437
+ function scene3DZodIssues(error) {
15438
+ return error.issues.map((issue2) => ({ path: [...issue2.path], message: issue2.message }));
15439
+ }
15440
+ function entityCapabilities(entity) {
15441
+ return entity.capabilities ?? SCENE3D_DEFAULT_ENTITY_CAPABILITIES;
15442
+ }
15443
+ function scene3DEntityAcceptsOverlay(entity, capability2) {
15444
+ return entityCapabilities(entity).includes(capability2) && !(entity.locks ?? []).includes(capability2);
15445
+ }
15446
+ function checkEntities(plan, byId, issues) {
15447
+ const rootNodeOwners = /* @__PURE__ */ new Map();
15448
+ plan.objects.forEach((entity, index) => {
15449
+ const at = (...rest) => ["objects", index, ...rest];
15450
+ if (entity.visual.kind !== "asset") {
15451
+ for (const field of ["position", "rotation", "scale"]) {
15452
+ if (entity[field] === void 0) {
15453
+ issues.push({
15454
+ path: at(field),
15455
+ message: `entity "${entity.id}" is a ${entity.visual.kind} and must declare ${field}`
15456
+ });
15457
+ }
15458
+ }
15459
+ }
15460
+ if (entity.visual.kind === "asset") {
15461
+ const owner = rootNodeOwners.get(entity.visual.rootNodeId);
15462
+ if (owner !== void 0) {
15463
+ issues.push({
15464
+ path: at("visual", "rootNodeId"),
15465
+ message: `root node "${entity.visual.rootNodeId}" is already the root of entity "${owner}"`
15466
+ });
15467
+ } else {
15468
+ rootNodeOwners.set(entity.visual.rootNodeId, entity.id);
15469
+ }
15470
+ const animation = entity.visual.animation;
15471
+ if (animation) {
15472
+ if (animation.endFrameExclusive <= animation.startFrame) {
15473
+ issues.push({
15474
+ path: at("visual", "animation", "endFrameExclusive"),
15475
+ message: `entity "${entity.id}" animation ends at or before it starts`
15476
+ });
15477
+ }
15478
+ if (animation.endFrameExclusive > plan.durationInFrames) {
15479
+ issues.push({
15480
+ path: at("visual", "animation", "endFrameExclusive"),
15481
+ message: `entity "${entity.id}" animation runs past the scene (${plan.durationInFrames} frames)`
15482
+ });
15483
+ }
15484
+ }
15485
+ } else if (entity.materialBindings && entity.materialBindings.length > 0) {
15486
+ issues.push({
15487
+ path: at("materialBindings"),
15488
+ message: `entity "${entity.id}" is a ${entity.visual.kind}; material bindings name materials in an asset root`
15489
+ });
15490
+ }
15491
+ const roles = /* @__PURE__ */ new Set();
15492
+ (entity.materialBindings ?? []).forEach((binding, bindingIndex) => {
15493
+ if (roles.has(binding.role)) {
15494
+ issues.push({
15495
+ path: at("materialBindings", bindingIndex, "role"),
15496
+ message: `entity "${entity.id}" binds material role "${binding.role}" twice`
15497
+ });
15498
+ }
15499
+ roles.add(binding.role);
15500
+ });
15501
+ const anchorNames = /* @__PURE__ */ new Set();
15502
+ (entity.anchors ?? []).forEach((anchor, anchorIndex) => {
15503
+ if (anchorNames.has(anchor.name)) {
15504
+ issues.push({
15505
+ path: at("anchors", anchorIndex, "name"),
15506
+ message: `entity "${entity.id}" declares anchor "${anchor.name}" twice`
15507
+ });
15508
+ }
15509
+ anchorNames.add(anchor.name);
15510
+ });
15511
+ });
15512
+ plan.objects.forEach((entity, index) => {
15513
+ if (entity.parentId === void 0) return;
15514
+ if (entity.parentId === entity.id) {
15515
+ issues.push({ path: ["objects", index, "parentId"], message: `entity "${entity.id}" cannot parent itself` });
15516
+ return;
15517
+ }
15518
+ if (!byId.has(entity.parentId)) {
15519
+ issues.push({
15520
+ path: ["objects", index, "parentId"],
15521
+ message: `entity "${entity.id}" references unknown parent "${entity.parentId}"`
15522
+ });
15523
+ return;
15524
+ }
15525
+ const seen = /* @__PURE__ */ new Set([entity.id]);
15526
+ let cursor = byId.get(entity.parentId);
15527
+ let depth = 1;
15528
+ while (cursor) {
15529
+ if (seen.has(cursor.id)) {
15530
+ issues.push({ path: ["objects", index, "parentId"], message: `parent cycle through entity "${cursor.id}"` });
15531
+ break;
15532
+ }
15533
+ seen.add(cursor.id);
15534
+ depth += 1;
15535
+ if (depth > SCENE3D_V2_LIMITS.maxHierarchyDepth) {
15536
+ issues.push({
15537
+ path: ["objects", index, "parentId"],
15538
+ message: `hierarchy deeper than ${SCENE3D_V2_LIMITS.maxHierarchyDepth} levels`
15539
+ });
15540
+ break;
15541
+ }
15542
+ cursor = cursor.parentId === void 0 ? void 0 : byId.get(cursor.parentId);
15543
+ }
15544
+ });
15545
+ }
15546
+ function checkAssets(plan, assetsById, issues) {
15547
+ let rendererBytes = 0;
15548
+ let sourceCount = 0;
15549
+ plan.assets.forEach((asset, index) => {
15550
+ const at = (...rest) => ["assets", index, ...rest];
15551
+ const expectedKind = SCENE3D_ASSET_ROLE_KINDS[asset.role];
15552
+ if (asset.kind !== expectedKind) {
15553
+ issues.push({
15554
+ path: at("kind"),
15555
+ message: `asset "${asset.assetId}" has role "${asset.role}", which requires kind "${expectedKind}" (got "${asset.kind}")`
15556
+ });
15557
+ }
15558
+ if (asset.kind === "camera-track-json" && asset.byteLength > SCENE3D_V2_LIMITS.maxCameraTrackBytes) {
15559
+ issues.push({
15560
+ path: at("byteLength"),
15561
+ message: `camera track "${asset.assetId}" is ${asset.byteLength} bytes; the limit is ${SCENE3D_V2_LIMITS.maxCameraTrackBytes}`
15562
+ });
15563
+ }
15564
+ if (SCENE3D_RENDERER_ASSET_KINDS.includes(asset.kind)) {
15565
+ rendererBytes += asset.byteLength;
15566
+ if (asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
15567
+ issues.push({
15568
+ path: at("byteLength"),
15569
+ message: `asset "${asset.assetId}" is ${asset.byteLength} bytes; a downloaded scene asset may not exceed ${SCENE3D_V2_LIMITS.maxRendererAssetBytes}`
15570
+ });
15571
+ }
15572
+ }
15573
+ if (asset.kind === "blend-source") {
15574
+ sourceCount += 1;
15575
+ if (sourceCount > 1) {
15576
+ issues.push({ path: at("kind"), message: "a revision may retain at most one blend-source asset" });
15577
+ }
15578
+ }
15579
+ });
15580
+ if (rendererBytes > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
15581
+ issues.push({
15582
+ path: ["assets"],
15583
+ message: `downloaded scene assets total ${rendererBytes} bytes; the limit is ${SCENE3D_V2_LIMITS.maxRendererAssetBytes}`
15584
+ });
15585
+ }
15586
+ const track = assetsById.get(plan.cameraTrackAssetId);
15587
+ if (!track) {
15588
+ issues.push({
15589
+ path: ["cameraTrackAssetId"],
15590
+ message: `cameraTrackAssetId "${plan.cameraTrackAssetId}" is not in assets`
15591
+ });
15592
+ } else if (track.kind !== "camera-track-json") {
15593
+ issues.push({
15594
+ path: ["cameraTrackAssetId"],
15595
+ message: `cameraTrackAssetId "${plan.cameraTrackAssetId}" is kind "${track.kind}"; a camera track must be camera-track-json`
15596
+ });
15597
+ }
15598
+ const referencedGlbs = /* @__PURE__ */ new Set();
15599
+ for (const entity of plan.objects) {
15600
+ if (entity.visual.kind === "asset") referencedGlbs.add(entity.visual.assetId);
15601
+ }
15602
+ plan.assets.forEach((asset, index) => {
15603
+ if (asset.kind === "glb" && !referencedGlbs.has(asset.assetId)) {
15604
+ issues.push({
15605
+ path: ["assets", index, "assetId"],
15606
+ message: `glb asset "${asset.assetId}" is not referenced by any entity`
15607
+ });
15608
+ }
15609
+ });
15610
+ plan.objects.forEach((entity, index) => {
15611
+ if (entity.visual.kind !== "asset") return;
15612
+ const asset = assetsById.get(entity.visual.assetId);
15613
+ if (!asset) {
15614
+ issues.push({
15615
+ path: ["objects", index, "visual", "assetId"],
15616
+ message: `entity "${entity.id}" references unknown asset "${entity.visual.assetId}"`
15617
+ });
15618
+ } else if (asset.kind !== "glb") {
15619
+ issues.push({
15620
+ path: ["objects", index, "visual", "assetId"],
15621
+ message: `entity "${entity.id}" references asset "${asset.assetId}" of kind "${asset.kind}"; geometry must be glb`
15622
+ });
15623
+ }
15624
+ });
15625
+ if (plan.provenance.sourceArtifactId !== void 0) {
15626
+ const source = assetsById.get(plan.provenance.sourceArtifactId);
15627
+ if (!source) {
15628
+ issues.push({
15629
+ path: ["provenance", "sourceArtifactId"],
15630
+ message: `sourceArtifactId "${plan.provenance.sourceArtifactId}" is not in assets`
15631
+ });
15632
+ } else if (source.kind !== "blend-source") {
15633
+ issues.push({
15634
+ path: ["provenance", "sourceArtifactId"],
15635
+ message: `sourceArtifactId "${source.assetId}" is kind "${source.kind}"; a retained source must be blend-source`
15636
+ });
15637
+ }
15638
+ }
15639
+ }
15640
+ function checkShots(plan, byId, issues) {
15641
+ const seenIds = /* @__PURE__ */ new Set();
15642
+ let expectedStart = 0;
15643
+ plan.shots.forEach((shot, index) => {
15644
+ const at = (...rest) => ["shots", index, ...rest];
15645
+ if (seenIds.has(shot.id)) {
15646
+ issues.push({ path: at("id"), message: `duplicate shot id "${shot.id}"` });
15647
+ }
15648
+ seenIds.add(shot.id);
15649
+ if (shot.endFrameExclusive <= shot.startFrame) {
15650
+ issues.push({
15651
+ path: at("endFrameExclusive"),
15652
+ message: `shot "${shot.id}" ends at or before it starts (${shot.startFrame}..${shot.endFrameExclusive})`
15653
+ });
15654
+ }
15655
+ if (shot.startFrame !== expectedStart) {
15656
+ issues.push({
15657
+ path: at("startFrame"),
15658
+ message: index === 0 ? `shots must start at frame 0 (got ${shot.startFrame})` : `shot "${shot.id}" starts at ${shot.startFrame}; the previous shot ends at ${expectedStart} \u2014 every frame belongs to exactly one shot`
15659
+ });
15660
+ }
15661
+ expectedStart = Math.max(expectedStart, shot.endFrameExclusive);
15662
+ for (const field of ["subjectEntityIds", "foregroundEntityIds"]) {
15663
+ (shot[field] ?? []).forEach((entityId, entityIndex) => {
15664
+ if (!byId.has(entityId)) {
15665
+ issues.push({
15666
+ path: at(field, entityIndex),
15667
+ message: `shot "${shot.id}" references unknown entity "${entityId}"`
15668
+ });
15669
+ }
15670
+ });
15671
+ }
15672
+ });
15673
+ const last = plan.shots[plan.shots.length - 1];
15674
+ if (last && last.endFrameExclusive !== plan.durationInFrames) {
15675
+ issues.push({
15676
+ path: ["shots", plan.shots.length - 1, "endFrameExclusive"],
15677
+ message: `shots end at frame ${last.endFrameExclusive}; the scene is ${plan.durationInFrames} frames and must be covered completely`
15678
+ });
15679
+ }
15680
+ }
15681
+ function checkOverrides(plan, byId, shotIds, issues) {
15682
+ const overrideIds = /* @__PURE__ */ new Set();
15683
+ const transformTargets = /* @__PURE__ */ new Set();
15684
+ const visibilityTargets = /* @__PURE__ */ new Set();
15685
+ const colorTargets = /* @__PURE__ */ new Set();
15686
+ const offsetTargets = /* @__PURE__ */ new Set();
15687
+ (plan.overrides ?? []).forEach((override, index) => {
15688
+ const at = (...rest) => ["overrides", index, ...rest];
15689
+ if (overrideIds.has(override.id)) {
15690
+ issues.push({ path: at("id"), message: `duplicate override id "${override.id}"` });
15691
+ }
15692
+ overrideIds.add(override.id);
15693
+ if (override.operationVersion > SCENE3D_V2_OVERRIDE_OPERATION_VERSION) {
15694
+ issues.push({
15695
+ path: at("operationVersion"),
15696
+ message: `override "${override.id}" uses operation version ${override.operationVersion}; this reader understands up to ${SCENE3D_V2_OVERRIDE_OPERATION_VERSION}`
15697
+ });
15698
+ }
15699
+ if (override.kind === "camera-shot-offset") {
15700
+ if (!shotIds.has(override.shotId)) {
15701
+ issues.push({ path: at("shotId"), message: `override "${override.id}" targets unknown shot "${override.shotId}"` });
15702
+ } else if (offsetTargets.has(override.shotId)) {
15703
+ issues.push({
15704
+ path: at("shotId"),
15705
+ message: `shot "${override.shotId}" already has a camera offset; one owner per channel`
15706
+ });
15707
+ }
15708
+ offsetTargets.add(override.shotId);
15709
+ if (override.positionOffset === void 0 && override.targetOffset === void 0) {
15710
+ issues.push({ path: at(), message: `override "${override.id}" offsets nothing` });
15711
+ }
15712
+ return;
15713
+ }
15714
+ const entity = byId.get(override.entityId);
15715
+ if (!entity) {
15716
+ issues.push({ path: at("entityId"), message: `override "${override.id}" targets unknown entity "${override.entityId}"` });
15717
+ return;
15718
+ }
15719
+ if (override.kind === "entity-transform") {
15720
+ if (transformTargets.has(override.entityId)) {
15721
+ issues.push({
15722
+ path: at("entityId"),
15723
+ message: `entity "${override.entityId}" already has a transform override; one owner per channel`
15724
+ });
15725
+ }
15726
+ transformTargets.add(override.entityId);
15727
+ if (!scene3DEntityAcceptsOverlay(entity, "transform")) {
15728
+ issues.push({
15729
+ path: at("entityId"),
15730
+ message: `entity "${override.entityId}" does not accept a transform overlay (locked or not advertised)`
15731
+ });
15732
+ }
15733
+ if (override.position === void 0 && override.rotation === void 0 && override.scale === void 0) {
15734
+ issues.push({ path: at(), message: `override "${override.id}" changes nothing` });
15735
+ }
15736
+ return;
15737
+ }
15738
+ if (override.kind === "entity-visibility") {
15739
+ if (visibilityTargets.has(override.entityId)) {
15740
+ issues.push({
15741
+ path: at("entityId"),
15742
+ message: `entity "${override.entityId}" already has a visibility override; one owner per channel`
15743
+ });
15744
+ }
15745
+ visibilityTargets.add(override.entityId);
15746
+ if (!scene3DEntityAcceptsOverlay(entity, "visibility")) {
15747
+ issues.push({
15748
+ path: at("entityId"),
15749
+ message: `entity "${override.entityId}" does not accept a visibility overlay (locked or not advertised)`
15750
+ });
15751
+ }
15752
+ return;
15753
+ }
15754
+ const key = `${override.entityId}\0${override.materialRole}`;
15755
+ if (colorTargets.has(key)) {
15756
+ issues.push({
15757
+ path: at("materialRole"),
15758
+ message: `entity "${override.entityId}" already recolours material role "${override.materialRole}"`
15759
+ });
15760
+ }
15761
+ colorTargets.add(key);
15762
+ if (!scene3DEntityAcceptsOverlay(entity, "color")) {
15763
+ issues.push({
15764
+ path: at("entityId"),
15765
+ message: `entity "${override.entityId}" does not accept a colour overlay (locked or not advertised)`
15766
+ });
15767
+ }
15768
+ if (entity.visual.kind === "group") {
15769
+ issues.push({
15770
+ path: at("materialRole"),
15771
+ message: `entity "${override.entityId}" is a group and has no geometry to recolour`
15772
+ });
15773
+ } else if (entity.visual.kind === "primitive") {
15774
+ if (override.materialRole !== SCENE3D_PRIMITIVE_MATERIAL_ROLE) {
15775
+ issues.push({
15776
+ path: at("materialRole"),
15777
+ message: `entity "${override.entityId}" is a primitive; its only material role is "${SCENE3D_PRIMITIVE_MATERIAL_ROLE}"`
15778
+ });
15779
+ }
15780
+ } else if (!(entity.materialBindings ?? []).some((binding) => binding.role === override.materialRole)) {
15781
+ issues.push({
15782
+ path: at("materialRole"),
15783
+ message: `entity "${override.entityId}" declares no material role "${override.materialRole}"; a binding may only name materials in that entity's asset root`
15784
+ });
15785
+ }
15786
+ });
15787
+ }
15788
+ function scene3DPlanV2Issues(plan) {
15789
+ const issues = [];
15790
+ const seconds = plan.durationInFrames / plan.fps;
15791
+ if (seconds > SCENE3D_V2_LIMITS.maxDurationSeconds) {
15792
+ issues.push({
15793
+ path: ["durationInFrames"],
15794
+ message: `scene is ${seconds.toFixed(2)}s; the limit is ${SCENE3D_V2_LIMITS.maxDurationSeconds}s`
15795
+ });
15796
+ }
15797
+ for (const axis of ["width", "height"]) {
15798
+ if (plan[axis] % 2 !== 0) {
15799
+ issues.push({ path: [axis], message: `${axis} must be an even number of pixels (got ${plan[axis]})` });
15800
+ }
15801
+ }
15802
+ const byId = /* @__PURE__ */ new Map();
15803
+ plan.objects.forEach((entity, index) => {
15804
+ if (byId.has(entity.id)) {
15805
+ issues.push({ path: ["objects", index, "id"], message: `duplicate entity id "${entity.id}"` });
15806
+ return;
15807
+ }
15808
+ byId.set(entity.id, entity);
15809
+ });
15810
+ const assetsById = /* @__PURE__ */ new Map();
15811
+ plan.assets.forEach((asset, index) => {
15812
+ if (assetsById.has(asset.assetId)) {
15813
+ issues.push({ path: ["assets", index, "assetId"], message: `duplicate asset id "${asset.assetId}"` });
15814
+ return;
15815
+ }
15816
+ assetsById.set(asset.assetId, asset);
15817
+ });
15818
+ checkEntities(plan, byId, issues);
15819
+ checkAssets(plan, assetsById, issues);
15820
+ checkShots(plan, byId, issues);
15821
+ checkOverrides(plan, byId, new Set(plan.shots.map((shot) => shot.id)), issues);
15822
+ const referenceIds = /* @__PURE__ */ new Set();
15823
+ (plan.references ?? []).forEach((reference, index) => {
15824
+ if (referenceIds.has(reference.id)) {
15825
+ issues.push({ path: ["references", index, "id"], message: `duplicate reference id "${reference.id}"` });
15826
+ }
15827
+ referenceIds.add(reference.id);
15828
+ if (reference.objectId !== void 0 && !byId.has(reference.objectId)) {
15829
+ issues.push({
15830
+ path: ["references", index, "objectId"],
15831
+ message: `reference "${reference.id}" points at unknown entity "${reference.objectId}"`
15832
+ });
15833
+ }
15834
+ if (reference.startSeconds !== void 0 && reference.endSeconds !== void 0 && reference.endSeconds <= reference.startSeconds) {
15835
+ issues.push({
15836
+ path: ["references", index, "endSeconds"],
15837
+ message: `reference "${reference.id}" ends at or before it starts`
15838
+ });
15839
+ }
15840
+ if (reference.kind === "image" && (reference.startSeconds !== void 0 || reference.endSeconds !== void 0)) {
15841
+ issues.push({
15842
+ path: ["references", index, "startSeconds"],
15843
+ message: `reference "${reference.id}" is an image; a time window applies to video only`
15844
+ });
15845
+ }
15846
+ });
15847
+ return issues;
15848
+ }
15849
+ var scene3DPlanV2ObjectSchema = z.object({
15850
+ planType: z.literal(SCENE3D_PLAN_TYPE),
15851
+ schemaVersion: z.literal(SCENE3D_SCHEMA_VERSION_V2),
15852
+ revisionId: z.uuid(),
15853
+ parentRevisionId: z.uuid().optional(),
15854
+ width: z.number().int().min(SCENE3D_V2_LIMITS.minDimensionPx).max(SCENE3D_V2_LIMITS.maxDimensionPx),
15855
+ height: z.number().int().min(SCENE3D_V2_LIMITS.minDimensionPx).max(SCENE3D_V2_LIMITS.maxDimensionPx),
15856
+ fps: z.number().int().min(SCENE3D_V2_LIMITS.minFps).max(SCENE3D_V2_LIMITS.maxFps),
15857
+ durationInFrames: z.number().int().min(SCENE3D_V2_LIMITS.minDurationInFrames).max(SCENE3D_V2_LIMITS.maxDurationInFrames),
15858
+ units: z.literal("meters"),
15859
+ upAxis: z.literal("Y"),
15860
+ handedness: z.literal("right"),
15861
+ objects: z.array(scene3DEntityV2Schema).min(SCENE3D_V2_LIMITS.minEntities).max(SCENE3D_V2_LIMITS.maxEntities),
15862
+ assets: z.array(scene3DAssetRefSchema).min(1).max(SCENE3D_V2_LIMITS.maxAssets),
15863
+ cameraTrackAssetId: scene3DAssetIdSchema,
15864
+ shots: z.array(scene3DShotSchema).min(1).max(SCENE3D_V2_LIMITS.maxShots),
15865
+ lighting: scene3DClayLightingSchema,
15866
+ backgroundColor: scene3DColorSchema,
15867
+ references: z.array(scene3DReferenceSchema).max(SCENE3D_V2_LIMITS.maxReferences).optional(),
15868
+ overrides: z.array(scene3DOverrideSchema).max(SCENE3D_V2_LIMITS.maxOverrides).optional(),
15869
+ provenance: scene3DProvenanceSchema
15870
+ }).strict();
15871
+ var scene3DPlanV2Schema = scene3DPlanV2ObjectSchema.superRefine((plan, ctx) => {
15872
+ for (const issue2 of scene3DPlanV2Issues(plan)) {
15873
+ ctx.addIssue({ code: "custom", path: issue2.path, message: issue2.message });
15874
+ }
15875
+ });
15876
+ var scene3DAnyPlanSchema = z.discriminatedUnion("schemaVersion", [scene3DPlanV1ObjectSchema, scene3DPlanV2ObjectSchema]).superRefine((plan, ctx) => {
15877
+ const issues = plan.schemaVersion === SCENE3D_SCHEMA_VERSION_V2 ? scene3DPlanV2Issues(plan) : scene3DPlanV1Issues(plan);
15878
+ for (const issue2 of issues) {
15879
+ ctx.addIssue({ code: "custom", path: issue2.path, message: issue2.message });
15880
+ }
15881
+ });
15882
+ var scene3DAcceptedSchemaVersionsSchema = z.array(z.union([z.literal(1), z.literal(2)])).min(1).max(SCENE3D_SUPPORTED_SCHEMA_VERSIONS.length);
15883
+ function isScene3DPlanV2(value) {
15884
+ return scene3DPlanV2Schema.safeParse(value).success;
15885
+ }
15886
+ function isScene3DPlan(value) {
15887
+ return scene3DAnyPlanSchema.safeParse(value).success;
15888
+ }
15889
+ function scene3DPlanSchemaVersion(value) {
15890
+ if (typeof value !== "object" || value === null) return null;
15891
+ const record = value;
15892
+ if (record.planType !== SCENE3D_PLAN_TYPE) return null;
15893
+ if (typeof record.schemaVersion !== "number" || !Number.isInteger(record.schemaVersion)) return null;
15894
+ return record.schemaVersion;
15895
+ }
15896
+ function isScene3DSchemaVersionSupported(version) {
15897
+ return SCENE3D_SUPPORTED_SCHEMA_VERSIONS.includes(version);
15898
+ }
15899
+ function isKnownScene3DEngine(engine) {
15900
+ return SCENE3D_V2_ENGINES.includes(engine);
15901
+ }
15902
+ function scene3DShotIndexForFrame(shots, frame) {
15903
+ for (let index = 0; index < shots.length; index++) {
15904
+ const shot = shots[index];
15905
+ if (frame >= shot.startFrame && frame < shot.endFrameExclusive) return index;
15906
+ }
15907
+ return -1;
15908
+ }
15909
+ function scene3DShotForFrame(shots, frame) {
15910
+ const index = scene3DShotIndexForFrame(shots, frame);
15911
+ return index === -1 ? void 0 : shots[index];
15912
+ }
15913
+
15914
+ // src/scene3d-v2-resources.ts
15915
+ function scene3DV2HierarchyDepth(entities) {
15916
+ const byId = new Map(entities.map((entity) => [entity.id, entity]));
15917
+ let deepest = 0;
15918
+ for (const entity of entities) {
15919
+ let depth = 1;
15920
+ let cursor = entity;
15921
+ const seen = /* @__PURE__ */ new Set([entity.id]);
15922
+ while (cursor.parentId !== void 0) {
15923
+ const parent = byId.get(cursor.parentId);
15924
+ if (!parent || seen.has(parent.id)) break;
15925
+ seen.add(parent.id);
15926
+ cursor = parent;
15927
+ depth += 1;
15928
+ }
15929
+ if (depth > deepest) deepest = depth;
15930
+ }
15931
+ return deepest;
15932
+ }
15933
+ function scene3DV2ResourceUsage(plan) {
15934
+ let rendererAssetBytes = 0;
15935
+ let cameraTrackBytes = 0;
15936
+ let blendSourceBytes = 0;
15937
+ for (const asset of plan.assets) {
15938
+ if (SCENE3D_RENDERER_ASSET_KINDS.includes(asset.kind)) rendererAssetBytes += asset.byteLength;
15939
+ if (asset.kind === "camera-track-json") cameraTrackBytes += asset.byteLength;
15940
+ if (asset.kind === "blend-source") blendSourceBytes += asset.byteLength;
15941
+ }
15942
+ return {
15943
+ entities: plan.objects.length,
15944
+ assets: plan.assets.length,
15945
+ shots: plan.shots.length,
15946
+ overrides: plan.overrides?.length ?? 0,
15947
+ references: plan.references?.length ?? 0,
15948
+ frames: plan.durationInFrames,
15949
+ durationSeconds: plan.durationInFrames / plan.fps,
15950
+ hierarchyDepth: scene3DV2HierarchyDepth(plan.objects),
15951
+ rendererAssetBytes,
15952
+ cameraTrackBytes,
15953
+ blendSourceBytes
15954
+ };
15955
+ }
15956
+ function scene3DV2AdmissionIssues(plan, manifestBytes) {
15957
+ const issues = [];
15958
+ const usage = scene3DV2ResourceUsage(plan);
15959
+ const limits = SCENE3D_V2_LIMITS;
15960
+ if (manifestBytes !== void 0 && manifestBytes > limits.maxManifestBytes) {
15961
+ issues.push({
15962
+ path: [],
15963
+ message: `manifest is ${manifestBytes} bytes; the limit is ${limits.maxManifestBytes}`
15964
+ });
15965
+ }
15966
+ if (usage.frames > limits.maxDurationInFrames) {
15967
+ issues.push({
15968
+ path: ["durationInFrames"],
15969
+ message: `scene is ${usage.frames} frames; the limit is ${limits.maxDurationInFrames}`
15970
+ });
15971
+ }
15972
+ if (usage.durationSeconds > limits.maxDurationSeconds) {
15973
+ issues.push({
15974
+ path: ["durationInFrames"],
15975
+ message: `scene is ${usage.durationSeconds.toFixed(2)}s; the limit is ${limits.maxDurationSeconds}s`
15976
+ });
15977
+ }
15978
+ if (usage.entities > limits.maxEntities) {
15979
+ issues.push({ path: ["objects"], message: `${usage.entities} entities; the limit is ${limits.maxEntities}` });
15980
+ }
15981
+ if (usage.shots > limits.maxShots) {
15982
+ issues.push({ path: ["shots"], message: `${usage.shots} shots; the limit is ${limits.maxShots}` });
15983
+ }
15984
+ if (usage.hierarchyDepth > limits.maxHierarchyDepth) {
15985
+ issues.push({
15986
+ path: ["objects"],
15987
+ message: `hierarchy is ${usage.hierarchyDepth} deep; the limit is ${limits.maxHierarchyDepth}`
15988
+ });
15989
+ }
15990
+ if (usage.rendererAssetBytes > limits.maxRendererAssetBytes) {
15991
+ issues.push({
15992
+ path: ["assets"],
15993
+ message: `downloaded scene assets total ${usage.rendererAssetBytes} bytes; the limit is ${limits.maxRendererAssetBytes}`
15994
+ });
15995
+ }
15996
+ if (usage.cameraTrackBytes > limits.maxCameraTrackBytes) {
15997
+ issues.push({
15998
+ path: ["assets"],
15999
+ message: `camera track data totals ${usage.cameraTrackBytes} bytes; the limit is ${limits.maxCameraTrackBytes}`
16000
+ });
16001
+ }
16002
+ return issues;
16003
+ }
16004
+ function scene3DV2NormalizationIssues(plan, stats) {
16005
+ const issues = [];
16006
+ const limits = SCENE3D_V2_LIMITS;
16007
+ const declared = new Map(plan.assets.map((asset) => [asset.assetId, asset]));
16008
+ let meshNodes = 0;
16009
+ let triangles = 0;
16010
+ let rendererBytes = 0;
16011
+ stats.forEach((stat, index) => {
16012
+ const at = (...rest) => [index, ...rest];
16013
+ const asset = declared.get(stat.assetId);
16014
+ if (!asset) {
16015
+ issues.push({ path: at("assetId"), message: `asset "${stat.assetId}" is not declared in the manifest` });
16016
+ return;
16017
+ }
16018
+ if (stat.kind !== asset.kind) {
16019
+ issues.push({
16020
+ path: at("kind"),
16021
+ message: `asset "${stat.assetId}" decoded as "${stat.kind}" but the manifest declares "${asset.kind}"`
16022
+ });
16023
+ }
16024
+ if (stat.byteLength !== asset.byteLength) {
16025
+ issues.push({
16026
+ path: at("byteLength"),
16027
+ message: `asset "${stat.assetId}" is ${stat.byteLength} bytes; the manifest declares ${asset.byteLength}`
16028
+ });
16029
+ }
16030
+ if (stat.sha256 !== void 0 && stat.sha256 !== asset.sha256) {
16031
+ issues.push({
16032
+ path: at("sha256"),
16033
+ message: `asset "${stat.assetId}" digest does not match the manifest`
16034
+ });
16035
+ }
16036
+ if (SCENE3D_RENDERER_ASSET_KINDS.includes(stat.kind)) rendererBytes += stat.byteLength;
16037
+ if (stat.kind === "camera-track-json" && stat.byteLength > limits.maxCameraTrackBytes) {
16038
+ issues.push({
16039
+ path: at("byteLength"),
16040
+ message: `camera track "${stat.assetId}" decoded to ${stat.byteLength} bytes; the limit is ${limits.maxCameraTrackBytes}`
16041
+ });
16042
+ }
16043
+ meshNodes += stat.meshNodes ?? 0;
16044
+ triangles += stat.triangles ?? 0;
16045
+ if (stat.maxNodeDepth !== void 0 && stat.maxNodeDepth > limits.maxHierarchyDepth) {
16046
+ issues.push({
16047
+ path: at("maxNodeDepth"),
16048
+ message: `asset "${stat.assetId}" nests ${stat.maxNodeDepth} levels; the limit is ${limits.maxHierarchyDepth}`
16049
+ });
16050
+ }
16051
+ for (const [field, value] of [
16052
+ ["imageWidth", stat.imageWidth],
16053
+ ["imageHeight", stat.imageHeight]
16054
+ ]) {
16055
+ if (value === void 0) continue;
16056
+ if (!Number.isInteger(value) || value < limits.minPosterDimensionPx || value > limits.maxPosterDimensionPx) {
16057
+ issues.push({
16058
+ path: at(field),
16059
+ message: `asset "${stat.assetId}" ${field} is ${value}; it must be an integer between ${limits.minPosterDimensionPx} and ${limits.maxPosterDimensionPx}`
16060
+ });
16061
+ }
16062
+ }
16063
+ });
16064
+ if (meshNodes > limits.maxMeshNodes) {
16065
+ issues.push({ path: [], message: `resolved assets contain ${meshNodes} mesh nodes; the limit is ${limits.maxMeshNodes}` });
16066
+ }
16067
+ if (triangles > limits.maxTriangles) {
16068
+ issues.push({ path: [], message: `resolved assets contain ${triangles} triangles; the limit is ${limits.maxTriangles}` });
16069
+ }
16070
+ if (rendererBytes > limits.maxRendererAssetBytes) {
16071
+ issues.push({
16072
+ path: [],
16073
+ message: `downloaded scene assets decoded to ${rendererBytes} bytes; the limit is ${limits.maxRendererAssetBytes}`
16074
+ });
16075
+ }
16076
+ return issues;
16077
+ }
16078
+ function parseScene3DPlanV2Json(text) {
16079
+ const bytes = scene3DJsonByteLength(text);
16080
+ if (bytes > SCENE3D_V2_LIMITS.maxManifestBytes) {
16081
+ return {
16082
+ ok: false,
16083
+ issues: [{ path: [], message: `manifest is ${bytes} bytes; the limit is ${SCENE3D_V2_LIMITS.maxManifestBytes}` }]
16084
+ };
16085
+ }
16086
+ let decoded;
16087
+ try {
16088
+ decoded = JSON.parse(text);
16089
+ } catch {
16090
+ return { ok: false, issues: [{ path: [], message: "manifest is not valid JSON" }] };
16091
+ }
16092
+ const parsed = scene3DPlanV2Schema.safeParse(decoded);
16093
+ if (!parsed.success) return { ok: false, issues: scene3DZodIssues(parsed.error) };
16094
+ return { ok: true, value: parsed.data };
16095
+ }
16096
+ var SCENE3D_V2_CONTENT_HASH_EXCLUDED = ["revisionId", "parentRevisionId"];
16097
+ function canonicalize(value) {
16098
+ if (value === null) return "null";
16099
+ if (typeof value === "number") {
16100
+ if (!Number.isFinite(value)) throw new Error("cannot canonicalize a non-finite number");
16101
+ return JSON.stringify(value === 0 ? 0 : value);
16102
+ }
16103
+ if (typeof value === "string" || typeof value === "boolean") return JSON.stringify(value);
16104
+ if (Array.isArray(value)) return `[${value.map((item) => canonicalize(item)).join(",")}]`;
16105
+ if (typeof value === "object") {
16106
+ const record = value;
16107
+ const parts = [];
16108
+ for (const key of Object.keys(record).sort()) {
16109
+ const entry = record[key];
16110
+ if (entry === void 0) continue;
16111
+ parts.push(`${JSON.stringify(key)}:${canonicalize(entry)}`);
16112
+ }
16113
+ return `{${parts.join(",")}}`;
16114
+ }
16115
+ throw new Error(`cannot canonicalize ${typeof value}`);
16116
+ }
16117
+ function canonicalScene3DPlanV2Json(plan) {
16118
+ const { revisionId: _revisionId, parentRevisionId: _parentRevisionId, provenance, ...rest } = plan;
16119
+ const { contentHash: _contentHash, ...provenanceRest } = provenance;
16120
+ return canonicalize({ ...rest, provenance: provenanceRest });
16121
+ }
16122
+ function toHex(buffer) {
16123
+ return Array.from(new Uint8Array(buffer), (byte) => byte.toString(16).padStart(2, "0")).join("");
16124
+ }
16125
+ async function computeScene3DPlanV2ContentHash(plan) {
16126
+ const subtle = globalThis.crypto?.subtle;
16127
+ if (!subtle) throw new Error("WebCrypto SubtleCrypto is required to hash a Scene3D revision");
16128
+ const bytes = new TextEncoder().encode(canonicalScene3DPlanV2Json(plan));
16129
+ return toHex(await subtle.digest("SHA-256", bytes));
16130
+ }
16131
+ async function verifyScene3DPlanV2ContentHash(plan) {
16132
+ return await computeScene3DPlanV2ContentHash(plan) === plan.provenance.contentHash;
16133
+ }
16134
+ var SCENE3D_CAMERA_TRACK_FORMAT = "scene3d-camera-track";
16135
+ var SCENE3D_CAMERA_TRACK_VERSION = 1;
16136
+ var SCENE3D_CAMERA_TRACK_LIMITS = {
16137
+ maxJsonBytes: SCENE3D_V2_LIMITS.maxCameraTrackBytes,
16138
+ maxFrameCount: SCENE3D_V2_LIMITS.maxDurationInFrames,
16139
+ minFps: SCENE3D_V2_LIMITS.minFps,
16140
+ maxFps: SCENE3D_V2_LIMITS.maxFps,
16141
+ /** A unit quaternion off by more than this is a bug, not float noise. */
16142
+ quaternionTolerance: 1e-4,
16143
+ /** Absolute tolerance on the projection entries that must be exactly zero
16144
+ * (or exactly ∓1) in a perspective matrix. */
16145
+ projectionEpsilon: 1e-6,
16146
+ /** Relative tolerance when comparing declared near/far against the values the
16147
+ * projection matrix implies. */
16148
+ nearFarRelativeTolerance: 1e-3,
16149
+ /** Relative tolerance on `m[0]/m[5]` vs the manifest's `height/width`. */
16150
+ aspectRelativeTolerance: 1e-3,
16151
+ minNear: 1e-4,
16152
+ maxFar: 1e7
16153
+ };
16154
+ var coordinate = z.number().min(-SCENE3D_LIMITS.maxCoordinate).max(SCENE3D_LIMITS.maxCoordinate);
16155
+ var positionSchema = z.tuple([coordinate, coordinate, coordinate]);
16156
+ var scene3DCameraSampleSchema = z.object({
16157
+ position: positionSchema,
16158
+ quaternion: z.tuple([z.number(), z.number(), z.number(), z.number()]),
16159
+ projectionMatrix: z.array(z.number()).length(16),
16160
+ near: z.number().min(SCENE3D_CAMERA_TRACK_LIMITS.minNear).max(SCENE3D_CAMERA_TRACK_LIMITS.maxFar),
16161
+ far: z.number().min(SCENE3D_CAMERA_TRACK_LIMITS.minNear).max(SCENE3D_CAMERA_TRACK_LIMITS.maxFar),
16162
+ target: positionSchema.optional(),
16163
+ focalLengthMm: z.number().min(SCENE3D_LIMITS.minFocalLengthMm).max(SCENE3D_LIMITS.maxFocalLengthMm).optional()
16164
+ }).strict();
16165
+ var scene3DCameraTrackObjectSchema = z.object({
16166
+ format: z.literal(SCENE3D_CAMERA_TRACK_FORMAT),
16167
+ version: z.literal(SCENE3D_CAMERA_TRACK_VERSION),
16168
+ frameStart: z.literal(0),
16169
+ frameCount: z.number().int().min(1).max(SCENE3D_CAMERA_TRACK_LIMITS.maxFrameCount),
16170
+ fps: z.number().int().min(SCENE3D_CAMERA_TRACK_LIMITS.minFps).max(SCENE3D_CAMERA_TRACK_LIMITS.maxFps),
16171
+ samples: z.array(scene3DCameraSampleSchema).min(1).max(SCENE3D_CAMERA_TRACK_LIMITS.maxFrameCount)
16172
+ }).strict();
16173
+ function scene3DProjectionIssues(matrix, near, far, path) {
16174
+ const issues = [];
16175
+ const eps = SCENE3D_CAMERA_TRACK_LIMITS.projectionEpsilon;
16176
+ if (matrix.length !== 16) {
16177
+ issues.push({ path, message: `projection matrix must have exactly 16 entries (got ${matrix.length})` });
16178
+ return issues;
16179
+ }
16180
+ if (matrix.some((value) => !Number.isFinite(value))) {
16181
+ issues.push({ path, message: "projection matrix contains a non-finite entry" });
16182
+ return issues;
16183
+ }
16184
+ if (Math.abs(matrix[11]) < eps && Math.abs(matrix[15] - 1) < eps) {
16185
+ issues.push({
16186
+ path,
16187
+ message: "projection matrix is orthographic; only perspective cameras are supported by this schema version"
16188
+ });
16189
+ return issues;
16190
+ }
16191
+ for (const index of [1, 2, 3, 4, 6, 7, 12, 13, 15]) {
16192
+ if (Math.abs(matrix[index]) > eps) {
16193
+ issues.push({ path: [...path, index], message: `projection matrix entry ${index} must be 0 (got ${matrix[index]})` });
16194
+ }
16195
+ }
16196
+ if (Math.abs(matrix[11] + 1) > eps) {
16197
+ issues.push({ path: [...path, 11], message: `projection matrix entry 11 must be -1 for a perspective camera (got ${matrix[11]})` });
16198
+ }
16199
+ if (!(matrix[0] > 0)) {
16200
+ issues.push({ path: [...path, 0], message: `projection matrix entry 0 must be positive (got ${matrix[0]})` });
16201
+ }
16202
+ if (!(matrix[5] > 0)) {
16203
+ issues.push({ path: [...path, 5], message: `projection matrix entry 5 must be positive (got ${matrix[5]})` });
16204
+ }
16205
+ if (!(matrix[10] < 0)) {
16206
+ issues.push({ path: [...path, 10], message: `projection matrix entry 10 must be negative (got ${matrix[10]})` });
16207
+ }
16208
+ if (!(matrix[14] < 0)) {
16209
+ issues.push({ path: [...path, 14], message: `projection matrix entry 14 must be negative (got ${matrix[14]})` });
16210
+ }
16211
+ if (issues.length > 0) return issues;
16212
+ if (!(near > 0) || !(far > near)) {
16213
+ issues.push({ path, message: `near/far must satisfy 0 < near < far (got near ${near}, far ${far})` });
16214
+ return issues;
16215
+ }
16216
+ const tolerance = SCENE3D_CAMERA_TRACK_LIMITS.nearFarRelativeTolerance;
16217
+ const impliedNear = matrix[14] / (matrix[10] - 1);
16218
+ if (Math.abs(impliedNear - near) > Math.abs(near) * tolerance) {
16219
+ issues.push({
16220
+ path,
16221
+ message: `projection matrix implies near ${impliedNear.toPrecision(6)}, but the sample declares ${near}`
16222
+ });
16223
+ }
16224
+ const farDenominator = matrix[10] + 1;
16225
+ if (Math.abs(farDenominator) < eps) {
16226
+ issues.push({
16227
+ path,
16228
+ message: `projection matrix implies an infinite far plane, but the sample declares ${far}`
16229
+ });
16230
+ } else {
16231
+ const impliedFar = matrix[14] / farDenominator;
16232
+ if (Math.abs(impliedFar - far) > Math.abs(far) * tolerance) {
16233
+ issues.push({
16234
+ path,
16235
+ message: `projection matrix implies far ${impliedFar.toPrecision(6)}, but the sample declares ${far}`
16236
+ });
16237
+ }
16238
+ }
16239
+ return issues;
16240
+ }
16241
+ function scene3DCameraTrackIssues(track) {
16242
+ const issues = [];
16243
+ if (track.samples.length !== track.frameCount) {
16244
+ issues.push({
16245
+ path: ["samples"],
16246
+ message: `track declares ${track.frameCount} frames but carries ${track.samples.length} samples; exactly one sample per frame is required`
16247
+ });
16248
+ }
16249
+ const quaternionTolerance = SCENE3D_CAMERA_TRACK_LIMITS.quaternionTolerance;
16250
+ track.samples.forEach((sample, index) => {
16251
+ const [x, y, z22, w] = sample.quaternion;
16252
+ const norm = Math.sqrt(x * x + y * y + z22 * z22 + w * w);
16253
+ if (Math.abs(norm - 1) > quaternionTolerance) {
16254
+ issues.push({
16255
+ path: ["samples", index, "quaternion"],
16256
+ message: `quaternion at frame ${index} has length ${norm.toPrecision(6)}; it must be normalized`
16257
+ });
16258
+ }
16259
+ if (!(sample.far > sample.near)) {
16260
+ issues.push({
16261
+ path: ["samples", index, "far"],
16262
+ message: `frame ${index}: far (${sample.far}) must be greater than near (${sample.near})`
16263
+ });
16264
+ }
16265
+ for (const issue2 of scene3DProjectionIssues(
16266
+ sample.projectionMatrix,
16267
+ sample.near,
16268
+ sample.far,
16269
+ ["samples", index, "projectionMatrix"]
16270
+ )) {
16271
+ issues.push(issue2);
16272
+ }
16273
+ });
16274
+ return issues;
16275
+ }
16276
+ var scene3DCameraTrackSchema = scene3DCameraTrackObjectSchema.superRefine((track, ctx) => {
16277
+ for (const issue2 of scene3DCameraTrackIssues(track)) {
16278
+ ctx.addIssue({ code: "custom", path: issue2.path, message: issue2.message });
16279
+ }
16280
+ });
16281
+ function isScene3DCameraTrack(value) {
16282
+ return scene3DCameraTrackSchema.safeParse(value).success;
16283
+ }
16284
+ function scene3DCameraTrackPlanIssues(track, plan) {
16285
+ const issues = [];
16286
+ if (track.fps !== plan.fps) {
16287
+ issues.push({
16288
+ path: ["fps"],
16289
+ message: `camera track is ${track.fps} fps but the scene is ${plan.fps} fps; changing fps requires an explicit resample and a new revision`
16290
+ });
16291
+ }
16292
+ if (track.frameCount !== plan.durationInFrames) {
16293
+ issues.push({
16294
+ path: ["frameCount"],
16295
+ message: `camera track covers ${track.frameCount} frames but the scene is ${plan.durationInFrames} frames`
16296
+ });
16297
+ }
16298
+ const expected = plan.height / plan.width;
16299
+ const tolerance = SCENE3D_CAMERA_TRACK_LIMITS.aspectRelativeTolerance;
16300
+ track.samples.forEach((sample, index) => {
16301
+ const m0 = sample.projectionMatrix[0];
16302
+ const m5 = sample.projectionMatrix[5];
16303
+ if (!Number.isFinite(m0) || !Number.isFinite(m5) || m5 === 0) return;
16304
+ const actual = m0 / m5;
16305
+ if (Math.abs(actual - expected) > expected * tolerance) {
16306
+ issues.push({
16307
+ path: ["samples", index, "projectionMatrix"],
16308
+ message: `frame ${index}: projection is baked for aspect ${(1 / actual).toPrecision(6)} but the scene renders ${plan.width}\xD7${plan.height}; reprojection requires a new revision`
16309
+ });
16310
+ }
16311
+ });
16312
+ return issues;
16313
+ }
16314
+ function scene3DSampleForFrame(track, frame) {
16315
+ if (!Number.isInteger(frame) || frame < 0 || frame >= track.frameCount) return void 0;
16316
+ return track.samples[frame];
16317
+ }
16318
+ function parseScene3DCameraTrackJson(text) {
16319
+ const bytes = scene3DJsonByteLength(text);
16320
+ if (bytes > SCENE3D_CAMERA_TRACK_LIMITS.maxJsonBytes) {
16321
+ return {
16322
+ ok: false,
16323
+ issues: [
16324
+ {
16325
+ path: [],
16326
+ message: `camera track is ${bytes} bytes; the limit is ${SCENE3D_CAMERA_TRACK_LIMITS.maxJsonBytes}`
16327
+ }
16328
+ ]
16329
+ };
16330
+ }
16331
+ let decoded;
16332
+ try {
16333
+ decoded = JSON.parse(text);
16334
+ } catch {
16335
+ return { ok: false, issues: [{ path: [], message: "camera track is not valid JSON" }] };
16336
+ }
16337
+ const parsed = scene3DCameraTrackSchema.safeParse(decoded);
16338
+ if (!parsed.success) {
16339
+ return { ok: false, issues: scene3DZodIssues(parsed.error) };
16340
+ }
16341
+ return { ok: true, value: parsed.data };
16342
+ }
14679
16343
 
14680
16344
  // src/studio-transient.ts
14681
16345
  var STUDIO_TRANSIENT_KEYS = [
@@ -14723,7 +16387,141 @@ function stripStudioTransientSettings(settings) {
14723
16387
  }
14724
16388
  return { ...settings, studio: kept };
14725
16389
  }
16390
+ var scene3DV2OverrideInputSchema = z.discriminatedUnion("kind", [
16391
+ z.object({
16392
+ kind: z.literal("entity-transform"),
16393
+ entityId: scene3DIdSchema,
16394
+ space: z.enum(["local", "world"]),
16395
+ position: vec3Schema.optional(),
16396
+ rotation: rotationVec3Schema.optional(),
16397
+ scale: scaleVec3Schema.optional()
16398
+ }).strict(),
16399
+ z.object({
16400
+ kind: z.literal("entity-color"),
16401
+ entityId: scene3DIdSchema,
16402
+ materialRole: scene3DMaterialRoleSchema,
16403
+ color: scene3DColorSchema
16404
+ }).strict(),
16405
+ z.object({ kind: z.literal("entity-visibility"), entityId: scene3DIdSchema, visible: z.boolean() }).strict(),
16406
+ z.object({
16407
+ kind: z.literal("camera-shot-offset"),
16408
+ shotId: scene3DIdSchema,
16409
+ positionOffset: vec3Schema.optional(),
16410
+ targetOffset: vec3Schema.optional()
16411
+ }).strict()
16412
+ ]);
16413
+ var scene3DV2EditOperationSchema = z.discriminatedUnion("op", [
16414
+ z.object({ op: z.literal("set-override"), override: scene3DV2OverrideInputSchema }).strict(),
16415
+ z.object({ op: z.literal("remove-override"), overrideId: scene3DIdSchema }).strict()
16416
+ ]);
16417
+ var scene3DV2EditOperationsSchema = z.array(scene3DV2EditOperationSchema).min(1).max(100);
16418
+ function channel(override) {
16419
+ switch (override.kind) {
16420
+ case "entity-transform":
16421
+ return `transform:${override.entityId}`;
16422
+ case "entity-color":
16423
+ return `color:${override.entityId}:${override.materialRole}`;
16424
+ case "entity-visibility":
16425
+ return `visibility:${override.entityId}`;
16426
+ case "camera-shot-offset":
16427
+ return `camera:${override.shotId}`;
16428
+ }
16429
+ }
16430
+ function capability(override) {
16431
+ switch (override.kind) {
16432
+ case "entity-transform":
16433
+ return "transform";
16434
+ case "entity-color":
16435
+ return "color";
16436
+ case "entity-visibility":
16437
+ return "visibility";
16438
+ case "camera-shot-offset":
16439
+ return null;
16440
+ }
16441
+ }
16442
+ function lockIssue(plan, override, externalLocks) {
16443
+ if (override.kind === "camera-shot-offset") return null;
16444
+ const target = plan.objects.find((o) => o.id === override.entityId);
16445
+ if (!target) return `Unknown entity: ${override.entityId}`;
16446
+ const cap = capability(override);
16447
+ if (target.capabilities && !target.capabilities.includes(cap)) return `Entity ${target.id} does not allow ${cap} edits`;
16448
+ if (externalLocks.has(target.id) || target.locks?.includes(cap)) return `Entity ${target.id} is locked for ${cap}`;
16449
+ if (cap !== "transform" && cap !== "visibility") return null;
16450
+ const byId = new Map(plan.objects.map((entity) => [entity.id, entity]));
16451
+ for (const entity of plan.objects) {
16452
+ if (!externalLocks.has(entity.id) && !entity.locks?.includes(cap)) continue;
16453
+ let parent = entity.parentId;
16454
+ while (parent) {
16455
+ if (parent === target.id) return `Changing ${target.id} would change locked descendant ${entity.id}`;
16456
+ parent = byId.get(parent)?.parentId;
16457
+ }
16458
+ }
16459
+ return null;
16460
+ }
16461
+ async function applyScene3DV2EditOperations(input, operations, options) {
16462
+ const parsed = scene3DPlanV2Schema.safeParse(input);
16463
+ if (!parsed.success) return { ok: false, code: "invalid_plan", message: parsed.error.issues[0]?.message ?? "Invalid scene" };
16464
+ const base = parsed.data;
16465
+ if (base.revisionId !== options.expectedRevisionId || options.expectedContentHash !== void 0 && base.provenance.contentHash !== options.expectedContentHash) {
16466
+ return { ok: false, code: "stale_revision", message: "The scene changed since this edit was prepared" };
16467
+ }
16468
+ if (!await verifyScene3DPlanV2ContentHash(base)) {
16469
+ return { ok: false, code: "invalid_plan", message: "The scene content does not match its digest" };
16470
+ }
16471
+ const ops = scene3DV2EditOperationsSchema.safeParse(operations);
16472
+ if (!ops.success) return { ok: false, code: "invalid_operations", message: ops.error.issues[0]?.message ?? "Invalid edit" };
16473
+ const revisionId = options.newRevisionId ?? newScene3DRevisionId();
16474
+ if (revisionId === base.revisionId) return { ok: false, code: "invalid_operations", message: "An edit requires a new revision identity" };
16475
+ const externalLocks = new Set(options.lockedObjectIds ?? []);
16476
+ for (const id of externalLocks) {
16477
+ if (!base.objects.some((entity) => entity.id === id)) return { ok: false, code: "invalid_operations", message: `Unknown locked entity: ${id}` };
16478
+ }
16479
+ let overrides = [...base.overrides ?? []];
16480
+ for (const [index, operation] of ops.data.entries()) {
16481
+ if (operation.op === "remove-override") {
16482
+ const existing = overrides.find((override) => override.id === operation.overrideId);
16483
+ if (!existing) return { ok: false, code: "invalid_operations", message: `Unknown override: ${operation.overrideId}` };
16484
+ const issue3 = lockIssue(base, existing, externalLocks);
16485
+ if (issue3) return { ok: false, code: "locked", message: issue3 };
16486
+ overrides = overrides.filter((override) => override.id !== existing.id);
16487
+ continue;
16488
+ }
16489
+ const issue2 = lockIssue(base, operation.override, externalLocks);
16490
+ if (issue2) return { ok: false, code: "locked", message: issue2 };
16491
+ const previous = overrides.find((override) => channel(override) === channel(operation.override));
16492
+ const compatible = previous && (previous.kind !== "entity-transform" || operation.override.kind === "entity-transform" && previous.space === operation.override.space);
16493
+ const next2 = {
16494
+ ...compatible ? previous : {},
16495
+ ...operation.override,
16496
+ id: `edit-${revisionId}-${index}`,
16497
+ sourceRevisionId: base.revisionId,
16498
+ sourceContentHash: base.provenance.contentHash,
16499
+ operationVersion: SCENE3D_V2_OVERRIDE_OPERATION_VERSION
16500
+ };
16501
+ const key = channel(next2);
16502
+ overrides = [...overrides.filter((override) => channel(override) !== key), next2];
16503
+ }
16504
+ const { sourceArtifactId: _sourceArtifactId, ...provenance } = base.provenance;
16505
+ const next = {
16506
+ ...base,
16507
+ revisionId,
16508
+ parentRevisionId: base.revisionId,
16509
+ // Geometry and cameras are reused; derived images, validation and native
16510
+ // exports describe the old revision until regenerated for these overlays.
16511
+ assets: base.assets.filter((asset) => asset.kind === "glb" || asset.kind === "camera-track-json").map((asset) => ({
16512
+ ...asset,
16513
+ originRevisionId: asset.originRevisionId ?? base.revisionId
16514
+ })),
16515
+ overrides,
16516
+ provenance: { ...provenance, sourceRevisionId: base.revisionId }
16517
+ };
16518
+ const validated = scene3DPlanV2Schema.safeParse(next);
16519
+ if (!validated.success) return { ok: false, code: "invalid_operations", message: validated.error.issues[0]?.message ?? "Invalid edited scene" };
16520
+ const plan = validated.data;
16521
+ const contentHash = await computeScene3DPlanV2ContentHash(plan);
16522
+ return { ok: true, plan: { ...plan, provenance: { ...plan.provenance, contentHash } }, changeSummary: `Applied ${ops.data.length} scene edit${ops.data.length === 1 ? "" : "s"}` };
16523
+ }
14726
16524
 
14727
- export { ACCESS_LEVELS, ACTIVE_SCENE_HELPERS, ADVANCED_MODE_UNAVAILABLE_REASON, AGGREGATEABLE_TYPES, AGGREGATE_LANE_SOURCE_TYPES, AI_AVATAR_DURATION_BUCKETS, AI_AVATAR_MAX_AUDIO_SEC, AI_AVATAR_MAX_DURATION_SEC, AI_AVATAR_RESERVE_IDS, AI_WRITER_PROVIDERS, ALA_CARTE_BOARDS, ALL_CAPTION_STYLES, ANIMALS, ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, ASPECT_RATIO_DIMENSIONS, AUDIO_ADDON_PROVIDERS, AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, AUDIO_PRODUCER_TYPES, AddBRollResultSchema, AnchorSceneStyleResultSchema, AssetRefSchema, AuditImagesResultSchema, AuditImagesShotEntrySchema, AuditPromptIssueSchema, AuditPromptResultSchema, AvatarPayloadError, BOARD_TO_ASSET_TYPE, BOARD_TO_COLUMN, BOARD_VARIANTS, BridgeToNextSceneInputSchema, BridgeToNextSceneResultSchema, CATEGORY_DURATION_DEFAULTS, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASSET_TYPES, CHARACTER_ASSET_VARIANTS, CHARACTER_ATTACH_COLUMNS, CHARACTER_FACETS, CHARACTER_FACET_IDS, CHARACTER_LORA_TRAINING_JOB_TYPE, CHARACTER_MOTION_PROVIDERS, CHARACTER_PICKER_DISPLAY_ORDER, CHARACTER_REFERENCE_PHOTO_KINDS, CHARACTER_STYLES, CHARACTER_VARIANT_ASSET_BUCKETS, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, CINEMATIC_DEFAULT_DURATION_SEC, CINEMATIC_DEFAULT_RESOLUTION, CINEMATIC_MAX_DURATION_SEC, CINEMATIC_MAX_LOOKS, CINEMATIC_MAX_REFERENCE_IMAGES, CINEMATIC_MAX_REFERENCE_VIDEOS, CINEMATIC_MIN_DURATION_SEC, CINEMATIC_MIN_LOOKS, CINEMATIC_PROMPT_MAX, CINEMATIC_RESERVE_IDS, COLLABORATOR_ROLES, COLLECT_IN_HANDLE, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, COMPOSER_PLAN_FIELDS, COMPOSER_PLAN_MAP, CONTENT_TYPES_BY_PLATFORM, CREATURE_ATTACH_COLUMNS, CREDIT_BASE_USD, CREDIT_ROUNDING_RESOLUTION, CastCoverageCriticVerdictSchema, CharacterImageCriticVerdictSchema, CharacterMetadataSchema, ChatTurnResponseSchema, CriticIssueSchema, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, DEFAULT_CARRIED_FRACTION, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, DEFAULT_CHARACTER_FACET, DEFAULT_LABEL_BY_SOURCE, DEFAULT_LOCATION_USAGE_MODE, DEFAULT_PANEL_COUNT, DEFAULT_REF_IMAGE_MAX, DEFAULT_SECTIONS, DEFAULT_USAGE_MODE, DEFAULT_VIDEO_ANALYSIS_MODEL, DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_CLIP_COST, DEFAULT_VIDEO_DURATION_SEC, DEFAULT_VIDEO_PROVIDER, DEFAULT_VOICE_CHANGER_MODEL, DEFAULT_VOICE_DESIGN_MODEL, DETAIL_VARIANTS, DURATION_PRICED_PROVIDERS, DYNAMIC_PRODUCER_TYPES, DetectionResultSchema, EFFORT_TIER_BUMP, EMOTIONAL_BEAT, ENTITY_ASPECT_DEFAULTS, ENTITY_BUCKET_FIELDS, ENTITY_DB_ID_FIELD, ENTITY_IMAGE_HANDLE_TYPES, ENTITY_KIND_SCALAR_FIELDS, ENTITY_NAME_FIELD, ENTITY_NODE_KINDS, ENTITY_SCALAR_FIELDS, ENTITY_SECTIONS, ENTITY_STATUSES, ENTITY_TABLE, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, EXECUTION_DATA_KEYS, EXTEND_VIDEO_PROVIDERS, EntityMetadataSchema, EntityRejectInputSchema, EntityStaleEventSchema, EntityStateChangeEventSchema, FACE_SWAP_PROVIDERS, FAL_LIP_SYNC_PROVIDERS, FAN_OUT_EACH_TYPES, FEATURED_ENTITIES, FILM_BASE_CREDITS, FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS, FLUX2_RES_MP, FLUX_LORA_CHARACTER_MODEL_ID, FRAME_MODE_ADAPTIVE_ONLY_ASPECT, FRAME_TARGET_HANDLES, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, FURNITURE, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, FixContinuityInputSchema, FixContinuityResultSchema, GEMINI_OMNI_PROVIDERS, GENERATE_TEXT_DELIMITER, GLOBAL_MAX_DURATION_SECONDS, GRANTED_ACCESS, GROUP_HANDLE_PREFIX, GUIDANCE_SCALE_SUPPORT, GVP_ANCHOR_CHOICES, GVP_DEFAULT_PROVIDER, GVP_END_FRAME_PROVIDERS, GVP_EXTEND_PROVIDERS, GVP_SUPPORTED_PROVIDERS, GenerateMotionInputSchema, GenerateMotionResultSchema, HANDLE_PORT_SEPARATOR, HELPERS_SHIPPED_IN_1B3, HIGH_QUALITY_PROVIDERS, HINT_EXEMPT_PARAMETER_TYPES, I2I_MASK_SUPPORT, I2I_STRENGTH_SUPPORT, IDEOGRAM_PROVIDERS, IMAGE_ASPECT_RATIO_VALUES, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, IMAGE_EDIT_PROVIDERS, IMAGE_GEN_PROVIDERS, IMAGE_I2I_PROVIDERS, IMAGE_MASK_MODE, IMAGE_PROMPT_MAX, IMAGE_REF_TYPES, IMAGE_TO_VIDEO_PROVIDERS, INPUT_FIELD_MAP2 as INPUT_FIELD_MAP, INPUT_NODE_TYPES, INSTAGRAM_CAROUSEL_MAX_ITEMS, INSTAGRAM_CAROUSEL_MIN_ITEMS, ITER_CLONE_PATTERN, ImageCriticIssueSchema, ImageCriticResultSchema, ImageCriticVerdictSchema, ImprovePromptInputSchema, ImprovePromptResultSchema, KEYFRAME_CREDITS_PER_SHOT, KINETIC_CAPTION_STYLES, LANGUAGES, LEGACY_LOTTIE_HOST_REMAP, LIP_SYNC_DURATION_BUCKETS, LIP_SYNC_MAX_AUDIO_SECONDS, LIP_SYNC_PROVIDERS, LLM_FEATURE_DEFAULTS, LLM_MODALITY_CAPS, LLM_MODELS, LLM_MODEL_IDS, LLM_REASONING_EFFORTS, LLM_ROUTE_DEFAULTS, LLM_TEXT_INPUT_MAX, LLM_VENDOR_LABELS, LLM_VENDOR_ORDER, LOCATION_ASSET_TYPES, LOCATION_ASSET_VARIANTS, LOCATION_ATMOSPHERE_PROVIDERS, LOCATION_ATTACH_COLUMNS, LOCATION_BUCKET_TO_CATALOG_ID, LOCATION_PRESET_TO_CATALOG, LOCATION_REFERENCE_PHOTO_KINDS, LOCATION_REFERENCE_PHOTO_KIND_LABELS, LOCATION_USAGE_MODES, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, LocationImageCriticVerdictSchema, LocationMetadataSchema, LocationsCoverageCriticIssueSchema, LocationsCoverageCriticVerdictSchema, MAX_CUSTOM_ENTRIES_PER_BOARD, MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER, MAX_LOCATION_VARIANTS, MAX_NEGATIVE_PROMPT_CHARS_BY_PROVIDER, MAX_PANELS_PER_SHEET, MAX_TTS_CHARS_BY_PROVIDER, MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER, MEMBER_STATUSES, MINIMAX_H3_DEFAULT_RESOLUTION, MINIMAX_H3_PROVIDERS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, MODEL_CATALOG, MODEL_PARAM_NODE_TYPES, MODEL_RECOMMENDATIONS, MODIFY_IMAGE_PROVIDERS, MOTION_COLUMN, MOTION_TRANSFER_PROVIDERS, MUSIC_PROVIDERS, MatchCutVerdictSchema, NATIVE_ADAPTIVE_ASPECT, NATIVE_NEGATIVE_PROMPT_MODELS, NATIVE_NEGATIVE_VIDEO_PROVIDERS, NEGATIVE_PROMPT_MAX, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, NODE_DEFAULT_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_REF_PATTERN, NON_EN_LOCALE_IDS, NO_SPLIT_DELIMITER, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ASSET_VARIANTS, OBJECT_ATTACH_COLUMNS, OBJECT_MOTION_PROVIDERS, OBJECT_PICKER_NODE_TYPES, ORG_ERROR_CODES, ORG_KINDS, ORG_ROLES, ORG_STATUSES, OUTPUT_FIELD_MAP, OUTPUT_FORMATS, ObjectMetadataSchema, OptimizeForModelInputSchema, OptimizeForModelResultSchema, OrgSettingsSchema, PARAMETER_NODE_TYPES, PASSTHROUGH_TYPES, PAYG_RETENTION_DAYS, PER_FORMAT_DURATION_BOUNDS, PICKER_TO_COMBINE_TRANSITION, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, PLACEHOLDER_CHARACTER_NAME, PLATFORM_LABELS, PLATFORM_SPECS, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LABELS, PRESET_SETTING_KEYS, PRICING_DEFAULT_DURATION_SEC, PRICING_DEFAULT_RESOLUTION, PROMPT_HARD_CEILING, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PROVIDER_DIRECTIVE_DEFAULTS, PROVIDER_PLACEHOLDER_PREFIX, PipelineCompletedEventSchema, PipelineConfigSchema, PipelineDriftSummarySchema, PipelineEditorDecisionsReadyEventSchema, PipelineForkedEventSchema, PipelineInputSchema, PipelineMusicReadyEventSchema, PipelineStageNameSchema, PipelineStageStatusSchema, PipelineStateSchema, PipelineStatusSchema, PresetSettingsSchema, QA_CHECK_PROVIDERS, REDUCE_STRATEGIES, REDUCE_STRATEGY_IDS, REFERENCE_BOARD_PROVIDERS, REFERENCE_BOARD_TEMPLATES, REFERENCE_HANDLE_MAP, REFERENCE_ROLE_PRESETS, REF_HANDLE_CATEGORY, REF_IMAGE_MAX_LIMITS, REF_TOKEN_NAMESPACE_PREFIXES, RENDERING_SPEED_SUPPORT, REPEATABLE_NODE_TYPES, REPEAT_PLACEHOLDER, REPLICATE_LIP_SYNC_PROVIDERS, RESERVED_TEMPLATE_VARS, SCENE_HELPER_NAMES, SCRAPER_ACTOR_LABELS, SCRAPER_CREDIT_COSTS, SCRAPER_OUTPUT_FIELDS, SCRIPT_PROVIDERS, SEASONS, SECTION_BOARD, SECTION_KINDS, SEEDANCE_2_5_REF_LIMITS, SEEDANCE_2_CONTINUATION_REF_SEC, SEEDANCE_2_EXTEND_STITCH, SEEDANCE_2_PROVIDERS, SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER, SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC, SEEDANCE_2_REF_LIMITS, SEEDANCE_LIP_SYNC_PROVIDERS, SEED_SUPPORT, SEPARATOR_DISPLAY, SEPARATOR_PRESETS, SHEET_ASPECTS, SHEET_BACKGROUNDS, SHEET_PRESETS, SHEET_SKINS, SHEET_TYPES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, SLOT_TOKEN_RE, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SOCIAL_POST_NODE_TYPES, STAGE_PATCH_SCHEMA, STATIC_CAPTION_STYLES, STRUCTURAL_SECTIONS, STRUCTURED_VISION_MODELS, STUDIO_SHOT_TRANSIENT_KEYS, STUDIO_TRANSIENT_KEYS, SUBMISSION_STATUSES, SUNO_ADD_TRACK_MODELS, SUNO_FIELD_HANDLE_FIELDS, SUNO_HARD_CEILING, SUNO_MODELS, SUNO_SELECT_OPERATIONS, SUNO_TEXT_MAX, SUNO_TITLE_MAX, SUNO_TRACK_SOURCE_TYPES, SUNO_VERSION_PRICED_OPERATIONS, SUPPORTED_FONT_NAMES, SURROUND_DIRECTIONS, SWITCHX_BLOCK_FRAMES, SWITCHX_FRAME_TIERS, SceneHelperNameSchema, SceneInputModeSchema, SceneMetadataSchema, SceneNodeDataSchema, SceneSpecSchema, ScriptCriticVerdictSchema, ShotSpecSchema, ShowrunnerPlanSchema, StageAwaitingSubGateEventSchema, StoryboardCohesionCriticVerdictSchema, StyleDirectivesSchema, SubGateNameSchema, T2I_TO_I2I_VARIANT, TASK_CHAINED_EDIT_PROVIDERS, TEXT_TO_AUDIO_PROVIDERS, TEXT_TO_VIDEO_PROVIDERS, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, TILT_CARRIED_FRACTION, TOPAZ_DEFAULT_UPSCALE_FACTOR, TOPAZ_UPSCALE_FACTORS, TRANSCRIBE_PROVIDERS, TRANSIENT_RUNTIME_KEYS, TTS_PROVIDERS, TTS_TEXT_MAX, TWO_K_RESOLUTION_PROVIDERS, TransitionTypeSchema, UPSCALE_IMAGE_PROVIDERS, USAGE_GROUP_BYS, USAGE_MODES, VARIABLES_HANDLE_ID, VARIABLE_PRICING_MODELS, VEHICLES, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, VEO_PROVIDERS, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_BUCKET_CREDITS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_DURATION_BUCKETS, VIDEO_ANALYSIS_DURATION_TOLERANCE_SEC, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_LEGACY_MODELS, VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_MAX_DURATION_SEC, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_MIXED_TIERS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_LABELS, VIDEO_ANALYSIS_TIER_ORDER, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_ANALYSIS_WINDOW, VIDEO_AUDIO_CAPABILITY, VIDEO_AUDIT_BUCKET_CREDITS, VIDEO_CLIP_CREDITS, VIDEO_CRITIC_CREDITS_PER_SHOT, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_DURATION_TIERS, VIDEO_GEN_COLLAPSED_T2V_IDS, VIDEO_GEN_PROVIDERS, VIDEO_INPUT_LIP_SYNC_PROVIDERS, VIDEO_MODEL_CAPS, VIDEO_MODE_ALIASES, VIDEO_PRODUCER_TYPES, VIDEO_PROMPT_MAX, VIDEO_PROVIDERS_REQUIRING_IMAGE, VIDEO_PROVIDERS_WITHOUT_DISPATCH, VIDEO_REF_LIMITS_BY_PROVIDER, VIDEO_REF_VIDEO_DURATION_LIMITS, VIDEO_TO_VIDEO_PROVIDERS, VIDEO_UPSCALE_PROVIDERS, VIDEO_UTIL_PRICING, VIDEO_VARIABLE_PRICING, VOICE_CHANGER_MODELS, VOICE_CHANGER_MODEL_IDS, VOICE_DESIGN_MODELS, ValidateMatchCutInputSchema, ValidateMatchCutResultSchema, VideoCriticVerdictSchema, VoiceMatchSchema, WAN_3_DEFAULT_RESOLUTION, WAN_3_PROVIDERS, WARDROBE_VARIANTS, WEAPONS, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, WORKFLOW_VISIBILITIES, WORKSPACE_HEADER, WORKSPACE_HEADER_LOWER, WORKSPACE_ROLES, WorkspaceSettingsSchema, aggregateByType, aiAvatarReserveCreditId, analyzedSceneSchema, applyDefaultVideoSelection, applyHandleInputOverride, applyRange, applyRangeIndices, applySlots, applyVideoAudioToggle, applyVideoNegativePrompt, aspectRatioFromDims, aspectRatioOptionsByKind, aspectRatioToNumber, assembleNarratedVideoCredits, availableReasoningEfforts, bucketSecondsFromAuditCreditId, bucketSecondsFromCreditId, buildBoardPrompt, buildChildrenByParent, buildConditionVariables, buildCreditModelIdentifier, buildExpressionFromVisual, buildLipSyncCreditId, buildLlmCreditIdentifier, buildModelMenu, buildModelTree, buildMotionCreditModelIdentifier, buildNodePresetExport, buildPanelPrompt, buildProgressSegments, buildRangeLabel, buildScraperCreditId, buildVideoAnalysisCreditId, buildVideoAuditCreditId, buildVideoCreditModelIdentifier, calculateCombinedProgress, calculateMonetizationMarkup, calculateMonetizedCost, calculateProgress, canonicalVarName, characterBoardItems, characterBucketDisplayRank, characterMentionSlug, characterMentionableAssetArrays, characterSheetRefItems, characterVariantAssetArrays, checkRefVideoDurations, cinematicCreditId, clampCinematicDuration, clampSmartCutWindow, classifyRefToken, cleanOrphanedItems, clearImageCriticMetadata, clearVideoCriticMetadata, clipLookSchema, collectAncestorRefs, combineSameLabelRefs, computeAggregateLanes, countRefModalityEdges, creditRangesAll, creditsToUsd, decodeProviderItem, defaultCarriedFraction, defaultResolutionFor, defaultRoleForSource, defaultVideoAspectRatio, deriveLinkedFields, deriveLottieSlotFields, deriveSlotRefs, describeEdgeBehavior, describeMaskRegion, describeNodeAdjustments, describeSlotControl, dropUnknownBindings, dropUnknownSpeakers, durationsByMode, effectiveReasoningEffort, encodeProviderItem, ensureLocaleCatalogLoaded, entityHydrationColumns, entityMentionSlug, entityMentionSlugForRef, entityScalarFields, entitySlotSchema, entryMatchesQuery, estimateCombineVideosCredits, estimateFilmCredits, estimateLoopTrimAddonCredits, estimateLoopVideoCredits, estimateScriptDurationSec, estimateSheetCost, estimateTrimVideoCredits, evaluateCondition, evaluateConditionGroup, evaluateJsonExpression, evaluateJsonPath, expandExtraRefsToConnectedReferences, expandItemsWithRepeat, extractAllGeneratedResults, extractCharacterLoraFields, extractGeneratedJsonAsList, extractPresetData, extractReferencedLabels, extractVideoDurationFromNode, fieldKeyFromHandle, filterCloneNodes, findCharacterMentionTokens, findEntityMentionTokens, findImageMentionTokens, findLocationMentionTokens, findSeedance2AudioOverLimit, firstSightExtraRole, flattenItems, getAnimal, getAnimalLabel, getAnimalPromptHint, getAnimalTerm, getAspectRatioOptions, getAudioCrossfadeCurve, getCharacterFacet, getCombineTransition, getCreditRange, getDurationsForModel, getEffectiveRepeatCount, getFeaturedEntities, getFurniture, getFurnitureLabel, getInputFieldSchema, getInputNodes, getItemSortId, getLipSyncMaxAudioSeconds, getLlmModalityCaps, getLlmModel, getLlmTier, getLocaleDirection, getMaxImagePromptChars, getMaxNegativePromptChars, getMaxSunoPromptChars, getMaxSunoStyleChars, getMaxTtsChars, getMaxVideoPromptChars, getModel, getNodeLabel, getNodeResult, getOutputNodes, getOutputType, getParameterValue, getQualityOptions, getResolutionOptions, getRouteReachableNodeIds, getStrategy, getTargetField, getValidValues, getVehicle, getVehicleLabel, getVideoAudioCapability, getWeapon, getWeaponLabel, groupByFamily, groupHandleId, groupLlmModelsByVendor, hasContiguousSegmentDurations, hasFeature, hexToRgbaArray, humanizeSlotSid, imageMentionSlug, imageMentionSlugForRef, imageReferenceLimit, inferMusicVideo, isAggregateableType, isCharacterAspectRatio, isCollectInEdge, isDefaultSelectorConfig, isExpandedClone, isFlux2Model, isGeminiOmniProvider, isGvpSupportedProvider, isHandleInputWired, isKineticCaptionStyle, isLocationUsageMode, isMinimaxH3Provider, isObjectAspectRatio, isOversizedScene, isPaygRetentionActive, isPerSecondLipSyncProvider, isScraperActor, isSeedance2Provider, isTiltDirection, isUsageMode, isVeoProvider, isVideoAnalysisMixedTier, isVideoAnalysisTier, isWan3Provider, jsonResultToList, knownEntitySlugsFromRefs, knownImageSlugsFromRefs, listBoardTemplates, listModels, listSlotSids, llmRouteDefaults, locationMentionSlug, locationReferencePhotoKindLabel, locationUsageModeLabel, mapAspectRatio, mapQuality, mapShotIntentToProviderDirectives, matchVariant, maxSegmentSecFor, maxSegmentsFor, mergeClipLook, mergeExposedSettings, migrateEdgeOutputMode, migrateToItems, minSegmentSecFor, modelIdsByKindMode, modelToNodeTarget, modelsForInputMode, modelsWithFeature, motionGraphicsFeature, normalizeLottieLayers, normalizeMinimaxH3Resolution, normalizeModelInput, normalizeNodeModelParams, normalizePinterestUrl, normalizeRoleSlug, normalizeVideoRequestParams, normalizeWan3Resolution, orderedLlmModels, parseAttributedDialogue, parseCharacterMentionToken, parseEntityMentionToken, parseGroupHandle, parseHandleId, parseImageMentionToken, parseListExpression, parseLocationMentionToken, parseNodePresetExport, parseNodeRef, pickAiAvatarBucket, pickIds, pickLipSyncBucket, pickSwitchXFrameTier, pickVideoAnalysisBucket, planSheetGeneration, planSheetPanels, preferredInputModeForModel, presentTypes, presetApplyClearKeys, presetDataMatches, presetEntries, pricedVideoSelection, qualityOptionsByKind, readPromptAffixes, refHandleCategory, referenceModalityForHandle, referenceSheetCreditId, registerCatalogSidecars, registerSidecarLoaders, renderAnalyzedScene, resetCatalogSidecars, resolutionOptionsByKind, resolveAiAvatarCreditId, resolveAudioCrossfadeCurve, resolveCharacterAspectRatio, resolveCinematicCreditId, resolveConditionValue, resolveDefaultRole, resolveDescription, resolveDialogueVoices, resolveEffectiveSourceType, resolveEffectiveTier, resolveEntityAspect, resolveFieldMappings, resolveGvpAnchorWire, resolveImageGenCreditIdentifier, resolveIndex, resolveLabel, resolveListExpression, resolveLlmCreditId, resolveLocationFields, resolveLocationPresetCatalog, resolveLottieOverlaySrc, resolveNodeRefs, resolveNormalizedImageGen, resolveObjectAspectRatio, resolvePipelineModel, resolveRelativeWindowToken, resolveScraperCreditId, resolveSelectorRefs, resolveSeparator, resolveSheetSections, resolveSlideshowTransition, resolveSourceThroughConnectedList, resolveStoredTier, resolveSwitchXCreditId, resolveTopazUpscale, resolveVideoAnalysisModel, resolveVideoModeForInputs, resolveVideoProviderForMode, resolveXfadeName, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, rgbaArrayToHex, roleToPhrase, runSelector, safetyRetryPolicy, sanitizeRole, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripDerivedAnalysisFields, stripExportContent, stripStudioTransientSettings, stripTransientRuntimeData, sunoCreditType, supportedDefaultDimensions, supportsAdvancedMode, supportsEndAnchor, supportsExtendRender, toConnectedReference, toConnectedReferences, togglePick, tryParseJson, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unresolvedRefTokens, unwrapUnresolvedTokens, usageModeDirective, usageModeIncludesName, usageModeLabel, usdToCredits, validateAiAvatarPayload, validateCinematicAvatarPayload, validateDurationForFormat, validateModeActivation, validateModelInput, validateNoNestedGroups, validateObjects, validateProviderForNodeType, validateSubWorkflowRoutes, variantJobId, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderFoldsLoneEndFrame, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };
16525
+ export { ACCESS_LEVELS, ACTIVE_SCENE_HELPERS, ADVANCED_MODE_UNAVAILABLE_REASON, AGGREGATEABLE_TYPES, AGGREGATE_LANE_SOURCE_TYPES, AI_AVATAR_DURATION_BUCKETS, AI_AVATAR_MAX_AUDIO_SEC, AI_AVATAR_MAX_DURATION_SEC, AI_AVATAR_RESERVE_IDS, AI_WRITER_PROVIDERS, ALA_CARTE_BOARDS, ALL_CAPTION_STYLES, ANIMALS, ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, ASPECT_RATIO_DIMENSIONS, AUDIO_ADDON_PROVIDERS, AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, AUDIO_PRODUCER_TYPES, AddBRollResultSchema, AnchorSceneStyleResultSchema, AssetRefSchema, AuditImagesResultSchema, AuditImagesShotEntrySchema, AuditPromptIssueSchema, AuditPromptResultSchema, AvatarPayloadError, BOARD_TO_ASSET_TYPE, BOARD_TO_COLUMN, BOARD_VARIANTS, BridgeToNextSceneInputSchema, BridgeToNextSceneResultSchema, CATEGORY_DURATION_DEFAULTS, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASSET_TYPES, CHARACTER_ASSET_VARIANTS, CHARACTER_ATTACH_COLUMNS, CHARACTER_FACETS, CHARACTER_FACET_IDS, CHARACTER_LORA_TRAINING_JOB_TYPE, CHARACTER_MOTION_PROVIDERS, CHARACTER_PICKER_DISPLAY_ORDER, CHARACTER_REFERENCE_PHOTO_KINDS, CHARACTER_STYLES, CHARACTER_VARIANT_ASSET_BUCKETS, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, CINEMATIC_DEFAULT_DURATION_SEC, CINEMATIC_DEFAULT_RESOLUTION, CINEMATIC_MAX_DURATION_SEC, CINEMATIC_MAX_LOOKS, CINEMATIC_MAX_REFERENCE_IMAGES, CINEMATIC_MAX_REFERENCE_VIDEOS, CINEMATIC_MIN_DURATION_SEC, CINEMATIC_MIN_LOOKS, CINEMATIC_PROMPT_MAX, CINEMATIC_RESERVE_IDS, COLLABORATOR_ROLES, COLLECT_IN_HANDLE, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, COMPOSER_PLAN_FIELDS, COMPOSER_PLAN_MAP, CONTENT_TYPES_BY_PLATFORM, CREATURE_ATTACH_COLUMNS, CREDIT_BASE_USD, CREDIT_ROUNDING_RESOLUTION, CastCoverageCriticVerdictSchema, CharacterImageCriticVerdictSchema, CharacterMetadataSchema, ChatTurnResponseSchema, CriticIssueSchema, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, DEFAULT_CARRIED_FRACTION, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, DEFAULT_CHARACTER_FACET, DEFAULT_LABEL_BY_SOURCE, DEFAULT_LOCATION_USAGE_MODE, DEFAULT_PANEL_COUNT, DEFAULT_REF_IMAGE_MAX, DEFAULT_SECTIONS, DEFAULT_USAGE_MODE, DEFAULT_VIDEO_ANALYSIS_MODEL, DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_CLIP_COST, DEFAULT_VIDEO_DURATION_SEC, DEFAULT_VIDEO_PROVIDER, DEFAULT_VOICE_CHANGER_MODEL, DEFAULT_VOICE_DESIGN_MODEL, DETAIL_VARIANTS, DURATION_PRICED_PROVIDERS, DYNAMIC_PRODUCER_TYPES, DetectionResultSchema, EFFORT_TIER_BUMP, EMOTIONAL_BEAT, ENTITY_ASPECT_DEFAULTS, ENTITY_BUCKET_FIELDS, ENTITY_DB_ID_FIELD, ENTITY_IMAGE_HANDLE_TYPES, ENTITY_KIND_SCALAR_FIELDS, ENTITY_NAME_FIELD, ENTITY_NODE_KINDS, ENTITY_SCALAR_FIELDS, ENTITY_SECTIONS, ENTITY_STATUSES, ENTITY_TABLE, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, EXECUTION_DATA_KEYS, EXTEND_VIDEO_PROVIDERS, EntityMetadataSchema, EntityRejectInputSchema, EntityStaleEventSchema, EntityStateChangeEventSchema, FACE_SWAP_PROVIDERS, FAL_LIP_SYNC_PROVIDERS, FAN_OUT_EACH_TYPES, FEATURED_ENTITIES, FILM_BASE_CREDITS, FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS, FLUX2_RES_MP, FLUX_LORA_CHARACTER_MODEL_ID, FRAME_MODE_ADAPTIVE_ONLY_ASPECT, FRAME_TARGET_HANDLES, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, FURNITURE, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, FixContinuityInputSchema, FixContinuityResultSchema, GEMINI_OMNI_PROVIDERS, GENERATE_TEXT_DELIMITER, GLOBAL_MAX_DURATION_SECONDS, GRANTED_ACCESS, GROUP_HANDLE_PREFIX, GUIDANCE_SCALE_SUPPORT, GVP_ANCHOR_CHOICES, GVP_DEFAULT_PROVIDER, GVP_END_FRAME_PROVIDERS, GVP_EXTEND_PROVIDERS, GVP_SUPPORTED_PROVIDERS, GenerateMotionInputSchema, GenerateMotionResultSchema, HANDLE_PORT_SEPARATOR, HELPERS_SHIPPED_IN_1B3, HIGH_QUALITY_PROVIDERS, HINT_EXEMPT_PARAMETER_TYPES, I2I_MASK_SUPPORT, I2I_STRENGTH_SUPPORT, IDEOGRAM_PROVIDERS, IMAGE_ASPECT_RATIO_VALUES, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, IMAGE_EDIT_PROVIDERS, IMAGE_GEN_PROVIDERS, IMAGE_I2I_PROVIDERS, IMAGE_MASK_MODE, IMAGE_PROMPT_MAX, IMAGE_REF_TYPES, IMAGE_TO_VIDEO_PROVIDERS, INPUT_FIELD_MAP2 as INPUT_FIELD_MAP, INPUT_NODE_TYPES, INSTAGRAM_CAROUSEL_MAX_ITEMS, INSTAGRAM_CAROUSEL_MIN_ITEMS, ITER_CLONE_PATTERN, ImageCriticIssueSchema, ImageCriticResultSchema, ImageCriticVerdictSchema, ImprovePromptInputSchema, ImprovePromptResultSchema, KEYFRAME_CREDITS_PER_SHOT, KINETIC_CAPTION_STYLES, LANGUAGES, LEGACY_LOTTIE_HOST_REMAP, LIP_SYNC_DURATION_BUCKETS, LIP_SYNC_MAX_AUDIO_SECONDS, LIP_SYNC_PROVIDERS, LLM_FEATURE_DEFAULTS, LLM_MODALITY_CAPS, LLM_MODELS, LLM_MODEL_IDS, LLM_REASONING_EFFORTS, LLM_ROUTE_DEFAULTS, LLM_TEXT_INPUT_MAX, LLM_VENDOR_LABELS, LLM_VENDOR_ORDER, LOCATION_ASSET_TYPES, LOCATION_ASSET_VARIANTS, LOCATION_ATMOSPHERE_PROVIDERS, LOCATION_ATTACH_COLUMNS, LOCATION_BUCKET_TO_CATALOG_ID, LOCATION_PRESET_TO_CATALOG, LOCATION_REFERENCE_PHOTO_KINDS, LOCATION_REFERENCE_PHOTO_KIND_LABELS, LOCATION_USAGE_MODES, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, LocationImageCriticVerdictSchema, LocationMetadataSchema, LocationsCoverageCriticIssueSchema, LocationsCoverageCriticVerdictSchema, MAX_CUSTOM_ENTRIES_PER_BOARD, MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER, MAX_LOCATION_VARIANTS, MAX_NEGATIVE_PROMPT_CHARS_BY_PROVIDER, MAX_PANELS_PER_SHEET, MAX_TTS_CHARS_BY_PROVIDER, MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER, MEMBER_STATUSES, MINIMAX_H3_DEFAULT_RESOLUTION, MINIMAX_H3_PROVIDERS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, MODEL_CATALOG, MODEL_PARAM_NODE_TYPES, MODEL_RECOMMENDATIONS, MODIFY_IMAGE_PROVIDERS, MOTION_COLUMN, MOTION_TRANSFER_PROVIDERS, MUSIC_PROVIDERS, MatchCutVerdictSchema, NATIVE_ADAPTIVE_ASPECT, NATIVE_NEGATIVE_PROMPT_MODELS, NATIVE_NEGATIVE_VIDEO_PROVIDERS, NEGATIVE_PROMPT_MAX, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, NODE_DEFAULT_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_REF_PATTERN, NON_EN_LOCALE_IDS, NO_SPLIT_DELIMITER, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ASSET_VARIANTS, OBJECT_ATTACH_COLUMNS, OBJECT_MOTION_PROVIDERS, OBJECT_PICKER_NODE_TYPES, ORG_ERROR_CODES, ORG_KINDS, ORG_ROLES, ORG_STATUSES, OUTPUT_FIELD_MAP, OUTPUT_FORMATS, ObjectMetadataSchema, OptimizeForModelInputSchema, OptimizeForModelResultSchema, OrgSettingsSchema, PARAMETER_NODE_TYPES, PASSTHROUGH_TYPES, PAYG_RETENTION_DAYS, PER_FORMAT_DURATION_BOUNDS, PICKER_TO_COMBINE_TRANSITION, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, PLACEHOLDER_CHARACTER_NAME, PLATFORM_LABELS, PLATFORM_SPECS, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LABELS, PRESET_SETTING_KEYS, PRICING_DEFAULT_DURATION_SEC, PRICING_DEFAULT_RESOLUTION, PROMPT_HARD_CEILING, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PROVIDER_DIRECTIVE_DEFAULTS, PROVIDER_PLACEHOLDER_PREFIX, PipelineCompletedEventSchema, PipelineConfigSchema, PipelineDriftSummarySchema, PipelineEditorDecisionsReadyEventSchema, PipelineForkedEventSchema, PipelineInputSchema, PipelineMusicReadyEventSchema, PipelineStageNameSchema, PipelineStageStatusSchema, PipelineStateSchema, PipelineStatusSchema, PresetSettingsSchema, QA_CHECK_PROVIDERS, REDUCE_STRATEGIES, REDUCE_STRATEGY_IDS, REFERENCE_BOARD_PROVIDERS, REFERENCE_BOARD_TEMPLATES, REFERENCE_HANDLE_MAP, REFERENCE_ROLE_PRESETS, REF_HANDLE_CATEGORY, REF_IMAGE_MAX_LIMITS, REF_TOKEN_NAMESPACE_PREFIXES, RENDERING_SPEED_SUPPORT, REPEATABLE_NODE_TYPES, REPEAT_PLACEHOLDER, REPLICATE_LIP_SYNC_PROVIDERS, RESERVED_TEMPLATE_VARS, SCENE3D_ASSET_KINDS, SCENE3D_ASSET_ROLES, SCENE3D_ASSET_ROLE_KINDS, SCENE3D_CAMERA_TRACK_FORMAT, SCENE3D_CAMERA_TRACK_LIMITS, SCENE3D_CAMERA_TRACK_VERSION, SCENE3D_CLAY_LIGHTING_PRESETS, SCENE3D_DEFAULT_DURATION_SECONDS, SCENE3D_DEFAULT_ENTITY_CAPABILITIES, SCENE3D_DEFAULT_FPS, SCENE3D_EDIT_NODE_TYPE, SCENE3D_ENTITY_CAPABILITIES, SCENE3D_ENTITY_ROLES, SCENE3D_GENERATE_NODE_TYPE, SCENE3D_GLB_EXTRAS_ALLOWLIST, SCENE3D_GLB_EXTRAS_ENTITY_ID, SCENE3D_GLB_EXTRAS_MATERIAL_ROLE, SCENE3D_GLB_EXTRAS_SUBPART_ID, SCENE3D_LIMITS, SCENE3D_PLAN_FIELD, SCENE3D_PLAN_TYPE, SCENE3D_PRIMITIVES, SCENE3D_PRIMITIVE_MATERIAL_ROLE, SCENE3D_RENDERER_ASSET_KINDS, SCENE3D_SCHEMA_VERSION, SCENE3D_SCHEMA_VERSION_V2, SCENE3D_SUPPORTED_SCHEMA_VERSIONS, SCENE3D_V2_CONTENT_HASH_EXCLUDED, SCENE3D_V2_ENGINES, SCENE3D_V2_LIMITS, SCENE3D_V2_OVERRIDE_OPERATION_VERSION, SCENE3D_V2_PRIMITIVES, SCENE_HELPER_NAMES, SCRAPER_ACTOR_LABELS, SCRAPER_CREDIT_COSTS, SCRAPER_OUTPUT_FIELDS, SCRIPT_PROVIDERS, SEASONS, SECTION_BOARD, SECTION_KINDS, SEEDANCE_2_5_REF_LIMITS, SEEDANCE_2_CONTINUATION_REF_SEC, SEEDANCE_2_EXTEND_STITCH, SEEDANCE_2_PROVIDERS, SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER, SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC, SEEDANCE_2_REF_LIMITS, SEEDANCE_LIP_SYNC_PROVIDERS, SEED_SUPPORT, SEPARATOR_DISPLAY, SEPARATOR_PRESETS, SHEET_ASPECTS, SHEET_BACKGROUNDS, SHEET_PRESETS, SHEET_SKINS, SHEET_TYPES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, SLOT_TOKEN_RE, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SOCIAL_POST_NODE_TYPES, STAGE_PATCH_SCHEMA, STATIC_CAPTION_STYLES, STRUCTURAL_SECTIONS, STRUCTURED_VISION_MODELS, STUDIO_SHOT_TRANSIENT_KEYS, STUDIO_TRANSIENT_KEYS, SUBMISSION_STATUSES, SUNO_ADD_TRACK_MODELS, SUNO_FIELD_HANDLE_FIELDS, SUNO_HARD_CEILING, SUNO_MODELS, SUNO_SELECT_OPERATIONS, SUNO_TEXT_MAX, SUNO_TITLE_MAX, SUNO_TRACK_SOURCE_TYPES, SUNO_VERSION_PRICED_OPERATIONS, SUPPORTED_FONT_NAMES, SURROUND_DIRECTIONS, SWITCHX_BLOCK_FRAMES, SWITCHX_FRAME_TIERS, SceneHelperNameSchema, SceneInputModeSchema, SceneMetadataSchema, SceneNodeDataSchema, SceneSpecSchema, ScriptCriticVerdictSchema, ShotSpecSchema, ShowrunnerPlanSchema, StageAwaitingSubGateEventSchema, StoryboardCohesionCriticVerdictSchema, StyleDirectivesSchema, SubGateNameSchema, T2I_TO_I2I_VARIANT, TASK_CHAINED_EDIT_PROVIDERS, TEXT_TO_AUDIO_PROVIDERS, TEXT_TO_VIDEO_PROVIDERS, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, TILT_CARRIED_FRACTION, TOPAZ_DEFAULT_UPSCALE_FACTOR, TOPAZ_UPSCALE_FACTORS, TRANSCRIBE_PROVIDERS, TRANSIENT_RUNTIME_KEYS, TTS_PROVIDERS, TTS_TEXT_MAX, TWO_K_RESOLUTION_PROVIDERS, TransitionTypeSchema, UPSCALE_IMAGE_PROVIDERS, USAGE_GROUP_BYS, USAGE_MODES, VARIABLES_HANDLE_ID, VARIABLE_PRICING_MODELS, VEHICLES, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, VEO_PROVIDERS, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_BUCKET_CREDITS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_DURATION_BUCKETS, VIDEO_ANALYSIS_DURATION_TOLERANCE_SEC, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_LEGACY_MODELS, VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_MAX_DURATION_SEC, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_MIXED_TIERS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_LABELS, VIDEO_ANALYSIS_TIER_ORDER, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_ANALYSIS_WINDOW, VIDEO_AUDIO_CAPABILITY, VIDEO_AUDIT_BUCKET_CREDITS, VIDEO_CLIP_CREDITS, VIDEO_CRITIC_CREDITS_PER_SHOT, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_DURATION_TIERS, VIDEO_GEN_COLLAPSED_T2V_IDS, VIDEO_GEN_PROVIDERS, VIDEO_INPUT_LIP_SYNC_PROVIDERS, VIDEO_MODEL_CAPS, VIDEO_MODE_ALIASES, VIDEO_PRODUCER_TYPES, VIDEO_PROMPT_MAX, VIDEO_PROVIDERS_REQUIRING_IMAGE, VIDEO_PROVIDERS_WITHOUT_DISPATCH, VIDEO_REF_LIMITS_BY_PROVIDER, VIDEO_REF_VIDEO_DURATION_LIMITS, VIDEO_TO_VIDEO_PROVIDERS, VIDEO_UPSCALE_PROVIDERS, VIDEO_UTIL_PRICING, VIDEO_VARIABLE_PRICING, VOICE_CHANGER_MODELS, VOICE_CHANGER_MODEL_IDS, VOICE_DESIGN_MODELS, ValidateMatchCutInputSchema, ValidateMatchCutResultSchema, VideoCriticVerdictSchema, VoiceMatchSchema, WAN_3_DEFAULT_RESOLUTION, WAN_3_PROVIDERS, WARDROBE_VARIANTS, WEAPONS, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, WORKFLOW_VISIBILITIES, WORKSPACE_HEADER, WORKSPACE_HEADER_LOWER, WORKSPACE_ROLES, WorkspaceSettingsSchema, aggregateByType, aiAvatarReserveCreditId, analyzedSceneSchema, applyDefaultVideoSelection, applyHandleInputOverride, applyRange, applyRangeIndices, applyScene3DEditOperations, applyScene3DV2EditOperations, applySlots, applyVideoAudioToggle, applyVideoNegativePrompt, aspectRatioFromDims, aspectRatioOptionsByKind, aspectRatioToNumber, assembleNarratedVideoCredits, availableReasoningEfforts, bucketSecondsFromAuditCreditId, bucketSecondsFromCreditId, buildBoardPrompt, buildChildrenByParent, buildConditionVariables, buildCreditModelIdentifier, buildExpressionFromVisual, buildLipSyncCreditId, buildLlmCreditIdentifier, buildModelMenu, buildModelTree, buildMotionCreditModelIdentifier, buildNodePresetExport, buildPanelPrompt, buildProgressSegments, buildRangeLabel, buildScraperCreditId, buildVideoAnalysisCreditId, buildVideoAuditCreditId, buildVideoCreditModelIdentifier, calculateCombinedProgress, calculateMonetizationMarkup, calculateMonetizedCost, calculateProgress, canonicalScene3DPlanV2Json, canonicalVarName, characterBoardItems, characterBucketDisplayRank, characterMentionSlug, characterMentionableAssetArrays, characterSheetRefItems, characterVariantAssetArrays, checkRefVideoDurations, cinematicCreditId, clampCinematicDuration, clampSmartCutWindow, classifyRefToken, cleanOrphanedItems, clearImageCriticMetadata, clearVideoCriticMetadata, clipLookSchema, collectAncestorRefs, combineSameLabelRefs, computeAggregateLanes, computeScene3DPlanV2ContentHash, countRefModalityEdges, creditRangesAll, creditsToUsd, decodeProviderItem, defaultCarriedFraction, defaultResolutionFor, defaultRoleForSource, defaultVideoAspectRatio, deriveLinkedFields, deriveLottieSlotFields, deriveSlotRefs, describeEdgeBehavior, describeMaskRegion, describeNodeAdjustments, describeSlotControl, dropUnknownBindings, dropUnknownSpeakers, durationsByMode, effectiveReasoningEffort, encodeProviderItem, ensureLocaleCatalogLoaded, entityHydrationColumns, entityMentionSlug, entityMentionSlugForRef, entityScalarFields, entitySlotSchema, entryMatchesQuery, estimateCombineVideosCredits, estimateFilmCredits, estimateLoopTrimAddonCredits, estimateLoopVideoCredits, estimateScriptDurationSec, estimateSheetCost, estimateTrimVideoCredits, evaluateCondition, evaluateConditionGroup, evaluateJsonExpression, evaluateJsonPath, expandExtraRefsToConnectedReferences, expandItemsWithRepeat, extractAllGeneratedResults, extractCharacterLoraFields, extractGeneratedJsonAsList, extractPresetData, extractReferencedLabels, extractVideoDurationFromNode, fieldKeyFromHandle, filterCloneNodes, findCharacterMentionTokens, findEntityMentionTokens, findImageMentionTokens, findLocationMentionTokens, findSeedance2AudioOverLimit, firstSightExtraRole, flattenItems, getAnimal, getAnimalLabel, getAnimalPromptHint, getAnimalTerm, getAspectRatioOptions, getAudioCrossfadeCurve, getCharacterFacet, getCombineTransition, getCreditRange, getDurationsForModel, getEffectiveRepeatCount, getFeaturedEntities, getFurniture, getFurnitureLabel, getInputFieldSchema, getInputNodes, getItemSortId, getLipSyncMaxAudioSeconds, getLlmModalityCaps, getLlmModel, getLlmTier, getLocaleDirection, getMaxImagePromptChars, getMaxNegativePromptChars, getMaxSunoPromptChars, getMaxSunoStyleChars, getMaxTtsChars, getMaxVideoPromptChars, getModel, getNodeLabel, getNodeResult, getOutputNodes, getOutputType, getParameterValue, getQualityOptions, getResolutionOptions, getRouteReachableNodeIds, getStrategy, getTargetField, getValidValues, getVehicle, getVehicleLabel, getVideoAudioCapability, getWeapon, getWeaponLabel, groupByFamily, groupHandleId, groupLlmModelsByVendor, hasContiguousSegmentDurations, hasFeature, hexToRgbaArray, humanizeSlotSid, imageMentionSlug, imageMentionSlugForRef, imageReferenceLimit, inferMusicVideo, isAggregateableType, isCharacterAspectRatio, isCollectInEdge, isDefaultSelectorConfig, isExpandedClone, isFlux2Model, isGeminiOmniProvider, isGvpSupportedProvider, isHandleInputWired, isKineticCaptionStyle, isKnownScene3DEngine, isLocationUsageMode, isMinimaxH3Provider, isObjectAspectRatio, isOversizedScene, isPaygRetentionActive, isPerSecondLipSyncProvider, isScene3DCameraTrack, isScene3DHttpUrl, isScene3DPlan, isScene3DPlanV1, isScene3DPlanV2, isScene3DSchemaVersionSupported, isScraperActor, isSeedance2Provider, isTiltDirection, isUsageMode, isVeoProvider, isVideoAnalysisMixedTier, isVideoAnalysisTier, isWan3Provider, jsonResultToList, knownEntitySlugsFromRefs, knownImageSlugsFromRefs, listBoardTemplates, listModels, listSlotSids, llmRouteDefaults, locationMentionSlug, locationReferencePhotoKindLabel, locationUsageModeLabel, mapAspectRatio, mapQuality, mapShotIntentToProviderDirectives, matchVariant, maxSegmentSecFor, maxSegmentsFor, mergeClipLook, mergeExposedSettings, migrateEdgeOutputMode, migrateToItems, minSegmentSecFor, modelIdsByKindMode, modelToNodeTarget, modelsForInputMode, modelsWithFeature, motionGraphicsFeature, newScene3DRevisionId, normalizeLottieLayers, normalizeMinimaxH3Resolution, normalizeModelInput, normalizeNodeModelParams, normalizePinterestUrl, normalizeRoleSlug, normalizeVideoRequestParams, normalizeWan3Resolution, orderedLlmModels, parseAttributedDialogue, parseCharacterMentionToken, parseEntityMentionToken, parseGroupHandle, parseHandleId, parseImageMentionToken, parseListExpression, parseLocationMentionToken, parseNodePresetExport, parseNodeRef, parseScene3DCameraTrackJson, parseScene3DPlanV2Json, pickAiAvatarBucket, pickIds, pickLipSyncBucket, pickSwitchXFrameTier, pickVideoAnalysisBucket, planSheetGeneration, planSheetPanels, preferredInputModeForModel, presentTypes, presetApplyClearKeys, presetDataMatches, presetEntries, pricedVideoSelection, qualityOptionsByKind, readPromptAffixes, refHandleCategory, referenceModalityForHandle, referenceSheetCreditId, registerCatalogSidecars, registerSidecarLoaders, renderAnalyzedScene, resetCatalogSidecars, resolutionOptionsByKind, resolveAiAvatarCreditId, resolveAudioCrossfadeCurve, resolveCharacterAspectRatio, resolveCinematicCreditId, resolveConditionValue, resolveDefaultRole, resolveDescription, resolveDialogueVoices, resolveEffectiveSourceType, resolveEffectiveTier, resolveEntityAspect, resolveFieldMappings, resolveGvpAnchorWire, resolveImageGenCreditIdentifier, resolveIndex, resolveLabel, resolveListExpression, resolveLlmCreditId, resolveLocationFields, resolveLocationPresetCatalog, resolveLottieOverlaySrc, resolveNodeRefs, resolveNormalizedImageGen, resolveObjectAspectRatio, resolvePipelineModel, resolveRelativeWindowToken, resolveScraperCreditId, resolveSelectorRefs, resolveSeparator, resolveSheetSections, resolveSlideshowTransition, resolveSourceThroughConnectedList, resolveStoredTier, resolveSwitchXCreditId, resolveTopazUpscale, resolveVideoAnalysisModel, resolveVideoModeForInputs, resolveVideoProviderForMode, resolveXfadeName, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, rgbaArrayToHex, roleToPhrase, rotationVec3Schema, runSelector, safetyRetryPolicy, sanitizeRole, scaleVec3Schema, scene3DAcceptedSchemaVersionsSchema, scene3DAnchorNameSchema, scene3DAnchorSchema, scene3DAnyPlanSchema, scene3DAssetAnimationSchema, scene3DAssetIdSchema, scene3DAssetRefSchema, scene3DCameraChangesSchema, scene3DCameraKeyframeSchema, scene3DCameraSampleSchema, scene3DCameraSchema, scene3DCameraTrackIssues, scene3DCameraTrackObjectSchema, scene3DCameraTrackPlanIssues, scene3DCameraTrackSchema, scene3DClayLightingSchema, scene3DColorSchema, scene3DDeepEqual, scene3DEasingSchema, scene3DEditOperationSchema, scene3DEditOperationsSchema, scene3DEngineIdSchema, scene3DEntityAcceptsOverlay, scene3DEntityCapabilitySchema, scene3DEntityV2Schema, scene3DEntityVisualSchema, scene3DIdSchema, scene3DJsonByteLength, scene3DLightingChangesSchema, scene3DLightingSchema, scene3DMaterialBindingSchema, scene3DMaterialNameSchema, scene3DMaterialRoleSchema, scene3DNodeIdSchema, scene3DObjectChangesSchema, scene3DObjectKeyframeSchema, scene3DObjectSchema, scene3DOverrideSchema, scene3DPlanIssues, scene3DPlanSchema, scene3DPlanSchemaVersion, scene3DPlanV1Issues, scene3DPlanV1ObjectSchema, scene3DPlanV1Schema, scene3DPlanV2Issues, scene3DPlanV2ObjectSchema, scene3DPlanV2Schema, scene3DPrimitiveSchema, scene3DProjectionIssues, scene3DProvenanceSchema, scene3DReferenceSchema, scene3DSampleForFrame, scene3DSha256Schema, scene3DShotForFrame, scene3DShotIndexForFrame, scene3DShotSchema, scene3DUrlSchema, scene3DV2AdmissionIssues, scene3DV2EditOperationSchema, scene3DV2EditOperationsSchema, scene3DV2HierarchyDepth, scene3DV2NormalizationIssues, scene3DV2OverrideInputSchema, scene3DV2ResourceUsage, scene3DVersionTokenSchema, scene3DZodIssues, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, sizeVec3Schema, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripDerivedAnalysisFields, stripExportContent, stripStudioTransientSettings, stripTransientRuntimeData, summarizeScene3DOperations, sunoCreditType, supportedDefaultDimensions, supportsAdvancedMode, supportsEndAnchor, supportsExtendRender, toConnectedReference, toConnectedReferences, togglePick, tryParseJson, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unresolvedRefTokens, unwrapUnresolvedTokens, usageModeDirective, usageModeIncludesName, usageModeLabel, usdToCredits, validateAiAvatarPayload, validateCinematicAvatarPayload, validateDurationForFormat, validateModeActivation, validateModelInput, validateNoNestedGroups, validateObjects, validateProviderForNodeType, validateSubWorkflowRoutes, variantJobId, vec3Schema, verifyScene3DPlanV2ContentHash, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderFoldsLoneEndFrame, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };
14728
16526
  //# sourceMappingURL=index.js.map
14729
16527
  //# sourceMappingURL=index.js.map