@nvidia-elements/core 2.22.5 → 2.23.1

package/dist/ghost/ghost.d.ts

@@ -0,0 +1,27 @@
+import { LitElement } from 'lit';
+/**
+ * @element nve-ghost
+ * @description An inert visual preview of content or its prospective placement. Applications control its geometry, movement, and accessible feedback.
+ * @documentation https://nvidia.github.io/elements/docs/elements/ghost/
+ * @since 0.0.0
+ * @stable false
+ * @entrypoint \@nvidia-elements/core/ghost
+ * @slot - Presentation content for the preview.
+ * @cssprop --background
+ * @cssprop --border
+ * @cssprop --border-radius
+ * @cssprop --color
+ * @cssprop --stack-offset-x - Nonnegative horizontal distance between layers. Defaults to 4px.
+ * @cssprop --stack-offset-y - Nonnegative vertical distance between layers. Defaults to 4px.
+ * @cssprop --padding
+ */
+export declare class Ghost extends LitElement {
+    static styles: import("lit").CSSResult[];
+    static readonly metadata: {
+        tag: string;
+        version: string;
+    };
+    /** Number of visual surfaces. Rendering truncates fractions and clamps to one through three; nonfinite values use one. */
+    layers: number;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist/ghost/ghost.examples.js

@@ -0,0 +1,5 @@
+// src/ghost/ghost.examples.ts
+var e = "";
+export { e as default };
+
+//# sourceMappingURL=ghost.examples.js.map

package/dist/ghost/ghost.examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost.examples.js","names":["ghost_examples_default"],"sources":["../../src/ghost/ghost.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html } from 'lit';\nimport '@nvidia-elements/core/ghost/define.js';\n\nexport default { title: 'Elements/Ghost', component: 'nve-ghost' };\n\n/**\n * @summary Show a visual preview of content before placement. Include recognizable content to help users identify the preview.\n */\nexport const Preview = {\n  render: () => html`\n<nve-ghost style=\"width:300px;max-width:100%;height:180px\">\n  <div nve-layout=\"column gap:md\">\n    <strong nve-text=\"heading\">Notes</strong>\n    <p nve-text=\"body\">Review the training results and prepare the next run.</p>\n  </div>\n</nve-ghost>`\n};\n\n/**\n * @tags theme\n * @summary Compact carried preview with an opaque surface and a readable title. Customize the surface, border, and text color to distinguish carried content.\n */\nexport const Carried = {\n  render: () => html`\n<nve-ghost style=\"--background:var(--nve-sys-layer-container-background);--border:var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background);--color:var(--nve-sys-text-emphasis-color);width:fit-content;max-width:100%;white-space:nowrap\">Editor</nve-ghost>`\n};\n\n/**\n * @tags theme\n * @summary Show carried items as a compact stack with one label. Set layers to two or three and customize the offsets to adjust their separation.\n */\nexport const Stack = {\n  render: () => html`\n<nve-ghost layers=\"3\" style=\"--background:var(--nve-sys-layer-container-background);--border:var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background);width:fit-content;max-width:100%;white-space:nowrap\">Editor</nve-ghost>`\n};\n"],"mappings":";AAGA,IAAAA,IAAS"}

package/dist/ghost/ghost.examples.json

@@ -0,0 +1,37 @@
+{
+  "element": "nve-ghost",
+  "entrypoint": "@nvidia-elements/core/ghost/ghost.examples.json",
+  "items": [
+    {
+      "id": "ghost-preview",
+      "name": "Preview",
+      "template": "<nve-ghost style=\"width: 300px; max-width: 100%; height: 180px\">\n  <div nve-layout=\"column gap:md\">\n    <strong nve-text=\"heading\">Notes</strong>\n    <p nve-text=\"body\">Review the training results and prepare the next run.</p>\n  </div>\n</nve-ghost>\n",
+      "summary": "Show a visual preview of content before placement. Include recognizable content to help users identify the preview.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "ghost-carried",
+      "name": "Carried",
+      "template": "<nve-ghost\n  style=\"\n    --background: var(--nve-sys-layer-container-background);\n    --border: var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background);\n    --color: var(--nve-sys-text-emphasis-color);\n    width: fit-content;\n    max-width: 100%;\n    white-space: nowrap;\n  \"\n  >Editor</nve-ghost\n>\n",
+      "summary": "Compact carried preview with an opaque surface and a readable title. Customize the surface, border, and text color to distinguish carried content.",
+      "description": "",
+      "composition": false,
+      "tags": [
+        "theme"
+      ]
+    },
+    {
+      "id": "ghost-stack",
+      "name": "Stack",
+      "template": "<nve-ghost\n  layers=\"3\"\n  style=\"--background: var(--nve-sys-layer-container-background); --border: var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background); width: fit-content; max-width: 100%; white-space: nowrap\"\n  >Editor</nve-ghost\n>\n",
+      "summary": "Show carried items as a compact stack with one label. Set layers to two or three and customize the offsets to adjust their separation.",
+      "description": "",
+      "composition": false,
+      "tags": [
+        "theme"
+      ]
+    }
+  ]
+}

