@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/ui/Widget.js

@@ -0,0 +1,113 @@
+import { Container } from '../rendering/Container.js';
+
+/** Normalized (0..1) horizontal/vertical factors for an anchor. */
+const anchorFactors = (anchor) => {
+    let x = 0.5;
+    let y = 0.5;
+    if (anchor.endsWith('left')) {
+        x = 0;
+    }
+    else if (anchor.endsWith('right')) {
+        x = 1;
+    }
+    if (anchor.startsWith('top')) {
+        y = 0;
+    }
+    else if (anchor.startsWith('bottom')) {
+        y = 1;
+    }
+    return [x, y];
+};
+/**
+ * Base class for UI widgets — a {@link Container} with an explicit layout size
+ * (independent of child bounds / scale), an `enabled` flag, and optional
+ * screen-edge anchoring that re-applies on resize.
+ *
+ * Subclasses redraw size-dependent content in {@link Widget._relayout} and
+ * react to enable/disable in {@link Widget._onEnabledChanged}.
+ */
+class Widget extends Container {
+    _uiWidth = 0;
+    _uiHeight = 0;
+    _enabled = true;
+    _uiAnchor = null;
+    _uiAnchorOffsetX = 0;
+    _uiAnchorOffsetY = 0;
+    _uiAnchorRoot = null;
+    _onAnchorResize = (width, height) => {
+        this._applyAnchor(width, height);
+    };
+    /** Explicit layout width in pixels (not derived from children or scale). */
+    get uiWidth() {
+        return this._uiWidth;
+    }
+    /** Explicit layout height in pixels (not derived from children or scale). */
+    get uiHeight() {
+        return this._uiHeight;
+    }
+    /** Set the widget's layout size; triggers a redraw and re-anchors if anchored. */
+    setSize(width, height) {
+        const w = Math.max(0, width);
+        const h = Math.max(0, height);
+        if (this._uiWidth !== w || this._uiHeight !== h) {
+            this._uiWidth = w;
+            this._uiHeight = h;
+            this._relayout();
+            if (this._uiAnchorRoot !== null) {
+                this._applyAnchor(this._uiAnchorRoot.screenWidth, this._uiAnchorRoot.screenHeight);
+            }
+        }
+        return this;
+    }
+    /** Whether the widget responds to input. Disabled widgets typically dim and ignore clicks. */
+    get enabled() {
+        return this._enabled;
+    }
+    set enabled(value) {
+        if (this._enabled !== value) {
+            this._enabled = value;
+            this._onEnabledChanged(value);
+        }
+    }
+    /**
+     * Anchor this widget within `root`'s screen box at `anchor`, offset by
+     * `(offsetX, offsetY)`. The position is recomputed whenever the screen
+     * resizes. E.g. `widget.anchorIn(scene.ui, 'bottom-right', -20, -20)` pins it
+     * to the bottom-right corner with a 20px margin.
+     */
+    anchorIn(root, anchor, offsetX = 0, offsetY = 0) {
+        this._uiAnchor = anchor;
+        this._uiAnchorOffsetX = offsetX;
+        this._uiAnchorOffsetY = offsetY;
+        if (this._uiAnchorRoot !== root) {
+            this._uiAnchorRoot?.onResize.remove(this._onAnchorResize);
+            this._uiAnchorRoot = root;
+            root.onResize.add(this._onAnchorResize);
+        }
+        this._applyAnchor(root.screenWidth, root.screenHeight);
+        return this;
+    }
+    _applyAnchor(containerWidth, containerHeight) {
+        if (this._uiAnchor === null) {
+            return;
+        }
+        const [ax, ay] = anchorFactors(this._uiAnchor);
+        this.setPosition(ax * (containerWidth - this._uiWidth) + this._uiAnchorOffsetX, ay * (containerHeight - this._uiHeight) + this._uiAnchorOffsetY);
+    }
+    /** Redraw size-dependent content (background, child positions). Override in subclasses. */
+    _relayout() {
+        // Overridden by subclasses that draw a sized background.
+    }
+    /** React to an enabled/disabled change. Override in subclasses. */
+    _onEnabledChanged(_enabled) {
+        // Overridden by interactive subclasses (e.g. Button dimming).
+    }
+    destroy() {
+        this._uiAnchorRoot?.onResize.remove(this._onAnchorResize);
+        this._uiAnchorRoot = null;
+        super.destroy();
+    }
+}
+
+export { Widget };
+//# sourceMappingURL=Widget.js.map

package/dist/esm/ui/Widget.js.map

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

package/dist/esm/ui/index.d.ts

@@ -0,0 +1,17 @@
+export type { ButtonOptions } from './Button';
+export { Button } from './Button';
+export { Label } from './Label';
+export type { PanelOptions } from './Panel';
+export { Panel } from './Panel';
+export type { ProgressBarOptions } from './ProgressBar';
+export { ProgressBar } from './ProgressBar';
+export type { ScrollContainerOptions, ScrollDirection } from './ScrollContainer';
+export { ScrollContainer } from './ScrollContainer';
+export type { StackDirection, StackOptions } from './Stack';
+export { Stack } from './Stack';
+export type { TooltipOptions } from './Tooltip';
+export { Tooltip } from './Tooltip';
+export { UIRoot } from './UIRoot';
+export type { WidgetAnchor } from './Widget';
+export { Widget } from './Widget';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}