@number10/jsx-phaser 5.0.0

package/dist/fx/fx-creators/vignette.d.ts

@@ -0,0 +1,33 @@
+import { FXConfig, FXCreatorFn } from '../use-fx';
+/**
+ * Vignette FX configuration
+ */
+export interface VignetteFXConfig extends FXConfig {
+    /** The horizontal offset of the vignette effect. This value is normalized to the range 0 to 1 */
+    x?: number;
+    /** The vertical offset of the vignette effect. This value is normalized to the range 0 to 1 */
+    y?: number;
+    /** The radius of the vignette effect. This value is normalized to the range 0 to 1 */
+    radius?: number;
+    /** The strength of the vignette effect */
+    strength?: number;
+}
+/**
+ * Create vignette FX
+ * @param obj - GameObject
+ * @param config - Vignette configuration
+ * @param type - 'post' or 'pre' FX
+ * @returns Vignette controller
+ *
+ * @example
+ * ```tsx
+ * applyFX(createVignetteFX, {
+ *   x: 0.5,
+ *   y: 0.5,
+ *   radius: 0.5,
+ *   strength: 0.7
+ * })
+ * ```
+ */
+export declare const createVignetteFX: FXCreatorFn<VignetteFXConfig>;
+//# sourceMappingURL=vignette.d.ts.map

package/dist/fx/fx-creators/vignette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vignette.d.ts","sourceRoot":"","sources":["../../../src/fx/fx-creators/vignette.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,iGAAiG;IACjG,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,+FAA+F;IAC/F,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAoB1D,CAAA"}

package/dist/fx/fx-creators/vignette.js

@@ -0,0 +1,20 @@
+const createVignetteFX = (obj, config, type = "internal") => {
+  const { strength = 0.5, radius = 0.5, x = 0.5, y = 0.5 } = config;
+  obj.enableFilters();
+  const filters = obj.filters;
+  if (!filters) {
+    console.warn("[createVignetteFX] Filters not available on this GameObject");
+    return null;
+  }
+  const pipeline = type === "internal" ? filters.internal : filters.external;
+  if (!pipeline) {
+    console.warn("[createVignetteFX] FX pipeline not available on this GameObject");
+    return null;
+  }
+  const vignette = pipeline.addVignette(x, y, radius, strength);
+  return vignette;
+};
+export {
+  createVignetteFX
+};
+//# sourceMappingURL=vignette.js.map

package/dist/fx/fx-creators/vignette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vignette.js","sources":["../../../src/fx/fx-creators/vignette.ts"],"sourcesContent":["/**\n * Vignette FX creator\n */\nimport type { FXConfig, FXCreatorFn } from '../use-fx'\n\n/**\n * Vignette FX configuration\n */\nexport interface VignetteFXConfig extends FXConfig {\n  /** The horizontal offset of the vignette effect. This value is normalized to the range 0 to 1 */\n  x?: number\n  /** The vertical offset of the vignette effect. This value is normalized to the range 0 to 1 */\n  y?: number\n  /** The radius of the vignette effect. This value is normalized to the range 0 to 1 */\n  radius?: number\n  /** The strength of the vignette effect */\n  strength?: number\n}\n\n/**\n * Create vignette FX\n * @param obj - GameObject\n * @param config - Vignette configuration\n * @param type - 'post' or 'pre' FX\n * @returns Vignette controller\n *\n * @example\n * ```tsx\n * applyFX(createVignetteFX, {\n *   x: 0.5,\n *   y: 0.5,\n *   radius: 0.5,\n *   strength: 0.7\n * })\n * ```\n */\nexport const createVignetteFX: FXCreatorFn<VignetteFXConfig> = (obj, config, type = 'internal') => {\n  const { strength = 0.5, radius = 0.5, x = 0.5, y = 0.5 } = config\n\n  obj.enableFilters()\n  const filters = obj.filters\n  if (!filters) {\n    console.warn('[createVignetteFX] Filters not available on this GameObject')\n    return null\n  }\n\n  const pipeline = type === 'internal' ? filters.internal : filters.external\n  if (!pipeline) {\n    console.warn('[createVignetteFX] FX pipeline not available on this GameObject')\n    return null\n  }\n\n  // Phaser Vignette: addVignette(x, y, radius, strength)\n  const vignette = pipeline.addVignette(x, y, radius, strength)\n\n  return vignette\n}\n"],"names":[],"mappings":"AAoCO,MAAM,mBAAkD,CAAC,KAAK,QAAQ,OAAO,eAAe;AACjG,QAAM,EAAE,WAAW,KAAK,SAAS,KAAK,IAAI,KAAK,IAAI,IAAA,IAAQ;AAE3D,MAAI,cAAA;AACJ,QAAM,UAAU,IAAI;AACpB,MAAI,CAAC,SAAS;AACZ,YAAQ,KAAK,6DAA6D;AAC1E,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,SAAS,aAAa,QAAQ,WAAW,QAAQ;AAClE,MAAI,CAAC,UAAU;AACb,YAAQ,KAAK,iEAAiE;AAC9E,WAAO;AAAA,EACT;AAGA,QAAM,WAAW,SAAS,YAAY,GAAG,GAAG,QAAQ,QAAQ;AAE5D,SAAO;AACT;"}

package/dist/fx/fx-registry.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const blur = require("./fx-creators/blur.cjs");
+const colorMatrix = require("./fx-creators/color-matrix.cjs");
+const glow = require("./fx-creators/glow.cjs");
+const pixelate = require("./fx-creators/pixelate.cjs");
+const shadow = require("./fx-creators/shadow.cjs");
+const vignette = require("./fx-creators/vignette.cjs");
+const FX_REGISTRY = {
+  shadow: shadow.createShadowFX,
+  glow: glow.createGlowFX,
+  blur: blur.createBlurFX,
+  pixelate: pixelate.createPixelateFX,
+  vignette: vignette.createVignetteFX,
+  grayscale: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "grayscale" }, type),
+  sepia: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "sepia" }, type),
+  negative: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "negative" }, type),
+  blackWhite: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "blackWhite" }, type),
+  brown: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "brown" }, type),
+  kodachrome: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "kodachrome" }, type),
+  technicolor: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "technicolor" }, type),
+  polaroid: (obj, config, type) => colorMatrix.createColorMatrixFX(obj, { ...config, effect: "polaroid" }, type)
+};
+const DEFAULT_FX = "grayscale";
+function resolveFX(fxOrName) {
+  if (typeof fxOrName === "function") {
+    return fxOrName;
+  }
+  return FX_REGISTRY[fxOrName] ?? null;
+}
+function applyFXByName(applyFXFn, fxName, config = {}) {
+  const creator = resolveFX(fxName);
+  if (creator) {
+    applyFXFn(creator, config);
+  } else {
+    console.warn(`[applyFXByName] FX "${fxName}" not found in registry`);
+  }
+}
+exports.DEFAULT_FX = DEFAULT_FX;
+exports.FX_REGISTRY = FX_REGISTRY;
+exports.applyFXByName = applyFXByName;
+exports.resolveFX = resolveFX;
+//# sourceMappingURL=fx-registry.cjs.map

