@caperjs/core 0.1.0

package/lib/mixins/factory/props.d.ts

@@ -0,0 +1,160 @@
+import { LayoutOptions } from '@pixi/layout';
+import { GraphicsContext, HTMLTextStyleOptions, TextStyleOptions } from 'pixi.js';
+import { ContainerConfig } from '../../display';
+import { ParticleContainerConfig } from '../../display/ParticleContainer';
+import { ButtonConfig, FlexContainerConfig, UICanvasProps } from '../../ui';
+import { BitmapFontFamilyAsset, FontFamilyAsset, PointLike, SpineAsset, SpritesheetAsset, TextureAsset, WithRequiredProps } from '../../utils';
+export interface AbstractProps {
+    [key: string]: any;
+}
+export interface TextureProps {
+    asset: TextureAsset;
+    sheet: SpritesheetAsset;
+}
+export interface PositionProps {
+    x: number;
+    y: number;
+    position: PointLike;
+}
+export interface ScaleProps {
+    scaleX: number;
+    scaleY: number;
+    scale: PointLike;
+}
+export interface PivotProps {
+    pivot: PointLike;
+}
+export interface VisibilityProps {
+    alpha: number;
+    visible: boolean;
+}
+export interface LayoutProps {
+    layout?: Omit<LayoutOptions, 'target'> | null | boolean;
+}
+export interface ExistingProps extends AbstractProps, PositionProps, ScaleProps, VisibilityProps, LayoutProps {
+}
+/**
+ * Layout-ish props the `this.add.entity(id, props)` factory applies after
+ * construction — intentionally narrow (no `AbstractProps` index signature)
+ * so TypeScript can still narrow entity-specific props at the call site.
+ */
+export interface EntityFactoryProps extends Partial<PositionProps>, Partial<ScaleProps>, Partial<PivotProps>, Partial<VisibilityProps> {
+}
+export interface GraphicsProps extends AbstractProps, PositionProps, ScaleProps, PivotProps, VisibilityProps {
+}
+export interface SvgProps extends GraphicsProps {
+    ctx: string | GraphicsContext;
+}
+export interface SpriteProps extends AbstractProps, TextureProps, ScaleProps, PositionProps, VisibilityProps, LayoutProps {
+    anchor: PointLike;
+}
+export interface TilingSpriteProps extends SpriteProps {
+    tilePosition?: PointLike;
+    /**
+     * Scaling of the image that is being tiled.
+     * @default {x: 1, y: 1}
+     */
+    tileScale?: PointLike;
+    /**
+     * The rotation of the image that is being tiled.
+     * @default 0
+     */
+    tileRotation?: number;
+    /**
+     * The texture to use for the sprite.
+     * @default Texture.WHITE
+     */
+    /**
+     * The width of the tiling sprite. #
+     * @default 256
+     */
+    width?: number;
+    /**
+     * The height of the tiling sprite.
+     * @default 256
+     */
+    height?: number;
+    /**
+     * @default false
+     */
+    applyAnchorToTexture?: boolean;
+    /** Whether or not to round the x/y position. */
+    roundPixels?: boolean;
+}
+export interface AnimatedSpriteAnimationProps extends AbstractProps, ScaleProps, PositionProps, VisibilityProps, LayoutProps {
+    texturePrefix: string;
+    sheet: SpritesheetAsset;
+    startIndex: number;
+    numFrames: number;
+    zeroPad: number;
+    autoUpdate: boolean;
+    updateAnchor: boolean;
+    loop: boolean;
+    animationSpeed: number;
+}
+export interface AnimatedSpriteProps extends AbstractProps, ScaleProps, PositionProps, VisibilityProps, LayoutProps {
+    sheet: SpritesheetAsset;
+    texturePrefix: string;
+    zeroPad: number;
+    animations: {
+        [animationName: string]: Partial<AnimatedSpriteAnimationProps>;
+    };
+    autoPlay: boolean;
+    autoUpdate: boolean;
+    defaultAnimation: string;
+    reversible: boolean;
+    animationSpeed: number;
+    startIndex: number;
+}
+export type TextStyle = Partial<Omit<TextStyleOptions, 'fontFamily'> & {
+    fontFamily: FontFamilyAsset;
+}>;
+export interface TextProps extends AbstractProps, PositionProps, ScaleProps, VisibilityProps, LayoutProps {
+    text: string;
+    anchor: PointLike;
+    resolution: number;
+    roundPixels: boolean;
+    style: TextStyle;
+}
+export interface BitmapTextProps extends AbstractProps, PositionProps, ScaleProps, VisibilityProps, LayoutProps {
+    text: string;
+    anchor: PointLike;
+    resolution: number;
+    roundPixels: boolean;
+    style: Partial<Omit<TextStyleOptions, 'fontFamily'> & {
+        fontFamily: BitmapFontFamilyAsset;
+    }>;
+}
+export interface HTMLTextProps extends AbstractProps, PositionProps, ScaleProps, VisibilityProps, LayoutProps {
+    text: string;
+    anchor: PointLike;
+    resolution: number;
+    roundPixels: boolean;
+    style: Partial<Omit<HTMLTextStyleOptions, 'fontFamily'> & {
+        fontFamily: FontFamilyAsset;
+    }>;
+}
+export interface OmittedTextProps extends AbstractProps, PositionProps, ScaleProps, VisibilityProps {
+}
+export declare const TextPropsKeys: (keyof TextProps)[];
+export interface ContainerProps extends AbstractProps, PositionProps, ScaleProps, PivotProps, VisibilityProps, LayoutProps, ContainerConfig {
+}
+export interface ParticleContainerProps extends AbstractProps, ParticleContainerConfig {
+}
+export interface FlexContainerProps extends ContainerProps, FlexContainerConfig {
+}
+export interface UICanvasFactoryProps extends ContainerProps, UICanvasProps {
+}
+export interface SpineProps extends AbstractProps, ScaleProps, PositionProps, VisibilityProps, LayoutProps {
+    data: SpineAsset;
+    autoUpdate: boolean;
+    animationName: string;
+    trackIndex: number;
+    loop: boolean;
+    paused: boolean;
+}
+interface _ButtonProps extends AbstractProps, ScaleProps, PositionProps, PivotProps, VisibilityProps, ButtonConfig, LayoutProps {
+}
+export type ButtonProps = WithRequiredProps<_ButtonProps, 'textures'>;
+export {};
+//# sourceMappingURL=props.d.ts.map

