@number10/jsx-phaser 5.0.0

package/dist/particles/emit-zone.js

@@ -0,0 +1,205 @@
+function resolveNumericSize(value) {
+  return typeof value === "number" ? value : void 0;
+}
+function resolveZoneSize(zone, fallback) {
+  const size = {};
+  const width = zone.width ?? fallback.width;
+  const height = zone.height ?? fallback.height;
+  if (width !== void 0) size.width = width;
+  if (height !== void 0) size.height = height;
+  return size;
+}
+function withPoint(point, x, y) {
+  if (point) {
+    point.x = x;
+    point.y = y;
+    return point;
+  }
+  return { x, y };
+}
+function createRectSource(x, y, width, height) {
+  return {
+    x,
+    y,
+    width,
+    height,
+    contains: (px, py) => px >= x && px <= x + width && py >= y && py <= y + height,
+    getRandomPoint: (point) => withPoint(point, x + Math.random() * width, y + Math.random() * height),
+    getPoints: (quantity = 1) => {
+      const count = Math.max(1, quantity);
+      return Array.from({ length: count }, (_, index) => {
+        const progress = count === 1 ? 0 : index / (count - 1);
+        const perimeter = 2 * (width + height);
+        const distance = progress * perimeter;
+        if (distance <= width) return { x: x + distance, y };
+        if (distance <= width + height) return { x: x + width, y: y + distance - width };
+        if (distance <= width * 2 + height) {
+          return { x: x + width - (distance - width - height), y: y + height };
+        }
+        return { x, y: y + height - (distance - width * 2 - height) };
+      });
+    }
+  };
+}
+function createCircleSource(x, y, radius) {
+  return {
+    x,
+    y,
+    radius,
+    contains: (px, py) => {
+      const dx = px - x;
+      const dy = py - y;
+      return dx * dx + dy * dy <= radius * radius;
+    },
+    getRandomPoint: (point) => {
+      const angle = Math.random() * Math.PI * 2;
+      const distance = Math.sqrt(Math.random()) * radius;
+      return withPoint(point, x + Math.cos(angle) * distance, y + Math.sin(angle) * distance);
+    },
+    getPoints: (quantity = 1) => {
+      const count = Math.max(1, quantity);
+      return Array.from({ length: count }, (_, index) => {
+        const angle = index / count * Math.PI * 2;
+        return { x: x + Math.cos(angle) * radius, y: y + Math.sin(angle) * radius };
+      });
+    }
+  };
+}
+function createEllipseSource(x, y, width, height) {
+  const radiusX = width / 2;
+  const radiusY = height / 2;
+  return {
+    x,
+    y,
+    width,
+    height,
+    contains: (px, py) => {
+      const dx = (px - x) / radiusX;
+      const dy = (py - y) / radiusY;
+      return dx * dx + dy * dy <= 1;
+    },
+    getRandomPoint: (point) => {
+      const angle = Math.random() * Math.PI * 2;
+      const distance = Math.sqrt(Math.random());
+      return withPoint(
+        point,
+        x + Math.cos(angle) * radiusX * distance,
+        y + Math.sin(angle) * radiusY * distance
+      );
+    },
+    getPoints: (quantity = 1) => {
+      const count = Math.max(1, quantity);
+      return Array.from({ length: count }, (_, index) => {
+        const angle = index / count * Math.PI * 2;
+        return { x: x + Math.cos(angle) * radiusX, y: y + Math.sin(angle) * radiusY };
+      });
+    }
+  };
+}
+function createLineSource(x, y, endX, endY) {
+  return {
+    x,
+    y,
+    contains: (px, py) => {
+      const lengthSquared = (endX - x) ** 2 + (endY - y) ** 2;
+      if (lengthSquared === 0) return px === x && py === y;
+      const progress = Math.max(
+        0,
+        Math.min(1, ((px - x) * (endX - x) + (py - y) * (endY - y)) / lengthSquared)
+      );
+      const closestX = x + progress * (endX - x);
+      const closestY = y + progress * (endY - y);
+      return Math.hypot(px - closestX, py - closestY) <= 0.5;
+    },
+    getRandomPoint: (point) => {
+      const progress = Math.random();
+      return withPoint(point, x + (endX - x) * progress, y + (endY - y) * progress);
+    },
+    getPoints: (quantity = 1) => {
+      const count = Math.max(1, quantity);
+      return Array.from({ length: count }, (_, index) => {
+        const progress = count === 1 ? 0 : index / (count - 1);
+        return { x: x + (endX - x) * progress, y: y + (endY - y) * progress };
+      });
+    }
+  };
+}
+function buildZoneSource(zone, fallbackSize) {
+  const baseX = zone.x ?? 0;
+  const baseY = zone.y ?? 0;
+  const { width, height } = resolveZoneSize(zone, fallbackSize);
+  switch (zone.shape) {
+    case "rect":
+      return createRectSource(baseX, baseY, width ?? 1, height ?? 1);
+    case "circle":
+      return createCircleSource(baseX, baseY, zone.radius ?? 1);
+    case "ellipse":
+      return createEllipseSource(baseX, baseY, width ?? 1, height ?? 1);
+    case "line":
+      return createLineSource(
+        baseX,
+        baseY,
+        zone.endX ?? baseX + (width ?? 1),
+        zone.endY ?? baseY + (height ?? 1)
+      );
+    default:
+      return void 0;
+  }
+}
+function getTransformOwner(value) {
+  if (!value || typeof value !== "object") return void 0;
+  if (typeof value.getWorldTransformMatrix !== "function") {
+    return void 0;
+  }
+  return value;
+}
+function createLocalDeathZoneSource(source, owner) {
+  const transformOwner = getTransformOwner(owner);
+  if (!transformOwner) return source;
+  return {
+    ...source,
+    contains: (worldX, worldY) => {
+      const matrix = transformOwner.getWorldTransformMatrix?.();
+      if (!matrix) return source.contains(worldX, worldY);
+      const localPoint = matrix.applyInverse(worldX, worldY);
+      return source.contains(localPoint.x, localPoint.y);
+    }
+  };
+}
+function buildEmitZone(zone, fallbackSize = {}) {
+  const type = zone.type ?? "random";
+  const source = buildZoneSource(zone, fallbackSize);
+  if (!source) return void 0;
+  return { type, source };
+}
+function buildEmitZoneFromLayout(zone, width, height) {
+  const fallback = {};
+  const resolvedWidth = resolveNumericSize(width);
+  const resolvedHeight = resolveNumericSize(height);
+  if (resolvedWidth !== void 0) fallback.width = resolvedWidth;
+  if (resolvedHeight !== void 0) fallback.height = resolvedHeight;
+  return buildEmitZone(zone, fallback);
+}
+function buildDeathZone(zone, fallbackSize = {}, owner) {
+  const type = zone.mode ?? "onEnter";
+  const source = buildZoneSource(zone, fallbackSize);
+  if (!source) return void 0;
+  return { type, source: createLocalDeathZoneSource(source, owner) };
+}
+function buildDeathZonesFromLayout(zones, width, height, owner) {
+  if (!zones) return void 0;
+  const list = Array.isArray(zones) ? zones : [zones];
+  const fallback = {};
+  const resolvedWidth = resolveNumericSize(width);
+  const resolvedHeight = resolveNumericSize(height);
+  if (resolvedWidth !== void 0) fallback.width = resolvedWidth;
+  if (resolvedHeight !== void 0) fallback.height = resolvedHeight;
+  const deathZones = list.map((zone) => buildDeathZone(zone, fallback, owner)).filter((zone) => Boolean(zone));
+  return deathZones.length > 0 ? deathZones : void 0;
+}
+export {
+  buildDeathZonesFromLayout,
+  buildEmitZone,
+  buildEmitZoneFromLayout
+};
+//# sourceMappingURL=emit-zone.js.map

