@vielzeug/orbit 1.1.5 → 2.0.0

package/README.md

@@ -1,77 +1,37 @@
 # @vielzeug/orbit
 
-> Zero-dependency floating element positioning for tooltips, dropdowns, menus, and popovers.
+Dependency-free floating UI positioning with lifecycle-owned geometry, middleware, and client-only execution.
 
-[![npm version](https://img.shields.io/npm/v/@vielzeug/orbit)](https://www.npmjs.com/package/@vielzeug/orbit) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+## Features
 
-<details>
-<summary>Quick Reference</summary>
+- `createPositioner()` owns coordinates, clipping, updates, and cleanup.
+- `computePosition()` remains available for advanced platform-managed positioning.
+- Middleware supports offset, flip, shift, size, hide, arrow, inline, and auto-placement.
+- `@vielzeug/orbit/reactive` exposes a Ripple adapter when Ripple is installed.
+- Root imports are SSR-safe; start positioners only from a client mount lifecycle.
 
-**Package:** `@vielzeug/orbit` &nbsp;·&nbsp; **Category:** UI Positioning
-
-**Key exports:** `float`, `computePosition`, `getRects`, `detectOverflow`, `autoUpdate`, `offset`, `flip`, `shift`, `autoPlacement`, `arrow`, `size`, `hide`, `compose`, `limitShift`, `getSide`, `getAlignment`
-
-**When to use:** Zero-dependency floating element positioning for tooltips, dropdowns, menus, and popovers.
-
-**Related:** [@vielzeug/ore](https://vielzeug.dev/ore/) · [@vielzeug/refine](https://vielzeug.dev/refine/) · [@vielzeug/dnd](https://vielzeug.dev/dnd/)
-
-</details>
-
-`@vielzeug/orbit` is part of Vielzeug and ships as a zero-dependency TypeScript package with ESM+CJS output.
-
-## Installation
+## Install
 
 ```sh
 pnpm add @vielzeug/orbit
-npm install @vielzeug/orbit
-yarn add @vielzeug/orbit
 ```
 
+Install `@vielzeug/ripple` only when importing `@vielzeug/orbit/reactive`.
+
 ## Quick Start
 
-```ts
-import { arrow, float, flip, offset, shift } from '@vielzeug/orbit';
+Create a positioner after both elements mount, then dispose it with their owner.
 
-const reference = document.querySelector<HTMLElement>('#trigger')!;
-const floating = document.querySelector<HTMLElement>('#tooltip')!;
-const arrowEl = floating.querySelector<HTMLElement>('.arrow')!;
+```ts
+import { createPositioner, flip, offset, shift } from '@vielzeug/orbit';
 
-const handle = float(reference, floating, {
+const positioner = createPositioner(trigger, tooltip, {
+  middleware: [offset(8), flip(), shift({ padding: 6 })],
   placement: 'top',
-  middleware: [offset(8), flip(), shift({ padding: 6 }), arrow({ element: arrowEl, padding: 6 })],
-  apply(result) {
-    floating.style.left = `${result.x}px`;
-    floating.style.top = `${result.y}px`;
-
-    if (result.middlewareData.arrow) {
-      const { x, y } = result.middlewareData.arrow;
-      arrowEl.style.left = x != null ? `${x}px` : '';
-      arrowEl.style.top = y != null ? `${y}px` : '';
-    }
-  },
 });
 
-// On teardown:
-handle.dispose();
+positioner.start();
+positioner.dispose();
 ```
 
-## Sub-paths
-
-| Import                     | Purpose                                                     |
-| -------------------------- | ------------------------------------------------------------ |
-| `@vielzeug/orbit`          | Core API, middleware (`inline` included), utilities, types |
-| `@vielzeug/orbit/presets`  | Pre-configured middleware stacks                            |
-| `@vielzeug/orbit/reactive` | Reactive signal adapter (`@vielzeug/ripple`)                |
-| `@vielzeug/orbit/devtools` | Visual debug overlay (development only)                     |
-| `@vielzeug/orbit/ssr`      | No-op stubs for server-side rendering                        |
-
-## Documentation
-
-- [Overview](https://vielzeug.dev/orbit/)
-- [Usage Guide](https://vielzeug.dev/orbit/usage)
-- [API Reference](https://vielzeug.dev/orbit/api)
-- [Examples](https://vielzeug.dev/orbit/examples)
-
-## License
-
-MIT © [Helmuth Saatkamp](https://github.com/helmuthdu) — part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.
+[Full documentation](https://vielzeug.dev/orbit/)

package/dist/auto-update.cjs

@@ -1,2 +1,2 @@
-const e=require("./utils.cjs");let t=require("@vielzeug/arsenal/function");function n(t){let n=[],r=e.flatTreeParent(t);for(;r;){let t=getComputedStyle(r),i=t.overflow+t.overflowX+t.overflowY;/auto|scroll|overlay/.test(i)&&n.push(r),r=e.flatTreeParent(r)}return n}function r(r,i,a,{animationFrame:o=!1,observeAncestors:s=!0,observeFloating:c=!0,observeVisualViewport:l=!0,pauseWhenHidden:u=!0,throttle:d=0}={}){let f=d>0?(0,t.throttle)(a,d,{leading:!0,trailing:!0}):null,p=f??a,m=!0,h=()=>{m&&p()};p();let g=[];if(u&&e.isElement(r)&&typeof IntersectionObserver<`u`){let e=new IntersectionObserver(e=>{m=e.at(-1)?.isIntersecting??!0,m&&p()});e.observe(r),g.push(()=>e.disconnect())}if(e.isElement(r)&&s){let e=n(r);for(let t of e)t.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>t.removeEventListener(`scroll`,h));window.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>window.removeEventListener(`scroll`,h))}else{let e=e=>{e.composedPath().includes(i)||h()};window.addEventListener(`scroll`,e,{capture:!0,passive:!0}),g.push(()=>window.removeEventListener(`scroll`,e,{capture:!0}))}window.addEventListener(`resize`,h,{passive:!0}),g.push(()=>window.removeEventListener(`resize`,h));let _=l?window.visualViewport:null;_&&(_.addEventListener(`resize`,h,{passive:!0}),_.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>{_.removeEventListener(`resize`,h),_.removeEventListener(`scroll`,h)}));let v=new ResizeObserver(h);e.isElement(r)&&v.observe(r),c&&v.observe(i),g.push(()=>v.disconnect());let y=0;if(o){let e=()=>{h(),y=window.requestAnimationFrame(e)};y=window.requestAnimationFrame(e),g.push(()=>window.cancelAnimationFrame(y))}return()=>{f?.cancel();for(let e of g)e()}}exports.autoUpdate=r;
+const e=require("./utils.cjs");function t(e,t){let n,r=0,i=(()=>{let i=Date.now(),a=t-(i-r);if(a<=0){n!==void 0&&clearTimeout(n),n=void 0,r=i,e();return}n===void 0&&(n=setTimeout(()=>{n=void 0,r=Date.now(),e()},a))});return i.cancel=()=>{n!==void 0&&clearTimeout(n),n=void 0},i}function n(t){let n=[],r=e.flatTreeParent(t);for(;r;){let t=getComputedStyle(r),i=t.overflow+t.overflowX+t.overflowY;/auto|scroll|overlay/.test(i)&&n.push(r),r=e.flatTreeParent(r)}return n}function r(r,i,a,{animationFrame:o=!1,observeAncestors:s=!0,observeFloating:c=!0,observeVisualViewport:l=!0,pauseWhenHidden:u=!0,throttle:d=0}={}){let f=d>0?t(a,d):null,p=f??a,m=!0,h=()=>{m&&p()};p();let g=[];if(u&&e.isElement(r)&&typeof IntersectionObserver<`u`){let e=new IntersectionObserver(e=>{m=e.at(-1)?.isIntersecting??!0,m&&p()});e.observe(r),g.push(()=>e.disconnect())}if(e.isElement(r)&&s){let e=n(r);for(let t of e)t.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>t.removeEventListener(`scroll`,h));window.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>window.removeEventListener(`scroll`,h))}else{let e=e=>{e.composedPath().includes(i)||h()};window.addEventListener(`scroll`,e,{capture:!0,passive:!0}),g.push(()=>window.removeEventListener(`scroll`,e,{capture:!0}))}window.addEventListener(`resize`,h,{passive:!0}),g.push(()=>window.removeEventListener(`resize`,h));let _=l?window.visualViewport:null;_&&(_.addEventListener(`resize`,h,{passive:!0}),_.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>{_.removeEventListener(`resize`,h),_.removeEventListener(`scroll`,h)}));let v=new ResizeObserver(h);e.isElement(r)&&v.observe(r),c&&v.observe(i),g.push(()=>v.disconnect());let y=0;if(o){let e=()=>{h(),y=window.requestAnimationFrame(e)};y=window.requestAnimationFrame(e),g.push(()=>window.cancelAnimationFrame(y))}return()=>{f?.cancel();for(let e of g)e()}}exports.autoUpdate=r;
 //# sourceMappingURL=auto-update.cjs.map

package/dist/auto-update.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.cjs","names":[],"sources":["../src/auto-update.ts"],"sourcesContent":["import { throttle } from '@vielzeug/arsenal/function';\n\nimport type { ReferenceElement } from './types';\n\nimport { flatTreeParent, isElement } from './utils';\n\nexport interface AutoUpdateOptions {\n  /** Watch the floating element for size changes. Default: `true`. */\n  observeFloating?: boolean;\n  /**\n   * Listen to scroll events on ancestor scroll containers of the reference element\n   * in addition to the window. More efficient in deeply nested DOMs.\n   * Set to `false` to use only a capture-phase window listener.\n   * Default: `true`.\n   */\n  observeAncestors?: boolean;\n  /** Track visual viewport scroll and resize (useful for pinch-zoom). Default: `true`. */\n  observeVisualViewport?: boolean;\n  /** Re-position on every animation frame. Use only when the reference itself animates. Default: `false`. */\n  animationFrame?: boolean;\n  /**\n   * Throttle update calls to at most once every `throttle` milliseconds.\n   * Uses a leading + trailing strategy: fires immediately, then once more after the interval.\n   * Default: `0` (no throttling).\n   */\n  throttle?: number;\n  /**\n   * Pause position updates while the reference element is scrolled out of the viewport.\n   * Uses IntersectionObserver to detect visibility. When the reference becomes visible again,\n   * one position update is fired immediately.\n   * Default: `true`.\n   */\n  pauseWhenHidden?: boolean;\n}\n\n/**\n * Collects the ancestor scroll containers of an element (up to and including the\n * nearest scrollable ancestor). Used to scope scroll listeners to the minimal\n * set of elements rather than relying on a capture-phase window listener.\n *\n * Walks the flat (rendering) tree via `flatTreeParent` — not light-DOM `parentElement` alone —\n * so a scroll container that lives inside the shadow tree a component's light-DOM content is\n * *projected into* (e.g. a dialog's own internal scroll region, reached only by crossing its\n * `<slot>`) is still found, instead of silently skipped.\n */\nfunction getScrollAncestors(el: Element): Element[] {\n  const ancestors: Element[] = [];\n  let current: Element | null = flatTreeParent(el);\n\n  while (current) {\n    const style = getComputedStyle(current);\n    const overflow = style.overflow + style.overflowX + style.overflowY;\n\n    if (/auto|scroll|overlay/.test(overflow)) {\n      ancestors.push(current);\n    }\n\n    current = flatTreeParent(current);\n  }\n\n  return ancestors;\n}\n\n/**\n * Calls `update` immediately and re-calls it whenever the reference or floating element\n * could have changed position: scroll, resize, ResizeObserver, or animation frames.\n *\n * By default, scroll listeners are attached to both ancestor scroll containers of the reference\n * AND the window (for document scroll). The ancestor listeners fire for nested container scrolls;\n * the window listener fires for page-level scroll. Set `observeAncestors: false` to use only a\n * capture-phase window listener.\n *\n * Returns a cleanup function that removes all listeners.\n *\n * @example\n * ```ts\n * const cleanup = autoUpdate(reference, floating, () => {\n *   const { x, y } = computePosition(reference, floating, options);\n *   floating.style.left = `${x}px`;\n *   floating.style.top  = `${y}px`;\n * });\n * // later:\n * cleanup();\n * ```\n */\nexport function autoUpdate(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  update: () => void,\n  {\n    animationFrame = false,\n    observeAncestors = true,\n    observeFloating = true,\n    observeVisualViewport = true,\n    pauseWhenHidden = true,\n    throttle: throttleMs = 0,\n  }: AutoUpdateOptions = {},\n): () => void {\n  const throttled = throttleMs > 0 ? throttle(update, throttleMs, { leading: true, trailing: true }) : null;\n  const notify = throttled ?? update;\n\n  // ── Visibility guard ─────────────────────────────────────────────────────────\n  let referenceVisible = true;\n  const conditionalNotify = (): void => {\n    if (referenceVisible) notify();\n  };\n\n  // Initial call always runs regardless of visibility state.\n  notify();\n\n  const cleanups: Array<() => void> = [];\n\n  // IntersectionObserver: pause updates when reference is off-screen.\n  if (pauseWhenHidden && isElement(reference) && typeof IntersectionObserver !== 'undefined') {\n    const io = new IntersectionObserver((entries) => {\n      referenceVisible = entries.at(-1)?.isIntersecting ?? true;\n\n      if (referenceVisible) notify(); // Re-position immediately when becoming visible.\n    });\n\n    io.observe(reference);\n    cleanups.push(() => io.disconnect());\n  }\n\n  // ── Scroll listeners ────────────────────────────────────────────────────────\n  if (isElement(reference) && observeAncestors) {\n    // Targeted ancestor listeners for nested container scroll.\n    const ancestors = getScrollAncestors(reference);\n\n    for (const ancestor of ancestors) {\n      ancestor.addEventListener('scroll', conditionalNotify, { passive: true });\n      cleanups.push(() => ancestor.removeEventListener('scroll', conditionalNotify));\n    }\n\n    // Always add window scroll for document-level scroll (non-capture, doesn't fire for nested containers).\n    window.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', conditionalNotify));\n  } else {\n    // VirtualReference or observeAncestors: false — capture-phase window listener catches all scrolls.\n    const scrollHandler = (e: Event): void => {\n      if (e.composedPath().includes(floating)) return;\n\n      conditionalNotify();\n    };\n\n    window.addEventListener('scroll', scrollHandler, { capture: true, passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', scrollHandler, { capture: true }));\n  }\n\n  window.addEventListener('resize', conditionalNotify, { passive: true });\n  cleanups.push(() => window.removeEventListener('resize', conditionalNotify));\n\n  const vv = observeVisualViewport ? window.visualViewport : null;\n\n  if (vv) {\n    vv.addEventListener('resize', conditionalNotify, { passive: true });\n    vv.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => {\n      vv.removeEventListener('resize', conditionalNotify);\n      vv.removeEventListener('scroll', conditionalNotify);\n    });\n  }\n\n  const ro = new ResizeObserver(conditionalNotify);\n\n  if (isElement(reference)) ro.observe(reference);\n\n  if (observeFloating) ro.observe(floating);\n\n  cleanups.push(() => ro.disconnect());\n\n  let frameId = 0;\n\n  if (animationFrame) {\n    const frameLoop = (): void => {\n      conditionalNotify();\n      frameId = window.requestAnimationFrame(frameLoop);\n    };\n\n    frameId = window.requestAnimationFrame(frameLoop);\n    cleanups.push(() => window.cancelAnimationFrame(frameId));\n  }\n\n  return (): void => {\n    throttled?.cancel();\n\n    for (const fn of cleanups) fn();\n  };\n}\n"],"mappings":"2EA6CA,SAAS,EAAmB,EAAwB,CAClD,IAAM,EAAuB,CAAC,EAC1B,EAA0B,EAAA,eAAe,CAAE,EAE/C,KAAO,GAAS,CACd,IAAM,EAAQ,iBAAiB,CAAO,EAChC,EAAW,EAAM,SAAW,EAAM,UAAY,EAAM,UAEtD,sBAAsB,KAAK,CAAQ,GACrC,EAAU,KAAK,CAAO,EAGxB,EAAU,EAAA,eAAe,CAAO,CAClC,CAEA,OAAO,CACT,CAwBA,SAAgB,EACd,EACA,EACA,EACA,CACE,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,kBAAkB,GAClB,SAAU,EAAa,GACF,CAAC,EACZ,CACZ,IAAM,EAAY,EAAa,GAAA,EAAI,EAAA,SAAA,CAAS,EAAQ,EAAY,CAAE,QAAS,GAAM,SAAU,EAAK,CAAC,EAAI,KAC/F,EAAS,GAAa,EAGxB,EAAmB,GACjB,MAAgC,CAChC,GAAkB,EAAO,CAC/B,EAGA,EAAO,EAEP,IAAM,EAA8B,CAAC,EAGrC,GAAI,GAAmB,EAAA,UAAU,CAAS,GAAK,OAAO,qBAAyB,IAAa,CAC1F,IAAM,EAAK,IAAI,qBAAsB,GAAY,CAC/C,EAAmB,EAAQ,GAAG,EAAE,CAAC,EAAE,gBAAkB,GAEjD,GAAkB,EAAO,CAC/B,CAAC,EAED,EAAG,QAAQ,CAAS,EACpB,EAAS,SAAW,EAAG,WAAW,CAAC,CACrC,CAGA,GAAI,EAAA,UAAU,CAAS,GAAK,EAAkB,CAE5C,IAAM,EAAY,EAAmB,CAAS,EAE9C,IAAK,IAAM,KAAY,EACrB,EAAS,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACxE,EAAS,SAAW,EAAS,oBAAoB,SAAU,CAAiB,CAAC,EAI/E,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,CAC7E,KAAO,CAEL,IAAM,EAAiB,GAAmB,CACpC,EAAE,aAAa,CAAC,CAAC,SAAS,CAAQ,GAEtC,EAAkB,CACpB,EAEA,OAAO,iBAAiB,SAAU,EAAe,CAAE,QAAS,GAAM,QAAS,EAAK,CAAC,EACjF,EAAS,SAAW,OAAO,oBAAoB,SAAU,EAAe,CAAE,QAAS,EAAK,CAAC,CAAC,CAC5F,CAEA,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,EAE3E,IAAM,EAAK,EAAwB,OAAO,eAAiB,KAEvD,IACF,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAS,SAAW,CAClB,EAAG,oBAAoB,SAAU,CAAiB,EAClD,EAAG,oBAAoB,SAAU,CAAiB,CACpD,CAAC,GAGH,IAAM,EAAK,IAAI,eAAe,CAAiB,EAE3C,EAAA,UAAU,CAAS,GAAG,EAAG,QAAQ,CAAS,EAE1C,GAAiB,EAAG,QAAQ,CAAQ,EAExC,EAAS,SAAW,EAAG,WAAW,CAAC,EAEnC,IAAI,EAAU,EAEd,GAAI,EAAgB,CAClB,IAAM,MAAwB,CAC5B,EAAkB,EAClB,EAAU,OAAO,sBAAsB,CAAS,CAClD,EAEA,EAAU,OAAO,sBAAsB,CAAS,EAChD,EAAS,SAAW,OAAO,qBAAqB,CAAO,CAAC,CAC1D,CAEA,UAAmB,CACjB,GAAW,OAAO,EAElB,IAAK,IAAM,KAAM,EAAU,EAAG,CAChC,CACF"}
+{"version":3,"file":"auto-update.cjs","names":[],"sources":["../src/auto-update.ts"],"sourcesContent":["import type { ReferenceElement } from './types';\n\nimport { flatTreeParent, isElement } from './utils';\n\ntype ThrottledUpdate = (() => void) & { cancel(): void };\n\nfunction throttle(update: () => void, delay: number): ThrottledUpdate {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let lastCall = 0;\n\n  const throttled = (() => {\n    const now = Date.now();\n    const remaining = delay - (now - lastCall);\n\n    if (remaining <= 0) {\n      if (timer !== undefined) clearTimeout(timer);\n\n      timer = undefined;\n      lastCall = now;\n      update();\n\n      return;\n    }\n\n    if (timer !== undefined) return;\n\n    timer = setTimeout(() => {\n      timer = undefined;\n      lastCall = Date.now();\n      update();\n    }, remaining);\n  }) as ThrottledUpdate;\n\n  throttled.cancel = (): void => {\n    if (timer !== undefined) clearTimeout(timer);\n\n    timer = undefined;\n  };\n\n  return throttled;\n}\n\nexport interface AutoUpdateOptions {\n  /** Watch the floating element for size changes. Default: `true`. */\n  observeFloating?: boolean;\n  /**\n   * Listen to scroll events on ancestor scroll containers of the reference element\n   * in addition to the window. More efficient in deeply nested DOMs.\n   * Set to `false` to use only a capture-phase window listener.\n   * Default: `true`.\n   */\n  observeAncestors?: boolean;\n  /** Track visual viewport scroll and resize (useful for pinch-zoom). Default: `true`. */\n  observeVisualViewport?: boolean;\n  /** Re-position on every animation frame. Use only when the reference itself animates. Default: `false`. */\n  animationFrame?: boolean;\n  /**\n   * Throttle update calls to at most once every `throttle` milliseconds.\n   * Uses a leading + trailing strategy: fires immediately, then once more after the interval.\n   * Default: `0` (no throttling).\n   */\n  throttle?: number;\n  /**\n   * Pause position updates while the reference element is scrolled out of the viewport.\n   * Uses IntersectionObserver to detect visibility. When the reference becomes visible again,\n   * one position update is fired immediately.\n   * Default: `true`.\n   */\n  pauseWhenHidden?: boolean;\n}\n\n/**\n * Collects the ancestor scroll containers of an element (up to and including the\n * nearest scrollable ancestor). Used to scope scroll listeners to the minimal\n * set of elements rather than relying on a capture-phase window listener.\n *\n * Walks the flat (rendering) tree via `flatTreeParent` — not light-DOM `parentElement` alone —\n * so a scroll container that lives inside the shadow tree a component's light-DOM content is\n * *projected into* (e.g. a dialog's own internal scroll region, reached only by crossing its\n * `<slot>`) is still found, instead of silently skipped.\n */\nfunction getScrollAncestors(el: Element): Element[] {\n  const ancestors: Element[] = [];\n  let current: Element | null = flatTreeParent(el);\n\n  while (current) {\n    const style = getComputedStyle(current);\n    const overflow = style.overflow + style.overflowX + style.overflowY;\n\n    if (/auto|scroll|overlay/.test(overflow)) {\n      ancestors.push(current);\n    }\n\n    current = flatTreeParent(current);\n  }\n\n  return ancestors;\n}\n\n/**\n * Calls `update` immediately and re-calls it whenever the reference or floating element\n * could have changed position: scroll, resize, ResizeObserver, or animation frames.\n *\n * By default, scroll listeners are attached to both ancestor scroll containers of the reference\n * AND the window (for document scroll). The ancestor listeners fire for nested container scrolls;\n * the window listener fires for page-level scroll. Set `observeAncestors: false` to use only a\n * capture-phase window listener.\n *\n * Returns a cleanup function that removes all listeners.\n *\n * @example\n * ```ts\n * const cleanup = autoUpdate(reference, floating, () => {\n *   const { x, y } = computePosition(reference, floating, options);\n *   floating.style.left = `${x}px`;\n *   floating.style.top  = `${y}px`;\n * });\n * // later:\n * cleanup();\n * ```\n */\nexport function autoUpdate(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  update: () => void,\n  {\n    animationFrame = false,\n    observeAncestors = true,\n    observeFloating = true,\n    observeVisualViewport = true,\n    pauseWhenHidden = true,\n    throttle: throttleMs = 0,\n  }: AutoUpdateOptions = {},\n): () => void {\n  const throttled = throttleMs > 0 ? throttle(update, throttleMs) : null;\n  const notify = throttled ?? update;\n\n  // ── Visibility guard ─────────────────────────────────────────────────────────\n  let referenceVisible = true;\n  const conditionalNotify = (): void => {\n    if (referenceVisible) notify();\n  };\n\n  // Initial call always runs regardless of visibility state.\n  notify();\n\n  const cleanups: Array<() => void> = [];\n\n  // IntersectionObserver: pause updates when reference is off-screen.\n  if (pauseWhenHidden && isElement(reference) && typeof IntersectionObserver !== 'undefined') {\n    const io = new IntersectionObserver((entries) => {\n      referenceVisible = entries.at(-1)?.isIntersecting ?? true;\n\n      if (referenceVisible) notify(); // Re-position immediately when becoming visible.\n    });\n\n    io.observe(reference);\n    cleanups.push(() => io.disconnect());\n  }\n\n  // ── Scroll listeners ────────────────────────────────────────────────────────\n  if (isElement(reference) && observeAncestors) {\n    // Targeted ancestor listeners for nested container scroll.\n    const ancestors = getScrollAncestors(reference);\n\n    for (const ancestor of ancestors) {\n      ancestor.addEventListener('scroll', conditionalNotify, { passive: true });\n      cleanups.push(() => ancestor.removeEventListener('scroll', conditionalNotify));\n    }\n\n    // Always add window scroll for document-level scroll (non-capture, doesn't fire for nested containers).\n    window.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', conditionalNotify));\n  } else {\n    // VirtualReference or observeAncestors: false — capture-phase window listener catches all scrolls.\n    const scrollHandler = (e: Event): void => {\n      if (e.composedPath().includes(floating)) return;\n\n      conditionalNotify();\n    };\n\n    window.addEventListener('scroll', scrollHandler, { capture: true, passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', scrollHandler, { capture: true }));\n  }\n\n  window.addEventListener('resize', conditionalNotify, { passive: true });\n  cleanups.push(() => window.removeEventListener('resize', conditionalNotify));\n\n  const vv = observeVisualViewport ? window.visualViewport : null;\n\n  if (vv) {\n    vv.addEventListener('resize', conditionalNotify, { passive: true });\n    vv.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => {\n      vv.removeEventListener('resize', conditionalNotify);\n      vv.removeEventListener('scroll', conditionalNotify);\n    });\n  }\n\n  const ro = new ResizeObserver(conditionalNotify);\n\n  if (isElement(reference)) ro.observe(reference);\n\n  if (observeFloating) ro.observe(floating);\n\n  cleanups.push(() => ro.disconnect());\n\n  let frameId = 0;\n\n  if (animationFrame) {\n    const frameLoop = (): void => {\n      conditionalNotify();\n      frameId = window.requestAnimationFrame(frameLoop);\n    };\n\n    frameId = window.requestAnimationFrame(frameLoop);\n    cleanups.push(() => window.cancelAnimationFrame(frameId));\n  }\n\n  return (): void => {\n    throttled?.cancel();\n\n    for (const fn of cleanups) fn();\n  };\n}\n"],"mappings":"+BAMA,SAAS,EAAS,EAAoB,EAAgC,CACpE,IAAI,EACA,EAAW,EAET,OAAmB,CACvB,IAAM,EAAM,KAAK,IAAI,EACf,EAAY,GAAS,EAAM,GAEjC,GAAI,GAAa,EAAG,CACd,IAAU,IAAA,IAAW,aAAa,CAAK,EAE3C,EAAQ,IAAA,GACR,EAAW,EACX,EAAO,EAEP,MACF,CAEI,IAAU,IAAA,KAEd,EAAQ,eAAiB,CACvB,EAAQ,IAAA,GACR,EAAW,KAAK,IAAI,EACpB,EAAO,CACT,EAAG,CAAS,EACd,GAQA,MANA,GAAU,WAAqB,CACzB,IAAU,IAAA,IAAW,aAAa,CAAK,EAE3C,EAAQ,IAAA,EACV,EAEO,CACT,CAyCA,SAAS,EAAmB,EAAwB,CAClD,IAAM,EAAuB,CAAC,EAC1B,EAA0B,EAAA,eAAe,CAAE,EAE/C,KAAO,GAAS,CACd,IAAM,EAAQ,iBAAiB,CAAO,EAChC,EAAW,EAAM,SAAW,EAAM,UAAY,EAAM,UAEtD,sBAAsB,KAAK,CAAQ,GACrC,EAAU,KAAK,CAAO,EAGxB,EAAU,EAAA,eAAe,CAAO,CAClC,CAEA,OAAO,CACT,CAwBA,SAAgB,EACd,EACA,EACA,EACA,CACE,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,kBAAkB,GAClB,SAAU,EAAa,GACF,CAAC,EACZ,CACZ,IAAM,EAAY,EAAa,EAAI,EAAS,EAAQ,CAAU,EAAI,KAC5D,EAAS,GAAa,EAGxB,EAAmB,GACjB,MAAgC,CAChC,GAAkB,EAAO,CAC/B,EAGA,EAAO,EAEP,IAAM,EAA8B,CAAC,EAGrC,GAAI,GAAmB,EAAA,UAAU,CAAS,GAAK,OAAO,qBAAyB,IAAa,CAC1F,IAAM,EAAK,IAAI,qBAAsB,GAAY,CAC/C,EAAmB,EAAQ,GAAG,EAAE,CAAC,EAAE,gBAAkB,GAEjD,GAAkB,EAAO,CAC/B,CAAC,EAED,EAAG,QAAQ,CAAS,EACpB,EAAS,SAAW,EAAG,WAAW,CAAC,CACrC,CAGA,GAAI,EAAA,UAAU,CAAS,GAAK,EAAkB,CAE5C,IAAM,EAAY,EAAmB,CAAS,EAE9C,IAAK,IAAM,KAAY,EACrB,EAAS,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACxE,EAAS,SAAW,EAAS,oBAAoB,SAAU,CAAiB,CAAC,EAI/E,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,CAC7E,KAAO,CAEL,IAAM,EAAiB,GAAmB,CACpC,EAAE,aAAa,CAAC,CAAC,SAAS,CAAQ,GAEtC,EAAkB,CACpB,EAEA,OAAO,iBAAiB,SAAU,EAAe,CAAE,QAAS,GAAM,QAAS,EAAK,CAAC,EACjF,EAAS,SAAW,OAAO,oBAAoB,SAAU,EAAe,CAAE,QAAS,EAAK,CAAC,CAAC,CAC5F,CAEA,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,EAE3E,IAAM,EAAK,EAAwB,OAAO,eAAiB,KAEvD,IACF,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAS,SAAW,CAClB,EAAG,oBAAoB,SAAU,CAAiB,EAClD,EAAG,oBAAoB,SAAU,CAAiB,CACpD,CAAC,GAGH,IAAM,EAAK,IAAI,eAAe,CAAiB,EAE3C,EAAA,UAAU,CAAS,GAAG,EAAG,QAAQ,CAAS,EAE1C,GAAiB,EAAG,QAAQ,CAAQ,EAExC,EAAS,SAAW,EAAG,WAAW,CAAC,EAEnC,IAAI,EAAU,EAEd,GAAI,EAAgB,CAClB,IAAM,MAAwB,CAC5B,EAAkB,EAClB,EAAU,OAAO,sBAAsB,CAAS,CAClD,EAEA,EAAU,OAAO,sBAAsB,CAAS,EAChD,EAAS,SAAW,OAAO,qBAAqB,CAAO,CAAC,CAC1D,CAEA,UAAmB,CACjB,GAAW,OAAO,EAElB,IAAK,IAAM,KAAM,EAAU,EAAG,CAChC,CACF"}

package/dist/auto-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../src/auto-update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2GAA2G;IAC3G,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA8BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,IAAI,EAClB,EACE,cAAsB,EACtB,gBAAuB,EACvB,eAAsB,EACtB,qBAA4B,EAC5B,eAAsB,EACtB,QAAQ,EAAE,UAAc,GACzB,GAAE,iBAAsB,GACxB,MAAM,IAAI,CA2FZ"}
+{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../src/auto-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA0ChD,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2GAA2G;IAC3G,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA8BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,IAAI,EAClB,EACE,cAAsB,EACtB,gBAAuB,EACvB,eAAsB,EACtB,qBAA4B,EAC5B,eAAsB,EACtB,QAAQ,EAAE,UAAc,GACzB,GAAE,iBAAsB,GACxB,MAAM,IAAI,CA2FZ"}

package/dist/auto-update.js

@@ -1,2 +1,2 @@
-import{flatTreeParent as e,isElement as t}from"./utils.js";import{throttle as n}from"@vielzeug/arsenal/function";function r(t){let n=[],r=e(t);for(;r;){let t=getComputedStyle(r),i=t.overflow+t.overflowX+t.overflowY;/auto|scroll|overlay/.test(i)&&n.push(r),r=e(r)}return n}function i(e,i,a,{animationFrame:o=!1,observeAncestors:s=!0,observeFloating:c=!0,observeVisualViewport:l=!0,pauseWhenHidden:u=!0,throttle:d=0}={}){let f=d>0?n(a,d,{leading:!0,trailing:!0}):null,p=f??a,m=!0,h=()=>{m&&p()};p();let g=[];if(u&&t(e)&&typeof IntersectionObserver<`u`){let t=new IntersectionObserver(e=>{m=e.at(-1)?.isIntersecting??!0,m&&p()});t.observe(e),g.push(()=>t.disconnect())}if(t(e)&&s){let t=r(e);for(let e of t)e.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>e.removeEventListener(`scroll`,h));window.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>window.removeEventListener(`scroll`,h))}else{let e=e=>{e.composedPath().includes(i)||h()};window.addEventListener(`scroll`,e,{capture:!0,passive:!0}),g.push(()=>window.removeEventListener(`scroll`,e,{capture:!0}))}window.addEventListener(`resize`,h,{passive:!0}),g.push(()=>window.removeEventListener(`resize`,h));let _=l?window.visualViewport:null;_&&(_.addEventListener(`resize`,h,{passive:!0}),_.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>{_.removeEventListener(`resize`,h),_.removeEventListener(`scroll`,h)}));let v=new ResizeObserver(h);t(e)&&v.observe(e),c&&v.observe(i),g.push(()=>v.disconnect());let y=0;if(o){let e=()=>{h(),y=window.requestAnimationFrame(e)};y=window.requestAnimationFrame(e),g.push(()=>window.cancelAnimationFrame(y))}return()=>{f?.cancel();for(let e of g)e()}}export{i as autoUpdate};
+import{flatTreeParent as e,isElement as t}from"./utils.js";function n(e,t){let n,r=0,i=(()=>{let i=Date.now(),a=t-(i-r);if(a<=0){n!==void 0&&clearTimeout(n),n=void 0,r=i,e();return}n===void 0&&(n=setTimeout(()=>{n=void 0,r=Date.now(),e()},a))});return i.cancel=()=>{n!==void 0&&clearTimeout(n),n=void 0},i}function r(t){let n=[],r=e(t);for(;r;){let t=getComputedStyle(r),i=t.overflow+t.overflowX+t.overflowY;/auto|scroll|overlay/.test(i)&&n.push(r),r=e(r)}return n}function i(e,i,a,{animationFrame:o=!1,observeAncestors:s=!0,observeFloating:c=!0,observeVisualViewport:l=!0,pauseWhenHidden:u=!0,throttle:d=0}={}){let f=d>0?n(a,d):null,p=f??a,m=!0,h=()=>{m&&p()};p();let g=[];if(u&&t(e)&&typeof IntersectionObserver<`u`){let t=new IntersectionObserver(e=>{m=e.at(-1)?.isIntersecting??!0,m&&p()});t.observe(e),g.push(()=>t.disconnect())}if(t(e)&&s){let t=r(e);for(let e of t)e.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>e.removeEventListener(`scroll`,h));window.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>window.removeEventListener(`scroll`,h))}else{let e=e=>{e.composedPath().includes(i)||h()};window.addEventListener(`scroll`,e,{capture:!0,passive:!0}),g.push(()=>window.removeEventListener(`scroll`,e,{capture:!0}))}window.addEventListener(`resize`,h,{passive:!0}),g.push(()=>window.removeEventListener(`resize`,h));let _=l?window.visualViewport:null;_&&(_.addEventListener(`resize`,h,{passive:!0}),_.addEventListener(`scroll`,h,{passive:!0}),g.push(()=>{_.removeEventListener(`resize`,h),_.removeEventListener(`scroll`,h)}));let v=new ResizeObserver(h);t(e)&&v.observe(e),c&&v.observe(i),g.push(()=>v.disconnect());let y=0;if(o){let e=()=>{h(),y=window.requestAnimationFrame(e)};y=window.requestAnimationFrame(e),g.push(()=>window.cancelAnimationFrame(y))}return()=>{f?.cancel();for(let e of g)e()}}export{i as autoUpdate};
 //# sourceMappingURL=auto-update.js.map

package/dist/auto-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.js","names":[],"sources":["../src/auto-update.ts"],"sourcesContent":["import { throttle } from '@vielzeug/arsenal/function';\n\nimport type { ReferenceElement } from './types';\n\nimport { flatTreeParent, isElement } from './utils';\n\nexport interface AutoUpdateOptions {\n  /** Watch the floating element for size changes. Default: `true`. */\n  observeFloating?: boolean;\n  /**\n   * Listen to scroll events on ancestor scroll containers of the reference element\n   * in addition to the window. More efficient in deeply nested DOMs.\n   * Set to `false` to use only a capture-phase window listener.\n   * Default: `true`.\n   */\n  observeAncestors?: boolean;\n  /** Track visual viewport scroll and resize (useful for pinch-zoom). Default: `true`. */\n  observeVisualViewport?: boolean;\n  /** Re-position on every animation frame. Use only when the reference itself animates. Default: `false`. */\n  animationFrame?: boolean;\n  /**\n   * Throttle update calls to at most once every `throttle` milliseconds.\n   * Uses a leading + trailing strategy: fires immediately, then once more after the interval.\n   * Default: `0` (no throttling).\n   */\n  throttle?: number;\n  /**\n   * Pause position updates while the reference element is scrolled out of the viewport.\n   * Uses IntersectionObserver to detect visibility. When the reference becomes visible again,\n   * one position update is fired immediately.\n   * Default: `true`.\n   */\n  pauseWhenHidden?: boolean;\n}\n\n/**\n * Collects the ancestor scroll containers of an element (up to and including the\n * nearest scrollable ancestor). Used to scope scroll listeners to the minimal\n * set of elements rather than relying on a capture-phase window listener.\n *\n * Walks the flat (rendering) tree via `flatTreeParent` — not light-DOM `parentElement` alone —\n * so a scroll container that lives inside the shadow tree a component's light-DOM content is\n * *projected into* (e.g. a dialog's own internal scroll region, reached only by crossing its\n * `<slot>`) is still found, instead of silently skipped.\n */\nfunction getScrollAncestors(el: Element): Element[] {\n  const ancestors: Element[] = [];\n  let current: Element | null = flatTreeParent(el);\n\n  while (current) {\n    const style = getComputedStyle(current);\n    const overflow = style.overflow + style.overflowX + style.overflowY;\n\n    if (/auto|scroll|overlay/.test(overflow)) {\n      ancestors.push(current);\n    }\n\n    current = flatTreeParent(current);\n  }\n\n  return ancestors;\n}\n\n/**\n * Calls `update` immediately and re-calls it whenever the reference or floating element\n * could have changed position: scroll, resize, ResizeObserver, or animation frames.\n *\n * By default, scroll listeners are attached to both ancestor scroll containers of the reference\n * AND the window (for document scroll). The ancestor listeners fire for nested container scrolls;\n * the window listener fires for page-level scroll. Set `observeAncestors: false` to use only a\n * capture-phase window listener.\n *\n * Returns a cleanup function that removes all listeners.\n *\n * @example\n * ```ts\n * const cleanup = autoUpdate(reference, floating, () => {\n *   const { x, y } = computePosition(reference, floating, options);\n *   floating.style.left = `${x}px`;\n *   floating.style.top  = `${y}px`;\n * });\n * // later:\n * cleanup();\n * ```\n */\nexport function autoUpdate(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  update: () => void,\n  {\n    animationFrame = false,\n    observeAncestors = true,\n    observeFloating = true,\n    observeVisualViewport = true,\n    pauseWhenHidden = true,\n    throttle: throttleMs = 0,\n  }: AutoUpdateOptions = {},\n): () => void {\n  const throttled = throttleMs > 0 ? throttle(update, throttleMs, { leading: true, trailing: true }) : null;\n  const notify = throttled ?? update;\n\n  // ── Visibility guard ─────────────────────────────────────────────────────────\n  let referenceVisible = true;\n  const conditionalNotify = (): void => {\n    if (referenceVisible) notify();\n  };\n\n  // Initial call always runs regardless of visibility state.\n  notify();\n\n  const cleanups: Array<() => void> = [];\n\n  // IntersectionObserver: pause updates when reference is off-screen.\n  if (pauseWhenHidden && isElement(reference) && typeof IntersectionObserver !== 'undefined') {\n    const io = new IntersectionObserver((entries) => {\n      referenceVisible = entries.at(-1)?.isIntersecting ?? true;\n\n      if (referenceVisible) notify(); // Re-position immediately when becoming visible.\n    });\n\n    io.observe(reference);\n    cleanups.push(() => io.disconnect());\n  }\n\n  // ── Scroll listeners ────────────────────────────────────────────────────────\n  if (isElement(reference) && observeAncestors) {\n    // Targeted ancestor listeners for nested container scroll.\n    const ancestors = getScrollAncestors(reference);\n\n    for (const ancestor of ancestors) {\n      ancestor.addEventListener('scroll', conditionalNotify, { passive: true });\n      cleanups.push(() => ancestor.removeEventListener('scroll', conditionalNotify));\n    }\n\n    // Always add window scroll for document-level scroll (non-capture, doesn't fire for nested containers).\n    window.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', conditionalNotify));\n  } else {\n    // VirtualReference or observeAncestors: false — capture-phase window listener catches all scrolls.\n    const scrollHandler = (e: Event): void => {\n      if (e.composedPath().includes(floating)) return;\n\n      conditionalNotify();\n    };\n\n    window.addEventListener('scroll', scrollHandler, { capture: true, passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', scrollHandler, { capture: true }));\n  }\n\n  window.addEventListener('resize', conditionalNotify, { passive: true });\n  cleanups.push(() => window.removeEventListener('resize', conditionalNotify));\n\n  const vv = observeVisualViewport ? window.visualViewport : null;\n\n  if (vv) {\n    vv.addEventListener('resize', conditionalNotify, { passive: true });\n    vv.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => {\n      vv.removeEventListener('resize', conditionalNotify);\n      vv.removeEventListener('scroll', conditionalNotify);\n    });\n  }\n\n  const ro = new ResizeObserver(conditionalNotify);\n\n  if (isElement(reference)) ro.observe(reference);\n\n  if (observeFloating) ro.observe(floating);\n\n  cleanups.push(() => ro.disconnect());\n\n  let frameId = 0;\n\n  if (animationFrame) {\n    const frameLoop = (): void => {\n      conditionalNotify();\n      frameId = window.requestAnimationFrame(frameLoop);\n    };\n\n    frameId = window.requestAnimationFrame(frameLoop);\n    cleanups.push(() => window.cancelAnimationFrame(frameId));\n  }\n\n  return (): void => {\n    throttled?.cancel();\n\n    for (const fn of cleanups) fn();\n  };\n}\n"],"mappings":"iHA6CA,SAAS,EAAmB,EAAwB,CAClD,IAAM,EAAuB,CAAC,EAC1B,EAA0B,EAAe,CAAE,EAE/C,KAAO,GAAS,CACd,IAAM,EAAQ,iBAAiB,CAAO,EAChC,EAAW,EAAM,SAAW,EAAM,UAAY,EAAM,UAEtD,sBAAsB,KAAK,CAAQ,GACrC,EAAU,KAAK,CAAO,EAGxB,EAAU,EAAe,CAAO,CAClC,CAEA,OAAO,CACT,CAwBA,SAAgB,EACd,EACA,EACA,EACA,CACE,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,kBAAkB,GAClB,SAAU,EAAa,GACF,CAAC,EACZ,CACZ,IAAM,EAAY,EAAa,EAAI,EAAS,EAAQ,EAAY,CAAE,QAAS,GAAM,SAAU,EAAK,CAAC,EAAI,KAC/F,EAAS,GAAa,EAGxB,EAAmB,GACjB,MAAgC,CAChC,GAAkB,EAAO,CAC/B,EAGA,EAAO,EAEP,IAAM,EAA8B,CAAC,EAGrC,GAAI,GAAmB,EAAU,CAAS,GAAK,OAAO,qBAAyB,IAAa,CAC1F,IAAM,EAAK,IAAI,qBAAsB,GAAY,CAC/C,EAAmB,EAAQ,GAAG,EAAE,CAAC,EAAE,gBAAkB,GAEjD,GAAkB,EAAO,CAC/B,CAAC,EAED,EAAG,QAAQ,CAAS,EACpB,EAAS,SAAW,EAAG,WAAW,CAAC,CACrC,CAGA,GAAI,EAAU,CAAS,GAAK,EAAkB,CAE5C,IAAM,EAAY,EAAmB,CAAS,EAE9C,IAAK,IAAM,KAAY,EACrB,EAAS,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACxE,EAAS,SAAW,EAAS,oBAAoB,SAAU,CAAiB,CAAC,EAI/E,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,CAC7E,KAAO,CAEL,IAAM,EAAiB,GAAmB,CACpC,EAAE,aAAa,CAAC,CAAC,SAAS,CAAQ,GAEtC,EAAkB,CACpB,EAEA,OAAO,iBAAiB,SAAU,EAAe,CAAE,QAAS,GAAM,QAAS,EAAK,CAAC,EACjF,EAAS,SAAW,OAAO,oBAAoB,SAAU,EAAe,CAAE,QAAS,EAAK,CAAC,CAAC,CAC5F,CAEA,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,EAE3E,IAAM,EAAK,EAAwB,OAAO,eAAiB,KAEvD,IACF,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAS,SAAW,CAClB,EAAG,oBAAoB,SAAU,CAAiB,EAClD,EAAG,oBAAoB,SAAU,CAAiB,CACpD,CAAC,GAGH,IAAM,EAAK,IAAI,eAAe,CAAiB,EAE3C,EAAU,CAAS,GAAG,EAAG,QAAQ,CAAS,EAE1C,GAAiB,EAAG,QAAQ,CAAQ,EAExC,EAAS,SAAW,EAAG,WAAW,CAAC,EAEnC,IAAI,EAAU,EAEd,GAAI,EAAgB,CAClB,IAAM,MAAwB,CAC5B,EAAkB,EAClB,EAAU,OAAO,sBAAsB,CAAS,CAClD,EAEA,EAAU,OAAO,sBAAsB,CAAS,EAChD,EAAS,SAAW,OAAO,qBAAqB,CAAO,CAAC,CAC1D,CAEA,UAAmB,CACjB,GAAW,OAAO,EAElB,IAAK,IAAM,KAAM,EAAU,EAAG,CAChC,CACF"}
+{"version":3,"file":"auto-update.js","names":[],"sources":["../src/auto-update.ts"],"sourcesContent":["import type { ReferenceElement } from './types';\n\nimport { flatTreeParent, isElement } from './utils';\n\ntype ThrottledUpdate = (() => void) & { cancel(): void };\n\nfunction throttle(update: () => void, delay: number): ThrottledUpdate {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let lastCall = 0;\n\n  const throttled = (() => {\n    const now = Date.now();\n    const remaining = delay - (now - lastCall);\n\n    if (remaining <= 0) {\n      if (timer !== undefined) clearTimeout(timer);\n\n      timer = undefined;\n      lastCall = now;\n      update();\n\n      return;\n    }\n\n    if (timer !== undefined) return;\n\n    timer = setTimeout(() => {\n      timer = undefined;\n      lastCall = Date.now();\n      update();\n    }, remaining);\n  }) as ThrottledUpdate;\n\n  throttled.cancel = (): void => {\n    if (timer !== undefined) clearTimeout(timer);\n\n    timer = undefined;\n  };\n\n  return throttled;\n}\n\nexport interface AutoUpdateOptions {\n  /** Watch the floating element for size changes. Default: `true`. */\n  observeFloating?: boolean;\n  /**\n   * Listen to scroll events on ancestor scroll containers of the reference element\n   * in addition to the window. More efficient in deeply nested DOMs.\n   * Set to `false` to use only a capture-phase window listener.\n   * Default: `true`.\n   */\n  observeAncestors?: boolean;\n  /** Track visual viewport scroll and resize (useful for pinch-zoom). Default: `true`. */\n  observeVisualViewport?: boolean;\n  /** Re-position on every animation frame. Use only when the reference itself animates. Default: `false`. */\n  animationFrame?: boolean;\n  /**\n   * Throttle update calls to at most once every `throttle` milliseconds.\n   * Uses a leading + trailing strategy: fires immediately, then once more after the interval.\n   * Default: `0` (no throttling).\n   */\n  throttle?: number;\n  /**\n   * Pause position updates while the reference element is scrolled out of the viewport.\n   * Uses IntersectionObserver to detect visibility. When the reference becomes visible again,\n   * one position update is fired immediately.\n   * Default: `true`.\n   */\n  pauseWhenHidden?: boolean;\n}\n\n/**\n * Collects the ancestor scroll containers of an element (up to and including the\n * nearest scrollable ancestor). Used to scope scroll listeners to the minimal\n * set of elements rather than relying on a capture-phase window listener.\n *\n * Walks the flat (rendering) tree via `flatTreeParent` — not light-DOM `parentElement` alone —\n * so a scroll container that lives inside the shadow tree a component's light-DOM content is\n * *projected into* (e.g. a dialog's own internal scroll region, reached only by crossing its\n * `<slot>`) is still found, instead of silently skipped.\n */\nfunction getScrollAncestors(el: Element): Element[] {\n  const ancestors: Element[] = [];\n  let current: Element | null = flatTreeParent(el);\n\n  while (current) {\n    const style = getComputedStyle(current);\n    const overflow = style.overflow + style.overflowX + style.overflowY;\n\n    if (/auto|scroll|overlay/.test(overflow)) {\n      ancestors.push(current);\n    }\n\n    current = flatTreeParent(current);\n  }\n\n  return ancestors;\n}\n\n/**\n * Calls `update` immediately and re-calls it whenever the reference or floating element\n * could have changed position: scroll, resize, ResizeObserver, or animation frames.\n *\n * By default, scroll listeners are attached to both ancestor scroll containers of the reference\n * AND the window (for document scroll). The ancestor listeners fire for nested container scrolls;\n * the window listener fires for page-level scroll. Set `observeAncestors: false` to use only a\n * capture-phase window listener.\n *\n * Returns a cleanup function that removes all listeners.\n *\n * @example\n * ```ts\n * const cleanup = autoUpdate(reference, floating, () => {\n *   const { x, y } = computePosition(reference, floating, options);\n *   floating.style.left = `${x}px`;\n *   floating.style.top  = `${y}px`;\n * });\n * // later:\n * cleanup();\n * ```\n */\nexport function autoUpdate(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  update: () => void,\n  {\n    animationFrame = false,\n    observeAncestors = true,\n    observeFloating = true,\n    observeVisualViewport = true,\n    pauseWhenHidden = true,\n    throttle: throttleMs = 0,\n  }: AutoUpdateOptions = {},\n): () => void {\n  const throttled = throttleMs > 0 ? throttle(update, throttleMs) : null;\n  const notify = throttled ?? update;\n\n  // ── Visibility guard ─────────────────────────────────────────────────────────\n  let referenceVisible = true;\n  const conditionalNotify = (): void => {\n    if (referenceVisible) notify();\n  };\n\n  // Initial call always runs regardless of visibility state.\n  notify();\n\n  const cleanups: Array<() => void> = [];\n\n  // IntersectionObserver: pause updates when reference is off-screen.\n  if (pauseWhenHidden && isElement(reference) && typeof IntersectionObserver !== 'undefined') {\n    const io = new IntersectionObserver((entries) => {\n      referenceVisible = entries.at(-1)?.isIntersecting ?? true;\n\n      if (referenceVisible) notify(); // Re-position immediately when becoming visible.\n    });\n\n    io.observe(reference);\n    cleanups.push(() => io.disconnect());\n  }\n\n  // ── Scroll listeners ────────────────────────────────────────────────────────\n  if (isElement(reference) && observeAncestors) {\n    // Targeted ancestor listeners for nested container scroll.\n    const ancestors = getScrollAncestors(reference);\n\n    for (const ancestor of ancestors) {\n      ancestor.addEventListener('scroll', conditionalNotify, { passive: true });\n      cleanups.push(() => ancestor.removeEventListener('scroll', conditionalNotify));\n    }\n\n    // Always add window scroll for document-level scroll (non-capture, doesn't fire for nested containers).\n    window.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', conditionalNotify));\n  } else {\n    // VirtualReference or observeAncestors: false — capture-phase window listener catches all scrolls.\n    const scrollHandler = (e: Event): void => {\n      if (e.composedPath().includes(floating)) return;\n\n      conditionalNotify();\n    };\n\n    window.addEventListener('scroll', scrollHandler, { capture: true, passive: true });\n    cleanups.push(() => window.removeEventListener('scroll', scrollHandler, { capture: true }));\n  }\n\n  window.addEventListener('resize', conditionalNotify, { passive: true });\n  cleanups.push(() => window.removeEventListener('resize', conditionalNotify));\n\n  const vv = observeVisualViewport ? window.visualViewport : null;\n\n  if (vv) {\n    vv.addEventListener('resize', conditionalNotify, { passive: true });\n    vv.addEventListener('scroll', conditionalNotify, { passive: true });\n    cleanups.push(() => {\n      vv.removeEventListener('resize', conditionalNotify);\n      vv.removeEventListener('scroll', conditionalNotify);\n    });\n  }\n\n  const ro = new ResizeObserver(conditionalNotify);\n\n  if (isElement(reference)) ro.observe(reference);\n\n  if (observeFloating) ro.observe(floating);\n\n  cleanups.push(() => ro.disconnect());\n\n  let frameId = 0;\n\n  if (animationFrame) {\n    const frameLoop = (): void => {\n      conditionalNotify();\n      frameId = window.requestAnimationFrame(frameLoop);\n    };\n\n    frameId = window.requestAnimationFrame(frameLoop);\n    cleanups.push(() => window.cancelAnimationFrame(frameId));\n  }\n\n  return (): void => {\n    throttled?.cancel();\n\n    for (const fn of cleanups) fn();\n  };\n}\n"],"mappings":"2DAMA,SAAS,EAAS,EAAoB,EAAgC,CACpE,IAAI,EACA,EAAW,EAET,OAAmB,CACvB,IAAM,EAAM,KAAK,IAAI,EACf,EAAY,GAAS,EAAM,GAEjC,GAAI,GAAa,EAAG,CACd,IAAU,IAAA,IAAW,aAAa,CAAK,EAE3C,EAAQ,IAAA,GACR,EAAW,EACX,EAAO,EAEP,MACF,CAEI,IAAU,IAAA,KAEd,EAAQ,eAAiB,CACvB,EAAQ,IAAA,GACR,EAAW,KAAK,IAAI,EACpB,EAAO,CACT,EAAG,CAAS,EACd,GAQA,MANA,GAAU,WAAqB,CACzB,IAAU,IAAA,IAAW,aAAa,CAAK,EAE3C,EAAQ,IAAA,EACV,EAEO,CACT,CAyCA,SAAS,EAAmB,EAAwB,CAClD,IAAM,EAAuB,CAAC,EAC1B,EAA0B,EAAe,CAAE,EAE/C,KAAO,GAAS,CACd,IAAM,EAAQ,iBAAiB,CAAO,EAChC,EAAW,EAAM,SAAW,EAAM,UAAY,EAAM,UAEtD,sBAAsB,KAAK,CAAQ,GACrC,EAAU,KAAK,CAAO,EAGxB,EAAU,EAAe,CAAO,CAClC,CAEA,OAAO,CACT,CAwBA,SAAgB,EACd,EACA,EACA,EACA,CACE,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,kBAAkB,GAClB,SAAU,EAAa,GACF,CAAC,EACZ,CACZ,IAAM,EAAY,EAAa,EAAI,EAAS,EAAQ,CAAU,EAAI,KAC5D,EAAS,GAAa,EAGxB,EAAmB,GACjB,MAAgC,CAChC,GAAkB,EAAO,CAC/B,EAGA,EAAO,EAEP,IAAM,EAA8B,CAAC,EAGrC,GAAI,GAAmB,EAAU,CAAS,GAAK,OAAO,qBAAyB,IAAa,CAC1F,IAAM,EAAK,IAAI,qBAAsB,GAAY,CAC/C,EAAmB,EAAQ,GAAG,EAAE,CAAC,EAAE,gBAAkB,GAEjD,GAAkB,EAAO,CAC/B,CAAC,EAED,EAAG,QAAQ,CAAS,EACpB,EAAS,SAAW,EAAG,WAAW,CAAC,CACrC,CAGA,GAAI,EAAU,CAAS,GAAK,EAAkB,CAE5C,IAAM,EAAY,EAAmB,CAAS,EAE9C,IAAK,IAAM,KAAY,EACrB,EAAS,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACxE,EAAS,SAAW,EAAS,oBAAoB,SAAU,CAAiB,CAAC,EAI/E,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,CAC7E,KAAO,CAEL,IAAM,EAAiB,GAAmB,CACpC,EAAE,aAAa,CAAC,CAAC,SAAS,CAAQ,GAEtC,EAAkB,CACpB,EAEA,OAAO,iBAAiB,SAAU,EAAe,CAAE,QAAS,GAAM,QAAS,EAAK,CAAC,EACjF,EAAS,SAAW,OAAO,oBAAoB,SAAU,EAAe,CAAE,QAAS,EAAK,CAAC,CAAC,CAC5F,CAEA,OAAO,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EACtE,EAAS,SAAW,OAAO,oBAAoB,SAAU,CAAiB,CAAC,EAE3E,IAAM,EAAK,EAAwB,OAAO,eAAiB,KAEvD,IACF,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAG,iBAAiB,SAAU,EAAmB,CAAE,QAAS,EAAK,CAAC,EAClE,EAAS,SAAW,CAClB,EAAG,oBAAoB,SAAU,CAAiB,EAClD,EAAG,oBAAoB,SAAU,CAAiB,CACpD,CAAC,GAGH,IAAM,EAAK,IAAI,eAAe,CAAiB,EAE3C,EAAU,CAAS,GAAG,EAAG,QAAQ,CAAS,EAE1C,GAAiB,EAAG,QAAQ,CAAQ,EAExC,EAAS,SAAW,EAAG,WAAW,CAAC,EAEnC,IAAI,EAAU,EAEd,GAAI,EAAgB,CAClB,IAAM,MAAwB,CAC5B,EAAkB,EAClB,EAAU,OAAO,sBAAsB,CAAS,CAClD,EAEA,EAAU,OAAO,sBAAsB,CAAS,EAChD,EAAS,SAAW,OAAO,qBAAqB,CAAO,CAAC,CAC1D,CAEA,UAAmB,CACjB,GAAW,OAAO,EAElB,IAAK,IAAM,KAAM,EAAU,EAAG,CAChC,CACF"}

package/dist/core.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs"),t=require("./utils.cjs");require("./_dev.cjs");function n(e,n){return{floating:t.toRect(n.getBoundingClientRect()),reference:t.toRect(e.getBoundingClientRect())}}function r(e,t){return t?{...e,middlewareData:t.data?Object.assign(Object.create(null),e.middlewareData,t.data):e.middlewareData,placement:t.placement??e.placement,x:t.x??e.x,y:t.y??e.y}:e}var i=8;function a(e,t,n){return Promise.resolve().then(()=>s(e,t,n))}function o(e,t,n){return new Promise((r,i)=>{requestAnimationFrame(()=>{try{r(s(e,t,n))}catch(e){i(e)}})})}function s(a,o,{boundary:s,containingBlock:c,middleware:l=[],padding:u,placement:d=`bottom`}={}){let f=l.filter(Boolean),p=f.map(e=>{let n=e[t.MIDDLEWARE_NAME];return typeof n==`string`?n:null});t.validateMiddlewareNames(p);let m=d,h={},g=n(a,o);for(let e=0;e<i;e+=1){let e={...t.baseCoords(m,g.reference,g.floating),boundary:s,elements:{floating:o,reference:a},initialPlacement:d,middlewareData:h,padding:u,placement:m,rects:g},i;for(let t of f){let n=t(e);if(e=r(e,n),h=e.middlewareData,i=n?.reset,i)break}if(!i){let t={middlewareData:e.middlewareData,placement:e.placement,x:e.x,y:e.y};if(c){let e=c.getBoundingClientRect();return{...t,x:t.x-e.x,y:t.y-e.y}}return t}i.remeasure?g=n(a,o):i.rects!=null&&(g=i.rects),m=i.placement??e.placement}throw new e.OrbitConfigError(`Middleware triggered too many resets in a single compute cycle.`)}exports.computePosition=s,exports.computePositionAsync=a,exports.computePositionRaf=o,exports.getRects=n;
+const e=require("./utils.cjs");require("./_dev.cjs");const t=require("./errors.cjs");function n(t,n){return{floating:e.toRect(n.getBoundingClientRect()),reference:e.toRect(t.getBoundingClientRect())}}function r(e,t){return t?{...e,middlewareData:t.data?Object.assign(Object.create(null),e.middlewareData,t.data):e.middlewareData,placement:t.placement??e.placement,x:t.x??e.x,y:t.y??e.y}:e}var i=8;function a(e,t,n){return Promise.resolve().then(()=>s(e,t,n))}function o(e,t,n){return new Promise((r,i)=>{requestAnimationFrame(()=>{try{r(s(e,t,n))}catch(e){i(e)}})})}function s(a,o,{boundary:s,containingBlock:c,middleware:l=[],padding:u,placement:d=`bottom`}={}){let f=l,p=d,m={},h=n(a,o);for(let t=0;t<i;t+=1){let t={...e.baseCoords(p,h.reference,h.floating),boundary:s,elements:{floating:o,reference:a},initialPlacement:d,middlewareData:m,padding:u,placement:p,rects:h},i;for(let e of f){let n=e(t);if(t=r(t,n),m=t.middlewareData,i=n?.reset,i)break}if(!i){let e={middlewareData:t.middlewareData,placement:t.placement,x:t.x,y:t.y};if(c){let t=c.getBoundingClientRect();return{...e,x:e.x-t.x,y:e.y-t.y}}return e}i.remeasure?h=n(a,o):i.rects!=null&&(h=i.rects),p=i.placement??t.placement}throw new t.OrbitConfigError(`Middleware triggered too many resets in a single compute cycle.`)}exports.computePosition=s,exports.computePositionAsync=a,exports.computePositionRaf=o,exports.getRects=n;
 //# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.cjs","names":[],"sources":["../src/core.ts"],"sourcesContent":["import type {\n  ComputePositionOptions,\n  ComputePositionResult,\n  Middleware,\n  MiddlewareData,\n  MiddlewareReset,\n  MiddlewareResult,\n  MiddlewareState,\n  ReferenceElement,\n} from './types';\n\nimport { devOnly, warn } from './_dev';\nimport { OrbitConfigError } from './errors';\nimport { baseCoords, MIDDLEWARE_NAME, toRect, validateMiddlewareNames } from './utils';\n\n// ── DOM helpers ────────────────────────────────────────────────────────────────────────────────\n\n/** Reads the bounding rects of the reference and floating elements from the DOM. */\nexport function getRects(reference: ReferenceElement, floating: HTMLElement): MiddlewareState['rects'] {\n  return {\n    floating: toRect(floating.getBoundingClientRect()),\n    reference: toRect(reference.getBoundingClientRect()),\n  };\n}\n\n// ── Internal state helpers ───────────────────────────────────────────────────────────\n\nfunction mergeState(state: MiddlewareState, result: MiddlewareResult | void): MiddlewareState {\n  if (!result) return state;\n\n  return {\n    ...state,\n    middlewareData: result.data\n      ? (Object.assign(Object.create(null), state.middlewareData, result.data) as MiddlewareData)\n      : state.middlewareData,\n    placement: result.placement ?? state.placement,\n    x: result.x ?? state.x,\n    y: result.y ?? state.y,\n  };\n}\n\n// ── Constants ─────────────────────────────────────────────────────────────────────────────────\n\n/** Maximum number of pipeline restarts allowed per `computePosition` call before throwing. */\nconst MAX_RESETS = 8;\n\n// ── Public API ────────────────────────────────────────────────────────────────────────────────\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **microtask** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful for async component lifecycles (e.g. `await nextTick()` in Vue/React) where the\n * synchronous `computePosition` would read stale DOM measurements because layout has not been\n * committed yet. Note: this defers to the microtask queue, not the next animation frame — if you\n * need post-layout measurements use `requestAnimationFrame` instead.\n *\n * @example\n * ```ts\n * const result = await computePositionAsync(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionAsync(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return Promise.resolve().then(() => computePosition(reference, floating, options));\n}\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **animation frame** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful when the layout has not yet committed (e.g. immediately after DOM insertion). Unlike\n * `computePositionAsync` which defers to the microtask queue, this waits for the next\n * `requestAnimationFrame` tick — guaranteeing post-layout DOM measurements.\n *\n * @example\n * ```ts\n * const result = await computePositionRaf(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionRaf(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return new Promise((resolve, reject) => {\n    requestAnimationFrame(() => {\n      try {\n        resolve(computePosition(reference, floating, options));\n      } catch (err) {\n        reject(err);\n      }\n    });\n  });\n}\n\n/**\n * Runs the middleware pipeline and returns the final position.\n *\n * Position is computed in viewport-relative coordinates assuming `position: fixed`.\n */\nexport function computePosition(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  { boundary, containingBlock, middleware = [], padding, placement = 'bottom' }: ComputePositionOptions = {},\n): ComputePositionResult {\n  const mws = middleware.filter(Boolean) as Middleware[];\n\n  if (reference === floating) {\n    warn('computePosition: reference and floating are the same element.');\n  }\n\n  const names = mws.map((mw) => {\n    const tag = (mw as unknown as Record<symbol, unknown>)[MIDDLEWARE_NAME];\n\n    return typeof tag === 'string' ? tag : null;\n  });\n\n  validateMiddlewareNames(names);\n\n  let currentPlacement = placement;\n  let middlewareData: MiddlewareData = {};\n  let rects = getRects(reference, floating);\n\n  devOnly(() => {\n    if (rects.floating.width === 0 && rects.floating.height === 0) {\n      warn('computePosition: floating element has zero dimensions — is it hidden or detached from the DOM?');\n    }\n\n    const pos = getComputedStyle(floating).position;\n\n    if (pos !== 'fixed' && pos !== 'absolute') {\n      warn(\n        `computePosition: floating element has \\`position: ${pos}\\`. ` +\n          'Orbit computes viewport-relative coordinates and expects position: fixed ' +\n          '(or absolute for scoped stacking contexts).',\n      );\n    }\n  });\n\n  for (let resets = 0; resets < MAX_RESETS; resets += 1) {\n    let state: MiddlewareState = {\n      ...baseCoords(currentPlacement, rects.reference, rects.floating),\n      boundary,\n      elements: { floating, reference },\n      initialPlacement: placement,\n      middlewareData,\n      padding,\n      placement: currentPlacement,\n      rects,\n    };\n\n    let reset: MiddlewareReset | undefined;\n\n    for (const mw of mws) {\n      const result = mw(state);\n\n      state = mergeState(state, result);\n      middlewareData = state.middlewareData;\n      reset = result?.reset;\n\n      if (reset) break;\n    }\n\n    if (!reset) {\n      const result: ComputePositionResult = {\n        middlewareData: state.middlewareData,\n        placement: state.placement,\n        x: state.x,\n        y: state.y,\n      };\n\n      if (containingBlock) {\n        const cb = containingBlock.getBoundingClientRect();\n\n        return { ...result, x: result.x - cb.x, y: result.y - cb.y };\n      }\n\n      return result;\n    }\n\n    if (reset.remeasure) {\n      rects = getRects(reference, floating);\n    } else if (reset.rects != null) {\n      rects = reset.rects;\n    }\n\n    currentPlacement = reset.placement ?? state.placement;\n  }\n\n  throw new OrbitConfigError('Middleware triggered too many resets in a single compute cycle.');\n}\n"],"mappings":"+EAkBA,SAAgB,EAAS,EAA6B,EAAiD,CACrG,MAAO,CACL,SAAU,EAAA,OAAO,EAAS,sBAAsB,CAAC,EACjD,UAAW,EAAA,OAAO,EAAU,sBAAsB,CAAC,CACrD,CACF,CAIA,SAAS,EAAW,EAAwB,EAAkD,CAG5F,OAFK,EAEE,CACL,GAAG,EACH,eAAgB,EAAO,KAClB,OAAO,OAAO,OAAO,OAAO,IAAI,EAAG,EAAM,eAAgB,EAAO,IAAI,EACrE,EAAM,eACV,UAAW,EAAO,WAAa,EAAM,UACrC,EAAG,EAAO,GAAK,EAAM,EACrB,EAAG,EAAO,GAAK,EAAM,CACvB,EAVoB,CAWtB,CAKA,IAAM,EAAa,EAoBnB,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,QAAQ,QAAQ,CAAC,CAAC,SAAW,EAAgB,EAAW,EAAU,CAAO,CAAC,CACnF,CAiBA,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,IAAI,SAAS,EAAS,IAAW,CACtC,0BAA4B,CAC1B,GAAI,CACF,EAAQ,EAAgB,EAAW,EAAU,CAAO,CAAC,CACvD,OAAS,EAAK,CACZ,EAAO,CAAG,CACZ,CACF,CAAC,CACH,CAAC,CACH,CAOA,SAAgB,EACd,EACA,EACA,CAAE,WAAU,kBAAiB,aAAa,CAAC,EAAG,UAAS,YAAY,UAAqC,CAAC,EAClF,CACvB,IAAM,EAAM,EAAW,OAAO,OAAO,EAM/B,EAAQ,EAAI,IAAK,GAAO,CAC5B,IAAM,EAAO,EAA0C,EAAA,iBAEvD,OAAO,OAAO,GAAQ,SAAW,EAAM,IACzC,CAAC,EAED,EAAA,wBAAwB,CAAK,EAE7B,IAAI,EAAmB,EACnB,EAAiC,CAAC,EAClC,EAAQ,EAAS,EAAW,CAAQ,EAkBxC,IAAK,IAAI,EAAS,EAAG,EAAS,EAAY,GAAU,EAAG,CACrD,IAAI,EAAyB,CAC3B,GAAG,EAAA,WAAW,EAAkB,EAAM,UAAW,EAAM,QAAQ,EAC/D,WACA,SAAU,CAAE,WAAU,WAAU,EAChC,iBAAkB,EAClB,iBACA,UACA,UAAW,EACX,OACF,EAEI,EAEJ,IAAK,IAAM,KAAM,EAAK,CACpB,IAAM,EAAS,EAAG,CAAK,EAMvB,GAJA,EAAQ,EAAW,EAAO,CAAM,EAChC,EAAiB,EAAM,eACvB,EAAQ,GAAQ,MAEZ,EAAO,KACb,CAEA,GAAI,CAAC,EAAO,CACV,IAAM,EAAgC,CACpC,eAAgB,EAAM,eACtB,UAAW,EAAM,UACjB,EAAG,EAAM,EACT,EAAG,EAAM,CACX,EAEA,GAAI,EAAiB,CACnB,IAAM,EAAK,EAAgB,sBAAsB,EAEjD,MAAO,CAAE,GAAG,EAAQ,EAAG,EAAO,EAAI,EAAG,EAAG,EAAG,EAAO,EAAI,EAAG,CAAE,CAC7D,CAEA,OAAO,CACT,CAEI,EAAM,UACR,EAAQ,EAAS,EAAW,CAAQ,EAC3B,EAAM,OAAS,OACxB,EAAQ,EAAM,OAGhB,EAAmB,EAAM,WAAa,EAAM,SAC9C,CAEA,MAAM,IAAI,EAAA,iBAAiB,iEAAiE,CAC9F"}
+{"version":3,"file":"core.cjs","names":[],"sources":["../src/core.ts"],"sourcesContent":["import type {\n  ComputePositionOptions,\n  ComputePositionResult,\n  MiddlewareData,\n  MiddlewareReset,\n  MiddlewareResult,\n  MiddlewareState,\n  ReferenceElement,\n} from './types';\n\nimport { devOnly, warn } from './_dev';\nimport { OrbitConfigError } from './errors';\nimport { baseCoords, toRect } from './utils';\n\n// ── DOM helpers ────────────────────────────────────────────────────────────────────────────────\n\n/** Reads the bounding rects of the reference and floating elements from the DOM. */\nexport function getRects(reference: ReferenceElement, floating: HTMLElement): MiddlewareState['rects'] {\n  return {\n    floating: toRect(floating.getBoundingClientRect()),\n    reference: toRect(reference.getBoundingClientRect()),\n  };\n}\n\n// ── Internal state helpers ───────────────────────────────────────────────────────────\n\nfunction mergeState(state: MiddlewareState, result: MiddlewareResult | void): MiddlewareState {\n  if (!result) return state;\n\n  return {\n    ...state,\n    middlewareData: result.data\n      ? (Object.assign(Object.create(null), state.middlewareData, result.data) as MiddlewareData)\n      : state.middlewareData,\n    placement: result.placement ?? state.placement,\n    x: result.x ?? state.x,\n    y: result.y ?? state.y,\n  };\n}\n\n// ── Constants ─────────────────────────────────────────────────────────────────────────────────\n\n/** Maximum number of pipeline restarts allowed per `computePosition` call before throwing. */\nconst MAX_RESETS = 8;\n\n// ── Public API ────────────────────────────────────────────────────────────────────────────────\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **microtask** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful for async component lifecycles (e.g. `await nextTick()` in Vue/React) where the\n * synchronous `computePosition` would read stale DOM measurements because layout has not been\n * committed yet. Note: this defers to the microtask queue, not the next animation frame — if you\n * need post-layout measurements use `requestAnimationFrame` instead.\n *\n * @example\n * ```ts\n * const result = await computePositionAsync(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionAsync(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return Promise.resolve().then(() => computePosition(reference, floating, options));\n}\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **animation frame** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful when the layout has not yet committed (e.g. immediately after DOM insertion). Unlike\n * `computePositionAsync` which defers to the microtask queue, this waits for the next\n * `requestAnimationFrame` tick — guaranteeing post-layout DOM measurements.\n *\n * @example\n * ```ts\n * const result = await computePositionRaf(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionRaf(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return new Promise((resolve, reject) => {\n    requestAnimationFrame(() => {\n      try {\n        resolve(computePosition(reference, floating, options));\n      } catch (err) {\n        reject(err);\n      }\n    });\n  });\n}\n\n/**\n * Runs the middleware pipeline and returns the final position.\n *\n * Position is computed in viewport-relative coordinates assuming `position: fixed`.\n */\nexport function computePosition(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  { boundary, containingBlock, middleware = [], padding, placement = 'bottom' }: ComputePositionOptions = {},\n): ComputePositionResult {\n  const mws = middleware;\n\n  if (reference === floating) {\n    warn('computePosition: reference and floating are the same element.');\n  }\n\n  let currentPlacement = placement;\n  let middlewareData: MiddlewareData = {};\n  let rects = getRects(reference, floating);\n\n  devOnly(() => {\n    if (rects.floating.width === 0 && rects.floating.height === 0) {\n      warn('computePosition: floating element has zero dimensions — is it hidden or detached from the DOM?');\n    }\n\n    const pos = getComputedStyle(floating).position;\n\n    if (pos !== 'fixed' && pos !== 'absolute') {\n      warn(\n        `computePosition: floating element has \\`position: ${pos}\\`. ` +\n          'Orbit computes viewport-relative coordinates and expects position: fixed ' +\n          '(or absolute for scoped stacking contexts).',\n      );\n    }\n  });\n\n  for (let resets = 0; resets < MAX_RESETS; resets += 1) {\n    let state: MiddlewareState = {\n      ...baseCoords(currentPlacement, rects.reference, rects.floating),\n      boundary,\n      elements: { floating, reference },\n      initialPlacement: placement,\n      middlewareData,\n      padding,\n      placement: currentPlacement,\n      rects,\n    };\n\n    let reset: MiddlewareReset | undefined;\n\n    for (const mw of mws) {\n      const result = mw(state);\n\n      state = mergeState(state, result);\n      middlewareData = state.middlewareData;\n      reset = result?.reset;\n\n      if (reset) break;\n    }\n\n    if (!reset) {\n      const result: ComputePositionResult = {\n        middlewareData: state.middlewareData,\n        placement: state.placement,\n        x: state.x,\n        y: state.y,\n      };\n\n      if (containingBlock) {\n        const cb = containingBlock.getBoundingClientRect();\n\n        return { ...result, x: result.x - cb.x, y: result.y - cb.y };\n      }\n\n      return result;\n    }\n\n    if (reset.remeasure) {\n      rects = getRects(reference, floating);\n    } else if (reset.rects != null) {\n      rects = reset.rects;\n    }\n\n    currentPlacement = reset.placement ?? state.placement;\n  }\n\n  throw new OrbitConfigError('Middleware triggered too many resets in a single compute cycle.');\n}\n"],"mappings":"qFAiBA,SAAgB,EAAS,EAA6B,EAAiD,CACrG,MAAO,CACL,SAAU,EAAA,OAAO,EAAS,sBAAsB,CAAC,EACjD,UAAW,EAAA,OAAO,EAAU,sBAAsB,CAAC,CACrD,CACF,CAIA,SAAS,EAAW,EAAwB,EAAkD,CAG5F,OAFK,EAEE,CACL,GAAG,EACH,eAAgB,EAAO,KAClB,OAAO,OAAO,OAAO,OAAO,IAAI,EAAG,EAAM,eAAgB,EAAO,IAAI,EACrE,EAAM,eACV,UAAW,EAAO,WAAa,EAAM,UACrC,EAAG,EAAO,GAAK,EAAM,EACrB,EAAG,EAAO,GAAK,EAAM,CACvB,EAVoB,CAWtB,CAKA,IAAM,EAAa,EAoBnB,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,QAAQ,QAAQ,CAAC,CAAC,SAAW,EAAgB,EAAW,EAAU,CAAO,CAAC,CACnF,CAiBA,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,IAAI,SAAS,EAAS,IAAW,CACtC,0BAA4B,CAC1B,GAAI,CACF,EAAQ,EAAgB,EAAW,EAAU,CAAO,CAAC,CACvD,OAAS,EAAK,CACZ,EAAO,CAAG,CACZ,CACF,CAAC,CACH,CAAC,CACH,CAOA,SAAgB,EACd,EACA,EACA,CAAE,WAAU,kBAAiB,aAAa,CAAC,EAAG,UAAS,YAAY,UAAqC,CAAC,EAClF,CACvB,IAAM,EAAM,EAMR,EAAmB,EACnB,EAAiC,CAAC,EAClC,EAAQ,EAAS,EAAW,CAAQ,EAkBxC,IAAK,IAAI,EAAS,EAAG,EAAS,EAAY,GAAU,EAAG,CACrD,IAAI,EAAyB,CAC3B,GAAG,EAAA,WAAW,EAAkB,EAAM,UAAW,EAAM,QAAQ,EAC/D,WACA,SAAU,CAAE,WAAU,WAAU,EAChC,iBAAkB,EAClB,iBACA,UACA,UAAW,EACX,OACF,EAEI,EAEJ,IAAK,IAAM,KAAM,EAAK,CACpB,IAAM,EAAS,EAAG,CAAK,EAMvB,GAJA,EAAQ,EAAW,EAAO,CAAM,EAChC,EAAiB,EAAM,eACvB,EAAQ,GAAQ,MAEZ,EAAO,KACb,CAEA,GAAI,CAAC,EAAO,CACV,IAAM,EAAgC,CACpC,eAAgB,EAAM,eACtB,UAAW,EAAM,UACjB,EAAG,EAAM,EACT,EAAG,EAAM,CACX,EAEA,GAAI,EAAiB,CACnB,IAAM,EAAK,EAAgB,sBAAsB,EAEjD,MAAO,CAAE,GAAG,EAAQ,EAAG,EAAO,EAAI,EAAG,EAAG,EAAG,EAAO,EAAI,EAAG,CAAE,CAC7D,CAEA,OAAO,CACT,CAEI,EAAM,UACR,EAAQ,EAAS,EAAW,CAAQ,EAC3B,EAAM,OAAS,OACxB,EAAQ,EAAM,OAGhB,EAAmB,EAAM,WAAa,EAAM,SAC9C,CAEA,MAAM,IAAI,EAAA,iBAAiB,iEAAiE,CAC9F"}

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAKrB,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAQjB,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAKrG;AAyBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAe,EAAE,OAAO,EAAE,SAAoB,EAAE,GAAE,sBAA2B,GACzG,qBAAqB,CAsFvB"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAIrB,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAQjB,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAKrG;AAyBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAe,EAAE,OAAO,EAAE,SAAoB,EAAE,GAAE,sBAA2B,GACzG,qBAAqB,CA8EvB"}

package/dist/core.js

@@ -1,2 +1,2 @@
-import{OrbitConfigError as e}from"./errors.js";import{MIDDLEWARE_NAME as t,baseCoords as n,toRect as r,validateMiddlewareNames as i}from"./utils.js";import"./_dev.js";function a(e,t){return{floating:r(t.getBoundingClientRect()),reference:r(e.getBoundingClientRect())}}function o(e,t){return t?{...e,middlewareData:t.data?Object.assign(Object.create(null),e.middlewareData,t.data):e.middlewareData,placement:t.placement??e.placement,x:t.x??e.x,y:t.y??e.y}:e}var s=8;function c(e,t,n){return Promise.resolve().then(()=>u(e,t,n))}function l(e,t,n){return new Promise((r,i)=>{requestAnimationFrame(()=>{try{r(u(e,t,n))}catch(e){i(e)}})})}function u(r,c,{boundary:l,containingBlock:u,middleware:d=[],padding:f,placement:p=`bottom`}={}){let m=d.filter(Boolean),h=m.map(e=>{let n=e[t];return typeof n==`string`?n:null});i(h);let g=p,_={},v=a(r,c);for(let e=0;e<s;e+=1){let e={...n(g,v.reference,v.floating),boundary:l,elements:{floating:c,reference:r},initialPlacement:p,middlewareData:_,padding:f,placement:g,rects:v},t;for(let n of m){let r=n(e);if(e=o(e,r),_=e.middlewareData,t=r?.reset,t)break}if(!t){let t={middlewareData:e.middlewareData,placement:e.placement,x:e.x,y:e.y};if(u){let e=u.getBoundingClientRect();return{...t,x:t.x-e.x,y:t.y-e.y}}return t}t.remeasure?v=a(r,c):t.rects!=null&&(v=t.rects),g=t.placement??e.placement}throw new e(`Middleware triggered too many resets in a single compute cycle.`)}export{u as computePosition,c as computePositionAsync,l as computePositionRaf,a as getRects};
+import{baseCoords as e,toRect as t}from"./utils.js";import"./_dev.js";import{OrbitConfigError as n}from"./errors.js";function r(e,n){return{floating:t(n.getBoundingClientRect()),reference:t(e.getBoundingClientRect())}}function i(e,t){return t?{...e,middlewareData:t.data?Object.assign(Object.create(null),e.middlewareData,t.data):e.middlewareData,placement:t.placement??e.placement,x:t.x??e.x,y:t.y??e.y}:e}var a=8;function o(e,t,n){return Promise.resolve().then(()=>c(e,t,n))}function s(e,t,n){return new Promise((r,i)=>{requestAnimationFrame(()=>{try{r(c(e,t,n))}catch(e){i(e)}})})}function c(t,o,{boundary:s,containingBlock:c,middleware:l=[],padding:u,placement:d=`bottom`}={}){let f=l,p=d,m={},h=r(t,o);for(let n=0;n<a;n+=1){let n={...e(p,h.reference,h.floating),boundary:s,elements:{floating:o,reference:t},initialPlacement:d,middlewareData:m,padding:u,placement:p,rects:h},a;for(let e of f){let t=e(n);if(n=i(n,t),m=n.middlewareData,a=t?.reset,a)break}if(!a){let e={middlewareData:n.middlewareData,placement:n.placement,x:n.x,y:n.y};if(c){let t=c.getBoundingClientRect();return{...e,x:e.x-t.x,y:e.y-t.y}}return e}a.remeasure?h=r(t,o):a.rects!=null&&(h=a.rects),p=a.placement??n.placement}throw new n(`Middleware triggered too many resets in a single compute cycle.`)}export{c as computePosition,o as computePositionAsync,s as computePositionRaf,r as getRects};
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["import type {\n  ComputePositionOptions,\n  ComputePositionResult,\n  Middleware,\n  MiddlewareData,\n  MiddlewareReset,\n  MiddlewareResult,\n  MiddlewareState,\n  ReferenceElement,\n} from './types';\n\nimport { devOnly, warn } from './_dev';\nimport { OrbitConfigError } from './errors';\nimport { baseCoords, MIDDLEWARE_NAME, toRect, validateMiddlewareNames } from './utils';\n\n// ── DOM helpers ────────────────────────────────────────────────────────────────────────────────\n\n/** Reads the bounding rects of the reference and floating elements from the DOM. */\nexport function getRects(reference: ReferenceElement, floating: HTMLElement): MiddlewareState['rects'] {\n  return {\n    floating: toRect(floating.getBoundingClientRect()),\n    reference: toRect(reference.getBoundingClientRect()),\n  };\n}\n\n// ── Internal state helpers ───────────────────────────────────────────────────────────\n\nfunction mergeState(state: MiddlewareState, result: MiddlewareResult | void): MiddlewareState {\n  if (!result) return state;\n\n  return {\n    ...state,\n    middlewareData: result.data\n      ? (Object.assign(Object.create(null), state.middlewareData, result.data) as MiddlewareData)\n      : state.middlewareData,\n    placement: result.placement ?? state.placement,\n    x: result.x ?? state.x,\n    y: result.y ?? state.y,\n  };\n}\n\n// ── Constants ─────────────────────────────────────────────────────────────────────────────────\n\n/** Maximum number of pipeline restarts allowed per `computePosition` call before throwing. */\nconst MAX_RESETS = 8;\n\n// ── Public API ────────────────────────────────────────────────────────────────────────────────\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **microtask** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful for async component lifecycles (e.g. `await nextTick()` in Vue/React) where the\n * synchronous `computePosition` would read stale DOM measurements because layout has not been\n * committed yet. Note: this defers to the microtask queue, not the next animation frame — if you\n * need post-layout measurements use `requestAnimationFrame` instead.\n *\n * @example\n * ```ts\n * const result = await computePositionAsync(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionAsync(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return Promise.resolve().then(() => computePosition(reference, floating, options));\n}\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **animation frame** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful when the layout has not yet committed (e.g. immediately after DOM insertion). Unlike\n * `computePositionAsync` which defers to the microtask queue, this waits for the next\n * `requestAnimationFrame` tick — guaranteeing post-layout DOM measurements.\n *\n * @example\n * ```ts\n * const result = await computePositionRaf(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionRaf(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return new Promise((resolve, reject) => {\n    requestAnimationFrame(() => {\n      try {\n        resolve(computePosition(reference, floating, options));\n      } catch (err) {\n        reject(err);\n      }\n    });\n  });\n}\n\n/**\n * Runs the middleware pipeline and returns the final position.\n *\n * Position is computed in viewport-relative coordinates assuming `position: fixed`.\n */\nexport function computePosition(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  { boundary, containingBlock, middleware = [], padding, placement = 'bottom' }: ComputePositionOptions = {},\n): ComputePositionResult {\n  const mws = middleware.filter(Boolean) as Middleware[];\n\n  if (reference === floating) {\n    warn('computePosition: reference and floating are the same element.');\n  }\n\n  const names = mws.map((mw) => {\n    const tag = (mw as unknown as Record<symbol, unknown>)[MIDDLEWARE_NAME];\n\n    return typeof tag === 'string' ? tag : null;\n  });\n\n  validateMiddlewareNames(names);\n\n  let currentPlacement = placement;\n  let middlewareData: MiddlewareData = {};\n  let rects = getRects(reference, floating);\n\n  devOnly(() => {\n    if (rects.floating.width === 0 && rects.floating.height === 0) {\n      warn('computePosition: floating element has zero dimensions — is it hidden or detached from the DOM?');\n    }\n\n    const pos = getComputedStyle(floating).position;\n\n    if (pos !== 'fixed' && pos !== 'absolute') {\n      warn(\n        `computePosition: floating element has \\`position: ${pos}\\`. ` +\n          'Orbit computes viewport-relative coordinates and expects position: fixed ' +\n          '(or absolute for scoped stacking contexts).',\n      );\n    }\n  });\n\n  for (let resets = 0; resets < MAX_RESETS; resets += 1) {\n    let state: MiddlewareState = {\n      ...baseCoords(currentPlacement, rects.reference, rects.floating),\n      boundary,\n      elements: { floating, reference },\n      initialPlacement: placement,\n      middlewareData,\n      padding,\n      placement: currentPlacement,\n      rects,\n    };\n\n    let reset: MiddlewareReset | undefined;\n\n    for (const mw of mws) {\n      const result = mw(state);\n\n      state = mergeState(state, result);\n      middlewareData = state.middlewareData;\n      reset = result?.reset;\n\n      if (reset) break;\n    }\n\n    if (!reset) {\n      const result: ComputePositionResult = {\n        middlewareData: state.middlewareData,\n        placement: state.placement,\n        x: state.x,\n        y: state.y,\n      };\n\n      if (containingBlock) {\n        const cb = containingBlock.getBoundingClientRect();\n\n        return { ...result, x: result.x - cb.x, y: result.y - cb.y };\n      }\n\n      return result;\n    }\n\n    if (reset.remeasure) {\n      rects = getRects(reference, floating);\n    } else if (reset.rects != null) {\n      rects = reset.rects;\n    }\n\n    currentPlacement = reset.placement ?? state.placement;\n  }\n\n  throw new OrbitConfigError('Middleware triggered too many resets in a single compute cycle.');\n}\n"],"mappings":"uKAkBA,SAAgB,EAAS,EAA6B,EAAiD,CACrG,MAAO,CACL,SAAU,EAAO,EAAS,sBAAsB,CAAC,EACjD,UAAW,EAAO,EAAU,sBAAsB,CAAC,CACrD,CACF,CAIA,SAAS,EAAW,EAAwB,EAAkD,CAG5F,OAFK,EAEE,CACL,GAAG,EACH,eAAgB,EAAO,KAClB,OAAO,OAAO,OAAO,OAAO,IAAI,EAAG,EAAM,eAAgB,EAAO,IAAI,EACrE,EAAM,eACV,UAAW,EAAO,WAAa,EAAM,UACrC,EAAG,EAAO,GAAK,EAAM,EACrB,EAAG,EAAO,GAAK,EAAM,CACvB,EAVoB,CAWtB,CAKA,IAAM,EAAa,EAoBnB,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,QAAQ,QAAQ,CAAC,CAAC,SAAW,EAAgB,EAAW,EAAU,CAAO,CAAC,CACnF,CAiBA,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,IAAI,SAAS,EAAS,IAAW,CACtC,0BAA4B,CAC1B,GAAI,CACF,EAAQ,EAAgB,EAAW,EAAU,CAAO,CAAC,CACvD,OAAS,EAAK,CACZ,EAAO,CAAG,CACZ,CACF,CAAC,CACH,CAAC,CACH,CAOA,SAAgB,EACd,EACA,EACA,CAAE,WAAU,kBAAiB,aAAa,CAAC,EAAG,UAAS,YAAY,UAAqC,CAAC,EAClF,CACvB,IAAM,EAAM,EAAW,OAAO,OAAO,EAM/B,EAAQ,EAAI,IAAK,GAAO,CAC5B,IAAM,EAAO,EAA0C,GAEvD,OAAO,OAAO,GAAQ,SAAW,EAAM,IACzC,CAAC,EAED,EAAwB,CAAK,EAE7B,IAAI,EAAmB,EACnB,EAAiC,CAAC,EAClC,EAAQ,EAAS,EAAW,CAAQ,EAkBxC,IAAK,IAAI,EAAS,EAAG,EAAS,EAAY,GAAU,EAAG,CACrD,IAAI,EAAyB,CAC3B,GAAG,EAAW,EAAkB,EAAM,UAAW,EAAM,QAAQ,EAC/D,WACA,SAAU,CAAE,WAAU,WAAU,EAChC,iBAAkB,EAClB,iBACA,UACA,UAAW,EACX,OACF,EAEI,EAEJ,IAAK,IAAM,KAAM,EAAK,CACpB,IAAM,EAAS,EAAG,CAAK,EAMvB,GAJA,EAAQ,EAAW,EAAO,CAAM,EAChC,EAAiB,EAAM,eACvB,EAAQ,GAAQ,MAEZ,EAAO,KACb,CAEA,GAAI,CAAC,EAAO,CACV,IAAM,EAAgC,CACpC,eAAgB,EAAM,eACtB,UAAW,EAAM,UACjB,EAAG,EAAM,EACT,EAAG,EAAM,CACX,EAEA,GAAI,EAAiB,CACnB,IAAM,EAAK,EAAgB,sBAAsB,EAEjD,MAAO,CAAE,GAAG,EAAQ,EAAG,EAAO,EAAI,EAAG,EAAG,EAAG,EAAO,EAAI,EAAG,CAAE,CAC7D,CAEA,OAAO,CACT,CAEI,EAAM,UACR,EAAQ,EAAS,EAAW,CAAQ,EAC3B,EAAM,OAAS,OACxB,EAAQ,EAAM,OAGhB,EAAmB,EAAM,WAAa,EAAM,SAC9C,CAEA,MAAM,IAAI,EAAiB,iEAAiE,CAC9F"}
+{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["import type {\n  ComputePositionOptions,\n  ComputePositionResult,\n  MiddlewareData,\n  MiddlewareReset,\n  MiddlewareResult,\n  MiddlewareState,\n  ReferenceElement,\n} from './types';\n\nimport { devOnly, warn } from './_dev';\nimport { OrbitConfigError } from './errors';\nimport { baseCoords, toRect } from './utils';\n\n// ── DOM helpers ────────────────────────────────────────────────────────────────────────────────\n\n/** Reads the bounding rects of the reference and floating elements from the DOM. */\nexport function getRects(reference: ReferenceElement, floating: HTMLElement): MiddlewareState['rects'] {\n  return {\n    floating: toRect(floating.getBoundingClientRect()),\n    reference: toRect(reference.getBoundingClientRect()),\n  };\n}\n\n// ── Internal state helpers ───────────────────────────────────────────────────────────\n\nfunction mergeState(state: MiddlewareState, result: MiddlewareResult | void): MiddlewareState {\n  if (!result) return state;\n\n  return {\n    ...state,\n    middlewareData: result.data\n      ? (Object.assign(Object.create(null), state.middlewareData, result.data) as MiddlewareData)\n      : state.middlewareData,\n    placement: result.placement ?? state.placement,\n    x: result.x ?? state.x,\n    y: result.y ?? state.y,\n  };\n}\n\n// ── Constants ─────────────────────────────────────────────────────────────────────────────────\n\n/** Maximum number of pipeline restarts allowed per `computePosition` call before throwing. */\nconst MAX_RESETS = 8;\n\n// ── Public API ────────────────────────────────────────────────────────────────────────────────\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **microtask** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful for async component lifecycles (e.g. `await nextTick()` in Vue/React) where the\n * synchronous `computePosition` would read stale DOM measurements because layout has not been\n * committed yet. Note: this defers to the microtask queue, not the next animation frame — if you\n * need post-layout measurements use `requestAnimationFrame` instead.\n *\n * @example\n * ```ts\n * const result = await computePositionAsync(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionAsync(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return Promise.resolve().then(() => computePosition(reference, floating, options));\n}\n\n/**\n * Deferred position computation. Runs `computePosition` in the next **animation frame** and\n * returns a `Promise<ComputePositionResult>`.\n *\n * Useful when the layout has not yet committed (e.g. immediately after DOM insertion). Unlike\n * `computePositionAsync` which defers to the microtask queue, this waits for the next\n * `requestAnimationFrame` tick — guaranteeing post-layout DOM measurements.\n *\n * @example\n * ```ts\n * const result = await computePositionRaf(reference, floating, { placement: 'top' });\n * floating.style.left = `${result.x}px`;\n * floating.style.top  = `${result.y}px`;\n * ```\n */\nexport function computePositionRaf(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options?: ComputePositionOptions,\n): Promise<ComputePositionResult> {\n  return new Promise((resolve, reject) => {\n    requestAnimationFrame(() => {\n      try {\n        resolve(computePosition(reference, floating, options));\n      } catch (err) {\n        reject(err);\n      }\n    });\n  });\n}\n\n/**\n * Runs the middleware pipeline and returns the final position.\n *\n * Position is computed in viewport-relative coordinates assuming `position: fixed`.\n */\nexport function computePosition(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  { boundary, containingBlock, middleware = [], padding, placement = 'bottom' }: ComputePositionOptions = {},\n): ComputePositionResult {\n  const mws = middleware;\n\n  if (reference === floating) {\n    warn('computePosition: reference and floating are the same element.');\n  }\n\n  let currentPlacement = placement;\n  let middlewareData: MiddlewareData = {};\n  let rects = getRects(reference, floating);\n\n  devOnly(() => {\n    if (rects.floating.width === 0 && rects.floating.height === 0) {\n      warn('computePosition: floating element has zero dimensions — is it hidden or detached from the DOM?');\n    }\n\n    const pos = getComputedStyle(floating).position;\n\n    if (pos !== 'fixed' && pos !== 'absolute') {\n      warn(\n        `computePosition: floating element has \\`position: ${pos}\\`. ` +\n          'Orbit computes viewport-relative coordinates and expects position: fixed ' +\n          '(or absolute for scoped stacking contexts).',\n      );\n    }\n  });\n\n  for (let resets = 0; resets < MAX_RESETS; resets += 1) {\n    let state: MiddlewareState = {\n      ...baseCoords(currentPlacement, rects.reference, rects.floating),\n      boundary,\n      elements: { floating, reference },\n      initialPlacement: placement,\n      middlewareData,\n      padding,\n      placement: currentPlacement,\n      rects,\n    };\n\n    let reset: MiddlewareReset | undefined;\n\n    for (const mw of mws) {\n      const result = mw(state);\n\n      state = mergeState(state, result);\n      middlewareData = state.middlewareData;\n      reset = result?.reset;\n\n      if (reset) break;\n    }\n\n    if (!reset) {\n      const result: ComputePositionResult = {\n        middlewareData: state.middlewareData,\n        placement: state.placement,\n        x: state.x,\n        y: state.y,\n      };\n\n      if (containingBlock) {\n        const cb = containingBlock.getBoundingClientRect();\n\n        return { ...result, x: result.x - cb.x, y: result.y - cb.y };\n      }\n\n      return result;\n    }\n\n    if (reset.remeasure) {\n      rects = getRects(reference, floating);\n    } else if (reset.rects != null) {\n      rects = reset.rects;\n    }\n\n    currentPlacement = reset.placement ?? state.placement;\n  }\n\n  throw new OrbitConfigError('Middleware triggered too many resets in a single compute cycle.');\n}\n"],"mappings":"qHAiBA,SAAgB,EAAS,EAA6B,EAAiD,CACrG,MAAO,CACL,SAAU,EAAO,EAAS,sBAAsB,CAAC,EACjD,UAAW,EAAO,EAAU,sBAAsB,CAAC,CACrD,CACF,CAIA,SAAS,EAAW,EAAwB,EAAkD,CAG5F,OAFK,EAEE,CACL,GAAG,EACH,eAAgB,EAAO,KAClB,OAAO,OAAO,OAAO,OAAO,IAAI,EAAG,EAAM,eAAgB,EAAO,IAAI,EACrE,EAAM,eACV,UAAW,EAAO,WAAa,EAAM,UACrC,EAAG,EAAO,GAAK,EAAM,EACrB,EAAG,EAAO,GAAK,EAAM,CACvB,EAVoB,CAWtB,CAKA,IAAM,EAAa,EAoBnB,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,QAAQ,QAAQ,CAAC,CAAC,SAAW,EAAgB,EAAW,EAAU,CAAO,CAAC,CACnF,CAiBA,SAAgB,EACd,EACA,EACA,EACgC,CAChC,OAAO,IAAI,SAAS,EAAS,IAAW,CACtC,0BAA4B,CAC1B,GAAI,CACF,EAAQ,EAAgB,EAAW,EAAU,CAAO,CAAC,CACvD,OAAS,EAAK,CACZ,EAAO,CAAG,CACZ,CACF,CAAC,CACH,CAAC,CACH,CAOA,SAAgB,EACd,EACA,EACA,CAAE,WAAU,kBAAiB,aAAa,CAAC,EAAG,UAAS,YAAY,UAAqC,CAAC,EAClF,CACvB,IAAM,EAAM,EAMR,EAAmB,EACnB,EAAiC,CAAC,EAClC,EAAQ,EAAS,EAAW,CAAQ,EAkBxC,IAAK,IAAI,EAAS,EAAG,EAAS,EAAY,GAAU,EAAG,CACrD,IAAI,EAAyB,CAC3B,GAAG,EAAW,EAAkB,EAAM,UAAW,EAAM,QAAQ,EAC/D,WACA,SAAU,CAAE,WAAU,WAAU,EAChC,iBAAkB,EAClB,iBACA,UACA,UAAW,EACX,OACF,EAEI,EAEJ,IAAK,IAAM,KAAM,EAAK,CACpB,IAAM,EAAS,EAAG,CAAK,EAMvB,GAJA,EAAQ,EAAW,EAAO,CAAM,EAChC,EAAiB,EAAM,eACvB,EAAQ,GAAQ,MAEZ,EAAO,KACb,CAEA,GAAI,CAAC,EAAO,CACV,IAAM,EAAgC,CACpC,eAAgB,EAAM,eACtB,UAAW,EAAM,UACjB,EAAG,EAAM,EACT,EAAG,EAAM,CACX,EAEA,GAAI,EAAiB,CACnB,IAAM,EAAK,EAAgB,sBAAsB,EAEjD,MAAO,CAAE,GAAG,EAAQ,EAAG,EAAO,EAAI,EAAG,EAAG,EAAG,EAAO,EAAI,EAAG,CAAE,CAC7D,CAEA,OAAO,CACT,CAEI,EAAM,UACR,EAAQ,EAAS,EAAW,CAAQ,EAC3B,EAAM,OAAS,OACxB,EAAQ,EAAM,OAGhB,EAAmB,EAAM,WAAa,EAAM,SAC9C,CAEA,MAAM,IAAI,EAAiB,iEAAiE,CAC9F"}

