@wavemaker/foundation-css 11.14.1-rc.6311 → 11.14.2-1.6423

package/src/tokens/web/components/list/Token.Readme.md

@@ -0,0 +1,19 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| background | Sets the background color of lists (containers that hold multiple list items in a vertical or horizontal arrangement). This is the main background color that appears behind the list container.<br>CSS variable: --wm-list-background |
+| min-height | Controls the minimum height of lists (containers that hold multiple list items). This ensures the list is always tall enough to be visible and properly displayed, even when it has few items.<br>CSS variable: --wm-list-min-height |
+| opacity | Controls the transparency of lists (containers that hold multiple list items). When set to 1, the list is fully opaque. Lower values make the list more transparent, higher values make it more opaque.<br>CSS variable: --wm-list-opacity |
+| pointer-events | Controls whether list items can receive mouse/touch interactions. 'all' makes list items fully interactive (clickable, hoverable), 'none' makes them ignore all mouse/touch events (like they're invisible to the mouse), and 'auto' lets the browser decide. This is useful for enabling/disabling list functionality.<br>CSS variable: --wm-list-pointer-events |
+| state.layer.color | Sets the color of the state layer that appears when users hover, focus, or interact with list items. This creates visual feedback to show that the list item is interactive and responsive to user actions.<br>CSS variable: --wm-list-state-layer-color |
+| state.layer.opacity | Controls the transparency of the state layer that appears during user interactions with list items (hover, focus, active). When set to 0, the state layer is invisible. Higher values make the interaction feedback more visible.<br>CSS variable: --wm-list-state-layer-opacity |
+| item.background | Sets the background color of list items (individual entries in a list that users can interact with). This is the main background color that appears behind each list item content.<br>CSS variable: --wm-list-item-background |
+| item.padding | Controls the internal spacing inside list items (the space between the list item content and its borders). This creates breathing room around each list item content.<br>CSS variable: --wm-list-item-padding |
+| item.header.padding | Controls the internal spacing inside list item headers (section titles that group related list items). This creates breathing room around the header text.<br>CSS variable: --wm-list-item-header-padding |
+| item.header.background | Sets the background color of list item headers (section titles that group related list items). This is the main background color that appears behind the header text.<br>CSS variable: --wm-list-item-header-background |
+| item.header.color | Sets the text color of list item headers (section titles that group related list items). This determines what color the header text appears in, which should contrast well with the background for readability.<br>CSS variable: --wm-list-item-header-color |

package/src/tokens/web/components/list/list.json

@@ -34,28 +34,32 @@
         "value": "{color.surface.@.value}",
         "type": "color",
         "attributes": {
-          "subtype": "color"
+          "subtype": "color",
+          "description": "Sets the background color of lists (containers that hold multiple list items in a vertical or horizontal arrangement). This is the main background color that appears behind the list container.<br>CSS variable: --wm-list-background"
         }
       },
       "min-height": {
         "value": "6rem",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls the minimum height of lists (containers that hold multiple list items). This ensures the list is always tall enough to be visible and properly displayed, even when it has few items.<br>CSS variable: --wm-list-min-height"
         }
       },
       "opacity": {
         "value": "1",
         "type": "radius",
         "attributes": {
-          "subtype": "radius"
+          "subtype": "radius",
+          "description": "Controls the transparency of lists (containers that hold multiple list items). When set to 1, the list is fully opaque. Lower values make the list more transparent, higher values make it more opaque.<br>CSS variable: --wm-list-opacity"
         }
       },
       "pointer-events": {
         "value": "all",
         "type": "radius",
         "attributes": {
-          "subtype": "cursor"
+          "subtype": "cursor",
+          "description": "Controls whether list items can receive mouse/touch interactions. 'all' makes list items fully interactive (clickable, hoverable), 'none' makes them ignore all mouse/touch events (like they're invisible to the mouse), and 'auto' lets the browser decide. This is useful for enabling/disabling list functionality.<br>CSS variable: --wm-list-pointer-events"
         }
       },
       "state": {
@@ -64,14 +68,16 @@
             "value": "{color.on-surface.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the color of the state layer that appears when users hover, focus, or interact with list items. This creates visual feedback to show that the list item is interactive and responsive to user actions.<br>CSS variable: --wm-list-state-layer-color"
             }
           },
           "opacity": {
             "value": "0",
             "type": "radius",
             "attributes": {
-              "subtype": "opacity"
+              "subtype": "opacity",
+              "description": "Controls the transparency of the state layer that appears during user interactions with list items (hover, focus, active). When set to 0, the state layer is invisible. Higher values make the interaction feedback more visible.<br>CSS variable: --wm-list-state-layer-opacity"
             }
           }
         }
