@caperjs/core 0.1.0

package/lib/core/Application.d.ts

@@ -0,0 +1,268 @@
+import { gsap } from 'gsap';
+import { AppConfig, IApplication, IApplicationOptions, ICaperAutomation, ICoreFunctions, ICoreSignals, PauseConfig } from '.';
+import { ActionSignal, AppScenes, IAssetsPlugin, IAudioManagerPlugin, IBreakpointPlugin, IControls, IFocusManagerPlugin, Ii18nPlugin, IInputPlugin, IKeyboardPlugin, IPlugin, IPopupManagerPlugin, IResizerPlugin, ISceneManagerPlugin, IWebEventsPlugin, LoadSceneConfig } from '../plugins';
+import { AssetsManifest, DestroyOptions, RendererDestroyOptions, Container as PIXIContainer, Application as PIXIPApplication, Point } from 'pixi.js';
+import { IDataAdapter } from '../plugins/DataAdapter';
+import { IStore } from '../store';
+import { AppTypeOverrides, Eases, ImportList, ImportListItem, SceneId, SceneLoadArgs, Size } from '../utils';
+import { defaultFactoryMethods } from '../mixins';
+import { IActionsPlugin } from '../plugins/actions';
+import { IVoiceOverPlugin } from '../plugins/audio/VoiceOverPlugin';
+import { ICaptionsPlugin } from '../plugins/captions';
+import { IFullScreenPlugin } from '../plugins/FullScreenPlugin';
+import { IGSAPPlugin } from '../plugins/GSAPPlugin';
+import { ILookupPlugin } from '../plugins/LookupPlugin';
+import { ITimerPlugin } from '../plugins/TimerPlugin';
+import { Signal } from '../signals';
+type App = AppTypeOverrides['App'];
+type AppContexts = AppTypeOverrides['Contexts'];
+type AppActions = AppTypeOverrides['Actions'];
+type AppPlugins = AppTypeOverrides['Plugins'];
+export declare class Application extends PIXIPApplication implements IApplication {
+    static containerElement: HTMLElement;
+    static instance: IApplication;
+    private readonly __caper_method_binding_root;
+    private _debugContainer;
+    config: Partial<IApplicationOptions>;
+    /**
+     * Automation facade for Playwright / agent drivers. Only assigned when
+     * automation is enabled (dev env, `config.automation === true`, or
+     * `VITE_CAPER_AUTOMATION === 'true'`); otherwise undefined.
+     */
+    automation?: ICaperAutomation;
+    plugins: ImportList<IPlugin>;
+    manifest: string | AssetsManifest | undefined;
+    onPause: Signal<(config: PauseConfig) => void>;
+    onResume: Signal<(config: PauseConfig) => void>;
+    onResize: Signal<(size: Size) => void>;
+    /**
+     * Emitted when a plugin throws during initialize/postInitialize. Previously
+     * these failures bricked the app silently.
+     */
+    onPluginError: Signal<(detail: {
+        id: string;
+        phase: "initialize" | "postInitialize";
+        error: unknown;
+    }) => void>;
+    readonly _plugins: Map<string, IPlugin>;
+    protected _assetManager: IAssetsPlugin;
+    protected _lookup: ILookupPlugin;
+    protected _sceneManager: ISceneManagerPlugin;
+    protected _webEventsManager: IWebEventsPlugin;
+    protected _fullScreenPlugin: IFullScreenPlugin;
+    protected _keyboardManager: IKeyboardPlugin;
+    protected _focusManager: IFocusManagerPlugin;
+    protected _popupManager: IPopupManagerPlugin;
+    protected _timerPlugin: ITimerPlugin;
+    protected _audioManager: IAudioManagerPlugin;
+    protected _voiceoverPlugin: IVoiceOverPlugin;
+    protected _captionsPlugin: ICaptionsPlugin;
+    protected _actions: ActionSignal;
+    protected _isBooting: boolean;
+    protected _env: Record<string, string>;
+    protected _makeFactory: typeof defaultFactoryMethods;
+    protected _isFullScreen: boolean;
+    protected _fullScreenElement: HTMLElement | Window | null;
+    get make(): typeof defaultFactoryMethods;
+    get env(): Record<string, string>;
+    get debugContainer(): PIXIContainer;
+    protected _paused: boolean;
+    protected _pauseConfig: Partial<PauseConfig>;
+    get paused(): boolean;
+    pause(config?: Partial<PauseConfig>): void;
+    resume(): void;
+    togglePause(config?: Partial<PauseConfig>): void;
+    constructor();
+    protected _appVersion: string | number;
+    get appVersion(): string | number;
+    protected _appName: string;
+    get appName(): string;
+    protected _i18n: Ii18nPlugin;
+    get i18n(): Ii18nPlugin;
+    protected _resizer: IResizerPlugin;
+    get resizer(): IResizerPlugin;
+    protected _breakpoints: IBreakpointPlugin;
+    get breakpoints(): IBreakpointPlugin;
+    protected _actionsPlugin: IActionsPlugin<AppContexts>;
+    get actionsPlugin(): IActionsPlugin<AppContexts>;
+    protected _input: IInputPlugin;
+    get input(): IInputPlugin;
+    get controls(): IControls;
+    /**
+     * The GSAP plugin.
+     * @returns The GSAP plugin.
+     */
+    get animation(): IGSAPPlugin;
+    /**
+     * The GSAP instance.
+     * @returns The GSAP instance.
+     */
+    get anim(): typeof gsap;
+    /**
+     * Adds one or more GSAP tweens or timelines to a specified animation context.
+     * This uses the GSAPPlugin's custom animation context (a Set of tweens/timelines),
+     * not a `gsap.Context` instance. If no contextId is provided, animations are added
+     * to the plugin's global collection.
+     * @param animation - A single GSAP tween/timeline or an array of them.
+     * @param contextId - Optional ID of the animation context. Defaults to the global context.
+     * @returns The animation(s) that were added.
+     */
+    addAnimation(animation: gsap.core.Tween | gsap.core.Timeline | (gsap.core.Tween | gsap.core.Timeline)[], contextId?: string): gsap.core.Tween | gsap.core.Timeline | (gsap.core.Tween | gsap.core.Timeline)[];
+    /**
+     * Returns the registered eases or ease names.
+     * @param namesOnly - If true, returns only the ease names.
+     * @returns The registered eases or ease names.
+     */
+    eases(namesOnly?: boolean): Eases | string[];
+    protected _store: IStore;
+    get store(): IStore;
+    protected _center: Point;
+    get center(): Point;
+    get lookup(): ILookupPlugin;
+    getChildAtPath(path: string): PIXIContainer | undefined;
+    getPathForChild(container: PIXIContainer): string;
+    getChildrenAtPaths(...paths: string[]): PIXIContainer[];
+    getPathsForChildren(...containers: PIXIContainer[]): string[];
+    getAllPaths(): string[];
+    get assets(): IAssetsPlugin;
+    get scenes(): ISceneManagerPlugin;
+    loadScene<K extends SceneId>(id: K, ...args: SceneLoadArgs<K>): void;
+    loadScene(scene: LoadSceneConfig | AppScenes): void;
+    get webEvents(): IWebEventsPlugin;
+    get keyboard(): IKeyboardPlugin;
+    get focus(): IFocusManagerPlugin;
+    get size(): Size;
+    get popups(): IPopupManagerPlugin;
+    get timers(): ITimerPlugin;
+    get audio(): IAudioManagerPlugin;
+    get actionContext(): AppContexts;
+    set actionContext(context: AppContexts);
+    get voiceover(): IVoiceOverPlugin;
+    get captions(): ICaptionsPlugin;
+    /** Fullscreen plugin */
+    get fullScreen(): IFullScreenPlugin;
+    get fullScreenElement(): HTMLElement | Window | null;
+    get isFullScreen(): boolean;
+    get canFullscreen(): boolean;
+    setFullScreenElement(value: HTMLElement | Window | null): void;
+    setFullScreen(value: boolean): void;
+    toggleFullScreen(): void;
+    /** End Fullscreen plugin */
+    get isMobile(): boolean;
+    get isTouch(): boolean;
+    get signal(): ICoreSignals;
+    get signals(): ICoreSignals;
+    get func(): ICoreFunctions;
+    get exec(): ICoreFunctions;
+    protected _views: any[];
+    get views(): any[];
+    static getInstance<T extends App = App>(): T;
+    /**
+     * Destroy the application
+     * This will destroy all plugins and the store
+     * @param {RendererDestroyOptions} rendererDestroyOptions
+     * @param {DestroyOptions} options
+     */
+    destroy(rendererDestroyOptions?: RendererDestroyOptions, options?: DestroyOptions): void;
+    setContainer(container: HTMLElement): void;
+    initialize(config: Partial<AppConfig>, el?: HTMLElement): Promise<AppTypeOverrides['App']>;
+    getPlugin<T extends IPlugin>(pluginName: AppPlugins, debug?: boolean): T;
+    /**
+     * Framework post-initialization. Always runs the plugin `postInitialize` loop and
+     * core wiring, then invokes the user-overridable {@link postInitialize} hook last.
+     * The runtime (`create()`) calls this — apps should not call it directly, and must
+     * NOT need to call `super` from their own `postInitialize` override to get wired up.
+     */
+    _postInitialize(): Promise<void>;
+    /**
+     * User-overridable post-initialization hook, invoked after all framework wiring is
+     * complete. Override to perform app setup that depends on a fully initialized
+     * environment. Safe to override WITHOUT calling `super` — framework post-init lives
+     * in {@link _postInitialize}, which the runtime calls.
+     */
+    postInitialize(): Promise<void>;
+    getUnloadedPlugin(id: string): ImportListItem<IPlugin> | undefined;
+    loadPlugin(listItem: ImportListItem, isDefault?: boolean): Promise<void>;
+    /**
+     * Gets an ActionSignal for the specified action type
+     * @template TActionData - The type of data associated with the action
+     * @param {A} action - The action to get the signal for
+     * @returns {ActionSignal<TActionData>} A signal that can be used to listen for the action
+     * @example
+     * // Listen for a 'jump' action
+     * app.actions('jump').connect((data) => {
+     *   player.jump(data.power);
+     * });
+     */
+    actions<TActionData = any>(action: AppActions): ActionSignal<TActionData>;
+    /**
+     * Dispatches an action with optional data
+     * @template TActionData - The type of data to send with the action
+     * @param {A} action - The action to dispatch
+     * @param {TActionData} [data] - Optional data to send with the action
+     * @example
+     * // Send a 'jump' action with power data
+     * app.sendAction('jump', { power: 100 });
+     */
+    sendAction<TActionData = any>(action: AppActions, data?: TActionData): void;
+    /**
+     * Dispatches an action with optional data
+     * alias for sendAction
+     * @template TActionData - The type of data to send with the action
+     * @param {A} action - The action to dispatch
+     * @param {TActionData} [data] - Optional data to send with the action
+     * @example
+     * // Send a 'jump' action with power data
+     * app.action('jump', { power: 100 });
+     */
+    action<TActionData = any>(action: AppActions, data?: TActionData): void;
+    /**
+     * Checks if an action is currently active
+     * @param {A} action - The action to check
+     * @returns {boolean} True if the action is active, false otherwise
+     * @example
+     * // Check if the 'run' action is active
+     * if (app.isActionActive('run')) {
+     *   player.updateSpeed(runningSpeed);
+     * }
+     */
+    isActionActive(action: AppActions): boolean;
+    /**
+     * The built-in DataAdapter plugin (in-memory game data with optional
+     * localStorage backup). Routed through the plugin registry, not `store` —
+     * its API is richer than generic save/load.
+     */
+    get data(): IDataAdapter;
+    protected boot(config?: Partial<IApplicationOptions>): Promise<void>;
+    protected preInitialize(config: Partial<IApplicationOptions>): Promise<void>;
+    protected registerPlugin(plugin: IPlugin, options?: any): Promise<void>;
+    protected registerDefaultPlugins(): Promise<void>;
+    protected registerPlugins(): Promise<void>;
+    /**
+     * This is called after the required assets are loaded
+     * You can be sure that all the assets on the assets.preload from caper.config are loaded
+     * @protected
+     */
+    protected requiredAssetsLoaded(): Promise<void> | void;
+    /**
+     * This is called after the application is initialized
+     * You can be sure that
+     * - all plugins are registered
+     * - the store is created, with all storage adapters registered
+     * @protected
+     */
+    protected setup(): Promise<void> | void;
+    protected initAssets(): Promise<void>;
+    protected loadDefaultScene(): Promise<void>;
+    private _resize;
+    /**
+     * Called after the application is initialized
+     * Here we add application specific signal listeners, etc
+     * @returns {Promise<void>}
+     * @private
+     */
+    private _setup;
+    private _addSplash;
+}
+export {};
+//# sourceMappingURL=Application.d.ts.map

