@codexo/exojs 0.9.0 → 0.11.0

package/dist/esm/rendering/geometry/Geometry.js

@@ -0,0 +1,228 @@
+import { Rectangle } from '../../math/Rectangle.js';
+
+const attributeTypeByteSizes = {
+    f32: 4,
+    u8: 1,
+    u16: 2,
+    u32: 4,
+    i32: 4,
+};
+const validTopologies = new Set(['triangle-list', 'triangle-strip']);
+const validUsages = new Set(['static', 'dynamic', 'stream']);
+const positionAttributeNames = new Set(['a_position', 'position']);
+const geometryIds = new WeakMap();
+let nextGeometryId = 1;
+const getOrCreateGeometryId = (geometry) => {
+    const cached = geometryIds.get(geometry);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const id = nextGeometryId++;
+    geometryIds.set(geometry, id);
+    return id;
+};
+const getVertexCount = (vertexData, stride) => {
+    const { byteLength } = vertexData;
+    if (byteLength % stride !== 0) {
+        throw new Error(`Geometry vertexData byteLength ${byteLength} must be divisible by stride ${stride}.`);
+    }
+    return byteLength / stride;
+};
+const readComponent = (view, type, offset, normalized) => {
+    switch (type) {
+        case 'f32':
+            return view.getFloat32(offset, true);
+        case 'u8': {
+            const value = view.getUint8(offset);
+            return normalized ? value / 255 : value;
+        }
+        case 'u16': {
+            const value = view.getUint16(offset, true);
+            return normalized ? value / 65535 : value;
+        }
+        case 'u32': {
+            const value = view.getUint32(offset, true);
+            return normalized ? value / 4294967295 : value;
+        }
+        case 'i32': {
+            const value = view.getInt32(offset, true);
+            return normalized ? Math.max(value / 2147483647, -1) : value;
+        }
+        default:
+            return 0;
+    }
+};
+const cloneAttributes = (attributes) => {
+    return attributes.map(attribute => ({ ...attribute }));
+};
+const resolvePositionAttribute = (attributes) => {
+    const directMatch = attributes.find(attribute => positionAttributeNames.has(attribute.name));
+    if (directMatch) {
+        return directMatch;
+    }
+    const fuzzyMatch = attributes.find(attribute => attribute.name.toLowerCase().includes('position'));
+    if (fuzzyMatch) {
+        return fuzzyMatch;
+    }
+    throw new Error('Geometry requires a position attribute named `a_position` or `position`.');
+};
+/**
+ * Non-renderable geometry data object used by advanced rendering paths.
+ *
+ * Geometry owns only vertex/index data and its layout metadata; it is not a
+ * scene node, has no transform state, and cannot render itself.
+ * @advanced
+ */
+class Geometry {
+    attributes;
+    stride;
+    topology;
+    usage;
+    indices;
+    vertexData;
+    _version = 0;
+    _localBounds = new Rectangle();
+    _localBoundsDirty = true;
+    _positionAttribute;
+    _disposeCallbacks = new Set();
+    constructor(options) {
+        const { attributes, vertexData, stride, indices = null, topology = 'triangle-list', usage = 'static' } = options;
+        if (attributes.length === 0) {
+            throw new Error('Geometry attributes must be a non-empty array.');
+        }
+        if (!Number.isInteger(stride) || stride <= 0) {
+            throw new Error(`Geometry stride must be a positive integer (got ${stride}).`);
+        }
+        if (!validTopologies.has(topology)) {
+            throw new Error(`Geometry topology must be one of: triangle-list, triangle-strip (got ${String(topology)}).`);
+        }
+        if (!validUsages.has(usage)) {
+            throw new Error(`Geometry usage must be one of: static, dynamic, stream (got ${String(usage)}).`);
+        }
+        const ranges = [];
+        const names = new Set();
+        for (const attribute of attributes) {
+            if (typeof attribute.name !== 'string' || attribute.name.length === 0) {
+                throw new Error('Geometry attribute name must be a non-empty string.');
+            }
+            if (names.has(attribute.name)) {
+                throw new Error(`Geometry attribute "${attribute.name}" is declared more than once.`);
+            }
+            names.add(attribute.name);
+            if (!Number.isInteger(attribute.size) || attribute.size < 1 || attribute.size > 4) {
+                throw new Error(`Geometry attribute "${attribute.name}" size must be an integer in [1..4] (got ${attribute.size}).`);
+            }
+            if (!Number.isInteger(attribute.offset) || attribute.offset < 0) {
+                throw new Error(`Geometry attribute "${attribute.name}" offset must be a non-negative integer (got ${attribute.offset}).`);
+            }
+            const byteSize = attributeTypeByteSizes[attribute.type];
+            const end = attribute.offset + byteSize * attribute.size;
+            if (end > stride) {
+                throw new Error(`Geometry attribute "${attribute.name}" range [${attribute.offset}, ${end}) exceeds stride ${stride}.`);
+            }
+            for (const range of ranges) {
+                if (attribute.offset < range.end && end > range.start) {
+                    throw new Error(`Geometry attribute "${attribute.name}" overlaps attribute "${range.name}" in the interleaved layout.`);
+                }
+            }
+            ranges.push({ name: attribute.name, start: attribute.offset, end });
+        }
+        const positionAttribute = resolvePositionAttribute(attributes);
+        if (positionAttribute.size < 2) {
+            throw new Error(`Geometry position attribute "${positionAttribute.name}" must declare at least 2 components.`);
+        }
+        const vertexCount = getVertexCount(vertexData, stride);
+        if (indices !== null) {
+            for (let i = 0; i < indices.length; i++) {
+                if (indices[i] >= vertexCount) {
+                    throw new Error(`Geometry index ${indices[i]} at position ${i} is out of range for vertex count ${vertexCount}.`);
+                }
+            }
+        }
+        this.attributes = cloneAttributes(attributes);
+        this.vertexData = vertexData;
+        this.stride = stride;
+        this.indices = indices;
+        this.topology = topology;
+        this.usage = usage;
+        this._positionAttribute = { ...positionAttribute };
+    }
+    get vertexCount() {
+        return getVertexCount(this.vertexData, this.stride);
+    }
+    get indexCount() {
+        return this.indices?.length ?? this.vertexCount;
+    }
+    get version() {
+        return this._version;
+    }
+    get id() {
+        return getOrCreateGeometryId(this);
+    }
+    /** Mark vertex data as mutated in place so backends can re-upload GPU buffers. */
+    invalidate() {
+        this._version++;
+        this._localBoundsDirty = true;
+        return this;
+    }
+    /** Return local-space bounds; when `out` is provided it is populated and returned. */
+    getLocalBounds(out = this._localBounds) {
+        if (this._localBoundsDirty) {
+            this.recomputeLocalBounds();
+        }
+        if (out === this._localBounds) {
+            return this._localBounds;
+        }
+        return out.copy(this._localBounds);
+    }
+    /** Force local-space AABB recomputation from the current position attribute data. */
+    recomputeLocalBounds() {
+        const vertexCount = this.vertexCount;
+        if (vertexCount === 0) {
+            this._localBounds.set(0, 0, 0, 0);
+            this._localBoundsDirty = false;
+            return this;
+        }
+        const view = this.vertexData instanceof Float32Array
+            ? new DataView(this.vertexData.buffer, this.vertexData.byteOffset, this.vertexData.byteLength)
+            : new DataView(this.vertexData);
+        const componentByteSize = attributeTypeByteSizes[this._positionAttribute.type];
+        let minX = Infinity;
+        let minY = Infinity;
+        let maxX = -Infinity;
+        let maxY = -Infinity;
+        for (let vertexIndex = 0; vertexIndex < vertexCount; vertexIndex++) {
+            const start = vertexIndex * this.stride + this._positionAttribute.offset;
+            const x = readComponent(view, this._positionAttribute.type, start, this._positionAttribute.normalized);
+            const y = readComponent(view, this._positionAttribute.type, start + componentByteSize, this._positionAttribute.normalized);
+            if (x < minX)
+                minX = x;
+            if (x > maxX)
+                maxX = x;
+            if (y < minY)
+                minY = y;
+            if (y > maxY)
+                maxY = y;
+        }
+        this._localBounds.set(minX, minY, maxX - minX, maxY - minY);
+        this._localBoundsDirty = false;
+        return this;
+    }
+    /** Release backend-owned resources associated with this geometry instance. */
+    destroy() {
+        for (const callback of this._disposeCallbacks) {
+            callback();
+        }
+        this._disposeCallbacks.clear();
+    }
+    /**
+     * Internal backend hook used to register per-geometry cleanup callbacks.
+     * @internal
+     */
+    _onDispose(callback) {
+        this._disposeCallbacks.add(callback);
+    }
+}
+
+export { Geometry };
+//# sourceMappingURL=Geometry.js.map

