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

package/src/tokens/web/components/page-left-nav/page-left-nav.json

@@ -75,28 +75,32 @@
             "value": "{color.outline.variant.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the color of the left navigation panel border (the vertical sidebar that contains navigation menu items). This determines what color the border line appears in that separates the navigation from the main content.<br>CSS variable: --wm-aside-left-border-color"
             }
           },
           "style": {
             "value": "{border.style.base.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "border-style"
+              "subtype": "border-style",
+              "description": "Sets the visual style of the left navigation panel border. 'solid' creates a continuous line, 'dashed' creates a broken line, 'dotted' creates a dotted line, 'none' removes the border completely.<br>CSS variable: --wm-aside-left-border-style"
             }
           },
           "radius": {
             "value": "{radius.none.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "radius"
+              "subtype": "radius",
+              "description": "Controls the corner rounding of the left navigation panel. This makes the navigation panel corners slightly rounded for a softer appearance, or keeps them square with 'none'.<br>CSS variable: --wm-aside-left-border-radius"
             }
           },
           "width": {
             "value": "{border.width.0.value} {border.width.1.value} {border.width.0.value} {border.width.0.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "border-width"
+              "subtype": "border-width",
+              "description": "Controls the thickness of the left navigation panel border. The format is 'top right bottom left' - this setting creates a right border only to separate the navigation from the main content.<br>CSS variable: --wm-aside-left-border-width"
             }
           }
         },
@@ -104,42 +108,48 @@
           "value": "{elevation.shadow.none.value}",
           "type": "radius",
           "attributes": {
-            "subtype": "elevation"
+            "subtype": "elevation",
+            "description": "Controls the drop shadow effect around the left navigation panel (the vertical sidebar that contains navigation menu items). This creates a subtle shadow that makes the navigation appear to float above the background, giving it depth and elevation.<br>CSS variable: --wm-aside-left-shadow"
           }
         },
         "letter-spacing": {
           "value": "{label.medium.letter-spacing.value}",
           "type": "font",
           "attributes": {
-            "subtype": "letter-spacing"
+            "subtype": "letter-spacing",
+            "description": "Controls the horizontal spacing between individual characters in the left navigation panel text. This can help make the navigation text more readable and properly spaced.<br>CSS variable: --wm-aside-left-letter-spacing"
           }
         },
         "padding": {
           "value": "{space.0.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the internal spacing inside the left navigation panel (the space between the navigation content and its borders). This creates breathing room around the navigation menu items.<br>CSS variable: --wm-aside-left-padding"
           }
         },
         "background": {
           "value": "{color.surface.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the background color of the left navigation panel (the vertical sidebar that contains navigation menu items). This is the main background color that appears behind the navigation content.<br>CSS variable: --wm-aside-left-background"
           }
         },
         "color": {
           "value": "{color.on-surface.variant.@.value}",
           "type": "color",
           "attributes": {
-            "subtype": "color"
+            "subtype": "color",
+            "description": "Sets the text color of the left navigation panel (the vertical sidebar that contains navigation menu items). This determines what color the navigation text appears in.<br>CSS variable: --wm-aside-left-color"
           }
         },
         "gap": {
           "value": "{space.1.value}",
           "type": "space",
           "attributes": {
-            "subtype": "space"
+            "subtype": "space",
+            "description": "Controls the spacing between navigation items in the left navigation panel (the vertical sidebar that contains navigation menu items). This creates visual separation between different menu options.<br>CSS variable: --wm-aside-left-nav-gap"
           }
         },
         "item": {
@@ -147,14 +157,16 @@
             "value": "none",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the text color of navigation items in the left navigation panel (individual menu options like 'Home', 'Settings', 'Profile'). This determines what color the menu item text appears in.<br>CSS variable: --wm-aside-left-nav-item-color"
             }
           },
           "background": {
             "value": "{color.surface.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the background color of navigation items in the left navigation panel (individual menu options like 'Home', 'Settings', 'Profile'). This creates the background color behind each menu item.<br>CSS variable: --wm-aside-left-nav-item-background"
             }
           },
           "min": {
@@ -162,7 +174,8 @@
               "value": "44px",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the minimum height of navigation items in the left navigation panel (individual menu options like 'Home', 'Settings', 'Profile'). This ensures each menu item is tall enough to be easily clickable.<br>CSS variable: --wm-aside-left-nav-item-min-height"
               }
             }
           },
