@number10/phaserjsx 0.1.0

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

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

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

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

package/dist/gestures/gesture-manager.d.ts

@@ -0,0 +1,149 @@
+import { default as Phaser } from 'phaser';
+import { GestureCallbacks, GestureConfig } from './gesture-types';
+/**
+ * Generate unique mount root ID for mountJSX isolation
+ * @returns Unique root ID
+ */
+export declare function generateMountRootId(): number;
+/**
+ * Manager for gesture detection across all containers in a scene
+ * Singleton per scene, stored in scene.data
+ */
+export declare class GestureManager {
+    private scene;
+    private containers;
+    private lastPointerPositions;
+    private activePointerDown;
+    private activeContainersForMove;
+    private hoveredContainers;
+    private pendingTimeouts;
+    private isInitialized;
+    private isDestroyed;
+    constructor(scene: Phaser.Scene);
+    /**
+     * Initialize global event listeners (called once per scene)
+     */
+    private initialize;
+    /**
+     * Register a container for gesture tracking
+     * @param container - Container to track
+     * @param callbacks - Gesture event callbacks
+     * @param hitArea - Interactive hit area
+     * @param config - Gesture configuration
+     */
+    registerContainer(container: Phaser.GameObjects.Container, callbacks: GestureCallbacks, hitArea: Phaser.Geom.Rectangle, config?: GestureConfig): void;
+    /**
+     * Unregister a container
+     * @param container - Container to remove
+     */
+    unregisterContainer(container: Phaser.GameObjects.Container): void;
+    /**
+     * Check if a container is registered
+     * @param container - Container to check
+     * @returns True if container is registered
+     */
+    hasContainer(container: Phaser.GameObjects.Container): boolean;
+    /**
+     * Create a gesture event data object with propagation control
+     * @param pointer - Phaser pointer
+     * @param localX - Local X coordinate
+     * @param localY - Local Y coordinate
+     * @param width - Hit area width
+     * @param height - Hit area height
+     * @param options - Optional additional data (dx, dy, isInside, state)
+     * @returns Event data with stopPropagation support
+     */
+    private createEventData;
+    /**
+     * Get effective depth considering entire parent hierarchy
+     * @param container - Container to calculate depth for
+     * @returns Accumulated depth from container and all parents
+     */
+    private getEffectiveDepth;
+    /**
+     * Get mount root ID from container hierarchy
+     * Walks up to find the topmost container with __mountRootId
+     * @param container - Container to check
+     * @returns Mount root ID or 0 if none found
+     */
+    private getRootId;
+    /**
+     * Bubble an event through overlapping containers
+     * Iterates all containers at pointer position and calls handler until stopPropagation
+     * Sorts containers by their actual display list order (z-index) to respect visual stacking
+     * @param pointer - The pointer that triggered the event
+     * @param eventType - Type of event for filtering callbacks
+     * @param handler - Function to call for each container, returns true if propagation stopped
+     * @param filterSet - Optional set of containers to limit bubbling to (for move events)
+     * @param skipContainerCheck - Skip the isPointerInContainer check (for final move events)
+     */
+    private bubbleEvent;
+    /**
+     * Update hit area for a container
+     * @param container - Container to update
+     * @param hitArea - New hit area
+     */
+    updateHitArea(container: Phaser.GameObjects.Container, hitArea: Phaser.Geom.Rectangle): void;
+    /**
+     * Update callbacks for a container
+     * @param container - Container to update
+     * @param callbacks - New callbacks
+     */
+    updateCallbacks(container: Phaser.GameObjects.Container, callbacks: GestureCallbacks): void;
+    /**
+     * Handle global pointer down event
+     * Registers all containers that were hit for move event tracking
+     * Only the topmost gets touch/longpress callbacks
+     */
+    private handlePointerDown;
+    /**
+     * Handle global pointer up event
+     */
+    private handlePointerUp;
+    /**
+     * Handle pointer up outside canvas (global window events)
+     * Ensures touch move 'end' state is sent even when pointer released outside
+     * Also handles onTouchOutside for ALL containers
+     */
+    private handleGlobalPointerUp;
+    /**
+     * Handle global pointer move event
+     * Detects hover state changes and notifies containers with onHoverStart/onHoverEnd
+     * Only notifies containers that were hit during pointer down for onTouchMove
+     * Bubbles through them until stopPropagation() is called
+     */
+    private handlePointerMove;
+    /**
+     * Check if pointer is within a container's hit area
+     * Also checks parent visibility chain to handle collapsed accordions
+     */
+    private isPointerInContainer;
+    /**
+     * Convert global pointer position to container local coordinates
+     */
+    private getLocalPosition;
+    /**
+     * Detect hover state changes for all containers (desktop/mouse only)
+     * Called on every pointer move to update hover state
+     */
+    private detectHoverChanges;
+    /**
+     * Create hover event data
+     */
+    private createHoverEventData;
+    /**
+     * Handle mouse wheel event
+     * Bubbles to all containers under the pointer
+     */
+    private handleWheel;
+    /**
+     * Cleanup all resources
+     */
+    private destroy;
+}
+/**
+ * Get or create GestureManager for a scene
+ * Stored in scene.data to ensure singleton per scene
+ */
+export declare function getGestureManager(scene: Phaser.Scene): GestureManager;
+//# sourceMappingURL=gesture-manager.d.ts.map

