@helixui/library 0.3.4 → 1.0.1

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

@@ -8,7 +8,7 @@ import { LitElement } from 'lit';
  * @tag hx-time-picker
  *
  * @slot label - Custom label content; overrides the rendered label element when used.
- * @slot help - Help text displayed below the field.
+ * @slot help-text - Help text displayed below the field.
  * @slot error - Custom error content; overrides the `error` property.
  *
  * @fires {CustomEvent<{value: string}>} hx-change - Dispatched when the selected time changes. Detail value is HH:MM (24h).
@@ -39,7 +39,15 @@ import { LitElement } from 'lit';
  */
 export declare class HelixTimePicker extends LitElement {
     static styles: import('lit').CSSResult[];
+    /**
+     * Declares this element as form-associated so it participates in native form submission.
+     * @internal
+     */
     static formAssociated: boolean;
+    /**
+     * ElementInternals instance used for form participation and constraint validation.
+     * @internal
+     */
     private readonly _internals;
     constructor();
     /**
@@ -92,22 +100,95 @@ export declare class HelixTimePicker extends LitElement {
      * @attr format
      */
     format: '12h' | '24h';
+    /**
+     * Whether the dropdown listbox is currently open.
+     * @internal
+     */
     private _open;
+    /**
+     * Index of the currently keyboard-active option in the listbox; -1 when none is active.
+     * @internal
+     */
     private _activeIndex;
+    /**
+     * The display string shown in the text input, formatted according to the current `format` property.
+     * @internal
+     */
     private _inputDisplayValue;
+    /**
+     * Whether the label slot has slotted content assigned to it.
+     * @internal
+     */
     private _hasLabelSlot;
+    /**
+     * Whether the error slot has slotted content assigned to it.
+     * @internal
+     */
     private _hasErrorSlot;
+    /**
+     * Whether the help-text slot has slotted content assigned to it.
+     * @internal
+     */
+    private _hasHelpSlot;
+    /**
+     * The ID of the slotted label element, used for aria-labelledby cross-root linking.
+     * @internal
+     */
     private _slottedLabelId;
+    /**
+     * Monotonically incrementing counter used to generate unique element IDs across instances.
+     * @internal
+     */
     private static _instanceCount;
+    /**
+     * Unique ID for this component instance, used as the input element's `id` attribute.
+     * @internal
+     */
     private readonly _id;
+    /**
+     * Unique ID for the listbox element, referenced by `aria-controls` on the combobox input.
+     * @internal
+     */
     private readonly _listboxId;
+    /**
+     * Unique ID for the error message element, referenced by `aria-describedby` on the input.
+     * @internal
+     */
     private readonly _errorId;
+    /**
+     * Unique ID for the help text element, referenced by `aria-describedby` on the input.
+     * @internal
+     */
     private readonly _helpId;
+    /**
+     * Reference to the text input element inside the shadow DOM.
+     * @internal
+     */
     private _inputEl;
+    /**
+     * Reference to the listbox `<ul>` element inside the shadow DOM.
+     * @internal
+     */
     private _listboxEl;
+    /**
+     * Memoized array of generated time slots; null until first access.
+     * @internal
+     */
     private _cachedSlots;
+    /**
+     * Cache key composed of min, max, step, and format; used to detect when slots must be regenerated.
+     * @internal
+     */
     private _slotsKey;
+    /**
+     * Lazily generates and caches the list of time slots based on current min, max, step, and format.
+     * @internal
+     */
     private get _slots();
+    /**
+     * Closes the listbox when a click is detected outside the component; bound for stable add/removeEventListener calls.
+     * @internal
+     */
     private readonly _handleOutsideClick;
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -132,6 +213,7 @@ export declare class HelixTimePicker extends LitElement {
     private _selectSlot;
     private _handleLabelSlotChange;
     private _handleErrorSlotChange;
+    private _handleHelpSlotChange;
     private _dispatchChange;
     private _handleInputClick;
     private _handleToggleClick;

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":"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"}

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

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

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

@@ -0,0 +1,36 @@
+import { LitElement } from 'lit';
+export type ToastStackPlacement = 'top-start' | 'top-center' | 'top-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
+/**
+ * A fixed-position container that stacks `hx-toast` elements at the specified
+ * corner of the viewport. Enforces a maximum visible toast count via `stack-limit`.
+ *
+ * @summary Toast stack container managing position and count limits.
+ *
+ * @tag hx-toast-stack
+ *
+ * @slot - Accepts `hx-toast` elements.
+ *
+ * @csspart base - The inner stack container div.
+ *
+ * @cssprop [--hx-z-index-toast=9000] - Z-index for the fixed stack.
+ */
+export declare class HelixToastStack extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Corner of the viewport where toasts appear.
+     * @attr placement
+     */
+    placement: ToastStackPlacement;
+    /**
+     * Maximum number of simultaneously visible toasts. 0 = unlimited.
+     * @attr stack-limit
+     */
+    stackLimit: number;
+    render(): import('lit').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-toast-stack': HelixToastStack;
+    }
+}
+//# sourceMappingURL=hx-toast-stack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hx-toast-stack.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAMvC,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB;;;;;;;;;;;;;GAaG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAAwC;IAE9D;;;OAGG;IAEH,SAAS,EAAE,mBAAmB,CAAgB;IAE9C;;;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

