@layoutit/polycss 0.2.4 → 0.2.6

package/README.md

@@ -84,7 +84,7 @@ 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`, `worldPositionToPolyCss`, `worldDirectionToPolyCss`, `worldDistanceToPolyCss`, `polyCssDistanceToWorld`, and `polyCssPositionToWorld` for renderer-compatible transforms and world/CSS conversions.
+- Tooling can reuse `buildPolyMeshTransform`, `buildPolySceneTransform`, `worldPositionToPolyCss`, `worldDirectionToPolyCss`, `worldDirectionalLightToPolyCss`, `worldDistanceToPolyCss`, `polyCssDistanceToWorld`, and `polyCssPositionToWorld` for renderer-compatible transforms and world/CSS conversions.
 
 ### Controls
 

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

@@ -1,4 +1,4 @@
-import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
+import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolyTextureLeafSizing, PolyTextureImageRendering, PolyTextureBackend, PolyTextureProjection, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
 
 interface PolyCameraOptions {
     zoom?: number;
@@ -69,6 +69,14 @@ interface PolySceneOptions {
      *  desktop/mobile sprite sizing. Numeric values 0.1..1 force an explicit
      *  raster scale and the 64px sprite. */
     textureQuality?: TextureQuality;
+    /** Texture leaf primitive sizing. Defaults to "canonical". */
+    textureLeafSizing?: PolyTextureLeafSizing;
+    /** Default image filtering for atlas and direct image texture leaves. */
+    textureImageRendering?: PolyTextureImageRendering;
+    /** Default texture backend request. Defaults to "auto". */
+    textureBackend?: PolyTextureBackend;
+    /** Default texture projection request. Defaults to "affine". */
+    textureProjection?: PolyTextureProjection;
     /** Solid seam overscan. `"auto"` computes a fitted per-edge amount from the polygon plan. */
     seamBleed?: PolySeamBleed;
     /**
@@ -229,6 +237,8 @@ interface PolyMeshHandle {
      * pointer release (or any point where you want to commit the new shading).
      */
     rebakeAtlas(): void;
+    /** Resolves when this mesh's current texture generation has usable backgrounds. */
+    whenTexturesReady(): Promise<void>;
     /** Current `position` from the transform (matches framework API). */
     getPosition(): Vec3 | undefined;
     /** Current `rotation` from the transform (matches framework API). */
@@ -284,6 +294,8 @@ interface PolySceneHandle {
     /** Snapshot of mesh handles currently in the scene (insertion order).
      *  Used by selection helpers to enumerate hit-test candidates. */
     meshes(): readonly PolyMeshHandle[];
+    /** Resolves when every mesh currently in the scene has usable texture backgrounds. */
+    whenTexturesReady(): Promise<void>;
     /** Resolve a `.polycss-mesh` element back to its handle, or `null` if
      *  the element doesn't belong to this scene. */
     findMeshByElement(element: Element | null): PolyMeshHandle | null;

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

@@ -1,4 +1,4 @@
-import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
+import { CameraHandle, Vec3, Polygon, MeshResolution, ParseResult, PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureQuality, PolyTextureLeafSizing, PolyTextureImageRendering, PolyTextureBackend, PolyTextureProjection, PolySeamBleed, PolyRenderStrategiesOption } from '@layoutit/polycss-core';
 
 interface PolyCameraOptions {
     zoom?: number;
@@ -69,6 +69,14 @@ interface PolySceneOptions {
      *  desktop/mobile sprite sizing. Numeric values 0.1..1 force an explicit
      *  raster scale and the 64px sprite. */
     textureQuality?: TextureQuality;
+    /** Texture leaf primitive sizing. Defaults to "canonical". */
+    textureLeafSizing?: PolyTextureLeafSizing;
+    /** Default image filtering for atlas and direct image texture leaves. */
+    textureImageRendering?: PolyTextureImageRendering;
+    /** Default texture backend request. Defaults to "auto". */
+    textureBackend?: PolyTextureBackend;
+    /** Default texture projection request. Defaults to "affine". */
+    textureProjection?: PolyTextureProjection;
     /** Solid seam overscan. `"auto"` computes a fitted per-edge amount from the polygon plan. */
     seamBleed?: PolySeamBleed;
     /**
@@ -229,6 +237,8 @@ interface PolyMeshHandle {
      * pointer release (or any point where you want to commit the new shading).
      */
     rebakeAtlas(): void;
+    /** Resolves when this mesh's current texture generation has usable backgrounds. */
+    whenTexturesReady(): Promise<void>;
     /** Current `position` from the transform (matches framework API). */
     getPosition(): Vec3 | undefined;
     /** Current `rotation` from the transform (matches framework API). */
@@ -284,6 +294,8 @@ interface PolySceneHandle {
     /** Snapshot of mesh handles currently in the scene (insertion order).
      *  Used by selection helpers to enumerate hit-test candidates. */
     meshes(): readonly PolyMeshHandle[];
+    /** Resolves when every mesh currently in the scene has usable texture backgrounds. */
+    whenTexturesReady(): Promise<void>;
     /** Resolve a `.polycss-mesh` element back to its handle, or `null` if
      *  the element doesn't belong to this scene. */
     findMeshByElement(element: Element | null): PolyMeshHandle | null;