@number10/jsx-phaser 5.0.0

package/dist/hooks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.cjs","sources":["../src/hooks.ts"],"sourcesContent":["/**\n * Phaser-specific hook runtime — render cycle + Phaser-only hooks.\n *\n * Core hooks (useState, useRef, useMemo, useCallback, useEffect, useTheme,\n * useForceRedraw, useRedraw, disposeCtx, shallowEqual, shouldComponentUpdate)\n * are re-exported from @number10/jsx-core — the single source of truth.\n *\n * Phaser provides:\n *   - withHooks() — render cycle with scene/shutdown guards\n *   - useScene(), useViewportSize() — Phaser-specific hooks\n *   - useLayoutEffect() — layout-aware effect (rAF-deferred)\n *   - Layout helpers — getLayoutSize, useLayoutRect, etc.\n *   - setUpdateHandler() call — injects Phaser's VDOM patching into core\n *\n * @migration(audit:scene-portal-mount) Phase 3G — core hooks extracted to\n *   @number10/jsx-core. Phaser keeps only its render cycle and Phaser-specific hooks.\n */\n\nimport type { LayoutContainer, LayoutSize } from '@number10/jsx-core'\nimport {\n  useEffect as coreUseEffect,\n  useState as coreUseState,\n  useTheme as coreUseTheme,\n  withHooks as coreWithHooks,\n  getCurrentCtx,\n  setUpdateHandler,\n  type HookContext,\n  type UpdateHandler,\n} from '@number10/jsx-core'\nimport type * as Phaser from 'phaser'\nimport type { BackgroundImage } from './components/backgroundImage'\nimport type { BackgroundProps, LayoutProps, TransformProps } from './core-props'\nimport { getContextFromParent } from './render-context'\nimport type { PhaserPartialTheme } from './theme'\nimport type { ParentType, VNodeLike } from './types'\nimport { isPhaserScene } from './utils/phaser-guards'\nimport { normalizeVNodeLike, patchVNode } from './vdom'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Phaser component context — extends core's HookContext with Phaser-specific fields.\n * The `parent` field is required by withHooks() for scene/shutdown checks.\n */\nexport interface Ctx extends Omit<HookContext, 'vnode' | 'componentVNode' | 'function' | 'theme'> {\n  /** Phaser parent (Scene or Container) */\n  parent: ParentType\n  /** Narrower vnode type (Phaser VNode instead of unknown) */\n  vnode: VNode | null\n  /** Narrower componentVNode type */\n  componentVNode: VNode\n  /** Narrower function return type */\n  function: (props: unknown) => VNodeLike\n  /** Theme context for this component (Phaser-specific theme override map) */\n  theme?: PhaserPartialTheme | undefined\n}\n\n// VNode type — re-exported from @number10/jsx-core for consistency.\nimport type { VNode as CoreVNode } from '@number10/jsx-core'\nexport type { VNode as CoreVNode } from '@number10/jsx-core'\n\n/**\n * VNode type used in the Phaser package.\n * Compatible with core's VNode.\n */\nexport type VNode = CoreVNode\n\n// ---------------------------------------------------------------------------\n// getCurrent — thin wrapper casting core's HookContext to Phaser's Ctx\n// ---------------------------------------------------------------------------\n\n/**\n * Get current hook context from active render.\n * Delegates to core's getCurrentCtx() — the single source of truth.\n * @returns Current context or null if not in render\n */\nexport function getCurrent(): Ctx | null {\n  return getCurrentCtx() as Ctx | null\n}\n\n// ---------------------------------------------------------------------------\n// withHooks — Phaser-specific render cycle\n// ---------------------------------------------------------------------------\n\n/**\n * Executes a render function with hooks context.\n * Delegates to Core's withHooks() with Phaser-specific lifecycle guards\n * and per-mount context isolation via RenderContext.\n *\n * @migration(audit:scene-portal-mount) Phase 6I — delegates to coreWithHooks()\n *   with Phaser scene/shutdown guards. Per-mount context stack preserved\n *   via onAfterRender callback.\n * @param ctx - The component context\n * @param render - The render function to execute\n * @returns The result of the render function, or null if scene is shutting down\n */\nexport function withHooks<T>(ctx: Ctx, render: () => T): T {\n  const renderContext = getContextFromParent(ctx.parent)\n\n  // Per-mount context isolation (pre-Core pattern, preserved for compatibility)\n  const prevMount = renderContext.getCurrent()\n\n  const result = coreWithHooks(ctx as HookContext, render, {\n    isAlive: () => {\n      const scene = isPhaserScene(ctx.parent) ? ctx.parent : ctx.parent.scene\n      if (!scene || !scene.sys || !scene.sys.settings.active) return false\n      if (renderContext.isShutdown()) return false\n      return true\n    },\n    onAfterRender: () => {\n      // Restore per-mount context after render\n      renderContext.setCurrent(prevMount)\n    },\n  })\n\n  // Set per-mount context before render\n  renderContext.setCurrent(ctx)\n  // Note: setCurrentCtx is handled by coreWithHooks()\n\n  return result as T\n}\n\n// ---------------------------------------------------------------------------\n// Phaser-specific hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to access current Phaser scene.\n * @returns Current Phaser scene\n */\nexport function useScene(): Phaser.Scene {\n  const ctx = getCurrent()\n  if (!ctx) throw new Error('useScene must be called within a component')\n\n  const renderContext = getContextFromParent(ctx.parent)\n  return renderContext.scene\n}\n\n/**\n * Hook to get the current viewport size from the active surface context.\n * Reactive — subscribes to Phaser's scene.scale resize events so that\n * overlay components reposition automatically on viewport changes.\n *\n * @migration(audit:surface-access) Phase 7 — scene.scale.on('resize') subscription\n *   triggers re-render when the game canvas is resized.\n * @returns Viewport dimensions { width, height }\n */\nexport function useViewportSize(): { width: number; height: number } {\n  const ctx = getCurrent()\n  const surfaceViewport = ctx?.surface?.viewport\n  if (surfaceViewport) {\n    return surfaceViewport\n  }\n\n  const scene = useScene()\n  const initialSize = { width: scene.scale.width, height: scene.scale.height }\n  const [size, setSize] = coreUseState(initialSize)\n\n  coreUseEffect(() => {\n    const onResize = () => {\n      setSize({ width: scene.scale.width, height: scene.scale.height })\n    }\n    scene.scale.on('resize', onResize)\n    return () => {\n      scene.scale.off('resize', onResize)\n    }\n  }, [scene])\n\n  return size\n}\n\n// ---------------------------------------------------------------------------\n// Layout helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Get the layout-computed size of a container.\n * Works with any renderer's container that implements LayoutContainer duck-typing.\n *\n * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer instead of\n *   Phaser.GameObjects.Container. Portable across renderers.\n */\nexport function getLayoutSize(\n  container: LayoutContainer | null | undefined\n): LayoutSize | undefined {\n  if (!container) return undefined\n  return container.__getLayoutSize?.()\n}\n\n/**\n * Hook to get the layout size of a ref'd container.\n */\nexport function useLayoutSize(ref: { current: LayoutContainer | null }): LayoutSize | undefined {\n  return getLayoutSize(ref.current)\n}\n\n/**\n * Get layout props from a container's metadata.\n *\n * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer.\n */\nexport function getLayoutProps(\n  container: LayoutContainer | null | undefined\n): (LayoutProps & BackgroundProps & TransformProps) | undefined {\n  if (!container) return undefined\n  return container.__layoutProps as (LayoutProps & BackgroundProps & TransformProps) | undefined\n}\n\n/**\n * Get the background graphics object from a container.\n * Phaser-specific: returns Phaser's BackgroundImage type.\n *\n * @phaser-specific Uses Phaser.BackgroundImage via __background duck-typing.\n */\nfunction getBackgroundGraphics(\n  container: LayoutContainer | null | undefined\n): BackgroundImage | undefined {\n  if (!container) return undefined\n  return container.__background as BackgroundImage | undefined\n}\n\n/**\n * Hook to get background graphics from a ref'd container.\n * @phaser-specific\n */\nexport function useBackgroundGraphics(ref: {\n  current: LayoutContainer | null\n}): BackgroundImage | undefined {\n  return getBackgroundGraphics(ref.current)\n}\n\n/**\n * Get the layout-computed rectangle (position + size) of a container.\n *\n * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer.\n */\nexport function getLayoutRect(\n  container: LayoutContainer | null | undefined\n): { x: number; y: number; width: number; height: number } | undefined {\n  if (!container) return undefined\n  const size = getLayoutSize(container)\n  if (!size) return undefined\n  return {\n    x: container.x ?? 0,\n    y: container.y ?? 0,\n    width: size.width,\n    height: size.height,\n  }\n}\n\n/**\n * Hook to get the layout rectangle of a ref'd container.\n */\nexport function useLayoutRect(ref: {\n  current: LayoutContainer | null\n}): { x: number; y: number; width: number; height: number } | undefined {\n  return getLayoutRect(ref.current)\n}\n\n/**\n * Get the world-space layout rectangle of a Phaser container.\n * Phaser-specific: uses `getWorldTransformMatrix()` which is not portable.\n *\n * @phaser-specific\n */\nexport function getWorldLayoutRect(\n  container: Phaser.GameObjects.Container | null | undefined\n): { x: number; y: number; width: number; height: number } | undefined {\n  if (!container) return undefined\n\n  const size = getLayoutSize(container as unknown as LayoutContainer)\n  if (!size) return undefined\n\n  const matrix = container.getWorldTransformMatrix()\n\n  return {\n    x: matrix.tx,\n    y: matrix.ty,\n    width: size.width * Math.abs(matrix.scaleX),\n    height: size.height * Math.abs(matrix.scaleY),\n  }\n}\n\n/**\n * Hook to get the world-space layout rectangle.\n * @phaser-specific\n */\nexport function useWorldLayoutRect(ref: {\n  current: Phaser.GameObjects.Container | null\n}): { x: number; y: number; width: number; height: number } | undefined {\n  return getWorldLayoutRect(ref.current)\n}\n\n// ---------------------------------------------------------------------------\n// useLayoutEffect — now re-exported from Core (Phase 7B dedup)\n// ---------------------------------------------------------------------------\n// Core's useLayoutEffect uses HostScheduler.requestAnimationFrame() with\n// global rAF fallback — identical logic, no Phaser-specific behavior.\n\n// ---------------------------------------------------------------------------\n// Re-exports from @number10/jsx-core — canonical hook implementations\n// ---------------------------------------------------------------------------\n\nexport {\n  depsChanged,\n  disposeCtx,\n  getCurrentCtx,\n  getCurrentOrThrow,\n  setCurrentCtx,\n  shallowEqual,\n  shouldComponentUpdate,\n  useCallback,\n  useEffect,\n  useForceRedraw,\n  useLayoutEffect,\n  useMemo,\n  useRedraw,\n  useRef,\n  useState,\n  useTheme,\n} from '@number10/jsx-core'\n\n/**\n * Hook to access current theme context with Phaser-specific component keys.\n * Wraps core's useTheme() and casts to PhaserPartialTheme for typed access\n * to Phaser component themes (Slider, View, Text, etc.).\n *\n * Prefer core's useTheme() for renderer-agnostic code. Use this hook when\n * you need typed access to Phaser-specific component theme properties.\n *\n * @returns Current theme context or undefined if no theme is set\n */\nexport function usePhaserTheme(): PhaserPartialTheme | undefined {\n  return coreUseTheme() as PhaserPartialTheme | undefined\n}\n\n// ---------------------------------------------------------------------------\n// Register Phaser's update handler with core\n// ---------------------------------------------------------------------------\n\nconst phaserUpdateHandler: UpdateHandler = (c: HookContext) => {\n  const ctx = c as Ctx\n\n  if (ctx.disposed) return\n\n  const scene = isPhaserScene(ctx.parent) ? ctx.parent : ctx.parent.scene\n  if (!scene || !scene.sys || !scene.sys.settings.active) return\n\n  const componentProps = ctx.componentVNode.props ?? {}\n  const propsWithChildren = ctx.componentVNode.children?.length\n    ? { ...componentProps, children: ctx.componentVNode.children }\n    : componentProps\n\n  const nextVNode = normalizeVNodeLike(withHooks(ctx, () => ctx.function(propsWithChildren)))\n\n  patchVNode(ctx.parent, ctx.vnode, nextVNode)\n\n  ctx.vnode = nextVNode\n\n  for (const run of ctx.effects) run()\n}\n\nsetUpdateHandler(phaserUpdateHandler)\n"],"names":["getCurrentCtx","renderContext","getContextFromParent","coreWithHooks","isPhaserScene","coreUseState","coreUseEffect","coreUseTheme","normalizeVNodeLike","patchVNode","setUpdateHandler"],"mappings":"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"}

