@aura3d/addons 0.0.0-stage → 5.0.0

package/dist/renderers/SpatialDOMRenderer.d.ts

@@ -0,0 +1,76 @@
+/** A top-left-origin rectangle in CSS pixels. */
+export interface SpatialDOMViewport {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * A world-anchored DOM element. Matrix values are column-major and use the
+ * same world coordinates as the view-projection matrix. A function allows an
+ * animated scene transform to be sampled anew on each render.
+ */
+export interface SpatialDOMLabel {
+    readonly id: string;
+    readonly element: HTMLElement;
+    readonly worldMatrix: ArrayLike<number> | (() => ArrayLike<number>);
+    /** Screen-aligned pixels, or an oriented world-space plane. Default `screen`. */
+    readonly mode?: "screen" | "perspective";
+    readonly visible?: boolean;
+    /** Receive DOM pointer events instead of passing them through to the canvas. */
+    readonly interactive?: boolean;
+    readonly ariaLabel?: string;
+    /** Explicit layering overrides the normal far-to-near ordering. */
+    readonly renderOrder?: number;
+    /** World units represented by one CSS pixel on a perspective label; default 0.01. */
+    readonly worldUnitsPerPixel?: number;
+}
+export interface SpatialDOMView {
+    readonly viewProjectionMatrix: ArrayLike<number>;
+    /** Rectangle within the renderer's dimensions; default is the whole surface. */
+    readonly viewport?: SpatialDOMViewport;
+    /** NDC depth convention. Defaults to `minus-one-to-one`. */
+    readonly depthRange?: "minus-one-to-one" | "zero-to-one";
+    /** Reverse the depth sort when the projection maps the near plane to larger NDC values. */
+    readonly depthOrder?: "standard" | "reversed";
+}
+export type SpatialDOMOcclusionTest = (label: SpatialDOMLabel, worldAnchor: readonly [number, number, number]) => boolean;
+export interface SpatialDOMRendererOptions {
+    readonly container: HTMLElement;
+    readonly width: number;
+    readonly height: number;
+    /** Optional caller-owned anchor test. No depth-buffer query is performed. */
+    readonly isOccluded?: SpatialDOMOcclusionTest;
+}
+/**
+ * Opt-in DOM output. Mount the container over the canvas (its positioning is
+ * owned by the caller), then render once per view/frame. The overlay itself
+ * clips to the supplied viewport. Its labels preserve their DOM semantics;
+ * off-frustum, occluded and explicitly hidden labels leave the accessibility
+ * tree. No GPU depth buffer is sampled: the optional callback tests the world
+ * anchor only, and does not imply per-pixel occlusion of a label. Frustum
+ * visibility is also determined from the anchor; viewport overflow clips the
+ * element rectangle but geometry and near/far planes do not clip it per pixel.
+ * Perspective planes that collapse or face exactly edge-on are hidden.
+ *
+ * Pointer events pass through by default. An interactive element receives
+ * normal DOM events and those events are not forwarded to the canvas. Remove
+ * or dispose restores each element's original parent, styles and ARIA fields.
+ * A borrowed element cannot be managed by another renderer until it is removed
+ * from this renderer or this renderer is disposed.
+ */
+export declare class SpatialDOMRenderer {
+    readonly element: HTMLDivElement;
+    private readonly managed;
+    private readonly occlusionTest?;
+    private width;
+    private height;
+    private disposed;
+    constructor(options: SpatialDOMRendererOptions);
+    setSize(width: number, height: number): void;
+    render(labels: readonly SpatialDOMLabel[], view: SpatialDOMView): void;
+    dispose(): void;
+    private assertAlive;
+    private setViewport;
+}
+//# sourceMappingURL=SpatialDOMRenderer.d.ts.map

package/dist/renderers/SpatialDOMRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialDOMRenderer.d.ts","sourceRoot":"","sources":["../../src/renderers/SpatialDOMRenderer.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACjD,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,GAAG,aAAa,CAAC;IACzD,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/C;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAC3C,OAAO,CAAC;AAEb,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;CAC/C;AA6BD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA0B;IACzD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,yBAAyB;IAa9C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAS5C,MAAM,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAiFtE,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/renderers/SpatialDOMRenderer.js

@@ -0,0 +1,279 @@
+const OWNED_STYLES = ["position", "left", "top", "transform", "transform-origin", "z-index", "display", "pointer-events"];
+// A borrowed element must have exactly one renderer owner. Otherwise a second
+// renderer can capture the first renderer's temporary state as its "original"
+// state and each renderer will steal the element back from the other on dispose.
+const LABEL_OWNERS = new WeakMap();
+const OUTPUT_LAYERS = new WeakSet();
+/**
+ * Opt-in DOM output. Mount the container over the canvas (its positioning is
+ * owned by the caller), then render once per view/frame. The overlay itself
+ * clips to the supplied viewport. Its labels preserve their DOM semantics;
+ * off-frustum, occluded and explicitly hidden labels leave the accessibility
+ * tree. No GPU depth buffer is sampled: the optional callback tests the world
+ * anchor only, and does not imply per-pixel occlusion of a label. Frustum
+ * visibility is also determined from the anchor; viewport overflow clips the
+ * element rectangle but geometry and near/far planes do not clip it per pixel.
+ * Perspective planes that collapse or face exactly edge-on are hidden.
+ *
+ * Pointer events pass through by default. An interactive element receives
+ * normal DOM events and those events are not forwarded to the canvas. Remove
+ * or dispose restores each element's original parent, styles and ARIA fields.
+ * A borrowed element cannot be managed by another renderer until it is removed
+ * from this renderer or this renderer is disposed.
+ */
+export class SpatialDOMRenderer {
+    element;
+    managed = new Map();
+    occlusionTest;
+    width;
+    height;
+    disposed = false;
+    constructor(options) {
+        this.width = positive(options.width, "width");
+        this.height = positive(options.height, "height");
+        this.occlusionTest = options.isOccluded;
+        this.element = options.container.ownerDocument.createElement("div");
+        this.element.setAttribute("data-aura-spatial-labels", "");
+        this.element.setAttribute("aria-live", "off");
+        Object.assign(this.element.style, { position: "absolute", overflow: "hidden", pointerEvents: "none" });
+        options.container.appendChild(this.element);
+        OUTPUT_LAYERS.add(this.element);
+        this.setViewport({ x: 0, y: 0, width: this.width, height: this.height });
+    }
+    setSize(width, height) {
+        this.assertAlive();
+        const nextWidth = positive(width, "width");
+        const nextHeight = positive(height, "height");
+        this.width = nextWidth;
+        this.height = nextHeight;
+        this.setViewport({ x: 0, y: 0, width: this.width, height: this.height });
+    }
+    render(labels, view) {
+        this.assertAlive();
+        const projection = matrix(view.viewProjectionMatrix, "viewProjectionMatrix");
+        const viewport = view.viewport ?? { x: 0, y: 0, width: this.width, height: this.height };
+        validateViewport(viewport, this.width, this.height);
+        const depthRange = view.depthRange ?? "minus-one-to-one";
+        if (depthRange !== "minus-one-to-one" && depthRange !== "zero-to-one")
+            throw new RangeError("Unknown spatial DOM depth range.");
+        const depthOrder = view.depthOrder ?? "standard";
+        if (depthOrder !== "standard" && depthOrder !== "reversed")
+            throw new RangeError("Unknown spatial DOM depth order.");
+        const elementsById = new Map();
+        const elements = new Set();
+        const prepared = labels.map((label) => {
+            if (!label.id || elementsById.has(label.id))
+                throw new Error(`Spatial DOM label id must be nonempty and unique: ${label.id}`);
+            if (elements.has(label.element))
+                throw new Error("A DOM element cannot belong to multiple spatial labels.");
+            if (OUTPUT_LAYERS.has(label.element) || label.element.contains(this.element))
+                throw new Error("A spatial label cannot be or contain its output layer.");
+            const owner = LABEL_OWNERS.get(label.element);
+            if (owner && owner !== this)
+                throw new Error("A DOM element is already managed by another SpatialDOMRenderer.");
+            elementsById.set(label.id, label.element);
+            elements.add(label.element);
+            if (label.mode !== undefined && label.mode !== "screen" && label.mode !== "perspective")
+                throw new RangeError("Unknown spatial DOM label mode.");
+            if (label.renderOrder !== undefined && !Number.isFinite(label.renderOrder))
+                throw new RangeError("Label renderOrder must be finite.");
+            const scale = positive(label.worldUnitsPerPixel ?? 0.01, "worldUnitsPerPixel");
+            const world = matrix(typeof label.worldMatrix === "function" ? label.worldMatrix() : label.worldMatrix, "worldMatrix");
+            if (world[3] !== 0 || world[7] !== 0 || world[11] !== 0 || world[15] !== 1)
+                throw new RangeError("A label worldMatrix must be affine.");
+            const combined = multiply(projection, world);
+            if (!combined.every(Number.isFinite))
+                throw new RangeError("Spatial label transformation overflowed.");
+            const x = combined[12], y = combined[13], z = combined[14], w = combined[15];
+            const inFrustum = w > 0 && Math.abs(x) <= w && Math.abs(y) <= w && z <= w && z >= (depthRange === "zero-to-one" ? 0 : -w);
+            let shown = label.visible !== false && inFrustum && !(this.occlusionTest?.(label, [world[12], world[13], world[14]]) ?? false);
+            const depth = w > 0 ? z / w : Number.POSITIVE_INFINITY;
+            let transform = "none";
+            if (shown && label.mode === "perspective") {
+                const perspective = perspectiveTransform(combined, viewport.width, viewport.height, scale);
+                if (perspective === null)
+                    shown = false;
+                else
+                    transform = perspective;
+            }
+            else if (shown) {
+                transform = `translate3d(${(x / w * 0.5 + 0.5) * viewport.width}px, ${(0.5 - y / w * 0.5) * viewport.height}px, 0) translate(-50%, -50%)`;
+            }
+            return { label, depth, shown, transform };
+        });
+        // Validate the full input before moving elements or changing the layer.
+        // Callbacks above are caller code and may have disposed this renderer or
+        // synchronously lent an element to another renderer while being sampled.
+        this.assertAlive();
+        for (const { label } of prepared) {
+            const owner = LABEL_OWNERS.get(label.element);
+            if (owner && owner !== this)
+                throw new Error("A DOM element is already managed by another SpatialDOMRenderer.");
+        }
+        for (const [id, current] of this.managed) {
+            if (elementsById.get(id) !== current.element) {
+                restore(current);
+                LABEL_OWNERS.delete(current.element);
+                this.managed.delete(id);
+            }
+        }
+        this.setViewport(viewport);
+        const ordered = [...prepared].sort((a, b) => (a.label.renderOrder ?? 0) - (b.label.renderOrder ?? 0) || (depthOrder === "reversed" ? a.depth - b.depth : b.depth - a.depth) || (a.label.id < b.label.id ? -1 : a.label.id > b.label.id ? 1 : 0));
+        ordered.forEach(({ label, depth: _depth, shown, transform }, index) => {
+            let current = this.managed.get(label.id);
+            if (!current) {
+                current = capture(label.element);
+                this.managed.set(label.id, current);
+                LABEL_OWNERS.set(label.element, this);
+            }
+            if (label.element.parentNode !== this.element)
+                this.element.appendChild(label.element);
+            const style = label.element.style;
+            style.position = "absolute";
+            style.left = "0";
+            style.top = "0";
+            style.transformOrigin = "0 0";
+            style.transform = transform;
+            style.zIndex = String(index + 1);
+            style.pointerEvents = label.interactive === true ? "auto" : "none";
+            style.display = shown ? current.styles.get("display")[0] : "none";
+            setAttribute(label.element, "aria-hidden", shown ? current.ariaHidden : "true");
+            setAttribute(label.element, "aria-label", label.ariaLabel ?? current.ariaLabel);
+        });
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const label of this.managed.values()) {
+            restore(label);
+            LABEL_OWNERS.delete(label.element);
+        }
+        this.managed.clear();
+        this.element.remove();
+        OUTPUT_LAYERS.delete(this.element);
+    }
+    assertAlive() {
+        if (this.disposed)
+            throw new Error("SpatialDOMRenderer is disposed.");
+    }
+    setViewport(viewport) {
+        Object.assign(this.element.style, { left: `${viewport.x}px`, top: `${viewport.y}px`, width: `${viewport.width}px`, height: `${viewport.height}px` });
+    }
+}
+function capture(element) {
+    const parent = element.parentNode;
+    const nextSibling = element.nextSibling;
+    const marker = parent ? element.ownerDocument.createComment("aura-spatial-label") : null;
+    if (parent && marker)
+        parent.insertBefore(marker, element);
+    return {
+        element,
+        parent,
+        nextSibling,
+        marker,
+        styles: new Map(OWNED_STYLES.map((property) => [property, [element.style.getPropertyValue(property), element.style.getPropertyPriority(property)]])),
+        ariaHidden: element.getAttribute("aria-hidden"),
+        ariaLabel: element.getAttribute("aria-label")
+    };
+}
+function restore(label) {
+    for (const [property, [value, priority]] of label.styles) {
+        if (value)
+            label.element.style.setProperty(property, value, priority);
+        else
+            label.element.style.removeProperty(property);
+    }
+    setAttribute(label.element, "aria-hidden", label.ariaHidden);
+    setAttribute(label.element, "aria-label", label.ariaLabel);
+    if (label.marker?.parentNode) {
+        label.marker.parentNode.insertBefore(label.element, label.marker);
+        label.marker.parentNode.removeChild(label.marker);
+    }
+    else if (label.parent) {
+        label.parent.insertBefore(label.element, label.nextSibling?.parentNode === label.parent ? label.nextSibling : null);
+    }
+    else
+        label.element.remove();
+}
+function setAttribute(element, name, value) {
+    if (value === null)
+        element.removeAttribute(name);
+    else
+        element.setAttribute(name, value);
+}
+function positive(value, name) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new RangeError(`${name} must be positive and finite.`);
+    return value;
+}
+function validateViewport(viewport, width, height) {
+    if (![viewport.x, viewport.y, viewport.width, viewport.height].every(Number.isFinite) || viewport.x < 0 || viewport.y < 0 || viewport.width <= 0 || viewport.height <= 0 || viewport.x + viewport.width > width || viewport.y + viewport.height > height) {
+        throw new RangeError("Spatial DOM viewport must fit within the renderer size.");
+    }
+}
+function matrix(value, name) {
+    if (value.length !== 16)
+        throw new RangeError(`${name} must contain 16 column-major values.`);
+    const result = Array.from(value);
+    if (!result.every(Number.isFinite))
+        throw new RangeError(`${name} must contain finite values.`);
+    return result;
+}
+function multiply(a, b) {
+    const result = new Array(16).fill(0);
+    for (let c = 0; c < 4; c++)
+        for (let r = 0; r < 4; r++)
+            for (let k = 0; k < 4; k++)
+                result[c * 4 + r] += a[k * 4 + r] * b[c * 4 + k];
+    return result;
+}
+function perspectiveTransform(clip, width, height, scale) {
+    const css = new Array(16).fill(0);
+    for (let col = 0; col < 4; col++) {
+        // DOM's downward Y axis is the opposite of the label plane's upward Y.
+        const factor = col === 0 || col === 2 ? scale : col === 1 ? -scale : 1;
+        const x = clip[col * 4] * factor, y = clip[col * 4 + 1] * factor, w = clip[col * 4 + 3] * factor;
+        css[col * 4] = (x + w) * width / 2;
+        css[col * 4 + 1] = (w - y) * height / 2;
+        css[col * 4 + 2] = clip[col * 4 + 2] * factor;
+        css[col * 4 + 3] = w;
+    }
+    if (!css.every(Number.isFinite))
+        throw new RangeError("Spatial label CSS transform overflowed.");
+    if (!invertible(css)) {
+        // HTML content lies in the local XY plane, so replacing only the Z input
+        // column leaves every point on that plane unchanged. This preserves flat
+        // labels under a zero-depth world scale; CSS otherwise discards the entire
+        // element for a singular 4x4 matrix even when its plane can be projected.
+        css[8] = 0;
+        css[9] = 0;
+        css[10] = 1;
+        css[11] = 0;
+        if (!invertible(css))
+            return null; // The plane itself is edge-on or collapsed.
+    }
+    return `matrix3d(${css.join(",")}) translate(-50%, -50%)`;
+}
+function invertible(value) {
+    const scale = Math.max(...value.map(Math.abs));
+    if (scale === 0)
+        return false;
+    const rows = Array.from({ length: 4 }, (_, row) => Array.from({ length: 4 }, (_, col) => value[col * 4 + row] / scale));
+    for (let col = 0; col < 4; col++) {
+        let pivot = col;
+        for (let row = col + 1; row < 4; row++)
+            if (Math.abs(rows[row][col]) > Math.abs(rows[pivot][col]))
+                pivot = row;
+        if (rows[pivot][col] === 0)
+            return false;
+        [rows[pivot], rows[col]] = [rows[col], rows[pivot]];
+        for (let row = col + 1; row < 4; row++) {
+            const factor = rows[row][col] / rows[col][col];
+            for (let next = col + 1; next < 4; next++)
+                rows[row][next] -= factor * rows[col][next];
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=SpatialDOMRenderer.js.map

package/dist/renderers/SpatialDOMRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialDOMRenderer.js","sourceRoot":"","sources":["../../src/renderers/SpatialDOMRenderer.ts"],"names":[],"mappings":"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"}

package/dist/renderers/VectorRenderer.d.ts

@@ -0,0 +1,98 @@
+/** Flat vector styles; lighting, textures and shader effects are not reproduced. */
+export interface VectorStyle {
+    readonly fill?: string;
+    readonly stroke?: string;
+    readonly strokeWidth?: number;
+    readonly opacity?: number;
+    readonly pointSize?: number;
+    readonly lineCap?: "butt" | "round" | "square";
+    readonly lineJoin?: "miter" | "round" | "bevel";
+}
+interface VectorPositionBuffer {
+    readonly vertexCount: number;
+    getAttribute(index: number, semantic: "position"): readonly number[];
+    getDecodedAttribute?(index: number, semantic: "position"): readonly number[];
+}
+/** Structurally compatible with Aura3D Geometry's readable CPU buffers. */
+export interface VectorGeometry {
+    readonly vertexBuffer: VectorPositionBuffer;
+    getAttributeBuffer?(semantic: "position"): VectorPositionBuffer;
+    readonly indexBuffer?: {
+        readonly data: ArrayLike<number>;
+    } | null;
+    readonly topology: "triangles" | "lines" | "points";
+    readonly drawRange?: {
+        readonly start: number;
+        readonly count: number;
+    };
+}
+export interface VectorRenderItem {
+    readonly geometry: VectorGeometry;
+    /** Passed through to `resolveStyle`; GPU material behavior is not inferred. */
+    readonly material?: unknown;
+    readonly label?: string;
+    readonly modelMatrix?: ArrayLike<number>;
+    readonly geometryMatrix?: ArrayLike<number>;
+    /** If supplied, this replaces viewProjectionMatrix × modelMatrix. */
+    readonly modelViewProjectionMatrix?: ArrayLike<number>;
+    /** Intersected with the geometry's draw range; offsets address indices when present. */
+    readonly drawRange?: {
+        readonly start: number;
+        readonly count: number;
+    };
+    readonly renderOrder?: number;
+    /** Per-item fields override the defaults returned by `resolveStyle`. */
+    readonly style?: VectorStyle;
+    readonly skinning?: unknown;
+    readonly morphTargets?: unknown;
+    readonly morphWeights?: unknown;
+    readonly instanceTransforms?: unknown;
+}
+export interface VectorViewport {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface VectorView {
+    /** Column-major world-to-clip matrix. */
+    readonly viewProjectionMatrix: ArrayLike<number>;
+    /** Top-left-origin viewport in output pixels; defaults to the whole output. */
+    readonly viewport?: VectorViewport;
+    readonly depthRange?: "minus-one-to-one" | "zero-to-one";
+    /** Set for projections that map the near plane to larger NDC depth. */
+    readonly depthOrder?: "standard" | "reversed";
+}
+export interface VectorRendererOptions {
+    readonly width: number;
+    readonly height: number;
+    readonly background?: string;
+    /** Upper bound on submitted primitives, before clipping; default 100,000. */
+    readonly maxPrimitives?: number;
+    /** Convert an item's material to the supported flat vector styles if desired. */
+    readonly resolveStyle?: (item: VectorRenderItem) => VectorStyle;
+}
+/**
+ * Produce a standalone SVG from CPU-readable, static Aura3D render geometry.
+ * Triangles, lines and points are clipped in homogeneous space before the
+ * perspective divide. `renderOrder` then far-to-near painter ordering is used;
+ * intersecting polygons cannot be depth-tested per pixel. Vector styles are
+ * flat and explicit; textures, lighting, shadows and post effects are not
+ * exported. Skinned, morphed and instanced draws throw instead of silently
+ * exporting an undeformed or partial scene. The renderer owns no geometry.
+ */
+export declare class VectorRenderer {
+    private width;
+    private height;
+    private readonly background?;
+    private readonly maxPrimitives;
+    private readonly resolveStyle?;
+    private disposed;
+    constructor(options: VectorRendererOptions);
+    setSize(width: number, height: number): void;
+    render(items: readonly VectorRenderItem[], view: VectorView): string;
+    dispose(): void;
+    private assertAlive;
+}
+export {};
+//# sourceMappingURL=VectorRenderer.d.ts.map

package/dist/renderers/VectorRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorRenderer.d.ts","sourceRoot":"","sources":["../../src/renderers/VectorRenderer.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;CACjD;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,CAAC;IACrE,mBAAmB,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,CAAC;CAC9E;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,kBAAkB,CAAC,CAAC,QAAQ,EAAE,UAAU,GAAG,oBAAoB,CAAC;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACvD,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACjD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,GAAG,aAAa,CAAC;IACzD,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,WAAW,CAAC;CACjE;AAOD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA0C;IACxE,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,qBAAqB;IAU1C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5C,MAAM,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM;IA2EpE,OAAO,IAAI,IAAI;IACf,OAAO,CAAC,WAAW;CACpB"}