package/lib/mixins/factory/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/mixins/factory/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;CACzD;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW;CAAG;AAEhH;;;;GAIG;AACH,MAAM,WAAW,kBACf,SAAQ,OAAO,CAAC,aAAa,CAAC,EAC5B,OAAO,CAAC,UAAU,CAAC,EACnB,OAAO,CAAC,UAAU,CAAC,EACnB,OAAO,CAAC,eAAe,CAAC;CAAG;AAE/B,MAAM,WAAW,aAAc,SAAQ,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe;CAAG;AAE/G,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC7C,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,WACf,SAAQ,aAAa,EACnB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW;IACb,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,4BACf,SAAQ,aAAa,EACnB,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW;IACjH,KAAK,EAAE,gBAAgB,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAA;KAAE,CAAC;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,EAAE,eAAe,CAAA;CAAE,CAAC,CAAC;AAExG,MAAM,WAAW,SAAU,SAAQ,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW;IACvG,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW;IAC7G,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW;IAC3G,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe;CAAG;AAEtG,eAAO,MAAM,aAAa,EAAE,CAAC,MAAM,SAAS,CAAC,EAAwD,CAAC;AAEtG,MAAM,WAAW,cACf,SAAQ,aAAa,EACnB,aAAa,EACb,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe;CAAG;AAEtB,MAAM,WAAW,sBAAuB,SAAQ,aAAa,EAAE,uBAAuB;CAAG;AAEzF,MAAM,WAAW,kBAAmB,SAAQ,cAAc,EAAE,mBAAmB;CAAG;AAElF,MAAM,WAAW,oBAAqB,SAAQ,cAAc,EAAE,aAAa;CAAG;AAG9E,MAAM,WAAW,UAAW,SAAQ,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW;IACxG,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,YACR,SAAQ,aAAa,EACnB,UAAU,EACV,aAAa,EACb,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW;CAAG;AAElB,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC"}

