@caperjs/core 0.1.0

package/lib/signals/Signal.d.ts

@@ -0,0 +1,16 @@
+import { Collector, CollectorArray, CollectorLast, CollectorUntil0, CollectorWhile0, SignalConnection, SignalConnections, Signal as TsSignal } from 'typed-signals';
+export type SignalOrder = 'highest' | 'high' | 'normal' | 'low' | 'lower' | 'lowest' | number;
+declare class Signal<THandler extends (...args: any[]) => any> extends TsSignal<THandler> {
+    connectOnce(callback: THandler, order?: SignalOrder): SignalConnection;
+    connectNTimes(callback: THandler, times: number, order?: SignalOrder): SignalConnection;
+    /**
+     * Subscribe to this signal.
+     *
+     * @param callback This callback will be run when emit() is called.
+     * @param order Handlers with a higher order value will be called later.
+     */
+    connect(callback: THandler, order?: SignalOrder): SignalConnection;
+}
+export { Collector, CollectorArray, CollectorLast, CollectorUntil0, CollectorWhile0, Signal, SignalConnections };
+export type { SignalConnection };
+//# sourceMappingURL=Signal.d.ts.map

package/lib/signals/Signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../src/signals/Signal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,IAAI,QAAQ,EACnB,MAAM,eAAe,CAAC;AAYvB,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9F,cAAM,MAAM,CAAC,QAAQ,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAE,SAAQ,QAAQ,CAAC,QAAQ,CAAC;IAExE,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,gBAAgB;IAatE,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,gBAAgB;IAe9F;;;;;OAKG;IACI,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAE,WAAsB,GAAG,gBAAgB;CAIpF;AAGD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AACjH,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/lib/signals/Signal.test.d.ts

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

package/lib/signals/Signal.test.d.ts.map

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

package/lib/signals/index.d.ts

@@ -0,0 +1,3 @@
+export { Signal, SignalConnections, Collector, CollectorLast, CollectorArray, CollectorUntil0, CollectorWhile0, } from './Signal';
+export type { SignalConnection, SignalOrder } from './Signal';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/signals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/lib/store/Store.d.ts

@@ -0,0 +1,56 @@
+import { IApplication } from '../core';
+import { IStorageCapability } from '../core/interfaces/IStorageCapability';
+import { Signal } from '../signals';
+import { AppTypeOverrides } from '../utils';
+export type StoreErrorDetail = {
+    adapterId: string;
+    operation: 'save' | 'load';
+    key: string;
+    error: Error;
+};
+type AppPlugins = AppTypeOverrides['Plugins'];
+/**
+ * Configuration for a single save call.
+ */
+type AdapterSaveConfig = {
+    adapterId: string;
+    awaitSave: boolean;
+};
+/**
+ * Thin façade over the Application's plugin registry.
+ *
+ * A "storage adapter" is nothing more than a `Plugin` whose instance implements
+ * {@link IStorageCapability}. The `Store` doesn't own a second registry — it
+ * just filters `app._plugins` for storage-capable entries and routes save/load
+ * calls through them.
+ */
+export interface IStore {
+    initialize(app: IApplication): IStore;
+    destroy(): void;
+    getAdapter<T extends IStorageCapability = IStorageCapability>(adapterId: AppPlugins): T;
+    hasAdapter(adapterId: AppPlugins): boolean;
+    save(adapterId: AppPlugins | AppPlugins[] | Partial<AdapterSaveConfig> | Partial<AdapterSaveConfig>[], key: string, data: any, awaitSave?: boolean): Promise<any>;
+    load(adapterId: AppPlugins, key: string): Promise<any>;
+    onError: Signal<(detail: StoreErrorDetail) => void>;
+}
+export declare class Store implements IStore {
+    readonly onError: Signal<(detail: StoreErrorDetail) => void>;
+    private _app;
+    initialize(app: IApplication): IStore;
+    destroy(): void;
+    private _emitError;
+    /**
+     * Returns a storage-capable plugin by id. Throws if the plugin is missing or
+     * does not implement {@link IStorageCapability}.
+     */
+    getAdapter<T extends IStorageCapability = IStorageCapability>(adapterId: AppPlugins): T;
+    hasAdapter(adapterId: AppPlugins): boolean;
+    /**
+     * Iterates every storage-capable plugin currently registered with the app.
+     */
+    private allAdapterIds;
+    save(adapterId: AppPlugins | AppPlugins[] | Partial<AdapterSaveConfig> | Partial<AdapterSaveConfig>[], key: string, data: any, awaitSave?: boolean): Promise<any>;
+    load(adapterId: AppPlugins, key: string): Promise<any>;
+}
+export {};
+//# sourceMappingURL=Store.d.ts.map

