@caperjs/core 0.1.0

package/lib/utils/debug.d.ts

@@ -0,0 +1,34 @@
+import { Graphics, Text } from 'pixi.js';
+export declare const DebugColors: {
+    readonly bounds: 65535;
+    readonly innerBounds: 65280;
+    readonly outerBounds: 16711680;
+    readonly direction: 16776960;
+    readonly gap: 16711935;
+    readonly region: 30975;
+};
+export declare const DebugAlpha: {
+    readonly stroke: 0.6;
+    readonly fill: 0.1;
+    readonly fillActive: 0.2;
+    readonly crosshair: 0.5;
+};
+/**
+ * Creates a Graphics object pre-configured for debug overlays.
+ * Non-interactive, excluded from layout, labeled for identification.
+ */
+export declare function createDebugGraphics(label?: string): Graphics;
+/**
+ * Creates a small monospace Text label for debug overlays.
+ * Dark stroke ensures readability over any background.
+ */
+export declare function createDebugLabel(text: string, color?: number): Text;
+type DebugEntry = {
+    label: string;
+    color: number;
+};
+export declare function registerDebug(id: string, label: string, color: number): void;
+export declare function unregisterDebug(id: string): void;
+export declare function getDebugRegistry(): ReadonlyMap<string, DebugEntry>;
+export {};
+//# sourceMappingURL=debug.d.ts.map

package/lib/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAGzC,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAO5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAA2B,GAAG,IAAI,CAcvF;AAKD,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAGnD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAElE"}

package/lib/utils/define.d.ts

@@ -0,0 +1,100 @@
+import { SceneAssets, SceneDebug, ScenePlugins } from '../display/Scene';
+import { AppTypeOverrides } from './types';
+type AppPluginId = AppTypeOverrides['Plugins'];
+/**
+ * Runtime-free helpers that give scene/plugin/popup/entity config files
+ * strong type inference without forcing users to extend base classes or
+ * hand-type every file-level export.
+ *
+ * They are all typed identity functions (`(config) => config`), following
+ * the Vite / Rollup / Playwright `defineConfig` pattern. No runtime cost:
+ * the vite-plugin-caper-config scanner reads the call's object
+ * argument via AST just like it reads individual `export const` forms.
+ *
+ * Example:
+ *
+ *   // src/scenes/MenuScene.ts
+ *   import { defineScene, Scene } from '@caperjs/core';
+ *   export const scene = defineScene({
+ *     id: 'menu',
+ *     assets: { preload: { bundles: ['menu'] } },
+ *     plugins: ['google-analytics'],
+ *   });
+ *   export default class MenuScene extends Scene { ... }
+ */
+/**
+ * Scene metadata accepted by `defineScene`. Mirrors the runtime
+ * `SceneConfig` in `display/Scene.ts` — reuses the canonical `SceneAssets`
+ * / `ScenePlugins` / `SceneDebug` types so there's one source of truth.
+ *
+ * `id` is required here (unlike the runtime `SceneConfig` where it's
+ * optional, because the scene class itself may carry the id).
+ */
+export interface SceneConfigInput {
+    /** Unique scene ID used in `app.scenes.loadScene()`. */
+    id: string;
+    /** Defaults to `true`. Set `false` to hide from discovery without deleting the file. */
+    active?: boolean;
+    /** Defaults to `true` (code-split). Set `false` to force a static import. */
+    dynamic?: boolean;
+    /**
+     * Asset load configuration. Uses the canonical `SceneAssets` shape:
+     *
+     *   { preload: { bundles: [...] }, background: { bundles: [...] }, autoUnload: true }
+     */
+    assets?: SceneAssets;
+    /** Plugin IDs this scene requires. Loaded lazily on scene load. */
+    plugins?: ScenePlugins;
+    /** Labels used by the debug UI scene picker. */
+    debug?: SceneDebug;
+}
+export interface PluginConfigInput {
+    /** Unique plugin ID used in `app.getPlugin(id)`. */
+    id: string;
+    /** Defaults to `true`. Set `false` to hide from discovery without deleting the file. */
+    active?: boolean;
+    /** Defaults to `true` (code-split). Set `false` to force a static import. */
+    dynamic?: boolean;
+    /**
+     * Plugin IDs that must be initialized before this one. The framework
+     * topologically sorts plugins by `requires` at bootstrap, so the order
+     * in `caper.config.ts` doesn't matter — required deps will always
+     * `initialize()` (and `postInitialize()`) before any plugin that
+     * requires them.
+     *
+     * Bootstrap fails loudly if a required plugin id isn't registered in
+     * `caper.config.ts plugins[]`, or if there's a dependency cycle. The
+     * error message includes the fix.
+     *
+     * Build-time validation also checks `requires` against discovered
+     * plugin IDs and warns on typos before you ever run the app.
+     */
+    requires?: AppPluginId[];
+}
+export interface PopupConfigInput {
+    /** Unique popup ID used in `app.popups.show(id)`. */
+    id: string;
+    active?: boolean;
+    dynamic?: boolean;
+}
+export interface EntityConfigInput {
+    /** Unique entity ID used in `app.entities.create(id)`. */
+    id: string;
+    active?: boolean;
+    dynamic?: boolean;
+}
+export interface UIConfigInput {
+    /** Unique UI element ID used in `this.add.ui(id)`. */
+    id: string;
+    /** Defaults to `true`. Set `false` to hide from discovery without deleting the file. */
+    active?: boolean;
+    /** Defaults to `false` (static import). Set `true` to code-split. */
+    dynamic?: boolean;
+}
+export declare function defineScene<T extends SceneConfigInput>(config: T): T;
+export declare function definePlugin<T extends PluginConfigInput>(config: T): T;
+export declare function definePopup<T extends PopupConfigInput>(config: T): T;
+export declare function defineEntity<T extends EntityConfigInput>(config: T): T;
+export declare function defineUI<T extends UIConfigInput>(config: T): T;
+export {};
+//# sourceMappingURL=define.d.ts.map

