@nvidia-elements/core 2.4.1 → 2.5.0

package/dist/format-truncate/format-truncate2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-truncate2.js","names":["#observeAvailableWidth","#resizeObserver","#slottedText","#renderText","#onSlotChange","#createTextMeasurer","#availableWidth","#textMeasurementContext","#measureText","#measurementContext"],"sources":["../../src/format-truncate/format-truncate.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { TemplateResult } from 'lit';\nimport { html, LitElement } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport { attachInternals, useStyles, typeSSR } from '@nvidia-elements/core/internal';\nimport { normalizeTruncateString, normalizeTruncateText, truncateText } from './utils.js';\nimport styles from './format-truncate.css?inline';\n\n/**\n * @element nve-format-truncate\n * @description Truncates text at its start, center, or end while preserving the full text for assistive technology.\n * @documentation https://nvidia.github.io/elements/docs/elements/format-truncate/\n * @since 0.0.0\n * @entrypoint \\@nvidia-elements/core/format-truncate\n * @slot - Text to truncate. The component flattens, trims, and normalizes mixed text and element nodes.\n * @beta\n */\n@typeSSR()\nexport class FormatTruncate extends LitElement {\n  static styles = useStyles([styles]);\n\n  static readonly metadata = {\n    tag: 'nve-format-truncate',\n    version: '0.0.0'\n  };\n\n  /**\n   * Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges.\n   */\n  @property({ type: String, reflect: true }) position: 'start' | 'center' | 'end' = 'start';\n\n  /**\n   * Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments.\n   */\n  @property({ type: String, reflect: true }) strategy: 'character' | 'word' | 'path' = 'character';\n\n  /**\n   * Edge favored by center truncation. The favored edge keeps at least the configured number of units.\n   */\n  @property({ type: String, reflect: true }) bias: 'start' | 'end' = 'end';\n\n  /**\n   * Number of strategy units retained at the biased edge during center truncation.\n   */\n  @property({ type: Number, reflect: true }) preserve = 6;\n\n  /** @private */\n  declare _internals: ElementInternals;\n\n  #measurementContext?: CanvasRenderingContext2D | null;\n  #resizeObserver?: ResizeObserver;\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    attachInternals(this);\n    this.#observeAvailableWidth();\n    this.requestUpdate();\n  }\n\n  override disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this.#resizeObserver?.disconnect();\n  }\n\n  connectedMoveCallback(): void {\n    this.#observeAvailableWidth();\n    this.requestUpdate();\n  }\n\n  override render(): TemplateResult {\n    const text = this.#slottedText;\n    const truncatedText = this.#renderText(text);\n\n    if (truncatedText !== text) this.title = text;\n    else this.removeAttribute('title');\n\n    return html`<span internal-host aria-hidden=\"true\">${truncatedText}</span><span sizing-host aria-hidden=\"true\">${text}</span><slot @slotchange=${this.#onSlotChange}></slot>`;\n  }\n\n  get #slottedText(): string {\n    const slot = this.shadowRoot?.querySelector<HTMLSlotElement>('slot:not([name])');\n    if (slot) return normalizeTruncateText(slot.assignedNodes({ flatten: true }));\n\n    const nodes = Array.from(this.childNodes ?? []).filter(isDefaultSlotNode);\n    return nodes.length ? normalizeTruncateText(nodes) : normalizeTruncateString(this.textContent ?? '');\n  }\n\n  #renderText(text: string): string {\n    const measureText = this.#createTextMeasurer();\n\n    return truncateText(text, {\n      position: this.position,\n      strategy: this.strategy,\n      bias: this.bias,\n      preserve: this.preserve,\n      availableWidth: this.#availableWidth,\n      measureText\n    });\n  }\n\n  get #availableWidth(): number {\n    const view = this.ownerDocument?.defaultView;\n    if (!view || !this.shadowRoot?.querySelector('[internal-host]')) return Number.POSITIVE_INFINITY;\n\n    return getContentWidth(this, view);\n  }\n\n  #createTextMeasurer(): (text: string) => number {\n    const view = this.ownerDocument?.defaultView;\n    const context = this.#textMeasurementContext;\n    if (!view || !context) return () => 0;\n\n    const computedStyles = view.getComputedStyle(this);\n    context.font = computedStyles.font;\n\n    const letterSpacing = cssPixelValue(computedStyles.letterSpacing);\n    const wordSpacing = cssPixelValue(computedStyles.wordSpacing);\n    const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });\n\n    return text => this.#measureText(text, { context, letterSpacing, wordSpacing, graphemeSegmenter });\n  }\n\n  #measureText(\n    text: string,\n    {\n      context,\n      letterSpacing,\n      wordSpacing,\n      graphemeSegmenter\n    }: {\n      context: CanvasRenderingContext2D;\n      letterSpacing: number;\n      wordSpacing: number;\n      graphemeSegmenter: Intl.Segmenter;\n    }\n  ): number {\n    const graphemeSegments = graphemeSegmenter.segment(text);\n    const whitespaceCount = Array.from(text.matchAll(/\\s/gu)).length;\n\n    return (\n      context.measureText(text).width +\n      Math.max(0, Array.from(graphemeSegments).length - 1) * letterSpacing +\n      whitespaceCount * wordSpacing\n    );\n  }\n\n  get #textMeasurementContext(): CanvasRenderingContext2D | null {\n    if (this.#measurementContext === undefined) {\n      this.#measurementContext = this.ownerDocument?.createElement('canvas').getContext('2d') ?? null;\n    }\n\n    return this.#measurementContext;\n  }\n\n  #observeAvailableWidth(): void {\n    if (typeof ResizeObserver === 'undefined') return;\n\n    this.#resizeObserver ??= new ResizeObserver(() => {\n      if (this.isConnected) this.requestUpdate();\n    });\n    this.#resizeObserver.disconnect();\n    this.#resizeObserver.observe(this);\n  }\n\n  #onSlotChange = (): void => {\n    this.requestUpdate();\n  };\n}\n\nfunction getContentWidth(element: HTMLElement, view: Window): number {\n  const computedStyles = view.getComputedStyle(element);\n  return Math.max(\n    0,\n    element.getBoundingClientRect().width -\n      cssPixelValue(computedStyles.borderInlineStartWidth) -\n      cssPixelValue(computedStyles.borderInlineEndWidth) -\n      cssPixelValue(computedStyles.paddingInlineStart) -\n      cssPixelValue(computedStyles.paddingInlineEnd)\n  );\n}\n\nfunction cssPixelValue(value: string): number {\n  const parsed = Number.parseFloat(value);\n  return Number.isFinite(parsed) ? parsed : 0;\n}\n\nfunction isDefaultSlotNode(node: Node): boolean {\n  return !isElementNode(node) || !node.getAttribute('slot');\n}\n\nfunction isElementNode(node: Node): node is Element {\n  return node.nodeType === 1;\n}\n"],"mappings":"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"}

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

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