package/dist/esm/rendering/geometry/Geometry.js.map

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

package/dist/esm/rendering/geometry/GeometryAttribute.d.ts

@@ -0,0 +1,32 @@
+/**
+ * GPU buffer ownership strategy used by geometry-aware render paths.
+ *
+ * - `static`  — immutable after creation; eligible for shared batched buffers.
+ * - `dynamic` — occasionally mutated; backend should keep a dedicated buffer.
+ * - `stream`  — mutated every frame; backend should treat as immediate data.
+ */
+export type GeometryUsage = 'static' | 'dynamic' | 'stream';
+/** Scalar component type used by a geometry vertex attribute. */
+export type AttributeType = 'f32' | 'u8' | 'u16' | 'u32' | 'i32';
+/** Primitive topology used when drawing this geometry. */
+export type Topology = 'triangle-list' | 'triangle-strip';
+/**
+ * Descriptor for one attribute in an interleaved vertex layout.
+ * Offsets and stride are expressed in bytes.
+ */
+export interface GeometryAttribute {
+    readonly name: string;
+    readonly size: number;
+    readonly type: AttributeType;
+    readonly normalized: boolean;
+    readonly offset: number;
+}
+/** Construction options for {@link Geometry}. */
+export interface GeometryOptions {
+    readonly attributes: readonly GeometryAttribute[];
+    readonly vertexData: Float32Array | ArrayBuffer;
+    readonly stride: number;
+    readonly indices?: Uint16Array | Uint32Array | null;
+    readonly topology?: Topology;
+    readonly usage?: GeometryUsage;
+}

