zimporter-html 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yonny Zohar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# zImporter HTML
+
+An HTML/CSS div-based renderer for zStudio scenes. Part of the `zImporter` family alongside the [PIXI](https://github.com/yonnyzohar/zImporter_PIXI) and [Phaser](https://github.com/yonnyzohar/zImporter_Phaser) versions.
+
+## What it does
+
+Loads the same `placements.json` format produced by zStudio and constructs the scene as a tree of `<div>` elements using CSS transforms — no canvas, no game engine dependency.
+
+### Supported asset types
+
+| Type | Status |
+|------|--------|
+| Container (asset) | ✅ |
+| Button (btn) | ✅ |
+| State machine (state) | ✅ |
+| Toggle | ✅ |
+| Timeline / animation | ✅ |
+| Image (img) | ✅ |
+| Nine-slice (9slice) | ✅ via `border-image` |
+| Text / TextField | ✅ via `<span>` |
+| Spine | ❌ not supported |
+| Particles | ❌ not supported |
+
+## Installation
+
+```bash
+npm install
+npm run build      # emit JS + .d.ts to dist/
+npm run package    # also bundles with webpack → dist/zimporter-html.min.js
+```
+
+## Usage
+
+```typescript
+import { ZScene, ZButton, ZToggle, ZTimeline, ZContainer, ZUpdatables } from 'zimporter-html';
+
+// 1. Boot the animation ticker (drives ZTimeline)
+ZUpdatables.init(24); // fps
+
+// 2. Create and load a scene
+const scene = new ZScene('myScene');
+scene.load('./assets/myScene/', () => {
+
+  // 3. Build the DOM and attach it to a host element
+  scene.loadStage(document.getElementById('app')!);
+
+  // 4. Access named containers exactly as in the PIXI / Phaser versions
+  const btn = scene.sceneStage.get('myButton') as ZButton;
+  btn.pressCallback = () => console.log('Button pressed!');
+
+  // 5. React to resize
+  window.addEventListener('resize', () =>
+    scene.resize(window.innerWidth, window.innerHeight));
+});
+```
+
+## Transform model
+
+CSS transforms replicate PIXI's hierarchical transform 1-to-1:
+
+```
+T(x, y) · R(rotation) · S(scaleX, scaleY) · T(–pivotX, –pivotY)
+```
+
+Each `ZContainer` is a `position:absolute; width:0; height:0; overflow:visible` div so children are placed in local coordinate space and the parent's transform is applied hierarchically, identical to PIXI containers.
+
+The stage div is given explicit `width × height` (scene resolution) and then scaled + centred via CSS transform to fit the viewport.
+
+## API surface
+
+The public API is identical to `zImporter-PIXI`:
+
+- `ZContainer` — base display object (div)
+- `ZButton` — interactive button with up/down/over/disabled states
+- `ZState` — shows one named child state at a time
+- `ZToggle` — flips between `onState` / `offState`
+- `ZTimeline` — frame-based animation driven by `ZUpdatables`
+- `ZScene` — loads `placements.json` and builds the scene graph
+- `ZSceneStack` — stacks multiple ZScene instances
+- `ZUpdatables` — RAF-based animation ticker
+- `ZResizeables` — resize listener registry
+- `ZCuePointsManager` — named cue-point event bus

package/dist/ParticleConverter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Converts PIXI v5 particle configuration to a simple HTML/CSS-compatible
+ * particle description.  Identical to the Phaser version — no engine-specific
+ * code was required.
+ *
+ * @remarks
+ * The HTML version does not yet have a particle renderer; this class is
+ * provided so that the same scene JSON that works in PIXI / Phaser also
+ * compiles and loads cleanly in the HTML build.
+ */
+export declare class ParticleConverter {
+    /**
+     * Converts a PIXI particles v5 config object to a normalised description
+     * that can be consumed by an HTML particle renderer.
+     */
+    static pixiToPhaserConfig(pixiConfig: any): any;
+    private static processBehavior;
+    private static processAlphaBehavior;
+    private static processScaleBehavior;
+    private static processColorBehavior;
+    private static processMoveSpeedBehavior;
+    private static processRotationStaticBehavior;
+    private static processSpawnBurstBehavior;
+    static hexToInt(hex: string): number;
+}
+//# sourceMappingURL=ParticleConverter.d.ts.map

package/dist/ParticleConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleConverter.d.ts","sourceRoot":"","sources":["../src/ParticleConverter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC1B;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG;IAoD/C,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAMnC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAMnC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IASnC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAQvC,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAM5C,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAKxC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAGvC"}

package/dist/ParticleConverter.js

@@ -0,0 +1,129 @@
+/**
+ * Converts PIXI v5 particle configuration to a simple HTML/CSS-compatible
+ * particle description.  Identical to the Phaser version — no engine-specific
+ * code was required.
+ *
+ * @remarks
+ * The HTML version does not yet have a particle renderer; this class is
+ * provided so that the same scene JSON that works in PIXI / Phaser also
+ * compiles and loads cleanly in the HTML build.
+ */
+export class ParticleConverter {
+    /**
+     * Converts a PIXI particles v5 config object to a normalised description
+     * that can be consumed by an HTML particle renderer.
+     */
+    static pixiToPhaserConfig(pixiConfig) {
+        const cfg = {};
+        // Lifetime (PIXI: seconds, output: milliseconds)
+        if (pixiConfig.lifetime) {
+            cfg.lifespan = {
+                min: (pixiConfig.lifetime.min ?? 1) * 1000,
+                max: (pixiConfig.lifetime.max ?? 1) * 1000,
+            };
+        }
+        else {
+            cfg.lifespan = { min: 1000, max: 1000 };
+        }
+        // Emission frequency (PIXI: seconds → ms)
+        if (pixiConfig.frequency !== undefined) {
+            const freqMs = pixiConfig.frequency * 1000;
+            cfg.frequency = freqMs;
+            if (pixiConfig.maxParticles) {
+                const lifespanMs = cfg.lifespan.max;
+                const maxSimultaneous = Math.ceil(lifespanMs / freqMs) + 1;
+                cfg.maxParticles = Math.max(pixiConfig.maxParticles, maxSimultaneous);
+            }
+        }
+        else {
+            cfg.frequency = 100;
+        }
+        // Max particles
+        if (pixiConfig.maxParticles) {
+            cfg.maxParticles = pixiConfig.maxParticles;
+        }
+        else {
+            cfg.maxParticles = 100;
+        }
+        // Emitter lifetime
+        if (pixiConfig.emitterLifetime === -1) {
+            cfg.duration = -1; // infinite
+        }
+        else if (pixiConfig.emitterLifetime > 0) {
+            cfg.duration = pixiConfig.emitterLifetime * 1000;
+        }
+        cfg.quantity = 1;
+        // Process behaviours
+        if (Array.isArray(pixiConfig.behaviors)) {
+            for (const behavior of pixiConfig.behaviors) {
+                ParticleConverter.processBehavior(behavior, cfg);
+            }
+        }
+        return cfg;
+    }
+    static processBehavior(behavior, cfg) {
+        switch (behavior.type) {
+            case 'alpha':
+                ParticleConverter.processAlphaBehavior(behavior.config, cfg);
+                break;
+            case 'scale':
+                ParticleConverter.processScaleBehavior(behavior.config, cfg);
+                break;
+            case 'color':
+                ParticleConverter.processColorBehavior(behavior.config, cfg);
+                break;
+            case 'moveSpeed':
+                ParticleConverter.processMoveSpeedBehavior(behavior.config, cfg);
+                break;
+            case 'rotationStatic':
+                ParticleConverter.processRotationStaticBehavior(behavior.config, cfg);
+                break;
+            case 'spawnBurst':
+                ParticleConverter.processSpawnBurstBehavior(behavior.config, cfg);
+                break;
+            default: break;
+        }
+    }
+    static processAlphaBehavior(config, cfg) {
+        if (config?.alpha?.list?.length >= 2) {
+            cfg.alpha = { start: config.alpha.list[0].value, end: config.alpha.list[config.alpha.list.length - 1].value };
+        }
+    }
+    static processScaleBehavior(config, cfg) {
+        if (config?.scale?.list?.length >= 2) {
+            cfg.scale = { start: config.scale.list[0].value, end: config.scale.list[config.scale.list.length - 1].value };
+        }
+    }
+    static processColorBehavior(config, cfg) {
+        if (config?.color?.list?.length >= 2) {
+            cfg.tint = {
+                start: ParticleConverter.hexToInt(config.color.list[0].value),
+                end: ParticleConverter.hexToInt(config.color.list[config.color.list.length - 1].value),
+            };
+        }
+    }
+    static processMoveSpeedBehavior(config, cfg) {
+        if (config?.speed?.list?.length >= 2) {
+            cfg.speed = { start: config.speed.list[0].value, end: config.speed.list[config.speed.list.length - 1].value };
+        }
+        if (config?.minMult !== undefined)
+            cfg.speedMult = { min: config.minMult, max: 1 };
+        if (config?.acceleration)
+            cfg.gravityY = config.acceleration.y ?? 0;
+    }
+    static processRotationStaticBehavior(config, cfg) {
+        if (config?.min !== undefined && config?.max !== undefined) {
+            cfg.rotate = { min: config.min, max: config.max };
+        }
+    }
+    static processSpawnBurstBehavior(config, cfg) {
+        if (config?.particlesPerWave)
+            cfg.quantity = config.particlesPerWave;
+        if (config?.angle)
+            cfg.angle = { min: config.angle.min ?? 0, max: config.angle.max ?? 360 };
+    }
+    static hexToInt(hex) {
+        return parseInt(hex.replace('#', ''), 16);
+    }
+}
+//# sourceMappingURL=ParticleConverter.js.map

package/dist/ParticleConverter.js.map

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

package/dist/SceneData.d.ts

@@ -0,0 +1,189 @@
+export interface BoxStroke {
+    color?: number;
+    width?: number;
+    alpha?: number;
+}
+export interface InputBoxStyle {
+    fill: number;
+    rounded?: number;
+    stroke?: BoxStroke;
+}
+export interface InputParams {
+    fontFamily: string;
+    fontSize: string;
+    padding: string;
+    width: string;
+    color: string | number;
+    fontWeight?: string;
+    textAlign: string;
+    textIndent?: string;
+    lineHeight?: string;
+}
+export interface TextInputObj {
+    input: InputParams;
+    box: {
+        default: InputBoxStyle;
+        focused: InputBoxStyle;
+        disabled: InputBoxStyle;
+    };
+}
+export interface TextInputData extends BaseAssetData {
+    x: number;
+    y: number;
+    text: string;
+    props: TextInputObj;
+}
+export interface SpineData extends BaseAssetData {
+    name: string;
+    spineJson: string;
+    spineAtlas: string;
+    pngFiles: string[];
+    animations: string[];
+    skin?: string;
+    playOnStart?: {
+        value: boolean;
+        animation: string;
+    };
+}
+export interface ParticleData extends BaseAssetData {
+    jsonPath: string;
+    pngPaths: string[];
+    name: string;
+    emitterConfig: any;
+}
+export declare enum AnchorConsts {
+    NONE = "none",
+    TOP_LEFT = "topLeft",
+    TOP_RIGHT = "topRight",
+    BOTTOM_LEFT = "btmLeft",
+    BOTTOM_RIGHT = "btmRight",
+    LEFT = "left",
+    RIGHT = "right",
+    TOP = "top",
+    BOTTOM = "btm",
+    CENTER = "center"
+}
+export interface ResolutionData {
+    x: number;
+    y: number;
+}
+export interface OrientationData {
+    x: number;
+    y: number;
+    rotation: number;
+    scaleX: number;
+    scaleY: number;
+    alpha: number;
+    pivotX: number;
+    pivotY: number;
+    visible: boolean;
+    isAnchored: boolean;
+    anchorType?: AnchorConsts;
+    anchorPercentage?: {
+        x: number;
+        y: number;
+    };
+    width: number;
+    height: number;
+}
+export interface BaseAssetData {
+    type: string;
+    name: string;
+    filters: any;
+}
+export interface InstanceAttributes {
+    fitToScreen?: boolean;
+}
+export interface InstanceData extends BaseAssetData {
+    template: boolean;
+    instanceName: string;
+    guide: boolean;
+    portrait: OrientationData;
+    landscape: OrientationData;
+    attrs?: InstanceAttributes;
+}
+export interface SpriteData extends BaseAssetData {
+    name: string;
+    type: string;
+    width: number;
+    height: number;
+    filePath: string;
+    x: number;
+    y: number;
+    pivotX: number;
+    pivotY: number;
+}
+export interface NineSliceData extends SpriteData {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    origWidth: number;
+    origHeight: number;
+    portrait: OrientationData;
+    landscape: OrientationData;
+}
+export interface GradientData {
+    colors: number[];
+    percentages: number[];
+    fillGradientType: number;
+}
+export interface TextData extends BaseAssetData {
+    x: number;
+    y: number;
+    rotation: number;
+    width: number;
+    height: number;
+    alpha: number;
+    size: number | string;
+    color?: string | number;
+    align: string;
+    text: string;
+    fontName: string | string[];
+    lineHeight?: number;
+    stroke?: string | number;
+    strokeThickness?: number;
+    wordWrap?: boolean;
+    wordWrapWidth?: number;
+    letterSpacing?: number;
+    fontWeight?: string;
+    textAnchorX: number;
+    textAnchorY: number;
+    pivotX: number;
+    pivotY: number;
+    /** Key used to look up the .fnt / .png bitmap font files. */
+    uniqueFontName?: string;
+    /** 'gradient' | 'solid' */
+    fillType?: string;
+    gradientData?: GradientData;
+}
+export interface AnimTrackData {
+    x?: number;
+    y?: number;
+    scaleX?: number;
+    scaleY?: number;
+    rotation?: number;
+    alpha?: number;
+    pivotX?: number;
+    pivotY?: number;
+}
+export interface TemplateData {
+    type: string;
+    name: string;
+    children: BaseAssetData[];
+}
+export interface StageData {
+    children: InstanceData[];
+    type: string;
+    name: string;
+}
+export interface SceneData {
+    resolution: ResolutionData;
+    animTracks?: Record<string, AnimTrackData[]>;
+    cuePoints?: Record<string, Record<number, string>>;
+    stage: StageData;
+    templates: Record<string, TemplateData>;
+    fonts: string[];
+    atlas?: boolean;
+}
+//# sourceMappingURL=SceneData.d.ts.map

package/dist/SceneData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneData.d.ts","sourceRoot":"","sources":["../src/SceneData.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE;QACD,OAAO,EAAE,aAAa,CAAC;QACvB,OAAO,EAAE,aAAa,CAAC;QACvB,QAAQ,EAAE,aAAa,CAAC;KAC3B,CAAC;CACL;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAChD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;CACvB;AAID,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE;QACV,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,GAAG,CAAC;CACtB;AAID,oBAAY,YAAY;IACpB,IAAI,SAAS;IACb,QAAQ,YAAY;IACpB,SAAS,aAAa;IACtB,WAAW,YAAY;IACvB,YAAY,aAAa;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,QAAQ;IACd,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,cAAc;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,gBAAgB,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC1B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/SceneData.js

@@ -0,0 +1,16 @@
+// ── Input field types ─────────────────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────────────────────────
+export var AnchorConsts;
+(function (AnchorConsts) {
+    AnchorConsts["NONE"] = "none";
+    AnchorConsts["TOP_LEFT"] = "topLeft";
+    AnchorConsts["TOP_RIGHT"] = "topRight";
+    AnchorConsts["BOTTOM_LEFT"] = "btmLeft";
+    AnchorConsts["BOTTOM_RIGHT"] = "btmRight";
+    AnchorConsts["LEFT"] = "left";
+    AnchorConsts["RIGHT"] = "right";
+    AnchorConsts["TOP"] = "top";
+    AnchorConsts["BOTTOM"] = "btm";
+    AnchorConsts["CENTER"] = "center";
+})(AnchorConsts || (AnchorConsts = {}));
+//# sourceMappingURL=SceneData.js.map

package/dist/SceneData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneData.js","sourceRoot":"","sources":["../src/SceneData.ts"],"names":[],"mappings":"AACA,iFAAiF;AAgEjF,gFAAgF;AAEhF,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACpB,6BAAa,CAAA;IACb,oCAAoB,CAAA;IACpB,sCAAsB,CAAA;IACtB,uCAAuB,CAAA;IACvB,yCAAyB,CAAA;IACzB,6BAAa,CAAA;IACb,+BAAe,CAAA;IACf,2BAAW,CAAA;IACX,8BAAc,CAAA;IACd,iCAAiB,CAAA;AACrB,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB"}

package/dist/ZButton.d.ts

@@ -0,0 +1,37 @@
+import { ZContainer } from './ZContainer';
+export declare const RemoveClickListener: (container: ZContainer) => void;
+export declare const AttachClickListener: (container: ZContainer, pressCallback?: () => void, longPressCallback?: () => void) => void;
+export declare const AddHoverListener: (container: ZContainer, hoverCallback: (...args: any[]) => void, outCallback: (...args: any[]) => void) => void;
+export declare const RemoveHoverListener: (container: ZContainer) => void;
+export declare class ZButton extends ZContainer {
+    topLabelContainer: ZContainer;
+    topLabelContainer2: ZContainer;
+    overState: ZContainer;
+    overLabelContainer: ZContainer;
+    overLabelContainer2: ZContainer;
+    downState: ZContainer;
+    downLabelContainer: ZContainer;
+    downLabelContainer2: ZContainer;
+    upState: ZContainer;
+    upLabelContainer: ZContainer;
+    upLabelContainer2: ZContainer;
+    disabledState: ZContainer;
+    disabledLabelContainer: ZContainer;
+    disabledLabelContainer2: ZContainer;
+    pressCallback?: () => void;
+    longPressCallback?: () => void;
+    private labelState;
+    getType(): string;
+    init(_labelStr?: string): void;
+    setLabel(name: string): void;
+    setLabel2(name: string): void;
+    setFixedTextSize(fixed: boolean): void;
+    makeSingleLine(): void;
+    getLabel(): HTMLElement | null;
+    private _showState;
+    enable(): void;
+    disable(): void;
+    private _interactionsAttached;
+    private _attachInteractions;
+}
+//# sourceMappingURL=ZButton.d.ts.map

package/dist/ZButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZButton.d.ts","sourceRoot":"","sources":["../src/ZButton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C,eAAO,MAAM,mBAAmB,GAAI,WAAW,UAAU,KAAG,IAO3D,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC5B,WAAW,UAAU,EACrB,gBAAgB,MAAM,IAAI,EAC1B,oBAAoB,MAAM,IAAI,KAC/B,IAwDF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GACzB,WAAW,UAAU,EACrB,eAAe,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EACvC,aAAa,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KACtC,IAGF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,WAAW,UAAU,KAAG,IAG3D,CAAC;AAQF,qBAAa,OAAQ,SAAQ,UAAU;IACnC,iBAAiB,EAAG,UAAU,CAAC;IAC/B,kBAAkB,EAAG,UAAU,CAAC;IAEhC,SAAS,EAAG,UAAU,CAAC;IACvB,kBAAkB,EAAG,UAAU,CAAC;IAChC,mBAAmB,EAAG,UAAU,CAAC;IAEjC,SAAS,EAAG,UAAU,CAAC;IACvB,kBAAkB,EAAG,UAAU,CAAC;IAChC,mBAAmB,EAAG,UAAU,CAAC;IAEjC,OAAO,EAAG,UAAU,CAAC;IACrB,gBAAgB,EAAG,UAAU,CAAC;IAC9B,iBAAiB,EAAG,UAAU,CAAC;IAE/B,aAAa,EAAG,UAAU,CAAC;IAC3B,sBAAsB,EAAG,UAAU,CAAC;IACpC,uBAAuB,EAAG,UAAU,CAAC;IAErC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE/B,OAAO,CAAC,UAAU,CAAsB;IAExB,OAAO,IAAI,MAAM;IAEjB,IAAI,CAAC,SAAS,GAAE,MAAW,GAAG,IAAI;IA2ClD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa7B,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKtC,cAAc,IAAI,IAAI;IAQf,QAAQ,IAAI,WAAW,GAAG,IAAI;IAWrC,OAAO,CAAC,UAAU;IAOlB,MAAM,IAAI,IAAI;IASd,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,qBAAqB,CAAS;IAEtC,OAAO,CAAC,mBAAmB;CAiD9B"}