@nvidia-elements/core 2.8.0 → 2.9.0

package/dist/textarea/textarea2.js

@@ -1,19 +1,26 @@
 import { useStyles as e } from "../internal/styles/index.js";
 import { Control as t } from "../forms/control/control2.js";
 import n from "./textarea.js";
+import { html as r } from "lit";
 //#region src/textarea/textarea.ts
-var r = class extends t {
+var i = class extends t {
 	static {
 		this.styles = e([...t.styles, n]);
 	}
+	get prefixContent() {
+		return r`<slot name="prefix"></slot>`;
+	}
+	get suffixContent() {
+		return r`<slot name="suffix"></slot>`;
+	}
 	static {
 		this.metadata = {
 			tag: "nve-textarea",
-			version: "2.8.0"
+			version: "2.9.0"
 		};
 	}
 };
 //#endregion
-export { r as Textarea };
+export { i as Textarea };
 
 //# sourceMappingURL=textarea2.js.map

package/dist/textarea/textarea2.js.map

@@ -1 +1 @@
-{"version":3,"file":"textarea2.js","names":[],"sources":["../../src/textarea/textarea.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { CSSResult } from 'lit';\nimport { useStyles } from '@nvidia-elements/core/internal';\nimport { Control } from '@nvidia-elements/core/forms';\nimport styles from './textarea.css?inline';\n\n/**\n * @element nve-textarea\n * @description A textarea is a control that enables users to enter and edit text.\n * @documentation https://nvidia.github.io/elements/docs/elements/textarea/\n * @since 0.3.0\n * @entrypoint \\@nvidia-elements/core/textarea\n * @cssprop --padding\n * @cssprop --font-size\n * @cssprop --height\n * @cssprop --width\n * @cssprop --min-height\n * @cssprop --background\n * @cssprop --border-radius\n * @cssprop --cursor\n * @cssprop --border\n * @cssprop --color\n * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea\n */\nexport class Textarea extends Control {\n  static styles: CSSResult[] = useStyles([...Control.styles, styles]);\n\n  static readonly metadata = {\n    tag: 'nve-textarea',\n    version: '0.0.0'\n  };\n}\n"],"mappings":";;;;AA0BA,IAAa,IAAb,cAA8B,EAAQ;;EACP,KAAA,SAAA,EAAU,CAAC,GAAG,EAAQ,QAAQ,CAAM,CAAC;;;EAEvC,KAAA,WAAA;GACzB,KAAK;GACL,SAAS;EACX;;AACF"}
+{"version":3,"file":"textarea2.js","names":[],"sources":["../../src/textarea/textarea.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, type CSSResult } from 'lit';\nimport { useStyles } from '@nvidia-elements/core/internal';\nimport { Control } from '@nvidia-elements/core/forms';\nimport styles from './textarea.css?inline';\n\n/**\n * @element nve-textarea\n * @description A textarea is a control that enables users to enter and edit text.\n * @documentation https://nvidia.github.io/elements/docs/elements/textarea/\n * @since 0.3.0\n * @entrypoint \\@nvidia-elements/core/textarea\n * @slot prefix - Content to display before the textarea.\n * @slot suffix - Content to display after the textarea.\n * @cssprop --padding\n * @cssprop --font-size\n * @cssprop --height\n * @cssprop --width\n * @cssprop --min-height\n * @cssprop --background\n * @cssprop --border-radius\n * @cssprop --cursor\n * @cssprop --border\n * @cssprop --color\n * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea\n */\nexport class Textarea extends Control {\n  static styles: CSSResult[] = useStyles([...Control.styles, styles]);\n\n  /** @private */\n  protected get prefixContent() {\n    return html`<slot name=\"prefix\"></slot>`;\n  }\n\n  /** @private */\n  protected get suffixContent() {\n    return html`<slot name=\"suffix\"></slot>`;\n  }\n\n  static readonly metadata = {\n    tag: 'nve-textarea',\n    version: '0.0.0'\n  };\n}\n"],"mappings":";;;;;AA4BA,IAAa,IAAb,cAA8B,EAAQ;;EACP,KAAA,SAAA,EAAU,CAAC,GAAG,EAAQ,QAAQ,CAAM,CAAC;;CAGlE,IAAc,gBAAgB;EAC5B,OAAO,CAAI;CACb;CAGA,IAAc,gBAAgB;EAC5B,OAAO,CAAI;CACb;;EAE2B,KAAA,WAAA;GACzB,KAAK;GACL,SAAS;EACX;;AACF"}

package/dist/time/time2.js

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

package/dist/toast/toast.examples.json

@@ -106,7 +106,7 @@
     {
       "id": "toast-body-anchor",
       "name": "BodyAnchor",
-      "template": "<nve-toast style=\"--background: red\" anchor=\"body\" position=\"center\" alignment=\"center\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: blue\" anchor=\"body\" position=\"top\" alignment=\"start\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: yellow\" anchor=\"body\" position=\"top\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: green\" anchor=\"body\" position=\"top\" alignment=\"end\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: purple\" anchor=\"body\" position=\"bottom\" alignment=\"start\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: orange\" anchor=\"body\" position=\"bottom\">•︎︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: pink\" anchor=\"body\" position=\"bottom\" alignment=\"end\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: brown; margin-right: -250px\" anchor=\"body\" position=\"left\" alignment=\"start\"\n  >•︎•︎•︎•︎•︎•︎</nve-toast\n>\n<nve-toast style=\"--background: gray\" anchor=\"body\" position=\"left\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: black; margin-right: -250px\" anchor=\"body\" position=\"left\" alignment=\"end\"\n  >•︎•︎•︎•︎•︎•︎</nve-toast\n>\n<nve-toast style=\"--background: red; margin-left: -250px\" anchor=\"body\" position=\"right\" alignment=\"start\"\n  >•︎•︎•︎•︎•︎•︎</nve-toast\n>\n<nve-toast style=\"--background: blue\" anchor=\"body\" position=\"right\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: yellow; margin-left: -250px\" anchor=\"body\" position=\"right\" alignment=\"end\"\n  >•︎•︎•︎•︎•︎•︎</nve-toast\n>\n",
+      "template": "<nve-toast style=\"--background: red\" anchor=\"body\" position=\"center\" alignment=\"center\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: blue\" anchor=\"body\" position=\"top\" alignment=\"start\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: yellow\" anchor=\"body\" position=\"top\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: green\" anchor=\"body\" position=\"top\" alignment=\"end\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: purple\" anchor=\"body\" position=\"bottom\" alignment=\"start\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: orange\" anchor=\"body\" position=\"bottom\">•︎︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: pink\" anchor=\"body\" position=\"bottom\" alignment=\"end\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: brown; margin-right: -250px\" anchor=\"body\" position=\"left\" alignment=\"start\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: gray\" anchor=\"body\" position=\"left\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: black; margin-right: -250px\" anchor=\"body\" position=\"left\" alignment=\"end\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: red; margin-left: -250px\" anchor=\"body\" position=\"right\" alignment=\"start\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: blue\" anchor=\"body\" position=\"right\">•︎•︎•︎•︎•︎•︎</nve-toast>\n<nve-toast style=\"--background: yellow; margin-left: -250px\" anchor=\"body\" position=\"right\" alignment=\"end\">•︎•︎•︎•︎•︎•︎</nve-toast>\n",
       "summary": "Body anchor positioning for toast.",
       "description": "",
       "composition": false,

package/dist/toast/toast2.js

@@ -23,7 +23,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-toast",
-			version: "2.8.0"
+			version: "2.9.0"
 		};
 	}
 	static {

package/dist/toggletip/toggletip-footer2.js

@@ -11,7 +11,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-toggletip-footer",
-			version: "2.8.0",
+			version: "2.9.0",
 			parents: ["nve-toggletip"]
 		};
 	}

