@helixui/library 1.1.2 → 2.0.0-next.30

package/dist/base/helix-element.d.ts

@@ -0,0 +1,134 @@
+import { LitElement } from 'lit';
+/**
+ * `HelixElement` extends `LitElement` with shared infrastructure for all HELiX
+ * components: lazy `ElementInternals` access, form lifecycle hook delegation,
+ * and convenience validity getters.
+ *
+ * Form association is opt-in via `static formAssociated = true` on the subclass.
+ * When set, `HelixElement` provides a lazy `_internals` accessor that calls
+ * `attachInternals()` on first access — eliminating constructor boilerplate.
+ *
+ * Form components should also override the `_onForm*` hook methods rather than
+ * re-declaring the raw browser callbacks (`formResetCallback`, etc.).
+ *
+ * @example Non-form component — no configuration required:
+ * ```ts
+ * class HxCard extends HelixElement {
+ *   // no formAssociated needed
+ * }
+ * ```
+ *
+ * @example Form-associated component:
+ * ```ts
+ * class HxTextInput extends HelixElement {
+ *   static override formAssociated = true;
+ *
+ *   override _onFormReset(): void {
+ *     this.value = '';
+ *     this._internals.setFormValue('');
+ *   }
+ *
+ *   override _onFormDisabled(disabled: boolean): void {
+ *     this.disabled = disabled;
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare class HelixElement extends LitElement {
+    #private;
+    /**
+     * Set to `true` on the subclass to enable ElementInternals form association.
+     *
+     * IMPORTANT: This MUST be redeclared as `static override formAssociated = true`
+     * on each form-associated subclass. The browser's form association mechanism
+     * inspects `formAssociated` on the *registered* custom element class, not
+     * on ancestor classes.
+     *
+     * @internal
+     */
+    static formAssociated: boolean;
+    /**
+     * Lazy accessor for `ElementInternals`. Calls `attachInternals()` on first
+     * access and caches the result.
+     *
+     * Only valid when `static formAssociated = true` is declared on the subclass.
+     * Accessing this on a non-form-associated component throws a descriptive error.
+     *
+     * @throws {Error} If accessed on a component where `formAssociated` is `false`
+     * @internal
+     */
+    get _internals(): ElementInternals;
+    /**
+     * Called by the browser when the element's form-associated disabled state
+     * changes (e.g., a parent `<fieldset disabled>` is toggled).
+     *
+     * Delegates to `_onFormDisabled`. Override that method in subclasses.
+     * @internal
+     */
+    formDisabledCallback(disabled: boolean): void;
+    /**
+     * Called by the browser when the owning form is reset.
+     *
+     * Delegates to `_onFormReset`. Override that method in subclasses.
+     * @internal
+     */
+    formResetCallback(): void;
+    /**
+     * Called by the browser to restore form state (e.g., back/forward cache).
+     *
+     * Delegates to `_onFormStateRestore`. Override that method in subclasses.
+     * @internal
+     */
+    formStateRestoreCallback(state: File | string | FormData | null, mode: 'restore' | 'autocomplete'): void;
+    /**
+     * Override in subclass to react to the element being disabled or enabled
+     * via a parent `<fieldset>`.
+     *
+     * @param _disabled - `true` when the element is being disabled
+     * @internal
+     */
+    protected _onFormDisabled(_disabled: boolean): void;
+    /**
+     * Override in subclass to reset component state when the owning form resets.
+     * @internal
+     */
+    protected _onFormReset(): void;
+    /**
+     * Override in subclass to restore component state from saved form state.
+     *
+     * @param _state - The saved state value, or `null` if none
+     * @param _mode - `'restore'` for bfcache navigation, `'autocomplete'` for autofill
+     * @internal
+     */
+    protected _onFormStateRestore(_state: File | string | FormData | null, _mode: 'restore' | 'autocomplete'): void;
+    /**
+     * The associated form element, or `null` if not form-associated or not yet
+     * connected to a form.
+     *
+     * Form-associated subclasses that need a guaranteed non-null return type
+     * should redeclare this getter and delegate to `this._internals.form`.
+     *
+     * @internal
+     */
+    get form(): HTMLFormElement | null;
+    /**
+     * The current `ValidityState` for this element, or `null` if not
+     * form-associated.
+     *
+     * Form-associated subclasses that need a guaranteed `ValidityState` return
+     * should redeclare this getter and delegate to `this._internals.validity`.
+     *
+     * @internal
+     */
+    get validity(): ValidityState | null;
+    /**
+     * The current validation message, or an empty string if not form-associated
+     * or if the element is valid.
+     *
+     * @internal
+     */
+    get validationMessage(): string;
+}
+//# sourceMappingURL=helix-element.d.ts.map

