fraxel 0.1.0-alpha.1

package/dist/errors/node.d.ts

@@ -0,0 +1,68 @@
+import { DinixError } from './base.js';
+/**
+ * The **`NodeError`** error is thrown when an error occurs during node creation, manipulation, or traversal.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new NodeError('Node operation failed')
+ * ```
+ */
+export declare class NodeError extends DinixError {
+    constructor(message: string);
+}
+/**
+ * The **`InvalidNodeIdError`** error is thrown when a node ID does not match the required pattern `([a-zA-Z][a-zA-Z0-9-_]*)`.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new InvalidNodeIdError('123-invalid')
+ * ```
+ */
+export declare class InvalidNodeIdError extends NodeError {
+    constructor(id: string);
+}
+/**
+ * The **`NodeChildNotFoundError`** error is thrown when attempting to access a child node at a path that does not exist within a parent node.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new NodeChildNotFoundError('player/sprite')
+ * ```
+ */
+export declare class NodeChildNotFoundError extends NodeError {
+    constructor(path: string);
+}
+/**
+ * The **`NodeTypeMismatchError`** error is thrown when a node has an unexpected type that does not match the expected type.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new NodeTypeMismatchError('Sprite', 'Button')
+ * ```
+ */
+export declare class NodeTypeMismatchError extends NodeError {
+    constructor(expected: string, received: string);
+}
+/**
+ * The **`UnknownNodeTypeError`** error is thrown when attempting to create or reference a node type that is not registered in the node registry.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new UnknownNodeTypeError('CustomWidget')
+ * ```
+ */
+export declare class UnknownNodeTypeError extends NodeError {
+    constructor(type: string);
+}
+/**
+ * The **`InvalidNodeInstanceError`** error is thrown when a value is not a valid Node instance (e.g., null, undefined, or a non-Node object).
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new InvalidNodeInstanceError(null)
+ * ```
+ */
+export declare class InvalidNodeInstanceError extends NodeError {
+    constructor(received: unknown);
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/errors/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/errors/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,EAAE,EAAE,MAAM;CAGvB;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACvC,IAAI,EAAE,MAAM;CAGzB;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAG/C;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,IAAI,EAAE,MAAM;CAGzB;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,QAAQ,EAAE,OAAO;CAU9B"}

package/dist/errors/node.js

@@ -0,0 +1,87 @@
+import { Nodes } from '../nodes/lib/registry.js';
+import { DinixError } from './base.js';
+/**
+ * The **`NodeError`** error is thrown when an error occurs during node creation, manipulation, or traversal.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new NodeError('Node operation failed')
+ * ```
+ */
+export class NodeError extends DinixError {
+    constructor(message) {
+        super(message);
+        this.name = 'NodeError';
+    }
+}
+/**
+ * The **`InvalidNodeIdError`** error is thrown when a node ID does not match the required pattern `([a-zA-Z][a-zA-Z0-9-_]*)`.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new InvalidNodeIdError('123-invalid')
+ * ```
+ */
+export class InvalidNodeIdError extends NodeError {
+    constructor(id) {
+        super(`Invalid node id "${id}". Expected pattern ([a-zA-Z][a-zA-Z0-9-_]*)`);
+    }
+}
+/**
+ * The **`NodeChildNotFoundError`** error is thrown when attempting to access a child node at a path that does not exist within a parent node.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new NodeChildNotFoundError('player/sprite')
+ * ```
+ */
+export class NodeChildNotFoundError extends NodeError {
+    constructor(path) {
+        super(`Node child with path "${path}" does not exist`);
+    }
+}
+/**
+ * The **`NodeTypeMismatchError`** error is thrown when a node has an unexpected type that does not match the expected type.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new NodeTypeMismatchError('Sprite', 'Button')
+ * ```
+ */
+export class NodeTypeMismatchError extends NodeError {
+    constructor(expected, received) {
+        super(`Expected node type "${expected}" but received "${received}"`);
+    }
+}
+/**
+ * The **`UnknownNodeTypeError`** error is thrown when attempting to create or reference a node type that is not registered in the node registry.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new UnknownNodeTypeError('CustomWidget')
+ * ```
+ */
+export class UnknownNodeTypeError extends NodeError {
+    constructor(type) {
+        super(`Unknown node type "${type}". Available types: ${Object.keys(Nodes).join(', ')}`);
+    }
+}
+/**
+ * The **`InvalidNodeInstanceError`** error is thrown when a value is not a valid Node instance (e.g., null, undefined, or a non-Node object).
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new InvalidNodeInstanceError(null)
+ * ```
+ */
+export class InvalidNodeInstanceError extends NodeError {
+    constructor(received) {
+        const type = received === null
+            ? 'null'
+            : received === undefined
+                ? 'undefined'
+                : (received?.constructor?.name ?? typeof received);
+        super(`Expected a Node instance but received ${type}`);
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/errors/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/errors/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;;;;;;GAOG;AACH,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,EAAU;QACpB,KAAK,CAAC,oBAAoB,EAAE,8CAA8C,CAAC,CAAA;IAC7E,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACnD,YAAY,IAAY;QACtB,KAAK,CAAC,yBAAyB,IAAI,kBAAkB,CAAC,CAAA;IACxD,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAClD,YAAY,QAAgB,EAAE,QAAgB;QAC5C,KAAK,CAAC,uBAAuB,QAAQ,mBAAmB,QAAQ,GAAG,CAAC,CAAA;IACtE,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,YAAY,IAAY;QACtB,KAAK,CAAC,sBAAsB,IAAI,uBAAuB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzF,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD,YAAY,QAAiB;QAC3B,MAAM,IAAI,GACR,QAAQ,KAAK,IAAI;YACf,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,QAAQ,KAAK,SAAS;gBACtB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,IAAI,OAAO,QAAQ,CAAC,CAAA;QAExD,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;CACF"}

package/dist/errors/scene.d.ts

@@ -0,0 +1,35 @@
+import { DinixError } from './base.js';
+/**
+ * The **`SceneError`** error is thrown when an error occurs during scene management, loading, or rendering.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new SceneError('Scene operation failed')
+ * ```
+ */
+export declare class SceneError extends DinixError {
+    constructor(message: string);
+}
+/**
+ * The **`SceneNotFoundError`** error is thrown when attempting to access a scene that does not exist in the scene registry.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new SceneNotFoundError('MainMenu')
+ * ```
+ */
+export declare class SceneNotFoundError extends SceneError {
+    constructor(name: string);
+}
+/**
+ * The **`InvalidSceneRootError`** error is thrown when the root element of a scene is not a valid Node instance.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new InvalidSceneRootError()
+ * ```
+ */
+export declare class InvalidSceneRootError extends SceneError {
+    constructor();
+}
+//# sourceMappingURL=scene.d.ts.map

package/dist/errors/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/errors/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,UAAU;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,IAAI,EAAE,MAAM;CAGzB;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;;CAIpD"}

package/dist/errors/scene.js

@@ -0,0 +1,42 @@
+import { DinixError } from './base.js';
+/**
+ * The **`SceneError`** error is thrown when an error occurs during scene management, loading, or rendering.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new SceneError('Scene operation failed')
+ * ```
+ */
+export class SceneError extends DinixError {
+    constructor(message) {
+        super(message);
+        this.name = 'SceneError';
+    }
+}
+/**
+ * The **`SceneNotFoundError`** error is thrown when attempting to access a scene that does not exist in the scene registry.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new SceneNotFoundError('MainMenu')
+ * ```
+ */
+export class SceneNotFoundError extends SceneError {
+    constructor(name) {
+        super(`Scene "${name}" does not exist`);
+    }
+}
+/**
+ * The **`InvalidSceneRootError`** error is thrown when the root element of a scene is not a valid Node instance.
+ * @example
+ * ```ts
+ * // When this happens:
+ * throw new InvalidSceneRootError()
+ * ```
+ */
+export class InvalidSceneRootError extends SceneError {
+    constructor() {
+        super(`Scene root must be an instance of Node`);
+    }
+}
+//# sourceMappingURL=scene.js.map

package/dist/errors/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../src/errors/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,IAAY;QACtB,KAAK,CAAC,UAAU,IAAI,kBAAkB,CAAC,CAAA;IACzC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD;QACE,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACjD,CAAC;CACF"}

package/dist/events/event.d.ts

@@ -0,0 +1,106 @@
+import type { EventName, Fun } from './types.js';
+/**
+ * The **`Event`** class is a type-safe event emitter that supports subscribing, unsubscribing, and emitting events.
+ *
+ * @typeParam T The parameter types of the event callback.
+ * @typeParam K The string literal type of the event base name.
+ *
+ * @example
+ * ```ts
+ * const onDamage = new Event<[number], 'damage'>('damage', (amount) => {})
+ *
+ * onDamage.on((amount) => {
+ *   console.log('Damage taken:', amount)
+ * })
+ *
+ * onDamage.emit(25) // logs: "Damage taken: 25"
+ * ```
+ */
+export declare class Event<T extends any[], const K extends string> {
+    #private;
+    /** The base name used to derive the event handler name (e.g., `'damage'` → `'onDamage'`). */
+    baseName: K;
+    /** An example function used for type inference in event subscriptions. */
+    exampleFun: Fun<T>;
+    /**
+     * The **`on`** method subscribes a callback to this event.
+     * @param cb The callback function to invoke when the event is emitted.
+     *
+     * @example
+     * ```ts
+     * sprite.started.on(() => {
+     *   console.log('Sprite started!')
+     * })
+     * ```
+     */
+    on(cb: Fun<T>): void;
+    /**
+     * The **`onFirst`** method subscribes a callback to this event with highest priority.
+     * @param cb The callback function to invoke first when the event is emitted.
+     *
+     * @example
+     * ```ts
+     * // This callback will be called before any previously registered callbacks
+     * collider.collided.onFirst((other) => {
+     *   console.log('Priority handler:', other)
+     * })
+     * ```
+     */
+    onFirst(cb: Fun<T>): void;
+    /**
+     * The **`off`** method unsubscribes a callback from this event.
+     * @param cb The callback function to remove.
+     *
+     * @example
+     * ```ts
+     * const handler = (delta: number) => { ... }
+     * node.updated.on(handler)
+     * node.updated.off(handler)
+     * ```
+     */
+    off(cb: Fun<T>): void;
+    /**
+     * The **`emit`** method invokes all subscribed callbacks with the given parameters.
+     * @param params The parameters to pass to each callback.
+     *
+     * @example
+     * ```ts
+     * collider.colliderEntered.emit(otherCollider)
+     * ```
+     */
+    emit(...params: T): void;
+    /**
+     * The **`clean`** method removes all subscribed callbacks from this event.
+     *
+     * @example
+     * ```ts
+     * // Remove all listeners before destroying a node
+     * node.updated.clean()
+     * ```
+     */
+    clean(): void;
+    /**
+     * Creates a new `Event` instance.
+     * @param baseName The base name of the event (e.g., `'damage'`, `'colliderEnter'`).
+     * @param exampleFun An example function signature for type inference.
+     */
+    constructor(
+    /** The base name used to derive the event handler name (e.g., `'damage'` → `'onDamage'`). */
+    baseName: K, 
+    /** An example function used for type inference in event subscriptions. */
+    exampleFun: Fun<T>);
+}
+/**
+ * The **`getEventName`** function converts a base event name to its handler name.
+ * For example, `'damage'` becomes `'onDamage'`.
+ * @param baseName The base name of the event.
+ * @returns The event handler name with `on` prefix.
+ *
+ * @example
+ * ```ts
+ * getEventName('damage')    // 'onDamage'
+ * getEventName('colliderEnter') // 'onColliderEnter'
+ * ```
+ */
+export declare function getEventName<const K extends string>(baseName: K): EventName<K>;
+//# sourceMappingURL=event.d.ts.map

package/dist/events/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/events/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM;;IAqFtD,6FAA6F;IACtF,QAAQ,EAAE,CAAC;IAClB,0EAA0E;IACnE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAvF3B;;;;;;;;;;OAUG;IACH,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAIb;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAIlB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAOd;;;;;;;;OAQG;IACH,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;IAKjB;;;;;;;;OAQG;IACH,KAAK;IAML;;;;OAIG;;IAED,6FAA6F;IACtF,QAAQ,EAAE,CAAC;IAClB,0EAA0E;IACnE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;CAE5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAK9E"}

package/dist/events/event.js

@@ -0,0 +1,125 @@
+/**
+ * The **`Event`** class is a type-safe event emitter that supports subscribing, unsubscribing, and emitting events.
+ *
+ * @typeParam T The parameter types of the event callback.
+ * @typeParam K The string literal type of the event base name.
+ *
+ * @example
+ * ```ts
+ * const onDamage = new Event<[number], 'damage'>('damage', (amount) => {})
+ *
+ * onDamage.on((amount) => {
+ *   console.log('Damage taken:', amount)
+ * })
+ *
+ * onDamage.emit(25) // logs: "Damage taken: 25"
+ * ```
+ */
+export class Event {
+    baseName;
+    exampleFun;
+    /**
+     * The **`on`** method subscribes a callback to this event.
+     * @param cb The callback function to invoke when the event is emitted.
+     *
+     * @example
+     * ```ts
+     * sprite.started.on(() => {
+     *   console.log('Sprite started!')
+     * })
+     * ```
+     */
+    on(cb) {
+        this.#list.push(cb);
+    }
+    /**
+     * The **`onFirst`** method subscribes a callback to this event with highest priority.
+     * @param cb The callback function to invoke first when the event is emitted.
+     *
+     * @example
+     * ```ts
+     * // This callback will be called before any previously registered callbacks
+     * collider.collided.onFirst((other) => {
+     *   console.log('Priority handler:', other)
+     * })
+     * ```
+     */
+    onFirst(cb) {
+        this.#list.unshift(cb);
+    }
+    /**
+     * The **`off`** method unsubscribes a callback from this event.
+     * @param cb The callback function to remove.
+     *
+     * @example
+     * ```ts
+     * const handler = (delta: number) => { ... }
+     * node.updated.on(handler)
+     * node.updated.off(handler)
+     * ```
+     */
+    off(cb) {
+        const index = this.#list.indexOf(cb);
+        if (index < 0)
+            return;
+        this.#list.splice(index, 1);
+    }
+    /**
+     * The **`emit`** method invokes all subscribed callbacks with the given parameters.
+     * @param params The parameters to pass to each callback.
+     *
+     * @example
+     * ```ts
+     * collider.colliderEntered.emit(otherCollider)
+     * ```
+     */
+    emit(...params) {
+        const listeners = [...this.#list];
+        listeners.forEach((cb) => cb(...params));
+    }
+    /**
+     * The **`clean`** method removes all subscribed callbacks from this event.
+     *
+     * @example
+     * ```ts
+     * // Remove all listeners before destroying a node
+     * node.updated.clean()
+     * ```
+     */
+    clean() {
+        this.#list.length = 0;
+    }
+    #list = [];
+    /**
+     * Creates a new `Event` instance.
+     * @param baseName The base name of the event (e.g., `'damage'`, `'colliderEnter'`).
+     * @param exampleFun An example function signature for type inference.
+     */
+    constructor(
+    /** The base name used to derive the event handler name (e.g., `'damage'` → `'onDamage'`). */
+    baseName, 
+    /** An example function used for type inference in event subscriptions. */
+    exampleFun) {
+        this.baseName = baseName;
+        this.exampleFun = exampleFun;
+    }
+}
+/**
+ * The **`getEventName`** function converts a base event name to its handler name.
+ * For example, `'damage'` becomes `'onDamage'`.
+ * @param baseName The base name of the event.
+ * @returns The event handler name with `on` prefix.
+ *
+ * @example
+ * ```ts
+ * getEventName('damage')    // 'onDamage'
+ * getEventName('colliderEnter') // 'onColliderEnter'
+ * ```
+ */
+export function getEventName(baseName) {
+    const first = baseName[0]?.toUpperCase() ?? '';
+    const rest = baseName.slice(1);
+    const eventName = `on${first}${rest}`;
+    return eventName;
+}
+//# sourceMappingURL=event.js.map

package/dist/events/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/events/event.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,KAAK;IAsFP;IAEA;IAvFT;;;;;;;;;;OAUG;IACH,EAAE,CAAC,EAAU;QACX,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACrB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAU;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAM;QAErB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,GAAG,MAAS;QACf,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACjC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IACvB,CAAC;IAED,KAAK,GAAa,EAAE,CAAA;IAEpB;;;;OAIG;IACH;IACE,6FAA6F;IACtF,QAAW;IAClB,0EAA0E;IACnE,UAAkB;QAFlB,aAAQ,GAAR,QAAQ,CAAG;QAEX,eAAU,GAAV,UAAU,CAAQ;IACxB,CAAC;CACL;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAyB,QAAW;IAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,KAAK,KAAK,GAAG,IAAI,EAAE,CAAA;IACrC,OAAO,SAAyB,CAAA;AAClC,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,2 @@
+export * from './event.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/dist/events/index.js

@@ -0,0 +1,2 @@
+export * from './event.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/dist/events/types.d.ts

@@ -0,0 +1,20 @@
+import type { Event } from './event';
+/**
+ * The **`Fun`** type represents a function with the given parameter types.
+ * @typeParam T The parameter types of the function.
+ */
+export type Fun<T extends any[]> = (...args: T) => void;
+/**
+ * The **`EventName`** type converts a base event name to its handler name.
+ * For example, `'damage'` becomes `'onDamage'`.
+ * @typeParam T The base event name string.
+ */
+export type EventName<T extends string> = `on${Capitalize<T>}`;
+/**
+ * The **`EventsFromRecord`** type extracts event handler types from a record of `Event` instances.
+ * Used internally to generate type-safe event handler properties.
+ */
+export type EventsFromRecord<T extends Record<string, Event<any[], string>>> = {
+    [P in keyof T as EventName<T[P]['baseName']>]: T[P]['exampleFun'];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;AAE9D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI;KAC5E,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;CAClE,CAAA"}

package/dist/events/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":""}

package/dist/hooks/context.d.ts

@@ -0,0 +1,15 @@
+import type { Node } from '../nodes/_node.js';
+import type { Context } from './use-context.js';
+export interface HookContext {
+    node: Node[] | null;
+    effects: HookEffect[];
+    context?: Context<any>;
+}
+type HookEffect = (nodes: Node[], currentContext: HookContext[]) => void;
+export declare const currentContext: HookContext[];
+export declare function startHooks(): void;
+export declare function finishHooks(node: Node[]): void;
+export declare function declareDerivedHook(hookName: string): void;
+export declare function pushEffect(hookName: string, effect: HookEffect): void;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/hooks/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/hooks/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;CACvB;AAED,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,IAAI,CAAA;AAExE,eAAO,MAAM,cAAc,EAAE,WAAW,EAAO,CAAA;AAE/C,wBAAgB,UAAU,SAKzB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAKvC;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,QAIlD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,QAM9D"}

package/dist/hooks/context.js

@@ -0,0 +1,26 @@
+import { HookOutsideComponentError } from '../errors/hook.js';
+export const currentContext = [];
+export function startHooks() {
+    currentContext.push({
+        node: null,
+        effects: [],
+    });
+}
+export function finishHooks(node) {
+    if (!currentContext)
+        return;
+    currentContext.at(-1)?.effects.forEach((fn) => fn(node, currentContext));
+    currentContext.pop();
+}
+export function declareDerivedHook(hookName) {
+    if (!currentContext) {
+        throw new HookOutsideComponentError(hookName);
+    }
+}
+export function pushEffect(hookName, effect) {
+    if (!currentContext) {
+        throw new HookOutsideComponentError(hookName);
+    }
+    currentContext.at(-1)?.effects.push(effect);
+}
+//# sourceMappingURL=context.js.map

package/dist/hooks/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/hooks/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAY7D,MAAM,CAAC,MAAM,cAAc,GAAkB,EAAE,CAAA;AAE/C,MAAM,UAAU,UAAU;IACxB,cAAc,CAAC,IAAI,CAAC;QAClB,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE;KACZ,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,cAAc;QAAE,OAAM;IAE3B,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;IACxE,cAAc,CAAC,GAAG,EAAE,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,yBAAyB,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAkB;IAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,yBAAyB,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC;IAED,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC7C,CAAC"}

package/dist/hooks/deriveds/by-nodes/index.d.ts

@@ -0,0 +1,7 @@
+export { useClickable } from './use-clickable.js';
+export { useTimer } from './use-timer.js';
+export { useRayCast } from './use-ray-cast.js';
+export { useCollider } from './use-collider.js';
+export { useAnimation } from './use-animation.js';
+export { useAudio } from './use-audio.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/deriveds/by-nodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/hooks/deriveds/by-nodes/index.js

@@ -0,0 +1,7 @@
+export { useClickable } from './use-clickable.js';
+export { useTimer } from './use-timer.js';
+export { useRayCast } from './use-ray-cast.js';
+export { useCollider } from './use-collider.js';
+export { useAnimation } from './use-animation.js';
+export { useAudio } from './use-audio.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/deriveds/by-nodes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/hooks/deriveds/by-nodes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/hooks/deriveds/by-nodes/use-animation.d.ts

@@ -0,0 +1,44 @@
+import { PrimaryNode } from '../../../nodes/index.js';
+import type { NodeReference } from '../../use-node.js';
+/**
+ * The **`useAnimation`** derived hook provides a declarative API for the `AnimationPlayer` node.
+ * Returns the node reference, reactive `animName` and `frameIndex` signals,
+ * a reactive `ended` boolean, and control methods.
+ *
+ * @param anim An optional existing `NodeReference` to the AnimationPlayer node
+ * @returns An object with `ref`, `animName`, `frameIndex`, `ended`, `play`, `stop`, `setNext`
+ *
+ * @example
+ * ```tsx
+ * import { useAnimation } from 'dinix/hooks'
+ *
+ * function Character() {
+ *   const sprite = useNode(PrimaryNode.Sprite)
+ *   const { ref, animName, ended, play, setNext } = useAnimation()
+ *
+ *   useEffect(() => {
+ *     play(isWalking() ? 'walk' : 'idle')
+ *   })
+ *
+ *   useEvent(ref, 'animationEnded', () => {
+ *     setNext('idle')
+ *   })
+ *
+ *   return (
+ *     <sprite ref={sprite} textureId={CHAR}>
+ *       <animation-player ref={ref} animations={() => anims} currentAnim={animName} />
+ *     </sprite>
+ *   )
+ * }
+ * ```
+ */
+export declare function useAnimation(anim?: NodeReference<PrimaryNode.AnimationPlayer>): {
+    ref: NodeReference<PrimaryNode.AnimationPlayer>;
+    animName: import("../../../index.js").SignalGetter<string | null>;
+    frameIndex: import("../../../index.js").SignalGetter<number>;
+    ended: import("../../../index.js").SignalGetter<boolean>;
+    play: (animName: string, index?: number) => void;
+    stop: () => void;
+    setNext: (animName: string | null) => void;
+};
+//# sourceMappingURL=use-animation.d.ts.map