package/dist/devtools.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./float.cjs");function t(e,t){for(let[n,r]of Object.entries(t))e.style.setProperty(n,r)}function n(){let e=document.createElement(`div`);return e.dataset.orbitDebug=``,t(e,{"font-family":`monospace`,"font-size":`11px`,left:`0`,"pointer-events":`none`,position:`fixed`,top:`0`,"z-index":`2147483647`}),e}function r(e,n,r){let i=document.createElement(`div`);return i.textContent=e,t(i,{background:`rgba(0,100,255,0.85)`,"border-radius":`3px`,color:`#fff`,left:`${n}px`,padding:`1px 6px`,position:`fixed`,top:`${Math.max(0,r)}px`,"white-space":`nowrap`}),i}function i(e,n,r,i,a){let o=document.createElement(`div`);return t(o,{border:`1.5px dashed ${a}`,height:`${i}px`,left:`${e}px`,position:`fixed`,top:`${n}px`,width:`${r}px`}),o}function a(t,a,o={}){let s=n();document.body.appendChild(s);function c(e){if(s.innerHTML=``,s.appendChild(i(1,1,window.innerWidth-2,window.innerHeight-2,`rgba(0,100,255,0.3)`)),t instanceof Element){let e=t.getBoundingClientRect();s.appendChild(i(e.left,e.top,e.width,e.height,`rgba(255,120,0,0.7)`))}let n=a.getBoundingClientRect();s.appendChild(r(e.placement,n.left,n.top-22))}let l=o.apply;function u(e){l?l(e):(a.style.left=`${e.x}px`,a.style.top=`${e.y}px`),c(e)}let d=e.float(t,a,{...o,apply:u});return e.makeHandle(()=>{d.dispose(),s.remove()},()=>d.getPosition(),()=>d.update())}exports.debugFloat=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./float.cjs");function t(e,t){for(let[n,r]of Object.entries(t))e.style.setProperty(n,r)}function n(){let e=document.createElement(`div`);return e.dataset.orbitDebug=``,t(e,{"font-family":`monospace`,"font-size":`11px`,left:`0`,"pointer-events":`none`,position:`fixed`,top:`0`,"z-index":`2147483647`}),e}function r(e,n,r){let i=document.createElement(`div`);return i.textContent=e,t(i,{background:`rgba(0,100,255,0.85)`,"border-radius":`3px`,color:`#fff`,left:`${n}px`,padding:`1px 6px`,position:`fixed`,top:`${Math.max(0,r)}px`,"white-space":`nowrap`}),i}function i(e,n,r,i,a){let o=document.createElement(`div`);return t(o,{border:`1.5px dashed ${a}`,height:`${i}px`,left:`${e}px`,position:`fixed`,top:`${n}px`,width:`${r}px`}),o}function a(t,a,o={}){let s=n();document.body.appendChild(s);function c(e){if(s.innerHTML=``,s.appendChild(i(1,1,window.innerWidth-2,window.innerHeight-2,`rgba(0,100,255,0.3)`)),t instanceof Element){let e=t.getBoundingClientRect();s.appendChild(i(e.left,e.top,e.width,e.height,`rgba(255,120,0,0.7)`))}let n=a.getBoundingClientRect();s.appendChild(r(e.placement,n.left,n.top-22))}let l=o.apply;function u(e){l?l(e):(a.style.left=`${e.x}px`,a.style.top=`${e.y}px`),c(e)}let d=e.createPositioner(t,a,{...o,apply:u}),f=d.dispose.bind(d);return d.start(),Object.assign(d,{dispose(){f(),s.remove()}})}exports.debugPositioner=a;
 //# sourceMappingURL=devtools.cjs.map

