@teseor/css 1.7.0 → 1.9.0

package/src/components/feedback/alert/alert.docs.json

@@ -0,0 +1,325 @@
+{
+  "id": "alert",
+  "type": "component",
+  "title": "Alert",
+  "description": "Informational banner for important messages. Use variants for different message types.",
+  "api": "./alert.api.json",
+  "sections": [
+    {
+      "title": "Default",
+      "examples": [
+        {
+          "items": [
+            {
+              "tag": "div",
+              "class": "ui-alert",
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ui-alert__content",
+                  "children": [
+                    { "tag": "p", "class": "ui-alert__title", "text": "Note" },
+                    {
+                      "tag": "p",
+                      "class": "ui-alert__description",
+                      "text": "This is a default alert message."
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "code": "<div class=\"ui-alert\">\n  <div class=\"ui-alert__content\">\n    <p class=\"ui-alert__title\">Note</p>\n    <p class=\"ui-alert__description\">This is a default alert.</p>\n  </div>\n</div>"
+        }
+      ]
+    },
+    {
+      "title": "Variants",
+      "examples": [
+        {
+          "items": [
+            {
+              "tag": "div",
+              "class": "ui-column",
+              "attrs": { "style": "--column-gap: var(--ui-space-2);" },
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--info",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        { "tag": "p", "class": "ui-alert__title", "text": "Info" },
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Informational message for the user."
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--success",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        { "tag": "p", "class": "ui-alert__title", "text": "Success" },
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Your action was completed successfully."
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--warning",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        { "tag": "p", "class": "ui-alert__title", "text": "Warning" },
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Please review before continuing."
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--danger",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        { "tag": "p", "class": "ui-alert__title", "text": "Error" },
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Something went wrong. Please try again."
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "code": "<div class=\"ui-alert ui-alert--info\">...</div>\n<div class=\"ui-alert ui-alert--success\">...</div>\n<div class=\"ui-alert ui-alert--warning\">...</div>\n<div class=\"ui-alert ui-alert--danger\">...</div>"
+        }
+      ]
+    },
+    {
+      "title": "With Icon",
+      "examples": [
+        {
+          "items": [
+            {
+              "tag": "div",
+              "class": "ui-alert ui-alert--info",
+              "children": [
+                {
+                  "tag": "svg",
+                  "class": "ui-icon ui-icon--sm ui-alert__icon",
+                  "attrs": { "viewBox": "0 0 24 24" },
+                  "children": [
+                    { "tag": "circle", "attrs": { "cx": "12", "cy": "12", "r": "10" } },
+                    { "tag": "path", "attrs": { "d": "M12 16v-4" } },
+                    { "tag": "path", "attrs": { "d": "M12 8h.01" } }
+                  ]
+                },
+                {
+                  "tag": "div",
+                  "class": "ui-alert__content",
+                  "children": [
+                    {
+                      "tag": "p",
+                      "class": "ui-alert__description",
+                      "text": "Your session will expire in 5 minutes."
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "code": "<div class=\"ui-alert ui-alert--info\">\n  <svg class=\"ui-icon ui-alert__icon\">...</svg>\n  <div class=\"ui-alert__content\">\n    <p class=\"ui-alert__description\">Your session will expire.</p>\n  </div>\n</div>"
+        }
+      ]
+    },
+    {
+      "title": "Description Only",
+      "examples": [
+        {
+          "items": [
+            {
+              "tag": "div",
+              "class": "ui-alert ui-alert--success",
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ui-alert__content",
+                  "children": [
+                    {
+                      "tag": "p",
+                      "class": "ui-alert__description",
+                      "text": "File uploaded successfully."
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "code": "<div class=\"ui-alert ui-alert--success\">\n  <div class=\"ui-alert__content\">\n    <p class=\"ui-alert__description\">File uploaded.</p>\n  </div>\n</div>"
+        }
+      ]
+    },
+    {
+      "title": "Sizes",
+      "examples": [
+        {
+          "items": [
+            {
+              "tag": "div",
+              "class": "ui-column",
+              "attrs": { "style": "--column-gap: var(--ui-space-2);" },
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--info ui-alert--sm",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Small alert with compact padding."
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--info",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Default alert size."
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "tag": "div",
+                  "class": "ui-alert ui-alert--info ui-alert--lg",
+                  "children": [
+                    {
+                      "tag": "div",
+                      "class": "ui-alert__content",
+                      "children": [
+                        {
+                          "tag": "p",
+                          "class": "ui-alert__description",
+                          "text": "Large alert with extra padding."
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "code": "<div class=\"ui-alert ui-alert--sm\">...</div>\n<div class=\"ui-alert\">...</div>\n<div class=\"ui-alert ui-alert--lg\">...</div>"
+        }
+      ]
+    },
+    {
+      "title": "Dismissible",
+      "examples": [
+        {
+          "items": [
+            {
+              "tag": "div",
+              "class": "ui-alert ui-alert--info ui-alert--dismissible",
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ui-alert__content",
+                  "children": [
+                    { "tag": "p", "class": "ui-alert__title", "text": "Dismissible" },
+                    {
+                      "tag": "p",
+                      "class": "ui-alert__description",
+                      "text": "This alert can be closed by the user."
+                    }
+                  ]
+                },
+                {
+                  "tag": "button",
+                  "class": "ui-alert__close ui-close-button",
+                  "attrs": { "aria-label": "Close" }
+                }
+              ]
+            }
+          ],
+          "code": "<div class=\"ui-alert ui-alert--info ui-alert--dismissible\">\n  <div class=\"ui-alert__content\">\n    <p class=\"ui-alert__title\">Dismissible</p>\n    <p class=\"ui-alert__description\">This alert can be closed.</p>\n  </div>\n  <button class=\"ui-alert__close\" aria-label=\"Close\">...</button>\n</div>"
+        }
+      ]
+    }
+  ],
+  "customization": [
+    {
+      "token": "--ui-alert-padding",
+      "default": "var(--ui-space-2)",
+      "description": "Inner padding"
+    },
+    {
+      "token": "--ui-alert-gap",
+      "default": "var(--ui-space-1)",
+      "description": "Gap between icon and content"
+    },
+    {
+      "token": "--ui-alert-radius",
+      "default": "var(--ui-radius-md)",
+      "description": "Border radius"
+    },
+    {
+      "token": "--ui-alert-border-width",
+      "default": "var(--ui-border-width-sm)",
+      "description": "Border width"
+    },
+    {
+      "token": "--ui-alert-bg",
+      "default": "var(--ui-color-bg-subtle)",
+      "description": "Background color"
+    },
+    {
+      "token": "--ui-alert-border-color",
+      "default": "var(--ui-color-border)",
+      "description": "Border color"
+    },
+    { "token": "--ui-alert-color", "default": "var(--ui-color-text)", "description": "Text color" },
+    { "token": "--ui-alert-icon-color", "default": "currentcolor", "description": "Icon color" }
+  ]
+}

package/src/{04-components → components}/feedback/alert/index.scss

@@ -1,20 +1,34 @@
-@use '../../../00-config/tokens/variables' as t;
+@use '../../../config/tokens/variables' as t;
 
 // @component alert
 // @element div
 
 @layer components.tokens {
   .alert {
+    --_weight-medium: var(--ui-weight-medium, #{t.$weight-medium});
+    --_row-1: var(--ui-row-1, #{t.$row});
+    --_font-size-sm: var(--ui-font-size-sm, #{t.$font-size-sm});
+    --_color-text-muted: var(--ui-color-text-muted, #{t.$color-text-muted});
+    --_color-text: var(--ui-color-text, #{t.$color-text});
     // Single accent color - variants override, bg/border derived via color-mix
+    // @desc Accent color
     --_accent: var(--ui-alert-accent, var(--ui-color-border, #{t.$color-border}));
 
+    // @desc Padding on all sides
     --_padding: var(--ui-alert-padding, var(--ui-space-2, #{t.$space-2}));
+    // @desc Border thickness
     --_border-width: var(--ui-alert-border-width, var(--ui-border-width-sm, #{t.$border-width-sm}));
+    // @desc Gap between children
     --_gap: var(--ui-alert-gap, var(--ui-space-1, #{t.$space-1}));
+    // @desc Corner radius
     --_radius: var(--ui-alert-radius, var(--ui-radius-md, #{t.$radius-md}));
     --_bg: color-mix(in oklch, var(--_accent) 8%, white);
     --_border-color: var(--_accent);
+    // @desc Text color
     --_color: var(--ui-alert-color, var(--ui-color-text, #{t.$color-text}));
+    // @desc Font size
+    --_font-size: var(--ui-alert-font-size, inherit);
+    --_padding-end: 0;
     --_icon-color: var(--_accent);
   }
 
@@ -34,6 +48,31 @@
   .alert--danger {
     --_accent: var(--ui-color-danger, #{t.$color-danger});
   }
+
+  // @modifier size
+  .alert--sm {
+    // @desc Padding on all sides at small size
+    --_padding: var(--ui-alert-padding-sm, var(--ui-space-1, #{t.$space-1}));
+    // @desc Gap between children at small size
+    --_gap: var(--ui-alert-gap-sm, calc(#{t.$unit} * 0.5));
+    // @desc Font size at small size
+    --_font-size: var(--ui-alert-font-size-sm, var(--ui-font-size-sm, #{t.$font-size-sm}));
+  }
+
+  .alert--lg {
+    // @desc Padding on all sides at large size
+    --_padding: var(--ui-alert-padding-lg, var(--ui-space-4, #{t.$space-4}));
+    // @desc Gap between children at large size
+    --_gap: var(--ui-alert-gap-lg, var(--ui-space-2, #{t.$space-2}));
+    // @desc Font size at large size
+    --_font-size: var(--ui-alert-font-size-lg, var(--ui-font-size-lg, #{t.$font-size-lg}));
+  }
+
+  // @modifier boolean dismissible
+  .alert--dismissible {
+    // @desc Padding end
+    --_padding-end: var(--ui-alert-padding-end, calc(#{t.$unit} * 5));
+  }
 }
 
 @layer components.styles {
@@ -45,7 +84,9 @@
     // Subtract border from padding to maintain grid rhythm
     padding: calc(var(--_padding) - var(--_border-width));
     padding-inline: var(--_padding);
+    padding-inline-end: calc(var(--_padding) + var(--_padding-end));
 
+    font-size: var(--_font-size);
     color: var(--_color);
 
     background: var(--_bg);
@@ -69,19 +110,19 @@
   .alert__title {
     margin: 0;
 
-    font-weight: var(--ui-weight-medium, #{t.$weight-medium});
+    font-weight: var(--_weight-medium);
     // Line-height aligned to grid (24px = 3 units)
-    line-height: var(--ui-row-1, #{t.$row});
+    line-height: var(--_row-1);
   }
 
   .alert__description {
     margin: 0;
     margin-block-start: calc(#{t.$unit} * 1);
 
-    font-size: var(--ui-font-size-sm, #{t.$font-size-sm});
+    font-size: var(--_font-size-sm);
     // Line-height aligned to grid (16px = 2 units for smaller text)
-    line-height: var(--ui-row-1, #{t.$row});
-    color: var(--ui-color-text-muted, #{t.$color-text-muted});
+    line-height: var(--_row-1);
+    color: var(--_color-text-muted);
   }
 
   .alert__close {
@@ -90,14 +131,14 @@
 
     padding: 0;
 
-    color: var(--ui-color-text-muted, #{t.$color-text-muted});
+    color: var(--_color-text-muted);
 
     background: none;
     border: none;
     cursor: pointer;
 
     &:hover {
-      color: var(--ui-color-text, #{t.$color-text});
+      color: var(--_color-text);
     }
   }
 }

package/src/{04-components → components}/feedback/progress/index.scss

@@ -1,16 +1,25 @@
-@use '../../../00-config/tokens/variables' as t;
+@use '../../../config/tokens/variables' as t;
+// @component progress
+// @element div
 
 // Progress - progress bar indicator
 // Shows completion status of a task
 
 @layer components.tokens {
   .progress {
+    --_duration-normal: var(--ui-duration-normal, #{t.$duration-normal});
+    --_ease-default: var(--ui-ease-default, ease);
+    // @desc Overall height
     --_height: var(--ui-progress-height, calc(#{t.$unit} * 1));
-    --_bg: var(--ui-progress-bg, var(--ui-color-bg-subtle, rgb(0 0 0 / 0.1)));
+    // @desc Background color
+    --_bg: var(--ui-progress-bg, var(--ui-color-bg-subtle, #{t.$overlay-bg-subtle}));
+    // @desc Fill
     --_fill: var(--ui-progress-fill, var(--ui-color-primary));
-    --_radius: var(--ui-progress-radius, var(--ui-radius-full, 9999px));
+    // @desc Corner radius
+    --_radius: var(--ui-progress-radius, var(--ui-radius-full, #{t.$radius-full}));
   }
 
+  // @modifier size
   .progress--sm {
     --_height: calc(#{t.$unit} * 1);
   }
@@ -37,10 +46,11 @@
     background: var(--_fill);
     border-radius: var(--_radius);
 
-    transition: inline-size var(--ui-duration-normal, 200ms) var(--ui-ease-default, ease);
+    transition: inline-size var(--_duration-normal) var(--_ease-default);
   }
 
   // Indeterminate state - animated stripe
+  // @modifier boolean indeterminate
   .progress--indeterminate .progress__bar {
     inline-size: 30%;
 
@@ -58,6 +68,7 @@
   }
 
   // Striped variant
+  // @modifier boolean striped
   .progress--striped .progress__bar {
     background-image: linear-gradient(
       45deg,
@@ -73,6 +84,7 @@
   }
 
   // Animated stripes
+  // @modifier boolean animated
   .progress--animated .progress__bar {
     animation: progress-stripes 1s linear infinite;
   }
@@ -87,7 +99,18 @@
     }
   }
 
+  @media (prefers-reduced-motion: reduce) {
+    .progress--indeterminate .progress__bar {
+      animation: none;
+    }
+
+    .progress--animated .progress__bar {
+      animation: none;
+    }
+  }
+
   // Color variants
+  // @modifier variant
   .progress--success {
     --_fill: var(--ui-color-success);
   }

package/src/{04-components → components}/feedback/progress/progress.api.json

@@ -1,12 +1,13 @@
 {
+  "$schema": "Auto-generated from index.scss annotations. Do not edit manually — run: pnpm generate:api",
   "name": "progress",
   "element": "div",
   "modifiers": {
     "size": {
       "values": ["sm", "lg"]
     },
-    "variant": {
-      "values": ["success", "warning", "danger"]
+    "indeterminate": {
+      "type": "boolean"
     },
     "striped": {
       "type": "boolean"
@@ -14,8 +15,8 @@
     "animated": {
       "type": "boolean"
     },
-    "indeterminate": {
-      "type": "boolean"
+    "variant": {
+      "values": ["success", "warning", "danger"]
     }
   },
   "elements": {
@@ -24,19 +25,23 @@
   "cssVars": [
     {
       "name": "--ui-progress-height",
-      "default": "calc(#{t.$unit} * 1"
+      "default": "calc(var(--ui-unit) * 1)",
+      "description": "Overall height"
     },
     {
       "name": "--ui-progress-bg",
-      "default": "var(--ui-color-bg-subtle)"
+      "default": "var(--ui-color-bg-subtle)",
+      "description": "Background color"
     },
     {
       "name": "--ui-progress-fill",
-      "default": "var(--ui-color-primary)"
+      "default": "var(--ui-color-primary)",
+      "description": "Fill"
     },
     {
       "name": "--ui-progress-radius",
-      "default": "var(--ui-radius-full)"
+      "default": "var(--ui-radius-full)",
+      "description": "Corner radius"
     }
   ]
 }