@rb-games/core 0.1.0

package/dist/utils/PixiUtils.d.ts

@@ -0,0 +1,118 @@
+import { Container, Rectangle } from 'pixi.js';
+/**
+ * Type helper for elements that have an anchor property
+ */
+export type HasAnchor<T> = T & {
+    anchor: {
+        set(x: number, y: number): void;
+    };
+};
+/**
+ * Calculate animation speed from FPS for PixiJS AnimatedSprite
+ *
+ * Converts animation FPS to PixiJS animationSpeed value. Default is 12 FPS because
+ * animation sequences are typically exported from animation tools at 12 FPS,
+ * while PixiJS runs at 60 FPS (requiring conversion: exportedFps / 60).
+ *
+ * @param exportedFps - Frames per second of the exported animation sequence (default: 12)
+ * @param speed - Speed multiplier for playback (default: 1)
+ * @returns Animation speed value for PixiJS AnimatedSprite (exportedFps / 60 * speed)
+ *
+ * @example
+ * ```ts
+ * const animSprite = new AnimatedSprite(frames);
+ * // For 12 FPS animation (standard export)
+ * animSprite.animationSpeed = calculateAnimationSpeed(12); // 0.2
+ * // For 24 FPS animation
+ * animSprite.animationSpeed = calculateAnimationSpeed(24); // 0.4
+ * // For 12 FPS animation with 2x playback speed
+ * animSprite.animationSpeed = calculateAnimationSpeed(12, 2); // 0.4
+ * ```
+ */
+export declare function calculateAnimationSpeed(exportedFps?: number, speed?: number): number;
+/**
+ * Apply anchor to a PixiJS element that supports anchor property
+ *
+ * @param element - Container element (Sprite, AnimatedSprite, Text, etc.)
+ * @param anchor - Anchor point to set
+ * @param defaultAnchor - Default anchor if anchor is not provided
+ *
+ * @example
+ * ```ts
+ * const sprite = new Sprite(texture);
+ * applyAnchor(sprite, { x: 0.5, y: 0.5 });
+ * ```
+ */
+export declare function applyAnchor(element: Container, anchor?: {
+    x: number;
+    y: number;
+}, defaultAnchor?: {
+    x: number;
+    y: number;
+}): void;
+/**
+ * Apply scale to a PixiJS Container element
+ * Supports both uniform (number) and non-uniform ({ x, y }) scaling
+ *
+ * @param element - Container element to scale
+ * @param scale - Scale value (number for uniform, object for non-uniform)
+ *
+ * @example
+ * ```ts
+ * // Uniform scale
+ * applyScale(sprite, 2);
+ *
+ * // Non-uniform scale
+ * applyScale(sprite, { x: 2, y: 1.5 });
+ * ```
+ */
+export declare function applyScale(element: Container, scale?: number | {
+    x: number;
+    y: number;
+}): void;
+/**
+ * Apply common visual properties to a PixiJS Container element
+ * Includes alpha, blendMode, and scale
+ *
+ * @param element - Container element
+ * @param config - Configuration object with optional properties
+ *
+ * @example
+ * ```ts
+ * applyCommonProperties(sprite, {
+ *   alpha: 0.8,
+ *   blendMode: 'add',
+ *   scale: 1.5
+ * });
+ * ```
+ */
+export declare function applyCommonProperties(element: Container, config: {
+    alpha?: number;
+    blendMode?: string;
+    scale?: number | {
+        x: number;
+        y: number;
+    };
+}): void;
+/**
+ * Update or create a Rectangle for bounds
+ * Reuses existing Rectangle instance to prevent memory leaks
+ *
+ * @param existingBounds - Existing Rectangle instance or undefined
+ * @param x - X position
+ * @param y - Y position
+ * @param width - Width
+ * @param height - Height
+ * @returns Updated or new Rectangle instance
+ *
+ * @example
+ * ```ts
+ * // First call - creates new Rectangle
+ * this.boundsArea = updateBounds(this.boundsArea, 0, 0, 100, 100);
+ *
+ * // Subsequent calls - reuses existing Rectangle
+ * this.boundsArea = updateBounds(this.boundsArea, 0, 0, 200, 200);
+ * ```
+ */
+export declare function updateBounds(existingBounds: Rectangle | undefined, x: number, y: number, width: number, height: number): Rectangle;
+//# sourceMappingURL=PixiUtils.d.ts.map

package/dist/utils/PixiUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixiUtils.d.ts","sourceRoot":"","sources":["../../utils/PixiUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE;QAAE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAW,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAE3F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,MAAM,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACjC,aAAa,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,IAAI,CAUN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ9F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE;IACN,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,GACA,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,SAAS,GAAG,SAAS,EACrC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,SAAS,CASX"}

package/dist/utils/Throttle.d.ts

