@caperjs/core 0.1.0

package/lib/plugins/KeyboardPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyboardPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/KeyboardPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAS,WAAW,EAAU,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC,CAAC;AAEtE,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/B,SAAS,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAS5D;AAED,qBAAa,cAAe,SAAQ,MAAO,YAAW,eAAe;IACnE,SAAgB,EAAE,EAAE,MAAM,CAAc;IAEjC,eAAe,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC,CAAgB;IAC9E,aAAa,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC,CAAgB;IAEnF,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,aAAa,CAAiD;IAEtE,OAAO,CAAC,SAAS,CAA0B;IAG3C,OAAO,CAAC,kBAAkB,CAAS;IAEnC,IAAI,QAAQ,gBAEX;IAED,OAAO,CAAC,QAAQ,CAAiB;IAEjC,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAEhC;IAGM,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAMnD,OAAO;IAOP,SAAS,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,SAAS;IAIvC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,SAAS;IAIrC,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO;IAI3C,OAAO;IAIP,SAAS,CAAC,cAAc,IAAI,MAAM,EAAE;IAIpC,SAAS,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAItC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,YAAY;IAkBpB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,YAAY;CASrB"}

package/lib/plugins/LayoutPlugin.d.ts

@@ -0,0 +1,100 @@
+import { Plugin, IPlugin } from './Plugin';
+/**
+ * Interface for the Layout plugin providing PIXI.js layout management.
+ * Enables advanced CSS-like layout capabilities for PIXI display objects.
+ */
+export interface ILayoutPlugin extends IPlugin {
+}
+/**
+ * Layout management plugin for PIXI.js applications using @pixi/layout.
+ *
+ * Integrates the @pixi/layout library to provide CSS-like layout capabilities
+ * for PIXI display objects, including flexbox, positioning, and responsive design.
+ * Automatically configures sensible default styles for consistent layout behavior.
+ *
+ * Key Features:
+ * - CSS Flexbox-like layout system for PIXI containers
+ * - Responsive design capabilities with intrinsic sizing
+ * - Automatic layout calculation and positioning
+ * - Gap, padding, and margin support
+ * - Transform origin and object positioning controls
+ * - Development tools integration for layout debugging
+ *
+ * Default Style Configuration:
+ * - Container: Auto width/height with no gap
+ * - Leaf: Intrinsic sizing with flex shrink enabled
+ * - Shared: Center transform origin, row direction, stretch alignment
+ *
+ * @example
+ * ```typescript
+ * // Plugin is automatically initialized with the application
+ * // Layout capabilities are immediately available on all containers
+ *
+ * // Create a flexbox-style layout
+ * const container = new PIXI.Container();
+ * container.layout = {
+ *   display: 'flex',
+ *   flexDirection: 'row',
+ *   justifyContent: 'space-between',
+ *   alignItems: 'center',
+ *   gap: 10,
+ *   padding: 20
+ * };
+ *
+ * // Add children that will be automatically laid out
+ * const button1 = new PIXI.Sprite(buttonTexture);
+ * const button2 = new PIXI.Sprite(buttonTexture);
+ * const button3 = new PIXI.Sprite(buttonTexture);
+ *
+ * container.addChild(button1, button2, button3);
+ * // Children are automatically positioned using flexbox rules
+ *
+ * // Responsive design with intrinsic sizing
+ * const responsiveContainer = new PIXI.Container();
+ * responsiveContainer.layout = {
+ *   width: '100%',
+ *   maxWidth: 800,
+ *   flexDirection: 'column',
+ *   alignItems: 'center'
+ * };
+ * ```
+ *
+ * @remarks
+ * - Requires @pixi/layout package to be installed
+ * - Provides devtools integration for layout debugging in development
+ * - Default styles are optimized for common game UI patterns
+ * - Layout calculations happen automatically when display objects are added/modified
+ * - Supports both absolute and relative positioning
+ */
+export declare class LayoutPlugin extends Plugin implements ILayoutPlugin {
+    /** Plugin identifier for framework registration */
+    readonly id = "LayoutPlugin";
+    /**
+     * Initializes the Layout plugin with optimized default styles.
+     * Configures the @pixi/layout system with sensible defaults for game development,
+     * including flexbox behavior, sizing, and alignment settings.
+     *
+     * Default Configuration Details:
+     * - **Container styles**: Auto-sizing with no gaps for efficient nesting
+     * - **Leaf styles**: Intrinsic sizing with flex shrink for responsive behavior
+     * - **Shared styles**: Center origins, row direction, and stretch alignment
+     * - **Transform origin**: Set to 50% for predictable scaling and rotation
+     * - **Object position**: Centered for consistent alignment behavior
+     *
+     * @example
+     * ```typescript
+     * // Called automatically by the plugin system
+     * // After initialization, all PIXI containers support layout properties
+     *
+     * const container = new PIXI.Container();
+     * container.layout = {
+     *   display: 'flex',        // Use flexbox layout
+     *   flexDirection: 'column', // Stack children vertically
+     *   gap: 10,                // 10px gap between children
+     *   padding: 15             // 15px padding around content
+     * };
+     * ```
+     */
+    initialize(): Promise<void>;
+}
+//# sourceMappingURL=LayoutPlugin.d.ts.map

