@nvidia-elements/core 2.15.0 → 2.15.2

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

@@ -1,21 +0,0 @@
-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

@@ -1,93 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-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

@@ -1,105 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,36 +0,0 @@
-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

@@ -1,35 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,27 +0,0 @@
-import type { ReactiveController, ReactiveControllerHost } from 'lit';
-import type { ViewportPanBehavior, ViewportPanSession, ViewportPanProposal, ViewportPoint, ViewportTransform, ViewportZoomProposal } from './viewport.types.js';
-type ViewportGestureNavigationHost = HTMLElement & ReactiveControllerHost & {
-    readonly _internals: ElementInternals;
-    readonly behaviorPan: ViewportPanBehavior;
-    readonly pannable: boolean;
-    readonly zoomable: boolean;
-    readonly dragThreshold: number;
-    requestPan(proposal: ViewportPanProposal): boolean;
-    requestZoom(proposal: ViewportZoomProposal): boolean;
-    startPan(proposal: ViewportPanProposal): ViewportPanSession | undefined;
-};
-interface ViewportGestureNavigationDelegate {
-    readonly clampScale: (value: number) => number;
-    readonly clientToViewport: (clientX: number, clientY: number) => ViewportPoint;
-    readonly getTransform: () => ViewportTransform;
-    readonly requestAdmittedPinchZoom: (proposal: ViewportZoomProposal) => boolean;
-}
-export declare class ViewportGestureNavigationController implements ReactiveController {
-    #private;
-    constructor(host: ViewportGestureNavigationHost, delegate: ViewportGestureNavigationDelegate);
-    hostConnected(): void;
-    hostDisconnected(): void;
-    hostUpdated(): void;
-    rebasePointerSessions(): void;
-}
-export {};