@layoutit/polycss 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { P as PolySceneHandle, a as PolyMeshHandle } from './PolyShapeElements-prI_DBZX.cjs';
-export { b as PolyBoxElement, c as PolyCameraElement, d as PolyCameraOptions, e as PolyConeElement, f as PolyCylinderElement, g as PolyDodecahedronElement, h as PolyFirstPersonControlsElement, i as PolyIcosahedronElement, j as PolyMapControlsElement, k as PolyMeshElement, l as PolyMeshTransform, m as PolyOctahedronElement, n as PolyOrbitControlsElement, o as PolyOrthographicCameraElement, p as PolyOrthographicCameraHandle, q as PolyOrthographicCameraOptions, r as PolyPerspectiveCameraElement, s as PolyPerspectiveCameraHandle, t as PolyPerspectiveCameraOptions, u as PolyPlaneElement, v as PolyPolygonElement, w as PolyRingElement, x as PolySceneElement, y as PolySceneOptions, z as PolySelectElement, A as PolySphereElement, B as PolyTetrahedronElement, C as PolyTorusElement, D as PolyTransformControlsElement, E as createPolyCamera, F as createPolyOrthographicCamera, G as createPolyPerspectiveCamera, H as createPolyScene } from './PolyShapeElements-prI_DBZX.cjs';
+import { P as PolySceneOptions, a as PolySceneHandle, b as PolyControlsHandle, c as PolyControlsBaseOptions, d as PolyControlsEvent, e as PolyControlsListener, f as PolyMeshHandle } from './PolyShapeElements-CoKhApyN.cjs';
+export { g as PolyBoxElement, h as PolyCameraElement, i as PolyCameraOptions, j as PolyConeElement, k as PolyControlsAnimateOptions, l as PolyControlsCamera, m as PolyControlsChangeEvent, n as PolyControlsInteractionEvent, o as PolyCylinderElement, p as PolyDodecahedronElement, q as PolyFirstPersonControlsElement, r as PolyIcosahedronElement, s as PolyIframeElement, t as PolyMapControlsElement, u as PolyMeshElement, v as PolyMeshTransform, w as PolyOctahedronElement, x as PolyOrbitControlsElement, y as PolyOrbitControlsHandle, z as PolyOrbitControlsOptions, A as PolyOrthographicCameraElement, B as PolyOrthographicCameraHandle, C as PolyOrthographicCameraOptions, D as PolyPerspectiveCameraElement, E as PolyPerspectiveCameraHandle, F as PolyPerspectiveCameraOptions, G as PolyPlaneElement, H as PolyPolygonElement, I as PolyRingElement, J as PolySceneElement, K as PolySelectElement, L as PolySphereElement, M as PolyTetrahedronElement, N as PolyTorusElement, O as PolyTransformControlsElement, Q as createPolyCamera, R as createPolyOrbitControls, S as createPolyOrthographicCamera, T as createPolyPerspectiveCamera } from './PolyShapeElements-CoKhApyN.cjs';
 import * as _layoutit_polycss_core from '@layoutit/polycss-core';
 import { PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureAtlasPlan, TextureQuality, PackedAtlas, PackedPage, TextureAtlasPage, PolyRenderStrategy, SolidPaintDefaults, Polygon, SolidTriangleFrame, Vec3, BoxPolygonsOptions, ParseResult, ConePolygonsOptions, CylinderPolygonsOptions, DodecahedronPolygonsOptions, IcosahedronPolygonsOptions, OctahedronPolygonsOptions, PlanePolygonsOptions, RingPolygonsOptions, SpherePolygonsOptions, TetrahedronPolygonsOptions, TorusPolygonsOptions } from '@layoutit/polycss-core';
 export * from '@layoutit/polycss-core';
