@maltjoy/mcp-server 0.2.0 → 0.3.0

package/README.md

@@ -6,6 +6,7 @@ MCP (Model Context Protocol) server for the Joy Design System. This server expos
 
 - 🔍 List all 74 available Joy Vue3 components
 - 📚 Access component documentation (props, events, slots, exposed members)
+- 🏷️ Retrieve TypeScript types definitions for component props (variants, sizes, etc.)
 - 🎨 List 132 design tokens (colors, spacing, typography, etc.)
 - 💅 List 272 CSS utility classes
 - 🤖 AI-friendly interface through MCP protocol
@@ -109,7 +110,35 @@ Retrieves detailed information about a specific Joy Vue3 component including pro
 }
 ```
 
-### 3. `joy_list_design_tokens`
+### 3. `joy_get_component_types`
+
+Retrieves the TypeScript types definition files associated with a specific Joy Vue3 component. These types define the allowed values for props (variants, sizes, etc.).
+
+**Parameters:**
+- `componentName` (string, required): The exact name of the component (e.g., "VJoyButton", "VJoyMenu")
+
+**Returns:**
+```json
+{
+  "componentName": "VJoyButton",
+  "files": [
+    {
+      "filename": "JoyButton.types.ts",
+      "content": "import {TGenericVariants, TPositions, TSizes} from '../../types';\n\nexport type TJoyDefaultButtonVariants = TGenericVariants | 'main' | 'admin' | 'ghost';\nexport type TJoyButtonVariants = TJoyDefaultButtonVariants | ...;\nexport type TJoyButtonSizes = Exclude<TSizes, 'xlarge'>;\nexport type TJoyButtonIconPositions = TPositions;\n"
+    }
+  ]
+}
+```
+
+**Error Response:**
+```json
+{
+  "error": "No types file found for component \"VJoyNonExistent\". Use joy_list_components to get a list of available components."
+}
+```
+
+### 4. `joy_list_design_tokens`
+
 
 Lists all available Joy design tokens (CSS custom properties) organized by domain.
 
@@ -129,7 +158,7 @@ Lists all available Joy design tokens (CSS custom properties) organized by domai
 }
 ```
 
-### 4. `joy_list_css_classes`
+### 5. `joy_list_css_classes`
 
 Lists all available Joy CSS utility classes organized by domain.
 
@@ -192,6 +221,7 @@ joy-mcp-server/
 │   └── tools/
 │       ├── list-components.ts      # Component listing tool
 │       ├── get-component-info.ts   # Component info retrieval tool
+│       ├── get-component-types.ts  # Component types retrieval tool
 │       ├── list-design-tokens.ts   # Design tokens tool
 │       └── list-css-classes.ts     # CSS classes tool
 ├── dist/
@@ -200,7 +230,8 @@ joy-mcp-server/
 │       ├── design-tokens.json      # All design tokens
 │       ├── css-classes.json        # All CSS classes
 │       └── VJoy*/                  # Component directories
-│           └── metadata.json       # Component metadata
+│           ├── metadata.json       # Component metadata
+│           └── *.types.ts          # Component TypeScript types
 ├── package.json
 ├── tsconfig.json
 ├── README.md

package/dist/doc/VJoyAvailability/JoyAvailability.types.ts

@@ -0,0 +1 @@
+export type TJoyAvailabilityStatus = 'AVAILABLE' | 'AVAILABLE_AND_VERIFIED' | 'NOT_AVAILABLE_WITH_DATE' | 'AVAILABLE_SOON' | 'NOT_AVAILABLE';

package/dist/doc/VJoyAvatar/JoyAvatar.types.ts

@@ -0,0 +1,6 @@
+import {TSizes} from '../../types';
+import VJoyAvatar from './VJoyAvatar.vue';
+
+/** AVATAR SIZES */
+export type TJoyAvatarSizes = Exclude<TSizes, 'xxsmall'>;
+export type TJoyAvatarProps = InstanceType<typeof VJoyAvatar>['$props'];

package/dist/doc/VJoyAvatar/metadata.json

@@ -103,7 +103,7 @@
         "key",
         "user-photo",
         "link",
-        "... (207 more)"
+        "... (210 more)"
       ]
     },
     {

package/dist/doc/VJoyBadge/JoyBadge.types.ts

@@ -0,0 +1,3 @@
+import {TJoyDotVariants} from '../JoyDot/VJoyDot.types';
+
+export type TJoyBadgeVariants = TJoyDotVariants;

package/dist/doc/VJoyBadge/metadata.json

@@ -40,15 +40,6 @@
         "dark-blue",
         "yellow"
       ]
