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

package/src/tokens/mobile/components/icon/icon.json

@@ -61,27 +61,51 @@
     "mapping": {
       "color": {
         "value": "{color.on-background.@.value}",
-        "type": "color"
+        "type": "color",
+        "attributes": {
+          "subtype": "color",
+          "description": "Sets the color of icons (symbols like arrows, hearts, settings, etc.). This determines what color the icon symbols appear in, which should contrast well with the background for visibility.<br>CSS variable: --wm-icon-color"
+        }
       },
       "font-size": {
         "value": "{icon.size.@.value}",
-        "type": "font"
+        "type": "font",
+        "attributes": {
+          "subtype": "icon-size",
+          "description": "Controls how large icon symbols appear (like arrows, hearts, settings, etc.). Larger values make icons more prominent, smaller values make them more subtle.<br>CSS variable: --wm-icon-font-size"
+        }
       },
       "min-width": {
         "value": "{icon.size.@.value}",
-        "type": "space"
+        "type": "space",
+        "attributes": {
+          "subtype": "icon-size",
+          "description": "Controls the minimum width of icon symbols to ensure they're always wide enough to be visible and clickable, even when they contain small symbols.<br>CSS variable: --wm-icon-min-width"
+        }
       },
       "width": {
         "value": "{icon.size.@.value}",
-        "type": "space"
+        "type": "space",
+        "attributes": {
+          "subtype": "icon-size",
+          "description": "Controls how wide icon symbols appear (like arrows, hearts, settings, etc.). This determines the horizontal space each icon takes up.<br>CSS variable: --wm-icon-width"
+        }
       },
       "height": {
         "value": "{icon.size.@.value}",
-        "type": "space"
+        "type": "space",
+        "attributes": {
+          "subtype": "icon-size",
+          "description": "Controls how tall icon symbols appear (like arrows, hearts, settings, etc.). This determines the vertical space each icon takes up.<br>CSS variable: --wm-icon-height"
+        }
       },
       "gap": {
         "value": "{space.1.value}",
-        "type": "space"
+        "type": "space",
+        "attributes": {
+          "subtype": "space",
+          "description": "Controls the spacing between icons and adjacent elements (like text or other icons). This creates visual separation so icons don't appear crowded together.<br>CSS variable: --wm-icon-gap"
+        }
       }
     },
     "appearances": {

package/src/tokens/mobile/components/label/label.json

@@ -155,33 +155,61 @@
     "mapping": {
       "color": {
         "value": "{color.on-surface.@.value}",
-        "type": "color"
+        "type": "color",
+        "attributes": {
+          "subtype": "color",
+          "description": "Sets the text color of labels (text elements that describe or identify other content). This determines what color the label text appears in, which should contrast well with the background for readability.<br>CSS variable: --wm-label-color"
+        }
       },
       "margin": {
         "value": "{space.0.value}",
-        "type": "space"
+        "type": "space",
+        "attributes": {
+          "subtype": "space",
+          "description": "Controls the outer spacing around labels (the space between the label and surrounding elements). This creates breathing room around label text.<br>CSS variable: --wm-label-margin"
+        }
       },
       "asterisk": {
         "color": {
           "value": "{color.error.@.value}",
-          "type": "color"
+          "type": "color",
+          "attributes": {
+            "subtype": "color",
+            "description": "Sets the color of the asterisk symbol (*) that appears in required field labels. This determines what color the asterisk appears in, typically red to indicate required fields.<br>CSS variable: --wm-label-asterisk-color"
+          }
         }
       },
       "padding": {
         "value": "{space.0.value}",
-        "type": "space"
+        "type": "space",
+        "attributes": {
+          "subtype": "space",
+          "description": "Controls the internal spacing inside labels (the space between the label text and its border). This creates breathing room around the label content.<br>CSS variable: --wm-label-padding"
+        }
       },
       "font-size": {
         "value": "{body.large.font-size.value}",
-        "type": "font"
+        "type": "font",
+        "attributes": {
+          "subtype": "font-size",
+          "description": "Controls how large label text appears (text that describes or identifies other content). Larger values make labels more prominent, smaller values make them more subtle.<br>CSS variable: --wm-label-font-size"
+        }
       },
       "font-weight": {
         "value": "{body.medium.font-weight.value}",
-        "type": "font"
+        "type": "font",
+        "attributes": {
+          "subtype": "font-weight",
+          "description": "Controls how thick or bold label text appears. 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-label-font-weight"
+        }
       },
       "font-family": {
         "value": "{body.medium.font-family.value}",
-        "type": "font"
+        "type": "font",
+        "attributes": {
+          "subtype": "font-family",
+          "description": "Sets the typeface (font style) for label text. This determines whether the label text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-label-font-family"
+        }
       }
     },
     "appearances": {
@@ -340,28 +368,52 @@
           "padding": {
             "left": {
               "value": "{space.8.value}",
-              "type": "space"
+              "type": "space",
+              "attributes": {
+                "subtype": "space",
+                "description": "Controls the left padding (horizontal spacing) inside label badges (colored label containers). This creates breathing room on the left side of the label content. Acceptable units: px.<br>CSS variable: --wm-label-padding-left"
+              }
             },
             "right": {
               "value": "{space.8.value}",
-              "type": "space"
+              "type": "space",
+              "attributes": {
+                "subtype": "space",
+                "description": "Controls the right padding (horizontal spacing) inside label badges (colored label containers). This creates breathing room on the right side of the label content. Acceptable units: px.<br>CSS variable: --wm-label-padding-right"
+              }
             },
             "top": {
               "value": "{space.4.value}",
-              "type": "space"
+              "type": "space",
+              "attributes": {
+                "subtype": "space",
+                "description": "Controls the top padding (vertical spacing) inside label badges (colored label containers). This creates breathing room above the label content. Acceptable units: px.<br>CSS variable: --wm-label-padding-top"
+              }
             },
             "bottom": {
               "value": "{space.4.value}",
-              "type": "space"
+              "type": "space",
+              "attributes": {
+                "subtype": "space",
+                "description": "Controls the bottom padding (vertical spacing) inside label badges (colored label containers). This creates breathing room below the label content. Acceptable units: px.<br>CSS variable: --wm-label-padding-bottom"
+              }
             }
           },
           "font-weight": {
             "value": "{font.weight.700.value}",
-            "type": "font"
+            "type": "font",
+            "attributes": {
+              "subtype": "font-weight",
+              "description": "Controls how thick or bold label badge text appears. When set to 700, the label text appears bold to emphasize the label badge.<br>CSS variable: --wm-label-font-weight"
+            }
           },
           "border-radius": {
             "value": "6px",
-            "type": "border"
+            "type": "radius",
+            "attributes": {
+              "subtype": "radius",
+              "description": "Controls the corner rounding of label badges (colored label containers). This makes the label badges appear with rounded corners for a softer appearance.<br>CSS variable: --wm-label-border-radius"
+            }
           }
         },
         "variantGroups": {

package/src/tokens/mobile/components/left-nav/left-nav.json

@@ -3,22 +3,38 @@
         "mapping": {
             "min-height": {
                 "type": "space",
-                "value": "100%"
+                "value": "100%",
+                "attributes": {
+                    "subtype": "space",
+                    "description": "Controls the minimum height of the left navigation panel (the side panel that slides in from the left). When set to 100%, the panel takes up the full height of the viewport. Acceptable units: %, px.<br>CSS variable: --wm-left-panel-min-height"
+                }
             },
             "background": {
                 "type": "color",
-                "value": "#ffffff"
+                "value": "#ffffff",
+                "attributes": {
+                    "subtype": "color",
+                    "description": "Sets the background color of the left navigation panel (the side panel that slides in from the left). This is the main background color that appears behind the navigation content.<br>CSS variable: --wm-left-panel-background"
+                }
             },
             "elevation": {
                 "type": "radius",
-                "value": "{elevation.shadow.1.value}"
+                "value": "{elevation.shadow.1.value}",
+                "attributes": {
+                    "subtype": "elevation",
+                    "description": "Controls the drop shadow effect around the left navigation panel. This creates a subtle shadow that makes the panel appear to float above the background, giving it depth and elevation.<br>CSS variable: --wm-left-panel-elevation"
+                }
             },
             "border": {
                 "top": {
                     "right": {
                         "radius": {
                             "type": "radius",
-                            "value": "{radius.lg.value}"
+                            "value": "{radius.lg.value}",
+                            "attributes": {
+                                "subtype": "radius",
+                                "description": "Controls the corner rounding of the top-right corner of the left navigation panel. This makes the panel appear with rounded corners on the top-right for a softer appearance.<br>CSS variable: --wm-left-panel-border-top-right-radius"
+                            }
                         }
                     }
                 },
@@ -26,14 +42,22 @@
                     "right": {
                         "radius": {
                             "type": "radius",
-                            "value": "{radius.lg.value}"
+                            "value": "{radius.lg.value}",
+                            "attributes": {
+                                "subtype": "radius",
+                                "description": "Controls the corner rounding of the bottom-right corner of the left navigation panel. This makes the panel appear with rounded corners on the bottom-right for a softer appearance.<br>CSS variable: --wm-left-panel-border-bottom-right-radius"
+                            }
                         }
                     }
                 }
             },
             "max-width": {
                 "type": "space",
-                "value": "360px"
+                "value": "360px",
+                "attributes": {
+                    "subtype": "space",
+                    "description": "Controls the maximum width of the left navigation panel (the side panel that slides in from the left). This determines how wide the panel can be when it's open. Acceptable units: px.<br>CSS variable: --wm-left-panel-max-width"
+                }
             }
         }
     }

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