@@ -81,14 +87,16 @@
           "value": "{color.white.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the background color of list items (individual entries in a list that users can interact with). This is the main background color that appears behind each list item content.<br>CSS variable: --wm-list-item-background"
           }
         },
         "padding": {
           "value": "{space.3.value} {space.4.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing inside list items (the space between the list item content and its borders). This creates breathing room around each list item content.<br>CSS variable: --wm-list-item-padding"
           }
         },
         "header": {
@@ -96,21 +104,24 @@
             "value": "{space.3.value} {space.4.value}",
             "type": "space",
             "attributes": {
-              "subtype": "space"
+              "subtype": "space",
+              "description": "Controls the internal spacing inside list item headers (section titles that group related list items). This creates breathing room around the header text.<br>CSS variable: --wm-list-item-header-padding"
             }
           },
           "background": {
             "value": "{color.surface.container.lowest.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the background color of list item headers (section titles that group related list items). This is the main background color that appears behind the header text.<br>CSS variable: --wm-list-item-header-background"
             }
           },
           "color": {
             "value": "{color.on-surface.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the text color of list item headers (section titles that group related list items). This determines what color the header text appears in, which should contrast well with the background for readability.<br>CSS variable: --wm-list-item-header-color"
             }
           }
         }
@@ -176,11 +187,12 @@
             "value": "none",
             "type": "radius",
             "attributes": {
-              "subtype": "cursor"
+              "subtype": "cursor",
+              "description": "Disables mouse/touch interactions for disabled list items. When set to 'none', disabled list items ignore all mouse/touch events, making them completely non-interactive. This prevents users from clicking or hovering over disabled items.<br>CSS variable: --wm-list-pointer-events (disabled state)"
             }
           }
         }
       }
     }
   }
-}
+}

package/src/tokens/web/components/message/Token.Readme.md

@@ -0,0 +1,22 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| container.shadow | Controls the drop shadow effect around message containers (notification boxes that show alerts, warnings, or success messages). This creates a subtle shadow that makes the message appear to float above the background.<br>CSS variable: --wm-message-container-shadow |
+| container.border.radius | Controls the corner rounding of message containers (notification boxes). This makes the message appear with rounded corners instead of sharp edges for a softer appearance.<br>CSS variable: --wm-message-container-border-radius |
+| container.border.width | Controls the thickness of the outline around message containers (notification boxes). This creates a colored border around the message to define its boundaries.<br>CSS variable: --wm-message-container-border-width |
+| container.border.style | Controls the style of the outline around message containers. 'solid' creates a continuous line, 'dashed' creates a dotted line, 'dotted' creates small dots, 'none' removes the border.<br>CSS variable: --wm-message-container-border-style |
+| container.border.color | Sets the color of the outline around message containers (notification boxes). This creates a colored border around the message to define its boundaries.<br>CSS variable: --wm-message-container-border-color |
+| container.padding | Controls the internal spacing inside message containers (the space between the message content and the container border). This creates breathing room around the message text and icons.<br>CSS variable: --wm-message-container-padding |
+| container.gap | Controls the spacing between elements within message containers (like between icons and text, or between text and close buttons). This creates visual separation between different parts of the message.<br>CSS variable: --wm-message-container-gap |
+| container.background | Sets the background color of message containers (notification boxes). This is the main background color that appears behind the message content.<br>CSS variable: --wm-message-container-background |
+| container.color | Sets the text color of message containers (the color of the message text). This should contrast well with the background color for readability.<br>CSS variable: --wm-message-container-color |
+| font-family | Sets the typeface (font style) for message text. This determines whether the message text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-message-font-family |
+| font-weight | Controls how thick or bold message text appears. 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-message-font-weight |
+| font-size | Controls how large message text appears. Larger values make the message more prominent and easier to read, while smaller values make it more subtle.<br>CSS variable: --wm-message-font-size |
+| line-height | Controls the vertical spacing between lines when message text wraps to multiple lines. Higher values create more space between lines for better readability.<br>CSS variable: --wm-message-line-height |
+| letter-spacing | Controls the horizontal spacing between individual letters in message text. Positive values spread letters apart, negative values bring them closer together.<br>CSS variable: --wm-message-letter-spacing |