package/lib/store/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../src/store/Store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAElG,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,KAAK,gBAAgB,EAAU,MAAM,UAAU,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,KAAK,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAE9C;;GAEG;AACH,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC;IAEtC,OAAO,IAAI,IAAI,CAAC;IAEhB,UAAU,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,EAAE,SAAS,EAAE,UAAU,GAAG,CAAC,CAAC;IAExF,UAAU,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC;IAE3C,IAAI,CACF,SAAS,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,EAAE,EAChG,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,GAAG,EACT,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,GAAG,CAAC,CAAC;IAEhB,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvD,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC;CACrD;AAED,qBAAa,KAAM,YAAW,MAAM;IAClC,SAAgB,OAAO,kBAAuB,gBAAgB,KAAK,IAAI,EAAI;IAC3E,OAAO,CAAC,IAAI,CAAgB;IAErB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IAKrC,OAAO,IAAI,IAAI;IAKtB,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACI,UAAU,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,EAAE,SAAS,EAAE,UAAU,GAAG,CAAC;IAWvF,UAAU,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO;IAKjD;;OAEG;IACH,OAAO,CAAC,aAAa;IAaR,IAAI,CACf,SAAS,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,EAAE,EAChG,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,GAAG,EACT,SAAS,UAAO,GACf,OAAO,CAAC,GAAG,CAAC;IAgEF,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAapE"}

package/lib/store/Store.test.d.ts

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

package/lib/store/Store.test.d.ts.map

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

package/lib/store/index.d.ts

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

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

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

package/lib/types/framework.d.ts

@@ -0,0 +1,46 @@
+import { Application } from '../core/Application';
+import { Action, ActionContext } from '../plugins';
+import { DataSchema } from '../plugins/DataAdapter';
+declare module '../utils/types' {
+  export interface AppTypeOverrides {
+    App: Application;
+    Data: DataSchema;
+    Contexts: ActionContext;
+    Actions: Action;
+    ActionMap: Record<string, Action>;
+    Scenes: string;
+    Plugins: string;
+  }
+  export interface AssetTypeOverrides {
+    Texture: string;
+    TPSFrames: string;
+    SpriteSheet: string;
+    SpineData: string;
+    Audio: string;
+    FontFamily: string;
+    BitmapFontFamily: string;
+    Bundles: string;
+  }
+}
+
+declare module '@caperjs/core' {
+  export interface AppTypeOverrides {
+    App: Application;
+    Data: DataSchema;
+    Contexts: ActionContext;
+    Actions: Action;
+    ActionMap: Record<string, Action>;
+    Scenes: string;
+    Plugins: string;
+  }
+  export interface AssetTypeOverrides {
+    Texture: string;
+    TPSFrames: string;
+    SpriteSheet: string;
+    SpineData: string;
+    Audio: string;
+    FontFamily: string;
+    BitmapFontFamily: string;
+    Bundles: string;
+  }
+}

package/lib/types/gsap.d.ts

@@ -0,0 +1,23 @@
+import { AppTypeOverrides } from '../utils';
+/**
+ * An interface for custom GSAP eases.
+ * This interface can be augmented in your application to provide strong typing for your custom eases.
+ *
+ * @example
+ * ```ts
+ * // src/types/custom-eases.d.ts
+ * declare module '@caperjs/core/types/gsap' {
+ *   interface CustomEase {
+ *     'my-custom-ease': any;
+ *     'another-ease': any;
+ *   }
+ * }
+ * ```
+ */
+
+declare module 'gsap/gsap-core' {
+  // We can't directly augment the EaseString type alias, so we'll augment TweenVars instead.
+  interface TweenVars {
+    ease?: EaseString | AppTypeOverrides['CustomEases'];
+  }
+}

package/lib/ui/Button.d.ts

