fraxel 0.1.0-alpha.1

package/dist/math/vector2.d.ts

@@ -0,0 +1,145 @@
+/** **`Vector2`** class helps to manage points in the plane. */
+export declare class Vector2 {
+    /** The **`x`** property of `Vector2` represents the x-coordinate. */
+    x: number;
+    /** The **`y`** property of `Vector2` represents the y-coordinate. */
+    y: number;
+    /** Vector in position ZERO (0, 0) */
+    static get ZERO(): Vector2;
+    /** Vector in position ONE (1, 1) */
+    static get ONE(): Vector2;
+    /**
+     * The **`fromJSON`** method creates a `Vector2` from a `Position` object.
+     * @param position The position object with `x` and `y` properties.
+     * @returns A new `Vector2` instance.
+     *
+     * @example
+     * ```ts
+     * const vec = Vector2.fromJSON({ x: 10, y: 20 })
+     * vec.x // 10
+     * vec.y // 20
+     * ```
+     */
+    static fromJSON(position: Position): Vector2;
+    static vectorize(vectorlike: VectorLike): Vector2;
+    constructor(
+    /** The **`x`** property of `Vector2` represents the x-coordinate. */
+    x: number, 
+    /** The **`y`** property of `Vector2` represents the y-coordinate. */
+    y: number);
+    /**
+     * The **`clone`** method clones the vector without the same reference.
+     */
+    clone(): Vector2;
+    /**
+     * The **`add`** method adds other vector to this vector.
+     * @param vector2
+     */
+    add(vector2: Vector2): Vector2;
+    /**
+     * The **`add`** method adds a number to `x` and `y` of this vector.
+     * @param vector2
+     */
+    add(num: number): Vector2;
+    /**
+     * The **`toAdded`** method clones this vector and adds other vector to the clone.
+     * @param vector2
+     */
+    toAdded(vector2: Vector2): Vector2;
+    /**
+     * The **`toAdded`** method clones this vector and adds a number to `x` and `y` of the clone.
+     * @param num
+     */
+    toAdded(num: number): Vector2;
+    /**
+     * The **`subtract`** method subtracts other vector to this vector.
+     * @param vector2
+     */
+    subtract(vector2: Vector2): Vector2;
+    /**
+     * The **`subtract`** method subtracts a number to `x` and `y` of this vector.
+     * @param num
+     */
+    subtract(num: number): Vector2;
+    /**
+     * The **`toSubtracted`** method clones this vector and subtracts other vector to the clone.
+     * @param vector2
+     */
+    toSubtracted(vector2: Vector2): Vector2;
+    /**
+     * The **`toSubtracted`** method clones this vector and subtracts a number to `x` and `y` of the clone.
+     * @param num
+     */
+    toSubtracted(num: number): Vector2;
+    /**
+     * The **`multiply`** method multiplies other vector to this vector.
+     * @param vector2
+     */
+    multiply(vector2: Vector2): Vector2;
+    /**
+     * The **`multiply`** method multiplies a number to `x` and `y` of this vector.
+     * @param num
+     */
+    multiply(num: number): Vector2;
+    /**
+     * The **`toMultiplied`** method clones this vector and multiplies other vector to the clone.
+     * @param vector2
+     */
+    toMultiplied(vector2: Vector2): Vector2;
+    /**
+     * The **`toMultiplied`** method clones this vector and multiplies a number to `x` and `y` of the clone.
+     * @param num
+     */
+    toMultiplied(num: number): Vector2;
+    apply(fn: (coord: number, axis: 'x' | 'y') => number): Vector2;
+    toApplied(fn: (coord: number, axis: 'x' | 'y') => number): Vector2;
+    /**
+     * The **`equals`** method checks if this vector has the same x and y values as another vector.
+     * @param vector2 The vector to compare with.
+     * @returns `true` if both components are equal, `false` otherwise.
+     *
+     * @example
+     * ```ts
+     * const a = new Vector2(1, 2)
+     * const b = new Vector2(1, 2)
+     * a.equals(b) // true
+     * ```
+     */
+    equals(vector2: Vector2): boolean;
+    /**
+     * The **`normalize`** method scales this vector to unit length (magnitude of 1).
+     * If the vector is zero, it remains zero.
+     * @returns This vector for chaining.
+     *
+     * @example
+     * ```ts
+     * const dir = new Vector2(3, 4)
+     * dir.normalize() // magnitude is now 1
+     * ```
+     */
+    normalize(): this;
+    /**
+     * The **`toJSON`** method converts this vector to a plain `Position` object.
+     * @returns A `Position` object with `x` and `y` properties.
+     *
+     * @example
+     * ```ts
+     * const pos = new Vector2(10, 20)
+     * pos.toJSON() // { x: 10, y: 20 }
+     * ```
+     */
+    toJSON(): Position;
+}
+/**
+ * The **`Position`** interface represents a 2D point with `x` and `y` coordinates.
+ * Used as a lightweight alternative to `Vector2` when methods are not needed.
+ */
+export interface Position {
+    /** The x-coordinate. */
+    x: number;
+    /** The y-coordinate. */
+    y: number;
+}
+export type VectorLike = Vector2 | Position | [x: number, y: number] | number;
+export declare function vectorize(vectorLike: VectorLike): Vector2;
+//# sourceMappingURL=vector2.d.ts.map

