@helixui/library 1.1.2 → 2.0.0

package/dist/mixins/FormMixin.d.ts

@@ -0,0 +1,69 @@
+import { HelixElement } from '../base/helix-element.js';
+/**
+ * Constructor type for the mixin pattern.
+ * @internal
+ */
+type Constructor<T = object> = new (...args: any[]) => T;
+/**
+ * The public interface that FormMixin adds to any host element.
+ *
+ * @public
+ */
+export interface FormMixinInterface {
+    /** True after the user has modified the field value at least once. */
+    readonly dirty: boolean;
+    /** True after the field has received and lost focus at least once. */
+    readonly touched: boolean;
+    /** True while the field has never been modified (opposite of dirty). */
+    readonly pristine: boolean;
+    /** Delegates to ElementInternals.checkValidity(). */
+    checkValidity(): boolean;
+    /** Delegates to ElementInternals.reportValidity(). */
+    reportValidity(): boolean;
+    /**
+     * Advance `dirty` state. Call from the native input's `input` event handler.
+     * @internal
+     */
+    _handleInteractionInput(): void;
+    /**
+     * Advance `touched` state. Call from the native input's `blur` event handler.
+     * @internal
+     */
+    _handleInteractionBlur(): void;
+    /**
+     * Reset interaction flags. Call from `_onFormReset()` in the host component.
+     * @internal
+     */
+    _resetInteractionState(): void;
+}
+/**
+ * FormMixin adds shared form infrastructure to any HelixElement subclass:
+ *
+ * - Interaction state tracking: `dirty`, `touched`, `pristine`
+ * - `checkValidity()` / `reportValidity()` delegation to `ElementInternals`
+ * - A `_updateValidity()` lifecycle hook called automatically after every
+ *   `updated()` cycle — subclasses override this to run constraint checks
+ * - `_handleInteractionBlur()` and `_handleInteractionInput()` helpers that
+ *   components wire to their native inputs to advance interaction state
+ *
+ * @example
+ * ```ts
+ * class HxTextInput extends FormMixin(HelixElement) {
+ *   protected override _updateValidity(): void {
+ *     if (this.required && !this.value) {
+ *       this._internals.setValidity({ valueMissing: true }, 'Required', this._inputEl);
+ *     } else {
+ *       this._internals.setValidity({});
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param superClass - A HelixElement-derived constructor to mix into
+ * @returns The mixed class constructor with form interaction state tracking
+ *
+ * @public
+ */
+export declare function FormMixin<TBase extends Constructor<HelixElement>>(superClass: TBase): TBase & Constructor<FormMixinInterface>;
+export {};
+//# sourceMappingURL=FormMixin.d.ts.map

package/dist/mixins/FormMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormMixin.d.ts","sourceRoot":"","sources":["../../src/mixins/FormMixin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;GAGG;AAEH,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,qDAAqD;IACrD,aAAa,IAAI,OAAO,CAAC;IACzB,sDAAsD;IACtD,cAAc,IAAI,OAAO,CAAC;IAE1B;;;OAGG;IACH,uBAAuB,IAAI,IAAI,CAAC;IAEhC;;;OAGG;IACH,sBAAsB,IAAI,IAAI,CAAC;IAE/B;;;OAGG;IACH,sBAAsB,IAAI,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAS,WAAW,CAAC,YAAY,CAAC,EAC/D,UAAU,EAAE,KAAK,GAChB,KAAK,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAmHzC"}

package/dist/mixins/aria-delegation.d.ts

