@nvidia-elements/core 2.2.3 → 2.3.0

package/dist/format-bytes/format-bytes.d.ts

@@ -0,0 +1,53 @@
+import { LitElement } from 'lit';
+export type FormatBytesDisplay = 'decimal' | 'binary';
+export type FormatBytesUnit = 'b' | 'kb' | 'mb' | 'gb' | 'tb' | 'pb';
+export type FormatBytesUnitDisplay = 'short' | 'long';
+/**
+ * @element nve-format-bytes
+ * @description Formats a byte count as localized, human-readable decimal or binary units.
+ * @documentation https://nvidia.github.io/elements/docs/elements/format-bytes/
+ * @since 0.0.0
+ * @entrypoint \@nvidia-elements/core/format-bytes
+ * @slot - Numeric byte count to format (such as 1048576). Serves as fallback before hydration.
+ * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/data
+ */
+export declare class FormatBytes extends LitElement {
+    #private;
+    static styles: import("lit").CSSResult[];
+    static readonly metadata: {
+        tag: string;
+        version: string;
+    };
+    /**
+     * Optional byte count for values supplied by JavaScript or bound data.
+     * By default, the component formats the element's text content, which also serves as the SSR fallback.
+     * When both are present, this property takes precedence.
+     */
+    value?: number;
+    /**
+     * Unit system: 'decimal' uses powers of 1000 and 'binary' uses powers of 1024.
+     */
+    display: FormatBytesDisplay;
+    /**
+     * Optional unit magnitude. When omitted, the component selects a unit from the byte count.
+     */
+    unit?: FormatBytesUnit;
+    /**
+     * Unit label length: 'short' renders labels such as 'mb'; 'long' renders labels such as 'megabytes'.
+     */
+    unitDisplay: FormatBytesUnitDisplay;
+    /**
+     * Language tag (such as en-US or de-DE) used to format the number.
+     * Defaults to document.documentElement.lang or the runtime default.
+     */
+    locale?: string;
+    /**
+     * Pad fraction output to at least this many digits.
+     */
+    minimumFractionDigits?: number;
+    /**
+     * Round fraction output to at most this many digits. Defaults to two effective digits after the decimal point.
+     */
+    maximumFractionDigits?: number;
+    render(): import("lit").TemplateResult<1>;
+}

package/dist/format-bytes/format-bytes.examples.js

@@ -0,0 +1,6 @@
+//#region src/format-bytes/format-bytes.examples.ts
+var e = "";
+//#endregion
+export { e as default };
+
+//# sourceMappingURL=format-bytes.examples.js.map

package/dist/format-bytes/format-bytes.examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.examples.js","names":[],"sources":["../../src/format-bytes/format-bytes.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html } from 'lit';\nimport '@nvidia-elements/core/format-bytes/define.js';\n\nexport default {\n  title: 'Elements/FormatBytes',\n  component: 'nve-format-bytes'\n};\n\n/**\n * @summary Automatic decimal conversion for concise file sizes and storage metrics. The component selects the appropriate unit from the byte count.\n */\nexport const Default = {\n  render: () => html`\n    <div nve-layout=\"column gap:sm\">\n      <nve-format-bytes>1024</nve-format-bytes>\n      <nve-format-bytes>1048576</nve-format-bytes>\n      <nve-format-bytes>1073741824</nve-format-bytes>\n    </div>\n  `\n};\n\n/**\n * @summary Forced unit magnitudes for comparing byte counts on a consistent scale. Use when values need the same unit across a table or chart.\n */\nexport const Unit = {\n  render: () => html`\n    <div nve-layout=\"column gap:sm\">\n      <nve-format-bytes unit=\"kb\">1048576</nve-format-bytes>\n      <nve-format-bytes unit=\"mb\">1048576</nve-format-bytes>\n      <nve-format-bytes unit=\"gb\">1048576</nve-format-bytes>\n    </div>\n  `\n};\n\n/**\n * @summary Short and long unit labels for compact metrics or explanatory text. Long labels improve clarity when space allows.\n */\nexport const UnitDisplay = {\n  render: () => html`\n    <div nve-layout=\"column gap:sm\">\n      <nve-format-bytes unit-display=\"short\">1048576</nve-format-bytes>\n      <nve-format-bytes unit-display=\"long\">1048576</nve-format-bytes>\n      <nve-format-bytes display=\"binary\" unit-display=\"long\">1048576</nve-format-bytes>\n    </div>\n  `\n};\n\n/**\n * @summary Fraction digit controls for matching the precision of storage measurements. Use fixed digits when values must align visually.\n */\nexport const Precision = {\n  render: () => html`\n    <div nve-layout=\"column gap:sm\">\n      <nve-format-bytes maximum-fraction-digits=\"0\">1234567</nve-format-bytes>\n      <nve-format-bytes maximum-fraction-digits=\"2\">1234567</nve-format-bytes>\n      <nve-format-bytes minimum-fraction-digits=\"3\" maximum-fraction-digits=\"3\">1234567</nve-format-bytes>\n    </div>\n  `\n};\n\n/**\n * @summary Explicit locale formatting for audiences whose numeric separators differ from the document language. Unit labels remain lowercase English.\n */\nexport const Locale = {\n  render: () => html`\n    <div nve-layout=\"column gap:sm\">\n      <nve-format-bytes locale=\"en-US\">1048576</nve-format-bytes>\n      <nve-format-bytes locale=\"de-DE\">1048576</nve-format-bytes>\n      <nve-format-bytes locale=\"fr-FR\">1048576</nve-format-bytes>\n    </div>\n  `\n};\n\n/**\n * @summary Value attribute input for JavaScript or bound data. It takes precedence over text content while the text remains an SSR fallback.\n */\nexport const Value = {\n  render: () => html`<nve-format-bytes value=\"1048576\">1024</nve-format-bytes>`\n};\n\n/**\n * @summary Decimal and binary conversion for matching SI or IEC storage conventions. Use the convention expected by the surrounding product.\n */\nexport const Display = {\n  render: () => html`\n    <div nve-layout=\"column gap:sm\">\n      <nve-format-bytes display=\"decimal\">1024</nve-format-bytes>\n      <nve-format-bytes display=\"binary\">1024</nve-format-bytes>\n    </div>\n  `\n};\n"],"mappings":";AAGA,IAAA,IAAS"}

