@redsift/ds-mcp-server 12.3.1-muiv6-alpha.2

package/dist/scaffold.js

@@ -0,0 +1,239 @@
+/**
+ * Code scaffold generator for new components.
+ *
+ * Generates boilerplate files following the exact conventions from
+ * the design system's CONTRIBUTING.md and copilot-instructions.md.
+ */
+/**
+ * Convert PascalCase to kebab-case.
+ */
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}
+/**
+ * Generate all component scaffold files.
+ */
+export function generateComponentScaffold(options) {
+    const { name, element, description, props } = options;
+    const kebabName = toKebabCase(name);
+    const classname = `redsift-${kebabName}`;
+    return [
+        {
+            fileName: `${name}.tsx`,
+            language: 'tsx',
+            content: generateComponent(name, classname, element, description, props),
+        },
+        {
+            fileName: 'types.ts',
+            language: 'typescript',
+            content: generateTypes(name, element, props),
+        },
+        {
+            fileName: 'styles.ts',
+            language: 'typescript',
+            content: generateStyles(name),
+        },
+        {
+            fileName: 'index.ts',
+            language: 'typescript',
+            content: generateIndex(name),
+        },
+        {
+            fileName: `${name}.test.tsx`,
+            language: 'tsx',
+            content: generateTest(name),
+        },
+        {
+            fileName: `${name}.stories.tsx`,
+            language: 'tsx',
+            content: generateStories(name),
+        },
+    ];
+}
+function generateComponent(name, classname, element, description, props) {
+    const styledName = `Styled${name}`;
+    const destructuredProps = props.map((p) => p.name).join(',\n    ');
+    const styledTransientProps = props.map((p) => `        $${p.name}={${p.name}}`).join('\n');
+    return `import React, { forwardRef } from 'react';
+import classNames from 'classnames';
+import { Comp } from '../../types';
+import { ${styledName} } from './styles';
+import { ${name}Props } from './types';
+
+const COMPONENT_NAME = '${name}';
+const CLASSNAME = '${classname}';
+
+/**
+ * ${description}
+ */
+export const ${name}: Comp<${name}Props, HTML${capitalize(element)}Element> = forwardRef((props, ref) => {
+  const {
+    children,
+    className,${destructuredProps ? '\n    ' + destructuredProps + ',' : ''}
+    ...forwardedProps
+  } = props;
+
+  return (
+    <${styledName}
+      {...forwardedProps}
+${styledTransientProps}
+      className={classNames(${name}.className, className)}
+      ref={ref}
+    >
+      {children}
+    </${styledName}>
+  );
+});
+${name}.className = CLASSNAME;
+${name}.displayName = COMPONENT_NAME;
+`;
+}
+function generateTypes(name, element, props) {
+    const propsEntries = props
+        .map((p) => {
+        const lines = [];
+        if (p.description) {
+            lines.push('  /**');
+            lines.push(`   * ${p.description}`);
+            if (p.defaultValue) {
+                lines.push(`   * @default ${p.defaultValue}`);
+            }
+            lines.push('   */');
+        }
+        lines.push(`  ${p.name}${p.required ? '' : '?'}: ${p.type};`);
+        return lines.join('\n');
+    })
+        .join('\n');
+    const styledPropsEntries = props.map((p) => `  $${p.name}?: ${name}Props['${p.name}'];`).join('\n');
+    return `import { ComponentProps } from 'react';
+import { StylingProps } from '../../types';
+
+/**
+ * ${name} component props.
+ */
+export interface ${name}Props extends ComponentProps<'${element}'>, StylingProps {
+${propsEntries}
+}
+
+export type Styled${name}Props = ${name}Props & {
+${styledPropsEntries}
+};
+`;
+}
+function generateStyles(name) {
+    return `import styled from 'styled-components';
+import { baseStyling, focusRing } from '../shared';
+import { Styled${name}Props } from './types';
+
+/**
+ * ${name} component style.
+ */
+export const Styled${name} = styled.div<Styled${name}Props>\`
+  \${baseStyling}
+  \${focusRing}
+\`;
+`;
+}
+function generateIndex(name) {
+    return `export * from './types';
+export * from './styles';
+export * from './${name}';
+`;
+}
+function generateTest(name) {
+    const kebabName = toKebabCase(name);
+    return `import React from 'react';
+import { render } from '@testing-library/react';
+import { composeStory } from '@storybook/react';
+import Meta, { Default } from './${name}.stories';
+import { ${name} } from '.';
+
+describe('${name}', () => {
+  it('should match snapshot', () => {
+    const ComposedStory = composeStory(Default, Meta);
+    const tree = render(<ComposedStory />);
+
+    expect(tree).toMatchSnapshot();
+  });
+
+  it('should render with default props', () => {
+    const { container } = render(<${name}>Content</${name}>);
+
+    expect(container.querySelector('.${kebabName}')).toBeInTheDocument();
+  });
+
+  it('should forward className', () => {
+    const { container } = render(<${name} className="custom">Content</${name}>);
+    const element = container.querySelector('.${kebabName}');
+
+    expect(element).toHaveClass('custom');
+  });
+
+  it('should forward ref', () => {
+    const ref = React.createRef<HTMLDivElement>();
+    render(<${name} ref={ref}>Content</${name}>);
+
+    expect(ref.current).toBeInstanceOf(HTMLDivElement);
+  });
+});
+`;
+}
+function generateStories(name) {
+    return `import React from 'react';
+import type { Meta, StoryObj } from '@storybook/react';
+import { ${name} } from '.';
+
+const meta: Meta<typeof ${name}> = {
+  title: 'Components/${name}',
+  component: ${name} as any,
+};
+export default meta;
+type Story = StoryObj<typeof ${name}>;
+
+export const Default: Story = {
+  args: {
+    children: '${name} content',
+  },
+};
+`;
+}
+/**
+ * Capitalize first letter of a string.
+ */
+function capitalize(str) {
+    // Map common HTML elements to their HTMLElement type prefix
+    const elementMap = {
+        div: 'Div',
+        span: 'Span',
+        button: 'Button',
+        input: 'Input',
+        a: 'Anchor',
+        form: 'Form',
+        select: 'Select',
+        textarea: 'TextArea',
+        img: 'Image',
+        label: 'Label',
+        li: 'LI',
+        ul: 'UList',
+        ol: 'OList',
+        p: 'Paragraph',
+        h1: 'Heading',
+        h2: 'Heading',
+        h3: 'Heading',
+        nav: '',
+        section: '',
+        article: '',
+        aside: '',
+        header: '',
+        footer: '',
+        main: '',
+    };
+    if (str in elementMap) {
+        return elementMap[str] || str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACxC,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAwB;IAChE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,WAAW,SAAS,EAAE,CAAC;IAEzC,OAAO;QACL;YACE,QAAQ,EAAE,GAAG,IAAI,MAAM;YACvB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC;SACzE;QACD;YACE,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;SAC7C;QACD;YACE,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;SAC9B;QACD;YACE,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;SAC7B;QACD;YACE,QAAQ,EAAE,GAAG,IAAI,WAAW;YAC5B,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC;SAC5B;QACD;YACE,QAAQ,EAAE,GAAG,IAAI,cAAc;YAC/B,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC;SAC/B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,SAAiB,EACjB,OAAe,EACf,WAAmB,EACnB,KAAqB;IAErB,MAAM,UAAU,GAAG,SAAS,IAAI,EAAE,CAAC;IAEnC,MAAM,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3F,OAAO;;;WAGE,UAAU;WACV,IAAI;;0BAEW,IAAI;qBACT,SAAS;;;KAGzB,WAAW;;eAED,IAAI,UAAU,IAAI,cAAc,UAAU,CAAC,OAAO,CAAC;;;gBAGlD,iBAAiB,CAAC,CAAC,CAAC,QAAQ,GAAG,iBAAiB,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;OAKpE,UAAU;;EAEf,oBAAoB;8BACQ,IAAI;;;;QAI1B,UAAU;;;EAGhB,IAAI;EACJ,IAAI;CACL,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,OAAe,EAAE,KAAqB;IACzE,MAAM,YAAY,GAAG,KAAK;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,IAAI,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEpG,OAAO;;;;KAIJ,IAAI;;mBAEU,IAAI,iCAAiC,OAAO;EAC7D,YAAY;;;oBAGM,IAAI,WAAW,IAAI;EACrC,kBAAkB;;CAEnB,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO;;iBAEQ,IAAI;;;KAGhB,IAAI;;qBAEY,IAAI,uBAAuB,IAAI;;;;CAInD,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO;;mBAEU,IAAI;CACtB,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEpC,OAAO;;;mCAG0B,IAAI;WAC5B,IAAI;;YAEH,IAAI;;;;;;;;;oCASoB,IAAI,aAAa,IAAI;;uCAElB,SAAS;;;;oCAIZ,IAAI,gCAAgC,IAAI;gDAC5B,SAAS;;;;;;;cAO3C,IAAI,uBAAuB,IAAI;;;;;CAK5C,CAAC;AACF,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO;;WAEE,IAAI;;0BAEW,IAAI;uBACP,IAAI;eACZ,IAAI;;;+BAGY,IAAI;;;;iBAIlB,IAAI;;;CAGpB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,4DAA4D;IAC5D,MAAM,UAAU,GAA2B;QACzC,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,OAAO;QACd,CAAC,EAAE,QAAQ;QACX,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,OAAO;QACd,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,OAAO;QACX,EAAE,EAAE,OAAO;QACX,CAAC,EAAE,WAAW;QACd,EAAE,EAAE,SAAS;QACb,EAAE,EAAE,SAAS;QACb,EAAE,EAAE,SAAS;QACb,GAAG,EAAE,EAAE;QACP,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/token-store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Design token loader and search for the MCP server.
+ *
+ * Parses style-dictionary JSON source files and the generated CSS variables
+ * to provide searchable design token data (colors, typography, spacing, etc.).
+ */
+/** A single design token */
+export interface DesignToken {
+    /** Full dot-path name (e.g. "Color.Blue.N") */
+    name: string;
+    /** Resolved value (e.g. "#4285f4") */
+    value: string;
+    /** CSS variable name if available (e.g. "--redsift-color-blue-n") */
+    cssVariable?: string;
+    /** Category: color, typography, layout, border-radius, component */
+    category: string;
+    /** Source file */
+    source: string;
+    /** Whether this is a reference to another token */
+    isReference: boolean;
+    /** Raw reference value if isReference (e.g. "{Color.Blue.N}") */
+    rawValue?: string;
+}
+/**
+ * Design token store — loads all tokens at startup and provides search.
+ */
+export declare class TokenStore {
+    private tokens;
+    private cssVariables;
+    private tokensByCategory;
+    constructor();
+    private loadTokens;
+    private loadCssVariables;
+    /**
+     * Match source tokens to their generated CSS variable names.
+     * Uses token path → kebab-case conversion with "redsift" prefix.
+     */
+    private matchCssVariables;
+    private buildCategoryIndex;
+    /** Get all available categories */
+    getCategories(): string[];
+    /** Get tokens by category */
+    getTokensByCategory(category: string): DesignToken[];
+    /** Get all tokens */
+    getAllTokens(): DesignToken[];
+    /**
+     * Search tokens by query string.
+     * Matches against name, value, CSS variable, and category.
+     */
+    searchTokens(query: string, category?: string): DesignToken[];
+    /**
+     * Lookup a specific CSS variable by name.
+     */
+    getCssVariable(name: string): string | undefined;
+    /**
+     * Get all CSS variables matching a pattern.
+     * Useful for finding all component-specific tokens.
+     */
+    getCssVariablesByPattern(pattern: string): Array<{
+        name: string;
+        value: string;
+    }>;
+    /** Get summary stats */
+    getSummary(): {
+        totalTokens: number;
+        totalCssVariables: number;
+        categories: Record<string, number>;
+    };
+}
+//# sourceMappingURL=token-store.d.ts.map

package/dist/token-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../src/token-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqDD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,gBAAgB,CAAyC;;IASjE,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,kBAAkB;IAQ1B,mCAAmC;IACnC,aAAa,IAAI,MAAM,EAAE;IAIzB,6BAA6B;IAC7B,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAIpD,qBAAqB;IACrB,YAAY,IAAI,WAAW,EAAE;IAI7B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAwC7D;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKhD;;;OAGG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAajF,wBAAwB;IACxB,UAAU,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;CAYrG"}

package/dist/token-store.js

@@ -0,0 +1,196 @@
+/**
+ * Design token loader and search for the MCP server.
+ *
+ * Parses style-dictionary JSON source files and the generated CSS variables
+ * to provide searchable design token data (colors, typography, spacing, etc.).
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { resolveDataPaths } from './paths.js';
+const { styleDictDir: STYLE_DICT_DIR, cssTokensPath: CSS_TOKENS_PATH } = resolveDataPaths();
+/**
+ * Parse a nested style-dictionary JSON object into flat tokens.
+ */
+function flattenTokens(obj, path = [], category, source) {
+    const tokens = [];
+    for (const [key, val] of Object.entries(obj)) {
+        const currentPath = [...path, key];
+        if (val && typeof val === 'object' && 'value' in val) {
+            const tokenObj = val;
+            const rawValue = tokenObj.value;
+            const isReference = rawValue.startsWith('{') && rawValue.endsWith('}');
+            tokens.push({
+                name: currentPath.join('.'),
+                value: rawValue,
+                category,
+                source,
+                isReference,
+                rawValue: isReference ? rawValue : undefined,
+            });
+        }
+        else if (val && typeof val === 'object') {
+            tokens.push(...flattenTokens(val, currentPath, category, source));
+        }
+    }
+    return tokens;
+}
+/**
+ * Parse CSS variables from the generated tokens CSS file.
+ * Returns a map of variable name → value.
+ */
+function parseCssVariables(cssContent) {
+    const vars = new Map();
+    const regex = /--([a-z0-9-]+):\s*([^;]+);/gi;
+    let match;
+    while ((match = regex.exec(cssContent)) !== null) {
+        vars.set(`--${match[1]}`, match[2].trim());
+    }
+    return vars;
+}
+/**
+ * Design token store — loads all tokens at startup and provides search.
+ */
+export class TokenStore {
+    tokens = [];
+    cssVariables = new Map();
+    tokensByCategory = new Map();
+    constructor() {
+        this.loadTokens();
+        this.loadCssVariables();
+        this.matchCssVariables();
+        this.buildCategoryIndex();
+    }
+    loadTokens() {
+        // Load core tokens
+        const coreDir = resolve(STYLE_DICT_DIR, 'core');
+        if (existsSync(coreDir)) {
+            for (const file of readdirSync(coreDir).filter((f) => f.endsWith('.json'))) {
+                const category = file.replace('.json', '');
+                const content = JSON.parse(readFileSync(resolve(coreDir, file), 'utf-8'));
+                this.tokens.push(...flattenTokens(content, [], category, `core/${file}`));
+            }
+        }
+        // Load component tokens
+        const componentsDir = resolve(STYLE_DICT_DIR, 'components');
+        if (existsSync(componentsDir)) {
+            for (const file of readdirSync(componentsDir).filter((f) => f.endsWith('.json'))) {
+                const content = JSON.parse(readFileSync(resolve(componentsDir, file), 'utf-8'));
+                this.tokens.push(...flattenTokens(content, [], 'component', `components/${file}`));
+            }
+        }
+    }
+    loadCssVariables() {
+        if (existsSync(CSS_TOKENS_PATH)) {
+            const css = readFileSync(CSS_TOKENS_PATH, 'utf-8');
+            this.cssVariables = parseCssVariables(css);
+        }
+    }
+    /**
+     * Match source tokens to their generated CSS variable names.
+     * Uses token path → kebab-case conversion with "redsift" prefix.
+     */
+    matchCssVariables() {
+        for (const token of this.tokens) {
+            // Convert token name "Color.Blue.N" → "--redsift-color-blue-n"
+            const cssName = '--redsift-' + token.name.replace(/\./g, '-').replace(/\s+/g, '-').toLowerCase();
+            if (this.cssVariables.has(cssName)) {
+                token.cssVariable = cssName;
+                // Resolve the value from CSS (which has references resolved)
+                if (token.isReference) {
+                    token.value = this.cssVariables.get(cssName) || token.value;
+                }
+            }
+        }
+    }
+    buildCategoryIndex() {
+        for (const token of this.tokens) {
+            const existing = this.tokensByCategory.get(token.category) || [];
+            existing.push(token);
+            this.tokensByCategory.set(token.category, existing);
+        }
+    }
+    /** Get all available categories */
+    getCategories() {
+        return Array.from(this.tokensByCategory.keys()).sort();
+    }
+    /** Get tokens by category */
+    getTokensByCategory(category) {
+        return this.tokensByCategory.get(category) || [];
+    }
+    /** Get all tokens */
+    getAllTokens() {
+        return this.tokens;
+    }
+    /**
+     * Search tokens by query string.
+     * Matches against name, value, CSS variable, and category.
+     */
+    searchTokens(query, category) {
+        const lowerQuery = query.toLowerCase();
+        const terms = lowerQuery.split(/\s+/).filter(Boolean);
+        const pool = category ? this.getTokensByCategory(category) : this.tokens;
+        const scored = pool
+            .map((token) => {
+            const nameLower = token.name.toLowerCase();
+            const valueLower = token.value.toLowerCase();
+            const cssLower = (token.cssVariable || '').toLowerCase();
+            let score = 0;
+            for (const term of terms) {
+                // Exact name segment match
+                if (nameLower.split('.').some((seg) => seg === term)) {
+                    score += 100;
+                }
+                // Name contains term
+                else if (nameLower.includes(term)) {
+                    score += 50;
+                }
+                // CSS variable contains term
+                if (cssLower.includes(term)) {
+                    score += 30;
+                }
+                // Value matches (e.g. searching by hex color)
+                if (valueLower.includes(term)) {
+                    score += 20;
+                }
+            }
+            return { token, score };
+        })
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score);
+        return scored.map((s) => s.token);
+    }
+    /**
+     * Lookup a specific CSS variable by name.
+     */
+    getCssVariable(name) {
+        const normalized = name.startsWith('--') ? name : `--${name}`;
+        return this.cssVariables.get(normalized);
+    }
+    /**
+     * Get all CSS variables matching a pattern.
+     * Useful for finding all component-specific tokens.
+     */
+    getCssVariablesByPattern(pattern) {
+        const lowerPattern = pattern.toLowerCase();
+        const results = [];
+        for (const [name, value] of this.cssVariables) {
+            if (name.toLowerCase().includes(lowerPattern)) {
+                results.push({ name, value });
+            }
+        }
+        return results.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /** Get summary stats */
+    getSummary() {
+        const categories = {};
+        for (const [cat, tokens] of this.tokensByCategory) {
+            categories[cat] = tokens.length;
+        }
+        return {
+            totalTokens: this.tokens.length,
+            totalCssVariables: this.cssVariables.size,
+            categories,
+        };
+    }
+}
+//# sourceMappingURL=token-store.js.map

package/dist/token-store.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MCP Tools for the Red Sift Design System.
+ *
+ * Provides search, lookup, usage, and code generation capabilities
+ * for AI assistants working with the design system.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DataStore } from './data-store.js';
+import type { TokenStore } from './token-store.js';
+import type { PatternStore } from './pattern-store.js';
+/**
+ * Register all MCP tools on the server.
+ */
+export declare function registerTools(server: McpServer, store: DataStore, tokenStore: TokenStore, patternStore: PatternStore): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAuCvD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,GACzB,IAAI,CAoiBN"}