@duro-app/cli 5.20.0 → 5.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duro-app/cli",
-  "version": "5.20.0",
+  "version": "5.21.0",
   "type": "module",
   "license": "MIT",
   "description": "Machine-queryable docs for the Duro design system: components, props, recipes, tokens and rules as CLI output, JSON, or an MCP server.",
@@ -46,7 +46,7 @@
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": ">=1.0.0",
-    "@duro-app/ui": "^5.20.0"
+    "@duro-app/ui": "^5.21.0"
   },
   "peerDependenciesMeta": {
     "@duro-app/ui": {
@@ -61,9 +61,9 @@
     "@types/node": "^24.0.0",
     "ts-morph": "^26.0.0",
     "typescript": "^5.7.0",
-    "@duro-app/eslint-plugin": "^5.20.0",
-    "@duro-app/ui": "^5.20.0",
-    "@duro-app/tokens": "^5.20.0"
+    "@duro-app/eslint-plugin": "^5.21.0",
+    "@duro-app/ui": "^5.21.0",
+    "@duro-app/tokens": "^5.21.0"
   },
   "scripts": {
     "registry": "node scripts/build-registry.mjs",

package/registry.json

@@ -1378,13 +1378,25 @@
           "description": "Initial preference (uncontrolled). Default `'system'`. For SSR with no hydration flash, pass the value you persisted server-side (e.g. a cookie).",
           "name": "defaultPreference",
           "required": false,
-          "type": "ColorModePreference"
+          "type": "ColorModePreference",
+          "union": [
+            "system",
+            "dark",
+            "light",
+            "high-contrast"
+          ]
         },
         {
           "description": "Controlled preference — when set, the provider does not own the state.",
           "name": "preference",
           "required": false,
-          "type": "ColorModePreference"
+          "type": "ColorModePreference",
+          "union": [
+            "system",
+            "dark",
+            "light",
+            "high-contrast"
+          ]
         },
         {
           "description": "Fired whenever the preference changes (controlled or not).",
@@ -3307,8 +3319,8 @@
       "importPath": "@duro-app/ui",
       "kind": "component",
       "meta": {
-        "description": "Semantic heading element (h1-h6) with typography presets. Always use the correct level for document hierarchy. Visual size can differ from semantic level via the variant prop.",
-        "example": "<Stack gap=\"md\">\n  <Heading level={1}>Page Title</Heading>\n  <Heading level={2} variant=\"headingMd\">Section</Heading>\n  <Heading level={3}>Subsection</Heading>\n</Stack>",
+        "description": "Semantic heading element (h1-h6) with typography presets. Always use the correct level for document hierarchy. The look is `variant` (heading, display, overline) and its size is `size` (sm, md, lg, xl), both independent of the semantic level. The old combined variants (headingSm, displayLg, …) still work and are deprecated.",
+        "example": "<Stack gap=\"md\">\n  <Heading level={1}>Page Title</Heading>\n  <Heading level={2} size=\"md\">Section</Heading>\n  <Heading level={1} variant=\"display\" size=\"lg\">Hero</Heading>\n  <Heading level={3} variant=\"overline\" color=\"muted\">Group</Heading>\n  <Heading level={2} variant=\"overline\" size=\"lg\">Large group</Heading>\n</Stack>",
         "relatedTo": [
           {
             "component": "Text",
@@ -3324,7 +3336,8 @@
         "whenToUse": [
           "Page titles (level 1)",
           "Section headers (level 2-3)",
-          "Card or panel titles (level 3-4)"
+          "Card or panel titles (level 3-4)",
+          "Group titles over a list of rows or a form section (level 3-4, variant=\"overline\", any size)"
         ]
       },
       "name": "Heading",
@@ -3336,10 +3349,14 @@
           "type": "1 | 2 | 3 | 4 | 5 | 6"
         },
         {
+          "description": "The look: `heading` (default), `display` (fluid hero titles), `overline` (small uppercase group titles).",
           "name": "variant",
           "required": false,
           "type": "HeadingVariant",
           "union": [
+            "heading",
+            "display",
+            "overline",
             "displayLg",
             "displayMd",
             "displaySm",
@@ -3349,6 +3366,18 @@
             "headingSm"
           ]
         },
+        {
+          "description": "The size within the look. Default: the level's size for `heading`, `md` for `display`, `sm` for `overline`; `display` and `overline` stop at `lg`.",
+          "name": "size",
+          "required": false,
+          "type": "HeadingSize",
+          "union": [
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ]
+        },
         {
           "default": "'default'",
           "name": "color",
@@ -7250,13 +7279,13 @@
           }
         ],
         "whenNotToUse": [
-          "Page or section titles — use Heading",
+          "Page, section or group titles — use Heading, even in overline style (variant=\"overline\")",
           "Form field labels — use Field.Label (auto-binds to form)"
         ],
         "whenToUse": [
           "Body text (paragraphs, descriptions)",
           "UI labels and metadata",
-          "Captions, code snippets, overlines"
+          "Captions, code snippets, and overline eyebrows above a Heading"
         ]
       },
       "name": "Text",
@@ -10793,6 +10822,12 @@
           {
             "key": "overline"
           },
+          {
+            "key": "overlineMd"
+          },
+          {
+            "key": "overlineLg"
+          },
           {
             "key": "headingSm"
           },
@@ -10938,6 +10973,12 @@
       "filled",
       "interactive"
     ],
+    "ColorModePreference": [
+      "system",
+      "dark",
+      "light",
+      "high-contrast"
+    ],
     "ContainerSize": [
       "compact",
       "default",
@@ -10990,7 +11031,16 @@
       "split-wide",
       "content-aside"
     ],
+    "HeadingSize": [
+      "sm",
+      "md",
+      "lg",
+      "xl"
+    ],
     "HeadingVariant": [
+      "heading",
+      "display",
+      "overline",
       "displayLg",
       "displayMd",
       "displaySm",