symbiote-ui 0.3.0-alpha.4

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 (322) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/LICENSE +21 -0
  3. package/README.md +76 -0
  4. package/canvas/AutoLayout.js +731 -0
  5. package/canvas/Breadcrumb/Breadcrumb.css.js +75 -0
  6. package/canvas/Breadcrumb/Breadcrumb.js +96 -0
  7. package/canvas/Breadcrumb/Breadcrumb.tpl.js +7 -0
  8. package/canvas/CanvasConnectionRenderer.js +971 -0
  9. package/canvas/CanvasGraph/CanvasGraph.css.js +29 -0
  10. package/canvas/CanvasGraph/CanvasGraph.js +1697 -0
  11. package/canvas/CanvasGraph/CanvasGraphDrawState.js +280 -0
  12. package/canvas/CanvasGraph/CanvasGraphGeometry.js +194 -0
  13. package/canvas/CanvasViewport.js +550 -0
  14. package/canvas/ConnectionRenderer.js +1283 -0
  15. package/canvas/FlowSimulator.js +326 -0
  16. package/canvas/ForceLayout.js +226 -0
  17. package/canvas/ForceWorker.js +1303 -0
  18. package/canvas/FrameManager.js +223 -0
  19. package/canvas/GraphExplorerShell/GraphExplorerShell.css.js +136 -0
  20. package/canvas/GraphExplorerShell/GraphExplorerShell.js +129 -0
  21. package/canvas/GraphExplorerShell/GraphExplorerShell.tpl.js +12 -0
  22. package/canvas/GraphTabs/GraphTabs.css.js +101 -0
  23. package/canvas/GraphTabs/GraphTabs.js +189 -0
  24. package/canvas/GraphTabs/GraphTabs.tpl.js +12 -0
  25. package/canvas/LODManager.js +88 -0
  26. package/canvas/Minimap/Minimap.css.js +73 -0
  27. package/canvas/Minimap/Minimap.js +210 -0
  28. package/canvas/Minimap/Minimap.tpl.js +7 -0
  29. package/canvas/NodeCanvas/NodeCanvas.css.js +398 -0
  30. package/canvas/NodeCanvas/NodeCanvas.js +1499 -0
  31. package/canvas/NodeCanvas/NodeCanvas.tpl.js +22 -0
  32. package/canvas/NodeSearch/NodeSearch.css.js +97 -0
  33. package/canvas/NodeSearch/NodeSearch.js +140 -0
  34. package/canvas/NodeSearch/NodeSearch.tpl.js +25 -0
  35. package/canvas/NodeViewManager.js +748 -0
  36. package/canvas/PcbRouteDiagnostics.js +463 -0
  37. package/canvas/PcbRouter.js +1127 -0
  38. package/canvas/PinExpansion.js +134 -0
  39. package/canvas/PseudoConnection.js +84 -0
  40. package/canvas/SelectionSync.js +163 -0
  41. package/canvas/SubgraphManager.js +203 -0
  42. package/canvas/SubgraphRouter.js +452 -0
  43. package/canvas/ViewportActions.js +473 -0
  44. package/canvas/graph-explorer.js +339 -0
  45. package/canvas/graph-layout.js +148 -0
  46. package/canvas/graph-model.js +68 -0
  47. package/canvas/html-in-canvas.js +202 -0
  48. package/canvas/project-graph-builder.js +440 -0
  49. package/canvas/project-graph-model.js +183 -0
  50. package/chat/ChatComposer/ChatComposer.css.js +652 -0
  51. package/chat/ChatComposer/ChatComposer.js +304 -0
  52. package/chat/ChatList/ChatList.css.js +102 -0
  53. package/chat/ChatList/ChatList.js +99 -0
  54. package/chat/ChatList/ChatList.tpl.js +20 -0
  55. package/chat/ChatListItem/ChatListItem.css.js +117 -0
  56. package/chat/ChatListItem/ChatListItem.js +32 -0
  57. package/chat/ChatListItem/ChatListItem.tpl.js +17 -0
  58. package/chat/ChatMessageItem/ChatMessageItem.css.js +628 -0
  59. package/chat/ChatMessageItem/ChatMessageItem.js +156 -0
  60. package/chat/ChatSidebar/ChatSidebar.css.js +150 -0
  61. package/chat/ChatSidebar/ChatSidebar.js +230 -0
  62. package/chat/ChatSidebar/ChatSidebar.tpl.js +18 -0
  63. package/chat/ChatSidebar/constants.js +11 -0
  64. package/chat/ChatSidebarItem/ChatSidebarItem.css.js +445 -0
  65. package/chat/ChatSidebarItem/ChatSidebarItem.js +304 -0
  66. package/chat/ChatTranscript/ChatTranscript.css.js +90 -0
  67. package/chat/ChatTranscript/ChatTranscript.js +244 -0
  68. package/chat/chat-context.js +123 -0
  69. package/chat/message-model.js +156 -0
  70. package/cli.js +20 -0
  71. package/control/Button/Button.css.js +93 -0
  72. package/control/Button/Button.js +78 -0
  73. package/control/Button/Button.tpl.js +3 -0
  74. package/control/Field/Field.css.js +91 -0
  75. package/control/Field/Field.js +17 -0
  76. package/control/Field/Field.tpl.js +3 -0
  77. package/core/Connection.js +47 -0
  78. package/core/Editor.js +449 -0
  79. package/core/Frame.js +33 -0
  80. package/core/GraphMermaid.js +348 -0
  81. package/core/GraphText.js +228 -0
  82. package/core/Node.js +145 -0
  83. package/core/Portal.js +106 -0
  84. package/core/Socket.js +187 -0
  85. package/core/SubgraphNode.js +121 -0
  86. package/core/base-path.js +55 -0
  87. package/core/dom-utils.js +14 -0
  88. package/core/index.js +18 -0
  89. package/core/local-cache.js +26 -0
  90. package/core/state-sync.js +227 -0
  91. package/custom-elements.json +6380 -0
  92. package/discover.js +240 -0
  93. package/display/Badge/Badge.css.js +44 -0
  94. package/display/Badge/Badge.js +17 -0
  95. package/display/Badge/Badge.tpl.js +3 -0
  96. package/display/Banner/Banner.css.js +61 -0
  97. package/display/Banner/Banner.js +17 -0
  98. package/display/Banner/Banner.tpl.js +3 -0
  99. package/display/CodeBlock/CodeBlock.css.js +194 -0
  100. package/display/CodeBlock/CodeBlock.js +220 -0
  101. package/display/CodeBlock/CodeBlock.tpl.js +11 -0
  102. package/display/DataTable/DataTable.css.js +101 -0
  103. package/display/DataTable/DataTable.js +136 -0
  104. package/display/DataTable/DataTable.tpl.js +13 -0
  105. package/display/EmptyState/EmptyState.css.js +33 -0
  106. package/display/EmptyState/EmptyState.js +17 -0
  107. package/display/EmptyState/EmptyState.tpl.js +3 -0
  108. package/display/EventFeed/EventFeed.css.js +145 -0
  109. package/display/EventFeed/EventFeed.js +64 -0
  110. package/display/EventFeed/EventFeed.tpl.js +14 -0
  111. package/display/EventFeed/EventFeedItem.js +116 -0
  112. package/display/EventFeed/EventFeedItem.tpl.js +22 -0
  113. package/display/LoadingOverlay/LoadingOverlay.css.js +91 -0
  114. package/display/LoadingOverlay/LoadingOverlay.js +48 -0
  115. package/display/LoadingOverlay/LoadingOverlay.tpl.js +12 -0
  116. package/display/Metric/Metric.css.js +60 -0
  117. package/display/Metric/Metric.js +17 -0
  118. package/display/Metric/Metric.tpl.js +6 -0
  119. package/display/OutputGraphPreview/OutputGraphPreview.css.js +122 -0
  120. package/display/OutputGraphPreview/OutputGraphPreview.js +89 -0
  121. package/display/OutputGraphPreview/OutputGraphPreview.tpl.js +13 -0
  122. package/display/OutputListPreview/OutputListPreview.css.js +109 -0
  123. package/display/OutputListPreview/OutputListPreview.js +77 -0
  124. package/display/OutputListPreview/OutputListPreview.tpl.js +13 -0
  125. package/display/SourceEditor/SourceEditor.css.js +39 -0
  126. package/display/SourceEditor/SourceEditor.js +129 -0
  127. package/display/SourceEditor/SourceEditor.tpl.js +10 -0
  128. package/display/SourceViewer/SourceViewer.css.js +80 -0
  129. package/display/SourceViewer/SourceViewer.js +418 -0
  130. package/display/SourceViewer/SourceViewer.tpl.js +17 -0
  131. package/display/StatusRibbon/StatusRibbon.css.js +73 -0
  132. package/display/StatusRibbon/StatusRibbon.js +87 -0
  133. package/display/StatusRibbon/StatusRibbon.tpl.js +7 -0
  134. package/display/event-feed-adapter.js +72 -0
  135. package/display/format-utils.js +29 -0
  136. package/display/highlight.js +659 -0
  137. package/display/icons.js +37 -0
  138. package/display/markdown-formatter.js +60 -0
  139. package/display/network-approval-page.js +487 -0
  140. package/display/output-preview.js +261 -0
  141. package/effects/CellBg/CellBg.css.js +33 -0
  142. package/effects/CellBg/CellBg.js +410 -0
  143. package/effects/CellBg/CellBg.tpl.js +5 -0
  144. package/graph/canvas-adapter.js +223 -0
  145. package/graph/graph-algorithms.js +31 -0
  146. package/graph/index.js +46 -0
  147. package/graph/model.js +176 -0
  148. package/graph/project-graph-build.js +66 -0
  149. package/graph/project-graph-metadata.js +253 -0
  150. package/graph/project-package.js +128 -0
  151. package/graph/project-runtime.js +116 -0
  152. package/graph/project-transaction.js +284 -0
  153. package/graph/skeleton-utils.js +84 -0
  154. package/graph/theme-contract.js +36 -0
  155. package/graph/transaction-parser.js +56 -0
  156. package/icons/MaterialSymbols.js +69 -0
  157. package/icons/material-symbols-outlined-400.ttf +0 -0
  158. package/icons/material-symbols.css +24 -0
  159. package/index.js +95 -0
  160. package/inspector/InspectorPanel/InspectorPanel.css.js +375 -0
  161. package/inspector/InspectorPanel/InspectorPanel.js +368 -0
  162. package/inspector/InspectorPanel/InspectorPanel.tpl.js +96 -0
  163. package/inspector/TemplatePreview/TemplatePreview.css.js +104 -0
  164. package/inspector/TemplatePreview/TemplatePreview.js +145 -0
  165. package/inspector/TemplatePreview/TemplatePreview.tpl.js +33 -0
  166. package/interactions/ConnectFlow.js +304 -0
  167. package/interactions/Drag.js +104 -0
  168. package/interactions/Selector.js +133 -0
  169. package/interactions/SnapGrid.js +66 -0
  170. package/interactions/Zoom.js +139 -0
  171. package/layout/ActionZone/ActionZone.css.js +88 -0
  172. package/layout/ActionZone/ActionZone.js +261 -0
  173. package/layout/ActionZone/ActionZone.tpl.js +11 -0
  174. package/layout/CrossLayoutPortalBridge/CrossLayoutPortalBridge.js +255 -0
  175. package/layout/Layout/Layout.css.js +91 -0
  176. package/layout/Layout/Layout.js +637 -0
  177. package/layout/Layout/Layout.tpl.js +27 -0
  178. package/layout/LayoutNode/LayoutNode.css.js +302 -0
  179. package/layout/LayoutNode/LayoutNode.js +509 -0
  180. package/layout/LayoutNode/LayoutNode.tpl.js +39 -0
  181. package/layout/LayoutPreview/LayoutPreview.css.js +46 -0
  182. package/layout/LayoutPreview/LayoutPreview.js +102 -0
  183. package/layout/LayoutPreview/LayoutPreview.tpl.js +6 -0
  184. package/layout/LayoutRouter/LayoutRouter.js +274 -0
  185. package/layout/LayoutRouter/SectionRegistry.js +135 -0
  186. package/layout/LayoutRouter/routerSync.js +250 -0
  187. package/layout/LayoutSidebar/LayoutSidebar.css.js +411 -0
  188. package/layout/LayoutSidebar/LayoutSidebar.js +368 -0
  189. package/layout/LayoutSidebar/LayoutSidebar.tpl.js +26 -0
  190. package/layout/LayoutSidebar/SidebarSection.css.js +20 -0
  191. package/layout/LayoutSidebar/SidebarSection.js +184 -0
  192. package/layout/LayoutSidebar/SidebarSection.tpl.js +22 -0
  193. package/layout/LayoutTree.js +373 -0
  194. package/layout/PanelMenu/PanelMenu.css.js +43 -0
  195. package/layout/PanelMenu/PanelMenu.js +95 -0
  196. package/layout/PanelMenu/PanelMenu.tpl.js +17 -0
  197. package/layout/ProjectTabs/ProjectTabs.css.js +188 -0
  198. package/layout/ProjectTabs/ProjectTabs.js +77 -0
  199. package/layout/ProjectTabs/ProjectTabs.tpl.js +15 -0
  200. package/layout/index.js +40 -0
  201. package/list/ListDetailShell/ListDetailShell.css.js +128 -0
  202. package/list/ListDetailShell/ListDetailShell.js +72 -0
  203. package/list/ListDetailShell/ListDetailShell.tpl.js +36 -0
  204. package/list/ListItem/ListItem.css.js +111 -0
  205. package/list/ListItem/ListItem.js +66 -0
  206. package/list/ListItem/ListItem.tpl.js +18 -0
  207. package/locale/index.js +503 -0
  208. package/manifest/component-registry.js +2446 -0
  209. package/manifest/graph-schema.js +285 -0
  210. package/manifest/index.js +6 -0
  211. package/manifest/project-schema-catalog.js +246 -0
  212. package/manifest/rule-catalog.js +201 -0
  213. package/manifest/theme-catalog.js +2149 -0
  214. package/manifest/ui-schema-catalog.js +334 -0
  215. package/menu/ContextMenu/ContextMenu.css.js +61 -0
  216. package/menu/ContextMenu/ContextMenu.js +82 -0
  217. package/menu/ContextMenu/ContextMenu.tpl.js +19 -0
  218. package/navigation/QuickOpen/QuickOpen.css.js +92 -0
  219. package/navigation/QuickOpen/QuickOpen.js +185 -0
  220. package/navigation/QuickOpen/QuickOpen.tpl.js +15 -0
  221. package/navigation/quick-open-utils.js +101 -0
  222. package/node/CtrlItem/CtrlItem.css.js +41 -0
  223. package/node/CtrlItem/CtrlItem.js +24 -0
  224. package/node/CtrlItem/CtrlItem.tpl.js +17 -0
  225. package/node/GraphFrame/GraphFrame.css.js +66 -0
  226. package/node/GraphFrame/GraphFrame.js +32 -0
  227. package/node/GraphFrame/GraphFrame.tpl.js +13 -0
  228. package/node/GraphNode/GraphNode.css.js +815 -0
  229. package/node/GraphNode/GraphNode.js +173 -0
  230. package/node/GraphNode/GraphNode.tpl.js +33 -0
  231. package/node/NodeCallout/NodeCallout.css.js +91 -0
  232. package/node/NodeCallout/NodeCallout.js +281 -0
  233. package/node/NodeCallout/NodeCallout.tpl.js +8 -0
  234. package/node/NodeSocket/NodeSocket.css.js +68 -0
  235. package/node/NodeSocket/NodeSocket.js +26 -0
  236. package/node/NodeSocket/NodeSocket.tpl.js +7 -0
  237. package/node/PortItem/PortItem.css.js +93 -0
  238. package/node/PortItem/PortItem.js +87 -0
  239. package/node/PortItem/PortItem.tpl.js +10 -0
  240. package/package.json +165 -0
  241. package/palette/PaletteBrowser/PaletteBrowser.css.js +143 -0
  242. package/palette/PaletteBrowser/PaletteBrowser.js +152 -0
  243. package/palette/PaletteBrowser/PaletteBrowser.tpl.js +23 -0
  244. package/plugins/History.js +408 -0
  245. package/plugins/Readonly.js +60 -0
  246. package/rules/symbiote-3x.json +170 -0
  247. package/schemas/component-descriptor-v1.json +91 -0
  248. package/schemas/component-descriptor-v2.json +145 -0
  249. package/schemas/graph-model-v1.json +179 -0
  250. package/schemas/graph-v1.json +91 -0
  251. package/schemas/project-package-v1.json +102 -0
  252. package/schemas/project-transaction-v1.json +114 -0
  253. package/schemas/runtime-ui-v1.json +80 -0
  254. package/schemas/theme-rule-block-v1.json +73 -0
  255. package/shapes/CircleShape.js +79 -0
  256. package/shapes/CommentShape.js +35 -0
  257. package/shapes/DiamondShape.js +130 -0
  258. package/shapes/NodeShape.js +79 -0
  259. package/shapes/PillShape.js +91 -0
  260. package/shapes/RectShape.js +84 -0
  261. package/shapes/SVGShape.js +525 -0
  262. package/shapes/index.js +63 -0
  263. package/surface/Card/Card.css.js +57 -0
  264. package/surface/Card/Card.js +17 -0
  265. package/surface/Card/Card.tpl.js +3 -0
  266. package/themes/Palette.js +30 -0
  267. package/themes/Skin.js +113 -0
  268. package/themes/Theme.js +82 -0
  269. package/themes/carbon.js +135 -0
  270. package/themes/dark.js +140 -0
  271. package/themes/default-dark.js +714 -0
  272. package/themes/default-provider.css +635 -0
  273. package/themes/default-provider.js +718 -0
  274. package/themes/ebook.js +136 -0
  275. package/themes/grey.js +137 -0
  276. package/themes/light.js +139 -0
  277. package/themes/neon.js +138 -0
  278. package/themes/pcb.js +273 -0
  279. package/themes/synthwave.js +138 -0
  280. package/tokens/base.json +29 -0
  281. package/tokens/themes/carbon.json +11 -0
  282. package/tokens/themes/dark.json +12 -0
  283. package/tokens/themes/default-dark.json +1543 -0
  284. package/tokens/themes/default-provider.json +1543 -0
  285. package/tokens/themes/ebook.json +11 -0
  286. package/tokens/themes/grey.json +11 -0
  287. package/tokens/themes/light.json +12 -0
  288. package/tokens/themes/neon.json +11 -0
  289. package/tokens/themes/pcb.json +11 -0
  290. package/tokens/themes/synthwave.json +11 -0
  291. package/toolbar/QuickToolbar/QuickToolbar.css.js +152 -0
  292. package/toolbar/QuickToolbar/QuickToolbar.js +529 -0
  293. package/toolbar/QuickToolbar/QuickToolbar.tpl.js +34 -0
  294. package/tree/TreePanel/TreePanel.css.js +112 -0
  295. package/tree/TreePanel/TreePanel.js +147 -0
  296. package/tree/TreePanel/TreePanel.tpl.js +18 -0
  297. package/tree/TreeView/TreeView.css.js +122 -0
  298. package/tree/TreeView/TreeView.js +365 -0
  299. package/tree/TreeView/TreeView.tpl.js +10 -0
  300. package/ui/dialogs.js +221 -0
  301. package/ui/host-adapters.js +114 -0
  302. package/ui/index.js +660 -0
  303. package/ui/locale.js +50 -0
  304. package/ui/overlay-stack.js +89 -0
  305. package/ui/shared-styles.js +26 -0
  306. package/webmcp.js +37 -0
  307. package/xr/deep-graph.js +646 -0
  308. package/xr/emulation.js +198 -0
  309. package/xr/gesture.js +228 -0
  310. package/xr/html-canvas-renderer.js +472 -0
  311. package/xr/index.js +15 -0
  312. package/xr/layout-projection.js +1046 -0
  313. package/xr/panel-frame.js +128 -0
  314. package/xr/panel-host.js +267 -0
  315. package/xr/pointer.js +258 -0
  316. package/xr/scene-controller.js +242 -0
  317. package/xr/spatial-scene.js +212 -0
  318. package/xr/theme-bridge.js +105 -0
  319. package/xr/three-webxr-adapter.js +3439 -0
  320. package/xr/webgl-layer-renderer.js +419 -0
  321. package/xr/webxr.js +679 -0
  322. package/xr/workbench.js +516 -0