package/lib/plugins/LayoutPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/LayoutPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO;CAAG;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBAAa,YAAa,SAAQ,MAAO,YAAW,aAAa;IAC/D,mDAAmD;IACnD,SAAgB,EAAE,kBAAkB;IAEpC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,UAAU;CAuBjB"}

package/lib/plugins/LookupPlugin.d.ts

@@ -0,0 +1,223 @@
+import { Container as PIXIContainer } from 'pixi.js';
+import { IPlugin, Plugin } from '.';
+/**
+ * Interface for the LookupPlugin providing fast container lookup functionality.
+ * Enables O(1) lookups of PIXI containers using hierarchical path strings.
+ */
+export interface ILookupPlugin extends IPlugin {
+    /**
+     * Retrieves a container at the specified hierarchical path.
+     * @param path - Slash-separated path like 'Parent/Child/GrandChild'
+     * @returns The container at the path, or undefined if not found
+     * @example
+     * ```typescript
+     * const button = lookupPlugin.getChildAtPath('UI/Menu/StartButton');
+     * ```
+     */
+    getChildAtPath(path: string): PIXIContainer | undefined;
+    /**
+     * Gets the hierarchical path for a given container.
+     * @param container - The PIXI container to get the path for
+     * @returns The hierarchical path string, or empty string if not tracked
+     * @example
+     * ```typescript
+     * const path = lookupPlugin.getPathForChild(myContainer); // 'Parent/Child'
+     * ```
+     */
+    getPathForChild(container: PIXIContainer): string;
+    /**
+     * Batch retrieval of containers at multiple paths.
+     * @param paths - Array of hierarchical paths to look up
+     * @returns Array of containers found at the specified paths (undefined entries filtered out)
+     * @example
+     * ```typescript
+     * const [ui, player] = lookupPlugin.getChildrenAtPaths('UI/HUD', 'Game/Player');
+     * ```
+     */
+    getChildrenAtPaths(...paths: string[]): PIXIContainer[];
+    /**
+     * Batch retrieval of paths for multiple containers.
+     * @param containers - Array of PIXI containers to get paths for
+     * @returns Array of hierarchical paths for the containers
+     * @example
+     * ```typescript
+     * const paths = lookupPlugin.getPathsForChildren(container1, container2);
+     * ```
+     */
+    getPathsForChildren(...containers: PIXIContainer[]): string[];
+    /**
+     * Gets all currently tracked hierarchical paths.
+     * @returns Array of all path strings in the lookup system
+     * @example
+     * ```typescript
+     * const allPaths = lookupPlugin.getAllPaths(); // ['UI/Menu', 'Game/Player', ...]
+     * ```
+     */
+    getAllPaths(): string[];
+}
+/**
+ * High-performance container lookup plugin for PIXI.js applications.
+ *
+ * Provides O(1) lookup of containers using hierarchical path strings by maintaining
+ * bidirectional maps between paths and containers. Automatically tracks container
+ * hierarchy changes through global Container events.
+ *
+ * @example
+ * ```typescript
+ * // Access containers by path
+ * const player = app.lookup.getChildAtPath('Game/Entities/Player');
+ * const menuButton = app.lookup.getChildAtPath('UI/MainMenu/StartButton');
+ *
+ * // Get paths for containers
+ * const playerPath = app.lookup.getPathForChild(playerSprite); // 'Game/Entities/Player'
+ * ```
+ *
+ * @remarks
+ * - Paths are built using container labels in hierarchical order
+ * - Only containers with labels are included in paths
+ * - Automatically handles container addition/removal through event listeners
+ * - Uses Map data structures for optimal performance
+ */
+export declare class LookupPlugin extends Plugin implements ILookupPlugin {
+    name: string;
+    /** Fast O(1) lookup map: hierarchical path -> container reference */
+    private pathToContainer;
+    /** Reverse lookup for efficient path updates: container reference -> hierarchical path */
+    private containerToPath;
+    /**
+     * Core function names exposed by this plugin for framework integration.
+     */
+    get coreFunctions(): string[];
+    /**
+     * Initializes the lookup plugin by connecting to global container events.
+     * Sets up automatic tracking of container hierarchy changes.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Fast O(1) lookup of container by hierarchical path.
+     *
+     * @param path - Slash-separated path like 'Parent/Child/GrandChild'
+     * @returns The container at the specified path, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * // Get a specific UI element
+     * const healthBar = lookup.getChildAtPath('UI/HUD/HealthBar');
+     * if (healthBar) {
+     *   // Update health display
+     *   healthBar.visible = true;
+     * }
+     * ```
+     */
+    getChildAtPath(path: string): PIXIContainer | undefined;
+    /**
+     * Batch retrieval of containers at multiple paths.
+     * Filters out undefined results for convenience.
+     *
+     * @param paths - Variable number of hierarchical paths to look up
+     * @returns Array of found containers (undefined entries filtered out)
+     *
+     * @example
+     * ```typescript
+     * // Get multiple UI elements at once
+     * const [menu, hud, inventory] = lookup.getChildrenAtPaths(
+     *   'UI/MainMenu',
+     *   'UI/HUD',
+     *   'UI/Inventory'
+     * );
+     * ```
+     */
+    getChildrenAtPaths(...paths: string[]): PIXIContainer[];
+    /**
+     * Get the hierarchical path for a given container.
+     *
+     * @param container - The container to get the path for
+     * @returns The hierarchical path or empty string if not tracked
+     *
+     * @example
+     * ```typescript
+     * // Get path for debugging or logging
+     * const containerPath = lookup.getPathForChild(someSprite);
+     * console.log(`Container is at: ${containerPath}`);
+     * ```
+     */
+    getPathForChild(container: PIXIContainer): string;
+    /**
+     * Batch retrieval of paths for multiple containers.
+     *
+     * @param containers - Variable number of PIXI containers to get paths for
+     * @returns Array of hierarchical paths for the containers
+     *
+     * @example
+     * ```typescript
+     * // Get paths for multiple containers for debugging
+     * const paths = lookup.getPathsForChildren(sprite1, sprite2, sprite3);
+     * console.log('Container paths:', paths);
+     * ```
+     */
+    getPathsForChildren(...containers: PIXIContainer[]): string[];
+    /**
+     * Gets all currently tracked hierarchical paths.
+     * Useful for debugging, serialization, or introspection.
+     *
+     * @returns Array of all path strings in the lookup system
+     *
+     * @example
+     * ```typescript
+     * // Debug all tracked containers
+     * const allPaths = lookup.getAllPaths();
+     * console.log('All tracked containers:', allPaths);
+     * ```
+     */
+    getAllPaths(): string[];
+    /**
+     * Gets all currently tracked containers.
+     * Useful for bulk operations or debugging.
+     *
+     * @returns Array of all container references in the lookup system
+     */
+    getAllChildren(): PIXIContainer[];
+    /**
+     * Event handler for when a child is added to any container.
+     * Automatically adds the new container to the lookup system.
+     *
+     * @param child - The newly added container
+     */
+    private onChildAdded;
+    /**
+     * Event handler for when a child is removed from any container.
+     * Automatically removes the container from the lookup system.
+     *
+     * @param child - The removed container
+     */
+    private onChildRemoved;
+    /**
+     * Add a container and all its descendants to the lookup system.
+     * Recursively processes the entire subtree to maintain lookup integrity.
+     *
+     * @param container - The container to add (along with all its children)
+     */
+    private addToLookup;
+    /**
+     * Remove a container and all its descendants from the lookup system.
+     * Recursively processes the entire subtree to prevent memory leaks.
+     *
+     * @param container - The container to remove (along with all its children)
+     */
+    private removeFromLookup;
+    /**
+     * Build the hierarchical path for a container by traversing up the parent chain.
+     * Only includes containers with labels in the path, stopping at 'Stage'.
+     *
+     * @param container - The container to build a path for
+     * @returns The hierarchical path string, or empty string if no labeled ancestors
+     *
+     * @example
+     * ```typescript
+     * // For a container structure: Stage -> Game -> Player -> HealthBar
+     * // Where each has a label, this would return: 'Game/Player/HealthBar'
+     * ```
+     */
+    private buildPath;
+}
+//# sourceMappingURL=LookupPlugin.d.ts.map

