@number10/phaserjsx 0.1.0

package/dist/hooks.d.ts

@@ -0,0 +1,135 @@
+import { Signal } from '@preact/signals-core';
+import { PartialTheme } from './theme';
+import { ParentType } from './types';
+type Cleanup = void | (() => void);
+/**
+ * Get current hook context from active render
+ * Must be called during component render
+ * @returns Current context or null if not in render
+ */
+export declare function getCurrent(): Ctx | null;
+export type Ctx = {
+    index: number;
+    slots: unknown[];
+    effects: (() => Cleanup)[];
+    cleanups: Cleanup[];
+    vnode: VNode;
+    componentVNode: VNode;
+    parent: ParentType;
+    function: (props: unknown) => VNode;
+    updater?: (() => void) | undefined;
+    isFactory: boolean;
+    lastProps?: unknown;
+    memoized?: boolean;
+    theme?: PartialTheme | undefined;
+    disposed?: boolean;
+};
+export type VNode = {
+    type: unknown;
+    props?: Record<string, unknown> | undefined;
+    children?: (VNode | null | undefined | false)[];
+    __node?: unknown;
+    __ctx?: Ctx;
+    __parent?: unknown;
+    __key?: string | number | null;
+    __addConfig?: {
+        expand?: boolean;
+        proportion?: number;
+        align?: string;
+        padding?: number | {
+            left?: number;
+            right?: number;
+            top?: number;
+            bottom?: number;
+        };
+    };
+    __memo?: boolean;
+    __theme?: PartialTheme;
+    __staticChildren?: boolean;
+};
+/**
+ * Executes a render function with hooks context
+ * @param ctx - The context to use for hooks
+ * @param render - The render function to execute
+ * @returns The result of the render function
+ */
+export declare function withHooks<T>(ctx: Ctx, render: () => T): T;
+/**
+ * State hook for managing component state
+ * @param initial - Initial state value or initializer function
+ * @returns Tuple of current state and setter function
+ */
+export declare function useState<T>(initial: T): [T, (v: T | ((p: T) => T)) => void];
+/**
+ * Ref hook for storing mutable values
+ * @param val - Initial ref value
+ * @returns Ref object with current property
+ */
+export declare function useRef<T>(val: T): {
+    current: T;
+};
+/**
+ * Hook to force component re-render when signals change
+ * @param signals - Array of signals to watch for changes
+ * @param throttleMs - Optional throttle time in milliseconds
+ *
+ * ⚠️ IMPORTANT: Obey performance, massive redraw could have an effect!
+ */
+export declare function useForceRedraw(throttleMs: number, ...signals: Signal<unknown>[]): void;
+export declare function useForceRedraw(...signals: Signal<unknown>[]): void;
+/**
+ * Memoization hook for expensive computations
+ * @param fn - Function to memoize
+ * @param deps - Dependency array
+ * @returns Memoized value
+ */
+export declare function useMemo<T>(fn: () => T, deps: readonly unknown[]): T;
+/**
+ * Callback memoization hook
+ * @param fn - Callback function to memoize
+ * @param deps - Dependency array
+ * @returns Memoized callback
+ */
+export declare function useCallback<T extends (...args: any[]) => any>(fn: T, deps: readonly unknown[]): T;
+/**
+ * Hook to access current theme context
+ * Returns the theme that was passed down through the VDOM tree
+ * @returns Current theme context or undefined if no theme is set
+ */
+export declare function useTheme(): PartialTheme | undefined;
+/**
+ * Hook to access current Phaser scene
+ * Returns the scene from the render context
+ * @returns Current Phaser scene
+ */
+export declare function useScene(): Phaser.Scene;
+/**
+ * Effect hook for side effects with cleanup
+ * @param fn - Effect function that optionally returns cleanup
+ * @param deps - Optional dependency array
+ */
+export declare function useEffect(fn: () => Cleanup, deps?: readonly unknown[] | undefined): void;
+/**
+ * Shallow comparison for props objects
+ * Used for component memoization (React.memo equivalent)
+ * @param a - Previous props
+ * @param b - Current props
+ * @returns true if props are shallowly equal
+ */
+export declare function shallowEqual(a: unknown, b: unknown): boolean;
+/**
+ * Check if component should update based on props comparison
+ * Similar to React.memo() - skips re-render if props haven't changed
+ * @param ctx - Component context
+ * @param newProps - New props to compare
+ * @returns true if component should re-render
+ */
+export declare function shouldComponentUpdate(ctx: Ctx, newProps: unknown): boolean;
+/**
+ * Hook to manually trigger a component redraw
+ * @returns Function to trigger redraw
+ */
+export declare function useRedraw(): () => void;
+export declare function disposeCtx(c: Ctx): void;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGzC,KAAK,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAA;AAElC;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,GAAG,GAAG,IAAI,CAMvC;AAKD,MAAM,MAAM,GAAG,GAAG;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,EAAE,CAAA;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,cAAc,EAAE,KAAK,CAAA;IACrB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAA;IACnC,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,EAAE,CAAA;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9B,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,GAAG;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACpF,CAAA;IACD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAyBzD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAe3E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAA;AACvF,wBAAgB,cAAc,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAA;AAgCnE;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,CAAC,CAYnE;AAED;;;;;GAKG;AAEH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,CAAC,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,YAAY,GAAG,SAAS,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAAC,KAAK,CAMvC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,QAiBjF;AAiBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA0B5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAoB1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,IAAI,CAKtC;AA6CD,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,QA2BhC"}