package/lib/utils/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/utils/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEpE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEtE;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,gBAAgB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEpE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEtE;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAE9D"}

package/lib/utils/env.d.ts

@@ -0,0 +1,4 @@
+export declare const env: string | undefined;
+export declare const isDev: boolean;
+export declare const isProduction: boolean;
+//# sourceMappingURL=env.d.ts.map

package/lib/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,GAAG,oBAAuB,CAAC;AACxC,eAAO,MAAM,KAAK,SAAwB,CAAC;AAC3C,eAAO,MAAM,YAAY,SAAuB,CAAC"}

package/lib/utils/events.d.ts

@@ -0,0 +1,12 @@
+export declare enum CaperEvent {
+    REQUIRED_ASSETS_START = "caper-required-assets-start",
+    REQUIRED_ASSETS_PROGRESS = "caper-required-assets-progress",
+    REQUIRED_ASSETS_COMPLETE = "caper-required-assets-complete",
+    ASSETS_START = "caper-assets-start",
+    ASSETS_PROGRESS = "caper-assets-progress",
+    ASSETS_COMPLETE = "caper-assets-complete"
+}
+export type CaperProgressEvent = CustomEvent<{
+    progress: number;
+}>;
+//# sourceMappingURL=events.d.ts.map

package/lib/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,qBAAqB,gCAAgC;IACrD,wBAAwB,mCAAmC;IAC3D,wBAAwB,mCAAmC;IAC3D,YAAY,uBAAuB;IACnC,eAAe,0BAA0B;IACzC,eAAe,0BAA0B;CAC1C;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/lib/utils/framework.d.ts

@@ -0,0 +1,12 @@
+import { ImportListItem, ImportListItemModule } from './types';
+/**
+ * Retrieves the constructor of the module from the given import list item.
+ * If the module is a promise, it waits for it to resolve.
+ * If the module is a class, it returns it directly.
+ * If the module has a named export specified in the item, it returns that.
+ * Otherwise, it returns the default export of the module.
+ * @param {ImportListItem<T>} item The import list item to get the module from.
+ * @returns {Promise<Constructor<T>>} A promise that resolves to the constructor of the module.
+ */
+export declare function getDynamicModuleFromImportListItem<T = any>(item: ImportListItem<T>): Promise<ImportListItemModule<T>>;
+//# sourceMappingURL=framework.d.ts.map

