@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/popup/popup-view.jsx

@@ -0,0 +1,67 @@
+import "./popup.css";
+import { useEffect, useRef, useState } from "@lynx-js/react";
+import { startTimer, stopTimer } from "../base/timers.jsx";
+import { useG9Back } from "../host/hooks.jsx";
+import { useG9Window } from "../provider/hooks.jsx";
+import { PopupFrame } from "./frame.jsx";
+function G9PopupView(props) {
+    var _props_options, _o_animationDuration;
+    const o = null != (_props_options = props.options) ? _props_options : {};
+    const win = useG9Window();
+    const duration = 'none' === o.animation ? 0 : null != (_o_animationDuration = o.animationDuration) ? _o_animationDuration : 240;
+    const [phase, setPhase] = useState(props.open ? 'enter' : 'closed');
+    const [generation, setGeneration] = useState(0);
+    const latest = useRef(props);
+    latest.current = props;
+    useEffect(()=>{
+        if (props.open) {
+            setGeneration((g)=>g + 1);
+            setPhase('enter');
+            const t = startTimer(()=>setPhase('open'), 16);
+            return ()=>stopTimer(t);
+        }
+        if ('closed' === phase) return;
+        setPhase('leave');
+        const t = startTimer(()=>{
+            var _latest_current_onClosed, _latest_current;
+            setPhase('closed');
+            null == (_latest_current_onClosed = (_latest_current = latest.current).onClosed) || _latest_current_onClosed.call(_latest_current);
+        }, duration);
+        return ()=>stopTimer(t);
+    }, [
+        props.open
+    ]);
+    useEffect(()=>{
+        var _o_autoCloseDuration;
+        const auto = null != (_o_autoCloseDuration = o.autoCloseDuration) ? _o_autoCloseDuration : 0;
+        if (!props.open || auto <= 0) return;
+        const t = startTimer(()=>{
+            var _latest_current_onOpenChange, _latest_current;
+            return null == (_latest_current_onOpenChange = (_latest_current = latest.current).onOpenChange) ? void 0 : _latest_current_onOpenChange.call(_latest_current, false);
+        }, auto);
+        return ()=>stopTimer(t);
+    }, [
+        props.open,
+        generation
+    ]);
+    useG9Back(()=>{
+        var _latest_current_onOpenChange, _latest_current;
+        if ('none' === o.overlayMode) return false;
+        if (false !== o.closeOnBackButton) null == (_latest_current_onOpenChange = (_latest_current = latest.current).onOpenChange) || _latest_current_onOpenChange.call(_latest_current, false);
+        return true;
+    }, {
+        enabled: props.open,
+        layer: 'popups'
+    });
+    if ('closed' === phase) return null;
+    return <PopupFrame key={generation} options={o} phase={'leave' === phase ? 'leave' : phase} hostWidth={win.width} onBackgroundTap={()=>{
+        var _latest_current_onBackgroundTap, _latest_current, _latest_current_options, _latest_current_onOpenChange, _latest_current1;
+        null == (_latest_current_onBackgroundTap = (_latest_current = latest.current).onBackgroundTap) || _latest_current_onBackgroundTap.call(_latest_current);
+        if (null == (_latest_current_options = latest.current.options) ? void 0 : _latest_current_options.closeOnBackgroundTap) null == (_latest_current_onOpenChange = (_latest_current1 = latest.current).onOpenChange) || _latest_current_onOpenChange.call(_latest_current1, false);
+    }}>
+      {props.children}
+    </PopupFrame>;
+}
+export { G9PopupView };
+
+//# sourceMappingURL=popup-view.jsx.map

