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

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

@@ -40,7 +40,8 @@
         "value": "{space.1.value}",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls the horizontal spacing between the checkbox box (the square input element) and the label text. This creates visual separation so users can easily distinguish between the clickable checkbox and its descriptive text.<br>CSS variable: --wm-checkbox-gap"
         }
       },
       "caption": {
@@ -48,35 +49,40 @@
           "value": "{body.large.font-size.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-size"
+            "subtype": "font-size",
+            "description": "Controls the size of the checkbox label text (the descriptive text that appears next to the checkbox). This text explains what the checkbox option represents, such as 'I agree to terms' or 'Subscribe to newsletter'.<br>CSS variable: --wm-checkbox-caption-font-size"
           }
         },
         "font-family": {
           "value": "{body.large.font-family.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-family"
+            "subtype": "font-family",
+            "description": "Sets the font family (typeface) for the checkbox label text. This determines the visual style of the text that describes what the checkbox option represents.<br>CSS variable: --wm-checkbox-caption-font-family"
           }
         },
         "font-weight": {
           "value": "{body.large.font-weight.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-weight"
+            "subtype": "font-weight",
+            "description": "Controls the thickness/boldness of the checkbox label text. Acceptable values: normal, bold, 100-900. This affects how prominent the descriptive text appears next to the checkbox.<br>CSS variable: --wm-checkbox-caption-font-weight"
           }
         },
         "line-height": {
           "value": "{body.large.line-height.value}",
           "type": "font",
           "attributes": {
-            "subtype": "line-height"
+            "subtype": "line-height",
+            "description": "Controls the vertical spacing between lines of text in the checkbox label. This is important when the label text wraps to multiple lines, ensuring proper readability.<br>CSS variable: --wm-checkbox-caption-line-height"
           }
         },
         "letter-spacing": {
           "value": "{body.large.letter-spacing.value}",
           "type": "font",
           "attributes": {
-            "subtype": "letter-spacing"
+            "subtype": "letter-spacing",
+            "description": "Controls the horizontal spacing between individual characters in the checkbox label text. Positive values spread letters apart, negative values bring them closer together.<br>CSS variable: --wm-checkbox-caption-letter-spacing"
           }
         }
       },
@@ -84,7 +90,8 @@
         "value": "18px",
         "type": "space",
         "attributes": {
-          "subtype": "space"
+          "subtype": "space",
+          "description": "Controls the width and height of the checkbox box (the square input element that users click to check/uncheck). This determines how large the actual checkbox appears visually. Acceptable units: px, em, rem.<br>CSS variable: --wm-checkbox-size"
         }
       },
       "icon": {
@@ -92,14 +99,16 @@
           "value": "10px",
           "type": "space",
           "attributes": {
-            "subtype": "icon-size"
+            "subtype": "icon-size",
+            "description": "Controls the size of the checkmark icon (the ✓ symbol) that appears inside the checkbox when it's checked. This icon is typically smaller than the checkbox box itself to fit nicely inside. Acceptable units: px, em, rem.<br>CSS variable: --wm-checkbox-icon-size"
           }
         },
         "color": {
           "value": "{color.on-primary.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the color of the checkmark icon (the ✓ symbol) that appears inside the checkbox when it's checked. This is typically a contrasting color to ensure the checkmark is clearly visible against the checkbox background.<br>CSS variable: --wm-checkbox-icon-color"
           }
         }
       },