package/dist/esm/rendering/geometry/QuadGeometry.d.ts

@@ -0,0 +1,5 @@
+import { Geometry } from './Geometry';
+/** @internal */
+export declare class QuadGeometry extends Geometry {
+    constructor();
+}

package/dist/esm/rendering/gradient/Gradient.d.ts

@@ -0,0 +1,67 @@
+import type { Color } from '@/core/Color';
+import type { Cloneable, Destroyable } from '@/core/types';
+import { DataTexture } from '@/rendering/texture/DataTexture';
+import type { SamplerOptions } from '@/rendering/texture/Sampler';
+/** Discriminant identifying the concrete gradient kind (`gradient.type`). */
+export type GradientType = 'linear' | 'radial';
+export interface GradientStop {
+    offset: number;
+    color: Color;
+}
+export interface GradientToTextureOptions {
+    readonly format?: 'rgba8' | 'rgba32f';
+    readonly samplerOptions?: Partial<SamplerOptions>;
+}
+/**
+ * CPU-rasterized gradient base. A {@link Color}-like paint value (not a
+ * {@link Drawable}): it owns a normalized list of color stops plus subclass
+ * geometry and supports the value-object contract — {@link Gradient.clone},
+ * {@link Gradient.copy}, and {@link Gradient.equals}. Stops are cloned on the
+ * way in, clamped to `0..1`, and kept sorted by offset.
+ *
+ * Convert a gradient into a sampleable {@link DataTexture} with
+ * {@link Gradient.toTexture}; wrap that texture in a `Sprite`/`Mesh` to draw it.
+ */
+export declare abstract class Gradient implements Cloneable, Destroyable {
+    /** Concrete gradient kind, e.g. `'linear'` or `'radial'`. */
+    abstract readonly type: GradientType;
+    private _stops;
+    private readonly _sample;
+    protected constructor(stops: readonly GradientStop[]);
+    get stops(): readonly GradientStop[];
+    /** Deep-clone into a new instance of the same concrete gradient type. */
+    abstract clone(): this;
+    /**
+     * Copy every value (stops and geometry) from a same-type `source` into this
+     * instance, replacing its current state. Returns `this` for chaining.
+     */
+    copy(source: this): this;
+    /**
+     * Structural value equality: same {@link GradientType}, same ordered stops
+     * (offset and {@link Color}), and same subclass geometry.
+     */
+    equals(other: Gradient): boolean;
+    toTexture(width: number, height: number, options?: GradientToTextureOptions & {
+        format?: 'rgba8';
+    }): DataTexture<'rgba8'>;
+    toTexture(width: number, height: number, options: GradientToTextureOptions & {
+        format: 'rgba32f';
+    }): DataTexture<'rgba32f'>;
+    destroy(): void;
+    protected abstract resolveT(u: number, v: number): number;
+    /** Copy the concrete subclass geometry from a same-type `source`. */
+    protected abstract _copyGeometry(source: this): void;
+    /**
+     * Compare the concrete subclass geometry against `other`. Only invoked once
+     * {@link Gradient.equals} has confirmed both sides share the same
+     * {@link GradientType}, so implementations may narrow `other` accordingly.
+     */
+    protected abstract _geometryEquals(other: Gradient): boolean;
+    /**
+     * Shared stop sampling logic ported from the legacy GLSL implementation.
+     */
+    protected sampleAt(t: number, out: Float32Array): void;
+    private static _normalizeStops;
+    private _toRgba8Texture;
+    private _toRgba32fTexture;
+}

