@maltjoy/mcp-server 0.5.0-beta.0 → 0.6.0-beta.0

package/dist/doc/VJoyWrapper/guideline.md

@@ -0,0 +1,173 @@
+---
+component: VJoyWrapper
+status: draft
+language: en
+dsds: JoyWrapper.dsds.json
+dsdsVersion: "0.15.2"
+---
+
+# Wrapper
+
+Use **`VJoyWrapper`** when you need a flex layout with Joy spacing tokens — for example a row of buttons, a vertical stack of form fields, or a wrapping tag list — without writing custom flex CSS.
+
+The component maps common flexbox props (`justify`, `align`, `direction`, `wrap`, gaps) to token-based classes, applies a default bottom margin between stacked wrappers, and `provide`s `VJoyWrapperContext` so children (e.g. `VJoyFormFieldSkeleton`) can align with the parent layout.
+
+| | |
+| --- | --- |
+| **Code** | `VJoyWrapper` from `@maltjoy/core-vue` |
+| **Storybook** | [VJoyWrapper docs](https://doc.malt.tech/joy-storybook/?path=/docs/components-layout-vjoywrapper--docs) |
+| **DSDS (machine)** | [`JoyWrapper.dsds.json`](./JoyWrapper.dsds.json) |
+| **Live API** | `joy_get_component_info("VJoyWrapper")` |
+
+---
+
+## When to use this component
+
+Use a wrapper when several sibling elements need **consistent gaps and alignment** in a flex row or column. Typical jobs: button groups, horizontal or vertical form field stacks, filter chips, skeleton layouts, and any list of Joy components that should wrap on small viewports.
+
+Prefer `VJoyWrapper` over ad-hoc `display: flex` in product CSS so spacing stays on the Joy spacing scale (`columnGap` / `rowGap` map to `--joy-core-spacing-*`).
+
+### When not to use this component
+
+| Need | Use instead |
+| --- | --- |
+| Label + field + error grouped as one form unit | `VJoyFormGroup` |
+| Card / panel with header, body, and footer | `VJoyPanel` |
+| Full page structure (header, sidebar, content) | `VJoyTemplate` |
+| Pre-styled tag list container | `VJoyTagsList` (or `VJoyWrapper` + `VJoyTag` when you need more control) |
+| Every flexbox option (grid, `space-around`, arbitrary child rules) | Extend only with documented props — don’t replace with raw layout CSS for the same job |
+
+---
+
+## How it works
+
+### Anatomy
+
+| Part | Required? | What it is |
+| --- | --- | --- |
+| Root (`div.joy-wrapper`) | Yes | Flex container; modifier classes set justify, align, direction, wrap, and gaps |
+| Default slot | Yes | Direct children laid out in the flex flow |
+| Bottom margin | Default on | `margin-bottom: --joy-core-spacing-8` unless `noMargin` is true |
+
+Children get `max-width: 100%`. With `itemStretch`, direct children receive `flex: 1 0 auto` so they share horizontal space. Nested `.joy-panel` children get `width: auto`.
+
+### Default values
+
+- `justify` defaults to **`flex-start`**
+- `align` defaults to **`center`**
+- `direction` defaults to **`row`**
+- `wrap` defaults to **`wrap`**
+- `columnGap` defaults to **`4`** (spacing token)
+- `rowGap` defaults to **`8`** (spacing token)
+- `noMargin` defaults to **`false`** (bottom margin applied)
+- `itemStretch` is **unset** (no stretch until explicitly `true`)
+
+Props and slots: use Joy MCP or Storybook — this page focuses on **when** and **how**, not a full API dump.
+
+### Layout props (behavioral)
+
+| Prop | Maps to | Typical use |
+| --- | --- | --- |
+| `direction="row"` | `flex-direction: row` | Button rows, inline filters |
+| `direction="column"` | `flex-direction: column` | Stacked inputs or sections |
+| `justify` | `justify-content` | Spread items (`space-between` for toolbar ends) |
+| `align` | `align-items` | Vertical alignment in a row; use `stretch` for equal-height columns |
+| `wrap` | `flex-wrap` | `wrap` (default) for responsive rows; `nowrap` to keep one line |
+| `columnGap` / `rowGap` | `column-gap` / `row-gap` | Token `"0"`–`"12"` — don’t use raw px |
+| `itemStretch` | `flex-grow` on children | Equal-width fields in a horizontal form row |
+| `noMargin` | Removes default bottom margin | Nested wrappers or tight vertical rhythm |
+
+---
+
+## Best practices
+
+Rules use RFC 2119 strength (**MUST** / **SHOULD** / **MUST NOT** / **SHOULD NOT**).
+
+### Layout
+
+- **SHOULD** use `direction="column"` with `align="stretch"` for vertical form stacks.
+- **SHOULD** use `itemStretch` when sibling inputs or panels should share horizontal space in a row.
+- **SHOULD** set `noMargin` on the last wrapper in a section or when spacing is handled by a parent.
+- **SHOULD** use `wrap="wrap"` (default) for button or tag rows that may overflow on narrow viewports.
+- **MUST NOT** rely on `VJoyWrapper` for grid layouts or uncommon `justify-content` values not in the API.
+
+### Implementation
+
+- **MUST** use only documented prop values from MCP or `JoyWrapper.types.ts`.
+- **MUST** use spacing tokens via `columnGap` / `rowGap` — not inline `gap` in px.
+- **MUST NOT** invent props (`gap`, `size`, `variant`, …).
+- **MUST NOT** override `.joy-wrapper` flex rules in product CSS when a prop already exists.
+- **SHOULD** nest `VJoyFormGroup` inside a wrapper for each logical field, not replace `VJoyFormGroup` with wrapper-only markup.
+
+### Do / don’t
+
+| Do | Don’t |
+| --- | --- |
+| `columnGap="4"` `rowGap="8"` for token-consistent spacing | `style="gap: 12px"` on a plain `motion.div` |
+| `noMargin` on inner wrappers in a stack | Double bottom margins from wrapper + parent |
+| `itemStretch` for equal-width inputs in a row | Manual `flex: 1` on every child in app CSS |
+| `VJoyFormGroup` per field inside a column wrapper | One wrapper with no labels/errors between fields |
+
+---
+
+## Accessibility
+
+`VJoyWrapper` is a **non-interactive layout container** (`div`). It has no focusable parts and does not define ARIA roles.
+
+| Behavior | Expectation |
+| --- | --- |
+| Semantics | Do not use the wrapper as a button, link, or landmark — keep semantics on children |
+| Reading order | DOM order in the default slot matches visual order (row or column) |
+| Keyboard | No keyboard behavior on the wrapper itself; interactive children keep their own focus order |
+| Long content | Children are capped at `max-width: 100%`; very long unbroken text in `VJoyText` may still need an explicit `max-width` on the text node |
+
+---
+
+## Examples
+
+```vue
+<script setup lang="ts">
+import { VJoyWrapper, VJoyButton, VJoyInput } from '@maltjoy/core-vue'
+</script>
+
+<template>
+  <!-- Button group (default row, wrap) -->
+  <VJoyWrapper>
+    <VJoyButton label="Save" variant="main" size="xsmall" />
+    <VJoyButton label="Cancel" variant="ghost" size="xsmall" />
+  </VJoyWrapper>
+
+  <!-- Vertical form stack -->
+  <VJoyWrapper direction="column" align="stretch">
+    <VJoyInput name="email" label="Email" />
+    <VJoyInput name="phone" label="Phone" />
+  </VJoyWrapper>
+
+  <!-- Horizontal fields with equal width -->
+  <VJoyWrapper item-stretch>
+    <VJoyInput name="first" label="First name" />
+    <VJoyInput name="last" label="Last name" />
+  </VJoyWrapper>
+
+  <!-- Tight nested layout (no extra bottom margin) -->
+  <VJoyWrapper direction="column" no-margin row-gap="2">
+    <slot name="password-requirements" />
+  </VJoyWrapper>
+</template>
+```
+
+In Nuxt (or apps with auto-import), omit the import if `VJoyWrapper` is already global.
+
+---
+
+## Related
+
+| Component | Use when |
+| --- | --- |
+| `VJoyFormGroup` | One label + control + errors as a single form unit |
+| `VJoyPanel` | Bordered card with header, body, and actions |
+| `VJoyTagsList` | Opinionated horizontal list of `VJoyTag` |
+| `VJoyFormFieldSkeleton` / `VJoyBlockSkeleton` | Loading placeholders — often composed inside `VJoyWrapper` |
+| `VJoyButton` | Primary actions in button groups |
+| `VJoyInput` | Fields in column or stretched row layouts |
+| `VJoyText` | Long copy inside a wrapper may need `max-width` to avoid layout breakage |

package/dist/doc/css-classes.json

@@ -261,23 +261,7 @@
     ".joy-font-size-secondary-200",
     ".joy-font-size-secondary-400",
     ".joy-font-size-secondary-600",
-    ".joy-font-size-secondary-800",
-    ".joy-font-primary-100",
-    ".joy-font-primary-150",
-    ".joy-font-primary-200",
-    ".joy-font-primary-250",
-    ".joy-font-primary-300",
-    ".joy-font-primary-350",
-    ".joy-font-primary-400",
-    ".joy-font-primary-450",
-    ".joy-font-primary-600",
-    ".joy-font-primary-650",
-    ".joy-font-primary-800",
-    ".joy-font-primary-850",
-    ".joy-font-secondary-200",
-    ".joy-font-secondary-400",
-    ".joy-font-secondary-600",
-    ".joy-font-secondary-800"
+    ".joy-font-size-secondary-800"
   ],
   "elevation": [
     ".joy-core-elevation-0",

package/dist/doc/index.json

@@ -1,12 +1,12 @@
 {
-  "generated": "2026-07-16T08:33:41.023Z",
-  "version": "0.5.0-beta.0",
+  "generated": "2026-07-22T09:35:12.292Z",
+  "version": "0.6.0-beta.0",
   "statistics": {
-    "totalComponents": 83,
-    "totalProps": 486,
-    "totalEvents": 67,
-    "totalSlots": 150,
-    "componentsWithVModel": 23,
+    "totalComponents": 82,
+    "totalProps": 473,
+    "totalEvents": 66,
+    "totalSlots": 148,
+    "componentsWithVModel": 22,
     "componentsWithErrors": 0,
     "componentsWithPartialErrors": 1
   },
@@ -23,7 +23,7 @@
     },
     {
       "name": "VJoyAvailability",
-      "description": "A status indicator component for displaying user availability information.\nFeatures colored dots and optional labels to communicate different availability states such as available, not available, available soon, or partially available.\nCan be displayed as a simple dot indicator or with descriptive text labels that handle long content gracefully!",
+      "description": "A status indicator component for displaying user availability information.\nFeatures colored dots and optional labels to communicate different availability states such as available, not available, available soon, or partially available.\nCan be displayed as a simple dot indicator or with descriptive text labels that handle long content gracefully.",
       "category": "View",
       "path": "VJoyAvailability/metadata.json",
       "propsCount": 3,
@@ -106,7 +106,7 @@
       "description": "A button component supporting multiple variants, sizes, and states.\nFeatures icon support, loading states and can function as either a button or link element.\nIncludes ripple effects and comprehensive styling options for different use cases from primary actions to subtle ghost buttons.\n\n**Tips:** set a \"href\" attribute to make the button a link.",
       "category": "Buttons",
       "path": "VJoyButton/metadata.json",
-      "propsCount": 9,
+      "propsCount": 8,
       "eventsCount": 0,
       "slotsCount": 1,
       "hasError": false
@@ -253,10 +253,10 @@
     },
     {
       "name": "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 disabled, invalid, and drag states, error handling, and flexible content slots for file information and actions.\n\nThe dropzone requires a `v-model` bound to an array containing objects with at least the `name` property (or `File` instances).\n\nUse `canDelete` (default `true`) to hide the delete button on file items while keeping update available. Set `disabled` to block uploads, drag-and-drop, and file actions. Set `invalid` for parent form feedback (e.g. required empty field); it adds invalid styling but does not replace format/size validation. The exposed `invalid` ref only reflects file validation (`accept`, `maxSize`); the `invalid` prop is for external form state—both can apply the invalid appearance.\n\nSlots: `dropzone-description` for the main instruction (default text with browse link), `dropzone-subtitle` for an optional hint line (empty by default), `dropzone-legend` for helper text below the zone, `file-information` and `file-actions` for per-file content (slot prop `file`). In single-file mode, `dropzone-legend` is hidden when a format or size error is shown (`VJoyFormError` instead); in multiple mode, errors appear on each file item and the legend stays visible.",
+      "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 disabled, invalid, and drag states, error handling, and flexible content slots for file information and actions.\n\nThe dropzone requires a `v-model` bound to an array containing objects with at least the `name` property (or `File` instances).\n\nUse `label` to display a label above the dropzone. Use `canDelete` (default `true`) to hide the delete button on file items while keeping update available. Set `disabled` to block uploads, drag-and-drop, and file actions. Set `invalid` for parent form feedback (e.g. required empty field); it adds invalid styling but does not replace format/size validation. The exposed `invalid` ref only reflects file validation (`accept`, `maxSize`); the `invalid` prop is for external form state—both can apply the invalid appearance.\n\nSlots: `dropzone-description` for the main instruction (default text with browse link), `dropzone-subtitle` for an optional hint line (empty by default), `dropzone-legend` for helper text below the zone, `file-information` and `file-actions` for per-file content (slot prop `file`). In single-file mode, `dropzone-legend` is hidden when a format or size error is shown (`VJoyFormError` instead); in multiple mode, errors appear on each file item and the legend stays visible.",
       "category": "Forms",
       "path": "VJoyDropzone/metadata.json",
-      "propsCount": 13,
+      "propsCount": 14,
       "eventsCount": 0,
       "slotsCount": 5,
       "hasError": false
@@ -296,7 +296,7 @@
       "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",
       "path": "VJoyFormError/metadata.json",
-      "propsCount": 4,
+      "propsCount": 3,
       "eventsCount": 0,
       "slotsCount": 1,
       "hasError": false
@@ -373,7 +373,7 @@
     },
     {
       "name": "VJoyIconButton",
-      "description": "A dedicated icon-button component built on top of `VJoyButton`.\nUse this component instead of the deprecated `circle` prop from `VJoyButton`.",
+      "description": "A dedicated icon-button component built on top of `VJoyButton`.\nIcon-only button with an accessible label.",
       "category": "Buttons",
       "path": "VJoyIconButton/metadata.json",
       "propsCount": 6,
@@ -403,10 +403,10 @@
     },
     {
       "name": "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.",
+      "description": "A comprehensive form input component with extensive customization and validation features.\nSupports multiple input types, icon support, clearable functionality, and comprehensive validation states.\nFeatures auto-focus capabilities, accessibility compliance, and seamless integration with form validation systems.",
       "category": "Forms",
       "path": "VJoyInput/metadata.json",
-      "propsCount": 19,
+      "propsCount": 18,
       "eventsCount": 1,
       "slotsCount": 2,
       "hasError": false
@@ -436,7 +436,7 @@
       "description": "Password input built on top of VJoyInput with built-in visibility toggle.",
       "category": "Forms",
       "path": "VJoyInputPassword/metadata.json",
-      "propsCount": 15,
+      "propsCount": 14,
       "eventsCount": 1,
       "slotsCount": 1,
       "hasError": false
@@ -491,16 +491,6 @@
       "slotsCount": 0,
       "hasError": false
     },
-    {
-      "name": "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",
-      "path": "VJoyMultiCheckbox/metadata.json",
-      "propsCount": 9,
-      "eventsCount": 1,
-      "slotsCount": 2,
-      "hasError": false
-    },
     {
       "name": "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.",
@@ -533,7 +523,7 @@
     },
     {
       "name": "VJoyPasswordRequirement",
-      "description": "A component to display a password requirement status.\nThis is meant to be displayed under a VJoyInput of type password.",
+      "description": "A component to display a password requirement status.\nThis is meant to be displayed under VJoyInputPassword.",
       "category": "Forms",
       "path": "VJoyPasswordRequirement/metadata.json",
       "propsCount": 2,
@@ -803,10 +793,10 @@
     },
     {
       "name": "VJoyUserCard",
-      "description": "A comprehensive user profile card component for displaying user information in a structured layout.\nFeatures integrated avatar display, name/subtitle presentation, rating stars support, and optional\nlink functionality for navigation. Includes multiple customization slots for avatar, title, subtitle,\nand rating components, with full attribute inheritance for link behavior and accessibility.",
+      "description": "A comprehensive user profile card component for displaying user information in a structured layout.\nFeatures integrated avatar display, name/subtitle presentation, rating stars support, and optional\nlink functionality for navigation. Includes multiple customization slots for avatar, title, subtitle,\nand free content through the default slot, with full attribute inheritance for link behavior and\naccessibility. The user-card-rating-stars slot is deprecated; use the default slot for custom\nrating stars or other free content instead.",
       "category": "View",
       "path": "VJoyUserCard/metadata.json",
-      "propsCount": 5,
+      "propsCount": 4,
       "eventsCount": 0,
       "slotsCount": 5,
       "hasError": false

package/dist/index.js

@@ -7,12 +7,10 @@ import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { listComponentsTool, handleListComponents } from './tools/list-components.js';
 import { getComponentInfoTool, handleGetComponentInfo } from './tools/get-component-info.js';
+import { getComponentGuidelineTool, handleGetComponentGuideline } from './tools/get-component-guideline.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';
-import { listDocumentationPagesTool, handleListDocumentationPages } from './tools/list-documentation-pages.js';
-import { getDocumentationPageTool, handleGetDocumentationPage } from './tools/get-documentation-page.js';
-import { searchDocumentationTool, handleSearchDocumentation } from './tools/search-documentation.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -24,7 +22,7 @@ class JoyMcpServer {
     constructor() {
         this.server = new Server({
             name: 'joy-design-system',
-            version: '0.2.0',
+            version: '0.6.0-beta.0',
         }, {
             capabilities: {
                 tools: {},
@@ -40,12 +38,10 @@ class JoyMcpServer {
                 tools: [
                     listComponentsTool,
                     getComponentInfoTool,
+                    getComponentGuidelineTool,
                     getComponentTypesTool,
                     listDesignTokensTool,
                     listCssClassesTool,
-                    listDocumentationPagesTool,
-                    getDocumentationPageTool,
-                    searchDocumentationTool,
                 ],
             };
         });
@@ -89,6 +85,18 @@ class JoyMcpServer {
                             ],
                         };
                     }
+                    case 'joy_get_component_guideline': {
+                        const componentName = args?.componentName;
+                        const result = await handleGetComponentGuideline(componentName);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
                     case 'joy_list_design_tokens': {
                         const result = handleListDesignTokens();
                         return {
@@ -111,24 +119,6 @@ class JoyMcpServer {
                             ],
                         };
                     }
-                    case 'joy_list_documentation_pages': {
-                        const result = await handleListDocumentationPages(args?.category, args?.componentName);
-                        return {
-                            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-                        };
-                    }
-                    case 'joy_get_documentation_page': {
-                        const result = await handleGetDocumentationPage(args?.page, args?.section);
-                        return {
-                            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-                        };
-                    }
-                    case 'joy_search_documentation': {
-                        const result = await handleSearchDocumentation(args?.query, args?.componentName, args?.limit);
-                        return {
-                            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-                        };
-                    }
                     default:
                         throw new Error(`Unknown tool: ${name}`);
                 }

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-guideline.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tool definition for retrieving the DSDS usage guideline markdown for a Joy component.
+ */
+export declare const getComponentGuidelineTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            componentName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ComponentGuidelineResult {
+    componentName: string;
+    format: 'markdown';
+    source: 'DSDS.guideline.md';
+    content: string;
+}
+/**
+ * Handler for joy_get_component_guideline
+ */
+export declare function handleGetComponentGuideline(componentName: string): Promise<ComponentGuidelineResult | {
+    error: string;
+}>;
+//# sourceMappingURL=get-component-guideline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-guideline.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-guideline.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;CAkBrC,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC7C,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,wBAAwB,GAAG;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC,CAwBrD"}

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

@@ -0,0 +1,51 @@
+import { existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Tool definition for retrieving the DSDS usage guideline markdown for a Joy component.
+ */
+export const getComponentGuidelineTool = {
+    name: 'joy_get_component_guideline',
+    description: 'Retrieves the DSDS usage guideline Markdown for a Joy Vue3 component. ' +
+        'Includes when to use / not use, anatomy, variants, best practices (MUST / SHOULD), ' +
+        'accessibility, examples, and agent rules. ' +
+        'Use this after joy_get_component_info when you need usage guidance — not a props dump. ' +
+        '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, VJoyInput)',
+            },
+        },
+        required: ['componentName'],
+    },
+};
+/**
+ * Handler for joy_get_component_guideline
+ */
+export async function handleGetComponentGuideline(componentName) {
+    if (!componentName || typeof componentName !== 'string') {
+        return {
+            error: 'Invalid component name. Please provide a valid component name (e.g., VJoyButton).',
+        };
+    }
+    const guidelinePath = join(__dirname, '..', 'doc', componentName, 'guideline.md');
+    if (!existsSync(guidelinePath)) {
+        return {
+            error: `No DSDS guideline found for component "${componentName}". ` +
+                'Use joy_list_components to get a list of available components, ' +
+                'or joy_get_component_info for the API surface.',
+        };
+    }
+    return {
+        componentName,
+        format: 'markdown',
+        source: 'DSDS.guideline.md',
+        content: readFileSync(guidelinePath, 'utf-8'),
+    };
+}
+//# sourceMappingURL=get-component-guideline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-guideline.js","sourceRoot":"","sources":["../../src/tools/get-component-guideline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,IAAI,CAAC;AAC5C,OAAO,EAAC,aAAa,EAAC,MAAM,KAAK,CAAC;AAClC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,MAAM,MAAM,CAAC;AAEnC,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,yBAAyB,GAAG;IACrC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACP,wEAAwE;QACxE,qFAAqF;QACrF,4CAA4C;QAC5C,yFAAyF;QACzF,sDAAsD;IAC1D,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,aAAa,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC/E;SACJ;QACD,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC9B;CACJ,CAAC;AASF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC7C,aAAqB;IAErB,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO;YACH,KAAK,EAAE,mFAAmF;SAC7F,CAAC;IACN,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IAElF,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7B,OAAO;YACH,KAAK,EACD,0CAA0C,aAAa,KAAK;gBAC5D,iEAAiE;gBACjE,gDAAgD;SACvD,CAAC;IACN,CAAC;IAED,OAAO;QACH,aAAa;QACb,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,mBAAmB;QAC3B,OAAO,EAAE,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC;KAChD,CAAC;AACN,CAAC"}

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

