@lumeo-ui/mcp-server 3.5.2 → 3.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumeo-ui/mcp-server",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "description": "Model Context Protocol server for the Lumeo Blazor component library. Lets LLMs (Claude, Copilot, Cursor) author correct Lumeo markup.",
   "type": "module",
   "main": "dist/index.js",

package/src/components-api.json

@@ -1,13 +1,13 @@
 {
   "$schema": "https://lumeo.nativ.sh/components-api-schema.json",
-  "version": "3.5.2",
-  "generated": "2026-05-28T12:37:45.8507262Z",
+  "version": "3.6.0",
+  "generated": "2026-05-28T15:34:32.0101018Z",
   "stats": {
     "componentCount": 163,
-    "totalParameters": 3897,
+    "totalParameters": 3898,
     "totalEnums": 71,
     "totalRecords": 63,
-    "serviceCount": 32,
+    "serviceCount": 33,
     "thinFallbacks": []
   },
   "themeTokens": [
@@ -1516,67 +1516,79 @@
           "name": "ScrollableBody",
           "type": "bool",
           "default": "true",
-          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas)."
+          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas). Applies to: Sheet."
         },
         {
           "name": "MobileFullscreen",
           "type": "bool",
           "default": null,
-          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSheetSize to Full but composes more naturally for the Sheet+Dialog mixed case."
+          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSize to Full but composes more naturally for the Sheet+Dialog mixed case. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "MobileSwipeToClose",
           "type": "bool?",
           "default": null,
-          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down."
+          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down. Applies to: Sheet."
         },
         {
           "name": "MobileSheetSize",
           "type": "SheetSize?",
           "default": null,
-          "summary": "Sheet size to use when the viewport is below MobileBreakpoint. Null = use SheetSize at all sizes. Typical pattern: SheetSize.Default on desktop, SheetSize.Full on mobile."
+          "summary": "Legacy Sheet-only alias for MobileSize. Applies to: Sheet. Reads/writes MobileSize via a 1:1 mapping (null round-trips to null). Kept for source compatibility with pre-3.6 callers."
+        },
+        {
+          "name": "MobileSize",
+          "type": "OverlaySize?",
+          "default": null,
+          "summary": "Overlay size to use when the viewport is below MobileBreakpoint. Null = use Size at all sizes. Typical pattern: OverlaySize.Default on desktop, OverlaySize.Full on mobile. Applies to: Dialog, Sheet."
         },
         {
           "name": "MobileSheetSide",
           "type": "Lumeo.Side?",
           "default": null,
-          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile."
+          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile. Applies to: Sheet."
         },
         {
           "name": "MobileBreakpoint",
           "type": "int?",
           "default": "768",
-          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated."
+          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated. Applies to: Dialog, Sheet, Drawer (gates every Mobile* override)."
         },
         {
           "name": "SwipeToClose",
           "type": "bool",
           "default": null,
-          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour."
+          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour. Applies to: Sheet."
         },
         {
           "name": "SheetSize",
           "type": "SheetSize",
-          "default": "SheetSize.Default",
-          "summary": null
+          "default": null,
+          "summary": "Legacy Sheet-only size alias. Applies to: Sheet. Reads/writes Size via a 1:1 mapping; setting either sets the same backing value. Kept for source compatibility with pre-3.6 callers."
+        },
+        {
+          "name": "Size",
+          "type": "OverlaySize",
+          "default": "OverlaySize.Default",
+          "summary": "Overlay content size. Applies to: Dialog, Sheet. (Drawer sizes to its content and ignores this.) For a Dialog it maps to the max-w-* preset (Sm→max-w-sm … Xl→max-w-4xl, Full→near-viewport); for a Sheet it maps to the side-appropriate width (Left/Right) or height (Top/Bottom). Replaces the Sheet-only SheetSize as the single size knob for service overlays."
         },
         {
           "name": "SheetSide",
           "type": "Lumeo.Side",
           "default": "Lumeo.Side.Right",
-          "summary": null
+          "summary": "Edge the sheet slides in from. Applies to: Sheet."
         },
         {
           "name": "PreventClose",
           "type": "bool",
           "default": null,
-          "summary": null
+          "summary": "Suppress dismissal via backdrop click / Escape. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "Class",
           "type": "string?",
           "default": null,
-          "summary": null
+          "summary": "Extra CSS classes merged onto the overlay's content element. Applies to: Dialog, Sheet, Drawer."
         }
       ],
       "methods": [],
