@dogsbay/elements 0.2.0-beta.13 → 0.2.0-beta.130

package/dist/chunk-RZ3KZOM3.js

@@ -0,0 +1,207 @@
+import {
+  afterAnimations,
+  ownOne,
+  resolveAsChild,
+  uid
+} from "./chunk-KXCPLIQD.js";
+import {
+  DogsbayElement,
+  ensureDefaultDisplay
+} from "./chunk-MZDGSTI4.js";
+
+// src/db-dialog.ts
+import { FocusTrap } from "@dogsbay/primitives/focus-trap";
+import { ScrollLock } from "@dogsbay/primitives/scroll-lock";
+import { DismissController } from "@dogsbay/primitives/dismiss";
+import { markOthersInert } from "@dogsbay/primitives/inert";
+var DbDialog = class extends DogsbayElement {
+  content = null;
+  backdrop = null;
+  trigger = null;
+  native = false;
+  _open = false;
+  openedBy = null;
+  focusTrap = null;
+  dismiss = null;
+  cleanupInert = null;
+  get open() {
+    return this._open;
+  }
+  get dismissible() {
+    return this.getAttribute("dismissible") !== "false";
+  }
+  onTriggerClick = (e) => {
+    e.preventDefault();
+    this.toggle(e.currentTarget);
+  };
+  onHostClick = (e) => {
+    const close = e.target.closest("[data-part='close']");
+    if (close && close.closest("db-dialog") === this) this.close("close-press");
+  };
+  onDocumentClick = (e) => {
+    const ext = e.target.closest?.("[data-dialog-for]");
+    if (!ext || ext === this.trigger) return;
+    const target = ext.getAttribute("data-dialog-for");
+    if (target && (target === this.id || target === this.content?.id)) {
+      e.preventDefault();
+      this.toggle(ext);
+    }
+  };
+  // Native <dialog>: Escape fires "cancel".
+  onCancel = (e) => {
+    e.preventDefault();
+    if (this.dismissible) this.close("escape-key");
+  };
+  // Native <dialog>: a click on the ::backdrop targets the dialog itself.
+  onNativeClick = (e) => {
+    if (!this.dismissible || e.target !== this.content || !this.content) return;
+    const r = this.content.getBoundingClientRect();
+    const inside = e.clientX >= r.left && e.clientX <= r.right && e.clientY >= r.top && e.clientY <= r.bottom;
+    if (!inside && (e.clientX !== 0 || e.clientY !== 0)) this.close("outside-press");
+  };
+  // Native <dialog> closed by the platform (form method="dialog").
+  onNativeClose = () => {
+    if (this._open) this.finishClose("close-press");
+  };
+  setup() {
+    this.content = ownOne(this, "[data-part='content']");
+    if (!this.content) return;
+    this.native = typeof HTMLDialogElement !== "undefined" && this.content instanceof HTMLDialogElement && typeof this.content.showModal === "function";
+    this.backdrop = ownOne(this, "[data-part='backdrop']");
+    this.trigger = resolveAsChild(ownOne(this, "[data-part='trigger']"));
+    const content = this.content;
+    if (!content.id) content.id = uid("db-dialog");
+    if (!this.native) {
+      content.setAttribute("role", content.getAttribute("role") || "dialog");
+      content.setAttribute("aria-modal", "true");
+      content.hidden = !this.hasAttribute("open");
+      if (this.backdrop) this.backdrop.hidden = true;
+    }
+    const title = content.querySelector("[data-part='title']");
+    if (title && !content.hasAttribute("aria-labelledby") && !content.hasAttribute("aria-label")) {
+      title.id ||= uid("db-dialog-title");
+      content.setAttribute("aria-labelledby", title.id);
+    }
+    const desc = content.querySelector("[data-part='description']");
+    if (desc && !content.hasAttribute("aria-describedby")) {
+      desc.id ||= uid("db-dialog-desc");
+      content.setAttribute("aria-describedby", desc.id);
+    }
+    for (const t of this.triggers()) this.prepareTrigger(t);
+    this.setState("closed");
+    if (!this.native) {
+      this.focusTrap = new FocusTrap(content);
+      this.dismiss = new DismissController(content, {
+        onDismiss: (reason) => this.dismissible && this.close(reason)
+      });
+    }
+  }
+  connect() {
+    if (!this.content) return;
+    this.trigger?.addEventListener("click", this.onTriggerClick);
+    this.addEventListener("click", this.onHostClick);
+    document.addEventListener("click", this.onDocumentClick);
+    if (this.native) {
+      this.content.addEventListener("cancel", this.onCancel);
+      this.content.addEventListener("click", this.onNativeClick);
+      this.content.addEventListener("close", this.onNativeClose);
+    }
+    queueMicrotask(() => {
+      if (!this.isConnected) return;
+      for (const t of this.triggers()) if (!t.hasAttribute("aria-controls")) this.prepareTrigger(t);
+      if (this.hasAttribute("open") && !this._open) this.show();
+    });
+  }
+  disconnect() {
+    this.trigger?.removeEventListener("click", this.onTriggerClick);
+    this.removeEventListener("click", this.onHostClick);
+    document.removeEventListener("click", this.onDocumentClick);
+    if (this.content && this.native) {
+      this.content.removeEventListener("cancel", this.onCancel);
+      this.content.removeEventListener("click", this.onNativeClick);
+      this.content.removeEventListener("close", this.onNativeClose);
+    }
+    if (this._open) this.finishClose("api", false);
+  }
+  /** Internal trigger plus every `[data-dialog-for]` pointing here. */
+  triggers() {
+    const out = this.trigger ? [this.trigger] : [];
+    const ids = [this.id, this.content?.id].filter(Boolean);
+    for (const id of ids) document.querySelectorAll(`[data-dialog-for="${CSS.escape(id)}"]`).forEach((el) => out.push(el));
+    return out;
+  }
+  prepareTrigger(t) {
+    if (!t.hasAttribute("aria-haspopup")) t.setAttribute("aria-haspopup", "dialog");
+    t.setAttribute("aria-controls", this.content.id);
+    t.setAttribute("aria-expanded", "false");
+  }
+  setState(state) {
+    this.setAttribute("data-state", state);
+    this.content?.setAttribute("data-state", state);
+    this.backdrop?.setAttribute("data-state", state);
+  }
+  toggle(opener) {
+    if (this._open) this.close("trigger-press");
+    else this.show(opener);
+  }
+  show(opener) {
+    const content = this.content;
+    if (!content || this._open) return;
+    this._open = true;
+    this.openedBy = opener ?? document.activeElement ?? this.trigger;
+    for (const t of this.triggers()) {
+      this.prepareTrigger(t);
+      t.setAttribute("aria-expanded", "true");
+    }
+    ScrollLock.activate();
+    if (this.native) {
+      const d = content;
+      if (!d.open) d.showModal();
+    } else {
+      content.hidden = false;
+      if (this.backdrop) this.backdrop.hidden = false;
+      this.cleanupInert = markOthersInert(content);
+      this.focusTrap?.activate();
+      this.dismiss?.activate();
+    }
+    this.setState("open");
+    this.dispatchEvent(new CustomEvent("db-dialog:open", { bubbles: true }));
+  }
+  close(reason = "api") {
+    if (!this._open) return;
+    this.finishClose(reason);
+  }
+  finishClose(reason, restoreFocus = true) {
+    const content = this.content;
+    this._open = false;
+    this.setState("closed");
+    for (const t of this.triggers()) t.setAttribute("aria-expanded", "false");
+    ScrollLock.deactivate();
+    if (this.native) {
+      const d = content;
+      if (d.open) d.close();
+    } else {
+      this.dismiss?.deactivate();
+      this.focusTrap?.deactivate();
+      this.cleanupInert?.();
+      this.cleanupInert = null;
+      afterAnimations(content, () => {
+        if (this._open) return;
+        content.hidden = true;
+        if (this.backdrop) this.backdrop.hidden = true;
+      });
+    }
+    const back = this.openedBy;
+    this.openedBy = null;
+    if (restoreFocus && back && document.contains(back)) back.focus();
+    this.dispatchEvent(new CustomEvent("db-dialog:close", { detail: { reason }, bubbles: true }));
+  }
+};
+ensureDefaultDisplay();
+if (!customElements.get("db-dialog")) {
+  customElements.define("db-dialog", DbDialog);
+}
+
+export {
+  DbDialog
+};

