@maz-ui/mcp 5.0.1-beta.0 → 5.1.0-beta.1

package/dist/index.d.mts

@@ -0,0 +1,345 @@
+export { main, runCli } from './cli.mjs';
+import { z, ZodRawShape } from 'zod';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { AgentTarget, SetupAgentsOptions, SetupAgentsResult, setupAgents } from '@maz-ui/node';
+
+declare const docCategories: readonly ["guide", "component", "composable", "directive", "plugin", "ecosystem", "util", "node", "reference"];
+type DocCategory = typeof docCategories[number];
+declare const docEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    category: z.ZodEnum<{
+        guide: "guide";
+        component: "component";
+        composable: "composable";
+        directive: "directive";
+        plugin: "plugin";
+        ecosystem: "ecosystem";
+        util: "util";
+        node: "node";
+        reference: "reference";
+    }>;
+    slug: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    package: z.ZodString;
+    file: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    symbols: z.ZodArray<z.ZodString>;
+    imports: z.ZodArray<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    headings: z.ZodArray<z.ZodString>;
+    related: z.ZodArray<z.ZodString>;
+    chars: z.ZodNumber;
+}, z.core.$strip>;
+declare const componentApiSchema: z.ZodObject<{
+    name: z.ZodString;
+    docId: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    import: z.ZodString;
+    parent: z.ZodOptional<z.ZodString>;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodBoolean;
+        default: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        strictValues: z.ZodBoolean;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    events: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        payload: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    slots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        bindings: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    expose: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const manifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    name: z.ZodLiteral<"maz-ui">;
+    version: z.ZodString;
+    homepage: z.ZodString;
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        docId: z.ZodString;
+    }, z.core.$strip>>;
+    docs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodEnum<{
+            guide: "guide";
+            component: "component";
+            composable: "composable";
+            directive: "directive";
+            plugin: "plugin";
+            ecosystem: "ecosystem";
+            util: "util";
+            node: "node";
+            reference: "reference";
+        }>;
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        package: z.ZodString;
+        file: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        symbols: z.ZodArray<z.ZodString>;
+        imports: z.ZodArray<z.ZodString>;
+        aliases: z.ZodArray<z.ZodString>;
+        headings: z.ZodArray<z.ZodString>;
+        related: z.ZodArray<z.ZodString>;
+        chars: z.ZodNumber;
+    }, z.core.$strip>>;
+    components: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        docId: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        import: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        props: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodBoolean;
+            default: z.ZodOptional<z.ZodString>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            strictValues: z.ZodBoolean;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        events: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            payload: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        slots: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            bindings: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        expose: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    icons: z.ZodObject<{
+        package: z.ZodString;
+        names: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    tailwind: z.ZodObject<{
+        entries: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+        colors: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            variable: z.ZodString;
+            foreground: z.ZodBoolean;
+            scale: z.ZodArray<z.ZodString>;
+            usage: z.ZodString;
+        }, z.core.$strip>>;
+        radius: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        shadows: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        breakpoints: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        zIndex: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        fonts: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        durations: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        easings: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        spacing: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        utilities: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            css: z.ZodString;
+        }, z.core.$strip>>;
+        variants: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        containerVariables: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        transitions: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type DocEntry = z.infer<typeof docEntrySchema>;
+type ComponentApi = z.infer<typeof componentApiSchema>;
+type Manifest = z.infer<typeof manifestSchema>;
+
+type KnowledgeSourceKind = 'custom' | 'project' | 'bundled';
+interface KnowledgeSource {
+    kind: KnowledgeSourceKind;
+    /** Directory of the bundle (`.../docs`) */
+    directory: string;
+    /** maz-ui version installed in the project, when found */
+    projectVersion?: string;
+}
+interface LoadKnowledgeOptions {
+    /** Explicit bundle directory (takes precedence over everything) */
+    docsDir?: string;
+    /** Project root used to find the installed maz-ui (defaults to `process.cwd()`) */
+    cwd?: string;
+    /** Bundle shipped with @maz-ui/mcp */
+    bundledDir?: string;
+    /** Version of the bundled docs, default: the version of @maz-ui/mcp (released together with maz-ui) */
+    bundledVersion?: string;
+}
+declare class Knowledge {
+    readonly manifest: Manifest;
+    readonly source: KnowledgeSource;
+    private readonly documentedVersion;
+    readonly docsById: Map<string, DocEntry>;
+    readonly componentsByName: Map<string, ComponentApi>;
+    readonly iconNames: Set<string>;
+    private readonly cache;
+    /**
+     * @param manifest manifest of the docs bundle
+     * @param source where the bundle was found
+     * @param documentedVersion version of the documented maz-ui, read from a package.json at runtime when possible: the
+     * docs are generated before the release bumps the version, so `manifest.version` can be the previous one
+     */
+    constructor(manifest: Manifest, source: KnowledgeSource, documentedVersion?: string);
+    get version(): string;
+    get docs(): DocEntry[];
+    readDoc(id: string): string;
+    readFile(relativePath: string): string | undefined;
+}
+/** Finds the maz-ui package installed in the project, monorepo workspace folders included */
+declare function findProjectMazUi(cwd: string): {
+    directory: string;
+    version: string;
+} | undefined;
+declare function loadKnowledge(options?: LoadKnowledgeOptions): Knowledge;
+
+interface SearchOptions {
+    category?: DocCategory;
+    limit?: number;
+}
+interface SearchHit {
+    doc: DocEntry;
+    score: number;
+    /** Query terms found in the doc */
+    matched: string[];
+}
+declare class DocSearch {
+    private readonly knowledge;
+    private readonly index;
+    private readonly synonyms;
+    constructor(knowledge: Knowledge);
+    private toIndexed;
+    private exactMatch;
+    search(query: string, { category, limit }?: SearchOptions): SearchHit[];
+}
+/** Icon search over the `@maz-ui/icons` names, with English keywords and country names for flags */
+declare function searchIcons(names: Iterable<string>, query: string, limit?: number): string[];
+
+interface ServerContext {
+    knowledge: Knowledge;
+    search: DocSearch;
+    /** Directory used to resolve relative file paths (review_code) */
+    cwd: string;
+}
+interface CreateContextOptions extends LoadKnowledgeOptions {
+    knowledge?: Knowledge;
+}
+declare function createContext(options?: CreateContextOptions): ServerContext;
+
+declare function buildInstructions(context: ServerContext): string;
+
+type Severity = 'error' | 'warning' | 'info';
+type RuleId = 'unknown-component' | 'unknown-prop' | 'invalid-prop-value' | 'boolean-prop-string' | 'unknown-model' | 'unknown-event' | 'unknown-slot' | 'unknown-icon' | 'prefer-maz-component' | 'inline-svg' | 'internal-prefix' | 'theme-colors' | 'hardcoded-color' | 'tailwind-v3' | 'root-import' | 'internal-import' | 'prefer-ecosystem' | 'manual-dark-mode' | 'prefer-utils' | 'nuxt-auto-import' | 'missing-reference';
+interface Finding {
+    rule: RuleId;
+    severity: Severity;
+    message: string;
+    line: number;
+    column: number;
+    /** Concrete fix */
+    suggestion?: string;
+}
+type Framework = 'vue' | 'nuxt';
+interface ReviewOptions {
+    knowledge: Knowledge;
+    /** Used to pick the parser (`.vue`, `.ts`, `.css`...) */
+    filename?: string;
+    /** `nuxt` reports explicit imports of auto-imported components and composables */
+    framework?: Framework;
+}
+
+declare function reviewCode(code: string, options: ReviewOptions): Finding[];
+declare function countBySeverity(findings: Finding[]): Record<Severity, number>;
+declare function filterBySeverity(findings: Finding[], minimum: Severity): Finding[];
+declare function formatFindings(findings: Finding[], label: string): string;
+
+interface FileReview {
+    file: string;
+    findings: Finding[];
+}
+interface ReviewFilesOptions {
+    knowledge: Knowledge;
+    cwd: string;
+    framework?: Framework;
+    minSeverity?: Severity;
+}
+declare function reviewFiles(patterns: string[], { knowledge, cwd, framework, minSeverity }: ReviewFilesOptions): Promise<{
+    reviews: FileReview[];
+    truncated: boolean;
+}>;
+
+interface ToolDefinition<Shape extends ZodRawShape = ZodRawShape> {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Shape;
+    /** Returns markdown for the agent */
+    run: (context: ServerContext, args: any) => string | Promise<string>;
+}
+
+/** Tools in a stable order (prompt caching on the client side) */
+declare const TOOLS: ToolDefinition[];
+declare function createMazUiMcpServer(options?: CreateContextOptions): {
+    server: McpServer;
+    context: ServerContext;
+};
+declare function startStdioServer(options?: CreateContextOptions): Promise<McpServer>;
+
+export { DocSearch, Knowledge, TOOLS, buildInstructions, countBySeverity, createContext, createMazUiMcpServer, filterBySeverity, findProjectMazUi, formatFindings, loadKnowledge, reviewCode, reviewFiles, searchIcons, startStdioServer };
+export type { ComponentApi, CreateContextOptions, DocCategory, DocEntry, Finding, Framework, KnowledgeSource, LoadKnowledgeOptions, Manifest, ReviewOptions, RuleId, ServerContext, Severity };

