stimeo-ui 0.9.0 → 0.10.0

package/dist/inspector/examples.json

@@ -11,7 +11,7 @@
     },
     "stimeo--anchored": {
       "file": "examples/anchored/_demo.html.erb",
-      "source": "<%# Anchored positioning demo: the panel is positioned against the anchor button by the\n    opt-in stimeo--anchored controller (it writes only position/left/top). Choose a side\n    with the buttons — demo.js sets the placement value — and the panel mirrors the\n    resolved side via data-anchored-placement (shown through demo.css). The controller is\n    registered from the opt-in stimeo-ui/positioning subpath in demo.js; demo.css owns the\n    look. %>\n<div class=\"anchored-demo\">\n  <p class=\"anchored-demo__hint\"><%= t(\"components.anchored.demo.hint\") %></p>\n  <div class=\"anchored-demo__controls\" role=\"group\"\n    aria-label=\"<%= t('components.anchored.demo.placement_label') %>\">\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"top\" aria-pressed=\"false\">\n      <%= t(\"components.anchored.demo.placements.top\") %>\n    </button>\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"right\" aria-pressed=\"false\">\n      <%= t(\"components.anchored.demo.placements.right\") %>\n    </button>\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"bottom\" aria-pressed=\"true\">\n      <%= t(\"components.anchored.demo.placements.bottom\") %>\n    </button>\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"left\" aria-pressed=\"false\">\n      <%= t(\"components.anchored.demo.placements.left\") %>\n    </button>\n  </div>\n  <div class=\"anchored-demo__viewport\">\n    <div class=\"anchored-demo__scope\" data-controller=\"stimeo--anchored\"\n      data-stimeo--anchored-placement-value=\"bottom\"\n      data-stimeo--anchored-offset-value=\"8\"\n      data-stimeo--anchored-padding-value=\"8\">\n      <button type=\"button\" class=\"demo-trigger anchored-demo__anchor\"\n        data-stimeo--anchored-target=\"anchor\">\n        <%= t(\"components.anchored.demo.anchor\") %>\n      </button>\n      <div class=\"anchored-demo__floating\" data-stimeo--anchored-target=\"floating\"></div>\n    </div>\n  </div>\n</div>\n"
+      "source": "<%# Anchored positioning demo: the panel is positioned against the anchor button by the\n    opt-in stimeo--anchored controller (it writes only position/left/top). Choose a side\n    with the buttons — demo.js sets the placement value — and the panel mirrors the\n    resolved side via data-anchored-placement (shown through demo.css). The controller is\n    registered from the opt-in stimeo-ui/positioning subpath in demo.js; demo.css owns the\n    look. %>\n<div class=\"anchored-demo\">\n  <p class=\"anchored-demo__hint\"><%= t(\"components.anchored.demo.hint\") %></p>\n  <div class=\"anchored-demo__controls\" role=\"group\"\n    aria-label=\"<%= t('components.anchored.demo.placement_label') %>\">\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"top\" aria-pressed=\"false\">\n      <%= t(\"components.anchored.demo.placements.top\") %>\n    </button>\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"right\" aria-pressed=\"false\">\n      <%= t(\"components.anchored.demo.placements.right\") %>\n    </button>\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"bottom\" aria-pressed=\"true\">\n      <%= t(\"components.anchored.demo.placements.bottom\") %>\n    </button>\n    <button type=\"button\" class=\"demo-trigger\" data-placement=\"left\" aria-pressed=\"false\">\n      <%= t(\"components.anchored.demo.placements.left\") %>\n    </button>\n  </div>\n  <div class=\"anchored-demo__viewport\">\n    <div class=\"anchored-demo__scope\" data-controller=\"stimeo--anchored\"\n      data-stimeo--anchored-placement-value=\"bottom\"\n      data-stimeo--anchored-offset-value=\"8\"\n      data-stimeo--anchored-padding-value=\"8\">\n      <button type=\"button\" class=\"demo-trigger anchored-demo__anchor\"\n        data-stimeo--anchored-target=\"anchor\">\n        <%= t(\"components.anchored.demo.anchor\") %>\n      </button>\n      <div class=\"anchored-demo__floating\" data-stimeo--anchored-target=\"floating\"\n        data-placement-label=\"<%= t('components.anchored.demo.placement_prefix') %>\"></div>\n    </div>\n  </div>\n</div>\n"
     },
     "stimeo--announcer": {
       "file": "examples/announcer/_demo.html.erb",
@@ -263,7 +263,7 @@
     },
     "stimeo--password-strength": {
       "file": "examples/password_strength/_demo.html.erb",
-      "source": "<%# Markup for the password-strength demo.\n    The controller scores the field with a lightweight zero-dependency heuristic and\n    drives the meter (aria-valuenow), the data-strength token, and the 0–1 fill on the\n    --stimeo--password-strength custom property. The input sits inside the controller so\n    its data-action input->...#evaluate binds directly. Level labels are localized via\n    the levels value; demo.css colors the bar by the locale-independent data-strength band,\n    so the look never depends on the (translated) label text. The library writes no CSS. %>\n<% levels = t(\"components.password_strength.demo.levels\").to_json %>\n<div\n  class=\"password-strength\"\n  data-controller=\"stimeo--password-strength\"\n  data-stimeo--password-strength-levels-value=\"<%= levels %>\">\n  <label class=\"password-strength__label\" for=\"password-strength-demo-input\">\n    <%= t(\"components.password_strength.demo.label\") %>\n  </label>\n  <input\n    class=\"password-strength__input\"\n    id=\"password-strength-demo-input\"\n    type=\"password\"\n    autocomplete=\"new-password\"\n    aria-describedby=\"password-strength-demo-readout\"\n    data-stimeo--password-strength-target=\"input\"\n    data-action=\"input->stimeo--password-strength#evaluate\">\n  <div\n    class=\"password-strength__meter\"\n    role=\"meter\"\n    aria-valuemin=\"0\"\n    aria-valuemax=\"4\"\n    aria-valuenow=\"0\"\n    aria-label=\"<%= t('components.password_strength.demo.meter_label') %>\"\n    data-stimeo--password-strength-target=\"meter\">\n    <span class=\"password-strength__bar\"></span>\n  </div>\n  <span\n    class=\"password-strength__readout\"\n    id=\"password-strength-demo-readout\"\n    aria-live=\"polite\"\n    data-stimeo--password-strength-target=\"label\"></span>\n</div>\n<p class=\"password-strength__hint\"><%= t(\"components.password_strength.demo.hint\") %></p>\n"
+      "source": "<%# Markup for the password-strength demo.\n    The controller scores the field with a lightweight zero-dependency heuristic and\n    drives the meter (aria-valuenow), the data-strength token, the 0–1 fill on the\n    --stimeo--password-strength custom property, and the visible readout — all on the\n    keystroke that caused them. The input sits inside the controller so its data-action\n    input->...#evaluate binds directly. Level labels are localized via the levels value;\n    demo.css colors the bar by the locale-independent data-strength band, so the look\n    never depends on the (translated) label text.\n\n    The readout is plain visible output, not a live region: the settled level is\n    debounced into the shared stimeo--announcer your app seats once, in its layout.\n    Announcing is opt-in through announce-text-value and only fires when the level\n    actually changes. The library writes no CSS. %>\n<% levels = t(\"components.password_strength.demo.levels\").to_json %>\n<% announcement = t(\"components.password_strength.demo.announcement\") %>\n<div\n  class=\"password-strength\"\n  data-controller=\"stimeo--password-strength\"\n  data-stimeo--password-strength-levels-value=\"<%= levels %>\"\n  data-stimeo--password-strength-announce-text-value=\"<%= announcement %>\">\n  <label class=\"password-strength__label\" for=\"password-strength-demo-input\">\n    <%= t(\"components.password_strength.demo.label\") %>\n  </label>\n  <input\n    class=\"password-strength__input\"\n    id=\"password-strength-demo-input\"\n    type=\"password\"\n    autocomplete=\"new-password\"\n    aria-describedby=\"password-strength-demo-readout\"\n    data-stimeo--password-strength-target=\"input\"\n    data-action=\"input->stimeo--password-strength#evaluate\">\n  <div\n    class=\"password-strength__meter\"\n    role=\"meter\"\n    aria-valuemin=\"0\"\n    aria-valuemax=\"4\"\n    aria-valuenow=\"0\"\n    aria-label=\"<%= t('components.password_strength.demo.meter_label') %>\"\n    data-stimeo--password-strength-target=\"meter\">\n    <span class=\"password-strength__bar\"></span>\n  </div>\n  <span\n    class=\"password-strength__readout\"\n    id=\"password-strength-demo-readout\"\n    data-stimeo--password-strength-target=\"label\"></span>\n</div>\n<p class=\"password-strength__hint\"><%= t(\"components.password_strength.demo.hint\") %></p>\n"
     },
     "stimeo--persist": {
       "file": "examples/persist/_demo.html.erb",
@@ -411,7 +411,7 @@
     },
     "stimeo--theme": {
       "file": "examples/theme/_demo.html.erb",
-      "source": "<%# Markup for the theme / color-scheme toggle demo.\n    The controller persists the light/dark/system choice, follows the OS while in\n    system, and writes data-theme + color-scheme onto the target. To avoid theming the\n    whole Playground, this demo targets a local preview element instead of <html>, so\n    the preview box below reacts to the resolved theme while the page is unaffected. %>\n<div class=\"theme-demo\">\n  <div class=\"theme-demo__switcher\" data-controller=\"stimeo--theme\"\n       data-stimeo--theme-target-value=\"#theme-demo-preview\"\n       data-stimeo--theme-storage-key-value=\"stimeo-theme-demo\"\n       data-stimeo--theme-mode-value=\"system\"\n       role=\"radiogroup\" aria-label=\"<%= t(\"components.theme.demo.aria_label\") %>\">\n    <button type=\"button\" class=\"theme-demo__option\"\n            data-stimeo--theme-target=\"option\" role=\"radio\"\n            data-action=\"click->stimeo--theme#set\" data-stimeo--theme-mode-param=\"light\">\n      <%= t(\"components.theme.demo.light\") %>\n    </button>\n    <button type=\"button\" class=\"theme-demo__option\"\n            data-stimeo--theme-target=\"option\" role=\"radio\"\n            data-action=\"click->stimeo--theme#set\" data-stimeo--theme-mode-param=\"dark\">\n      <%= t(\"components.theme.demo.dark\") %>\n    </button>\n    <button type=\"button\" class=\"theme-demo__option\"\n            data-stimeo--theme-target=\"option\" role=\"radio\"\n            data-action=\"click->stimeo--theme#set\" data-stimeo--theme-mode-param=\"system\">\n      <%= t(\"components.theme.demo.system\") %>\n    </button>\n  </div>\n\n  <div id=\"theme-demo-preview\" class=\"theme-demo__preview\">\n    <h3 class=\"theme-demo__preview-title\"><%= t(\"components.theme.demo.preview_title\") %></h3>\n    <p><%= t(\"components.theme.demo.preview_text\") %></p>\n  </div>\n</div>\n"
+      "source": "<%# Markup for the theme / color-scheme toggle demo.\n    The controller persists the light/dark/system choice, follows the OS while in\n    system, and writes data-theme + color-scheme onto the target. To avoid theming the\n    whole Playground, this demo targets a local preview element instead of <html>, so\n    the preview box below reacts to the resolved theme while the page is unaffected. %>\n<div class=\"theme-demo\">\n  <div class=\"theme-demo__switcher\" data-controller=\"stimeo--theme\"\n       data-stimeo--theme-target-value=\"#theme-demo-preview\"\n       data-stimeo--theme-storage-key-value=\"stimeo-theme-demo\"\n       data-stimeo--theme-mode-value=\"system\"\n       role=\"radiogroup\" aria-label=\"<%= t(\"components.theme.demo.aria_label\") %>\">\n    <button type=\"button\" class=\"theme-demo__option\"\n            data-stimeo--theme-target=\"option\" role=\"radio\"\n            data-action=\"click->stimeo--theme#set\" data-value=\"light\">\n      <%= t(\"components.theme.demo.light\") %>\n    </button>\n    <button type=\"button\" class=\"theme-demo__option\"\n            data-stimeo--theme-target=\"option\" role=\"radio\"\n            data-action=\"click->stimeo--theme#set\" data-value=\"dark\">\n      <%= t(\"components.theme.demo.dark\") %>\n    </button>\n    <button type=\"button\" class=\"theme-demo__option\"\n            data-stimeo--theme-target=\"option\" role=\"radio\"\n            data-action=\"click->stimeo--theme#set\" data-value=\"system\">\n      <%= t(\"components.theme.demo.system\") %>\n    </button>\n  </div>\n\n  <div id=\"theme-demo-preview\" class=\"theme-demo__preview\">\n    <h3 class=\"theme-demo__preview-title\"><%= t(\"components.theme.demo.preview_title\") %></h3>\n    <p><%= t(\"components.theme.demo.preview_text\") %></p>\n  </div>\n</div>\n"
     },
     "stimeo--time-picker": {
       "file": "examples/time_picker/_demo.html.erb",

package/dist/inspector/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 12,
-  "packageVersion": "0.9.0",
+  "packageVersion": "0.10.0",
   "controllers": {
     "stimeo--accordion": {
       "targets": [
@@ -3272,15 +3272,18 @@
       ],
       "values": [
         "minScore",
-        "levels"
+        "levels",
+        "announceText"
       ],
       "valueConstraints": [],
       "valueRelations": [],
       "actions": [
-        "evaluate"
+        "evaluate",
+        "setScore"
       ],
       "events": [
-        "change"
+        "change",
+        "reconcile"
       ],
       "requiredTargets": [
         "input",

package/dist/positioning/index.d.ts

@@ -21,9 +21,16 @@ import { Controller, Application } from '@hotwired/stimulus';
  * `active` drives tracking (start/stop) and fires on connect, mirroring Focus
  * Scope's `trapValueChanged`; set it `false` while the floating element is hidden
  * so no measurement runs. The other Values map to {@link PositioningOptions} and
- * re-apply live while tracking. Only `position`/`left`/`top` inline styles are
- * written — never decoration — and the resolved (post-flip) side is mirrored onto
- * `data-anchored-placement` on the floating element for CSS hooks (e.g. an arrow).
+ * re-apply live while tracking. A declaration the engine cannot use — a
+ * `placement` outside its set, a non-finite `offset` or `padding` — falls back to
+ * that Value's default, so a typo never reaches the coordinates or the hook. Only
+ * `position`/`left`/`top` inline styles are written — never decoration — and the
+ * resolved (post-flip) side is mirrored onto `data-anchored-placement` on the
+ * floating element for CSS hooks (e.g. an arrow).
+ *
+ * Tracking follows the targets themselves, not just the Values: the engine holds
+ * the two elements it was handed, so a target added, removed or swapped at
+ * runtime re-attaches against whatever is there now.
  *
  * `position` dispatches `{ placement, x, y }`.
  *
@@ -35,7 +42,10 @@ import { Controller, Application } from '@hotwired/stimulus';
  * zero-dependency; only consumers who register it pull in `@floating-ui/dom`. The
  * `autoUpdate` cleanup is released on `disconnect()` (Turbo navigation included)
  * so no observer outlives the element, and `#sync` reconciles to a single live
- * observer (keyed on the applied options) so reconnects never stack observers.
+ * observer (keyed on the applied options and elements) so reconnects never stack
+ * observers. That cleanup stops future updates but cannot cancel one already
+ * computing, so a pass that lands after its own attach was replaced stands down
+ * instead of writing.
  */
 declare class AnchoredController extends Controller<HTMLElement> {
     #private;
@@ -84,6 +94,10 @@ declare class AnchoredController extends Controller<HTMLElement> {
     activeValue: boolean;
     connect(): void;
     disconnect(): void;
+    anchorTargetConnected(): void;
+    anchorTargetDisconnected(): void;
+    floatingTargetConnected(): void;
+    floatingTargetDisconnected(): void;
     activeValueChanged(): void;
     placementValueChanged(): void;
     offsetValueChanged(): void;

package/dist/positioning/index.js

@@ -2,6 +2,20 @@ import { computePosition, autoUpdate, offset, flip, shift } from '@floating-ui/d
 import { Controller } from '@hotwired/stimulus';
 
 // src/positioning/index.ts
+var PLACEMENTS = /* @__PURE__ */ new Set([
+  "top",
+  "top-start",
+  "top-end",
+  "right",
+  "right-start",
+  "right-end",
+  "bottom",
+  "bottom-start",
+  "bottom-end",
+  "left",
+  "left-start",
+  "left-end"
+]);
 var AnchoredController = class extends Controller {
   static targets = ["anchor", "floating"];
   static values = {
@@ -16,10 +30,18 @@ var AnchoredController = class extends Controller {
   static events = ["position"];
   /** `autoUpdate` cleanup while tracking; `null` when detached. */
   #stop = null;
+  /** Identity of the live attach; `null` when detached — see {@link #onComputed}. */
+  #attachId = null;
   /** True between connect and disconnect (Stimulus may fire value callbacks before connect). */
   #connected = false;
-  /** Serialized options of the live observer, or `null` when detached — see {@link #sync}. */
-  #appliedKey = null;
+  /**
+   * Serialized options as of the last reconcile, empty only before the first one —
+   * a value no serialization produces, so it can never match a real key.
+   */
+  #appliedKey = "";
+  /** Elements the live observer holds, or `null` when detached — see {@link #sync}. */
+  #appliedAnchor = null;
+  #appliedFloating = null;
   connect() {
     this.#connected = true;
     this.#sync();
@@ -28,8 +50,21 @@ var AnchoredController = class extends Controller {
     this.#connected = false;
     this.#sync();
   }
-  // Every value change (active or an option) re-syncs. `#sync` is idempotent and
-  // order-independent, so no Value has to be declared in a particular position.
+  // Every value change (active or an option) and every target arrival or
+  // departure re-syncs. `#sync` is idempotent and order-independent, so no Value
+  // has to be declared in a particular position.
+  anchorTargetConnected() {
+    this.#sync();
+  }
+  anchorTargetDisconnected() {
+    this.#sync();
+  }
+  floatingTargetConnected() {
+    this.#sync();
+  }
+  floatingTargetDisconnected() {
+    this.#sync();
+  }
   activeValueChanged() {
     this.#sync();
   }
@@ -54,48 +89,72 @@ var AnchoredController = class extends Controller {
   /** Current Values mapped to the positioning engine's options. */
   get #options() {
     return {
-      placement: this.placementValue,
-      offset: this.offsetValue,
+      // Narrow every free-form Value to what the engine can use. A placement
+      // outside the set would be published on the hook as a resolved side it is
+      // not, and a non-finite distance poisons the coordinate it feeds until the
+      // browser drops the whole declaration and leaves that axis unplaced.
+      placement: PLACEMENTS.has(this.placementValue) ? this.placementValue : "bottom",
+      offset: Number.isFinite(this.offsetValue) ? this.offsetValue : 0,
       flip: this.flipValue,
       shift: this.shiftValue,
-      padding: this.paddingValue,
-      // Narrow the free-form Value to the engine's union; anything but "fixed"
-      // falls back to the default "absolute".
+      padding: Number.isFinite(this.paddingValue) ? this.paddingValue : 0,
       strategy: this.strategyValue === "fixed" ? "fixed" : "absolute"
     };
   }
   /**
    * Reconciles the live observer with the desired state — track iff connected,
-   * `active`, and both targets exist — re-attaching only when that state or the
-   * options actually changed. Stimulus fires the value-changed callbacks on
-   * connect in declaration order and may run them before or after `connect()`;
-   * keying on the applied options collapses that whole burst (in any order) to a
-   * single attach, while an option change at runtime re-attaches exactly once. So
-   * correctness never depends on `active` being declared last.
+   * `active`, and both targets exist — re-attaching only when that state, the
+   * options, or the elements actually changed. Stimulus fires the value-changed
+   * callbacks on connect in declaration order and may run them before or after
+   * `connect()`; keying on what is applied collapses that whole burst (in any
+   * order) to a single attach, while an option or target change at runtime
+   * re-attaches exactly once. So correctness never depends on `active` being
+   * declared last. The elements are part of the key because the engine holds the
+   * pair it was handed: a swap leaves the same options behind and would otherwise
+   * keep measuring the node that just left the document.
    */
   #sync() {
     const shouldTrack = this.#connected && this.activeValue && this.hasAnchorTarget && this.hasFloatingTarget;
-    const key = shouldTrack ? JSON.stringify(this.#options) : null;
-    if (key === this.#appliedKey) return;
+    const anchor = shouldTrack ? this.anchorTarget : null;
+    const floating = shouldTrack ? this.floatingTarget : null;
+    const key = JSON.stringify(this.#options);
+    if (key === this.#appliedKey && anchor === this.#appliedAnchor && floating === this.#appliedFloating) {
+      return;
+    }
     this.#detach();
     this.#appliedKey = key;
-    if (shouldTrack) this.#attach();
+    this.#appliedAnchor = anchor;
+    this.#appliedFloating = floating;
+    if (anchor && floating) this.#attach(anchor, floating);
   }
-  #attach() {
+  #attach(anchor, floating) {
+    const id = /* @__PURE__ */ Symbol("anchored-attach");
+    this.#attachId = id;
     this.#stop = attachPositioning(
-      this.anchorTarget,
-      this.floatingTarget,
+      anchor,
+      floating,
       this.#options,
-      (result) => this.#onComputed(result)
+      (result) => this.#onComputed(id, floating, result)
     );
   }
   #detach() {
     this.#stop?.();
     this.#stop = null;
+    this.#attachId = null;
   }
-  /** Reflects the resolved side onto the CSS hook and announces the placement. */
-  #onComputed(result) {
-    this.floatingTarget.setAttribute("data-anchored-placement", result.placement);
+  /**
+   * Reflects the resolved side onto the CSS hook and announces the placement.
+   *
+   * The pass carries the attach that started it and the element it positioned,
+   * and lands only while that attach is still the live one: `autoUpdate`'s
+   * cleanup stops further updates but cannot cancel one already computing, so a
+   * pass superseded mid-flight would otherwise write and dispatch afterwards.
+   * The element cannot stand in for that identity — an option change re-attaches
+   * against the very same pair.
+   */
+  #onComputed(id, floating, result) {
+    if (id !== this.#attachId) return;
+    floating.setAttribute("data-anchored-placement", result.placement);
     this.dispatch("position", {
       detail: { placement: result.placement, x: result.x, y: result.y }
     });

package/dist/positioning/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/positioning/anchored_controller.ts","../../src/positioning/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\nimport { attachPositioning, type Placement, type PositioningOptions, type PositionResult } from \".\";\n\n/**\n * Headless **anchored positioning**: keeps a `floating` element placed against an\n * `anchor`, flipping/shifting it away from viewport edges as the page scrolls or\n * resizes. It is the declarative surface of the opt-in {@link attachPositioning}\n * engine (`@floating-ui/dom`-based), exposing its `autoUpdate` behavior as a\n * controller. No dedicated APG pattern; it is the\n * placement primitive the popup patterns (Tooltip / Menu / Popover …) build on.\n *\n * Markup contract (identifier: `stimeo--anchored`):\n *   <div data-controller=\"stimeo--anchored\"\n *        data-stimeo--anchored-placement-value=\"bottom-start\"\n *        data-stimeo--anchored-offset-value=\"8\">\n *     <button data-stimeo--anchored-target=\"anchor\">Open</button>\n *     <div data-stimeo--anchored-target=\"floating\" role=\"…\">…</div>\n *   </div>\n *\n * `active` drives tracking (start/stop) and fires on connect, mirroring Focus\n * Scope's `trapValueChanged`; set it `false` while the floating element is hidden\n * so no measurement runs. The other Values map to {@link PositioningOptions} and\n * re-apply live while tracking. Only `position`/`left`/`top` inline styles are\n * written — never decoration — and the resolved (post-flip) side is mirrored onto\n * `data-anchored-placement` on the floating element for CSS hooks (e.g. an arrow).\n *\n * `position` dispatches `{ placement, x, y }`.\n *\n * @remarks\n * Behavior only. It does **not** open/close, manage focus, or render an overlay\n * (pair with Dialog / Popover and {@link \"../controllers/focus_controller\"}), and\n * it does **not** move DOM (pair with Portal). It lives in the opt-in\n * `stimeo-ui/positioning` subpath so the core `import \"stimeo-ui\"` stays\n * zero-dependency; only consumers who register it pull in `@floating-ui/dom`. The\n * `autoUpdate` cleanup is released on `disconnect()` (Turbo navigation included)\n * so no observer outlives the element, and `#sync` reconciles to a single live\n * observer (keyed on the applied options) so reconnects never stack observers.\n */\nexport class AnchoredController extends Controller<HTMLElement> {\n  static override targets = [\"anchor\", \"floating\"];\n  static override values = {\n    placement: { type: String, default: \"bottom\" },\n    offset: { type: Number, default: 0 },\n    flip: { type: Boolean, default: true },\n    shift: { type: Boolean, default: true },\n    padding: { type: Number, default: 0 },\n    strategy: { type: String, default: \"absolute\" },\n    active: { type: Boolean, default: true },\n  };\n  static events = [\"position\"] as const;\n\n  declare readonly anchorTarget: HTMLElement;\n  declare readonly floatingTarget: HTMLElement;\n  declare readonly hasAnchorTarget: boolean;\n  declare readonly hasFloatingTarget: boolean;\n\n  declare placementValue: string;\n  declare offsetValue: number;\n  declare flipValue: boolean;\n  declare shiftValue: boolean;\n  declare paddingValue: number;\n  declare strategyValue: string;\n  declare activeValue: boolean;\n\n  /** `autoUpdate` cleanup while tracking; `null` when detached. */\n  #stop: (() => void) | null = null;\n  /** True between connect and disconnect (Stimulus may fire value callbacks before connect). */\n  #connected = false;\n  /** Serialized options of the live observer, or `null` when detached — see {@link #sync}. */\n  #appliedKey: string | null = null;\n\n  override connect(): void {\n    this.#connected = true;\n    this.#sync();\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#sync();\n  }\n\n  // Every value change (active or an option) re-syncs. `#sync` is idempotent and\n  // order-independent, so no Value has to be declared in a particular position.\n  activeValueChanged(): void {\n    this.#sync();\n  }\n  placementValueChanged(): void {\n    this.#sync();\n  }\n  offsetValueChanged(): void {\n    this.#sync();\n  }\n  flipValueChanged(): void {\n    this.#sync();\n  }\n  shiftValueChanged(): void {\n    this.#sync();\n  }\n  paddingValueChanged(): void {\n    this.#sync();\n  }\n  strategyValueChanged(): void {\n    this.#sync();\n  }\n\n  /** Current Values mapped to the positioning engine's options. */\n  get #options(): PositioningOptions {\n    return {\n      placement: this.placementValue as Placement,\n      offset: this.offsetValue,\n      flip: this.flipValue,\n      shift: this.shiftValue,\n      padding: this.paddingValue,\n      // Narrow the free-form Value to the engine's union; anything but \"fixed\"\n      // falls back to the default \"absolute\".\n      strategy: this.strategyValue === \"fixed\" ? \"fixed\" : \"absolute\",\n    };\n  }\n\n  /**\n   * Reconciles the live observer with the desired state — track iff connected,\n   * `active`, and both targets exist — re-attaching only when that state or the\n   * options actually changed. Stimulus fires the value-changed callbacks on\n   * connect in declaration order and may run them before or after `connect()`;\n   * keying on the applied options collapses that whole burst (in any order) to a\n   * single attach, while an option change at runtime re-attaches exactly once. So\n   * correctness never depends on `active` being declared last.\n   */\n  #sync(): void {\n    const shouldTrack =\n      this.#connected && this.activeValue && this.hasAnchorTarget && this.hasFloatingTarget;\n    const key = shouldTrack ? JSON.stringify(this.#options) : null;\n    if (key === this.#appliedKey) return;\n    this.#detach();\n    this.#appliedKey = key;\n    if (shouldTrack) this.#attach();\n  }\n\n  #attach(): void {\n    this.#stop = attachPositioning(\n      this.anchorTarget,\n      this.floatingTarget,\n      this.#options,\n      (result) => this.#onComputed(result),\n    );\n  }\n\n  #detach(): void {\n    this.#stop?.();\n    this.#stop = null;\n  }\n\n  /** Reflects the resolved side onto the CSS hook and announces the placement. */\n  #onComputed(result: PositionResult): void {\n    this.floatingTarget.setAttribute(\"data-anchored-placement\", result.placement);\n    this.dispatch(\"position\", {\n      detail: { placement: result.placement, x: result.x, y: result.y },\n    });\n  }\n}\n","import {\n  autoUpdate,\n  type ComputePositionConfig,\n  computePosition,\n  flip,\n  type Middleware,\n  offset,\n  type Placement,\n  shift,\n} from \"@floating-ui/dom\";\nimport type { Application } from \"@hotwired/stimulus\";\nimport { AnchoredController } from \"./anchored_controller\";\n\nexport type { Placement };\nexport { AnchoredController };\n\n/**\n * Opt-in shared positioning helper for Stimeo's floating components\n * (popover / tooltip / hover-card / context-menu).\n *\n * **Why this is a separate entry point.** The core library is zero-runtime-dep:\n * `import \"stimeo-ui\"` pulls in nothing but `@hotwired/stimulus`. Dynamic\n * placement — measuring the viewport / scroll parents to flip and shift a\n * floating element away from screen edges — genuinely needs a small, trustworthy\n * dependency (`@floating-ui/dom`). To keep that cost *opt-in*, this lives at\n * `stimeo-ui/positioning` and is loaded only when a consumer explicitly imports\n * it. The controllers themselves never import this module, so the core install\n * stays dependency-free.\n *\n * **What it does and does not own.** This helper writes **coordinates only** —\n * `position`, `left`, `top` inline\n * styles on the floating element. It never emits color, border, shadow, size, or\n * any other decoration: the consumer's CSS still owns the entire look. Static\n * placement (a fixed `top`/`left` in CSS) needs no JS at all; reach for this only\n * when you want edge-collision avoidance.\n */\n\n/** Options accepted by {@link position} and {@link attachPositioning}. */\nexport interface PositioningOptions {\n  /**\n   * Preferred side of the anchor to place the floating element on. Mirrors\n   * floating-ui's `Placement` (e.g. `\"bottom\"`, `\"top-start\"`). Default `\"bottom\"`.\n   */\n  placement?: Placement;\n  /** Gap in pixels between the anchor and the floating element. Default `0`. */\n  offset?: number;\n  /**\n   * Flip to the opposite side when the preferred side would overflow the\n   * viewport. Default `true`.\n   */\n  flip?: boolean;\n  /**\n   * Shift the floating element along its axis to keep it in view. Default `true`.\n   */\n  shift?: boolean;\n  /**\n   * Padding (px) kept between the floating element and the viewport edge when\n   * flipping/shifting. Default `0`.\n   */\n  padding?: number;\n  /**\n   * CSS positioning strategy written to the floating element. `\"absolute\"`\n   * (default) positions against the nearest positioned ancestor; `\"fixed\"`\n   * positions against the viewport (useful inside `overflow` containers).\n   */\n  strategy?: \"absolute\" | \"fixed\";\n}\n\n/**\n * The resolved outcome of one positioning pass: the coordinates written to the\n * floating element and the **final** placement after flip/shift. Returned by\n * {@link position} and surfaced per update through {@link attachPositioning}'s\n * `onComputed` callback so callers can react to the resolved side (e.g. flip an\n * arrow, mirror the placement onto a `data-*` hook) without re-measuring.\n */\nexport interface PositionResult {\n  /** Final placement after flip/shift resolved it (e.g. `\"top-start\"`). */\n  placement: Placement;\n  /** X coordinate written as the floating element's inline `left`. */\n  x: number;\n  /** Y coordinate written as the floating element's inline `top`. */\n  y: number;\n}\n\n/** Builds the floating-ui middleware stack from {@link PositioningOptions}. */\nfunction buildMiddleware(options: PositioningOptions): Middleware[] {\n  const padding = options.padding ?? 0;\n  const middleware: Middleware[] = [];\n  if (options.offset) middleware.push(offset(options.offset));\n  // flip before shift so a side change is considered before nudging along-axis.\n  if (options.flip !== false) middleware.push(flip({ padding }));\n  if (options.shift !== false) middleware.push(shift({ padding }));\n  return middleware;\n}\n\n/**\n * Computes a single placement for `floating` relative to `anchor` and writes the\n * resulting coordinates as inline styles on `floating`.\n *\n * This is the one-shot form: it positions once and returns. For a floating\n * element that must track scrolling/resizing while open, use\n * {@link attachPositioning} instead.\n *\n * Only `position`, `left`, and `top` are written — never any decoration. The\n * resolved {@link PositionResult} (final placement + coordinates) is returned so\n * callers can react to the side flip/shift chose.\n */\nexport async function position(\n  anchor: Element,\n  floating: HTMLElement,\n  options: PositioningOptions = {},\n): Promise<PositionResult> {\n  const strategy = options.strategy ?? \"absolute\";\n  const config: Partial<ComputePositionConfig> = {\n    placement: options.placement ?? \"bottom\",\n    middleware: buildMiddleware(options),\n    strategy,\n  };\n  const { x, y, placement } = await computePosition(anchor, floating, config);\n  Object.assign(floating.style, {\n    position: strategy,\n    left: `${x}px`,\n    top: `${y}px`,\n  });\n  return { x, y, placement };\n}\n\n/**\n * Positions `floating` against `anchor` and keeps it positioned across scroll,\n * resize, and layout changes via floating-ui's `autoUpdate`.\n *\n * Returns a cleanup function that stops tracking; call it when the floating\n * element closes or the controller disconnects (Turbo navigation included) so no\n * observer outlives the element.\n *\n * Pass `onComputed` to receive the resolved {@link PositionResult} on every\n * update (initial placement and each scroll/resize re-computation) — used to\n * mirror the final placement onto a hook or emit an event without re-measuring.\n *\n * @example\n * ```ts\n * import { attachPositioning } from \"stimeo-ui/positioning\";\n *\n * // when a popover opens:\n * const stop = attachPositioning(trigger, panel, { placement: \"bottom-start\", offset: 8 });\n * // when it closes:\n * stop();\n * ```\n */\nexport function attachPositioning(\n  anchor: Element,\n  floating: HTMLElement,\n  options: PositioningOptions = {},\n  onComputed?: (result: PositionResult) => void,\n): () => void {\n  return autoUpdate(anchor, floating, () => {\n    void position(anchor, floating, options).then((result) => onComputed?.(result));\n  });\n}\n\n/**\n * Maps the opt-in positioning controller identifiers to their classes. Kept\n * separate from the core `stimeoControllers` (`src/index.ts`) so the core\n * install never imports `@floating-ui/dom`; the Inspector manifest reflects both\n * core and positioning controllers so `stimeo check` recognizes them.\n */\nexport const positioningControllers = {\n  \"stimeo--anchored\": AnchoredController,\n} as const;\n\n/**\n * Registers the opt-in positioning controllers (e.g. `stimeo--anchored`) on a\n * Stimulus application. Call this **in addition to** `registerStimeo` only when\n * you want the declarative positioning primitives — importing this module is\n * what pulls in `@floating-ui/dom`, so the core stays zero-dependency for\n * consumers who never call it.\n *\n * @param application - The Stimulus application to register controllers on.\n *\n * @example\n * ```ts\n * import { Application } from \"@hotwired/stimulus\";\n * import { registerStimeo } from \"stimeo-ui\";\n * import { registerPositioning } from \"stimeo-ui/positioning\";\n *\n * const application = Application.start();\n * registerStimeo(application);\n * registerPositioning(application); // opt-in: adds stimeo--anchored\n * ```\n */\nexport function registerPositioning(application: Application): void {\n  for (const [identifier, controller] of Object.entries(positioningControllers)) {\n    application.register(identifier, controller);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/positioning/anchored_controller.ts","../../src/positioning/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\nimport { attachPositioning, type Placement, type PositioningOptions, type PositionResult } from \".\";\n\n/**\n * Every placement the engine accepts. A declaration outside the set has no\n * resolved side to publish, so it falls back to the Value's default rather than\n * reaching the state hook and the event detail as-is.\n */\nconst PLACEMENTS: ReadonlySet<string> = new Set([\n  \"top\",\n  \"top-start\",\n  \"top-end\",\n  \"right\",\n  \"right-start\",\n  \"right-end\",\n  \"bottom\",\n  \"bottom-start\",\n  \"bottom-end\",\n  \"left\",\n  \"left-start\",\n  \"left-end\",\n]);\n\n/**\n * Headless **anchored positioning**: keeps a `floating` element placed against an\n * `anchor`, flipping/shifting it away from viewport edges as the page scrolls or\n * resizes. It is the declarative surface of the opt-in {@link attachPositioning}\n * engine (`@floating-ui/dom`-based), exposing its `autoUpdate` behavior as a\n * controller. No dedicated APG pattern; it is the\n * placement primitive the popup patterns (Tooltip / Menu / Popover …) build on.\n *\n * Markup contract (identifier: `stimeo--anchored`):\n *   <div data-controller=\"stimeo--anchored\"\n *        data-stimeo--anchored-placement-value=\"bottom-start\"\n *        data-stimeo--anchored-offset-value=\"8\">\n *     <button data-stimeo--anchored-target=\"anchor\">Open</button>\n *     <div data-stimeo--anchored-target=\"floating\" role=\"…\">…</div>\n *   </div>\n *\n * `active` drives tracking (start/stop) and fires on connect, mirroring Focus\n * Scope's `trapValueChanged`; set it `false` while the floating element is hidden\n * so no measurement runs. The other Values map to {@link PositioningOptions} and\n * re-apply live while tracking. A declaration the engine cannot use — a\n * `placement` outside its set, a non-finite `offset` or `padding` — falls back to\n * that Value's default, so a typo never reaches the coordinates or the hook. Only\n * `position`/`left`/`top` inline styles are written — never decoration — and the\n * resolved (post-flip) side is mirrored onto `data-anchored-placement` on the\n * floating element for CSS hooks (e.g. an arrow).\n *\n * Tracking follows the targets themselves, not just the Values: the engine holds\n * the two elements it was handed, so a target added, removed or swapped at\n * runtime re-attaches against whatever is there now.\n *\n * `position` dispatches `{ placement, x, y }`.\n *\n * @remarks\n * Behavior only. It does **not** open/close, manage focus, or render an overlay\n * (pair with Dialog / Popover and {@link \"../controllers/focus_controller\"}), and\n * it does **not** move DOM (pair with Portal). It lives in the opt-in\n * `stimeo-ui/positioning` subpath so the core `import \"stimeo-ui\"` stays\n * zero-dependency; only consumers who register it pull in `@floating-ui/dom`. The\n * `autoUpdate` cleanup is released on `disconnect()` (Turbo navigation included)\n * so no observer outlives the element, and `#sync` reconciles to a single live\n * observer (keyed on the applied options and elements) so reconnects never stack\n * observers. That cleanup stops future updates but cannot cancel one already\n * computing, so a pass that lands after its own attach was replaced stands down\n * instead of writing.\n */\nexport class AnchoredController extends Controller<HTMLElement> {\n  static override targets = [\"anchor\", \"floating\"];\n  static override values = {\n    placement: { type: String, default: \"bottom\" },\n    offset: { type: Number, default: 0 },\n    flip: { type: Boolean, default: true },\n    shift: { type: Boolean, default: true },\n    padding: { type: Number, default: 0 },\n    strategy: { type: String, default: \"absolute\" },\n    active: { type: Boolean, default: true },\n  };\n  static events = [\"position\"] as const;\n\n  declare readonly anchorTarget: HTMLElement;\n  declare readonly floatingTarget: HTMLElement;\n  declare readonly hasAnchorTarget: boolean;\n  declare readonly hasFloatingTarget: boolean;\n\n  declare placementValue: string;\n  declare offsetValue: number;\n  declare flipValue: boolean;\n  declare shiftValue: boolean;\n  declare paddingValue: number;\n  declare strategyValue: string;\n  declare activeValue: boolean;\n\n  /** `autoUpdate` cleanup while tracking; `null` when detached. */\n  #stop: (() => void) | null = null;\n  /** Identity of the live attach; `null` when detached — see {@link #onComputed}. */\n  #attachId: symbol | null = null;\n  /** True between connect and disconnect (Stimulus may fire value callbacks before connect). */\n  #connected = false;\n  /**\n   * Serialized options as of the last reconcile, empty only before the first one —\n   * a value no serialization produces, so it can never match a real key.\n   */\n  #appliedKey = \"\";\n  /** Elements the live observer holds, or `null` when detached — see {@link #sync}. */\n  #appliedAnchor: Element | null = null;\n  #appliedFloating: HTMLElement | null = null;\n\n  override connect(): void {\n    this.#connected = true;\n    this.#sync();\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#sync();\n  }\n\n  // Every value change (active or an option) and every target arrival or\n  // departure re-syncs. `#sync` is idempotent and order-independent, so no Value\n  // has to be declared in a particular position.\n  anchorTargetConnected(): void {\n    this.#sync();\n  }\n  anchorTargetDisconnected(): void {\n    this.#sync();\n  }\n  floatingTargetConnected(): void {\n    this.#sync();\n  }\n  floatingTargetDisconnected(): void {\n    this.#sync();\n  }\n  activeValueChanged(): void {\n    this.#sync();\n  }\n  placementValueChanged(): void {\n    this.#sync();\n  }\n  offsetValueChanged(): void {\n    this.#sync();\n  }\n  flipValueChanged(): void {\n    this.#sync();\n  }\n  shiftValueChanged(): void {\n    this.#sync();\n  }\n  paddingValueChanged(): void {\n    this.#sync();\n  }\n  strategyValueChanged(): void {\n    this.#sync();\n  }\n\n  /** Current Values mapped to the positioning engine's options. */\n  get #options(): PositioningOptions {\n    return {\n      // Narrow every free-form Value to what the engine can use. A placement\n      // outside the set would be published on the hook as a resolved side it is\n      // not, and a non-finite distance poisons the coordinate it feeds until the\n      // browser drops the whole declaration and leaves that axis unplaced.\n      placement: PLACEMENTS.has(this.placementValue)\n        ? (this.placementValue as Placement)\n        : \"bottom\",\n      offset: Number.isFinite(this.offsetValue) ? this.offsetValue : 0,\n      flip: this.flipValue,\n      shift: this.shiftValue,\n      padding: Number.isFinite(this.paddingValue) ? this.paddingValue : 0,\n      strategy: this.strategyValue === \"fixed\" ? \"fixed\" : \"absolute\",\n    };\n  }\n\n  /**\n   * Reconciles the live observer with the desired state — track iff connected,\n   * `active`, and both targets exist — re-attaching only when that state, the\n   * options, or the elements actually changed. Stimulus fires the value-changed\n   * callbacks on connect in declaration order and may run them before or after\n   * `connect()`; keying on what is applied collapses that whole burst (in any\n   * order) to a single attach, while an option or target change at runtime\n   * re-attaches exactly once. So correctness never depends on `active` being\n   * declared last. The elements are part of the key because the engine holds the\n   * pair it was handed: a swap leaves the same options behind and would otherwise\n   * keep measuring the node that just left the document.\n   */\n  #sync(): void {\n    const shouldTrack =\n      this.#connected && this.activeValue && this.hasAnchorTarget && this.hasFloatingTarget;\n    const anchor = shouldTrack ? this.anchorTarget : null;\n    const floating = shouldTrack ? this.floatingTarget : null;\n    // The elements already say whether anything is tracked, so the key only has\n    // to say which options are on it.\n    const key = JSON.stringify(this.#options);\n    if (\n      key === this.#appliedKey &&\n      anchor === this.#appliedAnchor &&\n      floating === this.#appliedFloating\n    ) {\n      return;\n    }\n    this.#detach();\n    this.#appliedKey = key;\n    this.#appliedAnchor = anchor;\n    this.#appliedFloating = floating;\n    if (anchor && floating) this.#attach(anchor, floating);\n  }\n\n  #attach(anchor: Element, floating: HTMLElement): void {\n    const id = Symbol(\"anchored-attach\");\n    this.#attachId = id;\n    this.#stop = attachPositioning(anchor, floating, this.#options, (result) =>\n      this.#onComputed(id, floating, result),\n    );\n  }\n\n  #detach(): void {\n    this.#stop?.();\n    this.#stop = null;\n    this.#attachId = null;\n  }\n\n  /**\n   * Reflects the resolved side onto the CSS hook and announces the placement.\n   *\n   * The pass carries the attach that started it and the element it positioned,\n   * and lands only while that attach is still the live one: `autoUpdate`'s\n   * cleanup stops further updates but cannot cancel one already computing, so a\n   * pass superseded mid-flight would otherwise write and dispatch afterwards.\n   * The element cannot stand in for that identity — an option change re-attaches\n   * against the very same pair.\n   */\n  #onComputed(id: symbol, floating: HTMLElement, result: PositionResult): void {\n    if (id !== this.#attachId) return;\n    floating.setAttribute(\"data-anchored-placement\", result.placement);\n    this.dispatch(\"position\", {\n      detail: { placement: result.placement, x: result.x, y: result.y },\n    });\n  }\n}\n","import {\n  autoUpdate,\n  type ComputePositionConfig,\n  computePosition,\n  flip,\n  type Middleware,\n  offset,\n  type Placement,\n  shift,\n} from \"@floating-ui/dom\";\nimport type { Application } from \"@hotwired/stimulus\";\nimport { AnchoredController } from \"./anchored_controller\";\n\nexport type { Placement };\nexport { AnchoredController };\n\n/**\n * Opt-in shared positioning helper for Stimeo's floating components\n * (popover / tooltip / hover-card / context-menu).\n *\n * **Why this is a separate entry point.** The core library is zero-runtime-dep:\n * `import \"stimeo-ui\"` pulls in nothing but `@hotwired/stimulus`. Dynamic\n * placement — measuring the viewport / scroll parents to flip and shift a\n * floating element away from screen edges — genuinely needs a small, trustworthy\n * dependency (`@floating-ui/dom`). To keep that cost *opt-in*, this lives at\n * `stimeo-ui/positioning` and is loaded only when a consumer explicitly imports\n * it. The controllers themselves never import this module, so the core install\n * stays dependency-free.\n *\n * **What it does and does not own.** This helper writes **coordinates only** —\n * `position`, `left`, `top` inline\n * styles on the floating element. It never emits color, border, shadow, size, or\n * any other decoration: the consumer's CSS still owns the entire look. Static\n * placement (a fixed `top`/`left` in CSS) needs no JS at all; reach for this only\n * when you want edge-collision avoidance.\n */\n\n/** Options accepted by {@link position} and {@link attachPositioning}. */\nexport interface PositioningOptions {\n  /**\n   * Preferred side of the anchor to place the floating element on. Mirrors\n   * floating-ui's `Placement` (e.g. `\"bottom\"`, `\"top-start\"`). Default `\"bottom\"`.\n   */\n  placement?: Placement;\n  /** Gap in pixels between the anchor and the floating element. Default `0`. */\n  offset?: number;\n  /**\n   * Flip to the opposite side when the preferred side would overflow the\n   * viewport. Default `true`.\n   */\n  flip?: boolean;\n  /**\n   * Shift the floating element along its axis to keep it in view. Default `true`.\n   */\n  shift?: boolean;\n  /**\n   * Padding (px) kept between the floating element and the viewport edge when\n   * flipping/shifting. Default `0`.\n   */\n  padding?: number;\n  /**\n   * CSS positioning strategy written to the floating element. `\"absolute\"`\n   * (default) positions against the nearest positioned ancestor; `\"fixed\"`\n   * positions against the viewport (useful inside `overflow` containers).\n   */\n  strategy?: \"absolute\" | \"fixed\";\n}\n\n/**\n * The resolved outcome of one positioning pass: the coordinates written to the\n * floating element and the **final** placement after flip/shift. Returned by\n * {@link position} and surfaced per update through {@link attachPositioning}'s\n * `onComputed` callback so callers can react to the resolved side (e.g. flip an\n * arrow, mirror the placement onto a `data-*` hook) without re-measuring.\n */\nexport interface PositionResult {\n  /** Final placement after flip/shift resolved it (e.g. `\"top-start\"`). */\n  placement: Placement;\n  /** X coordinate written as the floating element's inline `left`. */\n  x: number;\n  /** Y coordinate written as the floating element's inline `top`. */\n  y: number;\n}\n\n/** Builds the floating-ui middleware stack from {@link PositioningOptions}. */\nfunction buildMiddleware(options: PositioningOptions): Middleware[] {\n  const padding = options.padding ?? 0;\n  const middleware: Middleware[] = [];\n  if (options.offset) middleware.push(offset(options.offset));\n  // flip before shift so a side change is considered before nudging along-axis.\n  if (options.flip !== false) middleware.push(flip({ padding }));\n  if (options.shift !== false) middleware.push(shift({ padding }));\n  return middleware;\n}\n\n/**\n * Computes a single placement for `floating` relative to `anchor` and writes the\n * resulting coordinates as inline styles on `floating`.\n *\n * This is the one-shot form: it positions once and returns. For a floating\n * element that must track scrolling/resizing while open, use\n * {@link attachPositioning} instead.\n *\n * Only `position`, `left`, and `top` are written — never any decoration. The\n * resolved {@link PositionResult} (final placement + coordinates) is returned so\n * callers can react to the side flip/shift chose.\n */\nexport async function position(\n  anchor: Element,\n  floating: HTMLElement,\n  options: PositioningOptions = {},\n): Promise<PositionResult> {\n  const strategy = options.strategy ?? \"absolute\";\n  const config: Partial<ComputePositionConfig> = {\n    placement: options.placement ?? \"bottom\",\n    middleware: buildMiddleware(options),\n    strategy,\n  };\n  const { x, y, placement } = await computePosition(anchor, floating, config);\n  Object.assign(floating.style, {\n    position: strategy,\n    left: `${x}px`,\n    top: `${y}px`,\n  });\n  return { x, y, placement };\n}\n\n/**\n * Positions `floating` against `anchor` and keeps it positioned across scroll,\n * resize, and layout changes via floating-ui's `autoUpdate`.\n *\n * Returns a cleanup function that stops tracking; call it when the floating\n * element closes or the controller disconnects (Turbo navigation included) so no\n * observer outlives the element.\n *\n * Pass `onComputed` to receive the resolved {@link PositionResult} on every\n * update (initial placement and each scroll/resize re-computation) — used to\n * mirror the final placement onto a hook or emit an event without re-measuring.\n *\n * @example\n * ```ts\n * import { attachPositioning } from \"stimeo-ui/positioning\";\n *\n * // when a popover opens:\n * const stop = attachPositioning(trigger, panel, { placement: \"bottom-start\", offset: 8 });\n * // when it closes:\n * stop();\n * ```\n */\nexport function attachPositioning(\n  anchor: Element,\n  floating: HTMLElement,\n  options: PositioningOptions = {},\n  onComputed?: (result: PositionResult) => void,\n): () => void {\n  return autoUpdate(anchor, floating, () => {\n    void position(anchor, floating, options).then((result) => onComputed?.(result));\n  });\n}\n\n/**\n * Maps the opt-in positioning controller identifiers to their classes. Kept\n * separate from the core `stimeoControllers` (`src/index.ts`) so the core\n * install never imports `@floating-ui/dom`; the Inspector manifest reflects both\n * core and positioning controllers so `stimeo check` recognizes them.\n */\nexport const positioningControllers = {\n  \"stimeo--anchored\": AnchoredController,\n} as const;\n\n/**\n * Registers the opt-in positioning controllers (e.g. `stimeo--anchored`) on a\n * Stimulus application. Call this **in addition to** `registerStimeo` only when\n * you want the declarative positioning primitives — importing this module is\n * what pulls in `@floating-ui/dom`, so the core stays zero-dependency for\n * consumers who never call it.\n *\n * @param application - The Stimulus application to register controllers on.\n *\n * @example\n * ```ts\n * import { Application } from \"@hotwired/stimulus\";\n * import { registerStimeo } from \"stimeo-ui\";\n * import { registerPositioning } from \"stimeo-ui/positioning\";\n *\n * const application = Application.start();\n * registerStimeo(application);\n * registerPositioning(application); // opt-in: adds stimeo--anchored\n * ```\n */\nexport function registerPositioning(application: Application): void {\n  for (const [identifier, controller] of Object.entries(positioningControllers)) {\n    application.register(identifier, controller);\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stimeo-ui",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Headless Stimulus UI framework for Ruby on Rails — behavior-only, accessible components driven by HTML attributes.",
   "type": "module",
   "license": "MIT",
@@ -92,15 +92,15 @@
     "@hotwired/stimulus": "3.2.2",
     "@hotwired/turbo": "8.0.23",
     "@types/node": "24.13.3",
-    "@vitest/coverage-istanbul": "4.1.10",
+    "@vitest/coverage-istanbul": "4.1.11",
     "axe-core": "4.13.0",
-    "happy-dom": "20.11.2",
+    "happy-dom": "20.11.15",
     "tsup": "8.5.1",
     "typescript": "6.0.3",
-    "vitest": "4.1.10",
+    "vitest": "4.1.11",
     "vitest-axe": "0.1.0"
   },
   "overrides": {
-    "rollup": "4.62.4"
+    "rollup": "4.63.1"
   }
 }