tailwindcss-docs-mcp 1.0.0

package/dist/tools/search-docs.d.ts

@@ -0,0 +1,44 @@
+import type { Embedder } from "../pipeline/embedder.js";
+import type { Database } from "../storage/database.js";
+import { type SearchResult } from "../storage/search.js";
+import type { TailwindVersion } from "../utils/config.js";
+/**
+ * Input parameters for the search_docs MCP tool.
+ */
+export interface SearchDocsInput {
+    /** Natural language search query */
+    query: string;
+    /** Tailwind CSS major version to search (default: "v4") */
+    version?: TailwindVersion;
+    /** Maximum number of results (default: 5, min: 1, max: 20) */
+    limit?: number;
+}
+/**
+ * Result from the search_docs handler, including metadata about index state.
+ */
+export interface SearchDocsResult {
+    results: SearchResult[];
+    notIndexed: boolean;
+}
+/**
+ * Handle the `search_docs` MCP tool call.
+ *
+ * Performs hybrid semantic + keyword search:
+ * 1. Embed the query (with snowflake-arctic-embed-xs query prefix)
+ * 2. Cosine similarity against in-memory chunk embeddings
+ * 3. FTS5 keyword search for exact class names
+ * 4. Merge, deduplicate, and rank results
+ *
+ * Returns an error message if the index has not been built yet.
+ */
+export declare function handleSearchDocs(input: SearchDocsInput, db: Database, embedder: Embedder, defaultVersion: TailwindVersion): Promise<SearchDocsResult>;
+/**
+ * Format search results as markdown for LLM consumption.
+ *
+ * Each result includes:
+ * - Heading breadcrumb
+ * - Content snippet
+ * - Deep link to tailwindcss.com
+ */
+export declare function formatSearchResults(result: SearchDocsResult): string;
+//# sourceMappingURL=search-docs.d.ts.map

package/dist/tools/search-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,eAAe,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoBpE"}

package/dist/tools/search-docs.js

