fraxel 0.1.0-alpha.1

package/dist/reactivity/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A getter function that returns the current value.
+ * Calling it as a function (`getter()`) registers the signal as a dependency
+ * of the current `SignalRegister.watch` context (used by `useComputed`, `useEffect`).
+ * Calling `.value()` bypasses dependency tracking.
+ */
+export interface SignalGetter<T> {
+    (): T;
+    value(): T;
+}
+/**
+ * A setter function that updates the signal value and notifies subscribers.
+ * Equivalent to setting `signal.value = val`.
+ */
+export interface SignalSetter<T> {
+    (value: T): void;
+}
+/**
+ * A function that returns a value. Used for lazy/deferred computation.
+ * Unlike `SignalGetter`, does not register dependencies with `SignalRegister`.
+ * Accept either a real `SignalGetter` or a plain getter function.
+ */
+export interface SignalGetterLike<T> {
+    (): T;
+}
+/**
+ * A value that can be either a static value or a function that returns a value.
+ * Used by props that accept both static and reactive values (e.g. `currentAnim`, `animations`).
+ */
+export type Reactive<T> = T | SignalGetterLike<T>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reactivity/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAA;IACL,KAAK,IAAI,CAAC,CAAA;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,CAAC,CAAA;CACN;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAA"}

package/dist/reactivity/types.js

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

package/dist/reactivity/types.js.map

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

package/dist/scripts/index.d.ts

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

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

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

package/dist/scripts/index.js

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

package/dist/scripts/index.js.map

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

package/dist/scripts/script.d.ts

@@ -0,0 +1,80 @@
+import type { Event } from '../events';
+import type { Node, NodeInstances } from '../nodes';
+import type { PrimaryNode } from '../nodes/lib/enum';
+/**
+ * The **`DinixScript`** abstract class separates game logic from rendering.
+ * Attach a script to a node via the `script` prop to run logic independently
+ * of the JSX component tree.
+ *
+ * @typeParam T The `PrimaryNode` type this script is attached to.
+ *
+ * @example
+ * ```ts
+ * class PlayerScript extends DinixScript<PrimaryNode.Transform> {
+ *   health = 100
+ *
+ *   setup() {
+ *     this.connect('started', () => {
+ *       console.log('Player spawned!')
+ *     })
+ *   }
+ *
+ *   applyDamage(amount: number) {
+ *     this.health -= amount
+ *     if (this.health <= 0) this.me.destroy()
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class DinixScript<T extends PrimaryNode> {
+    #private;
+    /**
+     * The read-only **`me`** property returns the node this script is attached to.
+     * Throws `NodeNotInitializedError` if accessed before `init()` is called.
+     */
+    get me(): NodeInstances[T];
+    /**
+     * Initializes the script by binding it to a node.
+     * Called automatically by the `Node` constructor when a `script` option is provided.
+     * @param node The node instance to attach this script to.
+     */
+    init(node: NodeInstances[T]): void;
+    /**
+     * The **`connect`** method subscribes to a node event by name.
+     * Provides type-safe event subscription based on the node's event map.
+     *
+     * @param ev The event name to subscribe to (e.g. `'started'`, `'destroyed'`, `'updated'`).
+     * @param func The callback to invoke when the event fires.
+     *
+     * @example
+     * ```ts
+     * setup() {
+     *   this.connect('started', () => {
+     *     console.log('Node started!')
+     *   })
+     *
+     *   this.connect('destroyed', () => {
+     *     console.log('Node destroyed!')
+     *   })
+     *
+     *   this.connect('updated', (delta) => {
+     *     console.log('Delta:', delta)
+     *   })
+     * }
+     * ```
+     */
+    connect<K extends keyof NodeEvent<NodeInstances[T]>>(ev: K, func: EventFrom<T, K>['exampleFun']): void;
+    /**
+     * The **`setup`** method is called once when the script is initialized.
+     * Override this to register event listeners, initialize state, or set up
+     * subscriptions that should persist for the node's lifetime.
+     */
+    abstract setup(): void;
+}
+type NodeEvent<T extends Node> = {
+    [Q in keyof T as GetEvent<T, Q> extends undefined ? never : Q]: T[Q];
+};
+type GetEvent<T extends Node, K extends keyof T> = T[K] extends Event<any[], string> ? T[K] : undefined;
+type EventFrom<T extends PrimaryNode, K extends keyof NodeInstances[T]> = NonNullable<GetEvent<NodeInstances[T], K>>;
+export {};
+//# sourceMappingURL=script.d.ts.map

