zimporter-phaser 1.0.40

package/dist/ZSpine.js

@@ -0,0 +1,221 @@
+import { TextureAtlas, TextureAtlasPage, TextureAtlasRegion, TextureFilter, TextureWrap, } from "@esotericsoftware/spine-core";
+/**
+ * ZSpine — loads a Spine 4.x skeleton using the @esotericsoftware/spine-phaser plugin.
+ *
+ * Supports both:
+ *  - Standard path: spineJson + spineAtlas file via plugin loader
+ *  - No-atlas path: spineJson + individual pngFiles
+ *    PNGs are loaded as Phaser textures, then a TextureAtlas is built manually
+ *    (mirroring the PIXI version) and injected into the plugin's atlasCache.
+ *
+ * Register SpinePlugin in your Phaser game config:
+ *   plugins: { scene: [{ key: "SpinePlugin", plugin: SpinePlugin, mapping: "spine" }] }
+ */
+export class ZSpine {
+    phaserScene;
+    spineData;
+    assetBasePath;
+    constructor(scene, spineData, assetBasePath) {
+        this.phaserScene = scene;
+        this.spineData = spineData;
+        this.assetBasePath = assetBasePath.endsWith("/") ? assetBasePath : assetBasePath + "/";
+    }
+    async load(callback) {
+        const scene = this.phaserScene;
+        const data = this.spineData;
+        const base = this.assetBasePath;
+        const spinePlugin = scene.spine;
+        if (!spinePlugin) {
+            console.warn(`ZSpine: SpinePlugin not registered on scene.\n` +
+                `Add to Phaser config: plugins: { scene: [{ key:"SpinePlugin", plugin: SpinePlugin, mapping:"spine" }] }\n` +
+                `Spine asset "${data.name}" will not be displayed.`);
+            callback(undefined);
+            return;
+        }
+        const uid = Math.random().toString(36).slice(2);
+        const jsonKey = `${data.name}_json_${uid}`;
+        const atlasKey = `${data.name}_atlas_${uid}`;
+        try {
+            if (data.spineAtlas && data.spineAtlas !== "") {
+                // Standard path: queue both files then wait for the loader to complete
+                scene.load.spineJson(jsonKey, base + data.spineJson);
+                scene.load.spineAtlas(atlasKey, base + data.spineAtlas);
+                await this.waitForLoader();
+            }
+            else if (data.pngFiles && data.pngFiles.length > 0) {
+                // No-atlas path: load PNGs + JSON, build atlas manually, inject into plugin cache
+                await this.loadImages(data.pngFiles, base);
+                await this.loadJsonFile(jsonKey, base + data.spineJson);
+                this.buildAndInjectAtlas(atlasKey, data.pngFiles, spinePlugin);
+            }
+            else {
+                console.warn(`ZSpine: No atlas or pngFiles for "${data.name}"`);
+                callback(undefined);
+                return;
+            }
+            const spineObj = scene.add.spine(0, 0, jsonKey, atlasKey);
+            if (!spineObj) {
+                console.error(`ZSpine: scene.add.spine returned null for "${data.name}"`);
+                callback(undefined);
+                return;
+            }
+            if (data.skin) {
+                try {
+                    spineObj.skeleton.setSkinByName(data.skin);
+                    spineObj.skeleton.setToSetupPose();
+                }
+                catch (_) { /* skin may not exist */ }
+            }
+            if (data.playOnStart?.value && data.playOnStart?.animation) {
+                try {
+                    spineObj.animationState.setAnimation(0, data.playOnStart.animation, true);
+                }
+                catch (_) { /* animation may not exist */ }
+            }
+            callback(spineObj);
+        }
+        catch (err) {
+            console.error(`ZSpine: Error loading "${data.name}":`, err);
+            callback(undefined);
+        }
+    }
+    /**
+     * Builds a TextureAtlas directly from already-loaded Phaser textures,
+     * wires GLTexture (WebGL) or CanvasTexture wrappers, and injects into
+     * the SpinePlugin's atlasCache. getAtlas() checks atlasCache first —
+     * it returns the pre-built atlas directly without parsing any text file.
+     */
+    buildAndInjectAtlas(atlasKey, pngFiles, spinePlugin) {
+        const isWebGL = spinePlugin.isWebGL;
+        const gl = spinePlugin.gl;
+        // Pass empty string — we override pages/regions immediately after
+        const atlas = new TextureAtlas("");
+        atlas.pages = [];
+        atlas.regions = [];
+        for (const png of pngFiles) {
+            const texKey = this.texKey(png);
+            const phaserTex = this.phaserScene.textures.get(texKey);
+            const srcImage = phaserTex?.getSourceImage?.();
+            if (!srcImage) {
+                console.warn(`ZSpine: No loaded image for "${png}" (key: ${texKey})`);
+                continue;
+            }
+            const w = srcImage.naturalWidth || srcImage.width || 1;
+            const h = srcImage.naturalHeight || srcImage.height || 1;
+            const fileName = this.fileName(png); // "Spark.png"
+            const regionName = this.baseName(png); // "Spark"
+            // One page per PNG
+            const page = new TextureAtlasPage(fileName);
+            page.width = w;
+            page.height = h;
+            page.minFilter = TextureFilter.Linear;
+            page.magFilter = TextureFilter.Linear;
+            page.uWrap = TextureWrap.ClampToEdge;
+            page.vWrap = TextureWrap.ClampToEdge;
+            // Region: one per page, full image (constructor auto-pushes to page.regions)
+            const region = new TextureAtlasRegion(page, regionName);
+            region.x = 0;
+            region.y = 0;
+            region.width = w;
+            region.height = h;
+            region.originalWidth = w;
+            region.originalHeight = h;
+            region.offsetX = 0;
+            region.offsetY = 0;
+            region.degrees = 0;
+            region.index = -1;
+            region.u = 0;
+            region.v = 0;
+            region.u2 = 1;
+            region.v2 = 1;
+            // Wire the texture — page.setTexture() sets filters/wraps and assigns
+            // texture to every region in page.regions (region.texture is what the renderer uses)
+            if (isWebGL && gl) {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { GLTexture } = require("@esotericsoftware/spine-webgl");
+                page.setTexture(new GLTexture(gl, srcImage, false));
+            }
+            else {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { CanvasTexture } = require("@esotericsoftware/spine-canvas");
+                page.setTexture(new CanvasTexture(srcImage));
+            }
+            atlas.pages.push(page);
+            atlas.regions.push(region);
+            // Alias "Frame0" → "Frame" so attachments referencing the base name resolve
+            const seqMatch = regionName.match(/^(.*?)(\d+)$/);
+            if (seqMatch && parseInt(seqMatch[2], 10) === 0) {
+                const baseName = seqMatch[1];
+                if (!atlas.regions.find((r) => r.name === baseName)) {
+                    const alias = new TextureAtlasRegion(page, baseName);
+                    alias.x = region.x;
+                    alias.y = region.y;
+                    alias.width = region.width;
+                    alias.height = region.height;
+                    alias.originalWidth = region.originalWidth;
+                    alias.originalHeight = region.originalHeight;
+                    alias.offsetX = region.offsetX;
+                    alias.offsetY = region.offsetY;
+                    alias.degrees = region.degrees;
+                    alias.index = region.index;
+                    alias.u = region.u;
+                    alias.v = region.v;
+                    alias.u2 = region.u2;
+                    alias.v2 = region.v2;
+                    atlas.regions.push(alias);
+                }
+            }
+        }
+        const atlasCache = spinePlugin.atlasCache;
+        if (atlasCache) {
+            atlasCache.add(atlasKey, atlas);
+        }
+        else {
+            console.error("ZSpine: SpinePlugin.atlasCache not accessible");
+        }
+    }
+    /** Load all PNG files into Phaser's texture cache. */
+    loadImages(pngFiles, base) {
+        let queued = 0;
+        for (const png of pngFiles) {
+            const key = this.texKey(png);
+            if (!this.phaserScene.textures.exists(key)) {
+                this.phaserScene.load.image(key, base + png);
+                queued++;
+            }
+        }
+        if (queued === 0)
+            return Promise.resolve();
+        return this.waitForLoader();
+    }
+    /** Load a JSON file into Phaser's json cache. */
+    loadJsonFile(key, url) {
+        this.phaserScene.load.json(key, url);
+        return this.waitForLoader();
+    }
+    /** Wait for all currently queued loader files to finish. */
+    waitForLoader() {
+        return new Promise((resolve, reject) => {
+            if (!this.phaserScene.load.isLoading()) {
+                this.phaserScene.load.once("complete", () => resolve());
+                this.phaserScene.load.once("loaderror", (file) => reject(new Error(`ZSpine: Load error for ${file?.key}`)));
+                this.phaserScene.load.start();
+            }
+            else {
+                this.phaserScene.load.once("complete", () => resolve());
+                this.phaserScene.load.once("loaderror", (file) => reject(new Error(`ZSpine: Load error for ${file?.key}`)));
+            }
+        });
+    }
+    texKey(png) {
+        return `${this.spineData.name}_tex_${png.replace(/[^a-zA-Z0-9]/g, "_")}`;
+    }
+    fileName(png) {
+        return png.includes("/") ? png.substring(png.lastIndexOf("/") + 1) : png;
+    }
+    baseName(png) {
+        const file = this.fileName(png);
+        return file.includes(".") ? file.substring(0, file.lastIndexOf(".")) : file;
+    }
+}
+//# sourceMappingURL=ZSpine.js.map

