@tylertech/forge 3.9.0-dev.4 → 3.9.0

package/custom-elements.json

@@ -26950,80 +26950,132 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/meter/meter/meter.ts",
+      "path": "src/lib/list/list-item/list-item.ts",
       "declarations": [
-        {
-          "kind": "variable",
-          "name": "METER_TAG_NAME",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-meter'"
-        },
         {
           "kind": "class",
           "description": "",
-          "name": "MeterComponent",
+          "name": "ListItemComponent",
           "cssProperties": [
             {
-              "description": "The background color of the meter.",
-              "name": "--forge-meter-background"
+              "description": "The background color.",
+              "name": "--forge-list-item-background"
             },
             {
-              "description": "The color of the meter's bar.",
-              "name": "--forge-meter-color"
+              "description": "The shape of the list item.",
+              "name": "--forge-list-item-shape"
             },
             {
-              "description": "The block size of the meter.",
-              "name": "--forge-meter-height"
+              "description": "The padding inside of the container element.",
+              "name": "--forge-list-item-padding"
             },
             {
-              "description": "The border radius of the meter.",
-              "name": "--forge-meter-shape"
+              "description": "The padding inside of the container element when `wrap` is enabled.",
+              "name": "--forge-list-item-wrap-padding"
             },
             {
-              "description": "The border radius of the meter's bar.",
-              "name": "--forge-meter-bar-inner-shape"
+              "description": "The margin around the host element.",
+              "name": "--forge-list-item-margin"
             },
             {
-              "description": "The number of tickmarks to display.",
-              "name": "--forge-meter-tickmarks"
+              "description": "The height of the container.",
+              "name": "--forge-list-item-height"
             },
             {
-              "description": "The opacity of the tickmarks.",
-              "name": "--forge-meter-tickmark-opacity"
+              "description": "The margin inline state when in the indented state.",
+              "name": "--forge-list-item-indent"
             },
             {
-              "description": "The duration of transitions.",
-              "name": "--forge-meter-transition-duration"
+              "description": "The cursor when interactive.",
+              "name": "--forge-list-item-cursor"
             },
             {
-              "description": "The timing function of transitions.",
-              "name": "--forge-meter-transition-timing"
+              "description": "The gap between the slotted content.",
+              "name": "--forge-list-item-gap"
             },
             {
-              "description": "The color of the bar when the value is optimal.",
-              "name": "--forge-theme-success"
+              "description": "The text color of the text.",
+              "name": "--forge-list-item-text-color"
             },
             {
-              "description": "The color of the track when the value is optimal.",
-              "name": "--forge-theme-success-container-low"
+              "description": "The font size of the text.",
+              "name": "--forge-list-item-text-font-size"
             },
             {
-              "description": "The color of the bar when the value is suboptimal.",
-              "name": "--forge-theme-warning"
+              "description": "The font weight of the text.",
+              "name": "--forge-list-item-text-font-weight"
             },
             {
-              "description": "The color of the track when the value is suboptimal.",
-              "name": "--forge-theme-warning-container-low"
+              "description": "The line height of the text.",
+              "name": "--forge-list-item-text-line-height"
             },
             {
-              "description": "The color of the bar when the value is least optimal.",
-              "name": "--forge-theme-error"
+              "description": "The foreground color when in the selected state.",
+              "name": "--forge-list-item-selected-color"
             },
             {
-              "description": "The color of the track when the value is least optimal.",
-              "name": "--forge-theme-error-container-low"
+              "description": "The background color when in the selected state.",
+              "name": "--forge-list-item-selected-background"
+            },
+            {
+              "description": "The opacity of the background color when in the selected state.",
+              "name": "--forge-list-item-selected-opacity"
+            },
+            {
+              "description": "The color of the start content when in the selected state.",
+              "name": "--forge-list-item-start-selected-color"
+            },
+            {
+              "description": "The color of the end content when in the selected state.",
+              "name": "--forge-list-item-end-selected-color"
+            },
+            {
+              "description": "The color of the text when in the selected state.",
+              "name": "--forge-list-item-selected-text-color"
+            },
+            {
+              "description": "The opacity of the element when in the disabled state.",
+              "name": "--forge-list-item-disabled-opacity"
+            },
+            {
+              "description": "The cursor when in the disabled state.",
+              "name": "--forge-list-item-disabled-cursor"
+            },
+            {
+              "description": "The line height when in the one/single line state.",
+              "name": "--forge-list-item-one-line-height"
+            },
+            {
+              "description": "The line height when in the two line state.",
+              "name": "--forge-list-item-two-line-height"
+            },
+            {
+              "description": "The line height when in the three line state.",
+              "name": "--forge-list-item-three-line-height"
+            },
+            {
+              "description": "The line height when in the dense one/single line state.",
+              "name": "--forge-list-item-dense-one-line-height"
+            },
+            {
+              "description": "The line height when in the dense two line state.",
+              "name": "--forge-list-item-dense-two-line-height"
+            },
+            {
+              "description": "The line height when in the dense three line state.",
+              "name": "--forge-list-item-dense-three-line-height"
+            },
+            {
+              "description": "The font size when in the dense state.",
+              "name": "--forge-list-item-dense-font-size"
+            },
+            {
+              "description": "The margin inline state when in the dense indented state.",
+              "name": "--forge-list-item-dense-indent"
+            },
+            {
+              "description": "The gap between the slotted content when in the dense state.",
+              "name": "--forge-list-item-dense-gap"
             }
           ],
           "cssParts": [
@@ -27032,464 +27084,305 @@
               "name": "root"
             },
             {
-              "description": "The element comprising the meter's background.",
-              "name": "track"
+              "description": "The container for the text content.",
+              "name": "text-container"
             },
             {
-              "description": "The bar representing the value.",
-              "name": "bar"
+              "description": "The forwarded focus indicator's internal indicator element.",
+              "name": "focus-indicator"
+            },
+            {
+              "description": "The forwarded state layer's internal surface element.",
+              "name": "state-layer"
             }
           ],
           "slots": [
             {
-              "description": "The default slot for the meter's label.",
+              "description": "The primary text.",
               "name": ""
             },
             {
-              "description": "A textual representation of the meter's value.",
-              "name": "value"
+              "description": "The secondary text.",
+              "name": "secondary-text"
+            },
+            {
+              "description": "The tertiary text.",
+              "name": "tertiary-text"
+            },
+            {
+              "description": "The start content.",
+              "name": "start"
+            },
+            {
+              "description": "The end element.",
+              "name": "end"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "value",
+              "name": "_adapter",
               "type": {
-                "text": "number"
+                "text": "ListItemAdapter"
               },
-              "privacy": "public",
-              "default": "0",
-              "description": "The current value of the meter.",
-              "attribute": "value"
+              "privacy": "private",
+              "default": "new ListItemAdapter(this)"
             },
             {
               "kind": "field",
-              "name": "min",
+              "name": "selected",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "0",
-              "description": "The minimum value of the meter.",
-              "attribute": "min"
+              "description": "Applies the selected state to the list item.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "max",
+              "name": "active",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "1",
-              "description": "The maximum value of the meter.",
-              "attribute": "max"
+              "description": "Applies the active state to the list item by emulating its focused state.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "low",
+              "name": "value",
               "type": {
-                "text": "number | null | undefined"
+                "text": "unknown"
               },
               "privacy": "public",
-              "description": "The low value threshold.",
-              "default": "0",
-              "attribute": "low"
+              "description": "The unique value of the list item."
             },
             {
               "kind": "field",
-              "name": "high",
+              "name": "dense",
               "type": {
-                "text": "number | null | undefined"
+                "text": "boolean"
               },
               "privacy": "public",
-              "description": "The high value threshold.",
-              "default": "1",
-              "attribute": "high"
+              "description": "Applies the dense state to the list item.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "optimum",
+              "name": "indented",
               "type": {
-                "text": "number | null | undefined"
+                "text": "boolean"
               },
               "privacy": "public",
-              "description": "Indicates the region of the optimum value.",
-              "default": "1",
-              "attribute": "optimum"
+              "description": "Applies the indented state by adding margin to the start of the list item.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "tickmarks",
+              "name": "twoLine",
               "type": {
                 "text": "boolean"
               },
               "privacy": "public",
-              "default": "false",
-              "description": "Whether to display tickmarks.",
-              "attribute": "tickmarks"
+              "description": "Sets the list item height to support at least two lines of text.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "valueMode",
+              "name": "threeLine",
               "type": {
-                "text": "MeterValueMode"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "'manual'",
-              "description": "Whether the current value is displayed as a percentage or raw value. When set to `'manual'`\nthe value text is not shown automatically but can still be set manually via the value slot.",
-              "attribute": "value-mode"
+              "description": "Sets the list item height to support at least three lines of text.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "direction",
+              "name": "wrap",
               "type": {
-                "text": "MeterDirection"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "'horizontal'",
-              "description": "Whether the meter is oriented horizontally or vertically.",
-              "attribute": "direction"
+              "description": "Sets the list item to wrap its text content.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "shape",
+              "name": "noninteractive",
               "type": {
-                "text": "MeterShape"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "'default'",
-              "description": "The shape of the meter.",
-              "attribute": "shape"
+              "description": "Controls whether the list item will automatically attach itself to interactive slotted elements or not.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "innerShape",
+              "name": "focusPropagation",
               "type": {
-                "text": "MeterInnerShape"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "'default'",
-              "description": "The shape of the bar.",
-              "attribute": "inner-shape"
-            },
+              "description": "Controls whether the interactive element will receive focus if a non-interactive element is clicked within the list item.",
+              "default": "\"allow\""
+            }
+          ],
+          "events": [
             {
-              "kind": "field",
-              "name": "density",
               "type": {
-                "text": "MeterDensity"
+                "text": "CustomEvent<IListItemSelectEventData>"
               },
-              "privacy": "public",
-              "default": "'medium'",
-              "description": "The density of the meter.",
-              "attribute": "density"
-            },
+              "description": "Fires when the list item is selected.",
+              "name": "forge-list-item-select"
+            }
+          ],
+          "attributes": [
             {
-              "kind": "field",
-              "name": "theme",
               "type": {
-                "text": "MeterTheme"
+                "text": "boolean"
               },
-              "privacy": "public",
-              "default": "'default'",
-              "description": "The theme of the meter.",
-              "attribute": "theme"
+              "description": "Applies the selected state to the list item.",
+              "name": "selected",
+              "default": "false"
             },
             {
-              "kind": "field",
-              "name": "muted",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "public",
-              "default": "false",
-              "description": "Whether the theme is muted.",
-              "attribute": "muted"
+              "description": "Applies the active state to the list item by emulating its focused state.",
+              "name": "active",
+              "default": "false"
             },
             {
-              "kind": "field",
-              "name": "percentage",
               "type": {
-                "text": "number"
+                "text": "unknown"
               },
-              "privacy": "public",
-              "description": "Gets the percentage of the meter that's filled.",
-              "readonly": true
+              "description": "The unique value of the list item.",
+              "name": "value"
             },
             {
-              "kind": "field",
-              "name": "_percentage",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "0"
+              "description": "Applies the dense state to the list item.",
+              "name": "dense",
+              "default": "false"
             },
             {
-              "kind": "field",
-              "name": "_status",
               "type": {
-                "text": "MeterStatus"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "'optimal'"
+              "description": "Applies the indented state by adding margin to the start of the list item.",
+              "name": "indented",
+              "default": "false"
             },
             {
-              "kind": "field",
-              "name": "_segmented",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
+              "description": "Sets the list item height to support at least two lines of text.",
+              "name": "two-line",
               "default": "false"
             },
             {
-              "kind": "field",
-              "name": "_grouped",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
+              "description": "Sets the list item height to support at least three lines of text.",
+              "name": "three-line",
               "default": "false"
             },
             {
-              "kind": "field",
-              "name": "_hasSlottedContent",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
+              "description": "Sets the list item to wrap its text content.",
+              "name": "wrap",
               "default": "false"
             },
             {
-              "kind": "field",
-              "name": "_defaultNodes",
               "type": {
-                "text": "Node[]"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "description": "Controls whether the list item will automatically attach itself to interactive slotted elements or not.",
+              "name": "noninteractive",
+              "default": "false"
             },
             {
-              "kind": "field",
-              "name": "_valueNodes",
               "type": {
-                "text": "Node[]"
+                "text": "boolean"
               },
-              "privacy": "private"
-            },
+              "description": "Controls whether the interactive element will receive focus if a non-interactive element is clicked within the list item.",
+              "name": "focus-propagation",
+              "default": "\"allow\""
+            }
+          ],
+          "mixins": [
             {
-              "kind": "method",
-              "name": "_getStatus",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Determines the percentage of the meter that's filled and whether the value is optimal,\nsuboptimal, or least optimal."
+              "name": "WithElementInternals",
+              "module": "/src/lib/core/mixins/internals/with-element-internals"
             },
             {
-              "kind": "method",
-              "name": "_getSegmented",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Determines whether low and high ranges are set. The meter is segmented if either the low or\nhigh property is defined.\n\nWhen the meter is segmented the default or themed color scheme is replaced by semantic colors\ncorresponding to optimal, suboptimal, and least optimal values."
-            },
+              "name": "WithDefaultAria",
+              "module": "/src/lib/core/mixins/internals/with-default-aria"
+            }
+          ],
+          "superclass": {
+            "name": "BaseComponent",
+            "module": "/src/lib/core/base/base-component"
+          },
+          "tagName": "forge-list-item",
+          "customElement": true,
+          "summary": "List items are individual rows of content inside of a list.",
+          "cssClasses": [
             {
-              "kind": "method",
-              "name": "_getGrouped",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              },
-              "description": "Checks if the meter is part of a group and inherits the min and max values."
+              "name": "forge-list-item",
+              "description": "The list item element (required)."
             },
             {
-              "kind": "method",
-              "name": "_handleSlotChange",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Checks whether the meter has any slotted content."
+              "name": "forge-list-item--disabled",
+              "description": "The disabled state."
             },
             {
-              "kind": "method",
-              "name": "_setValueState",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Updates the internal state of the meter based on the current status."
-            }
-          ],
-          "attributes": [
-            {
-              "name": "value",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "The current value of the meter.",
-              "fieldName": "value"
+              "name": "forge-list-item--dense",
+              "description": "The dense state."
             },
             {
-              "name": "min",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "The minimum value of the meter.",
-              "fieldName": "min"
+              "name": "forge-list-item--interactive",
+              "description": "Manually forces the list item to appear interactive with hover/focus states. This will happen automatically if there is a child `<button>` or `<a>` element."
             },
             {
-              "name": "max",
-              "type": {
-                "text": "number"
-              },
-              "default": "1",
-              "description": "The maximum value of the meter.",
-              "fieldName": "max"
+              "name": "forge-list-item--two-line",
+              "description": "Uses the two-line style."
             },
             {
-              "name": "low",
-              "type": {
-                "text": "number | null | undefined"
-              },
-              "description": "The low value threshold.",
-              "default": "0",
-              "fieldName": "low"
+              "name": "forge-list-item--three-line",
+              "description": "Uses the three-line style."
             },
             {
-              "name": "high",
-              "type": {
-                "text": "number | null | undefined"
-              },
-              "description": "The high value threshold.",
-              "default": "1",
-              "fieldName": "high"
+              "name": "forge-list-item--indented",
+              "description": "Indents the list item."
             },
             {
-              "name": "optimum",
-              "type": {
-                "text": "number | null | undefined"
-              },
-              "description": "Indicates the region of the optimum value.",
-              "default": "1",
-              "fieldName": "optimum"
+              "name": "forge-list-item--wrap",
+              "description": "Wraps the text content."
             },
             {
-              "name": "tickmarks",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether to display tickmarks.",
-              "fieldName": "tickmarks"
+              "name": "forge-list-item--selected",
+              "description": "The selected state."
             },
             {
-              "name": "value-mode",
-              "type": {
-                "text": "MeterValueMode"
-              },
-              "default": "'manual'",
-              "description": "Whether the current value is displayed as a percentage or raw value. When set to `'manual'`\nthe value text is not shown automatically but can still be set manually via the value slot.",
-              "fieldName": "valueMode"
+              "name": "forge-list-item__text",
+              "description": "Styles the text content. Apply this to the primary, secondary, and tertiary text content."
             },
             {
-              "name": "direction",
-              "type": {
-                "text": "MeterDirection"
-              },
-              "default": "'horizontal'",
-              "description": "Whether the meter is oriented horizontally or vertically.",
-              "fieldName": "direction"
+              "name": "forge-list-item__start",
+              "description": "Styles the start content (typically an icon)."
             },
             {
-              "name": "shape",
-              "type": {
-                "text": "MeterShape"
-              },
-              "default": "'default'",
-              "description": "The shape of the meter.",
-              "fieldName": "shape"
-            },
-            {
-              "name": "inner-shape",
-              "type": {
-                "text": "MeterInnerShape"
-              },
-              "default": "'default'",
-              "description": "The shape of the bar.",
-              "fieldName": "innerShape"
-            },
-            {
-              "name": "density",
-              "type": {
-                "text": "MeterDensity"
-              },
-              "default": "'medium'",
-              "description": "The density of the meter.",
-              "fieldName": "density"
-            },
-            {
-              "name": "theme",
-              "type": {
-                "text": "MeterTheme"
-              },
-              "default": "'default'",
-              "description": "The theme of the meter.",
-              "fieldName": "theme"
-            },
-            {
-              "name": "muted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the theme is muted.",
-              "fieldName": "muted"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Defines a text alternative for the current value. Set this if it would be inaccurate to read the value as a percentage.",
-              "name": "aria-valuetext"
-            }
-          ],
-          "superclass": {
-            "name": "BaseLitElement",
-            "module": "/src/lib/core/base/base-lit-element"
-          },
-          "tagName": "forge-meter",
-          "customElement": true,
-          "summary": "Meters display a scalar value within a defined range.",
-          "states": [
-            {
-              "name": "vertical",
-              "description": "Applied when the meter is oriented vertically."
-            },
-            {
-              "name": "optimum-value",
-              "description": "Applied when the value is within the optimum range."
-            },
-            {
-              "name": "suboptimum-value",
-              "description": "Applied when the value is within the suboptimum range."
-            },
-            {
-              "name": "least-optimum-value",
-              "description": "Applied when the value is within the least optimum range."
+              "name": "forge-list-item__end",
+              "description": "Styles the end content (typically an icon)."
             }
           ]
         }
@@ -27497,457 +27390,556 @@
       "exports": [
         {
           "kind": "js",
-          "name": "METER_TAG_NAME",
-          "declaration": {
-            "name": "METER_TAG_NAME",
-            "module": "src/lib/meter/meter/meter.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "MeterComponent",
+          "name": "ListItemComponent",
           "declaration": {
-            "name": "MeterComponent",
-            "module": "src/lib/meter/meter/meter.ts"
+            "name": "ListItemComponent",
+            "module": "src/lib/list/list-item/list-item.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/list/list-item/list-item.ts",
+      "path": "src/lib/meter/meter/meter.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "METER_TAG_NAME",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-meter'"
+        },
         {
           "kind": "class",
           "description": "",
-          "name": "ListItemComponent",
+          "name": "MeterComponent",
           "cssProperties": [
             {
-              "description": "The background color.",
-              "name": "--forge-list-item-background"
-            },
-            {
-              "description": "The shape of the list item.",
-              "name": "--forge-list-item-shape"
-            },
-            {
-              "description": "The padding inside of the container element.",
-              "name": "--forge-list-item-padding"
-            },
-            {
-              "description": "The padding inside of the container element when `wrap` is enabled.",
-              "name": "--forge-list-item-wrap-padding"
-            },
-            {
-              "description": "The margin around the host element.",
-              "name": "--forge-list-item-margin"
-            },
-            {
-              "description": "The height of the container.",
-              "name": "--forge-list-item-height"
-            },
-            {
-              "description": "The margin inline state when in the indented state.",
-              "name": "--forge-list-item-indent"
+              "description": "The background color of the meter.",
+              "name": "--forge-meter-background"
             },
             {
-              "description": "The cursor when interactive.",
-              "name": "--forge-list-item-cursor"
+              "description": "The color of the meter's bar.",
+              "name": "--forge-meter-color"
             },
             {
-              "description": "The gap between the slotted content.",
-              "name": "--forge-list-item-gap"
+              "description": "The block size of the meter.",
+              "name": "--forge-meter-height"
             },
             {
-              "description": "The text color of the text.",
-              "name": "--forge-list-item-text-color"
+              "description": "The border radius of the meter.",
+              "name": "--forge-meter-shape"
             },
             {
-              "description": "The font size of the text.",
-              "name": "--forge-list-item-text-font-size"
+              "description": "The border radius of the meter's bar.",
+              "name": "--forge-meter-bar-inner-shape"
             },
             {
-              "description": "The font weight of the text.",
-              "name": "--forge-list-item-text-font-weight"
+              "description": "The number of tickmarks to display.",
+              "name": "--forge-meter-tickmarks"
             },
             {
-              "description": "The line height of the text.",
-              "name": "--forge-list-item-text-line-height"
+              "description": "The opacity of the tickmarks.",
+              "name": "--forge-meter-tickmark-opacity"
             },
             {
-              "description": "The foreground color when in the selected state.",
-              "name": "--forge-list-item-selected-color"
+              "description": "The duration of transitions.",
+              "name": "--forge-meter-transition-duration"
             },
             {
-              "description": "The background color when in the selected state.",
-              "name": "--forge-list-item-selected-background"
+              "description": "The timing function of transitions.",
+              "name": "--forge-meter-transition-timing"
             },
             {
-              "description": "The opacity of the background color when in the selected state.",
-              "name": "--forge-list-item-selected-opacity"
+              "description": "The color of the bar when the value is optimal.",
+              "name": "--forge-theme-success"
             },
             {
-              "description": "The color of the start content when in the selected state.",
-              "name": "--forge-list-item-start-selected-color"
+              "description": "The color of the track when the value is optimal.",
+              "name": "--forge-theme-success-container-low"
             },
             {
-              "description": "The color of the end content when in the selected state.",
-              "name": "--forge-list-item-end-selected-color"
+              "description": "The color of the bar when the value is suboptimal.",
+              "name": "--forge-theme-warning"
             },
             {
-              "description": "The color of the text when in the selected state.",
-              "name": "--forge-list-item-selected-text-color"
+              "description": "The color of the track when the value is suboptimal.",
+              "name": "--forge-theme-warning-container-low"
             },
             {
-              "description": "The opacity of the element when in the disabled state.",
-              "name": "--forge-list-item-disabled-opacity"
+              "description": "The color of the bar when the value is least optimal.",
+              "name": "--forge-theme-error"
             },
             {
-              "description": "The cursor when in the disabled state.",
-              "name": "--forge-list-item-disabled-cursor"
-            },
+              "description": "The color of the track when the value is least optimal.",
+              "name": "--forge-theme-error-container-low"
+            }
+          ],
+          "cssParts": [
             {
-              "description": "The line height when in the one/single line state.",
-              "name": "--forge-list-item-one-line-height"
+              "description": "The root container element.",
+              "name": "root"
             },
             {
-              "description": "The line height when in the two line state.",
-              "name": "--forge-list-item-two-line-height"
+              "description": "The element comprising the meter's background.",
+              "name": "track"
             },
             {
-              "description": "The line height when in the three line state.",
-              "name": "--forge-list-item-three-line-height"
-            },
+              "description": "The bar representing the value.",
+              "name": "bar"
+            }
+          ],
+          "slots": [
             {
-              "description": "The line height when in the dense one/single line state.",
-              "name": "--forge-list-item-dense-one-line-height"
+              "description": "The default slot for the meter's label.",
+              "name": ""
             },
             {
-              "description": "The line height when in the dense two line state.",
-              "name": "--forge-list-item-dense-two-line-height"
-            },
+              "description": "A textual representation of the meter's value.",
+              "name": "value"
+            }
+          ],
+          "members": [
             {
-              "description": "The line height when in the dense three line state.",
-              "name": "--forge-list-item-dense-three-line-height"
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "default": "0",
+              "description": "The current value of the meter.",
+              "attribute": "value"
             },
             {
-              "description": "The font size when in the dense state.",
-              "name": "--forge-list-item-dense-font-size"
+              "kind": "field",
+              "name": "min",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "default": "0",
+              "description": "The minimum value of the meter.",
+              "attribute": "min"
             },
             {
-              "description": "The margin inline state when in the dense indented state.",
-              "name": "--forge-list-item-dense-indent"
+              "kind": "field",
+              "name": "max",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "default": "1",
+              "description": "The maximum value of the meter.",
+              "attribute": "max"
             },
             {
-              "description": "The gap between the slotted content when in the dense state.",
-              "name": "--forge-list-item-dense-gap"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The root container element.",
-              "name": "root"
+              "kind": "field",
+              "name": "low",
+              "type": {
+                "text": "number | null | undefined"
+              },
+              "privacy": "public",
+              "description": "The low value threshold.",
+              "default": "0",
+              "attribute": "low"
             },
             {
-              "description": "The container for the text content.",
-              "name": "text-container"
+              "kind": "field",
+              "name": "high",
+              "type": {
+                "text": "number | null | undefined"
+              },
+              "privacy": "public",
+              "description": "The high value threshold.",
+              "default": "1",
+              "attribute": "high"
             },
             {
-              "description": "The forwarded focus indicator's internal indicator element.",
-              "name": "focus-indicator"
+              "kind": "field",
+              "name": "optimum",
+              "type": {
+                "text": "number | null | undefined"
+              },
+              "privacy": "public",
+              "description": "Indicates the region of the optimum value.",
+              "default": "1",
+              "attribute": "optimum"
             },
             {
-              "description": "The forwarded state layer's internal surface element.",
-              "name": "state-layer"
-            }
-          ],
-          "slots": [
-            {
-              "description": "The primary text.",
-              "name": ""
+              "kind": "field",
+              "name": "tickmarks",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether to display tickmarks.",
+              "attribute": "tickmarks"
             },
             {
-              "description": "The secondary text.",
-              "name": "secondary-text"
+              "kind": "field",
+              "name": "valueMode",
+              "type": {
+                "text": "MeterValueMode"
+              },
+              "privacy": "public",
+              "default": "'manual'",
+              "description": "Whether the current value is displayed as a percentage or raw value. When set to `'manual'`\nthe value text is not shown automatically but can still be set manually via the value slot.",
+              "attribute": "value-mode"
             },
             {
-              "description": "The tertiary text.",
-              "name": "tertiary-text"
+              "kind": "field",
+              "name": "direction",
+              "type": {
+                "text": "MeterDirection"
+              },
+              "privacy": "public",
+              "default": "'horizontal'",
+              "description": "Whether the meter is oriented horizontally or vertically.",
+              "attribute": "direction"
             },
             {
-              "description": "The start content.",
-              "name": "start"
+              "kind": "field",
+              "name": "shape",
+              "type": {
+                "text": "MeterShape"
+              },
+              "privacy": "public",
+              "default": "'default'",
+              "description": "The shape of the meter.",
+              "attribute": "shape"
             },
             {
-              "description": "The end element.",
-              "name": "end"
-            }
-          ],
-          "members": [
+              "kind": "field",
+              "name": "innerShape",
+              "type": {
+                "text": "MeterInnerShape"
+              },
+              "privacy": "public",
+              "default": "'default'",
+              "description": "The shape of the bar.",
+              "attribute": "inner-shape"
+            },
             {
               "kind": "field",
-              "name": "_adapter",
+              "name": "density",
               "type": {
-                "text": "ListItemAdapter"
+                "text": "MeterDensity"
               },
-              "privacy": "private",
-              "default": "new ListItemAdapter(this)"
+              "privacy": "public",
+              "default": "'medium'",
+              "description": "The density of the meter.",
+              "attribute": "density"
             },
             {
               "kind": "field",
-              "name": "selected",
+              "name": "theme",
               "type": {
-                "text": "boolean"
+                "text": "MeterTheme"
               },
               "privacy": "public",
-              "description": "Applies the selected state to the list item.",
-              "default": "false"
+              "default": "'default'",
+              "description": "The theme of the meter.",
+              "attribute": "theme"
             },
             {
               "kind": "field",
-              "name": "active",
+              "name": "muted",
               "type": {
                 "text": "boolean"
               },
               "privacy": "public",
-              "description": "Applies the active state to the list item by emulating its focused state.",
-              "default": "false"
+              "default": "false",
+              "description": "Whether the theme is muted.",
+              "attribute": "muted"
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "percentage",
               "type": {
-                "text": "unknown"
+                "text": "number"
               },
               "privacy": "public",
-              "description": "The unique value of the list item."
+              "description": "Gets the percentage of the meter that's filled.",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "dense",
+              "name": "_percentage",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "privacy": "public",
-              "description": "Applies the dense state to the list item.",
-              "default": "false"
+              "privacy": "private",
+              "default": "0"
             },
             {
               "kind": "field",
-              "name": "indented",
+              "name": "_status",
               "type": {
-                "text": "boolean"
+                "text": "MeterStatus"
               },
-              "privacy": "public",
-              "description": "Applies the indented state by adding margin to the start of the list item.",
-              "default": "false"
+              "privacy": "private",
+              "default": "'optimal'"
             },
             {
               "kind": "field",
-              "name": "twoLine",
+              "name": "_segmented",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "public",
-              "description": "Sets the list item height to support at least two lines of text.",
+              "privacy": "private",
               "default": "false"
             },
             {
               "kind": "field",
-              "name": "threeLine",
+              "name": "_grouped",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "public",
-              "description": "Sets the list item height to support at least three lines of text.",
+              "privacy": "private",
               "default": "false"
             },
             {
               "kind": "field",
-              "name": "wrap",
+              "name": "_hasSlottedContent",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "public",
-              "description": "Sets the list item to wrap its text content.",
+              "privacy": "private",
               "default": "false"
             },
             {
               "kind": "field",
-              "name": "noninteractive",
+              "name": "_defaultNodes",
               "type": {
-                "text": "boolean"
+                "text": "Node[]"
               },
-              "privacy": "public",
-              "description": "Controls whether the list item will automatically attach itself to interactive slotted elements or not.",
-              "default": "false"
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_valueNodes",
+              "type": {
+                "text": "Node[]"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_getStatus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Determines the percentage of the meter that's filled and whether the value is optimal,\nsuboptimal, or least optimal."
+            },
+            {
+              "kind": "method",
+              "name": "_getSegmented",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Determines whether low and high ranges are set. The meter is segmented if either the low or\nhigh property is defined.\n\nWhen the meter is segmented the default or themed color scheme is replaced by semantic colors\ncorresponding to optimal, suboptimal, and least optimal values."
+            },
+            {
+              "kind": "method",
+              "name": "_getGrouped",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "description": "Checks if the meter is part of a group and inherits the min and max values."
+            },
+            {
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Checks whether the meter has any slotted content."
+            },
+            {
+              "kind": "method",
+              "name": "_setValueState",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Updates the internal state of the meter based on the current status."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "value",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The current value of the meter.",
+              "fieldName": "value"
+            },
+            {
+              "name": "min",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The minimum value of the meter.",
+              "fieldName": "min"
+            },
+            {
+              "name": "max",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "The maximum value of the meter.",
+              "fieldName": "max"
             },
             {
-              "kind": "field",
-              "name": "focusPropagation",
+              "name": "low",
               "type": {
-                "text": "boolean"
+                "text": "number | null | undefined"
               },
-              "privacy": "public",
-              "description": "Controls whether the interactive element will receive focus if a non-interactive element is clicked within the list item.",
-              "default": "\"allow\""
-            }
-          ],
-          "events": [
+              "description": "The low value threshold.",
+              "default": "0",
+              "fieldName": "low"
+            },
             {
+              "name": "high",
               "type": {
-                "text": "CustomEvent<IListItemSelectEventData>"
+                "text": "number | null | undefined"
               },
-              "description": "Fires when the list item is selected.",
-              "name": "forge-list-item-select"
-            }
-          ],
-          "attributes": [
+              "description": "The high value threshold.",
+              "default": "1",
+              "fieldName": "high"
+            },
             {
+              "name": "optimum",
               "type": {
-                "text": "boolean"
+                "text": "number | null | undefined"
               },
-              "description": "Applies the selected state to the list item.",
-              "name": "selected",
-              "default": "false"
+              "description": "Indicates the region of the optimum value.",
+              "default": "1",
+              "fieldName": "optimum"
             },
             {
+              "name": "tickmarks",
               "type": {
                 "text": "boolean"
               },
-              "description": "Applies the active state to the list item by emulating its focused state.",
-              "name": "active",
-              "default": "false"
+              "default": "false",
+              "description": "Whether to display tickmarks.",
+              "fieldName": "tickmarks"
             },
             {
+              "name": "value-mode",
               "type": {
-                "text": "unknown"
+                "text": "MeterValueMode"
               },
-              "description": "The unique value of the list item.",
-              "name": "value"
+              "default": "'manual'",
+              "description": "Whether the current value is displayed as a percentage or raw value. When set to `'manual'`\nthe value text is not shown automatically but can still be set manually via the value slot.",
+              "fieldName": "valueMode"
             },
             {
+              "name": "direction",
               "type": {
-                "text": "boolean"
+                "text": "MeterDirection"
               },
-              "description": "Applies the dense state to the list item.",
-              "name": "dense",
-              "default": "false"
+              "default": "'horizontal'",
+              "description": "Whether the meter is oriented horizontally or vertically.",
+              "fieldName": "direction"
             },
             {
+              "name": "shape",
               "type": {
-                "text": "boolean"
+                "text": "MeterShape"
               },
-              "description": "Applies the indented state by adding margin to the start of the list item.",
-              "name": "indented",
-              "default": "false"
+              "default": "'default'",
+              "description": "The shape of the meter.",
+              "fieldName": "shape"
             },
             {
+              "name": "inner-shape",
               "type": {
-                "text": "boolean"
+                "text": "MeterInnerShape"
               },
-              "description": "Sets the list item height to support at least two lines of text.",
-              "name": "two-line",
-              "default": "false"
+              "default": "'default'",
+              "description": "The shape of the bar.",
+              "fieldName": "innerShape"
             },
             {
+              "name": "density",
               "type": {
-                "text": "boolean"
+                "text": "MeterDensity"
               },
-              "description": "Sets the list item height to support at least three lines of text.",
-              "name": "three-line",
-              "default": "false"
+              "default": "'medium'",
+              "description": "The density of the meter.",
+              "fieldName": "density"
             },
             {
+              "name": "theme",
               "type": {
-                "text": "boolean"
+                "text": "MeterTheme"
               },
-              "description": "Sets the list item to wrap its text content.",
-              "name": "wrap",
-              "default": "false"
+              "default": "'default'",
+              "description": "The theme of the meter.",
+              "fieldName": "theme"
             },
             {
+              "name": "muted",
               "type": {
                 "text": "boolean"
               },
-              "description": "Controls whether the list item will automatically attach itself to interactive slotted elements or not.",
-              "name": "noninteractive",
-              "default": "false"
+              "default": "false",
+              "description": "Whether the theme is muted.",
+              "fieldName": "muted"
             },
             {
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Controls whether the interactive element will receive focus if a non-interactive element is clicked within the list item.",
-              "name": "focus-propagation",
-              "default": "\"allow\""
-            }
-          ],
-          "mixins": [
-            {
-              "name": "WithElementInternals",
-              "module": "/src/lib/core/mixins/internals/with-element-internals"
-            },
-            {
-              "name": "WithDefaultAria",
-              "module": "/src/lib/core/mixins/internals/with-default-aria"
+              "description": "Defines a text alternative for the current value. Set this if it would be inaccurate to read the value as a percentage.",
+              "name": "aria-valuetext"
             }
           ],
           "superclass": {
-            "name": "BaseComponent",
-            "module": "/src/lib/core/base/base-component"
+            "name": "BaseLitElement",
+            "module": "/src/lib/core/base/base-lit-element"
           },