package/dist/fx/fx-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-registry.cjs","sources":["../../src/fx/fx-registry.ts"],"sourcesContent":["/**\n * FX Registry - string-based FX lookup\n * Similar to effect-registry.ts for animation effects\n */\nimport {\n  createBlurFX,\n  createColorMatrixFX,\n  createGlowFX,\n  createPixelateFX,\n  createShadowFX,\n  createVignetteFX,\n  type BlurFXConfig,\n  type ColorMatrixFXConfig,\n  type GlowFXConfig,\n  type PixelateFXConfig,\n  type ShadowFXConfig,\n  type VignetteFXConfig,\n} from './fx-creators'\nimport type { FXConfig, FXCreatorFn } from './use-fx'\n\n/**\n * Built-in FX names\n */\nexport type BuiltInFXName =\n  | 'shadow'\n  | 'glow'\n  | 'blur'\n  | 'pixelate'\n  | 'vignette'\n  | 'grayscale'\n  | 'sepia'\n  | 'negative'\n  | 'blackWhite'\n  | 'brown'\n  | 'kodachrome'\n  | 'technicolor'\n  | 'polaroid'\n\n/**\n * Extension point for custom FX (declaration merging)\n * @example\n * ```typescript\n * declare module '@number10/phaserjsx/fx' {\n *   interface FXNameExtensions {\n *     myCustomFX: 'myCustomFX'\n *   }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface FXNameExtensions {}\n\n/**\n * All available FX names (built-in + extensions)\n */\nexport type FXName =\n  | BuiltInFXName\n  | (keyof FXNameExtensions extends never ? never : keyof FXNameExtensions)\n\n/**\n * FX definition with name and config\n */\nexport interface FXDefinition {\n  name: FXName\n  config?: FXConfig\n}\n\n/**\n * FX Registry mapping names to creator functions\n */\nexport const FX_REGISTRY: Record<BuiltInFXName, FXCreatorFn> = {\n  shadow: createShadowFX,\n  glow: createGlowFX,\n  blur: createBlurFX,\n  pixelate: createPixelateFX,\n  vignette: createVignetteFX,\n  grayscale: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'grayscale' }, type),\n  sepia: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: 'sepia' }, type),\n  negative: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'negative' }, type),\n  blackWhite: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'blackWhite' }, type),\n  brown: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: 'brown' }, type),\n  kodachrome: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'kodachrome' }, type),\n  technicolor: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'technicolor' }, type),\n  polaroid: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'polaroid' }, type),\n}\n\n/**\n * Default FX (none)\n */\nexport const DEFAULT_FX: FXName = 'grayscale'\n\n/**\n * Resolve FX by name or function\n * @param fxOrName - FX name string or creator function\n * @returns FX creator function or null\n */\nexport function resolveFX(fxOrName: FXName | FXCreatorFn): FXCreatorFn | null {\n  if (typeof fxOrName === 'function') {\n    return fxOrName\n  }\n  return FX_REGISTRY[fxOrName as BuiltInFXName] ?? null\n}\n\n/**\n * Apply FX by name (helper function)\n * @param applyFXFn - applyFX function from useFX hook\n * @param fxName - FX name\n * @param config - FX config\n *\n * @example\n * ```tsx\n * const { applyFX } = useFX(ref)\n * applyFXByName(applyFX, 'shadow', { offsetX: 4, offsetY: 4, blur: 8 })\n * ```\n */\nexport function applyFXByName(\n  applyFXFn: ReturnType<typeof import('./use-fx').useFX>['applyFX'],\n  fxName: FXName,\n  config: FXConfig = {}\n) {\n  const creator = resolveFX(fxName)\n  if (creator) {\n    applyFXFn(creator, config)\n  } else {\n    console.warn(`[applyFXByName] FX \"${fxName}\" not found in registry`)\n  }\n}\n\n// Re-export config types for convenience\nexport type {\n  BlurFXConfig,\n  ColorMatrixFXConfig,\n  GlowFXConfig,\n  PixelateFXConfig,\n  ShadowFXConfig,\n  VignetteFXConfig,\n}\n"],"names":["createShadowFX","createGlowFX","createBlurFX","createPixelateFX","createVignetteFX","createColorMatrixFX"],"mappings":";;;;;;;;AAsEO,MAAM,cAAkD;AAAA,EAC7D,QAAQA,OAAAA;AAAAA,EACR,MAAMC,KAAAA;AAAAA,EACN,MAAMC,KAAAA;AAAAA,EACN,UAAUC,SAAAA;AAAAA,EACV,UAAUC,SAAAA;AAAAA,EACV,WAAW,CAAC,KAAK,QAAQ,SACvBC,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,YAAA,GAAe,IAAI;AAAA,EACnE,OAAO,CAAC,KAAK,QAAQ,SAASA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,QAAA,GAAW,IAAI;AAAA,EAC3F,UAAU,CAAC,KAAK,QAAQ,SACtBA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,WAAA,GAAc,IAAI;AAAA,EAClE,YAAY,CAAC,KAAK,QAAQ,SACxBA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,aAAA,GAAgB,IAAI;AAAA,EACpE,OAAO,CAAC,KAAK,QAAQ,SAASA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,QAAA,GAAW,IAAI;AAAA,EAC3F,YAAY,CAAC,KAAK,QAAQ,SACxBA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,aAAA,GAAgB,IAAI;AAAA,EACpE,aAAa,CAAC,KAAK,QAAQ,SACzBA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,cAAA,GAAiB,IAAI;AAAA,EACrE,UAAU,CAAC,KAAK,QAAQ,SACtBA,YAAAA,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,WAAA,GAAc,IAAI;AACpE;AAKO,MAAM,aAAqB;AAO3B,SAAS,UAAU,UAAoD;AAC5E,MAAI,OAAO,aAAa,YAAY;AAClC,WAAO;AAAA,EACT;AACA,SAAO,YAAY,QAAyB,KAAK;AACnD;AAcO,SAAS,cACd,WACA,QACA,SAAmB,CAAA,GACnB;AACA,QAAM,UAAU,UAAU,MAAM;AAChC,MAAI,SAAS;AACX,cAAU,SAAS,MAAM;AAAA,EAC3B,OAAO;AACL,YAAQ,KAAK,uBAAuB,MAAM,yBAAyB;AAAA,EACrE;AACF;;;;;"}