@@ -1593,67 +1605,79 @@
           "name": "ScrollableBody",
           "type": "bool",
           "default": "true",
-          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas)."
+          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas). Applies to: Sheet."
         },
         {
           "name": "MobileFullscreen",
           "type": "bool",
           "default": null,
-          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSheetSize to Full but composes more naturally for the Sheet+Dialog mixed case."
+          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSize to Full but composes more naturally for the Sheet+Dialog mixed case. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "MobileSwipeToClose",
           "type": "bool?",
           "default": null,
-          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down."
+          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down. Applies to: Sheet."
         },
         {
           "name": "MobileSheetSize",
           "type": "SheetSize?",
           "default": null,
-          "summary": "Sheet size to use when the viewport is below MobileBreakpoint. Null = use SheetSize at all sizes. Typical pattern: SheetSize.Default on desktop, SheetSize.Full on mobile."
+          "summary": "Legacy Sheet-only alias for MobileSize. Applies to: Sheet. Reads/writes MobileSize via a 1:1 mapping (null round-trips to null). Kept for source compatibility with pre-3.6 callers."
+        },
+        {
+          "name": "MobileSize",
+          "type": "OverlaySize?",
+          "default": null,
+          "summary": "Overlay size to use when the viewport is below MobileBreakpoint. Null = use Size at all sizes. Typical pattern: OverlaySize.Default on desktop, OverlaySize.Full on mobile. Applies to: Dialog, Sheet."
         },
         {
           "name": "MobileSheetSide",
           "type": "Lumeo.Side?",
           "default": null,
-          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile."
+          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile. Applies to: Sheet."
         },
         {
           "name": "MobileBreakpoint",
           "type": "int?",
           "default": "768",
-          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated."
+          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated. Applies to: Dialog, Sheet, Drawer (gates every Mobile* override)."
         },
         {
           "name": "SwipeToClose",
           "type": "bool",
           "default": null,
-          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour."
+          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour. Applies to: Sheet."
         },
         {
           "name": "SheetSize",
           "type": "SheetSize",
-          "default": "SheetSize.Default",
-          "summary": null
+          "default": null,
+          "summary": "Legacy Sheet-only size alias. Applies to: Sheet. Reads/writes Size via a 1:1 mapping; setting either sets the same backing value. Kept for source compatibility with pre-3.6 callers."
+        },
+        {
+          "name": "Size",
+          "type": "OverlaySize",
+          "default": "OverlaySize.Default",
+          "summary": "Overlay content size. Applies to: Dialog, Sheet. (Drawer sizes to its content and ignores this.) For a Dialog it maps to the max-w-* preset (Sm→max-w-sm … Xl→max-w-4xl, Full→near-viewport); for a Sheet it maps to the side-appropriate width (Left/Right) or height (Top/Bottom). Replaces the Sheet-only SheetSize as the single size knob for service overlays."
         },
         {
           "name": "SheetSide",
           "type": "Lumeo.Side",
           "default": "Lumeo.Side.Right",
-          "summary": null
+          "summary": "Edge the sheet slides in from. Applies to: Sheet."
         },
         {
           "name": "PreventClose",
           "type": "bool",
           "default": null,
-          "summary": null
+          "summary": "Suppress dismissal via backdrop click / Escape. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "Class",
           "type": "string?",
           "default": null,
-          "summary": null
+          "summary": "Extra CSS classes merged onto the overlay's content element. Applies to: Dialog, Sheet, Drawer."
         }
       ],
       "methods": [],