package/dist/particles/emit-zone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-zone.js","sources":["../../src/particles/emit-zone.ts"],"sourcesContent":["/**\n * Emit zone helpers for particle emitters\n */\nimport type { SizeValue } from '../core-props'\n\n/**\n * Supported zone shapes\n */\nexport type ParticleZoneShape = 'rect' | 'circle' | 'ellipse' | 'line'\n\n/**\n * Supported death zone modes\n */\nexport type ParticleDeathZoneMode = 'onEnter' | 'onLeave'\n\ntype ZoneConfigBase = {\n  shape: ParticleZoneShape\n  width?: number\n  height?: number\n  radius?: number\n  x?: number\n  y?: number\n  endX?: number\n  endY?: number\n}\n\n/**\n * Emit zone config\n */\nexport interface ParticleZoneConfig extends ZoneConfigBase {\n  type?: 'random' | 'edge'\n}\n\n/**\n * Death zone config\n * Death zones use particle world positions for evaluation,\n * but coordinates should be specified relative to the emitter position\n */\nexport interface ParticleDeathZoneConfig extends ZoneConfigBase {\n  /**\n   * Death zone mode - evaluated using particle world positions.\n   * - onEnter: remove particles when they enter the zone.\n   * - onLeave: remove particles when they leave the zone.\n   */\n  mode?: ParticleDeathZoneMode\n}\n\n/**\n * @deprecated Use ParticleDeathZoneConfig.\n */\nexport type ParticleExclusionZoneConfig = ParticleDeathZoneConfig\n\ntype PointLike = { x: number; y: number }\ntype TransformMatrixLike = {\n  applyInverse: (x: number, y: number) => PointLike\n}\nexport type ParticleZoneTransformOwner = {\n  getWorldTransformMatrix?: () => TransformMatrixLike\n}\n\nexport type ParticleZoneSource = {\n  x?: number\n  y?: number\n  width?: number\n  height?: number\n  radius?: number\n  contains: (x: number, y: number) => boolean\n  getRandomPoint: (point?: PointLike) => PointLike\n  getPoints: (quantity?: number, stepRate?: number) => PointLike[]\n}\n\nexport type EmitZoneConfig = {\n  type: 'random' | 'edge'\n  source: ParticleZoneSource\n}\n\nexport type DeathZoneConfig = {\n  type: ParticleDeathZoneMode\n  source: ParticleZoneSource\n}\n\ntype ZoneSize = { width?: number; height?: number }\n\nfunction resolveNumericSize(value?: SizeValue): number | undefined {\n  return typeof value === 'number' ? value : undefined\n}\n\nfunction resolveZoneSize(zone: ZoneConfigBase, fallback: ZoneSize): ZoneSize {\n  const size: ZoneSize = {}\n  const width = zone.width ?? fallback.width\n  const height = zone.height ?? fallback.height\n  if (width !== undefined) size.width = width\n  if (height !== undefined) size.height = height\n  return size\n}\n\nfunction withPoint(point: PointLike | undefined, x: number, y: number): PointLike {\n  if (point) {\n    point.x = x\n    point.y = y\n    return point\n  }\n\n  return { x, y }\n}\n\nfunction createRectSource(x: number, y: number, width: number, height: number): ParticleZoneSource {\n  return {\n    x,\n    y,\n    width,\n    height,\n    contains: (px, py) => px >= x && px <= x + width && py >= y && py <= y + height,\n    getRandomPoint: (point) =>\n      withPoint(point, x + Math.random() * width, y + Math.random() * height),\n    getPoints: (quantity = 1) => {\n      const count = Math.max(1, quantity)\n      return Array.from({ length: count }, (_, index) => {\n        const progress = count === 1 ? 0 : index / (count - 1)\n        const perimeter = 2 * (width + height)\n        const distance = progress * perimeter\n\n        if (distance <= width) return { x: x + distance, y }\n        if (distance <= width + height) return { x: x + width, y: y + distance - width }\n        if (distance <= width * 2 + height) {\n          return { x: x + width - (distance - width - height), y: y + height }\n        }\n        return { x, y: y + height - (distance - width * 2 - height) }\n      })\n    },\n  }\n}\n\nfunction createCircleSource(x: number, y: number, radius: number): ParticleZoneSource {\n  return {\n    x,\n    y,\n    radius,\n    contains: (px, py) => {\n      const dx = px - x\n      const dy = py - y\n      return dx * dx + dy * dy <= radius * radius\n    },\n    getRandomPoint: (point) => {\n      const angle = Math.random() * Math.PI * 2\n      const distance = Math.sqrt(Math.random()) * radius\n      return withPoint(point, x + Math.cos(angle) * distance, y + Math.sin(angle) * distance)\n    },\n    getPoints: (quantity = 1) => {\n      const count = Math.max(1, quantity)\n      return Array.from({ length: count }, (_, index) => {\n        const angle = (index / count) * Math.PI * 2\n        return { x: x + Math.cos(angle) * radius, y: y + Math.sin(angle) * radius }\n      })\n    },\n  }\n}\n\nfunction createEllipseSource(\n  x: number,\n  y: number,\n  width: number,\n  height: number\n): ParticleZoneSource {\n  const radiusX = width / 2\n  const radiusY = height / 2\n\n  return {\n    x,\n    y,\n    width,\n    height,\n    contains: (px, py) => {\n      const dx = (px - x) / radiusX\n      const dy = (py - y) / radiusY\n      return dx * dx + dy * dy <= 1\n    },\n    getRandomPoint: (point) => {\n      const angle = Math.random() * Math.PI * 2\n      const distance = Math.sqrt(Math.random())\n      return withPoint(\n        point,\n        x + Math.cos(angle) * radiusX * distance,\n        y + Math.sin(angle) * radiusY * distance\n      )\n    },\n    getPoints: (quantity = 1) => {\n      const count = Math.max(1, quantity)\n      return Array.from({ length: count }, (_, index) => {\n        const angle = (index / count) * Math.PI * 2\n        return { x: x + Math.cos(angle) * radiusX, y: y + Math.sin(angle) * radiusY }\n      })\n    },\n  }\n}\n\nfunction createLineSource(x: number, y: number, endX: number, endY: number): ParticleZoneSource {\n  return {\n    x,\n    y,\n    contains: (px, py) => {\n      const lengthSquared = (endX - x) ** 2 + (endY - y) ** 2\n      if (lengthSquared === 0) return px === x && py === y\n\n      const progress = Math.max(\n        0,\n        Math.min(1, ((px - x) * (endX - x) + (py - y) * (endY - y)) / lengthSquared)\n      )\n      const closestX = x + progress * (endX - x)\n      const closestY = y + progress * (endY - y)\n      return Math.hypot(px - closestX, py - closestY) <= 0.5\n    },\n    getRandomPoint: (point) => {\n      const progress = Math.random()\n      return withPoint(point, x + (endX - x) * progress, y + (endY - y) * progress)\n    },\n    getPoints: (quantity = 1) => {\n      const count = Math.max(1, quantity)\n      return Array.from({ length: count }, (_, index) => {\n        const progress = count === 1 ? 0 : index / (count - 1)\n        return { x: x + (endX - x) * progress, y: y + (endY - y) * progress }\n      })\n    },\n  }\n}\n\nfunction buildZoneSource(\n  zone: ZoneConfigBase,\n  fallbackSize: ZoneSize\n): ParticleZoneSource | undefined {\n  const baseX = zone.x ?? 0\n  const baseY = zone.y ?? 0\n  const { width, height } = resolveZoneSize(zone, fallbackSize)\n\n  switch (zone.shape) {\n    case 'rect':\n      return createRectSource(baseX, baseY, width ?? 1, height ?? 1)\n    case 'circle':\n      return createCircleSource(baseX, baseY, zone.radius ?? 1)\n    case 'ellipse':\n      return createEllipseSource(baseX, baseY, width ?? 1, height ?? 1)\n    case 'line':\n      return createLineSource(\n        baseX,\n        baseY,\n        zone.endX ?? baseX + (width ?? 1),\n        zone.endY ?? baseY + (height ?? 1)\n      )\n    default:\n      return undefined\n  }\n}\n\nfunction getTransformOwner(value: unknown): ParticleZoneTransformOwner | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  if (typeof (value as ParticleZoneTransformOwner).getWorldTransformMatrix !== 'function') {\n    return undefined\n  }\n  return value as ParticleZoneTransformOwner\n}\n\nfunction createLocalDeathZoneSource(\n  source: ParticleZoneSource,\n  owner?: unknown\n): ParticleZoneSource {\n  const transformOwner = getTransformOwner(owner)\n  if (!transformOwner) return source\n\n  return {\n    ...source,\n    contains: (worldX, worldY) => {\n      const matrix = transformOwner.getWorldTransformMatrix?.()\n      if (!matrix) return source.contains(worldX, worldY)\n\n      const localPoint = matrix.applyInverse(worldX, worldY)\n      return source.contains(localPoint.x, localPoint.y)\n    },\n  }\n}\n\n/**\n * Build a Phaser emitZone config from a lightweight zone definition\n */\nexport function buildEmitZone(\n  zone: ParticleZoneConfig,\n  fallbackSize: ZoneSize = {}\n): EmitZoneConfig | undefined {\n  const type = zone.type ?? 'random'\n  const source = buildZoneSource(zone, fallbackSize)\n\n  if (!source) return undefined\n\n  return { type, source }\n}\n\n/**\n * Create an emit zone using layout size as a fallback\n */\nexport function buildEmitZoneFromLayout(\n  zone: ParticleZoneConfig,\n  width?: SizeValue,\n  height?: SizeValue\n): EmitZoneConfig | undefined {\n  const fallback: ZoneSize = {}\n  const resolvedWidth = resolveNumericSize(width)\n  const resolvedHeight = resolveNumericSize(height)\n  if (resolvedWidth !== undefined) fallback.width = resolvedWidth\n  if (resolvedHeight !== undefined) fallback.height = resolvedHeight\n  return buildEmitZone(zone, fallback)\n}\n\n/**\n * Build a Phaser deathZone config from a lightweight death zone definition\n */\nfunction buildDeathZone(\n  zone: ParticleDeathZoneConfig,\n  fallbackSize: ZoneSize = {},\n  owner?: unknown\n): DeathZoneConfig | undefined {\n  const type = zone.mode ?? 'onEnter'\n  const source = buildZoneSource(zone, fallbackSize)\n\n  if (!source) return undefined\n\n  return { type, source: createLocalDeathZoneSource(source, owner) }\n}\n\n/**\n * Create death zones using layout size as a fallback\n */\nexport function buildDeathZonesFromLayout(\n  zones: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined,\n  width?: SizeValue,\n  height?: SizeValue,\n  owner?: unknown\n): DeathZoneConfig[] | undefined {\n  if (!zones) return undefined\n  const list = Array.isArray(zones) ? zones : [zones]\n  const fallback: ZoneSize = {}\n  const resolvedWidth = resolveNumericSize(width)\n  const resolvedHeight = resolveNumericSize(height)\n  if (resolvedWidth !== undefined) fallback.width = resolvedWidth\n  if (resolvedHeight !== undefined) fallback.height = resolvedHeight\n\n  const deathZones = list\n    .map((zone) => buildDeathZone(zone, fallback, owner))\n    .filter((zone): zone is DeathZoneConfig => Boolean(zone))\n\n  return deathZones.length > 0 ? deathZones : undefined\n}\n"],"names":[],"mappings":"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"}