package/dist/math/vector2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector2.d.ts","sourceRoot":"","sources":["../../src/math/vector2.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,qBAAa,OAAO;IA+BhB,qEAAqE;IAC9D,CAAC,EAAE,MAAM;IAChB,qEAAqE;IAC9D,CAAC,EAAE,MAAM;IAjClB,qCAAqC;IACrC,MAAM,KAAK,IAAI,YAEd;IACD,oCAAoC;IACpC,MAAM,KAAK,GAAG,YAEb;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAI5C,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU;;IAKrC,qEAAqE;IAC9D,CAAC,EAAE,MAAM;IAChB,qEAAqE;IAC9D,CAAC,EAAE,MAAM;IAGlB;;OAEG;IACH,KAAK;IAIL;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAC9B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAczB;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAClC;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IACnC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAc9B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IACvC;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKlC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IACnC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAc9B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IACvC;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKlC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,KAAK,MAAM,GAAG,OAAO;IAK9D,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,KAAK,MAAM,GAAG,OAAO;IAIlE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAIjC;;;;;;;;;;OAUG;IACH,SAAS;IAUT;;;;;;;;;OASG;IACH,MAAM,IAAI,QAAQ;CAMnB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAA;IACT,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAA;AAE7E,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,WAmB/C"}

package/dist/math/vector2.js

