@layoutit/polycss-react 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import * as React$1 from 'react';
-import React__default, { ReactNode, CSSProperties, MouseEventHandler, PointerEventHandler, FocusEventHandler, KeyboardEventHandler, RefObject, MouseEvent as MouseEvent$1 } from 'react';
+import React__default, { ReactNode, CSSProperties, MouseEventHandler, PointerEventHandler, FocusEventHandler, KeyboardEventHandler, IframeHTMLAttributes, RefObject, MouseEvent as MouseEvent$1 } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _layoutit_polycss_core from '@layoutit/polycss-core';
 import { Vec3, CameraState, CameraHandle, Vec2, PolyMaterial, PolyDirectionalLight, PolyTextureLightingMode, TextureQuality, Polygon, PolyAmbientLight, PolySeamBleed, PolyRenderStrategiesOption, LoadMeshOptions, ParseResult, MeshResolution, BoxPolygonsOptions, ConePolygonsOptions, CylinderPolygonsOptions, DodecahedronPolygonsOptions, IcosahedronPolygonsOptions, OctahedronPolygonsOptions, PlanePolygonsOptions, RingPolygonsOptions, SpherePolygonsOptions, TetrahedronPolygonsOptions, TorusPolygonsOptions, PolyAnimationTarget, PolyAnimationMixer, PolyAnimationClip, PolyAnimationAction, ParseAnimationController } from '@layoutit/polycss-core';