package/dist/base/helix-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-element.d.ts","sourceRoot":"","sources":["../../src/base/helix-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,YAAa,SAAQ,UAAU;;IAC1C;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,UAAS;IAI9B;;;;;;;;;OASG;IACH,IAAI,UAAU,IAAI,gBAAgB,CAcjC;IAID;;;;;;OAMG;IACH,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI7C;;;;;OAKG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;;OAKG;IACH,wBAAwB,CACtB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EACtC,IAAI,EAAE,SAAS,GAAG,cAAc,GAC/B,IAAI;IAMP;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAEnD;;;OAGG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAE9B;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAC3B,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EACvC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAIP;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAMjC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ,IAAI,aAAa,GAAG,IAAI,CAMnC;IAED;;;;;OAKG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAM9B;CACF"}

package/dist/base/id-counter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Module-level monotonic ID counter factory.
+ *
+ * Provides collision-free, deterministic, SSR-safe IDs for components that
+ * need stable element IDs (for ARIA relationships, label associations, etc.)
+ * without relying on Math.random() which causes hydration mismatches.
+ *
+ * @public
+ */
+/**
+ * Creates a monotonic ID generator for the given namespace.
+ *
+ * @param namespace - Component namespace (e.g. 'hx-text-input')
+ * @returns A function that returns the next unique ID string
+ * @public
+ *
+ * @example
+ * ```ts
+ * const nextId = createIdCounter('hx-text-input');
+ * private _id = nextId(); // 'hx-text-input-0', 'hx-text-input-1', ...
+ * ```
+ */
+export declare function createIdCounter(namespace: string): () => string;
+/**
+ * Resets the counter for the given namespace (or all namespaces if omitted).
+ * Use in test `beforeEach()` for counter isolation between tests.
+ *
+ * @param namespace - Optional namespace to reset. If omitted, resets all counters.
+ * @public
+ */
+export declare function resetIdCounter(namespace?: string): void;
+//# sourceMappingURL=id-counter.d.ts.map

package/dist/base/id-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-counter.d.ts","sourceRoot":"","sources":["../../src/base/id-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,MAAM,CAM/D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAMvD"}

package/dist/base/index.d.ts

@@ -0,0 +1,4 @@
+export { HelixElement } from './helix-element.js';
+export { createIdCounter, resetIdCounter } from './id-counter.js';
+export { mergeTokenStyles } from './styles.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/base/styles.d.ts

@@ -0,0 +1,19 @@
+import { CSSResultOrNative } from 'lit';
+/**
+ * Merges token CSS custom properties into component styles.
+ *
+ * Accepts either a single style or an array for each argument and returns
+ * a flat merged array suitable for use as `static override styles`.
+ *
+ * @param componentStyles - The component's own styles
+ * @param tokenStyles - Additional token CSS to merge in (e.g. `tokenStyles` from `@helixui/tokens/lit`)
+ * @returns Merged styles array
+ * @public
+ *
+ * @example
+ * ```ts
+ * static override styles = mergeTokenStyles(helixButtonStyles, tokenStyles);
+ * ```
+ */
+export declare function mergeTokenStyles(componentStyles: CSSResultOrNative | CSSResultOrNative[], tokenStyles: CSSResultOrNative | CSSResultOrNative[]): CSSResultOrNative[];
+//# sourceMappingURL=styles.d.ts.map

package/dist/base/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/base/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,KAAK,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,EACxD,WAAW,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GACnD,iBAAiB,EAAE,CAIrB"}

package/dist/components/hx-accordion/hx-accordion-item.d.ts