package/dist/gestures/gesture-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture-manager.d.ts","sourceRoot":"","sources":["../../src/gestures/gesture-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAKd,MAAM,iBAAiB,CAAA;AAMxB;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAiE;IAGnF,OAAO,CAAC,oBAAoB,CAA8C;IAG1E,OAAO,CAAC,iBAAiB,CAKV;IAGf,OAAO,CAAC,uBAAuB,CAAuD;IAGtF,OAAO,CAAC,iBAAiB,CAAmD;IAG5E,OAAO,CAAC,eAAe,CAAoB;IAE3C,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAQ;gBAEf,KAAK,EAAE,MAAM,CAAC,KAAK;IAI/B;;OAEG;IACH,OAAO,CAAC,UAAU;IA4BlB;;;;;;OAMG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EACvC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAC9B,MAAM,GAAE,aAAkB,GACzB,IAAI;IAkBP;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI;IAoBlE;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,GAAG,OAAO;IAI9D;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAejB;;;;;;;;;OASG;IACH,OAAO,CAAC,WAAW;IAkEnB;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI;IAO5F;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAO3F;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAwGzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsIvB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+G7B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAyFzB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiC1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAyGnB;;OAEG;IACH,OAAO,CAAC,OAAO;CA2ChB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,cAAc,CAerE"}

package/dist/gestures/gesture-types.d.ts