package/lib/mixins/factory/registry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Runtime registry for `this.add.entity(id, props)` lookups.
+ *
+ * The Vite plugin's entity discovery emits a `virtual:caper-entities` module
+ * with static imports by default (`defaultDynamic: false` in
+ * `discoverLocalClassFiles`). The `caper-runtime` virtual module pulls that
+ * list onto `globalThis.Caper.entityList` before the Application starts, so
+ * by the time any scene fires `initialize()` and calls `this.add.entity`,
+ * the list is in place.
+ *
+ * This registry is populated lazily on first lookup — no explicit bootstrap
+ * step needed. Entities declared with `defineEntity({ dynamic: true })` have
+ * an async `module` function and are skipped: the sync factory API can't
+ * wait for them. That's an intentional tradeoff — if a project needs code-
+ * split entities, they use `add.existing(new Foo(...), props)` with a
+ * manual lazy import instead.
+ */
+type EntityConstructor = new (props?: unknown) => unknown;
+export declare function getEntityCtor(id: string): EntityConstructor | undefined;
+export declare function getRegisteredEntityIds(): string[];
+/**
+ * Reset the registry. Test-only — production code should rely on the lazy
+ * initialization from `globalThis.Caper.entityList`.
+ */
+export declare function _resetEntityRegistry(): void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/lib/mixins/factory/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/mixins/factory/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,KAAK,iBAAiB,GAAG,KAAK,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;AA4B1D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEvE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/lib/mixins/factory/registry.test.d.ts

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

package/lib/mixins/factory/registry.test.d.ts.map

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

package/lib/mixins/factory/schema.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Common prop resolvers the schema helper can apply after constructing an
+ * instance. Each entry corresponds to one of the `resolveXxx` utilities and
+ * reads its inputs from the raw props object — so `'position'` consumes
+ * `{ position, x, y }`, `'scale'` consumes `{ scale, scaleX, scaleY }`,
+ * etc.
+ */
+export type FactoryApply = 'position' | 'scale' | 'pivot' | 'anchor';
+/**
+ * Schema describing a single factory method. Owned by the method's entry in
+ * `defaultFactoryMethods`; `buildFactoryMethod` consumes it to produce a
+ * typed `(props?: Props) => Instance` function with the standard
+ * resolve-position / resolve-scale / resolve-pivot / resolve-anchor
+ * post-construct pipeline and an automatic unknown-keys passthrough.
+ *
+ * The point of pushing every method through this shape is to collapse the
+ * copy-paste construction boilerplate in [const.ts](./const.ts): each
+ * method becomes (a) `build` — the bespoke constructor call that may
+ * reshape the props before handing them to Pixi — and (b) a list of which
+ * common resolvers to run. Everything else (unknowns passthrough, optional
+ * props guard, etc.) is centralized.
+ */
+export interface FactorySchema<Props, Instance> {
+    /**
+     * Bespoke construction. Receives the raw Caper-shaped props (possibly
+     * undefined) and returns a new instance. Any reshaping Caper does for DX
+     * — Sprite's `{asset, sheet}` → texture resolution, Text's top-level
+     * style flattening, Container's config/extras split — lives here.
+     */
+    build: (props: Props | undefined) => Instance;
+    /**
+     * Which common resolvers to run on the instance after `build` returns.
+     * Defaults to `['position', 'scale', 'pivot']` when omitted — the lowest
+     * common denominator that every display object supports. Classes with an
+     * `anchor` field (Sprite, Text, AnimatedSprite, Spine) opt in to
+     * `'anchor'` explicitly.
+     */
+    applies?: readonly FactoryApply[];
+    /**
+     * Keys the `build` callback already consumed — excluded from the
+     * unknown-keys passthrough so Caper doesn't try to set them on the
+     * instance a second time. For example, Sprite's schema excludes `asset`
+     * and `sheet` (consumed by `resolveTexture`), Text's schema excludes
+     * `text`, `roundPixels`, `resolution`, `style`, `anchor`, and `pivot`.
+     */
+    exclude?: readonly string[];
+}
+/**
+ * Build a typed factory method from a schema. The return type preserves
+ * the `(props?: Props) => Instance` shape TypeScript uses to drive
+ * autocomplete on `this.add.*({...})` call sites.
+ *
+ * Behavior mirrors the hand-written factory method pattern:
+ *  1. Call `schema.build(props)` to get the instance.
+ *  2. If props were passed, apply each resolver in `schema.applies`
+ *     (position / scale / pivot / anchor).
+ *  3. Forward any remaining keys to `resolveUnknownKeys` for the common
+ *     pass-through surface (`alpha`, `visible`, `label`, `eventMode`, etc.)
+ *     minus any keys the `build` callback already consumed.
+ *
+ * @example
+ * ```ts
+ * sprite: buildFactoryMethod<Partial<SpriteProps>, Sprite>({
+ *   build: (props) => new Sprite(props ? resolveTexture(props) : undefined),
+ *   applies: ['position', 'scale', 'pivot', 'anchor'],
+ *   exclude: ['asset', 'sheet'],
+ * }),
+ * ```
+ */
+export declare function buildFactoryMethod<Props, Instance>(schema: FactorySchema<Props, Instance>): (props?: Props) => Instance;
+//# sourceMappingURL=schema.d.ts.map

