@castandcrew/spotlight-mcp 0.1.0

package/dist/tools/search_tokens.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+export function registerSearchTokens(server) {
+    server.tool('search_tokens', 'Search Spotlight design tokens by name, description, or category.', {
+        query: z.string().describe('Semantic description, e.g. "large spacing", "positive color", "border radius"'),
+        category: z.string().optional().describe('Filter by category: "spacing", "color-semantic", "typography", etc.'),
+        limit: z.number().optional().default(10).describe('Max results to return (default 10)'),
+    }, async ({ query, category, limit }) => {
+        const index = loadIndex();
+        const tokens = category
+            ? index.tokens.filter(t => t.category.toLowerCase().includes(category.toLowerCase()))
+            : index.tokens;
+        const fuse = new Fuse(tokens, {
+            keys: ['name', 'useCase', 'description', 'category', 'variant', 'property'],
+            threshold: 0.4,
+            ignoreLocation: true,
+            includeScore: true,
+        });
+        const results = fuse.search(query, { limit }).map(r => ({
+            name: r.item.name,
+            value: r.item.value,
+            category: r.item.category,
+            layer: r.item.layer,
+            useCase: r.item.useCase,
+            score: r.score,
+        }));
+        return {
+            content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=search_tokens.js.map

package/dist/tools/search_tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_tokens.js","sourceRoot":"","sources":["../../src/tools/search_tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,mEAAmE,EACnE;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;QAC3G,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;QAC/G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KACxF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ;YACrB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YACrF,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAEjB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE;YAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;YAC3E,SAAS,EAAE,GAAG;YACd,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;YACjB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;YACzB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;YACvB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAC;QACJ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search_utility_classes.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchUtilityClasses(server: McpServer): void;

package/dist/tools/search_utility_classes.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+export function registerSearchUtilityClasses(server) {
+    server.tool('search_utility_classes', 'Search Spotlight CSS utility classes (e.g. ".spotlight_body-xs") by name, category, or subcategory. Use to find the helper class for typography, layout, spacing, alignment, etc.', {
+        query: z.string().describe('Search query, e.g. "body text", "heading", "flex", "grid column"'),
+        category: z.string().optional().describe('Filter by category: "typography", "layout", "spacing", etc.'),
+        limit: z.number().optional().default(10).describe('Max results to return (default 10)'),
+    }, async ({ query, category, limit }) => {
+        const index = loadIndex();
+        const classes = category
+            ? index.utilityClasses.filter(c => c.category.toLowerCase().includes(category.toLowerCase()))
+            : index.utilityClasses;
+        const fuse = new Fuse(classes, {
+            keys: ['name', 'category', 'subCategory', 'scale'],
+            threshold: 0.4,
+            ignoreLocation: true,
+            useExtendedSearch: true,
+            includeScore: true,
+        });
+        // OR each whitespace-separated word so multi-word queries ("body text")
+        // match items containing any term, instead of one fuzzy blob that matches none.
+        const orQuery = query.trim().split(/\s+/).map(t => `'${t}`).join(' | ');
+        const results = fuse.search(orQuery, { limit }).map(r => ({
+            name: r.item.name,
+            category: r.item.category,
+            subCategory: r.item.subCategory,
+            scale: r.item.scale,
+            responsive: r.item.responsive,
+            score: r.score,
+        }));
+        return {
+            content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=search_utility_classes.js.map

package/dist/tools/search_utility_classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_utility_classes.js","sourceRoot":"","sources":["../../src/tools/search_utility_classes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,mLAAmL,EACnL;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;QAC9F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;QACvG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KACxF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ;YACtB,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7F,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;QAEzB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE;YAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC;YAClD,SAAS,EAAE,GAAG;YACd,cAAc,EAAE,IAAI;YACpB,iBAAiB,EAAE,IAAI;YACvB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,wEAAwE;QACxE,gFAAgF;QAChF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;YACjB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;YACzB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW;YAC/B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU;YAC7B,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAC;QACJ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/validate_usage.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerValidateUsage(server: McpServer): void;

package/dist/tools/validate_usage.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { loadIndex } from '../data/loader.js';
+export function registerValidateUsage(server) {
+    server.tool('validate_usage', 'Check a JSX/TSX snippet against Spotlight rules and return any violations.', { code: z.string().describe('JSX or TSX code snippet to validate') }, async ({ code }) => {
+        const index = loadIndex();
+        const violations = [];
+        for (const rule of index.rules) {
+            const patternToCheck = rule.pattern ?? rule.incorrect;
+            if (!patternToCheck)
+                continue;
+            const matched = rule.pattern
+                ? new RegExp(rule.pattern).test(code)
+                : code.includes(patternToCheck.trim());
+            if (matched) {
+                violations.push({
+                    ruleId: rule.id,
+                    severity: rule.severity,
+                    title: rule.title,
+                    hint: rule.correct ? `Use instead: ${rule.correct}` : '',
+                });
+            }
+        }
+        // Check for deprecated component usage
+        for (const dep of index.deprecated) {
+            if (code.includes(`<${dep.component}`) || code.includes(`${dep.component} `)) {
+                violations.push({
+                    ruleId: `deprecated-${dep.component.toLowerCase()}`,
+                    severity: 'warning',
+                    title: `${dep.component} is deprecated${dep.removalDate ? ` (removal: ${dep.removalDate})` : ''}`,
+                    hint: dep.replacement ? `Use ${dep.replacement} instead.` : dep.notes ?? '',
+                });
+            }
+        }
+        const result = violations.length
+            ? { valid: false, violations }
+            : { valid: true, message: 'No violations found.' };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=validate_usage.js.map

package/dist/tools/validate_usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_usage.js","sourceRoot":"","sources":["../../src/tools/validate_usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,4EAA4E,EAC5E,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EACpE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAwE,EAAE,CAAC;QAE3F,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC;YACtD,IAAI,CAAC,cAAc;gBAAE,SAAS;YAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO;gBAC1B,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;YAEzC,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;iBACzD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC7E,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,cAAc,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE;oBACnD,QAAQ,EAAE,SAAS;oBACnB,KAAK,EAAE,GAAG,GAAG,CAAC,SAAS,iBAAiB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACjG,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,WAAW,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;iBAC5E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM;YAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE;YAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAErD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/transports/http.d.ts

@@ -0,0 +1 @@
+export declare function runHttp(port?: number): Promise<void>;

package/dist/transports/http.js

@@ -0,0 +1,71 @@
+import express from 'express';
+import { randomUUID } from 'crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { createServer } from '../server.js';
+const DEFAULT_PORT = Number(process.env.PORT ?? 3000);
+export async function runHttp(port = DEFAULT_PORT) {
+    const app = express();
+    app.use(express.json());
+    // ── Streamable HTTP (MCP spec 2025-03-26, new standard) ──────────────────
+    const streamableSessions = new Map();
+    app.post('/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (sessionId && streamableSessions.has(sessionId)) {
+            await streamableSessions.get(sessionId).transport.handleRequest(req, res, req.body);
+            return;
+        }
+        const server = createServer();
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (id) => {
+                streamableSessions.set(id, { server, transport });
+            },
+        });
+        transport.onclose = () => {
+            if (transport.sessionId)
+                streamableSessions.delete(transport.sessionId);
+        };
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+    app.delete('/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        const session = sessionId ? streamableSessions.get(sessionId) : undefined;
+        if (!session) {
+            res.status(404).json({ error: 'Session not found' });
+            return;
+        }
+        await session.transport.handleRequest(req, res);
+        streamableSessions.delete(sessionId);
+    });
+    // ── SSE (legacy transport for older MCP clients) ─────────────────────────
+    const sseSessions = new Map();
+    app.get('/sse', async (req, res) => {
+        const transport = new SSEServerTransport('/messages', res);
+        sseSessions.set(transport.sessionId, transport);
+        res.on('close', () => sseSessions.delete(transport.sessionId));
+        const server = createServer();
+        await server.connect(transport);
+    });
+    app.post('/messages', async (req, res) => {
+        const sessionId = req.query.sessionId;
+        const transport = sseSessions.get(sessionId);
+        if (!transport) {
+            res.status(404).json({ error: 'Session not found' });
+            return;
+        }
+        await transport.handlePostMessage(req, res, req.body);
+    });
+    // ── Health ────────────────────────────────────────────────────────────────
+    app.get('/health', (_, res) => {
+        res.json({ status: 'ok', server: 'spotlight-mcp', version: '0.1.0' });
+    });
+    app.listen(port, () => {
+        console.error(`Spotlight MCP HTTP server running on port ${port}`);
+        console.error(`  Streamable HTTP : POST http://localhost:${port}/mcp`);
+        console.error(`  SSE (legacy)    : GET  http://localhost:${port}/sse`);
+        console.error(`  Health          : GET  http://localhost:${port}/health`);
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/transports/http.js.map

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

package/dist/transports/stdio.d.ts

@@ -0,0 +1 @@
+export declare function runStdio(): Promise<void>;

package/dist/transports/stdio.js

@@ -0,0 +1,9 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from '../server.js';
+export async function runStdio() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Spotlight MCP running on stdio');
+}
+//# sourceMappingURL=stdio.js.map

package/dist/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;AAClD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+export interface ComponentProp {
+    name: string;
+    type: string;
+    required: boolean;
+    defaultValue?: string;
+    description: string;
+    importantNote?: string;
+}
+export interface ComponentStory {
+    name: string;
+    url: string;
+    /** Example code reconstructed from the story's args, or the story's render body. */
+    code?: string;
+}
+export interface ComponentUsage {
+    whenToUse?: string;
+    whenNotToUse?: string;
+    examples?: string[];
+}
+export interface Component {
+    id: string;
+    name: string;
+    category: string;
+    sourcePath: string;
+    status: 'stable' | 'deprecated' | 'legacy';
+    description: string;
+    muiEquivalent?: string;
+    reactAriaBase?: string;
+    props: ComponentProp[];
+    /** Where props came from: 'local' types.ts, or re-exported 'mui' types. */
+    propsSource?: 'local' | 'mui';
+    /** When propsSource is 'mui', the MUI props type name (e.g. "ButtonGroupProps"). */
+    muiPropsType?: string;
+    /** True when a content/components/*.md doc augmented this entry. */
+    manualDoc?: boolean;
+    stories: ComponentStory[];
+    usage: ComponentUsage;
+    tokens: string[];
+    relatedComponents: string[];
+    /** Patterns/guides relevant to this component (selection, placement, labeling, etc.). */
+    relatedPatterns?: {
+        id: string;
+        title: string;
+    }[];
+    importPath: string;
+}
+export interface Token {
+    name: string;
+    value: string;
+    category: string;
+    usedInComponents: string[];
+    description?: string;
+    pairedWith?: string;
+    /** Decomposed naming-formula segments (from token-dictionary.json). */
+    property?: string;
+    variant?: string;
+    element?: string;
+    hierarchy?: string;
+    scale?: string;
+    weight?: string;
+    states?: string[];
+    /** ref (raw palette) vs semantic (purpose-named, what you should use). */
+    layer?: 'ref' | 'semantic';
+    /** CSS selectors/states this token applies to (e.g. ".spotlight_interactive:focus"). */
+    appliesTo?: string[];
+    /** Human-readable intent derived from the name formula — "what to use this for". */
+    useCase?: string;
+}
+export interface Pattern {
+    id: string;
+    title: string;
+    category: string;
+    description: string;
+    content: string;
+    components: string[];
+    sourcePath: string;
+}
+export interface Rule {
+    id: string;
+    severity: 'error' | 'warning' | 'info';
+    title: string;
+    correct?: string;
+    incorrect?: string;
+    pattern?: string;
+    sourcePath: string;
+}
+export interface MigrationEntry {
+    fromComponent: string;
+    toComponent: string;
+    breaking: boolean;
+    deadline?: string;
+    propsMapping: Record<string, string>;
+    notes?: string;
+}
+export interface DeprecatedEntry {
+    component: string;
+    removalDate?: string;
+    replacement?: string;
+    status?: string;
+    notes?: string;
+}
+export interface UtilityClass {
+    name: string;
+    category: string;
+    subCategory?: string;
+    scale?: string;
+    responsive?: boolean;
+    value?: string | null;
+}
+export interface SpotlightIndex {
+    version: string;
+    generated: string;
+    components: Component[];
+    patterns: Pattern[];
+    tokens: Token[];
+    rules: Rule[];
+    migration: MigrationEntry[];
+    deprecated: DeprecatedEntry[];
+    utilityClasses: UtilityClass[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@castandcrew/spotlight-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Spotlight Design System",
+  "type": "module",
+  "bin": {
+    "spotlight-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data"
+  ],
+  "scripts": {
+    "dev:stdio": "tsx src/index.ts",
+    "dev:http": "tsx src/index.ts --http",
+    "build": "tsc",
+    "prepare": "pnpm build",
+    "start": "node dist/index.js",
+    "start:http": "node dist/index.js --http",
+    "index": "tsx scripts/indexer.ts",
+    "test": "pnpm build && vitest run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "express": "^4.22.2",
+    "fuse.js": "^7.4.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.1",
+    "@types/node": "^22.15.3",
+    "gray-matter": "^4.0.3",
+    "ts-morph": "^28.0.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.9"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}