@nebula-spatial/studio 0.0.0-stage → 0.1.1

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 (262) 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/openusd_three_loader-DLiqJWUM.js +13769 -0
  23. package/dist/assets/usd-export-worker-BRxTLqer.js +182 -0
  24. package/dist/assets/usd-worker-DekqMsQv.js +1392 -0
  25. package/dist/builders-BAXRR5o5.js +1854 -0
  26. package/dist/core/asset-task.d.ts +105 -0
  27. package/dist/core/context.d.ts +23 -0
  28. package/dist/core/host.d.ts +432 -0
  29. package/dist/core/persistence-controller.d.ts +58 -0
  30. package/dist/core/plugins.d.ts +139 -0
  31. package/dist/core/scene-tree.d.ts +62 -0
  32. package/dist/core/versions.d.ts +2 -0
  33. package/dist/core/when.d.ts +13 -0
  34. package/dist/core/write-policy.d.ts +29 -0
  35. package/dist/delivery/build-plan.d.ts +2 -0
  36. package/dist/delivery/contracts.d.ts +362 -0
  37. package/dist/delivery/digest.d.ts +3 -0
  38. package/dist/delivery/evidence.d.ts +10 -0
  39. package/dist/delivery/export-evidence.d.ts +3 -0
  40. package/dist/delivery/index.d.ts +9 -0
  41. package/dist/delivery/prim-name.d.ts +17 -0
  42. package/dist/delivery/profile.d.ts +4 -0
  43. package/dist/doc/builders.d.ts +99 -0
  44. package/dist/doc/command.d.ts +195 -0
  45. package/dist/doc/domain-extensions.d.ts +34 -0
  46. package/dist/doc/node-facts.d.ts +87 -0
  47. package/dist/doc/physics-facts.d.ts +74 -0
  48. package/dist/doc/placement-policy.d.ts +71 -0
  49. package/dist/doc/random-placement.d.ts +30 -0
  50. package/dist/doc/scene-graph.d.ts +80 -0
  51. package/dist/doc/scene-regions.d.ts +29 -0
  52. package/dist/doc/schema.d.ts +452 -0
  53. package/dist/doc/task.d.ts +71 -0
  54. package/dist/doc/validate.d.ts +68 -0
  55. package/dist/editor/asset-source.d.ts +15 -0
  56. package/dist/editor/editor.d.ts +246 -0
  57. package/dist/editor/index.d.ts +22 -0
  58. package/dist/editor/shortcuts.d.ts +2 -0
  59. package/dist/editor/types.d.ts +143 -0
  60. package/dist/editor/ui-plugins.d.ts +64 -0
  61. package/dist/editor.js +1755 -0
  62. package/dist/editorial-BkAFWfbg.js +83 -0
  63. package/dist/export-evidence-DMNRhgL9.js +2705 -0
  64. package/dist/generalization/domain.d.ts +10 -0
  65. package/dist/generalization/generalization.d.ts +371 -0
  66. package/dist/generalization/index.d.ts +11 -0
  67. package/dist/generalization.js +1659 -0
  68. package/dist/history/undo-stack.d.ts +74 -0
  69. package/dist/index.d.ts +91 -0
  70. package/dist/index.js +2840 -0
  71. package/dist/mjcf-visual-Bt4bUxd1.js +72 -0
  72. package/dist/mujoco-runtime-BYZnrvbR.js +467 -0
  73. package/dist/persist/content-addressed.d.ts +11 -0
  74. package/dist/persist/create-scene-package-from-host.d.ts +7 -0
  75. package/dist/persist/indexeddb-store.d.ts +69 -0
  76. package/dist/persist/scene-file.d.ts +52 -0
  77. package/dist/persist/scene-package.d.ts +8 -0
  78. package/dist/persist/snapshot.d.ts +5 -0
  79. package/dist/physics-facts-tfQYyNTD.js +337 -0
  80. package/dist/placement-policy-DY_FNRDu.js +405 -0
  81. package/dist/ports/asset-ingestor.d.ts +41 -0
  82. package/dist/ports/asset-source.d.ts +57 -0
  83. package/dist/ports/delivery.d.ts +13 -0
  84. package/dist/ports/persistence.d.ts +29 -0
  85. package/dist/project/asset-catalog.d.ts +21 -0
  86. package/dist/project/contracts.d.ts +272 -0
  87. package/dist/project/editorial.d.ts +16 -0
  88. package/dist/project/identity.d.ts +20 -0
  89. package/dist/project/index.d.ts +9 -0
  90. package/dist/project/scene-document.d.ts +5 -0
  91. package/dist/project/source-dependencies.d.ts +7 -0
  92. package/dist/remote-asset-resolver-Cb8cfNmw.js +136 -0
  93. package/dist/scene/index.d.ts +12 -0
  94. package/dist/scene-graph-DBLKAhxa.js +681 -0
  95. package/dist/scene-session-Cy6vDJ1l.js +21981 -0
  96. package/dist/scene.js +244 -0
  97. package/dist/session-BRBrCLdd.js +963 -0
  98. package/dist/session-DI5tPJxn.js +825 -0
  99. package/dist/session-q3uuG7OP.js +296 -0
  100. package/dist/studio/delivery-catalog.d.ts +28 -0
  101. package/dist/studio/in-memory-asset-source.d.ts +15 -0
  102. package/dist/studio/index.d.ts +31 -0
  103. package/dist/studio/indexeddb-asset-source.d.ts +32 -0
  104. package/dist/studio/indexeddb-persistence.d.ts +13 -0
  105. package/dist/studio/remote-asset-importer.d.ts +56 -0
  106. package/dist/studio/source-package.d.ts +9 -0
  107. package/dist/studio/usd-export-client.d.ts +13 -0
  108. package/dist/studio/usd-export-protocol.d.ts +98 -0
  109. package/dist/studio/usd-export-worker.d.ts +1 -0
  110. package/dist/studio/usd-zip-reader.d.ts +14 -0
  111. package/dist/studio/web-asset-ingestor.d.ts +10 -0
  112. package/dist/studio/web-host.d.ts +8 -0
  113. package/dist/studio.js +5545 -0
  114. package/dist/urdf-session-CQir2nb2.js +1230 -0
  115. package/dist/usd-session-DZJnEEOs.js +7385 -0
  116. package/dist/util/asset-facts.d.ts +3 -0
  117. package/dist/util/data.d.ts +17 -0
  118. package/dist/util/diagnostics.d.ts +38 -0
  119. package/dist/util/geometry.d.ts +11 -0
  120. package/dist/util/hash.d.ts +9 -0
  121. package/dist/util/ids.d.ts +20 -0
  122. package/dist/util/math.d.ts +47 -0
  123. package/dist/util/ply-metadata.d.ts +19 -0
  124. package/dist/util/studio-source.d.ts +23 -0
  125. package/dist/version.d.ts +5 -0
  126. package/dist/view/appearance.d.ts +13 -0
  127. package/dist/view/authoring-appearance.d.ts +25 -0
  128. package/dist/view/bounds-preview.d.ts +34 -0
  129. package/dist/view/bounds.d.ts +11 -0
  130. package/dist/view/camera-zoom.d.ts +3 -0
  131. package/dist/view/geometry-anchors.d.ts +20 -0
  132. package/dist/view/gizmo-appearance.d.ts +5 -0
  133. package/dist/view/gizmo.d.ts +81 -0
  134. package/dist/view/group-selection.d.ts +13 -0
  135. package/dist/view/node-features.d.ts +39 -0
  136. package/dist/view/picking.d.ts +49 -0
  137. package/dist/view/placement.d.ts +48 -0
  138. package/dist/view/region-editing.d.ts +25 -0
  139. package/dist/view/rotation-guide.d.ts +36 -0
  140. package/dist/view/runtime-capabilities.d.ts +22 -0
  141. package/dist/view/scene-session.d.ts +258 -0
  142. package/dist/view/screen-bounds.d.ts +17 -0
  143. package/dist/view/selection-transform.d.ts +20 -0
  144. package/dist/wasm-module-DZn2AM1W.js +13 -0
  145. package/dist/xacro-DLRXyk60.js +76 -0
  146. package/node_modules/@nebula-spatial/cad-loader/CHANGELOG.md +48 -0
  147. package/node_modules/@nebula-spatial/cad-loader/README.md +108 -0
  148. package/node_modules/@nebula-spatial/cad-loader/dist/core/cad-types.d.ts +26 -0
  149. package/node_modules/@nebula-spatial/cad-loader/dist/core/errors.d.ts +5 -0
  150. package/node_modules/@nebula-spatial/cad-loader/dist/core/index.d.ts +24 -0
  151. package/node_modules/@nebula-spatial/cad-loader/dist/core/index.js +2354 -0
  152. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/bin-group-reader.d.ts +9 -0
  153. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/bin-parser.d.ts +78 -0
  154. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/dxbs-sidecar.d.ts +24 -0
  155. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/geometry-segments.d.ts +20 -0
  156. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/text-roundtrip.d.ts +4 -0
  157. package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/types.d.ts +81 -0
  158. package/node_modules/@nebula-spatial/cad-loader/dist/core/runtime-text-decoder.d.ts +8 -0
  159. package/node_modules/@nebula-spatial/cad-loader/dist/core/types.d.ts +153 -0
  160. package/node_modules/@nebula-spatial/cad-loader/dist/core/utils/insert-bbox.d.ts +10 -0
  161. package/node_modules/@nebula-spatial/cad-loader/dist/core/utils/viewport-rect.d.ts +21 -0
  162. package/node_modules/@nebula-spatial/cad-loader/dist/index.d.ts +36 -0
  163. package/node_modules/@nebula-spatial/cad-loader/dist/index.js +5829 -0
  164. package/node_modules/@nebula-spatial/cad-loader/dist/loader/geo-loader.d.ts +59 -0
  165. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/automatic-external-resources.d.ts +26 -0
  166. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/external-variant-sidecar-fetch.d.ts +13 -0
  167. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/flow-control.d.ts +29 -0
  168. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/frame-budget-scheduler.d.ts +21 -0
  169. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-compact-executor.d.ts +19 -0
  170. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-local-adapter.d.ts +2 -0
  171. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-pipeline.d.ts +92 -0
  172. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-worker-adapter.d.ts +13 -0
  173. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node-builder.d.ts +34 -0
  174. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node-load-sink.d.ts +28 -0
  175. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node.d.ts +304 -0
  176. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare-worker-types.d.ts +94 -0
  177. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare.d.ts +38 -0
  178. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare.worker.d.ts +1 -0
  179. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/insert-model-builder.d.ts +10 -0
  180. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/insert-runtime-geometry.d.ts +15 -0
  181. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/line-canonical.d.ts +37 -0
  182. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/line-quality.d.ts +9 -0
  183. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/prepare-credit-gate.d.ts +20 -0
  184. package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/transport.d.ts +2 -0
  185. package/node_modules/@nebula-spatial/cad-loader/dist/render-resource/cad-render-node.d.ts +80 -0
  186. package/node_modules/@nebula-spatial/cad-loader/dist/render-resource/geo-node-cad-render-node.d.ts +12 -0
  187. package/node_modules/@nebula-spatial/cad-loader/dist/scene/geo-cad-line-geometry.d.ts +28 -0
  188. package/node_modules/@nebula-spatial/cad-loader/dist/scene/geo-cad-line-material.d.ts +18 -0
  189. package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/block-geometry-registry.d.ts +35 -0
  190. package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/insert-instance-table.d.ts +23 -0
  191. package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/viewport-instance-presenter.d.ts +66 -0
  192. package/node_modules/@nebula-spatial/cad-loader/dist/selection/cad-insert-selection.d.ts +35 -0
  193. package/node_modules/@nebula-spatial/cad-loader/dist/selection/cad-text-selection.d.ts +31 -0
  194. package/node_modules/@nebula-spatial/cad-loader/dist/session/annotation-idle-gate.d.ts +14 -0
  195. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-document-session.d.ts +187 -0
  196. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-font-runtime.d.ts +11 -0
  197. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-insert-id.d.ts +6 -0
  198. package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-text-warmup.d.ts +38 -0
  199. package/node_modules/@nebula-spatial/cad-loader/dist/session/create-cad-document-session.d.ts +5 -0
  200. package/node_modules/@nebula-spatial/cad-loader/dist/session/load-session.d.ts +90 -0
  201. package/node_modules/@nebula-spatial/cad-loader/dist/session/viewport-coverage.d.ts +32 -0
  202. package/node_modules/@nebula-spatial/cad-loader/dist/shared/abort.d.ts +3 -0
  203. package/node_modules/@nebula-spatial/cad-loader/dist/shared/cad-display-color.d.ts +55 -0
  204. package/node_modules/@nebula-spatial/cad-loader/dist/shared/cad-load-source.d.ts +8 -0
  205. package/node_modules/@nebula-spatial/cad-loader/dist/shared/color-buffer.d.ts +6 -0
  206. package/node_modules/@nebula-spatial/cad-loader/dist/shared/constants.d.ts +11 -0
  207. package/node_modules/@nebula-spatial/cad-loader/dist/shared/display-color-buffer.d.ts +27 -0
  208. package/node_modules/@nebula-spatial/cad-loader/dist/shared/errors.d.ts +2 -0
  209. package/node_modules/@nebula-spatial/cad-loader/dist/shared/text-builder.d.ts +25 -0
  210. package/node_modules/@nebula-spatial/cad-loader/dist/shared/text-font.d.ts +12 -0
  211. package/node_modules/@nebula-spatial/cad-loader/dist/shared/types.d.ts +57 -0
  212. package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/insert-bbox.d.ts +1 -0
  213. package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/timing.d.ts +2 -0
  214. package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/viewport-rect.d.ts +1 -0
  215. package/node_modules/@nebula-spatial/cad-loader/dist/shared/viewer-theme.d.ts +2 -0
  216. package/node_modules/@nebula-spatial/cad-loader/dist/workers/geo-prepare.worker.js +2264 -0
  217. package/node_modules/@nebula-spatial/cad-loader/package.json +62 -0
  218. package/node_modules/@nebula-spatial/viewer/CHANGELOG.md +426 -0
  219. package/node_modules/@nebula-spatial/viewer/FBX-MATERIAL-CONVERSION.md +97 -0
  220. package/node_modules/@nebula-spatial/viewer/README.md +1056 -0
  221. package/node_modules/@nebula-spatial/viewer/USD-VISUAL-MATERIAL-SUPPORT.md +89 -0
  222. package/node_modules/@nebula-spatial/viewer/basis/basis_transcoder.js +19 -0
  223. package/node_modules/@nebula-spatial/viewer/basis/basis_transcoder.wasm +0 -0
  224. package/node_modules/@nebula-spatial/viewer/dist/asset-ir-DEOK9SqE.js +382 -0
  225. package/node_modules/@nebula-spatial/viewer/dist/assets/ground-grid.d.ts +6 -0
  226. package/node_modules/@nebula-spatial/viewer/dist/assets/source-types.d.ts +19 -0
  227. package/node_modules/@nebula-spatial/viewer/dist/assets/types.d.ts +393 -0
  228. package/node_modules/@nebula-spatial/viewer/dist/assets/usd-worker-Bom5cjz3.js +1392 -0
  229. package/node_modules/@nebula-spatial/viewer/dist/cad/text.d.ts +2 -0
  230. package/node_modules/@nebula-spatial/viewer/dist/cad/types.d.ts +368 -0
  231. package/node_modules/@nebula-spatial/viewer/dist/index-ByBlfVc0.js +12132 -0
  232. package/node_modules/@nebula-spatial/viewer/dist/index.d.ts +32 -0
  233. package/node_modules/@nebula-spatial/viewer/dist/index.js +26 -0
  234. package/node_modules/@nebula-spatial/viewer/dist/inspection/types.d.ts +112 -0
  235. package/node_modules/@nebula-spatial/viewer/dist/mjcf-visual-DVRa0w90.js +72 -0
  236. package/node_modules/@nebula-spatial/viewer/dist/mujoco-runtime-Dhx6Ua2u.js +463 -0
  237. package/node_modules/@nebula-spatial/viewer/dist/plugins.d.ts +179 -0
  238. package/node_modules/@nebula-spatial/viewer/dist/scene/instances.d.ts +36 -0
  239. package/node_modules/@nebula-spatial/viewer/dist/scene/types.d.ts +258 -0
  240. package/node_modules/@nebula-spatial/viewer/dist/session-B-j6KdA-.js +389 -0
  241. package/node_modules/@nebula-spatial/viewer/dist/session-B4AICTeJ.js +963 -0
  242. package/node_modules/@nebula-spatial/viewer/dist/session-BAG5cDYe.js +9153 -0
  243. package/node_modules/@nebula-spatial/viewer/dist/simulation/mujoco-runtime.d.ts +118 -0
  244. package/node_modules/@nebula-spatial/viewer/dist/simulation/mujoco-wasm-module.d.ts +11 -0
  245. package/node_modules/@nebula-spatial/viewer/dist/simulation/openusd-wasm-module.d.ts +10 -0
  246. package/node_modules/@nebula-spatial/viewer/dist/simulation/physics-runtime-state.d.ts +75 -0
  247. package/node_modules/@nebula-spatial/viewer/dist/simulation/types.d.ts +129 -0
  248. package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-inspection.d.ts +66 -0
  249. package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-query.d.ts +50 -0
  250. package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-resource-policy.d.ts +28 -0
  251. package/node_modules/@nebula-spatial/viewer/dist/types.d.ts +278 -0
  252. package/node_modules/@nebula-spatial/viewer/dist/ui/types.d.ts +48 -0
  253. package/node_modules/@nebula-spatial/viewer/dist/urdf-session-kemAnBn8.js +3231 -0
  254. package/node_modules/@nebula-spatial/viewer/dist/usd-session-QtwGKI7v.js +6771 -0
  255. package/node_modules/@nebula-spatial/viewer/dist/version.d.ts +5 -0
  256. package/node_modules/@nebula-spatial/viewer/dist/viewer.d.ts +2 -0
  257. package/node_modules/@nebula-spatial/viewer/dist/xacro-CYTPS7mh.js +1537 -0
  258. package/node_modules/@nebula-spatial/viewer/openusd/openusd-runtime-manifest.json +15 -0
  259. package/node_modules/@nebula-spatial/viewer/openusd/openusd_probe.js +14 -0
  260. package/node_modules/@nebula-spatial/viewer/openusd/openusd_probe.wasm +0 -0
  261. package/node_modules/@nebula-spatial/viewer/package.json +66 -0
  262. package/package.json +87 -6