@@ -2736,67 +2760,79 @@
           "name": "Class",
           "type": "string?",
           "default": null,
-          "summary": null
+          "summary": "Extra CSS classes merged onto the overlay's content element. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "PreventClose",
           "type": "bool",
           "default": null,
-          "summary": null
+          "summary": "Suppress dismissal via backdrop click / Escape. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "SheetSide",
           "type": "Lumeo.Side",
           "default": "Lumeo.Side.Right",
-          "summary": null
+          "summary": "Edge the sheet slides in from. Applies to: Sheet."
+        },
+        {
+          "name": "Size",
+          "type": "OverlaySize",
+          "default": "OverlaySize.Default",
+          "summary": "Overlay content size. Applies to: Dialog, Sheet. (Drawer sizes to its content and ignores this.) For a Dialog it maps to the max-w-* preset (Sm→max-w-sm … Xl→max-w-4xl, Full→near-viewport); for a Sheet it maps to the side-appropriate width (Left/Right) or height (Top/Bottom). Replaces the Sheet-only SheetSize as the single size knob for service overlays."
         },
         {
           "name": "SheetSize",
           "type": "SheetSize",
-          "default": "SheetSize.Default",
-          "summary": null
+          "default": null,
+          "summary": "Legacy Sheet-only size alias. Applies to: Sheet. Reads/writes Size via a 1:1 mapping; setting either sets the same backing value. Kept for source compatibility with pre-3.6 callers."
         },
         {
           "name": "SwipeToClose",
           "type": "bool",
           "default": null,
-          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour."
+          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour. Applies to: Sheet."
         },
         {
           "name": "MobileBreakpoint",
           "type": "int?",
           "default": "768",
-          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated."
+          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated. Applies to: Dialog, Sheet, Drawer (gates every Mobile* override)."
         },
         {
           "name": "MobileSheetSide",
           "type": "Lumeo.Side?",
           "default": null,
-          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile."
+          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile. Applies to: Sheet."
+        },
+        {
+          "name": "MobileSize",
+          "type": "OverlaySize?",
+          "default": null,
+          "summary": "Overlay size to use when the viewport is below MobileBreakpoint. Null = use Size at all sizes. Typical pattern: OverlaySize.Default on desktop, OverlaySize.Full on mobile. Applies to: Dialog, Sheet."
         },
         {
           "name": "MobileSheetSize",
           "type": "SheetSize?",
           "default": null,
-          "summary": "Sheet size to use when the viewport is below MobileBreakpoint. Null = use SheetSize at all sizes. Typical pattern: SheetSize.Default on desktop, SheetSize.Full on mobile."
+          "summary": "Legacy Sheet-only alias for MobileSize. Applies to: Sheet. Reads/writes MobileSize via a 1:1 mapping (null round-trips to null). Kept for source compatibility with pre-3.6 callers."
         },
         {
           "name": "MobileSwipeToClose",
           "type": "bool?",
           "default": null,
-          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down."
+          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down. Applies to: Sheet."
         },
         {
           "name": "MobileFullscreen",
           "type": "bool",
           "default": null,
-          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSheetSize to Full but composes more naturally for the Sheet+Dialog mixed case."
+          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSize to Full but composes more naturally for the Sheet+Dialog mixed case. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "ScrollableBody",
           "type": "bool",
           "default": "true",
-          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas)."
+          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas). Applies to: Sheet."
         }
       ],
       "methods": [],
@@ -2945,6 +2981,37 @@
       ],
       "enumValues": []
     },
