@nvidia-elements/core 2.0.0 → 2.0.2

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

@@ -9,36 +9,37 @@ function h() {
 }
 var g = class {
 	#e = [];
-	get #t() {
+	#t;
+	get #n() {
 		return {
 			grid: this.host,
 			...this.host.keynavGridConfig
 		};
 	}
-	get #n() {
-		let e = Array.from(this.#t.rows);
-		return this.#t.columnRow && e.unshift(this.#t.columnRow), e;
-	}
 	get #r() {
-		return [...Array.from(this.#t.columns ?? []), ...Array.from(this.#t.cells)];
+		let e = Array.from(this.#n.rows);
+		return this.#n.columnRow && e.unshift(this.#n.columnRow), e;
+	}
+	get #i() {
+		return [...Array.from(this.#n.columns ?? []), ...Array.from(this.#n.cells)];
 	}
 	constructor(e) {
 		this.host = e, this.host.addController(this);
 	}
 	async hostConnected() {
-		await this.host.updateComplete, o(this.#r), this.#t.grid.addEventListener("keyup", (e) => this.#s(e)), this.#t.grid.addEventListener("keydown", (e) => this.#a(e)), this.#t.grid.addEventListener("mouseup", (e) => this.#i(e)), this.#e.push(t(this.host, n(() => o(this.#r), 500)));
+		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))));
 	}
 	hostDisconnected() {
-		this.#e.forEach((e) => e?.disconnect());
+		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;
 	}
-	#i(e) {
+	#a(e) {
 		if (!p(e)) {
-			let t = e.composedPath()[0], n = this.#r.find((e) => e === t) ? t : null;
-			n && this.#o(e, n);
+			let t = e.composedPath()[0], n = this.#i.find((e) => e === t) ? t : null;
+			n && this.#s(e, n);
 		}
 	}
-	#a(t) {
-		let n = Array.from(this.#n), i = Array.from(this.#r);
+	#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");
 			return;
@@ -49,11 +50,11 @@ var g = class {
 				ctrlKey: t.ctrlKey,
 				dir: this.host.dir
 			}), a = Array.from(u(n[r])).filter((e) => !!i.find((t) => t === e))[e];
-			this.#o(t, a), t.preventDefault();
+			this.#s(t, a), t.preventDefault();
 		}
 	}
-	#o(e, t) {
-		c(this.#r, t);
+	#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 = {
@@ -67,10 +68,13 @@ var g = class {
 			detail: a
 		}));
 	}
-	#s(e) {
-		let t = Array.from(this.#r).find((e) => e.tabIndex === 0);
+	#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);
 };
 function _(e, t) {
 	let n = t === "rtl" ? l.ArrowRight : l.ArrowLeft, r = t === "rtl" ? l.ArrowLeft : l.ArrowRight;

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

@@ -1 +1 @@
-{"version":3,"file":"keynav-grid.controller.js","names":["#config","#hostRows","#hostCells","#updateCellActivation","#keynavCell","#clickCell","#observers","#setActiveCell"],"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\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    initializeKeyListItems(this.#hostCells);\n    this.#config.grid.addEventListener('keyup', (e: KeyboardEvent) => this.#updateCellActivation(e));\n    this.#config.grid.addEventListener('keydown', (e: KeyboardEvent) => this.#keynavCell(e));\n    this.#config.grid.addEventListener('mouseup', (e: MouseEvent) => this.#clickCell(e));\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  }\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\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":["#config","#hostRows","#hostCells","#grid","#onKeyUp","#onKeyDown","#onMouseUp","#observers","#setActiveCell","#updateCellActivation","#keynavCell","#clickCell"],"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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"}

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

@@ -18,6 +18,7 @@ export declare class KeyNavigationListController<T extends ReactiveElement & Key
     private host;
     constructor(host: T);
     hostConnected(): Promise<void>;
+    hostDisconnected(): void;
 }
 interface KeyListConfig {
     code: KeynavCode;

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

@@ -23,7 +23,10 @@ var o = class {
 		return this.host.hasAttribute("nve-keynav-disabled");
 	}
 	async hostConnected() {
-		await this.host.updateComplete, this.#n(), this.host.addEventListener("pointerup", (e) => this.#r(e)), this.host.addEventListener("keydown", (e) => this.#i(e));
+		await this.host.updateComplete, this.host.isConnected && (this.#n(), this.host.addEventListener("pointerup", this.#s), this.host.addEventListener("keydown", this.#c));
+	}
+	hostDisconnected() {
+		this.host.removeEventListener("pointerup", this.#s), this.host.removeEventListener("keydown", this.#c);
 	}
 	#n() {
 		let { manageFocus: e, manageTabindex: n, items: r } = this.#e;
@@ -67,6 +70,8 @@ var o = class {
 			detail: c
 		}));
 	}