@@ -0,0 +1,162 @@
+import { BitmapText, Cursor, DestroyOptions, FederatedEvent, FederatedPointerEvent, HTMLText, Sprite, Text } from 'pixi.js';
+import { LayoutOptions } from '@pixi/layout';
+import { IApplication } from '../core';
+import { HTMLTextProps, TextProps } from '../mixins';
+import { Signal } from '../signals';
+import { AudioAsset, SpritesheetAsset, TextureAsset } from '../utils';
+export type ButtonCallback = (() => void) | (() => Promise<void>);
+export type ButtonAction = {
+    id: string | number;
+    data?: any;
+};
+export type ButtonActionOrCallback = ButtonAction | ButtonCallback;
+type ButtonTextureId = 'default' | 'hover' | 'active' | 'disabled';
+export interface IButton {
+    onDown: Signal<() => void>;
+    onUp: Signal<() => void>;
+    onUpOutside: Signal<() => void>;
+    onOut: Signal<() => void>;
+    onOver: Signal<() => void>;
+    onClick: Signal<() => void>;
+    onEnabled: Signal<() => void>;
+    onDisabled: Signal<() => void>;
+    onDestroy: Signal<() => void>;
+    onKeyboardEvent: Signal<(key: string) => void>;
+    view: Sprite;
+    isDown: boolean;
+    isOver: boolean;
+    id: string;
+}
+export type ButtonConfig = {
+    id: string;
+    textures: {
+        default: TextureAsset;
+        hover?: TextureAsset;
+        active?: TextureAsset;
+        disabled?: TextureAsset;
+    };
+    sounds?: {
+        hover?: AudioAsset;
+        out?: AudioAsset;
+        down?: AudioAsset;
+        click?: AudioAsset;
+    };
+    actions?: {
+        hover?: ButtonActionOrCallback;
+        out?: ButtonActionOrCallback;
+        down?: ButtonActionOrCallback;
+        click?: ButtonActionOrCallback;
+    };
+    textLabel?: Partial<TextProps | HTMLTextProps> & {
+        type?: 'text' | 'html' | 'bitmap';
+    };
+    cursor: Cursor;
+    disabledCursor: Cursor;
+    sheet: SpritesheetAsset;
+    enabled: boolean;
+    layout?: Omit<LayoutOptions, 'target'> | null | boolean;
+};
+export declare const ButtonConfigKeys: (keyof ButtonConfig)[];
+declare const _Button: (new () => import('..').IFactory<{
+    existing: <TEntity>(entity: TEntity, props?: Partial<import('..').ExistingProps>) => TEntity;
+    container: (props?: Partial<import('..').ContainerProps> | undefined) => import('..').Container;
+    particleContainer: (props?: Partial<import('..').ParticleContainerProps> | undefined) => import('..').ParticleContainer;
+    texture: typeof import('..').resolveTexture;
+    sprite: (props?: Partial<import('..').SpriteProps> | undefined) => Sprite;
+    tilingSprite: (props?: Partial<import('..').TilingSpriteProps> | undefined) => import('pixi.js').TilingSprite;
+    animatedSprite: (props?: Partial<import('..').AnimatedSpriteProps> | undefined) => import('..').AnimatedSprite;
+    graphics: (props?: Partial<import('..').GraphicsProps> | undefined) => import('pixi.js').Graphics;
+    svg(props: import('..').WithRequiredProps<import('..').SvgProps, "ctx">): import('..').Svg;
+    text: (props?: Partial<TextProps> | undefined) => Text;
+    htmlText: (props?: Partial<HTMLTextProps> | undefined) => HTMLText;
+    bitmapText: (props?: Partial<import('..').BitmapTextProps> | undefined) => BitmapText;
+    button: (props?: Partial<import('..').ButtonProps> | undefined) => Button;
+    flexContainer: (props?: Partial<import('..').FlexContainerProps> | undefined) => import('./FlexContainer').FlexContainer;
+    uiCanvas: (props?: Partial<import('..').UICanvasFactoryProps> | undefined) => import('./UICanvas').UICanvas;
+    spine: (props?: Partial<import('..').SpineProps> | undefined) => import('..').Spine;
+    spineAnimation: <ANames extends string = string>(props?: Partial<import('..').SpineProps>) => import('..').SpineAnimation<ANames>;
+    toaster: (toasterConfig?: Partial<import('./Toaster').ToasterConfig>, defaultToastConfig?: Partial<import('./Toast').ToastConfig>) => import('./Toaster').Toaster;
+    entity: <K extends import('..').EntityId>(id: K, props?: import('..').EntityProps<K> & import('..').EntityFactoryProps) => import('..').EntityInstance<K>;
+    ui: <K extends import('..').UIId>(id: K, props?: import('..').UIProps<K> & import('..').EntityFactoryProps) => import('..').UIInstance<K>;
+}>) & import('..').Constructor<import('..').ISignalContainer> & import('..').Constructor<import('..').IInteractive> & import('..').Constructor<import('..').IFocusable>;
+/**
+ * @class
+ * @extends {Container}
+ *  A class representing a button.
+ */
+export declare class Button extends _Button implements IButton {
+    onDown: Signal<() => void>;
+    onUp: Signal<() => void>;
+    onUpOutside: Signal<() => void>;
+    onOut: Signal<() => void>;
+    onOver: Signal<() => void>;
+    onClick: Signal<() => void>;
+    onEnabled: Signal<() => void>;
+    onDisabled: Signal<() => void>;
+    onKeyboardEvent: Signal<(key: string) => void>;
+    onDestroy: Signal<() => void>;
+    id: string;
+    view: Sprite;
+    isDown: boolean;
+    isOver: boolean;
+    protected config: ButtonConfig;
+    protected _isDownCallbacks: Map<string, () => void>;
+    private _isDownListenerAdded;
+    private _pointerId?;
+    private _textLabel?;
+    /**
+     * The text label of the button.
+     * @returns {Text | HTMLText | BitmapText | undefined} The text label instance.
+     */
+    get textLabel(): Text | HTMLText | BitmapText | undefined;
+    /**
+     * @constructor
+     * @param {Partial<ButtonConfig>} config - The configuration for the button.
+     */
+    constructor(config: Partial<ButtonConfig>);
+    protected _enabled: boolean;
+    /**
+     *  Sets the enabled state of the button.
+     * @param {boolean} enabled - Whether the button is enabled.
+     */
+    set enabled(enabled: boolean);
+    addLabel<T extends Text | HTMLText | BitmapText>(config: (Partial<TextProps | HTMLTextProps> & {
+        type?: 'text' | 'html' | 'bitmap';
+    }) | T): T;
+    positionLabel(): void;
+    get enabled(): boolean;
+    get app(): IApplication;
+    destroy(options?: DestroyOptions): void;
+    focusOut(): void;
+    blur(): void;
+    getFocusArea(): import('pixi.js').Bounds;
+    addIsDownCallback(callbackId: string, callback: () => void): void;
+    removeIsDownCallback(callbackId: string): void;
+    setTexture(textureId: ButtonTextureId, texture: TextureAsset): void;
+    /**
+     * Sets the texture of the button to the hover texture and emits the onOver event.
+     */
+    protected handlePointerOver(): void;
+    /**
+     * Sets the texture of the button to the default texture and emits the onOut event.
+     */
+    protected handlePointerOut(): void;
+    /**
+     * Sets the isDown property to true and changes the texture of the button.
+     */
+    protected handlePointerDown(e: FederatedEvent): void;
+    /**
+     * Removes the keyup event listener and emits the onPress and onUp events.
+     */
+    protected handlePointerUp(e: FederatedEvent): void;
+    protected handleClick(): void;
+    /**
+     *  Handles the pointer up event.
+     */
+    protected handlePointerUpOutside(e: PointerEvent | FederatedPointerEvent): void;
+    private _doAction;
+    private _checkIsDownCallbacks;
+    private _handleIsDownCallbacks;
+}
+export {};
+//# sourceMappingURL=Button.d.ts.map

