@helixui/library 3.3.1 → 3.4.0-next.121

package/dist/components/hx-tabs/hx-tab.d.ts

@@ -1,8 +1,19 @@
+import { PropertyValues } from 'lit';
 import { HelixElement } from '../../base/index.js';
 /**
  * An individual tab button, designed to be used inside an `<hx-tabs>` container.
  * Must be placed in the `tab` named slot of `<hx-tabs>`.
  *
+ * Group 5a host-canonical: `role="tab"` lives on the **host** via
+ * `_internals.role`. The host is the focusable surface (carries the roving
+ * tabindex); the inner `<button>` retains click activation semantics
+ * (Enter/Space and pointer events) but is no longer the AT-announced surface
+ * — its role and ARIA state are stripped on the modern path so the host's
+ * canonical surface wins. `internals.ariaSelected`, `ariaDisabled`, and
+ * `ariaControlsElements` mirror reactive state. The host `aria-label` /
+ * `aria-labelledby` resolved via the shared IDREF mirror name the tab
+ * cross-shadow.
+ *
  * @summary Presentational tab button that activates a corresponding panel.
  *
  * @tag hx-tab
@@ -47,12 +58,44 @@ export declare class HelixTab extends HelixElement {
      */
     disabled: boolean;
     /**
-     * The id of the panel this tab controls. Set by the parent `<hx-tabs>` to establish the
-     * aria-controls relationship on the inner button element (which carries role="tab").
+     * The id of the panel this tab controls. Set by the parent `<hx-tabs>` to
+     * establish the aria-controls relationship via element references on the
+     * host (modern path) or as a string fallback (legacy path).
      * @internal
      */
     controls: string;
+    /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /**
+     * Element reference for the controlled `<hx-tab-panel>` host. Set by the
+     * parent `<hx-tabs>` via `setControlsPanel()` and projected onto
+     * `internals.ariaControlsElements` so cross-shadow controls resolution
+     * works via IDL element references. Falls through to the `controls`
+     * string property on the legacy path.
+     * @internal
+     */
+    private _controlledPanel;
     connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Set by `<hx-tabs>` whenever the tab→panel relationship is recomputed.
+     * Drives `internals.ariaControlsElements` (modern path) so AT walks across
+     * the shadow boundary to the controlled panel by element reference.
+     * @internal
+     */
+    setControlsPanel(panel: Element | null): void;
+    /**
+     * Mirror reactive ARIA state onto ElementInternals on the **host**. The
+     * inner `<button>` no longer carries role/aria-* on the modern path — the
+     * host is the canonical AT-announced surface. The button stays as the
+     * activation surface (Enter/Space/click) but is `tabindex=-1` and
+     * presentational from AT's perspective.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _hasPrefixSlot;
     /** @internal */

package/dist/components/hx-tabs/hx-tab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tab.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,OAAgB,MAAM,4BAA6C;IAInE;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,QAAQ,SAAM;IAIL,iBAAiB,IAAI,IAAI;IASlC,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IACxC,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IAIxC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAkBpB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAK/B,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAOtB,MAAM;CAsBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,QAAQ,EAAE,QAAQ,CAAC;KACpB;CACF"}
+{"version":3,"file":"hx-tab.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,OAAgB,MAAM,4BAA6C;IAInE;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;OAKG;IAEH,QAAQ,SAAM;IAId,gBAAgB;IACP,OAAO,CAAC,kBAAkB,CAAQ;IAE3C,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAEzD;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB,CAAwB;IAIvC,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;IAM5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAY/D;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAK7C;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAmD9B,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IACxC,gBAAgB;IACP,OAAO,CAAC,cAAc,CAAS;IAIxC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAkBpB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAK/B,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAOtB,MAAM;CA6EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,QAAQ,EAAE,QAAQ,CAAC;KACpB;CACF"}

package/dist/components/hx-tabs/hx-tab.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tab.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,yBA2H1B,CAAC"}
+{"version":3,"file":"hx-tab.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tab.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,yBAsI1B,CAAC"}

package/dist/components/hx-tabs/hx-tabs.d.ts