package/dist/toggletip/toggletip-header2.js

@@ -11,7 +11,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-toggletip-header",
-			version: "2.8.0",
+			version: "2.9.0",
 			parents: ["nve-toggletip"]
 		};
 	}

package/dist/toggletip/toggletip2.js

@@ -24,7 +24,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-toggletip",
-			version: "2.8.0"
+			version: "2.9.0"
 		};
 	}
 	static {

package/dist/toolbar/toolbar2.js

@@ -21,7 +21,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-toolbar",
-			version: "2.8.0"
+			version: "2.9.0"
 		};
 	}
 	static {

package/dist/tooltip/tooltip.examples.json

@@ -92,7 +92,7 @@
     {
       "id": "tooltip-wrap",
       "name": "Wrap",
-      "template": "<nve-tooltip anchor=\"btn\" style=\"--width: 200px\">\n  Tooltips provide contextual help for interface elements. Keep content brief and descriptive to help users understand\n  available actions.\n</nve-tooltip>\n<nve-button id=\"btn\">button</nve-button>\n",
+      "template": "<nve-tooltip anchor=\"btn\" style=\"--width: 200px\"> Tooltips provide contextual help for interface elements. Keep content brief and descriptive to help users understand available actions. </nve-tooltip>\n<nve-button id=\"btn\">button</nve-button>\n",
       "summary": "Tooltip with constrained width for controlled text wrapping. Use when tooltip content is longer than a single line, but prefer keeping tooltips brief for better scannability and user experience.",
       "description": "",
       "composition": false,
@@ -184,7 +184,7 @@
     {
       "id": "tooltip-legacy-open-delay",
       "name": "LegacyOpenDelay",
-      "template": "<nve-tooltip behavior-trigger anchor=\"delay-tooltip-1\" trigger=\"delay-tooltip-1\" open-delay=\"500\" hidden\n  >delayed tooltip</nve-tooltip\n>\n<nve-button id=\"delay-tooltip-1\">button</nve-button>\n<nve-tooltip behavior-trigger anchor=\"delay-tooltip-2\" trigger=\"delay-tooltip-2\" open-delay=\"500\" hidden\n  >delayed tooltip</nve-tooltip\n>\n<nve-button id=\"delay-tooltip-2\">button</nve-button>\n<nve-tooltip behavior-trigger anchor=\"delay-tooltip-3\" trigger=\"delay-tooltip-3\" open-delay=\"500\" hidden\n  >delayed tooltip</nve-tooltip\n>\n<nve-button id=\"delay-tooltip-3\">button</nve-button>\n",
+      "template": "<nve-tooltip behavior-trigger anchor=\"delay-tooltip-1\" trigger=\"delay-tooltip-1\" open-delay=\"500\" hidden>delayed tooltip</nve-tooltip>\n<nve-button id=\"delay-tooltip-1\">button</nve-button>\n<nve-tooltip behavior-trigger anchor=\"delay-tooltip-2\" trigger=\"delay-tooltip-2\" open-delay=\"500\" hidden>delayed tooltip</nve-tooltip>\n<nve-button id=\"delay-tooltip-2\">button</nve-button>\n<nve-tooltip behavior-trigger anchor=\"delay-tooltip-3\" trigger=\"delay-tooltip-3\" open-delay=\"500\" hidden>delayed tooltip</nve-tooltip>\n<nve-button id=\"delay-tooltip-3\">button</nve-button>\n",
       "summary": "Legacy implementation combining behavior-trigger with open-delay for many tooltips. Older pattern for delayed tooltip appearance; prefer modern popovertarget with open-delay attribute.",
       "description": "",
       "deprecated": true,

package/dist/tooltip/tooltip2.js

@@ -19,7 +19,7 @@ var d = class extends s {
 	static {
 		this.metadata = {
 			tag: "nve-tooltip",
-			version: "2.8.0"
+			version: "2.9.0"
 		};
 	}
 	render() {

package/dist/tree/tree-node2.js

@@ -44,7 +44,7 @@ var E = class extends b {
 	static {
 		this.metadata = {
 			tag: "nve-tree-node",
-			version: "2.8.0",
+			version: "2.9.0",
 			parents: ["nve-tree", "nve-tree-node"]
 		};
 	}

package/dist/tree/tree2.js

@@ -22,7 +22,7 @@ var m = class extends d {
 	static {
 		this.metadata = {
 			tag: "nve-tree",
-			version: "2.8.0",
+			version: "2.9.0",
 			children: ["nve-tree-node"]
 		};
 	}

package/dist/viewport/define.d.ts

@@ -0,0 +1,7 @@
+import { Viewport, ViewportGridlines } from '@nvidia-elements/core/viewport';
+declare global {
+    interface HTMLElementTagNameMap {
+        'nve-viewport': Viewport;
+        'nve-viewport-gridlines': ViewportGridlines;
+    }
+}

package/dist/viewport/define.js

@@ -0,0 +1,7 @@
+import { define as e } from "../internal/utils/dom.js";
+import { Viewport as t } from "./viewport2.js";
+import { ViewportGridlines as n } from "./viewport-gridlines2.js";
+e(t), e(n);
+//#endregion
+
+//# sourceMappingURL=define.js.map

package/dist/viewport/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","names":[],"sources":["../../src/viewport/define.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { define } from '@nvidia-elements/core/internal';\nimport { Viewport, ViewportGridlines } from '@nvidia-elements/core/viewport';\n\ndefine(Viewport);\ndefine(ViewportGridlines);\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'nve-viewport': Viewport;\n    'nve-viewport-gridlines': ViewportGridlines;\n  }\n}\n"],"mappings":";;;AAMA,EAAO,CAAQ,GACf,EAAO,CAAiB"}

package/dist/viewport/index.d.ts

@@ -0,0 +1,3 @@
+export * from './viewport.js';
+export * from './viewport-gridlines.js';
+export type { ViewportAnimationOptions, ViewportDiscretePanDetail, ViewportPanBehavior, ViewportPanDetail, ViewportPanEndDetail, ViewportPanEndReason, ViewportPoint, ViewportPointerPanDetail, ViewportRect, ViewportRevealOptions, ViewportTransform, ViewportWheelPanDetail, ViewportZoomDetail } from './viewport.types.js';

package/dist/viewport/index.js

@@ -0,0 +1,3 @@
+import { Viewport as e } from "./viewport2.js";
+import { ViewportGridlines as t } from "./viewport-gridlines2.js";
+export { e as Viewport, t as ViewportGridlines };

package/dist/viewport/viewport-animation.controller.d.ts

@@ -0,0 +1,21 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ViewportAnimationOptions, ViewportTransform } from './viewport.types.js';
+interface ViewportSize {
+    readonly width: number;
+    readonly height: number;
+}
+export interface ViewportAnimationDelegate {
+    readonly commitTransform: (transform: ViewportTransform) => void;
+    readonly clampScale: (value: number) => number;
+    readonly getTransform: () => ViewportTransform;
+    readonly getViewportSize: () => ViewportSize;
+}
+export declare class ViewportAnimationController implements ReactiveController {
+    #private;
+    constructor(reactiveHost: ReactiveControllerHost, delegate: ViewportAnimationDelegate);
+    get destinationScale(): number | undefined;
+    animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void;
+    cancel(): void;
+    hostDisconnected(): void;
+}
+export {};

package/dist/viewport/viewport-animation.controller.js

@@ -0,0 +1,93 @@
+import { finiteOr as e, nonnegativeFiniteOr as t } from "../internal/utils/numeric.js";
+//#region src/viewport/viewport-animation.controller.ts
+var n = class {
+	#e;
+	#t;
+	constructor(e, t) {
+		this.#e = t, e.addController(this);
+	}
+	get destinationScale() {
+		return this.#t?.target.scale;
+	}
+	animateTo(n, i = {}) {
+		let o = this.#e.getTransform(), l = {
+			x: e(n.x, o.x),
+			y: e(n.y, o.y),
+			scale: this.#e.clampScale(n.scale ?? o.scale)
+		};
+		if (this.cancel(), s(o, l)) return;
+		let u = t(i.duration, r(o.scale, l.scale));
+		if (u === 0 || a()) {
+			this.#e.commitTransform(l);
+			return;
+		}
+		let d = {
+			duration: u,
+			frame: 0,
+			start: o,
+			startCenter: c(o, this.#e.getViewportSize()),
+			target: l
+		};
+		this.#t = d, d.frame = requestAnimationFrame(this.#n);
+	}
+	cancel() {
+		let e = this.#t;
+		e && (cancelAnimationFrame(e.frame), this.#t = void 0);
+	}
+	hostDisconnected() {
+		this.cancel();
+	}
+	#n = (e) => {
+		let t = this.#t;
+		if (!t) return;
+		if (t.startTime === void 0) return this.#r(t, e);
+		let n = Math.min(1, Math.max(0, (e - t.startTime) / t.duration)), r = o(n), a = this.#e.getViewportSize(), s = c(t.target, a), l = 1 / i(1 / t.start.scale, 1 / t.target.scale, r), u = i(t.startCenter.x, s.x, r), d = i(t.startCenter.y, s.y, r);
+		this.#e.commitTransform({
+			scale: l,
+			x: u - a.width / (2 * l),
+			y: d - a.height / (2 * l)
+		}), n >= 1 ? (this.#t = void 0, this.#e.commitTransform(t.target)) : t.frame = requestAnimationFrame(this.#n);
+	};
+	#r(e, t) {
+		e.startTime = t, e.frame = requestAnimationFrame(this.#n);
+	}
+};
+function r(e, t) {
+	return Math.min(400, Math.max(150, 150 + Math.abs(Math.log2(t / e)) * 100));
+}
+function i(e, t, n) {
+	return e + (t - e) * n;
+}
+function a() {
+	return typeof matchMedia == "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+function o(e) {
+	let t = e;
+	for (let n = 0; n < 6; n += 1) {
+		let n = l(t, .4, .2) - e, r = u(t, .4, .2);
+		if (Math.abs(r) < 1e-7) break;
+		t = Math.min(1, Math.max(0, t - n / r));
+	}
+	return l(t, 0, 1);
+}
+function s(e, t) {
+	return e.x === t.x && e.y === t.y && e.scale === t.scale;
+}
+function c(e, t) {
+	return {
+		x: e.x + t.width / (2 * e.scale),
+		y: e.y + t.height / (2 * e.scale)
+	};
+}
+function l(e, t, n) {
+	let r = 1 - e;
+	return 3 * r ** 2 * e * t + 3 * r * e ** 2 * n + e ** 3;
+}
+function u(e, t, n) {
+	let r = 1 - e;
+	return 3 * r ** 2 * t + 6 * r * e * (n - t) + 3 * e ** 2 * (1 - n);
+}
+//#endregion
+export { n as ViewportAnimationController };
+
+//# sourceMappingURL=viewport-animation.controller.js.map

package/dist/viewport/viewport-animation.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-animation.controller.js","names":[],"sources":["../../src/viewport/viewport-animation.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';\nimport { finiteOr, nonnegativeFiniteOr } from '@nvidia-elements/core/internal';\nimport type { ViewportAnimationOptions, ViewportPoint, ViewportTransform } from './viewport.types.js';\n\ninterface ViewportAnimation {\n  frame: number;\n  readonly start: ViewportTransform;\n  readonly target: ViewportTransform;\n  readonly startCenter: ViewportPoint;\n  startTime?: number;\n  readonly duration: number;\n}\n\ninterface ViewportSize {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface ViewportAnimationDelegate {\n  readonly commitTransform: (transform: ViewportTransform) => void;\n  readonly clampScale: (value: number) => number;\n  readonly getTransform: () => ViewportTransform;\n  readonly getViewportSize: () => ViewportSize;\n}\n\nexport class ViewportAnimationController implements ReactiveController {\n  readonly #delegate: ViewportAnimationDelegate;\n  #animation?: ViewportAnimation;\n\n  constructor(reactiveHost: ReactiveControllerHost, delegate: ViewportAnimationDelegate) {\n    this.#delegate = delegate;\n    reactiveHost.addController(this);\n  }\n\n  get destinationScale(): number | undefined {\n    return this.#animation?.target.scale;\n  }\n\n  animateTo(target: Partial<ViewportTransform>, options: ViewportAnimationOptions = {}): void {\n    const start = this.#delegate.getTransform();\n    const next: ViewportTransform = {\n      x: finiteOr(target.x, start.x),\n      y: finiteOr(target.y, start.y),\n      scale: this.#delegate.clampScale(target.scale ?? start.scale)\n    };\n    this.cancel();\n    if (transformsEqual(start, next)) return;\n    const duration = nonnegativeFiniteOr(options.duration, defaultAnimationDuration(start.scale, next.scale));\n    if (duration === 0 || prefersReducedMotion()) {\n      this.#delegate.commitTransform(next);\n      return;\n    }\n    const viewport = this.#delegate.getViewportSize();\n    const animation: ViewportAnimation = {\n      duration,\n      frame: 0,\n      start,\n      startCenter: viewportCenter(start, viewport),\n      target: next\n    };\n    this.#animation = animation;\n    animation.frame = requestAnimationFrame(this.#animateFrame);\n  }\n\n  cancel(): void {\n    const animation = this.#animation;\n    if (!animation) return;\n    cancelAnimationFrame(animation.frame);\n    this.#animation = undefined;\n  }\n\n  hostDisconnected(): void {\n    this.cancel();\n  }\n\n  #animateFrame = (time: number): void => {\n    const animation = this.#animation;\n    if (!animation) return;\n    if (animation.startTime === undefined) return this.#startAnimation(animation, time);\n    const progress = Math.min(1, Math.max(0, (time - animation.startTime) / animation.duration));\n    const eased = standardEasing(progress);\n    const viewport = this.#delegate.getViewportSize();\n    const targetCenter = viewportCenter(animation.target, viewport);\n    const scale = 1 / lerp(1 / animation.start.scale, 1 / animation.target.scale, eased);\n    const centerX = lerp(animation.startCenter.x, targetCenter.x, eased);\n    const centerY = lerp(animation.startCenter.y, targetCenter.y, eased);\n    this.#delegate.commitTransform({\n      scale,\n      x: centerX - viewport.width / (2 * scale),\n      y: centerY - viewport.height / (2 * scale)\n    });\n    if (progress >= 1) {\n      this.#animation = undefined;\n      this.#delegate.commitTransform(animation.target);\n    } else {\n      animation.frame = requestAnimationFrame(this.#animateFrame);\n    }\n  };\n\n  #startAnimation(animation: ViewportAnimation, time: number): void {\n    animation.startTime = time;\n    animation.frame = requestAnimationFrame(this.#animateFrame);\n  }\n}\n\nfunction defaultAnimationDuration(startScale: number, targetScale: number): number {\n  return Math.min(400, Math.max(150, 150 + Math.abs(Math.log2(targetScale / startScale)) * 100));\n}\n\nfunction lerp(start: number, end: number, progress: number): number {\n  return start + (end - start) * progress;\n}\n\nfunction prefersReducedMotion(): boolean {\n  return typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;\n}\n\nfunction standardEasing(progress: number): number {\n  let parameter = progress;\n  for (let iteration = 0; iteration < 6; iteration += 1) {\n    const x = cubicBezier(parameter, 0.4, 0.2) - progress;\n    const slope = cubicBezierSlope(parameter, 0.4, 0.2);\n    if (Math.abs(slope) < 1e-7) break;\n    parameter = Math.min(1, Math.max(0, parameter - x / slope));\n  }\n  return cubicBezier(parameter, 0, 1);\n}\n\nfunction transformsEqual(first: ViewportTransform, second: ViewportTransform): boolean {\n  return first.x === second.x && first.y === second.y && first.scale === second.scale;\n}\n\nfunction viewportCenter(transform: ViewportTransform, viewport: ViewportSize): ViewportPoint {\n  return {\n    x: transform.x + viewport.width / (2 * transform.scale),\n    y: transform.y + viewport.height / (2 * transform.scale)\n  };\n}\n\nfunction cubicBezier(parameter: number, firstControl: number, secondControl: number): number {\n  const inverse = 1 - parameter;\n  return 3 * inverse ** 2 * parameter * firstControl + 3 * inverse * parameter ** 2 * secondControl + parameter ** 3;\n}\n\nfunction cubicBezierSlope(parameter: number, firstControl: number, secondControl: number): number {\n  const inverse = 1 - parameter;\n  return (\n    3 * inverse ** 2 * firstControl +\n    6 * inverse * parameter * (secondControl - firstControl) +\n    3 * parameter ** 2 * (1 - secondControl)\n  );\n}\n"],"mappings":"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"}

package/dist/viewport/viewport-autofit.controller.d.ts

@@ -0,0 +1,18 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ViewportClientRect } from './viewport-fitting.utils.js';
+interface ViewportAutoFitHost extends ReactiveControllerHost, HTMLElement {
+    readonly autoFit: boolean;
+    readonly hasUpdated: boolean;
+}
+type ApplyInitialFit = (clientRects: readonly ViewportClientRect[]) => void;
+/** Coordinates one initial fit once default-slot children have definitions and measurable layout. */
+export declare class ViewportAutoFitController implements ReactiveController {
+    #private;
+    constructor(host: ViewportAutoFitHost, applyInitialFit: ApplyInitialFit);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    hostUpdated(): void;
+    contentChanged: (event: Event) => void;
+    consume(): void;
+}
+export {};

package/dist/viewport/viewport-autofit.controller.js

@@ -0,0 +1,105 @@
+import { getChildren as e, getCustomElementRegistry as t } from "../internal/utils/dom.js";
+//#region src/viewport/viewport-autofit.controller.ts
+var n = class {
+	#e;
+	#t;
+	#n;
+	#r;
+	#i;
+	#a;
+	#o;
+	constructor(e, t) {
+		this.#r = !1, this.#a = 0, this.contentChanged = (e) => {
+			e.target instanceof HTMLSlotElement && this.#c(e.target);
+		}, this.#t = e, this.#e = t, e.addController(this);
+	}
+	hostConnected() {
+		this.#t.hasUpdated && this.#c();
+	}
+	hostDisconnected() {
+		this.#s();
+	}
+	hostUpdated() {
+		this.#t.autoFit ? this.#c() : this.#s();
+	}
+	consume() {
+		!this.#t.autoFit || this.#r || (this.#r = !0, this.#n = void 0, this.#a += 1, this.#i !== void 0 && cancelAnimationFrame(this.#i), this.#i = void 0, this.#o?.disconnect(), this.#o = void 0);
+	}
+	#s() {
+		this.#a += 1, this.#n = void 0, this.#i !== void 0 && cancelAnimationFrame(this.#i), this.#i = void 0, this.#o?.disconnect(), this.#o = void 0;
+	}
+	#c(t) {
+		if (!this.#t.autoFit || this.#r || this.#n || !this.#t.isConnected) return;
+		let n = (t ? e(t) : Array.from(this.#t.children).filter((e) => !e.slot)).filter((e) => !(e instanceof HTMLElement && e.hidden));
+		this.#n = n;
+		let r = ++this.#a;
+		this.#l(n).then(() => this.#u(r));
+	}
+	async #l(e) {
+		let n = /* @__PURE__ */ new Map();
+		for (let r of e) for (let e of [r, ...r.querySelectorAll(":not(:defined)")]) {
+			if (e.namespaceURI !== "http://www.w3.org/1999/xhtml" || !e.localName.includes("-") || i(e, r)) continue;
+			let a = t(e);
+			if (!a) continue;
+			let o = n.get(a) ?? /* @__PURE__ */ new Set();
+			o.add(e.localName), n.set(a, o);
+		}
+		await Promise.all(Array.from(n, ([e, t]) => Promise.all(Array.from(t, (t) => r(e, t)))));
+	}
+	#u(e) {
+		if (this.#m(e)) {
+			if (typeof ResizeObserver > "u") {
+				queueMicrotask(() => this.#f(e));
+				return;
+			}
+			this.#o?.disconnect(), this.#o = new ResizeObserver(() => this.#d(e)), this.#o.observe(this.#t);
+		}
+	}
+	#d(e) {
+		!this.#m(e) || this.#t.clientWidth <= 0 || this.#t.clientHeight <= 0 || (this.#o?.disconnect(), this.#o = void 0, this.#i = requestAnimationFrame(() => {
+			this.#i = void 0, this.#f(e);
+		}));
+	}
+	#f(e) {
+		if (!this.#m(e) || this.#t.clientWidth <= 0 || this.#t.clientHeight <= 0) return;
+		let t = this.#n;
+		if (!t) return;
+		let n = this.#p(t);
+		this.consume(), n.length && this.#e(n);
+	}
+	#p(e) {
+		let t = new Set(Array.from(this.#t.children).filter((e) => !e.slot)), n = [];
+		for (let r of e) {
+			if (!t.has(r) || r instanceof HTMLElement && r.hidden) continue;
+			let e = r.getBoundingClientRect();
+			e.width > 0 && e.height > 0 && n.push({
+				height: e.height,
+				left: e.left,
+				top: e.top,
+				width: e.width
+			});
+		}
+		return n;
+	}
+	#m(e) {
+		return e === this.#a && this.#t.autoFit && !this.#r && this.#n !== void 0 && this.#t.isConnected;
+	}
+};
+async function r(e, t) {
+	try {
+		await e.whenDefined(t);
+	} catch (e) {
+		if (!(e instanceof DOMException) || e.name !== "SyntaxError") throw e;
+	}
+}
+function i(e, t) {
+	for (let n = e; n; n = n.parentElement) {
+		if (n instanceof HTMLElement && n.hidden) return !0;
+		if (n === t) return !1;
+	}
+	return !1;
+}
+//#endregion
+export { n as ViewportAutoFitController };
+
+//# sourceMappingURL=viewport-autofit.controller.js.map