package/dist/fx/fx-registry.d.ts

@@ -0,0 +1,59 @@
+import { BlurFXConfig, ColorMatrixFXConfig, GlowFXConfig, PixelateFXConfig, ShadowFXConfig, VignetteFXConfig } from './fx-creators';
+import { FXConfig, FXCreatorFn } from './use-fx';
+/**
+ * Built-in FX names
+ */
+export type BuiltInFXName = 'shadow' | 'glow' | 'blur' | 'pixelate' | 'vignette' | 'grayscale' | 'sepia' | 'negative' | 'blackWhite' | 'brown' | 'kodachrome' | 'technicolor' | 'polaroid';
+/**
+ * Extension point for custom FX (declaration merging)
+ * @example
+ * ```typescript
+ * declare module '@number10/phaserjsx/fx' {
+ *   interface FXNameExtensions {
+ *     myCustomFX: 'myCustomFX'
+ *   }
+ * }
+ * ```
+ */
+export interface FXNameExtensions {
+}
+/**
+ * All available FX names (built-in + extensions)
+ */
+export type FXName = BuiltInFXName | (keyof FXNameExtensions extends never ? never : keyof FXNameExtensions);
+/**
+ * FX definition with name and config
+ */
+export interface FXDefinition {
+    name: FXName;
+    config?: FXConfig;
+}
+/**
+ * FX Registry mapping names to creator functions
+ */
+export declare const FX_REGISTRY: Record<BuiltInFXName, FXCreatorFn>;
+/**
+ * Default FX (none)
+ */
+export declare const DEFAULT_FX: FXName;
+/**
+ * Resolve FX by name or function
+ * @param fxOrName - FX name string or creator function
+ * @returns FX creator function or null
+ */
+export declare function resolveFX(fxOrName: FXName | FXCreatorFn): FXCreatorFn | null;
+/**
+ * Apply FX by name (helper function)
+ * @param applyFXFn - applyFX function from useFX hook
+ * @param fxName - FX name
+ * @param config - FX config
+ *
+ * @example
+ * ```tsx
+ * const { applyFX } = useFX(ref)
+ * applyFXByName(applyFX, 'shadow', { offsetX: 4, offsetY: 4, blur: 8 })
+ * ```
+ */
+export declare function applyFXByName(applyFXFn: ReturnType<typeof import('./use-fx').useFX>['applyFX'], fxName: FXName, config?: FXConfig): void;
+export type { BlurFXConfig, ColorMatrixFXConfig, GlowFXConfig, PixelateFXConfig, ShadowFXConfig, VignetteFXConfig, };
+//# sourceMappingURL=fx-registry.d.ts.map

package/dist/fx/fx-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-registry.d.ts","sourceRoot":"","sources":["../../src/fx/fx-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,UAAU,GACV,YAAY,GACZ,OAAO,GACP,YAAY,GACZ,aAAa,GACb,UAAU,CAAA;AAEd;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,gBAAgB;CAAG;AAEpC;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,aAAa,GACb,CAAC,MAAM,gBAAgB,SAAS,KAAK,GAAG,KAAK,GAAG,MAAM,gBAAgB,CAAC,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,CAoB1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAoB,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,IAAI,CAK5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,UAAU,CAAC,cAAc,UAAU,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,EACjE,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,QAAa,QAQtB;AAGD,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,CAAA"}

package/dist/fx/fx-registry.js

