@axis-ds/mcp 1.2.1 → 1.2.3

package/README.md

@@ -40,7 +40,7 @@ Claude Desktop 또는 기타 MCP 호환 클라이언트에서 설정:
 
 ## 문서
 
-자세한 사용법은 [AXIS Design System 문서](https://axis.minu.best)를 참고하세요.
+자세한 사용법은 [AXIS Design System 문서](https://axis-design-system.pages.dev)를 참고하세요.
 
 ## 라이선스
 

package/dist/index.js

@@ -2434,9 +2434,222 @@ var TAILWIND_CSS_CANDIDATES = [
   "styles/globals.css"
 ];
 var TAILWIND_IMPORT = /@import\s+(?:url\(\s*)?["']tailwindcss["']/;
+function stripCssComments(css) {
+  return css.replace(/\/\*[\s\S]*?\*\//g, "");
+}
 function hasTailwindImport(css) {
-  return TAILWIND_IMPORT.test(css.replace(/\/\*[\s\S]*?\*\//g, ""));
+  return TAILWIND_IMPORT.test(stripCssComments(css));
+}
+var TOKENS_TAILWIND4_ENTRY = "@axis-ds/tokens/css/tailwind4";
+var TOKENS_TAILWIND4_IMPORT_LINE = `@import "${TOKENS_TAILWIND4_ENTRY}";`;
+var TOKENS_TAILWIND4_IMPORT = /@import\s+(?:url\(\s*)?["']@axis-ds\/tokens\/css\/tailwind4["']/;
+function hasTokensTailwind4Import(css) {
+  return TOKENS_TAILWIND4_IMPORT.test(stripCssComments(css));
+}
+var TOKENS_CSS_IMPORT = /@import\s+(?:url\(\s*)?["'](@axis-ds\/tokens\/css(?:\/shadcn|\/tailwind4)?)["']/;
+function findTokensCssImport(css) {
+  return TOKENS_CSS_IMPORT.exec(stripCssComments(css))?.[1];
+}
+function checkGlobalsCss(baseDirInput) {
+  const baseDir = resolve3(baseDirInput);
+  for (const candidate of TAILWIND_CSS_CANDIDATES) {
+    const file = join5(baseDir, candidate);
+    if (!existsSync5(file)) continue;
+    const content = readFileSync6(file, "utf8");
+    if (content.includes("--background") && content.includes("--primary")) {
+      return { name: "globals.css", severity: "pass", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4` };
+    }
+    const imported = findTokensCssImport(content);
+    if (imported !== void 0) {
+      return { name: "globals.css", severity: "pass", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${imported} import)` };
+    }
+    return { name: "globals.css", severity: "warn", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4` };
+  }
+  return { name: "globals.css", severity: "fail", message: "globals.css \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4" };
+}
+var TAILWIND4_MIN_AXIS_VERSION = "1.4.0";
+var TAILWIND4_AXIS_PACKAGES = ["@axis-ds/tokens", "@axis-ds/ui-react", "@axis-ds/agentic-ui"];
+function lowerOf(token) {
+  const v = versionParts(token);
+  if (!v) return void 0;
+  const num = (part) => isWild(part) ? 0 : Number(part);
+  const pre = /^v?\d+(?:\.(?:\d+|[xX*]))?(?:\.(?:\d+|[xX*]))?-/.test(token);
+  return { core: [v.major, num(v.minor), num(v.patch)], pre };
+}
+function compareLower(a, b) {
+  for (let i = 0; i < 3; i++) {
+    if (a.core[i] !== b.core[i]) return a.core[i] - b.core[i];
+  }
+  return Number(b.pre) - Number(a.pre);
+}
+function rangeLowerVersion(range) {
+  const r = range.trim();
+  if (r === "" || r.includes("||")) return void 0;
+  const simple = new RegExp(`^(?:\\^|~|=)?\\s*(${VERSION})$`).exec(r);
+  if (simple) return lowerOf(simple[1]);
+  if (new RegExp(`^(${VERSION})\\s+-\\s+(${VERSION})$`).test(r)) {
+    const [a, b] = r.split(/\s+-\s+/);
+    return lowerOf(b) ? lowerOf(a) : void 0;
+  }
+  const tokens = r.replace(/(>=|<=|>|<|=)\s+/g, "$1").split(/\s+/);
+  let lower;
+  for (const t of tokens) {
+    const c = /^(>=|<=|>|<|=)(.+)$/.exec(t);
+    if (!c) return void 0;
+    const v = versionParts(c[2]);
+    const low = lowerOf(c[2]);
+    if (!v || !low) return void 0;
+    let candidate;
+    if (c[1] === ">=" || c[1] === "=") candidate = low;
+    else if (c[1] === ">") {
+      if (isWild(v.minor)) candidate = { core: [v.major + 1, 0, 0], pre: false };
+      else if (isWild(v.patch)) candidate = { core: [v.major, Number(v.minor) + 1, 0], pre: false };
+      else candidate = { core: [v.major, Number(v.minor), Number(v.patch) + 1], pre: false };
+    }
+    if (candidate && (!lower || compareLower(candidate, lower) > 0)) lower = candidate;
+  }
+  return lower;
+}
+function rangeLowerAtLeast(range, min) {
+  const lower = rangeLowerVersion(range);
+  const target = lowerOf(min);
+  if (!lower || !target) return void 0;
+  return compareLower(lower, target) >= 0;
+}
+function exactVersion(version) {
+  if (typeof version !== "string") return void 0;
+  const v = version.trim();
+  if (!/^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(v) || /^v?0\.0\.0-/.test(v)) return void 0;
+  return v;
+}
+function installedVersion(baseDir, name) {
+  try {
+    const parsed = JSON.parse(readFileSync6(join5(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
+    return isPlainObject(parsed) ? exactVersion(parsed.version) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function axisPackagesBelowTailwind4(pkg, baseDirInput) {
+  if (!pkg) return [];
+  const baseDir = baseDirInput !== void 0 ? resolve3(baseDirInput) : void 0;
+  const out = [];
+  const min = lowerOf(TAILWIND4_MIN_AXIS_VERSION);
+  for (const name of TAILWIND4_AXIS_PACKAGES) {
+    const range = hasDependency(pkg, name);
+    if (range === void 0 || range.trim().startsWith("workspace:")) continue;
+    const installed = baseDir !== void 0 ? installedVersion(baseDir, name) : void 0;
+    const installedLower = installed !== void 0 ? lowerOf(installed) : void 0;
+    if (installed !== void 0 && installedLower !== void 0) {
+      if (compareLower(installedLower, min) < 0) out.push({ name, range, status: "below", source: "installed", installed });
+      continue;
+    }
+    const atLeast = rangeLowerAtLeast(range, TAILWIND4_MIN_AXIS_VERSION);
+    if (atLeast === false) out.push({ name, range, status: "below", source: "declared" });
+    else if (atLeast === void 0) out.push({ name, range, status: "unknown", source: "declared" });
+  }
+  return out;
+}
+function axisPackageVersionLabel(issue) {
+  return issue.source === "installed" ? `${issue.name} \uC124\uCE58\uBCF8 ${issue.installed}` : `${issue.name} ${issue.range}`;
+}
+var declaredList = (issues) => issues.map(axisPackageVersionLabel).join(" \xB7 ");
+function tailwind4VersionNote(issues) {
+  const below = issues.filter((i) => i.status === "below");
+  const unknown = issues.filter((i) => i.status === "unknown");
+  let note = "";
+  if (below.length > 0) note += ` (${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1 \uD544\uC694: ${declaredList(below)})`;
+  if (unknown.length > 0) note += ` (\uC124\uCE58\uB41C \uBC84\uC804\uC774 ${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC778\uC9C0 \uD655\uC778\uD558\uC138\uC694: ${declaredList(unknown)})`;
+  return note;
+}
+var TAILWIND4_COMPONENT_PACKAGES = ["@axis-ds/ui-react", "@axis-ds/agentic-ui"];
+function componentTailwindImportLine(name) {
+  return `@import "${name}/tailwind.css";`;
+}
+var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function hasComponentTailwindImport(css, name) {
+  const re = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${escapeRegExp(name)}/tailwind\\.css["']`);
+  return re.test(stripCssComments(css));
+}
+function hasComponentSource(css, name) {
+  const re = new RegExp(`@source\\s+(["'])(?!@axis-ds/)[^"'\\n]*${escapeRegExp(name)}(?:[/\\\\][^"'\\n]*)?\\1`);
+  return re.test(stripCssComments(css));
+}
+var CREATE_NEXT_APP_DEFAULTS = [
+  {
+    prefix: ":root \uC0C9\uAC12",
+    pattern: /(?<![\w-])(--(?:background|foreground))\s*:\s*(?:#[0-9a-fA-F]{3,8}\b|(?:rgba?|hsla?|hwb|oklch|oklab|lab|lch|color)\()/g,
+    item: (m) => m[1]
+  },
+  {
+    prefix: "@theme",
+    pattern: /(?<![\w-])(--color-(?:background|foreground))\s*:\s*var\(\s*(--(?:background|foreground))\s*\)/g,
+    item: (m) => `${m[1]}: var(${m[2]})`
+  },
+  {
+    prefix: "@theme",
+    pattern: /(?<![\w-])(--font-(?:sans|mono))\s*:\s*var\(\s*(--font-geist-(?:sans|mono))\s*\)/g,
+    item: (m) => `${m[1]}: var(${m[2]})`
+  },
+  {
+    prefix: "body",
+    pattern: /(?<![\w-])(background|background-color|color)\s*:\s*var\(\s*(--(?:background|foreground))\s*\)/g,
+    item: (m) => `${m[1]}: var(${m[2]})`
+  }
+];
+function findCreateNextAppDefaults(css) {
+  const body = stripCssComments(css);
+  const labels = [];
+  for (const d of CREATE_NEXT_APP_DEFAULTS) {
+    const items = [];
+    for (const m of body.matchAll(d.pattern)) {
+      const item = d.item(m);
+      if (!items.includes(item)) items.push(item);
+    }
+    if (items.length > 0) labels.push(`${d.prefix} ${items.join(", ")}`);
+  }
+  return labels;
+}
+function stripJsComments(src) {
+  let out = "";
+  let i = 0;
+  const n = src.length;
+  while (i < n) {
+    const c = src[i];
+    const d = src[i + 1];
+    if (c === '"' || c === "'" || c === "`") {
+      let j = i + 1;
+      while (j < n && src[j] !== c) {
+        if (src[j] === "\\") j++;
+        else if (c !== "`" && src[j] === "\n") break;
+        j++;
+      }
+      out += src.slice(i, j + 1);
+      i = j + 1;
+      continue;
+    }
+    if (c === "/" && d === "/") {
+      const end = src.indexOf("\n", i);
+      i = end === -1 ? n : end;
+      continue;
+    }
+    if (c === "/" && d === "*") {
+      const end = src.indexOf("*/", i + 2);
+      i = end === -1 ? n : end + 2;
+      out += " ";
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+var TOKENS_TAILWIND3_PRESET = "@axis-ds/tokens/tailwind";
+var PRESET_REFERENCE = /(?:\brequire\s*\(\s*|\bimport\s*\(\s*|\bfrom\s*|\bimport\s+)(["'])@axis-ds\/tokens\/tailwind\1/;
+function hasTokensPresetReference(source) {
+  return PRESET_REFERENCE.test(stripJsComments(source));
 }
+var PRESET_PASS_SUFFIX = `\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (${TOKENS_TAILWIND3_PRESET} preset)`;
 function readPackageJson(baseDir) {
   try {
     const parsed = JSON.parse(readFileSync6(join5(baseDir, "package.json"), "utf8"));
@@ -2445,19 +2658,60 @@ function readPackageJson(baseDir) {
     return void 0;
   }
 }
+function tailwind4Issues(css, pkg, versions) {
+  const issues = [];
+  const hasEntry = hasTokensTailwind4Import(css);
+  if (!hasEntry) issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${TOKENS_TAILWIND4_IMPORT_LINE}`);
+  const missing = TAILWIND4_COMPONENT_PACKAGES.filter(
+    (name) => pkg !== void 0 && hasDependency(pkg, name) !== void 0 && !hasComponentTailwindImport(css, name) && !hasComponentSource(css, name)
+  );
+  if (missing.length > 0) {
+    issues.push(`\uCEF4\uD3EC\uB10C\uD2B8 \uC2A4\uCE94 \uACBD\uB85C(tailwind.css)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${missing.map(componentTailwindImportLine).join(" ")}`);
+  }
+  if (hasEntry) {
+    const defaults = findCreateNextAppDefaults(css);
+    if (defaults.length > 0) issues.push(`create-next-app \uAE30\uBCF8 \uC815\uC758\uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4(${defaults.join(" \xB7 ")}) \u2192 \uC9C0\uC6B0\uC138\uC694`);
+    if (versions.some((v) => v.name === TAILWIND4_AXIS_PACKAGES[0])) {
+      issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC9C0\uB9CC ${TAILWIND4_AXIS_PACKAGES[0]} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
+    }
+  }
+  for (const name of TAILWIND4_COMPONENT_PACKAGES) {
+    if (hasComponentTailwindImport(css, name) && versions.some((v) => v.name === name)) {
+      issues.push(`${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${name} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
+    }
+  }
+  return issues;
+}
 function checkTailwindSetup(baseDirInput) {
   const baseDir = resolve3(baseDirInput);
-  const tailwind = detectTailwind(baseDir, readPackageJson(baseDir));
+  const pkg = readPackageJson(baseDir);
+  const tailwind = detectTailwind(baseDir, pkg);
   if (tailwind.major !== void 0 && tailwind.major >= 4) {
     const label = `Tailwind ${tailwind.major}`;
     for (const candidate of TAILWIND_CSS_CANDIDATES) {
       const file = join5(baseDir, candidate);
       if (!existsSync5(file)) continue;
-      const found = hasTailwindImport(readFileSync6(file, "utf8"));
+      const css = readFileSync6(file, "utf8");
+      if (!hasTailwindImport(css)) {
+        return {
+          name: "tailwind.config",
+          severity: "warn",
+          message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
+        };
+      }
+      const versions = axisPackagesBelowTailwind4(pkg, baseDir);
+      const issues = tailwind4Issues(css, pkg, versions);
+      if (issues.length > 0) {
+        return {
+          name: "tailwind.config",
+          severity: "warn",
+          message: `${label}: ${candidate}\uC5D0 ${issues.join(" / ")}${tailwind4VersionNote(versions)}`
+        };
+      }
       return {
         name: "tailwind.config",
-        severity: found ? "pass" : "warn",
-        message: found ? `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC788\uC2B5\uB2C8\uB2E4` : `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
+        severity: "pass",
+        message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uC640 AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC2B5\uB2C8\uB2E4`
       };
     }
     return {
@@ -2471,22 +2725,31 @@ function checkTailwindSetup(baseDirInput) {
   if (existsSync5(tsPath)) {
     const content = readFileSync6(tsPath, "utf8");
     const hasTokens = content.includes("--background") || content.includes("hsl(var(");
-    return {
-      name: "tailwind.config",
-      severity: hasTokens ? "pass" : "warn",
-      message: hasTokens ? "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4" : "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-    };
+    if (hasTokens) {
+      return { name: "tailwind.config", severity: "pass", message: "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4" };
+    }
+    if (hasTokensPresetReference(content)) {
+      return { name: "tailwind.config", severity: "pass", message: `tailwind.config.ts${PRESET_PASS_SUFFIX}` };
+    }
+    return { name: "tailwind.config", severity: "warn", message: "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
   }
   for (const file of otherFiles) {
-    if (existsSync5(join5(baseDir, file))) {
+    const path5 = join5(baseDir, file);
+    if (existsSync5(path5)) {
+      if (hasTokensPresetReference(readFileSync6(path5, "utf8"))) {
+        return { name: "tailwind.config", severity: "pass", message: `${file}${PRESET_PASS_SUFFIX}` };
+      }
       return { name: "tailwind.config", severity: "warn", message: `${file} \uC874\uC7AC (TypeScript \uAD8C\uC7A5)` };
     }
   }
   return { name: "tailwind.config", severity: "fail", message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
 }
 
+// src/site.ts
+var AXIS_SITE_URL = "https://axis-design-system.pages.dev";
+
 // src/tools/template.ts
-var TEMPLATE_REGISTRY_URL = process.env.AXIS_TEMPLATE_URL || "https://axis.minu.best/templates";
+var TEMPLATE_REGISTRY_URL = process.env.AXIS_TEMPLATE_URL || `${AXIS_SITE_URL}/templates`;
 async function fetchTemplateIndex() {
   const url = `${TEMPLATE_REGISTRY_URL}/index.json`;
   const res = await fetch(url);
@@ -2646,35 +2909,7 @@ async function handleCheckProject(params) {
     message: configExists ? "axis.config.json \uD30C\uC77C\uC774 \uC874\uC7AC\uD569\uB2C8\uB2E4" : "axis.config.json \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 'axis init'\uC744 \uC2E4\uD589\uD558\uC138\uC694"
   });
   results.push(checkTailwindSetup(baseDir));
-  const cssCandidates = [
-    "globals.css",
-    "app/globals.css",
-    "src/app/globals.css",
-    "src/globals.css",
-    "styles/globals.css"
-  ];
-  let cssFound = false;
-  for (const candidate of cssCandidates) {
-    const fullPath = path3.join(baseDir, candidate);
-    if (await fs3.pathExists(fullPath)) {
-      const content = await fs3.readFile(fullPath, "utf-8");
-      const hasTokens = content.includes("--background") && content.includes("--primary");
-      results.push({
-        name: "globals.css",
-        severity: hasTokens ? "pass" : "warn",
-        message: hasTokens ? `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4` : `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
-      });
-      cssFound = true;
-      break;
-    }
-  }
-  if (!cssFound) {
-    results.push({
-      name: "globals.css",
-      severity: "fail",
-      message: "globals.css \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4"
-    });
-  }
+  results.push(checkGlobalsCss(baseDir));
   const utilsCandidates = [
     "lib/utils.ts",
     "src/lib/utils.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axis-ds/mcp",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "type": "module",
   "description": "AXIS Design System - MCP Server for AI-assisted component discovery",
   "bin": {
@@ -41,7 +41,7 @@
     "url": "https://github.com/IDEA-on-Action/AXIS-Design-System.git",
     "directory": "packages/axis-mcp"
   },
-  "homepage": "https://axis.minu.best",
+  "homepage": "https://axis-design-system.pages.dev",
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean && npm run copy-data",
     "copy-data": "node -e \"const fs=require('fs');fs.cpSync('src/registry/data','dist/data',{recursive:true})\"",