@@ -0,0 +1,97 @@
+import { LitElement } from 'lit';
+/**
+ * All standard ARIA attributes intercepted by this mixin.
+ * Extend as needed, but keep the list minimal.
+ */
+declare const ARIA_ATTRIBUTES: readonly ["aria-activedescendant", "aria-atomic", "aria-autocomplete", "aria-braillelabel", "aria-brailleroledescription", "aria-busy", "aria-checked", "aria-colcount", "aria-colindex", "aria-colindextext", "aria-colspan", "aria-controls", "aria-current", "aria-describedby", "aria-description", "aria-details", "aria-disabled", "aria-errormessage", "aria-expanded", "aria-flowto", "aria-haspopup", "aria-hidden", "aria-invalid", "aria-keyshortcuts", "aria-label", "aria-labelledby", "aria-level", "aria-live", "aria-modal", "aria-multiline", "aria-multiselectable", "aria-orientation", "aria-owns", "aria-placeholder", "aria-posinset", "aria-pressed", "aria-readonly", "aria-relevant", "aria-required", "aria-roledescription", "aria-rowcount", "aria-rowindex", "aria-rowindextext", "aria-rowspan", "aria-selected", "aria-setsize", "aria-sort", "aria-valuemax", "aria-valuemin", "aria-valuenow", "aria-valuetext", "role"];
+/** Union type of all intercepted ARIA attribute names. */
+export type AriaAttribute = (typeof ARIA_ATTRIBUTES)[number];
+type LitElementConstructor = new (...args: any[]) => LitElement;
+/**
+ * The public interface added to any class by `mixinDelegatesAria`.
+ * JS property accessors for all intercepted ARIA attributes, reading from
+ * `data-aria-*` storage rather than `aria-*` attributes on the host.
+ */
+export interface AriadDelegationMixinInterface {
+    ariaActiveDescendant: string | null;
+    ariaAtomic: string | null;
+    ariaAutoComplete: string | null;
+    ariaBrailleLabel: string | null;
+    ariaBrailleRoleDescription: string | null;
+    ariaBusy: string | null;
+    ariaChecked: string | null;
+    ariaColCount: string | null;
+    ariaColIndex: string | null;
+    ariaColIndexText: string | null;
+    ariaColSpan: string | null;
+    ariaControls: string | null;
+    ariaCurrent: string | null;
+    ariaDescribedBy: string | null;
+    ariaDescription: string | null;
+    ariaDetails: string | null;
+    ariaDisabled: string | null;
+    ariaErrorMessage: string | null;
+    ariaExpanded: string | null;
+    ariaFlowTo: string | null;
+    ariaHasPopup: string | null;
+    ariaHidden: string | null;
+    ariaInvalid: string | null;
+    ariaKeyShortcuts: string | null;
+    ariaLabel: string | null;
+    ariaLabelledBy: string | null;
+    ariaLevel: string | null;
+    ariaLive: string | null;
+    ariaModal: string | null;
+    ariaMultiLine: string | null;
+    ariaMultiSelectable: string | null;
+    ariaOrientation: string | null;
+    ariaOwns: string | null;
+    ariaPlaceholder: string | null;
+    ariaPosInSet: string | null;
+    ariaPressed: string | null;
+    ariaReadOnly: string | null;
+    ariaRelevant: string | null;
+    ariaRequired: string | null;
+    ariaRoleDescription: string | null;
+    ariaRowCount: string | null;
+    ariaRowIndex: string | null;
+    ariaRowIndexText: string | null;
+    ariaRowSpan: string | null;
+    ariaSelected: string | null;
+    ariaSetSize: string | null;
+    ariaSort: string | null;
+    ariaValueMax: string | null;
+    ariaValueMin: string | null;
+    ariaValueNow: string | null;
+    ariaValueText: string | null;
+    role: string | null;
+}
+/**
+ * Mixin that delegates ARIA attributes from the host element to data-aria-* storage,
+ * preventing Shadow DOM double-announcement by screen readers.
+ *
+ * When a custom element uses `delegatesFocus: true`, the focus delegate (inner element)
+ * and the host are both in the a11y tree. Setting `aria-label` on the host causes the
+ * label to be announced twice — once for the host, once for the focused inner element.
+ *
+ * This mixin intercepts `attributeChangedCallback` for all ARIA attributes:
+ * - Shifts the value from `aria-*` to `data-aria-*` on the host
+ * - Provides JS property accessors that read from `data-aria-*`
+ * - The host element no longer has `aria-*` attributes visible in the a11y tree
+ * - Components read ARIA values via property accessors and apply them to inner elements
+ *
+ * @example
+ * ```ts
+ * class HxButton extends mixinDelegatesAria(LitElement) {
+ *   render() {
+ *     return html`<button aria-label=${this.ariaLabel ?? nothing}></button>`;
+ *   }
+ * }
+ * ```
+ *
+ * @param Base - A LitElement subclass constructor
+ * @returns A new constructor extending Base with ARIA delegation behaviour
+ */
+export declare function mixinDelegatesAria<T extends LitElementConstructor>(Base: T): T;
+export {};
+//# sourceMappingURL=aria-delegation.d.ts.map

package/dist/mixins/aria-delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-delegation.d.ts","sourceRoot":"","sources":["../../src/mixins/aria-delegation.ts"],"names":[],"mappings":"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"}

package/dist/mixins/index.d.ts

@@ -0,0 +1,5 @@
+export { mixinDelegatesAria } from './aria-delegation.js';
+export type { AriadDelegationMixinInterface, AriaAttribute } from './aria-delegation.js';
+export { FocusMixin } from './FocusMixin.js';
+export type { FocusMixinInterface } from './FocusMixin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mixins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mixins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,6BAA6B,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/shared/FormMixin-Bjvw20G5.js