package/dist/particles/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Particle system utilities and presets
+ */
+export { PARTICLE_PRESET_REGISTRY, resolveParticlePreset, type BuiltInParticlePresetName, type ParticleEmitterConfig, type ParticlePresetDefinition, type ParticlePresetExtensions, type ParticlePresetName, } from './preset-registry';
+export { buildDeathZonesFromLayout, buildEmitZone, buildEmitZoneFromLayout, type DeathZoneConfig, type EmitZoneConfig, type ParticleDeathZoneConfig, type ParticleDeathZoneMode, type ParticleExclusionZoneConfig, type ParticleZoneTransformOwner, type ParticleZoneSource, type ParticleZoneConfig, type ParticleZoneShape, } from './emit-zone';
+export type { ParticleEmitter, ParticleEmitterManagerLike, ParticlesHandle } from './particle-types';
+export { useParticles } from './use-particles';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/particles/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/particles/particle-types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Local particle types to avoid reliance on Phaser type exports
+ */
+import type * as Phaser from 'phaser';
+export type ParticleEmitter = Phaser.GameObjects.Particles.ParticleEmitter;
+export type ParticleEmitterManagerLike = Phaser.GameObjects.GameObject & {
+    x: number;
+    y: number;
+    emitters?: ParticleEmitter[] | {
+        list?: ParticleEmitter[];
+    };
+    createEmitter?: (config: unknown) => ParticleEmitter | void;
+    setTexture?: (key: string, frame?: string | number) => void;
+    setPosition?: (x: number, y: number) => void;
+    setScale: (x: number, y?: number) => void;
+    setRotation: (rotation: number) => void;
+    setDepth: (depth: number) => void;
+    setAlpha: (alpha: number) => void;
+    visible: boolean;
+    __emitter?: ParticleEmitter | null;
+    destroy: () => void;
+    scene: Phaser.Scene;
+};
+export type ParticlesHandle = ParticleEmitter | ParticleEmitterManagerLike;
+//# sourceMappingURL=particle-types.d.ts.map