+	#s = (e) => this.#r(e);
+	#c = (e) => this.#i(e);
 };
 function s(e) {
 	let { code: t, layout: n, dir: i } = e, a = i === "rtl" ? r.ArrowRight : r.ArrowLeft, o = i === "rtl" ? r.ArrowLeft : r.ArrowRight;

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

@@ -1 +1 @@
-{"version":3,"file":"keynav-list.controller.js","names":["#config","#keynavDisabled","#initializeTabIndex","#clickItem","#focusItem","#getActiveItem","#setActiveItem"],"sources":["../../../src/internal/controllers/keynav-list.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 { focusElement, initializeKeyListItems, setActiveKeyListItem } from '../utils/focus.js';\nimport { KeynavCode, validKeyNavigationCode } from '../utils/dom.js';\n\nexport interface KeynavListConfig {\n  items: NodeListOf<HTMLElement> | HTMLElement[];\n  layout?: 'both' | 'horizontal' | 'vertical';\n  manageFocus?: boolean;\n  manageTabindex?: boolean;\n  loop?: boolean;\n  dir?: string | null;\n}\n\nexport interface KeynavListElement {\n  keynavListConfig: KeynavListConfig;\n}\n\n/** https://webaim.org/techniques/keyboard/ */\nexport function keyNavigationList<T extends ReactiveElement & KeynavListElement>(): ClassDecorator {\n  return (target: LegacyDecoratorTarget) =>\n    target.addInitializer!((instance: T) => new KeyNavigationListController(instance));\n}\n\nexport class KeyNavigationListController<T extends ReactiveElement & KeynavListElement> implements ReactiveController {\n  get #config(): KeynavListConfig & { items: HTMLElement[] } {\n    return {\n      layout: 'horizontal',\n      manageFocus: true,\n      manageTabindex: true,\n      loop: false,\n      dir: this.host.getAttribute('rtl'),\n      ...this.host.keynavListConfig,\n      items: Array.from(this.host.keynavListConfig.items).filter(\n        (i: HTMLElement & { disabled?: boolean }) => !i.disabled\n      )\n    };\n  }\n\n  constructor(private host: T) {\n    this.host.addController(this);\n  }\n\n  /** @private attr nve-keynav-disabled is an internal API for advanced use cases only */\n  get #keynavDisabled() {\n    return this.host.hasAttribute('nve-keynav-disabled');\n  }\n\n  async hostConnected() {\n    await this.host.updateComplete;\n    this.#initializeTabIndex();\n    this.host.addEventListener('pointerup', (e: PointerEvent) => this.#clickItem(e));\n    this.host.addEventListener('keydown', (e: KeyboardEvent) => this.#focusItem(e));\n  }\n\n  #initializeTabIndex() {\n    const { manageFocus, manageTabindex, items } = this.#config;\n    if (manageFocus && manageTabindex && !this.#keynavDisabled) {\n      initializeKeyListItems(items);\n    }\n  }\n\n  #clickItem(e: PointerEvent) {\n    const item = this.#getActiveItem(e, this.#config.items);\n    if (item) {\n      this.#setActiveItem(e, item);\n    }\n  }\n\n  #focusItem(e: KeyboardEvent) {\n    if (validKeyNavigationCode(e) && !this.#keynavDisabled) {\n      const { loop, layout, dir, items } = this.#config;\n      const activeItem = this.#getActiveItem(e, items);\n      if (activeItem) {\n        const { next, previous } = getNextKeyListItem(activeItem, Array.from(items), {\n          loop,\n          layout,\n          dir,\n          code: e.code as KeynavCode\n        });\n\n        if (next !== previous) {\n          this.#setActiveItem(e, items[next]!, items[previous]);\n        }\n      }\n    }\n  }\n\n  #getActiveItem(e: Event, items: HTMLElement[]) {\n    const focusedElement = e.composedPath()[0] as HTMLElement;\n    return items.find(i => i === focusedElement) ? focusedElement : null;\n  }\n\n  #setActiveItem(e: KeyboardEvent | PointerEvent, activeItem: HTMLElement, previousItem?: HTMLElement) {\n    const { manageFocus, manageTabindex, items } = this.#config;\n    if (manageFocus) {\n      if (manageTabindex) {\n        setActiveKeyListItem(items, activeItem);\n      }\n\n      focusElement(activeItem);\n      e.preventDefault();\n    }\n\n    const detail = {\n      activeItem,\n      previousItem,\n      code: e instanceof KeyboardEvent ? e.code : null,\n      metaKey: e.ctrlKey || e.metaKey,\n      items\n    };\n    activeItem.dispatchEvent(new CustomEvent('nve-key-change', { bubbles: true, composed: true, detail }));\n  }\n}\n\ninterface KeyListConfig {\n  code: KeynavCode;\n  loop?: boolean;\n  layout?: 'horizontal' | 'vertical' | 'both';\n  dir: string | null | undefined;\n}\n\nfunction resolveArrowDirection(config: KeyListConfig): 'backward' | 'forward' | null {\n  const { code, layout, dir } = config;\n  const start = dir === 'rtl' ? KeynavCode.ArrowRight : KeynavCode.ArrowLeft;\n  const end = dir === 'rtl' ? KeynavCode.ArrowLeft : KeynavCode.ArrowRight;\n\n  if (layout !== 'horizontal') {\n    if (code === KeynavCode.ArrowUp) return 'backward';\n    if (code === KeynavCode.ArrowDown) return 'forward';\n  }\n\n  if (layout !== 'vertical') {\n    if (code === start) return 'backward';\n    if (code === end) return 'forward';\n  }\n\n  return null;\n}\n\nfunction resolveSpecialKey(code: KeynavCode): 'home' | 'end' | 'pageup' | 'pagedown' | null {\n  if (code === KeynavCode.End) return 'end';\n  if (code === KeynavCode.Home) return 'home';\n  if (code === KeynavCode.PageUp) return 'pageup';\n  if (code === KeynavCode.PageDown) return 'pagedown';\n  return null;\n}\n\nfunction navigateWithLoop(current: number, step: number, options: { limit: number; loop: boolean | undefined }) {\n  const { limit, loop } = options;\n  const next = current + step;\n  if (next >= 0 && next <= limit) return next;\n  return loop ? (step < 0 ? limit : 0) : current;\n}\n\nexport function getNextKeyListItem(item: HTMLElement, items: HTMLElement[], config: KeyListConfig) {\n  let next = items.indexOf(item);\n  const previous = next;\n  const itemCount = items.length - 1;\n  const direction = resolveArrowDirection(config);\n\n  switch (direction ?? resolveSpecialKey(config.code)) {\n    case 'backward':\n      next = navigateWithLoop(next, -1, { limit: itemCount, loop: config.loop });\n      break;\n    case 'forward':\n      next = navigateWithLoop(next, 1, { limit: itemCount, loop: config.loop });\n      break;\n    case 'end':\n      next = itemCount;\n      break;\n    case 'home':\n      next = 0;\n      break;\n    case 'pageup':\n      next = Math.max(0, next - 4);\n      break;\n    case 'pagedown':\n      next = Math.min(itemCount, next + 4);\n      break;\n    case null:\n      break;\n  }\n\n  return { next, previous };\n}\n"],"mappings":"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"}
+{"version":3,"file":"keynav-list.controller.js","names":["#config","#keynavDisabled","#initializeTabIndex","#onPointerUp","#onKeyDown","#getActiveItem","#setActiveItem","#clickItem","#focusItem"],"sources":["../../../src/internal/controllers/keynav-list.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 { focusElement, initializeKeyListItems, setActiveKeyListItem } from '../utils/focus.js';\nimport { KeynavCode, validKeyNavigationCode } from '../utils/dom.js';\n\nexport interface KeynavListConfig {\n  items: NodeListOf<HTMLElement> | HTMLElement[];\n  layout?: 'both' | 'horizontal' | 'vertical';\n  manageFocus?: boolean;\n  manageTabindex?: boolean;\n  loop?: boolean;\n  dir?: string | null;\n}\n\nexport interface KeynavListElement {\n  keynavListConfig: KeynavListConfig;\n}\n\n/** https://webaim.org/techniques/keyboard/ */\nexport function keyNavigationList<T extends ReactiveElement & KeynavListElement>(): ClassDecorator {\n  return (target: LegacyDecoratorTarget) =>\n    target.addInitializer!((instance: T) => new KeyNavigationListController(instance));\n}\n\nexport class KeyNavigationListController<T extends ReactiveElement & KeynavListElement> implements ReactiveController {\n  get #config(): KeynavListConfig & { items: HTMLElement[] } {\n    return {\n      layout: 'horizontal',\n      manageFocus: true,\n      manageTabindex: true,\n      loop: false,\n      dir: this.host.getAttribute('rtl'),\n      ...this.host.keynavListConfig,\n      items: Array.from(this.host.keynavListConfig.items).filter(\n        (i: HTMLElement & { disabled?: boolean }) => !i.disabled\n      )\n    };\n  }\n\n  constructor(private host: T) {\n    this.host.addController(this);\n  }\n\n  /** @private attr nve-keynav-disabled is an internal API for advanced use cases only */\n  get #keynavDisabled() {\n    return this.host.hasAttribute('nve-keynav-disabled');\n  }\n\n  async hostConnected() {\n    await this.host.updateComplete;\n    if (!this.host.isConnected) return;\n    this.#initializeTabIndex();\n    this.host.addEventListener('pointerup', this.#onPointerUp);\n    this.host.addEventListener('keydown', this.#onKeyDown);\n  }\n\n  hostDisconnected() {\n    this.host.removeEventListener('pointerup', this.#onPointerUp);\n    this.host.removeEventListener('keydown', this.#onKeyDown);\n  }\n\n  #initializeTabIndex() {\n    const { manageFocus, manageTabindex, items } = this.#config;\n    if (manageFocus && manageTabindex && !this.#keynavDisabled) {\n      initializeKeyListItems(items);\n    }\n  }\n\n  #clickItem(e: PointerEvent) {\n    const item = this.#getActiveItem(e, this.#config.items);\n    if (item) {\n      this.#setActiveItem(e, item);\n    }\n  }\n\n  #focusItem(e: KeyboardEvent) {\n    if (validKeyNavigationCode(e) && !this.#keynavDisabled) {\n      const { loop, layout, dir, items } = this.#config;\n      const activeItem = this.#getActiveItem(e, items);\n      if (activeItem) {\n        const { next, previous } = getNextKeyListItem(activeItem, Array.from(items), {\n          loop,\n          layout,\n          dir,\n          code: e.code as KeynavCode\n        });\n\n        if (next !== previous) {\n          this.#setActiveItem(e, items[next]!, items[previous]);\n        }\n      }\n    }\n  }\n\n  #getActiveItem(e: Event, items: HTMLElement[]) {\n    const focusedElement = e.composedPath()[0] as HTMLElement;\n    return items.find(i => i === focusedElement) ? focusedElement : null;\n  }\n\n  #setActiveItem(e: KeyboardEvent | PointerEvent, activeItem: HTMLElement, previousItem?: HTMLElement) {\n    const { manageFocus, manageTabindex, items } = this.#config;\n    if (manageFocus) {\n      if (manageTabindex) {\n        setActiveKeyListItem(items, activeItem);\n      }\n\n      focusElement(activeItem);\n      e.preventDefault();\n    }\n\n    const detail = {\n      activeItem,\n      previousItem,\n      code: e instanceof KeyboardEvent ? e.code : null,\n      metaKey: e.ctrlKey || e.metaKey,\n      items\n    };\n    activeItem.dispatchEvent(new CustomEvent('nve-key-change', { bubbles: true, composed: true, detail }));\n  }\n\n  #onPointerUp = (e: PointerEvent) => this.#clickItem(e);\n\n  #onKeyDown = (e: KeyboardEvent) => this.#focusItem(e);\n}\n\ninterface KeyListConfig {\n  code: KeynavCode;\n  loop?: boolean;\n  layout?: 'horizontal' | 'vertical' | 'both';\n  dir: string | null | undefined;\n}\n\nfunction resolveArrowDirection(config: KeyListConfig): 'backward' | 'forward' | null {\n  const { code, layout, dir } = config;\n  const start = dir === 'rtl' ? KeynavCode.ArrowRight : KeynavCode.ArrowLeft;\n  const end = dir === 'rtl' ? KeynavCode.ArrowLeft : KeynavCode.ArrowRight;\n\n  if (layout !== 'horizontal') {\n    if (code === KeynavCode.ArrowUp) return 'backward';\n    if (code === KeynavCode.ArrowDown) return 'forward';\n  }\n\n  if (layout !== 'vertical') {\n    if (code === start) return 'backward';\n    if (code === end) return 'forward';\n  }\n\n  return null;\n}\n\nfunction resolveSpecialKey(code: KeynavCode): 'home' | 'end' | 'pageup' | 'pagedown' | null {\n  if (code === KeynavCode.End) return 'end';\n  if (code === KeynavCode.Home) return 'home';\n  if (code === KeynavCode.PageUp) return 'pageup';\n  if (code === KeynavCode.PageDown) return 'pagedown';\n  return null;\n}\n\nfunction navigateWithLoop(current: number, step: number, options: { limit: number; loop: boolean | undefined }) {\n  const { limit, loop } = options;\n  const next = current + step;\n  if (next >= 0 && next <= limit) return next;\n  return loop ? (step < 0 ? limit : 0) : current;\n}\n\nexport function getNextKeyListItem(item: HTMLElement, items: HTMLElement[], config: KeyListConfig) {\n  let next = items.indexOf(item);\n  const previous = next;\n  const itemCount = items.length - 1;\n  const direction = resolveArrowDirection(config);\n\n  switch (direction ?? resolveSpecialKey(config.code)) {\n    case 'backward':\n      next = navigateWithLoop(next, -1, { limit: itemCount, loop: config.loop });\n      break;\n    case 'forward':\n      next = navigateWithLoop(next, 1, { limit: itemCount, loop: config.loop });\n      break;\n    case 'end':\n      next = itemCount;\n      break;\n    case 'home':\n      next = 0;\n      break;\n    case 'pageup':\n      next = Math.max(0, next - 4);\n      break;\n    case 'pagedown':\n      next = Math.min(itemCount, next + 4);\n      break;\n    case null:\n      break;\n  }\n\n  return { next, previous };\n}\n"],"mappings":"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"}

package/dist/internal/controllers/type-native-popover.controller.js

@@ -23,75 +23,105 @@ var c = class {
 		};
 	}
 	async hostConnected() {
-		i(this.host), this.host.popover = this.host.popoverType ?? null, await this.host.updateComplete, this.host.setAttribute("nve-popover", ""), this.#p(), this.#f(), this.#u(), this.host.inert = this.host.matches(":not(:popover-open)") && !!this.#e.length, this.host.addEventListener("beforetoggle", (e) => {
-			e.newState === "open" && this.host._internals.states.add("transition-start");
-		}), this.host.addEventListener("toggle", (e) => {
-			this.host.behaviorTrigger && (this.host.hidden = e.newState === "closed"), e.newState === "open" && this.host.closeTimeout && this.#a(), e.newState === "closed" && (this.#s(), this.#o()), this.host.inert = this.host.matches(":not(:popover-open)"), this.host.modal && this.#m(e.newState === "open", e.target), this.host.dispatchEvent(new CustomEvent(e.newState === "open" && e.oldState !== "open" ? "open" : "close", {
-				bubbles: !0,
-				composed: !0,
-				detail: { trigger: e.source }
-			}));
-		}), this.host.addEventListener("command", ((e) => {
-			e.command === "toggle-popover" && this.host.togglePopover({ source: e.source }), e.command === "hide-popover" && (this.host.hidePopover(), this.#s()), e.command === "show-popover" && this.host.showPopover({ source: e.source });
-		})), this.host.addEventListener("interest", ((e) => {
-			if (e.source?.localName.includes("-")) {
-				let t = this.host.openDelay ?? this.#c();
-				t ? this.#t = setTimeout(() => {
-					this.host.isConnected && this.host.showPopover({ source: e.source });
-				}, t) : this.host.showPopover({ source: e.source });
-			}
-		})), this.host.addEventListener("loseinterest", ((e) => {
-			e.source?.localName.includes("-") && this.host.hidePopover(), this.#t &&= (clearTimeout(this.#t), null);
-		}));
+		i(this.host), this.host.popover = this.host.popoverType ?? null, await this.host.updateComplete, this.host.isConnected && (this.host.setAttribute("nve-popover", ""), this.#m(), this.#p(), this.#d(), this.host.inert = this.host.matches(":not(:popover-open)") && !!this.#e.length, this.host.addEventListener("beforetoggle", this.#b), this.host.addEventListener("toggle", this.#x), this.host.addEventListener("command", this.#S), this.host.addEventListener("interest", this.#C), this.host.addEventListener("loseinterest", this.#w));
 	}
 	#t = null;
 	#n = null;
 	#r = [];
 	#i = null;
