@volter/sdk 0.0.0-stage → 0.5.204

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 (523) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +20 -0
  3. package/README.md +38 -3
  4. package/package.json +510 -4
  5. package/src/account.ts +210 -0
  6. package/src/chrome.ts +88 -0
  7. package/src/client.ts +1646 -0
  8. package/src/commands.ts +66 -0
  9. package/src/contributions.ts +619 -0
  10. package/src/css-numeric-style.ts +97 -0
  11. package/src/document-probe.ts +282 -0
  12. package/src/editor-view.ts +225 -0
  13. package/src/extension.ts +40 -0
  14. package/src/generations.ts +178 -0
  15. package/src/host.ts +1157 -0
  16. package/src/http-transport.browser.ts +14 -0
  17. package/src/http-transport.node.ts +19 -0
  18. package/src/index.ts +131 -0
  19. package/src/kit/CapabilityCoverageSection.tsx +185 -0
  20. package/src/kit/account-client.ts +333 -0
  21. package/src/kit/action-registry.ts +317 -0
  22. package/src/kit/active-product.ts +76 -0
  23. package/src/kit/active-project.ts +155 -0
  24. package/src/kit/adapter-editor-config.ts +25 -0
  25. package/src/kit/adapter-module.ts +7 -0
  26. package/src/kit/adapter-observation.ts +49 -0
  27. package/src/kit/animation/animation-clock.ts +479 -0
  28. package/src/kit/animation/stage-transport.ts +385 -0
  29. package/src/kit/api/assets.ts +365 -0
  30. package/src/kit/api/project-open.ts +355 -0
  31. package/src/kit/api/project-source.ts +180 -0
  32. package/src/kit/api/project-state.ts +110 -0
  33. package/src/kit/api/relay.ts +270 -0
  34. package/src/kit/api/themes.ts +45 -0
  35. package/src/kit/api-asset-library-wire.ts +45 -0
  36. package/src/kit/api-base.ts +10 -0
  37. package/src/kit/api-build.ts +99 -0
  38. package/src/kit/api-git-wire.ts +56 -0
  39. package/src/kit/api-logs.ts +92 -0
  40. package/src/kit/api-project-identity.ts +74 -0
  41. package/src/kit/api-settings.ts +36 -0
  42. package/src/kit/api-worktrees.ts +205 -0
  43. package/src/kit/asset-capabilities.ts +344 -0
  44. package/src/kit/asset-compare-core.ts +171 -0
  45. package/src/kit/asset-editor-context.tsx +101 -0
  46. package/src/kit/asset-events.ts +96 -0
  47. package/src/kit/asset-inspector-actions.ts +87 -0
  48. package/src/kit/asset-selection-viewer-registry.ts +113 -0
  49. package/src/kit/asset-selection.ts +146 -0
  50. package/src/kit/asset-thumbnails.ts +25 -0
  51. package/src/kit/asset-viewers.ts +115 -0
  52. package/src/kit/asset-workflow/asset-import-jobs.ts +106 -0
  53. package/src/kit/asset-workflow/asset-ledger-backend.ts +126 -0
  54. package/src/kit/asset-workflow/asset-ledger.ts +156 -0
  55. package/src/kit/asset-workflow/asset-materialization-report.ts +140 -0
  56. package/src/kit/asset-workflow/asset-pack-manifest.ts +320 -0
  57. package/src/kit/asset-workflow/asset-types.ts +142 -0
  58. package/src/kit/asset-workflow/audio-preview-player.ts +193 -0
  59. package/src/kit/asset-workflow/audio-waveform.ts +22 -0
  60. package/src/kit/asset-workflow/cloud-asset-client.ts +263 -0
  61. package/src/kit/asset-workflow/hosted-asset-materialization.ts +236 -0
  62. package/src/kit/asset-workflow/image-view-scale.ts +31 -0
  63. package/src/kit/asset-workflow/import-contract.ts +124 -0
  64. package/src/kit/asset-workflow/ledger-write-lock.ts +244 -0
  65. package/src/kit/asset-workflow/pixi-spritesheet.ts +197 -0
  66. package/src/kit/asset-workflow/preview-resource-lifetime.ts +44 -0
  67. package/src/kit/asset-workflow/project-asset-commands.ts +20 -0
  68. package/src/kit/asset-workflow/project-content.ts +288 -0
  69. package/src/kit/asset-workflow/project-source-index.ts +545 -0
  70. package/src/kit/asset-workflow/thumbnail-system.ts +256 -0
  71. package/src/kit/authoring/active-adapter.ts +200 -0
  72. package/src/kit/authoring/active-systems.ts +422 -0
  73. package/src/kit/authoring/adapter-key.ts +18 -0
  74. package/src/kit/authoring/authoring-asset-url.ts +27 -0
  75. package/src/kit/authoring/bootstrap-state.ts +49 -0
  76. package/src/kit/authoring/boundary-authoring-adapter.ts +189 -0
  77. package/src/kit/authoring/canvas-scene-guides.ts +84 -0
  78. package/src/kit/authoring/composite-authoring-adapter.ts +2109 -0
  79. package/src/kit/authoring/consumer-actions.ts +531 -0
  80. package/src/kit/authoring/design-time-layers.ts +852 -0
  81. package/src/kit/authoring/design-time-mount-registry.ts +244 -0
  82. package/src/kit/authoring/edit-mode-authoring.ts +637 -0
  83. package/src/kit/authoring/empty-project-authoring.ts +22 -0
  84. package/src/kit/authoring/instance-source-menu.ts +135 -0
  85. package/src/kit/authoring/layered-pick.ts +185 -0
  86. package/src/kit/authoring/mounted-root-subjects.ts +146 -0
  87. package/src/kit/authoring/no-authoring-adapter.ts +59 -0
  88. package/src/kit/authoring/object3d-document-persistence.ts +122 -0
  89. package/src/kit/authoring/panel-authoring.ts +121 -0
  90. package/src/kit/authoring/project-authoring-session.ts +105 -0
  91. package/src/kit/authoring/provenance.ts +99 -0
  92. package/src/kit/authoring/react-canvas-navigation.ts +259 -0
  93. package/src/kit/authoring/react-design-canvas-style.ts +20 -0
  94. package/src/kit/authoring/react-story-board.ts +917 -0
  95. package/src/kit/authoring/selection-scope.ts +195 -0
  96. package/src/kit/authoring/shell-document-ops.ts +169 -0
  97. package/src/kit/authoring/story-board-chrome-fit.ts +107 -0
  98. package/src/kit/authoring/story-board-presentation.ts +111 -0
  99. package/src/kit/authoring/three-root.ts +67 -0
  100. package/src/kit/authoring/viewport-tool-context.ts +73 -0
  101. package/src/kit/authoring/viewport-tool-owner.ts +38 -0
  102. package/src/kit/authoring/world-session-state.ts +101 -0
  103. package/src/kit/authoring-seam-evidence.ts +300 -0
  104. package/src/kit/availability-tick.ts +66 -0
  105. package/src/kit/bitmap-label.ts +120 -0
  106. package/src/kit/boot-routing.ts +392 -0
  107. package/src/kit/breakpoint-state.ts +43 -0
  108. package/src/kit/build-identity.ts +16 -0
  109. package/src/kit/bytes-codec.ts +62 -0
  110. package/src/kit/cancellation-reason.ts +58 -0
  111. package/src/kit/canvas-frames.ts +88 -0
  112. package/src/kit/capture-camera-pose.ts +77 -0
  113. package/src/kit/capture-size.ts +88 -0
  114. package/src/kit/chrome-registry.ts +159 -0
  115. package/src/kit/chrome-slot-registry.ts +91 -0
  116. package/src/kit/collaboration-client.ts +264 -0
  117. package/src/kit/collaboration-presence.ts +41 -0
  118. package/src/kit/command-dispatch.ts +19 -0
  119. package/src/kit/command-listener.ts +2182 -0
  120. package/src/kit/command-registry.ts +71 -0
  121. package/src/kit/component-board-registry.ts +205 -0
  122. package/src/kit/component-states-registry.ts +199 -0
  123. package/src/kit/components/AlignToolbar.tsx +204 -0
  124. package/src/kit/components/ApplicationMenus.tsx +372 -0
  125. package/src/kit/components/AssetEditorShell.tsx +216 -0
  126. package/src/kit/components/AssetInspectorToolSection.tsx +124 -0
  127. package/src/kit/components/BoardRulers.tsx +354 -0
  128. package/src/kit/components/CanvasAddNodeDialogs.tsx +529 -0
  129. package/src/kit/components/CanvasSceneViewport.tsx +1195 -0
  130. package/src/kit/components/ChromeSlot.tsx +20 -0
  131. package/src/kit/components/CodeView.tsx +470 -0
  132. package/src/kit/components/CompactInspectorShell.tsx +39 -0
  133. package/src/kit/components/ConsolePanel.tsx +273 -0
  134. package/src/kit/components/GameplaySessionTimeline.tsx +295 -0
  135. package/src/kit/components/InspectionProjection.tsx +932 -0
  136. package/src/kit/components/Inspector.tsx +270 -0
  137. package/src/kit/components/InspectorCanvasPreview.tsx +35 -0
  138. package/src/kit/components/InspectorFieldsSection.tsx +290 -0
  139. package/src/kit/components/InspectorStoriesSection.tsx +92 -0
  140. package/src/kit/components/InspectorToolSection.tsx +96 -0
  141. package/src/kit/components/InspectorTransformSection.tsx +245 -0
  142. package/src/kit/components/LightExplorerPanel.tsx +433 -0
  143. package/src/kit/components/MediaProperties.tsx +145 -0
  144. package/src/kit/components/ProjectHeader.tsx +328 -0
  145. package/src/kit/components/ReactCanvasControls.tsx +358 -0
  146. package/src/kit/components/RootSelectionOverlay.tsx +3688 -0
  147. package/src/kit/components/RootTextEditor.tsx +79 -0
  148. package/src/kit/components/SaveStatus.tsx +70 -0
  149. package/src/kit/components/SurfaceCrashBoundary.tsx +105 -0
  150. package/src/kit/components/SurfaceStateOverlay.tsx +24 -0
  151. package/src/kit/components/ToolContributionSurfaces.tsx +49 -0
  152. package/src/kit/components/ToolHost.tsx +380 -0
  153. package/src/kit/components/Toolbar.tsx +811 -0
  154. package/src/kit/components/TransientHint.tsx +44 -0
  155. package/src/kit/components/VersionControlSection.tsx +470 -0
  156. package/src/kit/components/ViewportOverlaysMenu.tsx +177 -0
  157. package/src/kit/components/VolterLogo.tsx +18 -0
  158. package/src/kit/components/WorktreeSwitcher.tsx +712 -0
  159. package/src/kit/components/account-documents.tsx +1162 -0
  160. package/src/kit/components/asset-documents.tsx +794 -0
  161. package/src/kit/components/asset-editor-persistence.ts +216 -0
  162. package/src/kit/components/asset-selection-section.tsx +545 -0
  163. package/src/kit/components/asset-thumbnails.tsx +307 -0
  164. package/src/kit/components/asset-viewers/AudioViewer.tsx +201 -0
  165. package/src/kit/components/asset-viewers/GenericJsonViewer.tsx +102 -0
  166. package/src/kit/components/asset-viewers/ImageViewer.tsx +300 -0
  167. package/src/kit/components/asset-viewers/JsonAssetDocument.tsx +98 -0
  168. package/src/kit/components/asset-viewers/OnlineAssetDetail.tsx +426 -0
  169. package/src/kit/components/asset-viewers/SourceAssetViewer.tsx +356 -0
  170. package/src/kit/components/asset-viewers/SpritesheetSpriteView.tsx +102 -0
  171. package/src/kit/components/asset-viewers/VideoViewer.tsx +101 -0
  172. package/src/kit/components/asset-viewers/shader-source.ts +144 -0
  173. package/src/kit/components/board-guides.ts +150 -0
  174. package/src/kit/components/canvas-scene-hotkeys.ts +37 -0
  175. package/src/kit/components/canvas-temporary-pivot.ts +34 -0
  176. package/src/kit/components/core-utilities.tsx +94 -0
  177. package/src/kit/components/inspector-preview-section.tsx +223 -0
  178. package/src/kit/components/inspector-revert-label.ts +20 -0
  179. package/src/kit/components/inspector-selection.ts +42 -0
  180. package/src/kit/components/inspector-stories-gating.ts +171 -0
  181. package/src/kit/components/inspector-transform-subject.ts +11 -0
  182. package/src/kit/components/inspector-transform.ts +88 -0
  183. package/src/kit/components/kind-documents.tsx +544 -0
  184. package/src/kit/components/primitives/DraftColorInput.tsx +74 -0
  185. package/src/kit/components/project-tool-documents.tsx +402 -0
  186. package/src/kit/components/scene-documents.tsx +221 -0
  187. package/src/kit/components/status-contributions.tsx +407 -0
  188. package/src/kit/components/tool-documents.tsx +302 -0
  189. package/src/kit/components/tool-schema-form.tsx +262 -0
  190. package/src/kit/components/use-after-paint.ts +41 -0
  191. package/src/kit/components/use-project-image-assets.ts +86 -0
  192. package/src/kit/components/workspace-history.ts +32 -0
  193. package/src/kit/components/world-documents.tsx +570 -0
  194. package/src/kit/components/world-overlay-gestures.ts +1939 -0
  195. package/src/kit/composite-screenshot.ts +2238 -0
  196. package/src/kit/content-entry-source-registry.ts +184 -0
  197. package/src/kit/contribution-surfaces.ts +48 -0
  198. package/src/kit/coverage/canvas-reveal.ts +192 -0
  199. package/src/kit/coverage/design-time-surfaces.ts +101 -0
  200. package/src/kit/coverage/ontology-invariants.ts +466 -0
  201. package/src/kit/coverage/session-vitals.ts +503 -0
  202. package/src/kit/crash-null-boundary.ts +36 -0
  203. package/src/kit/creation-site-edit.ts +1491 -0
  204. package/src/kit/creation-site-registry.ts +160 -0
  205. package/src/kit/delegate-harness-registry.ts +134 -0
  206. package/src/kit/document-areas.ts +70 -0
  207. package/src/kit/document-context-registry.ts +193 -0
  208. package/src/kit/document-open-registry.ts +200 -0
  209. package/src/kit/document-play-extension.ts +221 -0
  210. package/src/kit/document-preview-source.ts +20 -0
  211. package/src/kit/document-renderer-session.ts +138 -0
  212. package/src/kit/document-stage-sessions.ts +26 -0
  213. package/src/kit/document-viewports.ts +120 -0
  214. package/src/kit/editor-api.ts +46 -0
  215. package/src/kit/editor-chrome-capture.ts +136 -0
  216. package/src/kit/editor-commands.ts +176 -0
  217. package/src/kit/editor-console.ts +580 -0
  218. package/src/kit/editor-current-view.ts +56 -0
  219. package/src/kit/editor-document-probe.ts +1168 -0
  220. package/src/kit/editor-git-client.ts +115 -0
  221. package/src/kit/editor-hotkeys.ts +728 -0
  222. package/src/kit/editor-lease-view.ts +39 -0
  223. package/src/kit/editor-lease.ts +415 -0
  224. package/src/kit/editor-mode.ts +19 -0
  225. package/src/kit/editor-notifications.ts +140 -0
  226. package/src/kit/editor-presence.ts +563 -0
  227. package/src/kit/editor-presentation-activity.ts +58 -0
  228. package/src/kit/editor-presentation-notice.ts +42 -0
  229. package/src/kit/editor-runtime.tsx +147 -0
  230. package/src/kit/editor-server-response.ts +86 -0
  231. package/src/kit/editor-session-attribution.ts +85 -0
  232. package/src/kit/editor-session-mode.ts +54 -0
  233. package/src/kit/editor-state-facets.ts +74 -0
  234. package/src/kit/editor-view-presentation.ts +777 -0
  235. package/src/kit/environment-images.ts +58 -0
  236. package/src/kit/eyedropper-session.ts +60 -0
  237. package/src/kit/files/file-provider.ts +62 -0
  238. package/src/kit/files/project-files.ts +270 -0
  239. package/src/kit/finders/index.ts +137 -0
  240. package/src/kit/finders/scenes-from-entrypoint-selection.ts +387 -0
  241. package/src/kit/frame/frame-parts.ts +30 -0
  242. package/src/kit/framed-document-capture.ts +34 -0
  243. package/src/kit/game-globals-prelude.ts +143 -0
  244. package/src/kit/game-surface-defaults.ts +33 -0
  245. package/src/kit/gameplay-dom-recording.ts +318 -0
  246. package/src/kit/gameplay-export-state.ts +14 -0
  247. package/src/kit/gameplay-replay.ts +417 -0
  248. package/src/kit/gameplay-session-time.ts +9 -0
  249. package/src/kit/gameplay-sessions.ts +204 -0
  250. package/src/kit/hierarchy-component-marks.ts +298 -0
  251. package/src/kit/hierarchy-internals.ts +197 -0
  252. package/src/kit/hierarchy-kind-icon.ts +217 -0
  253. package/src/kit/hierarchy-menu-registry.ts +67 -0
  254. package/src/kit/hierarchy-node-rows.ts +307 -0
  255. package/src/kit/hierarchy-panel-view.ts +280 -0
  256. package/src/kit/hierarchy-projection.ts +76 -0
  257. package/src/kit/hierarchy-row-media.ts +45 -0
  258. package/src/kit/hierarchy-row-model.ts +308 -0
  259. package/src/kit/hierarchy-rows.ts +11 -0
  260. package/src/kit/hierarchy-walk.ts +86 -0
  261. package/src/kit/history/editor-session.ts +25 -0
  262. package/src/kit/history/history-commands.ts +147 -0
  263. package/src/kit/history/history-delegate.ts +187 -0
  264. package/src/kit/history/history-limit-notices.ts +43 -0
  265. package/src/kit/history/history-service.ts +1189 -0
  266. package/src/kit/history/persistence-coordinator.ts +35 -0
  267. package/src/kit/history/project-file-history.ts +386 -0
  268. package/src/kit/history/project-root-history-backends.ts +139 -0
  269. package/src/kit/history/resource-registry.ts +209 -0
  270. package/src/kit/history/snapshot-store.ts +103 -0
  271. package/src/kit/history/source-history-backend.ts +546 -0
  272. package/src/kit/history-types.ts +124 -0
  273. package/src/kit/hmr-registration-group.ts +67 -0
  274. package/src/kit/hmr-stable-react-context.ts +23 -0
  275. package/src/kit/hotkeys.ts +190 -0
  276. package/src/kit/inference-diagnostics.ts +69 -0
  277. package/src/kit/initial-project.ts +80 -0
  278. package/src/kit/inspection/active-subject.ts +571 -0
  279. package/src/kit/inspection/active-surface.ts +142 -0
  280. package/src/kit/inspection/compose-subject.ts +1055 -0
  281. package/src/kit/inspection/compose.ts +7 -0
  282. package/src/kit/inspection/display.ts +171 -0
  283. package/src/kit/inspection/document-subject.ts +109 -0
  284. package/src/kit/inspection/game-subject.ts +85 -0
  285. package/src/kit/inspection/null-subject.ts +119 -0
  286. package/src/kit/inspection/serialize.ts +357 -0
  287. package/src/kit/inspection/use-active-inspection.ts +180 -0
  288. package/src/kit/inspection-model.ts +542 -0
  289. package/src/kit/inspection-node-media.ts +58 -0
  290. package/src/kit/inspector-presentation.ts +203 -0
  291. package/src/kit/inspector-property-grouping.ts +64 -0
  292. package/src/kit/inspector-section-registry.ts +221 -0
  293. package/src/kit/instance-source-actions.ts +163 -0
  294. package/src/kit/js-heap.ts +71 -0
  295. package/src/kit/key-actions.ts +91 -0
  296. package/src/kit/keymap-presets.ts +428 -0
  297. package/src/kit/layout-policy.ts +31 -0
  298. package/src/kit/light-explorer-model.ts +134 -0
  299. package/src/kit/live-canvas-frame.ts +55 -0
  300. package/src/kit/live-document.ts +296 -0
  301. package/src/kit/live-gesture-lock.ts +50 -0
  302. package/src/kit/live-seam-evidence.ts +11 -0
  303. package/src/kit/live-session-registry.ts +220 -0
  304. package/src/kit/live-transition.ts +391 -0
  305. package/src/kit/manifest-project.ts +107 -0
  306. package/src/kit/module-fetch-diagnosis.ts +192 -0
  307. package/src/kit/mount-failure-report.ts +154 -0
  308. package/src/kit/native-selection-style.ts +497 -0
  309. package/src/kit/object3d-document-write-policy.ts +137 -0
  310. package/src/kit/packaged-runtime.ts +108 -0
  311. package/src/kit/palettes/maya.palette.json +57 -0
  312. package/src/kit/palettes/substance.palette.json +57 -0
  313. package/src/kit/performance-profiler.ts +367 -0
  314. package/src/kit/performance-sources.ts +69 -0
  315. package/src/kit/photograph-notice.ts +141 -0
  316. package/src/kit/play-boot-phase.ts +166 -0
  317. package/src/kit/play-camera-flight.ts +35 -0
  318. package/src/kit/png-encode.worker.ts +26 -0
  319. package/src/kit/presentation-surface.ts +248 -0
  320. package/src/kit/product-command.ts +90 -0
  321. package/src/kit/project-adapter.ts +1140 -0
  322. package/src/kit/project-asset-refresh.ts +23 -0
  323. package/src/kit/project-asset-roots.ts +68 -0
  324. package/src/kit/project-local-state.ts +151 -0
  325. package/src/kit/project-manager.ts +243 -0
  326. package/src/kit/project-module-changes.ts +201 -0
  327. package/src/kit/project-module-split.ts +270 -0
  328. package/src/kit/project-play-layers.ts +25 -0
  329. package/src/kit/project-provenance.ts +115 -0
  330. package/src/kit/project-ready.ts +42 -0
  331. package/src/kit/project-shape.ts +68 -0
  332. package/src/kit/project-tools.ts +107 -0
  333. package/src/kit/projection-types.ts +44 -0
  334. package/src/kit/readiness.ts +113 -0
  335. package/src/kit/renderer-resource-counts.ts +27 -0
  336. package/src/kit/reported-play-state.ts +90 -0
  337. package/src/kit/resolve-contributed-command.ts +14 -0
  338. package/src/kit/resolve-relative-specifier.ts +33 -0
  339. package/src/kit/retained-document-states.ts +91 -0
  340. package/src/kit/scene-document-plan.ts +320 -0
  341. package/src/kit/scene-live-open.ts +210 -0
  342. package/src/kit/scoped-game-css.ts +152 -0
  343. package/src/kit/served-url.ts +5 -0
  344. package/src/kit/session-close.ts +17 -0
  345. package/src/kit/session-tombstone.ts +127 -0
  346. package/src/kit/settings/settings-provider.ts +82 -0
  347. package/src/kit/settings-store.ts +348 -0
  348. package/src/kit/shell-document-state.ts +27 -0
  349. package/src/kit/shell-store-door.ts +45 -0
  350. package/src/kit/shell-store.ts +722 -0
  351. package/src/kit/source-conflict.ts +122 -0
  352. package/src/kit/stage-context.ts +377 -0
  353. package/src/kit/stage-invalidation.ts +25 -0
  354. package/src/kit/stage-store-registry.ts +69 -0
  355. package/src/kit/startup-failure.ts +80 -0
  356. package/src/kit/state-report-deferral.ts +73 -0
  357. package/src/kit/storage/host-files-storage.ts +97 -0
  358. package/src/kit/storage/http-storage.ts +174 -0
  359. package/src/kit/storage/index.ts +75 -0
  360. package/src/kit/storage/mem-storage.ts +158 -0
  361. package/src/kit/storage/path-lock.ts +44 -0
  362. package/src/kit/storage/paths.ts +26 -0
  363. package/src/kit/storage-types.ts +127 -0
  364. package/src/kit/stories/StoryPreviewMount.tsx +306 -0
  365. package/src/kit/stories/compose-project-stories.ts +255 -0
  366. package/src/kit/stories/prefabs-finder.ts +54 -0
  367. package/src/kit/stories/prefabs-from-stories.ts +182 -0
  368. package/src/kit/stories/project-story-regions.ts +24 -0
  369. package/src/kit/stories/story-capture.ts +579 -0
  370. package/src/kit/stories/story-declared-medium.ts +126 -0
  371. package/src/kit/stories/story-discovery.ts +176 -0
  372. package/src/kit/stories/story-dom-runtime.ts +78 -0
  373. package/src/kit/stories/story-grouping.ts +111 -0
  374. package/src/kit/stories/story-mount-turn.ts +27 -0
  375. package/src/kit/stories/story-presentation.ts +215 -0
  376. package/src/kit/stories/story-preview-component.ts +7 -0
  377. package/src/kit/stories/story-registry.ts +530 -0
  378. package/src/kit/stories-scope.ts +35 -0
  379. package/src/kit/story-document-openers.ts +36 -0
  380. package/src/kit/story-thumbnails.ts +47 -0
  381. package/src/kit/surface-keyboard.ts +101 -0
  382. package/src/kit/surface-state.ts +135 -0
  383. package/src/kit/system-seam-evidence.ts +72 -0
  384. package/src/kit/tab-census.ts +202 -0
  385. package/src/kit/tab-lifecycle-client.ts +227 -0
  386. package/src/kit/theme-library.ts +897 -0
  387. package/src/kit/theme-preference.ts +429 -0
  388. package/src/kit/three-viewport-presentation.ts +23 -0
  389. package/src/kit/tool-contribution-play.ts +74 -0
  390. package/src/kit/tool-loader.ts +1918 -0
  391. package/src/kit/transform-mode-request.ts +66 -0
  392. package/src/kit/transient-hint.ts +78 -0
  393. package/src/kit/transport-strip.tsx +174 -0
  394. package/src/kit/ui-source/adapter-region-includes.ts +238 -0
  395. package/src/kit/ui-source/file-region-resolver.ts +302 -0
  396. package/src/kit/ui-source/inspect.ts +775 -0
  397. package/src/kit/ui-source/source-write-backend.ts +605 -0
  398. package/src/kit/ui-source/tier-source-write-backend.ts +279 -0
  399. package/src/kit/user-local-state.ts +105 -0
  400. package/src/kit/viewport-activation-timings.ts +840 -0
  401. package/src/kit/viewport-editor-controls.ts +22 -0
  402. package/src/kit/viewport-presentation.ts +668 -0
  403. package/src/kit/viewport-surface-status.tsx +55 -0
  404. package/src/kit/wait-until.ts +37 -0
  405. package/src/kit/worker-call-metrics.ts +166 -0
  406. package/src/kit/workspace-areas.ts +191 -0
  407. package/src/kit/workspace-aux-commands.ts +11 -0
  408. package/src/kit/workspace-available-documents.ts +142 -0
  409. package/src/kit/workspace-core-utilities.ts +31 -0
  410. package/src/kit/workspace-document-ids.ts +59 -0
  411. package/src/kit/workspace-document-registry.ts +624 -0
  412. package/src/kit/workspace-document-restore.ts +146 -0
  413. package/src/kit/workspace-host-commands.ts +141 -0
  414. package/src/kit/workspace-persistence-gate.ts +40 -0
  415. package/src/kit/workspace-play-utilities.ts +44 -0
  416. package/src/kit/workspace-presets.ts +446 -0
  417. package/src/kit/workspace-regions.ts +276 -0
  418. package/src/kit/workspace-static-panels.ts +73 -0
  419. package/src/kit/workspace-status-registry.ts +121 -0
  420. package/src/kit/workspace-storage.ts +35 -0
  421. package/src/kit/workspace-style.ts +226 -0
  422. package/src/kit/workspace-utility-commands.ts +74 -0
  423. package/src/kit/workspace-utility-registry.ts +263 -0
  424. package/src/kit/world-adoption-event.ts +23 -0
  425. package/src/kit/world-adoption.ts +115 -0
  426. package/src/kit/world-canvas-viewport-state.ts +35 -0
  427. package/src/kit/world-document-routing.ts +104 -0
  428. package/src/kit/world-pan-state.ts +198 -0
  429. package/src/kit/write-pipe.ts +173 -0
  430. package/src/layout-arrangements.ts +5 -0
  431. package/src/layouts.tsx +108 -0
  432. package/src/looks.ts +16 -0
  433. package/src/project/output-roots.ts +73 -0
  434. package/src/project/tab-census.ts +155 -0
  435. package/src/project-tool-catalog.ts +104 -0
  436. package/src/selection.tsx +107 -0
  437. package/src/services.ts +18 -0
  438. package/src/session/build-report.ts +22 -0
  439. package/src/session/collaboration-types.ts +262 -0
  440. package/src/session/command-table.ts +327 -0
  441. package/src/session/discovery.ts +100 -0
  442. package/src/session/editor-brand.ts +48 -0
  443. package/src/session/editor-compatibility.ts +329 -0
  444. package/src/session/editor-control-lifecycle.ts +68 -0
  445. package/src/session/editor-control-protocol.ts +5 -0
  446. package/src/session/entrypoint-selection-readers.ts +66 -0
  447. package/src/session/entrypoint-selection-source.ts +120 -0
  448. package/src/session/game-css-scope.ts +30 -0
  449. package/src/session/hosted-attachment.ts +225 -0
  450. package/src/session/limited-view.ts +82 -0
  451. package/src/session/product-create.ts +24 -0
  452. package/src/session/product-locator.ts +478 -0
  453. package/src/session/project-module-url.ts +242 -0
  454. package/src/session/project-serving.ts +164 -0
  455. package/src/session/project-upgrade.ts +669 -0
  456. package/src/session/registry-format.ts +210 -0
  457. package/src/session/relative-path-guard.ts +56 -0
  458. package/src/session/scoped-game-css.ts +461 -0
  459. package/src/session/source-glob.ts +15 -0
  460. package/src/session/tool-contribution-convention.ts +123 -0
  461. package/src/session/workbench-locator.ts +712 -0
  462. package/src/session.ts +41 -0
  463. package/src/share.ts +160 -0
  464. package/src/source-analysis.ts +28 -0
  465. package/src/source-authoring.ts +439 -0
  466. package/src/tools/errors.ts +91 -0
  467. package/src/tools/provider-execution.ts +70 -0
  468. package/src/tools/registry.ts +341 -0
  469. package/src/tools/types.ts +159 -0
  470. package/src/transport.ts +100 -0
  471. package/src/types.ts +1693 -0
  472. package/src/views.ts +164 -0
  473. package/src/widgets/design-system.ts +93 -0
  474. package/src/widgets/editor-appearance.ts +151 -0
  475. package/src/widgets/editor-material.ts +83 -0
  476. package/src/widgets/icon-set-registry.ts +105 -0
  477. package/src/widgets/index.ts +71 -0
  478. package/src/widgets/inspector-widgets/AlignmentGrid.tsx +182 -0
  479. package/src/widgets/inspector-widgets/AssetSlotPicker.tsx +123 -0
  480. package/src/widgets/inspector-widgets/BorderEditor.tsx +309 -0
  481. package/src/widgets/inspector-widgets/ColorPicker.tsx +549 -0
  482. package/src/widgets/inspector-widgets/CurveEditor.tsx +359 -0
  483. package/src/widgets/inspector-widgets/FilterEditor.tsx +108 -0
  484. package/src/widgets/inspector-widgets/FontPicker.tsx +191 -0
  485. package/src/widgets/inspector-widgets/GradientEditor.tsx +623 -0
  486. package/src/widgets/inspector-widgets/ScrubbableInput.tsx +180 -0
  487. package/src/widgets/inspector-widgets/ShadowEditor.tsx +319 -0
  488. package/src/widgets/inspector-widgets/color-utils.ts +201 -0
  489. package/src/widgets/inspector-widgets/curve-utils.ts +212 -0
  490. package/src/widgets/inspector-widgets/index.ts +25 -0
  491. package/src/widgets/inspector-widgets/shared.tsx +140 -0
  492. package/src/widgets/interactive-edit-scope.ts +33 -0
  493. package/src/widgets/patterns/Dialog.tsx +140 -0
  494. package/src/widgets/patterns/Fields.tsx +44 -0
  495. package/src/widgets/patterns/List.tsx +25 -0
  496. package/src/widgets/patterns/StateSurface.tsx +40 -0
  497. package/src/widgets/patterns/Surfaces.tsx +122 -0
  498. package/src/widgets/patterns/Tabs.tsx +80 -0
  499. package/src/widgets/patterns/Toolbar.tsx +72 -0
  500. package/src/widgets/patterns/Tree.tsx +72 -0
  501. package/src/widgets/primitives/AnchoredMenu.tsx +260 -0
  502. package/src/widgets/primitives/Button.tsx +62 -0
  503. package/src/widgets/primitives/ColorInput.tsx +78 -0
  504. package/src/widgets/primitives/DraftTextInput.tsx +63 -0
  505. package/src/widgets/primitives/EditorIcon.tsx +157 -0
  506. package/src/widgets/primitives/FormControls.tsx +88 -0
  507. package/src/widgets/primitives/HoverPreview.tsx +96 -0
  508. package/src/widgets/primitives/JsonInput.tsx +113 -0
  509. package/src/widgets/primitives/Layout.tsx +100 -0
  510. package/src/widgets/primitives/Menu.tsx +161 -0
  511. package/src/widgets/primitives/NumberInput.tsx +169 -0
  512. package/src/widgets/primitives/Panel.tsx +80 -0
  513. package/src/widgets/primitives/SectionHeader.tsx +77 -0
  514. package/src/widgets/primitives/Text.tsx +54 -0
  515. package/src/widgets/primitives/ThemeRootPortal.tsx +52 -0
  516. package/src/widgets/primitives/Tooltip.tsx +204 -0
  517. package/src/widgets/primitives/Vec3Input.tsx +70 -0
  518. package/src/widgets/primitives/banner-tones.ts +32 -0
  519. package/src/widgets/primitives/clamp-to-viewport.ts +44 -0
  520. package/src/widgets/primitives/editor-icons.ts +254 -0
  521. package/src/widgets/primitives/panel-header-styles.ts +42 -0
  522. package/src/widgets/theme.ts +2841 -0
  523. package/src/widgets/z-index.ts +25 -0