package/dist/particles/particle-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-types.d.ts","sourceRoot":"","sources":["../../src/particles/particle-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AAErC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,eAAe,CAAA;AAE1E,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG;IACvE,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,QAAQ,CAAC,EAAE,eAAe,EAAE,GAAG;QAAE,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,CAAA;IAC3D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,eAAe,GAAG,IAAI,CAAA;IAC3D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;IAC3D,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,0BAA0B,CAAA"}

package/dist/particles/preset-registry.cjs

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PARTICLE_PRESET_REGISTRY = {
+  explosion: {
+    speed: { min: 120, max: 320 },
+    scale: { start: 1, end: 0 },
+    alpha: { start: 1, end: 0 },
+    lifespan: 600,
+    quantity: 24,
+    blendMode: "ADD"
+  },
+  trail: {
+    speed: { min: 30, max: 80 },
+    scale: { start: 0.6, end: 0 },
+    alpha: { start: 0.8, end: 0 },
+    lifespan: 700,
+    frequency: 40
+  },
+  rain: {
+    speed: { min: 320, max: 520 },
+    angle: { min: 80, max: 100 },
+    scale: { start: 0.5, end: 0.2 },
+    alpha: { start: 0.6, end: 0.1 },
+    lifespan: 1e3,
+    frequency: 20
+  },
+  snow: {
+    speed: { min: 40, max: 120 },
+    angle: { min: 80, max: 100 },
+    gravityY: 8,
+    scale: { start: 0.6, end: 0.6 },
+    alpha: { start: 0.8, end: 0.3 },
+    lifespan: 2600,
+    frequency: 80
+  },
+  sparkle: {
+    speed: { min: 20, max: 60 },
+    scale: { start: 0.4, end: 0 },
+    alpha: { start: 1, end: 0 },
+    lifespan: 500,
+    frequency: 60,
+    blendMode: "ADD"
+  }
+};
+function resolveParticlePreset(preset, config = {}) {
+  const base = preset ? PARTICLE_PRESET_REGISTRY[preset] : void 0;
+  if (preset && !base) {
+    console.warn(`[Particles] Preset "${String(preset)}" not found in registry`);
+  }
+  return {
+    ...base ?? {},
+    ...config
+  };
+}
+exports.PARTICLE_PRESET_REGISTRY = PARTICLE_PRESET_REGISTRY;
+exports.resolveParticlePreset = resolveParticlePreset;
+//# sourceMappingURL=preset-registry.cjs.map

