@codexo/exojs 0.8.0 → 0.8.3

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

@@ -1,56 +1,59 @@
+export * from './CallbackRenderPass';
+export * from './Container';
+export * from './Drawable';
+export * from './filters/BlurFilter';
+export * from './filters/ColorFilter';
+export * from './filters/Filter';
+export * from './filters/LutFilter';
+export * from './filters/WebGl2ShaderFilter';
+export * from './filters/WebGpuShaderFilter';
 export * from './mesh/Mesh';
+export * from './mesh/MeshShader';
 export * from './primitives/Graphics';
+export * from './RenderBackend';
+export * from './RenderBackendType';
+export * from './Renderer';
+export * from './RendererRegistry';
+export * from './RenderNode';
+export * from './RenderPass';
+export * from './RenderStats';
+export * from './RenderTarget';
+export * from './RenderTargetPass';
 export * from './shader/Shader';
 export * from './shader/ShaderAttribute';
 export * from './shader/ShaderUniform';
 export * from './shader/upgradeFragmentShaderToGl300';
+export * from './sprite/AnimatedSprite';
 export * from './sprite/Sprite';
 export * from './sprite/Spritesheet';
-export * from './sprite/AnimatedSprite';
 export * from './text/DynamicGlyphAtlas';
 export * from './text/Text';
 export * from './text/TextLayout';
 export * from './text/TextStyle';
 export * from './text/types';
+export * from './texture/DataTexture';
 export * from './texture/RenderTexture';
 export * from './texture/Sampler';
 export * from './texture/Texture';
+export * from './types';
 export * from './video/Video';
+export * from './View';
 export * from './webgl2/AbstractWebGl2BatchedRenderer';
 export * from './webgl2/AbstractWebGl2Renderer';
+export type { WebGl2Backend } from './webgl2/WebGl2Backend';
+export * from './webgl2/WebGl2Backend';
+export * from './webgl2/WebGl2MeshRenderer';
+export * from './webgl2/WebGl2ParticleRenderer';
 export * from './webgl2/WebGl2RenderBuffer';
 export * from './webgl2/WebGl2ShaderBlock';
 export * from './webgl2/WebGl2ShaderMappings';
-export * from './webgl2/WebGl2VertexArrayObject';
-export * from './webgl2/WebGl2MeshRenderer';
-export * from './webgl2/WebGl2ParticleRenderer';
-export type { WebGl2Backend } from './webgl2/WebGl2Backend';
-export * from './webgl2/WebGl2Backend';
 export * from './webgl2/WebGl2ShaderProgram';
 export * from './webgl2/WebGl2SpriteRenderer';
+export * from './webgl2/WebGl2VertexArrayObject';
 export * from './webgpu/AbstractWebGpuRenderer';
+export type { WebGpuBackend } from './webgpu/WebGpuBackend';
+export * from './webgpu/WebGpuBackend';
 export * from './webgpu/WebGpuBlendState';
 export * from './webgpu/WebGpuMeshRenderer';
 export * from './webgpu/WebGpuParticleRenderer';
-export type { WebGpuBackend } from './webgpu/WebGpuBackend';
-export * from './webgpu/WebGpuBackend';
 export * from './webgpu/WebGpuSpriteRenderer';
-export * from './types';
-export * from './Container';
-export * from './Drawable';
-export * from './RenderNode';
-export * from './RenderBackendType';
-export * from './RenderPass';
-export * from './RenderStats';
-export * from './RenderTarget';
-export * from './RenderTargetPass';
-export * from './CallbackRenderPass';
-export * from './Renderer';
-export * from './RendererRegistry';
-export * from './RenderBackend';
-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

@@ -1,6 +1,7 @@
 import { Drawable } from '@/rendering/Drawable';
-import type { Texture } from '@/rendering/texture/Texture';
+import type { MeshShader } from '@/rendering/mesh/MeshShader';
 import type { RenderTexture } from '@/rendering/texture/RenderTexture';
