@helixui/library 2.1.2 → 3.0.0-next.65

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

@@ -1,4 +1,5 @@
-import { LitElement, PropertyValues } from 'lit';
+import { PropertyValues } from 'lit';
+import { HelixElement } from '../../base/index.js';
 /**
  * A modal and non-modal dialog component built on the native HTML `<dialog>` element.
  * Provides focus trapping, backdrop interaction, keyboard navigation, and full
@@ -16,6 +17,12 @@ import { LitElement, PropertyValues } from 'lit';
  * @fires {CustomEvent<void>} hx-close - Fired when the dialog closes for any reason.
  * @fires {CustomEvent<void>} hx-cancel - Fired when the dialog is dismissed via Escape key or cancel action.
  *
+ * **Event naming rationale:** hx-dialog intentionally uses `hx-open`/`hx-close`/`hx-cancel`
+ * instead of the `hx-show`/`hx-hide`/`hx-after-show`/`hx-after-hide` pattern used by overlay
+ * components (hx-drawer, hx-popover, hx-tooltip). This aligns with the native `<dialog>`
+ * element's `close` and `cancel` events and communicates that the dialog is a stateful container
+ * (open/closed) rather than a transient visibility toggle (show/hide).
+ *
  * @csspart dialog - The inner container div that holds the dialog content.
  * @csspart backdrop - The non-modal backdrop overlay element.
  * @csspart header - The header region containing the heading and header slot.
@@ -61,7 +68,7 @@ import { LitElement, PropertyValues } from 'lit';
  * ```
  * Focus restoration to the trigger element is handled automatically by the component.
  */
