@number10/phaserjsx 0.2.0 → 0.4.0

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,12 +38,26 @@ 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
  * Use this for type-safe mountJSX calls
  */
 export type MountComponentProps<P = Record<string, never>> = MountProps & P;
+/**
+ * Returned handle from mountJSX
+ * Extends the root GameObject with a typed unmount helper
+ */
+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)
@@ -61,6 +93,12 @@ export declare function patchVNode(parent: ParentType, oldV: VNode | null, newV:
  * @param props - Component props including width and height
  * @returns Created Phaser GameObject
  */
-export declare function mountJSX<T extends NodeType>(parentOrScene: ParentType, type: T, props: MountComponentProps<NodeProps<T>>): Phaser.GameObjects.GameObject;
-export declare function mountJSX<P = Record<string, never>>(parentOrScene: ParentType, type: (props: P & MountProps) => VNode, props: MountComponentProps<P>): Phaser.GameObjects.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) => 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
+ * @param target - Root GameObject or Phaser scene that holds the mounted JSX tree
+ */
+export declare function unmountJSX(target: Phaser.Scene | Phaser.GameObjects.GameObject): void;
 //# sourceMappingURL=vdom.d.ts.map

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;AAwE9C;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAoGjC;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;AA8U3E;;;;;;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,MAAM,CAAC,WAAW,CAAC,UAAU,CAAA;AAEhC,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,MAAM,CAAC,WAAW,CAAC,UAAU,CAAA"}
+{"version":3,"file":"vdom.d.ts","sourceRoot":"","sources":["../src/vdom.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@number10/phaserjsx",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Declarative Phaser3 + UI renderer core library",
   "author": "Michael Rieck (Michael--) <mr@number10.de>",
@@ -63,12 +63,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/number10/phaserjsx.git",
+    "url": "https://github.com/Michael--/phaserjsx",
     "directory": "packages/ui"
   },
-  "homepage": "https://github.com/number10/phaserjsx",
+  "homepage": "https://michael--.github.io/phaserjsx/",
   "bugs": {
-    "url": "https://github.com/number10/phaserjsx/issues"
+    "url": "https://github.com/Michael--/phaserjsx/issues"
   },
   "devDependencies": {
     "@types/lodash": "^4.17.20",
@@ -100,7 +100,6 @@
     "@preact/signals-core": "^1.12.1",
     "fast-deep-equal": "^3.1.3",
     "lodash": "^4.17.21",
-    "phaser3-rex-plugins": "^1.80.17",
     "tsx": "^4.20.6"
   },
   "scripts": {