package/dist/viewport/viewport-autofit.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-autofit.controller.js","names":[],"sources":["../../src/viewport/viewport-autofit.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';\nimport { getChildren, getCustomElementRegistry } from '@nvidia-elements/core/internal';\nimport type { ViewportClientRect } from './viewport-fitting.utils.js';\n\ninterface ViewportAutoFitHost extends ReactiveControllerHost, HTMLElement {\n  readonly autoFit: boolean;\n  readonly hasUpdated: boolean;\n}\n\ntype ApplyInitialFit = (clientRects: readonly ViewportClientRect[]) => void;\n\n/** Coordinates one initial fit once default-slot children have definitions and measurable layout. */\nexport class ViewportAutoFitController implements ReactiveController {\n  readonly #applyInitialFit: ApplyInitialFit;\n  readonly #host: ViewportAutoFitHost;\n  #children?: readonly Element[];\n  #consumed = false;\n  #frame?: number;\n  #generation = 0;\n  #observer?: ResizeObserver;\n\n  constructor(host: ViewportAutoFitHost, applyInitialFit: ApplyInitialFit) {\n    this.#host = host;\n    this.#applyInitialFit = applyInitialFit;\n    host.addController(this);\n  }\n\n  hostConnected(): void {\n    if (this.#host.hasUpdated) this.#start();\n  }\n\n  hostDisconnected(): void {\n    this.#cancelPending();\n  }\n\n  hostUpdated(): void {\n    if (this.#host.autoFit) {\n      this.#start();\n    } else {\n      this.#cancelPending();\n    }\n  }\n\n  contentChanged = (event: Event): void => {\n    if (!(event.target instanceof HTMLSlotElement)) return;\n    this.#start(event.target);\n  };\n\n  consume(): void {\n    if (!this.#host.autoFit || this.#consumed) return;\n    this.#consumed = true;\n    this.#children = undefined;\n    this.#generation += 1;\n    if (this.#frame !== undefined) cancelAnimationFrame(this.#frame);\n    this.#frame = undefined;\n    this.#observer?.disconnect();\n    this.#observer = undefined;\n  }\n\n  #cancelPending(): void {\n    this.#generation += 1;\n    this.#children = undefined;\n    if (this.#frame !== undefined) cancelAnimationFrame(this.#frame);\n    this.#frame = undefined;\n    this.#observer?.disconnect();\n    this.#observer = undefined;\n  }\n\n  #start(slot?: HTMLSlotElement): void {\n    if (!this.#host.autoFit || this.#consumed || this.#children || !this.#host.isConnected) return;\n    const children = (slot ? getChildren(slot) : Array.from(this.#host.children).filter(child => !child.slot)).filter(\n      child => !(child instanceof HTMLElement && child.hidden)\n    );\n    this.#children = children;\n    const generation = ++this.#generation;\n    void this.#waitForDefinitions(children).then(() => this.#waitForLayout(generation));\n  }\n\n  async #waitForDefinitions(children: readonly Element[]): Promise<void> {\n    const definitions = new Map<CustomElementRegistry, Set<string>>();\n    for (const child of children) {\n      for (const element of [child, ...child.querySelectorAll(':not(:defined)')]) {\n        if (\n          element.namespaceURI !== 'http://www.w3.org/1999/xhtml' ||\n          !element.localName.includes('-') ||\n          isExplicitlyHidden(element, child)\n        ) {\n          continue;\n        }\n        const registry = getCustomElementRegistry(element);\n        if (!registry) continue;\n        const names = definitions.get(registry) ?? new Set<string>();\n        names.add(element.localName);\n        definitions.set(registry, names);\n      }\n    }\n    await Promise.all(\n      Array.from(definitions, ([registry, names]) =>\n        Promise.all(Array.from(names, name => whenDefined(registry, name)))\n      )\n    );\n  }\n\n  #waitForLayout(generation: number): void {\n    if (!this.#isCurrent(generation)) return;\n    if (typeof ResizeObserver === 'undefined') {\n      queueMicrotask(() => this.#fit(generation));\n      return;\n    }\n    this.#observer?.disconnect();\n    this.#observer = new ResizeObserver(() => this.#scheduleFit(generation));\n    this.#observer.observe(this.#host);\n  }\n\n  #scheduleFit(generation: number): void {\n    if (!this.#isCurrent(generation) || this.#host.clientWidth <= 0 || this.#host.clientHeight <= 0) return;\n    this.#observer?.disconnect();\n    this.#observer = undefined;\n    this.#frame = requestAnimationFrame(() => {\n      this.#frame = undefined;\n      this.#fit(generation);\n    });\n  }\n\n  #fit(generation: number): void {\n    if (!this.#isCurrent(generation) || this.#host.clientWidth <= 0 || this.#host.clientHeight <= 0) return;\n    const children = this.#children;\n    if (!children) return;\n    const measurableBounds = this.#measurableClientRects(children);\n    this.consume();\n    if (measurableBounds.length) this.#applyInitialFit(measurableBounds);\n  }\n\n  #measurableClientRects(children: readonly Element[]): ViewportClientRect[] {\n    const assigned = new Set(Array.from(this.#host.children).filter(child => !child.slot));\n    const measurableBounds: ViewportClientRect[] = [];\n    for (const child of children) {\n      if (!assigned.has(child) || (child instanceof HTMLElement && child.hidden)) continue;\n      const bounds = child.getBoundingClientRect();\n      if (bounds.width > 0 && bounds.height > 0) {\n        measurableBounds.push({ height: bounds.height, left: bounds.left, top: bounds.top, width: bounds.width });\n      }\n    }\n    return measurableBounds;\n  }\n\n  #isCurrent(generation: number): boolean {\n    return (\n      generation === this.#generation &&\n      this.#host.autoFit &&\n      !this.#consumed &&\n      this.#children !== undefined &&\n      this.#host.isConnected\n    );\n  }\n}\n\nasync function whenDefined(registry: CustomElementRegistry, name: string): Promise<void> {\n  try {\n    await registry.whenDefined(name);\n  } catch (error) {\n    if (!(error instanceof DOMException) || error.name !== 'SyntaxError') throw error;\n  }\n}\n\nfunction isExplicitlyHidden(element: Element, child: Element): boolean {\n  for (let current: Element | null = element; current; current = current.parentElement) {\n    if (current instanceof HTMLElement && current.hidden) return true;\n    if (current === child) return false;\n  }\n  return false;\n}\n"],"mappings":"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"}