package/dist/devtools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.cjs","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/orbit — debug overlay for positioning visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugFloat } from '@vielzeug/orbit/devtools';\n * ```\n */\n\nimport type { FloatOptions } from './float';\nimport type { ComputePositionResult, FloatHandle, ReferenceElement } from './types';\n\nimport { float, makeHandle } from './float';\n\n// ── Overlay helpers ───────────────────────────────────────────────────────────\n\nfunction setStyles(el: HTMLElement, styles: Record<string, string>): void {\n  for (const [key, val] of Object.entries(styles)) {\n    el.style.setProperty(key, val);\n  }\n}\n\nfunction createOverlay(): HTMLElement {\n  const el = document.createElement('div');\n\n  el.dataset['orbitDebug'] = '';\n  setStyles(el, {\n    'font-family': 'monospace',\n    'font-size': '11px',\n    left: '0',\n    'pointer-events': 'none',\n    position: 'fixed',\n    top: '0',\n    'z-index': '2147483647',\n  });\n\n  return el;\n}\n\nfunction createPlacementBadge(text: string, x: number, y: number): HTMLElement {\n  const el = document.createElement('div');\n\n  el.textContent = text;\n  setStyles(el, {\n    background: 'rgba(0,100,255,0.85)',\n    'border-radius': '3px',\n    color: '#fff',\n    left: `${x}px`,\n    padding: '1px 6px',\n    position: 'fixed',\n    top: `${Math.max(0, y)}px`,\n    'white-space': 'nowrap',\n  });\n\n  return el;\n}\n\nfunction createOutlineBox(x: number, y: number, width: number, height: number, color: string): HTMLElement {\n  const el = document.createElement('div');\n\n  setStyles(el, {\n    border: `1.5px dashed ${color}`,\n    height: `${height}px`,\n    left: `${x}px`,\n    position: 'fixed',\n    top: `${y}px`,\n    width: `${width}px`,\n  });\n\n  return el;\n}\n\n// ── Public API ────────────────────────────────────────────────────────────────\n\n/**\n * Wraps `float()` and attaches a persistent visual debug overlay to the document.\n *\n * The overlay renders on every position update:\n * - **Blue dashed outline** — the viewport boundary used by overflow detection.\n * - **Orange dashed outline** — the reference element's bounding rect.\n * - **Blue label** — the active placement string (e.g. `\"top-start\"`).\n *\n * The overlay is automatically removed when `handle.dispose()` is called.\n *\n * Use only in development. Tree-shaken from production bundles via the sub-path import.\n *\n * @example\n * ```ts\n * import { debugFloat } from '@vielzeug/orbit/devtools';\n *\n * const handle = debugFloat(reference, tooltip, {\n *   placement: 'top',\n *   middleware: [offset(8), flip(), shift({ padding: 6 })],\n * });\n * // on teardown:\n * handle.dispose();\n * ```\n */\nexport function debugFloat(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options: FloatOptions = {},\n): FloatHandle {\n  const overlay = createOverlay();\n\n  document.body.appendChild(overlay);\n\n  function renderOverlay(result: ComputePositionResult): void {\n    overlay.innerHTML = '';\n\n    // Viewport boundary.\n    overlay.appendChild(createOutlineBox(1, 1, window.innerWidth - 2, window.innerHeight - 2, 'rgba(0,100,255,0.3)'));\n\n    // Reference element.\n    if (reference instanceof Element) {\n      const r = reference.getBoundingClientRect();\n\n      overlay.appendChild(createOutlineBox(r.left, r.top, r.width, r.height, 'rgba(255,120,0,0.7)'));\n    }\n\n    // Placement label — positioned just above the floating element.\n    const fr = floating.getBoundingClientRect();\n\n    overlay.appendChild(createPlacementBadge(result.placement, fr.left, fr.top - 22));\n  }\n\n  const userApply = options.apply;\n\n  function wrappedApply(result: ComputePositionResult): void {\n    if (userApply) {\n      userApply(result);\n    } else {\n      floating.style.left = `${result.x}px`;\n      floating.style.top = `${result.y}px`;\n    }\n\n    renderOverlay(result);\n  }\n\n  const handle = float(reference, floating, { ...options, apply: wrappedApply });\n\n  return makeHandle(\n    () => {\n      handle.dispose();\n      overlay.remove();\n    },\n    () => handle.getPosition(),\n    () => handle.update(),\n  );\n}\n"],"mappings":"kGAgBA,SAAS,EAAU,EAAiB,EAAsC,CACxE,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,CAAM,EAC5C,EAAG,MAAM,YAAY,EAAK,CAAG,CAEjC,CAEA,SAAS,GAA6B,CACpC,IAAM,EAAK,SAAS,cAAc,KAAK,EAavC,MAXA,GAAG,QAAQ,WAAgB,GAC3B,EAAU,EAAI,CACZ,cAAe,YACf,YAAa,OACb,KAAM,IACN,iBAAkB,OAClB,SAAU,QACV,IAAK,IACL,UAAW,YACb,CAAC,EAEM,CACT,CAEA,SAAS,EAAqB,EAAc,EAAW,EAAwB,CAC7E,IAAM,EAAK,SAAS,cAAc,KAAK,EAcvC,MAZA,GAAG,YAAc,EACjB,EAAU,EAAI,CACZ,WAAY,uBACZ,gBAAiB,MACjB,MAAO,OACP,KAAM,GAAG,EAAE,IACX,QAAS,UACT,SAAU,QACV,IAAK,GAAG,KAAK,IAAI,EAAG,CAAC,EAAE,IACvB,cAAe,QACjB,CAAC,EAEM,CACT,CAEA,SAAS,EAAiB,EAAW,EAAW,EAAe,EAAgB,EAA4B,CACzG,IAAM,EAAK,SAAS,cAAc,KAAK,EAWvC,OATA,EAAU,EAAI,CACZ,OAAQ,gBAAgB,IACxB,OAAQ,GAAG,EAAO,IAClB,KAAM,GAAG,EAAE,IACX,SAAU,QACV,IAAK,GAAG,EAAE,IACV,MAAO,GAAG,EAAM,GAClB,CAAC,EAEM,CACT,CA4BA,SAAgB,EACd,EACA,EACA,EAAwB,CAAC,EACZ,CACb,IAAM,EAAU,EAAc,EAE9B,SAAS,KAAK,YAAY,CAAO,EAEjC,SAAS,EAAc,EAAqC,CAO1D,GANA,EAAQ,UAAY,GAGpB,EAAQ,YAAY,EAAiB,EAAG,EAAG,OAAO,WAAa,EAAG,OAAO,YAAc,EAAG,qBAAqB,CAAC,EAG5G,aAAqB,QAAS,CAChC,IAAM,EAAI,EAAU,sBAAsB,EAE1C,EAAQ,YAAY,EAAiB,EAAE,KAAM,EAAE,IAAK,EAAE,MAAO,EAAE,OAAQ,qBAAqB,CAAC,CAC/F,CAGA,IAAM,EAAK,EAAS,sBAAsB,EAE1C,EAAQ,YAAY,EAAqB,EAAO,UAAW,EAAG,KAAM,EAAG,IAAM,EAAE,CAAC,CAClF,CAEA,IAAM,EAAY,EAAQ,MAE1B,SAAS,EAAa,EAAqC,CACrD,EACF,EAAU,CAAM,GAEhB,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,KAGnC,EAAc,CAAM,CACtB,CAEA,IAAM,EAAS,EAAA,MAAM,EAAW,EAAU,CAAE,GAAG,EAAS,MAAO,CAAa,CAAC,EAE7E,OAAO,EAAA,eACC,CACJ,EAAO,QAAQ,EACf,EAAQ,OAAO,CACjB,MACM,EAAO,YAAY,MACnB,EAAO,OAAO,CACtB,CACF"}
+{"version":3,"file":"devtools.cjs","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/orbit — debug overlay for positioning visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugPositioner } from '@vielzeug/orbit/devtools';\n * ```\n */\n\nimport type { Positioner, PositionerOptions } from './float';\nimport type { ComputePositionResult, ReferenceElement } from './types';\n\nimport { createPositioner } from './float';\n\n// ── Overlay helpers ───────────────────────────────────────────────────────────\n\nfunction setStyles(el: HTMLElement, styles: Record<string, string>): void {\n  for (const [key, val] of Object.entries(styles)) {\n    el.style.setProperty(key, val);\n  }\n}\n\nfunction createOverlay(): HTMLElement {\n  const el = document.createElement('div');\n\n  el.dataset['orbitDebug'] = '';\n  setStyles(el, {\n    'font-family': 'monospace',\n    'font-size': '11px',\n    left: '0',\n    'pointer-events': 'none',\n    position: 'fixed',\n    top: '0',\n    'z-index': '2147483647',\n  });\n\n  return el;\n}\n\nfunction createPlacementBadge(text: string, x: number, y: number): HTMLElement {\n  const el = document.createElement('div');\n\n  el.textContent = text;\n  setStyles(el, {\n    background: 'rgba(0,100,255,0.85)',\n    'border-radius': '3px',\n    color: '#fff',\n    left: `${x}px`,\n    padding: '1px 6px',\n    position: 'fixed',\n    top: `${Math.max(0, y)}px`,\n    'white-space': 'nowrap',\n  });\n\n  return el;\n}\n\nfunction createOutlineBox(x: number, y: number, width: number, height: number, color: string): HTMLElement {\n  const el = document.createElement('div');\n\n  setStyles(el, {\n    border: `1.5px dashed ${color}`,\n    height: `${height}px`,\n    left: `${x}px`,\n    position: 'fixed',\n    top: `${y}px`,\n    width: `${width}px`,\n  });\n\n  return el;\n}\n\n// ── Public API ────────────────────────────────────────────────────────────────\n\n/**\n * Wraps `createPositioner()` and attaches a persistent visual debug overlay to the document.\n *\n * The overlay renders on every position update:\n * - **Blue dashed outline** — the viewport boundary used by overflow detection.\n * - **Orange dashed outline** — the reference element's bounding rect.\n * - **Blue label** — the active placement string (e.g. `\"top-start\"`).\n *\n * The overlay is automatically removed when `handle.dispose()` is called.\n *\n * Use only in development. Tree-shaken from production bundles via the sub-path import.\n *\n * @example\n * ```ts\n * import { debugPositioner } from '@vielzeug/orbit/devtools';\n *\n * const handle = debugPositioner(reference, tooltip, {\n *   placement: 'top',\n *   middleware: [offset(8), flip(), shift({ padding: 6 })],\n * });\n * // on teardown:\n * handle.dispose();\n * ```\n */\nexport function debugPositioner(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options: PositionerOptions = {},\n): Positioner {\n  const overlay = createOverlay();\n\n  document.body.appendChild(overlay);\n\n  function renderOverlay(result: ComputePositionResult): void {\n    overlay.innerHTML = '';\n\n    // Viewport boundary.\n    overlay.appendChild(createOutlineBox(1, 1, window.innerWidth - 2, window.innerHeight - 2, 'rgba(0,100,255,0.3)'));\n\n    // Reference element.\n    if (reference instanceof Element) {\n      const r = reference.getBoundingClientRect();\n\n      overlay.appendChild(createOutlineBox(r.left, r.top, r.width, r.height, 'rgba(255,120,0,0.7)'));\n    }\n\n    // Placement label — positioned just above the floating element.\n    const fr = floating.getBoundingClientRect();\n\n    overlay.appendChild(createPlacementBadge(result.placement, fr.left, fr.top - 22));\n  }\n\n  const userApply = options.apply;\n\n  function wrappedApply(result: ComputePositionResult): void {\n    if (userApply) {\n      userApply(result);\n    } else {\n      floating.style.left = `${result.x}px`;\n      floating.style.top = `${result.y}px`;\n    }\n\n    renderOverlay(result);\n  }\n\n  const positioner = createPositioner(reference, floating, { ...options, apply: wrappedApply });\n  const dispose = positioner.dispose.bind(positioner);\n\n  positioner.start();\n\n  return Object.assign(positioner, {\n    dispose(): void {\n      dispose();\n      overlay.remove();\n    },\n  });\n}\n"],"mappings":"kGAgBA,SAAS,EAAU,EAAiB,EAAsC,CACxE,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,CAAM,EAC5C,EAAG,MAAM,YAAY,EAAK,CAAG,CAEjC,CAEA,SAAS,GAA6B,CACpC,IAAM,EAAK,SAAS,cAAc,KAAK,EAavC,MAXA,GAAG,QAAQ,WAAgB,GAC3B,EAAU,EAAI,CACZ,cAAe,YACf,YAAa,OACb,KAAM,IACN,iBAAkB,OAClB,SAAU,QACV,IAAK,IACL,UAAW,YACb,CAAC,EAEM,CACT,CAEA,SAAS,EAAqB,EAAc,EAAW,EAAwB,CAC7E,IAAM,EAAK,SAAS,cAAc,KAAK,EAcvC,MAZA,GAAG,YAAc,EACjB,EAAU,EAAI,CACZ,WAAY,uBACZ,gBAAiB,MACjB,MAAO,OACP,KAAM,GAAG,EAAE,IACX,QAAS,UACT,SAAU,QACV,IAAK,GAAG,KAAK,IAAI,EAAG,CAAC,EAAE,IACvB,cAAe,QACjB,CAAC,EAEM,CACT,CAEA,SAAS,EAAiB,EAAW,EAAW,EAAe,EAAgB,EAA4B,CACzG,IAAM,EAAK,SAAS,cAAc,KAAK,EAWvC,OATA,EAAU,EAAI,CACZ,OAAQ,gBAAgB,IACxB,OAAQ,GAAG,EAAO,IAClB,KAAM,GAAG,EAAE,IACX,SAAU,QACV,IAAK,GAAG,EAAE,IACV,MAAO,GAAG,EAAM,GAClB,CAAC,EAEM,CACT,CA4BA,SAAgB,EACd,EACA,EACA,EAA6B,CAAC,EAClB,CACZ,IAAM,EAAU,EAAc,EAE9B,SAAS,KAAK,YAAY,CAAO,EAEjC,SAAS,EAAc,EAAqC,CAO1D,GANA,EAAQ,UAAY,GAGpB,EAAQ,YAAY,EAAiB,EAAG,EAAG,OAAO,WAAa,EAAG,OAAO,YAAc,EAAG,qBAAqB,CAAC,EAG5G,aAAqB,QAAS,CAChC,IAAM,EAAI,EAAU,sBAAsB,EAE1C,EAAQ,YAAY,EAAiB,EAAE,KAAM,EAAE,IAAK,EAAE,MAAO,EAAE,OAAQ,qBAAqB,CAAC,CAC/F,CAGA,IAAM,EAAK,EAAS,sBAAsB,EAE1C,EAAQ,YAAY,EAAqB,EAAO,UAAW,EAAG,KAAM,EAAG,IAAM,EAAE,CAAC,CAClF,CAEA,IAAM,EAAY,EAAQ,MAE1B,SAAS,EAAa,EAAqC,CACrD,EACF,EAAU,CAAM,GAEhB,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,KAGnC,EAAc,CAAM,CACtB,CAEA,IAAM,EAAa,EAAA,iBAAiB,EAAW,EAAU,CAAE,GAAG,EAAS,MAAO,CAAa,CAAC,EACtF,EAAU,EAAW,QAAQ,KAAK,CAAU,EAIlD,OAFA,EAAW,MAAM,EAEV,OAAO,OAAO,EAAY,CAC/B,SAAgB,CACd,EAAQ,EACR,EAAQ,OAAO,CACjB,CACF,CAAC,CACH"}

