@maltjoy/mcp-server 0.3.0 → 0.3.2

package/dist/doc/VJoyInputDigit/metadata.json

@@ -0,0 +1,155 @@
+{
+  "name": "JoyInputDigit",
+  "displayName": "VJoyInputDigit",
+  "description": "One-time code input with auto-navigation between slots. Supports numeric filtering with disabled/invalid states.",
+  "props": [
+    {
+      "name": "modelValue",
+      "type": "string | undefined",
+      "required": false,
+      "default": "\"\"",
+      "description": "Joined value of all input slots.",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "length",
+      "type": "number | undefined",
+      "required": false,
+      "default": "6",
+      "description": "Number of displayed input slots.",
+      "possibleValues": [
+        "number"
+      ]
+    },
+    {
+      "name": "invalid",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Applies invalid visual state on every slot.",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "disabled",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Disables all input slots.",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "name",
+      "type": "string | undefined",
+      "required": false,
+      "default": "\"joy-input-digit\"",
+      "description": "Name prefix used for each generated input.",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "inputAriaLabel",
+      "type": "string | undefined",
+      "required": false,
+      "default": "\"Digit\"",
+      "description": "Base aria-label used for each input, indexed automatically (e.g. \"Digit 1 of 6\").",
+      "possibleValues": [
+        "string"
+      ]
+    }
+  ],
+  "events": [
+    {
+      "name": "blur",
+      "description": "",
+      "signature": "(event: \"blur\", event: FocusEvent): void"
+    },
+    {
+      "name": "change",
+      "description": "",
+      "signature": "(event: \"change\", value: string, event: Event): void"
+    },
+    {
+      "name": "focus",
+      "description": "",
+      "signature": "(event: \"focus\", event: FocusEvent): void"
+    },
+    {
+      "name": "update:modelValue",
+      "description": "",
+      "signature": "(event: \"update:modelValue\", value: string): void"
+    }
+  ],
+  "slots": [],
+  "exposed": [
+    {
+      "name": "invalid",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "length",
+      "type": "number",
+      "isMethod": false
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "modelValue",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "inputAriaLabel",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "onBlur",
+      "type": "((event: FocusEvent) => any) | undefined",
+      "isMethod": true
+    },
+    {
+      "name": "onFocus",
+      "type": "((event: FocusEvent) => any) | undefined",
+      "isMethod": true
+    },
+    {
+      "name": "onUpdate:modelValue",
+      "type": "((value: string) => any) | undefined",
+      "isMethod": true
+    },
+    {
+      "name": "onChange",
+      "type": "((value: string, event: Event) => any) | undefined",
+      "isMethod": true
+    },
+    {
+      "name": "focusInput",
+      "type": "(index: number) => void",
+      "isMethod": true
+    },
+    {
+      "name": "tokens",
+      "type": "string[]",
+      "isMethod": false
+    }
+  ],
+  "hasVModel": true
+}

package/dist/doc/VJoyInputPassword/metadata.json