package/dist/particles/preset-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-registry.cjs","sources":["../../src/particles/preset-registry.ts"],"sourcesContent":["/**\n * Particle preset registry - typed presets with extension support\n */\nimport type * as Phaser from 'phaser'\n\n/**\n * Built-in particle preset names\n */\nexport type BuiltInParticlePresetName = 'explosion' | 'trail' | 'rain' | 'snow' | 'sparkle'\n\n/**\n * Extension point for custom particle preset names\n * Use declaration merging to add custom presets:\n * @example\n * ```typescript\n * declare module '@number10/phaserjsx' {\n *   interface ParticlePresetExtensions {\n *     myPreset: 'myPreset'\n *   }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface ParticlePresetExtensions {}\n\n/**\n * Available particle preset names (built-in + extensions)\n */\nexport type ParticlePresetName =\n  | BuiltInParticlePresetName\n  | (keyof ParticlePresetExtensions extends never ? never : keyof ParticlePresetExtensions)\n\n/**\n * Phaser emitter config alias\n */\nexport type ParticleEmitterConfig = Phaser.Types.GameObjects.Particles.ParticleEmitterConfig\n\n/**\n * Preset definition for component/theme props\n */\nexport interface ParticlePresetDefinition {\n  preset?: ParticlePresetName\n  config?: ParticleEmitterConfig\n}\n\n/**\n * Map of built-in particle presets to emitter configs\n */\nexport const PARTICLE_PRESET_REGISTRY: Record<BuiltInParticlePresetName, ParticleEmitterConfig> = {\n  explosion: {\n    speed: { min: 120, max: 320 },\n    scale: { start: 1, end: 0 },\n    alpha: { start: 1, end: 0 },\n    lifespan: 600,\n    quantity: 24,\n    blendMode: 'ADD',\n  },\n  trail: {\n    speed: { min: 30, max: 80 },\n    scale: { start: 0.6, end: 0 },\n    alpha: { start: 0.8, end: 0 },\n    lifespan: 700,\n    frequency: 40,\n  },\n  rain: {\n    speed: { min: 320, max: 520 },\n    angle: { min: 80, max: 100 },\n    scale: { start: 0.5, end: 0.2 },\n    alpha: { start: 0.6, end: 0.1 },\n    lifespan: 1000,\n    frequency: 20,\n  },\n  snow: {\n    speed: { min: 40, max: 120 },\n    angle: { min: 80, max: 100 },\n    gravityY: 8,\n    scale: { start: 0.6, end: 0.6 },\n    alpha: { start: 0.8, end: 0.3 },\n    lifespan: 2600,\n    frequency: 80,\n  },\n  sparkle: {\n    speed: { min: 20, max: 60 },\n    scale: { start: 0.4, end: 0 },\n    alpha: { start: 1, end: 0 },\n    lifespan: 500,\n    frequency: 60,\n    blendMode: 'ADD',\n  },\n}\n\n/**\n * Resolve a preset name with optional overrides\n * @param preset - Preset name (built-in or extension)\n * @param config - Optional overrides applied last\n * @returns Resolved emitter config\n */\nexport function resolveParticlePreset(\n  preset?: ParticlePresetName,\n  config: ParticleEmitterConfig = {}\n): ParticleEmitterConfig {\n  const base = preset ? PARTICLE_PRESET_REGISTRY[preset as BuiltInParticlePresetName] : undefined\n\n  if (preset && !base) {\n    console.warn(`[Particles] Preset \"${String(preset)}\" not found in registry`)\n  }\n\n  return {\n    ...(base ?? {}),\n    ...config,\n  }\n}\n"],"names":[],"mappings":";;AAgDO,MAAM,2BAAqF;AAAA,EAChG,WAAW;AAAA,IACT,OAAO,EAAE,KAAK,KAAK,KAAK,IAAA;AAAA,IACxB,OAAO,EAAE,OAAO,GAAG,KAAK,EAAA;AAAA,IACxB,OAAO,EAAE,OAAO,GAAG,KAAK,EAAA;AAAA,IACxB,UAAU;AAAA,IACV,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,OAAO;AAAA,IACL,OAAO,EAAE,KAAK,IAAI,KAAK,GAAA;AAAA,IACvB,OAAO,EAAE,OAAO,KAAK,KAAK,EAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,KAAK,KAAK,EAAA;AAAA,IAC1B,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,MAAM;AAAA,IACJ,OAAO,EAAE,KAAK,KAAK,KAAK,IAAA;AAAA,IACxB,OAAO,EAAE,KAAK,IAAI,KAAK,IAAA;AAAA,IACvB,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,MAAM;AAAA,IACJ,OAAO,EAAE,KAAK,IAAI,KAAK,IAAA;AAAA,IACvB,OAAO,EAAE,KAAK,IAAI,KAAK,IAAA;AAAA,IACvB,UAAU;AAAA,IACV,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,SAAS;AAAA,IACP,OAAO,EAAE,KAAK,IAAI,KAAK,GAAA;AAAA,IACvB,OAAO,EAAE,OAAO,KAAK,KAAK,EAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,GAAG,KAAK,EAAA;AAAA,IACxB,UAAU;AAAA,IACV,WAAW;AAAA,IACX,WAAW;AAAA,EAAA;AAEf;AAQO,SAAS,sBACd,QACA,SAAgC,IACT;AACvB,QAAM,OAAO,SAAS,yBAAyB,MAAmC,IAAI;AAEtF,MAAI,UAAU,CAAC,MAAM;AACnB,YAAQ,KAAK,uBAAuB,OAAO,MAAM,CAAC,yBAAyB;AAAA,EAC7E;AAEA,SAAO;AAAA,IACL,GAAI,QAAQ,CAAA;AAAA,IACZ,GAAG;AAAA,EAAA;AAEP;;;"}

package/dist/particles/preset-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Particle preset registry - typed presets with extension support
+ */
+import type * as Phaser from 'phaser';
+/**
+ * Built-in particle preset names
+ */
+export type BuiltInParticlePresetName = 'explosion' | 'trail' | 'rain' | 'snow' | 'sparkle';
+/**
+ * Extension point for custom particle preset names
+ * Use declaration merging to add custom presets:
+ * @example
+ * ```typescript
+ * declare module '@number10/phaserjsx' {
+ *   interface ParticlePresetExtensions {
+ *     myPreset: 'myPreset'
+ *   }
+ * }
+ * ```
+ */
+export interface ParticlePresetExtensions {
+}
+/**
+ * Available particle preset names (built-in + extensions)
+ */
+export type ParticlePresetName = BuiltInParticlePresetName | (keyof ParticlePresetExtensions extends never ? never : keyof ParticlePresetExtensions);
+/**
+ * Phaser emitter config alias
+ */
+export type ParticleEmitterConfig = Phaser.Types.GameObjects.Particles.ParticleEmitterConfig;
+/**
+ * Preset definition for component/theme props
+ */
+export interface ParticlePresetDefinition {
+    preset?: ParticlePresetName;
+    config?: ParticleEmitterConfig;
+}
+/**
+ * Map of built-in particle presets to emitter configs
+ */
+export declare const PARTICLE_PRESET_REGISTRY: Record<BuiltInParticlePresetName, ParticleEmitterConfig>;
+/**
+ * Resolve a preset name with optional overrides
+ * @param preset - Preset name (built-in or extension)
+ * @param config - Optional overrides applied last
+ * @returns Resolved emitter config
+ */
+export declare function resolveParticlePreset(preset?: ParticlePresetName, config?: ParticleEmitterConfig): ParticleEmitterConfig;
+//# sourceMappingURL=preset-registry.d.ts.map

package/dist/particles/preset-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-registry.d.ts","sourceRoot":"","sources":["../../src/particles/preset-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AAErC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;AAE3F;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,wBAAwB;CAAG;AAE5C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,yBAAyB,GACzB,CAAC,MAAM,wBAAwB,SAAS,KAAK,GAAG,KAAK,GAAG,MAAM,wBAAwB,CAAC,CAAA;AAE3F;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,qBAAqB,CAAA;AAE5F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAA;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,yBAAyB,EAAE,qBAAqB,CAyC7F,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,kBAAkB,EAC3B,MAAM,GAAE,qBAA0B,GACjC,qBAAqB,CAWvB"}

package/dist/particles/preset-registry.js

