@number10/jsx-phaser 5.0.0

package/dist/components/primitives/nineslice.js

@@ -0,0 +1,42 @@
+import { applyNineSliceProps } from "../appliers/applyNineSlice.js";
+import { applyNineSliceLayout } from "../appliers/applyNineSliceLayout.js";
+import { applyPhaserProps } from "../appliers/applyPhaser.js";
+import { applyTransformProps } from "../appliers/applyTransform.js";
+import { createNineSliceLayout } from "../creators/createNineSliceLayout.js";
+import { createPhaser } from "../creators/createPhaser.js";
+import { resolveAnimatableNumber, createTransform } from "../creators/createTransform.js";
+const nineSliceCreator = (scene, props) => {
+  const initialWidth = typeof props.width === "number" ? props.width : 64;
+  const initialHeight = typeof props.height === "number" ? props.height : 64;
+  const nineSlice = scene.add.nineslice(
+    resolveAnimatableNumber(props.x) ?? 0,
+    resolveAnimatableNumber(props.y) ?? 0,
+    props.texture,
+    props.frame,
+    initialWidth,
+    initialHeight,
+    props.leftWidth,
+    props.rightWidth,
+    props.topHeight,
+    props.bottomHeight
+  );
+  nineSlice.setOrigin(0, 0);
+  if (props.tint !== void 0) {
+    nineSlice.setTint(props.tint);
+  }
+  createTransform(nineSlice, props);
+  createPhaser(nineSlice, props);
+  createNineSliceLayout(nineSlice, props);
+  return nineSlice;
+};
+const nineSlicePatcher = (node, prev, next) => {
+  applyTransformProps(node, prev, next);
+  applyPhaserProps(node, prev, next);
+  applyNineSliceProps(node, prev, next);
+  applyNineSliceLayout(node, prev, next);
+};
+export {
+  nineSliceCreator,
+  nineSlicePatcher
+};
+//# sourceMappingURL=nineslice.js.map