-export declare class HelixDialog extends LitElement {
+export declare class HelixDialog extends HelixElement {
     static styles: import('lit').CSSResult[];
     static get observedAttributes(): string[];
     /** @internal */
@@ -75,9 +82,30 @@ export declare class HelixDialog extends LitElement {
     /** Cached focusable elements — populated on open, cleared on close. */
     /** @internal */
     private _cachedFocusableElements;
-    /** Guards against rapid open/close state changes causing asymmetric scroll lock. */
+    /**
+     * Guards against re-entrant open/close calls within a single async open cycle.
+     *
+     * STATE MANAGEMENT CONTRACT
+     * ─────────────────────────
+     * `this.open` (the Lit property) is the single source of truth for dialog open state.
+     * All native `<dialog>` state changes (`showModal()`, `show()`, `close()`) flow exclusively
+     * from `updated()` → `_openDialog()` / `_closeDialog()`. External callers MUST only set
+     * `this.open`; they must never call native dialog methods directly.
+     *
+     * `_isTransitioning` is set to `true` at the start of `_openDialog()` to prevent a second
+     * open call from running concurrently while the first is awaiting `updateComplete`. It is
+     * cleared synchronously after the async tail completes. A 200 ms fallback timeout ensures
+     * the flag is always released even if `updateComplete` never resolves (e.g. detached DOM).
+     *
+     * `_closeDialog()` does NOT use `_isTransitioning` as a guard — it always runs immediately
+     * to honour a `this.open = false` that arrives during the open async tail. The open async
+     * tail checks `this.open` before touching focus so it can abort cleanly.
+     */
     /** @internal */
     private _isTransitioning;
+    /** Fallback timer that releases `_isTransitioning` if the open async tail never fires. */
+    /** @internal */
+    private _transitionFallbackTimer;
     /** The element that had focus when the dialog opened — restored on close (D1). */
     /** @internal */
     private _triggerElement;
@@ -85,6 +113,8 @@ export declare class HelixDialog extends LitElement {
     /** @internal */
     private _pendingReturnValue;
     /** @internal */
+    private readonly _dialogId;
+    /** @internal */
     private readonly _headingId;
     /** @internal */
     private readonly _descriptionId;
@@ -94,8 +124,10 @@ export declare class HelixDialog extends LitElement {
      */
     open: boolean;
     /**
-     * When true, renders as a modal dialog with a backdrop and focus trap.
-     * When false, renders as a non-modal dialog.
+     * When true, dialog renders as a modal with backdrop and focus trap using the native
+     * `showModal()` API. When false (default), dialog renders as a non-modal overlay using
+     * the native `show()` API. Defaults to false, consistent with HTML boolean attribute
+     * semantics (absent = false, present = true).
      * @attr modal
      */
     modal: boolean;
@@ -142,6 +174,8 @@ export declare class HelixDialog extends LitElement {
      * @param returnValue - Optional return value string stored as `dialog.returnValue`.
      */
     close(returnValue?: string): void;
+    /** Clears the fallback timer that releases `_isTransitioning`. @internal */
+    private _clearTransitionFallback;
     /** @internal */
     private _openDialog;
     /** @internal */
@@ -182,5 +216,10 @@ declare global {
     interface HTMLElementTagNameMap {
         'hx-dialog': HelixDialog;
     }
+    interface HTMLElementEventMap {
+        'hx-open': CustomEvent<void>;
+        'hx-close': CustomEvent<void>;
+        'hx-cancel': CustomEvent<void>;
+    }
 }
 //# sourceMappingURL=hx-dialog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dialog/hx-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAsBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAuB;IAG7C,WAAoB,kBAAkB,IAAI,MAAM,EAAE,CAEjD;IAID,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAuC;IAIxD;OACG;IAEH,OAAO,CAAC,cAAc,CAAS;IAE/B;OACG;IAEH,OAAO,CAAC,cAAc,CAAS;IAE/B,uEAAuE;IACvE,gBAAgB;IAChB,OAAO,CAAC,wBAAwB,CAAqB;IAErD,oFAAoF;IACpF,gBAAgB;IAChB,OAAO,CAAC,gBAAgB,CAAS;IAEjC,kFAAkF;IAClF,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAA4B;IAEnD,kEAAkE;IAClE,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CAAiC;IAI5D,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IACtE,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAI5E;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;;OAIG;IAEH,KAAK,UAAQ;IAEb;;;OAGG;IASH,eAAe,UAAQ;IAEvB;;;OAGG;IAEH,OAAO,SAAM;IAEb;;;;OAIG;IAEH,OAAO,EAAE,QAAQ,GAAG,aAAa,CAAY;IAE7C;;;;;OAKG;IAEH,WAAW,SAAM;IAEjB,0EAA0E;IAE1E,UAAU,SAAkB;IAE5B;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAKQ,wBAAwB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,IAAI;IAOE,YAAY,IAAI,IAAI;IAYpB,oBAAoB,IAAI,IAAI;IAS5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAc/D,uEAAuE;IACvE,IAAI,IAAI,IAAI;IAIZ,8EAA8E;IAC9E,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IASjC,gBAAgB;IAChB,OAAO,CAAC,WAAW;IA0CnB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA0CpB,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAM3B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAQ9B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAapB;IAIF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAoC7B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IA6ClB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAUxB;IAIF,gBAAgB;IAChB,OAAO,CAAC,oBAAoB,CAG1B;IAIF,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CAGzB;IAIF,gBAAgB;IAChB,OAAO,CAAC,OAAO;IAcf,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAK/B,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAO/B,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAqBrB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAQrB,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAa/B,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IASjB,MAAM;CAwBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF"}
+{"version":3,"file":"hx-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dialog/hx-dialog.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-dialog-D4ubstxx.js";
+import { H as e } from "../../shared/hx-dialog-CvIlY0Tc.js";
 export {
   e as HelixDialog
 };

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

@@ -1,4 +1,5 @@
-import { LitElement, PropertyValues } from 'lit';
+import { PropertyValues } from 'lit';
+import { HelixElement } from '../../base/index.js';
 /**
  * A visual separator element for dividing content sections. Supports
  * horizontal and vertical orientations, configurable spacing, and an optional
@@ -19,7 +20,7 @@ import { LitElement, PropertyValues } from 'lit';
  * @cssprop [--hx-divider-label-font-size=var(--hx-font-size-sm)] - Label font size.
  * @cssprop [--hx-divider-label-gap=var(--hx-space-3)] - Gap between lines and label.
  */
-export declare class HelixDivider extends LitElement {
+export declare class HelixDivider extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
      * Orientation of the divider.
@@ -59,6 +60,4 @@ declare global {
 }
 /** Canonical type alias for the hx-divider component. */
 export type HxDivider = HelixDivider;
-/** @deprecated Use {@link HxDivider} instead. The `Wc` prefix was a legacy naming convention. */
-export type WcDivider = HelixDivider;
 //# sourceMappingURL=hx-divider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-divider.d.ts","sourceRoot":"","sources":["../../../src/components/hx-divider/hx-divider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAKpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,MAAM,4BAAwB;IAE9C;;;OAGG;IAEH,WAAW,EAAE,YAAY,GAAG,UAAU,CAAgB;IAEtD;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAE5C;;;;OAIG;IAEH,UAAU,UAAS;IAEnB;;;;OAIG;IAEH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAS;IAE1B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAExB;IAEO,YAAY,CAAC,kBAAkB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAY5D,MAAM;CAuBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF;AAED,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC;AAErC,iGAAiG;AACjG,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC"}
+{"version":3,"file":"hx-divider.d.ts","sourceRoot":"","sources":["../../../src/components/hx-divider/hx-divider.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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,OAAgB,MAAM,4BAAwB;IAE9C;;;OAGG;IAEH,WAAW,EAAE,YAAY,GAAG,UAAU,CAAgB;IAEtD;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAE5C;;;;OAIG;IAEH,UAAU,UAAS;IAEnB;;;;OAIG;IAEH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB;IAEhB,OAAO,CAAC,SAAS,CAAS;IAE1B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IASlB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB,CAExB;IAEO,YAAY,CAAC,kBAAkB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAY5D,MAAM;CAuBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF;AAED,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-divider.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-divider/hx-divider.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,yBAuF9B,CAAC"}
+{"version":3,"file":"hx-divider.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-divider/hx-divider.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,yBA+F9B,CAAC"}

package/dist/components/hx-divider/index.d.ts

@@ -1,3 +1,2 @@
 export { HelixDivider } from './hx-divider.js';
-export type { WcDivider } from './hx-divider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hx-divider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-divider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-divider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as r } from "../../shared/hx-divider-BBtOLHRP.js";
+import { H as r } from "../../shared/hx-divider-DwpOrzMW.js";
 export {
   r as HelixDivider
 };

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

@@ -1,9 +1,33 @@
-import { LitElement, PropertyValues } from 'lit';
+import { PropertyValues } from 'lit';
+import { HelixElement } from '../../base/index.js';
 /**
  * A slide-in drawer panel that can appear from any edge of the viewport.
  * Supports focus trapping, overlay backdrop, keyboard navigation, and full
  * ARIA labelling for enterprise healthcare accessibility requirements.
  *
+ * ## Architecture Note: Native `<dialog>` Migration
+ *
+ * This component currently uses `role="dialog"` + `aria-modal="true"` on a
+ * `<div>` rather than the native `<dialog>` element. This is intentional for
+ * the current release because:
+ *
+ * 1. **SSR compatibility**: Native `<dialog>` requires `showModal()` to activate
+ *    its modal behavior (focus trapping, backdrop, top-layer). This JavaScript
+ *    call is not available during server-side rendering, which is a primary
+ *    consumption pattern for Drupal/Twig templates.
+ *
+ * 2. **Contained mode**: The `contained` property constrains the drawer to a
+ *    positioned parent. Native `<dialog>` in modal mode renders in the top layer
+ *    and cannot be constrained to a parent element.
+ *
+ * 3. **Animation control**: The current CSS transition approach provides precise
+ *    control over slide-in/slide-out animations. Native `<dialog>` `::backdrop`
+ *    animations have inconsistent cross-browser support.
+ *
+ * Migration to native `<dialog>` is tracked as a future enhancement. When browser
+ * support for `CloseWatcher`, `::backdrop` transitions, and declarative dialog
+ * opening stabilizes, this component will be migrated to native semantics.
+ *
  * @summary Slide-in panel overlay from any viewport edge.
  *
  * @tag hx-drawer
@@ -19,6 +43,12 @@ import { LitElement, PropertyValues } from 'lit';
  * @fires {CustomEvent<void>} hx-after-hide - Fired after the drawer close animation completes.
  * @fires {CustomEvent<void>} hx-initial-focus - Fired when initial focus is set inside the drawer. Cancelable to override focus behavior.
  *
+ * **Event naming rationale:** hx-drawer uses the `hx-show`/`hx-hide`/`hx-after-show`/`hx-after-hide`
+ * pattern shared by all overlay components (hx-popover, hx-tooltip, hx-dropdown). This differs from
+ * hx-dialog's `hx-open`/`hx-close`/`hx-cancel` events, which align with native `<dialog>` semantics.
+ * The distinction is intentional: overlays are transient visibility toggles, while dialog is a stateful
+ * container with cancel semantics.
+ *
  * @csspart overlay - The full-screen overlay container (includes backdrop and panel).
  * @csspart panel - The drawer panel itself.
  * @csspart header - The header region containing the title and actions.
@@ -42,7 +72,7 @@ import { LitElement, PropertyValues } from 'lit';
  * @cssprop [--hx-drawer-footer-padding] - Padding inside the footer.
  * @cssprop [--hx-drawer-footer-border-color=var(--hx-color-neutral-200)] - Footer border color.
  */
-export declare class HelixDrawer extends LitElement {
+export declare class HelixDrawer extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
      * Reference to the overlay element that wraps the backdrop and panel.
@@ -200,5 +230,12 @@ declare global {
     interface HTMLElementTagNameMap {
         'hx-drawer': HelixDrawer;
     }
+    interface HTMLElementEventMap {
+        'hx-show': CustomEvent<void>;
+        'hx-after-show': CustomEvent<void>;
+        'hx-hide': CustomEvent<void>;
+        'hx-after-hide': CustomEvent<void>;
+        'hx-initial-focus': CustomEvent<void>;
+    }
 }
 //# sourceMappingURL=hx-drawer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-drawer.d.ts","sourceRoot":"","sources":["../../../src/components/hx-drawer/hx-drawer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAgCpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAuB;IAI7C;;;OAGG;IAEH,OAAO,CAAC,UAAU,CAAiC;IAEnD;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAAiC;IAIjD;;;OAGG;IAEH,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;IAEH,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;OAGG;IAEH,OAAO,CAAC,cAAc,CAAS;IAE/B;;;OAGG;IAEH,OAAO,CAAC,aAAa,CAAS;IAE9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB,CAAqB;IACrD;;;OAGG;IACH,OAAO,CAAC,eAAe,CAA4B;IACnD;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAA8C;IACvE,uEAAuE;IACvE,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAAS;IAC/B;;;OAGG;IACH,OAAO,CAAC,0BAA0B,CAAiB;IAEnD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IAItE;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAS;IAEtD;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAQ;IAE3E;;;;OAIG;IAEH,SAAS,UAAS;IAElB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,KAAK,SAAM;IAEX,mFAAmF;IAEnF,UAAU,SAAkB;IAInB,iBAAiB,IAAI,IAAI;IAWzB,oBAAoB,IAAI,IAAI;IAS5B,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB/D,wBAAwB;IACxB,IAAI,IAAI,IAAI;IAIZ,yBAAyB;IACzB,IAAI,IAAI,IAAI;IAMZ,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAOrB,gBAAgB;IAChB,OAAO,CAAC,eAAe;IASvB,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAM1B,gBAAgB;IAChB,OAAO,CAAC,WAAW;IA0CnB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IA6BpB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAQ7B,gBAAgB;IAChB,OAAO,CAAC,gCAAgC;IAuBxC,gBAAgB;IAChB,OAAO,CAAC,kCAAkC;IAS1C,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAIrB,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAMxB;;;OAGG;IACH,OAAO,CAAC,cAAc,CAYpB;IAIF,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAkBxB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IA0B7B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAmClB;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAMzB;IAIF,gBAAgB;IAChB,OAAO,CAAC,8BAA8B;IAKtC,gBAAgB;IAChB,OAAO,CAAC,uBAAuB;IAK/B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAO9B,gBAAgB;IAChB,OAAO,CAAC,aAAa;IA8DrB,gBAAgB;IAChB,OAAO,CAAC,aAAa;IAYZ,MAAM;CAiChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,WAAW,CAAC;KAC1B;CACF"}
+{"version":3,"file":"hx-drawer.d.ts","sourceRoot":"","sources":["../../../src/components/hx-drawer/hx-drawer.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -1,4 +1,4 @@
-import { H as a } from "../../shared/hx-drawer--WDLuWtS.js";
+import { H as a } from "../../shared/hx-drawer-Cx2ZJhBe.js";
 export {
   a as HelixDrawer
 };

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

@@ -1,4 +1,5 @@
-import { LitElement, PropertyValues } from 'lit';
+import { PropertyValues } from 'lit';
+import { HelixElement } from '../../base/index.js';
 export type DropdownPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'start' | 'end';
 /**
  * A dropdown component — a button that opens a floating panel on click.
@@ -35,7 +36,7 @@ export type DropdownPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bo
  * </hx-dropdown>
  * ```
  */
-export declare class HelixDropdown extends LitElement {
+export declare class HelixDropdown extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
      * Whether the dropdown panel is open.
@@ -73,11 +74,6 @@ export declare class HelixDropdown extends LitElement {
      * @internal
      */
     private _documentListenerAttached;
-    /**
-     * Monotonically incrementing counter used to generate unique panel IDs across instances.
-     * @internal
-     */
-    private static _instanceCounter;
     /**
      * Unique ID assigned to the floating panel element, referenced by `aria-controls` on the trigger.
      * @internal
@@ -131,5 +127,13 @@ declare global {
     interface HTMLElementTagNameMap {
         'hx-dropdown': HelixDropdown;
     }
+    interface HTMLElementEventMap {
+        'hx-show': CustomEvent<void>;
+        'hx-hide': CustomEvent<void>;
+        'hx-select': CustomEvent<{
+            value: string | null;
+            label: string;
+        }>;
+    }
 }
 //# sourceMappingURL=hx-dropdown.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dropdown/hx-dropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAapD,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAyB;IAI/C;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAkB;IAE3B;;;OAGG;IACS,KAAK,SAAU;IAE3B;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,SAAK;IAIb;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB,CAAS;IAG1C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAK;IACpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA2D;IAE3E;;;OAGG;IACsB,OAAO,CAAC,MAAM,CAA0B;IACjE;;;OAGG;IACwB,OAAO,CAAC,eAAe,CAA0B;IAInE,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAWrC,gBAAgB;YACF,KAAK;IAwBnB,gBAAgB;IAChB,OAAO,CAAC,KAAK;IAkBb,gBAAgB;YACF,eAAe;IAwB7B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAS3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAepB;IAGF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAkB7B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAkB9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAgB9B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CAKzB;IAEF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAsBhB,MAAM;IA0Bf,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAInB,YAAY,IAAI,IAAI;IAI7B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAkBhB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;CAchE;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,aAAa,EAAE,aAAa,CAAC;KAC9B;CACF"}
+{"version":3,"file":"hx-dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dropdown/hx-dropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAC;AAIV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,OAAgB,MAAM,4BAAyB;IAI/C;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,SAAS,EACL,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,OAAO,GACP,KAAK,CAAkB;IAE3B;;;OAGG;IACS,KAAK,SAAU;IAE3B;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,SAAK;IAIb;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB,CAAS;IAG1C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAgC;IAEhD;;;OAGG;IACsB,OAAO,CAAC,MAAM,CAA0B;IACjE;;;OAGG;IACwB,OAAO,CAAC,eAAe,CAA0B;IAInE,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAWrC,gBAAgB;YACF,KAAK;IAwBnB,gBAAgB;IAChB,OAAO,CAAC,KAAK;IAkBb,gBAAgB;YACF,eAAe;IAyB7B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IAS3B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAepB;IAGF,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAkB7B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAkB9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAgB9B,gBAAgB;IAChB,OAAO,CAAC,mBAAmB,CAKzB;IAEF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAsBhB,MAAM;IA0Bf,gBAAgB;IAChB,OAAO,CAAC,kBAAkB;IAc1B,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAInB,YAAY,IAAI,IAAI;IAI7B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAkBhB,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;CAchE;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,aAAa,EAAE,aAAa,CAAC;KAC9B;IACD,UAAU,mBAAmB;QAC3B,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7B,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7B,WAAW,EAAE,WAAW,CAAC;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnE;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-dropdown.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dropdown/hx-dropdown.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBA8C/B,CAAC"}
+{"version":3,"file":"hx-dropdown.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-dropdown/hx-dropdown.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBAuD/B,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-dropdown-n5-XSmiV.js";
+import { H as e } from "../../shared/hx-dropdown-BjDrPUq5.js";
 export {
   e as HelixDropdown
 };

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

@@ -1,4 +1,5 @@
-import { LitElement, PropertyValues } from 'lit';
+import { PropertyValues } from 'lit';
+import { HelixElement } from '../../base/index.js';
 /**
  * Layout wrapper providing consistent label + input + help text + validation
  * message structure for any form control. Use this when wrapping non-HELiX
@@ -26,7 +27,7 @@ import { LitElement, PropertyValues } from 'lit';
  * @csspart label - The label element.
  * @csspart control - The wrapper around slotted content.
  * @csspart help-text - The help text container.
- * @csspart error-message - The error message container.
+ * @csspart error - The error message container.
  * @csspart required-indicator - The required asterisk span.
  *
  * @cssprop [--hx-field-label-color=var(--hx-color-neutral-700)] - Label color.
@@ -35,7 +36,7 @@ import { LitElement, PropertyValues } from 'lit';
  * @cssprop [--hx-field-gap=var(--hx-space-1, 0.25rem)] - Gap between field segments.
  * @cssprop [--hx-field-help-text-color=var(--hx-color-neutral-500)] - Help text color.
  */
-export declare class HelixField extends LitElement {
+export declare class HelixField extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
      * The visible label text for the field.

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

@@ -1 +1 @@
-{"version":3,"file":"hx-field.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field/hx-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACrE,OAAO,4CAA4C,CAAC;AAgBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;;OAIG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAIvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAE9C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAI9C;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAA4B;IAEnD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,CAA4B;IAEtC,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAc5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB1D,uFAAuF;IACvF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAazB,qFAAqF;IACrF,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAYvB,kEAAkE;IAClE,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAOhC;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;;;;;;OAaG;IACH,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IA4ClB,MAAM;CAwEhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}
+{"version":3,"file":"hx-field.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field/hx-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAcpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,OAAgB,MAAM,4BAAsB;IAI5C;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,SAAM;IAEd;;;;OAIG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAIvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,sBAAsB;IAK9B,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAO7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAE9C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAI9C;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAA4B;IAEnD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,CAA4B;IAEtC,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAc5B,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB1D,uFAAuF;IACvF,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAazB,qFAAqF;IACrF,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAYvB,kEAAkE;IAClE,gBAAgB;IAChB,OAAO,CAAC,wBAAwB;IAOhC;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;;;;;;OAaG;IACH,gBAAgB;IAChB,OAAO,CAAC,mBAAmB;IA4ClB,MAAM;CAwEhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

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

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

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

@@ -1,4 +1,4 @@
-import { H as l } from "../../shared/hx-field-CwT9tki1.js";
+import { H as l } from "../../shared/hx-field-Dp3qQMut.js";
 export {
   l as HelixField
 };

package/dist/components/hx-field-label/hx-field-label.d.ts

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { HelixElement } from '../../base/index.js';
 /**
  * Standardized label for form fields. Used as a consistent sub-component
  * for hx-field and other form field components.
@@ -40,7 +40,7 @@ import { LitElement } from 'lit';
  * @cssprop [--hx-font-label-line-height=var(--hx-line-height-normal)] - Label line height.
  * @cssprop [--hx-font-label-family=var(--hx-font-family-sans)] - Label font family.
  */
-export declare class HelixFieldLabel extends LitElement {
+export declare class HelixFieldLabel extends HelixElement {
     static styles: import('lit').CSSResult[];
     /**
      * The ID of the associated form control. When set, renders a native

package/dist/components/hx-field-label/hx-field-label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-field-label.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field-label/hx-field-label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAChD,OAAO,4CAA4C,CAAC;AAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAA2B;IAEjD;;;;OAIG;IAEH,GAAG,SAAM;IAET;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAER,MAAM;CAoBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}
+{"version":3,"file":"hx-field-label.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field-label/hx-field-label.ts"],"names":[],"mappings":"AACA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,OAAgB,MAAM,4BAA2B;IAEjD;;;;OAIG;IAEH,GAAG,SAAM;IAET;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAER,MAAM;CAoBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}

package/dist/components/hx-field-label/hx-field-label.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-field-label.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field-label/hx-field-label.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yBAsCjC,CAAC"}
+{"version":3,"file":"hx-field-label.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-field-label/hx-field-label.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,yBAsDjC,CAAC"}

package/dist/components/hx-field-label/index.js

@@ -1,4 +1,4 @@
-import { H as a } from "../../shared/hx-field-label-CcOK9VU3.js";
+import { H as a } from "../../shared/hx-field-label-BC8QViXv.js";
 export {
   a as HelixFieldLabel
 };

package/dist/components/hx-file-upload/hx-file-upload.d.ts

@@ -1,4 +1,20 @@
-import { LitElement, PropertyValues } from 'lit';
+import { PropertyValues } from 'lit';
+import { HelixElement } from '../../base/index.js';
+/** Detail for the hx-upload event dispatched by hx-file-upload. */
+export interface HxFileUploadDetail {
+    files: File[];
+}
+/** Detail for the hx-remove event dispatched by hx-file-upload. */
+export interface HxFileRemoveDetail {
+    file: File;
+    index: number;
+}
+/** Detail for the hx-error event dispatched by hx-file-upload. */
+export interface HxFileErrorDetail {
+    message: string;
+    files: File[];
+}
+declare const HelixFileUpload_base: typeof HelixElement & (new (...args: any[]) => import('../../index.js').FormMixinInterface & import('../../mixins/FormMixin.js').FormMixinProtectedHooks);
 /**
  * A drag-and-drop file upload component with client-side validation,
  * file list management, per-file progress, and native form association.
@@ -28,13 +44,10 @@ import { LitElement, PropertyValues } from 'lit';
  * @cssprop [--hx-file-upload-progress-color=var(--hx-color-primary-500)] - Progress bar fill color.
  * @cssprop [--hx-file-upload-error-color=var(--hx-color-error-500)] - Error state and remove-button hover color.
  */
-export declare class HelixFileUpload extends LitElement {
+export declare class HelixFileUpload extends HelixFileUpload_base {
     static styles: import('lit').CSSResult[];
     /** Marks this element as form-associated for ElementInternals support. @internal */
     static formAssociated: boolean;
-    /** Holds the ElementInternals instance used for form value and validity management. @internal */
-    private _internals;
-    constructor();
     /**
      * The form field name used during form submission.
      * @attr name
@@ -84,6 +97,22 @@ export declare class HelixFileUpload extends LitElement {
     labelDropzone: string;
     /** Accessible label for the selected files list. */
     labelFileList: string;
+    /**
+     * Accessible label for the dropzone when no visible label text is provided.
+     * Falls back to `label-dropzone` prop value, then a default string.
+     *
+     * Accepts both `accessible-label` and the standard `aria-label` HTML attribute.
+     * `accessible-label` takes precedence when both are set.
+     *
+     * @attr accessible-label
+     */
+    accessibleLabel: string;
+    /**
+     * Returns the effective label for the dropzone, checking accessible-label first,
+     * then the aria-label attribute, falling back to empty string.
+     * @internal
+     */
+    private get _effectiveLabel();
     /**
      * Generates upload progress description for screen readers.
      * @param name - file name
@@ -116,22 +145,12 @@ export declare class HelixFileUpload extends LitElement {
     /** @internal */
     private _handleFileListSlotChange;
     updated(changedProperties: PropertyValues<this>): void;
-    /** Returns the associated form element, if any. */
-    get form(): HTMLFormElement | null;
-    /** Returns the validation message. */
-    get validationMessage(): string;
-    /** Returns the ValidityState object. */
-    get validity(): ValidityState;
-    /** Checks whether the component satisfies its constraints. */
-    checkValidity(): boolean;
-    /** Reports validity and shows the browser's constraint validation UI. */
-    reportValidity(): boolean;
     /** @internal */
-    formResetCallback(): void;
+    protected _onFormReset(): void;
     /** @internal */
-    formDisabledCallback(disabled: boolean): void;
+    protected _onFormDisabled(disabled: boolean): void;
     /** @internal */
-    formStateRestoreCallback(_state: string | File | FormData, mode: string): void;
+    protected _onFormStateRestore(_state: File | string | FormData | null, _mode: 'restore' | 'autocomplete'): void;
     /** @internal */
     private _syncFormValue;
     /**
@@ -184,4 +203,5 @@ declare global {
         'hx-file-upload': HelixFileUpload;
     }
 }
+export {};
 //# sourceMappingURL=hx-file-upload.d.ts.map

package/dist/components/hx-file-upload/hx-file-upload.d.ts.map

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

package/dist/components/hx-file-upload/hx-file-upload.styles.d.ts.map

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

package/dist/components/hx-file-upload/index.d.ts

@@ -1,2 +1,3 @@
 export { HelixFileUpload } from './hx-file-upload.js';
+export type { HxFileUploadDetail, HxFileRemoveDetail, HxFileErrorDetail, } from './hx-file-upload.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hx-file-upload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-file-upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-file-upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/components/hx-file-upload/index.js

@@ -1,4 +1,4 @@
-import { H as o } from "../../shared/hx-file-upload-Dwtu3WcB.js";
+import { H as o } from "../../shared/hx-file-upload-B6Yl1u0i.js";
 export {
   o as HelixFileUpload
 };

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

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { HelixElement } from '../../base/index.js';
 /**
  * A Light DOM form wrapper that styles native HTML form elements and
  * hx-* components with the design system's form styles.
@@ -24,7 +24,7 @@ import { LitElement } from 'lit';
  * @cssprop [--hx-form-max-width=none] - Maximum width of the form.
  * @cssprop [--hx-form-padding=0] - Internal padding of the form.
  */
-export declare class HelixForm extends LitElement {
+export declare class HelixForm extends HelixElement {
     createRenderRoot(): HTMLElement;
     /**
      * Controller that injects scoped CSS into the document via adopted stylesheets for Light DOM styling.

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

@@ -1 +1 @@
-{"version":3,"file":"hx-form.d.ts","sourceRoot":"","sources":["../../../src/components/hx-form/hx-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,SAAU,SAAQ,UAAU;IAG9B,gBAAgB,IAAI,WAAW;IAMxC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAwE;IAIvF;;;OAGG;IAEH,OAAO,CAAC,iBAAiB,CAAgD;IAIhE,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAQrC;;;;OAIG;IAEH,MAAM,SAAM;IAEZ;;;OAGG;IAEH,MAAM,EAAE,KAAK,GAAG,MAAM,CAAU;IAEhC;;;;OAIG;IAEH,UAAU,UAAS;IAEnB;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;;OAIG;IAEH,OAAO,EAAE,mCAAmC,GAAG,qBAAqB,GAAG,YAAY,CAC7C;IAItC;;;OAGG;IACH,aAAa,IAAI,OAAO;IAUxB;;;OAGG;IACH,cAAc,IAAI,OAAO;IAazB;;;OAGG;IACH,WAAW,IAAI,QAAQ;IA8BvB;;;;;;;OAOG;IACH,eAAe,IAAI,WAAW,EAAE;IAQhC;;;OAGG;IACH,qBAAqB,IAAI,KAAK,CAC5B,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,CAC/E;IAQD;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAKjE;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlD;;;OAGG;IACH,WAAW,IAAI,IAAI;IAOnB;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAcrC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,aAAa,CAiEnB;IAEF;;;OAGG;IACH,OAAO,CAAC,YAAY,CAclB;IAEF;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBvB,MAAM;CAqChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}
+{"version":3,"file":"hx-form.d.ts","sourceRoot":"","sources":["../../../src/components/hx-form/hx-form.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,SAAU,SAAQ,YAAY;IAGhC,gBAAgB,IAAI,WAAW;IAMxC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAwE;IAIvF;;;OAGG;IAEH,OAAO,CAAC,iBAAiB,CAAgD;IAIhE,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAQrC;;;;OAIG;IAEH,MAAM,SAAM;IAEZ;;;OAGG;IAEH,MAAM,EAAE,KAAK,GAAG,MAAM,CAAU;IAEhC;;;;OAIG;IAEH,UAAU,UAAS;IAEnB;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;;OAIG;IAEH,OAAO,EAAE,mCAAmC,GAAG,qBAAqB,GAAG,YAAY,CAC7C;IAItC;;;OAGG;IACH,aAAa,IAAI,OAAO;IAUxB;;;OAGG;IACH,cAAc,IAAI,OAAO;IAazB;;;OAGG;IACH,WAAW,IAAI,QAAQ;IA8BvB;;;;;;;OAOG;IACH,eAAe,IAAI,WAAW,EAAE;IAQhC;;;OAGG;IACH,qBAAqB,IAAI,KAAK,CAC5B,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,CAC/E;IAQD;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAKjE;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlD;;;OAGG;IACH,WAAW,IAAI,IAAI;IAOnB;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAcrC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,aAAa,CAiEnB;IAEF;;;OAGG;IACH,OAAO,CAAC,YAAY,CAclB;IAEF;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAqBvB,MAAM;CA+BhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

package/dist/components/hx-form/hx-form.styles.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Scoped CSS for hx-form (applied to light DOM via CSSStyleSheet adoption).
+ *
+ * @media (forced-colors: active) rules are authored directly in
+ * `../../styles/form/form.scoped.css` so they remain co-located with the
+ * selectors they override. See the bottom of that file for the complete
+ * forced-colors block.
+ */
 export declare const helixFormScopedCss: string;
 //# sourceMappingURL=hx-form.styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hx-form.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-form/hx-form.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,QAAgB,CAAC"}
+{"version":3,"file":"hx-form.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-form/hx-form.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAgB,CAAC"}

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

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-form-fJE-FJQV.js";
+import { H as e } from "../../shared/hx-form-ButQFt9A.js";
 export {
   e as HelixForm
 };