@@ -0,0 +1,164 @@
+import { InvalidVectorLikeError } from '../errors/math.js';
+/** **`Vector2`** class helps to manage points in the plane. */
+export class Vector2 {
+    x;
+    y;
+    /** Vector in position ZERO (0, 0) */
+    static get ZERO() {
+        return new Vector2(0, 0);
+    }
+    /** Vector in position ONE (1, 1) */
+    static get ONE() {
+        return new Vector2(1, 1);
+    }
+    /**
+     * The **`fromJSON`** method creates a `Vector2` from a `Position` object.
+     * @param position The position object with `x` and `y` properties.
+     * @returns A new `Vector2` instance.
+     *
+     * @example
+     * ```ts
+     * const vec = Vector2.fromJSON({ x: 10, y: 20 })
+     * vec.x // 10
+     * vec.y // 20
+     * ```
+     */
+    static fromJSON(position) {
+        return new Vector2(position.x, position.y);
+    }
+    static vectorize(vectorlike) {
+        return vectorize(vectorlike);
+    }
+    constructor(
+    /** The **`x`** property of `Vector2` represents the x-coordinate. */
+    x, 
+    /** The **`y`** property of `Vector2` represents the y-coordinate. */
+    y) {
+        this.x = x;
+        this.y = y;
+    }
+    /**
+     * The **`clone`** method clones the vector without the same reference.
+     */
+    clone() {
+        return new Vector2(this.x, this.y);
+    }
+    add(arg) {
+        if (arg instanceof Vector2) {
+            this.x += arg.x;
+            this.y += arg.y;
+        }
+        if (typeof arg === 'number') {
+            this.x += arg;
+            this.y += arg;
+        }
+        return this;
+    }
+    toAdded(arg) {
+        return this.clone().add(arg);
+    }
+    subtract(arg) {
+        if (arg instanceof Vector2) {
+            this.x -= arg.x;
+            this.y -= arg.y;
+        }
+        if (typeof arg === 'number') {
+            this.x -= arg;
+            this.y -= arg;
+        }
+        return this;
+    }
+    toSubtracted(arg) {
+        return this.clone().subtract(arg);
+    }
+    multiply(arg) {
+        if (arg instanceof Vector2) {
+            this.x *= arg.x;
+            this.y *= arg.y;
+        }
+        if (typeof arg === 'number') {
+            this.x *= arg;
+            this.y *= arg;
+        }
+        return this;
+    }
+    toMultiplied(arg) {
+        return this.clone().multiply(arg);
+    }
+    apply(fn) {
+        this.x = fn(this.x, 'x');
+        this.y = fn(this.y, 'y');
+        return this;
+    }
+    toApplied(fn) {
+        return this.clone().apply(fn);
+    }
+    /**
+     * The **`equals`** method checks if this vector has the same x and y values as another vector.
+     * @param vector2 The vector to compare with.
+     * @returns `true` if both components are equal, `false` otherwise.
+     *
+     * @example
+     * ```ts
+     * const a = new Vector2(1, 2)
+     * const b = new Vector2(1, 2)
+     * a.equals(b) // true
+     * ```
+     */
+    equals(vector2) {
+        return this.x === vector2.x && this.y === vector2.y;
+    }
+    /**
+     * The **`normalize`** method scales this vector to unit length (magnitude of 1).
+     * If the vector is zero, it remains zero.
+     * @returns This vector for chaining.
+     *
+     * @example
+     * ```ts
+     * const dir = new Vector2(3, 4)
+     * dir.normalize() // magnitude is now 1
+     * ```
+     */
+    normalize() {
+        const length = Math.sqrt(this.x * this.x + this.y * this.y);
+        if (length > 0) {
+            this.x /= length;
+            this.y /= length;
+        }
+        return this;
+    }
+    /**
+     * The **`toJSON`** method converts this vector to a plain `Position` object.
+     * @returns A `Position` object with `x` and `y` properties.
+     *
+     * @example
+     * ```ts
+     * const pos = new Vector2(10, 20)
+     * pos.toJSON() // { x: 10, y: 20 }
+     * ```
+     */
+    toJSON() {
+        return {
+            x: this.x,
+            y: this.y,
+        };
+    }
+}
+export function vectorize(vectorLike) {
+    if (vectorLike instanceof Vector2)
+        return vectorLike;
+    if (typeof vectorLike === 'number')
+        return new Vector2(vectorLike, vectorLike);
+    if ('x' in vectorLike &&
+        typeof vectorLike.x === 'number' &&
+        'y' in vectorLike &&
+        typeof vectorLike.y === 'number')
+        return Vector2.fromJSON(vectorLike);
+    if (Array.isArray(vectorLike) &&
+        vectorLike.length === 2 &&
+        typeof vectorLike[0] === 'number' &&
+        typeof vectorLike[1] === 'number')
+        return new Vector2(...vectorLike);
+    throw new InvalidVectorLikeError(vectorLike);
+}
+//# sourceMappingURL=vector2.js.map