package/dist/devtools.d.ts

@@ -3,13 +3,13 @@
  *
  * Import from the dedicated sub-path so it is tree-shaken from production bundles:
  * ```ts
- * import { debugFloat } from '@vielzeug/orbit/devtools';
+ * import { debugPositioner } from '@vielzeug/orbit/devtools';
  * ```
  */
-import type { FloatOptions } from './float';
-import type { FloatHandle, ReferenceElement } from './types';
+import type { Positioner, PositionerOptions } from './float';
+import type { ReferenceElement } from './types';
 /**
- * Wraps `float()` and attaches a persistent visual debug overlay to the document.
+ * Wraps `createPositioner()` and attaches a persistent visual debug overlay to the document.
  *
  * The overlay renders on every position update:
  * - **Blue dashed outline** — the viewport boundary used by overflow detection.
@@ -22,9 +22,9 @@ import type { FloatHandle, ReferenceElement } from './types';
  *
  * @example
  * ```ts
- * import { debugFloat } from '@vielzeug/orbit/devtools';
+ * import { debugPositioner } from '@vielzeug/orbit/devtools';
  *
- * const handle = debugFloat(reference, tooltip, {
+ * const handle = debugPositioner(reference, tooltip, {
  *   placement: 'top',
  *   middleware: [offset(8), flip(), shift({ padding: 6 })],
  * });
@@ -32,5 +32,5 @@ import type { FloatHandle, ReferenceElement } from './types';
  * handle.dispose();
  * ```
  */