package/src/tokens/web/components/message/message.json

@@ -52,7 +52,8 @@
           "value": "{elevation.shadow.3.value}",
           "type": "radius",
           "attributes": {
-            "subtype": "elevation"
+            "subtype": "elevation",
+            "description": "Controls the drop shadow effect around message containers (notification boxes that show alerts, warnings, or success messages). This creates a subtle shadow that makes the message appear to float above the background.<br>CSS variable: --wm-message-container-shadow"
           }
         },
         "border": {
@@ -60,28 +61,32 @@
             "value": "{radius.xs.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "radius"
+              "subtype": "radius",
+              "description": "Controls the corner rounding of message containers (notification boxes). This makes the message appear with rounded corners instead of sharp edges for a softer appearance.<br>CSS variable: --wm-message-container-border-radius"
             }
           },
           "width": {
             "value": "{border.width.base.value}",
             "type": "space",
             "attributes": {
-              "subtype": "border-width"
+              "subtype": "border-width",
+              "description": "Controls the thickness of the outline around message containers (notification boxes). This creates a colored border around the message to define its boundaries.<br>CSS variable: --wm-message-container-border-width"
             }
           },
           "style": {
             "value": "{border.style.base.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "border-style"
+              "subtype": "border-style",
+              "description": "Controls the style of the outline around message containers. 'solid' creates a continuous line, 'dashed' creates a dotted line, 'dotted' creates small dots, 'none' removes the border.<br>CSS variable: --wm-message-container-border-style"
             }
           },
           "color": {
             "value": "{color.primary.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the color of the outline around message containers (notification boxes). This creates a colored border around the message to define its boundaries.<br>CSS variable: --wm-message-container-border-color"
             }
           }
         },
@@ -89,28 +94,32 @@
           "value": "{space.3.value} {space.4.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing inside message containers (the space between the message content and the container border). This creates breathing room around the message text and icons.<br>CSS variable: --wm-message-container-padding"
           }
         },
         "gap": {
           "value": "{space.3.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the spacing between elements within message containers (like between icons and text, or between text and close buttons). This creates visual separation between different parts of the message.<br>CSS variable: --wm-message-container-gap"
           }
         },
         "background": {
           "value": "{color.primary.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the background color of message containers (notification boxes). This is the main background color that appears behind the message content.<br>CSS variable: --wm-message-container-background"
           }
         },
         "color": {
           "value": "{color.on-primary.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the text color of message containers (the color of the message text). This should contrast well with the background color for readability.<br>CSS variable: --wm-message-container-color"
           }
         }
       },
