stimeo-ui 0.16.0 → 0.18.0

package/dist/positioning/index.d.ts

@@ -7,8 +7,8 @@ import { Controller, Application } from '@hotwired/stimulus';
  * `anchor`, flipping/shifting it away from viewport edges as the page scrolls or
  * resizes. It is the declarative surface of the opt-in {@link attachPositioning}
  * engine (`@floating-ui/dom`-based), exposing its `autoUpdate` behavior as a
- * controller. No dedicated APG pattern; it is the
- * placement primitive the popup patterns (Tooltip / Menu / Popover …) build on.
+ * controller. No dedicated APG pattern; it is a placement primitive a consumer pairs
+ * with a popup such as `stimeo--tooltip`, `stimeo--menu` or `stimeo--popover`.
  *
  * Markup contract (identifier: `stimeo--anchored`):
  *   <div data-controller="stimeo--anchored"
@@ -18,9 +18,9 @@ import { Controller, Application } from '@hotwired/stimulus';
  *     <div data-stimeo--anchored-target="floating" role="…">…</div>
  *   </div>
  *
- * `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
+ * `active` drives tracking (start/stop) and fires on connect, mirroring
+ * `stimeo--focus`'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. 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
@@ -36,8 +36,8 @@ import { Controller, Application } from '@hotwired/stimulus';
  *
  * @remarks
  * Behavior only. It does **not** open/close, manage focus, or render an overlay
- * (pair with Dialog / Popover and {@link "../controllers/focus_controller"}), and
- * it does **not** move DOM (pair with Portal). It lives in the opt-in
+ * (pair with `stimeo--dialog` / `stimeo--popover` and `stimeo--focus`), and it does
+ * **not** move DOM (pair with `stimeo--portal`). It lives in the opt-in
  * `stimeo-ui/positioning` subpath so the core `import "stimeo-ui"` stays
  * zero-dependency; only consumers who register it pull in `@floating-ui/dom`. The
  * `autoUpdate` cleanup is released on `disconnect()` (Turbo navigation included)
@@ -80,6 +80,14 @@ declare class AnchoredController extends Controller<HTMLElement> {
             default: boolean;
         };
     };
+    static valueConstraints: {
+        offset: {
+            readonly finite: true;
+        };
+        padding: {
+            readonly finite: true;
+        };
+    };
     static events: readonly ["position"];
     readonly anchorTarget: HTMLElement;
     readonly floatingTarget: HTMLElement;

package/dist/positioning/index.js

@@ -1,7 +1,120 @@
 import { computePosition, autoUpdate, offset, flip, shift } from '@floating-ui/dom';
 import { Controller } from '@hotwired/stimulus';
 
-// src/positioning/index.ts
+var ListenerSet = class {
+  #abort = new AbortController();
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
+
+var MicrotaskCoalescer = class {
+  #run;
+  #queued = false;
+  #active = false;
+  #generation = 0;
+  constructor(run) {
+    this.#run = run;
+  }
+  activate() {
+    this.#active = true;
+  }
+  cancel() {
+    this.#active = false;
+    this.#queued = false;
+    this.#generation += 1;
+  }
+  get pending() {
+    return this.#queued;
+  }
+  schedule() {
+    if (!this.#active || this.#queued) return;
+    this.#queued = true;
+    const generation = this.#generation;
+    queueMicrotask(() => {
+      if (generation !== this.#generation || !this.#queued || !this.#active) return;
+      this.#queued = false;
+      this.#run();
+    });
+  }
+};
+
+var MorphRenderWatcher = class {
+  #listeners = new ListenerSet();
+  #pass;
+  #element = null;
+  #onMorph = () => this.#pass.schedule();
+  constructor(run) {
+    this.#pass = new MicrotaskCoalescer(run);
+  }
+  observe(element) {
+    if (this.#element === element) return;
+    this.disconnect();
+    this.#element = element;
+    this.#pass.activate();
+    this.#listeners.add(element, "turbo:morph-element", this.#onMorph);
+  }
+  schedule() {
+    this.#pass.schedule();
+  }
+  get pending() {
+    return this.#pass.pending;
+  }
+  disconnect() {
+    this.#listeners.dispose();
+    this.#pass.cancel();
+    this.#element = null;
+  }
+};
+
+var NUMBER_BOUNDS = {
+  finite: { finite: true }};
+function matchesNumberBounds(value, bounds) {
+  if (!Number.isFinite(value)) {
+    const direction = value === Infinity ? "positive" : value === -Infinity ? "negative" : null;
+    if (direction === null) return false;
+    if (bounds.allowInfinity !== "both" && bounds.allowInfinity !== direction) return false;
+  }
+  if (bounds.min !== void 0 && value < bounds.min) return false;
+  if (bounds.max !== void 0 && value > bounds.max) return false;
+  if (bounds.exclusiveMin !== void 0 && value <= bounds.exclusiveMin) return false;
+  if (bounds.integer && !Number.isInteger(value)) return false;
+  if (bounds.allowedValues !== void 0 && !bounds.allowedValues.includes(value)) return false;
+  return true;
+}
+
+function readNumber(raw, fallback, bounds) {
+  return matchesNumberBounds(raw, bounds) ? raw : fallback;
+}
+
+var NumberValueReader = class {
+  #lastRejected = /* @__PURE__ */ new Map();
+  read(owner, name, raw, fallback, bounds) {
+    const resolved = readNumber(raw, fallback, bounds);
+    if (matchesNumberBounds(raw, bounds)) {
+      this.#lastRejected.delete(name);
+      return resolved;
+    }
+    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;
+    const literal = owner.element.getAttribute(attribute);
+    if (literal === null) {
+      this.#lastRejected.delete(name);
+      return resolved;
+    }
+    if (this.#lastRejected.get(name) !== literal) {
+      this.#lastRejected.set(name, literal);
+      console.warn(
+        `Stimeo UI: "${owner.identifier}" has an invalid number Value "${name}" declaration ${JSON.stringify(literal)}; using ${fallback}.`
+      );
+    }
+    return resolved;
+  }
+};
+
 var PLACEMENTS = /* @__PURE__ */ new Set([
   "top",
   "top-start",
@@ -16,7 +129,8 @@ var PLACEMENTS = /* @__PURE__ */ new Set([
   "left-start",
   "left-end"
 ]);
-var AnchoredController = class extends Controller {
+var AnchoredController = class _AnchoredController extends Controller {
+  #numbers = new NumberValueReader();
   static targets = ["anchor", "floating"];
   static values = {
     placement: { type: String, default: "bottom" },
@@ -27,32 +141,29 @@ var AnchoredController = class extends Controller {
     strategy: { type: String, default: "absolute" },
     active: { type: Boolean, default: true }
   };
+  static valueConstraints = {
+    offset: NUMBER_BOUNDS.finite,
+    padding: NUMBER_BOUNDS.finite
+  };
   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 as of the last reconcile, empty only before the first one —
-   * a value no serialization produces, so it can never match a real key.
-   */
+  #position = null;
+  #morphRender = new MorphRenderWatcher(() => this.#sync());
   #appliedKey = "";
-  /** Elements the live observer holds, or `null` when detached — see {@link #sync}. */
   #appliedAnchor = null;
   #appliedFloating = null;
   connect() {
+    this.#morphRender.observe(this.element);
     this.#connected = true;
     this.#sync();
   }
   disconnect() {
+    this.#morphRender.disconnect();
     this.#connected = false;
     this.#sync();
   }
-  // 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();
   }
@@ -86,41 +197,23 @@ var AnchoredController = class extends Controller {
   strategyValueChanged() {
     this.#sync();
   }
-  /** Current Values mapped to the positioning engine's options. */
   get #options() {
     return {
-      // 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,
+      offset: this.#safeOffset,
       flip: this.flipValue,
       shift: this.shiftValue,
-      padding: Number.isFinite(this.paddingValue) ? this.paddingValue : 0,
+      padding: this.#safePadding,
       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, 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.
-   *
-   * @stimeoRenderRoot
-   */
   #sync() {
     const shouldTrack = this.#connected && this.activeValue && this.hasAnchorTarget && this.hasFloatingTarget;
     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) {
+      if (floating && this.#position) this.#reflectPosition(floating, this.#position);
       return;
     }
     this.#detach();
@@ -143,27 +236,42 @@ var AnchoredController = class extends Controller {
     this.#stop?.();
     this.#stop = null;
     this.#attachId = null;
+    this.#position = null;
   }
-  /**
-   * 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.#position = result;
+    this.#reflectPosition(floating, result);
     this.dispatch("position", {
       detail: { placement: result.placement, x: result.x, y: result.y }
     });
   }
+  #reflectPosition(floating, result) {
+    floating.setAttribute("data-anchored-placement", result.placement);
+    floating.style.position = this.#options.strategy ?? "absolute";
+    floating.style.left = `${result.x}px`;
+    floating.style.top = `${result.y}px`;
+  }
+  get #safeOffset() {
+    return this.#numbers.read(
+      this,
+      "offset",
+      this.offsetValue,
+      _AnchoredController.values.offset.default,
+      _AnchoredController.valueConstraints.offset
+    );
+  }
+  get #safePadding() {
+    return this.#numbers.read(
+      this,
+      "padding",
+      this.paddingValue,
+      _AnchoredController.values.padding.default,
+      _AnchoredController.valueConstraints.padding
+    );
+  }
 };
 
-// src/positioning/index.ts
 function buildMiddleware(options) {
   const padding = options.padding ?? 0;
   const middleware = [];
@@ -202,5 +310,4 @@ function registerPositioning(application) {
 }
 
 export { AnchoredController, attachPositioning, position, positioningControllers, registerPositioning };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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 * 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   * @stimeoRenderRoot\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"]}
+{"version":3,"sources":["../../src/utils/listener_set.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/morph_render_watcher.ts","../../src/utils/number_bounds.ts","../../src/utils/coerce.ts","../../src/utils/number_value.ts","../../src/positioning/anchored_controller.ts","../../src/positioning/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** What {@link ListenerSet.add} passes on besides the signal it supplies itself. */\nexport type ListenerOptions = Omit<AddEventListenerOptions, \"signal\">;\n\n/**\n * The event map a target's own `addEventListener` types its handlers with: the\n * window's, a document's, an HTML or SVG element's, any other element's, or a\n * media query list's. Other targets name none.\n */\ntype EventMapOf<T extends EventTarget> = T extends Window\n  ? WindowEventMap\n  : T extends Document\n    ? DocumentEventMap\n    : T extends HTMLElement\n      ? HTMLElementEventMap\n      : T extends SVGElement\n        ? SVGElementEventMap\n        : T extends Element\n          ? ElementEventMap\n          : T extends MediaQueryList\n            ? MediaQueryListEventMap\n            : Record<never, never>;\n\n/**\n * Owns every listener a controller attaches for one connected lifetime and\n * releases them together, so an event name is spelled once and the release\n * cannot drift from the registration.\n *\n * Detaching by hand repeats three things at the release site — the type, the\n * handler reference and the capture flag — and any one of them drifting leaves\n * a listener alive on an element the controller no longer drives. Aborting the\n * signal a registration was created with releases it whatever it was made of,\n * so the release site names nothing.\n *\n * One set per lifetime, held as a field and never rebuilt.\n * {@link ListenerSet.dispose} is the only thing that closes a generation, and it opens\n * the next one in the same step, so the lifecycle hooks can call `add` and\n * `dispose` in any order any number of times, and no `add` ever meets an\n * already aborted signal — a DOM that registers a listener on such a signal\n * would keep it forever. Rebuilding the set instead would leak:\n * `addEventListener` matches an existing registration on target, type, callback\n * and capture alone, so re-adding the same handler while the first registration\n * is live is discarded, and that live registration keeps the signal it was\n * attached with — a set built by a second `connect()` can never release what it\n * appears to own.\n *\n * Scope is the registration only. Timers, observers, leases and the order they\n * are unwound in stay with the controller, which places `dispose()` in its\n * cleanup sequence. A receiver that changes at runtime (a\n * swapped target) is rebound by calling `dispose()` and then `add()` again from\n * the rebind, not by a second set.\n *\n * A lifetime shorter than the connection — while a Value holds, until a first\n * load, while a subscription is open — gets a set of its own, which the end of\n * that lifetime disposes. A controller therefore holds one set per lifetime: the\n * connection's, and one for each swapped receiver or shorter span.\n *\n * The set must own every registration of a tuple it holds: a listener the same\n * target already carries for the same type, callback and capture flag keeps the\n * right to remove it, and this set's `add` for that tuple is discarded. A\n * subscription shared between instances behind a participant count, listeners of\n * several elements that come and go one at a time, and those one gesture holds\n * keep their own pair of calls or a signal of their own.\n *\n * @example\n * ```ts\n * readonly #listeners = new ListenerSet();\n *\n * connect(): void {\n *   this.#listeners.add(this.element, \"submit\", this.#onNativeSubmit, { capture: true });\n *   this.#listeners.add(this.element, \"turbo:submit-start\", this.#onSubmitStart);\n *   this.#listeners.add(this.element, \"turbo:submit-end\", this.#onSubmitEnd);\n * }\n *\n * disconnect(): void {\n *   this.#listeners.dispose();\n * }\n * ```\n */\nexport class ListenerSet {\n  /** The generation every `add` joins until the next `dispose()`. */\n  #abort = new AbortController();\n\n  /**\n   * Attaches `handler` to the open generation, exactly as the caller spelled it.\n   *\n   * The set supplies the signal, so `options` carries everything else the DOM\n   * accepts — `capture` included. A removal by hand would have to repeat that\n   * flag; aborting the signal releases the listener without it.\n   *\n   * A `type` the target's own event map names types `handler` with that event,\n   * as the target's `addEventListener` does, so a handler written for a\n   * `KeyboardEvent` is passed as it is; any other `type` takes an\n   * `EventListener`.\n   */\n  add<T extends EventTarget, K extends keyof EventMapOf<T> & string>(\n    target: T,\n    type: K,\n    handler: (event: EventMapOf<T>[K]) => void,\n    options?: ListenerOptions,\n  ): void;\n  add(target: EventTarget, type: string, handler: EventListener, options?: ListenerOptions): void;\n  add(target: EventTarget, type: string, handler: EventListener, options?: ListenerOptions): void {\n    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });\n  }\n\n  /**\n   * Releases every listener of the open generation, synchronously, and opens the\n   * next one. Idempotent, and safe before anything has been added.\n   */\n  dispose(): void {\n    this.#abort.abort();\n    this.#abort = new AbortController();\n  }\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Whether a requested pass has yet to run. */\n  get pending(): boolean {\n    return this.#queued;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { ListenerSet } from \"./listener_set\";\nimport { MicrotaskCoalescer } from \"./microtask_coalescer\";\n\n/**\n * Coalesces retained-element morphs and explicit lifecycle requests into one pass.\n *\n * Observe the controller's element after its initial state is settled. Morphs on\n * that element and bubbling morphs on its descendants share the same microtask\n * as {@link schedule}. The callback repairs derived output; the controller owns\n * any logical transition reporting. {@link disconnect} releases the listener and\n * cancels pending work, including work from an earlier connected lifetime.\n */\nexport class MorphRenderWatcher {\n  readonly #listeners = new ListenerSet();\n  readonly #pass: MicrotaskCoalescer;\n  #element: Element | null = null;\n  readonly #onMorph = (): void => this.#pass.schedule();\n\n  /** @param run - the single pass that repairs the settled controller's output. */\n  constructor(run: () => void) {\n    this.#pass = new MicrotaskCoalescer(run);\n  }\n\n  /** Opens observation; observing the same element again preserves queued work. */\n  observe(element: Element): void {\n    if (this.#element === element) return;\n    this.disconnect();\n    this.#element = element;\n    this.#pass.activate();\n    this.#listeners.add(element, \"turbo:morph-element\", this.#onMorph);\n  }\n\n  /** Requests one pass; requests outside an observed lifetime are ignored. */\n  schedule(): void {\n    this.#pass.schedule();\n  }\n\n  /** Whether a pass requested by a morph or {@link schedule} has yet to run. */\n  get pending(): boolean {\n    return this.#pass.pending;\n  }\n\n  /** Releases observation and pending work synchronously; safe to repeat. */\n  disconnect(): void {\n    this.#listeners.dispose();\n    this.#pass.cancel();\n    this.#element = null;\n  }\n}\n","import { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/** Semantic constraints on an already decoded number, independent of the DOM. */\nexport interface NumberBounds {\n  /** Finite numbers are required, including when this field is omitted. */\n  readonly finite?: true;\n  /** Inclusive lower endpoint. */\n  readonly min?: number;\n  /** Inclusive upper endpoint. */\n  readonly max?: number;\n  /** Exclusive lower endpoint. */\n  readonly exclusiveMin?: number;\n  /** Require a number without a fractional part. */\n  readonly integer?: boolean;\n  /** Exact decoded numbers accepted by a discrete contract. */\n  readonly allowedValues?: readonly number[];\n  /** JSON-safe exceptions to finite-number checking for unbounded endpoints. */\n  readonly allowInfinity?: \"negative\" | \"positive\" | \"both\";\n}\n\n/** One constraint for each Number Value, including shorthand declarations. */\nexport type NumberValueConstraints<Values> = {\n  readonly [Key in keyof Values as Values[Key] extends\n    | NumberConstructor\n    | { type: NumberConstructor }\n    ? Key\n    : never]: NumberBounds;\n};\n\n/** Reusable semantic domains; fractional inputs remain fractional unless excluded. */\nexport const NUMBER_BOUNDS = {\n  finite: { finite: true },\n  nonNegative: { finite: true, min: 0 },\n  positive: { finite: true, exclusiveMin: 0 },\n  nonNegativeInteger: { finite: true, min: 0, integer: true },\n  positiveInteger: { finite: true, exclusiveMin: 0, integer: true },\n  lowerBound: { finite: true, allowInfinity: \"negative\" },\n  upperBound: { finite: true, allowInfinity: \"positive\" },\n  timer: { finite: true, min: 0, max: MAX_TIMER_DELAY_MS },\n  positiveTimer: { finite: true, exclusiveMin: 0, max: MAX_TIMER_DELAY_MS },\n} as const satisfies Record<string, NumberBounds>;\n\n/**\n * Checks all declared bounds without rounding, clamping, or coercing the input.\n * Infinity exceptions relax only finite checking; every other bound still applies.\n */\nexport function matchesNumberBounds(value: number, bounds: NumberBounds): boolean {\n  if (!Number.isFinite(value)) {\n    const direction = value === Infinity ? \"positive\" : value === -Infinity ? \"negative\" : null;\n    if (direction === null) return false;\n    if (bounds.allowInfinity !== \"both\" && bounds.allowInfinity !== direction) return false;\n  }\n  if (bounds.min !== undefined && value < bounds.min) return false;\n  if (bounds.max !== undefined && value > bounds.max) return false;\n  if (bounds.exclusiveMin !== undefined && value <= bounds.exclusiveMin) return false;\n  if (bounds.integer && !Number.isInteger(value)) return false;\n  if (bounds.allowedValues !== undefined && !bounds.allowedValues.includes(value)) return false;\n  return true;\n}\n\n/** Decodes a Number Value literal; action params use their own JSON decoder. */\nexport function decodeNumberValue(raw: string): number {\n  return Number(raw.replace(/_/g, \"\"));\n}\n","/**\n * Numeric coercion for controllers that accept a number through a Value, an action\n * param, or an event detail.\n *\n * Stimulus decodes action params as JSON when possible and leaves other text\n * untouched. CustomEvent detail can also supply a number or numeric string.\n * The reader accepts those two types while rejecting blank and non-finite input.\n */\n\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** Numeric update input, accepting decoded action params before CustomEvent detail. */\nexport type NumericValueEvent = Event & {\n  params?: { amount?: unknown };\n  detail?: { value?: unknown };\n};\n\n/** Reads the nullish action-param/detail precedence without falling back from invalid input. */\nexport function eventNumber(event: NumericValueEvent): number | null {\n  return toFiniteNumber(event.params?.amount ?? event.detail?.value);\n}\n\n/**\n * Reads a finite number or nonblank numeric string; other input returns `null`.\n * Blank strings cannot silently reset a value to zero.\n */\nexport function toFiniteNumber(raw: unknown): number | null {\n  if (typeof raw !== \"number\" && typeof raw !== \"string\") return null;\n  if (typeof raw === \"string\" && raw.trim().length === 0) return null;\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Returns an accepted decoded Number Value or the caller's fallback unchanged.\n * The caller owns the fallback contract; this reader does not parse or write a Value.\n */\nexport function readNumber(raw: number, fallback: number, bounds: NumberBounds): number {\n  return matchesNumberBounds(raw, bounds) ? raw : fallback;\n}\n","import { readNumber } from \"./coerce\";\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** The instance identity carried by a Number Value read. */\nexport interface NumberValueOwner {\n  readonly identifier: string;\n  readonly element: Element;\n}\n\n/** Reads current declarations at the point of use without rewriting their attributes. */\nexport class NumberValueReader {\n  /** The last rejected literal per Value; no history grows for an unchanged instance. */\n  readonly #lastRejected = new Map<string, string>();\n\n  /** Resolves the declared number using its own fallback and shared class contract. */\n  read(\n    owner: NumberValueOwner,\n    name: string,\n    raw: number,\n    fallback: number,\n    bounds: NumberBounds,\n  ): number {\n    const resolved = readNumber(raw, fallback, bounds);\n    if (matchesNumberBounds(raw, bounds)) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;\n    const literal = owner.element.getAttribute(attribute);\n    if (literal === null) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    if (this.#lastRejected.get(name) !== literal) {\n      this.#lastRejected.set(name, literal);\n      console.warn(\n        `Stimeo UI: \"${owner.identifier}\" has an invalid number Value \"${name}\" declaration ${JSON.stringify(literal)}; using ${fallback}.`,\n      );\n    }\n    return resolved;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { MorphRenderWatcher } from \"../utils/morph_render_watcher\";\nimport { NUMBER_BOUNDS, type NumberValueConstraints } from \"../utils/number_bounds\";\nimport { NumberValueReader } from \"../utils/number_value\";\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 a placement primitive a consumer pairs\n * with a popup such as `stimeo--tooltip`, `stimeo--menu` or `stimeo--popover`.\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\n * `stimeo--focus`'s `trapValueChanged`; set it `false` while the floating element is\n * hidden 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 `stimeo--dialog` / `stimeo--popover` and `stimeo--focus`), and it does\n * **not** move DOM (pair with `stimeo--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  /** Numeric read boundaries share one reader for this controller instance. */\n  readonly #numbers = new NumberValueReader();\n\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\n  static valueConstraints = {\n    offset: NUMBER_BOUNDS.finite,\n    padding: NUMBER_BOUNDS.finite,\n  } satisfies NumberValueConstraints<typeof AnchoredController.values>;\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  #position: PositionResult | null = null;\n  readonly #morphRender = new MorphRenderWatcher(() => this.#sync());\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.#morphRender.observe(this.element);\n    this.#connected = true;\n    this.#sync();\n  }\n\n  override disconnect(): void {\n    this.#morphRender.disconnect();\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: this.#safeOffset,\n      flip: this.flipValue,\n      shift: this.shiftValue,\n      padding: this.#safePadding,\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   * @stimeoRenderRoot\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      if (floating && this.#position) this.#reflectPosition(floating, this.#position);\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    this.#position = 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    this.#position = result;\n    this.#reflectPosition(floating, result);\n    this.dispatch(\"position\", {\n      detail: { placement: result.placement, x: result.x, y: result.y },\n    });\n  }\n  /** Restores the last completed placement without restarting the attached engine. */\n  #reflectPosition(floating: HTMLElement, result: PositionResult): void {\n    floating.setAttribute(\"data-anchored-placement\", result.placement);\n    floating.style.position = this.#options.strategy ?? \"absolute\";\n    floating.style.left = `${result.x}px`;\n    floating.style.top = `${result.y}px`;\n  }\n  /** Current `offset` declaration resolved against its numeric contract. */\n  get #safeOffset(): number {\n    return this.#numbers.read(\n      this,\n      \"offset\",\n      this.offsetValue,\n      AnchoredController.values.offset.default,\n      AnchoredController.valueConstraints.offset,\n    );\n  }\n\n  /** Current `padding` declaration resolved against its numeric contract. */\n  get #safePadding(): number {\n    return this.#numbers.read(\n      this,\n      \"padding\",\n      this.paddingValue,\n      AnchoredController.values.padding.default,\n      AnchoredController.valueConstraints.padding,\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.16.0",
+  "version": "0.18.0",
   "description": "Headless Stimulus UI framework for Ruby on Rails — behavior-only, accessible components driven by HTML attributes.",
   "type": "module",
   "license": "MIT",