@@ -107,7 +116,8 @@
         "value": "{color.transparent.value}",
         "type": "color",
         "attributes": {
-          "subtype":"color"
+          "subtype": "color",
+          "description": "Sets the background color of the checkbox box (the square input element). When transparent, only the border is visible. When filled with a color, the checkbox appears solid. This affects the visual appearance of the unchecked state.<br>CSS variable: --wm-checkbox-background"
         }
       },
       "border": {
@@ -115,21 +125,24 @@
           "value": "2px",
           "type": "space",
           "attributes": {
-            "subtype": "border-width"
+            "subtype": "border-width",
+            "description": "Controls the thickness of the border around the checkbox box (the square input element). This creates the outline that defines the checkbox shape and makes it visible to users.<br>CSS variable: --wm-checkbox-border-width"
           }
         },
         "color": {
           "value": "{color.on-surface.variant.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the color of the border around the checkbox box (the square input element). This determines the color of the outline that defines the checkbox shape in its default/unchecked state.<br>CSS variable: --wm-checkbox-border-color"
           }
         },
         "radius": {
           "value": "{radius.xxs.value}",
           "type": "radius",
           "attributes": {
-            "subtype": "radius"
+            "subtype": "radius",
+            "description": "Controls the corner rounding of the checkbox box (the square input element). Small values create slightly rounded corners, while larger values make the checkbox more rounded or even circular.<br>CSS variable: --wm-checkbox-border-radius"
           }
         }
       },
@@ -139,21 +152,24 @@
             "value": "40px",
             "type": "space",
             "attributes": {
-              "subtype": "space"
+              "subtype": "space",
+              "description": "Controls the size of the invisible clickable area around the checkbox (the state layer). This area is larger than the visible checkbox box, making it easier for users to click and interact with the checkbox. Acceptable units: px, em, rem.<br>CSS variable: --wm-checkbox-state-layer-size"
             }
           },
           "color": {
             "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 the checkbox. This creates visual feedback to show that the checkbox is interactive and responsive to user actions.<br>CSS variable: --wm-checkbox-state-layer-color"
             }
           },
           "opacity": {
             "value": "0",
             "type": "color",
             "attributes": {
-              "subtype": "opacity"
+              "subtype": "opacity",
+              "description": "Controls the transparency of the state layer that appears during user interactions (hover, focus, active). When set to 0, the state layer is invisible. Higher values make the interaction feedback more visible.<br>CSS variable: --wm-checkbox-state-layer-opacity"
             }
           }
         }
@@ -166,7 +182,8 @@
                 "value": "{opacity.hover.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "opacity"
+                  "subtype": "opacity",
+                  "description": "Controls the opacity of the state layer when users hover their mouse over the checkbox. This creates a subtle visual feedback effect to indicate that the checkbox is interactive and ready to be clicked.<br>CSS variable: --wm-checkbox-state-layer-opacity (hover state)"
                 }
               }
             }
@@ -179,7 +196,8 @@
                 "value": "{opacity.focus.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "opacity"
+                  "subtype": "opacity",
+                  "description": "Controls the opacity of the state layer when the checkbox receives keyboard focus (when users navigate to it using Tab key). This provides visual feedback for keyboard navigation accessibility.<br>CSS variable: --wm-checkbox-state-layer-opacity (focus state)"
                 }
               }
             }
@@ -192,7 +210,8 @@
                 "value": "{opacity.active.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "opacity"
+                  "subtype": "opacity",
+                  "description": "Controls the opacity of the state layer when users are actively clicking/pressing the checkbox. This provides immediate visual feedback during the click interaction.<br>CSS variable: --wm-checkbox-state-layer-opacity (active state)"
                 }
               }
             }
@@ -205,7 +224,8 @@
                 "value": "{color.primary.@.value}",
                 "type": "color",
                 "attributes": {
-                  "subtype": "color"
+                  "subtype": "color",
+                  "description": "Sets the color of the state layer when the checkbox is checked. This creates a colored background effect to emphasize the selected/checked state of the checkbox.<br>CSS variable: --wm-checkbox-state-layer-color (checked state)"
                 }
               }
             }
@@ -214,7 +234,8 @@
             "value": "{color.primary.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the background color of the checkbox box when it's checked. This fills the checkbox with a color to visually indicate that the option has been selected.<br>CSS variable: --wm-checkbox-background (checked state)"
             }
           },
           "border": {
@@ -222,7 +243,8 @@
               "value": "{color.primary.@.value}",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the border color of the checkbox box when it's checked. This changes the outline color to match the checked state, creating a cohesive visual appearance.<br>CSS variable: --wm-checkbox-border-color (checked state)"
               }
             }
           },