package/lib/utils/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/utils/framework.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,cAAc,EAAE,oBAAoB,EAAC,MAAM,SAAS,CAAC;AAW1E;;;;;;;;GAQG;AACH,wBAAsB,kCAAkC,CAAC,CAAC,GAAG,GAAG,EAC9D,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAqBlC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,28 @@
+export * from './array';
+export * from './bind';
+export * from './canvas';
+export * from './color';
+export * from './console';
+export * from './debug';
+export * from './define';
+export * from './env';
+export * from './events';
+export * from './framework';
+export * from './map';
+export * from './math';
+export * from './misc';
+export * from './number';
+export * from './object';
+export * from './padding';
+export * from './pixi';
+export * from './platform';
+export * from './point';
+export * from './promise';
+export * from './random';
+export * from './rect';
+export * from './set';
+export * from './string';
+export * from './text';
+export * from './types';
+export * from './web';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/lib/utils/map.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Returns the map entry that comes before the entry with the provided key.
+ * If the provided key is the first entry in the map or doesn't exist in the map, the function returns undefined.
+ * @param {Map<K, V>} map The map to search in.
+ * @param {any} currentKey The key of the map entry that comes after the desired entry.
+ * @returns {[K, V] | undefined} The map entry that comes before the entry with the provided key, or undefined if such an entry doesn't exist.
+ */
+export declare function getPreviousMapEntry<K = any, V = any>(map: Map<K, V>, currentKey: any): [K, V] | undefined;
+/**
+ * Returns the map entry that comes after the entry with the provided key.
+ * If the provided key is the first entry in the map or doesn't exist in the map, the function returns undefined.
+ * @param {Map<K, V>} map The map to search in.
+ * @param {any} currentKey The key of the map entry that comes after the desired entry.
+ * @returns {[K, V] | undefined} The map entry that comes before the entry with the provided key, or undefined if such an entry doesn't exist.
+ */
+export declare function getNextMapEntry<K = any, V = any>(map: Map<K, V>, currentKey: any): [K, V] | undefined;
+/**
+ * Returns the last entry in the provided map.
+ * If the map is empty, the function returns undefined.
+ * @param {Map<K, V>} map The map to get the last entry from.
+ * @returns {[K, V] | undefined} The last entry in the map, or undefined if the map is empty.
+ */
+export declare function getLastMapEntry<K = any, V = any>(map: Map<K, V>): [K, V] | undefined;
+/**
+ * Returns the first entry in the provided map.
+ * If the map is empty, the function returns undefined.
+ * @param {Map<K, V>} map The map to get the last entry from.
+ * @returns {[K, V] | undefined} The last entry in the map, or undefined if the map is empty.
+ */
+export declare function getFirstMapEntry<K = any, V = any>(map: Map<K, V>): [K, V] | undefined;
+//# sourceMappingURL=map.d.ts.map

package/lib/utils/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/utils/map.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAUzG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAYrG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAErF"}

package/lib/utils/math.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Clamp a number
+ * @param pValue
+ * @param pMin
+ * @param pMax
+ */
+export declare function clamp(pValue: number, pMin: number, pMax: number): number;
+/**
+ * lerp
+ * @param pMin
+ * @param pMax
+ * @param pPerc
+ */
+export declare function lerp(pMin: number, pMax: number, pPerc: number): number;
+//# sourceMappingURL=math.d.ts.map

package/lib/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/lib/utils/misc.d.ts

@@ -0,0 +1,13 @@
+import { Size, SizeLike } from './types';
+export declare function resolveSizeLike(size?: SizeLike): Size;
+type DebouncedFunction<T extends (...args: any[]) => any> = (...args: Parameters<T>) => void;
+/**
+ * Debounce a function
+ * @param func - function to debounce
+ * @param wait - time in milliseconds
+ * @example const debounced = debounce(() => console.log('debounced'), 1000);
+ * @example window.addEventListener('resize', debounced);
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): DebouncedFunction<T>;
+export {};
+//# sourceMappingURL=misc.d.ts.map

package/lib/utils/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAerD;AAED,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAevG"}

package/lib/utils/number.d.ts

@@ -0,0 +1,2 @@
+export declare function getZeroPaddedNumber(num: number, zeroPad?: number): string;
+//# sourceMappingURL=number.d.ts.map

package/lib/utils/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/utils/number.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,MAAM,CAE5E"}

package/lib/utils/object.d.ts

@@ -0,0 +1,21 @@
+import { DeepPartial } from './types';
+/**
+ * Plucks the specified keys from an object and returns a new object with only those keys.
+ * @template T The type of the original object.
+ * @template K The keys to pluck from the original object.
+ * @param {T} obj The original object.
+ * @param {K[]} keys The keys to pluck from the original object.
+ * @returns {Pick<T, K>} A new object with only the plucked keys.
+ */
+export declare function pluck<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Omits the specified keys from an object and returns a new object without those keys.
+ * @template T The type of the original object.
+ * @template K The keys to omit from the original object.
+ * @param {K[]} keysToOmit The keys to omit from the original object.
+ * @param {Partial<T>} obj The original object.
+ * @returns {Omit<T, K>} A new object without the omitted keys.
+ */
+export declare function omitKeys<T extends object, K extends keyof T>(keysToOmit: K[], obj: Partial<T>): Omit<T, K>;
+export declare function deepMerge<T extends Record<string, any>>(target: T, source: DeepPartial<T>): T;
+//# sourceMappingURL=object.d.ts.map

