@antadesign/anta 0.3.31 → 0.3.33

package/dist/elements/a-slider.d.ts

@@ -1,7 +1,8 @@
 import { HTMLElementBase } from '../anta_helpers';
 import './a-slider.css';
+type SliderValue = number | [number, number];
 /**
- * `<a-slider>` is a form-associated single-value slider. Its rail uses relative
+ * `<a-slider>` is a form-associated single-value or range slider. Its rail uses relative
  * dragging by default: pressing any point captures the pointer, while only the
  * subsequent horizontal movement changes the value. Set `track-click="jump"`
  * for the conventional position-based track click.
@@ -11,10 +12,10 @@ export declare class ASliderElement extends HTMLElementBase {
     static formAssociated: boolean;
     static observedAttributes: string[];
     private internals?;
-    get value(): number;
-    set value(value: number | string);
-    get defaultValue(): number;
-    set defaultValue(value: number | string);
+    get value(): SliderValue;
+    set value(value: SliderValue | string);
+    get defaultValue(): SliderValue;
+    set defaultValue(value: SliderValue | string);
     constructor();
     connectedCallback(): void;
     attributeChangedCallback(name: string): void;
@@ -23,3 +24,4 @@ export declare class ASliderElement extends HTMLElementBase {
     formDisabledCallback(): void;
 }
 export declare function register_a_slider(): void;
+export {};

package/dist/elements/a-slider.js

@@ -4,6 +4,16 @@ const precisionOf = (value) => {
   const exponent = value.toString().match(/(?:\.(\d+))?(?:e([+-]?\d+))?$/i);
   return Math.max(0, (exponent?.[1]?.length ?? 0) - Number(exponent?.[2] ?? 0));
 };
+const parseSliderValue = (source, fallback) => {
+  if (source === null || !source.trim()) return fallback;
+  const parts = source.trim().split(/\s+/);
+  if (parts.length !== 1 && parts.length !== 2) return fallback;
+  const numbers = parts.map(Number);
+  if (!numbers.every(Number.isFinite)) return fallback;
+  return numbers.length === 2 ? [numbers[0], numbers[1]] : numbers[0];
+};
+const serializeSliderValue = (value) => Array.isArray(value) ? value.join(" ") : String(value);
+const sameSliderValue = (left, right) => Array.isArray(left) && Array.isArray(right) ? left[0] === right[0] && left[1] === right[1] : !Array.isArray(left) && !Array.isArray(right) && left === right;
 class ASliderElement extends HTMLElementBase {
   static formAssociated = true;
   static observedAttributes = [
@@ -16,13 +26,19 @@ class ASliderElement extends HTMLElementBase {
     "track-click",
     "value-display",
     "value-prefix",
-    "value-suffix"
+    "value-suffix",
+    "inverted",
+    "name",
+    "aria-label",
+    "aria-labelledby"
   ];
   internals;
   #control;
   #railArea;
   #fill;
+  #fillEnd;
   #thumb;
+  #thumbEnd;
   #header;
   #label;
   #inlineValue;
@@ -32,25 +48,31 @@ class ASliderElement extends HTMLElementBase {
   #endValuePrefix;
   #endValueSuffix;
   #thumbValue;
+  #thumbValueEnd;
   #thumbValuePrefix;
   #thumbValueSuffix;
+  #thumbValueEndPrefix;
+  #thumbValueEndSuffix;
   #markers;
   #extras;
   #value = 0;
+  #physicalValues = [0, 0];
+  #orderReversed = false;
+  #lastActiveThumb = 0;
   #seeded = false;
   #dirty = false;
   #drag;
   get value() {
-    return this.#value;
+    return Array.isArray(this.#value) ? [...this.#value] : this.#value;
   }
   set value(value) {
-    this.setAttribute("value", String(value));
+    this.setAttribute("value", Array.isArray(value) ? value.join(" ") : String(value));
   }
   get defaultValue() {
-    return finiteNumber(this.getAttribute("defaultvalue"), this.#min);
+    return parseSliderValue(this.getAttribute("defaultvalue"), this.#fallbackValue());
   }
   set defaultValue(value) {
-    this.setAttribute("defaultvalue", String(value));
+    this.setAttribute("defaultvalue", Array.isArray(value) ? value.join(" ") : String(value));
   }
   constructor() {
     super();
@@ -113,7 +135,7 @@ class ASliderElement extends HTMLElementBase {
       }
       :host([track-click="jump"]) .control { cursor: pointer; }
       .control[data-dragging] { cursor: grabbing; }
-      .control[data-dragging] .thumb { background: var(--slider-thumb-active); }
+      .control[data-dragging] .thumb[data-active] { background: var(--slider-thumb-active); }
       :host(:focus-visible) .control:not([data-pointer-focus]) {
         outline: 1px solid var(--focus-ring);
         outline-offset: 0;
@@ -137,9 +159,9 @@ class ASliderElement extends HTMLElementBase {
         background: var(--slider-track);
       }
       .fill {
-        inset-inline-start: calc(var(--slider-track-inset) - var(--anta-slider-thumb-size) / 2);
+        inset-inline-start: calc(var(--_fill-start, 0%) + var(--_fill-start-edge, 0px));
         inset-inline-end: auto;
-        inline-size: calc(var(--_percent, 0%) + var(--anta-slider-thumb-size) / 2 - var(--slider-track-inset));
+        inline-size: calc(var(--_fill-end, 0%) - var(--_fill-start, 0%) + var(--_fill-end-edge, 0px) - var(--_fill-start-edge, 0px));
         background: var(--slider-fill);
       }
       .thumb {
@@ -155,6 +177,12 @@ class ASliderElement extends HTMLElementBase {
         transition: background-color 75ms ease-out, border-color 75ms ease-out;
         transform: translate(-50%, -50%);
       }
+      .thumb[data-last-active] { z-index: 1; }
+      .thumb:focus-visible {
+        outline: 1px solid var(--focus-ring);
+        outline-offset: 2px;
+        z-index: 2;
+      }
       .thumb-value {
         display: none;
         position: absolute;
@@ -176,6 +204,7 @@ class ASliderElement extends HTMLElementBase {
         ));
       }
       :host([value-display="thumb"]) .thumb-value { display: block; }
+      :host([value-display="thumb"]) .thumb-value[hidden] { display: none !important; }
       slot[name="markers"] {
         display: block;
         position: relative;
@@ -204,6 +233,7 @@ class ASliderElement extends HTMLElementBase {
         .fill { background: Highlight; }
         .thumb { background: Canvas; border-color: CanvasText; }
         :host(:focus-visible) .control { outline: 2px solid Highlight; }
+        .thumb:focus-visible { outline: 2px solid Highlight; }
       }
       @media (prefers-reduced-motion: reduce) {
         .rail,
@@ -248,9 +278,15 @@ class ASliderElement extends HTMLElementBase {
     this.#fill = document.createElement("div");
     this.#fill.className = "fill";
     this.#fill.part.add("fill");
+    this.#fillEnd = document.createElement("div");
+    this.#fillEnd.className = "fill";
+    this.#fillEnd.part.add("fill", "fill-end");
     this.#thumb = document.createElement("div");
     this.#thumb.className = "thumb";
-    this.#thumb.part.add("thumb");
+    this.#thumb.part.add("thumb", "thumb-1");
+    this.#thumbEnd = document.createElement("div");
+    this.#thumbEnd.className = "thumb";
+    this.#thumbEnd.part.add("thumb", "thumb-2");
     this.#thumbValue = document.createElement("span");
     this.#thumbValue.className = "thumb-value";
     this.#thumbValue.part.add("thumb-value");
@@ -259,7 +295,15 @@ class ASliderElement extends HTMLElementBase {
     this.#thumbValueSuffix = document.createElement("span");
     this.#thumbValueSuffix.className = "value-affix";
     this.#thumbValue.append(this.#thumbValuePrefix, this.#thumbValueSuffix);
-    this.#railArea.append(rail, this.#fill, this.#thumb, this.#thumbValue);
+    this.#thumbValueEnd = document.createElement("span");
+    this.#thumbValueEnd.className = "thumb-value";
+    this.#thumbValueEnd.part.add("thumb-value", "thumb-value-2");
+    this.#thumbValueEndPrefix = document.createElement("span");
+    this.#thumbValueEndPrefix.className = "value-affix";
+    this.#thumbValueEndSuffix = document.createElement("span");
+    this.#thumbValueEndSuffix.className = "value-affix";
+    this.#thumbValueEnd.append(this.#thumbValueEndPrefix, this.#thumbValueEndSuffix);
+    this.#railArea.append(rail, this.#fill, this.#fillEnd, this.#thumb, this.#thumbEnd, this.#thumbValue, this.#thumbValueEnd);
     this.#control.append(this.#railArea);
     this.#markers = document.createElement("slot");
     this.#markers.name = "markers";
@@ -267,7 +311,17 @@ class ASliderElement extends HTMLElementBase {
     this.#extras = document.createElement("slot");
     this.#extras.part.add("extras");
     for (const slot of [this.#label, this.#markers, this.#extras]) {
-      slot.addEventListener("slotchange", () => this.#syncSlotVisibility());
+      slot.addEventListener("slotchange", () => {
+        this.#syncSlotVisibility();
+        if (slot === this.#label) this.#paintAccessibility();
+      });
+    }
+    for (const [index, thumb] of [this.#thumb, this.#thumbEnd].entries()) {
+      thumb.addEventListener("focus", () => {
+        if (!Array.isArray(this.#value)) return;
+        this.#lastActiveThumb = index;
+        this.#paint();
+      });
     }
     this.#control.addEventListener("pointerdown", (event) => this.#beginDrag(event));
     this.#control.addEventListener("pointermove", (event) => this.#moveDrag(event));
@@ -280,7 +334,7 @@ class ASliderElement extends HTMLElementBase {
   }
   connectedCallback() {
     if (!this.#seeded) {
-      this.#value = this.#initialValue();
+      this.#applyValue(this.#initialValue());
       this.#seeded = true;
     }
     this.#paint();
@@ -290,29 +344,29 @@ class ASliderElement extends HTMLElementBase {
     if (!this.#seeded) return;
     if (name === "value") {
       if (this.hasAttribute("value")) {
-        this.#value = this.#normalize(finiteNumber(this.getAttribute("value"), this.#min));
+        this.#applyValue(parseSliderValue(this.getAttribute("value"), this.#fallbackValue()));
         this.#dirty = false;
       } else if (!this.#dirty) {
-        this.#value = this.#initialValue();
+        this.#applyValue(this.#initialValue());
       }
     } else if (name === "defaultvalue" && !this.hasAttribute("value") && !this.#dirty) {
-      this.#value = this.#initialValue();
+      this.#applyValue(this.#initialValue());
     } else if (name === "min" || name === "max" || name === "step") {
-      this.#value = this.#normalize(this.#value);
+      this.#applyValue(this.#value);
     }
     this.#paint();
     if (name === "value-display") this.#syncSlotVisibility();
   }
   formResetCallback() {
     const previous = this.#value;
-    this.#value = this.#normalize(finiteNumber(this.getAttribute("defaultvalue"), this.#min));
+    this.#applyValue(this.defaultValue);
     this.#dirty = false;
     this.#paint();
-    if (this.#value !== previous) this.#emitInputAndChange();
+    if (!sameSliderValue(this.#value, previous)) this.#emitInputAndChange();
   }
   formStateRestoreCallback(state) {
     if (typeof state !== "string") return;
-    this.#value = this.#normalize(finiteNumber(state, this.#min));
+    this.#applyValue(parseSliderValue(state, this.#fallbackValue()));
     this.#dirty = true;
     this.#paint();
   }
@@ -332,9 +386,13 @@ class ASliderElement extends HTMLElementBase {
   get #isDisabled() {
     return this.hasAttribute("disabled") || this.matches(":disabled");
   }
+  #fallbackValue() {
+    const range = Array.isArray(this.#value) || Array.isArray(parseSliderValue(this.getAttribute("value"), this.#min));
+    return range ? [this.#min, this.#max] : this.#min;
+  }
   #initialValue() {
     const source = this.getAttribute("value") ?? this.getAttribute("defaultvalue");
-    return this.#normalize(finiteNumber(source, this.#min));
+    return parseSliderValue(source, this.#fallbackValue());
   }
   #normalize(value) {
     const min = this.#min;
@@ -344,38 +402,145 @@ class ASliderElement extends HTMLElementBase {
     const precision = Math.min(12, Math.max(precisionOf(min), precisionOf(max), precisionOf(step)));
     return Number(Math.min(max, Math.max(min, stepped)).toFixed(precision));
   }
-  #percent(value = this.#value) {
+  #normalizeValue(value) {
+    if (!Array.isArray(value)) return this.#normalize(value);
+    const low = this.#normalize(value[0]);
+    const high = this.#normalize(value[1]);
+    return low <= high ? [low, high] : [high, low];
+  }
+  #applyValue(value) {
+    const next = this.#normalizeValue(value);
+    const wasRange = Array.isArray(this.#value);
+    this.#value = next;
+    if (Array.isArray(next)) {
+      if (!wasRange) this.#orderReversed = false;
+      this.#physicalValues = this.#orderReversed ? [next[1], next[0]] : [next[0], next[1]];
+    } else {
+      this.#physicalValues = [next, next];
+      this.#orderReversed = false;
+    }
+  }
+  #percent(value) {
     const range = this.#max - this.#min;
     return range > 0 ? (value - this.#min) / range * 100 : 0;
   }
   #paint() {
-    const percent = `${this.#percent()}%`;
-    this.#railArea.style.setProperty("--_percent", percent);
-    const value = this.#displayValue();
-    const displayedValue = String(this.#value);
+    const currentValue = this.#value;
+    const range = Array.isArray(currentValue);
+    const low = range ? currentValue[0] : this.#min;
+    const high = range ? currentValue[1] : currentValue;
+    const lowPercent = `${this.#percent(low)}%`;
+    const highPercent = `${this.#percent(high)}%`;
+    const [first, second] = range ? this.#physicalValues : [high, high];
+    this.#thumb.style.setProperty("--_percent", `${this.#percent(first)}%`);
+    this.#thumbEnd.style.setProperty("--_percent", `${this.#percent(second)}%`);
+    this.#thumb.toggleAttribute("data-last-active", this.#lastActiveThumb === 0);
+    this.#thumbEnd.toggleAttribute("data-last-active", this.#lastActiveThumb === 1);
+    this.#thumbValue.style.setProperty("--_percent", `${this.#percent(first)}%`);
+    this.#thumbValueEnd.style.setProperty("--_percent", `${this.#percent(second)}%`);
+    this.#thumbEnd.hidden = !range;
+    const coincident = range && first === second;
+    this.#thumbValue.hidden = coincident && this.#lastActiveThumb !== 0;
+    this.#thumbValueEnd.hidden = !range || coincident && this.#lastActiveThumb !== 1;
+    const edgeStart = "calc(var(--slider-track-inset) - var(--anta-slider-thumb-size) / 2)";
+    const edgeEnd = "calc(var(--anta-slider-thumb-size) / 2 - var(--slider-track-inset))";
+    const setFill = (fill, start, end, startEdge = "0px", endEdge = "0px") => {
+      fill.style.setProperty("--_fill-start", start);
+      fill.style.setProperty("--_fill-end", end);
+      fill.style.setProperty("--_fill-start-edge", startEdge);
+      fill.style.setProperty("--_fill-end-edge", endEdge);
+    };
+    if (this.hasAttribute("inverted")) {
+      this.#fill.hidden = range ? low === this.#min : high === this.#max;
+      setFill(this.#fill, range ? "0%" : highPercent, range ? lowPercent : "100%", range ? edgeStart : high === this.#min ? edgeStart : "0px", range ? "0px" : edgeEnd);
+      this.#fillEnd.hidden = !range || high === this.#max;
+      if (range) setFill(this.#fillEnd, highPercent, "100%", "0px", edgeEnd);
+    } else {
+      this.#fill.hidden = range ? low === high : high === this.#min;
+      setFill(this.#fill, range ? lowPercent : "0%", highPercent, range && low !== this.#min ? "0px" : edgeStart, range && high === this.#max ? edgeEnd : "0px");
+      this.#fillEnd.hidden = true;
+    }
+    this.#renderValue(this.#inlineValue, this.#inlineValuePrefix, this.#inlineValueSuffix, range ? low : high, range ? high : void 0);
+    this.#renderValue(this.#endValue, this.#endValuePrefix, this.#endValueSuffix, range ? low : high, range ? high : void 0);
+    this.#renderValue(this.#thumbValue, this.#thumbValuePrefix, this.#thumbValueSuffix, first);
+    if (range) this.#renderValue(this.#thumbValueEnd, this.#thumbValueEndPrefix, this.#thumbValueEndSuffix, second);
+    this.#paintAccessibility();
+    this.#paintFormValue();
+  }
+  #renderValue(element, prefixElement, suffixElement, first, second) {
+    const prefix = this.getAttribute("value-prefix") ?? "";
+    const suffix = this.getAttribute("value-suffix") ?? "";
+    element.textContent = String(first);
+    prefixElement.textContent = prefix;
+    suffixElement.textContent = suffix;
+    element.prepend(prefixElement);
+    element.append(suffixElement);
+    if (second === void 0) return;
+    const secondPrefix = prefixElement.cloneNode(true);
+    const secondSuffix = suffixElement.cloneNode(true);
+    element.append("\u2013", secondPrefix, String(second), secondSuffix);
+  }
+  #formatValue(value) {
     const prefix = this.getAttribute("value-prefix") ?? "";
     const suffix = this.getAttribute("value-suffix") ?? "";
-    for (const [element, prefixElement, suffixElement] of [
-      [this.#inlineValue, this.#inlineValuePrefix, this.#inlineValueSuffix],
-      [this.#endValue, this.#endValuePrefix, this.#endValueSuffix],
-      [this.#thumbValue, this.#thumbValuePrefix, this.#thumbValueSuffix]
-    ]) {
-      element.textContent = displayedValue;
-      prefixElement.textContent = prefix;
-      suffixElement.textContent = suffix;
-      element.prepend(prefixElement);
-      element.append(suffixElement);
+    return `${prefix}${value}${suffix}`;
+  }
+  #paintAccessibility() {
+    const range = Array.isArray(this.#value);
+    const slottedLabel = this.#label.assignedNodes({ flatten: true }).map((node) => node.textContent ?? "").join("").trim();
+    const root = this.getRootNode();
+    const referencedLabel = (this.getAttribute("aria-labelledby") ?? "").split(/\s+/).map((id) => root.getElementById(id)?.textContent?.trim() ?? "").filter(Boolean).join(" ");
+    const base = (this.getAttribute("aria-label") ?? referencedLabel ?? slottedLabel).trim() || slottedLabel;
+    const internals = this.internals;
+    if (internals) {
+      internals.role = range ? "group" : "slider";
+      internals.ariaLabel = !this.hasAttribute("aria-label") && !this.hasAttribute("aria-labelledby") ? slottedLabel || null : null;
+      internals.ariaValueMin = range ? null : String(this.#min);
+      internals.ariaValueMax = range ? null : String(this.#max);
+      internals.ariaValueNow = range ? null : String(this.#value);
+      internals.ariaValueText = range ? null : this.#formatValue(this.#value);
+    }
+    for (const [index, thumb] of [this.#thumb, this.#thumbEnd].entries()) {
+      if (!range) {
+        thumb.removeAttribute("role");
+        thumb.tabIndex = -1;
+        thumb.removeAttribute("aria-label");
+        thumb.removeAttribute("aria-valuemin");
+        thumb.removeAttribute("aria-valuemax");
+        thumb.removeAttribute("aria-valuenow");
+        thumb.removeAttribute("aria-valuetext");
+        thumb.removeAttribute("aria-disabled");
+        continue;
+      }
+      const endpoint = index === 0 !== this.#orderReversed ? "minimum" : "maximum";
+      const value = this.#physicalValues[index];
+      thumb.role = "slider";
+      thumb.tabIndex = this.#isDisabled ? -1 : 0;
+      thumb.ariaLabel = base ? `${base} ${endpoint}` : `${endpoint[0].toUpperCase()}${endpoint.slice(1)} value`;
+      thumb.ariaValueMin = String(this.#min);
+      thumb.ariaValueMax = String(this.#max);
+      thumb.ariaValueNow = String(value);
+      thumb.ariaValueText = this.#formatValue(value);
+      thumb.ariaDisabled = this.#isDisabled ? "true" : null;
     }
+  }
+  #paintFormValue() {
     const internals = this.internals;
     if (!internals) return;
-    internals.ariaValueMin = String(this.#min);
-    internals.ariaValueMax = String(this.#max);
-    internals.ariaValueNow = String(this.#value);
-    internals.ariaValueText = value;
-    internals.setFormValue(this.#isDisabled ? null : String(this.#value), String(this.#value));
-  }
-  #displayValue() {
-    return `${this.getAttribute("value-prefix") ?? ""}${this.#value}${this.getAttribute("value-suffix") ?? ""}`;
+    const state = serializeSliderValue(this.#value);
+    if (this.#isDisabled) {
+      internals.setFormValue(null, state);
+    } else if (Array.isArray(this.#value)) {
+      const formValue = new FormData();
+      const name = this.getAttribute("name");
+      if (name) {
+        formValue.append(name, String(this.#value[0]));
+        formValue.append(name, String(this.#value[1]));
+      }
+      internals.setFormValue(formValue, state);
+    } else {
+      internals.setFormValue(state, state);
+    }
   }
   #syncSlotVisibility() {
     const assigned = (slot) => slot.assignedNodes({ flatten: true }).length > 0;
@@ -383,12 +548,25 @@ class ASliderElement extends HTMLElementBase {
     this.#markers.hidden = !assigned(this.#markers);
     this.#extras.hidden = !assigned(this.#extras);
   }
-  #setValue(value) {
+  #setValue(value, thumb = 0) {
     const next = this.#normalize(value);
-    if (next === this.#value) return false;
-    this.#value = next;
+    if (Array.isArray(this.#value)) {
+      const previous = this.#value;
+      this.#physicalValues[thumb] = next;
+      if (this.#physicalValues[0] !== this.#physicalValues[1]) {
+        this.#orderReversed = this.#physicalValues[0] > this.#physicalValues[1];
+      }
+      this.#value = this.#orderReversed ? [this.#physicalValues[1], this.#physicalValues[0]] : [this.#physicalValues[0], this.#physicalValues[1]];
+      this.#lastActiveThumb = thumb;
+      this.#paint();
+      if (sameSliderValue(previous, this.#value)) return false;
+    } else {
+      if (next === this.#value) return false;
+      this.#value = next;
+      this.#physicalValues = [next, next];
+      this.#paint();
+    }
     this.#dirty = true;
-    this.#paint();
     this.dispatchEvent(new Event("input", { bubbles: true, composed: true }));
     return true;
   }
@@ -398,19 +576,33 @@ class ASliderElement extends HTMLElementBase {
   }
   #valueAt(clientX) {
     const rect = this.#railArea.getBoundingClientRect();
-    if (rect.width <= 0) return this.#value;
+    if (rect.width <= 0) return Array.isArray(this.#value) ? this.#physicalValues[this.#lastActiveThumb] : this.#value;
     return this.#min + (clientX - rect.left) / rect.width * (this.#max - this.#min);
   }
+  #thumbAt(clientX) {
+    if (!Array.isArray(this.#value)) return 0;
+    const candidate = this.#valueAt(clientX);
+    const firstDistance = Math.abs(candidate - this.#physicalValues[0]);
+    const secondDistance = Math.abs(candidate - this.#physicalValues[1]);
+    return firstDistance === secondDistance ? this.#lastActiveThumb : firstDistance < secondDistance ? 0 : 1;
+  }
   #beginDrag(event) {
     if (this.#isDisabled || event.button !== 0) return;
     const rect = this.#railArea.getBoundingClientRect();
     if (rect.width <= 0) return;
-    this.#drag = { pointerId: event.pointerId, startX: event.clientX, startValue: this.#value };
+    const thumb = event.composedPath()[0] === this.#thumb ? 0 : event.composedPath()[0] === this.#thumbEnd ? 1 : this.#thumbAt(event.clientX);
+    const startValue = Array.isArray(this.#value) ? this.#physicalValues[thumb] : this.#value;
+    this.#drag = { pointerId: event.pointerId, startX: event.clientX, startValue, startPublicValue: this.value, thumb };
     this.#control.setPointerCapture(event.pointerId);
     this.#control.dataset.dragging = "";
     this.#control.dataset.pointerFocus = "";
-    this.focus({ preventScroll: true });
-    if (this.getAttribute("track-click") === "jump") this.#setValue(this.#valueAt(event.clientX));
+    this.#lastActiveThumb = thumb;
+    this.#thumb.toggleAttribute("data-last-active", thumb === 0);
+    this.#thumbEnd.toggleAttribute("data-last-active", thumb === 1);
+    const focusTarget = Array.isArray(this.#value) ? [this.#thumb, this.#thumbEnd][thumb] : this;
+    focusTarget.focus({ preventScroll: true });
+    [this.#thumb, this.#thumbEnd][thumb].dataset.active = "";
+    if (this.getAttribute("track-click") === "jump") this.#setValue(this.#valueAt(event.clientX), thumb);
     event.preventDefault();
   }
   #moveDrag(event) {
@@ -421,7 +613,7 @@ class ASliderElement extends HTMLElementBase {
       return;
     }
     const next = this.getAttribute("track-click") === "jump" ? this.#valueAt(event.clientX) : drag.startValue + (event.clientX - drag.startX) / this.#railArea.getBoundingClientRect().width * (this.#max - this.#min);
-    this.#setValue(next);
+    this.#setValue(next, drag.thumb);
     event.preventDefault();
   }
   #finishDrag(event) {
@@ -429,28 +621,33 @@ class ASliderElement extends HTMLElementBase {
     if (!drag || drag.pointerId !== event.pointerId) return;
     this.#drag = void 0;
     delete this.#control.dataset.dragging;
+    delete [this.#thumb, this.#thumbEnd][drag.thumb].dataset.active;
     if (this.#control.hasPointerCapture(event.pointerId)) this.#control.releasePointerCapture(event.pointerId);
-    if (this.#value !== drag.startValue) this.dispatchEvent(new Event("change", { bubbles: true, composed: true }));
+    if (!sameSliderValue(this.#value, drag.startPublicValue)) this.dispatchEvent(new Event("change", { bubbles: true, composed: true }));
   }
   #handleKeydown(event) {
-    if (event.target !== this || this.#isDisabled || isModifiedNavigationKey(event)) return;
+    const source = event.composedPath()[0];
+    const range = Array.isArray(this.#value);
+    const thumb = source === this.#thumb ? 0 : source === this.#thumbEnd ? 1 : void 0;
+    if ((range ? thumb === void 0 : source !== this) || this.#isDisabled || isModifiedNavigationKey(event)) return;
     delete this.#control.dataset.pointerFocus;
     const page = Math.max(this.#step, (this.#max - this.#min) / 10);
+    const current = range ? this.#physicalValues[thumb ?? 0] : this.#value;
     let next;
     switch (event.key) {
       case "ArrowRight":
       case "ArrowUp":
-        next = this.#value + this.#step;
+        next = current + this.#step;
         break;
       case "ArrowLeft":
       case "ArrowDown":
-        next = this.#value - this.#step;
+        next = current - this.#step;
         break;
       case "PageUp":
-        next = this.#value + page;
+        next = current + page;
         break;
       case "PageDown":
-        next = this.#value - page;
+        next = current - page;
         break;
       case "Home":
         next = this.#min;
@@ -462,7 +659,7 @@ class ASliderElement extends HTMLElementBase {
         return;
     }
     event.preventDefault();
-    if (this.#setValue(next)) this.dispatchEvent(new Event("change", { bubbles: true, composed: true }));
+    if (this.#setValue(next, range ? thumb ?? 0 : 0)) this.dispatchEvent(new Event("change", { bubbles: true, composed: true }));
   }
 }
 function register_a_slider() {

package/dist/general_types.d.ts

@@ -334,6 +334,10 @@ export interface ABoxAttributes extends BaseAttributes {
      *  typed `attr()` read it from `--box-gap` in the host's inline style
      *  instead, which is what the JSX wrapper always sets. */
     gap?: boolean | '' | number | string;
