@number10/jsx-core 5.0.0

package/dist/hooks.cjs

@@ -0,0 +1,378 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const globalRegistry = require("./global-registry.cjs");
+const GLOBAL_NS = "@number10/jsx-core";
+const _currentCtxKey = /* @__PURE__ */ Symbol.for(`${GLOBAL_NS}:currentCtx`);
+const _onScheduleUpdateKey = /* @__PURE__ */ Symbol.for(`${GLOBAL_NS}:onScheduleUpdate`);
+function getCurrentCtx() {
+  return globalRegistry.getGlobalValue(_currentCtxKey) ?? null;
+}
+function setCurrentCtx(ctx) {
+  globalRegistry.setGlobalValue(_currentCtxKey, ctx);
+}
+function withHooks(ctx, render, opts) {
+  if (opts?.isAlive && !opts.isAlive()) return null;
+  const prev = getCurrentCtx();
+  setCurrentCtx(ctx);
+  ctx.index = 0;
+  ctx.effects = [];
+  try {
+    const out = render();
+    opts?.onAfterRender?.();
+    return out;
+  } finally {
+    setCurrentCtx(prev);
+  }
+}
+function getCurrentOrThrow() {
+  const ctx = getCurrentCtx();
+  if (!ctx) {
+    throw new Error(
+      "Hook called outside of component render. Hooks (useState, useRef, useEffect, etc.) must be called synchronously during a function component render. This error commonly occurs when:\n  1. A hook is called in an async callback or event handler\n  2. A hook is called after the component has unmounted\n  3. A hook is called in a non-component function"
+    );
+  }
+  return ctx;
+}
+function setUpdateHandler(handler) {
+  globalRegistry.setGlobalValue(_onScheduleUpdateKey, handler);
+}
+function useState(initial) {
+  const c = getCurrentOrThrow();
+  const i = c.index++;
+  if (i >= c.slots.length)
+    c.slots[i] = typeof initial === "function" ? initial() : initial;
+  const value = c.slots[i];
+  const set = (v) => {
+    const next = typeof v === "function" ? v(c.slots[i]) : v;
+    if (Object.is(next, c.slots[i])) return;
+    c.slots[i] = next;
+    scheduleUpdate(c);
+  };
+  return [value, set];
+}
+function useRef(val) {
+  const c = getCurrentOrThrow();
+  const i = c.index++;
+  if (i >= c.slots.length) c.slots[i] = { current: val };
+  return c.slots[i];
+}
+function useMemo(fn, deps) {
+  const c = getCurrentOrThrow();
+  const i = c.index++;
+  const slot = c.slots[i] ?? (c.slots[i] = { deps: void 0, value: void 0 });
+  if (!depsChanged(slot.deps, deps)) return slot.value;
+  slot.value = fn();
+  slot.deps = deps;
+  return slot.value;
+}
+function useCallback(fn, deps) {
+  return useMemo(() => fn, deps);
+}
+function useEffect(fn, deps) {
+  const c = getCurrentOrThrow();
+  const i = c.index++;
+  const slot = c.slots[i] ?? (c.slots[i] = { deps: void 0, cleanup: void 0 });
+  c.effects.push(() => {
+    if (!depsChanged(slot.deps, deps)) return;
+    if (typeof slot.cleanup === "function") slot.cleanup();
+    slot.cleanup = fn();
+    if (deps !== void 0) {
+      slot.deps = deps;
+    }
+  });
+}
+function useTheme() {
+  return getCurrentCtx()?.theme;
+}
+function useThemeTokens() {
+  return getCurrentCtx()?.themeTokens;
+}
+function useForceRedraw(first, ...rest) {
+  const [, setForceRedraw] = useState(0);
+  const throttleMs = typeof first === "number" ? first : void 0;
+  const signals = typeof first === "number" ? rest : [first, ...rest];
+  useEffect(() => {
+    const unsubscribes = [];
+    let lastUpdate = 0;
+    const triggerUpdate = () => {
+      const now = Date.now();
+      if (throttleMs && now - lastUpdate < throttleMs) return;
+      lastUpdate = now;
+      setForceRedraw({});
+    };
+    for (const signal of signals) {
+      if (signal && typeof signal === "object" && "subscribe" in signal) {
+        unsubscribes.push(signal.subscribe(triggerUpdate));
+      }
+    }
+    return () => {
+      unsubscribes.forEach((unsubscribe) => unsubscribe());
+    };
+  }, [throttleMs, ...signals]);
+}
+function useRedraw() {
+  const c = getCurrentCtx();
+  return () => {
+    if (c != null) scheduleUpdate(c);
+  };
+}
+function scheduleUpdate(c) {
+  if (c.updater) return;
+  c.updater = () => {
+    c.updater = void 0;
+    if (c.disposed) return;
+    const handler = c.updateHandler ?? globalRegistry.getGlobalValue(_onScheduleUpdateKey);
+    if (handler) handler(c);
+  };
+  queueMicrotask(c.updater);
+}
+function depsChanged(a, b) {
+  if (!a || !b) return true;
+  if (a.length !== b.length) return true;
+  for (let i = 0; i < a.length; i++) {
+    if (!Object.is(a[i], b[i])) return true;
+  }
+  return false;
+}
+function shallowEqual(a, b) {
+  if (Object.is(a, b)) return true;
+  if (a == null || b == null) return false;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!Object.prototype.hasOwnProperty.call(b, key) || !Object.is(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
+}
+function shouldComponentUpdate(ctx, newProps) {
+  if (ctx.memoized === false) return true;
+  if (ctx.componentVNode.__memo === false) return true;
+  if (ctx.lastProps === void 0) {
+    ctx.lastProps = newProps;
+    return true;
+  }
+  const hasChanged = !shallowEqual(ctx.lastProps, newProps);
+  ctx.lastProps = newProps;
+  return hasChanged;
+}
+function disposeCtx(c) {
+  c.disposed = true;
+  for (const cl of c.cleanups) {
+    if (typeof cl === "function") cl();
+  }
+  for (const slot of c.slots) {
+    if (slot && typeof slot === "object" && "cleanup" in slot && typeof slot.cleanup === "function") {
+      slot.cleanup();
+    }
+  }
+  c.cleanups.length = 0;
+}
+function useSurface() {
+  const ctx = getCurrentCtx();
+  return ctx?.surface ?? null;
+}
+function useViewportSize() {
+  const ctx = getCurrentOrThrow();
+  return ctx.surface?.viewport ?? { width: 0, height: 0 };
+}
+function useDebugSnapshot(intervalMs = 250) {
+  const ctx = getCurrentCtx();
+  const collector = ctx?.surface?.debugSnapshotCollector;
+  const getInitial = () => {
+    if (!collector) return {};
+    try {
+      return collector();
+    } catch {
+      return {};
+    }
+  };
+  const [snapshot, setSnapshot] = useState(getInitial());
+  useEffect(() => {
+    if (!collector) return;
+    const delay = Math.max(50, intervalMs);
+    try {
+      setSnapshot(collector());
+    } catch {
+    }
+    const timer = window.setInterval(() => {
+      try {
+        setSnapshot(collector());
+      } catch {
+      }
+    }, delay);
+    return () => {
+      window.clearInterval(timer);
+    };
+  }, [intervalMs, collector]);
+  return snapshot;
+}
+function useLayoutEffect(fn, deps) {
+  const c = getCurrentOrThrow();
+  const i = c.index++;
+  const slot = c.slots[i] ?? (c.slots[i] = { deps: void 0, cleanup: void 0 });
+  c.effects.push(() => {
+    if (!depsChanged(slot.deps, deps)) return;
+    if (typeof slot.cleanup === "function") slot.cleanup();
+    const scheduler = c.surface?.scheduler;
+    if (scheduler) {
+      scheduler.requestAnimationFrame(() => {
+        slot.cleanup = fn();
+      });
+    } else {
+      requestAnimationFrame(() => {
+        slot.cleanup = fn();
+      });
+    }
+    if (deps !== void 0) {
+      slot.deps = deps;
+    }
+  });
+}
+function useTexture(key, url) {
+  const [ready, setReady] = useState(false);
+  const ctx = getCurrentOrThrow();
+  const loader = ctx.surface?.textureLoader;
+  useEffect(() => {
+    if (!loader) {
+      setReady(true);
+      return;
+    }
+    let cancelled = false;
+    loader.load(key, url).then(() => {
+      if (!cancelled) setReady(true);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [key, url, loader]);
+  return { ready, key };
+}
+function useSVGTexture(keyOrConfigs, svg, width = 32, height = 32) {
+  if (typeof keyOrConfigs === "string") {
+    const key = keyOrConfigs;
+    if (svg == null) throw new Error("SVG string must be provided for single texture load");
+    const svgStr = svg;
+    const [ready2, setReady2] = useState(false);
+    const ctx2 = getCurrentOrThrow();
+    const loader2 = ctx2.surface?.textureLoader;
+    useEffect(() => {
+      if (!loader2) {
+        setReady2(true);
+        return;
+      }
+      let cancelled = false;
+      setReady2(false);
+      loader2.loadSVG(key, svgStr, width, height).then(() => {
+        if (!cancelled) setReady2(true);
+      });
+      return () => {
+        cancelled = true;
+      };
+    }, [key, svgStr, width, height, loader2]);
+    return ready2;
+  }
+  const configs = keyOrConfigs;
+  const [ready, setReady] = useState(false);
+  const ctx = getCurrentOrThrow();
+  const loader = ctx.surface?.textureLoader;
+  const configKey = useMemo(
+    () => configs.map((c) => `${c.key}:${c.width ?? 32}:${c.height ?? 32}`).join("|"),
+    [configs]
+  );
+  useEffect(() => {
+    if (!loader || configs.length === 0) {
+      setReady(true);
+      return;
+    }
+    let cancelled = false;
+    setReady(false);
+    const loadSequentially = async () => {
+      for (const { key, svg: s, width: w = 32, height: h = 32 } of configs) {
+        if (cancelled) return;
+        await loader.loadSVG(key, s, w, h);
+      }
+      if (!cancelled) setReady(true);
+    };
+    loadSequentially();
+    return () => {
+      cancelled = true;
+    };
+  }, [configKey, loader]);
+  return ready;
+}
+function asTextureResolver(loader) {
+  if (loader && typeof loader.getFrameNames === "function" && typeof loader.getFrameInfo === "function" && typeof loader.getFrameRect === "function" && typeof loader.getTextureSize === "function") {
+    return loader;
+  }
+  return void 0;
+}
+function useAtlas(key, imageUrl, dataUrl) {
+  const [ready, setReady] = useState(false);
+  const ctx = getCurrentOrThrow();
+  const loader = ctx.surface?.textureLoader;
+  const resolver = asTextureResolver(loader);
+  useEffect(() => {
+    if (!loader) {
+      setReady(true);
+      return;
+    }
+    let cancelled = false;
+    loader.loadAtlas(key, imageUrl, dataUrl).then(() => {
+      if (!cancelled) setReady(true);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [key, imageUrl, dataUrl, loader]);
+  const textureSize = useMemo(
+    () => ready && resolver ? resolver.getTextureSize(key) : void 0,
+    [ready, resolver, key]
+  );
+  const frameNames = useMemo(
+    () => ready && resolver ? resolver.getFrameNames(key) : [],
+    [ready, resolver, key]
+  );
+  const frames = useMemo(
+    () => frameNames.map((frame) => resolver?.getFrameInfo(key, frame)).filter((frame) => frame !== void 0),
+    [frameNames, resolver, key]
+  );
+  const getFrameInfo = useCallback(
+    (frame) => ready && resolver ? resolver.getFrameInfo(key, frame) : void 0,
+    [ready, resolver, key]
+  );
+  const getFrameRect = useCallback(
+    (frame) => ready && resolver ? resolver.getFrameRect(key, frame) : void 0,
+    [ready, resolver, key]
+  );
+  return { ready, key, textureSize, frameNames, frames, getFrameInfo, getFrameRect };
+}
+exports.depsChanged = depsChanged;
+exports.disposeCtx = disposeCtx;
+exports.getCurrentCtx = getCurrentCtx;
+exports.getCurrentOrThrow = getCurrentOrThrow;
+exports.setCurrentCtx = setCurrentCtx;
+exports.setUpdateHandler = setUpdateHandler;
+exports.shallowEqual = shallowEqual;
+exports.shouldComponentUpdate = shouldComponentUpdate;
+exports.useAtlas = useAtlas;
+exports.useCallback = useCallback;
+exports.useDebugSnapshot = useDebugSnapshot;
+exports.useEffect = useEffect;
+exports.useForceRedraw = useForceRedraw;
+exports.useLayoutEffect = useLayoutEffect;
+exports.useMemo = useMemo;
+exports.useRedraw = useRedraw;
+exports.useRef = useRef;
+exports.useSVGTexture = useSVGTexture;
+exports.useState = useState;
+exports.useSurface = useSurface;
+exports.useTexture = useTexture;
+exports.useTheme = useTheme;
+exports.useThemeTokens = useThemeTokens;
+exports.useViewportSize = useViewportSize;
+exports.withHooks = withHooks;
+//# sourceMappingURL=hooks.cjs.map

package/dist/hooks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.cjs","sources":["../src/hooks.ts"],"sourcesContent":["/**\n * Portable hook runtime — renderer-neutral component state management.\n *\n * Provides React-like hooks (useState, useEffect, useMemo, useRef, useCallback)\n * that work against a generic HookContext. Each renderer provides its own\n * `withHooks()` wrapper that supplies the context and manages the render cycle.\n *\n * @migration(audit:scene-portal-mount) Phase 3G — extracted from packages/ui/src/hooks.ts.\n *   Pure hook functions live here. Phaser-specific hooks (useScene, layout helpers)\n *   and the render cycle (withHooks, scheduleUpdate) remain in the renderer package.\n */\n\nimport type { Signal } from '@preact/signals-core'\nimport type { DesignTokens } from './design-tokens/design-token-types'\nimport { getGlobalValue, setGlobalValue } from './global-registry'\nimport type {\n  AtlasFrameInfo,\n  FrameRect,\n  Size,\n  SurfaceContext,\n  TextureResolver,\n} from './host-adapter'\nimport type { PartialTheme } from './theme'\n\n// ---------------------------------------------------------------------------\n// HookContext — portable context for hook state\n// ---------------------------------------------------------------------------\n\ntype Cleanup = void | (() => void)\n\n/**\n * Portable hook context — the data structure passed through the hook runtime.\n * Each renderer extends this with renderer-specific fields (e.g., Phaser adds `parent: ParentType`).\n */\nexport interface HookContext {\n  /** Current hook slot index (incremented by each hook call) */\n  index: number\n  /** Hook state slots (one per hook call) */\n  slots: unknown[]\n  /** Pending effects to run after render */\n  effects: (() => Cleanup)[]\n  /** Cleanup functions to run on unmount */\n  cleanups: Cleanup[]\n  /** The rendered VNode output of the component */\n  vnode: unknown | null\n  /** The component VNode itself (type = function) */\n  componentVNode: {\n    type: unknown\n    props?: Record<string, unknown> | undefined\n    children?: unknown[]\n    __memo?: boolean\n  }\n  /** The component function */\n  function: (props: unknown) => unknown\n  /** Optional updater callback (set by renderer's withHooks/scheduleUpdate) */\n  updater?: (() => void) | undefined\n  /** Optional per-runtime update handler for concurrent renderer runtimes */\n  updateHandler?: ((ctx: HookContext) => void) | undefined\n  /** Whether this is a VNode factory (no hooks used) */\n  isFactory: boolean\n  /** Last rendered props (for memoization) */\n  lastProps?: unknown\n  /** Whether component uses memoization (default: true) */\n  memoized?: boolean\n  /** Theme context for this component */\n  theme?: PartialTheme | undefined\n  /** Design tokens injected by the renderer (colors, text styles, spacing, etc.) */\n  themeTokens?: Record<string, unknown> | undefined\n  /** Flag to prevent updates after disposal */\n  disposed?: boolean\n  /**\n   * Surface context for accessing viewport, scheduler, and capabilities.\n   * Set by the renderer's withHooks() wrapper during component render.\n   *\n   * @migration(audit:scene-portal-mount) Phase 6G — enables portable hooks\n   *   (useViewportSize, useLayoutEffect via HostScheduler, ...).\n   */\n  surface?: SurfaceContext | undefined\n}\n\n// ---------------------------------------------------------------------------\n// Global registry for bundler-safe module-level state\n// ---------------------------------------------------------------------------\n\nconst GLOBAL_NS = '@number10/jsx-core'\nconst _currentCtxKey = Symbol.for(`${GLOBAL_NS}:currentCtx`)\nconst _onScheduleUpdateKey = Symbol.for(`${GLOBAL_NS}:onScheduleUpdate`)\n\n/**\n * Get the current hook context. Must be called during component render.\n * Uses a global registry to ensure correctness even when bundlers duplicate modules.\n * @returns Current context or null if not in render\n */\nexport function getCurrentCtx(): HookContext | null {\n  return getGlobalValue<HookContext | null>(_currentCtxKey) ?? null\n}\n\n/**\n * Set the current hook context. Called by withHooks() in the renderer.\n * @internal\n */\nexport function setCurrentCtx(ctx: HookContext | null): void {\n  setGlobalValue(_currentCtxKey, ctx)\n}\n\n/**\n * Portable render cycle — sets up hook context, runs render, runs effects.\n * Each renderer wraps this with its own lifecycle guards.\n *\n * @param ctx - The hook context for this component\n * @param render - The render function to execute\n * @param opts - Optional renderer-specific hooks\n * @returns The result of the render function, or null if the guard fails\n *\n * @migration(audit:scene-portal-mount) Phase 6I — extracted from Phaser withHooks().\n *   The guard callback replaces Phaser-specific scene/shutdown checks.\n */\nexport function withHooks<T>(\n  ctx: HookContext,\n  render: () => T,\n  opts?: {\n    /** Renderer-specific lifecycle guard. Return false to abort render. */\n    isAlive?: () => boolean\n    /** Called after render, before restoring context. For renderer-specific side effects. */\n    onAfterRender?: () => void\n  }\n): T | null {\n  if (opts?.isAlive && !opts.isAlive()) return null\n\n  const prev = getCurrentCtx()\n  setCurrentCtx(ctx)\n  ctx.index = 0\n  ctx.effects = []\n\n  try {\n    const out = render()\n    opts?.onAfterRender?.()\n    return out\n  } finally {\n    setCurrentCtx(prev)\n  }\n}\n\n/**\n * Get current hook context, throwing if not in a render context.\n * Used by hooks that MUST be called during render.\n * @returns Non-null hook context\n * @throws Error if called outside of a component render\n */\nexport function getCurrentOrThrow(): HookContext {\n  const ctx = getCurrentCtx()\n  if (!ctx) {\n    throw new Error(\n      'Hook called outside of component render. ' +\n        'Hooks (useState, useRef, useEffect, etc.) must be called synchronously ' +\n        'during a function component render. ' +\n        'This error commonly occurs when:\\n' +\n        '  1. A hook is called in an async callback or event handler\\n' +\n        '  2. A hook is called after the component has unmounted\\n' +\n        '  3. A hook is called in a non-component function'\n    )\n  }\n  return ctx\n}\n\n// ---------------------------------------------------------------------------\n// Injectable update handler — renderer-provided VDOM patching\n// ---------------------------------------------------------------------------\n\n/** Callback type for renderer-specific update logic */\nexport type UpdateHandler = (ctx: HookContext) => void\n\n/**\n * Register a renderer-specific update handler.\n * Called once by the renderer package to override core's no-op scheduleUpdate.\n * Uses a global registry to ensure correctness even when bundlers duplicate modules.\n * @param handler - Function that performs the actual VDOM patching for a component\n */\nexport function setUpdateHandler(handler: UpdateHandler): void {\n  setGlobalValue(_onScheduleUpdateKey, handler)\n}\n\n// ---------------------------------------------------------------------------\n// State hook\n// ---------------------------------------------------------------------------\n\n/**\n * State hook for managing component state.\n * @param initial - Initial state value or initializer function\n * @returns Tuple of current state and setter function\n */\nexport function useState<T>(initial: T): [T, (v: T | ((p: T) => T)) => void] {\n  const c = getCurrentOrThrow()\n  const i = c.index++\n  if (i >= c.slots.length)\n    c.slots[i] = typeof initial === 'function' ? (initial as () => T)() : initial\n  const value = c.slots[i] as T\n  const set = (v: T | ((p: T) => T)) => {\n    const next = typeof v === 'function' ? (v as (p: T) => T)(c.slots[i] as T) : v\n    if (Object.is(next, c.slots[i])) return\n    c.slots[i] = next\n    scheduleUpdate(c)\n  }\n  return [value, set]\n}\n\n// ---------------------------------------------------------------------------\n// Ref hook\n// ---------------------------------------------------------------------------\n\n/**\n * Ref hook for storing mutable values.\n * @param val - Initial ref value\n * @returns Ref object with current property\n */\nexport function useRef<T>(val: T): { current: T } {\n  const c = getCurrentOrThrow()\n  const i = c.index++\n  if (i >= c.slots.length) c.slots[i] = { current: val }\n  return c.slots[i] as { current: T }\n}\n\n// ---------------------------------------------------------------------------\n// Memoization hook\n// ---------------------------------------------------------------------------\n\n/**\n * Memoization hook for expensive computations.\n * @param fn - Function to memoize\n * @param deps - Dependency array\n * @returns Memoized value\n */\nexport function useMemo<T>(fn: () => T, deps: readonly unknown[]): T {\n  const c = getCurrentOrThrow()\n  const i = c.index++\n  const slot = (c.slots[i] ?? (c.slots[i] = { deps: undefined, value: undefined as T })) as {\n    deps?: readonly unknown[]\n    value: T\n  }\n  if (!depsChanged(slot.deps, deps)) return slot.value\n  slot.value = fn()\n  slot.deps = deps\n  return slot.value\n}\n\n// ---------------------------------------------------------------------------\n// Callback memoization hook\n// ---------------------------------------------------------------------------\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useCallback<T extends (...args: any[]) => any>(fn: T, deps: readonly unknown[]): T {\n  return useMemo(() => fn, deps)\n}\n\n// ---------------------------------------------------------------------------\n// Effect hook\n// ---------------------------------------------------------------------------\n\n/**\n * Effect hook for side effects with cleanup.\n * @param fn - Effect function that optionally returns cleanup\n * @param deps - Optional dependency array\n */\nexport function useEffect(fn: () => Cleanup, deps?: readonly unknown[] | undefined) {\n  const c = getCurrentOrThrow()\n  const i = c.index++\n  const slot = (c.slots[i] ??\n    (c.slots[i] = { deps: undefined, cleanup: undefined as Cleanup })) as {\n    deps?: readonly unknown[] | undefined\n    cleanup: Cleanup\n  }\n  c.effects.push(() => {\n    if (!depsChanged(slot.deps, deps)) return\n    if (typeof slot.cleanup === 'function') slot.cleanup()\n    slot.cleanup = fn()\n    if (deps !== undefined) {\n      slot.deps = deps\n    }\n  })\n}\n\n// ---------------------------------------------------------------------------\n// Theme hook\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to access current theme context.\n * Returns the theme that was passed down through the VDOM tree.\n * @returns Current theme context or undefined if no theme is set\n */\nexport function useTheme(): PartialTheme | undefined {\n  return getCurrentCtx()?.theme as PartialTheme | undefined\n}\n\n/**\n * Hook to access design tokens injected by the renderer.\n * Each renderer sets `themeTokens` on the hook context during component render\n * (e.g., Phaser's plugin injects color presets, text styles, spacing).\n * Returns undefined if no tokens are configured by the active renderer.\n * @returns Design tokens or undefined\n */\nexport function useThemeTokens<T = DesignTokens>(): T | undefined {\n  return getCurrentCtx()?.themeTokens as T | undefined\n}\n\n// ---------------------------------------------------------------------------\n// Force re-render via signals\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to force component re-render when signals change.\n */\nexport function useForceRedraw(throttleMs: number, ...signals: Signal<unknown>[]): void\nexport function useForceRedraw(...signals: Signal<unknown>[]): void\nexport function useForceRedraw(first: number | Signal<unknown>, ...rest: Signal<unknown>[]): void {\n  const [, setForceRedraw] = useState<unknown>(0)\n  const throttleMs = typeof first === 'number' ? first : undefined\n  const signals = typeof first === 'number' ? rest : [first, ...rest]\n\n  useEffect(() => {\n    const unsubscribes: (() => void)[] = []\n    let lastUpdate = 0\n\n    const triggerUpdate = () => {\n      const now = Date.now()\n      if (throttleMs && now - lastUpdate < throttleMs) return\n      lastUpdate = now\n      setForceRedraw({})\n    }\n\n    for (const signal of signals) {\n      if (signal && typeof signal === 'object' && 'subscribe' in signal) {\n        unsubscribes.push(signal.subscribe(triggerUpdate))\n      }\n    }\n\n    return () => {\n      unsubscribes.forEach((unsubscribe) => unsubscribe())\n    }\n  }, [throttleMs, ...signals])\n}\n\n// ---------------------------------------------------------------------------\n// Manual redraw trigger\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to manually trigger a component redraw.\n * @returns Function to trigger redraw\n */\nexport function useRedraw(): () => void {\n  const c = getCurrentCtx()\n  return () => {\n    if (c != null) scheduleUpdate(c)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Scheduling — portable version (calls ctx.updater)\n// ---------------------------------------------------------------------------\n\n/**\n * Schedule a component update on next microtask.\n * The renderer provides the actual update logic via ctx.updater.\n * @param c - Component context to update\n */\nfunction scheduleUpdate(c: HookContext) {\n  if (c.updater) return\n  c.updater = () => {\n    c.updater = undefined\n    if (c.disposed) return\n    // Delegates to renderer-provided update handler (e.g., Phaser's VDOM patching)\n    const handler = c.updateHandler ?? getGlobalValue<UpdateHandler>(_onScheduleUpdateKey)\n    if (handler) handler(c)\n  }\n  queueMicrotask(c.updater)\n}\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Checks if dependency arrays have changed.\n */\nexport function depsChanged(a?: readonly unknown[], b?: readonly unknown[]) {\n  if (!a || !b) return true\n  if (a.length !== b.length) return true\n  for (let i = 0; i < a.length; i++) {\n    if (!Object.is(a[i], b[i])) return true\n  }\n  return false\n}\n\n/**\n * Shallow comparison for props objects.\n * Used for component memoization (React.memo equivalent).\n */\nexport function shallowEqual(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true\n  if (a == null || b == null) return false\n  if (typeof a !== 'object' || typeof b !== 'object') return false\n\n  const keysA = Object.keys(a as object)\n  const keysB = Object.keys(b as object)\n  if (keysA.length !== keysB.length) return false\n\n  for (const key of keysA) {\n    if (\n      !Object.prototype.hasOwnProperty.call(b, key) ||\n      !Object.is((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])\n    ) {\n      return false\n    }\n  }\n  return true\n}\n\n/**\n * Check if component should update based on props comparison.\n */\nexport function shouldComponentUpdate(ctx: HookContext, newProps: unknown): boolean {\n  if (ctx.memoized === false) return true\n  if (ctx.componentVNode.__memo === false) return true\n\n  if (ctx.lastProps === undefined) {\n    ctx.lastProps = newProps\n    return true\n  }\n\n  const hasChanged = !shallowEqual(ctx.lastProps, newProps)\n  ctx.lastProps = newProps\n  return hasChanged\n}\n\n/**\n * Disposes component context and runs cleanups.\n */\nexport function disposeCtx(c: HookContext) {\n  c.disposed = true\n\n  for (const cl of c.cleanups) {\n    if (typeof cl === 'function') cl()\n  }\n\n  for (const slot of c.slots) {\n    if (\n      slot &&\n      typeof slot === 'object' &&\n      'cleanup' in slot &&\n      typeof (slot as { cleanup?: () => void }).cleanup === 'function'\n    ) {\n      ;(slot as { cleanup: () => void }).cleanup()\n    }\n  }\n\n  c.cleanups.length = 0\n}\n\n// ---------------------------------------------------------------------------\n// Surface-aware hooks (Phase 6G+)\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to access the full SurfaceContext (viewport, scheduler, capabilities).\n * Must be called during component render. Returns null if no surface is available.\n *\n * Portable — works with any renderer that provides SurfaceContext.\n * @returns SurfaceContext or null\n *\n * @migration(audit:surface-access) Phase 7 — new hook, replaces manual ctx.surface access.\n */\nexport function useSurface(): SurfaceContext | null {\n  const ctx = getCurrentCtx()\n  return ctx?.surface ?? null\n}\n\n/**\n * Hook to get the current viewport size from the surface context.\n * Portable — works with any renderer that provides SurfaceContext.\n * @returns Viewport dimensions { width, height }\n *\n * @migration(audit:scene-portal-mount) Phase 6G — extracted from Phaser hooks.ts.\n *   Uses ctx.surface.viewport instead of Phaser-specific RenderContext.\n */\nexport function useViewportSize(): { width: number; height: number } {\n  const ctx = getCurrentOrThrow()\n  return ctx.surface?.viewport ?? { width: 0, height: 0 }\n}\n\n// ---------------------------------------------------------------------------\n// useDebugSnapshot — renderer-agnostic debug metrics hook\n// ---------------------------------------------------------------------------\n\n/**\n * Hook that collects debug metrics from the active renderer on an interval.\n *\n * Delegates to the `debugSnapshotCollector` function registered by the\n * renderer on the {@link SurfaceContext}. When no collector is registered,\n * returns an empty snapshot.\n *\n * Portable — works with any renderer (Phaser, Pixi, …). Each renderer\n * wires its own collector into the SurfaceContext during surface creation.\n *\n * @param intervalMs - Refresh interval in milliseconds (default: 250)\n * @returns Debug snapshot (key → string|number), refreshed on interval\n *\n * @example\n * ```tsx\n * import { useDebugSnapshot } from '@number10/jsx-core'\n * import { DebugPanel } from '@number10/jsx-components'\n *\n * function App() {\n *   const snapshot = useDebugSnapshot(500)\n *   return <DebugPanel snapshot={snapshot} metrics={['fps', 'renderer']} />\n * }\n * ```\n */\nexport function useDebugSnapshot(intervalMs = 250): Record<string, string | number> {\n  const ctx = getCurrentCtx()\n  const collector = ctx?.surface?.debugSnapshotCollector\n\n  const getInitial = (): Record<string, string | number> => {\n    if (!collector) return {}\n    try {\n      return collector()\n    } catch {\n      return {}\n    }\n  }\n\n  const [snapshot, setSnapshot] = useState(getInitial())\n\n  useEffect(() => {\n    if (!collector) return\n\n    const delay = Math.max(50, intervalMs)\n    try {\n      setSnapshot(collector())\n    } catch {\n      // collector may throw if renderer not ready yet\n    }\n\n    const timer = window.setInterval(() => {\n      try {\n        setSnapshot(collector())\n      } catch {\n        // silently ignore\n      }\n    }, delay)\n\n    return () => {\n      window.clearInterval(timer)\n    }\n  }, [intervalMs, collector])\n\n  return snapshot\n}\n\n// ---------------------------------------------------------------------------\n// Layout-aware effect hook (Phase 6H)\n// ---------------------------------------------------------------------------\n\ntype CleanupFn = void | (() => void)\n\n/**\n * Layout-aware effect hook — defers execution to the next animation frame.\n * Uses HostScheduler.requestAnimationFrame() when available, falls back to\n * global requestAnimationFrame.\n *\n * Portable across renderers. Each renderer's HostScheduler provides the tick source.\n * Phaser uses scene.events.once('update'), PixiJS would use app.ticker.addOnce().\n *\n * @param fn - Effect function that optionally returns a cleanup\n * @param deps - Optional dependency array\n *\n * @migration(audit:scene-portal-mount) Phase 6H — portable version uses HostScheduler.\n */\nexport function useLayoutEffect(fn: () => CleanupFn, deps?: readonly unknown[] | undefined) {\n  const c = getCurrentOrThrow()\n  const i = c.index++\n  const slot = (c.slots[i] ??\n    (c.slots[i] = { deps: undefined, cleanup: undefined as CleanupFn })) as {\n    deps?: readonly unknown[] | undefined\n    cleanup: CleanupFn\n  }\n  c.effects.push(() => {\n    if (!depsChanged(slot.deps, deps)) return\n    if (typeof slot.cleanup === 'function') slot.cleanup()\n\n    const scheduler = c.surface?.scheduler\n    if (scheduler) {\n      scheduler.requestAnimationFrame(() => {\n        slot.cleanup = fn()\n      })\n    } else {\n      requestAnimationFrame(() => {\n        slot.cleanup = fn()\n      })\n    }\n\n    if (deps !== undefined) {\n      slot.deps = deps\n    }\n  })\n}\n\n// ---------------------------------------------------------------------------\n// useTexture — portable texture loading hook\n// ---------------------------------------------------------------------------\n\n/**\n * Load a texture from a URL and register it under the given key.\n * Returns `{ ready, key }` — use `key` as the `texture` prop on `<Image>`.\n *\n * Portable — works with any renderer that provides `textureLoader` on\n * its SurfaceContext. Replaces Phaser-specific preload functions.\n *\n * @param key — Unique texture key (e.g. 'icon', 'background')\n * @param url — URL to load the texture from\n * @returns `{ ready: boolean, key: string }`\n *\n * @example\n * ```tsx\n * function MyIcon() {\n *   const { ready, key } = useTexture('star', '/assets/star.png')\n *   if (!ready) return <Text text=\"Loading...\" />\n *   return <Image texture={key} width={48} height={48} />\n * }\n * ```\n */\nexport function useTexture(key: string, url: string): { ready: boolean; key: string } {\n  const [ready, setReady] = useState(false)\n  const ctx = getCurrentOrThrow()\n  const loader = ctx.surface?.textureLoader\n\n  useEffect(() => {\n    if (!loader) {\n      setReady(true)\n      return\n    }\n\n    let cancelled = false\n    loader.load(key, url).then(() => {\n      if (!cancelled) setReady(true)\n    })\n\n    return () => {\n      cancelled = true\n    }\n  }, [key, url, loader])\n\n  return { ready, key }\n}\n\n// ---------------------------------------------------------------------------\n// SVGTextureConfig — portable SVG texture configuration\n// ---------------------------------------------------------------------------\n\n/**\n * Configuration for loading a single SVG as a texture.\n * Used by {@link useSVGTexture} for batch loading.\n */\nexport interface SVGTextureConfig {\n  /** Unique texture key */\n  key: string\n  /** SVG markup string */\n  svg: string\n  /** Texture width in pixels (default: 32) */\n  width?: number\n  /** Texture height in pixels (default: 32) */\n  height?: number\n}\n\n// ---------------------------------------------------------------------------\n// useSVGTexture — portable single & batch SVG→texture hook\n// ---------------------------------------------------------------------------\n\n/**\n * Render an SVG string to a texture and register it under the given key.\n * Returns `ready: boolean` — when true, use the key as `<Image texture={key} />`.\n *\n * Portable — works with any renderer that provides `textureLoader.loadSVG`\n * on its SurfaceContext.\n */\nexport function useSVGTexture(key: string, svg: string, width?: number, height?: number): boolean\n/**\n * Load multiple SVGs as textures in batch.\n * Returns `ready: boolean` — when true, all textures are registered.\n */\nexport function useSVGTexture(configs: SVGTextureConfig[]): boolean\nexport function useSVGTexture(\n  keyOrConfigs: string | SVGTextureConfig[],\n  svg?: string,\n  width: number = 32,\n  height: number = 32\n): boolean {\n  // Singular mode\n  if (typeof keyOrConfigs === 'string') {\n    const key = keyOrConfigs\n    if (svg == null) throw new Error('SVG string must be provided for single texture load')\n    const svgStr = svg\n    const [ready, setReady] = useState(false)\n    const ctx = getCurrentOrThrow()\n    const loader = ctx.surface?.textureLoader\n\n    useEffect(() => {\n      if (!loader) {\n        setReady(true)\n        return\n      }\n\n      let cancelled = false\n      setReady(false)\n      loader.loadSVG(key, svgStr, width, height).then(() => {\n        if (!cancelled) setReady(true)\n      })\n\n      return () => {\n        cancelled = true\n      }\n    }, [key, svgStr, width, height, loader])\n\n    return ready\n  }\n\n  // Batch mode\n  const configs = keyOrConfigs\n  const [ready, setReady] = useState(false)\n  const ctx = getCurrentOrThrow()\n  const loader = ctx.surface?.textureLoader\n\n  // Stable key from configs to detect semantic changes (not referential)\n  const configKey = useMemo(\n    () => configs.map((c) => `${c.key}:${c.width ?? 32}:${c.height ?? 32}`).join('|'),\n    [configs]\n  )\n\n  useEffect(() => {\n    if (!loader || configs.length === 0) {\n      setReady(true)\n      return\n    }\n\n    let cancelled = false\n    setReady(false)\n\n    const loadSequentially = async () => {\n      for (const { key, svg: s, width: w = 32, height: h = 32 } of configs) {\n        if (cancelled) return\n        await loader.loadSVG(key, s, w, h)\n      }\n      if (!cancelled) setReady(true)\n    }\n\n    loadSequentially()\n\n    return () => {\n      cancelled = true\n    }\n  }, [configKey, loader])\n\n  return ready\n}\n\n// ---------------------------------------------------------------------------\n// useAtlas — portable atlas (spritesheet) loading hook\n// ---------------------------------------------------------------------------\n\n/**\n * Result object returned by {@link useAtlas}.\n *\n * Combines atlas loading state with portable metadata access so callers can\n * render frames and inspect atlas contents without renderer-specific APIs.\n */\nexport interface UseAtlasResult {\n  /** Whether the atlas image and JSON data are fully loaded and queryable. */\n  ready: boolean\n  /** Texture key to pass into portable image-like components. */\n  key: string\n  /** Dimensions of the full atlas texture, if available from the active renderer. */\n  textureSize: Size | undefined\n  /** All known frame names within the loaded atlas. */\n  frameNames: string[]\n  /** Full portable metadata for every known frame in the atlas. */\n  frames: AtlasFrameInfo[]\n  /** Look up full metadata for a specific frame name. */\n  getFrameInfo: (frame: string) => AtlasFrameInfo | undefined\n  /** Look up only the atlas rectangle for a specific frame name. */\n  getFrameRect: (frame: string) => FrameRect | undefined\n}\n\nfunction asTextureResolver(\n  loader: SurfaceContext['textureLoader'] | undefined\n): TextureResolver | undefined {\n  if (\n    loader &&\n    typeof (loader as Partial<TextureResolver>).getFrameNames === 'function' &&\n    typeof (loader as Partial<TextureResolver>).getFrameInfo === 'function' &&\n    typeof (loader as Partial<TextureResolver>).getFrameRect === 'function' &&\n    typeof (loader as Partial<TextureResolver>).getTextureSize === 'function'\n  ) {\n    return loader as TextureResolver\n  }\n  return undefined\n}\n\n/**\n * Load a texture atlas from image + data URLs.\n * Returns `{ ready, key }` plus portable atlas metadata helpers.\n * Use `key` as `texture` and frame names as `frame`.\n *\n * @param key — Unique atlas key (e.g. 'buttons')\n * @param imageUrl — URL to the atlas image (PNG)\n * @param dataUrl — URL to the atlas data (JSON)\n *\n * @example\n * ```tsx\n * const { ready, key } = useAtlas('buttons', '/ui/buttons.png', '/ui/buttons.json')\n * if (!ready) return <Text text=\"Loading...\" />\n * return <Image texture={key} frame=\"ButtonGreen\" />\n * ```\n */\nexport function useAtlas(key: string, imageUrl: string, dataUrl: string): UseAtlasResult {\n  const [ready, setReady] = useState(false)\n  const ctx = getCurrentOrThrow()\n  const loader = ctx.surface?.textureLoader\n  const resolver = asTextureResolver(loader)\n\n  useEffect(() => {\n    if (!loader) {\n      setReady(true)\n      return\n    }\n\n    let cancelled = false\n    loader.loadAtlas(key, imageUrl, dataUrl).then(() => {\n      if (!cancelled) setReady(true)\n    })\n\n    return () => {\n      cancelled = true\n    }\n  }, [key, imageUrl, dataUrl, loader])\n\n  const textureSize = useMemo(\n    () => (ready && resolver ? resolver.getTextureSize(key) : undefined),\n    [ready, resolver, key]\n  )\n  const frameNames = useMemo(\n    () => (ready && resolver ? resolver.getFrameNames(key) : []),\n    [ready, resolver, key]\n  )\n  const frames = useMemo(\n    () =>\n      frameNames\n        .map((frame) => resolver?.getFrameInfo(key, frame))\n        .filter((frame): frame is AtlasFrameInfo => frame !== undefined),\n    [frameNames, resolver, key]\n  )\n  const getFrameInfo = useCallback(\n    (frame: string) => (ready && resolver ? resolver.getFrameInfo(key, frame) : undefined),\n    [ready, resolver, key]\n  )\n  const getFrameRect = useCallback(\n    (frame: string) => (ready && resolver ? resolver.getFrameRect(key, frame) : undefined),\n    [ready, resolver, key]\n  )\n\n  return { ready, key, textureSize, frameNames, frames, getFrameInfo, getFrameRect }\n}\n"],"names":["getGlobalValue","setGlobalValue","ready","setReady","ctx","loader"],"mappings":"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"}