@@ -170,7 +183,8 @@
             "value": "{space.2.value} {space.6.value}",
             "type": "space",
             "attributes": {
-              "subtype": "space"
+              "subtype": "space",
+              "description": "Controls the internal spacing inside navigation items in the left navigation panel (the space between the menu item content and its borders). This creates breathing room around the menu item text and icons.<br>CSS variable: --wm-aside-left-nav-item-padding"
             }
           },
           "font": {
@@ -178,21 +192,24 @@
               "value": "{label.large.font-family.value}",
               "type": "font",
               "attributes": {
-                "subtype": "font-family"
+                "subtype": "font-family",
+                "description": "Sets the typeface (font style) for navigation item text in the left navigation panel (individual menu options like 'Home', 'Settings', 'Profile'). This determines whether the menu item text appears in Arial, Times New Roman, or other font styles.<br>CSS variable: --wm-aside-left-nav-item-font-family"
               }
             },
             "size": {
               "value": "{label.large.font-size.value}",
               "type": "font",
               "attributes": {
-                "subtype": "font-size"
+                "subtype": "font-size",
+                "description": "Controls how large the navigation item text appears in the left navigation panel (individual menu options like 'Home', 'Settings', 'Profile'). This affects the size of the text that users see in each menu option.<br>CSS variable: --wm-aside-left-nav-item-font-size"
               }
             },
             "weight": {
               "value": "{label.large.font-weight.value}",
               "type": "font",
               "attributes": {
-                "subtype": "font-weight"
+                "subtype": "font-weight",
+                "description": "Controls how thick or bold the navigation item text appears in the left navigation panel (individual menu options like 'Home', 'Settings', 'Profile'). 'normal' makes it regular weight, 'bold' makes it thicker, and numbers (100-900) provide fine control over thickness.<br>CSS variable: --wm-aside-left-nav-item-font-weight"
               }
             }
           },
@@ -200,7 +217,8 @@
             "value": "{label.medium.line-height.value}",
             "type": "font",
             "attributes": {
-              "subtype": "line-height"
+              "subtype": "line-height",
+              "description": "Controls the vertical spacing between lines when navigation item text wraps to multiple lines in the left navigation panel. This ensures proper spacing for the menu item text displayed in the navigation.<br>CSS variable: --wm-aside-left-nav-item-line-height"
             }
           },
           "border": {
@@ -208,7 +226,8 @@
               "value": "{radius.none.value}",
               "type": "radius",
               "attributes": {
-                "subtype": "radius"
+                "subtype": "radius",
+                "description": "Controls the border radius of navigation items.<br>CSS variable: --wm-aside-left-nav-item-border-radius"
               }
             }
           },
@@ -216,7 +235,8 @@
             "value": "{space.1.value}",
             "type": "space",
             "attributes": {
-              "subtype": "space"
+              "subtype": "space",
+              "description": "Controls spacing between elements within navigation items.<br>CSS variable: --wm-aside-left-nav-item-gap"
             }
           },
           "icon": {
@@ -224,21 +244,24 @@
               "value": "24px",
               "type": "space",
               "attributes": {
-                "subtype": "icon-size"
+                "subtype": "icon-size",
+                "description": "Controls the size of navigation item icons.<br>CSS variable: --wm-aside-left-nav-item-icon-size"
               }
             },
             "width": {
               "value": "40px",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the width of navigation item icons.<br>CSS variable: --wm-aside-left-nav-item-icon-width"
               }
             },
             "height": {
               "value": "40px",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the height of navigation item icons.<br>CSS variable: --wm-aside-left-nav-item-icon-height"
               }
             },
             "border": {
@@ -246,7 +269,8 @@
                 "value": "{radius.none.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "radius"
+                  "subtype": "radius",
+                  "description": "Controls the border radius of navigation item icons.<br>CSS variable: --wm-aside-left-nav-item-icon-border-radius"
                 }
               }
             },