@@ -231,7 +253,8 @@
               "value": "{color.on-primary.@.value}",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the color of the checkmark icon (✓) when the checkbox is checked. This ensures the checkmark is clearly visible against the colored background of the checked checkbox.<br>CSS variable: --wm-checkbox-icon-color (checked state)"
               }
             }
           }
@@ -240,4 +263,4 @@
     },
     "appearances": {}
   }
-}
+}

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

@@ -0,0 +1,9 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| item.gap | Controls the horizontal spacing between individual checkbox options in a checkbox set (a group of related checkboxes like 'Select all', 'Option 1', 'Option 2'). This creates visual separation between each checkbox option.<br>CSS variable: --wm-checkboxset-item-gap |

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

@@ -7,7 +7,8 @@
           "value": "{space.6.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the horizontal spacing between individual checkbox options in a checkbox set (a group of related checkboxes like 'Select all', 'Option 1', 'Option 2'). This creates visual separation between each checkbox option.<br>CSS variable: --wm-checkboxset-item-gap"
           }
         }
       }

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

@@ -0,0 +1,43 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| border.width | Controls the border width of the main chips container (the wrapper that holds all chips and the input field). This creates the outline around the entire chips component.<br>CSS variable: --wm-chips-border-width |
+| background | Sets the background color of the main chips container (the wrapper that holds all chips and the input field). When set to 'none', the container has no background color.<br>CSS variable: --wm-chips-background |
+| color | Sets the text color of individual chip items (the small pill-shaped elements). This affects the color of the text content inside each chip, not the container.<br>CSS variable: --wm-chips-color |
+| opacity | Controls the overall transparency of the chips component. When set to 1, the component is fully opaque. Lower values make the entire component more transparent.<br>CSS variable: --wm-chips-opacity |
+| cursor | Controls the mouse cursor style when hovering over the chips component. Acceptable values: pointer (hand cursor), default (arrow), not-allowed (blocked cursor).<br>CSS variable: --wm-chips-cursor |
+| pointer-events | Controls whether the chips component can receive mouse/touch interactions. Acceptable values: all (fully interactive), none (not clickable), auto (browser default).<br>CSS variable: --wm-chips-pointer-events |
+| shadow | Controls the drop shadow effect around the main chips container. This creates a subtle elevation effect that makes the chips component appear to float above the background.<br>CSS variable: --wm-chips-shadow |
+| list.gap | Controls the horizontal spacing between individual chip items (the small pill-shaped elements) within the chips container. This creates visual separation between each chip so users can easily distinguish between them.<br>CSS variable: --wm-chips-list-gap |
+| list.icon.size | Controls the size of icons that appear within the chips container (like search icons or action icons). This affects icons that are part of the chips component interface, not icons inside individual chips.<br>CSS variable: --wm-chips-list-icon-size |
+| list.padding | Controls the internal spacing (padding) around the chips container (the wrapper that holds all chips and the input field). This creates breathing room between the container border and the chips/input inside.<br>CSS variable: --wm-chips-list-padding |
+| list.background | Sets the background color of the chips container (the wrapper that holds all chips and the input field). When set to 'none', the container has no background color, making it transparent.<br>CSS variable: --wm-chips-list-background |
+| list.border.width | Controls the thickness of the border around the chips container (the wrapper that holds all chips and the input field). This creates the outline that defines the container shape.<br>CSS variable: --wm-chips-list-border-width |
+| list.border.style | Controls the border style of the chips container. Acceptable values: solid (continuous line), dashed (dotted line), dotted (small dots), none (no border).<br>CSS variable: --wm-chips-list-border-style |
+| list.border.color | Sets the color of the border around the chips container (the wrapper that holds all chips and the input field). This determines the color of the outline that defines the container shape.<br>CSS variable: --wm-chips-list-border-color |
+| list.border.radius | Controls the corner rounding of the chips container (the wrapper that holds all chips and the input field). This makes the container appear with rounded corners instead of sharp edges.<br>CSS variable: --wm-chips-list-border-radius |
+| list.height | Controls the minimum height of the chips container (the wrapper that holds all chips and the input field). This ensures the container has a consistent height even when empty or with few chips.<br>CSS variable: --wm-chips-list-height |
+| input.padding | Controls the internal spacing (padding) around the input field where users type to add new chips. This creates breathing room between the input text and the input field border.<br>CSS variable: --wm-chips-input-padding |
+| item.height | Controls the height of individual chip items (the small pill-shaped elements). This determines how tall each chip appears visually. Acceptable units: px, em, rem.<br>CSS variable: --wm-chips-item-height |
+| item.padding | Controls the internal spacing (padding) around the content inside each chip item. This creates breathing room between the chip text/icon and the chip border.<br>CSS variable: --wm-chips-item-padding |
+| item.gap | Controls the spacing between elements within individual chip items (like between text and icons, or between text and the remove button). This creates visual separation between different parts of each chip.<br>CSS variable: --wm-chips-item-gap |
+| item.border.width | Controls the thickness of the border around individual chip items (the small pill-shaped elements). This creates the outline that defines each chip's shape.<br>CSS variable: --wm-chips-item-border-width |
+| item.border.style | Controls the border style of individual chip items. Acceptable values: solid (continuous line), dashed (dotted line), dotted (small dots), none (no border).<br>CSS variable: --wm-chips-item-border-style |
+| item.border.color | Sets the color of the border around individual chip items (the small pill-shaped elements). This determines the color of the outline that defines each chip's shape.<br>CSS variable: --wm-chips-item-border-color |
+| item.border.radius.@ | Controls the corner rounding of individual chip items (the small pill-shaped elements). This makes each chip appear with rounded corners instead of sharp edges.<br>CSS variable: --wm-chips-item-border-radius |
+| item.border.radius.with.icon | Controls the corner rounding of chip items that contain icons. This creates a specific rounded appearance for chips with icon content.<br>CSS variable: --wm-chips-item-border-radius-with-icon |
+| item.border.radius.with.avatar | Controls the corner rounding of chip items that contain user avatars. This creates a pill-shaped appearance for chips with avatar content.<br>CSS variable: --wm-chips-item-border-radius-with-avatar |
+| item.font-family | Sets the font family (typeface) for the text content inside individual chip items (the small pill-shaped elements). This determines the visual style of the text that appears within each chip.<br>CSS variable: --wm-chips-item-font-family |
+| item.font-weight | Controls the thickness/boldness of the text content inside individual chip items. Acceptable values: normal, bold, 100-900. This affects how prominent the text appears within each chip.<br>CSS variable: --wm-chips-item-font-weight |
+| item.font-size | Controls the size of the text content inside individual chip items (the small pill-shaped elements). This determines how large the text appears within each chip.<br>CSS variable: --wm-chips-item-font-size |
+| item.line-height | Controls the vertical spacing between lines of text inside individual chip items. This is important when chip text wraps to multiple lines, ensuring proper readability.<br>CSS variable: --wm-chips-item-line-height |
+| item.letter-spacing | Controls the horizontal spacing between individual characters in the text content inside chip items. Positive values spread letters apart, negative values bring them closer together.<br>CSS variable: --wm-chips-item-letter-spacing |
+| item.layer.color | Sets the color of the state layer that appears when users hover, focus, or interact with individual chip items. This creates visual feedback to show that chips are interactive and responsive to user actions.<br>CSS variable: --wm-chips-item-layer-color |
+| item.layer.opacity | Controls the transparency of the state layer that appears during user interactions with individual chip 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-chips-item-layer-opacity |
+| item.avatar.size | Controls the size of user avatars that appear inside chip items (the small pill-shaped elements). This determines how large profile pictures or user images appear within each chip.<br>CSS variable: --wm-chips-item-avatar-size |
+| item.avatar.radius | Controls the corner rounding of user avatars inside chip items. When set to pill, avatars appear as perfect circles. Other values create rounded rectangles.<br>CSS variable: --wm-chips-item-avatar-radius |

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