+	#a = null;
 	async hostUpdated() {
-		this.host.popover = this.host.popoverType ?? null, this.#p();
+		this.host.popover = this.host.popoverType ?? null, this.#m();
 	}
 	hostDisconnected() {
-		this.#r.forEach((e) => e.disconnect()), this.#s(), this.#o();
-	}
-	#a() {
-		this.#o(), this.host.closeTimeout && (this.#n = setTimeout(() => this.host.hidePopover(), this.host.closeTimeout));
+		this.#r.forEach((e) => e.disconnect()), this.#r.length = 0, this.host.removeEventListener("beforetoggle", this.#b), this.host.removeEventListener("toggle", this.#x), this.host.removeEventListener("command", this.#S), this.host.removeEventListener("interest", this.#C), this.host.removeEventListener("loseinterest", this.#w), this.host.removeEventListener("pointerdown", this.#T), this.host.removeEventListener("pointerup", this.#E), this.#y(), this.#c(), this.#s();
 	}
 	#o() {
-		this.#n &&= (clearTimeout(this.#n), null);
+		this.#s(), this.host.closeTimeout && (this.#n = setTimeout(() => this.host.hidePopover(), this.host.closeTimeout));
 	}
 	#s() {
-		this.#t &&= (clearTimeout(this.#t), null);
+		this.#n &&= (clearTimeout(this.#n), null);
 	}
 	#c() {
+		this.#t &&= (clearTimeout(this.#t), null);
+	}
+	#l() {
 		let e = getComputedStyle(this.host).interestDelayStart;
 		if (!e) return 0;
 		let t = parseFloat(e);
 		return e.endsWith("ms") ? t : t * 1e3;
 	}
-	#l = !1;
-	#u() {
-		this.host.addEventListener("pointerdown", (e) => {
-			this.host.modal && this.host.matches(":popover-open") && (this.#l = t(e, this.host));
-		}), this.host.addEventListener("pointerup", (e) => {
-			this.#l && this.host.popoverDismissible && this.host.modal && this.host.matches(":popover-open") && !s(this.host) && t(e, this.host) && this.host.hidePopover();
-		});
+	#u = !1;
+	#d() {
+		this.host.removeEventListener("pointerdown", this.#T), this.host.removeEventListener("pointerup", this.#E), this.host.addEventListener("pointerdown", this.#T), this.host.addEventListener("pointerup", this.#E);
 	}
-	get #d() {
+	get #f() {
 		return this.host.trigger ? o(this.host, this.host.trigger) : null;
 	}
-	async #f() {
+	async #p() {
 		await new Promise((e) => requestAnimationFrame(e)), this.#r.push(r(this.host, ["hidden"], () => {
 			this.host.isConnected && !this.host.hidden && !this.host.matches(":popover-open") && this.host.showPopover(), this.host.isConnected && this.host.hidden && this.host.matches(":popover-open") && this.host.hidePopover();
 		})), this.host.isConnected && !this.#e.length && !this.host.hidden && !this.host.matches(":popover-open") && (this.host.popover = "manual", this.host.showPopover());
 	}
-	#p() {
-		let e = this.#d;
-		this.#i && this.#i !== e && (this.#i.popoverTargetElement = null, this.#i.removeAttribute("popovertarget")), e && (this.host.popoverType === "hint" ? (e.addEventListener("mouseenter", () => this.host.showPopover({ source: e })), e.addEventListener("mouseleave", () => this.host.hidePopover()), e.addEventListener("focusout", () => this.host.hidePopover())) : (this.host.id = this.host.id ? this.host.id : n(), e.popoverTargetElement = this.host, e.setAttribute("popovertarget", this.host.id)), this.#i = e);
+	#m() {
+		let e = this.#f;
+		if (this.#i && this.#i !== e && this.#v(this.#i), this.#a && this.#a !== e && this.#y(), !e) {
+			this.#i = null;
+			return;
+		}
+		this.host.popoverType === "hint" ? this.#h(e) : this.#g(e), this.#i = e;
+	}
+	#h(e) {
+		this.#a !== e && (e.addEventListener("mouseenter", this.#D), e.addEventListener("mouseleave", this.#O), e.addEventListener("focusout", this.#O), this.#a = e);
+	}
+	#g(e) {
+		this.#y(), this.host.id = this.host.id ? this.host.id : n(), e.popoverTargetElement = this.host, e.setAttribute("popovertarget", this.host.id);
 	}
-	#m(t, n) {
+	#_(t, n) {
 		t ? this.host.getRootNode().activeElement !== this.host && !this.host.shadowRoot.activeElement && e(this.host) : e(n);
 	}