@@ -64,7 +64,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "bun node_modules/@typescript/native/bin/tsc --noEmit",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
@@ -84,21 +84,22 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.14",
+    "@biomejs/biome": "2.5.15",
     "@floating-ui/dom": "1.8.0",
     "@guidepup/virtual-screen-reader": "0.33.0",
     "@hotwired/stimulus": "3.2.2",
     "@hotwired/turbo": "8.0.23",
-    "@rails/actioncable": "8.1.301",
-    "@types/node": "24.13.6",
+    "@rails/actioncable": "8.1.400",
+    "@types/node": "24.19.2",
     "@types/rails__actioncable": "8.0.3",
-    "@vitest/coverage-istanbul": "5.0.1",
-    "axe-core": "4.13.0",
-    "happy-dom": "20.14.5",
-    "rollup": "4.63.3",
+    "@typescript/native": "npm:typescript@7.0.2",
+    "@vitest/coverage-istanbul": "5.0.5",
+    "axe-core": "4.14.0",
+    "happy-dom": "20.14.6",
+    "rollup": "4.64.12",
     "tsup": "8.5.1",
     "typescript": "6.0.3",
-    "vitest": "5.0.1",
+    "vitest": "5.0.5",
     "vitest-axe": "0.1.0"
   }
 }

package/dist/controllers/reset_before_cache_controller.d.ts