@@ -0,0 +1,229 @@
+import { default as Phaser } from 'phaser';
+/**
+ * Touch move gesture state
+ */
+export type TouchMoveState = 'start' | 'move' | 'end';
+/**
+ * Data passed to keyboard event handlers
+ */
+export interface KeyboardEventData {
+    /** The original DOM keyboard event */
+    event: KeyboardEvent;
+    /** The key value of the key represented by the event */
+    key: string;
+    /** The code value of the physical key */
+    code: string;
+    /** Whether the Alt key was pressed */
+    altKey: boolean;
+    /** Whether the Ctrl key was pressed */
+    ctrlKey: boolean;
+    /** Whether the Shift key was pressed */
+    shiftKey: boolean;
+    /** Whether the Meta key (Cmd/Win) was pressed */
+    metaKey: boolean;
+    /** Whether this is a repeat event (key held down) */
+    repeat: boolean;
+    /**
+     * Prevent default browser behavior
+     */
+    preventDefault(): void;
+    /**
+     * Stop event propagation
+     */
+    stopPropagation(): void;
+}
+/**
+ * Data passed to input event handlers
+ */
+export interface InputEventData {
+    /** The current value of the input */
+    value: string;
+    /** The original DOM input event */
+    event: Event;
+    /**
+     * Prevent default browser behavior
+     */
+    preventDefault(): void;
+    /**
+     * Stop event propagation
+     */
+    stopPropagation(): void;
+}
+/**
+ * Data passed to focus/blur event handlers
+ */
+export interface FocusEventData {
+    /** The original DOM focus event */
+    event: FocusEvent;
+    /**
+     * Prevent default browser behavior
+     */
+    preventDefault(): void;
+    /**
+     * Stop event propagation
+     */
+    stopPropagation(): void;
+}
+/**
+ * Data passed to hover event handlers (desktop/mouse only)
+ */
+export interface HoverEventData {
+    /** The Phaser pointer that triggered the event */
+    pointer: Phaser.Input.Pointer;
+    /** Local X coordinate relative to container origin (0,0) */
+    localX: number;
+    /** Local Y coordinate relative to container origin (0,0) */
+    localY: number;
+    /** Width of the container's hit area */
+    width: number;
+    /** Height of the container's hit area */
+    height: number;
+    /**
+     * Stop event propagation to parent containers
+     */
+    stopPropagation(): void;
+    /**
+     * Check if propagation has been stopped
+     * @returns true if stopPropagation() was called
+     */
+    isPropagationStopped(): boolean;
+}
+/**
+ * Data passed to wheel event handlers (desktop/mouse only)
+ */
+export interface WheelEventData {
+    /** The Phaser pointer at the time of the wheel event */
+    pointer: Phaser.Input.Pointer;
+    /** Local X coordinate relative to container origin (0,0) */
+    localX: number;
+    /** Local Y coordinate relative to container origin (0,0) */
+    localY: number;
+    /** Wheel scroll delta X (horizontal scrolling) */
+    deltaX: number;
+    /** Wheel scroll delta Y (vertical scrolling) */
+    deltaY: number;
+    /** Wheel scroll delta Z (some mice) */
+    deltaZ: number;
+    /** Delta mode: 0 = pixels, 1 = lines, 2 = pages */
+    deltaMode: number;
+    /** Width of the container's hit area */
+    width: number;
+    /** Height of the container's hit area */
+    height: number;
+    /** Original DOM wheel event */
+    originalEvent: WheelEvent;
+    /**
+     * Stop event propagation to parent containers
+     */
+    stopPropagation(): void;
+    /**
+     * Check if propagation has been stopped
+     * @returns true if stopPropagation() was called
+     */
+    isPropagationStopped(): boolean;
+    /**
+     * Prevent default browser behavior (e.g., page scroll)
+     */
+    preventDefault(): void;
+}
+/**
+ * Data passed to gesture event handlers
+ * Supports DOM-style event propagation control
+ */
+export interface GestureEventData {
+    /** The Phaser pointer that triggered the event */
+    pointer: Phaser.Input.Pointer;
+    /** Local X coordinate relative to container origin (0,0) */
+    localX: number;
+    /** Local Y coordinate relative to container origin (0,0) */
+    localY: number;
+    /** Delta X since last move event (only for onTouchMove) */
+    dx?: number;
+    /** Delta Y since last move event (only for onTouchMove) */
+    dy?: number;
+    /** Width of the container's hit area */
+    width: number;
+    /** Height of the container's hit area */
+    height: number;
+    /** Whether pointer is currently inside the container hit area */
+    isInside?: boolean;
+    /** Current state of touch move gesture: 'start' (first move), 'move' (during), 'end' (pointer up) (only for onTouchMove) */
+    state?: TouchMoveState;
+    /**
+     * Stop event propagation to parent containers
+     * Similar to DOM's event.stopPropagation()
+     * Default behavior: events bubble up to parent containers
+     */
+    stopPropagation(): void;
+    /**
+     * Check if propagation has been stopped
+     * @returns true if stopPropagation() was called
+     */
+    isPropagationStopped(): boolean;
+}
+/**
+ * Callback functions for gesture events
+ */
+export interface GestureCallbacks {
+    /** Called on pointer down + up on the same target (click/tap) */
+    onTouch?: (data: GestureEventData) => void;
+    /** Called when pointer up occurs outside the container (for click-outside detection) */
+    onTouchOutside?: (data: GestureEventData) => void;
+    /** Called during pointer movement - continues even when outside bounds */
+    onTouchMove?: (data: GestureEventData) => void;
+    /** Called when double tap/click is detected */
+    onDoubleTap?: (data: GestureEventData) => void;
+    /** Called when pointer is held down for configured duration */
+    onLongPress?: (data: GestureEventData) => void;
+    /** Called when a key is pressed down */
+    onKeyDown?: (data: KeyboardEventData) => void;
+    /** Called when a key is released */
+    onKeyUp?: (data: KeyboardEventData) => void;
+    /** Called when input value changes */
+    onInput?: (data: InputEventData) => void;
+    /** Called when element receives focus */
+    onFocus?: (data: FocusEventData) => void;
+    /** Called when element loses focus */
+    onBlur?: (data: FocusEventData) => void;
+    /** Called when pointer enters the container (desktop/mouse only) */
+    onHoverStart?: (data: HoverEventData) => void;
+    /** Called when pointer exits the container (desktop/mouse only) */
+    onHoverEnd?: (data: HoverEventData) => void;
+    /** Called when mouse wheel is scrolled over container (desktop/mouse only) */
+    onWheel?: (data: WheelEventData) => void;
+}
+/**
+ * Configuration for gesture detection
+ */
+export interface GestureConfig {
+    /** Duration in ms to trigger long press (default: 500) */
+    longPressDuration?: number;
+    /** Max time in ms between taps for double tap (default: 300) */
+    doubleTapDelay?: number;
+    /** Max time in ms for a valid touch/click (prevents delayed touch after long hold) (default: 500) */
+    maxTouchDuration?: number;
+}
+/**
+ * Default gesture configuration values
+ */
+export declare const DEFAULT_GESTURE_CONFIG: Required<GestureConfig>;
+/**
+ * Internal state for tracking a registered container
+ */
+export interface GestureContainerState {
+    container: Phaser.GameObjects.Container;
+    callbacks: GestureCallbacks;
+    config: Required<GestureConfig>;
+    hitArea: Phaser.Geom.Rectangle;
+    mountRootId?: number | undefined;
+    lastTapTime?: number | undefined;
+    longPressTimer?: NodeJS.Timeout | undefined;
+    pointerDownPosition?: {
+        x: number;
+        y: number;
+    } | undefined;
+    pointerDownTime?: number | undefined;
+    longPressTriggered?: boolean | undefined;
+    isFirstMove?: boolean | undefined;
+}
+//# sourceMappingURL=gesture-types.d.ts.map