package/lib/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/utils/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAExF;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAI1G;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAc7F"}

package/lib/utils/padding.d.ts

@@ -0,0 +1,4 @@
+import { Padding, PointLike } from './types';
+export declare function resolvePadding(paddingNum: number, size: number): number;
+export declare function ensurePadding(padding: Partial<Padding> | PointLike): Padding;
+//# sourceMappingURL=padding.d.ts.map

package/lib/utils/padding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padding.d.ts","sourceRoot":"","sources":["../../src/utils/padding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAElD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAO9D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CA+B5E"}

package/lib/utils/pixi.d.ts

@@ -0,0 +1,42 @@
+import { Circle, Container, ContainerChild, Ellipse, Point, Polygon, Rectangle, RoundedRectangle } from 'pixi.js';
+import { PointLike, Size } from './types';
+export type PixiSimpleShape = Rectangle | Circle | Ellipse | RoundedRectangle;
+export type PixiShape = PixiSimpleShape | Polygon;
+/**
+ * Reassigns the displays object parent while maintaing it's world position
+ * @param pChild
+ * @param pParent
+ */
+export declare function reParent(pChild: ContainerChild, pParent: Container): void;
+/**
+ *
+ * @param pObject
+ */
+export declare function objectDiagonal(pObject: Container): number;
+/**
+ * Removes provided object from its parent and re-adds it.
+ * @param pObject The object to send to the back.
+ */
+export declare function sendToFront(pObject: Container): void;
+/**
+ * Removes provided object from its parent and re-adds it at index 0.
+ * @param pObject The object to send to the back.
+ */
+export declare function sendToBack(pObject: Container): void;
+/**
+ *
+ * @param pShape
+ * @param pDelta
+ */
+export declare function offsetShape(pShape: PixiShape, pDelta: Point): PixiShape;
+/**
+ *
+ * @param pShape
+ * @param pDelta
+ */
+export declare function offsetSimpleShape(pShape: PixiSimpleShape, pDelta: Point): PixiSimpleShape;
+export declare function scaleUniform(obj: any, scaleNum: number, scaleProp?: 'width' | 'height'): void;
+export declare function scaleToWidth(obj: Container, width: number): void;
+export declare function scaleToHeight(obj: Container, height: number): void;
+export declare function scaleToSize(obj: Container, size: PointLike | Size, firstProp?: 'width' | 'height'): void;
+//# sourceMappingURL=pixi.d.ts.map

package/lib/utils/pixi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixi.d.ts","sourceRoot":"","sources":["../../src/utils/pixi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAClH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,OAAO,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAOzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAKpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAKnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAG,SAAS,CAYvE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,GAAG,eAAe,CAIzF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,GAAG,QAAkB,QAK/F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,QAEzD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAE3D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,GAAE,OAAO,GAAG,QAAkB,QAmB1G"}

package/lib/utils/platform.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks if the device has a retina display.
+ * A device is considered to have a retina display if its device pixel ratio is greater than 1,
+ * or if it matches the media query for high resolution displays.
+ * @type {boolean}
+ */
+export declare const isRetina: boolean;
+/**
+ * Check if we're on a touch device
+ */
+export declare const isTouch: boolean;
+/**
+ * Checks if the device is a mobile device.
+ * This uses the `isMobile` function from the `@pixi/utils` package.
+ * @type {boolean}
+ */
+export declare const isMobile: boolean;
+export declare const isAndroid: boolean;
+export declare const isIos: boolean;
+//# sourceMappingURL=platform.d.ts.map