-    },
-    {
-      "name": "number",
-      "type": "number | undefined",
-      "required": false,
-      "description": "",
-      "possibleValues": [
-        "number"
-      ]
     }
   ],
   "events": [],
@@ -73,11 +64,6 @@
       "name": "variant",
       "type": "TJoyDotVariants",
       "isMethod": false
-    },
-    {
-      "name": "number",
-      "type": "number | undefined",
-      "isMethod": false
     }
   ],
   "hasVModel": false

package/dist/doc/VJoyBadgeLevel/JoyBadgeLevel.types.ts

@@ -0,0 +1,15 @@
+export enum JoyBadgeLevelEnum {
+    // Should be replaced by JoyBadgeLevelEnum.HIGH_POTENTIAL_AUTO OR JoyBadgeProgramEnum.HIGH_POTENTIAL
+    HIGH_POTENTIAL = 'highpotential',
+    HIGH_POTENTIAL_AUTO = 'high-potential-auto',
+    MALT_LINKER = 'maltlinker',
+    NEW = 'new',
+    SUPER_MALTER = 'supermalter',
+    VERIFIED = 'verified',
+}
+
+export enum JoyBadgeProgramEnum {
+    HIGH_POTENTIAL = 'program_high-potential',
+}
+
+export type TJoyBadges = `${JoyBadgeLevelEnum | JoyBadgeProgramEnum}`;

package/dist/doc/VJoyButton/JoyButton.types.ts

@@ -0,0 +1,10 @@
+import {TGenericVariants, TPositions, TSizes} from '../../types';
+
+export type TJoyDefaultButtonVariants = TGenericVariants | 'main' | 'admin' | 'ghost';
+export type TJoyAIButtonVariants = `${TJoyDefaultButtonVariants}-ai`;
+
+export type TJoyButtonVariants = TJoyDefaultButtonVariants | Exclude<TJoyAIButtonVariants, 'admin-ai'>;
+
+export type TJoyButtonSizes = Exclude<TSizes, 'xlarge'>;
+
+export type TJoyButtonIconPositions = TPositions;

package/dist/doc/VJoyButton/metadata.json

@@ -92,7 +92,7 @@
       "type": "string",
       "required": false,
       "description": "Name of the icon, placed before the text",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "id",

package/dist/doc/VJoyCollapseItem/JoyCollapseItem.types.ts

@@ -0,0 +1,8 @@
+import VJoyCollapseItem from './VJoyCollapseItem.vue';
+
+export type TJoyCollapseItemProps = InstanceType<typeof VJoyCollapseItem>['$props'];
+
+export type TJoyCollapseItems = TJoyCollapseItemProps[];
+
+export const COLLAPSE_ITEM_MODES = ['outline', 'default'] as const;
+export type TJoyCollapseItemModes = (typeof COLLAPSE_ITEM_MODES)[number];

package/dist/doc/VJoyCollapseItem/metadata.json

@@ -65,7 +65,7 @@
         "key",
         "user-photo",
         "link",
-        "... (207 more)"
+        "... (210 more)"
       ]
     }
   ],

package/dist/doc/VJoyCompanyAvatar/JoyCompanyAvatar.types.ts

@@ -0,0 +1,3 @@
+import {TSizes} from '../../types';
+
+export type TJoyCompanyAvatarSizes = Extract<TSizes, 'large' | 'medium' | 'small'>;

package/dist/doc/VJoyDialog/JoyDialog.types.ts

@@ -0,0 +1,3 @@
+import {TSizes} from '../../types';
+
+export type TJoyDialogSizes = Extract<TSizes, 'large'> | 'default';

package/dist/doc/VJoyDot/VJoyDot.types.ts

@@ -0,0 +1 @@
+export type TJoyDotVariants = 'info' | 'gray' | 'green' | 'orange' | 'red' | 'teal' | 'pink' | 'dark-blue' | 'yellow';

package/dist/doc/VJoyDot/metadata.json

