polymorph-ui-components-mcp 0.0.1

package/build/docs/Tooltip.md

@@ -0,0 +1,86 @@
+# Tooltip
+
+A floating tooltip that appears on hover or focus of a trigger element. The tooltip displays informational text positioned relative to its trigger (top, bottom, left, or right). Supports a configurable show delay and is fully themeable via CSS custom properties. The tooltip includes a directional arrow pointing toward the trigger element.
+
+## Usage
+
+```svelte
+<script>
+  import { Tooltip } from 'polymorph-ui-components';
+</script>
+
+<Tooltip text="This is helpful info" position="top">
+  <button>Hover me</button>
+</Tooltip>
+```
+
+## Props
+
+| Prop     | Type                                                       | Required | Default | Description                                                                                                                                                            |
+| -------- | ---------------------------------------------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| text     | `string`                                                   | Yes      | -       | The text content displayed inside the tooltip bubble.                                                                                                                  |
+| position | `TooltipPosition = 'top' \| 'bottom' \| 'left' \| 'right'` | No       | `'top'` | Where the tooltip bubble appears relative to the trigger element.                                                                                                      |
+| delay    | `number`                                                   | No       | `0`     | Time in milliseconds to wait before showing the tooltip after hover/focus. A value of 0 shows the tooltip immediately.                                                 |
+| testId   | `string \| null`                                           | No       | `-`     | Value for data-pw on the tooltip container element for Playwright testing.                                                                                             |
+| classes  | `string`                                                   | No       | `-`     | CSS class string applied to the component's top-level element. Useful for theming — define classes with CSS variable overrides and pass them to create variant styles. |
+
+## Snippets
+
+Svelte 5 Snippet props — pass content blocks to the component.
+
+| Snippet  | Type      | Description                                                                                                |
+| -------- | --------- | ---------------------------------------------------------------------------------------------------------- |
+| children | `Snippet` | The trigger element(s) that the tooltip wraps. The tooltip appears when hovering or focusing this content. |
+
+## Events
+
+This component does not emit any events.
+
+## CSS Variables
+
+Override these custom properties to theme the component.
+
+| Variable                      | Default                              | CSS Property        | Description                                                                 |
+| ----------------------------- | ------------------------------------ | ------------------- | --------------------------------------------------------------------------- |
+| `--tooltip-container-display` | `inline-flex`                        | display             | Display mode of the wrapper element around the trigger and tooltip.         |
+| `--tooltip-z-index`           | `1000`                               | z-index             | Stacking order of the tooltip bubble.                                       |
+| `--tooltip-max-width`         | `200px`                              | max-width           | Maximum width of the tooltip bubble before text wraps.                      |
+| `--tooltip-background`        | `#18181b`                            | background          | Background color of the tooltip bubble.                                     |
+| `--tooltip-color`             | `#ffffff`                            | color               | Text color inside the tooltip bubble.                                       |
+| `--tooltip-font-size`         | `12px`                               | font-size           | Font size of the tooltip text.                                              |
+| `--tooltip-font-weight`       | `400`                                | font-weight         | Font weight of the tooltip text.                                            |
+| `--tooltip-font-family`       | `-`                                  | font-family         | Font family of the tooltip text.                                            |
+| `--tooltip-padding`           | `6px 10px`                           | padding             | Inner padding of the tooltip bubble.                                        |
+| `--tooltip-border-radius`     | `8px`                                | border-radius       | Corner rounding of the tooltip bubble.                                      |
+| `--tooltip-border`            | `none`                               | border              | Border of the tooltip bubble.                                               |
+| `--tooltip-box-shadow`        | `0 2px 6px rgba(0, 0, 0, 0.15)`      | box-shadow          | Shadow effect around the tooltip bubble.                                    |
+| `--tooltip-opacity-duration`  | `0.15s`                              | transition duration | Duration of the tooltip opacity fade transition.                            |
+| `--tooltip-offset`            | `8px`                                | calc offset         | Distance between the tooltip bubble and the trigger element.                |
+| `--tooltip-arrow-size`        | `5px`                                | border-width        | Size of the directional arrow pointing from the tooltip toward the trigger. |
+| `--tooltip-arrow-color`       | `var(--tooltip-background, #18181b)` | border-color        | Color of the directional arrow. Defaults to match the tooltip background.   |
+
+## Type Reference
+
+Custom types used by this component's props and events:
+
+### TooltipPosition
+
+```typescript
+type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+```
+
+## Web Component
+
+Tag: `<pui-tooltip>`
+
+```html
+<pui-tooltip text="More info" position="top">
+  <button>Hover me</button>
+</pui-tooltip>
+```
+
+### Slots
+
+| Slot Name   | Maps to Snippet | Description                                          |
+| ----------- | --------------- | ---------------------------------------------------- |
+| _(default)_ | `children`      | The trigger element that shows the tooltip on hover. |