@@ -0,0 +1,43 @@
+import { createBlurFX } from "./fx-creators/blur.js";
+import { createColorMatrixFX } from "./fx-creators/color-matrix.js";
+import { createGlowFX } from "./fx-creators/glow.js";
+import { createPixelateFX } from "./fx-creators/pixelate.js";
+import { createShadowFX } from "./fx-creators/shadow.js";
+import { createVignetteFX } from "./fx-creators/vignette.js";
+const FX_REGISTRY = {
+  shadow: createShadowFX,
+  glow: createGlowFX,
+  blur: createBlurFX,
+  pixelate: createPixelateFX,
+  vignette: createVignetteFX,
+  grayscale: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "grayscale" }, type),
+  sepia: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "sepia" }, type),
+  negative: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "negative" }, type),
+  blackWhite: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "blackWhite" }, type),
+  brown: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "brown" }, type),
+  kodachrome: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "kodachrome" }, type),
+  technicolor: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "technicolor" }, type),
+  polaroid: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: "polaroid" }, type)
+};
+const DEFAULT_FX = "grayscale";
+function resolveFX(fxOrName) {
+  if (typeof fxOrName === "function") {
+    return fxOrName;
+  }
+  return FX_REGISTRY[fxOrName] ?? null;
+}
+function applyFXByName(applyFXFn, fxName, config = {}) {
+  const creator = resolveFX(fxName);
+  if (creator) {
+    applyFXFn(creator, config);
+  } else {
+    console.warn(`[applyFXByName] FX "${fxName}" not found in registry`);
+  }
+}
+export {
+  DEFAULT_FX,
+  FX_REGISTRY,
+  applyFXByName,
+  resolveFX
+};
+//# sourceMappingURL=fx-registry.js.map

package/dist/fx/fx-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-registry.js","sources":["../../src/fx/fx-registry.ts"],"sourcesContent":["/**\n * FX Registry - string-based FX lookup\n * Similar to effect-registry.ts for animation effects\n */\nimport {\n  createBlurFX,\n  createColorMatrixFX,\n  createGlowFX,\n  createPixelateFX,\n  createShadowFX,\n  createVignetteFX,\n  type BlurFXConfig,\n  type ColorMatrixFXConfig,\n  type GlowFXConfig,\n  type PixelateFXConfig,\n  type ShadowFXConfig,\n  type VignetteFXConfig,\n} from './fx-creators'\nimport type { FXConfig, FXCreatorFn } from './use-fx'\n\n/**\n * Built-in FX names\n */\nexport type BuiltInFXName =\n  | 'shadow'\n  | 'glow'\n  | 'blur'\n  | 'pixelate'\n  | 'vignette'\n  | 'grayscale'\n  | 'sepia'\n  | 'negative'\n  | 'blackWhite'\n  | 'brown'\n  | 'kodachrome'\n  | 'technicolor'\n  | 'polaroid'\n\n/**\n * Extension point for custom FX (declaration merging)\n * @example\n * ```typescript\n * declare module '@number10/phaserjsx/fx' {\n *   interface FXNameExtensions {\n *     myCustomFX: 'myCustomFX'\n *   }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface FXNameExtensions {}\n\n/**\n * All available FX names (built-in + extensions)\n */\nexport type FXName =\n  | BuiltInFXName\n  | (keyof FXNameExtensions extends never ? never : keyof FXNameExtensions)\n\n/**\n * FX definition with name and config\n */\nexport interface FXDefinition {\n  name: FXName\n  config?: FXConfig\n}\n\n/**\n * FX Registry mapping names to creator functions\n */\nexport const FX_REGISTRY: Record<BuiltInFXName, FXCreatorFn> = {\n  shadow: createShadowFX,\n  glow: createGlowFX,\n  blur: createBlurFX,\n  pixelate: createPixelateFX,\n  vignette: createVignetteFX,\n  grayscale: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'grayscale' }, type),\n  sepia: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: 'sepia' }, type),\n  negative: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'negative' }, type),\n  blackWhite: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'blackWhite' }, type),\n  brown: (obj, config, type) => createColorMatrixFX(obj, { ...config, effect: 'brown' }, type),\n  kodachrome: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'kodachrome' }, type),\n  technicolor: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'technicolor' }, type),\n  polaroid: (obj, config, type) =>\n    createColorMatrixFX(obj, { ...config, effect: 'polaroid' }, type),\n}\n\n/**\n * Default FX (none)\n */\nexport const DEFAULT_FX: FXName = 'grayscale'\n\n/**\n * Resolve FX by name or function\n * @param fxOrName - FX name string or creator function\n * @returns FX creator function or null\n */\nexport function resolveFX(fxOrName: FXName | FXCreatorFn): FXCreatorFn | null {\n  if (typeof fxOrName === 'function') {\n    return fxOrName\n  }\n  return FX_REGISTRY[fxOrName as BuiltInFXName] ?? null\n}\n\n/**\n * Apply FX by name (helper function)\n * @param applyFXFn - applyFX function from useFX hook\n * @param fxName - FX name\n * @param config - FX config\n *\n * @example\n * ```tsx\n * const { applyFX } = useFX(ref)\n * applyFXByName(applyFX, 'shadow', { offsetX: 4, offsetY: 4, blur: 8 })\n * ```\n */\nexport function applyFXByName(\n  applyFXFn: ReturnType<typeof import('./use-fx').useFX>['applyFX'],\n  fxName: FXName,\n  config: FXConfig = {}\n) {\n  const creator = resolveFX(fxName)\n  if (creator) {\n    applyFXFn(creator, config)\n  } else {\n    console.warn(`[applyFXByName] FX \"${fxName}\" not found in registry`)\n  }\n}\n\n// Re-export config types for convenience\nexport type {\n  BlurFXConfig,\n  ColorMatrixFXConfig,\n  GlowFXConfig,\n  PixelateFXConfig,\n  ShadowFXConfig,\n  VignetteFXConfig,\n}\n"],"names":[],"mappings":";;;;;;AAsEO,MAAM,cAAkD;AAAA,EAC7D,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,EACV,WAAW,CAAC,KAAK,QAAQ,SACvB,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,YAAA,GAAe,IAAI;AAAA,EACnE,OAAO,CAAC,KAAK,QAAQ,SAAS,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,QAAA,GAAW,IAAI;AAAA,EAC3F,UAAU,CAAC,KAAK,QAAQ,SACtB,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,WAAA,GAAc,IAAI;AAAA,EAClE,YAAY,CAAC,KAAK,QAAQ,SACxB,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,aAAA,GAAgB,IAAI;AAAA,EACpE,OAAO,CAAC,KAAK,QAAQ,SAAS,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,QAAA,GAAW,IAAI;AAAA,EAC3F,YAAY,CAAC,KAAK,QAAQ,SACxB,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,aAAA,GAAgB,IAAI;AAAA,EACpE,aAAa,CAAC,KAAK,QAAQ,SACzB,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,cAAA,GAAiB,IAAI;AAAA,EACrE,UAAU,CAAC,KAAK,QAAQ,SACtB,oBAAoB,KAAK,EAAE,GAAG,QAAQ,QAAQ,WAAA,GAAc,IAAI;AACpE;AAKO,MAAM,aAAqB;AAO3B,SAAS,UAAU,UAAoD;AAC5E,MAAI,OAAO,aAAa,YAAY;AAClC,WAAO;AAAA,EACT;AACA,SAAO,YAAY,QAAyB,KAAK;AACnD;AAcO,SAAS,cACd,WACA,QACA,SAAmB,CAAA,GACnB;AACA,QAAM,UAAU,UAAU,MAAM;AAChC,MAAI,SAAS;AACX,cAAU,SAAS,MAAM;AAAA,EAC3B,OAAO;AACL,YAAQ,KAAK,uBAAuB,MAAM,yBAAyB;AAAA,EACrE;AACF;"}