+    {
+      "name": "OverlaySize",
+      "kind": "enum",
+      "namespace": "Lumeo.Services",
+      "summary": "Unified overlay content size as exposed through OverlayService. Drives both DialogContent.DialogSize and SheetContent.SheetSize from a single Size value, so the same options record can size a Dialog or a Sheet. Kept in the service layer (not the UI namespace) so consumers don't take a hard UI dependency. Full is layout-intent (entire viewport).",
+      "properties": [],
+      "methods": [],
+      "events": [],
+      "enumValues": [
+        {
+          "name": "Sm",
+          "summary": null
+        },
+        {
+          "name": "Default",
+          "summary": null
+        },
+        {
+          "name": "Lg",
+          "summary": null
+        },
+        {
+          "name": "Xl",
+          "summary": null
+        },
+        {
+          "name": "Full",
+          "summary": null
+        }
+      ]
+    },
     {
       "name": "OverlayType",
       "kind": "enum",
@@ -2982,67 +3049,79 @@
           "name": "ScrollableBody",
           "type": "bool",
           "default": "true",
-          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas)."
+          "summary": "Wrap the rendered component in a scrollable body region inside the overlay's chrome (Sheet only — Dialog and Drawer manage their own scroll). Default true so consumers can pass a long form to OverlayService.ShowSheetAsync{T} without rolling their own overflow-y-auto wrapper — and without hitting the focus- ring clip that bare overflow-y: auto introduces (per spec, overflow-y: auto promotes overflow-x to auto too, which clips inputs' box-shadow focus rings at the left/right edge). The built-in wrapper uses the px-1 -mx-1 trick to give focus rings 4px breathing room without shifting the visual padding. Set to false for sheets whose content sets its own scrolling strategy (e.g. an embedded PdfViewer that already paints inside a fixed canvas). Applies to: Sheet."
         },
         {
           "name": "MobileFullscreen",
           "type": "bool",
           "default": null,
-          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSheetSize to Full but composes more naturally for the Sheet+Dialog mixed case."
+          "summary": "When true and the viewport width is below MobileBreakpoint, the overlay is forced full-screen (full width + full height, no corner radius). Works across Dialog, Sheet and Drawer overlays — replaces the consumer-side max-md:!h-full max-md:!w-full max-md:!max-w-full Tailwind override chain that was previously the only way to get a full-screen Dialog on mobile. For Sheets, this is equivalent to setting MobileSize to Full but composes more naturally for the Sheet+Dialog mixed case. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "MobileSwipeToClose",
           "type": "bool?",
           "default": null,
-          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down."
+          "summary": "SwipeToClose override below MobileBreakpoint. Null = use SwipeToClose at all sizes. Typical pattern: off on desktop, on for mobile bottom-sheet pull-down. Applies to: Sheet."
         },
         {
           "name": "MobileSheetSize",
           "type": "SheetSize?",
           "default": null,
-          "summary": "Sheet size to use when the viewport is below MobileBreakpoint. Null = use SheetSize at all sizes. Typical pattern: SheetSize.Default on desktop, SheetSize.Full on mobile."
+          "summary": "Legacy Sheet-only alias for MobileSize. Applies to: Sheet. Reads/writes MobileSize via a 1:1 mapping (null round-trips to null). Kept for source compatibility with pre-3.6 callers."
+        },
+        {
+          "name": "MobileSize",
+          "type": "OverlaySize?",
+          "default": null,
+          "summary": "Overlay size to use when the viewport is below MobileBreakpoint. Null = use Size at all sizes. Typical pattern: OverlaySize.Default on desktop, OverlaySize.Full on mobile. Applies to: Dialog, Sheet."
         },
         {
           "name": "MobileSheetSide",
           "type": "Lumeo.Side?",
           "default": null,
-          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile."
+          "summary": "Sheet side to use when the viewport is below MobileBreakpoint. Null = use SheetSide at all sizes. Typical pattern: Lumeo.Side.Right on desktop, Lumeo.Side.Bottom on mobile. Applies to: Sheet."
         },
         {
           "name": "MobileBreakpoint",
           "type": "int?",
           "default": "768",
-          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated."
+          "summary": "Viewport width threshold (CSS pixels) below which the Mobile* overrides apply. Default 768 (Tailwind md). Set to null to disable responsive switching even if the Mobile* fields are populated. Applies to: Dialog, Sheet, Drawer (gates every Mobile* override)."
         },
         {
           "name": "SwipeToClose",
           "type": "bool",
           "default": null,
-          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour."
+          "summary": "When true, a Sheet opened via OverlayService.ShowSheetAsync{T} can be dismissed by swiping in the direction opposite to its SheetSide (e.g. swipe-down on a Bottom sheet). Ignored for non-Sheet overlay types. Drawers already enable swipe by default. Default false to preserve the existing programmatic-open behaviour. Applies to: Sheet."
         },
         {
           "name": "SheetSize",
           "type": "SheetSize",
-          "default": "SheetSize.Default",
-          "summary": null
+          "default": null,
+          "summary": "Legacy Sheet-only size alias. Applies to: Sheet. Reads/writes Size via a 1:1 mapping; setting either sets the same backing value. Kept for source compatibility with pre-3.6 callers."
+        },
+        {
+          "name": "Size",
+          "type": "OverlaySize",
+          "default": "OverlaySize.Default",
+          "summary": "Overlay content size. Applies to: Dialog, Sheet. (Drawer sizes to its content and ignores this.) For a Dialog it maps to the max-w-* preset (Sm→max-w-sm … Xl→max-w-4xl, Full→near-viewport); for a Sheet it maps to the side-appropriate width (Left/Right) or height (Top/Bottom). Replaces the Sheet-only SheetSize as the single size knob for service overlays."
         },
         {
           "name": "SheetSide",
           "type": "Lumeo.Side",
           "default": "Lumeo.Side.Right",
-          "summary": null
+          "summary": "Edge the sheet slides in from. Applies to: Sheet."
         },
         {
           "name": "PreventClose",
           "type": "bool",
           "default": null,
-          "summary": null
+          "summary": "Suppress dismissal via backdrop click / Escape. Applies to: Dialog, Sheet, Drawer."
         },
         {
           "name": "Class",
           "type": "string?",
           "default": null,
-          "summary": null
+          "summary": "Extra CSS classes merged onto the overlay's content element. Applies to: Dialog, Sheet, Drawer."
         }
       ],
       "methods": [],