package/lib/mixins/factory/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/mixins/factory/schema.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,QAAQ;IAC5C;;;;;OAKG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,KAAK,QAAQ,CAAC;IAE9C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAElC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAqBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAChD,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,GACrC,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,QAAQ,CA6C7B"}

package/lib/mixins/factory/ui-registry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Runtime registry for `this.add.ui(id, props)` lookups.
+ *
+ * Mirrors the entity registry pattern exactly. The Vite plugin's UI
+ * discovery emits a `virtual:caper-uis` module with static imports by
+ * default (`defaultDynamic: false`). The `caper-runtime` virtual module
+ * pulls that list onto `globalThis.Caper.uiList` before the Application
+ * starts.
+ *
+ * Populated lazily on first lookup — no explicit bootstrap step needed.
+ */
+type UIConstructor = new (props?: unknown) => unknown;
+export declare function getUICtor(id: string): UIConstructor | undefined;
+export declare function getRegisteredUIIds(): string[];
+/**
+ * Reset the registry. Test-only.
+ */
+export declare function _resetUIRegistry(): void;
+export {};
+//# sourceMappingURL=ui-registry.d.ts.map

package/lib/mixins/factory/ui-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-registry.d.ts","sourceRoot":"","sources":["../../../src/mixins/factory/ui-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,KAAK,aAAa,GAAG,KAAK,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;AA4BtD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE/D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/lib/mixins/factory/utils.d.ts

@@ -0,0 +1,11 @@
+import { Texture } from 'pixi.js';
+import { PointLike } from '../../utils';
+import { PositionProps, ScaleProps, TextureProps } from './props';
+export declare function resolveUnknownKeys(props: any, entity: any): void;
+export declare function getErrorTexture(): Texture<import('pixi.js').TextureSource<any>>;
+export declare function resolveTexture(props?: Partial<TextureProps>): Texture;
+export declare function resolvePosition(props: Partial<PositionProps>, entity: any): void;
+export declare function resolveScale(props: Partial<ScaleProps>, entity: any): void;
+export declare function resolveAnchor(anchor: PointLike | undefined, entity: any): void;
+export declare function resolvePivot(pivot: PointLike | undefined, entity: any): void;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/mixins/factory/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAU,SAAS,EAAoB,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIlE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAQzD;AAED,wBAAgB,eAAe,kDAgB9B;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAsDrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,QAIzE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,QAiBnE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,QAKvE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,QAKrE"}

package/lib/mixins/focus.d.ts

