@nvidia-elements/core 2.16.0 → 2.17.1

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

@@ -1,63 +1,95 @@
 import { GlobalStateService as e } from "../services/global.service.js";
-import { onChildListMutation as t, throttle as n } from "../utils/events.js";
-import { LogService as r } from "../services/log.service.js";
-import { focusElement as i, getActiveElement as a, initializeKeyListItems as o, isSimpleFocusable as s, setActiveKeyListItem as c } from "../utils/focus.js";
-import { KeynavCode as l, getFlattenedDOMTree as u, getFlattenedFocusableItems as d, hasInvalidDOMGrid as f, isContextMenuClick as p, validKeyNavigationCode as m } from "../utils/dom.js";
+import { throttle as t } from "../utils/events.js";
+import { LogService as n } from "../services/log.service.js";
+import { focusElement as r, getActiveElement as i, isSimpleFocusable as a, setActiveKeyListItem as o } from "../utils/focus.js";
+import { KeynavCode as s, getFlattenedDOMTree as c, getFlattenedFocusableItems as l, hasInvalidDOMGrid as u, isContextMenuClick as d, validKeyNavigationCode as f } from "../utils/dom.js";
 //#region src/internal/controllers/keynav-grid.controller.ts
-function h() {
-	return (e) => e.addInitializer((e) => new g(e));
+function p() {
+	return (e) => e.addInitializer((e) => new m(e));
 }
-var g = class {
-	#e = [];
+var m = class {
+	#e;
 	#t;
-	get #n() {
+	#n;
+	#r = /* @__PURE__ */ new WeakSet();
+	#i = t(() => this.#c(), 500, { trailing: !0 });
+	get #a() {
 		return {
 			grid: this.host,
 			...this.host.keynavGridConfig
 		};
 	}
-	get #r() {
-		let e = Array.from(this.#n.rows);
-		return this.#n.columnRow && e.unshift(this.#n.columnRow), e;
+	get #o() {
+		let e = Array.from(this.#a.rows);
+		return this.#a.columnRow && e.unshift(this.#a.columnRow), e;
 	}
-	get #i() {
-		return [...Array.from(this.#n.columns ?? []), ...Array.from(this.#n.cells)];
+	get #s() {
+		let { columns: e, cells: t } = this.#a;
+		return [...Array.from(e ?? []), ...Array.from(t)];
 	}
 	constructor(e) {
 		this.host = e, this.host.addController(this);
 	}
 	async hostConnected() {
-		await this.host.updateComplete, this.host.isConnected && (this.#t = this.#n.grid, o(this.#i), this.#t.addEventListener("keyup", this.#l), this.#t.addEventListener("keydown", this.#u), this.#t.addEventListener("mouseup", this.#d), this.#e.push(t(this.host, n(() => o(this.#i), 500))));
+		await this.host.updateComplete, this.host.isConnected && (this.#t = this.#a.grid, this.#c(), this.#t.addEventListener("keyup", this.#m), this.#t.addEventListener("keydown", this.#f), this.#t.addEventListener("mouseup", this.#d), this.#e?.disconnect(), this.#e = new MutationObserver(this.#l), this.#e.observe(this.#t, {
+			childList: !0,
+			subtree: !0,
+			attributes: !0,
+			attributeFilter: ["tabindex"]
+		}));
 	}
 	hostDisconnected() {
-		this.#e.forEach((e) => e?.disconnect()), this.#e.length = 0, this.#t?.removeEventListener("keyup", this.#l), this.#t?.removeEventListener("keydown", this.#u), this.#t?.removeEventListener("mouseup", this.#d), this.#t = void 0;
+		this.#e?.disconnect(), this.#e = void 0, this.#i.cancel(), this.#t?.removeEventListener("keyup", this.#m), this.#t?.removeEventListener("keydown", this.#f), this.#t?.removeEventListener("mouseup", this.#d), this.#t = void 0, this.#n = void 0;
 	}
-	#a(e) {
-		if (!p(e)) {
-			let t = e.composedPath()[0], n = this.#i.find((e) => e === t) ? t : null;
-			n && this.#s(e, n);
+	#c() {
+		let e = this.#s, t = e.find((e) => e.tabIndex === 0) ?? (this.#n && e.includes(this.#n) ? this.#n : e[0]);
+		this.#n = t, this.#r = new WeakSet(e);
+		for (let n of e) {
+			let e = n === t ? "0" : "-1";
+			n.getAttribute("tabindex") !== e && n.setAttribute("tabindex", e);
 		}
 	}
-	#o(t) {
-		let n = Array.from(this.#r), i = Array.from(this.#i);
-		if (e.state.env !== "production" && f(n)) {
-			r.warn("Invalid grid structure, all rows must have the same number of cells");
+	#l = (e) => {
+		e.some((e) => {
+			if (e.type === "attributes") {
+				let t = e.target;
+				return t instanceof HTMLElement && this.#r.has(t) && t.getAttribute("tabindex") !== (t === this.#n ? "0" : "-1");
+			}
+			return [...e.addedNodes, ...e.removedNodes].some((e) => e.nodeType === Node.ELEMENT_NODE);
+		}) && this.#i();
+	};
+	#u() {
+		this.#l(this.#e?.takeRecords() ?? []), this.#i.flush();
+	}
+	#d = (e) => {
+		if (!d(e)) {
+			this.#u();
+			let t = e.composedPath()[0], n = this.#s.find((e) => e === t) ? t : null;
+			n && this.#p(e, n);
+		}
+	};
+	#f = (t) => {
+		if (!f(t)) return;
+		this.#u();
+		let r = Array.from(this.#o), o = Array.from(this.#s);
+		if (e.state.env !== "production" && u(r)) {
+			n.warn("Invalid grid structure, all rows must have the same number of cells");
 			return;
 		}
-		if (m(t) && s(a())) {
-			let { x: e, y: r } = y(i, n, {
+		if (a(i())) {
+			let { x: e, y: n } = _(o, r, {
 				code: t.code,
 				ctrlKey: t.ctrlKey,
 				dir: this.host.dir
-			}), a = Array.from(u(n[r])).filter((e) => !!i.find((t) => t === e))[e];
-			this.#s(t, a), t.preventDefault();
+			}), i = Array.from(c(r[n])).filter((e) => !!o.find((t) => t === e))[e];
+			this.#p(t, i), t.preventDefault();
 		}
-	}
-	#s(e, t) {
-		c(this.#i, t);
-		let n = d(t), r = n.filter((e) => s(e));
-		r.length === 1 && n.length === 1 ? i(r[0]) : i(t);
-		let a = {
+	};
+	#p(e, t) {
+		this.#n = t, o(this.#s, t);
+		let n = l(t), i = n.filter((e) => a(e));
+		i.length === 1 && n.length === 1 ? r(i[0]) : r(t);
+		let s = {
 			code: e instanceof KeyboardEvent ? e.code : null,
 			shiftKey: e.shiftKey,
 			activeItem: t
@@ -65,23 +97,22 @@ var g = class {
 		t.dispatchEvent(new CustomEvent("nve-key-change", {
 			bubbles: !0,
 			composed: !0,
-			detail: a
+			detail: s
 		}));
 	}
-	#c(e) {
-		let t = Array.from(this.#i).find((e) => e.tabIndex === 0);
-		e.code === "Escape" && t?.focus(), e.code === "Enter" && t === e.composedPath()[0] && d(t)[0]?.focus();
-	}
-	#l = (e) => this.#c(e);
-	#u = (e) => this.#o(e);
-	#d = (e) => this.#a(e);
+	#m = (e) => {
+		if (e.code !== "Enter" && e.code !== "Escape") return;
+		this.#u();
+		let t = Array.from(this.#s).find((e) => e.tabIndex === 0);
+		e.code === "Escape" && t?.focus(), e.code === "Enter" && t === e.composedPath()[0] && l(t)[0]?.focus();
+	};
 };
-function _(e, t) {
-	let n = t === "rtl" ? l.ArrowRight : l.ArrowLeft, r = t === "rtl" ? l.ArrowLeft : l.ArrowRight;
-	return e === l.ArrowUp ? {
+function h(e, t) {
+	let n = t === "rtl" ? s.ArrowRight : s.ArrowLeft, r = t === "rtl" ? s.ArrowLeft : s.ArrowRight;
+	return e === s.ArrowUp ? {
 		dx: 0,
 		dy: -1
-	} : e === l.ArrowDown ? {
+	} : e === s.ArrowDown ? {
 		dx: 0,
 		dy: 1
 	} : e === n ? {
@@ -90,42 +121,42 @@ function _(e, t) {
 	} : e === r ? {
 		dx: 1,
 		dy: 0
-	} : e === l.PageUp ? {
+	} : e === s.PageUp ? {
 		dx: 0,
 		dy: -4
-	} : e === l.PageDown ? {
+	} : e === s.PageDown ? {
 		dx: 0,
 		dy: 4
 	} : null;
 }
-function v(e, t, n) {
-	let { x: r, y: i } = t, { columnCount: a, rowCount: o, ctrlKey: s } = n;
-	return e === l.End ? {
+function g(e, t, n) {
+	let { x: r, y: i } = t, { columnCount: a, rowCount: o, ctrlKey: c } = n;
+	return e === s.End ? {
 		x: a,
-		y: s ? o : i
-	} : e === l.Home ? {
+		y: c ? o : i
+	} : e === s.Home ? {
 		x: 0,
-		y: s ? 0 : i
+		y: c ? 0 : i
 	} : {
 		x: r,
 		y: i
 	};
 }
-function y(e, t, n) {
-	let r = e.find((e) => e.tabIndex === 0), i = t.find((e) => u(e).find((e) => e === r)), a = Array.from(u(i)).filter((t) => !!e.find((e) => e === t)), o = t.length - 1, s = a.length - 1, c = a.indexOf(r), l = t.indexOf(i), d = _(n.code, n.dir);
-	return d ? (c = Math.max(0, Math.min(s, c + d.dx)), l = Math.max(0, Math.min(o, l + d.dy))) : {x: c, y: l} = v(n.code, {
-		x: c,
-		y: l
+function _(e, t, n) {
+	let r = e.find((e) => e.tabIndex === 0), i = t.find((e) => c(e).find((e) => e === r)), a = Array.from(c(i)).filter((t) => !!e.find((e) => e === t)), o = t.length - 1, s = a.length - 1, l = a.indexOf(r), u = t.indexOf(i), d = h(n.code, n.dir);
+	return d ? (l = Math.max(0, Math.min(s, l + d.dx)), u = Math.max(0, Math.min(o, u + d.dy))) : {x: l, y: u} = g(n.code, {
+		x: l,
+		y: u
 	}, {
 		columnCount: s,
 		rowCount: o,
 		ctrlKey: n.ctrlKey
 	}), {
-		x: c,
-		y: l
+		x: l,
+		y: u
 	};
 }
 //#endregion
-export { g as KeyNavigationGridController, y as getNextKeyGridItem, h as keyNavigationGrid };
+export { m as KeyNavigationGridController, _ as getNextKeyGridItem, p as keyNavigationGrid };
 
 //# sourceMappingURL=keynav-grid.controller.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"keynav-grid.controller.js","names":[],"sources":["../../../src/internal/controllers/keynav-grid.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, ReactiveElement } from 'lit';\nimport type { LegacyDecoratorTarget } from '../types/index.js';\nimport { onChildListMutation, throttle } from '../utils/events.js';\nimport { GlobalStateService } from '../services/global.service.js';\nimport { LogService } from '../services/log.service.js';\nimport {\n  validKeyNavigationCode,\n  isContextMenuClick,\n  getFlattenedDOMTree,\n  getFlattenedFocusableItems,\n  KeynavCode,\n  hasInvalidDOMGrid\n} from '../utils/dom.js';\nimport {\n  focusElement,\n  getActiveElement,\n  initializeKeyListItems,\n  setActiveKeyListItem,\n  isSimpleFocusable\n} from '../utils/focus.js';\n\nexport interface KeynavGridConfig {\n  grid?: HTMLElement;\n  columnRow?: HTMLElement;\n  columns?: NodeListOf<HTMLElement> | HTMLElement[];\n  rows: NodeListOf<HTMLElement> | HTMLElement[];\n  cells: NodeListOf<HTMLElement> | HTMLElement[];\n}\n\nexport interface KeynavGridElement {\n  keynavGridConfig: KeynavGridConfig;\n}\n\n/**\n * https://w3c.github.io/aria-practices/#gridNav_focus\n */\nexport function keyNavigationGrid<T extends ReactiveElement & KeynavGridElement>(): ClassDecorator {\n  return (target: LegacyDecoratorTarget) =>\n    target.addInitializer!((instance: T) => new KeyNavigationGridController(instance));\n}\n\nexport class KeyNavigationGridController<T extends ReactiveElement & KeynavGridElement> implements ReactiveController {\n  #observers: MutationObserver[] = [];\n  #grid?: HTMLElement;\n\n  get #config() {\n    return {\n      grid: this.host,\n      ...this.host.keynavGridConfig\n    };\n  }\n\n  get #hostRows() {\n    const rows = Array.from(this.#config.rows);\n\n    if (this.#config.columnRow) {\n      rows.unshift(this.#config.columnRow);\n    }\n\n    return rows;\n  }\n\n  get #hostCells() {\n    return [...Array.from(this.#config.columns ?? []), ...Array.from(this.#config.cells)];\n  }\n\n  constructor(private host: T) {\n    this.host.addController(this);\n  }\n\n  async hostConnected() {\n    await this.host.updateComplete;\n    if (!this.host.isConnected) return;\n\n    this.#grid = this.#config.grid;\n    initializeKeyListItems(this.#hostCells);\n    this.#grid.addEventListener('keyup', this.#onKeyUp);\n    this.#grid.addEventListener('keydown', this.#onKeyDown);\n    this.#grid.addEventListener('mouseup', this.#onMouseUp);\n    this.#observers.push(\n      onChildListMutation(\n        this.host,\n        throttle(() => initializeKeyListItems(this.#hostCells), 500)\n      )\n    );\n  }\n\n  hostDisconnected() {\n    this.#observers.forEach(o => o?.disconnect());\n    this.#observers.length = 0;\n    this.#grid?.removeEventListener('keyup', this.#onKeyUp);\n    this.#grid?.removeEventListener('keydown', this.#onKeyDown);\n    this.#grid?.removeEventListener('mouseup', this.#onMouseUp);\n    this.#grid = undefined;\n  }\n\n  #clickCell(e: MouseEvent) {\n    if (!isContextMenuClick(e)) {\n      const focusedElement = e.composedPath()[0] as HTMLElement;\n      const activeCell = this.#hostCells.find(i => i === focusedElement) ? focusedElement : null;\n      if (activeCell) {\n        this.#setActiveCell(e, activeCell as HTMLElement);\n      }\n    }\n  }\n\n  #keynavCell(e: KeyboardEvent) {\n    const rows = Array.from(this.#hostRows);\n    const cells = Array.from(this.#hostCells);\n\n    if (GlobalStateService.state.env !== 'production' && hasInvalidDOMGrid(rows)) {\n      LogService.warn('Invalid grid structure, all rows must have the same number of cells');\n      return;\n    }\n\n    if (validKeyNavigationCode(e) && isSimpleFocusable(getActiveElement() as Element)) {\n      const { x, y } = getNextKeyGridItem(cells, rows, {\n        code: e.code,\n        ctrlKey: e.ctrlKey,\n        dir: this.host.dir\n      });\n\n      const nextCell = Array.from(getFlattenedDOMTree(rows[y]!)).filter(c => !!cells.find(i => i === c))[\n        x\n      ] as HTMLElement;\n      this.#setActiveCell(e, nextCell);\n      e.preventDefault();\n    }\n  }\n\n  #setActiveCell(e: KeyboardEvent | MouseEvent, activeCell: HTMLElement) {\n    setActiveKeyListItem(this.#hostCells, activeCell);\n\n    const items = getFlattenedFocusableItems(activeCell);\n    const simpleItems = items.filter(i => isSimpleFocusable(i));\n\n    if (simpleItems.length === 1 && items.length === 1) {\n      focusElement(simpleItems[0]!);\n    } else {\n      focusElement(activeCell);\n    }\n\n    const detail = { code: e instanceof KeyboardEvent ? e.code : null, shiftKey: e.shiftKey, activeItem: activeCell };\n    activeCell.dispatchEvent(new CustomEvent('nve-key-change', { bubbles: true, composed: true, detail }));\n  }\n\n  #updateCellActivation(e: KeyboardEvent) {\n    const activeCell = Array.from(this.#hostCells).find(i => i.tabIndex === 0) as HTMLElement;\n    if (e.code === 'Escape') {\n      activeCell?.focus();\n    }\n\n    if (e.code === 'Enter' && activeCell === e.composedPath()[0]) {\n      getFlattenedFocusableItems(activeCell as HTMLElement)[0]?.focus();\n    }\n  }\n\n  #onKeyUp = (e: KeyboardEvent) => this.#updateCellActivation(e);\n\n  #onKeyDown = (e: KeyboardEvent) => this.#keynavCell(e);\n\n  #onMouseUp = (e: MouseEvent) => this.#clickCell(e);\n}\n\nfunction getGridDelta(code: KeynavCode | string, dir: string): { dx: number; dy: number } | null {\n  const start = dir === 'rtl' ? KeynavCode.ArrowRight : KeynavCode.ArrowLeft;\n  const end = dir === 'rtl' ? KeynavCode.ArrowLeft : KeynavCode.ArrowRight;\n\n  if (code === KeynavCode.ArrowUp) return { dx: 0, dy: -1 };\n  if (code === KeynavCode.ArrowDown) return { dx: 0, dy: 1 };\n  if (code === start) return { dx: -1, dy: 0 };\n  if (code === end) return { dx: 1, dy: 0 };\n  if (code === KeynavCode.PageUp) return { dx: 0, dy: -4 };\n  if (code === KeynavCode.PageDown) return { dx: 0, dy: 4 };\n  return null;\n}\n\nfunction applyGridHomeEnd(\n  code: KeynavCode | string,\n  position: { x: number; y: number },\n  bounds: { columnCount: number; rowCount: number; ctrlKey: boolean }\n) {\n  const { x, y } = position;\n  const { columnCount, rowCount, ctrlKey } = bounds;\n  if (code === KeynavCode.End) {\n    return { x: columnCount, y: ctrlKey ? rowCount : y };\n  }\n\n  if (code === KeynavCode.Home) {\n    return { x: 0, y: ctrlKey ? 0 : y };\n  }\n\n  return { x, y };\n}\n\nexport function getNextKeyGridItem(\n  cells: HTMLElement[],\n  rows: HTMLElement[],\n  config: { code: KeynavCode | string; ctrlKey: boolean; dir: string }\n) {\n  const currentCell = cells.find(i => i.tabIndex === 0) as HTMLElement;\n  const currentRow = rows.find(r => getFlattenedDOMTree(r).find(c => c === currentCell)) as HTMLElement;\n  const currentRowCells = Array.from(getFlattenedDOMTree(currentRow)).filter(c => !!cells.find(i => i === c));\n  const rowCount = rows.length - 1;\n  const columnCount = currentRowCells.length - 1;\n\n  let x = currentRowCells.indexOf(currentCell);\n  let y = rows.indexOf(currentRow);\n\n  const delta = getGridDelta(config.code, config.dir);\n  if (delta) {\n    x = Math.max(0, Math.min(columnCount, x + delta.dx));\n    y = Math.max(0, Math.min(rowCount, y + delta.dy));\n  } else {\n    ({ x, y } = applyGridHomeEnd(config.code, { x, y }, { columnCount, rowCount, ctrlKey: config.ctrlKey }));\n  }\n\n  return { x, y };\n}\n"],"mappings":"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"}
+{"version":3,"file":"keynav-grid.controller.js","names":[],"sources":["../../../src/internal/controllers/keynav-grid.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, ReactiveElement } from 'lit';\nimport type { LegacyDecoratorTarget } from '../types/index.js';\nimport { throttle } from '../utils/events.js';\nimport { GlobalStateService } from '../services/global.service.js';\nimport { LogService } from '../services/log.service.js';\nimport {\n  validKeyNavigationCode,\n  isContextMenuClick,\n  getFlattenedDOMTree,\n  getFlattenedFocusableItems,\n  KeynavCode,\n  hasInvalidDOMGrid\n} from '../utils/dom.js';\nimport { focusElement, getActiveElement, setActiveKeyListItem, isSimpleFocusable } from '../utils/focus.js';\n\nexport interface KeynavGridConfig {\n  grid?: HTMLElement;\n  columnRow?: HTMLElement;\n  columns?: NodeListOf<HTMLElement> | HTMLElement[];\n  rows: NodeListOf<HTMLElement> | HTMLElement[];\n  cells: NodeListOf<HTMLElement> | HTMLElement[];\n}\n\nexport interface KeynavGridElement {\n  keynavGridConfig: KeynavGridConfig;\n}\n\n/**\n * https://w3c.github.io/aria-practices/#gridNav_focus\n */\nexport function keyNavigationGrid<T extends ReactiveElement & KeynavGridElement>(): ClassDecorator {\n  return (target: LegacyDecoratorTarget) =>\n    target.addInitializer!((instance: T) => new KeyNavigationGridController(instance));\n}\n\nexport class KeyNavigationGridController<T extends ReactiveElement & KeynavGridElement> implements ReactiveController {\n  #observer?: MutationObserver;\n  #grid?: HTMLElement;\n  #activeCell?: HTMLElement;\n  #cells = new WeakSet<HTMLElement>();\n  #updateCells = throttle(() => this.#initializeCells(), 500, { trailing: true });\n\n  get #config() {\n    return {\n      grid: this.host,\n      ...this.host.keynavGridConfig\n    };\n  }\n\n  get #hostRows() {\n    const rows = Array.from(this.#config.rows);\n\n    if (this.#config.columnRow) {\n      rows.unshift(this.#config.columnRow);\n    }\n\n    return rows;\n  }\n\n  get #hostCells() {\n    const { columns, cells } = this.#config;\n    return [...Array.from(columns ?? []), ...Array.from(cells)];\n  }\n\n  constructor(private host: T) {\n    this.host.addController(this);\n  }\n\n  async hostConnected() {\n    await this.host.updateComplete;\n    if (!this.host.isConnected) return;\n\n    this.#grid = this.#config.grid;\n    this.#initializeCells();\n    this.#grid.addEventListener('keyup', this.#onKeyUp);\n    this.#grid.addEventListener('keydown', this.#onKeyDown);\n    this.#grid.addEventListener('mouseup', this.#onMouseUp);\n    this.#observer?.disconnect();\n    this.#observer = new MutationObserver(this.#onMutations);\n    this.#observer.observe(this.#grid, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: ['tabindex']\n    });\n  }\n\n  hostDisconnected() {\n    this.#observer?.disconnect();\n    this.#observer = undefined;\n    this.#updateCells.cancel();\n    this.#grid?.removeEventListener('keyup', this.#onKeyUp);\n    this.#grid?.removeEventListener('keydown', this.#onKeyDown);\n    this.#grid?.removeEventListener('mouseup', this.#onMouseUp);\n    this.#grid = undefined;\n    this.#activeCell = undefined;\n  }\n\n  #initializeCells() {\n    const cells = this.#hostCells;\n    const activeCell =\n      cells.find(cell => cell.tabIndex === 0) ??\n      (this.#activeCell && cells.includes(this.#activeCell) ? this.#activeCell : cells[0]);\n    this.#activeCell = activeCell;\n    this.#cells = new WeakSet(cells);\n    for (const cell of cells) {\n      const tabIndex = cell === activeCell ? '0' : '-1';\n      // Avoid observing our own unchanged writes after a DOM morph or key change.\n      if (cell.getAttribute('tabindex') !== tabIndex) {\n        cell.setAttribute('tabindex', tabIndex);\n      }\n    }\n  }\n\n  #onMutations = (mutations: MutationRecord[]) => {\n    const changed = mutations.some(mutation => {\n      if (mutation.type === 'attributes') {\n        const cell = mutation.target;\n        // Ignore nested controls and our own tabindex writes.\n        return (\n          cell instanceof HTMLElement &&\n          this.#cells.has(cell) &&\n          cell.getAttribute('tabindex') !== (cell === this.#activeCell ? '0' : '-1')\n        );\n      }\n      return [...mutation.addedNodes, ...mutation.removedNodes].some(node => node.nodeType === Node.ELEMENT_NODE);\n    });\n    if (changed) this.#updateCells();\n  };\n\n  #flushCellUpdates() {\n    // A key event can arrive before the observer delivers a synchronous DOM update.\n    this.#onMutations(this.#observer?.takeRecords() ?? []);\n    this.#updateCells.flush();\n  }\n\n  #onMouseUp = (e: MouseEvent) => {\n    if (!isContextMenuClick(e)) {\n      this.#flushCellUpdates();\n      const focusedElement = e.composedPath()[0] as HTMLElement;\n      const activeCell = this.#hostCells.find(i => i === focusedElement) ? focusedElement : null;\n      if (activeCell) {\n        this.#setActiveCell(e, activeCell);\n      }\n    }\n  };\n\n  #onKeyDown = (e: KeyboardEvent) => {\n    if (!validKeyNavigationCode(e)) return;\n    this.#flushCellUpdates();\n    const rows = Array.from(this.#hostRows);\n    const cells = Array.from(this.#hostCells);\n\n    if (GlobalStateService.state.env !== 'production' && hasInvalidDOMGrid(rows)) {\n      LogService.warn('Invalid grid structure, all rows must have the same number of cells');\n      return;\n    }\n\n    if (isSimpleFocusable(getActiveElement() as Element)) {\n      const { x, y } = getNextKeyGridItem(cells, rows, {\n        code: e.code,\n        ctrlKey: e.ctrlKey,\n        dir: this.host.dir\n      });\n\n      const nextCell = Array.from(getFlattenedDOMTree(rows[y]!)).filter(c => !!cells.find(i => i === c))[\n        x\n      ] as HTMLElement;\n      this.#setActiveCell(e, nextCell);\n      e.preventDefault();\n    }\n  };\n\n  #setActiveCell(e: KeyboardEvent | MouseEvent, activeCell: HTMLElement) {\n    this.#activeCell = activeCell;\n    setActiveKeyListItem(this.#hostCells, activeCell);\n\n    const items = getFlattenedFocusableItems(activeCell);\n    const simpleItems = items.filter(i => isSimpleFocusable(i));\n\n    if (simpleItems.length === 1 && items.length === 1) {\n      focusElement(simpleItems[0]!);\n    } else {\n      focusElement(activeCell);\n    }\n\n    const detail = { code: e instanceof KeyboardEvent ? e.code : null, shiftKey: e.shiftKey, activeItem: activeCell };\n    activeCell.dispatchEvent(new CustomEvent('nve-key-change', { bubbles: true, composed: true, detail }));\n  }\n\n  #onKeyUp = (e: KeyboardEvent) => {\n    if (e.code !== 'Enter' && e.code !== 'Escape') return;\n    this.#flushCellUpdates();\n    const activeCell = Array.from(this.#hostCells).find(i => i.tabIndex === 0) as HTMLElement;\n    if (e.code === 'Escape') {\n      activeCell?.focus();\n    }\n\n    if (e.code === 'Enter' && activeCell === e.composedPath()[0]) {\n      getFlattenedFocusableItems(activeCell)[0]?.focus();\n    }\n  };\n}\n\nfunction getGridDelta(code: KeynavCode | string, dir: string): { dx: number; dy: number } | null {\n  const start = dir === 'rtl' ? KeynavCode.ArrowRight : KeynavCode.ArrowLeft;\n  const end = dir === 'rtl' ? KeynavCode.ArrowLeft : KeynavCode.ArrowRight;\n\n  if (code === KeynavCode.ArrowUp) return { dx: 0, dy: -1 };\n  if (code === KeynavCode.ArrowDown) return { dx: 0, dy: 1 };\n  if (code === start) return { dx: -1, dy: 0 };\n  if (code === end) return { dx: 1, dy: 0 };\n  if (code === KeynavCode.PageUp) return { dx: 0, dy: -4 };\n  if (code === KeynavCode.PageDown) return { dx: 0, dy: 4 };\n  return null;\n}\n\nfunction applyGridHomeEnd(\n  code: KeynavCode | string,\n  position: { x: number; y: number },\n  bounds: { columnCount: number; rowCount: number; ctrlKey: boolean }\n) {\n  const { x, y } = position;\n  const { columnCount, rowCount, ctrlKey } = bounds;\n  if (code === KeynavCode.End) {\n    return { x: columnCount, y: ctrlKey ? rowCount : y };\n  }\n\n  if (code === KeynavCode.Home) {\n    return { x: 0, y: ctrlKey ? 0 : y };\n  }\n\n  return { x, y };\n}\n\nexport function getNextKeyGridItem(\n  cells: HTMLElement[],\n  rows: HTMLElement[],\n  config: { code: KeynavCode | string; ctrlKey: boolean; dir: string }\n) {\n  const currentCell = cells.find(i => i.tabIndex === 0) as HTMLElement;\n  const currentRow = rows.find(r => getFlattenedDOMTree(r).find(c => c === currentCell)) as HTMLElement;\n  const currentRowCells = Array.from(getFlattenedDOMTree(currentRow)).filter(c => !!cells.find(i => i === c));\n  const rowCount = rows.length - 1;\n  const columnCount = currentRowCells.length - 1;\n\n  let x = currentRowCells.indexOf(currentCell);\n  let y = rows.indexOf(currentRow);\n\n  const delta = getGridDelta(config.code, config.dir);\n  if (delta) {\n    x = Math.max(0, Math.min(columnCount, x + delta.dx));\n    y = Math.max(0, Math.min(rowCount, y + delta.dy));\n  } else {\n    ({ x, y } = applyGridHomeEnd(config.code, { x, y }, { columnCount, rowCount, ctrlKey: config.ctrlKey }));\n  }\n\n  return { x, y };\n}\n"],"mappings":"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"}

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.16.0"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.16.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)}`);
+		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(/* @__PURE__ */ new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.17.1"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.17.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)}`);
 	}
 	get state() {
 		return globalThis.NVE_ELEMENTS.state;

package/dist/internal/styles/popover.js

@@ -1,5 +1,5 @@
 //#region src/internal/styles/popover.css?inline
-var e = ":host{--animation-duration: var(--nve-ref-animation-duration-200);margin:calc(var(--nve-sys-layer-popover-offset) + calc(var(--nve-sys-layer-popover-arrow-offset) * 2));border:0;padding:0;background:none;position:fixed;overflow:visible;contain:initial;width:max-content;z-index:99;inset:revert;interest-delay-start:.5s}:host([popover]){opacity:0;pointer-events:none}:host(:state(transition-start)){transition-duration:var(--animation-duration);transition-timing-function:ease-in-out;transition-property:opacity,display,overlay,translate,transform;transition-behavior:allow-discrete}@supports not (container-type: anchored){:host{--animation-duration: 0}}:host(:popover-open){opacity:1;pointer-events:initial;@starting-style{opacity:0}}:host(:not([nve-popover])),:host([defer-hydration]){opacity:0!important;pointer-events:none!important}[internal-host]{width:var(--width);min-width:var(--min-width);font-family:inherit;display:flex;flex-direction:column;overflow:visible;white-space:nowrap;z-index:9999;border:0;margin:0;user-select:text}@supports (position-area: bottom){[internal-host]{position:relative}.arrow{position-area:bottom;translate:0% 50%}:host([position=\"top\"]) .arrow{position-area:bottom;translate:0% 50%}:host([position=\"top\"][alignment=\"end\"]) .arrow{position-area:bottom right;translate:-50% 50%}:host([position=\"top\"][alignment=\"start\"]) .arrow{position-area:bottom left;translate:50% 50%}:host([position=\"bottom\"]) .arrow{position-area:top;translate:0% -50%}:host([position=\"bottom\"][alignment=\"end\"]) .arrow{position-area:top right;translate:-50% -50%}:host([position=\"bottom\"][alignment=\"start\"]) .arrow{position-area:top left;translate:50% -50%}:host([position=\"left\"]) .arrow{position-area:right;translate:50% 0%}:host([position=\"left\"][alignment=\"end\"]) .arrow{position-area:bottom right;translate:50% -50%}:host([position=\"left\"][alignment=\"start\"]) .arrow{position-area:top right;translate:50% 50%}:host([position=\"right\"]) .arrow{position-area:left;translate:-50% 0%}:host([position=\"right\"][alignment=\"end\"]) .arrow{position-area:bottom left;translate:-50% -50%}:host([position=\"right\"][alignment=\"start\"]) .arrow{position-area:top left;translate:-50% 50%}:host([position=\"center\"]){position-area:center}:host{inset:auto!important;place-self:normal!important;position-anchor:auto!important}:host([position=\"top\"]){position-area:top center}:host([position=\"top\"][alignment=\"start\"]){position-area:top left}:host([position=\"top\"][alignment=\"end\"]){position-area:top right}:host([position=\"top\"][alignment=\"start\"]){position-area:top span-right}:host([position=\"top\"][alignment=\"end\"]){position-area:top span-left}:host([position=\"bottom\"]){position-area:bottom center}:host([position=\"bottom\"][alignment=\"start\"]){position-area:bottom span-right}:host([position=\"bottom\"][alignment=\"end\"]){position-area:bottom span-left}:host([position=\"left\"]){position-area:left center}:host([position=\"left\"][alignment=\"end\"]){position-area:left span-top}:host([position=\"left\"][alignment=\"start\"]){position-area:left span-bottom}:host([position=\"right\"]){position-area:right center}:host([position=\"right\"][alignment=\"end\"]){position-area:right span-top}:host([position=\"right\"][alignment=\"start\"]){position-area:right span-bottom}:host([position=\"top\"]){position-try-fallbacks:top,bottom,left,right}:host([position=\"bottom\"]){position-try-fallbacks:bottom,top,left,right}:host([position=\"left\"]){position-try-fallbacks:left,right,top,bottom}:host([position=\"right\"]){position-try-fallbacks:right,left,top,bottom}}:host([position=\"center\"][alignment=\"center\"]){position-area:unset!important;margin:auto!important;inset:0!important}@supports (not selector(::search-text)) and (position-area: bottom){.arrow{translate:0% -50%}:host([position=\"top\"]) .arrow{translate:0% -50%}:host([position=\"top\"][alignment=\"end\"]) .arrow{translate:-150% -50%}:host([position=\"top\"][alignment=\"start\"]) .arrow{translate:150% -50%}:host([position=\"bottom\"]) .arrow{translate:0% 50%}:host([position=\"bottom\"][alignment=\"end\"]) .arrow{translate:-150% 50%}:host([position=\"bottom\"][alignment=\"start\"]) .arrow{translate:150% 50%}:host([position=\"left\"]) .arrow{translate:-50% 0%}:host([position=\"left\"][alignment=\"end\"]) .arrow{translate:-50% -150%}:host([position=\"left\"][alignment=\"start\"]) .arrow{translate:-50% 150%}:host([position=\"right\"]) .arrow{translate:50% 0%}:host([position=\"right\"][alignment=\"end\"]) .arrow{translate:50% -150%}:host([position=\"right\"][alignment=\"start\"]) .arrow{translate:50% 150%}}:host([popover][modal]):before{content:\" \";display:block;inset:0;z-index:99;position:fixed}";
+var e = ":host{--animation-duration: var(--nve-ref-animation-duration-200);margin:calc(var(--nve-sys-layer-popover-offset) + calc(var(--nve-sys-layer-popover-arrow-offset) * 2));border:0;padding:0;background:none;position:fixed;overflow:visible;contain:initial;width:max-content;z-index:99;inset:revert;interest-delay-start:.5s}:host([popover]){opacity:0;pointer-events:none}:host([popover]:not(:popover-open)){display:none!important}:host(:state(transition-start)){transition-duration:var(--animation-duration);transition-timing-function:ease-in-out;transition-property:opacity,display,overlay,translate,transform;transition-behavior:allow-discrete}@supports not (container-type: anchored){:host{--animation-duration: 0}}:host(:popover-open){opacity:1;pointer-events:initial;@starting-style{opacity:0}}:host(:not([nve-popover])),:host([defer-hydration]){opacity:0!important;pointer-events:none!important}[internal-host]{width:var(--width);min-width:var(--min-width);font-family:inherit;display:flex;flex-direction:column;overflow:visible;white-space:nowrap;z-index:9999;border:0;margin:0;user-select:text}@supports (position-area: bottom){[internal-host]{position:relative}.arrow{position-area:bottom;translate:0% 50%}:host([position=\"top\"]) .arrow{position-area:bottom;translate:0% 50%}:host([position=\"top\"][alignment=\"end\"]) .arrow{position-area:bottom right;translate:-50% 50%}:host([position=\"top\"][alignment=\"start\"]) .arrow{position-area:bottom left;translate:50% 50%}:host([position=\"bottom\"]) .arrow{position-area:top;translate:0% -50%}:host([position=\"bottom\"][alignment=\"end\"]) .arrow{position-area:top right;translate:-50% -50%}:host([position=\"bottom\"][alignment=\"start\"]) .arrow{position-area:top left;translate:50% -50%}:host([position=\"left\"]) .arrow{position-area:right;translate:50% 0%}:host([position=\"left\"][alignment=\"end\"]) .arrow{position-area:bottom right;translate:50% -50%}:host([position=\"left\"][alignment=\"start\"]) .arrow{position-area:top right;translate:50% 50%}:host([position=\"right\"]) .arrow{position-area:left;translate:-50% 0%}:host([position=\"right\"][alignment=\"end\"]) .arrow{position-area:bottom left;translate:-50% -50%}:host([position=\"right\"][alignment=\"start\"]) .arrow{position-area:top left;translate:-50% 50%}:host([position=\"center\"]){position-area:center}:host{inset:auto!important;place-self:normal!important;position-anchor:auto!important}:host([position=\"top\"]){position-area:top center}:host([position=\"top\"][alignment=\"start\"]){position-area:top left}:host([position=\"top\"][alignment=\"end\"]){position-area:top right}:host([position=\"top\"][alignment=\"start\"]){position-area:top span-right}:host([position=\"top\"][alignment=\"end\"]){position-area:top span-left}:host([position=\"bottom\"]){position-area:bottom center}:host([position=\"bottom\"][alignment=\"start\"]){position-area:bottom span-right}:host([position=\"bottom\"][alignment=\"end\"]){position-area:bottom span-left}:host([position=\"left\"]){position-area:left center}:host([position=\"left\"][alignment=\"end\"]){position-area:left span-top}:host([position=\"left\"][alignment=\"start\"]){position-area:left span-bottom}:host([position=\"right\"]){position-area:right center}:host([position=\"right\"][alignment=\"end\"]){position-area:right span-top}:host([position=\"right\"][alignment=\"start\"]){position-area:right span-bottom}:host([position=\"top\"]){position-try-fallbacks:top,bottom,left,right}:host([position=\"bottom\"]){position-try-fallbacks:bottom,top,left,right}:host([position=\"left\"]){position-try-fallbacks:left,right,top,bottom}:host([position=\"right\"]){position-try-fallbacks:right,left,top,bottom}}:host([position=\"center\"][alignment=\"center\"]){position-area:unset!important;margin:auto!important;inset:0!important}@supports (not selector(::search-text)) and (position-area: bottom){.arrow{translate:0% -50%}:host([position=\"top\"]) .arrow{translate:0% -50%}:host([position=\"top\"][alignment=\"end\"]) .arrow{translate:-150% -50%}:host([position=\"top\"][alignment=\"start\"]) .arrow{translate:150% -50%}:host([position=\"bottom\"]) .arrow{translate:0% 50%}:host([position=\"bottom\"][alignment=\"end\"]) .arrow{translate:-150% 50%}:host([position=\"bottom\"][alignment=\"start\"]) .arrow{translate:150% 50%}:host([position=\"left\"]) .arrow{translate:-50% 0%}:host([position=\"left\"][alignment=\"end\"]) .arrow{translate:-50% -150%}:host([position=\"left\"][alignment=\"start\"]) .arrow{translate:-50% 150%}:host([position=\"right\"]) .arrow{translate:50% 0%}:host([position=\"right\"][alignment=\"end\"]) .arrow{translate:50% -150%}:host([position=\"right\"][alignment=\"start\"]) .arrow{translate:50% 150%}}:host([popover][modal]):before{content:\" \";display:block;inset:0;z-index:99;position:fixed}";
 //#endregion
 export { e as default };
 

package/dist/internal/styles/popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"popover.js","names":[],"sources":["../../../src/internal/styles/popover.css?inline"],"sourcesContent":["/* SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. */\n/* SPDX-License-Identifier: Apache-2.0 */\n\n:host {\n  --animation-duration: var(--nve-ref-animation-duration-200);\n  margin: calc(var(--nve-sys-layer-popover-offset) + calc(var(--nve-sys-layer-popover-arrow-offset) * 2));\n  border: 0;\n  padding: 0;\n  background: none;\n  position: fixed;\n  overflow: visible;\n  contain: initial;\n  width: max-content;\n  z-index: 99;\n  inset: revert;\n  interest-delay-start: 0.5s;\n}\n\n:host([popover]) {\n  opacity: 0;\n  pointer-events: none;\n}\n\n/* apply transitions during beforetoggle event to prevent flash of unstyled popover on page load */\n:host(:state(transition-start)) {\n  transition-duration: var(--animation-duration);\n  transition-timing-function: ease-in-out;\n  transition-property: opacity, display, overlay, translate, transform;\n  transition-behavior: allow-discrete;\n}\n\n/** workaround for Safari / Firefox which do not respect transitions on implicit anchor positioning */\n@supports not (container-type: anchored) {\n  :host {\n    --animation-duration: 0;\n  }\n}\n\n:host(:popover-open) {\n  opacity: 1;\n  pointer-events: initial;\n\n  @starting-style {\n    opacity: 0;\n  }\n}\n\n/* lit SSR ensure popovers are not visible until hydration has happened */\n:host(:not([nve-popover])),\n:host([defer-hydration]) {\n  opacity: 0 !important;\n  pointer-events: none !important;\n}\n\n[internal-host] {\n  width: var(--width);\n  min-width: var(--min-width);\n  font-family: inherit;\n  display: flex;\n  flex-direction: column;\n  overflow: visible;\n  white-space: nowrap;\n  z-index: 9999;\n  border: 0;\n  margin: 0;\n  user-select: text;\n}\n\n@supports (position-area: bottom) {\n  [internal-host] {\n    position: relative;\n  }\n\n  .arrow {\n    position-area: bottom;\n    translate: 0% 50%;\n  }\n\n  :host([position='top']) .arrow {\n    position-area: bottom;\n    translate: 0% 50%;\n  }\n\n  :host([position='top'][alignment='end']) .arrow {\n    position-area: bottom right;\n    translate: -50% 50%;\n  }\n\n  :host([position='top'][alignment='start']) .arrow {\n    position-area: bottom left;\n    translate: 50% 50%;\n  }\n\n  :host([position='bottom']) .arrow {\n    position-area: top;\n    translate: 0% -50%;\n  }\n\n  :host([position='bottom'][alignment='end']) .arrow {\n    position-area: top right;\n    translate: -50% -50%;\n  }\n\n  :host([position='bottom'][alignment='start']) .arrow {\n    position-area: top left;\n    translate: 50% -50%;\n  }\n\n  :host([position='left']) .arrow {\n    position-area: right;\n    translate: 50% 0%;\n  }\n\n  :host([position='left'][alignment='end']) .arrow {\n    position-area: bottom right;\n    translate: 50% -50%;\n  }\n\n  :host([position='left'][alignment='start']) .arrow {\n    position-area: top right;\n    translate: 50% 50%;\n  }\n\n  :host([position='right']) .arrow {\n    position-area: left;\n    translate: -50% 0%;\n  }\n\n  :host([position='right'][alignment='end']) .arrow {\n    position-area: bottom left;\n    translate: -50% -50%;\n  }\n\n  :host([position='right'][alignment='start']) .arrow {\n    position-area: top left;\n    translate: -50% 50%;\n  }\n\n  /** positioning */\n  :host([position='center']) {\n    position-area: center;\n  }\n\n  :host {\n    inset: auto !important;\n    place-self: normal !important;\n\n    /*\n     * This line is critical for shadow root positioning and auto anchor association\n     * https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Anchor_positioning/Using#implicit_anchor_association\n     */\n    position-anchor: auto !important;\n  }\n\n  /** top */\n  :host([position='top']) {\n    position-area: top center;\n  }\n\n  :host([position='top'][alignment='start']) {\n    position-area: top left;\n  }\n\n  :host([position='top'][alignment='end']) {\n    position-area: top right;\n  }\n\n  :host([position='top'][alignment='start']) {\n    position-area: top span-right;\n  }\n\n  :host([position='top'][alignment='end']) {\n    position-area: top span-left;\n  }\n\n  /** bottom */\n  :host([position='bottom']) {\n    position-area: bottom center;\n  }\n\n  :host([position='bottom'][alignment='start']) {\n    position-area: bottom span-right;\n  }\n\n  :host([position='bottom'][alignment='end']) {\n    position-area: bottom span-left;\n  }\n\n  /** left */\n  :host([position='left']) {\n    position-area: left center;\n  }\n\n  :host([position='left'][alignment='end']) {\n    position-area: left span-top;\n  }\n\n  :host([position='left'][alignment='start']) {\n    position-area: left span-bottom;\n  }\n\n  /** right */\n  :host([position='right']) {\n    position-area: right center;\n  }\n\n  :host([position='right'][alignment='end']) {\n    position-area: right span-top;\n  }\n\n  :host([position='right'][alignment='start']) {\n    position-area: right span-bottom;\n  }\n\n  :host([position='top']) {\n    position-try-fallbacks: top, bottom, left, right;\n  }\n\n  :host([position='bottom']) {\n    position-try-fallbacks: bottom, top, left, right;\n  }\n\n  :host([position='left']) {\n    position-try-fallbacks: left, right, top, bottom;\n  }\n\n  :host([position='right']) {\n    position-try-fallbacks: right, left, top, bottom;\n  }\n}\n\n:host([position='center'][alignment='center']) {\n  position-area: unset !important;\n  margin: auto !important;\n  inset: 0 !important;\n}\n\n/*\n * Remove the following @supports block after Chrome 145 is stable.\n * This is to compensate for a change in Chrome 144 for how anchor positioning with transforms works.\n * https://developer.chrome.com/blog/chrome-144-beta#css_anchor_positioning_with_transforms\n * https://x.com/una/status/1995538970223018004\n * \n * The (not selector(::search-text)) selector is used to target Chrome 143 and below.\n */\n@supports (not selector(::search-text)) and (position-area: bottom) {\n  .arrow {\n    translate: 0% -50%;\n  }\n\n  :host([position='top']) .arrow {\n    translate: 0% -50%;\n  }\n\n  :host([position='top'][alignment='end']) .arrow {\n    translate: -150% -50%;\n  }\n\n  :host([position='top'][alignment='start']) .arrow {\n    translate: 150% -50%;\n  }\n\n  :host([position='bottom']) .arrow {\n    translate: 0% 50%;\n  }\n\n  :host([position='bottom'][alignment='end']) .arrow {\n    translate: -150% 50%;\n  }\n\n  :host([position='bottom'][alignment='start']) .arrow {\n    translate: 150% 50%;\n  }\n\n  :host([position='left']) .arrow {\n    translate: -50% 0%;\n  }\n\n  :host([position='left'][alignment='end']) .arrow {\n    translate: -50% -150%;\n  }\n\n  :host([position='left'][alignment='start']) .arrow {\n    translate: -50% 150%;\n  }\n\n  :host([position='right']) .arrow {\n    translate: 50% 0%;\n  }\n\n  :host([position='right'][alignment='end']) .arrow {\n    translate: 50% -150%;\n  }\n\n  :host([position='right'][alignment='start']) .arrow {\n    translate: 50% 150%;\n  }\n}\n\n:host([popover][modal])::before {\n  content: ' ';\n  display: block;\n  inset: 0;\n  z-index: 99;\n  position: fixed;\n}\n"],"mappings":""}
+{"version":3,"file":"popover.js","names":[],"sources":["../../../src/internal/styles/popover.css?inline"],"sourcesContent":["/* SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. */\n/* SPDX-License-Identifier: Apache-2.0 */\n\n:host {\n  --animation-duration: var(--nve-ref-animation-duration-200);\n  margin: calc(var(--nve-sys-layer-popover-offset) + calc(var(--nve-sys-layer-popover-arrow-offset) * 2));\n  border: 0;\n  padding: 0;\n  background: none;\n  position: fixed;\n  overflow: visible;\n  contain: initial;\n  width: max-content;\n  z-index: 99;\n  inset: revert;\n  interest-delay-start: 0.5s;\n}\n\n:host([popover]) {\n  opacity: 0;\n  pointer-events: none;\n}\n\n/* Closed popovers must not retain layout boxes from host display styles. */\n:host([popover]:not(:popover-open)) {\n  display: none !important;\n}\n\n/* apply transitions during beforetoggle event to prevent flash of unstyled popover on page load */\n:host(:state(transition-start)) {\n  transition-duration: var(--animation-duration);\n  transition-timing-function: ease-in-out;\n  transition-property: opacity, display, overlay, translate, transform;\n  transition-behavior: allow-discrete;\n}\n\n/** workaround for Safari / Firefox which do not respect transitions on implicit anchor positioning */\n@supports not (container-type: anchored) {\n  :host {\n    --animation-duration: 0;\n  }\n}\n\n:host(:popover-open) {\n  opacity: 1;\n  pointer-events: initial;\n\n  @starting-style {\n    opacity: 0;\n  }\n}\n\n/* lit SSR ensure popovers are not visible until hydration has happened */\n:host(:not([nve-popover])),\n:host([defer-hydration]) {\n  opacity: 0 !important;\n  pointer-events: none !important;\n}\n\n[internal-host] {\n  width: var(--width);\n  min-width: var(--min-width);\n  font-family: inherit;\n  display: flex;\n  flex-direction: column;\n  overflow: visible;\n  white-space: nowrap;\n  z-index: 9999;\n  border: 0;\n  margin: 0;\n  user-select: text;\n}\n\n@supports (position-area: bottom) {\n  [internal-host] {\n    position: relative;\n  }\n\n  .arrow {\n    position-area: bottom;\n    translate: 0% 50%;\n  }\n\n  :host([position='top']) .arrow {\n    position-area: bottom;\n    translate: 0% 50%;\n  }\n\n  :host([position='top'][alignment='end']) .arrow {\n    position-area: bottom right;\n    translate: -50% 50%;\n  }\n\n  :host([position='top'][alignment='start']) .arrow {\n    position-area: bottom left;\n    translate: 50% 50%;\n  }\n\n  :host([position='bottom']) .arrow {\n    position-area: top;\n    translate: 0% -50%;\n  }\n\n  :host([position='bottom'][alignment='end']) .arrow {\n    position-area: top right;\n    translate: -50% -50%;\n  }\n\n  :host([position='bottom'][alignment='start']) .arrow {\n    position-area: top left;\n    translate: 50% -50%;\n  }\n\n  :host([position='left']) .arrow {\n    position-area: right;\n    translate: 50% 0%;\n  }\n\n  :host([position='left'][alignment='end']) .arrow {\n    position-area: bottom right;\n    translate: 50% -50%;\n  }\n\n  :host([position='left'][alignment='start']) .arrow {\n    position-area: top right;\n    translate: 50% 50%;\n  }\n\n  :host([position='right']) .arrow {\n    position-area: left;\n    translate: -50% 0%;\n  }\n\n  :host([position='right'][alignment='end']) .arrow {\n    position-area: bottom left;\n    translate: -50% -50%;\n  }\n\n  :host([position='right'][alignment='start']) .arrow {\n    position-area: top left;\n    translate: -50% 50%;\n  }\n\n  /** positioning */\n  :host([position='center']) {\n    position-area: center;\n  }\n\n  :host {\n    inset: auto !important;\n    place-self: normal !important;\n\n    /*\n     * This line is critical for shadow root positioning and auto anchor association\n     * https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Anchor_positioning/Using#implicit_anchor_association\n     */\n    position-anchor: auto !important;\n  }\n\n  /** top */\n  :host([position='top']) {\n    position-area: top center;\n  }\n\n  :host([position='top'][alignment='start']) {\n    position-area: top left;\n  }\n\n  :host([position='top'][alignment='end']) {\n    position-area: top right;\n  }\n\n  :host([position='top'][alignment='start']) {\n    position-area: top span-right;\n  }\n\n  :host([position='top'][alignment='end']) {\n    position-area: top span-left;\n  }\n\n  /** bottom */\n  :host([position='bottom']) {\n    position-area: bottom center;\n  }\n\n  :host([position='bottom'][alignment='start']) {\n    position-area: bottom span-right;\n  }\n\n  :host([position='bottom'][alignment='end']) {\n    position-area: bottom span-left;\n  }\n\n  /** left */\n  :host([position='left']) {\n    position-area: left center;\n  }\n\n  :host([position='left'][alignment='end']) {\n    position-area: left span-top;\n  }\n\n  :host([position='left'][alignment='start']) {\n    position-area: left span-bottom;\n  }\n\n  /** right */\n  :host([position='right']) {\n    position-area: right center;\n  }\n\n  :host([position='right'][alignment='end']) {\n    position-area: right span-top;\n  }\n\n  :host([position='right'][alignment='start']) {\n    position-area: right span-bottom;\n  }\n\n  :host([position='top']) {\n    position-try-fallbacks: top, bottom, left, right;\n  }\n\n  :host([position='bottom']) {\n    position-try-fallbacks: bottom, top, left, right;\n  }\n\n  :host([position='left']) {\n    position-try-fallbacks: left, right, top, bottom;\n  }\n\n  :host([position='right']) {\n    position-try-fallbacks: right, left, top, bottom;\n  }\n}\n\n:host([position='center'][alignment='center']) {\n  position-area: unset !important;\n  margin: auto !important;\n  inset: 0 !important;\n}\n\n/*\n * Remove the following @supports block after Chrome 145 is stable.\n * This is to compensate for a change in Chrome 144 for how anchor positioning with transforms works.\n * https://developer.chrome.com/blog/chrome-144-beta#css_anchor_positioning_with_transforms\n * https://x.com/una/status/1995538970223018004\n * \n * The (not selector(::search-text)) selector is used to target Chrome 143 and below.\n */\n@supports (not selector(::search-text)) and (position-area: bottom) {\n  .arrow {\n    translate: 0% -50%;\n  }\n\n  :host([position='top']) .arrow {\n    translate: 0% -50%;\n  }\n\n  :host([position='top'][alignment='end']) .arrow {\n    translate: -150% -50%;\n  }\n\n  :host([position='top'][alignment='start']) .arrow {\n    translate: 150% -50%;\n  }\n\n  :host([position='bottom']) .arrow {\n    translate: 0% 50%;\n  }\n\n  :host([position='bottom'][alignment='end']) .arrow {\n    translate: -150% 50%;\n  }\n\n  :host([position='bottom'][alignment='start']) .arrow {\n    translate: 150% 50%;\n  }\n\n  :host([position='left']) .arrow {\n    translate: -50% 0%;\n  }\n\n  :host([position='left'][alignment='end']) .arrow {\n    translate: -50% -150%;\n  }\n\n  :host([position='left'][alignment='start']) .arrow {\n    translate: -50% 150%;\n  }\n\n  :host([position='right']) .arrow {\n    translate: 50% 0%;\n  }\n\n  :host([position='right'][alignment='end']) .arrow {\n    translate: 50% -150%;\n  }\n\n  :host([position='right'][alignment='start']) .arrow {\n    translate: 50% 150%;\n  }\n}\n\n:host([popover][modal])::before {\n  content: ' ';\n  display: block;\n  inset: 0;\n  z-index: 99;\n  position: fixed;\n}\n"],"mappings":""}

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

@@ -1,4 +1,9 @@
 export declare function stopEvent(event: Event): void;
 export declare function onChildListMutation(element: HTMLElement, fn: (mutation?: MutationRecord) => void, options?: MutationObserverInit): MutationObserver;
-export declare function throttle(func: (...args: unknown[]) => void, limit: number): (...args: unknown[]) => void;
+export declare function throttle<Args extends unknown[]>(func: (...args: Args) => void, limit: number, { trailing }?: {
+    trailing?: boolean;
+}): ((...args: Args) => void) & {
+    flush(): void;
+    cancel(): void;
+};
 export declare function debounce(func: (...args: unknown[]) => void, timeout?: number): (...args: unknown[]) => void;

package/dist/internal/utils/events.js

@@ -11,11 +11,29 @@ function t(e, t, n = {}) {
 		...n
 	}), r;
 }
-function n(e, t) {
-	let n = !0;
-	return (...r) => {
-		n && (e(...r), n = !1, setTimeout(() => n = !0, t));
+function n(e, t, { trailing: n = !1 } = {}) {
+	let r, i, a = (...o) => {
+		if (r !== void 0) {
+			n && (i = o);
+			return;
+		}
+		e(...o), r = setTimeout(() => {
+			if (r = void 0, i) {
+				let e = i;
+				i = void 0, a(...e);
+			}
+		}, t);
 	};
+	return Object.assign(a, {
+		flush() {
+			if (!i) return;
+			let t = i;
+			i = void 0, e(...t);
+		},
+		cancel() {
+			clearTimeout(r), r = void 0, i = void 0;
+		}
+	});
 }
 function r(e, t = 0) {
 	let n;

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

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../../src/internal/utils/events.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function stopEvent(event: Event) {\n  event?.preventDefault();\n  event?.stopPropagation();\n}\n\nexport function onChildListMutation(\n  element: HTMLElement,\n  fn: (mutation?: MutationRecord) => void,\n  options: MutationObserverInit = {}\n) {\n  const observer = new MutationObserver(mutations => {\n    for (const mutation of mutations) {\n      if (mutation.type === 'childList') {\n        fn(mutation);\n      }\n\n      if (options.attributes && mutation.type === 'attributes') {\n        fn(mutation);\n      }\n    }\n  });\n  observer.observe(element, { childList: true, ...options });\n  return observer;\n}\n\nexport function throttle(func: (...args: unknown[]) => void, limit: number) {\n  let wait = true;\n  return (...args: unknown[]) => {\n    if (wait) {\n      func(...args);\n      wait = false;\n      /* istanbul ignore next */\n      setTimeout(() => (wait = true), limit);\n    }\n  };\n}\n\nexport function debounce(func: (...args: unknown[]) => void, timeout = 0) {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: unknown[]) => {\n    clearTimeout(timer);\n    /* istanbul ignore next */\n    timer = setTimeout(() => {\n      func(...args);\n    }, timeout);\n  };\n}\n"],"mappings":";AAGA,SAAgB,EAAU,GAAc;CAEtC,AADA,GAAO,eAAe,GACtB,GAAO,gBAAgB;AACzB;AAEA,SAAgB,EACd,GACA,GACA,IAAgC,CAAC,GACjC;CACA,IAAM,IAAW,IAAI,kBAAiB,MAAa;EACjD,KAAK,IAAM,KAAY,GAKrB,AAJI,EAAS,SAAS,eACpB,EAAG,CAAQ,GAGT,EAAQ,cAAc,EAAS,SAAS,gBAC1C,EAAG,CAAQ;CAGjB,CAAC;CAED,OADA,EAAS,QAAQ,GAAS;EAAE,WAAW;EAAM,GAAG;CAAQ,CAAC,GAClD;AACT;AAEA,SAAgB,EAAS,GAAoC,GAAe;CAC1E,IAAI,IAAO;CACX,QAAQ,GAAG,MAAoB;EAC7B,AAAI,MACF,EAAK,GAAG,CAAI,GACZ,IAAO,IAEP,iBAAkB,IAAO,IAAO,CAAK;CAEzC;AACF;AAEA,SAAgB,EAAS,GAAoC,IAAU,GAAG;CACxE,IAAI;CACJ,QAAQ,GAAG,MAAoB;;EAG7B,AAFA,aAAa,CAAK,GAElB,IAAQ,iBAAiB;GACvB,EAAK,GAAG,CAAI;EACd,GAAG,CAAO;CACZ;AACF"}
+{"version":3,"file":"events.js","names":[],"sources":["../../../src/internal/utils/events.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function stopEvent(event: Event) {\n  event?.preventDefault();\n  event?.stopPropagation();\n}\n\nexport function onChildListMutation(\n  element: HTMLElement,\n  fn: (mutation?: MutationRecord) => void,\n  options: MutationObserverInit = {}\n) {\n  const observer = new MutationObserver(mutations => {\n    for (const mutation of mutations) {\n      if (mutation.type === 'childList') {\n        fn(mutation);\n      }\n\n      if (options.attributes && mutation.type === 'attributes') {\n        fn(mutation);\n      }\n    }\n  });\n  observer.observe(element, { childList: true, ...options });\n  return observer;\n}\n\nexport function throttle<Args extends unknown[]>(\n  func: (...args: Args) => void,\n  limit: number,\n  { trailing = false }: { trailing?: boolean } = {}\n) {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let pending: Args | undefined;\n\n  const throttled = (...args: Args): void => {\n    if (timer !== undefined) {\n      if (trailing) pending = args;\n      return;\n    }\n\n    func(...args);\n    timer = setTimeout(() => {\n      timer = undefined;\n      if (pending) {\n        const nextArgs = pending;\n        pending = undefined;\n        throttled(...nextArgs);\n      }\n    }, limit);\n  };\n\n  return Object.assign(throttled, {\n    flush() {\n      if (!pending) return;\n      const args = pending;\n      pending = undefined;\n      func(...args);\n    },\n    cancel() {\n      clearTimeout(timer);\n      timer = undefined;\n      pending = undefined;\n    }\n  });\n}\n\nexport function debounce(func: (...args: unknown[]) => void, timeout = 0) {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: unknown[]) => {\n    clearTimeout(timer);\n    /* istanbul ignore next */\n    timer = setTimeout(() => {\n      func(...args);\n    }, timeout);\n  };\n}\n"],"mappings":";AAGA,SAAgB,EAAU,GAAc;CAEtC,AADA,GAAO,eAAe,GACtB,GAAO,gBAAgB;AACzB;AAEA,SAAgB,EACd,GACA,GACA,IAAgC,CAAC,GACjC;CACA,IAAM,IAAW,IAAI,kBAAiB,MAAa;EACjD,KAAK,IAAM,KAAY,GAKrB,AAJI,EAAS,SAAS,eACpB,EAAG,CAAQ,GAGT,EAAQ,cAAc,EAAS,SAAS,gBAC1C,EAAG,CAAQ;CAGjB,CAAC;CAED,OADA,EAAS,QAAQ,GAAS;EAAE,WAAW;EAAM,GAAG;CAAQ,CAAC,GAClD;AACT;AAEA,SAAgB,EACd,GACA,GACA,EAAE,cAAW,OAAkC,CAAC,GAChD;CACA,IAAI,GACA,GAEE,KAAa,GAAG,MAAqB;EACzC,IAAI,MAAU,KAAA,GAAW;GACvB,AAAI,MAAU,IAAU;GACxB;EACF;EAGA,AADA,EAAK,GAAG,CAAI,GACZ,IAAQ,iBAAiB;GAEvB,IADA,IAAQ,KAAA,GACJ,GAAS;IACX,IAAM,IAAW;IAEjB,AADA,IAAU,KAAA,GACV,EAAU,GAAG,CAAQ;GACvB;EACF,GAAG,CAAK;CACV;CAEA,OAAO,OAAO,OAAO,GAAW;EAC9B,QAAQ;GACN,IAAI,CAAC,GAAS;GACd,IAAM,IAAO;GAEb,AADA,IAAU,KAAA,GACV,EAAK,GAAG,CAAI;EACd;EACA,SAAS;GAGP,AAFA,aAAa,CAAK,GAClB,IAAQ,KAAA,GACR,IAAU,KAAA;EACZ;CACF,CAAC;AACH;AAEA,SAAgB,EAAS,GAAoC,IAAU,GAAG;CACxE,IAAI;CACJ,QAAQ,GAAG,MAAoB;;EAG7B,AAFA,aAAa,CAAK,GAElB,IAAQ,iBAAiB;GACvB,EAAK,GAAG,CAAI;EACd,GAAG,CAAO;CACZ;AACF"}

package/dist/logo/logo2.js

@@ -12,7 +12,7 @@ var c = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-logo",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {

package/dist/menu/menu-group2.js

@@ -21,7 +21,7 @@ var d = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-menu-group",
-			version: "2.16.0",
+			version: "2.17.1",
 			children: ["nve-menu"]
 		};
 	}

package/dist/menu/menu-item2.js

@@ -13,7 +13,7 @@ var c = class extends s(i) {
 	static {
 		this.metadata = {
 			tag: "nve-menu-item",
-			version: "2.16.0",
+			version: "2.17.1",
 			parents: ["nve-menu"]
 		};
 	}

package/dist/menu/menu2.js

@@ -17,7 +17,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-menu",
-			version: "2.16.0",
+			version: "2.17.1",
 			children: ["nve-menu-item", "nve-divider"]
 		};
 	}

package/dist/month/month2.js

@@ -19,7 +19,7 @@ var l = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-month",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	static {

package/dist/notification/notification-group2.js

@@ -20,7 +20,7 @@ var l = class extends o {
 	static {
 		this.metadata = {
 			tag: "nve-notification-group",
-			version: "2.16.0",
+			version: "2.17.1",
 			children: ["nve-notification"]
 		};
 	}

package/dist/notification/notification2.js

@@ -34,7 +34,7 @@ var m = class extends d {
 	static {
 		this.metadata = {
 			tag: "nve-notification",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	static {

package/dist/page/page-panel/page-panel-content2.js

@@ -9,7 +9,7 @@ var i = class extends n {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel-content",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {

package/dist/page/page-panel/page-panel-footer2.js

@@ -14,7 +14,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel-footer",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {

package/dist/page/page-panel/page-panel-header2.js

@@ -14,7 +14,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel-header",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {

package/dist/page/page-panel/page-panel2.js

@@ -18,7 +18,7 @@ var f = class extends l {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel",
-			version: "2.16.0",
+			version: "2.17.1",
 			parents: ["nve-page"]
 		};
 	}

package/dist/page/page2.js

@@ -16,7 +16,7 @@ var c = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-page",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	static {

package/dist/page-header/page-header2.js

@@ -12,7 +12,7 @@ var s = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-page-header",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {

package/dist/page-loader/page-loader2.js

@@ -18,7 +18,7 @@ var u = class extends s {
 	static {
 		this.metadata = {
 			tag: "nve-page-loader",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	static {

package/dist/pagination/pagination2.js

@@ -21,7 +21,7 @@ var g = class extends h(d) {
 	static {
 		this.metadata = {
 			tag: "nve-pagination",
-			version: "2.16.0",
+			version: "2.17.1",
 			valueSchema: { type: "number" }
 		};
 	}

package/dist/panel/panel2.js

@@ -21,7 +21,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel-header",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {
@@ -37,7 +37,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel-content",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {
@@ -50,7 +50,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel-footer",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	render() {
@@ -69,7 +69,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	static {

package/dist/password/password2.js

@@ -23,7 +23,7 @@ var u = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-password",
-			version: "2.16.0"
+			version: "2.17.1"
 		};
 	}
 	static {