@@ -2,12 +2,20 @@
   "name": "JoyDot",
   "displayName": "VJoyDot",
   "props": [
+    {
+      "name": "number",
+      "type": "any",
+      "required": false,
+      "default": "undefined",
+      "description": "number: set a number or a string to display inside the dot, for badge-style dots with numbers.",
+      "possibleValues": null
+    },
     {
       "name": "variant",
       "type": "TJoyDotVariants | undefined",
       "required": false,
       "default": "\"info\"",
-      "description": "",
+      "description": "variant: the color variant for the dot. You can use the TJoyDotVariants type.",
       "possibleValues": [
         "info",
         "gray",
@@ -19,28 +27,19 @@
         "dark-blue",
         "yellow"
       ]
-    },
-    {
-      "name": "number",
-      "type": "number | undefined",
-      "required": false,
-      "description": "",
-      "possibleValues": [
-        "number"
-      ]
     }
   ],
   "events": [],
   "slots": [],
   "exposed": [
     {
-      "name": "variant",
-      "type": "TJoyDotVariants",
+      "name": "number",
+      "type": "any",
       "isMethod": false
     },
     {
-      "name": "number",
-      "type": "number | undefined",
+      "name": "variant",
+      "type": "TJoyDotVariants",
       "isMethod": false
     }
   ],

package/dist/doc/VJoyDrawer/JoyDrawer.types.ts

@@ -0,0 +1 @@
+export type TJoyDrawerSizes = 'default' | 'large';

package/dist/doc/VJoyDropdown/JoyDropdown.types.ts

@@ -0,0 +1,21 @@
+import {TPositions} from '../../types';
+
+export type TJoyDropdownDirections = 'up' | 'down';
+
+export type TJoyDropdownJustify = TPositions;
+
+export interface TJoyDropdownOption {
+    id: string;
+    value?: string;
+    label: string;
+    href?: string;
+    /**
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * @default false
+     */
+    checked?: boolean;
+    [k: string]: any;
+}

package/dist/doc/VJoyDropdownList/JoyDropdownList.types.ts

@@ -0,0 +1,3 @@
+import {TSizes} from '../../types';
+
+export type TJoyDropdownListSizes = Extract<TSizes, 'xsmall' | 'small' | 'medium'>;

package/dist/doc/VJoyDropzone/metadata.json

@@ -102,6 +102,17 @@
       "possibleValues": [
         "string"
       ]
+    },
+    {
+      "name": "canDelete",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "true",
+      "description": "Enable delete file button.",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
     }
   ],
   "events": [],

package/dist/doc/VJoyFormError/metadata.json

@@ -13,6 +13,17 @@
         "true"
       ]
     },
+    {
+      "name": "noMargin",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Allows to remove any bottom margin on the component",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
     {
       "name": "noHtmlErrorText",
       "type": "string | undefined",
@@ -51,6 +62,11 @@
       "type": "boolean",
       "isMethod": false
     },
+    {
+      "name": "noMargin",
+      "type": "boolean",
+      "isMethod": false
+    },
     {
       "name": "noHtmlErrorText",
       "type": "string | undefined",

package/dist/doc/VJoyFunnel/JoyFunnel.types.ts

@@ -0,0 +1,5 @@
+import {Profiles, TSizes} from '../../types';
+
+export type TJoyFunnelLayoutWidths = Extract<TSizes, 'medium' | 'large'>;
+
+export type TJoyFunnelProfiles = `${Profiles.STRATEGY}` | `${Profiles.DEFAULT}`;

package/dist/doc/VJoyHighlight/JoyHighlight.types.ts

@@ -0,0 +1,4 @@
+import {TLevels} from '../../types';
+
+export type TJoyHighlightLevels = TLevels;
+export type TJoyHighlightVariants = 'ai' | 'default';

package/dist/doc/VJoyHighlight/metadata.json

@@ -54,7 +54,7 @@
       "type": "string",
       "required": false,
       "description": "Based on maltjoy/icons availabilities. Works in pair with displayIcon boolean prop.",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     }
   ],
   "events": [],

package/dist/doc/VJoyIcon/JoyIcon.types.ts

@@ -0,0 +1,8 @@
+import type {JoyIconsId} from '@maltjoy/icons';
+import {TSizes, TLevels} from '../../types';
+
+export type TJoyIconsColors = TLevels | 'neutral-50' | 'primary' | 'secondary' | 'tertiary' | 'quaternary' | 'brand-primary' | 'brand-secondary' | 'white';
+
+export type TJoyIconSizes = TSizes;
+
+export type TJoyIconsNames = JoyIconsId;

package/dist/doc/VJoyIcon/metadata.json

@@ -65,7 +65,7 @@
         "key",
         "user-photo",
         "link",