package/dist/hooks.d.ts

@@ -0,0 +1,151 @@
+import { LayoutContainer, LayoutSize, HookContext, VNode as CoreVNode } from '@number10/jsx-core';
+import { BackgroundImage } from './components/backgroundImage';
+import { BackgroundProps, LayoutProps, TransformProps } from './core-props';
+import { PhaserPartialTheme } from './theme';
+import { ParentType, VNodeLike } from './types';
+import type * as Phaser from 'phaser';
+/**
+ * Phaser component context — extends core's HookContext with Phaser-specific fields.
+ * The `parent` field is required by withHooks() for scene/shutdown checks.
+ */
+export interface Ctx extends Omit<HookContext, 'vnode' | 'componentVNode' | 'function' | 'theme'> {
+    /** Phaser parent (Scene or Container) */
+    parent: ParentType;
+    /** Narrower vnode type (Phaser VNode instead of unknown) */
+    vnode: VNode | null;
+    /** Narrower componentVNode type */
+    componentVNode: VNode;
+    /** Narrower function return type */
+    function: (props: unknown) => VNodeLike;
+    /** Theme context for this component (Phaser-specific theme override map) */
+    theme?: PhaserPartialTheme | undefined;
+}
+export type { VNode as CoreVNode } from '@number10/jsx-core';
+/**
+ * VNode type used in the Phaser package.
+ * Compatible with core's VNode.
+ */
+export type VNode = CoreVNode;
+/**
+ * Get current hook context from active render.
+ * Delegates to core's getCurrentCtx() — the single source of truth.
+ * @returns Current context or null if not in render
+ */
+export declare function getCurrent(): Ctx | null;
+/**
+ * Executes a render function with hooks context.
+ * Delegates to Core's withHooks() with Phaser-specific lifecycle guards
+ * and per-mount context isolation via RenderContext.
+ *
+ * @migration(audit:scene-portal-mount) Phase 6I — delegates to coreWithHooks()
+ *   with Phaser scene/shutdown guards. Per-mount context stack preserved
+ *   via onAfterRender callback.
+ * @param ctx - The component context
+ * @param render - The render function to execute
+ * @returns The result of the render function, or null if scene is shutting down
+ */
+export declare function withHooks<T>(ctx: Ctx, render: () => T): T;
+/**
+ * Hook to access current Phaser scene.
+ * @returns Current Phaser scene
+ */
+export declare function useScene(): Phaser.Scene;
+/**
+ * Hook to get the current viewport size from the active surface context.
+ * Reactive — subscribes to Phaser's scene.scale resize events so that
+ * overlay components reposition automatically on viewport changes.
+ *
+ * @migration(audit:surface-access) Phase 7 — scene.scale.on('resize') subscription
+ *   triggers re-render when the game canvas is resized.
+ * @returns Viewport dimensions { width, height }
+ */
+export declare function useViewportSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Get the layout-computed size of a container.
+ * Works with any renderer's container that implements LayoutContainer duck-typing.
+ *
+ * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer instead of
+ *   Phaser.GameObjects.Container. Portable across renderers.
+ */
+export declare function getLayoutSize(container: LayoutContainer | null | undefined): LayoutSize | undefined;
+/**
+ * Hook to get the layout size of a ref'd container.
+ */
+export declare function useLayoutSize(ref: {
+    current: LayoutContainer | null;
+}): LayoutSize | undefined;
+/**
+ * Get layout props from a container's metadata.
+ *
+ * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer.
+ */
+export declare function getLayoutProps(container: LayoutContainer | null | undefined): (LayoutProps & BackgroundProps & TransformProps) | undefined;
+/**
+ * Hook to get background graphics from a ref'd container.
+ * @phaser-specific
+ */
+export declare function useBackgroundGraphics(ref: {
+    current: LayoutContainer | null;
+}): BackgroundImage | undefined;
+/**
+ * Get the layout-computed rectangle (position + size) of a container.
+ *
+ * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer.
+ */
+export declare function getLayoutRect(container: LayoutContainer | null | undefined): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | undefined;
+/**
+ * Hook to get the layout rectangle of a ref'd container.
+ */
+export declare function useLayoutRect(ref: {
+    current: LayoutContainer | null;
+}): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | undefined;
+/**
+ * Get the world-space layout rectangle of a Phaser container.
+ * Phaser-specific: uses `getWorldTransformMatrix()` which is not portable.
+ *
+ * @phaser-specific
+ */
+export declare function getWorldLayoutRect(container: Phaser.GameObjects.Container | null | undefined): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | undefined;
+/**
+ * Hook to get the world-space layout rectangle.
+ * @phaser-specific
+ */
+export declare function useWorldLayoutRect(ref: {
+    current: Phaser.GameObjects.Container | null;
+}): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | undefined;
+export { depsChanged, disposeCtx, getCurrentCtx, getCurrentOrThrow, setCurrentCtx, shallowEqual, shouldComponentUpdate, useCallback, useEffect, useForceRedraw, useLayoutEffect, useMemo, useRedraw, useRef, useState, useTheme, } from '@number10/jsx-core';
+/**
+ * Hook to access current theme context with Phaser-specific component keys.
+ * Wraps core's useTheme() and casts to PhaserPartialTheme for typed access
+ * to Phaser component themes (Slider, View, Text, etc.).
+ *
+ * Prefer core's useTheme() for renderer-agnostic code. Use this hook when
+ * you need typed access to Phaser-specific component theme properties.
+ *
+ * @returns Current theme context or undefined if no theme is set
+ */
+export declare function usePhaserTheme(): PhaserPartialTheme | undefined;
+//# 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":"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"}

