@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,278 @@
1
+ import type { Box3, ColorRepresentation, Object3D, Vector3 } from 'three';
2
+ import type { CadViewerCapability, CameraStateStore, ViewerUiOptions, ViewerUiTheme } from './cad/types';
3
+ import type { AssetChangeEvent, AssetControlChangeEvent, AssetErrorEvent, AssetPreview, AssetSource, OpenAssetOptions, ViewerAssetOptions } from './assets/types';
4
+ import type { SceneControl, SceneEntry, SceneOptions } from './scene/types';
5
+ export type { CadBlockModel, CadDocumentHandle, CadDocumentUnits, CadFontResolver, CadFontRequest, CadResolvedFont, CadResolvedTextFont, CadTextWarmupOptions, CadHudModel, CadHudSnapshot, CadInspectorModel, CadInspectorSnapshot, CadLayerModel, CadLayerRow, CadBlockUsageRow, CadSessionPhase, CadWorldBounds, CadScaleRulerState, CadInsertDetails, CadInsertSelection, CadInsertSelectionId, CadTextDetails, CadTextSelection, CadTextSelectionId, CadSelection, CadHit, CadViewerSnapshot, CadLoadProgress, CadViewerErrorCode, CadViewerErrorEvent, CadLoadSource, CadOpenOptions, CadSessionLoadTiming, RenderDebugBreakdownEntry, SplitBlockLayerDetail, CadViewerCapability, ResolveTextFont, CadViewerEventMap, CameraStateStore, ViewerCadUiKeyboardOptions, ViewerUiOptions, ViewerCadUiParts, ViewerCadUiOptions, ViewerUiPreset, ViewerCadUiStateStore, ViewerUiTheme, ViewerUiTokens, } from './cad/types';
6
+ export type ViewerViewMode = '2d' | '3d';
7
+ export type CadInteractionMode = 'managed' | 'manual' | 'disabled';
8
+ /**
9
+ * Which 3D navigation implementation the runtime drives.
10
+ * `viewer` is the CAD path; `preview` is the model/simulation particle viewer
11
+ * matching sim-studio. Kept as its own union so the viewer's public surface
12
+ * does not re-export the runtime package's type.
13
+ */
14
+ export type ViewerNavigationPolicy = 'legacy' | 'viewer' | 'preview';
15
+ /**
16
+ * Model/simulation preview pointer mapping. `left-rotate` (default) orbits with
17
+ * the left button and pans with the right; `left-pan` inverts that; `studio`
18
+ * pans with the left or middle button and orbits with the right. Own union so
19
+ * the viewer surface does not re-export the runtime package's type.
20
+ */
21
+ export type ViewerPreviewDragPreset = 'left-rotate' | 'left-pan' | 'studio';
22
+ export type CameraChangeReason = 'pointer' | 'wheel' | 'fit' | 'restore' | 'api' | 'view-mode';
23
+ export type ViewerEnvironment = 'room' | {
24
+ /** Load an external equirectangular HDR texture for image-based lighting. */
25
+ readonly type: 'hdr';
26
+ readonly url: string;
27
+ };
28
+ export interface ViewerDocumentRect {
29
+ readonly minX: number;
30
+ readonly minY: number;
31
+ readonly maxX: number;
32
+ readonly maxY: number;
33
+ }
34
+ export interface ViewerOrthographicSnapshot {
35
+ readonly left: number;
36
+ readonly right: number;
37
+ readonly top: number;
38
+ readonly bottom: number;
39
+ readonly zoom: number;
40
+ readonly positionX: number;
41
+ readonly positionY: number;
42
+ readonly targetX: number;
43
+ readonly targetY: number;
44
+ }
45
+ export interface ViewerOrbitSnapshot {
46
+ readonly targetX: number;
47
+ readonly targetY: number;
48
+ readonly targetZ: number;
49
+ readonly distance: number;
50
+ readonly yaw: number;
51
+ readonly pitch: number;
52
+ }
53
+ export interface ViewerCameraSnapshot {
54
+ readonly schemaVersion: number;
55
+ readonly viewMode: ViewerViewMode;
56
+ readonly orthographic?: ViewerOrthographicSnapshot;
57
+ readonly orbit?: ViewerOrbitSnapshot;
58
+ }
59
+ export interface ViewerOptions {
60
+ viewport: HTMLElement;
61
+ canvas: HTMLCanvasElement;
62
+ clearColor?: ColorRepresentation;
63
+ antialias?: boolean;
64
+ alpha?: boolean;
65
+ powerPreference?: WebGLPowerPreference;
66
+ initialViewMode?: ViewerViewMode;
67
+ /** Image-based lighting environment. Defaults to the built-in room environment. */
68
+ environment?: ViewerEnvironment;
69
+ /** Pointer mapping for model/simulation previews. Defaults to `left-rotate`. */
70
+ previewDragPreset?: ViewerPreviewDragPreset;
71
+ autoSelectOnPick?: boolean;
72
+ pointerPick?: boolean;
73
+ /** CAD click policy. Defaults to managed. */
74
+ cadInteraction?: CadInteractionMode;
75
+ cadInteractionStyle?: {
76
+ hover?: {
77
+ color?: ColorRepresentation;
78
+ fillOpacity?: number;
79
+ edgeOpacity?: number;
80
+ enabled?: boolean;
81
+ };
82
+ selected?: {
83
+ color?: ColorRepresentation;
84
+ fillOpacity?: number;
85
+ edgeOpacity?: number;
86
+ enabled?: boolean;
87
+ };
88
+ };
89
+ cameraStateStore?: CameraStateStore | false;
90
+ /** Max delay for merged viewport demands while the interaction is active. Default 160ms. */
91
+ viewportDemandCoalesceMs?: number;
92
+ ui?: ViewerUiOptions;
93
+ assets?: ViewerAssetOptions;
94
+ onCleanupError?: (event: AssetErrorEvent) => void;
95
+ }
96
+ export interface ViewerFitViewOptions {
97
+ padding?: number;
98
+ viewMode?: ViewerViewMode;
99
+ }
100
+ export interface ViewerPickOptions {
101
+ /** Stop at the nearest intersection when accelerated picking is available. */
102
+ firstHitOnly?: boolean;
103
+ roots?: readonly Object3D[];
104
+ recursive?: boolean;
105
+ includeInvisible?: boolean;
106
+ }
107
+ export interface ViewerPickResult {
108
+ object: Object3D;
109
+ root: Object3D;
110
+ point: Vector3;
111
+ distance: number;
112
+ faceIndex: number | null;
113
+ instanceId?: number;
114
+ }
115
+ export interface ViewerHighlightOptions {
116
+ color?: ColorRepresentation;
117
+ }
118
+ export interface ViewerObjectOptions {
119
+ /** Viewer only mounts the object; the caller retains responsibility for GPU resource disposal. */
120
+ readonly ownership?: 'borrowed';
121
+ }
122
+ export interface ViewerRenderStats {
123
+ readonly drawCalls: number;
124
+ readonly submittedVertexRefs: number;
125
+ readonly fps: number;
126
+ }
127
+ export interface ViewerPointerEvent {
128
+ clientX: number;
129
+ clientY: number;
130
+ buttons: number;
131
+ shiftKey: boolean;
132
+ ctrlKey: boolean;
133
+ metaKey: boolean;
134
+ }
135
+ export interface ViewerEventMap {
136
+ 'pointer-move': ViewerPointerEvent;
137
+ 'pointer-leave': ViewerPointerEvent;
138
+ 'pointer-click': ViewerPointerEvent;
139
+ pick: ViewerPointerEvent & {
140
+ result: ViewerPickResult | null;
141
+ };
142
+ 'selection-change': {
143
+ object: Object3D | null;
144
+ };
145
+ 'highlight-change': {
146
+ object: Object3D | null;
147
+ };
148
+ 'view-mode-change': {
149
+ viewMode: ViewerViewMode;
150
+ };
151
+ 'theme-change': {
152
+ theme: ViewerUiTheme;
153
+ };
154
+ resize: {
155
+ resized: boolean;
156
+ };
157
+ 'viewport-change': {
158
+ viewportWidthPx: number;
159
+ viewportHeightPx: number;
160
+ worldUnitsPerPixel: number;
161
+ interaction: 'active' | 'idle';
162
+ };
163
+ 'interaction-change': {
164
+ interaction: 'active' | 'idle';
165
+ };
166
+ 'content-change': {
167
+ source: 'object' | 'cad';
168
+ };
169
+ 'camera-change': {
170
+ viewMode: ViewerViewMode;
171
+ reason: CameraChangeReason;
172
+ interaction: 'active' | 'idle';
173
+ };
174
+ 'ui-layout-change': {
175
+ contentInsets: {
176
+ readonly top: number;
177
+ readonly right: number;
178
+ readonly bottom: number;
179
+ readonly left: number;
180
+ };
181
+ layerPanelOpen: boolean;
182
+ propertyPanelOpen: boolean;
183
+ };
184
+ 'asset-change': AssetChangeEvent;
185
+ 'asset-error': AssetErrorEvent;
186
+ 'asset-control-change': AssetControlChangeEvent;
187
+ }
188
+ export interface Viewer {
189
+ readonly viewport: HTMLElement;
190
+ readonly canvas: HTMLCanvasElement;
191
+ readonly viewMode: ViewerViewMode;
192
+ readonly selectedObject: Object3D | null;
193
+ readonly highlightedObject: Object3D | null;
194
+ readonly isDisposed: boolean;
195
+ readonly cad: CadViewerCapability;
196
+ readonly overlays: {
197
+ set(key: string, object: Object3D, options?: {
198
+ owned?: boolean;
199
+ }): void;
200
+ remove(key: string, options?: {
201
+ dispose?: boolean;
202
+ }): Object3D | null;
203
+ };
204
+ readonly camera: {
205
+ getState(): ViewerCameraSnapshot | null;
206
+ /** Applies a validated snapshot immediately. Animated transitions are not part of the current contract. */
207
+ setState(snapshot: ViewerCameraSnapshot): boolean;
208
+ reset(): boolean;
209
+ };
210
+ readonly plugins: import('./plugins').ViewerPluginRegistry;
211
+ readonly commands: {
212
+ execute(id: string, args?: unknown): boolean;
213
+ has(id: string): boolean;
214
+ };
215
+ openAsset(source: AssetSource, options?: OpenAssetOptions): AssetPreview;
216
+ closeAsset(): Promise<void>;
217
+ /**
218
+ * Opens a multi-asset scene under the existing single Renderer/Scene/RAF.
219
+ * A scene owns one stage and one child group per placed asset; each asset is
220
+ * still loaded by its own format loader. Only one scene may be open at a
221
+ * time, and opening a scene closes any active single asset (and vice versa).
222
+ */
223
+ openScene(entries: readonly SceneEntry[], options?: SceneOptions): SceneControl;
224
+ closeScene(): Promise<void>;
225
+ addObject(object: Object3D, options?: ViewerObjectOptions): void;
226
+ removeObject(object: Object3D): boolean;
227
+ setVisible(object: Object3D, visible: boolean): void;
228
+ setViewMode(mode: ViewerViewMode, options?: {
229
+ preserveOrbit?: boolean;
230
+ }): void;
231
+ /** Switches the UI and active preview stage theme at runtime. */
232
+ setTheme(theme: ViewerUiTheme): boolean;
233
+ fitView(target?: Object3D | Box3, options?: ViewerFitViewOptions): boolean;
234
+ fitAll(options?: ViewerFitViewOptions): boolean;
235
+ screenToWorldOnPlane(clientX: number, clientY: number, planeZ?: number): Vector3 | null;
236
+ pick(clientX: number, clientY: number, options?: ViewerPickOptions): ViewerPickResult | null;
237
+ setSelection(object: Object3D | null): void;
238
+ setHighlight(object: Object3D | null, options?: ViewerHighlightOptions): void;
239
+ on<K extends keyof ViewerEventMap>(type: K, listener: (event: ViewerEventMap[K]) => void): () => void;
240
+ captureFrame(options: ViewerCaptureOptions): Promise<ViewerCaptureResult>;
241
+ resize(): boolean;
242
+ requestRender(): void;
243
+ getActiveCamera(): import('three').Camera;
244
+ setNavigationEnabled(enabled: boolean): void;
245
+ /** Switches the model/simulation preview pointer mapping at runtime. */
246
+ setPreviewDragPreset(preset: ViewerPreviewDragPreset): void;
247
+ dispose(): void;
248
+ use(plugins: readonly import('./plugins').ViewerPlugin[], options?: {
249
+ replace?: boolean;
250
+ }): void;
251
+ }
252
+ export interface ViewerCaptureOptions {
253
+ readonly width: number;
254
+ readonly height: number;
255
+ readonly format?: 'image/png' | 'image/jpeg' | 'image/webp';
256
+ readonly quality?: number;
257
+ readonly background?: 'scene' | 'transparent' | {
258
+ readonly color: readonly [number, number, number];
259
+ };
260
+ readonly crop?: {
261
+ readonly x: number;
262
+ readonly y: number;
263
+ readonly width: number;
264
+ readonly height: number;
265
+ };
266
+ readonly signal?: AbortSignal;
267
+ readonly frameBounds?: {
268
+ readonly min: readonly [number, number, number];
269
+ readonly max: readonly [number, number, number];
270
+ };
271
+ readonly padding?: number;
272
+ }
273
+ export interface ViewerCaptureResult {
274
+ readonly blob: Blob;
275
+ readonly width: number;
276
+ readonly height: number;
277
+ readonly format: string;
278
+ }
@@ -0,0 +1,48 @@
1
+ import type { ViewerCadUiOptions } from '../cad/types';
2
+ /** Theme shared by every package-owned UI group. */
3
+ export type ViewerUiTheme = 'dark' | 'light';
4
+ /** Which built-in UI groups the viewer registers. */
5
+ export type ViewerUiPreset = 'auto' | 'cad-readonly' | 'none';
6
+ /** Options for the built-in model/simulation scene UI group. */
7
+ export interface ViewerSceneUiOptions {
8
+ parts?: ViewerSceneUiParts;
9
+ }
10
+ export interface ViewerSceneUiParts {
11
+ filename?: boolean;
12
+ playback?: boolean;
13
+ reset?: boolean;
14
+ fit?: boolean;
15
+ upAxis?: boolean;
16
+ scaleRuler?: boolean;
17
+ ground?: boolean;
18
+ collision?: boolean;
19
+ theme?: boolean;
20
+ }
21
+ /** Shared UI configuration; asset-specific controls live in their named groups. */
22
+ export interface ViewerUiOptions {
23
+ root: HTMLElement;
24
+ preset?: ViewerUiPreset;
25
+ /** Single initial theme source; built-in buttons switch it internally at runtime. */
26
+ theme?: ViewerUiTheme;
27
+ tokens?: ViewerUiTokens;
28
+ style?: string | ((root: ShadowRoot) => void);
29
+ locale?: string;
30
+ messages?: Readonly<Record<string, string>>;
31
+ messageResolver?: (key: string, params?: Readonly<Record<string, string | number>>) => string | undefined;
32
+ /** Defaults to the viewport; 'none' only broadcasts layout changes. */
33
+ insetTarget?: HTMLElement | 'none';
34
+ cad?: ViewerCadUiOptions;
35
+ /** Shared scene controls for model and simulation assets, gated by capabilities. */
36
+ scene?: ViewerSceneUiOptions;
37
+ /** Built-in URDF review workbench. Defaults to true for preset 'auto'. */
38
+ urdf?: boolean;
39
+ }
40
+ export interface ViewerUiTokens {
41
+ accent?: string;
42
+ panelBackground?: string;
43
+ background?: string;
44
+ text?: string;
45
+ textDim?: string;
46
+ border?: string;
47
+ hudBackground?: string;
48
+ }