@axis-ds/mcp 1.3.2 → 1.3.4

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 statSync2 } 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 } 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";
@@ -885,10 +885,92 @@ function hasDependency(pkg, name) {
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function addCommandFor(installCommand, deps) {
+  const specs = Object.entries(deps).map(([name, range]) => `"${name}@${range}"`).join(" ");
+  if (installCommand.startsWith("yarn")) return `yarn add ${specs}`;
+  if (installCommand.startsWith("npm")) return `npm install ${specs}`;
+  return `pnpm add ${specs}`;
+}
+var GLOBAL_CSS_CANDIDATES = [
+  "app/globals.css",
+  "src/app/globals.css",
+  "styles/globals.css",
+  "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, 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];
@@ -975,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) {
@@ -1023,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` };
   }
@@ -1097,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;
@@ -1166,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) {
@@ -1223,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;
@@ -1264,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",
@@ -1293,29 +1461,307 @@ function checkTailwindSetup(baseDirInput) {
       message: `${label}: @import "tailwindcss" \uB97C \uD655\uC778\uD560 CSS \uD30C\uC77C\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4`
     };
   }
-  const [tsFile, ...otherFiles] = TAILWIND_CONFIG_FILES;
-  const tsPath = join2(baseDir, tsFile);
-  if (existsSync3(tsPath)) {
-    const content = readFileSync3(tsPath, "utf8");
-    const hasTokens = content.includes("--background") || content.includes("hsl(var(");
-    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" };
-    }
+  for (const file of TAILWIND_CONFIG_FILES) {
+    const path11 = join2(baseDir, file);
+    if (!existsSync3(path11)) continue;
+    const content = readFileSync4(path11, "utf8");
     if (hasTokensPresetReference(content)) {
-      return { name: "tailwind.config", severity: "pass", message: `tailwind.config.ts${PRESET_PASS_SUFFIX}` };
+      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}` };
     }
