@caperjs/core 0.1.0

package/lib/plugins/SceneManagerPlugin.d.ts

@@ -0,0 +1,122 @@
+import { Container } from 'pixi.js';
+import { IApplication } from '../core';
+import { IScene, ISceneTransition, SceneTransition } from '../display';
+import { Signal } from '../signals';
+import { AppTypeOverrides, AssetTypes, BundleTypes, SceneId, SceneImportList, SceneLoadArgs } from '../utils';
+import { IPlugin, Plugin } from './Plugin';
+export type AppScenes = AppTypeOverrides['Scenes'];
+export interface ISceneManagerPlugin extends IPlugin {
+    isFirstScene: boolean;
+    onSceneChangeStart: Signal<(detail: {
+        exiting: string | null;
+        entering: string;
+    }) => void>;
+    onSceneChangeComplete: Signal<(detail: {
+        current: string;
+    }) => void>;
+    view: Container;
+    list: SceneImportList<IScene>;
+    splash: {
+        view: ISceneTransition | null;
+        hideWhen: SplashHideWhen;
+        zOrder: SplashZOrder;
+    };
+    transition?: ISceneTransition;
+    currentScene: IScene;
+    readonly ids: AppScenes[];
+    readonly defaultScene: string;
+    readonly debugGroupsList: any[];
+    setDefaultLoadMethod(method: LoadSceneMethod): void;
+    loadDefaultScene(): Promise<void>;
+    /** Typed overload — enforces `props` required when `Scene<Props>` declares a non-void generic. */
+    loadScene<K extends SceneId>(id: K, ...args: SceneLoadArgs<K>): Promise<void>;
+    loadScene(sceneIdOrLoadSceneConfig: LoadSceneConfig | AppScenes): Promise<void>;
+    getSceneFromHash(): string | null;
+}
+export type LoadSceneMethod = 'immediate' | 'exitEnter' | 'enterExit' | 'enterBehind' | 'transitionExitEnter' | 'exitTransitionEnter';
+export type SplashHideWhen = 'firstSceneEnter' | 'requiredAssetsLoaded';
+export type SplashZOrder = 'top' | 'bottom';
+export type SplashOptions = {
+    view: ISceneTransition | typeof SceneTransition | null;
+    zOrder: SplashZOrder;
+    hideWhen: SplashHideWhen;
+    preload?: {
+        assets?: AssetTypes;
+        bundles?: BundleTypes;
+    };
+};
+export type LoadSceneConfig = {
+    id: AppScenes;
+    method?: LoadSceneMethod;
+};
+export declare class SceneManagerPlugin extends Plugin implements ISceneManagerPlugin {
+    readonly id: string;
+    onSceneChangeStart: Signal<(detail: {
+        exiting: string | null;
+        entering: string;
+    }) => void>;
+    onSceneChangeComplete: Signal<(detail: {
+        current: string;
+    }) => void>;
+    splash: {
+        view: ISceneTransition | null;
+        hideWhen: SplashHideWhen;
+        zOrder: SplashZOrder;
+        preload?: {
+            assets?: AssetTypes;
+            bundles?: BundleTypes;
+        };
+    };
+    transition?: ISceneTransition;
+    view: Container;
+    isFirstScene: boolean;
+    list: SceneImportList<IScene>;
+    groupOrder: string[];
+    currentScene: IScene;
+    defaultScene: string;
+    debugGroupsList: any[];
+    private _sceneModules;
+    /** Props for the pending `loadScene(id, props)` call, assigned onto the new scene before `initialize()` runs. */
+    private _pendingLoadProps;
+    private _lastScene;
+    private _queue;
+    private _defaultLoadMethod;
+    private _currentSceneId;
+    private _debugVisible;
+    private _debugMenu;
+    private _useHash;
+    private _sceneSelect;
+    constructor();
+    get ids(): string[];
+    setDefaultLoadMethod(method: LoadSceneMethod): void;
+    destroy(): void;
+    initialize(_options: any, app: IApplication): Promise<void>;
+    private _onPause;
+    private _onResume;
+    loadDefaultScene(): Promise<void>;
+    loadScene<K extends SceneId>(id: K, ...args: SceneLoadArgs<K>): Promise<void>;
+    loadScene(sceneIdOrLoadSceneConfig: LoadSceneConfig | string): Promise<void>;
+    getSceneFromHash(): string | null;
+    protected getCoreSignals(): string[];
+    protected getCoreFunctions(): string[];
+    private _listenForHashChange;
+    private _createCurrentScene;
+    private _queueComplete;
+    private _destroyLastScene;
+    private _exitLastScene;
+    private _loadCurrentScene;
+    private _unloadLastScene;
+    private _initializeCurrentScene;
+    private _addCurrentScene;
+    private _addCurrentSceneBehind;
+    private _enterCurrentScene;
+    private _startCurrentScene;
+    private _showTransition;
+    private _hideTransition;
+    private _showSplash;
+    private _hideSplash;
+    private _createDebugMenu;
+    private _enableDebugMenu;
+    private _disableDebugMenu;
+}
+//# sourceMappingURL=SceneManagerPlugin.d.ts.map

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

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