@@ -254,14 +278,16 @@
               "value": "{color.inherit.value}",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the background color of navigation item icons.<br>CSS variable: --wm-aside-left-nav-item-icon-background"
               }
             },
             "color": {
               "value": "{color.inherit.value}",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the color of navigation item icons.<br>CSS variable: --wm-aside-left-nav-item-icon-color"
               }
             }
           },
@@ -270,28 +296,32 @@
               "value": "none",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the color of navigation item indicators.<br>CSS variable: --wm-aside-left-nav-item-indicator-color"
               }
             },
             "width": {
               "value": "1px",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the width of navigation item indicators.<br>CSS variable: --wm-aside-left-nav-item-indicator-width"
               }
             },
             "height": {
               "value": "100%",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the height of navigation item indicators.<br>CSS variable: --wm-aside-left-nav-item-indicator-height"
               }
             },
             "position": {
               "value": " 0 0 0 auto",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the positioning of navigation item indicators.<br>CSS variable: --wm-aside-left-nav-item-indicator-position"
               }
             },
             "border": {
@@ -299,7 +329,8 @@
                 "value": "{radius.none.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "radius"
+                  "subtype": "radius",
+                  "description": "Controls the border radius of navigation item indicators.<br>CSS variable: --wm-aside-left-nav-item-indicator-border-radius"
                 }
               }
             }
@@ -309,7 +340,8 @@
               "value": "{icon.size.sm.value}",
               "type": "space",
               "attributes": {
-                "subtype": "icon-size"
+                "subtype": "icon-size",
+                "description": "Controls the size of navigation item caret icons.<br>CSS variable: --wm-aside-left-nav-item-caret-size"
               }
             }
           }
@@ -319,14 +351,16 @@
             "value": "{space.0.value} {space.0.value} {space.0.value} {space.3.value}",
             "type": "space",
             "attributes": {
-              "subtype": "space"
+              "subtype": "space",
+              "description": "Sets internal spacing within submenu containers.<br>CSS variable: --wm-aside-left-nav-submenu-padding"
             }
           },
           "background": {
             "value": "{color.surface.@.value}",
             "type": "color",
             "attributes": {
-              "subtype": "color"
+              "subtype": "color",
+              "description": "Sets the background color of submenu containers.<br>CSS variable: --wm-aside-left-nav-submenu-background"
             }
           },
           "border": {
@@ -334,7 +368,8 @@
               "value": "{radius.none.value}",
               "type": "radius",
               "attributes": {
-                "subtype": "radius"
+                "subtype": "radius",
+                "description": "Controls the border radius of submenu containers.<br>CSS variable: --wm-aside-left-nav-submenu-border-radius"
               }
             }
           },
