@maltjoy/mcp-server 0.3.1 → 0.4.0

package/dist/doc/VJoyMultiCheckbox/metadata.json

@@ -1,13 +1,179 @@
 {
   "name": "JoyMultiCheckbox",
   "displayName": "VJoyMultiCheckbox",
+  "description": "A multi-selection checkbox group component for handling arrays of selected values.\nSimplifies multi-selection scenarios by managing checkbox states and array manipulation automatically.\nFeatures integrated labeling, fieldset structure for accessibility, and customizable checkbox content through slots.\nPerfect for filtering interfaces and bulk selection operations.",
+  "category": "Forms",
   "props": [
     {
       "name": "options",
-      "type": "Option[]",
-      "required": true,
+      "type": "Option[] | undefined",
+      "required": false,
       "description": "",
-      "possibleValues": null
+      "possibleValues": [
+        {
+          "kind": "array",
+          "type": "Option[]",
+          "schema": [
+            {
+              "kind": "object",
+              "type": "Option",
+              "schema": {
+                "id": {
+                  "name": "id",
+                  "global": false,
+                  "description": "",
+                  "tags": [],
+                  "required": true,
+                  "type": "string",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1310,
+                        1321
+                      ]
+                    }
+                  ],
+                  "schema": "string"
+                },
+                "name": {
+                  "name": "name",
+                  "global": false,
+                  "description": "",
+                  "tags": [],
+                  "required": false,
+                  "type": "string | undefined",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1330,
+                        1344
+                      ]
+                    }
+                  ],
+                  "schema": {
+                    "kind": "enum",
+                    "type": "string | undefined",
+                    "schema": [
+                      "undefined",
+                      "string"
+                    ]
+                  }
+                },
+                "value": {
+                  "name": "value",
+                  "global": false,
+                  "description": "",
+                  "tags": [],
+                  "required": true,
+                  "type": "string",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1353,
+                        1367
+                      ]
+                    }
+                  ],
+                  "schema": "string"
+                },
+                "label": {
+                  "name": "label",
+                  "global": false,
+                  "description": "",
+                  "tags": [],
+                  "required": true,
+                  "type": "string",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1376,
+                        1390
+                      ]
+                    }
+                  ],
+                  "schema": "string"
+                },
+                "subLabel": {
+                  "name": "subLabel",
+                  "global": false,
+                  "description": "",
+                  "tags": [],
+                  "required": false,
+                  "type": "string | undefined",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1399,
+                        1417
+                      ]
+                    }
+                  ],
+                  "schema": "string | undefined"
+                },
+                "disabled": {
+                  "name": "disabled",
+                  "global": false,
+                  "description": "",
+                  "tags": [
+                    {
+                      "name": "default",
+                      "text": "false"
+                    }
+                  ],
+                  "required": false,
+                  "type": "boolean | undefined",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1476,
+                        1495
+                      ]
+                    }
+                  ],
+                  "schema": {
+                    "kind": "enum",
+                    "type": "boolean | undefined",
+                    "schema": [
+                      "undefined",
+                      "false",
+                      "true"
+                    ]
+                  }
+                },
+                "required": {
+                  "name": "required",
+                  "global": false,
+                  "description": "",
+                  "tags": [
+                    {
+                      "name": "default",
+                      "text": "false"
+                    }
+                  ],
+                  "required": false,
+                  "type": "boolean | undefined",
+                  "declarations": [
+                    {
+                      "file": "/home/kevincarnaille/dev/design-system/packages/core-vue/src/components/JoyCheckboxGroup/VJoyCheckboxGroup.vue",
+                      "range": [
+                        1554,
+                        1573
+                      ]
+                    }
+                  ],
+                  "schema": "boolean | undefined"
+                }
+              }
+            }
+          ]
+        }
+      ]
     },
     {
       "name": "id",
@@ -22,7 +188,6 @@
       "name": "value",
       "type": "any[] | undefined",
       "required": false,
-      "default": "[]",
       "description": "TODO: better typings",
       "possibleValues": [
         {
@@ -34,11 +199,20 @@
         }
       ]
     },