package/lib/plugins/LookupPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LookupPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/LookupPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC;AAGpC;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C;;;;;;;;OAQG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAExD;;;;;;;;OAQG;IACH,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAAC;IAElD;;;;;;;;OAQG;IACH,kBAAkB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAExD;;;;;;;;OAQG;IACH,mBAAmB,CAAC,GAAG,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;IAE9D;;;;;;;OAOG;IACH,WAAW,IAAI,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,SAAQ,MAAO,YAAW,aAAa;IACxD,IAAI,SAAY;IAEvB,qEAAqE;IACrE,OAAO,CAAC,eAAe,CAAoC;IAE3D,0FAA0F;IAC1F,OAAO,CAAC,eAAe,CAAoC;IAE3D;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,EAAE,CAE5B;IAED;;;OAGG;IACU,UAAU;IAKvB;;;;;;;;;;;;;;;OAeG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9D;;;;;;;;;;;;;;;;OAgBG;IACI,kBAAkB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;IAI9D;;;;;;;;;;;;OAYG;IACI,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM;IAIxD;;;;;;;;;;;;OAYG;IACI,mBAAmB,CAAC,GAAG,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE;IAIpE;;;;;;;;;;;;OAYG;IACI,WAAW,IAAI,MAAM,EAAE;IAI9B;;;;;OAKG;IACI,cAAc,IAAI,aAAa,EAAE;IAIxC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,SAAS;CAgBlB"}