package/dist/ghost/ghost.js

@@ -0,0 +1,5 @@
+// src/ghost/ghost.css?inline
+var e = ":host{--background: color-mix(in oklab, var(--nve-sys-accent-secondary-background) 16%, transparent);--border: var(--nve-ref-border-width-md) dashed var(--nve-sys-accent-secondary-background);--border-radius: var(--nve-ref-border-radius-xs);--padding: var(--nve-ref-space-xs);--stack-offset-x: 4px;--stack-offset-y: 4px;--color: var(--nve-sys-text-emphasis-color);border-radius:var(--border-radius);display:block;pointer-events:none}[internal-host]{--_offset-x: max(0px, var(--stack-offset-x));--_offset-y: max(0px, var(--stack-offset-y));box-sizing:border-box;display:grid;grid-template:minmax(0,1fr) / minmax(0,1fr);width:100%;height:100%;padding:0 calc(var(--_back-layers) * var(--_offset-x)) calc(var(--_back-layers) * var(--_offset-y)) 0;border-radius:inherit}.surface{grid-area:1 / 1;min-width:0;min-height:0;box-sizing:border-box;padding:var(--padding);overflow:hidden;text-overflow:ellipsis;background:var(--background);border:var(--border);border-radius:inherit;color:var(--color)}.front{z-index:1}.rear{transform:translate(calc(var(--_layer) * var(--_offset-x)),calc(var(--_layer) * var(--_offset-y)))}";
+export { e as default };
+
+//# sourceMappingURL=ghost.js.map

package/dist/ghost/ghost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost.js","names":["ghost_default"],"sources":["../../src/ghost/ghost.css?inline"],"sourcesContent":["/* SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. */\n/* SPDX-License-Identifier: Apache-2.0 */\n:host {\n  --background: color-mix(in oklab, var(--nve-sys-accent-secondary-background) 16%, transparent);\n  --border: var(--nve-ref-border-width-md) dashed var(--nve-sys-accent-secondary-background);\n  --border-radius: var(--nve-ref-border-radius-xs);\n  --padding: var(--nve-ref-space-xs);\n  --stack-offset-x: 4px;\n  --stack-offset-y: 4px;\n  --color: var(--nve-sys-text-emphasis-color);\n  border-radius: var(--border-radius);\n  display: block;\n  pointer-events: none;\n}\n\n[internal-host] {\n  --_offset-x: max(0px, var(--stack-offset-x));\n  --_offset-y: max(0px, var(--stack-offset-y));\n  box-sizing: border-box;\n  display: grid;\n  grid-template: minmax(0, 1fr) / minmax(0, 1fr);\n  width: 100%;\n  height: 100%;\n  padding: 0 calc(var(--_back-layers) * var(--_offset-x)) calc(var(--_back-layers) * var(--_offset-y)) 0;\n  border-radius: inherit;\n}\n\n.surface {\n  grid-area: 1 / 1;\n  min-width: 0;\n  min-height: 0;\n  box-sizing: border-box;\n  padding: var(--padding);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  background: var(--background);\n  border: var(--border);\n  border-radius: inherit;\n  color: var(--color);\n}\n\n.front {\n  z-index: 1;\n}\n\n.rear {\n  transform: translate(calc(var(--_layer) * var(--_offset-x)), calc(var(--_layer) * var(--_offset-y)));\n}\n"],"mappings":""}

package/dist/ghost/ghost2.js