package/dist/esm/rendering/gradient/Gradient.js

@@ -0,0 +1,160 @@
+import { clamp } from '../../math/utils.js';
+import { DataTexture } from '../texture/DataTexture.js';
+
+const sortedStopOffset = (left, right) => left.offset - right.offset;
+/**
+ * CPU-rasterized gradient base. A {@link Color}-like paint value (not a
+ * {@link Drawable}): it owns a normalized list of color stops plus subclass
+ * geometry and supports the value-object contract — {@link Gradient.clone},
+ * {@link Gradient.copy}, and {@link Gradient.equals}. Stops are cloned on the
+ * way in, clamped to `0..1`, and kept sorted by offset.
+ *
+ * Convert a gradient into a sampleable {@link DataTexture} with
+ * {@link Gradient.toTexture}; wrap that texture in a `Sprite`/`Mesh` to draw it.
+ */
+class Gradient {
+    _stops;
+    _sample = new Float32Array(4);
+    constructor(stops) {
+        this._stops = Gradient._normalizeStops(stops);
+    }
+    get stops() {
+        return this._stops;
+    }
+    /**
+     * Copy every value (stops and geometry) from a same-type `source` into this
+     * instance, replacing its current state. Returns `this` for chaining.
+     */
+    copy(source) {
+        this._stops = source._stops.map(stop => ({ offset: stop.offset, color: stop.color.clone() }));
+        this._copyGeometry(source);
+        return this;
+    }
+    /**
+     * Structural value equality: same {@link GradientType}, same ordered stops
+     * (offset and {@link Color}), and same subclass geometry.
+     */
+    equals(other) {
+        if (this === other) {
+            return true;
+        }
+        if (this.type !== other.type || this._stops.length !== other._stops.length) {
+            return false;
+        }
+        for (let i = 0; i < this._stops.length; i++) {
+            const own = this._stops[i];
+            const their = other._stops[i];
+            if (own.offset !== their.offset || !own.color.equals(their.color)) {
+                return false;
+            }
+        }
+        return this._geometryEquals(other);
+    }
+    toTexture(width, height, options = {}) {
+        if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
+            throw new Error('Gradient.toTexture() width/height must be positive integers.');
+        }
+        if (options.format === 'rgba32f') {
+            return this._toRgba32fTexture(width, height, options);
+        }
+        return this._toRgba8Texture(width, height, options);
+    }
+    destroy() {
+        for (const stop of this._stops) {
+            stop.color.destroy();
+        }
+        this._stops = [];
+    }
+    /**
+     * Shared stop sampling logic ported from the legacy GLSL implementation.
+     */
+    sampleAt(t, out) {
+        const clamped = clamp(t, 0, 1);
+        const first = this._stops[0];
+        let previousOffset = first.offset;
+        let previousColor = first.color;
+        for (let i = 1; i < this._stops.length; i++) {
+            const current = this._stops[i];
+            if (clamped <= current.offset) {
+                const span = Math.max(current.offset - previousOffset, 0.000001);
+                const ratio = clamp((clamped - previousOffset) / span, 0, 1);
+                out[0] = previousColor.r / 255 + (current.color.r / 255 - previousColor.r / 255) * ratio;
+                out[1] = previousColor.g / 255 + (current.color.g / 255 - previousColor.g / 255) * ratio;
+                out[2] = previousColor.b / 255 + (current.color.b / 255 - previousColor.b / 255) * ratio;
+                out[3] = previousColor.a + (current.color.a - previousColor.a) * ratio;
+                return;
+            }
+            previousOffset = current.offset;
+            previousColor = current.color;
+        }
+        out[0] = previousColor.r / 255;
+        out[1] = previousColor.g / 255;
+        out[2] = previousColor.b / 255;
+        out[3] = previousColor.a;
+    }
+    static _normalizeStops(stops) {
+        if (stops.length < 2) {
+            throw new Error('Gradient requires at least 2 color stops.');
+        }
+        return stops
+            .map(stop => {
+            if (!Number.isFinite(stop.offset)) {
+                throw new Error('Gradient stop offset must be a finite number.');
+            }
+            return { offset: clamp(stop.offset, 0, 1), color: stop.color.clone() };
+        })
+            .sort(sortedStopOffset);
+    }
+    _toRgba8Texture(width, height, options) {
+        const texture = new DataTexture({
+            width,
+            height,
+            format: 'rgba8',
+            samplerOptions: options.samplerOptions,
+        });
+        const buffer = texture.buffer;
+        let offset = 0;
+        for (let y = 0; y < height; y++) {
+            const v = height === 1 ? 0 : y / (height - 1);
+            for (let x = 0; x < width; x++) {
+                const u = width === 1 ? 0 : x / (width - 1);
+                this.sampleAt(this.resolveT(u, v), this._sample);
+                buffer[offset] = toUnorm8(this._sample[0]);
+                buffer[offset + 1] = toUnorm8(this._sample[1]);
+                buffer[offset + 2] = toUnorm8(this._sample[2]);
+                buffer[offset + 3] = toUnorm8(this._sample[3]);
+                offset += 4;
+            }
+        }
+        texture.commit();
+        return texture;
+    }
+    _toRgba32fTexture(width, height, options) {
+        const texture = new DataTexture({
+            width,
+            height,
+            format: 'rgba32f',
+            samplerOptions: options.samplerOptions,
+        });
+        const buffer = texture.buffer;
+        let offset = 0;
+        for (let y = 0; y < height; y++) {
+            const v = height === 1 ? 0 : y / (height - 1);
+            for (let x = 0; x < width; x++) {
+                const u = width === 1 ? 0 : x / (width - 1);
+                this.sampleAt(this.resolveT(u, v), this._sample);
+                buffer[offset] = this._sample[0];
+                buffer[offset + 1] = this._sample[1];
+                buffer[offset + 2] = this._sample[2];
+                buffer[offset + 3] = this._sample[3];
+                offset += 4;
+            }
+        }
+        texture.commit();
+        return texture;
+    }
+}
+const toUnorm8 = (value) => (clamp(value, 0, 1) * 255 + 0.5) | 0;
+
+export { Gradient };
+//# sourceMappingURL=Gradient.js.map

