@g9tm/lynxcontrols 0.0.0-stage → 1.4.2

package/dist/popup/queue.jsx

@@ -0,0 +1,309 @@
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+const CLOSE = {
+    action: 'close',
+    nextPopup: null,
+    afterClose: null
+};
+class G9PopupQueue {
+    getSnapshot() {
+        return this.snapshot;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return ()=>this.listeners.delete(listener);
+    }
+    get queuedCount() {
+        return this.queue.length;
+    }
+    show(descriptor) {
+        return new Promise((resolve)=>{
+            const request = {
+                id: this.nextId++,
+                descriptor,
+                phase: 'queued',
+                busy: false,
+                showCount: 0,
+                settled: false,
+                settle: (o)=>{
+                    if (request.settled) return;
+                    request.settled = true;
+                    request.phase = 'done';
+                    resolve(o);
+                },
+                autoTimer: null,
+                controller: {
+                    aborted: false
+                }
+            };
+            if (this.disposed) return void request.settle({
+                exit: 'unmount',
+                result: CLOSE,
+                buttonIndex: -1
+            });
+            if (this.userCode > 0) {
+                var _this_active;
+                this.queue.unshift(request);
+                if (null == (_this_active = this.active) ? void 0 : _this_active.busy) this.park(this.active);
+            } else this.queue.push(request);
+            this.pump();
+        });
+    }
+    markOpened(id) {
+        var _this_active;
+        if ((null == (_this_active = this.active) ? void 0 : _this_active.id) === id && 'opening' === this.active.phase) {
+            this.active.phase = 'open';
+            this.emit();
+        }
+    }
+    async press(id, index) {
+        const request = this.active;
+        if (!request || request.id !== id || request.busy || 'open' !== request.phase && 'opening' !== request.phase) return;
+        const button = request.descriptor.buttons[index];
+        if (!button) return;
+        request.busy = true;
+        this.clearAuto(request);
+        this.emit();
+        let result;
+        this.userCode += 1;
+        try {
+            var _ref;
+            result = button.callback ? null != (_ref = await button.callback(request.controller)) ? _ref : CLOSE : CLOSE;
+        } catch (error) {
+            this.report(error);
+            this.userCode -= 1;
+            request.busy = false;
+            if (this.parked.has(request)) this.unpark(request);
+            else this.emit();
+            return;
+        }
+        this.userCode -= 1;
+        request.busy = false;
+        if ('doNothing' === result.action) {
+            if (this.parked.has(request)) this.unpark(request);
+            else this.emit();
+            return;
+        }
+        const outcome = {
+            exit: 'button',
+            result,
+            buttonIndex: index
+        };
+        if (this.parked.has(request)) {
+            this.parked.delete(request);
+            this.complete(request, outcome);
+            return;
+        }
+        this.close(request, outcome);
+    }
+    backgroundTap(id) {
+        const r = this.active;
+        if (!r || r.id !== id || r.busy || !this.config.closesOnBackgroundTap(r.descriptor)) return;
+        this.close(r, {
+            exit: 'backgroundTap',
+            result: CLOSE,
+            buttonIndex: -1
+        });
+    }
+    handleBack() {
+        const r = this.active;
+        if (!r) return false;
+        if (!r.busy && 'closing' !== r.phase && this.config.closesOnBack(r.descriptor)) this.close(r, {
+            exit: 'hardwareBack',
+            result: CLOSE,
+            buttonIndex: -1
+        });
+        return true;
+    }
+    closeActive() {
+        if (this.active && 'closing' !== this.active.phase) this.close(this.active, {
+            exit: 'closeActive',
+            result: CLOSE,
+            buttonIndex: -1
+        });
+    }
+    clearQueue(exit = 'clearQueue') {
+        const waiting = this.queue;
+        this.queue = [];
+        for (const r of waiting)r.settle({
+            exit,
+            result: CLOSE,
+            buttonIndex: -1
+        });
+    }
+    dismissAll() {
+        this.clearQueue('dismissAll');
+        for (const r of this.parked){
+            r.controller.aborted = true;
+            r.settle({
+                exit: 'dismissAll',
+                result: CLOSE,
+                buttonIndex: -1
+            });
+        }
+        this.parked.clear();
+        if (this.active && 'closing' !== this.active.phase) this.close(this.active, {
+            exit: 'dismissAll',
+            result: CLOSE,
+            buttonIndex: -1
+        });
+    }
+    dispose() {
+        if (this.disposed) return;
+        this.disposed = true;
+        const all = [
+            ...this.queue,
+            ...this.parked,
+            ...this.active ? [
+                this.active
+            ] : []
+        ];
+        this.queue = [];
+        this.parked.clear();
+        this.active = null;
+        if (null !== this.closeTimer) this.config.clearTimer(this.closeTimer);
+        for (const r of all){
+            this.clearAuto(r);
+            r.controller.aborted = true;
+            r.settle({
+                exit: 'unmount',
+                result: CLOSE,
+                buttonIndex: -1
+            });
+        }
+        this.emit();
+    }
+    pump() {
+        if (this.disposed || this.active) return;
+        const next = this.queue.shift();
+        if (!next) return void this.emit();
+        this.active = next;
+        next.phase = 'opening';
+        next.showCount += 1;
+        const auto = this.config.autoCloseMs(next.descriptor);
+        if (auto > 0) next.autoTimer = this.config.setTimer(()=>{
+            next.autoTimer = null;
+            if (this.active === next && !next.busy) this.close(next, {
+                exit: 'autoClose',
+                result: CLOSE,
+                buttonIndex: -1
+            });
+        }, auto);
+        this.emit();
+    }
+    park(request) {
+        this.parked.add(request);
+        request.phase = 'parked';
+        if (this.active === request) this.active = null;
+    }
+    unpark(request) {
+        this.parked.delete(request);
+        request.phase = 'queued';
+        this.queue.unshift(request);
+        this.pump();
+        this.emit();
+    }
+    close(request, outcome) {
+        if ('closing' === request.phase || request.settled) return;
+        this.clearAuto(request);
+        request.phase = 'closing';
+        this.emit();
+        this.closeTimer = this.config.setTimer(()=>{
+            this.closeTimer = null;
+            if (this.active === request) this.active = null;
+            this.complete(request, outcome);
+        }, this.config.closeDurationMs(request.descriptor));
+    }
+    complete(request, outcome) {
+        request.settle(outcome);
+        const result = outcome.result;
+        if ('showNext' === result.action && result.nextPopup) this.showFront(result.nextPopup);
+        if (result.afterClose) {
+            const after = result.afterClose;
+            this.userCode += 1;
+            Promise.resolve().then(after).catch((error)=>this.report(error)).finally(()=>{
+                this.userCode -= 1;
+            });
+        }
+        this.pump();
+    }
+    showFront(descriptor) {
+        return new Promise((resolve)=>{
+            const request = {
+                id: this.nextId++,
+                descriptor,
+                phase: 'queued',
+                busy: false,
+                showCount: 0,
+                settled: false,
+                settle: (o)=>{
+                    if (request.settled) return;
+                    request.settled = true;
+                    request.phase = 'done';
+                    resolve(o);
+                },
+                autoTimer: null,
+                controller: {
+                    aborted: false
+                }
+            };
+            this.queue.unshift(request);
+        });
+    }
+    clearAuto(request) {
+        if (null !== request.autoTimer) {
+            this.config.clearTimer(request.autoTimer);
+            request.autoTimer = null;
+        }
+    }
+    report(error) {
+        try {
+            var _this_config_onError, _this_config;
+            null == (_this_config_onError = (_this_config = this.config).onError) || _this_config_onError.call(_this_config, error);
+        } catch  {}
+    }
+    emit() {
+        const r = this.active;
+        this.snapshot = r ? {
+            id: r.id,
+            descriptor: r.descriptor,
+            phase: r.phase,
+            busy: r.busy,
+            showCount: r.showCount
+        } : null;
+        for (const l of this.listeners)l();
+    }
+    constructor(config){
+        _define_property(this, "config", void 0);
+        _define_property(this, "queue", void 0);
+        _define_property(this, "active", void 0);
+        _define_property(this, "parked", void 0);
+        _define_property(this, "userCode", void 0);
+        _define_property(this, "nextId", void 0);
+        _define_property(this, "listeners", void 0);
+        _define_property(this, "snapshot", void 0);
+        _define_property(this, "closeTimer", void 0);
+        _define_property(this, "disposed", void 0);
+        this.config = config;
+        this.queue = [];
+        this.active = null;
+        this.parked = new Set();
+        this.userCode = 0;
+        this.nextId = 1;
+        this.listeners = new Set();
+        this.snapshot = null;
+        this.closeTimer = null;
+        this.disposed = false;
+    }
+}
+export { G9PopupQueue };
+
+//# sourceMappingURL=queue.jsx.map