-export declare function debugFloat(reference: ReferenceElement, floating: HTMLElement, options?: FloatOptions): FloatHandle;
+export declare function debugPositioner(reference: ReferenceElement, floating: HTMLElement, options?: PositionerOptions): Positioner;
 //# sourceMappingURL=devtools.d.ts.map

package/dist/devtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAyB,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgEpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,YAAiB,GACzB,WAAW,CA+Cb"}
+{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAyB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAgDZ"}

package/dist/devtools.js

@@ -1,2 +1,2 @@
-import{float as e,makeHandle as t}from"./float.js";function n(e,t){for(let[n,r]of Object.entries(t))e.style.setProperty(n,r)}function r(){let e=document.createElement(`div`);return e.dataset.orbitDebug=``,n(e,{"font-family":`monospace`,"font-size":`11px`,left:`0`,"pointer-events":`none`,position:`fixed`,top:`0`,"z-index":`2147483647`}),e}function i(e,t,r){let i=document.createElement(`div`);return i.textContent=e,n(i,{background:`rgba(0,100,255,0.85)`,"border-radius":`3px`,color:`#fff`,left:`${t}px`,padding:`1px 6px`,position:`fixed`,top:`${Math.max(0,r)}px`,"white-space":`nowrap`}),i}function a(e,t,r,i,a){let o=document.createElement(`div`);return n(o,{border:`1.5px dashed ${a}`,height:`${i}px`,left:`${e}px`,position:`fixed`,top:`${t}px`,width:`${r}px`}),o}function o(n,o,s={}){let c=r();document.body.appendChild(c);function l(e){if(c.innerHTML=``,c.appendChild(a(1,1,window.innerWidth-2,window.innerHeight-2,`rgba(0,100,255,0.3)`)),n instanceof Element){let e=n.getBoundingClientRect();c.appendChild(a(e.left,e.top,e.width,e.height,`rgba(255,120,0,0.7)`))}let t=o.getBoundingClientRect();c.appendChild(i(e.placement,t.left,t.top-22))}let u=s.apply;function d(e){u?u(e):(o.style.left=`${e.x}px`,o.style.top=`${e.y}px`),l(e)}let f=e(n,o,{...s,apply:d});return t(()=>{f.dispose(),c.remove()},()=>f.getPosition(),()=>f.update())}export{o as debugFloat};
+import{createPositioner as e}from"./float.js";function t(e,t){for(let[n,r]of Object.entries(t))e.style.setProperty(n,r)}function n(){let e=document.createElement(`div`);return e.dataset.orbitDebug=``,t(e,{"font-family":`monospace`,"font-size":`11px`,left:`0`,"pointer-events":`none`,position:`fixed`,top:`0`,"z-index":`2147483647`}),e}function r(e,n,r){let i=document.createElement(`div`);return i.textContent=e,t(i,{background:`rgba(0,100,255,0.85)`,"border-radius":`3px`,color:`#fff`,left:`${n}px`,padding:`1px 6px`,position:`fixed`,top:`${Math.max(0,r)}px`,"white-space":`nowrap`}),i}function i(e,n,r,i,a){let o=document.createElement(`div`);return t(o,{border:`1.5px dashed ${a}`,height:`${i}px`,left:`${e}px`,position:`fixed`,top:`${n}px`,width:`${r}px`}),o}function a(t,a,o={}){let s=n();document.body.appendChild(s);function c(e){if(s.innerHTML=``,s.appendChild(i(1,1,window.innerWidth-2,window.innerHeight-2,`rgba(0,100,255,0.3)`)),t instanceof Element){let e=t.getBoundingClientRect();s.appendChild(i(e.left,e.top,e.width,e.height,`rgba(255,120,0,0.7)`))}let n=a.getBoundingClientRect();s.appendChild(r(e.placement,n.left,n.top-22))}let l=o.apply;function u(e){l?l(e):(a.style.left=`${e.x}px`,a.style.top=`${e.y}px`),c(e)}let d=e(t,a,{...o,apply:u}),f=d.dispose.bind(d);return d.start(),Object.assign(d,{dispose(){f(),s.remove()}})}export{a as debugPositioner};
 //# sourceMappingURL=devtools.js.map

package/dist/devtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/orbit — debug overlay for positioning visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugFloat } from '@vielzeug/orbit/devtools';\n * ```\n */\n\nimport type { FloatOptions } from './float';\nimport type { ComputePositionResult, FloatHandle, ReferenceElement } from './types';\n\nimport { float, makeHandle } from './float';\n\n// ── Overlay helpers ───────────────────────────────────────────────────────────\n\nfunction setStyles(el: HTMLElement, styles: Record<string, string>): void {\n  for (const [key, val] of Object.entries(styles)) {\n    el.style.setProperty(key, val);\n  }\n}\n\nfunction createOverlay(): HTMLElement {\n  const el = document.createElement('div');\n\n  el.dataset['orbitDebug'] = '';\n  setStyles(el, {\n    'font-family': 'monospace',\n    'font-size': '11px',\n    left: '0',\n    'pointer-events': 'none',\n    position: 'fixed',\n    top: '0',\n    'z-index': '2147483647',\n  });\n\n  return el;\n}\n\nfunction createPlacementBadge(text: string, x: number, y: number): HTMLElement {\n  const el = document.createElement('div');\n\n  el.textContent = text;\n  setStyles(el, {\n    background: 'rgba(0,100,255,0.85)',\n    'border-radius': '3px',\n    color: '#fff',\n    left: `${x}px`,\n    padding: '1px 6px',\n    position: 'fixed',\n    top: `${Math.max(0, y)}px`,\n    'white-space': 'nowrap',\n  });\n\n  return el;\n}\n\nfunction createOutlineBox(x: number, y: number, width: number, height: number, color: string): HTMLElement {\n  const el = document.createElement('div');\n\n  setStyles(el, {\n    border: `1.5px dashed ${color}`,\n    height: `${height}px`,\n    left: `${x}px`,\n    position: 'fixed',\n    top: `${y}px`,\n    width: `${width}px`,\n  });\n\n  return el;\n}\n\n// ── Public API ────────────────────────────────────────────────────────────────\n\n/**\n * Wraps `float()` and attaches a persistent visual debug overlay to the document.\n *\n * The overlay renders on every position update:\n * - **Blue dashed outline** — the viewport boundary used by overflow detection.\n * - **Orange dashed outline** — the reference element's bounding rect.\n * - **Blue label** — the active placement string (e.g. `\"top-start\"`).\n *\n * The overlay is automatically removed when `handle.dispose()` is called.\n *\n * Use only in development. Tree-shaken from production bundles via the sub-path import.\n *\n * @example\n * ```ts\n * import { debugFloat } from '@vielzeug/orbit/devtools';\n *\n * const handle = debugFloat(reference, tooltip, {\n *   placement: 'top',\n *   middleware: [offset(8), flip(), shift({ padding: 6 })],\n * });\n * // on teardown:\n * handle.dispose();\n * ```\n */\nexport function debugFloat(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options: FloatOptions = {},\n): FloatHandle {\n  const overlay = createOverlay();\n\n  document.body.appendChild(overlay);\n\n  function renderOverlay(result: ComputePositionResult): void {\n    overlay.innerHTML = '';\n\n    // Viewport boundary.\n    overlay.appendChild(createOutlineBox(1, 1, window.innerWidth - 2, window.innerHeight - 2, 'rgba(0,100,255,0.3)'));\n\n    // Reference element.\n    if (reference instanceof Element) {\n      const r = reference.getBoundingClientRect();\n\n      overlay.appendChild(createOutlineBox(r.left, r.top, r.width, r.height, 'rgba(255,120,0,0.7)'));\n    }\n\n    // Placement label — positioned just above the floating element.\n    const fr = floating.getBoundingClientRect();\n\n    overlay.appendChild(createPlacementBadge(result.placement, fr.left, fr.top - 22));\n  }\n\n  const userApply = options.apply;\n\n  function wrappedApply(result: ComputePositionResult): void {\n    if (userApply) {\n      userApply(result);\n    } else {\n      floating.style.left = `${result.x}px`;\n      floating.style.top = `${result.y}px`;\n    }\n\n    renderOverlay(result);\n  }\n\n  const handle = float(reference, floating, { ...options, apply: wrappedApply });\n\n  return makeHandle(\n    () => {\n      handle.dispose();\n      overlay.remove();\n    },\n    () => handle.getPosition(),\n    () => handle.update(),\n  );\n}\n"],"mappings":"mDAgBA,SAAS,EAAU,EAAiB,EAAsC,CACxE,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,CAAM,EAC5C,EAAG,MAAM,YAAY,EAAK,CAAG,CAEjC,CAEA,SAAS,GAA6B,CACpC,IAAM,EAAK,SAAS,cAAc,KAAK,EAavC,MAXA,GAAG,QAAQ,WAAgB,GAC3B,EAAU,EAAI,CACZ,cAAe,YACf,YAAa,OACb,KAAM,IACN,iBAAkB,OAClB,SAAU,QACV,IAAK,IACL,UAAW,YACb,CAAC,EAEM,CACT,CAEA,SAAS,EAAqB,EAAc,EAAW,EAAwB,CAC7E,IAAM,EAAK,SAAS,cAAc,KAAK,EAcvC,MAZA,GAAG,YAAc,EACjB,EAAU,EAAI,CACZ,WAAY,uBACZ,gBAAiB,MACjB,MAAO,OACP,KAAM,GAAG,EAAE,IACX,QAAS,UACT,SAAU,QACV,IAAK,GAAG,KAAK,IAAI,EAAG,CAAC,EAAE,IACvB,cAAe,QACjB,CAAC,EAEM,CACT,CAEA,SAAS,EAAiB,EAAW,EAAW,EAAe,EAAgB,EAA4B,CACzG,IAAM,EAAK,SAAS,cAAc,KAAK,EAWvC,OATA,EAAU,EAAI,CACZ,OAAQ,gBAAgB,IACxB,OAAQ,GAAG,EAAO,IAClB,KAAM,GAAG,EAAE,IACX,SAAU,QACV,IAAK,GAAG,EAAE,IACV,MAAO,GAAG,EAAM,GAClB,CAAC,EAEM,CACT,CA4BA,SAAgB,EACd,EACA,EACA,EAAwB,CAAC,EACZ,CACb,IAAM,EAAU,EAAc,EAE9B,SAAS,KAAK,YAAY,CAAO,EAEjC,SAAS,EAAc,EAAqC,CAO1D,GANA,EAAQ,UAAY,GAGpB,EAAQ,YAAY,EAAiB,EAAG,EAAG,OAAO,WAAa,EAAG,OAAO,YAAc,EAAG,qBAAqB,CAAC,EAG5G,aAAqB,QAAS,CAChC,IAAM,EAAI,EAAU,sBAAsB,EAE1C,EAAQ,YAAY,EAAiB,EAAE,KAAM,EAAE,IAAK,EAAE,MAAO,EAAE,OAAQ,qBAAqB,CAAC,CAC/F,CAGA,IAAM,EAAK,EAAS,sBAAsB,EAE1C,EAAQ,YAAY,EAAqB,EAAO,UAAW,EAAG,KAAM,EAAG,IAAM,EAAE,CAAC,CAClF,CAEA,IAAM,EAAY,EAAQ,MAE1B,SAAS,EAAa,EAAqC,CACrD,EACF,EAAU,CAAM,GAEhB,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,KAGnC,EAAc,CAAM,CACtB,CAEA,IAAM,EAAS,EAAM,EAAW,EAAU,CAAE,GAAG,EAAS,MAAO,CAAa,CAAC,EAE7E,OAAO,MACC,CACJ,EAAO,QAAQ,EACf,EAAQ,OAAO,CACjB,MACM,EAAO,YAAY,MACnB,EAAO,OAAO,CACtB,CACF"}
+{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/orbit — debug overlay for positioning visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugPositioner } from '@vielzeug/orbit/devtools';\n * ```\n */\n\nimport type { Positioner, PositionerOptions } from './float';\nimport type { ComputePositionResult, ReferenceElement } from './types';\n\nimport { createPositioner } from './float';\n\n// ── Overlay helpers ───────────────────────────────────────────────────────────\n\nfunction setStyles(el: HTMLElement, styles: Record<string, string>): void {\n  for (const [key, val] of Object.entries(styles)) {\n    el.style.setProperty(key, val);\n  }\n}\n\nfunction createOverlay(): HTMLElement {\n  const el = document.createElement('div');\n\n  el.dataset['orbitDebug'] = '';\n  setStyles(el, {\n    'font-family': 'monospace',\n    'font-size': '11px',\n    left: '0',\n    'pointer-events': 'none',\n    position: 'fixed',\n    top: '0',\n    'z-index': '2147483647',\n  });\n\n  return el;\n}\n\nfunction createPlacementBadge(text: string, x: number, y: number): HTMLElement {\n  const el = document.createElement('div');\n\n  el.textContent = text;\n  setStyles(el, {\n    background: 'rgba(0,100,255,0.85)',\n    'border-radius': '3px',\n    color: '#fff',\n    left: `${x}px`,\n    padding: '1px 6px',\n    position: 'fixed',\n    top: `${Math.max(0, y)}px`,\n    'white-space': 'nowrap',\n  });\n\n  return el;\n}\n\nfunction createOutlineBox(x: number, y: number, width: number, height: number, color: string): HTMLElement {\n  const el = document.createElement('div');\n\n  setStyles(el, {\n    border: `1.5px dashed ${color}`,\n    height: `${height}px`,\n    left: `${x}px`,\n    position: 'fixed',\n    top: `${y}px`,\n    width: `${width}px`,\n  });\n\n  return el;\n}\n\n// ── Public API ────────────────────────────────────────────────────────────────\n\n/**\n * Wraps `createPositioner()` and attaches a persistent visual debug overlay to the document.\n *\n * The overlay renders on every position update:\n * - **Blue dashed outline** — the viewport boundary used by overflow detection.\n * - **Orange dashed outline** — the reference element's bounding rect.\n * - **Blue label** — the active placement string (e.g. `\"top-start\"`).\n *\n * The overlay is automatically removed when `handle.dispose()` is called.\n *\n * Use only in development. Tree-shaken from production bundles via the sub-path import.\n *\n * @example\n * ```ts\n * import { debugPositioner } from '@vielzeug/orbit/devtools';\n *\n * const handle = debugPositioner(reference, tooltip, {\n *   placement: 'top',\n *   middleware: [offset(8), flip(), shift({ padding: 6 })],\n * });\n * // on teardown:\n * handle.dispose();\n * ```\n */\nexport function debugPositioner(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  options: PositionerOptions = {},\n): Positioner {\n  const overlay = createOverlay();\n\n  document.body.appendChild(overlay);\n\n  function renderOverlay(result: ComputePositionResult): void {\n    overlay.innerHTML = '';\n\n    // Viewport boundary.\n    overlay.appendChild(createOutlineBox(1, 1, window.innerWidth - 2, window.innerHeight - 2, 'rgba(0,100,255,0.3)'));\n\n    // Reference element.\n    if (reference instanceof Element) {\n      const r = reference.getBoundingClientRect();\n\n      overlay.appendChild(createOutlineBox(r.left, r.top, r.width, r.height, 'rgba(255,120,0,0.7)'));\n    }\n\n    // Placement label — positioned just above the floating element.\n    const fr = floating.getBoundingClientRect();\n\n    overlay.appendChild(createPlacementBadge(result.placement, fr.left, fr.top - 22));\n  }\n\n  const userApply = options.apply;\n\n  function wrappedApply(result: ComputePositionResult): void {\n    if (userApply) {\n      userApply(result);\n    } else {\n      floating.style.left = `${result.x}px`;\n      floating.style.top = `${result.y}px`;\n    }\n\n    renderOverlay(result);\n  }\n\n  const positioner = createPositioner(reference, floating, { ...options, apply: wrappedApply });\n  const dispose = positioner.dispose.bind(positioner);\n\n  positioner.start();\n\n  return Object.assign(positioner, {\n    dispose(): void {\n      dispose();\n      overlay.remove();\n    },\n  });\n}\n"],"mappings":"8CAgBA,SAAS,EAAU,EAAiB,EAAsC,CACxE,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,CAAM,EAC5C,EAAG,MAAM,YAAY,EAAK,CAAG,CAEjC,CAEA,SAAS,GAA6B,CACpC,IAAM,EAAK,SAAS,cAAc,KAAK,EAavC,MAXA,GAAG,QAAQ,WAAgB,GAC3B,EAAU,EAAI,CACZ,cAAe,YACf,YAAa,OACb,KAAM,IACN,iBAAkB,OAClB,SAAU,QACV,IAAK,IACL,UAAW,YACb,CAAC,EAEM,CACT,CAEA,SAAS,EAAqB,EAAc,EAAW,EAAwB,CAC7E,IAAM,EAAK,SAAS,cAAc,KAAK,EAcvC,MAZA,GAAG,YAAc,EACjB,EAAU,EAAI,CACZ,WAAY,uBACZ,gBAAiB,MACjB,MAAO,OACP,KAAM,GAAG,EAAE,IACX,QAAS,UACT,SAAU,QACV,IAAK,GAAG,KAAK,IAAI,EAAG,CAAC,EAAE,IACvB,cAAe,QACjB,CAAC,EAEM,CACT,CAEA,SAAS,EAAiB,EAAW,EAAW,EAAe,EAAgB,EAA4B,CACzG,IAAM,EAAK,SAAS,cAAc,KAAK,EAWvC,OATA,EAAU,EAAI,CACZ,OAAQ,gBAAgB,IACxB,OAAQ,GAAG,EAAO,IAClB,KAAM,GAAG,EAAE,IACX,SAAU,QACV,IAAK,GAAG,EAAE,IACV,MAAO,GAAG,EAAM,GAClB,CAAC,EAEM,CACT,CA4BA,SAAgB,EACd,EACA,EACA,EAA6B,CAAC,EAClB,CACZ,IAAM,EAAU,EAAc,EAE9B,SAAS,KAAK,YAAY,CAAO,EAEjC,SAAS,EAAc,EAAqC,CAO1D,GANA,EAAQ,UAAY,GAGpB,EAAQ,YAAY,EAAiB,EAAG,EAAG,OAAO,WAAa,EAAG,OAAO,YAAc,EAAG,qBAAqB,CAAC,EAG5G,aAAqB,QAAS,CAChC,IAAM,EAAI,EAAU,sBAAsB,EAE1C,EAAQ,YAAY,EAAiB,EAAE,KAAM,EAAE,IAAK,EAAE,MAAO,EAAE,OAAQ,qBAAqB,CAAC,CAC/F,CAGA,IAAM,EAAK,EAAS,sBAAsB,EAE1C,EAAQ,YAAY,EAAqB,EAAO,UAAW,EAAG,KAAM,EAAG,IAAM,EAAE,CAAC,CAClF,CAEA,IAAM,EAAY,EAAQ,MAE1B,SAAS,EAAa,EAAqC,CACrD,EACF,EAAU,CAAM,GAEhB,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,KAGnC,EAAc,CAAM,CACtB,CAEA,IAAM,EAAa,EAAiB,EAAW,EAAU,CAAE,GAAG,EAAS,MAAO,CAAa,CAAC,EACtF,EAAU,EAAW,QAAQ,KAAK,CAAU,EAIlD,OAFA,EAAW,MAAM,EAEV,OAAO,OAAO,EAAY,CAC/B,SAAgB,CACd,EAAQ,EACR,EAAQ,OAAO,CACjB,CACF,CAAC,CACH"}

