@master/css-mcp 2.0.0-rc.88 → 2.0.0

package/dist/source-schema.js

@@ -0,0 +1,141 @@
+import { browserSupport, cssStatus, diagnostic, inspection, matchStatus, range, strings } from "./semantic-schema.js";
+import * as z from "zod/v4";
+// src/source-schema.ts
+const count = z.number().int().nonnegative();
+const counts = (...names) => z.object(Object.fromEntries(names.map((name) => [name, count])));
+const position = z.object({
+	line: count,
+	character: count
+});
+const location = z.object({
+	start: position,
+	end: position
+});
+const occurrence = z.object({
+	candidate: z.string(),
+	source: z.string(),
+	range,
+	contextRange: range,
+	rangeKind: z.enum(["token", "expression"]),
+	extractor: z.string(),
+	contentKind: z.string(),
+	owner: z.string(),
+	included: z.boolean(),
+	reason: z.string()
+});
+const extractedFile = z.object({
+	filePath: z.string(),
+	languageId: z.string(),
+	occurrences: z.array(occurrence),
+	classes: z.array(z.object({
+		raw: z.string(),
+		token: z.string(),
+		range,
+		loc: location,
+		contextRange: range,
+		sourceKind: z.string(),
+		provenance: occurrence,
+		status: z.string(),
+		matchStatus,
+		cssSyntaxStatus: cssStatus,
+		cssValueStatus: cssStatus,
+		browserSupport,
+		inspection
+	}))
+});
+const sourceFix = z.object({
+	kind: z.literal("class-list"),
+	safety: z.literal("safe"),
+	range,
+	text: z.string(),
+	description: z.string(),
+	requiresFormatting: z.boolean()
+});
+const lintFile = z.object({
+	filePath: z.string(),
+	languageId: z.string(),
+	sourceKind: z.enum([
+		"source",
+		"stylesheet",
+		"manifest"
+	]),
+	diagnostics: z.array(diagnostic.extend({
+		code: z.string(),
+		severity: z.enum(["error", "warning"]),
+		range,
+		loc: z.object({
+			start: z.object({
+				line: count,
+				column: count
+			}),
+			end: z.object({
+				line: count,
+				column: count
+			})
+		}),
+		source: z.literal("Master CSS"),
+		sourceKind: z.string(),
+		fixes: z.array(sourceFix).optional()
+	}))
+});
+const lintCoverage = z.object({
+	status: z.enum(["complete", "no-inputs"]),
+	checkedFiles: strings,
+	description: z.string()
+});
+const lintSummary = counts("checkedFiles", "filesWithDiagnostics", "diagnostics", "errors", "warnings", "fixable", "safeFixes");
+const formatFile = z.object({
+	filePath: z.string(),
+	languageId: z.string(),
+	edits: z.array(z.object({
+		range: location,
+		newText: z.string()
+	})),
+	changed: z.boolean(),
+	beforeBytes: count,
+	afterBytes: count
+});
+const discovered = z.object({
+	latent: strings,
+	valid: strings,
+	invalid: strings,
+	usedNative: strings
+});
+const scannedFile = z.object({
+	filePath: z.string(),
+	source: z.string(),
+	scanned: z.boolean(),
+	changed: z.boolean(),
+	discovered
+});
+const scanner = z.object({
+	counts: counts("latent", "valid", "invalid", "native", "usedNative", "safelist", "blocklist"),
+	classes: discovered.extend({
+		native: strings,
+		safelist: strings,
+		blocklist: strings
+	}),
+	resetDependencies: strings
+});
+const stylesheets = z.object({
+	entries: z.array(z.object({
+		filePath: z.string(),
+		masterCSS: z.boolean(),
+		pruneNativeCSS: z.boolean(),
+		dependencies: strings,
+		sourceDependencies: strings,
+		warnings: strings,
+		errors: strings
+	})),
+	dependencies: strings,
+	warnings: strings,
+	errors: z.array(z.object({
+		filePath: z.string(),
+		message: z.string()
+	}))
+});
+const scanSummary = counts("files", "stylesheets", "diagnostics", "errors", "warnings", "missingCSS", "invalidClasses");
+const previewSummary = counts("files", "bytesBefore", "bytesAfter");
+const formatSummary = counts("files", "changed", "edits");
+const extractSummary = counts("files", "classes", "matched", "unmatched").extend({ diagnostics: count.optional() });
+export { extractSummary, extractedFile, formatFile, formatSummary, lintCoverage, lintFile, lintSummary, occurrence, previewSummary, scanSummary, scannedFile, scanner, stylesheets };

package/dist/suggest.js

