@vincentt-xr/sdk 2.0.0-alpha.1 → 2.0.0-alpha.3

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 (355) hide show
  1. package/GROUNDING.md +1614 -21
  2. package/dist/{DebuggerUI-CatYc-RG.cjs → DebuggerUI-B45_Gb9d.cjs} +1 -1
  3. package/dist/{DebuggerUI-gLMKiVwJ.js → DebuggerUI-xp4bg3gH.js} +1 -1
  4. package/dist/FaceMeshRenderer-CALA4k49.js +1195 -0
  5. package/dist/FaceMeshRenderer-D4PFqsb3.cjs +155 -0
  6. package/dist/FaceRetouch-Bq2rtPlV.cjs +134 -0
  7. package/dist/FaceRetouch-DF5UsOsZ.js +551 -0
  8. package/dist/audio/AudioEngine.d.ts +3 -1
  9. package/dist/audio/AudioPlayer.d.ts +29 -0
  10. package/dist/audio/AudioPlayerLogic.d.ts +4 -0
  11. package/dist/audio/index.d.ts +2 -0
  12. package/dist/components/Axes/index.d.ts +6 -0
  13. package/dist/components/FaceMesh/FaceMeshRenderer.d.ts +17 -0
  14. package/dist/components/FaceMesh/canonical/CanonicalFaceMeshRenderer.d.ts +17 -1
  15. package/dist/components/FaceMesh/canonical/FaceMeshMaterial.d.ts +25 -0
  16. package/dist/components/FaceMesh/canonical/assets.d.ts +3 -0
  17. package/dist/components/FaceMesh/canonical/geometryGroups.d.ts +9 -0
  18. package/dist/components/FaceMesh/canonical/parseCanonicalFaceModel.d.ts +2 -0
  19. package/dist/components/FaceMesh/canonical/shaders.d.ts +2 -0
  20. package/dist/components/FaceMesh/deform.d.ts +3 -0
  21. package/dist/components/FaceMesh/index.d.ts +5 -0
  22. package/dist/components/FaceMesh/material/defaults.d.ts +70 -0
  23. package/dist/components/FaceMesh/material/index.d.ts +1 -0
  24. package/dist/components/FaceMesh/material/options.d.ts +5 -1
  25. package/dist/components/FaceMesh/material/support.d.ts +7 -2
  26. package/dist/components/FaceMesh/material/textures.d.ts +4 -0
  27. package/dist/components/FaceMesh/material/types.d.ts +2 -2
  28. package/dist/components/FaceRetouch/Background.d.ts +5 -6
  29. package/dist/components/FaceRetouch/FaceRetouch.d.ts +47 -0
  30. package/dist/components/FaceRetouch/index.d.ts +2 -8
  31. package/dist/components/FaceRetouch/landmarkMask.d.ts +0 -5
  32. package/dist/components/FaceRetouch/useFaceRetouchMask.d.ts +3 -7
  33. package/dist/components/FaceTracker/index.d.ts +5 -3
  34. package/dist/components/FaceWarp3D/FaceWarp3DHead.d.ts +1 -1
  35. package/dist/components/HandJoints2D/index.d.ts +1 -1
  36. package/dist/components/HandTracking2D/HandVisual.d.ts +1 -1
  37. package/dist/components/HandTracking2D/index.d.ts +1 -1
  38. package/dist/components/HandTracking2DController/index.d.ts +1 -1
  39. package/dist/components/HandTracking3D/index.d.ts +1 -1
  40. package/dist/components/LightObject/index.d.ts +20 -0
  41. package/dist/components/LookAt/index.d.ts +23 -0
  42. package/dist/components/MeshRenderer/index.d.ts +59 -0
  43. package/dist/components/PerspectiveCamera/index.d.ts +2 -8
  44. package/dist/components/PinToMesh/index.d.ts +47 -0
  45. package/dist/components/RenderGroupLayer/index.d.ts +6 -0
  46. package/dist/components/SceneObjectRenderer/index.d.ts +16 -0
  47. package/dist/components/Screen2D/ScreenTransformFrame.d.ts +11 -0
  48. package/dist/components/Screen2D/ScreenTransformHelpers.d.ts +19 -0
  49. package/dist/components/Screen2D/ScreenTransformInteraction.d.ts +18 -0
  50. package/dist/components/Screen2D/index.d.ts +5 -0
  51. package/dist/components/ScreenGlass/defaults.d.ts +3 -0
  52. package/dist/components/ScreenGlass/index.d.ts +5 -0
  53. package/dist/components/ScreenGlass/shaders.d.ts +2 -0
  54. package/dist/components/ScreenGlass/types.d.ts +10 -0
  55. package/dist/components/ScreenGradient/defaults.d.ts +5 -0
  56. package/dist/components/ScreenGradient/index.d.ts +5 -0
  57. package/dist/components/ScreenGradient/shaders.d.ts +2 -0
  58. package/dist/components/ScreenGradient/types.d.ts +19 -0
  59. package/dist/components/ScreenImage/ScreenImage.d.ts +4 -0
  60. package/dist/components/ScreenImage/components/DynamicTextureSync.d.ts +9 -0
  61. package/dist/components/ScreenImage/components/ScreenImageBody.d.ts +9 -0
  62. package/dist/components/ScreenImage/components/ScreenImageFrame.d.ts +9 -0
  63. package/dist/components/ScreenImage/components/ScreenImageTransformFrame.d.ts +9 -0
  64. package/dist/components/ScreenImage/fit.d.ts +52 -0
  65. package/dist/components/ScreenImage/index.d.ts +8 -87
  66. package/dist/components/ScreenImage/materials/ScreenImageBlendMaterial.d.ts +9 -0
  67. package/dist/components/ScreenImage/materials/ScreenImageMatcap.d.ts +3 -0
  68. package/dist/components/ScreenImage/source.d.ts +19 -0
  69. package/dist/components/ScreenImage/types.d.ts +37 -0
  70. package/dist/components/ScreenImage/utils/ScreenImageConstants.d.ts +9 -0
  71. package/dist/components/ScreenImage/utils/ScreenImageHelpers.d.ts +4 -0
  72. package/dist/components/ScreenShape/geometry.d.ts +5 -0
  73. package/dist/components/ScreenShape/index.d.ts +5 -0
  74. package/dist/components/ScreenShape/types.d.ts +41 -0
  75. package/dist/components/ScreenSpaceUI/ScreenTransformGuide.d.ts +15 -0
  76. package/dist/components/ScreenSpaceUI/ScreenTransformOverlayGuide.d.ts +9 -0
  77. package/dist/components/ScreenSpaceUI/index.d.ts +2 -0
  78. package/dist/components/ScreenText/components/ScreenTextBody.d.ts +2 -0
  79. package/dist/components/ScreenText/components/ScreenTextTransformFrame.d.ts +9 -0
  80. package/dist/components/ScreenText/constants.d.ts +5 -0
  81. package/dist/components/ScreenText/index.d.ts +6 -20
  82. package/dist/components/ScreenText/types.d.ts +31 -0
  83. package/dist/components/ScreenText/utils/ScreenTextHelpers.d.ts +14 -0
  84. package/dist/components/ScreenText/utils/ScreenTextMappings.d.ts +17 -0
  85. package/dist/components/SequentialRenderPasses/index.d.ts +6 -0
  86. package/dist/components/TextLabel/TextLabel.d.ts +5 -0
  87. package/dist/components/TextLabel/alignment.d.ts +4 -0
  88. package/dist/components/TextLabel/bend.d.ts +9 -0
  89. package/dist/components/TextLabel/canvas/buildTextLabelTexture.d.ts +4 -0
  90. package/dist/components/TextLabel/canvas/canvasTypography.d.ts +13 -0
  91. package/dist/components/TextLabel/canvas/drawBackground.d.ts +21 -0
  92. package/dist/components/TextLabel/canvas/drawEffects.d.ts +34 -0
  93. package/dist/components/TextLabel/canvas/drawText.d.ts +19 -0
  94. package/dist/components/TextLabel/components/TextLabelMesh.d.ts +13 -0
  95. package/dist/components/TextLabel/constants.d.ts +2 -0
  96. package/dist/components/TextLabel/hooks/useTextLabelTexture.d.ts +7 -0
  97. package/dist/components/TextLabel/index.d.ts +2 -161
  98. package/dist/components/TextLabel/layout/measurement.d.ts +8 -0
  99. package/dist/components/TextLabel/layout/resolveTextLayout.d.ts +25 -0
  100. package/dist/components/TextLabel/layout/wrapText.d.ts +6 -0
  101. package/dist/components/TextLabel/types.d.ts +227 -0
  102. package/dist/components/TrackingAnchor/index.d.ts +18 -2
  103. package/dist/components/Transform3D/index.d.ts +30 -0
  104. package/dist/components/XRMediaSurface/index.d.ts +6 -6
  105. package/dist/components/XRViewport/XRViewport.d.ts +11 -0
  106. package/dist/components/XRViewport/components/HiddenMedia.d.ts +7 -0
  107. package/dist/components/XRViewport/components/MediaAssetPicker.d.ts +8 -0
  108. package/dist/components/XRViewport/components/MediaControlStack.d.ts +13 -0
  109. package/dist/components/XRViewport/components/XRViewportLayers.d.ts +30 -0
  110. package/dist/components/XRViewport/constants.d.ts +24 -0
  111. package/dist/components/XRViewport/contexts.d.ts +6 -0
  112. package/dist/components/XRViewport/hooks/useViewportExternalFaces.d.ts +13 -0
  113. package/dist/components/XRViewport/hooks/useViewportMediaSource.d.ts +16 -0
  114. package/dist/components/XRViewport/hooks/useViewportMediaTexture.d.ts +10 -0
  115. package/dist/components/XRViewport/hooks/useViewportPipeline.d.ts +41 -0
  116. package/dist/components/XRViewport/hooks/useViewportRenderState.d.ts +47 -0
  117. package/dist/components/XRViewport/index.d.ts +3 -118
  118. package/dist/components/XRViewport/layout.d.ts +16 -0
  119. package/dist/components/XRViewport/slots.d.ts +16 -0
  120. package/dist/components/XRViewport/types.d.ts +89 -0
  121. package/dist/components/XRViewport/useViewportSize.d.ts +3 -0
  122. package/dist/components/index.d.ts +12 -0
  123. package/dist/contexts-D5TQcwmv.js +660 -0
  124. package/dist/contexts-Dv1SA0bS.cjs +1 -0
  125. package/dist/debug-ui/component-editor/index.d.ts +19 -0
  126. package/dist/debug-ui/face-mesh-renderer-settings/index.d.ts +8 -0
  127. package/dist/debug-ui/face-retouch/index.d.ts +11 -0
  128. package/dist/debug-ui/hand-joints-2d/index.d.ts +1 -1
  129. package/dist/debug-ui/hand-tracking-2d/index.d.ts +1 -1
  130. package/dist/debug-ui/hand-tracking-2d-controller/index.d.ts +1 -1
  131. package/dist/debug-ui/hand-tracking-3d/index.d.ts +1 -1
  132. package/dist/debug-ui/hierarchy-panel/index.d.ts +29 -0
  133. package/dist/debug-ui/index.d.ts +25 -2
  134. package/dist/debug-ui/layer-panel/index.d.ts +3 -2
  135. package/dist/debug-ui/media-source/index.d.ts +2 -0
  136. package/dist/debug-ui/media-source/session.d.ts +12 -0
  137. package/dist/debug-ui/media-source.cjs +1 -1
  138. package/dist/debug-ui/media-source.js +6 -4
  139. package/dist/debug-ui/mesh-renderer-settings/index.d.ts +6 -0
  140. package/dist/debug-ui/object-inspector-panel/index.d.ts +25 -0
  141. package/dist/debug-ui/pin-to-mesh-settings/index.d.ts +10 -0
  142. package/dist/debug-ui/scene-editor/context.d.ts +38 -0
  143. package/dist/debug-ui/scene-editor/hierarchy-panel.d.ts +9 -0
  144. package/dist/debug-ui/scene-editor/index.d.ts +11 -0
  145. package/dist/debug-ui/scene-editor/inspector-panel.d.ts +7 -0
  146. package/dist/debug-ui/scene-editor/store-utils.d.ts +2 -0
  147. package/dist/debug-ui/scene-editor/viewport-toolbar.d.ts +4 -0
  148. package/dist/debug-ui/scene-editor/viewport.d.ts +21 -0
  149. package/dist/debug-ui/screen-glass-settings/index.d.ts +6 -0
  150. package/dist/debug-ui/screen-gradient-settings/GradientStopsEditor.d.ts +5 -0
  151. package/dist/debug-ui/screen-gradient-settings/index.d.ts +6 -0
  152. package/dist/debug-ui/screen-gradient-settings/styles.d.ts +3 -0
  153. package/dist/debug-ui/screen-image-settings/index.d.ts +4 -2
  154. package/dist/debug-ui/screen-shape-settings/index.d.ts +6 -0
  155. package/dist/debug-ui/screen-text-settings/NumberField.d.ts +9 -0
  156. package/dist/debug-ui/screen-text-settings/ScreenTextSettingsPanel.d.ts +3 -0
  157. package/dist/debug-ui/screen-text-settings/controls/NestedSection.d.ts +7 -0
  158. package/dist/debug-ui/screen-text-settings/controls/Section.d.ts +8 -0
  159. package/dist/debug-ui/screen-text-settings/controls/icons.d.ts +4 -0
  160. package/dist/debug-ui/screen-text-settings/index.d.ts +2 -122
  161. package/dist/debug-ui/screen-text-settings/sections/BackgroundSection.d.ts +8 -0
  162. package/dist/debug-ui/screen-text-settings/sections/ContentSection.d.ts +5 -0
  163. package/dist/debug-ui/screen-text-settings/sections/EffectsSection.d.ts +25 -0
  164. package/dist/debug-ui/screen-text-settings/sections/StyleSection.d.ts +5 -0
  165. package/dist/debug-ui/screen-text-settings/sections/TransformSection.d.ts +5 -0
  166. package/dist/debug-ui/screen-text-settings/sections/background/BackgroundFillControls.d.ts +2 -0
  167. package/dist/debug-ui/screen-text-settings/sections/background/BackgroundSizeControls.d.ts +2 -0
  168. package/dist/debug-ui/screen-text-settings/sections/background/BackgroundStrokeControls.d.ts +2 -0
  169. package/dist/debug-ui/screen-text-settings/sections/background/types.d.ts +7 -0
  170. package/dist/debug-ui/screen-text-settings/sections/effects/BendEffectSection.d.ts +4 -0
  171. package/dist/debug-ui/screen-text-settings/sections/effects/EffectChrome.d.ts +21 -0
  172. package/dist/debug-ui/screen-text-settings/sections/effects/GlowEffectSection.d.ts +4 -0
  173. package/dist/debug-ui/screen-text-settings/sections/effects/InnerShadowEffectSection.d.ts +4 -0
  174. package/dist/debug-ui/screen-text-settings/sections/effects/OutlineEffectSection.d.ts +4 -0
  175. package/dist/debug-ui/screen-text-settings/sections/effects/ShadowEffectSection.d.ts +4 -0
  176. package/dist/debug-ui/screen-text-settings/sections/effects/types.d.ts +14 -0
  177. package/dist/debug-ui/screen-text-settings/settings.d.ts +90 -0
  178. package/dist/debug-ui/screen-text-settings/styles.d.ts +26 -0
  179. package/dist/debug-ui/screen-text-settings/transform.d.ts +6 -0
  180. package/dist/debug-ui/screen-text-settings/types.d.ts +9 -0
  181. package/dist/debug-ui/shared/ScreenTransformSection.d.ts +6 -3
  182. package/dist/debug-ui/transform-3d-settings/index.d.ts +11 -0
  183. package/dist/debug-ui.cjs +3 -13
  184. package/dist/debug-ui.js +7735 -4896
  185. package/dist/drawNormalizedCrop-B-7zU-Xw.cjs +1 -0
  186. package/dist/drawNormalizedCrop-CRdIDyl1.js +44 -0
  187. package/dist/entries/all.d.ts +1 -0
  188. package/dist/entries/core.d.ts +53 -6
  189. package/dist/entries/face-effects.d.ts +10 -8
  190. package/dist/entries/internal.d.ts +1 -1
  191. package/dist/entries/low-level.d.ts +21 -4
  192. package/dist/entries/scene-object.d.ts +10 -0
  193. package/dist/entries/tracking.d.ts +25 -2
  194. package/dist/face-action/index.d.ts +34 -0
  195. package/dist/face-attribute-expression/index.d.ts +10 -0
  196. package/dist/face-effects.cjs +1 -342
  197. package/dist/face-effects.js +1391 -2767
  198. package/dist/face-info/blendshapes.d.ts +3 -0
  199. package/dist/face-info/derive.d.ts +8 -0
  200. package/dist/face-info/drawFaceCrop.d.ts +10 -0
  201. package/dist/face-info/getFaceInfo.d.ts +8 -0
  202. package/dist/face-info/index.d.ts +8 -0
  203. package/dist/face-info/landmarks.d.ts +21 -0
  204. package/dist/face-info/types.d.ts +52 -0
  205. package/dist/getFaceInfo-Cjcgcc4w.js +118 -0
  206. package/dist/getFaceInfo-oQcP40Ha.cjs +1 -0
  207. package/dist/{handJoints2d.d.ts → hand/handJoints2d.d.ts} +1 -1
  208. package/dist/{handTracking2d.d.ts → hand/handTracking2d.d.ts} +1 -1
  209. package/dist/{handTracking2dController.d.ts → hand/handTracking2dController.d.ts} +1 -1
  210. package/dist/{handTracking3d.d.ts → hand/handTracking3d.d.ts} +1 -1
  211. package/dist/hooks/faceResults.d.ts +1 -1
  212. package/dist/hooks/useCalibrationFaceTracker.d.ts +1 -1
  213. package/dist/hooks/useFaceAction.d.ts +3 -0
  214. package/dist/hooks/useFaceAttributeExpression.d.ts +16 -0
  215. package/dist/hooks/useFaceDetection.d.ts +18 -0
  216. package/dist/hooks/useFaceInfo.d.ts +7 -0
  217. package/dist/hooks/useFaceInfos.d.ts +15 -0
  218. package/dist/hooks/useFaceResultReader.d.ts +10 -0
  219. package/dist/hooks/useFrameCapture.d.ts +18 -0
  220. package/dist/hooks/useMediaRecorder.d.ts +14 -2
  221. package/dist/hooks/useOwnedTexture.d.ts +6 -0
  222. package/dist/hooks/useTrackerContext.d.ts +2 -2
  223. package/dist/hooks/useXRModel.d.ts +5 -0
  224. package/dist/hooks/useXRSession/facade.d.ts +3 -0
  225. package/dist/hooks/useXRSession/registry.d.ts +9 -0
  226. package/dist/index-Be-S7uSm.cjs +1 -0
  227. package/dist/index-D4bLzBr6.cjs +1 -0
  228. package/dist/index-DdWBnI7A.cjs +17 -0
  229. package/dist/index-DpVIEBHw.js +2068 -0
  230. package/dist/index-DqhqBi7O.cjs +1 -0
  231. package/dist/index-HxT9XEuh.js +111 -0
  232. package/dist/{index-safCs_af.js → index-JygePOwo.js} +565 -508
  233. package/dist/index-N7C6fNah.js +214 -0
  234. package/dist/index-UU5ODHGU.cjs +1 -0
  235. package/dist/{index-BGNbrc4C.js → index-YMUaJU7U.js} +217 -126
  236. package/dist/{internal-Cae1ps15.js → internal-D7NxAsc6.js} +86 -80
  237. package/dist/internal-i2JkM85N.cjs +1 -0
  238. package/dist/internal.cjs +1 -1
  239. package/dist/internal.js +2 -2
  240. package/dist/low-level.cjs +1 -1
  241. package/dist/low-level.js +1138 -86
  242. package/dist/main.cjs +1 -73
  243. package/dist/main.js +545 -1693
  244. package/dist/material/MaterialFill.d.ts +20 -0
  245. package/dist/material/MeshMaterial.d.ts +14 -0
  246. package/dist/material/index.d.ts +2 -0
  247. package/dist/models/Body/index.d.ts +1 -1
  248. package/dist/models/Face/index.d.ts +1 -0
  249. package/dist/models/Face/rotation.d.ts +3 -0
  250. package/dist/render/renderGroups.d.ts +47 -0
  251. package/dist/render/renderPasses.d.ts +18 -0
  252. package/dist/renderGroups-JEXqSACh.js +152 -0
  253. package/dist/renderGroups-uXXsFpvw.cjs +1 -0
  254. package/dist/renderLayers-lDtL0_43.cjs +1 -0
  255. package/dist/renderLayers-zrK2pv5O.js +13 -0
  256. package/dist/renderPasses-CVWt0t8m.cjs +21 -0
  257. package/dist/renderPasses-CdGZeHHL.js +1500 -0
  258. package/dist/scene-object/index.d.ts +146 -0
  259. package/dist/scene-object/runtimeRegistry.d.ts +14 -0
  260. package/dist/scene-object.cjs +1 -0
  261. package/dist/scene-object.js +40 -0
  262. package/dist/{screenImageSettings.d.ts → screen-image/screenImageSettings.d.ts} +9 -2
  263. package/dist/{screenTextSettings.d.ts → screen-text/screenTextSettings.d.ts} +18 -2
  264. package/dist/screen2d/coordinates.d.ts +87 -0
  265. package/dist/screen2d/index.d.ts +3 -0
  266. package/dist/screen2d/screenTransform.d.ts +47 -0
  267. package/dist/screen2d/smoothing.d.ts +5 -0
  268. package/dist/{selectors-BLl2JUWW.cjs → selectors-2QvO5RYY.cjs} +1 -1
  269. package/dist/{selectors-CXd_x-6t.js → selectors-twqYByYZ.js} +6 -6
  270. package/dist/services/MetricsCollector/index.d.ts +7 -1
  271. package/dist/services/MetricsCollector/utils.d.ts +1 -1
  272. package/dist/session-BChR4TgK.cjs +31 -0
  273. package/dist/session-C1StwN0f.js +363 -0
  274. package/dist/texture/animatedTexture.d.ts +63 -0
  275. package/dist/texture/animationMath.d.ts +8 -0
  276. package/dist/texture/gifReader.d.ts +17 -0
  277. package/dist/texture/gifTextureSource.d.ts +16 -0
  278. package/dist/texture/sourceResolver.d.ts +30 -0
  279. package/dist/tracking.cjs +1 -1
  280. package/dist/tracking.js +580 -321
  281. package/dist/types/face.d.ts +1 -13
  282. package/dist/types/index.d.ts +0 -1
  283. package/dist/types/nodes.d.ts +2 -1
  284. package/dist/types/session.d.ts +2 -0
  285. package/dist/types/tracking.d.ts +8 -2
  286. package/dist/types/util-types.d.ts +1 -1
  287. package/dist/useFaceInfo-DOJCGlDG.js +62 -0
  288. package/dist/useFaceInfo-DSUmuzzO.cjs +1 -0
  289. package/dist/useFaceResults-B1BSGUAW.cjs +1 -0
  290. package/dist/useFaceResults-CBmhT5E8.js +19 -0
  291. package/dist/utils/drawNormalizedCrop.d.ts +22 -0
  292. package/dist/utils/integrity.d.ts +4 -25
  293. package/dist/utils/landmarkBounds.d.ts +1 -1
  294. package/dist/utils/logger.d.ts +2 -2
  295. package/docs/MIGRATION_GUIDE.md +589 -0
  296. package/docs/SDK_DOCUMENTATION.md +1155 -0
  297. package/docs/api/audio.mdx +36 -0
  298. package/docs/api/behavior-components.mdx +164 -0
  299. package/docs/api/capture-recording.mdx +103 -0
  300. package/docs/api/debug-ui-scene-editor.mdx +249 -0
  301. package/docs/api/face-actions.mdx +104 -0
  302. package/docs/api/face-attribute-expression.mdx +87 -0
  303. package/docs/api/face-binding-anchors.mdx +53 -0
  304. package/docs/api/face-effects.mdx +19 -0
  305. package/docs/api/face-info.mdx +112 -0
  306. package/docs/api/face-mesh.mdx +98 -0
  307. package/docs/api/face-painting.mdx +33 -0
  308. package/docs/api/face-retouching.mdx +73 -0
  309. package/docs/api/material-render-state.mdx +132 -0
  310. package/docs/api/runtime-3d.mdx +311 -0
  311. package/docs/api/scene-object-store.mdx +213 -0
  312. package/docs/api/screen-image.mdx +65 -0
  313. package/docs/api/screen-shape.mdx +64 -0
  314. package/docs/api/screen-space-coordinates.mdx +41 -0
  315. package/docs/api/screen-text.mdx +39 -0
  316. package/docs/api/texture-sources.mdx +74 -0
  317. package/docs/api/trackers.mdx +46 -0
  318. package/docs/docs.json +70 -0
  319. package/docs/examples/scene-object-recipes.mdx +194 -0
  320. package/docs/guides/harness-debug-ui.mdx +139 -0
  321. package/docs/inspector/hierarchy-panel.mdx +51 -0
  322. package/docs/inspector/object-inspector-panel.mdx +51 -0
  323. package/docs/introduction.mdx +121 -0
  324. package/docs/scene-objects/overview.mdx +127 -0
  325. package/docs/scene-objects/render-groups.mdx +77 -0
  326. package/docs/scene-objects/runtime-rendering.mdx +75 -0
  327. package/docs/texture-api-consumer.md +84 -0
  328. package/package.json +38 -8
  329. package/dist/MediaSourceSwitcher-C-xYg0nQ.js +0 -317
  330. package/dist/MediaSourceSwitcher-Cq3g4IKw.cjs +0 -31
  331. package/dist/components/FaceRetouch/defaults.d.ts +0 -13
  332. package/dist/components/FaceRetouch/retouchRegions.d.ts +0 -23
  333. package/dist/components/FaceRetouch/useFaceRetouchRegions.d.ts +0 -12
  334. package/dist/defaults-BLpcN3pG.cjs +0 -1
  335. package/dist/defaults-LtY4M7dg.js +0 -55
  336. package/dist/index-BXyObVHF.cjs +0 -1
  337. package/dist/index-CY3bUAcW.js +0 -12
  338. package/dist/index-C_Duh13c.cjs +0 -1
  339. package/dist/index-D8fpPQkC.cjs +0 -1
  340. package/dist/index-DxshgBu0.cjs +0 -1
  341. package/dist/index-O-2crZ3M.js +0 -1102
  342. package/dist/internal-BjyhBP8i.cjs +0 -1
  343. package/dist/modules/XRClient/index.d.ts +0 -9
  344. package/dist/modules/index.d.ts +0 -1
  345. package/dist/screenImageSettings-6NRg4cx9.js +0 -39
  346. package/dist/screenImageSettings-y_B4_767.cjs +0 -1
  347. package/dist/services/ApiService.d.ts +0 -12
  348. package/dist/types/client.d.ts +0 -3
  349. package/dist/useFaceResults-cpsSmKKc.js +0 -81
  350. package/dist/useFaceResults-hVUJYSEY.cjs +0 -1
  351. package/dist/useXRModel-3DcUa28n.cjs +0 -1
  352. package/dist/useXRModel-BMJE1hrk.js +0 -28
  353. /package/dist/{layerStack.d.ts → render/layerStack.d.ts} +0 -0
  354. /package/dist/{screenImagePresets.d.ts → screen-image/screenImagePresets.d.ts} +0 -0
  355. /package/dist/{screenTextPresets.d.ts → screen-text/screenTextPresets.d.ts} +0 -0
