@zeyos/zx 4.2.0 → 4.3.4

package/src/components/launcher/launcher.css

@@ -3,10 +3,12 @@
   max-block-size: min(720px, calc(100vh - (2 * var(--zx-space-6))));
   border: 1px solid var(--zx-color-overlay-border);
   border-radius: var(--zx-radius-xl);
-  background: var(--zx-color-overlay-panel);
+  background-color: var(--zx-color-overlay-panel);
+  background-image: var(--zx-overlay-panel-image);
+  background-clip: padding-box;
   -webkit-backdrop-filter: var(--zx-glass-filter-panel);
   backdrop-filter: var(--zx-glass-filter-panel);
-  box-shadow: var(--zx-glass-raised-shadow);
+  box-shadow: var(--zx-glass-panel-shadow);
   color: var(--zx-color-text);
   padding: 0;
 }
@@ -22,7 +24,7 @@
 }
 
 .zx-launcher::backdrop {
-  background: var(--zx-color-bg-backdrop);
+  background: var(--zx-color-overlay-backdrop);
 }
 
 .zx-launcher__surface {
@@ -36,7 +38,7 @@
   grid-template-columns: auto minmax(0, 1fr) auto auto;
   align-items: center;
   gap: var(--zx-space-3);
-  border-block-end: 1px solid var(--zx-color-border);
+  border-block-end: 1px solid var(--zx-color-overlay-divider);
   padding: var(--zx-space-3) var(--zx-space-4);
 }
 
@@ -129,11 +131,11 @@
 
 .zx-launcher__option[aria-selected="true"],
 .zx-launcher__option:hover {
-  background: var(--zx-color-bg-hover);
+  background: var(--zx-color-overlay-hover);
 }
 
 .zx-launcher__option[aria-current="page"] {
-  background: var(--zx-color-bg-selected);
+  background: var(--zx-color-overlay-selected);
   color: var(--zx-color-accent);
 }
 
@@ -148,7 +150,7 @@
 }
 
 .zx-launcher__option[data-kind="application"][aria-current="page"] {
-  background: var(--zx-color-bg-selected);
+  background: var(--zx-color-overlay-selected);
 }
 
 .zx-launcher__option[data-kind="application"] .zx-launcher__icon {
@@ -187,7 +189,7 @@
   justify-content: end;
   gap: var(--zx-space-4);
   padding: var(--zx-space-2) var(--zx-space-4);
-  border-block-start: 1px solid var(--zx-color-border);
+  border-block-start: 1px solid var(--zx-color-overlay-divider);
   color: var(--zx-color-text-muted);
   font-size: var(--zx-text-xs);
 }

package/src/components/launcher/launcher.js

@@ -1,6 +1,7 @@
 import { Component } from '../../core/component.js';
 import { h, safeHref } from '../../core/dom.js';
 import { icon } from '../../core/icons.js';
+import { overlayHost } from '../../core/overlay-host.js';
 import { uid } from '../../core/util.js';
 
 /**
@@ -49,6 +50,7 @@ import { uid } from '../../core/util.js';
  * @property {string} [loadingText='Searching…'] Loading-state text.
  * @property {'mod+k'|false} [shortcut='mod+k'] Optional global keyboard shortcut.
  * @property {false|{move?: string, open?: string, close?: string}} [hints] Visible keyboard hints, or false.
+ * @property {Element|string|null} [scope=null] Element whose nearest Zx theme scope owns an internally created launcher; defaults to the opener.
  * @property {(event: CustomEvent<LauncherSelectDetail>) => void} [onselect] Preventable selection listener.
  * @property {(event: CustomEvent<{query: string}>) => void} [onquery] Query-change listener.
  * @property {(event: CustomEvent<Record<string, never>>) => void} [onopen] Open listener.
@@ -85,7 +87,8 @@ export class Launcher extends Component {
     emptyText: 'No results',
     loadingText: 'Searching…',
     shortcut: 'mod+k',
-    hints: { move: 'Move', open: 'Open', close: 'Close' }
+    hints: { move: 'Move', open: 'Open', close: 'Close' },
+    scope: null
   };
 
   /**
@@ -172,7 +175,7 @@ export class Launcher extends Component {
       results,
       footer));
     dialog.dataset.state = 'closed';
-    if (this._createdRoot) document.body.append(dialog);
+    if (this._createdRoot) overlayHost(this.options.scope).append(dialog);
 
     this.listen(input, 'input', () => {
       this._query = /** @type {HTMLInputElement} */ (input).value;