@@ -0,0 +1,22 @@
+import { loadWorkspaceManifest, manifestMetadata, requireWorkspaceManifest } from "./project.js";
+import { createMCPToolingSession } from "./tooling-session.js";
+// src/suggest.ts
+async function suggestClasses(context, options) {
+	const manifest = await loadWorkspaceManifest(context, options.context);
+	using session = createMCPToolingSession(requireWorkspaceManifest(manifest));
+	const report = session.suggestClasses(options.declarations);
+	const inspections = report.classes.map((className) => session.inspectClassName(className));
+	return {
+		...report,
+		manifest: manifestMetadata(manifest),
+		diagnostics: inspections.flatMap((inspection) => inspection.diagnostics ?? []),
+		validation: inspections.map(({ className, matchStatus, cssSyntaxStatus, cssValueStatus, browserSupport }) => ({
+			className,
+			matchStatus,
+			cssSyntaxStatus,
+			cssValueStatus,
+			browserSupport
+		}))
+	};
+}
+export { suggestClasses };

package/dist/tooling-session.js

@@ -0,0 +1,27 @@
+import { createToolingSessionSync } from "@master/css-tooling/node";
+// src/tooling-session.ts
+function createMCPToolingSession(manifest, nativeClassNames = []) {
+	return createToolingSessionSync({
+		manifest,
+		nativeClassNames
+	});
+}
+function compactClassInspection(session, className, includeRules = false, resolvedInspection) {
+	const inspection = resolvedInspection ?? session.inspectClassName(className);
+	return {
+		...inspection,
+		variables: inspection.variables.map(({ key, variable }) => ({
+			key,
+			variable: {
+				...variable,
+				dependencies: [...variable.dependencies ?? []]
+			}
+		})),
+		rules: inspection.rules.map((rule) => {
+			if (includeRules) return rule;
+			const { text: _text, ...metadata } = rule;
+			return metadata;
+		})
+	};
+}
+export { compactClassInspection, createMCPToolingSession };

package/package.json

@@ -1,75 +1,65 @@
 {
-  "name": "@master/css-mcp",
-  "type": "module",
-  "license": "MIT",
-  "description": "Model Context Protocol server for Master CSS tooling.",
-  "author": "Aoyue Design LLC.",
-  "funding": "https://rc.css.master.co/sponsor",
-  "homepage": "https://css.master.co",
-  "bugs": {
-    "url": "https://github.com/master-co/css/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/master-co/css.git",
-    "directory": "packages/mcp"
-  },
-  "keywords": [
-    "mcp",
-    "ai",
-    "css",
-    "mastercss"
-  ],
-  "sideEffects": false,
-  "bin": {
-    "master-css-mcp": "./dist/bin/index.js"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "jsnext:main": "./dist/index.js",
-  "esnext": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+    "name": "@master/css-mcp",
+    "type": "module",
+    "engines": {
+        "node": "^24"
     },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js",
-      "default": "./dist/server.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "fast-glob": "^3.3.3",
-    "vscode-languageserver-textdocument": "^1.0.12",
-    "zod": "^4.4.3",
-    "@master/css-compiler": "^2.0.0-rc.88",
-    "@master/css-language-service": "^2.0.0-rc.88",
-    "@master/css-engine": "^2.0.0-rc.88",
-    "@master/css-diagnostics": "^2.0.0-rc.88",
-    "@master/css-lexer": "^2.0.0-rc.88",
-    "@master/css-lint": "^2.0.0-rc.88",
-    "@master/css-preset": "^2.0.0-rc.88",
-    "@master/css-server": "^2.0.0-rc.88",
-    "@master/css-validator": "^2.0.0-rc.88",
-    "@master/css-project": "^2.0.0-rc.88"
-  },
-  "version": "2.0.0-rc.88",
-  "scripts": {
-    "build": "tsdown --config ../../shared/tsdown-package.config.ts",
-    "dev": "tsdown --config ../../shared/tsdown-package.config.ts --watch",
-    "lint": "eslint",
-    "type-check": "tsc -b tsconfig.typecheck.json",
-    "test": "vitest"
-  }
-}
+    "scripts": {
+        "build": "bun --bun tsdown --config ../../shared/tsdown-package.config.ts",
+        "dev": "bun --bun tsdown --config ../../shared/tsdown-package.config.ts --watch",
+        "lint": "bun --bun eslint",
+        "type-check": "bun --bun tsc -b tsconfig.typecheck.json",
+        "test": "bun --bun vitest run"
+    },
+    "license": "MIT",
+    "description": "Model Context Protocol server for Master CSS tooling.",
+    "author": "Aoyue Design LLC.",
+    "homepage": "https://css.master.co",
+    "bugs": {
+        "url": "https://github.com/master-co/css/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/master-co/css.git",
+        "directory": "packages/mcp"
+    },
+    "keywords": [
+        "mcp",
+        "ai",
+        "css",
+        "mastercss"
+    ],
+    "sideEffects": false,
+    "bin": {
+        "master-css-mcp": "./dist/bin/index.js"
+    },
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "dependencies": {
+        "@master/css": "2.0.0",
+        "@master/css-compiler": "2.0.0",
+        "@master/css-language-service": "2.0.0",
+        "@master/css-tooling": "2.0.0",
+        "@master/css-preset": "2.0.0",
+        "@master/css-schema": "2.0.0",
+        "@modelcontextprotocol/sdk": "^1.32.2",
+        "fast-glob": "^3.3.3",
+        "vscode-languageserver-textdocument": "^1.0.16",
+        "zod": "^4.6.7"
+    },
+    "version": "2.0.0",
+    "gitHead": "6bf9adc4432b67e62613caea59d3b554711b4d54"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-The MIT License
-
-Copyright (c) Aoyue Design LLC.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/dist/classes.d.ts