-        "... (207 more)"
+        "... (210 more)"
       ]
     },
     {

package/dist/doc/VJoyIndicators/JoyIndicators.types.ts

@@ -0,0 +1 @@
+export type TJoyIndicatorsVariants = 'default' | 'light';

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

@@ -0,0 +1,36 @@
+import {TSizes} from '../../types';
+import {TJoyIconsNames} from '../JoyIcon/JoyIcon.types';
+import {TJoyLabelSizes} from '../JoyLabel/JoyLabel.types';
+
+export type TJoyInputSizes = Extract<TSizes, 'small' | 'medium' | 'large'>;
+
+export interface VJoyInputProps {
+    autofocus?: boolean;
+    modelValue?: string | number | null;
+    disabled?: boolean;
+    id?: string;
+    invalid?: boolean;
+    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;
+    /** Overrides the default label size. See JoyLabel stories */
+    labelSize?: TJoyLabelSizes;
+    /** If your component is not required, we can add a label to explicitely tell that it's not mandatory */
+    optionalLabel?: string;
+    /** Depending on context, we can add a "*" after the label to specify it's mandatory. */
+    requiredMark?: boolean;
+    modelModifiers?: Partial<Record<'number' | 'trim' | 'lazy', boolean>>;
+    /** Display a cross icon on the right that enables to clear the field */
+    clearable?: boolean;
+    /** Add a JoyIcon / joy-icon with given name on left-side. */
+    icon?: TJoyIconsNames;
+    size?: TJoyInputSizes;
+    type?: string;
+    /** Adds a legend like symbol on the right of the component. Made for number based values */
+    unit?: string;
+    /** Activates the readonly mode for the input */
+    readonly?: boolean;
+    /** When using the clearable property, you have to specific an aria-label for accessibility. */
+    clearAriaLabel?: string;
+}

package/dist/doc/VJoyInput/metadata.json

@@ -57,10 +57,12 @@
     },
     {
       "name": "name",
-      "type": "string",
-      "required": true,
+      "type": "string | undefined",
+      "required": false,
       "description": "",
-      "possibleValues": null
+      "possibleValues": [
+        "string"
+      ]
     },
     {
       "name": "required",
@@ -140,7 +142,7 @@
       "type": "string",
       "required": false,
       "description": "Add a JoyIcon / joy-icon with given name on left-side.",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "size",
@@ -284,7 +286,7 @@
     },
     {
       "name": "name",
-      "type": "string",
+      "type": "string | undefined",
       "isMethod": false
     },
     {

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

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

package/dist/doc/VJoyLink/JoyLink.types.ts

@@ -0,0 +1,2 @@
+export type TJoyLinkColors = 'teal' | 'white';
+export type TJoyLinkType = HTMLButtonElement['type'];

package/dist/doc/VJoyLink/metadata.json

@@ -25,7 +25,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "text",

package/dist/doc/VJoyListItem/metadata.json

@@ -7,7 +7,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     }
   ],
   "events": [

package/dist/doc/VJoyMenu/JoyMenu.types.ts

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

package/dist/doc/VJoyMenu/metadata.json

@@ -129,6 +129,7 @@
                       "\"bell\"",
                       "\"block-shield\"",
                       "\"bricks\"",
+                      "\"briefcase-hover\"",
                       "\"briefcase\"",
                       "\"calendar\"",
                       "\"camcorder\"",
@@ -243,6 +244,8 @@
                       "\"plus-circle\"",
                       "\"pound-circle\"",
                       "\"print\"",
+                      "\"profile-picture-hover\"",
+                      "\"profile-picture\"",
                       "\"projectmanager-agile\"",
                       "\"qr-code\"",
                       "\"question-circle\"",

package/dist/doc/VJoyMenuItem/metadata.json

@@ -23,7 +23,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "current",
@@ -50,7 +50,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "statusColor",

package/dist/doc/VJoyPanel/JoyPanel.types.ts

@@ -0,0 +1,6 @@
+import {TSizes} from '../../types';
+
+export type TJoyPanelSizes = Extract<TSizes, 'small' | 'medium' | 'large'>;
+export type TJoyPanelTitleSizes = Extract<TSizes, 'small' | 'large'>;
+
+export type TJoyPanelVariants = 'default' | 'ai';

package/dist/doc/VJoyProductTour/JoyProductTour.types.ts

@@ -0,0 +1,45 @@
+import {TJoyIconsNames} from '../JoyIcon/JoyIcon.types';
+import VJoyProductTourInner from './VJoyProductTourInner.vue';
+
+export const PRODUCT_TOUR_POSITIONS = ['left', 'right', 'top', 'bottom'] as const;
+export type TJoyProductTourPositions = (typeof PRODUCT_TOUR_POSITIONS)[number];
+
+export interface IJoyProductTourShowParams {
+    highlightSelector?: HTMLElement;
+}
+
+export type TJoyProductTourEvents = {
+    'product-tour:show': string;
+};
+
+export interface VJoyProductTourProps {
+    icon?: TJoyIconsNames;
+    steps?: number;
+    step?: number;
+    position?: TJoyProductTourPositions;
+    open?: boolean;
+    maxWidth?: number;
+    disableOverlay?: boolean;
+    spotlightPadding?: number;
+    spotlightSelector: string;
+    closeButton?: boolean;
+}
+
+export interface VJoyProductTourSlots {
+    /** Allows to inject an image above the title */
+    'product-tour-banner'?: () => any;
+    /** Most of the time we use it to display tags, or short content */
+    'product-tour-preheader'?: () => any;
+    /** Title of the component */
+    'product-tour-header'?: () => any;
+    /** Main content. Put whatever you want here */
+    'product-tour-content'?: () => any;
+    /** The click here will automatically handle slotted VJoyButton with bubbling */
+    'product-tour-dismiss'?: () => any;
+    /** To display the main CTA. Component hiding needs to be made manually */
+    'product-tour-next'?: () => any;
+}
+
+export interface VJoyProductToursEvents {
+    'product-tour:hide': [];
+}

package/dist/doc/VJoyProductTour/metadata.json

@@ -7,7 +7,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "steps",

package/dist/doc/VJoyProgressBar/JoyProgressBar.types.ts

@@ -0,0 +1,3 @@
+import {TGenericVariants, TLevels} from '../../types';
+
+export type TJoyProgressBarColors = TGenericVariants | Exclude<TLevels, 'info' | 'neutral'>;

package/dist/doc/VJoyRadio/JoyRadio.types.ts

@@ -0,0 +1 @@
+export type RadioThemes = 'default' | 'outline';

package/dist/doc/VJoyRadio/metadata.json

@@ -2,6 +2,17 @@
   "name": "JoyRadio",
   "displayName": "VJoyRadio",
   "props": [
+    {
+      "name": "invalid",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "undefined",
+      "description": "Invalid state of the component\n\nIf not explicitly provided, will inherit from parent VJoyRadioGroup's invalid prop.\nNote: A checked radio cannot be invalid (the `checked` state takes priority over `invalid` state).",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
+    },
     {
       "name": "required",
       "type": "boolean | undefined",
@@ -104,6 +115,11 @@
     }
   ],
   "exposed": [
+    {
+      "name": "invalid",
+      "type": "boolean",
+      "isMethod": false
+    },
     {
       "name": "required",
       "type": "boolean",

package/dist/doc/VJoyRadioGroup/JoyRadioGroup.types.ts

@@ -0,0 +1 @@
+export type RadioGroupDirection = 'vertical' | 'horizontal';

package/dist/doc/VJoyRadioGroup/metadata.json

@@ -30,6 +30,17 @@
       "possibleValues": [
         "string"
       ]
+    },
+    {
+      "name": "invalid",
+      "type": "boolean | undefined",
+      "required": false,
+      "default": "false",
+      "description": "Invalid state of the radio group\n\nWhen set to true, all child VJoyRadio components will inherit this invalid state.\nNote: A checked radio cannot be invalid (the `checked` state takes priority over `invalid` state at the radio level).",
+      "possibleValues": [
+        "false",
+        "true"
+      ]
     }
   ],
   "events": [],
@@ -44,6 +55,11 @@
     }
   ],
   "exposed": [
+    {
+      "name": "invalid",
+      "type": "boolean",
+      "isMethod": false
+    },
     {
       "name": "direction",
       "type": "RadioGroupDirection",

package/dist/doc/VJoyRatingStars/JoyRatingStars.types.ts

@@ -0,0 +1,3 @@
+import {TSizes} from '../../types';
+
+export type TJoyRatingStarsSizes = Extract<TSizes, 'small' | 'medium' | 'large'>;

package/dist/doc/VJoyScreenLoader/VJoyScreenLoader.types.ts

@@ -0,0 +1 @@
+export type TJoyScreenLoaderColors = 'dark' | 'light';

package/dist/doc/VJoySelect/JoySelect.types.ts

@@ -0,0 +1,3 @@
+import {TSizes} from '../../types';
+
+export type TJoySelectSizes = Extract<TSizes, 'xsmall' | 'small' | 'medium'>;

package/dist/doc/VJoySelectableItem/VJoySelectableItem.types.ts

@@ -0,0 +1,10 @@
+import VJoySelectableItem from './VJoySelectableItem.vue';
+import type {ComponentProps} from 'vue-component-type-helpers';
+
+export type TVJoySelectableItemProps = ComponentProps<typeof VJoySelectableItem>;
+
+export interface TJoySelectableItemOption extends TVJoySelectableItemProps {
+    attrs?: {
+        [k: string]: any;
+    };
+}

package/dist/doc/VJoySelectableItem/metadata.json

@@ -104,7 +104,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     }
   ],
   "events": [

package/dist/doc/VJoySeparator/JoySeparator.types.ts

@@ -0,0 +1,4 @@
+import {TSizes} from '../../types';
+
+export type BinarySizes = 'default';
+export type TJoySeparatorSizes = BinarySizes | Extract<TSizes, 'small'>;

package/dist/doc/VJoySnackbar/JoySnackbar.types.ts

@@ -0,0 +1,23 @@
+import {App} from 'vue';
+import {Emitter} from 'mitt';
+import VJoySnackbar from './VJoySnackbar.vue';
+import {TLevels} from '../../types';
+
+export type TJoySnackbarLevels = Exclude<TLevels, 'neutral'>;
+
+export type TJoySnackbarEvents = {
+    'snackbar:hide': undefined;
+    'snackbar:show': undefined;
+    'snackbar:action-click': undefined;
+};
+
+export interface IJoynackbarServiceOptions {
+    disableStacking?: boolean;
+    snackbarHostId?: string;
+    props: InstanceType<typeof VJoySnackbar>['$props'];
+}
+
+export interface IJoynackbarServiceReturn {
+    snackbarEventBus: Emitter<TJoySnackbarEvents>;
+    snackbarApp: App<Element>;
+}

package/dist/doc/VJoySpinner/JoySpinner.types.ts

@@ -0,0 +1 @@
+export type TJoySpinnerColors = 'teal' | 'white';

package/dist/doc/VJoyStep/TJoyStep.types.ts

@@ -0,0 +1 @@
+export type TJoyStepSizes = 'small' | 'default';

package/dist/doc/VJoyTag/JoyTag.types.ts

@@ -0,0 +1,19 @@
+import {TSizes} from '../../types';
+import VJoyTag from './VJoyTag.vue';
+
+export type TJoyTagVariants = 'important' | 'inactive' | 'pending' | 'pricing' | 'special' | 'primary' | 'secondary' | 'ai-primary' | 'ai-secondary' | 'empty';
+
+export type TJoyTagSizes = Exclude<TSizes, 'xlarge' | 'xxsmall'>;
+
+export type VJoyTagProps = InstanceType<typeof VJoyTag>['$props'];
+
+export interface IJoyTagSelected {
+    selected: boolean;
+    value: VJoyTagProps['value'];
+}
+
+export interface IJoyTagRemoved {
+    value: VJoyTagProps['value'];
+}
+
+export interface IJoyTag extends VJoyTagProps {}

package/dist/doc/VJoyTagsInput/JoyTagsInput.types.ts

@@ -0,0 +1,4 @@
+export enum TAGS_INPUT_ERRORS {
+    DUPLICATED_ENTRY = 'DUPLICATED_ENTRY',
+    INVALID_EMAIL = 'INVALID_EMAIL',
+}

package/dist/doc/VJoyTagsList/JoyTagsList.types.ts

@@ -0,0 +1,5 @@
+import {IJoyTag} from '../JoyTag/JoyTag.types';
+
+export type TJoyTagsListAlign = 'center' | 'left' | 'right';
+export type TJoyTagsList = IJoyTag[];
+export type TJoyTagsListModel = IJoyTag['value'][];

package/dist/doc/VJoyTemplate/JoyTemplate.types.ts

@@ -0,0 +1 @@
+export type TJoyTemplateSidebarSide = 'left' | 'right';

package/dist/doc/VJoyText/JoyText.types.ts

@@ -0,0 +1,14 @@
+import {PRIMARY_FONT_SIZES, SECONDARY_FONT_SIZES, PRIMARY_FONT_SIZES_BOLD, FontsFamilies} from '../../types';
+
+const JOY_TEXT_FONT_PRIMARY_PRESET = PRIMARY_FONT_SIZES.map((s) => 'primary-' + s);
+const JOY_TEXT_FONT_PRIMARY_BOLD_PRESET = PRIMARY_FONT_SIZES_BOLD;
+const JOY_TEXT_FONT_SECONDARY_PRESET = SECONDARY_FONT_SIZES.map((s) => 'secondary-' + s);
+
+export const JOY_TEXT_FONT_PRESET = [...JOY_TEXT_FONT_PRIMARY_PRESET, ...JOY_TEXT_FONT_PRIMARY_BOLD_PRESET, ...JOY_TEXT_FONT_SECONDARY_PRESET];
+
+export type TJoyTextFontPreset =
+    | `${FontsFamilies.PRIMARY}-${(typeof PRIMARY_FONT_SIZES)[number]}`
+    | `${FontsFamilies.SECONDARY}-${(typeof SECONDARY_FONT_SIZES)[number]}`
+    | `${FontsFamilies.PRIMARY}-${(typeof PRIMARY_FONT_SIZES_BOLD)[number]}`;
+
+export type TJoyTextTagName = 'p' | 'span' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'strong';

package/dist/doc/VJoyWalkthrough/metadata.json

@@ -47,7 +47,7 @@
         "key",
         "user-photo",
         "link",
-        "... (207 more)"
+        "... (210 more)"
       ]
     },
     {

package/dist/doc/VJoyWalkthroughTrigger/metadata.json

@@ -7,7 +7,7 @@
       "type": "string",
       "required": false,
       "description": "",
-      "possibleValues": "TJoyIconsNames (217 values)"
+      "possibleValues": "TJoyIconsNames (220 values)"
     },
     {
       "name": "title",

package/dist/doc/VJoyWrapper/JoyWrapper.types.ts

@@ -0,0 +1,9 @@
+export type TJoyWrapperJustify = 'center' | 'space-between' | 'flex-start' | 'flex-end';
+
+export type TJoyWrapperAlign = 'center' | 'flex-start' | 'flex-end' | 'stretch';
+
+export type TJoyWrapperDirection = 'row' | 'column';
+
+export type TJoyWrapperWrap = 'nowrap' | 'wrap';
+
+export type TJoyWrapperGap = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12';

package/dist/doc/index.json

@@ -1,9 +1,9 @@
 {
-  "generated": "2026-01-09T09:22:06.580Z",
-  "version": "0.2.0",
+  "generated": "2026-02-20T10:05:20.068Z",
+  "version": "1.0.0",
   "statistics": {
     "totalComponents": 74,
-    "totalProps": 407,
+    "totalProps": 410,
     "totalEvents": 57,
     "totalSlots": 136,
     "componentsWithVModel": 18,
@@ -46,7 +46,7 @@
     {
       "name": "VJoyBadge",
       "path": "VJoyBadge/metadata.json",
-      "propsCount": 4,
+      "propsCount": 3,
       "eventsCount": 0,
       "slotsCount": 1,
       "hasError": false
@@ -182,7 +182,7 @@
     {
       "name": "VJoyDropzone",
       "path": "VJoyDropzone/metadata.json",
-      "propsCount": 10,
+      "propsCount": 11,
       "eventsCount": 0,
       "slotsCount": 4,
       "hasError": false
@@ -206,7 +206,7 @@
     {
       "name": "VJoyFormError",
       "path": "VJoyFormError/metadata.json",
-      "propsCount": 3,
+      "propsCount": 4,
       "eventsCount": 0,
       "slotsCount": 1,
       "hasError": false
@@ -382,7 +382,7 @@
     {
       "name": "VJoyRadio",
       "path": "VJoyRadio/metadata.json",
-      "propsCount": 7,
+      "propsCount": 8,
       "eventsCount": 1,
       "slotsCount": 5,
       "hasError": false
@@ -390,7 +390,7 @@
     {
       "name": "VJoyRadioGroup",
       "path": "VJoyRadioGroup/metadata.json",
-      "propsCount": 3,
+      "propsCount": 4,
       "eventsCount": 0,
       "slotsCount": 2,
       "hasError": false

package/dist/index.js

@@ -9,6 +9,7 @@ import { listComponentsTool, handleListComponents } from './tools/list-component
 import { getComponentInfoTool, handleGetComponentInfo } from './tools/get-component-info.js';
 import { listDesignTokensTool, handleListDesignTokens } from './tools/list-design-tokens.js';
 import { listCssClassesTool, handleListCssClasses } from './tools/list-css-classes.js';
+import { getComponentTypesTool, handleGetComponentTypes } from './tools/get-component-types.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -20,7 +21,7 @@ class JoyMcpServer {
     constructor() {
         this.server = new Server({
             name: 'joy-design-system',
-            version: '0.1.2',
+            version: '0.3.0',
         }, {
             capabilities: {
                 tools: {},
@@ -33,7 +34,7 @@ class JoyMcpServer {
         // List available tools
         this.server.setRequestHandler(ListToolsRequestSchema, async () => {
             return {
-                tools: [listComponentsTool, getComponentInfoTool, listDesignTokensTool, listCssClassesTool],
+                tools: [listComponentsTool, getComponentInfoTool, getComponentTypesTool, listDesignTokensTool, listCssClassesTool],
             };
         });
         // Handle tool calls
@@ -64,6 +65,18 @@ class JoyMcpServer {
                             ],
                         };
                     }
+                    case 'joy_get_component_types': {
+                        const componentName = args?.componentName;
+                        const result = await handleGetComponentTypes(componentName);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
                     case 'joy_list_design_tokens': {
                         const result = handleListDesignTokens();
                         return {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-component-types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool definition for getting TypeScript types associated with a Joy Vue component
+ */
+export declare const getComponentTypesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            componentName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ComponentTypesResult {
+    componentName: string;
+    files: {
+        filename: string;
+        content: string;
+    }[];
+}
+/**
+ * Handler for the get component types tool
+ */
+export declare function handleGetComponentTypes(componentName: string): Promise<ComponentTypesResult | {
+    error: string;
+}>;
+//# sourceMappingURL=get-component-types.d.ts.map

package/dist/tools/get-component-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-types.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-types.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAgBjC,CAAC;AAcF,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,oBAAoB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBnD"}

package/dist/tools/get-component-types.js

@@ -0,0 +1,60 @@
+import { readFileSync, readdirSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Tool definition for getting TypeScript types associated with a Joy Vue component
+ */
+export const getComponentTypesTool = {
+    name: 'joy_get_component_types',
+    description: 'Retrieves the TypeScript types definition file associated with a specific Joy Vue3 component. ' +
+        'These types define the allowed values for props (variants, sizes, etc.). ' +
+        'Provide the exact component name (e.g., VJoyButton).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            componentName: {
+                type: 'string',
+                description: 'The exact name of the component (e.g., VJoyButton, VJoyAvatar)',
+            },
+        },
+        required: ['componentName'],
+    },
+};
+/**
+ * Find all *.types.ts files in a component doc directory.
+ */
+function findTypesFiles(componentDir) {
+    try {
+        const entries = readdirSync(componentDir);
+        return entries.filter((f) => f.endsWith('.types.ts'));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Handler for the get component types tool
+ */
+export async function handleGetComponentTypes(componentName) {
+    if (!componentName || typeof componentName !== 'string') {
+        return {
+            error: 'Invalid component name. Please provide a valid component name (e.g., VJoyButton).',
+        };
+    }
+    const componentDir = join(__dirname, '..', 'doc', componentName);
+    const typesFiles = findTypesFiles(componentDir);
+    if (typesFiles.length === 0) {
+        return {
+            error: `No types file found for component "${componentName}". ` +
+                'Use joy_list_components to get a list of available components.',
+        };
+    }
+    const files = typesFiles.map((filename) => ({
+        filename,
+        content: readFileSync(join(componentDir, filename), 'utf-8'),
+    }));
+    return { componentName, files };
+}
+//# sourceMappingURL=get-component-types.js.map

package/dist/tools/get-component-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-types.js","sourceRoot":"","sources":["../../src/tools/get-component-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,gGAAgG;QAChG,2EAA2E;QAC3E,sDAAsD;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gEAAgE;aAC9E;SACF;QACD,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,cAAc,CAAC,YAAoB;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAOD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB;IAErB,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO;YACL,KAAK,EAAE,mFAAmF;SAC3F,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EACH,sCAAsC,aAAa,KAAK;gBACxD,gEAAgE;SACnE,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1C,QAAQ;QACR,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;KAC7D,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maltjoy/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for Joy Design System - exposes Vue3 components information",
   "type": "module",
   "main": "dist/index.js",