package/dist/scripts/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/scripts/script.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,WAAW,CAAC,CAAC,SAAS,WAAW;;IAGrD;;;OAGG;IACH,IAAI,EAAE,qBAGL;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAI3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IAK/F;;;;OAIG;IACH,QAAQ,CAAC,KAAK,IAAI,IAAI;CACvB;AAED,KAAK,SAAS,CAAC,CAAC,SAAS,IAAI,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrE,CAAA;AAED,KAAK,QAAQ,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,MAAM,CAAC,IAC7C,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;AAEtD,KAAK,SAAS,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM,aAAa,CAAC,CAAC,CAAC,IAAI,WAAW,CACnF,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAC9B,CAAA"}

package/dist/scripts/script.js

@@ -0,0 +1,75 @@
+import { NodeNotInitializedError } from '../errors';
+/**
+ * The **`DinixScript`** abstract class separates game logic from rendering.
+ * Attach a script to a node via the `script` prop to run logic independently
+ * of the JSX component tree.
+ *
+ * @typeParam T The `PrimaryNode` type this script is attached to.
+ *
+ * @example
+ * ```ts
+ * class PlayerScript extends DinixScript<PrimaryNode.Transform> {
+ *   health = 100
+ *
+ *   setup() {
+ *     this.connect('started', () => {
+ *       console.log('Player spawned!')
+ *     })
+ *   }
+ *
+ *   applyDamage(amount: number) {
+ *     this.health -= amount
+ *     if (this.health <= 0) this.me.destroy()
+ *   }
+ * }
+ * ```
+ */
+export class DinixScript {
+    #me;
+    /**
+     * The read-only **`me`** property returns the node this script is attached to.
+     * Throws `NodeNotInitializedError` if accessed before `init()` is called.
+     */
+    get me() {
+        if (this.#me == null)
+            throw new NodeNotInitializedError('dinix-script-unknown');
+        return this.#me;
+    }
+    /**
+     * Initializes the script by binding it to a node.
+     * Called automatically by the `Node` constructor when a `script` option is provided.
+     * @param node The node instance to attach this script to.
+     */
+    init(node) {
+        this.#me = node;
+    }
+    /**
+     * The **`connect`** method subscribes to a node event by name.
+     * Provides type-safe event subscription based on the node's event map.
+     *
+     * @param ev The event name to subscribe to (e.g. `'started'`, `'destroyed'`, `'updated'`).
+     * @param func The callback to invoke when the event fires.
+     *
+     * @example
+     * ```ts
+     * setup() {
+     *   this.connect('started', () => {
+     *     console.log('Node started!')
+     *   })
+     *
+     *   this.connect('destroyed', () => {
+     *     console.log('Node destroyed!')
+     *   })
+     *
+     *   this.connect('updated', (delta) => {
+     *     console.log('Delta:', delta)
+     *   })
+     * }
+     * ```
+     */
+    connect(ev, func) {
+        const event = this.me[ev];
+        event.on(func);
+    }
+}
+//# sourceMappingURL=script.js.map

package/dist/scripts/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../src/scripts/script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAgB,WAAW;IAC/B,GAAG,CAA8B;IAEjC;;;OAGG;IACH,IAAI,EAAE;QACJ,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI;YAAE,MAAM,IAAI,uBAAuB,CAAC,sBAAsB,CAAC,CAAA;QAC/E,OAAO,IAAI,CAAC,GAAG,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAsB;QACzB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAA;IACjB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAA8C,EAAK,EAAE,IAAmC;QAC7F,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAoB,CAAA;QAC5C,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;CAQF"}

package/dist/utils/dpr.d.ts

@@ -0,0 +1,2 @@
+export declare function getDPRFromCtx(ctx: CanvasRenderingContext2D, originalWidth: number, originalHeight: number, currentRatio: number): number;
+//# sourceMappingURL=dpr.d.ts.map

package/dist/utils/dpr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dpr.d.ts","sourceRoot":"","sources":["../../src/utils/dpr.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAC3B,GAAG,EAAE,wBAAwB,EAC7B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,UAqBrB"}

package/dist/utils/dpr.js

@@ -0,0 +1,14 @@
+export function getDPRFromCtx(ctx, originalWidth, originalHeight, currentRatio) {
+    const reverseRatio = 1 / currentRatio;
+    ctx.scale(reverseRatio, reverseRatio);
+    const dpr = window.devicePixelRatio ?? 1;
+    const { width: w, height: h } = ctx.canvas.getBoundingClientRect();
+    const width = w * dpr;
+    const height = h * dpr;
+    const ratio = (width / originalWidth + height / originalHeight) / 2;
+    ctx.canvas.width = width;
+    ctx.canvas.height = height;
+    ctx.scale(ratio, ratio);
+    return ratio;
+}
+//# sourceMappingURL=dpr.js.map

package/dist/utils/dpr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dpr.js","sourceRoot":"","sources":["../../src/utils/dpr.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAC3B,GAA6B,EAC7B,aAAqB,EACrB,cAAsB,EACtB,YAAoB;IAEpB,MAAM,YAAY,GAAG,CAAC,GAAG,YAAY,CAAA;IAErC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAErC,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAA;IAExC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAA;IAElE,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAA;IACrB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAA;IAEtB,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IAEnE,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;IACxB,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IAE1B,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAEvB,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/utils/ternaries.d.ts

@@ -0,0 +1,6 @@
+import type { Node } from '../nodes';
+import { type Reactive } from '../reactivity';
+export declare function ns<T, K>(value: T | null | undefined, operation: (value: T) => K, defaultValue: K): K;
+export declare function propSignal<N extends Node, K extends keyof N, T extends N[K]>(node: N, key: K, prop: Reactive<T> | undefined): N[K];
+export declare function applySignal<T, K>(prop: Reactive<T>, changer: (value: T) => K): Reactive<K>;
+//# sourceMappingURL=ternaries.d.ts.map

package/dist/utils/ternaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternaries.d.ts","sourceRoot":"","sources":["../../src/utils/ternaries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAyB,KAAK,QAAQ,EAAqB,MAAM,eAAe,CAAA;AAEvF,wBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC,KAEhG;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC1E,IAAI,EAAE,CAAC,EACP,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,QAa9B;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAI1F"}

package/dist/utils/ternaries.js

@@ -0,0 +1,17 @@
+import { reactive, subReactive } from '../reactivity';
+export function ns(value, operation, defaultValue) {
+    return value == null ? defaultValue : operation(value);
+}
+export function propSignal(node, key, prop) {
+    if (prop == null) {
+        return node[key];
+    }
+    const signal = subReactive(prop, (val) => (node[key] = val), (unsub) => node.destroyed.on(unsub));
+    return signal;
+}
+export function applySignal(prop, changer) {
+    if (typeof prop !== 'function')
+        return changer(prop);
+    return reactive(() => changer(prop()));
+}
+//# sourceMappingURL=ternaries.js.map

package/dist/utils/ternaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternaries.js","sourceRoot":"","sources":["../../src/utils/ternaries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAoC,MAAM,eAAe,CAAA;AAEvF,MAAM,UAAU,EAAE,CAAO,KAA2B,EAAE,SAA0B,EAAE,YAAe;IAC/F,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAO,EACP,GAAM,EACN,IAA6B;IAE7B,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CACxB,IAAI,EACJ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,EAC1B,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CACpC,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAO,IAAiB,EAAE,OAAwB;IAC3E,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpD,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAE,IAAwB,EAAE,CAAC,CAAC,CAAA;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "fraxel",
+  "version": "0.1.0-alpha.1",
+  "type": "module",
+  "description": "A modern node-based 2D game engine for the web powered by JSX and fine-grained reactivity",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./jsx-runtime": "./dist/jsx-runtime.js",
+    "./jsx": "./dist/jsx/index.js",
+    "./jsx/*": "./dist/jsx/*",
+    "./hooks": "./dist/hooks/index.js",
+    "./hooks/*": "./dist/hooks/*",
+    "./scripts": "./dist/scripts/index.js",
+    "./scripts/*": "./dist/scripts/*",
+    "./*": "./dist/*"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "prepublishOnly": "pnpm build && pnpm -w lint"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "game-engine",
+    "2d",
+    "canvas",
+    "jsx",
+    "typescript",
+    "signals",
+    "reactivity",
+    "browser"
+  ],
+  "author": "José Sánchez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sanchedev/dinix.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sanchedev/dinix/issues"
+  },
+  "homepage": "https://github.com/sanchedev/dinix#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "pnpm@10.29.3",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}