-export { ComputeTextureAtlasPlanOptions, PackedAtlas, PackedPage, PackedTextureAtlasEntry, PolyRenderStrategiesOption, PolyRenderStrategy, ParseResult as PolyShapeResult, SolidPaintDefaults, SolidTriangleFrame, TextureAtlasPage, TextureAtlasPlan, TextureQuality, buildTextureEdgeRepairSets, computeTextureAtlasPlanPublic, cssBorderShapeForPlan, formatBorderShapeEntryMatrix, formatCssLengthPx, formatMatrix3d, formatSolidQuadEntryMatrix, isFullRectSolid, isProjectiveQuadPlan, isSolidTrianglePlan } from '@layoutit/polycss-core';
+export { ComputeTextureAtlasPlanOptions, PackedAtlas, PackedPage, PackedTextureAtlasEntry, PolyRenderStrategiesOption, PolyRenderStrategy, ParseResult as PolyShapeResult, SolidPaintDefaults, SolidTriangleFrame, TextureAtlasPage, TextureAtlasPlan, TextureQuality, buildPolyMeshTransform, buildTextureEdgeRepairSets, computeTextureAtlasPlanPublic, cssBorderShapeForPlan, formatBorderShapeEntryMatrix, formatCssLengthPx, formatMatrix3d, formatSolidQuadEntryMatrix, isFullRectSolid, isProjectiveQuadPlan, isSolidTrianglePlan, worldDirectionToPolyCss, worldPositionToPolyCss } from '@layoutit/polycss-core';
 
 interface RenderTextureAtlasOptions {
     doc?: Document;
@@ -22,6 +22,13 @@ interface RenderTextureAtlasOptions {
     textureQuality?: _layoutit_polycss_core.TextureQuality;
     solidPaintDefaults?: _layoutit_polycss_core.SolidPaintDefaults;
     strategies?: _layoutit_polycss_core.PolyRenderStrategiesOption;
+    /**
+     * Indices of polygons that the directional light cannot reach (precomputed
+     * by createPolyScene via {@link computeLightVisibility}). Atlas + solid
+     * planning forces directScale to 0 for these polys so they render with
+     * ambient-only color, matching what a shadow-map pass would output.
+     */
+    lightOccludedPolyIndices?: ReadonlySet<number>;
 }
 interface RenderedPoly {
     polygonIndex: number;
@@ -33,6 +40,16 @@ interface RenderedPoly {
 interface RenderTextureAtlasResult {
     rendered: RenderedPoly[];
     dispose(): void;
+    /**
+     * Resolves once every textured `<s>` leaf has its `background-image`
+     * applied (i.e. the atlas canvas → Blob → URL chain has completed and
+     * the apply-bg pass has run). For meshes with no textured leaves this
+     * resolves immediately. Callers doing stale-while-revalidate swaps
+     * await this before disposing the previous render — without it, the
+     * fresh leaves mount with empty backgrounds and the prior frame's
+     * bitmaps would be needed underneath to avoid a transparent flash.
+     */
+    pagesReady?: Promise<void>;
 }
 interface RenderTextureAtlasAsyncResult extends RenderTextureAtlasResult {
     solidPaintDefaults: _layoutit_polycss_core.SolidPaintDefaults;
@@ -83,97 +100,7 @@ declare function updatePolygonsWithStableTopology(rendered: RenderedPoly[], poly
 declare function renderPolygonsWithStableTriangles(polygons: Polygon[], options?: RenderTextureAtlasOptions): RenderTextureAtlasResult | null;
 declare function updatePolygonsWithStableTriangles(rendered: RenderedPoly[], polygons: Polygon[], options?: RenderTextureAtlasOptions): RenderTextureAtlasResult | null;
 
-/**
- * Shared types, constants, and utilities for orbit/map controls factories.
- * Not part of the public API surface — use createPolyOrbitControls or
- * createPolyMapControls.
- */
-
-interface PolyControlsAnimateOptions {
-    /**
-     * Rotation rate in degrees per 60 Hz-equivalent frame. The tick is
-     * dt-clamped so 0.3 deg/frame ≈ 18 deg/sec on every refresh rate.
-     * Default: 0.3.
-     */
-    speed?: number;
-    /** Rotation axis. Default: "y" (yaw, rotates around vertical world Z). */
-    axis?: "x" | "y";
-    /** Halt the loop while a pointer drag is in progress. Default: true. */
-    pauseOnInteraction?: boolean;
-}
-interface PolyControlsBaseOptions {
-    /** Pointer-drag. Default: true. */
-    drag?: boolean;
-    /** Wheel / pinch zoom. Default: true. */
-    wheel?: boolean;
-    /**
-     * When `true`, wheel events change `distance` (camera pull-back in CSS px)
-     * instead of `zoom`. Mirrors Three.js OrbitControls dolly behaviour.
-     * Default: false (zoom mode).
-     */
-    dolly?: boolean;
-    /**
-     * Drag-direction inversion. `false` = natural, `true` = invert (×-1),
-     * a number multiplies sensitivity (negative inverts). Default: false.
-     */
-    invert?: boolean | number;
-    /** Minimum CSS zoom. Default: 0.1. */
-    minZoom?: number;
-    /** Maximum CSS zoom. Default: 10. */
-    maxZoom?: number;
-    /** Minimum dolly distance in CSS pixels. Default: 0. Only used when `dolly: true`. */
-    minDistance?: number;
-    /** Maximum dolly distance in CSS pixels. Default: Infinity. Only used when `dolly: true`. */
-    maxDistance?: number;
-    /** Auto-rotate. Pass false (or omit) to disable. */
-    animate?: false | PolyControlsAnimateOptions;
-}
-interface PolyControlsCamera {
-    rotX: number;
-    rotY: number;
-    zoom: number;
-    target: Vec3;
-    distance: number;
-}
-interface PolyControlsChangeEvent {
-    type: "change";
-    camera: PolyControlsCamera;
-}
-interface PolyControlsInteractionEvent {
-    type: "start" | "end";
-    camera: PolyControlsCamera;
-}
-type PolyControlsEvent = PolyControlsChangeEvent | PolyControlsInteractionEvent;
-type PolyControlsListener<E extends PolyControlsEvent = PolyControlsEvent> = (event: E) => void;
-interface PolyControlsHandle {
-    update(partial: PolyControlsBaseOptions): void;
-    resume(): void;
-    pause(): void;
-    destroy(): void;
-    addEventListener<T extends PolyControlsEvent["type"]>(type: T, listener: PolyControlsListener<Extract<PolyControlsEvent, {
-        type: T;
-    }>>): void;
-    removeEventListener<T extends PolyControlsEvent["type"]>(type: T, listener: PolyControlsListener<Extract<PolyControlsEvent, {
-        type: T;
-    }>>): void;
-    hasEventListener<T extends PolyControlsEvent["type"]>(type: T, listener: PolyControlsListener<Extract<PolyControlsEvent, {
-        type: T;
-    }>>): boolean;
-}
-
-/**
- * createPolyOrbitControls — orbit-mode camera input for a PolyScene.
- *
- * Left-drag rotates rotX / rotY around the target (orbit). Wheel zooms or
- * dollies. Mirrors Three.js OrbitControls semantics.
- *
- * For map/pan semantics (left-drag pans, right-drag orbits) use
- * `createPolyMapControls` instead.
- */
-
-type PolyOrbitControlsOptions = PolyControlsBaseOptions;
-type PolyOrbitControlsHandle = PolyControlsHandle;
-declare function createPolyOrbitControls(scene: PolySceneHandle, options?: PolyOrbitControlsOptions): PolyOrbitControlsHandle;
+declare function createPolyScene(host: HTMLElement, options: PolySceneOptions): PolySceneHandle;
 
 /**
  * createPolyMapControls — map/pan-mode camera input for a PolyScene.
@@ -398,6 +325,19 @@ interface PolyRenderStatsOptions {
 }
 declare function collectPolyRenderStats(root: ParentNode | null | undefined, optionsOrPolygonCount?: number | PolyRenderStatsOptions): PolyRenderStats;
 
+type PolySceneSnapshotErrorCode = "INVALID_TARGET" | "SCENE_NOT_FOUND" | "ASSET_INLINE_FAILED";
+declare class PolySceneSnapshotError extends Error {
+    readonly code: PolySceneSnapshotErrorCode;
+    readonly url?: string;
+    constructor(code: PolySceneSnapshotErrorCode, message: string, url?: string);
+}
+/**
+ * Serialize the current rendered PolyCSS DOM into a standalone HTML document.
+ * The snapshot is intentionally static: it preserves the scene's current DOM,
+ * inlines CSS image assets, and emits no scripts or PolyCSS runtime imports.
+ */
+declare function exportPolySceneSnapshot(target: Element): Promise<string>;
+
 /**
  * Primitive shape factories — thin wrappers over the polygon generators in
  * @layoutit/polycss-core. Each returns a `ParseResult`-compatible object so
@@ -418,4 +358,4 @@ declare function createPolyTorus(options?: TorusPolygonsOptions): ParseResult;
 
 declare function injectPolyBaseStyles(doc?: Document): void;
 
-export { type PolyControlsAnimateOptions, type PolyControlsBaseOptions, type PolyControlsCamera, type PolyControlsChangeEvent, type PolyControlsEvent, type PolyControlsHandle, type PolyControlsInteractionEvent, type PolyControlsListener, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyMapControlsHandle, type PolyMapControlsOptions, PolyMeshHandle, type PolyOrbitControlsHandle, type PolyOrbitControlsOptions, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolySceneHandle, type PolySelectOptions, type PolySelectionHandle, type PolyTransformControlsHandle, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsOptions, type RenderTextureAtlasAsyncResult, type RenderTextureAtlasOptions, type RenderTextureAtlasResult, type RenderedPoly, buildAtlasPages, collectPolyRenderStats, createPolyBox, createPolyCone, createPolyCylinder, createPolyDodecahedron, createPolyFirstPersonControls, createPolyIcosahedron, createPolyMapControls, createPolyOctahedron, createPolyOrbitControls, createPolyPlane, createPolyRing, createPolySphere, createPolyTetrahedron, createPolyTorus, createSelect, createTransformControls, filterAtlasPlans, getSolidPaintDefaults, getSolidPaintDefaultsFromPlans, injectPolyBaseStyles, isBorderShapeSupported, isSolidTriangleSupported, packTextureAtlasPlansWithScale, renderPolygonsWithStableTriangles, renderPolygonsWithTextureAtlas, renderPolygonsWithTextureAtlasAsync, updatePolygonsWithStableTopology, updatePolygonsWithStableTriangles, updateStableTriangleFrame };
+export { PolyControlsBaseOptions, PolyControlsEvent, PolyControlsHandle, PolyControlsListener, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyMapControlsHandle, type PolyMapControlsOptions, PolyMeshHandle, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolySceneHandle, PolySceneOptions, PolySceneSnapshotError, type PolySceneSnapshotErrorCode, type PolySelectOptions, type PolySelectionHandle, type PolyTransformControlsHandle, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsOptions, type RenderTextureAtlasAsyncResult, type RenderTextureAtlasOptions, type RenderTextureAtlasResult, type RenderedPoly, buildAtlasPages, collectPolyRenderStats, createPolyBox, createPolyCone, createPolyCylinder, createPolyDodecahedron, createPolyFirstPersonControls, createPolyIcosahedron, createPolyMapControls, createPolyOctahedron, createPolyPlane, createPolyRing, createPolyScene, createPolySphere, createPolyTetrahedron, createPolyTorus, createSelect, createTransformControls, exportPolySceneSnapshot, filterAtlasPlans, getSolidPaintDefaults, getSolidPaintDefaultsFromPlans, injectPolyBaseStyles, isBorderShapeSupported, isSolidTriangleSupported, packTextureAtlasPlansWithScale, renderPolygonsWithStableTriangles, renderPolygonsWithTextureAtlas, renderPolygonsWithTextureAtlasAsync, updatePolygonsWithStableTopology, updatePolygonsWithStableTriangles, updateStableTriangleFrame };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { P as PolySceneHandle, a as PolyMeshHandle } from './PolyShapeElements-prI_DBZX.js';
-export { b as PolyBoxElement, c as PolyCameraElement, d as PolyCameraOptions, e as PolyConeElement, f as PolyCylinderElement, g as PolyDodecahedronElement, h as PolyFirstPersonControlsElement, i as PolyIcosahedronElement, j as PolyMapControlsElement, k as PolyMeshElement, l as PolyMeshTransform, m as PolyOctahedronElement, n as PolyOrbitControlsElement, o as PolyOrthographicCameraElement, p as PolyOrthographicCameraHandle, q as PolyOrthographicCameraOptions, r as PolyPerspectiveCameraElement, s as PolyPerspectiveCameraHandle, t as PolyPerspectiveCameraOptions, u as PolyPlaneElement, v as PolyPolygonElement, w as PolyRingElement, x as PolySceneElement, y as PolySceneOptions, z as PolySelectElement, A as PolySphereElement, B as PolyTetrahedronElement, C as PolyTorusElement, D as PolyTransformControlsElement, E as createPolyCamera, F as createPolyOrthographicCamera, G as createPolyPerspectiveCamera, H as createPolyScene } from './PolyShapeElements-prI_DBZX.js';
+import { P as PolySceneOptions, a as PolySceneHandle, b as PolyControlsHandle, c as PolyControlsBaseOptions, d as PolyControlsEvent, e as PolyControlsListener, f as PolyMeshHandle } from './PolyShapeElements-CoKhApyN.js';
+export { g as PolyBoxElement, h as PolyCameraElement, i as PolyCameraOptions, j as PolyConeElement, k as PolyControlsAnimateOptions, l as PolyControlsCamera, m as PolyControlsChangeEvent, n as PolyControlsInteractionEvent, o as PolyCylinderElement, p as PolyDodecahedronElement, q as PolyFirstPersonControlsElement, r as PolyIcosahedronElement, s as PolyIframeElement, t as PolyMapControlsElement, u as PolyMeshElement, v as PolyMeshTransform, w as PolyOctahedronElement, x as PolyOrbitControlsElement, y as PolyOrbitControlsHandle, z as PolyOrbitControlsOptions, A as PolyOrthographicCameraElement, B as PolyOrthographicCameraHandle, C as PolyOrthographicCameraOptions, D as PolyPerspectiveCameraElement, E as PolyPerspectiveCameraHandle, F as PolyPerspectiveCameraOptions, G as PolyPlaneElement, H as PolyPolygonElement, I as PolyRingElement, J as PolySceneElement, K as PolySelectElement, L as PolySphereElement, M as PolyTetrahedronElement, N as PolyTorusElement, O as PolyTransformControlsElement, Q as createPolyCamera, R as createPolyOrbitControls, S as createPolyOrthographicCamera, T as createPolyPerspectiveCamera } from './PolyShapeElements-CoKhApyN.js';
 import * as _layoutit_polycss_core from '@layoutit/polycss-core';
 import { PolyDirectionalLight, PolyAmbientLight, PolyTextureLightingMode, TextureAtlasPlan, TextureQuality, PackedAtlas, PackedPage, TextureAtlasPage, PolyRenderStrategy, SolidPaintDefaults, Polygon, SolidTriangleFrame, Vec3, BoxPolygonsOptions, ParseResult, ConePolygonsOptions, CylinderPolygonsOptions, DodecahedronPolygonsOptions, IcosahedronPolygonsOptions, OctahedronPolygonsOptions, PlanePolygonsOptions, RingPolygonsOptions, SpherePolygonsOptions, TetrahedronPolygonsOptions, TorusPolygonsOptions } from '@layoutit/polycss-core';
 export * from '@layoutit/polycss-core';
-export { ComputeTextureAtlasPlanOptions, PackedAtlas, PackedPage, PackedTextureAtlasEntry, PolyRenderStrategiesOption, PolyRenderStrategy, ParseResult as PolyShapeResult, SolidPaintDefaults, SolidTriangleFrame, TextureAtlasPage, TextureAtlasPlan, TextureQuality, buildTextureEdgeRepairSets, computeTextureAtlasPlanPublic, cssBorderShapeForPlan, formatBorderShapeEntryMatrix, formatCssLengthPx, formatMatrix3d, formatSolidQuadEntryMatrix, isFullRectSolid, isProjectiveQuadPlan, isSolidTrianglePlan } from '@layoutit/polycss-core';
+export { ComputeTextureAtlasPlanOptions, PackedAtlas, PackedPage, PackedTextureAtlasEntry, PolyRenderStrategiesOption, PolyRenderStrategy, ParseResult as PolyShapeResult, SolidPaintDefaults, SolidTriangleFrame, TextureAtlasPage, TextureAtlasPlan, TextureQuality, buildPolyMeshTransform, buildTextureEdgeRepairSets, computeTextureAtlasPlanPublic, cssBorderShapeForPlan, formatBorderShapeEntryMatrix, formatCssLengthPx, formatMatrix3d, formatSolidQuadEntryMatrix, isFullRectSolid, isProjectiveQuadPlan, isSolidTrianglePlan, worldDirectionToPolyCss, worldPositionToPolyCss } from '@layoutit/polycss-core';
 
 interface RenderTextureAtlasOptions {
     doc?: Document;
@@ -22,6 +22,13 @@ interface RenderTextureAtlasOptions {
     textureQuality?: _layoutit_polycss_core.TextureQuality;
     solidPaintDefaults?: _layoutit_polycss_core.SolidPaintDefaults;
     strategies?: _layoutit_polycss_core.PolyRenderStrategiesOption;
+    /**
+     * Indices of polygons that the directional light cannot reach (precomputed
+     * by createPolyScene via {@link computeLightVisibility}). Atlas + solid
+     * planning forces directScale to 0 for these polys so they render with
+     * ambient-only color, matching what a shadow-map pass would output.
+     */
+    lightOccludedPolyIndices?: ReadonlySet<number>;
 }
 interface RenderedPoly {
     polygonIndex: number;
@@ -33,6 +40,16 @@ interface RenderedPoly {
 interface RenderTextureAtlasResult {
     rendered: RenderedPoly[];
     dispose(): void;
+    /**
+     * Resolves once every textured `<s>` leaf has its `background-image`
+     * applied (i.e. the atlas canvas → Blob → URL chain has completed and
+     * the apply-bg pass has run). For meshes with no textured leaves this
+     * resolves immediately. Callers doing stale-while-revalidate swaps
+     * await this before disposing the previous render — without it, the
+     * fresh leaves mount with empty backgrounds and the prior frame's
+     * bitmaps would be needed underneath to avoid a transparent flash.
+     */
+    pagesReady?: Promise<void>;
 }
 interface RenderTextureAtlasAsyncResult extends RenderTextureAtlasResult {
     solidPaintDefaults: _layoutit_polycss_core.SolidPaintDefaults;
@@ -83,97 +100,7 @@ declare function updatePolygonsWithStableTopology(rendered: RenderedPoly[], poly
 declare function renderPolygonsWithStableTriangles(polygons: Polygon[], options?: RenderTextureAtlasOptions): RenderTextureAtlasResult | null;
 declare function updatePolygonsWithStableTriangles(rendered: RenderedPoly[], polygons: Polygon[], options?: RenderTextureAtlasOptions): RenderTextureAtlasResult | null;
 
-/**
- * Shared types, constants, and utilities for orbit/map controls factories.
- * Not part of the public API surface — use createPolyOrbitControls or
- * createPolyMapControls.
- */
-
-interface PolyControlsAnimateOptions {
-    /**
-     * Rotation rate in degrees per 60 Hz-equivalent frame. The tick is
-     * dt-clamped so 0.3 deg/frame ≈ 18 deg/sec on every refresh rate.
-     * Default: 0.3.
-     */
-    speed?: number;
-    /** Rotation axis. Default: "y" (yaw, rotates around vertical world Z). */
-    axis?: "x" | "y";
-    /** Halt the loop while a pointer drag is in progress. Default: true. */
-    pauseOnInteraction?: boolean;
-}
-interface PolyControlsBaseOptions {
-    /** Pointer-drag. Default: true. */
-    drag?: boolean;
-    /** Wheel / pinch zoom. Default: true. */
-    wheel?: boolean;
-    /**
-     * When `true`, wheel events change `distance` (camera pull-back in CSS px)
-     * instead of `zoom`. Mirrors Three.js OrbitControls dolly behaviour.
-     * Default: false (zoom mode).
-     */
-    dolly?: boolean;
-    /**
-     * Drag-direction inversion. `false` = natural, `true` = invert (×-1),
-     * a number multiplies sensitivity (negative inverts). Default: false.
-     */
-    invert?: boolean | number;
-    /** Minimum CSS zoom. Default: 0.1. */
-    minZoom?: number;
-    /** Maximum CSS zoom. Default: 10. */
-    maxZoom?: number;
-    /** Minimum dolly distance in CSS pixels. Default: 0. Only used when `dolly: true`. */
-    minDistance?: number;
-    /** Maximum dolly distance in CSS pixels. Default: Infinity. Only used when `dolly: true`. */
-    maxDistance?: number;
-    /** Auto-rotate. Pass false (or omit) to disable. */
-    animate?: false | PolyControlsAnimateOptions;
-}
-interface PolyControlsCamera {
-    rotX: number;
-    rotY: number;
-    zoom: number;
-    target: Vec3;
-    distance: number;
-}
-interface PolyControlsChangeEvent {
-    type: "change";
-    camera: PolyControlsCamera;
-}
-interface PolyControlsInteractionEvent {
-    type: "start" | "end";
-    camera: PolyControlsCamera;
-}
-type PolyControlsEvent = PolyControlsChangeEvent | PolyControlsInteractionEvent;
-type PolyControlsListener<E extends PolyControlsEvent = PolyControlsEvent> = (event: E) => void;
-interface PolyControlsHandle {
-    update(partial: PolyControlsBaseOptions): void;
-    resume(): void;
-    pause(): void;
-    destroy(): void;
-    addEventListener<T extends PolyControlsEvent["type"]>(type: T, listener: PolyControlsListener<Extract<PolyControlsEvent, {
-        type: T;
-    }>>): void;
-    removeEventListener<T extends PolyControlsEvent["type"]>(type: T, listener: PolyControlsListener<Extract<PolyControlsEvent, {
-        type: T;
-    }>>): void;
-    hasEventListener<T extends PolyControlsEvent["type"]>(type: T, listener: PolyControlsListener<Extract<PolyControlsEvent, {
-        type: T;
-    }>>): boolean;
-}
-
-/**
- * createPolyOrbitControls — orbit-mode camera input for a PolyScene.
- *
- * Left-drag rotates rotX / rotY around the target (orbit). Wheel zooms or
- * dollies. Mirrors Three.js OrbitControls semantics.
- *
- * For map/pan semantics (left-drag pans, right-drag orbits) use
- * `createPolyMapControls` instead.
- */
-
-type PolyOrbitControlsOptions = PolyControlsBaseOptions;
-type PolyOrbitControlsHandle = PolyControlsHandle;
-declare function createPolyOrbitControls(scene: PolySceneHandle, options?: PolyOrbitControlsOptions): PolyOrbitControlsHandle;
+declare function createPolyScene(host: HTMLElement, options: PolySceneOptions): PolySceneHandle;
 
 /**
  * createPolyMapControls — map/pan-mode camera input for a PolyScene.
@@ -398,6 +325,19 @@ interface PolyRenderStatsOptions {
 }
 declare function collectPolyRenderStats(root: ParentNode | null | undefined, optionsOrPolygonCount?: number | PolyRenderStatsOptions): PolyRenderStats;
 
+type PolySceneSnapshotErrorCode = "INVALID_TARGET" | "SCENE_NOT_FOUND" | "ASSET_INLINE_FAILED";
+declare class PolySceneSnapshotError extends Error {
+    readonly code: PolySceneSnapshotErrorCode;
+    readonly url?: string;
+    constructor(code: PolySceneSnapshotErrorCode, message: string, url?: string);
+}
+/**
+ * Serialize the current rendered PolyCSS DOM into a standalone HTML document.
+ * The snapshot is intentionally static: it preserves the scene's current DOM,
+ * inlines CSS image assets, and emits no scripts or PolyCSS runtime imports.
+ */
+declare function exportPolySceneSnapshot(target: Element): Promise<string>;
+
 /**
  * Primitive shape factories — thin wrappers over the polygon generators in
  * @layoutit/polycss-core. Each returns a `ParseResult`-compatible object so
@@ -418,4 +358,4 @@ declare function createPolyTorus(options?: TorusPolygonsOptions): ParseResult;
 
 declare function injectPolyBaseStyles(doc?: Document): void;
 
-export { type PolyControlsAnimateOptions, type PolyControlsBaseOptions, type PolyControlsCamera, type PolyControlsChangeEvent, type PolyControlsEvent, type PolyControlsHandle, type PolyControlsInteractionEvent, type PolyControlsListener, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyMapControlsHandle, type PolyMapControlsOptions, PolyMeshHandle, type PolyOrbitControlsHandle, type PolyOrbitControlsOptions, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolySceneHandle, type PolySelectOptions, type PolySelectionHandle, type PolyTransformControlsHandle, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsOptions, type RenderTextureAtlasAsyncResult, type RenderTextureAtlasOptions, type RenderTextureAtlasResult, type RenderedPoly, buildAtlasPages, collectPolyRenderStats, createPolyBox, createPolyCone, createPolyCylinder, createPolyDodecahedron, createPolyFirstPersonControls, createPolyIcosahedron, createPolyMapControls, createPolyOctahedron, createPolyOrbitControls, createPolyPlane, createPolyRing, createPolySphere, createPolyTetrahedron, createPolyTorus, createSelect, createTransformControls, filterAtlasPlans, getSolidPaintDefaults, getSolidPaintDefaultsFromPlans, injectPolyBaseStyles, isBorderShapeSupported, isSolidTriangleSupported, packTextureAtlasPlansWithScale, renderPolygonsWithStableTriangles, renderPolygonsWithTextureAtlas, renderPolygonsWithTextureAtlasAsync, updatePolygonsWithStableTopology, updatePolygonsWithStableTriangles, updateStableTriangleFrame };
+export { PolyControlsBaseOptions, PolyControlsEvent, PolyControlsHandle, PolyControlsListener, type PolyFirstPersonControlsHandle, type PolyFirstPersonControlsOptions, type PolyMapControlsHandle, type PolyMapControlsOptions, PolyMeshHandle, type PolyRenderStats, type PolyRenderStatsOptions, type PolyRenderSurfaceLeafCounts, PolySceneHandle, PolySceneOptions, PolySceneSnapshotError, type PolySceneSnapshotErrorCode, type PolySelectOptions, type PolySelectionHandle, type PolyTransformControlsHandle, type PolyTransformControlsObjectChangeEvent, type PolyTransformControlsOptions, type RenderTextureAtlasAsyncResult, type RenderTextureAtlasOptions, type RenderTextureAtlasResult, type RenderedPoly, buildAtlasPages, collectPolyRenderStats, createPolyBox, createPolyCone, createPolyCylinder, createPolyDodecahedron, createPolyFirstPersonControls, createPolyIcosahedron, createPolyMapControls, createPolyOctahedron, createPolyPlane, createPolyRing, createPolyScene, createPolySphere, createPolyTetrahedron, createPolyTorus, createSelect, createTransformControls, exportPolySceneSnapshot, filterAtlasPlans, getSolidPaintDefaults, getSolidPaintDefaultsFromPlans, injectPolyBaseStyles, isBorderShapeSupported, isSolidTriangleSupported, packTextureAtlasPlansWithScale, renderPolygonsWithStableTriangles, renderPolygonsWithTextureAtlas, renderPolygonsWithTextureAtlasAsync, updatePolygonsWithStableTopology, updatePolygonsWithStableTriangles, updateStableTriangleFrame };