@taiga-ui/mcp 0.2.1 → 0.2.2

package/dist/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { start } from './server/server.js';
+import { logError } from './utils/logger.js';
+start().catch((err) => {
+    logError('Unhandled startup error', err);
+    process.exit(1);
+});
+//# 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,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAE3C,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC3B,QAAQ,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAEzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/schemas/doc-types.js

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

package/dist/schemas/doc-types.js.map

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

package/dist/server/fetch.js

@@ -0,0 +1,33 @@
+import { parseContent } from '../utils/parse-content.js';
+import { state } from './server.js';
+// 6-hour refresh window
+const REFRESH_INTERVAL_MS = 6 * 60 * 60 * 1000;
+export async function fetchSource() {
+    const argProvidedUrl = process.argv
+        .find((arg) => arg.startsWith('--source-url='))
+        ?.split('=')[1];
+    const sourceUrl = argProvidedUrl ?? process.env.SOURCE_URL;
+    if (!sourceUrl) {
+        throw new Error('Source URL not provided. Set SOURCE_URL or pass --source-url=...');
+    }
+    const response = await fetch(sourceUrl).catch((error) => {
+        throw new Error(`Network error fetching documentation source: ${error instanceof Error ? error.message : String(error)}`);
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch documentation (HTTP ${response.status} ${response.statusText}) from ${sourceUrl}`);
+    }
+    const content = await response.text();
+    if (!content.trim()) {
+        throw new Error(`Fetched documentation from ${sourceUrl} is empty.`);
+    }
+    return { url: sourceUrl, content };
+}
+export async function ensureSourceLoaded() {
+    const isContentStale = !state.lastLoadedAt || Date.now() - state.lastLoadedAt > REFRESH_INTERVAL_MS;
+    if (!state.sections.length || isContentStale) {
+        const { url, content } = await fetchSource();
+        parseContent(content, url);
+        state.lastLoadedAt = Date.now();
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/server/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/server/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAC;AAElC,wBAAwB;AACxB,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC7B,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI;SAC9B,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAC/C,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpB,MAAM,SAAS,GAAG,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAE3D,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,kEAAkE,CACrE,CAAC;IACN,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC7D,MAAM,IAAI,KAAK,CACX,gDAAgD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3G,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACX,uCAAuC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,UAAU,SAAS,EAAE,CACrG,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEtC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,SAAS,YAAY,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,EAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACpC,MAAM,cAAc,GAChB,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,GAAG,mBAAmB,CAAC;IAEjF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,EAAC,GAAG,EAAE,OAAO,EAAC,GAAG,MAAM,WAAW,EAAE,CAAC;QAE3C,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE3B,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;AACL,CAAC"}

package/dist/server/server.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import packageJson from '../../package.json' with { type: 'json' };
+import { registerAllTools } from '../tools/index.js';
+import { logError, logInfo } from '../utils/logger.js';
+import { ensureSourceLoaded } from './fetch.js';
+export const state = {
+    sections: [],
+    overview: undefined,
+    migrationGuide: undefined,
+    sourceUrl: undefined,
+    lastLoadedAt: undefined,
+};
+const server = new McpServer({
+    name: 'taiga-ui-mcp',
+    version: packageJson.version,
+}, {
+    capabilities: { tools: {} },
+    instructions: `
+<General Purpose>
+This server provides programmatic access to Taiga UI component documentation for AI assistants.
+Use these tools to discover, understand, and retrieve usage examples for Taiga UI components.
+</General Purpose>
+
+<Core Workflows & Tool Guide>
+* **1. Get Documentation Overview (Start Here):** Always begin by calling \`get_overview\` to retrieve the structured documentation header with installation instructions, critical notices, and general guidance.
+
+* **2. Discover Components:** Call \`get_list_components\` to see all available Taiga UI components. Use the optional \`query\` parameter for fuzzy filtering to find specific components.
+
+* **3. Get Component Examples:** Once you identify needed component(s), call \`get_component_example\` with component name(s) to retrieve full documentation and code examples.
+
+* **4. Get Migration Guide:** Call \`get_migration_guide\` for step-by-step migration instructions, troubleshooting, and common issues when updating Taiga UI versions.
+</Core Workflows & Tool Guide>
+
+<Key Concepts>
+* **Component Categories:** Components are organized by category (UI elements, forms, layouts, etc.)
+* **Packages:** Components belong to different packages (CORE, KIT, etc.)
+* **Fuzzy Matching:** Component queries support fuzzy matching for flexible searching.
+</Key Concepts>
+`,
+});
+registerAllTools(server);
+export async function start() {
+    try {
+        await ensureSourceLoaded();
+    }
+    catch (error) {
+        logError('Initial source load failed', error);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logInfo(`Angular Taiga UI MCP Server running. Fetched source components: ${state.sections.length}`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,oBAAoB,EAAC,MAAM,2CAA2C,CAAC;AAE/E,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAM,IAAI,EAAE,MAAM,EAAC,CAAC;AAEjE,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAU9C,MAAM,CAAC,MAAM,KAAK,GAAe;IAC7B,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,SAAS;IACnB,cAAc,EAAE,SAAS;IACzB,SAAS,EAAE,SAAS;IACpB,YAAY,EAAE,SAAS;CAC1B,CAAC;AAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CACxB;IACI,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC/B,EACD;IACI,YAAY,EAAE,EAAC,KAAK,EAAE,EAAE,EAAC;IACzB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBrB;CACI,CACJ,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,KAAK;IACvB,IAAI,CAAC;QACD,MAAM,kBAAkB,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,QAAQ,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CACH,mEAAmE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAC7F,CAAC;AACN,CAAC"}

package/dist/tools/get-component-example.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { ensureSourceLoaded } from '../server/fetch.js';
+import { buildQueryResults } from '../utils/query-results.js';
+export function registerGetComponentExampleTool(server) {
+    server.registerTool('get_component_example', {
+        title: 'Get Component Example',
+        description: 'Return section-related content snippets (formerly examples) for specified documentation section name(s). The presence of id indicates a successful match.',
+        inputSchema: { names: z.array(z.string().min(2)).min(1) },
+        outputSchema: {
+            results: z.array(z.object({
+                query: z.string(),
+                id: z.string().optional(),
+                package: z.string().nullable().optional(),
+                type: z.string().nullable().optional(),
+                suggestions: z.array(z.string()).optional(),
+                content: z.array(z.string()).optional(),
+            })),
+            matched: z.number(),
+        },
+    }, async ({ names }) => {
+        if (!names.length) {
+            const output = { error: 'Provide at least one name in names array.' };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        await ensureSourceLoaded();
+        const { results, matches } = buildQueryResults(names);
+        const output = { results, matched: matches };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=get-component-example.js.map

package/dist/tools/get-component-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-example.js","sourceRoot":"","sources":["../../src/tools/get-component-example.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAE5D,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACf,uBAAuB,EACvB;QACI,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACP,2JAA2J;QAC/J,WAAW,EAAE,EAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAC;QACvD,YAAY,EAAE;YACV,OAAO,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;gBACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;gBACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;gBACtC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;aAC1C,CAAC,CACL;YACD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB;KACJ,EACD,KAAK,EAAE,EAAC,KAAK,EAAoB,EAAE,EAAE;QACjC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,EAAC,KAAK,EAAE,2CAA2C,EAAC,CAAC;YAEpE,OAAO;gBACH,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAC,CAAC;gBAChE,iBAAiB,EAAE,MAAM;aAC5B,CAAC;QACN,CAAC;QAED,MAAM,kBAAkB,EAAE,CAAC;QAE3B,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,EAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAC,CAAC;QAE3C,OAAO;YACH,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAC,CAAC;YAChE,iBAAiB,EAAE,MAAM;SAC5B,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/get-list-components.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { ensureSourceLoaded } from '../server/fetch.js';
+import { constructComponentsList } from '../utils/list-components.js';
+export function registerGetListComponentsTool(server) {
+    server.registerTool('get_list_components', {
+        title: 'List Components',
+        description: 'List all Taiga UI documentation section IDs (structured JSON only).',
+        inputSchema: { query: z.string().optional().default('') },
+        outputSchema: {
+            items: z.array(z.object({
+                id: z.string(),
+                name: z.string(),
+                category: z.string(),
+                package: z.string().nullable(),
+                type: z.string().nullable(),
+            })),
+        },
+    }, async ({ query }) => {
+        await ensureSourceLoaded();
+        const output = { items: constructComponentsList(query) };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=get-list-components.js.map

package/dist/tools/get-list-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-list-components.js","sourceRoot":"","sources":["../../src/tools/get-list-components.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAC,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AAEpE,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACf,qBAAqB,EACrB;QACI,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACP,qEAAqE;QACzE,WAAW,EAAE,EAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAC;QACvD,YAAY,EAAE;YACV,KAAK,EAAE,CAAC,CAAC,KAAK,CACV,CAAC,CAAC,MAAM,CAAC;gBACL,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;gBACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;gBACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC9B,CAAC,CACL;SACJ;KACJ,EACD,KAAK,EAAE,EAAC,KAAK,EAAmB,EAAE,EAAE;QAChC,MAAM,kBAAkB,EAAE,CAAC;QAE3B,MAAM,MAAM,GAAG,EAAC,KAAK,EAAE,uBAAuB,CAAC,KAAK,CAAC,EAAC,CAAC;QAEvD,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC;aACJ;YACD,iBAAiB,EAAE,MAAM;SAC5B,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/get-migration-guide.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { ensureSourceLoaded } from '../server/fetch.js';
+import { state } from '../server/server.js';
+import { parseMigrationGuide } from '../utils/extract-migration-guide.js';
+export function registerGetMigrationGuideTool(server) {
+    server.registerTool('get_migration_guide', {
+        title: 'Get Migration Guide',
+        description: 'Returns the complete Migration Guide for Taiga UI updates. Includes step-by-step migration instructions, troubleshooting, and common issues. Call this tool when you need to migrate between Taiga UI versions.',
+        inputSchema: z.object({}).optional(),
+        outputSchema: {
+            title: z.string(),
+            introduction: z.array(z.string()),
+            sections: z.array(z.object({
+                title: z.string(),
+                content: z.array(z.string()),
+                codeBlocks: z.array(z.string()).optional(),
+                subsections: z
+                    .array(z.object({
+                    title: z.string(),
+                    content: z.array(z.string()),
+                    codeBlocks: z.array(z.string()).optional(),
+                }))
+                    .optional(),
+            })),
+        },
+    }, async () => {
+        await ensureSourceLoaded();
+        if (!state.migrationGuide?.trim()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Migration Guide is not available. Ensure the source file contains the Migration Guide section.',
+                    },
+                ],
+            };
+        }
+        const parsed = parseMigrationGuide(state.migrationGuide);
+        const output = {
+            title: parsed.title,
+            introduction: parsed.introduction,
+            sections: parsed.sections.map((section) => {
+                const sectionData = {
+                    title: section.title,
+                    content: section.content,
+                };
+                if (section.codeBlocks && section.codeBlocks.length > 0) {
+                    sectionData.codeBlocks = section.codeBlocks;
+                }
+                if (section.subsections && section.subsections.length > 0) {
+                    sectionData.subsections = section.subsections.map((sub) => {
+                        const subData = {
+                            title: sub.title,
+                            content: sub.content,
+                        };
+                        if (sub.codeBlocks && sub.codeBlocks.length > 0) {
+                            subData.codeBlocks = sub.codeBlocks;
+                        }
+                        return subData;
+                    });
+                }
+                return sectionData;
+            }),
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# 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":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAC,mBAAmB,EAAC,MAAM,qCAAqC,CAAC;AAExE,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACf,qBAAqB,EACrB;QACI,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACP,iNAAiN;QACrN,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACpC,YAAY,EAAE;YACV,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;gBACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC5B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAC1C,WAAW,EAAE,CAAC;qBACT,KAAK,CACF,CAAC,CAAC,MAAM,CAAC;oBACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;oBAC5B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;iBAC7C,CAAC,CACL;qBACA,QAAQ,EAAE;aAClB,CAAC,CACL;SACJ;KACJ,EACD,KAAK,IAAI,EAAE;QACP,MAAM,kBAAkB,EAAE,CAAC;QAE3B,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;YAChC,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gGAAgG;qBACzG;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAEzD,MAAM,MAAM,GAA4B;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACtC,MAAM,WAAW,GAA4B;oBACzC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;iBAC3B,CAAC;gBAEF,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtD,WAAW,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;gBAChD,CAAC;gBAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxD,WAAW,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;wBACtD,MAAM,OAAO,GAA4B;4BACrC,KAAK,EAAE,GAAG,CAAC,KAAK;4BAChB,OAAO,EAAE,GAAG,CAAC,OAAO;yBACvB,CAAC;wBAEF,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC9C,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;wBACxC,CAAC;wBAED,OAAO,OAAO,CAAC;oBACnB,CAAC,CAAC,CAAC;gBACP,CAAC;gBAED,OAAO,WAAW,CAAC;YACvB,CAAC,CAAC;SACL,CAAC;QAEF,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC;aACJ;YACD,iBAAiB,EAAE,MAAM;SAC5B,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/get-overview.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { ensureSourceLoaded } from '../server/fetch.js';
+import { state } from '../server/server.js';
+import { parseHeaderSections, } from '../utils/extract-header.js';
+export function registerGetOverviewTool(server) {
+    server.registerTool('get_overview', {
+        title: 'Get Documentation Overview',
+        description: 'Call this tool FIRST to retrieve the fully structured documentation header as JSON. Returns hierarchical sections with parsed content (no raw markdown). Includes installation instructions, critical notices, and subsections with their content and code blocks. This provides essential context before exploring specific components.',
+        inputSchema: z.object({}).optional(),
+        outputSchema: {
+            title: z.string(),
+            sections: z.array(z.object({
+                title: z.string(),
+                description: z.string().optional(),
+                criticalNotices: z.array(z.string()),
+                subsections: z.array(z.object({
+                    title: z.string(),
+                    content: z.array(z.string()),
+                    sections: z
+                        .array(z.object({
+                        section: z.string(),
+                        code: z.string().optional(),
+                    }))
+                        .optional(),
+                    items: z
+                        .array(z.object({
+                        title: z.string(),
+                        content: z.array(z.string()),
+                        code: z.string().optional(),
+                        sections: z
+                            .array(z.object({
+                            section: z.string(),
+                            code: z.string().optional(),
+                        }))
+                            .optional(),
+                    }))
+                        .optional(),
+                })),
+            })),
+            totalComponents: z.number(),
+            sourceUrl: z.string().optional(),
+        },
+    }, async () => {
+        await ensureSourceLoaded();
+        const headerInfo = state.overview
+            ? parseHeaderSections(state.overview)
+            : {
+                title: 'Taiga UI Documentation',
+                sections: [],
+            };
+        const output = {
+            title: headerInfo.title,
+            sections: headerInfo.sections.map((section) => {
+                const sectionData = { title: section.title };
+                if (section.description) {
+                    sectionData.description = section.description;
+                }
+                sectionData.criticalNotices = section.criticalNotices;
+                sectionData.subsections = section.subsections.map((sub) => {
+                    const subData = {
+                        title: sub.title,
+                        content: sub.content,
+                    };
+                    // Only include sections if not empty
+                    if (sub.sections && sub.sections.length > 0) {
+                        subData.sections = sub.sections;
+                    }
+                    // Only include items if not empty
+                    if (sub.items && sub.items.length > 0) {
+                        subData.items = sub.items.map((item) => {
+                            const itemData = {
+                                title: item.title,
+                                content: item.content,
+                            };
+                            if (item.code) {
+                                itemData.code = item.code;
+                            }
+                            if (item.sections && item.sections.length > 0) {
+                                itemData.sections = item.sections;
+                            }
+                            return itemData;
+                        });
+                    }
+                    return subData;
+                });
+                return sectionData;
+            }),
+            totalComponents: state.sections.length,
+            sourceUrl: state.sourceUrl,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=get-overview.js.map

package/dist/tools/get-overview.js.map

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

package/dist/tools/index.js

@@ -0,0 +1,11 @@
+import { registerGetComponentExampleTool } from './get-component-example.js';
+import { registerGetListComponentsTool } from './get-list-components.js';
+import { registerGetMigrationGuideTool } from './get-migration-guide.js';
+import { registerGetOverviewTool } from './get-overview.js';
+export function registerAllTools(server) {
+    registerGetOverviewTool(server);
+    registerGetListComponentsTool(server);
+    registerGetComponentExampleTool(server);
+    registerGetMigrationGuideTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,+BAA+B,EAAC,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAC,6BAA6B,EAAC,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAC,6BAA6B,EAAC,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAC,uBAAuB,EAAC,MAAM,mBAAmB,CAAC;AAE1D,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAC9C,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,6BAA6B,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}