@@ -53,6 +53,9 @@ export declare class HelixAccordionItem extends LitElement {
      * @attr level
      */
     level: 1 | 2 | 3 | 4 | 5 | 6;
+    connectedCallback(): void;
+    /** @internal */
+    private _handleTriggerSlotChange;
     /**
      * Returns a clamped heading level (1–6) for use as `aria-level` on the
      * `<summary>` element. Per the WAI-ARIA APG Accordion pattern, the

package/dist/components/hx-accordion/hx-accordion-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-accordion-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-accordion/hx-accordion-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AAuBrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,kBAAmB,SAAQ,UAAU;IAChD,OAAgB,MAAM,4BAA2C;IAEjE,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAK;IAC5B,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAwD;IAEpE;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;OAKG;IAEH,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAK;IAIjC;;;;;;;OAOG;IACH,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAExB;IAID,gBAAgB;IAChB,OAAO,CAAC,OAAO;IASf,gBAAgB;IAChB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAiB7C,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAK3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IASb,MAAM;CA0ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,kBAAkB,CAAC;KACzC;CACF"}
+{"version":3,"file":"hx-accordion-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-accordion/hx-accordion-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AACrD,OAAO,4CAA4C,CAAC;AAuBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,kBAAmB,SAAQ,UAAU;IAChD,OAAgB,MAAM,4BAA8B;IAEpD,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAK;IAC5B,gBAAgB;IAChB,OAAO,CAAC,IAAI,CAAwD;IAEpE;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;;OAKG;IAEH,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAK;IAIxB,iBAAiB,IAAI,IAAI;IAYlC,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAahC;;;;;;;OAOG;IACH,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAExB;IAID,gBAAgB;IAChB,OAAO,CAAC,OAAO;IASf,gBAAgB;IAChB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAiB7C,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAK3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IASb,MAAM;CA0ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,kBAAkB,CAAC;KACzC;CACF"}

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

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { LitElement, PropertyValues } from 'lit';
 /**
  * An accordion container that manages collapsible content sections.
  *
@@ -30,9 +30,12 @@ export declare class HelixAccordion extends LitElement {
      * @attr mode
      */
     mode: 'single' | 'multi';
+    /** @internal */
+    private _mutationObserver;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
+    updated(changedProperties: PropertyValues<this>): void;
     /** @internal */
     private _enforceSingleMode;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"hx-accordion.d.ts","sourceRoot":"","sources":["../../../src/components/hx-accordion/hx-accordion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAIvC,OAAO,wBAAwB,CAAC;AAIhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,cAAe,SAAQ,UAAU;IAC5C,OAAgB,MAAM,4BAAuC;IAE7D;;;;OAIG;IAEH,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAY;IAI3B,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;cAMlB,YAAY,IAAI,IAAI;IAMvC,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAYxB;IAIF;;;OAGG;IACH,OAAO,CAAC,cAAc,CA6CpB;IAEF,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAYpB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAgBhB,MAAM;CAOhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,cAAc,CAAC;KAChC;CACF"}
+{"version":3,"file":"hx-accordion.d.ts","sourceRoot":"","sources":["../../../src/components/hx-accordion/hx-accordion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC5D,OAAO,4CAA4C,CAAC;AAGpD,OAAO,wBAAwB,CAAC;AAIhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,cAAe,SAAQ,UAAU;IAC5C,OAAgB,MAAM,4BAA0B;IAEhD;;;;OAIG;IAEH,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAY;IAIpC,gBAAgB;IAChB,OAAO,CAAC,iBAAiB,CAAiC;IAEjD,iBAAiB,IAAI,IAAI;IAsBzB,oBAAoB,IAAI,IAAI;cAQlB,YAAY,IAAI,IAAI;IAI9B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAmB/D,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAYxB;IAIF;;;OAGG;IACH,OAAO,CAAC,cAAc,CA6CpB;IAEF,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAYpB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAgBhB,MAAM;CAOhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,cAAc,CAAC;KAChC;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as e, a as i } from "../../shared/hx-accordion-D1kFhdeQ.js";
+import { H as e, a as i } from "../../shared/hx-accordion-Cvs-uzZq.js";
 export {
   e as HelixAccordion,
   i as HelixAccordionItem

package/dist/components/hx-action-bar/hx-action-bar.d.ts

@@ -42,7 +42,7 @@ export declare class HelixActionBar extends LitElement {
      * Size of the action bar — propagated as a data attribute to slotted children.
      * @attr hx-size
      */
-    size: ActionBarSize;
+    size: 'sm' | 'md' | 'lg';
     /**
      * Visual variant controlling the bar background.
      * @attr variant

package/dist/components/hx-action-bar/hx-action-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-action-bar.d.ts","sourceRoot":"","sources":["../../../src/components/hx-action-bar/hx-action-bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAOvC,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBACa,cAAe,SAAQ,UAAU;IAC5C,OAAgB,MAAM,4BAAuC;IAE7D;;;OAGG;IAEH,IAAI,EAAE,aAAa,CAAQ;IAE3B;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAa;IAEvD;;;;;;;OAOG;IAEH,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAS;IAE9C;;;;OAIG;IACH,IACI,MAAM,IAAI,OAAO,CAEpB;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAUxB;IACD,gBAAgB;IAChB,OAAO,CAAC,OAAO,CAAS;IAExB;;;;OAIG;IAEH,SAAS,EAAE,MAAM,CAAa;IAE9B,mEAAmE;IACnE,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAA8B;IAErD;OACG;IAEH,OAAO,CAAC,YAAY,CAAS;IAI7B,2EAA2E;IAC3E,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAwBpB;IAEO,iBAAiB,IAAI,IAAI;IAyBzB,YAAY,IAAI,IAAI;IAMpB,oBAAoB,IAAI,IAAI;IAOrC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAcpB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAgC1B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAiB3B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAuBlB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAUhB,MAAM;CA4BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,eAAe,EAAE,cAAc,CAAC;KACjC;CACF"}
+{"version":3,"file":"hx-action-bar.d.ts","sourceRoot":"","sources":["../../../src/components/hx-action-bar/hx-action-bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AACvC,OAAO,4CAA4C,CAAC;AAMpD,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBACa,cAAe,SAAQ,UAAU;IAC5C,OAAgB,MAAM,4BAA0B;IAEhD;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAa;IAEvD;;;;;;;OAOG;IAEH,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAS;IAE9C;;;;OAIG;IACH,IACI,MAAM,IAAI,OAAO,CAEpB;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAUxB;IACD,gBAAgB;IAChB,OAAO,CAAC,OAAO,CAAS;IAExB;;;;OAIG;IAEH,SAAS,EAAE,MAAM,CAAa;IAE9B,mEAAmE;IACnE,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAA8B;IAErD;OACG;IAEH,OAAO,CAAC,YAAY,CAAS;IAI7B,2EAA2E;IAC3E,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAwBpB;IAEO,iBAAiB,IAAI,IAAI;IAyBzB,YAAY,IAAI,IAAI;IAMpB,oBAAoB,IAAI,IAAI;IAOrC,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAcpB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAgC1B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAY3B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAuBlB,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAUhB,MAAM;CA4BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,eAAe,EAAE,cAAc,CAAC;KACjC;CACF"}

package/dist/components/hx-action-bar/index.js

@@ -1,4 +1,4 @@
-import { H as a } from "../../shared/hx-action-bar-D4bulGQP.js";
+import { H as a } from "../../shared/hx-action-bar-B2BNlKQv.js";
 export {
   a as HelixActionBar
 };

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

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { LitElement, PropertyValues } from 'lit';
 /** Alert variant determines visual styling and ARIA semantics. */
 export type AlertVariant = 'info' | 'success' | 'warning' | 'error';
 /**
@@ -45,7 +45,7 @@ export declare class HelixAlert extends LitElement {
      * Visual variant of the alert that determines colors and ARIA semantics.
      * @attr variant
      */
-    variant: AlertVariant;
+    variant: 'info' | 'success' | 'warning' | 'error';
     /**
      * Whether the alert can be dismissed by the user.
      * @attr dismissible
@@ -58,6 +58,11 @@ export declare class HelixAlert extends LitElement {
      * @attr heading
      */
     heading: string;
+    /**
+     * Accessible label for the close button. Override for i18n.
+     * @attr label-close
+     */
+    labelClose: string;
     /**
      * Whether the alert is visible. Add the `open` attribute to show the alert.
      * @attr open
@@ -95,9 +100,9 @@ export declare class HelixAlert extends LitElement {
     private _actionsSlotChangeHandler;
     /** @internal */
     private _titleSlotChangeHandler;
-    /** Returns the default English severity label for the current variant. */
+    /** @internal */
     private _defaultSeverityLabel;
-    /** Returns the effective severity label, using the override if provided. */
+    /** @internal */
     private get _effectiveSeverityLabel();
     /** Returns true when the variant requires assertive announcement. */
     /** @internal */
@@ -112,7 +117,7 @@ export declare class HelixAlert extends LitElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     firstUpdated(): void;
-    protected updated(changedProperties: Map<PropertyKey, unknown>): void;
+    protected updated(changedProperties: PropertyValues<this>): void;
     /** @internal */
     private _renderInfoIcon;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-alert.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAMhD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAmC;IAIzD;;;OAGG;IAEH,OAAO,EAAE,YAAY,CAAU;IAE/B;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;;OAKG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,MAAM,UAAS;IAEf;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAIpC,gBAAgB;IAEhB,OAAO,CAAC,WAAW,CAAS;IAE5B,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAS;IAI1B,gBAAgB;IAChB,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAA6B;IAI5D,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB;IAU7B,4EAA4E;IAC5E,OAAO,KAAK,uBAAuB,GAElC;IAED,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;IAWzB,oBAAoB,IAAI,IAAI;IAY5B,YAAY,IAAI,IAAI;cAoBV,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI;IA6C9E,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAqCb,MAAM;CAuDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,YAAY,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC"}
+{"version":3,"file":"hx-alert.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAKpD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAU;IAE3D;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;;OAKG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IACqC,UAAU,SAAiB;IAEnE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,MAAM,UAAS;IAEf;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;IAEH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAIpC,gBAAgB;IAEhB,OAAO,CAAC,WAAW,CAAS;IAE5B,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAS;IAI1B,gBAAgB;IAChB,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,gBAAgB;IAChB,OAAO,CAAC,uBAAuB,CAA6B;IAI5D,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAU7B,gBAAgB;IAChB,OAAO,KAAK,uBAAuB,GAElC;IAED,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;IAWzB,oBAAoB,IAAI,IAAI;IAY5B,YAAY,IAAI,IAAI;cAoBV,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IA6CzE,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAqCb,MAAM;CAuDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF;AAED,YAAY,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-alert.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAoN5B,CAAC"}
+{"version":3,"file":"hx-alert.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-alert/hx-alert.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAqN5B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as l } from "../../shared/hx-alert-CSxCF2rr.js";
+import { H as l } from "../../shared/hx-alert-CnDlZO6m.js";
 export {
   l as HelixAlert
 };

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

@@ -1 +1 @@
-{"version":3,"file":"hx-avatar.d.ts","sourceRoot":"","sources":["../../../src/components/hx-avatar/hx-avatar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAOrE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAoC;IAE1D;;;OAGG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAEpC;;;;OAIG;IAEH,GAAG,SAAM;IAET;;;;;;OAMG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAE9C;;;OAGG;IAEH,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAEtC;;;OAGG;IAEH,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IAEH,OAAO,CAAC,eAAe,CAAS;IAEhC;;;OAGG;IAEH,OAAO,CAAC,aAAa,CAAS;IAOrB,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkDlE,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAYzB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAqC9B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMvB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAkBlB,MAAM;CA+DhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF"}
+{"version":3,"file":"hx-avatar.d.ts","sourceRoot":"","sources":["../../../src/components/hx-avatar/hx-avatar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAMpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAuB;IAE7C;;;OAGG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAEpC;;;;OAIG;IAEH,GAAG,SAAM;IAET;;;;;;OAMG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAE9C;;;OAGG;IAEH,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAEtC;;;OAGG;IAEH,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IAEH,OAAO,CAAC,eAAe,CAAS;IAEhC;;;OAGG;IAEH,OAAO,CAAC,aAAa,CAAS;IAOrB,UAAU,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkDlE,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAYzB,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAqC9B,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAMvB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAkBlB,MAAM;CA+DhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-avatar.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-avatar/hx-avatar.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBAqH7B,CAAC"}
+{"version":3,"file":"hx-avatar.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-avatar/hx-avatar.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBAsI7B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-avatar-Cun-O99h.js";
+import { H as e } from "../../shared/hx-avatar-C68g1G2e.js";
 export {
   e as HelixAvatar
 };

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

@@ -1 +1 @@
-{"version":3,"file":"hx-badge.d.ts","sourceRoot":"","sources":["../../../src/components/hx-badge/hx-badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAOhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAmC;IAEzD;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAC3E;IAEZ;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,KAAK,UAAS;IAEd;;;OAGG;IAEH,SAAS,UAAS;IAElB;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;OAGG;IAEH,GAAG,SAAM;IAET;;;;;OAKG;IAEH,QAAQ,SAAM;IAEd;;;;OAIG;IAEH,WAAW,SAAY;IAEvB;;;OAGG;IAEH,OAAO,CAAC,eAAe,CAAS;IAIvB,iBAAiB,IAAI,IAAI;IAalC,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAezB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAWrB,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAGxB;IAOD,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAM5C;IAEJ,gBAAgB;IAChB,OAAO,KAAK,qBAAqB,GAEhC;IAIQ,MAAM;CA8ChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC;AAEjC,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC;AAEjC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}
+{"version":3,"file":"hx-badge.d.ts","sourceRoot":"","sources":["../../../src/components/hx-badge/hx-badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAMpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAsB;IAE5C;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAC3E;IAEZ;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,KAAK,UAAS;IAEd;;;OAGG;IAEH,SAAS,UAAS;IAElB;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;OAGG;IAEH,GAAG,SAAM;IAET;;;;;OAKG;IAEH,QAAQ,SAAM;IAEd;;;;OAIG;IAEH,WAAW,SAAY;IAEvB;;;OAGG;IAEH,OAAO,CAAC,eAAe,CAAS;IAIvB,iBAAiB,IAAI,IAAI;IAalC,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAezB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAWrB,gBAAgB;IAChB,OAAO,KAAK,aAAa,GAGxB;IAOD,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAM5C;IAEJ,gBAAgB;IAChB,OAAO,KAAK,qBAAqB,GAEhC;IAIQ,MAAM;CAqDhB;AAED;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC;AAEjC,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC;AAEjC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-badge.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-badge/hx-badge.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBA2K5B,CAAC"}
+{"version":3,"file":"hx-badge.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-badge/hx-badge.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAkL5B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-badge-CsFd2xtw.js";
+import { H as o } from "../../shared/hx-badge-D5vy_5BO.js";
 export {
   o as HelixBadge
 };

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

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { LitElement, PropertyValues } from 'lit';
 /** Banner variant determines visual styling and ARIA semantics. */
 export type BannerVariant = 'info' | 'success' | 'warning' | 'error';
 /** Banner position determines CSS positioning behavior. */
@@ -41,12 +41,12 @@ export declare class HelixBanner extends LitElement {
      * Visual variant of the banner that determines colors and ARIA semantics.
      * @attr variant
      */
-    variant: BannerVariant;
+    variant: 'info' | 'success' | 'warning' | 'error';
     /**
      * CSS positioning behavior. "sticky" keeps the banner in flow; "fixed" pins it to the viewport.
      * @attr position
      */
-    position: BannerPosition;
+    position: 'sticky' | 'fixed';
     /**
      * Whether the banner can be dismissed by the user.
      * @attr dismissible
@@ -74,7 +74,17 @@ export declare class HelixBanner extends LitElement {
      */
     open: boolean;
     /** Accessible label for the dismiss button. Override for localized text. */
-    closeLabel: string;
+    labelClose: string;
+    /**
+     * Override for the severity prefix announced to screen readers (e.g., "Info:", "Error:").
+     * When not set, defaults to the English label matching the current variant.
+     * @attr severity-label
+     */
+    severityLabel: string | undefined;
+    /** Returns the default English severity label for the current variant. */
+    private _defaultSeverityLabel;
+    /** Returns the effective severity label, using the override if provided. */
+    private get _effectiveSeverityLabel();
     /** Returns true when the variant requires assertive announcement. */
     /** @internal */
     private get _isAssertive();
@@ -86,7 +96,7 @@ export declare class HelixBanner extends LitElement {
     /** @internal */
     private get _role();
     connectedCallback(): void;
-    protected updated(changedProperties: Map<PropertyKey, unknown>): void;
+    protected updated(changedProperties: PropertyValues<this>): void;
     /** @internal */
     private _renderInfoIcon;
     /** @internal */

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

@@ -1 +1 @@
-{"version":3,"file":"hx-banner.d.ts","sourceRoot":"","sources":["../../../src/components/hx-banner/hx-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAOhD,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAoC;IAI1D;;;OAGG;IAEH,OAAO,EAAE,aAAa,CAAU;IAEhC;;;OAGG;IAEH,QAAQ,EAAE,cAAc,CAAY;IAEpC;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;OAIG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IAEH,WAAW,SAAM;IAEjB;;;OAGG;IAEH,UAAU,SAAM;IAEhB;;;OAGG;IAEH,IAAI,UAAQ;IAEZ,4EAA4E;IAE5E,UAAU,SAAoB;IAI9B,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;cAWf,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI;IAoB9E,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkBb,MAAM;CA6ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF;AAED,YAAY,EAAE,WAAW,IAAI,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"hx-banner.d.ts","sourceRoot":"","sources":["../../../src/components/hx-banner/hx-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAMpD,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAuB;IAI7C;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAU;IAE3D;;;OAGG;IAEH,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAY;IAExC;;;OAGG;IAEH,WAAW,UAAS;IAEpB;;;;OAIG;IAEH,OAAO,SAAM;IAEb;;;OAGG;IAEH,WAAW,SAAM;IAEjB;;;OAGG;IAEH,UAAU,SAAM;IAEhB;;;OAGG;IAEH,IAAI,UAAQ;IAEZ,4EAA4E;IAE5E,UAAU,SAAoB;IAE9B;;;;OAIG;IAEH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAIlC,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB;IAU7B,4EAA4E;IAC5E,OAAO,KAAK,uBAAuB,GAElC;IAED,qEAAqE;IACrE,gBAAgB;IAChB,OAAO,KAAK,YAAY,GAEvB;IAED;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAIQ,iBAAiB,IAAI,IAAI;cAWf,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAoBzE,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAQvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAQ1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAQxB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAkBb,MAAM;CAkDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF;AAED,YAAY,EAAE,WAAW,IAAI,QAAQ,EAAE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-banner.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-banner/hx-banner.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBAyL7B,CAAC"}
+{"version":3,"file":"hx-banner.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-banner/hx-banner.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,yBA2M7B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as a } from "../../shared/hx-banner-BTV-X2xF.js";
+import { H as a } from "../../shared/hx-banner-Ccif-GaB.js";
 export {
   a as HelixBanner
 };

package/dist/components/hx-breadcrumb/hx-breadcrumb-item.d.ts

@@ -22,6 +22,7 @@ import { LitElement } from 'lit';
  * @cssprop [--hx-breadcrumb-separator-color=var(--hx-color-neutral-400)] - Separator color.
  * @cssprop [--hx-breadcrumb-separator-gap=var(--hx-space-1)] - Horizontal margin around separator.
  * @cssprop [--hx-breadcrumb-item-max-width] - Optional max-width for text truncation.
+ * @cssprop [--hx-breadcrumb-link-focus-ring-color=var(--hx-focus-ring-color, var(--hx-color-primary-500))] - Focus ring color for breadcrumb links.
  */
 export declare class HelixBreadcrumbItem extends LitElement {
     static styles: import('lit').CSSResult[];

package/dist/components/hx-breadcrumb/hx-breadcrumb-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-breadcrumb-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-breadcrumb/hx-breadcrumb-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAKhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,mBAAoB,SAAQ,UAAU;IACjD,OAAgB,MAAM,4BAA4C;IAEzD,iBAAiB,IAAI,IAAI;IAkBlC;;;;;OAKG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;;;OAOG;IAEH,UAAU,UAAS;IAEnB;;;;;;;;;;;;OAYG;IAEH,OAAO,UAAS;IAEP,MAAM;CAkBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,oBAAoB,EAAE,mBAAmB,CAAC;KAC3C;CACF"}
+{"version":3,"file":"hx-breadcrumb-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-breadcrumb/hx-breadcrumb-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAIpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,mBAAoB,SAAQ,UAAU;IACjD,OAAgB,MAAM,4BAA+B;IAE5C,iBAAiB,IAAI,IAAI;IAwBlC;;;;;OAKG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;;;OAOG;IAEH,UAAU,UAAS;IAEnB;;;;;;;;;;;;OAYG;IAEH,OAAO,UAAS;IAEP,MAAM;CAkBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,oBAAoB,EAAE,mBAAmB,CAAC;KAC3C;CACF"}

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

@@ -1,13 +1,37 @@
 import { LitElement, PropertyValues } from 'lit';
-/** Breadcrumb navigation component with automatic truncation and JSON-LD structured data. @tag hx-breadcrumb */
+/**
+ * Hierarchical page path navigation showing current location in site structure.
+ *
+ * @summary Navigation breadcrumb showing the page hierarchy. Works with Drupal's breadcrumb system.
+ *
+ * @tag hx-breadcrumb
+ *
+ * @slot - Default slot for hx-breadcrumb-item children.
+ * @slot separator - Optional separator element. Its text content overrides the `separator` property.
+ *
+ * @csspart nav - The nav landmark element.
+ * @csspart list - The ordered list containing items.
+ *
+ * @cssprop [--hx-breadcrumb-separator-content='/'] - Separator character between items.
+ *   NOTE: If overriding this custom property directly in CSS (rather than via the `separator`
+ *   attribute), the value MUST be quoted: `--hx-breadcrumb-separator-content: ">"`. An unquoted
+ *   value is invalid for the CSS `content` property and will silently render nothing.
+ * @cssprop [--hx-breadcrumb-separator-color=var(--hx-color-neutral-400)] - Separator color.
+ * @cssprop [--hx-breadcrumb-separator-gap=var(--hx-space-1)] - Horizontal gap around separators.
+ * @cssprop [--hx-breadcrumb-font-size=var(--hx-font-size-sm)] - Font size.
+ * @cssprop [--hx-breadcrumb-link-color=var(--hx-color-primary-600)] - Link color.
+ * @cssprop [--hx-breadcrumb-link-hover-color=var(--hx-color-primary-700)] - Link hover color.
+ * @cssprop [--hx-breadcrumb-text-color=var(--hx-color-neutral-700)] - Current page text color.
+ * @cssprop [--hx-breadcrumb-item-max-width] - Max-width for item text truncation (e.g. `12rem`).
+ */
 export declare class HelixBreadcrumb extends LitElement {
     static styles: import('lit').CSSResult[];
     /**
      * Per-instance counter used to generate stable, deterministic IDs for the
      * injected JSON-LD script tags. Deterministic IDs (vs Math.random()) allow
      * SSR frameworks to match server-rendered script tags during hydration.
+     * @internal
      */
-    /** @internal */
     private static _instanceCounter;
     /**
      * The separator character displayed between breadcrumb items.
@@ -26,6 +50,11 @@ export declare class HelixBreadcrumb extends LitElement {
      * @attr max-items
      */
     maxItems: number;
+    /**
+     * Accessible label for the expand ellipsis button. Override for i18n.
+     * @attr label-ellipsis
+     */
+    labelEllipsis: string;
     /**
      * When true, injects a JSON-LD BreadcrumbList structured data script into the document head.
      *
@@ -46,17 +75,17 @@ export declare class HelixBreadcrumb extends LitElement {
     /** @internal */
     private _jsonLdScript;
     /** @internal */
-    private _boundEllipsisClick;
+    private readonly _boundEllipsisClick;
     /** @internal */
-    private _boundEllipsisKeydown;
+    private readonly _boundEllipsisKeydown;
     /**
      * Tracks which items had their `current` attribute set by this component
      * (as opposed to set by a consumer/Drupal template). This lets us re-evaluate
      * positional current-page detection on each slotchange without incorrectly
      * treating a previously component-set `current` attribute as a consumer-set
      * explicit override.
+     * @internal
      */
-    /** @internal */
     private readonly _managedCurrentItems;
     /**
      * Stable per-instance ID used to tag the injected script element so that
@@ -67,11 +96,13 @@ export declare class HelixBreadcrumb extends LitElement {
      *
      * Uses a static counter (not Math.random()) so IDs are deterministic across
      * server and client renders, enabling SSR hydration matching.
+     * @internal
      */
-    /** @internal */
     private readonly _jsonLdId;
-    /** Returns only real breadcrumb items, excluding the managed ellipsis element. */
-    /** @internal */
+    /**
+     * Returns only real breadcrumb items, excluding the managed ellipsis element.
+     * @internal
+     */
     private _getBreadcrumbItems;
     /**
      * Applies aria/state attributes to the item list.
@@ -82,8 +113,8 @@ export declare class HelixBreadcrumb extends LitElement {
      *
      * This separation allows Drupal to control current-page marking without
      * relying on item order.
+     * @internal
      */
-    /** @internal */
     private _applyItemAttributes;
     /** @internal */
     private _handleSlotChange;
@@ -100,13 +131,13 @@ export declare class HelixBreadcrumb extends LitElement {
     /**
      * Expands a collapsed breadcrumb by resetting maxItems to 0.
      * Called by the ellipsis expand button (click or Enter/Space).
+     * @internal
      */
-    /** @internal */
     private _expandBreadcrumb;
     /**
      * JSON-LD ListItem entry with typed fields to avoid Record<string, unknown>.
+     * @internal
      */
-    /** @internal */
     private _buildListItem;
     /** @internal */
     private _updateJsonLd;

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

@@ -1 +1 @@
-{"version":3,"file":"hx-breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/hx-breadcrumb/hx-breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAsC5D,gHAAgH;AAChH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAAwC;IAE9D;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAK;IAEpC;;;OAGG;IAEH,SAAS,SAAO;IAEhB;;;OAGG;IAEH,KAAK,SAAgB;IAErB;;;;;OAKG;IAEH,QAAQ,SAAK;IAEb;;;;;;;;;;;;;OAaG;IAEH,MAAM,UAAS;IAEf,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAwB;IAC7C,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAkC;IACvD,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CAAuC;IAClE,gBAAgB;IAChB,OAAO,CAAC,qBAAqB,CAAuC;IAEpE;;;;;;OAMG;IACH,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0B;IAE/D;;;;;;;;;OASG;IACH,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4D;IAItF,kFAAkF;IAClF,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAU3B;;;;;;;;;OASG;IACH,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAuC5B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAkBzB,gBAAgB;IAChB,OAAO,CAAC,0BAA0B;IAWlC,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAmCtB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAUvB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAM5B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAU9B;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAYtB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IA2BrB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAOZ,iBAAiB,IAAI,IAAI;IAQzB,oBAAoB,IAAI,IAAI;IAO5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwCtD,MAAM;CAchB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,eAAe,EAAE,eAAe,CAAC;KAClC;CACF"}
+{"version":3,"file":"hx-breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/hx-breadcrumb/hx-breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC5D,OAAO,4CAA4C,CAAC;AAYpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAA2B;IAEjD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAK;IAEpC;;;OAGG;IAEH,SAAS,SAAO;IAEhB;;;OAGG;IAEH,KAAK,SAAgB;IAErB;;;;;OAKG;IAEH,QAAQ,SAAK;IAEb;;;OAGG;IACwC,aAAa,SAA+B;IAEvF;;;;;;;;;;;;;OAaG;IAEH,MAAM,UAAS;IAEf,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAwB;IAC7C,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAkC;IACvD,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8C;IAClF,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgD;IAEtF;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0B;IAE/D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4D;IAItF;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;IAuC5B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAkBzB,gBAAgB;IAChB,OAAO,CAAC,0BAA0B;IAWlC,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAmCtB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAUvB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAM5B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAU9B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAYtB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IA2BrB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAOZ,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAO5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwCtD,MAAM;CAchB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,eAAe,EAAE,eAAe,CAAC;KAClC;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as a, a as m } from "../../shared/hx-breadcrumb-item-4IwaLgaO.js";
+import { H as a, a as m } from "../../shared/hx-breadcrumb-item-DhxDZI3r.js";
 export {
   a as HelixBreadcrumb,
   m as HelixBreadcrumbItem