-          "tagName": "forge-list-item",
+          "tagName": "forge-meter",
           "customElement": true,
-          "summary": "List items are individual rows of content inside of a list.",
-          "cssClasses": [
-            {
-              "name": "forge-list-item",
-              "description": "The list item element (required)."
-            },
-            {
-              "name": "forge-list-item--disabled",
-              "description": "The disabled state."
-            },
-            {
-              "name": "forge-list-item--dense",
-              "description": "The dense state."
-            },
-            {
-              "name": "forge-list-item--interactive",
-              "description": "Manually forces the list item to appear interactive with hover/focus states. This will happen automatically if there is a child `<button>` or `<a>` element."
-            },
-            {
-              "name": "forge-list-item--two-line",
-              "description": "Uses the two-line style."
-            },
-            {
-              "name": "forge-list-item--three-line",
-              "description": "Uses the three-line style."
-            },
-            {
-              "name": "forge-list-item--indented",
-              "description": "Indents the list item."
-            },
-            {
-              "name": "forge-list-item--wrap",
-              "description": "Wraps the text content."
-            },
+          "summary": "Meters display a scalar value within a defined range.",
+          "states": [
             {
-              "name": "forge-list-item--selected",
-              "description": "The selected state."
+              "name": "vertical",
+              "description": "Applied when the meter is oriented vertically."
             },
             {
-              "name": "forge-list-item__text",
-              "description": "Styles the text content. Apply this to the primary, secondary, and tertiary text content."
+              "name": "optimum-value",
+              "description": "Applied when the value is within the optimum range."
             },
             {
-              "name": "forge-list-item__start",
-              "description": "Styles the start content (typically an icon)."
+              "name": "suboptimum-value",
+              "description": "Applied when the value is within the suboptimum range."
             },
             {
-              "name": "forge-list-item__end",
-              "description": "Styles the end content (typically an icon)."
+              "name": "least-optimum-value",
+              "description": "Applied when the value is within the least optimum range."
             }
           ]
         }