package/lib/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,SAOV,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAGX,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,QAAQ,SAAwB,CAAC;AAC9C,eAAO,MAAM,SAAS,SAAmC,CAAC;AAC1D,eAAO,MAAM,KAAK,SAAiC,CAAC"}

package/lib/utils/point.d.ts

@@ -0,0 +1,66 @@
+import { Point, PointLike } from 'pixi.js';
+import { PointLike as CaperPointLike } from './types';
+/**
+ * Add the x and the y values of two Points together and return a new point.
+ * @returns Point
+ * @param a
+ * @param b
+ */
+export declare function add(a: PointLike, b: PointLike): Point;
+/**
+ * Increase the x,y of point A by the x,y of point B.
+ * @param a
+ * @param b
+ */
+export declare function addToPoint(a: PointLike, b: PointLike): void;
+/**
+ * Subtract the x and the y values of point B from Point A and return a new point.
+ * @param a
+ * @param b
+ */
+export declare function subtract(a: PointLike, b: PointLike): Point;
+/**
+ * Decrease the x,y of point A by the x,y of point B.
+ * @param a
+ * @param b
+ */
+export declare function subtractFromPoint(a: PointLike, b: PointLike): void;
+/**
+ * Multply the x,y values of a point by the provided value.
+ * @param a
+ * @param pMult
+ */
+export declare function multiply(a: PointLike, pMult: number): Point;
+/**
+ *
+ * @param pt
+ * @param percent
+ */
+export declare function lerpPoint(pt: PointLike, percent: number): number;
+/**
+ * Get the distance between two points.
+ * @param a
+ * @param b
+ */
+export declare function distance(a: PointLike, b: Point): number;
+/**
+ * Get the squared distance between two points.
+ * @param a
+ * @param b
+ */
+export declare function distanceSq(a: PointLike, b: Point): number;
+/**
+ * Gets the magnitude of a point.
+ * @param pt
+ */
+export declare function magnitude(pt: PointLike): number;
+export type PointLikeResult = {
+    x: number;
+    y: number;
+} | Point;
+export declare function resolvePointLike(position?: CaperPointLike, asPoint?: false, x?: number, y?: number): {
+    x: number;
+    y: number;
+};
+export declare function resolvePointLike(position?: CaperPointLike, asPoint?: true, x?: number, y?: number): Point;
+//# sourceMappingURL=point.d.ts.map

package/lib/utils/point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../src/utils/point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,KAAK,CAErD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,KAAK,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC;AAE/D,wBAAgB,gBAAgB,CAC9B,QAAQ,CAAC,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,KAAK,EACf,CAAC,CAAC,EAAE,MAAM,EACV,CAAC,CAAC,EAAE,MAAM,GACT;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5B,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC"}