@@ -0,0 +1,139 @@
1
+ import type { Diagnostic } from '../util/diagnostics';
2
+ import type { StudioContext } from './context';
3
+ import type { StudioCommandResult, StudioHost, StudioHostSnapshot, StudioReadOnlyHost, StudioTransactionRequest } from './host';
4
+ import type { CommandRecord } from '../doc/command';
5
+ import type { StudioContextFacts, StudioWhen } from './when';
6
+ export declare const STUDIO_PLUGIN_API_VERSION = "1.0";
7
+ export type StudioDisposer = () => void | Promise<void>;
8
+ export type StudioActivationEvent = 'startup' | 'checker' | 'inspector' | 'exporter' | `action:${string}`;
9
+ export interface StudioPluginDependency {
10
+ readonly id: string;
11
+ readonly version?: string;
12
+ readonly optional?: boolean;
13
+ }
14
+ export interface StudioPluginManifest {
15
+ readonly id: string;
16
+ readonly name?: string;
17
+ readonly version: string;
18
+ readonly apiVersion: string;
19
+ readonly dependencies?: readonly StudioPluginDependency[];
20
+ readonly activationEvents?: readonly StudioActivationEvent[];
21
+ }
22
+ export interface StudioContributionContext {
23
+ readonly studio: StudioReadOnlyHost;
24
+ readonly snapshot: StudioHostSnapshot;
25
+ readonly context: StudioContext;
26
+ }
27
+ /** Runtime facade exposed to Core actions. It cannot access Host lifecycle or policy APIs. */
28
+ export interface StudioActionHost extends StudioReadOnlyHost {
29
+ commit(request: StudioTransactionRequest): StudioCommandResult;
30
+ dispatch(records: CommandRecord | readonly CommandRecord[]): StudioCommandResult;
31
+ }
32
+ export interface StudioActionContext extends Omit<StudioContributionContext, 'studio'> {
33
+ readonly studio: StudioActionHost;
34
+ readonly expectedDocumentVersion: number;
35
+ readonly expectedSceneEpoch: number;
36
+ readonly expectedSelectionVersion: number;
37
+ readonly targetIds: readonly string[];
38
+ readonly targetPolicy: 'selection' | 'scene';
39
+ /** Set by Editor action execution and aborted by cancelAction/unregister/dispose. */
40
+ readonly signal?: AbortSignal;
41
+ }
42
+ export interface StudioActionContribution {
43
+ readonly id: string;
44
+ readonly title: string;
45
+ readonly description?: string;
46
+ /** When present, the Editor may project this action into that toolbar. */
47
+ readonly scope?: 'scene' | 'selection';
48
+ readonly when?: StudioWhen;
49
+ readonly run: (context: StudioActionContext, input?: unknown) => unknown | Promise<unknown>;
50
+ }
51
+ export interface StudioExporterContribution {
52
+ readonly id: string;
53
+ readonly title: string;
54
+ readonly extension?: string;
55
+ readonly when?: StudioWhen;
56
+ readonly export: (context: StudioContributionContext) => unknown | Promise<unknown>;
57
+ }
58
+ export interface StudioCheckerContribution {
59
+ readonly id: string;
60
+ readonly title: string;
61
+ readonly when?: StudioWhen;
62
+ readonly check: (context: StudioContributionContext) => readonly Diagnostic[] | Promise<readonly Diagnostic[]>;
63
+ }
64
+ export interface StudioInspectorInvocationContext extends StudioContributionContext {
65
+ readonly instanceId?: string;
66
+ readonly assetId?: string;
67
+ }
68
+ export interface StudioInspectorContribution {
69
+ readonly id: string;
70
+ readonly title: string;
71
+ readonly when?: StudioWhen;
72
+ readonly resolve: (context: StudioInspectorInvocationContext) => unknown | Promise<unknown>;
73
+ }
74
+ export interface StudioPluginContributions {
75
+ registerAction(contribution: StudioActionContribution, dispose?: StudioDisposer): StudioDisposer;
76
+ registerExporter(contribution: StudioExporterContribution, dispose?: StudioDisposer): StudioDisposer;
77
+ registerChecker(contribution: StudioCheckerContribution, dispose?: StudioDisposer): StudioDisposer;
78
+ registerInspector(contribution: StudioInspectorContribution, dispose?: StudioDisposer): StudioDisposer;
79
+ }
80
+ export interface StudioPluginContext {
81
+ readonly studio: StudioReadOnlyHost;
82
+ readonly contributions: StudioPluginContributions;
83
+ readonly context: StudioContext;
84
+ }
85
+ export interface StudioPlugin {
86
+ readonly manifest: StudioPluginManifest;
87
+ activate(context: StudioPluginContext): StudioDisposer | void | Promise<StudioDisposer | void>;
88
+ deactivate?(): void | Promise<void>;
89
+ }
90
+ /**
91
+ * Internal contribution registry. Plugins receive a plugin-scoped facade so
92
+ * ownership cannot be forged and the host can remove a plugin atomically.
93
+ */
94
+ export declare class StudioContributions {
95
+ private readonly onActionRemoved?;
96
+ private readonly actionEntries;
97
+ private readonly exporterEntries;
98
+ private readonly checkerEntries;
99
+ private readonly inspectorEntries;
100
+ constructor(onActionRemoved?: ((actionId: string) => void) | undefined);
101
+ forPlugin(pluginId: string): StudioPluginContributions;
102
+ getActions(facts: StudioContextFacts): readonly StudioActionContribution[];
103
+ getExporters(facts: StudioContextFacts): readonly StudioExporterContribution[];
104
+ getCheckers(facts: StudioContextFacts): readonly StudioCheckerContribution[];
105
+ getInspectors(facts: StudioContextFacts): readonly StudioInspectorContribution[];
106
+ getAction(id: string, facts: StudioContextFacts): StudioActionContribution | undefined;
107
+ hasAction(id: string): boolean;
108
+ removePlugin(pluginId: string): Promise<void>;
109
+ private register;
110
+ }
111
+ /**
112
+ * Owns manifest registration, dependency validation, lazy activation and
113
+ * deterministic deactivation.
114
+ */
115
+ export declare class StudioPluginHost {
116
+ private readonly studio;
117
+ private readonly contributions;
118
+ private readonly registry;
119
+ private readonly active;
120
+ private readonly activeOrder;
121
+ private readonly pending;
122
+ private graphValidated;
123
+ private disposal;
124
+ private disposing;
125
+ constructor(studio: StudioHost, contributions: StudioContributions);
126
+ get plugins(): readonly StudioPlugin[];
127
+ get manifests(): readonly StudioPluginManifest[];
128
+ isActive(id: string): boolean;
129
+ register(plugin: StudioPlugin): void;
130
+ validate(): void;
131
+ activate(id: string, extraFacts?: StudioContextFacts): Promise<void>;
132
+ activateFor(event: StudioActivationEvent, extraFacts?: StudioContextFacts): Promise<void>;
133
+ unuse(id: string): Promise<void>;
134
+ dispose(): Promise<void>;
135
+ private ensureActive;
136
+ private activateOne;
137
+ private deactivatePlugin;
138
+ private assertNotDisposing;
139
+ }
@@ -0,0 +1,62 @@
1
+ import type { SceneDocument, SceneNode, StudioEditorialState } from '../doc/schema';
2
+ /** Document/editorial eligibility; runtime loading and Editor write policy may further restrict it. */
3
+ export interface StudioNodeCapabilities {
4
+ readonly canSelectFromTree: boolean;
5
+ /** Eligibility for selectFromViewport; direct pointer hits depend on the runtime projection. */
6
+ readonly canSelectFromViewport: boolean;
7
+ readonly canTransform: boolean;
8
+ readonly canGroup: boolean;
9
+ readonly canUngroup: boolean;
10
+ }
11
+ export interface StudioEffectiveNodeState {
12
+ readonly nodeId: string;
13
+ readonly authoredVisible: boolean;
14
+ /** The node's own temporary state, excluding inherited state. */
15
+ readonly hidden: boolean;
16
+ readonly locked: boolean;
17
+ readonly inheritedHidden: boolean;
18
+ readonly inheritedLocked: boolean;
19
+ readonly effectivelyVisible: boolean;
20
+ readonly effectivelyLocked: boolean;
21
+ readonly capabilities: StudioNodeCapabilities;
22
+ }
23
+ export interface StudioSceneTreeNode extends StudioEffectiveNodeState {
24
+ readonly parentNodeId: string;
25
+ readonly nodeType: SceneNode['nodeType'];
26
+ readonly label: string;
27
+ readonly selected: boolean;
28
+ readonly assetRevisionId?: string;
29
+ readonly visualRevisionId?: string;
30
+ readonly domainId?: string;
31
+ readonly role?: string;
32
+ readonly category?: string;
33
+ readonly children: readonly StudioSceneTreeNode[];
34
+ }
35
+ export interface StudioSceneTreeSnapshot {
36
+ readonly documentVersion: number;
37
+ readonly sceneEpoch: number;
38
+ readonly selectionVersion: number;
39
+ /** Changes on temporary hidden/locked updates independently of document history. */
40
+ readonly editorialVersion: number;
41
+ readonly rootNodeId: string;
42
+ readonly nodes: readonly StudioSceneTreeNode[];
43
+ readonly counts: {
44
+ readonly total: number;
45
+ readonly assets: number;
46
+ readonly visuals: number;
47
+ readonly placeholders: number;
48
+ readonly domains: number;
49
+ readonly groups: number;
50
+ readonly selected: number;
51
+ };
52
+ }
53
+ /** A detached, immutable tree projection. It never exposes runtime objects. */
54
+ export declare function createSceneTreeSnapshot(input: {
55
+ readonly document: SceneDocument;
56
+ readonly documentVersion: number;
57
+ readonly sceneEpoch: number;
58
+ readonly selectionVersion: number;
59
+ readonly editorialVersion: number;
60
+ readonly selectedNodeIds: readonly string[];
61
+ readonly editorial: Readonly<Record<string, StudioEditorialState>>;
62
+ }): StudioSceneTreeSnapshot;
@@ -0,0 +1,2 @@
1
+ export declare function satisfiesVersion(version: string, requirement?: string): boolean;
2
+ export declare function isPluginApiVersionCompatible(version: string, current: string): boolean;
@@ -0,0 +1,13 @@
1
+ export type StudioWhen = {
2
+ readonly all: readonly StudioWhen[];
3
+ } | {
4
+ readonly any: readonly StudioWhen[];
5
+ } | {
6
+ readonly not: StudioWhen;
7
+ } | {
8
+ readonly path: string;
9
+ readonly op?: 'eq' | 'neq' | 'in' | 'notIn' | 'truthy' | 'falsy' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'exists';
10
+ readonly value?: unknown;
11
+ };
12
+ export type StudioContextFacts = Readonly<Record<string, unknown>>;
13
+ export declare function evaluateWhen(expression: StudioWhen | undefined, facts: StudioContextFacts): boolean;
@@ -0,0 +1,29 @@
1
+ import type { SceneDocument } from '../doc/schema';
2
+ import type { StudioSupportContact } from '../doc/placement-policy';
3
+ export type StudioTransactionKind = 'document' | 'editorial' | 'undo' | 'redo' | 'open' | 'replace' | 'asset';
4
+ export interface StudioWriteRequest {
5
+ readonly kind: StudioTransactionKind;
6
+ readonly targetNodeIds: readonly string[];
7
+ readonly gestureCommit?: boolean;
8
+ /** Node ids moved by one explicitly allowed-overlap operation. */
9
+ readonly allowOverlapNodeIds?: readonly string[];
10
+ /** Exact transaction-local contacts that are seated on a validated support plane. */
11
+ readonly supportContacts?: readonly StudioSupportContact[];
12
+ /** Candidate document at the final, validated commit boundary. */
13
+ readonly nextDocument?: SceneDocument;
14
+ }
15
+ export interface StudioWriteDecision {
16
+ readonly allowed: boolean;
17
+ readonly code?: string;
18
+ readonly message?: string;
19
+ }
20
+ export interface StudioWritePolicy {
21
+ check(request: StudioWriteRequest): StudioWriteDecision;
22
+ }
23
+ /**
24
+ * Editor-owned write policy capability. This function is intentionally not
25
+ * exported from public package entries: plugin code receives a restricted
26
+ * facade and never the owner object with this capability.
27
+ */
28
+ export declare function installStudioWritePolicy(owner: object, policy: StudioWritePolicy): () => void;
29
+ export declare function evaluateStudioWritePolicies(owner: object, request: StudioWriteRequest): StudioWriteDecision;
@@ -0,0 +1,2 @@
1
+ import type { BuildUsdDeliveryPlanInputV4, UsdDeliveryPlanV4 } from './contracts';
2
+ export declare function buildUsdDeliveryPlan(input: BuildUsdDeliveryPlanInputV4): UsdDeliveryPlanV4;
@@ -0,0 +1,362 @@
1
+ import type { StudioAssetResourceLocator } from '../doc/schema';
2
+ import type { DeliveryDiagnosticV1, DeliveryOutcomeV1, DeliveryArtifactV2, ResourceManifestEntryV2 } from '../project/contracts';
3
+ export declare const DELIVERY_PROFILE_FORMAT: "sim-studio.delivery-profile@1";
4
+ export declare const USD_DELIVERY_PLAN_FORMAT: "sim-studio.usd-delivery-plan@4";
5
+ export declare const DELIVERY_EVIDENCE_FORMAT: "sim-studio.delivery-evidence@1";
6
+ export declare const USD_EXPORT_EVIDENCE_FORMAT: "sim-studio.usd-export-evidence@3";
7
+ export interface DeliveryProfileV1 {
8
+ readonly format: typeof DELIVERY_PROFILE_FORMAT;
9
+ readonly schemaVersion: 1;
10
+ readonly profileId: string;
11
+ readonly profileVersion: string;
12
+ readonly target: 'isaac-sim';
13
+ readonly stage: {
14
+ readonly upAxis: 'Z';
15
+ readonly metersPerUnit: 1;
16
+ readonly kilogramsPerUnit: 1;
17
+ readonly defaultPrim: 'World';
18
+ };
19
+ readonly variants: {
20
+ /**
21
+ * Profile preferences are applied only when the source declares the variant
22
+ * set, the preferred branch exists, and its payload is fully resolved.
23
+ */
24
+ readonly preferred: Readonly<Record<string, string>>;
25
+ readonly conflictPolicy: 'block';
26
+ readonly fallbackPolicy: 'source-authored-default';
27
+ };
28
+ readonly visualArtifactPolicy: 'require-resolved-artifact';
29
+ }
30
+ export type UsdDeliveryAttributeValueV1 = string | number | boolean | Readonly<{
31
+ type: 'double3';
32
+ value: readonly [number, number, number];
33
+ }> | Readonly<{
34
+ type: 'float3';
35
+ value: readonly [number, number, number];
36
+ }> | Readonly<{
37
+ type: 'quatf';
38
+ value: readonly [number, number, number, number];
39
+ }> | Readonly<{
40
+ type: 'token[]';
41
+ value: readonly string[];
42
+ }> | Readonly<{
43
+ type: 'asset';
44
+ value: string;
45
+ }>;
46
+ export interface UsdDeliveryReferenceV1 {
47
+ readonly assetPath: string;
48
+ readonly targetPrim?: string;
49
+ readonly variantSelections?: Readonly<Record<string, string>>;
50
+ }
51
+ export interface UsdDeliveryPhysicsMaterialV1 {
52
+ readonly densityKgPerM3?: number;
53
+ readonly staticFriction?: number;
54
+ readonly dynamicFriction?: number;
55
+ readonly restitution?: number;
56
+ }
57
+ export interface UsdDeliveryJointOverrideV1 {
58
+ readonly jointPrimPath: string;
59
+ readonly driveType?: 'position' | 'velocity';
60
+ readonly target?: number;
61
+ readonly stiffness?: number;
62
+ readonly damping?: number;
63
+ readonly maxForce?: number;
64
+ }
65
+ interface UsdDeliveryPhysicsBaseV1 {
66
+ readonly colliderPrimPaths?: readonly string[];
67
+ readonly physicsMaterial?: UsdDeliveryPhysicsMaterialV1;
68
+ readonly jointOverrides?: readonly UsdDeliveryJointOverrideV1[];
69
+ }
70
+ export type UsdDeliveryPhysicsV1 = (UsdDeliveryPhysicsBaseV1 & {
71
+ readonly kind: 'none';
72
+ readonly policy: 'visual-only';
73
+ }) | (UsdDeliveryPhysicsBaseV1 & {
74
+ readonly kind: 'asset-authored';
75
+ readonly policy: 'preserve-source' | 'preserve-with-overrides';
76
+ }) | (UsdDeliveryPhysicsBaseV1 & {
77
+ readonly kind: 'static';
78
+ readonly policy: 'preserve-with-overrides';
79
+ }) | (UsdDeliveryPhysicsBaseV1 & {
80
+ readonly kind: 'kinematic';
81
+ readonly policy: 'preserve-with-overrides';
82
+ }) | (UsdDeliveryPhysicsBaseV1 & {
83
+ readonly kind: 'dynamic';
84
+ readonly policy: 'preserve-with-overrides';
85
+ readonly massKg?: number;
86
+ readonly centerOfMassM?: readonly [number, number, number];
87
+ });
88
+ interface UsdDeliveryNodeBaseV3 {
89
+ readonly nodeId: string;
90
+ readonly primPath: string;
91
+ readonly attributes: Readonly<Record<string, UsdDeliveryAttributeValueV1>>;
92
+ /** Content correction in source coordinates; absent when the pivot is zero. */
93
+ readonly contentAttributes?: Readonly<Record<string, UsdDeliveryAttributeValueV1>>;
94
+ readonly relationships?: Readonly<Record<string, string>>;
95
+ readonly visible: boolean;
96
+ }
97
+ export interface UsdDeliveryGroupNodeV3 extends UsdDeliveryNodeBaseV3 {
98
+ readonly nodeKind: 'group';
99
+ readonly typeName: 'Xform';
100
+ readonly children: readonly UsdDeliveryNodeV3[];
101
+ }
102
+ export interface UsdDeliveryReferenceNodeV3 extends UsdDeliveryNodeBaseV3 {
103
+ readonly nodeKind: 'reference';
104
+ readonly typeName: 'Xform';
105
+ readonly assetId: string;
106
+ readonly sourceRevisionId: string;
107
+ readonly artifactId?: string;
108
+ readonly reference: UsdDeliveryReferenceV1;
109
+ readonly classification: 'native-usd' | 'visual-only';
110
+ readonly materialBinding: 'source-authored' | 'visual-artifact' | 'none';
111
+ readonly physics: UsdDeliveryPhysicsV1;
112
+ }
113
+ export type UsdDeliveryNodeV3 = UsdDeliveryGroupNodeV3 | UsdDeliveryReferenceNodeV3;
114
+ export type UsdResourceOutputTransformV1 = Readonly<{
115
+ kind: 'identity';
116
+ }> | Readonly<{
117
+ kind: 'canonicalize-usdz';
118
+ }>;
119
+ export interface DeliveryResourceRefV2 {
120
+ readonly resourceId: string;
121
+ readonly sourceRevisionId: string;
122
+ readonly artifactId?: string;
123
+ readonly outputPath: string;
124
+ readonly sourceLocator: StudioAssetResourceLocator;
125
+ readonly sourceSha256: string;
126
+ readonly mediaType: string;
127
+ readonly sourceByteSize: number;
128
+ readonly outputTransform: UsdResourceOutputTransformV1;
129
+ }
130
+ export interface UsdDeliveryPlanV4 {
131
+ readonly format: typeof USD_DELIVERY_PLAN_FORMAT;
132
+ readonly schemaVersion: 4;
133
+ readonly sourcePackageDigest: string;
134
+ readonly profileDigest: string;
135
+ readonly profile: {
136
+ readonly profileId: string;
137
+ readonly profileVersion: string;
138
+ };
139
+ readonly stage: {
140
+ readonly defaultPrim: string;
141
+ readonly upAxis: 'Z';
142
+ readonly metersPerUnit: 1;
143
+ readonly kilogramsPerUnit: 1;
144
+ readonly physicsScene: {
145
+ readonly gravityDirection: readonly [number, number, number];
146
+ readonly gravityMagnitude: number;
147
+ };
148
+ };
149
+ readonly nodes: readonly UsdDeliveryNodeV3[];
150
+ readonly resources: readonly DeliveryResourceRefV2[];
151
+ readonly diagnostics: readonly DeliveryDiagnosticV1[];
152
+ readonly outcome: DeliveryOutcomeV1;
153
+ readonly planDigest: string;
154
+ }
155
+ export interface BuildUsdDeliveryPlanInputV4 {
156
+ readonly document: import('../doc/schema').SceneDocument;
157
+ readonly assetCatalog: import('../project/contracts').AssetCatalogV3;
158
+ readonly profile: DeliveryProfileV1;
159
+ readonly sourcePackageDigest: string;
160
+ }
161
+ export type UsdLayerEncoding = 'usda' | 'usdc';
162
+ export type UsdPackageKind = 'layer-bundle' | 'usdz';
163
+ export type UsdExportProgressPhase = 'resolve' | 'materialize' | 'validate-input' | 'worker-load' | 'stage-build' | 'encode' | 'package' | 'final-validate' | 'complete';
164
+ export interface UsdExportProgress {
165
+ readonly phase: UsdExportProgressPhase;
166
+ readonly completed: number;
167
+ readonly total: number | null;
168
+ readonly message?: string;
169
+ }
170
+ export interface UsdExportResourceReaderOptions {
171
+ readonly signal?: AbortSignal;
172
+ }
173
+ export interface UsdExportResourceReader {
174
+ read(resource: DeliveryResourceRefV2, options?: UsdExportResourceReaderOptions): Promise<ArrayBuffer | Uint8Array | Blob>;
175
+ }
176
+ export interface UsdExportLimits {
177
+ readonly maxResources?: number;
178
+ readonly maxResourceBytes?: number;
179
+ readonly maxTotalBytes?: number;
180
+ readonly maxNodes?: number;
181
+ readonly timeoutMs?: number;
182
+ }
183
+ export interface UsdExportRequest {
184
+ readonly plan: UsdDeliveryPlanV4;
185
+ readonly layerEncoding: UsdLayerEncoding;
186
+ readonly packageKind: UsdPackageKind;
187
+ readonly rootLayerPath: string;
188
+ readonly resourceReader: UsdExportResourceReader;
189
+ readonly signal?: AbortSignal;
190
+ readonly onProgress?: (event: UsdExportProgress) => void;
191
+ readonly limits?: UsdExportLimits;
192
+ }
193
+ export interface UsdExportFile {
194
+ readonly path: string;
195
+ readonly mediaType: string;
196
+ readonly bytes: ArrayBuffer;
197
+ readonly sha256: string;
198
+ }
199
+ export interface UsdExportResult {
200
+ readonly packageKind: UsdPackageKind;
201
+ readonly layerEncoding: UsdLayerEncoding;
202
+ readonly entryOutputPath: string;
203
+ readonly files: readonly UsdExportFile[];
204
+ readonly packageDigest: string;
205
+ readonly evidence: UsdExportEvidenceV3;
206
+ readonly diagnostics: readonly DeliveryDiagnosticV1[];
207
+ }
208
+ export interface UsdExportDiagnosticV1 {
209
+ readonly code: string;
210
+ readonly stage: 'resolve-source' | 'materialize' | 'artifact-validate' | 'build-plan' | 'worker-load' | 'stage-build' | 'encode' | 'package' | 'final-validate';
211
+ readonly severity: 'error' | 'warning' | 'info';
212
+ readonly message: string;
213
+ readonly detail?: Readonly<Record<string, string | number | boolean | null>>;
214
+ }
215
+ export interface UsdPhysicsFactsV1 {
216
+ readonly physicsScenes: readonly {
217
+ readonly path: string;
218
+ readonly gravityDirection: readonly [number, number, number] | null;
219
+ readonly gravityMagnitude: number | null;
220
+ }[];
221
+ readonly rigidBodies: readonly {
222
+ readonly path: string;
223
+ readonly typeName: string;
224
+ readonly enabled: boolean;
225
+ readonly kinematicEnabled: boolean;
226
+ readonly massKg: number | null;
227
+ readonly centerOfMassM: readonly [number, number, number] | null;
228
+ }[];
229
+ readonly colliders: readonly {
230
+ readonly path: string;
231
+ readonly typeName: string;
232
+ readonly enabled: boolean;
233
+ readonly approximation: string | null;
234
+ readonly materialPath: string | null;
235
+ }[];
236
+ readonly joints: readonly {
237
+ readonly path: string;
238
+ readonly typeName: string;
239
+ readonly enabled: boolean;
240
+ readonly body0: string | null;
241
+ readonly body1: string | null;
242
+ readonly axis: string | null;
243
+ readonly lowerLimit: number | null;
244
+ readonly upperLimit: number | null;
245
+ readonly coneAngle0Limit: number | null;
246
+ readonly coneAngle1Limit: number | null;
247
+ readonly driveTargetPosition: number | null;
248
+ readonly driveTargetVelocity: number | null;
249
+ readonly driveStiffness: number | null;
250
+ readonly driveDamping: number | null;
251
+ readonly driveMaxForce: number | null;
252
+ }[];
253
+ readonly materials: readonly {
254
+ readonly path: string;
255
+ readonly staticFriction: number | null;
256
+ readonly dynamicFriction: number | null;
257
+ readonly restitution: number | null;
258
+ readonly densityKgPerM3: number | null;
259
+ }[];
260
+ readonly articulationRoots: readonly string[];
261
+ }
262
+ export interface UsdPhysicsPreservationV1 {
263
+ readonly status: 'passed' | 'failed' | 'review_required' | 'not_run';
264
+ readonly before: UsdPhysicsFactsV1;
265
+ readonly after: UsdPhysicsFactsV1;
266
+ readonly missingSourceFacts: readonly string[];
267
+ readonly unexpectedFactChanges: readonly string[];
268
+ }
269
+ export interface UsdExportResourceFactV1 {
270
+ readonly path: string;
271
+ readonly mediaType: string;
272
+ readonly sourceSha256: string;
273
+ readonly sourceByteSize: number;
274
+ readonly outputSha256: string;
275
+ readonly outputByteSize: number;
276
+ readonly outputTransform: UsdResourceOutputTransformV1;
277
+ readonly changed: boolean;
278
+ }
279
+ export interface UsdNestedUsdzFactV1 {
280
+ readonly path: string;
281
+ readonly defaultLayerPath: string;
282
+ readonly packageManifest: readonly {
283
+ readonly path: string;
284
+ readonly byteSize: number;
285
+ readonly dataOffset: number;
286
+ }[];
287
+ }
288
+ export interface UsdExportEvidenceV3 {
289
+ readonly format: typeof USD_EXPORT_EVIDENCE_FORMAT;
290
+ readonly schemaVersion: 3;
291
+ readonly planDigest: string;
292
+ readonly packageDigest: string;
293
+ readonly entryOutputPath: string;
294
+ readonly profileDigest: string;
295
+ readonly validator: {
296
+ readonly id: string;
297
+ readonly version: string;
298
+ readonly runtimeId: string;
299
+ };
300
+ readonly axes: {
301
+ readonly openUsdStructure: ValidationAxisV1;
302
+ readonly resourceClosure: ValidationAxisV1;
303
+ readonly physicsPreservation: ValidationAxisV1;
304
+ readonly formatReadback: ValidationAxisV1;
305
+ readonly packageReadback: ValidationAxisV1;
306
+ readonly stormRender: ValidationAxisV1;
307
+ readonly isaacProfileStatic: ValidationAxisV1;
308
+ readonly isaacRuntime: ValidationAxisV1;
309
+ };
310
+ readonly physics: UsdPhysicsPreservationV1;
311
+ readonly resourceClosure: {
312
+ readonly expectedFiles: readonly string[];
313
+ readonly unresolvedPaths: readonly string[];
314
+ readonly externalModuleReferences: readonly string[];
315
+ readonly packageManifest: readonly {
316
+ readonly path: string;
317
+ readonly byteSize: number;
318
+ readonly dataOffset: number;
319
+ }[];
320
+ readonly resourceManifest: readonly UsdExportResourceFactV1[];
321
+ readonly nestedPackages: readonly UsdNestedUsdzFactV1[];
322
+ };
323
+ readonly evidenceDigest: string;
324
+ }
325
+ export type ValidationAxisStatus = 'passed' | 'failed' | 'review_required' | 'stale' | 'not_run' | 'not_applicable';
326
+ export interface ValidationAxisV1 {
327
+ readonly status: ValidationAxisStatus;
328
+ }
329
+ export interface DeliveryValidationEvidenceV1 {
330
+ readonly format: typeof DELIVERY_EVIDENCE_FORMAT;
331
+ readonly schemaVersion: 1;
332
+ readonly subjectDigest: string;
333
+ readonly profileDigest: string;
334
+ readonly validator: {
335
+ readonly id: string;
336
+ readonly version: string;
337
+ readonly optionsDigest: string;
338
+ };
339
+ readonly axes: {
340
+ readonly openUsdStructure: ValidationAxisV1;
341
+ readonly stormRender: ValidationAxisV1;
342
+ readonly isaacProfileStatic: ValidationAxisV1;
343
+ readonly isaacRuntime: ValidationAxisV1;
344
+ };
345
+ readonly evidenceDigest: string;
346
+ }
347
+ export interface DeliveryEvidenceExpectationV1 {
348
+ readonly subjectDigest: string;
349
+ readonly profile: DeliveryProfileV1;
350
+ readonly validator: {
351
+ readonly id: string;
352
+ readonly version: string;
353
+ readonly optionsDigest: string;
354
+ };
355
+ }
356
+ export interface DeliveryArtifactSelectionV2 {
357
+ readonly artifact: DeliveryArtifactV2;
358
+ readonly lock?: import('../project/contracts').DeliveryLockV1;
359
+ }
360
+ export type DeliveryResourceManifestEntry = ResourceManifestEntryV2;
361
+ export type DeliveryDiagnostic = DeliveryDiagnosticV1;
362
+ export {};
@@ -0,0 +1,3 @@
1
+ import type { UsdDeliveryPlanV4 } from './contracts';
2
+ export declare function calculateUsdDeliveryPlanDigest(plan: Omit<UsdDeliveryPlanV4, 'planDigest'> | UsdDeliveryPlanV4): string;
3
+ export declare function assertUsdDeliveryPlanV4(value: unknown): asserts value is UsdDeliveryPlanV4;
@@ -0,0 +1,10 @@
1
+ import type { DeliveryEvidenceExpectationV1, DeliveryValidationEvidenceV1 } from './contracts';
2
+ export declare function createDeliveryValidationEvidence(input: {
3
+ readonly subjectDigest: string;
4
+ readonly profile: DeliveryEvidenceExpectationV1['profile'];
5
+ readonly validator: DeliveryEvidenceExpectationV1['validator'];
6
+ readonly axes: DeliveryValidationEvidenceV1['axes'];
7
+ }): DeliveryValidationEvidenceV1;
8
+ export declare function isDeliveryEvidenceCurrent(evidence: DeliveryValidationEvidenceV1, expectation: DeliveryEvidenceExpectationV1): boolean;
9
+ export declare function applyDeliveryEvidenceFreshness(evidence: DeliveryValidationEvidenceV1, expectation: DeliveryEvidenceExpectationV1): DeliveryValidationEvidenceV1;
10
+ export declare function calculateValidatorOptionsDigest(options: unknown): string;
@@ -0,0 +1,3 @@
1
+ import type { UsdExportEvidenceV3, UsdExportFile } from './contracts';
2
+ export declare function calculateUsdPackageDigest(files: readonly Pick<UsdExportFile, 'path' | 'sha256' | 'bytes'>[]): string;
3
+ export declare function createUsdExportEvidence(input: Omit<UsdExportEvidenceV3, 'format' | 'schemaVersion' | 'evidenceDigest'>): UsdExportEvidenceV3;
@@ -0,0 +1,9 @@
1
+ export { DELIVERY_EVIDENCE_FORMAT, DELIVERY_PROFILE_FORMAT, USD_DELIVERY_PLAN_FORMAT, USD_EXPORT_EVIDENCE_FORMAT, } from './contracts';
2
+ export type { BuildUsdDeliveryPlanInputV4, DeliveryDiagnostic, DeliveryEvidenceExpectationV1, DeliveryProfileV1, DeliveryResourceManifestEntry, DeliveryResourceRefV2, DeliveryValidationEvidenceV1, UsdDeliveryAttributeValueV1, UsdDeliveryGroupNodeV3, UsdDeliveryJointOverrideV1, UsdDeliveryNodeV3, UsdDeliveryPhysicsMaterialV1, UsdDeliveryPhysicsV1, UsdDeliveryPlanV4, UsdDeliveryReferenceNodeV3, UsdDeliveryReferenceV1, UsdExportDiagnosticV1, UsdExportEvidenceV3, UsdExportResourceFactV1, UsdNestedUsdzFactV1, UsdResourceOutputTransformV1, UsdExportFile, UsdExportLimits, UsdExportProgress, UsdExportProgressPhase, UsdExportRequest, UsdExportResourceReader, UsdExportResourceReaderOptions, UsdExportResult, UsdLayerEncoding, UsdPackageKind, UsdPhysicsFactsV1, UsdPhysicsPreservationV1, ValidationAxisStatus, ValidationAxisV1, } from './contracts';
3
+ export { ISAAC_SIM_M1_PROFILE, calculateDeliveryProfileDigest, validateDeliveryProfile } from './profile';
4
+ export { assignPrimNames, sanitizeIdentifier, toSlug } from './prim-name';
5
+ export type { PrimNameAssignment, PrimNameInput, PrimNameResult } from './prim-name';
6
+ export { buildUsdDeliveryPlan } from './build-plan';
7
+ export { assertUsdDeliveryPlanV4, calculateUsdDeliveryPlanDigest } from './digest';
8
+ export { applyDeliveryEvidenceFreshness, calculateValidatorOptionsDigest, createDeliveryValidationEvidence, isDeliveryEvidenceCurrent, } from './evidence';
9
+ export { calculateUsdPackageDigest, createUsdExportEvidence, } from './export-evidence';
@@ -0,0 +1,17 @@
1
+ export interface PrimNameInput {
2
+ readonly instanceId: string;
3
+ readonly label: string;
4
+ }
5
+ export interface PrimNameAssignment {
6
+ readonly instanceId: string;
7
+ readonly from: string;
8
+ readonly to: string;
9
+ readonly fallback: boolean;
10
+ }
11
+ export interface PrimNameResult {
12
+ readonly byInstanceId: ReadonlyMap<string, string>;
13
+ readonly renames: readonly PrimNameAssignment[];
14
+ }
15
+ export declare function assignPrimNames(inputs: readonly PrimNameInput[]): PrimNameResult;
16
+ export declare function sanitizeIdentifier(label: string): string | null;
17
+ export declare function toSlug(label: string, fallbackId: string): string;
@@ -0,0 +1,4 @@
1
+ import type { DeliveryProfileV1 } from './contracts';
2
+ export declare const ISAAC_SIM_M1_PROFILE: DeliveryProfileV1;
3
+ export declare function calculateDeliveryProfileDigest(profile: DeliveryProfileV1): string;
4
+ export declare function validateDeliveryProfile(profile: DeliveryProfileV1): void;