package/dist/viewport/viewport-fitting.utils.d.ts

@@ -0,0 +1,36 @@
+import type { ViewportRect, ViewportTransform } from './viewport.types.js';
+export interface ViewportClientRect {
+    readonly height: number;
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+}
+interface ViewportClientFrame {
+    readonly left: number;
+    readonly top: number;
+}
+export interface ViewportFitOptions {
+    readonly inset?: number;
+    readonly scale?: number;
+}
+/** Converts measurable client-space rectangles into their single content-space union. */
+export declare function contentBoundsFromClientRects(clientRects: Iterable<ViewportClientRect>, viewportFrame: ViewportClientFrame, transform: ViewportTransform): ViewportRect | undefined;
+/** Calculates the viewport transform that centers or fits a content-space region. */
+export declare function revealTarget(region: {
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+}, configuration: {
+    options: ViewportFitOptions;
+    scaleRange: {
+        min: number;
+        max: number;
+    };
+    transform: ViewportTransform;
+    viewport: {
+        width: number;
+        height: number;
+    };
+}): ViewportTransform;
+export {};

package/dist/viewport/viewport-fitting.utils.js

@@ -0,0 +1,35 @@
+import { finiteOr as e, nonnegativeFiniteOr as t, positiveFiniteOr as n } from "../internal/utils/numeric.js";
+//#region src/viewport/viewport-fitting.utils.ts
+function r(e, t, n) {
+	let r = Infinity, a = Infinity, o = -Infinity, s = -Infinity;
+	for (let c of e) {
+		let e = i(c, t, n);
+		e && (r = Math.min(r, e.x), a = Math.min(a, e.y), o = Math.max(o, e.x + e.width), s = Math.max(s, e.y + e.height));
+	}
+	if (!(!Number.isFinite(r) || !Number.isFinite(a) || !Number.isFinite(o) || !Number.isFinite(s))) return {
+		height: s - a,
+		width: o - r,
+		x: r,
+		y: a
+	};
+}
+function i(e, t, n) {
+	if (!(!(e.width > 0) || !(e.height > 0))) return {
+		height: e.height / n.scale,
+		width: e.width / n.scale,
+		x: n.x + (e.left - t.left) / n.scale,
+		y: n.y + (e.top - t.top) / n.scale
+	};
+}
+function a(r, i) {
+	let { options: a, scaleRange: o, transform: s, viewport: c } = i, l = t(a.inset, 0), u = n(r.width, 0), d = n(r.height, 0), f = u > 0 && d > 0, p = Math.max(0, c.width - l * 2), m = Math.max(0, c.height - l * 2), h = a.scale ?? (f && p > 0 && m > 0 ? Math.min(p / u, m / d) : s.scale), g = Math.min(o.max, Math.max(o.min, n(h, o.min))), _ = e(r.x, 0) + (f ? u / 2 : 0), v = e(r.y, 0) + (f ? d / 2 : 0);
+	return {
+		scale: g,
+		x: _ - c.width / (2 * g),
+		y: v - c.height / (2 * g)
+	};
+}
+//#endregion
+export { r as contentBoundsFromClientRects, a as revealTarget };
+
+//# sourceMappingURL=viewport-fitting.utils.js.map