package/lib/plugins/Plugin.d.ts

@@ -0,0 +1,132 @@
+import { IApplication } from '../core';
+import { SignalConnection, SignalConnections } from '../signals';
+import { AppTypeOverrides, ImportListItemModule } from '../utils';
+/**
+ * Public contract for a Caper plugin. A plugin is a long-lived object
+ * with `initialize` / `postInitialize` / `destroy` lifecycle hooks,
+ * registered at app bootstrap and accessed via `app.getPlugin(id)`.
+ *
+ * **Lifecycle order** (per plugin):
+ *
+ *   1. `constructor` — instantiated by the framework. Don't reference
+ *      the app yet; it isn't attached.
+ *   2. `initialize(options, app)` — set up internal state, parse options,
+ *      open connections, register signals. Awaited by the framework
+ *      before any other plugin's `initialize` runs (when ordered by
+ *      `requires`). Don't call out to other plugins here unless they
+ *      are listed in your `requires` — order isn't guaranteed otherwise.
+ *   3. `postInitialize(app)` — runs after every plugin has finished
+ *      `initialize`. Safe to look up sibling plugins via `app.getPlugin`
+ *      regardless of `requires`. Use for cross-plugin wiring.
+ *   4. (use phase) — the plugin is live; signal handlers fire, exposed
+ *      methods are called from scenes / other plugins / the app.
+ *   5. `destroy()` — called when the app shuts down. Tear down
+ *      connections, disconnect signals, free resources. The base class
+ *      already disconnects everything added via `addSignalConnection`.
+ *
+ * Discovery: plugin classes under `src/plugins/` are auto-discovered
+ * by the Vite plugin if they default-export a class. Annotate with
+ * `definePlugin({ id, requires })` for the canonical id and any
+ * dependency declarations:
+ *
+ * @example
+ * ```ts
+ * import { definePlugin, IApplication, Plugin } from '@caperjs/core';
+ *
+ * export const plugin = definePlugin({
+ *   id: 'leaderboard',
+ *   requires: ['firebase'],   // firebase initializes first
+ * });
+ *
+ * export default class LeaderboardPlugin extends Plugin {
+ *   public readonly id = 'leaderboard';
+ *
+ *   async initialize(_options, app) {
+ *     this.firebase = app.getPlugin('firebase'); // guaranteed to exist
+ *   }
+ * }
+ * ```
+ */
+export interface IPlugin<O = any> {
+    /** Unique plugin id. Must match the `definePlugin({ id })` value. */
+    id: string;
+    /** The owning application instance. Available after registration. */
+    app: IApplication;
+    /** Resolved options after `initialize` merges defaults with the user's. */
+    readonly options: O;
+    /**
+     * Set up the plugin. Called once at bootstrap, awaited before any
+     * dependent plugin's `initialize` runs. Use this to parse options,
+     * open connections, and register signals.
+     *
+     * @param options Partial options from `caper.config.ts plugins[]`.
+     * @param app The application instance, fully constructed but possibly
+     *   mid-bootstrap (other plugins may not yet be initialized — see
+     *   `requires` and `postInitialize`).
+     */
+    initialize(options: Partial<O>, app: IApplication): Promise<void> | void;
+    /**
+     * Cross-plugin wiring hook. Called after every plugin has finished
+     * `initialize`. Safe to look up siblings via `app.getPlugin(id)` here
+     * regardless of `requires` — they're all live.
+     */
+    postInitialize(_app: IApplication): Promise<void> | void;
+    /** Tear down. Called on app shutdown. */
+    destroy(): void;
+    /**
+     * Track a signal connection so it gets auto-disconnected on `destroy`.
+     * Prefer this over storing connections manually.
+     */
+    addSignalConnection(...args: SignalConnection[]): void;
+    /** Disconnect every connection added via `addSignalConnection`. */
+    clearSignalConnections(): void;
+    /** Register methods this plugin exposes via the core function registry. */
+    registerCoreFunctions(): void;
+    /** Register signals this plugin exposes via the core signal registry. */
+    registerCoreSignals(): void;
+}
+export interface PluginListItem {
+    id: string;
+    path: string;
+    module?: ImportListItemModule<IPlugin>;
+    assets?: string[];
+    plugins?: string[];
+    /**
+     * IDs of other plugins that must initialize before this one. Populated
+     * from `definePlugin({ requires: [...] })` for local plugins; carried
+     * through discovery to bootstrap so the framework can topologically
+     * sort the active plugin set.
+     */
+    requires?: string[];
+}
+export declare class Plugin<O = any> implements IPlugin<O> {
+    id: string;
+    private readonly __caper_method_binding_root;
+    protected _signalConnections: SignalConnections;
+    protected _options: O;
+    get options(): O;
+    constructor(id?: string);
+    get app(): AppTypeOverrides['App'];
+    destroy(): void;
+    initialize(options?: Partial<O>, _app?: IApplication): Promise<void> | void;
+    postInitialize(_app: IApplication): Promise<void> | void;
+    /**
+     * Add signal connections to the container.
+     * @param args - The signal connections to add.
+     */
+    addSignalConnection(...args: SignalConnection[]): void;
+    clearSignalConnections(): void;
+    /**
+     * @override
+     * @protected
+     */
+    registerCoreFunctions(): void;
+    /**
+     * @override
+     * @protected
+     */
+    registerCoreSignals(): void;
+    protected getCoreFunctions(): string[];
+    protected getCoreSignals(): string[];
+}
+//# sourceMappingURL=Plugin.d.ts.map