@@ -0,0 +1,5 @@
1
+ import { ScreenTextSettings } from '../types';
2
+ export declare function ContentSection({ value, onChange, }: {
3
+ value: ScreenTextSettings;
4
+ onChange: (updater: (current: ScreenTextSettings) => ScreenTextSettings) => void;
5
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,25 @@
1
+ import { Dispatch, SetStateAction } from 'react';
2
+ import { ScreenTextSettings } from '../types';
3
+ type EffectsSectionProps = {
4
+ value: ScreenTextSettings;
5
+ onChange: (updater: (current: ScreenTextSettings) => ScreenTextSettings) => void;
6
+ outlineLayers: NonNullable<ScreenTextSettings["style"]["strokeLayers"]>;
7
+ shadowLayers: NonNullable<ScreenTextSettings["style"]["shadowLayers"]>;
8
+ innerShadow: NonNullable<ScreenTextSettings["style"]["innerShadow"]>;
9
+ glow: NonNullable<ScreenTextSettings["style"]["glow"]>;
10
+ bend: NonNullable<ScreenTextSettings["style"]["bend"]>;
11
+ outlineSettingsOpen: boolean;
12
+ setOutlineSettingsOpen: Dispatch<SetStateAction<boolean>>;
13
+ shadowSettingsOpen: boolean;
14
+ setShadowSettingsOpen: Dispatch<SetStateAction<boolean>>;
15
+ innerShadowSettingsOpen: boolean;
16
+ setInnerShadowSettingsOpen: Dispatch<SetStateAction<boolean>>;
17
+ glowSettingsOpen: boolean;
18
+ setGlowSettingsOpen: Dispatch<SetStateAction<boolean>>;
19
+ bendSettingsOpen: boolean;
20
+ setBendSettingsOpen: Dispatch<SetStateAction<boolean>>;
21
+ backgroundSettingsOpen: boolean;
22
+ setBackgroundSettingsOpen: Dispatch<SetStateAction<boolean>>;
23
+ };
24
+ export declare function EffectsSection({ backgroundSettingsOpen, bend, bendSettingsOpen, glow, glowSettingsOpen, innerShadow, innerShadowSettingsOpen, onChange, outlineLayers, outlineSettingsOpen, setBackgroundSettingsOpen, setBendSettingsOpen, setGlowSettingsOpen, setInnerShadowSettingsOpen, setOutlineSettingsOpen, setShadowSettingsOpen, shadowLayers, shadowSettingsOpen, value, }: EffectsSectionProps): import("react/jsx-runtime").JSX.Element;
25
+ export {};
@@ -0,0 +1,5 @@
1
+ import { ScreenTextSettings } from '../types';
2
+ export declare function StyleSection({ value, onChange, }: {
3
+ value: ScreenTextSettings;
4
+ onChange: (updater: (current: ScreenTextSettings) => ScreenTextSettings) => void;
5
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,5 @@
1
+ import { ScreenTextSettings } from '../types';
2
+ export declare function TransformSection({ value, onChange, }: {
3
+ value: ScreenTextSettings;
4
+ onChange: (updater: (current: ScreenTextSettings) => ScreenTextSettings) => void;
5
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,2 @@
1
+ import { BackgroundControlsProps } from './types';
2
+ export declare function BackgroundFillControls({ background, onChange }: BackgroundControlsProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,2 @@
1
+ import { BackgroundControlsProps } from './types';
2
+ export declare function BackgroundSizeControls({ background, onChange }: BackgroundControlsProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,2 @@
1
+ import { BackgroundControlsProps } from './types';
2
+ export declare function BackgroundStrokeControls({ background, onChange }: BackgroundControlsProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,7 @@
1
+ import { ScreenTextSettings } from '../../types';
2
+ export type BackgroundSettings = ScreenTextSettings["style"]["background"];
3
+ export type BackgroundControlsProps = {
4
+ background: BackgroundSettings;
5
+ onChange: (updater: (current: ScreenTextSettings) => ScreenTextSettings) => void;
6
+ };
7
+ export declare const updateBackground: (onChange: BackgroundControlsProps["onChange"], patcher: (background: BackgroundSettings) => Partial<BackgroundSettings>) => () => void;
@@ -0,0 +1,4 @@
1
+ import { BendSettings, CollapsibleEffectProps } from './types';
2
+ export declare function BendEffectSection({ bend, open, onChange, setOpen, value, }: CollapsibleEffectProps & {
3
+ bend: BendSettings;
4
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,21 @@
1
+ import { ReactNode } from 'react';
2
+ export declare const effectLayerCardStyle: {
3
+ gridColumn: string;
4
+ display: string;
5
+ gap: number;
6
+ padding: string;
7
+ borderRadius: number;
8
+ border: string;
9
+ background: string;
10
+ };
11
+ export declare function EffectToggle({ checked, label, onChange, }: {
12
+ checked: boolean;
13
+ label: string;
14
+ onChange: (checked: boolean) => void;
15
+ }): import("react/jsx-runtime").JSX.Element;
16
+ export declare function CollapsibleEffectGroup({ children, label, open, setOpen, }: {
17
+ children: ReactNode;
18
+ label: string;
19
+ open: boolean;
20
+ setOpen: React.Dispatch<React.SetStateAction<boolean>>;
21
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,4 @@
1
+ import { CollapsibleEffectProps, GlowSettings } from './types';
2
+ export declare function GlowEffectSection({ glow, open, onChange, setOpen, value, }: CollapsibleEffectProps & {
3
+ glow: GlowSettings;
4
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,4 @@
1
+ import { CollapsibleEffectProps, InnerShadowSettings } from './types';
2
+ export declare function InnerShadowEffectSection({ innerShadow, open, onChange, setOpen, value, }: CollapsibleEffectProps & {
3
+ innerShadow: InnerShadowSettings;
4
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,4 @@
1
+ import { CollapsibleEffectProps, OutlineLayer } from './types';
2
+ export declare function OutlineEffectSection({ layers, open, onChange, setOpen, value, }: CollapsibleEffectProps & {
3
+ layers: OutlineLayer[];
4
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,4 @@
1
+ import { CollapsibleEffectProps, ShadowLayer } from './types';
2
+ export declare function ShadowEffectSection({ layers, open, onChange, setOpen, value, }: CollapsibleEffectProps & {
3
+ layers: ShadowLayer[];
4
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,14 @@
1
+ import { Dispatch, SetStateAction } from 'react';
2
+ import { ScreenTextSettings } from '../../types';
3
+ export type ScreenTextSettingsUpdater = (updater: (current: ScreenTextSettings) => ScreenTextSettings) => void;
4
+ export type CollapsibleEffectProps = {
5
+ value: ScreenTextSettings;
6
+ onChange: ScreenTextSettingsUpdater;
7
+ open: boolean;
8
+ setOpen: Dispatch<SetStateAction<boolean>>;
9
+ };
10
+ export type OutlineLayer = NonNullable<ScreenTextSettings["style"]["strokeLayers"]>[number];
11
+ export type ShadowLayer = NonNullable<ScreenTextSettings["style"]["shadowLayers"]>[number];
12
+ export type InnerShadowSettings = NonNullable<ScreenTextSettings["style"]["innerShadow"]>;
13
+ export type GlowSettings = NonNullable<ScreenTextSettings["style"]["glow"]>;
14
+ export type BendSettings = NonNullable<ScreenTextSettings["style"]["bend"]>;
@@ -0,0 +1,90 @@
1
+ import { ScreenTextArtPreset, ScreenTextSettings } from './types';
2
+ export declare const SCREEN_TEXT_FONT_OPTIONS: readonly [{
3
+ readonly label: "Space Grotesk";
4
+ readonly value: "\"Space Grotesk\", sans-serif";
5
+ }, {
6
+ readonly label: "Bebas Neue";
7
+ readonly value: "\"Bebas Neue\", sans-serif";
8
+ }, {
9
+ readonly label: "DM Serif Display";
10
+ readonly value: "\"DM Serif Display\", serif";
11
+ }, {
12
+ readonly label: "Caveat";
13
+ readonly value: "\"Caveat\", cursive";
14
+ }];
15
+ export declare const SCREEN_TEXT_ART_OPTIONS: ScreenTextArtPreset[];
16
+ export declare const SCREEN_TEXT_ART_LABELS: Record<ScreenTextArtPreset, string>;
17
+ export declare const createDefaultOutlineLayer: () => {
18
+ color: string;
19
+ opacity: number;
20
+ width: number;
21
+ };
22
+ export declare const createDefaultShadowLayer: () => {
23
+ color: string;
24
+ opacity: number;
25
+ offset: number;
26
+ angle: number;
27
+ feather: number;
28
+ blur: number;
29
+ offsetX: number;
30
+ offsetY: number;
31
+ };
32
+ export declare const createDefaultGlow: () => {
33
+ color: string;
34
+ style: "outward";
35
+ intensity: number;
36
+ range: number;
37
+ horizontalAngle: number;
38
+ verticalAngle: number;
39
+ };
40
+ export declare const createDefaultBend: () => {
41
+ preset: "arc";
42
+ strength: number;
43
+ };
44
+ export declare const BEND_PRESET_OPTIONS: readonly [{
45
+ readonly label: "Arc";
46
+ readonly value: "arc";
47
+ }, {
48
+ readonly label: "Arc Lower";
49
+ readonly value: "arc-lower";
50
+ }, {
51
+ readonly label: "Arc Upper";
52
+ readonly value: "arc-upper";
53
+ }, {
54
+ readonly label: "Arch";
55
+ readonly value: "arch";
56
+ }, {
57
+ readonly label: "Bulge";
58
+ readonly value: "bulge";
59
+ }, {
60
+ readonly label: "Shell Lower";
61
+ readonly value: "shell-lower";
62
+ }, {
63
+ readonly label: "Shell Upper";
64
+ readonly value: "shell-upper";
65
+ }, {
66
+ readonly label: "Flag";
67
+ readonly value: "flag";
68
+ }, {
69
+ readonly label: "Wave";
70
+ readonly value: "wave";
71
+ }, {
72
+ readonly label: "Fish";
73
+ readonly value: "fish";
74
+ }, {
75
+ readonly label: "Rise";
76
+ readonly value: "rise";
77
+ }, {
78
+ readonly label: "Fisheye";
79
+ readonly value: "fisheye";
80
+ }, {
81
+ readonly label: "Inflate";
82
+ readonly value: "inflate";
83
+ }, {
84
+ readonly label: "Squeeze";
85
+ readonly value: "squeeze";
86
+ }, {
87
+ readonly label: "Twist";
88
+ readonly value: "twist";
89
+ }];
90
+ export declare const applyTextArtPresetToSettings: (current: ScreenTextSettings, textArtPreset: ScreenTextArtPreset) => ScreenTextSettings;
@@ -0,0 +1,26 @@
1
+ import { CSSProperties } from 'react';
2
+ export declare const badgeStyle: CSSProperties;
3
+ export declare const sectionStyle: CSSProperties;
4
+ export declare const sectionHeaderStyle: CSSProperties;
5
+ export declare const sectionTitleStyle: CSSProperties;
6
+ export declare const sectionToggleStyle: CSSProperties;
7
+ export declare const sectionToggleKnobStyle: (enabled: boolean) => CSSProperties;
8
+ export declare const sectionBodyStyle: CSSProperties;
9
+ export declare const fieldGridStyle: CSSProperties;
10
+ export declare const fieldStyle: CSSProperties;
11
+ export declare const fullWidthFieldStyle: CSSProperties;
12
+ export declare const nestedGroupStyle: CSSProperties;
13
+ export declare const nestedHeaderButtonStyle: CSSProperties;
14
+ export declare const nestedHeaderLabelStyle: CSSProperties;
15
+ export declare const nestedHeaderStateStyle: CSSProperties;
16
+ export declare const labelStyle: CSSProperties;
17
+ export declare const inputStyle: CSSProperties;
18
+ export declare const textAreaStyle: CSSProperties;
19
+ export declare const colorInputStyle: CSSProperties;
20
+ export declare const selectStyle: CSSProperties;
21
+ export declare const disabledInputStyle: CSSProperties;
22
+ export declare const checkboxRowStyle: CSSProperties;
23
+ export declare const checkboxStyle: CSSProperties;
24
+ export declare const textFormatControlStyle: CSSProperties;
25
+ export declare const textFormatButtonStyle: (active: boolean) => CSSProperties;
26
+ export declare const buttonStyle: CSSProperties;
@@ -0,0 +1,6 @@
1
+ import { ScreenTransform2DSettings } from '../../screen2d';
2
+ import { ScreenTransformSectionValue } from '../shared/ScreenTransformSection';
3
+ import { ScreenTextSettings } from './types';
4
+ export declare const toTransformSectionValue: (transformation: ScreenTextSettings["transformation"], screenTransform?: ScreenTextSettings["screenTransform"]) => ScreenTransformSectionValue;
5
+ export declare const fromTransformSectionValue: (next: ScreenTransformSectionValue, current: ScreenTextSettings["transformation"]) => ScreenTextSettings["transformation"];
6
+ export declare const toScreenTransformSettings: (next: ScreenTransformSectionValue, current?: ScreenTransform2DSettings) => ScreenTransform2DSettings;
@@ -0,0 +1,9 @@
1
+ import { ObjectInspectorPanelProps } from '../object-inspector-panel';
2
+ import { ScreenTextSceneSettings } from '../../screen-text/screenTextSettings';
3
+ export type { ScreenTextArtPreset, ScreenTextSceneSettings, ScreenTextSettings, } from '../../screen-text/screenTextSettings';
4
+ export type ScreenTextSettingsPanelProps = {
5
+ value: ScreenTextSceneSettings;
6
+ onChange: (next: ScreenTextSceneSettings) => void;
7
+ copyLabel?: string;
8
+ inspector?: Omit<ObjectInspectorPanelProps, "children">;
9
+ };
@@ -13,6 +13,11 @@ export type ScreenTransformSectionValue = {
13
13
  height: number;
14
14
  };
15
15
  rotation: number;
16
+ scale2D?: {
17
+ x: number;
18
+ y: number;
19
+ };
20
+ referencePixelsPerUnit?: number;
16
21
  pivot: [number, number];
17
22
  renderOrder: number;
18
23
  overlay: boolean;
@@ -22,8 +27,6 @@ export type ScreenTransformSectionProps = {
22
27
  value: ScreenTransformSectionValue;
23
28
  onChange: (next: ScreenTransformSectionValue) => void;
24
29
  guideLabel: string;
25
- copyLabel?: string;
26
- copyValue?: unknown;
27
30
  showRenderOrder?: boolean;
28
31
  };
29
- export declare const ScreenTransformSection: ({ value, onChange, guideLabel, copyLabel, copyValue, showRenderOrder, }: ScreenTransformSectionProps) => import("react/jsx-runtime").JSX.Element;
32
+ export declare const ScreenTransformSection: ({ value, onChange, guideLabel, showRenderOrder, }: ScreenTransformSectionProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,11 @@
1
+ import { Transform3DSettings } from '../../components/Transform3D';
2
+ export type Transform3DSettingsPanelProps = {
3
+ value: Transform3DSettings;
4
+ onChange: (next: Transform3DSettings) => void;
5
+ copyLabel?: string;
6
+ };
7
+ export declare const Transform3DSettingsSection: ({ value, onChange, }: {
8
+ value: Transform3DSettings;
9
+ onChange: (next: Transform3DSettings) => void;
10
+ }) => import("react/jsx-runtime").JSX.Element;
11
+ export declare const Transform3DSettingsPanel: ({ value, onChange, copyLabel, }: Transform3DSettingsPanelProps) => import('react').ReactPortal | null;