package/lib/ui/Button.d.ts.map

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

package/lib/ui/FlexContainer.d.ts

@@ -0,0 +1,109 @@
+import { LayoutOptions, NumberValue } from '@pixi/layout';
+import { BitmapText, Graphics, Container as PIXIContainer, Text } from 'pixi.js';
+import { Container } from '../display';
+import { Signal } from '../signals';
+import { AppTypeOverrides, ContainerLike } from '../utils';
+declare const _FlexContainer: (new () => import('..').IFactory<{
+    existing: <TEntity>(entity: TEntity, props?: Partial<import('..').ExistingProps>) => TEntity;
+    container: (props?: Partial<import('..').ContainerProps> | undefined) => Container;
+    particleContainer: (props?: Partial<import('..').ParticleContainerProps> | undefined) => import('..').ParticleContainer;
+    texture: typeof import('..').resolveTexture;
+    sprite: (props?: Partial<import('..').SpriteProps> | undefined) => import('pixi.js').Sprite;
+    tilingSprite: (props?: Partial<import('..').TilingSpriteProps> | undefined) => import('pixi.js').TilingSprite;
+    animatedSprite: (props?: Partial<import('..').AnimatedSpriteProps> | undefined) => import('..').AnimatedSprite;
+    graphics: (props?: Partial<import('..').GraphicsProps> | undefined) => Graphics;
+    svg(props: import('..').WithRequiredProps<import('..').SvgProps, "ctx">): import('..').Svg;
+    text: (props?: Partial<import('..').TextProps> | undefined) => Text;
+    htmlText: (props?: Partial<import('..').HTMLTextProps> | undefined) => import('pixi.js').HTMLText;
+    bitmapText: (props?: Partial<import('..').BitmapTextProps> | undefined) => BitmapText;
+    button: (props?: Partial<import('..').ButtonProps> | undefined) => import('./Button').Button;
+    flexContainer: (props?: Partial<import('..').FlexContainerProps> | undefined) => FlexContainer;
+    uiCanvas: (props?: Partial<import('..').UICanvasFactoryProps> | undefined) => import('./UICanvas').UICanvas;
+    spine: (props?: Partial<import('..').SpineProps> | undefined) => import('..').Spine;
+    spineAnimation: <ANames extends string = string>(props?: Partial<import('..').SpineProps>) => import('..').SpineAnimation<ANames>;
+    toaster: (toasterConfig?: Partial<import('./Toaster').ToasterConfig>, defaultToastConfig?: Partial<import('./Toast').ToastConfig>) => import('./Toaster').Toaster;
+    entity: <K extends import('..').EntityId>(id: K, props?: import('..').EntityProps<K> & import('..').EntityFactoryProps) => import('..').EntityInstance<K>;
+    ui: <K extends import('..').UIId>(id: K, props?: import('..').UIProps<K> & import('..').EntityFactoryProps) => import('..').UIInstance<K>;
+}>) & import('..').Constructor<import('..').ISignalContainer>;
+export declare function isText(child: PIXIContainer): child is Text | BitmapText;
+export interface FlexContainerConfig {
+    bindTo?: ContainerLike;
+    bindToAppSize?: boolean;
+    autoLayoutChildren?: boolean;
+    layout?: Omit<LayoutOptions, 'target'> | null | boolean;
+    debug?: boolean;
+}
+export declare const FlexContainerConfigKeys: (keyof FlexContainerConfig)[];
+export type FlexWrap = 'wrap' | 'nowrap' | 'wrap-reverse' | undefined;
+export type FlexDirection = 'row' | 'column' | 'row-reverse' | 'column-reverse' | undefined;
+export type AlignItems = 'center' | 'flex-start' | 'flex-end' | 'stretch' | 'baseline' | undefined;
+export type JustifyContent = 'center' | 'space-between' | 'space-around' | 'space-evenly' | 'flex-start' | 'flex-end' | undefined;
+export type SizeNumber = NumberValue | 'auto' | 'intrinsic';
+export declare class FlexContainer extends _FlexContainer {
+    onLayoutComplete: Signal<() => void>;
+    config: Partial<FlexContainerConfig>;
+    private _debugGraphics;
+    private _debugLabel;
+    constructor(config?: Partial<FlexContainerConfig>);
+    private createLayout;
+    private handleAdded;
+    private _updateLayout;
+    private handleChildAdded;
+    private handleChildRemoved;
+    private handleResize;
+    private handleBindToResize;
+    updateLayout(): void;
+    get app(): AppTypeOverrides['App'];
+    /**
+     * Set multiple layout properties at once, triggering a single deferred layout update.
+     */
+    configure(styles: Partial<Omit<LayoutOptions, 'target'>>): void;
+    get gap(): number;
+    set gap(value: number);
+    get flexWrap(): FlexWrap;
+    set flexWrap(value: FlexWrap);
+    get flexDirection(): FlexDirection;
+    set flexDirection(value: FlexDirection);
+    get alignItems(): AlignItems;
+    set alignItems(value: AlignItems);
+    get justifyContent(): JustifyContent;
+    set justifyContent(value: JustifyContent);
+    get size(): {
+        width: SizeNumber;
+        height: SizeNumber;
+    };
+    set size(size: {
+        width: SizeNumber;
+        height: SizeNumber;
+    } | [SizeNumber, SizeNumber] | SizeNumber);
+    get layoutWidth(): SizeNumber;
+    set layoutWidth(width: SizeNumber);
+    get layoutHeight(): SizeNumber;
+    set layoutHeight(height: SizeNumber);
+    get padding(): NumberValue | undefined;
+    set padding(value: NumberValue);
+    get paddingTop(): NumberValue | undefined;
+    set paddingTop(value: NumberValue);
+    get paddingRight(): NumberValue | undefined;
+    set paddingRight(value: NumberValue);
+    get paddingBottom(): NumberValue | undefined;
+    set paddingBottom(value: NumberValue);
+    get paddingLeft(): NumberValue | undefined;
+    set paddingLeft(value: NumberValue);
+    get margin(): NumberValue | undefined;
+    set margin(value: NumberValue);
+    get marginTop(): NumberValue | undefined;
+    set marginTop(value: NumberValue);
+    get marginRight(): NumberValue | undefined;
+    set marginRight(value: NumberValue);
+    get marginBottom(): NumberValue | undefined;
+    set marginBottom(value: NumberValue);
+    get marginLeft(): NumberValue | undefined;
+    set marginLeft(value: NumberValue);
+    get debug(): boolean;
+    set debug(value: boolean);
+    private drawDebug;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=FlexContainer.d.ts.map

package/lib/ui/FlexContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlexContainer.d.ts","sourceRoot":"","sources":["../../src/ui/FlexContainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,IAAI,aAAa,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EACL,gBAAgB,EAEhB,KAAK,aAAa,EAOnB,MAAM,UAAU,CAAC;AAElB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;6DAAyB,CAAC;AAE9C,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,IAAI,GAAG,UAAU,CAEvE;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,uBAAuB,EAAE,CAAC,MAAM,mBAAmB,CAAC,EAKhE,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AACnG,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,eAAe,GACf,cAAc,GACd,cAAc,GACd,YAAY,GACZ,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5D,qBAAa,aAAc,SAAQ,cAAc;IACxC,gBAAgB,eAAoB,IAAI,EAAI;IAC5C,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,WAAW,CAAqB;gBAE5B,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IA+BrD,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,kBAAkB;IASnB,YAAY;IASnB,IAAW,GAAG,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAExC;IAED;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI;IAMtE,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,EAGpB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAG3B;IAED,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,EAGrC;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,UAAU,EAG/B;IAED,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,IAAI,cAAc,CAAC,KAAK,EAAE,cAAc,EAGvC;IAED,IAAI,IAAI,IAAI;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAKpD;IAED,IAAI,IAAI,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,UAAU,EAS/F;IAED,IAAI,WAAW,IAAI,UAAU,CAE5B;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,UAAU,EAGhC;IAED,IAAI,YAAY,IAAI,UAAU,CAE7B;IAED,IAAI,YAAY,CAAC,MAAM,EAAE,UAAU,EAGlC;IAGD,IAAI,OAAO,IAAI,WAAW,GAAG,SAAS,CAErC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,WAAW,EAG7B;IAED,IAAI,UAAU,IAAI,WAAW,GAAG,SAAS,CAExC;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,WAAW,EAGhC;IAED,IAAI,YAAY,IAAI,WAAW,GAAG,SAAS,CAE1C;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,WAAW,EAGlC;IAED,IAAI,aAAa,IAAI,WAAW,GAAG,SAAS,CAE3C;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,WAAW,EAGnC;IAED,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAGjC;IAGD,IAAI,MAAM,IAAI,WAAW,GAAG,SAAS,CAEpC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,EAG5B;IAED,IAAI,SAAS,IAAI,WAAW,GAAG,SAAS,CAEvC;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,WAAW,EAG/B;IAED,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,WAAW,EAGjC;IAED,IAAI,YAAY,IAAI,WAAW,GAAG,SAAS,CAE1C;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,WAAW,EAGlC;IAED,IAAI,UAAU,IAAI,WAAW,GAAG,SAAS,CAExC;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,WAAW,EAGhC;IAGD,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAevB;IAED,OAAO,CAAC,SAAS;IA0HjB,OAAO;CA4BR"}