package/dist/ZSpine.js.map

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

package/dist/ZState.d.ts

@@ -0,0 +1,18 @@
+import { ZContainer } from "./ZContainer";
+/**
+ * Stateful container for Phaser.
+ * Only one child is visible at a time; all others are hidden.
+ * Supports ZTimeline children (play/stop automatically on state switch).
+ */
+export declare class ZState extends ZContainer {
+    currentState: ZContainer | null;
+    init(): void;
+    getCurrentState(): ZContainer | null;
+    hasState(str: string): boolean;
+    /** Alias for setViewState — matches PIXI ZState API */
+    setState(str: string | number): this;
+    setViewState(str: string): ZContainer | null;
+    getAllStateNames(): (string | null)[];
+    getType(): string;
+}
+//# sourceMappingURL=ZState.d.ts.map

package/dist/ZState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZState.d.ts","sourceRoot":"","sources":["../src/ZState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;;GAIG;AAEH,qBAAa,MAAO,SAAQ,UAAU;IAC3B,YAAY,EAAE,UAAU,GAAG,IAAI,CAAQ;IAGvC,IAAI,IAAI,IAAI;IAIZ,eAAe,IAAI,UAAU,GAAG,IAAI;IAIpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC,uDAAuD;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOpC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA+B5C,gBAAgB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;IAIrC,OAAO,IAAI,MAAM;CAG3B"}