package/lib/plugins/StatsPlugin.d.ts

@@ -0,0 +1,8 @@
+import { default as Stats } from 'stats.js';
+import { Plugin } from './Plugin';
+export declare class StatsPlugin extends Plugin {
+    readonly id = "StatsPlugin";
+    stats: Stats;
+    initialize(): Promise<void>;
+}
+//# sourceMappingURL=StatsPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StatsPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/StatsPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,UAAU,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,WAAY,SAAQ,MAAM;IACrC,SAAgB,EAAE,iBAAiB;IAC5B,KAAK,EAAE,KAAK,CAAC;IAEP,UAAU;CAcxB"}

package/lib/plugins/TimerPlugin.d.ts

@@ -0,0 +1,401 @@
+import { Signal } from '../signals';
+import { IPlugin, Plugin } from './Plugin';
+/**
+ * Configuration options for creating a timer.
+ */
+export interface TimerOptions {
+    /** Duration in milliseconds. If not provided, timer counts up indefinitely */
+    duration?: number;
+    /** Whether to start the timer immediately upon creation */
+    autoStart?: boolean;
+    /** Whether to restart the timer when it completes */
+    loop?: boolean;
+    /** Run timer in a web worker for better performance and independence from main thread */
+    useWorker?: boolean;
+    /** Update interval in milliseconds for worker-based timers. Default is 16ms (roughly 60fps) */
+    workerInterval?: number;
+    /** Callback fired when the timer completes. Not called in count-up mode */
+    onComplete?: () => void;
+    /** Callback fired on each timer tick with the remaining time (or elapsed time in count-up mode) */
+    onTick?: (remaining: number) => void;
+}
+export type TimeFormat = 'mm:ss' | 'hh:mm:ss' | 'ms';
+export type TimerObject = {
+    h: number;
+    m: number;
+    s: number;
+    ms: number;
+};
+/**
+ * Formats a time duration in milliseconds into a human-readable string or object.
+ * Supports multiple time formats and return types for flexible time representation.
+ *
+ * @param ms - Time duration in milliseconds to format
+ * @param format - Output format for string representation
+ *   - 'mm:ss' (default): Minutes and seconds (e.g., "02:30")
+ *   - 'hh:mm:ss': Hours, minutes, and seconds (e.g., "01:30:45")
+ *   - 'ms': Total seconds with milliseconds (e.g., "90.50")
+ * @param returnFormat - Determines the return type
+ *   - 'string' (default): Returns formatted time string
+ *   - 'object': Returns object with h, m, s, ms properties
+ *
+ * @returns Formatted time string or object containing time components
+ *
+ * @example
+ * ```typescript
+ * // Format as mm:ss string (default)
+ * formatTime(150000) // "02:30"
+ *
+ * // Format as hh:mm:ss string
+ * formatTime(5430000, 'hh:mm:ss') // "01:30:30"
+ *
+ * // Format as seconds with milliseconds
+ * formatTime(90500, 'ms') // "90.50"
+ *
+ * // Get time components as object
+ * formatTime(5430000, 'hh:mm:ss', 'object')
+ * // Returns: { h: 1, m: 30, s: 30, ms: 0 }
+ *
+ * // Use in a game timer display
+ * timer.onTick = (remaining) => {
+ *   display.text = formatTime(remaining, 'mm:ss');
+ * };
+ * ```
+ */
+export declare function formatTime(ms: number, format?: TimeFormat, returnFormat?: 'object'): TimerObject;
+export declare function formatTime(ms: number, format?: TimeFormat, returnFormat?: 'string'): string;
+/**
+ * A Timer instance that can count down or up, optionally running in a web worker.
+ *
+ * Features:
+ * - Count down from a duration or count up indefinitely
+ * - Run in main thread (synced with Pixi ticker) or web worker
+ * - Pause, resume, and reset functionality
+ * - Loop option for repeating timers
+ * - Tick and completion callbacks
+ *
+ * @example
+ * ```typescript
+ * // Create a 10-second countdown timer
+ * const timer = new Timer({
+ *   duration: 10000,
+ *   autoStart: true,
+ *   loop: true,
+ *   onTick: (remaining) => {
+ *     console.log(`${remaining / 1000} seconds remaining`);
+ *   },
+ *   onComplete: () => {
+ *     console.log('Timer completed!');
+ *   }
+ * }, timerPlugin);
+ *
+ * // Pause the timer
+ * timer.pause();
+ *
+ * // Resume the timer
+ * timer.start();
+ *
+ * // Reset the timer
+ * timer.reset();
+ * ```
+ */
+export declare class Timer {
+    private options;
+    private plugin;
+    private startTime;
+    private pausedTime;
+    private isPaused;
+    private isDestroyed;
+    private timerId;
+    private isWorkerTimer;
+    constructor(options: TimerOptions | undefined, plugin: TimerPlugin);
+    /**
+     * Starts or resumes the timer.
+     * If the timer was paused, it will continue from where it left off.
+     */
+    start(): void;
+    /**
+     * Pauses the timer, maintaining its current state.
+     * The timer can be resumed later from the same point.
+     */
+    pause(): void;
+    /**
+     * Resets the timer to its initial state.
+     * If the timer is not paused, it will start running immediately after reset.
+     */
+    reset(): void;
+    /**
+     * Destroys the timer, cleaning up all resources.
+     * A destroyed timer cannot be restarted.
+     */
+    destroy(): void;
+    private _destroy;
+    update(): void;
+    /**
+     * Gets the current time value (elapsed time for count-up, remaining time for countdown).
+     * @returns Time in milliseconds
+     */
+    getTime(): number;
+    /**
+     * Gets the remaining time for countdown timers.
+     * @returns Remaining time in milliseconds, or 0 for count-up timers
+     */
+    getRemainingTime(): number;
+    /**
+     * Gets the unique ID of this timer.
+     * @returns The timer's UUID
+     */
+    getId(): string;
+    /**
+     * Gets the timer's configuration options.
+     * @returns The TimerOptions object used to create this timer
+     */
+    getOptions(): TimerOptions;
+    /**
+     * Checks if this timer is running in a web worker.
+     * @returns true if the timer is worker-based, false if running on main thread
+     */
+    isWorker(): boolean;
+    /**
+     * Adds time to the timer. For countdown timers, this increases the duration.
+     * For count-up timers, this effectively adds time to the elapsed time.
+     *
+     * @param ms - Time to add in milliseconds
+     * @returns The new time value after adjustment
+     *
+     * @example
+     * ```typescript
+     * // Add 5 seconds to a countdown timer
+     * timer.addTime(5000);
+     *
+     * // Add 5 seconds to a count-up timer
+     * timer.addTime(5000);
+     * ```
+     */
+    addTime(ms: number): number;
+    /**
+     * Removes time from the timer. For countdown timers, this decreases the duration.
+     * For count-up timers, this effectively removes time from the elapsed time.
+     *
+     * @param ms - Time to remove in milliseconds
+     * @returns The new time value after adjustment
+     *
+     * @example
+     * ```typescript
+     * // Remove 5 seconds from a countdown timer
+     * timer.removeTime(5000);
+     *
+     * // Remove 5 seconds from a count-up timer
+     * timer.removeTime(5000);
+     * ```
+     */
+    removeTime(ms: number): number;
+}
+/**
+ * Interface for the Timer Plugin which manages both main-thread and web worker timers.
+ *
+ * The Timer Plugin provides functionality for:
+ * - Creating and managing countdown and count-up timers
+ * - Running timers in a web worker for better performance
+ * - Pausing and resuming all timers
+ * - Handling timer lifecycle events
+ *
+ * @example
+ * ```typescript
+ * // Create a 5-second countdown timer
+ * const countdown = this.app.timers.createTimer({
+ *   duration: 5000,
+ *   autoStart: true,
+ *   onTick: (remaining) => {
+ *     console.log(`Time remaining: ${formatTime(remaining, 'mm:ss')}`);
+ *   },
+ *   onComplete: () => {
+ *     console.log('Timer completed!');
+ *   }
+ * });
+ *
+ * // Create a count-up timer in a web worker
+ * const stopwatch = this.app.timers.createTimer({
+ *   useWorker: true,
+ *   workerInterval: 100, // Update every 100ms
+ *   onTick: (elapsed) => {
+ *     console.log(`Time elapsed: ${formatTime(elapsed, 'mm:ss')}`);
+ *   }
+ * });
+ *
+ * // Pause all timers
+ * this.app.timers.pauseAllTimers();
+ *
+ * // Resume all timers
+ * this.app.timers.resumeAllTimers();
+ * ```
+ */
+export interface ITimerPlugin extends IPlugin {
+    /**
+     * Signal emitted when a new timer is created.
+     * @example
+     * ```typescript
+     * this.app.timers.onTimerCreated.connect((timer) => {
+     *   console.log(`New timer created with ID: ${timer.getId()}`);
+     * });
+     * ```
+     */
+    onTimerCreated: Signal<(timer: Timer) => void>;
+    /**
+     * Signal emitted when a timer is destroyed.
+     * @example
+     * ```typescript
+     * this.app.timers.onTimerDestroyed.connect((timer) => {
+     *   console.log(`Timer destroyed: ${timer.getId()}`);
+     * });
+     * ```
+     */
+    onTimerDestroyed: Signal<(timer: Timer) => void>;
+    /**
+     * Signal emitted when all timers are paused.
+     * @example
+     * ```typescript
+     * this.app.timers.onAllTimersPaused.connect(() => {
+     *   console.log('All timers paused');
+     * });
+     * ```
+     */
+    onAllTimersPaused: Signal<() => void>;
+    /**
+     * Signal emitted when all timers are resumed.
+     * @example
+     * ```typescript
+     * this.app.timers.onAllTimersResumed.connect(() => {
+     *   console.log('All timers resumed');
+     * });
+     * ```
+     */
+    onAllTimersResumed: Signal<() => void>;
+    /**
+     * Creates a new timer with the specified options.
+     *
+     * @param options - Configuration options for the timer
+     * @returns A new Timer instance
+     *
+     * @example
+     * ```typescript
+     * // Create a looping timer that runs in a web worker
+     * const timer = this.app.timers.createTimer({
+     *   duration: 1000,
+     *   loop: true,
+     *   useWorker: true,
+     *   onTick: (remaining) => {
+     *     console.log(`${remaining}ms remaining`);
+     *   }
+     * });
+     * ```
+     */
+    createTimer(options?: TimerOptions): Timer;
+    /**
+     * Destroys a timer, cleaning up all resources and removing it from the plugin.
+     *
+     * @param timer - The timer instance to destroy
+     *
+     * @example
+     * ```typescript
+     * const timer = this.app.timers.createTimer({ duration: 5000 });
+     * // ... later ...
+     * this.app.timers.destroyTimer(timer);
+     * ```
+     */
+    destroyTimer(timer: Timer): void;
+    /**
+     * Pauses all active timers, both main thread and worker timers.
+     * Timers will maintain their current state and can be resumed later.
+     *
+     * @example
+     * ```typescript
+     * // Pause all timers when the game loses focus
+     * window.onblur = () => {
+     *   this.app.timers.pauseAllTimers();
+     * };
+     * ```
+     */
+    pauseAllTimers(): void;
+    /**
+     * Resumes all paused timers, both main thread and worker timers.
+     * Timers will continue from their paused state.
+     *
+     * @example
+     * ```typescript
+     * // Resume all timers when the game regains focus
+     * window.onfocus = () => {
+     *   this.app.timers.resumeAllTimers();
+     * };
+     * ```
+     */
+    resumeAllTimers(): void;
+    /**
+     * Destroys all active timers, both main thread and worker timers     .
+     * This will remove all timers from the plugin and stop them.
+     *
+     * @example
+     * ```typescript
+     * this.app.timers.destroyAllTimers();
+     * ```
+     */
+    destroyAllTimers(): void;
+    /**
+     * Resets a worker timer to its initial state.
+     * This is primarily used internally by the Timer class.
+     *
+     * @param timerId - The ID of the worker timer to reset
+     *
+     * @example
+     * ```typescript
+     * // This is typically called internally by the Timer class
+     * this.app.timers.resetWorkerTimer(timer.getId());
+     * ```
+     */
+    resetWorkerTimer(timerId: string): void;
+    /**
+     * Adjusts the time of a worker timer.
+     * This is primarily used internally by the Timer class.
+     *
+     * @param timerId - The ID of the worker timer to adjust
+     * @param timeAdjustment - The amount of time to add (positive) or remove (negative) in milliseconds
+     *
+     * @example
+     * ```typescript
+     * // This is typically called internally by the Timer class
+     * this.app.timers.adjustWorkerTimer(timer.getId(), 5000); // Add 5 seconds
+     * ```
+     */
+    adjustWorkerTimer(timerId: string, timeAdjustment: number): void;
+}
+export declare class TimerPlugin extends Plugin implements ITimerPlugin {
+    private mainThreadTimers;
+    private workerTimers;
+    private isPageVisible;
+    private worker;
+    private timerCallbacks;
+    private _hasWorkerSupport;
+    get hasWorkerSupport(): boolean;
+    readonly onTimerCreated: Signal<(timer: Timer) => void>;
+    readonly onTimerDestroyed: Signal<(timer: Timer) => void>;
+    readonly onAllTimersPaused: Signal<() => void>;
+    readonly onAllTimersResumed: Signal<() => void>;
+    constructor();
+    protected getCoreFunctions(): string[];
+    protected getCoreSignals(): string[];
+    postInitialize(): void;
+    private initWorker;
+    private handleWorkerMessage;
+    startWorkerTimer(timerId: string, options: TimerOptions): void;
+    stopWorkerTimer(timerId: string): void;
+    resetWorkerTimer(timerId: string): void;
+    destroy(): void;
+    private update;
+    createTimer(options?: TimerOptions): Timer;
+    destroyTimer(timer: Timer): void;
+    pauseAllTimers(): void;
+    resumeAllTimers(): void;
+    destroyAllTimers(): void;
+    adjustWorkerTimer(timerId: string, timeAdjustment: number): void;
+}
+//# sourceMappingURL=TimerPlugin.d.ts.map

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

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