@@ -0,0 +1,15 @@
+import { Container } from 'pixi.js';
+import { Constructor } from '../utils';
+import { IFocusable } from '../plugins';
+/**
+ * The Focusable function is a higher-order function that adds focus-related functionality to a given class.
+ *
+ * @param {TBase extends Constructor<Container>} Base - The base class to add focus functionality to.
+ *
+ * @returns {TBase & Constructor<IFocusable>} The modified class with focus functionality.
+ */
+export declare function Focusable<TBase extends Constructor<Container>>(Base: TBase): TBase & Constructor<IFocusable>;
+export declare namespace Focusable {
+    var INITTED: boolean;
+}
+//# sourceMappingURL=focus.d.ts.map

package/lib/mixins/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/mixins/focus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,UAAU,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CA0G5G;yBA1Ge,SAAS"}

package/lib/mixins/index.d.ts

@@ -0,0 +1,6 @@
+export * from './signals';
+export * from './animated';
+export * from './focus';
+export * from './interaction';
+export * from './factory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mixins/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/lib/mixins/interaction.d.ts

@@ -0,0 +1,20 @@
+import { AllFederatedEventMap, Container, FederatedEvent } from 'pixi.js';
+import { Signal } from '../signals';
+import { Constructor } from '../utils';
+type InteractionEventName = keyof AllFederatedEventMap;
+export type InteractionSignal = Signal<(event: FederatedEvent) => void>;
+/**
+ * Represents an interactive element.
+ */
+export interface IInteractive {
+    onInteraction: (eventName: InteractionEventName) => InteractionSignal;
+}
+/**
+ * Adds interactive functionality to a container.
+ *
+ * @param {Constructor<Container>} Base - The base container class.
+ * @returns {Constructor<IInteractive>} - The extended container class with interactive functionality.
+ */
+export declare function Interactive<TBase extends Constructor<Container>>(Base: TBase): TBase & Constructor<IInteractive>;
+export {};
+//# sourceMappingURL=interaction.d.ts.map

package/lib/mixins/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/mixins/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,KAAK,oBAAoB,GAAG,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,iBAAiB,CAAC;CACvE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAiDhH"}

package/lib/mixins/signals.d.ts

@@ -0,0 +1,15 @@
+import { DestroyOptions } from 'pixi.js';
+import { SignalConnection, SignalConnections } from '../signals';
+import { Constructor } from '../utils';
+/**
+ * Interface for animated entities.
+ */
+export interface ISignalContainer {
+    signalConnections: SignalConnections;
+    destroy(options?: DestroyOptions): void;
+    addSignalConnection(...args: SignalConnection[]): void;
+    connectSignal(...args: SignalConnection[]): void;
+    connectAction(...args: SignalConnection[]): void;
+}
+export declare function WithSignals<TBase extends Constructor<any>>(Base: TBase): TBase & Constructor<ISignalContainer>;
+//# sourceMappingURL=signals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/mixins/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAExC,mBAAmB,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACvD,aAAa,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACjD,aAAa,CAAC,GAAG,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,WAAW,CAAC,KAAK,SAAS,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC,CA+B9G"}

package/lib/plugins/AssetsPlugin.d.ts