package/dist/math/vector2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector2.js","sourceRoot":"","sources":["../../src/math/vector2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,+DAA+D;AAC/D,MAAM,OAAO,OAAO;IAgCT;IAEA;IAjCT,qCAAqC;IACrC,MAAM,KAAK,IAAI;QACb,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1B,CAAC;IACD,oCAAoC;IACpC,MAAM,KAAK,GAAG;QACZ,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1B,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAkB;QAChC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,UAAsB;QACrC,OAAO,SAAS,CAAC,UAAU,CAAC,CAAA;IAC9B,CAAC;IAED;IACE,qEAAqE;IAC9D,CAAS;IAChB,qEAAqE;IAC9D,CAAS;QAFT,MAAC,GAAD,CAAC,CAAQ;QAET,MAAC,GAAD,CAAC,CAAQ;IACf,CAAC;IAEJ;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC;IAYD,GAAG,CAAC,GAAqB;QACvB,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;YACf,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;YACb,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;QACf,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAYD,OAAO,CAAC,GAAqB;QAC3B,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAa,CAAC,CAAA;IACxC,CAAC;IAYD,QAAQ,CAAC,GAAqB;QAC5B,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;YACf,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;YACb,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;QACf,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAYD,YAAY,CAAC,GAAqB;QAChC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,GAAa,CAAC,CAAA;IAC7C,CAAC;IAYD,QAAQ,CAAC,GAAqB;QAC5B,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;YACf,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;YACb,IAAI,CAAC,CAAC,IAAI,GAAG,CAAA;QACf,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAYD,YAAY,CAAC,GAAqB;QAChC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,GAAa,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,EAA8C;QAClD,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACxB,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,SAAS,CAAC,EAA8C;QACtD,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAgB;QACrB,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAA;IACrD,CAAC;IAED;;;;;;;;;;OAUG;IACH,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QAC3D,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,IAAI,MAAM,CAAA;YAChB,IAAI,CAAC,CAAC,IAAI,MAAM,CAAA;QAClB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM;QACJ,OAAO;YACL,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,CAAC,EAAE,IAAI,CAAC,CAAC;SACV,CAAA;IACH,CAAC;CACF;AAeD,MAAM,UAAU,SAAS,CAAC,UAAsB;IAC9C,IAAI,UAAU,YAAY,OAAO;QAAE,OAAO,UAAU,CAAA;IACpD,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;IAC9E,IACE,GAAG,IAAI,UAAU;QACjB,OAAO,UAAU,CAAC,CAAC,KAAK,QAAQ;QAChC,GAAG,IAAI,UAAU;QACjB,OAAO,UAAU,CAAC,CAAC,KAAK,QAAQ;QAEhC,OAAO,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IACrC,IACE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACzB,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,QAAQ;QACjC,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,QAAQ;QAEjC,OAAO,IAAI,OAAO,CAAC,GAAG,UAAU,CAAC,CAAA;IAEnC,MAAM,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAAA;AAC9C,CAAC"}

package/dist/nodes/_node.d.ts