package/dist/hooks.js

@@ -0,0 +1,146 @@
+import { setUpdateHandler, withHooks as withHooks$1, getCurrentCtx, useTheme, useState, useEffect } from "@number10/jsx-core";
+import { depsChanged, disposeCtx, getCurrentCtx as getCurrentCtx2, getCurrentOrThrow, setCurrentCtx, shallowEqual, shouldComponentUpdate, useCallback, useEffect as useEffect2, useForceRedraw, useLayoutEffect, useMemo, useRedraw, useRef, useState as useState2, useTheme as useTheme2 } from "@number10/jsx-core";
+import { getContextFromParent } from "./render-context.js";
+import { isPhaserScene } from "./utils/phaser-guards.js";
+import { normalizeVNodeLike, patchVNode } from "./vdom.js";
+function getCurrent() {
+  return getCurrentCtx();
+}
+function withHooks(ctx, render) {
+  const renderContext = getContextFromParent(ctx.parent);
+  const prevMount = renderContext.getCurrent();
+  const result = withHooks$1(ctx, render, {
+    isAlive: () => {
+      const scene = isPhaserScene(ctx.parent) ? ctx.parent : ctx.parent.scene;
+      if (!scene || !scene.sys || !scene.sys.settings.active) return false;
+      if (renderContext.isShutdown()) return false;
+      return true;
+    },
+    onAfterRender: () => {
+      renderContext.setCurrent(prevMount);
+    }
+  });
+  renderContext.setCurrent(ctx);
+  return result;
+}
+function useScene() {
+  const ctx = getCurrent();
+  if (!ctx) throw new Error("useScene must be called within a component");
+  const renderContext = getContextFromParent(ctx.parent);
+  return renderContext.scene;
+}
+function useViewportSize() {
+  const ctx = getCurrent();
+  const surfaceViewport = ctx?.surface?.viewport;
+  if (surfaceViewport) {
+    return surfaceViewport;
+  }
+  const scene = useScene();
+  const initialSize = { width: scene.scale.width, height: scene.scale.height };
+  const [size, setSize] = useState(initialSize);
+  useEffect(() => {
+    const onResize = () => {
+      setSize({ width: scene.scale.width, height: scene.scale.height });
+    };
+    scene.scale.on("resize", onResize);
+    return () => {
+      scene.scale.off("resize", onResize);
+    };
+  }, [scene]);
+  return size;
+}
+function getLayoutSize(container) {
+  if (!container) return void 0;
+  return container.__getLayoutSize?.();
+}
+function useLayoutSize(ref) {
+  return getLayoutSize(ref.current);
+}
+function getLayoutProps(container) {
+  if (!container) return void 0;
+  return container.__layoutProps;
+}
+function getBackgroundGraphics(container) {
+  if (!container) return void 0;
+  return container.__background;
+}
+function useBackgroundGraphics(ref) {
+  return getBackgroundGraphics(ref.current);
+}
+function getLayoutRect(container) {
+  if (!container) return void 0;
+  const size = getLayoutSize(container);
+  if (!size) return void 0;
+  return {
+    x: container.x ?? 0,
+    y: container.y ?? 0,
+    width: size.width,
+    height: size.height
+  };
+}
+function useLayoutRect(ref) {
+  return getLayoutRect(ref.current);
+}
+function getWorldLayoutRect(container) {
+  if (!container) return void 0;
+  const size = getLayoutSize(container);
+  if (!size) return void 0;
+  const matrix = container.getWorldTransformMatrix();
+  return {
+    x: matrix.tx,
+    y: matrix.ty,
+    width: size.width * Math.abs(matrix.scaleX),
+    height: size.height * Math.abs(matrix.scaleY)
+  };
+}
+function useWorldLayoutRect(ref) {
+  return getWorldLayoutRect(ref.current);
+}
+function usePhaserTheme() {
+  return useTheme();
+}
+const phaserUpdateHandler = (c) => {
+  const ctx = c;
+  if (ctx.disposed) return;
+  const scene = isPhaserScene(ctx.parent) ? ctx.parent : ctx.parent.scene;
+  if (!scene || !scene.sys || !scene.sys.settings.active) return;
+  const componentProps = ctx.componentVNode.props ?? {};
+  const propsWithChildren = ctx.componentVNode.children?.length ? { ...componentProps, children: ctx.componentVNode.children } : componentProps;
+  const nextVNode = normalizeVNodeLike(withHooks(ctx, () => ctx.function(propsWithChildren)));
+  patchVNode(ctx.parent, ctx.vnode, nextVNode);
+  ctx.vnode = nextVNode;
+  for (const run of ctx.effects) run();
+};
+setUpdateHandler(phaserUpdateHandler);
+export {
+  depsChanged,
+  disposeCtx,
+  getCurrent,
+  getCurrentCtx2 as getCurrentCtx,
+  getCurrentOrThrow,
+  getLayoutProps,
+  getLayoutRect,
+  getLayoutSize,
+  getWorldLayoutRect,
+  setCurrentCtx,
+  shallowEqual,
+  shouldComponentUpdate,
+  useBackgroundGraphics,
+  useCallback,
+  useEffect2 as useEffect,
+  useForceRedraw,
+  useLayoutEffect,
+  useLayoutRect,
+  useLayoutSize,
+  useMemo,
+  usePhaserTheme,
+  useRedraw,
+  useRef,
+  useScene,
+  useState2 as useState,
+  useTheme2 as useTheme,
+  useViewportSize,
+  useWorldLayoutRect,
+  withHooks
+};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sources":["../src/hooks.ts"],"sourcesContent":["/**\n * Phaser-specific hook runtime — render cycle + Phaser-only hooks.\n *\n * Core hooks (useState, useRef, useMemo, useCallback, useEffect, useTheme,\n * useForceRedraw, useRedraw, disposeCtx, shallowEqual, shouldComponentUpdate)\n * are re-exported from @number10/jsx-core — the single source of truth.\n *\n * Phaser provides:\n *   - withHooks() — render cycle with scene/shutdown guards\n *   - useScene(), useViewportSize() — Phaser-specific hooks\n *   - useLayoutEffect() — layout-aware effect (rAF-deferred)\n *   - Layout helpers — getLayoutSize, useLayoutRect, etc.\n *   - setUpdateHandler() call — injects Phaser's VDOM patching into core\n *\n * @migration(audit:scene-portal-mount) Phase 3G — core hooks extracted to\n *   @number10/jsx-core. Phaser keeps only its render cycle and Phaser-specific hooks.\n */\n\nimport type { LayoutContainer, LayoutSize } from '@number10/jsx-core'\nimport {\n  useEffect as coreUseEffect,\n  useState as coreUseState,\n  useTheme as coreUseTheme,\n  withHooks as coreWithHooks,\n  getCurrentCtx,\n  setUpdateHandler,\n  type HookContext,\n  type UpdateHandler,\n} from '@number10/jsx-core'\nimport type * as Phaser from 'phaser'\nimport type { BackgroundImage } from './components/backgroundImage'\nimport type { BackgroundProps, LayoutProps, TransformProps } from './core-props'\nimport { getContextFromParent } from './render-context'\nimport type { PhaserPartialTheme } from './theme'\nimport type { ParentType, VNodeLike } from './types'\nimport { isPhaserScene } from './utils/phaser-guards'\nimport { normalizeVNodeLike, patchVNode } from './vdom'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Phaser component context — extends core's HookContext with Phaser-specific fields.\n * The `parent` field is required by withHooks() for scene/shutdown checks.\n */\nexport interface Ctx extends Omit<HookContext, 'vnode' | 'componentVNode' | 'function' | 'theme'> {\n  /** Phaser parent (Scene or Container) */\n  parent: ParentType\n  /** Narrower vnode type (Phaser VNode instead of unknown) */\n  vnode: VNode | null\n  /** Narrower componentVNode type */\n  componentVNode: VNode\n  /** Narrower function return type */\n  function: (props: unknown) => VNodeLike\n  /** Theme context for this component (Phaser-specific theme override map) */\n  theme?: PhaserPartialTheme | undefined\n}\n\n// VNode type — re-exported from @number10/jsx-core for consistency.\nimport type { VNode as CoreVNode } from '@number10/jsx-core'\nexport type { VNode as CoreVNode } from '@number10/jsx-core'\n\n/**\n * VNode type used in the Phaser package.\n * Compatible with core's VNode.\n */\nexport type VNode = CoreVNode\n\n// ---------------------------------------------------------------------------\n// getCurrent — thin wrapper casting core's HookContext to Phaser's Ctx\n// ---------------------------------------------------------------------------\n\n/**\n * Get current hook context from active render.\n * Delegates to core's getCurrentCtx() — the single source of truth.\n * @returns Current context or null if not in render\n */\nexport function getCurrent(): Ctx | null {\n  return getCurrentCtx() as Ctx | null\n}\n\n// ---------------------------------------------------------------------------\n// withHooks — Phaser-specific render cycle\n// ---------------------------------------------------------------------------\n\n/**\n * Executes a render function with hooks context.\n * Delegates to Core's withHooks() with Phaser-specific lifecycle guards\n * and per-mount context isolation via RenderContext.\n *\n * @migration(audit:scene-portal-mount) Phase 6I — delegates to coreWithHooks()\n *   with Phaser scene/shutdown guards. Per-mount context stack preserved\n *   via onAfterRender callback.\n * @param ctx - The component context\n * @param render - The render function to execute\n * @returns The result of the render function, or null if scene is shutting down\n */\nexport function withHooks<T>(ctx: Ctx, render: () => T): T {\n  const renderContext = getContextFromParent(ctx.parent)\n\n  // Per-mount context isolation (pre-Core pattern, preserved for compatibility)\n  const prevMount = renderContext.getCurrent()\n\n  const result = coreWithHooks(ctx as HookContext, render, {\n    isAlive: () => {\n      const scene = isPhaserScene(ctx.parent) ? ctx.parent : ctx.parent.scene\n      if (!scene || !scene.sys || !scene.sys.settings.active) return false\n      if (renderContext.isShutdown()) return false\n      return true\n    },\n    onAfterRender: () => {\n      // Restore per-mount context after render\n      renderContext.setCurrent(prevMount)\n    },\n  })\n\n  // Set per-mount context before render\n  renderContext.setCurrent(ctx)\n  // Note: setCurrentCtx is handled by coreWithHooks()\n\n  return result as T\n}\n\n// ---------------------------------------------------------------------------\n// Phaser-specific hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to access current Phaser scene.\n * @returns Current Phaser scene\n */\nexport function useScene(): Phaser.Scene {\n  const ctx = getCurrent()\n  if (!ctx) throw new Error('useScene must be called within a component')\n\n  const renderContext = getContextFromParent(ctx.parent)\n  return renderContext.scene\n}\n\n/**\n * Hook to get the current viewport size from the active surface context.\n * Reactive — subscribes to Phaser's scene.scale resize events so that\n * overlay components reposition automatically on viewport changes.\n *\n * @migration(audit:surface-access) Phase 7 — scene.scale.on('resize') subscription\n *   triggers re-render when the game canvas is resized.\n * @returns Viewport dimensions { width, height }\n */\nexport function useViewportSize(): { width: number; height: number } {\n  const ctx = getCurrent()\n  const surfaceViewport = ctx?.surface?.viewport\n  if (surfaceViewport) {\n    return surfaceViewport\n  }\n\n  const scene = useScene()\n  const initialSize = { width: scene.scale.width, height: scene.scale.height }\n  const [size, setSize] = coreUseState(initialSize)\n\n  coreUseEffect(() => {\n    const onResize = () => {\n      setSize({ width: scene.scale.width, height: scene.scale.height })\n    }\n    scene.scale.on('resize', onResize)\n    return () => {\n      scene.scale.off('resize', onResize)\n    }\n  }, [scene])\n\n  return size\n}\n\n// ---------------------------------------------------------------------------\n// Layout helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Get the layout-computed size of a container.\n * Works with any renderer's container that implements LayoutContainer duck-typing.\n *\n * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer instead of\n *   Phaser.GameObjects.Container. Portable across renderers.\n */\nexport function getLayoutSize(\n  container: LayoutContainer | null | undefined\n): LayoutSize | undefined {\n  if (!container) return undefined\n  return container.__getLayoutSize?.()\n}\n\n/**\n * Hook to get the layout size of a ref'd container.\n */\nexport function useLayoutSize(ref: { current: LayoutContainer | null }): LayoutSize | undefined {\n  return getLayoutSize(ref.current)\n}\n\n/**\n * Get layout props from a container's metadata.\n *\n * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer.\n */\nexport function getLayoutProps(\n  container: LayoutContainer | null | undefined\n): (LayoutProps & BackgroundProps & TransformProps) | undefined {\n  if (!container) return undefined\n  return container.__layoutProps as (LayoutProps & BackgroundProps & TransformProps) | undefined\n}\n\n/**\n * Get the background graphics object from a container.\n * Phaser-specific: returns Phaser's BackgroundImage type.\n *\n * @phaser-specific Uses Phaser.BackgroundImage via __background duck-typing.\n */\nfunction getBackgroundGraphics(\n  container: LayoutContainer | null | undefined\n): BackgroundImage | undefined {\n  if (!container) return undefined\n  return container.__background as BackgroundImage | undefined\n}\n\n/**\n * Hook to get background graphics from a ref'd container.\n * @phaser-specific\n */\nexport function useBackgroundGraphics(ref: {\n  current: LayoutContainer | null\n}): BackgroundImage | undefined {\n  return getBackgroundGraphics(ref.current)\n}\n\n/**\n * Get the layout-computed rectangle (position + size) of a container.\n *\n * @migration(audit:scene-portal-mount) Phase 6H — uses LayoutContainer.\n */\nexport function getLayoutRect(\n  container: LayoutContainer | null | undefined\n): { x: number; y: number; width: number; height: number } | undefined {\n  if (!container) return undefined\n  const size = getLayoutSize(container)\n  if (!size) return undefined\n  return {\n    x: container.x ?? 0,\n    y: container.y ?? 0,\n    width: size.width,\n    height: size.height,\n  }\n}\n\n/**\n * Hook to get the layout rectangle of a ref'd container.\n */\nexport function useLayoutRect(ref: {\n  current: LayoutContainer | null\n}): { x: number; y: number; width: number; height: number } | undefined {\n  return getLayoutRect(ref.current)\n}\n\n/**\n * Get the world-space layout rectangle of a Phaser container.\n * Phaser-specific: uses `getWorldTransformMatrix()` which is not portable.\n *\n * @phaser-specific\n */\nexport function getWorldLayoutRect(\n  container: Phaser.GameObjects.Container | null | undefined\n): { x: number; y: number; width: number; height: number } | undefined {\n  if (!container) return undefined\n\n  const size = getLayoutSize(container as unknown as LayoutContainer)\n  if (!size) return undefined\n\n  const matrix = container.getWorldTransformMatrix()\n\n  return {\n    x: matrix.tx,\n    y: matrix.ty,\n    width: size.width * Math.abs(matrix.scaleX),\n    height: size.height * Math.abs(matrix.scaleY),\n  }\n}\n\n/**\n * Hook to get the world-space layout rectangle.\n * @phaser-specific\n */\nexport function useWorldLayoutRect(ref: {\n  current: Phaser.GameObjects.Container | null\n}): { x: number; y: number; width: number; height: number } | undefined {\n  return getWorldLayoutRect(ref.current)\n}\n\n// ---------------------------------------------------------------------------\n// useLayoutEffect — now re-exported from Core (Phase 7B dedup)\n// ---------------------------------------------------------------------------\n// Core's useLayoutEffect uses HostScheduler.requestAnimationFrame() with\n// global rAF fallback — identical logic, no Phaser-specific behavior.\n\n// ---------------------------------------------------------------------------\n// Re-exports from @number10/jsx-core — canonical hook implementations\n// ---------------------------------------------------------------------------\n\nexport {\n  depsChanged,\n  disposeCtx,\n  getCurrentCtx,\n  getCurrentOrThrow,\n  setCurrentCtx,\n  shallowEqual,\n  shouldComponentUpdate,\n  useCallback,\n  useEffect,\n  useForceRedraw,\n  useLayoutEffect,\n  useMemo,\n  useRedraw,\n  useRef,\n  useState,\n  useTheme,\n} from '@number10/jsx-core'\n\n/**\n * Hook to access current theme context with Phaser-specific component keys.\n * Wraps core's useTheme() and casts to PhaserPartialTheme for typed access\n * to Phaser component themes (Slider, View, Text, etc.).\n *\n * Prefer core's useTheme() for renderer-agnostic code. Use this hook when\n * you need typed access to Phaser-specific component theme properties.\n *\n * @returns Current theme context or undefined if no theme is set\n */\nexport function usePhaserTheme(): PhaserPartialTheme | undefined {\n  return coreUseTheme() as PhaserPartialTheme | undefined\n}\n\n// ---------------------------------------------------------------------------\n// Register Phaser's update handler with core\n// ---------------------------------------------------------------------------\n\nconst phaserUpdateHandler: UpdateHandler = (c: HookContext) => {\n  const ctx = c as Ctx\n\n  if (ctx.disposed) return\n\n  const scene = isPhaserScene(ctx.parent) ? ctx.parent : ctx.parent.scene\n  if (!scene || !scene.sys || !scene.sys.settings.active) return\n\n  const componentProps = ctx.componentVNode.props ?? {}\n  const propsWithChildren = ctx.componentVNode.children?.length\n    ? { ...componentProps, children: ctx.componentVNode.children }\n    : componentProps\n\n  const nextVNode = normalizeVNodeLike(withHooks(ctx, () => ctx.function(propsWithChildren)))\n\n  patchVNode(ctx.parent, ctx.vnode, nextVNode)\n\n  ctx.vnode = nextVNode\n\n  for (const run of ctx.effects) run()\n}\n\nsetUpdateHandler(phaserUpdateHandler)\n"],"names":["coreWithHooks","coreUseState","coreUseEffect","coreUseTheme"],"mappings":"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"}