@@ -0,0 +1,103 @@
+interface DebounceSettings {
+    /** Specify invoking on the leading edge of the timeout. */
+    leading?: boolean | undefined;
+    /** The maximum time func is allowed to be delayed before it's invoked. */
+    maxWait?: number | undefined;
+    /** Specify invoking on the trailing edge of the timeout. */
+    trailing?: boolean | undefined;
+}
+interface DebounceSettingsLeading extends DebounceSettings {
+    leading: true;
+}
+export interface DebouncedFunc<T extends (...args: any[]) => any> {
+    /**
+     * Call the original function, but applying the debounce rules.
+     *
+     * If the debounced function can be run immediately, this calls it and returns
+     * its return value.
+     *
+     * Otherwise, it returns the return value of the last invocation, or undefined
+     * if the debounced function was not invoked yet.
+     */
+    (...args: Parameters<T>): ReturnType<T> | undefined;
+    /** Throw away any pending invocation of the debounced function. */
+    cancel(): void;
+    /**
+     * If there is a pending invocation of the debounced function, invoke it
+     * immediately and return its return value.
+     *
+     * Otherwise, return the value from the last invocation, or undefined if the
+     * debounced function was never invoked.
+     */
+    flush(): ReturnType<T> | undefined;
+    /** Check if there is a pending invocation. */
+    pending(): boolean;
+}
+interface DebouncedFuncLeading<T extends (...args: any[]) => any> extends DebouncedFunc<T> {
+    (...args: Parameters<T>): ReturnType<T>;
+    flush(): ReturnType<T>;
+}
+/**
+ * Creates a debounced function that delays invoking `func` until after `wait`
+ * milliseconds have elapsed since the last time the debounced function was
+ * invoked, or until the next browser frame is drawn. The debounced function
+ * comes with a `cancel` method to cancel delayed `func` invocations and a
+ * `flush` method to immediately invoke them. Provide `options` to indicate
+ * whether `func` should be invoked on the leading and/or trailing edge of the
+ * `wait` timeout. The `func` is invoked with the last arguments provided to the
+ * debounced function. Subsequent calls to the debounced function return the
+ * result of the last `func` invocation.
+ *
+ * **Note:** If `leading` and `trailing` options are `true`, `func` is invoked
+ * on the trailing edge of the timeout only if the debounced function is invoked
+ * more than once during the `wait` timeout.
+ *
+ * If `wait` is `0` and `leading` is `false`, `func` invocation is deferred
+ * until the next tick, similar to `setTimeout` with a timeout of `0`.
+ *
+ * If `wait` is omitted in an environment with `requestAnimationFrame`, `func`
+ * invocation will be deferred until the next frame is drawn (typically about
+ * 16ms).
+ *
+ * @param func The function to debounce.
+ * @param wait The number of milliseconds to delay. Default is `0`.
+ * @param options The options object. Default is `{}`.
+ * @returns Returns the new debounced function.
+ */
+export declare function debounce<T extends (...args: any) => any>(func: T, wait: number | undefined, options: DebounceSettingsLeading): DebouncedFuncLeading<T>;
+export declare function debounce<T extends (...args: any) => any>(func: T, wait?: number, options?: DebounceSettings): DebouncedFunc<T>;
+export interface ThrottleSettings {
+    /** Specify invoking on the leading edge of the timeout. */
+    leading?: boolean | undefined;
+    /** Specify invoking on the trailing edge of the timeout. */
+    trailing?: boolean | undefined;
+}
+/**
+ * Creates a throttled function that only invokes `func` at most once per every
+ * `wait` milliseconds (or once per browser frame). The throttled function comes
+ * with a `cancel` method to cancel delayed `func` invocations and a `flush`
+ * method to immediately invoke them. Provide `options` to indicate whether
+ * `func` should be invoked on the leading and/or trailing edge of the `wait`
+ * timeout. The `func` is invoked with the last arguments provided to the
+ * throttled function. Subsequent calls to the throttled function return the
+ * result of the last `func` invocation.
+ *
+ * **Note:** If `leading` and `trailing` options are `true`, `func` is invoked
+ * on the trailing edge of the timeout only if the throttled function is invoked
+ * more than once during the `wait` timeout.
+ *
+ * If `wait` is `0` and `leading` is `false`, `func` invocation is deferred
+ * until the next tick, similar to `setTimeout` with a timeout of `0`.
+ *
+ * If `wait` is omitted in an environment with `requestAnimationFrame`, `func`
+ * invocation will be deferred until the next frame is drawn (typically about
+ * 16ms).
+ *
+ * @param func The function to throttle.
+ * @param wait The number of milliseconds to throttle invocations to. Default is `0`.
+ * @param options The options object. Default is `{}`.
+ * @returns Returns the new throttled function.
+ */
+export declare function throttle<T extends (...args: any) => any>(func: T, wait?: number, options?: ThrottleSettings): DebouncedFunc<T>;
+export {};
+//# sourceMappingURL=Throttle.d.ts.map

package/dist/utils/Throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Throttle.d.ts","sourceRoot":"","sources":["../../utils/Throttle.ts"],"names":[],"mappings":"AAAA,UAAU,gBAAgB;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,UAAU,uBAAwB,SAAQ,gBAAgB;IACxD,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IAC9D;;;;;;;;OAQG;IACH,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAEpD,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAAC;IAEf;;;;;;OAMG;IACH,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAEnC,8CAA8C;IAC9C,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,UAAU,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IACxF,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EACtD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,uBAAuB,GAC/B,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAC3B,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EACtD,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,CAAC,CAAC,CAAC,CAAC;AAmKpB,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EACtD,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAAC,CAAC,CAAC,CAalB"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './Logger';
+export * from './DataInjector';
+export * from './ColorUtils';
+export * from './NumberFormatter';
+export * from './ArrayUtils';
+export * from './ObjectUtils';
+export * from './PixiUtils';
+export * from './Throttle';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}