package/dist/esm/rendering/gradient/Gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gradient.js","sources":["../../../../../src/rendering/gradient/Gradient.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAwBA,MAAM,gBAAgB,GAAG,CAAC,IAA0B,EAAE,KAA2B,KAAa,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;AAExH;;;;;;;;;AASG;MACmB,QAAQ,CAAA;AAIpB,IAAA,MAAM;AACG,IAAA,OAAO,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC;AAE9C,IAAA,WAAA,CAAsB,KAA8B,EAAA;QAClD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC;IAC/C;AAEA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;AAKA;;;AAGG;AACI,IAAA,IAAI,CAAC,MAAY,EAAA;AACtB,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7F,QAAA,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;AAE1B,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACI,IAAA,MAAM,CAAC,KAAe,EAAA;AAC3B,QAAA,IAAI,IAAI,KAAK,KAAK,EAAE;AAClB,YAAA,OAAO,IAAI;QACb;QAEA,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;AAC1E,YAAA,OAAO,KAAK;QACd;AAEA,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAE7B,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;AACjE,gBAAA,OAAO,KAAK;YACd;QACF;AAEA,QAAA,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;IACpC;AAIO,IAAA,SAAS,CAAC,KAAa,EAAE,MAAc,EAAE,UAAoC,EAAE,EAAA;QACpF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE;AACtF,YAAA,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC;QACjF;AAEA,QAAA,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE;YAChC,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;QACvD;QAEA,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;IACrD;IAEO,OAAO,GAAA;AACZ,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE;AAC9B,YAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;QACtB;AAEA,QAAA,IAAI,CAAC,MAAM,GAAG,EAAE;IAClB;AAcA;;AAEG;IACO,QAAQ,CAAC,CAAS,EAAE,GAAiB,EAAA;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5B,QAAA,IAAI,cAAc,GAAG,KAAK,CAAC,MAAM;AACjC,QAAA,IAAI,aAAa,GAAG,KAAK,CAAC,KAAK;AAE/B,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAE9B,YAAA,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE;AAC7B,gBAAA,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,cAAc,EAAE,QAAQ,CAAC;AAChE,gBAAA,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;gBAE5D,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK;gBACxF,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK;gBACxF,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK;gBACxF,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,KAAK;gBAEtE;YACF;AAEA,YAAA,cAAc,GAAG,OAAO,CAAC,MAAM;AAC/B,YAAA,aAAa,GAAG,OAAO,CAAC,KAAK;QAC/B;QAEA,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG;QAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG;QAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,GAAG;AAC9B,QAAA,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;IAC1B;IAEQ,OAAO,eAAe,CAAC,KAA8B,EAAA;AAC3D,QAAA,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;AACpB,YAAA,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC;QAC9D;AAEA,QAAA,OAAO;aACJ,GAAG,CAAC,IAAI,IAAG;YACV,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;AACjC,gBAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;YAClE;YAEA,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE;AACxE,QAAA,CAAC;aACA,IAAI,CAAC,gBAAgB,CAAC;IAC3B;AAEQ,IAAA,eAAe,CAAC,KAAa,EAAE,MAAc,EAAE,OAAiC,EAAA;AACtF,QAAA,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC9B,KAAK;YACL,MAAM;AACN,YAAA,MAAM,EAAE,OAAO;YACf,cAAc,EAAE,OAAO,CAAC,cAAc;AACvC,SAAA,CAAC;AACF,QAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;QAE7B,IAAI,MAAM,GAAG,CAAC;AAEd,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;AAC/B,YAAA,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AAE7C,YAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE;AAC9B,gBAAA,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAE3C,gBAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC;AAEhD,gBAAA,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1C,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC9C,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC9C,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC9C,MAAM,IAAI,CAAC;YACb;QACF;QAEA,OAAO,CAAC,MAAM,EAAE;AAEhB,QAAA,OAAO,OAAO;IAChB;AAEQ,IAAA,iBAAiB,CAAC,KAAa,EAAE,MAAc,EAAE,OAAiC,EAAA;AACxF,QAAA,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC9B,KAAK;YACL,MAAM;AACN,YAAA,MAAM,EAAE,SAAS;YACjB,cAAc,EAAE,OAAO,CAAC,cAAc;AACvC,SAAA,CAAC;AACF,QAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;QAE7B,IAAI,MAAM,GAAG,CAAC;AAEd,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;AAC/B,YAAA,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AAE7C,YAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE;AAC9B,gBAAA,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAE3C,gBAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC;gBAEhD,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAChC,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACpC,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACpC,gBAAA,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBACpC,MAAM,IAAI,CAAC;YACb;QACF;QAEA,OAAO,CAAC,MAAM,EAAE;AAEhB,QAAA,OAAO,OAAO;IAChB;AACD;AAED,MAAM,QAAQ,GAAG,CAAC,KAAa,KAAa,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;;;;"}

