@codexo/exojs 0.8.4 → 0.10.0

package/dist/esm/rendering/webgpu/WebGpuStencilClipper.js

@@ -0,0 +1,257 @@
+import { Matrix } from '../../math/Matrix.js';
+
+/// <reference types="@webgpu/types" />
+/** depth24plus-stencil8 is the portable depth/stencil format with an 8-bit stencil aspect. */
+const stencilAttachmentFormat = 'depth24plus-stencil8';
+const positionNames = new Set(['a_position', 'position']);
+const matrixByteLength = 64; // mat4x4<f32>
+const stencilWriteShaderSource = `
+struct Uniforms {
+    matrix: mat4x4<f32>,
+};
+
+@group(0) @binding(0) var<uniform> u: Uniforms;
+
+@vertex
+fn vertexMain(@location(0) position: vec2<f32>) -> @builtin(position) vec4<f32> {
+    return u.matrix * vec4<f32>(position, 0.0, 1.0);
+}
+
+@fragment
+fn fragmentMain() -> @location(0) vec4<f32> {
+    // Color writes are masked off (writeMask 0); only the stencil aspect is touched.
+    return vec4<f32>(0.0);
+}
+`;
+/**
+ * Draws a {@link Geometry} silhouette into the stencil aspect of a render
+ * pass for the WebGPU geometric clip path, and owns the per-target
+ * `depth24plus-stencil8` attachments and the two stencil-write pipelines
+ * (increment on push, decrement on pop).
+ *
+ * Mirrors {@link WebGl2StencilClipper} + the WebGL2 backend's stencil stack:
+ * positions are de-referenced (indices expanded) into a tightly packed `x, y`
+ * stream on the CPU and drawn with a position-only pipeline whose colour writes
+ * are masked off. The owning {@link WebGpuPassCoordinator} manages the
+ * reference value and load/clear of the stencil aspect around each draw.
+ * @internal
+ */
+class WebGpuStencilClipper {
+    _matrix = new Matrix();
+    _matrixData = new Float32Array(matrixByteLength / Float32Array.BYTES_PER_ELEMENT);
+    _positions = new Float32Array(64);
+    _device = null;
+    _shaderModule = null;
+    _bindGroupLayout = null;
+    _pipelineLayout = null;
+    _uniformBuffer = null;
+    _bindGroup = null;
+    _vertexBuffer = null;
+    _vertexBufferCapacity = 0;
+    _incrementPipelines = new Map();
+    _decrementPipelines = new Map();
+    _stencilTextures = new Map();
+    connect(device) {
+        if (this._device !== null) {
+            return;
+        }
+        this._device = device;
+        this._shaderModule = device.createShaderModule({ code: stencilWriteShaderSource });
+        this._bindGroupLayout = device.createBindGroupLayout({
+            entries: [{ binding: 0, visibility: GPUShaderStage.VERTEX, buffer: { type: 'uniform' } }],
+        });
+        this._pipelineLayout = device.createPipelineLayout({ bindGroupLayouts: [this._bindGroupLayout] });
+        this._uniformBuffer = device.createBuffer({
+            size: matrixByteLength,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this._bindGroup = device.createBindGroup({
+            layout: this._bindGroupLayout,
+            entries: [{ binding: 0, resource: { buffer: this._uniformBuffer } }],
+        });
+    }
+    disconnect() {
+        if (this._device === null) {
+            return;
+        }
+        this._uniformBuffer?.destroy();
+        this._vertexBuffer?.destroy();
+        for (const entry of this._stencilTextures.values()) {
+            entry.texture.destroy();
+        }
+        this._stencilTextures.clear();
+        this._incrementPipelines.clear();
+        this._decrementPipelines.clear();
+        this._uniformBuffer = null;
+        this._vertexBuffer = null;
+        this._bindGroup = null;
+        this._pipelineLayout = null;
+        this._bindGroupLayout = null;
+        this._shaderModule = null;
+        this._vertexBufferCapacity = 0;
+        this._device = null;
+    }
+    /**
+     * Return (lazily creating) the stencil attachment view for `key`, sized to
+     * `width`×`height`. Recreated when the size changes so a resized or pooled
+     * render texture never reuses a stale, mis-sized stencil buffer.
+     */
+    getAttachmentView(key, width, height) {
+        const device = this._device;
+        if (device === null) {
+            throw new Error('WebGpuStencilClipper: not connected.');
+        }
+        const safeWidth = Math.max(1, width);
+        const safeHeight = Math.max(1, height);
+        const existing = this._stencilTextures.get(key);
+        if (existing?.width === safeWidth && existing.height === safeHeight) {
+            return existing.view;
+        }
+        existing?.texture.destroy();
+        const texture = device.createTexture({
+            size: { width: safeWidth, height: safeHeight },
+            format: stencilAttachmentFormat,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT,
+        });
+        const entry = { texture, view: texture.createView(), width: safeWidth, height: safeHeight };
+        this._stencilTextures.set(key, entry);
+        return entry.view;
+    }
+    /** Drop the cached stencil attachment for `key` (e.g. when its target is destroyed). */
+    releaseAttachment(key) {
+        const entry = this._stencilTextures.get(key);
+        if (entry !== undefined) {
+            entry.texture.destroy();
+            this._stencilTextures.delete(key);
+        }
+    }
+    /**
+     * Record the shape silhouette into the active pass's stencil aspect. The pass
+     * pipeline tests `stencil == reference` and applies increment-clamp (push) or
+     * decrement-clamp (pop); the caller sets the reference via
+     * `pass.setStencilReference`. `transform` is the clip node's global transform.
+     */
+    draw(pass, format, increment, shape, transform, view) {
+        const device = this._device;
+        if (device === null || this._bindGroup === null) {
+            throw new Error('WebGpuStencilClipper: not connected.');
+        }
+        const vertexCount = this._extractPositions(shape);
+        if (vertexCount === 0) {
+            return;
+        }
+        this._matrix.copy(transform).combine(view.getTransform());
+        this._packMatrix(this._matrix);
+        device.queue.writeBuffer(this._uniformBuffer, 0, this._matrixData.buffer, this._matrixData.byteOffset, this._matrixData.byteLength);
+        this._ensureVertexCapacity(vertexCount);
+        device.queue.writeBuffer(this._vertexBuffer, 0, this._positions.buffer, this._positions.byteOffset, vertexCount * 2 * Float32Array.BYTES_PER_ELEMENT);
+        pass.setPipeline(this._getPipeline(format, increment, shape.topology));
+        pass.setBindGroup(0, this._bindGroup);
+        pass.setVertexBuffer(0, this._vertexBuffer);
+        pass.draw(vertexCount);
+    }
+    _getPipeline(format, increment, topology) {
+        const cache = increment ? this._incrementPipelines : this._decrementPipelines;
+        const existing = cache.get(format);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const device = this._device;
+        const stencilOp = increment ? 'increment-clamp' : 'decrement-clamp';
+        const stencilFace = { compare: 'equal', failOp: 'keep', depthFailOp: 'keep', passOp: stencilOp };
+        const pipeline = device.createRenderPipeline({
+            layout: this._pipelineLayout,
+            vertex: {
+                module: this._shaderModule,
+                entryPoint: 'vertexMain',
+                buffers: [{ arrayStride: 8, attributes: [{ shaderLocation: 0, offset: 0, format: 'float32x2' }] }],
+            },
+            fragment: {
+                module: this._shaderModule,
+                entryPoint: 'fragmentMain',
+                // writeMask 0: no colour output, only the stencil aspect is modified.
+                targets: [{ format, writeMask: 0 }],
+            },
+            primitive: { topology: topology === 'triangle-strip' ? 'triangle-strip' : 'triangle-list' },
+            depthStencil: {
+                format: stencilAttachmentFormat,
+                depthWriteEnabled: false,
+                depthCompare: 'always',
+                stencilFront: stencilFace,
+                stencilBack: stencilFace,
+                stencilReadMask: 0xff,
+                stencilWriteMask: 0xff,
+            },
+        });
+        cache.set(format, pipeline);
+        return pipeline;
+    }
+    _packMatrix(m) {
+        const data = this._matrixData;
+        data[0] = m.a;
+        data[1] = m.c;
+        data[2] = 0;
+        data[3] = 0;
+        data[4] = m.b;
+        data[5] = m.d;
+        data[6] = 0;
+        data[7] = 0;
+        data[8] = 0;
+        data[9] = 0;
+        data[10] = 1;
+        data[11] = 0;
+        data[12] = m.x;
+        data[13] = m.y;
+        data[14] = 0;
+        data[15] = m.z;
+    }
+    _extractPositions(shape) {
+        const position = this._resolvePositionAttribute(shape.attributes);
+        if (position.type !== 'f32') {
+            throw new Error(`Stencil clipShape position attribute "${position.name}" must be of type f32 (got "${position.type}").`);
+        }
+        const { stride, vertexData, indices } = shape;
+        const view = vertexData instanceof Float32Array ? new DataView(vertexData.buffer, vertexData.byteOffset, vertexData.byteLength) : new DataView(vertexData);
+        const drawCount = indices !== null ? indices.length : shape.vertexCount;
+        this._ensurePositionCapacity(drawCount);
+        const out = this._positions;
+        for (let i = 0; i < drawCount; i++) {
+            const vertexIndex = indices !== null ? indices[i] : i;
+            const base = vertexIndex * stride + position.offset;
+            out[i * 2] = view.getFloat32(base, true);
+            out[i * 2 + 1] = view.getFloat32(base + 4, true);
+        }
+        return drawCount;
+    }
+    _resolvePositionAttribute(attributes) {
+        const directMatch = attributes.find(attribute => positionNames.has(attribute.name));
+        if (directMatch) {
+            return directMatch;
+        }
+        const fuzzyMatch = attributes.find(attribute => attribute.name.toLowerCase().includes('position'));
+        if (fuzzyMatch) {
+            return fuzzyMatch;
+        }
+        throw new Error('Stencil clipShape requires a position attribute named `a_position` or `position`.');
+    }
+    _ensurePositionCapacity(vertexCount) {
+        const requiredFloats = vertexCount * 2;
+        if (this._positions.length < requiredFloats) {
+            this._positions = new Float32Array(Math.max(requiredFloats, this._positions.length * 2));
+        }
+    }
+    _ensureVertexCapacity(vertexCount) {
+        const requiredBytes = vertexCount * 2 * Float32Array.BYTES_PER_ELEMENT;
+        if (requiredBytes > this._vertexBufferCapacity) {
+            this._vertexBuffer?.destroy();
+            this._vertexBufferCapacity = Math.max(requiredBytes, this._vertexBufferCapacity * 2 || 512);
+            this._vertexBuffer = this._device.createBuffer({
+                size: this._vertexBufferCapacity,
+                usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+            });
+        }
+    }
+}
+
+export { WebGpuStencilClipper, stencilAttachmentFormat };
+//# sourceMappingURL=WebGpuStencilClipper.js.map

package/dist/esm/rendering/webgpu/WebGpuStencilClipper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGpuStencilClipper.js","sources":["../../../../../src/rendering/webgpu/WebGpuStencilClipper.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/webgpu/WebGpuStencilState.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `depthStencil` pipeline state for a content pipeline (sprite / mesh / text
+ * / particle) rendered while a geometric stencil clip is active. Tests
+ * `stencil == reference` (the reference is set per-pass via
+ * `setStencilReference`), never writes the stencil aspect, and leaves depth
+ * inert (matching the clip pass's `depthReadOnly` attachment).
+ *
+ * Returned fresh per call because `GPURenderPipelineDescriptor` consumers may
+ * retain the object. Pipelines that omit this state (no active clip) must run in
+ * a pass without a depth/stencil attachment — the two variants are never
+ * interchangeable, so callers key their pipeline cache on the stencil flag.
+ * @internal
+ */
+export declare function stencilContentDepthStencilState(): GPUDepthStencilState;

package/dist/esm/rendering/webgpu/WebGpuStencilState.js

@@ -0,0 +1,36 @@
+import { stencilAttachmentFormat } from './WebGpuStencilClipper.js';
+
+/// <reference types="@webgpu/types" />
+const stencilContentFace = {
+    compare: 'equal',
+    failOp: 'keep',
+    depthFailOp: 'keep',
+    passOp: 'keep',
+};
+/**
+ * The `depthStencil` pipeline state for a content pipeline (sprite / mesh / text
+ * / particle) rendered while a geometric stencil clip is active. Tests
+ * `stencil == reference` (the reference is set per-pass via
+ * `setStencilReference`), never writes the stencil aspect, and leaves depth
+ * inert (matching the clip pass's `depthReadOnly` attachment).
+ *
+ * Returned fresh per call because `GPURenderPipelineDescriptor` consumers may
+ * retain the object. Pipelines that omit this state (no active clip) must run in
+ * a pass without a depth/stencil attachment — the two variants are never
+ * interchangeable, so callers key their pipeline cache on the stencil flag.
+ * @internal
+ */
+function stencilContentDepthStencilState() {
+    return {
+        format: stencilAttachmentFormat,
+        depthWriteEnabled: false,
+        depthCompare: 'always',
+        stencilFront: stencilContentFace,
+        stencilBack: stencilContentFace,
+        stencilReadMask: 0xff,
+        stencilWriteMask: 0,
+    };
+}
+
+export { stencilContentDepthStencilState };
+//# sourceMappingURL=WebGpuStencilState.js.map

package/dist/esm/rendering/webgpu/WebGpuStencilState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGpuStencilState.js","sources":["../../../../../src/rendering/webgpu/WebGpuStencilState.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;AAIA,MAAM,kBAAkB,GAAwB;AAC9C,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,MAAM,EAAE,MAAM;AACd,IAAA,WAAW,EAAE,MAAM;AACnB,IAAA,MAAM,EAAE,MAAM;CACf;AAED;;;;;;;;;;;;AAYG;SACa,+BAA+B,GAAA;IAC7C,OAAO;AACL,QAAA,MAAM,EAAE,uBAAuB;AAC/B,QAAA,iBAAiB,EAAE,KAAK;AACxB,QAAA,YAAY,EAAE,QAAQ;AACtB,QAAA,YAAY,EAAE,kBAAkB;AAChC,QAAA,WAAW,EAAE,kBAAkB;AAC/B,QAAA,eAAe,EAAE,IAAI;AACrB,QAAA,gBAAgB,EAAE,CAAC;KACpB;AACH;;;;"}

package/dist/esm/rendering/webgpu/WebGpuTextRenderer.d.ts

@@ -0,0 +1,70 @@
+import { type BitmapText } from '@/rendering/text/BitmapText';
+import { Text } from '@/rendering/text/Text';
+import { AbstractWebGpuRenderer } from './AbstractWebGpuRenderer';
+import type { WebGpuBackend } from './WebGpuBackend';
+/**
+ * WebGPU renderer for {@link Text} and {@link BitmapText} nodes.
+ *
+ * Mirrors {@link WebGl2TextRenderer}: per-node style data is packed once per
+ * flush into a `var<storage, read>` buffer, three specialised WGSL fragment
+ * variants handle SDF / MSDF / colour-atlas glyphs, and quads are sorted and
+ * batched by (shaderType, atlasPage) to minimise draw calls within a single
+ * render pass.
+ */
+export declare class WebGpuTextRenderer extends AbstractWebGpuRenderer<Text | BitmapText> {
+    private _device;
+    private _shaderModule;
+    private _frameBindGroupLayout;
+    private _textureBindGroupLayout;
+    private _pipelineLayout;
+    private readonly _pipelines;
+    private _texBindGroups;
+    private _projBuffer;
+    private _nodeBuffer;
+    private _vertexBuffer;
+    private _indexBuffer;
+    private _nodeBufferCapacity;
+    private _vertexBufferCapacity;
+    private _indexBufferCapacity;
+    private _frameBindGroup;
+    private _frameBindGroupDirty;
+    private _vertexCapacity;
+    private _indexCapacity;
+    private _vertexData;
+    private _float32View;
+    private _indexData;
+    private _projData;
+    private _nodeDataArray;
+    private _nodeCapacity;
+    private _nodeCount;
+    private readonly _pendingQuads;
+    private readonly _nodeIndexMap;
+    private readonly _textureKeyMap;
+    private _textureKeyCounter;
+    render(node: Text | BitmapText): void;
+    flush(): void;
+    destroy(): void;
+    /**
+     * Pre-create render pipelines for every (shaderType × targetFormat) pair
+     * asynchronously. Called from the backend init path so first-frame draws
+     * do not block on synchronous pipeline compilation.
+     */
+    prewarmPipelines(formats: readonly GPUTextureFormat[]): Promise<void>;
+    protected onConnect(backend: WebGpuBackend): void;
+    protected onDisconnect(): void;
+    private _collectText;
+    private _collectBitmapText;
+    private _assignNodeIndex;
+    private _packNodeData;
+    private _uploadNodeBuffer;
+    private _ensureGpuVertexBuffer;
+    private _ensureGpuIndexBuffer;
+    private _getFrameBindGroup;
+    private _getTexBindGroup;
+    private _getPipeline;
+    private _buildPipelineDescriptor;
+    private _ensureVertexCapacity;
+    private _ensureIndexCapacity;
+    private _ensureNodeCapacity;
+    private _resetFrameState;
+}