package/dist/components/primitives/nineslice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nineslice.js","sources":["../../../src/components/primitives/nineslice.ts"],"sourcesContent":["/**\n * NineSlice component - Phaser NineSlice GameObject for scalable UI panels\n * Status: IMPLEMENTED ✅\n *\n * Design Overview:\n * ================\n *\n * 1. Component Role: SCALABLE UI PANELS\n *    Purpose: Create resizable UI elements that preserve border/corner integrity\n *    Phaser Type: Phaser.GameObjects.NineSlice (9-slice scaling)\n *    Use Cases:\n *    - Buttons with fixed corner radius\n *    - Dialog boxes with preserved borders\n *    - Progress bars with capped ends\n *    - Panels that scale without distorting decorative edges\n *\n * 2. Nine-Slice Scaling Concept:\n *    Texture divided into 9 regions:\n *      ┌─────┬─────────┬─────┐\n *      │ TL  │   Top   │ TR  │  (corners + edges)\n *      ├─────┼─────────┼─────┤\n *      │Left │ Center  │Right│  (center scales, edges stretch)\n *      ├─────┼─────────┼─────┤\n *      │ BL  │ Bottom  │ BR  │  (corners stay fixed)\n *      └─────┴─────────┴─────┘\n *    Behavior:\n *    - Corners: Never scale (preserve pixel-perfect)\n *    - Edges: Stretch along one axis (top/bottom: horizontal, left/right: vertical)\n *    - Center: Scales in both directions\n *    Benefit: UI elements scale to any size without visual distortion\n *\n * 3. Three-Slice Mode (Optional):\n *    Feature: Omit topHeight/bottomHeight for horizontal-only slicing\n *    Use Case: Horizontal buttons, progress bars\n *    Layout:\n *      ┌─────┬─────────────────┬─────┐\n *      │Left │     Center      │Right│\n *      └─────┴─────────────────┴─────┘\n *    Props: Only leftWidth + rightWidth required\n *\n * 4. Headless Default: FALSE ✅\n *    Decision: NineSlice participates in layout by default\n *    Reasoning:\n *    - NineSlice is a UI element (buttons, panels, containers)\n *    - Should affect parent container dimensions\n *    - Similar to View component (container semantics)\n *    Use Cases:\n *    - ✅ Layout-aware (default): Buttons, panels, dialogs, cards\n *    - ❌ Headless (optional): Background overlays, decorative frames\n *    Usage:\n *      <NineSlice texture=\"panel\" leftWidth={16} rightWidth={16} width={200} height={100} />\n *      <NineSlice texture=\"frame\" headless={true} />  // Decorative\n *\n * 5. Layout Size Provider:\n *    Implementation: Uses explicit width/height (required props)\n *    Reasoning:\n *    - NineSlice requires explicit dimensions (Phaser constructor param)\n *    - No auto-sizing (unlike Text)\n *    - Dimensions always known and stable\n *    __getLayoutSize:\n *      return { width: nineSlice.width, height: nineSlice.height }\n *    Note: getBounds() not needed (no rotation typically applied)\n *\n * 6. Slice Configuration:\n *    Required Props:\n *    - texture: string (texture key)\n *    - leftWidth: number (pixels)\n *    - rightWidth: number (pixels)\n *    - width: number (total width)\n *    - height: number (total height)\n *    Optional Props:\n *    - topHeight: number (9-slice mode, default: 0 for 3-slice)\n *    - bottomHeight: number (9-slice mode, default: 0 for 3-slice)\n *    - frame: string | number (texture atlas frame)\n *    Validation:\n *    - Width must be >= leftWidth + rightWidth\n *    - Height must be >= topHeight + bottomHeight\n *    - Slice widths/heights define source texture regions\n *\n * 7. Inner Bounds Feature:\n *    Purpose: Calculate content area excluding slices\n *    Use Case: Position children inside panel borders\n *    Calculation:\n *      innerBounds = {\n *        x: leftWidth,\n *        y: topHeight,\n *        width: totalWidth - leftWidth - rightWidth,\n *        height: totalHeight - topHeight - bottomHeight\n *      }\n *    Access:\n *      const ref = useRef<NineSliceRef>(null)\n *      <NineSlice ref={ref} ... />\n *      console.log(ref.current?.innerBounds)  // { x, y, width, height }\n *    Pattern: Useful for padding-aware content positioning\n *\n * 8. Ref Extension:\n *    Feature: NineSliceRef provides slice metadata\n *    Properties:\n *    - node: Phaser.GameObjects.NineSlice (the GameObject)\n *    - leftWidth, rightWidth, topHeight, bottomHeight: Slice dimensions\n *    - innerBounds: Content area calculation\n *    Usage:\n *      const panelRef = useRef<NineSliceRef>(null)\n *      // Access slice info for child positioning\n *      const { innerBounds } = panelRef.current\n *\n * 9. Common Patterns:\n *    Button:\n *      <NineSlice\n *        texture=\"button\"\n *        leftWidth={16} rightWidth={16}\n *        topHeight={16} bottomHeight={16}\n *        width={200} height={60}\n *      >\n *        <Text text=\"Click Me\" />\n *      </NineSlice>\n *    Dialog Box:\n *      <NineSlice\n *        texture=\"panel\"\n *        leftWidth={32} rightWidth={32}\n *        topHeight={32} bottomHeight={32}\n *        width={400} height={300}\n *      >\n *        <View padding={32}>  {/* Padding matches slice sizes * }\n *          <Text text=\"Dialog Content\" />\n *        </View>\n *      </NineSlice>\n *    Progress Bar (3-slice):\n *      <NineSlice\n *        texture=\"progressbar\"\n *        leftWidth={8} rightWidth={8}\n *        width={progress * 200} height={20}\n *      />\n *\n * 10. Performance Considerations:\n *     - Efficient rendering (single draw call per NineSlice)\n *     - Texture atlases recommended (reduce texture switches)\n *     - Scaling performance: No geometry regeneration needed\n *     - Slice configuration: Calculated once on creation\n *     - Dynamic resizing: Efficiently handled by Phaser\n *\n * 11. Known Limitations:\n *     - Requires pre-designed 9-slice texture\n *     - Slice dimensions must match source texture layout exactly\n *     - Rotation not recommended (distorts slice alignment)\n *     - Can't animate slice dimensions (only width/height)\n *     - No rounded corner support (must be in texture)\n *\n * Implementation Status:\n * ======================\n * [✅] Phaser NineSlice creation with slice configuration\n * [✅] Transform props (position, scale, alpha, depth)\n * [✅] Layout system integration (__layoutProps, __getLayoutSize)\n * [✅] Width/height as layout props (explicit sizing)\n * [✅] Three-slice mode support (optional topHeight/bottomHeight)\n * [✅] NineSliceRef with innerBounds calculation\n * [✅] Slice dimension validation\n * [✅] Theme system integration\n * [✅] Dynamic resizing support (width/height patching)\n */\nimport type * as Phaser from 'phaser'\nimport type { LayoutProps, PhaserProps, TransformProps } from '../../core-props'\nimport type { HostCreator, HostPatcher } from '../../host'\nimport type { PropsDefaultExtension } from '../../types'\nimport { applyNineSliceProps } from '../appliers/applyNineSlice'\nimport { applyNineSliceLayout } from '../appliers/applyNineSliceLayout'\nimport { applyPhaserProps } from '../appliers/applyPhaser'\nimport { applyTransformProps } from '../appliers/applyTransform'\nimport { createNineSliceLayout } from '../creators/createNineSliceLayout'\nimport { createPhaser } from '../creators/createPhaser'\nimport { createTransform, resolveAnimatableNumber } from '../creators/createTransform'\n\n/**\n * Inner bounds of a NineSlice - the content area excluding slices\n */\nexport interface NineSliceInnerBounds {\n  /**\n   * X offset from left edge (equals leftWidth)\n   */\n  x: number\n  /**\n   * Y offset from top edge (equals topHeight)\n   */\n  y: number\n  /**\n   * Width of inner content area (totalWidth - leftWidth - rightWidth)\n   */\n  width: number\n  /**\n   * Height of inner content area (totalHeight - topHeight - bottomHeight)\n   */\n  height: number\n}\n\n/**\n * Extended NineSlice reference with slice information and inner bounds\n */\nexport interface NineSliceRef {\n  /**\n   * The underlying Phaser NineSlice GameObject\n   */\n  node: Phaser.GameObjects.NineSlice | null\n  /**\n   * Width of the left slice in pixels\n   */\n  leftWidth: number\n  /**\n   * Width of the right slice in pixels\n   */\n  rightWidth: number\n  /**\n   * Height of the top slice in pixels (0 for 3-slice mode)\n   */\n  topHeight: number\n  /**\n   * Height of the bottom slice in pixels (0 for 3-slice mode)\n   */\n  bottomHeight: number\n  /**\n   * Inner content bounds excluding slices\n   * Useful for positioning content within the NineSlice\n   */\n  innerBounds: NineSliceInnerBounds\n}\n\n/**\n * NineSlice-specific properties for texture and slice configuration\n */\nexport interface NineSliceSpecificProps {\n  /**\n   * Texture key to use for the NineSlice\n   */\n  texture: string\n\n  /**\n   * Optional tint to apply to the NineSlice\n   */\n  tint?: number | undefined\n\n  /**\n   * Optional frame within the texture atlas\n   */\n  frame?: string | number\n\n  /**\n   * Width of the left slice (in pixels of source texture)\n   */\n  leftWidth: number\n\n  /**\n   * Width of the right slice (in pixels of source texture)\n   */\n  rightWidth: number\n\n  /**\n   * Height of the top slice (in pixels of source texture)\n   * Optional - omit for 3-slice mode (horizontal only)\n   */\n  topHeight?: number\n\n  /**\n   * Height of the bottom slice (in pixels of source texture)\n   * Optional - omit for 3-slice mode (horizontal only)\n   */\n  bottomHeight?: number\n}\n\n/**\n * Base props for NineSlice - composing shared prop groups\n * Note: No InteractionProps - interaction should be handled by parent View container\n */\nexport interface NineSliceBaseProps\n  extends TransformProps, PhaserProps, LayoutProps, NineSliceSpecificProps {}\n\n/**\n * Props for NineSlice primitive - extends base props with JSX-specific props\n * Renamed to avoid conflict with custom NineSlice wrapper\n */\nexport interface NineSlicePrimitiveProps\n  extends NineSliceBaseProps, PropsDefaultExtension<Phaser.GameObjects.NineSlice> {}\n\n/**\n * NineSlice creator - creates a Phaser NineSlice object\n */\nexport const nineSliceCreator: HostCreator<'NineSlice'> = (scene, props) => {\n  // For width/height, use a small default that will be overridden by layout system\n  // This prevents the NineSlice from being created with huge dimensions\n  const initialWidth = typeof props.width === 'number' ? props.width : 64\n  const initialHeight = typeof props.height === 'number' ? props.height : 64\n\n  const nineSlice = scene.add.nineslice(\n    resolveAnimatableNumber(props.x) ?? 0,\n    resolveAnimatableNumber(props.y) ?? 0,\n    props.texture,\n    props.frame,\n    initialWidth,\n    initialHeight,\n    props.leftWidth,\n    props.rightWidth,\n    props.topHeight,\n    props.bottomHeight\n  )\n  nineSlice.setOrigin(0, 0) // Top-left origin for easier layout handling as it is in UI\n\n  // Apply tint if provided\n  if (props.tint !== undefined) {\n    nineSlice.setTint(props.tint)\n  }\n\n  // Apply transform props (scale, rotation)\n  createTransform(nineSlice, props)\n\n  // Apply Phaser display props (alpha, depth, visible)\n  createPhaser(nineSlice, props)\n\n  // Setup layout system (props and size provider)\n  createNineSliceLayout(nineSlice, props)\n\n  return nineSlice\n}\n\n/**\n * NineSlice patcher - updates NineSlice properties\n */\nexport const nineSlicePatcher: HostPatcher<'NineSlice'> = (node, prev, next) => {\n  // Apply transform props (position, rotation, scale)\n  applyTransformProps(node, prev, next)\n\n  // Apply Phaser display props (alpha, depth, visible)\n  applyPhaserProps(node, prev, next)\n\n  // Apply NineSlice-specific props (texture, frame, slice dimensions)\n  applyNineSliceProps(node, prev, next)\n\n  // Apply layout props and update size provider if needed\n  applyNineSliceLayout(node, prev, next)\n}\n"],"names":[],"mappings":";;;;;;;AA4RO,MAAM,mBAA6C,CAAC,OAAO,UAAU;AAG1E,QAAM,eAAe,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;AACrE,QAAM,gBAAgB,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AAExE,QAAM,YAAY,MAAM,IAAI;AAAA,IAC1B,wBAAwB,MAAM,CAAC,KAAK;AAAA,IACpC,wBAAwB,MAAM,CAAC,KAAK;AAAA,IACpC,MAAM;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,EAAA;AAER,YAAU,UAAU,GAAG,CAAC;AAGxB,MAAI,MAAM,SAAS,QAAW;AAC5B,cAAU,QAAQ,MAAM,IAAI;AAAA,EAC9B;AAGA,kBAAgB,WAAW,KAAK;AAGhC,eAAa,WAAW,KAAK;AAG7B,wBAAsB,WAAW,KAAK;AAEtC,SAAO;AACT;AAKO,MAAM,mBAA6C,CAAC,MAAM,MAAM,SAAS;AAE9E,sBAAoB,MAAM,MAAM,IAAI;AAGpC,mBAAiB,MAAM,MAAM,IAAI;AAGjC,sBAAoB,MAAM,MAAM,IAAI;AAGpC,uBAAqB,MAAM,MAAM,IAAI;AACvC;"}

package/dist/components/primitives/particles.cjs

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const emitZone = require("../../particles/emit-zone.cjs");
+const presetRegistry = require("../../particles/preset-registry.cjs");
+const utils = require("../../particles/utils.cjs");
+const applyParticles = require("../appliers/applyParticles.cjs");
+const applyParticlesLayout = require("../appliers/applyParticlesLayout.cjs");
+const applyPhaser = require("../appliers/applyPhaser.cjs");
+const applyTransform = require("../appliers/applyTransform.cjs");
+const createParticlesLayout = require("../creators/createParticlesLayout.cjs");
+const createPhaser = require("../creators/createPhaser.cjs");
+const createTransform = require("../creators/createTransform.cjs");
+const particlesCreator = (scene, props) => {
+  const resolvedConfig = {
+    ...presetRegistry.resolveParticlePreset(props.preset, props.config)
+  };
+  const emitZoneProps = props.emitZone ?? props.zone;
+  const deathZoneProps = props.deathZones ?? props.excludeZones;
+  if (emitZoneProps) {
+    const emitZone$1 = emitZone.buildEmitZoneFromLayout(emitZoneProps, props.width, props.height);
+    if (emitZone$1) {
+      const configWithZone = resolvedConfig;
+      configWithZone.emitZone = emitZone$1;
+    }
+  }
+  const particles = scene.add.particles(
+    createTransform.resolveAnimatableNumber(props.x) ?? 0,
+    createTransform.resolveAnimatableNumber(props.y) ?? 0,
+    props.texture,
+    resolvedConfig
+  );
+  if (props.frame !== void 0) {
+    const configWithFrame = resolvedConfig;
+    configWithFrame.frame = props.frame;
+    if ("setTexture" in particles && particles.setTexture) {
+      particles.setTexture(props.texture, props.frame);
+    }
+  }
+  const emitter = utils.isParticleEmitter(particles) ? particles : utils.getFirstEmitter(particles);
+  if (!utils.isParticleEmitter(particles)) {
+    particles.__emitter = emitter;
+  }
+  if ("setOrigin" in particles && typeof particles.setOrigin === "function") {
+    particles.setOrigin(0, 0);
+  }
+  createTransform.createTransform(particles, props);
+  createPhaser.createPhaser(particles, props);
+  createParticlesLayout.createParticlesLayout(particles, props);
+  if (deathZoneProps && emitter) {
+    const deathZones = emitZone.buildDeathZonesFromLayout(
+      deathZoneProps,
+      props.width,
+      props.height,
+      particles
+    );
+    const combinedDeathZones = utils.mergeDeathZones(
+      resolvedConfig.deathZone,
+      deathZones
+    );
+    if (combinedDeathZones) {
+      utils.applyDeathZone(emitter, combinedDeathZones);
+    }
+  }
+  if (props.onReady) {
+    props.onReady(particles);
+  }
+  return particles;
+};
+const particlesPatcher = (node, prev, next) => {
+  applyTransform.applyTransformProps(node, prev, next);
+  applyPhaser.applyPhaserProps(node, prev, next);
+  applyParticles.applyParticlesProps(node, prev, next);
+  applyParticlesLayout.applyParticlesLayout(node, prev, next);
+};
+exports.particlesCreator = particlesCreator;
+exports.particlesPatcher = particlesPatcher;
+//# sourceMappingURL=particles.cjs.map

package/dist/components/primitives/particles.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.cjs","sources":["../../../src/components/primitives/particles.ts"],"sourcesContent":["/**\n * Particles component - Phaser ParticleEmitterManager wrapper\n * Status: IMPLEMENTED ✅\n *\n * Design Overview:\n * ================\n * - Always headless (does not affect layout)\n * - Emits particles via a single emitter (configurable)\n * - Optional emit zone support (rect, circle, ellipse, line)\n */\nimport type { LayoutProps, PhaserProps, TransformProps } from '../../core-props'\nimport type { HostCreator, HostPatcher } from '../../host'\nimport type { ParticleDeathZoneConfig, ParticleZoneConfig } from '../../particles/emit-zone'\nimport { buildDeathZonesFromLayout, buildEmitZoneFromLayout } from '../../particles/emit-zone'\nimport type { ParticleEmitterManagerLike, ParticlesHandle } from '../../particles/particle-types'\nimport type { ParticleEmitterConfig, ParticlePresetName } from '../../particles/preset-registry'\nimport { resolveParticlePreset } from '../../particles/preset-registry'\nimport {\n  applyDeathZone,\n  getFirstEmitter,\n  isParticleEmitter,\n  mergeDeathZones,\n} from '../../particles/utils'\nimport type { PropsDefaultExtension } from '../../types'\nimport { applyParticlesProps } from '../appliers/applyParticles'\nimport { applyParticlesLayout } from '../appliers/applyParticlesLayout'\nimport { applyPhaserProps } from '../appliers/applyPhaser'\nimport { applyTransformProps } from '../appliers/applyTransform'\nimport { createParticlesLayout } from '../creators/createParticlesLayout'\nimport { createPhaser } from '../creators/createPhaser'\nimport { createTransform, resolveAnimatableNumber } from '../creators/createTransform'\n\n/**\n * Base props for Particles component\n */\nexport interface ParticlesBaseProps extends TransformProps, PhaserProps, LayoutProps {\n  /** Texture key (loaded via Phaser's texture manager) */\n  texture: string\n\n  /** Optional frame from texture atlas or spritesheet */\n  frame?: string | number\n\n  /** Built-in preset name */\n  preset?: ParticlePresetName\n\n  /** Optional emitter config overrides */\n  config?: ParticleEmitterConfig\n\n  /** Optional emit zone: where particles are born */\n  emitZone?: ParticleZoneConfig\n\n  /**\n   * Optional emit zone: where particles are born.\n   * @deprecated Use emitZone.\n   */\n  zone?: ParticleZoneConfig\n\n  /** Optional death zones: where particles are removed */\n  deathZones?: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined\n\n  /**\n   * Optional death zones: where particles are removed.\n   * @deprecated Use deathZones.\n   */\n  excludeZones?: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined\n}\n\n/**\n * Props for primitive Particles component (internal use only)\n */\nexport interface ParticlesPrimitiveProps\n  extends ParticlesBaseProps, PropsDefaultExtension<ParticlesHandle> {}\n\n/**\n * Particles creator - creates a Phaser ParticleEmitterManager with a single emitter\n */\nexport const particlesCreator: HostCreator<'Particles'> = (scene, props) => {\n  const resolvedConfig = {\n    ...resolveParticlePreset(props.preset, props.config),\n  } as ParticleEmitterConfig\n\n  const emitZoneProps = props.emitZone ?? props.zone\n  const deathZoneProps = props.deathZones ?? props.excludeZones\n\n  if (emitZoneProps) {\n    const emitZone = buildEmitZoneFromLayout(emitZoneProps, props.width, props.height)\n    if (emitZone) {\n      const configWithZone = resolvedConfig as unknown as { emitZone?: unknown }\n      configWithZone.emitZone = emitZone\n    }\n  }\n\n  // Don't set death zones yet - will be applied after transform\n\n  const particles = scene.add.particles(\n    resolveAnimatableNumber(props.x) ?? 0,\n    resolveAnimatableNumber(props.y) ?? 0,\n    props.texture,\n    resolvedConfig\n  ) as unknown as ParticlesHandle\n  if (props.frame !== undefined) {\n    const configWithFrame = resolvedConfig as unknown as { frame?: string | number }\n    configWithFrame.frame = props.frame\n    if ('setTexture' in particles && particles.setTexture) {\n      particles.setTexture(props.texture, props.frame)\n    }\n  }\n\n  const emitter = isParticleEmitter(particles)\n    ? particles\n    : getFirstEmitter(particles as ParticleEmitterManagerLike)\n\n  if (!isParticleEmitter(particles)) {\n    ;(particles as ParticleEmitterManagerLike).__emitter = emitter\n  }\n\n  // Set origin to (0, 0) for consistent coordinate system (top-left)\n  if ('setOrigin' in particles && typeof particles.setOrigin === 'function') {\n    particles.setOrigin(0, 0)\n  }\n\n  // Apply transform props\n  createTransform(particles, props)\n\n  // Apply Phaser display props (alpha, depth, visible)\n  createPhaser(particles, props)\n\n  // Setup layout system (headless)\n  createParticlesLayout(particles, props)\n\n  // Now apply death zones with container-relative coordinates\n  if (deathZoneProps && emitter) {\n    const deathZones = buildDeathZonesFromLayout(\n      deathZoneProps,\n      props.width,\n      props.height,\n      particles\n    )\n    const combinedDeathZones = mergeDeathZones(\n      (resolvedConfig as unknown as { deathZone?: unknown }).deathZone,\n      deathZones\n    )\n    if (combinedDeathZones) {\n      applyDeathZone(emitter, combinedDeathZones as Parameters<typeof applyDeathZone>[1])\n    }\n  }\n\n  // Call onReady callback if provided\n  if (props.onReady) {\n    props.onReady(particles)\n  }\n\n  return particles\n}\n\n/**\n * Particles patcher - updates ParticleEmitterManager properties\n */\nexport const particlesPatcher: HostPatcher<'Particles'> = (node, prev, next) => {\n  // Apply transform props\n  applyTransformProps(node, prev, next)\n\n  // Apply Phaser display props\n  applyPhaserProps(node, prev, next)\n\n  // Apply particle-specific props\n  applyParticlesProps(node, prev, next)\n\n  // Apply layout props\n  applyParticlesLayout(node, prev, next)\n}\n"],"names":["resolveParticlePreset","emitZone","buildEmitZoneFromLayout","resolveAnimatableNumber","isParticleEmitter","getFirstEmitter","createTransform","createPhaser","createParticlesLayout","buildDeathZonesFromLayout","mergeDeathZones","applyDeathZone","applyTransformProps","applyPhaserProps","applyParticlesProps","applyParticlesLayout"],"mappings":";;;;;;;;;;;;AA4EO,MAAM,mBAA6C,CAAC,OAAO,UAAU;AAC1E,QAAM,iBAAiB;AAAA,IACrB,GAAGA,qCAAsB,MAAM,QAAQ,MAAM,MAAM;AAAA,EAAA;AAGrD,QAAM,gBAAgB,MAAM,YAAY,MAAM;AAC9C,QAAM,iBAAiB,MAAM,cAAc,MAAM;AAEjD,MAAI,eAAe;AACjB,UAAMC,aAAWC,SAAAA,wBAAwB,eAAe,MAAM,OAAO,MAAM,MAAM;AACjF,QAAID,YAAU;AACZ,YAAM,iBAAiB;AACvB,qBAAe,WAAWA;AAAAA,IAC5B;AAAA,EACF;AAIA,QAAM,YAAY,MAAM,IAAI;AAAA,IAC1BE,wCAAwB,MAAM,CAAC,KAAK;AAAA,IACpCA,wCAAwB,MAAM,CAAC,KAAK;AAAA,IACpC,MAAM;AAAA,IACN;AAAA,EAAA;AAEF,MAAI,MAAM,UAAU,QAAW;AAC7B,UAAM,kBAAkB;AACxB,oBAAgB,QAAQ,MAAM;AAC9B,QAAI,gBAAgB,aAAa,UAAU,YAAY;AACrD,gBAAU,WAAW,MAAM,SAAS,MAAM,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,QAAM,UAAUC,MAAAA,kBAAkB,SAAS,IACvC,YACAC,MAAAA,gBAAgB,SAAuC;AAE3D,MAAI,CAACD,MAAAA,kBAAkB,SAAS,GAAG;AAC/B,cAAyC,YAAY;AAAA,EACzD;AAGA,MAAI,eAAe,aAAa,OAAO,UAAU,cAAc,YAAY;AACzE,cAAU,UAAU,GAAG,CAAC;AAAA,EAC1B;AAGAE,kBAAAA,gBAAgB,WAAW,KAAK;AAGhCC,eAAAA,aAAa,WAAW,KAAK;AAG7BC,wBAAAA,sBAAsB,WAAW,KAAK;AAGtC,MAAI,kBAAkB,SAAS;AAC7B,UAAM,aAAaC,SAAAA;AAAAA,MACjB;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,IAAA;AAEF,UAAM,qBAAqBC,MAAAA;AAAAA,MACxB,eAAsD;AAAA,MACvD;AAAA,IAAA;AAEF,QAAI,oBAAoB;AACtBC,YAAAA,eAAe,SAAS,kBAA0D;AAAA,IACpF;AAAA,EACF;AAGA,MAAI,MAAM,SAAS;AACjB,UAAM,QAAQ,SAAS;AAAA,EACzB;AAEA,SAAO;AACT;AAKO,MAAM,mBAA6C,CAAC,MAAM,MAAM,SAAS;AAE9EC,qCAAoB,MAAM,MAAM,IAAI;AAGpCC,+BAAiB,MAAM,MAAM,IAAI;AAGjCC,qCAAoB,MAAM,MAAM,IAAI;AAGpCC,4CAAqB,MAAM,MAAM,IAAI;AACvC;;;"}

package/dist/components/primitives/particles.d.ts

@@ -0,0 +1,47 @@
+import { LayoutProps, PhaserProps, TransformProps } from '../../core-props';
+import { HostCreator, HostPatcher } from '../../host';
+import { ParticleDeathZoneConfig, ParticleZoneConfig } from '../../particles/emit-zone';
+import { ParticlesHandle } from '../../particles/particle-types';
+import { ParticleEmitterConfig, ParticlePresetName } from '../../particles/preset-registry';
+import { PropsDefaultExtension } from '../../types';
+/**
+ * Base props for Particles component
+ */
+export interface ParticlesBaseProps extends TransformProps, PhaserProps, LayoutProps {
+    /** Texture key (loaded via Phaser's texture manager) */
+    texture: string;
+    /** Optional frame from texture atlas or spritesheet */
+    frame?: string | number;
+    /** Built-in preset name */
+    preset?: ParticlePresetName;
+    /** Optional emitter config overrides */
+    config?: ParticleEmitterConfig;
+    /** Optional emit zone: where particles are born */
+    emitZone?: ParticleZoneConfig;
+    /**
+     * Optional emit zone: where particles are born.
+     * @deprecated Use emitZone.
+     */
+    zone?: ParticleZoneConfig;
+    /** Optional death zones: where particles are removed */
+    deathZones?: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined;
+    /**
+     * Optional death zones: where particles are removed.
+     * @deprecated Use deathZones.
+     */
+    excludeZones?: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined;
+}
+/**
+ * Props for primitive Particles component (internal use only)
+ */
+export interface ParticlesPrimitiveProps extends ParticlesBaseProps, PropsDefaultExtension<ParticlesHandle> {
+}
+/**
+ * Particles creator - creates a Phaser ParticleEmitterManager with a single emitter
+ */
+export declare const particlesCreator: HostCreator<'Particles'>;
+/**
+ * Particles patcher - updates ParticleEmitterManager properties
+ */
+export declare const particlesPatcher: HostPatcher<'Particles'>;
+//# sourceMappingURL=particles.d.ts.map

package/dist/components/primitives/particles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/particles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE5F,OAAO,KAAK,EAA8B,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAQhG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AASxD;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc,EAAE,WAAW,EAAE,WAAW;IAClF,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IAEf,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEvB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAE3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAE9B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAE7B;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAA;IAEzB,wDAAwD;IACxD,UAAU,CAAC,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,GAAG,SAAS,CAAA;IAE5E;;;OAGG;IACH,YAAY,CAAC,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,GAAG,SAAS,CAAA;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,uBACf,SAAQ,kBAAkB,EAAE,qBAAqB,CAAC,eAAe,CAAC;CAAG;AAEvE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,WAAW,CA6ErD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,WAAW,CAYrD,CAAA"}

package/dist/components/primitives/particles.js

@@ -0,0 +1,77 @@
+import { buildEmitZoneFromLayout, buildDeathZonesFromLayout } from "../../particles/emit-zone.js";
+import { resolveParticlePreset } from "../../particles/preset-registry.js";
+import { isParticleEmitter, getFirstEmitter, mergeDeathZones, applyDeathZone } from "../../particles/utils.js";
+import { applyParticlesProps } from "../appliers/applyParticles.js";
+import { applyParticlesLayout } from "../appliers/applyParticlesLayout.js";
+import { applyPhaserProps } from "../appliers/applyPhaser.js";
+import { applyTransformProps } from "../appliers/applyTransform.js";
+import { createParticlesLayout } from "../creators/createParticlesLayout.js";
+import { createPhaser } from "../creators/createPhaser.js";
+import { resolveAnimatableNumber, createTransform } from "../creators/createTransform.js";
+const particlesCreator = (scene, props) => {
+  const resolvedConfig = {
+    ...resolveParticlePreset(props.preset, props.config)
+  };
+  const emitZoneProps = props.emitZone ?? props.zone;
+  const deathZoneProps = props.deathZones ?? props.excludeZones;
+  if (emitZoneProps) {
+    const emitZone = buildEmitZoneFromLayout(emitZoneProps, props.width, props.height);
+    if (emitZone) {
+      const configWithZone = resolvedConfig;
+      configWithZone.emitZone = emitZone;
+    }
+  }
+  const particles = scene.add.particles(
+    resolveAnimatableNumber(props.x) ?? 0,
+    resolveAnimatableNumber(props.y) ?? 0,
+    props.texture,
+    resolvedConfig
+  );
+  if (props.frame !== void 0) {
+    const configWithFrame = resolvedConfig;
+    configWithFrame.frame = props.frame;
+    if ("setTexture" in particles && particles.setTexture) {
+      particles.setTexture(props.texture, props.frame);
+    }
+  }
+  const emitter = isParticleEmitter(particles) ? particles : getFirstEmitter(particles);
+  if (!isParticleEmitter(particles)) {
+    particles.__emitter = emitter;
+  }
+  if ("setOrigin" in particles && typeof particles.setOrigin === "function") {
+    particles.setOrigin(0, 0);
+  }
+  createTransform(particles, props);
+  createPhaser(particles, props);
+  createParticlesLayout(particles, props);
+  if (deathZoneProps && emitter) {
+    const deathZones = buildDeathZonesFromLayout(
+      deathZoneProps,
+      props.width,
+      props.height,
+      particles
+    );
+    const combinedDeathZones = mergeDeathZones(
+      resolvedConfig.deathZone,
+      deathZones
+    );
+    if (combinedDeathZones) {
+      applyDeathZone(emitter, combinedDeathZones);
+    }
+  }
+  if (props.onReady) {
+    props.onReady(particles);
+  }
+  return particles;
+};
+const particlesPatcher = (node, prev, next) => {
+  applyTransformProps(node, prev, next);
+  applyPhaserProps(node, prev, next);
+  applyParticlesProps(node, prev, next);
+  applyParticlesLayout(node, prev, next);
+};
+export {
+  particlesCreator,
+  particlesPatcher
+};
+//# sourceMappingURL=particles.js.map

package/dist/components/primitives/particles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.js","sources":["../../../src/components/primitives/particles.ts"],"sourcesContent":["/**\n * Particles component - Phaser ParticleEmitterManager wrapper\n * Status: IMPLEMENTED ✅\n *\n * Design Overview:\n * ================\n * - Always headless (does not affect layout)\n * - Emits particles via a single emitter (configurable)\n * - Optional emit zone support (rect, circle, ellipse, line)\n */\nimport type { LayoutProps, PhaserProps, TransformProps } from '../../core-props'\nimport type { HostCreator, HostPatcher } from '../../host'\nimport type { ParticleDeathZoneConfig, ParticleZoneConfig } from '../../particles/emit-zone'\nimport { buildDeathZonesFromLayout, buildEmitZoneFromLayout } from '../../particles/emit-zone'\nimport type { ParticleEmitterManagerLike, ParticlesHandle } from '../../particles/particle-types'\nimport type { ParticleEmitterConfig, ParticlePresetName } from '../../particles/preset-registry'\nimport { resolveParticlePreset } from '../../particles/preset-registry'\nimport {\n  applyDeathZone,\n  getFirstEmitter,\n  isParticleEmitter,\n  mergeDeathZones,\n} from '../../particles/utils'\nimport type { PropsDefaultExtension } from '../../types'\nimport { applyParticlesProps } from '../appliers/applyParticles'\nimport { applyParticlesLayout } from '../appliers/applyParticlesLayout'\nimport { applyPhaserProps } from '../appliers/applyPhaser'\nimport { applyTransformProps } from '../appliers/applyTransform'\nimport { createParticlesLayout } from '../creators/createParticlesLayout'\nimport { createPhaser } from '../creators/createPhaser'\nimport { createTransform, resolveAnimatableNumber } from '../creators/createTransform'\n\n/**\n * Base props for Particles component\n */\nexport interface ParticlesBaseProps extends TransformProps, PhaserProps, LayoutProps {\n  /** Texture key (loaded via Phaser's texture manager) */\n  texture: string\n\n  /** Optional frame from texture atlas or spritesheet */\n  frame?: string | number\n\n  /** Built-in preset name */\n  preset?: ParticlePresetName\n\n  /** Optional emitter config overrides */\n  config?: ParticleEmitterConfig\n\n  /** Optional emit zone: where particles are born */\n  emitZone?: ParticleZoneConfig\n\n  /**\n   * Optional emit zone: where particles are born.\n   * @deprecated Use emitZone.\n   */\n  zone?: ParticleZoneConfig\n\n  /** Optional death zones: where particles are removed */\n  deathZones?: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined\n\n  /**\n   * Optional death zones: where particles are removed.\n   * @deprecated Use deathZones.\n   */\n  excludeZones?: ParticleDeathZoneConfig | ParticleDeathZoneConfig[] | undefined\n}\n\n/**\n * Props for primitive Particles component (internal use only)\n */\nexport interface ParticlesPrimitiveProps\n  extends ParticlesBaseProps, PropsDefaultExtension<ParticlesHandle> {}\n\n/**\n * Particles creator - creates a Phaser ParticleEmitterManager with a single emitter\n */\nexport const particlesCreator: HostCreator<'Particles'> = (scene, props) => {\n  const resolvedConfig = {\n    ...resolveParticlePreset(props.preset, props.config),\n  } as ParticleEmitterConfig\n\n  const emitZoneProps = props.emitZone ?? props.zone\n  const deathZoneProps = props.deathZones ?? props.excludeZones\n\n  if (emitZoneProps) {\n    const emitZone = buildEmitZoneFromLayout(emitZoneProps, props.width, props.height)\n    if (emitZone) {\n      const configWithZone = resolvedConfig as unknown as { emitZone?: unknown }\n      configWithZone.emitZone = emitZone\n    }\n  }\n\n  // Don't set death zones yet - will be applied after transform\n\n  const particles = scene.add.particles(\n    resolveAnimatableNumber(props.x) ?? 0,\n    resolveAnimatableNumber(props.y) ?? 0,\n    props.texture,\n    resolvedConfig\n  ) as unknown as ParticlesHandle\n  if (props.frame !== undefined) {\n    const configWithFrame = resolvedConfig as unknown as { frame?: string | number }\n    configWithFrame.frame = props.frame\n    if ('setTexture' in particles && particles.setTexture) {\n      particles.setTexture(props.texture, props.frame)\n    }\n  }\n\n  const emitter = isParticleEmitter(particles)\n    ? particles\n    : getFirstEmitter(particles as ParticleEmitterManagerLike)\n\n  if (!isParticleEmitter(particles)) {\n    ;(particles as ParticleEmitterManagerLike).__emitter = emitter\n  }\n\n  // Set origin to (0, 0) for consistent coordinate system (top-left)\n  if ('setOrigin' in particles && typeof particles.setOrigin === 'function') {\n    particles.setOrigin(0, 0)\n  }\n\n  // Apply transform props\n  createTransform(particles, props)\n\n  // Apply Phaser display props (alpha, depth, visible)\n  createPhaser(particles, props)\n\n  // Setup layout system (headless)\n  createParticlesLayout(particles, props)\n\n  // Now apply death zones with container-relative coordinates\n  if (deathZoneProps && emitter) {\n    const deathZones = buildDeathZonesFromLayout(\n      deathZoneProps,\n      props.width,\n      props.height,\n      particles\n    )\n    const combinedDeathZones = mergeDeathZones(\n      (resolvedConfig as unknown as { deathZone?: unknown }).deathZone,\n      deathZones\n    )\n    if (combinedDeathZones) {\n      applyDeathZone(emitter, combinedDeathZones as Parameters<typeof applyDeathZone>[1])\n    }\n  }\n\n  // Call onReady callback if provided\n  if (props.onReady) {\n    props.onReady(particles)\n  }\n\n  return particles\n}\n\n/**\n * Particles patcher - updates ParticleEmitterManager properties\n */\nexport const particlesPatcher: HostPatcher<'Particles'> = (node, prev, next) => {\n  // Apply transform props\n  applyTransformProps(node, prev, next)\n\n  // Apply Phaser display props\n  applyPhaserProps(node, prev, next)\n\n  // Apply particle-specific props\n  applyParticlesProps(node, prev, next)\n\n  // Apply layout props\n  applyParticlesLayout(node, prev, next)\n}\n"],"names":[],"mappings":";;;;;;;;;;AA4EO,MAAM,mBAA6C,CAAC,OAAO,UAAU;AAC1E,QAAM,iBAAiB;AAAA,IACrB,GAAG,sBAAsB,MAAM,QAAQ,MAAM,MAAM;AAAA,EAAA;AAGrD,QAAM,gBAAgB,MAAM,YAAY,MAAM;AAC9C,QAAM,iBAAiB,MAAM,cAAc,MAAM;AAEjD,MAAI,eAAe;AACjB,UAAM,WAAW,wBAAwB,eAAe,MAAM,OAAO,MAAM,MAAM;AACjF,QAAI,UAAU;AACZ,YAAM,iBAAiB;AACvB,qBAAe,WAAW;AAAA,IAC5B;AAAA,EACF;AAIA,QAAM,YAAY,MAAM,IAAI;AAAA,IAC1B,wBAAwB,MAAM,CAAC,KAAK;AAAA,IACpC,wBAAwB,MAAM,CAAC,KAAK;AAAA,IACpC,MAAM;AAAA,IACN;AAAA,EAAA;AAEF,MAAI,MAAM,UAAU,QAAW;AAC7B,UAAM,kBAAkB;AACxB,oBAAgB,QAAQ,MAAM;AAC9B,QAAI,gBAAgB,aAAa,UAAU,YAAY;AACrD,gBAAU,WAAW,MAAM,SAAS,MAAM,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,QAAM,UAAU,kBAAkB,SAAS,IACvC,YACA,gBAAgB,SAAuC;AAE3D,MAAI,CAAC,kBAAkB,SAAS,GAAG;AAC/B,cAAyC,YAAY;AAAA,EACzD;AAGA,MAAI,eAAe,aAAa,OAAO,UAAU,cAAc,YAAY;AACzE,cAAU,UAAU,GAAG,CAAC;AAAA,EAC1B;AAGA,kBAAgB,WAAW,KAAK;AAGhC,eAAa,WAAW,KAAK;AAG7B,wBAAsB,WAAW,KAAK;AAGtC,MAAI,kBAAkB,SAAS;AAC7B,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,IAAA;AAEF,UAAM,qBAAqB;AAAA,MACxB,eAAsD;AAAA,MACvD;AAAA,IAAA;AAEF,QAAI,oBAAoB;AACtB,qBAAe,SAAS,kBAA0D;AAAA,IACpF;AAAA,EACF;AAGA,MAAI,MAAM,SAAS;AACjB,UAAM,QAAQ,SAAS;AAAA,EACzB;AAEA,SAAO;AACT;AAKO,MAAM,mBAA6C,CAAC,MAAM,MAAM,SAAS;AAE9E,sBAAoB,MAAM,MAAM,IAAI;AAGpC,mBAAiB,MAAM,MAAM,IAAI;AAGjC,sBAAoB,MAAM,MAAM,IAAI;AAGpC,uBAAqB,MAAM,MAAM,IAAI;AACvC;"}

package/dist/components/primitives/sprite.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const applyPhaser = require("../appliers/applyPhaser.cjs");
+const applySprite = require("../appliers/applySprite.cjs");
+const applySpriteLayout = require("../appliers/applySpriteLayout.cjs");
+const applyTransform = require("../appliers/applyTransform.cjs");
+const createPhaser = require("../creators/createPhaser.cjs");
+const createSpriteLayout = require("../creators/createSpriteLayout.cjs");
+const createTransform = require("../creators/createTransform.cjs");
+const spriteCreator = (scene, props) => {
+  const sprite = scene.add.sprite(
+    createTransform.resolveAnimatableNumber(props.x) ?? 0,
+    createTransform.resolveAnimatableNumber(props.y) ?? 0,
+    props.texture,
+    props.frame
+  );
+  sprite.setOrigin(0.5, 0.5);
+  if (props.originX !== void 0 || props.originY !== void 0) {
+    sprite.setOrigin(props.originX ?? sprite.originX, props.originY ?? sprite.originY);
+  }
+  createTransform.createTransform(sprite, props);
+  createPhaser.createPhaser(sprite, props);
+  if (props.tint !== void 0) {
+    sprite.setTint(props.tint);
+  }
+  if (props.displayWidth !== void 0 || props.displayHeight !== void 0) {
+    if (props.displayWidth !== void 0 && props.displayHeight !== void 0) {
+      const fit = props.fit ?? "fill";
+      const textureWidth = sprite.width;
+      const textureHeight = sprite.height;
+      if (textureWidth > 0 && textureHeight > 0) {
+        if (fit === "fill") {
+          sprite.setDisplaySize(props.displayWidth, props.displayHeight);
+        } else if (fit === "contain") {
+          const targetAspect = props.displayWidth / props.displayHeight;
+          const textureAspect = textureWidth / textureHeight;
+          const scale = targetAspect > textureAspect ? props.displayHeight / textureHeight : props.displayWidth / textureWidth;
+          sprite.setScale(scale);
+        } else if (fit === "cover") {
+          const targetAspect = props.displayWidth / props.displayHeight;
+          const textureAspect = textureWidth / textureHeight;
+          const scale = targetAspect < textureAspect ? props.displayHeight / textureHeight : props.displayWidth / textureWidth;
+          sprite.setScale(scale);
+        }
+      }
+    } else if (props.displayWidth !== void 0) {
+      const scale = props.displayWidth / sprite.width;
+      sprite.setScale(scale);
+    } else if (props.displayHeight !== void 0) {
+      const scale = props.displayHeight / sprite.height;
+      sprite.setScale(scale);
+    }
+  }
+  if (props.animationKey) {
+    if (sprite.scene && sprite.scene.anims.exists(props.animationKey)) {
+      sprite.anims.play({
+        key: props.animationKey,
+        repeat: props.loop ? -1 : 0,
+        repeatDelay: props.repeatDelay ?? 0
+      });
+    }
+  }
+  if (props.onAnimationStart) {
+    sprite.on("animationstart", (anim) => {
+      props.onAnimationStart?.(anim.key);
+    });
+  }
+  if (props.onAnimationComplete) {
+    sprite.on("animationcomplete", (anim) => {
+      props.onAnimationComplete?.(anim.key);
+    });
+  }
+  if (props.onAnimationRepeat) {
+    sprite.on("animationrepeat", (anim) => {
+      props.onAnimationRepeat?.(anim.key);
+    });
+  }
+  if (props.onAnimationUpdate) {
+    sprite.on(
+      "animationupdate",
+      (anim, frame) => {
+        props.onAnimationUpdate?.(anim.key, frame);
+      }
+    );
+  }
+  createSpriteLayout.createSpriteLayout(sprite, props);
+  if (props.onReady) {
+    props.onReady(sprite);
+  }
+  return sprite;
+};
+const spritePatcher = (node, prev, next) => {
+  applyTransform.applyTransformProps(node, prev, next);
+  applyPhaser.applyPhaserProps(node, prev, next);
+  applySprite.applySpriteProps(node, prev, next);
+  applySpriteLayout.applySpriteLayout(node, prev, next);
+};
+exports.spriteCreator = spriteCreator;
+exports.spritePatcher = spritePatcher;
+//# sourceMappingURL=sprite.cjs.map

package/dist/components/primitives/sprite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite.cjs","sources":["../../../src/components/primitives/sprite.ts"],"sourcesContent":["/**\n * Sprite component - Phaser Sprite GameObject (animated texture)\n * Status: IMPLEMENTED ✅\n *\n * Design Overview:\n * ================\n *\n * 1. Component Role: ANIMATED GAME OBJECTS\n *    Purpose: Display animated sprites in game scenes (characters, effects, particles)\n *    Phaser Type: Phaser.GameObjects.Sprite (animation-capable texture rendering)\n *    Characteristics:\n *    - Always headless (does not affect parent layout)\n *    - Supports Phaser Animation system\n *    - Free positioning with rotation/scale\n *\n * 2. Headless Behavior: MANDATORY ✅\n *    Decision: Sprites are ALWAYS headless (not configurable)\n *    Reasoning:\n *    - Sprites are game objects, not UI elements\n *    - Should NOT affect parent layout dimensions\n *    - Free positioning with full transform support (rotation, scale)\n *    Layout Impact: Returns minimal size (0.01x0.01) - participates in alignment only\n *    Use Cases:\n *    - ✅ Game characters, particles, effects, free-floating objects\n *    - ✅ Animated decorations, background elements\n *    - ❌ NOT for layout-based UIs (use Image component instead)\n *\n * 3. Layout Size Provider: MINIMAL SIZE ✅\n *    Implementation: Always returns { width: 0.01, height: 0.01 }\n *    Reasoning:\n *    - Sprites don't affect layout spacing\n *    - Minimal size allows alignment but no spacing impact\n *    - Simpler than getBounds() with same result\n *\n * 4. Animation System: PHASER ANIMATIONS ✅\n *    Features:\n *    - animationKey: Play pre-registered animation\n *    - loop: Repeat animation indefinitely\n *    - repeatDelay: Delay between animation repeats (ms)\n *    Callbacks:\n *    - onAnimationStart: Triggered when animation begins\n *    - onAnimationComplete: Triggered when animation ends\n *    - onAnimationRepeat: Triggered on each repeat\n *    - onAnimationUpdate: Triggered on each frame update\n *    Note: Animations must be pre-registered in Phaser AnimationManager\n *\n * 5. Texture & Sizing: LIKE IMAGE ✅\n *    Props:\n *    - texture: Texture key (required)\n *    - frame: Frame from atlas/spritesheet\n *    - tint: Color tint (0xRRGGBB)\n *    - displayWidth/displayHeight: Scale sprite to fit\n *    - fit: 'fill' | 'contain' | 'cover' (aspect ratio handling)\n *    Error Handling: Missing texture → Phaser default (white square)\n *\n * 6. Origin Behavior: CENTERED (0.5, 0.5) ✅\n *    Decision: Default origin (0.5, 0.5) - centered\n *    Reasoning:\n *    - Phaser sprite default\n *    - Natural for rotation/scale pivot\n *    - Game object semantics\n *    Override: Use originX/originY props for custom origin\n *\n * 7. Performance: SPRITE BATCHING ✅\n *    Strategy:\n *    - Leverages Phaser's sprite batching (WebGL)\n *    - Props that preserve batching: tint, alpha, scale, position\n *    - Props that break batching: custom shaders, blend modes (use sparingly)\n *    - Texture atlases strongly recommended for multiple sprites\n *\n * 8. Common Patterns:\n *    Character:\n *      <Sprite texture=\"player\" animationKey=\"walk\" loop={true} />\n *    Particle Effect:\n *      <Sprite texture=\"explosion\" animationKey=\"explode\" onAnimationComplete={destroy} />\n *    Scaled Sprite:\n *      <Sprite texture=\"coin\" displayWidth={32} displayHeight={32} fit=\"contain\" />\n *\n * Implementation Status:\n * ======================\n * [✅] Phaser Sprite creation with texture/frame support\n * [✅] Transform props (position, rotation, scale, alpha)\n * [✅] Layout system integration (always headless)\n * [✅] Origin handling (0.5, 0.5 default)\n * [✅] Display size with fit modes (contain/cover/fill)\n * [✅] Tint support\n * [✅] Animation system (play, loop, callbacks)\n * [✅] Texture and frame patching\n */\nimport type * as Phaser from 'phaser'\nimport type { LayoutProps, PhaserProps, TransformProps } from '../../core-props'\nimport type { HostCreator, HostPatcher } from '../../host'\nimport type { PropsDefaultExtension } from '../../types'\nimport { applyPhaserProps } from '../appliers/applyPhaser'\nimport { applySpriteProps } from '../appliers/applySprite'\nimport { applySpriteLayout } from '../appliers/applySpriteLayout'\nimport { applyTransformProps } from '../appliers/applyTransform'\nimport { createPhaser } from '../creators/createPhaser'\nimport { createSpriteLayout } from '../creators/createSpriteLayout'\nimport { createTransform, resolveAnimatableNumber } from '../creators/createTransform'\n\n/**\n * Base props for Sprite component\n */\nexport interface SpriteBaseProps extends TransformProps, PhaserProps, LayoutProps {\n  /** Texture key (loaded via Phaser's texture manager) */\n  texture: string\n\n  /** Optional frame from texture atlas or spritesheet */\n  frame?: string | number\n\n  /** Tint color applied to sprite (0xRRGGBB) */\n  tint?: number\n\n  /** Display width (scales sprite to fit) */\n  displayWidth?: number\n\n  /** Display height (scales sprite to fit) */\n  displayHeight?: number\n\n  /**\n   * How sprite should fit within bounds (if displayWidth/displayHeight set)\n   * - 'fill': Stretch to fill (default, may distort aspect ratio)\n   * - 'contain': Scale to fit within bounds, preserve aspect ratio\n   * - 'cover': Scale to cover bounds, preserve aspect ratio (may crop)\n   */\n  fit?: 'fill' | 'contain' | 'cover'\n\n  /** Animation key to play (pre-registered in Phaser AnimationManager) */\n  animationKey?: string\n\n  /** Loop animation (default: false) */\n  loop?: boolean\n\n  /** Delay between animation repeats in ms (default: 0) */\n  repeatDelay?: number\n\n  /** Callback when animation starts */\n  onAnimationStart?: (key: string) => void\n\n  /** Callback when animation completes */\n  onAnimationComplete?: (key: string) => void\n\n  /** Callback when animation repeats */\n  onAnimationRepeat?: (key: string) => void\n\n  /** Callback on each animation frame update */\n  onAnimationUpdate?: (key: string, frame: Phaser.Animations.AnimationFrame) => void\n\n  /** Origin X (0-1, default 0.5) */\n  originX?: number\n\n  /** Origin Y (0-1, default 0.5) */\n  originY?: number\n}\n\n/**\n * Props for Sprite component\n */\nexport interface SpriteProps\n  extends SpriteBaseProps, PropsDefaultExtension<Phaser.GameObjects.Sprite> {}\n\n/**\n * Sprite creator - creates a Phaser Sprite object with animations\n */\nexport const spriteCreator: HostCreator<'Sprite'> = (scene, props) => {\n  const sprite = scene.add.sprite(\n    resolveAnimatableNumber(props.x) ?? 0,\n    resolveAnimatableNumber(props.y) ?? 0,\n    props.texture,\n    props.frame\n  )\n\n  // Set origin - always centered (0.5, 0.5) for sprites\n  sprite.setOrigin(0.5, 0.5)\n\n  // Apply custom origin if specified\n  if (props.originX !== undefined || props.originY !== undefined) {\n    sprite.setOrigin(props.originX ?? sprite.originX, props.originY ?? sprite.originY)\n  }\n\n  // Apply transform props (scale, rotation)\n  createTransform(sprite, props)\n\n  // Apply Phaser display props (alpha, depth, visible)\n  createPhaser(sprite, props)\n\n  // Apply sprite-specific props (tint, displaySize, fit)\n  if (props.tint !== undefined) {\n    sprite.setTint(props.tint)\n  }\n\n  // Apply displayWidth/displayHeight if specified\n  if (props.displayWidth !== undefined || props.displayHeight !== undefined) {\n    if (props.displayWidth !== undefined && props.displayHeight !== undefined) {\n      // Both specified - use fit mode\n      const fit = props.fit ?? 'fill'\n      const textureWidth = sprite.width\n      const textureHeight = sprite.height\n\n      if (textureWidth > 0 && textureHeight > 0) {\n        if (fit === 'fill') {\n          sprite.setDisplaySize(props.displayWidth, props.displayHeight)\n        } else if (fit === 'contain') {\n          const targetAspect = props.displayWidth / props.displayHeight\n          const textureAspect = textureWidth / textureHeight\n          const scale =\n            targetAspect > textureAspect\n              ? props.displayHeight / textureHeight\n              : props.displayWidth / textureWidth\n          sprite.setScale(scale)\n        } else if (fit === 'cover') {\n          const targetAspect = props.displayWidth / props.displayHeight\n          const textureAspect = textureWidth / textureHeight\n          const scale =\n            targetAspect < textureAspect\n              ? props.displayHeight / textureHeight\n              : props.displayWidth / textureWidth\n          sprite.setScale(scale)\n        }\n      }\n    } else if (props.displayWidth !== undefined) {\n      const scale = props.displayWidth / sprite.width\n      sprite.setScale(scale)\n    } else if (props.displayHeight !== undefined) {\n      const scale = props.displayHeight / sprite.height\n      sprite.setScale(scale)\n    }\n  }\n\n  // Setup animation system\n  // Only play if the animation is already registered in the AnimationManager.\n  // Calling `sprite.anims.play` with a missing key causes Phaser to log\n  // \"Missing animation: <key>\". Many examples register animations in a\n  // separate effect that may run after the Sprite is created, so avoid\n  // attempting to play until the animation actually exists.\n  if (props.animationKey) {\n    if (sprite.scene && sprite.scene.anims.exists(props.animationKey)) {\n      sprite.anims.play({\n        key: props.animationKey,\n        repeat: props.loop ? -1 : 0,\n        repeatDelay: props.repeatDelay ?? 0,\n      })\n    }\n  }\n\n  // Setup animation callbacks\n  if (props.onAnimationStart) {\n    sprite.on('animationstart', (anim: Phaser.Animations.Animation) => {\n      props.onAnimationStart?.(anim.key)\n    })\n  }\n\n  if (props.onAnimationComplete) {\n    sprite.on('animationcomplete', (anim: Phaser.Animations.Animation) => {\n      props.onAnimationComplete?.(anim.key)\n    })\n  }\n\n  if (props.onAnimationRepeat) {\n    sprite.on('animationrepeat', (anim: Phaser.Animations.Animation) => {\n      props.onAnimationRepeat?.(anim.key)\n    })\n  }\n\n  if (props.onAnimationUpdate) {\n    sprite.on(\n      'animationupdate',\n      (anim: Phaser.Animations.Animation, frame: Phaser.Animations.AnimationFrame) => {\n        props.onAnimationUpdate?.(anim.key, frame)\n      }\n    )\n  }\n\n  // Setup layout system (props and size provider)\n  createSpriteLayout(sprite, props)\n\n  // Call onReady callback if provided\n  if (props.onReady) {\n    props.onReady(sprite)\n  }\n\n  return sprite\n}\n\n/**\n * Sprite patcher - updates Sprite properties\n */\nexport const spritePatcher: HostPatcher<'Sprite'> = (node, prev, next) => {\n  // Apply transform props (position, rotation, scale)\n  applyTransformProps(node, prev, next)\n\n  // Apply Phaser display props (alpha, depth, visible)\n  applyPhaserProps(node, prev, next)\n\n  // Apply sprite-specific props (texture, frame, tint, displaySize, fit, animations)\n  applySpriteProps(node, prev, next)\n\n  // Apply layout props and update size provider if needed\n  applySpriteLayout(node, prev, next)\n}\n"],"names":["resolveAnimatableNumber","createTransform","createPhaser","createSpriteLayout","applyTransformProps","applyPhaserProps","applySpriteProps","applySpriteLayout"],"mappings":";;;;;;;;;AAqKO,MAAM,gBAAuC,CAAC,OAAO,UAAU;AACpE,QAAM,SAAS,MAAM,IAAI;AAAA,IACvBA,wCAAwB,MAAM,CAAC,KAAK;AAAA,IACpCA,wCAAwB,MAAM,CAAC,KAAK;AAAA,IACpC,MAAM;AAAA,IACN,MAAM;AAAA,EAAA;AAIR,SAAO,UAAU,KAAK,GAAG;AAGzB,MAAI,MAAM,YAAY,UAAa,MAAM,YAAY,QAAW;AAC9D,WAAO,UAAU,MAAM,WAAW,OAAO,SAAS,MAAM,WAAW,OAAO,OAAO;AAAA,EACnF;AAGAC,kBAAAA,gBAAgB,QAAQ,KAAK;AAG7BC,eAAAA,aAAa,QAAQ,KAAK;AAG1B,MAAI,MAAM,SAAS,QAAW;AAC5B,WAAO,QAAQ,MAAM,IAAI;AAAA,EAC3B;AAGA,MAAI,MAAM,iBAAiB,UAAa,MAAM,kBAAkB,QAAW;AACzE,QAAI,MAAM,iBAAiB,UAAa,MAAM,kBAAkB,QAAW;AAEzE,YAAM,MAAM,MAAM,OAAO;AACzB,YAAM,eAAe,OAAO;AAC5B,YAAM,gBAAgB,OAAO;AAE7B,UAAI,eAAe,KAAK,gBAAgB,GAAG;AACzC,YAAI,QAAQ,QAAQ;AAClB,iBAAO,eAAe,MAAM,cAAc,MAAM,aAAa;AAAA,QAC/D,WAAW,QAAQ,WAAW;AAC5B,gBAAM,eAAe,MAAM,eAAe,MAAM;AAChD,gBAAM,gBAAgB,eAAe;AACrC,gBAAM,QACJ,eAAe,gBACX,MAAM,gBAAgB,gBACtB,MAAM,eAAe;AAC3B,iBAAO,SAAS,KAAK;AAAA,QACvB,WAAW,QAAQ,SAAS;AAC1B,gBAAM,eAAe,MAAM,eAAe,MAAM;AAChD,gBAAM,gBAAgB,eAAe;AACrC,gBAAM,QACJ,eAAe,gBACX,MAAM,gBAAgB,gBACtB,MAAM,eAAe;AAC3B,iBAAO,SAAS,KAAK;AAAA,QACvB;AAAA,MACF;AAAA,IACF,WAAW,MAAM,iBAAiB,QAAW;AAC3C,YAAM,QAAQ,MAAM,eAAe,OAAO;AAC1C,aAAO,SAAS,KAAK;AAAA,IACvB,WAAW,MAAM,kBAAkB,QAAW;AAC5C,YAAM,QAAQ,MAAM,gBAAgB,OAAO;AAC3C,aAAO,SAAS,KAAK;AAAA,IACvB;AAAA,EACF;AAQA,MAAI,MAAM,cAAc;AACtB,QAAI,OAAO,SAAS,OAAO,MAAM,MAAM,OAAO,MAAM,YAAY,GAAG;AACjE,aAAO,MAAM,KAAK;AAAA,QAChB,KAAK,MAAM;AAAA,QACX,QAAQ,MAAM,OAAO,KAAK;AAAA,QAC1B,aAAa,MAAM,eAAe;AAAA,MAAA,CACnC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,MAAM,kBAAkB;AAC1B,WAAO,GAAG,kBAAkB,CAAC,SAAsC;AACjE,YAAM,mBAAmB,KAAK,GAAG;AAAA,IACnC,CAAC;AAAA,EACH;AAEA,MAAI,MAAM,qBAAqB;AAC7B,WAAO,GAAG,qBAAqB,CAAC,SAAsC;AACpE,YAAM,sBAAsB,KAAK,GAAG;AAAA,IACtC,CAAC;AAAA,EACH;AAEA,MAAI,MAAM,mBAAmB;AAC3B,WAAO,GAAG,mBAAmB,CAAC,SAAsC;AAClE,YAAM,oBAAoB,KAAK,GAAG;AAAA,IACpC,CAAC;AAAA,EACH;AAEA,MAAI,MAAM,mBAAmB;AAC3B,WAAO;AAAA,MACL;AAAA,MACA,CAAC,MAAmC,UAA4C;AAC9E,cAAM,oBAAoB,KAAK,KAAK,KAAK;AAAA,MAC3C;AAAA,IAAA;AAAA,EAEJ;AAGAC,qBAAAA,mBAAmB,QAAQ,KAAK;AAGhC,MAAI,MAAM,SAAS;AACjB,UAAM,QAAQ,MAAM;AAAA,EACtB;AAEA,SAAO;AACT;AAKO,MAAM,gBAAuC,CAAC,MAAM,MAAM,SAAS;AAExEC,qCAAoB,MAAM,MAAM,IAAI;AAGpCC,+BAAiB,MAAM,MAAM,IAAI;AAGjCC,+BAAiB,MAAM,MAAM,IAAI;AAGjCC,sCAAkB,MAAM,MAAM,IAAI;AACpC;;;"}

package/dist/components/primitives/sprite.d.ts

@@ -0,0 +1,147 @@
+import { LayoutProps, PhaserProps, TransformProps } from '../../core-props';
+import { HostCreator, HostPatcher } from '../../host';
+import { PropsDefaultExtension } from '../../types';
+/**
+ * Sprite component - Phaser Sprite GameObject (animated texture)
+ * Status: IMPLEMENTED ✅
+ *
+ * Design Overview:
+ * ================
+ *
+ * 1. Component Role: ANIMATED GAME OBJECTS
+ *    Purpose: Display animated sprites in game scenes (characters, effects, particles)
+ *    Phaser Type: Phaser.GameObjects.Sprite (animation-capable texture rendering)
+ *    Characteristics:
+ *    - Always headless (does not affect parent layout)
+ *    - Supports Phaser Animation system
+ *    - Free positioning with rotation/scale
+ *
+ * 2. Headless Behavior: MANDATORY ✅
+ *    Decision: Sprites are ALWAYS headless (not configurable)
+ *    Reasoning:
+ *    - Sprites are game objects, not UI elements
+ *    - Should NOT affect parent layout dimensions
+ *    - Free positioning with full transform support (rotation, scale)
+ *    Layout Impact: Returns minimal size (0.01x0.01) - participates in alignment only
+ *    Use Cases:
+ *    - ✅ Game characters, particles, effects, free-floating objects
+ *    - ✅ Animated decorations, background elements
+ *    - ❌ NOT for layout-based UIs (use Image component instead)
+ *
+ * 3. Layout Size Provider: MINIMAL SIZE ✅
+ *    Implementation: Always returns { width: 0.01, height: 0.01 }
+ *    Reasoning:
+ *    - Sprites don't affect layout spacing
+ *    - Minimal size allows alignment but no spacing impact
+ *    - Simpler than getBounds() with same result
+ *
+ * 4. Animation System: PHASER ANIMATIONS ✅
+ *    Features:
+ *    - animationKey: Play pre-registered animation
+ *    - loop: Repeat animation indefinitely
+ *    - repeatDelay: Delay between animation repeats (ms)
+ *    Callbacks:
+ *    - onAnimationStart: Triggered when animation begins
+ *    - onAnimationComplete: Triggered when animation ends
+ *    - onAnimationRepeat: Triggered on each repeat
+ *    - onAnimationUpdate: Triggered on each frame update
+ *    Note: Animations must be pre-registered in Phaser AnimationManager
+ *
+ * 5. Texture & Sizing: LIKE IMAGE ✅
+ *    Props:
+ *    - texture: Texture key (required)
+ *    - frame: Frame from atlas/spritesheet
+ *    - tint: Color tint (0xRRGGBB)
+ *    - displayWidth/displayHeight: Scale sprite to fit
+ *    - fit: 'fill' | 'contain' | 'cover' (aspect ratio handling)
+ *    Error Handling: Missing texture → Phaser default (white square)
+ *
+ * 6. Origin Behavior: CENTERED (0.5, 0.5) ✅
+ *    Decision: Default origin (0.5, 0.5) - centered
+ *    Reasoning:
+ *    - Phaser sprite default
+ *    - Natural for rotation/scale pivot
+ *    - Game object semantics
+ *    Override: Use originX/originY props for custom origin
+ *
+ * 7. Performance: SPRITE BATCHING ✅
+ *    Strategy:
+ *    - Leverages Phaser's sprite batching (WebGL)
+ *    - Props that preserve batching: tint, alpha, scale, position
+ *    - Props that break batching: custom shaders, blend modes (use sparingly)
+ *    - Texture atlases strongly recommended for multiple sprites
+ *
+ * 8. Common Patterns:
+ *    Character:
+ *      <Sprite texture="player" animationKey="walk" loop={true} />
+ *    Particle Effect:
+ *      <Sprite texture="explosion" animationKey="explode" onAnimationComplete={destroy} />
+ *    Scaled Sprite:
+ *      <Sprite texture="coin" displayWidth={32} displayHeight={32} fit="contain" />
+ *
+ * Implementation Status:
+ * ======================
+ * [✅] Phaser Sprite creation with texture/frame support
+ * [✅] Transform props (position, rotation, scale, alpha)
+ * [✅] Layout system integration (always headless)
+ * [✅] Origin handling (0.5, 0.5 default)
+ * [✅] Display size with fit modes (contain/cover/fill)
+ * [✅] Tint support
+ * [✅] Animation system (play, loop, callbacks)
+ * [✅] Texture and frame patching
+ */
+import type * as Phaser from 'phaser';
+/**
+ * Base props for Sprite component
+ */
+export interface SpriteBaseProps extends TransformProps, PhaserProps, LayoutProps {
+    /** Texture key (loaded via Phaser's texture manager) */
+    texture: string;
+    /** Optional frame from texture atlas or spritesheet */
+    frame?: string | number;
+    /** Tint color applied to sprite (0xRRGGBB) */
+    tint?: number;
+    /** Display width (scales sprite to fit) */
+    displayWidth?: number;
+    /** Display height (scales sprite to fit) */
+    displayHeight?: number;
+    /**
+     * How sprite should fit within bounds (if displayWidth/displayHeight set)
+     * - 'fill': Stretch to fill (default, may distort aspect ratio)
+     * - 'contain': Scale to fit within bounds, preserve aspect ratio
+     * - 'cover': Scale to cover bounds, preserve aspect ratio (may crop)
+     */
+    fit?: 'fill' | 'contain' | 'cover';
+    /** Animation key to play (pre-registered in Phaser AnimationManager) */
+    animationKey?: string;
+    /** Loop animation (default: false) */
+    loop?: boolean;
+    /** Delay between animation repeats in ms (default: 0) */
+    repeatDelay?: number;
+    /** Callback when animation starts */
+    onAnimationStart?: (key: string) => void;
+    /** Callback when animation completes */
+    onAnimationComplete?: (key: string) => void;
+    /** Callback when animation repeats */
+    onAnimationRepeat?: (key: string) => void;
+    /** Callback on each animation frame update */
+    onAnimationUpdate?: (key: string, frame: Phaser.Animations.AnimationFrame) => void;
+    /** Origin X (0-1, default 0.5) */
+    originX?: number;
+    /** Origin Y (0-1, default 0.5) */
+    originY?: number;
+}
+/**
+ * Props for Sprite component
+ */
+export interface SpriteProps extends SpriteBaseProps, PropsDefaultExtension<Phaser.GameObjects.Sprite> {
+}
+/**
+ * Sprite creator - creates a Phaser Sprite object with animations
+ */
+export declare const spriteCreator: HostCreator<'Sprite'>;
+/**
+ * Sprite patcher - updates Sprite properties
+ */
+export declare const spritePatcher: HostPatcher<'Sprite'>;
+//# sourceMappingURL=sprite.d.ts.map

package/dist/components/primitives/sprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/sprite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFG;AACH,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AASxD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc,EAAE,WAAW,EAAE,WAAW;IAC/E,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IAEf,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEvB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAElC,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAExC,wCAAwC;IACxC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAE3C,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAEzC,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,cAAc,KAAK,IAAI,CAAA;IAElF,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WACf,SAAQ,eAAe,EAAE,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;CAAG;AAE9E;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,QAAQ,CAsH/C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,QAAQ,CAY/C,CAAA"}