@@ -100,7 +100,8 @@
           "value": "{form.mapping.control.border.width.@.value}",
           "type": "radius",
           "attributes": {
-            "subtype": "border-width"
+            "subtype": "border-width",
+            "description": "Controls the border width of the main chips container (the wrapper that holds all chips and the input field). This creates the outline around the entire chips component.<br>CSS variable: --wm-chips-border-width"
           }
         }
       },
@@ -108,42 +109,48 @@
         "value": "none",
         "type": "color",
         "attributes": {
-          "subtype": "color"
+          "subtype": "color",
+          "description": "Sets the background color of the main chips container (the wrapper that holds all chips and the input field). When set to 'none', the container has no background color.<br>CSS variable: --wm-chips-background"
         }
       },
       "color": {
         "value": "{color.on-surface.variant.@.value}",
         "type": "color",
         "attributes": {
-          "subtype": "color"
+          "subtype": "color",
+          "description": "Sets the text color of individual chip items (the small pill-shaped elements). This affects the color of the text content inside each chip, not the container.<br>CSS variable: --wm-chips-color"
         }
       },
       "opacity": {
         "value": "1",
         "type": "radius",
         "attributes": {
-          "subtype": "opacity"
+          "subtype": "opacity",
+          "description": "Controls the overall transparency of the chips component. When set to 1, the component is fully opaque. Lower values make the entire component more transparent.<br>CSS variable: --wm-chips-opacity"
         }
       },
       "cursor": {
         "value": "pointer",
         "type": "radius",
         "attributes": {
-          "subtype": "cursor"
+          "subtype": "cursor",
+          "description": "Controls the mouse cursor style when hovering over the chips component. Acceptable values: pointer (hand cursor), default (arrow), not-allowed (blocked cursor).<br>CSS variable: --wm-chips-cursor"
         }
       },
       "pointer-events": {
         "value": "all",
         "type": "radius",
         "attributes": {
-          "subtype": "pointer-events"
+          "subtype": "pointer-events",
+          "description": "Controls whether the chips component can receive mouse/touch interactions. Acceptable values: all (fully interactive), none (not clickable), auto (browser default).<br>CSS variable: --wm-chips-pointer-events"
         }
       },
       "shadow": {
         "value": "none",
         "type": "radius",
         "attributes": {
-          "subtype": "elevation"
+          "subtype": "elevation",
+          "description": "Controls the drop shadow effect around the main chips container. This creates a subtle elevation effect that makes the chips component appear to float above the background.<br>CSS variable: --wm-chips-shadow"
         }
       },
       "list": {
@@ -151,7 +158,8 @@
           "value": "{space.3.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the horizontal spacing between individual chip items (the small pill-shaped elements) within the chips container. This creates visual separation between each chip so users can easily distinguish between them.<br>CSS variable: --wm-chips-list-gap"
           }
         },
         "icon": {
@@ -159,7 +167,8 @@
             "value": "{icon.size.sm.value}",
             "type": "space",
             "attributes": {
-              "subtype": "icon-size"
+              "subtype": "icon-size",
+              "description": "Controls the size of icons that appear within the chips container (like search icons or action icons). This affects icons that are part of the chips component interface, not icons inside individual chips.<br>CSS variable: --wm-chips-list-icon-size"
             }
           }
         },