@@ -0,0 +1,79 @@
+import { UnresolvedAsset } from 'pixi.js';
+import { IScene } from '../display';
+import { Signal } from '../signals';
+import { AssetLike, AssetLoadingOptions, AssetTypes, BundleTypes, SceneImportListItem } from '../utils';
+import { IPlugin, Plugin } from './Plugin';
+export interface IAssetsPlugin extends IPlugin {
+    onLoadStart: Signal<() => void>;
+    onLoadProgress: Signal<(progress: number) => void>;
+    onLoadComplete: Signal<() => void>;
+    onLoadRequiredStart: Signal<() => void>;
+    onLoadRequiredProgress: Signal<(progress: number) => void>;
+    onLoadRequiredComplete: Signal<() => void>;
+    onBackgroundLoadStart: Signal<() => void>;
+    onBackgroundAssetLoaded: Signal<(asset: string) => void>;
+    onBackgroundBundlesLoaded: Signal<(bundles: BundleTypes) => void>;
+    webStartEvent: Event;
+    webProgressEvent: CustomEvent<{
+        progress: number;
+    }>;
+    webCompleteEvent: Event;
+    webRequiredStartEvent: Event;
+    webRequiredProgressEvent: CustomEvent<{
+        progress: number;
+    }>;
+    webRequiredCompleteEvent: Event;
+    loadAssets(assets: string | string[] | UnresolvedAsset | UnresolvedAsset[] | AssetLike | AssetLike[], reportProgress?: boolean): Promise<void>;
+    loadBundles(bundle: BundleTypes, reportProgress?: boolean): Promise<void>;
+    loadSceneAssets(scene: IScene | SceneImportListItem<any>, background?: boolean): Promise<void>;
+    unloadSceneAssets(scene: IScene | SceneImportListItem<any>): Promise<void>;
+    loadRequired(): Promise<void>;
+    loadBackground(): void;
+}
+export declare class AssetsPlugin extends Plugin<AssetLoadingOptions> implements IAssetsPlugin {
+    readonly id: string;
+    onLoadStart: Signal<() => void>;
+    onLoadProgress: Signal<(progress: number) => void>;
+    onLoadComplete: Signal<() => void>;
+    onLoadRequiredStart: Signal<() => void>;
+    onLoadRequiredProgress: Signal<(progress: number) => void>;
+    onLoadRequiredComplete: Signal<() => void>;
+    onBackgroundLoadStart: Signal<() => void>;
+    onBackgroundAssetLoaded: Signal<(asset: string) => void>;
+    onBackgroundBundlesLoaded: Signal<(bundles: BundleTypes) => void>;
+    private _loadedBundles;
+    private _loadedAssets;
+    private _required;
+    private _background;
+    private _isLoadingRequired;
+    webRequiredStartEvent: Event;
+    webRequiredProgressEvent: CustomEvent<{
+        progress: number;
+    }>;
+    webRequiredCompleteEvent: Event;
+    webStartEvent: Event;
+    webProgressEvent: CustomEvent<{
+        progress: number;
+    }>;
+    webCompleteEvent: Event;
+    initialize(options?: AssetLoadingOptions): Promise<void> | void;
+    loadRequired(): Promise<void>;
+    loadBackground(): void;
+    loadAssets(assets: AssetTypes, reportProgress?: boolean): Promise<void>;
+    loadBundles(bundles: BundleTypes, reportProgress?: boolean): Promise<void>;
+    unloadSceneAssets(scene: IScene | SceneImportListItem<any>): Promise<void>;
+    loadSceneAssets(scene: IScene | SceneImportListItem<any>, background?: boolean): Promise<void>;
+    protected getCoreFunctions(): string[];
+    protected getCoreSignals(): string[];
+    private _isAssetLoaded;
+    private _isBundleLoaded;
+    private _markAssetsLoaded;
+    private _markBundlesLoaded;
+    private _markAssetsUnloaded;
+    private _markBundlesUnloaded;
+    private _handleLoadStart;
+    private _handleLoadProgress;
+    private _handleLoadComplete;
+    private dispatchWebEvent;
+}
+//# sourceMappingURL=AssetsPlugin.d.ts.map

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

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

package/lib/plugins/DataAdapter.d.ts