-    return { name: "tailwind.config", severity: "warn", message: "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+    const ownMapping = content.includes("--background") || content.includes("hsl(var(");
+    return {
+      name: "tailwind.config",
+      severity: "warn",
+      message: ownMapping ? `${file}\uC5D0 AXIS preset(${TOKENS_TAILWIND3_PRESET})\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC790\uCCB4 CSS \uBCC0\uC218 \uB9E4\uD551\uB9CC \uC788\uC74C, presets \uC5D0 \uB123\uC73C\uC138\uC694)` : `${file}\uC5D0 AXIS preset(${TOKENS_TAILWIND3_PRESET})\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (presets \uC5D0 \uB123\uC73C\uC138\uC694)`
+    };
   }
-  for (const file of otherFiles) {
-    const path11 = join2(baseDir, file);
-    if (existsSync3(path11)) {
-      if (hasTokensPresetReference(readFileSync3(path11, "utf8"))) {
-        return { name: "tailwind.config", severity: "pass", message: `${file}${PRESET_PASS_SUFFIX}` };
+  return { name: "tailwind.config", severity: "fail", message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+}
+function readAxisConfigLike(baseDir) {
+  try {
+    const parsed = JSON.parse(readFileSync4(join2(baseDir, "axis.config.json"), "utf8"));
+    return isPlainObject2(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function contentGlobToRegExp(glob) {
+  const g = glob.trim().replace(/^\.\//, "");
+  let re = "";
+  for (let i = 0; i < g.length; i++) {
+    const c = g[i];
+    if (c === "*") {
+      if (g[i + 1] === "*") {
+        const slash = g[i + 2] === "/";
+        re += slash ? "(?:.*/)?" : ".*";
+        i += slash ? 2 : 1;
+      } else re += "[^/]*";
+    } else if (c === "?") re += "[^/]";
+    else if (c === "{") {
+      const end = g.indexOf("}", i);
+      if (end === -1) {
+        re += "\\{";
+        continue;
+      }
+      re += `(?:${g.slice(i + 1, end).split(",").map((part) => part.replace(/[.+^$()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*")).join("|")})`;
+      i = end;
+    } else if (c === "[") {
+      const end = g.indexOf("]", i);
+      if (end === -1) re += "\\[";
+      else {
+        re += g.slice(i, end + 1);
+        i = end;
       }
-      return { name: "tailwind.config", severity: "warn", message: `${file} \uC874\uC7AC (TypeScript \uAD8C\uC7A5)` };
+    } else re += c.replace(/[.+^$()|\\]/g, "\\$&");
+  }
+  return new RegExp(`^${re}$`);
+}
+function balancedSlice(src, start) {
+  const open = src[start];
+  const close = open === "[" ? "]" : "}";
+  let depth = 0;
+  for (let i = start; i < src.length; i++) {
+    const c = src[i];
+    if (c === '"' || c === "'" || c === "`") {
+      let j = i + 1;
+      while (j < src.length && src[j] !== c) j += src[j] === "\\" ? 2 : 1;
+      i = j;
+      continue;
     }
+    if (c === open) depth++;
+    else if (c === close && --depth === 0) return src.slice(start, i + 1);
   }
-  return { name: "tailwind.config", severity: "fail", message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+  return void 0;
+}
+function stringLiterals(src) {
+  return [...src.matchAll(/(["'`])((?:\\.|(?!\1)[^\\])*)\1/g)].map((m) => m[2]).filter((s) => !s.includes("${"));
+}
+function readTailwindContent(source) {
+  const src = stripJsComments(source);
+  const key = /\bcontent\s*:\s*/g;
+  for (const m of src.matchAll(key)) {
+    let at = (m.index ?? 0) + m[0].length;
+    let block = src[at] === "[" || src[at] === "{" ? balancedSlice(src, at) : void 0;
+    if (block === void 0) continue;
+    if (block.startsWith("{")) {
+      const files = /\bfiles\s*:\s*\[/.exec(block);
+      if (!files) return { globs: [], dynamic: true };
+      at = files.index + files[0].length - 1;
+      block = balancedSlice(block, at);
+      if (block === void 0) return { globs: [], dynamic: true };
+    }
+    const inner = block.slice(1, -1);
+    const globs = stringLiterals(inner);
+    const rest = inner.replace(/(["'`])((?:\\.|(?!\1)[^\\])*)\1/g, "").replace(/[\s,]/g, "");
+    return { globs, dynamic: rest !== "" };
+  }
+  return void 0;
+}
+function normalizeRel(p) {
+  const s = p.trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+  if (s === "" || s.startsWith("../") || s.startsWith("/") || /^[A-Za-z]:/.test(s)) return void 0;
+  return s;
+}
+function inspectTailwindContent(baseDirInput) {
+  const baseDir = resolve(baseDirInput);
+  const pkg = readPackageJson(baseDir);
+  const tailwind = detectTailwind(baseDir, pkg);
+  if (tailwind.major !== void 0 && tailwind.major >= 4) return null;
+  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync3(join2(baseDir, f)));
+  if (configFile === void 0) return null;
+  const targets = [];
+  const componentsDir = readAxisConfigLike(baseDir)?.componentsDir;
+  const rel2 = typeof componentsDir === "string" ? normalizeRel(componentsDir) : void 0;
+  if (rel2 !== void 0) {
+    targets.push({ label: `componentsDir(${componentsDir})`, sample: `${rel2}/button.tsx`, suggest: `./${rel2}/**/*.{ts,tsx}` });
+  }
+  for (const name of TAILWIND4_COMPONENT_PACKAGES) {
+    if (pkg !== void 0 && hasDependency2(pkg, name) !== void 0) {
+      targets.push({ label: name, sample: `node_modules/${name}/dist/index.js`, suggest: `./node_modules/${name}/dist/**/*.{js,mjs}` });
+    }
+  }
+  if (targets.length === 0) return null;
+  const read = readTailwindContent(readFileSync4(join2(baseDir, configFile), "utf8"));
+  const patterns = (read?.globs ?? []).filter((g) => !g.trim().startsWith("!")).map(contentGlobToRegExp);
+  return {
+    configFile,
+    unreadable: read === void 0,
+    dynamic: read?.dynamic ?? false,
+    targets: targets.map((t) => ({ ...t, covered: patterns.some((re) => re.test(t.sample)) }))
+  };
+}
+function checkTailwindContent(baseDir) {
+  const r = inspectTailwindContent(baseDir);
+  if (r === null) return null;
+  const missing = r.targets.filter((t) => !t.covered);
+  if (missing.length === 0) {
+    return {
+      name: "tailwind.content",
+      severity: "pass",
+      message: `${r.configFile}\uC758 content \uAC00 ${r.targets.map((t) => t.label).join(" \xB7 ")} \uB97C \uB36E\uC2B5\uB2C8\uB2E4`
+    };
+  }
+  const list = missing.map((t) => `${t.label} \u2192 "${t.suggest}"`).join(" \xB7 ");
+  if (r.unreadable || r.dynamic) {
+    return {
+      name: "tailwind.content",
+      severity: "warn",
+      message: `${r.configFile}\uC758 content \uB97C \uC815\uC801\uC73C\uB85C \uB2E4 \uC77D\uC9C0 \uBABB\uD574 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4: ${list}`
+    };
+  }
+  return {
+    name: "tailwind.content",
+    severity: "fail",
+    message: `${r.configFile}\uC758 content \uAC00 \uCEF4\uD3EC\uB10C\uD2B8 \uACBD\uB85C\uB97C \uB36E\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uD074\uB798\uC2A4\uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC74C): ${list}`
+  };
+}
+var ANIMATION_PLUGIN_TAILWIND3 = "tailwindcss-animate";
+var ANIMATION_PLUGIN_TAILWIND4 = "tw-animate-css";
+var ANIMATION_SCAN_ENTRY_LIMIT = 2e3;
+var ANIMATION_SCAN_DEPTH_LIMIT = 8;
+var ANIMATION_SCAN_FILE_BYTES = 512 * 1024;
+function componentsUseAnimation(baseDir, componentsDir) {
+  const rel2 = normalizeRel(componentsDir);
+  if (rel2 === void 0) return false;
+  const stack = [[join2(baseDir, rel2), 0]];
+  let visited = 0;
+  while (stack.length > 0) {
+    const [dir, depth] = stack.pop();
+    let names;
+    try {
+      names = readdirSync(dir);
+    } catch {
+      continue;
+    }
+    for (const name of names) {
+      if (++visited > ANIMATION_SCAN_ENTRY_LIMIT) return false;
+      const p = join2(dir, name);
+      let st;
+      try {
+        st = lstatSync(p);
+      } catch {
+        continue;
+      }
+      if (st.isSymbolicLink()) continue;
+      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(readFileSync4(p, "utf8"))) return true;
+      }
+    }
+  }
+  return false;
+}
+function checkAnimationPlugin(baseDirInput) {
+  const baseDir = resolve(baseDirInput);
+  const pkg = readPackageJson(baseDir);
+  const config = readAxisConfigLike(baseDir);
+  const declared = pkg !== void 0 && hasDependency2(pkg, "@axis-ds/ui-react") !== void 0;
+  const copied = typeof config?.componentsDir === "string" && componentsUseAnimation(baseDir, config.componentsDir);
+  if (!declared && !copied) return null;
+  const by = declared ? "@axis-ds/ui-react \uC120\uC5B8" : "componentsDir \uC758 animate-in \uB958 \uD074\uB798\uC2A4";
+  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(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",
+      severity: "warn",
+      message: `\uC560\uB2C8\uBA54\uC774\uC158 \uD50C\uB7EC\uADF8\uC778\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(${by}): 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_TAILWIND4} \uC124\uCE58 \uB4A4 @import "${ANIMATION_PLUGIN_TAILWIND4}";`
+    };
+  }
+  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync3(join2(baseDir, f)));
+  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;
+  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 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}, ${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
@@ -1332,7 +1778,7 @@ function selectUtilsDependencies(tailwind) {
 }
 
 // ../axis-registry-core/src/add/safe-write.ts
-import { constants as fsConstants, existsSync as existsSync4, lstatSync, realpathSync, statSync } from "fs";
+import { constants as fsConstants, existsSync as existsSync4, lstatSync as lstatSync2, realpathSync, statSync as statSync2 } from "fs";
 import path4 from "path";
 import fs2 from "fs-extra";
 var NEW_FILE_FLAGS = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | (fsConstants.O_NOFOLLOW ?? 0);
@@ -1370,7 +1816,7 @@ function escapeReason(root, target, options = {}) {
   }
   let st = null;
   try {
-    st = lstatSync(target);
+    st = lstatSync2(target);
   } catch {
     st = null;
   }
@@ -1388,7 +1834,7 @@ function escapeReason(root, target, options = {}) {
     }
     let followed;
     try {
-      followed = statSync(realTarget);
+      followed = statSync2(realTarget);
     } catch {
       return `\uAE30\uC874 \uD30C\uC77C \uC815\uBCF4\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${target})`;
     }
@@ -1404,7 +1850,7 @@ function escapeReason(root, target, options = {}) {
 }
 function isSymlink(p) {
   try {
-    return lstatSync(p).isSymbolicLink();
+    return lstatSync2(p).isSymbolicLink();
   } catch {
     return false;
   }
@@ -1420,7 +1866,7 @@ function outsideLinkTarget(root, target) {
 }
 function hardLinkCount(target) {
   try {
-    const st = lstatSync(target);
+    const st = lstatSync2(target);
     return st.isFile() && st.nlink >= 2 ? st.nlink : null;
   } catch {
     return null;
@@ -1660,7 +2106,7 @@ function relativeSpecifierResolves(fromFile, spec) {
   const base = path5.resolve(path5.dirname(fromFile), spec);
   return RESOLVE_EXTS.some((ext) => {
     try {
-      return statSync2(base + ext).isFile();
+      return statSync3(base + ext).isFile();
     } catch {
       return false;
     }
@@ -1735,7 +2181,7 @@ function missingDependencies(root, items) {
   const installCommand = detectInstallCommand(root);
   let pkg;
   try {
-    const text = readFileSync4(path5.join(root, "package.json"), "utf8").replace(/^/, "");
+    const text = readFileSync5(path5.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
     const parsed = JSON.parse(text);
     pkg = isPlainObject(parsed) ? parsed : void 0;
   } catch {
@@ -1856,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})`
@@ -2417,7 +2863,7 @@ function formatTokenList(result) {
 }
 
 // src/tools/install.ts
-import { statSync as statSync3 } from "fs";
+import { statSync as statSync4 } from "fs";
 import path6 from "path";
 var DEFAULT_LAYOUT_CONFIG = { componentsDir: "components/ui" };
 var MCP_ADD_HINTS = {
@@ -2456,7 +2902,7 @@ async function handleInstallComponent(params, deps = {}) {
   const root = path6.resolve(params.targetDir);
   let isDir = false;
   try {
-    isDir = statSync3(root).isDirectory();
+    isDir = statSync4(root).isDirectory();
   } catch {
     isDir = false;
   }
@@ -2570,7 +3016,7 @@ var REUSABLE_PATTERNS = {
 };
 var PROJECT_SPECIFIC_PATTERNS = [
   // 파일 경로
-  /(?:src|packages|apps|lib|components)\/[\w\-\/]+\.(?:ts|tsx|js|jsx|md)/gi,
+  /(?:src|packages|apps|lib|components)\/[\w\-/]+\.(?:ts|tsx|js|jsx|md)/gi,
   // 컴포넌트명 (PascalCase)
   /\b[A-Z][a-z]+(?:[A-Z][a-z]+)+\b/g,
   // 버전
@@ -2584,7 +3030,7 @@ function segmentText(text) {
   const sections = text.split(/(?=^#{1,3}\s)/m);
   return sections.filter((s) => s.trim().length > 50);
 }
-function calculateRepeatability(text, _context) {
+function calculateRepeatability(text) {
   let score = 0;
   const structuredPatterns = [
     REUSABLE_PATTERNS.goal,
@@ -2597,7 +3043,7 @@ function calculateRepeatability(text, _context) {
     }
   }
   if (/^#{1,3}\s/m.test(text)) score += 5;
-  if (/^[\-\*]\s/m.test(text)) score += 3;
+  if (/^[-*]\s/m.test(text)) score += 3;
   if (/^\d+\.\s/m.test(text)) score += 2;
   return Math.min(25, score);
 }
@@ -2648,8 +3094,8 @@ function calculateClarity(text) {
   }
   return Math.min(20, score);
 }
-function calculateScores(text, context) {
-  const repeatability = calculateRepeatability(text, context);
+function calculateScores(text) {
+  const repeatability = calculateRepeatability(text);
   const generality = calculateGenerality(text);
   const independence = calculateIndependence(text);
   const clarity = calculateClarity(text);
@@ -2752,7 +3198,7 @@ function handleDetect(params) {
   const candidates = [];
   for (let i = 0; i < segments.length; i++) {
     const segment = segments[i];
-    const scores = calculateScores(segment, context);
+    const scores = calculateScores(segment);
     if (scores.total >= minScore) {
       candidates.push({
         id: `candidate-${i + 1}`,
@@ -2882,7 +3328,7 @@ var CATEGORY_KEYWORDS = {
   ]
 };
 var PROJECT_PATTERNS = {
-  path: /(?:src|packages|apps|lib|components)\/[\w\-\/]+\.(?:ts|tsx|js|jsx|md)/gi,
+  path: /(?:src|packages|apps|lib|components)\/[\w\-/]+\.(?:ts|tsx|js|jsx|md)/gi,
   name: /\b[A-Z][a-z]+(?:[A-Z][a-z]+)+\b/g,
   version: /\b\d+\.\d+\.\d+(?:-[\w.]+)?\b/g,
   date: /\b\d{4}-\d{2}-\d{2}\b/g,
@@ -2899,7 +3345,7 @@ function calculateRepeatability2(text) {
     score += 4;
     reasons.push(`${headerCount}\uAC1C \uC139\uC158 \uC874\uC7AC`);
   }
-  const listCount = (text.match(/^[\-\*]\s/gm) || []).length;
+  const listCount = (text.match(/^[-*]\s/gm) || []).length;
   const numberedCount = (text.match(/^\d+\.\s/gm) || []).length;
   if (listCount + numberedCount >= 5) {
     score += 8;
@@ -3229,7 +3675,7 @@ function formatAnalyzeResult(result) {
 // src/tools/prompt/refine.ts
 var VARIABLE_PATTERNS = [
   {
-    pattern: /(?:src|packages|apps|lib|components)\/[\w\-\/]+\.(?:ts|tsx|js|jsx|md)/gi,
+    pattern: /(?:src|packages|apps|lib|components)\/[\w\-/]+\.(?:ts|tsx|js|jsx|md)/gi,
     variable: "{{FILE_PATH}}",
     description: "\uD30C\uC77C \uACBD\uB85C",
     type: "path"
@@ -3554,7 +4000,7 @@ function checkRequiredSections(text) {
 function checkHardcodedPaths(text) {
   const hardcodedPatterns = [
     // 절대 경로 (변수화되지 않은)
-    /(?<!{{)(?:src|packages|apps|lib|components)\/[\w\-\/]+\.(?:ts|tsx|js|jsx|md)(?!}})/gi,
+    /(?<!{{)(?:src|packages|apps|lib|components)\/[\w\-/]+\.(?:ts|tsx|js|jsx|md)(?!}})/gi,
     // 특정 프로젝트 경로
     /D:\\|C:\\|\/Users\/|\/home\//gi
   ];
@@ -3586,7 +4032,7 @@ function checkVariablesDocumented(text) {
     undocumented
   };
 }
-function checkDuplicate(text, _basePath) {
+function checkDuplicate(text) {
   const similar = [];
   try {
     const indexPath = path7.resolve(process.cwd(), INDEX_PATH);
@@ -3832,7 +4278,7 @@ function savePromptFile(basePath, category, name, content) {
   fs5.writeFileSync(promptPath, content, "utf-8");
   return `${PROMPTS_BASE_PATH}/${category}/${name}.md`;
 }
-function updateIndex(index, entry, isNew) {
+function updateIndex(index, entry) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const existingIndex = index.prompts.findIndex((p) => p.id === entry.id);
   if (existingIndex >= 0) {
@@ -3900,8 +4346,7 @@ function handleSave(params) {
         description,
         path: relativePath,
         variables
-      },
-      !isDuplicate
+      }
     );
     saveIndex(basePath, index);
     return {
@@ -3962,11 +4407,12 @@ import fs6 from "fs-extra";
 import path9 from "path";
 
 // src/tools/brand-core.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, statSync as statSync4 } 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";
 var MIN_BRAND_TOKENS_VERSION = "1.3.0";
+var TOKENS_DEPENDENCY_MIN_VERSION = "1.6.0";
 var KEY_TOKENS = [
   "--primary",
   "--primary-foreground",
@@ -3983,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;
@@ -4022,10 +4468,9 @@ function resolveTokens(baseDir) {
 function brandImportPath(entry) {
   return tokensSpecifier(entry.css);
 }
-var GLOBAL_CSS_CANDIDATES = ["app/globals.css", "src/app/globals.css", "globals.css"];
-function isFile(file) {
+function isFile2(file) {
   try {
-    return statSync4(file).isFile();
+    return statSync5(file).isFile();
   } catch {
     return false;
   }
@@ -4036,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;
     }
@@ -4060,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;
   }
@@ -4079,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";
@@ -4163,13 +4608,72 @@ function pickKeyTokens(decls) {
   }
   return out;
 }
+var THEME_MARKUP_BRAND_MIN_VERSION = "1.7.0";
 function providerExample(name) {
   return [
-    'import { ThemeProvider } from "@axis-ds/theme";',
+    "// 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}">`,
     "",
-    `<ThemeProvider defaultBrand="${name}">{children}</ThemeProvider>`
+    `// 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 = 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");
+}
+function findBrandActivation(baseDir) {
+  const root = resolve3(baseDir);
+  const layoutFiles = [];
+  for (const candidate of BRAND_ACTIVATION_FILES) {
+    const file = join4(root, candidate);
+    if (!isFile2(file)) continue;
+    layoutFiles.push(candidate);
+    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 (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 };
+      }
+    }
+  }
+  return { layoutFiles };
+}
+function inspectBrandActivation(baseDir) {
+  const config = readBrandConfig(baseDir);
+  const brand = config?.brand;
+  if (typeof brand !== "string" || brand.trim() === "") return null;
+  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);
   if (tokens.status !== "ok" || !tokens.indexPath) {
@@ -4186,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;
@@ -4204,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";
 
@@ -4358,6 +4913,30 @@ 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",
+      severity: "pass",
+      message: `${check.found}\uC5D0 \uBE0C\uB79C\uB4DC\uB97C \uCF1C\uB294 \uCF54\uB4DC(data-brand \xB7 setBrand \uB4F1)\uAC00 \uC788\uC2B5\uB2C8\uB2E4`
+    };
+  }
+  const where = check.layoutFiles.length > 0 ? check.layoutFiles.join(" \xB7 ") : "\uB8E8\uD2B8 \uB808\uC774\uC544\uC6C3(app/layout.tsx \uB4F1)";
+  return {
+    name: "brand.activation",
+    severity: "warn",
+    message: `brand "${check.brand}" \uAC00 \uC124\uC815\uB410\uC9C0\uB9CC ${where}\uC5D0 \uBE0C\uB79C\uB4DC\uB97C \uCF1C\uB294 \uCF54\uB4DC(data-brand \xB7 setBrand \uB4F1)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(ThemeProvider \uB9CC\uC73C\uB85C\uB294 \uB9C8\uC6B4\uD2B8 \uB54C \uAEBC\uC9D0) \u2192 <html data-brand="${check.brand}"> \uB610\uB294 setBrand("${check.brand}")`
+  };
+}
 async function handleCheckProject(params) {
   const baseDir = path9.resolve(params.targetDir || ".");
   const results = [];
@@ -4380,8 +4959,8 @@ async function handleCheckProject(params) {
   for (const candidate of utilsCandidates) {
     const fullPath = path9.join(baseDir, candidate);
     if (await fs6.pathExists(fullPath)) {
-      const content = await fs6.readFile(fullPath, "utf-8");
-      const hasCn = content.includes("function cn");
+      const content2 = await fs6.readFile(fullPath, "utf-8");
+      const hasCn = content2.includes("function cn");
       results.push({
         name: "utils.ts",
         severity: hasCn ? "pass" : "warn",
@@ -4398,42 +4977,15 @@ 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);
+  if (activation) results.push(brandActivationResult(activation));
+  const content = checkTailwindContent(baseDir);
+  if (content) results.push(content);
+  const animation = checkAnimationPlugin(baseDir);
+  if (animation) results.push(animation);
   const summary = {
     pass: results.filter((r) => r.severity === "pass").length,
     warn: results.filter((r) => r.severity === "warn").length,
@@ -4550,7 +5102,7 @@ function formatCheckProjectResult(result) {
 
 // src/tools/brand.ts
 import path10 from "path";
-var TOKENS_INSTALL_COMMAND = `pnpm add ${TOKENS_PACKAGE}@^${MIN_BRAND_TOKENS_VERSION}`;
+var TOKENS_INSTALL_COMMAND = addCommandFor("pnpm install", { [TOKENS_PACKAGE]: `^${TOKENS_DEPENDENCY_MIN_VERSION}` });
 function baseDirOf(targetDir) {
   return path10.resolve(targetDir || process.cwd());
 }