@@ -212,6 +215,10 @@ export class Launcher extends Component {
   /** Opens the launcher and focuses/selects its query. @returns {this} @fires Launcher#open */
   open() {
     if (this.isOpen() || this._destroyed) return this;
+    if (this._createdRoot) {
+      const host = overlayHost(this.options.scope);
+      if (this.el.parentElement !== host) host.append(this.el);
+    }
     this.el.showModal();
     this.el.dataset.state = 'open';
     this.refs.input.setAttribute('aria-expanded', 'true');

package/src/components/menu-button/menu-button.css

@@ -24,7 +24,7 @@
 
 .zx-menu-button__item:hover,
 .zx-menu-button__item:focus-visible {
-  background: var(--zx-color-bg-hover);
+  background: var(--zx-color-overlay-hover);
 }
 
 .zx-menu-button__item[data-danger="true"] {
@@ -45,5 +45,5 @@
 .zx-menu-button__separator {
   block-size: 1px;
   margin: var(--zx-space-1) var(--zx-space-2);
-  background: var(--zx-color-border);
+  background: var(--zx-color-overlay-divider);
 }

package/src/components/message/message.css

@@ -27,14 +27,15 @@
 
 .zx-message__toast {
   --zx-message-kind: var(--zx-color-info);
+  --zx-message-fallback-bg: var(--zx-color-info-bg);
   position: relative;
   display: grid;
   grid-template-columns: auto minmax(0, 1fr) auto;
   align-items: start;
   gap: var(--zx-space-3);
   border: 1px solid var(--zx-color-overlay-border);
-  border-radius: var(--zx-radius-md);
-  background: var(--zx-color-info-bg);
+  border-radius: var(--zx-radius-lg);
+  background: var(--zx-message-fallback-bg);
   box-shadow: inset 0 0 0 1px var(--zx-message-kind), var(--zx-glass-raised-shadow);
   padding: var(--zx-space-3);
   color: var(--zx-color-text);
@@ -42,51 +43,40 @@
 
 .zx-message__toast[data-kind="success"] {
   --zx-message-kind: var(--zx-color-success);
-  background: var(--zx-color-success-bg);
+  --zx-message-fallback-bg: var(--zx-color-success-bg);
 }
 
 .zx-message__toast[data-kind="warning"] {
   --zx-message-kind: var(--zx-color-warning);
-  background: var(--zx-color-warning-bg);
+  --zx-message-fallback-bg: var(--zx-color-warning-bg);
 }
 
 .zx-message__toast[data-kind="error"] {
   --zx-message-kind: var(--zx-color-danger);
-  background: var(--zx-color-danger-bg);
+  --zx-message-fallback-bg: var(--zx-color-danger-bg);
 }
 
-@supports (backdrop-filter: blur(1px)) {
+@supports ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
   .zx-message__toast {
-    background: color-mix(in srgb, var(--zx-color-info-bg) 34%, var(--zx-color-overlay-surface));
+    border-color: color-mix(in srgb, var(--zx-message-kind) 28%, var(--zx-color-overlay-border));
+    background-color: var(--zx-color-overlay-surface);
+    background-image: var(--zx-overlay-toast-image);
+    background-clip: padding-box;
     -webkit-backdrop-filter: var(--zx-glass-filter-overlay);
     backdrop-filter: var(--zx-glass-filter-overlay);
-    box-shadow: inset 0 0 0 1px var(--zx-message-kind), var(--zx-glass-raised-shadow);
-  }
-
-  .zx-message__toast[data-kind="success"] {
-    background: color-mix(in srgb, var(--zx-color-success-bg) 34%, var(--zx-color-overlay-surface));
-  }
-
-  .zx-message__toast[data-kind="warning"] {
-    background: color-mix(in srgb, var(--zx-color-warning-bg) 34%, var(--zx-color-overlay-surface));
-  }
-
-  .zx-message__toast[data-kind="error"] {
-    background: color-mix(in srgb, var(--zx-color-danger-bg) 34%, var(--zx-color-overlay-surface));
+    box-shadow: inset 3px 0 0 color-mix(in srgb, var(--zx-message-kind) 72%,
+      var(--zx-color-glass-highlight-strong)), var(--zx-glass-overlay-shadow);
   }
 }
 
 @media (prefers-reduced-transparency: reduce) {
   .zx-message__toast {
     border-color: var(--zx-color-border);
+    background: var(--zx-message-fallback-bg);
     -webkit-backdrop-filter: none;
     backdrop-filter: none;
     box-shadow: var(--zx-overlay-shadow);
   }
-  .zx-message__toast[data-kind="info"] { background: var(--zx-color-info-bg); }
-  .zx-message__toast[data-kind="success"] { background: var(--zx-color-success-bg); }
-  .zx-message__toast[data-kind="warning"] { background: var(--zx-color-warning-bg); }
-  .zx-message__toast[data-kind="error"] { background: var(--zx-color-danger-bg); }
 }
 
 .zx-message__icon {
@@ -111,7 +101,7 @@
   block-size: 4px;
   margin-block-start: var(--zx-space-2);
   border-radius: var(--zx-radius-full);
-  background: var(--zx-color-border);
+  background: var(--zx-color-overlay-divider);
 }
 
 .zx-message__progress-fill {

package/src/components/message/message.js

@@ -1,6 +1,7 @@
 import { Component } from '../../core/component.js';
 import { h } from '../../core/dom.js';
 import { icon } from '../../core/icons.js';
+import { overlayHost } from '../../core/overlay-host.js';
 
 /** @typedef {'info'|'success'|'warning'|'error'} MessageKind */
 
@@ -9,6 +10,7 @@ import { icon } from '../../core/icons.js';
  * @property {MessageKind|'danger'} [kind='info'] Message intent (`danger` aliases `error`).
  * @property {number} [timeout=4000] Auto-dismiss delay in milliseconds; zero persists.
  * @property {boolean} [closable=true] Whether to render a close button.
+ * @property {Element|string|null} [scope=null] Element whose nearest Zx theme scope owns a floating toast.
  */
 
 /**
@@ -133,8 +135,8 @@ export class Message extends Component {
     maxVisible: 5
   };
 
-  /** @type {Message|null} */
-  static #floating = null;
+  /** @type {WeakMap<Element, Message>} */
+  static #floating = new WeakMap();
 
   /** @returns {HTMLElement} */
   render() {
@@ -217,16 +219,17 @@ export class Message extends Component {
    * @returns {MessageHandle}
    */
   static show(msg, options = {}) {
-    return this.#floatingRegion().show(msg, options);
+    return this.#floatingRegion(options.scope).show(msg, options);
   }
 
   /**
    * Shows a floating progress status.
    * @param {string} text Initial status text.
+   * @param {{scope?: Element|string|null}} [options={}] Floating-region scope.
    * @returns {ProgressHandle}
    */
-  static progress(text) {
-    return this.#floatingRegion()._progress(text);
+  static progress(text, options = {}) {
+    return this.#floatingRegion(options.scope)._progress(text);
   }
 
   /** @returns {void} */
@@ -414,19 +417,22 @@ export class Message extends Component {
     this._queue.remove(entry);
   }
 
-  /** @returns {Message} */
-  static #floatingRegion() {
-    if (this.#floating) return this.#floating;
+  /** @param {Element|string|null|undefined} scope @returns {Message} */
+  static #floatingRegion(scope) {
+    const host = overlayHost(scope ?? null);
+    const existing = this.#floating.get(host);
+    if (existing) return existing;
     const region = h('div', {
       class: 'zx-message-region',
       popover: 'manual',
       role: 'status',
       ariaLive: 'polite'
     });
-    document.body.append(region);
-    this.#floating = new Message(region);
+    host.append(region);
+    const floating = new Message(region);
+    this.#floating.set(host, floating);
     if (typeof region.showPopover === 'function') region.showPopover();
-    return this.#floating;
+    return floating;
   }
 }
 

package/src/components/modal/modal.css

@@ -4,10 +4,12 @@
   overflow: auto;
   border: 1px solid var(--zx-color-overlay-border);
   border-radius: var(--zx-radius-lg);
-  background: var(--zx-color-overlay-panel);
+  background-color: var(--zx-color-overlay-panel);
+  background-image: var(--zx-overlay-panel-image);
+  background-clip: padding-box;
   -webkit-backdrop-filter: var(--zx-glass-filter-panel);
   backdrop-filter: var(--zx-glass-filter-panel);
-  box-shadow: var(--zx-glass-raised-shadow);
+  box-shadow: var(--zx-glass-panel-shadow);
   color: var(--zx-color-text);
   padding: 0;
 }
@@ -23,7 +25,7 @@
 }
 
 .zx-modal::backdrop {
-  background: var(--zx-color-bg-backdrop);
+  background: var(--zx-color-overlay-backdrop);
 }
 
 .zx-modal__content {
@@ -34,7 +36,7 @@
  * `:modal` rather than `[open]`: only a dialog opened with `showModal()` blocks the page, and a
  * non-modal one (Sheet's `modal: false`) must leave the page scrollable behind it.
  */
-body:has(> .zx-modal:modal) {
+body:has(.zx-modal:modal) {
   overflow: hidden;
   overscroll-behavior: none;
 }

package/src/components/modal/modal.js

@@ -1,5 +1,6 @@
 import { Component } from '../../core/component.js';
 import { h } from '../../core/dom.js';
+import { overlayHost } from '../../core/overlay-host.js';
 
 /**
  * @typedef {Object} ModalOptions
@@ -8,6 +9,7 @@ import { h } from '../../core/dom.js';
  * @property {boolean} [closable=true] Whether Escape may close the modal.
  * @property {boolean} [lightDismiss=false] Whether a backdrop click closes the modal.
  * @property {boolean} [destroyOnClose=false] Whether to destroy the modal after it closes.
+ * @property {Element|string|null} [scope=null] Element whose nearest Zx theme scope owns the overlay; defaults to the opener.
  * @property {(event: CustomEvent<Record<string, never>>) => void} [onopen] Open event listener.
  * @property {(event: CustomEvent<{result: unknown}>) => void} [onclose] Close event listener.
  * @property {(event: CustomEvent<Record<string, never>>) => void} [oncancel] Cancel event listener.
@@ -30,15 +32,19 @@ export class Modal extends Component {
     width: 'auto',
     closable: true,
     lightDismiss: false,
-    destroyOnClose: false
+    destroyOnClose: false,
+    scope: null
   };
 
-  #pendingResult;
-  #hasPendingResult = false;
+  /** @type {Map<number, {result: unknown}>} */
+  #pendingResults = new Map();
   #destroying = false;
+  #presentation = 0;
+  /** @type {number[]} */
+  #nativeClosingPresentations = [];
 
   /**
-   * Creates a modal appended to `document.body`.
+   * Creates a modal in the configured theme scope, or at document level when none is present.
    * @param {Element|string|null} [_target=null] Ignored; Modal always owns its root dialog.
    * @param {ModalOptions} [options={}] Modal options.
    */
@@ -52,14 +58,7 @@ export class Modal extends Component {
       if (!this.options.closable || cancelEvent.defaultPrevented) event.preventDefault();
     });
     this.listen(this.el, 'close', () => {
-      if (!this._isRealClose()) return;
-      this.el.dataset.state = 'closed';
-      delete this.el.dataset.zxOverlayOrder;
-      const result = this.#hasPendingResult ? this.#pendingResult : (this.el.returnValue || undefined);
-      this.#pendingResult = undefined;
-      this.#hasPendingResult = false;
-      this.emit('close', { result });
-      if (this.options.destroyOnClose && !this.#destroying) this.destroy();
+      this._settleClose(this.#nativeClosingPresentations.shift());
     });
     this.listen(this.el, 'click', (event) => {
       if (!this.options.lightDismiss || event.target !== this.el || !isBackdropClick(this.el, event)) return;
@@ -76,7 +75,7 @@ export class Modal extends Component {
    * @returns {Element}
    */
   mountTarget() {
-    return document.body;
+    return overlayHost(this.options.scope);
   }
 
   /**
@@ -87,17 +86,85 @@ export class Modal extends Component {
     this.el.showModal();
   }
 
+  /**
+   * Removes the dialog from its current presentation layer.
+   * Subclasses may replace native dialog presentation while preserving Modal lifecycle events.
+   * @param {string} [result=''] Native string return value.
+   * @param {number} [presentation=this.#presentation] Presentation generation being hidden.
+   * @returns {void}
+   */
+  _hide(result = '', presentation = this.#presentation) {
+    this.#nativeClosingPresentations.push(presentation);
+    try {
+      this.el.close(result);
+    } catch (error) {
+      this.#nativeClosingPresentations.pop();
+      throw error;
+    }
+  }
+
+  /**
+   * Shows a new presentation and gives it a generation of its own. Close events are queued by the
+   * platform, so the generation lets an event from an earlier presentation expire harmlessly if
+   * the same overlay has already reopened.
+   * @returns {void}
+   */
+  _present() {
+    this._show();
+    this.#presentation += 1;
+  }
+
+  /**
+   * Hides the current presentation and records which generation its queued close event belongs to.
+   * @param {string} [result=''] Native string return value.
+   * @returns {void}
+   */
+  _dismiss(result = '') {
+    this._hide(result, this.#presentation);
+  }
+
+  /**
+   * Reports whether the current presentation layer is visible.
+   * @returns {boolean}
+   */
+  _isShown() {
+    return this.el.open;
+  }
+
   /**
    * Whether an incoming `close` event is a real dismissal.
    *
-   * A dialog cannot move between the top layer and the page flow while it is open, so a subclass
-   * that re-hosts itself has to close and immediately reopen. `close` is dispatched in a queued
-   * task, not synchronously, so that stale event arrives once the dialog is already open again —
-   * late enough to clobber `data-state`, fire a `close` nobody asked for, and trip
-   * `destroyOnClose`. Returning false from an override drops it at the source instead.
+   * `close` is dispatched in a queued task, not synchronously. By the time it arrives the overlay
+   * may have reopened or crossed presentation layers, so only the event for the current hidden
+   * generation may settle state, emit lifecycle events, or trigger `destroyOnClose`.
+   * @param {number|undefined} closingPresentation Presentation that produced the event, if known.
    * @returns {boolean}
    */
-  _isRealClose() {
+  _isRealClose(closingPresentation) {
+    if (closingPresentation !== undefined && closingPresentation !== this.#presentation) return false;
+    return !this._isShown();
+  }
+
+  /**
+   * Settles one presentation's close without allowing a queued event to invalidate a newer one.
+   * Popover-based subclasses call this directly; native dialog events arrive through the listener.
+   * @param {number|undefined} closingPresentation Presentation that was hidden, if known.
+   * @returns {boolean} Whether this event closed the current presentation.
+   */
+  _settleClose(closingPresentation) {
+    if (!this._isRealClose(closingPresentation)) {
+      if (closingPresentation !== undefined) this.#pendingResults.delete(closingPresentation);
+      return false;
+    }
+    this.el.dataset.state = 'closed';
+    delete this.el.dataset.zxOverlayOrder;
+    const pending = closingPresentation === undefined
+      ? undefined
+      : this.#pendingResults.get(closingPresentation);
+    if (closingPresentation !== undefined) this.#pendingResults.delete(closingPresentation);
+    const result = pending ? pending.result : (this.el.returnValue || undefined);
+    this.emit('close', { result });
+    if (this.options.destroyOnClose && !this.#destroying) this.destroy();
     return true;
   }
 
@@ -121,10 +188,12 @@ export class Modal extends Component {
    */
   open() {
     if (this.isOpen()) return this;
+    const host = this.mountTarget();
+    if (this.el.parentElement !== host) host.append(this.el);
     this.el.dataset.zxOverlayOrder = String(nextOverlayOrder());
     this.el.returnValue = '';
     try {
-      this._show();
+      this._present();
     } catch (error) {
       delete this.el.dataset.zxOverlayOrder;
       throw error;
@@ -141,9 +210,14 @@ export class Modal extends Component {
    */
   close(result) {
     if (!this.isOpen()) return this;
-    this.#pendingResult = result;
-    this.#hasPendingResult = true;
-    this.el.close(typeof result === 'string' ? result : '');
+    const presentation = this.#presentation;
+    this.#pendingResults.set(presentation, { result });
+    try {
+      this._dismiss(typeof result === 'string' ? result : '');
+    } catch (error) {
+      this.#pendingResults.delete(presentation);
+      throw error;
+    }
     return this;
   }
 
@@ -162,7 +236,7 @@ export class Modal extends Component {
    * @returns {boolean}
    */
   isOpen() {
-    return this.el.open;
+    return this._isShown();
   }
 
   /**
@@ -172,7 +246,7 @@ export class Modal extends Component {
   destroy() {
     if (this.#destroying) return;
     this.#destroying = true;
-    if (this.isOpen()) this.el.close();
+    if (this.isOpen()) this._dismiss();
     super.destroy();
   }
 

package/src/components/select/select.css

@@ -98,10 +98,12 @@
   overflow: hidden;
   border: 1px solid var(--zx-color-overlay-border);
   border-radius: var(--zx-radius-md);
-  background: var(--zx-color-overlay-surface);
+  background-color: var(--zx-color-overlay-surface);
+  background-image: var(--zx-overlay-surface-image);
+  background-clip: padding-box;
   -webkit-backdrop-filter: var(--zx-glass-filter-overlay);
   backdrop-filter: var(--zx-glass-filter-overlay);
-  box-shadow: var(--zx-glass-raised-shadow);
+  box-shadow: var(--zx-glass-overlay-shadow);
   color: var(--zx-color-text);
   padding: var(--zx-space-1);
 }
@@ -128,15 +130,15 @@
 }
 
 .zx-select__option[data-active="true"] {
-  background: var(--zx-color-bg-hover);
+  background: var(--zx-color-overlay-hover);
 }
 
 .zx-select__option:hover {
-  background: var(--zx-color-bg-hover);
+  background: var(--zx-color-overlay-hover);
 }
 
 .zx-select__option[aria-selected="true"] {
-  background: var(--zx-color-bg-selected);
+  background: var(--zx-color-overlay-selected);
 }
 
 .zx-select__option > .zx-icon {
@@ -148,7 +150,7 @@
   position: sticky;
   z-index: 1;
   inset-block-start: 0;
-  background: var(--zx-color-overlay-surface);
+  background: var(--zx-color-overlay-scrim);
   color: var(--zx-color-text-muted);
   font-size: var(--zx-text-xs);
   font-weight: 700;
@@ -174,7 +176,7 @@
 .zx-select__separator {
   block-size: 1px;
   margin: var(--zx-space-1) var(--zx-control-pad-x);
-  background: var(--zx-color-border);
+  background: var(--zx-color-overlay-divider);
 }
 
 .zx-select__empty {

package/src/components/sheet/sheet.css

@@ -12,7 +12,7 @@
   border-radius: 0;
   /* The header and footer stay put; `.zx-dialog__body` is what scrolls. */
   overflow: hidden;
-  box-shadow: var(--zx-glass-raised-shadow);
+  box-shadow: var(--zx-glass-panel-shadow);
 }
 
 /* Horizontal sheets: full height, sized across the inline axis. */
@@ -26,14 +26,14 @@
 .zx-sheet[data-side="start"] {
   inset-inline-start: 0;
   inset-inline-end: auto;
-  border-inline-end: 1px solid var(--zx-color-border);
+  border-inline-end: 1px solid var(--zx-color-overlay-border);
   --zx-sheet-enter: -100% 0;
 }
 
 .zx-sheet[data-side="end"] {
   inset-inline-start: auto;
   inset-inline-end: 0;
-  border-inline-start: 1px solid var(--zx-color-border);
+  border-inline-start: 1px solid var(--zx-color-overlay-border);
   --zx-sheet-enter: 100% 0;
 }
 
@@ -56,7 +56,7 @@
 .zx-sheet[data-side="top"] {
   inset-block-start: 0;
   inset-block-end: auto;
-  border-block-end: 1px solid var(--zx-color-border);
+  border-block-end: 1px solid var(--zx-color-overlay-border);
   border-end-start-radius: var(--zx-sheet-radius, var(--zx-radius-xl));
   border-end-end-radius: var(--zx-sheet-radius, var(--zx-radius-xl));
   --zx-sheet-enter: 0 -100%;
@@ -65,7 +65,7 @@
 .zx-sheet[data-side="bottom"] {
   inset-block-start: auto;
   inset-block-end: 0;
-  border-block-start: 1px solid var(--zx-color-border);
+  border-block-start: 1px solid var(--zx-color-overlay-border);
   border-start-start-radius: var(--zx-sheet-radius, var(--zx-radius-xl));
   border-start-end-radius: var(--zx-sheet-radius, var(--zx-radius-xl));
   --zx-sheet-enter: 0 100%;
@@ -80,9 +80,26 @@
 }
 
 .zx-sheet[data-backdrop="blur"]::backdrop {
+  -webkit-backdrop-filter: blur(var(--zx-overlay-blur));
   backdrop-filter: blur(var(--zx-overlay-blur));
 }
 
+/* A non-modal Sheet uses the popover top layer to escape transformed/clipped application shells,
+   but it must not gain a visual or interactive modal backdrop in the process. */
+.zx-sheet[data-modality="none"]::backdrop,
+.zx-sheet[data-modality="trap-focus"]::backdrop {
+  background: transparent;
+  -webkit-backdrop-filter: none;
+  backdrop-filter: none;
+}
+
+@media (prefers-reduced-transparency: reduce), (prefers-contrast: more), (forced-colors: active) {
+  .zx-sheet[data-backdrop="blur"]::backdrop {
+    -webkit-backdrop-filter: none;
+    backdrop-filter: none;
+  }
+}
+
 /*
  * Entry and exit both animate. A `<dialog>` normally cannot animate out — `close()` applies
  * `display: none` immediately — so `display` and `overlay` transition with `allow-discrete`, which
@@ -103,13 +120,14 @@
     animation: none;
   }
 
-  .zx-sheet:not([open]) {
+  .zx-sheet:not([open]):not(:popover-open) {
     translate: var(--zx-sheet-enter, 0 0);
     opacity: 0;
   }
 
   @starting-style {
-    .zx-sheet[open] {
+    .zx-sheet[open],
+    .zx-sheet:popover-open {
       translate: var(--zx-sheet-enter, 0 0);
       opacity: 0;
     }