@@ -118,35 +127,40 @@
         "value": "{label.large.font-family.value}",
         "type": "font",
         "attributes": {
-          "subtype": "font-family"
+          "subtype": "font-family",
+          "description": "Sets the typeface (font style) for message text. This determines whether the message text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-message-font-family"
         }
       },
       "font-weight": {
         "value": "{label.large.font-weight.value}",
         "type": "font",
         "attributes": {
-          "subtype": "font-weight"
+          "subtype": "font-weight",
+          "description": "Controls how thick or bold message text appears. 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-message-font-weight"
         }
       },
       "font-size": {
         "value": "{label.large.font-size.value}",
         "type": "font",
         "attributes": {
-          "subtype": "font-size"
+          "subtype": "font-size",
+          "description": "Controls how large message text appears. Larger values make the message more prominent and easier to read, while smaller values make it more subtle.<br>CSS variable: --wm-message-font-size"
         }
       },
       "line-height": {
         "value": "{label.large.line-height.value}",
         "type": "font",
         "attributes": {
-          "subtype": "line-height"
+          "subtype": "line-height",
+          "description": "Controls the vertical spacing between lines when message text wraps to multiple lines. Higher values create more space between lines for better readability.<br>CSS variable: --wm-message-line-height"
         }
       },
       "letter-spacing": {
         "value": "{label.large.letter-spacing.value}",
         "type": "font",
         "attributes": {
-          "subtype": "letter-spacing"
+          "subtype": "letter-spacing",
+          "description": "Controls the horizontal spacing between individual letters in message text. Positive values spread letters apart, negative values bring them closer together.<br>CSS variable: --wm-message-letter-spacing"
         }
       }
     },
@@ -295,4 +309,4 @@
       }
     }
   }
-}
+}

package/src/tokens/web/components/modal-dialog/Token.Readme.md

@@ -0,0 +1,31 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| align-items | Controls the vertical alignment of modal dialogs (pop-up windows that appear over the main content). 'center' positions the modal in the middle of the screen vertically, 'flex-start' positions it at the top, 'flex-end' positions it at the bottom, and 'stretch' makes it fill the full height.<br>CSS variable: --wm-modal-align-items |
+| justify-content | Controls the horizontal alignment of modal dialogs (pop-up windows that appear over the main content). 'center' positions the modal in the middle of the screen horizontally, 'flex-start' positions it at the left, 'flex-end' positions it at the right, and 'space-between'/'space-around' distributes space around the modal.<br>CSS variable: --wm-modal-justify-content |
+| margin | Controls the margin around modal dialogs (pop-up windows that appear over the main content). This creates space between the modal and the edges of the screen, ensuring the modal doesn't touch the screen edges.<br>CSS variable: --wm-modal-margin |
+| backdrop.opacity | Controls the transparency of the modal backdrop (the dark overlay that appears behind modal dialogs). This determines how much the background content is dimmed when a modal is open.<br>CSS variable: --wm-modal-backdrop-opacity |
+| backdrop.background | Sets the background color of the modal backdrop (the dark overlay that appears behind modal dialogs). This is the color that dims the background content when a modal is open.<br>CSS variable: --wm-modal-backdrop-background |
+| backdrop.z-index | Controls the stacking order of the modal backdrop (the dark overlay that appears behind modal dialogs). Higher values make the backdrop appear above other elements, ensuring it covers the background content.<br>CSS variable: --wm-modal-backdrop-z-index |
+| z-index | Controls the stacking order of modal dialogs (pop-up windows that appear over the main content). Higher values make the modal appear above other elements, ensuring it's visible on top of all other content.<br>CSS variable: --wm-modal-z-index |
+| width | Controls how wide modal dialogs appear (pop-up windows that appear over the main content). This determines the horizontal size of the modal window that users interact with.<br>CSS variable: --wm-modal-width |
+| height | Controls how tall modal dialogs appear (pop-up windows that appear over the main content). 'auto' lets the modal size itself based on its content, while specific values (px, %, em, rem, vh) set a fixed height.<br>CSS variable: --wm-modal-height |
+| background | Sets the background color of modal dialogs (pop-up windows that appear over the main content). This is the main background color that appears behind the modal content.<br>CSS variable: --wm-modal-background |
+| radius | Controls the corner rounding of modal dialogs (pop-up windows that appear over the main content). This makes the modal appear with rounded corners for a softer appearance.<br>CSS variable: --wm-modal-radius |
+| header.padding | Controls the internal spacing inside modal headers (the top section of modal dialogs that contains the title and close button). This creates breathing room around the header content.<br>CSS variable: --wm-modal-header-padding |
+| title.gap | Controls the spacing between title elements in modal dialogs (like the space between the title text and any icons). This creates visual separation between different parts of the modal title.<br>CSS variable: --wm-modal-title-gap |
+| title.font-size | Controls how large the modal titles appear (the main heading text in modal dialogs). This affects the size of the title text that users see in the modal header.<br>CSS variable: --wm-modal-title-font-size |
+| title.font-family | Sets the typeface (font style) for modal titles (the main heading text in modal dialogs). This determines whether the title text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-modal-title-font-family |
+| title.font-weight | Controls how thick or bold the modal titles appear (the main heading text in modal dialogs). 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-modal-title-font-weight |
+| title.line-height | Controls the vertical spacing between lines when modal titles wrap to multiple lines. This ensures proper spacing for the title text displayed in the modal header.<br>CSS variable: --wm-modal-title-line-height |
+| title.letter-spacing | Controls the horizontal spacing between individual characters in modal titles. This can help make the title text more readable and properly spaced.<br>CSS variable: --wm-modal-title-letter-spacing |
+| body.padding | Controls the internal spacing inside modal body content (the main content area of modal dialogs). This creates breathing room around the modal content.<br>CSS variable: --wm-modal-body-padding |
+| footer.padding | Controls the internal spacing inside modal footers (the bottom section of modal dialogs that contains action buttons). This creates breathing room around the footer content.<br>CSS variable: --wm-modal-footer-padding |
+| footer.gap | Controls the spacing between footer elements in modal dialogs (like the space between action buttons). This creates visual separation between different footer elements.<br>CSS variable: --wm-modal-footer-gap |
+| login.dialog.form.body.padding | Controls padding of login dialog form body.<br>CSS variable: --wm-modal-login-dialog-form-body-padding |
+| login.dialog.form.elements.gap | Controls spacing between login dialog form elements.<br>CSS variable: --wm-modal-login-dialog-form-elements-gap |