package/dist/ZState.js

@@ -0,0 +1,64 @@
+import { ZContainer } from "./ZContainer";
+import { ZTimeline } from "./ZTimeline";
+/**
+ * Stateful container for Phaser.
+ * Only one child is visible at a time; all others are hidden.
+ * Supports ZTimeline children (play/stop automatically on state switch).
+ */
+export class ZState extends ZContainer {
+    currentState = null;
+    // Called once all children are added to the container
+    init() {
+        this.setViewState("idle");
+    }
+    getCurrentState() {
+        return this.currentState;
+    }
+    hasState(str) {
+        return this.getChildByName(str) !== null;
+    }
+    /** Alias for setViewState — matches PIXI ZState API */
+    setState(str) {
+        if (typeof str === 'string') {
+            this.setViewState(str);
+        }
+        return this;
+    }
+    setViewState(str) {
+        let chosenChild = this.get(str);
+        if (!chosenChild) {
+            chosenChild = this.get("idle");
+            if (!chosenChild && this.list.length > 0) {
+                chosenChild = this.list[0];
+            }
+        }
+        if (this.list) {
+            for (let i = 0; i < this.list.length; i++) {
+                let child = this.list[i];
+                child.visible = false;
+                if (child instanceof ZTimeline) {
+                    child.stop();
+                }
+            }
+        }
+        if (chosenChild) {
+            chosenChild.visible = true;
+            this.currentState = chosenChild;
+            if (chosenChild.parentContainer) {
+                chosenChild.parentContainer.bringToTop(chosenChild);
+            }
+            if (chosenChild instanceof ZTimeline) {
+                chosenChild.play();
+            }
+            return chosenChild;
+        }
+        return null;
+    }
+    getAllStateNames() {
+        return this.list.map((child) => child.name);
+    }
+    getType() {
+        return "ZState";
+    }
+}
+//# sourceMappingURL=ZState.js.map

