@nebula-spatial/studio 0.0.0-stage → 0.1.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.
Files changed (251) hide show
  1. package/README.md +206 -3
  2. package/dist/ai/contract.d.ts +73 -0
  3. package/dist/ai/host.d.ts +28 -0
  4. package/dist/asset/dependency-scan.d.ts +78 -0
  5. package/dist/asset/intake.d.ts +84 -0
  6. package/dist/asset/layout-detect.d.ts +40 -0
  7. package/dist/asset/media-type.d.ts +10 -0
  8. package/dist/asset/model-inspection.d.ts +127 -0
  9. package/dist/asset/record.d.ts +35 -0
  10. package/dist/asset/remote-asset-resolver.d.ts +36 -0
  11. package/dist/asset/repairs.d.ts +53 -0
  12. package/dist/asset/resource-locator.d.ts +15 -0
  13. package/dist/asset/revision-diff.d.ts +33 -0
  14. package/dist/asset/source-contracts.d.ts +21 -0
  15. package/dist/asset/source-paths.d.ts +15 -0
  16. package/dist/asset/usd-inspection.d.ts +39 -0
  17. package/dist/asset/usd-source-metadata.d.ts +142 -0
  18. package/dist/asset/visual-intake.d.ts +27 -0
  19. package/dist/asset/visual-record.d.ts +22 -0
  20. package/dist/asset/web-intake.d.ts +46 -0
  21. package/dist/asset-source-BExlEcRt.js +444 -0
  22. package/dist/assets/usd-export-worker-BsGubtAE.js +1 -0
  23. package/dist/builders-BAXRR5o5.js +1854 -0
  24. package/dist/core/asset-task.d.ts +105 -0
  25. package/dist/core/context.d.ts +23 -0
  26. package/dist/core/host.d.ts +432 -0
  27. package/dist/core/persistence-controller.d.ts +58 -0
  28. package/dist/core/plugins.d.ts +139 -0
  29. package/dist/core/scene-tree.d.ts +62 -0
  30. package/dist/core/versions.d.ts +2 -0
  31. package/dist/core/when.d.ts +13 -0
  32. package/dist/core/write-policy.d.ts +29 -0
  33. package/dist/delivery/build-plan.d.ts +2 -0
  34. package/dist/delivery/contracts.d.ts +362 -0
  35. package/dist/delivery/digest.d.ts +3 -0
  36. package/dist/delivery/evidence.d.ts +10 -0
  37. package/dist/delivery/export-evidence.d.ts +3 -0
  38. package/dist/delivery/index.d.ts +9 -0
  39. package/dist/delivery/prim-name.d.ts +17 -0
  40. package/dist/delivery/profile.d.ts +4 -0
  41. package/dist/doc/builders.d.ts +99 -0
  42. package/dist/doc/command.d.ts +195 -0
  43. package/dist/doc/domain-extensions.d.ts +34 -0
  44. package/dist/doc/node-facts.d.ts +87 -0
  45. package/dist/doc/physics-facts.d.ts +74 -0
  46. package/dist/doc/placement-policy.d.ts +71 -0
  47. package/dist/doc/random-placement.d.ts +30 -0
  48. package/dist/doc/scene-graph.d.ts +80 -0
  49. package/dist/doc/scene-regions.d.ts +29 -0
  50. package/dist/doc/schema.d.ts +452 -0
  51. package/dist/doc/task.d.ts +71 -0
  52. package/dist/doc/validate.d.ts +68 -0
  53. package/dist/editor/asset-source.d.ts +15 -0
  54. package/dist/editor/editor.d.ts +246 -0
  55. package/dist/editor/index.d.ts +22 -0
  56. package/dist/editor/shortcuts.d.ts +2 -0
  57. package/dist/editor/types.d.ts +143 -0
  58. package/dist/editor/ui-plugins.d.ts +64 -0
  59. package/dist/editor.js +1755 -0
  60. package/dist/editorial-BkAFWfbg.js +83 -0
  61. package/dist/export-evidence-B_0zRmb8.js +5027 -0
  62. package/dist/generalization/domain.d.ts +10 -0
  63. package/dist/generalization/generalization.d.ts +371 -0
  64. package/dist/generalization/index.d.ts +11 -0
  65. package/dist/generalization.js +1659 -0
  66. package/dist/history/undo-stack.d.ts +74 -0
  67. package/dist/index.d.ts +91 -0
  68. package/dist/index.js +2839 -0
  69. package/dist/persist/content-addressed.d.ts +11 -0
  70. package/dist/persist/create-scene-package-from-host.d.ts +7 -0
  71. package/dist/persist/indexeddb-store.d.ts +69 -0
  72. package/dist/persist/scene-file.d.ts +52 -0
  73. package/dist/persist/scene-package.d.ts +8 -0
  74. package/dist/persist/snapshot.d.ts +5 -0
  75. package/dist/physics-facts-tfQYyNTD.js +337 -0
  76. package/dist/placement-policy-DY_FNRDu.js +405 -0
  77. package/dist/ports/asset-ingestor.d.ts +41 -0
  78. package/dist/ports/asset-source.d.ts +57 -0
  79. package/dist/ports/delivery.d.ts +13 -0
  80. package/dist/ports/persistence.d.ts +29 -0
  81. package/dist/project/asset-catalog.d.ts +21 -0
  82. package/dist/project/contracts.d.ts +272 -0
  83. package/dist/project/editorial.d.ts +16 -0
  84. package/dist/project/identity.d.ts +20 -0
  85. package/dist/project/index.d.ts +9 -0
  86. package/dist/project/scene-document.d.ts +5 -0
  87. package/dist/project/source-dependencies.d.ts +7 -0
  88. package/dist/remote-asset-resolver-Cb8cfNmw.js +136 -0
  89. package/dist/scene/index.d.ts +12 -0
  90. package/dist/scene-graph-DBLKAhxa.js +681 -0
  91. package/dist/scene-session-BV1HnxNh.js +3506 -0
  92. package/dist/scene.js +244 -0
  93. package/dist/studio/delivery-catalog.d.ts +28 -0
  94. package/dist/studio/in-memory-asset-source.d.ts +15 -0
  95. package/dist/studio/index.d.ts +31 -0
  96. package/dist/studio/indexeddb-asset-source.d.ts +32 -0
  97. package/dist/studio/indexeddb-persistence.d.ts +13 -0
  98. package/dist/studio/remote-asset-importer.d.ts +56 -0
  99. package/dist/studio/source-package.d.ts +9 -0
  100. package/dist/studio/usd-export-client.d.ts +13 -0
  101. package/dist/studio/usd-export-protocol.d.ts +98 -0
  102. package/dist/studio/usd-export-worker.d.ts +1 -0
  103. package/dist/studio/usd-zip-reader.d.ts +14 -0
  104. package/dist/studio/web-asset-ingestor.d.ts +10 -0
  105. package/dist/studio/web-host.d.ts +8 -0
  106. package/dist/studio.js +5544 -0
  107. package/dist/util/asset-facts.d.ts +3 -0
  108. package/dist/util/data.d.ts +17 -0
  109. package/dist/util/diagnostics.d.ts +38 -0
  110. package/dist/util/geometry.d.ts +11 -0
  111. package/dist/util/hash.d.ts +9 -0
  112. package/dist/util/ids.d.ts +20 -0
  113. package/dist/util/math.d.ts +47 -0
  114. package/dist/util/ply-metadata.d.ts +19 -0
  115. package/dist/util/studio-source.d.ts +23 -0
  116. package/dist/version.d.ts +5 -0
  117. package/dist/view/appearance.d.ts +13 -0
  118. package/dist/view/authoring-appearance.d.ts +25 -0
  119. package/dist/view/bounds-preview.d.ts +34 -0
  120. package/dist/view/bounds.d.ts +11 -0
  121. package/dist/view/camera-zoom.d.ts +3 -0
  122. package/dist/view/geometry-anchors.d.ts +20 -0
  123. package/dist/view/gizmo-appearance.d.ts +5 -0
  124. package/dist/view/gizmo.d.ts +81 -0
  125. package/dist/view/group-selection.d.ts +13 -0
  126. package/dist/view/node-features.d.ts +39 -0
  127. package/dist/view/picking.d.ts +49 -0
  128. package/dist/view/placement.d.ts +48 -0
  129. package/dist/view/region-editing.d.ts +25 -0
  130. package/dist/view/rotation-guide.d.ts +36 -0
  131. package/dist/view/runtime-capabilities.d.ts +22 -0
  132. package/dist/view/scene-session.d.ts +258 -0
  133. package/dist/view/screen-bounds.d.ts +17 -0
  134. package/dist/view/selection-transform.d.ts +20 -0
  135. package/node_modules/@nebula-spatial/cad-loader/CHANGELOG.md +48 -0
  136. package/node_modules/@nebula-spatial/cad-loader/README.md +108 -0
  137. package/node_modules/@nebula-spatial/cad-loader/dist/core/cad-types.d.ts +26 -0
  138. package/node_modules/@nebula-spatial/cad-loader/dist/core/errors.d.ts +5 -0
  139. package/node_modules/@nebula-spatial/cad-loader/dist/core/index.d.ts +24 -0
  140. package/node_modules/@nebula-spatial/cad-loader/dist/core/index.js +2354 -0
  141. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/bin-group-reader.d.ts +9 -0
  142. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/bin-parser.d.ts +78 -0
  143. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/dxbs-sidecar.d.ts +24 -0
  144. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/geometry-segments.d.ts +20 -0
  145. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/text-roundtrip.d.ts +4 -0
  146. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/types.d.ts +81 -0
  147. package/node_modules/@nebula-spatial/cad-loader/dist/core/runtime-text-decoder.d.ts +8 -0
  148. package/node_modules/@nebula-spatial/cad-loader/dist/core/types.d.ts +153 -0
  149. package/node_modules/@nebula-spatial/cad-loader/dist/core/utils/insert-bbox.d.ts +10 -0
  150. package/node_modules/@nebula-spatial/cad-loader/dist/core/utils/viewport-rect.d.ts +21 -0
  151. package/node_modules/@nebula-spatial/cad-loader/dist/index.d.ts +36 -0
  152. package/node_modules/@nebula-spatial/cad-loader/dist/index.js +5829 -0
  153. package/node_modules/@nebula-spatial/cad-loader/dist/loader/geo-loader.d.ts +59 -0
  154. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/automatic-external-resources.d.ts +26 -0
  155. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/external-variant-sidecar-fetch.d.ts +13 -0
  156. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/flow-control.d.ts +29 -0
  157. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/frame-budget-scheduler.d.ts +21 -0
  158. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-compact-executor.d.ts +19 -0
  159. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-local-adapter.d.ts +2 -0
  160. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-pipeline.d.ts +92 -0
  161. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-worker-adapter.d.ts +13 -0
  162. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node-builder.d.ts +34 -0
  163. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node-load-sink.d.ts +28 -0
  164. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node.d.ts +304 -0
  165. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare-worker-types.d.ts +94 -0
  166. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare.d.ts +38 -0
  167. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare.worker.d.ts +1 -0
  168. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/insert-model-builder.d.ts +10 -0
  169. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/insert-runtime-geometry.d.ts +15 -0
  170. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/line-canonical.d.ts +37 -0
  171. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/line-quality.d.ts +9 -0
  172. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/prepare-credit-gate.d.ts +20 -0
  173. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/transport.d.ts +2 -0
  174. package/node_modules/@nebula-spatial/cad-loader/dist/render-resource/cad-render-node.d.ts +80 -0
  175. package/node_modules/@nebula-spatial/cad-loader/dist/render-resource/geo-node-cad-render-node.d.ts +12 -0
  176. package/node_modules/@nebula-spatial/cad-loader/dist/scene/geo-cad-line-geometry.d.ts +28 -0
  177. package/node_modules/@nebula-spatial/cad-loader/dist/scene/geo-cad-line-material.d.ts +18 -0
  178. package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/block-geometry-registry.d.ts +35 -0
  179. package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/insert-instance-table.d.ts +23 -0
  180. package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/viewport-instance-presenter.d.ts +66 -0
  181. package/node_modules/@nebula-spatial/cad-loader/dist/selection/cad-insert-selection.d.ts +35 -0
  182. package/node_modules/@nebula-spatial/cad-loader/dist/selection/cad-text-selection.d.ts +31 -0
  183. package/node_modules/@nebula-spatial/cad-loader/dist/session/annotation-idle-gate.d.ts +14 -0
  184. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-document-session.d.ts +187 -0
  185. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-font-runtime.d.ts +11 -0
  186. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-insert-id.d.ts +6 -0
  187. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-text-warmup.d.ts +38 -0
  188. package/node_modules/@nebula-spatial/cad-loader/dist/session/create-cad-document-session.d.ts +5 -0
  189. package/node_modules/@nebula-spatial/cad-loader/dist/session/load-session.d.ts +90 -0
  190. package/node_modules/@nebula-spatial/cad-loader/dist/session/viewport-coverage.d.ts +32 -0
  191. package/node_modules/@nebula-spatial/cad-loader/dist/shared/abort.d.ts +3 -0
  192. package/node_modules/@nebula-spatial/cad-loader/dist/shared/cad-display-color.d.ts +55 -0
  193. package/node_modules/@nebula-spatial/cad-loader/dist/shared/cad-load-source.d.ts +8 -0
  194. package/node_modules/@nebula-spatial/cad-loader/dist/shared/color-buffer.d.ts +6 -0
  195. package/node_modules/@nebula-spatial/cad-loader/dist/shared/constants.d.ts +11 -0
  196. package/node_modules/@nebula-spatial/cad-loader/dist/shared/display-color-buffer.d.ts +27 -0
  197. package/node_modules/@nebula-spatial/cad-loader/dist/shared/errors.d.ts +2 -0
  198. package/node_modules/@nebula-spatial/cad-loader/dist/shared/text-builder.d.ts +25 -0
  199. package/node_modules/@nebula-spatial/cad-loader/dist/shared/text-font.d.ts +12 -0
  200. package/node_modules/@nebula-spatial/cad-loader/dist/shared/types.d.ts +57 -0
  201. package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/insert-bbox.d.ts +1 -0
  202. package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/timing.d.ts +2 -0
  203. package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/viewport-rect.d.ts +1 -0
  204. package/node_modules/@nebula-spatial/cad-loader/dist/shared/viewer-theme.d.ts +2 -0
  205. package/node_modules/@nebula-spatial/cad-loader/dist/workers/geo-prepare.worker.js +2264 -0
  206. package/node_modules/@nebula-spatial/cad-loader/package.json +62 -0
  207. package/node_modules/@nebula-spatial/viewer/CHANGELOG.md +426 -0
  208. package/node_modules/@nebula-spatial/viewer/FBX-MATERIAL-CONVERSION.md +97 -0
  209. package/node_modules/@nebula-spatial/viewer/README.md +1056 -0
  210. package/node_modules/@nebula-spatial/viewer/USD-VISUAL-MATERIAL-SUPPORT.md +89 -0
  211. package/node_modules/@nebula-spatial/viewer/basis/basis_transcoder.js +19 -0
  212. package/node_modules/@nebula-spatial/viewer/basis/basis_transcoder.wasm +0 -0
  213. package/node_modules/@nebula-spatial/viewer/dist/asset-ir-DEOK9SqE.js +382 -0
  214. package/node_modules/@nebula-spatial/viewer/dist/assets/ground-grid.d.ts +6 -0
  215. package/node_modules/@nebula-spatial/viewer/dist/assets/source-types.d.ts +19 -0
  216. package/node_modules/@nebula-spatial/viewer/dist/assets/types.d.ts +393 -0
  217. package/node_modules/@nebula-spatial/viewer/dist/assets/usd-worker-Bom5cjz3.js +1392 -0
  218. package/node_modules/@nebula-spatial/viewer/dist/cad/text.d.ts +2 -0
  219. package/node_modules/@nebula-spatial/viewer/dist/cad/types.d.ts +368 -0
  220. package/node_modules/@nebula-spatial/viewer/dist/index-ByBlfVc0.js +12132 -0
  221. package/node_modules/@nebula-spatial/viewer/dist/index.d.ts +32 -0
  222. package/node_modules/@nebula-spatial/viewer/dist/index.js +26 -0
  223. package/node_modules/@nebula-spatial/viewer/dist/inspection/types.d.ts +112 -0
  224. package/node_modules/@nebula-spatial/viewer/dist/mjcf-visual-DVRa0w90.js +72 -0
  225. package/node_modules/@nebula-spatial/viewer/dist/mujoco-runtime-Dhx6Ua2u.js +463 -0
  226. package/node_modules/@nebula-spatial/viewer/dist/plugins.d.ts +179 -0
  227. package/node_modules/@nebula-spatial/viewer/dist/scene/instances.d.ts +36 -0
  228. package/node_modules/@nebula-spatial/viewer/dist/scene/types.d.ts +258 -0
  229. package/node_modules/@nebula-spatial/viewer/dist/session-B-j6KdA-.js +389 -0
  230. package/node_modules/@nebula-spatial/viewer/dist/session-B4AICTeJ.js +963 -0
  231. package/node_modules/@nebula-spatial/viewer/dist/session-BAG5cDYe.js +9153 -0
  232. package/node_modules/@nebula-spatial/viewer/dist/simulation/mujoco-runtime.d.ts +118 -0
  233. package/node_modules/@nebula-spatial/viewer/dist/simulation/mujoco-wasm-module.d.ts +11 -0
  234. package/node_modules/@nebula-spatial/viewer/dist/simulation/openusd-wasm-module.d.ts +10 -0
  235. package/node_modules/@nebula-spatial/viewer/dist/simulation/physics-runtime-state.d.ts +75 -0
  236. package/node_modules/@nebula-spatial/viewer/dist/simulation/types.d.ts +129 -0
  237. package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-inspection.d.ts +66 -0
  238. package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-query.d.ts +50 -0
  239. package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-resource-policy.d.ts +28 -0
  240. package/node_modules/@nebula-spatial/viewer/dist/types.d.ts +278 -0
  241. package/node_modules/@nebula-spatial/viewer/dist/ui/types.d.ts +48 -0
  242. package/node_modules/@nebula-spatial/viewer/dist/urdf-session-kemAnBn8.js +3231 -0
  243. package/node_modules/@nebula-spatial/viewer/dist/usd-session-QtwGKI7v.js +6771 -0
  244. package/node_modules/@nebula-spatial/viewer/dist/version.d.ts +5 -0
  245. package/node_modules/@nebula-spatial/viewer/dist/viewer.d.ts +2 -0
  246. package/node_modules/@nebula-spatial/viewer/dist/xacro-CYTPS7mh.js +1537 -0
  247. package/node_modules/@nebula-spatial/viewer/openusd/openusd-runtime-manifest.json +15 -0
  248. package/node_modules/@nebula-spatial/viewer/openusd/openusd_probe.js +14 -0
  249. package/node_modules/@nebula-spatial/viewer/openusd/openusd_probe.wasm +0 -0
  250. package/node_modules/@nebula-spatial/viewer/package.json +66 -0
  251. package/package.json +87 -6