@@ -1,76 +0,0 @@
-import { Controller } from '@hotwired/stimulus';
-
-/**
- * Headless **before-cache reset** — Hotwire-specific, with no APG pattern. On `turbo:before-cache` it returns transient UI (open menus/modals,
- * typed-in values, spinning indicators) to its initial state, so a page restored by
- * the Back button is not frozen mid-interaction. Place one on `<body>`.
- *
- * Markup contract (identifier: `stimeo--reset-before-cache`):
- *   <body data-controller="stimeo--reset-before-cache">
- *     <details data-reset-attr="open">…</details>     <!-- remove these attributes -->
- *     <div data-reset-class="is-open is-loading">…</div> <!-- remove these classes -->
- *     <form data-reset-form>…</form>                   <!-- form.reset() -->
- *     <input data-reset-value>                          <!-- back to its authored state -->
- *     <div data-reset-hidden>transient overlay</div>    <!-- re-hide -->
- *     <div data-reset-remove>flash toast</div>          <!-- drop from the DOM -->
- *   </body>
- *
- * `scope` narrows the sweep to the first descendant matching that CSS selector;
- * left empty (the default) it covers the whole element. A selector the engine
- * cannot read falls back to that default rather than taking the sweep down with
- * it, and so does one that matches nothing.
- *
- * `reset` dispatches `{}`; `request` dispatches `{}`.
- *
- * @remarks
- * Behavior only and **idempotent** — every run converges on the same initial state,
- * holding no module-scope state. It does the cross-cutting DOM cleanup directly
- * (attribute removal, class removal, restoring a field to its authored state,
- * re-hiding, node removal) and, when
- * `dispatchReset` is on, fires `stimeo--reset-before-cache:request` so individual
- * Stimeo controllers can run their own close logic. The `turbo:before-cache`
- * listener is paired to `connect()` / `disconnect()` so it never double-registers or
- * leaks. {@link reset} is also a public action for manual triggering.
- */
-declare class ResetBeforeCacheController extends Controller<HTMLElement> {
-    #private;
-    static values: {
-        scope: {
-            type: StringConstructor;
-            default: string;
-        };
-        dispatchReset: {
-            type: BooleanConstructor;
-            default: boolean;
-        };
-    };
-    static actions: readonly ["reset"];
-    static events: readonly ["reset", "request"];
-    scopeValue: string;
-    dispatchResetValue: boolean;
-    /**
-     * Validates the scope declaration once, keeping only a selector the engine can
-     * read.
-     *
-     * A selector reads back as an ordinary string, so a malformed one survives
-     * until it is handed to the DOM — and this part runs from a single listener
-     * whose whole job is to keep a cached page from freezing. Falling back to the
-     * default keeps that job running with a visible, findable result instead of
-     * silently taking the sweep down.
-     */
-    scopeValueChanged(): void;
-    connect(): void;
-    disconnect(): void;
-    /**
-     * Resets transient UI within scope to its initial state. Asks controllers to
-     * close (via `request`) first, then applies the declarative `data-reset-*` cleanup,
-     * and finally emits `reset`. Safe to call any number of times (idempotent).
-     *
-     * `dispatchReset` decides only whether the `request` ask goes out; the cleanup
-     * and the closing `reset` run either way. Both the listener and this action
-     * reach the same sweep, so `reset` is emitted for a manual call too.
-     */
-    reset(): void;
-}
-
-export { ResetBeforeCacheController };