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

package/dist/doc/VJoyWalkthroughTrigger/guideline.md

@@ -0,0 +1,171 @@
+---
+component: VJoyWalkthroughTrigger
+status: draft
+language: en
+dsds: JoyWalkthroughTrigger.dsds.json
+dsdsVersion: "0.15.2"
+---
+
+# Walkthrough trigger
+
+Use **`VJoyWalkthroughTrigger`** as the **collapsed-state pill button** for a Joy walkthrough — a fixed, dark floating control with optional icon, title, subtitle, and chevron.
+
+In product code, **prefer `VJoyWalkthrough`** and its `triggerTitle`, `triggerSubtitle`, and `triggerIcon` props; the parent renders this trigger when the modal is closed. Mount the trigger directly only when you need the chrome without the full walkthrough shell.
+
+| | |
+| --- | --- |
+| **Code** | `VJoyWalkthroughTrigger` from `@maltjoy/core-vue` |
+| **Design** | [ZeroHeight — Walkthrough](https://zeroheight.com/6bf479565/p/6305853-walkthrough) |
+| **Storybook** | [VJoyWalkthrough docs](https://doc.malt.tech/joy-storybook/?path=/docs/components-overlays-vjoywalkthrough--docs) (subcomponent) |
+| **DSDS (machine)** | [`JoyWalkthroughTrigger.dsds.json`](./JoyWalkthroughTrigger.dsds.json) |
+| **Live API** | `joy_get_component_info("VJoyWalkthroughTrigger")` |
+
+---
+
+## When to use this component
+
+Use this trigger when a walkthrough is **collapsed** and the user needs a persistent entry point — typically “Get started”, onboarding progress, or a resume CTA fixed to the viewport corner.
+
+The button shows an optional leading icon, a **title** (primary line), an optional **subtitle** (secondary line, separated by a vertical rule), and a chevron that reflects open/closed state. Ripple feedback is built in (`v-joy-ripple`).
+
+### When not to use this component
+
+| Need | Use instead |
+| --- | --- |
+| Full collapsible walkthrough with modal, slots, and footer | `VJoyWalkthrough` (renders this trigger automatically when closed) |
+| Spotlight tour anchored to page elements | `VJoyProductTour` |
+| Generic page action or navigation | `VJoyButton` or `VJoyLink` |
+| Short contextual hint on hover | `VJoyTooltip` |
+| Custom floating pill with ad-hoc CSS | Still use `VJoyWalkthroughTrigger` or `VJoyWalkthrough` + Joy tokens |
+
+> **Composition:** pass extra HTML attributes (for example `data-testid`, `aria-label`) through `triggerAttrs` on `VJoyWalkthrough`, or `v-bind="$attrs"` when using the trigger standalone.
+
+---
+
+## How it works
+
+### Anatomy
+
+| Part | Required? | What it is |
+| --- | --- | --- |
+| Root button | Yes | Native `<button type="button">` — `.joy-walkthrough-trigger` |
+| Leading icon | No | `VJoyIcon` when `icon` is set (`color="white"`) |
+| Content row | No* | `.joy-walkthrough-trigger__content` — `title` and/or `subtitle` spans |
+| Title | No | Primary label (`title` prop) |
+| Subtitle | No | Secondary label (`subtitle` prop); vertical divider when both title and subtitle are present |
+| Chevron | Yes | `VJoyIcon` — `chevron-up` when collapsed, `chevron-down` when `open` is true |
+| Ripple | Yes | `v-joy-ripple` on the button |
+
+\*At least one of `title`, `subtitle`, or `icon` should be provided so the control is recognizable.
+
+### Default values
+
+- `open` has **no default** in types — internal state starts from the prop when set; otherwise collapsed (`chevron-up`)
+- `icon`, `title`, and `subtitle` are all **optional**
+
+Props and exposed members: use Joy MCP or Storybook — this page focuses on **when** and **how**, not a full API dump.
+
+### Parent integration
+
+`VJoyWalkthrough` shows `VJoyWalkthroughTrigger` only while the modal is closed, forwards `triggerTitle` → `title`, `triggerSubtitle` → `subtitle`, `triggerIcon` → `icon`, merges `triggerAttrs` onto the button, and handles `@click` to open the modal. Positioning and mobile compaction (fixed bottom-left, shorter height, title hidden on narrow viewports) come from `JoyWalkthrough.scss` on the parent — not from props on the trigger.
+
+Standalone usage toggles internal `open` on click (chevron only); wire your own handler with `@click` if the button should open custom content.
+
+---
+
+## Best practices
+
+Rules use RFC 2119 strength (**MUST** / **SHOULD** / **MUST NOT** / **SHOULD NOT**).
+
+### Selection
+
+- **SHOULD** use **`VJoyWalkthrough`** instead of mounting `VJoyWalkthroughTrigger` alone when the goal is onboarding or guided help with expandable content.
+- **SHOULD** provide at least **`title`** or **`icon`** so the pill has a clear purpose at a glance.
+- **SHOULD** use **`subtitle`** for progress or status (for example `80% completed`) — omit it when there is no secondary line to show.
+- **MUST NOT** use this trigger for primary form submission or destructive actions.
+
+### Implementation
+
+- **MUST** use only documented props from MCP or `VJoyWalkthroughTrigger.vue` (`icon`, `title`, `subtitle`, `open`).
+- **MUST** use Joy tokens — no custom `.joy-walkthrough-trigger` background, radius, height, or typography overrides.
+- **MUST NOT** invent props (`variant`, `size`, `color`, `placement`, …).
+- **MUST NOT** add slots — the component has none.
+- **SHOULD** pass test and a11y attributes via **`triggerAttrs`** on `VJoyWalkthrough` or fallthrough attrs on a standalone trigger.
+- **SHOULD** use valid Joy icon names for `icon` (see `TJoyIconsNames` / MCP).
+
+### Do / don’t
+
+| Do | Don’t |
+| --- | --- |
+| `VJoyWalkthrough` + `triggerTitle` / `triggerSubtitle` / `triggerIcon` | Rebuild the dark pill with `VJoyButton` + custom CSS |
+| `subtitle` for progress when using `walkthrough-progress` | Duplicate progress in title and subtitle |
+| `triggerAttrs` for `data-testid` or `aria-label` | Hardcode `64px` height or neutral-60 background in apps |
+| `VJoyProductTour` for element-highlight tours | `VJoyWalkthroughTrigger` as a page spotlight |
+
+---
+
+## Accessibility
+
+Behaviors (what must happen), not slogans.
+
+| Behavior | Expectation |
+| --- | --- |
+| Role | Native `button` (`type="button"`) |
+| Name | Visible **`title`** and/or **`subtitle`** should carry the accessible name; if neither is sufficient alone, set **`aria-label`** via `triggerAttrs` or fallthrough attrs |
+| Keyboard | **Enter** / **Space** activate the button when focused |
+| Focus | Visible focus ring — `2px solid var(--joy-color-neutral-0)` with negative outline offset; do not remove in product CSS |
+| Chevron / icon | Decorative when title or subtitle already names the control; supplement with `aria-label` if the trigger is icon-only |
+| Mobile | Parent walkthrough layout may hide the title on narrow viewports — ensure **`subtitle`** or **`aria-label`** still conveys purpose |
+
+Target: **WCAG 2.2 AA** where the product requires it.
+
+---
+
+## Examples
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { VJoyWalkthrough, VJoyWalkthroughTrigger } from '@maltjoy/core-vue'
+
+const showPanel = ref(false)
+</script>
+
+<template>
+  <!-- Preferred: parent owns trigger + modal -->
+  <VJoyWalkthrough
+    trigger-icon="list"
+    trigger-title="Get started"
+    trigger-subtitle="80% completed"
+    footer="Close and don't show again"
+    :trigger-attrs="{ 'data-testid': 'onboarding-trigger' }"
+  >
+    <template #walkthrough-title>Welcome to your dashboard</template>
+    <template #walkthrough-content>Step-by-step guidance goes here.</template>
+  </VJoyWalkthrough>
+
+  <!-- Standalone trigger (uncommon — you handle open state) -->
+  <VJoyWalkthroughTrigger
+    icon="list"
+    title="Get started"
+    subtitle="3 steps left"
+    aria-label="Resume onboarding walkthrough"
+    @click="showPanel = true"
+  />
+</template>
+```
+
+In Nuxt (or apps with auto-import), omit the import if `VJoyWalkthroughTrigger` is already global.
+
+---
+
+## Related
+
+| Component | Use when |
+| --- | --- |
+| `VJoyWalkthrough` | Full collapsible walkthrough — modal, slots, footer, teleport |
+| `VJoyProductTour` | Multi-step tour with element spotlighting |
+| `VJoyProductTourTrigger` | Trigger pattern for product tours |
+| `VJoyIcon` | Icons passed to the `icon` prop |
+| `VJoyProgressBar` | Progress slot content inside `VJoyWalkthrough` |
+| `VJoyButton` | Standard actions unrelated to walkthrough chrome |

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,21 +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-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-400",
-    ".joy-font-secondary-600",
-    ".joy-font-secondary-800"
+    ".joy-font-size-secondary-800"
   ],
   "elevation": [
     ".joy-core-elevation-0",

package/dist/doc/design-tokens.json

@@ -120,6 +120,7 @@
   "zIndex": {
     "--joy-core-z-index-fixed-content": "20",
     "--joy-core-z-index-dropdown": "23",
+    "--joy-core-z-index-funnel": "1040",
     "--joy-core-z-index-backdrop": "1050",
     "--joy-core-z-index-product-tour": "1060",
     "--joy-core-z-index-walkthrough": "1070",

package/dist/doc/index.json

@@ -1,12 +1,12 @@
 {
-  "generated": "2026-04-16T12:48:46.193Z",
-  "version": "0.4.0",
+  "generated": "2026-07-22T09:35:12.292Z",
+  "version": "0.6.0-beta.0",
   "statistics": {
-    "totalComponents": 83,
-    "totalProps": 484,
-    "totalEvents": 67,
+    "totalComponents": 82,
+    "totalProps": 473,
+    "totalEvents": 66,
     "totalSlots": 148,
-    "componentsWithVModel": 23,
+    "componentsWithVModel": 22,
     "componentsWithErrors": 0,
     "componentsWithPartialErrors": 1
   },
@@ -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,12 +253,12 @@
     },
     {
       "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 drag states, error handling, and flexible content slots for file information and actions.\n\nThe dropzone required as `v-model` an array containing objects with at least the \"name\" property.",
+      "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": 11,
+      "propsCount": 14,
       "eventsCount": 0,
-      "slotsCount": 4,
+      "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
@@ -428,7 +428,7 @@
       "path": "VJoyInputNumber/metadata.json",
       "propsCount": 17,
       "eventsCount": 1,
-      "slotsCount": 0,
+      "slotsCount": 1,
       "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,
@@ -753,7 +743,7 @@
     },
     {
       "name": "VJoyText",
-      "description": "This component is directly dependant from `@maltjoy/css` package, a CSS class utils package built on top of `@maltjoy/themes` that contains our design tokens.\n\n**Reminder**: values ending with 50 have same size but are bold.\n\nSee \"Fonts\" section here https://doc.malt.tech/joy-storybook/?path=/docs/css-framework--docs#advanced-fonts\n\n**Warning** If you use long text within a VJoyWrapper, you'll have to set a max-width to prevent the text from breaking the layout.",
+      "description": "This component uses CSS utility classes from `@maltjoy/themes` (`dist/default.css`).\n\n**Reminder**: values ending with 50 have same size but are bold.\n\nSee \"Fonts\" section here https://doc.malt.tech/joy-storybook/?path=/docs/css-framework--docs#advanced-fonts\n\n**Warning** If you use long text within a VJoyWrapper, you'll have to set a max-width to prevent the text from breaking the layout.",
       "category": "View",
       "path": "VJoyText/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,6 +7,7 @@ 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';
@@ -21,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: {},
@@ -34,7 +35,14 @@ class JoyMcpServer {
         // List available tools
         this.server.setRequestHandler(ListToolsRequestSchema, async () => {
             return {
-                tools: [listComponentsTool, getComponentInfoTool, getComponentTypesTool, listDesignTokensTool, listCssClassesTool],
+                tools: [
+                    listComponentsTool,
+                    getComponentInfoTool,
+                    getComponentGuidelineTool,
+                    getComponentTypesTool,
+                    listDesignTokensTool,
+                    listCssClassesTool,
+                ],
             };
         });
         // Handle tool calls
@@ -77,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 {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEhG,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,YAAY;IACR,MAAM,CAAS;IAEvB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB;YACE,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,OAAO;SACjB,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;aACV;SACF,CACF,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAEO,aAAa;QACnB,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YAC/D,OAAO;gBACL,KAAK,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;aACnH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAEjD,IAAI,CAAC;gBACH,QAAQ,IAAI,EAAE,CAAC;oBACb,KAAK,qBAAqB,CAAC,CAAC,CAAC;wBAC3B,MAAM,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAC;wBAC5C,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iCACtC;6BACF;yBACF,CAAC;oBACJ,CAAC;oBAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;wBAC9B,MAAM,aAAa,GAAG,IAAI,EAAE,aAAuB,CAAC;wBACpD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;wBAC3D,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iCACtC;6BACF;yBACF,CAAC;oBACJ,CAAC;oBAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;wBAC/B,MAAM,aAAa,GAAG,IAAI,EAAE,aAAuB,CAAC;wBACpD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,aAAa,CAAC,CAAC;wBAC5D,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iCACtC;6BACF;yBACF,CAAC;oBACJ,CAAC;oBAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;wBAC9B,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;wBACxC,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iCACtC;6BACF;yBACF,CAAC;oBACJ,CAAC;oBAED,KAAK,sBAAsB,CAAC,CAAC,CAAC;wBAC5B,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;wBACtC,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iCACtC;6BACF;yBACF,CAAC;oBACJ,CAAC;oBAED;wBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,UAAU,YAAY,EAAE;yBAC/B;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,kBAAkB;QACxB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;CACF;AAED;;GAEG;AACH,SAAS,mBAAmB;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAE/D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uCAAuC;AACvC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,mBAAmB;AACnB,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;AAClC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"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"}