@@ -0,0 +1,105 @@
1
+ import type { AssetRevision } from '../asset/record';
2
+ import type { InstanceRole, LocalTransform, ObjectSemantic, PhysicsOverride, SceneAppearance, VisualAppearance, VisualAssetRevision, VisualRenderLayer, VisualSelectionMode } from '../doc/schema';
3
+ import type { Diagnostic } from '../util/diagnostics';
4
+ import type { StudioAssetProgress } from '../ports/asset-ingestor';
5
+ import type { StudioAssetSource } from '../ports/asset-source';
6
+ export type { StudioAssetIngestOptions, StudioAssetProgress, StudioAssetProgressStage, } from '../ports/asset-ingestor';
7
+ export type StudioAssetTaskStatus = 'preparing' | 'ready' | 'committing' | 'committed' | 'partial' | 'failed' | 'cancelled' | 'stale';
8
+ export type StudioPreparedAssetStatus = 'ready' | 'persisting' | 'committed' | 'failed' | 'cancelled';
9
+ export interface StudioAssetPrepareOptions {
10
+ readonly taskId?: string;
11
+ readonly operationId?: string;
12
+ readonly signal?: AbortSignal;
13
+ readonly onProgress?: (progress: StudioAssetProgress) => void;
14
+ }
15
+ export interface StudioPreparedAssetItem {
16
+ readonly itemId: string;
17
+ /** Stable intake identity used to retry only failed items. */
18
+ readonly sourceKey: string;
19
+ readonly kind: 'asset' | 'visual';
20
+ readonly label: string;
21
+ readonly status: StudioPreparedAssetStatus;
22
+ readonly revision: AssetRevision | VisualAssetRevision;
23
+ readonly source: StudioAssetSource;
24
+ readonly diagnostics: readonly Diagnostic[];
25
+ }
26
+ export interface StudioPreparedAssetBatch {
27
+ readonly taskId: string;
28
+ readonly operationId: string;
29
+ readonly status: StudioAssetTaskStatus;
30
+ readonly sceneEpoch: number;
31
+ readonly baseDocumentVersion: number;
32
+ readonly items: readonly StudioPreparedAssetItem[];
33
+ readonly diagnostics: readonly Diagnostic[];
34
+ readonly entryCandidates: readonly string[];
35
+ }
36
+ /**
37
+ * Optional node creation intent for one prepared asset item. Match by itemId or
38
+ * sourceKey. Camera and platform policy remain the caller's responsibility.
39
+ */
40
+ export interface StudioAssetPlacementIntent {
41
+ readonly itemId?: string;
42
+ readonly sourceKey?: string;
43
+ /** Caller-selected stable ID. Omit to let the Host derive one from the operation identity. */
44
+ readonly nodeId?: string;
45
+ /** A scene-group preserves one source reference below a transformable group. */
46
+ readonly importShape?: {
47
+ readonly kind: 'object';
48
+ } | {
49
+ readonly kind: 'scene-group';
50
+ readonly contentLabel?: string;
51
+ };
52
+ readonly label?: string;
53
+ readonly parentNodeId?: string;
54
+ readonly localTransform?: LocalTransform;
55
+ readonly visible?: boolean;
56
+ readonly role?: InstanceRole;
57
+ readonly physics?: PhysicsOverride;
58
+ readonly variantSelections?: Readonly<Record<string, string>>;
59
+ readonly initialPose?: Readonly<Record<string, number>>;
60
+ readonly appearance?: SceneAppearance | VisualAppearance;
61
+ readonly semantic?: ObjectSemantic;
62
+ readonly renderLayer?: VisualRenderLayer;
63
+ readonly selectionMode?: VisualSelectionMode;
64
+ }
65
+ export type StudioAssetCommitScope = 'asset-library' | 'scene-import';
66
+ export interface StudioAssetCommitOptions {
67
+ readonly expectedDocumentVersion?: number;
68
+ readonly expectedSceneEpoch?: number;
69
+ readonly signal?: AbortSignal;
70
+ /** Present only when the caller explicitly wants to create scene nodes. */
71
+ readonly placementIntents?: readonly StudioAssetPlacementIntent[];
72
+ }
73
+ export interface StudioAssetTaskSnapshot {
74
+ readonly taskId: string;
75
+ readonly operationId: string;
76
+ readonly status: StudioAssetTaskStatus;
77
+ readonly sceneEpoch: number;
78
+ readonly baseDocumentVersion: number;
79
+ readonly progress: StudioAssetProgress;
80
+ readonly items: readonly Pick<StudioPreparedAssetItem, 'itemId' | 'sourceKey' | 'kind' | 'label' | 'status' | 'diagnostics'>[];
81
+ readonly diagnostics: readonly Diagnostic[];
82
+ readonly error: string | null;
83
+ readonly canCancel: boolean;
84
+ readonly canRetry: boolean;
85
+ }
86
+ export interface StudioAssetCommitReceipt {
87
+ readonly scope: StudioAssetCommitScope;
88
+ readonly operationId: string;
89
+ readonly taskId: string;
90
+ readonly itemKey: string;
91
+ readonly itemDigest: string;
92
+ readonly sceneEpoch: number;
93
+ readonly documentVersion: number;
94
+ readonly committedAt: string;
95
+ readonly createdAssetRevisionIds: readonly string[];
96
+ readonly createdVisualRevisionIds: readonly string[];
97
+ readonly createdNodeIds: readonly string[];
98
+ }
99
+ export interface StudioAssetCommitResult {
100
+ readonly scope: StudioAssetCommitScope;
101
+ readonly status: StudioAssetTaskStatus;
102
+ readonly receipt: StudioAssetCommitReceipt | null;
103
+ readonly diagnostics: readonly Diagnostic[];
104
+ readonly items: readonly StudioPreparedAssetItem[];
105
+ }
@@ -0,0 +1,23 @@
1
+ import type { StudioHostSnapshot } from './host';
2
+ import type { StudioContextFacts } from './when';
3
+ export interface StudioContextCapabilities {
4
+ readonly canPersist: boolean;
5
+ readonly hasAssets: boolean;
6
+ readonly hasSelection: boolean;
7
+ readonly hasMultipleSelection: boolean;
8
+ readonly hasEditableSelection: boolean;
9
+ readonly hasPhysicsSelection: boolean;
10
+ }
11
+ export interface StudioContext {
12
+ readonly snapshot: StudioHostSnapshot;
13
+ readonly capabilities: StudioContextCapabilities;
14
+ readonly activePluginIds: readonly string[];
15
+ readonly facts: StudioContextFacts;
16
+ }
17
+ export interface CreateStudioContextOptions {
18
+ readonly snapshot: StudioHostSnapshot;
19
+ readonly canPersist: boolean;
20
+ readonly activePluginIds: readonly string[];
21
+ readonly extraFacts?: StudioContextFacts;
22
+ }
23
+ export declare function createStudioContext(options: CreateStudioContextOptions): StudioContext;
@@ -0,0 +1,432 @@
1
+ import type { AssetRevision } from '../asset/record';
2
+ import type { CommandRecord } from '../doc/command';
3
+ import { type StudioDocumentDomainExtension, type StudioDocumentDomainPurpose } from '../doc/domain-extensions';
4
+ import { type SceneAppearance, type SceneDocument, type InstanceRole, type InitialPose, type ObjectSemantic, type PhysicsOverride, type StudioExternalAssetRef, type StudioEditorialState, type Vec3, type VisualAssetRevision } from '../doc/schema';
5
+ export type { StudioEditorialState } from '../doc/schema';
6
+ import type { HistoryOptions, HistoryState } from '../history/undo-stack';
7
+ import type { BuildUsdDeliveryPlanInputV4, UsdDeliveryPlanV4 } from '../delivery/contracts';
8
+ import type { StudioStateSnapshot } from '../persist/snapshot';
9
+ export type { StudioStateSnapshot } from '../persist/snapshot';
10
+ import type { StudioSupportContact } from '../doc/placement-policy';
11
+ import { type Diagnostic } from '../util/diagnostics';
12
+ import { type StudioSourceBundle } from '../util/studio-source';
13
+ import type { StudioAssetIngestor, StudioAssetInput } from '../ports/asset-ingestor';
14
+ import type { StudioAssetCommitResult, StudioAssetCommitOptions, StudioAssetPrepareOptions, StudioAssetTaskSnapshot, StudioPreparedAssetBatch } from './asset-task';
15
+ import type { StudioContext } from './context';
16
+ import type { StudioActionContribution, StudioPlugin } from './plugins';
17
+ import { StudioPluginHost } from './plugins';
18
+ import type { StudioContextFacts } from './when';
19
+ import type { StudioAssetSource, StudioAssetSourceProvider, StudioAssetSourceResolveOptions, StudioPreparedAsset } from '../ports/asset-source';
20
+ import type { StudioPersistenceAdapter, StudioPersistenceReceipt, StudioPersistenceState } from '../ports/persistence';
21
+ import { getStudioPhysicsFacts } from '../doc/physics-facts';
22
+ import { getStudioNodeFrame, getStudioSelectionFrame, getStudioAssetDimensions } from '../doc/node-facts';
23
+ import type { StudioEffectiveNodeState, StudioSceneTreeSnapshot } from './scene-tree';
24
+ export type { StudioTransactionKind, StudioWriteDecision, StudioWritePolicy, StudioWriteRequest, } from './write-policy';
25
+ export interface StudioSelection {
26
+ /** These are SceneNode nodeIds; the field name is kept for the selection API. */
27
+ readonly instanceIds: readonly string[];
28
+ readonly primaryId: string | null;
29
+ }
30
+ export interface LoadedStudioAsset {
31
+ readonly revision: AssetRevision;
32
+ readonly source: StudioAssetSource;
33
+ }
34
+ export interface LoadedStudioVisualAsset {
35
+ readonly revision: VisualAssetRevision;
36
+ readonly source: StudioAssetSource;
37
+ }
38
+ export interface StudioAssetLoadResult {
39
+ readonly status: 'loaded' | 'needs-entry' | 'blocked';
40
+ readonly assets: readonly LoadedStudioAsset[];
41
+ readonly diagnostics: readonly Diagnostic[];
42
+ readonly entryCandidates: readonly string[];
43
+ }
44
+ export interface StudioBoundingBoxDimensions {
45
+ readonly length: number;
46
+ readonly width: number;
47
+ readonly height: number;
48
+ }
49
+ export interface StudioBoundingBoxInput {
50
+ readonly parentNodeId?: string;
51
+ readonly label: string;
52
+ readonly dimensions: StudioBoundingBoxDimensions;
53
+ readonly localUpDirection?: Vec3;
54
+ readonly position?: Vec3;
55
+ readonly role?: InstanceRole;
56
+ readonly visible?: boolean;
57
+ readonly assetRevisionId?: string;
58
+ readonly externalRef?: StudioExternalAssetRef | null;
59
+ readonly semantic?: ObjectSemantic;
60
+ }
61
+ export type StudioReplaceModelExpected = {
62
+ readonly kind: 'asset';
63
+ readonly assetId: string;
64
+ readonly revisionId: string;
65
+ } | {
66
+ readonly kind: 'placeholder';
67
+ };
68
+ export type StudioReplaceModelReplacement = {
69
+ readonly kind: 'asset';
70
+ readonly prepared: StudioPreparedAsset;
71
+ readonly variantSelections?: Readonly<Record<string, string>>;
72
+ readonly physics?: PhysicsOverride;
73
+ readonly initialPose?: InitialPose | null;
74
+ readonly label?: string;
75
+ readonly appearance?: SceneAppearance | null;
76
+ readonly semantic?: ObjectSemantic | null;
77
+ } | {
78
+ readonly kind: 'placeholder';
79
+ readonly dimensions: StudioBoundingBoxDimensions;
80
+ readonly localUpDirection?: Vec3;
81
+ readonly externalRef?: StudioExternalAssetRef | null;
82
+ readonly assetRevisionId?: string | null;
83
+ readonly label?: string;
84
+ readonly semantic?: ObjectSemantic | null;
85
+ };
86
+ export interface StudioReplaceModelInput {
87
+ readonly nodeIds: readonly string[];
88
+ readonly expected: StudioReplaceModelExpected;
89
+ readonly replacement: StudioReplaceModelReplacement;
90
+ readonly signal?: AbortSignal;
91
+ readonly expectedDocumentVersion?: number;
92
+ readonly expectedSceneEpoch?: number;
93
+ /** Allows replacing the asset identity while preserving the instance transform. */
94
+ readonly identityPolicy?: 'preserve-asset' | 'replace-asset';
95
+ }
96
+ export interface StudioOpenResult {
97
+ readonly ok: boolean;
98
+ readonly diagnostics: readonly Diagnostic[];
99
+ readonly document: SceneDocument;
100
+ }
101
+ export interface StudioCommandResult {
102
+ readonly changed: boolean;
103
+ readonly diagnostics: readonly Diagnostic[];
104
+ readonly document: SceneDocument;
105
+ /** Nodes created by this committed transaction. */
106
+ readonly createdNodeIds: readonly string[];
107
+ }
108
+ export type StudioTransactionTargetPolicy = 'selection' | 'explicit';
109
+ export interface StudioTransactionRequest {
110
+ readonly commands: readonly CommandRecord[];
111
+ readonly expectedDocumentVersion?: number;
112
+ readonly expectedSceneEpoch?: number;
113
+ readonly expectedSelectionVersion?: number;
114
+ readonly expectedTargetNodeIds?: readonly string[];
115
+ /** Defaults to explicit when expectedTargetNodeIds is present. */
116
+ readonly expectedTargetPolicy?: StudioTransactionTargetPolicy;
117
+ readonly gestureCommit?: boolean;
118
+ /** Applies only to this transaction; existing overlap is never revalidated globally. */
119
+ readonly allowOverlapNodeIds?: readonly string[];
120
+ /** Exact moved/support contacts allowed to touch for this transaction only. */
121
+ readonly supportContacts?: readonly StudioSupportContact[];
122
+ }
123
+ export interface StudioActionRunOptions {
124
+ readonly signal?: AbortSignal;
125
+ readonly expectedDocumentVersion?: number;
126
+ readonly expectedSceneEpoch?: number;
127
+ readonly expectedSelectionVersion?: number;
128
+ readonly targetIds?: readonly string[];
129
+ }
130
+ export interface StudioTransactionPreview {
131
+ readonly changed: boolean;
132
+ readonly diagnostics: readonly Diagnostic[];
133
+ readonly documentVersion: number;
134
+ readonly sceneEpoch: number;
135
+ }
136
+ export declare class StudioTransactionError extends Error {
137
+ readonly code: string;
138
+ readonly diagnostics: readonly Diagnostic[];
139
+ constructor(code: string, message: string, diagnostics?: readonly Diagnostic[]);
140
+ }
141
+ export interface StudioHostSnapshot {
142
+ readonly documentVersion: number;
143
+ readonly sceneEpoch: number;
144
+ readonly selectionVersion: number;
145
+ readonly document: SceneDocument;
146
+ readonly selection: StudioSelection;
147
+ readonly editorial: Readonly<Record<string, StudioEditorialState>>;
148
+ readonly history: HistoryState;
149
+ readonly assets: readonly AssetRevision[];
150
+ readonly visualAssets: readonly VisualAssetRevision[];
151
+ readonly persistence: StudioPersistenceState;
152
+ }
153
+ export type StudioHostEvent = {
154
+ readonly type: 'ready';
155
+ readonly snapshot: StudioHostSnapshot;
156
+ } | {
157
+ readonly type: 'document.change';
158
+ readonly origin: 'command' | 'undo' | 'redo' | 'open' | 'replace';
159
+ readonly snapshot: StudioHostSnapshot;
160
+ readonly commands?: readonly CommandRecord[];
161
+ } | {
162
+ readonly type: 'selection.change';
163
+ readonly snapshot: StudioHostSnapshot;
164
+ readonly selection: StudioSelection;
165
+ } | {
166
+ readonly type: 'editorial.change';
167
+ readonly snapshot: StudioHostSnapshot;
168
+ readonly nodeId: string;
169
+ readonly nodeIds?: readonly string[];
170
+ } | {
171
+ readonly type: 'asset.loaded';
172
+ readonly snapshot: StudioHostSnapshot;
173
+ readonly asset: LoadedStudioAsset;
174
+ } | {
175
+ readonly type: 'visual-asset.loaded';
176
+ readonly snapshot: StudioHostSnapshot;
177
+ readonly asset: LoadedStudioVisualAsset;
178
+ } | {
179
+ readonly type: 'asset.task';
180
+ readonly snapshot: StudioHostSnapshot;
181
+ readonly task: StudioAssetTaskSnapshot;
182
+ } | {
183
+ readonly type: 'persistence.change';
184
+ readonly snapshot: StudioHostSnapshot;
185
+ } | {
186
+ readonly type: 'persistence.saved';
187
+ readonly snapshot: StudioHostSnapshot;
188
+ readonly currentSnapshot: StudioHostSnapshot;
189
+ readonly receipt: StudioPersistenceReceipt;
190
+ } | {
191
+ readonly type: 'disposed';
192
+ readonly snapshot: StudioHostSnapshot;
193
+ };
194
+ export interface StudioHostOptions {
195
+ readonly document?: SceneDocument;
196
+ readonly persistence?: StudioPersistenceAdapter | null;
197
+ /** Close a supplied persistence adapter on Host dispose. Defaults to false. */
198
+ readonly ownsPersistence?: boolean;
199
+ readonly assetIngestor?: StudioAssetIngestor;
200
+ readonly assetSourceProvider?: StudioAssetSourceProvider | null;
201
+ /** Dispose a supplied source provider on Host dispose. Defaults to false. */
202
+ readonly ownsAssetSourceProvider?: boolean;
203
+ readonly corePlugins?: readonly StudioPlugin[];
204
+ readonly domainExtensions?: readonly StudioDocumentDomainExtension[];
205
+ readonly history?: HistoryOptions;
206
+ readonly now?: () => string;
207
+ readonly createId?: () => string;
208
+ readonly onError?: (error: unknown, event: StudioHostEvent) => void;
209
+ }
210
+ /** Read-only Host surface exposed to checkers, inspectors and exporters. */
211
+ export interface StudioReadOnlyHost {
212
+ readonly document: SceneDocument;
213
+ readonly canPersist: boolean;
214
+ getSnapshot(): StudioHostSnapshot;
215
+ getContext(extraFacts?: StudioContextFacts): StudioContext;
216
+ getSelection(): StudioSelection;
217
+ getHistoryState(): HistoryState;
218
+ getEditorialState(nodeId: string): StudioEditorialState;
219
+ getEffectiveNodeState(nodeId: string): StudioEffectiveNodeState | null;
220
+ getSceneTreeSnapshot(): StudioSceneTreeSnapshot;
221
+ getNodeFrame(nodeId: string): ReturnType<typeof getStudioNodeFrame>;
222
+ getSelectionFrame(): ReturnType<typeof getStudioSelectionFrame>;
223
+ getAssetDimensions(nodeId: string): ReturnType<typeof getStudioAssetDimensions>;
224
+ getPhysicsFacts(nodeId: string): ReturnType<typeof getStudioPhysicsFacts>;
225
+ getEnvironment(): SceneDocument['environment'];
226
+ listAssets(): readonly AssetRevision[];
227
+ getAsset(id: string): AssetRevision | null;
228
+ listVisualAssets(): readonly VisualAssetRevision[];
229
+ getVisualAsset(id: string): VisualAssetRevision | null;
230
+ resolveAssetSource(revisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioAssetSource | null>;
231
+ resolveVisualAssetSource(visualRevisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioAssetSource | null>;
232
+ resolveAssetBundle(revisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioSourceBundle | null>;
233
+ resolveVisualAssetBundle(visualRevisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioSourceBundle | null>;
234
+ serializeScene(): string;
235
+ createStateSnapshot(): StudioStateSnapshot;
236
+ buildUsdDeliveryPlan(input: Omit<BuildUsdDeliveryPlanInputV4, 'document'>): UsdDeliveryPlanV4;
237
+ validateDocumentDomains(purpose?: StudioDocumentDomainPurpose): readonly Diagnostic[];
238
+ }
239
+ type StudioListener = (event: StudioHostEvent) => void;
240
+ export declare class StudioHost {
241
+ readonly plugins: StudioPluginHost;
242
+ private readonly options;
243
+ private readonly contributions;
244
+ private readonly persistence;
245
+ private readonly assetIngestor;
246
+ private readonly assetSourceProvider;
247
+ private readonly domainExtensions;
248
+ private readonly createId;
249
+ private readonly listeners;
250
+ private readonly editorialStates;
251
+ private readonlyHost;
252
+ private readonly persistenceController;
253
+ private readonly assetTasks;
254
+ private readonly assetTaskInputs;
255
+ private readonly assetTaskPlacements;
256
+ private readonly assetTaskControllers;
257
+ private readonly assetTaskProgress;
258
+ private readonly assetCommitReceipts;
259
+ private readonly assetTaskRuns;
260
+ private readonly assetTaskClosing;
261
+ private readonly assetTaskDisposals;
262
+ private readonly assetMutationTails;
263
+ private readonly activeActionControllers;
264
+ private history;
265
+ private selection;
266
+ private editorialVersion;
267
+ private documentVersion;
268
+ private sceneEpoch;
269
+ private selectionVersion;
270
+ private persistenceState;
271
+ private starting;
272
+ private disposing;
273
+ private disposal;
274
+ private disposed;
275
+ constructor(options?: StudioHostOptions);
276
+ get document(): SceneDocument;
277
+ get canPersist(): boolean;
278
+ ready(): Promise<void>;
279
+ getSnapshot(): StudioHostSnapshot;
280
+ getContext(extraFacts?: StudioContextFacts): StudioContext;
281
+ getActions(extraFacts?: StudioContextFacts): readonly StudioActionContribution[];
282
+ activatePlugin(id: string, extraFacts?: StudioContextFacts): Promise<void>;
283
+ getSelection(): StudioSelection;
284
+ getPhysicsFacts(nodeId: string): import("..").StudioPhysicsFacts | null;
285
+ getEnvironment(): import("..").SceneEnvironment;
286
+ getNodeFrame(nodeId: string): import("..").StudioNodeFrame | null;
287
+ getSelectionFrame(): import("..").StudioSelectionFrame;
288
+ getAssetDimensions(nodeId: string): import("..").StudioAssetDimensions | null;
289
+ getHistoryState(): HistoryState;
290
+ getEditorialState(nodeId: string): StudioEditorialState;
291
+ /** Returns an immutable tree projection suitable for external scene-tree UIs. */
292
+ getSceneTreeSnapshot(): StudioSceneTreeSnapshot;
293
+ getEffectiveNodeState(nodeId: string): StudioEffectiveNodeState | null;
294
+ setEditorialState(nodeId: string, patch: Partial<StudioEditorialState>): StudioEditorialState;
295
+ updateEditorialState(nodeIds: readonly string[], patch: Partial<StudioEditorialState>): void;
296
+ replaceEditorialState(editorial: Readonly<Record<string, StudioEditorialState>>, selection: StudioSelection): void;
297
+ listAssets(): readonly AssetRevision[];
298
+ getAsset(id: string): AssetRevision | null;
299
+ listVisualAssets(): readonly VisualAssetRevision[];
300
+ getVisualAsset(id: string): VisualAssetRevision | null;
301
+ resolveAssetSource(revisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioAssetSource | null>;
302
+ resolveVisualAssetSource(visualRevisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioAssetSource | null>;
303
+ resolveAssetBundle(revisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioSourceBundle | null>;
304
+ resolveVisualAssetBundle(visualRevisionId: string, options?: StudioAssetSourceResolveOptions): Promise<StudioSourceBundle | null>;
305
+ releaseAssetSource(revisionId: string): Promise<void>;
306
+ subscribe(listener: StudioListener): () => void;
307
+ runAction(id: string, input?: unknown, options?: StudioActionRunOptions): Promise<unknown>;
308
+ runCheckers(): Promise<readonly {
309
+ readonly id: string;
310
+ readonly title: string;
311
+ readonly diagnostics: readonly Diagnostic[];
312
+ }[]>;
313
+ runExporters(): Promise<readonly {
314
+ readonly id: string;
315
+ readonly title: string;
316
+ readonly output: unknown;
317
+ }[]>;
318
+ resolveInspectors(invocation?: {
319
+ readonly instanceId?: string;
320
+ readonly assetId?: string;
321
+ }): Promise<readonly {
322
+ readonly id: string;
323
+ readonly title: string;
324
+ readonly value: unknown;
325
+ }[]>;
326
+ registerAsset(revision: AssetRevision, source: StudioAssetSource, options?: {
327
+ readonly expectedSceneEpoch?: number;
328
+ readonly expectedDocumentVersion?: number;
329
+ readonly operationId?: string;
330
+ readonly signal?: AbortSignal;
331
+ }): Promise<void>;
332
+ registerVisualAsset(revision: VisualAssetRevision, source: StudioAssetSource, options?: {
333
+ readonly expectedSceneEpoch?: number;
334
+ readonly expectedDocumentVersion?: number;
335
+ readonly operationId?: string;
336
+ readonly signal?: AbortSignal;
337
+ }): Promise<void>;
338
+ prepareAsset(input: StudioAssetInput, options?: StudioAssetPrepareOptions): Promise<StudioPreparedAssetBatch>;
339
+ private prepareAssetRun;
340
+ commitPreparedAsset(prepared: StudioPreparedAssetBatch, options?: StudioAssetCommitOptions): Promise<StudioAssetCommitResult>;
341
+ private commitPreparedAssetRun;
342
+ prepareVisualAssetRegistration(revision: VisualAssetRevision, source: StudioAssetSource, options?: StudioAssetPrepareOptions): StudioPreparedAssetBatch;
343
+ loadAsset(input: StudioAssetInput, options?: StudioAssetPrepareOptions): Promise<StudioAssetLoadResult>;
344
+ listAssetTasks(): readonly StudioAssetTaskSnapshot[];
345
+ cancelAssetTask(taskId: string): void;
346
+ retryAssetTask(taskId: string): Promise<StudioAssetCommitResult | null>;
347
+ disposeAssetTask(taskId: string): Promise<void>;
348
+ addBoundingBoxPlaceholder(input: StudioBoundingBoxInput): StudioCommandResult;
349
+ replaceModel(input: StudioReplaceModelInput): Promise<StudioCommandResult>;
350
+ dispatch(records: CommandRecord | readonly CommandRecord[]): StudioCommandResult;
351
+ inspect(records: CommandRecord | readonly CommandRecord[]): StudioTransactionPreview;
352
+ commit(request: StudioTransactionRequest): StudioCommandResult;
353
+ private planModelReplacement;
354
+ private applyPlannedReplacementCommand;
355
+ private revisionForModelReplacement;
356
+ private buildAssetReplacementNode;
357
+ private buildPlaceholderReplacementNode;
358
+ private assertPlaceholderExternalCompatibility;
359
+ private commonNodeExternalRef;
360
+ private nodeExternalRef;
361
+ private assertModelReplacementContext;
362
+ private modelReplacementNode;
363
+ private enqueueAssetMutation;
364
+ undo(): StudioCommandResult;
365
+ redo(): StudioCommandResult;
366
+ selectFromTree(nodeIds: readonly string[], primaryId?: string | null): StudioSelection;
367
+ /** Explicit viewport-origin selection. Direct picking normally calls this through SceneSession. */
368
+ selectFromViewport(nodeIds: readonly string[], primaryId?: string | null): StudioSelection;
369
+ select(instanceIds: readonly string[], primaryId?: string | null): StudioSelection;
370
+ private selectNodes;
371
+ openSceneText(documentText: string, sources?: readonly StudioAssetSource[], options?: {
372
+ readonly signal?: AbortSignal;
373
+ }): Promise<StudioOpenResult>;
374
+ replaceDocument(document: SceneDocument): void;
375
+ newScene(document?: SceneDocument): SceneDocument;
376
+ serializeScene(): string;
377
+ createStateSnapshot(): StudioStateSnapshot;
378
+ save(): Promise<boolean>;
379
+ cancelPendingSave(): void;
380
+ buildUsdDeliveryPlan(input: Omit<BuildUsdDeliveryPlanInputV4, 'document'>): UsdDeliveryPlanV4;
381
+ validateDocumentDomains(purpose?: StudioDocumentDomainPurpose): readonly Diagnostic[];
382
+ dispose(): Promise<void>;
383
+ private start;
384
+ private snapshot;
385
+ private publishDocument;
386
+ private markPersistenceDirty;
387
+ private publishAssetProgress;
388
+ private publishAssetBatch;
389
+ private assetTaskSnapshot;
390
+ getReadOnlyHostFacade(): StudioReadOnlyHost;
391
+ private createActionHost;
392
+ private assertExpectedActionContext;
393
+ private cancelActiveActions;
394
+ private assertTaskStartable;
395
+ private trackAssetTask;
396
+ private waitForTaskRuns;
397
+ private waitForAllTaskRuns;
398
+ private cancelRemainingItems;
399
+ private assetStaleDiagnostic;
400
+ private bindPlacementIntents;
401
+ private placementIntentForItem;
402
+ private preparePlacementNode;
403
+ private commitPreparedAssetPlacement;
404
+ private assetReceiptKey;
405
+ private itemCommitReceipt;
406
+ private assetItemDigest;
407
+ private assetBaseItemDigest;
408
+ private placementDigestPayload;
409
+ private placementNodeId;
410
+ private revisionIdOfPreparedItem;
411
+ private releaseRegisteredSource;
412
+ private deleteTaskReceipts;
413
+ private requireAssetSourceProvider;
414
+ private registerRevisionSource;
415
+ private assertRegistrationRevision;
416
+ private assertOpenContext;
417
+ private releaseCreatedSources;
418
+ private assertAssetCommitContext;
419
+ private getReadOnlyHost;
420
+ private selectionSource;
421
+ private pruneSelection;
422
+ private selectableNodes;
423
+ private isSelectable;
424
+ private uniqueIdentity;
425
+ private normalizeSource;
426
+ private verifySourceBundleFacts;
427
+ private emit;
428
+ private assertActive;
429
+ private assertExpectedVersions;
430
+ private assertExpectedTargets;
431
+ private assertWriteAllowed;
432
+ }
@@ -0,0 +1,58 @@
1
+ import type { StudioPersistenceAdapter, StudioPersistenceReceipt, StudioPersistenceState } from '../ports/persistence';
2
+ import type { StudioStateSnapshot } from '../persist/snapshot';
3
+ export interface StudioPersistenceCapture<TMetadata = unknown> {
4
+ readonly snapshot: StudioStateSnapshot;
5
+ readonly documentVersion: number;
6
+ readonly sceneEpoch: number;
7
+ readonly metadata: TMetadata;
8
+ }
9
+ export interface StudioPersistenceSaveResult<TMetadata = unknown> {
10
+ readonly receipt: StudioPersistenceReceipt;
11
+ readonly captured: StudioPersistenceCapture<TMetadata>;
12
+ readonly state: StudioPersistenceState;
13
+ }
14
+ export interface StudioPersistenceControllerOptions<TMetadata = unknown> {
15
+ readonly adapter: StudioPersistenceAdapter;
16
+ readonly capture: () => StudioPersistenceCapture<TMetadata>;
17
+ readonly currentVersion: () => {
18
+ readonly documentVersion: number;
19
+ readonly sceneEpoch: number;
20
+ };
21
+ readonly flushResources?: () => Promise<void>;
22
+ readonly now?: () => string;
23
+ readonly onState?: (state: StudioPersistenceState) => void;
24
+ }
25
+ /**
26
+ * Serializes saves and coalesces unstarted requests. A save always binds its
27
+ * receipt to the capture taken when that save actually starts; edits arriving
28
+ * during the adapter write remain dirty for the next flush.
29
+ */
30
+ export declare class StudioPersistenceController<TMetadata = unknown> {
31
+ private readonly options;
32
+ private state;
33
+ private running;
34
+ private requested;
35
+ private lastResult;
36
+ private disposed;
37
+ private activeSaveController;
38
+ constructor(options: StudioPersistenceControllerOptions<TMetadata>);
39
+ getState(): StudioPersistenceState;
40
+ markDirty(): void;
41
+ /**
42
+ * Binds a loaded snapshot to its on-disk baseline. A migrated or otherwise
43
+ * non-canonical on-disk hash stays dirty until a current-schema save succeeds.
44
+ */
45
+ restoreBaseline(documentHash: string, options?: {
46
+ readonly canonicalHash?: string;
47
+ readonly migrationPending?: boolean;
48
+ }): void;
49
+ scheduleSave(): Promise<StudioPersistenceSaveResult<TMetadata>>;
50
+ flush(): Promise<StudioPersistenceSaveResult<TMetadata>>;
51
+ retry(): Promise<StudioPersistenceSaveResult<TMetadata>>;
52
+ save(): Promise<StudioPersistenceSaveResult<TMetadata>>;
53
+ cancel(): void;
54
+ dispose(closeAdapter?: boolean): Promise<void>;
55
+ private drain;
56
+ private performSave;
57
+ private setState;
58
+ }