@@ -0,0 +1,28 @@
+import { useStyles as e } from "../internal/styles/index.js";
+import t from "../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/decorate.js";
+import n from "./ghost.js";
+import { LitElement as r, html as i } from "lit";
+import { property as a } from "lit/decorators/property.js";
+// src/ghost/ghost.ts
+var o = class extends r {
+	constructor(...e) {
+		super(...e), this.layers = 1;
+	}
+	static {
+		this.styles = e([n]);
+	}
+	static {
+		this.metadata = {
+			tag: "nve-ghost",
+			version: "2.23.1"
+		};
+	}
+	render() {
+		let e = Number.isFinite(this.layers) ? Math.min(3, Math.max(1, Math.trunc(this.layers))) : 1;
+		return i`<div internal-host inert aria-hidden="true" style="${`--_back-layers:${e - 1}`}">${Array.from({ length: e - 1 }, (t, n) => i`<div class="surface rear" style="${`--_layer:${e - n - 1}`}"></div>`)}<div class="surface front"><slot></slot></div></div>`;
+	}
+};
+t([a({ type: Number })], o.prototype, "layers", void 0);
+export { o as Ghost };
+
+//# sourceMappingURL=ghost2.js.map

package/dist/ghost/ghost2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost2.js","names":["styles","_decorate","__decorate","ghost_default","Ghost","LitElement","_args","useStyles","layers","index","property"],"sources":["../../src/ghost/ghost.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, LitElement } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport { useStyles } from '@nvidia-elements/core/internal';\nimport styles from './ghost.css?inline';\n\n/**\n * @element nve-ghost\n * @description An inert visual preview of content or its prospective placement. Applications control its geometry, movement, and accessible feedback.\n * @documentation https://nvidia.github.io/elements/docs/elements/ghost/\n * @since 0.0.0\n * @stable false\n * @entrypoint \\@nvidia-elements/core/ghost\n * @slot - Presentation content for the preview.\n * @cssprop --background\n * @cssprop --border\n * @cssprop --border-radius\n * @cssprop --color\n * @cssprop --stack-offset-x - Nonnegative horizontal distance between layers. Defaults to 4px.\n * @cssprop --stack-offset-y - Nonnegative vertical distance between layers. Defaults to 4px.\n * @cssprop --padding\n */\nexport class Ghost extends LitElement {\n  static styles = useStyles([styles]);\n\n  static readonly metadata = { tag: 'nve-ghost', version: '0.0.0' };\n\n  /** Number of visual surfaces. Rendering truncates fractions and clamps to one through three; nonfinite values use one. */\n  @property({ type: Number }) layers = 1;\n\n  render() {\n    const layers = Number.isFinite(this.layers) ? Math.min(3, Math.max(1, Math.trunc(this.layers))) : 1;\n    return html`\n      <div internal-host inert aria-hidden=\"true\" style=${`--_back-layers:${layers - 1}`}>\n        ${Array.from(\n          { length: layers - 1 },\n          (_, index) => html`<div class=\"surface rear\" style=${`--_layer:${layers - index - 1}`}></div>`\n        )}\n        <div class=\"surface front\"><slot></slot></div>\n      </div>\n    `;\n  }\n}\n"],"mappings":";;;;;;AAwBA,IAAaI,IAAb,cAA2BC,EAAW;;EAMC,A,aAAA,KAAA,SAAA;;;EALrB,KAAA,SAAAE,EAAU,CAACP,CAAM,CAAC;;;EAEP,KAAA,WAAA;GAAE,KAAK;GAAa,SAAS;EAAQ;;CAKhE,SAAS;EACP,IAAMQ,IAAS,OAAO,SAAS,KAAK,MAAM,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,MAAM,CAAC,CAAC,IAAI;EAClG,OAAO,CAAI,sDAC2C,kBAAkBA,IAAS,IAAI,IAC/E,MAAM,KACN,EAAE,QAAQA,IAAS,EAAE,IACpB,GAAG,MAAU,CAAI,oCAAmC,YAAYA,IAASC,IAAQ,IAAI,SACxF,EAAE;CAIR;AACF;AAdGR,EAAA,CAAAS,EAAS,EAAE,MAAM,OAAO,CAAC,CAAA,GAAAN,EAAA,WAAA,UAAA,KAAA,CAAA"}

package/dist/ghost/index.d.ts

@@ -0,0 +1 @@
+export * from './ghost.js';

package/dist/ghost/index.js

@@ -0,0 +1 @@
+export { Ghost } from "./ghost2.js";

