@codexo/exojs 0.6.12 → 0.7.12

package/dist/esm/rendering/filters/WebGpuShaderFilter.js

@@ -0,0 +1,402 @@
+import { Color } from '../../core/Color.js';
+import { RenderBackendType } from '../RenderBackendType.js';
+import { RenderTargetPass } from '../RenderTargetPass.js';
+import { Texture } from '../texture/Texture.js';
+import { Filter } from './Filter.js';
+
+/// <reference types="@webgpu/types" />
+/**
+ * Default fullscreen-quad vertex shader (WGSL). Positions are already in
+ * clip space (-1..1), so no projection matrix is needed.
+ */
+const defaultVertexSource = `
+struct VsOut {
+    @builtin(position) position: vec4<f32>,
+    @location(0) vUv: vec2<f32>,
+};
+
+@vertex
+fn main(@location(0) aPosition: vec2<f32>, @location(1) aUv: vec2<f32>) -> VsOut {
+    var out: VsOut;
+    out.position = vec4<f32>(aPosition, 0.0, 1.0);
+    out.vUv = aUv;
+    return out;
+}
+`;
+/**
+ * Interleaved position+UV data for a fullscreen TRIANGLE_STRIP quad.
+ * Layout per vertex: [posX, posY, uvX, uvY]
+ *
+ * Vertices (clip-space positions, 0..1 UVs):
+ *   0: bottom-left  (-1, -1, 0, 0)
+ *   1: bottom-right ( 1, -1, 1, 0)
+ *   2: top-left     (-1,  1, 0, 1)
+ *   3: top-right    ( 1,  1, 1, 1)
+ */
+const quadVertexData = new Float32Array([
+    -1, -1, 0, 0,
+    1, -1, 1, 0,
+    -1, 1, 0, 1,
+    1, 1, 1, 1,
+]);
+/** Bytes per vertex: 2 floats position + 2 floats UV = 16 bytes */
+const vertexStrideBytes = 16;
+/** Resolution uniform buffer size: vec2<f32> = 8 bytes, padded to 16 */
+const resolutionBufferBytes = 16;
+/** Returns true when the value is a texture (goes into a bind group, not a UBO). */
+function isTextureValue(value) {
+    return value instanceof Texture
+        || (typeof value === 'object' && value !== null && 'width' in value && 'height' in value && !(value instanceof Float32Array) && !(value instanceof Int32Array) && !Array.isArray(value));
+}
+/**
+ * A high-level {@link Filter} subclass that renders the input texture through
+ * a user-provided WGSL fragment shader on the **WebGPU** backend.
+ *
+ * For the WebGL2 backend use {@link WebGl2ShaderFilter}.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * const filter = new WebGpuShaderFilter({
+ *   fragmentSource: `
+ *     @group(0) @binding(0) var<uniform> uResolution: vec2<f32>;
+ *     @group(0) @binding(1) var uTexture: texture_2d<f32>;
+ *     @group(0) @binding(2) var uSampler: sampler;
+ *
+ *     @fragment
+ *     fn main(@location(0) vUv: vec2<f32>) -> @location(0) vec4<f32> {
+ *       return textureSample(uTexture, uSampler, vUv);
+ *     }
+ *   `,
+ *   uniforms: { uTime: 0.0 },
+ * });
+ *
+ * // Update uniforms each frame:
+ * filter.uniforms.uTime = performance.now() / 1000;
+ * sprite.filters = [filter];
+ * ```
+ *
+ * ## Auto-bound uniforms (group 0)
+ *
+ * - `@binding(0)` — `var<uniform> uResolution: vec2<f32>` (output dimensions)
+ * - `@binding(1)` — `var uTexture: texture_2d<f32>` (filter input)
+ * - `@binding(2)` — `var uSampler: sampler`
+ *
+ * ## User uniforms (group 1)
+ *
+ * All non-texture user uniforms are packed into a single uniform buffer at
+ * `@binding(0)`. Each member occupies a 16-byte aligned slot (conservative
+ * alignment). Declare your WGSL struct to match this layout.
+ *
+ * Texture/RenderTexture uniforms are bound as separate entries starting at
+ * `@binding(1)` (texture) and `@binding(N+1)` (sampler), in declaration order.
+ */
+class WebGpuShaderFilter extends Filter {
+    /**
+     * Mutable map of uniform values. Set values via property assignment;
+     * they are flushed to the GPU before each apply().
+     *
+     *   filter.uniforms.uTime = 1.234;
+     *   filter.uniforms.uColor = [1, 0.5, 0, 1];  // vec4
+     */
+    uniforms;
+    _fragmentSource;
+    _vertexSource;
+    _connection = null;
+    constructor(options) {
+        super();
+        if (!options.fragmentSource) {
+            throw new Error('WebGpuShaderFilter requires fragmentSource.');
+        }
+        this._fragmentSource = options.fragmentSource;
+        this._vertexSource = options.vertexSource ?? defaultVertexSource;
+        this.uniforms = { ...(options.uniforms ?? {}) };
+    }
+    /**
+     * Execute the WGSL shader pass: flush uniforms, build bind groups, and
+     * render the input texture into `output`. Throws if the active backend is
+     * not WebGPU — use {@link WebGl2ShaderFilter} on WebGL2.
+     */
+    apply(backend, input, output) {
+        if (backend.backendType !== RenderBackendType.WebGpu) {
+            throw new Error('WebGpuShaderFilter requires the WebGPU backend. Use WebGl2ShaderFilter on WebGL2.');
+        }
+        const gpuBackend = backend;
+        this._ensureConnected(gpuBackend, output);
+        const conn = this._connection;
+        backend.execute(new RenderTargetPass((b) => {
+            const gpu = b;
+            const device = conn.device;
+            // ---- Update auto-bound resolution uniform ----
+            const resData = new Float32Array([output.width, output.height, 0, 0]);
+            device.queue.writeBuffer(conn.resolutionBuffer, 0, resData);
+            // ---- Build auto-bind group (group 0) ----
+            const inputBinding = gpu.getTextureBinding(input);
+            const autoBindGroup = device.createBindGroup({
+                layout: conn.autoBindGroupLayout,
+                entries: [
+                    { binding: 0, resource: { buffer: conn.resolutionBuffer } },
+                    { binding: 1, resource: inputBinding.view },
+                    { binding: 2, resource: conn.sampler },
+                ],
+            });
+            // ---- Build user bind group (group 1) ----
+            const userBindGroup = this._buildUserBindGroup(gpu, conn);
+            // ---- Encode render pass ----
+            const device2 = gpu.device;
+            const encoder = device2.createCommandEncoder();
+            const pass = encoder.beginRenderPass({
+                colorAttachments: [gpu.createColorAttachment()],
+            });
+            gpu.stats.renderPasses++;
+            pass.setPipeline(conn.pipeline);
+            pass.setVertexBuffer(0, conn.vertexBuffer);
+            pass.setBindGroup(0, autoBindGroup);
+            pass.setBindGroup(1, userBindGroup);
+            pass.draw(4);
+            gpu.stats.drawCalls++;
+            pass.end();
+            gpu.submit(encoder.finish());
+        }, {
+            target: output,
+            view: output.view,
+            clearColor: Color.transparentBlack,
+        }));
+    }
+    destroy() {
+        if (this._connection !== null) {
+            this._connection.vertexBuffer.destroy();
+            this._connection.resolutionBuffer.destroy();
+            this._connection.userUniformBuffer?.destroy();
+            this._connection = null;
+        }
+        for (const key of Object.keys(this.uniforms)) {
+            delete this.uniforms[key];
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    _ensureConnected(backend, output) {
+        if (this._connection !== null) {
+            return;
+        }
+        const device = backend.device;
+        // Shader modules
+        const vsModule = device.createShaderModule({ code: this._vertexSource });
+        const fsModule = device.createShaderModule({ code: this._fragmentSource });
+        // ---- Group 0 layout: resolution uniform + input texture + sampler ----
+        const autoBindGroupLayout = device.createBindGroupLayout({
+            entries: [
+                {
+                    binding: 0,
+                    visibility: GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX,
+                    buffer: { type: 'uniform' },
+                },
+                {
+                    binding: 1,
+                    visibility: GPUShaderStage.FRAGMENT,
+                    texture: {},
+                },
+                {
+                    binding: 2,
+                    visibility: GPUShaderStage.FRAGMENT,
+                    sampler: {},
+                },
+            ],
+        });
+        // ---- Group 1 layout: user UBO + optional texture/sampler pairs ----
+        const userBindGroupLayout = this._buildUserBindGroupLayout(device);
+        // ---- Pipeline layout ----
+        const pipelineLayout = device.createPipelineLayout({
+            bindGroupLayouts: [autoBindGroupLayout, userBindGroupLayout],
+        });
+        // ---- Render pipeline ----
+        const targetFormat = backend.renderTargetFormat;
+        const pipeline = device.createRenderPipeline({
+            layout: pipelineLayout,
+            vertex: {
+                module: vsModule,
+                entryPoint: 'main',
+                buffers: [
+                    {
+                        arrayStride: vertexStrideBytes,
+                        attributes: [
+                            { shaderLocation: 0, offset: 0, format: 'float32x2' },
+                            { shaderLocation: 1, offset: 8, format: 'float32x2' },
+                        ],
+                    },
+                ],
+            },
+            fragment: {
+                module: fsModule,
+                entryPoint: 'main',
+                targets: [{ format: targetFormat }],
+            },
+            primitive: { topology: 'triangle-strip' },
+        });
+        // ---- Vertex buffer (fullscreen quad, static) ----
+        const vertexBuffer = device.createBuffer({
+            size: quadVertexData.byteLength,
+            usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+        });
+        device.queue.writeBuffer(vertexBuffer, 0, quadVertexData);
+        // ---- Resolution uniform buffer ----
+        const resolutionBuffer = device.createBuffer({
+            size: resolutionBufferBytes,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        // ---- Sampler ----
+        const sampler = device.createSampler({
+            magFilter: 'linear',
+            minFilter: 'linear',
+            addressModeU: 'clamp-to-edge',
+            addressModeV: 'clamp-to-edge',
+        });
+        this._connection = {
+            device,
+            vertexBuffer,
+            resolutionBuffer,
+            autoBindGroupLayout,
+            userBindGroupLayout,
+            pipelineLayout,
+            pipeline,
+            sampler,
+            userUniformBuffer: null,
+        };
+    }
+    /**
+     * Build the GPUBindGroupLayout for group 1 (user uniforms).
+     *
+     * Layout:
+     *   binding 0 — uniform buffer (scalar/vector uniforms), if any scalar uniforms exist
+     *   binding 1, 3, 5, ... — texture entries (one per texture uniform, in order)
+     *   binding 2, 4, 6, ... — sampler entries (paired with textures)
+     */
+    _buildUserBindGroupLayout(device) {
+        const entries = [];
+        const hasScalarUniforms = Object.values(this.uniforms).some((v) => !isTextureValue(v));
+        if (hasScalarUniforms) {
+            entries.push({
+                binding: 0,
+                visibility: GPUShaderStage.FRAGMENT,
+                buffer: { type: 'uniform' },
+            });
+        }
+        let bindingIndex = 1;
+        for (const value of Object.values(this.uniforms)) {
+            if (!isTextureValue(value)) {
+                continue;
+            }
+            // texture entry
+            entries.push({
+                binding: bindingIndex,
+                visibility: GPUShaderStage.FRAGMENT,
+                texture: {},
+            });
+            bindingIndex++;
+            // sampler entry
+            entries.push({
+                binding: bindingIndex,
+                visibility: GPUShaderStage.FRAGMENT,
+                sampler: {},
+            });
+            bindingIndex++;
+        }
+        // If no entries at all, add a dummy uniform buffer entry so the layout is valid
+        if (entries.length === 0) {
+            entries.push({
+                binding: 0,
+                visibility: GPUShaderStage.FRAGMENT,
+                buffer: { type: 'uniform' },
+            });
+        }
+        return device.createBindGroupLayout({ entries });
+    }
+    /**
+     * Build and return the GPUBindGroup for group 1 on each frame.
+     * Marshals scalar uniforms into the user uniform buffer and assembles
+     * texture/sampler bind group entries.
+     */
+    _buildUserBindGroup(backend, conn) {
+        const device = conn.device;
+        const entries = [];
+        // ---- Collect scalar uniforms and marshal into a UBO ----
+        const scalarEntries = Object.entries(this.uniforms).filter(([, v]) => !isTextureValue(v));
+        if (scalarEntries.length > 0) {
+            // Each uniform gets a 16-byte aligned slot (conservative WGSL alignment)
+            const bufferSize = scalarEntries.length * 16;
+            const data = new Float32Array(bufferSize / 4);
+            let slot = 0;
+            for (const [, value] of scalarEntries) {
+                const baseFloatIndex = slot * 4; // 16 bytes = 4 floats per slot
+                if (typeof value === 'number') {
+                    data[baseFloatIndex] = value;
+                }
+                else if (value instanceof Float32Array) {
+                    data.set(value, baseFloatIndex);
+                }
+                else if (value instanceof Int32Array) {
+                    // Int32Array values — reinterpret as float (best-effort for V1)
+                    for (let i = 0; i < value.length; i++) {
+                        data[baseFloatIndex + i] = value[i];
+                    }
+                }
+                else {
+                    // Readonly tuple [a], [a,b], [a,b,c], [a,b,c,d]
+                    const arr = value;
+                    for (let i = 0; i < arr.length; i++) {
+                        data[baseFloatIndex + i] = arr[i];
+                    }
+                }
+                slot++;
+            }
+            // Reuse / create user uniform buffer
+            if (conn.userUniformBuffer === null || conn.userUniformBuffer.size < bufferSize) {
+                conn.userUniformBuffer?.destroy();
+                conn.userUniformBuffer = device.createBuffer({
+                    size: bufferSize,
+                    usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+                });
+            }
+            device.queue.writeBuffer(conn.userUniformBuffer, 0, data);
+            entries.push({
+                binding: 0,
+                resource: { buffer: conn.userUniformBuffer },
+            });
+        }
+        else {
+            // No scalar uniforms — still need binding 0 to satisfy the layout.
+            // Create a minimal 16-byte dummy buffer if needed.
+            if (conn.userUniformBuffer === null) {
+                conn.userUniformBuffer = device.createBuffer({
+                    size: 16,
+                    usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+                });
+            }
+            entries.push({
+                binding: 0,
+                resource: { buffer: conn.userUniformBuffer },
+            });
+        }
+        // ---- Texture/sampler entries ----
+        let bindingIndex = 1;
+        for (const [, value] of Object.entries(this.uniforms)) {
+            if (!isTextureValue(value)) {
+                continue;
+            }
+            const binding = backend.getTextureBinding(value);
+            entries.push({ binding: bindingIndex, resource: binding.view });
+            bindingIndex++;
+            entries.push({ binding: bindingIndex, resource: binding.sampler });
+            bindingIndex++;
+        }
+        return device.createBindGroup({
+            layout: conn.userBindGroupLayout,
+            entries,
+        });
+    }
+}
+
+export { WebGpuShaderFilter };
+//# sourceMappingURL=WebGpuShaderFilter.js.map

package/dist/esm/rendering/filters/WebGpuShaderFilter.js.map

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

package/dist/esm/rendering/index.d.ts

@@ -3,6 +3,7 @@ export * from './primitives/Graphics';
 export * from './shader/Shader';
 export * from './shader/ShaderAttribute';
 export * from './shader/ShaderUniform';
+export * from './shader/upgradeFragmentShaderToGl300';
 export * from './sprite/Sprite';
 export * from './sprite/Spritesheet';
 export * from './sprite/AnimatedSprite';
@@ -51,3 +52,5 @@ export * from './View';
 export * from './filters/Filter';
 export * from './filters/BlurFilter';
 export * from './filters/ColorFilter';
+export * from './filters/WebGl2ShaderFilter';
+export * from './filters/WebGpuShaderFilter';

package/dist/esm/rendering/mesh/Mesh.d.ts

@@ -56,7 +56,9 @@ export declare class Mesh extends Drawable {
     readonly colors: Uint32Array | null;
     private _texture;
     constructor(options: MeshOptions);
+    /** Number of (x, y) vertex pairs in the mesh (i.e. `vertices.length / 2`). */
     get vertexCount(): number;
+    /** Number of indices to draw: `indices.length` for indexed meshes, `vertexCount` otherwise. */
     get indexCount(): number;
     get texture(): Texture | RenderTexture | null;
     set texture(texture: Texture | RenderTexture | null);

package/dist/esm/rendering/mesh/Mesh.js

@@ -70,9 +70,11 @@ class Mesh extends Drawable {
         this._texture = texture;
         this.recomputeLocalBounds();
     }
+    /** Number of (x, y) vertex pairs in the mesh (i.e. `vertices.length / 2`). */
     get vertexCount() {
         return this.vertices.length / 2;
     }
+    /** Number of indices to draw: `indices.length` for indexed meshes, `vertexCount` otherwise. */
     get indexCount() {
         return this.indices?.length ?? this.vertexCount;
     }
@@ -106,6 +108,7 @@ class Mesh extends Drawable {
                 maxY = y;
         }
         this.localBounds.set(minX, minY, maxX - minX, maxY - minY);
+        this._invalidateBoundsCascade();
         return this;
     }
 }

package/dist/esm/rendering/mesh/Mesh.js.map

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

package/dist/esm/rendering/primitives/Graphics.d.ts

@@ -3,6 +3,19 @@ import { Container } from '@/rendering/Container';
 import { Vector } from '@/math/Vector';
 import { Mesh } from '@/rendering/mesh/Mesh';
 import type { RenderNode } from '@/rendering/RenderNode';
+/**
+ * Immediate-mode 2D shape API backed by {@link Mesh} children.
+ *
+ * Each draw call (e.g. `drawCircle`, `drawRectangle`, `drawLine`) appends a
+ * new {@link Mesh} child colored with the current `fillColor` or `lineColor`.
+ * The active `lineWidth` controls stroke thickness for path and outline draws.
+ * Path commands (`moveTo`, `lineTo`, `quadraticCurveTo`, etc.) track a cursor
+ * point and flush a Mesh on each segment.
+ *
+ * Call {@link clear} to remove all child meshes and reset pen state. Because
+ * each shape is a separate Mesh, `Graphics` inherits full filter, blend,
+ * tint, and mask support from {@link Container}.
+ */
 export declare class Graphics extends Container {
     private _lineWidth;
     private _lineColor;
@@ -18,19 +31,40 @@ export declare class Graphics extends Container {
     getChildAt(index: number): Mesh;
     addChild(child: RenderNode): this;
     addChildAt(child: RenderNode, index: number): this;
+    /** Move the current pen position to (`x`, `y`) without drawing anything. */
     moveTo(x: number, y: number): this;
+    /** Draw a stroked line segment from the current point to (`toX`, `toY`) and advance the pen. */
     lineTo(toX: number, toY: number): this;
+    /** Draw a quadratic Bézier curve from the current point to (`toX`, `toY`) via control point (`cpX`, `cpY`). */
     quadraticCurveTo(cpX: number, cpY: number, toX: number, toY: number): this;
+    /** Draw a cubic Bézier curve from the current point to (`toX`, `toY`) via two control points. */
     bezierCurveTo(cpX1: number, cpY1: number, cpX2: number, cpY2: number, toX: number, toY: number): this;
+    /**
+     * Draw a circular arc tangent to the two lines defined by the current point→(x1,y1)
+     * and (x1,y1)→(x2,y2), with the given `radius`. Falls back to `lineTo(x1,y1)`
+     * when the geometry is degenerate.
+     */
     arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): this;
+    /** Draw a stroked arc centered at (`x`, `y`) with the given `radius` from `startAngle` to `endAngle` (radians). */
     drawArc(x: number, y: number, radius: number, startAngle: number, endAngle: number, anticlockwise?: boolean): this;
+    /** Draw a stroked line between two explicit points, independent of the current pen position. */
     drawLine(startX: number, startY: number, endX: number, endY: number): this;
+    /** Draw a stroked polyline from a flat `[x0,y0, x1,y1, ...]` coordinate array. */
     drawPath(path: Array<number>): this;
+    /** Fill a closed polygon defined by `[x0,y0, x1,y1, ...]` and optionally stroke its outline. */
     drawPolygon(path: Array<number>): this;
+    /** Fill a circle and optionally stroke its outline if `lineWidth > 0`. */
     drawCircle(centerX: number, centerY: number, radius: number): this;
+    /** Fill an ellipse and optionally stroke its outline if `lineWidth > 0`. */
     drawEllipse(centerX: number, centerY: number, radiusX: number, radiusY: number): this;
+    /** Fill a rectangle and optionally stroke its outline if `lineWidth > 0`. */
     drawRectangle(x: number, y: number, width: number, height: number): this;
+    /**
+     * Fill a regular star polygon and optionally stroke its outline.
+     * `innerRadius` defaults to half of `radius`.
+     */
     drawStar(centerX: number, centerY: number, points: number, radius: number, innerRadius?: number, rotation?: number): this;
+    /** Remove all child meshes and reset pen state (position, colors, line width). */
     clear(): this;
     destroy(): void;
     private _createMesh;

package/dist/esm/rendering/primitives/Graphics.js

@@ -5,6 +5,19 @@ import { buildLine, buildPath, buildPolygon, buildCircle, buildEllipse, buildSta
 import { Vector } from '../../math/Vector.js';
 import { Mesh } from '../mesh/Mesh.js';
 
+/**
+ * Immediate-mode 2D shape API backed by {@link Mesh} children.
+ *
+ * Each draw call (e.g. `drawCircle`, `drawRectangle`, `drawLine`) appends a
+ * new {@link Mesh} child colored with the current `fillColor` or `lineColor`.
+ * The active `lineWidth` controls stroke thickness for path and outline draws.
+ * Path commands (`moveTo`, `lineTo`, `quadraticCurveTo`, etc.) track a cursor
+ * point and flush a Mesh on each segment.
+ *
+ * Call {@link clear} to remove all child meshes and reset pen state. Because
+ * each shape is a separate Mesh, `Graphics` inherits full filter, blend,
+ * tint, and mask support from {@link Container}.
+ */
 class Graphics extends Container {
     _lineWidth = 0;
     _lineColor = new Color();
@@ -46,28 +59,37 @@ class Graphics extends Container {
         }
         return super.addChildAt(child, index);
     }
+    /** Move the current pen position to (`x`, `y`) without drawing anything. */
     moveTo(x, y) {
         this._currentPoint.set(x, y);
         return this;
     }
+    /** Draw a stroked line segment from the current point to (`toX`, `toY`) and advance the pen. */
     lineTo(toX, toY) {
         const { x: fromX, y: fromY } = this._currentPoint;
         this.drawPath([fromX, fromY, toX, toY]);
         this.moveTo(toX, toY);
         return this;
     }
+    /** Draw a quadratic Bézier curve from the current point to (`toX`, `toY`) via control point (`cpX`, `cpY`). */
     quadraticCurveTo(cpX, cpY, toX, toY) {
         const { x: fromX, y: fromY } = this._currentPoint;
         this.drawPath(quadraticCurveTo(fromX, fromY, cpX, cpY, toX, toY));
         this.moveTo(toX, toY);
         return this;
     }
+    /** Draw a cubic Bézier curve from the current point to (`toX`, `toY`) via two control points. */
     bezierCurveTo(cpX1, cpY1, cpX2, cpY2, toX, toY) {
         const { x: fromX, y: fromY } = this._currentPoint;
         this.drawPath(bezierCurveTo(fromX, fromY, cpX1, cpY1, cpX2, cpY2, toX, toY));
         this.moveTo(toX, toY);
         return this;
     }
+    /**
+     * Draw a circular arc tangent to the two lines defined by the current point→(x1,y1)
+     * and (x1,y1)→(x2,y2), with the given `radius`. Falls back to `lineTo(x1,y1)`
+     * when the geometry is degenerate.
+     */
     arcTo(x1, y1, x2, y2, radius) {
         const { x: fromX, y: fromY } = this._currentPoint;
         const r = Math.abs(radius);
@@ -111,6 +133,7 @@ class Graphics extends Container {
         this.lineTo(startX, startY);
         return this.drawArc(centerX, centerY, r, startAngle, endAngle, leftTurn);
     }
+    /** Draw a stroked arc centered at (`x`, `y`) with the given `radius` from `startAngle` to `endAngle` (radians). */
     drawArc(x, y, radius, startAngle, endAngle, anticlockwise = false) {
         const r = Math.abs(radius);
         if (r === 0) {
@@ -137,16 +160,19 @@ class Graphics extends Container {
         this.moveTo(path[path.length - 2], path[path.length - 1]);
         return this;
     }
+    /** Draw a stroked line between two explicit points, independent of the current pen position. */
     drawLine(startX, startY, endX, endY) {
         const data = buildLine(startX, startY, endX, endY, this._lineWidth);
         this.addChild(this._createMesh(data, this._lineColor));
         return this;
     }
+    /** Draw a stroked polyline from a flat `[x0,y0, x1,y1, ...]` coordinate array. */
     drawPath(path) {
         const data = buildPath(path, this._lineWidth);
         this.addChild(this._createMesh(data, this._lineColor));
         return this;
     }
+    /** Fill a closed polygon defined by `[x0,y0, x1,y1, ...]` and optionally stroke its outline. */
     drawPolygon(path) {
         const data = buildPolygon(path);
         this.addChild(this._createMesh(data, this._fillColor));
@@ -155,6 +181,7 @@ class Graphics extends Container {
         }
         return this;
     }
+    /** Fill a circle and optionally stroke its outline if `lineWidth > 0`. */
     drawCircle(centerX, centerY, radius) {
         const data = buildCircle(centerX, centerY, radius);
         this.addChild(this._createMesh(data, this._fillColor));
@@ -163,6 +190,7 @@ class Graphics extends Container {
         }
         return this;
     }
+    /** Fill an ellipse and optionally stroke its outline if `lineWidth > 0`. */
     drawEllipse(centerX, centerY, radiusX, radiusY) {
         const data = buildEllipse(centerX, centerY, radiusX, radiusY);
         this.addChild(this._createMesh(data, this._fillColor));
@@ -171,6 +199,7 @@ class Graphics extends Container {
         }
         return this;
     }
+    /** Fill a rectangle and optionally stroke its outline if `lineWidth > 0`. */
     drawRectangle(x, y, width, height) {
         const data = buildRectangle(x, y, width, height);
         this.addChild(this._createMesh(data, this._fillColor));
@@ -179,6 +208,10 @@ class Graphics extends Container {
         }
         return this;
     }
+    /**
+     * Fill a regular star polygon and optionally stroke its outline.
+     * `innerRadius` defaults to half of `radius`.
+     */
     drawStar(centerX, centerY, points, radius, innerRadius = radius / 2, rotation = 0) {
         const data = buildStar(centerX, centerY, points, radius, innerRadius, rotation);
         this.addChild(this._createMesh(data, this._fillColor));
@@ -187,6 +220,7 @@ class Graphics extends Container {
         }
         return this;
     }
+    /** Remove all child meshes and reset pen state (position, colors, line width). */
     clear() {
         this.removeChildren();
         this._lineWidth = 0;