package/dist/{chunk-LFXZQ4YV.js → chunk-US4H4ZPZ.js}

@@ -1,6 +1,7 @@
 import {
-  DogsbayElement
-} from "./chunk-XBMLE4N3.js";
+  DogsbayElement,
+  ensureDefaultDisplay
+} from "./chunk-MZDGSTI4.js";
 
 // src/db-link-button.ts
 var DbLinkButton = class extends DogsbayElement {
@@ -27,6 +28,7 @@ var DbLinkButton = class extends DogsbayElement {
     this.appendChild(this.anchor);
   }
 };
+ensureDefaultDisplay();
 if (!customElements.get("db-link-button")) {
   customElements.define("db-link-button", DbLinkButton);
 }
@@ -34,4 +36,3 @@ if (!customElements.get("db-link-button")) {
 export {
   DbLinkButton
 };
-//# sourceMappingURL=chunk-LFXZQ4YV.js.map

package/dist/db-accordion.d.ts

@@ -1,4 +1,4 @@
-import { D as DogsbayElement } from './base-BtvRtAsC.js';
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
 
 /**
  * `<db-accordion>` — Accessible accordion with single/multiple mode.

package/dist/db-accordion.js

@@ -1,8 +1,7 @@
 import {
   DbAccordion
-} from "./chunk-7M7SFLKN.js";
-import "./chunk-XBMLE4N3.js";
+} from "./chunk-5KHESKQR.js";
+import "./chunk-MZDGSTI4.js";
 export {
   DbAccordion
 };
-//# sourceMappingURL=db-accordion.js.map

package/dist/db-card.d.ts

@@ -1,4 +1,4 @@
-import { D as DogsbayElement } from './base-BtvRtAsC.js';
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
 
 /**
  * `<db-card>` — Accessible content card with optional link behavior.

package/dist/db-card.js

@@ -1,8 +1,7 @@
 import {
   DbCard
-} from "./chunk-7BIVQSGP.js";
-import "./chunk-XBMLE4N3.js";
+} from "./chunk-JRAYNKQ6.js";
+import "./chunk-MZDGSTI4.js";
 export {
   DbCard
 };
-//# sourceMappingURL=db-card.js.map

package/dist/db-code-block.d.ts

@@ -1,4 +1,4 @@
-import { D as DogsbayElement } from './base-BtvRtAsC.js';
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
 
 /**
  * `<db-code-block>` — Code block with copy-to-clipboard.

package/dist/db-code-block.js

@@ -1,8 +1,7 @@
 import {
   DbCodeBlock
-} from "./chunk-FWAAU5UY.js";
-import "./chunk-XBMLE4N3.js";
+} from "./chunk-CD3G6HKT.js";
+import "./chunk-MZDGSTI4.js";
 export {
   DbCodeBlock
 };
-//# sourceMappingURL=db-code-block.js.map

package/dist/db-collapsible.d.ts

@@ -1,4 +1,4 @@
-import { D as DogsbayElement } from './base-BtvRtAsC.js';
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
 
 /**
  * `<db-collapsible>` — Accessible expand/collapse panel.

package/dist/db-collapsible.js

@@ -1,8 +1,7 @@
 import {
   DbCollapsible
-} from "./chunk-TTNTPXBA.js";
-import "./chunk-XBMLE4N3.js";
+} from "./chunk-5WY3DHVB.js";
+import "./chunk-MZDGSTI4.js";
 export {
   DbCollapsible
 };
-//# sourceMappingURL=db-collapsible.js.map

package/dist/db-combobox.d.ts

@@ -0,0 +1,70 @@
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
+
+/**
+ * `<db-combobox>` — Editable combobox with a listbox (APG "Editable
+ * Combobox With List Autocomplete"). Focus stays in the input; the
+ * highlighted option is exposed with aria-activedescendant.
+ *
+ * Parts (same contract as the Astro Combobox):
+ *   [data-part="input"]    text input, role=combobox
+ *   [data-part="listbox"]  role=listbox
+ *   [data-part="option"]   role=option, data-value, data-disabled
+ *   [data-part="empty"]    shown when a query has no matches (optional)
+ *
+ * Attributes:
+ *   filter="contains"  (default) the element filters its own options by text
+ *   filter="none"      the page supplies options (search results); the element
+ *                      watches the listbox and manages highlight and ARIA
+ *   inline             the listbox is always shown (e.g. inside a search dialog);
+ *                      aria-expanded tracks whether it has options
+ *   no-autohighlight   do not highlight the first option when the list changes
+ *
+ * Choosing an option dispatches a cancelable `db-combobox:select`
+ * (detail: { value, text, option }). If not cancelled, a link option
+ * (`<a href data-part="option">`, the accessible shape for results that
+ * navigate: ARIA allows role=option on a link, but not a link inside an
+ * option) is followed; otherwise the input takes the option's text and
+ * `db-combobox:change` fires. Wrap link options in `<li role="none">`.
+ *
+ * Other events: db-combobox:update (detail: { count }) when the visible options change.
+ */
+declare class DbCombobox extends DogsbayElement {
+    private input;
+    private listbox;
+    private empty;
+    private _open;
+    private highlighted;
+    private observer;
+    private base;
+    private optionSeq;
+    get open(): boolean;
+    private get inline();
+    private get filtering();
+    /** All options, in order. Read live, so page-supplied results are always current. */
+    options(): HTMLElement[];
+    private visible;
+    protected setup(): void;
+    private prepareOptions;
+    private onInput;
+    private onFocus;
+    private onKey;
+    private onListClick;
+    private onListPointer;
+    private onListDown;
+    private onDocDown;
+    protected connect(): void;
+    protected disconnect(): void;
+    /** Re-scan options after the page replaced them (filter="none"). */
+    refresh(): void;
+    private onOptionsChanged;
+    private filter;
+    private syncExpanded;
+    show(): void;
+    hide(): void;
+    private highlight;
+    private clearHighlight;
+    /** Returns false when a `db-combobox:select` listener cancelled the choice. */
+    private choose;
+}
+
+export { DbCombobox };

package/dist/db-combobox.js

@@ -0,0 +1,8 @@
+import {
+  DbCombobox
+} from "./chunk-GC5HL7FU.js";
+import "./chunk-KXCPLIQD.js";
+import "./chunk-MZDGSTI4.js";
+export {
+  DbCombobox
+};

package/dist/db-details-sheet.d.ts

@@ -0,0 +1,53 @@
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
+
+/**
+ * `<db-details-sheet>` — a `<details>` that opens as a side sheet.
+ *
+ * The markup is an ordinary `<details>` (the CollapsibleAlert markup), so
+ * with no script — `js: none`, a blocked script, print, an agent reading the
+ * HTML — it is a working collapsible block and nothing is hidden. With the
+ * script, activating the summary opens the body in a native modal `<dialog>`
+ * on the right instead: the browser puts it in the top layer, makes the page
+ * inert and handles Escape.
+ *
+ * The body is MOVED into the sheet while it is open and back when it closes,
+ * so ids, anchors and nested elements exist once. A URL fragment naming the
+ * details or anything in its body opens the sheet, so a cross-reference lands.
+ *
+ * Attributes:
+ *   close-label  — the close button's accessible name (default "Close")
+ *
+ * Children:
+ *   <details> with a <summary> — the summary's `[data-part="title"]`, or its
+ *   text, titles the sheet
+ *
+ * Events: db-details-sheet:open, db-details-sheet:close
+ */
+declare class DbDetailsSheet extends DogsbayElement {
+    private details;
+    private summary;
+    private dialog;
+    private body;
+    /** Where the moved nodes came from, and the nodes, while the sheet is open. */
+    private source;
+    private moved;
+    /** The fragment already acted on: moving a nested sheet in and out of a
+     *  dialog reconnects it, and reopening on every connect made it undismissable. */
+    private handledHash;
+    get open(): boolean;
+    private onSummaryClick;
+    private onDialogClick;
+    private onDialogClose;
+    private onDocClick;
+    private onHash;
+    protected setup(): void;
+    protected connect(): void;
+    protected disconnect(): void;
+    show(focusTarget?: Element | null): void;
+    close(): void;
+    private restore;
+    /** Open when the URL fragment names the details or something in its body. */
+    private openForHash;
+}
+
+export { DbDetailsSheet };

package/dist/db-details-sheet.js

@@ -0,0 +1,8 @@
+import {
+  DbDetailsSheet
+} from "./chunk-KFY2MTR3.js";
+import "./chunk-KXCPLIQD.js";
+import "./chunk-MZDGSTI4.js";
+export {
+  DbDetailsSheet
+};

package/dist/db-dialog.d.ts

@@ -0,0 +1,62 @@
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
+
+type DialogCloseReason = "escape-key" | "outside-press" | "close-press" | "trigger-press" | "api";
+/**
+ * `<db-dialog>` — Modal dialog (WAI-ARIA APG "Dialog (Modal)").
+ *
+ * Same parts as the Astro Dialog. When `[data-part="content"]` is a native
+ * `<dialog>`, it opens with `showModal()`: the browser puts it in the top
+ * layer, makes the rest of the page inert and handles Escape. Otherwise the
+ * content is a positioned element and the primitives do that work
+ * (FocusTrap, markOthersInert, ScrollLock, DismissController). Content is
+ * never moved out of the element, so nested elements keep working.
+ *
+ * Attributes:
+ *   open                  — open on connect
+ *   dismissible="false"   — ignore Escape and outside clicks
+ *
+ * Parts:
+ *   [data-part="trigger"]      — opens (optional; `data-as-child` supported)
+ *   [data-part="content"]      — `<dialog>` (recommended) or any element
+ *   [data-part="backdrop"]     — overlay for non-native content
+ *   [data-part="title"]        — becomes aria-labelledby
+ *   [data-part="description"]  — becomes aria-describedby
+ *   [data-part="close"]        — closes
+ *
+ * External triggers: any element with `data-dialog-for="<id>"`, where the id
+ * is the element's or the content's, opens it from anywhere on the page.
+ *
+ * Events: db-dialog:open, db-dialog:close (detail: { reason })
+ */
+declare class DbDialog extends DogsbayElement {
+    content: HTMLElement | null;
+    private backdrop;
+    private trigger;
+    private native;
+    private _open;
+    private openedBy;
+    private focusTrap;
+    private dismiss;
+    private cleanupInert;
+    get open(): boolean;
+    private get dismissible();
+    private onTriggerClick;
+    private onHostClick;
+    private onDocumentClick;
+    private onCancel;
+    private onNativeClick;
+    private onNativeClose;
+    protected setup(): void;
+    protected connect(): void;
+    protected disconnect(): void;
+    /** Internal trigger plus every `[data-dialog-for]` pointing here. */
+    private triggers;
+    private prepareTrigger;
+    private setState;
+    toggle(opener?: HTMLElement): void;
+    show(opener?: HTMLElement): void;
+    close(reason?: DialogCloseReason): void;
+    private finishClose;
+}
+
+export { DbDialog, type DialogCloseReason };

package/dist/db-dialog.js

@@ -0,0 +1,8 @@
+import {
+  DbDialog
+} from "./chunk-RZ3KZOM3.js";
+import "./chunk-KXCPLIQD.js";
+import "./chunk-MZDGSTI4.js";
+export {
+  DbDialog
+};

package/dist/db-link-button.d.ts

@@ -1,4 +1,4 @@
-import { D as DogsbayElement } from './base-BtvRtAsC.js';
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
 
 /**
  * `<db-link-button>` — Styled link that looks like a button.

package/dist/db-link-button.js

@@ -1,8 +1,7 @@
 import {
   DbLinkButton
-} from "./chunk-LFXZQ4YV.js";
-import "./chunk-XBMLE4N3.js";
+} from "./chunk-US4H4ZPZ.js";
+import "./chunk-MZDGSTI4.js";
 export {
   DbLinkButton
 };
-//# sourceMappingURL=db-link-button.js.map

package/dist/db-nav-tree.d.ts

@@ -0,0 +1,83 @@
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
+
+/**
+ * [label, url, children?, noCurrent?]. `noCurrent` (1): never mark this link
+ * as the current page even when its URL matches — an alias (a link to a page
+ * that lives in another section) or a #section link. The server-rendered
+ * tree already leaves those unmarked; lazily built groups must agree.
+ */
+type NavData = [string, string | null, NavData[]?, 1?];
+/**
+ * `<db-nav-tree>` — Site navigation tree (APG "Disclosure Navigation").
+ *
+ * A section that is also a page gets a real link AND a separate toggle
+ * button as siblings — never a link inside `<summary>`, which is nested
+ * interactive content (axe `nested-interactive`). A section with no page
+ * is a single toggle button carrying the label. Every link stays in the
+ * normal Tab order; arrow keys are an extra shortcut, not a replacement.
+ *
+ * Server-rendered markup works without JavaScript: links navigate, and the
+ * branch to the current page is rendered open.
+ *
+ *   <db-nav-tree>
+ *     <ul data-part="list">
+ *       <li data-part="item" data-state="open">
+ *         <div data-part="row">
+ *           <button data-part="toggle" type="button" aria-expanded="true" aria-controls="g1" aria-label="Toggle Guides"></button>
+ *           <a data-part="link" href="guides/index.html">Guides</a>
+ *         </div>
+ *         <ul data-part="group" id="g1">…</ul>
+ *       </li>
+ *       <li data-part="item"><div data-part="row"><a data-part="link" href="faq.html" aria-current="page">FAQ</a></div></li>
+ *     </ul>
+ *   </db-nav-tree>
+ *
+ * Lazy sections: a group with `data-lazy` and `data-path="0.3"` is filled
+ * from `navData` (or the global named by `data-source`) the first time it
+ * opens. URLs in the data are prefixed with the `base` attribute.
+ *
+ * Attributes:
+ *   base            — prefix for data URLs (e.g. "../../")
+ *   data-source     — name of a window global holding NavData[]
+ *   toggle-label    — accessible name template, default "Toggle {label}"
+ *   scroll-current  — scroll the current page's link into view on connect
+ * Built items carry `style="--db-level:N"` (0 at the top) so CSS can indent
+ * them; server markup should set the same.
+ *
+ *   toggle-position — "start" (default) or "end": where lazily built rows put
+ *                     the toggle relative to the link. Match the server markup
+ *                     so DOM (and Tab) order follows the visual order.
+ *
+ * Keyboard (in addition to Tab): ArrowDown/ArrowUp move between visible
+ * rows, ArrowRight opens a section or moves into it, ArrowLeft closes it or
+ * moves to its parent, Home/End go to the first/last row.
+ *
+ * Events: db-nav-tree:toggle (detail: { item, open })
+ */
+declare class DbNavTree extends DogsbayElement {
+    /** Nav data for lazy sections. Falls back to `window[data-source]`. */
+    navData: NavData[] | null;
+    private onClick;
+    private onKey;
+    protected setup(): void;
+    protected connect(): void;
+    protected disconnect(): void;
+    private prepareItem;
+    private groupOf;
+    private toggleOf;
+    /** The row's main focus target: its link, or its toggle for a label-only section. */
+    private primary;
+    private visibleRows;
+    isOpen(item: HTMLElement): boolean;
+    toggle(item: HTMLElement): void;
+    setOpen(item: HTMLElement, open: boolean): void;
+    private apply;
+    /** Expand every section on the path to the current page. */
+    revealCurrent(): void;
+    private data;
+    /** Fill a lazy group from nav data. */
+    private fill;
+    private build;
+}
+
+export { DbNavTree, type NavData };

package/dist/db-nav-tree.js

@@ -0,0 +1,8 @@
+import {
+  DbNavTree
+} from "./chunk-2ZMWJ74J.js";
+import "./chunk-KXCPLIQD.js";
+import "./chunk-MZDGSTI4.js";
+export {
+  DbNavTree
+};

package/dist/db-popover.d.ts

@@ -0,0 +1,42 @@
+import { D as DogsbayElement } from './base-D1Rz70fn.js';
+
+/**
+ * `<db-popover>` — Non-modal floating panel (APG "Dialog", non-modal).
+ *
+ * Same parts as the Astro Popover. The content opens in the browser's top
+ * layer (Popover API) where available, so no ancestor's `overflow` clips it
+ * and it needs no portal, and floating-ui positions it next to the trigger.
+ *
+ * Attributes:
+ *   placement   — "bottom" (default), "top-start", … (or data-side/data-align on the content)
+ *   offset      — gap in px (default 8)
+ *   no-autofocus — keep focus on the trigger when opening
+ *
+ * Parts: [data-part="trigger"], [data-part="content"], [data-part="close"]
+ *
+ * Focus: opening moves focus to the first focusable element in the content.
+ * Escape and the close part return focus to the trigger; an outside click
+ * leaves focus where the user clicked.
+ *
+ * Events: db-popover:open, db-popover:close (detail: { reason })
+ */
+declare class DbPopover extends DogsbayElement {
+    private trigger;
+    private content;
+    private dismiss;
+    private cleanupFloating;
+    private _open;
+    get open(): boolean;
+    private onTriggerClick;
+    private onContentClick;
+    protected setup(): void;
+    protected connect(): void;
+    protected disconnect(): void;
+    private setState;
+    private placement;
+    toggle(): void;
+    show(): void;
+    close(reason?: string): void;
+}
+
+export { DbPopover };