package/lib/plugins/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgC,MAAM,SAAS,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,KAAK,gBAAgB,EAAkB,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,GAAG;IAC9B,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IAEX,qEAAqE;IACrE,GAAG,EAAE,YAAY,CAAC;IAElB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpB;;;;;;;;;OASG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzE;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzD,yCAAyC;IACzC,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,mBAAmB,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAEvD,mEAAmE;IACnE,sBAAsB,IAAI,IAAI,CAAC;IAE/B,2EAA2E;IAC3E,qBAAqB,IAAI,IAAI,CAAC;IAE9B,yEAAyE;IACzE,mBAAmB,IAAI,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,MAAM,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAW7B,EAAE,EAAE,MAAM;IAV7B,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAQ;IAEpD,SAAS,CAAC,kBAAkB,EAAE,iBAAiB,CAA2B;IAE1E,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEtB,IAAI,OAAO,IAAI,CAAC,CAEf;gBAEkB,EAAE,GAAE,MAAiB;IAIxC,IAAW,GAAG,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAExC;IAEM,OAAO,IAAI,IAAI;IAIf,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAO3E,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAO/D;;;OAGG;IACI,mBAAmB,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE;IAM/C,sBAAsB;IAI7B;;;OAGG;IACI,qBAAqB,IAAI,IAAI;IASpC;;;OAGG;IACI,mBAAmB,IAAI,IAAI;IASlC,SAAS,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAItC,SAAS,CAAC,cAAc,IAAI,MAAM,EAAE;CAGrC"}