package/dist/index.d.ts

@@ -0,0 +1,345 @@
+export { main, runCli } from './cli.js';
+import { z, ZodRawShape } from 'zod';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { AgentTarget, SetupAgentsOptions, SetupAgentsResult, setupAgents } from '@maz-ui/node';
+
+declare const docCategories: readonly ["guide", "component", "composable", "directive", "plugin", "ecosystem", "util", "node", "reference"];
+type DocCategory = typeof docCategories[number];
+declare const docEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    category: z.ZodEnum<{
+        guide: "guide";
+        component: "component";
+        composable: "composable";
+        directive: "directive";
+        plugin: "plugin";
+        ecosystem: "ecosystem";
+        util: "util";
+        node: "node";
+        reference: "reference";
+    }>;
+    slug: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    package: z.ZodString;
+    file: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    symbols: z.ZodArray<z.ZodString>;
+    imports: z.ZodArray<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    headings: z.ZodArray<z.ZodString>;
+    related: z.ZodArray<z.ZodString>;
+    chars: z.ZodNumber;
+}, z.core.$strip>;
+declare const componentApiSchema: z.ZodObject<{
+    name: z.ZodString;
+    docId: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    import: z.ZodString;
+    parent: z.ZodOptional<z.ZodString>;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodBoolean;
+        default: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        strictValues: z.ZodBoolean;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    events: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        payload: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    slots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        bindings: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    expose: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const manifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    name: z.ZodLiteral<"maz-ui">;
+    version: z.ZodString;
+    homepage: z.ZodString;
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        docId: z.ZodString;
+    }, z.core.$strip>>;
+    docs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodEnum<{
+            guide: "guide";
+            component: "component";
+            composable: "composable";
+            directive: "directive";
+            plugin: "plugin";
+            ecosystem: "ecosystem";
+            util: "util";
+            node: "node";
+            reference: "reference";
+        }>;
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        package: z.ZodString;
+        file: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        symbols: z.ZodArray<z.ZodString>;
+        imports: z.ZodArray<z.ZodString>;
+        aliases: z.ZodArray<z.ZodString>;
+        headings: z.ZodArray<z.ZodString>;
+        related: z.ZodArray<z.ZodString>;
+        chars: z.ZodNumber;
+    }, z.core.$strip>>;
+    components: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        docId: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        import: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        props: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodBoolean;
+            default: z.ZodOptional<z.ZodString>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            strictValues: z.ZodBoolean;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        events: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            payload: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        slots: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            bindings: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        expose: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    icons: z.ZodObject<{
+        package: z.ZodString;
+        names: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    tailwind: z.ZodObject<{
+        entries: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+        colors: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            variable: z.ZodString;
+            foreground: z.ZodBoolean;
+            scale: z.ZodArray<z.ZodString>;
+            usage: z.ZodString;
+        }, z.core.$strip>>;
+        radius: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        shadows: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        breakpoints: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        zIndex: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        fonts: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        durations: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        easings: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        spacing: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        utilities: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            css: z.ZodString;
+        }, z.core.$strip>>;
+        variants: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        containerVariables: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        transitions: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type DocEntry = z.infer<typeof docEntrySchema>;
+type ComponentApi = z.infer<typeof componentApiSchema>;
+type Manifest = z.infer<typeof manifestSchema>;
+
+type KnowledgeSourceKind = 'custom' | 'project' | 'bundled';
+interface KnowledgeSource {
+    kind: KnowledgeSourceKind;
+    /** Directory of the bundle (`.../docs`) */
+    directory: string;
+    /** maz-ui version installed in the project, when found */
+    projectVersion?: string;
+}
+interface LoadKnowledgeOptions {
+    /** Explicit bundle directory (takes precedence over everything) */
+    docsDir?: string;
+    /** Project root used to find the installed maz-ui (defaults to `process.cwd()`) */
+    cwd?: string;
+    /** Bundle shipped with @maz-ui/mcp */
+    bundledDir?: string;
+    /** Version of the bundled docs, default: the version of @maz-ui/mcp (released together with maz-ui) */
+    bundledVersion?: string;
+}
+declare class Knowledge {
+    readonly manifest: Manifest;
+    readonly source: KnowledgeSource;
+    private readonly documentedVersion;
+    readonly docsById: Map<string, DocEntry>;
+    readonly componentsByName: Map<string, ComponentApi>;
+    readonly iconNames: Set<string>;
+    private readonly cache;
+    /**
+     * @param manifest manifest of the docs bundle
+     * @param source where the bundle was found
+     * @param documentedVersion version of the documented maz-ui, read from a package.json at runtime when possible: the
+     * docs are generated before the release bumps the version, so `manifest.version` can be the previous one
+     */
+    constructor(manifest: Manifest, source: KnowledgeSource, documentedVersion?: string);
+    get version(): string;
+    get docs(): DocEntry[];
+    readDoc(id: string): string;
+    readFile(relativePath: string): string | undefined;
+}
+/** Finds the maz-ui package installed in the project, monorepo workspace folders included */
+declare function findProjectMazUi(cwd: string): {
+    directory: string;
+    version: string;
+} | undefined;
+declare function loadKnowledge(options?: LoadKnowledgeOptions): Knowledge;
+
+interface SearchOptions {
+    category?: DocCategory;
+    limit?: number;
+}
+interface SearchHit {
+    doc: DocEntry;
+    score: number;
+    /** Query terms found in the doc */
+    matched: string[];
+}
+declare class DocSearch {
+    private readonly knowledge;
+    private readonly index;
+    private readonly synonyms;
+    constructor(knowledge: Knowledge);
+    private toIndexed;
+    private exactMatch;
+    search(query: string, { category, limit }?: SearchOptions): SearchHit[];
+}
+/** Icon search over the `@maz-ui/icons` names, with English keywords and country names for flags */
+declare function searchIcons(names: Iterable<string>, query: string, limit?: number): string[];
+
+interface ServerContext {
+    knowledge: Knowledge;
+    search: DocSearch;
+    /** Directory used to resolve relative file paths (review_code) */
+    cwd: string;
+}
+interface CreateContextOptions extends LoadKnowledgeOptions {
+    knowledge?: Knowledge;
+}
+declare function createContext(options?: CreateContextOptions): ServerContext;
+
+declare function buildInstructions(context: ServerContext): string;
+
+type Severity = 'error' | 'warning' | 'info';
+type RuleId = 'unknown-component' | 'unknown-prop' | 'invalid-prop-value' | 'boolean-prop-string' | 'unknown-model' | 'unknown-event' | 'unknown-slot' | 'unknown-icon' | 'prefer-maz-component' | 'inline-svg' | 'internal-prefix' | 'theme-colors' | 'hardcoded-color' | 'tailwind-v3' | 'root-import' | 'internal-import' | 'prefer-ecosystem' | 'manual-dark-mode' | 'prefer-utils' | 'nuxt-auto-import' | 'missing-reference';
+interface Finding {
+    rule: RuleId;
+    severity: Severity;
+    message: string;
+    line: number;
+    column: number;
+    /** Concrete fix */
+    suggestion?: string;
+}
+type Framework = 'vue' | 'nuxt';
+interface ReviewOptions {
+    knowledge: Knowledge;
+    /** Used to pick the parser (`.vue`, `.ts`, `.css`...) */
+    filename?: string;
+    /** `nuxt` reports explicit imports of auto-imported components and composables */
+    framework?: Framework;
+}
+
+declare function reviewCode(code: string, options: ReviewOptions): Finding[];
+declare function countBySeverity(findings: Finding[]): Record<Severity, number>;
+declare function filterBySeverity(findings: Finding[], minimum: Severity): Finding[];
+declare function formatFindings(findings: Finding[], label: string): string;
+
+interface FileReview {
+    file: string;
+    findings: Finding[];
+}
+interface ReviewFilesOptions {
+    knowledge: Knowledge;
+    cwd: string;
+    framework?: Framework;
+    minSeverity?: Severity;
+}
+declare function reviewFiles(patterns: string[], { knowledge, cwd, framework, minSeverity }: ReviewFilesOptions): Promise<{
+    reviews: FileReview[];
+    truncated: boolean;
+}>;
+
+interface ToolDefinition<Shape extends ZodRawShape = ZodRawShape> {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Shape;
+    /** Returns markdown for the agent */
+    run: (context: ServerContext, args: any) => string | Promise<string>;
+}
+
+/** Tools in a stable order (prompt caching on the client side) */
+declare const TOOLS: ToolDefinition[];
+declare function createMazUiMcpServer(options?: CreateContextOptions): {
+    server: McpServer;
+    context: ServerContext;
+};
+declare function startStdioServer(options?: CreateContextOptions): Promise<McpServer>;
+
+export { DocSearch, Knowledge, TOOLS, buildInstructions, countBySeverity, createContext, createMazUiMcpServer, filterBySeverity, findProjectMazUi, formatFindings, loadKnowledge, reviewCode, reviewFiles, searchIcons, startStdioServer };
+export type { ComponentApi, CreateContextOptions, DocCategory, DocEntry, Finding, Framework, KnowledgeSource, LoadKnowledgeOptions, Manifest, ReviewOptions, RuleId, ServerContext, Severity };