@@ -1,6 +1,5 @@
 import { LitElement } from 'lit';
 export type ToastVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';
-export type ToastStackPlacement = 'top-start' | 'top-center' | 'top-end' | 'bottom-start' | 'bottom-center' | 'bottom-end';
 /**
  * A transient notification message that auto-dismisses after a configurable duration.
  * Supports multiple visual variants, a closable button, icon/action slots, and full
@@ -59,6 +58,8 @@ export declare class HelixToast extends LitElement {
     closeLabel: string;
     /** @internal */
     private _timer;
+    /** @internal Returns true when the user has opted into reduced motion. */
+    private get _reducedMotion();
     /** @internal */
     private _timerStartedAt;
     /** @internal */
@@ -95,62 +96,19 @@ export declare class HelixToast extends LitElement {
     private get _role();
     /** @internal */
     private get _ariaLive();
-    render(): import('lit').TemplateResult<1>;
-}
-/**
- * A fixed-position container that stacks `hx-toast` elements at the specified
- * corner of the viewport. Enforces a maximum visible toast count via `stack-limit`.
- *
- * @summary Toast stack container managing position and count limits.
- *
- * @tag hx-toast-stack
- *
- * @slot - Accepts `hx-toast` elements.
- *
- * @csspart base - The inner stack container div.
- *
- * @cssprop [--hx-z-index-toast=9000] - Z-index for the fixed stack.
- */
-export declare class HelixToastStack extends LitElement {
-    static styles: import('lit').CSSResult[];
-    /**
-     * Corner of the viewport where toasts appear.
-     * @attr placement
-     */
-    placement: ToastStackPlacement;
-    /**
-     * Maximum number of simultaneously visible toasts. 0 = unlimited.
-     * @attr stack-limit
-     */
-    stackLimit: number;
+    private _renderSuccessIcon;
+    private _renderWarningIcon;
+    private _renderDangerIcon;
+    private _renderInfoIcon;
+    /** @internal Returns the default icon for the current variant, or nothing for 'default'. */
+    private get _defaultIcon();
+    private static readonly _SEVERITY_LABELS;
+    private get _severityLabel();
     render(): import('lit').TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {
         'hx-toast': HelixToast;
-        'hx-toast-stack': HelixToastStack;
     }
 }