@@ -10,6 +10,16 @@ export interface HxTabChangeDetail {
  * Supports horizontal and vertical orientations, automatic and manual activation modes,
  * and full keyboard navigation per the ARIA Authoring Practices Guide.
  *
+ * Group 5a host-canonical: `role="tablist"` lives on the host via
+ * `_internals.role`. `aria-orientation`, `aria-label`, and consumer
+ * `aria-labelledby` resolve through the host. Per-tab `role="tab"` and
+ * per-panel `role="tabpanel"` likewise live on their respective hosts.
+ *
+ * Activation defaults to **manual** per healthcare patterns — keyboard arrow
+ * keys move focus only; Enter/Space activates. APG explicitly allows both
+ * automatic and manual activation; manual is safer when panels are heavy or
+ * announce changes via live regions.
+ *
  * @summary Tab container that organizes content into selectable panels.
  *
  * @tag hx-tabs
@@ -58,18 +68,30 @@ export declare class HelixTabs extends HelixElement {
      * Controls how keyboard navigation activates tabs.
      * In `automatic` mode, focus also activates the tab.
      * In `manual` mode, focus moves independently; Space or Enter activates.
+     *
+     * Group 5a default: `manual` — safer for healthcare patterns where panel
+     * content may be heavy or announce updates via live regions. APG explicitly
+     * allows both modes; manual avoids disorienting auto-activation when users
+     * scan tabs with arrow keys.
+     *
      * @attr activation
      */
     activation: 'manual' | 'automatic';
     /**
-     * Accessible label for the tablist. Rendered as `aria-label` on the tablist container.
-     * Provide a brief description of what the tabs represent (e.g., "Patient record sections").
+     * Accessible label for the tablist. Drives the host `internals.ariaLabel`.
+     * Provide a brief description of what the tabs represent (e.g., "Patient
+     * record sections"). Consumer `aria-label` / `aria-labelledby` on the host
+     * override this property when present.
      * @attr label
      */
     label: string;
     /** @internal */
     private _activePanel;
     /** @internal */
+    private _supportsIdrefRefs;
+    /** @internal */
+    private _ariaMirror;
+    /** @internal */
     private _cachedTabs;
     /** @internal */
     private _cachedPanels;
@@ -101,6 +123,14 @@ export declare class HelixTabs extends HelixElement {
     disconnectedCallback(): void;
     firstUpdated(): void;
     updated(changedProperties: PropertyValues<this>): void;
+    /**
+     * Mirror tablist semantics onto the host via ElementInternals so consumer-
+     * supplied `aria-label`, `aria-labelledby`, and the `label` property all
+     * reach the announced control. The host carries `role="tablist"` and the
+     * orientation reflects the `orientation` property reactively.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
     /** @internal */
     private _syncTabsAndPanels;
     /** @internal */

package/dist/components/hx-tabs/hx-tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tabs.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AASpE,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA8C;IAIpE,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAiB;IAI5B;;;OAGG;IAEH,WAAW,EAAE,YAAY,GAAG,UAAU,CAAgB;IAEtD;;;;;OAKG;IAEH,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAe;IAEjD;;;;OAIG;IAEH,KAAK,SAAM;IAIX,gBAAgB;IACP,OAAO,CAAC,YAAY,CAAM;IAInC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA2B;IAC9C,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAgC;IACrD,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAiC;IAClD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAuB;IAI5C,WAAoB,kBAAkB,IAAI,MAAM,EAAE,CAEjD;IAEQ,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAqB/F;;;;;OAKG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAK9B;IAED,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAShB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMd,iBAAiB,IAAI,IAAI;IAkBzB,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IA6BpB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAS/D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA6C1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IA6B5B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA2BpB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB,CAStB;IAEF,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IA2B/B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAgBvB;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAiEpB;IAIO,MAAM;CAkBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;IACD,UAAU,mBAAmB;QAC3B,eAAe,EAAE,WAAW,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChE;CACF"}
+{"version":3,"file":"hx-tabs.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tabs/hx-tabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAgBpE,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,OAAgB,MAAM,4BAA8C;IAIpE,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAiB;IAI5B;;;OAGG;IAEH,WAAW,EAAE,YAAY,GAAG,UAAU,CAAgB;IAEtD;;;;;;;;;;;OAWG;IAEH,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAY;IAE9C;;;;;;OAMG;IAEH,KAAK,SAAM;IAIX,gBAAgB;IACP,OAAO,CAAC,YAAY,CAAM;IAEnC,gBAAgB;IACP,OAAO,CAAC,kBAAkB,CAAQ;IAI3C,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAAsC;IAIzD,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA2B;IAC9C,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAgC;IACrD,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAiC;IAClD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAuB;IAI5C,WAAoB,kBAAkB,IAAI,MAAM,EAAE,CAEjD;IAEQ,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAqB/F;;;;;OAKG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAK9B;IAED,gBAAgB;IAChB,OAAO,CAAC,QAAQ;IAShB,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMd,iBAAiB,IAAI,IAAI;IAwBzB,oBAAoB,IAAI,IAAI;IAU5B,YAAY,IAAI,IAAI;IA6BpB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAe/D;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA4C9B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA6D1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IA4B5B,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA2BpB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB,CAStB;IAEF,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IA2B/B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAgBvB;IAEF,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAuEpB;IAIO,MAAM;CAYhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;IACD,UAAU,mBAAmB;QAC3B,eAAe,EAAE,WAAW,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChE;CACF"}

package/dist/components/hx-tabs/index.js

@@ -1,4 +1,4 @@
-import { H as b, a as l, b as s } from "../../shared/hx-tab-panel-DspCrKqo.js";
+import { H as b, a as l, b as s } from "../../shared/hx-tab-panel-BQtBXKLD.js";
 export {
   b as HelixTab,
   l as HelixTabPanel,

package/dist/components/hx-tag/hx-tag.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tag.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tag/hx-tag.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,yBA8J1B,CAAC"}
+{"version":3,"file":"hx-tag.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tag/hx-tag.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,yBAqL1B,CAAC"}

package/dist/components/hx-tag/index.js

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-tag-CNSmdyaK.js";
+import { H as o } from "../../shared/hx-tag-C5aCUpVi.js";
 export {
   o as HelixTag
 };

package/dist/components/hx-theme/hx-theme.d.ts

@@ -50,8 +50,9 @@ export type ThemeName = 'light' | 'dark' | 'high-contrast' | 'auto';
  *
  * @csspart base - The inner slot wrapper element. `display: contents` — no layout effect.
  *
- * @cssprop [--hx-*] - All design tokens for the selected theme are injected
- *   as CSS custom properties on the host element.
+ * Theme-injected CSS custom properties (semantic surface — full token catalog
+ * lives in `@helixui/tokens`; the wildcard `--hx-*` was previously documented
+ * here but the CEM cssProperties[] surface requires explicit names).
  *
  * @example Drupal Twig — wrap a region with a dark theme:
  * ```twig
@@ -76,9 +77,13 @@ export type ThemeName = 'light' | 'dark' | 'high-contrast' | 'auto';
  *   <!-- Clinical dashboard content -->
  * </hx-theme>
  * ```
- * @cssprop [--hx-color-text-primary] - Color.
- * @cssprop [--hx-space-4] - Spacing token.
- * @cssprop [--hx-duration-fast] - Animation duration.
+ * @cssprop [--hx-color-text-primary] - Primary text color (theme-injected).
+ * @cssprop [--hx-color-surface-base] - Base surface background (theme-injected).
+ * @cssprop [--hx-color-border-default] - Default border color (theme-injected).
+ * @cssprop [--hx-space-4] - Spacing token (theme-injected).
+ * @cssprop [--hx-duration-fast] - Animation duration (theme-injected).
+ * @cssprop [--hx-radius-md] - Medium border-radius (theme-injected).
+ * @cssprop [--hx-font-family-body] - Body font family (theme-injected).
  */
 export declare class HelixTheme extends HelixElement {
     static styles: import('lit').CSSResult[];

package/dist/components/hx-theme/hx-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-theme.d.ts","sourceRoot":"","sources":["../../../src/components/hx-theme/hx-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;AA+HpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAsB;IAE5C;;;;;;;OAOG;IAEH,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAW;IAK7D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEH,KAAK,SAAM;IAEX;;;;;;;;;;;OAWG;IAEH,MAAM,EAAE,UAAU,CAAU;IAE5B;;;;;;OAMG;IAEH,OAAO,EAAE,WAAW,CAAiB;IAErC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA+B;IAClD,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAA6B;IAClD,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA8B;IACjD,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAA8B;IACnD,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAA+B;IACnD,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAA6B;IACnD;;;4EAGwE;IACxE,OAAO,CAAC,qBAAqB,CAAuB;IAE3C,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAWjD,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA2B5C,oBAAoB,IAAI,IAAI;IAMrC;;;;OAIG;IACH,IAAI,cAAc,IAAI,OAAO,GAAG,MAAM,GAAG,eAAe,CAMvD;IAED;;;;OAIG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CASxC;IAED,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAcvB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAUzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAQzB,+EAA+E;IAC/E,OAAO,CAAC,kBAAkB;IAS1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAO5B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAgE5B,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAcZ,MAAM;CAQhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,6FAA6F;AAC7F,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC"}
+{"version":3,"file":"hx-theme.d.ts","sourceRoot":"","sources":["../../../src/components/hx-theme/hx-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;AA+HpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAsB;IAE5C;;;;;;;OAOG;IAEH,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAW;IAK7D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEH,KAAK,SAAM;IAEX;;;;;;;;;;;OAWG;IAEH,MAAM,EAAE,UAAU,CAAU;IAE5B;;;;;;OAMG;IAEH,OAAO,EAAE,WAAW,CAAiB;IAErC,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA+B;IAClD,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAA6B;IAClD,gBAAgB;IAChB,OAAO,CAAC,WAAW,CAA8B;IACjD,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAA8B;IACnD,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAA+B;IACnD,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAA6B;IACnD;;;4EAGwE;IACxE,OAAO,CAAC,qBAAqB,CAAuB;IAE3C,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAWjD,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA2B5C,oBAAoB,IAAI,IAAI;IAMrC;;;;OAIG;IACH,IAAI,cAAc,IAAI,OAAO,GAAG,MAAM,GAAG,eAAe,CAMvD;IAED;;;;OAIG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CASxC;IAED,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAcvB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAUzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAQzB,+EAA+E;IAC/E,OAAO,CAAC,kBAAkB;IAS1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAO5B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAgE5B,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAcZ,MAAM;CAQhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,6FAA6F;AAC7F,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC"}

package/dist/components/hx-time-picker/hx-time-picker.d.ts

@@ -85,6 +85,14 @@ export declare class HelixTimePicker extends HelixTimePicker_base {
      * @internal
      */
     static formAssociated: boolean;
+    /**
+     * Test seam: when set to `true` or `false`, overrides the platform
+     * `supportsIdrefElementReferences` probe before `connectedCallback` seeds
+     * `_supportsIdrefRefs`. Production code MUST NOT touch this field. It is a
+     * `static` so the test stub cleanup is global and obvious.
+     * @internal
+     */
+    static __testSupportsIdrefRefsOverride: boolean | null;
     /**
      * The name submitted with the form. Value is always HH:MM (24-hour).
      * @attr name
@@ -135,6 +143,13 @@ export declare class HelixTimePicker extends HelixTimePicker_base {
      * @attr format
      */
     format: '12h' | '24h';
+    /**
+     * Accessible name for screen readers, if different from the visible label.
+     * Uses `accessible-label` attribute instead of `aria-label` to avoid
+     * ARIAMixin shadowing on the host element. Highest-precedence naming source.
+     * @attr accessible-label
+     */
+    accessibleLabel: string | null;
     /**
      * Whether the dropdown listbox is currently open.
      * @internal
@@ -166,10 +181,36 @@ export declare class HelixTimePicker extends HelixTimePicker_base {
      */
     private _hasHelpSlot;
     /**
-     * The ID of the slotted label element, used for aria-labelledby cross-root linking.
+     * Source of the accessible name. Discriminated union avoids string sentinels.
      * @internal
      */
-    private _slottedLabelId;
+    private _labelSource;
+    /**
+     * Flattened, trimmed text content from all label-slot nodes — used to drive
+     * the inner input's `aria-label` on the no-IDL-ref fallback path and to
+     * gate `_hasLabelSlot` per AccName 1.2.
+     * @internal
+     */
+    private _labelSlotText;
+    /**
+     * Whether the platform supports IDL element references on `ElementInternals`.
+     * Drives the cross-shadow naming strategy for the inner `<input>`.
+     * @internal
+     */
+    private _supportsIdrefRefs;
+    /**
+     * Cached invalidity flag derived from `internals.validity.valid`, the
+     * `error` property, and the slotted error content. Drives `aria-invalid`
+     * on the inner input.
+     * @internal
+     */
+    private _invalid;
+    /**
+     * Deferred copy of `error` driven through reactive state so the persistent
+     * live region can re-announce on transitions without direct DOM mutation.
+     * @internal
+     */
+    private _announcedError;
     private readonly _id;
     /**
      * Unique ID for the listbox element, referenced by `aria-controls` on the combobox input.
@@ -186,6 +227,22 @@ export declare class HelixTimePicker extends HelixTimePicker_base {
      * @internal
      */
     private readonly _helpId;
+    /**
+     * Unique ID for the internal `<label>` element, referenced by inner input
+     * `aria-labelledby` when the `label` property names the field.
+     * @internal
+     */
+    private readonly _labelId;
+    /**
+     * Id of the synthesized in-shadow span that mirrors the consumer-resolved
+     * description text. Appended to the inner input's `aria-describedby` so AT
+     * picks the consumer description up through the standard described-by
+     * channel — `aria-description` is intentionally NOT written, because the
+     * W3C AccName algorithm ignores `aria-description` whenever
+     * `aria-describedby` is also present.
+     * @internal
+     */
+    private readonly _consumerDescId;
     /**
      * Reference to the text input element inside the shadow DOM.
      * @internal
@@ -211,6 +268,64 @@ export declare class HelixTimePicker extends HelixTimePicker_base {
      * @internal
      */
     private get _slots();
+    /** Handle for the shared IDREF observer. @internal */
+    private _ariaMirror;
+    /**
+     * Watches assigned `<slot name="help-text">` nodes for in-place text
+     * mutations so help-text effective state stays in sync with consumer
+     * `textContent` writes that don't trigger a `slotchange` event.
+     * @internal
+     */
+    private _helpSlotTextObserver;
+    /**
+     * Watches assigned `<slot name="error">` nodes for in-place text mutations.
+     * @internal
+     */
+    private _errorSlotTextObserver;
+    /**
+     * Dedicated host observer scoped to `aria-describedby` with
+     * `attributeOldValue: true`. Governed by the disconnect-during-strip
+     * discipline.
+     * @internal
+     */
+    private _hostDescribedByObserver;
+    /**
+     * Most recently observed *consumer-supplied* `aria-labelledby` baseline.
+     * Refreshed on every sync. Modern + legacy paths leave the host attribute
+     * in place, so the live attribute IS the cache.
+     * @internal
+     */
+    private _consumerLabelledBy;
+    /** @internal — see `_consumerLabelledBy`. */
+    private _consumerDescribedBy;
+    /**
+     * Direct references to ALL labellable elements projected into
+     * `<slot name="label">`. Aggregating every assigned element preserves
+     * composed labels such as
+     * `<svg slot="label" aria-hidden="true">…</svg><span slot="label">Time</span>`.
+     * The modern path passes the visible subset to
+     * `internals.ariaLabelledByElements`; the fallback path text-flattens every
+     * non-hidden node into `_labelSlotText` per AccName 1.2.
+     * @internal
+     */
+    private _slottedLabelEls;
+    /**
+     * Watches in-place text mutations on the assigned slotted label nodes. The
+     * `slotchange` event covers add/remove/replace; this MO covers
+     * `node.textContent = '…'` updates on an unchanged node (consumer i18n
+     * re-renders) and `aria-hidden` / `hidden` toggles per AccName 1.2 §4.3.10.
+     * @internal
+     */
+    private _labelSlotTextObserver;
+    /**
+     * Watches in-place text mutations on consumer light-DOM elements resolved
+     * from host `aria-labelledby` / `aria-describedby`. Without this, a consumer
+     * keeping the same `<label id="…">` but mutating its `textContent` (e.g.
+     * i18n re-render) would leave the inner input's `aria-label` and
+     * synthesized description span stale indefinitely.
+     * @internal
+     */
+    private _externalRefsObserver;
     /**
      * Closes the listbox when a click is detected outside the component; bound for stable add/removeEventListener calls.
      * @internal
@@ -220,6 +335,99 @@ export declare class HelixTimePicker extends HelixTimePicker_base {
     disconnectedCallback(): void;
     willUpdate(changed: PropertyValues<this>): void;
     updated(changed: PropertyValues<this>): void;
+    firstUpdated(changed: PropertyValues<this>): void;
+    /**
+     * Synchronous slot-state seed. Mirrors the side effects of the three
+     * `_handle*SlotChange` handlers (label / help-text / error) but is driven by
+     * direct `slot.assignedNodes()` reads so we can populate state BEFORE the
+     * microtask `slotchange` events fire after the first render.
+     * @internal
+     */
+    private _seedSlotStateSync;
+    /**
+     * Reads the label slot's assigned nodes and computes the discriminated
+     * naming state. An empty whitespace-only slot does NOT count as a useful
+     * name. Aggregates ALL assigned elements (not just the first); per AccName
+     * 1.2 §4.3.10, `aria-hidden="true"` and `[hidden]` elements contribute zero
+     * to the accessible name (their text is skipped during flattening).
+     * @internal
+     */
+    private _readLabelSlotState;
+    /**
+     * Re-evaluate the help-text slot's "has meaningful content" state from its
+     * current effective text. Mirrors the slotchange-handler logic but is
+     * invocable from the in-place mutation observer so that clearing
+     * `textContent` on the same slotted node flips `_hasHelpSlot` back to
+     * `false`. Uses AccName-aware flatten so descendants carrying
+     * `aria-hidden="true"` or `hidden` do NOT count toward "has meaningful
+     * content".
+     * @internal
+     */
+    private _readHelpSlotStateSync;
+    /**
+     * Re-evaluate the error slot's "has meaningful content" state from its
+     * current effective text. AccName-aware so visibility-suppressed roots /
+     * descendants don't keep the field stuck in error state.
+     * @internal
+     */
+    private _readErrorSlotStateSync;
+    /**
+     * (Re-)installs a `MutationObserver` against the deduped union of
+     * consumer-resolved label/description elements. Watches `characterData`,
+     * `childList`, `subtree`, and aria-hidden/hidden attribute toggles so any
+     * in-place text or visibility mutation triggers a fresh sync.
+     * @internal
+     */
+    private _installExternalRefsObserver;
+    /**
+     * Resolves consumer-supplied label/description IDREFs on the host and writes
+     * the canonical combobox ARIA onto the **inner `<input>`** per W3C APG
+     * editable combobox pattern. The inner input owns `role="combobox"`
+     * (replacing its implicit textbox role) and all combobox state ARIA so AT
+     * sees a single announced + focused surface.
+     *
+     * Cross-shadow naming uses a belt-and-suspenders strategy:
+     *
+     *   1. **Modern path** (`_supportsIdrefRefs === true`): consumer-resolved
+     *      label/description elements are written onto
+     *      `internals.ariaLabelledByElements` / `internals.ariaDescribedByElements`
+     *      on the host. Host-level `aria-labelledby` / `aria-describedby`
+     *      attributes are LEFT IN PLACE so AT walking up the DOM also sees them.
+     *      The text content of the resolved elements is also flattened onto the
+     *      inner input as `aria-label` so AT that does not walk up still
+     *      announces the right name.
+     *
+     *   2. **Legacy fallback** (`_supportsIdrefRefs === false`): the resolved-
+     *      element text is flattened onto the inner input as `aria-label` and
+     *      mirrored into a synthesized in-shadow span pointed at by the inner
+     *      input's `aria-describedby`.
+     *
+     * Writing `aria-labelledby="<light-DOM id>"` directly on the shadow-DOM
+     * inner input is INTENTIONALLY avoided: light-DOM ids do not resolve from
+     * inside a shadow root.
+     * @internal
+     */
+    private _syncHostAriaSemantics;
+    /**
+     * (Re-)installs the help-text slot text/visibility observer.
+     * @internal
+     */
+    private _installHelpSlotTextObserver;
+    /**
+     * (Re-)installs the error slot text/visibility observer.
+     * @internal
+     */
+    private _installErrorSlotTextObserver;
+    /**
+     * (Re-)installs the label slot text/visibility observer over the current
+     * set of slotted label elements.
+     * @internal
+     */
+    private _installLabelSlotTextObserver;
+    /**
+     * Recomputes the discriminated label source. @internal
+     */
+    private _refreshLabelSource;
     /** @internal */
     _updateValidity(): void;
     /** @internal */

package/dist/components/hx-time-picker/hx-time-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-time-picker.d.ts","sourceRoot":"","sources":["../../../src/components/hx-time-picker/hx-time-picker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hx-time-picker.d.ts","sourceRoot":"","sources":["../../../src/components/hx-time-picker/hx-time-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAsLpE,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,qBACa,eAAgB,SAAQ,oBAAuB;IAC1D,OAAgB,MAAM,4BAA8C;IAIpE;;;OAGG;IACH,OAAgB,cAAc,UAAQ;IAEtC;;;;;;OAMG;IACH,MAAM,CAAC,+BAA+B,EAAE,OAAO,GAAG,IAAI,CAAQ;IAI9D;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,GAAG,SAAW;IAEd;;;OAGG;IAEH,GAAG,SAAW;IAEd;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,MAAM,EAAE,KAAK,GAAG,KAAK,CAAS;IAE9B;;;;;OAKG;IAEH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAItC;;;OAGG;IACM,OAAO,CAAC,KAAK,CAAS;IAC/B;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAM;IACnC;;;OAGG;IACM,OAAO,CAAC,kBAAkB,CAAM;IACzC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IACvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IACvC;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IACtC;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAsC;IACnE;;;;;OAKG;IACM,OAAO,CAAC,cAAc,CAAM;IACrC;;;;OAIG;IACM,OAAO,CAAC,kBAAkB,CAAQ;IAC3C;;;;;OAKG;IACM,OAAO,CAAC,QAAQ,CAAS;IAClC;;;;OAIG;IACM,OAAO,CAAC,eAAe,CAAM;IAItC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+B;IAI/D;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAA+B;IAE/C;;;OAGG;IAEH,OAAO,CAAC,UAAU,CAA+B;IAIjD;;;OAGG;IACH,OAAO,CAAC,YAAY,CAA2B;IAC/C;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAM;IAEvB;;;OAGG;IACH,OAAO,KAAK,MAAM,GAOjB;IAID,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAsC;IACzD;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB,CAAiC;IAC9D;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAAiC;IAC/D;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB,CAAiC;IACjE;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB,CAAuB;IAClD,6CAA6C;IAC7C,OAAO,CAAC,oBAAoB,CAAuB;IACnD;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB,CAAiB;IACzC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB,CAAiC;IAC/D;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB,CAAiC;IAI9D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAKlC;IAIO,iBAAiB,IAAI,IAAI;IA4CzB,oBAAoB,IAAI,IAAI;IAiB5B,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAsB/C,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA0B5C,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA2B1D;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CAAC,sBAAsB;IAkM9B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA8BpC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IA8BrC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA+BrC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B,gBAAgB;IACP,eAAe,IAAI,IAAI;IAehC,gBAAgB;cACG,YAAY,IAAI,IAAI;IAQvC,gBAAgB;cACG,mBAAmB,CACpC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAMP,gBAAgB;cACG,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAM3D,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAOpB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAOrB,gBAAgB;IAChB,OAAO,CAAC,2BAA2B;IAMnC,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAUnB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAW9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAO9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAS7B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAYvB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAW1B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAMzB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IA6B1B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAuD3B,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAIhC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAK1B,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAM/B,6CAA6C;IACpC,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAMnC,MAAM;CAkLhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}

package/dist/components/hx-time-picker/hx-time-picker.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-time-picker.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-time-picker/hx-time-picker.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yBAuOjC,CAAC"}
+{"version":3,"file":"hx-time-picker.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-time-picker/hx-time-picker.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yBAkPjC,CAAC"}

package/dist/components/hx-time-picker/index.js

@@ -1,4 +1,4 @@
-import { H as r } from "../../shared/hx-time-picker-BoEIZwzv.js";
+import { H as r } from "../../shared/hx-time-picker-iwCD7rzW.js";
 export {
   r as HelixTimePicker
 };

package/dist/components/hx-toast/hx-toast-stack.d.ts

@@ -13,6 +13,20 @@ export type ToastStackPlacement = 'top-start' | 'top-center' | 'top-end' | 'bott
  * @csspart base - The inner stack container div.
  *
  * @cssprop [--hx-z-index-toast=9000] - Z-index for the fixed stack.
+ *
+ * ─── ARIA scope (group-6 §3.2 / §5.9) ─────────────────────────────────────
+ *
+ * `hx-toast-stack` deliberately has NO `role`, `aria-live`, `aria-atomic`,
+ * or `aria-relevant` on its host or inner container. Each child `hx-toast`
+ * is its own live region (role=alert/status via ElementInternals). Wrapping
+ * those toasts in a second live region (e.g. `role="log"` on the stack)
+ * would create nested live regions, which causes older NVDA/JAWS to
+ * announce every toast TWICE — once for the toast's own role, once for the
+ * surrounding log region.
+ *
+ * The stack is purely a positional/z-index container; it is invisible to
+ * the AT tree. Do NOT add a container role unless this entire architecture
+ * is rewritten so individual toasts no longer carry their own roles.
  */
 export declare class HelixToastStack extends HelixElement {
     static styles: import('lit').CSSResult[];

package/dist/components/hx-toast/hx-toast-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-toast-stack.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast-stack.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB;;;;;;;;;;;;;GAaG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,OAAgB,MAAM,4BAA2B;IAEjD;;;OAGG;IAEH,SAAS,EACL,WAAW,GACX,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,YAAY,CAAgB;IAEhC;;;OAGG;IAEH,UAAU,SAAK;IAEN,MAAM;CAahB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}
+{"version":3,"file":"hx-toast-stack.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast-stack.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,OAAgB,MAAM,4BAA2B;IAEjD;;;OAGG;IAEH,SAAS,EACL,WAAW,GACX,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,YAAY,CAAgB;IAEhC;;;OAGG;IAEH,UAAU,SAAK;IAEN,MAAM;CAahB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}

package/dist/components/hx-toast/hx-toast.d.ts

@@ -97,8 +97,22 @@ export declare class HelixToast extends HelixElement {
     private _timerStartedAt;
     /** @internal */
     private _timerRemaining;
+    connectedCallback(): void;
     updated(changedProperties: PropertyValues<this>): void;
     disconnectedCallback(): void;
+    /**
+     * (group-6 §5.3) WCAG 2.2.3 (Level AA — No Time Limits) audit. When
+     * `duration` is shorter than the role-implied minimum-display-time for the
+     * current variant, surface a developer warning recommending a longer
+     * duration or `duration=0` for persistent toasts. Danger toasts in
+     * particular are safety-critical and routinely need more than 5 seconds
+     * for screen readers to finish reading.
+     *
+     * Fires only in DEV builds (Vite tree-shakes the call in production).
+     *
+     * @internal
+     */
+    private _auditWcag223;
     /** Show the toast. */
     show(): void;
     /** Hide the toast. */
@@ -127,11 +141,16 @@ export declare class HelixToast extends HelixElement {
     private _handleClose;
     /** @internal */
     private _handleActionSlotChange;
-    /** @internal */
+    /**
+     * @internal
+     * Variant→role mapping (harmonized with hx-alert/hx-banner per group-6):
+     * only `danger` is assertive (role=alert); all other variants are polite
+     * (role=status). role implies aria-live, so we do NOT also expose an
+     * `_ariaLive` getter — that path was removed when the inner div stopped
+     * carrying explicit aria-live (§5.1 double-announce mitigation).
+     */
     private get _role();
     /** @internal */
-    private get _ariaLive();
-    /** @internal */
     private _renderSuccessIcon;
     /** @internal */
     private _renderWarningIcon;

package/dist/components/hx-toast/hx-toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-toast.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,qBACa,UAAW,SAAQ,YAAY;IAO1C,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAa;IAE3E;;;OAGG;IAEH,QAAQ,SAAQ;IAEhB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,UAAU,SAA0B;IAIpC,gBAAgB;IACC,OAAO,CAAC,QAAQ,CAAsB;IAEvD,oEAAoE;IAC3D,OAAO,CAAC,iBAAiB,CAAS;IAE3C,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAA8C;IAI5D,0EAA0E;IAC1E,OAAO,KAAK,cAAc,GAIzB;IAED,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAE9C,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAIrC,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAiBtD,oBAAoB,IAAI,IAAI;IAOrC,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAMZ,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAQZ,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAUnB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IASnB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAOzB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAIjB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAsBjB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAMzB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAItB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMvB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIpB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAU/B,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAED,gBAAgB;IAChB,OAAO,KAAK,SAAS,GAEpB;IAMD,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAS1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAS1B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IASzB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IASvB,4FAA4F;IAC5F,OAAO,KAAK,YAAY,GAavB;IAID,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAKtC;IAEF,gBAAgB;IAChB,OAAO,KAAK,cAAc,GAEzB;IAIQ,MAAM;CA6DhB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}
+{"version":3,"file":"hx-toast.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAejF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,qBACa,UAAW,SAAQ,YAAY;IAO1C,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAa;IAE3E;;;OAGG;IAEH,QAAQ,SAAQ;IAEhB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,UAAU,SAA0B;IAIpC,gBAAgB;IACC,OAAO,CAAC,QAAQ,CAAsB;IAEvD,oEAAoE;IAC3D,OAAO,CAAC,iBAAiB,CAAS;IAE3C,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAA8C;IAI5D,0EAA0E;IAC1E,OAAO,KAAK,cAAc,GAIzB;IAED,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAE9C,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAIrC,iBAAiB,IAAI,IAAI;IAsBzB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA0BtD,oBAAoB,IAAI,IAAI;IAKrC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IAarB,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAMZ,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAQZ,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAUnB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IASnB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAOzB,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAMnB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAIjB,gBAAgB;IAChB,OAAO,CAAC,SAAS;IAsBjB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAMzB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAItB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMvB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAIpB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAU/B;;;;;;;OAOG;IACH,OAAO,KAAK,KAAK,GAEhB;IAMD,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAS1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAS1B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IASzB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IASvB,4FAA4F;IAC5F,OAAO,KAAK,YAAY,GAavB;IAID,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAKtC;IAEF,gBAAgB;IAChB,OAAO,KAAK,cAAc,GAEzB;IAYQ,MAAM;CA0DhB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

package/dist/components/hx-toast/index.js

@@ -1,4 +1,4 @@
-import { H as s, a as o, t as e } from "../../shared/toast-factory-YSznocIV.js";
+import { H as s, a as o, t as e } from "../../shared/toast-factory-CL2BzdSB.js";
 export {
   s as HelixToast,
   o as HelixToastStack,

package/dist/components/hx-toast/toast-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-factory.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/toast-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CA6CvD"}
+{"version":3,"file":"toast-factory.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/toast-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AA6BD;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CA4EvD"}