package/dist/viewport/viewport-fitting.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-fitting.utils.js","names":[],"sources":["../../src/viewport/viewport-fitting.utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { finiteOr, nonnegativeFiniteOr, positiveFiniteOr } from '@nvidia-elements/core/internal';\nimport type { ViewportRect, ViewportTransform } from './viewport.types.js';\n\nexport interface ViewportClientRect {\n  readonly height: number;\n  readonly left: number;\n  readonly top: number;\n  readonly width: number;\n}\n\ninterface ViewportClientFrame {\n  readonly left: number;\n  readonly top: number;\n}\n\nexport interface ViewportFitOptions {\n  readonly inset?: number;\n  readonly scale?: number;\n}\n\n/** Converts measurable client-space rectangles into their single content-space union. */\nexport function contentBoundsFromClientRects(\n  clientRects: Iterable<ViewportClientRect>,\n  viewportFrame: ViewportClientFrame,\n  transform: ViewportTransform\n): ViewportRect | undefined {\n  let left = Number.POSITIVE_INFINITY;\n  let top = Number.POSITIVE_INFINITY;\n  let right = Number.NEGATIVE_INFINITY;\n  let bottom = Number.NEGATIVE_INFINITY;\n  for (const clientRect of clientRects) {\n    const contentRect = contentRectFromClientRect(clientRect, viewportFrame, transform);\n    if (!contentRect) continue;\n    left = Math.min(left, contentRect.x);\n    top = Math.min(top, contentRect.y);\n    right = Math.max(right, contentRect.x + contentRect.width);\n    bottom = Math.max(bottom, contentRect.y + contentRect.height);\n  }\n  if (!Number.isFinite(left) || !Number.isFinite(top) || !Number.isFinite(right) || !Number.isFinite(bottom)) {\n    return undefined;\n  }\n  return { height: bottom - top, width: right - left, x: left, y: top };\n}\n\nfunction contentRectFromClientRect(\n  clientRect: ViewportClientRect,\n  viewportFrame: ViewportClientFrame,\n  transform: ViewportTransform\n): ViewportRect | undefined {\n  if (!(clientRect.width > 0) || !(clientRect.height > 0)) return undefined;\n  return {\n    height: clientRect.height / transform.scale,\n    width: clientRect.width / transform.scale,\n    x: transform.x + (clientRect.left - viewportFrame.left) / transform.scale,\n    y: transform.y + (clientRect.top - viewportFrame.top) / transform.scale\n  };\n}\n\n/** Calculates the viewport transform that centers or fits a content-space region. */\nexport function revealTarget(\n  region: { x: number; y: number; width?: number; height?: number },\n  configuration: {\n    options: ViewportFitOptions;\n    scaleRange: { min: number; max: number };\n    transform: ViewportTransform;\n    viewport: { width: number; height: number };\n  }\n): ViewportTransform {\n  const { options, scaleRange, transform, viewport } = configuration;\n  const inset = nonnegativeFiniteOr(options.inset, 0);\n  const width = positiveFiniteOr(region.width, 0);\n  const height = positiveFiniteOr(region.height, 0);\n  const isRect = width > 0 && height > 0;\n  const availableWidth = Math.max(0, viewport.width - inset * 2);\n  const availableHeight = Math.max(0, viewport.height - inset * 2);\n  const requestedScale =\n    options.scale ??\n    (isRect && availableWidth > 0 && availableHeight > 0\n      ? Math.min(availableWidth / width, availableHeight / height)\n      : transform.scale);\n  const scale = Math.min(scaleRange.max, Math.max(scaleRange.min, positiveFiniteOr(requestedScale, scaleRange.min)));\n  const centerX = finiteOr(region.x, 0) + (isRect ? width / 2 : 0);\n  const centerY = finiteOr(region.y, 0) + (isRect ? height / 2 : 0);\n  return {\n    scale,\n    x: centerX - viewport.width / (2 * scale),\n    y: centerY - viewport.height / (2 * scale)\n  };\n}\n"],"mappings":";;AAwBA,SAAgB,EACd,GACA,GACA,GAC0B;CAC1B,IAAI,IAAO,UACP,IAAM,UACN,IAAQ,WACR,IAAS;CACb,KAAK,IAAM,KAAc,GAAa;EACpC,IAAM,IAAc,EAA0B,GAAY,GAAe,CAAS;EAC7E,MACL,IAAO,KAAK,IAAI,GAAM,EAAY,CAAC,GACnC,IAAM,KAAK,IAAI,GAAK,EAAY,CAAC,GACjC,IAAQ,KAAK,IAAI,GAAO,EAAY,IAAI,EAAY,KAAK,GACzD,IAAS,KAAK,IAAI,GAAQ,EAAY,IAAI,EAAY,MAAM;CAC9D;CACI,OAAC,OAAO,SAAS,CAAI,KAAK,CAAC,OAAO,SAAS,CAAG,KAAK,CAAC,OAAO,SAAS,CAAK,KAAK,CAAC,OAAO,SAAS,CAAM,IAGzG,OAAO;EAAE,QAAQ,IAAS;EAAK,OAAO,IAAQ;EAAM,GAAG;EAAM,GAAG;CAAI;AACtE;AAEA,SAAS,EACP,GACA,GACA,GAC0B;CACtB,QAAE,EAAW,QAAQ,MAAM,EAAE,EAAW,SAAS,KACrD,OAAO;EACL,QAAQ,EAAW,SAAS,EAAU;EACtC,OAAO,EAAW,QAAQ,EAAU;EACpC,GAAG,EAAU,KAAK,EAAW,OAAO,EAAc,QAAQ,EAAU;EACpE,GAAG,EAAU,KAAK,EAAW,MAAM,EAAc,OAAO,EAAU;CACpE;AACF;AAGA,SAAgB,EACd,GACA,GAMmB;CACnB,IAAM,EAAE,YAAS,eAAY,cAAW,gBAAa,GAC/C,IAAQ,EAAoB,EAAQ,OAAO,CAAC,GAC5C,IAAQ,EAAiB,EAAO,OAAO,CAAC,GACxC,IAAS,EAAiB,EAAO,QAAQ,CAAC,GAC1C,IAAS,IAAQ,KAAK,IAAS,GAC/B,IAAiB,KAAK,IAAI,GAAG,EAAS,QAAQ,IAAQ,CAAC,GACvD,IAAkB,KAAK,IAAI,GAAG,EAAS,SAAS,IAAQ,CAAC,GACzD,IACJ,EAAQ,UACP,KAAU,IAAiB,KAAK,IAAkB,IAC/C,KAAK,IAAI,IAAiB,GAAO,IAAkB,CAAM,IACzD,EAAU,QACV,IAAQ,KAAK,IAAI,EAAW,KAAK,KAAK,IAAI,EAAW,KAAK,EAAiB,GAAgB,EAAW,GAAG,CAAC,CAAC,GAC3G,IAAU,EAAS,EAAO,GAAG,CAAC,KAAK,IAAS,IAAQ,IAAI,IACxD,IAAU,EAAS,EAAO,GAAG,CAAC,KAAK,IAAS,IAAS,IAAI;CAC/D,OAAO;EACL;EACA,GAAG,IAAU,EAAS,SAAS,IAAI;EACnC,GAAG,IAAU,EAAS,UAAU,IAAI;CACtC;AACF"}