package/lib/plugins/WebEventsPlugin.d.ts

@@ -0,0 +1,60 @@
+import { Application } from '../core/Application';
+import { Signal } from '../signals';
+import { Size, Orientation } from '../utils';
+import { IPlugin, Plugin } from './Plugin';
+export interface IWebEventsPlugin extends IPlugin {
+    onResize: Signal<(size: {
+        width: number;
+        height: number;
+    }) => void>;
+    onVisibilityChanged: Signal<(visible: boolean) => void>;
+    onOrientationChanged: Signal<({ orientation, screenOrientation }: {
+        orientation: Orientation;
+        screenOrientation: ScreenOrientation;
+    }) => void>;
+}
+/**
+ * Maintains a list of callbacks for specific web events and invokes callbacks when event occurs.
+ */
+export declare class WebEventsPlugin extends Plugin implements IWebEventsPlugin {
+    readonly id = "webEvents";
+    onResize: Signal<(size: Size) => void>;
+    onVisibilityChanged: Signal<(visible: boolean) => void>;
+    onOrientationChanged: Signal<({ orientation, screenOrientation }: {
+        orientation: Orientation;
+        screenOrientation: ScreenOrientation;
+    }) => void>;
+    private _debouncedEmitVisibility;
+    /**
+     * Creates callback arrays and registers to web events.
+     */
+    constructor();
+    get app(): Application;
+    initialize(): void;
+    destroy(): void;
+    protected getCoreSignals(): string[];
+    /**
+     * Called when the browser visibility changes. Passes the `hidden` flag of the document to all callbacks.
+     */
+    private _onVisibilityChanged;
+    /**
+     * Called when the browser resizes.
+     */
+    private _onResize;
+    /**
+     * Called when the page is hidden.
+     * Some browsers (like Safari) don't support the `visibilitychange` event, so we also listen for `pagehide`.
+     * We're just mimicking the `visibilitychange` event here.
+     */
+    private _onPageHide;
+    /**
+     * Called when the page is shown.
+     * Some browsers (like Safari) don't support the `visibilitychange` event, so we also listen for `pageshow`.
+     * We're just mimicking the `visibilitychange` event here.
+     * @private
+     */
+    private _onPageShow;
+    private _emitVisibilityChanged;
+    private _onOrientationChanged;
+}
+//# sourceMappingURL=WebEventsPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebEventsPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/WebEventsPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAA4C,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,CAAC;IACpE,mBAAmB,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC;IACxD,oBAAoB,EAAE,MAAM,CAC1B,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE;QAAE,WAAW,EAAE,WAAW,CAAC;QAAC,iBAAiB,EAAE,iBAAiB,CAAA;KAAE,KAAK,IAAI,CACjH,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,MAAO,YAAW,gBAAgB;IACrE,SAAgB,EAAE,eAAe;IAG1B,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,CAAsC;IAC5E,mBAAmB,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,CAA4C;IACnG,oBAAoB,EAAE,MAAM,CACjC,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE;QAAE,WAAW,EAAE,WAAW,CAAC;QAAC,iBAAiB,EAAE,iBAAiB,CAAA;KAAE,KAAK,IAAI,CACjH,CAEG;IACJ,OAAO,CAAC,wBAAwB,CAE1B;IAEN;;OAEG;;IAMH,IAAI,GAAG,IAAI,WAAW,CAErB;IAEM,UAAU,IAAI,IAAI;IASlB,OAAO;IAQd,SAAS,CAAC,cAAc,IAAI,MAAM,EAAE;IAIpC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,qBAAqB;CAoB9B"}