@@ -342,7 +377,8 @@
             "value": "{elevation.shadow.none.value}",
             "type": "radius",
             "attributes": {
-              "subtype": "elevation"
+              "subtype": "elevation",
+              "description": "Controls the drop shadow effect of submenu containers.<br>CSS variable: --wm-aside-left-nav-submenu-box-shadow"
             }
           },
           "item": {
@@ -350,28 +386,32 @@
               "value": "none",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the text color of submenu items.<br>CSS variable: --wm-aside-left-nav-submenu-item-color"
               }
             },
             "background": {
               "value": "{color.surface.@.value}",
               "type": "color",
               "attributes": {
-                "subtype": "color"
+                "subtype": "color",
+                "description": "Sets the background color of submenu items.<br>CSS variable: --wm-aside-left-nav-submenu-item-background"
               }
             },
             "height": {
               "value": "44px",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls the height of submenu items.<br>CSS variable: --wm-aside-left-nav-submenu-item-height"
               }
             },
             "padding": {
               "value": "{space.2.value} {space.6.value}",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Sets internal spacing within submenu items.<br>CSS variable: --wm-aside-left-nav-submenu-item-padding"
               }
             },
             "font": {
@@ -379,21 +419,24 @@
                 "value": "{label.large.font-size.value}",
                 "type": "font",
                 "attributes": {
-                  "subtype": "font-size"
+                  "subtype": "font-size",
+                  "description": "Controls the size of submenu item text.<br>CSS variable: --wm-aside-left-nav-submenu-item-font-size"
                 }
               },
               "family": {
                 "value": "{label.large.font-family.value}",
                 "type": "font",
                 "attributes": {
-                  "subtype": "font-family"
+                  "subtype": "font-family",
+                  "description": "Sets the font family for submenu item text.<br>CSS variable: --wm-aside-left-nav-submenu-item-font-family"
                 }
               },
               "weight": {
                 "value": "{label.large.font-weight.value}",
                 "type": "font",
                 "attributes": {
-                  "subtype": "font-weight"
+                  "subtype": "font-weight",
+                  "description": "Controls the weight of submenu item text.<br>CSS variable: --wm-aside-left-nav-submenu-item-font-weight"
                 }
               }
             },
@@ -401,7 +444,8 @@
               "value": "{label.large.line-height.value}",
               "type": "font",
               "attributes": {
-                "subtype": "line-height"
+                "subtype": "line-height",
+                "description": "Sets the line height for submenu item text.<br>CSS variable: --wm-aside-left-nav-submenu-item-line-height"
               }
             },
             "border": {
@@ -409,7 +453,8 @@
                 "value": "{radius.none.value}",
                 "type": "radius",
                 "attributes": {
-                  "subtype": "radius"
+                  "subtype": "radius",
+                  "description": "Controls the border radius of submenu items.<br>CSS variable: --wm-aside-left-nav-submenu-item-border-radius"
                 }
               }
             },
@@ -417,7 +462,8 @@
               "value": "{space.2.value}",
               "type": "space",
               "attributes": {
-                "subtype": "space"
+                "subtype": "space",
+                "description": "Controls spacing between elements within submenu items.<br>CSS variable: --wm-aside-left-nav-submenu-item-gap"
               }
             }
           }
@@ -904,4 +950,4 @@
       }
     }
   }
-}
+}

package/src/tokens/web/components/page-right-nav/Token.Readme.md