+    /** Adds matching descendant rects to each measurement snapshot. With
+     * `observe="scroll"`, use `throttle` when many descendants match: rects are
+     * read for each emitted event, and CSS state updates follow the interval. */
+    'include-rects-for'?: string;
     /** CSS padding shorthand (`padding="8px 16px"`). Without typed `attr()`
      * support, set `--box-padding` as well. The JSX wrapper supplies it. */
     padding?: boolean | '' | number | string;
@@ -348,8 +352,12 @@ export interface ABoxAttributes extends BaseAttributes {
      * attribute means `all`. Omission runs no observers unless `fade` is set;
      * a native event listener alone does not enable observation. */
     observe?: string;
-    /** Minimum interval between measurement events in milliseconds. Omit or
-     * pass `0` for frame-based reporting. Invalid or negative values use `0`. */
+    /** Keeps measurement observation active outside the viewport when `observe`
+     * or `fade` selects measurement. */
+    'observe-offscreen'?: boolean | '';
+    /** Minimum interval between measurement reads, CSS state updates, and
+     * events in milliseconds. The initial read is immediate. Omit or pass `0`
+     * for frame-based updates. Invalid or negative values use `0`. */
     throttle?: number | string;
     /** Depth of that mask, as a length value (`fade-size="2rem"`). Engines
      *  without typed `attr()` read it from `--box-fade-size` in the host's
@@ -423,6 +431,11 @@ export interface ATagAttributes extends BaseAttributes {
  * use `Expander` from `@antadesign/anta`.
  */
 export interface AExpanderAttributes extends BaseAttributes {
+    /** Built-in disclosure mark. Custom visuals use `slot="indicator"`.
+     *  Defaults to `chevron`. */
+    indicator?: 'chevron' | 'triangle' | 'plus';
+    /** Logical side for the disclosure mark. Defaults to `start`. */
+    'indicator-placement'?: 'start' | 'end';
     /** Controlled open state (`'open'` / `'closed'`). Present → controlled: the
      *  attribute is the source of truth, clicks only dispatch the cancelable
      *  `statechange` event, and the consumer answers by updating it. Absent →
@@ -434,10 +447,9 @@ export interface AExpanderAttributes extends BaseAttributes {
     /** Surface emphasis. `secondary` (default) is a subtle fill; `primary`
      *  is a stronger raised fill; `tertiary` is transparent. */
     priority?: 'primary' | 'secondary' | 'tertiary';
-    /** Outdent the chevron into the left gutter so the title + body sit
-     *  flush with surrounding content (the docs-header layout). Tertiary
-     *  only — a no-op on the filled priorities, where the container edge
-     *  has to bound the chevron. Presence-based. */
+    /** Align the title and body with surrounding content on a tertiary
+     *  expander. The start indicator hangs in the gutter; an end indicator
+     *  stays inside its edge. Presence-based. */
     outdent?: boolean | '';
     /** Disables the header: not clickable or focusable, hover affordance
      *  off, text dimmed. The open state freezes as-is. Presence-based. */
@@ -693,9 +705,12 @@ export interface AInputAttributes extends BaseAttributes {
      *  wrapper) the glyph. Only `critical` carries validity weight (`aria-invalid`
      *  + `:state(invalid)`); the others are advisory. Omit for the neutral field. */
     status?: 'neutral' | 'brand' | 'info' | 'success' | 'warning' | 'critical';
-    /** Custom accent color (any literal CSS color) — tints the resting + hover
-     *  border via an oklch derivation. `status` overrides it for validation. */
+    /** Custom accent color (any literal CSS color) — tints the border when shown
+     *  via an oklch derivation. `status` overrides it for validation. */
     tone?: string;
+    /** Field emphasis. Secondary removes the fill; tertiary also makes the
+     *  resting border transparent. Status borders remain visible. */
+    priority?: 'primary' | 'secondary' | 'tertiary';
     /** Disabled state. Presence-based. */
     disabled?: boolean | '';
     /** Read-only state. Presence-based. */
@@ -750,9 +765,9 @@ export interface AInputAttributes extends BaseAttributes {
 /** Attributes for the `<a-slider>` custom element. For the typed JSX wrapper,
  * display formatting, and marker layout use `Slider` from `@antadesign/anta`. */
 export interface ASliderAttributes extends BaseAttributes {
-    /** Controlled numeric value. */
+    /** Controlled value. Range attributes use two space-separated numbers. */
     value?: number | string;
-    /** Initial uncontrolled value and form-reset baseline. */
+    /** Initial uncontrolled value and form-reset baseline. Range attributes use two space-separated numbers. */
     defaultvalue?: number | string;
     /** Lowest permitted value. Defaults to 0. */
     min?: number | string;
@@ -780,6 +795,8 @@ export interface ASliderAttributes extends BaseAttributes {
     round?: boolean | number | string;
     /** `jump` moves to a pressed rail position. Omit for relative dragging. */
     'track-click'?: 'jump';
+    /** Fill the rail outside the selected value or range. Presence-based. */
+    inverted?: boolean | '';
     /** `inline`, `thumb`, or `none`; omit for a value at the label row's end. */
     'value-display'?: 'inline' | 'thumb' | 'none';
     /** Text inserted before the live numeric value. */