+	#v(e) {
+		e.popoverTargetElement = null, e.removeAttribute("popovertarget"), this.#a === e && this.#y();
+	}
+	#y() {
+		this.#a?.removeEventListener("mouseenter", this.#D), this.#a?.removeEventListener("mouseleave", this.#O), this.#a?.removeEventListener("focusout", this.#O), this.#a = null;
+	}
+	#b = (e) => {
+		e.newState === "open" && this.host._internals.states.add("transition-start");
+	};
+	#x = (e) => {
+		this.host.behaviorTrigger && (this.host.hidden = e.newState === "closed"), e.newState === "open" && this.host.closeTimeout && this.#o(), e.newState === "closed" && (this.#c(), this.#s()), this.host.inert = this.host.matches(":not(:popover-open)"), this.host.modal && this.#_(e.newState === "open", e.target), this.host.dispatchEvent(new CustomEvent(e.newState === "open" && e.oldState !== "open" ? "open" : "close", {
+			bubbles: !0,
+			composed: !0,
+			detail: { trigger: e.source }
+		}));
+	};
+	#S = (e) => {
+		e.command === "toggle-popover" && this.host.togglePopover({ source: e.source }), e.command === "hide-popover" && (this.host.hidePopover(), this.#c()), e.command === "show-popover" && this.host.showPopover({ source: e.source });
+	};
+	#C = (e) => {
+		if (e.source?.localName.includes("-")) {
+			let t = this.host.openDelay ?? this.#l();
+			t ? this.#t = setTimeout(() => {
+				this.host.isConnected && this.host.showPopover({ source: e.source });
+			}, t) : this.host.showPopover({ source: e.source });
+		}
+	};
+	#w = (e) => {
+		e.source?.localName.includes("-") && this.host.hidePopover(), this.#c();
+	};
+	#T = (e) => {
+		this.host.modal && this.host.matches(":popover-open") && (this.#u = t(e, this.host));
+	};
+	#E = (e) => {
+		this.#u && this.host.popoverDismissible && this.host.modal && this.host.matches(":popover-open") && !s(this.host) && t(e, this.host) && this.host.hidePopover();
+	};
+	#D = (e) => {
+		this.host.showPopover({ source: e.currentTarget });
+	};
+	#O = () => {
+		this.host.hidePopover();
+	};
 };
 //#endregion
 export { c as TypeNativePopoverController };