@@ -8,213 +8,175 @@
       }
     },
     "mapping": {
-      "select": {
-          "icon": {
-            "font-size": {
-              "value": "{body.medium.font-size.value}",
-              "type": "font"
-            },
-            "color": {
-              "value": "{color.primary.@.value}",
-              "type": "color"
-            }
-          }
-        },
-      "listicon": {
-        "margin": {
-          "top": {
-            "value": "10px",
-            "type": "space"
-          },
-          "right": {
-            "value": "{space.2.value}",
-            "type": "space"
-          }
-        }
-      },
-      "group": {
-        "margin": {
-          "bottom": {
-            "value": "{space.4.value}",
-            "type": "space"
-          }
-        }
-      },
-      "group-heading": {
-        "background-color": {
-          "value": "transparent",
-          "type": "color"
-        },
-        "font-size": {
-          "value": "{body.large.font-size.value}",
-          "type": "font"
-        },
-        "padding": {
-          "left": {
-            "value": "{space.2.value}",
-            "type": "space"
-          },
-          "right": {
-            "value": "{space.2.value}",
-            "type": "space"
-          }
-        },
-        "line-height": {
-          "value": "40px",
-          "type": "font"
-        },
-        "font-family": {
-          "value": "{font.family.plain.value}",
-          "type": "font"
-        }
-      },
-      "loading": {
-        "icon": {
-          "font": {
-            "size": {
-              "value": "{space.4.value}",
-              "type": "font"
-            }
-          },
-          "text": {
-            "color": {
-              "value": "{color.on-surface.variant.@.value}",
-              "type": "color"
-            }
-          }
-        }
-      },
       "heading": {
         "padding": {
           "value": "{space.2.value}",
-          "type": "space"
+          "type": "space",
+          "attributes": {
+            "subtype": "space",
+            "description": "Controls the internal spacing inside list headings (section titles at the top of lists). This creates breathing room around the heading content. Acceptable units: px.<br>CSS variable: --wm-list-heading-padding"
+          }
         },
         "margin-bottom": {
           "value": "6px",
-          "type": "space"
+          "type": "space",
+          "attributes": {
+            "subtype": "space",
+            "description": "Controls the bottom margin (vertical spacing) of list headings (section titles at the top of lists). This creates spacing below the heading, separating it from the list items. Acceptable units: px.<br>CSS variable: --wm-list-heading-margin-bottom"
+          }
         },
         "background-color": {
           "value": "transparent",
-          "type": "color"
+          "type": "color",
+          "attributes": {
+            "subtype": "color",
+            "description": "Sets the background color of list headings (section titles at the top of lists). When transparent, only the heading text is visible. When filled with a color, the heading appears with a colored background.<br>CSS variable: --wm-list-heading-background-color"
+          }
         }
       },
       "title": {
         "line-height": {
           "value": "{body.large.line-height.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "line-height",
+            "description": "Controls the vertical spacing between lines when list title text wraps to multiple lines. This ensures proper spacing for the title text displayed in list items.<br>CSS variable: --wm-list-title-line-height"
+          }
         },
         "font-size": {
           "value": "{body.large.font-size.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "font-size",
+            "description": "Controls the size of list title text (the primary text that appears in each list item). This affects how large the title text appears.<br>CSS variable: --wm-list-title-font-size"
+          }
         },
         "color": {
           "value": "{color.on-surface.@.value}",
-          "type": "color"
+          "type": "color",
+          "attributes": {
+            "subtype": "color",
+            "description": "Sets the text color of list titles (the primary text that appears in each list item). This determines what color the title text appears in, which should contrast well with the background for readability.<br>CSS variable: --wm-list-title-color"
+          }
         },
         "font-family": {
           "value": "{font.family.plain.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "font-family",
+            "description": "Sets the typeface (font style) for list title text (the primary text that appears in each list item). This determines whether the title text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-list-title-font-family"
+          }
         },
         "font-weight": {
           "value": "{body.large.font-weight.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "font-weight",
+            "description": "Controls how thick or bold list title text appears. 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-list-title-font-weight"
+          }
         }
       },
       "sub-heading": {
         "font-size": {
           "value": "{body.medium.font-size.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "font-size",
+            "description": "Controls the size of list sub-heading text (secondary text that appears below the title in each list item). This affects how large the sub-heading text appears.<br>CSS variable: --wm-list-sub-heading-font-size"
+          }
         },
         "line-height": {
           "value": "{body.medium.line-height.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "line-height",
+            "description": "Controls the vertical spacing between lines when list sub-heading text wraps to multiple lines. This ensures proper spacing for the sub-heading text displayed in list items.<br>CSS variable: --wm-list-sub-heading-line-height"
+          }
         },
         "color": {
           "value": "{color.on-surface.@.value}",
-          "type": "color"
+          "type": "color",
+          "attributes": {
+            "subtype": "color",
+            "description": "Sets the text color of list sub-headings (secondary text that appears below the title in each list item). This determines what color the sub-heading text appears in, which should contrast well with the background for readability.<br>CSS variable: --wm-list-sub-heading-color"
+          }
         },
         "font-family": {
           "value": "{font.family.plain.value}",
-          "type": "font"
+          "type": "font",
+          "attributes": {
+            "subtype": "font-family",
+            "description": "Sets the typeface (font style) for list sub-heading text (secondary text that appears below the title in each list item). This determines whether the sub-heading text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-list-sub-heading-font-family"
+          }
         },
         "font-weight": {
           "value": "{body.medium.font-weight.value}",
-          "type": "font"
-        }
-      },
-      "empty": {
-        "message": {
-          "line-height": {
-            "value": "18px",
-            "type": "font"
-          },
-          "font-size": {
-            "value": "{body.large.font-size.value}",
-            "type": "font"
-          },
-          "color": {
-            "value": "{color.on-surface.@.value}",
-            "type": "color"
+          "type": "font",
+          "attributes": {
+            "subtype": "font-weight",
+            "description": "Controls how thick or bold list sub-heading text appears. 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-list-sub-heading-font-weight"
           }
         }
       },
-      "on-demand-messsage": {
-        "padding": {
-          "vertical": {
-            "value": "{space.2.value}",
-            "type": "space"
-          }
-        },
-        "width": {
-          "value": "100%",
-          "type": "space"
-        },
-        "text": {
-          "value": "{color.on-surface.@.value}",
-          "type": "color"
-        }
-      },
       "item": {
-        "background-color": {
-          "active": {
-            "value": "{color.surface.container.high.@.value}",
-            "type": "color"
+        "border": {
+          "radius": {
+            "value": "6px",
+            "type": "radius",
+            "attributes": {
+              "subtype": "radius",
+              "description": "Controls the corner rounding of list items (individual entries in a list). This makes the list items appear with rounded corners for a softer appearance.<br>CSS variable: --wm-list-item-border-radius"
+            }
           }
         },
         "padding": {
           "value": "{space.1.value}",
-          "type": "space"
+          "type": "space",
+          "attributes": {
+            "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"
+          }
         },
         "min-height": {
           "value": "56px",
-          "type": "space"
+          "type": "space",
+          "attributes": {
+            "subtype": "space",
+            "description": "Controls the minimum height of list items (individual entries in a list that users can interact with). This ensures each list item is always tall enough to be visible and properly displayed. Acceptable units: px, em, rem.<br>CSS variable: --wm-list-item-min-height"
+          }
         },
         "header": {
           "background-color": {
             "value": "{color.surface.container.lowest.@.value}",
-            "type": "color"
-          },
-          "color": {
-            "value": "{color.on-surface.@.value}",
-            "type": "color"
+            "type": "color",
+            "attributes": {
+              "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"
+            }
           }
-        },
-        "border": {
-          "radius": {
-            "value": "6px",
-            "type": "radius"
-          },
-          "style": {
-            "value": "{border.style.base.value}",
-            "type": "radius"
+        }
+      },
+      "select": {
+        "icon": {
+          "font-size": {
+            "value": "{body.medium.font-size.value}",
+            "type": "font",
+            "attributes": {
+              "subtype": "icon-size",
+              "description": "Controls the size of selection icons in lists (checkmarks or other icons that indicate selected list items). This affects how large the selection icons appear.<br>CSS variable: --wm-list-select-icon-font-size"
+            }
           },
           "color": {
-            "value": "transparent",
-            "type": "color"
+            "value": "{color.primary.@.value}",
+            "type": "color",
+            "attributes": {
+              "subtype": "color",
+              "description": "Sets the color of selection icons in lists (checkmarks or other icons that indicate selected list items). This determines what color the selection icons appear in, typically matching the primary theme color.<br>CSS variable: --wm-list-select-icon-color"
+            }
           }
         }
-      }
-    },
-    "appearances": {}
+      },
+      "appearances": {}
+    }
   }
 }