package/dist/fx/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * FX System for PhaserJSX
+ * GPU-accelerated Phaser PostFX/PreFX pipeline effects
+ *
+ * @example Basic usage:
+ * ```tsx
+ * import { useFX, createShadowFX } from '@number10/phaserjsx/fx'
+ *
+ * function MyComponent() {
+ *   const ref = useRef(null)
+ *   const { applyFX } = useFX(ref)
+ *
+ *   const handleHover = () => {
+ *     applyFX(createShadowFX, { offsetX: 4, offsetY: 4, blur: 8 })
+ *   }
+ *
+ *   return <Image ref={ref} onHoverStart={handleHover} />
+ * }
+ * ```
+ *
+ * @example Convenience hooks:
+ * ```tsx
+ * import { useShadow } from '@number10/phaserjsx/fx'
+ *
+ * function MyComponent() {
+ *   const ref = useRef(null)
+ *   useShadow(ref, { offsetX: 4, offsetY: 4, blur: 8 })
+ *
+ *   return <View ref={ref}>Content</View>
+ * }
+ * ```
+ *
+ * @example Registry-based FX:
+ * ```tsx
+ * import { useFX, applyFXByName } from '@number10/phaserjsx/fx'
+ *
+ * function MyComponent() {
+ *   const ref = useRef(null)
+ *   const { applyFX } = useFX(ref)
+ *
+ *   const handleClick = () => {
+ *     applyFXByName(applyFX, 'glow', { color: 0xff6600, distance: 10 })
+ *   }
+ * }
+ * ```
+ */
+export { useFX, type FXCapableGameObject, type FXConfig, type FXCreatorFn, type FXType, } from './use-fx';
+export { DEFAULT_FX, FX_REGISTRY, applyFXByName, resolveFX, type BuiltInFXName, type FXDefinition, type FXName, type FXNameExtensions, } from './fx-registry';
+export { createBlurFX, createColorMatrixFX, createGlowFX, createPixelateFX, createShadowFX, createVignetteFX, type BlurFXConfig, type ColorMatrixEffect, type ColorMatrixFXConfig, type GlowFXConfig, type PixelateFXConfig, type ShadowFXConfig, type VignetteFXConfig, } from './fx-creators';
+export { useBlur, useGlow, useShadow } from './convenience-hooks';
+//# sourceMappingURL=index.d.ts.map

package/dist/fx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,EACL,KAAK,EACL,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,MAAM,GACZ,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/fx/use-fx.cjs

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../hooks.cjs");
+const jsxCore = require("@number10/jsx-core");
+function useFX(ref) {
+  const activeEffectsRef = jsxCore.useRef(/* @__PURE__ */ new Set());
+  jsxCore.useEffect(() => {
+    const obj = ref.current;
+    if (obj && typeof obj.enableFilters === "function") {
+      obj.enableFilters();
+    }
+  }, []);
+  jsxCore.useEffect(() => {
+    return () => {
+      activeEffectsRef.current.forEach((cleanup) => {
+        if (typeof cleanup === "function") {
+          cleanup();
+        } else if (cleanup?.destroy) {
+          cleanup.destroy();
+        }
+      });
+      activeEffectsRef.current.clear();
+    };
+  }, []);
+  const applyFX = (fxCreator, config, type = "internal") => {
+    const obj = ref.current;
+    if (!obj) {
+      console.warn("[useFX] No object found in ref");
+      return;
+    }
+    const cleanupOrController = fxCreator(obj, config, type);
+    if (cleanupOrController) {
+      activeEffectsRef.current.add(cleanupOrController);
+    }
+  };
+  const clearFX = () => {
+    activeEffectsRef.current.forEach((cleanup) => {
+      if (typeof cleanup === "function") {
+        cleanup();
+      } else if (cleanup?.destroy) {
+        cleanup.destroy();
+      }
+    });
+    activeEffectsRef.current.clear();
+    const obj = ref.current;
+    if (obj?.filters) {
+      obj.filters.internal.clear();
+      obj.filters.external.clear();
+    }
+  };
+  return { applyFX, clearFX };
+}
+exports.useFX = useFX;
+//# sourceMappingURL=use-fx.cjs.map