package/dist/internal/controllers/type-native-popover.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-native-popover.controller.js","names":["#nativeTriggers","#updateLegacyTriggers","#setupLegacyTriggers","#setupModalLightDismiss","#setCloseTimeout","#clearInterestTimeout","#clearCloseTimeout","#toggleFocus","#parseInterestDelay","#interestTimeout","#observers","#closeTimeout","#pointerdownWithinModal","#legacyHostTrigger","#previousLegacyTrigger"],"sources":["../../../src/internal/controllers/type-native-popover.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 { clickOutsideElementBounds, generateId, getAttributeListChanges } from '../utils/dom.js';\nimport { attachInternals } from '../utils/a11y.js';\nimport { focusElement } from '../utils/focus.js';\nimport { getHostAnchor, getHostTrigger, hasOpenPopover } from './type-native-popover.utils.js';\nimport type { PopoverType } from '../types/index.js';\nimport type { InterestEvent } from './type-interest.controller.js';\n\nexport interface NativePopover extends ReactiveElement {\n  anchor?: HTMLElement | string;\n  closeTimeout?: number;\n  popoverType?: PopoverType;\n  modal?: boolean;\n  popoverDismissible?: boolean;\n  _activeTrigger?: HTMLElement;\n  _internals?: ElementInternals;\n\n  /** @deprecated */\n  trigger?: HTMLElement | string;\n  /** @deprecated */\n  openDelay?: number;\n  /** @deprecated */\n  behaviorTrigger?: boolean;\n}\n\n/**\n * https://open-ui.org/components/popup.research.explainer\n */\nexport class TypeNativePopoverController<T extends NativePopover> implements ReactiveController {\n  get #nativeTriggers(): HTMLElement[] {\n    const root = this.host.getRootNode() as HTMLElement;\n    const popoverTargetTriggers = Array.from(\n      root.querySelectorAll(`[popovertarget=\"${CSS.escape ? CSS.escape(this.host.id) : this.host.id}\"]`)\n    ) as HTMLElement[];\n\n    const commandForTriggers = Array.from(\n      root.querySelectorAll(`[commandfor=\"${CSS.escape ? CSS.escape(this.host.id) : this.host.id}\"]`)\n    ) as HTMLElement[];\n\n    const interestForTriggers = Array.from(\n      root.querySelectorAll(`[interestfor=\"${CSS.escape ? CSS.escape(this.host.id) : this.host.id}\"]`)\n    ) as HTMLElement[];\n\n    return [...popoverTargetTriggers, ...commandForTriggers, ...interestForTriggers];\n  }\n\n  constructor(private host: T) {\n    this.host.addController(this);\n\n    const showPopover = this.host.showPopover;\n    this.host.showPopover = (options?: ShowPopoverOptions) => {\n      if (this.host.isConnected) {\n        // provide legacy fallback for source anchor or trigger if not provided, this can happen if the popover is dynamically created in the DOM without the use of the standard popover api or legacy trigger based api\n        let source: HTMLElement | Element | null = options?.source ?? null;\n        if (!source) {\n          if (this.host.anchor) {\n            source = getHostAnchor(this.host);\n          } else if (this.host.trigger) {\n            source = getHostTrigger(this.host, this.host.trigger);\n          } else {\n            source = globalThis.document.activeElement;\n          }\n        }\n\n        showPopover.call(this.host, { source: source as HTMLElement });\n      }\n    };\n  }\n\n  // eslint-disable-next-line max-lines-per-function\n  async hostConnected() {\n    attachInternals(this.host);\n    this.host.popover = this.host.popoverType ?? null;\n    await this.host.updateComplete;\n    this.host.setAttribute('nve-popover', '');\n    this.#updateLegacyTriggers();\n    this.#setupLegacyTriggers(); // eslint-disable-line @typescript-eslint/no-floating-promises\n    this.#setupModalLightDismiss();\n    this.host.inert = this.host.matches(':not(:popover-open)') && !!this.#nativeTriggers.length;\n\n    this.host.addEventListener('beforetoggle', e => {\n      if (e.newState === 'open') {\n        this.host._internals!.states.add('transition-start');\n      }\n    });\n\n    this.host.addEventListener('toggle', (e: ToggleEvent) => {\n      if (this.host.behaviorTrigger) {\n        this.host.hidden = e.newState === 'closed';\n      }\n\n      if (e.newState === 'open' && this.host.closeTimeout) {\n        this.#setCloseTimeout();\n      }\n\n      if (e.newState === 'closed') {\n        this.#clearInterestTimeout();\n        this.#clearCloseTimeout();\n      }\n\n      this.host.inert = this.host.matches(':not(:popover-open)');\n\n      if (this.host.modal) {\n        this.#toggleFocus(e.newState === 'open', e.target as HTMLElement);\n      }\n\n      this.host.dispatchEvent(\n        new CustomEvent(e.newState === 'open' && e.oldState !== 'open' ? 'open' : 'close', {\n          bubbles: true,\n          composed: true,\n          detail: { trigger: e.source }\n        })\n      );\n    });\n\n    // https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API#creating_declarative_popovers\n    this.host.addEventListener('command', ((e: CommandEvent) => {\n      if (e.command === 'toggle-popover') {\n        this.host.togglePopover({ source: e.source as HTMLElement });\n      }\n\n      if (e.command === 'hide-popover') {\n        this.host.hidePopover();\n        this.#clearInterestTimeout();\n      }\n\n      if (e.command === 'show-popover') {\n        this.host.showPopover({ source: e.source as HTMLElement });\n      }\n    }) as EventListener);\n\n    // https://developer.mozilla.org/en-US/docs/Web/API/Popover_API/Using_interest_invokers\n    this.host.addEventListener('interest', ((e: InterestEvent) => {\n      const isCustomElement = e.source?.localName.includes('-');\n      if (isCustomElement) {\n        const interestDelayStart = this.host.openDelay ?? this.#parseInterestDelay();\n        if (interestDelayStart) {\n          this.#interestTimeout = setTimeout(() => {\n            if (this.host.isConnected) {\n              this.host.showPopover({ source: e.source as HTMLElement });\n            }\n          }, interestDelayStart);\n        } else {\n          this.host.showPopover({ source: e.source as HTMLElement });\n        }\n      }\n    }) as EventListener);\n\n    this.host.addEventListener('loseinterest', ((e: InterestEvent) => {\n      const isCustomElement = e.source?.localName.includes('-');\n      if (isCustomElement) {\n        this.host.hidePopover();\n      }\n\n      if (this.#interestTimeout) {\n        clearTimeout(this.#interestTimeout);\n        this.#interestTimeout = null;\n      }\n    }) as EventListener);\n  }\n\n  #interestTimeout: ReturnType<typeof setTimeout> | null = null;\n  #closeTimeout: ReturnType<typeof setTimeout> | null = null;\n  #observers: MutationObserver[] = [];\n  #previousLegacyTrigger: HTMLButtonElement | null = null;\n\n  async hostUpdated() {\n    this.host.popover = this.host.popoverType ?? null;\n    this.#updateLegacyTriggers();\n  }\n\n  hostDisconnected() {\n    this.#observers.forEach(observer => observer.disconnect());\n    this.#clearInterestTimeout();\n    this.#clearCloseTimeout();\n  }\n\n  #setCloseTimeout() {\n    this.#clearCloseTimeout();\n    if (this.host.closeTimeout) {\n      this.#closeTimeout = setTimeout(() => this.host.hidePopover(), this.host.closeTimeout);\n    }\n  }\n\n  #clearCloseTimeout() {\n    if (this.#closeTimeout) {\n      clearTimeout(this.#closeTimeout);\n      this.#closeTimeout = null;\n    }\n  }\n\n  #clearInterestTimeout() {\n    if (this.#interestTimeout) {\n      clearTimeout(this.#interestTimeout);\n      this.#interestTimeout = null;\n    }\n  }\n\n  #parseInterestDelay(): number {\n    const style = getComputedStyle(this.host);\n    const raw = (style as unknown as { interestDelayStart: string }).interestDelayStart;\n    if (!raw) {\n      return 0;\n    }\n    const value = parseFloat(raw);\n    return raw.endsWith('ms') ? value : value * 1000;\n  }\n\n  #pointerdownWithinModal = false;\n\n  #setupModalLightDismiss() {\n    this.host.addEventListener('pointerdown', e => {\n      if (this.host.modal && this.host.matches(':popover-open')) {\n        this.#pointerdownWithinModal = clickOutsideElementBounds(e, this.host);\n      }\n    });\n\n    this.host.addEventListener('pointerup', e => {\n      if (\n        this.#pointerdownWithinModal &&\n        this.host.popoverDismissible &&\n        this.host.modal &&\n        this.host.matches(':popover-open') &&\n        !hasOpenPopover(this.host) &&\n        clickOutsideElementBounds(e, this.host)\n      ) {\n        this.host.hidePopover();\n      }\n    });\n  }\n\n  get #legacyHostTrigger(): HTMLElement | null {\n    return this.host.trigger ? (getHostTrigger(this.host, this.host.trigger) as HTMLButtonElement) : null;\n  }\n\n  /**\n   * @deprecated Legacy behavior that allows popovers to show as open by default when using the legacy trigger based api\n   */\n  async #setupLegacyTriggers() {\n    await new Promise(r => requestAnimationFrame(r));\n\n    // setup hidden updates for legacy triggers\n    this.#observers.push(\n      getAttributeListChanges(this.host, ['hidden'], () => {\n        if (this.host.isConnected && !this.host.hidden && !this.host.matches(':popover-open')) {\n          this.host.showPopover();\n        }\n\n        if (this.host.isConnected && this.host.hidden && this.host.matches(':popover-open')) {\n          this.host.hidePopover();\n        }\n      })\n    );\n\n    // determine if popover is open by default\n    if (\n      this.host.isConnected &&\n      !this.#nativeTriggers.length &&\n      !this.host.hidden &&\n      !this.host.matches(':popover-open')\n    ) {\n      this.host.popover = 'manual';\n      this.host.showPopover();\n    }\n  }\n\n  /**\n   * @deprecated Legacy behavior that allows popovers to show as open by default when using the legacy trigger based api\n   */\n  #updateLegacyTriggers() {\n    const trigger = this.#legacyHostTrigger as HTMLButtonElement;\n\n    // Clean up previous trigger if it changed\n    if (this.#previousLegacyTrigger && this.#previousLegacyTrigger !== trigger) {\n      this.#previousLegacyTrigger.popoverTargetElement = null;\n      this.#previousLegacyTrigger.removeAttribute('popovertarget');\n    }\n\n    // if not a hint type setup native popovertarget\n    if (trigger) {\n      if (this.host.popoverType === 'hint') {\n        trigger.addEventListener('mouseenter', () => this.host.showPopover({ source: trigger as HTMLElement }));\n        trigger.addEventListener('mouseleave', () => this.host.hidePopover());\n        trigger.addEventListener('focusout', () => this.host.hidePopover());\n      } else {\n        this.host.id = this.host.id ? this.host.id : generateId();\n        trigger.popoverTargetElement = this.host;\n        trigger.setAttribute('popovertarget', this.host.id);\n      }\n      this.#previousLegacyTrigger = trigger;\n    }\n  }\n\n  #toggleFocus(open: boolean, target: HTMLElement) {\n    if (open) {\n      // only focus popover if not the active element and not containing the active element already\n      if ((this.host.getRootNode() as Document).activeElement !== this.host && !this.host.shadowRoot!.activeElement) {\n        focusElement(this.host);\n      }\n    } else {\n      focusElement(target);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"type-native-popover.controller.js","names":["#nativeTriggers","#updateLegacyTriggers","#setupLegacyTriggers","#setupModalLightDismiss","#onBeforeToggle","#onToggle","#onCommand","#onInterest","#onLoseInterest","#observers","#onPointerDown","#onPointerUp","#removeHintTrigger","#clearInterestTimeout","#clearCloseTimeout","#closeTimeout","#interestTimeout","#legacyHostTrigger","#previousLegacyTrigger","#clearLegacyTrigger","#hintTrigger","#setupHintTrigger","#setupPopoverTargetTrigger","#onHintMouseEnter","#onHintMouseLeave","#setCloseTimeout","#toggleFocus","#parseInterestDelay","#pointerdownWithinModal"],"sources":["../../../src/internal/controllers/type-native-popover.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 { clickOutsideElementBounds, generateId, getAttributeListChanges } from '../utils/dom.js';\nimport { attachInternals } from '../utils/a11y.js';\nimport { focusElement } from '../utils/focus.js';\nimport { getHostAnchor, getHostTrigger, hasOpenPopover } from './type-native-popover.utils.js';\nimport type { InterestEvent, PopoverType } from '../types/index.js';\n\nexport interface NativePopover extends ReactiveElement {\n  anchor?: HTMLElement | string;\n  closeTimeout?: number;\n  popoverType?: PopoverType;\n  modal?: boolean;\n  popoverDismissible?: boolean;\n  _activeTrigger?: HTMLElement;\n  _internals?: ElementInternals;\n\n  /** @deprecated */\n  trigger?: HTMLElement | string;\n  /** @deprecated */\n  openDelay?: number;\n  /** @deprecated */\n  behaviorTrigger?: boolean;\n}\n\n/**\n * https://open-ui.org/components/popup.research.explainer\n */\nexport class TypeNativePopoverController<T extends NativePopover> implements ReactiveController {\n  get #nativeTriggers(): HTMLElement[] {\n    const root = this.host.getRootNode() as HTMLElement;\n    const popoverTargetTriggers = Array.from(\n      root.querySelectorAll(`[popovertarget=\"${CSS.escape ? CSS.escape(this.host.id) : this.host.id}\"]`)\n    ) as HTMLElement[];\n\n    const commandForTriggers = Array.from(\n      root.querySelectorAll(`[commandfor=\"${CSS.escape ? CSS.escape(this.host.id) : this.host.id}\"]`)\n    ) as HTMLElement[];\n\n    const interestForTriggers = Array.from(\n      root.querySelectorAll(`[interestfor=\"${CSS.escape ? CSS.escape(this.host.id) : this.host.id}\"]`)\n    ) as HTMLElement[];\n\n    return [...popoverTargetTriggers, ...commandForTriggers, ...interestForTriggers];\n  }\n\n  constructor(private host: T) {\n    this.host.addController(this);\n\n    const showPopover = this.host.showPopover;\n    this.host.showPopover = (options?: ShowPopoverOptions) => {\n      if (this.host.isConnected) {\n        // provide legacy fallback for source anchor or trigger if not provided, this can happen if the popover is dynamically created in the DOM without the use of the standard popover api or legacy trigger based api\n        let source: HTMLElement | Element | null = options?.source ?? null;\n        if (!source) {\n          if (this.host.anchor) {\n            source = getHostAnchor(this.host);\n          } else if (this.host.trigger) {\n            source = getHostTrigger(this.host, this.host.trigger);\n          } else {\n            source = globalThis.document.activeElement;\n          }\n        }\n\n        showPopover.call(this.host, { source: source as HTMLElement });\n      }\n    };\n  }\n\n  async hostConnected() {\n    attachInternals(this.host);\n    this.host.popover = this.host.popoverType ?? null;\n    await this.host.updateComplete;\n    if (!this.host.isConnected) return;\n\n    this.host.setAttribute('nve-popover', '');\n    this.#updateLegacyTriggers();\n    this.#setupLegacyTriggers(); // eslint-disable-line @typescript-eslint/no-floating-promises\n    this.#setupModalLightDismiss();\n    this.host.inert = this.host.matches(':not(:popover-open)') && !!this.#nativeTriggers.length;\n\n    this.host.addEventListener('beforetoggle', this.#onBeforeToggle);\n    this.host.addEventListener('toggle', this.#onToggle as EventListener);\n    this.host.addEventListener('command', this.#onCommand as EventListener);\n    this.host.addEventListener('interest', this.#onInterest as EventListener);\n    this.host.addEventListener('loseinterest', this.#onLoseInterest as EventListener);\n  }\n\n  #interestTimeout: ReturnType<typeof setTimeout> | null = null;\n  #closeTimeout: ReturnType<typeof setTimeout> | null = null;\n  #observers: MutationObserver[] = [];\n  #previousLegacyTrigger: HTMLButtonElement | null = null;\n  #hintTrigger: HTMLButtonElement | null = null;\n\n  async hostUpdated() {\n    this.host.popover = this.host.popoverType ?? null;\n    this.#updateLegacyTriggers();\n  }\n\n  hostDisconnected() {\n    this.#observers.forEach(observer => observer.disconnect());\n    this.#observers.length = 0;\n    this.host.removeEventListener('beforetoggle', this.#onBeforeToggle);\n    this.host.removeEventListener('toggle', this.#onToggle as EventListener);\n    this.host.removeEventListener('command', this.#onCommand as EventListener);\n    this.host.removeEventListener('interest', this.#onInterest as EventListener);\n    this.host.removeEventListener('loseinterest', this.#onLoseInterest as EventListener);\n    this.host.removeEventListener('pointerdown', this.#onPointerDown);\n    this.host.removeEventListener('pointerup', this.#onPointerUp);\n    this.#removeHintTrigger();\n    this.#clearInterestTimeout();\n    this.#clearCloseTimeout();\n  }\n\n  #setCloseTimeout() {\n    this.#clearCloseTimeout();\n    if (this.host.closeTimeout) {\n      this.#closeTimeout = setTimeout(() => this.host.hidePopover(), this.host.closeTimeout);\n    }\n  }\n\n  #clearCloseTimeout() {\n    if (this.#closeTimeout) {\n      clearTimeout(this.#closeTimeout);\n      this.#closeTimeout = null;\n    }\n  }\n\n  #clearInterestTimeout() {\n    if (this.#interestTimeout) {\n      clearTimeout(this.#interestTimeout);\n      this.#interestTimeout = null;\n    }\n  }\n\n  #parseInterestDelay(): number {\n    const style = getComputedStyle(this.host);\n    const raw = (style as unknown as { interestDelayStart: string }).interestDelayStart;\n    if (!raw) {\n      return 0;\n    }\n    const value = parseFloat(raw);\n    return raw.endsWith('ms') ? value : value * 1000;\n  }\n\n  #pointerdownWithinModal = false;\n\n  #setupModalLightDismiss() {\n    this.host.removeEventListener('pointerdown', this.#onPointerDown);\n    this.host.removeEventListener('pointerup', this.#onPointerUp);\n    this.host.addEventListener('pointerdown', this.#onPointerDown);\n    this.host.addEventListener('pointerup', this.#onPointerUp);\n  }\n\n  get #legacyHostTrigger(): HTMLElement | null {\n    return this.host.trigger ? (getHostTrigger(this.host, this.host.trigger) as HTMLButtonElement) : null;\n  }\n\n  /**\n   * @deprecated Legacy behavior that allows popovers to show as open by default when using the legacy trigger based api\n   */\n  async #setupLegacyTriggers() {\n    await new Promise(r => requestAnimationFrame(r));\n\n    // setup hidden updates for legacy triggers\n    this.#observers.push(\n      getAttributeListChanges(this.host, ['hidden'], () => {\n        if (this.host.isConnected && !this.host.hidden && !this.host.matches(':popover-open')) {\n          this.host.showPopover();\n        }\n\n        if (this.host.isConnected && this.host.hidden && this.host.matches(':popover-open')) {\n          this.host.hidePopover();\n        }\n      })\n    );\n\n    // determine if popover is open by default\n    if (\n      this.host.isConnected &&\n      !this.#nativeTriggers.length &&\n      !this.host.hidden &&\n      !this.host.matches(':popover-open')\n    ) {\n      this.host.popover = 'manual';\n      this.host.showPopover();\n    }\n  }\n\n  /**\n   * @deprecated Legacy behavior that allows popovers to show as open by default when using the legacy trigger based api\n   */\n  #updateLegacyTriggers() {\n    const trigger = this.#legacyHostTrigger as HTMLButtonElement;\n\n    if (this.#previousLegacyTrigger && this.#previousLegacyTrigger !== trigger) {\n      this.#clearLegacyTrigger(this.#previousLegacyTrigger);\n    }\n\n    if (this.#hintTrigger && this.#hintTrigger !== trigger) {\n      this.#removeHintTrigger();\n    }\n\n    if (!trigger) {\n      this.#previousLegacyTrigger = null;\n      return;\n    }\n\n    if (this.host.popoverType === 'hint') {\n      this.#setupHintTrigger(trigger);\n    } else {\n      this.#setupPopoverTargetTrigger(trigger);\n    }\n    this.#previousLegacyTrigger = trigger;\n  }\n\n  #setupHintTrigger(trigger: HTMLButtonElement) {\n    if (this.#hintTrigger === trigger) return;\n\n    trigger.addEventListener('mouseenter', this.#onHintMouseEnter);\n    trigger.addEventListener('mouseleave', this.#onHintMouseLeave);\n    trigger.addEventListener('focusout', this.#onHintMouseLeave);\n    this.#hintTrigger = trigger;\n  }\n\n  #setupPopoverTargetTrigger(trigger: HTMLButtonElement) {\n    this.#removeHintTrigger();\n    this.host.id = this.host.id ? this.host.id : generateId();\n    trigger.popoverTargetElement = this.host;\n    trigger.setAttribute('popovertarget', this.host.id);\n  }\n\n  #toggleFocus(open: boolean, target: HTMLElement) {\n    if (open) {\n      // only focus popover if not the active element and not containing the active element already\n      if ((this.host.getRootNode() as Document).activeElement !== this.host && !this.host.shadowRoot!.activeElement) {\n        focusElement(this.host);\n      }\n    } else {\n      focusElement(target);\n    }\n  }\n\n  #clearLegacyTrigger(trigger: HTMLButtonElement) {\n    trigger.popoverTargetElement = null;\n    trigger.removeAttribute('popovertarget');\n    if (this.#hintTrigger === trigger) {\n      this.#removeHintTrigger();\n    }\n  }\n\n  #removeHintTrigger() {\n    this.#hintTrigger?.removeEventListener('mouseenter', this.#onHintMouseEnter);\n    this.#hintTrigger?.removeEventListener('mouseleave', this.#onHintMouseLeave);\n    this.#hintTrigger?.removeEventListener('focusout', this.#onHintMouseLeave);\n    this.#hintTrigger = null;\n  }\n\n  #onBeforeToggle = (e: ToggleEvent) => {\n    if (e.newState === 'open') {\n      this.host._internals!.states.add('transition-start');\n    }\n  };\n\n  #onToggle = (e: ToggleEvent) => {\n    if (this.host.behaviorTrigger) {\n      this.host.hidden = e.newState === 'closed';\n    }\n\n    if (e.newState === 'open' && this.host.closeTimeout) {\n      this.#setCloseTimeout();\n    }\n\n    if (e.newState === 'closed') {\n      this.#clearInterestTimeout();\n      this.#clearCloseTimeout();\n    }\n\n    this.host.inert = this.host.matches(':not(:popover-open)');\n\n    if (this.host.modal) {\n      this.#toggleFocus(e.newState === 'open', e.target as HTMLElement);\n    }\n\n    this.host.dispatchEvent(\n      new CustomEvent(e.newState === 'open' && e.oldState !== 'open' ? 'open' : 'close', {\n        bubbles: true,\n        composed: true,\n        detail: { trigger: e.source }\n      })\n    );\n  };\n\n  #onCommand = (e: CommandEvent) => {\n    if (e.command === 'toggle-popover') {\n      this.host.togglePopover({ source: e.source as HTMLElement });\n    }\n\n    if (e.command === 'hide-popover') {\n      this.host.hidePopover();\n      this.#clearInterestTimeout();\n    }\n\n    if (e.command === 'show-popover') {\n      this.host.showPopover({ source: e.source as HTMLElement });\n    }\n  };\n\n  #onInterest = (e: InterestEvent) => {\n    const isCustomElement = e.source?.localName.includes('-');\n    if (isCustomElement) {\n      const interestDelayStart = this.host.openDelay ?? this.#parseInterestDelay();\n      if (interestDelayStart) {\n        this.#interestTimeout = setTimeout(() => {\n          if (this.host.isConnected) {\n            this.host.showPopover({ source: e.source as HTMLElement });\n          }\n        }, interestDelayStart);\n      } else {\n        this.host.showPopover({ source: e.source as HTMLElement });\n      }\n    }\n  };\n\n  #onLoseInterest = (e: InterestEvent) => {\n    const isCustomElement = e.source?.localName.includes('-');\n    if (isCustomElement) {\n      this.host.hidePopover();\n    }\n\n    this.#clearInterestTimeout();\n  };\n\n  #onPointerDown = (e: PointerEvent) => {\n    if (this.host.modal && this.host.matches(':popover-open')) {\n      this.#pointerdownWithinModal = clickOutsideElementBounds(e, this.host);\n    }\n  };\n\n  #onPointerUp = (e: PointerEvent) => {\n    if (\n      this.#pointerdownWithinModal &&\n      this.host.popoverDismissible &&\n      this.host.modal &&\n      this.host.matches(':popover-open') &&\n      !hasOpenPopover(this.host) &&\n      clickOutsideElementBounds(e, this.host)\n    ) {\n      this.host.hidePopover();\n    }\n  };\n\n  #onHintMouseEnter = (e: MouseEvent) => {\n    this.host.showPopover({ source: e.currentTarget as HTMLElement });\n  };\n\n  #onHintMouseLeave = () => {\n    this.host.hidePopover();\n  };\n}\n"],"mappings":"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"}