package/dist/float.cjs

@@ -1,2 +1,2 @@
-const e=require("./auto-update.cjs"),t=require("./core.cjs");function n(e,t,n){let r=new AbortController,i=!1;return{get disposalSignal(){return r.signal},dispose(){i||(i=!0,r.abort(),e())},get disposed(){return i},getPosition:t,[Symbol.dispose](){this.dispose()},update:n}}function r(){return typeof CSS<`u`&&CSS.supports(`anchor-name`,`--orbit`)}var i=0,a={bottom:`block-end center`,"bottom-end":`block-end span-inline-end`,"bottom-start":`block-end span-inline-start`,left:`inline-start center`,"left-end":`inline-start span-block-end`,"left-start":`inline-start span-block-start`,right:`inline-end center`,"right-end":`inline-end span-block-end`,"right-start":`inline-end span-block-start`,top:`block-start center`,"top-end":`block-start span-inline-end`,"top-start":`block-start span-inline-start`};function o(e,t){let n={};for(let r of Object.keys(t)){let i=e.style.getPropertyValue(r);n[r]=i===``?void 0:i,e.style.setProperty(r,t[r])}return()=>{for(let r of Object.keys(t)){let t=n[r];t===void 0?e.style.removeProperty(r):e.style.setProperty(r,t)}}}function s(e,t,n,r){let s=`--orbit-${++i}`,c=o(e,{"anchor-name":s}),l=o(t,{position:`fixed`,"position-anchor":s,"position-area":a[n],"position-try-fallbacks":r});return()=>{c(),l()}}function c(e,t,{fallbacks:r=`flip-block, flip-inline, flip-block flip-inline`,placement:i=`bottom`}={}){let a=s(e,t,i,r),o=n(()=>a(),()=>null,()=>{});return Object.assign(o,{cssAnchor:!0})}function l(e,t){t.style.left=`${e.x}px`,t.style.top=`${e.y}px`}function u(r,i,{apply:a,autoUpdate:o={},boundary:s,containingBlock:c,middleware:u,padding:d,placement:f=`bottom`}={}){let p=null,m=a??(e=>l(e,i));function h(){let e=t.computePosition(r,i,{boundary:s,containingBlock:c,middleware:u,padding:d,placement:f});p=e,m(e)}if(o===!1)return h(),n(()=>{},()=>p,h);let g=e.autoUpdate(r,i,h,o);return n(()=>g(),()=>p,h)}exports.float=u,exports.floatWithAnchor=c,exports.isCssAnchorSupported=r,exports.makeHandle=n;
+const e=require("./auto-update.cjs"),t=require("./containing-block.cjs"),n=require("./core.cjs"),r=require("./overflow.cjs");function i(e,t,n,r){let i=new AbortController,a=!1;return{get disposalSignal(){return i.signal},dispose(){a||(a=!0,i.abort(),e())},get disposed(){return a},getPosition:t,start(){a||n()},[Symbol.dispose](){this.dispose()},update(){a||r()}}}function a(e,n){return n===`absolute`?e.offsetParent instanceof Element?e.offsetParent:null:t.getContainingBlock(e)}function o(e,t,n){t.style.position=n,t.style.left=`${e.x}px`,t.style.top=`${e.y}px`}function s(t,s,{apply:c,autoUpdate:l={},boundary:u=`clippingAncestors`,middleware:d,padding:f,placement:p=`bottom`,strategy:m=`fixed`}={}){let h=!0,g,_=null,v=!1;function y(){if(!h)return;let e=a(s,m),i=u===`clippingAncestors`?r.getClippingAncestorRect(s):u,l=n.computePosition(t,s,{boundary:i,containingBlock:e,middleware:d,padding:f,placement:p});_=l,(c??(e=>o(e,s,m)))(l)}function b(){v||(v=!0,l===!1?y():g=e.autoUpdate(t,s,y,l))}return i(()=>{h=!1,g?.()},()=>_,b,y)}exports.createPositioner=s;
 //# sourceMappingURL=float.cjs.map