@@ -0,0 +1,283 @@
+import { Event } from '../events/event.js';
+import { type NodeInstances } from './lib/types.js';
+import { PrimaryNode } from './lib/enum.js';
+import type { DinixScript } from '../scripts/script.js';
+export interface NodeOptions<T extends PrimaryNode> {
+    /**
+     * The **`id`** property of a node represents the node's identifier.
+     * It can be used to retrieve this node via `child()`.
+     * IDs can be non-unique and must match `([a-zA-Z][a-zA-Z0-9-_]*)`.
+     *
+     * @example
+     * ```tsx
+     * const transform = useNode(PrimaryNode.Transform)
+     * const container = useChild(['container'], PrimaryNode.Transform)
+     *
+     * return (
+     *   <transform ref={transform}>
+     *     <transform id='container' />
+     *   </transform>
+     * )
+     * ```
+     *
+     * **`id`** can be used as path to find nested nodes.
+     *
+     * @example
+     * ```tsx
+     * const child2 = useChild(['child1', 'child2'], PrimaryNode.Transform)
+     *
+     * return (
+     *   <transform>
+     *     <transform id='child1'>
+     *       <transform id='child2' />
+     *     </transform>
+     *   </transform>
+     * )
+     * ```
+     */
+    id?: string | symbol;
+    /**
+     * The **`zIndex`** property of a node.
+     * It represents the position in Z in the plane.
+     *
+     * @example
+     * ```tsx
+     * <transform>
+     *   <sprite textureId={BALL_TEXTURE} zIndex={0} />
+     *   <sprite textureId={BALL_2_TEXTURE} zIndex={1} />
+     * </transform>
+     * ```
+     */
+    zIndex?: number;
+    /**
+     * The **`deltaIncrease`** property changes the speed of the node and its children.
+     *
+     * @example
+     * ```tsx
+     * // Speed x0.5
+     * <transform deltaIncrease={0.5}>
+     *   <Ball />
+     * </transform>
+     * ```
+     */
+    deltaIncrease?: number;
+    /** Optional script to attach to this node */
+    script?: DinixScript<T>;
+    /** Child nodes to add */
+    children?: Node[];
+}
+export declare abstract class Node<T extends PrimaryNode = PrimaryNode> {
+    #private;
+    type: T;
+    _parent?: Node;
+    _children: Node[];
+    /**
+     * The **`deltaIncrease`** property changes the speed of the node and its children.
+     *
+     * @example
+     * ```tsx
+     * // Speed x0.5
+     * <transform deltaIncrease={0.5}>
+     *   <Ball />
+     * </transform>
+     * ```
+     */
+    deltaIncrease: number;
+    script?: DinixScript<T>;
+    /**
+     * The **`isStarted`** property of the node indicates whether the node is started.
+     */
+    isStarted: boolean;
+    /**
+     * The **`isDestroyed`** property of the node indicates whether the node is destroyed.
+     */
+    isDestroyed: boolean;
+    constructor(type: T, { id, zIndex, deltaIncrease, script, children }: NodeOptions<T>);
+    /**
+     * The read-only **`id`** property of a node represents the node's identifier.
+     * It can be used to retrieve this node via `child()`.
+     * IDs can be non-unique and must match `([a-zA-Z][a-zA-Z0-9-_]*)`.
+     *
+     * @example
+     * ```tsx
+     * const container = useChild(['container'], PrimaryNode.Transform)
+     *
+     * return (
+     *   <transform>
+     *     <transform id='container' />
+     *   </transform>
+     * )
+     * ```
+     *
+     * **`id`** can be used as path to find nested nodes.
+     *
+     * @example
+     * ```tsx
+     * const child2 = useChild(['child1', 'child2'], PrimaryNode.Transform)
+     *
+     * return (
+     *   <transform>
+     *     <transform id='child1'>
+     *       <transform id='child2' />
+     *     </transform>
+     *   </transform>
+     * )
+     * ```
+     */
+    get id(): string | symbol;
+    /**
+     * The read-only **`parent`** property returns the parent of this node.
+     *
+     * @example
+     * ```tsx
+     * const transform = useNode(PrimaryNode.Transform)
+     *
+     * useMount(() => {
+     *   const parent = transform.node.parent
+     *   parent?.destroy()
+     * })
+     *
+     * return (
+     *   <transform ref={transform}>
+     *     <transform id='container' />
+     *   </transform>
+     * )
+     * ```
+     */
+    get parent(): Node<PrimaryNode> | undefined;
+    /**
+     * The read-only **`children`** property returns the child nodes.
+     *
+     * @example
+     * ```tsx
+     * const transform = useNode(PrimaryNode.Transform)
+     *
+     * useMount(() => {
+     *   const children = transform.node.children
+     *   console.log(children) // [Node]
+     * })
+     *
+     * return (
+     *   <transform ref={transform}>
+     *     <transform id='container' />
+     *   </transform>
+     * )
+     * ```
+     */
+    get children(): Node<PrimaryNode>[];
+    /**
+     * Gets or sets the **`zIndex`** of the node.
+     */
+    set zIndex(value: number);
+    get zIndex(): number;
+    /**
+     * Gets or sets the **`globalZIndex`** of the node.
+     */
+    set globalZIndex(value: number);
+    get globalZIndex(): number;
+    /**
+     * Gets or sets the **`globalDeltaIncrease`** of the node.
+     */
+    set globalDeltaIncrease(value: number);
+    get globalDeltaIncrease(): number;
+    /**
+     * Returns the first descendant node that matches the given path and type.
+     *
+     * @param options Options to filter nodes
+     * @returns The matching node, or throws if not found
+     *
+     * @example
+     * ```tsx
+     * const transform = useNode(PrimaryNode.Transform)
+     *
+     * useMount(() => {
+     *   const sprite = transform.node.child({
+     *     path: ['sprite'],
+     *     type: PrimaryNode.Sprite
+     *   })
+     * })
+     *
+     * return (
+     *   <transform ref={transform}>
+     *     <sprite id='sprite' />
+     *   </transform>
+     * )
+     * ```
+     */
+    child<T extends PrimaryNode>(options: {
+        path: (string | symbol)[];
+        type: T;
+    }): NodeInstances[T];
+    /**
+     * Add child nodes to this node.
+     * @param children Nodes to add as children
+     */
+    addChild(...children: Node[]): void;
+    removeChild(child: Node): void;
+    /**
+     * The **`zIndexChanged`** event fires when the node's `zIndex` value changes.
+     */
+    zIndexChanged: Event<[_zIndex: number], "zIndexChange">;
+    /**
+     * The **`started`** event fires when the node finishes its `start()` lifecycle.
+     */
+    started: Event<[], "start">;
+    /**
+     * The **`drawed`** event fires each frame when the node is being drawn.
+     */
+    drawed: Event<[_delta: number], "draw">;
+    /**
+     * The **`updated`** event fires each frame during the node's update cycle.
+     */
+    updated: Event<[_delta: number], "update">;
+    /**
+     * The **`destroyed`** event fires when the node is destroyed.
+     */
+    destroyed: Event<[], "destroy">;
+    onZIndexChange?(_zIndex: number): void;
+    onStart?(): void;
+    onDraw?(_delta: number): void;
+    onUpdate?(_delta: number): void;
+    onDestroy?(): void;
+    /**
+     * The **`start`** method initializes the node and starts its lifecycle.
+     * It attaches event callbacks and starts all child nodes.
+     * Called automatically when the node is added to the scene.
+     */
+    start(): void;
+    /**
+     * The **`update`** method is called each frame to update the node and its children.
+     * @param delta The time elapsed since the last frame in seconds.
+     */
+    update(delta: number): void;
+    /**
+     * The **`draw`** method is called each frame to render the node and its children.
+     * It applies position translation for proper rendering hierarchy.
+     * @param delta The time elapsed since the last frame in seconds.
+     */
+    draw(delta: number): void;
+    /**
+     * The **`destroy`** method destroys this node and all its children.
+     */
+    destroy(): void;
+    /**
+     * The **`cleanEvents`** method removes all event listeners from this node.
+     * It is called automatically when the node is destroyed.
+     *
+     * @example
+     * ```tsx
+     * const transform = useNode(PrimaryNode.Transform)
+     *
+     * useMount(() => {
+     *   transform.node.started.on(() => {
+     *     console.log('Node started')
+     *   })
+     *
+     *   transform.node.cleanEvents()
+     *   // No listeners will fire
+     * })
+     * ```
+     */
+    cleanEvents(): void;
+}
+//# sourceMappingURL=_node.d.ts.map

package/dist/nodes/_node.d.ts.map

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