package/src/tokens/web/components/modal-dialog/modal-dialog.json

@@ -81,21 +81,24 @@
         "value": "center",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls the vertical alignment of modal dialogs (pop-up windows that appear over the main content). 'center' positions the modal in the middle of the screen vertically, 'flex-start' positions it at the top, 'flex-end' positions it at the bottom, and 'stretch' makes it fill the full height.<br>CSS variable: --wm-modal-align-items"
         }
       },
       "justify-content": {
         "value": "center",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls the horizontal alignment of modal dialogs (pop-up windows that appear over the main content). 'center' positions the modal in the middle of the screen horizontally, 'flex-start' positions it at the left, 'flex-end' positions it at the right, and 'space-between'/'space-around' distributes space around the modal.<br>CSS variable: --wm-modal-justify-content"
         }
       },
       "margin": {
         "value": "{space.6.value}",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls the margin around modal dialogs (pop-up windows that appear over the main content). This creates space between the modal and the edges of the screen, ensuring the modal doesn't touch the screen edges.<br>CSS variable: --wm-modal-margin"
         }
       },
       "backdrop": {
@@ -103,21 +106,24 @@
           "value": "50%",
           "type": "radius",
           "attributes": {
-            "subtype": "radius"
+            "subtype": "radius",
+            "description": "Controls the transparency of the modal backdrop (the dark overlay that appears behind modal dialogs). This determines how much the background content is dimmed when a modal is open.<br>CSS variable: --wm-modal-backdrop-opacity"
           }
         },
         "background": {
           "value": "{color.scrim.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the background color of the modal backdrop (the dark overlay that appears behind modal dialogs). This is the color that dims the background content when a modal is open.<br>CSS variable: --wm-modal-backdrop-background"
           }
         },
         "z-index": {
           "value": "999",
           "type": "radius",
           "attributes": {
-            "subtype": "elevation"
+            "subtype": "elevation",
+            "description": "Controls the stacking order of the modal backdrop (the dark overlay that appears behind modal dialogs). Higher values make the backdrop appear above other elements, ensuring it covers the background content.<br>CSS variable: --wm-modal-backdrop-z-index"
           }
         }
       },