package/dist/internal/index.d.ts

@@ -5,25 +5,16 @@ export * from './controllers/audit.controller.js';
 export * from './controllers/i18n.controller.js';
 export * from './controllers/keynav-grid.controller.js';
 export * from './controllers/keynav-list.controller.js';
-export * from './controllers/state-active.controller.js';
-export * from './controllers/state-current.controller.js';
-export * from './controllers/state-disabled.controller.js';
 export * from './controllers/state-expanded.controller.js';
 export * from './controllers/state-highlighted.controller.js';
 export * from './controllers/state-scroll.controller.js';
 export * from './controllers/state-selected.controller.js';
-export * from './controllers/state-pressed.controller.js';
 export * from './controllers/type-anchor.controller.js';
 export * from './controllers/type-closable.controller.js';
-export * from './controllers/type-command.controller.js';
-export * from './controllers/type-interest.controller.js';
 export * from './controllers/type-expandable.controller.js';
 export * from './controllers/type-selectable.controller.js';
-export * from './controllers/type-button.controller.js';
-export * from './controllers/type-native-popover-trigger.controller.js';
 export * from './controllers/type-native-popover.controller.js';
 export * from './controllers/type-ssr.controller.js';
-export * from './controllers/type-submit.controller.js';
 export * from './controllers/type-touch.controller.js';
 export * from './decorators/host-attr.js';
 export * from './decorators/scoped-registry.js';