package/lib/plugins/Plugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Plugin.test.d.ts.map

package/lib/plugins/Plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.test.d.ts","sourceRoot":"","sources":["../../src/plugins/Plugin.test.ts"],"names":[],"mappings":""}

package/lib/plugins/PopupManagerPlugin.d.ts

@@ -0,0 +1,108 @@
+import { Container } from '../display';
+import { Signal } from '../signals';
+import { IPopup } from '../ui';
+import { PopupId, PopupInstance, PopupProps } from '../utils';
+import { IPlugin, Plugin } from './Plugin';
+/**`
+ * Interface for PopupManager
+ */
+export interface IPopupManagerPlugin extends IPlugin {
+    readonly view: Container;
+    readonly current: IPopup | undefined;
+    readonly hasActivePopups: boolean;
+    readonly popupCount: number;
+    readonly currentPopupId: string | number | undefined;
+    onShowPopup: Signal<(detail: PopupSignalDetail) => void>;
+    onHidePopup: Signal<(detail: PopupSignalDetail) => void>;
+    onPopupChanged: Signal<(detail: PopupSignalDetail) => void>;
+    /**
+     * Show a discovered popup by id. The `config.data` field is narrowed to
+     * the popup's declared data type (if it extends `Popup<MyData>`). Awaits
+     * the full show lifecycle (initialize → beforeShow → show animation).
+     */
+    showPopup<K extends PopupId>(id: K, config?: PopupProps<K>): Promise<PopupInstance<K> | undefined>;
+    /** Alias for `showPopup` — shorter when called as `this.popups.show(...)`. */
+    show<K extends PopupId>(id: K, config?: PopupProps<K>): Promise<PopupInstance<K> | undefined>;
+    hidePopup<T = any>(id: string | number, data?: any): Promise<IPopup<T> | undefined>;
+    removeAllPopups(animate?: boolean): void;
+}
+export type PopupSignalDetail<T = any> = {
+    id: string | number;
+    data?: T;
+};
+/**
+ * PopupManager
+ */
+export declare class PopupManagerPlugin extends Plugin implements IPopupManagerPlugin {
+    readonly id: string;
+    readonly view: Container;
+    onShowPopup: Signal<(detail: PopupSignalDetail) => void>;
+    onHidePopup: Signal<(detail: PopupSignalDetail) => void>;
+    onPopupChanged: Signal<(detail: PopupSignalDetail) => void>;
+    private _popups;
+    private _activePopups;
+    private _currentPopupId;
+    get currentPopupId(): string | number | undefined;
+    get popupCount(): number;
+    get current(): IPopup | undefined;
+    get hasActivePopups(): boolean;
+    /**
+     * Initialize the PopupManager. Reads the discovered `popupList` from the
+     * `caper-runtime` global and pre-registers every active popup. Dynamic
+     * imports are stored as-is and resolved on first `show()` call.
+     */
+    initialize(): void;
+    /**
+     * Destroy the PopupManager
+     */
+    destroy(): void;
+    /**
+     * Show a discovered popup by id.
+     * @param id - The id of the popup (typed against `AppPopups`).
+     * @param config - The configuration for the popup. `config.data` is
+     *   narrowed via the popup class's `Popup<T>` generic.
+     * @returns a promise resolving to the popup instance.
+     */
+    showPopup<K extends PopupId>(id: K, config?: PopupProps<K>): Promise<PopupInstance<K> | undefined>;
+    /** Alias for `showPopup`. */
+    show<K extends PopupId>(id: K, config?: PopupProps<K>): Promise<PopupInstance<K> | undefined>;
+    /**
+     * Hide a popup
+     * @param id - The id of the popup
+     * @param data
+     * @returns a promise resolving to the popup, if it exists
+     */
+    hidePopup<T = any>(id: string | number, data?: T): Promise<IPopup<T> | undefined>;
+    /**
+     * Remove all popups
+     * @param animate - Whether to animate the removal
+     */
+    removeAllPopups(animate?: boolean): void;
+    protected getCoreFunctions(): string[];
+    protected getCoreSignals(): string[];
+    /**
+     * Setup application listeners
+     * @private
+     */
+    private _setupAppListeners;
+    /**
+     * Pull every active popup off `globalThis.Caper.popupList` (populated by
+     * the `caper-runtime` virtual module before the Application starts) and
+     * seed the registry. Entries stay as dynamic-import functions until the
+     * first `show()` call resolves them.
+     */
+    private _registerDiscoveredPopups;
+    /**
+     * Ensure the popup constructor for `id` is loaded and return it. Resolves
+     * dynamic-import functions on first access, caches the result back onto
+     * the registry so subsequent shows are synchronous.
+     */
+    private _resolvePopupCtor;
+    /**
+     * Handle escape key press
+     * if the current popup should close when escape is pressed (true by default), closes it
+     * @private
+     */
+    private _handleEscape;
+}
+//# sourceMappingURL=PopupManagerPlugin.d.ts.map