package/dist/format-truncate/index.js

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

package/dist/format-truncate/utils.d.ts

@@ -0,0 +1,14 @@
+type TruncatePosition = 'start' | 'center' | 'end';
+type TruncateStrategy = 'character' | 'word' | 'path';
+type TruncateBias = 'start' | 'end';
+export declare function normalizeTruncateText(nodes: Iterable<Node>): string;
+export declare function normalizeTruncateString(text: string): string;
+export declare function truncateText(text: string, { position, strategy, bias, preserve, availableWidth, measureText }: {
+    position: TruncatePosition;
+    strategy: TruncateStrategy;
+    bias: TruncateBias;
+    preserve: number;
+    availableWidth: number;
+    measureText: (value: string) => number;
+}): string;
+export {};

package/dist/format-truncate/utils.js

@@ -0,0 +1,114 @@
+function e(e) {
+	return t(Array.from(e, (e) => e.textContent ?? "").join(" "));
+}
+function t(e) {
+	return e.replace(/\s+/gu, " ").trim();
+}
+function n(e, { position: t, strategy: n, bias: o, preserve: s, availableWidth: c, measureText: u }) {
+	if (!e || !Number.isFinite(c)) return e;
+	if (c <= 0) return "";
+	if (u(e) <= c) return e;
+	if (u("…") > c) return "…";
+	switch (t) {
+		case "start": return i(l(e, "grapheme"), c, u);
+		case "center": return r(e, {
+			strategy: n,
+			bias: o,
+			preserve: s,
+			availableWidth: c,
+			measureText: u
+		});
+		default: return a(l(e, "grapheme"), c, u);
+	}
+}
+function r(e, { strategy: t, bias: n, preserve: r, availableWidth: l, measureText: u }) {
+	let d = h(e, t, n), f = Math.min(d.length, c(r));
+	if (n === "start") {
+		let e = d.slice(0, f), t = d.slice(f), n = (n) => s(e.join(""), t.slice(-n || t.length).join(""));
+		return u(n(0)) > l ? a(e, l, u) : n(o(t.length, n, {
+			availableWidth: l,
+			measureText: u
+		}));
+	}
+	let p = d.slice(0, d.length - f), m = d.slice(d.length - f), g = (e) => s(p.slice(0, e).join(""), m.join(""));
+	return u(g(0)) > l ? i(m, l, u) : g(o(p.length, g, {
+		availableWidth: l,
+		measureText: u
+	}));
+}
+function i(e, t, n) {
+	let r = (t) => `…${e.slice(-t || e.length).join("")}`;
+	return r(o(e.length - 1, r, {
+		availableWidth: t,
+		measureText: n
+	}));
+}
+function a(e, t, n) {
+	let r = (t) => `${e.slice(0, t).join("")}…`;
+	return r(o(e.length - 1, r, {
+		availableWidth: t,
+		measureText: n
+	}));
+}
+function o(e, t, { availableWidth: n, measureText: r }) {
+	let i = 0, a = e, o = 0;
+	for (; i <= a;) {
+		let e = Math.floor((i + a) / 2);
+		r(t(e)) <= n ? (o = e, i = e + 1) : a = e - 1;
+	}
+	return o;
+}
+function s(e, t) {
+	return `${e.trimEnd()}…${t.trimStart()}`;
+}
+function c(e) {
+	return Number.isFinite(e) ? Math.max(1, Math.floor(e)) : 1;
+}
+function l(e, t) {
+	let n = new Intl.Segmenter(void 0, { granularity: t }).segment(e);
+	return Array.from(n, (e) => e.segment);
+}
+function u(e, t) {
+	return t === "start" ? d(e) : f(e);
+}
+function d(e) {
+	let t = [];
+	for (let n of e) n.trim() ? t.push(n) : p(t, n);
+	return t;
+}
+function f(e) {
+	let t = [], n = "";
+	for (let r of e) r.trim() ? (t.push(n + r), n = "") : n += r;
+	return p(t, n), t;
+}
+function p(e, t) {
+	let n = e.at(-1);
+	n !== void 0 && (e[e.length - 1] = n + t);
+}
+function m(e, t) {
+	let n = Array.from(e.matchAll(/[^/\\]+/gu));
+	return n.length === 0 ? [e] : t === "start" ? n.map((t, r) => {
+		let i = r === 0 ? 0 : t.index, a = n[r + 1]?.index ?? e.length;
+		return e.slice(i, a);
+	}) : n.map((t, r) => {
+		let i = n[r - 1], a = i ? i.index + i[0].length : 0, o = r === n.length - 1 ? e.length : t.index + t[0].length;
+		return e.slice(a, o);
+	});
+}
+function h(e, t, n) {
+	switch (t) {
+		case "word": {
+			let t = u(l(e, "word"), n);
+			return t.length ? t : [e];
+		}
+		case "path": {
+			let t = m(e, n);
+			return t.length ? t : [e];
+		}
+		default: return l(e, "grapheme");
+	}
+}
+//#endregion
+export { t as normalizeTruncateString, e as normalizeTruncateText, n as truncateText };
+
+//# sourceMappingURL=utils.js.map

