@maltjoy/mcp-server 0.3.1 → 0.4.0

package/dist/doc/VJoyDropdown/metadata.json

@@ -1,13 +1,15 @@
 {
   "name": "JoyDropdown",
   "displayName": "VJoyDropdown",
+  "description": "A flexible dropdown component for creating contextual menus and option lists.\nFeatures customizable trigger buttons, positioning options (left/right/up/down), and support for\nboth predefined option lists and completely custom content. Includes proper accessibility support\nand click-outside behavior for seamless user interaction.\n\n**ACCESSIBILITY FOCUS:**\n\nWhen using this component, to properly apply useful informations for screen readers, you will need to set an **aria-label** to your dropdown trigger if it has no default text.",
+  "category": "Forms",
   "props": [
     {
       "name": "reset",
       "type": "boolean | undefined",
       "required": false,
       "default": "false",
-      "description": "Display a reset CTA on top of the dropdown list. Useful when using a VJoyMultiCheckbox.\nPlease note that is does not automatically apply changes to you models, it simply fires a **dropdown:reset** custom event",
+      "description": "Display a reset CTA on top of the dropdown list. Useful when using a VJoyCheckboxGroup.\nPlease note that is does not automatically apply changes to you models, it simply fires a **dropdown:reset** custom event",
       "possibleValues": [
         "false",
         "true"
@@ -45,68 +47,6 @@
         "string"
       ]
     },
-    {
-      "name": "modelValue",
-      "type": "string | undefined",
-      "required": false,
-      "default": "\"\"",
-      "description": "Use v-model",
-      "possibleValues": [
-        "string"
-      ]
-    },
-    {
-      "name": "disableTeleport",
-      "type": "boolean | undefined",
-      "required": false,
-      "default": "false",
-      "description": "Disable teleport for testing purpose mostly.",
-      "possibleValues": [
-        "false",
-        "true"
-      ]
-    },
-    {
-      "name": "appendTo",
-      "type": "string | RendererElement | null | undefined",
-      "required": false,
-      "default": "\"body\"",
-      "description": "DOM valid selector to give to Vue3 Teleport \"to\" property",
-      "possibleValues": null
-    },
-    {
-      "name": "closeOnSelect",
-      "type": "boolean | undefined",
-      "required": false,
-      "default": "true",
-      "description": "close the dropdown list when clicking on any item. Default to false",
-      "possibleValues": [
-        "false",
-        "true"
-      ]
-    },
-    {
-      "name": "direction",
-      "type": "TJoyDropdownDirections | undefined",
-      "required": false,
-      "default": "\"down\"",
-      "description": "Dropdown vertical position according to the trigger",
-      "possibleValues": [
-        "up",
-        "down"
-      ]
-    },
-    {
-      "name": "justify",
-      "type": "TPositions | undefined",
-      "required": false,
-      "default": "\"left\"",
-      "description": "Dropdown horizontal justify according to the trigger",
-      "possibleValues": [
-        "left",
-        "right"
-      ]
-    },
     {
       "name": "options",
       "type": "TJoyDropdownOption[] | undefined",
@@ -260,6 +200,68 @@
         }
       ]
     },
+    {
+      "name": "direction",
+      "type": "TJoyDropdownDirections | undefined",
+      "required": false,
+      "default": "\"down\"",
+      "description": "Dropdown vertical position according to the trigger",
+      "possibleValues": [
+        "up",
+        "down"
+      ]
+    },
+    {
+      "name": "modelValue",
+      "type": "string | undefined",
+      "required": false,
+      "default": "\"\"",
+      "description": "Use v-model",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "disableTeleport",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Disable teleport for testing purpose mostly.",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "appendTo",
+      "type": "string | RendererElement | null | undefined",
+      "required": false,
+      "default": "\"body\"",
+      "description": "DOM valid selector to give to Vue3 Teleport \"to\" property",
+      "possibleValues": null
+    },
+    {
+      "name": "closeOnSelect",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "true",
+      "description": "close the dropdown list when clicking on any item. Default to false",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "justify",
+      "type": "TPositions | undefined",
+      "required": false,
+      "default": "\"left\"",
+      "description": "Dropdown horizontal justify according to the trigger",
+      "possibleValues": [
+        "left",
+        "right"
+      ]
+    },
     {
       "name": "dropdownGap",
       "type": "string | undefined",
@@ -313,7 +315,7 @@
     },
     {
       "name": "dropdown-items",
-      "description": "Free slot in order to render any kind of component. Can be handy to use it with VJoyMultiCheckbox for instance."
+      "description": "Free slot in order to render any kind of component. Can be handy to use it with VJoyCheckboxGroup for instance."
     },
     {
       "name": "dropdown-item",
@@ -345,6 +347,16 @@
       "type": "string",
       "isMethod": false
     },