package/lib/utils/promise/Queue.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Creates a new Queue with the given promises.
+ * @param {...(Promise<any> | (() => Promise<any | void>))[]} promises The promises to add to the queue.
+ * @returns {Queue} The created Queue.
+ */
+export declare function createQueue(...promises: (Promise<any> | (() => Promise<any | void>))[]): Queue;
+/**
+ * A class representing a queue of promises.
+ * @template T The type of the values that the promises in the queue resolve to.
+ */
+export declare class Queue<T = any | void> {
+    private _promises;
+    private _currentIndex;
+    private _isPaused;
+    private _isCanceled;
+    /**
+     * Creates a new Queue.
+     * @param {(Promise<any> | (() => Promise<T>))[]} promises The promises to add to the queue.
+     */
+    constructor(promises?: (Promise<any> | (() => Promise<T>))[]);
+    private _results;
+    /**
+     * Gets the results of the promises that have been resolved so far.
+     * @returns {T[]} The results.
+     */
+    get results(): T[];
+    /**
+     * Gets the progress of the queue.
+     * @returns {number} The progress (0-1)
+     */
+    get progress(): number;
+    /**
+     * Adds promises to the queue.
+     * @param {...(Promise<any> | (() => Promise<T>))[]} args The promises to add.
+     */
+    add(...args: (Promise<any> | (() => Promise<T>))[]): void;
+    /**
+     * Starts the execution of the promises in the queue.
+     */
+    start(): void;
+    /**
+     * Pauses the execution of the promises in the queue.
+     */
+    pause(): void;
+    /**
+     * Resumes the execution of the promises in the queue.
+     */
+    resume(): void;
+    /**
+     * Cancels the execution of the promises in the queue.
+     */
+    cancel(): void;
+    /**
+     * Executes the next promise in the queue.
+     * @private
+     * @returns {Promise<void>} A promise that resolves when the next promise in the queue has been executed.
+     */
+    private _next;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/lib/utils/promise/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/utils/promise/Queue.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAE9F;AAED;;;GAGG;AACH,qBAAa,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI;IAC/B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;IAErC;;;OAGG;gBACS,QAAQ,GAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAO;IAIhE,OAAO,CAAC,QAAQ,CAAM;IAEtB;;;OAGG;IACH,IAAW,OAAO,IAAI,CAAC,EAAE,CAExB;IAED;;;OAGG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;IAIzD;;OAEG;IACI,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,MAAM,IAAI,IAAI;IAOrB;;OAEG;IACI,MAAM,IAAI,IAAI;IAKrB;;;;OAIG;YACW,KAAK;CA4BpB"}

package/lib/utils/promise/functions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delays the execution of the subsequent code.
+ * @param {number} seconds The delay time in seconds. Default is 0.
+ * @returns {Promise<void>} A promise that resolves after the specified delay.
+ */
+export declare const delay: (seconds?: number) => Promise<void>;
+export declare const wait: (seconds?: number) => Promise<void>;
+/**
+ * Checks if the given value is a promise.
+ * @param {any} value The value to check.
+ * @returns {boolean} True if the value is a promise, false otherwise.
+ */
+export declare const isPromise: (value: any) => value is Promise<any>;
+//# sourceMappingURL=functions.d.ts.map

package/lib/utils/promise/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/utils/promise/functions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,UAAS,MAAU,KAAG,OAAO,CAAC,IAAI,CACO,CAAC;AAEhE,eAAO,MAAM,IAAI,GAAI,UAAS,MAAU,KAAG,OAAO,CAAC,IAAI,CAAmB,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAA8C,CAAC"}

package/lib/utils/promise/index.d.ts

@@ -0,0 +1,3 @@
+export * from './functions';
+export * from './Queue';
+//# sourceMappingURL=index.d.ts.map

package/lib/utils/promise/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/lib/utils/random.d.ts

@@ -0,0 +1,42 @@
+import { Point } from 'pixi.js';
+/**
+ * Generates a UUID v4 string
+ * @returns {string} A UUID v4 string
+ */
+export declare function randomUUID(): string;
+/**
+ * Find a float between two numbers, inclusive of {@param min} and optionally inclusive of {@param max}.
+ * @param min The minimum value (inclusive)
+ * @param max The maximum value (exclusive by default)
+ * @param includeMax Whether the max value should be inclusive (default: false)
+ * @returns number
+ */
+export declare function floatBetween(min: number, max: number, includeMax?: boolean): number;
+/**
+ * Find a float between the x,y of a Point
+ * @param pt The point containing min (x) and max (y) values
+ * @param includeMax Whether the max value should be inclusive (default: false)
+ * @returns number
+ */
+export declare function floatBetweenPoint(pt: Point, includeMax?: boolean): number;
+/**
+ * Find an integer between two numbers, inclusive of {@param min} and optionally inclusive of {@param max}.
+ * @param min The minimum value (inclusive)
+ * @param max The maximum value (exclusive by default)
+ * @param includeMax Whether the max value should be inclusive (default: false)
+ * @returns number
+ */
+export declare function intBetween(min: number, max: number, includeMax?: boolean): number;
+/**
+ * Find an int between the x,y of a Point
+ * @param pt The point containing min (x) and max (y) values
+ * @param includeMax Whether the max value should be inclusive (default: false)
+ * @returns number
+ */
+export declare function intBetweenPoint(pt: Point, includeMax?: boolean): number;
+/**
+ * Get a random boolean value
+ * @returns boolean
+ */
+export declare function bool(): boolean;
+//# sourceMappingURL=random.d.ts.map

package/lib/utils/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/utils/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAYnC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,UAAQ,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,UAAQ,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B"}