@surdeddd/bottom-sheet 0.2.0 → 0.4.0

package/dist/element.js

@@ -31,16 +31,52 @@ var init_sheetStack = __esm({
         this.entries.splice(idx, 1);
         this.recompute();
       }
+      promote(id) {
+        const idx = this.entries.findIndex((e) => e.id === id);
+        if (idx === -1) return;
+        if (idx !== this.entries.length - 1) {
+          const [entry] = this.entries.splice(idx, 1);
+          this.entries.push(entry);
+        }
+        this.recompute();
+      }
+      update() {
+        this.recompute();
+      }
       size() {
         return this.entries.length;
       }
+      depthOf(id) {
+        const open = [];
+        for (const entry of this.entries) {
+          if (!entry.isOpen || entry.isOpen()) open.push(entry);
+        }
+        const idx = open.findIndex((e) => e.id === id);
+        if (idx === -1) return 0;
+        return open.length - 1 - idx;
+      }
       clear() {
         this.entries = [];
       }
       recompute() {
+        let top = null;
+        const open = [];
+        for (const entry of this.entries) {
+          if (!entry.isOpen || entry.isOpen()) {
+            top = entry;
+            open.push(entry);
+          }
+        }
+        if (!top && this.entries.length > 0) {
+          top = this.entries[this.entries.length - 1];
+        }
         this.entries.forEach((entry, i) => {
           entry.setZIndex(BASE_Z + i * STEP);
-          entry.setIsTop(i === this.entries.length - 1);
+          entry.setIsTop(entry === top);
+          if (entry.setDepth) {
+            const openIdx = open.indexOf(entry);
+            entry.setDepth(openIdx === -1 ? 0 : open.length - 1 - openIdx);
+          }
         });
       }
     };