@@ -3053,7 +3132,7 @@
       "name": "SheetSize",
       "kind": "enum",
       "namespace": "Lumeo.Services",
-      "summary": "Sheet size as exposed through OverlayService. Mirrors SheetContent.SheetSize — kept distinct so the service layer doesn't take a hard dependency on the UI namespace. Full is layout-intent (entire viewport) and intentionally NOT folded into Size.",
+      "summary": "Sheet size as exposed through OverlayService. Mirrors SheetContent.SheetSize — kept distinct so the service layer doesn't take a hard dependency on the UI namespace. Full is layout-intent (entire viewport) and intentionally NOT folded into Size. Retained as the parameter type of OverlayService.ShowSheetAsync{T} and as the backing type of the obsolete SheetSize alias; new code should prefer OverlaySize.",
       "properties": [],
       "methods": [],
       "events": [],
@@ -5818,6 +5897,10 @@
           "title": "Variants",
           "code": "<Badge>Default</Badge>\n<Badge Variant=\"Badge.BadgeVariant.Secondary\">Secondary</Badge>\n<Badge Variant=\"Badge.BadgeVariant.Outline\">Outline</Badge>\n<Badge Variant=\"Badge.BadgeVariant.Destructive\">Destructive</Badge>\n<Badge Variant=\"Badge.BadgeVariant.Success\">Success</Badge>\n<Badge Variant=\"Badge.BadgeVariant.Warning\">Warning</Badge>"
         },