package/dist/esm/rendering/gradient/LinearGradient.d.ts

@@ -0,0 +1,18 @@
+import { Gradient, type GradientStop, type GradientType } from './Gradient';
+/**
+ * Linear gradient in UV space projected from `start` to `end`.
+ */
+export declare class LinearGradient extends Gradient {
+    readonly type: GradientType;
+    private _start;
+    private _end;
+    constructor(stops: readonly GradientStop[], start?: readonly [number, number], end?: readonly [number, number]);
+    /** Projection axis start point in UV space. */
+    get start(): readonly [number, number];
+    /** Projection axis end point in UV space. */
+    get end(): readonly [number, number];
+    clone(): this;
+    protected resolveT(u: number, v: number): number;
+    protected _copyGeometry(source: LinearGradient): void;
+    protected _geometryEquals(other: Gradient): boolean;
+}

package/dist/esm/rendering/gradient/LinearGradient.js

@@ -0,0 +1,49 @@
+import { Gradient } from './Gradient.js';
+
+/**
+ * Linear gradient in UV space projected from `start` to `end`.
+ */
+class LinearGradient extends Gradient {
+    type = 'linear';
+    _start;
+    _end;
+    constructor(stops, start = [0, 0], end = [1, 0]) {
+        super(stops);
+        this._start = [start[0], start[1]];
+        this._end = [end[0], end[1]];
+    }
+    /** Projection axis start point in UV space. */
+    get start() {
+        return [this._start[0], this._start[1]];
+    }
+    /** Projection axis end point in UV space. */
+    get end() {
+        return [this._end[0], this._end[1]];
+    }
+    clone() {
+        return new LinearGradient(this.stops, this._start, this._end);
+    }
+    resolveT(u, v) {
+        const axisX = this._end[0] - this._start[0];
+        const axisY = this._end[1] - this._start[1];
+        const lengthSquared = axisX * axisX + axisY * axisY;
+        if (lengthSquared <= 0.000001) {
+            return 0;
+        }
+        return ((u - this._start[0]) * axisX + (v - this._start[1]) * axisY) / lengthSquared;
+    }
+    _copyGeometry(source) {
+        this._start = [source._start[0], source._start[1]];
+        this._end = [source._end[0], source._end[1]];
+    }
+    _geometryEquals(other) {
+        return (other instanceof LinearGradient &&
+            this._start[0] === other._start[0] &&
+            this._start[1] === other._start[1] &&
+            this._end[0] === other._end[0] &&
+            this._end[1] === other._end[1]);
+    }
+}
+
+export { LinearGradient };
+//# sourceMappingURL=LinearGradient.js.map