@@ -167,14 +176,16 @@
           "value": "{form.mapping.control.padding.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing (padding) around the chips container (the wrapper that holds all chips and the input field). This creates breathing room between the container border and the chips/input inside.<br>CSS variable: --wm-chips-list-padding"
           }
         },
         "background": {
           "value": "none",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the background color of the chips container (the wrapper that holds all chips and the input field). When set to 'none', the container has no background color, making it transparent.<br>CSS variable: --wm-chips-list-background"
           }
         },
         "border": {
@@ -182,28 +193,32 @@
             "value": "{form.mapping.control.border.width.@.value}",
             "type": "space",
             "attributes": {
-              "subtype": "border-width"
+              "subtype": "border-width",
+              "description": "Controls the thickness of the border around the chips container (the wrapper that holds all chips and the input field). This creates the outline that defines the container shape.<br>CSS variable: --wm-chips-list-border-width"
             }
           },
           "style": {
             "value": "{form.mapping.control.border.style.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "border-style"
+              "subtype": "border-style",
+              "description": "Controls the border style of the chips container. Acceptable values: solid (continuous line), dashed (dotted line), dotted (small dots), none (no border).<br>CSS variable: --wm-chips-list-border-style"
             }
           },
           "color": {
             "value": "{form.mapping.control.border.color.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the color of the border around the chips container (the wrapper that holds all chips and the input field). This determines the color of the outline that defines the container shape.<br>CSS variable: --wm-chips-list-border-color"
             }
           },
           "radius": {
             "value": "{form.mapping.control.border.radius.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "radius"
+              "subtype": "radius",
+              "description": "Controls the corner rounding of the chips container (the wrapper that holds all chips and the input field). This makes the container appear with rounded corners instead of sharp edges.<br>CSS variable: --wm-chips-list-border-radius"
             }
           }
         },