package/dist/popup/queue.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup/queue.jsx","sources":["../../src/popup/queue.ts"],"sourcesContent":["import type { G9PopupDescriptor, G9PopupResult } from './types';\n\n// The popup queue (MAUI `G9PopupHelper` pump) as a pure model: one card at a time, FIFO, button callbacks that run\n// once, nested popups that preempt a running callback, and an outcome that settles once for every way a popup ends.\n// The view renders `getSnapshot()`; timers come from the caller so tests drive time.\n\n/** How a popup ended (MAUI: two buttons, background tap, back, auto-close, dismiss/clear, unmount, failure). */\nexport type G9PopupExit =\n  | 'button'\n  | 'backgroundTap'\n  | 'hardwareBack'\n  | 'autoClose'\n  | 'closeActive'\n  | 'dismissAll'\n  | 'clearQueue'\n  | 'unmount'\n  | 'failure';\n\n/** What the caller of `show` gets: the result of the button that ended it, or a dismissal. */\nexport interface G9PopupOutcome {\n  readonly exit: G9PopupExit;\n  /** The button result (`exit === 'button'`), else a `close` result. */\n  readonly result: G9PopupResult;\n  /** Index of the button that ended it, or -1. */\n  readonly buttonIndex: number;\n}\n\n/** Where a request is. */\nexport type G9PopupPhase = 'queued' | 'opening' | 'open' | 'closing' | 'parked' | 'done';\n\n/** One popup request (what the view renders while it is the active one). */\nexport interface G9PopupEntry {\n  readonly id: number;\n  readonly descriptor: G9PopupDescriptor;\n  readonly phase: G9PopupPhase;\n  /** A footer callback is running (buttons show busy, the gate is shut). */\n  readonly busy: boolean;\n  /** Bumped every time the request is (re)shown: the view keys its open motion on it. */\n  readonly showCount: number;\n}\n\n/** Timing and reporting of the queue. */\nexport interface G9PopupQueueConfig {\n  setTimer(callback: () => void, ms: number): unknown;\n  clearTimer(handle: unknown): void;\n  /** Close motion length for a descriptor (the queue waits it out before the next popup). */\n  closeDurationMs(descriptor: G9PopupDescriptor): number;\n  /** Auto-close delay for a descriptor (0 = none). */\n  autoCloseMs(descriptor: G9PopupDescriptor): number;\n  /** `false` keeps the popup on a hardware back (it still swallows the press). */\n  closesOnBack(descriptor: G9PopupDescriptor): boolean;\n  /** `true` lets a background tap close it. */\n  closesOnBackgroundTap(descriptor: G9PopupDescriptor): boolean;\n  /** A button callback or `afterClose` threw (reported, never escapes). */\n  onError?(error: unknown): void;\n}\n\ninterface Request {\n  id: number;\n  descriptor: G9PopupDescriptor;\n  phase: G9PopupPhase;\n  busy: boolean;\n  showCount: number;\n  settle: (outcome: G9PopupOutcome) => void;\n  settled: boolean;\n  autoTimer: unknown;\n  controller: { aborted: boolean };\n}\n\nconst CLOSE: G9PopupResult = { action: 'close', nextPopup: null, afterClose: null };\n\n/**\n * The queue. `show` enqueues and resolves the outcome when the popup ended (exactly once). A popup requested while a\n * footer callback is running goes to the FRONT and is shown now; the popup whose callback runs is parked (its card\n * closes, its callback keeps running). When that callback returns, `close`/`showNext` complete it, `doNothing`\n * puts it back at the front. A callback that throws keeps the popup open and is reported.\n */\nexport class G9PopupQueue {\n  private queue: Request[] = [];\n  private active: Request | null = null;\n  private readonly parked = new Set<Request>();\n  private userCode = 0;\n  private nextId = 1;\n  private readonly listeners = new Set<() => void>();\n  private snapshot: G9PopupEntry | null = null;\n  private closeTimer: unknown = null;\n  private disposed = false;\n\n  constructor(private readonly config: G9PopupQueueConfig) {}\n\n  /** The popup on screen (opening, open or closing), or `null`. */\n  getSnapshot(): G9PopupEntry | null {\n    return this.snapshot;\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /** Requests waiting behind the active popup. */\n  get queuedCount(): number {\n    return this.queue.length;\n  }\n\n  /** Enqueues a popup; resolves when it ended. */\n  show(descriptor: G9PopupDescriptor): Promise<G9PopupOutcome> {\n    return new Promise((resolve) => {\n      const request: Request = {\n        id: this.nextId++,\n        descriptor,\n        phase: 'queued',\n        busy: false,\n        showCount: 0,\n        settled: false,\n        settle: (o) => {\n          if (request.settled) return;\n          request.settled = true;\n          request.phase = 'done';\n          resolve(o);\n        },\n        autoTimer: null,\n        controller: { aborted: false },\n      };\n      if (this.disposed) {\n        request.settle({ exit: 'unmount', result: CLOSE, buttonIndex: -1 });\n        return;\n      }\n      if (this.userCode > 0) {\n        // Nested: preempt the popup whose callback is running.\n        this.queue.unshift(request);\n        if (this.active?.busy) this.park(this.active);\n      } else {\n        this.queue.push(request);\n      }\n      this.pump();\n    });\n  }\n\n  /** The view finished the open motion. */\n  markOpened(id: number): void {\n    if (this.active?.id === id && this.active.phase === 'opening') {\n      this.active.phase = 'open';\n      this.emit();\n    }\n  }\n\n  /** A footer button was pressed: runs its callback once (one gate per popup), then applies the result. */\n  async press(id: number, index: number): Promise<void> {\n    const request = this.active;\n    if (!request || request.id !== id || request.busy || (request.phase !== 'open' && request.phase !== 'opening')) {\n      return;\n    }\n    const button = request.descriptor.buttons[index];\n    if (!button) return;\n    request.busy = true;\n    this.clearAuto(request);\n    this.emit();\n    let result: G9PopupResult;\n    this.userCode += 1;\n    try {\n      result = button.callback ? ((await button.callback(request.controller)) ?? CLOSE) : CLOSE;\n    } catch (error) {\n      this.report(error);\n      this.userCode -= 1;\n      request.busy = false;\n      if (this.parked.has(request)) this.unpark(request);\n      else this.emit();\n      return;\n    }\n    this.userCode -= 1;\n    request.busy = false;\n    if (result.action === 'doNothing') {\n      if (this.parked.has(request)) this.unpark(request);\n      else this.emit();\n      return;\n    }\n    const outcome: G9PopupOutcome = { exit: 'button', result, buttonIndex: index };\n    if (this.parked.has(request)) {\n      this.parked.delete(request);\n      this.complete(request, outcome);\n      return;\n    }\n    this.close(request, outcome);\n  }\n\n  /** The scrim was tapped. */\n  backgroundTap(id: number): void {\n    const r = this.active;\n    if (!r || r.id !== id || r.busy || !this.config.closesOnBackgroundTap(r.descriptor)) return;\n    this.close(r, { exit: 'backgroundTap', result: CLOSE, buttonIndex: -1 });\n  }\n\n  /** Hardware back: `true` when a popup is on screen (a non-cancelable one swallows the press). */\n  handleBack(): boolean {\n    const r = this.active;\n    if (!r) return false;\n    if (!r.busy && r.phase !== 'closing' && this.config.closesOnBack(r.descriptor)) {\n      this.close(r, { exit: 'hardwareBack', result: CLOSE, buttonIndex: -1 });\n    }\n    return true;\n  }\n\n  /** Closes the popup on screen (MAUI `CloseActiveG9PopupAsync`). */\n  closeActive(): void {\n    if (this.active && this.active.phase !== 'closing') {\n      this.close(this.active, { exit: 'closeActive', result: CLOSE, buttonIndex: -1 });\n    }\n  }\n\n  /** Drops every waiting request (MAUI `ClearG9PopupQueueAsync`); the popup on screen stays. */\n  clearQueue(exit: G9PopupExit = 'clearQueue'): void {\n    const waiting = this.queue;\n    this.queue = [];\n    for (const r of waiting) r.settle({ exit, result: CLOSE, buttonIndex: -1 });\n  }\n\n  /** Closes the popup on screen, drops the queue and forgets parked popups (MAUI `DismissAllG9PopupsAsync`). */\n  dismissAll(): void {\n    this.clearQueue('dismissAll');\n    for (const r of this.parked) {\n      r.controller.aborted = true;\n      r.settle({ exit: 'dismissAll', result: CLOSE, buttonIndex: -1 });\n    }\n    this.parked.clear();\n    if (this.active && this.active.phase !== 'closing') {\n      this.close(this.active, { exit: 'dismissAll', result: CLOSE, buttonIndex: -1 });\n    }\n  }\n\n  /** The host unmounted: everything settles with `unmount`. */\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    const all = [...this.queue, ...this.parked, ...(this.active ? [this.active] : [])];\n    this.queue = [];\n    this.parked.clear();\n    this.active = null;\n    if (this.closeTimer !== null) this.config.clearTimer(this.closeTimer);\n    for (const r of all) {\n      this.clearAuto(r);\n      r.controller.aborted = true;\n      r.settle({ exit: 'unmount', result: CLOSE, buttonIndex: -1 });\n    }\n    this.emit();\n  }\n\n  private pump(): void {\n    if (this.disposed || this.active) return;\n    const next = this.queue.shift();\n    if (!next) {\n      this.emit();\n      return;\n    }\n    this.active = next;\n    next.phase = 'opening';\n    next.showCount += 1;\n    const auto = this.config.autoCloseMs(next.descriptor);\n    if (auto > 0) {\n      next.autoTimer = this.config.setTimer(() => {\n        next.autoTimer = null;\n        if (this.active === next && !next.busy) this.close(next, { exit: 'autoClose', result: CLOSE, buttonIndex: -1 });\n      }, auto);\n    }\n    this.emit();\n  }\n\n  private park(request: Request): void {\n    this.parked.add(request);\n    request.phase = 'parked';\n    if (this.active === request) this.active = null;\n    // The parked card leaves at once (one card at a time); the nested popup takes the slot.\n  }\n\n  private unpark(request: Request): void {\n    this.parked.delete(request);\n    request.phase = 'queued';\n    this.queue.unshift(request);\n    this.pump();\n    this.emit();\n  }\n\n  private close(request: Request, outcome: G9PopupOutcome): void {\n    if (request.phase === 'closing' || request.settled) return;\n    this.clearAuto(request);\n    request.phase = 'closing';\n    this.emit();\n    this.closeTimer = this.config.setTimer(() => {\n      this.closeTimer = null;\n      if (this.active === request) this.active = null;\n      this.complete(request, outcome);\n    }, this.config.closeDurationMs(request.descriptor));\n  }\n\n  private complete(request: Request, outcome: G9PopupOutcome): void {\n    request.settle(outcome);\n    const result = outcome.result;\n    if (result.action === 'showNext' && result.nextPopup) {\n      // The next popup takes the front of the queue (it must not wait behind unrelated requests).\n      void this.showFront(result.nextPopup);\n    }\n    if (result.afterClose) {\n      const after = result.afterClose;\n      this.userCode += 1;\n      Promise.resolve()\n        .then(after)\n        .catch((error: unknown) => this.report(error))\n        .finally(() => {\n          this.userCode -= 1;\n        });\n    }\n    this.pump();\n  }\n\n  private showFront(descriptor: G9PopupDescriptor): Promise<G9PopupOutcome> {\n    return new Promise((resolve) => {\n      const request: Request = {\n        id: this.nextId++,\n        descriptor,\n        phase: 'queued',\n        busy: false,\n        showCount: 0,\n        settled: false,\n        settle: (o) => {\n          if (request.settled) return;\n          request.settled = true;\n          request.phase = 'done';\n          resolve(o);\n        },\n        autoTimer: null,\n        controller: { aborted: false },\n      };\n      this.queue.unshift(request);\n    });\n  }\n\n  private clearAuto(request: Request): void {\n    if (request.autoTimer !== null) {\n      this.config.clearTimer(request.autoTimer);\n      request.autoTimer = null;\n    }\n  }\n\n  private report(error: unknown): void {\n    try {\n      this.config.onError?.(error);\n    } catch {\n      // Reporting must never escape the queue.\n    }\n  }\n\n  private emit(): void {\n    const r = this.active;\n    this.snapshot = r\n      ? { id: r.id, descriptor: r.descriptor, phase: r.phase, busy: r.busy, showCount: r.showCount }\n      : null;\n    for (const l of this.listeners) l();\n  }\n}\n"],"names":["CLOSE","G9PopupQueue","listener","descriptor","Promise","resolve","request","o","_this_active","id","index","button","result","_ref","error","outcome","r","exit","waiting","all","next","auto","after","_this_config","l","config","Set"],"mappings":"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"}