@@ -0,0 +1,57 @@
+const PARTICLE_PRESET_REGISTRY = {
+  explosion: {
+    speed: { min: 120, max: 320 },
+    scale: { start: 1, end: 0 },
+    alpha: { start: 1, end: 0 },
+    lifespan: 600,
+    quantity: 24,
+    blendMode: "ADD"
+  },
+  trail: {
+    speed: { min: 30, max: 80 },
+    scale: { start: 0.6, end: 0 },
+    alpha: { start: 0.8, end: 0 },
+    lifespan: 700,
+    frequency: 40
+  },
+  rain: {
+    speed: { min: 320, max: 520 },
+    angle: { min: 80, max: 100 },
+    scale: { start: 0.5, end: 0.2 },
+    alpha: { start: 0.6, end: 0.1 },
+    lifespan: 1e3,
+    frequency: 20
+  },
+  snow: {
+    speed: { min: 40, max: 120 },
+    angle: { min: 80, max: 100 },
+    gravityY: 8,
+    scale: { start: 0.6, end: 0.6 },
+    alpha: { start: 0.8, end: 0.3 },
+    lifespan: 2600,
+    frequency: 80
+  },
+  sparkle: {
+    speed: { min: 20, max: 60 },
+    scale: { start: 0.4, end: 0 },
+    alpha: { start: 1, end: 0 },
+    lifespan: 500,
+    frequency: 60,
+    blendMode: "ADD"
+  }
+};
+function resolveParticlePreset(preset, config = {}) {
+  const base = preset ? PARTICLE_PRESET_REGISTRY[preset] : void 0;
+  if (preset && !base) {
+    console.warn(`[Particles] Preset "${String(preset)}" not found in registry`);
+  }
+  return {
+    ...base ?? {},
+    ...config
+  };
+}
+export {
+  PARTICLE_PRESET_REGISTRY,
+  resolveParticlePreset
+};
+//# sourceMappingURL=preset-registry.js.map

package/dist/particles/preset-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-registry.js","sources":["../../src/particles/preset-registry.ts"],"sourcesContent":["/**\n * Particle preset registry - typed presets with extension support\n */\nimport type * as Phaser from 'phaser'\n\n/**\n * Built-in particle preset names\n */\nexport type BuiltInParticlePresetName = 'explosion' | 'trail' | 'rain' | 'snow' | 'sparkle'\n\n/**\n * Extension point for custom particle preset names\n * Use declaration merging to add custom presets:\n * @example\n * ```typescript\n * declare module '@number10/phaserjsx' {\n *   interface ParticlePresetExtensions {\n *     myPreset: 'myPreset'\n *   }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface ParticlePresetExtensions {}\n\n/**\n * Available particle preset names (built-in + extensions)\n */\nexport type ParticlePresetName =\n  | BuiltInParticlePresetName\n  | (keyof ParticlePresetExtensions extends never ? never : keyof ParticlePresetExtensions)\n\n/**\n * Phaser emitter config alias\n */\nexport type ParticleEmitterConfig = Phaser.Types.GameObjects.Particles.ParticleEmitterConfig\n\n/**\n * Preset definition for component/theme props\n */\nexport interface ParticlePresetDefinition {\n  preset?: ParticlePresetName\n  config?: ParticleEmitterConfig\n}\n\n/**\n * Map of built-in particle presets to emitter configs\n */\nexport const PARTICLE_PRESET_REGISTRY: Record<BuiltInParticlePresetName, ParticleEmitterConfig> = {\n  explosion: {\n    speed: { min: 120, max: 320 },\n    scale: { start: 1, end: 0 },\n    alpha: { start: 1, end: 0 },\n    lifespan: 600,\n    quantity: 24,\n    blendMode: 'ADD',\n  },\n  trail: {\n    speed: { min: 30, max: 80 },\n    scale: { start: 0.6, end: 0 },\n    alpha: { start: 0.8, end: 0 },\n    lifespan: 700,\n    frequency: 40,\n  },\n  rain: {\n    speed: { min: 320, max: 520 },\n    angle: { min: 80, max: 100 },\n    scale: { start: 0.5, end: 0.2 },\n    alpha: { start: 0.6, end: 0.1 },\n    lifespan: 1000,\n    frequency: 20,\n  },\n  snow: {\n    speed: { min: 40, max: 120 },\n    angle: { min: 80, max: 100 },\n    gravityY: 8,\n    scale: { start: 0.6, end: 0.6 },\n    alpha: { start: 0.8, end: 0.3 },\n    lifespan: 2600,\n    frequency: 80,\n  },\n  sparkle: {\n    speed: { min: 20, max: 60 },\n    scale: { start: 0.4, end: 0 },\n    alpha: { start: 1, end: 0 },\n    lifespan: 500,\n    frequency: 60,\n    blendMode: 'ADD',\n  },\n}\n\n/**\n * Resolve a preset name with optional overrides\n * @param preset - Preset name (built-in or extension)\n * @param config - Optional overrides applied last\n * @returns Resolved emitter config\n */\nexport function resolveParticlePreset(\n  preset?: ParticlePresetName,\n  config: ParticleEmitterConfig = {}\n): ParticleEmitterConfig {\n  const base = preset ? PARTICLE_PRESET_REGISTRY[preset as BuiltInParticlePresetName] : undefined\n\n  if (preset && !base) {\n    console.warn(`[Particles] Preset \"${String(preset)}\" not found in registry`)\n  }\n\n  return {\n    ...(base ?? {}),\n    ...config,\n  }\n}\n"],"names":[],"mappings":"AAgDO,MAAM,2BAAqF;AAAA,EAChG,WAAW;AAAA,IACT,OAAO,EAAE,KAAK,KAAK,KAAK,IAAA;AAAA,IACxB,OAAO,EAAE,OAAO,GAAG,KAAK,EAAA;AAAA,IACxB,OAAO,EAAE,OAAO,GAAG,KAAK,EAAA;AAAA,IACxB,UAAU;AAAA,IACV,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,OAAO;AAAA,IACL,OAAO,EAAE,KAAK,IAAI,KAAK,GAAA;AAAA,IACvB,OAAO,EAAE,OAAO,KAAK,KAAK,EAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,KAAK,KAAK,EAAA;AAAA,IAC1B,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,MAAM;AAAA,IACJ,OAAO,EAAE,KAAK,KAAK,KAAK,IAAA;AAAA,IACxB,OAAO,EAAE,KAAK,IAAI,KAAK,IAAA;AAAA,IACvB,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,MAAM;AAAA,IACJ,OAAO,EAAE,KAAK,IAAI,KAAK,IAAA;AAAA,IACvB,OAAO,EAAE,KAAK,IAAI,KAAK,IAAA;AAAA,IACvB,UAAU;AAAA,IACV,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,KAAK,KAAK,IAAA;AAAA,IAC1B,UAAU;AAAA,IACV,WAAW;AAAA,EAAA;AAAA,EAEb,SAAS;AAAA,IACP,OAAO,EAAE,KAAK,IAAI,KAAK,GAAA;AAAA,IACvB,OAAO,EAAE,OAAO,KAAK,KAAK,EAAA;AAAA,IAC1B,OAAO,EAAE,OAAO,GAAG,KAAK,EAAA;AAAA,IACxB,UAAU;AAAA,IACV,WAAW;AAAA,IACX,WAAW;AAAA,EAAA;AAEf;AAQO,SAAS,sBACd,QACA,SAAgC,IACT;AACvB,QAAM,OAAO,SAAS,yBAAyB,MAAmC,IAAI;AAEtF,MAAI,UAAU,CAAC,MAAM;AACnB,YAAQ,KAAK,uBAAuB,OAAO,MAAM,CAAC,yBAAyB;AAAA,EAC7E;AAEA,SAAO;AAAA,IACL,GAAI,QAAQ,CAAA;AAAA,IACZ,GAAG;AAAA,EAAA;AAEP;"}