@@ -0,0 +1,95 @@
+import { Signal } from '../signals';
+import { AppTypeOverrides, DeepPartial } from '../utils';
+import { Plugin } from './Plugin';
+export type DataSchema = {
+    [key: string]: any;
+};
+/**
+ * Interface for the options of the DataAdapter.
+ */
+export interface IDataAdapterOptions {
+    initial: Partial<AppTypeOverrides['Data']>;
+    /**
+     * The namespace to use for the keys in local storage.
+     */
+    namespace: string;
+    /**
+     * Whether to override the data with the data from local storage.
+     */
+    overrideWithLocalStorage: boolean;
+    /**
+     * Whether to backup all data to local storage.
+     */
+    backupAll: boolean;
+    /**
+     * The keys to backup to local storage.
+     */
+    backupKeys: Array<keyof AppTypeOverrides['Data']>;
+}
+export interface DataChangeSignalDetail {
+    key?: any;
+    value?: any;
+    restore?: boolean;
+    clear?: boolean;
+}
+type DataAdapterType = AppTypeOverrides['Data'];
+export interface IDataAdapter {
+    get(): DataAdapterType;
+    get<K extends keyof DataAdapterType>(key: K): DataAdapterType[K] | undefined;
+    set<K extends keyof DataAdapterType>(key: K, data: DataAdapterType[K]): DataAdapterType;
+    set(data: DeepPartial<DataAdapterType>, merge?: boolean): DataAdapterType;
+    clear(): void;
+    clear<K extends keyof DataAdapterType>(key: K): void;
+    increment<K extends keyof DataAdapterType & {
+        [P in keyof DataAdapterType]: DataAdapterType[P] extends number ? P : never;
+    }[keyof DataAdapterType]>(key: K, amount?: number): DataAdapterType[K];
+    concat<K extends keyof DataAdapterType & {
+        [P in keyof DataAdapterType]: DataAdapterType[P] extends any[] ? P : never;
+    }[keyof DataAdapterType]>(key: K, value: DataAdapterType[K] extends (infer E)[] ? E | E[] : never): DataAdapterType[K];
+    append<K extends keyof DataAdapterType & {
+        [P in keyof DataAdapterType]: DataAdapterType[P] extends string ? P : never;
+    }[keyof DataAdapterType]>(key: K, value: string, separator?: string): DataAdapterType[K];
+    snapshot(): DataAdapterType;
+    snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K];
+    onDataChange: Signal<(detail: DataChangeSignalDetail) => void>;
+    clearOnResume?: boolean;
+}
+export declare function defineData<T extends DataSchema>(data: T): T;
+/**
+ * An in-memory game-data plugin with optional localStorage backup.
+ *
+ * Not `IStorageCapability` — its API (`get`/`set`/`increment`/...) is richer
+ * than the generic save/load contract. Accessed directly via `app.data`.
+ */
+export declare class DataAdapter extends Plugin<Partial<IDataAdapterOptions>> implements IDataAdapter {
+    data: DataAdapterType;
+    onDataChange: Signal<(detail: DataChangeSignalDetail) => void>;
+    private backupKeys;
+    private backupAll;
+    private namespace;
+    private overrideWithLocalStorage;
+    constructor(id?: string);
+    getCoreSignals(): string[];
+    destroy(): void;
+    initialize(options?: Partial<IDataAdapterOptions>): void;
+    set<K extends keyof DataAdapterType>(key: K, data: DataAdapterType[K]): DataAdapterType;
+    set(data: DeepPartial<DataAdapterType>, merge?: boolean): DataAdapterType;
+    get(): DataAdapterType;
+    get<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | undefined;
+    increment<K extends keyof DataAdapterType & {
+        [P in keyof DataAdapterType]: DataAdapterType[P] extends number ? P : never;
+    }[keyof DataAdapterType]>(key: K, amount?: number): DataAdapterType[K];
+    concat<K extends keyof DataAdapterType & {
+        [P in keyof DataAdapterType]: DataAdapterType[P] extends any[] ? P : never;
+    }[keyof DataAdapterType]>(key: K, value: DataAdapterType[K] extends (infer E)[] ? E | E[] : never): DataAdapterType[K];
+    append<K extends keyof DataAdapterType & {
+        [P in keyof DataAdapterType]: DataAdapterType[P] extends string ? P : never;
+    }[keyof DataAdapterType]>(key: K, value: string, separator?: string): DataAdapterType[K];
+    clear(): void;
+    snapshot(): DataAdapterType;
+    snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K];
+    private backupToLocalStorage;
+    private restoreFromLocalStorage;
+}
+export {};
+//# sourceMappingURL=DataAdapter.d.ts.map

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

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