package/dist/popup/service.d.ts

@@ -0,0 +1,60 @@
+import './popup.css';
+import { type G9ErrorPopupRequest } from '@g9tm/lynxcontrols-foundation';
+import { type ReactNode } from '@lynx-js/react';
+import { type G9HostHandle } from '../host/registry.js';
+import { type G9PopupInputOptions, type G9PopupInputResult } from './input.js';
+import { type G9PopupOutcome, G9PopupQueue } from './queue.js';
+import { type G9PopupAnimationType, type G9PopupButton, type G9PopupDescriptor, type G9PopupResult, type G9PopupSettings, type G9PopupType } from './types.js';
+/** Most buttons a `row` footer shows (MAUI); more are dropped with a warning. */
+export declare const g9PopupRowButtonLimit = 3;
+/** Options of `showConfirm` (MAUI `ShowConfirmAsync`). */
+export interface G9ConfirmOptions {
+    readonly title?: string | null;
+    readonly okCallback?: ((context: {
+        readonly aborted: boolean;
+    }) => unknown) | null;
+    readonly cancelCallback?: ((context: {
+        readonly aborted: boolean;
+    }) => unknown) | null;
+    /** Default `'information'`; `'warning'` for a lossy confirm (sign out, discard). */
+    readonly type?: G9PopupType;
+    readonly okText?: string;
+    readonly cancelText?: string;
+}
+/** The popups of a host (MAUI `G9PopupHelper`). */
+export interface G9PopupService {
+    /** Information popup (MAUI `ShowG9PopupAsync`); resolves the result of the button that closed it. */
+    show(message: string, title?: string | null, buttons?: ReadonlyArray<G9PopupButton> | null, settings?: G9PopupSettings | null, animation?: G9PopupAnimationType | null): Promise<G9PopupResult>;
+    showSuccess(message: string, title?: string | null, buttons?: ReadonlyArray<G9PopupButton> | null, settings?: G9PopupSettings | null, animation?: G9PopupAnimationType | null): Promise<G9PopupResult>;
+    showWarning(message: string, title?: string | null, buttons?: ReadonlyArray<G9PopupButton> | null, settings?: G9PopupSettings | null, animation?: G9PopupAnimationType | null): Promise<G9PopupResult>;
+    showError(message: string, title?: string | null, buttons?: ReadonlyArray<G9PopupButton> | null, settings?: G9PopupSettings | null, animation?: G9PopupAnimationType | null): Promise<G9PopupResult>;
+    /** Any content in the body (MAUI `ShowCustomG9PopupAsync`). */
+    showCustom(content: ReactNode | (() => ReactNode), title?: string | null, buttons?: ReadonlyArray<G9PopupButton> | null, settings?: G9PopupSettings | null, animation?: G9PopupAnimationType | null): Promise<G9PopupResult>;
+    /** Any descriptor; resolves how it ended. */
+    showDescriptor(descriptor: G9PopupDescriptor): Promise<G9PopupOutcome>;
+    /** A validated form (MAUI `ShowInputG9PopupAsync`). */
+    showInput(options: G9PopupInputOptions): Promise<G9PopupInputResult>;
+    /** OK/Cancel: `true` only for OK; every other exit is `false` (MAUI `ShowConfirmAsync`). */
+    showConfirm(message: string, options?: G9ConfirmOptions): Promise<boolean>;
+    /** Hardware back: `true` when a popup is on screen (closed unless `closeOnBackButton: false`). */
+    handleHardwareBack(): boolean;
+    /** Closes the popup on screen. */
+    closeActive(): void;
+    /** Drops waiting popups; the one on screen stays. */
+    clearQueue(): void;
+    /** Closes everything. */
+    dismissAll(): void;
+    readonly queue: G9PopupQueue;
+}
+/** The popup service of a host (created once as a host feature). */
+export declare function popupServiceOf(host: G9HostHandle): G9PopupService;
+/** The popups of the nearest `G9Host` (MAUI `G9PopupHelper`): one card at a time, FIFO, in the `popups` layer. */
+export declare function useG9Popups(): G9PopupService;
+/** The popups of the active host, for code outside components. Throws `host-missing` without a host. */
+export declare function g9Popups(): G9PopupService;
+/**
+ * The default error presenter (installed when this module loads): the executor's error popup as an error-type popup
+ * on the active host, with More details when diagnostics are available. Without a host it does nothing.
+ */
+export declare function presentErrorPopup(request: G9ErrorPopupRequest): Promise<void> | undefined;
+//# sourceMappingURL=service.d.ts.map

