@rb-games/core 0.1.0

package/dist/helpers/SVGParser.d.ts

@@ -0,0 +1,121 @@
+import { Texture, LoaderParser } from 'pixi.js';
+/**
+ * Style definitions for SVG elements using CSS selectors.
+ *
+ * Maps CSS selectors to attribute-value pairs that will be applied to matching SVG elements.
+ * Commonly used for dynamic theming and color changes.
+ *
+ * @example
+ * ```typescript
+ * const styles: SVGStyleData = {
+ *   '#primary': { fill: '#4CAF50', stroke: '#388E3C' },
+ *   '.icon': { fill: '#FFFFFF' },
+ *   'circle': { opacity: '0.8' }
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface SVGStyleData {
+    /** CSS selector as key, attributes as value */
+    [selector: string]: {
+        /** SVG attribute name (e.g., 'fill', 'stroke', 'opacity') */
+        [attribute: string]: string;
+    };
+}
+/**
+ * Configuration data for loading and processing SVG files.
+ *
+ * This interface defines all options available when loading an SVG asset,
+ * including styling, sizing, and resolution settings.
+ *
+ * @example
+ * ```typescript
+ * const loadData: SVGLoadData = {
+ *   styles: {
+ *     '#background': { fill: '#4CAF50' },
+ *     '#icon': { fill: '#FFFFFF' }
+ *   },
+ *   size: { width: 128, height: 128 },
+ *   resolution: 2
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface SVGLoadData {
+    /** Style definitions to apply to SVG elements */
+    styles?: SVGStyleData;
+    /** Target size for rasterization (width and height in pixels) */
+    size?: {
+        width: number;
+        height: number;
+    };
+    /** Resolution multiplier for high-DPI displays (default: 1) */
+    resolution?: number;
+    /** Button states for multi-state assets (used by SVGAssetHelper) */
+    states?: string[];
+}
+/**
+ * Global configuration for the SVG parser.
+ *
+ * @public
+ */
+export interface SVGParserConfig {
+    /** Glob pattern to match SVG files (uses minimatch) */
+    testPattern?: string;
+}
+/**
+ * PixiJS LoaderParser implementation for SVG files.
+ *
+ * This parser integrates with PixiJS Assets system to automatically detect,
+ * load, and process SVG files as textures. It handles:
+ * - SVG file detection via URL pattern matching
+ * - Style manipulation using CSS selectors
+ * - Size and resolution configuration
+ * - Canvas rasterization for texture generation
+ *
+ * The parser is registered with PixiJS Assets via SVGLoader.install().
+ *
+ * @remarks
+ * This parser uses DOMParser and Canvas API to convert SVG to raster textures.
+ * All SVG manipulations happen before rasterization, ensuring clean output.
+ *
+ * @example
+ * ```typescript
+ * // Parser is automatically used after SVGLoader.install()
+ * await Assets.load({
+ *   alias: 'icon',
+ *   src: 'assets/icon.svg',
+ *   data: {
+ *     styles: { '#primary': { fill: '#4CAF50' } },
+ *     size: { width: 64, height: 64 },
+ *     resolution: 2
+ *   }
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare const SVGParser: LoaderParser<Texture, SVGLoadData>;
+/**
+ * Configures the SVG parser with global settings.
+ *
+ * This function allows customization of the parser behavior, such as
+ * specifying custom glob patterns for SVG file matching.
+ *
+ * Typically called by SVGLoader.install() but can be used independently.
+ *
+ * @param config - Parser configuration options
+ *
+ * @example
+ * ```typescript
+ * configureSVGParser({
+ *   testPattern: 'assets/svg/*.svg'
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare function configureSVGParser(config: SVGParserConfig): void;
+//# sourceMappingURL=SVGParser.d.ts.map

package/dist/helpers/SVGParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SVGParser.d.ts","sourceRoot":"","sources":["../../helpers/SVGParser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAiB,YAAY,EAAgC,MAAM,SAAS,CAAC;AAI7F;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,6DAA6D;QAC7D,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;KAC7B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,iEAAiE;IACjE,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAwGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,SAAS,EAAE,YAAY,CAAC,OAAO,EAAE,WAAW,CAyExD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAEhE"}

package/dist/helpers/eventBridge.d.ts

@@ -0,0 +1,150 @@
+import type { EventEmitter } from 'pixi.js';
+/**
+ * Extract namespace prefix from event names (supports nested namespaces)
+ * Example: ExtractNamespace<'hud:spin'> = 'hud'
+ * Example: ExtractNamespace<'menu:autoplay:start'> = 'menu:autoplay'
+ */
+type ExtractNamespace<T extends string> = T extends `${infer Prefix}:${infer Rest}` ? Rest extends `${string}:${string}` ? `${Prefix}:${ExtractNamespace<Rest>}` : Prefix : never;
+/**
+ * Get all unique namespaces from event map (supports nested namespaces)
+ * Example: GetNamespaces<{'hud:spin': ..., 'menu:autoplay:start': ...}> = 'hud' | 'menu:autoplay'
+ */
+type GetNamespaces<T> = ExtractNamespace<Extract<keyof T, string>>;
+/**
+ * Filter events by namespace
+ * Example: FilterByNamespace<SlotBaseEvents, 'hud'> = { 'hud:spin': () => void, ... }
+ */
+type FilterByNamespace<T, NS extends string> = {
+    [K in Extract<keyof T, `${NS}:${string}`>]: T[K];
+};
+/**
+ * Remove namespace prefix from event names (supports nested namespaces)
+ * Example: StripNamespace<'hud:spin', 'hud'> = 'spin'
+ * Example: StripNamespace<'menu:autoplay:start', 'menu:autoplay'> = 'start'
+ */
+type StripNamespace<T extends string, NS extends string> = T extends `${NS}:${infer Rest}` ? Rest : T;
+/**
+ * Transform event map by removing namespace prefix
+ * Example: TransformEventMap<{ 'hud:spin': () => void }, 'hud'> = { 'spin': () => void }
+ */
+type TransformEventMap<T, NS extends string> = {
+    [K in Extract<keyof T, string> as StripNamespace<K, NS>]: K extends keyof T ? T[K] : never;
+};
+/**
+ * Configuration for event bridge
+ */
+export interface EventBridgeConfig {
+    /**
+     * Namespace prefix to add to forwarded events
+     * Example: 'hud' will transform 'spin' to 'hud:spin'
+     */
+    namespace?: string;
+    /**
+     * Custom transform function for event name and arguments
+     * Takes precedence over namespace if provided
+     */
+    transform?: (event: string, ...args: any[]) => [string, ...any[]];
+    /**
+     * Filter function to selectively forward events
+     * Return true to forward, false to skip
+     */
+    filter?: (event: string) => boolean;
+    /**
+     * Intercept function for side effects before forwarding
+     * Useful for UI state changes, logging, etc.
+     */
+    intercept?: (event: string, ...args: any[]) => void;
+}
+/**
+ * Event bridge handle for cleanup
+ */
+export interface EventBridgeHandle {
+    /**
+     * Disconnect the bridge and restore original emit behavior
+     */
+    disconnect: () => void;
+}
+/**
+ * Type-safe event bridge configuration
+ */
+export interface TypedEventBridgeConfig<TSource extends Record<string, any>, TTarget extends Record<string, any>, NS extends GetNamespaces<TTarget>> extends Omit<EventBridgeConfig, 'namespace' | 'filter' | 'intercept'> {
+    namespace: NS;
+    filter?: (event: keyof TSource) => boolean;
+    intercept?: <K extends keyof TSource>(event: K, ...args: Parameters<TSource[K]>) => void;
+}
+/**
+ * Creates an event bridge that automatically forwards all emitted events from source to target.
+ * This eliminates the need for manual event binding boilerplate.
+ *
+ * **Auto-cleanup:** If the source component has a `destroy()` method, the bridge will
+ * automatically clean up when the component is destroyed, preventing memory leaks.
+ * You can also manually disconnect using the returned handle.
+ *
+ * @example
+ * // Simple namespace forwarding
+ * createEventBridge(this.gameHud, this.eventBusPlugin, {
+ *   namespace: 'hud'
+ * });
+ * // Now: gameHud.emit('spin') → eventBus.emit('hud:spin')
+ * // Auto-cleanup when gameHud.destroy() is called
+ *
+ * @example
+ * // With side effects
+ * createEventBridge(this.gameHud, this.eventBusPlugin, {
+ *   namespace: 'hud',
+ *   intercept: (event) => {
+ *     if (event === 'autoplay') this.autoplayMenu.visible = !this.autoplayMenu.visible;
+ *   }
+ * });
+ *
+ * @example
+ * // Manual cleanup (optional)
+ * const handle = createEventBridge(this.component, this.eventBus, {
+ *   transform: (event, ...args) => [`custom:${event}`, ...args]
+ * });
+ * // Later...
+ * handle.disconnect(); // Manual cleanup if needed
+ *
+ * @param source - The EventEmitter to bridge from
+ * @param target - The EventEmitter to forward events to
+ * @param config - Bridge configuration options
+ * @returns Handle with disconnect method for manual cleanup
+ */
+export declare function createEventBridge(source: EventEmitter, target: {
+    emit(event: any, ...args: any[]): boolean;
+}, config?: EventBridgeConfig): EventBridgeHandle;
+/**
+ * Type-safe event bridge creator
+ * Ensures source events match target events after namespace transformation
+ *
+ * @example
+ * // Define source events (without namespace)
+ * interface HudEvents {
+ *   spin: () => void;
+ *   autoplay: () => void;
+ * }
+ *
+ * // Define target events (with namespace)
+ * interface GameEvents {
+ *   'hud:spin': () => void;
+ *   'hud:autoplay': () => void;
+ *   'menu:close': () => void;
+ * }
+ *
+ * // Type-safe bridge - TypeScript validates that HudEvents matches 'hud' namespace in GameEvents
+ * createTypedEventBridge<GameEvents, 'hud', HudEvents>(
+ *   hudComponent,
+ *   eventBus,
+ *   { namespace: 'hud' }
+ * );
+ *
+ * @param source - The EventEmitter to bridge from
+ * @param target - The EventEmitter to forward events to
+ * @param config - Type-safe bridge configuration
+ * @returns Handle with disconnect method for manual cleanup
+ */
+export declare function createTypedEventBridge<TTarget extends Record<string, any>, NS extends GetNamespaces<TTarget>, TSource extends TransformEventMap<FilterByNamespace<TTarget, NS>, NS>>(source: EventEmitter, target: {
+    emit(event: any, ...args: any[]): boolean;
+}, config: TypedEventBridgeConfig<TSource, TTarget, NS>): EventBridgeHandle;
+export {};
+//# sourceMappingURL=eventBridge.d.ts.map

package/dist/helpers/eventBridge.d.ts.map

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

package/dist/helpers/index.d.ts

@@ -0,0 +1,8 @@
+export * from './SVGLoader';
+export * from './SVGParser';
+export * from './SVGAssetHelper';
+export * from './AssetHelper';
+export * from './resolvePublicPath';
+export * from './eventBridge';
+export * from './mergeUtils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../helpers/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC"}