+    {
+      "name": "options",
+      "type": "TJoyDropdownOption[]",
+      "isMethod": false
+    },
+    {
+      "name": "direction",
+      "type": "TJoyDropdownDirections",
+      "isMethod": false
+    },
     {
       "name": "modelValue",
       "type": "string",
@@ -365,21 +377,11 @@
       "type": "boolean",
       "isMethod": false
     },
-    {
-      "name": "direction",
-      "type": "TJoyDropdownDirections",
-      "isMethod": false
-    },
     {
       "name": "justify",
       "type": "TPositions",
       "isMethod": false
     },
-    {
-      "name": "options",
-      "type": "TJoyDropdownOption[]",
-      "isMethod": false
-    },
     {
       "name": "dropdownGap",
       "type": "string",

package/dist/doc/VJoyDropdownList/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyDropdownList",
   "displayName": "VJoyDropdownList",
+  "description": "The core list component used within dropdown interfaces for displaying selectable options.\nFeatures customizable sizing, header/footer slots, keyboard navigation, and accessibility compliance.\nSupports both predefined option arrays and custom content through slots. Can be used standalone\nor as part of the VJoyDropdown component for complete dropdown functionality.",
+  "category": "Forms",
   "props": [
     {
       "name": "reset",

package/dist/doc/VJoyDropzone/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyDropzone",
   "displayName": "VJoyDropzone",
+  "description": "A file upload component with drag-and-drop functionality for handling file selection and management.\nSupports single or multiple file uploads, file validation and customizable file displays.\nFeatures visual feedback for drag states, error handling, and flexible content slots for file information and actions.\n\nThe dropzone required as `v-model` an array containing objects with at least the \"name\" property.",
+  "category": "Forms",
   "props": [
     {
       "name": "modelValue",

package/dist/doc/VJoyFilterBar/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyFilterBar",
   "displayName": "VJoyFilterBar",
+  "description": "A container component for creating grouped filter interfaces with connected filter buttons.\nAutomatically applies appropriate border radius styling to create seamless filter groups\nthat work perfectly with VJoyFilterBarButton components. Includes accessibility support\nand integrates well with dropdowns for complex filtering scenarios.",
+  "category": "Forms",
   "props": [
     {
       "name": "ariaLabel",

package/dist/doc/VJoyFilterBarButton/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyFilterBarButton",
   "displayName": "VJoyFilterBarButton",
+  "description": "",
+  "category": "Forms",
   "props": [
     {
       "name": "active",

package/dist/doc/VJoyFloatingActionsBar/metadata.json

@@ -0,0 +1,70 @@
+{
+  "name": "JoyFloatingActionsBar",
+  "displayName": "VJoyFloatingActionsBar",
+  "description": "A persistent action container displayed at the bottom of the viewport.\nUseful to surface bulk actions when items are selected, or to keep\nprimary actions visible while users scroll through long pages.",
+  "category": "Overlays",
+  "props": [
+    {
+      "name": "height",
+      "type": "string | undefined",
+      "required": false,
+      "default": "\"92px\"",
+      "description": "Height of the bar. Adjust when the default does not fit your content.",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "appendTo",
+      "type": "string | RendererElement | null | undefined",
+      "required": false,
+      "default": "\"body\"",
+      "description": "CSS selector or DOM element used as the Teleport target.",
+      "possibleValues": null
+    },
+    {
+      "name": "justify",
+      "type": "\"center\" | \"space-between\" | \"space-around\" | \"space-evenly\" | \"flex-start\" | \"flex-end\" | undefined",
+      "required": false,
+      "default": "\"space-between\"",
+      "description": "Controls the horizontal distribution of the inner content.",
+      "possibleValues": [
+        "center",
+        "space-between",
+        "space-around",
+        "space-evenly",
+        "flex-start",
+        "flex-end"
+      ]
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "content",
+      "description": "Content slot, placed on the left side of the bar"
+    },
+    {
+      "name": "actions",
+      "description": "Actions slot, placed on the right side"
+    }
+  ],
+  "exposed": [
+    {
+      "name": "height",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "appendTo",
+      "type": "string | RendererElement | null",
+      "isMethod": false
+    },
+    {
+      "name": "justify",
+      "type": "\"center\" | \"space-between\" | \"space-around\" | \"space-evenly\" | \"flex-start\" | \"flex-end\"",
+      "isMethod": false
+    }
+  ],
+  "hasVModel": false
+}

package/dist/doc/VJoyFormError/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyFormError",
   "displayName": "VJoyFormError",
+  "description": "A form error display component for showing error messages.\nFeatures a warning icon, support for single error messages or multiple error lists, and visibility control for conditional error display.\nIncludes proper accessibility attributes with alert role for screen reader announcement of form errors.",
+  "category": "Forms",
   "props": [
     {
       "name": "visible",

package/dist/doc/VJoyFormFieldSkeleton/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyFormFieldSkeleton",
   "displayName": "VJoyFormFieldSkeleton",
+  "description": "A specialized skeleton loading component designed specifically for form field placeholders.\nFeatures form-appropriate sizing, flexible layout support with VJoyWrapper integration,\nand consistent styling that matches form field dimensions. Perfect for creating skeleton\nforms and improving perceived loading performance in form-heavy interfaces.\n\nSkeleton is 100% width by default. If you want to have a better control on this, use the \"width\" property.",
+  "category": "Skeletons",
   "props": [
     {
       "name": "size",

package/dist/doc/VJoyFormGroup/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyFormGroup",
   "displayName": "VJoyFormGroup",
+  "description": "A form group component to group form elements together.\n\nIt is used to group a label, any form component, and form errors together.\n\nIt is also used to handle the gap between the form elements, and **it resets the existing margins** within form elements!",
+  "category": "Functional",
   "props": [],
   "events": [],
   "slots": [

package/dist/doc/VJoyFunnel/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyFunnel",
   "displayName": "VJoyFunnel",
+  "description": "A full-page layout component designed for multi-step workflows and guided user flows.\nFeatures decorative background shapes, header and footer areas, and seamless integration\nwith stepper components. Optimized for mobile experiences and onboarding funnels\nwith different visual profiles and customizable content areas.",
+  "category": "Layout",
   "props": [
     {
       "name": "profile",

package/dist/doc/VJoyFunnelFooter/metadata.json

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

package/dist/doc/VJoyFunnelHeader/metadata.json

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

package/dist/doc/VJoyHighlight/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyHighlight",
   "displayName": "VJoyHighlight",
+  "description": "A content highlighting component for displaying important information with visual emphasis.\nFeatures different severity levels (success, info, warning, error, neutral), optional accent borders, customizable icons, and title support.\nIncludes an experimental AI variant for AI-related content with special styling and decorative elements.",
+  "category": "View",
   "props": [
     {
       "name": "variant",

package/dist/doc/VJoyIcon/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyIcon",
   "displayName": "VJoyIcon",
+  "description": "An icon component supporting the complete Joy icon library with customizable sizing and theming.\nFeatures accessibility support with aria labels, multiple color variants and different size options.\nProvides consistent icon rendering across the design system with proper semantic markup and keyboard navigation capabilities.",
+  "category": "Icons",
   "props": [
     {
       "name": "size",

package/dist/doc/VJoyIconButton/JoyIconButton.types.ts

@@ -0,0 +1,6 @@
+import {TJoyButtonSizes, TJoyButtonVariants} from '../JoyButton/JoyButton.types';
+import {TJoyIconsNames} from '../JoyIcon/JoyIcon.types';
+
+export type TJoyIconButtonVariants = TJoyButtonVariants;
+export type TJoyIconButtonSizes = TJoyButtonSizes;
+export type TJoyIconButtonIconNames = TJoyIconsNames;

package/dist/doc/VJoyIconButton/metadata.json

@@ -0,0 +1,116 @@
+{
+  "name": "JoyIconButton",
+  "displayName": "VJoyIconButton",
+  "description": "A dedicated icon-button component built on top of `VJoyButton`.\nUse this component instead of the deprecated `circle` prop from `VJoyButton`.",
+  "category": "Buttons",
+  "props": [
+    {
+      "name": "size",
+      "type": "TJoyButtonSizes | undefined",
+      "required": false,
+      "default": "\"medium\"",
+      "description": "Button or Link size",
+      "possibleValues": [
+        "medium",
+        "large",
+        "small",
+        "xsmall",
+        "xxsmall"
+      ]
+    },
+    {
+      "name": "loading",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Change the component's state and display a JoySpinner.",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "variant",
+      "type": "TJoyButtonVariants | undefined",
+      "required": false,
+      "default": "\"primary\"",
+      "description": "Button or Link color variant",
+      "possibleValues": [
+        "secondary",
+        "primary",
+        "main",
+        "admin",
+        "ghost",
+        "secondary-ai",
+        "primary-ai",
+        "main-ai",
+        "ghost-ai"
+      ]
+    },
+    {
+      "name": "label",
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible label used when no default slot is provided.\nThe text is hidden visually by JoyIconButton styles.",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "icon",
+      "type": "string",
+      "required": true,
+      "description": "Name of the icon displayed inside the button",
+      "possibleValues": "TJoyIconsNames (220 values)"
+    },
+    {
+      "name": "id",
+      "type": "string | undefined",
+      "required": false,
+      "description": "",
+      "possibleValues": [
+        "string"
+      ]
+    }
+  ],
+  "events": [],
+  "slots": [
+    {
+      "name": "default",
+      "description": "Accessible label for the icon button"
+    }
+  ],
+  "exposed": [
+    {
+      "name": "size",
+      "type": "TJoyButtonSizes",
+      "isMethod": false
+    },
+    {
+      "name": "loading",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "variant",
+      "type": "TJoyButtonVariants",
+      "isMethod": false
+    },
+    {
+      "name": "label",
+      "type": "string | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "icon",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "id",
+      "type": "string | undefined",
+      "isMethod": false
+    }
+  ],
+  "hasVModel": false
+}

package/dist/doc/VJoyIndicator/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyIndicator",
   "displayName": "VJoyIndicator",
+  "description": "",
+  "category": "Buttons",
   "props": [
     {
       "name": "variant",

package/dist/doc/VJoyIndicators/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyIndicators",
   "displayName": "VJoyIndicators",
+  "description": "A navigation component for creating page or content indicators, commonly used in carousels and dialogs.\nManages a collection of VJoyIndicator components with selection state and v-model support.\nFeatures visual variants and automatic indicator management for seamless navigation experiences with proper accessibility and keyboard interaction support.",
+  "category": "Buttons",
   "props": [
     {
       "name": "variant",

package/dist/doc/VJoyInput/JoyInput.types.ts

@@ -10,7 +10,7 @@ export interface VJoyInputProps {
     disabled?: boolean;
     id?: string;
     invalid?: boolean;
-    name: string;
+    name?: string;
     required?: boolean;
     /** Display a label on top of the element. Handy if you only need to pass a string. If you need more, use the VJoyLabel. */
     label?: string;

package/dist/doc/VJoyInput/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyInput",
   "displayName": "VJoyInput",
+  "description": "A comprehensive form input component with extensive customization and validation features.\nSupports multiple input types, icon support, clearable functionality, unit displays, and comprehensive validation states.\nFeatures auto-focus capabilities, accessibility compliance, and seamless integration with form validation systems.",
+  "category": "Forms",
   "props": [
     {
       "name": "autofocus",
@@ -57,10 +59,12 @@
     },
     {
       "name": "name",
-      "type": "string",
-      "required": true,
+      "type": "string | undefined",
+      "required": false,
       "description": "",
-      "possibleValues": null
+      "possibleValues": [
+        "string"
+      ]
     },
     {
       "name": "required",
@@ -236,11 +240,6 @@
       "type": "boolean",
       "isMethod": false
     },
-    {
-      "name": "autofocus",
-      "type": "boolean",
-      "isMethod": false
-    },
     {
       "name": "labelSize",
       "type": "TJoyLabelSizes",
@@ -251,6 +250,11 @@
       "type": "boolean",
       "isMethod": false
     },
+    {
+      "name": "autofocus",
+      "type": "boolean",
+      "isMethod": false
+    },
     {
       "name": "modelModifiers",
       "type": "Partial<Record<\"number\" | \"trim\" | \"lazy\", boolean>>",
@@ -288,7 +292,12 @@
     },
     {
       "name": "name",
-      "type": "string",
+      "type": "string | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "optionalLabel",
+      "type": "string | undefined",
       "isMethod": false
     },
     {
@@ -301,11 +310,6 @@
       "type": "((value: string) => any) | undefined",
       "isMethod": true
     },
-    {
-      "name": "optionalLabel",
-      "type": "string | undefined",
-      "isMethod": false
-    },
     {
       "name": "unit",
       "type": "string | undefined",

package/dist/doc/VJoyInputDigit/metadata.json

@@ -1,6 +1,8 @@
 {
   "name": "JoyInputDigit",
   "displayName": "VJoyInputDigit",
+  "description": "One-time code input with auto-navigation between slots.\nSupports numeric filtering with disabled/invalid states.",
+  "category": "Forms",
   "props": [
     {
       "name": "modelValue",