package/dist/popup/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/popup/service.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AACrB,OAAO,EAAgC,KAAK,mBAAmB,EAAe,MAAM,+BAA+B,CAAC;AACpH,OAAO,EAAE,KAAK,SAAS,EAAqD,MAAM,gBAAgB,CAAC;AAMnG,OAAO,EAAE,KAAK,YAAY,EAAW,MAAM,kBAAkB,CAAC;AAK9D,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAsB,MAAM,SAAS,CAAC;AAEhG,OAAO,EAAqB,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,WAAW,EAKjB,MAAM,SAAS,CAAC;AAEjB,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IACnF,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;IACvF,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,EAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,WAAW,CACT,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,EAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,WAAW,CACT,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,EAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,SAAS,CACP,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,EAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,+DAA+D;IAC/D,UAAU,CACR,OAAO,EAAE,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,EACtC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,EAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,EACjC,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,6CAA6C;IAC7C,cAAc,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvE,uDAAuD;IACvD,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrE,4FAA4F;IAC5F,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,kGAAkG;IAClG,kBAAkB,IAAI,OAAO,CAAC;IAC9B,kCAAkC;IAClC,WAAW,IAAI,IAAI,CAAC;IACpB,qDAAqD;IACrD,UAAU,IAAI,IAAI,CAAC;IACnB,yBAAyB;IACzB,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAgVD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAGjE;AAED,kHAAkH;AAClH,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED,wGAAwG;AACxG,wBAAgB,QAAQ,IAAI,cAAc,CAEzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAWzF"}