package/lib/plugins/actions/ActionsPlugin.d.ts

@@ -0,0 +1,39 @@
+import { Action, ActionContext, ActionDetail, ActionMap, ActionSignal } from '.';
+import { IApplication } from '../../core';
+import { Signal } from '../../signals';
+import { IPlugin, Plugin } from '../Plugin';
+export interface IActionsPlugin<C extends ActionContext = ActionContext> extends IPlugin {
+    context: C;
+    onActionContextChanged: Signal<(context: C) => void>;
+    onActionDispatched: Signal<(detail: ActionDetail) => void>;
+    initialize(options: Partial<IActionsPluginOptions>, app: IApplication): void;
+    getAction<TActionData = any>(action: Action | string): ActionSignal<TActionData>;
+    getActions(): ActionMap;
+    sendAction<TActionData = any>(actionId: Action | string, data?: TActionData): void;
+    setActionContext(context: C): string;
+    debug: boolean;
+}
+export interface IActionsPluginOptions {
+    actions: Partial<ActionMap>;
+}
+export declare class ActionsPlugin extends Plugin<IActionsPluginOptions> implements IActionsPlugin {
+    readonly id = "actions";
+    onActionContextChanged: Signal<(context: string | ActionContext) => void>;
+    onActionDispatched: Signal<(detail: ActionDetail) => void>;
+    private _context;
+    private _signals;
+    private _actions;
+    private _debug;
+    set debug(debug: boolean);
+    get debug(): boolean;
+    get context(): string | ActionContext;
+    set context(context: string | ActionContext);
+    initialize(_options: Partial<IActionsPluginOptions>, app: IApplication): void;
+    getAction<TActionData = any>(action: Action | string): ActionSignal<TActionData>;
+    getActions(): ActionMap;
+    sendAction<TActionData = any>(actionId: Action | string, data?: TActionData): void;
+    setActionContext(context: string | ActionContext): string;
+    protected getCoreFunctions(): string[];
+    protected getCoreSignals(): string[];
+}
+//# sourceMappingURL=ActionsPlugin.d.ts.map

