@wordpress/design-system-mcp 0.1.2-next.v.202604201441.0

package/build-types/parse-components.d.ts

@@ -0,0 +1,55 @@
+import type { Component, ComponentDetail, ComponentProp, ManifestComponent } from './types';
+/**
+ * Derive the npm package name from the story file path.
+ *
+ * Manifest paths look like `../packages/<dir>/src/.../index.story.tsx`. We
+ * extract `<dir>` and prepend the `@wordpress/` npm namespace. Curation of
+ * which components appear in the manifest is handled upstream via Storybook
+ * tags, so this only needs to recognize package-shaped paths.
+ *
+ * @param storyPath - The story file path from the manifest.
+ * @return The npm package name, or null for paths outside `packages/*`.
+ */
+export declare function packageNameFromPath(storyPath: string): string | null;
+/**
+ * Parse props from a component's reactDocgen data, filtering out
+ * deprecated and ignored props.
+ *
+ * @param rawProps - The reactDocgen props record.
+ * @return Parsed props with deprecated entries removed.
+ */
+export declare function parseProps(rawProps: Record<string, {
+    required?: boolean;
+    tsType?: {
+        name: string;
+        raw?: string;
+    };
+    description?: string;
+    defaultValue?: {
+        value: string;
+    };
+}>): ComponentProp[];
+/**
+ * Parse manifest components into a flat list sorted alphabetically by name.
+ * When a component is defined across multiple story files (e.g. a companion
+ * file documenting a specific aspect), it is collapsed to a single entry keyed
+ * by its canonical name and package.
+ *
+ * @param components - The manifest components record.
+ * @return Flat list of components derived from the manifest.
+ */
+export declare function parseComponents(components: Record<string, ManifestComponent>): Component[];
+/**
+ * Find a single component by name (case-insensitive) and return its full
+ * detail including props and stories. When a component is spread across
+ * multiple story files, stories from every contributing file are collected
+ * in manifest order. Descriptions and props are also authored on the component
+ * itself, so in principle they should be identical across story files; in
+ * practice one file may omit them, so we prefer any non-empty value found.
+ *
+ * @param components - The manifest components record.
+ * @param name       - The component name to look up.
+ * @return The component detail, or null if not found.
+ */
+export declare function parseComponentDetail(components: Record<string, ManifestComponent>, name: string): ComponentDetail | null;
+//# sourceMappingURL=parse-components.d.ts.map

package/build-types/parse-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-components.d.ts","sourceRoot":"","sources":["../src/parse-components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,MAAM,SAAS,CAAC;AAuCjB;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAE,SAAS,EAAE,MAAM,GAAI,MAAM,GAAG,IAAI,CAGtE;AAiBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,MAAM,CACf,MAAM,EACN;IACC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CACD,GACC,aAAa,EAAE,CAmBjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,MAAM,CAAE,MAAM,EAAE,iBAAiB,CAAE,GAC7C,SAAS,EAAE,CA0Bb;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,CAAE,MAAM,EAAE,iBAAiB,CAAE,EAC/C,IAAI,EAAE,MAAM,GACV,eAAe,GAAG,IAAI,CAqCxB"}

package/build-types/test/data.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data.d.ts.map

package/build-types/test/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/test/data.ts"],"names":[],"mappings":""}

package/build-types/test/format.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.d.ts.map

package/build-types/test/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/test/format.ts"],"names":[],"mappings":""}

package/build-types/test/parse-components.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parse-components.d.ts.map

package/build-types/test/parse-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-components.d.ts","sourceRoot":"","sources":["../../src/test/parse-components.ts"],"names":[],"mappings":""}