package/dist/host.cjs

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const phaserGuards = require("./utils/phaser-guards.cjs");
+const nodeRegistry = {};
+function register(type, descriptor) {
+  nodeRegistry[type] = descriptor;
+}
+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
+   */
+  // @migration(audit:scene-portal-mount) Root-Container — host.create(scene) → HostAdapter.create(type, props, ctx)
+  create(type, props, scene) {
+    const descriptor = nodeRegistry[type];
+    if (!descriptor) {
+      throw new Error(`No host descriptor registered for node type "${String(type)}"`);
+    }
+    return descriptor.create(scene, props);
+  },
+  /**
+   * 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(type, node, prev, next) {
+    const descriptor = nodeRegistry[type];
+    if (!descriptor) {
+      throw new Error(`No host descriptor registered for node type "${String(type)}"`);
+    }
+    descriptor.patch(node, prev, next);
+  },
+  /**
+   * Appends child node to parent container
+   * @param parent - Parent container or scene
+   * @param child - Child node to append
+   */
+  append(parent, child) {
+    if (phaserGuards.isPhaserContainer(parent)) {
+      parent.add(child);
+      child.parent = parent;
+    } else if (phaserGuards.isPhaserScene(parent)) {
+      const scene = parent;
+      scene.add.existing(child);
+      child.parent = void 0;
+    } else if (parent && typeof parent === "object" && "scene" in parent) {
+      const gameObject = parent;
+      if (gameObject.scene?.children) {
+        gameObject.scene.children.add(child);
+        child.parent = void 0;
+      }
+    }
+  },
+  /**
+   * Removes child node from parent and destroys it
+   * @param parent - Parent container
+   * @param child - Child node to remove
+   */
+  remove(parent, child) {
+    const childObj = child;
+    if (!childObj.scene) return;
+    if (phaserGuards.isPhaserContainer(parent)) {
+      parent.remove(childObj, false);
+    }
+    childObj.parent = void 0;
+    if (childObj.destroy) {
+      childObj.destroy(false);
+    }
+  },
+  /**
+   * Performs layout update on container (no-op for native Phaser)
+   */
+  layout() {
+  }
+};
+exports.host = host;
+exports.nodeRegistry = nodeRegistry;
+exports.register = register;
+//# sourceMappingURL=host.cjs.map