@@ -125,35 +131,40 @@
         "value": "1000",
         "type": "radius",
         "attributes": {
-          "subtype": "elevation"
+          "subtype": "elevation",
+          "description": "Controls the stacking order of modal dialogs (pop-up windows that appear over the main content). Higher values make the modal appear above other elements, ensuring it's visible on top of all other content.<br>CSS variable: --wm-modal-z-index"
         }
       },
       "width": {
         "value": "600px",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls how wide modal dialogs appear (pop-up windows that appear over the main content). This determines the horizontal size of the modal window that users interact with.<br>CSS variable: --wm-modal-width"
         }
       },
       "height": {
         "value": "auto",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls how tall modal dialogs appear (pop-up windows that appear over the main content). 'auto' lets the modal size itself based on its content, while specific values (px, %, em, rem, vh) set a fixed height.<br>CSS variable: --wm-modal-height"
         }
       },
       "background": {
         "value": "{color.surface.container.high.@.value}",
         "type": "color",
         "attributes": {
-          "subtype": "color"
+          "subtype": "color",
+          "description": "Sets the background color of modal dialogs (pop-up windows that appear over the main content). This is the main background color that appears behind the modal content.<br>CSS variable: --wm-modal-background"
         }
       },
       "radius": {
         "value": "{radius.lg.value}",
         "type": "radius",
         "attributes": {
-          "subtype": "radius"
+          "subtype": "radius",
+          "description": "Controls the corner rounding of modal dialogs (pop-up windows that appear over the main content). This makes the modal appear with rounded corners for a softer appearance.<br>CSS variable: --wm-modal-radius"
         }
       },
       "header": {
@@ -161,7 +172,8 @@
           "value": "{space.6.value} {space.4.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing inside modal headers (the top section of modal dialogs that contains the title and close button). This creates breathing room around the header content.<br>CSS variable: --wm-modal-header-padding"
           }
         }
       },
@@ -170,42 +182,48 @@
           "value": "{space.1.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the spacing between title elements in modal dialogs (like the space between the title text and any icons). This creates visual separation between different parts of the modal title.<br>CSS variable: --wm-modal-title-gap"
           }
         },
         "font-size": {
           "value": "{h3.font-size.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-size"
+            "subtype": "font-size",
+            "description": "Controls how large the modal titles appear (the main heading text in modal dialogs). This affects the size of the title text that users see in the modal header.<br>CSS variable: --wm-modal-title-font-size"
           }
         },
         "font-family": {
           "value": "{h3.font-family.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-family"
+            "subtype": "font-family",
+            "description": "Sets the typeface (font style) for modal titles (the main heading text in modal dialogs). This determines whether the title text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-modal-title-font-family"
           }
         },
         "font-weight": {
           "value": "{h3.font-weight.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-weight"
+            "subtype": "font-weight",
+            "description": "Controls how thick or bold the modal titles appear (the main heading text in modal dialogs). 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-modal-title-font-weight"
           }
         },
         "line-height": {
           "value": "{h3.line-height.value}",
           "type": "font",
           "attributes": {
-            "subtype": "line-height"
+            "subtype": "line-height",
+            "description": "Controls the vertical spacing between lines when modal titles wrap to multiple lines. This ensures proper spacing for the title text displayed in the modal header.<br>CSS variable: --wm-modal-title-line-height"
           }
         },
         "letter-spacing": {
           "value": "{h3.letter-spacing.value}",
           "type": "font",
           "attributes": {
-            "subtype": "letter-spacing"
+            "subtype": "letter-spacing",
+            "description": "Controls the horizontal spacing between individual characters in modal titles. This can help make the title text more readable and properly spaced.<br>CSS variable: --wm-modal-title-letter-spacing"
           }
         }
       },