package/dist/particles/use-particles.cjs

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../hooks.cjs");
+const emitZone = require("./emit-zone.cjs");
+const utils = require("./utils.cjs");
+const jsxCore = require("@number10/jsx-core");
+function useParticles(ref) {
+  const getManager = jsxCore.useCallback(() => ref.current ?? null, [ref]);
+  const getEmitter = jsxCore.useCallback(() => {
+    const current = ref.current;
+    if (!current) return null;
+    if (utils.isParticleEmitter(current)) return current;
+    return utils.getFirstEmitter(current);
+  }, [ref]);
+  const start = jsxCore.useCallback(() => {
+    const emitter = getEmitter();
+    emitter?.start();
+  }, [getEmitter]);
+  const stop = jsxCore.useCallback(() => {
+    const emitter = getEmitter();
+    emitter?.stop();
+  }, [getEmitter]);
+  const explode = jsxCore.useCallback(
+    (count, x, y) => {
+      const emitter = getEmitter();
+      emitter?.explode(count, x, y);
+    },
+    [getEmitter]
+  );
+  const setConfig = jsxCore.useCallback(
+    (config) => {
+      const emitter = getEmitter();
+      utils.applyEmitterConfig(emitter, config);
+    },
+    [getEmitter]
+  );
+  const setEmitZone = jsxCore.useCallback(
+    (zone, width, height) => {
+      const emitter = getEmitter();
+      const emitZone$1 = emitZone.buildEmitZoneFromLayout(zone, width, height);
+      utils.applyEmitZone(emitter, emitZone$1);
+    },
+    [getEmitter]
+  );
+  const setDeathZones = jsxCore.useCallback(
+    (zones, width, height) => {
+      const emitter = getEmitter();
+      const manager = getManager();
+      const deathZones = emitZone.buildDeathZonesFromLayout(zones, width, height, manager ?? void 0);
+      utils.applyDeathZone(emitter, deathZones);
+    },
+    [getEmitter, getManager]
+  );
+  return {
+    getManager,
+    getEmitter,
+    start,
+    stop,
+    explode,
+    setConfig,
+    setEmitZone,
+    setDeathZones,
+    setExcludeZones: setDeathZones
+  };
+}
+exports.useParticles = useParticles;
+//# sourceMappingURL=use-particles.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-particles.cjs","sources":["../../src/particles/use-particles.ts"],"sourcesContent":["/**\n * Hook for imperative particle control\n */\nimport { useCallback } from '../hooks'\nimport type { RefObject } from '../types'\nimport {\n  buildDeathZonesFromLayout,\n  buildEmitZoneFromLayout,\n  type ParticleDeathZoneConfig,\n  type ParticleZoneConfig,\n} from './emit-zone'\nimport type { ParticleEmitter, ParticleEmitterManagerLike, ParticlesHandle } from './particle-types'\nimport type { ParticleEmitterConfig } from './preset-registry'\nimport {\n  applyDeathZone,\n  applyEmitZone,\n  applyEmitterConfig,\n  getFirstEmitter,\n  isParticleEmitter,\n} from './utils'\n\nexport function useParticles(ref: RefObject<ParticlesHandle | null>): {\n  getManager: () => ParticlesHandle | null\n  getEmitter: () => ParticleEmitter | null\n  start: () => void\n  stop: () => void\n  explode: (count: number, x?: number, y?: number) => void\n  setConfig: (config: ParticleEmitterConfig) => void\n  setEmitZone: (zone: ParticleZoneConfig, width?: number, height?: number) => void\n  setDeathZones: (\n    zones: ParticleDeathZoneConfig | ParticleDeathZoneConfig[],\n    width?: number,\n    height?: number\n  ) => void\n  /**\n   * @deprecated Use setDeathZones.\n   */\n  setExcludeZones: (\n    zones: ParticleDeathZoneConfig | ParticleDeathZoneConfig[],\n    width?: number,\n    height?: number\n  ) => void\n} {\n  const getManager = useCallback(() => ref.current ?? null, [ref])\n  const getEmitter = useCallback(() => {\n    const current = ref.current\n    if (!current) return null\n    if (isParticleEmitter(current)) return current\n    return getFirstEmitter(current as ParticleEmitterManagerLike)\n  }, [ref])\n\n  const start = useCallback(() => {\n    const emitter = getEmitter()\n    emitter?.start()\n  }, [getEmitter])\n\n  const stop = useCallback(() => {\n    const emitter = getEmitter()\n    emitter?.stop()\n  }, [getEmitter])\n\n  const explode = useCallback(\n    (count: number, x?: number, y?: number) => {\n      const emitter = getEmitter()\n      emitter?.explode(count, x, y)\n    },\n    [getEmitter]\n  )\n\n  const setConfig = useCallback(\n    (config: ParticleEmitterConfig) => {\n      const emitter = getEmitter()\n      applyEmitterConfig(emitter, config)\n    },\n    [getEmitter]\n  )\n\n  const setEmitZone = useCallback(\n    (zone: ParticleZoneConfig, width?: number, height?: number) => {\n      const emitter = getEmitter()\n      const emitZone = buildEmitZoneFromLayout(zone, width, height)\n      applyEmitZone(emitter, emitZone)\n    },\n    [getEmitter]\n  )\n\n  const setDeathZones = useCallback(\n    (\n      zones: ParticleDeathZoneConfig | ParticleDeathZoneConfig[],\n      width?: number,\n      height?: number\n    ) => {\n      const emitter = getEmitter()\n      const manager = getManager()\n      const deathZones = buildDeathZonesFromLayout(zones, width, height, manager ?? undefined)\n      applyDeathZone(emitter, deathZones)\n    },\n    [getEmitter, getManager]\n  )\n\n  return {\n    getManager,\n    getEmitter,\n    start,\n    stop,\n    explode,\n    setConfig,\n    setEmitZone,\n    setDeathZones,\n    setExcludeZones: setDeathZones,\n  }\n}\n"],"names":["useCallback","isParticleEmitter","getFirstEmitter","applyEmitterConfig","emitZone","buildEmitZoneFromLayout","applyEmitZone","buildDeathZonesFromLayout","applyDeathZone"],"mappings":";;;;;;AAqBO,SAAS,aAAa,KAqB3B;AACA,QAAM,aAAaA,QAAAA,YAAY,MAAM,IAAI,WAAW,MAAM,CAAC,GAAG,CAAC;AAC/D,QAAM,aAAaA,QAAAA,YAAY,MAAM;AACnC,UAAM,UAAU,IAAI;AACpB,QAAI,CAAC,QAAS,QAAO;AACrB,QAAIC,MAAAA,kBAAkB,OAAO,EAAG,QAAO;AACvC,WAAOC,MAAAA,gBAAgB,OAAqC;AAAA,EAC9D,GAAG,CAAC,GAAG,CAAC;AAER,QAAM,QAAQF,QAAAA,YAAY,MAAM;AAC9B,UAAM,UAAU,WAAA;AAChB,aAAS,MAAA;AAAA,EACX,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,OAAOA,QAAAA,YAAY,MAAM;AAC7B,UAAM,UAAU,WAAA;AAChB,aAAS,KAAA;AAAA,EACX,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,UAAUA,QAAAA;AAAAA,IACd,CAAC,OAAe,GAAY,MAAe;AACzC,YAAM,UAAU,WAAA;AAChB,eAAS,QAAQ,OAAO,GAAG,CAAC;AAAA,IAC9B;AAAA,IACA,CAAC,UAAU;AAAA,EAAA;AAGb,QAAM,YAAYA,QAAAA;AAAAA,IAChB,CAAC,WAAkC;AACjC,YAAM,UAAU,WAAA;AAChBG,YAAAA,mBAAmB,SAAS,MAAM;AAAA,IACpC;AAAA,IACA,CAAC,UAAU;AAAA,EAAA;AAGb,QAAM,cAAcH,QAAAA;AAAAA,IAClB,CAAC,MAA0B,OAAgB,WAAoB;AAC7D,YAAM,UAAU,WAAA;AAChB,YAAMI,aAAWC,SAAAA,wBAAwB,MAAM,OAAO,MAAM;AAC5DC,YAAAA,cAAc,SAASF,UAAQ;AAAA,IACjC;AAAA,IACA,CAAC,UAAU;AAAA,EAAA;AAGb,QAAM,gBAAgBJ,QAAAA;AAAAA,IACpB,CACE,OACA,OACA,WACG;AACH,YAAM,UAAU,WAAA;AAChB,YAAM,UAAU,WAAA;AAChB,YAAM,aAAaO,SAAAA,0BAA0B,OAAO,OAAO,QAAQ,WAAW,MAAS;AACvFC,YAAAA,eAAe,SAAS,UAAU;AAAA,IACpC;AAAA,IACA,CAAC,YAAY,UAAU;AAAA,EAAA;AAGzB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,iBAAiB;AAAA,EAAA;AAErB;;"}

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