@@ -0,0 +1,359 @@
1
+ /**
2
+ * CurveEditor (W1b) — SVG piecewise-bezier curve editor over the
3
+ * `CurveSegment[]` shape (`curve-utils.ts`), which is structurally the
4
+ * engine schema's `PiecewiseBezier.functions` AND three.quarks' native JSON.
5
+ *
6
+ * Deliberately generic (value curve in, curve out — zero particle coupling):
7
+ * the particle inspector's over-lifetime modules use it today; future
8
+ * consumers reuse it as-is.
9
+ *
10
+ * Interactions: drag keys (endpoints value-only, interior keys time+value),
11
+ * drag tangent handles of the selected key, double-click the plot to insert
12
+ * a key (exact de Casteljau split), Delete/Backspace or the footer × to
13
+ * remove an interior key. Y-range auto-fits to the curve with axis labels.
14
+ * Contract: `ChangeHandlers<CurveSegment[]>` — `onChange` fires live during
15
+ * a drag, `onChangeEnd` once per gesture (the caller's single undo step).
16
+ */
17
+
18
+ import { useMemo, useRef, useState } from 'react';
19
+ import { Button, NumberInput } from '../design-system';
20
+ import {
21
+ type CurveSegment,
22
+ curveKeys,
23
+ curveValueRange,
24
+ deleteKey,
25
+ moveKey,
26
+ moveTangent,
27
+ segmentEnd,
28
+ splitAt,
29
+ } from './curve-utils';
30
+ import { type ChangeHandlers, fireChange, fireEnd, THEME } from './shared';
31
+
32
+ export type { CurveBezier, CurveKey, CurveSegment } from './curve-utils';
33
+
34
+ export interface CurveEditorProps extends ChangeHandlers<CurveSegment[]> {
35
+ /** Plot height in px (default 90). */
36
+ height?: number | undefined;
37
+ /** Curve stroke color (default the theme accent). */
38
+ color?: string | undefined;
39
+ /** Root-element test id (default `curve-editor`). */
40
+ testId?: string | undefined;
41
+ }
42
+
43
+ const PAD_L = 34; // room for y-axis labels
44
+ const PAD_R = 6;
45
+ const PAD_T = 6;
46
+ const PAD_B = 14; // room for x-axis labels
47
+ const WIDTH = 260; // viewBox width — the element itself is 100% wide
48
+
49
+ function formatAxis(v: number): string {
50
+ if (Math.abs(v) >= 100) return v.toFixed(0);
51
+ if (Math.abs(v) >= 1) return String(Math.round(v * 100) / 100);
52
+ return String(Math.round(v * 1000) / 1000);
53
+ }
54
+
55
+ export function CurveEditor({
56
+ value,
57
+ onChange,
58
+ onChangeEnd,
59
+ disabled,
60
+ height = 90,
61
+ color,
62
+ testId = 'curve-editor',
63
+ }: CurveEditorProps): React.ReactElement {
64
+ const [selectedKey, setSelectedKey] = useState(0);
65
+ const svgRef = useRef<SVGSVGElement | null>(null);
66
+ // The in-flight gesture's latest curve — window-level listeners see stale
67
+ // React props, so drags accumulate against this ref, not `value`.
68
+ const dragCurve = useRef<CurveSegment[] | null>(null);
69
+
70
+ const keys = useMemo(() => curveKeys(value), [value]);
71
+
72
+ // --- plot coordinate mapping (y auto-fit with padding) ---
73
+ const range = useMemo(() => {
74
+ const { min, max } = curveValueRange(value);
75
+ if (max - min < 1e-6) return { min: min - 1, max: max + 1 };
76
+ const pad = (max - min) * 0.1;
77
+ return { min: min - pad, max: max + pad };
78
+ }, [value]);
79
+
80
+ const plotW = WIDTH - PAD_L - PAD_R;
81
+ const plotH = height - PAD_T - PAD_B;
82
+ const xOf = (t: number): number => PAD_L + t * plotW;
83
+ const yOf = (v: number): number =>
84
+ PAD_T + (1 - (v - range.min) / (range.max - range.min)) * plotH;
85
+ const tOf = (x: number): number => Math.max(0, Math.min(1, (x - PAD_L) / plotW));
86
+ const vOf = (y: number): number =>
87
+ range.min + (1 - (y - PAD_T) / plotH) * (range.max - range.min);
88
+
89
+ /** Pointer event → plot-space (t, v) using the rendered element's box. */
90
+ const plotPoint = (e: { clientX: number; clientY: number }): { t: number; v: number } => {
91
+ const rect = svgRef.current?.getBoundingClientRect();
92
+ if (!rect) return { t: 0, v: 0 };
93
+ const x = ((e.clientX - rect.left) / rect.width) * WIDTH;
94
+ const y = ((e.clientY - rect.top) / rect.height) * height;
95
+ return { t: tOf(x), v: vOf(y) };
96
+ };
97
+
98
+ // The curve path: x is linear in each segment's normalized time, so the
99
+ // plotted curve is an EXACT svg cubic with x-controls at 1/3 and 2/3.
100
+ const path = useMemo(() => {
101
+ if (value.length === 0) return '';
102
+ let d = `M ${xOf(value[0]!.start)} ${yOf(value[0]!.function.p0)}`;
103
+ for (let i = 0; i < value.length; i++) {
104
+ const s = value[i]!;
105
+ const end = segmentEnd(value, i);
106
+ const w = end - s.start;
107
+ d += ` C ${xOf(s.start + w / 3)} ${yOf(s.function.p1)}, ${xOf(s.start + (2 * w) / 3)} ${yOf(s.function.p2)}, ${xOf(end)} ${yOf(s.function.p3)}`;
108
+ }
109
+ return d;
110
+ }, [value, range, height]);
111
+
112
+ const commit = (next: CurveSegment[]): void => fireEnd({ onChange, onChangeEnd }, next);
113
+ const live = (next: CurveSegment[]): void => fireChange({ onChange }, next);
114
+
115
+ /** Shared drag loop: apply(t, v) produces the next curve from a pointer position. */
116
+ const beginDrag = (
117
+ e: React.PointerEvent,
118
+ apply: (base: CurveSegment[], t: number, v: number) => CurveSegment[],
119
+ ): void => {
120
+ if (disabled) return;
121
+ e.preventDefault();
122
+ e.stopPropagation();
123
+ dragCurve.current = value;
124
+ const onMove = (me: PointerEvent): void => {
125
+ const { t, v } = plotPoint(me);
126
+ const next = apply(dragCurve.current ?? value, t, v);
127
+ dragCurve.current = next;
128
+ live(next);
129
+ };
130
+ const onUp = (me: PointerEvent): void => {
131
+ const { t, v } = plotPoint(me);
132
+ const next = apply(dragCurve.current ?? value, t, v);
133
+ dragCurve.current = null;
134
+ commit(next);
135
+ window.removeEventListener('pointermove', onMove);
136
+ window.removeEventListener('pointerup', onUp);
137
+ };
138
+ window.addEventListener('pointermove', onMove);
139
+ window.addEventListener('pointerup', onUp);
140
+ };
141
+
142
+ const stroke = color ?? THEME.accent;
143
+ const n = value.length;
144
+ const selected = keys[selectedKey];
145
+ const canDelete = selectedKey > 0 && selectedKey < n;
146
+
147
+ // Tangent handle geometry for the selected key.
148
+ const outSeg = selectedKey < n ? value[selectedKey] : undefined;
149
+ const inSeg = selectedKey > 0 ? value[selectedKey - 1] : undefined;
150
+ const outHandle = outSeg
151
+ ? {
152
+ x: xOf(outSeg.start + (segmentEnd(value, selectedKey) - outSeg.start) / 3),
153
+ y: yOf(outSeg.function.p1),
154
+ }
155
+ : null;
156
+ const inHandle = inSeg
157
+ ? {
158
+ x: xOf(inSeg.start + ((segmentEnd(value, selectedKey - 1) - inSeg.start) * 2) / 3),
159
+ y: yOf(inSeg.function.p2),
160
+ }
161
+ : null;
162
+
163
+ const yTicks = [range.min, (range.min + range.max) / 2, range.max];
164
+
165
+ return (
166
+ <div data-testid={testId}>
167
+ <svg
168
+ ref={svgRef}
169
+ data-testid={`${testId}-plot`}
170
+ viewBox={`0 0 ${WIDTH} ${height}`}
171
+ style={{
172
+ width: '100%',
173
+ height,
174
+ display: 'block',
175
+ background: THEME.inputBg,
176
+ border: `1px solid ${THEME.border}`,
177
+ borderRadius: THEME.radiusSmall,
178
+ touchAction: 'none',
179
+ outline: 'none',
180
+ }}
181
+ // biome-ignore lint/a11y/noNoninteractiveTabindex: the plot IS the interactive surface (role=application); focus enables the Delete-key path
182
+ tabIndex={0}
183
+ role="application"
184
+ aria-label="Curve editor"
185
+ onKeyDown={(e) => {
186
+ if ((e.key === 'Delete' || e.key === 'Backspace') && canDelete && !disabled) {
187
+ e.preventDefault();
188
+ commit(deleteKey(value, selectedKey));
189
+ setSelectedKey(Math.max(0, selectedKey - 1));
190
+ }
191
+ }}
192
+ onDoubleClick={(e) => {
193
+ if (disabled) return;
194
+ const { t } = plotPoint(e);
195
+ const next = splitAt(value, t);
196
+ if (next !== value) {
197
+ commit(next);
198
+ setSelectedKey(next.findIndex((s) => Math.abs(s.start - t) < 1e-6));
199
+ }
200
+ }}
201
+ >
202
+ {/* axes + grid */}
203
+ {yTicks.map((v) => (
204
+ <g key={v}>
205
+ <line
206
+ x1={PAD_L}
207
+ x2={WIDTH - PAD_R}
208
+ y1={yOf(v)}
209
+ y2={yOf(v)}
210
+ stroke={THEME.border}
211
+ strokeWidth={0.5}
212
+ />
213
+ <text
214
+ x={PAD_L - 3}
215
+ y={yOf(v) + 2.5}
216
+ fontSize={7}
217
+ fill={THEME.textMuted}
218
+ textAnchor="end"
219
+ >
220
+ {formatAxis(v)}
221
+ </text>
222
+ </g>
223
+ ))}
224
+ {[0, 0.5, 1].map((t) => (
225
+ <text
226
+ key={t}
227
+ x={xOf(t)}
228
+ y={height - 3}
229
+ fontSize={7}
230
+ fill={THEME.textMuted}
231
+ textAnchor="middle"
232
+ >
233
+ {t}
234
+ </text>
235
+ ))}
236
+
237
+ {/* the curve */}
238
+ <path d={path} fill="none" stroke={stroke} strokeWidth={1.5} />
239
+
240
+ {/* tangent handles for the selected key */}
241
+ {selected && outHandle && (
242
+ <g>
243
+ <line
244
+ x1={xOf(selected.time)}
245
+ y1={yOf(selected.value)}
246
+ x2={outHandle.x}
247
+ y2={outHandle.y}
248
+ stroke={THEME.textMuted}
249
+ strokeDasharray="2 2"
250
+ strokeWidth={0.75}
251
+ />
252
+ <circle
253
+ data-testid={`${testId}-tangent-out`}
254
+ cx={outHandle.x}
255
+ cy={outHandle.y}
256
+ r={3}
257
+ fill={THEME.surface}
258
+ stroke={THEME.textMuted}
259
+ style={{ cursor: disabled ? 'not-allowed' : 'ns-resize' }}
260
+ onPointerDown={(e) =>
261
+ beginDrag(e, (base, _t, v) => moveTangent(base, selectedKey, 'out', v))
262
+ }
263
+ />
264
+ </g>
265
+ )}
266
+ {selected && inHandle && (
267
+ <g>
268
+ <line
269
+ x1={xOf(selected.time)}
270
+ y1={yOf(selected.value)}
271
+ x2={inHandle.x}
272
+ y2={inHandle.y}
273
+ stroke={THEME.textMuted}
274
+ strokeDasharray="2 2"
275
+ strokeWidth={0.75}
276
+ />
277
+ <circle
278
+ data-testid={`${testId}-tangent-in`}
279
+ cx={inHandle.x}
280
+ cy={inHandle.y}
281
+ r={3}
282
+ fill={THEME.surface}
283
+ stroke={THEME.textMuted}
284
+ style={{ cursor: disabled ? 'not-allowed' : 'ns-resize' }}
285
+ onPointerDown={(e) =>
286
+ beginDrag(e, (base, _t, v) => moveTangent(base, selectedKey, 'in', v))
287
+ }
288
+ />
289
+ </g>
290
+ )}
291
+
292
+ {/* keys */}
293
+ {keys.map((k, i) => (
294
+ <circle
295
+ key={i}
296
+ data-testid={`${testId}-key-${i}`}
297
+ cx={xOf(k.time)}
298
+ cy={yOf(k.value)}
299
+ r={4}
300
+ fill={i === selectedKey ? THEME.accent : THEME.surface}
301
+ stroke={i === selectedKey ? THEME.onAccent : stroke}
302
+ strokeWidth={1.25}
303
+ style={{ cursor: disabled ? 'not-allowed' : 'move' }}
304
+ onPointerDown={(e) => {
305
+ setSelectedKey(i);
306
+ beginDrag(e, (base, t, v) => moveKey(base, i, t, v));
307
+ }}
308
+ />
309
+ ))}
310
+ </svg>
311
+
312
+ {/* selected-key detail row */}
313
+ <div style={{ display: 'flex', gap: 4, alignItems: 'center', marginTop: 3 }}>
314
+ <span style={{ fontSize: 9, color: THEME.textMuted, flex: '0 0 auto' }}>
315
+ Key {selectedKey + 1}/{keys.length}
316
+ </span>
317
+ <NumberInput
318
+ label="t"
319
+ value={selected ? Math.round(selected.time * 1000) / 1000 : null}
320
+ step={0.05}
321
+ testId={`${testId}-key-time`}
322
+ onChange={(t) => {
323
+ if (selected) live(moveKey(value, selectedKey, t, selected.value));
324
+ }}
325
+ onChangeEnd={(t) => {
326
+ if (selected) commit(moveKey(value, selectedKey, t, selected.value));
327
+ }}
328
+ />
329
+ <NumberInput
330
+ label="v"
331
+ value={selected ? Math.round(selected.value * 1000) / 1000 : null}
332
+ step={0.05}
333
+ testId={`${testId}-key-value`}
334
+ onChange={(v) => {
335
+ if (selected) live(moveKey(value, selectedKey, selected.time, v));
336
+ }}
337
+ onChangeEnd={(v) => {
338
+ if (selected) commit(moveKey(value, selectedKey, selected.time, v));
339
+ }}
340
+ />
341
+ <Button
342
+ type="button"
343
+ variant="ghost"
344
+ size="compact"
345
+ data-testid={`${testId}-delete-key`}
346
+ disabled={!canDelete || disabled === true}
347
+ aria-label="Delete curve key"
348
+ title={canDelete ? 'Delete key' : 'Endpoint keys cannot be deleted'}
349
+ onClick={() => {
350
+ commit(deleteKey(value, selectedKey));
351
+ setSelectedKey(Math.max(0, selectedKey - 1));
352
+ }}
353
+ >
354
+ ×
355
+ </Button>
356
+ </div>
357
+ </div>
358
+ );
359
+ }
@@ -0,0 +1,108 @@
1
+ /**
2
+ * FilterEditor — `filter`/`backdrop-filter` function sliders (blur/
3
+ * brightness/contrast/saturate/grayscale/hue-rotate), add/remove-by-slider
4
+ * (each function resets to its identity default when dragged back to it —
5
+ * matching the reference's "omit default-valued functions from the composed
6
+ * string" behavior) (spec 27 §5 C1). Ported from `visual-edit/inspector.tsx`'s
7
+ * `FilterEditor`/`FILTER_DEFS` (:1530-1620); the reference's expand/collapse
8
+ * chrome is left to the calling SECTION (Effects) — this widget renders its
9
+ * sliders directly given a value, matching this kit's "widgets are pure,
10
+ * sections own layout/disclosure" split.
11
+ */
12
+
13
+ import { ScrubbableInput } from './ScrubbableInput';
14
+ import { type ChangeHandlers, fireChange, fireEnd, THEME } from './shared';
15
+
16
+ interface FilterDef {
17
+ name: string;
18
+ unit: string;
19
+ min: number;
20
+ max: number;
21
+ step: number;
22
+ default: number;
23
+ }
24
+
25
+ const FILTER_DEFS: FilterDef[] = [
26
+ { name: 'blur', unit: 'px', min: 0, max: 50, step: 0.5, default: 0 },
27
+ { name: 'brightness', unit: '%', min: 0, max: 300, step: 1, default: 100 },
28
+ { name: 'contrast', unit: '%', min: 0, max: 300, step: 1, default: 100 },
29
+ { name: 'saturate', unit: '%', min: 0, max: 300, step: 1, default: 100 },
30
+ { name: 'grayscale', unit: '%', min: 0, max: 100, step: 1, default: 0 },
31
+ { name: 'hue-rotate', unit: 'deg', min: 0, max: 360, step: 1, default: 0 },
32
+ ];
33
+
34
+ export interface FilterFunc {
35
+ name: string;
36
+ value: number;
37
+ }
38
+
39
+ export function parseFilterFunctions(filter: string): FilterFunc[] {
40
+ if (!filter || filter === 'none') {
41
+ return FILTER_DEFS.map((d) => ({ name: d.name, value: d.default }));
42
+ }
43
+ return FILTER_DEFS.map((def) => {
44
+ const regex = new RegExp(`${def.name}\\(([\\d.]+)${def.unit}?\\)`);
45
+ const m = filter.match(regex);
46
+ return { name: def.name, value: m?.[1] ? Number.parseFloat(m[1]) : def.default };
47
+ });
48
+ }
49
+
50
+ export function composeFilter(funcs: FilterFunc[]): string {
51
+ const parts: string[] = [];
52
+ for (let i = 0; i < funcs.length; i++) {
53
+ const f = funcs[i];
54
+ const def = FILTER_DEFS[i];
55
+ if (f && def && f.value !== def.default) parts.push(`${f.name}(${f.value}${def.unit})`);
56
+ }
57
+ return parts.length ? parts.join(' ') : 'none';
58
+ }
59
+
60
+ export interface FilterEditorProps extends ChangeHandlers<FilterFunc[]> {
61
+ /** Cosmetic only — "Filter" vs "Backdrop Filter" label for the caller's section. */
62
+ label?: string | undefined;
63
+ /** Root-element test id. Defaults to the stable `filter-editor`; a node with
64
+ * BOTH a `filter` and a `backdropFilter` row renders two of these, so the
65
+ * inspector passes a per-row id to keep the roots distinct (spec 27 §5 C2, S1). */
66
+ testId?: string | undefined;
67
+ }
68
+
69
+ export function FilterEditor({
70
+ value,
71
+ onChange,
72
+ onChangeEnd,
73
+ disabled,
74
+ label = 'Filter',
75
+ testId = 'filter-editor',
76
+ }: FilterEditorProps): React.ReactElement {
77
+ const apply = (index: number, v: number, commit: boolean): void => {
78
+ const next = value.map((f, i) => (i === index ? { ...f, value: v } : f));
79
+ if (commit) fireEnd({ onChange, onChangeEnd }, next);
80
+ else fireChange({ onChange }, next);
81
+ };
82
+
83
+ return (
84
+ <div data-testid={testId}>
85
+ <div style={{ fontSize: 9, color: THEME.textMuted, marginBottom: 4 }}>{label}</div>
86
+ {value.map((f, i) => {
87
+ const def = FILTER_DEFS[i];
88
+ if (!def) return null;
89
+ return (
90
+ <div key={f.name} data-testid={`filter-row-${f.name}`} style={{ marginBottom: 3 }}>
91
+ <ScrubbableInput
92
+ testId={`filter-${f.name}`}
93
+ label={f.name.replace('hue-rotate', 'hue')}
94
+ value={f.value}
95
+ unit={def.unit}
96
+ min={def.min}
97
+ max={def.max}
98
+ step={def.step}
99
+ disabled={disabled}
100
+ onChange={(v) => apply(i, v, false)}
101
+ onChangeEnd={(v) => apply(i, v, true)}
102
+ />
103
+ </div>
104
+ );
105
+ })}
106
+ </div>
107
+ );
108
+ }
@@ -0,0 +1,191 @@
1
+ import { Button, EditorPopover, TextInput } from '../design-system';
2
+ /**
3
+ * FontPicker — a searchable, windowed (virtualized-by-hand, no new dep) font
4
+ * list (spec 27 §5 C1). Ported from `visual-edit/inspector.tsx`'s
5
+ * `FontPicker` (:1958-2093); the reference fetched fonts async through its
6
+ * `ParentBridge.getAvailableFonts()` (an iframe-bridge RPC this editor has no
7
+ * equivalent of) — here `fonts` is passed in directly by the caller, wired
8
+ * at C2 to the editor's OWN font source, `ui-source/inspect.ts:
9
+ * getAvailableFonts()` (browser `document.fonts` + the web-safe fallback
10
+ * list, already merged/sorted there — no re-implementation needed).
11
+ */
12
+
13
+ import { useEffect, useMemo, useRef, useState } from 'react';
14
+ import { DisclosureIcon } from '../design-system';
15
+ import { type ChangeHandlers, THEME } from './shared';
16
+
17
+ const ITEM_HEIGHT = 28;
18
+ const MAX_VISIBLE = 10;
19
+
20
+ export interface FontPickerProps extends ChangeHandlers<string> {
21
+ /** The available font families — wire to `getAvailableFonts()` at C2. */
22
+ fonts: readonly string[];
23
+ /** Root-element test id. Defaults to the stable `font-picker`; a node with a
24
+ * fontFamily on BOTH the style row and a component prop renders two, so the
25
+ * inspector passes a per-row id to keep the roots distinct (spec 27 §5 C2, S1). */
26
+ testId?: string | undefined;
27
+ }
28
+
29
+ export function FontPicker({
30
+ value,
31
+ onChange,
32
+ disabled,
33
+ fonts,
34
+ testId = 'font-picker',
35
+ }: FontPickerProps): React.ReactElement {
36
+ const [open, setOpen] = useState(false);
37
+ const [search, setSearch] = useState('');
38
+ const [scrollTop, setScrollTop] = useState(0);
39
+ const containerRef = useRef<HTMLDivElement>(null);
40
+ const searchRef = useRef<HTMLInputElement>(null);
41
+
42
+ useEffect(() => {
43
+ if (open) searchRef.current?.focus();
44
+ }, [open]);
45
+
46
+ useEffect(() => {
47
+ if (!open) return;
48
+ const handler = (e: MouseEvent): void => {
49
+ if (containerRef.current && !containerRef.current.contains(e.target as Node)) setOpen(false);
50
+ };
51
+ document.addEventListener('mousedown', handler);
52
+ return () => document.removeEventListener('mousedown', handler);
53
+ }, [open]);
54
+
55
+ useEffect(() => {
56
+ if (!open) return;
57
+ const handler = (e: KeyboardEvent): void => {
58
+ if (e.key === 'Escape') setOpen(false);
59
+ };
60
+ document.addEventListener('keydown', handler);
61
+ return () => document.removeEventListener('keydown', handler);
62
+ }, [open]);
63
+
64
+ const filtered = useMemo(() => {
65
+ if (!search) return fonts;
66
+ const q = search.toLowerCase();
67
+ return fonts.filter((f) => f.toLowerCase().includes(q));
68
+ }, [fonts, search]);
69
+
70
+ const totalHeight = filtered.length * ITEM_HEIGHT;
71
+ const startIndex = Math.floor(scrollTop / ITEM_HEIGHT);
72
+ const endIndex = Math.min(filtered.length, startIndex + MAX_VISIBLE + 2);
73
+ const visible = filtered.slice(startIndex, endIndex);
74
+
75
+ const select = (font: string): void => {
76
+ onChange(font);
77
+ setOpen(false);
78
+ setSearch('');
79
+ };
80
+
81
+ const displayValue = value.replace(/^["']|["']$/g, '');
82
+
83
+ return (
84
+ <div ref={containerRef} data-testid={testId} style={{ position: 'relative', flex: 1 }}>
85
+ <Button
86
+ type="button"
87
+ variant="secondary"
88
+ className="volter-field-trigger"
89
+ /* This trigger opens a listbox popover and never said so: the ARIA was
90
+ missing, which is both an a11y defect and — since the widget classes
91
+ landed — what decides whether it paints as a menu well or a
92
+ pushbutton (`theme.css`, the `wcol_menu` rule). */
93
+ aria-haspopup="listbox"
94
+ aria-expanded={open}
95
+ disabled={disabled}
96
+ data-testid="font-picker-input"
97
+ onClick={() => {
98
+ if (!disabled) setOpen((v) => !v);
99
+ }}
100
+ >
101
+ <span style={{ overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>
102
+ {displayValue || '—'}
103
+ </span>
104
+ <DisclosureIcon direction="down" tone="muted" style={{ marginLeft: 4 }} />
105
+ </Button>
106
+ {open && (
107
+ <EditorPopover
108
+ data-testid="font-picker-dropdown"
109
+ style={{
110
+ position: 'absolute',
111
+ top: '100%',
112
+ left: 0,
113
+ right: 0,
114
+ zIndex: 'var(--volter-z-dropdown)',
115
+ marginTop: 2,
116
+ }}
117
+ >
118
+ <div style={{ padding: 4 }}>
119
+ <TextInput
120
+ ref={searchRef}
121
+ type="text"
122
+ data-testid="font-picker-search"
123
+ value={search}
124
+ onChange={(e) => {
125
+ setSearch(e.target.value);
126
+ setScrollTop(0);
127
+ }}
128
+ placeholder="Search fonts…"
129
+ data-density="compact"
130
+ style={{
131
+ width: '100%',
132
+ boxSizing: 'border-box',
133
+ }}
134
+ />
135
+ </div>
136
+ <div
137
+ data-testid="font-picker-list"
138
+ onScroll={(e) => setScrollTop((e.target as HTMLDivElement).scrollTop)}
139
+ style={{ maxHeight: MAX_VISIBLE * ITEM_HEIGHT, overflowY: 'auto' }}
140
+ >
141
+ <div style={{ height: totalHeight, position: 'relative' }}>
142
+ {visible.map((font, i) => {
143
+ const actualIndex = startIndex + i;
144
+ const isActive = font.toLowerCase() === displayValue.toLowerCase();
145
+ return (
146
+ <div
147
+ key={font}
148
+ data-testid={`font-picker-option-${font}`}
149
+ onClick={() => select(font)}
150
+ style={{
151
+ position: 'absolute',
152
+ top: actualIndex * ITEM_HEIGHT,
153
+ left: 0,
154
+ right: 0,
155
+ height: ITEM_HEIGHT,
156
+ display: 'flex',
157
+ alignItems: 'center',
158
+ padding: '0 8px',
159
+ cursor: 'pointer',
160
+ fontSize: 12,
161
+ background: isActive ? THEME.accent : 'transparent',
162
+ color: isActive ? THEME.onAccent : THEME.text,
163
+ }}
164
+ >
165
+ <span
166
+ style={{ overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}
167
+ >
168
+ {font}
169
+ </span>
170
+ </div>
171
+ );
172
+ })}
173
+ </div>
174
+ </div>
175
+ {filtered.length === 0 && (
176
+ <div
177
+ style={{
178
+ padding: '8px 12px',
179
+ color: THEME.textMuted,
180
+ fontSize: 10,
181
+ textAlign: 'center',
182
+ }}
183
+ >
184
+ No matching fonts
185
+ </div>
186
+ )}
187
+ </EditorPopover>
188
+ )}
189
+ </div>
190
+ );
191
+ }