package/dist/esm/rendering/gradient/LinearGradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinearGradient.js","sources":["../../../../../src/rendering/gradient/LinearGradient.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;AAEG;AACG,MAAO,cAAe,SAAQ,QAAQ,CAAA;IAC1B,IAAI,GAAiB,QAAQ;AAErC,IAAA,MAAM;AACN,IAAA,IAAI;AAEZ,IAAA,WAAA,CAAmB,KAA8B,EAAE,KAAA,GAAmC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAA,GAAiC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAA;QACnI,KAAK,CAAC,KAAK,CAAC;AAEZ,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAClC,QAAA,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B;;AAGA,IAAA,IAAW,KAAK,GAAA;AACd,QAAA,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzC;;AAGA,IAAA,IAAW,GAAG,GAAA;AACZ,QAAA,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC;IAEO,KAAK,GAAA;AACV,QAAA,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAS;IACvE;IAEmB,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAA;AAC9C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK;AAEnD,QAAA,IAAI,aAAa,IAAI,QAAQ,EAAE;AAC7B,YAAA,OAAO,CAAC;QACV;AAEA,QAAA,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,aAAa;IACtF;AAEmB,IAAA,aAAa,CAAC,MAAsB,EAAA;AACrD,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAClD,QAAA,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C;AAEmB,IAAA,eAAe,CAAC,KAAe,EAAA;QAChD,QACE,KAAK,YAAY,cAAc;YAC/B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9B,YAAA,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAElC;AACD;;;;"}