@@ -0,0 +1,53 @@
+import { hybridSearch } from "../storage/search.js";
+/**
+ * Handle the `search_docs` MCP tool call.
+ *
+ * Performs hybrid semantic + keyword search:
+ * 1. Embed the query (with snowflake-arctic-embed-xs query prefix)
+ * 2. Cosine similarity against in-memory chunk embeddings
+ * 3. FTS5 keyword search for exact class names
+ * 4. Merge, deduplicate, and rank results
+ *
+ * Returns an error message if the index has not been built yet.
+ */
+export async function handleSearchDocs(input, db, embedder, defaultVersion) {
+    const version = input.version ?? defaultVersion;
+    const limit = Math.min(Math.max(input.limit ?? 5, 1), 20);
+    // Check if index exists
+    const status = db.getIndexStatus(version);
+    if (status.length === 0) {
+        return { results: [], notIndexed: true };
+    }
+    const results = await hybridSearch(db, embedder, {
+        query: input.query,
+        version,
+        limit,
+    });
+    return { results, notIndexed: false };
+}
+/**
+ * Format search results as markdown for LLM consumption.
+ *
+ * Each result includes:
+ * - Heading breadcrumb
+ * - Content snippet
+ * - Deep link to tailwindcss.com
+ */
+export function formatSearchResults(result) {
+    if (result.notIndexed) {
+        return "Index not built for this version. Run fetch_docs first.";
+    }
+    if (result.results.length === 0) {
+        return "No results found for this query.";
+    }
+    const lines = [];
+    for (let i = 0; i < result.results.length; i++) {
+        const r = result.results[i];
+        lines.push(`## ${i + 1}. ${r.docTitle} — ${r.heading}`);
+        lines.push(`[View on tailwindcss.com](${r.url})\n`);
+        lines.push(r.content);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=search-docs.js.map

package/dist/tools/search-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.js","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAuBvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,EAAY,EACZ,QAAkB,EAClB,cAA+B;IAE/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE1D,wBAAwB;IACxB,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE;QAC/C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO;QACP,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAwB;IAC1D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,yDAAyD,CAAC;IACnE,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/categories.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A single utility category with its documentation pages.
+ */
+export interface UtilityCategory {
+    name: string;
+    description: string;
+    slugs: string[];
+}
+/**
+ * Tailwind CSS utility categories mapped from the official documentation structure.
+ *
+ * Each category groups related utility classes by their purpose.
+ * Slugs correspond to documentation page slugs (e.g., "padding" -> tailwindcss.com/docs/padding).
+ */
+export declare const UTILITY_CATEGORIES: UtilityCategory[];
+/**
+ * Find a category by name (case-insensitive).
+ */
+export declare function findCategory(name: string): UtilityCategory | undefined;
+/**
+ * Find which category a doc slug belongs to.
+ * @internal Used only in tests.
+ */
+export declare function categoryForSlug(slug: string): UtilityCategory | undefined;
+//# sourceMappingURL=categories.d.ts.map

package/dist/utils/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/utils/categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAAe,EA0N/C,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAGtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE"}

package/dist/utils/categories.js

@@ -0,0 +1,240 @@
+/**
+ * Tailwind CSS utility categories mapped from the official documentation structure.
+ *
+ * Each category groups related utility classes by their purpose.
+ * Slugs correspond to documentation page slugs (e.g., "padding" -> tailwindcss.com/docs/padding).
+ */
+export const UTILITY_CATEGORIES = [
+    {
+        name: "Layout",
+        description: "Utilities for controlling layout behavior: display, position, overflow, z-index",
+        slugs: [
+            "aspect-ratio",
+            "container",
+            "columns",
+            "break-after",
+            "break-before",
+            "break-inside",
+            "box-decoration-break",
+            "box-sizing",
+            "display",
+            "float",
+            "clear",
+            "isolation",
+            "object-fit",
+            "object-position",
+            "overflow",
+            "overscroll-behavior",
+            "position",
+            "top-right-bottom-left",
+            "visibility",
+            "z-index",
+        ],
+    },
+    {
+        name: "Flexbox & Grid",
+        description: "Utilities for flexbox and CSS grid layouts",
+        slugs: [
+            "flex-basis",
+            "flex-direction",
+            "flex-wrap",
+            "flex",
+            "flex-grow",
+            "flex-shrink",
+            "order",
+            "grid-template-columns",
+            "grid-column",
+            "grid-template-rows",
+            "grid-row",
+            "grid-auto-flow",
+            "grid-auto-columns",
+            "grid-auto-rows",
+            "gap",
+            "justify-content",
+            "justify-items",
+            "justify-self",
+            "align-content",
+            "align-items",
+            "align-self",
+            "place-content",
+            "place-items",
+            "place-self",
+        ],
+    },
+    {
+        name: "Spacing",
+        description: "Utilities for padding, margin, and space between elements",
+        slugs: ["padding", "margin", "space"],
+    },
+    {
+        name: "Sizing",
+        description: "Utilities for width, height, and min/max sizing",
+        slugs: ["width", "min-width", "max-width", "height", "min-height", "max-height", "size"],
+    },
+    {
+        name: "Typography",
+        description: "Utilities for font, text, and content styling",
+        slugs: [
+            "font-family",
+            "font-size",
+            "font-smoothing",
+            "font-style",
+            "font-weight",
+            "font-variant-numeric",
+            "letter-spacing",
+            "line-clamp",
+            "line-height",
+            "list-style-image",
+            "list-style-position",
+            "list-style-type",
+            "text-align",
+            "text-color",
+            "text-decoration",
+            "text-decoration-color",
+            "text-decoration-style",
+            "text-decoration-thickness",
+            "text-underline-offset",
+            "text-transform",
+            "text-overflow",
+            "text-wrap",
+            "text-indent",
+            "vertical-align",
+            "whitespace",
+            "word-break",
+            "hyphens",
+            "content",
+        ],
+    },
+    {
+        name: "Backgrounds",
+        description: "Utilities for background colors, images, gradients, and positioning",
+        slugs: [
+            "background-attachment",
+            "background-clip",
+            "background-color",
+            "background-origin",
+            "background-position",
+            "background-repeat",
+            "background-size",
+            "background-image",
+            "gradient-color-stops",
+        ],
+    },
+    {
+        name: "Borders",
+        description: "Utilities for border width, color, style, and radius",
+        slugs: [
+            "border-radius",
+            "border-width",
+            "border-color",
+            "border-style",
+            "divide-width",
+            "divide-color",
+            "divide-style",
+            "outline-width",
+            "outline-color",
+            "outline-style",
+            "outline-offset",
+            "ring-width",
+            "ring-color",
+            "ring-offset-width",
+            "ring-offset-color",
+        ],
+    },
+    {
+        name: "Effects",
+        description: "Utilities for shadows, opacity, and blend modes",
+        slugs: ["box-shadow", "box-shadow-color", "opacity", "mix-blend-mode", "background-blend-mode"],
+    },
+    {
+        name: "Filters",
+        description: "Utilities for blur, brightness, contrast, and other filters",
+        slugs: [
+            "blur",
+            "brightness",
+            "contrast",
+            "drop-shadow",
+            "grayscale",
+            "hue-rotate",
+            "invert",
+            "saturate",
+            "sepia",
+            "backdrop-blur",
+            "backdrop-brightness",
+            "backdrop-contrast",
+            "backdrop-grayscale",
+            "backdrop-hue-rotate",
+            "backdrop-invert",
+            "backdrop-opacity",
+            "backdrop-saturate",
+            "backdrop-sepia",
+        ],
+    },
+    {
+        name: "Tables",
+        description: "Utilities for table layout and border behavior",
+        slugs: ["border-collapse", "border-spacing", "table-layout", "caption-side"],
+    },
+    {
+        name: "Transitions & Animation",
+        description: "Utilities for transitions, transforms, and animations",
+        slugs: [
+            "transition-property",
+            "transition-duration",
+            "transition-timing-function",
+            "transition-delay",
+            "animation",
+        ],
+    },
+    {
+        name: "Transforms",
+        description: "Utilities for scale, rotate, translate, and skew",
+        slugs: ["scale", "rotate", "translate", "skew", "transform-origin"],
+    },
+    {
+        name: "Interactivity",
+        description: "Utilities for cursor, user select, scroll behavior, and pointer events",
+        slugs: [
+            "accent-color",
+            "appearance",
+            "cursor",
+            "caret-color",
+            "pointer-events",
+            "resize",
+            "scroll-behavior",
+            "scroll-margin",
+            "scroll-padding",
+            "scroll-snap-align",
+            "scroll-snap-stop",
+            "scroll-snap-type",
+            "touch-action",
+            "user-select",
+            "will-change",
+        ],
+    },
+    {
+        name: "SVG",
+        description: "Utilities for SVG fill and stroke",
+        slugs: ["fill", "stroke", "stroke-width"],
+    },
+    {
+        name: "Accessibility",
+        description: "Utilities for screen readers",
+        slugs: ["screen-readers"],
+    },
+];
+/**
+ * Find a category by name (case-insensitive).
+ */
+export function findCategory(name) {
+    const lower = name.toLowerCase();
+    return UTILITY_CATEGORIES.find((c) => c.name.toLowerCase() === lower);
+}
+/**
+ * Find which category a doc slug belongs to.
+ * @internal Used only in tests.
+ */
+export function categoryForSlug(slug) {
+    return UTILITY_CATEGORIES.find((c) => c.slugs.includes(slug));
+}
+//# sourceMappingURL=categories.js.map

package/dist/utils/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/utils/categories.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iFAAiF;QAC9F,KAAK,EAAE;YACL,cAAc;YACd,WAAW;YACX,SAAS;YACT,aAAa;YACb,cAAc;YACd,cAAc;YACd,sBAAsB;YACtB,YAAY;YACZ,SAAS;YACT,OAAO;YACP,OAAO;YACP,WAAW;YACX,YAAY;YACZ,iBAAiB;YACjB,UAAU;YACV,qBAAqB;YACrB,UAAU;YACV,uBAAuB;YACvB,YAAY;YACZ,SAAS;SACV;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,4CAA4C;QACzD,KAAK,EAAE;YACL,YAAY;YACZ,gBAAgB;YAChB,WAAW;YACX,MAAM;YACN,WAAW;YACX,aAAa;YACb,OAAO;YACP,uBAAuB;YACvB,aAAa;YACb,oBAAoB;YACpB,UAAU;YACV,gBAAgB;YAChB,mBAAmB;YACnB,gBAAgB;YAChB,KAAK;YACL,iBAAiB;YACjB,eAAe;YACf,cAAc;YACd,eAAe;YACf,aAAa;YACb,YAAY;YACZ,eAAe;YACf,aAAa;YACb,YAAY;SACb;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;KACtC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iDAAiD;QAC9D,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC;KACzF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE;YACL,aAAa;YACb,WAAW;YACX,gBAAgB;YAChB,YAAY;YACZ,aAAa;YACb,sBAAsB;YACtB,gBAAgB;YAChB,YAAY;YACZ,aAAa;YACb,kBAAkB;YAClB,qBAAqB;YACrB,iBAAiB;YACjB,YAAY;YACZ,YAAY;YACZ,iBAAiB;YACjB,uBAAuB;YACvB,uBAAuB;YACvB,2BAA2B;YAC3B,uBAAuB;YACvB,gBAAgB;YAChB,eAAe;YACf,WAAW;YACX,aAAa;YACb,gBAAgB;YAChB,YAAY;YACZ,YAAY;YACZ,SAAS;YACT,SAAS;SACV;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,qEAAqE;QAClF,KAAK,EAAE;YACL,uBAAuB;YACvB,iBAAiB;YACjB,kBAAkB;YAClB,mBAAmB;YACnB,qBAAqB;YACrB,mBAAmB;YACnB,iBAAiB;YACjB,kBAAkB;YAClB,sBAAsB;SACvB;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sDAAsD;QACnE,KAAK,EAAE;YACL,eAAe;YACf,cAAc;YACd,cAAc;YACd,cAAc;YACd,cAAc;YACd,cAAc;YACd,cAAc;YACd,eAAe;YACf,eAAe;YACf,eAAe;YACf,gBAAgB;YAChB,YAAY;YACZ,YAAY;YACZ,mBAAmB;YACnB,mBAAmB;SACpB;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iDAAiD;QAC9D,KAAK,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,gBAAgB,EAAE,uBAAuB,CAAC;KAChG;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE;YACL,MAAM;YACN,YAAY;YACZ,UAAU;YACV,aAAa;YACb,WAAW;YACX,YAAY;YACZ,QAAQ;YACR,UAAU;YACV,OAAO;YACP,eAAe;YACf,qBAAqB;YACrB,mBAAmB;YACnB,oBAAoB;YACpB,qBAAqB;YACrB,iBAAiB;YACjB,kBAAkB;YAClB,mBAAmB;YACnB,gBAAgB;SACjB;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,CAAC;KAC7E;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,uDAAuD;QACpE,KAAK,EAAE;YACL,qBAAqB;YACrB,qBAAqB;YACrB,4BAA4B;YAC5B,kBAAkB;YAClB,WAAW;SACZ;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,CAAC;KACpE;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,wEAAwE;QACrF,KAAK,EAAE;YACL,cAAc;YACd,YAAY;YACZ,QAAQ;YACR,aAAa;YACb,gBAAgB;YAChB,QAAQ;YACR,iBAAiB;YACjB,eAAe;YACf,gBAAgB;YAChB,mBAAmB;YACnB,kBAAkB;YAClB,kBAAkB;YAClB,cAAc;YACd,aAAa;YACb,aAAa;SACd;KACF;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,mCAAmC;QAChD,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC;KAC1C;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,8BAA8B;QAC3C,KAAK,EAAE,CAAC,gBAAgB,CAAC;KAC1B;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tailwind CSS version identifiers.
+ */
+export type TailwindVersion = "v3" | "v4";
+/**
+ * Application configuration derived from environment variables and defaults.
+ */
+export interface Config {
+    /** Root data directory for the MCP server */
+    dataDir: string;
+    /** Path to the SQLite database file */
+    dbPath: string;
+    /** Directory for cached raw MDX files */
+    rawDir: string;
+    /** Default Tailwind CSS version */
+    defaultVersion: TailwindVersion;
+    /** Embedding model identifier */
+    embeddingModel: string;
+    /** Embedding vector dimensions */
+    embeddingDimensions: number;
+    /** Query prefix required by snowflake-arctic-embed-xs */
+    queryPrefix: string;
+    /** Directory for cached ONNX model files */
+    modelCacheDir: string;
+}
+/**
+ * Version-to-branch mapping for the tailwindcss.com repository.
+ */
+export declare const VERSION_BRANCH_MAP: Record<TailwindVersion, string>;
+/**
+ * GitHub repository details for Tailwind CSS documentation.
+ */
+export declare const GITHUB_REPO: {
+    readonly owner: "tailwindlabs";
+    readonly repo: "tailwindcss.com";
+    readonly docsPath: "src/pages/docs";
+};
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,cAAc,EAAE,eAAe,CAAC;IAChC,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAG9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAOX,wBAAgB,UAAU,IAAI,MAAM,CAgBnC"}

package/dist/utils/config.js

@@ -0,0 +1,37 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Version-to-branch mapping for the tailwindcss.com repository.
+ */
+export const VERSION_BRANCH_MAP = {
+    v3: "master",
+    v4: "next",
+};
+/**
+ * GitHub repository details for Tailwind CSS documentation.
+ */
+export const GITHUB_REPO = {
+    owner: "tailwindlabs",
+    repo: "tailwindcss.com",
+    docsPath: "src/pages/docs",
+};
+/**
+ * Load configuration from environment variables with defaults.
+ */
+const VALID_VERSIONS = new Set(["v3", "v4"]);
+export function loadConfig() {
+    const dataDir = process.env.TAILWIND_DOCS_MCP_PATH ?? join(homedir(), ".tailwindcss-docs-mcp");
+    const envVersion = process.env.TAILWIND_DOCS_MCP_DEFAULT_VERSION;
+    const defaultVersion = envVersion && VALID_VERSIONS.has(envVersion) ? envVersion : "v4";
+    return {
+        dataDir,
+        dbPath: join(dataDir, "docs.db"),
+        rawDir: join(dataDir, "raw"),
+        defaultVersion,
+        embeddingModel: "Snowflake/snowflake-arctic-embed-xs",
+        embeddingDimensions: 384,
+        queryPrefix: "Represent this sentence for searching relevant passages: ",
+        modelCacheDir: join(dataDir, "models"),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA6BjC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,MAAM;CACX,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,gBAAgB;CAClB,CAAC;AAEX;;GAEG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAErD,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC;IACjE,MAAM,cAAc,GAClB,UAAU,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAE,UAA8B,CAAC,CAAC,CAAC,IAAI,CAAC;IAExF,OAAO;QACL,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;QAChC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QAC5B,cAAc;QACd,cAAc,EAAE,qCAAqC;QACrD,mBAAmB,EAAE,GAAG;QACxB,WAAW,EAAE,2DAA2D;QACxE,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/utils/query-expansion.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Query expansion for Tailwind CSS class name queries.
+ *
+ * Detects Tailwind class names in search queries and appends their canonical
+ * CSS property names. This bridges the vocabulary gap between abbreviated
+ * class prefixes (e.g., "mx-auto") and documentation titles (e.g., "Margin").
+ */
+/**
+ * Expand a search query by mapping detected Tailwind class name prefixes
+ * to their canonical CSS property names.
+ *
+ * Expansion terms are appended to the original query, preserving all original
+ * tokens. Duplicate terms (already present in the query) are not added.
+ *
+ * Returns the original query unchanged when no Tailwind class names are detected.
+ *
+ * @example
+ * expandQuery("tailwind text-lg class")
+ * // → "tailwind text-lg class font size"
+ *
+ * expandQuery("mx-auto centering")
+ * // → "mx-auto centering margin"
+ *
+ * expandQuery("how to center a div")
+ * // → "how to center a div" (unchanged — no class names)
+ */
+export declare function expandQuery(query: string): string;
+//# sourceMappingURL=query-expansion.d.ts.map

package/dist/utils/query-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-expansion.d.ts","sourceRoot":"","sources":["../../src/utils/query-expansion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmHH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBjD"}

package/dist/utils/query-expansion.js

@@ -0,0 +1,147 @@
+/**
+ * Query expansion for Tailwind CSS class name queries.
+ *
+ * Detects Tailwind class names in search queries and appends their canonical
+ * CSS property names. This bridges the vocabulary gap between abbreviated
+ * class prefixes (e.g., "mx-auto") and documentation titles (e.g., "Margin").
+ */
+/** Regex to detect Tailwind class names: hyphenated lowercase tokens like text-lg, grid-cols-3 */
+const TAILWIND_CLASS_RE = /\b[a-z]+(?:-[a-z0-9]+)+\b/g;
+/** Font size suffixes used by Tailwind's text-{size} utilities */
+const TEXT_SIZE_RE = /^text-(xs|sm|base|lg|xl|\d+xl)$/;
+/** Color name prefixes used by Tailwind's text-{color} utilities */
+const TEXT_COLOR_RE = /^text-(inherit|current|transparent|black|white|slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)/;
+/**
+ * Map of Tailwind class prefixes to their CSS property expansion terms.
+ * Each value is a space-separated string of terms to append to the query.
+ */
+const PREFIX_MAP = new Map([
+    // ── Multi-segment prefixes ─────────────────────────────────────
+    ["grid-cols", "grid template columns"],
+    ["grid-rows", "grid template rows"],
+    ["auto-cols", "grid auto columns"],
+    ["auto-rows", "grid auto rows"],
+    ["col-span", "grid column"],
+    ["row-span", "grid row"],
+    ["space-x", "space between horizontal"],
+    ["space-y", "space between vertical"],
+    ["min-w", "min-width"],
+    ["max-w", "max-width"],
+    ["min-h", "min-height"],
+    ["max-h", "max-height"],
+    // ── Single-segment prefixes ────────────────────────────────────
+    // Spacing
+    ["px", "padding"],
+    ["py", "padding"],
+    ["pt", "padding"],
+    ["pr", "padding"],
+    ["pb", "padding"],
+    ["pl", "padding"],
+    ["ps", "padding"],
+    ["pe", "padding"],
+    ["mx", "margin"],
+    ["my", "margin"],
+    ["mt", "margin"],
+    ["mr", "margin"],
+    ["mb", "margin"],
+    ["ml", "margin"],
+    ["ms", "margin"],
+    ["me", "margin"],
+    // Typography
+    ["font", "font"],
+    ["tracking", "letter spacing"],
+    ["leading", "line height"],
+    // Grid & Flex
+    ["gap", "gap"],
+    // Background
+    ["bg", "background"],
+    // Borders
+    ["rounded", "border radius"],
+    // Effects
+    ["shadow", "box shadow"],
+    // Sizing
+    ["w", "width"],
+    ["h", "height"],
+    ["size", "size"],
+    // Position
+    ["z", "z-index"],
+    ["inset", "position"],
+]);
+/**
+ * Disambiguate `text-` class names which map to different CSS properties
+ * depending on the suffix (font size vs text color).
+ *
+ * Returns null for unrecognized variants (text-center, text-wrap, etc.)
+ * where expansion could hurt more than help.
+ */
+function resolveTextClass(className) {
+    if (TEXT_SIZE_RE.test(className))
+        return "font size";
+    if (TEXT_COLOR_RE.test(className))
+        return "text color";
+    return null;
+}
+/**
+ * Resolve expansion terms for a single Tailwind class name.
+ *
+ * Tries progressively shorter hyphen-delimited prefixes (longest first):
+ *   "grid-cols-3" → tries "grid-cols" (match!) → "grid template columns"
+ *   "text-lg"     → tries "text" (conditional) → checks size regex → "font size"
+ *
+ * Returns null if no expansion applies.
+ */
+function resolveExpansion(className) {
+    const parts = className.split("-");
+    for (let len = parts.length - 1; len >= 1; len--) {
+        const prefix = parts.slice(0, len).join("-");
+        // Special case: text- requires disambiguation
+        if (prefix === "text")
+            return resolveTextClass(className);
+        const terms = PREFIX_MAP.get(prefix);
+        if (terms)
+            return terms;
+    }
+    return null;
+}
+/**
+ * Expand a search query by mapping detected Tailwind class name prefixes
+ * to their canonical CSS property names.
+ *
+ * Expansion terms are appended to the original query, preserving all original
+ * tokens. Duplicate terms (already present in the query) are not added.
+ *
+ * Returns the original query unchanged when no Tailwind class names are detected.
+ *
+ * @example
+ * expandQuery("tailwind text-lg class")
+ * // → "tailwind text-lg class font size"
+ *
+ * expandQuery("mx-auto centering")
+ * // → "mx-auto centering margin"
+ *
+ * expandQuery("how to center a div")
+ * // → "how to center a div" (unchanged — no class names)
+ */
+export function expandQuery(query) {
+    const classNames = query.match(TAILWIND_CLASS_RE);
+    if (!classNames)
+        return query;
+    const existingTerms = new Set(query.toLowerCase().split(/\s+/).filter(Boolean));
+    const expansionTerms = [];
+    for (const className of classNames) {
+        const terms = resolveExpansion(className);
+        if (!terms)
+            continue;
+        for (const term of terms.split(/\s+/)) {
+            const lower = term.toLowerCase();
+            if (lower && !existingTerms.has(lower)) {
+                expansionTerms.push(lower);
+                existingTerms.add(lower);
+            }
+        }
+    }
+    if (expansionTerms.length === 0)
+        return query;
+    return `${query} ${expansionTerms.join(" ")}`;
+}
+//# sourceMappingURL=query-expansion.js.map

package/dist/utils/query-expansion.js.map

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