@@ -0,0 +1,88 @@
+function s(t) {
+  class e extends t {
+    constructor() {
+      super(...arguments), this._dirty = !1, this._touched = !1;
+    }
+    // ─── Public Getters ──────────────────────────────────────────────────────
+    /**
+     * True after the user has modified the field value at least once.
+     * Resets to false on form reset.
+     */
+    get dirty() {
+      return this._dirty;
+    }
+    /**
+     * True after the field has received and lost focus at least once.
+     * Resets to false on form reset.
+     */
+    get touched() {
+      return this._touched;
+    }
+    /**
+     * True while the field has never been modified. Opposite of `dirty`.
+     */
+    get pristine() {
+      return !this._dirty;
+    }
+    // ─── Validity Delegation ─────────────────────────────────────────────────
+    /**
+     * Delegates to `ElementInternals.checkValidity()`.
+     * The host element must have `static formAssociated = true`.
+     */
+    checkValidity() {
+      return this._internals.checkValidity();
+    }
+    /**
+     * Delegates to `ElementInternals.reportValidity()`.
+     * The host element must have `static formAssociated = true`.
+     */
+    reportValidity() {
+      return this._internals.reportValidity();
+    }
+    // ─── Lifecycle ───────────────────────────────────────────────────────────
+    /**
+     * Calls `_updateValidity()` after every Lit update cycle.
+     * @internal
+     */
+    updated(i) {
+      super.updated(i), this._updateValidity();
+    }
+    // ─── Hook Methods ────────────────────────────────────────────────────────
+    /**
+     * Override in the host component to run constraint validation logic.
+     * Called automatically by `updated()`. Use `this._internals.setValidity()`
+     * inside this method.
+     * @internal
+     */
+    _updateValidity() {
+    }
+    // ─── Interaction State Helpers ───────────────────────────────────────────
+    /**
+     * Advance `dirty` state. Call from the native input's `input` event.
+     * @internal
+     */
+    _handleInteractionInput() {
+      this._dirty || (this._dirty = !0, this.requestUpdate());
+    }
+    /**
+     * Advance `touched` state. Call from the native input's `blur` event.
+     * @internal
+     */
+    _handleInteractionBlur() {
+      this._touched || (this._touched = !0, this.requestUpdate());
+    }
+    /**
+     * Reset interaction state to initial values.
+     * Call from `_onFormReset()` in the host component.
+     * @internal
+     */
+    _resetInteractionState() {
+      (this._dirty || this._touched) && (this._dirty = !1, this._touched = !1, this.requestUpdate());
+    }
+  }
+  return e;
+}
+export {
+  s as F
+};
+//# sourceMappingURL=FormMixin-Bjvw20G5.js.map