@@ -1,236 +0,0 @@
-import MasterCSSMCPContext from "./context.js";
-//#region src/classes.d.ts
-interface ExtractClassesOptions {
-  content?: string;
-  filePath?: string;
-  patterns?: string[];
-  includeRules?: boolean;
-}
-interface TraceClassOptions {
-  className: string;
-  patterns?: string[];
-  includeCss?: boolean;
-  mode?: string;
-}
-declare function extractClasses(context: MasterCSSMCPContext, options?: ExtractClassesOptions): Promise<{
-  version: number;
-  root: string;
-  manifest: {
-    status: "error" | "loaded";
-    entries: string[];
-    error?: string | undefined;
-  };
-  inputs: {
-    mode: string;
-    filePath: string;
-    patterns?: undefined;
-    files?: undefined;
-  };
-  files: {
-    filePath: string;
-    languageId: string;
-    classes: {
-      raw: string;
-      token: string;
-      range: {
-        start: number;
-        end: number;
-      };
-      loc: {
-        start: import("vscode-languageserver-textdocument").Position;
-        end: import("vscode-languageserver-textdocument").Position;
-      };
-      contextRange: {
-        start: number;
-        end: number;
-      };
-      sourceKind: string;
-      status: string;
-      valid: boolean;
-      inspection: {
-        valid: boolean;
-        base: string;
-        suffix: string;
-        key: string | undefined;
-        value: string | undefined;
-        keyToken: string | undefined;
-        valueToken: string | undefined;
-        stateToken: string | undefined;
-        important: boolean | undefined;
-        matcherTypes: ("key" | "pattern" | "static" | "value" | "variable")[];
-        variables: {
-          key: string;
-          variable: import("~/packages/language/src").Variable;
-        }[];
-        rules: {
-          className: string;
-          layer: import("@master/css-engine").MasterCSSManifestUtilityLayerName;
-          type: import("~/packages/language/src").UtilityType;
-        }[];
-      };
-    }[];
-  }[];
-  summary: {
-    files: number;
-    classes: number;
-    valid: number;
-    invalid: number;
-    diagnostics?: undefined;
-  };
-  scanner?: undefined;
-  diagnostics?: undefined;
-} | {
-  version: number;
-  root: string;
-  manifest: {
-    status: "error" | "loaded";
-    entries: string[];
-    error?: string | undefined;
-  };
-  inputs: {
-    filePath?: undefined;
-    mode: string;
-    patterns: string[];
-    files: string[];
-  };
-  files: {
-    filePath: string;
-    languageId: string;
-    classes: {
-      raw: string;
-      token: string;
-      range: {
-        start: number;
-        end: number;
-      };
-      loc: {
-        start: import("vscode-languageserver-textdocument").Position;
-        end: import("vscode-languageserver-textdocument").Position;
-      };
-      contextRange: {
-        start: number;
-        end: number;
-      };
-      sourceKind: string;
-      status: string;
-      valid: boolean;
-      inspection: {
-        valid: boolean;
-        base: string;
-        suffix: string;
-        key: string | undefined;
-        value: string | undefined;
-        keyToken: string | undefined;
-        valueToken: string | undefined;
-        stateToken: string | undefined;
-        important: boolean | undefined;
-        matcherTypes: ("key" | "pattern" | "static" | "value" | "variable")[];
-        variables: {
-          key: string;
-          variable: import("~/packages/language/src").Variable;
-        }[];
-        rules: {
-          className: string;
-          layer: import("@master/css-engine").MasterCSSManifestUtilityLayerName;
-          type: import("~/packages/language/src").UtilityType;
-        }[];
-      };
-    }[];
-  }[];
-  scanner: {
-    counts: {
-      latent: number;
-      valid: number;
-      invalid: number;
-      native: number;
-      usedNative: number;
-      safelist: number;
-      blocklist: number;
-    };
-  };
-  diagnostics: import("~/packages/diagnostics/src").MasterCSSInspectionDiagnostic[];
-  summary: {
-    files: number;
-    classes: number;
-    valid: number;
-    invalid: number;
-    diagnostics: number;
-  };
-}>;
-declare function traceClass(context: MasterCSSMCPContext, options: TraceClassOptions): Promise<{
-  version: number;
-  root: string;
-  manifest: {
-    status: "error" | "loaded";
-    entries: string[];
-    error?: string | undefined;
-  };
-  inputs: {
-    className: string;
-    patterns: string[];
-    mode: string | undefined;
-  };
-  className: string;
-  status: "missing" | "present";
-  reason: "blocklisted" | "generated" | "invalid" | "native-css" | "not-detected" | "safelist";
-  detected: boolean;
-  occurrences: {
-    filePath: string;
-    source: string;
-    statuses: string[];
-  }[];
-  inspection: {
-    valid: boolean;
-    base: string;
-    suffix: string;
-    key: string | undefined;
-    value: string | undefined;
-    keyToken: string | undefined;
-    valueToken: string | undefined;
-    stateToken: string | undefined;
-    important: boolean | undefined;
-    matcherTypes: ("key" | "pattern" | "static" | "value" | "variable")[];
-    variables: {
-      key: string;
-      variable: import("~/packages/language/src").Variable;
-    }[];
-    rules: {
-      className: string;
-      layer: import("@master/css-engine").MasterCSSManifestUtilityLayerName;
-      type: import("~/packages/language/src").UtilityType;
-    }[];
-  };
-  scanner: {
-    counts: {
-      latent: number;
-      valid: number;
-      invalid: number;
-      native: number;
-      usedNative: number;
-      safelist: number;
-      blocklist: number;
-    };
-    safelist: boolean;
-    blocklist: boolean;
-  };
-  css: {
-    included: boolean;
-    bytes: number;
-    emittedGlobals: {
-      variables: number;
-      animations: number;
-    };
-    text?: string | undefined;
-  };
-  diagnostics: import("~/packages/diagnostics/src").MasterCSSInspectionDiagnostic[];
-  summary: {
-    status: "missing" | "present";
-    reason: "blocklisted" | "generated" | "invalid" | "native-css" | "not-detected" | "safelist";
-    detected: boolean;
-    valid: boolean;
-    rules: number;
-    diagnostics: number;
-  };
-}>;
-//#endregion
-export { ExtractClassesOptions, TraceClassOptions, extractClasses, traceClass };

