@number10/phaserjsx 0.3.1 → 0.4.1

package/dist/types.d.ts

@@ -22,12 +22,29 @@ export interface RefObject<T> {
  * Ref type - can be either a callback or an object
  */
 export type Ref<T> = RefCallback<T> | RefObject<T>;
+/**
+ * Props extension to include key, ref, and theme
+ */
 export interface PropsDefaultExtension<T = unknown> {
     key?: string | number | undefined;
     ref?: Ref<T> | undefined;
     theme?: PartialTheme | undefined;
 }
-export type ChildrenType = VNode | VNode[] | null | undefined;
+/**
+ * VNode types
+ */
+export type VNodeChild = VNode | null | undefined | false;
+/**
+ * VNodeLike type - a VNode or an array of VNodeLike
+ */
+export type VNodeLike = VNodeChild | VNodeLike[];
+/**
+ * Children type - can be a single VNodeLike or an array of VNodeLike
+ */
+export type ChildrenType = VNodeLike;
+/**
+ * Props extension to include children
+ */
 export interface PropsContainerExtension {
     children?: ChildrenType;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAAA;AAE5C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAA;AAEpE;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;AAElD,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAChD,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACjC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IACxB,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,GAAG,SAAS,CAAA;AAE7D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAAA;AAE5C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAA;AAEpE;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAChD,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACjC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IACxB,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,EAAE,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAA;AAEpC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB"}

package/dist/vdom.d.ts

@@ -1,8 +1,26 @@
 import { default as Phaser } from 'phaser';
 import { NodeProps, NodeType } from './core-types';
 import { VNode } from './hooks';
-import { ParentType } from './types';
-export type VNodeLike = VNode | VNode[] | null;
+import { ParentType, VNodeLike } from './types';
+export type { VNodeLike } from './types';
+/**
+ * Get statistics about active mountJSX instances
+ * Useful for debugging and monitoring mount registry state
+ * @returns Object with mount statistics including counts by type, parent, and key
+ */
+export declare function getMountStats(): {
+    totalMounts: number;
+    byType: Map<string, number>;
+    byParent: Map<ParentType, number>;
+    byKey: Map<string, number>;
+    mounts: Array<{
+        id: number;
+        type: string;
+        key?: string;
+        parentType: string;
+        propsKeys: string[];
+    }>;
+};
 /**
  * Remount all active mountJSX instances
  * Completely unmounts and remounts every registered root
@@ -20,6 +38,8 @@ export interface MountProps {
     height: number;
     /** Disable automatic SceneWrapper (default: false) */
     disableAutoSize?: boolean;
+    /** Unique key to distinguish multiple mounts on same parent */
+    key?: string;
 }
 /**
  * Combined props type: MountProps + Component-specific props
@@ -33,6 +53,11 @@ export type MountComponentProps<P = Record<string, never>> = MountProps & P;
 export interface MountHandle extends Phaser.GameObjects.GameObject {
     unmount: () => void;
 }
+/**
+ * Normalizes a component return into a single VNode or null.
+ * Wraps arrays into a Fragment VNode for consistent mounting.
+ */
+export declare function normalizeVNodeLike(rendered: VNodeLike): VNode | null;
 /**
  * Creates a VNode element (alternative to JSX)
  * @param type - Element type (string or component)
@@ -69,7 +94,7 @@ export declare function patchVNode(parent: ParentType, oldV: VNode | null, newV:
  * @returns Created Phaser GameObject
  */
 export declare function mountJSX<T extends NodeType>(parentOrScene: ParentType, type: T, props: MountComponentProps<NodeProps<T>>): MountHandle;
-export declare function mountJSX<P = Record<string, never>>(parentOrScene: ParentType, type: (props: P & MountProps) => VNode, props: MountComponentProps<P>): MountHandle;
+export declare function mountJSX<P = Record<string, never>>(parentOrScene: ParentType, type: (props: P & MountProps) => VNodeLike, props: MountComponentProps<P>): MountHandle;
 /**
  * Convenience helper to unmount a tree created via mountJSX without manual casting
  * Accepts either the root GameObject returned from mountJSX or the owning scene

package/dist/vdom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vdom.d.ts","sourceRoot":"","sources":["../src/vdom.ts"],"names":[],"mappings":"AAKA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAGvD,OAAO,EAA0D,KAAK,KAAK,EAAE,MAAM,SAAS,CAAA;AAO5F,OAAO,KAAK,EAAE,UAAU,EAAO,MAAM,SAAS,CAAA;AAE9C,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;AAmF9C;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAsGjC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,UAAU,GAAG,CAAC,CAAA;AAE3E;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,WAAW,CAAC,UAAU;IAChE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AA8UD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC,EAC1D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACrC,GAAG,QAAQ,EAAE,KAAK,EAAE,GACnB,KAAK,CAGP;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,CAwR5F;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CA4CrE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,QAwVpF;AAED;;;;;;;GAOG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EACzC,aAAa,EAAE,UAAU,EACzB,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GACvC,WAAW,CAAA;AAEd,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAChD,aAAa,EAAE,UAAU,EACzB,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,KAAK,KAAK,EACtC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,WAAW,CAAA;AA4Ed;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG,IAAI,CA+BrF"}
+{"version":3,"file":"vdom.d.ts","sourceRoot":"","sources":["../src/vdom.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,22 @@
 {
   "name": "@number10/phaserjsx",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "type": "module",
   "description": "Declarative Phaser3 + UI renderer core library",
   "author": "Michael Rieck (Michael--) <mr@number10.de>",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "jsx-runtime": [
+        "dist/jsx-runtime.d.ts"
+      ],
+      "jsx-dev-runtime": [
+        "dist/jsx-dev-runtime.d.ts"
+      ]
+    }
+  },
   "bin": {
     "generate-icons": "./dist/scripts/generate-icons.js",
     "generate-icon-types": "./dist/scripts/generate-icon-types.js",