@lumeo-ui/mcp-server 4.0.3 → 4.1.0-preview.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumeo-ui/mcp-server",
-  "version": "4.0.3",
+  "version": "4.1.0-preview.1",
   "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,10 +1,10 @@
 {
   "$schema": "https://lumeo.nativ.sh/components-api-schema.json",
-  "version": "4.0.3",
-  "generated": "2026-07-01T16:03:19.2439901Z",
+  "version": "4.1.0-preview.1",
+  "generated": "2026-07-02T08:47:23.5739781Z",
   "stats": {
     "componentCount": 164,
-    "totalParameters": 4153,
+    "totalParameters": 4166,
     "totalEnums": 74,
     "totalRecords": 72,
     "serviceCount": 33,
@@ -1335,6 +1335,12 @@
           "signature": "PrefersReducedMotion()",
           "summary": null
         },
+        {
+          "name": "IsActiveElementFocusVisible",
+          "returnType": "ValueTask<bool>",
+          "signature": "IsActiveElementFocusVisible()",
+          "summary": null
+        },
         {
           "name": "TouchRippleCoords",
           "returnType": "ValueTask<RipplePoint>",
@@ -1818,6 +1824,12 @@
           "default": "Lumeo.Side.Right",
           "summary": "Edge the sheet slides in from. Applies to: Sheet."
         },
+        {
+          "name": "ShowCloseButton",
+          "type": "bool?",
+          "default": null,
+          "summary": "Whether the shell renders its top-end close (X) button. null (default) keeps the legacy coupling — the X shows whenever PreventClose is false. Set true to force the X even on a modal overlay (PreventClose=true: backdrop/Escape stay disabled, but the X still offers an explicit way out — it routes through the same dismiss guard, so an OnBeforeClose veto still applies), or false to hide it and own the close chrome yourself. Applies to: Dialog, Sheet. (Drawer has no X by design — drag handle.)"
+        },
         {
           "name": "PreventClose",
           "type": "bool",
@@ -1907,6 +1919,12 @@
           "default": "Lumeo.Side.Right",
           "summary": "Edge the sheet slides in from. Applies to: Sheet."
         },
+        {
+          "name": "ShowCloseButton",
+          "type": "bool?",
+          "default": null,
+          "summary": "Whether the shell renders its top-end close (X) button. null (default) keeps the legacy coupling — the X shows whenever PreventClose is false. Set true to force the X even on a modal overlay (PreventClose=true: backdrop/Escape stay disabled, but the X still offers an explicit way out — it routes through the same dismiss guard, so an OnBeforeClose veto still applies), or false to hide it and own the close chrome yourself. Applies to: Dialog, Sheet. (Drawer has no X by design — drag handle.)"
+        },
         {
           "name": "PreventClose",
           "type": "bool",
@@ -2555,6 +2573,12 @@
           "signature": "PrefersReducedMotion()",
           "summary": "Core-side prefers-reduced-motion: reduce query (mirrors the Lumeo.Motion helper) for core components that animate via Blazor/JS and can't be fully neutralised by a CSS @media block alone. Default returns false (motion allowed) so existing implementers/test doubles keep compiling unchanged."
         },
+        {
+          "name": "IsActiveElementFocusVisible",
+          "returnType": "ValueTask<bool>",
+          "signature": "IsActiveElementFocusVisible()",
+          "summary": "True when the currently-focused element is in the browser's :focus-visible state (keyboard/programmatic focus) rather than a plain :focus a mouse click also leaves behind. Tooltip uses this to gate opening on focusin so a clicked-then-abandoned trigger doesn't stay open forever — a native button keeps DOM focus after a mouse click with nothing to clear it, but :focus-visible is false for that case in supporting browsers. Default returns true (old behaviour: always open on focus) so existing implementers/test doubles — which have no real DOM to query — keep compiling and behaving unchanged."
+        },
         {
           "name": "TouchRippleCoords",
           "returnType": "ValueTask<RipplePoint>",
@@ -3224,6 +3248,12 @@
           "default": null,
           "summary": "Suppress dismissal via backdrop click / Escape. Applies to: Dialog, Sheet, Drawer."
         },
+        {
+          "name": "ShowCloseButton",
+          "type": "bool?",
+          "default": null,
+          "summary": "Whether the shell renders its top-end close (X) button. null (default) keeps the legacy coupling — the X shows whenever PreventClose is false. Set true to force the X even on a modal overlay (PreventClose=true: backdrop/Escape stay disabled, but the X still offers an explicit way out — it routes through the same dismiss guard, so an OnBeforeClose veto still applies), or false to hide it and own the close chrome yourself. Applies to: Dialog, Sheet. (Drawer has no X by design — drag handle.)"
+        },
         {
           "name": "SheetSide",
           "type": "Lumeo.Side",
@@ -3567,6 +3597,12 @@
           "default": "Lumeo.Side.Right",
           "summary": "Edge the sheet slides in from. Applies to: Sheet."
         },
+        {
+          "name": "ShowCloseButton",
+          "type": "bool?",
+          "default": null,
+          "summary": "Whether the shell renders its top-end close (X) button. null (default) keeps the legacy coupling — the X shows whenever PreventClose is false. Set true to force the X even on a modal overlay (PreventClose=true: backdrop/Escape stay disabled, but the X still offers an explicit way out — it routes through the same dismiss guard, so an OnBeforeClose veto still applies), or false to hide it and own the close chrome yourself. Applies to: Dialog, Sheet. (Drawer has no X by design — drag handle.)"
+        },
         {
           "name": "PreventClose",
           "type": "bool",
@@ -26816,6 +26852,15 @@
           "captureUnmatched": false,
           "isEditorRequired": false
         },
+        {
+          "name": "FullWidth",
+          "type": "bool",
+          "default": null,
+          "description": "When true, the date picker expands to fill its container width — equivalent to FullWidth on a Button. Propagates w-full to the Popover wrapper and PopoverTrigger so the constraint reaches the rendered trigger element through the shrink-wrap chain.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
         {
           "name": "AutoFocus",
           "type": "bool",
@@ -27080,6 +27125,15 @@
               "captureUnmatched": false,
               "isEditorRequired": false
             },
+            {
+              "name": "FullWidth",
+              "type": "bool",
+              "default": null,
+              "description": "When true, the date range picker expands to fill its container width. Forwarded directly to the inner DatePicker.",
+              "isCascading": false,
+              "captureUnmatched": false,
+              "isEditorRequired": false
+            },
             {
               "name": "FirstDayOfWeek",
               "type": "DayOfWeek?",
@@ -28180,6 +28234,15 @@
               "captureUnmatched": false,
               "isEditorRequired": false
             },
+            {
+              "name": "ShowCloseButton",
+              "type": "bool?",
+              "default": null,
+              "description": "Whether the top-end close (X) button renders. null (default) keeps the legacy coupling — X shows whenever PreventClose is false. true forces the X even on a modal dialog (backdrop/Escape stay disabled; the X still routes through the dismiss guard so an OnBeforeClose veto applies); false hides it for fully custom close chrome. Mirrors OverlayOptions.ShowCloseButton for service dialogs.",
+              "isCascading": false,
+              "captureUnmatched": false,
+              "isEditorRequired": false
+            },
             {
               "name": "Size",
               "type": "DialogSize",
@@ -36281,7 +36344,43 @@
           "name": "Cluster",
           "type": "bool",
           "default": null,
-          "description": "Marker clustering via leaflet.markercluster. CDN-loaded on first use; falls back to plain markers if the script fails to fetch.",
+          "description": "Enable MapLibre GL native marker clustering. When true, markers are aggregated into circle bubbles via a GeoJSON cluster source — no additional script is fetched. Cluster bubbles are tinted with --lumeo-map-cluster-highlight (default amber) when at least one child marker is Highlighted. Fine-tune with ClusterRadius, ClusterMaxZoom, ClusterProperties, and ClusterColorExpression.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
+        {
+          "name": "ClusterProperties",
+          "type": "Dictionary<string, object[]>?",
+          "default": null,
+          "description": "Additional MapLibre clusterProperties expressions merged into the GeoJSON cluster source alongside the built-in highlighted aggregator. Each entry maps a property name to a raw [operator, expression] array — e.g. { \"totalScore\", new object[] { \"+\", new object[] { \"get\", \"score\" } } }. Only meaningful when Cluster is true. Built-in keys (highlighted) win on collision.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
+        {
+          "name": "ClusterColorExpression",
+          "type": "object[]?",
+          "default": null,
+          "description": "Replaces the default circle-color MapLibre paint expression on cluster circles. The default expression tints any bubble that contains a highlighted marker with --lumeo-map-cluster-highlight (default amber). Pass a raw MapLibre expression array to drive cluster color from a custom aggregated property instead.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
+        {
+          "name": "ClusterRadius",
+          "type": "int",
+          "default": "50",
+          "description": "Target pixel radius of each cluster circle. Default is 50.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
+        {
+          "name": "ClusterMaxZoom",
+          "type": "int",
+          "default": "14",
+          "description": "Zoom level at which markers fully emerge from their cluster. Default is 14. Lower values break clusters apart at coarser zoom levels.",
           "isCascading": false,
           "captureUnmatched": false,
           "isEditorRequired": false
@@ -36411,7 +36510,9 @@
           "description": "Cascading context passed to MapMarker + shape children so they can register themselves with the parent Map."
         }
       ],
-      "gotchas": [],
+      "gotchas": [
+        "MapLibre GL JS and its stylesheet are loaded at runtime from unpkg (CDN) the first time a Map mounts. For strict-CSP or air-gapped deployments, self-host them and set window.lumeoCdn = { mapLibreJs: '/your/maplibre-gl.js', mapLibreCss: '/your/maplibre-gl.css' } before the first Map renders, or run `lumeo deps install --lib maplibre` (CLI). See /docs/cdn-deps."
+      ],
       "cssVars": [
         "--color-background",
         "--color-border",
@@ -36980,6 +37081,24 @@
               "captureUnmatched": false,
               "isEditorRequired": false
             },
+            {
+              "name": "ClusterExclude",
+              "type": "bool",
+              "default": null,
+              "description": "When true and the parent Map has Cluster enabled, this marker is rendered as a DOM element rather than being absorbed into the cluster source. Use for permanently-visible markers (e.g. a depot, a selected result) that must never be hidden inside a cluster bubble. Default is false.",
+              "isCascading": false,
+              "captureUnmatched": false,
+              "isEditorRequired": false
+            },
+            {
+              "name": "Properties",
+              "type": "Dictionary<string, object>?",
+              "default": null,
+              "description": "Arbitrary key-value properties merged into this marker's GeoJSON feature when Cluster is enabled. Drives custom ClusterProperties aggregation expressions (e.g. a score field summed across the cluster). Built-in keys (id, highlighted, color, hasClick) win on collision.",
+              "isCascading": false,
+              "captureUnmatched": false,
+              "isEditorRequired": false
+            },
             {
               "name": "MapCtx",
               "type": "Map.MapContext?",
@@ -41285,7 +41404,9 @@
         }
       ],
       "records": [],
-      "gotchas": [],
+      "gotchas": [
+        "pdf.js and its worker are loaded at runtime from jsDelivr (CDN) the first time a PdfViewer mounts. For strict-CSP or air-gapped deployments, self-host them and set window.lumeoCdn = { pdfJs: '/your/pdf.min.mjs', pdfJsWorker: '/your/pdf.worker.min.mjs' } before the first PdfViewer renders, or run `lumeo deps install --lib pdfjs` (CLI). See /docs/cdn-deps."
+      ],
       "cssVars": [
         "--color-accent",
         "--color-accent-foreground",
@@ -41967,6 +42088,15 @@
           "captureUnmatched": false,
           "isEditorRequired": false
         },
+        {
+          "name": "Class",
+          "type": "string?",
+          "default": null,
+          "description": "Extra CSS classes for the popover ROOT wrapper div, e.g. w-full to un-shrink-wrap a full-width trigger contained inside. The base classes (relative inline-block outline-none) are always preserved.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
         {
           "name": "AdditionalAttributes",
           "type": "Dictionary<string, object>?",
@@ -47664,6 +47794,15 @@
               "captureUnmatched": false,
               "isEditorRequired": false
             },
+            {
+              "name": "ShowCloseButton",
+              "type": "bool?",
+              "default": null,
+              "description": "Whether the top-end close (X) button renders. null (default) keeps the legacy coupling — X shows whenever PreventClose is false. true forces the X on a modal sheet (backdrop/Escape stay disabled; the X routes through the dismiss guard); false hides it. Mirrors OverlayOptions.ShowCloseButton for service sheets.",
+              "isCascading": false,
+              "captureUnmatched": false,
+              "isEditorRequired": false
+            },
             {
               "name": "SwipeToClose",
               "type": "bool",
@@ -55139,6 +55278,15 @@
           "captureUnmatched": false,
           "isEditorRequired": false
         },
+        {
+          "name": "FullWidth",
+          "type": "bool",
+          "default": null,
+          "description": "When true, the time picker expands to fill its container width — equivalent to FullWidth on a Button. Propagates w-full to the Popover wrapper, PopoverTrigger, and the trigger button so the constraint reaches the rendered element through the shrink-wrap chain.",
+          "isCascading": false,
+          "captureUnmatched": false,
+          "isEditorRequired": false
+        },
         {
           "name": "AdditionalAttributes",
           "type": "Dictionary<string, object>?",
@@ -56788,6 +56936,15 @@
               "captureUnmatched": false,
               "isEditorRequired": false
             },
+            {
+              "name": "Align",
+              "type": "Lumeo.Align",
+              "default": "Lumeo.Align.Center",
+              "description": null,
+              "isCascading": false,
+              "captureUnmatched": false,
+              "isEditorRequired": false
+            },
             {
               "name": "ShowArrow",
               "type": "bool",

package/src/registry.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://lumeo.nativ.sh/registry-schema.json",
-  "version": "4.0.3",
-  "generated": "2026-07-01T16:03:18.0127450Z",
+  "version": "4.1.0-preview.1",
+  "generated": "2026-07-02T08:47:21.7648612Z",
   "components": {
     "accordion": {
       "name": "Accordion",
@@ -1390,8 +1390,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/combobox.json",
       "testCoverage": {
         "tier": 3,
-        "files": 10,
-        "tests": 93,
+        "files": 11,
+        "tests": 97,
         "relatedFiles": 0,
         "render": true,
         "behavior": true,
@@ -1873,8 +1873,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/date-picker.json",
       "testCoverage": {
         "tier": 3,
-        "files": 10,
-        "tests": 56,
+        "files": 11,
+        "tests": 64,
         "relatedFiles": 1,
         "render": true,
         "behavior": true,
@@ -2083,7 +2083,7 @@
         "tier": 4,
         "files": 9,
         "tests": 44,
-        "relatedFiles": 1,
+        "relatedFiles": 2,
         "render": true,
         "behavior": true,
         "a11y": true,
@@ -2197,7 +2197,7 @@
         "tier": 4,
         "files": 4,
         "tests": 31,
-        "relatedFiles": 0,
+        "relatedFiles": 1,
         "render": true,
         "behavior": true,
         "a11y": true,
@@ -3433,12 +3433,14 @@
         "--color-muted-foreground",
         "--radius"
       ],
-      "gotchas": [],
+      "gotchas": [
+        "MapLibre GL JS and its stylesheet are loaded at runtime from unpkg (CDN) the first time a Map mounts. For strict-CSP or air-gapped deployments, self-host them and set window.lumeoCdn = { mapLibreJs: '/your/maplibre-gl.js', mapLibreCss: '/your/maplibre-gl.css' } before the first Map renders, or run `lumeo deps install --lib maplibre` (CLI). See /docs/cdn-deps."
+      ],
       "registryUrl": "https://lumeo.nativ.sh/registry/map.json",
       "testCoverage": {
         "tier": 3,
-        "files": 4,
-        "tests": 13,
+        "files": 5,
+        "tests": 26,
         "relatedFiles": 0,
         "render": true,
         "behavior": true,
@@ -3828,8 +3830,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/overlay.json",
       "testCoverage": {
         "tier": 3,
-        "files": 4,
-        "tests": 25,
+        "files": 5,
+        "tests": 35,
         "relatedFiles": 0,
         "render": true,
         "behavior": true,
@@ -3867,7 +3869,7 @@
         "tier": 3,
         "files": 4,
         "tests": 16,
-        "relatedFiles": 0,
+        "relatedFiles": 1,
         "render": true,
         "behavior": true,
         "a11y": true,
@@ -3998,7 +4000,9 @@
         "--color-ring",
         "--radius"
       ],
-      "gotchas": [],
+      "gotchas": [
+        "pdf.js and its worker are loaded at runtime from jsDelivr (CDN) the first time a PdfViewer mounts. For strict-CSP or air-gapped deployments, self-host them and set window.lumeoCdn = { pdfJs: '/your/pdf.min.mjs', pdfJsWorker: '/your/pdf.worker.min.mjs' } before the first PdfViewer renders, or run `lumeo deps install --lib pdfjs` (CLI). See /docs/cdn-deps."
+      ],
       "registryUrl": "https://lumeo.nativ.sh/registry/pdf-viewer.json",
       "testCoverage": {
         "tier": 3,
@@ -4172,8 +4176,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/popover.json",
       "testCoverage": {
         "tier": 4,
-        "files": 7,
-        "tests": 30,
+        "files": 8,
+        "tests": 34,
         "relatedFiles": 0,
         "render": true,
         "behavior": true,
@@ -4945,8 +4949,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/select.json",
       "testCoverage": {
         "tier": 4,
-        "files": 11,
-        "tests": 99,
+        "files": 12,
+        "tests": 105,
         "relatedFiles": 1,
         "render": true,
         "behavior": true,
@@ -5037,7 +5041,7 @@
         "tier": 4,
         "files": 7,
         "tests": 46,
-        "relatedFiles": 0,
+        "relatedFiles": 1,
         "render": true,
         "behavior": true,
         "a11y": true,
@@ -5139,7 +5143,7 @@
       "testCoverage": {
         "tier": 3,
         "files": 10,
-        "tests": 47,
+        "tests": 50,
         "relatedFiles": 0,
         "render": true,
         "behavior": true,
@@ -6287,8 +6291,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/time-picker.json",
       "testCoverage": {
         "tier": 3,
-        "files": 9,
-        "tests": 31,
+        "files": 10,
+        "tests": 38,
         "relatedFiles": 1,
         "render": true,
         "behavior": true,
@@ -6582,8 +6586,8 @@
       "registryUrl": "https://lumeo.nativ.sh/registry/tooltip.json",
       "testCoverage": {
         "tier": 4,
-        "files": 3,
-        "tests": 26,
+        "files": 5,
+        "tests": 40,
         "relatedFiles": 3,
         "render": true,
         "behavior": true,