+        {
+          "title": "Sizes &amp; Pill",
+          "code": "<Badge Size=\"Badge.BadgeSize.Sm\">Small</Badge>\n<Badge Size=\"Badge.BadgeSize.Md\">Medium</Badge>\n<Badge Size=\"Badge.BadgeSize.Lg\">Large</Badge>\n\n<Badge Pill=\"true\">99+</Badge>\n<Badge Pill=\"true\" Variant=\"Badge.BadgeVariant.Secondary\">New</Badge>\n<Badge Pill=\"true\" Size=\"Badge.BadgeSize.Lg\" Variant=\"Badge.BadgeVariant.Success\">Online</Badge>"
+        },
         {
           "title": "Variant (interactive)",
           "code": "<Segmented @bind-Value=\"_variant\">\n    <SegmentedItem Value=\"@Badge.BadgeVariant.Default\">Default</SegmentedItem>\n    <SegmentedItem Value=\"@Badge.BadgeVariant.Secondary\">Secondary</SegmentedItem>\n    <SegmentedItem Value=\"@Badge.BadgeVariant.Outline\">Outline</SegmentedItem>\n    <SegmentedItem Value=\"@Badge.BadgeVariant.Destructive\">Destructive</SegmentedItem>\n    <SegmentedItem Value=\"@Badge.BadgeVariant.Success\">Success</SegmentedItem>\n    <SegmentedItem Value=\"@Badge.BadgeVariant.Warning\">Warning</SegmentedItem>\n</Segmented>\n<Badge Variant=\"@_variant\">@_variant.ToString()</Badge>\n\n@code { private Badge.BadgeVariant _variant = Badge.BadgeVariant.Default; }"
@@ -5825,10 +5908,6 @@
         {
           "title": "Usage Examples",
           "code": "<Flex Align=\"center\" Gap=\"2\">\n    <Lumeo.Text As=\"span\" Size=\"sm\" Weight=\"medium\">Status</Lumeo.Text>\n    <Badge Variant=\"Badge.BadgeVariant.Success\">Active</Badge>\n</Flex>\n<Flex Align=\"center\" Gap=\"2\">\n    <Lumeo.Text As=\"span\" Size=\"sm\" Weight=\"medium\">Priority</Lumeo.Text>\n    <Badge Variant=\"Badge.BadgeVariant.Destructive\">High</Badge>\n</Flex>"
-        },
-        {
-          "title": "In a Card",
-          "code": "<Card>\n    <CardHeader>\n        <Flex Align=\"center\" Justify=\"between\">\n            <Heading Level=\"3\" Size=\"lg\">Notifications</Heading>\n            <Badge>3 new</Badge>\n        </Flex>\n        <Lumeo.Text Size=\"sm\" Color=\"muted\">You have unread messages.</Lumeo.Text>\n    </CardHeader>\n</Card>"
         }
       ],
       "subComponents": {},
@@ -38578,6 +38657,14 @@
           "isCascading": false,
           "captureUnmatched": false
         },
+        {
+          "name": "FocusRingGutter",
+          "type": "bool",
+          "default": null,
+          "description": "Adds a 4px inline gutter (-mx-1 px-1, net-zero layout) so a focusable control's focus ring isn't clipped at the left/right edge. Per CSS spec overflow-auto on one axis promotes the other to auto too, so a full-width &lt;Input&gt; flush against the scroll box loses its box-shadow ring on that edge. Opt-in (default false) because the negative margin makes the element 4px wider per side — only enable when the scroll area holds focusable controls (forms, menus), not when it wraps edge-aligned content like a table.",
+          "isCascading": false,
+          "captureUnmatched": false
+        },
         {
           "name": "Class",
           "type": "string?",
@@ -38617,6 +38704,10 @@
         {
           "title": "Horizontal Scroll",
           "code": "<ScrollArea Class=\"w-full whitespace-nowrap rounded-md border p-4\">\n    <div class=\"flex gap-4\">\n        @for (var i = 1; i <= 12; i++)\n        {\n            <div class=\"flex-shrink-0 w-32 h-20 rounded-md bg-muted flex items-center justify-center\">\n                Item @i\n            </div>\n        }\n    </div>\n</ScrollArea>"
+        },
+        {
+          "title": "Focus Ring Gutter",
+          "code": "@* padding on the inner wrapper, not the ScrollArea root *@\n<ScrollArea FocusRingGutter=\"true\" Class=\"h-64 rounded-md border\">\n    <Stack Gap=\"3\" Class=\"p-4\">\n        <FormField Label=\"Full name\"><Input placeholder=\"Full name\" /></FormField>\n        <FormField Label=\"Email\"><Input placeholder=\"Email\" /></FormField>\n        <Button Class=\"w-full\">Save</Button>\n    </Stack>\n</ScrollArea>"
         }
       ],
       "subComponents": {},
