@master/css-mcp 2.0.0-rc.77 → 2.0.0-rc.78

package/dist/compare.js

@@ -0,0 +1,131 @@
+import { createMCPTextDocument } from "./document.js";
+import { loadWorkspaceManifest } from "./project.js";
+import { createRequire } from "node:module";
+import CSSLanguageService from "@master/css-language-service";
+import { createCSSWithNativeDeclarations } from "@master/css-validator/native-declaration";
+import { parseHTML } from "@master/css-server";
+//#region src/compare.ts
+const CSS_COMPARE_VERSION = 1;
+const defaultManifest = createRequire(import.meta.url)("@master/css-preset/default-manifest.json");
+function unique(values) {
+	return [...new Set(values)];
+}
+function splitClassList(value) {
+	return unique((value ?? "").split(/\s+/).map((className) => className.trim()).filter(Boolean));
+}
+function extractContentClasses(content, filePath) {
+	if (content === void 0) return [];
+	const service = new CSSLanguageService();
+	const document = createMCPTextDocument(filePath, content);
+	return unique(service.getClassPositions(document).map((position) => position.token));
+}
+function resolveClasses(options, side, filePath) {
+	const classList = side === "before" ? options.beforeClassList : options.afterClassList;
+	const html = side === "before" ? options.beforeHtml : options.afterHtml;
+	const content = side === "before" ? options.beforeContent : options.afterContent;
+	if (classList !== void 0) return splitClassList(classList);
+	if (html !== void 0) return unique(parseHTML(html).classes);
+	return extractContentClasses(content, filePath);
+}
+function renderClasses(manifest, classes) {
+	const css = createCSSWithNativeDeclarations(manifest);
+	const invalid = [];
+	for (const className of classes) {
+		const rules = css.generate(className);
+		if (rules.length) for (const rule of rules) rule.layer.insert(rule);
+		else invalid.push(className);
+	}
+	return {
+		text: css.text,
+		bytes: css.text.length,
+		invalid
+	};
+}
+function diffValues(before, after) {
+	return {
+		added: after.filter((value) => !before.includes(value)),
+		removed: before.filter((value) => !after.includes(value)),
+		unchanged: after.filter((value) => before.includes(value))
+	};
+}
+function splitRules(css) {
+	return css.split(/(?<=})/).map((rule) => rule.trim()).filter(Boolean);
+}
+function createTextDiff(before, after) {
+	if (before === after) return "";
+	const beforeLines = before.split("\n");
+	const afterLines = after.split("\n");
+	return [
+		"--- before.css",
+		"+++ after.css",
+		"@@",
+		...beforeLines.map((line) => `-${line}`),
+		...afterLines.map((line) => `+${line}`)
+	].join("\n");
+}
+async function compareCSS(context, options) {
+	const manifest = await loadWorkspaceManifest(context);
+	const filePath = context.resolveVirtualPath(options.filePath || "index.html");
+	const activeManifest = manifest.status === "loaded" ? manifest.manifest : defaultManifest;
+	const beforeClasses = resolveClasses(options, "before", filePath);
+	const afterClasses = resolveClasses(options, "after", filePath);
+	const before = renderClasses(activeManifest, beforeClasses);
+	const after = renderClasses(activeManifest, afterClasses);
+	const classDiff = diffValues(beforeClasses, afterClasses);
+	const ruleDiff = diffValues(splitRules(before.text), splitRules(after.text));
+	return {
+		version: CSS_COMPARE_VERSION,
+		root: context.root,
+		manifest: {
+			status: manifest.status,
+			entries: manifest.entries,
+			...manifest.status === "error" ? { error: manifest.error } : {}
+		},
+		inputs: {
+			filePath,
+			before: {
+				classes: beforeClasses.length,
+				invalid: before.invalid.length
+			},
+			after: {
+				classes: afterClasses.length,
+				invalid: after.invalid.length
+			}
+		},
+		classes: classDiff,
+		invalid: {
+			before: before.invalid,
+			after: after.invalid,
+			added: after.invalid.filter((className) => !before.invalid.includes(className)),
+			removed: before.invalid.filter((className) => !after.invalid.includes(className))
+		},
+		css: {
+			changed: before.text !== after.text,
+			before: {
+				bytes: before.bytes,
+				text: before.text
+			},
+			after: {
+				bytes: after.bytes,
+				text: after.text
+			},
+			bytesDelta: after.bytes - before.bytes,
+			diff: createTextDiff(before.text, after.text)
+		},
+		rules: {
+			added: ruleDiff.added,
+			removed: ruleDiff.removed,
+			unchanged: ruleDiff.unchanged.length
+		},
+		summary: {
+			changed: before.text !== after.text,
+			addedClasses: classDiff.added.length,
+			removedClasses: classDiff.removed.length,
+			addedRules: ruleDiff.added.length,
+			removedRules: ruleDiff.removed.length,
+			bytesDelta: after.bytes - before.bytes
+		}
+	};
+}
+//#endregion
+export { compareCSS };