package/build/docs/_index.json

@@ -0,0 +1,218 @@
+[
+  {
+    "name": "Accordion",
+    "description": "An expandable/collapsible container that uses CSS grid row animation for smooth open/close transitions. When `expand` is true, the content is visible (grid-template-rows: 1fr); when false, it collapses to 0fr. Render children content using the default `children` snippet."
+  },
+  {
+    "name": "Avatar",
+    "description": "A circular user avatar that displays an image (via the Img component with fallback support) or text initials derived from `name`. Supports small/medium/large sizes and configurable border and colors via CSS variables. Becomes a button when `onclick` is provided."
+  },
+  {
+    "name": "Badge",
+    "description": "An icon with a numeric/text badge overlay positioned in the top-right corner. Displays an image with a small badge bubble containing the `value` text. Commonly used for notification counts on icons."
+  },
+  {
+    "name": "Banner",
+    "description": "A notification banner with optional icon snippet, text content, inline link text, right content slot, and a dismissible close button. Supports click interaction with keyboard accessibility. The `visible` prop is bindable for dismiss state control. Uses slide transition for show/hide."
+  },
+  {
+    "name": "Book",
+    "description": "A 3D book display component with animated page turning. Renders multiple pages with content snippets and supports swipe/click navigation. Includes page indicator dots and configurable perspective and rotation."
+  },
+  {
+    "name": "Browser",
+    "description": "A browser window chrome frame with address bar, navigation buttons, and a content area. Renders any content inside a browser-like UI frame. Useful for documentation, screenshots, and preview displays."
+  },
+  {
+    "name": "Button",
+    "description": "An action button that supports two loader modes (circular spinner or progress bar), HTML text content, icon and children snippets, aria-expanded for dropdown triggers, and a disabled state. The progress bar mode prevents clicks during animation."
+  },
+  {
+    "name": "Calendar",
+    "description": "A date picker with single-date and date-range selection modes. Supports month/year navigation, locale-aware day and month names, min/max date constraints, disabled dates, and keyboard navigation. Range mode shows visual start/end pills with highlighted in-between days."
+  },
+  {
+    "name": "Carousel",
+    "description": "An auto-playing slideshow that renders Svelte components as slides. Supports touch swipe and mouse drag for navigation. Shows optional dot indicators below the slides for direct navigation."
+  },
+  {
+    "name": "Checkbox",
+    "description": "A styled checkbox input with a custom SVG checkmark. Supports checked state binding, disabled state, and configurable size and colors via CSS variables."
+  },
+  {
+    "name": "ColorPicker",
+    "description": "A color selection component with a custom popover containing a saturation/brightness panel, hue slider, and editable HEX/RGB/HSL input fields. The trigger shows a color swatch with an optional hex text input. Uses Button, Input, and Slider components internally."
+  },
+  {
+    "name": "Combobox",
+    "description": "A text input with a filtered dropdown list implementing the WAI-ARIA combobox pattern. Supports keyboard navigation, disabled items, custom item rendering, and bindable value/inputValue/open state. Use for autocomplete, search suggestions, and typeahead inputs."
+  },
+  {
+    "name": "CheckListItem",
+    "description": "A list row pairing a Checkbox with a plain-text label. Toggling the checkbox updates the bindable `checked` state and fires `onclick` with the new boolean value. Supports a custom `checkboxLabel` snippet and a disabled state."
+  },
+  {
+    "name": "Choicebox",
+    "description": "A single selectable option box with radio-style or checkbox-style behavior set via the `mode` prop. Renders a `children` snippet for its content, toggles a bindable `selected` state on click/keyboard, and supports a disabled state."
+  },
+  {
+    "name": "CommandMenu",
+    "description": "A command palette overlay (Ctrl+K / Cmd+K) with substring search filtering, optional command groups with headings, and keyboard navigation. Supports per-item icons, shortcut display, and a custom empty state."
+  },
+  {
+    "name": "ContextMenu",
+    "description": "A right-click context menu with a flat list of items supporting separators, disabled items, danger styling, optional icons, and shortcut labels. Has keyboard navigation, positions itself at the click point, and adjusts to stay within the viewport."
+  },
+  {
+    "name": "Gauge",
+    "description": "A full-circle ring gauge that displays a `value` clamped to 0-100 as a single SVG arc. Has an animated stroke-dashoffset transition and an optional centered percentage label. Uses SVG stroke-dasharray for the arc rendering."
+  },
+  {
+    "name": "GridItem",
+    "description": "A square grid cell with a header icon (top-right), centered main icon, and text label below. Clicking toggles a loading overlay animation (clip-path radial sweep). The `showLoader` state is bindable."
+  },
+  {
+    "name": "Icon",
+    "description": "A clickable icon component that displays an image with an optional text label below. The entire container is a button for accessibility."
+  },
+  {
+    "name": "IconStack",
+    "description": "A horizontal stack of circular icons/avatars with negative margin layering (each icon overlaps the previous one). Each item can be either an `image` (renders an img) or `text` (renders a text span). Icons are z-indexed so the first icon appears on top."
+  },
+  {
+    "name": "Img",
+    "description": "An image component with automatic fallback. If the primary `src` fails to load (onerror), it switches to the `fallback` URL. The fallback only triggers once (won't loop if fallback also fails). Supports hover styling."
+  },
+  {
+    "name": "Input",
+    "description": "A text input field with built-in validation for email, phone, password, and text patterns. Validates automatically using RegExp props plus optional custom validator functions. Supports text transformers and view presentation formatting. Can render as a textarea."
+  },
+  {
+    "name": "InputButton",
+    "description": "A composite component that combines an Input field with optional left, right, and bottom Button components. The right and bottom buttons are automatically disabled until the input validation state becomes Valid."
+  },
+  {
+    "name": "KeyboardInput",
+    "description": "A keyboard shortcut display component that renders key combinations in styled key caps, mapping common keys (cmd, ctrl, shift, arrows, etc.) to symbols. Accepts a key array or a separator-delimited string. Optionally clickable with keyboard accessibility."
+  },
+  {
+    "name": "ListItem",
+    "description": "A multi-section list row with left image (with fallback), center label (supports HTML), right image, and optional text on the right. Supports an accordion-expandable bottom section and per-section click handlers."
+  },
+  {
+    "name": "Loader",
+    "description": "A rotating circular spinner with a gradient foreground that transitions from `--loader-foreground` to `--loader-foreground-end`. The center is cut out to create a ring/donut shape. Spins continuously with a 1.4s linear animation."
+  },
+  {
+    "name": "LoadingDots",
+    "description": "Animated dot sequence for inline loading indication. Renders a configurable number of dots (default 3) that animate in a staggered sequence using either a bounce or pulse animation. Size and duration are controlled via CSS variables."
+  },
+  {
+    "name": "Menu",
+    "description": "A dropdown action menu with full keyboard navigation (ArrowUp/Down, Enter/Space, Escape, Home/End), typeahead search, click-outside dismiss, separator lines, danger-styled items, disabled items, optional icons, and configurable position. Focus is managed automatically."
+  },
+  {
+    "name": "Modal",
+    "description": "A dialog overlay component that renders on top of the page with configurable size, alignment, header, footer, and transition animations. Locks body scroll and optionally handles hardware back-press navigation. Supports click-to-dismiss and Escape key."
+  },
+  {
+    "name": "ModalAnimation",
+    "description": "A wrapper that applies fly or fade Svelte transitions to its children based on the modal's `align` prop. For top alignment, content flies in from above; for bottom, from below; for center, a fade transition is used."
+  },
+  {
+    "name": "OverlayAnimation",
+    "description": "A wrapper that applies a fade-out transition (350ms) to its children when they are removed from the DOM. Used internally by Modal to animate the overlay background."
+  },
+  {
+    "name": "Pagination",
+    "description": "A page navigation component with previous/next buttons and numbered page links. Supports configurable visible page range with ellipsis for large page counts, disabled states, and custom arrow snippets."
+  },
+  {
+    "name": "Phone",
+    "description": "A smartphone device frame that renders content inside a realistic phone shell with a notch, status bar, and home indicator. Useful for documentation, app previews, and marketing displays."
+  },
+  {
+    "name": "Pill",
+    "description": "A compact label/tag element for displaying status, categories, or metadata. Supports an optional icon snippet and click interaction with keyboard accessibility (role=button, Enter/Space). Optionally clickable when onclick is provided."
+  },
+  {
+    "name": "Progress",
+    "description": "A horizontal progress bar that fills from left to right based on `value` relative to `max`, with an animated width transition. Supports an optional percentage label and an indeterminate sweeping animation when `value` is negative. Styling is configurable via CSS variables."
+  },
+  {
+    "name": "Radio",
+    "description": "A styled radio button input with a custom circular indicator. Supports checked state binding, disabled state, and configurable size and colors via CSS variables."
+  },
+  {
+    "name": "RelativeTime",
+    "description": "Displays a human-readable relative time string (e.g., '5 minutes ago') that auto-updates at a configurable interval. Uses Intl.RelativeTimeFormat for locale-aware formatting. Renders a semantic <time> element. Optionally wraps in a Tooltip showing the full date."
+  },
+  {
+    "name": "Scroller",
+    "description": "Overflowing horizontal or vertical item list with scroll controls. Shows navigation arrows when content overflows, with gradient fade edges. Supports drag-to-scroll, snap-to-item, touch device detection, and scroll position tracking."
+  },
+  {
+    "name": "Select",
+    "description": "A dropdown selector supporting single-select and multi-select modes, each with optional searchable filtering. In multi-select mode chosen items appear as dismissible Pills in the trigger (Backspace removes the last). Has full keyboard navigation and closes on outside click."
+  },
+  {
+    "name": "Sheet",
+    "description": "A panel that slides in from any edge of the screen (left, right, top, or bottom). Includes a structured layout with header, scrollable content, and optional footer. Body scroll locks while open, focus is trapped, and Escape key dismisses. The open prop is bindable."
+  },
+  {
+    "name": "Shimmer",
+    "description": "A loading placeholder with an animated shimmer/shine effect. Renders a rectangle with a sweeping highlight gradient. All visuals (size, shape, colors, speed) controlled entirely via CSS variables. Combine multiple instances to build skeleton layouts."
+  },
+  {
+    "name": "Slider",
+    "description": "A range slider with configurable min, max, and step values and a filled track. Supports an optional value display, a disabled state, and `oninput`/`onchange` callbacks. The value is bindable for two-way binding."
+  },
+  {
+    "name": "Snippet",
+    "description": "A copyable command-line code snippet with a prompt prefix and copy-to-clipboard button. Shows 'Copied!' feedback after copying. Supports custom copy icon snippet. Clipboard errors are silently handled for non-secure contexts."
+  },
+  {
+    "name": "SplitButton",
+    "description": "A primary action button paired with a dropdown arrow that opens a Menu component. The dropdown provides full keyboard navigation, typeahead, disabled/danger items, and separator support via the MenuItem API. Click the main button for the primary action or select from the dropdown for alternatives."
+  },
+  {
+    "name": "SplitInput",
+    "description": "A row of related input fields for segmented values like OTP/PIN codes, RGB/HSL color channels, IP addresses, or time inputs. Supports per-field configuration (dataType, min/max, validation), auto-advance focus, paste distribution, keyboard navigation, and optional separators between fields. Uses the Input component internally."
+  },
+  {
+    "name": "Step",
+    "description": "An individual step within a Stepper. Displays either a numbered circle or an icon image, a text label, and a dashed separator line. When clicked, fires the onclick event with the selected index."
+  },
+  {
+    "name": "Stepper",
+    "description": "A progress indicator showing numbered steps with completion and active states. Steps before currentStepIndex are completed (green), the active step is dark, and remaining steps are inactive (grey). Each step is clickable."
+  },
+  {
+    "name": "Table",
+    "description": "A sortable data table with clickable column headers for sort toggling (ascending/descending). Supports string, number, and boolean sorting. Enables vertical scrolling with sticky headers and per-cell content scrolling."
+  },
+  {
+    "name": "Tabs",
+    "description": "A horizontal tab bar with clickable tab items and an animated active indicator. Supports overflow scrolling with arrow buttons, custom tab content via a parameterized Snippet, and keyboard activation (Enter/Space). All visuals customizable via CSS variables."
+  },
+  {
+    "name": "ThemeSwitcher",
+    "description": "A segmented control for switching between light, dark, and system theme modes. Displays icons for each mode with an animated sliding indicator. Fires a callback with the selected theme value."
+  },
+  {
+    "name": "Toast",
+    "description": "An animated notification that slides in from a configurable direction, stays visible for a duration, then slides out. Unstyled by default — themed via CSS variables (--toast-background-color, --toast-color, etc.) or consumer-defined variant classes passed through `classes`. Has optional icons, subtext, and bottom content."
+  },
+  {
+    "name": "Toggle",
+    "description": "A labeled on/off switch with sliding ball animation. The `checked` prop controls the toggle state and the `onclick` event returns the new boolean state after toggling."
+  },
+  {
+    "name": "Toolbar",
+    "description": "A fixed-position header bar with a back button, center title, and customizable left/center/right content areas via Snippet slots. Supports an additional content row below the main toolbar."
+  },
+  {
+    "name": "Tooltip",
+    "description": "A hover-triggered tooltip that displays text content above, below, left, or right of its trigger element. Supports configurable position, delay, and styling via CSS variables."
+  }
+]