@@ -0,0 +1,53 @@
+<!-- AUTO-GENERATED FILE. Do not edit manually. -->
+
+# Token Reference Table
+
+This table lists all tokens for this component:
+
+| Token | Description |
+|-------|------------|
+| nav.border.color | Sets the color of the right navigation panel border (the vertical sidebar that contains navigation menu items). This determines what color the border line appears in that separates the navigation from the main content.<br>CSS variable: --wm-aside-right-nav-border-color |
+| nav.border.style | Sets the visual style of the right navigation panel border. 'solid' creates a continuous line, 'dashed' creates a broken line, 'dotted' creates a dotted line, 'none' removes the border completely.<br>CSS variable: --wm-aside-right-nav-border-style |
+| nav.border.radius | Controls the corner rounding of the right navigation panel. This makes the navigation panel corners slightly rounded for a softer appearance, or keeps them square with 'none'.<br>CSS variable: --wm-aside-right-nav-border-radius |
+| nav.border.width | Controls the thickness of the right navigation panel border. The format is 'top right bottom left' - this setting creates a left border only to separate the navigation from the main content.<br>CSS variable: --wm-aside-right-nav-border-width |
+| nav.shadow | Controls the drop shadow effect around the right navigation panel (the vertical sidebar that contains navigation menu items). This creates a subtle shadow that makes the navigation appear to float above the background, giving it depth and elevation.<br>CSS variable: --wm-aside-right-nav-shadow |
+| nav.letter-spacing | Controls the horizontal spacing between individual characters in the right navigation panel text. This can help make the navigation text more readable and properly spaced.<br>CSS variable: --wm-aside-right-nav-letter-spacing |
+| nav.padding | Controls the internal spacing inside the right navigation panel (the space between the navigation content and its borders). This creates breathing room around the navigation menu items.<br>CSS variable: --wm-aside-right-nav-padding |
+| nav.background | Sets the background color of the right navigation panel (the vertical sidebar that contains navigation menu items). This is the main background color that appears behind the navigation content.<br>CSS variable: --wm-aside-right-nav-background |
+| nav.color | Sets the text color of the right navigation panel (the vertical sidebar that contains navigation menu items). This determines what color the navigation text appears in.<br>CSS variable: --wm-aside-right-nav-color |
+| nav.gap | Controls spacing between elements in right navigation panels.<br>CSS variable: --wm-aside-right-nav-gap |
+| nav.item.color | Sets the text color of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-color |
+| nav.item.background | Sets the background color of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-background |
+| nav.item.min.height | Controls the minimum height of right navigation items. Acceptable units: px, em, rem.<br>CSS variable: --wm-aside-right-nav-item-min-height |
+| nav.item.padding | Controls padding of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-padding |
+| nav.item.font.family | Sets the font family of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-font-family |
+| nav.item.font.size | Controls the font size of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-font-size |
+| nav.item.font.weight | Controls the font weight of right navigation items. Acceptable values: normal, bold, 100-900.<br>CSS variable: --wm-aside-right-nav-item-font-weight |
+| nav.item.line-height | Controls the line height of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-line-height |
+| nav.item.border.radius | Controls the border radius of right navigation items.<br>CSS variable: --wm-aside-right-nav-item-border-radius |
+| nav.item.gap | Controls spacing between elements in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-gap |
+| nav.item.icon.size | Controls the size of icons in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-icon-size |
+| nav.item.icon.height | Controls the height of icons in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-icon-height |
+| nav.item.icon.border.radius | Controls the border radius of icons in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-icon-border-radius |
+| nav.item.icon.background | Sets the background color of icons in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-icon-background |
+| nav.item.icon.color | Sets the color of icons in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-icon-color |
+| nav.item.indicator.color | Sets the color of indicators in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-indicator-color |
+| nav.item.indicator.width | Controls the width of indicators in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-indicator-width |
+| nav.item.indicator.height | Controls the height of indicators in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-indicator-height |
+| nav.item.indicator.position | Controls the position of indicators in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-indicator-position |
+| nav.item.indicator.border.radius | Controls the border radius of indicators in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-indicator-radius |
+| nav.item.caret.size | Controls the size of caret icons in right navigation items.<br>CSS variable: --wm-aside-right-nav-item-caret-size |
+| nav.submenu.padding | Controls padding of right navigation submenus.<br>CSS variable: --wm-aside-right-nav-submenu-padding |
+| nav.submenu.background | Sets the background color of right navigation submenus.<br>CSS variable: --wm-aside-right-nav-submenu-background |
+| nav.submenu.border.radius | Controls the border radius of right navigation submenus.<br>CSS variable: --wm-aside-right-nav-submenu-border-radius |
+| nav.submenu.box-shadow | Controls the box shadow of right navigation submenus.<br>CSS variable: --wm-aside-right-nav-submenu-box-shadow |
+| nav.submenu.item.color | Sets the text color of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-color |
+| nav.submenu.item.background | Sets the background color of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-background |
+| nav.submenu.item.height | Controls the height of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-height |
+| nav.submenu.item.padding | Controls padding of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-padding |
+| nav.submenu.item.font.size | Controls the font size of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-font-size |
+| nav.submenu.item.font.family | Sets the font family of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-font-family |
+| nav.submenu.item.font.weight | Controls the font weight of right navigation submenu items. Acceptable values: normal, bold, 100-900.<br>CSS variable: --wm-aside-right-nav-submenu-item-font-weight |
+| nav.submenu.item.line-height | Controls the line height of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-line-height |
+| nav.submenu.item.border.radius | Controls the border radius of right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-border-radius |
+| nav.submenu.item.gap | Controls spacing between elements in right navigation submenu items.<br>CSS variable: --wm-aside-right-nav-submenu-item-gap |