@@ -27955,10 +27947,18 @@
       "exports": [
         {
           "kind": "js",
-          "name": "ListItemComponent",
+          "name": "METER_TAG_NAME",
           "declaration": {
-            "name": "ListItemComponent",
-            "module": "src/lib/list/list-item/list-item.ts"
+            "name": "METER_TAG_NAME",
+            "module": "src/lib/meter/meter/meter.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MeterComponent",
+          "declaration": {
+            "name": "MeterComponent",
+            "module": "src/lib/meter/meter/meter.ts"
           }
         }
       ]
@@ -33179,7 +33179,7 @@
       ]
     }
   ],
-  "branchName": "fix-dialog-persistent-order",
+  "branchName": "main",
   "forgeTypes": {
     "Theme": {
       "path": "src/lib/constants.ts",
@@ -36349,38 +36349,6 @@
       "path": "src/lib/list/list/list.ts",
       "lineNumber": 70
     },
-    "MeterDirection": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 15
-    },
-    "MeterDensity": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 16
-    },
-    "MeterShape": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 17
-    },
-    "MeterInnerShape": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 18
-    },
-    "MeterStatus": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 19
-    },
-    "MeterTheme": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 20
-    },
-    "MeterValueMode": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 21
-    },
-    "MeterComponent": {
-      "path": "src/lib/meter/meter/meter.ts",
-      "lineNumber": 64
-    },
     "IListItemAdapter": {
       "path": "src/lib/list/list-item/list-item-adapter.ts",
       "lineNumber": 11
@@ -36417,6 +36385,38 @@
       "path": "src/lib/list/list-item/list-item.ts",
       "lineNumber": 123
     },
+    "MeterDirection": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 15
+    },
+    "MeterDensity": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 16
+    },
+    "MeterShape": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 17
+    },
+    "MeterInnerShape": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 18
+    },
+    "MeterStatus": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 19
+    },
+    "MeterTheme": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 20
+    },
+    "MeterValueMode": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 21
+    },
+    "MeterComponent": {
+      "path": "src/lib/meter/meter/meter.ts",
+      "lineNumber": 64
+    },
     "MeterGroupComponent": {
       "path": "src/lib/meter/meter-group/meter-group.ts",
       "lineNumber": 35