@nvidia-elements/core 2.4.1 → 2.5.0

package/dist/button/button2.js

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

package/dist/button-group/button-group2.js

@@ -26,7 +26,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-button-group",
-			version: "2.4.1",
+			version: "2.5.0",
 			children: [
 				"nve-button",
 				"nve-icon-button",

package/dist/card/card2.js

@@ -16,7 +16,7 @@ var d = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-card",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {
@@ -37,7 +37,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-card-header",
-			version: "2.4.1",
+			version: "2.5.0",
 			parents: ["nve-card"]
 		};
 	}
@@ -53,7 +53,7 @@ var p = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-card-content",
-			version: "2.4.1",
+			version: "2.5.0",
 			parents: ["nve-card"]
 		};
 	}
@@ -72,7 +72,7 @@ var m = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-card-footer",
-			version: "2.4.1",
+			version: "2.5.0",
 			parents: ["nve-card"]
 		};
 	}

package/dist/chat-message/chat-message2.js

@@ -13,7 +13,7 @@ var l = class extends o {
 	static {
 		this.metadata = {
 			tag: "nve-chat-message",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	render() {

package/dist/checkbox/checkbox-group2.js

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

package/dist/checkbox/checkbox2.js

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

package/dist/color/color2.js

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

package/dist/combobox/combobox2.js

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

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

@@ -32,7 +32,7 @@ var p = class extends a {
 	static {
 		this.metadata = {
 			tag: "nve-copy-button",
-			version: "2.4.1"
+			version: "2.5.0"
 		};
 	}
 	static {

package/dist/custom-elements-jsx.d.ts

@@ -1246,6 +1246,17 @@ When both are present, this property takes precedence. */
   sync?: boolean;
 };
 
+export type FormatTruncateProps = {
+  /** Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges. */
+  position?: "start" | "center" | "end";
+  /** Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments. */
+  strategy?: "character" | "word" | "path";
+  /** Edge favored by center truncation. The favored edge keeps at least the configured number of units. */
+  bias?: "start" | "end";
+  /** Number of strategy units retained at the biased edge during center truncation. */
+  preserve?: number;
+};
+
 export type ControlGroupProps = {
   /** Controls the directional arrangement and spacing behavior of the element's content.
 - `vertical` Arranges content in a vertical stack with block-level spacing.
@@ -4993,6 +5004,16 @@ export type CustomElements = {
    */
   "nve-format-relative-time": Partial<FormatRelativeTimeProps & BaseProps & BaseEvents>;
 
+  /**
+   * Truncates text at its start, center, or end while preserving the full text for assistive technology.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - Text to truncate. The component flattens, trims, and normalizes mixed text and element nodes.
+   */
+  "nve-format-truncate": Partial<FormatTruncateProps & BaseProps & BaseEvents>;
+
   /**
    * Groups many related form controls under a shared label and validation context for semantically linked inputs.
    * ---

package/dist/custom-elements-vue.d.ts

@@ -1122,6 +1122,17 @@ When both are present, this property takes precedence. */
   sync?: boolean;
 };
 
+type FormatTruncateProps = {
+  /** Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges. */
+  position?: "start" | "center" | "end";
+  /** Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments. */
+  strategy?: "character" | "word" | "path";
+  /** Edge favored by center truncation. The favored edge keeps at least the configured number of units. */
+  bias?: "start" | "end";
+  /** Number of strategy units retained at the biased edge during center truncation. */
+  preserve?: number;
+};
+
 type ControlGroupProps = {
   /** Controls the directional arrangement and spacing behavior of the element's content.
 - `vertical` Arranges content in a vertical stack with block-level spacing.
@@ -4751,6 +4762,16 @@ export type CustomElements = {
    */
   "nve-format-relative-time": DefineComponent<FormatRelativeTimeProps>;
 
+  /**
+   * Truncates text at its start, center, or end while preserving the full text for assistive technology.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - Text to truncate. The component flattens, trims, and normalizes mixed text and element nodes.
+   */
+  "nve-format-truncate": DefineComponent<FormatTruncateProps>;
+
   /**
    * Groups many related form controls under a shared label and validation context for semantically linked inputs.
    * ---

package/dist/custom-elements.json

@@ -2726,6 +2726,14 @@
             "package": "@nvidia-elements/core/format-relative-time"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "@nvidia-elements/core/format-truncate"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -15331,6 +15339,360 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "/src/format-truncate/define.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/format-truncate/format-truncate.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Truncates text at its start, center, or end while preserving the full text for assistive technology.",
+          "name": "FormatTruncate",
+          "slots": [
+            {
+              "description": "Text to truncate. The component flattens, trims, and normalizes mixed text and element nodes.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "'start' | 'center' | 'end'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "start",
+                    "description": ""
+                  },
+                  {
+                    "value": "center",
+                    "description": ""
+                  },
+                  {
+                    "value": "end",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'start'",
+              "description": "Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges.",
+              "attribute": "position",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "strategy",
+              "type": {
+                "text": "'character' | 'word' | 'path'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "character",
+                    "description": ""
+                  },
+                  {
+                    "value": "word",
+                    "description": ""
+                  },
+                  {
+                    "value": "path",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'character'",
+              "description": "Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments.",
+              "attribute": "strategy",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "bias",
+              "type": {
+                "text": "'start' | 'end'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "start",
+                    "description": ""
+                  },
+                  {
+                    "value": "end",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'end'",
+              "description": "Edge favored by center truncation. The favored edge keeps at least the configured number of units.",
+              "attribute": "bias",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "preserve",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "6",
+              "description": "Number of strategy units retained at the biased edge during center truncation.",
+              "attribute": "preserve",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "connectedMoveCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "position",
+              "type": {
+                "text": "'start' | 'center' | 'end'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "start",
+                    "description": ""
+                  },
+                  {
+                    "value": "center",
+                    "description": ""
+                  },
+                  {
+                    "value": "end",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'start'",
+              "description": "Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges.",
+              "fieldName": "position"
+            },
+            {
+              "name": "strategy",
+              "type": {
+                "text": "'character' | 'word' | 'path'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "character",
+                    "description": ""
+                  },
+                  {
+                    "value": "word",
+                    "description": ""
+                  },
+                  {
+                    "value": "path",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'character'",
+              "description": "Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments.",
+              "fieldName": "strategy"
+            },
+            {
+              "name": "bias",
+              "type": {
+                "text": "'start' | 'end'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "start",
+                    "description": ""
+                  },
+                  {
+                    "value": "end",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'end'",
+              "description": "Edge favored by center truncation. The favored edge keeps at least the configured number of units.",
+              "fieldName": "bias"
+            },
+            {
+              "name": "preserve",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "6",
+              "description": "Number of strategy units retained at the biased edge during center truncation.",
+              "fieldName": "preserve"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nve-format-truncate",
+          "customElement": true,
+          "metadata": {
+            "unitTests": true,
+            "apiReview": true,
+            "performance": true,
+            "stable": true,
+            "vqa": true,
+            "responsive": true,
+            "themes": true,
+            "aria": "#",
+            "entrypoint": "@nvidia-elements/core/format-truncate",
+            "example": "<div nve-layout=\"column gap:sm\" style=\"max-width: 16rem\">\n  <nve-format-truncate position=\"start\">training-pipeline-2026-08-05-production</nve-format-truncate>\n  <nve-format-truncate position=\"center\">training-pipeline-2026-08-05-production</nve-format-truncate>\n  <nve-format-truncate position=\"end\">training-pipeline-2026-08-05-production</nve-format-truncate>\n</div>",
+            "package": true,
+            "documentation": "https://nvidia.github.io/elements/docs/elements/format-truncate/",
+            "since": "0.0.0",
+            "status": "beta",
+            "behavior": "content",
+            "markdown": "## nve-format-truncate\n\nTruncates text at its start, center, or end while preserving the full text for assistive technology.\n\n### Example\n\n```html\n<div nve-layout=\"column gap:sm\" style=\"max-width: 16rem\">\n  <nve-format-truncate position=\"start\">training-pipeline-2026-08-05-production</nve-format-truncate>\n  <nve-format-truncate position=\"center\">training-pipeline-2026-08-05-production</nve-format-truncate>\n  <nve-format-truncate position=\"end\">training-pipeline-2026-08-05-production</nve-format-truncate>\n</div>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/format-truncate/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Text to truncate. The component flattens, trims, and normalizes mixed text and element nodes. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| position | `'start' \\| 'center' \\| 'end'` | Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges. |\n| strategy | `'character' \\| 'word' \\| 'path'` | Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments. |\n| bias | `'start' \\| 'end'` | Edge favored by center truncation. The favored edge keeps at least the configured number of units. |\n| preserve | `number` | Number of strategy units retained at the biased edge during center truncation. |\n| connectedMoveCallback |  |  |"
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "FormatTruncate",
+          "declaration": {
+            "name": "FormatTruncate",
+            "module": "/src/format-truncate/format-truncate.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/format-truncate/index.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "home/runner/work/elements/elements/projects/core/src/format-truncate/format-truncate.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/format-truncate/utils.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "normalizeTruncateText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "nodes",
+              "type": {
+                "text": "Iterable<Node>",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "normalizeTruncateString",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "truncateText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "{\n    position,\n    strategy,\n    bias,\n    preserve,\n    availableWidth,\n    measureText\n  }",
+              "type": {
+                "text": "{\n    position: TruncatePosition;\n    strategy: TruncateStrategy;\n    bias: TruncateBias;\n    preserve: number;\n    availableWidth: number;\n    measureText: (value: string) => number;\n  }",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "normalizeTruncateText",
+          "declaration": {
+            "name": "normalizeTruncateText",
+            "module": "/src/format-truncate/utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "normalizeTruncateString",
+          "declaration": {
+            "name": "normalizeTruncateString",
+            "module": "/src/format-truncate/utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "truncateText",
+          "declaration": {
+            "name": "truncateText",
+            "module": "/src/format-truncate/utils.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "/src/forms/control-group/control-group.js",

package/dist/data.html.json

@@ -1948,6 +1948,46 @@
         }
       ]
     },
+    {
+      "name": "nve-format-truncate",
+      "description": "Truncates text at its start, center, or end while preserving the full text for assistive technology.\n---\n\n\n### **Slots:**\n - _default_ - Text to truncate. The component flattens, trims, and normalizes mixed text and element nodes.",
+      "attributes": [
+        {
+          "name": "position",
+          "description": "Location of the ellipsis. Use start or end to preserve one edge, or center to preserve both edges.",
+          "values": [
+            { "name": "start" },
+            { "name": "center" },
+            { "name": "end" }
+          ]
+        },
+        {
+          "name": "strategy",
+          "description": "Text unit used for center truncation. Character preserves graphemes, word preserves words, and path preserves path segments.",
+          "values": [
+            { "name": "character" },
+            { "name": "word" },
+            { "name": "path" }
+          ]
+        },
+        {
+          "name": "bias",
+          "description": "Edge favored by center truncation. The favored edge keeps at least the configured number of units.",
+          "values": [{ "name": "start" }, { "name": "end" }]
+        },
+        {
+          "name": "preserve",
+          "description": "Number of strategy units retained at the biased edge during center truncation.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://nvidia.github.io/elements/docs/elements/format-truncate/"
+        }
+      ]
+    },
     {
       "name": "nve-control-group",
       "description": "Groups many related form controls under a shared label and validation context for semantically linked inputs.\n---\n\n\n### **Slots:**\n - _default_ - Control input elements\n\n### **CSS Properties:**\n - **--color** - [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color) _(default: undefined)_\n- **--label-color** - [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color) _(default: undefined)_\n- **--label-text-transform** - [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-transform) _(default: undefined)_\n- **--label-font-weight** - [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight) _(default: undefined)_\n- **--label-font-size** - [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size) _(default: undefined)_",