package/build-types/tools/get-component-details.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+/**
+ * Register the get_component_details tool.
+ *
+ * @param server - The MCP server instance.
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-component-details.d.ts.map

package/build-types/tools/get-component-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAK9D;;;;GAIG;AACH,wBAAgB,QAAQ,CAAE,MAAM,EAAE,SAAS,GAAI,IAAI,CAwClD"}

package/build-types/tools/get-components.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+/**
+ * Register the get_components tool.
+ *
+ * @param server - The MCP server instance.
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-components.d.ts.map

package/build-types/tools/get-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-components.d.ts","sourceRoot":"","sources":["../../src/tools/get-components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D;;;;GAIG;AACH,wBAAgB,QAAQ,CAAE,MAAM,EAAE,SAAS,GAAI,IAAI,CAuBlD"}

package/build-types/tools/get-design-tokens.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+/**
+ * Register the get_design_tokens tool.
+ *
+ * @param server - The MCP server instance.
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=get-design-tokens.d.ts.map

package/build-types/tools/get-design-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-design-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/get-design-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D;;;;GAIG;AACH,wBAAgB,QAAQ,CAAE,MAAM,EAAE,SAAS,GAAI,IAAI,CAuBlD"}

package/build-types/tools/index.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+/**
+ * Register all MCP tools on the server.
+ *
+ * @param server - The MCP server instance.
+ */
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/build-types/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAK9D;;;;GAIG;AACH,wBAAgB,aAAa,CAAE,MAAM,EAAE,SAAS,GAAI,IAAI,CAIvD"}

package/build-types/types.d.ts

@@ -0,0 +1,51 @@
+export interface ManifestComponent {
+    id: string;
+    name: string;
+    path: string;
+    description?: string;
+    stories?: Array<{
+        name: string;
+        snippet?: string;
+        description?: string;
+    }>;
+    reactDocgen?: {
+        description?: string;
+        displayName?: string;
+        props?: Record<string, {
+            required?: boolean;
+            tsType?: {
+                name: string;
+                raw?: string;
+            };
+            description?: string;
+            defaultValue?: {
+                value: string;
+            };
+        }>;
+    };
+}
+export interface Component {
+    name: string;
+    description: string;
+    packageName: string;
+}
+export interface ComponentProp {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    defaultValue: string | null;
+}
+export interface ComponentDetail {
+    name: string;
+    description: string;
+    packageName: string;
+    importStatement: string | null;
+    props: ComponentProp[];
+    stories: Array<{
+        name: string;
+        snippet?: string;
+        description?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build-types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAE,CAAC;IACJ,WAAW,CAAC,EAAE;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CACb,MAAM,EACN;YACC,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,MAAM,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,GAAG,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YACxC,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,YAAY,CAAC,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC;SACjC,CACD,CAAC;KACF,CAAC;CACF;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,KAAK,CAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAE,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@wordpress/design-system-mcp",
+	"version": "0.1.2-next.v.202604201441.0+dab6d8c07",
+	"description": "MCP server for the WordPress Design System.",
+	"author": "The WordPress Contributors",
+	"license": "GPL-2.0-or-later",
+	"keywords": [
+		"wordpress",
+		"gutenberg",
+		"design-system",
+		"mcp"
+	],
+	"homepage": "https://github.com/WordPress/gutenberg/tree/HEAD/packages/design-system-mcp/README.md",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/WordPress/gutenberg.git",
+		"directory": "packages/design-system-mcp"
+	},
+	"bugs": {
+		"url": "https://github.com/WordPress/gutenberg/issues"
+	},
+	"engines": {
+		"node": ">=20.10.0",
+		"npm": ">=10.2.3"
+	},
+	"files": [
+		"bin",
+		"build-module",
+		"build-types"
+	],
+	"type": "module",
+	"module": "build-module/index.mjs",
+	"exports": {
+		".": {
+			"types": "./build-types/index.d.ts",
+			"import": "./build-module/index.mjs"
+		},
+		"./package.json": "./package.json"
+	},
+	"bin": {
+		"design-system-mcp": "./bin/design-system-mcp.mjs"
+	},
+	"dependencies": {
+		"@cfworker/json-schema": "4.1.1",
+		"@modelcontextprotocol/server": "2.0.0-alpha.2",
+		"zod": "4.3.6"
+	},
+	"devDependencies": {
+		"@types/jest": "^29.5.14"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"gitHead": "c788005ba4ee2a34851c1217c51602656aa7c3a6"
+}