@castandcrew/spotlight-mcp 0.1.0

package/dist/data/loader.d.ts

@@ -0,0 +1,3 @@
+import type { SpotlightIndex } from '../types.js';
+export declare function loadIndex(): SpotlightIndex;
+export declare function reloadIndex(): SpotlightIndex;

package/dist/data/loader.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cached = null;
+export function loadIndex() {
+    if (cached)
+        return cached;
+    const indexPath = process.env.SPOTLIGHT_INDEX_PATH
+        ? resolve(process.env.SPOTLIGHT_INDEX_PATH)
+        : resolve(__dirname, '../../data/index.json');
+    cached = JSON.parse(readFileSync(indexPath, 'utf-8'));
+    return cached;
+}
+export function reloadIndex() {
+    cached = null;
+    return loadIndex();
+}
+//# sourceMappingURL=loader.js.map

package/dist/data/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/data/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,MAAM,GAA0B,IAAI,CAAC;AAEzC,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAChD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;IAChD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAmB,CAAC;IACxE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { runStdio } from './transports/stdio.js';
+import { runHttp } from './transports/http.js';
+const args = process.argv.slice(2);
+if (args.includes('--http')) {
+    const portArg = args.find(a => a.startsWith('--port='));
+    const port = portArg ? Number(portArg.split('=')[1]) : undefined;
+    runHttp(port).catch(console.error);
+}
+else {
+    runStdio().catch(console.error);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;KAAM,CAAC;IACN,QAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,33 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerGetComponent } from './tools/get_component.js';
+import { registerSearchComponents } from './tools/search_components.js';
+import { registerGetToken } from './tools/get_token.js';
+import { registerSearchTokens } from './tools/search_tokens.js';
+import { registerGetMigrationGuide } from './tools/get_migration_guide.js';
+import { registerGetPattern } from './tools/get_pattern.js';
+import { registerValidateUsage } from './tools/validate_usage.js';
+import { registerListDeprecated } from './tools/list_deprecated.js';
+import { registerSearchUtilityClasses } from './tools/search_utility_classes.js';
+import { registerAskSpotlight } from './tools/ask_spotlight.js';
+import { registerIdentifyPattern } from './tools/identify_pattern.js';
+import { registerGetRecipe } from './tools/get_recipe.js';
+export function createServer() {
+    const server = new McpServer({
+        name: 'spotlight-mcp',
+        version: '0.1.0',
+    });
+    registerGetComponent(server);
+    registerSearchComponents(server);
+    registerGetToken(server);
+    registerSearchTokens(server);
+    registerGetMigrationGuide(server);
+    registerGetPattern(server);
+    registerValidateUsage(server);
+    registerListDeprecated(server);
+    registerSearchUtilityClasses(server);
+    registerAskSpotlight(server);
+    registerIdentifyPattern(server);
+    registerGetRecipe(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/ask_spotlight.d.ts

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

package/dist/tools/ask_spotlight.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+const EXCERPT = 8000;
+const STOPWORDS = new Set([
+    'how', 'should', 'shall', 'would', 'could', 'can', 'the', 'and', 'for', 'with', 'what',
+    'when', 'which', 'use', 'used', 'using', 'do', 'does', 'are', 'is', 'be', 'to', 'of', 'in',
+    'on', 'or', 'my', 'me', 'it', 'this', 'that', 'an', 'a', 'i', 'about', 'best', 'way', 'ways',
+]);
+function keywords(question) {
+    const kw = question
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length >= 3 && !STOPWORDS.has(w));
+    return kw.length ? kw.join(' ') : question;
+}
+export function registerAskSpotlight(server) {
+    server.tool('ask_spotlight', 'Answer a Spotlight Design System question in ONE call. The default entry point for any ' +
+        'natural-language question about Spotlight — which component to use, when/how to use it, ' +
+        'props, design tokens, button labeling/placement, MUI migration, etc. Searches components, ' +
+        'usage patterns/guides, and tokens, and returns the most relevant material consolidated so ' +
+        'no follow-up calls are needed for a typical answer.', {
+        question: z
+            .string()
+            .describe('A natural-language question, e.g. "how should I label and place buttons?"'),
+    }, async ({ question }) => {
+        const index = loadIndex();
+        const query = keywords(question);
+        // Patterns: title/id/components are weighted far above content so a guide that's
+        // *about* the topic beats a big rules doc that merely mentions the word.
+        const patternFuse = new Fuse(index.patterns, {
+            keys: [
+                { name: 'title', weight: 3 },
+                { name: 'id', weight: 2 },
+                { name: 'components', weight: 2 },
+                { name: 'description', weight: 1 },
+                { name: 'content', weight: 0.2 },
+            ],
+            threshold: 0.45,
+            ignoreLocation: true,
+        });
+        const guidance = patternFuse.search(query, { limit: 3 }).map(r => {
+            const p = r.item;
+            const truncated = p.content.length > EXCERPT;
+            return {
+                id: p.id,
+                title: p.title,
+                category: p.category,
+                excerpt: truncated
+                    ? `${p.content.slice(0, EXCERPT)}\n… (call get_pattern "${p.id}" for the full guide)`
+                    : p.content,
+            };
+        });
+        // Components: name/description/category.
+        const compFuse = new Fuse(index.components, {
+            keys: [{ name: 'name', weight: 3 }, { name: 'category', weight: 1 }, { name: 'description', weight: 1 }],
+            threshold: 0.4,
+            ignoreLocation: true,
+        });
+        const components = compFuse.search(query, { limit: 3 }).map(r => {
+            const c = r.item;
+            return {
+                name: c.name,
+                category: c.category,
+                status: c.status,
+                description: c.description,
+                propsCount: c.props.length,
+                examples: c.stories.filter(s => s.code).slice(0, 3).map(s => s.code),
+                relatedPatterns: c.relatedPatterns ?? [],
+            };
+        });
+        // Stem the keywords and match short-field data deterministically — fuzzy search
+        // is unreliable on token/class names ("spacing" → "--space-md", etc.).
+        const stems = query.split(/\s+/).filter(w => w.length >= 3).map(w => w.replace(/(ings?|es|s)$/, ''));
+        const matches = (text) => {
+            const t = text.toLowerCase();
+            return stems.some(s => s.length >= 3 && t.includes(s));
+        };
+        // Tokens — when the question is token/style-shaped.
+        const tokenIntent = /token|colou?r|spac|gap|margin|pad|radius|radii|typograph|font|weight|text|shadow|elevation|\bsize/i.test(question);
+        const tokens = tokenIntent
+            ? index.tokens
+                .filter(t => matches(`${t.name} ${t.category} ${t.useCase ?? ''}`))
+                .slice(0, 8)
+                .map(t => ({ name: t.name, value: t.value, useCase: t.useCase, layer: t.layer }))
+            : [];
+        // Utility classes — when the question mentions classes/utilities/layout.
+        const classIntent = /class|utilit|grid|flex|column|align|justif|spotlight_|body|heading|display|label/i.test(question);
+        const utilityClasses = classIntent
+            ? index.utilityClasses
+                .filter(c => matches(`${c.name} ${c.category} ${c.subCategory ?? ''}`))
+                .slice(0, 8)
+                .map(c => c.name)
+            : [];
+        // Migration — when the question is about MUI/migrating; match the component, not "mui".
+        const wantsMigration = /\b(mui|material[-\s]?ui|migrat|reskin|replace)\b/i.test(question);
+        const generic = new Set(['mui', 'material', 'materialui', 'migrate', 'migrat', 'migration', 'reskin', 'replace', 'component']);
+        const migStems = stems.filter(s => !generic.has(s));
+        const migration = wantsMigration
+            ? index.migration
+                .filter(m => migStems.some(s => `${m.fromComponent} ${m.toComponent}`.toLowerCase().includes(s)))
+                .slice(0, 4)
+                .map(m => ({ from: m.fromComponent, to: m.toComponent }))
+            : [];
+        const payload = {
+            question,
+            components,
+            guidance,
+            ...(tokens.length ? { tokens } : {}),
+            ...(utilityClasses.length ? { utilityClasses } : {}),
+            ...(migration.length ? { migration } : {}),
+            hint: 'This is the consolidated answer context. For a full component (all props) call ' +
+                'get_component; for a full guide call get_pattern with the id; for a migration guide ' +
+                'call get_migration_guide with the "from" value.',
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=ask_spotlight.js.map

package/dist/tools/ask_spotlight.js.map

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

package/dist/tools/get_component.d.ts

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

package/dist/tools/get_component.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { loadIndex } from '../data/loader.js';
+export function registerGetComponent(server) {
+    server.tool('get_component', 'Get full details for a Spotlight component: props, usage guidelines, examples, related components, and design tokens.', { name: z.string().describe('Component name, e.g. "Button", "TextField"') }, async ({ name }) => {
+        const index = loadIndex();
+        const component = index.components.find(c => c.name.toLowerCase() === name.toLowerCase() ||
+            c.id.toLowerCase() === name.toLowerCase());
+        if (!component) {
+            return {
+                content: [{ type: 'text', text: `Component "${name}" not found. Use search_components to find available components.` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(component, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get_component.js.map

package/dist/tools/get_component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_component.js","sourceRoot":"","sources":["../../src/tools/get_component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uHAAuH,EACvH,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC,EAAE,EAC3E,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,CACF,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE;YAC3C,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAC5C,CAAC;QACF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,IAAI,kEAAkE,EAAE,CAAC;gBAChI,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC/E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get_migration_guide.d.ts

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

package/dist/tools/get_migration_guide.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { loadIndex } from '../data/loader.js';
+export function registerGetMigrationGuide(server) {
+    server.tool('get_migration_guide', 'Get the migration guide from a MUI or deprecated Spotlight component to its current equivalent, including prop mapping.', { fromComponent: z.string().describe('Source component, e.g. "MUI/Button", "ComboBox"') }, async ({ fromComponent }) => {
+        const index = loadIndex();
+        const guide = index.migration.find(m => m.fromComponent.toLowerCase() === fromComponent.toLowerCase());
+        if (!guide) {
+            const available = index.migration.map(m => m.fromComponent);
+            return {
+                content: [{ type: 'text', text: `No migration guide found for "${fromComponent}".\n\nAvailable: ${available.join(', ')}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(guide, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get_migration_guide.js.map

package/dist/tools/get_migration_guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_migration_guide.js","sourceRoot":"","sources":["../../src/tools/get_migration_guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,yHAAyH,EACzH,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC,EAAE,EACzF,KAAK,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,CACnE,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iCAAiC,aAAa,oBAAoB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACpI,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get_pattern.d.ts

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

package/dist/tools/get_pattern.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+export function registerGetPattern(server) {
+    server.tool('get_pattern', 'Get a Spotlight usage pattern: when to use which component, comparisons between alternatives, and code examples.', { query: z.string().describe('Pattern name or topic, e.g. "overlay", "modal vs drawer", "filtering", "pagination"') }, async ({ query }) => {
+        const index = loadIndex();
+        if (!index.patterns.length) {
+            return {
+                content: [{ type: 'text', text: 'No patterns available in the index yet.' }],
+            };
+        }
+        const fuse = new Fuse(index.patterns, {
+            keys: ['title', 'description', 'id', 'components'],
+            threshold: 0.4,
+        });
+        const results = fuse.search(query, { limit: 3 });
+        if (!results.length) {
+            const available = index.patterns.map(p => p.title);
+            return {
+                content: [{ type: 'text', text: `No patterns found for "${query}".\n\nAvailable patterns: ${available.join(', ')}` }],
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(results[0].item, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get_pattern.js.map

package/dist/tools/get_pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_pattern.js","sourceRoot":"","sources":["../../src/tools/get_pattern.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,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,kHAAkH,EAClH,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,EAAE,EACrH,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yCAAyC,EAAE,CAAC;aACtF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YACpC,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,CAAC;YAClD,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,KAAK,6BAA6B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;aAC/H,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get_recipe.d.ts

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

package/dist/tools/get_recipe.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+export function registerGetRecipe(server) {
+    server.tool('get_recipe', 'Get the implementation recipe for a Spotlight pattern — concise, AI-consumable instructions ' +
+        'for building the pattern correctly. Call this after identify_pattern confirms which pattern ' +
+        'applies. Returns component structure, critical props, token usage, a complete implementation ' +
+        'example, and a validation checklist.', {
+        patternId: z
+            .string()
+            .describe('Pattern ID from identify_pattern, e.g. "data-display-table-pattern" or "filter-chips-pattern"'),
+    }, async ({ patternId }) => {
+        const index = loadIndex();
+        const recipes = index.patterns.filter(p => p.category === 'recipe');
+        // 1. Exact id match within recipes.
+        const exact = recipes.find(p => p.id === patternId);
+        if (exact) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ id: exact.id, title: exact.title, content: exact.content }, null, 2),
+                    },
+                ],
+            };
+        }
+        // 2. Fuzzy match against recipe titles and ids.
+        if (recipes.length > 0) {
+            const fuse = new Fuse(recipes, {
+                keys: [
+                    { name: 'id', weight: 3 },
+                    { name: 'title', weight: 2 },
+                    { name: 'description', weight: 1 },
+                ],
+                threshold: 0.4,
+                ignoreLocation: true,
+                includeScore: true,
+            });
+            const results = fuse.search(patternId, { limit: 1 });
+            if (results.length) {
+                const best = results[0].item;
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                id: best.id,
+                                title: best.title,
+                                content: best.content,
+                                note: `No exact recipe for "${patternId}". Closest match: "${best.title}" (${best.id}).`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+        }
+        // 3. No recipe exists — direct caller to get_pattern.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        notFound: true,
+                        patternId,
+                        hint: `No implementation recipe exists for "${patternId}". Try calling get_pattern("${patternId}") for conceptual guidance, or call identify_pattern with a use-case description to find the right pattern.`,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get_recipe.js.map

package/dist/tools/get_recipe.js.map

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

package/dist/tools/get_token.d.ts

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

package/dist/tools/get_token.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { loadIndex } from '../data/loader.js';
+export function registerGetToken(server) {
+    server.tool('get_token', 'Get details for a Spotlight design token: its value, category, and which components use it.', { name: z.string().describe('Token name, e.g. "--space-md", "--color-background-positive"') }, async ({ name }) => {
+        const index = loadIndex();
+        const token = index.tokens.find(t => t.name.toLowerCase() === name.toLowerCase());
+        if (!token) {
+            return {
+                content: [{ type: 'text', text: `Token "${name}" not found. Use search_tokens to find available tokens.` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(token, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get_token.js.map

package/dist/tools/get_token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_token.js","sourceRoot":"","sources":["../../src/tools/get_token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,WAAW,EACX,6FAA6F,EAC7F,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC,EAAE,EAC7F,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACjD,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,IAAI,0DAA0D,EAAE,CAAC;gBACpH,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/identify_pattern.d.ts

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

package/dist/tools/identify_pattern.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+const HIGH_THRESHOLD = 0.25;
+const MEDIUM_THRESHOLD = 0.42;
+const SEARCH_THRESHOLD = 0.55;
+function confidence(score) {
+    if (score < HIGH_THRESHOLD)
+        return 'high';
+    if (score < MEDIUM_THRESHOLD)
+        return 'medium';
+    return 'low';
+}
+function firstSentence(text) {
+    const trimmed = text.replace(/\s+/g, ' ').trim();
+    const end = trimmed.search(/[.!?]/);
+    return end > 0 ? trimmed.slice(0, end + 1) : trimmed.slice(0, 150);
+}
+export function registerIdentifyPattern(server) {
+    server.tool('identify_pattern', 'Identify the correct Spotlight pattern for a use case. Call this when you need to know ' +
+        'which pattern applies before implementing — provide a natural-language description of ' +
+        'what you are building. Returns ranked pattern matches with confidence scores and whether ' +
+        'a recipe is available.', {
+        useCase: z
+            .string()
+            .describe('Natural-language description of the UI you are building, e.g. "a table of timecards with sorting and row selection"'),
+        components: z
+            .array(z.string())
+            .optional()
+            .describe('Spotlight component names already in scope (optional), e.g. ["GridTable", "Chip"]'),
+    }, async ({ useCase, components }) => {
+        const index = loadIndex();
+        // Pool: selection guides + recipe files only.
+        const pool = index.patterns.filter(p => p.category === 'selection' || p.category === 'recipe');
+        // Build recipe id set for recipeAvailable lookup.
+        const recipeIds = new Set(index.patterns.filter(p => p.category === 'recipe').map(p => p.id));
+        const recipeAvailable = (matchId) => {
+            if (recipeIds.has(matchId))
+                return true;
+            // A selection guide may have a corresponding recipe whose id shares a common root.
+            const root = matchId.replace(/-pattern$/, '');
+            for (const rid of recipeIds) {
+                if (rid.startsWith(root) || rid === root)
+                    return true;
+            }
+            return false;
+        };
+        // Boost query with provided component names so component-bearing queries
+        // surface patterns that mention those components.
+        const componentBoost = components?.length ? components.join(' ') + ' ' : '';
+        const query = componentBoost + useCase;
+        const fuse = new Fuse(pool, {
+            keys: [
+                { name: 'title', weight: 4 },
+                { name: 'id', weight: 3 },
+                { name: 'components', weight: 2 },
+                { name: 'description', weight: 1.5 },
+                { name: 'content', weight: 0.1 },
+            ],
+            threshold: SEARCH_THRESHOLD,
+            ignoreLocation: true,
+            includeScore: true,
+        });
+        const results = fuse.search(query, { limit: 3 });
+        if (!results.length) {
+            // Suggest component names tangentially related to the use case.
+            const compFuse = new Fuse(index.components, {
+                keys: [{ name: 'name', weight: 2 }, { name: 'description', weight: 1 }],
+                threshold: 0.4,
+                ignoreLocation: true,
+            });
+            const suggestions = compFuse
+                .search(useCase, { limit: 5 })
+                .map(r => r.item.name);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ noMatch: true, suggestions }, null, 2),
+                    },
+                ],
+            };
+        }
+        const matches = results.map(r => ({
+            id: r.item.id,
+            title: r.item.title,
+            confidence: confidence(r.score ?? 1),
+            recipeAvailable: recipeAvailable(r.item.id),
+            hint: firstSentence(r.item.description),
+        }));
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ matches }, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=identify_pattern.js.map

package/dist/tools/identify_pattern.js.map

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

package/dist/tools/list_deprecated.d.ts

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

package/dist/tools/list_deprecated.js

@@ -0,0 +1,10 @@
+import { loadIndex } from '../data/loader.js';
+export function registerListDeprecated(server) {
+    server.tool('list_deprecated', 'List all deprecated and legacy Spotlight components with their replacements and removal dates.', {}, async () => {
+        const index = loadIndex();
+        return {
+            content: [{ type: 'text', text: JSON.stringify(index.deprecated, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=list_deprecated.js.map

package/dist/tools/list_deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_deprecated.js","sourceRoot":"","sources":["../../src/tools/list_deprecated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,gGAAgG,EAChG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACtF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search_components.d.ts

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

package/dist/tools/search_components.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import Fuse from 'fuse.js';
+import { loadIndex } from '../data/loader.js';
+export function registerSearchComponents(server) {
+    server.tool('search_components', 'Search Spotlight components by name, description, or category. Returns a ranked list of matches.', {
+        query: z.string().describe('Search query, e.g. "date picker", "dropdown", "inputs"'),
+        limit: z.number().optional().default(10).describe('Max results to return (default 10)'),
+    }, async ({ query, limit }) => {
+        const index = loadIndex();
+        const fuse = new Fuse(index.components, {
+            keys: ['name', 'description', 'category', 'id'],
+            threshold: 0.4,
+            includeScore: true,
+        });
+        const results = fuse.search(query, { limit }).map(r => ({
+            name: r.item.name,
+            category: r.item.category,
+            status: r.item.status,
+            description: r.item.description,
+            score: r.score,
+        }));
+        return {
+            content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=search_components.js.map

package/dist/tools/search_components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_components.js","sourceRoot":"","sources":["../../src/tools/search_components.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,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,kGAAkG,EAClG;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACpF,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,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;YACtC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC;YAC/C,SAAS,EAAE,GAAG;YACd,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,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;YACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;YACrB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW;YAC/B,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_tokens.d.ts

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