@@ -1,11 +1,4 @@
 import { ComponentInfo } from '../parser.js';
-interface ComponentInfoWithDocumentation extends ComponentInfo {
-    documentationPages: Array<{
-        id: string;
-        slug: string;
-        title: string;
-    }>;
-}
 /**
  * Tool definition for getting detailed information about a specific Joy Vue component
  */
@@ -26,8 +19,7 @@ export declare const getComponentInfoTool: {
 /**
  * Handler for the get component info tool
  */
-export declare function handleGetComponentInfo(componentName: string): Promise<ComponentInfoWithDocumentation | {
+export declare function handleGetComponentInfo(componentName: string): Promise<ComponentInfo | {
     error: string;
 }>;
-export {};
 //# sourceMappingURL=get-component-info.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-component-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAE,MAAM,cAAc,CAAC;AAGjE,UAAU,8BAA+B,SAAQ,aAAa;IAC5D,kBAAkB,EAAE,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAahC,CAAC;AAEF;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB/H"}
+{"version":3,"file":"get-component-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAahC,CAAC;AAEF;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB9G"}

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

@@ -1,5 +1,4 @@
 import { parseComponentInfo } from '../parser.js';
-import { listDocumentationPages } from '../zeroheight-parser.js';
 /**
  * Tool definition for getting detailed information about a specific Joy Vue component
  */
@@ -32,13 +31,6 @@ export async function handleGetComponentInfo(componentName) {
             error: `Component "${componentName}" not found. Use joy_list_components to get a list of available components.`
         };
     }
-    return {
-        ...componentInfo,
-        documentationPages: listDocumentationPages(undefined, componentName).map((page) => ({
-            id: page.id,
-            slug: page.slug,
-            title: page.title,
-        })),
-    };
+    return componentInfo;
 }
 //# sourceMappingURL=get-component-info.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-component-info.js","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiB,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAMjE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,qMAAqM;IAClN,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,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAChE,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO;YACL,KAAK,EAAE,mFAAmF;SAC3F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAExD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,cAAc,aAAa,6EAA6E;SAChH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,aAAa;QAChB,kBAAkB,EAAE,sBAAsB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClF,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-component-info.js","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiB,MAAM,cAAc,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,qMAAqM;IAClN,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,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAChE,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO;YACL,KAAK,EAAE,mFAAmF;SAC3F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAExD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,cAAc,aAAa,6EAA6E;SAChH,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maltjoy/mcp-server",
-  "version": "0.5.0-beta.0",
+  "version": "0.6.0-beta.0",
   "description": "MCP server for Joy Design System - exposes Vue3 components information",
   "type": "module",
   "main": "dist/index.js",
@@ -23,18 +23,16 @@
     "@modelcontextprotocol/sdk": "1.25.2"
   },
   "devDependencies": {
-    "@modelcontextprotocol/inspector": "0.22.0",
     "@types/node": "24.12.0",
     "tsx": "^4.21.0",
     "typescript": "5.3.3",
     "vue-component-meta": "3.1.5"
   },
   "scripts": {
-    "build": "tsc && npm run generate:components-docs:json && npm run generate:zeroheight-docs",
+    "build": "tsc && npm run generate:components-docs:json",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "generate:components-docs:json": "tsx src/json-metadata-generator.mjs",
-    "generate:zeroheight-docs": "node src/zeroheight-metadata-generator.mjs",
-    "inspector": "mcp-inspector node ./dist/index.js"
+    "inspector": "pnpx @modelcontextprotocol/inspector node ./dist/index.js"
   }
 }