package/dist/format-truncate/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/format-truncate/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nconst ELLIPSIS = '…';\n\ntype TruncatePosition = 'start' | 'center' | 'end';\ntype TruncateStrategy = 'character' | 'word' | 'path';\ntype TruncateBias = 'start' | 'end';\n\nexport function normalizeTruncateText(nodes: Iterable<Node>): string {\n  return normalizeTruncateString(Array.from(nodes, node => node.textContent ?? '').join(' '));\n}\n\nexport function normalizeTruncateString(text: string): string {\n  return text.replace(/\\s+/gu, ' ').trim();\n}\n\nexport function truncateText(\n  text: string,\n  {\n    position,\n    strategy,\n    bias,\n    preserve,\n    availableWidth,\n    measureText\n  }: {\n    position: TruncatePosition;\n    strategy: TruncateStrategy;\n    bias: TruncateBias;\n    preserve: number;\n    availableWidth: number;\n    measureText: (value: string) => number;\n  }\n): string {\n  if (!text || !Number.isFinite(availableWidth)) return text;\n  if (availableWidth <= 0) return '';\n  if (measureText(text) <= availableWidth) return text;\n  if (measureText(ELLIPSIS) > availableWidth) return ELLIPSIS;\n\n  switch (position) {\n    case 'start':\n      return truncateStart(segmentText(text, 'grapheme'), availableWidth, measureText);\n    case 'center':\n      return truncateMiddle(text, { strategy, bias, preserve, availableWidth, measureText });\n    case 'end':\n    default:\n      return truncateEnd(segmentText(text, 'grapheme'), availableWidth, measureText);\n  }\n}\n\nfunction truncateMiddle(\n  text: string,\n  {\n    strategy,\n    bias,\n    preserve,\n    availableWidth,\n    measureText\n  }: {\n    strategy: TruncateStrategy;\n    bias: TruncateBias;\n    preserve: number;\n    availableWidth: number;\n    measureText: (value: string) => number;\n  }\n): string {\n  const units = getUnits(text, strategy, bias);\n  const preserveCount = Math.min(units.length, normalizePreserve(preserve));\n\n  if (bias === 'start') {\n    const preservedUnits = units.slice(0, preserveCount);\n    const truncatableUnits = units.slice(preserveCount);\n    const candidate = (count: number) =>\n      joinWithEllipsis(preservedUnits.join(''), truncatableUnits.slice(-count || truncatableUnits.length).join(''));\n\n    if (measureText(candidate(0)) > availableWidth) {\n      return truncateEnd(preservedUnits, availableWidth, measureText);\n    }\n\n    return candidate(findLargestFittingCount(truncatableUnits.length, candidate, { availableWidth, measureText }));\n  }\n\n  const truncatableUnits = units.slice(0, units.length - preserveCount);\n  const preservedUnits = units.slice(units.length - preserveCount);\n  const candidate = (count: number) =>\n    joinWithEllipsis(truncatableUnits.slice(0, count).join(''), preservedUnits.join(''));\n\n  if (measureText(candidate(0)) > availableWidth) {\n    return truncateStart(preservedUnits, availableWidth, measureText);\n  }\n\n  return candidate(findLargestFittingCount(truncatableUnits.length, candidate, { availableWidth, measureText }));\n}\n\nfunction truncateStart(units: string[], availableWidth: number, measureText: (value: string) => number): string {\n  const candidate = (count: number) => `${ELLIPSIS}${units.slice(-count || units.length).join('')}`;\n  return candidate(findLargestFittingCount(units.length - 1, candidate, { availableWidth, measureText }));\n}\n\nfunction truncateEnd(units: string[], availableWidth: number, measureText: (value: string) => number): string {\n  const candidate = (count: number) => `${units.slice(0, count).join('')}${ELLIPSIS}`;\n  return candidate(findLargestFittingCount(units.length - 1, candidate, { availableWidth, measureText }));\n}\n\nfunction findLargestFittingCount(\n  maximum: number,\n  candidate: (count: number) => string,\n  {\n    availableWidth,\n    measureText\n  }: {\n    availableWidth: number;\n    measureText: (value: string) => number;\n  }\n): number {\n  let lower = 0;\n  let upper = maximum;\n  let fitting = 0;\n\n  while (lower <= upper) {\n    const count = Math.floor((lower + upper) / 2);\n\n    if (measureText(candidate(count)) <= availableWidth) {\n      fitting = count;\n      lower = count + 1;\n    } else {\n      upper = count - 1;\n    }\n  }\n\n  return fitting;\n}\n\nfunction joinWithEllipsis(start: string, end: string): string {\n  return `${start.trimEnd()}${ELLIPSIS}${end.trimStart()}`;\n}\n\nfunction normalizePreserve(value: number): number {\n  return Number.isFinite(value) ? Math.max(1, Math.floor(value)) : 1;\n}\n\nfunction segmentText(text: string, granularity: 'grapheme' | 'word'): string[] {\n  const segments = new Intl.Segmenter(undefined, { granularity }).segment(text);\n  return Array.from(segments, segment => segment.segment);\n}\n\nfunction mergeWhitespace(segments: string[], bias: TruncateBias): string[] {\n  return bias === 'start' ? mergeFollowingWhitespace(segments) : mergePrecedingWhitespace(segments);\n}\n\nfunction mergeFollowingWhitespace(segments: string[]): string[] {\n  const units: string[] = [];\n\n  for (const segment of segments) {\n    if (segment.trim()) units.push(segment);\n    else appendToLastUnit(units, segment);\n  }\n\n  return units;\n}\n\nfunction mergePrecedingWhitespace(segments: string[]): string[] {\n  const units: string[] = [];\n  let whitespace = '';\n\n  for (const segment of segments) {\n    if (segment.trim()) {\n      units.push(whitespace + segment);\n      whitespace = '';\n    } else {\n      whitespace += segment;\n    }\n  }\n\n  appendToLastUnit(units, whitespace);\n\n  return units;\n}\n\nfunction appendToLastUnit(units: string[], text: string): void {\n  const previous = units.at(-1);\n  if (previous !== undefined) units[units.length - 1] = previous + text;\n}\n\nfunction splitPathUnits(text: string, bias: TruncateBias): string[] {\n  const pathSegments = Array.from(text.matchAll(/[^/\\\\]+/gu));\n  if (pathSegments.length === 0) return [text];\n\n  if (bias === 'start') {\n    return pathSegments.map((segment, index) => {\n      const start = index === 0 ? 0 : segment.index;\n      const end = pathSegments[index + 1]?.index ?? text.length;\n      return text.slice(start, end);\n    });\n  }\n\n  return pathSegments.map((segment, index) => {\n    const previous = pathSegments[index - 1];\n    const start = previous ? previous.index + previous[0].length : 0;\n    const end = index === pathSegments.length - 1 ? text.length : segment.index + segment[0].length;\n    return text.slice(start, end);\n  });\n}\n\nfunction getUnits(text: string, strategy: TruncateStrategy, bias: TruncateBias): string[] {\n  switch (strategy) {\n    case 'word': {\n      const units = mergeWhitespace(segmentText(text, 'word'), bias);\n      return units.length ? units : [text];\n    }\n    case 'path': {\n      const units = splitPathUnits(text, bias);\n      return units.length ? units : [text];\n    }\n    case 'character':\n    default:\n      return segmentText(text, 'grapheme');\n  }\n}\n"],"mappings":"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"}