@@ -214,7 +232,8 @@
           "value": "{space.6.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing inside modal body content (the main content area of modal dialogs). This creates breathing room around the modal content.<br>CSS variable: --wm-modal-body-padding"
           }
         }
       },
@@ -223,14 +242,16 @@
           "value": "{space.6.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing inside modal footers (the bottom section of modal dialogs that contains action buttons). This creates breathing room around the footer content.<br>CSS variable: --wm-modal-footer-padding"
           }
         },
         "gap": {
           "value": "{space.3.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the spacing between footer elements in modal dialogs (like the space between action buttons). This creates visual separation between different footer elements.<br>CSS variable: --wm-modal-footer-gap"
           }
         }
       },
@@ -242,7 +263,8 @@
                 "value": "{space.1.value}",
                 "type": "space",
                 "attributes": {
-                  "subtype": "space"
+                  "subtype": "space",
+                  "description": "Controls padding of login dialog form body.<br>CSS variable: --wm-modal-login-dialog-form-body-padding"
                 }
               }
             },
@@ -251,7 +273,8 @@
                 "value": "{space.2.value}",
                 "type": "space",
                 "attributes": {
-                  "subtype": "space"
+                  "subtype": "space",
+                  "description": "Controls spacing between login dialog form elements.<br>CSS variable: --wm-modal-login-dialog-form-elements-gap"
                 }
               }
             }
@@ -436,4 +459,4 @@
       }
     }
   }
-}
+}

package/src/tokens/web/components/nav/Token.Readme.md

@@ -0,0 +1,25 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| background | Sets the background color of navigation components (menus and navigation bars that help users move around the application). This is the main background color that appears behind the navigation items.<br>CSS variable: --wm-nav-background |
+| margin | Controls the external spacing around the navigation component (space outside the nav container). This separates the navigation from surrounding content.<br>CSS variable: --wm-nav-margin |
+| padding | Controls the internal spacing inside navigation components (the space between the navigation content and its borders). This creates breathing room around the navigation items.<br>CSS variable: --wm-nav-padding |
+| border.radius | Controls the corner rounding of navigation items (individual menu options and links). This makes the navigation items appear with rounded corners for a softer appearance.<br>CSS variable: --wm-nav-item-radius |
+| border.width | Controls the border thickness of the navigation container. Higher values create thicker borders.<br>CSS variable: --wm-nav-border-width |
+| border.style | Controls the border style of the navigation container. Allowed values: solid, dashed, dotted, none.<br>CSS variable: --wm-nav-border-style |
+| border.color | Sets the border color of the navigation container. Use a color that contrasts the background for visibility.<br>CSS variable: --wm-nav-border-color |
+| shadow | Controls the drop shadow of the navigation container to create depth. Use to lift the nav above the page background.<br>CSS variable: --wm-nav-shadow |
+| item.background | Sets the background color of individual navigation items (links/menu options).<br>CSS variable: --wm-nav-item-background |
+| item.margin | Controls the external spacing around each navigation item (space between adjacent items).<br>CSS variable: --wm-nav-item-margin |
+| item.padding | Controls the internal spacing inside each navigation item (space around the text/icon inside the item).<br>CSS variable: --wm-nav-item-padding |
+| item.border.radius | Controls the corner rounding of each navigation item. Use higher values for rounded chips/pills.<br>CSS variable: --wm-nav-item-border-radius |
+| item.border.width | Controls the border thickness of each navigation item.<br>CSS variable: --wm-nav-item-border-width |
+| item.border.style | Controls the border style of each navigation item. Allowed values: solid, dashed, dotted, none.<br>CSS variable: --wm-nav-item-border-style |
+| item.border.color | Sets the border color of each navigation item.<br>CSS variable: --wm-nav-item-border-color |
+| item.shadow | Controls the drop shadow of navigation items to add depth and focus.<br>CSS variable: --wm-nav-item-shadow |
+| item.caret.size | Controls the size of the caret indicator shown on items that open a submenu (the small triangle/arrow).<br>CSS variable: --wm-nav-item-caret-size |