package/dist/compare.d.ts

@@ -1,70 +0,0 @@
-import MasterCSSMCPContext from "./context.js";
-//#region src/compare.d.ts
-interface CompareCSSOptions {
-  beforeClassList?: string;
-  afterClassList?: string;
-  beforeHtml?: string;
-  afterHtml?: string;
-  beforeContent?: string;
-  afterContent?: string;
-  filePath?: string;
-}
-declare function compareCSS(context: MasterCSSMCPContext, options: CompareCSSOptions): Promise<{
-  version: number;
-  root: string;
-  manifest: {
-    status: "error" | "loaded";
-    entries: string[];
-    error?: string | undefined;
-  };
-  inputs: {
-    filePath: string;
-    before: {
-      classes: number;
-      invalid: number;
-    };
-    after: {
-      classes: number;
-      invalid: number;
-    };
-  };
-  classes: {
-    added: string[];
-    removed: string[];
-    unchanged: string[];
-  };
-  invalid: {
-    before: string[];
-    after: string[];
-    added: string[];
-    removed: string[];
-  };
-  css: {
-    changed: boolean;
-    before: {
-      bytes: number;
-      text: string;
-    };
-    after: {
-      bytes: number;
-      text: string;
-    };
-    bytesDelta: number;
-    diff: string;
-  };
-  rules: {
-    added: string[];
-    removed: string[];
-    unchanged: number;
-  };
-  summary: {
-    changed: boolean;
-    addedClasses: number;
-    removedClasses: number;
-    addedRules: number;
-    removedRules: number;
-    bytesDelta: number;
-  };
-}>;
-//#endregion
-export { CompareCSSOptions, compareCSS };