@nvidia-elements/core 2.8.1 → 2.9.0

package/dist/internal/controllers/key-state.controller.d.ts

@@ -0,0 +1,18 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+export interface KeyStateControllerOptions {
+    readonly watchedCodes: ReadonlyArray<string>;
+}
+type KeyStateHost = ReactiveControllerHost & Pick<HTMLElement, 'ownerDocument'>;
+/** Provides host-scoped access to shared raw keyboard state without assigning interaction semantics to any key. */
+export declare class KeyStateController implements ReactiveController {
+    #private;
+    constructor(host: KeyStateHost, { watchedCodes }: KeyStateControllerOptions);
+    /** Enables shared keyboard tracking during the host's connected lifecycle. */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    /** Returns whether a key identified by `KeyboardEvent.code` is currently held. */
+    isPressed(code: string): boolean;
+    hostConnected(): void;
+    hostDisconnected(): void;
+}
+export {};

package/dist/internal/controllers/key-state.controller.js

@@ -0,0 +1,84 @@
+//#region src/internal/controllers/key-state.controller.ts
+var e = class {
+	#e;
+	#t = /* @__PURE__ */ new Set();
+	#n = /* @__PURE__ */ new Set();
+	constructor(e) {
+		this.#e = e;
+	}
+	subscribe(e) {
+		this.#n.has(e) || (this.#n.size === 0 && this.#r(), this.#n.add(e));
+	}
+	unsubscribe(e) {
+		!this.#n.delete(e) || this.#n.size > 0 || (this.#i(), this.#t.clear());
+	}
+	isPressed(e) {
+		return this.#t.has(e);
+	}
+	#r() {
+		let e = this.#e.defaultView;
+		e?.addEventListener("keydown", this.#a, !0), e?.addEventListener("keyup", this.#o, !0), e?.addEventListener("blur", this.#c), this.#e.addEventListener("visibilitychange", this.#s);
+	}
+	#i() {
+		let e = this.#e.defaultView;
+		e?.removeEventListener("keydown", this.#a, !0), e?.removeEventListener("keyup", this.#o, !0), e?.removeEventListener("blur", this.#c), this.#e.removeEventListener("visibilitychange", this.#s);
+	}
+	#a = (e) => {
+		this.#t.has(e.code) || (this.#t.add(e.code), this.#l(e.code));
+	};
+	#o = (e) => {
+		this.#t.delete(e.code) && this.#l(e.code);
+	};
+	#s = () => {
+		this.#e.visibilityState === "hidden" && this.#c();
+	};
+	#c = () => {
+		if (this.#t.size === 0) return;
+		let e = [...this.#t];
+		this.#t.clear();
+		for (let t of this.#n) e.some((e) => t.watchedCodes.has(e)) && t.requestUpdate();
+	};
+	#l(e) {
+		for (let t of this.#n) t.watchedCodes.has(e) && t.requestUpdate();
+	}
+}, t = /* @__PURE__ */ new WeakMap();
+function n(n) {
+	let r = t.get(n);
+	return r || (r = new e(n), t.set(n, r)), r;
+}
+var r = class {
+	#e;
+	#t;
+	#n = !1;
+	#r = !1;
+	#i;
+	constructor(e, { watchedCodes: t }) {
+		this.#e = e, this.#t = {
+			watchedCodes: new Set(t),
+			requestUpdate: () => e.requestUpdate()
+		}, e.addController(this);
+	}
+	get enabled() {
+		return this.#r;
+	}
+	set enabled(e) {
+		e !== this.#r && (this.#r = e, this.#a());
+	}
+	isPressed(e) {
+		return this.#i?.isPressed(e) ?? !1;
+	}
+	hostConnected() {
+		this.#n = !0, this.#a();
+	}
+	hostDisconnected() {
+		this.#n = !1, this.#a();
+	}
+	#a() {
+		let e = this.#n && this.#r ? n(this.#e.ownerDocument) : void 0;
+		e !== this.#i && (this.#i?.unsubscribe(this.#t), this.#i = e, this.#i?.subscribe(this.#t));
+	}
+};
+//#endregion
+export { r as KeyStateController };
+
+//# sourceMappingURL=key-state.controller.js.map