package/dist/grid/cell/cell2.js

@@ -10,7 +10,7 @@ var a = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-grid-cell",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	render() {

package/dist/grid/column/column2.js

@@ -13,7 +13,7 @@ var c = class r extends a {
 	static {
 		this.metadata = {
 			tag: "nve-grid-column",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	get #e() {

package/dist/grid/footer/footer2.js

@@ -15,7 +15,7 @@ var s = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-grid-footer",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	static {

package/dist/grid/grid2.js

@@ -23,7 +23,7 @@ var y = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-grid",
-			version: "2.22.5",
+			version: "2.23.1",
 			children: [
 				d.metadata.tag,
 				f.metadata.tag,

package/dist/grid/header/header2.js

@@ -19,7 +19,7 @@ var m = class extends d {
 	static {
 		this.metadata = {
 			tag: "nve-grid-header",
-			version: "2.22.5",
+			version: "2.23.1",
 			children: [s.metadata.tag]
 		};
 	}

package/dist/grid/placeholder/placeholder2.js

@@ -10,7 +10,7 @@ var a = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-grid-placeholder",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	render() {

package/dist/grid/row/row2.js

@@ -15,7 +15,7 @@ var u = class extends s {
 	static {
 		this.metadata = {
 			tag: "nve-grid-row",
-			version: "2.22.5",
+			version: "2.23.1",
 			children: [a.metadata.tag]
 		};
 	}

package/dist/icon/icon2.js

@@ -16,7 +16,7 @@ var f = class n extends o {
 	static {
 		this.metadata = {
 			tag: "nve-icon",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	static {
@@ -103,7 +103,7 @@ a([l({
 })], f.prototype, "name", void 0), a([d()], f.prototype, "svg", void 0);
 function p(e) {
 	if (typeof globalThis.customElements?.get == "function") {
-		let t = n(e.metadata.version), i = n("2.22.5");
+		let t = n(e.metadata.version), i = n("2.23.1");
 		t.minor <= i.minor && t.major <= i.major && (e._icons = {
 			...e._icons,
 			...r

package/dist/icon-button/icon-button2.js

@@ -15,7 +15,7 @@ var l = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-icon-button",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	static {

package/dist/iframe/iframe2.js

@@ -47,7 +47,7 @@ var a = "\n    window.addEventListener('message', event => {\n      if (event.so
 	static {
 		this.metadata = {
 			tag: "nve-iframe",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	static get observedAttributes() {

package/dist/index.d.ts

@@ -1,4 +1,8 @@
+/** @public */
 export declare const VERSION = "0.0.0";
+/** @public */
 export declare const SCOPE = "@nvidia-elements";
+/** @public */
 export { I18nService, getThemeTokens } from '@nvidia-elements/core/internal';
+/** @public */
 export * from './internal/types/index.js';

package/dist/index.js

@@ -2,7 +2,7 @@ import { getThemeTokens as e } from "./internal/utils/dom.js";
 import { statusIcons as t } from "./internal/types/index.js";
 import { internal_exports as n } from "./internal/index.js";
 // src/index.ts
-var r = "2.22.5", i = "@nvidia-elements", a = n.I18nService;
+var r = "2.23.1", i = "@nvidia-elements", a = n.I18nService;
 export { a as I18nService, i as SCOPE, r as VERSION, e as getThemeTokens, t as statusIcons };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["VERSION","SCOPE","I18nService","internal_exports","getThemeTokens","statusIcons"],"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\n/// <reference types=\"./declarations\" />\nexport const VERSION = '0.0.0';\nexport const SCOPE = '@nvidia-elements';\nexport { I18nService, getThemeTokens } from '@nvidia-elements/core/internal';\nexport * from './internal/types/index.js';\n"],"mappings":";;;;AAIA,IAAaA,IAAU,SACVC,IAAQ,oB"}
+{"version":3,"file":"index.js","names":["VERSION","SCOPE","I18nService","internal_exports","getThemeTokens","statusIcons"],"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\n/// <reference types=\"./declarations\" />\n/** @public */\nexport const VERSION = '0.0.0';\n/** @public */\nexport const SCOPE = '@nvidia-elements';\n/** @public */\nexport { I18nService, getThemeTokens } from '@nvidia-elements/core/internal';\n/** @public */\nexport * from './internal/types/index.js';\n"],"mappings":";;;;AAKA,IAAaA,IAAU,SAEVC,IAAQ,oB"}

package/dist/input/input-group2.js

@@ -11,7 +11,7 @@ var a = class extends n {
 	static {
 		this.metadata = {
 			tag: "nve-input-group",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 	async connectedCallback() {

package/dist/input/input2.js

@@ -14,7 +14,7 @@ var a = r, o = class extends n {
 	static {
 		this.metadata = {
 			tag: "nve-input",
-			version: "2.22.5"
+			version: "2.23.1"
 		};
 	}
 };

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

@@ -1,6 +1,5 @@
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
 type SpatialKeyHost = ReactiveControllerHost & HTMLElement;
-export type SpatialKeyHandling = 'handled' | 'ignored';
 export interface KeyNavigationSpatialControllerOptions {
     readonly isEnabled?: () => boolean;
 }

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

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

package/dist/internal/controllers/type-native-popover.utils.d.ts

@@ -1,4 +1,3 @@
-export declare function associateAnchor(host: HTMLElement, anchor: HTMLElement): void;
 export declare function getHostTrigger(element: HTMLElement, trigger: HTMLElement | string): HTMLButtonElement;
 export declare function getHostAnchor(host: HTMLElement & {
     anchor?: HTMLElement | string;

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

@@ -1 +1 @@
-{"version":3,"file":"type-native-popover.utils.js","names":["getHostTrigger","trigger","getFlattenedDOMTree","element","el","getHostAnchor","anchor","host","match","LogService","getIdMatchNotFoundWarning","hasOpenPopover"],"sources":["../../../src/internal/controllers/type-native-popover.utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { LogService } from '../services/log.service.js';\nimport { getIdMatchNotFoundWarning } from '../utils/audit-logs.js';\nimport { generateId, getFlattenedDOMTree, getAnchorNames, appendAnchorName } from '../utils/dom.js';\n\nexport function associateAnchor(host: HTMLElement, anchor: HTMLElement) {\n  const anchorNames = getAnchorNames(anchor);\n  let anchorId = anchorNames.find(name => name.startsWith('--_'));\n  if (!anchorId) {\n    anchorId = `--${anchor.id && !anchor.id.includes(':') ? `_${anchor.id}` : generateId()}`;\n    appendAnchorName(anchor, anchorId);\n  }\n  host.style.positionAnchor = anchorId;\n}\n\nexport function getHostTrigger(element: HTMLElement, trigger: HTMLElement | string) {\n  if (typeof trigger === 'string') {\n    return (\n      (getFlattenedDOMTree(element.parentNode as HTMLElement)\n        .filter(el => el?.id !== '')\n        .find(el => el.id === trigger) as HTMLButtonElement) ?? globalThis.document.body\n    );\n  } else {\n    return trigger as HTMLButtonElement;\n  }\n}\n\nexport function getHostAnchor(host: HTMLElement & { anchor?: HTMLElement | string }) {\n  const anchor = host.anchor;\n\n  if (typeof anchor === 'string' && anchor?.length) {\n    const match = getFlattenedDOMTree(host.parentNode as HTMLElement).find(el => el.id === anchor);\n\n    if (!match) {\n      LogService.warn(getIdMatchNotFoundWarning(anchor));\n    }\n\n    return match ?? globalThis.document.body;\n  } else if (anchor && anchor !== globalThis.document.body) {\n    return anchor as HTMLElement;\n  } else {\n    return globalThis.document.body;\n  }\n}\n\nexport function hasOpenPopover(host: HTMLElement) {\n  return !!getFlattenedDOMTree(host).filter(e => e.popover && e.matches(':popover-open')).length;\n}\n"],"mappings":";;;;AAiBA,SAAgBA,EAAe,GAAsB,GAA+B;CAQhF,OAPE,OAAOC,KAAY,WAElBC,EAAoBC,EAAQ,UAAyB,CAAC,CACpD,QAAO,MAAMC,GAAI,OAAO,EAAE,CAAC,CAC3B,MAAK,MAAMA,EAAG,OAAOH,CAAO,KAA2B,WAAW,SAAS,OAGzEA;AAEX;AAEA,SAAgBI,EAAc,GAAuD;CACnF,IAAMC,IAASC,EAAK;CAEpB,IAAI,OAAOD,KAAW,YAAYA,GAAQ,QAAQ;EAChD,IAAME,IAAQN,EAAoBK,EAAK,UAAyB,CAAC,CAAC,MAAK,MAAMH,EAAG,OAAOE,CAAM;EAM7F,OAJKE,KACHC,EAAW,KAAKC,EAA0BJ,CAAM,CAAC,GAG5CE,KAAS,WAAW,SAAS;CACtC;CAGE,OAHSF,KAAUA,MAAW,WAAW,SAAS,OAC3CA,IAEA,WAAW,SAAS;AAE/B;AAEA,SAAgBK,EAAe,GAAmB;CAChD,OAAO,CAAC,CAACT,EAAoBK,CAAI,CAAC,CAAC,QAAO,MAAK,EAAE,WAAW,EAAE,QAAQ,eAAe,CAAC,CAAC,CAAC;AAC1F"}
+{"version":3,"file":"type-native-popover.utils.js","names":["getHostTrigger","trigger","getFlattenedDOMTree","element","el","getHostAnchor","anchor","host","match","LogService","getIdMatchNotFoundWarning","hasOpenPopover"],"sources":["../../../src/internal/controllers/type-native-popover.utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { LogService } from '../services/log.service.js';\nimport { getIdMatchNotFoundWarning } from '../utils/audit-logs.js';\nimport { getFlattenedDOMTree } from '../utils/dom.js';\n\nexport function getHostTrigger(element: HTMLElement, trigger: HTMLElement | string) {\n  if (typeof trigger === 'string') {\n    return (\n      (getFlattenedDOMTree(element.parentNode as HTMLElement)\n        .filter(el => el?.id !== '')\n        .find(el => el.id === trigger) as HTMLButtonElement) ?? globalThis.document.body\n    );\n  } else {\n    return trigger as HTMLButtonElement;\n  }\n}\n\nexport function getHostAnchor(host: HTMLElement & { anchor?: HTMLElement | string }) {\n  const anchor = host.anchor;\n\n  if (typeof anchor === 'string' && anchor?.length) {\n    const match = getFlattenedDOMTree(host.parentNode as HTMLElement).find(el => el.id === anchor);\n\n    if (!match) {\n      LogService.warn(getIdMatchNotFoundWarning(anchor));\n    }\n\n    return match ?? globalThis.document.body;\n  } else if (anchor && anchor !== globalThis.document.body) {\n    return anchor as HTMLElement;\n  } else {\n    return globalThis.document.body;\n  }\n}\n\nexport function hasOpenPopover(host: HTMLElement) {\n  return !!getFlattenedDOMTree(host).filter(e => e.popover && e.matches(':popover-open')).length;\n}\n"],"mappings":";;;;AAOA,SAAgBA,EAAe,GAAsB,GAA+B;CAQhF,OAPE,OAAOC,KAAY,WAElBC,EAAoBC,EAAQ,UAAyB,CAAC,CACpD,QAAO,MAAMC,GAAI,OAAO,EAAE,CAAC,CAC3B,MAAK,MAAMA,EAAG,OAAOH,CAAO,KAA2B,WAAW,SAAS,OAGzEA;AAEX;AAEA,SAAgBI,EAAc,GAAuD;CACnF,IAAMC,IAASC,EAAK;CAEpB,IAAI,OAAOD,KAAW,YAAYA,GAAQ,QAAQ;EAChD,IAAME,IAAQN,EAAoBK,EAAK,UAAyB,CAAC,CAAC,MAAK,MAAMH,EAAG,OAAOE,CAAM;EAM7F,OAJKE,KACHC,EAAW,KAAKC,EAA0BJ,CAAM,CAAC,GAG5CE,KAAS,WAAW,SAAS;CACtC;CAGE,OAHSF,KAAUA,MAAW,WAAW,SAAS,OAC3CA,IAEA,WAAW,SAAS;AAE/B;AAEA,SAAgBK,EAAe,GAAmB;CAChD,OAAO,CAAC,CAACT,EAAoBK,CAAI,CAAC,CAAC,QAAO,MAAK,EAAE,WAAW,EAAE,QAAQ,eAAe,CAAC,CAAC,CAAC;AAC1F"}

package/dist/internal/index.d.ts

@@ -34,4 +34,3 @@ export * from './utils/strings.js';
 export * from './utils/focus.js';
 export * from './utils/keynav.js';
 export * from './utils/numeric.js';
-export * from './utils/supports.js';