package/dist/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.cjs","sources":["../src/host.ts"],"sourcesContent":["/**\n * Host layer - Generic bridge between VDOM and Phaser GameObjects\n * Provides type-safe creator/patcher pattern for extensible node types\n */\nimport type * as Phaser from 'phaser'\nimport type { NodeInstance, NodeProps, NodeType } from './core-types'\nimport { isPhaserContainer, isPhaserScene } from './utils/phaser-guards'\n// @migration(audit:scene-portal-mount) Root-Container — host.ts: HostCreator(scene) → HostAdapter.create(ctx)\n\n/**\n * Host creator function type - creates a node instance from props\n */\nexport type HostCreator<T extends NodeType> = (\n  scene: Phaser.Scene,\n  props: NodeProps<T>\n) => NodeInstance<T>\n\n/**\n * Host patcher function type - updates node properties\n */\nexport type HostPatcher<T extends NodeType> = (\n  node: NodeInstance<T>,\n  prev: NodeProps<T>,\n  next: NodeProps<T>\n) => void\n\n/**\n * Node descriptor combining creator and patcher\n */\nexport interface NodeDescriptor<T extends NodeType> {\n  create: HostCreator<T>\n  patch: HostPatcher<T>\n}\n\n/**\n * Internal registry of node descriptors\n */\ntype NodeRegistry = {\n  [K in NodeType]: NodeDescriptor<K>\n}\n\n/**\n * Node registry - maps node types to their descriptors\n * Exported for external registration of custom node types\n */\nexport const nodeRegistry: Partial<NodeRegistry> = {}\n\n/**\n * Registers a node descriptor (creator + patcher) for a custom node type\n * @param type - Node type name\n * @param descriptor - Node descriptor with create and patch functions\n */\nexport function register<T extends NodeType>(type: T, descriptor: NodeDescriptor<T>): void {\n  nodeRegistry[type] = descriptor as NodeRegistry[T]\n}\n\n/**\n * Host API - Generic interface for VDOM to manage Phaser nodes\n */\nexport const host = {\n  /**\n   * Creates a node instance using the registered creator for the given type\n   * @param type - Node type name\n   * @param props - Node properties\n   * @param scene - Phaser scene\n   * @returns Created node instance\n   * @throws Error if no creator registered for the type\n   */\n  // @migration(audit:scene-portal-mount) Root-Container — host.create(scene) → HostAdapter.create(type, props, ctx)\n  create<T extends NodeType>(type: T, props: NodeProps<T>, scene: Phaser.Scene): NodeInstance<T> {\n    const descriptor = nodeRegistry[type] as NodeDescriptor<T> | undefined\n    if (!descriptor) {\n      throw new Error(`No host descriptor registered for node type \"${String(type)}\"`)\n    }\n    return descriptor.create(scene, props)\n  },\n\n  /**\n   * Patches node properties with updates using the registered patcher\n   * @param type - Node type name\n   * @param node - Node to patch\n   * @param prev - Previous props\n   * @param next - New props\n   */\n  patch<T extends NodeType>(\n    type: T,\n    node: NodeInstance<T>,\n    prev: NodeProps<T>,\n    next: NodeProps<T>\n  ): void {\n    const descriptor = nodeRegistry[type] as NodeDescriptor<T> | undefined\n    if (!descriptor) {\n      throw new Error(`No host descriptor registered for node type \"${String(type)}\"`)\n    }\n    descriptor.patch(node, prev, next)\n  },\n\n  /**\n   * Appends child node to parent container\n   * @param parent - Parent container or scene\n   * @param child - Child node to append\n   */\n  append(parent: unknown, child: unknown) {\n    // Parent is a Container\n    if (isPhaserContainer(parent)) {\n      parent.add(child as Phaser.GameObjects.GameObject)\n      ;(child as { parent?: unknown }).parent = parent\n    }\n    // Parent is a Scene\n    else if (isPhaserScene(parent)) {\n      const scene = parent as Phaser.Scene\n      scene.add.existing(child as Phaser.GameObjects.GameObject)\n      ;(child as { parent?: unknown }).parent = undefined\n    }\n    // Fallback: try to add to display list\n    else if (parent && typeof parent === 'object' && 'scene' in parent) {\n      const gameObject = parent as Phaser.GameObjects.GameObject\n      if (gameObject.scene?.children) {\n        gameObject.scene.children.add(child as Phaser.GameObjects.GameObject)\n        ;(child as { parent?: unknown }).parent = undefined\n      }\n    }\n  },\n\n  /**\n   * Removes child node from parent and destroys it\n   * @param parent - Parent container\n   * @param child - Child node to remove\n   */\n  remove(parent: unknown, child: unknown) {\n    const childObj = child as Phaser.GameObjects.GameObject & { scene?: Phaser.Scene | null }\n\n    // Check if child still has a scene (not already destroyed)\n    if (!childObj.scene) return\n\n    // Remove from parent container first\n    if (isPhaserContainer(parent)) {\n      parent.remove(childObj, false)\n    }\n\n    ;(childObj as { parent?: unknown }).parent = undefined\n\n    // Destroy the child WITHOUT destroying its children (VDOM handles that)\n    if (childObj.destroy) {\n      childObj.destroy(false)\n    }\n  },\n\n  /**\n   * Performs layout update on container (no-op for native Phaser)\n   */\n  layout() {\n    // Native Phaser containers don't have automatic layout\n    // This is a no-op but kept for API compatibility\n  },\n}\n"],"names":["isPhaserContainer","isPhaserScene"],"mappings":";;;AA6CO,MAAM,eAAsC,CAAA;AAO5C,SAAS,SAA6B,MAAS,YAAqC;AACzF,eAAa,IAAI,IAAI;AACvB;AAKO,MAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUlB,OAA2B,MAAS,OAAqB,OAAsC;AAC7F,UAAM,aAAa,aAAa,IAAI;AACpC,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,gDAAgD,OAAO,IAAI,CAAC,GAAG;AAAA,IACjF;AACA,WAAO,WAAW,OAAO,OAAO,KAAK;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MACE,MACA,MACA,MACA,MACM;AACN,UAAM,aAAa,aAAa,IAAI;AACpC,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,gDAAgD,OAAO,IAAI,CAAC,GAAG;AAAA,IACjF;AACA,eAAW,MAAM,MAAM,MAAM,IAAI;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,QAAiB,OAAgB;AAEtC,QAAIA,aAAAA,kBAAkB,MAAM,GAAG;AAC7B,aAAO,IAAI,KAAsC;AAC/C,YAA+B,SAAS;AAAA,IAC5C,WAESC,2BAAc,MAAM,GAAG;AAC9B,YAAM,QAAQ;AACd,YAAM,IAAI,SAAS,KAAsC;AACvD,YAA+B,SAAS;AAAA,IAC5C,WAES,UAAU,OAAO,WAAW,YAAY,WAAW,QAAQ;AAClE,YAAM,aAAa;AACnB,UAAI,WAAW,OAAO,UAAU;AAC9B,mBAAW,MAAM,SAAS,IAAI,KAAsC;AAClE,cAA+B,SAAS;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,QAAiB,OAAgB;AACtC,UAAM,WAAW;AAGjB,QAAI,CAAC,SAAS,MAAO;AAGrB,QAAID,aAAAA,kBAAkB,MAAM,GAAG;AAC7B,aAAO,OAAO,UAAU,KAAK;AAAA,IAC/B;AAEE,aAAkC,SAAS;AAG7C,QAAI,SAAS,SAAS;AACpB,eAAS,QAAQ,KAAK;AAAA,IACxB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS;AAAA,EAGT;AACF;;;;"}