-export { ArrowPolygonsOptions, AutoRotateConfig, AutoRotateOption, AxesHelperOptions, BASE_TILE, BoxFace, BoxFaceOptions, BoxPolygonsOptions, CAMERA_BACKFACE_CULL_EPS, CameraCullNormalGroup, CameraCullRotation, CameraHandle, CameraState, CameraStyleInput, ConePolygonsOptions, CoverPlanarPolygonsOptions, CullInteriorOptions, CylinderPolygonsOptions, DEFAULT_CAMERA_STATE, DEFAULT_PROJECTION, DEFAULT_SEAM_FACET_SPLIT_OPTIONS, DEFAULT_SEAM_OVERLAP_OPTIONS, DodecahedronPolygonsOptions, GltfParseOptions, IcosahedronPolygonsOptions, LoadMeshOptions, LoopMode, LoopOnce, LoopPingPong, LoopRepeat, MeshResolution, MtlParseResult, NormalizeResult, ObjParseOptions, OctahedronPolygonsOptions, OptimizeAnimatedMeshPolygonsOptions, OptimizeMeshPolygonsOptions, ParseAnimationClip, ParseAnimationController, ParseResult, ParsedColor, PlanePolygonsOptions, PolyAmbientLight, PolyAnimationAction, PolyAnimationClip, PolyAnimationMixer, PolyAnimationTarget, PolyDirectionalLight, PolyMaterial, PolyRenderStrategiesOption, PolyRenderStrategy, PolyTextureLightingMode, Polygon, PolygonFace, RingPolygonsOptions, SceneBbox, SceneContext, SceneContextBuildArgs, SceneContextBuildResult, SeamFacetSplitCandidate, SeamFacetSplitCandidateReason, SeamFacetSplitOptions, SeamFacetSplitReport, SeamOverlapCandidate, SeamOverlapCandidateKind, SeamOverlapDiagnostics, SeamOverlapOptions, SolidTextureSampleOptions, TetrahedronPolygonsOptions, TexturePaintMetrics, TexturePaintMetricsOptions, TextureTriangle, TorusPolygonsOptions, VOXEL_CAMERA_CULL_AXIS_EPS, VOXEL_CAMERA_CULL_NORMAL_LIMIT, Vec2, Vec3, VoxParseOptions, arrowPolygons, axesHelperPolygons, bakeSolidTextureSampledPolygons, bakeSolidTextureSamples, boxPolygons, buildSceneContext, cameraCullNormalGroups, cameraCullNormalGroupsFromPolygons, cameraCullNormalKey, cameraCullVisibleSignature, cameraFacingDepth, clampChannel, computeSceneBbox, computeShapeLighting, computeTexturePaintMetrics, conePolygons, coverPlanarPolygons, createIsometricCamera, createPolyAnimationMixer, cullInteriorPolygons, cylinderPolygons, dodecahedronPolygons, formatColor, icosahedronPolygons, inverseRotateVec3, isAxisAlignedSurfaceNormal, isVoxelCameraCullableNormalGroups, loadMesh, mergePolygons, normalFacesCamera, normalizeInvertMultiplier, normalizePolygons, octahedronPolygons, optimizeAnimatedMeshPolygons, optimizeMeshPolygons, parseColor, parseGltf, parseHexColor, parseMtl, parseObj, parsePureColor, parseRgbColor, parseVox, planePolygons, polygonCssSurfaceNormal, polygonFaces, polygonFacesCamera, repairMeshSeams, ringPolygons, rotateVec3, seamFacetSplitPolygons, seamFacetSplitReport, seamOverlapDiagnostics, seamOverlapPolygons, seamOverlapReport, shadeColor, tetrahedronPolygons, torusPolygons } from '@layoutit/polycss-core';
+export { ArrowPolygonsOptions, AutoRotateConfig, AutoRotateOption, AxesHelperOptions, BASE_TILE, BoxFace, BoxFaceOptions, BoxPolygonsOptions, CAMERA_BACKFACE_CULL_EPS, CameraCullNormalGroup, CameraCullRotation, CameraHandle, CameraState, CameraStyleInput, ConePolygonsOptions, CoverPlanarPolygonsOptions, CullInteriorOptions, CylinderPolygonsOptions, DEFAULT_CAMERA_STATE, DEFAULT_PROJECTION, DEFAULT_SEAM_FACET_SPLIT_OPTIONS, DEFAULT_SEAM_OVERLAP_OPTIONS, DodecahedronPolygonsOptions, GltfParseOptions, IcosahedronPolygonsOptions, LoadMeshOptions, LoopMode, LoopOnce, LoopPingPong, LoopRepeat, MeshResolution, MtlParseResult, NormalizeResult, ObjParseOptions, OctahedronPolygonsOptions, OptimizeAnimatedMeshPolygonsOptions, OptimizeMeshParseResultOptions, OptimizeMeshPolygonsOptions, ParseAnimationClip, ParseAnimationController, ParseResult, ParseStlColor, ParseStlSolid, ParseStlTopology, ParsedColor, PlanePolygonsOptions, PolyAmbientLight, PolyAnimationAction, PolyAnimationClip, PolyAnimationMixer, PolyAnimationTarget, PolyDirectionalLight, PolyMaterial, PolyMeshTransformInput, PolyRenderStrategiesOption, PolyRenderStrategy, PolyTextureLightingMode, Polygon, PolygonFace, RingPolygonsOptions, SceneBbox, SceneContext, SceneContextBuildArgs, SceneContextBuildResult, SeamFacetSplitCandidate, SeamFacetSplitCandidateReason, SeamFacetSplitOptions, SeamFacetSplitReport, SeamOverlapCandidate, SeamOverlapCandidateKind, SeamOverlapDiagnostics, SeamOverlapOptions, SimplifyTriangleMeshPolygonsOptions, SolidTextureSampleOptions, StlParseOptions, TetrahedronPolygonsOptions, TexturePaintMetrics, TexturePaintMetricsOptions, TextureTriangle, TorusPolygonsOptions, VOXEL_CAMERA_CULL_AXIS_EPS, VOXEL_CAMERA_CULL_NORMAL_LIMIT, Vec2, Vec3, VoxParseOptions, arrowPolygons, axesHelperPolygons, bakeSolidTextureSampledPolygons, bakeSolidTextureSamples, boxPolygons, buildPolyMeshTransform, buildSceneContext, cameraCullNormalGroups, cameraCullNormalGroupsFromPolygons, cameraCullNormalKey, cameraCullVisibleSignature, cameraFacingDepth, clampChannel, computeSceneBbox, computeShapeLighting, computeTexturePaintMetrics, conePolygons, coverPlanarPolygons, createIsometricCamera, createPolyAnimationMixer, cullInteriorPolygons, cylinderPolygons, dodecahedronPolygons, formatColor, icosahedronPolygons, inverseRotateVec3, isAxisAlignedSurfaceNormal, isVoxelCameraCullableNormalGroups, loadMesh, mergePolygons, normalFacesCamera, normalizeInvertMultiplier, normalizePolygons, octahedronPolygons, optimizeAnimatedMeshPolygons, optimizeMeshParseResult, optimizeMeshPolygons, parseColor, parseGltf, parseHexColor, parseMtl, parseObj, parsePureColor, parseRgbColor, parseStl, parseVox, planePolygons, polygonCssSurfaceNormal, polygonFaces, polygonFacesCamera, repairMeshSeams, ringPolygons, rotateVec3, seamFacetSplitPolygons, seamFacetSplitReport, seamOverlapDiagnostics, seamOverlapPolygons, seamOverlapReport, shadeColor, simplifyTriangleMeshPolygons, tetrahedronPolygons, torusPolygons, worldDirectionToCss as worldDirectionToPolyCss, worldPositionToCss as worldPositionToPolyCss } from '@layoutit/polycss-core';
 
 interface PolyPerspectiveCameraProps {
     zoom?: number;
@@ -11,7 +12,7 @@ interface PolyPerspectiveCameraProps {
     rotY?: number;
     /** Camera pull-back in CSS pixels (dolly). Default 0. */
     distance?: number;
-    /** CSS perspective distance in pixels. Defaults to 8000. */
+    /** CSS perspective distance in pixels. Defaults to 32000. */
     perspective?: number;
     children?: ReactNode;
     className?: string;
@@ -117,12 +118,7 @@ interface ShadowOptions {
     maxExtend?: number;
 }
 
-/**
- * Three.js-style transform props accepted by every polycss component.
- * In Phase 3, position/scale/rotation are accepted but not yet applied —
- * the rendered transform comes from vertices in scene-root space.
- * Phase 4 wires these into the matrix3d composition with parent PolyMesh.
- */
+/** Three.js-style transform props accepted by every PolyCSS component. */
 interface TransformProps {
     position?: Vec3;
     scale?: number | Vec3;
@@ -130,7 +126,7 @@ interface TransformProps {
 }
 /**
  * DOM event handlers, ARIA, and style props forwarded to the rendered
- * element (atlas-backed <div>) by every Poly component.
+ * element by every Poly component.
  *
  * This is the DOM-native pitch: polygons are real DOM nodes you can
  * target with CSS, attach event handlers to, and inspect in DevTools.
@@ -162,7 +158,7 @@ interface DOMPassthroughProps {
  * Props for the `<Poly>` component — the atomic polygon primitive.
  *
  * Extends TransformProps + DOMPassthroughProps with the polygon's own fields.
- * This is the canonical polycss v0.1.0 Poly component API per §API freeze.
+ * This is the canonical Poly component API.
  */
 interface PolyProps extends TransformProps, DOMPassthroughProps {
     vertices: Vec3[];
@@ -243,10 +239,9 @@ interface PolySceneProps extends TransformProps {
     autoCenter?: boolean;
     /**
      * Shadow appearance for meshes with `castShadow={true}`. Works in both
-     * lighting modes — dynamic mode projects via CSS vars so shadows
-     * follow a moving light, baked mode CPU-bakes the projection into
-     * each leaf's inline `matrix3d` and drops back-facing polys from the
-     * DOM entirely. Defaults: `{ color: "#000000", opacity: 0.25, lift: 0.05, maxExtend: 2000 }`.
+     * lighting modes. Shadows emit as SVG paths and reproject when light,
+     * ground, or mesh geometry changes. Defaults:
+     * `{ color: "#000000", opacity: 0.25, lift: 0.05, maxExtend: 2000 }`.
      */
     shadow?: ShadowOptions;
     className?: string;
@@ -426,6 +421,14 @@ interface PolyMeshProps extends TransformProps, InteractionProps {
     mtl?: string;
     /** Pre-parsed polygons. Mutually exclusive with `src`. */
     polygons?: Polygon[];
+    /** Optional `parseResult.voxelSource` companion for `.vox` meshes. When
+     *  set alongside `polygons`, the direct voxel renderer fast path activates
+     *  — emitting one `<b>` per visible voxel quad inside `.polycss-voxel-face`
+     *  wrappers (matches vanilla's `scene.add(parseResult)` behaviour).
+     *  Callers fetching via core's `loadMesh()` pass `parseResult.voxelSource`
+     *  here so the fast path engages; callers fetching via PolyMesh's `src`
+     *  prop get the same data wired through `useMesh` automatically. */
+    voxelSource?: _layoutit_polycss_core.ParseResult["voxelSource"];
     /** Translate so mesh's bbox center is at local origin before applying `position`. */
     autoCenter?: boolean;
     /** Textured polygon lighting mode. Defaults to "baked". */
@@ -437,6 +440,15 @@ interface PolyMeshProps extends TransformProps, InteractionProps {
     textureQuality?: TextureQuality;
     /** Solid seam overscan. `"auto"` computes a fitted per-edge amount from the polygon plan. */
     seamBleed?: PolySeamBleed;
+    /**
+     * Hold the whole previous frame (geometry + texture) until the next atlas is
+     * decoded, then swap atomically — so a geometry edit never shows geometry
+     * before its texture. Best when edits arrive as discrete commits (no
+     * continuous drag). Defaults to false (bitmap streams in over live geometry).
+     */
+    atomicAtlas?: boolean;
+    /** Fires when the displayed atlas frame swaps to a ready one (atomic mode). */
+    onFrameReady?: () => void;
     /** Per-polygon override render, or static children mounted inside the mesh wrapper. */
     children?: ((polygon: Polygon, index: number) => ReactNode) | ReactNode;
     /** Loading slot — rendered while `src` is being fetched/parsed. */
@@ -450,18 +462,62 @@ interface PolyMeshProps extends TransformProps, InteractionProps {
      *  when both are present. */
     meshResolution?: MeshResolution;
     /**
-     * When `true` and the scene is in dynamic lighting mode, emits a flat
-     * shadow leaf (`<q class="polycss-shadow">`) sibling for each polygon.
-     * The shadow is projected onto the ground plane along the CSS-space light
-     * direction via `--shadow-proj` (a CSS var on the scene root). Zero JS in
-     * the render loop — projection is pure `calc()`. Defaults to `false`.
+     * When `true`, emits a per-mesh SVG shadow path in both lighting modes.
+     * Each casting polygon projects onto the scene ground plane along the
+     * directional light; overlapping outlines are merged into one silhouette.
+     * Defaults to `false`.
      */
     castShadow?: boolean;
+    /**
+     * When `true`, this mesh acts as a shadow receiver. The scene's caster
+     * meshes (those with `castShadow=true`) project per-coplanar-face SVG
+     * shadows onto each visible surface of this mesh, matching Three.js's
+     * `mesh.receiveShadow` semantics. Disables the ground-shadow fallback
+     * for caster meshes — receivers handle shadow display. Defaults to `false`.
+     */
+    receiveShadow?: boolean;
+    /**
+     * Apply mesh optimization (coplanar merge + interior cull) before
+     * rendering. Defaults to `true` — matches vanilla `scene.add`'s default.
+     * Set `false` for helper meshes (axes, light markers) whose geometry
+     * shouldn't be merged, or when the imperative `updatePolygon` API needs
+     * polygon refs to survive across updates.
+     */
+    merge?: boolean;
     className?: string;
     style?: CSSProperties;
 }
 declare const PolyMesh: React$1.ForwardRefExoticComponent<PolyMeshProps & React$1.RefAttributes<PolyMeshHandle>>;
 
+interface PolyIframeProps {
+    /** Iframe URL — forwarded to the underlying <iframe>'s `src` attribute. */
+    src: string;
+    /** Width in world units (multiplied by BASE_TILE for CSS px). */
+    width: number;
+    /** Height in world units (multiplied by BASE_TILE for CSS px). */
+    height: number;
+    /** World-units position (+X right, +Y forward, +Z up). */
+    position?: Vec3;
+    /** World Euler XYZ in degrees. */
+    rotation?: Vec3;
+    /** Uniform scale (number) or per-axis Vec3. */
+    scale?: number | Vec3;
+    /** Forwarded to the underlying <iframe>'s `allow`. */
+    allow?: string;
+    /** Forwarded to the underlying <iframe>'s `sandbox`. */
+    sandbox?: string;
+    /** Forwarded to the underlying <iframe>'s `loading`. */
+    loading?: IframeHTMLAttributes<HTMLIFrameElement>["loading"];
+    /** Forwarded to the underlying <iframe>'s `referrerpolicy`. */
+    referrerPolicy?: IframeHTMLAttributes<HTMLIFrameElement>["referrerPolicy"];
+    /** Forwarded to the underlying <iframe>'s `title` (a11y label). */
+    title?: string;
+    className?: string;
+    /** Style overrides on the wrapper div (NOT on the iframe). */
+    style?: CSSProperties;
+}
+declare function PolyIframe({ src, width, height, position, rotation, scale, allow, sandbox, loading, referrerPolicy, title, className, style, }: PolyIframeProps): react_jsx_runtime.JSX.Element;
+
 interface PolyGroundProps {
     /** Side length of the ground quad in world units. Default `6`. */
     size?: number;
@@ -469,8 +525,8 @@ interface PolyGroundProps {
     z?: number;
     /** World-space XY center. Default `[0, 0]`. */
     center?: [number, number];
-    /** Fill color. Default `#7d848e` — medium gray, chosen so the 25% black
-     *  `<q>` shadow leaves on top have visible contrast against it. */
+    /** Fill color. Default `#7d848e` — medium gray, chosen so the default
+     *  25% black SVG shadow has visible contrast against it. */
     color?: string;
     className?: string;
 }
@@ -491,7 +547,7 @@ interface UseSceneContextResult {
  *   normalizePolygons → mergePolygons by default → bbox compute.
  *
  * Returns the processed polygons + the scene-wide axis-aligned bbox. Memoized
- * on input identity + the few options that affect output. Per §Design.6.
+ * on input identity + the few options that affect output.
  */
 declare function usePolySceneContext(polygons: Polygon[], options: UseSceneContextOptions): UseSceneContextResult;
 
@@ -512,11 +568,12 @@ declare function usePolyMaterial(options: {
 }): PolyMaterial;
 
 /**
- * Poly — renders one polygon as an atlas-backed DOM sprite.
+ * Poly — renders one polygon as a render-strategy DOM leaf.
  *
  * Public API: `{ vertices, color?, texture?, uvs?, data? }` plus DOM
- * passthrough props. The atlas renderer handles both textured and solid-color
- * faces, so `<Poly>` never emits SVG in the normal render path.
+ * passthrough props. Solid faces use the cheapest supported solid strategy;
+ * textured faces use the atlas path. `<Poly>` never emits SVG in the normal
+ * render path.
  *
  * Wrapped in React.memo so parent re-renders (e.g. camera rotation updating
  * rotY state) do not re-render stable polygon children. The shallow-equality
@@ -824,10 +881,11 @@ interface PolyDirectionalLightHelperProps {
  * PolyDirectionalLightHelper — small octahedron placed along the light's
  * direction vector. Mirrors three.js's `DirectionalLightHelper`.
  *
- * `light.direction` is in CSS-pixel space (axis convention used by the
- * shader). Polygon vertices are in world space, which the renderer remaps
- * via `[v[1], v[0], v[2]]`. The helper reverses that swap so the marker
- * lands where the light visibly comes from on screen.
+ * Post-parity: both `light.direction` and `target` are in WORLD coords
+ * (`+X right, +Y forward, +Z up`), and `<PolyMesh>`'s `position` prop is
+ * also world units (the renderer applies the world→CSS axis swap +
+ * ×BASE_TILE internally). The helper just adds `dir × distance` to
+ * `target` and passes the result through.
  *
  * The octahedron is built at LOCAL origin once; the world position is
  * applied via PolyMesh's `position` prop (a CSS transform on the wrapper).
@@ -879,4 +937,4 @@ interface UsePolyAnimationResult {
 }
 declare function usePolyAnimation(clips: PolyAnimationClip[] | undefined, controller: ParseAnimationController | undefined, root?: RefObject<PolyAnimationTarget | null> | PolyAnimationTarget | null): UsePolyAnimationResult;
 
-export { type DOMPassthroughProps, type InteractionProps, Poly, PolyAxesHelper, type PolyAxesHelperProps, PolyBox, type PolyBoxProps, PolyOrthographicCamera as PolyCamera, PolyCameraContext, type PolyCameraContextValue, type PolyOrthographicCameraProps as PolyCameraProps, PolyCone, type PolyConeProps, type PolyControlsAnimateOptions, type PolyControlsCamera, PolyCylinder, type PolyCylinderProps, PolyDirectionalLightHelper, type PolyDirectionalLightHelperProps, PolyDodecahedron, type PolyDodecahedronProps, type PolyEventHandler, PolyFirstPersonControls, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyFirstPersonControlsProps, PolyGround, type PolyGroundProps, PolyIcosahedron, type PolyIcosahedronProps, PolyMapControls, type PolyControlsCamera as PolyMapControlsCamera, type PolyMapControlsProps, PolyMesh, type PolyMeshHandle, type PolyMeshProps, type PolyMouseEvent, PolyOctahedron, type PolyOctahedronProps, PolyOrbitControls, type PolyControlsCamera as PolyOrbitControlsCamera, type PolyOrbitControlsProps, PolyOrthographicCamera, type PolyOrthographicCameraProps, PolyPerspectiveCamera, type PolyPerspectiveCameraProps, PolyPlane, type PolyPlaneProps, type PolyPointerEvent, type PolyProps, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolyRing, type PolyRingProps, PolyScene, type PolySceneProps, PolySelect, type PolySelectProps, type PolySelectionApi, PolySphere, type PolySphereProps, PolyTetrahedron, type PolyTetrahedronProps, PolyTorus, type PolyTorusProps, PolyTransformControls, type PolyTransformControlsObject, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsProps, type PolyWheelEvent, type SharedControlsProps, type TransformProps, type UseCameraOptions, type UseCameraResult, type UseMeshOptions, type UseMeshResult, type UsePolyAnimationResult, type UseSceneContextOptions, type UseSceneContextResult, collectPolyRenderStats, findMeshUnderPoint, findPolyMeshHandle, injectPolyBaseStyles, pointInMeshElement, useCameraContext, usePolyAnimation, usePolyCamera, usePolyMaterial, usePolyMesh, usePolySceneContext, usePolySelect, usePolySelectionApi };
+export { type DOMPassthroughProps, type InteractionProps, Poly, PolyAxesHelper, type PolyAxesHelperProps, PolyBox, type PolyBoxProps, PolyOrthographicCamera as PolyCamera, PolyCameraContext, type PolyCameraContextValue, type PolyOrthographicCameraProps as PolyCameraProps, PolyCone, type PolyConeProps, type PolyControlsAnimateOptions, type PolyControlsCamera, PolyCylinder, type PolyCylinderProps, PolyDirectionalLightHelper, type PolyDirectionalLightHelperProps, PolyDodecahedron, type PolyDodecahedronProps, type PolyEventHandler, PolyFirstPersonControls, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyFirstPersonControlsProps, PolyGround, type PolyGroundProps, PolyIcosahedron, type PolyIcosahedronProps, PolyIframe, type PolyIframeProps, PolyMapControls, type PolyControlsCamera as PolyMapControlsCamera, type PolyMapControlsProps, PolyMesh, type PolyMeshHandle, type PolyMeshProps, type PolyMouseEvent, PolyOctahedron, type PolyOctahedronProps, PolyOrbitControls, type PolyControlsCamera as PolyOrbitControlsCamera, type PolyOrbitControlsProps, PolyOrthographicCamera, type PolyOrthographicCameraProps, PolyPerspectiveCamera, type PolyPerspectiveCameraProps, PolyPlane, type PolyPlaneProps, type PolyPointerEvent, type PolyProps, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolyRing, type PolyRingProps, PolyScene, type PolySceneProps, PolySelect, type PolySelectProps, type PolySelectionApi, PolySphere, type PolySphereProps, PolyTetrahedron, type PolyTetrahedronProps, PolyTorus, type PolyTorusProps, PolyTransformControls, type PolyTransformControlsObject, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsProps, type PolyWheelEvent, type SharedControlsProps, type TransformProps, type UseCameraOptions, type UseCameraResult, type UseMeshOptions, type UseMeshResult, type UsePolyAnimationResult, type UseSceneContextOptions, type UseSceneContextResult, collectPolyRenderStats, findMeshUnderPoint, findPolyMeshHandle, injectPolyBaseStyles, pointInMeshElement, useCameraContext, usePolyAnimation, usePolyCamera, usePolyMaterial, usePolyMesh, usePolySceneContext, usePolySelect, usePolySelectionApi };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as React$1 from 'react';
-import React__default, { ReactNode, CSSProperties, MouseEventHandler, PointerEventHandler, FocusEventHandler, KeyboardEventHandler, RefObject, MouseEvent as MouseEvent$1 } from 'react';
+import React__default, { ReactNode, CSSProperties, MouseEventHandler, PointerEventHandler, FocusEventHandler, KeyboardEventHandler, IframeHTMLAttributes, RefObject, MouseEvent as MouseEvent$1 } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _layoutit_polycss_core from '@layoutit/polycss-core';
 import { Vec3, CameraState, CameraHandle, Vec2, PolyMaterial, PolyDirectionalLight, PolyTextureLightingMode, TextureQuality, Polygon, PolyAmbientLight, PolySeamBleed, PolyRenderStrategiesOption, LoadMeshOptions, ParseResult, MeshResolution, BoxPolygonsOptions, ConePolygonsOptions, CylinderPolygonsOptions, DodecahedronPolygonsOptions, IcosahedronPolygonsOptions, OctahedronPolygonsOptions, PlanePolygonsOptions, RingPolygonsOptions, SpherePolygonsOptions, TetrahedronPolygonsOptions, TorusPolygonsOptions, PolyAnimationTarget, PolyAnimationMixer, PolyAnimationClip, PolyAnimationAction, ParseAnimationController } from '@layoutit/polycss-core';
-export { ArrowPolygonsOptions, AutoRotateConfig, AutoRotateOption, AxesHelperOptions, BASE_TILE, BoxFace, BoxFaceOptions, BoxPolygonsOptions, CAMERA_BACKFACE_CULL_EPS, CameraCullNormalGroup, CameraCullRotation, CameraHandle, CameraState, CameraStyleInput, ConePolygonsOptions, CoverPlanarPolygonsOptions, CullInteriorOptions, CylinderPolygonsOptions, DEFAULT_CAMERA_STATE, DEFAULT_PROJECTION, DEFAULT_SEAM_FACET_SPLIT_OPTIONS, DEFAULT_SEAM_OVERLAP_OPTIONS, DodecahedronPolygonsOptions, GltfParseOptions, IcosahedronPolygonsOptions, LoadMeshOptions, LoopMode, LoopOnce, LoopPingPong, LoopRepeat, MeshResolution, MtlParseResult, NormalizeResult, ObjParseOptions, OctahedronPolygonsOptions, OptimizeAnimatedMeshPolygonsOptions, OptimizeMeshPolygonsOptions, ParseAnimationClip, ParseAnimationController, ParseResult, ParsedColor, PlanePolygonsOptions, PolyAmbientLight, PolyAnimationAction, PolyAnimationClip, PolyAnimationMixer, PolyAnimationTarget, PolyDirectionalLight, PolyMaterial, PolyRenderStrategiesOption, PolyRenderStrategy, PolyTextureLightingMode, Polygon, PolygonFace, RingPolygonsOptions, SceneBbox, SceneContext, SceneContextBuildArgs, SceneContextBuildResult, SeamFacetSplitCandidate, SeamFacetSplitCandidateReason, SeamFacetSplitOptions, SeamFacetSplitReport, SeamOverlapCandidate, SeamOverlapCandidateKind, SeamOverlapDiagnostics, SeamOverlapOptions, SolidTextureSampleOptions, TetrahedronPolygonsOptions, TexturePaintMetrics, TexturePaintMetricsOptions, TextureTriangle, TorusPolygonsOptions, VOXEL_CAMERA_CULL_AXIS_EPS, VOXEL_CAMERA_CULL_NORMAL_LIMIT, Vec2, Vec3, VoxParseOptions, arrowPolygons, axesHelperPolygons, bakeSolidTextureSampledPolygons, bakeSolidTextureSamples, boxPolygons, buildSceneContext, cameraCullNormalGroups, cameraCullNormalGroupsFromPolygons, cameraCullNormalKey, cameraCullVisibleSignature, cameraFacingDepth, clampChannel, computeSceneBbox, computeShapeLighting, computeTexturePaintMetrics, conePolygons, coverPlanarPolygons, createIsometricCamera, createPolyAnimationMixer, cullInteriorPolygons, cylinderPolygons, dodecahedronPolygons, formatColor, icosahedronPolygons, inverseRotateVec3, isAxisAlignedSurfaceNormal, isVoxelCameraCullableNormalGroups, loadMesh, mergePolygons, normalFacesCamera, normalizeInvertMultiplier, normalizePolygons, octahedronPolygons, optimizeAnimatedMeshPolygons, optimizeMeshPolygons, parseColor, parseGltf, parseHexColor, parseMtl, parseObj, parsePureColor, parseRgbColor, parseVox, planePolygons, polygonCssSurfaceNormal, polygonFaces, polygonFacesCamera, repairMeshSeams, ringPolygons, rotateVec3, seamFacetSplitPolygons, seamFacetSplitReport, seamOverlapDiagnostics, seamOverlapPolygons, seamOverlapReport, shadeColor, tetrahedronPolygons, torusPolygons } from '@layoutit/polycss-core';
+export { ArrowPolygonsOptions, AutoRotateConfig, AutoRotateOption, AxesHelperOptions, BASE_TILE, BoxFace, BoxFaceOptions, BoxPolygonsOptions, CAMERA_BACKFACE_CULL_EPS, CameraCullNormalGroup, CameraCullRotation, CameraHandle, CameraState, CameraStyleInput, ConePolygonsOptions, CoverPlanarPolygonsOptions, CullInteriorOptions, CylinderPolygonsOptions, DEFAULT_CAMERA_STATE, DEFAULT_PROJECTION, DEFAULT_SEAM_FACET_SPLIT_OPTIONS, DEFAULT_SEAM_OVERLAP_OPTIONS, DodecahedronPolygonsOptions, GltfParseOptions, IcosahedronPolygonsOptions, LoadMeshOptions, LoopMode, LoopOnce, LoopPingPong, LoopRepeat, MeshResolution, MtlParseResult, NormalizeResult, ObjParseOptions, OctahedronPolygonsOptions, OptimizeAnimatedMeshPolygonsOptions, OptimizeMeshParseResultOptions, OptimizeMeshPolygonsOptions, ParseAnimationClip, ParseAnimationController, ParseResult, ParseStlColor, ParseStlSolid, ParseStlTopology, ParsedColor, PlanePolygonsOptions, PolyAmbientLight, PolyAnimationAction, PolyAnimationClip, PolyAnimationMixer, PolyAnimationTarget, PolyDirectionalLight, PolyMaterial, PolyMeshTransformInput, PolyRenderStrategiesOption, PolyRenderStrategy, PolyTextureLightingMode, Polygon, PolygonFace, RingPolygonsOptions, SceneBbox, SceneContext, SceneContextBuildArgs, SceneContextBuildResult, SeamFacetSplitCandidate, SeamFacetSplitCandidateReason, SeamFacetSplitOptions, SeamFacetSplitReport, SeamOverlapCandidate, SeamOverlapCandidateKind, SeamOverlapDiagnostics, SeamOverlapOptions, SimplifyTriangleMeshPolygonsOptions, SolidTextureSampleOptions, StlParseOptions, TetrahedronPolygonsOptions, TexturePaintMetrics, TexturePaintMetricsOptions, TextureTriangle, TorusPolygonsOptions, VOXEL_CAMERA_CULL_AXIS_EPS, VOXEL_CAMERA_CULL_NORMAL_LIMIT, Vec2, Vec3, VoxParseOptions, arrowPolygons, axesHelperPolygons, bakeSolidTextureSampledPolygons, bakeSolidTextureSamples, boxPolygons, buildPolyMeshTransform, buildSceneContext, cameraCullNormalGroups, cameraCullNormalGroupsFromPolygons, cameraCullNormalKey, cameraCullVisibleSignature, cameraFacingDepth, clampChannel, computeSceneBbox, computeShapeLighting, computeTexturePaintMetrics, conePolygons, coverPlanarPolygons, createIsometricCamera, createPolyAnimationMixer, cullInteriorPolygons, cylinderPolygons, dodecahedronPolygons, formatColor, icosahedronPolygons, inverseRotateVec3, isAxisAlignedSurfaceNormal, isVoxelCameraCullableNormalGroups, loadMesh, mergePolygons, normalFacesCamera, normalizeInvertMultiplier, normalizePolygons, octahedronPolygons, optimizeAnimatedMeshPolygons, optimizeMeshParseResult, optimizeMeshPolygons, parseColor, parseGltf, parseHexColor, parseMtl, parseObj, parsePureColor, parseRgbColor, parseStl, parseVox, planePolygons, polygonCssSurfaceNormal, polygonFaces, polygonFacesCamera, repairMeshSeams, ringPolygons, rotateVec3, seamFacetSplitPolygons, seamFacetSplitReport, seamOverlapDiagnostics, seamOverlapPolygons, seamOverlapReport, shadeColor, simplifyTriangleMeshPolygons, tetrahedronPolygons, torusPolygons, worldDirectionToCss as worldDirectionToPolyCss, worldPositionToCss as worldPositionToPolyCss } from '@layoutit/polycss-core';
 
 interface PolyPerspectiveCameraProps {
     zoom?: number;
@@ -11,7 +12,7 @@ interface PolyPerspectiveCameraProps {
     rotY?: number;
     /** Camera pull-back in CSS pixels (dolly). Default 0. */
     distance?: number;
-    /** CSS perspective distance in pixels. Defaults to 8000. */
+    /** CSS perspective distance in pixels. Defaults to 32000. */
     perspective?: number;
     children?: ReactNode;
     className?: string;
@@ -117,12 +118,7 @@ interface ShadowOptions {
     maxExtend?: number;
 }
 
-/**
- * Three.js-style transform props accepted by every polycss component.
- * In Phase 3, position/scale/rotation are accepted but not yet applied —
- * the rendered transform comes from vertices in scene-root space.
- * Phase 4 wires these into the matrix3d composition with parent PolyMesh.
- */
+/** Three.js-style transform props accepted by every PolyCSS component. */
 interface TransformProps {
     position?: Vec3;
     scale?: number | Vec3;
@@ -130,7 +126,7 @@ interface TransformProps {
 }
 /**
  * DOM event handlers, ARIA, and style props forwarded to the rendered
- * element (atlas-backed <div>) by every Poly component.
+ * element by every Poly component.
  *
  * This is the DOM-native pitch: polygons are real DOM nodes you can
  * target with CSS, attach event handlers to, and inspect in DevTools.
@@ -162,7 +158,7 @@ interface DOMPassthroughProps {
  * Props for the `<Poly>` component — the atomic polygon primitive.
  *
  * Extends TransformProps + DOMPassthroughProps with the polygon's own fields.
- * This is the canonical polycss v0.1.0 Poly component API per §API freeze.
+ * This is the canonical Poly component API.
  */
 interface PolyProps extends TransformProps, DOMPassthroughProps {
     vertices: Vec3[];
@@ -243,10 +239,9 @@ interface PolySceneProps extends TransformProps {
     autoCenter?: boolean;
     /**
      * Shadow appearance for meshes with `castShadow={true}`. Works in both
-     * lighting modes — dynamic mode projects via CSS vars so shadows
-     * follow a moving light, baked mode CPU-bakes the projection into
-     * each leaf's inline `matrix3d` and drops back-facing polys from the
-     * DOM entirely. Defaults: `{ color: "#000000", opacity: 0.25, lift: 0.05, maxExtend: 2000 }`.
+     * lighting modes. Shadows emit as SVG paths and reproject when light,
+     * ground, or mesh geometry changes. Defaults:
+     * `{ color: "#000000", opacity: 0.25, lift: 0.05, maxExtend: 2000 }`.
      */
     shadow?: ShadowOptions;
     className?: string;
@@ -426,6 +421,14 @@ interface PolyMeshProps extends TransformProps, InteractionProps {
     mtl?: string;
     /** Pre-parsed polygons. Mutually exclusive with `src`. */
     polygons?: Polygon[];
+    /** Optional `parseResult.voxelSource` companion for `.vox` meshes. When
+     *  set alongside `polygons`, the direct voxel renderer fast path activates
+     *  — emitting one `<b>` per visible voxel quad inside `.polycss-voxel-face`
+     *  wrappers (matches vanilla's `scene.add(parseResult)` behaviour).
+     *  Callers fetching via core's `loadMesh()` pass `parseResult.voxelSource`
+     *  here so the fast path engages; callers fetching via PolyMesh's `src`
+     *  prop get the same data wired through `useMesh` automatically. */
+    voxelSource?: _layoutit_polycss_core.ParseResult["voxelSource"];
     /** Translate so mesh's bbox center is at local origin before applying `position`. */
     autoCenter?: boolean;
     /** Textured polygon lighting mode. Defaults to "baked". */
@@ -437,6 +440,15 @@ interface PolyMeshProps extends TransformProps, InteractionProps {
     textureQuality?: TextureQuality;
     /** Solid seam overscan. `"auto"` computes a fitted per-edge amount from the polygon plan. */
     seamBleed?: PolySeamBleed;
+    /**
+     * Hold the whole previous frame (geometry + texture) until the next atlas is
+     * decoded, then swap atomically — so a geometry edit never shows geometry
+     * before its texture. Best when edits arrive as discrete commits (no
+     * continuous drag). Defaults to false (bitmap streams in over live geometry).
+     */
+    atomicAtlas?: boolean;
+    /** Fires when the displayed atlas frame swaps to a ready one (atomic mode). */
+    onFrameReady?: () => void;
     /** Per-polygon override render, or static children mounted inside the mesh wrapper. */
     children?: ((polygon: Polygon, index: number) => ReactNode) | ReactNode;
     /** Loading slot — rendered while `src` is being fetched/parsed. */
@@ -450,18 +462,62 @@ interface PolyMeshProps extends TransformProps, InteractionProps {
      *  when both are present. */
     meshResolution?: MeshResolution;
     /**
-     * When `true` and the scene is in dynamic lighting mode, emits a flat
-     * shadow leaf (`<q class="polycss-shadow">`) sibling for each polygon.
-     * The shadow is projected onto the ground plane along the CSS-space light
-     * direction via `--shadow-proj` (a CSS var on the scene root). Zero JS in
-     * the render loop — projection is pure `calc()`. Defaults to `false`.
+     * When `true`, emits a per-mesh SVG shadow path in both lighting modes.
+     * Each casting polygon projects onto the scene ground plane along the
+     * directional light; overlapping outlines are merged into one silhouette.
+     * Defaults to `false`.
      */
     castShadow?: boolean;
+    /**
+     * When `true`, this mesh acts as a shadow receiver. The scene's caster
+     * meshes (those with `castShadow=true`) project per-coplanar-face SVG
+     * shadows onto each visible surface of this mesh, matching Three.js's
+     * `mesh.receiveShadow` semantics. Disables the ground-shadow fallback
+     * for caster meshes — receivers handle shadow display. Defaults to `false`.
+     */
+    receiveShadow?: boolean;
+    /**
+     * Apply mesh optimization (coplanar merge + interior cull) before
+     * rendering. Defaults to `true` — matches vanilla `scene.add`'s default.
+     * Set `false` for helper meshes (axes, light markers) whose geometry
+     * shouldn't be merged, or when the imperative `updatePolygon` API needs
+     * polygon refs to survive across updates.
+     */
+    merge?: boolean;
     className?: string;
     style?: CSSProperties;
 }
 declare const PolyMesh: React$1.ForwardRefExoticComponent<PolyMeshProps & React$1.RefAttributes<PolyMeshHandle>>;
 
+interface PolyIframeProps {
+    /** Iframe URL — forwarded to the underlying <iframe>'s `src` attribute. */
+    src: string;
+    /** Width in world units (multiplied by BASE_TILE for CSS px). */
+    width: number;
+    /** Height in world units (multiplied by BASE_TILE for CSS px). */
+    height: number;
+    /** World-units position (+X right, +Y forward, +Z up). */
+    position?: Vec3;
+    /** World Euler XYZ in degrees. */
+    rotation?: Vec3;
+    /** Uniform scale (number) or per-axis Vec3. */
+    scale?: number | Vec3;
+    /** Forwarded to the underlying <iframe>'s `allow`. */
+    allow?: string;
+    /** Forwarded to the underlying <iframe>'s `sandbox`. */
+    sandbox?: string;
+    /** Forwarded to the underlying <iframe>'s `loading`. */
+    loading?: IframeHTMLAttributes<HTMLIFrameElement>["loading"];
+    /** Forwarded to the underlying <iframe>'s `referrerpolicy`. */
+    referrerPolicy?: IframeHTMLAttributes<HTMLIFrameElement>["referrerPolicy"];
+    /** Forwarded to the underlying <iframe>'s `title` (a11y label). */
+    title?: string;
+    className?: string;
+    /** Style overrides on the wrapper div (NOT on the iframe). */
+    style?: CSSProperties;
+}
+declare function PolyIframe({ src, width, height, position, rotation, scale, allow, sandbox, loading, referrerPolicy, title, className, style, }: PolyIframeProps): react_jsx_runtime.JSX.Element;
+
 interface PolyGroundProps {
     /** Side length of the ground quad in world units. Default `6`. */
     size?: number;
@@ -469,8 +525,8 @@ interface PolyGroundProps {
     z?: number;
     /** World-space XY center. Default `[0, 0]`. */
     center?: [number, number];
-    /** Fill color. Default `#7d848e` — medium gray, chosen so the 25% black
-     *  `<q>` shadow leaves on top have visible contrast against it. */
+    /** Fill color. Default `#7d848e` — medium gray, chosen so the default
+     *  25% black SVG shadow has visible contrast against it. */
     color?: string;
     className?: string;
 }
@@ -491,7 +547,7 @@ interface UseSceneContextResult {
  *   normalizePolygons → mergePolygons by default → bbox compute.
  *
  * Returns the processed polygons + the scene-wide axis-aligned bbox. Memoized
- * on input identity + the few options that affect output. Per §Design.6.
+ * on input identity + the few options that affect output.
  */
 declare function usePolySceneContext(polygons: Polygon[], options: UseSceneContextOptions): UseSceneContextResult;
 
@@ -512,11 +568,12 @@ declare function usePolyMaterial(options: {
 }): PolyMaterial;
 
 /**
- * Poly — renders one polygon as an atlas-backed DOM sprite.
+ * Poly — renders one polygon as a render-strategy DOM leaf.
  *
  * Public API: `{ vertices, color?, texture?, uvs?, data? }` plus DOM
- * passthrough props. The atlas renderer handles both textured and solid-color
- * faces, so `<Poly>` never emits SVG in the normal render path.
+ * passthrough props. Solid faces use the cheapest supported solid strategy;
+ * textured faces use the atlas path. `<Poly>` never emits SVG in the normal
+ * render path.
  *
  * Wrapped in React.memo so parent re-renders (e.g. camera rotation updating
  * rotY state) do not re-render stable polygon children. The shallow-equality
@@ -824,10 +881,11 @@ interface PolyDirectionalLightHelperProps {
  * PolyDirectionalLightHelper — small octahedron placed along the light's
  * direction vector. Mirrors three.js's `DirectionalLightHelper`.
  *
- * `light.direction` is in CSS-pixel space (axis convention used by the
- * shader). Polygon vertices are in world space, which the renderer remaps
- * via `[v[1], v[0], v[2]]`. The helper reverses that swap so the marker
- * lands where the light visibly comes from on screen.
+ * Post-parity: both `light.direction` and `target` are in WORLD coords
+ * (`+X right, +Y forward, +Z up`), and `<PolyMesh>`'s `position` prop is
+ * also world units (the renderer applies the world→CSS axis swap +
+ * ×BASE_TILE internally). The helper just adds `dir × distance` to
+ * `target` and passes the result through.
  *
  * The octahedron is built at LOCAL origin once; the world position is
  * applied via PolyMesh's `position` prop (a CSS transform on the wrapper).
@@ -879,4 +937,4 @@ interface UsePolyAnimationResult {
 }
 declare function usePolyAnimation(clips: PolyAnimationClip[] | undefined, controller: ParseAnimationController | undefined, root?: RefObject<PolyAnimationTarget | null> | PolyAnimationTarget | null): UsePolyAnimationResult;
 
-export { type DOMPassthroughProps, type InteractionProps, Poly, PolyAxesHelper, type PolyAxesHelperProps, PolyBox, type PolyBoxProps, PolyOrthographicCamera as PolyCamera, PolyCameraContext, type PolyCameraContextValue, type PolyOrthographicCameraProps as PolyCameraProps, PolyCone, type PolyConeProps, type PolyControlsAnimateOptions, type PolyControlsCamera, PolyCylinder, type PolyCylinderProps, PolyDirectionalLightHelper, type PolyDirectionalLightHelperProps, PolyDodecahedron, type PolyDodecahedronProps, type PolyEventHandler, PolyFirstPersonControls, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyFirstPersonControlsProps, PolyGround, type PolyGroundProps, PolyIcosahedron, type PolyIcosahedronProps, PolyMapControls, type PolyControlsCamera as PolyMapControlsCamera, type PolyMapControlsProps, PolyMesh, type PolyMeshHandle, type PolyMeshProps, type PolyMouseEvent, PolyOctahedron, type PolyOctahedronProps, PolyOrbitControls, type PolyControlsCamera as PolyOrbitControlsCamera, type PolyOrbitControlsProps, PolyOrthographicCamera, type PolyOrthographicCameraProps, PolyPerspectiveCamera, type PolyPerspectiveCameraProps, PolyPlane, type PolyPlaneProps, type PolyPointerEvent, type PolyProps, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolyRing, type PolyRingProps, PolyScene, type PolySceneProps, PolySelect, type PolySelectProps, type PolySelectionApi, PolySphere, type PolySphereProps, PolyTetrahedron, type PolyTetrahedronProps, PolyTorus, type PolyTorusProps, PolyTransformControls, type PolyTransformControlsObject, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsProps, type PolyWheelEvent, type SharedControlsProps, type TransformProps, type UseCameraOptions, type UseCameraResult, type UseMeshOptions, type UseMeshResult, type UsePolyAnimationResult, type UseSceneContextOptions, type UseSceneContextResult, collectPolyRenderStats, findMeshUnderPoint, findPolyMeshHandle, injectPolyBaseStyles, pointInMeshElement, useCameraContext, usePolyAnimation, usePolyCamera, usePolyMaterial, usePolyMesh, usePolySceneContext, usePolySelect, usePolySelectionApi };
+export { type DOMPassthroughProps, type InteractionProps, Poly, PolyAxesHelper, type PolyAxesHelperProps, PolyBox, type PolyBoxProps, PolyOrthographicCamera as PolyCamera, PolyCameraContext, type PolyCameraContextValue, type PolyOrthographicCameraProps as PolyCameraProps, PolyCone, type PolyConeProps, type PolyControlsAnimateOptions, type PolyControlsCamera, PolyCylinder, type PolyCylinderProps, PolyDirectionalLightHelper, type PolyDirectionalLightHelperProps, PolyDodecahedron, type PolyDodecahedronProps, type PolyEventHandler, PolyFirstPersonControls, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyFirstPersonControlsProps, PolyGround, type PolyGroundProps, PolyIcosahedron, type PolyIcosahedronProps, PolyIframe, type PolyIframeProps, PolyMapControls, type PolyControlsCamera as PolyMapControlsCamera, type PolyMapControlsProps, PolyMesh, type PolyMeshHandle, type PolyMeshProps, type PolyMouseEvent, PolyOctahedron, type PolyOctahedronProps, PolyOrbitControls, type PolyControlsCamera as PolyOrbitControlsCamera, type PolyOrbitControlsProps, PolyOrthographicCamera, type PolyOrthographicCameraProps, PolyPerspectiveCamera, type PolyPerspectiveCameraProps, PolyPlane, type PolyPlaneProps, type PolyPointerEvent, type PolyProps, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolyRing, type PolyRingProps, PolyScene, type PolySceneProps, PolySelect, type PolySelectProps, type PolySelectionApi, PolySphere, type PolySphereProps, PolyTetrahedron, type PolyTetrahedronProps, PolyTorus, type PolyTorusProps, PolyTransformControls, type PolyTransformControlsObject, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsProps, type PolyWheelEvent, type SharedControlsProps, type TransformProps, type UseCameraOptions, type UseCameraResult, type UseMeshOptions, type UseMeshResult, type UsePolyAnimationResult, type UseSceneContextOptions, type UseSceneContextResult, collectPolyRenderStats, findMeshUnderPoint, findPolyMeshHandle, injectPolyBaseStyles, pointInMeshElement, useCameraContext, usePolyAnimation, usePolyCamera, usePolyMaterial, usePolyMesh, usePolySceneContext, usePolySelect, usePolySelectionApi };