@@ -211,7 +226,8 @@
           "value": "{form.mapping.control.height.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the minimum height of the chips container (the wrapper that holds all chips and the input field). This ensures the container has a consistent height even when empty or with few chips.<br>CSS variable: --wm-chips-list-height"
           }
         }
       },
@@ -220,7 +236,8 @@
           "value": "{space.0.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing (padding) around the input field where users type to add new chips. This creates breathing room between the input text and the input field border.<br>CSS variable: --wm-chips-input-padding"
           }
         }
       },
@@ -229,21 +246,24 @@
           "value": "32px",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the height of individual chip items (the small pill-shaped elements). This determines how tall each chip appears visually. Acceptable units: px, em, rem.<br>CSS variable: --wm-chips-item-height"
           }
         },
         "padding": {
           "value": "{space.1.value} {space.3.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing (padding) around the content inside each chip item. This creates breathing room between the chip text/icon and the chip border.<br>CSS variable: --wm-chips-item-padding"
           }
         },
         "gap": {
           "value": "{space.2.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the spacing between elements within individual chip items (like between text and icons, or between text and the remove button). This creates visual separation between different parts of each chip.<br>CSS variable: --wm-chips-item-gap"
           }
         },
         "border": {
@@ -251,21 +271,24 @@
             "value": "{border.width.base.value}",
             "type": "space",
             "attributes": {
-              "subtype": "border-width"
+              "subtype": "border-width",
+              "description": "Controls the thickness of the border around individual chip items (the small pill-shaped elements). This creates the outline that defines each chip's shape.<br>CSS variable: --wm-chips-item-border-width"
             }
           },
           "style": {
             "value": "{border.style.base.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "border-style"
+              "subtype": "border-style",
+              "description": "Controls the border style of individual chip items. Acceptable values: solid (continuous line), dashed (dotted line), dotted (small dots), none (no border).<br>CSS variable: --wm-chips-item-border-style"
             }
           },
           "color": {
             "value": "{color.outline.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the color of the border around individual chip items (the small pill-shaped elements). This determines the color of the outline that defines each chip's shape.<br>CSS variable: --wm-chips-item-border-color"
             }
           },
           "radius": {
@@ -273,7 +296,8 @@
               "value": "{radius.sm.value}",
               "type": "radius",
               "attributes": {
-                "subtype": "radius"
+                "subtype": "radius",
+                "description": "Controls the corner rounding of individual chip items (the small pill-shaped elements). This makes each chip appear with rounded corners instead of sharp edges.<br>CSS variable: --wm-chips-item-border-radius"
               }
             },
             "with": {
@@ -281,14 +305,16 @@
                 "value": "{radius.sm.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "radius"
+                  "subtype": "radius",
+                  "description": "Controls the corner rounding of chip items that contain icons. This creates a specific rounded appearance for chips with icon content.<br>CSS variable: --wm-chips-item-border-radius-with-icon"
                 }
               },
               "avatar": {
                 "value": "{radius.pill.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "radius"
+                  "subtype": "radius",
+                  "description": "Controls the corner rounding of chip items that contain user avatars. This creates a pill-shaped appearance for chips with avatar content.<br>CSS variable: --wm-chips-item-border-radius-with-avatar"
                 }
               }
             }