package/lib/core/Application.d.ts.map

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

package/lib/core/config.d.ts

@@ -0,0 +1,39 @@
+import { IPlugin } from '../plugins/Plugin';
+import { AppTypeOverrides, ImportList } from '../utils';
+import { AppConfig } from './types';
+type PluginId = AppTypeOverrides['Plugins'];
+export type PluginConfig = PluginId | [PluginId, {
+    autoLoad?: boolean;
+    options?: any;
+}];
+/**
+ * Resolves the config's plugin list (which may be a mix of IDs and `[id, opts]`
+ * tuples) against the discovered plugin registry injected by the Vite runtime
+ * plugin. Plugin discovery now includes everything formerly registered as a
+ * "storage adapter" — unified into a single list.
+ */
+export declare function generatePluginList<T extends IPlugin = IPlugin>(plugins: PluginConfig[]): Promise<ImportList<T>>;
+export declare function defineConfig(config: Partial<AppConfig>): Partial<AppConfig>;
+/**
+ * Topologically sort the active plugin list by each item's `requires` field
+ * so dependencies initialize before dependents. Throws on missing required
+ * plugin or on cycle. Used by `Application.registerPlugins()` at bootstrap.
+ *
+ * Behavior:
+ *   - If `B.requires = ['A']`, A is initialized before B regardless of the
+ *     order they appear in `caper.config.ts plugins[]`.
+ *   - If `B.requires = ['A']` but A is not in the active plugin list, this
+ *     throws with an error message that names B, names A, and tells the
+ *     user to add A to `caper.config.ts plugins[]`. We deliberately do NOT
+ *     auto-register the missing dep — the config file is the single source
+ *     of truth for what plugins run, and silently inserting transitive
+ *     deps would make it stop being trustworthy.
+ *   - If a cycle exists (A→B→A), throws with the cycle path printed.
+ *
+ * Stable order: items with no dependencies preserve their original
+ * relative order from `caper.config.ts`. Only items participating in a
+ * `requires` chain get reordered.
+ */
+export declare function sortPluginsByRequires<T extends ImportList<IPlugin>[number]>(items: T[]): T[];
+export {};
+//# sourceMappingURL=config.d.ts.map