package/dist/format-bytes/format-bytes.examples.json

@@ -0,0 +1,69 @@
+{
+  "element": "nve-format-bytes",
+  "entrypoint": "@nvidia-elements/core/format-bytes/format-bytes.examples.json",
+  "items": [
+    {
+      "id": "format-bytes",
+      "name": "Default",
+      "template": "<div nve-layout=\"column gap:sm\">\n  <nve-format-bytes>1024</nve-format-bytes>\n  <nve-format-bytes>1048576</nve-format-bytes>\n  <nve-format-bytes>1073741824</nve-format-bytes>\n</div>\n",
+      "summary": "Automatic decimal conversion for concise file sizes and storage metrics. The component selects the appropriate unit from the byte count.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "format-bytes-unit",
+      "name": "Unit",
+      "template": "<div nve-layout=\"column gap:sm\">\n  <nve-format-bytes unit=\"kb\">1048576</nve-format-bytes>\n  <nve-format-bytes unit=\"mb\">1048576</nve-format-bytes>\n  <nve-format-bytes unit=\"gb\">1048576</nve-format-bytes>\n</div>\n",
+      "summary": "Forced unit magnitudes for comparing byte counts on a consistent scale. Use when values need the same unit across a table or chart.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "format-bytes-unit-display",
+      "name": "UnitDisplay",
+      "template": "<div nve-layout=\"column gap:sm\">\n  <nve-format-bytes unit-display=\"short\">1048576</nve-format-bytes>\n  <nve-format-bytes unit-display=\"long\">1048576</nve-format-bytes>\n  <nve-format-bytes display=\"binary\" unit-display=\"long\">1048576</nve-format-bytes>\n</div>\n",
+      "summary": "Short and long unit labels for compact metrics or explanatory text. Long labels improve clarity when space allows.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "format-bytes-precision",
+      "name": "Precision",
+      "template": "<div nve-layout=\"column gap:sm\">\n  <nve-format-bytes maximum-fraction-digits=\"0\">1234567</nve-format-bytes>\n  <nve-format-bytes maximum-fraction-digits=\"2\">1234567</nve-format-bytes>\n  <nve-format-bytes minimum-fraction-digits=\"3\" maximum-fraction-digits=\"3\">1234567</nve-format-bytes>\n</div>\n",
+      "summary": "Fraction digit controls for matching the precision of storage measurements. Use fixed digits when values must align visually.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "format-bytes-locale",
+      "name": "Locale",
+      "template": "<div nve-layout=\"column gap:sm\">\n  <nve-format-bytes locale=\"en-US\">1048576</nve-format-bytes>\n  <nve-format-bytes locale=\"de-DE\">1048576</nve-format-bytes>\n  <nve-format-bytes locale=\"fr-FR\">1048576</nve-format-bytes>\n</div>\n",
+      "summary": "Explicit locale formatting for audiences whose numeric separators differ from the document language. Unit labels remain lowercase English.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "format-bytes-value",
+      "name": "Value",
+      "template": "<nve-format-bytes value=\"1048576\">1024</nve-format-bytes>\n",
+      "summary": "Value attribute input for JavaScript or bound data. It takes precedence over text content while the text remains an SSR fallback.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    },
+    {
+      "id": "format-bytes-display",
+      "name": "Display",
+      "template": "<div nve-layout=\"column gap:sm\">\n  <nve-format-bytes display=\"decimal\">1024</nve-format-bytes>\n  <nve-format-bytes display=\"binary\">1024</nve-format-bytes>\n</div>\n",
+      "summary": "Decimal and binary conversion for matching SI or IEC storage conventions. Use the convention expected by the surrounding product.",
+      "description": "",
+      "composition": false,
+      "tags": []
+    }
+  ]
+}

package/dist/format-bytes/format-bytes.js

@@ -0,0 +1,6 @@
+//#region src/format-bytes/format-bytes.css?inline
+var e = ":host{display:inline}[internal-host]{color:var(--nve-sys-text-color, inherit)}slot{display:none}";
+//#endregion
+export { e as default };
+
+//# sourceMappingURL=format-bytes.js.map

package/dist/format-bytes/format-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes.js","names":[],"sources":["../../src/format-bytes/format-bytes.css?inline"],"sourcesContent":["/* SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. */\n/* SPDX-License-Identifier: Apache-2.0 */\n\n:host {\n  display: inline;\n}\n\n[internal-host] {\n  color: var(--nve-sys-text-color, inherit);\n}\n\nslot {\n  display: none;\n}\n"],"mappings":""}

package/dist/format-bytes/format-bytes2.js

@@ -0,0 +1,182 @@
+import { LogService as e } from "../internal/services/log.service.js";
+import { typeSSR as t } from "../internal/controllers/type-ssr.controller.js";
+import { useStyles as n } from "../internal/styles/index.js";
+import r from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/decorate.js";
+import i from "./format-bytes.js";
+import { LitElement as a, html as o } from "lit";
+import { property as s } from "lit/decorators/property.js";
+//#region src/format-bytes/format-bytes.ts
+var c = [
+	"b",
+	"kb",
+	"mb",
+	"gb",
+	"tb",
+	"pb"
+], l = ["decimal", "binary"], u = ["short", "long"], d = {
+	b: {
+		short: "b",
+		singular: "byte",
+		plural: "bytes"
+	},
+	kb: {
+		short: "kb",
+		singular: "kilobyte",
+		plural: "kilobytes"
+	},
+	mb: {
+		short: "mb",
+		singular: "megabyte",
+		plural: "megabytes"
+	},
+	gb: {
+		short: "gb",
+		singular: "gigabyte",
+		plural: "gigabytes"
+	},
+	tb: {
+		short: "tb",
+		singular: "terabyte",
+		plural: "terabytes"
+	},
+	pb: {
+		short: "pb",
+		singular: "petabyte",
+		plural: "petabytes"
+	}
+}, f = {
+	b: {
+		short: "b",
+		singular: "byte",
+		plural: "bytes"
+	},
+	kb: {
+		short: "kib",
+		singular: "kibibyte",
+		plural: "kibibytes"
+	},
+	mb: {
+		short: "mib",
+		singular: "mebibyte",
+		plural: "mebibytes"
+	},
+	gb: {
+		short: "gib",
+		singular: "gibibyte",
+		plural: "gibibytes"
+	},
+	tb: {
+		short: "tib",
+		singular: "tebibyte",
+		plural: "tebibytes"
+	},
+	pb: {
+		short: "pib",
+		singular: "pebibyte",
+		plural: "pebibytes"
+	}
+};
+function p(e) {
+	return l.some((t) => t === e);
+}
+function m(e) {
+	return c.some((t) => t === e);
+}
+function h(e) {
+	return u.some((t) => t === e);
+}
+var g = class extends a {
+	constructor(...e) {
+		super(...e), this.display = "decimal", this.unitDisplay = "short";
+	}
+	static {
+		this.styles = n([i]);
+	}
+	static {
+		this.metadata = {
+			tag: "nve-format-bytes",
+			version: "2.3.0"
+		};
+	}
+	get #e() {
+		let e = Number.isNaN(this.value) ? this.getAttribute("value") ?? this.value : this.value;
+		return String(e ?? this.textContent?.trim() ?? "");
+	}
+	get #t() {
+		return this.locale ?? (globalThis.document?.documentElement?.lang || void 0);
+	}
+	get #n() {
+		let t = this.#e;
+		if (!t) return null;
+		let n = Number(t);
+		return Number.isFinite(n) ? n : (e.warn(`format-bytes: invalid numeric value "${t}"`), null);
+	}
+	#r(e, t) {
+		let n = t === "binary" ? 1024 : 1e3, r = Math.abs(e);
+		for (let e = c.length - 1; e > 0; e--) {
+			let t = c[e];
+			if (t && r >= n ** e) return t;
+		}
+		return "b";
+	}
+	#i(e, t) {
+		let n = this.display === "binary" ? f[e] : d[e];
+		return this.unitDisplay === "short" ? n.short : Math.abs(t) === 1 ? n.singular : n.plural;
+	}
+	#a(t, n) {
+		e.warn(`format-bytes: invalid ${t} value "${String(n)}"`);
+	}
+	#o() {
+		return p(this.display) ? h(this.unitDisplay) ? this.unit !== void 0 && !m(this.unit) ? (this.#a("unit", this.unit), !1) : !0 : (this.#a("unit-display", this.unitDisplay), !1) : (this.#a("display", this.display), !1);
+	}
+	get #s() {
+		let e = this.maximumFractionDigits ?? Math.max(this.minimumFractionDigits ?? 0, 2);
+		return {
+			minimumFractionDigits: this.minimumFractionDigits,
+			maximumFractionDigits: e
+		};
+	}
+	#c(e) {
+		return Number(new Intl.NumberFormat("en-US-u-nu-latn", {
+			...this.#s,
+			useGrouping: !1
+		}).format(e));
+	}
+	#l(e) {
+		return new Intl.NumberFormat(this.#t, this.#s).format(e);
+	}
+	get #u() {
+		let t = this.#e;
+		if (!t) return "";
+		let n = this.#n;
+		if (n === null || !this.#o()) return t;
+		let r = this.unit ?? this.#r(n, this.display), i = c.indexOf(r), a = n / (this.display === "binary" ? 1024 : 1e3) ** i;
+		try {
+			let e = this.#c(a);
+			return `${this.#l(e)} ${this.#i(r, e)}`;
+		} catch (n) {
+			let r = n instanceof Error ? n.message : String(n);
+			return e.warn(`format-bytes: ${r}`), t;
+		}
+	}
+	render() {
+		return o`<data internal-host value="${this.#e}">${this.#u}<slot @slotchange="${this.#d}" hidden></slot></data>`;
+	}
+	#d() {
+		this.requestUpdate();
+	}
+};
+r([s({ type: Number })], g.prototype, "value", void 0), r([s({ type: String })], g.prototype, "display", void 0), r([s({ type: String })], g.prototype, "unit", void 0), r([s({
+	type: String,
+	attribute: "unit-display"
+})], g.prototype, "unitDisplay", void 0), r([s({ type: String })], g.prototype, "locale", void 0), r([s({
+	type: Number,
+	attribute: "minimum-fraction-digits"
+})], g.prototype, "minimumFractionDigits", void 0), r([s({
+	type: Number,
+	attribute: "maximum-fraction-digits"
+})], g.prototype, "maximumFractionDigits", void 0), g = r([t()], g);
+//#endregion
+export { g as FormatBytes };
+
+//# sourceMappingURL=format-bytes2.js.map

