@nvidia-elements/core 2.8.1 → 2.10.0

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [2.10.0](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.9.0...@nvidia-elements/core-v2.10.0) (2026-09-30)
+
+### Features
+
+* **core:** add viewport minimap ([c3cc189](https://github.com/NVIDIA/elements/commit/c3cc1891132f6ae6ab27c94fcdfe79d38b592230))
+* **pi:** pi extension ([88dea55](https://github.com/NVIDIA/elements/commit/88dea552fd28da8a31c95ff713218bda73d64e64))
+
+### Bug Fixes
+
+* **cli:** mcp app rendering and schema tools ([5cf5f51](https://github.com/NVIDIA/elements/commit/5cf5f51e8b77468451024a9a31f247ac0beb5373))
+* **cli:** update marked to 18.0.14 ([b24d6cb](https://github.com/NVIDIA/elements/commit/b24d6cb07ee47cf392214e0a934f1caee31eb510))
+* **lint:** update eslint ([2a3ad12](https://github.com/NVIDIA/elements/commit/2a3ad1217db5aadfdef4a89f796f96348dc0f330))
+
+## [2.9.0](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.8.1...@nvidia-elements/core-v2.9.0) (2026-09-24)
+
+### Features
+
+* **core:** add viewport ([0e9e892](https://github.com/NVIDIA/elements/commit/0e9e892de5d41c2a64d1e9adcfaa7a9df2c4deef))
+
+### Bug Fixes
+
+* **cli:** update bun to 1.4.2 ([0e84e28](https://github.com/NVIDIA/elements/commit/0e84e2880ca5ff09405d0d88d16ef12d9341623e))
+* **core:** enhance gesture recognizer ([0be2399](https://github.com/NVIDIA/elements/commit/0be2399b37982fde94c061ed811c280b29e3a3ae))
+
 ## [2.8.1](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.8.0...@nvidia-elements/core-v2.8.1) (2026-09-23)
 
 ### Features

package/README.md

@@ -10,17 +10,13 @@ NVIDIA Design System and UI Agent Harness for AI/ML Factories, Robotics, and Aut
 ## Getting Started
 
 ```shell
-# local .npmrc file
-registry=https://registry.npmjs.org
-
-# https://registry.npmjs.org
-npm login
-
-npm install @nvidia-elements/themes @nvidia-elements/styles @nvidia-elements/core
+npm install --registry=https://registry.npmjs.org/ @nvidia-elements/themes @nvidia-elements/styles @nvidia-elements/core
 ```
 
 Elements ships as many small packages. This allows you to choose what tools your application needs and omit anything unnecessary, improving application performance.
 
+The core package provides framework-agnostic Web Components that you can use in [React](https://NVIDIA.github.io/elements/docs/integrations/react/), [Vue](https://NVIDIA.github.io/elements/docs/integrations/vue/), and [Angular](https://NVIDIA.github.io/elements/docs/integrations/angular/) applications.
+
 ## Usage
 
 ```css

package/dist/accordion/accordion.d.ts

@@ -22,7 +22,7 @@ export declare class AccordionHeader extends LitElement {
     };
     /** @private */
     _internals: ElementInternals;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     /** @private */
     slot: string;
     connectedCallback(): void;
@@ -43,7 +43,7 @@ export declare class AccordionContent extends LitElement {
         tag: string;
         version: string;
     };
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
 }
 /**
  * @element nve-accordion
@@ -101,7 +101,7 @@ export declare class Accordion extends LitElement implements ContainerElement {
      * Determines whether the accordion should opt-in to stateful expansion behavior (defaults to stateless)
      */
     behaviorExpand: boolean;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
     firstUpdated(props: PropertyValues<this>): Promise<void>;
 }
@@ -137,7 +137,7 @@ export declare class AccordionGroup extends LitElement {
         children: string[];
     };
     private accordions;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(props: PropertyValues<this>): void;

package/dist/accordion/accordion2.js

@@ -28,7 +28,7 @@ var b = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-header",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	render() {
@@ -46,7 +46,7 @@ var x = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-content",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	render() {
@@ -62,7 +62,7 @@ var x = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion",
-			version: "2.8.1",
+			version: "2.10.0",
 			children: [
 				b.metadata.tag,
 				x.metadata.tag,
@@ -120,7 +120,7 @@ var C = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-group",
-			version: "2.8.1",
+			version: "2.10.0",
 			children: [S.metadata.tag]
 		};
 	}

package/dist/alert/alert-group.d.ts

@@ -36,7 +36,7 @@ export declare class AlertGroup extends LitElement {
     /** @private */
     _internals: ElementInternals;
     private alerts;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
     updated(props: PropertyValues<this>): void;
 }

package/dist/alert/alert-group2.js

@@ -19,7 +19,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-alert-group",
-			version: "2.8.1",
+			version: "2.10.0",
 			children: [o.metadata.tag]
 		};
 	}

package/dist/alert/alert.d.ts

@@ -52,6 +52,6 @@ export declare class Alert extends LitElement {
     private actionItems;
     /** @private */
     _internals: ElementInternals;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
 }

package/dist/alert/alert2.js

@@ -28,7 +28,7 @@ var v = class extends m {
 	static {
 		this.metadata = {
 			tag: "nve-alert",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	static {

package/dist/avatar/avatar-group.d.ts

@@ -16,6 +16,6 @@ export declare class AvatarGroup extends LitElement {
     };
     /** @private */
     _internals: ElementInternals;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
 }

package/dist/avatar/avatar-group2.js

@@ -10,7 +10,7 @@ var a = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-avatar-group",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	render() {

package/dist/avatar/avatar.d.ts

@@ -28,5 +28,5 @@ export declare class Avatar extends LitElement {
     size?: Size | 'xs';
     /** Sets the color of the avatar component. */
     color: Color;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
 }

package/dist/avatar/avatar2.js

@@ -11,7 +11,7 @@ var s = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-avatar",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	render() {

package/dist/badge/badge.d.ts

@@ -57,7 +57,7 @@ export declare class Badge extends LitElement {
     i18n: Partial<import("@nvidia-elements/core/internal").I18nStrings & {
         __set: boolean;
     }>;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
     updated(props: PropertyValues<this>): void;
 }

package/dist/badge/badge2.js

@@ -25,7 +25,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-badge",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	static {

package/dist/breadcrumb/breadcrumb.d.ts

@@ -23,6 +23,7 @@ import { Icon } from '@nvidia-elements/core/icon';
  */
 export declare class Breadcrumb extends LitElement {
     #private;
+    /** @private */
     get keynavListConfig(): KeynavListConfig;
     /** @private */
     _internals: ElementInternals;
@@ -35,6 +36,6 @@ export declare class Breadcrumb extends LitElement {
         [Icon.metadata.tag]: typeof Icon;
     };
     private breadcrumbItems;
-    render(): import("lit").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
     connectedCallback(): void;
 }

package/dist/breadcrumb/breadcrumb2.js

@@ -24,7 +24,7 @@ var m = class extends u {
 	static {
 		this.metadata = {
 			tag: "nve-breadcrumb",
-			version: "2.8.1"
+			version: "2.10.0"
 		};
 	}
 	static {

package/dist/breadcrumb/breadcrumb2.js.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumb2.js","names":[],"sources":["../../src/breadcrumb/breadcrumb.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, LitElement, nothing } from 'lit';\nimport { state } from 'lit/decorators/state.js';\nimport type { KeynavListConfig } from '@nvidia-elements/core/internal';\nimport {\n  useStyles,\n  keyNavigationList,\n  attachInternals,\n  generateId,\n  isFocusable,\n  typeSSR,\n  scopedRegistry\n} from '@nvidia-elements/core/internal';\nimport styles from './breadcrumb.css?inline';\nimport { Icon } from '@nvidia-elements/core/icon';\nimport type { Button } from '@nvidia-elements/core/button';\n\n/**\n * @element nve-breadcrumb\n * @description Breadcrumb is a component that can help users establish their location while navigating a website with complex URLs and navigation paths.\n * @documentation https://nvidia.github.io/elements/docs/elements/breadcrumb/\n * @since 0.11.0\n * @entrypoint \\@nvidia-elements/core/breadcrumb\n * @cssprop --gap\n * @cssprop --height\n * @cssprop --font-size\n * @cssprop --font-weight\n * @cssprop --color\n * @cssprop --border-radius\n * @cssprop --padding\n * @cssprop --width\n * @cssprop --icon-width\n * @cssprop --icon-height\n * @cssprop --text-decoration\n * @slot - default slot for `nve-button` and anchor elements\n * @aria https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/navigation_role\n */\n@typeSSR()\n@scopedRegistry()\n@keyNavigationList<Breadcrumb>()\nexport class Breadcrumb extends LitElement {\n  get keynavListConfig(): KeynavListConfig {\n    return {\n      items: Array.from(this.shadowRoot!.querySelectorAll('slot'))\n        .flatMap(slot => slot.assignedElements())\n        .filter(e => isFocusable(e)) as HTMLElement[]\n    };\n  }\n\n  /** @private */\n  declare _internals: ElementInternals;\n\n  static styles = useStyles([styles]);\n\n  static readonly metadata = {\n    tag: 'nve-breadcrumb',\n    version: '0.0.0'\n  };\n\n  static elementDefinitions = {\n    [Icon.metadata.tag]: Icon\n  };\n\n  @state() private breadcrumbItems: Element[] = [];\n\n  render() {\n    /* eslint-disable @nvidia-elements/lint/no-unstyled-typography */\n    return html`\n    <ol internal-host>\n      ${this.breadcrumbItems.map(\n        (el, idx) => html`\n        <li>\n          <slot name=${el.slot} @slotchange=${this.#removeItem}></slot>\n          ${idx < this.breadcrumbItems.length - 1 ? html`<nve-icon part=\"icon\" separator aria-hidden=\"true\" name=\"chevron\" direction=\"right\" size=\"sm\"></nve-icon>` : nothing}\n        </li>\n      `\n      )}\n    </ol>\n    <slot ?hidden-slot=${!this.breadcrumbItems.length} @slotchange=${this.#createItems}></slot>`;\n  }\n\n  connectedCallback() {\n    super.connectedCallback();\n    attachInternals(this);\n    this._internals.role = 'navigation';\n  }\n\n  #removeItem(e: Event) {\n    if (!(e.target as HTMLSlotElement).assignedElements().length) {\n      this.#resetItems();\n    }\n  }\n\n  #createItems(e: Event) {\n    if (e.target && (e.target as HTMLSlotElement).assignedElements().length) {\n      this.#resetItems();\n      const items = this.shadowRoot!.querySelector<HTMLSlotElement>('slot:not([name])')!.assignedElements();\n      items.filter(i => i.matches('nve-button, nve-icon-button, span, a')).forEach(i => (i.slot = generateId()));\n      items\n        .filter(i => i.matches('nve-button, nve-icon-button'))\n        .forEach((i: Element) => ((i as Button).container = 'inline'));\n      this.breadcrumbItems = items.length ? items : this.breadcrumbItems;\n    }\n  }\n\n  #resetItems() {\n    Array.from(this.shadowRoot!.querySelectorAll('slot'))\n      .flatMap(i => i.assignedElements())\n      .forEach(i => (i.slot = ''));\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA0CO,IAAM,IAAN,cAAyB,EAAW;;EAuBK,aAAA,KAAA,kBAAA,CAAC;;CAtB/C,IAAI,mBAAqC;EACvC,OAAO,EACL,OAAO,MAAM,KAAK,KAAK,WAAY,iBAAiB,MAAM,CAAC,CAAC,CACzD,SAAQ,MAAQ,EAAK,iBAAiB,CAAC,CAAC,CACxC,QAAO,MAAK,EAAY,CAAC,CAAC,EAC/B;CACF;;EAKgB,KAAA,SAAA,EAAU,CAAC,CAAM,CAAC;;;EAEP,KAAA,WAAA;GACzB,KAAK;GACL,SAAS;EACX;;;EAE4B,KAAA,qBAAA,GACzB,EAAK,SAAS,MAAM,EACvB;;CAIA,SAAS;EAEP,OAAO,CAAI,qBAEP,KAAK,gBAAgB,KACpB,GAAI,MAAQ,CAAI,mBAEF,EAAG,KAAK,iBAAe,KAAK,GAAY,WACnD,IAAM,KAAK,gBAAgB,SAAS,IAAI,CAAI,8GAA8G,EAAQ,MAGxK,EAAE,2BAEiB,CAAC,KAAK,gBAAgB,OAAO,iBAAe,KAAK,GAAa;CACrF;CAEA,oBAAoB;EAGlB,AAFA,MAAM,kBAAkB,GACxB,EAAgB,IAAI,GACpB,KAAK,WAAW,OAAO;CACzB;CAEA,GAAY,GAAU;EACpB,AAAM,EAAE,OAA2B,iBAAiB,CAAC,CAAC,UACpD,KAAK,GAAY;CAErB;CAEA,GAAa,GAAU;EACrB,IAAI,EAAE,UAAW,EAAE,OAA2B,iBAAiB,CAAC,CAAC,QAAQ;GACvE,KAAK,GAAY;GACjB,IAAM,IAAQ,KAAK,WAAY,cAA+B,kBAAkB,CAAC,CAAE,iBAAiB;GAKpG,AAJA,EAAM,QAAO,MAAK,EAAE,QAAQ,sCAAsC,CAAC,CAAC,CAAC,SAAQ,MAAM,EAAE,OAAO,EAAW,CAAE,GACzG,EACG,QAAO,MAAK,EAAE,QAAQ,6BAA6B,CAAC,CAAC,CACrD,SAAS,MAAgB,EAAc,YAAY,QAAS,GAC/D,KAAK,kBAAkB,EAAM,SAAS,IAAQ,KAAK;EACrD;CACF;CAEA,KAAc;EACZ,MAAM,KAAK,KAAK,WAAY,iBAAiB,MAAM,CAAC,CAAC,CAClD,SAAQ,MAAK,EAAE,iBAAiB,CAAC,CAAC,CAClC,SAAQ,MAAM,EAAE,OAAO,EAAG;CAC/B;AACF;AA/CG,EAAA,CAAA,EAAM,CAAA,GAAA,EAAA,WAAA,mBAAA,KAAA,CAAA;CA1BR,EAAQ;CACR,EAAe;CACf,EAA8B"}
+{"version":3,"file":"breadcrumb2.js","names":[],"sources":["../../src/breadcrumb/breadcrumb.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, LitElement, nothing } from 'lit';\nimport { state } from 'lit/decorators/state.js';\nimport type { KeynavListConfig } from '@nvidia-elements/core/internal';\nimport {\n  useStyles,\n  keyNavigationList,\n  attachInternals,\n  generateId,\n  isFocusable,\n  typeSSR,\n  scopedRegistry\n} from '@nvidia-elements/core/internal';\nimport styles from './breadcrumb.css?inline';\nimport { Icon } from '@nvidia-elements/core/icon';\nimport type { Button } from '@nvidia-elements/core/button';\n\n/**\n * @element nve-breadcrumb\n * @description Breadcrumb is a component that can help users establish their location while navigating a website with complex URLs and navigation paths.\n * @documentation https://nvidia.github.io/elements/docs/elements/breadcrumb/\n * @since 0.11.0\n * @entrypoint \\@nvidia-elements/core/breadcrumb\n * @cssprop --gap\n * @cssprop --height\n * @cssprop --font-size\n * @cssprop --font-weight\n * @cssprop --color\n * @cssprop --border-radius\n * @cssprop --padding\n * @cssprop --width\n * @cssprop --icon-width\n * @cssprop --icon-height\n * @cssprop --text-decoration\n * @slot - default slot for `nve-button` and anchor elements\n * @aria https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/navigation_role\n */\n@typeSSR()\n@scopedRegistry()\n@keyNavigationList<Breadcrumb>()\nexport class Breadcrumb extends LitElement {\n  /** @private */\n  get keynavListConfig(): KeynavListConfig {\n    return {\n      items: Array.from(this.shadowRoot!.querySelectorAll('slot'))\n        .flatMap(slot => slot.assignedElements())\n        .filter(e => isFocusable(e)) as HTMLElement[]\n    };\n  }\n\n  /** @private */\n  declare _internals: ElementInternals;\n\n  static styles = useStyles([styles]);\n\n  static readonly metadata = {\n    tag: 'nve-breadcrumb',\n    version: '0.0.0'\n  };\n\n  static elementDefinitions = {\n    [Icon.metadata.tag]: Icon\n  };\n\n  @state() private breadcrumbItems: Element[] = [];\n\n  render() {\n    /* eslint-disable @nvidia-elements/lint/no-unstyled-typography */\n    return html`\n    <ol internal-host>\n      ${this.breadcrumbItems.map(\n        (el, idx) => html`\n        <li>\n          <slot name=${el.slot} @slotchange=${this.#removeItem}></slot>\n          ${idx < this.breadcrumbItems.length - 1 ? html`<nve-icon part=\"icon\" separator aria-hidden=\"true\" name=\"chevron\" direction=\"right\" size=\"sm\"></nve-icon>` : nothing}\n        </li>\n      `\n      )}\n    </ol>\n    <slot ?hidden-slot=${!this.breadcrumbItems.length} @slotchange=${this.#createItems}></slot>`;\n  }\n\n  connectedCallback() {\n    super.connectedCallback();\n    attachInternals(this);\n    this._internals.role = 'navigation';\n  }\n\n  #removeItem(e: Event) {\n    if (!(e.target as HTMLSlotElement).assignedElements().length) {\n      this.#resetItems();\n    }\n  }\n\n  #createItems(e: Event) {\n    if (e.target && (e.target as HTMLSlotElement).assignedElements().length) {\n      this.#resetItems();\n      const items = this.shadowRoot!.querySelector<HTMLSlotElement>('slot:not([name])')!.assignedElements();\n      items.filter(i => i.matches('nve-button, nve-icon-button, span, a')).forEach(i => (i.slot = generateId()));\n      items\n        .filter(i => i.matches('nve-button, nve-icon-button'))\n        .forEach((i: Element) => ((i as Button).container = 'inline'));\n      this.breadcrumbItems = items.length ? items : this.breadcrumbItems;\n    }\n  }\n\n  #resetItems() {\n    Array.from(this.shadowRoot!.querySelectorAll('slot'))\n      .flatMap(i => i.assignedElements())\n      .forEach(i => (i.slot = ''));\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA0CO,IAAM,IAAN,cAAyB,EAAW;;EAwBK,aAAA,KAAA,kBAAA,CAAC;;CAtB/C,IAAI,mBAAqC;EACvC,OAAO,EACL,OAAO,MAAM,KAAK,KAAK,WAAY,iBAAiB,MAAM,CAAC,CAAC,CACzD,SAAQ,MAAQ,EAAK,iBAAiB,CAAC,CAAC,CACxC,QAAO,MAAK,EAAY,CAAC,CAAC,EAC/B;CACF;;EAKgB,KAAA,SAAA,EAAU,CAAC,CAAM,CAAC;;;EAEP,KAAA,WAAA;GACzB,KAAK;GACL,SAAS;EACX;;;EAE4B,KAAA,qBAAA,GACzB,EAAK,SAAS,MAAM,EACvB;;CAIA,SAAS;EAEP,OAAO,CAAI,qBAEP,KAAK,gBAAgB,KACpB,GAAI,MAAQ,CAAI,mBAEF,EAAG,KAAK,iBAAe,KAAK,GAAY,WACnD,IAAM,KAAK,gBAAgB,SAAS,IAAI,CAAI,8GAA8G,EAAQ,MAGxK,EAAE,2BAEiB,CAAC,KAAK,gBAAgB,OAAO,iBAAe,KAAK,GAAa;CACrF;CAEA,oBAAoB;EAGlB,AAFA,MAAM,kBAAkB,GACxB,EAAgB,IAAI,GACpB,KAAK,WAAW,OAAO;CACzB;CAEA,GAAY,GAAU;EACpB,AAAM,EAAE,OAA2B,iBAAiB,CAAC,CAAC,UACpD,KAAK,GAAY;CAErB;CAEA,GAAa,GAAU;EACrB,IAAI,EAAE,UAAW,EAAE,OAA2B,iBAAiB,CAAC,CAAC,QAAQ;GACvE,KAAK,GAAY;GACjB,IAAM,IAAQ,KAAK,WAAY,cAA+B,kBAAkB,CAAC,CAAE,iBAAiB;GAKpG,AAJA,EAAM,QAAO,MAAK,EAAE,QAAQ,sCAAsC,CAAC,CAAC,CAAC,SAAQ,MAAM,EAAE,OAAO,EAAW,CAAE,GACzG,EACG,QAAO,MAAK,EAAE,QAAQ,6BAA6B,CAAC,CAAC,CACrD,SAAS,MAAgB,EAAc,YAAY,QAAS,GAC/D,KAAK,kBAAkB,EAAM,SAAS,IAAQ,KAAK;EACrD;CACF;CAEA,KAAc;EACZ,MAAM,KAAK,KAAK,WAAY,iBAAiB,MAAM,CAAC,CAAC,CAClD,SAAQ,MAAK,EAAE,iBAAiB,CAAC,CAAC,CAClC,SAAQ,MAAM,EAAE,OAAO,EAAG;CAC/B;AACF;AA/CG,EAAA,CAAA,EAAM,CAAA,GAAA,EAAA,WAAA,mBAAA,KAAA,CAAA;CA3BR,EAAQ;CACR,EAAe;CACf,EAA8B"}

package/dist/bundle.d.ts

@@ -67,6 +67,7 @@ import '@nvidia-elements/core/toggletip/define.js';
 import '@nvidia-elements/core/toolbar/define.js';
 import '@nvidia-elements/core/tooltip/define.js';
 import '@nvidia-elements/core/tree/define.js';
+import '@nvidia-elements/core/viewport/define.js';
 import '@nvidia-elements/core/week/define.js';
 export * from '@nvidia-elements/core/accordion';
 export * from '@nvidia-elements/core/alert';
@@ -137,4 +138,5 @@ export * from '@nvidia-elements/core/toggletip';
 export * from '@nvidia-elements/core/toolbar';
 export * from '@nvidia-elements/core/tooltip';
 export * from '@nvidia-elements/core/tree';
+export * from '@nvidia-elements/core/viewport';
 export * from '@nvidia-elements/core/week';

package/dist/bundles/index.d.ts

@@ -78,6 +78,19 @@ export interface RenderOptions {
 	 */
 	isConnected?: boolean;
 }
+/** Coordinates and deltas use CSS pixels; movement is sample-relative and total displacement is start-relative. */
+export interface PointerMovementGesture {
+	readonly event: PointerEvent;
+	readonly clientX: number;
+	readonly clientY: number;
+	readonly movementX: number;
+	readonly movementY: number;
+	readonly startClientX: number;
+	readonly startClientY: number;
+	readonly totalDisplacementX: number;
+	readonly totalDisplacementY: number;
+}
+export type PointerEndReason = "up" | "cancel" | "lost-capture" | "buttons-released";
 export interface I18nStrings {
 	close: string;
 	copy: string;
@@ -1466,6 +1479,7 @@ export declare class Badge extends LitElement {
  */
 export declare class Breadcrumb extends LitElement {
 	#private;
+	/** @private */
 	get keynavListConfig(): KeynavListConfig;
 	/** @private */
 	_internals: ElementInternals;
@@ -1730,7 +1744,9 @@ export declare class ControlGroup extends LitElement {
 	layout: "vertical" | "vertical-inline" | "horizontal" | "horizontal-inline";
 	/** Set the visual prominence of the control group */
 	prominence: "muted";
+	/** Returns the label associated with the control group. */
 	get label(): HTMLLabelElement | null;
+	/** Returns the input elements associated with the control group. */
 	get inputs(): HTMLInputElement[];
 	static styles: CSSResult[];
 	static readonly metadata: {
@@ -3470,11 +3486,13 @@ export declare class Grid extends LitElement implements ContainerElement {
 		children: string[];
 	};
 	static elementDefinitions: {};
+	/** @private */
 	get keynavGridConfig(): {
 		columns: GridColumn[];
 		rows: (GridRow | GridHeader)[];
 		cells: (GridColumn | GridCell)[];
 	};
+	/** @private */
 	get stateScrollConfig(): StateScrollConfig;
 	/** @private */
 	_internals: ElementInternals;
@@ -5462,7 +5480,7 @@ export declare class TreeNode extends LitElement {
 	/** @private */
 	slot: string;
 	/**
-	 * Returns list of child nodes
+	 * Returns the slotted child tree nodes.
 	 */
 	readonly nodes: TreeNode[];
 	/** @private */
@@ -5531,6 +5549,7 @@ export declare class Tree extends LitElement {
 		children: string[];
 	};
 	_internals: ElementInternals;
+	/** Returns the tree nodes in document order. */
 	get nodes(): TreeNode[];
 	/** @private */
 	get keynavListConfig(): KeynavListConfig;
@@ -5541,6 +5560,198 @@ export declare class Tree extends LitElement {
 	disconnectedCallback(): void;
 	updated(props: PropertyValues<this>): Promise<void>;
 }
+export interface ViewportTransform {
+	readonly x: number;
+	readonly y: number;
+	readonly scale: number;
+}
+export interface ViewportPoint {
+	readonly x: number;
+	readonly y: number;
+}
+export interface ViewportRect extends ViewportPoint {
+	readonly width: number;
+	readonly height: number;
+}
+export type ViewportPanBehavior = boolean | "space";
+export interface ViewportPointerPanDetail extends PointerMovementGesture {
+	readonly source: "pointer";
+	readonly start: ViewportTransform;
+	readonly next: ViewportTransform;
+}
+export interface ViewportWheelPanDetail {
+	readonly source: "wheel";
+	readonly event: WheelEvent;
+	readonly clientX: number;
+	readonly clientY: number;
+	readonly deltaX: number;
+	readonly deltaY: number;
+	readonly start: ViewportTransform;
+	readonly next: ViewportTransform;
+}
+export interface ViewportDiscretePanDetail {
+	readonly source: "keyboard" | "command";
+	readonly event: KeyboardEvent | CommandEvent;
+	readonly start: ViewportTransform;
+	readonly next: ViewportTransform;
+}
+export type ViewportPanDetail = ViewportPointerPanDetail | ViewportWheelPanDetail | ViewportDiscretePanDetail;
+export type ViewportPanEndReason = PointerEndReason | "pinch";
+export interface ViewportPanEndDetail {
+	readonly source: "pointer";
+	readonly event: PointerEvent;
+	readonly interrupted: boolean;
+	readonly reason: ViewportPanEndReason;
+	readonly start: ViewportTransform;
+	readonly transform: ViewportTransform;
+}
+export interface ViewportZoomDetail {
+	readonly source: "wheel" | "pinch" | "keyboard" | "command";
+	readonly event: WheelEvent | PointerEvent | KeyboardEvent | CommandEvent;
+	readonly clientX: number;
+	readonly clientY: number;
+	readonly anchor: ViewportPoint;
+	readonly factor: number;
+	readonly start: ViewportTransform;
+	readonly next: ViewportTransform;
+}
+export interface ViewportAnimationOptions {
+	readonly duration?: number;
+}
+export interface ViewportRevealOptions {
+	/** Uniform CSS-pixel inset reserved around the revealed bounds. */
+	readonly inset?: number;
+	readonly scale?: number;
+	readonly animated?: boolean;
+	readonly duration?: number;
+}
+/**
+ * @element nve-viewport
+ * @description A viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.
+ * @documentation https://nvidia.github.io/elements/docs/elements/viewport/
+ * @since 0.0.0
+ * @entrypoint \@nvidia-elements/core/viewport
+ * @slot - Content positioned in the viewport's infinite content space.
+ * @slot background - Custom content rendered behind viewport content and excluded from content fitting
+ * @event panstart - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
+ * @event pan - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
+ * @event panend - Dispatched when a pointer pan ends, including its terminal reason.
+ * @event zoom - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
+ * @event viewportchange - Dispatched once after a render that commits one or more viewport transform changes.
+ * @cssprop --background - Background color of the fixed viewport area.
+ * @cssprop --min-height
+ * @cssprop --pan-cursor - Cursor shown over a background eligible for primary-pointer panning.
+ * @cssprop --panning-cursor - Cursor shown while a pointer pan is active.
+ * @command --pan-left - With behavior-pan enabled, pans left by one discrete step.
+ * @command --pan-right - With behavior-pan enabled, pans right by one discrete step.
+ * @command --pan-up - With behavior-pan enabled, pans up by one discrete step.
+ * @command --pan-down - With behavior-pan enabled, pans down by one discrete step.
+ * @command --zoom-in - With behavior-zoom enabled, animates to the next permitted scale step.
+ * @command --zoom-out - With behavior-zoom enabled, animates to the previous permitted scale step.
+ * @command --zoom-reset - With behavior-zoom enabled, animates to 100% scale.
+ * @command --zoom-to-fit - With behavior-zoom enabled, animates to fit direct default-slot element boxes.
+ * @stable false
+ */
+export declare class Viewport extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** @private */
+	_internals: ElementInternals;
+	private internalHost;
+	constructor();
+	/** Horizontal content-space coordinate at the viewport origin. */
+	get x(): number;
+	set x(value: number);
+	/** Vertical content-space coordinate at the viewport origin. */
+	get y(): number;
+	set y(value: number);
+	/** Content-to-viewport CSS-pixel scale. */
+	get scale(): number;
+	set scale(value: number);
+	/** Inclusive lower scale limit. */
+	get minScale(): number;
+	set minScale(value: number);
+	/** Inclusive upper scale limit. */
+	get maxScale(): number;
+	set maxScale(value: number);
+	/** Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. */
+	get behaviorPan(): ViewportPanBehavior;
+	set behaviorPan(value: ViewportPanBehavior | null | undefined);
+	/** Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. */
+	behaviorZoom: boolean;
+	/** Fits measurable direct default-slot content once after initial layout. */
+	autoFit: boolean;
+	/** Default uniform CSS-pixel inset reserved around bounds when fitting content. */
+	get fitInset(): number;
+	set fitInset(value: number);
+	/** CSS-pixel pointer movement required before a pointer pan begins. */
+	get dragThreshold(): number;
+	set dragThreshold(value: number);
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	protected updated(changed: PropertyValues<this>): void;
+	render(): TemplateResult<1>;
+	/** Converts a content-space point to viewport CSS pixels. */
+	toViewportCoords(contentX: number, contentY: number): ViewportPoint;
+	/** Converts a viewport CSS-pixel point to content space. */
+	toContentCoords(viewportX: number, viewportY: number): ViewportPoint;
+	/** Returns the current content-space origin and CSS-pixel scale. */
+	getTransform(): ViewportTransform;
+	/** Returns the visible content-space rectangle. */
+	getVisibleRect(): ViewportRect;
+	/** Animates the viewport to the requested partial transform. */
+	animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void;
+	/** Centers or fits a content-space region within the viewport. */
+	reveal(region: {
+		x: number;
+		y: number;
+		width?: number;
+		height?: number;
+	}, options?: ViewportRevealOptions): void;
+	/** Fits the union of direct default-slot element boxes within the viewport. */
+	fitContents(options?: ViewportRevealOptions): void;
+}
+/**
+ * @element nve-viewport-gridlines
+ * @description Renders origin-stable, zoom-adaptive gridlines behind viewport content.
+ * @documentation https://nvidia.github.io/elements/docs/elements/viewport/
+ * @since 0.0.0
+ * @entrypoint \@nvidia-elements/core/viewport
+ * @cssprop --color - Sets the gridline stroke color.
+ * @cssprop --line-width - Sets the approximate stroke width in CSS pixels.
+ */
+export declare class ViewportGridlines extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** @private */
+	slot: string;
+	/** @private */
+	protected accessibilityHidden: string;
+	/** Smallest gridline interval in content-space units. */
+	get step(): number;
+	set step(value: number);
+	/** Content-space x coordinate of the grid origin. */
+	get originX(): number;
+	set originX(value: number);
+	/** Content-space y coordinate of the grid origin. */
+	get originY(): number;
+	set originY(value: number);
+	/** Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. */
+	get targetSpacing(): number;
+	set targetSpacing(value: number);
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	protected willUpdate(changed: PropertyValues<this>): void;
+	render(): typeof nothing | TemplateResult<1>;
+}
 /**
  * @element nve-week
  * @description A week picker is a control that enables users to choose a week value.