@@ -298,35 +324,40 @@
           "value": "{label.large.font-family.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-family"
+            "subtype": "font-family",
+            "description": "Sets the font family (typeface) for the text content inside individual chip items (the small pill-shaped elements). This determines the visual style of the text that appears within each chip.<br>CSS variable: --wm-chips-item-font-family"
           }
         },
         "font-weight": {
           "value": "{label.large.font-weight.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-weight"
+            "subtype": "font-weight",
+            "description": "Controls the thickness/boldness of the text content inside individual chip items. Acceptable values: normal, bold, 100-900. This affects how prominent the text appears within each chip.<br>CSS variable: --wm-chips-item-font-weight"
           }
         },
         "font-size": {
           "value": "{label.large.font-size.value}",
           "type": "font",
           "attributes": {
-            "subtype": "font-size"
+            "subtype": "font-size",
+            "description": "Controls the size of the text content inside individual chip items (the small pill-shaped elements). This determines how large the text appears within each chip.<br>CSS variable: --wm-chips-item-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 of text inside individual chip items. This is important when chip text wraps to multiple lines, ensuring proper readability.<br>CSS variable: --wm-chips-item-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 characters in the text content inside chip items. Positive values spread letters apart, negative values bring them closer together.<br>CSS variable: --wm-chips-item-letter-spacing"
           }
         },
         "layer": {
@@ -334,14 +365,16 @@
             "value": "{color.on-surface.variant.@.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 individual chip items. This creates visual feedback to show that chips are interactive and responsive to user actions.<br>CSS variable: --wm-chips-item-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 individual chip 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-chips-item-layer-opacity"
             }
           }
         },
@@ -350,14 +383,16 @@
             "value": "{icon.size.@.value}",
             "type": "space",
             "attributes": {
-              "subtype": "icon-size"
+              "subtype": "icon-size",
+              "description": "Controls the size of user avatars that appear inside chip items (the small pill-shaped elements). This determines how large profile pictures or user images appear within each chip.<br>CSS variable: --wm-chips-item-avatar-size"
             }
           },
           "radius": {
             "value": "{radius.pill.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "radius"
+              "subtype": "radius",
+              "description": "Controls the corner rounding of user avatars inside chip items. When set to pill, avatars appear as perfect circles. Other values create rounded rectangles.<br>CSS variable: --wm-chips-item-avatar-radius"
             }
           }
         }
@@ -615,4 +650,4 @@
       }
     }
   }
-}
+}

package/src/tokens/web/components/color-picker/Token.Readme.md

@@ -0,0 +1,10 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| container.width | Controls how wide the color picker button appears (the small colored square that users click to open the color selection dialog). This determines the size of the color preview button.<br>CSS variable: --wm-color-picker-container-width |
+| container.height | Controls how tall the color picker button appears (the small colored square that users click to open the color selection dialog). This determines the size of the color preview button.<br>CSS variable: --wm-color-picker-container-height |