package/dist/forms/control/control2.js

@@ -48,7 +48,7 @@ var C = class extends v {
 	static {
 		this.metadata = {
 			tag: "nve-control",
-			version: "2.4.1"
+			version: "2.5.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.4.1"
+			version: "2.5.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.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

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.4.1"
+			version: "2.5.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.4.1"
+			version: "2.5.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.4.1"
+			version: "2.5.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.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/grid/grid2.js

@@ -23,7 +23,7 @@ var y = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-grid",
-			version: "2.4.1",
+			version: "2.5.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.4.1",
+			version: "2.5.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.4.1"
+			version: "2.5.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.4.1",
+			version: "2.5.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.4.1"
+			version: "2.5.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.4.1");
+		let n = e(t.metadata.version), i = e("2.5.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.4.1"
+			version: "2.5.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.4.1", i = "@nvidia-elements";
+var r = "2.5.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.4.1"
+			version: "2.5.0"
 		};
 	}
 	async connectedCallback() {

package/dist/input/input2.js

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

package/dist/internal/services/global.service.js

@@ -19,7 +19,7 @@ var a = class {
 				i18nRegistry: {},
 				audit: {}
 			}
-		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(/* @__PURE__ */ new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.4.1"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.4.1"] = i(), globalThis.NVE_ELEMENTS.state.versions.length > 1 && globalThis.NVE_ELEMENTS.state.env !== "production" && console.warn(e(), `\n\n${JSON.stringify(globalThis.NVE_ELEMENTS.state.versions, null, 2)}`);
+		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(/* @__PURE__ */ new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.5.0"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.5.0"] = i(), globalThis.NVE_ELEMENTS.state.versions.length > 1 && globalThis.NVE_ELEMENTS.state.env !== "production" && console.warn(e(), `\n\n${JSON.stringify(globalThis.NVE_ELEMENTS.state.versions, null, 2)}`);
 	}
 	get state() {
 		return globalThis.NVE_ELEMENTS.state;

package/dist/logo/logo2.js

@@ -12,7 +12,7 @@ var c = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-logo",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/menu/menu-item2.js

@@ -13,7 +13,7 @@ var c = class extends s(i) {
 	static {
 		this.metadata = {
 			tag: "nve-menu-item",
-			version: "2.4.1",
+			version: "2.5.0",
 			parents: ["nve-menu"]
 		};
 	}

package/dist/menu/menu2.js

@@ -16,7 +16,7 @@ var d = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-menu",
-			version: "2.4.1",
+			version: "2.5.0",
 			children: ["nve-menu-item", "nve-divider"]
 		};
 	}

package/dist/month/month2.js

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

package/dist/notification/notification-group2.js

@@ -20,7 +20,7 @@ var l = class extends o {
 	static {
 		this.metadata = {
 			tag: "nve-notification-group",
-			version: "2.4.1",
+			version: "2.5.0",
 			children: ["nve-notification"]
 		};
 	}

package/dist/notification/notification2.js

@@ -34,7 +34,7 @@ var m = class extends d {
 	static {
 		this.metadata = {
 			tag: "nve-notification",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/page/page-panel/page-panel-content2.js

@@ -9,7 +9,7 @@ var i = class extends n {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel-content",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/page/page-panel/page-panel-footer2.js

@@ -14,7 +14,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel-footer",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/page/page-panel/page-panel-header2.js

@@ -14,7 +14,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel-header",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/page/page-panel/page-panel2.js

@@ -18,7 +18,7 @@ var f = class extends l {
 	static {
 		this.metadata = {
 			tag: "nve-page-panel",
-			version: "2.4.1",
+			version: "2.5.0",
 			parents: ["nve-page"]
 		};
 	}

package/dist/page/page2.js

@@ -16,7 +16,7 @@ var c = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-page",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/page-header/page-header2.js

@@ -12,7 +12,7 @@ var s = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-page-header",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/page-loader/page-loader2.js

@@ -18,7 +18,7 @@ var u = class extends s {
 	static {
 		this.metadata = {
 			tag: "nve-page-loader",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/pagination/pagination2.js

@@ -21,7 +21,7 @@ var g = class extends h(d) {
 	static {
 		this.metadata = {
 			tag: "nve-pagination",
-			version: "2.4.1",
+			version: "2.5.0",
 			valueSchema: { type: "number" }
 		};
 	}

package/dist/panel/panel2.js

@@ -21,7 +21,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel-header",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {
@@ -37,7 +37,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel-content",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {
@@ -50,7 +50,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel-footer",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {
@@ -69,7 +69,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-panel",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/password/password2.js

@@ -23,7 +23,7 @@ var u = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-password",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/preferences-input/preferences-input2.js

@@ -43,7 +43,7 @@ var x = class extends g(d) {
 	static {
 		this.metadata = {
 			tag: "nve-preferences-input",
-			version: "2.4.1",
+			version: "2.5.0",
 			valueSchema: {
 				type: "object",
 				properties: {

package/dist/progress-bar/progress-bar2.js

@@ -16,7 +16,7 @@ var c = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-progress-bar",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/progress-ring/progress-ring2.js

@@ -19,7 +19,7 @@ var d = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-progress-ring",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/progressive-filter-chip/progressive-filter-chip2.js

@@ -23,7 +23,7 @@ var b = class extends h {
 	static {
 		this.metadata = {
 			tag: "nve-progressive-filter-chip",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/pulse/pulse2.js

@@ -13,7 +13,7 @@ var c = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-pulse",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/radio/radio-group2.js

@@ -12,7 +12,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-radio-group",
-			version: "2.4.1",
+			version: "2.5.0",
 			children: [
 				"label",
 				"nve-control-message",

package/dist/radio/radio2.js

@@ -15,7 +15,7 @@ var o = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-radio",
-			version: "2.4.1",
+			version: "2.5.0",
 			children: [
 				"label",
 				"input",

package/dist/range/range2.js

@@ -17,7 +17,7 @@ var d = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-range",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	connectedCallback() {