@@ -40499,7 +40590,7 @@
       "examples": [
         {
           "title": "Push (Default)",
-          "code": "<SidebarProvider @bind-IsCollapsed=\"_isCollapsed\">\n    <SidebarComponent>\n        <SidebarHeader>\n            <Lumeo.Text As=\"span\" Size=\"sm\" Weight=\"semibold\">Acme Inc</Lumeo.Text>\n        </SidebarHeader>\n        <SidebarContent>\n            <SidebarGroup>\n                <SidebarGroupLabel>Platform</SidebarGroupLabel>\n                <SidebarMenu>\n                    <SidebarMenuItem>\n                        <SidebarMenuButton Href=\"#\" IsActive=\"true\">\n                            <IconContent><Blazicon Svg=\"Lucide.House\" class=\"h-4 w-4\" /></IconContent>\n                            <LabelContent><span>Dashboard</span></LabelContent>\n                        </SidebarMenuButton>\n                    </SidebarMenuItem>\n                </SidebarMenu>\n            </SidebarGroup>\n        </SidebarContent>\n        <SidebarFooter>\n            <Avatar Src=\"\" Fallback=\"CN\" />\n        </SidebarFooter>\n    </SidebarComponent>\n    <main class=\"flex-1 p-6\">\n        <SidebarTrigger />\n    </main>\n</SidebarProvider>"
+          "code": "<SidebarProvider @bind-IsCollapsed=\"_isCollapsed\">\n    <SidebarComponent>\n        <SidebarHeader>\n            <Lumeo.Text As=\"span\" Size=\"sm\" Weight=\"semibold\">Acme Inc</Lumeo.Text>\n        </SidebarHeader>\n        <SidebarContent>\n            <SidebarGroup>\n                <SidebarGroupLabel>Platform</SidebarGroupLabel>\n                <SidebarMenu>\n                    <SidebarMenuItem>\n                        <SidebarMenuButton Href=\"#\" IsActive=\"true\">\n                            <IconContent><Blazicon Svg=\"Lucide.House\" class=\"h-4 w-4\" /></IconContent>\n                            <LabelContent><span>Dashboard</span></LabelContent>\n                        </SidebarMenuButton>\n                    </SidebarMenuItem>\n                </SidebarMenu>\n            </SidebarGroup>\n        </SidebarContent>\n        <SidebarFooter>\n            <Avatar><AvatarFallback>CN</AvatarFallback></Avatar>\n        </SidebarFooter>\n    </SidebarComponent>\n    <main class=\"flex-1 p-6\">\n        <SidebarTrigger />\n    </main>\n</SidebarProvider>"
         },
         {
           "title": "Overlay",

package/src/registry.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://lumeo.nativ.sh/registry-schema.json",
-  "version": "3.5.2",
-  "generated": "2026-05-28T12:37:45.1405814Z",
+  "version": "3.6.0",
+  "generated": "2026-05-28T15:34:30.4827448Z",
   "components": {
     "accordion": {
       "name": "Accordion",