@axis-ds/mcp 1.3.3 → 1.3.5

package/dist/index.js

@@ -71,7 +71,7 @@ function getTokenStats() {
 }
 
 // ../axis-registry-core/src/add/add.ts
-import { existsSync as existsSync5, readFileSync as readFileSync4, statSync as statSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5, statSync as statSync3 } from "fs";
 import path5 from "path";
 import fs3 from "fs-extra";
 
@@ -597,7 +597,7 @@ function createPinnedFetch(options = {}) {
   const judge = options.judge ?? blockedAddressReason;
   const send = options.request ?? httpsRequest;
   const maxBytes = options.maxBytes ?? PINNED_FETCH_MAX_BYTES;
-  return (input, init) => new Promise((resolve4, reject) => {
+  return (input, init) => new Promise((resolve5, reject) => {
     let url;
     try {
       url = new URL(input);
@@ -638,7 +638,7 @@ function createPinnedFetch(options = {}) {
           if (failed) return;
           const body = Buffer.concat(chunks).toString("utf8");
           const status = res.statusCode ?? 0;
-          resolve4({ ok: status >= 200 && status < 300, status, text: async () => body });
+          resolve5({ ok: status >= 200 && status < 300, status, text: async () => body });
         });
       }
     );
@@ -865,7 +865,7 @@ var RegistryClient = class {
 };
 
 // ../axis-registry-core/src/project.ts
-import { existsSync as existsSync2, statSync } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync3, statSync } from "fs";
 import path3 from "path";
 function detectInstallCommand(baseDir) {
   if (existsSync2(path3.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
@@ -898,10 +898,79 @@ var GLOBAL_CSS_CANDIDATES = [
   "src/styles/globals.css",
   "globals.css"
 ];
+function isFile(file) {
+  try {
+    return statSync(file).isFile();
+  } catch {
+    return false;
+  }
+}
+var ROOT_LAYOUT_FILES = [
+  "app/layout.tsx",
+  "app/layout.jsx",
+  "app/layout.js",
+  "src/app/layout.tsx",
+  "src/app/layout.jsx",
+  "src/app/layout.js",
+  "pages/_app.tsx",
+  "pages/_app.jsx",
+  "pages/_document.tsx",
+  "pages/_document.jsx",
+  "src/pages/_app.tsx",
+  "src/pages/_app.jsx",
+  "src/pages/_document.tsx",
+  "src/pages/_document.jsx"
+];
+function exactVersionOf(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 findInstalledPackage(baseDirInput, name) {
+  let dir = path3.resolve(baseDirInput);
+  for (; ; ) {
+    const pkgDir = path3.join(dir, "node_modules", ...name.split("/"));
+    const file = path3.join(pkgDir, "package.json");
+    if (isFile(file)) {
+      let version;
+      try {
+        const parsed = JSON.parse(readFileSync3(file, "utf8"));
+        version = isPlainObject(parsed) ? exactVersionOf(parsed.version) : void 0;
+      } catch {
+        version = void 0;
+      }
+      return { dir: pkgDir, version };
+    }
+    const parent = path3.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function isPnpProject(baseDirInput) {
+  let dir = path3.resolve(baseDirInput);
+  for (; ; ) {
+    if (isFile(path3.join(dir, ".pnp.cjs")) || isFile(path3.join(dir, ".pnp.js"))) return true;
+    const parent = path3.dirname(dir);
+    if (parent === dir) return false;
+    dir = parent;
+  }
+}
+function compareExactVersions(a, b) {
+  const parse = (v) => {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?/.exec(v.trim());
+    return m ? { core: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] !== void 0 } : void 0;
+  };
+  const x = parse(a);
+  const y = parse(b);
+  if (!x || !y) return void 0;
+  for (let i = 0; i < 3; i++) if (x.core[i] !== y.core[i]) return x.core[i] - y.core[i];
+  return Number(y.pre) - Number(x.pre);
+}
 
 // ../axis-registry-core/src/template/tailwind-core.ts
-import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync3 } from "fs";
-import { join as join2, resolve } from "path";
+import { existsSync as existsSync3, lstatSync, readdirSync, readFileSync as readFileSync4 } from "fs";
+import { extname, join as join2, resolve } from "path";
 function hasDependency2(pkg, name) {
   for (const field of ["dependencies", "devDependencies"]) {
     const deps = pkg[field];
@@ -988,7 +1057,7 @@ function detectTailwind(baseDirInput, pkg) {
   const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
   const declaredMajor = bounds?.lower;
   try {
-    const installed = JSON.parse(readFileSync3(installedFile, "utf8"));
+    const installed = JSON.parse(readFileSync4(installedFile, "utf8"));
     const version = isPlainObject2(installed) ? installed.version : void 0;
     const major = majorFromVersion(version);
     if (major !== void 0) {
@@ -1036,18 +1105,57 @@ var TOKENS_CSS_IMPORT = /@import\s+(?:url\(\s*)?["'](@axis-ds\/tokens\/css(?:\/s
 function findTokensCssImport(css) {
   return TOKENS_CSS_IMPORT.exec(stripCssComments(css))?.[1];
 }
+var TOKENS_CSS_JS_IMPORT = /(?:\bimport\s+|\bfrom\s+|\brequire\s*\(\s*)(["'])(@axis-ds\/tokens\/css(?:\/shadcn|\/tailwind4)?)\1/;
+var AXIS_VARIABLE_DEFINITION = /(?<![\w-])--axis-[\w-]+\s*:/;
+function findLayoutTokensCssImport(baseDirInput) {
+  const baseDir = resolve(baseDirInput);
+  for (const candidate of ROOT_LAYOUT_FILES) {
+    const file = join2(baseDir, candidate);
+    if (!existsSync3(file)) continue;
+    let text;
+    try {
+      text = readFileSync4(file, "utf8");
+    } catch {
+      continue;
+    }
+    const m = TOKENS_CSS_JS_IMPORT.exec(stripJsComments(text));
+    if (m) return { file: candidate, spec: m[2] };
+  }
+  return void 0;
+}
 function checkGlobalsCss(baseDirInput) {
   const baseDir = resolve(baseDirInput);
   for (const candidate of TAILWIND_CSS_CANDIDATES) {
     const file = join2(baseDir, candidate);
     if (!existsSync3(file)) continue;
-    const content = readFileSync3(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 content = readFileSync4(file, "utf8");
+    const css = stripCssComments(content);
     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)` };
+    let pass;
+    if (imported !== void 0) pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${imported} import)`;
+    else if (AXIS_VARIABLE_DEFINITION.test(css)) pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218(--axis-*)\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4`;
+    else {
+      const layout = findLayoutTokensCssImport(baseDir);
+      if (layout) pass = `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${layout.file}\uC758 ${layout.spec} import)`;
+    }
+    if (pass !== void 0) {
+      const tailwind = detectTailwind(baseDir, readPackageJson(baseDir));
+      const tailwind4 = tailwind.major !== void 0 && tailwind.major >= 4;
+      if (!tailwind4 && findCreateNextAppDefaults(content).some((d) => d.includes("font-family: Arial"))) {
+        return {
+          name: "globals.css",
+          severity: "warn",
+          message: `${pass}. \uB2E4\uB9CC create-next-app \uAE30\uBCF8 body font-family: Arial \uC774 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 \u2192 \uC9C0\uC6B0\uC138\uC694(AXIS \uAE00\uAF34 \uB300\uC2E0 Arial \uC774 \uC801\uC6A9\uB428)`
+        };
+      }
+      return { name: "globals.css", severity: "pass", message: pass };
+    }
+    if (css.includes("--background") && css.includes("--primary")) {
+      return {
+        name: "globals.css",
+        severity: "warn",
+        message: `${candidate}\uC5D0 \uC790\uCCB4 CSS \uBCC0\uC218(--background \xB7 --primary)\uB9CC \uC788\uACE0 AXIS \uD1A0\uD070\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 @axis-ds/tokens CSS \uB97C import \uD558\uC138\uC694`
+      };
     }
     return { name: "globals.css", severity: "warn", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4` };
   }
@@ -1110,7 +1218,7 @@ function exactVersion(version) {
 }
 function installedVersion(baseDir, name) {
   try {
-    const parsed = JSON.parse(readFileSync3(join2(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
+    const parsed = JSON.parse(readFileSync4(join2(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
     return isPlainObject2(parsed) ? exactVersion(parsed.version) : void 0;
   } catch {
     return void 0;
@@ -1179,8 +1287,10 @@ var CREATE_NEXT_APP_DEFAULTS = [
   },
   {
     prefix: "body",
-    pattern: /(?<![\w-])(background|background-color|color)\s*:\s*var\(\s*(--(?:background|foreground))\s*\)/g,
-    item: (m) => `${m[1]}: var(${m[2]})`
+    // WI-0070: create-next-app 의 body `font-family: Arial, Helvetica, sans-serif` 도 같은 특징으로 봅니다. 레이어 밖 규칙이라
+    // AXIS 글꼴(Pretendard, html 에 적용)을 이기고 Button 등이 `font-family: inherit` 로 Arial 을 물려받습니다.
+    pattern: /(?<![\w-])(?:(background|background-color|color)\s*:\s*var\(\s*(--(?:background|foreground))\s*\)|font-family\s*:\s*Arial\b)/g,
+    item: (m) => m[1] !== void 0 ? `${m[1]}: var(${m[2]})` : "font-family: Arial"
   }
 ];
 function findCreateNextAppDefaults(css) {
@@ -1236,9 +1346,54 @@ 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)`;
+var TOKENS_CJS_PRESET_FIXED_VERSION = "1.7.0";
+var TOKENS_TAILWIND3_CJS_REQUIRE = `require("${TOKENS_TAILWIND3_PRESET}").default`;
+var PRESET_REQUIRE_CALL = /\brequire\s*\(\s*(["'])@axis-ds\/tokens\/tailwind\1\s*\)/g;
+var DEFAULT_ACCESS_AHEAD = /^\s*(?:\.\s*default\b|\[\s*["']default["']\s*\])/;
+function hasBareCjsPresetRequire(code) {
+  for (const m of code.matchAll(PRESET_REQUIRE_CALL)) {
+    const start = m.index ?? 0;
+    const end = start + m[0].length;
+    if (DEFAULT_ACCESS_AHEAD.test(code.slice(end))) continue;
+    const before = code.slice(0, start);
+    if (/\b(?:const|let|var)\s*\{[^{}]*\}\s*=\s*$/.test(before)) continue;
+    const bound = /\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*$/.exec(before);
+    if (!bound) return true;
+    const ident = escapeRegExp(bound[1]);
+    const rest = code.slice(0, bound.index) + code.slice(end);
+    const bareUse = new RegExp(`(?<![\\w$.])${ident}(?![\\w$])(?!\\s*(?:\\.\\s*default\\b|\\[\\s*["']default["']\\s*\\]))`);
+    if (bareUse.test(rest)) return true;
+  }
+  return false;
+}
+function isCommonJsConfig(file, source) {
+  return extname(file) === ".cjs" || /\bmodule\.exports\b/.test(source);
+}
+function packageVersionGate(baseDirInput, pkg, name, min) {
+  const baseDir = resolve(baseDirInput);
+  if (!isPnpProject(baseDir)) {
+    const installed = findInstalledPackage(baseDir, name)?.version;
+    if (installed !== void 0) {
+      const cmp = compareExactVersions(installed, min);
+      if (cmp !== void 0) return { status: cmp >= 0 ? "ok" : "below", source: "installed", value: installed };
+    }
+  }
+  const declared = pkg ? hasDependency2(pkg, name) : void 0;
+  if (declared !== void 0) {
+    const atLeast = rangeLowerAtLeast(declared, min);
+    if (atLeast !== void 0) return { status: atLeast ? "ok" : "below", source: "declared", value: declared };
+    return { status: "unknown", source: "declared", value: declared };
+  }
+  return { status: "unknown", source: "none" };
+}
+function versionGateLabel(gate) {
+  if (gate.source === "installed") return `\uC124\uCE58\uBCF8 ${gate.value}`;
+  if (gate.source === "declared") return `\uC120\uC5B8 ${gate.value}`;
+  return "\uC124\uCE58\uBCF8 \xB7 \uC120\uC5B8 \uC5C6\uC74C";
+}
 function readPackageJson(baseDir) {
   try {
-    const parsed = JSON.parse(readFileSync3(join2(baseDir, "package.json"), "utf8"));
+    const parsed = JSON.parse(readFileSync4(join2(baseDir, "package.json"), "utf8"));
     return isPlainObject2(parsed) ? parsed : void 0;
   } catch {
     return void 0;
@@ -1277,7 +1432,7 @@ function checkTailwindSetup(baseDirInput) {
     for (const candidate of TAILWIND_CSS_CANDIDATES) {
       const file = join2(baseDir, candidate);
       if (!existsSync3(file)) continue;
-      const css = readFileSync3(file, "utf8");
+      const css = readFileSync4(file, "utf8");
       if (!hasTailwindImport(css)) {
         return {
           name: "tailwind.config",
@@ -1309,8 +1464,20 @@ function checkTailwindSetup(baseDirInput) {
   for (const file of TAILWIND_CONFIG_FILES) {
     const path11 = join2(baseDir, file);
     if (!existsSync3(path11)) continue;
-    const content = readFileSync3(path11, "utf8");
+    const content = readFileSync4(path11, "utf8");
     if (hasTokensPresetReference(content)) {
+      const code = stripJsComments(content);
+      if (isCommonJsConfig(file, code) && hasBareCjsPresetRequire(code)) {
+        const gate = packageVersionGate(baseDir, pkg, "@axis-ds/tokens", TOKENS_CJS_PRESET_FIXED_VERSION);
+        if (gate.status !== "ok") {
+          const why = gate.status === "below" ? `@axis-ds/tokens ${versionGateLabel(gate)} \uC5D0\uC11C\uB294 CommonJS \uC758 require("${TOKENS_TAILWIND3_PRESET}") \uAC00 preset \uC774 \uC544\uB2C8\uB77C { default } \uB97C \uB3CC\uB824\uC918 \uC0C9 \xB7 keyframes \uAC00 \uC801\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` : `@axis-ds/tokens \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${versionGateLabel(gate)}). ${TOKENS_CJS_PRESET_FIXED_VERSION} \uBBF8\uB9CC\uC774\uBA74 CommonJS \uC758 require("${TOKENS_TAILWIND3_PRESET}") \uB85C\uB294 preset \uC774 \uC801\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`;
+          return {
+            name: "tailwind.config",
+            severity: "warn",
+            message: `${file}\uC5D0 AXIS preset \uCC38\uC870\uAC00 \uC788\uC9C0\uB9CC ${why} \u2192 ${TOKENS_TAILWIND3_CJS_REQUIRE} \uB85C \uBC14\uAFB8\uAC70\uB098 @axis-ds/tokens ${TOKENS_CJS_PRESET_FIXED_VERSION} \uC774\uC0C1`
+          };
+        }
+      }
       return { name: "tailwind.config", severity: "pass", message: `${file}${PRESET_PASS_SUFFIX}` };
     }
     const ownMapping = content.includes("--background") || content.includes("hsl(var(");
@@ -1324,7 +1491,7 @@ function checkTailwindSetup(baseDirInput) {
 }
 function readAxisConfigLike(baseDir) {
   try {
-    const parsed = JSON.parse(readFileSync3(join2(baseDir, "axis.config.json"), "utf8"));
+    const parsed = JSON.parse(readFileSync4(join2(baseDir, "axis.config.json"), "utf8"));
     return isPlainObject2(parsed) ? parsed : void 0;
   } catch {
     return void 0;
@@ -1426,7 +1593,7 @@ function inspectTailwindContent(baseDirInput) {
     }
   }
   if (targets.length === 0) return null;
-  const read = readTailwindContent(readFileSync3(join2(baseDir, configFile), "utf8"));
+  const read = readTailwindContent(readFileSync4(join2(baseDir, configFile), "utf8"));
   const patterns = (read?.globs ?? []).filter((g) => !g.trim().startsWith("!")).map(contentGlobToRegExp);
   return {
     configFile,
@@ -1491,7 +1658,7 @@ function componentsUseAnimation(baseDir, componentsDir) {
       if (st.isDirectory()) {
         if (name !== "node_modules" && depth < ANIMATION_SCAN_DEPTH_LIMIT) stack.push([p, depth + 1]);
       } else if (st.isFile() && st.size <= ANIMATION_SCAN_FILE_BYTES && /\.(tsx|ts|jsx|js)$/.test(name)) {
-        if (/\banimate-(?:in|out)\b/.test(readFileSync3(p, "utf8"))) return true;
+        if (/\banimate-(?:in|out)\b/.test(readFileSync4(p, "utf8"))) return true;
       }
     }
   }
@@ -1508,7 +1675,7 @@ function checkAnimationPlugin(baseDirInput) {
   const tailwind = detectTailwind(baseDir, pkg);
   if (tailwind.major !== void 0 && tailwind.major >= 4) {
     const file = TAILWIND_CSS_CANDIDATES.find((c) => existsSync3(join2(baseDir, c)));
-    const css = file !== void 0 ? stripCssComments(readFileSync3(join2(baseDir, file), "utf8")) : "";
+    const css = file !== void 0 ? stripCssComments(readFileSync4(join2(baseDir, file), "utf8")) : "";
     const ok = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${ANIMATION_PLUGIN_TAILWIND4}["']`).test(css) || new RegExp(`@plugin\\s+["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(css);
     return ok ? { name: "animation", severity: "pass", message: `${file}\uC5D0 \uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC788\uC2B5\uB2C8\uB2E4` } : {
       name: "animation",
@@ -1517,19 +1684,85 @@ function checkAnimationPlugin(baseDirInput) {
     };
   }
   const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync3(join2(baseDir, f)));
-  const source = configFile !== void 0 ? stripJsComments(readFileSync3(join2(baseDir, configFile), "utf8")) : "";
-  const pluginRef = new RegExp(`["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(source);
+  const source = configFile !== void 0 ? stripJsComments(readFileSync4(join2(baseDir, configFile), "utf8")) : "";
+  const plugins = configFile !== void 0 ? readAnimationPluginUse(source) : "absent";
   const pluginDeclared = pkg !== void 0 && hasDependency2(pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0;
-  if (pluginRef && pluginDeclared) {
-    return { name: "animation", severity: "pass", message: `${configFile}\uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uD50C\uB7EC\uADF8\uC778\uC774 \uC788\uC2B5\uB2C8\uB2E4` };
+  const pluginInstalled = pluginDeclared && (isPnpProject(baseDir) || findInstalledPackage(baseDir, ANIMATION_PLUGIN_TAILWIND3) !== void 0);
+  if (plugins === "found" && pluginDeclared && pluginInstalled) {
+    return { name: "animation", severity: "pass", message: `${configFile}\uC758 plugins \uC5D0 ${ANIMATION_PLUGIN_TAILWIND3} \uAC00 \uC788\uC2B5\uB2C8\uB2E4` };
   }
-  const why = !pluginDeclared ? `${ANIMATION_PLUGIN_TAILWIND3} \uBBF8\uC124\uCE58` : `${configFile ?? "tailwind.config"} plugins \uC5D0 \uC5C6\uC74C`;
+  const cfg = configFile ?? "tailwind.config";
+  const reasons = [];
+  if (!pluginDeclared) reasons.push(`${ANIMATION_PLUGIN_TAILWIND3} \uC120\uC5B8 \uC5C6\uC74C`);
+  else if (!pluginInstalled) reasons.push(`${ANIMATION_PLUGIN_TAILWIND3} \uBBF8\uC124\uCE58(\uC120\uC5B8\uB9CC \uC788\uC74C)`);
+  if (plugins === "dynamic") reasons.push(`${cfg} plugins \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD568`);
+  else if (plugins !== "found") reasons.push(`${cfg} plugins \uC5D0 \uC5C6\uC74C`);
   return {
     name: "animation",
     severity: "warn",
-    message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}, ${why}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${ANIMATION_PLUGIN_TAILWIND3} \uC124\uCE58 \uB4A4 plugins \uC5D0 require("${ANIMATION_PLUGIN_TAILWIND3}")`
+    message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}, ${reasons.join(" \xB7 ")}): Dialog \xB7 Select \uB4F1\uC758 \uC5F4\uACE0 \uB2EB\uB294 \uC560\uB2C8\uBA54\uC774\uC158\uC774 \uB3D9\uC791\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2192 ${ANIMATION_PLUGIN_TAILWIND3} \uC124\uCE58 \uB4A4 plugins \uC5D0 require("${ANIMATION_PLUGIN_TAILWIND3}")`
   };
 }
+function readAnimationPluginUse(source) {
+  const name = escapeRegExp(ANIMATION_PLUGIN_TAILWIND3);
+  const idents = /* @__PURE__ */ new Set();
+  for (const m of source.matchAll(new RegExp(`\\bimport\\s+([A-Za-z_$][\\w$]*)\\s+from\\s*(["'])${name}\\2`, "g"))) idents.add(m[1]);
+  for (const m of source.matchAll(
+    new RegExp(`\\b(?:const|let|var)\\s+([A-Za-z_$][\\w$]*)\\s*=\\s*require\\s*\\(\\s*(["'])${name}\\2\\s*\\)`, "g")
+  )) {
+    idents.add(m[1]);
+  }
+  const requireCall = new RegExp(`^require\\s*\\(\\s*(["'])${name}\\1\\s*\\)(?:\\s*\\.\\s*default)?$`);
+  let sawDynamic = false;
+  for (const m of source.matchAll(/\bplugins\b\s*(:)?\s*/g)) {
+    if (m[1] === void 0) {
+      const before = source.slice(Math.max(0, (m.index ?? 0) - 1), m.index ?? 0);
+      if (/[{,\s]/.test(before) || before === "") sawDynamic = true;
+      continue;
+    }
+    const at = (m.index ?? 0) + m[0].length;
+    if (source[at] !== "[") {
+      sawDynamic = true;
+      continue;
+    }
+    const block = balancedSlice(source, at);
+    if (block === void 0) {
+      sawDynamic = true;
+      continue;
+    }
+    const elements = splitTopLevel(block.slice(1, -1));
+    for (const el of elements) {
+      const e = el.trim();
+      if (e === "") continue;
+      if (requireCall.test(e) || idents.has(e) || idents.has(e.replace(/\(\s*\)$/, ""))) return "found";
+      if (/^require\s*\(\s*(["'])[^"']+\1\s*\)(?:\s*\.\s*default)?$/.test(e)) continue;
+      sawDynamic = true;
+    }
+  }
+  return sawDynamic ? "dynamic" : "absent";
+}
+function splitTopLevel(body) {
+  const out = [];
+  let depth = 0;
+  let start = 0;
+  for (let i = 0; i < body.length; i++) {
+    const c = body[i];
+    if (c === '"' || c === "'" || c === "`") {
+      let j = i + 1;
+      while (j < body.length && body[j] !== c) j += body[j] === "\\" ? 2 : 1;
+      i = j;
+      continue;
+    }
+    if (c === "(" || c === "[" || c === "{") depth++;
+    else if (c === ")" || c === "]" || c === "}") depth--;
+    else if (c === "," && depth === 0) {
+      out.push(body.slice(start, i));
+      start = i + 1;
+    }
+  }
+  out.push(body.slice(start));
+  return out;
+}
 
 // ../axis-registry-core/src/utils-deps.ts
 var CLSX_RANGE = "^2.1.1";
@@ -1948,7 +2181,7 @@ function missingDependencies(root, items) {
   const installCommand = detectInstallCommand(root);
   let pkg;
   try {
-    const text = readFileSync4(path5.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
+    const text = readFileSync5(path5.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
     const parsed = JSON.parse(text);
     pkg = isPlainObject(parsed) ? parsed : void 0;
   } catch {
@@ -2069,7 +2302,7 @@ async function runAdd(cwd, requested, options, ctx) {
       continue;
     }
     try {
-      existing.set(file, readFileSync4(file.target, "utf8"));
+      existing.set(file, readFileSync5(file.target, "utf8"));
     } catch (e) {
       readErrors.push(
         `${file.item.name}: \uAE30\uC874 \uD30C\uC77C ${rel(root, file.target)} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${e.code ?? e.message})`
@@ -4174,7 +4407,7 @@ import fs6 from "fs-extra";
 import path9 from "path";
 
 // src/tools/brand-core.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, statSync as statSync5 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
 import { createRequire } from "module";
 import { dirname as dirname3, join as join4, relative, resolve as resolve3, sep } from "path";
 var TOKENS_PACKAGE = "@axis-ds/tokens";
@@ -4196,7 +4429,7 @@ var KEY_TOKENS = [
 ];
 var BRAND_ADJUSTMENT_REFERENCE = "WI-0025 PRD \uBD80\uB85D B (docs/workitems/WI-0025-brand-theme/prd.md)";
 function readJsonFile(file) {
-  return JSON.parse(readFileSync7(file, "utf8"));
+  return JSON.parse(readFileSync8(file, "utf8"));
 }
 function errorCode(err) {
   return typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
@@ -4235,7 +4468,7 @@ function resolveTokens(baseDir) {
 function brandImportPath(entry) {
   return tokensSpecifier(entry.css);
 }
-function isFile(file) {
+function isFile2(file) {
   try {
     return statSync5(file).isFile();
   } catch {
@@ -4248,12 +4481,12 @@ function findGlobalCss(baseDir, config) {
   const configured = config?.globalCss;
   if (typeof configured === "string" && configured.trim() !== "") {
     const file = resolve3(root, configured);
-    if (isFile(file)) return { path: file };
+    if (isFile2(file)) return { path: file };
     result.configuredMissing = configured;
   }
   for (const candidate of GLOBAL_CSS_CANDIDATES) {
     const file = join4(root, candidate);
-    if (isFile(file)) {
+    if (isFile2(file)) {
       result.path = file;
       break;
     }
@@ -4272,7 +4505,7 @@ var AXIS_CONFIG_FILE_NAME = "axis.config.json";
 function readBrandConfig(baseDir) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync7(join4(resolve3(baseDir), AXIS_CONFIG_FILE_NAME), "utf8"));
+    parsed = JSON.parse(readFileSync8(join4(resolve3(baseDir), AXIS_CONFIG_FILE_NAME), "utf8"));
   } catch {
     return null;
   }
@@ -4291,7 +4524,7 @@ function inspectBrandImport(baseDir) {
     return { ...base, state: "css-missing", imports: [] };
   }
   const cssFile = relative(root, location.path).split(sep).join("/");
-  const imports = [...new Set(findBrandImports(readFileSync7(location.path, "utf8")))];
+  const imports = [...new Set(findBrandImports(readFileSync8(location.path, "utf8")))];
   let state;
   if (imports.includes(brand)) state = "match";
   else if (imports.length === 0) state = "import-missing";
@@ -4375,34 +4608,23 @@ function pickKeyTokens(decls) {
   }
   return out;
 }
+var THEME_MARKUP_BRAND_MIN_VERSION = "1.7.0";
 function providerExample(name) {
   return [
-    "// 1) Provider \uC5C6\uC774: \uB8E8\uD2B8 \uB808\uC774\uC544\uC6C3(app/layout.tsx)\uC758 <html> \uC5D0 \uBD99\uC785\uB2C8\uB2E4(\uCCAB \uD654\uBA74\uBD80\uD130 \uC801\uC6A9)",
+    "// 1) \uB8E8\uD2B8 \uB808\uC774\uC544\uC6C3(app/layout.tsx)\uC758 <html> \uC5D0 \uBD99\uC785\uB2C8\uB2E4(\uCCAB \uD654\uBA74\uBD80\uD130 \uC801\uC6A9)",
+    `//    ThemeProvider \uB97C \uD568\uAED8 \uC4F0\uBA74 @axis-ds/theme ${THEME_MARKUP_BRAND_MIN_VERSION} \uC774\uC0C1\uC774 \uD544\uC694\uD569\uB2C8\uB2E4(\uADF8 \uC544\uB798\uB294 \uB9C8\uC6B4\uD2B8 \uB54C \uC18D\uC131\uC744 \uC9C0\uC6C0)`,
     `<html lang="ko" data-brand="${name}">`,
     "",
-    "// 2) ThemeProvider \uB97C \uC4F0\uBA74 \uB9C8\uC6B4\uD2B8 \uB54C \uBE0C\uB79C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 \uC18D\uC131\uC744 \uC9C0\uC6B0\uBBC0\uB85C setBrand \uB85C \uCF2D\uB2C8\uB2E4(\uC800\uC7A5\uB3FC \uC720\uC9C0, setBrand(undefined) \uB85C \uB054)",
+    `// 2) \uC0AC\uC6A9\uC790\uAC00 \uACE0\uB974\uAC8C \uD558\uB824\uBA74 setBrand \uB85C \uCF1C\uACE0 \uB055\uB2C8\uB2E4(\uC800\uC7A5\uB3FC \uC720\uC9C0, setBrand(undefined) \uB85C \uB048 \uC0C1\uD0DC \uC720\uC9C0\uB294 ${THEME_MARKUP_BRAND_MIN_VERSION} \uC774\uC0C1)`,
     'import { useTheme } from "@axis-ds/theme";',
     "const { setBrand } = useTheme();",
     `setBrand("${name}");`
   ].join("\n");
 }
-var BRAND_ACTIVATION_FILES = [
-  "app/layout.tsx",
-  "app/layout.jsx",
-  "app/layout.js",
-  "src/app/layout.tsx",
-  "src/app/layout.jsx",
-  "src/app/layout.js",
-  "pages/_app.tsx",
-  "pages/_app.jsx",
-  "pages/_document.tsx",
-  "pages/_document.jsx",
-  "src/pages/_app.tsx",
-  "src/pages/_app.jsx",
-  "src/pages/_document.tsx",
-  "src/pages/_document.jsx"
-];
+var BRAND_ACTIVATION_FILES = ROOT_LAYOUT_FILES;
 var BRAND_ACTIVATION_PATTERN = /data-brand|setBrand\s*\(|defaultBrand\s*=/;
+var PROVIDER_ACTIVATION_PATTERN = /setBrand\s*\(|defaultBrand\s*=/;
+var THEME_PROVIDER_PATTERN = /<ThemeProvider\b/;
 function stripJsLikeComments(src) {
   return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:"'`])\/\/[^\n]*/g, "$1");
 }
@@ -4411,17 +4633,25 @@ function findBrandActivation(baseDir) {
   const layoutFiles = [];
   for (const candidate of BRAND_ACTIVATION_FILES) {
     const file = join4(root, candidate);
-    if (!isFile(file)) continue;
+    if (!isFile2(file)) continue;
     layoutFiles.push(candidate);
-    const text = stripJsLikeComments(readFileSync7(file, "utf8"));
-    if (BRAND_ACTIVATION_PATTERN.test(text)) return { found: candidate, layoutFiles };
+    const text = stripJsLikeComments(readFileSync8(file, "utf8"));
+    const providerTexts = [];
     for (const m of text.matchAll(/from\s+["']\.\/(providers?)["']/g)) {
       for (const ext of [".tsx", ".jsx", ".ts", ".js"]) {
         const rel2 = `${dirname3(candidate)}/${m[1]}${ext}`;
         const p = join4(root, rel2);
-        if (isFile(p) && BRAND_ACTIVATION_PATTERN.test(stripJsLikeComments(readFileSync7(p, "utf8")))) {
-          return { found: rel2, layoutFiles };
-        }
+        if (isFile2(p)) providerTexts.push({ rel: rel2, text: stripJsLikeComments(readFileSync8(p, "utf8")) });
+      }
+    }
+    const all = [text, ...providerTexts.map((x) => x.text)];
+    const markupWithProvider = !all.some((t) => PROVIDER_ACTIVATION_PATTERN.test(t)) && all.some((t) => THEME_PROVIDER_PATTERN.test(t));
+    if (BRAND_ACTIVATION_PATTERN.test(text)) {
+      return markupWithProvider ? { found: candidate, layoutFiles, markupWithProvider } : { found: candidate, layoutFiles };
+    }
+    for (const x of providerTexts) {
+      if (BRAND_ACTIVATION_PATTERN.test(x.text)) {
+        return markupWithProvider ? { found: x.rel, layoutFiles, markupWithProvider } : { found: x.rel, layoutFiles };
       }
     }
   }
@@ -4431,7 +4661,18 @@ function inspectBrandActivation(baseDir) {
   const config = readBrandConfig(baseDir);
   const brand = config?.brand;
   if (typeof brand !== "string" || brand.trim() === "") return null;
-  return { brand, ...findBrandActivation(baseDir) };
+  const location = findBrandActivation(baseDir);
+  if (!location.markupWithProvider) return { brand, ...location };
+  return { brand, ...location, theme: packageVersionGate(baseDir, readProjectPackageJson(baseDir), THEME_PACKAGE, THEME_MARKUP_BRAND_MIN_VERSION) };
+}
+var THEME_PACKAGE = "@axis-ds/theme";
+function readProjectPackageJson(baseDir) {
+  try {
+    const parsed = JSON.parse(readFileSync8(join4(resolve3(baseDir), "package.json"), "utf8"));
+    return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
 }
 function getBrand(baseDir, name) {
   const tokens = resolveTokens(baseDir);
@@ -4449,7 +4690,7 @@ function getBrand(baseDir, name) {
   try {
     summary = readSummary(baseDir, entry);
     const cssPath = projectRequire(baseDir).resolve(summary.importPath);
-    parsed = parseBrandCss(readFileSync7(cssPath, "utf8"), name);
+    parsed = parseBrandCss(readFileSync8(cssPath, "utf8"), name);
   } catch (err) {
     if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brand: null, available: [] };
     throw err;
@@ -4467,6 +4708,57 @@ function getBrand(baseDir, name) {
   };
 }
 
+// ../axis-registry-core/src/template/dependencies-core.ts
+import { readFileSync as readFileSync9 } from "fs";
+import { join as join5, resolve as resolve4 } from "path";
+var REQUIRED_DEPENDENCIES = ["tailwindcss"];
+var RECOMMENDED_DEPENDENCIES = ["clsx", "tailwind-merge"];
+function declaredAxisPackages(pkg) {
+  const out = [];
+  for (const field of ["dependencies", "devDependencies"]) {
+    const deps = pkg[field];
+    if (!isPlainObject(deps)) continue;
+    for (const name of Object.keys(deps)) if (name.startsWith("@axis-ds/") && !out.includes(name)) out.push(name);
+  }
+  return out;
+}
+function checkDependencies(baseDirInput) {
+  const baseDir = resolve4(baseDirInput);
+  let pkg;
+  try {
+    const parsed = JSON.parse(readFileSync9(join5(baseDir, "package.json"), "utf8"));
+    if (!isPlainObject(parsed)) throw new Error("not object");
+    pkg = parsed;
+  } catch (err) {
+    if (err?.code === "ENOENT") {
+      return { name: "dependencies", severity: "fail", message: "package.json \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+    }
+    return { name: "dependencies", severity: "fail", message: "package.json \uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(JSON \uD655\uC778)" };
+  }
+  const missingRequired = REQUIRED_DEPENDENCIES.filter((d) => !hasDependency(pkg, d));
+  if (missingRequired.length > 0) {
+    return { name: "dependencies", severity: "fail", message: `\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}` };
+  }
+  const missingRecommended = RECOMMENDED_DEPENDENCIES.filter((d) => !hasDependency(pkg, d));
+  const targets = [
+    ...[...REQUIRED_DEPENDENCIES, ...RECOMMENDED_DEPENDENCIES].filter((d) => hasDependency(pkg, d) !== void 0),
+    ...declaredAxisPackages(pkg)
+  ];
+  const pnp = isPnpProject(baseDir);
+  const notInstalled = pnp ? [] : targets.filter((d) => findInstalledPackage(baseDir, d) === void 0);
+  const problems = [];
+  if (missingRecommended.length > 0) problems.push(`\uAD8C\uC7A5 \uC758\uC874\uC131 \uB204\uB77D: ${missingRecommended.join(", ")}`);
+  if (notInstalled.length > 0) {
+    problems.push(`\uC120\uC5B8\uB410\uC9C0\uB9CC \uC124\uCE58\uB418\uC9C0 \uC54A\uC740 \uC758\uC874\uC131: ${notInstalled.join(", ")} \u2192 ${detectInstallCommand(baseDir)}`);
+  }
+  if (problems.length > 0) return { name: "dependencies", severity: "warn", message: problems.join(" / ") };
+  return {
+    name: "dependencies",
+    severity: "pass",
+    message: pnp ? `\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uC120\uC5B8\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (Plug'n'Play \uB77C \uC124\uCE58\uBCF8\uC740 \uD655\uC778\uD558\uC9C0 \uC54A\uC74C, ${targets.length}\uAC1C)` : `\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uC120\uC5B8 \xB7 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (${targets.length}\uAC1C \uD655\uC778)`
+  };
+}
+
 // src/site.ts
 var AXIS_SITE_URL2 = "https://axis-design-system.pages.dev";
 
@@ -4622,6 +4914,15 @@ function brandCheckResult(check) {
   }
 }
 function brandActivationResult(check) {
+  if (check.found && check.theme && check.theme.status !== "ok") {
+    const label = versionGateLabel(check.theme);
+    const why = check.theme.status === "below" ? `@axis-ds/theme ${label} \uC758 ThemeProvider \uAC00 \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6C1\uB2C8\uB2E4` : `@axis-ds/theme \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${label}). ${THEME_MARKUP_BRAND_MIN_VERSION} \uBBF8\uB9CC\uC774\uBA74 ThemeProvider \uAC00 \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6C1\uB2C8\uB2E4`;
+    return {
+      name: "brand.activation",
+      severity: "warn",
+      message: `${check.found}\uC758 <html data-brand> \uB97C ${why} \u2192 @axis-ds/theme ${THEME_MARKUP_BRAND_MIN_VERSION} \uC774\uC0C1\uC73C\uB85C \uC62C\uB9AC\uAC70\uB098 setBrand("${check.brand}")`
+    };
+  }
   if (check.found) {
     return {
       name: "brand.activation",
@@ -4676,40 +4977,7 @@ async function handleCheckProject(params) {
       message: "utils.ts\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 \uC2DC \uD544\uC694)"
     });
   }
-  const pkgPath = path9.join(baseDir, "package.json");
-  if (await fs6.pathExists(pkgPath)) {
-    const pkg = await fs6.readJSON(pkgPath);
-    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const required = ["tailwindcss"];
-    const recommended = ["clsx", "tailwind-merge"];
-    const missingRequired = required.filter((d) => !allDeps[d]);
-    const missingRecommended = recommended.filter((d) => !allDeps[d]);
-    if (missingRequired.length > 0) {
-      results.push({
-        name: "dependencies",
-        severity: "fail",
-        message: `\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}`
-      });
-    } else if (missingRecommended.length > 0) {
-      results.push({
-        name: "dependencies",
-        severity: "warn",
-        message: `\uAD8C\uC7A5 \uC758\uC874\uC131 \uB204\uB77D: ${missingRecommended.join(", ")}`
-      });
-    } else {
-      results.push({
-        name: "dependencies",
-        severity: "pass",
-        message: "\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uBAA8\uB450 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4"
-      });
-    }
-  } else {
-    results.push({
-      name: "dependencies",
-      severity: "fail",
-      message: "package.json \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-    });
-  }
+  results.push(checkDependencies(baseDir));
   const brandCheck = inspectBrandImport(baseDir);
   if (brandCheck) results.push(brandCheckResult(brandCheck));
   const activation = inspectBrandActivation(baseDir);