package/lib/plugins/actions/ActionsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionsPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/actions/ActionsPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,CAAE,SAAQ,OAAO;IACtF,OAAO,EAAE,CAAC,CAAC;IACX,sBAAsB,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;IACrD,kBAAkB,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC,CAAC;IAC3D,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7E,SAAS,CAAC,WAAW,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACjF,UAAU,IAAI,SAAS,CAAC;IACxB,UAAU,CAAC,WAAW,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACnF,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7B;AAED,qBAAa,aAAc,SAAQ,MAAM,CAAC,qBAAqB,CAAE,YAAW,cAAc;IACxF,SAAgB,EAAE,aAAa;IAExB,sBAAsB,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,KAAK,IAAI,CAAC,CAE5E;IAEG,kBAAkB,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC,CAAgD;IAGjH,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAkB;IAChC,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAEvB;IACD,IAAI,KAAK,IAAI,OAAO,CAEnB;IAGD,IAAI,OAAO,IAAI,MAAM,GAAG,aAAa,CAEpC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAM1C;IAED,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,qBAAqB,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI;IAI7E,SAAS,CAAC,WAAW,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC;IAOhF,UAAU,IAAI,SAAS;IAIvB,UAAU,CAAC,WAAW,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IA6BlF,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM;IAKzD,SAAS,CAAC,gBAAgB,IAAI,MAAM,EAAE;IAItC,SAAS,CAAC,cAAc,IAAI,MAAM,EAAE;CAGrC"}