package/dist/context.js

@@ -1,7 +1,7 @@
-import { createHash, randomBytes } from "node:crypto";
-import { existsSync, realpathSync, statSync } from "node:fs";
 import { mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { createHash, randomBytes } from "node:crypto";
+import { existsSync, realpathSync, statSync } from "node:fs";
 //#region src/context.ts
 const DEFAULT_PREVIEW_TTL = 300 * 1e3;
 function sha256(text) {

package/dist/contributor.d.ts

@@ -0,0 +1,150 @@
+import MasterCSSMCPContext from "./context.js";
+
+//#region src/contributor.d.ts
+interface ContributorInput {
+  paths?: string[];
+  diff?: string;
+  task?: string;
+}
+interface PackageGraphInput {
+  packageName?: string;
+  includeExamples?: boolean;
+}
+interface WorkspacePackage {
+  name: string;
+  path: string;
+  private: boolean;
+  kind: 'root' | 'package' | 'site' | 'shared' | 'benchmarks' | 'example';
+  scripts: string[];
+  exports: string[];
+  dependencies: string[];
+  dependents: string[];
+  aiNotes: string | null;
+}
+interface Risk {
+  id: string;
+  severity: 'info' | 'warning' | 'high';
+  reason: string;
+  paths: string[];
+}
+declare function getPackageGraph(context: MasterCSSMCPContext, input?: PackageGraphInput): Promise<{
+  packages: WorkspacePackage[];
+  summary: {
+    packages: number;
+    workspacePackages: number;
+    examples: number;
+  };
+  status: "loaded" | "limited";
+  reason: string;
+  version: number;
+  audience: string;
+  root: string;
+}>;
+declare function getRepoContext(context: MasterCSSMCPContext, input?: ContributorInput): Promise<{
+  inputs: {
+    task: string | null;
+    paths: string[];
+    hasDiff: boolean;
+  };
+  affectedPackages: {
+    matchedPaths: string[];
+    name: string;
+    path: string;
+    kind: WorkspacePackage["kind"] | "agent-docs" | "repo-root";
+    packageJSON?: string;
+    aiNotes?: string | null;
+  }[];
+  context: {
+    files: string[];
+    note: string;
+  };
+  risks: Risk[];
+  validation: {
+    commands: {
+      command: string;
+      reason: string;
+    }[];
+  };
+  status: "loaded" | "limited";
+  reason: string;
+  version: number;
+  audience: string;
+  root: string;
+} | {
+  version: number;
+  audience: string;
+  root: string;
+  status: "error";
+  error: string;
+}>;
+declare function getChangeImpact(context: MasterCSSMCPContext, input?: ContributorInput): Promise<{
+  version: number;
+  audience: string;
+  root: string;
+  status: "error";
+  error: string;
+} | {
+  version: number;
+  audience: string;
+  root: string;
+  status: "loaded" | "limited";
+  reason: string;
+  inputs: {
+    task: string | null;
+    paths: string[];
+    hasDiff: boolean;
+  };
+  affectedPackages: {
+    matchedPaths: string[];
+    name: string;
+    path: string;
+    kind: WorkspacePackage["kind"] | "agent-docs" | "repo-root";
+    packageJSON?: string;
+    aiNotes?: string | null;
+  }[];
+  risks: Risk[];
+  summary: {
+    riskCount: number;
+    highRisk: number;
+    packageCount: number;
+  };
+}>;
+declare function getTestRouter(context: MasterCSSMCPContext, input?: ContributorInput): Promise<{
+  version: number;
+  audience: string;
+  root: string;
+  status: "error";
+  error: string;
+} | {
+  version: number;
+  audience: string;
+  root: string;
+  status: "loaded" | "limited";
+  reason: string;
+  inputs: {
+    task: string | null;
+    paths: string[];
+    hasDiff: boolean;
+  };
+  affectedPackages: {
+    matchedPaths: string[];
+    name: string;
+    path: string;
+    kind: WorkspacePackage["kind"] | "agent-docs" | "repo-root";
+    packageJSON?: string;
+    aiNotes?: string | null;
+  }[];
+  validation: {
+    commands: {
+      command: string;
+      reason: string;
+    }[];
+  };
+  risks: {
+    id: string;
+    severity: "info" | "warning" | "high";
+    reason: string;
+  }[];
+}>;
+//#endregion
+export { ContributorInput, PackageGraphInput, getChangeImpact, getPackageGraph, getRepoContext, getTestRouter };