package/dist/shared/FormMixin-Bjvw20G5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormMixin-Bjvw20G5.js","sources":["../../src/mixins/FormMixin.ts"],"sourcesContent":["import type { PropertyValues } from 'lit';\nimport { HelixElement } from '../base/helix-element.js';\n\n/**\n * Constructor type for the mixin pattern.\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Constructor<T = object> = new (...args: any[]) => T;\n\n/**\n * The public interface that FormMixin adds to any host element.\n *\n * @public\n */\nexport interface FormMixinInterface {\n  /** True after the user has modified the field value at least once. */\n  readonly dirty: boolean;\n  /** True after the field has received and lost focus at least once. */\n  readonly touched: boolean;\n  /** True while the field has never been modified (opposite of dirty). */\n  readonly pristine: boolean;\n\n  /** Delegates to ElementInternals.checkValidity(). */\n  checkValidity(): boolean;\n  /** Delegates to ElementInternals.reportValidity(). */\n  reportValidity(): boolean;\n\n  /**\n   * Advance `dirty` state. Call from the native input's `input` event handler.\n   * @internal\n   */\n  _handleInteractionInput(): void;\n\n  /**\n   * Advance `touched` state. Call from the native input's `blur` event handler.\n   * @internal\n   */\n  _handleInteractionBlur(): void;\n\n  /**\n   * Reset interaction flags. Call from `_onFormReset()` in the host component.\n   * @internal\n   */\n  _resetInteractionState(): void;\n}\n\n/**\n * FormMixin adds shared form infrastructure to any HelixElement subclass:\n *\n * - Interaction state tracking: `dirty`, `touched`, `pristine`\n * - `checkValidity()` / `reportValidity()` delegation to `ElementInternals`\n * - A `_updateValidity()` lifecycle hook called automatically after every\n *   `updated()` cycle — subclasses override this to run constraint checks\n * - `_handleInteractionBlur()` and `_handleInteractionInput()` helpers that\n *   components wire to their native inputs to advance interaction state\n *\n * @example\n * ```ts\n * class HxTextInput extends FormMixin(HelixElement) {\n *   protected override _updateValidity(): void {\n *     if (this.required && !this.value) {\n *       this._internals.setValidity({ valueMissing: true }, 'Required', this._inputEl);\n *     } else {\n *       this._internals.setValidity({});\n *     }\n *   }\n * }\n * ```\n *\n * @param superClass - A HelixElement-derived constructor to mix into\n * @returns The mixed class constructor with form interaction state tracking\n *\n * @public\n */\nexport function FormMixin<TBase extends Constructor<HelixElement>>(\n  superClass: TBase,\n): TBase & Constructor<FormMixinInterface> {\n  class FormMixinClass extends (superClass as Constructor<HelixElement>) {\n    // ─── Interaction State ───────────────────────────────────────────────────\n\n    /** @internal */\n    private _dirty = false;\n\n    /** @internal */\n    private _touched = false;\n\n    // ─── Public Getters ──────────────────────────────────────────────────────\n\n    /**\n     * True after the user has modified the field value at least once.\n     * Resets to false on form reset.\n     */\n    get dirty(): boolean {\n      return this._dirty;\n    }\n\n    /**\n     * True after the field has received and lost focus at least once.\n     * Resets to false on form reset.\n     */\n    get touched(): boolean {\n      return this._touched;\n    }\n\n    /**\n     * True while the field has never been modified. Opposite of `dirty`.\n     */\n    get pristine(): boolean {\n      return !this._dirty;\n    }\n\n    // ─── Validity Delegation ─────────────────────────────────────────────────\n\n    /**\n     * Delegates to `ElementInternals.checkValidity()`.\n     * The host element must have `static formAssociated = true`.\n     */\n    checkValidity(): boolean {\n      return this._internals.checkValidity();\n    }\n\n    /**\n     * Delegates to `ElementInternals.reportValidity()`.\n     * The host element must have `static formAssociated = true`.\n     */\n    reportValidity(): boolean {\n      return this._internals.reportValidity();\n    }\n\n    // ─── Lifecycle ───────────────────────────────────────────────────────────\n\n    /**\n     * Calls `_updateValidity()` after every Lit update cycle.\n     * @internal\n     */\n    override updated(changedProperties: PropertyValues): void {\n      super.updated(changedProperties);\n      this._updateValidity();\n    }\n\n    // ─── Hook Methods ────────────────────────────────────────────────────────\n\n    /**\n     * Override in the host component to run constraint validation logic.\n     * Called automatically by `updated()`. Use `this._internals.setValidity()`\n     * inside this method.\n     * @internal\n     */\n    _updateValidity(): void {\n      // Default: valid. Subclasses override to apply constraints.\n    }\n\n    // ─── Interaction State Helpers ───────────────────────────────────────────\n\n    /**\n     * Advance `dirty` state. Call from the native input's `input` event.\n     * @internal\n     */\n    _handleInteractionInput(): void {\n      if (!this._dirty) {\n        this._dirty = true;\n        this.requestUpdate();\n      }\n    }\n\n    /**\n     * Advance `touched` state. Call from the native input's `blur` event.\n     * @internal\n     */\n    _handleInteractionBlur(): void {\n      if (!this._touched) {\n        this._touched = true;\n        this.requestUpdate();\n      }\n    }\n\n    /**\n     * Reset interaction state to initial values.\n     * Call from `_onFormReset()` in the host component.\n     * @internal\n     */\n    _resetInteractionState(): void {\n      if (this._dirty || this._touched) {\n        this._dirty = false;\n        this._touched = false;\n        this.requestUpdate();\n      }\n    }\n  }\n\n  return FormMixinClass as unknown as TBase & Constructor<FormMixinInterface>;\n}\n"],"names":["FormMixin","superClass","FormMixinClass","changedProperties"],"mappings":"AA2EO,SAASA,EACdC,GACyC;AAAA,EACzC,MAAMC,UAAwBD,EAAyC;AAAA,IAAvE,cAAA;AAAA,YAAA,GAAA,SAAA,GAIE,KAAQ,SAAS,IAGjB,KAAQ,WAAW;AAAA,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQnB,IAAI,QAAiB;AACnB,aAAO,KAAK;AAAA,IACd;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,IAAI,UAAmB;AACrB,aAAO,KAAK;AAAA,IACd;AAAA;AAAA;AAAA;AAAA,IAKA,IAAI,WAAoB;AACtB,aAAO,CAAC,KAAK;AAAA,IACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQA,gBAAyB;AACvB,aAAO,KAAK,WAAW,cAAA;AAAA,IACzB;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,iBAA0B;AACxB,aAAO,KAAK,WAAW,eAAA;AAAA,IACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQS,QAAQE,GAAyC;AACxD,YAAM,QAAQA,CAAiB,GAC/B,KAAK,gBAAA;AAAA,IACP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUA,kBAAwB;AAAA,IAExB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQA,0BAAgC;AAC9B,MAAK,KAAK,WACR,KAAK,SAAS,IACd,KAAK,cAAA;AAAA,IAET;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,yBAA+B;AAC7B,MAAK,KAAK,aACR,KAAK,WAAW,IAChB,KAAK,cAAA;AAAA,IAET;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,yBAA+B;AAC7B,OAAI,KAAK,UAAU,KAAK,cACtB,KAAK,SAAS,IACd,KAAK,WAAW,IAChB,KAAK,cAAA;AAAA,IAET;AAAA,EAAA;AAGF,SAAOD;AACT;"}

package/dist/shared/aria-delegation-CBP9eQ0M.js

@@ -0,0 +1,107 @@
+var d = (e) => {
+  throw TypeError(e);
+};
+var h = (e, a, r) => a.has(e) || d("Cannot " + r);
+var c = (e, a, r) => (h(e, a, "read from private field"), r ? r.call(e) : a.get(e)), b = (e, a, r) => a.has(e) ? d("Cannot add the same private member more than once") : a instanceof WeakSet ? a.add(e) : a.set(e, r);
+const n = [
+  "aria-activedescendant",
+  "aria-atomic",
+  "aria-autocomplete",
+  "aria-braillelabel",
+  "aria-brailleroledescription",
+  "aria-busy",
+  "aria-checked",
+  "aria-colcount",
+  "aria-colindex",
+  "aria-colindextext",
+  "aria-colspan",
+  "aria-controls",
+  "aria-current",
+  "aria-describedby",
+  "aria-description",
+  "aria-details",
+  "aria-disabled",
+  "aria-errormessage",
+  "aria-expanded",
+  "aria-flowto",
+  "aria-haspopup",
+  "aria-hidden",
+  "aria-invalid",
+  "aria-keyshortcuts",
+  "aria-label",
+  "aria-labelledby",
+  "aria-level",
+  "aria-live",
+  "aria-modal",
+  "aria-multiline",
+  "aria-multiselectable",
+  "aria-orientation",
+  "aria-owns",
+  "aria-placeholder",
+  "aria-posinset",
+  "aria-pressed",
+  "aria-readonly",
+  "aria-relevant",
+  "aria-required",
+  "aria-roledescription",
+  "aria-rowcount",
+  "aria-rowindex",
+  "aria-rowindextext",
+  "aria-rowspan",
+  "aria-selected",
+  "aria-setsize",
+  "aria-sort",
+  "aria-valuemax",
+  "aria-valuemin",
+  "aria-valuenow",
+  "aria-valuetext",
+  "role"
+];
+function v(e) {
+  var r;
+  const o = class o extends e {
+    constructor() {
+      super(...arguments);
+      // Per-instance guard: tracks which aria attributes are mid-processing so
+      // that the recursive attributeChangedCallback triggered by our own
+      // removeAttribute(name) call does not erroneously clear data-aria-*.
+      b(this, r, /* @__PURE__ */ new Set());
+    }
+    static get observedAttributes() {
+      const t = Object.getPrototypeOf(o), i = Reflect.get(t, "observedAttributes", this) ?? [], l = n.filter((p) => !i.includes(p));
+      return [...i, ...l];
+    }
+    attributeChangedCallback(t, i, l) {
+      if (n.includes(t)) {
+        if (c(this, r).has(t)) return;
+        l !== null ? this.setAttribute(`data-${t}`, l) : this.removeAttribute(`data-${t}`), c(this, r).add(t), this.hasAttribute(t) && this.removeAttribute(t), c(this, r).delete(t), this.requestUpdate();
+        return;
+      }
+      super.attributeChangedCallback(t, i, l);
+    }
+  };
+  r = new WeakMap();
+  let a = o;
+  for (const s of n) {
+    const u = s === "role" ? "role" : A(s), t = `data-${s}`;
+    Object.defineProperty(a.prototype, u, {
+      get() {
+        return this.getAttribute(t);
+      },
+      set(i) {
+        i == null ? (this.removeAttribute(t), this.removeAttribute(s)) : (this.setAttribute(t, i), this.hasAttribute(s) && this.removeAttribute(s)), this.requestUpdate();
+      },
+      configurable: !0,
+      enumerable: !1
+    });
+  }
+  return a;
+}
+function A(e) {
+  const a = e.replace(/^aria-/, "");
+  return "aria" + a.charAt(0).toUpperCase() + a.slice(1).replace(/-([a-z])/g, (r, o) => o.toUpperCase());
+}
+export {
+  v as m
+};
+//# sourceMappingURL=aria-delegation-CBP9eQ0M.js.map

package/dist/shared/aria-delegation-CBP9eQ0M.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-delegation-CBP9eQ0M.js","sources":["../../src/mixins/aria-delegation.ts"],"sourcesContent":["import type { LitElement } from 'lit';\n\n/**\n * All standard ARIA attributes intercepted by this mixin.\n * Extend as needed, but keep the list minimal.\n */\nconst ARIA_ATTRIBUTES = [\n  'aria-activedescendant',\n  'aria-atomic',\n  'aria-autocomplete',\n  'aria-braillelabel',\n  'aria-brailleroledescription',\n  'aria-busy',\n  'aria-checked',\n  'aria-colcount',\n  'aria-colindex',\n  'aria-colindextext',\n  'aria-colspan',\n  'aria-controls',\n  'aria-current',\n  'aria-describedby',\n  'aria-description',\n  'aria-details',\n  'aria-disabled',\n  'aria-errormessage',\n  'aria-expanded',\n  'aria-flowto',\n  'aria-haspopup',\n  'aria-hidden',\n  'aria-invalid',\n  'aria-keyshortcuts',\n  'aria-label',\n  'aria-labelledby',\n  'aria-level',\n  'aria-live',\n  'aria-modal',\n  'aria-multiline',\n  'aria-multiselectable',\n  'aria-orientation',\n  'aria-owns',\n  'aria-placeholder',\n  'aria-posinset',\n  'aria-pressed',\n  'aria-readonly',\n  'aria-relevant',\n  'aria-required',\n  'aria-roledescription',\n  'aria-rowcount',\n  'aria-rowindex',\n  'aria-rowindextext',\n  'aria-rowspan',\n  'aria-selected',\n  'aria-setsize',\n  'aria-sort',\n  'aria-valuemax',\n  'aria-valuemin',\n  'aria-valuenow',\n  'aria-valuetext',\n  'role',\n] as const;\n\n/** Union type of all intercepted ARIA attribute names. */\nexport type AriaAttribute = (typeof ARIA_ATTRIBUTES)[number];\n\n// TypeScript mixin constraint: constructors must accept `any[]`.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype LitElementConstructor = new (...args: any[]) => LitElement;\n\n/**\n * The public interface added to any class by `mixinDelegatesAria`.\n * JS property accessors for all intercepted ARIA attributes, reading from\n * `data-aria-*` storage rather than `aria-*` attributes on the host.\n */\nexport interface AriadDelegationMixinInterface {\n  ariaActiveDescendant: string | null;\n  ariaAtomic: string | null;\n  ariaAutoComplete: string | null;\n  ariaBrailleLabel: string | null;\n  ariaBrailleRoleDescription: string | null;\n  ariaBusy: string | null;\n  ariaChecked: string | null;\n  ariaColCount: string | null;\n  ariaColIndex: string | null;\n  ariaColIndexText: string | null;\n  ariaColSpan: string | null;\n  ariaControls: string | null;\n  ariaCurrent: string | null;\n  ariaDescribedBy: string | null;\n  ariaDescription: string | null;\n  ariaDetails: string | null;\n  ariaDisabled: string | null;\n  ariaErrorMessage: string | null;\n  ariaExpanded: string | null;\n  ariaFlowTo: string | null;\n  ariaHasPopup: string | null;\n  ariaHidden: string | null;\n  ariaInvalid: string | null;\n  ariaKeyShortcuts: string | null;\n  ariaLabel: string | null;\n  ariaLabelledBy: string | null;\n  ariaLevel: string | null;\n  ariaLive: string | null;\n  ariaModal: string | null;\n  ariaMultiLine: string | null;\n  ariaMultiSelectable: string | null;\n  ariaOrientation: string | null;\n  ariaOwns: string | null;\n  ariaPlaceholder: string | null;\n  ariaPosInSet: string | null;\n  ariaPressed: string | null;\n  ariaReadOnly: string | null;\n  ariaRelevant: string | null;\n  ariaRequired: string | null;\n  ariaRoleDescription: string | null;\n  ariaRowCount: string | null;\n  ariaRowIndex: string | null;\n  ariaRowIndexText: string | null;\n  ariaRowSpan: string | null;\n  ariaSelected: string | null;\n  ariaSetSize: string | null;\n  ariaSort: string | null;\n  ariaValueMax: string | null;\n  ariaValueMin: string | null;\n  ariaValueNow: string | null;\n  ariaValueText: string | null;\n  role: string | null;\n}\n\n/**\n * Mixin that delegates ARIA attributes from the host element to data-aria-* storage,\n * preventing Shadow DOM double-announcement by screen readers.\n *\n * When a custom element uses `delegatesFocus: true`, the focus delegate (inner element)\n * and the host are both in the a11y tree. Setting `aria-label` on the host causes the\n * label to be announced twice — once for the host, once for the focused inner element.\n *\n * This mixin intercepts `attributeChangedCallback` for all ARIA attributes:\n * - Shifts the value from `aria-*` to `data-aria-*` on the host\n * - Provides JS property accessors that read from `data-aria-*`\n * - The host element no longer has `aria-*` attributes visible in the a11y tree\n * - Components read ARIA values via property accessors and apply them to inner elements\n *\n * @example\n * ```ts\n * class HxButton extends mixinDelegatesAria(LitElement) {\n *   render() {\n *     return html`<button aria-label=${this.ariaLabel ?? nothing}></button>`;\n *   }\n * }\n * ```\n *\n * @param Base - A LitElement subclass constructor\n * @returns A new constructor extending Base with ARIA delegation behaviour\n */\nexport function mixinDelegatesAria<T extends LitElementConstructor>(Base: T): T {\n  class AriadDelegationMixin extends Base {\n    // Per-instance guard: tracks which aria attributes are mid-processing so\n    // that the recursive attributeChangedCallback triggered by our own\n    // removeAttribute(name) call does not erroneously clear data-aria-*.\n    #processingAria = new Set<string>();\n\n    static get observedAttributes(): string[] {\n      // Reflect.get with `this` as the receiver passes the concrete subclass\n      // (e.g. HelixButton) through to Lit's ReactiveElement getter, so it\n      // returns @property attribute names for that specific class.\n      // TypeScript cannot infer static members on `T`, so we use Reflect.get\n      // rather than `super.observedAttributes` to avoid TS2339.\n      const parent: object = Object.getPrototypeOf(AriadDelegationMixin);\n      const superAttrs: string[] =\n        (Reflect.get(parent, 'observedAttributes', this) as string[] | undefined) ?? [];\n      // Append any ARIA attributes not already in the list.\n      const ariaAttrs = ARIA_ATTRIBUTES.filter((a) => !superAttrs.includes(a));\n      return [...superAttrs, ...ariaAttrs];\n    }\n\n    attributeChangedCallback(name: string, old: string | null, next: string | null): void {\n      if ((ARIA_ATTRIBUTES as readonly string[]).includes(name)) {\n        // Guard: if we're already processing this attribute, we're in the\n        // recursive callback triggered by our own removeAttribute(name) below.\n        // Do not process it again — that would clear data-aria-* incorrectly.\n        if (this.#processingAria.has(name)) return;\n\n        // Intercept: store as data-aria-*, do not propagate aria-* to the host.\n        if (next !== null) {\n          // data-aria-* is not in observedAttributes — no recursive loop here.\n          this.setAttribute(`data-${name}`, next);\n        } else {\n          this.removeAttribute(`data-${name}`);\n        }\n\n        // Remove the aria-* attribute from the host so it is absent from the\n        // a11y tree and cannot cause double announcements. Guard while doing so.\n        this.#processingAria.add(name);\n        if (this.hasAttribute(name)) {\n          this.removeAttribute(name); // synchronously re-enters attributeChangedCallback; guard catches it\n        }\n        this.#processingAria.delete(name);\n\n        // Trigger Lit update so render() re-reads the delegated value.\n        this.requestUpdate();\n        return;\n      }\n      super.attributeChangedCallback(name, old, next);\n    }\n  }\n\n  // Add JS property accessors for each ARIA attribute, reading from data-aria-*\n  for (const attr of ARIA_ATTRIBUTES) {\n    // Convert 'aria-label' → 'ariaLabel', 'role' → 'role'\n    const propName: string = attr === 'role' ? 'role' : ariaAttrToProp(attr);\n    const dataAttr = `data-${attr}`;\n\n    Object.defineProperty(AriadDelegationMixin.prototype, propName, {\n      get(this: Element): string | null {\n        return this.getAttribute(dataAttr);\n      },\n      set(this: LitElement, value: string | null) {\n        if (value === null || value === undefined) {\n          this.removeAttribute(dataAttr);\n          this.removeAttribute(attr);\n        } else {\n          this.setAttribute(dataAttr, value);\n          // Ensure aria-* is NOT present on the host.\n          if (this.hasAttribute(attr)) {\n            this.removeAttribute(attr);\n          }\n        }\n        // Trigger Lit reactive update.\n        this.requestUpdate();\n      },\n      configurable: true,\n      enumerable: false,\n    });\n  }\n\n  // Cast to T to satisfy the declared return type. The AriadDelegationMixinInterface\n  // instance members are added at runtime via Object.defineProperty above; callers\n  // that need the typed accessors should cast the instance or use the interface directly.\n  return AriadDelegationMixin as unknown as T;\n}\n\n/**\n * Converts 'aria-label' → 'ariaLabel', 'aria-busy' → 'ariaBusy', etc.\n * Removes the 'aria-' prefix, capitalizes the first letter of the remainder,\n * then camelCases any additional hyphen-separated segments.\n */\nfunction ariaAttrToProp(attr: string): string {\n  const rest = attr.replace(/^aria-/, '');\n  return (\n    'aria' +\n    rest.charAt(0).toUpperCase() +\n    rest.slice(1).replace(/-([a-z])/g, (_, c: string) => c.toUpperCase())\n  );\n}\n"],"names":["ARIA_ATTRIBUTES","mixinDelegatesAria","Base","_processingAria","_AriadDelegationMixin","__privateAdd","parent","superAttrs","ariaAttrs","a","name","old","next","__privateGet","AriadDelegationMixin","attr","propName","ariaAttrToProp","dataAttr","value","rest","_","c"],"mappings":";;;;;AAMA,MAAMA,IAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA+FO,SAASC,EAAoDC,GAAY;AApJhF,MAAAC;AAqJE,QAAMC,IAAN,MAAMA,UAA6BF,EAAK;AAAA,IAAxC;AAAA;AAIE;AAAA;AAAA;AAAA,MAAAG,EAAA,MAAAF,uBAAsB,IAAA;AAAA;AAAA,IAEtB,WAAW,qBAA+B;AAMxC,YAAMG,IAAiB,OAAO,eAAeF,CAAoB,GAC3DG,IACH,QAAQ,IAAID,GAAQ,sBAAsB,IAAI,KAA8B,CAAA,GAEzEE,IAAYR,EAAgB,OAAO,CAACS,MAAM,CAACF,EAAW,SAASE,CAAC,CAAC;AACvE,aAAO,CAAC,GAAGF,GAAY,GAAGC,CAAS;AAAA,IACrC;AAAA,IAEA,yBAAyBE,GAAcC,GAAoBC,GAA2B;AACpF,UAAKZ,EAAsC,SAASU,CAAI,GAAG;AAIzD,YAAIG,EAAA,MAAKV,GAAgB,IAAIO,CAAI,EAAG;AAGpC,QAAIE,MAAS,OAEX,KAAK,aAAa,QAAQF,CAAI,IAAIE,CAAI,IAEtC,KAAK,gBAAgB,QAAQF,CAAI,EAAE,GAKrCG,EAAA,MAAKV,GAAgB,IAAIO,CAAI,GACzB,KAAK,aAAaA,CAAI,KACxB,KAAK,gBAAgBA,CAAI,GAE3BG,EAAA,MAAKV,GAAgB,OAAOO,CAAI,GAGhC,KAAK,cAAA;AACL;AAAA,MACF;AACA,YAAM,yBAAyBA,GAAMC,GAAKC,CAAI;AAAA,IAChD;AAAA,EAAA;AA5CA,EAAAT,IAAA;AAJF,MAAMW,IAANV;AAoDA,aAAWW,KAAQf,GAAiB;AAElC,UAAMgB,IAAmBD,MAAS,SAAS,SAASE,EAAeF,CAAI,GACjEG,IAAW,QAAQH,CAAI;AAE7B,WAAO,eAAeD,EAAqB,WAAWE,GAAU;AAAA,MAC9D,MAAkC;AAChC,eAAO,KAAK,aAAaE,CAAQ;AAAA,MACnC;AAAA,MACA,IAAsBC,GAAsB;AAC1C,QAAIA,KAAU,QACZ,KAAK,gBAAgBD,CAAQ,GAC7B,KAAK,gBAAgBH,CAAI,MAEzB,KAAK,aAAaG,GAAUC,CAAK,GAE7B,KAAK,aAAaJ,CAAI,KACxB,KAAK,gBAAgBA,CAAI,IAI7B,KAAK,cAAA;AAAA,MACP;AAAA,MACA,cAAc;AAAA,MACd,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAKA,SAAOD;AACT;AAOA,SAASG,EAAeF,GAAsB;AAC5C,QAAMK,IAAOL,EAAK,QAAQ,UAAU,EAAE;AACtC,SACE,SACAK,EAAK,OAAO,CAAC,EAAE,YAAA,IACfA,EAAK,MAAM,CAAC,EAAE,QAAQ,aAAa,CAACC,GAAGC,MAAcA,EAAE,aAAa;AAExE;"}