@helixui/library 1.1.2 → 2.0.0

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

@@ -92,12 +92,24 @@ export declare class HelixTreeItem extends LitElement {
      * @returns True if one or more elements are assigned to the children slot.
      */
     get hasChildItems(): boolean;
+    /**
+     * The text content of the item's label slot, used for typeahead keyboard navigation.
+     * Returns an empty string until the label slot has been assigned.
+     */
+    get labelText(): string;
     /**
      * Recompute all cached ARIA metadata in a single DOM pass.
      * Called on connect, slotchange, and whenever structural context may change.
      * @internal
      */
     private _updateAriaMetadata;
+    /**
+     * Set ARIA position metadata from the parent hx-tree-view in a single O(n) pass.
+     * Calling this avoids the O(n^2) ancestor-walk + sibling-iteration in _updateAriaMetadata
+     * when the parent already knows the layout.
+     * @internal
+     */
+    setAriaMetadata(level: number, posInSet: number, setSize: number, selectable: boolean): void;
     connectedCallback(): void;
     /**
      * Updates _hasChildren and recomputes ARIA metadata when the children slot assignment changes.

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;AAMhD,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;IAErC,gBAAgB;IACI,OAAO,CAAC,UAAU,CAAsB;IAI5D;;;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;IAMtB;;;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"}
+{"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;AAMhD,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;IAErC,gBAAgB;IACI,OAAO,CAAC,UAAU,CAAsB;IAI5D;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IASnF,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;IAMtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBhB,MAAM;CA0ChB;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-view.d.ts

@@ -54,15 +54,26 @@ export declare class HelixTreeView extends LitElement {
      * - `multiple` — multiple items can be selected
      * @attr selection
      */
-    selection: TreeSelection;
+    selection: 'none' | 'single' | 'multiple';
     /** @internal */
     private _currentIndex;
     /** Tracks whether the tree has any visible items, to decide the container tabindex. */
     /** @internal */
     private _hasVisibleItems;
+    /**
+     * Cached flat list of visible items (depth-first, respects collapsed nodes).
+     * Set to null to invalidate; rebuilt on next access.
+     * @internal
+     */
+    private _cachedVisibleItems;
+    /**
+     * Invalidate the visible-items cache. Call after any expand/collapse or structural change.
+     * @internal
+     */
+    private _invalidateVisibleItemsCache;
     /**
      * Returns a flat ordered list of all visible (not inside a collapsed item) hx-tree-items
-     * in depth-first order.
+     * in depth-first order. Result is cached; invalidated on expand/collapse/slotchange.
      */
     /** @internal */
     private _getVisibleItems;
@@ -83,13 +94,27 @@ export declare class HelixTreeView extends LitElement {
     private _handleTreeItemSelect;
     /** @internal */
     private _handleKeyDown;
+    /**
+     * Finds the next visible item (starting after `currentIndex`, wrapping around) whose
+     * label text begins with the given lowercase character. Returns -1 if no match.
+     * @internal
+     */
+    private _findTypeaheadMatch;
     /** @internal */
     private _handleFocusIn;
+    /**
+     * Compute and push ARIA position metadata (level, posInSet, setSize, selectable) to all
+     * direct hx-tree-item children of a container in a single O(n) pass.
+     * Each item also recurses for its own children, building the full tree in O(total-items) total.
+     * @internal
+     */
+    private _updateAriaMetadataForContainer;
     /**
      * 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.
+     * Pushes O(n) ARIA metadata to all items to replace the O(n^2) per-item ancestor walk.
      */
     /** @internal */
     private _handleSlotChange;

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,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;IAIlC,gBAAgB;IACP,OAAO,CAAC,aAAa,CAAK;IAEnC,uFAAuF;IACvF,gBAAgB;IACP,OAAO,CAAC,gBAAgB,CAAS;IAI1C;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAIxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAgB5B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAM7B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAWlB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IA0B7B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAwEtB,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACH,gBAAgB;IAChB,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"}
+{"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;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,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAU;IAInD,gBAAgB;IACP,OAAO,CAAC,aAAa,CAAK;IAEnC,uFAAuF;IACvF,gBAAgB;IACP,OAAO,CAAC,gBAAgB,CAAS;IAI1C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAgC;IAE3D;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;OAGG;IACH,gBAAgB;IAChB,OAAO,CAAC,gBAAgB;IAOxB,gBAAgB;IAChB,OAAO,CAAC,oBAAoB;IAgB5B,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAM7B,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAWlB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IA0B7B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IA0FtB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B,gBAAgB;IAChB,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAavC;;;;;;OAMG;IACH,gBAAgB;IAChB,OAAO,CAAC,iBAAiB;IAehB,YAAY,IAAI,IAAI;IAWpB,MAAM;CA2BhB;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-view.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hx-tree-view.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-view.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBAqB/B,CAAC"}
+{"version":3,"file":"hx-tree-view.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-tree-view/hx-tree-view.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBAsB/B,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-BP6UF_H1.js";
+import { H as a, a as i } from "../../shared/hx-tree-item-C1PhX-HE.js";
 export {
   a as HelixTreeItem,
   i as HelixTreeView

package/dist/controllers/helix-audit-controller.d.ts

@@ -0,0 +1,71 @@
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * The structured payload carried in every `hx-audit` CustomEvent.
+ */
+export interface AuditEventDetail {
+    /** Stable correlation ID generated once per controller instance. */
+    sessionId: string;
+    /** ISO-8601 timestamp at the moment of capture. */
+    timestamp: string;
+    /** Lowercase tag name of the host element (e.g. `"hx-button"`). */
+    tagName: string;
+    /** The original `hx-*` event type that triggered this audit record. */
+    sourceEventType: string;
+    /** The original event's `detail` payload, preserved verbatim. */
+    sourceEventDetail: unknown;
+    /** Optional user identifier for the authenticated session. */
+    userId?: string;
+    /** Optional patient context identifier for clinical audit trails. */
+    patientContextId?: string;
+    /** Optional encounter/visit identifier for clinical audit trails. */
+    encounterId?: string;
+    /** Additional caller-supplied key/value metadata. */
+    [key: string]: unknown;
+}
+/**
+ * Options accepted by `HelixAuditController` at construction time and via
+ * `updateMetadata()`.
+ */
+export interface AuditControllerOptions {
+    /** Authenticated user identifier. */
+    userId?: string;
+    /** Patient context identifier. */
+    patientContextId?: string;
+    /** Clinical encounter / visit identifier. */
+    encounterId?: string;
+    /** Arbitrary additional metadata to merge into every audit record. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Attaches to a Lit `ReactiveControllerHost` (any `LitElement`) and silently
+ * captures all `hx-*` events, enriching them with session, timestamp, and
+ * optional clinical metadata before re-dispatching as `hx-audit` events.
+ *
+ * Because all HELiX component events are dispatched with
+ * `bubbles: true, composed: true`, they propagate from inside the shadow DOM
+ * up to the host element — where this controller's listeners are registered —
+ * and then continue bubbling to `document`, making the `hx-audit` event
+ * observable anywhere in the page without requiring a global listener.
+ */
+export declare class HelixAuditController implements ReactiveController {
+    private readonly _host;
+    private readonly _sessionId;
+    private _options;
+    /**
+     * A single `EventListenerObject` reused across all event-type registrations.
+     * Using the object form (rather than a bound function) avoids creating a new
+     * closure per event type while still keeping `this` bound correctly.
+     */
+    private readonly _listener;
+    constructor(host: ReactiveControllerHost & EventTarget, options?: AuditControllerOptions);
+    /**
+     * Updates the metadata attached to future audit records. Useful when the
+     * authenticated user, patient context, or encounter changes after the
+     * component is connected (e.g. patient context switch within a session).
+     */
+    updateMetadata(options: AuditControllerOptions): void;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _onHxEvent;
+}
+//# sourceMappingURL=helix-audit-controller.d.ts.map

package/dist/controllers/helix-audit-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helix-audit-controller.d.ts","sourceRoot":"","sources":["../../src/controllers/helix-audit-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAqDD;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAEpC,IAAI,EAAE,sBAAsB,GAAG,WAAW,EAAE,OAAO,GAAE,sBAA2B;IAQ5F;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAIrD,aAAa,IAAI,IAAI;IAMrB,gBAAgB,IAAI,IAAI;IAMxB,OAAO,CAAC,UAAU;CAgCnB"}