@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,2 @@
1
+ export { configureCadTextBuilder as configureViewerText, } from '@nebula-spatial/cad-loader';
2
+ export type { CadTextBuilderOptions as ViewerTextBuilderOptions, } from '@nebula-spatial/cad-loader';
@@ -0,0 +1,368 @@
1
+ import type { RenderDebugBreakdownEntry, SplitBlockLayerDetail } from '@nebula-spatial/cad-loader';
2
+ import type { CadSessionLoadTiming } from '@nebula-spatial/cad-loader';
3
+ import type { ViewerViewMode } from '../types';
4
+ import type { AssetSingleSource } from '../assets/source-types';
5
+ export type { ViewerUiOptions, ViewerSceneUiOptions, ViewerSceneUiParts, ViewerUiPreset, ViewerUiTheme, ViewerUiTokens } from '../ui/types';
6
+ export type { CadSessionLoadTiming } from '@nebula-spatial/cad-loader';
7
+ export type { RenderDebugBreakdownEntry, SplitBlockLayerDetail } from '@nebula-spatial/cad-loader';
8
+ export type CadSessionPhase = 'created' | 'header-ready' | 'initial-loading' | 'interactive' | 'failed' | 'disposed';
9
+ export interface CadWorldBounds {
10
+ readonly minX: number;
11
+ readonly minY: number;
12
+ readonly minZ: number;
13
+ readonly maxX: number;
14
+ readonly maxY: number;
15
+ readonly maxZ: number;
16
+ readonly planar: boolean;
17
+ }
18
+ /** CAD accepts the common single-source forms plus its legacy packFile form. */
19
+ export type CadLoadSource = AssetSingleSource | {
20
+ /** CAD-specific package source; do not use AssetSource's { kind: 'files' }. */
21
+ readonly kind: 'packFile';
22
+ readonly file: Pick<File, 'arrayBuffer'>;
23
+ };
24
+ export interface CadFontRequest {
25
+ readonly family?: string;
26
+ readonly styleName?: string;
27
+ readonly shxName?: string;
28
+ readonly weight?: number;
29
+ readonly italic?: boolean;
30
+ }
31
+ export interface CadResolvedFont {
32
+ readonly fontUrl?: string;
33
+ readonly family?: string;
34
+ readonly fallback: boolean;
35
+ readonly sourceFingerprint?: string;
36
+ }
37
+ export interface CadFontResolver {
38
+ resolve(request: CadFontRequest, signal?: AbortSignal): Promise<CadResolvedFont | null>;
39
+ }
40
+ export interface CadResolvedTextFont {
41
+ readonly text: string;
42
+ readonly fontUrl?: string;
43
+ readonly kind?: string;
44
+ readonly replacedUnsupported: boolean;
45
+ }
46
+ export type ResolveTextFont = (text: string) => CadResolvedTextFont;
47
+ export interface CadTextWarmupOptions {
48
+ /** Idle delay before a scheduled warmup batch flushes. */
49
+ readonly idleDelayMs?: number;
50
+ /** Max unique characters accumulated per font before capping. */
51
+ readonly maxUniqueCharsPerFont?: number;
52
+ /** Per-preload timeout in milliseconds. */
53
+ readonly timeoutMs?: number;
54
+ /** Max remembered warm signatures. */
55
+ readonly signatureCacheLimit?: number;
56
+ }
57
+ export interface CadOpenOptions {
58
+ documentKey?: string;
59
+ filename?: string;
60
+ loadAnnotations?: boolean;
61
+ /** Override the package-relative geometry preparation Worker URL. */
62
+ workerUrl?: string | URL;
63
+ /** Create the geometry preparation Worker. Takes precedence over `workerUrl`. */
64
+ workerFactory?: () => Worker;
65
+ fontResolver?: CadFontResolver;
66
+ resolveTextFont?: ResolveTextFont;
67
+ /**
68
+ * Troika glyph warmup policy passed to the document session. Defaults to
69
+ * enabled; `false` disables background glyph preloading.
70
+ */
71
+ textWarmup?: boolean | CadTextWarmupOptions;
72
+ signal?: AbortSignal;
73
+ }
74
+ export interface CadDocumentHandle {
75
+ readonly documentKey: string | null;
76
+ readonly filename: string | null;
77
+ readonly phase: CadSessionPhase;
78
+ readonly headerBounds: CadWorldBounds | null;
79
+ readonly layerCount: number;
80
+ readonly units: CadDocumentUnits;
81
+ }
82
+ export interface CadDocumentUnits {
83
+ /** Source unit label. Legacy packs without metadata default to `mm`. */
84
+ readonly source: string;
85
+ readonly scaleToMeters?: number;
86
+ }
87
+ export interface CadLayerRow {
88
+ readonly index: number;
89
+ readonly name: string;
90
+ readonly visible: boolean;
91
+ readonly color: number | null;
92
+ readonly sourceColor: readonly [number, number, number];
93
+ }
94
+ export interface CadLayerModel {
95
+ readonly rows: readonly CadLayerRow[];
96
+ readonly allColor: number | null;
97
+ readonly revision: number;
98
+ toggle(index: number): void;
99
+ setVisible(index: number, visible: boolean): boolean;
100
+ setVisibleBatch(updates: ReadonlyArray<{
101
+ index: number;
102
+ visible: boolean;
103
+ }>): number;
104
+ showAll(): void;
105
+ hideAll(): void;
106
+ setColor(index: number, color: number | null): void;
107
+ setAllColor(color: number | null): void;
108
+ }
109
+ export interface CadBlockUsageRow {
110
+ readonly insertId: string;
111
+ readonly blockName: string;
112
+ readonly layerName: string;
113
+ readonly layerIndex: number;
114
+ readonly variantId: number;
115
+ readonly instanceId: number;
116
+ readonly label: string;
117
+ readonly canHighlight?: boolean;
118
+ readonly visible: boolean;
119
+ }
120
+ export interface CadBlockModel {
121
+ readonly usages: readonly CadBlockUsageRow[];
122
+ readonly revision: number;
123
+ toggleInsert(insertId: string, visible?: boolean): void;
124
+ batchToggleInserts(updates: ReadonlyArray<{
125
+ insertId: string;
126
+ visible: boolean;
127
+ }>): void;
128
+ }
129
+ export interface CadInsertSelectionId {
130
+ readonly kind: 'insert';
131
+ readonly layerIndex: number;
132
+ readonly variantId: number;
133
+ readonly instanceId: number;
134
+ }
135
+ export interface CadInsertSelection {
136
+ readonly documentKey: string | null;
137
+ readonly id: CadInsertSelectionId;
138
+ }
139
+ export interface CadTextSelectionId {
140
+ readonly kind: 'text';
141
+ readonly textId: number;
142
+ }
143
+ export interface CadTextSelection {
144
+ readonly documentKey: string | null;
145
+ readonly id: CadTextSelectionId;
146
+ }
147
+ export interface CadTextDetails {
148
+ readonly id: CadTextSelectionId;
149
+ readonly content: string;
150
+ readonly x: number;
151
+ readonly y: number;
152
+ readonly height: number;
153
+ readonly rotation: number;
154
+ readonly layerName: string;
155
+ readonly layerIndex: number;
156
+ }
157
+ export interface CadInsertDetails {
158
+ readonly id: CadInsertSelectionId;
159
+ readonly label: string;
160
+ readonly blockName: string;
161
+ readonly layerName: string;
162
+ readonly layerIndex: number;
163
+ readonly tx: number;
164
+ readonly ty: number;
165
+ readonly rotation: number | null;
166
+ readonly scaleX: number | null;
167
+ readonly scaleY: number | null;
168
+ readonly bbox: {
169
+ readonly minX: number;
170
+ readonly minY: number;
171
+ readonly maxX: number;
172
+ readonly maxY: number;
173
+ };
174
+ }
175
+ export interface CadInspectorSnapshot {
176
+ readonly selection: CadInsertSelection | null;
177
+ readonly details: CadInsertDetails | null;
178
+ readonly textSelection: CadTextSelection | null;
179
+ readonly textDetails: CadTextDetails | null;
180
+ readonly revision: number;
181
+ }
182
+ /** Live inspector model. Subscribe to `inspector-change` before reading it reactively. */
183
+ export interface CadInspectorModel extends CadInspectorSnapshot {
184
+ }
185
+ export interface CadScaleRulerState {
186
+ readonly visible: boolean;
187
+ readonly lengthLabel: string;
188
+ readonly worldLength: number;
189
+ }
190
+ export interface CadHudSnapshot {
191
+ readonly revision: number;
192
+ readonly filename: string | null;
193
+ readonly fileCount: number;
194
+ readonly visibleLayerCount: number;
195
+ readonly totalLayerCount: number;
196
+ readonly statusMessage: string;
197
+ readonly zoomLabel: string;
198
+ readonly orbitDistanceLabel: string;
199
+ readonly scaleRuler: CadScaleRulerState | null;
200
+ readonly viewportVertexCount: number;
201
+ readonly drawCalls: number;
202
+ readonly fps: number;
203
+ readonly lineRenderMode: string;
204
+ readonly entityCount: number;
205
+ readonly lineCount: number;
206
+ readonly fillCount: number;
207
+ readonly dotCount: number;
208
+ readonly textCount: number;
209
+ readonly renderableCount: number;
210
+ readonly submittedVertexRefs: number;
211
+ readonly blockVariantCount: number;
212
+ readonly blockInstanceCount: number;
213
+ readonly splitBlockLayerGroupCount: number;
214
+ readonly renderDebugBreakdown: readonly RenderDebugBreakdownEntry[];
215
+ readonly splitBlockLayerDetails: readonly SplitBlockLayerDetail[];
216
+ readonly phase: CadSessionPhase | null;
217
+ }
218
+ /** Live HUD model. Subscribe to `hud-change` before reading it reactively. */
219
+ export interface CadHudModel extends CadHudSnapshot {
220
+ }
221
+ export interface CadViewerEventMap {
222
+ 'document-change': {
223
+ document: CadDocumentHandle | null;
224
+ };
225
+ 'layer-change': {
226
+ layers: CadLayerModel;
227
+ };
228
+ 'block-change': {
229
+ blocks: CadBlockModel;
230
+ };
231
+ 'inspector-change': {
232
+ inspector: CadInspectorModel;
233
+ };
234
+ 'hud-change': {
235
+ hud: CadHudModel;
236
+ };
237
+ 'load-timing': {
238
+ timing: CadSessionLoadTiming;
239
+ };
240
+ 'load-progress': CadLoadProgress;
241
+ error: CadViewerErrorEvent;
242
+ }
243
+ export interface CadLoadProgress {
244
+ readonly phase: CadSessionPhase;
245
+ readonly progress: number;
246
+ readonly pending: number;
247
+ readonly loaded: number;
248
+ readonly settled: boolean;
249
+ }
250
+ export type CadViewerErrorCode = 'E_SOURCE' | 'E_FETCH' | 'E_PARSE_HEADER' | 'E_PARSE_GEOMETRY' | 'E_WORKER' | 'E_SIDECAR_FETCH' | 'E_ANNOTATION' | 'E_FONT' | 'E_ABORTED' | 'E_SUPERSEDED';
251
+ export interface CadViewerErrorEvent {
252
+ readonly code: CadViewerErrorCode;
253
+ readonly stage: 'source' | 'header' | 'geometry' | 'worker' | 'sidecar' | 'annotation' | 'font' | 'lifecycle';
254
+ readonly fatal: boolean;
255
+ readonly source: CadLoadSource | null;
256
+ readonly error: Error;
257
+ }
258
+ export type CadSelection = {
259
+ readonly kind: 'insert';
260
+ readonly selection: CadInsertSelection;
261
+ } | {
262
+ readonly kind: 'text';
263
+ readonly selection: CadTextSelection;
264
+ };
265
+ export type CadHit = {
266
+ readonly kind: 'insert';
267
+ readonly selection: CadInsertSelection;
268
+ readonly details: CadInsertDetails | null;
269
+ } | {
270
+ readonly kind: 'text';
271
+ readonly selection: CadTextSelection;
272
+ readonly details: CadTextDetails | null;
273
+ };
274
+ export interface CadViewerSnapshot {
275
+ readonly revision: number;
276
+ readonly document: CadDocumentHandle | null;
277
+ readonly layers: {
278
+ readonly rows: readonly CadLayerRow[];
279
+ readonly allColor: number | null;
280
+ readonly revision: number;
281
+ };
282
+ readonly blocks: {
283
+ readonly usages: readonly CadBlockUsageRow[];
284
+ readonly revision: number;
285
+ };
286
+ readonly inspector: CadInspectorSnapshot;
287
+ readonly hud: CadHudSnapshot;
288
+ readonly loadTiming: CadSessionLoadTiming | null;
289
+ }
290
+ export interface CadViewerCapability {
291
+ readonly document: CadDocumentHandle | null;
292
+ readonly layers: CadLayerModel;
293
+ readonly blocks: CadBlockModel;
294
+ readonly inspector: CadInspectorModel;
295
+ readonly hud: CadHudModel;
296
+ readonly loadTiming: CadSessionLoadTiming | null;
297
+ readonly capabilities: {
298
+ readonly insertSelection: true;
299
+ readonly textSelection: true;
300
+ readonly insertPreview: true;
301
+ readonly batchVisibility: true;
302
+ };
303
+ /**
304
+ * @deprecated Use `viewer.openAsset(source, { format: 'cad', cad: options })`
305
+ * and read `viewer.cad.document` after `asset.ready`.
306
+ */
307
+ open(source: CadLoadSource, options?: CadOpenOptions): Promise<CadDocumentHandle>;
308
+ /**
309
+ * @deprecated Use `viewer.closeAsset()` to close the active asset.
310
+ */
311
+ close(): void;
312
+ renderInsertPreview(canvas: HTMLCanvasElement): boolean;
313
+ hitTest(clientX: number, clientY: number, options?: {
314
+ readonly kinds?: readonly ('insert' | 'text')[];
315
+ }): CadHit | null;
316
+ select(selection: CadSelection | null): void;
317
+ clearSelection(): void;
318
+ getSnapshot(): CadViewerSnapshot;
319
+ fitDocument(): boolean;
320
+ fitSelection(): boolean;
321
+ on<K extends keyof CadViewerEventMap>(type: K, listener: (event: CadViewerEventMap[K]) => void): () => void;
322
+ }
323
+ export interface ViewerCadUiParts {
324
+ layerPanel?: boolean;
325
+ propertyPanel?: boolean;
326
+ hud?: boolean;
327
+ viewMode?: boolean;
328
+ fit?: boolean;
329
+ scaleRuler?: boolean;
330
+ /** Show the line-render-mode chip in the infobar. Default: true. */
331
+ infobarLineMode?: boolean;
332
+ /** Show the session phase label in the infobar. Default: true. */
333
+ infobarPhase?: boolean;
334
+ /** Show the Debug details card in the infobar. Default: true. */
335
+ infobarDebug?: boolean;
336
+ }
337
+ /** Options belonging only to the built-in CAD UI group. */
338
+ export interface ViewerCadUiOptions {
339
+ parts?: ViewerCadUiParts;
340
+ persistence?: boolean;
341
+ persistenceKey?: string;
342
+ stateStore?: ViewerCadUiStateStore;
343
+ keyboard?: ViewerCadUiKeyboardOptions;
344
+ unitFormatter?: (value: number, context: {
345
+ readonly unit: string;
346
+ readonly viewMode: ViewerViewMode;
347
+ }) => string;
348
+ }
349
+ export interface ViewerCadUiStateStore {
350
+ read(key: string): string | null;
351
+ write(key: string, value: string): void;
352
+ }
353
+ export interface ViewerCadUiKeyboardOptions {
354
+ enabled?: boolean;
355
+ /**
356
+ * Restrict shortcuts to this element. A pointer interaction inside it focuses
357
+ * the target unless the interaction began in an editable control.
358
+ */
359
+ target?: HTMLElement;
360
+ shortcuts?: {
361
+ /** Key used by the built-in fit command. Defaults to `f`; `false` disables it. */
362
+ fit?: string | false;
363
+ };
364
+ }
365
+ export interface CameraStateStore {
366
+ read(key: string): unknown | null;
367
+ write(key: string, value: unknown): void;
368
+ }