package/dist/float.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"float.cjs","names":[],"sources":["../src/float.ts"],"sourcesContent":["import type { ComputePositionOptions, ComputePositionResult, FloatHandle, Placement, ReferenceElement } from './types';\n\nimport { autoUpdate, type AutoUpdateOptions } from './auto-update';\nimport { computePosition } from './core';\n\n// ── makeHandle ────────────────────────────────────────────────────────────────\n\n/**\n * Constructs a {@link FloatHandle} with idempotent dispose, disposalSignal, and disposed getter.\n * @internal — exported for use by ssr.ts and devtools.ts only.\n */\nexport function makeHandle(\n  rawDispose: () => void,\n  getPosition: () => ComputePositionResult | null,\n  update: () => void,\n): FloatHandle {\n  const controller = new AbortController();\n  let disposed = false;\n\n  return {\n    get disposalSignal() {\n      return controller.signal;\n    },\n    dispose() {\n      if (disposed) return;\n\n      disposed = true;\n      controller.abort();\n      rawDispose();\n    },\n    get disposed() {\n      return disposed;\n    },\n    getPosition,\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n    update,\n  };\n}\n\n// ── CSS Anchor Positioning ────────────────────────────────────────────────────\n\nfunction isCssAnchorPositioningSupported(): boolean {\n  return typeof CSS !== 'undefined' && CSS.supports('anchor-name', '--orbit');\n}\n\nlet anchorCounter = 0;\n\n/**\n * Maps a placement to the CSS `position-area` value.\n * https://drafts.csswg.org/css-anchor-position/#position-area\n */\nconst POSITION_AREA: Record<Placement, string> = {\n  bottom: 'block-end center',\n  'bottom-end': 'block-end span-inline-end',\n  'bottom-start': 'block-end span-inline-start',\n  left: 'inline-start center',\n  'left-end': 'inline-start span-block-end',\n  'left-start': 'inline-start span-block-start',\n  right: 'inline-end center',\n  'right-end': 'inline-end span-block-end',\n  'right-start': 'inline-end span-block-start',\n  top: 'block-start center',\n  'top-end': 'block-start span-inline-end',\n  'top-start': 'block-start span-inline-start',\n};\n\n/** Applies a set of CSS properties to an element and returns a cleanup that restores them. */\nfunction withStyles(el: HTMLElement, props: Record<string, string>): () => void {\n  const saved: Record<string, string | undefined> = {};\n\n  for (const prop of Object.keys(props)) {\n    const prev = el.style.getPropertyValue(prop);\n\n    saved[prop] = prev !== '' ? prev : undefined;\n    el.style.setProperty(prop, props[prop]);\n  }\n\n  return () => {\n    for (const prop of Object.keys(props)) {\n      const prev = saved[prop];\n\n      if (prev !== undefined) {\n        el.style.setProperty(prop, prev);\n      } else {\n        el.style.removeProperty(prop);\n      }\n    }\n  };\n}\n\nfunction setupCssAnchorPositioning(\n  reference: HTMLElement,\n  floating: HTMLElement,\n  placement: Placement,\n  fallbacks: string,\n): () => void {\n  const name = `--orbit-${++anchorCounter}`;\n\n  const cleanupRef = withStyles(reference, { 'anchor-name': name });\n  const cleanupFloat = withStyles(floating, {\n    position: 'fixed',\n    'position-anchor': name,\n    'position-area': POSITION_AREA[placement],\n    'position-try-fallbacks': fallbacks,\n  });\n\n  return () => {\n    cleanupRef();\n    cleanupFloat();\n  };\n}\n\nexport interface CssAnchorHandle extends FloatHandle {\n  /** Always `true` — position is managed natively by CSS Anchor Positioning. */\n  readonly cssAnchor: true;\n}\n\n/**\n * Uses CSS Anchor Positioning to let the browser handle repositioning natively.\n * No JavaScript positioning loop — the browser manages placement via `position-try-fallbacks`.\n *\n * Requires both elements to be `HTMLElement`. Falls back to `float()` for complex cases\n * (e.g. middleware pipelines, custom apply callbacks).\n *\n * @experimental CSS Anchor Positioning support varies by browser. Check `isCssAnchorSupported()`\n * before using in production.\n *\n * @example\n * ```ts\n * import { floatWithAnchor } from '@vielzeug/orbit';\n *\n * const handle = floatWithAnchor(trigger, tooltip, { placement: 'top' });\n * // on hide:\n * handle.dispose();\n * ```\n */\nexport function floatWithAnchor(\n  reference: HTMLElement,\n  floating: HTMLElement,\n  {\n    fallbacks = 'flip-block, flip-inline, flip-block flip-inline',\n    placement = 'bottom',\n  }: { fallbacks?: string; placement?: Placement } = {},\n): CssAnchorHandle {\n  const cleanupFn = setupCssAnchorPositioning(reference, floating, placement, fallbacks);\n  const base = makeHandle(\n    () => cleanupFn(),\n    () => null,\n    () => {},\n  );\n\n  return Object.assign(base, { cssAnchor: true as const });\n}\n\n/**\n * Returns `true` when the browser supports CSS Anchor Positioning.\n * Use to guard `floatWithAnchor()` calls in production.\n */\nexport { isCssAnchorPositioningSupported as isCssAnchorSupported };\n\n// ── float() ───────────────────────────────────────────────────────────────────\n\n/**\n * Options for `float()`. Extends `ComputePositionOptions` so all positioning\n * options (`placement`, `middleware`, `boundary`, `padding`, `containingBlock`)\n * are inherited directly.\n */\nexport interface FloatOptions extends ComputePositionOptions {\n  /**\n   * Custom callback to apply the computed position to the DOM.\n   * Called once per position update with the full `ComputePositionResult`.\n   * Defaults to writing `left` / `top` on the floating element (requires `position: fixed`).\n   */\n  apply?: (result: ComputePositionResult) => void;\n  /**\n   * Options for the auto-update loop. Omit to use defaults.\n   * Pass `false` to disable auto-updating (position is computed once on call).\n   */\n  autoUpdate?: AutoUpdateOptions | false;\n}\n\nfunction applyDefault(result: ComputePositionResult, floating: HTMLElement): void {\n  floating.style.left = `${result.x}px`;\n  floating.style.top = `${result.y}px`;\n}\n\n/**\n * High-level API: positions the floating element and continuously keeps it updated.\n *\n * For CSS Anchor Positioning (browser-native, no JS loop), use {@link floatWithAnchor} instead.\n *\n * Returns a {@link FloatHandle} with `dispose()`, `update()`, and `getPosition()`.\n * Always call `dispose()` on teardown to remove listeners.\n *\n * @example\n * ```ts\n * const handle = float(trigger, tooltip, {\n *   placement: 'top',\n *   middleware: [offset(8), flip(), shift({ padding: 6 })],\n * });\n * // on hide:\n * handle.dispose();\n * ```\n */\nexport function float(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  {\n    apply,\n    autoUpdate: autoUpdateOptions = {},\n    boundary,\n    containingBlock,\n    middleware,\n    padding,\n    placement = 'bottom',\n  }: FloatOptions = {},\n): FloatHandle {\n  let lastPosition: ComputePositionResult | null = null;\n  const applyFn = apply ?? ((result) => applyDefault(result, floating));\n\n  function update(): void {\n    const result = computePosition(reference, floating, { boundary, containingBlock, middleware, padding, placement });\n\n    lastPosition = result;\n    applyFn(result);\n  }\n\n  if (autoUpdateOptions === false) {\n    update();\n\n    return makeHandle(\n      () => {},\n      () => lastPosition,\n      update,\n    );\n  }\n\n  const cleanupFn = autoUpdate(reference, floating, update, autoUpdateOptions);\n\n  return makeHandle(\n    () => cleanupFn(),\n    () => lastPosition,\n    update,\n  );\n}\n"],"mappings":"6DAWA,SAAgB,EACd,EACA,EACA,EACa,CACb,IAAM,EAAa,IAAI,gBACnB,EAAW,GAEf,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAO,EAAW,MACpB,EACA,SAAU,CACJ,IAEJ,EAAW,GACX,EAAW,MAAM,EACjB,EAAW,EACb,EACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,cACA,CAAC,OAAO,UAAiB,CACvB,KAAK,QAAQ,CACf,EACA,QACF,CACF,CAIA,SAAS,GAA2C,CAClD,OAAO,OAAO,IAAQ,KAAe,IAAI,SAAS,cAAe,SAAS,CAC5E,CAEA,IAAI,EAAgB,EAMd,EAA2C,CAC/C,OAAQ,mBACR,aAAc,4BACd,eAAgB,8BAChB,KAAM,sBACN,WAAY,8BACZ,aAAc,gCACd,MAAO,oBACP,YAAa,4BACb,cAAe,8BACf,IAAK,qBACL,UAAW,8BACX,YAAa,+BACf,EAGA,SAAS,EAAW,EAAiB,EAA2C,CAC9E,IAAM,EAA4C,CAAC,EAEnD,IAAK,IAAM,KAAQ,OAAO,KAAK,CAAK,EAAG,CACrC,IAAM,EAAO,EAAG,MAAM,iBAAiB,CAAI,EAE3C,EAAM,GAAQ,IAAS,GAAY,IAAA,GAAP,EAC5B,EAAG,MAAM,YAAY,EAAM,EAAM,EAAK,CACxC,CAEA,UAAa,CACX,IAAK,IAAM,KAAQ,OAAO,KAAK,CAAK,EAAG,CACrC,IAAM,EAAO,EAAM,GAEf,IAAS,IAAA,GAGX,EAAG,MAAM,eAAe,CAAI,EAF5B,EAAG,MAAM,YAAY,EAAM,CAAI,CAInC,CACF,CACF,CAEA,SAAS,EACP,EACA,EACA,EACA,EACY,CACZ,IAAM,EAAO,WAAW,EAAE,IAEpB,EAAa,EAAW,EAAW,CAAE,cAAe,CAAK,CAAC,EAC1D,EAAe,EAAW,EAAU,CACxC,SAAU,QACV,kBAAmB,EACnB,gBAAiB,EAAc,GAC/B,yBAA0B,CAC5B,CAAC,EAED,UAAa,CACX,EAAW,EACX,EAAa,CACf,CACF,CA0BA,SAAgB,EACd,EACA,EACA,CACE,YAAY,kDACZ,YAAY,UACqC,CAAC,EACnC,CACjB,IAAM,EAAY,EAA0B,EAAW,EAAU,EAAW,CAAS,EAC/E,EAAO,MACL,EAAU,MACV,SACA,CAAC,CACT,EAEA,OAAO,OAAO,OAAO,EAAM,CAAE,UAAW,EAAc,CAAC,CACzD,CA6BA,SAAS,EAAa,EAA+B,EAA6B,CAChF,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,GACnC,CAoBA,SAAgB,EACd,EACA,EACA,CACE,QACA,WAAY,EAAoB,CAAC,EACjC,WACA,kBACA,aACA,UACA,YAAY,UACI,CAAC,EACN,CACb,IAAI,EAA6C,KAC3C,EAAU,IAAW,GAAW,EAAa,EAAQ,CAAQ,GAEnE,SAAS,GAAe,CACtB,IAAM,EAAS,EAAA,gBAAgB,EAAW,EAAU,CAAE,WAAU,kBAAiB,aAAY,UAAS,WAAU,CAAC,EAEjH,EAAe,EACf,EAAQ,CAAM,CAChB,CAEA,GAAI,IAAsB,GAGxB,OAFA,EAAO,EAEA,MACC,CAAC,MACD,EACN,CACF,EAGF,IAAM,EAAY,EAAA,WAAW,EAAW,EAAU,EAAQ,CAAiB,EAE3E,OAAO,MACC,EAAU,MACV,EACN,CACF,CACF"}
+{"version":3,"file":"float.cjs","names":[],"sources":["../src/float.ts"],"sourcesContent":["import type { ComputePositionOptions, ComputePositionResult, ReferenceElement } from './types';\n\nimport { autoUpdate, type AutoUpdateOptions } from './auto-update';\nimport { getContainingBlock } from './containing-block';\nimport { computePosition } from './core';\nimport { getClippingAncestorRect } from './overflow';\n\nexport type PositionStrategy = 'absolute' | 'fixed';\n\nexport interface PositionerOptions extends Omit<ComputePositionOptions, 'boundary' | 'containingBlock'> {\n  apply?: (result: ComputePositionResult) => void;\n  autoUpdate?: AutoUpdateOptions | false;\n  boundary?: ComputePositionOptions['boundary'] | 'clippingAncestors';\n  strategy?: PositionStrategy;\n}\n\nexport interface Positioner {\n  readonly disposalSignal: AbortSignal;\n  dispose(): void;\n  readonly disposed: boolean;\n  getPosition(): ComputePositionResult | null;\n  start(): void;\n  update(): void;\n  [Symbol.dispose](): void;\n}\n\nfunction makePositioner(\n  rawDispose: () => void,\n  getPosition: () => ComputePositionResult | null,\n  start: () => void,\n  update: () => void,\n): Positioner {\n  const controller = new AbortController();\n  let disposed = false;\n\n  return {\n    get disposalSignal() {\n      return controller.signal;\n    },\n    dispose() {\n      if (disposed) return;\n\n      disposed = true;\n      controller.abort();\n      rawDispose();\n    },\n    get disposed() {\n      return disposed;\n    },\n    getPosition,\n    start(): void {\n      if (!disposed) start();\n    },\n    [Symbol.dispose](): void {\n      this.dispose();\n    },\n    update(): void {\n      if (!disposed) update();\n    },\n  };\n}\n\nfunction resolveContainingBlock(floating: HTMLElement, strategy: PositionStrategy): Element | null {\n  if (strategy === 'absolute') return floating.offsetParent instanceof Element ? floating.offsetParent : null;\n\n  return getContainingBlock(floating);\n}\n\nfunction applyDefault(result: ComputePositionResult, floating: HTMLElement, strategy: PositionStrategy): void {\n  floating.style.position = strategy;\n  floating.style.left = `${result.x}px`;\n  floating.style.top = `${result.y}px`;\n}\n\n/**\n * Creates a lifecycle-owned floating positioner.\n *\n * The positioner owns coordinate strategy, clipping-boundary resolution, updates, and cleanup.\n * Call `start()` once the elements are mounted, then call `dispose()` when their owner ends.\n */\nexport function createPositioner(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  {\n    apply,\n    autoUpdate: autoUpdateOptions = {},\n    boundary: boundaryOption = 'clippingAncestors',\n    middleware,\n    padding,\n    placement = 'bottom',\n    strategy = 'fixed',\n  }: PositionerOptions = {},\n): Positioner {\n  let active = true;\n  let cleanup: (() => void) | undefined;\n  let lastPosition: ComputePositionResult | null = null;\n  let started = false;\n\n  function update(): void {\n    if (!active) return;\n\n    const containingBlock = resolveContainingBlock(floating, strategy);\n    const boundary = boundaryOption === 'clippingAncestors' ? getClippingAncestorRect(floating) : boundaryOption;\n    const result = computePosition(reference, floating, { boundary, containingBlock, middleware, padding, placement });\n\n    lastPosition = result;\n    (apply ?? ((position) => applyDefault(position, floating, strategy)))(result);\n  }\n\n  function start(): void {\n    if (started) return;\n\n    started = true;\n\n    if (autoUpdateOptions === false) update();\n    else cleanup = autoUpdate(reference, floating, update, autoUpdateOptions);\n  }\n\n  return makePositioner(\n    () => {\n      active = false;\n      cleanup?.();\n    },\n    () => lastPosition,\n    start,\n    update,\n  );\n}\n"],"mappings":"6HA0BA,SAAS,EACP,EACA,EACA,EACA,EACY,CACZ,IAAM,EAAa,IAAI,gBACnB,EAAW,GAEf,MAAO,CACL,IAAI,gBAAiB,CACnB,OAAO,EAAW,MACpB,EACA,SAAU,CACJ,IAEJ,EAAW,GACX,EAAW,MAAM,EACjB,EAAW,EACb,EACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,cACA,OAAc,CACP,GAAU,EAAM,CACvB,EACA,CAAC,OAAO,UAAiB,CACvB,KAAK,QAAQ,CACf,EACA,QAAe,CACR,GAAU,EAAO,CACxB,CACF,CACF,CAEA,SAAS,EAAuB,EAAuB,EAA4C,CAGjG,OAFI,IAAa,WAAmB,EAAS,wBAAwB,QAAU,EAAS,aAAe,KAEhG,EAAA,mBAAmB,CAAQ,CACpC,CAEA,SAAS,EAAa,EAA+B,EAAuB,EAAkC,CAC5G,EAAS,MAAM,SAAW,EAC1B,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,GACnC,CAQA,SAAgB,EACd,EACA,EACA,CACE,QACA,WAAY,EAAoB,CAAC,EACjC,SAAU,EAAiB,oBAC3B,aACA,UACA,YAAY,SACZ,WAAW,SACU,CAAC,EACZ,CACZ,IAAI,EAAS,GACT,EACA,EAA6C,KAC7C,EAAU,GAEd,SAAS,GAAe,CACtB,GAAI,CAAC,EAAQ,OAEb,IAAM,EAAkB,EAAuB,EAAU,CAAQ,EAC3D,EAAW,IAAmB,oBAAsB,EAAA,wBAAwB,CAAQ,EAAI,EACxF,EAAS,EAAA,gBAAgB,EAAW,EAAU,CAAE,WAAU,kBAAiB,aAAY,UAAS,WAAU,CAAC,EAEjH,EAAe,GACd,IAAW,GAAa,EAAa,EAAU,EAAU,CAAQ,GAAA,CAAI,CAAM,CAC9E,CAEA,SAAS,GAAc,CACjB,IAEJ,EAAU,GAEN,IAAsB,GAAO,EAAO,EACnC,EAAU,EAAA,WAAW,EAAW,EAAU,EAAQ,CAAiB,EAC1E,CAEA,OAAO,MACC,CACJ,EAAS,GACT,IAAU,CACZ,MACM,EACN,EACA,CACF,CACF"}