package/dist/internal/controllers/key-state.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-state.controller.js","names":[],"sources":["../../../src/internal/controllers/key-state.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\nexport interface KeyStateControllerOptions {\n  readonly watchedCodes: ReadonlyArray<string>;\n}\n\ntype KeyStateHost = ReactiveControllerHost & Pick<HTMLElement, 'ownerDocument'>;\n\ninterface KeyStateSubscriber {\n  readonly watchedCodes: ReadonlySet<string>;\n  readonly requestUpdate: () => void;\n}\n\n/** Owns the keyboard state and global listeners shared by active controllers in one document. */\nclass DocumentKeyStateSource {\n  readonly #document: Document;\n  readonly #pressedCodes = new Set<string>();\n  readonly #subscribers = new Set<KeyStateSubscriber>();\n\n  constructor(document: Document) {\n    this.#document = document;\n  }\n\n  subscribe(subscriber: KeyStateSubscriber): void {\n    if (this.#subscribers.has(subscriber)) return;\n    if (this.#subscribers.size === 0) this.#addListeners();\n    this.#subscribers.add(subscriber);\n  }\n\n  unsubscribe(subscriber: KeyStateSubscriber): void {\n    if (!this.#subscribers.delete(subscriber) || this.#subscribers.size > 0) return;\n    this.#removeListeners();\n    this.#pressedCodes.clear();\n  }\n\n  isPressed(code: string): boolean {\n    return this.#pressedCodes.has(code);\n  }\n\n  #addListeners(): void {\n    const view = this.#document.defaultView;\n    view?.addEventListener('keydown', this.#handleKeyDown, true);\n    view?.addEventListener('keyup', this.#handleKeyUp, true);\n    view?.addEventListener('blur', this.#clear);\n    this.#document.addEventListener('visibilitychange', this.#handleVisibilityChange);\n  }\n\n  #removeListeners(): void {\n    const view = this.#document.defaultView;\n    view?.removeEventListener('keydown', this.#handleKeyDown, true);\n    view?.removeEventListener('keyup', this.#handleKeyUp, true);\n    view?.removeEventListener('blur', this.#clear);\n    this.#document.removeEventListener('visibilitychange', this.#handleVisibilityChange);\n  }\n\n  #handleKeyDown = (event: KeyboardEvent): void => {\n    if (this.#pressedCodes.has(event.code)) return;\n    this.#pressedCodes.add(event.code);\n    this.#notifySubscribers(event.code);\n  };\n\n  #handleKeyUp = (event: KeyboardEvent): void => {\n    if (!this.#pressedCodes.delete(event.code)) return;\n    this.#notifySubscribers(event.code);\n  };\n\n  #handleVisibilityChange = (): void => {\n    if (this.#document.visibilityState === 'hidden') this.#clear();\n  };\n\n  #clear = (): void => {\n    if (this.#pressedCodes.size === 0) return;\n    const changedCodes = [...this.#pressedCodes];\n    this.#pressedCodes.clear();\n    for (const subscriber of this.#subscribers) {\n      if (changedCodes.some(code => subscriber.watchedCodes.has(code))) subscriber.requestUpdate();\n    }\n  };\n\n  #notifySubscribers(code: string): void {\n    for (const subscriber of this.#subscribers) {\n      if (subscriber.watchedCodes.has(code)) subscriber.requestUpdate();\n    }\n  }\n}\n\nconst documentKeyStateSources = new WeakMap<Document, DocumentKeyStateSource>();\n\nfunction keyStateSourceFor(document: Document): DocumentKeyStateSource {\n  let source = documentKeyStateSources.get(document);\n  if (!source) {\n    source = new DocumentKeyStateSource(document);\n    documentKeyStateSources.set(document, source);\n  }\n  return source;\n}\n\n/** Provides host-scoped access to shared raw keyboard state without assigning interaction semantics to any key. */\nexport class KeyStateController implements ReactiveController {\n  readonly #host: KeyStateHost;\n  readonly #subscriber: KeyStateSubscriber;\n  #connected = false;\n  #enabled = false;\n  #source?: DocumentKeyStateSource;\n\n  constructor(host: KeyStateHost, { watchedCodes }: KeyStateControllerOptions) {\n    this.#host = host;\n    this.#subscriber = {\n      watchedCodes: new Set(watchedCodes),\n      requestUpdate: () => host.requestUpdate()\n    };\n    host.addController(this);\n  }\n\n  /** Enables shared keyboard tracking during the host's connected lifecycle. */\n  get enabled(): boolean {\n    return this.#enabled;\n  }\n\n  set enabled(value: boolean) {\n    if (value === this.#enabled) return;\n    this.#enabled = value;\n    this.#syncSubscription();\n  }\n\n  /** Returns whether a key identified by `KeyboardEvent.code` is currently held. */\n  isPressed(code: string): boolean {\n    return this.#source?.isPressed(code) ?? false;\n  }\n\n  hostConnected(): void {\n    this.#connected = true;\n    this.#syncSubscription();\n  }\n\n  hostDisconnected(): void {\n    this.#connected = false;\n    this.#syncSubscription();\n  }\n\n  #syncSubscription(): void {\n    const source = this.#connected && this.#enabled ? keyStateSourceFor(this.#host.ownerDocument) : undefined;\n    if (source === this.#source) return;\n    this.#source?.unsubscribe(this.#subscriber);\n    this.#source = source;\n    this.#source?.subscribe(this.#subscriber);\n  }\n}\n"],"mappings":"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"}

package/dist/internal/controllers/keynav-spatial.controller.d.ts

@@ -1,6 +1,9 @@
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
 type SpatialKeyHost = ReactiveControllerHost & HTMLElement;
 export type SpatialKeyHandling = 'handled' | 'ignored';
+export interface KeyNavigationSpatialControllerOptions {
+    readonly isEnabled?: () => boolean;
+}
 export type SpatialKeyCommand = {
     readonly ctrlKey: boolean;
     readonly event: KeyboardEvent;
@@ -17,7 +20,7 @@ export type SpatialKeyCommand = {
 /** Converts direct-host keyboard input into spatial direction and zoom commands. */
 export declare class KeyNavigationSpatialController implements ReactiveController {
     #private;
-    constructor(host: SpatialKeyHost);
+    constructor(host: SpatialKeyHost, { isEnabled }?: KeyNavigationSpatialControllerOptions);
     hostConnected(): void;
     hostDisconnected(): void;
 }

package/dist/internal/controllers/keynav-spatial.controller.js

@@ -1,17 +1,18 @@
 //#region src/internal/controllers/keynav-spatial.controller.ts
 var e = class {
 	#e;
-	constructor(e) {
-		this.#e = e, e.addController(this);
+	#t;
+	constructor(e, { isEnabled: t = () => !0 } = {}) {
+		this.#e = e, this.#t = t, e.addController(this);
 	}
 	hostConnected() {
-		this.#e.addEventListener("keydown", this.#t);
+		this.#e.addEventListener("keydown", this.#n);
 	}
 	hostDisconnected() {
-		this.#e.removeEventListener("keydown", this.#t);
+		this.#e.removeEventListener("keydown", this.#n);
 	}
-	#t = (e) => {
-		if (e.composedPath()[0] !== this.#e) return;
+	#n = (e) => {
+		if (!this.#t() || e.composedPath()[0] !== this.#e) return;
 		let n = t(e);
 		n && this.#e.dispatchEvent(new CustomEvent("nve-key", {
 			bubbles: !1,

package/dist/internal/controllers/keynav-spatial.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"keynav-spatial.controller.js","names":[],"sources":["../../../src/internal/controllers/keynav-spatial.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\ntype SpatialKeyHost = ReactiveControllerHost & HTMLElement;\n\nexport type SpatialKeyHandling = 'handled' | 'ignored';\n\nexport type SpatialKeyCommand =\n  | {\n      readonly ctrlKey: boolean;\n      readonly event: KeyboardEvent;\n      readonly kind: 'direction';\n      readonly horizontal: -1 | 0 | 1;\n      readonly key: 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp';\n      readonly shiftKey: boolean;\n      readonly vertical: -1 | 0 | 1;\n    }\n  | {\n      readonly event: KeyboardEvent;\n      readonly kind: 'zoom';\n      readonly key: '+' | '-' | '=';\n    };\n\n/** Converts direct-host keyboard input into spatial direction and zoom commands. */\nexport class KeyNavigationSpatialController implements ReactiveController {\n  readonly #host: SpatialKeyHost;\n\n  constructor(host: SpatialKeyHost) {\n    this.#host = host;\n    host.addController(this);\n  }\n\n  hostConnected(): void {\n    this.#host.addEventListener('keydown', this.#handleKeydown);\n  }\n\n  hostDisconnected(): void {\n    this.#host.removeEventListener('keydown', this.#handleKeydown);\n  }\n\n  #handleKeydown = (event: KeyboardEvent): void => {\n    if (event.composedPath()[0] !== this.#host) return;\n    const command = getSpatialKeyCommand(event);\n    if (!command) return;\n    this.#host.dispatchEvent(\n      new CustomEvent<SpatialKeyCommand>('nve-key', {\n        bubbles: false,\n        cancelable: false,\n        composed: false,\n        detail: command\n      })\n    );\n  };\n}\n\nfunction getSpatialKeyCommand(event: KeyboardEvent): SpatialKeyCommand | undefined {\n  switch (event.key) {\n    case 'ArrowDown':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: 0,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: -1\n      };\n    case 'ArrowLeft':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: -1,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: 0\n      };\n    case 'ArrowRight':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: 1,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: 0\n      };\n    case 'ArrowUp':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: 0,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: 1\n      };\n    case '+':\n    case '-':\n    case '=':\n      return { event, key: event.key, kind: 'zoom' };\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";AA0BA,IAAa,IAAb,MAA0E;CACxE;CAEA,YAAY,GAAsB;EAEhC,AADA,KAAK,KAAQ,GACb,EAAK,cAAc,IAAI;CACzB;CAEA,gBAAsB;EACpB,KAAK,GAAM,iBAAiB,WAAW,KAAK,EAAc;CAC5D;CAEA,mBAAyB;EACvB,KAAK,GAAM,oBAAoB,WAAW,KAAK,EAAc;CAC/D;CAEA,MAAkB,MAA+B;EAC/C,IAAI,EAAM,aAAa,CAAC,CAAC,OAAO,KAAK,IAAO;EAC5C,IAAM,IAAU,EAAqB,CAAK;EACrC,KACL,KAAK,GAAM,cACT,IAAI,YAA+B,WAAW;GAC5C,SAAS;GACT,YAAY;GACZ,UAAU;GACV,QAAQ;EACV,CAAC,CACH;CACF;AACF;AAEA,SAAS,EAAqB,GAAqD;CACjF,QAAQ,EAAM,KAAd;EACE,KAAK,aACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK,aACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK,cACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK,WACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK;EACL,KAAK;EACL,KAAK,KACH,OAAO;GAAE;GAAO,KAAK,EAAM;GAAK,MAAM;EAAO;EAC/C,SACE;CACJ;AACF"}
+{"version":3,"file":"keynav-spatial.controller.js","names":[],"sources":["../../../src/internal/controllers/keynav-spatial.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\ntype SpatialKeyHost = ReactiveControllerHost & HTMLElement;\n\nexport type SpatialKeyHandling = 'handled' | 'ignored';\n\nexport interface KeyNavigationSpatialControllerOptions {\n  readonly isEnabled?: () => boolean;\n}\n\nexport type SpatialKeyCommand =\n  | {\n      readonly ctrlKey: boolean;\n      readonly event: KeyboardEvent;\n      readonly kind: 'direction';\n      readonly horizontal: -1 | 0 | 1;\n      readonly key: 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp';\n      readonly shiftKey: boolean;\n      readonly vertical: -1 | 0 | 1;\n    }\n  | {\n      readonly event: KeyboardEvent;\n      readonly kind: 'zoom';\n      readonly key: '+' | '-' | '=';\n    };\n\n/** Converts direct-host keyboard input into spatial direction and zoom commands. */\nexport class KeyNavigationSpatialController implements ReactiveController {\n  readonly #host: SpatialKeyHost;\n  readonly #isEnabled: () => boolean;\n\n  constructor(host: SpatialKeyHost, { isEnabled = () => true }: KeyNavigationSpatialControllerOptions = {}) {\n    this.#host = host;\n    this.#isEnabled = isEnabled;\n    host.addController(this);\n  }\n\n  hostConnected(): void {\n    this.#host.addEventListener('keydown', this.#handleKeydown);\n  }\n\n  hostDisconnected(): void {\n    this.#host.removeEventListener('keydown', this.#handleKeydown);\n  }\n\n  #handleKeydown = (event: KeyboardEvent): void => {\n    if (!this.#isEnabled() || event.composedPath()[0] !== this.#host) return;\n    const command = getSpatialKeyCommand(event);\n    if (!command) return;\n    this.#host.dispatchEvent(\n      new CustomEvent<SpatialKeyCommand>('nve-key', {\n        bubbles: false,\n        cancelable: false,\n        composed: false,\n        detail: command\n      })\n    );\n  };\n}\n\nfunction getSpatialKeyCommand(event: KeyboardEvent): SpatialKeyCommand | undefined {\n  switch (event.key) {\n    case 'ArrowDown':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: 0,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: -1\n      };\n    case 'ArrowLeft':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: -1,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: 0\n      };\n    case 'ArrowRight':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: 1,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: 0\n      };\n    case 'ArrowUp':\n      return {\n        ctrlKey: event.ctrlKey,\n        event,\n        horizontal: 0,\n        key: event.key,\n        kind: 'direction',\n        shiftKey: event.shiftKey,\n        vertical: 1\n      };\n    case '+':\n    case '-':\n    case '=':\n      return { event, key: event.key, kind: 'zoom' };\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";AA8BA,IAAa,IAAb,MAA0E;CACxE;CACA;CAEA,YAAY,GAAsB,EAAE,qBAAkB,OAAgD,CAAC,GAAG;EAGxG,AAFA,KAAK,KAAQ,GACb,KAAK,KAAa,GAClB,EAAK,cAAc,IAAI;CACzB;CAEA,gBAAsB;EACpB,KAAK,GAAM,iBAAiB,WAAW,KAAK,EAAc;CAC5D;CAEA,mBAAyB;EACvB,KAAK,GAAM,oBAAoB,WAAW,KAAK,EAAc;CAC/D;CAEA,MAAkB,MAA+B;EAC/C,IAAI,CAAC,KAAK,GAAW,KAAK,EAAM,aAAa,CAAC,CAAC,OAAO,KAAK,IAAO;EAClE,IAAM,IAAU,EAAqB,CAAK;EACrC,KACL,KAAK,GAAM,cACT,IAAI,YAA+B,WAAW;GAC5C,SAAS;GACT,YAAY;GACZ,UAAU;GACV,QAAQ;EACV,CAAC,CACH;CACF;AACF;AAEA,SAAS,EAAqB,GAAqD;CACjF,QAAQ,EAAM,KAAd;EACE,KAAK,aACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK,aACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK,cACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK,WACH,OAAO;GACL,SAAS,EAAM;GACf;GACA,YAAY;GACZ,KAAK,EAAM;GACX,MAAM;GACN,UAAU,EAAM;GAChB,UAAU;EACZ;EACF,KAAK;EACL,KAAK;EACL,KAAK,KACH,OAAO;GAAE;GAAO,KAAK,EAAM;GAAK,MAAM;EAAO;EAC/C,SACE;CACJ;AACF"}

package/dist/internal/index.d.ts

@@ -4,6 +4,7 @@
 export * from './controllers/audit.controller.js';
 export * from './controllers/gesture.controller.js';
 export * from './controllers/i18n.controller.js';
+export * from './controllers/key-state.controller.js';
 export * from './controllers/keynav-grid.controller.js';
 export * from './controllers/keynav-list.controller.js';
 export * from './controllers/keynav-spatial.controller.js';
@@ -34,4 +35,5 @@ export * from './utils/objects.js';
 export * from './utils/strings.js';
 export * from './utils/focus.js';
 export * from './utils/keynav.js';
+export * from './utils/numeric.js';
 export * from './utils/supports.js';

package/dist/internal/index.js

@@ -6,30 +6,32 @@ import { AuditController as p, audit as m, excessiveInstanceLimit as h } from ".
 import { GestureController as g } from "./controllers/gesture.controller.js";
 import { I18nService as _, I18nService_ as v } from "./services/i18n.service.js";
 import { I18nController as y, i18n as b } from "./controllers/i18n.controller.js";
-import { debounce as x, onChildListMutation as S, stopEvent as C, throttle as w } from "./utils/events.js";
-import { LogService as T } from "./services/log.service.js";
-import { focusElement as E, focusElementTimeout as D, getActiveElement as O, initializeKeyListItems as k, isFocusable as A, isSimpleFocusable as j, onListboxActivate as M, setActiveKeyListItem as N } from "./utils/focus.js";
-import { KeynavCode as P, appendAnchorName as F, appendRootNodeStyle as I, applySlotContentStates as L, clickOutsideElementBounds as R, createGhostElement as z, define as B, defineElement as V, endOfScrollBox as H, generateId as U, getAnchorNames as W, getAttributeChanges as G, getAttributeListChanges as K, getChildren as q, getDisplayValue as J, getElementUpdate as Y, getFlattenedDOMTree as X, getFlattenedFocusableItems as Z, getPropertyChanges as Q, getThemeTokens as $, hasHorizontalScrollBar as ee, hasInvalidDOMGrid as te, hasScrollBar as ne, isContextMenuClick as re, matchesElementName as ie, openEyeDropper as ae, parseTokenNumber as oe, removeAnchorName as se, removeEmptySlotWhitespace as ce, removeEmptyTextNode as le, sameOrderedStringArray as ue, sameRenderRoot as de, scrollBarWidth as fe, slotContainsOnlyWhitespace as pe, styleSheetToString as me, supportsScopedRegistry as he, uniqueNonEmptyStrings as ge, validKeyNavigationCode as _e } from "./utils/dom.js";
-import { KeyNavigationGridController as ve, getNextKeyGridItem as ye, keyNavigationGrid as be } from "./controllers/keynav-grid.controller.js";
-import { KeyNavigationListController as xe, getNextKeyListItem as Se, keyNavigationList as Ce } from "./controllers/keynav-list.controller.js";
-import { KeyNavigationSpatialController as we } from "./controllers/keynav-spatial.controller.js";
-import { associateAriaDescribedBy as Te, associateAriaLabel as Ee, associateControlGroup as De, associateDataList as Oe, associateLabel as ke, attachInternals as Ae } from "./utils/a11y.js";
-import { StateExpandedController as je, stateExpanded as Me } from "./controllers/state-expanded.controller.js";
-import { StateHighlightedController as Ne, stateHighlighted as Pe } from "./controllers/state-highlighted.controller.js";
-import { StateScrollController as Fe, stateScroll as Ie } from "./controllers/state-scroll.controller.js";
-import { StateSelectedController as Le, stateSelected as Re } from "./controllers/state-selected.controller.js";
-import { TypeAnchorController as ze, typeAnchor as Be } from "./controllers/type-anchor.controller.js";
-import { TypeClosableController as Ve } from "./controllers/type-closable.controller.js";
-import { TypeExpandableController as He } from "./controllers/type-expandable.controller.js";
-import { TypeSelectableController as Ue } from "./controllers/type-selectable.controller.js";
-import { TypeNativePopoverController as We } from "./controllers/type-native-popover.controller.js";
-import { TypeSSRController as Ge, typeSSR as Ke } from "./controllers/type-ssr.controller.js";
-import { hostAttr as qe } from "./decorators/host-attr.js";
-import { scopedRegistry as Je } from "./decorators/scoped-registry.js";
-import { colorStateStyles as Ye, statusStateStyles as Xe, supportStateStyles as Ze, useStyles as Qe } from "./styles/index.js";
-import { supportsCSSLegacyInsetArea as $e, supportsCSSPositionArea as et, supportsNativeCSSAnchorPosition as tt } from "./utils/supports.js";
-import { popoverStyles as nt } from "./styles/popover2.js";
-import { TransitionService as rt } from "./services/transition.service.js";
-import { statusIcons as it } from "./types/index.js";
-import { createLightDismiss as at, onKeys as ot } from "./utils/keynav.js";
-export { p as AuditController, e as DOCS_URL, g as GestureController, l as GlobalState, u as GlobalStateService, y as I18nController, _ as I18nService, v as I18nService_, ve as KeyNavigationGridController, xe as KeyNavigationListController, we as KeyNavigationSpatialController, P as KeynavCode, T as LogService, je as StateExpandedController, Ne as StateHighlightedController, Fe as StateScrollController, Le as StateSelectedController, rt as TransitionService, ze as TypeAnchorController, Ve as TypeClosableController, He as TypeExpandableController, We as TypeNativePopoverController, Ge as TypeSSRController, Ue as TypeSelectableController, F as appendAnchorName, I as appendRootNodeStyle, L as applySlotContentStates, Te as associateAriaDescribedBy, Ee as associateAriaLabel, De as associateControlGroup, Oe as associateDataList, ke as associateLabel, Ae as attachInternals, m as audit, d as auditParentElement, f as auditSlots, R as clickOutsideElementBounds, Ye as colorStateStyles, z as createGhostElement, at as createLightDismiss, x as debounce, r as deepMerge, B as define, V as defineElement, H as endOfScrollBox, h as excessiveInstanceLimit, E as focusElement, D as focusElementTimeout, t as formatFileSize, i as formatStandardNumber, U as generateId, O as getActiveElement, W as getAnchorNames, G as getAttributeChanges, K as getAttributeListChanges, q as getChildren, a as getDifference, J as getDisplayValue, Y as getElementUpdate, X as getFlattenedDOMTree, Z as getFlattenedFocusableItems, ye as getNextKeyGridItem, Se as getNextKeyListItem, Q as getPropertyChanges, $ as getThemeTokens, ee as hasHorizontalScrollBar, te as hasInvalidDOMGrid, ne as hasScrollBar, qe as hostAttr, b as i18n, k as initializeKeyListItems, re as isContextMenuClick, A as isFocusable, o as isObject, s as isObjectLiteral, j as isSimpleFocusable, be as keyNavigationGrid, Ce as keyNavigationList, ie as matchesElementName, S as onChildListMutation, ot as onKeys, M as onListboxActivate, ae as openEyeDropper, oe as parseTokenNumber, c as parseVersion, nt as popoverStyles, se as removeAnchorName, ce as removeEmptySlotWhitespace, le as removeEmptyTextNode, ue as sameOrderedStringArray, de as sameRenderRoot, Je as scopedRegistry, fe as scrollBarWidth, N as setActiveKeyListItem, n as shiftLeft, pe as slotContainsOnlyWhitespace, Me as stateExpanded, Pe as stateHighlighted, Ie as stateScroll, Re as stateSelected, it as statusIcons, Xe as statusStateStyles, C as stopEvent, me as styleSheetToString, Ze as supportStateStyles, $e as supportsCSSLegacyInsetArea, et as supportsCSSPositionArea, tt as supportsNativeCSSAnchorPosition, he as supportsScopedRegistry, w as throttle, Be as typeAnchor, Ke as typeSSR, ge as uniqueNonEmptyStrings, Qe as useStyles, _e as validKeyNavigationCode };
+import { KeyStateController as x } from "./controllers/key-state.controller.js";
+import { debounce as S, onChildListMutation as C, stopEvent as w, throttle as T } from "./utils/events.js";
+import { LogService as E } from "./services/log.service.js";
+import { focusElement as D, focusElementTimeout as O, getActiveElement as k, initializeKeyListItems as A, isFocusable as j, isImmediateRootActiveElement as M, isSimpleFocusable as N, onListboxActivate as P, setActiveKeyListItem as F } from "./utils/focus.js";
+import { KeynavCode as I, appendAnchorName as L, appendRootNodeStyle as R, applySlotContentStates as z, clickOutsideElementBounds as B, createGhostElement as V, define as H, defineElement as U, endOfScrollBox as W, generateId as G, getAnchorNames as K, getAttributeChanges as q, getAttributeListChanges as J, getChildren as Y, getCustomElementRegistry as X, getDisplayValue as Z, getElementUpdate as Q, getFlattenedDOMTree as $, getFlattenedFocusableItems as ee, getPropertyChanges as te, getThemeTokens as ne, hasHorizontalScrollBar as re, hasInvalidDOMGrid as ie, hasScrollBar as ae, isContextMenuClick as oe, matchesElementName as se, openEyeDropper as ce, parseTokenNumber as le, removeAnchorName as ue, removeEmptySlotWhitespace as de, removeEmptyTextNode as fe, sameOrderedStringArray as pe, sameRenderRoot as me, scrollBarWidth as he, slotContainsOnlyWhitespace as ge, styleSheetToString as _e, supportsScopedRegistry as ve, uniqueNonEmptyStrings as ye, validKeyNavigationCode as be } from "./utils/dom.js";
+import { KeyNavigationGridController as xe, getNextKeyGridItem as Se, keyNavigationGrid as Ce } from "./controllers/keynav-grid.controller.js";
+import { KeyNavigationListController as we, getNextKeyListItem as Te, keyNavigationList as Ee } from "./controllers/keynav-list.controller.js";
+import { KeyNavigationSpatialController as De } from "./controllers/keynav-spatial.controller.js";
+import { associateAriaDescribedBy as Oe, associateAriaLabel as ke, associateControlGroup as Ae, associateDataList as je, associateLabel as Me, attachInternals as Ne } from "./utils/a11y.js";
+import { StateExpandedController as Pe, stateExpanded as Fe } from "./controllers/state-expanded.controller.js";
+import { StateHighlightedController as Ie, stateHighlighted as Le } from "./controllers/state-highlighted.controller.js";
+import { StateScrollController as Re, stateScroll as ze } from "./controllers/state-scroll.controller.js";
+import { StateSelectedController as Be, stateSelected as Ve } from "./controllers/state-selected.controller.js";
+import { TypeAnchorController as He, typeAnchor as Ue } from "./controllers/type-anchor.controller.js";
+import { TypeClosableController as We } from "./controllers/type-closable.controller.js";
+import { TypeExpandableController as Ge } from "./controllers/type-expandable.controller.js";
+import { TypeSelectableController as Ke } from "./controllers/type-selectable.controller.js";
+import { TypeNativePopoverController as qe } from "./controllers/type-native-popover.controller.js";
+import { TypeSSRController as Je, typeSSR as Ye } from "./controllers/type-ssr.controller.js";
+import { hostAttr as Xe } from "./decorators/host-attr.js";
+import { scopedRegistry as Ze } from "./decorators/scoped-registry.js";
+import { colorStateStyles as Qe, statusStateStyles as $e, supportStateStyles as et, useStyles as tt } from "./styles/index.js";
+import { supportsCSSLegacyInsetArea as nt, supportsCSSPositionArea as rt, supportsNativeCSSAnchorPosition as it } from "./utils/supports.js";
+import { popoverStyles as at } from "./styles/popover2.js";
+import { TransitionService as ot } from "./services/transition.service.js";
+import { statusIcons as st } from "./types/index.js";
+import { createLightDismiss as ct, onKeys as lt } from "./utils/keynav.js";
+import { finiteOr as ut, nonnegativeFiniteOr as dt, positiveFiniteOr as ft } from "./utils/numeric.js";
+export { p as AuditController, e as DOCS_URL, g as GestureController, l as GlobalState, u as GlobalStateService, y as I18nController, _ as I18nService, v as I18nService_, xe as KeyNavigationGridController, we as KeyNavigationListController, De as KeyNavigationSpatialController, x as KeyStateController, I as KeynavCode, E as LogService, Pe as StateExpandedController, Ie as StateHighlightedController, Re as StateScrollController, Be as StateSelectedController, ot as TransitionService, He as TypeAnchorController, We as TypeClosableController, Ge as TypeExpandableController, qe as TypeNativePopoverController, Je as TypeSSRController, Ke as TypeSelectableController, L as appendAnchorName, R as appendRootNodeStyle, z as applySlotContentStates, Oe as associateAriaDescribedBy, ke as associateAriaLabel, Ae as associateControlGroup, je as associateDataList, Me as associateLabel, Ne as attachInternals, m as audit, d as auditParentElement, f as auditSlots, B as clickOutsideElementBounds, Qe as colorStateStyles, V as createGhostElement, ct as createLightDismiss, S as debounce, r as deepMerge, H as define, U as defineElement, W as endOfScrollBox, h as excessiveInstanceLimit, ut as finiteOr, D as focusElement, O as focusElementTimeout, t as formatFileSize, i as formatStandardNumber, G as generateId, k as getActiveElement, K as getAnchorNames, q as getAttributeChanges, J as getAttributeListChanges, Y as getChildren, X as getCustomElementRegistry, a as getDifference, Z as getDisplayValue, Q as getElementUpdate, $ as getFlattenedDOMTree, ee as getFlattenedFocusableItems, Se as getNextKeyGridItem, Te as getNextKeyListItem, te as getPropertyChanges, ne as getThemeTokens, re as hasHorizontalScrollBar, ie as hasInvalidDOMGrid, ae as hasScrollBar, Xe as hostAttr, b as i18n, A as initializeKeyListItems, oe as isContextMenuClick, j as isFocusable, M as isImmediateRootActiveElement, o as isObject, s as isObjectLiteral, N as isSimpleFocusable, Ce as keyNavigationGrid, Ee as keyNavigationList, se as matchesElementName, dt as nonnegativeFiniteOr, C as onChildListMutation, lt as onKeys, P as onListboxActivate, ce as openEyeDropper, le as parseTokenNumber, c as parseVersion, at as popoverStyles, ft as positiveFiniteOr, ue as removeAnchorName, de as removeEmptySlotWhitespace, fe as removeEmptyTextNode, pe as sameOrderedStringArray, me as sameRenderRoot, Ze as scopedRegistry, he as scrollBarWidth, F as setActiveKeyListItem, n as shiftLeft, ge as slotContainsOnlyWhitespace, Fe as stateExpanded, Le as stateHighlighted, ze as stateScroll, Ve as stateSelected, st as statusIcons, $e as statusStateStyles, w as stopEvent, _e as styleSheetToString, et as supportStateStyles, nt as supportsCSSLegacyInsetArea, rt as supportsCSSPositionArea, it as supportsNativeCSSAnchorPosition, ve as supportsScopedRegistry, T as throttle, Ue as typeAnchor, Ye as typeSSR, ye as uniqueNonEmptyStrings, tt as useStyles, be as validKeyNavigationCode };

package/dist/internal/services/global.service.js

@@ -19,7 +19,7 @@ var a = class {
 				i18nRegistry: {},
 				audit: {}
 			}
-		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(/* @__PURE__ */ new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.8.1"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.8.1"] = i(), globalThis.NVE_ELEMENTS.state.versions.length > 1 && globalThis.NVE_ELEMENTS.state.env !== "production" && console.warn(e(), `\n\n${JSON.stringify(globalThis.NVE_ELEMENTS.state.versions, null, 2)}`);
+		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(/* @__PURE__ */ new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.9.0"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.9.0"] = i(), globalThis.NVE_ELEMENTS.state.versions.length > 1 && globalThis.NVE_ELEMENTS.state.env !== "production" && console.warn(e(), `\n\n${JSON.stringify(globalThis.NVE_ELEMENTS.state.versions, null, 2)}`);
 	}
 	get state() {
 		return globalThis.NVE_ELEMENTS.state;

package/dist/internal/utils/dom.d.ts

@@ -16,6 +16,7 @@ export declare function getElementUpdate(element: HTMLElement, key: string, call
 export declare function clickOutsideElementBounds(event: PointerEvent | MouseEvent, element: HTMLElement): boolean;
 /** parses number out of basic calc generated by the design tokens */
 export declare function parseTokenNumber(value: string): number;
+export declare function getCustomElementRegistry(element: Element): CustomElementRegistry | undefined;
 /** true if the browser supports scoped custom element registries */
 export declare const supportsScopedRegistry: boolean;
 /** defines an element with the given custom element registry */

package/dist/internal/utils/dom.js

@@ -78,53 +78,57 @@ function d(e, t) {
 function f(e) {
 	return parseInt(e.includes("calc") ? e.split("*")[1].replace("px)", "").trim() : e, 10) || 0;
 }
-var p = globalThis.CustomElementRegistry && "initialize" in CustomElementRegistry.prototype;
-function m(t, n) {
+function p(e) {
+	let t = e.getRootNode(), n = e.ownerDocument.defaultView?.CustomElementRegistry ?? globalThis.CustomElementRegistry;
+	return n && "customElementRegistry" in t && t.customElementRegistry instanceof n ? t.customElementRegistry : e.ownerDocument.defaultView?.customElements || (typeof customElements > "u" ? void 0 : customElements);
+}
+var m = globalThis.CustomElementRegistry && "initialize" in CustomElementRegistry.prototype;
+function h(t, n) {
 	Object.entries(t.elementDefinitions ?? {}).filter(([e, t]) => !n.get(t.metadata.tag)).forEach(([e, t]) => {
-		m(t, n);
+		h(t, n);
 	}), n.get(t.metadata.tag) || (n.define(t.metadata.tag, t), n === customElements && e.dispatch("NVE_ELEMENT_DEFINE", { elementRegistry: { [t.metadata.tag]: t.metadata.version } }));
 }
-function h(t) {
+function g(t) {
 	let { version: n } = t.metadata;
-	p && !customElements.get(t.metadata.tag) ? (customElements.define(t.metadata.tag, t), e.dispatch("NVE_ELEMENT_DEFINE", { elementRegistry: { [t.metadata.tag]: t.metadata.version } })) : m(t, customElements), e.state.elementRegistry[t.metadata.tag] !== n && globalThis?.location?.hostname === "localhost" && import("./audit-logs.js").then((e) => console.warn(e.getDuplicatePackageVersionWarning(t.metadata.tag, n)));
+	m && !customElements.get(t.metadata.tag) ? (customElements.define(t.metadata.tag, t), e.dispatch("NVE_ELEMENT_DEFINE", { elementRegistry: { [t.metadata.tag]: t.metadata.version } })) : h(t, customElements), e.state.elementRegistry[t.metadata.tag] !== n && globalThis?.location?.hostname === "localhost" && import("./audit-logs.js").then((e) => console.warn(e.getDuplicatePackageVersionWarning(t.metadata.tag, n)));
 }
-function g(e) {
+function _(e) {
 	return e.buttons === 2 && !e.ctrlKey || e.buttons === 1 && e.ctrlKey;
 }
-function _(e, t = 10) {
-	return v(e, t).filter((e) => n(e));
-}
 function v(e, t = 10) {
-	return Array.from(r(e)).reduce((e, n) => [...e, [n, [...Array.from(r(n)).map((e) => [e, v(e, t)])]]], []).flat(t);
+	return y(e, t).filter((e) => n(e));
 }
-function y(e) {
-	return x.has(e.code);
+function y(e, t = 10) {
+	return Array.from(r(e)).reduce((e, n) => [...e, [n, [...Array.from(r(n)).map((e) => [e, y(e, t)])]]], []).flat(t);
 }
-var b = /* @__PURE__ */ function(e) {
+function b(e) {
+	return S.has(e.code);
+}
+var x = /* @__PURE__ */ function(e) {
 	return e.End = "End", e.Home = "Home", e.PageUp = "PageUp", e.PageDown = "PageDown", e.ArrowUp = "ArrowUp", e.ArrowDown = "ArrowDown", e.ArrowLeft = "ArrowLeft", e.ArrowRight = "ArrowRight", e;
-}({}), x = new Set(Object.values(b));
-function S(e) {
+}({}), S = new Set(Object.values(x));
+function C(e) {
 	return e.some((t) => t.children.length !== e[0].children.length);
 }
-function C(e) {
+function w(e) {
 	e?.wholeText?.trim() === "" && e.remove();
 }
-function w() {
+function T() {
 	let e = globalThis.document.createElement("div");
 	e.style.setProperty("width", "100px"), e.style.setProperty("height", "100px"), e.style.setProperty("overflow", "scroll"), e.style.setProperty("position", "absolute"), e.style.setProperty("top", "-9999px"), globalThis.document.body.appendChild(e);
 	let t = e.offsetWidth - e.clientWidth;
 	return globalThis.document.body.removeChild(e), t;
 }
-function T(e) {
+function E(e) {
 	return e.scrollHeight > e.clientHeight;
 }
-function E(e) {
+function D(e) {
 	return e.scrollWidth > e.clientWidth;
 }
-function D(e, t = 0) {
+function O(e, t = 0) {
 	return e.scrollTop + e.offsetHeight + t >= e.scrollHeight;
 }
-async function O() {
+async function k() {
 	let e = globalThis.EyeDropper;
 	if (!e) return t.warn("EyeDropper API is unavailable"), "";
 	try {
@@ -133,7 +137,7 @@ async function O() {
 		return t.warn(`EyeDropper selection failed: ${e.message}`), "";
 	}
 }
-function k(e = globalThis.document.querySelector(":root")) {
+function A(e = globalThis.document.querySelector(":root")) {
 	let t = getComputedStyle(e), n = [];
 	try {
 		n = Array.from(globalThis.parent.document.styleSheets);
@@ -152,48 +156,48 @@ function k(e = globalThis.document.querySelector(":root")) {
 		[n[0]]: t.getPropertyValue(n[0])
 	}), {});
 }
-function A(e) {
-	j(e) && e.assignedNodes().forEach((e) => e.parentNode?.removeChild(e));
-}
 function j(e) {
+	M(e) && e.assignedNodes().forEach((e) => e.parentNode?.removeChild(e));
+}
+function M(e) {
 	let t = !e.assignedNodes().find((e) => e.nodeType !== Node.TEXT_NODE), n = !e.assignedNodes().find((e) => e.nodeType === Node.TEXT_NODE && (e.textContent ?? "").trim() !== "");
 	return t && n;
 }
-function M(e, t) {
+function N(e, t) {
 	let n = e.assignedNodes(), r = e.name ?? "slot";
 	n.length ? t._internals.states.add(`has-${r}`) : t._internals.states.delete(`has-${r}`);
 }
-function N(e) {
+function P(e) {
 	return e?.label || e?.value || "";
 }
-function P(e, t) {
+function F(e, t) {
 	return e.localName === t.metadata.tag;
 }
-function F(e) {
+function I(e) {
 	let t = globalThis.document.createElement("div"), { width: n } = e.getBoundingClientRect();
 	return t.setAttribute("nve-ghost", ""), t.style.minWidth = `${n}px`, t.style.maxWidth = `${n}px`, t.style.height = "1px", t.slot = e.slot, t;
 }
-function I(e, t) {
+function L(e, t) {
 	let n = e.getRootNode(), r = t.getRootNode(), i = n instanceof ShadowRoot && r instanceof ShadowRoot && n === r, a = n === globalThis.document && r === globalThis.document;
 	return i || a || n === r;
 }
-function L(e) {
+function R(e) {
 	return e.style.anchorName?.split(",")?.map((e) => e.trim())?.filter((e) => e !== "none" && e !== "") ?? [];
 }
-function R(e, t) {
-	let n = L(e);
-	e.style.anchorName = n.filter((e) => e !== t).join(",");
-}
 function z(e, t) {
-	e.style.anchorName = Array.from(/* @__PURE__ */ new Set([...L(e), t])).join(",");
+	let n = R(e);
+	e.style.anchorName = n.filter((e) => e !== t).join(",");
 }
 function B(e, t) {
+	e.style.anchorName = Array.from(/* @__PURE__ */ new Set([...R(e), t])).join(",");
+}
+function V(e, t) {
 	return e.length === t.length && e.every((e, n) => e === t[n]);
 }
-function V(e) {
+function H(e) {
 	return Array.from(new Set(Array.from(e).filter((e) => typeof e == "string" && e.length > 0)));
 }
 //#endregion
-export { b as KeynavCode, z as appendAnchorName, s as appendRootNodeStyle, M as applySlotContentStates, d as clickOutsideElementBounds, F as createGhostElement, h as define, m as defineElement, D as endOfScrollBox, i as generateId, L as getAnchorNames, a as getAttributeChanges, o as getAttributeListChanges, r as getChildren, N as getDisplayValue, u as getElementUpdate, v as getFlattenedDOMTree, _ as getFlattenedFocusableItems, l as getPropertyChanges, k as getThemeTokens, E as hasHorizontalScrollBar, S as hasInvalidDOMGrid, T as hasScrollBar, g as isContextMenuClick, P as matchesElementName, O as openEyeDropper, f as parseTokenNumber, R as removeAnchorName, A as removeEmptySlotWhitespace, C as removeEmptyTextNode, B as sameOrderedStringArray, I as sameRenderRoot, w as scrollBarWidth, j as slotContainsOnlyWhitespace, c as styleSheetToString, p as supportsScopedRegistry, V as uniqueNonEmptyStrings, y as validKeyNavigationCode };
+export { x as KeynavCode, B as appendAnchorName, s as appendRootNodeStyle, N as applySlotContentStates, d as clickOutsideElementBounds, I as createGhostElement, g as define, h as defineElement, O as endOfScrollBox, i as generateId, R as getAnchorNames, a as getAttributeChanges, o as getAttributeListChanges, r as getChildren, p as getCustomElementRegistry, P as getDisplayValue, u as getElementUpdate, y as getFlattenedDOMTree, v as getFlattenedFocusableItems, l as getPropertyChanges, A as getThemeTokens, D as hasHorizontalScrollBar, C as hasInvalidDOMGrid, E as hasScrollBar, _ as isContextMenuClick, F as matchesElementName, k as openEyeDropper, f as parseTokenNumber, z as removeAnchorName, j as removeEmptySlotWhitespace, w as removeEmptyTextNode, V as sameOrderedStringArray, L as sameRenderRoot, T as scrollBarWidth, M as slotContainsOnlyWhitespace, c as styleSheetToString, m as supportsScopedRegistry, H as uniqueNonEmptyStrings, b as validKeyNavigationCode };
 
 //# sourceMappingURL=dom.js.map

package/dist/internal/utils/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","names":[],"sources":["../../../src/internal/utils/dom.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from '../services/global.service.js';\nimport { LogService } from '../services/log.service.js';\nimport type { ElementDefinition } from '../types/index.js';\nimport { isFocusable } from './focus.js';\n\nexport function getChildren(node: Document | Node | HTMLElement): Element[] {\n  if (node instanceof Document && node.documentElement) {\n    return Array.from(node.documentElement.children); // root document children\n  } else if (node instanceof HTMLElement && node.shadowRoot) {\n    return Array.from(node.shadowRoot.children); // shadow root direct children\n  } else if (node instanceof HTMLSlotElement && node.assignedElements) {\n    const slotted = node.assignedElements(); // slotted elements\n    return slotted.length ? slotted : Array.from(node.children); // slot fallback\n  } else {\n    return Array.from((node as HTMLElement).children); // light DOM direct children\n  }\n}\n\nexport function generateId() {\n  const uint32 = self.crypto.getRandomValues(new Uint32Array(1))[0]!;\n  return `_${uint32.toString(16)}`;\n}\n\nexport function getAttributeChanges(element: HTMLElement, attr: string, fn: (attrValue: string | null) => void) {\n  fn(element.getAttribute(attr));\n  const observer = new MutationObserver(mutations => {\n    mutations.forEach(mutation => {\n      if (mutation.attributeName === attr) {\n        fn((mutation.target as HTMLElement).getAttribute(attr));\n      }\n    });\n  });\n  observer.observe(element, { attributes: true, subtree: true });\n  return observer;\n}\n\nexport function getAttributeListChanges(element: HTMLElement, attrs: string[], fn: (mutation: MutationRecord) => void) {\n  const observer = new MutationObserver(mutations => {\n    mutations.forEach(mutation => {\n      if (mutation.attributeName && attrs.includes(mutation.attributeName)) {\n        fn(mutation);\n      }\n    });\n  });\n  observer.observe(element, { attributes: true, subtree: true });\n  return observer;\n}\n\n/**\n * Appends styles to the render root of a given element. This is useful for\n * styles that apply outside the scope of the element's shadow\n * root such as UA styles --webkit-* that won't work in a ::slotted selector\n */\nexport function appendRootNodeStyle(host: HTMLElement, styles: string) {\n  const stylesheet = new CSSStyleSheet();\n  stylesheet.replaceSync(styles);\n  const root = host.getRootNode() as Document | ShadowRoot;\n  if (root.adoptedStyleSheets) {\n    const hasStyleSheet = root.adoptedStyleSheets\n      .map(s => styleSheetToString(s))\n      .find(s => s === styleSheetToString(stylesheet));\n    if (!hasStyleSheet) {\n      root.adoptedStyleSheets = [...Array.from(root.adoptedStyleSheets), stylesheet];\n    }\n  }\n  return stylesheet;\n}\n\nexport function styleSheetToString(stylesheet: CSSStyleSheet) {\n  return stylesheet.cssRules\n    ? Array.from(stylesheet.cssRules)\n        .map(rule => rule.cssText || '')\n        .join('\\n')\n    : '';\n}\n\n/** Intercepts a property setter on an element so `callback` fires on every assignment. Does not use a MutationObserver. */\nexport function getPropertyChanges(element: HTMLElement, key: string, callback: (value: unknown) => void) {\n  const proto = Object.getPrototypeOf(element);\n  const descriptor = Object.getOwnPropertyDescriptor(proto, key);\n  if (!descriptor) return;\n  const own = Object.getOwnPropertyDescriptor(element, key);\n  if (own && own.configurable === false) return;\n  Object.defineProperty(element, key, {\n    configurable: true,\n    get: descriptor.get,\n    set: (val: unknown) => {\n      descriptor.set!.call(element, val);\n      callback(val);\n    }\n  });\n\n  return () => {\n    if (own) {\n      Object.defineProperty(element, key, own);\n      return;\n    }\n\n    Reflect.deleteProperty(element, key);\n  };\n}\n\n/* used for cases of needing to know a property update outside of lit, example a native input value prop change */\nexport function getElementUpdate(element: HTMLElement, key: string, callback: (value: unknown) => void) {\n  if (element.hasAttribute(key)) {\n    callback(element.getAttribute(key));\n  } else if ((element as unknown as Record<string, unknown>)[key] !== undefined) {\n    callback((element as unknown as Record<string, unknown>)[key]);\n  }\n\n  const cleanupPropertyChanges = getPropertyChanges(element, key, callback);\n  const observer = getAttributeChanges(element, key, val => callback(val));\n  const disconnect = observer.disconnect.bind(observer);\n\n  observer.disconnect = () => {\n    cleanupPropertyChanges?.();\n    disconnect();\n  };\n\n  return observer;\n}\n\nexport function clickOutsideElementBounds(event: PointerEvent | MouseEvent, element: HTMLElement) {\n  const { left, right, top, bottom } = element.getBoundingClientRect();\n  return event.clientX < left || event.clientX > right || event.clientY < top || event.clientY > bottom;\n}\n\n/** parses number out of basic calc generated by the design tokens */\nexport function parseTokenNumber(value: string) {\n  return parseInt(value.includes('calc') ? value.split('*')[1]!.replace('px)', '').trim() : value, 10) || 0;\n}\n\n/** true if the browser supports scoped custom element registries */\nexport const supportsScopedRegistry =\n  globalThis.CustomElementRegistry && 'initialize' in CustomElementRegistry.prototype;\n\n/** defines an element with the given custom element registry */\nexport function defineElement(element: ElementDefinition, customElementRegistry: CustomElementRegistry) {\n  Object.entries(element.elementDefinitions ?? {})\n    .filter(([_tag, e]) => !customElementRegistry.get(e.metadata.tag))\n    .forEach(([_tag, e]) => {\n      defineElement(e, customElementRegistry);\n    });\n\n  if (!customElementRegistry.get(element.metadata.tag)) {\n    customElementRegistry.define(element.metadata.tag, element);\n\n    if (customElementRegistry === customElements) {\n      GlobalStateService.dispatch('NVE_ELEMENT_DEFINE', {\n        elementRegistry: { [element.metadata.tag]: element.metadata.version }\n      });\n    }\n  }\n}\n\n/** defines an element with the global custom element registry */\nexport function define(element: ElementDefinition) {\n  const { version } = element.metadata;\n\n  // if scoped registry supported, register only the root element to global registry\n  if (supportsScopedRegistry && !customElements.get(element.metadata.tag)) {\n    customElements.define(element.metadata.tag, element);\n    GlobalStateService.dispatch('NVE_ELEMENT_DEFINE', {\n      elementRegistry: { [element.metadata.tag]: element.metadata.version }\n    });\n  } else {\n    // if scoped registry not supported, register the element and all its children to the global registry\n    defineElement(element, customElements);\n  }\n\n  // warn on duplicate version\n  if (\n    GlobalStateService.state.elementRegistry[element.metadata.tag] !== version &&\n    globalThis?.location?.hostname === 'localhost'\n  ) {\n    void import('./audit-logs.js').then(m =>\n      console.warn(m.getDuplicatePackageVersionWarning(element.metadata.tag, version))\n    );\n  }\n}\n\nexport function isContextMenuClick(event: MouseEvent) {\n  return (event.buttons === 2 && !event.ctrlKey) || (event.buttons === 1 && event.ctrlKey);\n}\n\nexport function getFlattenedFocusableItems(element: Node, depth = 10) {\n  return getFlattenedDOMTree(element, depth).filter((e: HTMLElement) => isFocusable(e)) as HTMLElement[];\n}\n\n/**\n * Preserves visual DOM ordering when using slots within Shadow DOM\n * See more information/resources on Shadow DOM linear traversal\n * https://nolanlawson.com/2021/02/13/managing-focus-in-the-shadow-dom/\n * https://www.abeautifulsite.net/posts/querying-through-shadow-roots/\n */\nexport function getFlattenedDOMTree(node: Node, depth = 10): HTMLElement[] {\n  return (\n    Array.from(getChildren(node)).reduce(\n      (p: unknown[], n: Node) => [\n        ...p,\n        [n, [...Array.from(getChildren(n)).map(i => [i, getFlattenedDOMTree(i, depth)])]]\n      ],\n      []\n    ) as unknown as HTMLElement[]\n  ).flat(depth);\n}\n\nexport function validKeyNavigationCode(e: KeyboardEvent) {\n  return keynavCodes.has(e.code);\n}\n\nexport enum KeynavCode {\n  End = 'End',\n  Home = 'Home',\n  PageUp = 'PageUp',\n  PageDown = 'PageDown',\n  ArrowUp = 'ArrowUp',\n  ArrowDown = 'ArrowDown',\n  ArrowLeft = 'ArrowLeft',\n  ArrowRight = 'ArrowRight'\n}\n\nconst keynavCodes: Set<string> = new Set(Object.values(KeynavCode));\n\nexport function hasInvalidDOMGrid(rows: HTMLElement[]) {\n  return rows.some(row => row.children.length !== rows[0]!.children.length);\n}\n\nexport function removeEmptyTextNode(node: Node) {\n  if ((node as Text)?.wholeText?.trim() === '') {\n    (node as Text).remove();\n  }\n}\n\nexport function scrollBarWidth() {\n  const div = globalThis.document.createElement('div');\n  div.style.setProperty('width', '100px');\n  div.style.setProperty('height', '100px');\n  div.style.setProperty('overflow', 'scroll');\n  div.style.setProperty('position', 'absolute');\n  div.style.setProperty('top', '-9999px');\n  globalThis.document.body.appendChild(div);\n  const width = div.offsetWidth - div.clientWidth;\n  globalThis.document.body.removeChild(div);\n  return width;\n}\n\nexport function hasScrollBar(el: HTMLElement) {\n  return el.scrollHeight > el.clientHeight;\n}\n\nexport function hasHorizontalScrollBar(el: HTMLElement) {\n  return el.scrollWidth > el.clientWidth;\n}\n\nexport function endOfScrollBox(element: HTMLElement, offset = 0) {\n  return element.scrollTop + element.offsetHeight + offset >= element.scrollHeight;\n}\n\nexport async function openEyeDropper(): Promise<string> {\n  const EyeDropperConstructor = (\n    globalThis as unknown as { EyeDropper?: new () => { open: () => Promise<{ sRGBHex: string }> } }\n  ).EyeDropper;\n\n  if (!EyeDropperConstructor) {\n    LogService.warn('EyeDropper API is unavailable');\n    return '';\n  }\n\n  try {\n    return (await new EyeDropperConstructor().open()).sRGBHex;\n  } catch (e) {\n    LogService.warn(`EyeDropper selection failed: ${(e as Error).message}`);\n    return '';\n  }\n}\n\n/**\n * provides a object with key/value of the currently applied design tokens\n */\nexport function getThemeTokens(element = globalThis.document.querySelector(':root')!) {\n  // default root or provided element\n  const styles = getComputedStyle(element);\n  let parent: CSSStyleSheet[] = [];\n\n  // check for parent iframe, same domain iframes change how the browser accesses style sheets\n  try {\n    parent = Array.from(globalThis.parent.document.styleSheets);\n  } catch {\n    // if not accessible, skip\n  }\n\n  return [...parent, ...Array.from(globalThis.document.styleSheets)]\n    .reduce((finalArr: string[][], sheet) => {\n      let rules: CSSRule[] = [];\n      try {\n        rules = [...sheet.cssRules];\n      } catch {\n        // if the style sheet is not accessible, skip\n      }\n      return finalArr.concat(\n        rules\n          .filter(rule => rule.type === 1)\n          .reduce((propValArr: string[][], rule) => {\n            const props = [...(rule as CSSStyleRule).style]\n              .filter((p: string) => p.trim().includes('--nve'))\n              .map((propName: string) => [\n                propName.trim(),\n                (rule as CSSStyleRule).style.getPropertyValue(propName).trim()\n              ]);\n            return [...propValArr, ...props];\n          }, [])\n      );\n    }, [])\n    .reduce(\n      (p: Record<string, string>, token: string[]) => ({ ...p, [token[0]!]: styles.getPropertyValue(token[0]!) }),\n      {}\n    );\n}\n\nexport function removeEmptySlotWhitespace(slot: HTMLSlotElement) {\n  if (slotContainsOnlyWhitespace(slot)) {\n    slot.assignedNodes().forEach((node: Node) => node.parentNode?.removeChild(node));\n  }\n}\n\nexport function slotContainsOnlyWhitespace(slot: HTMLSlotElement) {\n  const hasNoElements = !slot.assignedNodes().find(i => i.nodeType !== Node.TEXT_NODE);\n  const hasOnlyEmptyTextNodes = !slot\n    .assignedNodes()\n    .find(i => i.nodeType === Node.TEXT_NODE && (i.textContent ?? '').trim() !== '');\n  return hasNoElements && hasOnlyEmptyTextNodes;\n}\n\nexport function applySlotContentStates(slot: HTMLSlotElement, element: HTMLElement & { _internals: ElementInternals }) {\n  const nodes = slot.assignedNodes();\n  const name = slot.name ?? 'slot';\n\n  if (nodes.length) {\n    element._internals.states.add(`has-${name}`);\n  } else {\n    element._internals.states.delete(`has-${name}`);\n  }\n}\n\nexport function getDisplayValue(option?: { label?: string; value?: string }): string {\n  return option?.label || option?.value || '';\n}\n\n/** determines if HTML element matches the given component tag */\nexport function matchesElementName(element: Partial<HTMLElement>, component: { metadata: { tag: string } }) {\n  return element.localName === component.metadata.tag;\n}\n\nexport function createGhostElement(sourceElement: HTMLElement) {\n  const ghost = globalThis.document.createElement('div');\n  const { width } = sourceElement.getBoundingClientRect();\n  ghost.setAttribute('nve-ghost', '');\n  ghost.style.minWidth = `${width}px`;\n  ghost.style.maxWidth = `${width}px`;\n  ghost.style.height = '1px';\n  ghost.slot = sourceElement.slot;\n  return ghost;\n}\n\nexport function sameRenderRoot(element1: HTMLElement, element2: HTMLElement) {\n  const root1 = element1.getRootNode();\n  const root2 = element2.getRootNode();\n  const sameShadowRoot = root1 instanceof ShadowRoot && root2 instanceof ShadowRoot && root1 === root2;\n  const sameDocumentRoot = root1 === globalThis.document && root2 === globalThis.document;\n  const sameUnattachedRoot = root1 === root2;\n  return sameShadowRoot || sameDocumentRoot || sameUnattachedRoot;\n}\n\nexport function getAnchorNames(element: HTMLElement): string[] {\n  return (\n    element.style.anchorName\n      ?.split(',')\n      ?.map(name => name.trim())\n      ?.filter(name => name !== 'none' && name !== '') ?? []\n  );\n}\n\nexport function removeAnchorName(element: HTMLElement, name: string) {\n  const anchorNames = getAnchorNames(element);\n  element.style.anchorName = anchorNames.filter(i => i !== name).join(',');\n}\n\nexport function appendAnchorName(element: HTMLElement, name: string) {\n  element.style.anchorName = Array.from(new Set([...getAnchorNames(element), name])).join(',');\n}\n\n/**\n * Returns true when both arrays have the same length and each index is strictly equal (`===`).\n */\nexport function sameOrderedStringArray(a: readonly string[], b: readonly string[]): boolean {\n  return a.length === b.length && a.every((value, index) => value === b[index]);\n}\n\n/**\n * Returns unique non-empty strings in first-seen order (insertion order of a `Set` over the filtered list).\n */\nexport function uniqueNonEmptyStrings(values: Iterable<string | null | undefined>): string[] {\n  return Array.from(\n    new Set(Array.from(values).filter((value): value is string => typeof value === 'string' && value.length > 0))\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"dom.js","names":[],"sources":["../../../src/internal/utils/dom.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from '../services/global.service.js';\nimport { LogService } from '../services/log.service.js';\nimport type { ElementDefinition } from '../types/index.js';\nimport { isFocusable } from './focus.js';\n\nexport function getChildren(node: Document | Node | HTMLElement): Element[] {\n  if (node instanceof Document && node.documentElement) {\n    return Array.from(node.documentElement.children); // root document children\n  } else if (node instanceof HTMLElement && node.shadowRoot) {\n    return Array.from(node.shadowRoot.children); // shadow root direct children\n  } else if (node instanceof HTMLSlotElement && node.assignedElements) {\n    const slotted = node.assignedElements(); // slotted elements\n    return slotted.length ? slotted : Array.from(node.children); // slot fallback\n  } else {\n    return Array.from((node as HTMLElement).children); // light DOM direct children\n  }\n}\n\nexport function generateId() {\n  const uint32 = self.crypto.getRandomValues(new Uint32Array(1))[0]!;\n  return `_${uint32.toString(16)}`;\n}\n\nexport function getAttributeChanges(element: HTMLElement, attr: string, fn: (attrValue: string | null) => void) {\n  fn(element.getAttribute(attr));\n  const observer = new MutationObserver(mutations => {\n    mutations.forEach(mutation => {\n      if (mutation.attributeName === attr) {\n        fn((mutation.target as HTMLElement).getAttribute(attr));\n      }\n    });\n  });\n  observer.observe(element, { attributes: true, subtree: true });\n  return observer;\n}\n\nexport function getAttributeListChanges(element: HTMLElement, attrs: string[], fn: (mutation: MutationRecord) => void) {\n  const observer = new MutationObserver(mutations => {\n    mutations.forEach(mutation => {\n      if (mutation.attributeName && attrs.includes(mutation.attributeName)) {\n        fn(mutation);\n      }\n    });\n  });\n  observer.observe(element, { attributes: true, subtree: true });\n  return observer;\n}\n\n/**\n * Appends styles to the render root of a given element. This is useful for\n * styles that apply outside the scope of the element's shadow\n * root such as UA styles --webkit-* that won't work in a ::slotted selector\n */\nexport function appendRootNodeStyle(host: HTMLElement, styles: string) {\n  const stylesheet = new CSSStyleSheet();\n  stylesheet.replaceSync(styles);\n  const root = host.getRootNode() as Document | ShadowRoot;\n  if (root.adoptedStyleSheets) {\n    const hasStyleSheet = root.adoptedStyleSheets\n      .map(s => styleSheetToString(s))\n      .find(s => s === styleSheetToString(stylesheet));\n    if (!hasStyleSheet) {\n      root.adoptedStyleSheets = [...Array.from(root.adoptedStyleSheets), stylesheet];\n    }\n  }\n  return stylesheet;\n}\n\nexport function styleSheetToString(stylesheet: CSSStyleSheet) {\n  return stylesheet.cssRules\n    ? Array.from(stylesheet.cssRules)\n        .map(rule => rule.cssText || '')\n        .join('\\n')\n    : '';\n}\n\n/** Intercepts a property setter on an element so `callback` fires on every assignment. Does not use a MutationObserver. */\nexport function getPropertyChanges(element: HTMLElement, key: string, callback: (value: unknown) => void) {\n  const proto = Object.getPrototypeOf(element);\n  const descriptor = Object.getOwnPropertyDescriptor(proto, key);\n  if (!descriptor) return;\n  const own = Object.getOwnPropertyDescriptor(element, key);\n  if (own && own.configurable === false) return;\n  Object.defineProperty(element, key, {\n    configurable: true,\n    get: descriptor.get,\n    set: (val: unknown) => {\n      descriptor.set!.call(element, val);\n      callback(val);\n    }\n  });\n\n  return () => {\n    if (own) {\n      Object.defineProperty(element, key, own);\n      return;\n    }\n\n    Reflect.deleteProperty(element, key);\n  };\n}\n\n/* used for cases of needing to know a property update outside of lit, example a native input value prop change */\nexport function getElementUpdate(element: HTMLElement, key: string, callback: (value: unknown) => void) {\n  if (element.hasAttribute(key)) {\n    callback(element.getAttribute(key));\n  } else if ((element as unknown as Record<string, unknown>)[key] !== undefined) {\n    callback((element as unknown as Record<string, unknown>)[key]);\n  }\n\n  const cleanupPropertyChanges = getPropertyChanges(element, key, callback);\n  const observer = getAttributeChanges(element, key, val => callback(val));\n  const disconnect = observer.disconnect.bind(observer);\n\n  observer.disconnect = () => {\n    cleanupPropertyChanges?.();\n    disconnect();\n  };\n\n  return observer;\n}\n\nexport function clickOutsideElementBounds(event: PointerEvent | MouseEvent, element: HTMLElement) {\n  const { left, right, top, bottom } = element.getBoundingClientRect();\n  return event.clientX < left || event.clientX > right || event.clientY < top || event.clientY > bottom;\n}\n\n/** parses number out of basic calc generated by the design tokens */\nexport function parseTokenNumber(value: string) {\n  return parseInt(value.includes('calc') ? value.split('*')[1]!.replace('px)', '').trim() : value, 10) || 0;\n}\n\nexport function getCustomElementRegistry(element: Element): CustomElementRegistry | undefined {\n  const root = element.getRootNode();\n  const CustomElementRegistryConstructor =\n    element.ownerDocument.defaultView?.CustomElementRegistry ?? globalThis.CustomElementRegistry;\n  if (\n    CustomElementRegistryConstructor &&\n    'customElementRegistry' in root &&\n    root.customElementRegistry instanceof CustomElementRegistryConstructor\n  ) {\n    return root.customElementRegistry;\n  }\n  const documentRegistry = element.ownerDocument.defaultView?.customElements;\n  if (documentRegistry) return documentRegistry;\n  return typeof customElements === 'undefined' ? undefined : customElements;\n}\n\n/** true if the browser supports scoped custom element registries */\nexport const supportsScopedRegistry =\n  globalThis.CustomElementRegistry && 'initialize' in CustomElementRegistry.prototype;\n\n/** defines an element with the given custom element registry */\nexport function defineElement(element: ElementDefinition, customElementRegistry: CustomElementRegistry) {\n  Object.entries(element.elementDefinitions ?? {})\n    .filter(([_tag, e]) => !customElementRegistry.get(e.metadata.tag))\n    .forEach(([_tag, e]) => {\n      defineElement(e, customElementRegistry);\n    });\n\n  if (!customElementRegistry.get(element.metadata.tag)) {\n    customElementRegistry.define(element.metadata.tag, element);\n\n    if (customElementRegistry === customElements) {\n      GlobalStateService.dispatch('NVE_ELEMENT_DEFINE', {\n        elementRegistry: { [element.metadata.tag]: element.metadata.version }\n      });\n    }\n  }\n}\n\n/** defines an element with the global custom element registry */\nexport function define(element: ElementDefinition) {\n  const { version } = element.metadata;\n\n  // if scoped registry supported, register only the root element to global registry\n  if (supportsScopedRegistry && !customElements.get(element.metadata.tag)) {\n    customElements.define(element.metadata.tag, element);\n    GlobalStateService.dispatch('NVE_ELEMENT_DEFINE', {\n      elementRegistry: { [element.metadata.tag]: element.metadata.version }\n    });\n  } else {\n    // if scoped registry not supported, register the element and all its children to the global registry\n    defineElement(element, customElements);\n  }\n\n  // warn on duplicate version\n  if (\n    GlobalStateService.state.elementRegistry[element.metadata.tag] !== version &&\n    globalThis?.location?.hostname === 'localhost'\n  ) {\n    void import('./audit-logs.js').then(m =>\n      console.warn(m.getDuplicatePackageVersionWarning(element.metadata.tag, version))\n    );\n  }\n}\n\nexport function isContextMenuClick(event: MouseEvent) {\n  return (event.buttons === 2 && !event.ctrlKey) || (event.buttons === 1 && event.ctrlKey);\n}\n\nexport function getFlattenedFocusableItems(element: Node, depth = 10) {\n  return getFlattenedDOMTree(element, depth).filter((e: HTMLElement) => isFocusable(e)) as HTMLElement[];\n}\n\n/**\n * Preserves visual DOM ordering when using slots within Shadow DOM\n * See more information/resources on Shadow DOM linear traversal\n * https://nolanlawson.com/2021/02/13/managing-focus-in-the-shadow-dom/\n * https://www.abeautifulsite.net/posts/querying-through-shadow-roots/\n */\nexport function getFlattenedDOMTree(node: Node, depth = 10): HTMLElement[] {\n  return (\n    Array.from(getChildren(node)).reduce(\n      (p: unknown[], n: Node) => [\n        ...p,\n        [n, [...Array.from(getChildren(n)).map(i => [i, getFlattenedDOMTree(i, depth)])]]\n      ],\n      []\n    ) as unknown as HTMLElement[]\n  ).flat(depth);\n}\n\nexport function validKeyNavigationCode(e: KeyboardEvent) {\n  return keynavCodes.has(e.code);\n}\n\nexport enum KeynavCode {\n  End = 'End',\n  Home = 'Home',\n  PageUp = 'PageUp',\n  PageDown = 'PageDown',\n  ArrowUp = 'ArrowUp',\n  ArrowDown = 'ArrowDown',\n  ArrowLeft = 'ArrowLeft',\n  ArrowRight = 'ArrowRight'\n}\n\nconst keynavCodes: Set<string> = new Set(Object.values(KeynavCode));\n\nexport function hasInvalidDOMGrid(rows: HTMLElement[]) {\n  return rows.some(row => row.children.length !== rows[0]!.children.length);\n}\n\nexport function removeEmptyTextNode(node: Node) {\n  if ((node as Text)?.wholeText?.trim() === '') {\n    (node as Text).remove();\n  }\n}\n\nexport function scrollBarWidth() {\n  const div = globalThis.document.createElement('div');\n  div.style.setProperty('width', '100px');\n  div.style.setProperty('height', '100px');\n  div.style.setProperty('overflow', 'scroll');\n  div.style.setProperty('position', 'absolute');\n  div.style.setProperty('top', '-9999px');\n  globalThis.document.body.appendChild(div);\n  const width = div.offsetWidth - div.clientWidth;\n  globalThis.document.body.removeChild(div);\n  return width;\n}\n\nexport function hasScrollBar(el: HTMLElement) {\n  return el.scrollHeight > el.clientHeight;\n}\n\nexport function hasHorizontalScrollBar(el: HTMLElement) {\n  return el.scrollWidth > el.clientWidth;\n}\n\nexport function endOfScrollBox(element: HTMLElement, offset = 0) {\n  return element.scrollTop + element.offsetHeight + offset >= element.scrollHeight;\n}\n\nexport async function openEyeDropper(): Promise<string> {\n  const EyeDropperConstructor = (\n    globalThis as unknown as { EyeDropper?: new () => { open: () => Promise<{ sRGBHex: string }> } }\n  ).EyeDropper;\n\n  if (!EyeDropperConstructor) {\n    LogService.warn('EyeDropper API is unavailable');\n    return '';\n  }\n\n  try {\n    return (await new EyeDropperConstructor().open()).sRGBHex;\n  } catch (e) {\n    LogService.warn(`EyeDropper selection failed: ${(e as Error).message}`);\n    return '';\n  }\n}\n\n/**\n * provides a object with key/value of the currently applied design tokens\n */\nexport function getThemeTokens(element = globalThis.document.querySelector(':root')!) {\n  // default root or provided element\n  const styles = getComputedStyle(element);\n  let parent: CSSStyleSheet[] = [];\n\n  // check for parent iframe, same domain iframes change how the browser accesses style sheets\n  try {\n    parent = Array.from(globalThis.parent.document.styleSheets);\n  } catch {\n    // if not accessible, skip\n  }\n\n  return [...parent, ...Array.from(globalThis.document.styleSheets)]\n    .reduce((finalArr: string[][], sheet) => {\n      let rules: CSSRule[] = [];\n      try {\n        rules = [...sheet.cssRules];\n      } catch {\n        // if the style sheet is not accessible, skip\n      }\n      return finalArr.concat(\n        rules\n          .filter(rule => rule.type === 1)\n          .reduce((propValArr: string[][], rule) => {\n            const props = [...(rule as CSSStyleRule).style]\n              .filter((p: string) => p.trim().includes('--nve'))\n              .map((propName: string) => [\n                propName.trim(),\n                (rule as CSSStyleRule).style.getPropertyValue(propName).trim()\n              ]);\n            return [...propValArr, ...props];\n          }, [])\n      );\n    }, [])\n    .reduce(\n      (p: Record<string, string>, token: string[]) => ({ ...p, [token[0]!]: styles.getPropertyValue(token[0]!) }),\n      {}\n    );\n}\n\nexport function removeEmptySlotWhitespace(slot: HTMLSlotElement) {\n  if (slotContainsOnlyWhitespace(slot)) {\n    slot.assignedNodes().forEach((node: Node) => node.parentNode?.removeChild(node));\n  }\n}\n\nexport function slotContainsOnlyWhitespace(slot: HTMLSlotElement) {\n  const hasNoElements = !slot.assignedNodes().find(i => i.nodeType !== Node.TEXT_NODE);\n  const hasOnlyEmptyTextNodes = !slot\n    .assignedNodes()\n    .find(i => i.nodeType === Node.TEXT_NODE && (i.textContent ?? '').trim() !== '');\n  return hasNoElements && hasOnlyEmptyTextNodes;\n}\n\nexport function applySlotContentStates(slot: HTMLSlotElement, element: HTMLElement & { _internals: ElementInternals }) {\n  const nodes = slot.assignedNodes();\n  const name = slot.name ?? 'slot';\n\n  if (nodes.length) {\n    element._internals.states.add(`has-${name}`);\n  } else {\n    element._internals.states.delete(`has-${name}`);\n  }\n}\n\nexport function getDisplayValue(option?: { label?: string; value?: string }): string {\n  return option?.label || option?.value || '';\n}\n\n/** determines if HTML element matches the given component tag */\nexport function matchesElementName(element: Partial<HTMLElement>, component: { metadata: { tag: string } }) {\n  return element.localName === component.metadata.tag;\n}\n\nexport function createGhostElement(sourceElement: HTMLElement) {\n  const ghost = globalThis.document.createElement('div');\n  const { width } = sourceElement.getBoundingClientRect();\n  ghost.setAttribute('nve-ghost', '');\n  ghost.style.minWidth = `${width}px`;\n  ghost.style.maxWidth = `${width}px`;\n  ghost.style.height = '1px';\n  ghost.slot = sourceElement.slot;\n  return ghost;\n}\n\nexport function sameRenderRoot(element1: HTMLElement, element2: HTMLElement) {\n  const root1 = element1.getRootNode();\n  const root2 = element2.getRootNode();\n  const sameShadowRoot = root1 instanceof ShadowRoot && root2 instanceof ShadowRoot && root1 === root2;\n  const sameDocumentRoot = root1 === globalThis.document && root2 === globalThis.document;\n  const sameUnattachedRoot = root1 === root2;\n  return sameShadowRoot || sameDocumentRoot || sameUnattachedRoot;\n}\n\nexport function getAnchorNames(element: HTMLElement): string[] {\n  return (\n    element.style.anchorName\n      ?.split(',')\n      ?.map(name => name.trim())\n      ?.filter(name => name !== 'none' && name !== '') ?? []\n  );\n}\n\nexport function removeAnchorName(element: HTMLElement, name: string) {\n  const anchorNames = getAnchorNames(element);\n  element.style.anchorName = anchorNames.filter(i => i !== name).join(',');\n}\n\nexport function appendAnchorName(element: HTMLElement, name: string) {\n  element.style.anchorName = Array.from(new Set([...getAnchorNames(element), name])).join(',');\n}\n\n/**\n * Returns true when both arrays have the same length and each index is strictly equal (`===`).\n */\nexport function sameOrderedStringArray(a: readonly string[], b: readonly string[]): boolean {\n  return a.length === b.length && a.every((value, index) => value === b[index]);\n}\n\n/**\n * Returns unique non-empty strings in first-seen order (insertion order of a `Set` over the filtered list).\n */\nexport function uniqueNonEmptyStrings(values: Iterable<string | null | undefined>): string[] {\n  return Array.from(\n    new Set(Array.from(values).filter((value): value is string => typeof value === 'string' && value.length > 0))\n  );\n}\n"],"mappings":"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"}

package/dist/internal/utils/focus.d.ts

@@ -2,6 +2,8 @@ export declare function isFocusable(element: Element): boolean;
 /** returns interactive elements that does not require advanced keyboard interactions like arrow/navigation */
 export declare function isSimpleFocusable(element: Element): boolean;
 export declare function getActiveElement(root?: Document | ShadowRoot): Element | null;
+/** Returns whether an element itself owns focus in its immediate document or shadow root. */
+export declare function isImmediateRootActiveElement(element: Element): boolean;
 export declare function focusElement(element: HTMLElement): void;
 export declare function focusElementTimeout(element: HTMLElement): void;
 export declare function setActiveKeyListItem(items: NodeListOf<HTMLElement> | HTMLElement[], item: HTMLElement): void;