package/dist/format-bytes/format-bytes2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-bytes2.js","names":["#rawValue","#resolvedLocale","#parsedValue","#warnInvalidOption","#numberFormatOptions","#formattedBytes","#hasValidConfiguration","#resolveAutoUnit","#roundNumber","#formatNumber","#formatLabel","#onSlotChange"],"sources":["../../src/format-bytes/format-bytes.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, LitElement } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport { LogService, typeSSR, useStyles } from '@nvidia-elements/core/internal';\nimport styles from './format-bytes.css?inline';\n\nexport type FormatBytesDisplay = 'decimal' | 'binary';\nexport type FormatBytesUnit = 'b' | 'kb' | 'mb' | 'gb' | 'tb' | 'pb';\nexport type FormatBytesUnitDisplay = 'short' | 'long';\n\ninterface UnitLabels {\n  short: string;\n  singular: string;\n  plural: string;\n}\n\nconst UNITS: readonly FormatBytesUnit[] = ['b', 'kb', 'mb', 'gb', 'tb', 'pb'];\nconst DISPLAYS: readonly FormatBytesDisplay[] = ['decimal', 'binary'];\nconst UNIT_DISPLAYS: readonly FormatBytesUnitDisplay[] = ['short', 'long'];\n\nconst DECIMAL_LABELS: Record<FormatBytesUnit, UnitLabels> = {\n  b: { short: 'b', singular: 'byte', plural: 'bytes' },\n  kb: { short: 'kb', singular: 'kilobyte', plural: 'kilobytes' },\n  mb: { short: 'mb', singular: 'megabyte', plural: 'megabytes' },\n  gb: { short: 'gb', singular: 'gigabyte', plural: 'gigabytes' },\n  tb: { short: 'tb', singular: 'terabyte', plural: 'terabytes' },\n  pb: { short: 'pb', singular: 'petabyte', plural: 'petabytes' }\n};\n\nconst BINARY_LABELS: Record<FormatBytesUnit, UnitLabels> = {\n  b: { short: 'b', singular: 'byte', plural: 'bytes' },\n  kb: { short: 'kib', singular: 'kibibyte', plural: 'kibibytes' },\n  mb: { short: 'mib', singular: 'mebibyte', plural: 'mebibytes' },\n  gb: { short: 'gib', singular: 'gibibyte', plural: 'gibibytes' },\n  tb: { short: 'tib', singular: 'tebibyte', plural: 'tebibytes' },\n  pb: { short: 'pib', singular: 'pebibyte', plural: 'pebibytes' }\n};\n\nfunction isDisplay(value: unknown): value is FormatBytesDisplay {\n  return DISPLAYS.some(display => display === value);\n}\n\nfunction isUnit(value: unknown): value is FormatBytesUnit {\n  return UNITS.some(unit => unit === value);\n}\n\nfunction isUnitDisplay(value: unknown): value is FormatBytesUnitDisplay {\n  return UNIT_DISPLAYS.some(unitDisplay => unitDisplay === value);\n}\n\n/**\n * @element nve-format-bytes\n * @description Formats a byte count as localized, human-readable decimal or binary units.\n * @documentation https://nvidia.github.io/elements/docs/elements/format-bytes/\n * @since 0.0.0\n * @entrypoint \\@nvidia-elements/core/format-bytes\n * @slot - Numeric byte count to format (such as 1048576). Serves as fallback before hydration.\n * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/data\n */\n@typeSSR()\nexport class FormatBytes extends LitElement {\n  static styles = useStyles([styles]);\n\n  static readonly metadata = {\n    tag: 'nve-format-bytes',\n    version: '0.0.0'\n  };\n\n  /**\n   * Optional byte count for values supplied by JavaScript or bound data.\n   * By default, the component formats the element's text content, which also serves as the SSR fallback.\n   * When both are present, this property takes precedence.\n   */\n  @property({ type: Number }) value?: number;\n\n  /**\n   * Unit system: 'decimal' uses powers of 1000 and 'binary' uses powers of 1024.\n   */\n  @property({ type: String }) display: FormatBytesDisplay = 'decimal';\n\n  /**\n   * Optional unit magnitude. When omitted, the component selects a unit from the byte count.\n   */\n  @property({ type: String }) unit?: FormatBytesUnit;\n\n  /**\n   * Unit label length: 'short' renders labels such as 'mb'; 'long' renders labels such as 'megabytes'.\n   */\n  @property({ type: String, attribute: 'unit-display' }) unitDisplay: FormatBytesUnitDisplay = 'short';\n\n  /**\n   * Language tag (such as en-US or de-DE) used to format the number.\n   * Defaults to document.documentElement.lang or the runtime default.\n   */\n  @property({ type: String }) locale?: string;\n\n  /**\n   * Pad fraction output to at least this many digits.\n   */\n  @property({ type: Number, attribute: 'minimum-fraction-digits' }) minimumFractionDigits?: number;\n\n  /**\n   * Round fraction output to at most this many digits. Defaults to two effective digits after the decimal point.\n   */\n  @property({ type: Number, attribute: 'maximum-fraction-digits' }) maximumFractionDigits?: number;\n\n  get #rawValue(): string {\n    const value = Number.isNaN(this.value) ? (this.getAttribute('value') ?? this.value) : this.value;\n    return String(value ?? this.textContent?.trim() ?? '');\n  }\n\n  get #resolvedLocale(): string | undefined {\n    return this.locale ?? (globalThis.document?.documentElement?.lang || undefined);\n  }\n\n  get #parsedValue(): number | null {\n    const rawValue = this.#rawValue;\n    if (!rawValue) return null;\n\n    const numericValue = Number(rawValue);\n    if (Number.isFinite(numericValue)) return numericValue;\n\n    LogService.warn(`format-bytes: invalid numeric value \"${rawValue}\"`);\n    return null;\n  }\n\n  #resolveAutoUnit(value: number, display: FormatBytesDisplay): FormatBytesUnit {\n    const base = display === 'binary' ? 1024 : 1000;\n    const absoluteValue = Math.abs(value);\n\n    for (let index = UNITS.length - 1; index > 0; index--) {\n      const unit = UNITS[index];\n      if (unit && absoluteValue >= base ** index) return unit;\n    }\n\n    return 'b';\n  }\n\n  #formatLabel(unit: FormatBytesUnit, convertedValue: number): string {\n    const labels = this.display === 'binary' ? BINARY_LABELS[unit] : DECIMAL_LABELS[unit];\n    if (this.unitDisplay === 'short') return labels.short;\n    return Math.abs(convertedValue) === 1 ? labels.singular : labels.plural;\n  }\n\n  #warnInvalidOption(name: string, value: unknown): void {\n    LogService.warn(`format-bytes: invalid ${name} value \"${String(value)}\"`);\n  }\n\n  #hasValidConfiguration(): boolean {\n    if (!isDisplay(this.display)) {\n      this.#warnInvalidOption('display', this.display);\n      return false;\n    }\n    if (!isUnitDisplay(this.unitDisplay)) {\n      this.#warnInvalidOption('unit-display', this.unitDisplay);\n      return false;\n    }\n    if (this.unit !== undefined && !isUnit(this.unit)) {\n      this.#warnInvalidOption('unit', this.unit);\n      return false;\n    }\n    return true;\n  }\n\n  get #numberFormatOptions(): Intl.NumberFormatOptions {\n    const effectiveMaximumFractionDigits = this.maximumFractionDigits ?? Math.max(this.minimumFractionDigits ?? 0, 2);\n    return {\n      minimumFractionDigits: this.minimumFractionDigits,\n      maximumFractionDigits: effectiveMaximumFractionDigits\n    };\n  }\n\n  #roundNumber(value: number): number {\n    return Number(\n      new Intl.NumberFormat('en-US-u-nu-latn', {\n        ...this.#numberFormatOptions,\n        useGrouping: false\n      }).format(value)\n    );\n  }\n\n  #formatNumber(value: number): string {\n    return new Intl.NumberFormat(this.#resolvedLocale, this.#numberFormatOptions).format(value);\n  }\n\n  get #formattedBytes(): string {\n    const rawValue = this.#rawValue;\n    if (!rawValue) return '';\n\n    const numericValue = this.#parsedValue;\n    if (numericValue === null) return rawValue;\n    if (!this.#hasValidConfiguration()) return rawValue;\n\n    const resolvedUnit = this.unit ?? this.#resolveAutoUnit(numericValue, this.display);\n    const unitIndex = UNITS.indexOf(resolvedUnit);\n    const base = this.display === 'binary' ? 1024 : 1000;\n    const convertedValue = numericValue / base ** unitIndex;\n\n    try {\n      const roundedValue = this.#roundNumber(convertedValue);\n      return `${this.#formatNumber(roundedValue)} ${this.#formatLabel(resolvedUnit, roundedValue)}`;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      LogService.warn(`format-bytes: ${message}`);\n      return rawValue;\n    }\n  }\n\n  render() {\n    return html`<data internal-host value=${this.#rawValue}>${this.#formattedBytes}<slot @slotchange=${this.#onSlotChange} hidden></slot></data>`;\n  }\n\n  #onSlotChange() {\n    this.requestUpdate();\n  }\n}\n"],"mappings":"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"}