package/dist/host.d.ts

@@ -0,0 +1,74 @@
+import { default as Phaser } from 'phaser';
+import { NodeInstance, NodeProps, NodeType } from './core-types';
+/**
+ * Host creator function type - creates a node instance from props
+ */
+export type HostCreator<T extends NodeType> = (scene: Phaser.Scene, props: NodeProps<T>) => NodeInstance<T>;
+/**
+ * Host patcher function type - updates node properties
+ */
+export type HostPatcher<T extends NodeType> = (node: NodeInstance<T>, prev: NodeProps<T>, next: NodeProps<T>) => void;
+/**
+ * Node descriptor combining creator and patcher
+ */
+export interface NodeDescriptor<T extends NodeType> {
+    create: HostCreator<T>;
+    patch: HostPatcher<T>;
+}
+/**
+ * Internal registry of node descriptors
+ */
+type NodeRegistry = {
+    [K in NodeType]: NodeDescriptor<K>;
+};
+/**
+ * Node registry - maps node types to their descriptors
+ * Exported for external registration of custom node types
+ */
+export declare const nodeRegistry: Partial<NodeRegistry>;
+/**
+ * Registers a node descriptor (creator + patcher) for a custom node type
+ * @param type - Node type name
+ * @param descriptor - Node descriptor with create and patch functions
+ */
+export declare function register<T extends NodeType>(type: T, descriptor: NodeDescriptor<T>): void;
+/**
+ * Host API - Generic interface for VDOM to manage Phaser nodes
+ */
+export declare const host: {
+    /**
+     * Creates a node instance using the registered creator for the given type
+     * @param type - Node type name
+     * @param props - Node properties
+     * @param scene - Phaser scene
+     * @returns Created node instance
+     * @throws Error if no creator registered for the type
+     */
+    create<T extends NodeType>(type: T, props: NodeProps<T>, scene: Phaser.Scene): NodeInstance<T>;
+    /**
+     * Patches node properties with updates using the registered patcher
+     * @param type - Node type name
+     * @param node - Node to patch
+     * @param prev - Previous props
+     * @param next - New props
+     */
+    patch<T extends NodeType>(type: T, node: NodeInstance<T>, prev: NodeProps<T>, next: NodeProps<T>): void;
+    /**
+     * Appends child node to parent container
+     * @param parent - Parent container or scene
+     * @param child - Child node to append
+     */
+    append(parent: unknown, child: unknown): void;
+    /**
+     * Removes child node from parent and destroys it
+     * @param parent - Parent container
+     * @param child - Child node to remove
+     */
+    remove(parent: unknown, child: unknown): void;
+    /**
+     * Performs layout update on container (no-op for native Phaser)
+     */
+    layout(): void;
+};
+export {};
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAErE;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI,CAC5C,KAAK,EAAE,MAAM,CAAC,KAAK,EACnB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAChB,YAAY,CAAC,CAAC,CAAC,CAAA;AAEpB;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI,CAC5C,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KACf,IAAI,CAAA;AAET;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,QAAQ;IAChD,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IACtB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CACtB;AAED;;GAEG;AACH,KAAK,YAAY,GAAG;KACjB,CAAC,IAAI,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC;CACnC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,YAAY,CAAM,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAEzF;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;;;;;;OAOG;WACI,CAAC,SAAS,QAAQ,QAAQ,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC;IAQ9F;;;;;;OAMG;UACG,CAAC,SAAS,QAAQ,QAChB,CAAC,QACD,YAAY,CAAC,CAAC,CAAC,QACf,SAAS,CAAC,CAAC,CAAC,QACZ,SAAS,CAAC,CAAC,CAAC,GACjB,IAAI;IAQP;;;;OAIG;mBACY,OAAO,SAAS,OAAO;IAmBtC;;;;OAIG;mBACY,OAAO,SAAS,OAAO;IAiBtC;;OAEG;;CAKJ,CAAA"}