@number10/jsx-phaser 5.0.0

package/dist/effects/use-effect.cjs

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxCore = require("@number10/jsx-core");
+require("phaser");
+require("../hooks.cjs");
+function transformPoint(x, y, scaleX, scaleY, rotation) {
+  const scaledX = x * scaleX;
+  const scaledY = y * scaleY;
+  const cos = Math.cos(rotation);
+  const sin = Math.sin(rotation);
+  return {
+    x: scaledX * cos - scaledY * sin,
+    y: scaledX * sin + scaledY * cos
+  };
+}
+function createPhaserTarget(obj, origin) {
+  const layoutNode = obj;
+  const originX = origin === "center" || origin === "top-center" ? 0.5 : 0;
+  const originY = origin === "center" ? 0.5 : 0;
+  const hasOrigin = originX !== 0 || originY !== 0;
+  const baseScaleX = 1;
+  const baseScaleY = 1;
+  const baseRotation = 0;
+  let refWidth = obj.width;
+  let refHeight = obj.height;
+  let refPivot = null;
+  function ensurePivot() {
+    if (refPivot) return true;
+    if (refWidth === 0) {
+      refWidth = obj.width;
+      refHeight = obj.height;
+    }
+    if (refWidth === 0) return false;
+    const px = refWidth * originX;
+    const py = refHeight * originY;
+    refPivot = transformPoint(px, py, baseScaleX, baseScaleY, baseRotation);
+    return true;
+  }
+  let intendedX = layoutNode.__layoutPosition?.x ?? obj.x;
+  let intendedY = layoutNode.__layoutPosition?.y ?? obj.y;
+  let layoutPositionRevision = layoutNode.__layoutPositionRevision ?? 0;
+  return {
+    onUpdate(values) {
+      if (!obj.active) return;
+      const nextLayoutRevision = layoutNode.__layoutPositionRevision ?? 0;
+      const layoutPositionChanged = nextLayoutRevision !== layoutPositionRevision;
+      if (layoutPositionChanged && layoutNode.__layoutPosition) {
+        intendedX = layoutNode.__layoutPosition.x;
+        intendedY = layoutNode.__layoutPosition.y;
+        layoutPositionRevision = nextLayoutRevision;
+      }
+      if (values.x !== void 0) intendedX = values.x;
+      if (values.y !== void 0) intendedY = values.y;
+      if (!hasOrigin || !ensurePivot()) {
+        if (values.x === void 0 && !layoutPositionChanged) intendedX = obj.x;
+        if (values.y === void 0 && !layoutPositionChanged) intendedY = obj.y;
+        if (values.x !== void 0) obj.x = intendedX;
+        if (values.y !== void 0) obj.y = intendedY;
+        if (values.scaleX !== void 0) obj.scaleX = values.scaleX;
+        if (values.scaleY !== void 0) obj.scaleY = values.scaleY;
+        if (values.rotation !== void 0) obj.rotation = values.rotation;
+        if (values.alpha !== void 0) obj.alpha = values.alpha;
+        return;
+      }
+      const existingPivot = transformPoint(
+        refWidth * originX,
+        refHeight * originY,
+        obj.scaleX,
+        obj.scaleY,
+        obj.rotation
+      );
+      if (values.x === void 0 && !layoutPositionChanged) {
+        intendedX = obj.x - (refPivot.x - existingPivot.x);
+      }
+      if (values.y === void 0 && !layoutPositionChanged) {
+        intendedY = obj.y - (refPivot.y - existingPivot.y);
+      }
+      const currentScaleX = values.scaleX ?? obj.scaleX;
+      const currentScaleY = values.scaleY ?? obj.scaleY;
+      const currentRotation = values.rotation ?? obj.rotation;
+      const curPivot = transformPoint(
+        refWidth * originX,
+        refHeight * originY,
+        currentScaleX,
+        currentScaleY,
+        currentRotation
+      );
+      const dx = refPivot.x - curPivot.x;
+      const dy = refPivot.y - curPivot.y;
+      obj.x = intendedX + dx;
+      obj.y = intendedY + dy;
+      if (values.scaleX !== void 0) obj.scaleX = values.scaleX;
+      if (values.scaleY !== void 0) obj.scaleY = values.scaleY;
+      if (values.rotation !== void 0) obj.rotation = values.rotation;
+      if (values.alpha !== void 0) obj.alpha = values.alpha;
+    },
+    getSnapshot() {
+      return {
+        // Return the logical target position, not the compensated render position.
+        // The engine may feed snapshot values back into later tween/spring frames.
+        // Using rendered x/y here would compound the origin offset on every step.
+        x: intendedX,
+        y: intendedY,
+        scaleX: obj.scaleX,
+        scaleY: obj.scaleY,
+        rotation: obj.rotation,
+        alpha: obj.alpha
+      };
+    },
+    getScheduler() {
+      let current = obj;
+      while (current) {
+        const ctx = current.__surfaceContext;
+        if (ctx?.scheduler) return ctx.scheduler;
+        current = current.parentContainer;
+      }
+      throw new Error("No HostScheduler found in Phaser game object tree");
+    },
+    getSize() {
+      return { width: obj.width, height: obj.height };
+    }
+  };
+}
+function useGameObjectEffect(ref) {
+  const activeHandleRef = jsxCore.useRef(null);
+  const runCoreEffect = (name, config = {}) => {
+    if (!ref.current) return;
+    const def = jsxCore.EFFECT_DEFINITIONS[name];
+    if (!def) return;
+    const origin = jsxCore.resolveEffectTransformOrigin(name);
+    const target = createPhaserTarget(ref.current, origin);
+    const handle = jsxCore.runEffect(ref.current, target, def, config);
+    if (handle) {
+      activeHandleRef.current?.stop();
+      activeHandleRef.current = handle;
+    }
+  };
+  const stopEffects = () => {
+    if (!ref.current) return;
+    activeHandleRef.current?.stop();
+    activeHandleRef.current = null;
+    jsxCore.stopAnimationEffect(ref.current);
+  };
+  jsxCore.useEffect(() => {
+    return () => {
+      activeHandleRef.current?.stop();
+      activeHandleRef.current = null;
+      if (ref.current) jsxCore.stopAnimationEffect(ref.current);
+    };
+  }, []);
+  return { applyEffect: runCoreEffect, stopEffects };
+}
+exports.createPhaserTarget = createPhaserTarget;
+exports.useGameObjectEffect = useGameObjectEffect;
+//# sourceMappingURL=use-effect.cjs.map