package/dist/ZState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZState.js","sourceRoot":"","sources":["../src/ZState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AAEH,MAAM,OAAO,MAAO,SAAQ,UAAU;IAC3B,YAAY,GAAsB,IAAI,CAAC;IAE9C,sDAAsD;IAC/C,IAAI;QACP,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEM,eAAe;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAEM,QAAQ,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAC7C,CAAC;IAED,uDAAuD;IAChD,QAAQ,CAAC,GAAoB;QAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,YAAY,CAAC,GAAW;QAC3B,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAe,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAe,CAAC;YAC7C,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAe,CAAC;YAC7C,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACxB,KAAsC,CAAC,OAAO,GAAG,KAAK,CAAC;gBACxD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;oBAC5B,KAAmB,CAAC,IAAI,EAAE,CAAC;gBAChC,CAAC;YACL,CAAC;QACL,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YACd,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;YAChC,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;gBAC9B,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,WAAW,YAAY,SAAS,EAAE,CAAC;gBAClC,WAAyB,CAAC,IAAI,EAAE,CAAC;YACtC,CAAC;YACD,OAAO,WAAW,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,gBAAgB;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAEM,OAAO;QACV,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}

package/dist/ZTextInput.d.ts

@@ -0,0 +1,33 @@
+import Phaser from "phaser";
+import { TextInputData } from "./SceneData";
+import { ZContainer } from "./ZContainer";
+/**
+ * ZTextInput — Phaser equivalent of the PIXI ZTextInput.
+ *
+ * Renders an HTML <input> element positioned over the Phaser canvas using
+ * Phaser.GameObjects.DOMElement.  This mirrors the behaviour of the PIXI
+ * text-input library which also uses a real DOM input.
+ *
+ * Styling is applied from the same TextInputObj config used by the PIXI
+ * version so that the same scene JSON works for both engines.
+ */
+export declare class ZTextInput extends ZContainer {
+    private domElement;
+    private inputElement;
+    private props;
+    private _text;
+    constructor(scene: Phaser.Scene, data: TextInputData);
+    private createInput;
+    /** Get the current text value. */
+    getText(): string;
+    /** Set the text value. */
+    setValue(text: string): void;
+    /** Focus the input field. */
+    focus(): void;
+    /** Blur (unfocus) the input field. */
+    blur(): void;
+    /** Disable the input. */
+    setDisabled(disabled: boolean): void;
+    getType(): string;
+}
+//# sourceMappingURL=ZTextInput.d.ts.map

package/dist/ZTextInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZTextInput.d.ts","sourceRoot":"","sources":["../src/ZTextInput.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;GASG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACtC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,KAAK,CAAc;gBAEf,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa;IAOpD,OAAO,CAAC,WAAW;IAqFnB,kCAAkC;IAC3B,OAAO,IAAI,MAAM;IAIxB,0BAA0B;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOnC,6BAA6B;IACtB,KAAK,IAAI,IAAI;IAIpB,sCAAsC;IAC/B,IAAI,IAAI,IAAI;IAInB,yBAAyB;IAClB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAUpC,OAAO,IAAI,MAAM;CAG3B"}

