@mlightcad/cad-simple-viewer 1.6.3 → 1.7.1

package/lib/ui/AcUiFullscreenPanel.js

@@ -0,0 +1,224 @@
+/**
+ * Portable full-screen panel chrome (DOM + CSS only).
+ *
+ * Base for mobile “push” screens: header with back (`<`) + centered title and a
+ * content region. The offline HTML viewer pulls this via the main package
+ * export and tree-shaking (same pattern as {@link AcUiDialog}).
+ *
+ * Callers supply localized labels — this module does not depend on i18n.
+ */
+/** DOM id of the injected stylesheet. */
+var STYLE_ID = 'ml-ui-fullscreen-panel-styles';
+/** History state marker written by {@link AcUiFullscreenPanel.show}. */
+var HISTORY_STATE_KEY = 'mlcadFullscreenPanel';
+/**
+ * Mobile-style full-screen overlay with a nav header and content body.
+ *
+ * Subclasses append widgets to {@link bodyEl}. Opening optionally pushes a
+ * history entry so the system / gesture back dismisses the panel; the header
+ * back control closes the UI immediately (iframe navigations can insert extra
+ * history entries that would otherwise consume the first `history.back()`).
+ */
+var AcUiFullscreenPanel = /** @class */ (function () {
+    /**
+     * @param options - Optional mount host and root class.
+     */
+    function AcUiFullscreenPanel(options) {
+        if (options === void 0) { options = {}; }
+        var _this = this;
+        var _a;
+        this.onPopState = function () { return _this.onHistoryPop(); };
+        this.visible = false;
+        this.historyPushed = false;
+        this.labels = { title: '', back: 'Back' };
+        AcUiFullscreenPanel.injectCss();
+        this.mountHost = (_a = options.host) !== null && _a !== void 0 ? _a : document.body;
+        this.root = document.createElement('div');
+        this.root.className = ['ml-ui-fullscreen-panel', options.rootClassName]
+            .filter(Boolean)
+            .join(' ');
+        this.root.hidden = true;
+        this.root.setAttribute('aria-hidden', 'true');
+        this.root.setAttribute('role', 'dialog');
+        this.root.setAttribute('aria-modal', 'true');
+        var header = document.createElement('header');
+        header.className = 'ml-ui-fullscreen-panel__header';
+        this.backBtn = document.createElement('button');
+        this.backBtn.type = 'button';
+        this.backBtn.className = 'ml-ui-fullscreen-panel__back';
+        this.backBtn.innerHTML = backChevronIcon();
+        this.backBtn.addEventListener('click', function (e) {
+            e.preventDefault();
+            e.stopPropagation();
+            _this.requestClose();
+        });
+        this.titleEl = document.createElement('span');
+        this.titleEl.className = 'ml-ui-fullscreen-panel__title';
+        this.titleEl.id = "ml-ui-fullscreen-panel-title-".concat(AcUiFullscreenPanel.nextTitleId++);
+        this.root.setAttribute('aria-labelledby', this.titleEl.id);
+        // Trailing spacer mirrors the back button so the title stays optically centered.
+        var spacer = document.createElement('span');
+        spacer.className = 'ml-ui-fullscreen-panel__spacer';
+        spacer.setAttribute('aria-hidden', 'true');
+        header.append(this.backBtn, this.titleEl, spacer);
+        this.body = document.createElement('div');
+        this.body.className = 'ml-ui-fullscreen-panel__body';
+        this.root.append(header, this.body);
+        this.mountHost.appendChild(this.root);
+        this.applyLabels(this.labels);
+    }
+    Object.defineProperty(AcUiFullscreenPanel.prototype, "bodyEl", {
+        /** Content host for subclasses / callers. */
+        get: function () {
+            return this.body;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcUiFullscreenPanel.prototype, "rootEl", {
+        /** Root overlay element. */
+        get: function () {
+            return this.root;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcUiFullscreenPanel.prototype, "isOpen", {
+        /** Whether the panel is currently shown. */
+        get: function () {
+            return this.visible;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Shows the panel. Pushes a history entry the first time so system back can
+     * dismiss it.
+     *
+     * @param labels - Localized title and back aria-label.
+     */
+    AcUiFullscreenPanel.prototype.show = function (labels) {
+        var _a;
+        this.applyLabels(labels);
+        if (this.visible)
+            return;
+        this.visible = true;
+        this.root.hidden = false;
+        this.root.setAttribute('aria-hidden', 'false');
+        document.body.classList.add('ml-ui-fullscreen-panel-open');
+        try {
+            history.pushState((_a = {}, _a[HISTORY_STATE_KEY] = true, _a), '');
+            this.historyPushed = true;
+            window.addEventListener('popstate', this.onPopState);
+        }
+        catch (_b) {
+            this.historyPushed = false;
+        }
+        this.backBtn.focus();
+    };
+    /**
+     * Updates chrome labels without changing the open/closed state.
+     *
+     * @param labels - Localized title and back aria-label.
+     */
+    AcUiFullscreenPanel.prototype.setLabels = function (labels) {
+        this.applyLabels(labels);
+    };
+    /**
+     * Closes via the header back control. Hides immediately, then unwinds at most
+     * one history entry we pushed (does not wait on `popstate`, so iframe-added
+     * history entries cannot steal the first tap).
+     */
+    AcUiFullscreenPanel.prototype.requestClose = function () {
+        if (!this.visible)
+            return;
+        var pushed = this.historyPushed;
+        this.detachHistory();
+        this.hideUi();
+        if (!pushed)
+            return;
+        // Swallow the popstate from our intentional history.back() so it does not
+        // race with a later open.
+        var swallow = function () {
+            window.removeEventListener('popstate', swallow);
+        };
+        window.addEventListener('popstate', swallow);
+        try {
+            history.back();
+        }
+        catch (_a) {
+            window.removeEventListener('popstate', swallow);
+        }
+    };
+    /** Tears down DOM and history listeners. */
+    AcUiFullscreenPanel.prototype.dispose = function () {
+        if (this.visible && this.historyPushed) {
+            this.detachHistory();
+            var swallow_1 = function () {
+                window.removeEventListener('popstate', swallow_1);
+            };
+            window.addEventListener('popstate', swallow_1);
+            try {
+                history.back();
+            }
+            catch (_a) {
+                window.removeEventListener('popstate', swallow_1);
+            }
+        }
+        else {
+            this.detachHistory();
+        }
+        this.hideUi();
+        this.root.remove();
+    };
+    /** Hook for subclasses when the panel is hidden. */
+    AcUiFullscreenPanel.prototype.onHidden = function () {
+        // no-op
+    };
+    AcUiFullscreenPanel.prototype.applyLabels = function (labels) {
+        this.labels = labels;
+        this.titleEl.textContent = labels.title;
+        this.backBtn.setAttribute('aria-label', labels.back);
+    };
+    AcUiFullscreenPanel.prototype.onHistoryPop = function () {
+        this.historyPushed = false;
+        this.detachHistory();
+        this.hideUi();
+    };
+    AcUiFullscreenPanel.prototype.detachHistory = function () {
+        window.removeEventListener('popstate', this.onPopState);
+        this.historyPushed = false;
+    };
+    AcUiFullscreenPanel.prototype.hideUi = function () {
+        if (!this.visible) {
+            this.onHidden();
+            return;
+        }
+        this.visible = false;
+        this.root.hidden = true;
+        this.root.setAttribute('aria-hidden', 'true');
+        document.body.classList.remove('ml-ui-fullscreen-panel-open');
+        this.onHidden();
+    };
+    AcUiFullscreenPanel.injectCss = function () {
+        if (this.stylesInjected)
+            return;
+        if (typeof document === 'undefined')
+            return;
+        this.stylesInjected = true;
+        var style = document.createElement('style');
+        style.id = STYLE_ID;
+        style.textContent = FULLSCREEN_PANEL_CSS;
+        document.head.appendChild(style);
+    };
+    AcUiFullscreenPanel.stylesInjected = false;
+    AcUiFullscreenPanel.nextTitleId = 0;
+    return AcUiFullscreenPanel;
+}());
+export { AcUiFullscreenPanel };
+/** Left-pointing chevron for the back control. */
+function backChevronIcon() {
+    return '<svg viewBox="0 0 24 24" width="22" height="22" aria-hidden="true"><path fill="currentColor" d="M15.41 7.41 14 6l-6 6 6 6 1.41-1.41L10.83 12z"/></svg>';
+}
+var FULLSCREEN_PANEL_CSS = "\n  body.ml-ui-fullscreen-panel-open {\n    overflow: hidden;\n  }\n  .ml-ui-fullscreen-panel {\n    position: fixed;\n    inset: 0;\n    z-index: 10060;\n    display: flex;\n    flex-direction: column;\n    background: var(--ml-ui-bg, var(--mlcad-ui-bg, #1c1e22));\n    color: var(--ml-ui-text, var(--mlcad-ui-text, #e8eaed));\n    font-family: system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n  }\n  .ml-ui-fullscreen-panel[hidden] {\n    display: none !important;\n  }\n  .ml-ui-fullscreen-panel__header {\n    flex: 0 0 auto;\n    display: grid;\n    grid-template-columns: 44px 1fr 44px;\n    align-items: center;\n    column-gap: 4px;\n    min-height: 48px;\n    padding-top: env(safe-area-inset-top, 0px);\n    padding-left: max(4px, env(safe-area-inset-left, 0px));\n    padding-right: max(4px, env(safe-area-inset-right, 0px));\n    border-bottom: 1px solid var(--ml-ui-border, var(--mlcad-ui-border, rgba(255, 255, 255, 0.12)));\n    background: var(--ml-ui-bg-elevated, var(--mlcad-ui-bg-elevated, rgba(28, 30, 34, 0.98)));\n  }\n  .ml-ui-fullscreen-panel__back {\n    box-sizing: border-box;\n    grid-column: 1;\n    justify-self: start;\n    width: 44px;\n    height: 44px;\n    margin: 0;\n    padding: 0;\n    border: 0;\n    border-radius: 50%;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    background: transparent;\n    color: var(--ml-ui-accent, var(--mlcad-accent, #08e8de));\n    cursor: pointer;\n    line-height: 0;\n    -webkit-tap-highlight-color: transparent;\n  }\n  .ml-ui-fullscreen-panel__back:active {\n    background: rgba(255, 255, 255, 0.08);\n  }\n  .ml-ui-fullscreen-panel__back svg {\n    display: block;\n  }\n  .ml-ui-fullscreen-panel__title {\n    grid-column: 2;\n    min-width: 0;\n    font-size: 17px;\n    font-weight: 600;\n    line-height: 1.2;\n    text-align: center;\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n  }\n  .ml-ui-fullscreen-panel__spacer {\n    grid-column: 3;\n    width: 44px;\n    height: 44px;\n    justify-self: end;\n  }\n  .ml-ui-fullscreen-panel__body {\n    flex: 1;\n    min-height: 0;\n    display: flex;\n    flex-direction: column;\n  }\n";
+//# sourceMappingURL=AcUiFullscreenPanel.js.map

package/lib/ui/AcUiFullscreenPanel.js.map

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

package/lib/ui/AcUiHelpPanel.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Full-screen help browser built on {@link AcUiFullscreenPanel}.
+ *
+ * Loads a docs URL in an iframe. Portable (no i18n dependency).
+ */
+import { AcUiFullscreenPanel, type AcUiFullscreenPanelLabels, type AcUiFullscreenPanelOptions } from './AcUiFullscreenPanel';
+/** Localized chrome strings for {@link AcUiHelpPanel}. */
+export type AcUiHelpPanelLabels = AcUiFullscreenPanelLabels;
+/** Options for constructing {@link AcUiHelpPanel}. */
+export type AcUiHelpPanelOptions = AcUiFullscreenPanelOptions;
+/** Options for {@link AcUiHelpPanel.show}. */
+export interface AcUiHelpPanelShowOptions {
+    /** Absolute docs URL loaded in the iframe. */
+    url: string;
+    /** Localized title and back aria-label. */
+    labels: AcUiHelpPanelLabels;
+}
+/**
+ * Mobile full-screen help overlay (nav chrome + docs iframe).
+ */
+export declare class AcUiHelpPanel extends AcUiFullscreenPanel {
+    private readonly frameWrap;
+    private readonly iframe;
+    private readonly loadingEl;
+    private readonly onFrameLoad;
+    private loading;
+    /**
+     * @param options - Optional mount host for the overlay root.
+     */
+    constructor(options?: AcUiHelpPanelOptions);
+    /**
+     * Shows the panel and loads `url`.
+     *
+     * @param options - Docs URL and localized chrome labels.
+     */
+    showDocs(options: AcUiHelpPanelShowOptions): void;
+    /**
+     * Updates chrome labels without changing the open/closed state.
+     *
+     * @param labels - Localized title and back aria-label.
+     */
+    setLabels(labels: AcUiHelpPanelLabels): void;
+    dispose(): void;
+    protected onHidden(): void;
+    private setLoading;
+    private static helpStylesInjected;
+    private static injectHelpCss;
+}
+//# sourceMappingURL=AcUiHelpPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcUiHelpPanel.d.ts","sourceRoot":"","sources":["../../src/ui/AcUiHelpPanel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,uBAAuB,CAAA;AAE9B,0DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAA;AAE3D,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,CAAA;AAE7D,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,OAAO,CAAQ;IAEvB;;OAEG;gBACS,OAAO,GAAE,oBAAyB;IA4B9C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAcjD;;;;OAIG;IACM,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAK5C,OAAO,IAAI,IAAI;cAKL,QAAQ,IAAI,IAAI;IAMnC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAQ;IAEzC,OAAO,CAAC,MAAM,CAAC,aAAa;CA2D7B"}

package/lib/ui/AcUiHelpPanel.js

@@ -0,0 +1,124 @@
+/**
+ * Full-screen help browser built on {@link AcUiFullscreenPanel}.
+ *
+ * Loads a docs URL in an iframe. Portable (no i18n dependency).
+ */
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { AcUiFullscreenPanel } from './AcUiFullscreenPanel';
+/**
+ * Mobile full-screen help overlay (nav chrome + docs iframe).
+ */
+var AcUiHelpPanel = /** @class */ (function (_super) {
+    __extends(AcUiHelpPanel, _super);
+    /**
+     * @param options - Optional mount host for the overlay root.
+     */
+    function AcUiHelpPanel(options) {
+        if (options === void 0) { options = {}; }
+        var _this = _super.call(this, __assign(__assign({}, options), { rootClassName: ['ml-ui-help-panel', options.rootClassName]
+                .filter(Boolean)
+                .join(' ') })) || this;
+        _this.onFrameLoad = function () { return _this.setLoading(false); };
+        _this.loading = false;
+        _this.frameWrap = document.createElement('div');
+        _this.frameWrap.className = 'ml-ui-help-panel__frame-wrap';
+        _this.iframe = document.createElement('iframe');
+        _this.iframe.className = 'ml-ui-help-panel__frame';
+        _this.iframe.title = 'Help';
+        _this.iframe.setAttribute('referrerpolicy', 'no-referrer-when-downgrade');
+        _this.iframe.addEventListener('load', _this.onFrameLoad);
+        _this.loadingEl = document.createElement('div');
+        _this.loadingEl.className = 'ml-ui-help-panel__loading';
+        _this.loadingEl.setAttribute('aria-hidden', 'true');
+        _this.loadingEl.innerHTML =
+            '<div class="ml-ui-help-panel__spinner" aria-hidden="true"></div>';
+        _this.frameWrap.append(_this.iframe, _this.loadingEl);
+        _this.bodyEl.appendChild(_this.frameWrap);
+        AcUiHelpPanel.injectHelpCss();
+        return _this;
+    }
+    /**
+     * Shows the panel and loads `url`.
+     *
+     * @param options - Docs URL and localized chrome labels.
+     */
+    AcUiHelpPanel.prototype.showDocs = function (options) {
+        this.iframe.title = options.labels.title;
+        var nextUrl = options.url;
+        var currentSrc = this.iframe.getAttribute('src');
+        if (currentSrc !== nextUrl) {
+            this.setLoading(true);
+            this.iframe.src = nextUrl;
+        }
+        else if (!this.loading) {
+            // Already showing this document — keep content visible.
+            this.setLoading(false);
+        }
+        this.show(options.labels);
+    };
+    /**
+     * Updates chrome labels without changing the open/closed state.
+     *
+     * @param labels - Localized title and back aria-label.
+     */
+    AcUiHelpPanel.prototype.setLabels = function (labels) {
+        this.iframe.title = labels.title;
+        _super.prototype.setLabels.call(this, labels);
+    };
+    AcUiHelpPanel.prototype.dispose = function () {
+        this.iframe.removeEventListener('load', this.onFrameLoad);
+        _super.prototype.dispose.call(this);
+    };
+    AcUiHelpPanel.prototype.onHidden = function () {
+        this.setLoading(false);
+        // Drop the document so a later open with the same URL still reloads if needed.
+        this.iframe.removeAttribute('src');
+    };
+    AcUiHelpPanel.prototype.setLoading = function (active) {
+        this.loading = active;
+        this.loadingEl.classList.toggle('is-active', active);
+        this.loadingEl.setAttribute('aria-hidden', active ? 'false' : 'true');
+        this.loadingEl.setAttribute('aria-busy', active ? 'true' : 'false');
+        this.rootEl.classList.toggle('is-loading', active);
+    };
+    AcUiHelpPanel.injectHelpCss = function () {
+        if (this.helpStylesInjected)
+            return;
+        if (typeof document === 'undefined')
+            return;
+        this.helpStylesInjected = true;
+        var style = document.createElement('style');
+        style.id = 'ml-ui-help-panel-styles';
+        style.textContent = "\n      .ml-ui-help-panel__frame-wrap {\n        position: relative;\n        flex: 1;\n        min-height: 0;\n        display: flex;\n        flex-direction: column;\n        background: #fff;\n      }\n      .ml-ui-help-panel__frame {\n        flex: 1;\n        width: 100%;\n        min-height: 0;\n        border: 0;\n        background: #fff;\n        opacity: 1;\n        transition: opacity 0.18s ease;\n      }\n      .ml-ui-help-panel.is-loading .ml-ui-help-panel__frame {\n        opacity: 0;\n      }\n      .ml-ui-help-panel__loading {\n        position: absolute;\n        inset: 0;\n        z-index: 1;\n        display: flex;\n        align-items: center;\n        justify-content: center;\n        pointer-events: none;\n        background: var(--ml-ui-bg, var(--mlcad-ui-bg, #1c1e22));\n        opacity: 0;\n        visibility: hidden;\n        transition: opacity 0.18s ease, visibility 0.18s ease;\n      }\n      .ml-ui-help-panel__loading.is-active {\n        opacity: 1;\n        visibility: visible;\n      }\n      .ml-ui-help-panel__spinner {\n        box-sizing: border-box;\n        width: 36px;\n        height: 36px;\n        border-radius: 50%;\n        border: 3px solid rgba(255, 255, 255, 0.18);\n        border-top-color: var(--ml-ui-accent, var(--mlcad-accent, #08e8de));\n        animation: ml-ui-help-panel-spin 0.75s linear infinite;\n      }\n      @keyframes ml-ui-help-panel-spin {\n        to { transform: rotate(360deg); }\n      }\n    ";
+        document.head.appendChild(style);
+    };
+    AcUiHelpPanel.helpStylesInjected = false;
+    return AcUiHelpPanel;
+}(AcUiFullscreenPanel));
+export { AcUiHelpPanel };
+//# sourceMappingURL=AcUiHelpPanel.js.map

package/lib/ui/AcUiHelpPanel.js.map

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

package/lib/ui/AcUiMobileSessionPanel.d.ts

@@ -0,0 +1,239 @@
+/** Keyword / action chip on the mobile session panel. */
+export interface AcUiMobileSessionKeyword {
+    /** Text shown on the chip. */
+    displayName: string;
+    /** Token passed to {@link AcUiMobileSessionPanelCallbacks.onKeyword}. */
+    id: string;
+    /** When false the chip is visible but not tappable. */
+    enabled: boolean;
+}
+/** Formatted metric strings ready to display. */
+export interface AcUiMobileSessionMetricTexts {
+    length: string;
+    angle: string;
+    dx: string;
+    dy: string;
+    x: string;
+    y: string;
+}
+/** Localized chrome strings for the session panel. */
+export interface AcUiMobileSessionPanelLabels {
+    length: string;
+    angle: string;
+    dx: string;
+    dy: string;
+    x: string;
+    y: string;
+    confirm: string;
+    cancel: string;
+    help: string;
+    back: string;
+    collapse: string;
+    expand: string;
+}
+/**
+ * Callbacks for the mobile session panel.
+ *
+ * `onConfirm` is empty-Enter / `allowNone` (panel ✓).
+ */
+export interface AcUiMobileSessionPanelCallbacks {
+    onConfirm: () => void;
+    onCancel: () => void;
+    onKeyword: (id: string) => void;
+}
+/** Session content pushed into {@link AcUiMobileSessionPanel.show}. */
+export interface AcUiMobileSessionPanelState {
+    prompt: string;
+    keywords: AcUiMobileSessionKeyword[];
+    allowNone: boolean;
+    /** When false, the metric row is hidden (actions-only). */
+    showMetrics: boolean;
+    /**
+     * When true, the third row shows a text field instead of X/Y (or relative)
+     * metrics. Confirm commits the typed string via the same ✓ control.
+     */
+    showStringInput?: boolean;
+    /** Initial / current value for {@link showStringInput}. */
+    stringValue?: string;
+    /** Placeholder for the string field. */
+    stringPlaceholder?: string;
+}
+/** Construction options for {@link AcUiMobileSessionPanel}. */
+export interface AcUiMobileSessionPanelOptions {
+    /** View / canvas host that receives the overlay and CSS variables. */
+    host: HTMLElement;
+    /** Class toggled on `host` while the panel is open. */
+    activeClass?: string;
+    /** Phone layout detector (≤600px). */
+    isPhoneLayout: () => boolean;
+    /** Optional layout-change subscription used to re-place ✓/×. */
+    subscribeLayout?: (cb: () => void) => () => void;
+    /** Resolves the magnifier help docs URL for the current locale. */
+    helpDocsUrl: () => string;
+    /** Optional host for the full-screen help panel. */
+    helpHost?: HTMLElement | (() => HTMLElement | null);
+    /** Supplies localized labels (called on show / refreshLabels). */
+    labels: () => AcUiMobileSessionPanelLabels;
+}
+/**
+ * Shared phone/pad session chrome: bottom panel with title bar (session
+ * accessory or prompt + help + collapse), message row (prompt + keyword chips
+ * when an accessory owns the title), live metrics or a string field, and ✓/×.
+ *
+ * Compact (collapsed) mode is a single row:
+ * accessory (if any), command message in leftover space, expand, ✓/×.
+ * Metrics, string field, and keyword chips stay hidden.
+ */
+export declare class AcUiMobileSessionPanel {
+    private readonly host;
+    private readonly activeClass;
+    private readonly isPhoneLayout;
+    private readonly subscribeLayout?;
+    private readonly helpDocsUrl;
+    private readonly helpHostOpt?;
+    private readonly labelsFn;
+    private readonly root;
+    private readonly panel;
+    private readonly accessoryEl;
+    private readonly accessoryContentEl;
+    private readonly helpBtn;
+    private readonly collapseBtn;
+    private readonly promptEl;
+    private readonly promptRow;
+    private readonly compactActions;
+    private readonly titleActions;
+    private readonly chipsEl;
+    private readonly absGroup;
+    private readonly polarGroup;
+    private readonly deltaGroup;
+    private readonly stringGroup;
+    private readonly stringInput;
+    private readonly stringActions;
+    private readonly absStack;
+    private readonly polarStack;
+    private readonly deltaStack;
+    private readonly absActions;
+    private readonly polarActions;
+    private readonly deltaActions;
+    private readonly sharedActions;
+    private readonly cancelBtn;
+    private readonly confirmBtn;
+    private readonly metricButtons;
+    private helpPanel;
+    private callbacks;
+    private open;
+    private collapsed;
+    private showMetrics;
+    private showStringInput;
+    private hasBasePoint;
+    private frozenTexts;
+    private frozenHasBasePoint;
+    private layoutUnsub?;
+    private accessoryObserver?;
+    private compactPromptObserver?;
+    private compactPromptRaf;
+    constructor(options: AcUiMobileSessionPanelOptions);
+    /** Whether the panel is currently shown. */
+    get isOpen(): boolean;
+    /** Whether the panel is in compact (collapsed) mode. */
+    get isCollapsed(): boolean;
+    /** Mount slot for custom session accessories (left of help / collapse). */
+    get accessoryHost(): HTMLElement;
+    /**
+     * Shows the panel for an input session.
+     *
+     * @param state - Prompt, keywords, and metric visibility.
+     * @param callbacks - Confirm / cancel / keyword handlers.
+     */
+    show(state: AcUiMobileSessionPanelState, callbacks: AcUiMobileSessionPanelCallbacks): void;
+    /**
+     * Updates prompt / keywords / ✓ without tearing down the session.
+     *
+     * @param partial - Fields to update; omitted fields keep current values.
+     */
+    update(partial: Partial<AcUiMobileSessionPanelState>): void;
+    /** Current value of the session string field (empty when not in string mode). */
+    getStringValue(): string;
+    /** Focuses the session string field when string input mode is active. */
+    focusStringInput(): void;
+    /**
+     * Sizes the string field from 1 to 3 lines of content. Taller content
+     * scrolls inside a 3-line viewport so the right-hand actions/divider stay
+     * matched to the visible field height.
+     */
+    private syncStringInputHeight;
+    /**
+     * Pushes live metric values (read-only; buttons stay disabled for keypad hook).
+     *
+     * @param hasBasePoint - Whether relative metrics apply.
+     * @param texts - Formatted strings for display.
+     */
+    setMetrics(hasBasePoint: boolean, texts: AcUiMobileSessionMetricTexts): void;
+    /** Expands or collapses the panel into compact mode. */
+    setCollapsed(collapsed: boolean): void;
+    /** Shows the accessory / title row (custom content slot + help + collapse). */
+    prepareAccessory(): void;
+    /** Clears custom accessory content; help / collapse stay while open. */
+    clearAccessory(): void;
+    /**
+     * Hides the panel without clearing accessory widgets.
+     *
+     * Draw-style (and other) session accessories outlive individual prompts —
+     * `endMobilePrompt` / `beginMobilePrompt` pairs between picks must not wipe
+     * them. Ownership stays with the accessory mount lifecycle
+     * ({@link clearAccessory} via the session-accessory controller).
+     */
+    hide(): void;
+    /** Re-applies metric / action aria labels from {@link labels}. */
+    refreshLabels(): void;
+    /** Removes DOM. */
+    dispose(): void;
+    /** True when custom session widgets are mounted in the accessory slot. */
+    private hasAccessoryWidgets;
+    /**
+     * Places the command prompt vs session accessory on the title row.
+     *
+     * Expanded:
+     * - No accessory widgets → title shows the prompt; chips stay on the message
+     *   row (second row) when present.
+     * - With accessory widgets → title always shows the accessory; the message
+     *   row shows the prompt and keyword chips together.
+     *
+     * Compact mode keeps a single row:
+     * `[accessory?] [prompt (remaining space)] [expand] [✓ ×]`.
+     * Keyword chips never appear. The prompt uses leftover space only (ellipsis
+     * on overflow) and is hidden when less than one third of the text fits.
+     */
+    private syncPromptPlacement;
+    /** Defers compact prompt show/hide until after flex layout settles. */
+    private scheduleCompactPromptVisibility;
+    /**
+     * In compact mode the prompt only uses leftover width after accessory,
+     * expand, and ✓/×. Hide it when that width is under one third of the full
+     * message text width (partial text uses CSS ellipsis). When hidden, the
+     * accessory stays left-aligned and expand / ✓/× stay right-aligned.
+     *
+     * Avoids temporarily unhiding the prompt to measure — that would thrash
+     * layout and re-enter via {@link ResizeObserver} every frame.
+     */
+    private syncCompactPromptVisibility;
+    /** Applies compact prompt visibility only when the decision changes. */
+    private applyCompactPromptHidden;
+    /**
+     * Leftover width for the compact prompt. Uses the live flex slot when the
+     * prompt is visible; otherwise infers space from the row minus siblings so
+     * we never flash the prompt back on just to measure.
+     */
+    private measureCompactPromptAvailableWidth;
+    /** Intrinsic single-line width of the current prompt text. */
+    private measurePromptTextWidth;
+    private refreshCollapseLabel;
+    private makeMetricButton;
+    private setMetricTexts;
+    private applyMetricVisibility;
+    private renderChips;
+    private openHelpPanel;
+    private sinkPointer;
+    private static injectCss;
+}
+//# sourceMappingURL=AcUiMobileSessionPanel.d.ts.map