@layoutit/polycss 0.2.6 → 0.2.7

package/README.md

@@ -69,7 +69,7 @@ export default function App() {
 ### PolyScene
 
 - `polygons` renders a static `Polygon[]` directly.
-- `directionalLight` and `ambientLight` control scene lighting.
+- `directionalLight`, `pointLights` (direction-only, baked mode; optional per-light `castShadow`), and `ambientLight` control scene lighting.
 - `textureLighting` chooses `"baked"` or `"dynamic"`.
 - `textureQuality` controls atlas raster budget.
 - `strategies` can disable selected render strategies for diagnostics.
@@ -84,7 +84,6 @@ export default function App() {
 - `autoCenter` shifts the mesh bbox center to local origin.
 - `meshResolution` chooses `"lossy"` (default) or `"lossless"` optimization. STL imports use the conservative lossless path in both modes.
 - `castShadow` emits CSS-projected shadows in dynamic lighting mode.
-- Tooling can reuse `buildPolyMeshTransform`, `buildPolySceneTransform`, `worldPositionToPolyCss`, `worldDirectionToPolyCss`, `worldDirectionalLightToPolyCss`, `worldDistanceToPolyCss`, `polyCssDistanceToWorld`, and `polyCssPositionToWorld` for renderer-compatible transforms and world/CSS conversions.
 
 ### Controls
 

package/dist/{PolyShapeElements-YDkJX2Fz.d.cts → PolyShapeElements-LEK_aL9q.d.cts}

@@ -1,4 +1,4 @@
-import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolyTextureLeafSizing, PolyTextureImageRendering, PolyTextureBackend, PolyTextureProjection, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
+import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyPointLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolyTextureLeafSizing, PolyTextureImageRendering, PolyTextureBackend, PolyTextureProjection, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
 
 interface PolyCameraOptions {
     zoom?: number;
@@ -61,6 +61,9 @@ interface PolySceneOptions {
      */
     camera: PolyPerspectiveCameraHandle | PolyOrthographicCameraHandle;
     directionalLight?: PolyDirectionalLight;
+    /** Point lights (world-space positions). Direction-only per-face Lambert
+     *  shading (no distance falloff). Baked-mode only. */
+    pointLights?: PolyPointLight[];
     ambientLight?: PolyAmbientLight;
     /** Textured polygon lighting mode. Defaults to "baked". */
     textureLighting?: PolyTextureLightingMode;
@@ -123,6 +126,50 @@ interface PolySceneOptions {
          * very large number (e.g. `Infinity`) to disable the cap entirely.
          */
         maxExtend?: number;
+        /**
+         * Experimental: cast a single low-resolution parametric **silhouette**
+         * outline per caster instead of projecting its full geometry. Lighter DOM
+         * + cheaper projection, at the cost of an approximate (convex) outline.
+         * Casts onto every receiver through the normal pipeline. Default: `false`.
+         */
+        parametric?: boolean;
+        /**
+         * Parametric-shadow detail: the max number of points in the silhouette
+         * outline. Lower → blobbier + lighter; higher → closer to the exact convex
+         * outline. Only used when `parametric` is true. Default: `16`.
+         *
+         * Can be overridden per mesh via `PolyMeshTransform.shadowDefinition`.
+         */
+        definition?: number;
+        /**
+         * Progressive refinement: the definition used WHILE the directional light
+         * is actively changing (a drag). When set (and `parametric` is true), each
+         * light-direction change emits at `min(definition, dragDefinition)` for a
+         * laggless drag, then a debounced pass re-emits at full `definition` once
+         * the light settles — mirroring the atlas-rebake-at-rest escape hatch.
+         * Self-shadow recompute is O(faces × bands), so dropping detail during
+         * motion is the only way to keep a complex mesh smooth. Unset → no
+         * progressive pass (every change renders at full `definition`).
+         */
+        dragDefinition?: number;
+        /**
+         * Parametric-shadow render style (only used when `parametric` is true):
+         * - `"vector"` (default) — smooth concave contour outline.
+         * - `"pixel"` — the coverage is greedy-meshed into axis-aligned rectangles,
+         *   giving a blocky/voxel shadow. Holes (courtyards, the coliseum arena)
+         *   come free as absent cells. `definition` is the pixel-grid resolution
+         *   (lower → chunkier); the block size is the aesthetic.
+         */
+        style?: "vector" | "pixel";
+        /**
+         * Re-emit shadows while a mesh is animating (skeletal/GLB deformation), so
+         * the shadow follows the pose instead of freezing at the rest pose. Each
+         * `setPolygons` from the animation loop triggers a re-projection, throttled
+         * internally (~12fps) so it stays affordable. Strongly recommended only
+         * with `parametric: true` (a low-res silhouette is cheap to reproject every
+         * few frames; the exact path is not). Default: `false`.
+         */
+        followAnimation?: boolean;
     };
     /**
      * When `true`, emit `data-poly-shadow-*` attribution attributes on every
@@ -182,6 +229,14 @@ interface PolyMeshTransform {
      * Defaults to `false`.
      */
     receiveShadow?: boolean;
+    /**
+     * Per-mesh parametric-shadow detail (overrides the scene's
+     * `shadow.definition` for THIS mesh's cast/self shadow). Lets a detailed
+     * caster stay high-resolution while a simple prop runs cheap in the same
+     * scene. Only used when `shadow.parametric` is true. Unset → inherit the
+     * scene definition.
+     */
+    shadowDefinition?: number;
 }
 interface PolyMeshHandle {
     /** The polygons that were loaded after normalization and automatic merge. */

package/dist/{PolyShapeElements-YDkJX2Fz.d.ts → PolyShapeElements-LEK_aL9q.d.ts}

@@ -1,4 +1,4 @@
-import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolyTextureLeafSizing, PolyTextureImageRendering, PolyTextureBackend, PolyTextureProjection, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
+import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyPointLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolyTextureLeafSizing, PolyTextureImageRendering, PolyTextureBackend, PolyTextureProjection, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
 
 interface PolyCameraOptions {
     zoom?: number;
@@ -61,6 +61,9 @@ interface PolySceneOptions {
      */
     camera: PolyPerspectiveCameraHandle | PolyOrthographicCameraHandle;
     directionalLight?: PolyDirectionalLight;
+    /** Point lights (world-space positions). Direction-only per-face Lambert
+     *  shading (no distance falloff). Baked-mode only. */
+    pointLights?: PolyPointLight[];
     ambientLight?: PolyAmbientLight;
     /** Textured polygon lighting mode. Defaults to "baked". */
     textureLighting?: PolyTextureLightingMode;
@@ -123,6 +126,50 @@ interface PolySceneOptions {
          * very large number (e.g. `Infinity`) to disable the cap entirely.
          */
         maxExtend?: number;
+        /**
+         * Experimental: cast a single low-resolution parametric **silhouette**
+         * outline per caster instead of projecting its full geometry. Lighter DOM
+         * + cheaper projection, at the cost of an approximate (convex) outline.
+         * Casts onto every receiver through the normal pipeline. Default: `false`.
+         */
+        parametric?: boolean;
+        /**
+         * Parametric-shadow detail: the max number of points in the silhouette
+         * outline. Lower → blobbier + lighter; higher → closer to the exact convex
+         * outline. Only used when `parametric` is true. Default: `16`.
+         *
+         * Can be overridden per mesh via `PolyMeshTransform.shadowDefinition`.
+         */
+        definition?: number;
+        /**
+         * Progressive refinement: the definition used WHILE the directional light
+         * is actively changing (a drag). When set (and `parametric` is true), each
+         * light-direction change emits at `min(definition, dragDefinition)` for a
+         * laggless drag, then a debounced pass re-emits at full `definition` once
+         * the light settles — mirroring the atlas-rebake-at-rest escape hatch.
+         * Self-shadow recompute is O(faces × bands), so dropping detail during
+         * motion is the only way to keep a complex mesh smooth. Unset → no
+         * progressive pass (every change renders at full `definition`).
+         */
+        dragDefinition?: number;
+        /**
+         * Parametric-shadow render style (only used when `parametric` is true):
+         * - `"vector"` (default) — smooth concave contour outline.
+         * - `"pixel"` — the coverage is greedy-meshed into axis-aligned rectangles,
+         *   giving a blocky/voxel shadow. Holes (courtyards, the coliseum arena)
+         *   come free as absent cells. `definition` is the pixel-grid resolution
+         *   (lower → chunkier); the block size is the aesthetic.
+         */
+        style?: "vector" | "pixel";
+        /**
+         * Re-emit shadows while a mesh is animating (skeletal/GLB deformation), so
+         * the shadow follows the pose instead of freezing at the rest pose. Each
+         * `setPolygons` from the animation loop triggers a re-projection, throttled
+         * internally (~12fps) so it stays affordable. Strongly recommended only
+         * with `parametric: true` (a low-res silhouette is cheap to reproject every
+         * few frames; the exact path is not). Default: `false`.
+         */
+        followAnimation?: boolean;
     };
     /**
      * When `true`, emit `data-poly-shadow-*` attribution attributes on every
@@ -182,6 +229,14 @@ interface PolyMeshTransform {
      * Defaults to `false`.
      */
     receiveShadow?: boolean;
+    /**
+     * Per-mesh parametric-shadow detail (overrides the scene's
+     * `shadow.definition` for THIS mesh's cast/self shadow). Lets a detailed
+     * caster stay high-resolution while a simple prop runs cheap in the same
+     * scene. Only used when `shadow.parametric` is true. Unset → inherit the
+     * scene definition.
+     */
+    shadowDefinition?: number;
 }
 interface PolyMeshHandle {
     /** The polygons that were loaded after normalization and automatic merge. */