package/dist/viewport/viewport-gesture-navigation.controller.d.ts

@@ -0,0 +1,29 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ViewportPanBehavior, ViewportPoint, ViewportTransform } from './viewport.types.js';
+import type { ViewportNavigationEventDelegate } from './viewport-navigation.types.js';
+type ViewportGestureNavigationHost = HTMLElement & ReactiveControllerHost & {
+    readonly _internals: ElementInternals;
+    readonly behaviorPan: ViewportPanBehavior;
+    readonly behaviorZoom: boolean;
+    readonly dragThreshold: number;
+};
+export interface ViewportGestureNavigationDelegate {
+    readonly commitTransform: (next: ViewportTransform) => boolean;
+    readonly cancelAnimation: () => void;
+    readonly clampScale: (value: number) => number;
+    readonly clientToViewport: (clientX: number, clientY: number) => ViewportPoint;
+    readonly consumeAutoFit: () => void;
+    readonly events: ViewportNavigationEventDelegate;
+    readonly getTransform: () => ViewportTransform;
+}
+/** Coordinates the viewport's opt-in pointer, touch, pinch, and wheel navigation behavior. */
+export declare class ViewportGestureNavigationController implements ReactiveController {
+    #private;
+    constructor(host: ViewportGestureNavigationHost, delegate: ViewportGestureNavigationDelegate);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    hostUpdated(): void;
+    /** Rebase in-progress pointer math synchronously after an independent transform change. */
+    rebasePointerSessions(): void;
+}
+export {};