package/dist/gestures/gesture-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture-types.d.ts","sourceRoot":"","sources":["../../src/gestures/gesture-types.ts"],"names":[],"mappings":"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"}

package/dist/hooks-svg.d.ts

@@ -0,0 +1,104 @@
+import { default as Phaser } from 'phaser';
+/**
+ * SVG texture configuration for loading
+ */
+export interface SVGTextureConfig {
+    key: string;
+    svg: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Manually release a global SVG texture from memory
+ * Only call this if you're sure no component needs the texture anymore
+ *
+ * @param key - The texture key to release
+ * @example
+ * ```ts
+ * // In a Phaser scene
+ * import { releaseSVGTexture } from '@number10/phaserjsx'
+ *
+ * // When changing levels or cleaning up
+ * releaseSVGTexture('icon-bell')
+ * ```
+ */
+export declare function releaseSVGTexture(scene: Phaser.Scene, key: string): void;
+/**
+ * Manually release multiple global SVG textures from memory
+ * Only call this if you're sure no component needs these textures anymore
+ *
+ * @param keys - Array of texture keys to release
+ * @example
+ * ```ts
+ * // In a Phaser scene
+ * import { releaseSVGTextures } from '@number10/phaserjsx'
+ *
+ * // Clean up all icon textures when changing scenes
+ * releaseSVGTextures(['icon-bell', 'icon-settings', 'icon-user'])
+ * ```
+ */
+export declare function releaseSVGTextures(scene: Phaser.Scene, keys: string[]): void;
+/**
+ * Manually release ALL global SVG textures from memory
+ * Use with caution - this clears all textures managed by the texture registry
+ *
+ * @example
+ * ```ts
+ * // In a Phaser scene shutdown or cleanup
+ * import { releaseAllSVGTextures } from '@number10/phaserjsx'
+ *
+ * // When changing to a different scene or restarting
+ * releaseAllSVGTextures()
+ * ```
+ */
+export declare function releaseAllSVGTextures(): void;
+/**
+ * Hook to load a single SVG as a Phaser texture
+ *
+ * Automatically handles:
+ * - Scene detection from component context
+ * - Texture loading and registration
+ * - Cleanup on unmount (removes texture from Phaser)
+ *
+ * @param key - Unique texture key
+ * @param svg - SVG string or URL
+ * @param width - Texture width in pixels (default: 32)
+ * @param height - Texture height in pixels (default: 32)
+ * @returns true when texture is loaded and ready to use
+ * @example
+ * ```tsx
+ * function MyIcon() {
+ *   const ready = useSVGTexture('icon-bell', bellIconSvg, 32, 32)
+ *   return ready ? <Image texture="icon-bell" /> : null
+ * }
+ * ```
+ */
+export declare function useSVGTexture(key: string, svg: string, width?: number, height?: number): boolean;
+/**
+ * Hook to load multiple SVG textures
+ *
+ * Automatically handles:
+ * - Scene detection from component context
+ * - Parallel texture loading
+ * - Cleanup on unmount (removes all textures from Phaser)
+ *
+ * @param configs - Array of SVG texture configurations
+ * @returns true when all textures are loaded and ready to use
+ * @example
+ * ```tsx
+ * function MyIcons() {
+ *   const ready = useSVGTextures([
+ *     { key: 'icon-bell', svg: bellSvg, width: 32, height: 32 },
+ *     { key: 'icon-settings', svg: settingsSvg, width: 24 },
+ *   ])
+ *   return ready ? (
+ *     <>
+ *       <Image texture="icon-bell" />
+ *       <Image texture="icon-settings" />
+ *     </>
+ *   ) : null
+ * }
+ * ```
+ */
+export declare function useSVGTextures(configs: SVGTextureConfig[]): boolean;
+//# sourceMappingURL=hooks-svg.d.ts.map

package/dist/hooks-svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-svg.d.ts","sourceRoot":"","sources":["../src/hooks-svg.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAK3B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAExE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAI5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,MAAW,EAClB,MAAM,GAAE,MAAW,GAClB,OAAO,CAoCT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAwDnE"}