-export interface ToastOptions {
-    /** The notification message text. */
-    message: string;
-    /** Visual variant. Defaults to 'default'. */
-    variant?: ToastVariant;
-    /** Auto-dismiss duration in ms. 0 = persistent. Defaults to 3000. */
-    duration?: number;
-    /** Placement of the shared stack. Defaults to 'bottom-end'. */
-    placement?: ToastStackPlacement;
-}
-/**
- * Imperatively create and display a toast notification.
- *
- * Creates a shared `hx-toast-stack` on `document.body` if one does not exist,
- * then appends a new `hx-toast` with the given options. Respects the stack's
- * `stackLimit` by hiding the oldest visible toast when the limit is exceeded.
- *
- * @example
- * import { toast } from '@helixui/library/components/hx-toast/index.js';
- * toast({ message: 'Patient record saved.', variant: 'success' });
- */
-export declare function toast(options: ToastOptions): HelixToast;
 //# sourceMappingURL=hx-toast.d.ts.map

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,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAMhD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAmC;IAIzD;;;OAGG;IAEH,OAAO,EAAE,YAAY,CAAa;IAElC;;;OAGG;IAEH,QAAQ,SAAQ;IAEhB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,UAAU,SAA0B;IAIpC,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAA8C;IAE5D,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAE9C,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAIrC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI;IAgB3D,oBAAoB,IAAI,IAAI;IAOrC,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAMZ,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAQZ,gBAAgB;IAChB,OAAO,CAAC,WAAW;IAanB,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;IAMpB,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAED,gBAAgB;IAChB,OAAO,KAAK,SAAS,GAEpB;IAIQ,MAAM;CAoDhB;AAED;;;;;;;;;;;;;GAaG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAAwC;IAE9D;;;OAGG;IAEH,SAAS,EAAE,mBAAmB,CAAgB;IAE9C;;;OAGG;IAEH,UAAU,SAAK;IAEN,MAAM;CAahB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;QACvB,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF;AAID,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,CAoCvD"}
+{"version":3,"file":"hx-toast.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAMhD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAmC;IAIzD;;;OAGG;IAEH,OAAO,EAAE,YAAY,CAAa;IAElC;;;OAGG;IAEH,QAAQ,SAAQ;IAEhB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,UAAS;IAEb;;;OAGG;IAEH,UAAU,SAA0B;IAIpC,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAA8C;IAI5D,0EAA0E;IAC1E,OAAO,KAAK,cAAc,GAEzB;IAED,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAE9C,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAuB;IAIrC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI;IAgB3D,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;IAMpB,gBAAgB;IAChB,OAAO,KAAK,KAAK,GAEhB;IAED,gBAAgB;IAChB,OAAO,KAAK,SAAS,GAEpB;IAMD,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,eAAe;IASvB,4FAA4F;IAC5F,OAAO,KAAK,YAAY,GAavB;IAID,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAKtC;IAEF,OAAO,KAAK,cAAc,GAEzB;IAIQ,MAAM;CA6DhB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"hx-toast.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAoI5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,yBAyEjC,CAAC"}
+{"version":3,"file":"hx-toast.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/hx-toast.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAoJ5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,yBAyEjC,CAAC"}

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

@@ -1,3 +1,7 @@
-export { HelixToast, HelixToastStack, toast } from './hx-toast.js';
-export type { ToastVariant, ToastStackPlacement, ToastOptions } from './hx-toast.js';
+export { HelixToast } from './hx-toast.js';
+export type { ToastVariant } from './hx-toast.js';
+export { HelixToastStack } from './hx-toast-stack.js';
+export type { ToastStackPlacement } from './hx-toast-stack.js';
+export { toast } from './toast-factory.js';
+export type { ToastOptions } from './toast-factory.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

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

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

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

@@ -0,0 +1,25 @@
+import { HelixToast, ToastVariant } from './hx-toast.js';
+import { ToastStackPlacement } from './hx-toast-stack.js';
+export interface ToastOptions {
+    /** The notification message text. */
+    message: string;
+    /** Visual variant. Defaults to 'default'. */
+    variant?: ToastVariant;
+    /** Auto-dismiss duration in ms. 0 = persistent. Defaults to 3000. */
+    duration?: number;
+    /** Placement of the shared stack. Defaults to 'bottom-end'. */
+    placement?: ToastStackPlacement;
+}
+/**
+ * Imperatively create and display a toast notification.
+ *
+ * Creates a shared `hx-toast-stack` on `document.body` if one does not exist,
+ * then appends a new `hx-toast` with the given options. Respects the stack's
+ * `stackLimit` by hiding the oldest visible toast when the limit is exceeded.
+ *
+ * @example
+ * import { toast } from '@helixui/library/components/hx-toast/index.js';
+ * toast({ message: 'Patient record saved.', variant: 'success' });
+ */
+export declare function toast(options: ToastOptions): HelixToast;
+//# sourceMappingURL=toast-factory.d.ts.map

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

@@ -0,0 +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,CA4CvD"}

package/dist/components/hx-toggle-button/hx-toggle-button.d.ts

@@ -75,6 +75,7 @@ export declare class HelixToggleButton extends LitElement {
     label: string | undefined;
     /** Returns the associated form element, if any. */
     get form(): HTMLFormElement | null;
+    firstUpdated(changedProperties: PropertyValues<this>): void;
     updated(changedProperties: PropertyValues<this>): void;
     /** Called by the browser when the associated form is reset. */
     formResetCallback(): void;

package/dist/components/hx-toggle-button/hx-toggle-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-toggle-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toggle-button/hx-toggle-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBACa,iBAAkB,SAAQ,UAAU;IAC/C,OAAgB,MAAM,4BAA0C;IAIhE,MAAM,CAAC,cAAc,UAAQ;IAE7B,OAAO,CAAC,UAAU,CAAmB;;IASrC;;;;OAIG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAe;IAElF;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC,mDAAmD;IACnD,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAEjC;IAIQ,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAQ/D,+DAA+D;IAC/D,iBAAiB,IAAI,IAAI;IAIzB,sEAAsE;IACtE,wBAAwB,CACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAMP,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,YAAY;IAgBX,MAAM;CAsBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,iBAAiB,CAAC;KACvC;CACF"}
+{"version":3,"file":"hx-toggle-button.d.ts","sourceRoot":"","sources":["../../../src/components/hx-toggle-button/hx-toggle-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBACa,iBAAkB,SAAQ,UAAU;IAC/C,OAAgB,MAAM,4BAA0C;IAIhE,MAAM,CAAC,cAAc,UAAQ;IAE7B,OAAO,CAAC,UAAU,CAAmB;;IASrC;;;;OAIG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAe;IAElF;;;OAGG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAItC,mDAAmD;IACnD,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAEjC;IAIQ,YAAY,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgB3D,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAQ/D,+DAA+D;IAC/D,iBAAiB,IAAI,IAAI;IAIzB,sEAAsE;IACtE,wBAAwB,CACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,EAAE,SAAS,GAAG,cAAc,GAChC,IAAI;IAMP,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,YAAY;IAgBX,MAAM;CAsBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,iBAAiB,CAAC;KACvC;CACF"}

package/dist/components/hx-toggle-button/index.js

@@ -1,4 +1,4 @@
-import { H as t } from "../../shared/hx-toggle-button--xCXWRJW.js";
+import { H as t } from "../../shared/hx-toggle-button-D4F1soEM.js";
 export {
   t as HelixToggleButton
 };

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

@@ -1,45 +1,5 @@
 import { LitElement } from 'lit';
 import { Placement } from '@floating-ui/dom';
-/**
- * A tooltip that displays contextual help text on hover or focus.
- *
- * @summary Contextual help text and abbreviations with smart positioning.
- *
- * @tag hx-tooltip
- *
- * @slot - Default slot for the trigger element.
- * @slot content - Tooltip content to display.
- *
- * @csspart tooltip - The tooltip container element.
- * @csspart arrow - The arrow indicator element.
- *
- * @cssprop [--hx-tooltip-bg=var(--hx-color-neutral-900)] - Tooltip background color.
- * @cssprop [--hx-tooltip-color=var(--hx-color-neutral-50)] - Tooltip text color.
- * @cssprop [--hx-tooltip-font-size=var(--hx-font-size-xs)] - Tooltip font size.
- * @cssprop [--hx-tooltip-max-width=280px] - Maximum tooltip width.
- * @cssprop [--hx-tooltip-padding] - Tooltip padding.
- * @cssprop [--hx-tooltip-border-radius=var(--hx-border-radius-sm)] - Tooltip border radius.
- * @cssprop [--hx-tooltip-shadow] - Tooltip box shadow.
- * @cssprop [--hx-tooltip-z-index=9999] - Tooltip z-index.
- * @cssprop [--hx-tooltip-transition-duration=0.15s] - Show/hide transition duration.
- * @cssprop [--hx-tooltip-arrow-size=8px] - Size of the arrow indicator.
- *
- * @example
- * ```html
- * <hx-tooltip>
- *   <button>Hover me</button>
- *   <span slot="content">Helpful context here</span>
- * </hx-tooltip>
- * ```
- *
- * @example Drupal/Twig usage
- * ```twig
- * <hx-tooltip>
- *   <button type="button">{{ trigger_label }}</button>
- *   <span slot="content">{{ tooltip_text }}</span>
- * </hx-tooltip>
- * ```
- */
 export declare class HelixTooltip extends LitElement {
     static styles: import('lit').CSSResult[];
     /**
@@ -65,11 +25,7 @@ export declare class HelixTooltip extends LitElement {
     private _showTimer;
     /** @internal */
     private _hideTimer;
-    /**
-     * Unique ID for this tooltip instance.
-     * Uses crypto.randomUUID() to prevent SSR hydration ID collisions.
-     * @internal
-     */
+    /** @internal */
     private readonly _tooltipId;
     /**
      * Visually-hidden description element in light DOM.

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

@@ -1 +1 @@
-{"version":3,"file":"hx-tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tooltip/hx-tooltip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAGvC,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBACa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,MAAM,4BAAqC;IAE3D;;;;;OAKG;IAEH,SAAS,EAAE,SAAS,CAAS;IAE7B;;;OAGG;IAEH,SAAS,SAAO;IAEhB;;;OAGG;IAEH,SAAS,SAAO;IAEhB,gBAAgB;IACP,OAAO,CAAC,QAAQ,CAAS;IAElC,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAA8C;IAChE,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAA8C;IAEhE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAElE;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB,CAAgC;IAInD,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IAM7B,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;YAOP,KAAK;IAMnB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,YAAY;YAaN,eAAe;IAsC7B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAKpB;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAcvB,MAAM;CAyBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF"}
+{"version":3,"file":"hx-tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tooltip/hx-tooltip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAGvC,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA6C/F,qBACa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,MAAM,4BAAqC;IAE3D;;;;;OAKG;IAEH,SAAS,EAAE,SAAS,CAAS;IAE7B;;;OAGG;IAEH,SAAS,SAAO;IAEhB;;;OAGG;IAEH,SAAS,SAAO;IAEhB,gBAAgB;IACP,OAAO,CAAC,QAAQ,CAAS;IAElC,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAA8C;IAChE,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAA8C;IAEhE,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAEhE;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB,CAAgC;IAInD,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IAM7B,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;YAOP,KAAK;IAMnB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,YAAY;YAaN,eAAe;IAsC7B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAMpB;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAcvB,MAAM;CAyBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,YAAY,CAAC;KAC5B;CACF"}

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

@@ -1,4 +1,4 @@
-import { H as i } from "../../shared/hx-tooltip-DN6lMlP5.js";
+import { H as i } from "../../shared/hx-tooltip-Bk1iQRHs.js";
 export {
   i as HelixTooltip
 };

package/dist/components/hx-top-nav/hx-top-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-top-nav.d.ts","sourceRoot":"","sources":["../../../src/components/hx-top-nav/hx-top-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAM5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAoC;IAI1D;;;OAGG;IAEH,MAAM,UAAS;IAEf;;;OAGG;IAEH,KAAK,SAAqB;IAI1B,6DAA6D;IACpD,OAAO,CAAC,WAAW,CAAS;IAI5B,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAOrC,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,cAAc,CAapB;IAIF,OAAO,CAAC,oBAAoB;IA4BnB,MAAM;CAwChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,WAAW,CAAC;KAC3B;CACF"}
+{"version":3,"file":"hx-top-nav.d.ts","sourceRoot":"","sources":["../../../src/components/hx-top-nav/hx-top-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAM5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBACa,WAAY,SAAQ,UAAU;IACzC,OAAgB,MAAM,4BAAoC;IAI1D;;;OAGG;IAEH,MAAM,UAAS;IAEf;;;OAGG;IAEH,KAAK,SAAqB;IAI1B,6DAA6D;IACpD,OAAO,CAAC,WAAW,CAAS;IAI5B,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAOrC,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,cAAc,CAapB;IAIF,OAAO,CAAC,oBAAoB;IA4BnB,MAAM;CAwChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,WAAW,CAAC;KAC3B;CACF"}

package/dist/components/hx-top-nav/index.js

@@ -1,4 +1,4 @@
-import { H as e } from "../../shared/hx-top-nav-8lDKNZUj.js";
+import { H as e } from "../../shared/hx-top-nav-D2bQpns3.js";
 export {
   e as HelixTopNav
 };

package/dist/components/hx-tree-view/hx-tree-item.d.ts

@@ -12,7 +12,7 @@ export interface HxTreeItemSelectDetail {
  *
  * @tag hx-tree-item
  *
- * @slot - Default slot for the item label content.
+ * @slot - Default slot for the item label content. This text is also used to label the children group.
  * @slot icon - Custom icon shown before the label.
  * @slot children - Nested hx-tree-item elements for sub-tree.
  *
@@ -49,14 +49,41 @@ export declare class HelixTreeItem extends LitElement {
      * @attr disabled
      */
     disabled: boolean;
+    /**
+     * Tracks whether any elements are assigned to the children slot, controlling expand icon visibility.
+     * @internal
+     */
     private _hasChildren;
+    /**
+     * Whether this item is the roving-tabindex active item in the tree.
+     * @internal
+     */
+    private _rovingActive;
+    /**
+     * Text content from the default slot, used to label the children group for screen readers.
+     * @internal
+     */
+    private _labelText;
     /**
      * Cached ARIA position metadata. Computed once on connect and on slotchange
      * of the parent container, avoiding repeated DOM traversal on every render.
+     * @internal
      */
     private _level;
+    /**
+     * One-based position of this item within its sibling set, set as aria-posinset.
+     * @internal
+     */
     private _posInSet;
+    /**
+     * Total count of sibling hx-tree-item elements at the same level, set as aria-setsize.
+     * @internal
+     */
     private _setSize;
+    /**
+     * Whether the owning hx-tree-view supports item selection (single or multiple mode).
+     * @internal
+     */
     private _selectable;
     /**
      * Whether this item has slotted children.
@@ -66,15 +93,48 @@ export declare class HelixTreeItem extends LitElement {
     /**
      * Recompute all cached ARIA metadata in a single DOM pass.
      * Called on connect, slotchange, and whenever structural context may change.
+     * @internal
      */
     private _updateAriaMetadata;
     connectedCallback(): void;
+    /**
+     * Updates _hasChildren and recomputes ARIA metadata when the children slot assignment changes.
+     * @internal
+     */
     private _handleChildrenSlotChange;
+    /**
+     * Captures the text content from the default (label) slot for use on the children group label.
+     * @internal
+     */
+    private _handleLabelSlotChange;
+    /**
+     * Toggles the expanded state when the expand/collapse button is clicked, stopping event propagation.
+     * @internal
+     */
     private _handleExpandClick;
+    /**
+     * Dispatches the hx-tree-item-select event when the item is activated via click or keyboard.
+     * @internal
+     */
     private _handleRowClick;
+    /**
+     * Handles keyboard interaction for the tree item, including expand/collapse, activation, and delegation of list-navigation keys to the parent tree.
+     * @internal
+     */
     private _handleKeyDown;
+    /**
+     * Sets the roving tabindex state for this item.
+     * When `active` is true, the item row gets `tabindex="0"` making it the
+     * Tab-reachable item in the tree. All other items should be set to false.
+     * Called by the parent hx-tree-view to manage the roving tabindex pattern.
+     */
+    setRovingActive(active: boolean): void;
     /** Focus this item's interactive row element. */
     focus(): void;
+    /**
+     * Renders the expand/collapse chevron button, or a placeholder span when the item has no children.
+     * @internal
+     */
     private _renderExpandIcon;
     render(): import('lit').TemplateResult<1>;
 }

package/dist/components/hx-tree-view/hx-tree-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tree-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAKhD,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAI5D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAIR,OAAO,CAAC,YAAY,CAAS;IAEtC;;;OAGG;IACM,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAS;IAIrC;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAmClB,iBAAiB,IAAI,IAAI;IAOlC,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,cAAc;IAgCtB,iDAAiD;IACxC,KAAK,IAAI,IAAI;IAOtB,OAAO,CAAC,iBAAiB;IAmBhB,MAAM;CAwChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,kGAAkG;AAClG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}
+{"version":3,"file":"hx-tree-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAKhD,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAI5D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAIjB;;;OAGG;IACM,OAAO,CAAC,YAAY,CAAS;IAEtC;;;OAGG;IACM,OAAO,CAAC,aAAa,CAAS;IAEvC;;;OAGG;IACM,OAAO,CAAC,UAAU,CAAM;IAEjC;;;;OAIG;IACM,OAAO,CAAC,MAAM,CAAK;IAC5B;;;OAGG;IACM,OAAO,CAAC,SAAS,CAAK;IAC/B;;;OAGG;IACM,OAAO,CAAC,QAAQ,CAAK;IAC9B;;;OAGG;IACM,OAAO,CAAC,WAAW,CAAS;IAIrC;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAmClB,iBAAiB,IAAI,IAAI;IAOlC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAMjC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAItC,iDAAiD;IACxC,KAAK,IAAI,IAAI;IAOtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBhB,MAAM;CAyChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,kGAAkG;AAClG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}

package/dist/components/hx-tree-view/hx-tree-item.styles.d.ts.map

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

package/dist/components/hx-tree-view/hx-tree-view.d.ts

@@ -56,6 +56,8 @@ export declare class HelixTreeView extends LitElement {
      */
     selection: TreeSelection;
     private _currentIndex;
+    /** Tracks whether the tree has any visible items, to decide the container tabindex. */
+    private _hasVisibleItems;
     /**
      * Returns a flat ordered list of all visible (not inside a collapsed item) hx-tree-items
      * in depth-first order.
@@ -63,10 +65,24 @@ export declare class HelixTreeView extends LitElement {
     private _getVisibleItems;
     private _collectVisibleItems;
     private _getSelectedItems;
+    /**
+     * Updates the roving tabindex across all visible items so that only the
+     * item at `activeIndex` has `tabindex="0"`. All others receive `tabindex="-1"`.
+     * This is called whenever the active item changes (navigation, initial render).
+     */
+    private _updateRovingTabindex;
     private _focusItem;
     private _handleTreeItemSelect;
     private _handleKeyDown;
     private _handleFocusIn;
+    /**
+     * Initializes the roving tabindex after items are first slotted in.
+     * Ensures the active item (index 0 by default) has tabindex="0" from the start,
+     * so a Tab into the tree lands directly on the first item without a redirect.
+     * Also updates `_hasVisibleItems` so the container tabindex re-renders correctly.
+     */
+    private _handleSlotChange;
+    firstUpdated(): void;
     render(): import('lit').TemplateResult<1>;
 }
 declare global {

package/dist/components/hx-tree-view/hx-tree-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tree-view.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAIhD,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,mBAAmB,CAAC;AAE/E,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAI5D;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;;;;OAMG;IAEH,SAAS,EAAE,aAAa,CAAU;IAIzB,OAAO,CAAC,aAAa,CAAK;IAInC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,cAAc;IAwEtB,OAAO,CAAC,cAAc;IAQb,MAAM;CAiBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,kGAAkG;AAClG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}
+{"version":3,"file":"hx-tree-view.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAIvC,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,mBAAmB,CAAC;AAG/E,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAI5D;;;;OAIG;IAEH,KAAK,SAAM;IAEX;;;;;;OAMG;IAEH,SAAS,EAAE,aAAa,CAAU;IAIzB,OAAO,CAAC,aAAa,CAAK;IAEnC,uFAAuF;IAC9E,OAAO,CAAC,gBAAgB,CAAS;IAI1C;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,cAAc;IAwEtB,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAYhB,YAAY,IAAI,IAAI;IAWpB,MAAM;CAuBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,kGAAkG;AAClG,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC"}

package/dist/components/hx-tree-view/index.js

@@ -1,4 +1,4 @@
-import { H as a, a as i } from "../../shared/hx-tree-item-Cesh_du5.js";
+import { H as a, a as i } from "../../shared/hx-tree-item-BobGN76x.js";
 export {
   a as HelixTreeItem,
   i as HelixTreeView