package/xr/webxr.js ADDED
@@ -0,0 +1,679 @@
1
+ export const WEBXR_RENDERER_NAME = 'webxr';
2
+
3
+ export const WEBXR_MODES = Object.freeze({
4
+ inline: 'inline',
5
+ immersiveVr: 'immersive-vr',
6
+ immersiveAr: 'immersive-ar',
7
+ });
8
+
9
+ export const WEBXR_FEATURES = Object.freeze({
10
+ local: 'local',
11
+ localFloor: 'local-floor',
12
+ boundedFloor: 'bounded-floor',
13
+ viewer: 'viewer',
14
+ domOverlay: 'dom-overlay',
15
+ hitTest: 'hit-test',
16
+ anchors: 'anchors',
17
+ handTracking: 'hand-tracking',
18
+ layers: 'layers',
19
+ });
20
+
21
+ export const WEBXR_RENDERER = Object.freeze({
22
+ name: WEBXR_RENDERER_NAME,
23
+ status: 'experimental',
24
+ specifier: 'symbiote-ui/xr',
25
+ description: 'WebXR capability, session, render-loop, and input adapter primitives for spatial host applications.',
26
+ modes: Object.values(WEBXR_MODES),
27
+ fallback: 'dom-canvas',
28
+ capabilities: [
29
+ 'immersive-vr',
30
+ 'immersive-ar',
31
+ 'inline-xr',
32
+ 'xr-layout-projection',
33
+ 'xr-spatial-scene',
34
+ 'xr-scene-controller',
35
+ 'xr-session-controller',
36
+ 'xr-session-options-normalization',
37
+ 'xr-controller-input-normalization',
38
+ 'xr-primary-input-source',
39
+ 'xr-theme-bridge',
40
+ 'xr-panel-host',
41
+ 'xr-panel-frame',
42
+ 'xr-panel-window-affordances',
43
+ 'xr-dom-panel-workbench',
44
+ 'xr-content-viewport',
45
+ 'xr-texture-quality-policy',
46
+ 'xr-texture-quality-diagnostics',
47
+ 'xr-scene-quality-diagnostics',
48
+ 'xr-visual-test-summary',
49
+ 'xr-pose-comfort-diagnostics',
50
+ 'xr-pose-comfort-adjustment',
51
+ 'xr-facing-diagnostics',
52
+ 'xr-facing-adjustment',
53
+ 'xr-html-in-canvas-renderer',
54
+ 'xr-texture-debug-mode',
55
+ 'xr-texture-gate-diagnostics',
56
+ 'xr-pointer-normalization',
57
+ 'xr-content-pointer-target',
58
+ 'xr-panel-gesture',
59
+ 'xr-layout-transaction',
60
+ 'xr-deep-graph-scene',
61
+ 'xr-deep-graph-focus',
62
+ 'xr-room-aware-placement-contract',
63
+ 'xr-voice-command-contract',
64
+ 'xr-scene-diagnostics',
65
+ 'xr-readiness-diagnostics',
66
+ 'xr-webgl-layer-target',
67
+ 'xr-webgl-layer-panel-renderer',
68
+ 'xr-three-webxr-adapter',
69
+ 'xr-session-runtime-diagnostics',
70
+ 'xr-session-options-diagnostics',
71
+ 'xr-stable-diagnostic-client-id',
72
+ 'xr-diagnostic-url-redaction',
73
+ 'xr-webgl-layer-size',
74
+ 'xr-launch-gate-diagnostics',
75
+ 'xr-emulated-test-runtime',
76
+ 'iwer-emulation-runtime',
77
+ 'dom-overlay-optional',
78
+ 'webgl-layer',
79
+ 'feature-detected-fallback',
80
+ ],
81
+ features: Object.values(WEBXR_FEATURES),
82
+ });
83
+
84
+ const DEFAULT_XR_DIAGNOSTIC_STORAGE_KEY = 'symbiote-node:xr-diagnostic-client-id';
85
+ const SENSITIVE_URL_PARAM_PATTERN = /token|secret|password|cookie|authorization|auth|key|session|code/i;
86
+
87
+ function sanitizeDiagnosticIdPart(value, fallback = 'client') {
88
+ let out = String(value || '').replace(/[^a-zA-Z0-9_.:-]/g, '').slice(0, 80);
89
+ return out || fallback;
90
+ }
91
+
92
+ function createFallbackDiagnosticId(prefix, target) {
93
+ let random = typeof target?.crypto?.randomUUID === 'function'
94
+ ? target.crypto.randomUUID()
95
+ : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
96
+ return `${sanitizeDiagnosticIdPart(prefix, 'xr')}-${sanitizeDiagnosticIdPart(random, 'client')}`;
97
+ }
98
+
99
+ export function createStableXRDiagnosticClientId(options = {}) {
100
+ let target = options.globalThis || globalThis;
101
+ let prefix = sanitizeDiagnosticIdPart(options.prefix || 'xr');
102
+ let storageKey = String(options.storageKey || `${DEFAULT_XR_DIAGNOSTIC_STORAGE_KEY}:${prefix}`);
103
+ let storage = options.storage || target?.sessionStorage || target?.localStorage || null;
104
+ let existing = options.existingId || null;
105
+
106
+ try {
107
+ existing = existing || storage?.getItem?.(storageKey) || null;
108
+ } catch {
109
+ existing = null;
110
+ }
111
+
112
+ let id = existing
113
+ ? `${prefix}-${sanitizeDiagnosticIdPart(String(existing).replace(new RegExp(`^${prefix}-`), ''), 'client')}`
114
+ : createFallbackDiagnosticId(prefix, target);
115
+
116
+ try {
117
+ storage?.setItem?.(storageKey, id);
118
+ } catch {
119
+ // Storage can be unavailable in strict privacy modes; the returned id still scopes this page lifetime.
120
+ }
121
+
122
+ return {
123
+ version: 'xr-diagnostic-client-id-v1',
124
+ id,
125
+ storageKey,
126
+ persisted: Boolean(storage),
127
+ };
128
+ }
129
+
130
+ export function redactXRDiagnosticUrl(value, options = {}) {
131
+ if (!value) return '';
132
+ let base = options.base || 'https://symbiote.invalid/';
133
+ let redactHash = options.redactHash !== false;
134
+ try {
135
+ let url = new URL(String(value), base);
136
+ for (let key of [...url.searchParams.keys()]) {
137
+ if (SENSITIVE_URL_PARAM_PATTERN.test(key)) {
138
+ url.searchParams.set(key, '[redacted]');
139
+ }
140
+ }
141
+ if (redactHash && url.hash) {
142
+ let hash = url.hash.slice(1);
143
+ if (hash.includes('?')) {
144
+ let [route, query] = hash.split('?');
145
+ let params = new URLSearchParams(query);
146
+ for (let key of [...params.keys()]) {
147
+ if (SENSITIVE_URL_PARAM_PATTERN.test(key)) {
148
+ params.set(key, '[redacted]');
149
+ }
150
+ }
151
+ url.hash = `${route}?${params.toString()}`;
152
+ } else if (SENSITIVE_URL_PARAM_PATTERN.test(hash)) {
153
+ url.hash = '#[redacted]';
154
+ }
155
+ }
156
+ let out = url.href;
157
+ return String(value).startsWith('http') ? out : `${url.pathname}${url.search}${url.hash}`;
158
+ } catch {
159
+ return String(value)
160
+ .replace(/([?&][^=]*(?:token|secret|password|cookie|authorization|auth|key|session|code)[^=]*=)[^&#]*/gi, '$1[redacted]')
161
+ .slice(0, 300);
162
+ }
163
+ }
164
+
165
+ function hasFn(source, name) {
166
+ return typeof source?.[name] === 'function';
167
+ }
168
+
169
+ function getXR(target) {
170
+ return target?.navigator?.xr || null;
171
+ }
172
+
173
+ async function sessionSupported(xr, mode) {
174
+ if (!hasFn(xr, 'isSessionSupported')) return false;
175
+ try {
176
+ return Boolean(await xr.isSessionSupported(mode));
177
+ } catch {
178
+ return false;
179
+ }
180
+ }
181
+
182
+ export async function getWebXRSupport(target = globalThis) {
183
+ let xr = getXR(target);
184
+ let secureContext = target?.isSecureContext !== false;
185
+ let modes = {
186
+ inline: await sessionSupported(xr, WEBXR_MODES.inline),
187
+ immersiveVr: await sessionSupported(xr, WEBXR_MODES.immersiveVr),
188
+ immersiveAr: await sessionSupported(xr, WEBXR_MODES.immersiveAr),
189
+ };
190
+
191
+ return {
192
+ name: WEBXR_RENDERER_NAME,
193
+ status: 'experimental',
194
+ supported: Boolean(xr) && Object.values(modes).some(Boolean),
195
+ fallback: WEBXR_RENDERER.fallback,
196
+ modes,
197
+ apis: {
198
+ secureContext,
199
+ navigatorXrAvailable: Boolean(xr),
200
+ isSessionSupportedAvailable: hasFn(xr, 'isSessionSupported'),
201
+ requestSessionAvailable: hasFn(xr, 'requestSession'),
202
+ XRWebGLLayerAvailable: typeof target?.XRWebGLLayer === 'function',
203
+ XRReferenceSpaceAvailable: typeof target?.XRReferenceSpace === 'function',
204
+ XRFrameAvailable: typeof target?.XRFrame === 'function',
205
+ XRInputSourceAvailable: typeof target?.XRInputSource === 'function',
206
+ },
207
+ features: WEBXR_RENDERER.features,
208
+ };
209
+ }
210
+
211
+ export function createWebXRLaunchRecommendation(support = {}, options = {}) {
212
+ let preferredMode = options.preferredMode || null;
213
+ let allowInline = options.allowInline === true;
214
+ let modes = support.modes || {};
215
+ let supportsMode = (mode) => {
216
+ if (modes[mode]) return true;
217
+ if (mode === WEBXR_MODES.immersiveAr) return Boolean(modes.immersiveAr);
218
+ if (mode === WEBXR_MODES.immersiveVr) return Boolean(modes.immersiveVr);
219
+ if (mode === WEBXR_MODES.inline) return Boolean(modes.inline);
220
+ return false;
221
+ };
222
+ let mode = null;
223
+ if (preferredMode && supportsMode(preferredMode)) {
224
+ mode = preferredMode;
225
+ } else if (supportsMode(WEBXR_MODES.immersiveAr)) {
226
+ mode = WEBXR_MODES.immersiveAr;
227
+ } else if (supportsMode(WEBXR_MODES.immersiveVr)) {
228
+ mode = WEBXR_MODES.immersiveVr;
229
+ } else if (allowInline && supportsMode(WEBXR_MODES.inline)) {
230
+ mode = WEBXR_MODES.inline;
231
+ }
232
+
233
+ let secureContext = support.apis?.secureContext !== false;
234
+ let navigatorXrAvailable = Boolean(support.apis?.navigatorXrAvailable);
235
+ let requestSessionAvailable = Boolean(support.apis?.requestSessionAvailable);
236
+ let canLaunch = Boolean(mode && secureContext && navigatorXrAvailable && requestSessionAvailable);
237
+ let reason = 'ready';
238
+ if (!secureContext) {
239
+ reason = 'insecure-context';
240
+ } else if (!navigatorXrAvailable) {
241
+ reason = 'navigator-xr-unavailable';
242
+ } else if (!requestSessionAvailable) {
243
+ reason = 'request-session-unavailable';
244
+ } else if (!mode) {
245
+ reason = 'no-immersive-mode';
246
+ }
247
+
248
+ return {
249
+ version: 'webxr-launch-recommendation-v1',
250
+ canLaunch,
251
+ mode,
252
+ reason,
253
+ secureContext,
254
+ navigatorXrAvailable,
255
+ requestSessionAvailable,
256
+ modes: { ...modes },
257
+ };
258
+ }
259
+
260
+ function normalizeLaunchGateTexture(texture = null) {
261
+ if (!texture || typeof texture !== 'object') {
262
+ return {
263
+ strict: false,
264
+ total: 0,
265
+ ready: 0,
266
+ blocked: false,
267
+ reason: null,
268
+ stage: null,
269
+ requiredApi: [],
270
+ };
271
+ }
272
+ return {
273
+ strict: texture.strict === true,
274
+ total: Number.isFinite(Number(texture.total)) ? Number(texture.total) : 0,
275
+ ready: Number.isFinite(Number(texture.ready)) ? Number(texture.ready) : 0,
276
+ blocked: texture.blocked === true,
277
+ reason: texture.reason || null,
278
+ stage: texture.stage || null,
279
+ requiredApi: Array.isArray(texture.requiredApi) ? [...texture.requiredApi] : [],
280
+ };
281
+ }
282
+
283
+ function normalizeUserActivationState(userActivation = null) {
284
+ if (!userActivation || typeof userActivation !== 'object') {
285
+ return {
286
+ available: false,
287
+ isActive: null,
288
+ hasBeenActive: null,
289
+ };
290
+ }
291
+ return {
292
+ available: true,
293
+ isActive: userActivation.isActive == null ? null : Boolean(userActivation.isActive),
294
+ hasBeenActive: userActivation.hasBeenActive == null ? null : Boolean(userActivation.hasBeenActive),
295
+ };
296
+ }
297
+
298
+ export function createWebXRLaunchGateSummary(support = {}, options = {}) {
299
+ let launch = options.launch || createWebXRLaunchRecommendation(support, options);
300
+ let texture = normalizeLaunchGateTexture(options.texture);
301
+ let userActivation = normalizeUserActivationState(options.userActivation);
302
+ let requireUserActivation = options.requireUserActivation === true;
303
+ let activationOk = !requireUserActivation ||
304
+ userActivation.isActive === true ||
305
+ userActivation.available !== true ||
306
+ userActivation.isActive == null;
307
+ let probeMode = options.probeMode || options.selectedMode || launch.mode || null;
308
+ let canProbeMode = options.allowUnsupportedModeProbe === true &&
309
+ launch.canLaunch !== true &&
310
+ launch.reason === 'no-immersive-mode' &&
311
+ launch.navigatorXrAvailable === true &&
312
+ launch.requestSessionAvailable === true &&
313
+ Boolean(probeMode) &&
314
+ probeMode !== WEBXR_MODES.inline;
315
+ let checks = [
316
+ {
317
+ id: 'webxr-launch',
318
+ ok: launch.canLaunch === true || canProbeMode,
319
+ reason: launch.canLaunch || canProbeMode ? null : launch.reason || 'webxr-launch-blocked',
320
+ probe: canProbeMode,
321
+ probeMode: canProbeMode ? probeMode : null,
322
+ },
323
+ {
324
+ id: 'strict-texture',
325
+ ok: texture.blocked !== true,
326
+ reason: texture.blocked ? texture.reason || 'strict-texture-blocked' : null,
327
+ stage: texture.stage,
328
+ requiredApi: texture.requiredApi,
329
+ },
330
+ {
331
+ id: 'user-activation',
332
+ ok: activationOk,
333
+ reason: activationOk ? null : 'user-activation-required',
334
+ required: requireUserActivation,
335
+ available: userActivation.available,
336
+ isActive: userActivation.isActive,
337
+ hasBeenActive: userActivation.hasBeenActive,
338
+ },
339
+ ];
340
+ let blockingChecks = checks.filter((check) => !check.ok);
341
+ return {
342
+ version: 'webxr-launch-gate-summary-v1',
343
+ canStart: blockingChecks.length === 0,
344
+ blocked: blockingChecks.length > 0,
345
+ reason: blockingChecks[0]?.reason || 'ready',
346
+ mode: launch.mode || probeMode || null,
347
+ canProbeMode,
348
+ checks,
349
+ blockingChecks,
350
+ launch,
351
+ texture,
352
+ userActivation,
353
+ };
354
+ }
355
+
356
+ export function createXRReadinessSummary(input = {}) {
357
+ let launchGate = input.launchGate || null;
358
+ let htmlCanvas = input.htmlCanvas || null;
359
+ let texture = input.texture || null;
360
+ let sceneQuality = input.sceneQuality || null;
361
+ let sessionHealth = input.sessionHealth || input.health || null;
362
+ let checks = [
363
+ {
364
+ id: 'launch',
365
+ ok: launchGate ? launchGate.blocked !== true && launchGate.canStart !== false : false,
366
+ status: launchGate ? launchGate.blocked ? 'blocked' : 'ready' : 'missing',
367
+ reason: launchGate?.reason || (launchGate ? null : 'missing-launch-gate'),
368
+ },
369
+ {
370
+ id: 'html-canvas',
371
+ ok: htmlCanvas ? htmlCanvas.supported === true : false,
372
+ status: htmlCanvas?.availability || 'missing',
373
+ reason: htmlCanvas?.supported ? null : htmlCanvas?.recommendation || 'missing-html-canvas-diagnostics',
374
+ },
375
+ {
376
+ id: 'texture',
377
+ ok: texture ? texture.blocked !== true : false,
378
+ status: texture ? texture.blocked ? 'blocked' : 'ready' : 'missing',
379
+ reason: texture?.reason || (texture ? null : 'missing-texture-gate'),
380
+ },
381
+ {
382
+ id: 'scene-quality',
383
+ ok: sceneQuality ? sceneQuality.status !== 'warning' : false,
384
+ status: sceneQuality?.status || 'missing',
385
+ reason: sceneQuality?.status === 'warning' ? 'scene-quality-warning' : sceneQuality ? null : 'missing-scene-quality',
386
+ },
387
+ {
388
+ id: 'session-health',
389
+ ok: !sessionHealth || sessionHealth.status === 'healthy' || sessionHealth.status === 'waiting',
390
+ status: sessionHealth?.status || 'not-started',
391
+ reason: sessionHealth?.reason || null,
392
+ },
393
+ ];
394
+ let blockingChecks = checks.filter((check) => !check.ok);
395
+ let firstBlocking = blockingChecks[0] || null;
396
+ let running = sessionHealth?.status === 'healthy' || input.sessionActive === true;
397
+ return {
398
+ version: 'xr-readiness-summary-v1',
399
+ ready: blockingChecks.length === 0,
400
+ running,
401
+ status: running ? 'running' : blockingChecks.length ? 'blocked' : 'ready',
402
+ reason: firstBlocking?.reason || 'ready',
403
+ checks,
404
+ blockingChecks,
405
+ mode: launchGate?.mode || input.mode || null,
406
+ };
407
+ }
408
+
409
+ export function normalizeWebXRSessionOptions(options = {}) {
410
+ let requiredFeatures = [...new Set(options.requiredFeatures || [])];
411
+ let optionalFeatures = [...new Set(options.optionalFeatures || [
412
+ WEBXR_FEATURES.localFloor,
413
+ WEBXR_FEATURES.boundedFloor,
414
+ WEBXR_FEATURES.handTracking,
415
+ WEBXR_FEATURES.hitTest,
416
+ WEBXR_FEATURES.domOverlay,
417
+ WEBXR_FEATURES.layers,
418
+ ])];
419
+ let normalized = { requiredFeatures, optionalFeatures };
420
+ if (options.domOverlayRoot) {
421
+ normalized.domOverlay = { root: options.domOverlayRoot };
422
+ }
423
+ return normalized;
424
+ }
425
+
426
+ export async function requestWebXRSession(target = globalThis, mode = WEBXR_MODES.immersiveVr, options = {}) {
427
+ let xr = getXR(target);
428
+ if (!hasFn(xr, 'requestSession')) {
429
+ return { ok: false, reason: 'unsupported', session: null };
430
+ }
431
+ try {
432
+ let session = await xr.requestSession(mode, normalizeWebXRSessionOptions(options));
433
+ return { ok: true, mode, session };
434
+ } catch (error) {
435
+ return {
436
+ ok: false,
437
+ mode,
438
+ reason: error?.name || 'request-failed',
439
+ message: error?.message || '',
440
+ session: null,
441
+ };
442
+ }
443
+ }
444
+
445
+ export async function endWebXRSession(session) {
446
+ if (!hasFn(session, 'end')) return false;
447
+ await session.end();
448
+ return true;
449
+ }
450
+
451
+ export function createWebXRLayer(target = globalThis, session, gl, options = {}) {
452
+ if (typeof target?.XRWebGLLayer !== 'function') {
453
+ return { ok: false, reason: 'unsupported', layer: null };
454
+ }
455
+ if (!session || !gl) {
456
+ return { ok: false, reason: 'missing-session-or-context', layer: null };
457
+ }
458
+ try {
459
+ return { ok: true, layer: new target.XRWebGLLayer(session, gl, options) };
460
+ } catch (error) {
461
+ return {
462
+ ok: false,
463
+ reason: error?.name || 'layer-failed',
464
+ message: error?.message || '',
465
+ layer: null,
466
+ };
467
+ }
468
+ }
469
+
470
+ function createWebGLCanvas(documentRef, options = {}) {
471
+ if (!documentRef?.createElement) return null;
472
+ let size = createXRWebGLLayerSize(options);
473
+ let canvas = documentRef.createElement('canvas');
474
+ canvas.className = options.className || 'sn-xr-layer-canvas';
475
+ canvas.width = size.width;
476
+ canvas.height = size.height;
477
+ canvas.setAttribute?.('aria-hidden', 'true');
478
+ return canvas;
479
+ }
480
+
481
+ export function createXRWebGLLayerSize(options = {}) {
482
+ let panelCount = Number(options.panelCount || options.panels?.length || 0);
483
+ let width = Number(options.width || options.baseWidth || 1280);
484
+ let height = Number(options.height || options.baseHeight || 720);
485
+ let pixelRatio = Number(options.pixelRatio || 1);
486
+ let maxWidth = Number(options.maxWidth || 2048);
487
+ let maxHeight = Number(options.maxHeight || 2048);
488
+
489
+ if (!options.width && !options.height && panelCount > 4) {
490
+ let scale = Math.min(1.5, Math.sqrt(panelCount / 4));
491
+ width *= scale;
492
+ height *= scale;
493
+ }
494
+
495
+ width = Math.max(1, Math.min(maxWidth, Math.round(width * Math.max(0.5, pixelRatio))));
496
+ height = Math.max(1, Math.min(maxHeight, Math.round(height * Math.max(0.5, pixelRatio))));
497
+
498
+ return {
499
+ version: 'xr-webgl-layer-size-v1',
500
+ width,
501
+ height,
502
+ pixelRatio,
503
+ panelCount,
504
+ source: options.width || options.height ? 'explicit' : 'provider-default',
505
+ };
506
+ }
507
+
508
+ function getXRCompatibleWebGLContext(canvas, options = {}) {
509
+ if (!canvas?.getContext) return null;
510
+ let contextOptions = {
511
+ xrCompatible: true,
512
+ alpha: options.alpha !== false,
513
+ antialias: options.antialias !== false,
514
+ preserveDrawingBuffer: options.preserveDrawingBuffer === true,
515
+ };
516
+ let preferred = Array.isArray(options.contextTypes) && options.contextTypes.length
517
+ ? options.contextTypes
518
+ : ['webgl2', 'webgl'];
519
+ for (let contextType of preferred) {
520
+ let gl = canvas.getContext(contextType, contextOptions);
521
+ if (gl) {
522
+ gl.contextType = gl.contextType || contextType;
523
+ return gl;
524
+ }
525
+ }
526
+ return null;
527
+ }
528
+
529
+ export async function createXRWebGLLayerTarget(options = {}) {
530
+ let documentRef = options.document || options.globalThis?.document || globalThis?.document;
531
+ let hostElement = options.hostElement || null;
532
+ let existingCanvas = options.canvas || null;
533
+ let canvas = existingCanvas || createWebGLCanvas(documentRef, options);
534
+ if (!canvas) {
535
+ return {
536
+ ok: false,
537
+ reason: 'missing-document',
538
+ canvas: null,
539
+ gl: null,
540
+ contextType: null,
541
+ reused: false,
542
+ };
543
+ }
544
+ let appendCanvas = () => {
545
+ if (!existingCanvas && hostElement?.append && !canvas.isConnected) {
546
+ hostElement.append(canvas);
547
+ }
548
+ };
549
+ appendCanvas();
550
+
551
+ let gl = getXRCompatibleWebGLContext(canvas, options);
552
+ let recreated = false;
553
+ if (!gl && !existingCanvas && documentRef?.createElement) {
554
+ canvas.remove?.();
555
+ canvas = createWebGLCanvas(documentRef, options);
556
+ appendCanvas();
557
+ gl = getXRCompatibleWebGLContext(canvas, options);
558
+ recreated = true;
559
+ }
560
+
561
+ if (gl?.makeXRCompatible) {
562
+ await gl.makeXRCompatible();
563
+ }
564
+
565
+ return {
566
+ ok: Boolean(gl),
567
+ reason: gl ? null : 'missing-webgl-context',
568
+ canvas,
569
+ gl,
570
+ contextType: gl?.contextType || null,
571
+ reused: Boolean(existingCanvas),
572
+ recreated,
573
+ width: Number(canvas.width || 0),
574
+ height: Number(canvas.height || 0),
575
+ };
576
+ }
577
+
578
+ export function syncWebXRCanvas(canvas, gl, session) {
579
+ let layer = session?.renderState?.baseLayer || null;
580
+ if (!canvas || !layer) return false;
581
+ let width = Number(layer.framebufferWidth || 0);
582
+ let height = Number(layer.framebufferHeight || 0);
583
+ if (!width || !height) return false;
584
+ canvas.width = width;
585
+ canvas.height = height;
586
+ if (hasFn(gl, 'bindFramebuffer')) {
587
+ gl.bindFramebuffer(gl.FRAMEBUFFER, layer.framebuffer);
588
+ }
589
+ return true;
590
+ }
591
+
592
+ export function createWebXRRenderLoop(session, callback) {
593
+ let active = true;
594
+ let handle = null;
595
+ let loop = (time, frame) => {
596
+ if (!active) return;
597
+ callback?.(time, frame, session);
598
+ if (active && hasFn(session, 'requestAnimationFrame')) {
599
+ handle = session.requestAnimationFrame(loop);
600
+ }
601
+ };
602
+ if (hasFn(session, 'requestAnimationFrame')) {
603
+ handle = session.requestAnimationFrame(loop);
604
+ }
605
+ return {
606
+ stop() {
607
+ active = false;
608
+ if (handle != null && hasFn(session, 'cancelAnimationFrame')) {
609
+ session.cancelAnimationFrame(handle);
610
+ }
611
+ },
612
+ };
613
+ }
614
+
615
+ export async function requestWebXRReferenceSpace(session, type = WEBXR_FEATURES.localFloor) {
616
+ if (!hasFn(session, 'requestReferenceSpace')) {
617
+ return { ok: false, reason: 'unsupported', referenceSpace: null };
618
+ }
619
+ try {
620
+ return {
621
+ ok: true,
622
+ type,
623
+ referenceSpace: await session.requestReferenceSpace(type),
624
+ };
625
+ } catch (error) {
626
+ return {
627
+ ok: false,
628
+ type,
629
+ reason: error?.name || 'reference-space-failed',
630
+ message: error?.message || '',
631
+ referenceSpace: null,
632
+ };
633
+ }
634
+ }
635
+
636
+ export function listWebXRInputSources(session) {
637
+ return Array.from(session?.inputSources || []);
638
+ }
639
+
640
+ export function createWebXRAdapter(options = {}) {
641
+ let target = options.globalThis || globalThis;
642
+ let session = null;
643
+
644
+ return {
645
+ ...WEBXR_RENDERER,
646
+ async getSupport() {
647
+ return getWebXRSupport(target);
648
+ },
649
+ async isSupported(mode = WEBXR_MODES.immersiveVr) {
650
+ let xr = getXR(target);
651
+ return sessionSupported(xr, mode);
652
+ },
653
+ async requestSession(mode = WEBXR_MODES.immersiveVr, sessionOptions = {}) {
654
+ let result = await requestWebXRSession(target, mode, sessionOptions);
655
+ if (result.ok) session = result.session;
656
+ return result;
657
+ },
658
+ async endSession() {
659
+ let ended = await endWebXRSession(session);
660
+ session = null;
661
+ return ended;
662
+ },
663
+ getSession() {
664
+ return session;
665
+ },
666
+ requestReferenceSpace(type) {
667
+ return requestWebXRReferenceSpace(session, type);
668
+ },
669
+ createLayer(gl, layerOptions) {
670
+ return createWebXRLayer(target, session, gl, layerOptions);
671
+ },
672
+ createRenderLoop(callback) {
673
+ return createWebXRRenderLoop(session, callback);
674
+ },
675
+ getInputSources() {
676
+ return listWebXRInputSources(session);
677
+ },
678
+ };
679
+ }