package/dist/esm/rendering/gradient/RadialGradient.d.ts

@@ -0,0 +1,18 @@
+import { Gradient, type GradientStop, type GradientType } from './Gradient';
+/**
+ * Radial gradient in UV space around `center` with normalized radius.
+ */
+export declare class RadialGradient extends Gradient {
+    readonly type: GradientType;
+    private _center;
+    private _radius;
+    constructor(stops: readonly GradientStop[], center?: readonly [number, number], radius?: number);
+    /** Gradient center in UV space. */
+    get center(): readonly [number, number];
+    /** Normalized radius (UV units, clamped to be non-negative). */
+    get radius(): number;
+    clone(): this;
+    protected resolveT(u: number, v: number): number;
+    protected _copyGeometry(source: RadialGradient): void;
+    protected _geometryEquals(other: Gradient): boolean;
+}

package/dist/esm/rendering/gradient/RadialGradient.js

@@ -0,0 +1,44 @@
+import { Gradient } from './Gradient.js';
+
+/**
+ * Radial gradient in UV space around `center` with normalized radius.
+ */
+class RadialGradient extends Gradient {
+    type = 'radial';
+    _center;
+    _radius;
+    constructor(stops, center = [0.5, 0.5], radius = 0.5) {
+        super(stops);
+        this._center = [center[0], center[1]];
+        this._radius = Math.max(0, radius);
+    }
+    /** Gradient center in UV space. */
+    get center() {
+        return [this._center[0], this._center[1]];
+    }
+    /** Normalized radius (UV units, clamped to be non-negative). */
+    get radius() {
+        return this._radius;
+    }
+    clone() {
+        return new RadialGradient(this.stops, this._center, this._radius);
+    }
+    resolveT(u, v) {
+        if (this._radius <= 0.000001) {
+            return 1;
+        }
+        const dx = u - this._center[0];
+        const dy = v - this._center[1];
+        return Math.sqrt(dx * dx + dy * dy) / this._radius;
+    }
+    _copyGeometry(source) {
+        this._center = [source._center[0], source._center[1]];
+        this._radius = source._radius;
+    }
+    _geometryEquals(other) {
+        return other instanceof RadialGradient && this._center[0] === other._center[0] && this._center[1] === other._center[1] && this._radius === other._radius;
+    }
+}
+
+export { RadialGradient };
+//# sourceMappingURL=RadialGradient.js.map