+import type { Texture } from '@/rendering/texture/Texture';
 /**
  * Construction-time options for a {@link Mesh}.
  *
@@ -13,6 +14,8 @@ import type { RenderTexture } from '@/rendering/texture/RenderTexture';
  * supplied UVs while an untextured mesh paints solid vertex colors only.
  *
  * Validation is enforced at construction; any mismatch throws.
+ *
+ * For custom shaders, see {@link MeshShader}.
  */
 export interface MeshOptions {
     readonly vertices: Float32Array;
@@ -20,6 +23,7 @@ export interface MeshOptions {
     readonly uvs?: Float32Array;
     readonly colors?: Uint32Array;
     readonly texture?: Texture | RenderTexture | null;
+    readonly shader?: MeshShader;
 }
 /**
  * Arbitrary 2D triangle-mesh primitive.
@@ -54,6 +58,7 @@ export declare class Mesh extends Drawable {
     readonly indices: Uint16Array | null;
     readonly uvs: Float32Array | null;
     readonly colors: Uint32Array | null;
+    readonly shader: MeshShader | null;
     private _texture;
     constructor(options: MeshOptions);
     /** Number of (x, y) vertex pairs in the mesh (i.e. `vertices.length / 2`). */

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

@@ -33,10 +33,11 @@ class Mesh extends Drawable {
     indices;
     uvs;
     colors;
+    shader;
     _texture;
     constructor(options) {
         super();
-        const { vertices, indices = null, uvs = null, colors = null, texture = null } = options;
+        const { vertices, indices = null, uvs = null, colors = null, texture = null, shader = null } = options;
         if (vertices.length === 0 || vertices.length % 2 !== 0) {
             throw new Error(`Mesh vertices must be a non-empty flat array of (x,y) pairs (got length ${vertices.length}).`);
         }
@@ -67,6 +68,7 @@ class Mesh extends Drawable {
         this.indices = indices;
         this.uvs = uvs;
         this.colors = colors;
+        this.shader = shader;
         this._texture = texture;
         this.recomputeLocalBounds();
     }

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/mesh/MeshShader.d.ts

@@ -0,0 +1,183 @@
+import type { RenderTexture } from '@/rendering/texture/RenderTexture';
+import type { Texture } from '@/rendering/texture/Texture';
+/**
+ * Uniform value passed to a custom mesh shader. Scalars and small tuples
+ * auto-marshal to the appropriate `Float32Array`/`Int32Array` for the
+ * backend's uniform call. `Texture`/`RenderTexture` values are bound to
+ * texture slots starting at slot 1 — slot 0 is reserved for the mesh's
+ * own `texture`.
+ */
+export type MeshShaderUniformValue = number | readonly [number, number] | readonly [number, number, number] | readonly [number, number, number, number] | Float32Array | Int32Array | Texture | RenderTexture;
+/**
+ * Construction options for {@link MeshShader}.
+ *
+ * At least one language must be supplied. Provide `glsl` for WebGL2,
+ * `wgsl` for WebGPU, or both for backend-portable meshes. The shader
+ * is compiled lazily on first use against the active backend; an
+ * unsupported backend at draw time throws with a clear error.
+ */
+export interface MeshShaderOptions {
+    /**
+     * GLSL ES 3.00 sources for the WebGL2 backend. Both `vertex` and
+     * `fragment` are required when `glsl` is supplied.
+     */
+    readonly glsl?: {
+        readonly vertex: string;
+        readonly fragment: string;
+    };
+    /**
+     * WGSL source for the WebGPU backend. Vertex and fragment entry
+     * points live in the same source file (WGSL convention).
+     */
+    readonly wgsl?: string;
+    /** Initial uniform values; mutate per frame via {@link MeshShader.uniforms}. */
+    readonly uniforms?: Record<string, MeshShaderUniformValue>;
+}
+/**
+ * Custom shader pair attached to a {@link Mesh}.
+ *
+ * One `MeshShader` instance can be shared across many meshes; renderers
+ * cache compiled programs/pipelines on the instance reference. Call
+ * {@link destroy} when the shader is no longer needed to release the
+ * cached GPU resources on every backend the shader was used on.
+ *
+ * # Vertex layout
+ *
+ * The vertex layout is fixed and shared with the default mesh shader,
+ * so custom vertex shaders MUST pin the standard attribute locations:
+ *
+ * ## GLSL (location-qualified)
+ *
+ * ```glsl
+ * layout(location = 0) in vec2 a_position;
+ * layout(location = 1) in vec2 a_texcoord;
+ * layout(location = 2) in vec4 a_color;
+ * ```
+ *
+ * ## WGSL (location-qualified)
+ *
+ * ```wgsl
+ * struct VertexInput {
+ *     @location(0) position: vec2<f32>,
+ *     @location(1) texcoord: vec2<f32>,
+ *     @location(2) color: vec4<f32>,
+ * };
+ * ```
+ *
+ * # Auto-bound uniforms
+ *
+ * The renderer auto-binds these when the shader declares them. Declared
+ * but unused is fine; absent is fine too. Both backends carry the same
+ * logical uniforms, only the binding scheme differs.
+ *
+ * ## GLSL
+ *
+ * ```glsl
+ * uniform mat3 u_projection;   // active view's projection
+ * uniform mat3 u_translation;  // mesh's global transform
+ * uniform vec4 u_tint;         // mesh.tint as RGBA in 0..1
+ * uniform sampler2D u_texture; // bound to texture slot 0
+ * ```
+ *
+ * ## WGSL
+ *
+ * ```wgsl
+ * struct MeshUniforms {
+ *     projection: mat3x3<f32>,
+ *     translation: mat3x3<f32>,
+ *     tint: vec4<f32>,
+ * };
+ *
+ * @group(0) @binding(0) var<uniform> u_mesh: MeshUniforms;
+ *
+ * @group(1) @binding(0) var u_texture: texture_2d<f32>;
+ * @group(1) @binding(1) var u_sampler: sampler;
+ * ```
+ *
+ * # User uniforms
+ *
+ * Anything in {@link uniforms} is set after the auto-binds. `Texture`/
+ * `RenderTexture` values claim slots 1..N (slot 0 belongs to the mesh).
+ *
+ * ## WGSL user-uniform contract
+ *
+ * User uniforms live in `@group(2)`:
+ *
+ * - `@group(2) @binding(0) var<uniform> u_user: <UserUniformsStruct>;`
+ *   for the packed scalar/vector/matrix uniforms.
+ * - `@group(2) @binding(N)` for each `Texture`/`RenderTexture` uniform,
+ *   in declaration order, alongside its sampler at `@binding(N+1)`.
+ */
+export declare class MeshShader {
+    /**
+     * Mutable user uniform values. Mutate between frames to drive animated
+     * effects; the renderer reads from this map every draw.
+     *
+     *   shader.uniforms.uTime = performance.now() / 1000;
+     *   shader.uniforms.uColor = [1, 0.5, 0, 1];
+     */
+    uniforms: Record<string, MeshShaderUniformValue>;
+    /** GLSL source pair for the WebGL2 backend, or `null` if not provided. */
+    readonly glsl: {
+        readonly vertex: string;
+        readonly fragment: string;
+    } | null;
+    /** WGSL source for the WebGPU backend, or `null` if not provided. */
+    readonly wgsl: string | null;
+    private readonly _disposeCallbacks;
+    constructor(options: MeshShaderOptions);
+    /**
+     * Convenience setter equivalent to `shader.uniforms[name] = value`.
+     * Provided for symmetry with engine APIs that prefer explicit methods
+     * over property mutation.
+     */
+    setUniform(name: string, value: MeshShaderUniformValue): void;
+    /**
+     * Reflect declared uniforms from each language's source. Returns a per-
+     * language map of uniform-name → declared type, parsed from the shader
+     * sources via lightweight regex (not a full GLSL/WGSL grammar). Texture
+     * uniforms (`sampler2D`/`texture_2d`) are included; sampler bindings
+     * are not (they pair with textures by binding index).
+     *
+     * Reflection is best-effort and intended for CI drift-checks and editor
+     * tooling, not for runtime uniform binding decisions. The renderers do
+     * NOT consult this map; they bind uniforms by name from {@link uniforms}
+     * and let the underlying API resolve declared-but-unused entries.
+     */
+    getDeclaredUniforms(): {
+        glsl: Record<string, string>;
+        wgsl: Record<string, string>;
+    };
+    /**
+     * Compare declared uniform names between the GLSL and WGSL sources.
+     * Returns lists of names declared in only one language. Use in CI to
+     * catch drift when both languages should expose the same logical
+     * uniforms. When only one language is provided, returns empty arrays.
+     *
+     * Auto-bound uniforms (`u_projection`, `u_translation`, `u_tint`,
+     * `u_texture`) are excluded from the comparison since the GLSL source
+     * declares them at the top-level uniform scope while the WGSL source
+     * receives them via the `@group(0)` mesh-uniforms struct and the
+     * `@group(1)` texture binding.
+     */
+    detectUniformDrift(): {
+        onlyInGlsl: readonly string[];
+        onlyInWgsl: readonly string[];
+    };
+    /**
+     * Release GPU resources cached against this `MeshShader` on every
+     * backend that has compiled it. Safe to call multiple times. After
+     * destroy, the shader can still be re-used — renderers will recompile
+     * on next draw — but typical usage is to drop the reference.
+     */
+    destroy(): void;
+    /**
+     * Internal hook for renderers to register a per-shader-instance cleanup
+     * callback (release compiled program, pipeline, or bind groups). The
+     * callback fires on {@link destroy}; renderers MUST also tolerate the
+     * shader being garbage-collected without destroy ever being called.
+     *
+     * @internal
+     */
+    _onDispose(callback: () => void): void;
+}

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

@@ -0,0 +1,231 @@
+/**
+ * Custom shader pair attached to a {@link Mesh}.
+ *
+ * One `MeshShader` instance can be shared across many meshes; renderers
+ * cache compiled programs/pipelines on the instance reference. Call
+ * {@link destroy} when the shader is no longer needed to release the
+ * cached GPU resources on every backend the shader was used on.
+ *
+ * # Vertex layout
+ *
+ * The vertex layout is fixed and shared with the default mesh shader,
+ * so custom vertex shaders MUST pin the standard attribute locations:
+ *
+ * ## GLSL (location-qualified)
+ *
+ * ```glsl
+ * layout(location = 0) in vec2 a_position;
+ * layout(location = 1) in vec2 a_texcoord;
+ * layout(location = 2) in vec4 a_color;
+ * ```
+ *
+ * ## WGSL (location-qualified)
+ *
+ * ```wgsl
+ * struct VertexInput {
+ *     @location(0) position: vec2<f32>,
+ *     @location(1) texcoord: vec2<f32>,
+ *     @location(2) color: vec4<f32>,
+ * };
+ * ```
+ *
+ * # Auto-bound uniforms
+ *
+ * The renderer auto-binds these when the shader declares them. Declared
+ * but unused is fine; absent is fine too. Both backends carry the same
+ * logical uniforms, only the binding scheme differs.
+ *
+ * ## GLSL
+ *
+ * ```glsl
+ * uniform mat3 u_projection;   // active view's projection
+ * uniform mat3 u_translation;  // mesh's global transform
+ * uniform vec4 u_tint;         // mesh.tint as RGBA in 0..1
+ * uniform sampler2D u_texture; // bound to texture slot 0
+ * ```
+ *
+ * ## WGSL
+ *
+ * ```wgsl
+ * struct MeshUniforms {
+ *     projection: mat3x3<f32>,
+ *     translation: mat3x3<f32>,
+ *     tint: vec4<f32>,
+ * };
+ *
+ * @group(0) @binding(0) var<uniform> u_mesh: MeshUniforms;
+ *
+ * @group(1) @binding(0) var u_texture: texture_2d<f32>;
+ * @group(1) @binding(1) var u_sampler: sampler;
+ * ```
+ *
+ * # User uniforms
+ *
+ * Anything in {@link uniforms} is set after the auto-binds. `Texture`/
+ * `RenderTexture` values claim slots 1..N (slot 0 belongs to the mesh).
+ *
+ * ## WGSL user-uniform contract
+ *
+ * User uniforms live in `@group(2)`:
+ *
+ * - `@group(2) @binding(0) var<uniform> u_user: <UserUniformsStruct>;`
+ *   for the packed scalar/vector/matrix uniforms.
+ * - `@group(2) @binding(N)` for each `Texture`/`RenderTexture` uniform,
+ *   in declaration order, alongside its sampler at `@binding(N+1)`.
+ */
+class MeshShader {
+    /**
+     * Mutable user uniform values. Mutate between frames to drive animated
+     * effects; the renderer reads from this map every draw.
+     *
+     *   shader.uniforms.uTime = performance.now() / 1000;
+     *   shader.uniforms.uColor = [1, 0.5, 0, 1];
+     */
+    uniforms;
+    /** GLSL source pair for the WebGL2 backend, or `null` if not provided. */
+    glsl;
+    /** WGSL source for the WebGPU backend, or `null` if not provided. */
+    wgsl;
+    _disposeCallbacks = new Set();
+    constructor(options) {
+        if (options.glsl === undefined && options.wgsl === undefined) {
+            throw new Error('MeshShader requires at least one of `glsl` or `wgsl`.');
+        }
+        if (options.glsl !== undefined) {
+            if (typeof options.glsl.vertex !== 'string' || options.glsl.vertex.length === 0) {
+                throw new Error('MeshShader.glsl.vertex must be a non-empty string.');
+            }
+            if (typeof options.glsl.fragment !== 'string' || options.glsl.fragment.length === 0) {
+                throw new Error('MeshShader.glsl.fragment must be a non-empty string.');
+            }
+        }
+        if (options.wgsl !== undefined && (typeof options.wgsl !== 'string' || options.wgsl.length === 0)) {
+            throw new Error('MeshShader.wgsl must be a non-empty string.');
+        }
+        this.glsl = options.glsl ?? null;
+        this.wgsl = options.wgsl ?? null;
+        this.uniforms = { ...(options.uniforms ?? {}) };
+    }
+    /**
+     * Convenience setter equivalent to `shader.uniforms[name] = value`.
+     * Provided for symmetry with engine APIs that prefer explicit methods
+     * over property mutation.
+     */
+    setUniform(name, value) {
+        this.uniforms[name] = value;
+    }
+    /**
+     * Reflect declared uniforms from each language's source. Returns a per-
+     * language map of uniform-name → declared type, parsed from the shader
+     * sources via lightweight regex (not a full GLSL/WGSL grammar). Texture
+     * uniforms (`sampler2D`/`texture_2d`) are included; sampler bindings
+     * are not (they pair with textures by binding index).
+     *
+     * Reflection is best-effort and intended for CI drift-checks and editor
+     * tooling, not for runtime uniform binding decisions. The renderers do
+     * NOT consult this map; they bind uniforms by name from {@link uniforms}
+     * and let the underlying API resolve declared-but-unused entries.
+     */
+    getDeclaredUniforms() {
+        return {
+            glsl: this.glsl !== null ? parseGlslUniforms(this.glsl.vertex, this.glsl.fragment) : {},
+            wgsl: this.wgsl !== null ? parseWgslUniforms(this.wgsl) : {},
+        };
+    }
+    /**
+     * Compare declared uniform names between the GLSL and WGSL sources.
+     * Returns lists of names declared in only one language. Use in CI to
+     * catch drift when both languages should expose the same logical
+     * uniforms. When only one language is provided, returns empty arrays.
+     *
+     * Auto-bound uniforms (`u_projection`, `u_translation`, `u_tint`,
+     * `u_texture`) are excluded from the comparison since the GLSL source
+     * declares them at the top-level uniform scope while the WGSL source
+     * receives them via the `@group(0)` mesh-uniforms struct and the
+     * `@group(1)` texture binding.
+     */
+    detectUniformDrift() {
+        if (this.glsl === null || this.wgsl === null) {
+            return { onlyInGlsl: [], onlyInWgsl: [] };
+        }
+        const declared = this.getDeclaredUniforms();
+        const glslNames = new Set(Object.keys(declared.glsl).filter(n => !autoBoundUniformNames.has(n)));
+        const wgslNames = new Set(Object.keys(declared.wgsl).filter(n => !autoBoundUniformNames.has(n)));
+        const onlyInGlsl = [];
+        const onlyInWgsl = [];
+        for (const name of glslNames) {
+            if (!wgslNames.has(name))
+                onlyInGlsl.push(name);
+        }
+        for (const name of wgslNames) {
+            if (!glslNames.has(name))
+                onlyInWgsl.push(name);
+        }
+        return { onlyInGlsl, onlyInWgsl };
+    }
+    /**
+     * Release GPU resources cached against this `MeshShader` on every
+     * backend that has compiled it. Safe to call multiple times. After
+     * destroy, the shader can still be re-used — renderers will recompile
+     * on next draw — but typical usage is to drop the reference.
+     */
+    destroy() {
+        for (const callback of this._disposeCallbacks) {
+            callback();
+        }
+        this._disposeCallbacks.clear();
+    }
+    /**
+     * Internal hook for renderers to register a per-shader-instance cleanup
+     * callback (release compiled program, pipeline, or bind groups). The
+     * callback fires on {@link destroy}; renderers MUST also tolerate the
+     * shader being garbage-collected without destroy ever being called.
+     *
+     * @internal
+     */
+    _onDispose(callback) {
+        this._disposeCallbacks.add(callback);
+    }
+}
+const autoBoundUniformNames = new Set(['u_projection', 'u_translation', 'u_tint', 'u_texture', 'u_mesh']);
+const glslUniformPattern = /\buniform\s+(?:mediump\s+|highp\s+|lowp\s+|)(\w+)\s+(\w+)[^;]*;/g;
+const wgslUserUniformPattern = /@group\(\s*2\s*\)\s*@binding\(\s*\d+\s*\)\s*var(?:<[^>]+>|)\s+(\w+)\s*:\s*([^;]+);/g;
+/**
+ * Strip line and block comments from a shader source so the uniform
+ * regexes don't match commented-out declarations. Conservative: works
+ * for both GLSL and WGSL syntax (both use `//` and `/* ... *\/`).
+ */
+function stripComments(source) {
+    return source.replaceAll(/\/\*[\s\S]*?\*\//g, '').replaceAll(/\/\/[^\n]*/g, '');
+}
+function parseGlslUniforms(vertex, fragment) {
+    const result = {};
+    for (const source of [vertex, fragment]) {
+        const stripped = stripComments(source);
+        glslUniformPattern.lastIndex = 0;
+        let match;
+        while ((match = glslUniformPattern.exec(stripped)) !== null) {
+            const [, type, name] = match;
+            result[name] = type;
+        }
+    }
+    return result;
+}
+function parseWgslUniforms(source) {
+    const result = {};
+    const stripped = stripComments(source);
+    // User uniforms in @group(2). Each user-uniform binding is either:
+    //   - var<uniform> u_user: SomeStruct;
+    //   - var u_extraTex: texture_2d<f32>;
+    // We extract the name and the (trimmed) type expression.
+    wgslUserUniformPattern.lastIndex = 0;
+    let match;
+    while ((match = wgslUserUniformPattern.exec(stripped)) !== null) {
+        const [, name, type] = match;
+        result[name] = type.trim();
+    }
+    return result;
+}
+
+export { MeshShader };
+//# sourceMappingURL=MeshShader.js.map

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

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

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

@@ -1,6 +1,6 @@
 import { Color } from '@/core/Color';
-import { Container } from '@/rendering/Container';
 import { Vector } from '@/math/Vector';
+import { Container } from '@/rendering/Container';
 import { Mesh } from '@/rendering/mesh/Mesh';
 import type { RenderNode } from '@/rendering/RenderNode';
 /**
@@ -50,9 +50,9 @@ export declare class Graphics extends Container {
     /** 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;
+    drawPath(path: number[]): this;
     /** Fill a closed polygon defined by `[x0,y0, x1,y1, ...]` and optionally stroke its outline. */
-    drawPolygon(path: Array<number>): this;
+    drawPolygon(path: 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`. */

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

@@ -1,8 +1,8 @@
 import { Color } from '../../core/Color.js';
-import { Container } from '../Container.js';
-import { quadraticCurveTo, bezierCurveTo, tau, clamp } from '../../math/utils.js';
 import { buildLine, buildPath, buildPolygon, buildCircle, buildEllipse, buildStar, buildRectangle } from '../../math/geometry.js';
+import { quadraticCurveTo, bezierCurveTo, tau, clamp } from '../../math/utils.js';
 import { Vector } from '../../math/Vector.js';
+import { Container } from '../Container.js';
 import { Mesh } from '../mesh/Mesh.js';
 
 /**
@@ -109,7 +109,7 @@ class Graphics extends Container {
         const inDirY = inY / inLen;
         const outDirX = outX / outLen;
         const outDirY = outY / outLen;
-        const dot = clamp((inDirX * outDirX) + (inDirY * outDirY), -1, 1);
+        const dot = clamp(inDirX * outDirX + inDirY * outDirY, -1, 1);
         const angle = Math.acos(dot);
         if (angle === 0 || angle === Math.PI) {
             return this.lineTo(x1, y1);
@@ -118,16 +118,16 @@ class Graphics extends Container {
         if (!Number.isFinite(distanceToTangent) || distanceToTangent > inLen || distanceToTangent > outLen) {
             return this.lineTo(x1, y1);
         }
-        const startX = x1 - (inDirX * distanceToTangent);
-        const startY = y1 - (inDirY * distanceToTangent);
-        const endX = x1 + (outDirX * distanceToTangent);
-        const endY = y1 + (outDirY * distanceToTangent);
-        const cross = (inDirX * outDirY) - (inDirY * outDirX);
+        const startX = x1 - inDirX * distanceToTangent;
+        const startY = y1 - inDirY * distanceToTangent;
+        const endX = x1 + outDirX * distanceToTangent;
+        const endY = y1 + outDirY * distanceToTangent;
+        const cross = inDirX * outDirY - inDirY * outDirX;
         const leftTurn = cross > 0;
         const normalX = leftTurn ? -inDirY : inDirY;
         const normalY = leftTurn ? inDirX : -inDirX;
-        const centerX = startX + (normalX * r);
-        const centerY = startY + (normalY * r);
+        const centerX = startX + normalX * r;
+        const centerY = startY + normalY * r;
         const startAngle = Math.atan2(startY - centerY, startX - centerX);
         const endAngle = Math.atan2(endY - centerY, endX - centerX);
         this.lineTo(startX, startY);
@@ -153,8 +153,8 @@ class Graphics extends Container {
         const path = [];
         for (let i = 0; i <= segments; i++) {
             const ratio = i / segments;
-            const angle = startAngle + (sweep * ratio);
-            path.push(x + (Math.cos(angle) * r), y + (Math.sin(angle) * r));
+            const angle = startAngle + sweep * ratio;
+            path.push(x + Math.cos(angle) * r, y + Math.sin(angle) * r);
         }
         this.drawPath(path);
         this.moveTo(path[path.length - 2], path[path.length - 1]);