package/dist/popup/popup-view.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup/popup-view.jsx","sources":["../../src/popup/popup-view.tsx"],"sourcesContent":["import './popup.css';\nimport { type ReactNode, useEffect, useRef, useState } from '@lynx-js/react';\nimport { startTimer, stopTimer } from '../base/timers';\nimport { useG9Back } from '../host/hooks';\nimport { useG9Window } from '../provider/hooks';\nimport { type G9PopupViewOpenOptions, PopupFrame } from './frame';\n\n/** Props of {@link G9PopupView}. */\nexport interface G9PopupViewProps {\n  /** Shown (MAUI `Open` / `CloseAsync` / `IsOpen`). */\n  readonly open: boolean;\n  /** Asks to close: background tap (with `closeOnBackgroundTap`), hardware back (with `closeOnBackButton`), auto-close. */\n  readonly onOpenChange?: (open: boolean) => void;\n  readonly options?: G9PopupViewOpenOptions;\n  /** The scrim was tapped (MAUI `BackgroundTapped`), whether or not it closes the popup. */\n  readonly onBackgroundTap?: () => void;\n  /** After the close motion (MAUI `Closed`). */\n  readonly onClosed?: () => void;\n  /** The card content (MAUI `Content` / `SetContent`). */\n  readonly children?: ReactNode;\n}\n\n/**\n * A popup card you place yourself (MAUI `G9PopupView` hosted in your own layout): the same scrim, card, motions,\n * placement and drag as the queued popups, but outside the queue: for floating tools (non-modal `overlayMode:\n * 'none'` + `isDraggable` + a `G9PopupDragHandle` header) or a second popup next to the queued one. It fills its\n * parent; put it in a full-size container (or a host layer).\n */\nexport function G9PopupView(props: G9PopupViewProps): ReactNode {\n  const o = props.options ?? {};\n  const win = useG9Window();\n  const duration = o.animation === 'none' ? 0 : (o.animationDuration ?? 240);\n  const [phase, setPhase] = useState<'closed' | 'enter' | 'open' | 'leave'>(props.open ? 'enter' : 'closed');\n  const [generation, setGeneration] = useState(0);\n  const latest = useRef(props);\n  latest.current = props;\n  useEffect(() => {\n    if (props.open) {\n      setGeneration((g) => g + 1);\n      setPhase('enter');\n      const t = startTimer(() => setPhase('open'), 16);\n      return () => stopTimer(t);\n    }\n    if (phase === 'closed') return;\n    setPhase('leave');\n    const t = startTimer(() => {\n      setPhase('closed');\n      latest.current.onClosed?.();\n    }, duration);\n    return () => stopTimer(t);\n  }, [props.open]);\n  useEffect(() => {\n    const auto = o.autoCloseDuration ?? 0;\n    if (!props.open || auto <= 0) return;\n    const t = startTimer(() => latest.current.onOpenChange?.(false), auto);\n    return () => stopTimer(t);\n  }, [props.open, generation]);\n  useG9Back(\n    () => {\n      // A modal popup consumes back (closing it unless `closeOnBackButton: false`); a non-modal one lets it through.\n      if (o.overlayMode === 'none') return false;\n      if (o.closeOnBackButton !== false) latest.current.onOpenChange?.(false);\n      return true;\n    },\n    { enabled: props.open, layer: 'popups' },\n  );\n  if (phase === 'closed') return null;\n  return (\n    <PopupFrame\n      key={generation}\n      options={o}\n      phase={phase === 'leave' ? 'leave' : phase}\n      hostWidth={win.width}\n      onBackgroundTap={() => {\n        latest.current.onBackgroundTap?.();\n        if (latest.current.options?.closeOnBackgroundTap) latest.current.onOpenChange?.(false);\n      }}\n    >\n      {props.children}\n    </PopupFrame>\n  );\n}\n"],"names":["G9PopupView","props","_props_options","_o_animationDuration","o","win","useG9Window","duration","phase","setPhase","useState","generation","setGeneration","latest","useRef","useEffect","g","t","startTimer","stopTimer","_latest_current","_o_autoCloseDuration","auto","useG9Back","PopupFrame","_latest_current_options","_latest_current1"],"mappings":";;;;;;AA4BO,SAASA,YAAYC,KAAuB;QACvCC,gBAEqCC;IAF/C,MAAMC,IAAI,QAAAF,CAAAA,iBAAAA,MAAM,OAAO,AAAD,IAAZA,iBAAiB,CAAC;IAC5B,MAAMG,MAAMC;IACZ,MAAMC,WAAWH,AAAgB,WAAhBA,EAAE,SAAS,GAAc,IAAI,QAACD,CAAAA,uBAAAA,EAAE,iBAAiB,AAAD,IAAlBA,uBAAuB;IACtE,MAAM,CAACK,OAAOC,SAAS,GAAGC,SAAgDT,MAAM,IAAI,GAAG,UAAU;IACjG,MAAM,CAACU,YAAYC,cAAc,GAAGF,SAAS;IAC7C,MAAMG,SAASC,OAAOb;IACtBY,OAAO,OAAO,GAAGZ;IACjBc,UAAU;QACR,IAAId,MAAM,IAAI,EAAE;YACdW,cAAc,CAACI,IAAMA,IAAI;YACzBP,SAAS;YACT,MAAMQ,IAAIC,WAAW,IAAMT,SAAS,SAAS;YAC7C,OAAO,IAAMU,UAAUF;QACzB;QACA,IAAIT,AAAU,aAAVA,OAAoB;QACxBC,SAAS;QACT,MAAMQ,IAAIC,WAAW;gBAEnBE,0BAAAA;YADAX,SAAS;oBACTW,CAAAA,2BAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,QAAQ,AAAD,KAAtBA,yBAAAA,IAAAA,CAAAA;QACF,GAAGb;QACH,OAAO,IAAMY,UAAUF;IACzB,GAAG;QAAChB,MAAM,IAAI;KAAC;IACfc,UAAU;YACKM;QAAb,MAAMC,OAAO,QAAAD,CAAAA,uBAAAA,EAAE,iBAAiB,AAAD,IAAlBA,uBAAuB;QACpC,IAAI,CAACpB,MAAM,IAAI,IAAIqB,QAAQ,GAAG;QAC9B,MAAML,IAAIC,WAAW;gBAAME,8BAAAA;2BAAAA,CAAAA,+BAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,YAAY,AAAD,IAA1BA,KAAAA,IAAAA,6BAAAA,IAAAA,CAAAA,iBAA8B;WAAQE;QACjE,OAAO,IAAMH,UAAUF;IACzB,GAAG;QAAChB,MAAM,IAAI;QAAEU;KAAW;IAC3BY,UACE;YAGqCH,8BAAAA;QADnC,IAAIhB,AAAkB,WAAlBA,EAAE,WAAW,EAAa,OAAO;QACrC,IAAIA,AAAwB,UAAxBA,EAAE,iBAAiB,EAAY,QAAAgB,CAAAA,+BAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,YAAY,AAAD,KAA1BA,6BAAAA,IAAAA,CAAAA,iBAA8B;QACjE,OAAO;IACT,GACA;QAAE,SAASnB,MAAM,IAAI;QAAE,OAAO;IAAS;IAEzC,IAAIO,AAAU,aAAVA,OAAoB,OAAO;IAC/B,QACGgB,WACC,KAAKb,YACL,SAASP,GACT,OAAOI,AAAU,YAAVA,QAAoB,UAAUA,OACrC,WAAWH,IAAI,KAAK,EACpB,iBAAiB;YACfe,iCAAAA,iBACIK,yBAA8CC,8BAAAA;gBADlDN,CAAAA,kCAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,eAAe,AAAD,KAA7BA,gCAAAA,IAAAA,CAAAA;QACA,IAAI,QAAAK,CAAAA,0BAAAA,OAAO,OAAO,CAAC,OAAO,AAAD,IAArBA,KAAAA,IAAAA,wBAAwB,oBAAoB,EAAE,QAAAC,CAAAA,+BAAAA,AAAAA,CAAAA,mBAAAA,OAAO,OAAO,AAAD,EAAE,YAAY,AAAD,KAA1BA,6BAAAA,IAAAA,CAAAA,kBAA8B;IAClF,GACD;MACC,CAACzB,MAAM,QAAQ,CAAC;IAClB,EAAEuB;AAEN"}

package/dist/popup/popup.css

@@ -0,0 +1,203 @@
+.g9-popup {
+  justify-content: center;
+  align-items: center;
+  display: flex;
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-popup--placed {
+  display: block;
+}
+
+.g9-popup__scrim {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-popup__card {
+  border-style: solid;
+  border-width: 1px;
+  flex-direction: column;
+  max-height: 90%;
+  display: flex;
+}
+
+.g9-popup__content {
+  flex-direction: column;
+  display: flex;
+}
+
+.g9-popup__header {
+  flex-direction: row;
+  align-items: center;
+  margin-bottom: 10px;
+  display: flex;
+}
+
+.g9-popup__badge {
+  border-radius: 18px;
+  justify-content: center;
+  align-items: center;
+  width: 36px;
+  height: 36px;
+  margin-right: 10px;
+  display: flex;
+  position: relative;
+}
+
+.g9-dir-rtl .g9-popup__badge {
+  margin-left: 10px;
+  margin-right: 0;
+}
+
+.g9-popup__badge-tint {
+  opacity: .14;
+  border-radius: 18px;
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-popup__title {
+  flex: 1;
+  font-size: 17px;
+  font-weight: 700;
+}
+
+.g9-popup__close {
+  justify-content: center;
+  align-items: center;
+  width: 32px;
+  height: 32px;
+  display: flex;
+}
+
+.g9-popup__message {
+  margin-bottom: 12px;
+  font-size: 15px;
+  line-height: 22px;
+}
+
+.g9-popup__body {
+  margin-bottom: 12px;
+}
+
+.g9-popup__footer {
+  flex-direction: row;
+  align-items: center;
+  margin-top: 4px;
+  display: flex;
+}
+
+.g9-popup__footer--stacked {
+  flex-direction: column;
+  align-items: stretch;
+}
+
+.g9-popup__button {
+  border-radius: 12px;
+  flex-direction: row;
+  flex: 1;
+  justify-content: center;
+  align-items: center;
+  height: 44px;
+  margin-left: 4px;
+  margin-right: 4px;
+  display: flex;
+}
+
+.g9-popup__button--stacked {
+  flex: none;
+  margin: 4px 0;
+}
+
+.g9-popup__button--outline {
+  border-style: solid;
+  border-width: 1.5px;
+  border-color: var(--g9-outline-variant);
+}
+
+.g9-popup__button--busy {
+  opacity: .7;
+}
+
+.g9-popup__button-text {
+  font-size: 15px;
+  font-weight: 700;
+}
+
+.g9-popup-input {
+  flex-direction: column;
+  display: flex;
+}
+
+.g9-popup-input__group {
+  flex-direction: column;
+  margin-bottom: 10px;
+  display: flex;
+}
+
+.g9-popup-input__label {
+  color: var(--g9-text-secondary);
+  margin-bottom: 6px;
+  font-size: 14px;
+}
+
+.g9-popup-input__error {
+  color: var(--g9-error);
+  margin-top: 4px;
+  font-size: 13px;
+}
+
+.g9-popup-input__radio {
+  flex-direction: row;
+  align-items: center;
+  height: 40px;
+  display: flex;
+}
+
+.g9-popup-input__radio-ring {
+  border-style: solid;
+  border-width: 2px;
+  border-color: var(--g9-outline);
+  border-radius: 10px;
+  justify-content: center;
+  align-items: center;
+  width: 20px;
+  height: 20px;
+  margin-right: 10px;
+  display: flex;
+}
+
+.g9-dir-rtl .g9-popup-input__radio-ring {
+  margin-left: 10px;
+  margin-right: 0;
+}
+
+.g9-popup-input__radio--selected .g9-popup-input__radio-ring {
+  border-color: var(--g9-primary);
+}
+
+.g9-popup-input__radio-dot {
+  background-color: var(--g9-primary);
+  border-radius: 5px;
+  width: 10px;
+  height: 10px;
+}
+
+.g9-popup-input__option-text {
+  color: var(--g9-on-surface);
+  font-size: 15px;
+}
+
+
+/*# sourceMappingURL=popup.css.map */

package/dist/popup/popup.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["webpack://./src/popup/popup.css"],"names":[],"mappings":"AAAA;EACE,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;EAClB,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAEA;EACE,cAAc;AAChB;;AAEA;EACE,kBAAkB;EAClB,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAEA;EACE,mBAAmB;EACnB,iBAAiB;EACjB,sBAAsB;EACtB,eAAe;EACf,aAAa;AACf;;AAEA;EACE,sBAAsB;EACtB,aAAa;AACf;;AAEA;EACE,mBAAmB;EACnB,mBAAmB;EACnB,mBAAmB;EACnB,aAAa;AACf;;AAEA;EACE,mBAAmB;EACnB,uBAAuB;EACvB,mBAAmB;EACnB,WAAW;EACX,YAAY;EACZ,kBAAkB;EAClB,aAAa;EACb,kBAAkB;AACpB;;AAEA;EACE,iBAAiB;EACjB,eAAe;AACjB;;AAEA;EACE,YAAY;EACZ,mBAAmB;EACnB,kBAAkB;EAClB,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAEA;EACE,OAAO;EACP,eAAe;EACf,gBAAgB;AAClB;;AAEA;EACE,uBAAuB;EACvB,mBAAmB;EACnB,WAAW;EACX,YAAY;EACZ,aAAa;AACf;;AAEA;EACE,mBAAmB;EACnB,eAAe;EACf,iBAAiB;AACnB;;AAEA;EACE,mBAAmB;AACrB;;AAEA;EACE,mBAAmB;EACnB,mBAAmB;EACnB,eAAe;EACf,aAAa;AACf;;AAEA;EACE,sBAAsB;EACtB,oBAAoB;AACtB;;AAEA;EACE,mBAAmB;EACnB,mBAAmB;EACnB,OAAO;EACP,uBAAuB;EACvB,mBAAmB;EACnB,YAAY;EACZ,gBAAgB;EAChB,iBAAiB;EACjB,aAAa;AACf;;AAEA;EACE,UAAU;EACV,aAAa;AACf;;AAEA;EACE,mBAAmB;EACnB,mBAAmB;EACnB,uCAAuC;AACzC;;AAEA;EACE,WAAW;AACb;;AAEA;EACE,eAAe;EACf,gBAAgB;AAClB;;AAEA;EACE,sBAAsB;EACtB,aAAa;AACf;;AAEA;EACE,sBAAsB;EACtB,mBAAmB;EACnB,aAAa;AACf;;AAEA;EACE,+BAA+B;EAC/B,kBAAkB;EAClB,eAAe;AACjB;;AAEA;EACE,sBAAsB;EACtB,eAAe;EACf,eAAe;AACjB;;AAEA;EACE,mBAAmB;EACnB,mBAAmB;EACnB,YAAY;EACZ,aAAa;AACf;;AAEA;EACE,mBAAmB;EACnB,iBAAiB;EACjB,+BAA+B;EAC/B,mBAAmB;EACnB,uBAAuB;EACvB,mBAAmB;EACnB,WAAW;EACX,YAAY;EACZ,kBAAkB;EAClB,aAAa;AACf;;AAEA;EACE,iBAAiB;EACjB,eAAe;AACjB;;AAEA;EACE,+BAA+B;AACjC;;AAEA;EACE,mCAAmC;EACnC,kBAAkB;EAClB,WAAW;EACX,YAAY;AACd;;AAEA;EACE,2BAA2B;EAC3B,eAAe;AACjB","sourcesContent":[".g9-popup {\n  position: absolute;\n  top: 0px;\n  left: 0px;\n  right: 0px;\n  bottom: 0px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n}\n\n.g9-popup--placed {\n  display: block;\n}\n\n.g9-popup__scrim {\n  position: absolute;\n  top: 0px;\n  left: 0px;\n  right: 0px;\n  bottom: 0px;\n}\n\n.g9-popup__card {\n  display: flex;\n  flex-direction: column;\n  border-width: 1px;\n  border-style: solid;\n  max-height: 90%;\n}\n\n.g9-popup__content {\n  display: flex;\n  flex-direction: column;\n}\n\n.g9-popup__header {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  margin-bottom: 10px;\n}\n\n.g9-popup__badge {\n  width: 36px;\n  height: 36px;\n  border-radius: 18px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  margin-right: 10px;\n  position: relative;\n}\n\n.g9-dir-rtl .g9-popup__badge {\n  margin-right: 0px;\n  margin-left: 10px;\n}\n\n.g9-popup__badge-tint {\n  position: absolute;\n  top: 0px;\n  left: 0px;\n  right: 0px;\n  bottom: 0px;\n  border-radius: 18px;\n  opacity: 0.14;\n}\n\n.g9-popup__title {\n  flex: 1;\n  font-size: 17px;\n  font-weight: 700;\n}\n\n.g9-popup__close {\n  width: 32px;\n  height: 32px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n}\n\n.g9-popup__message {\n  font-size: 15px;\n  line-height: 22px;\n  margin-bottom: 12px;\n}\n\n.g9-popup__body {\n  margin-bottom: 12px;\n}\n\n.g9-popup__footer {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  margin-top: 4px;\n}\n\n.g9-popup__footer--stacked {\n  flex-direction: column;\n  align-items: stretch;\n}\n\n.g9-popup__button {\n  flex: 1;\n  height: 44px;\n  border-radius: 12px;\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  justify-content: center;\n  margin-left: 4px;\n  margin-right: 4px;\n}\n\n.g9-popup__button--stacked {\n  flex: none;\n  margin: 4px 0px;\n}\n\n.g9-popup__button--outline {\n  border-width: 1.5px;\n  border-style: solid;\n  border-color: var(--g9-outline-variant);\n}\n\n.g9-popup__button--busy {\n  opacity: 0.7;\n}\n\n.g9-popup__button-text {\n  font-size: 15px;\n  font-weight: 700;\n}\n\n.g9-popup-input {\n  display: flex;\n  flex-direction: column;\n}\n\n.g9-popup-input__group {\n  display: flex;\n  flex-direction: column;\n  margin-bottom: 10px;\n}\n\n.g9-popup-input__label {\n  font-size: 14px;\n  color: var(--g9-text-secondary);\n  margin-bottom: 6px;\n}\n\n.g9-popup-input__error {\n  font-size: 13px;\n  color: var(--g9-error);\n  margin-top: 4px;\n}\n\n.g9-popup-input__radio {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  height: 40px;\n}\n\n.g9-popup-input__radio-ring {\n  width: 20px;\n  height: 20px;\n  border-radius: 10px;\n  border-width: 2px;\n  border-style: solid;\n  border-color: var(--g9-outline);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  margin-right: 10px;\n}\n\n.g9-dir-rtl .g9-popup-input__radio-ring {\n  margin-right: 0px;\n  margin-left: 10px;\n}\n\n.g9-popup-input__radio--selected .g9-popup-input__radio-ring {\n  border-color: var(--g9-primary);\n}\n\n.g9-popup-input__radio-dot {\n  width: 10px;\n  height: 10px;\n  border-radius: 5px;\n  background-color: var(--g9-primary);\n}\n\n.g9-popup-input__option-text {\n  font-size: 15px;\n  color: var(--g9-on-surface);\n}\n"],"sourceRoot":""}

package/dist/popup/queue.d.ts

@@ -0,0 +1,90 @@
+import type { G9PopupDescriptor, G9PopupResult } from './types.js';
+/** How a popup ended (MAUI: two buttons, background tap, back, auto-close, dismiss/clear, unmount, failure). */
+export type G9PopupExit = 'button' | 'backgroundTap' | 'hardwareBack' | 'autoClose' | 'closeActive' | 'dismissAll' | 'clearQueue' | 'unmount' | 'failure';
+/** What the caller of `show` gets: the result of the button that ended it, or a dismissal. */
+export interface G9PopupOutcome {
+    readonly exit: G9PopupExit;
+    /** The button result (`exit === 'button'`), else a `close` result. */
+    readonly result: G9PopupResult;
+    /** Index of the button that ended it, or -1. */
+    readonly buttonIndex: number;
+}
+/** Where a request is. */
+export type G9PopupPhase = 'queued' | 'opening' | 'open' | 'closing' | 'parked' | 'done';
+/** One popup request (what the view renders while it is the active one). */
+export interface G9PopupEntry {
+    readonly id: number;
+    readonly descriptor: G9PopupDescriptor;
+    readonly phase: G9PopupPhase;
+    /** A footer callback is running (buttons show busy, the gate is shut). */
+    readonly busy: boolean;
+    /** Bumped every time the request is (re)shown: the view keys its open motion on it. */
+    readonly showCount: number;
+}
+/** Timing and reporting of the queue. */
+export interface G9PopupQueueConfig {
+    setTimer(callback: () => void, ms: number): unknown;
+    clearTimer(handle: unknown): void;
+    /** Close motion length for a descriptor (the queue waits it out before the next popup). */
+    closeDurationMs(descriptor: G9PopupDescriptor): number;
+    /** Auto-close delay for a descriptor (0 = none). */
+    autoCloseMs(descriptor: G9PopupDescriptor): number;
+    /** `false` keeps the popup on a hardware back (it still swallows the press). */
+    closesOnBack(descriptor: G9PopupDescriptor): boolean;
+    /** `true` lets a background tap close it. */
+    closesOnBackgroundTap(descriptor: G9PopupDescriptor): boolean;
+    /** A button callback or `afterClose` threw (reported, never escapes). */
+    onError?(error: unknown): void;
+}
+/**
+ * The queue. `show` enqueues and resolves the outcome when the popup ended (exactly once). A popup requested while a
+ * footer callback is running goes to the FRONT and is shown now; the popup whose callback runs is parked (its card
+ * closes, its callback keeps running). When that callback returns, `close`/`showNext` complete it, `doNothing`
+ * puts it back at the front. A callback that throws keeps the popup open and is reported.
+ */
+export declare class G9PopupQueue {
+    private readonly config;
+    private queue;
+    private active;
+    private readonly parked;
+    private userCode;
+    private nextId;
+    private readonly listeners;
+    private snapshot;
+    private closeTimer;
+    private disposed;
+    constructor(config: G9PopupQueueConfig);
+    /** The popup on screen (opening, open or closing), or `null`. */
+    getSnapshot(): G9PopupEntry | null;
+    subscribe(listener: () => void): () => void;
+    /** Requests waiting behind the active popup. */
+    get queuedCount(): number;
+    /** Enqueues a popup; resolves when it ended. */
+    show(descriptor: G9PopupDescriptor): Promise<G9PopupOutcome>;
+    /** The view finished the open motion. */
+    markOpened(id: number): void;
+    /** A footer button was pressed: runs its callback once (one gate per popup), then applies the result. */
+    press(id: number, index: number): Promise<void>;
+    /** The scrim was tapped. */
+    backgroundTap(id: number): void;
+    /** Hardware back: `true` when a popup is on screen (a non-cancelable one swallows the press). */
+    handleBack(): boolean;
+    /** Closes the popup on screen (MAUI `CloseActiveG9PopupAsync`). */
+    closeActive(): void;
+    /** Drops every waiting request (MAUI `ClearG9PopupQueueAsync`); the popup on screen stays. */
+    clearQueue(exit?: G9PopupExit): void;
+    /** Closes the popup on screen, drops the queue and forgets parked popups (MAUI `DismissAllG9PopupsAsync`). */
+    dismissAll(): void;
+    /** The host unmounted: everything settles with `unmount`. */
+    dispose(): void;
+    private pump;
+    private park;
+    private unpark;
+    private close;
+    private complete;
+    private showFront;
+    private clearAuto;
+    private report;
+    private emit;
+}
+//# sourceMappingURL=queue.d.ts.map

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

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