package/dist/fx/use-fx.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fx.cjs","sources":["../../src/fx/use-fx.ts"],"sourcesContent":["/**\n * Hook for applying Phaser PostFX/PreFX pipeline effects\n * Manages FX lifecycle with proper cleanup\n */\nimport { useEffect, useRef } from '../hooks'\n\n/**\n * Ref object type\n */\ntype RefObject<T> = { current: T | null }\n\n/**\n * FX configuration base type\n */\nexport interface FXConfig {\n  intensity?: number\n  quality?: number\n  onComplete?: () => void\n}\n\n/**\n * FX type discriminator (internal vs external filter context)\n */\nexport type FXType = 'internal' | 'external'\n\n/**\n * GameObject with FX pipeline support\n */\nexport type FXCapableGameObject =\n  | Phaser.GameObjects.Image\n  | Phaser.GameObjects.Sprite\n  | Phaser.GameObjects.Container\n  | Phaser.GameObjects.Text\n  | Phaser.GameObjects.TileSprite\n  | Phaser.GameObjects.NineSlice\n  | Phaser.GameObjects.RenderTexture\n  | Phaser.GameObjects.Video\n\n/**\n * FX creator function signature\n * @param obj - GameObject with FX pipeline\n * @param config - Effect-specific configuration\n * @param type - 'post' or 'pre' FX pipeline\n * @returns Cleanup function or FX controller (or any Phaser.FX effect)\n */\nexport type FXCreatorFn<TConfig extends FXConfig = FXConfig> = (\n  obj: FXCapableGameObject,\n  config: TConfig,\n  type?: FXType\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n) => (() => void) | Phaser.Filters.Controller | any | null\n\n/**\n * Hook for applying FX to GameObject\n * @param ref - Ref to GameObject\n * @returns Object with applyFX and clearFX methods\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * const { applyFX, clearFX } = useFX(ref)\n *\n * const handleClick = () => {\n *   applyFX(createShadowFX, { offsetX: 4, offsetY: 4, blur: 8 })\n * }\n *\n * return <View ref={ref} onClick={handleClick}>Click me</View>\n * ```\n */\nexport function useFX<T extends FXCapableGameObject>(ref: RefObject<T>) {\n  const activeEffectsRef = useRef<Set<(() => void) | Phaser.Filters.Controller>>(new Set())\n\n  // Pre-initialize the Phaser 4 filter pipeline at mount time.\n  // Calling enableFilters() lazily (on first FX application) causes the game object\n  // to resize to 1/4 of its original size. Initializing it eagerly during mount\n  // (before layout settles) prevents this resize behavior.\n  useEffect(() => {\n    const obj = ref.current\n    if (obj && typeof (obj as { enableFilters?: () => void }).enableFilters === 'function') {\n      ;(obj as { enableFilters: () => void }).enableFilters()\n    }\n  }, [])\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      activeEffectsRef.current.forEach((cleanup) => {\n        if (typeof cleanup === 'function') {\n          cleanup()\n        } else if (cleanup?.destroy) {\n          cleanup.destroy()\n        }\n      })\n      activeEffectsRef.current.clear()\n    }\n  }, [])\n\n  const applyFX = <TConfig extends FXConfig>(\n    fxCreator: FXCreatorFn<TConfig>,\n    config: TConfig,\n    type: FXType = 'internal'\n  ) => {\n    const obj = ref.current\n    if (!obj) {\n      console.warn('[useFX] No object found in ref')\n      return\n    }\n\n    const cleanupOrController = fxCreator(obj, config, type)\n    if (cleanupOrController) {\n      activeEffectsRef.current.add(cleanupOrController)\n    }\n  }\n\n  const clearFX = () => {\n    activeEffectsRef.current.forEach((cleanup) => {\n      if (typeof cleanup === 'function') {\n        cleanup()\n      } else if (cleanup?.destroy) {\n        cleanup.destroy()\n      }\n    })\n    activeEffectsRef.current.clear()\n\n    // Clear filters\n    const obj = ref.current\n    if (obj?.filters) {\n      obj.filters.internal.clear()\n      obj.filters.external.clear()\n    }\n  }\n\n  return { applyFX, clearFX }\n}\n"],"names":["useRef","useEffect"],"mappings":";;;;AAqEO,SAAS,MAAqC,KAAmB;AACtE,QAAM,mBAAmBA,QAAAA,OAAsD,oBAAI,KAAK;AAMxFC,UAAAA,UAAU,MAAM;AACd,UAAM,MAAM,IAAI;AAChB,QAAI,OAAO,OAAQ,IAAuC,kBAAkB,YAAY;AACpF,UAAsC,cAAA;AAAA,IAC1C;AAAA,EACF,GAAG,CAAA,CAAE;AAGLA,UAAAA,UAAU,MAAM;AACd,WAAO,MAAM;AACX,uBAAiB,QAAQ,QAAQ,CAAC,YAAY;AAC5C,YAAI,OAAO,YAAY,YAAY;AACjC,kBAAA;AAAA,QACF,WAAW,SAAS,SAAS;AAC3B,kBAAQ,QAAA;AAAA,QACV;AAAA,MACF,CAAC;AACD,uBAAiB,QAAQ,MAAA;AAAA,IAC3B;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,UAAU,CACd,WACA,QACA,OAAe,eACZ;AACH,UAAM,MAAM,IAAI;AAChB,QAAI,CAAC,KAAK;AACR,cAAQ,KAAK,gCAAgC;AAC7C;AAAA,IACF;AAEA,UAAM,sBAAsB,UAAU,KAAK,QAAQ,IAAI;AACvD,QAAI,qBAAqB;AACvB,uBAAiB,QAAQ,IAAI,mBAAmB;AAAA,IAClD;AAAA,EACF;AAEA,QAAM,UAAU,MAAM;AACpB,qBAAiB,QAAQ,QAAQ,CAAC,YAAY;AAC5C,UAAI,OAAO,YAAY,YAAY;AACjC,gBAAA;AAAA,MACF,WAAW,SAAS,SAAS;AAC3B,gBAAQ,QAAA;AAAA,MACV;AAAA,IACF,CAAC;AACD,qBAAiB,QAAQ,MAAA;AAGzB,UAAM,MAAM,IAAI;AAChB,QAAI,KAAK,SAAS;AAChB,UAAI,QAAQ,SAAS,MAAA;AACrB,UAAI,QAAQ,SAAS,MAAA;AAAA,IACvB;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,QAAA;AACpB;;"}

package/dist/fx/use-fx.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Ref object type
+ */
+type RefObject<T> = {
+    current: T | null;
+};
+/**
+ * FX configuration base type
+ */
+export interface FXConfig {
+    intensity?: number;
+    quality?: number;
+    onComplete?: () => void;
+}
+/**
+ * FX type discriminator (internal vs external filter context)
+ */
+export type FXType = 'internal' | 'external';
+/**
+ * GameObject with FX pipeline support
+ */
+export type FXCapableGameObject = Phaser.GameObjects.Image | Phaser.GameObjects.Sprite | Phaser.GameObjects.Container | Phaser.GameObjects.Text | Phaser.GameObjects.TileSprite | Phaser.GameObjects.NineSlice | Phaser.GameObjects.RenderTexture | Phaser.GameObjects.Video;
+/**
+ * FX creator function signature
+ * @param obj - GameObject with FX pipeline
+ * @param config - Effect-specific configuration
+ * @param type - 'post' or 'pre' FX pipeline
+ * @returns Cleanup function or FX controller (or any Phaser.FX effect)
+ */
+export type FXCreatorFn<TConfig extends FXConfig = FXConfig> = (obj: FXCapableGameObject, config: TConfig, type?: FXType) => (() => void) | Phaser.Filters.Controller | any | null;
+/**
+ * Hook for applying FX to GameObject
+ * @param ref - Ref to GameObject
+ * @returns Object with applyFX and clearFX methods
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef(null)
+ * const { applyFX, clearFX } = useFX(ref)
+ *
+ * const handleClick = () => {
+ *   applyFX(createShadowFX, { offsetX: 4, offsetY: 4, blur: 8 })
+ * }
+ *
+ * return <View ref={ref} onClick={handleClick}>Click me</View>
+ * ```
+ */
+export declare function useFX<T extends FXCapableGameObject>(ref: RefObject<T>): {
+    applyFX: <TConfig extends FXConfig>(fxCreator: FXCreatorFn<TConfig>, config: TConfig, type?: FXType) => void;
+    clearFX: () => void;
+};
+export {};
+//# sourceMappingURL=use-fx.d.ts.map

package/dist/fx/use-fx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fx.d.ts","sourceRoot":"","sources":["../../src/fx/use-fx.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,CAAA;AAEzC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;AAE5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,CAAC,WAAW,CAAC,KAAK,GACxB,MAAM,CAAC,WAAW,CAAC,MAAM,GACzB,MAAM,CAAC,WAAW,CAAC,SAAS,GAC5B,MAAM,CAAC,WAAW,CAAC,IAAI,GACvB,MAAM,CAAC,WAAW,CAAC,UAAU,GAC7B,MAAM,CAAC,WAAW,CAAC,SAAS,GAC5B,MAAM,CAAC,WAAW,CAAC,aAAa,GAChC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAC7D,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,OAAO,EACf,IAAI,CAAC,EAAE,MAAM,KAEV,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,GAAG,GAAG,IAAI,CAAA;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;cA4BnD,OAAO,SAAS,QAAQ,aAC5B,WAAW,CAAC,OAAO,CAAC,UACvB,OAAO,SACT,MAAM;;EAiCf"}

package/dist/fx/use-fx.js

@@ -0,0 +1,54 @@
+import "../hooks.js";
+import { useRef, useEffect } from "@number10/jsx-core";
+function useFX(ref) {
+  const activeEffectsRef = useRef(/* @__PURE__ */ new Set());
+  useEffect(() => {
+    const obj = ref.current;
+    if (obj && typeof obj.enableFilters === "function") {
+      obj.enableFilters();
+    }
+  }, []);
+  useEffect(() => {
+    return () => {
+      activeEffectsRef.current.forEach((cleanup) => {
+        if (typeof cleanup === "function") {
+          cleanup();
+        } else if (cleanup?.destroy) {
+          cleanup.destroy();
+        }
+      });
+      activeEffectsRef.current.clear();
+    };
+  }, []);
+  const applyFX = (fxCreator, config, type = "internal") => {
+    const obj = ref.current;
+    if (!obj) {
+      console.warn("[useFX] No object found in ref");
+      return;
+    }
+    const cleanupOrController = fxCreator(obj, config, type);
+    if (cleanupOrController) {
+      activeEffectsRef.current.add(cleanupOrController);
+    }
+  };
+  const clearFX = () => {
+    activeEffectsRef.current.forEach((cleanup) => {
+      if (typeof cleanup === "function") {
+        cleanup();
+      } else if (cleanup?.destroy) {
+        cleanup.destroy();
+      }
+    });
+    activeEffectsRef.current.clear();
+    const obj = ref.current;
+    if (obj?.filters) {
+      obj.filters.internal.clear();
+      obj.filters.external.clear();
+    }
+  };
+  return { applyFX, clearFX };
+}
+export {
+  useFX
+};
+//# sourceMappingURL=use-fx.js.map

package/dist/fx/use-fx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fx.js","sources":["../../src/fx/use-fx.ts"],"sourcesContent":["/**\n * Hook for applying Phaser PostFX/PreFX pipeline effects\n * Manages FX lifecycle with proper cleanup\n */\nimport { useEffect, useRef } from '../hooks'\n\n/**\n * Ref object type\n */\ntype RefObject<T> = { current: T | null }\n\n/**\n * FX configuration base type\n */\nexport interface FXConfig {\n  intensity?: number\n  quality?: number\n  onComplete?: () => void\n}\n\n/**\n * FX type discriminator (internal vs external filter context)\n */\nexport type FXType = 'internal' | 'external'\n\n/**\n * GameObject with FX pipeline support\n */\nexport type FXCapableGameObject =\n  | Phaser.GameObjects.Image\n  | Phaser.GameObjects.Sprite\n  | Phaser.GameObjects.Container\n  | Phaser.GameObjects.Text\n  | Phaser.GameObjects.TileSprite\n  | Phaser.GameObjects.NineSlice\n  | Phaser.GameObjects.RenderTexture\n  | Phaser.GameObjects.Video\n\n/**\n * FX creator function signature\n * @param obj - GameObject with FX pipeline\n * @param config - Effect-specific configuration\n * @param type - 'post' or 'pre' FX pipeline\n * @returns Cleanup function or FX controller (or any Phaser.FX effect)\n */\nexport type FXCreatorFn<TConfig extends FXConfig = FXConfig> = (\n  obj: FXCapableGameObject,\n  config: TConfig,\n  type?: FXType\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n) => (() => void) | Phaser.Filters.Controller | any | null\n\n/**\n * Hook for applying FX to GameObject\n * @param ref - Ref to GameObject\n * @returns Object with applyFX and clearFX methods\n *\n * @example\n * ```tsx\n * const ref = useRef(null)\n * const { applyFX, clearFX } = useFX(ref)\n *\n * const handleClick = () => {\n *   applyFX(createShadowFX, { offsetX: 4, offsetY: 4, blur: 8 })\n * }\n *\n * return <View ref={ref} onClick={handleClick}>Click me</View>\n * ```\n */\nexport function useFX<T extends FXCapableGameObject>(ref: RefObject<T>) {\n  const activeEffectsRef = useRef<Set<(() => void) | Phaser.Filters.Controller>>(new Set())\n\n  // Pre-initialize the Phaser 4 filter pipeline at mount time.\n  // Calling enableFilters() lazily (on first FX application) causes the game object\n  // to resize to 1/4 of its original size. Initializing it eagerly during mount\n  // (before layout settles) prevents this resize behavior.\n  useEffect(() => {\n    const obj = ref.current\n    if (obj && typeof (obj as { enableFilters?: () => void }).enableFilters === 'function') {\n      ;(obj as { enableFilters: () => void }).enableFilters()\n    }\n  }, [])\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      activeEffectsRef.current.forEach((cleanup) => {\n        if (typeof cleanup === 'function') {\n          cleanup()\n        } else if (cleanup?.destroy) {\n          cleanup.destroy()\n        }\n      })\n      activeEffectsRef.current.clear()\n    }\n  }, [])\n\n  const applyFX = <TConfig extends FXConfig>(\n    fxCreator: FXCreatorFn<TConfig>,\n    config: TConfig,\n    type: FXType = 'internal'\n  ) => {\n    const obj = ref.current\n    if (!obj) {\n      console.warn('[useFX] No object found in ref')\n      return\n    }\n\n    const cleanupOrController = fxCreator(obj, config, type)\n    if (cleanupOrController) {\n      activeEffectsRef.current.add(cleanupOrController)\n    }\n  }\n\n  const clearFX = () => {\n    activeEffectsRef.current.forEach((cleanup) => {\n      if (typeof cleanup === 'function') {\n        cleanup()\n      } else if (cleanup?.destroy) {\n        cleanup.destroy()\n      }\n    })\n    activeEffectsRef.current.clear()\n\n    // Clear filters\n    const obj = ref.current\n    if (obj?.filters) {\n      obj.filters.internal.clear()\n      obj.filters.external.clear()\n    }\n  }\n\n  return { applyFX, clearFX }\n}\n"],"names":[],"mappings":";;AAqEO,SAAS,MAAqC,KAAmB;AACtE,QAAM,mBAAmB,OAAsD,oBAAI,KAAK;AAMxF,YAAU,MAAM;AACd,UAAM,MAAM,IAAI;AAChB,QAAI,OAAO,OAAQ,IAAuC,kBAAkB,YAAY;AACpF,UAAsC,cAAA;AAAA,IAC1C;AAAA,EACF,GAAG,CAAA,CAAE;AAGL,YAAU,MAAM;AACd,WAAO,MAAM;AACX,uBAAiB,QAAQ,QAAQ,CAAC,YAAY;AAC5C,YAAI,OAAO,YAAY,YAAY;AACjC,kBAAA;AAAA,QACF,WAAW,SAAS,SAAS;AAC3B,kBAAQ,QAAA;AAAA,QACV;AAAA,MACF,CAAC;AACD,uBAAiB,QAAQ,MAAA;AAAA,IAC3B;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,UAAU,CACd,WACA,QACA,OAAe,eACZ;AACH,UAAM,MAAM,IAAI;AAChB,QAAI,CAAC,KAAK;AACR,cAAQ,KAAK,gCAAgC;AAC7C;AAAA,IACF;AAEA,UAAM,sBAAsB,UAAU,KAAK,QAAQ,IAAI;AACvD,QAAI,qBAAqB;AACvB,uBAAiB,QAAQ,IAAI,mBAAmB;AAAA,IAClD;AAAA,EACF;AAEA,QAAM,UAAU,MAAM;AACpB,qBAAiB,QAAQ,QAAQ,CAAC,YAAY;AAC5C,UAAI,OAAO,YAAY,YAAY;AACjC,gBAAA;AAAA,MACF,WAAW,SAAS,SAAS;AAC3B,gBAAQ,QAAA;AAAA,MACV;AAAA,IACF,CAAC;AACD,qBAAiB,QAAQ,MAAA;AAGzB,UAAM,MAAM,IAAI;AAChB,QAAI,KAAK,SAAS;AAChB,UAAI,QAAQ,SAAS,MAAA;AACrB,UAAI,QAAQ,SAAS,MAAA;AAAA,IACvB;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,QAAA;AACpB;"}