package/dist/host.d.ts

@@ -0,0 +1,78 @@
+import { NodeInstance, NodeProps, NodeType } from './core-types';
+/**
+ * Host layer - Generic bridge between VDOM and Phaser GameObjects
+ * Provides type-safe creator/patcher pattern for extensible node types
+ */
+import type * as Phaser from 'phaser';
+/**
+ * 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,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAIrE;;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;WAEI,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;IAsBtC;;;;OAIG;mBACY,OAAO,SAAS,OAAO;IAmBtC;;OAEG;;CAKJ,CAAA"}

package/dist/host.js

@@ -0,0 +1,85 @@
+import { isPhaserContainer, isPhaserScene } from "./utils/phaser-guards.js";
+const nodeRegistry = {};
+function register(type, descriptor) {
+  nodeRegistry[type] = descriptor;
+}
+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
+   */
+  // @migration(audit:scene-portal-mount) Root-Container — host.create(scene) → HostAdapter.create(type, props, ctx)
+  create(type, props, scene) {
+    const descriptor = nodeRegistry[type];
+    if (!descriptor) {
+      throw new Error(`No host descriptor registered for node type "${String(type)}"`);
+    }
+    return descriptor.create(scene, props);
+  },
+  /**
+   * 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(type, node, prev, next) {
+    const descriptor = nodeRegistry[type];
+    if (!descriptor) {
+      throw new Error(`No host descriptor registered for node type "${String(type)}"`);
+    }
+    descriptor.patch(node, prev, next);
+  },
+  /**
+   * Appends child node to parent container
+   * @param parent - Parent container or scene
+   * @param child - Child node to append
+   */
+  append(parent, child) {
+    if (isPhaserContainer(parent)) {
+      parent.add(child);
+      child.parent = parent;
+    } else if (isPhaserScene(parent)) {
+      const scene = parent;
+      scene.add.existing(child);
+      child.parent = void 0;
+    } else if (parent && typeof parent === "object" && "scene" in parent) {
+      const gameObject = parent;
+      if (gameObject.scene?.children) {
+        gameObject.scene.children.add(child);
+        child.parent = void 0;
+      }
+    }
+  },
+  /**
+   * Removes child node from parent and destroys it
+   * @param parent - Parent container
+   * @param child - Child node to remove
+   */
+  remove(parent, child) {
+    const childObj = child;
+    if (!childObj.scene) return;
+    if (isPhaserContainer(parent)) {
+      parent.remove(childObj, false);
+    }
+    childObj.parent = void 0;
+    if (childObj.destroy) {
+      childObj.destroy(false);
+    }
+  },
+  /**
+   * Performs layout update on container (no-op for native Phaser)
+   */
+  layout() {
+  }
+};
+export {
+  host,
+  nodeRegistry,
+  register
+};
+//# sourceMappingURL=host.js.map