+    {
+      "name": "direction",
+      "type": "CheckboxGroupDirection | undefined",
+      "required": false,
+      "description": "Switch checkboxes layout direction.",
+      "possibleValues": [
+        "vertical",
+        "horizontal"
+      ]
+    },
     {
       "name": "required",
       "type": "boolean | undefined",
       "required": false,
-      "default": "false",
       "description": "",
       "possibleValues": [
         "false",
@@ -58,7 +232,6 @@
       "name": "labelSize",
       "type": "TJoyLabelSizes | undefined",
       "required": false,
-      "default": "\"medium\"",
       "description": "",
       "possibleValues": [
         "medium",
@@ -79,7 +252,6 @@
       "name": "requiredMark",
       "type": "boolean | undefined",
       "required": false,
-      "default": "false",
       "description": "",
       "possibleValues": [
         "false",
@@ -95,6 +267,10 @@
     }
   ],
   "slots": [
+    {
+      "name": "default",
+      "description": "Allows explicit declaration of VJoyCheckbox / VJoyCheckboxCard children in the group.\n\n**Important**: v-model has to be handled by consumer."
+    },
     {
       "name": "checkbox",
       "description": "Customize the inner content of each checkboxes"
@@ -111,6 +287,16 @@
       "type": "any[]",
       "isMethod": false
     },
+    {
+      "name": "options",
+      "type": "Option[]",
+      "isMethod": false
+    },
+    {
+      "name": "direction",
+      "type": "CheckboxGroupDirection",
+      "isMethod": false
+    },
     {
       "name": "labelSize",
       "type": "TJoyLabelSizes",
@@ -131,11 +317,6 @@
       "type": "string | undefined",
       "isMethod": false
     },
-    {
-      "name": "options",
-      "type": "Option[]",
-      "isMethod": false
-    },
     {
       "name": "optionalLabel",
       "type": "string | undefined",

package/dist/doc/VJoyPagination/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyPagination",
   "displayName": "VJoyPagination",
+  "description": "A complete pagination component for navigating through large datasets with proper accessibility support.\nFeatures automatic page number calculation, gap handling for large page counts, customizable navigation arrows,\nand router integration support through slots. Includes proper ARIA attributes and keyboard navigation\nfor an accessible pagination experience across different content types.",
+  "category": "Navigation",
   "props": [
     {
       "name": "currentPage",

package/dist/doc/VJoyPanel/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyPanel",
   "displayName": "VJoyPanel",
+  "description": "A structured content container component providing consistent layout patterns for cards and sections.\nFeatures header with title/subtitle/actions, main body content, footer actions, and loading overlay support.\nIncludes flexible sizing, padding options, AI variant styling, and seamless integration with\nVJoyPanelSection for complex nested layouts and modular content organization.",
+  "category": "Layout",
   "props": [
     {
       "name": "loading",

package/dist/doc/VJoyPanelSection/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyPanelSection",
   "displayName": "VJoyPanelSection",
+  "description": "",
+  "category": "Layout",
   "props": [],
   "events": [],
   "slots": [

package/dist/doc/VJoyPasswordRequirement/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyPasswordRequirement",
   "displayName": "VJoyPasswordRequirement",
+  "description": "A component to display a password requirement status.\nThis is meant to be displayed under a VJoyInput of type password.",
+  "category": "Forms",
   "props": [
     {
       "name": "label",

package/dist/doc/VJoyProductTour/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyProductTour",
   "displayName": "VJoyProductTour",
+  "description": "An advanced guided tour component for creating interactive product demonstrations with element highlighting.\nFeatures intelligent positioning around target elements, multi-step tour progression, customizable banners and actions,\nand spotlight effects for drawing user attention. Includes SSR compatibility and proper z-index management\nthrough Teleport for seamless user onboarding and feature discovery experiences.",
+  "category": "Overlays",
   "props": [
     {
       "name": "icon",

package/dist/doc/VJoyProductTourTrigger/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyProductTourTrigger",
   "displayName": "VJoyProductTourTrigger",
+  "description": "",
+  "category": "Overlays",
   "props": [
     {
       "name": "productTour",

package/dist/doc/VJoyProgressBar/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyProgressBar",
   "displayName": "VJoyProgressBar",
+  "description": "A visual progress indicator component for displaying completion status with percentage or step-based progress.\nFeatures multiple color variants for different semantic meanings (success, warning, error), optional label display,\nand dual mode support (percentage-based or step-based calculations). Perfect for indicating task completion,\nloading states, and multi-step process progress with clear visual feedback.",
+  "category": "View",
   "props": [
     {
       "name": "color",
@@ -87,11 +89,6 @@
       "name": "computeInnerWidth",
       "type": "string",
       "isMethod": false
-    },
-    {
-      "name": "computedPercentage",
-      "type": "number",
-      "isMethod": false
     }
   ],
   "hasVModel": false

package/dist/doc/VJoyRadio/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyRadio",
   "displayName": "VJoyRadio",
+  "description": "",
+  "category": "Forms",
   "props": [
     {
       "name": "invalid",

package/dist/doc/VJoyRadioGroup/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyRadioGroup",
   "displayName": "VJoyRadioGroup",
+  "description": "A container component for organizing radio button groups with proper fieldset structure and accessibility.\nFeatures horizontal and vertical layout options, legend support for group labeling, and seamless integration\nwith VJoyRadio components. Provides proper ARIA attributes and form association for accessible\nsingle-choice selection interfaces with consistent spacing and visual organization.\n\nUse the same v-model for each `VJoyRadio` (modelValue). Create a ref for it.",
+  "category": "Forms",
   "props": [
     {
       "name": "direction",
@@ -9,8 +11,8 @@
       "default": "\"horizontal\"",
       "description": "",
       "possibleValues": [
-        "horizontal",
-        "vertical"
+        "vertical",
+        "horizontal"
       ]
     },
     {

package/dist/doc/VJoyRatingStars/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyRatingStars",
   "displayName": "VJoyRatingStars",
+  "description": "A visual rating display component using star icons to represent rating values from 0 to 5.\nFeatures support for fractional ratings with half-star display, multiple size variants,\nreview count display, and customizable content slots. Includes proper accessibility\nattributes with configurable ARIA labels for screen reader compatibility.\n\n**Accessibility focus**: you can give an aria-label to the component to actually describe the rating.\nBy default it is set to \"Rating: X out of 5\" but is obviously not translated.",
+  "category": "View",
   "props": [
     {
       "name": "size",

package/dist/doc/VJoyScreenLoader/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyScreenLoader",
   "displayName": "VJoyScreenLoader",
+  "description": "A full-screen loading overlay component for indicating page or section loading states.\nFeatures light and dark color modes, overlay positioning for absolute coverage, customizable spinner slots,\nand content areas for loading messages. Perfect for blocking user interactions during data loading\nwith professional loading animations and flexible content presentation.",
+  "category": "Loader",
   "props": [
     {
       "name": "color",

package/dist/doc/VJoySelect/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoySelect",
   "displayName": "VJoySelect",
+  "description": "A styled select dropdown component with integrated labeling.\nFeatures multiple size variants, disabled and invalid states, and flexible option rendering.\nSupports both inline label props and external VJoyLabel component usage.",
+  "category": "Forms",
   "props": [
     {
       "name": "invalid",
@@ -47,6 +49,17 @@
         "true"
       ]
     },
+    {
+      "name": "requiredMark",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
     {
       "name": "modelValue",
       "type": "string | number | null | undefined",
@@ -59,17 +72,6 @@
         "number"
       ]
     },
-    {
-      "name": "requiredMark",
-      "type": "boolean | undefined",
-      "required": false,
-      "default": "false",
-      "description": "",
-      "possibleValues": [
-        "false",
-        "true"
-      ]
-    },
     {
       "name": "label",
       "type": "string | undefined",
@@ -97,15 +99,6 @@
         "string"
       ]
     },
-    {
-      "name": "ariaLabel",
-      "type": "string | undefined",
-      "required": false,
-      "description": "aria-label is available only if 'label' property is undefined *",
-      "possibleValues": [
-        "string"
-      ]
-    },
     {
       "name": "labelSize",
       "type": "TJoyLabelSizes | undefined",
@@ -125,6 +118,15 @@
       "possibleValues": [
         "string"
       ]
+    },
+    {
+      "name": "ariaLabel",
+      "type": "string | undefined",
+      "required": false,
+      "description": "aria-label is available only if 'label' property is undefined *",
+      "possibleValues": [
+        "string"
+      ]
     }
   ],
   "events": [
@@ -166,13 +168,13 @@
       "isMethod": false
     },
     {
-      "name": "modelValue",
-      "type": "string | number | null",
+      "name": "requiredMark",
+      "type": "boolean",
       "isMethod": false
     },
     {
-      "name": "requiredMark",
-      "type": "boolean",
+      "name": "modelValue",
+      "type": "string | number | null",
       "isMethod": false
     },
     {
@@ -191,22 +193,22 @@
       "isMethod": false
     },
     {
-      "name": "onUpdate:modelValue",
-      "type": "((value: string) => any) | undefined",
-      "isMethod": true
+      "name": "labelSize",
+      "type": "TJoyLabelSizes | undefined",
+      "isMethod": false
     },
     {
-      "name": "ariaLabel",
+      "name": "optionalLabel",
       "type": "string | undefined",
       "isMethod": false
     },
     {
-      "name": "labelSize",
-      "type": "TJoyLabelSizes | undefined",
-      "isMethod": false
+      "name": "onUpdate:modelValue",
+      "type": "((value: string) => any) | undefined",
+      "isMethod": true
     },
     {
-      "name": "optionalLabel",
+      "name": "ariaLabel",
       "type": "string | undefined",
       "isMethod": false
     },

package/dist/doc/VJoySelectableItem/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoySelectableItem",
   "displayName": "VJoySelectableItem",
+  "description": "",
+  "category": "Forms",
   "props": [
     {
       "name": "disabled",

package/dist/doc/VJoySelectableItemGroup/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoySelectableItemGroup",
   "displayName": "VJoySelectableItemGroup",
+  "description": "Basic full implementation example :\n\n```html\n\n <template>\n     <VJoySelectableItemGroup :options=\"options\" v-model:value=\"selectableModel\" />\n <template>\n\n<script setup lang=\"ts\">\n import {ref} from 'vue';\n import {TJoySelectableItemOption} from '@maltjoy/core-vue';\n\nconst options = ref<TJoySelectableItemOption[]>([\n  {value: 'first-selectable-value', label: 'Option 1'},\n  {value: 'second-selectable-value', label: 'Option 2'},\n  {value: 'third-selectable-value', label: 'Option 3', {attrs: {...}}},\n]); // Use any type you prefer here, depending on what the backend is sending to you\n\n\nconst selectableModel = ref(['second-selectable-value']);\n\n</script>\n```\n\n> When passing the `options` property, you can include both `value` and `label` properties to each option.\n> But if it's simpler to use other key names, you can use `valueKey` and `labelKey` properties from `VJoySelectableItemGroup` to define the keys you prefer.\n>\n> You will have to deal with the typings by yourself, by creating a mix of interfaces or using satifies with type `TJoySelectableItemOption` depending on your cases.\n>\n> Example: `satisfies (TJoySelectableItemOption & Record<string, unknown>)[]`",
+  "category": "Forms",
   "props": [
     {
       "name": "options",

package/dist/doc/VJoySeparator/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoySeparator",
   "displayName": "VJoySeparator",
+  "description": "A visual content separator component with text labeling capabilities for organizing interface sections.\nFeatures customizable text content, multiple size options, and styled horizontal lines for improved\nvisual hierarchy. Enhanced version of the HTML hr element with better styling control and\nintegrated text display for clearer content separation and section identification.",
+  "category": "View",
   "props": [
     {
       "name": "size",

package/dist/doc/VJoySnackbar/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoySnackbar",
   "displayName": "VJoySnackbar",
+  "description": "This component should not be directly used. To display it, please use the pushVJoySnackbar service :\n\n```typescript\nimport {pushVJoySnackbar} from '@maltjoy/core-vue';\n\nfunction yourFunction() {\n   pushVJoySnackbar({\n      props: {\n        // at least message is mandatory\n        message: 'Your message'\n      }\n   });\n}\n```\n\nIf you need to listen  to events fired by the component, you can actually grab the event bus :\n\n```typescript\nimport {pushVJoySnackbar} from '@maltjoy/core-vue';\n\nfunction yourFunction() {\n   const {snackbarEventBus} = pushVJoySnackbar({\n      props: {\n        // at least message is mandatory\n        message: 'Your message'\n      }\n   });\n\n   snackbarEventBus.on('snackbar:hide', () => {\n      // do what you want, and don't forget to unregister the listener on component destroy\n   });\n}\n```\n\nOn the other hand, if you need to access the component instance, you can grab it as well\n\n```typescript\nimport {pushVJoySnackbar} from '@maltjoy/core-vue';\n\nfunction yourFunction() {\n   const {snackbarApp} = pushVJoySnackbar({\n      props: {\n        // at least message is mandatory\n        message: 'Your message'\n      }\n   });\n\n}\n```",
+  "category": "Overlays",
   "props": [
     {
       "name": "frozen",

package/dist/doc/VJoySpinner/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoySpinner",
   "displayName": "VJoySpinner",
+  "description": "A simple animated loading spinner component for indicating processing or loading states.\nFeatures customizable color variants to match different contexts and design requirements.\nLightweight and performant with CSS-based animations, perfect for buttons, forms,\nand content areas that need visual loading feedback.",
+  "category": "Loader",
   "props": [
     {
       "name": "color",

package/dist/doc/VJoyStep/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyStep",
   "displayName": "VJoyStep",
+  "description": "",
+  "category": "View",
   "props": [
     {
       "name": "size",

package/dist/doc/VJoyStepper/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyStepper",
   "displayName": "VJoyStepper",
+  "description": "A progress stepper component for visualizing multi-step processes and user workflows.\nManages a collection of VJoyStep components with support for main steps and sub-steps for granular progress tracking.\nFeatures automatic step state management (completed, current, upcoming), visual progress indicators,\nand flexible step sizing. Perfect for onboarding flows, form wizards, and guided processes.\n\nSee **VJoyStep** stories for properties related to `VJoyStepper` children",
+  "category": "View",
   "props": [
     {
       "name": "subStep",

package/dist/doc/VJoyTab/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyTab",
   "displayName": "VJoyTab",
+  "description": "",
+  "category": "Navigation",
   "props": [
     {
       "name": "notification",

package/dist/doc/VJoyTabs/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyTabs",
   "displayName": "VJoyTabs",
+  "description": "A tabbed navigation component for organizing content into switchable panels with proper accessibility support.\nFeatures scrollable tab headers for overflow management, notification badges, custom header content slots,\nand both local navigation and external link support. Includes automatic tab selection management\nand event handling for seamless content organization and user experience.",
+  "category": "Navigation",
   "props": [
     {
       "name": "selectedTab",

package/dist/doc/VJoyTag/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyTag",
   "displayName": "VJoyTag",
+  "description": "A versatile tag component for labeling, categorizing, and interactive content organization.\nFeatures multiple variants and sizes, removable functionality, drag visual indicators,\nselectable states, link styling, and AI-specific variants. Supports click handlers,\nremoval events, and flexible content through slots for complex tag implementations.",
+  "category": "View",
   "props": [
     {
       "name": "label",
@@ -180,13 +182,13 @@
       "isMethod": false
     },
     {
-      "name": "value",
-      "type": "string | number",
+      "name": "disabled",
+      "type": "boolean",
       "isMethod": false
     },
     {
-      "name": "disabled",
-      "type": "boolean",
+      "name": "value",
+      "type": "string | number",
       "isMethod": false
     },
     {

package/dist/doc/VJoyTagsInput/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyTagsInput",
   "displayName": "VJoyTagsInput",
+  "description": "A specialized form input component for managing collections of tags with dynamic add/remove functionality.\nFeatures email validation, duplication detection, multi-line responsive layout, and comprehensive error handling.\nIntegrates seamlessly with VJoyTag components for consistent tag display and provides flexible labeling\noptions for complex form scenarios with collections management.\n\n> **To render the component with default model, pass it an array of values.**\n> **Storybook code snippet is broken at the moment.**",
+  "category": "Forms",
   "props": [
     {
       "name": "name",