@@ -0,0 +1,260 @@
+{
+  "name": "JoyInputPassword",
+  "displayName": "VJoyInputPassword",
+  "description": "Password input built on top of VJoyInput with built-in visibility toggle.",
+  "props": [
+    {
+      "name": "invalid",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "label",
+      "type": "string | undefined",
+      "required": false,
+      "description": "Display a label on top of the element. Handy if you only need to pass a string. If you need more, use the VJoyLabel.",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "size",
+      "type": "TJoyInputSizes | undefined",
+      "required": false,
+      "description": "",
+      "possibleValues": [
+        "medium",
+        "large",
+        "small"
+      ]
+    },
+    {
+      "name": "required",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "icon",
+      "type": "string",
+      "required": false,
+      "description": "Add a JoyIcon / joy-icon with given name on left-side.",
+      "possibleValues": "TJoyIconsNames (220 values)"
+    },
+    {
+      "name": "id",
+      "type": "string | undefined",
+      "required": false,
+      "description": "",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "disabled",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "name",
+      "type": "string | undefined",
+      "required": false,
+      "default": "\"joy-input-password\"",
+      "description": "",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number | null | undefined",
+      "required": false,
+      "description": "",
+      "possibleValues": [
+        "null",
+        "string",
+        "number"
+      ]
+    },
+    {
+      "name": "autofocus",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "labelSize",
+      "type": "TJoyLabelSizes | undefined",
+      "required": false,
+      "default": "\"medium\"",
+      "description": "Overrides the default label size. See JoyLabel stories",
+      "possibleValues": [
+        "medium",
+        "large",
+        "small"
+      ]
+    },
+    {
+      "name": "optionalLabel",
+      "type": "string | undefined",
+      "required": false,
+      "description": "If your component is not required, we can add a label to explicitely tell that it's not mandatory",
+      "possibleValues": [
+        "string"
+      ]
+    },
+    {
+      "name": "requiredMark",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Depending on context, we can add a \"*\" after the label to specify it's mandatory.",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
+    {
+      "name": "modelModifiers",
+      "type": "Partial<Record<\"number\" | \"trim\" | \"lazy\", boolean>> | undefined",
+      "required": false,
+      "default": "{ lazy: false }",
+      "description": "",
+      "possibleValues": [
+        "Partial<Record<\"number\" | \"trim\" | \"lazy\", boolean>>"
+      ]
+    },
+    {
+      "name": "unit",
+      "type": "string | undefined",
+      "required": false,
+      "description": "Adds a legend like symbol on the right of the component. Made for number based values",
+      "possibleValues": [
+        "string"
+      ]
+    }
+  ],
+  "events": [
+    {
+      "name": "update:modelValue",
+      "description": "",
+      "signature": "(event: \"update:modelValue\", value: string): void"
+    }
+  ],
+  "slots": [
+    {
+      "name": "password-requirements",
+      "description": "Slot used to inject password requirements. Use VJoyPasswordRequirement component to display the requirements."
+    }
+  ],
+  "exposed": [
+    {
+      "name": "invalid",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "required",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "name",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "autofocus",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "labelSize",
+      "type": "TJoyLabelSizes",
+      "isMethod": false
+    },
+    {
+      "name": "requiredMark",
+      "type": "boolean",
+      "isMethod": false
+    },
+    {
+      "name": "modelModifiers",
+      "type": "Partial<Record<\"number\" | \"trim\" | \"lazy\", boolean>>",
+      "isMethod": false
+    },
+    {
+      "name": "label",
+      "type": "string | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "size",
+      "type": "TJoyInputSizes | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "icon",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "id",
+      "type": "string | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "modelValue",
+      "type": "string | number | null | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "onUpdate:modelValue",
+      "type": "((value: string) => any) | undefined",
+      "isMethod": true
+    },
+    {
+      "name": "optionalLabel",
+      "type": "string | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "unit",
+      "type": "string | undefined",
+      "isMethod": false
+    },
+    {
+      "name": "focus",
+      "type": "() => void",
+      "isMethod": true
+    }
+  ],
+  "hasVModel": true
+}

package/dist/doc/VJoyLabel/JoyLabel.types.ts

@@ -1,3 +1,4 @@
 import {TSizes} from '@/types';
 
 export type TJoyLabelSizes = Extract<TSizes, 'small' | 'medium' | 'large'>;
+export const JoyFormElementContext = 'JoyFormElementContext';

package/dist/doc/VJoyLabel/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyLabel",
   "displayName": "VJoyLabel",
+  "description": "A flexible form label component with enhanced functionality for complex form layouts. Features size variants, required/optional indicators, tooltip support, and legend text capabilities. Supports both label and legend tag rendering for different form contexts with integrated accessibility features and consistent styling across the design system. All native attributes are not declared as Vue component properties. But the actual label tag inherits from every attribute you pass.",
   "props": [
     {
       "name": "size",

package/dist/doc/VJoyLink/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyLink",
   "displayName": "VJoyLink",
+  "description": "Simple link component that should adapt its style depending on the context. Could be a button if **href** prop is undefined (add a **type** prop if needed).",
   "props": [
     {
       "name": "color",

package/dist/doc/VJoyListItem/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyListItem",
   "displayName": "VJoyListItem",
+  "description": "A structured list item component for creating consistent, interactive list entries. Features left and right content areas, optional icon support, hover states, and click handling. Perfect for data lists, navigation items, and content cards where consistent spacing and interactive feedback are essential for user experience.",
   "props": [
     {
       "name": "icon",

package/dist/doc/VJoyMenu/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyMenu",
   "displayName": "VJoyMenu",
+  "description": "A navigation menu component for creating accessible menu lists with keyboard navigation support. Works with VJoyMenuItem components to build complex navigation structures with icons, status indicators, and various link types. Features proper ARIA attributes, selection states, and integration with routing systems for seamless navigation experiences. items property is deprecated. Please use VJoyMenuItem with default slot. Docs generation is broken for the VJoyMenuItem component. Here you have the props interface as workaround. ```ts interface IJoyMenuItem { label: string; icon?: TJoyIconsNames; current?: boolean; disabled?: boolean; status?: TJoyIconsNames; statusColor?: TJoyIconsColors; type?: Component | 'a' | 'button'; linkProps?: ComponentProps<T>; } ```",
   "props": [
     {
       "name": "items",

package/dist/doc/VJoyMenuItem/JoyMenuItem.types.ts

@@ -0,0 +1,14 @@
+import {JoyIconsId} from '@maltjoy/icons';
+
+export interface IJoyMenuItemBis {
+    id?: string;
+    label: string;
+    href?: string;
+    icon?: JoyIconsId;
+    current?: boolean;
+    /**
+     * @default false
+     */
+    disabled?: boolean;
+    [k: string]: any;
+}

package/dist/doc/VJoyMenuItem/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyMenuItem",
   "displayName": "VJoyMenuItem",
+  "description": "",
   "props": [
     {
       "name": "label",

package/dist/doc/VJoyMultiCheckbox/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyMultiCheckbox",
   "displayName": "VJoyMultiCheckbox",
+  "description": "A multi-selection checkbox group component for handling arrays of selected values. Simplifies multi-selection scenarios by managing checkbox states and array manipulation automatically. Features integrated labeling, fieldset structure for accessibility, and customizable checkbox content through slots. Perfect for filtering interfaces and bulk selection operations.",
   "props": [
     {
       "name": "options",

package/dist/doc/VJoyPagination/metadata.json

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

package/dist/doc/VJoyPanel/metadata.json

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

package/dist/doc/VJoyPanelSection/metadata.json

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

package/dist/doc/VJoyPasswordRequirement/JoyPasswordRequirement.types.ts

@@ -0,0 +1,8 @@
+import type {TLevels} from '../../types';
+
+/**
+ * - neutral : The password field is focused but not this rule is not valid
+ * - valid : This rule is valid
+ * - invalid : This field is not focused and this rule is invalid
+ */
+export type TVJoyPasswordRequirementStatus = Extract<TLevels, 'success' | 'error' | 'neutral'>;

package/dist/doc/VJoyPasswordRequirement/metadata.json

@@ -0,0 +1,40 @@
+{
+  "name": "JoyPasswordRequirement",
+  "displayName": "VJoyPasswordRequirement",
+  "description": "A component to display a password requirement status. This is meant to be displayed under a VJoyInput of type password.",
+  "props": [
+    {
+      "name": "label",
+      "type": "string",
+      "required": true,
+      "description": "Label of the password strength rule",
+      "possibleValues": null
+    },
+    {
+      "name": "status",
+      "type": "TVJoyPasswordRequirementStatus | undefined",
+      "required": false,
+      "description": "Status of the password requirement",
+      "possibleValues": [
+        "error",
+        "neutral",
+        "success"
+      ]
+    }
+  ],
+  "events": [],
+  "slots": [],
+  "exposed": [
+    {
+      "name": "label",
+      "type": "string",
+      "isMethod": false
+    },
+    {
+      "name": "status",
+      "type": "TVJoyPasswordRequirementStatus | undefined",
+      "isMethod": false
+    }
+  ],
+  "hasVModel": false
+}

package/dist/doc/VJoyProductTour/metadata.json

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

package/dist/doc/VJoyProductTourTrigger/metadata.json

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

package/dist/doc/VJoyProgressBar/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyProgressBar",
   "displayName": "VJoyProgressBar",
+  "description": "A visual progress indicator component for displaying completion status with percentage or step-based progress. Features multiple color variants for different semantic meanings (success, warning, error), optional label display, and dual mode support (percentage-based or step-based calculations). Perfect for indicating task completion, loading states, and multi-step process progress with clear visual feedback.",
   "props": [
     {
       "name": "color",

package/dist/doc/VJoyRadio/metadata.json

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

package/dist/doc/VJoyRadioGroup/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoyRadioGroup",
   "displayName": "VJoyRadioGroup",
+  "description": "A container component for organizing radio button groups with proper fieldset structure and accessibility. Features horizontal and vertical layout options, legend support for group labeling, and seamless integration with VJoyRadio components. Provides proper ARIA attributes and form association for accessible single-choice selection interfaces with consistent spacing and visual organization. Use the same v-model for each `VJoyRadio` (modelValue). Create a ref for it.",
   "props": [
     {
       "name": "direction",

package/dist/doc/VJoyRatingStars/metadata.json

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

package/dist/doc/VJoyScreenLoader/metadata.json

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

package/dist/doc/VJoySelect/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoySelect",
   "displayName": "VJoySelect",
+  "description": "A styled select dropdown component with integrated labeling. Features multiple size variants, disabled and invalid states, and flexible option rendering. Supports both inline label props and external VJoyLabel component usage.",
   "props": [
     {
       "name": "invalid",

package/dist/doc/VJoySelectableItem/metadata.json

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

package/dist/doc/VJoySelectableItemGroup/metadata.json

@@ -1,6 +1,7 @@
 {
   "name": "JoySelectableItemGroup",
   "displayName": "VJoySelectableItemGroup",
+  "description": "Basic full implementation example : ```html <template> <VJoySelectableItemGroup :options=\"options\" v-model:value=\"selectableModel\" /> <template> <script setup lang=\"ts\"> import {ref} from 'vue'; import {TJoySelectableItemOption} from '@maltjoy/core-vue'; const options = ref<TJoySelectableItemOption[]>([ {value: 'first-selectable-value', label: 'Option 1'}, {value: 'second-selectable-value', label: 'Option 2'}, {value: 'third-selectable-value', label: 'Option 3', {attrs: {...}}}, ]); // Use any type you prefer here, depending on what the backend is sending to you const selectableModel = ref(['second-selectable-value']); </script> ``` > When passing the `options` property, you can include both `value` and `label` properties to each option. > 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. > > 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. > > Example: `satisfies (TJoySelectableItemOption & Record<string, unknown>)[]`",
   "props": [
     {
       "name": "options",

package/dist/doc/VJoySeparator/metadata.json

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