package/dist/ZTextInput.js

@@ -0,0 +1,124 @@
+import { ZContainer } from "./ZContainer";
+/**
+ * ZTextInput — Phaser equivalent of the PIXI ZTextInput.
+ *
+ * Renders an HTML <input> element positioned over the Phaser canvas using
+ * Phaser.GameObjects.DOMElement.  This mirrors the behaviour of the PIXI
+ * text-input library which also uses a real DOM input.
+ *
+ * Styling is applied from the same TextInputObj config used by the PIXI
+ * version so that the same scene JSON works for both engines.
+ */
+export class ZTextInput extends ZContainer {
+    domElement = null;
+    inputElement = null;
+    props;
+    _text = "";
+    constructor(scene, data) {
+        super(scene, data.x ?? 0, data.y ?? 0);
+        this.props = data.props;
+        this._text = data.text || "";
+        this.createInput(scene, data);
+    }
+    createInput(scene, data) {
+        const input = document.createElement("input");
+        input.type = "text";
+        input.value = this._text;
+        // Apply styles from props.input
+        const inp = this.props?.input;
+        if (inp) {
+            if (inp.fontFamily)
+                input.style.fontFamily = inp.fontFamily;
+            if (inp.fontSize)
+                input.style.fontSize = inp.fontSize;
+            if (inp.padding)
+                input.style.padding = inp.padding;
+            if (inp.width)
+                input.style.width = inp.width;
+            if (inp.color)
+                input.style.color = typeof inp.color === "number"
+                    ? "#" + inp.color.toString(16).padStart(6, "0")
+                    : inp.color;
+            if (inp.fontWeight)
+                input.style.fontWeight = inp.fontWeight;
+            if (inp.textAlign)
+                input.style.textAlign = inp.textAlign;
+            if (inp.textIndent)
+                input.style.textIndent = inp.textIndent;
+            if (inp.lineHeight)
+                input.style.lineHeight = inp.lineHeight;
+        }
+        // Apply default box styles
+        const box = this.props?.box?.default;
+        if (box) {
+            if (box.fill !== undefined) {
+                input.style.backgroundColor = "#" + box.fill.toString(16).padStart(6, "0");
+            }
+            if (box.rounded !== undefined) {
+                input.style.borderRadius = box.rounded + "px";
+            }
+            if (box.stroke) {
+                const stroke = box.stroke;
+                const strokeColor = stroke.color !== undefined ? "#" + stroke.color.toString(16).padStart(6, "0") : "#000000";
+                const strokeWidth = stroke.width !== undefined ? stroke.width : 1;
+                const strokeAlpha = stroke.alpha !== undefined ? stroke.alpha : 1;
+                input.style.border = `${strokeWidth}px solid ${strokeColor}`;
+                input.style.opacity = String(strokeAlpha);
+            }
+        }
+        input.style.outline = "none";
+        input.style.boxSizing = "border-box";
+        // Listen for focus/blur to apply focused/disabled box styles
+        input.addEventListener("focus", () => {
+            const focused = this.props?.box?.focused;
+            if (focused?.fill !== undefined) {
+                input.style.backgroundColor = "#" + focused.fill.toString(16).padStart(6, "0");
+            }
+        });
+        input.addEventListener("blur", () => {
+            const def = this.props?.box?.default;
+            if (def?.fill !== undefined) {
+                input.style.backgroundColor = "#" + def.fill.toString(16).padStart(6, "0");
+            }
+        });
+        input.addEventListener("input", () => {
+            this._text = input.value;
+        });
+        this.domElement = scene.add.dom(0, 0, input);
+        this.add(this.domElement);
+        this.inputElement = input;
+    }
+    /** Get the current text value. */
+    getText() {
+        return this.inputElement?.value ?? this._text;
+    }
+    /** Set the text value. */
+    setValue(text) {
+        this._text = text;
+        if (this.inputElement) {
+            this.inputElement.value = text;
+        }
+    }
+    /** Focus the input field. */
+    focus() {
+        this.inputElement?.focus();
+    }
+    /** Blur (unfocus) the input field. */
+    blur() {
+        this.inputElement?.blur();
+    }
+    /** Disable the input. */
+    setDisabled(disabled) {
+        if (this.inputElement) {
+            this.inputElement.disabled = disabled;
+            const style = disabled ? this.props?.box?.disabled : this.props?.box?.default;
+            if (style?.fill !== undefined) {
+                this.inputElement.style.backgroundColor = "#" + style.fill.toString(16).padStart(6, "0");
+            }
+        }
+    }
+    getType() {
+        return "ZTextInput";
+    }
+}
+//# sourceMappingURL=ZTextInput.js.map