package/lib/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAU,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,KAAK,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC;AAExF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAqBrH;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,sBAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAyE5F"}

package/lib/core/create.d.ts

@@ -0,0 +1,41 @@
+import { RegisterSWOptions } from 'vite-plugin-pwa/types';
+import { PluginListItem } from '../plugins';
+import { AppTypeOverrides, SceneImportListItem } from '../utils';
+import { ICaperAutomation } from './globals';
+import { IApplication } from './interfaces';
+import { AppConfig } from './types';
+type App = AppTypeOverrides['App'];
+interface CaperPWA {
+    readonly info: any;
+    register: () => void;
+    onRegisteredSW: (swScriptUrl: string) => void;
+    offlineReady: () => void;
+    onNeedRefresh?: () => void;
+    onRegisterError?: (error: any) => void;
+}
+interface CaperGlobal {
+    APP_NAME: string;
+    APP_VERSION: string | number;
+    readonly sceneList: SceneImportListItem<any>[];
+    readonly pluginsList: PluginListItem[];
+    get: (key?: string) => any;
+    pwa: CaperPWA;
+    apps: Map<string, IApplication>;
+    app?: IApplication;
+    ready(id?: string): Promise<IApplication>;
+    automation: Record<string, ICaperAutomation>;
+    __runtimeManaged?: boolean;
+}
+declare global {
+    const Caper: CaperGlobal;
+    const registerSW: (options: RegisterSWOptions) => void;
+    interface Window {
+        Caper: CaperGlobal;
+    }
+}
+export declare const DEFAULT_GAME_CONTAINER_ID = "caper-game-container";
+export declare function createContainer(id: string): HTMLDivElement;
+export declare function documentReady(): Promise<unknown>;
+export declare function create(config?: Partial<AppConfig>, domElement?: string | Window | HTMLElement, speak?: boolean): Promise<App>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/lib/core/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/core/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAItE,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,KAAK,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAEnC,UAAU,QAAQ;IAChB,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACxC;AACD,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAE7B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;IAEvC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC;IAE3B,GAAG,EAAE,QAAQ,CAAC;IAGd,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChC,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,KAAK,EAAE,WAAW,CAAC;IACzB,MAAM,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACvD,UAAU,MAAM;QACd,KAAK,EAAE,WAAW,CAAC;KACpB;CACF;AAED,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,kBAKzC;AAED,wBAAsB,aAAa,qBAUlC;AAgDD,wBAAsB,MAAM,CAC1B,MAAM,GAAE,OAAO,CAAC,SAAS,CAA8B,EACvD,UAAU,GAAE,MAAM,GAAG,MAAM,GAAG,WAAuC,EACrE,KAAK,GAAE,OAAc,GACpB,OAAO,CAAC,GAAG,CAAC,CAkEd"}