@@ -0,0 +1,19 @@
+import { RefObject } from '../types';
+import { ParticleDeathZoneConfig, ParticleZoneConfig } from './emit-zone';
+import { ParticleEmitter, ParticlesHandle } from './particle-types';
+import { ParticleEmitterConfig } from './preset-registry';
+export declare function useParticles(ref: RefObject<ParticlesHandle | null>): {
+    getManager: () => ParticlesHandle | null;
+    getEmitter: () => ParticleEmitter | null;
+    start: () => void;
+    stop: () => void;
+    explode: (count: number, x?: number, y?: number) => void;
+    setConfig: (config: ParticleEmitterConfig) => void;
+    setEmitZone: (zone: ParticleZoneConfig, width?: number, height?: number) => void;
+    setDeathZones: (zones: ParticleDeathZoneConfig | ParticleDeathZoneConfig[], width?: number, height?: number) => void;
+    /**
+     * @deprecated Use setDeathZones.
+     */
+    setExcludeZones: (zones: ParticleDeathZoneConfig | ParticleDeathZoneConfig[], width?: number, height?: number) => void;
+};
+//# sourceMappingURL=use-particles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-particles.d.ts","sourceRoot":"","sources":["../../src/particles/use-particles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,eAAe,EAA8B,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACpG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAS9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG;IACpE,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;IACxC,UAAU,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;IACxC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACxD,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAA;IAClD,WAAW,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAChF,aAAa,EAAE,CACb,KAAK,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,EAC1D,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,IAAI,CAAA;IACT;;OAEG;IACH,eAAe,EAAE,CACf,KAAK,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,EAC1D,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,IAAI,CAAA;CACV,CAqEA"}

package/dist/particles/use-particles.js

@@ -0,0 +1,67 @@
+import "../hooks.js";
+import { buildEmitZoneFromLayout, buildDeathZonesFromLayout } from "./emit-zone.js";
+import { isParticleEmitter, getFirstEmitter, applyEmitterConfig, applyEmitZone, applyDeathZone } from "./utils.js";
+import { useCallback } from "@number10/jsx-core";
+function useParticles(ref) {
+  const getManager = useCallback(() => ref.current ?? null, [ref]);
+  const getEmitter = useCallback(() => {
+    const current = ref.current;
+    if (!current) return null;
+    if (isParticleEmitter(current)) return current;
+    return getFirstEmitter(current);
+  }, [ref]);
+  const start = useCallback(() => {
+    const emitter = getEmitter();
+    emitter?.start();
+  }, [getEmitter]);
+  const stop = useCallback(() => {
+    const emitter = getEmitter();
+    emitter?.stop();
+  }, [getEmitter]);
+  const explode = useCallback(
+    (count, x, y) => {
+      const emitter = getEmitter();
+      emitter?.explode(count, x, y);
+    },
+    [getEmitter]
+  );
+  const setConfig = useCallback(
+    (config) => {
+      const emitter = getEmitter();
+      applyEmitterConfig(emitter, config);
+    },
+    [getEmitter]
+  );
+  const setEmitZone = useCallback(
+    (zone, width, height) => {
+      const emitter = getEmitter();
+      const emitZone = buildEmitZoneFromLayout(zone, width, height);
+      applyEmitZone(emitter, emitZone);
+    },
+    [getEmitter]
+  );
+  const setDeathZones = useCallback(
+    (zones, width, height) => {
+      const emitter = getEmitter();
+      const manager = getManager();
+      const deathZones = buildDeathZonesFromLayout(zones, width, height, manager ?? void 0);
+      applyDeathZone(emitter, deathZones);
+    },
+    [getEmitter, getManager]
+  );
+  return {
+    getManager,
+    getEmitter,
+    start,
+    stop,
+    explode,
+    setConfig,
+    setEmitZone,
+    setDeathZones,
+    setExcludeZones: setDeathZones
+  };
+}
+export {
+  useParticles
+};
+//# sourceMappingURL=use-particles.js.map