package/dist/format-bytes/index.d.ts

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

package/dist/format-bytes/index.js

@@ -0,0 +1,2 @@
+import { FormatBytes as e } from "./format-bytes2.js";
+export { e as FormatBytes };

package/dist/format-datetime/format-datetime2.js

@@ -13,7 +13,7 @@ var c = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-format-datetime",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	get #e() {

package/dist/format-number/format-number2.js

@@ -29,7 +29,7 @@ var c = [
 	static {
 		this.metadata = {
 			tag: "nve-format-number",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	get #e() {

package/dist/format-relative-time/format-relative-time2.js

@@ -53,7 +53,7 @@ var c = {
 	static {
 		this.metadata = {
 			tag: "nve-format-relative-time",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	#e;

package/dist/forms/control/control2.js

@@ -48,7 +48,7 @@ var C = class extends v {
 	static {
 		this.metadata = {
 			tag: "nve-control",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	render() {

package/dist/forms/control-group/control-group2.js

@@ -24,7 +24,7 @@ var m = class extends d {
 	static {
 		this.metadata = {
 			tag: "nve-control-group",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	render() {

package/dist/forms/control-message/control-message2.js

@@ -23,7 +23,7 @@ var l = {
 	static {
 		this.metadata = {
 			tag: "nve-control-message",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	static {

package/dist/gauge/gauge.examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"gauge.examples.js","names":[],"sources":["../../src/gauge/gauge.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html } from 'lit';\nimport '@nvidia-elements/core/gauge/define.js';\n\nexport default {\n  title: 'Elements/Gauge',\n  component: 'nve-gauge',\n};\n\n/**\n * @summary 270-degree gauges for displaying system resource usage.\n */\nexport const Default = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge value=\"50\">50%</nve-gauge>\n      <nve-gauge status=\"accent\" value=\"66\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Shape variants compare the default 270-degree gauge with the compact half gauge for telemetry layouts with tighter vertical space.\n * @tags test-case\n */\nexport const Shape = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm align:vertical-center\">\n      <nve-gauge status=\"accent\" value=\"66\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" status=\"accent\" value=\"66\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Half shape variant for telemetry layouts with tighter vertical space.\n * @tags test-case\n */\nexport const ShapeHalf = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm align:vertical-center\">\n      <nve-gauge shape=\"half\" value=\"66\" size=\"sm\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" value=\"66\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" value=\"66\" size=\"lg\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Half shape with needle thumb variant for rapidly changing values in confined spaces.\n * @tags test-case\n */\nexport const ShapeHalfNeedle = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm align:vertical-center\">\n      <nve-gauge shape=\"half\" thumb=\"needle\" value=\"66\" size=\"sm\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" thumb=\"needle\" value=\"66\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" thumb=\"needle\" value=\"66\" size=\"lg\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Thumb variants compare filled, dot, and needle indicators for dashboards that need different levels of visual emphasis.\n * @tags test-case\n */\nexport const Thumb = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge thumb=\"fill\" value=\"66\">fill</nve-gauge>\n      <nve-gauge thumb=\"dot\" value=\"66\">dot</nve-gauge>\n      <nve-gauge thumb=\"needle\" value=\"66\">needle</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Gauges with values from 0% to 100% for displaying system resource usage.\n * @tags test-case\n */\nexport const Values = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge value=\"0\">0%</nve-gauge>\n      <nve-gauge value=\"33\">33%</nve-gauge>\n      <nve-gauge value=\"66\">66%</nve-gauge>\n      <nve-gauge value=\"100\">100%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Gauges with custom max values for mission checkpoints, validation clips, and map tile processing.\n * @tags test-case\n */\nexport const Max = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge status=\"accent\" max=\"20\" value=\"5\">5/20</nve-gauge>\n      <nve-gauge max=\"20\" value=\"10\">10/20</nve-gauge>\n      <nve-gauge max=\"20\" value=\"15\">15/20</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Gauges with accent, success, warning, and danger colors for autonomous system health and readiness signals.\n * @tags test-case\n */\nexport const Status = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge value=\"50\">50%</nve-gauge>\n      <nve-gauge status=\"accent\" value=\"75\">75%</nve-gauge>\n      <nve-gauge status=\"success\" value=\"75\">75%</nve-gauge>\n      <nve-gauge status=\"warning\" value=\"75\" aria-valuetext=\"2.1m\">2.1m</nve-gauge>\n      <nve-gauge status=\"danger\" value=\"75\" aria-valuetext=\"0Hz\">0Hz</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Use gradient colors for gauges with scaled non-segmented values such as temperature and bandwidth.\n * @tags pattern\n */\nexport const Gradient = {\n  render: () => html`\n    <style>\n      nve-gauge#gauge-temperature-example {\n        --background: conic-gradient(\n          from 225deg at 50% 50%,\n          var(--nve-sys-support-success-emphasis-color) 0deg 18deg,\n          var(--nve-sys-support-warning-emphasis-color) 135deg,\n          var(--nve-sys-support-danger-emphasis-color) 252deg 300deg,\n          var(--nve-sys-support-success-emphasis-color) 300deg 360deg\n        );\n      }\n\n      nve-gauge#gauge-mbps-example {\n        --background: conic-gradient(\n          from 225deg at 50% 50%,\n          var(--nve-sys-support-danger-emphasis-color) 0deg 18deg,\n          var(--nve-sys-support-warning-emphasis-color) 135deg,\n          var(--nve-sys-support-success-emphasis-color) 252deg 300deg,\n          var(--nve-sys-support-danger-emphasis-color) 300deg 360deg\n        );\n      }\n    </style>\n\n    <div nve-layout=\"row gap:md\">\n      <nve-gauge thumb=\"dot\" value=\"82\" id=\"gauge-temperature-example\" aria-label=\"Temperature\" aria-valuetext=\"82°C\">\n        <span>82&deg;C</span>\n        <span nve-text=\"body sm muted\">TEMP</span>\n      </nve-gauge>\n\n      <nve-gauge thumb=\"needle\" value=\"98\" id=\"gauge-mbps-example\" aria-label=\"Download\" aria-valuetext=\"980Mbps\">\n        <span nve-text=\"body sm\">980Mbps</span>\n        <span nve-text=\"body sm muted\">Download</span>\n      </nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Small gauge paired with route-solve text for compact autonomous vehicle task rows.\n * @tags test-case\n */\nexport const WithText = {\n  render: () => html`\n    <div nve-layout=\"row gap:xs align:vertical-center\" nve-text=\"medium\">\n      <nve-gauge status=\"accent\" size=\"sm\" value=\"50\" aria-labelledby=\"route-solve-label\" aria-valuetext=\"2.4s\">2.4s</nve-gauge>\n      <span id=\"route-solve-label\">Route solve</span>\n    </div>\n`};\n\n/**\n * @summary Gauges in small, medium, and large sizes for dense robotics and autonomous vehicle dashboards.\n * @tags test-case\n */\nexport const Size = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge size=\"sm\" value=\"50\" aria-valuetext=\"30Hz\">\n        <span nve-text=\"grow\">30Hz</span>\n      </nve-gauge>\n      <nve-gauge size=\"md\" value=\"50\" aria-valuetext=\"12Hz\">\n        <span nve-text=\"grow\">12Hz</span>\n      </nve-gauge>\n      <nve-gauge size=\"lg\" value=\"50\" aria-valuetext=\"84%\">\n        <span nve-text=\"grow\">84%</span>\n      </nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Use for displaying real-time system usage and performance metrics.\n * @tags pattern\n */\nexport const Dynamic = {\n  render: () => html`\n<div nve-layout=\"row gap:sm\">\n  <nve-gauge id=\"dynamic-gpu-gauge\" status=\"success\" value=\"0\" aria-label=\"GPU\" aria-valuetext=\"0%\">\n    <span nve-text=\"grow\">0%</span>\n    <span nve-text=\"body sm muted\">GPU</span>\n  </nve-gauge>\n</div>\n<script type=\"module\">\n  const gauge = document.querySelector('#dynamic-gpu-gauge');\n  const valueElement = gauge.querySelector('span');\n  setInterval(() => {\n    const value = Math.floor(Math.random() * 101);\n    const text = value + '%';\n    gauge.value = value;\n    gauge.status = value >= 80 ? 'danger' : value >= 60 ? 'warning' : 'success';\n    gauge.setAttribute('aria-valuetext', text);\n    valueElement.textContent = text;\n  }, 1500);\n</script>\n`};\n\n/**\n * @summary Autonomous vehicle taxi gauges combine battery, perception, compute, and link status with realistic drift. Use for live dispatch views that need changing system health.\n * @tags test-case\n */\nexport const MultiGauge = {\n  render: () => html`\n<div nve-layout=\"row gap:sm\">\n  <nve-gauge id=\"av-taxi-battery-gauge\" status=\"success\" value=\"74\" aria-label=\"Battery\" aria-valuetext=\"74%\">\n    <span nve-text=\"grow\">74%</span>\n    <span nve-text=\"body sm muted\">BATTERY</span>\n  </nve-gauge>\n  <nve-gauge id=\"av-taxi-perception-gauge\" status=\"success\" value=\"96\" aria-label=\"Perception\" aria-valuetext=\"96%\">\n    <span nve-text=\"grow\">96%</span>\n    <span nve-text=\"body sm muted\">PERCEPTION</span>\n  </nve-gauge>\n  <nve-gauge id=\"av-taxi-compute-gauge\" status=\"success\" value=\"62\" aria-label=\"GPU\" aria-valuetext=\"62%\">\n    <span nve-text=\"grow\">62%</span>\n    <span nve-text=\"body sm muted\">GPU</span>\n  </nve-gauge>\n</div>\n<script type=\"module\">\n  const clamp = (value, min, max) => Math.min(Math.max(value, min), max);\n  const telemetry = {\n    battery: 74,\n    compute: 62,\n    perception: 96\n  };\n  const gauges = {\n    battery: document.querySelector('#av-taxi-battery-gauge'),\n    compute: document.querySelector('#av-taxi-compute-gauge'),\n    perception: document.querySelector('#av-taxi-perception-gauge')\n  };\n\n  const setGauge = (gauge, value, text, status) => {\n    gauge.value = Math.round(value);\n    gauge.status = status;\n    gauge.setAttribute('aria-valuetext', text);\n    gauge.querySelector('span').textContent = text;\n  };\n\n  setInterval(() => {\n    telemetry.battery = clamp(telemetry.battery - 0.08 + (Math.random() - 0.4) * 0.3, 46, 82);\n    telemetry.compute = clamp(telemetry.compute + (Math.random() - 0.48) * 7, 34, 91);\n    telemetry.perception = clamp(telemetry.perception + (Math.random() - 0.52) * 2.4, 88, 99);\n\n    const battery = Math.round(telemetry.battery);\n    const compute = Math.round(telemetry.compute);\n    const perception = Math.round(telemetry.perception);\n\n    setGauge(gauges.battery, battery, battery + '%', battery < 30 ? 'danger' : battery < 50 ? 'warning' : 'success');\n    setGauge(gauges.compute, compute, compute + '%', compute >= 85 ? 'danger' : compute >= 70 ? 'warning' : 'success');\n    setGauge(gauges.perception, perception, perception + '%', perception < 90 ? 'danger' : perception < 94 ? 'warning' : 'success');\n  }, 1600);\n</script>\n`};\n"],"mappings":";AAGA,IAAA,IAAS"}
+{"version":3,"file":"gauge.examples.js","names":[],"sources":["../../src/gauge/gauge.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html } from 'lit';\nimport '@nvidia-elements/core/gauge/define.js';\n\nexport default {\n  title: 'Elements/Gauge',\n  component: 'nve-gauge',\n};\n\n/**\n * @summary 270-degree gauges for displaying system resource usage.\n */\nexport const Default = {\n  render: () => html`\n    <nve-gauge status=\"accent\" value=\"66\">66%</nve-gauge>\n`};\n\n/**\n * @summary Shape variants compare the default 270-degree gauge with the compact half gauge for telemetry layouts with tighter vertical space.\n * @tags test-case\n */\nexport const Shape = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm align:vertical-center\">\n      <nve-gauge status=\"accent\" value=\"66\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" status=\"accent\" value=\"66\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Half shape variant for telemetry layouts with tighter vertical space.\n * @tags test-case\n */\nexport const ShapeHalf = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm align:vertical-center\">\n      <nve-gauge shape=\"half\" value=\"66\" size=\"sm\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" value=\"66\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" value=\"66\" size=\"lg\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Half shape with needle thumb variant for rapidly changing values in confined spaces.\n * @tags test-case\n */\nexport const ShapeHalfNeedle = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm align:vertical-center\">\n      <nve-gauge shape=\"half\" thumb=\"needle\" value=\"66\" size=\"sm\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" thumb=\"needle\" value=\"66\">66%</nve-gauge>\n      <nve-gauge shape=\"half\" thumb=\"needle\" value=\"66\" size=\"lg\">66%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Thumb variants compare filled, dot, and needle indicators for dashboards that need different levels of visual emphasis.\n * @tags test-case\n */\nexport const Thumb = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge thumb=\"fill\" value=\"66\">fill</nve-gauge>\n      <nve-gauge thumb=\"dot\" value=\"66\">dot</nve-gauge>\n      <nve-gauge thumb=\"needle\" value=\"66\">needle</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Gauges with values from 0% to 100% for displaying system resource usage.\n * @tags test-case\n */\nexport const Values = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge value=\"0\">0%</nve-gauge>\n      <nve-gauge value=\"33\">33%</nve-gauge>\n      <nve-gauge value=\"66\">66%</nve-gauge>\n      <nve-gauge value=\"100\">100%</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Gauges with custom max values for mission checkpoints, validation clips, and map tile processing.\n * @tags test-case\n */\nexport const Max = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge status=\"accent\" max=\"20\" value=\"5\">5/20</nve-gauge>\n      <nve-gauge max=\"20\" value=\"10\">10/20</nve-gauge>\n      <nve-gauge max=\"20\" value=\"15\">15/20</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Gauges with accent, success, warning, and danger colors for autonomous system health and readiness signals.\n * @tags test-case\n */\nexport const Status = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge value=\"50\">50%</nve-gauge>\n      <nve-gauge status=\"accent\" value=\"75\">75%</nve-gauge>\n      <nve-gauge status=\"success\" value=\"75\">75%</nve-gauge>\n      <nve-gauge status=\"warning\" value=\"75\" aria-valuetext=\"2.1m\">2.1m</nve-gauge>\n      <nve-gauge status=\"danger\" value=\"75\" aria-valuetext=\"0Hz\">0Hz</nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Use gradient colors for gauges with scaled non-segmented values such as temperature and bandwidth.\n * @tags pattern\n */\nexport const Gradient = {\n  render: () => html`\n    <style>\n      nve-gauge#gauge-temperature-example {\n        --background: conic-gradient(\n          from 225deg at 50% 50%,\n          var(--nve-sys-support-success-emphasis-color) 0deg 18deg,\n          var(--nve-sys-support-warning-emphasis-color) 135deg,\n          var(--nve-sys-support-danger-emphasis-color) 252deg 300deg,\n          var(--nve-sys-support-success-emphasis-color) 300deg 360deg\n        );\n      }\n\n      nve-gauge#gauge-mbps-example {\n        --background: conic-gradient(\n          from 225deg at 50% 50%,\n          var(--nve-sys-support-danger-emphasis-color) 0deg 18deg,\n          var(--nve-sys-support-warning-emphasis-color) 135deg,\n          var(--nve-sys-support-success-emphasis-color) 252deg 300deg,\n          var(--nve-sys-support-danger-emphasis-color) 300deg 360deg\n        );\n      }\n    </style>\n\n    <div nve-layout=\"row gap:md\">\n      <nve-gauge thumb=\"dot\" value=\"82\" id=\"gauge-temperature-example\" aria-label=\"Temperature\" aria-valuetext=\"82°C\">\n        <span>82&deg;C</span>\n        <span nve-text=\"body sm muted\">TEMP</span>\n      </nve-gauge>\n\n      <nve-gauge thumb=\"needle\" value=\"98\" id=\"gauge-mbps-example\" aria-label=\"Download\" aria-valuetext=\"980Mbps\">\n        <span nve-text=\"body sm\">980Mbps</span>\n        <span nve-text=\"body sm muted\">Download</span>\n      </nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Small gauge paired with route-solve text for compact autonomous vehicle task rows.\n * @tags test-case\n */\nexport const WithText = {\n  render: () => html`\n    <div nve-layout=\"row gap:xs align:vertical-center\" nve-text=\"medium\">\n      <nve-gauge status=\"accent\" size=\"sm\" value=\"50\" aria-labelledby=\"route-solve-label\" aria-valuetext=\"2.4s\">2.4s</nve-gauge>\n      <span id=\"route-solve-label\">Route solve</span>\n    </div>\n`};\n\n/**\n * @summary Gauges in small, medium, and large sizes for dense robotics and autonomous vehicle dashboards.\n * @tags test-case\n */\nexport const Size = {\n  render: () => html`\n    <div nve-layout=\"row gap:sm\">\n      <nve-gauge size=\"sm\" value=\"50\" aria-valuetext=\"30Hz\">\n        <span nve-text=\"grow\">30Hz</span>\n      </nve-gauge>\n      <nve-gauge size=\"md\" value=\"50\" aria-valuetext=\"12Hz\">\n        <span nve-text=\"grow\">12Hz</span>\n      </nve-gauge>\n      <nve-gauge size=\"lg\" value=\"50\" aria-valuetext=\"84%\">\n        <span nve-text=\"grow\">84%</span>\n      </nve-gauge>\n    </div>\n`};\n\n/**\n * @summary Use for displaying real-time system usage and performance metrics.\n * @tags pattern\n */\nexport const Dynamic = {\n  render: () => html`\n<div nve-layout=\"row gap:sm\">\n  <nve-gauge id=\"dynamic-gpu-gauge\" status=\"success\" value=\"0\" aria-label=\"GPU\" aria-valuetext=\"0%\">\n    <span nve-text=\"grow\">0%</span>\n    <span nve-text=\"body sm muted\">GPU</span>\n  </nve-gauge>\n</div>\n<script type=\"module\">\n  const gauge = document.querySelector('#dynamic-gpu-gauge');\n  const valueElement = gauge.querySelector('span');\n  setInterval(() => {\n    const value = Math.floor(Math.random() * 101);\n    const text = value + '%';\n    gauge.value = value;\n    gauge.status = value >= 80 ? 'danger' : value >= 60 ? 'warning' : 'success';\n    gauge.setAttribute('aria-valuetext', text);\n    valueElement.textContent = text;\n  }, 1500);\n</script>\n`};\n\n/**\n * @summary Autonomous vehicle taxi gauges combine battery, perception, compute, and link status with realistic drift. Use for live dispatch views that need changing system health.\n * @tags test-case\n */\nexport const MultiGauge = {\n  render: () => html`\n<div nve-layout=\"row gap:sm\">\n  <nve-gauge id=\"av-taxi-battery-gauge\" status=\"success\" value=\"74\" aria-label=\"Battery\" aria-valuetext=\"74%\">\n    <span nve-text=\"grow\">74%</span>\n    <span nve-text=\"body sm muted\">BATTERY</span>\n  </nve-gauge>\n  <nve-gauge id=\"av-taxi-perception-gauge\" status=\"success\" value=\"96\" aria-label=\"Perception\" aria-valuetext=\"96%\">\n    <span nve-text=\"grow\">96%</span>\n    <span nve-text=\"body sm muted\">PERCEPTION</span>\n  </nve-gauge>\n  <nve-gauge id=\"av-taxi-compute-gauge\" status=\"success\" value=\"62\" aria-label=\"GPU\" aria-valuetext=\"62%\">\n    <span nve-text=\"grow\">62%</span>\n    <span nve-text=\"body sm muted\">GPU</span>\n  </nve-gauge>\n</div>\n<script type=\"module\">\n  const clamp = (value, min, max) => Math.min(Math.max(value, min), max);\n  const telemetry = {\n    battery: 74,\n    compute: 62,\n    perception: 96\n  };\n  const gauges = {\n    battery: document.querySelector('#av-taxi-battery-gauge'),\n    compute: document.querySelector('#av-taxi-compute-gauge'),\n    perception: document.querySelector('#av-taxi-perception-gauge')\n  };\n\n  const setGauge = (gauge, value, text, status) => {\n    gauge.value = Math.round(value);\n    gauge.status = status;\n    gauge.setAttribute('aria-valuetext', text);\n    gauge.querySelector('span').textContent = text;\n  };\n\n  setInterval(() => {\n    telemetry.battery = clamp(telemetry.battery - 0.08 + (Math.random() - 0.4) * 0.3, 46, 82);\n    telemetry.compute = clamp(telemetry.compute + (Math.random() - 0.48) * 7, 34, 91);\n    telemetry.perception = clamp(telemetry.perception + (Math.random() - 0.52) * 2.4, 88, 99);\n\n    const battery = Math.round(telemetry.battery);\n    const compute = Math.round(telemetry.compute);\n    const perception = Math.round(telemetry.perception);\n\n    setGauge(gauges.battery, battery, battery + '%', battery < 30 ? 'danger' : battery < 50 ? 'warning' : 'success');\n    setGauge(gauges.compute, compute, compute + '%', compute >= 85 ? 'danger' : compute >= 70 ? 'warning' : 'success');\n    setGauge(gauges.perception, perception, perception + '%', perception < 90 ? 'danger' : perception < 94 ? 'warning' : 'success');\n  }, 1600);\n</script>\n`};\n"],"mappings":";AAGA,IAAA,IAAS"}

package/dist/gauge/gauge.examples.json

@@ -5,7 +5,7 @@
     {
       "id": "gauge",
       "name": "Default",
-      "template": "<div nve-layout=\"row gap:sm\">\n  <nve-gauge value=\"50\">50%</nve-gauge>\n  <nve-gauge status=\"accent\" value=\"66\">66%</nve-gauge>\n</div>\n",
+      "template": "<nve-gauge status=\"accent\" value=\"66\">66%</nve-gauge>\n",
       "summary": "270-degree gauges for displaying system resource usage.",
       "description": "",
       "composition": false,

package/dist/gauge/gauge2.js

@@ -52,7 +52,7 @@ var l = 200, u = 100 / 110.93, d = {
 	static {
 		this.metadata = {
 			tag: "nve-gauge",
-			version: "2.2.3"
+			version: "2.3.0"
 		};
 	}
 	#e;

package/dist/grid/cell/cell2.js

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

package/dist/grid/column/column2.js

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

package/dist/grid/footer/footer2.js

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

package/dist/grid/grid2.js

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

package/dist/grid/header/header2.js

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

package/dist/grid/placeholder/placeholder2.js

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

package/dist/grid/row/row2.js

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

package/dist/icon/icon2.js

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

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

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

package/dist/index.js

@@ -2,7 +2,7 @@ import { I18nService as e } from "./internal/services/i18n.service.js";
 import { getThemeTokens as t } from "./internal/utils/dom.js";
 import { statusIcons as n } from "./internal/types/index.js";
 //#region src/index.ts
-var r = "2.2.3", i = "@nvidia-elements";
+var r = "2.3.0", i = "@nvidia-elements";
 //#endregion
 export { e as I18nService, i as SCOPE, r as VERSION, t as getThemeTokens, n as statusIcons };
 

package/dist/input/input-group2.js

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