@@ -156,7 +192,9 @@ var init_cssLength = __esm({
     resolveSnap = (point, mode, measureFit) => {
       if (typeof point === "number") return Math.max(0, point);
       if (point === "full") return viewportSize(mode);
-      if (point === "fit") return Math.max(0, measureFit?.() ?? 0);
+      if (point === "fit" || point === "content") {
+        return Math.max(0, measureFit?.() ?? 0);
+      }
       const pctMatch = point.match(PERCENT);
       if (pctMatch) {
         const pct = parseFloat(pctMatch[1]) / 100;
@@ -362,14 +400,17 @@ function installAutoCollapse(deps) {
   const fire = () => {
     if (deps.isDestroyed()) return;
     if (deps.isDragging()) return;
-    const allowed = deps.getAllowedIds();
-    const target = allowed.find((id) => {
+    const active = deps.resolveSnap(deps.getActiveId());
+    if (!active || active.size === 0) return;
+    let target = null;
+    for (const id of deps.getAllowedIds()) {
       const snap = deps.resolveSnap(id);
-      return snap !== null && snap.size > 0;
-    });
+      if (!snap || snap.size <= 0) continue;
+      if (!target || snap.size < target.size) target = snap;
+    }
     if (!target) return;
-    if (target === deps.getActiveId()) return;
-    deps.snapTo(target);
+    if (target.id === active.id || target.size >= active.size) return;
+    deps.snapTo(target.id);
   };
   const reset = () => {
     clearTimer();
@@ -380,6 +421,7 @@ function installAutoCollapse(deps) {
     }, ms);
   };
   const unsubscribe = deps.on("snap", () => reset());
+  if ((deps.resolveSnap(deps.getActiveId())?.size ?? 0) > 0) reset();
   return () => {
     clearTimer();
     unsubscribe();
@@ -396,6 +438,7 @@ function notifyLinkedSheets(sheets, self) {
   for (const linked of sheets) {
     if (linked === self) continue;
     try {
+      if (linked.state.size === 0) continue;
       const ids = linked.getAllowedIds();
       const target = ids.find((id) => id !== "closed");
       if (target && target !== linked.state.activeId) {
@@ -423,86 +466,122 @@ function installRoute(deps) {
     return () => {
     };
   }
-  let routePushed = false;
-  let closeOnBackPushed = false;
-  let detachPopstate = null;
-  const popOurMarker = (key, expected) => {
-    const state = history.state;
-    if (state && state[key] === expected) {
-      try {
-        history.back();
-      } catch {
-      }
+  let pushed = false;
+  let closer = null;
+  const teardownEntry = () => {
+    if (closer) {
+      const idx = closers.indexOf(closer);
+      if (idx !== -1) closers.splice(idx, 1);
+    }
+    const wasConsumed = closer?.consumed ?? false;
+    closer = null;
+    if (pushed && !wasConsumed) {
+      pushed = false;
+      programmaticBack();
+    } else {
+      pushed = false;
     }
   };
   const onOpen = () => {
-    if (deps.routedTo && !detachPopstate) {
-      const target = deps.routedTo;
-      try {
-        history.pushState({ __bsRouted: target }, "", target);
-        routePushed = true;
-      } catch {
-      }
-      const onPop = (event) => {
-        if (deps.isDestroyed()) return;
-        const state = event.state;
-        if (state && state.__bsRouted === target && deps.getSize() > 0) {
-          routePushed = false;
-          void deps.close();
-        }
-      };
-      window.addEventListener("popstate", onPop);
-      detachPopstate = () => window.removeEventListener("popstate", onPop);
-    } else if (deps.closeOnBack && !detachPopstate) {
-      try {
+    if (closer) return;
+    closer = {
+      isOpen: () => !deps.isDestroyed() && deps.getSize() > 0,
+      isTop: () => deps.isTopSheet(),
+      close: () => void deps.close(),
+      consumed: false
+    };
+    ensureHandler();
+    closers.push(closer);
+    try {
+      if (deps.routedTo !== void 0) {
+        history.pushState({ __bsRouted: deps.sheetId }, "", deps.routedTo);
+      } else {
         history.pushState({ __bsSheet: deps.sheetId }, "");
-        closeOnBackPushed = true;
-      } catch {
       }
-      const onPop = () => {
-        if (deps.isDestroyed()) return;
-        if (deps.getSize() > 0 && deps.isTopSheet()) {
-          const state = history.state;
-          if (state?.__bsSheet !== deps.sheetId) closeOnBackPushed = false;
-          void deps.close();
-        }
-      };
-      window.addEventListener("popstate", onPop);
-      detachPopstate = () => window.removeEventListener("popstate", onPop);
-    }
-  };
-  const onClose = () => {
-    detachPopstate?.();
-    detachPopstate = null;
-    if (routePushed) {
-      routePushed = false;
-      if (deps.routedTo !== void 0) popOurMarker("__bsRouted", deps.routedTo);
-    }
-    if (closeOnBackPushed) {
-      closeOnBackPushed = false;
-      popOurMarker("__bsSheet", deps.sheetId);
+      pushed = true;
+    } catch {
+      pushed = false;
     }
   };
   const unsubscribeOpen = deps.on("open", onOpen);
-  const unsubscribeClose = deps.on("close", onClose);
+  const unsubscribeClose = deps.on("close", teardownEntry);
   if (deps.getSize() > 0) onOpen();
   return () => {
     unsubscribeOpen();
     unsubscribeClose();
-    detachPopstate?.();
-    detachPopstate = null;
-    if (routePushed) {
-      routePushed = false;
-      if (deps.routedTo !== void 0) popOurMarker("__bsRouted", deps.routedTo);
-    }
-    if (closeOnBackPushed) {
-      closeOnBackPushed = false;
-      popOurMarker("__bsSheet", deps.sheetId);
-    }
+    teardownEntry();
+  };
+}
+function installRouteChange(deps) {
+  if (typeof window === "undefined" || typeof history === "undefined") {
+    return () => {
+    };
+  }
+  const onChange = () => {
+    if (deps.isDestroyed() || deps.getSize() <= 0) return;
+    void deps.close();
+  };
+  const wrap = (key) => {
+    const original = history[key];
+    const patched = function(...args) {
+      original.apply(this, args);
+      onChange();
+    };
+    history[key] = patched;
+    return () => {
+      if (history[key] === patched) {
+        history[key] = original;
+      }
+    };
+  };
+  window.addEventListener("popstate", onChange);
+  const restorePush = wrap("pushState");
+  const restoreReplace = wrap("replaceState");
+  return () => {
+    window.removeEventListener("popstate", onChange);
+    restorePush();
+    restoreReplace();
   };
 }
+var closers, handlerInstalled, suppress, ensureHandler, programmaticBack;
 var init_route = __esm({
   "src/core/features/route.ts"() {
+    closers = [];
+    handlerInstalled = false;
+    suppress = 0;
+    ensureHandler = () => {
+      if (handlerInstalled || typeof window === "undefined") return;
+      handlerInstalled = true;
+      window.addEventListener("popstate", () => {
+        if (suppress > 0) {
+          suppress -= 1;
+          return;
+        }
+        let target = null;
+        for (let i = closers.length - 1; i >= 0; i -= 1) {
+          const c = closers[i];
+          if (!c.isOpen()) continue;
+          if (!target) target = c;
+          if (c.isTop()) {
+            target = c;
+            break;
+          }
+        }
+        if (!target) return;
+        target.consumed = true;
+        const idx = closers.indexOf(target);
+        if (idx !== -1) closers.splice(idx, 1);
+        target.close();
+      });
+    };
+    programmaticBack = () => {
+      suppress += 1;
+      try {
+        history.back();
+      } catch {
+        suppress = Math.max(0, suppress - 1);
+      }
+    };
   }
 });
 
@@ -614,13 +693,17 @@ function installResizeObserver(deps) {
     if (viewportSize2 > 0 && viewportSize2 < max) {
       deps.setMaxAxisSize(viewportSize2);
     }
+    const wasAnimating = deps.isAnimating?.() ?? false;
     deps.cancelInFlight();
     deps.newCycle();
     const current = deps.resolveActiveSnap();
     const newMax = deps.getMaxAxisSize();
     const targetSize = current ? Math.min(current.size, newMax) : Math.min(deps.getSize(), newMax);
     deps.setSize(targetSize);
-    if (current && !deps.isDragging()) deps.applySize(targetSize);
+    if (current && !deps.isDragging()) {
+      deps.applySize(targetSize);
+      if (wasAnimating) deps.resyncAfterCancel?.();
+    }
   };
   let resizeObserver = null;
   if (typeof ResizeObserver !== "undefined") {
@@ -762,7 +845,7 @@ var init_devWarn = __esm({
   }
 });
 
-// src/core/controllers/scrim-controller.ts
+// src/core/primitives/overlay-position.ts
 function resolveSheetAnchoredStyle(mode, position, inset) {
   const sizeOffset = `calc(var(--bs-size, 0px) + ${inset})`;
   switch (mode) {
@@ -784,15 +867,69 @@ function resolveSheetAnchoredStyle(mode, position, inset) {
       return { right: sizeOffset, top: "50%", transform: "translateY(-50%)" };
   }
 }
-function applySheetAnchoredPosition(ws, mode, position, inset) {
-  const style = resolveSheetAnchoredStyle(mode, position, inset);
-  if (style.top !== void 0) ws.top = style.top;
-  if (style.bottom !== void 0) ws.bottom = style.bottom;
-  if (style.left !== void 0) ws.left = style.left;
-  if (style.right !== void 0) ws.right = style.right;
-  if (style.transform !== void 0) ws.transform = style.transform;
+function applyOverlayPosition(ws, mode, position, inset) {
+  switch (position) {
+    case "top-left":
+      ws.top = inset;
+      ws.left = inset;
+      break;
+    case "top-center":
+      ws.top = inset;
+      ws.left = "50%";
+      ws.transform = "translateX(-50%)";
+      break;
+    case "top-right":
+      ws.top = inset;
+      ws.right = inset;
+      break;
+    case "center-left":
+      ws.top = "50%";
+      ws.left = inset;
+      ws.transform = "translateY(-50%)";
+      break;
+    case "center":
+      ws.top = "50%";
+      ws.left = "50%";
+      ws.transform = "translate(-50%, -50%)";
+      break;
+    case "center-right":
+      ws.top = "50%";
+      ws.right = inset;
+      ws.transform = "translateY(-50%)";
+      break;
+    case "bottom-left":
+      ws.bottom = inset;
+      ws.left = inset;
+      break;
+    case "bottom-center":
+      ws.bottom = inset;
+      ws.left = "50%";
+      ws.transform = "translateX(-50%)";
+      break;
+    case "bottom-right":
+      ws.bottom = inset;
+      ws.right = inset;
+      break;
+    case "sheet-top-left":
+    case "sheet-top-center":
+    case "sheet-top-right": {
+      const style = resolveSheetAnchoredStyle(mode, position, inset);
+      if (style.top !== void 0) ws.top = style.top;
+      if (style.bottom !== void 0) ws.bottom = style.bottom;
+      if (style.left !== void 0) ws.left = style.left;
+      if (style.right !== void 0) ws.right = style.right;
+      if (style.transform !== void 0) ws.transform = style.transform;
+      break;
+    }
+  }
 }
-var VALID_CSS_LENGTH, ScrimController;
+var init_overlay_position = __esm({
+  "src/core/primitives/overlay-position.ts"() {
+  }
+});
+
+// src/core/controllers/scrim-controller.ts
+var VALID_CSS_LENGTH, DEFAULT_SCRIM_DIM, ScrimController;
 var init_scrim_controller = __esm({
   "src/core/controllers/scrim-controller.ts"() {
     init_types();
@@ -800,7 +937,9 @@ var init_scrim_controller = __esm({
     init_hot_path_thresholds();
     init_opacity_dedup();
     init_devWarn();
+    init_overlay_position();
     VALID_CSS_LENGTH = /^-?\d+(?:\.\d+)?(?:px|em|rem|%)$/;
+    DEFAULT_SCRIM_DIM = "rgba(0, 0, 0, 0.4)";
     ScrimController = class {
       constructor(deps, opts) {
         __publicField(this, "screenComponent");
@@ -811,6 +950,8 @@ var init_scrim_controller = __esm({
         __publicField(this, "getAllowedIds");
         __publicField(this, "getResolvedSnaps");
         __publicField(this, "snapToFn");
+        __publicField(this, "closeFn");
+        __publicField(this, "scrimInteractive", false);
         __publicField(this, "scrimMode");
         __publicField(this, "backdropRange");
         __publicField(this, "screenRange");
@@ -831,14 +972,17 @@ var init_scrim_controller = __esm({
         this.getAllowedIds = deps.getAllowedIds;
         this.getResolvedSnaps = deps.getResolvedSnaps;
         this.snapToFn = deps.snapTo;
+        this.closeFn = deps.close;
         this.scrimMode = opts.scrimMode ?? "full";
         const preset = opts.scrimPreset ? SCRIM_PRESETS[opts.scrimPreset] : null;
         this.backdropRange = opts.backdropRange ?? preset?.range ?? [0, 1];
         this.screenRange = opts.screenRange ?? preset?.range ?? [0, 1];
         this.scrimTapToCloseEnabled = opts.scrimTapToClose ?? false;
+        const explicitColor = opts.scrimColor ?? preset?.color;
+        const effectiveColor = explicitColor ?? (this.scrimMode !== "off" && !this.backdrop ? DEFAULT_SCRIM_DIM : void 0);
         if (this.screenComponent) {
           this.applyScrimStyles({
-            color: opts.scrimColor ?? preset?.color,
+            color: effectiveColor,
             blur: opts.scrimBlur ?? preset?.blur,
             interactive: opts.scrimInteractive ?? preset?.interactive ?? false
           });
@@ -972,11 +1116,15 @@ var init_scrim_controller = __esm({
           }
           const onClick = () => {
             if (this.isDestroyed()) return;
+            if (this.closeFn) {
+              this.closeFn();
+              return;
+            }
             const allowed = this.getAllowedIds();
             const snaps = this.getResolvedSnaps();
             const fallback = allowed.find((id) => {
               const snap = findById(id, snaps);
-              return snap !== null && snap.size > 0;
+              return snap !== null && snap.size === 0;
             });
             if (fallback) this.snapToFn(fallback);
           };
@@ -993,6 +1141,7 @@ var init_scrim_controller = __esm({
         if (this.isDestroyed()) return;
         if (enabled === this.scrimEnabled) return;
         this.scrimEnabled = enabled;
+        this.invalidateOpacityCache();
         if (!enabled) {
           this.savedScrimRanges = {
             screen: this.screenRange,
@@ -1016,7 +1165,12 @@ var init_scrim_controller = __esm({
             blur: cfg.blur ?? null,
             interactive: cfg.interactive
           });
-          this.screenRange = cfg.range;
+          if (!this.scrimEnabled && this.savedScrimRanges) {
+            this.savedScrimRanges = { screen: cfg.range, backdrop: cfg.range };
+          } else {
+            this.screenRange = cfg.range;
+            this.backdropRange = cfg.range;
+          }
         }
         const noop = () => {
         };
@@ -1066,59 +1220,7 @@ var init_scrim_controller = __esm({
         wrapper.className = "bs-scrim-overlay";
         const ws = wrapper.style;
         ws.position = "absolute";
-        switch (position) {
-          case "top-left":
-            ws.top = inset;
-            ws.left = inset;
-            break;
-          case "top-center":
-            ws.top = inset;
-            ws.left = "50%";
-            ws.transform = "translateX(-50%)";
-            break;
-          case "top-right":
-            ws.top = inset;
-            ws.right = inset;
-            break;
-          case "center-left":
-            ws.top = "50%";
-            ws.left = inset;
-            ws.transform = "translateY(-50%)";
-            break;
-          case "center":
-            ws.top = "50%";
-            ws.left = "50%";
-            ws.transform = "translate(-50%, -50%)";
-            break;
-          case "center-right":
-            ws.top = "50%";
-            ws.right = inset;
-            ws.transform = "translateY(-50%)";
-            break;
-          case "bottom-left":
-            ws.bottom = inset;
-            ws.left = inset;
-            break;
-          case "bottom-center":
-            ws.bottom = inset;
-            ws.left = "50%";
-            ws.transform = "translateX(-50%)";
-            break;
-          case "bottom-right":
-            ws.bottom = inset;
-            ws.right = inset;
-            break;
-          case "sheet-top-left":
-          case "sheet-top-center":
-          case "sheet-top-right":
-            applySheetAnchoredPosition(
-              ws,
-              this.mode,
-              position,
-              inset
-            );
-            break;
-        }
+        applyOverlayPosition(ws, this.mode, position, inset);
         if (interactive) {
           ws.pointerEvents = "auto";
         }
@@ -1177,6 +1279,7 @@ var init_scrim_controller = __esm({
           }
         }
         if (opts.interactive !== void 0) {
+          this.scrimInteractive = opts.interactive;
           s.pointerEvents = opts.interactive ? "auto" : "none";
         }
       }
@@ -1191,14 +1294,14 @@ var init_scrim_controller = __esm({
         const s = this.screenComponent.style;
         s.position = "fixed";
         s.inset = insetByMode[this.mode];
-        s.pointerEvents = "none";
+        s.pointerEvents = this.scrimInteractive || this.scrimTapToCloseEnabled ? "auto" : "none";
       }
     };
   }
 });
 
 // src/core/animation/animation.ts
-var easeOutBack, easeOutCubic, easeLinear, easeOutQuint, tween;
+var easeOutBack, easeOutCubic, easeLinear, easeOutQuint, tween, prefersReducedMotion;
 var init_animation = __esm({
   "src/core/animation/animation.ts"() {
     easeOutBack = (t) => {
@@ -1250,6 +1353,10 @@ var init_animation = __esm({
         promise
       };
     };
+    prefersReducedMotion = () => {
+      if (typeof window === "undefined" || !window.matchMedia) return false;
+      return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    };
   }
 });
 
@@ -1285,14 +1392,20 @@ var init_spring = __esm({
           if (cancelled) return;
           const dt = Math.min((now - lastTime) / 1e3, MAX_DT);
           lastTime = now;
-          const subDt = Math.min(dt, 1 / 240);
-          let stepsLeft = Math.max(1, Math.ceil(dt / subDt));
+          const steps = Math.max(1, Math.ceil(dt * 240));
+          const subDt = dt / steps;
+          let stepsLeft = steps;
           while (stepsLeft-- > 0) {
             const force = -cfg.stiffness * (x - to) - cfg.damping * v;
             const accel = force / cfg.mass;
             v += accel * subDt;
             x += v * subDt;
           }
+          if (!Number.isFinite(x) || !Number.isFinite(v)) {
+            onUpdate(to, 0);
+            resolve();
+            return;
+          }
           onUpdate(x, v);
           const isAtRest = Math.abs(to - x) < (cfg.restDelta ?? 0.5) && Math.abs(v) < (cfg.restSpeed ?? 0.5);
           if (isAtRest) {
@@ -1461,7 +1574,7 @@ var init_animation_runner = __esm({
 });
 
 // src/core/lifecycle/focusTrap.ts
-var FOCUSABLE, isVisible, focusables, installFocusTrap;
+var FOCUSABLE, isVisible, focusables, trapStack, installFocusTrap;
 var init_focusTrap = __esm({
   "src/core/lifecycle/focusTrap.ts"() {
     FOCUSABLE = [
@@ -1486,9 +1599,13 @@ var init_focusTrap = __esm({
     focusables = (root) => Array.from(root.querySelectorAll(FOCUSABLE)).filter(
       (el) => !el.hasAttribute("inert") && isVisible(el) && !el.matches("[aria-hidden='true']")
     );
+    trapStack = [];
     installFocusTrap = (container, options = {}) => {
       if (typeof document === "undefined") return () => {
       };
+      const token = {};
+      trapStack.push(token);
+      const isActive = () => trapStack[trapStack.length - 1] === token;
       const previouslyFocused = document.activeElement;
       const focusInitial = () => {
         const initial = typeof options.initialFocus === "string" ? container.querySelector(options.initialFocus) : options.initialFocus ?? focusables(container)[0] ?? container;
@@ -1496,6 +1613,7 @@ var init_focusTrap = __esm({
       };
       focusInitial();
       const handleKey = (e) => {
+        if (!isActive()) return;
         if (e.key === "Escape" && options.onEscape) {
           options.onEscape();
           return;
@@ -1518,6 +1636,7 @@ var init_focusTrap = __esm({
         }
       };
       const handleFocusIn = (e) => {
+        if (!isActive()) return;
         const target = e.target;
         if (target && !container.contains(target)) {
           const list = focusables(container);
@@ -1530,6 +1649,8 @@ var init_focusTrap = __esm({
       return () => {
         if (released) return;
         released = true;
+        const idx = trapStack.indexOf(token);
+        if (idx !== -1) trapStack.splice(idx, 1);
         document.removeEventListener("keydown", handleKey, true);
         document.removeEventListener("focusin", handleFocusIn, true);
         if (previouslyFocused && document.contains(previouslyFocused)) {
@@ -1592,11 +1713,17 @@ function createInertSiblings(rootProvider) {
   return {
     apply() {
       if (typeof document === "undefined") return;
-      const root = rootProvider();
-      const parent = root.parentElement ?? document.body;
+      let top = rootProvider();
+      while (top.parentElement && top.parentElement !== document.body) {
+        top = top.parentElement;
+      }
+      const parent = top.parentElement ?? document.body;
       for (const child of Array.from(parent.children)) {
-        if (child === root) continue;
+        if (child === top) continue;
         if (child.hasAttribute("inert")) continue;
+        if (child.classList.contains("bs-backdrop") || child.classList.contains("bs-screen") || child.classList.contains("bs-root")) {
+          continue;
+        }
         child.setAttribute("inert", "");
         tracked.push(child);
       }
@@ -1622,7 +1749,6 @@ var init_lifecycle_controller = __esm({
     LifecycleController = class {
       constructor(deps, opts) {
         __publicField(this, "element");
-        __publicField(this, "closeFn");
         __publicField(this, "focusTrapEnabled");
         __publicField(this, "initialFocus");
         __publicField(this, "closeOnEscape");
@@ -1636,7 +1762,6 @@ var init_lifecycle_controller = __esm({
         __publicField(this, "installed", false);
         __publicField(this, "destroyed", false);
         this.element = deps.element;
-        this.closeFn = deps.close;
         this.focusTrapEnabled = opts.focusTrap ?? false;
         this.initialFocus = opts.initialFocus;
         this.closeOnEscape = opts.closeOnEscape ?? true;
@@ -1646,6 +1771,9 @@ var init_lifecycle_controller = __esm({
         this.returnFocus = opts.returnFocus;
         this.inertSiblings = createInertSiblings(() => this.element);
       }
+      get isInstalled() {
+        return this.installed;
+      }
       install() {
         if (this.destroyed) return;
         this.installed = true;
@@ -1654,8 +1782,7 @@ var init_lifecycle_controller = __esm({
         }
         if (this.focusTrapEnabled && !this.releaseFocusTrap) {
           this.releaseFocusTrap = installFocusTrap(this.element, {
-            initialFocus: this.initialFocus,
-            onEscape: this.closeOnEscape ? () => void this.closeFn() : void 0
+            initialFocus: this.initialFocus
           });
         }
         if (this.inertSiblingsEnabled && this.shouldApplyInertSiblings()) {
@@ -1675,7 +1802,7 @@ var init_lifecycle_controller = __esm({
         this.releaseScrollLock = null;
         this.inertSiblings.remove();
         if (this.returnFocus) {
-          const target = typeof this.returnFocus === "function" ? this.returnFocus() : this.returnFocus;
+          const target = typeof this.returnFocus === "function" ? this.returnFocus() : typeof this.returnFocus === "string" ? typeof document !== "undefined" ? document.querySelector(this.returnFocus) : null : this.returnFocus;
           target?.focus?.();
         }
       }
@@ -1818,12 +1945,12 @@ var init_gestures = __esm({
 // src/core/primitives/rubber-band.ts
 function rubberBand(overshoot, maxAxisSize) {
   const cap = Math.min(maxAxisSize * 0.15, 80);
-  return Math.sign(overshoot) * Math.pow(Math.abs(overshoot), RUBBER_BAND_FACTOR) * Math.min(6, cap / Math.max(Math.abs(overshoot), 1));
+  if (cap <= 0) return 0;
+  const abs = Math.abs(overshoot);
+  return Math.sign(overshoot) * (cap * abs / (abs + cap));
 }
-var RUBBER_BAND_FACTOR;
 var init_rubber_band = __esm({
   "src/core/primitives/rubber-band.ts"() {
-    RUBBER_BAND_FACTOR = 0.55;
   }
 });
 
@@ -1863,6 +1990,7 @@ var init_gesture_controller = __esm({
         __publicField(this, "dragStartSize", 0);
         __publicField(this, "currentPointerKind", "touch");
         __publicField(this, "keyboardDismissed", false);
+        __publicField(this, "dragSuppressed", false);
         __publicField(this, "dragPayload", { size: 0, delta: 0 });
         this.deps = deps;
       }
@@ -1873,6 +2001,11 @@ var init_gesture_controller = __esm({
         if (this.detach) return this.detach;
         this.detach = installGestures(this.deps.handle, this.deps.mode, {
           onStart: (_coord, kind) => {
+            if (this.deps.getDisableDrag?.()) {
+              this.dragSuppressed = true;
+              return;
+            }
+            this.dragSuppressed = false;
             this.deps.cancelAnimation();
             this.isDragging_ = true;
             this.dragStartSize = this.deps.getDragContext().size;
@@ -1883,6 +2016,7 @@ var init_gesture_controller = __esm({
             this.deps.emit("dragstart", { size: this.dragStartSize });
           },
           onMove: (delta) => {
+            if (this.dragSuppressed) return;
             const ctx = this.deps.getDragContext();
             const { min, max } = ctx.range;
             const maxAxis = ctx.maxAxisSize;
@@ -1906,6 +2040,10 @@ var init_gesture_controller = __esm({
             }
           },
           onEnd: (delta, velocity, kind) => {
+            if (this.dragSuppressed) {
+              this.dragSuppressed = false;
+              return;
+            }
             this.isDragging_ = false;
             this.keyboardDismissed = false;
             this.deps.getRoot()?.removeAttribute("data-dragging");
@@ -1916,9 +2054,17 @@ var init_gesture_controller = __esm({
             this.deps.settleAfterDrag(delta, velocity, kind);
           },
           onCancel: () => {
+            if (this.dragSuppressed) {
+              this.dragSuppressed = false;
+              return;
+            }
             this.isDragging_ = false;
             this.keyboardDismissed = false;
             this.deps.getRoot()?.removeAttribute("data-dragging");
+            this.deps.emit("dragend", {
+              size: this.deps.getDragContext().size,
+              velocity: 0
+            });
             const restoreTo = this.dragStartSize;
             void this.deps.animateTo(restoreTo, 0);
           }
@@ -2003,6 +2149,306 @@ var init_scroll_cache = __esm({
   }
 });
 
+// src/core/primitives/anchor-animations.ts
+function resolveTransitionFrames(spec, phase) {
+  const fallback = { frames: null, duration: 0, easing: DEFAULT_EASING };
+  if (spec === "none") return fallback;
+  if (spec === void 0 || typeof spec === "string") {
+    const preset2 = PRESET_FRAMES[spec ?? "fade"];
+    return {
+      frames: preset2[phase],
+      duration: DEFAULT_DURATION3,
+      easing: DEFAULT_EASING
+    };
+  }
+  const custom = phase === "enter" ? spec.enter : spec.exit;
+  if (custom) {
+    return {
+      frames: custom,
+      duration: spec.duration ?? DEFAULT_DURATION3,
+      easing: spec.easing ?? DEFAULT_EASING
+    };
+  }
+  if (spec.preset === "none") return fallback;
+  const preset = PRESET_FRAMES[spec.preset ?? "fade"];
+  return {
+    frames: preset[phase],
+    duration: spec.duration ?? DEFAULT_DURATION3,
+    easing: spec.easing ?? DEFAULT_EASING
+  };
+}
+function runAnchorTransition(el, spec, phase) {
+  const respectReduced = typeof spec === "object" ? spec.respectReducedMotion !== false : true;
+  if (respectReduced && prefersReducedMotion()) return INSTANT;
+  const { frames, duration, easing } = resolveTransitionFrames(spec, phase);
+  if (!frames || duration <= 0) return INSTANT;
+  if (typeof el.animate !== "function") return INSTANT;
+  const animation = el.animate(frames, {
+    duration,
+    easing,
+    fill: "both"
+  });
+  const finished = animation.finished.then(() => void 0).catch(() => void 0);
+  return {
+    finished,
+    cancel: () => {
+      try {
+        animation.cancel();
+      } catch {
+        return;
+      }
+    }
+  };
+}
+var DEFAULT_DURATION3, DEFAULT_EASING, PRESET_FRAMES, INSTANT;
+var init_anchor_animations = __esm({
+  "src/core/primitives/anchor-animations.ts"() {
+    init_animation();
+    DEFAULT_DURATION3 = 200;
+    DEFAULT_EASING = "cubic-bezier(0.22, 1, 0.36, 1)";
+    PRESET_FRAMES = {
+      fade: {
+        enter: [{ opacity: 0 }, { opacity: 1 }],
+        exit: [{ opacity: 1 }, { opacity: 0 }]
+      },
+      scale: {
+        enter: [
+          { opacity: 0, transform: "scale(0.85)" },
+          { opacity: 1, transform: "scale(1)" }
+        ],
+        exit: [
+          { opacity: 1, transform: "scale(1)" },
+          { opacity: 0, transform: "scale(0.85)" }
+        ]
+      },
+      slide: {
+        enter: [
+          { opacity: 0, transform: "translateY(10px)" },
+          { opacity: 1, transform: "translateY(0)" }
+        ],
+        exit: [
+          { opacity: 1, transform: "translateY(0)" },
+          { opacity: 0, transform: "translateY(10px)" }
+        ]
+      },
+      pop: {
+        enter: [
+          { opacity: 0, transform: "scale(0.6)", offset: 0 },
+          { opacity: 1, transform: "scale(1.06)", offset: 0.7 },
+          { opacity: 1, transform: "scale(1)", offset: 1 }
+        ],
+        exit: [
+          { opacity: 1, transform: "scale(1)" },
+          { opacity: 0, transform: "scale(0.6)" }
+        ]
+      }
+    };
+    INSTANT = {
+      finished: Promise.resolve(),
+      cancel: () => {
+      }
+    };
+  }
+});
+
+// src/core/features/sheet-anchors.ts
+function attachAnchor(deps, opts) {
+  const doc = deps.host.ownerDocument;
+  const wrapper = doc.createElement("div");
+  wrapper.className = "bs-anchor";
+  const interactive = opts.interactive ?? true;
+  const position = opts.position ?? "sheet-top-right";
+  const isDock = position === "dock-bottom" || position === "dock-top";
+  const ws = wrapper.style;
+  ws.position = "fixed";
+  if (isDock) {
+    ws.left = "0";
+    ws.right = "0";
+    if (position === "dock-bottom") {
+      ws.bottom = "0";
+    } else {
+      ws.top = "0";
+    }
+  } else {
+    applyOverlayPosition(ws, deps.mode, position, opts.inset ?? "16px");
+  }
+  if (opts.fadeRange) {
+    const [r0, r1] = opts.fadeRange;
+    const span = Math.max(r1 - r0, 1e-4);
+    ws.opacity = `clamp(0, calc((var(--bs-progress, 0) - ${r0}) / ${span}), 1)`;
+  }
+  wrapper.appendChild(opts.element);
+  deps.host.appendChild(wrapper);
+  let visible = null;
+  let inFlight = null;
+  const shouldShow = (state) => {
+    if (typeof opts.showOn === "function") return opts.showOn(state);
+    if (Array.isArray(opts.showOn)) return opts.showOn.includes(state.activeId);
+    return isDock || state.size > 0;
+  };
+  const applyVisibility = (next, animate) => {
+    if (next === visible) return;
+    visible = next;
+    inFlight?.cancel();
+    inFlight = null;
+    wrapper.style.pointerEvents = next && interactive ? "auto" : "none";
+    if (next) {
+      wrapper.style.visibility = "";
+      if (animate) {
+        inFlight = runAnchorTransition(opts.element, opts.animation, "enter");
+      }
+      return;
+    }
+    if (!animate) {
+      wrapper.style.visibility = "hidden";
+      return;
+    }
+    const handle = runAnchorTransition(opts.element, opts.animation, "exit");
+    inFlight = handle;
+    void handle.finished.then(() => {
+      if (inFlight === handle && visible === false) {
+        wrapper.style.visibility = "hidden";
+      }
+    });
+  };
+  const evaluate = (animate) => {
+    if (deps.isDestroyed()) return;
+    applyVisibility(shouldShow(deps.getState()), animate);
+  };
+  const offs = [
+    deps.on("snap", () => evaluate(true)),
+    deps.on("open", () => evaluate(true)),
+    deps.on("close", () => evaluate(true))
+  ];
+  evaluate(false);
+  return {
+    wrapper,
+    detach: () => {
+      offs.forEach((off) => off());
+      inFlight?.cancel();
+      inFlight = null;
+      if (wrapper.parentNode) wrapper.parentNode.removeChild(wrapper);
+    },
+    syncZ: (z) => {
+      wrapper.style.zIndex = String(z);
+    }
+  };
+}
+var init_sheet_anchors = __esm({
+  "src/core/features/sheet-anchors.ts"() {
+    init_overlay_position();
+    init_anchor_animations();
+  }
+});
+
+// src/core/features/scrim-stages.ts
+function installScrimStages(deps, opts) {
+  const doc = deps.host.ownerDocument;
+  const entries = opts.stages.map((def) => {
+    const wrapper = doc.createElement("div");
+    wrapper.className = "bs-scrim-stage";
+    const ws = wrapper.style;
+    ws.position = "absolute";
+    applyOverlayPosition(
+      ws,
+      deps.mode,
+      def.position ?? opts.position ?? "center",
+      def.inset ?? opts.inset ?? "16px"
+    );
+    ws.visibility = "hidden";
+    ws.pointerEvents = "none";
+    wrapper.appendChild(def.element);
+    deps.host.appendChild(wrapper);
+    return { def, wrapper, inFlight: null };
+  });
+  let active = null;
+  const resolveActive = () => {
+    const state = deps.getState();
+    if (state.size === 0) {
+      return entries.find((e) => matchesId(e.def, state.activeId)) ?? null;
+    }
+    return entries.find((e) => matchesId(e.def, state.activeId)) ?? entries.find((e) => matchesRange(e.def, state.progress)) ?? null;
+  };
+  const hide = (entry, animate) => {
+    entry.inFlight?.cancel();
+    entry.wrapper.style.pointerEvents = "none";
+    if (!animate) {
+      entry.inFlight = null;
+      entry.wrapper.style.visibility = "hidden";
+      return;
+    }
+    const handle = runAnchorTransition(
+      entry.def.element,
+      entry.def.animation ?? opts.animation,
+      "exit"
+    );
+    entry.inFlight = handle;
+    void handle.finished.then(() => {
+      if (entry.inFlight === handle && active !== entry) {
+        entry.wrapper.style.visibility = "hidden";
+      }
+    });
+  };
+  const show = (entry, animate) => {
+    entry.inFlight?.cancel();
+    entry.inFlight = null;
+    entry.wrapper.style.visibility = "";
+    entry.wrapper.style.pointerEvents = entry.def.interactive ?? opts.interactive ?? false ? "auto" : "none";
+    if (animate) {
+      entry.inFlight = runAnchorTransition(
+        entry.def.element,
+        entry.def.animation ?? opts.animation,
+        "enter"
+      );
+    }
+  };
+  const update = (animate) => {
+    if (deps.isDestroyed()) return;
+    const next = resolveActive();
+    if (next === active) return;
+    const prev = active;
+    active = next;
+    if (prev) hide(prev, animate);
+    if (next) show(next, animate);
+  };
+  const offs = [
+    deps.on("snap", () => update(true)),
+    deps.on("open", () => update(true)),
+    deps.on("close", () => update(true))
+  ];
+  if (entries.some((e) => e.def.forRange)) {
+    offs.push(deps.on("progress", () => update(true)));
+  }
+  update(false);
+  return () => {
+    offs.forEach((off) => off());
+    for (const entry of entries) {
+      entry.inFlight?.cancel();
+      entry.inFlight = null;
+      if (entry.wrapper.parentNode) {
+        entry.wrapper.parentNode.removeChild(entry.wrapper);
+      }
+    }
+    active = null;
+  };
+}
+var matchesId, matchesRange;
+var init_scrim_stages = __esm({
+  "src/core/features/scrim-stages.ts"() {
+    init_overlay_position();
+    init_anchor_animations();
+    matchesId = (def, activeId) => {
+      if (def.for === void 0) return false;
+      return Array.isArray(def.for) ? def.for.includes(activeId) : def.for === activeId;
+    };
+    matchesRange = (def, progress) => {
+      if (!def.forRange) return false;
+      const [from, to] = def.forRange;
+      return progress >= from && progress <= to;
+    };
+  }
+});
+
 // src/core/primitives/engine-options.ts
 function resolveEngineOptions(opts, extras) {
   const initialAllowed = opts.allowed ?? opts.snapPoints.map((p) => p.id);
@@ -2019,6 +2465,12 @@ function resolveEngineOptions(opts, extras) {
     dragThreshold: opts.dragThreshold ?? DEFAULT_DRAG_THRESHOLD,
     rubberBandEnabled: opts.rubberBand ?? true,
     closeOnBack: opts.closeOnBack ?? false,
+    persistent: opts.persistent ?? false,
+    disableClose: opts.disableClose ?? false,
+    disableDrag: opts.disableDrag ?? false,
+    closeOnRouteChange: opts.closeOnRouteChange ?? false,
+    radius: opts.radius,
+    maxHeight: opts.maxHeight,
     initialAllowed,
     initialId,
     scrim: {
@@ -2045,7 +2497,8 @@ function resolveEngineOptions(opts, extras) {
       closeOnEscape: opts.closeOnEscape,
       lockBodyScroll: opts.lockBodyScroll,
       inertSiblings: opts.inertSiblings,
-      shouldApplyInertSiblings: extras?.shouldApplyInertSiblings
+      shouldApplyInertSiblings: extras?.shouldApplyInertSiblings,
+      returnFocus: opts.returnFocusTo
     }
   };
 }
@@ -2083,6 +2536,8 @@ var init_BottomSheetEngine = __esm({
     init_aria_slider_writer();
     init_hot_path_thresholds();
     init_scroll_cache();
+    init_sheet_anchors();
+    init_scrim_stages();
     init_engine_options();
     init_opacity_dedup();
     HAPTIC_DURATION_MS = 8;
@@ -2124,6 +2579,11 @@ var init_BottomSheetEngine = __esm({
         __publicField(this, "lifecycle");
         __publicField(this, "closeOnBack");
         __publicField(this, "routedTo");
+        __publicField(this, "persistent");
+        __publicField(this, "disableCloseFlag");
+        __publicField(this, "disableDragFlag");
+        __publicField(this, "closeOnRouteChange");
+        __publicField(this, "maxHeightCap");
         __publicField(this, "snapPointsRaw");
         __publicField(this, "snaps");
         __publicField(this, "activeId");
@@ -2136,6 +2596,7 @@ var init_BottomSheetEngine = __esm({
         __publicField(this, "sizeWriteSentinel", new WriteSentinel());
         __publicField(this, "progressWriteSentinel", new WriteSentinel());
         __publicField(this, "isTopSheet", true);
+        __publicField(this, "opening", false);
         __publicField(this, "progressPayload", {
           value: 0,
           size: 0
@@ -2151,6 +2612,12 @@ var init_BottomSheetEngine = __esm({
         __publicField(this, "linkedSheets", []);
         __publicField(this, "scrollCache");
         __publicField(this, "teardowns", new TeardownStack());
+        __publicField(this, "anchors", []);
+        __publicField(this, "anchorHost", null);
+        __publicField(this, "stackZ", 100);
+        __publicField(this, "detachScrimStages", null);
+        __publicField(this, "stackEffectEnabled", false);
+        __publicField(this, "stackEffectPrimed", false);
         __publicField(this, "transformTemplate");
         const resolved = resolveEngineOptions(opts, {
           shouldApplyInertSiblings: () => {
@@ -2184,6 +2651,10 @@ var init_BottomSheetEngine = __esm({
             getResolvedSnaps: () => this.snaps.getResolvedSnaps().slice(),
             snapTo: (id) => {
               void this.snapTo(id);
+            },
+            close: () => {
+              if (!this.canDismiss()) return;
+              void this.close("backdrop");
             }
           },
           resolved.scrim
@@ -2207,6 +2678,11 @@ var init_BottomSheetEngine = __esm({
         );
         this.closeOnBack = resolved.closeOnBack;
         this.routedTo = opts.routedTo;
+        this.persistent = resolved.persistent;
+        this.disableCloseFlag = resolved.disableClose;
+        this.disableDragFlag = resolved.disableDrag;
+        this.closeOnRouteChange = resolved.closeOnRouteChange;
+        this.stackEffectEnabled = opts.stackEffect ?? false;
         this.snapPointsRaw = opts.snapPoints;
         this.persistKey = opts.persistKey;
         if (opts.linkedSheets) {
@@ -2219,7 +2695,7 @@ var init_BottomSheetEngine = __esm({
           this.snapPointsRaw,
           resolved.initialAllowed,
           this.mode,
-          () => this.handle.offsetHeight,
+          () => this.measureFitSize(),
           (maxAxisSize) => {
             this.element.style[layoutAxis(this.mode)] = `${maxAxisSize}px`;
           }
@@ -2253,6 +2729,19 @@ var init_BottomSheetEngine = __esm({
           io.observe(this.element);
           this.teardowns.add(() => io.disconnect());
         }
+        this.installFitObserver();
+        if (resolved.radius !== void 0) this.setRadius(resolved.radius);
+        if (resolved.maxHeight !== void 0) this.setMaxHeight(resolved.maxHeight);
+        this.applyAutoAriaLabelledBy();
+        if (this.closeOnRouteChange) {
+          this.teardowns.add(
+            installRouteChange({
+              isDestroyed: () => this.destroyed,
+              getSize: () => this.size,
+              close: () => this.close()
+            })
+          );
+        }
         if (this.persistKey) {
           this.teardowns.add(installPersist(this, this.persistKey));
         }
@@ -2277,7 +2766,7 @@ var init_BottomSheetEngine = __esm({
             isTopSheet: () => this.isTopSheet,
             getSize: () => this.size,
             isDestroyed: () => this.destroyed,
-            close: () => this.close(),
+            close: () => this.close("back"),
             on: (event, fn) => this.on(event, fn),
             sheetId: this.id
           })
@@ -2371,6 +2860,10 @@ var init_BottomSheetEngine = __esm({
         const previousSize = this.size;
         this.scrollCache.cache(previousId, previousSize, target.size);
         this.activeId = id;
+        if (wasClosed && target.size > 0) {
+          this.opening = true;
+          sheetStack.promote(this.id);
+        }
         if (this.animation.viewTransitionsAvailable) {
           this.currentViewTransition?.skipTransition?.();
           const vt = document.startViewTransition(() => {
@@ -2385,19 +2878,26 @@ var init_BottomSheetEngine = __esm({
         } else {
           await this.animation.animateTo(target.size, velocityPxPerMs);
         }
+        this.opening = false;
         externalSignal?.removeEventListener("abort", onExternalAbort);
         if (signal.aborted) return;
         this.scrollCache.restore(id, previousSize, target.size);
         this.updateAriaSlider();
-        this.emit("snap", { id, size: target.size });
+        this.emit("snap", {
+          id,
+          size: target.size,
+          progress: this.computeProgress(target.size)
+        });
         if (wasClosed && target.size > 0) {
           this.emit("open", { id });
           this.handleOpen();
           notifyLinkedSheets(this.linkedSheets, this);
+          this.emit("opened", { id });
         }
         if (target.size === 0) {
           this.emit("close", void 0);
           this.handleClose();
+          this.emit("closed", void 0);
         }
       }
       async dragTo(targetSize, velocityOrOpts = 0) {
@@ -2422,18 +2922,76 @@ var init_BottomSheetEngine = __esm({
         const target = id ?? this.snaps.getAllowedIds().find((a) => a !== "closed") ?? this.activeId;
         return this.snapTo(target);
       }
-      close() {
+      close(reason = "programmatic") {
         if (this.destroyed) return Promise.resolve();
+        if (this.disableCloseFlag) return Promise.resolve();
+        if (this.size > 0 && this.emitBeforeClose(reason)) return Promise.resolve();
         const closedId = this.snapPointsRaw.find((p) => p.id === "closed")?.id ?? this.snaps.getAllowedIds()[0];
         return this.snapTo(closedId ?? this.activeId);
       }
-      setAllowed(ids, snap) {
+      canDismiss() {
+        return !this.persistent && !this.disableCloseFlag && !this.destroyed;
+      }
+      isTop() {
+        return this.isTopSheet;
+      }
+      depth() {
+        return sheetStack.depthOf(this.id);
+      }
+      expand() {
+        if (this.destroyed) return Promise.resolve();
+        const ids = this.allowedIdsBySize();
+        const target = ids[ids.length - 1];
+        if (!target) return Promise.resolve();
+        return this.snapTo(target);
+      }
+      collapse() {
+        if (this.destroyed) return Promise.resolve();
+        const ids = this.allowedIdsBySize();
+        const nonZero = ids.find((id) => (this.snaps.findById(id)?.size ?? 0) > 0);
+        const target = nonZero ?? ids[0];
+        if (!target) return Promise.resolve();
+        return this.snapTo(target);
+      }
+      setRadius(r) {
         if (this.destroyed) return;
-        const willSnap = snap !== void 0 && ids.includes(snap) || !ids.includes(this.activeId) && ids.length > 0;
-        if (!willSnap) {
-          this.animation.cancel();
-          this.newCycle();
+        this.element.style.setProperty(
+          "--bs-radius",
+          typeof r === "number" ? `${r}px` : r
+        );
+      }
+      setMaxHeight(h) {
+        if (this.destroyed) return;
+        const value = typeof h === "number" ? `${h}px` : h;
+        const axis = layoutAxis(this.mode);
+        this.element.style.setProperty(
+          axis === "height" ? "maxHeight" : "maxWidth",
+          value
+        );
+        if (typeof h === "number") {
+          this.maxHeightCap = h;
+          this.clampToMaxHeight();
+        } else if (typeof window !== "undefined") {
+          const probe2 = document.createElement("div");
+          probe2.style.cssText = `position:absolute;visibility:hidden;pointer-events:none;${axis === "height" ? "height" : "width"}:${value};`;
+          document.body.appendChild(probe2);
+          const measured = axis === "height" ? probe2.offsetHeight : probe2.offsetWidth;
+          probe2.remove();
+          this.maxHeightCap = measured > 0 ? measured : void 0;
+          this.clampToMaxHeight();
+        }
+      }
+      clampToMaxHeight() {
+        if (this.maxHeightCap === void 0) return;
+        if (this.snaps.getMaxAxisSize() > this.maxHeightCap) {
+          this.snaps.setMaxAxisSize(this.maxHeightCap);
+        }
+        if (this.size > this.maxHeightCap && !this.gesture?.isDragging) {
+          this.applySize(this.maxHeightCap);
         }
+      }
+      setAllowed(ids, snap) {
+        if (this.destroyed) return;
         this.snaps.setAllowedIds(ids);
         this.updateAriaSlider();
         if (snap && ids.includes(snap)) {
@@ -2473,6 +3031,79 @@ var init_BottomSheetEngine = __esm({
       setScrimOverlay(opts) {
         return this.scrim.setScrimOverlay(opts);
       }
+      addAnchor(opts) {
+        if (this.destroyed || typeof document === "undefined") return () => {
+        };
+        if (!this.anchorHost) {
+          this.anchorHost = this.rootEl ?? this.element.parentElement ?? document.body;
+          this.anchorHost.style.setProperty("--bs-size", `${this.size}px`);
+          this.anchorHost.style.setProperty(
+            "--bs-progress",
+            String(this.computeProgress(this.size))
+          );
+        }
+        const handle = attachAnchor(
+          {
+            mode: this.mode,
+            host: this.anchorHost,
+            getState: () => ({
+              activeId: this.activeId,
+              size: this.size,
+              progress: this.computeProgress(this.size)
+            }),
+            on: (event, fn) => this.on(event, fn),
+            isDestroyed: () => this.destroyed
+          },
+          opts
+        );
+        handle.syncZ(this.stackZ + 1);
+        this.anchors.push(handle);
+        const detach = () => {
+          const idx = this.anchors.indexOf(handle);
+          if (idx === -1) return;
+          this.anchors.splice(idx, 1);
+          handle.detach();
+        };
+        this.teardowns.add(detach);
+        return detach;
+      }
+      setScrimStages(opts) {
+        if (this.destroyed || typeof document === "undefined") return () => {
+        };
+        this.detachScrimStages?.();
+        this.detachScrimStages = null;
+        if (!opts) return () => {
+        };
+        const host = this.screenComponent?.parentElement;
+        if (!host) {
+          console.warn(
+            "[BottomSheet] setScrimStages: no scrim element mounted \u2014 pass `scrim` to the engine first."
+          );
+          return () => {
+          };
+        }
+        const detachInstalled = installScrimStages(
+          {
+            mode: this.mode,
+            host,
+            getState: () => ({
+              activeId: this.activeId,
+              size: this.size,
+              progress: this.computeProgress(this.size)
+            }),
+            on: (event, fn) => this.on(event, fn),
+            isDestroyed: () => this.destroyed
+          },
+          opts
+        );
+        const detach = () => {
+          if (this.detachScrimStages === detach) this.detachScrimStages = null;
+          detachInstalled();
+        };
+        this.detachScrimStages = detach;
+        this.teardowns.add(() => this.detachScrimStages?.());
+        return detach;
+      }
       getScrimState() {
         return { mode: this.scrim.scrimMode, enabled: this.scrim.scrimEnabled };
       }
@@ -2492,8 +3123,53 @@ var init_BottomSheetEngine = __esm({
         }
         this.updateAriaSlider();
       }
+      recompute() {
+        if (this.destroyed) return;
+        this.snaps.recompute();
+        this.scrim.invalidateOpacityCache();
+        if (this.gesture?.isDragging) return;
+        const current = this.snaps.findById(this.activeId);
+        if (current) {
+          this.size = current.size;
+          this.applySize(this.size);
+          this.updateAriaSlider();
+        }
+      }
+      measureFitSize() {
+        const vertical = layoutAxis(this.mode) === "height";
+        const handleSize = vertical ? this.handle.offsetHeight : this.handle.offsetWidth;
+        const content = this.scrollContainer;
+        const natural = content ? handleSize + (vertical ? content.scrollHeight : content.scrollWidth) : handleSize;
+        if (typeof window === "undefined") return natural;
+        const viewport = vertical ? window.innerHeight : window.innerWidth;
+        return viewport > 0 ? Math.min(natural, viewport) : natural;
+      }
+      installFitObserver() {
+        if (typeof ResizeObserver === "undefined") return;
+        if (!this.snapPointsRaw.some((p) => p.size === "fit" || p.size === "content"))
+          return;
+        const targets = [this.handle];
+        if (this.scrollContainer && this.scrollContainer !== this.handle) {
+          targets.push(this.scrollContainer);
+        }
+        let raf = 0;
+        const ro = new ResizeObserver(() => {
+          if (raf) return;
+          raf = requestAnimationFrame(() => {
+            raf = 0;
+            if (this.destroyed || this.gesture?.isDragging) return;
+            this.recompute();
+          });
+        });
+        for (const t of targets) ro.observe(t);
+        this.teardowns.add(() => {
+          ro.disconnect();
+          if (raf) cancelAnimationFrame(raf);
+        });
+      }
       destroy() {
         this.destroyed = true;
+        this.opening = false;
         this.currentAbort.abort();
         this.currentViewTransition?.skipTransition?.();
         this.currentViewTransition = null;
@@ -2543,6 +3219,36 @@ var init_BottomSheetEngine = __esm({
         frozen = true;
         return cancelled;
       }
+      emitBeforeClose(reason) {
+        let cancelled = false;
+        let frozen = false;
+        this.emit("before-close", {
+          reason,
+          cancel: () => {
+            if (frozen) {
+              console.warn(
+                "[BottomSheet] before-close.cancel() called asynchronously \u2014 ignored. cancel() must be invoked synchronously inside the listener."
+              );
+              return;
+            }
+            cancelled = true;
+          }
+        });
+        frozen = true;
+        return cancelled;
+      }
+      applyAutoAriaLabelledBy() {
+        if (typeof document === "undefined") return;
+        if (!this.lifecycle.focusTrapEnabled) return;
+        if (this.element.getAttribute("aria-labelledby")) return;
+        const scope = this.handle ?? this.element;
+        const titled = scope.querySelector("[data-bs-title]") ?? scope.querySelector("h1,h2,h3,h4,h5,h6");
+        if (!titled) return;
+        if (!titled.id) {
+          titled.id = nextInstanceId("bs-title");
+        }
+        this.element.setAttribute("aria-labelledby", titled.id);
+      }
       recomputeSnaps() {
         const seen = /* @__PURE__ */ new Set();
         for (const p of this.snapPointsRaw) {
@@ -2559,24 +3265,42 @@ var init_BottomSheetEngine = __esm({
       getAllowedRange() {
         return this.snaps.getAllowedRange();
       }
+      allowedIdsBySize() {
+        return this.snaps.getAllowedIds().slice().sort(
+          (a, b) => (this.snaps.findById(a)?.size ?? 0) - (this.snaps.findById(b)?.size ?? 0)
+        );
+      }
       updateAriaSlider() {
-        this.aria.setValue(this.snaps.getAllowedIds(), this.activeId);
+        this.aria.setValue(this.allowedIdsBySize(), this.activeId);
       }
       registerInStack() {
         this.teardowns.add(sheetStack.push({
           id: this.id,
           setZIndex: (z) => {
+            this.stackZ = z;
             this.element.style.zIndex = String(z);
             if (this.backdrop) this.backdrop.style.zIndex = String(z - 1);
+            for (const anchor of this.anchors) anchor.syncZ(z + 1);
           },
           setIsTop: (isTop) => {
             this.isTopSheet = isTop;
-            if (this.backdrop) {
-              this.backdrop.style.display = isTop ? "" : "none";
-            }
-          }
+          },
+          isOpen: () => this.size > 0 || this.opening,
+          setDepth: (depth) => this.applyStackDepth(depth)
         }));
       }
+      applyStackDepth(depth) {
+        if (!this.stackEffectEnabled) return;
+        this.element.setAttribute("data-stack-depth", String(depth));
+        if (!this.stackEffectPrimed) {
+          this.stackEffectPrimed = true;
+          const isVertical = this.mode === "bottom" || this.mode === "top";
+          this.element.style.transformOrigin = isVertical ? "50% 100%" : "0% 50%";
+          this.element.style.transition = "scale 320ms cubic-bezier(0.29, 1.04, 0.84, 0.99)";
+        }
+        const scale = Math.max(1 - depth * 0.04, 0.86);
+        this.element.style.scale = scale === 1 ? "" : String(scale);
+      }
       attach() {
         this.gesture = new GestureController({
           handle: this.handle,
@@ -2593,6 +3317,7 @@ var init_BottomSheetEngine = __esm({
             buf.rubberBandEnabled = this.rubberBandEnabled;
             return buf;
           },
+          getDisableDrag: () => this.disableDragFlag,
           cancelAnimation: () => this.animation.cancel(),
           applySize: (size) => this.applySize(size),
           animateTo: (size, velocity) => this.animation.animateTo(size, velocity),
@@ -2636,7 +3361,7 @@ var init_BottomSheetEngine = __esm({
             container: this.scrollContainer,
             isDragging: () => this.gesture?.isDragging ?? false,
             isAnimating: () => this.animation.isAnimating,
-            getAllowedIds: () => this.snaps.getAllowedIds(),
+            getAllowedIds: () => this.allowedIdsBySize(),
             getActiveId: () => this.activeId,
             snapTo: (id) => {
               void this.snapTo(id);
@@ -2665,13 +3390,16 @@ var init_BottomSheetEngine = __esm({
             },
             newCycle: () => {
               this.newCycle();
-            }
+            },
+            isAnimating: () => this.animation.isAnimating,
+            resyncAfterCancel: () => this.resyncAfterResize()
           }));
           if (this.lifecycle.closeOnEscape) {
             const onKey = (e) => {
-              if (this.destroyed) return;
+              if (this.destroyed || e.defaultPrevented) return;
+              if (!this.canDismiss()) return;
               if (e.key === "Escape" && this.isTopSheet && this.size > 0) {
-                void this.close();
+                void this.close("escape");
               }
             };
             document.addEventListener("keydown", onKey);
@@ -2701,7 +3429,7 @@ var init_BottomSheetEngine = __esm({
           handle: this.handle,
           mode: this.mode,
           isDestroyed: () => this.destroyed,
-          getAllowedIds: () => this.snaps.getAllowedIds(),
+          getAllowedIds: () => this.allowedIdsBySize(),
           getActiveId: () => this.activeId,
           snapTo: (id) => {
             void this.snapTo(id);
@@ -2722,6 +3450,7 @@ var init_BottomSheetEngine = __esm({
         });
         if (!target) return;
         const previousId = this.activeId;
+        if (target.id === previousId && target.size === this.size) return;
         if (this.emitBeforeSnap(target, previousId)) {
           const restore = this.snaps.findById(previousId);
           if (restore) {
@@ -2730,21 +3459,34 @@ var init_BottomSheetEngine = __esm({
           return;
         }
         const previousSize = this.size;
+        const previousSnapSize = this.snaps.findById(previousId)?.size;
         this.scrollCache.cache(previousId, previousSize, target.size);
         this.activeId = target.id;
+        if (previousSnapSize === 0 && target.size > 0) {
+          this.opening = true;
+          sheetStack.promote(this.id);
+        }
         void this.animation.animateTo(target.size, velocity).then(() => {
+          this.opening = false;
           if (signal.aborted) return;
           this.scrollCache.restore(target.id, previousSize, target.size);
           this.updateAriaSlider();
-          this.emit("snap", { id: target.id, size: target.size });
+          this.emit("snap", {
+            id: target.id,
+            size: target.size,
+            progress: this.computeProgress(target.size)
+          });
           this.haptic();
-          if (previousId === "closed" && target.size > 0) {
+          if (previousSnapSize === 0 && target.size > 0) {
             this.emit("open", { id: target.id });
             this.handleOpen();
+            notifyLinkedSheets(this.linkedSheets, this);
+            this.emit("opened", { id: target.id });
           }
           if (target.size === 0) {
             this.emit("close", void 0);
             this.handleClose();
+            this.emit("closed", void 0);
           }
         });
       }
@@ -2766,6 +3508,9 @@ var init_BottomSheetEngine = __esm({
           if (this.scrimParent) {
             this.scrimParent.style.setProperty("--bs-size", `${size}px`);
           }
+          if (this.anchorHost && this.anchorHost !== this.scrimParent) {
+            this.anchorHost.style.setProperty("--bs-size", `${size}px`);
+          }
         }
         const progress = this.computeProgress(size);
         const progressChanged = this.progressWriteSentinel.shouldWrite(
@@ -2774,6 +3519,9 @@ var init_BottomSheetEngine = __esm({
         );
         if (progressChanged) {
           style.setProperty("--bs-progress", String(progress));
+          if (this.anchorHost) {
+            this.anchorHost.style.setProperty("--bs-progress", String(progress));
+          }
         }
         this.scrim.applyOpacity(progress, progressChanged);
         if (progressChanged && this.bus.listenerCount("progress") > 0) {
@@ -2788,6 +3536,7 @@ var init_BottomSheetEngine = __esm({
         return Math.min(Math.max((size - min) / (max - min), 0), 1);
       }
       handleOpen() {
+        sheetStack.promote(this.id);
         try {
           this.lifecycle.install();
         } catch (err) {
@@ -2801,8 +3550,31 @@ var init_BottomSheetEngine = __esm({
           });
         }
       }
+      resyncAfterResize() {
+        if (this.destroyed) return;
+        const target = this.snaps.findById(this.activeId);
+        if (!target) return;
+        this.updateAriaSlider();
+        this.emit("snap", {
+          id: target.id,
+          size: target.size,
+          progress: this.computeProgress(target.size)
+        });
+        if (target.size > 0 && !this.lifecycle.isInstalled) {
+          this.emit("open", { id: target.id });
+          this.handleOpen();
+          notifyLinkedSheets(this.linkedSheets, this);
+          this.emit("opened", { id: target.id });
+        } else if (target.size === 0 && this.lifecycle.isInstalled) {
+          this.emit("close", void 0);
+          this.handleClose();
+          this.emit("closed", void 0);
+        }
+      }
       handleClose() {
+        this.opening = false;
         this.lifecycle.release();
+        sheetStack.update();
       }
     };
   }
@@ -2812,7 +3584,7 @@ var init_BottomSheetEngine = __esm({
 var baseStyles;
 var init_baseStyles = __esm({
   "src/web-component/baseStyles.ts"() {
-    baseStyles = `:where(.bs-root){--bs-surface:#ffffff;--bs-surface-border:rgba(225,227,237,1);--bs-shadow:0 -3px 12px rgba(0,0,0,0.12);--bs-radius:20px;--bs-handle-color:#b5b3a8;--bs-handle-width:40px;--bs-handle-height:5px;--bs-z-backdrop:90;--bs-z-sheet:100;--bs-header-min-height:80px;--bs-backdrop-color:rgba(0,0,0,0.5);--bs-scrim-color:rgba(0,0,0,0.4);--bs-scrim-blur:0px;--bs-z-scrim:calc(var(--bs-z-sheet) - 1);--bs-size:0px;--bs-progress:0}.bs-backdrop{position:fixed;inset:0;background:var(--bs-backdrop-color);opacity:0;pointer-events:none;z-index:var(--bs-z-backdrop);transition:opacity 0.15s linear;will-change:opacity}.bs-root[data-dragging="true"] .bs-backdrop,.bs-root[data-animating="true"] .bs-backdrop{transition:none}.bs-sheet{position:fixed;background:var(--bs-surface);box-shadow:var(--bs-shadow);z-index:var(--bs-z-sheet);overflow:hidden;display:flex;flex-direction:column;-webkit-tap-highlight-color:transparent;user-select:none;overscroll-behavior:contain}.bs-sheet[data-mode="bottom"]{left:0;right:0;bottom:0;width:100%;border-top-left-radius:var(--bs-radius);border-top-right-radius:var(--bs-radius);border-top:1px solid var(--bs-surface-border);padding-bottom:env(safe-area-inset-bottom);box-shadow:0 calc(var(--bs-progress,0) * -2px - 3px) calc(var(--bs-progress,0) * 18px + 12px) rgba(0,0,0,calc(var(--bs-progress,0) * 0.15 + 0.12))}.bs-sheet[data-mode="top"]{left:0;right:0;top:0;width:100%;border-bottom-left-radius:var(--bs-radius);border-bottom-right-radius:var(--bs-radius);border-bottom:1px solid var(--bs-surface-border);flex-direction:column-reverse;box-shadow:0 3px 12px rgba(0,0,0,0.12);padding-top:env(safe-area-inset-top)}.bs-sheet[data-mode="left"]{top:0;bottom:0;left:0;height:100%;border-top-right-radius:var(--bs-radius);border-bottom-right-radius:var(--bs-radius);border-right:1px solid var(--bs-surface-border);box-shadow:3px 0 12px rgba(0,0,0,0.12)}.bs-sheet[data-mode="right"]{top:0;bottom:0;right:0;height:100%;border-top-left-radius:var(--bs-radius);border-bottom-left-radius:var(--bs-radius);border-left:1px solid var(--bs-surface-border);box-shadow:-3px 0 12px rgba(0,0,0,0.12)}.bs-sheet[data-mode="left"] .bs-content{padding-right:36px}.bs-sheet[data-mode="right"] .bs-content{padding-left:36px}.bs-handle{flex-shrink:0;min-height:44px;display:flex;flex-direction:column;justify-content:center;padding:8px 16px 4px;cursor:grab;touch-action:none;user-select:none;background:var(--bs-surface);-webkit-tap-highlight-color:transparent;outline:none;position:relative}.bs-handle:active{cursor:grabbing}.bs-handle:focus-visible{outline:2px solid currentColor;outline-offset:-2px;border-radius:var(--bs-radius)}.bs-handle::before{content:"";display:block;width:var(--bs-handle-width);height:var(--bs-handle-height);background:var(--bs-handle-color);border-radius:calc(var(--bs-handle-height) / 2);margin:0 auto 8px;transition:width 0.15s ease,background 0.15s ease,transform 0.15s ease;pointer-events:none}.bs-sheet[data-mode="left"] .bs-handle,.bs-sheet[data-mode="right"] .bs-handle{position:absolute;top:0;bottom:0;width:28px;min-width:0;min-height:0;display:flex;flex-direction:column;align-items:center;justify-content:center;padding:0;background:var(--bs-surface);z-index:1;overflow:hidden}.bs-sheet[data-mode="left"] .bs-handle>*,.bs-sheet[data-mode="right"] .bs-handle>*{display:none}.bs-sheet[data-mode="left"] .bs-handle{right:0;border-left:1px solid var(--bs-surface-border)}.bs-sheet[data-mode="right"] .bs-handle{left:0;border-right:1px solid var(--bs-surface-border)}.bs-sheet[data-mode="left"] .bs-handle::before,.bs-sheet[data-mode="right"] .bs-handle::before{width:var(--bs-handle-height);height:var(--bs-handle-width);margin:0}.bs-sheet:hover .bs-handle::before{background:color-mix(in oklab,var(--bs-handle-color),#000 15%)}.bs-handle:active::before{background:color-mix(in oklab,var(--bs-handle-color),#000 35%);transform:scaleX(1.15)}.bs-handle.bs-handle--ticks::after{content:"";display:block;position:absolute;left:50%;bottom:6px;transform:translateX(-50%);width:calc(var(--bs-handle-width) * 2);height:3px;background-image:radial-gradient( circle,var(--bs-handle-color) 0 1.5px,transparent 1.6px );background-size:8px 3px;background-repeat:repeat-x;background-position:center;opacity:0;transition:opacity 0.18s ease-out;pointer-events:none}.bs-root[data-dragging="true"] .bs-handle.bs-handle--ticks::after{opacity:0.4}.bs-sheet[data-mode="top"] .bs-handle.bs-handle--ticks::after{bottom:auto;top:6px}.bs-sheet[data-mode="left"] .bs-handle.bs-handle--ticks::after,.bs-sheet[data-mode="right"] .bs-handle.bs-handle--ticks::after{left:50%;top:50%;bottom:auto;transform:translate(-50%,-50%);width:3px;height:calc(var(--bs-handle-width) * 2);background-size:3px 8px;background-repeat:repeat-y;margin-left:calc(var(--bs-handle-height) + 6px)}.bs-sheet[data-mode="right"] .bs-handle.bs-handle--ticks::after{margin-left:calc(-1 * (var(--bs-handle-height) + 6px))}.bs-content{flex:1;min-height:0;overflow-y:auto;-webkit-overflow-scrolling:touch;overscroll-behavior:contain;padding:0 16px 16px}.bs-screen{position:absolute;inset:0;pointer-events:none;z-index:var(--bs-z-scrim)}.bs-scrim-overlay{z-index:calc(var(--bs-z-sheet) + 1);pointer-events:none}.bs-scrim{background:var(--bs-scrim-color);transition:opacity 0.15s linear;will-change:opacity}.bs-root[data-dragging="true"] .bs-scrim,.bs-root[data-animating="true"] .bs-scrim{transition:none}.bs-scrim{backdrop-filter:blur(var(--bs-scrim-blur));-webkit-backdrop-filter:blur(var(--bs-scrim-blur))}.bs-button-slot{position:absolute;z-index:calc(var(--bs-z-sheet) + 1);pointer-events:auto}.bs-button-slot[data-side="left"]{left:16px;bottom:calc(var(--bs-size,0px) + 12px);transition:bottom 0.15s ease}.bs-button-slot[data-side="right"]{right:16px;bottom:calc(var(--bs-size,0px) + 12px);transition:bottom 0.15s ease}@media (prefers-reduced-motion:reduce){.bs-backdrop,.bs-handle::before,.bs-button-slot[data-side="left"],.bs-button-slot[data-side="right"]{transition:none !important}}@media (prefers-color-scheme:dark){:where(.bs-root){--bs-surface:#1a1a1d;--bs-surface-border:rgba(255,255,255,0.08);--bs-handle-color:rgba(255,255,255,0.45);--bs-shadow:0 -3px 16px rgba(0,0,0,0.5)}}.bs-sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}:where(.ovl-root){--ovl-surface:var(--bs-surface,#ffffff);--ovl-surface-border:var(--bs-surface-border,rgba(0,0,0,0.08));--ovl-shadow:0 -8px 40px rgba(0,0,0,0.35);--ovl-radius:var(--bs-radius,20px);--ovl-backdrop-color:rgba(0,0,0,0.5);--ovl-z-backdrop:200;--ovl-z-panel:201}.ovl-backdrop{position:fixed;inset:0;background:var(--ovl-backdrop-color);opacity:0;pointer-events:none;z-index:var(--ovl-z-backdrop)}.ovl-panel{position:fixed;background:var(--ovl-surface);box-shadow:var(--ovl-shadow);z-index:var(--ovl-z-panel);-webkit-tap-highlight-color:transparent;outline:none;transition:transform 0.32s cubic-bezier(0.29,1.24,0.84,0.99),opacity 0.32s ease-out}.ovl-panel[data-state="open"]{transform:translate3d(0,0,0);opacity:1}@starting-style{.ovl-panel[data-edge="bottom"][data-state="open"]{transform:translate3d(0,100%,0);opacity:0}.ovl-panel[data-edge="top"][data-state="open"]{transform:translate3d(0,-100%,0);opacity:0}.ovl-panel[data-edge="left"][data-state="open"]{transform:translate3d(-100%,0,0);opacity:0}.ovl-panel[data-edge="right"][data-state="open"]{transform:translate3d(100%,0,0);opacity:0}}.ovl-panel[data-edge="bottom"]{left:0;right:0;bottom:0;width:100%;border-top-left-radius:var(--ovl-radius);border-top-right-radius:var(--ovl-radius);border-top:1px solid var(--ovl-surface-border);padding-bottom:env(safe-area-inset-bottom)}.ovl-panel[data-edge="top"]{left:0;right:0;top:0;width:100%;border-bottom-left-radius:var(--ovl-radius);border-bottom-right-radius:var(--ovl-radius);border-bottom:1px solid var(--ovl-surface-border);padding-top:env(safe-area-inset-top)}.ovl-panel[data-edge="left"]{top:0;bottom:0;left:0;height:100%;border-top-right-radius:var(--ovl-radius);border-bottom-right-radius:var(--ovl-radius);border-right:1px solid var(--ovl-surface-border)}.ovl-panel[data-edge="right"]{top:0;bottom:0;right:0;height:100%;border-top-left-radius:var(--ovl-radius);border-bottom-left-radius:var(--ovl-radius);border-left:1px solid var(--ovl-surface-border)}@media (prefers-reduced-motion:reduce){.ovl-panel,.ovl-backdrop{transition:none !important}}`;
+    baseStyles = `:where(.bs-root){--bs-surface-d:#ffffff;--bs-surface-border-d:rgba(225,227,237,1);--bs-radius-d:20px;--bs-handle-color-d:rgba(26,22,20,0.3);--bs-handle-width:40px;--bs-handle-height:5px;--bs-z-backdrop:90;--bs-z-sheet:100;--bs-header-min-height:80px;--bs-backdrop-color-d:rgba(0,0,0,0.5);--bs-scrim-color-d:transparent;--bs-scrim-blur:0px;--bs-z-scrim:calc(var(--bs-z-sheet) - 1);--bs-size:0px;--bs-progress:0}.bs-backdrop{position:fixed;inset:0;background:var(--bs-backdrop-color,var(--bs-backdrop-color-d));opacity:0;pointer-events:none;z-index:var(--bs-z-backdrop);transition:opacity 0.24s cubic-bezier(0.22,1,0.36,1);will-change:opacity}.bs-root[data-dragging="true"] .bs-backdrop,.bs-root[data-animating="true"] .bs-backdrop{transition:none}.bs-sheet{position:fixed;background:var(--bs-surface,var(--bs-surface-d));box-shadow:var(--bs-shadow,var(--bs-shadow-auto,none));z-index:var(--bs-z-sheet);pointer-events:auto;overflow:hidden;display:flex;flex-direction:column;-webkit-tap-highlight-color:transparent;user-select:none;overscroll-behavior:contain}.bs-sheet[data-mode="bottom"]{left:0;right:0;bottom:0;width:100%;border-top-left-radius:var(--bs-radius,var(--bs-radius-d));border-top-right-radius:var(--bs-radius,var(--bs-radius-d));border-top:1px solid var(--bs-surface-border,var(--bs-surface-border-d));padding-bottom:env(safe-area-inset-bottom);--bs-shadow-auto:0 calc(var(--bs-progress,0) * -2px - 3px) calc(var(--bs-progress,0) * 18px + 12px) rgba(0,0,0,calc(var(--bs-progress,0) * 0.15 + 0.12))}.bs-sheet[data-mode="top"]{left:0;right:0;top:0;width:100%;border-bottom-left-radius:var(--bs-radius,var(--bs-radius-d));border-bottom-right-radius:var(--bs-radius,var(--bs-radius-d));border-bottom:1px solid var(--bs-surface-border,var(--bs-surface-border-d));flex-direction:column-reverse;--bs-shadow-auto:0 3px 12px rgba(0,0,0,0.12);padding-top:env(safe-area-inset-top)}.bs-sheet[data-mode="left"]{top:0;bottom:0;left:0;height:100%;border-top-right-radius:var(--bs-radius,var(--bs-radius-d));border-bottom-right-radius:var(--bs-radius,var(--bs-radius-d));border-right:1px solid var(--bs-surface-border,var(--bs-surface-border-d));--bs-shadow-auto:3px 0 12px rgba(0,0,0,0.12)}.bs-sheet[data-mode="right"]{top:0;bottom:0;right:0;height:100%;border-top-left-radius:var(--bs-radius,var(--bs-radius-d));border-bottom-left-radius:var(--bs-radius,var(--bs-radius-d));border-left:1px solid var(--bs-surface-border,var(--bs-surface-border-d));--bs-shadow-auto:-3px 0 12px rgba(0,0,0,0.12)}.bs-sheet[data-mode="left"] .bs-content{padding-right:36px}.bs-sheet[data-mode="right"] .bs-content{padding-left:36px}.bs-handle{flex-shrink:0;min-height:44px;display:flex;flex-direction:column;justify-content:center;padding:8px 16px 4px;cursor:grab;touch-action:none;user-select:none;background:var(--bs-surface,var(--bs-surface-d));-webkit-tap-highlight-color:transparent;outline:none;position:relative}.bs-handle:active{cursor:grabbing}.bs-handle:focus-visible{outline:2px solid currentColor;outline-offset:-2px;border-radius:var(--bs-radius,var(--bs-radius-d))}.bs-handle::before{content:"";display:block;width:var(--bs-handle-width);height:var(--bs-handle-height);background:var(--bs-handle-color,var(--bs-handle-color-d));border-radius:calc(var(--bs-handle-height) / 2);margin:0 auto 8px;transition:width 0.15s ease,background 0.15s ease,transform 0.15s ease;pointer-events:none}.bs-sheet[data-mode="left"] .bs-handle,.bs-sheet[data-mode="right"] .bs-handle{position:absolute;top:0;bottom:0;width:28px;min-width:0;min-height:0;display:flex;flex-direction:column;align-items:center;justify-content:center;padding:0;background:var(--bs-surface,var(--bs-surface-d));z-index:1;overflow:hidden}.bs-sheet[data-mode="left"] .bs-handle>*,.bs-sheet[data-mode="right"] .bs-handle>*{display:none}.bs-sheet[data-mode="left"] .bs-handle{right:0;border-left:1px solid var(--bs-surface-border,var(--bs-surface-border-d))}.bs-sheet[data-mode="right"] .bs-handle{left:0;border-right:1px solid var(--bs-surface-border,var(--bs-surface-border-d))}.bs-sheet[data-mode="left"] .bs-handle::before,.bs-sheet[data-mode="right"] .bs-handle::before{width:var(--bs-handle-height);height:var(--bs-handle-width);margin:0}.bs-sheet:hover .bs-handle::before{background:color-mix(in oklab,var(--bs-handle-color,var(--bs-handle-color-d)),#000 15%)}.bs-handle:active::before{background:color-mix(in oklab,var(--bs-handle-color,var(--bs-handle-color-d)),#000 35%);transform:scaleX(1.15)}.bs-handle.bs-handle--ticks::after{content:"";display:block;position:absolute;left:50%;bottom:6px;transform:translateX(-50%);width:calc(var(--bs-handle-width) * 2);height:3px;background-image:radial-gradient( circle,var(--bs-handle-color,var(--bs-handle-color-d)) 0 1.5px,transparent 1.6px );background-size:8px 3px;background-repeat:repeat-x;background-position:center;opacity:0;transition:opacity 0.18s ease-out;pointer-events:none}.bs-root[data-dragging="true"] .bs-handle.bs-handle--ticks::after{opacity:0.4}.bs-sheet[data-mode="top"] .bs-handle.bs-handle--ticks::after{bottom:auto;top:6px}.bs-sheet[data-mode="left"] .bs-handle.bs-handle--ticks::after,.bs-sheet[data-mode="right"] .bs-handle.bs-handle--ticks::after{left:50%;top:50%;bottom:auto;transform:translate(-50%,-50%);width:3px;height:calc(var(--bs-handle-width) * 2);background-size:3px 8px;background-repeat:repeat-y;margin-left:calc(var(--bs-handle-height) + 6px)}.bs-sheet[data-mode="right"] .bs-handle.bs-handle--ticks::after{margin-left:calc(-1 * (var(--bs-handle-height) + 6px))}.bs-content{flex:1;min-height:0;overflow-y:auto;-webkit-overflow-scrolling:touch;overscroll-behavior:contain;user-select:text;padding:0 16px 16px}.bs-footer{flex:0 0 auto;padding:12px 16px calc(12px + env(safe-area-inset-bottom));border-top:1px solid var(--bs-surface-border,var(--bs-surface-border-d));background:var(--bs-surface,var(--bs-surface-d))}.bs-screen{position:absolute;inset:0;pointer-events:none;z-index:var(--bs-z-scrim);background:var(--bs-scrim-color,var(--bs-scrim-color-d));transition:opacity 0.24s cubic-bezier(0.22,1,0.36,1);will-change:opacity}.bs-root[data-dragging="true"] .bs-screen,.bs-root[data-animating="true"] .bs-screen{transition:none}.bs-scrim-overlay{z-index:calc(var(--bs-z-sheet) + 1);pointer-events:none}.bs-button-slot{position:absolute;z-index:calc(var(--bs-z-sheet) + 1);pointer-events:auto}.bs-button-slot[data-side="left"]{left:16px;bottom:calc(100% + 12px)}.bs-button-slot[data-side="right"]{right:16px;bottom:calc(100% + 12px)}.bs-sheet[data-mode="top"] .bs-button-slot{bottom:auto;top:calc(100% + 12px)}@media (prefers-reduced-motion:reduce){.bs-backdrop,.bs-handle::before,.bs-button-slot[data-side="left"],.bs-button-slot[data-side="right"]{transition:none !important}}@media (prefers-color-scheme:dark){:where(.bs-root){--bs-surface-d:#1a1a1d;--bs-surface-border-d:rgba(255,255,255,0.08);--bs-handle-color-d:rgba(255,255,255,0.45);--bs-shadow-auto:0 -3px 16px rgba(0,0,0,0.5)}}.bs-sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}:where(.ovl-root){--ovl-surface:var(--bs-surface,var(--bs-surface-d,#ffffff));--ovl-surface-border:var(--bs-surface-border,var(--bs-surface-border-d,rgba(0,0,0,0.08)));--ovl-shadow:0 -8px 40px rgba(0,0,0,0.35);--ovl-radius:var(--bs-radius,var(--bs-radius-d,20px));--ovl-backdrop-color:rgba(0,0,0,0.5);--ovl-z-backdrop:200;--ovl-z-panel:201}.ovl-backdrop{position:fixed;inset:0;background:var(--ovl-backdrop-color);opacity:0;pointer-events:none;z-index:var(--ovl-z-backdrop)}.ovl-panel{position:fixed;background:var(--ovl-surface);box-shadow:var(--ovl-shadow);z-index:var(--ovl-z-panel);-webkit-tap-highlight-color:transparent;outline:none;transition:transform 0.32s cubic-bezier(0.29,1.24,0.84,0.99),opacity 0.32s ease-out}.ovl-panel[data-state="open"]{transform:translate3d(0,0,0);opacity:1}@starting-style{.ovl-panel[data-edge="bottom"][data-state="open"]{transform:translate3d(0,100%,0);opacity:0}.ovl-panel[data-edge="top"][data-state="open"]{transform:translate3d(0,-100%,0);opacity:0}.ovl-panel[data-edge="left"][data-state="open"]{transform:translate3d(-100%,0,0);opacity:0}.ovl-panel[data-edge="right"][data-state="open"]{transform:translate3d(100%,0,0);opacity:0}}.ovl-panel[data-edge="bottom"]{left:0;right:0;bottom:0;width:100%;border-top-left-radius:var(--ovl-radius);border-top-right-radius:var(--ovl-radius);border-top:1px solid var(--ovl-surface-border);padding-bottom:env(safe-area-inset-bottom)}.ovl-panel[data-edge="top"]{left:0;right:0;top:0;width:100%;border-bottom-left-radius:var(--ovl-radius);border-bottom-right-radius:var(--ovl-radius);border-bottom:1px solid var(--ovl-surface-border);padding-top:env(safe-area-inset-top)}.ovl-panel[data-edge="left"]{top:0;bottom:0;left:0;height:100%;border-top-right-radius:var(--ovl-radius);border-bottom-right-radius:var(--ovl-radius);border-right:1px solid var(--ovl-surface-border)}.ovl-panel[data-edge="right"]{top:0;bottom:0;right:0;height:100%;border-top-left-radius:var(--ovl-radius);border-bottom-left-radius:var(--ovl-radius);border-left:1px solid var(--ovl-surface-border)}@media (prefers-reduced-motion:reduce){.ovl-panel,.ovl-backdrop{transition:none !important}}`;
   }
 });
 
@@ -2822,7 +3594,7 @@ __export(BottomSheetElement_exports, {
   BottomSheetElement: () => BottomSheetElement,
   defineBottomSheet: () => defineBottomSheet
 });
-var ATTR_SNAP_POINTS, ATTR_ALLOWED, ATTR_INITIAL, ATTR_MODE, ATTR_BACKDROP, ATTR_STYLESHEET, ATTR_ANIMATION, ATTR_FOCUS_TRAP, ATTR_CLOSE_ON_ESCAPE, ATTR_LOCK_BODY_SCROLL, isValidSnapPoint, DEFAULT_SNAP_POINTS, parseSnapPoints, VALID_MODES, VALID_ANIMATIONS, parseMode, parseAnimation, parseList, buildSlot, buildShadowTree, BottomSheetElement, registered, defineBottomSheet;
+var ATTR_SNAP_POINTS, ATTR_ALLOWED, ATTR_INITIAL, ATTR_MODE, ATTR_BACKDROP, ATTR_STYLESHEET, ATTR_ANIMATION, ATTR_FOCUS_TRAP, ATTR_CLOSE_ON_ESCAPE, ATTR_LOCK_BODY_SCROLL, ATTR_SHEET_LABEL, ATTR_STACK_EFFECT, ATTR_PERSISTENT, ATTR_DISABLE_CLOSE, ATTR_DISABLE_DRAG, ATTR_CLOSE_ON_ROUTE_CHANGE, ATTR_RADIUS, ATTR_MAX_HEIGHT, ATTR_RETURN_FOCUS_TO, ATTR_BACKDROP_COLOR, ATTR_SCRIM_COLOR, ATTR_SNAP, LIVE_ATTRS, isValidSnapPoint, DEFAULT_SNAP_POINTS, parseSnapPoints, VALID_MODES, VALID_ANIMATIONS, parseMode, parseAnimation, parseList, parseDimension, ANCHOR_POSITIONS, ANCHOR_ANIMATIONS, parseAnchorOptions, buildSlot, buildShadowTree, BaseHTMLElement, BottomSheetElement, defineBottomSheet;
 var init_BottomSheetElement = __esm({
   "src/web-component/BottomSheetElement.ts"() {
     init_BottomSheetEngine();
@@ -2837,6 +3609,25 @@ var init_BottomSheetElement = __esm({
     ATTR_FOCUS_TRAP = "focus-trap";
     ATTR_CLOSE_ON_ESCAPE = "close-on-escape";
     ATTR_LOCK_BODY_SCROLL = "lock-body-scroll";
+    ATTR_SHEET_LABEL = "sheet-label";
+    ATTR_STACK_EFFECT = "stack-effect";
+    ATTR_PERSISTENT = "persistent";
+    ATTR_DISABLE_CLOSE = "disable-close";
+    ATTR_DISABLE_DRAG = "disable-drag";
+    ATTR_CLOSE_ON_ROUTE_CHANGE = "close-on-route-change";
+    ATTR_RADIUS = "radius";
+    ATTR_MAX_HEIGHT = "max-height";
+    ATTR_RETURN_FOCUS_TO = "return-focus-to";
+    ATTR_BACKDROP_COLOR = "backdrop-color";
+    ATTR_SCRIM_COLOR = "scrim-color";
+    ATTR_SNAP = "snap";
+    LIVE_ATTRS = /* @__PURE__ */ new Set([
+      ATTR_RADIUS,
+      ATTR_MAX_HEIGHT,
+      ATTR_BACKDROP_COLOR,
+      ATTR_SCRIM_COLOR,
+      ATTR_SNAP
+    ]);
     isValidSnapPoint = (p) => !!p && typeof p === "object" && typeof p.id === "string" && (typeof p.size === "number" || typeof p.size === "string");
     DEFAULT_SNAP_POINTS = [{ id: "full", size: "full" }];
     parseSnapPoints = (raw) => {
@@ -2866,6 +3657,49 @@ var init_BottomSheetElement = __esm({
     parseMode = (raw) => raw && VALID_MODES.includes(raw) ? raw : "bottom";
     parseAnimation = (raw) => raw && VALID_ANIMATIONS.includes(raw) ? raw : void 0;
     parseList = (raw) => raw ? raw.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+    parseDimension = (raw) => {
+      if (raw === null) return void 0;
+      const numeric = Number(raw);
+      return Number.isFinite(numeric) && raw.trim() !== "" ? numeric : raw;
+    };
+    ANCHOR_POSITIONS = [
+      "top-left",
+      "top-center",
+      "top-right",
+      "center-left",
+      "center",
+      "center-right",
+      "bottom-left",
+      "bottom-center",
+      "bottom-right",
+      "sheet-top-left",
+      "sheet-top-center",
+      "sheet-top-right",
+      "dock-bottom",
+      "dock-top"
+    ];
+    ANCHOR_ANIMATIONS = [
+      "fade",
+      "scale",
+      "slide",
+      "pop",
+      "none"
+    ];
+    parseAnchorOptions = (el) => {
+      const position = el.getAttribute("data-position");
+      const animation = el.getAttribute("data-animation");
+      const showOn = parseList(el.getAttribute("data-show-on"));
+      const fadeRangeRaw = parseList(el.getAttribute("data-fade-range"));
+      const fadeRange = fadeRangeRaw?.length === 2 && fadeRangeRaw.every((v) => Number.isFinite(Number(v))) ? [Number(fadeRangeRaw[0]), Number(fadeRangeRaw[1])] : void 0;
+      return {
+        position: position && ANCHOR_POSITIONS.includes(position) ? position : void 0,
+        inset: el.getAttribute("data-inset") ?? void 0,
+        showOn,
+        fadeRange,
+        interactive: el.getAttribute("data-interactive") !== "false",
+        animation: animation && ANCHOR_ANIMATIONS.includes(animation) ? animation : void 0
+      };
+    };
     buildSlot = (name) => {
       const slot = document.createElement("slot");
       slot.name = name;
@@ -2935,7 +3769,9 @@ var init_BottomSheetElement = __esm({
         }
       };
     };
-    BottomSheetElement = class extends HTMLElement {
+    BaseHTMLElement = typeof HTMLElement !== "undefined" ? HTMLElement : class {
+    };
+    BottomSheetElement = class extends BaseHTMLElement {
       constructor() {
         super();
         __publicField(this, "engine", null);
@@ -2943,17 +3779,12 @@ var init_BottomSheetElement = __esm({
         __publicField(this, "offHandlers", []);
         __publicField(this, "refs");
         __publicField(this, "backdropClickHandler", null);
+        __publicField(this, "stylesheetLinked", false);
+        __publicField(this, "declarativeAnchors", []);
         this.root = this.attachShadow({ mode: "open" });
         const baseStyle = document.createElement("style");
         baseStyle.textContent = baseStyles;
         this.root.appendChild(baseStyle);
-        const stylesheet = this.getAttribute(ATTR_STYLESHEET);
-        if (stylesheet) {
-          const link = document.createElement("link");
-          link.rel = "stylesheet";
-          link.href = stylesheet;
-          this.root.appendChild(link);
-        }
         const inlineStyle = document.createElement("style");
         inlineStyle.textContent = [
           ":host { display: contents; }",
@@ -2981,20 +3812,70 @@ var init_BottomSheetElement = __esm({
           ATTR_ANIMATION,
           ATTR_FOCUS_TRAP,
           ATTR_CLOSE_ON_ESCAPE,
-          ATTR_LOCK_BODY_SCROLL
+          ATTR_LOCK_BODY_SCROLL,
+          ATTR_SHEET_LABEL,
+          ATTR_STACK_EFFECT,
+          ATTR_PERSISTENT,
+          ATTR_DISABLE_CLOSE,
+          ATTR_DISABLE_DRAG,
+          ATTR_CLOSE_ON_ROUTE_CHANGE,
+          ATTR_RADIUS,
+          ATTR_MAX_HEIGHT,
+          ATTR_RETURN_FOCUS_TO,
+          ATTR_BACKDROP_COLOR,
+          ATTR_SCRIM_COLOR,
+          ATTR_SNAP
         ];
       }
       connectedCallback() {
+        if (!this.stylesheetLinked) {
+          this.stylesheetLinked = true;
+          const stylesheet = this.getAttribute(ATTR_STYLESHEET);
+          if (stylesheet) {
+            const link = document.createElement("link");
+            link.rel = "stylesheet";
+            link.href = stylesheet;
+            this.root.appendChild(link);
+          }
+        }
         this.initEngine();
       }
       disconnectedCallback() {
         this.teardownEngine();
       }
-      attributeChangedCallback() {
+      attributeChangedCallback(name, _old, value) {
         if (!this.engine) return;
+        if (LIVE_ATTRS.has(name)) {
+          this.applyLiveAttribute(name, value);
+          return;
+        }
         this.teardownEngine();
         this.initEngine();
       }
+      applyLiveAttribute(name, value) {
+        if (!this.engine) return;
+        switch (name) {
+          case ATTR_RADIUS: {
+            const r = parseDimension(value);
+            if (r !== void 0) this.engine.setRadius(r);
+            break;
+          }
+          case ATTR_MAX_HEIGHT: {
+            const h = parseDimension(value);
+            if (h !== void 0) this.engine.setMaxHeight(h);
+            break;
+          }
+          case ATTR_BACKDROP_COLOR:
+          case ATTR_SCRIM_COLOR:
+            this.engine.setScrimColor(value);
+            break;
+          case ATTR_SNAP:
+            if (value && value !== this.engine.state.activeId) {
+              void this.engine.snapTo(value);
+            }
+            break;
+        }
+      }
       getEngine() {
         return this.engine;
       }
@@ -3007,6 +3888,10 @@ var init_BottomSheetElement = __esm({
         }
         this.engine?.destroy();
         this.engine = null;
+        for (const el of this.declarativeAnchors) {
+          this.appendChild(el);
+        }
+        this.declarativeAnchors = [];
       }
       initEngine() {
         const { sheet, handle, content, backdrop, announcer } = this.refs;
@@ -3018,10 +3903,16 @@ var init_BottomSheetElement = __esm({
         } else {
           sheet.removeAttribute("aria-modal");
         }
+        sheet.setAttribute(
+          "aria-label",
+          this.getAttribute(ATTR_SHEET_LABEL) ?? "Bottom sheet"
+        );
         const showBackdrop = this.getAttribute(ATTR_BACKDROP) !== "false";
         backdrop.style.display = showBackdrop ? "" : "none";
         if (showBackdrop) {
-          this.backdropClickHandler = () => void this.engine?.close();
+          this.backdropClickHandler = () => {
+            if (this.engine?.canDismiss()) void this.engine.close("backdrop");
+          };
           backdrop.addEventListener("click", this.backdropClickHandler);
         }
         const opts = {
@@ -3037,11 +3928,29 @@ var init_BottomSheetElement = __esm({
           animation: parseAnimation(this.getAttribute(ATTR_ANIMATION)),
           focusTrap,
           closeOnEscape: this.getAttribute(ATTR_CLOSE_ON_ESCAPE) !== "false",
-          lockBodyScroll: this.getAttribute(ATTR_LOCK_BODY_SCROLL) !== "false"
+          lockBodyScroll: this.getAttribute(ATTR_LOCK_BODY_SCROLL) !== "false",
+          stackEffect: this.getAttribute(ATTR_STACK_EFFECT) === "true",
+          persistent: this.getAttribute(ATTR_PERSISTENT) === "true",
+          disableClose: this.getAttribute(ATTR_DISABLE_CLOSE) === "true",
+          disableDrag: this.getAttribute(ATTR_DISABLE_DRAG) === "true",
+          closeOnRouteChange: this.getAttribute(ATTR_CLOSE_ON_ROUTE_CHANGE) === "true",
+          radius: parseDimension(this.getAttribute(ATTR_RADIUS)),
+          maxHeight: parseDimension(this.getAttribute(ATTR_MAX_HEIGHT)),
+          returnFocusTo: this.getAttribute(ATTR_RETURN_FOCUS_TO) ?? void 0
         };
         this.engine = new BottomSheetEngine(opts);
+        sheet.setAttribute("data-active", this.engine.state.activeId);
+        const scrimColor = this.getAttribute(ATTR_SCRIM_COLOR) ?? this.getAttribute(ATTR_BACKDROP_COLOR);
+        if (scrimColor !== null) this.engine.setScrimColor(scrimColor);
+        for (const el of Array.from(
+          this.querySelectorAll('[slot="anchor"]')
+        )) {
+          this.declarativeAnchors.push(el);
+          this.engine.addAnchor({ ...parseAnchorOptions(el), element: el });
+        }
         this.offHandlers = [
           this.engine.on("snap", (payload) => {
+            sheet.setAttribute("data-active", payload.id);
             announcer.textContent = payload.id;
             this.dispatchEvent(new CustomEvent("snap", { detail: payload }));
           }),
@@ -3056,6 +3965,26 @@ var init_BottomSheetElement = __esm({
           this.engine.on(
             "progress",
             (payload) => this.dispatchEvent(new CustomEvent("progress", { detail: payload }))
+          ),
+          this.engine.on(
+            "before-close",
+            (payload) => this.dispatchEvent(new CustomEvent("before-close", { detail: payload }))
+          ),
+          this.engine.on(
+            "opened",
+            (payload) => this.dispatchEvent(new CustomEvent("opened", { detail: payload }))
+          ),
+          this.engine.on(
+            "closed",
+            () => this.dispatchEvent(new CustomEvent("closed"))
+          ),
+          this.engine.on(
+            "dragstart",
+            (payload) => this.dispatchEvent(new CustomEvent("drag-start", { detail: payload }))
+          ),
+          this.engine.on(
+            "dragend",
+            (payload) => this.dispatchEvent(new CustomEvent("drag-end", { detail: payload }))
           )
         ];
       }
@@ -3065,21 +3994,66 @@ var init_BottomSheetElement = __esm({
       open(id) {
         return this.engine?.open(id) ?? Promise.resolve();
       }
-      close() {
-        return this.engine?.close() ?? Promise.resolve();
+      close(reason) {
+        return this.engine?.close(reason) ?? Promise.resolve();
+      }
+      expand() {
+        return this.engine?.expand() ?? Promise.resolve();
+      }
+      collapse() {
+        return this.engine?.collapse() ?? Promise.resolve();
+      }
+      isTop() {
+        return this.engine?.isTop() ?? false;
+      }
+      depth() {
+        return this.engine?.depth() ?? 0;
+      }
+      canDismiss() {
+        return this.engine?.canDismiss() ?? false;
+      }
+      setRadius(r) {
+        this.engine?.setRadius(r);
+      }
+      setMaxHeight(h) {
+        this.engine?.setMaxHeight(h);
       }
       setAllowed(ids, snap) {
         this.engine?.setAllowed(ids, snap);
       }
+      addAnchor(opts) {
+        return this.engine?.addAnchor(opts) ?? (() => {
+        });
+      }
+      setScrimStages(opts) {
+        return this.engine?.setScrimStages(opts) ?? (() => {
+        });
+      }
+      recompute() {
+        this.engine?.recompute();
+      }
       get sheetState() {
         return this.engine?.state ?? null;
       }
+      get snap() {
+        return this.engine?.state.activeId ?? this.getAttribute(ATTR_SNAP);
+      }
+      set snap(id) {
+        if (id === null) {
+          this.removeAttribute(ATTR_SNAP);
+          return;
+        }
+        if (this.engine) {
+          if (id !== this.engine.state.activeId) void this.engine.snapTo(id);
+        } else {
+          this.setAttribute(ATTR_SNAP, id);
+        }
+      }
     };
-    registered = false;
     defineBottomSheet = (tag = "bottom-sheet") => {
-      if (registered || customElements.get(tag)) return;
-      customElements.define(tag, BottomSheetElement);
-      registered = true;
+      if (typeof customElements === "undefined" || customElements.get(tag)) return;
+      customElements.define(tag, class extends BottomSheetElement {
+      });
     };
   }
 });