package/lib/plugins/PopupManagerPlugin.d.ts.map

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

package/lib/plugins/ResizerPlugin.d.ts

@@ -0,0 +1,62 @@
+import { Size } from '../utils';
+import { IPlugin, Plugin } from './Plugin';
+/**
+ * Interface for Resizer module.
+ */
+export interface IResizerPlugin extends IPlugin {
+    readonly size: Size;
+    readonly scale: number;
+    resize(): Promise<Size>;
+}
+/**
+ * Configuration options for the Resizer plugin
+ */
+export type ResizerPluginOptions = {
+    /** Whether to scroll the window to the top when resizing */
+    autoScroll: boolean;
+    /** The minimum width at which the renderer will resize. Also controls aspect ratio in letterbox mode */
+    minWidth: number;
+    /** The minimum height of the canvas. Also controls aspect ratio in letterbox mode */
+    minHeight: number;
+    /** Whether to letterbox the canvas to maintain aspect ratio */
+    letterbox: boolean;
+    /** Whether to center the canvas (particularly useful in letterbox mode) */
+    center: boolean;
+    /** Whether to draw debug information for visualizing canvas bounds */
+    debug: boolean;
+};
+export declare class ResizerPlugin extends Plugin<ResizerPluginOptions> implements IResizerPlugin {
+    readonly id = "resizer";
+    private _debugContainer;
+    private _gfx;
+    private _size;
+    private _scale;
+    private _resizeId;
+    get size(): Size;
+    get scale(): number;
+    /**
+     * Initializes the Resizer module.
+     */
+    initialize(options: Partial<ResizerPluginOptions>): Promise<void>;
+    /**
+     * Post-initialization of the Resizer module.
+     * when this is called, the renderer is already created, and the dom element has been appended
+     */
+    postInitialize(): Promise<void>;
+    resize(): Promise<Size>;
+    _cancelResize: () => void;
+    _resizeInternal(w: number, h: number, minWidth: number, minHeight: number, letterbox: boolean): {
+        width: number;
+        height: number;
+        aspectRatio: number;
+    };
+    /**
+     * Resizes the application based on window size and module options.
+     */
+    _resize(): void;
+    /**
+     * Draws debug information if debug option is enabled.
+     */
+    private _drawDebug;
+}
+//# sourceMappingURL=ResizerPlugin.d.ts.map

package/lib/plugins/ResizerPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResizerPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/ResizerPlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC7C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAC;IACpB,wGAAwG;IACxG,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAcF,qBAAa,aAAc,SAAQ,MAAM,CAAC,oBAAoB,CAAE,YAAW,cAAc;IACvF,SAAgB,EAAE,aAAa;IAC/B,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAgB;IAEjC,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAIvD;;;OAGG;IACG,cAAc;IAId,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B,aAAa,QAAO,IAAI,CAKtB;IAEF,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;;;;;IAqB7F;;OAEG;IAEH,OAAO;IAuFP;;OAEG;IACH,OAAO,CAAC,UAAU;CAUnB"}