package/lib/core/globals.d.ts

@@ -0,0 +1,51 @@
+import { IApplication } from './interfaces';
+/**
+ * A single entry in an app's automation log ring buffer.
+ */
+export interface AutomationLogEntry {
+    t: number;
+    kind: 'action' | 'state' | 'context';
+    name?: string;
+    data?: unknown;
+}
+/**
+ * The automation facade exposed on `window.Caper.automation[appId]` for
+ * Playwright / agent drivers. Only present when automation is enabled (see the
+ * gating rules in {@link registerCaperApp}).
+ */
+export interface ICaperAutomation {
+    readonly appId: string;
+    readonly log: readonly AutomationLogEntry[];
+    action(name: string, data?: unknown): void;
+    getContext(): string;
+    getState(): unknown;
+    registerStateGetter(fn: () => unknown): void;
+    notifyStateChanged(state: unknown): void;
+    waitFor(predicate: (state: unknown) => boolean, opts?: {
+        timeoutMs?: number;
+    }): Promise<unknown>;
+}
+/**
+ * Install the `Caper` discovery surface (`apps`, `automation`, `ready()`) on
+ * `globalThis` immediately. The caper-runtime virtual module calls this before
+ * bootstrap so automation drivers (Playwright etc.) can `await Caper.ready()`
+ * from the very first moment the page scripts run, instead of polling for the
+ * function to appear at the end of boot.
+ */
+export declare function installCaperGlobal(): void;
+/**
+ * Register an app with the global `Caper` discovery surface. Adds it to
+ * `Caper.apps` under its config id, sets `Caper.app` to the most-recently
+ * created app, and — when automation is enabled — builds the automation facade
+ * and stores it at `Caper.automation[id]` (and on the app instance).
+ *
+ * Automation is enabled when any of: dev env, `config.automation === true`, or
+ * `VITE_CAPER_AUTOMATION === 'true'`.
+ */
+export declare function registerCaperApp(app: IApplication): void;
+/**
+ * Resolve any pending `Caper.ready()` promises for this app — both the
+ * id-keyed resolver and the first-app resolver.
+ */
+export declare function signalCaperReady(app: IApplication): void;
+//# sourceMappingURL=globals.d.ts.map

package/lib/core/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../src/core/globals.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,IAAI,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAC7C,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClG;AA6GD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AA6GD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAYxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAgBxD"}

package/lib/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config';
+export { create, createContainer } from './create';
+export * from './globals';
+export * from './interfaces';
+export * from './registries';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACnD,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}