package/dist/effects/use-effect.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.cjs","sources":["../../src/effects/use-effect.ts"],"sourcesContent":["/**\n * Phaser effects — connects Core effect engine to Phaser game objects.\n *\n * The Core engine handles all effect definitions, step sequencing, easing,\n * origin calculation, and loop management. Phaser only applies values.\n */\nimport {\n  EFFECT_DEFINITIONS,\n  resolveEffectTransformOrigin,\n  runEffect,\n  stopAnimationEffect as stopEngineEffect,\n  type EffectConfig,\n  type EffectName,\n  type EffectTarget,\n  type EffectTransformOrigin,\n  type HostScheduler,\n} from '@number10/jsx-core'\nimport * as Phaser from 'phaser'\nimport { useEffect, useRef } from '../hooks'\n\n/**\n * Ref object type\n */\ntype RefObject<T> = { current: T }\n\n/**\n * 2D transform point helper used by origin compensation.\n */\nfunction transformPoint(\n  x: number,\n  y: number,\n  scaleX: number,\n  scaleY: number,\n  rotation: number\n): { x: number; y: number } {\n  const scaledX = x * scaleX\n  const scaledY = y * scaleY\n  const cos = Math.cos(rotation)\n  const sin = Math.sin(rotation)\n  return {\n    x: scaledX * cos - scaledY * sin,\n    y: scaledX * sin + scaledY * cos,\n  }\n}\n\n/**\n * Wrap a Phaser game object as an {@link EffectTarget} for the Core effect engine.\n *\n * Handles origin compensation for scale/rotation effects by computing an absolute\n * pivot offset from a frozen reference state.\n *\n * @param obj - The Phaser game object to wrap\n * @param origin - Optional transform origin for position compensation\n */\nexport function createPhaserTarget(\n  obj: Phaser.GameObjects.Container,\n  origin?: EffectTransformOrigin\n): EffectTarget {\n  const layoutNode = obj as Phaser.GameObjects.Container & {\n    __layoutPosition?: { x: number; y: number }\n    __layoutPositionRevision?: number\n  }\n  const originX = origin === 'center' || origin === 'top-center' ? 0.5 : 0\n  const originY = origin === 'center' ? 0.5 : 0\n  const hasOrigin = originX !== 0 || originY !== 0\n\n  // Reference state: always use neutral scale/rotation for the pivot.\n  // The engine communicates the actual animated values via onUpdate.\n  // Using the current (potentially mid-animation) scale would compute\n  // a wrong reference pivot, causing permanent position drift when\n  // effects are rapidly retriggered.\n  const baseScaleX = 1\n  const baseScaleY = 1\n  const baseRotation = 0\n\n  // Capture size once; lazily re-check if not yet laid out\n  let refWidth = obj.width\n  let refHeight = obj.height\n  let refPivot: { x: number; y: number } | null = null\n\n  function ensurePivot(): boolean {\n    if (refPivot) return true\n    if (refWidth === 0) {\n      refWidth = obj.width\n      refHeight = obj.height\n    }\n    if (refWidth === 0) return false\n    const px = refWidth * originX\n    const py = refHeight * originY\n    refPivot = transformPoint(px, py, baseScaleX, baseScaleY, baseRotation)\n    return true\n  }\n\n  let intendedX = layoutNode.__layoutPosition?.x ?? obj.x\n  let intendedY = layoutNode.__layoutPosition?.y ?? obj.y\n  let layoutPositionRevision = layoutNode.__layoutPositionRevision ?? 0\n\n  return {\n    onUpdate(values) {\n      if (!obj.active) return\n\n      const nextLayoutRevision = layoutNode.__layoutPositionRevision ?? 0\n      const layoutPositionChanged = nextLayoutRevision !== layoutPositionRevision\n      if (layoutPositionChanged && layoutNode.__layoutPosition) {\n        intendedX = layoutNode.__layoutPosition.x\n        intendedY = layoutNode.__layoutPosition.y\n        layoutPositionRevision = nextLayoutRevision\n      }\n\n      if (values.x !== undefined) intendedX = values.x\n      if (values.y !== undefined) intendedY = values.y\n\n      if (!hasOrigin || !ensurePivot()) {\n        if (values.x === undefined && !layoutPositionChanged) intendedX = obj.x\n        if (values.y === undefined && !layoutPositionChanged) intendedY = obj.y\n        if (values.x !== undefined) obj.x = intendedX\n        if (values.y !== undefined) obj.y = intendedY\n        if (values.scaleX !== undefined) obj.scaleX = values.scaleX\n        if (values.scaleY !== undefined) obj.scaleY = values.scaleY\n        if (values.rotation !== undefined) obj.rotation = values.rotation\n        if (values.alpha !== undefined) obj.alpha = values.alpha\n        return\n      }\n\n      const existingPivot = transformPoint(\n        refWidth * originX,\n        refHeight * originY,\n        obj.scaleX,\n        obj.scaleY,\n        obj.rotation\n      )\n      if (values.x === undefined && !layoutPositionChanged) {\n        intendedX = obj.x - ((refPivot as { x: number; y: number }).x - existingPivot.x)\n      }\n      if (values.y === undefined && !layoutPositionChanged) {\n        intendedY = obj.y - ((refPivot as { x: number; y: number }).y - existingPivot.y)\n      }\n\n      const currentScaleX = values.scaleX ?? obj.scaleX\n      const currentScaleY = values.scaleY ?? obj.scaleY\n      const currentRotation = values.rotation ?? obj.rotation\n\n      const curPivot = transformPoint(\n        refWidth * originX,\n        refHeight * originY,\n        currentScaleX,\n        currentScaleY,\n        currentRotation\n      )\n\n      const dx = (refPivot as { x: number; y: number }).x - curPivot.x\n      const dy = (refPivot as { x: number; y: number }).y - curPivot.y\n\n      obj.x = intendedX + dx\n      obj.y = intendedY + dy\n      if (values.scaleX !== undefined) obj.scaleX = values.scaleX\n      if (values.scaleY !== undefined) obj.scaleY = values.scaleY\n      if (values.rotation !== undefined) obj.rotation = values.rotation\n      if (values.alpha !== undefined) obj.alpha = values.alpha\n    },\n\n    getSnapshot() {\n      return {\n        // Return the logical target position, not the compensated render position.\n        // The engine may feed snapshot values back into later tween/spring frames.\n        // Using rendered x/y here would compound the origin offset on every step.\n        x: intendedX,\n        y: intendedY,\n        scaleX: obj.scaleX,\n        scaleY: obj.scaleY,\n        rotation: obj.rotation,\n        alpha: obj.alpha,\n      }\n    },\n\n    getScheduler() {\n      let current: Phaser.GameObjects.Container | null = obj\n      while (current) {\n        const ctx = (current as unknown as Record<string, unknown>).__surfaceContext as\n          | { scheduler?: HostScheduler }\n          | undefined\n        if (ctx?.scheduler) return ctx.scheduler\n        current = current.parentContainer\n      }\n      throw new Error('No HostScheduler found in Phaser game object tree')\n    },\n\n    getSize() {\n      return { width: obj.width, height: obj.height }\n    },\n  }\n}\n\n/**\n * Hook for applying effects to game objects via the central Core engine.\n *\n * @param ref - RefObject pointing to a Phaser game object\n * @returns { applyEffect, stopEffects }\n */\nexport function useGameObjectEffect(ref: RefObject<Phaser.GameObjects.Container | null>) {\n  const activeHandleRef = useRef<ReturnType<typeof runEffect> | null>(null)\n\n  /**\n   * Apply an effect by name to the game object.\n   * @param name - Effect name (e.g. 'pulse', 'fadeIn')\n   * @param config - Optional effect configuration\n   */\n  const runCoreEffect = (name: EffectName, config: EffectConfig = {}) => {\n    if (!ref.current) return\n\n    // Do NOT stop the previous handle here — runEffect handles state\n    // transitions internally, preserving the original base position.\n    // Calling stop() here would delete the effect state, causing\n    // runEffect to snapshot the current (animated) position as the\n    // new base, leading to permanent position drift on rapid clicks.\n\n    const def = EFFECT_DEFINITIONS[name]\n    if (!def) return\n\n    const origin = resolveEffectTransformOrigin(name)\n    const target = createPhaserTarget(ref.current, origin)\n    const handle = runEffect(ref.current, target, def, config)\n    if (handle) {\n      activeHandleRef.current?.stop()\n      activeHandleRef.current = handle\n    }\n  }\n\n  /**\n   * Stop all active effects on the game object.\n   */\n  const stopEffects = () => {\n    if (!ref.current) return\n    activeHandleRef.current?.stop()\n    activeHandleRef.current = null\n    stopEngineEffect(ref.current)\n  }\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      activeHandleRef.current?.stop()\n      activeHandleRef.current = null\n      if (ref.current) stopEngineEffect(ref.current)\n    }\n  }, [])\n\n  return { applyEffect: runCoreEffect, stopEffects }\n}\n"],"names":["useRef","EFFECT_DEFINITIONS","resolveEffectTransformOrigin","runEffect","stopEngineEffect","useEffect"],"mappings":"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"}

package/dist/effects/use-effect.d.ts

@@ -0,0 +1,30 @@
+import { EffectConfig, EffectName, EffectTarget, EffectTransformOrigin } from '@number10/jsx-core';
+import * as Phaser from 'phaser';
+/**
+ * Ref object type
+ */
+type RefObject<T> = {
+    current: T;
+};
+/**
+ * Wrap a Phaser game object as an {@link EffectTarget} for the Core effect engine.
+ *
+ * Handles origin compensation for scale/rotation effects by computing an absolute
+ * pivot offset from a frozen reference state.
+ *
+ * @param obj - The Phaser game object to wrap
+ * @param origin - Optional transform origin for position compensation
+ */
+export declare function createPhaserTarget(obj: Phaser.GameObjects.Container, origin?: EffectTransformOrigin): EffectTarget;
+/**
+ * Hook for applying effects to game objects via the central Core engine.
+ *
+ * @param ref - RefObject pointing to a Phaser game object
+ * @returns { applyEffect, stopEffects }
+ */
+export declare function useGameObjectEffect(ref: RefObject<Phaser.GameObjects.Container | null>): {
+    applyEffect: (name: EffectName, config?: EffectConfig) => void;
+    stopEffects: () => void;
+};
+export {};
+//# sourceMappingURL=use-effect.d.ts.map

package/dist/effects/use-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.d.ts","sourceRoot":"","sources":["../../src/effects/use-effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAE3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAGhC;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAA;AAsBlC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EACjC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,YAAY,CAsId;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC;wBAQxD,UAAU,WAAU,YAAY;;EAyC9D"}

package/dist/effects/use-effect.js

@@ -0,0 +1,155 @@
+import { useRef, useEffect, stopAnimationEffect, EFFECT_DEFINITIONS, resolveEffectTransformOrigin, runEffect } from "@number10/jsx-core";
+import "phaser";
+import "../hooks.js";
+function transformPoint(x, y, scaleX, scaleY, rotation) {
+  const scaledX = x * scaleX;
+  const scaledY = y * scaleY;
+  const cos = Math.cos(rotation);
+  const sin = Math.sin(rotation);
+  return {
+    x: scaledX * cos - scaledY * sin,
+    y: scaledX * sin + scaledY * cos
+  };
+}
+function createPhaserTarget(obj, origin) {
+  const layoutNode = obj;
+  const originX = origin === "center" || origin === "top-center" ? 0.5 : 0;
+  const originY = origin === "center" ? 0.5 : 0;
+  const hasOrigin = originX !== 0 || originY !== 0;
+  const baseScaleX = 1;
+  const baseScaleY = 1;
+  const baseRotation = 0;
+  let refWidth = obj.width;
+  let refHeight = obj.height;
+  let refPivot = null;
+  function ensurePivot() {
+    if (refPivot) return true;
+    if (refWidth === 0) {
+      refWidth = obj.width;
+      refHeight = obj.height;
+    }
+    if (refWidth === 0) return false;
+    const px = refWidth * originX;
+    const py = refHeight * originY;
+    refPivot = transformPoint(px, py, baseScaleX, baseScaleY, baseRotation);
+    return true;
+  }
+  let intendedX = layoutNode.__layoutPosition?.x ?? obj.x;
+  let intendedY = layoutNode.__layoutPosition?.y ?? obj.y;
+  let layoutPositionRevision = layoutNode.__layoutPositionRevision ?? 0;
+  return {
+    onUpdate(values) {
+      if (!obj.active) return;
+      const nextLayoutRevision = layoutNode.__layoutPositionRevision ?? 0;
+      const layoutPositionChanged = nextLayoutRevision !== layoutPositionRevision;
+      if (layoutPositionChanged && layoutNode.__layoutPosition) {
+        intendedX = layoutNode.__layoutPosition.x;
+        intendedY = layoutNode.__layoutPosition.y;
+        layoutPositionRevision = nextLayoutRevision;
+      }
+      if (values.x !== void 0) intendedX = values.x;
+      if (values.y !== void 0) intendedY = values.y;
+      if (!hasOrigin || !ensurePivot()) {
+        if (values.x === void 0 && !layoutPositionChanged) intendedX = obj.x;
+        if (values.y === void 0 && !layoutPositionChanged) intendedY = obj.y;
+        if (values.x !== void 0) obj.x = intendedX;
+        if (values.y !== void 0) obj.y = intendedY;
+        if (values.scaleX !== void 0) obj.scaleX = values.scaleX;
+        if (values.scaleY !== void 0) obj.scaleY = values.scaleY;
+        if (values.rotation !== void 0) obj.rotation = values.rotation;
+        if (values.alpha !== void 0) obj.alpha = values.alpha;
+        return;
+      }
+      const existingPivot = transformPoint(
+        refWidth * originX,
+        refHeight * originY,
+        obj.scaleX,
+        obj.scaleY,
+        obj.rotation
+      );
+      if (values.x === void 0 && !layoutPositionChanged) {
+        intendedX = obj.x - (refPivot.x - existingPivot.x);
+      }
+      if (values.y === void 0 && !layoutPositionChanged) {
+        intendedY = obj.y - (refPivot.y - existingPivot.y);
+      }
+      const currentScaleX = values.scaleX ?? obj.scaleX;
+      const currentScaleY = values.scaleY ?? obj.scaleY;
+      const currentRotation = values.rotation ?? obj.rotation;
+      const curPivot = transformPoint(
+        refWidth * originX,
+        refHeight * originY,
+        currentScaleX,
+        currentScaleY,
+        currentRotation
+      );
+      const dx = refPivot.x - curPivot.x;
+      const dy = refPivot.y - curPivot.y;
+      obj.x = intendedX + dx;
+      obj.y = intendedY + dy;
+      if (values.scaleX !== void 0) obj.scaleX = values.scaleX;
+      if (values.scaleY !== void 0) obj.scaleY = values.scaleY;
+      if (values.rotation !== void 0) obj.rotation = values.rotation;
+      if (values.alpha !== void 0) obj.alpha = values.alpha;
+    },
+    getSnapshot() {
+      return {
+        // Return the logical target position, not the compensated render position.
+        // The engine may feed snapshot values back into later tween/spring frames.
+        // Using rendered x/y here would compound the origin offset on every step.
+        x: intendedX,
+        y: intendedY,
+        scaleX: obj.scaleX,
+        scaleY: obj.scaleY,
+        rotation: obj.rotation,
+        alpha: obj.alpha
+      };
+    },
+    getScheduler() {
+      let current = obj;
+      while (current) {
+        const ctx = current.__surfaceContext;
+        if (ctx?.scheduler) return ctx.scheduler;
+        current = current.parentContainer;
+      }
+      throw new Error("No HostScheduler found in Phaser game object tree");
+    },
+    getSize() {
+      return { width: obj.width, height: obj.height };
+    }
+  };
+}
+function useGameObjectEffect(ref) {
+  const activeHandleRef = useRef(null);
+  const runCoreEffect = (name, config = {}) => {
+    if (!ref.current) return;
+    const def = EFFECT_DEFINITIONS[name];
+    if (!def) return;
+    const origin = resolveEffectTransformOrigin(name);
+    const target = createPhaserTarget(ref.current, origin);
+    const handle = runEffect(ref.current, target, def, config);
+    if (handle) {
+      activeHandleRef.current?.stop();
+      activeHandleRef.current = handle;
+    }
+  };
+  const stopEffects = () => {
+    if (!ref.current) return;
+    activeHandleRef.current?.stop();
+    activeHandleRef.current = null;
+    stopAnimationEffect(ref.current);
+  };
+  useEffect(() => {
+    return () => {
+      activeHandleRef.current?.stop();
+      activeHandleRef.current = null;
+      if (ref.current) stopAnimationEffect(ref.current);
+    };
+  }, []);
+  return { applyEffect: runCoreEffect, stopEffects };
+}
+export {
+  createPhaserTarget,
+  useGameObjectEffect
+};
+//# sourceMappingURL=use-effect.js.map

package/dist/effects/use-effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.js","sources":["../../src/effects/use-effect.ts"],"sourcesContent":["/**\n * Phaser effects — connects Core effect engine to Phaser game objects.\n *\n * The Core engine handles all effect definitions, step sequencing, easing,\n * origin calculation, and loop management. Phaser only applies values.\n */\nimport {\n  EFFECT_DEFINITIONS,\n  resolveEffectTransformOrigin,\n  runEffect,\n  stopAnimationEffect as stopEngineEffect,\n  type EffectConfig,\n  type EffectName,\n  type EffectTarget,\n  type EffectTransformOrigin,\n  type HostScheduler,\n} from '@number10/jsx-core'\nimport * as Phaser from 'phaser'\nimport { useEffect, useRef } from '../hooks'\n\n/**\n * Ref object type\n */\ntype RefObject<T> = { current: T }\n\n/**\n * 2D transform point helper used by origin compensation.\n */\nfunction transformPoint(\n  x: number,\n  y: number,\n  scaleX: number,\n  scaleY: number,\n  rotation: number\n): { x: number; y: number } {\n  const scaledX = x * scaleX\n  const scaledY = y * scaleY\n  const cos = Math.cos(rotation)\n  const sin = Math.sin(rotation)\n  return {\n    x: scaledX * cos - scaledY * sin,\n    y: scaledX * sin + scaledY * cos,\n  }\n}\n\n/**\n * Wrap a Phaser game object as an {@link EffectTarget} for the Core effect engine.\n *\n * Handles origin compensation for scale/rotation effects by computing an absolute\n * pivot offset from a frozen reference state.\n *\n * @param obj - The Phaser game object to wrap\n * @param origin - Optional transform origin for position compensation\n */\nexport function createPhaserTarget(\n  obj: Phaser.GameObjects.Container,\n  origin?: EffectTransformOrigin\n): EffectTarget {\n  const layoutNode = obj as Phaser.GameObjects.Container & {\n    __layoutPosition?: { x: number; y: number }\n    __layoutPositionRevision?: number\n  }\n  const originX = origin === 'center' || origin === 'top-center' ? 0.5 : 0\n  const originY = origin === 'center' ? 0.5 : 0\n  const hasOrigin = originX !== 0 || originY !== 0\n\n  // Reference state: always use neutral scale/rotation for the pivot.\n  // The engine communicates the actual animated values via onUpdate.\n  // Using the current (potentially mid-animation) scale would compute\n  // a wrong reference pivot, causing permanent position drift when\n  // effects are rapidly retriggered.\n  const baseScaleX = 1\n  const baseScaleY = 1\n  const baseRotation = 0\n\n  // Capture size once; lazily re-check if not yet laid out\n  let refWidth = obj.width\n  let refHeight = obj.height\n  let refPivot: { x: number; y: number } | null = null\n\n  function ensurePivot(): boolean {\n    if (refPivot) return true\n    if (refWidth === 0) {\n      refWidth = obj.width\n      refHeight = obj.height\n    }\n    if (refWidth === 0) return false\n    const px = refWidth * originX\n    const py = refHeight * originY\n    refPivot = transformPoint(px, py, baseScaleX, baseScaleY, baseRotation)\n    return true\n  }\n\n  let intendedX = layoutNode.__layoutPosition?.x ?? obj.x\n  let intendedY = layoutNode.__layoutPosition?.y ?? obj.y\n  let layoutPositionRevision = layoutNode.__layoutPositionRevision ?? 0\n\n  return {\n    onUpdate(values) {\n      if (!obj.active) return\n\n      const nextLayoutRevision = layoutNode.__layoutPositionRevision ?? 0\n      const layoutPositionChanged = nextLayoutRevision !== layoutPositionRevision\n      if (layoutPositionChanged && layoutNode.__layoutPosition) {\n        intendedX = layoutNode.__layoutPosition.x\n        intendedY = layoutNode.__layoutPosition.y\n        layoutPositionRevision = nextLayoutRevision\n      }\n\n      if (values.x !== undefined) intendedX = values.x\n      if (values.y !== undefined) intendedY = values.y\n\n      if (!hasOrigin || !ensurePivot()) {\n        if (values.x === undefined && !layoutPositionChanged) intendedX = obj.x\n        if (values.y === undefined && !layoutPositionChanged) intendedY = obj.y\n        if (values.x !== undefined) obj.x = intendedX\n        if (values.y !== undefined) obj.y = intendedY\n        if (values.scaleX !== undefined) obj.scaleX = values.scaleX\n        if (values.scaleY !== undefined) obj.scaleY = values.scaleY\n        if (values.rotation !== undefined) obj.rotation = values.rotation\n        if (values.alpha !== undefined) obj.alpha = values.alpha\n        return\n      }\n\n      const existingPivot = transformPoint(\n        refWidth * originX,\n        refHeight * originY,\n        obj.scaleX,\n        obj.scaleY,\n        obj.rotation\n      )\n      if (values.x === undefined && !layoutPositionChanged) {\n        intendedX = obj.x - ((refPivot as { x: number; y: number }).x - existingPivot.x)\n      }\n      if (values.y === undefined && !layoutPositionChanged) {\n        intendedY = obj.y - ((refPivot as { x: number; y: number }).y - existingPivot.y)\n      }\n\n      const currentScaleX = values.scaleX ?? obj.scaleX\n      const currentScaleY = values.scaleY ?? obj.scaleY\n      const currentRotation = values.rotation ?? obj.rotation\n\n      const curPivot = transformPoint(\n        refWidth * originX,\n        refHeight * originY,\n        currentScaleX,\n        currentScaleY,\n        currentRotation\n      )\n\n      const dx = (refPivot as { x: number; y: number }).x - curPivot.x\n      const dy = (refPivot as { x: number; y: number }).y - curPivot.y\n\n      obj.x = intendedX + dx\n      obj.y = intendedY + dy\n      if (values.scaleX !== undefined) obj.scaleX = values.scaleX\n      if (values.scaleY !== undefined) obj.scaleY = values.scaleY\n      if (values.rotation !== undefined) obj.rotation = values.rotation\n      if (values.alpha !== undefined) obj.alpha = values.alpha\n    },\n\n    getSnapshot() {\n      return {\n        // Return the logical target position, not the compensated render position.\n        // The engine may feed snapshot values back into later tween/spring frames.\n        // Using rendered x/y here would compound the origin offset on every step.\n        x: intendedX,\n        y: intendedY,\n        scaleX: obj.scaleX,\n        scaleY: obj.scaleY,\n        rotation: obj.rotation,\n        alpha: obj.alpha,\n      }\n    },\n\n    getScheduler() {\n      let current: Phaser.GameObjects.Container | null = obj\n      while (current) {\n        const ctx = (current as unknown as Record<string, unknown>).__surfaceContext as\n          | { scheduler?: HostScheduler }\n          | undefined\n        if (ctx?.scheduler) return ctx.scheduler\n        current = current.parentContainer\n      }\n      throw new Error('No HostScheduler found in Phaser game object tree')\n    },\n\n    getSize() {\n      return { width: obj.width, height: obj.height }\n    },\n  }\n}\n\n/**\n * Hook for applying effects to game objects via the central Core engine.\n *\n * @param ref - RefObject pointing to a Phaser game object\n * @returns { applyEffect, stopEffects }\n */\nexport function useGameObjectEffect(ref: RefObject<Phaser.GameObjects.Container | null>) {\n  const activeHandleRef = useRef<ReturnType<typeof runEffect> | null>(null)\n\n  /**\n   * Apply an effect by name to the game object.\n   * @param name - Effect name (e.g. 'pulse', 'fadeIn')\n   * @param config - Optional effect configuration\n   */\n  const runCoreEffect = (name: EffectName, config: EffectConfig = {}) => {\n    if (!ref.current) return\n\n    // Do NOT stop the previous handle here — runEffect handles state\n    // transitions internally, preserving the original base position.\n    // Calling stop() here would delete the effect state, causing\n    // runEffect to snapshot the current (animated) position as the\n    // new base, leading to permanent position drift on rapid clicks.\n\n    const def = EFFECT_DEFINITIONS[name]\n    if (!def) return\n\n    const origin = resolveEffectTransformOrigin(name)\n    const target = createPhaserTarget(ref.current, origin)\n    const handle = runEffect(ref.current, target, def, config)\n    if (handle) {\n      activeHandleRef.current?.stop()\n      activeHandleRef.current = handle\n    }\n  }\n\n  /**\n   * Stop all active effects on the game object.\n   */\n  const stopEffects = () => {\n    if (!ref.current) return\n    activeHandleRef.current?.stop()\n    activeHandleRef.current = null\n    stopEngineEffect(ref.current)\n  }\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      activeHandleRef.current?.stop()\n      activeHandleRef.current = null\n      if (ref.current) stopEngineEffect(ref.current)\n    }\n  }, [])\n\n  return { applyEffect: runCoreEffect, stopEffects }\n}\n"],"names":["stopEngineEffect"],"mappings":"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"}

package/dist/fx/convenience-hooks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convenience Hooks - Automatic FX application
+ */
+export { useBlur } from './use-blur';
+export { useGlow } from './use-glow';
+export { useShadow } from './use-shadow';
+//# sourceMappingURL=index.d.ts.map

package/dist/fx/convenience-hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fx/convenience-hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/fx/convenience-hooks/use-blur.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../hooks.cjs");
+const blur = require("../fx-creators/blur.cjs");
+const useFx = require("../use-fx.cjs");
+const jsxCore = require("@number10/jsx-core");
+function useBlur(ref, config = {}) {
+  const { applyFX, clearFX } = useFx.useFX(ref);
+  jsxCore.useEffect(() => {
+    if (!ref.current) return;
+    clearFX();
+    applyFX(blur.createBlurFX, config);
+    return () => clearFX();
+  }, [ref, config, applyFX, clearFX]);
+  return { clearFX };
+}
+exports.useBlur = useBlur;
+//# sourceMappingURL=use-blur.cjs.map

package/dist/fx/convenience-hooks/use-blur.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-blur.cjs","sources":["../../../src/fx/convenience-hooks/use-blur.ts"],"sourcesContent":["/**\n * Convenience hook for automatic blur FX\n * Applies blur on mount and updates on config changes\n */\nimport { useEffect } from '../../hooks'\nimport { createBlurFX, type BlurFXConfig } from '../fx-creators/blur'\nimport { useFX } from '../use-fx'\n\n/**\n * Hook for automatic blur FX\n * @param ref - GameObject ref\n * @param config - Blur config (updates reactively)\n * @returns FX controls\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * useBlur(ref, { strength: 8, steps: 4 })\n *\n * return <View ref={ref}>Content</View>\n * ```\n */\nexport function useBlur(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ref: { current: any },\n  config: BlurFXConfig = {}\n): { clearFX: () => void } {\n  const { applyFX, clearFX } = useFX(ref)\n\n  useEffect(() => {\n    if (!ref.current) return\n\n    // Clear previous FX\n    clearFX()\n\n    // Apply new blur\n    applyFX(createBlurFX, config)\n\n    return () => clearFX()\n  }, [ref, config, applyFX, clearFX])\n\n  return { clearFX }\n}\n"],"names":["useFX","useEffect","createBlurFX"],"mappings":";;;;;;AAsBO,SAAS,QAEd,KACA,SAAuB,IACE;AACzB,QAAM,EAAE,SAAS,YAAYA,MAAAA,MAAM,GAAG;AAEtCC,UAAAA,UAAU,MAAM;AACd,QAAI,CAAC,IAAI,QAAS;AAGlB,YAAA;AAGA,YAAQC,KAAAA,cAAc,MAAM;AAE5B,WAAO,MAAM,QAAA;AAAA,EACf,GAAG,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;AAElC,SAAO,EAAE,QAAA;AACX;;"}

package/dist/fx/convenience-hooks/use-blur.d.ts

@@ -0,0 +1,21 @@
+import { BlurFXConfig } from '../fx-creators/blur';
+/**
+ * Hook for automatic blur FX
+ * @param ref - GameObject ref
+ * @param config - Blur config (updates reactively)
+ * @returns FX controls
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef(null)
+ * useBlur(ref, { strength: 8, steps: 4 })
+ *
+ * return <View ref={ref}>Content</View>
+ * ```
+ */
+export declare function useBlur(ref: {
+    current: any;
+}, config?: BlurFXConfig): {
+    clearFX: () => void;
+};
+//# sourceMappingURL=use-blur.d.ts.map

package/dist/fx/convenience-hooks/use-blur.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-blur.d.ts","sourceRoot":"","sources":["../../../src/fx/convenience-hooks/use-blur.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGrE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAErB,GAAG,EAAE;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,EACrB,MAAM,GAAE,YAAiB,GACxB;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAgBzB"}

package/dist/fx/convenience-hooks/use-blur.js

@@ -0,0 +1,18 @@
+import "../../hooks.js";
+import { createBlurFX } from "../fx-creators/blur.js";
+import { useFX } from "../use-fx.js";
+import { useEffect } from "@number10/jsx-core";
+function useBlur(ref, config = {}) {
+  const { applyFX, clearFX } = useFX(ref);
+  useEffect(() => {
+    if (!ref.current) return;
+    clearFX();
+    applyFX(createBlurFX, config);
+    return () => clearFX();
+  }, [ref, config, applyFX, clearFX]);
+  return { clearFX };
+}
+export {
+  useBlur
+};
+//# sourceMappingURL=use-blur.js.map

package/dist/fx/convenience-hooks/use-blur.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-blur.js","sources":["../../../src/fx/convenience-hooks/use-blur.ts"],"sourcesContent":["/**\n * Convenience hook for automatic blur FX\n * Applies blur on mount and updates on config changes\n */\nimport { useEffect } from '../../hooks'\nimport { createBlurFX, type BlurFXConfig } from '../fx-creators/blur'\nimport { useFX } from '../use-fx'\n\n/**\n * Hook for automatic blur FX\n * @param ref - GameObject ref\n * @param config - Blur config (updates reactively)\n * @returns FX controls\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * useBlur(ref, { strength: 8, steps: 4 })\n *\n * return <View ref={ref}>Content</View>\n * ```\n */\nexport function useBlur(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ref: { current: any },\n  config: BlurFXConfig = {}\n): { clearFX: () => void } {\n  const { applyFX, clearFX } = useFX(ref)\n\n  useEffect(() => {\n    if (!ref.current) return\n\n    // Clear previous FX\n    clearFX()\n\n    // Apply new blur\n    applyFX(createBlurFX, config)\n\n    return () => clearFX()\n  }, [ref, config, applyFX, clearFX])\n\n  return { clearFX }\n}\n"],"names":[],"mappings":";;;;AAsBO,SAAS,QAEd,KACA,SAAuB,IACE;AACzB,QAAM,EAAE,SAAS,YAAY,MAAM,GAAG;AAEtC,YAAU,MAAM;AACd,QAAI,CAAC,IAAI,QAAS;AAGlB,YAAA;AAGA,YAAQ,cAAc,MAAM;AAE5B,WAAO,MAAM,QAAA;AAAA,EACf,GAAG,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;AAElC,SAAO,EAAE,QAAA;AACX;"}

package/dist/fx/convenience-hooks/use-glow.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../hooks.cjs");
+const glow = require("../fx-creators/glow.cjs");
+const useFx = require("../use-fx.cjs");
+const jsxCore = require("@number10/jsx-core");
+function useGlow(ref, config = {}) {
+  const { applyFX, clearFX } = useFx.useFX(ref);
+  jsxCore.useEffect(() => {
+    if (!ref.current) return;
+    clearFX();
+    applyFX(glow.createGlowFX, config);
+    return () => clearFX();
+  }, [ref, config, applyFX, clearFX]);
+  return { clearFX };
+}
+exports.useGlow = useGlow;
+//# sourceMappingURL=use-glow.cjs.map

package/dist/fx/convenience-hooks/use-glow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-glow.cjs","sources":["../../../src/fx/convenience-hooks/use-glow.ts"],"sourcesContent":["/**\n * Convenience hook for automatic glow FX\n * Applies glow on mount and updates on config changes\n */\nimport { useEffect } from '../../hooks'\nimport { createGlowFX, type GlowFXConfig } from '../fx-creators/glow'\nimport { useFX } from '../use-fx'\n\n/**\n * Hook for automatic glow FX\n * @param ref - GameObject ref\n * @param config - Glow config (updates reactively)\n * @returns FX controls\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * useGlow(ref, { color: 0xff6600, outerStrength: 6, innerStrength: 2 })\n *\n * return <View ref={ref}>Content</View>\n * ```\n */\nexport function useGlow(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ref: { current: any },\n  config: GlowFXConfig = {}\n): { clearFX: () => void } {\n  const { applyFX, clearFX } = useFX(ref)\n\n  useEffect(() => {\n    if (!ref.current) return\n\n    // Clear previous FX\n    clearFX()\n\n    // Apply new glow\n    applyFX(createGlowFX, config)\n\n    return () => clearFX()\n  }, [ref, config, applyFX, clearFX])\n\n  return { clearFX }\n}\n"],"names":["useFX","useEffect","createGlowFX"],"mappings":";;;;;;AAsBO,SAAS,QAEd,KACA,SAAuB,IACE;AACzB,QAAM,EAAE,SAAS,YAAYA,MAAAA,MAAM,GAAG;AAEtCC,UAAAA,UAAU,MAAM;AACd,QAAI,CAAC,IAAI,QAAS;AAGlB,YAAA;AAGA,YAAQC,KAAAA,cAAc,MAAM;AAE5B,WAAO,MAAM,QAAA;AAAA,EACf,GAAG,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;AAElC,SAAO,EAAE,QAAA;AACX;;"}

package/dist/fx/convenience-hooks/use-glow.d.ts

@@ -0,0 +1,21 @@
+import { GlowFXConfig } from '../fx-creators/glow';
+/**
+ * Hook for automatic glow FX
+ * @param ref - GameObject ref
+ * @param config - Glow config (updates reactively)
+ * @returns FX controls
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef(null)
+ * useGlow(ref, { color: 0xff6600, outerStrength: 6, innerStrength: 2 })
+ *
+ * return <View ref={ref}>Content</View>
+ * ```
+ */
+export declare function useGlow(ref: {
+    current: any;
+}, config?: GlowFXConfig): {
+    clearFX: () => void;
+};
+//# sourceMappingURL=use-glow.d.ts.map

package/dist/fx/convenience-hooks/use-glow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-glow.d.ts","sourceRoot":"","sources":["../../../src/fx/convenience-hooks/use-glow.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGrE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAErB,GAAG,EAAE;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,EACrB,MAAM,GAAE,YAAiB,GACxB;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAgBzB"}

package/dist/fx/convenience-hooks/use-glow.js

@@ -0,0 +1,18 @@
+import "../../hooks.js";
+import { createGlowFX } from "../fx-creators/glow.js";
+import { useFX } from "../use-fx.js";
+import { useEffect } from "@number10/jsx-core";
+function useGlow(ref, config = {}) {
+  const { applyFX, clearFX } = useFX(ref);
+  useEffect(() => {
+    if (!ref.current) return;
+    clearFX();
+    applyFX(createGlowFX, config);
+    return () => clearFX();
+  }, [ref, config, applyFX, clearFX]);
+  return { clearFX };
+}
+export {
+  useGlow
+};
+//# sourceMappingURL=use-glow.js.map

package/dist/fx/convenience-hooks/use-glow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-glow.js","sources":["../../../src/fx/convenience-hooks/use-glow.ts"],"sourcesContent":["/**\n * Convenience hook for automatic glow FX\n * Applies glow on mount and updates on config changes\n */\nimport { useEffect } from '../../hooks'\nimport { createGlowFX, type GlowFXConfig } from '../fx-creators/glow'\nimport { useFX } from '../use-fx'\n\n/**\n * Hook for automatic glow FX\n * @param ref - GameObject ref\n * @param config - Glow config (updates reactively)\n * @returns FX controls\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * useGlow(ref, { color: 0xff6600, outerStrength: 6, innerStrength: 2 })\n *\n * return <View ref={ref}>Content</View>\n * ```\n */\nexport function useGlow(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ref: { current: any },\n  config: GlowFXConfig = {}\n): { clearFX: () => void } {\n  const { applyFX, clearFX } = useFX(ref)\n\n  useEffect(() => {\n    if (!ref.current) return\n\n    // Clear previous FX\n    clearFX()\n\n    // Apply new glow\n    applyFX(createGlowFX, config)\n\n    return () => clearFX()\n  }, [ref, config, applyFX, clearFX])\n\n  return { clearFX }\n}\n"],"names":[],"mappings":";;;;AAsBO,SAAS,QAEd,KACA,SAAuB,IACE;AACzB,QAAM,EAAE,SAAS,YAAY,MAAM,GAAG;AAEtC,YAAU,MAAM;AACd,QAAI,CAAC,IAAI,QAAS;AAGlB,YAAA;AAGA,YAAQ,cAAc,MAAM;AAE5B,WAAO,MAAM,QAAA;AAAA,EACf,GAAG,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;AAElC,SAAO,EAAE,QAAA;AACX;"}

package/dist/fx/convenience-hooks/use-shadow.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../hooks.cjs");
+const shadow = require("../fx-creators/shadow.cjs");
+const useFx = require("../use-fx.cjs");
+const jsxCore = require("@number10/jsx-core");
+function useShadow(ref, config = {}) {
+  const { applyFX, clearFX } = useFx.useFX(ref);
+  jsxCore.useEffect(() => {
+    if (!ref.current) return;
+    clearFX();
+    applyFX(shadow.createShadowFX, config);
+    return () => clearFX();
+  }, [ref, config, applyFX, clearFX]);
+  return { clearFX };
+}
+exports.useShadow = useShadow;
+//# sourceMappingURL=use-shadow.cjs.map

package/dist/fx/convenience-hooks/use-shadow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-shadow.cjs","sources":["../../../src/fx/convenience-hooks/use-shadow.ts"],"sourcesContent":["/**\n * Convenience hook for automatic shadow FX\n * Applies shadow on mount and updates on config changes\n */\nimport { useEffect } from '../../hooks'\nimport { createShadowFX, type ShadowFXConfig } from '../fx-creators/shadow'\nimport { useFX } from '../use-fx'\n\n/**\n * Hook for automatic shadow FX\n * @param ref - GameObject ref\n * @param config - Shadow config (updates reactively)\n * @returns FX controls\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * useShadow(ref, { x: 4, y: 4, decay: 0.1 })\n *\n * return <View ref={ref}>Content</View>\n * ```\n */\nexport function useShadow(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ref: { current: any },\n  config: ShadowFXConfig = {}\n): { clearFX: () => void } {\n  const { applyFX, clearFX } = useFX(ref)\n\n  useEffect(() => {\n    if (!ref.current) return\n\n    // Clear previous FX\n    clearFX()\n\n    // Apply new shadow\n    applyFX(createShadowFX, config)\n\n    return () => clearFX()\n  }, [ref, config, applyFX, clearFX])\n\n  return { clearFX }\n}\n"],"names":["useFX","useEffect","createShadowFX"],"mappings":";;;;;;AAsBO,SAAS,UAEd,KACA,SAAyB,IACA;AACzB,QAAM,EAAE,SAAS,YAAYA,MAAAA,MAAM,GAAG;AAEtCC,UAAAA,UAAU,MAAM;AACd,QAAI,CAAC,IAAI,QAAS;AAGlB,YAAA;AAGA,YAAQC,OAAAA,gBAAgB,MAAM;AAE9B,WAAO,MAAM,QAAA;AAAA,EACf,GAAG,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;AAElC,SAAO,EAAE,QAAA;AACX;;"}

package/dist/fx/convenience-hooks/use-shadow.d.ts

@@ -0,0 +1,21 @@
+import { ShadowFXConfig } from '../fx-creators/shadow';
+/**
+ * Hook for automatic shadow FX
+ * @param ref - GameObject ref
+ * @param config - Shadow config (updates reactively)
+ * @returns FX controls
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef(null)
+ * useShadow(ref, { x: 4, y: 4, decay: 0.1 })
+ *
+ * return <View ref={ref}>Content</View>
+ * ```
+ */
+export declare function useShadow(ref: {
+    current: any;
+}, config?: ShadowFXConfig): {
+    clearFX: () => void;
+};
+//# sourceMappingURL=use-shadow.d.ts.map

package/dist/fx/convenience-hooks/use-shadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-shadow.d.ts","sourceRoot":"","sources":["../../../src/fx/convenience-hooks/use-shadow.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAEvB,GAAG,EAAE;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,EACrB,MAAM,GAAE,cAAmB,GAC1B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAgBzB"}

package/dist/fx/convenience-hooks/use-shadow.js

@@ -0,0 +1,18 @@
+import "../../hooks.js";
+import { createShadowFX } from "../fx-creators/shadow.js";
+import { useFX } from "../use-fx.js";
+import { useEffect } from "@number10/jsx-core";
+function useShadow(ref, config = {}) {
+  const { applyFX, clearFX } = useFX(ref);
+  useEffect(() => {
+    if (!ref.current) return;
+    clearFX();
+    applyFX(createShadowFX, config);
+    return () => clearFX();
+  }, [ref, config, applyFX, clearFX]);
+  return { clearFX };
+}
+export {
+  useShadow
+};
+//# sourceMappingURL=use-shadow.js.map

package/dist/fx/convenience-hooks/use-shadow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-shadow.js","sources":["../../../src/fx/convenience-hooks/use-shadow.ts"],"sourcesContent":["/**\n * Convenience hook for automatic shadow FX\n * Applies shadow on mount and updates on config changes\n */\nimport { useEffect } from '../../hooks'\nimport { createShadowFX, type ShadowFXConfig } from '../fx-creators/shadow'\nimport { useFX } from '../use-fx'\n\n/**\n * Hook for automatic shadow FX\n * @param ref - GameObject ref\n * @param config - Shadow config (updates reactively)\n * @returns FX controls\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * useShadow(ref, { x: 4, y: 4, decay: 0.1 })\n *\n * return <View ref={ref}>Content</View>\n * ```\n */\nexport function useShadow(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ref: { current: any },\n  config: ShadowFXConfig = {}\n): { clearFX: () => void } {\n  const { applyFX, clearFX } = useFX(ref)\n\n  useEffect(() => {\n    if (!ref.current) return\n\n    // Clear previous FX\n    clearFX()\n\n    // Apply new shadow\n    applyFX(createShadowFX, config)\n\n    return () => clearFX()\n  }, [ref, config, applyFX, clearFX])\n\n  return { clearFX }\n}\n"],"names":[],"mappings":";;;;AAsBO,SAAS,UAEd,KACA,SAAyB,IACA;AACzB,QAAM,EAAE,SAAS,YAAY,MAAM,GAAG;AAEtC,YAAU,MAAM;AACd,QAAI,CAAC,IAAI,QAAS;AAGlB,YAAA;AAGA,YAAQ,gBAAgB,MAAM;AAE9B,WAAO,MAAM,QAAA;AAAA,EACf,GAAG,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;AAElC,SAAO,EAAE,QAAA;AACX;"}