package/build/docs/templates/changelog.hbs

@@ -0,0 +1,36 @@
+{{#each releases}}
+  {{#if @first}}
+    # Changelog All notable changes to this project will be documented in this file. The format is
+    based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to
+    [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+  {{/if}}
+  {{#if href}}
+    ## [{{title}}]({{href}}){{#if tag}} - {{niceDate}}{{/if}}
+  {{else}}
+    ##
+    {{title}}{{#if tag}} - {{niceDate}}{{/if}}
+  {{/if}}
+
+  {{#if summary}}
+    {{summary}}
+
+  {{/if}}
+  {{#each sections}}
+    {{#if title}}
+      ###
+      {{title}}
+
+    {{/if}}
+    {{#each commits}}
+      {{#if breaking}}
+        - **BREAKING:**
+        {{subject}}{{#if href}} ([{{shorthash}}]({{href}})){{/if}}
+      {{else}}
+        -
+        {{subject}}{{#if href}} ([{{shorthash}}]({{href}})){{/if}}
+      {{/if}}
+    {{/each}}
+  {{/each}}
+
+{{/each}}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname$1 = dirname(__filename$1);
+class ComponentRegistry {
+    docsDir;
+    components = [];
+    docCache = new Map();
+    constructor(docsDir) {
+        this.docsDir = docsDir ?? join(__dirname$1, 'docs');
+    }
+    init() {
+        const indexPath = join(this.docsDir, '_index.json');
+        const raw = readFileSync(indexPath, 'utf-8');
+        this.components = JSON.parse(raw);
+    }
+    getComponentList() {
+        return this.components;
+    }
+    getComponentNames() {
+        return this.components.map((c) => c.name);
+    }
+    getComponentDocs(name) {
+        const lower = name.toLowerCase();
+        const cached = this.docCache.get(lower);
+        if (cached)
+            return cached;
+        const entry = this.components.find((c) => c.name.toLowerCase() === lower);
+        if (!entry)
+            return null;
+        try {
+            const mdPath = join(this.docsDir, `${entry.name}.md`);
+            const content = readFileSync(mdPath, 'utf-8');
+            this.docCache.set(lower, content);
+            return content;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+
+class SvelteUiComponentsServer {
+    server;
+    registry;
+    constructor() {
+        this.server = new McpServer({
+            name: "polymorph-ui-components",
+            version: "1.0.0",
+        });
+        this.registry = new ComponentRegistry();
+        this.registry.init();
+        this.registerTools();
+    }
+    registerTools() {
+        this.registerListComponents();
+        this.registerGetComponentDocs();
+    }
+    registerListComponents() {
+        this.server.registerTool("list_components", {
+            title: "List Components",
+            description: `Returns the list of all available components with brief descriptions.
+
+Use this to discover which components exist, then call
+get_component_docs to get the full documentation for any component.`,
+        }, async () => {
+            try {
+                const components = this.registry.getComponentList();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(components, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error listing components: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    registerGetComponentDocs() {
+        this.server.registerTool("get_component_docs", {
+            title: "Get Component Documentation",
+            description: `Returns the full markdown documentation for a component.
+
+Covers:
+- Usage example (import + template)
+- Props table (name, type, required, default)
+- Snippets (Svelte 5 Snippet props for passing content blocks)
+- Events (event handler props with callback signatures)
+- CSS Variables (custom properties to override for theming)`,
+            inputSchema: {
+                componentName: z
+                    .string()
+                    .describe('Component name from the list, e.g. "Button", "Input", "Modal"'),
+            },
+        }, async ({ componentName }) => {
+            try {
+                const docs = this.registry.getComponentDocs(componentName);
+                if (!docs) {
+                    const available = this.registry
+                        .getComponentNames()
+                        .join(", ");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Component "${componentName}" not found. Available: ${available}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: docs,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("polymorph-ui-components MCP server running on stdio");
+    }
+}
+const server = new SvelteUiComponentsServer();
+server.run().catch((error) => {
+    console.error("Fatal error starting server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/services/registry.ts","../src/index.ts"],"sourcesContent":[null,null],"names":["__filename","__dirname"],"mappings":"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"}

package/build/services/registry.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentEntry } from '../types';
+export declare class ComponentRegistry {
+    private docsDir;
+    private components;
+    private docCache;
+    constructor(docsDir?: string);
+    init(): void;
+    getComponentList(): ComponentEntry[];
+    getComponentNames(): string[];
+    getComponentDocs(name: string): string | null;
+}

package/build/types.d.ts

@@ -0,0 +1,4 @@
+export type ComponentEntry = {
+    name: string;
+    description: string;
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "polymorph-ui-components-mcp",
+  "version": "0.0.1",
+  "description": "MCP server for polymorph-ui-components - provides structured access to component props, CSS variables, and usage patterns",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "polymorph-ui-components-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "prebuild": "rm -rf build/docs && mkdir -p build && cp -r ../docs build/docs 2>/dev/null || true",
+    "build": "rollup -c && chmod +x build/index.js && rm -rf build/docs && cp -r ../docs build/docs",
+    "start": "node build/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^25.9.2",
+    "rollup": "^4.61.1",
+    "tslib": "^2.8.1",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "build"
+  ]
+}