package/dist/ZTextInput.js.map

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

package/dist/ZTimeline.d.ts

@@ -0,0 +1,42 @@
+import { ZContainer } from "./ZContainer";
+/**
+ * Represents a timeline container that manages frame-based animations for its children.
+ * Extends `ZContainer` and provides methods to control playback, frame navigation, and event listeners.
+ *
+ * @property {number | undefined} totalFrames - The total number of frames in the timeline, determined by the longest child timeline.
+ * @property {any} _frames - The frame data for all children with timelines.
+ * @property {number} currentFrame - The current frame index being displayed.
+ * @property {boolean} looping - Indicates whether the timeline should loop when it reaches the end.
+ * @property {(self: ZTimeline) => void | undefined} func - Optional callback function invoked when the timeline ends.
+ *
+ * @method getFrames - Returns the frame data for the timeline.
+ * @method setFrames - Sets the frame data and updates the total frame count based on the longest child timeline.
+ * @method removeStateEndEventListener - Removes the end-of-state event listener.
+ * @method addStateEndEventListener - Adds a callback to be invoked when the timeline ends.
+ * @method play - Starts playback of the timeline and all child timelines.
+ * @method stop - Stops playback of the timeline and all child timelines.
+ * @method gotoAndPlay - Jumps to a specific frame and starts playback.
+ * @method update - Advances the timeline by one frame, handles looping, and invokes the end event listener if present.
+ * @method gotoAndStop - Jumps to a specific frame and updates all child transforms to match that frame.
+ */
+export declare class ZTimeline extends ZContainer {
+    [key: string]: any;
+    totalFrames: number | undefined;
+    _frames: any;
+    currentFrame: number;
+    looping: boolean;
+    cuePoints: Record<number, string>;
+    func: ((self: ZTimeline) => void) | undefined;
+    constructor(scene: Phaser.Scene, x?: number, y?: number, children?: Phaser.GameObjects.GameObject[]);
+    setCuePoints(cuePoints: Record<number, string>): void;
+    getFrames(): any;
+    setFrames(value: any): void;
+    removeStateEndEventListener(): void;
+    addStateEndEventListener(func: (self: ZTimeline) => void): void;
+    play(): void;
+    stop(): void;
+    gotoAndPlay(frameNum: number): void;
+    update(): void;
+    gotoAndStop(frameNum: number): void;
+}
+//# sourceMappingURL=ZTimeline.d.ts.map

package/dist/ZTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZTimeline.d.ts","sourceRoot":"","sources":["../src/ZTimeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,GAAG,CAAC;IACb,YAAY,EAAE,MAAM,CAAK;IACzB,OAAO,EAAE,OAAO,CAAQ;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACvC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;gBAElC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE;IAQzF,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIrD,SAAS,IAAI,GAAG;IAMhB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAe3B,2BAA2B,IAAI,IAAI;IAInC,wBAAwB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAI/D,IAAI,IAAI,IAAI;IAUZ,IAAI,IAAI,IAAI;IAUZ,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOnC,MAAM,IAAI,IAAI;IAsBd,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAmDtC"}