package/dist/internal/index.js

@@ -12,32 +12,23 @@ import { KeynavCode as N, appendAnchorName as P, appendRootNodeStyle as F, apply
 import { KeyNavigationGridController as _e, getNextKeyGridItem as ve, keyNavigationGrid as ye } from "./controllers/keynav-grid.controller.js";
 import { KeyNavigationListController as be, getNextKeyListItem as xe, keyNavigationList as Se } from "./controllers/keynav-list.controller.js";
 import { associateAriaDescribedBy as Ce, associateAriaLabel as we, associateControlGroup as Te, associateDataList as Ee, associateLabel as De, attachInternals as Oe } from "./utils/a11y.js";
-import { StateActiveController as ke, stateActive as Ae } from "./controllers/state-active.controller.js";
-import { StateCurrentController as je, stateCurrent as Me } from "./controllers/state-current.controller.js";
-import { StateDisabledController as Ne, stateDisabled as Pe } from "./controllers/state-disabled.controller.js";
-import { StateExpandedController as Fe, stateExpanded as Ie } from "./controllers/state-expanded.controller.js";
-import { StateHighlightedController as Le, stateHighlighted as Re } from "./controllers/state-highlighted.controller.js";
-import { StateScrollController as ze, stateScroll as Be } from "./controllers/state-scroll.controller.js";
-import { StateSelectedController as Ve, stateSelected as He } from "./controllers/state-selected.controller.js";
-import { StatePressedController as Ue, statePressed as We } from "./controllers/state-pressed.controller.js";
-import { TypeAnchorController as Ge, typeAnchor as Ke } from "./controllers/type-anchor.controller.js";
-import { TypeClosableController as qe } from "./controllers/type-closable.controller.js";
-import { TypeCommandController as Je, typeCommand as Ye } from "./controllers/type-command.controller.js";
-import { TypeInterestController as Xe, typeInterest as Ze } from "./controllers/type-interest.controller.js";
-import { TypeExpandableController as Qe } from "./controllers/type-expandable.controller.js";
-import { TypeSelectableController as $e } from "./controllers/type-selectable.controller.js";
-import { TypeButtonController as et, typeButton as tt } from "./controllers/type-button.controller.js";
-import { TypeNativePopoverTriggerController as nt, typeNativePopoverTrigger as rt } from "./controllers/type-native-popover-trigger.controller.js";
-import { TypeNativePopoverController as it } from "./controllers/type-native-popover.controller.js";
-import { TypeSSRController as at, typeSSR as ot } from "./controllers/type-ssr.controller.js";
-import { createLightDismiss as st, onKeys as ct } from "./utils/keynav.js";
-import { TypeSubmitController as lt, typeSubmit as ut } from "./controllers/type-submit.controller.js";
-import { NveTouchEvent as dt, TypeTouchController as ft, typeTouch as pt } from "./controllers/type-touch.controller.js";
-import { hostAttr as mt } from "./decorators/host-attr.js";
-import { scopedRegistry as ht } from "./decorators/scoped-registry.js";
-import { colorStateStyles as gt, statusStateStyles as _t, supportStateStyles as vt, useStyles as yt } from "./styles/index.js";
-import { supportsCSSLegacyInsetArea as bt, supportsCSSPositionArea as xt, supportsNativeCSSAnchorPosition as St } from "./utils/supports.js";
-import { popoverStyles as Ct } from "./styles/popover2.js";
-import { TransitionService as wt } from "./services/transition.service.js";
-import { statusIcons as Tt } from "./types/index.js";
-export { p as AuditController, e as DOCS_URL, l as GlobalState, u as GlobalStateService, v as I18nController, g as I18nService, _ as I18nService_, _e as KeyNavigationGridController, be as KeyNavigationListController, N as KeynavCode, w as LogService, dt as NveTouchEvent, ke as StateActiveController, je as StateCurrentController, Ne as StateDisabledController, Fe as StateExpandedController, Le as StateHighlightedController, Ue as StatePressedController, ze as StateScrollController, Ve as StateSelectedController, wt as TransitionService, Ge as TypeAnchorController, et as TypeButtonController, qe as TypeClosableController, Je as TypeCommandController, Qe as TypeExpandableController, Xe as TypeInterestController, it as TypeNativePopoverController, nt as TypeNativePopoverTriggerController, at as TypeSSRController, $e as TypeSelectableController, lt as TypeSubmitController, ft as TypeTouchController, P as appendAnchorName, F as appendRootNodeStyle, I as applySlotContentStates, Ce as associateAriaDescribedBy, we as associateAriaLabel, Te as associateControlGroup, Ee as associateDataList, De as associateLabel, Oe as attachInternals, m as audit, d as auditParentElement, f as auditSlots, L as clickOutsideElementBounds, gt as colorStateStyles, R as createGhostElement, st as createLightDismiss, b as debounce, r as deepMerge, z as define, B as defineElement, V as endOfScrollBox, h as excessiveInstanceLimit, T as focusElement, E as focusElementTimeout, t as formatFileSize, i as formatStandardNumber, H as generateId, D as getActiveElement, U as getAnchorNames, W as getAttributeChanges, G as getAttributeListChanges, K as getChildren, a as getDifference, q as getDisplayValue, J as getElementUpdate, Y as getFlattenedDOMTree, X as getFlattenedFocusableItems, ve as getNextKeyGridItem, xe as getNextKeyListItem, Z as getPropertyChanges, Q as getThemeTokens, $ as hasHorizontalScrollBar, ee as hasInvalidDOMGrid, te as hasScrollBar, mt as hostAttr, y as i18n, O as initializeKeyListItems, ne as isContextMenuClick, k as isFocusable, o as isObject, s as isObjectLiteral, A as isSimpleFocusable, ye as keyNavigationGrid, Se as keyNavigationList, re as matchesElementName, x as onChildListMutation, ct as onKeys, j as onListboxActivate, ie as openEyeDropper, ae as parseTokenNumber, c as parseVersion, Ct as popoverStyles, oe as removeAnchorName, se as removeEmptySlotWhitespace, ce as removeEmptyTextNode, le as sameOrderedStringArray, ue as sameRenderRoot, ht as scopedRegistry, de as scrollBarWidth, M as setActiveKeyListItem, n as shiftLeft, fe as slotContainsOnlyWhitespace, Ae as stateActive, Me as stateCurrent, Pe as stateDisabled, Ie as stateExpanded, Re as stateHighlighted, We as statePressed, Be as stateScroll, He as stateSelected, Tt as statusIcons, _t as statusStateStyles, S as stopEvent, pe as styleSheetToString, vt as supportStateStyles, bt as supportsCSSLegacyInsetArea, xt as supportsCSSPositionArea, St as supportsNativeCSSAnchorPosition, me as supportsScopedRegistry, C as throttle, Ke as typeAnchor, tt as typeButton, Ye as typeCommand, Ze as typeInterest, rt as typeNativePopoverTrigger, ot as typeSSR, ut as typeSubmit, pt as typeTouch, he as uniqueNonEmptyStrings, yt as useStyles, ge as validKeyNavigationCode };
+import { StateExpandedController as ke, stateExpanded as Ae } from "./controllers/state-expanded.controller.js";
+import { StateHighlightedController as je, stateHighlighted as Me } from "./controllers/state-highlighted.controller.js";
+import { StateScrollController as Ne, stateScroll as Pe } from "./controllers/state-scroll.controller.js";
+import { StateSelectedController as Fe, stateSelected as Ie } from "./controllers/state-selected.controller.js";
+import { TypeAnchorController as Le, typeAnchor as Re } from "./controllers/type-anchor.controller.js";
+import { TypeClosableController as ze } from "./controllers/type-closable.controller.js";
+import { TypeExpandableController as Be } from "./controllers/type-expandable.controller.js";
+import { TypeSelectableController as Ve } from "./controllers/type-selectable.controller.js";
+import { TypeNativePopoverController as He } from "./controllers/type-native-popover.controller.js";
+import { TypeSSRController as Ue, typeSSR as We } from "./controllers/type-ssr.controller.js";
+import { NveTouchEvent as Ge, TypeTouchController as Ke, typeTouch as qe } from "./controllers/type-touch.controller.js";
+import { hostAttr as Je } from "./decorators/host-attr.js";
+import { scopedRegistry as Ye } from "./decorators/scoped-registry.js";
+import { colorStateStyles as Xe, statusStateStyles as Ze, supportStateStyles as Qe, useStyles as $e } from "./styles/index.js";
+import { supportsCSSLegacyInsetArea as et, supportsCSSPositionArea as tt, supportsNativeCSSAnchorPosition as nt } from "./utils/supports.js";
+import { popoverStyles as rt } from "./styles/popover2.js";
+import { TransitionService as it } from "./services/transition.service.js";
+import { statusIcons as at } from "./types/index.js";
+import { createLightDismiss as ot, onKeys as st } from "./utils/keynav.js";
+export { p as AuditController, e as DOCS_URL, l as GlobalState, u as GlobalStateService, v as I18nController, g as I18nService, _ as I18nService_, _e as KeyNavigationGridController, be as KeyNavigationListController, N as KeynavCode, w as LogService, Ge as NveTouchEvent, ke as StateExpandedController, je as StateHighlightedController, Ne as StateScrollController, Fe as StateSelectedController, it as TransitionService, Le as TypeAnchorController, ze as TypeClosableController, Be as TypeExpandableController, He as TypeNativePopoverController, Ue as TypeSSRController, Ve as TypeSelectableController, Ke as TypeTouchController, P as appendAnchorName, F as appendRootNodeStyle, I as applySlotContentStates, Ce as associateAriaDescribedBy, we as associateAriaLabel, Te as associateControlGroup, Ee as associateDataList, De as associateLabel, Oe as attachInternals, m as audit, d as auditParentElement, f as auditSlots, L as clickOutsideElementBounds, Xe as colorStateStyles, R as createGhostElement, ot as createLightDismiss, b as debounce, r as deepMerge, z as define, B as defineElement, V as endOfScrollBox, h as excessiveInstanceLimit, T as focusElement, E as focusElementTimeout, t as formatFileSize, i as formatStandardNumber, H as generateId, D as getActiveElement, U as getAnchorNames, W as getAttributeChanges, G as getAttributeListChanges, K as getChildren, a as getDifference, q as getDisplayValue, J as getElementUpdate, Y as getFlattenedDOMTree, X as getFlattenedFocusableItems, ve as getNextKeyGridItem, xe as getNextKeyListItem, Z as getPropertyChanges, Q as getThemeTokens, $ as hasHorizontalScrollBar, ee as hasInvalidDOMGrid, te as hasScrollBar, Je as hostAttr, y as i18n, O as initializeKeyListItems, ne as isContextMenuClick, k as isFocusable, o as isObject, s as isObjectLiteral, A as isSimpleFocusable, ye as keyNavigationGrid, Se as keyNavigationList, re as matchesElementName, x as onChildListMutation, st as onKeys, j as onListboxActivate, ie as openEyeDropper, ae as parseTokenNumber, c as parseVersion, rt as popoverStyles, oe as removeAnchorName, se as removeEmptySlotWhitespace, ce as removeEmptyTextNode, le as sameOrderedStringArray, ue as sameRenderRoot, Ye as scopedRegistry, de as scrollBarWidth, M as setActiveKeyListItem, n as shiftLeft, fe as slotContainsOnlyWhitespace, Ae as stateExpanded, Me as stateHighlighted, Pe as stateScroll, Ie as stateSelected, at as statusIcons, Ze as statusStateStyles, S as stopEvent, pe as styleSheetToString, Qe as supportStateStyles, et as supportsCSSLegacyInsetArea, tt as supportsCSSPositionArea, nt as supportsNativeCSSAnchorPosition, me as supportsScopedRegistry, C as throttle, Re as typeAnchor, We as typeSSR, qe as typeTouch, he as uniqueNonEmptyStrings, $e as useStyles, ge 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(new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.0.0"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.0.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(new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.0.2"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.0.2"] = 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/services/log.service.js

@@ -11,7 +11,7 @@ var t = "@nve: ", n = class {
 		e.state.env !== "production" && (console.error(`${t}${n}`, ...r), this.#e("error", n, ...r));
 	}
 	static #e(e, t, ...n) {
-		globalThis.document.dispatchEvent(new CustomEvent("NVE_ELEMENTS_LOG", { detail: {
+		globalThis.document?.dispatchEvent(new CustomEvent("NVE_ELEMENTS_LOG", { detail: {
 			type: e,
 			value: t,
 			args: n

package/dist/internal/services/log.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.service.js","names":["#dispatch"],"sources":["../../../src/internal/services/log.service.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from './global.service.js';\n\nconst prefix = '@nve: ';\n\nexport class LogService {\n  static log(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.log(`${prefix}${value}`, ...args);\n    }\n  }\n\n  static warn(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.warn(`${prefix}${value}`, ...args);\n      this.#dispatch('warn', value, ...args);\n    }\n  }\n\n  static error(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.error(`${prefix}${value}`, ...args);\n      this.#dispatch('error', value, ...args);\n    }\n  }\n\n  static #dispatch(type: 'warn' | 'error', value: string, ...args: unknown[]) {\n    globalThis.document.dispatchEvent(new CustomEvent('NVE_ELEMENTS_LOG', { detail: { type, value, args } }));\n  }\n}\n"],"mappings":";;AAKA,IAAM,IAAS,UAEF,IAAb,MAAwB;CACtB,OAAO,IAAI,GAAe,GAAG,GAAiB;EAC5C,AAAI,EAAmB,MAAM,QAAQ,gBACnC,QAAQ,IAAI,GAAG,IAAS,KAAS,GAAG,CAAI;CAE5C;CAEA,OAAO,KAAK,GAAe,GAAG,GAAiB;EAC7C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,KAAK,GAAG,IAAS,KAAS,GAAG,CAAI,GACzC,KAAKA,GAAU,QAAQ,GAAO,GAAG,CAAI;CAEzC;CAEA,OAAO,MAAM,GAAe,GAAG,GAAiB;EAC9C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,MAAM,GAAG,IAAS,KAAS,GAAG,CAAI,GAC1C,KAAKA,GAAU,SAAS,GAAO,GAAG,CAAI;CAE1C;CAEA,OAAOA,GAAU,GAAwB,GAAe,GAAG,GAAiB;EAC1E,WAAW,SAAS,cAAc,IAAI,YAAY,oBAAoB,EAAE,QAAQ;GAAE;GAAM;GAAO;EAAK,EAAE,CAAC,CAAC;CAC1G;AACF"}
+{"version":3,"file":"log.service.js","names":["#dispatch"],"sources":["../../../src/internal/services/log.service.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from './global.service.js';\n\nconst prefix = '@nve: ';\n\nexport class LogService {\n  static log(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.log(`${prefix}${value}`, ...args);\n    }\n  }\n\n  static warn(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.warn(`${prefix}${value}`, ...args);\n      this.#dispatch('warn', value, ...args);\n    }\n  }\n\n  static error(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.error(`${prefix}${value}`, ...args);\n      this.#dispatch('error', value, ...args);\n    }\n  }\n\n  static #dispatch(type: 'warn' | 'error', value: string, ...args: unknown[]) {\n    globalThis.document?.dispatchEvent(new CustomEvent('NVE_ELEMENTS_LOG', { detail: { type, value, args } }));\n  }\n}\n"],"mappings":";;AAKA,IAAM,IAAS,UAEF,IAAb,MAAwB;CACtB,OAAO,IAAI,GAAe,GAAG,GAAiB;EAC5C,AAAI,EAAmB,MAAM,QAAQ,gBACnC,QAAQ,IAAI,GAAG,IAAS,KAAS,GAAG,CAAI;CAE5C;CAEA,OAAO,KAAK,GAAe,GAAG,GAAiB;EAC7C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,KAAK,GAAG,IAAS,KAAS,GAAG,CAAI,GACzC,KAAKA,GAAU,QAAQ,GAAO,GAAG,CAAI;CAEzC;CAEA,OAAO,MAAM,GAAe,GAAG,GAAiB;EAC9C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,MAAM,GAAG,IAAS,KAAS,GAAG,CAAI,GAC1C,KAAKA,GAAU,SAAS,GAAO,GAAG,CAAI;CAE1C;CAEA,OAAOA,GAAU,GAAwB,GAAe,GAAG,GAAiB;EAC1E,WAAW,UAAU,cAAc,IAAI,YAAY,oBAAoB,EAAE,QAAQ;GAAE;GAAM;GAAO;EAAK,EAAE,CAAC,CAAC;CAC3G;AACF"}

package/dist/internal/types/index.d.ts

@@ -66,6 +66,9 @@ export type TaskStatus = 'scheduled' | 'queued' | 'pending' | 'starting' | 'runn
  * - `hint` no light dismiss, no auto focus, open/close on hover/focus
  */
 export type PopoverType = 'auto' | 'manual' | 'hint' | 'inline';
+export type InterestEvent = Event & {
+    source: HTMLElement;
+};
 /** Controls how the popover aligns along the edge of its anchor element.
  * - `start` - Aligns the popover to the beginning edge of the anchor for left or top alignment.
  * - `end` - Aligns the popover to the ending edge of the anchor for right or bottom alignment.