@axis-ds/cli 1.6.0 → 1.6.2

package/dist/index.js

@@ -1106,17 +1106,59 @@ function toSearchItem(c) {
     url: `/library/${c.category}/${c.slug}`
   };
 }
+var sourceTypeOf = (item) => typeof item.source === "string" ? item.source : item.source.type;
+function resolveRouteSlugs(items) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = `${item.category}/${item.slug}`;
+    if (!groups.has(key)) groups.set(key, []);
+    groups.get(key).push(item);
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const [key, group] of groups) {
+    if (group.length === 1) {
+      result.set(group[0].id, group[0].slug);
+      continue;
+    }
+    const axis = group.filter((i) => sourceTypeOf(i) === "axis");
+    if (axis.length > 1) {
+      throw new Error(`\uC0C1\uC138 \uC8FC\uC18C /library/${key} \uB97C AXIS \uD56D\uBAA9 ${axis.map((i) => i.id).join(", ")} \uAC00 \uD568\uAED8 \uC501\uB2C8\uB2E4`);
+    }
+    const keeper = axis[0] || group[0];
+    for (const item of group) {
+      result.set(item.id, item === keeper ? item.slug : `${sourceTypeOf(item)}-${item.slug}`);
+    }
+  }
+  const seen = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = `${item.category}/${result.get(item.id)}`;
+    const other = seen.get(key);
+    if (other !== void 0 && other !== item.id) {
+      throw new Error(`slug \uB97C \uBC14\uAFBC \uB4A4\uC5D0\uB3C4 \uC0C1\uC138 \uC8FC\uC18C /library/${key} \uAC00 ${other}, ${item.id} \uC5D0\uC11C \uACB9\uCE69\uB2C8\uB2E4`);
+    }
+    seen.set(key, item.id);
+  }
+  return result;
+}
+function withRouteSlugs(items) {
+  const slugs = resolveRouteSlugs(items);
+  return items.map((item) => slugs.get(item.id) === item.slug ? item : { ...item, slug: slugs.get(item.id) });
+}
+function componentFileOf(item) {
+  return `components/${item.id}.json`;
+}
 var Publisher = class {
   defaultOutputDir = "apps/web/public/library";
   /**
    * 라이브러리 인덱스를 사이트에 배치
    */
-  async publish(index, options = {}) {
+  async publish(input, options = {}) {
     const outputDir = options.outputDir || this.defaultOutputDir;
     const files = [];
     const errors = [];
     const spinner = ora("\uB77C\uC774\uBE0C\uB7EC\uB9AC \uBC30\uCE58 \uC911...").start();
     try {
+      const index = { ...input, components: withRouteSlugs(input.components) };
       await fs3.ensureDir(outputDir);
       const indexPath = path3.join(outputDir, "index.json");
       await this.writeJson(indexPath, this.createPublicIndex(index), options.minify);
@@ -1143,7 +1185,7 @@ var Publisher = class {
       const componentsDir = path3.join(outputDir, "components");
       await fs3.ensureDir(componentsDir);
       for (const component of index.components) {
-        const componentPath = path3.join(componentsDir, `${component.slug}.json`);
+        const componentPath = path3.join(outputDir, componentFileOf(component));
         await this.writeJson(componentPath, this.createPublicComponent(component), options.minify);
         files.push(componentPath);
       }
@@ -1400,6 +1442,25 @@ async function refreshAxisLibrary(options) {
   }
   for (const f of existingFiles.values()) if (f.data.source?.type === AXIS) oldAxisIds.add(f.data.id);
   const removed = [...oldAxisIds].filter((id) => !axisIds.has(id)).sort();
+  const routeSlugs = resolveRouteSlugs([...extOrder.map((id) => extCategory.get(id)), ...axisComponents]);
+  const renamedSlugs = {};
+  const renamedFrom = {};
+  for (const id of extOrder) {
+    const slug = routeSlugs.get(id);
+    const full = extCategory.get(id);
+    if (slug === full.slug) continue;
+    renamedSlugs[id] = slug;
+    renamedFrom[id] = full.slug;
+    extCategory.set(id, { ...full, slug });
+    extIndex.set(id, { ...extIndex.get(id), slug });
+    const s = extSearch.get(id);
+    extSearch.set(id, { ...s, slug, url: `/library/${s.category}/${slug}` });
+  }
+  for (const c of axisComponents) {
+    const slug = routeSlugs.get(c.id);
+    if (slug === c.slug) continue;
+    throw new Error(`AXIS \uD56D\uBAA9 ${c.id} \uC758 slug \uAC00 ${slug} \uB85C \uBC14\uB00C\uC5B4\uC57C \uD569\uB2C8\uB2E4. \uC218\uC9D1 \uACB0\uACFC\uB97C \uD655\uC778\uD558\uC138\uC694`);
+  }
   const indexEntries = [
     ...extOrder.map((id) => extIndex.get(id)),
     ...axisComponents.map((c) => toIndexEntry(c))
@@ -1457,24 +1518,18 @@ async function refreshAxisLibrary(options) {
       })
     );
   }
-  const finalSlugs = /* @__PURE__ */ new Set();
-  const axisBySlug = new Map(axisComponents.map((c) => [c.slug, c]));
-  for (const c of allPublic) finalSlugs.add(c.slug);
-  const shadowedAxis = [];
-  for (const slug of [...finalSlugs].sort()) {
-    const axis = axisBySlug.get(slug);
-    const existing = existingFiles.get(slug);
-    const extForSlug = extOrder.map((id) => extCategory.get(id)).filter((c) => c.slug === slug);
-    const existingIsExternal = !!existing && extForSlug.some((c) => c.id === existing.data.id);
-    if (existingIsExternal) {
-      if (axis) shadowedAxis.push(axis.id);
-      continue;
-    }
-    if (axis) {
-      outputs.set(`components/${slug}.json`, serialize(axis));
+  const finalFiles = /* @__PURE__ */ new Set();
+  for (const c of allPublic) {
+    const rel3 = componentFileOf(c);
+    finalFiles.add(rel3);
+    if (c.source.type === AXIS) {
+      outputs.set(rel3, serialize(c));
       continue;
     }
-    outputs.set(`components/${slug}.json`, serialize(extForSlug[0]));
+    const same = (f) => f.data?.id === c.id && isDeepStrictEqual(f.data, c);
+    const atKey = existingFiles.get(c.id);
+    const kept = atKey && same(atKey) ? atKey : [...existingFiles.values()].find(same);
+    outputs.set(rel3, kept ? kept.raw : serialize(c));
   }
   const writtenFiles = [];
   for (const [rel3, content] of outputs) {
@@ -1485,13 +1540,13 @@ async function refreshAxisLibrary(options) {
     if (!options.dryRun) await fs4.writeFile(file, content, "utf-8");
   }
   const removedFiles = [];
-  for (const slug of existingFiles.keys()) {
-    if (finalSlugs.has(slug)) continue;
-    const rel3 = `components/${slug}.json`;
+  for (const key of existingFiles.keys()) {
+    const rel3 = `components/${key}.json`;
+    if (finalFiles.has(rel3)) continue;
     removedFiles.push(rel3);
     if (!options.dryRun) await fs4.remove(path4.join(libraryDir, rel3));
   }
-  return { added, changed, unchanged, removed, shadowedAxis, writtenFiles, removedFiles, stats };
+  return { added, changed, unchanged, removed, renamedSlugs, renamedFrom, writtenFiles, removedFiles, stats };
 }
 function registerRefreshAxisCommand(libraryCmd2) {
   libraryCmd2.command("refresh-axis").description("AXIS \uD56D\uBAA9\uB9CC \uC800\uC7A5\uC18C \uC18C\uC2A4\uC5D0\uC11C \uB2E4\uC2DC \uB9CC\uB4E6 (\uC678\uBD80 \uC18C\uC2A4 \uD56D\uBAA9\uC740 \uADF8\uB300\uB85C, \uB124\uD2B8\uC6CC\uD06C \uC5C6\uC74C)").option("--root <dir>", "\uC800\uC7A5\uC18C \uB8E8\uD2B8", process.cwd()).option("-o, --output <dir>", "library \uB514\uB809\uD130\uB9AC (\uB8E8\uD2B8 \uAE30\uC900)", "apps/web/public/library").option("--updated-at <iso>", "\uBC14\uB010 \uD56D\uBAA9\uC5D0 \uAE30\uB85D\uD560 \uC2DC\uAC01 (\uAE30\uBCF8: \uC624\uB298 KST \uB0A0\uC9DC\uC758 00:00:00.000Z)").option("--dry-run", "\uD30C\uC77C\uC744 \uC4F0\uC9C0 \uC54A\uACE0 \uBC14\uB014 \uB0B4\uC6A9\uB9CC \uCD9C\uB825").action(async (opts) => {
@@ -1511,9 +1566,12 @@ ${head}AXIS library \uC7AC\uC0DD\uC131`));
     for (const id of result.added) console.log(chalk2.green(`  + ${id}`));
     for (const id of result.changed) console.log(chalk2.yellow(`  ~ ${id}`));
     for (const id of result.removed) console.log(chalk2.red(`  - ${id}`));
-    if (result.shadowedAxis.length > 0) {
+    const renamed = Object.entries(result.renamedSlugs);
+    if (renamed.length > 0) {
       console.log(
-        chalk2.yellow(`  slug \uAC00 \uC678\uBD80 \uD56D\uBAA9 \uD30C\uC77C\uACFC \uACB9\uCCD0 \uD30C\uC77C\uC744 \uC4F0\uC9C0 \uC54A\uC74C(E4): ${result.shadowedAxis.join(", ")}`)
+        chalk2.yellow(
+          `  \uC0C1\uC138 \uC8FC\uC18C\uAC00 \uACB9\uCCD0 slug \uB97C \uBC14\uAFC8(WI-0060): ${renamed.map(([id, slug]) => `${id}: ${result.renamedFrom[id] ?? id} \u2192 ${slug}`).join(", ")}`
+        )
       );
     }
     console.log(`  \uD30C\uC77C \uC4F0\uAE30 ${result.writtenFiles.length}\uAC1C \xB7 \uC0AD\uC81C ${result.removedFiles.length}\uAC1C`);
@@ -1745,7 +1803,7 @@ import ora5 from "ora";
 
 // src/template/template-apply.ts
 import fs8 from "fs-extra";
-import path8 from "path";
+import path9 from "path";
 import chalk5 from "chalk";
 import ora3 from "ora";
 import prompts from "prompts";
@@ -1843,8 +1901,18 @@ async function readAxisConfig(baseDir) {
 }
 
 // ../axis-registry-core/src/template/tailwind-core.ts
-import { existsSync, lstatSync, readdirSync, readFileSync } from "fs";
-import { join, resolve } from "path";
+import { existsSync as existsSync2, lstatSync, readdirSync, readFileSync as readFileSync2 } from "fs";
+import { extname, join, resolve } from "path";
+
+// ../axis-registry-core/src/project.ts
+import { existsSync, readFileSync, statSync } from "fs";
+import path8 from "path";
+function detectInstallCommand(baseDir) {
+  if (existsSync(path8.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
+  if (existsSync(path8.join(baseDir, "yarn.lock"))) return "yarn install";
+  if (existsSync(path8.join(baseDir, "package-lock.json"))) return "npm install";
+  return "pnpm install";
+}
 function hasDependency(pkg, name) {
   for (const field of ["dependencies", "devDependencies"]) {
     const deps = pkg[field];
@@ -1857,6 +1925,134 @@ 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"
+];
+var TAILWIND_CONFIG_CANDIDATES = [
+  "tailwind.config.ts",
+  "tailwind.config.js",
+  "tailwind.config.mjs",
+  "tailwind.config.cjs"
+];
+function isFile(file) {
+  try {
+    return statSync(file).isFile();
+  } catch {
+    return false;
+  }
+}
+function isDirectory(dir) {
+  try {
+    return statSync(dir).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function findFirstFile(baseDir, candidates) {
+  return candidates.find((c) => isFile(path8.join(baseDir, c)));
+}
+function detectProjectPaths(baseDirInput) {
+  const baseDir = path8.resolve(baseDirInput);
+  const hasSrc = isDirectory(path8.join(baseDir, "src"));
+  const css = findFirstFile(baseDir, GLOBAL_CSS_CANDIDATES);
+  const tw = findFirstFile(baseDir, TAILWIND_CONFIG_CANDIDATES);
+  return {
+    componentsDir: hasSrc ? "./src/components/ui" : "./components/ui",
+    globalCss: css !== void 0 ? `./${css}` : hasSrc ? "./src/app/globals.css" : "./app/globals.css",
+    globalCssSource: css !== void 0 ? "found" : "default",
+    tailwindConfig: tw !== void 0 ? `./${tw}` : "./tailwind.config.ts",
+    tailwindConfigSource: tw !== void 0 ? "found" : "default"
+  };
+}
+function projectFileExists(baseDir, relPath) {
+  return isFile(path8.resolve(baseDir, relPath));
+}
+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 = path8.resolve(baseDirInput);
+  for (; ; ) {
+    const pkgDir = path8.join(dir, "node_modules", ...name.split("/"));
+    const file = path8.join(pkgDir, "package.json");
+    if (isFile(file)) {
+      let version;
+      try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        version = isPlainObject(parsed) ? exactVersionOf(parsed.version) : void 0;
+      } catch {
+        version = void 0;
+      }
+      return { dir: pkgDir, version };
+    }
+    const parent = path8.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function isPnpProject(baseDirInput) {
+  let dir = path8.resolve(baseDirInput);
+  for (; ; ) {
+    if (isFile(path8.join(dir, ".pnp.cjs")) || isFile(path8.join(dir, ".pnp.js"))) return true;
+    const parent = path8.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
+function hasDependency2(pkg, name) {
+  for (const field of ["dependencies", "devDependencies"]) {
+    const deps = pkg[field];
+    if (typeof deps === "object" && deps !== null && name in deps) {
+      return String(deps[name]);
+    }
+  }
+  return void 0;
+}
+function isPlainObject2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 var VERSION = String.raw`v?(\d+)(?:\.(\d+|[xX*]))?(?:\.(\d+|[xX*]))?(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?`;
 function versionParts(token) {
   const m = new RegExp(`^${VERSION}$`).exec(token);
@@ -1930,12 +2126,12 @@ function majorFromVersion(version) {
 function detectTailwind(baseDirInput, pkg) {
   const baseDir = resolve(baseDirInput);
   const installedFile = join(baseDir, "node_modules", "tailwindcss", "package.json");
-  const declared = pkg ? hasDependency(pkg, "tailwindcss") : void 0;
+  const declared = pkg ? hasDependency2(pkg, "tailwindcss") : void 0;
   const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
   const declaredMajor = bounds?.lower;
   try {
-    const installed = JSON.parse(readFileSync(installedFile, "utf8"));
-    const version = isPlainObject(installed) ? installed.version : void 0;
+    const installed = JSON.parse(readFileSync2(installedFile, "utf8"));
+    const version = isPlainObject2(installed) ? installed.version : void 0;
     const major = majorFromVersion(version);
     if (major !== void 0) {
       const found = { major, source: "installed", value: String(version) };
@@ -1982,18 +2178,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 = join(baseDir, candidate);
+    if (!existsSync2(file)) continue;
+    let text;
+    try {
+      text = readFileSync2(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 = join(baseDir, candidate);
-    if (!existsSync(file)) continue;
-    const content = readFileSync(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` };
-    }
+    if (!existsSync2(file)) continue;
+    const content = readFileSync2(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` };
   }
@@ -2056,8 +2291,8 @@ function exactVersion(version) {
 }
 function installedVersion(baseDir, name) {
   try {
-    const parsed = JSON.parse(readFileSync(join(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
-    return isPlainObject(parsed) ? exactVersion(parsed.version) : void 0;
+    const parsed = JSON.parse(readFileSync2(join(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
+    return isPlainObject2(parsed) ? exactVersion(parsed.version) : void 0;
   } catch {
     return void 0;
   }
@@ -2068,7 +2303,7 @@ function axisPackagesBelowTailwind4(pkg, baseDirInput) {
   const out = [];
   const min = lowerOf(TAILWIND4_MIN_AXIS_VERSION);
   for (const name of TAILWIND4_AXIS_PACKAGES) {
-    const range = hasDependency(pkg, name);
+    const range = hasDependency2(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;
@@ -2125,8 +2360,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) {
@@ -2182,10 +2419,55 @@ 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(readFileSync(join(baseDir, "package.json"), "utf8"));
-    return isPlainObject(parsed) ? parsed : void 0;
+    const parsed = JSON.parse(readFileSync2(join(baseDir, "package.json"), "utf8"));
+    return isPlainObject2(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
@@ -2195,7 +2477,7 @@ function tailwind4Issues(css, pkg, versions) {
   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)
+    (name) => pkg !== void 0 && hasDependency2(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(" ")}`);
@@ -2222,8 +2504,8 @@ function checkTailwindSetup(baseDirInput) {
     const label = `Tailwind ${tailwind.major}`;
     for (const candidate of TAILWIND_CSS_CANDIDATES) {
       const file = join(baseDir, candidate);
-      if (!existsSync(file)) continue;
-      const css = readFileSync(file, "utf8");
+      if (!existsSync2(file)) continue;
+      const css = readFileSync2(file, "utf8");
       if (!hasTailwindImport(css)) {
         return {
           name: "tailwind.config",
@@ -2254,9 +2536,21 @@ function checkTailwindSetup(baseDirInput) {
   }
   for (const file of TAILWIND_CONFIG_FILES) {
     const path18 = join(baseDir, file);
-    if (!existsSync(path18)) continue;
-    const content = readFileSync(path18, "utf8");
+    if (!existsSync2(path18)) continue;
+    const content = readFileSync2(path18, "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(");
@@ -2270,8 +2564,8 @@ function checkTailwindSetup(baseDirInput) {
 }
 function readAxisConfigLike(baseDir) {
   try {
-    const parsed = JSON.parse(readFileSync(join(baseDir, "axis.config.json"), "utf8"));
-    return isPlainObject(parsed) ? parsed : void 0;
+    const parsed = JSON.parse(readFileSync2(join(baseDir, "axis.config.json"), "utf8"));
+    return isPlainObject2(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
@@ -2358,7 +2652,7 @@ function inspectTailwindContent(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) => existsSync(join(baseDir, f)));
+  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync2(join(baseDir, f)));
   if (configFile === void 0) return null;
   const targets = [];
   const componentsDir = readAxisConfigLike(baseDir)?.componentsDir;
@@ -2367,12 +2661,12 @@ function inspectTailwindContent(baseDirInput) {
     targets.push({ label: `componentsDir(${componentsDir})`, sample: `${rel3}/button.tsx`, suggest: `./${rel3}/**/*.{ts,tsx}` });
   }
   for (const name of TAILWIND4_COMPONENT_PACKAGES) {
-    if (pkg !== void 0 && hasDependency(pkg, name) !== void 0) {
+    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(readFileSync(join(baseDir, configFile), "utf8"));
+  const read = readTailwindContent(readFileSync2(join(baseDir, configFile), "utf8"));
   const patterns = (read?.globs ?? []).filter((g) => !g.trim().startsWith("!")).map(contentGlobToRegExp);
   return {
     configFile,
@@ -2437,7 +2731,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(readFileSync(p, "utf8"))) return true;
+        if (/\banimate-(?:in|out)\b/.test(readFileSync2(p, "utf8"))) return true;
       }
     }
   }
@@ -2447,14 +2741,14 @@ function checkAnimationPlugin(baseDirInput) {
   const baseDir = resolve(baseDirInput);
   const pkg = readPackageJson(baseDir);
   const config = readAxisConfigLike(baseDir);
-  const declared = pkg !== void 0 && hasDependency(pkg, "@axis-ds/ui-react") !== void 0;
+  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) => existsSync(join(baseDir, c)));
-    const css = file !== void 0 ? stripCssComments(readFileSync(join(baseDir, file), "utf8")) : "";
+    const file = TAILWIND_CSS_CANDIDATES.find((c) => existsSync2(join(baseDir, c)));
+    const css = file !== void 0 ? stripCssComments(readFileSync2(join(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",
@@ -2462,25 +2756,91 @@ function checkAnimationPlugin(baseDirInput) {
       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) => existsSync(join(baseDir, f)));
-  const source = configFile !== void 0 ? stripJsComments(readFileSync(join(baseDir, configFile), "utf8")) : "";
-  const pluginRef = new RegExp(`["']${ANIMATION_PLUGIN_TAILWIND3}["']`).test(source);
-  const pluginDeclared = pkg !== void 0 && hasDependency(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 why = !pluginDeclared ? `${ANIMATION_PLUGIN_TAILWIND3} \uBBF8\uC124\uCE58` : `${configFile ?? "tailwind.config"} plugins \uC5D0 \uC5C6\uC74C`;
+  const configFile = TAILWIND_CONFIG_FILES.find((f) => existsSync2(join(baseDir, f)));
+  const source = configFile !== void 0 ? stripJsComments(readFileSync2(join(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}, ${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;
+}
 
 // src/template/template-apply.ts
 async function templateApplyWarnings(baseDir, detail) {
   const warnings = [];
-  const pkgPath = path8.join(baseDir, "package.json");
+  const pkgPath = path9.join(baseDir, "package.json");
   const templateRange = detail.devDependencies?.tailwindcss ?? detail.dependencies?.tailwindcss;
   const templateMajor = templateRange !== void 0 ? tailwindMajorFromRange(templateRange) : void 0;
   if (templateMajor !== void 0 && await fs8.pathExists(pkgPath)) {
@@ -2498,7 +2858,7 @@ async function templateApplyWarnings(baseDir, detail) {
     }
   }
   const usesRootApp = detail.files.some((f) => f.path.startsWith("app/"));
-  if (usesRootApp && await fs8.pathExists(path8.join(baseDir, "src", "app"))) {
+  if (usesRootApp && await fs8.pathExists(path9.join(baseDir, "src", "app"))) {
     warnings.push(
       "src/app \uC774 \uC788\uB294\uB370 \uD15C\uD50C\uB9BF\uC740 \uB8E8\uD2B8 app/ \uC744 \uC501\uB2C8\uB2E4. Next.js \uB294 \uB8E8\uD2B8 app/ \uC774 \uC788\uC73C\uBA74 src/app \uC744 \uC4F0\uC9C0 \uC54A\uC544 \uAE30\uC874 \uB77C\uC6B0\uD2B8\uAC00 \uBE60\uC9D1\uB2C8\uB2E4."
     );
@@ -2515,13 +2875,13 @@ async function applyTemplate(slug, options) {
     spinner.fail(err.message);
     process.exit(1);
   }
-  const baseDir = path8.resolve(options.dir || ".");
+  const baseDir = path9.resolve(options.dir || ".");
   for (const w of await templateApplyWarnings(baseDir, detail)) {
     console.log(chalk5.yellow(`! ${w}`));
   }
   const conflicts = [];
   for (const file of detail.files) {
-    const dest = path8.join(baseDir, file.path);
+    const dest = path9.join(baseDir, file.path);
     if (await fs8.pathExists(dest)) {
       conflicts.push(file.path);
     }
@@ -2546,7 +2906,7 @@ async function applyTemplate(slug, options) {
   if (options.dryRun) {
     console.log(chalk5.blue("\n[\uBBF8\uB9AC\uBCF4\uAE30] \uC0DD\uC131\uB420 \uD30C\uC77C:"));
     for (const file of detail.files) {
-      const dest = path8.join(baseDir, file.path);
+      const dest = path9.join(baseDir, file.path);
       const exists = conflicts.includes(file.path);
       const label = exists ? chalk5.yellow("\uB36E\uC5B4\uC4F0\uAE30") : chalk5.green("\uC0DD\uC131");
       console.log(`  ${label} ${dest}`);
@@ -2561,8 +2921,8 @@ async function applyTemplate(slug, options) {
   }
   const writeSpinner = ora3("\uD30C\uC77C \uC0DD\uC131 \uC911...").start();
   for (const file of detail.files) {
-    const dest = path8.join(baseDir, file.path);
-    await fs8.ensureDir(path8.dirname(dest));
+    const dest = path9.join(baseDir, file.path);
+    await fs8.ensureDir(path9.dirname(dest));
     await fs8.writeFile(dest, file.content);
   }
   writeSpinner.succeed(`${detail.files.length}\uAC1C \uD30C\uC77C \uC0DD\uC131 \uC644\uB8CC`);
@@ -2623,7 +2983,7 @@ async function initTemplate(slug, options) {
     }
     targetDir = dir;
   }
-  const resolved = path8.resolve(targetDir);
+  const resolved = path9.resolve(targetDir);
   if (await fs8.pathExists(resolved)) {
     const entries = await fs8.readdir(resolved);
     if (entries.length > 0) {
@@ -2639,7 +2999,7 @@ async function initTemplate(slug, options) {
     await fs8.ensureDir(resolved);
   }
   await applyTemplate(selectedSlug, { dir: targetDir, yes: true });
-  const configPath = path8.join(resolved, "axis.config.json");
+  const configPath = path9.join(resolved, "axis.config.json");
   if (!await fs8.pathExists(configPath)) {
     const axisConfig = createTemplateConfig(selectedSlug);
     await fs8.writeJSON(configPath, axisConfig, { spaces: 2 });
@@ -2654,7 +3014,7 @@ async function initTemplate(slug, options) {
 
 // src/template/template-diff.ts
 import fs9 from "fs-extra";
-import path9 from "path";
+import path10 from "path";
 import chalk6 from "chalk";
 import ora4 from "ora";
 async function diffTemplate(slug, options) {
@@ -2667,10 +3027,10 @@ async function diffTemplate(slug, options) {
     spinner.fail(err.message);
     process.exit(1);
   }
-  const baseDir = path9.resolve(options.dir || ".");
+  const baseDir = path10.resolve(options.dir || ".");
   const entries = [];
   for (const file of detail.files) {
-    const localPath = path9.join(baseDir, file.path);
+    const localPath = path10.join(baseDir, file.path);
     if (!await fs9.pathExists(localPath)) {
       entries.push({ path: file.path, status: "added" });
       continue;
@@ -2751,12 +3111,12 @@ async function collectLocalFiles(dir, base) {
   }
   for (const entry of entries) {
     if (ignore.has(entry.name)) continue;
-    const fullPath = path9.join(dir, entry.name);
+    const fullPath = path10.join(dir, entry.name);
     if (entry.isDirectory()) {
       const nested = await collectLocalFiles(fullPath, root);
       results.push(...nested);
     } else {
-      results.push(path9.relative(root, fullPath).replace(/\\/g, "/"));
+      results.push(path10.relative(root, fullPath).replace(/\\/g, "/"));
     }
   }
   return results;
@@ -2768,85 +3128,9 @@ import path11 from "path";
 import chalk7 from "chalk";
 
 // src/theme/brand-core.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { createRequire } from "module";
 import { dirname, join as join2, relative, resolve as resolve2, sep } from "path";
-
-// ../axis-registry-core/src/project.ts
-import { existsSync as existsSync2, statSync } from "fs";
-import path10 from "path";
-function detectInstallCommand(baseDir) {
-  if (existsSync2(path10.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
-  if (existsSync2(path10.join(baseDir, "yarn.lock"))) return "yarn install";
-  if (existsSync2(path10.join(baseDir, "package-lock.json"))) return "npm install";
-  return "pnpm install";
-}
-function hasDependency2(pkg, name) {
-  for (const field of ["dependencies", "devDependencies"]) {
-    const deps = pkg[field];
-    if (typeof deps === "object" && deps !== null && name in deps) {
-      return String(deps[name]);
-    }
-  }
-  return void 0;
-}
-function isPlainObject2(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"
-];
-var TAILWIND_CONFIG_CANDIDATES = [
-  "tailwind.config.ts",
-  "tailwind.config.js",
-  "tailwind.config.mjs",
-  "tailwind.config.cjs"
-];
-function isFile(file) {
-  try {
-    return statSync(file).isFile();
-  } catch {
-    return false;
-  }
-}
-function isDirectory(dir) {
-  try {
-    return statSync(dir).isDirectory();
-  } catch {
-    return false;
-  }
-}
-function findFirstFile(baseDir, candidates) {
-  return candidates.find((c) => isFile(path10.join(baseDir, c)));
-}
-function detectProjectPaths(baseDirInput) {
-  const baseDir = path10.resolve(baseDirInput);
-  const hasSrc = isDirectory(path10.join(baseDir, "src"));
-  const css = findFirstFile(baseDir, GLOBAL_CSS_CANDIDATES);
-  const tw = findFirstFile(baseDir, TAILWIND_CONFIG_CANDIDATES);
-  return {
-    componentsDir: hasSrc ? "./src/components/ui" : "./components/ui",
-    globalCss: css !== void 0 ? `./${css}` : hasSrc ? "./src/app/globals.css" : "./app/globals.css",
-    globalCssSource: css !== void 0 ? "found" : "default",
-    tailwindConfig: tw !== void 0 ? `./${tw}` : "./tailwind.config.ts",
-    tailwindConfigSource: tw !== void 0 ? "found" : "default"
-  };
-}
-function projectFileExists(baseDir, relPath) {
-  return isFile(path10.resolve(baseDir, relPath));
-}
-
-// src/theme/brand-core.ts
 var TOKENS_PACKAGE = "@axis-ds/tokens";
 var BRAND_NAME_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 var MIN_BRAND_TOKENS_VERSION = "1.3.0";
@@ -2867,7 +3151,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(readFileSync2(file, "utf8"));
+  return JSON.parse(readFileSync3(file, "utf8"));
 }
 function errorCode(err) {
   return typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
@@ -2943,7 +3227,7 @@ var AXIS_CONFIG_FILE_NAME = "axis.config.json";
 function readBrandConfig(baseDir) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync2(join2(resolve2(baseDir), AXIS_CONFIG_FILE_NAME), "utf8"));
+    parsed = JSON.parse(readFileSync3(join2(resolve2(baseDir), AXIS_CONFIG_FILE_NAME), "utf8"));
   } catch {
     return null;
   }
@@ -2962,7 +3246,7 @@ function inspectBrandImport(baseDir) {
     return { ...base, state: "css-missing", imports: [] };
   }
   const cssFile = relative(root, location.path).split(sep).join("/");
-  const imports = [...new Set(findBrandImports(readFileSync2(location.path, "utf8")))];
+  const imports = [...new Set(findBrandImports(readFileSync3(location.path, "utf8")))];
   let state;
   if (imports.includes(brand)) state = "match";
   else if (imports.length === 0) state = "import-missing";
@@ -3046,34 +3330,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");
 }
@@ -3084,15 +3357,23 @@ function findBrandActivation(baseDir) {
     const file = join2(root, candidate);
     if (!isFile2(file)) continue;
     layoutFiles.push(candidate);
-    const text = stripJsLikeComments(readFileSync2(file, "utf8"));
-    if (BRAND_ACTIVATION_PATTERN.test(text)) return { found: candidate, layoutFiles };
+    const text = stripJsLikeComments(readFileSync3(file, "utf8"));
+    const providerTexts = [];
     for (const m of text.matchAll(/from\s+["']\.\/(providers?)["']/g)) {
       for (const ext of [".tsx", ".jsx", ".ts", ".js"]) {
         const rel3 = `${dirname(candidate)}/${m[1]}${ext}`;
         const p = join2(root, rel3);
-        if (isFile2(p) && BRAND_ACTIVATION_PATTERN.test(stripJsLikeComments(readFileSync2(p, "utf8")))) {
-          return { found: rel3, layoutFiles };
-        }
+        if (isFile2(p)) providerTexts.push({ rel: rel3, text: stripJsLikeComments(readFileSync3(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 };
       }
     }
   }
@@ -3102,7 +3383,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(readFileSync3(join2(resolve2(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);
@@ -3120,7 +3412,7 @@ function getBrand(baseDir, name) {
   try {
     summary = readSummary(baseDir, entry);
     const cssPath = projectRequire(baseDir).resolve(summary.importPath);
-    parsed = parseBrandCss(readFileSync2(cssPath, "utf8"), name);
+    parsed = parseBrandCss(readFileSync3(cssPath, "utf8"), name);
   } catch (err) {
     if (isMissingBuildFile(err)) return { status: "not-built", version: tokens.version, brand: null, available: [] };
     throw err;
@@ -3138,6 +3430,57 @@ function getBrand(baseDir, name) {
   };
 }
 
+// ../axis-registry-core/src/template/dependencies-core.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { join as join3, resolve as resolve3 } 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 = resolve3(baseDirInput);
+  let pkg;
+  try {
+    const parsed = JSON.parse(readFileSync4(join3(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/template/template-check.ts
 var SEVERITY_ICON = {
   pass: chalk7.green("PASS"),
@@ -3151,7 +3494,7 @@ async function collectCheckResults(dir) {
   results.push(checkTailwindSetup(baseDir));
   results.push(checkGlobalsCss(baseDir));
   results.push(await checkUtils(baseDir));
-  results.push(await checkDependencies(baseDir));
+  results.push(checkDependencies(baseDir));
   const brand = checkBrand(baseDir);
   if (brand) results.push(brand);
   const activation = inspectBrandActivation(baseDir);
@@ -3229,41 +3572,6 @@ async function checkUtils(baseDir) {
     message: "utils.ts\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 \uC2DC \uD544\uC694)"
   };
 }
-async function checkDependencies(baseDir) {
-  const pkgPath = path11.join(baseDir, "package.json");
-  if (!await fs10.pathExists(pkgPath)) {
-    return {
-      name: "package.json",
-      severity: "fail",
-      message: "package.json \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-    };
-  }
-  const pkg = await fs10.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) {
-    return {
-      name: "dependencies",
-      severity: "fail",
-      message: `\uD544\uC218 \uC758\uC874\uC131 \uB204\uB77D: ${missingRequired.join(", ")}`
-    };
-  }
-  if (missingRecommended.length > 0) {
-    return {
-      name: "dependencies",
-      severity: "warn",
-      message: `\uAD8C\uC7A5 \uC758\uC874\uC131 \uB204\uB77D: ${missingRecommended.join(", ")}`
-    };
-  }
-  return {
-    name: "dependencies",
-    severity: "pass",
-    message: "\uD544\uC218 \uBC0F \uAD8C\uC7A5 \uC758\uC874\uC131\uC774 \uBAA8\uB450 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4"
-  };
-}
 function checkBrand(baseDir) {
   const check = inspectBrandImport(baseDir);
   return check ? brandCheckResult(check) : null;
@@ -3299,6 +3607,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",
@@ -3422,14 +3739,13 @@ import chalk9 from "chalk";
 import path13 from "path";
 
 // src/theme/theme-add.ts
-import { accessSync, constants, existsSync as existsSync4, readFileSync as readFileSync3, realpathSync, unlinkSync, writeFileSync } from "fs";
+import { accessSync, constants, existsSync as existsSync4, readFileSync as readFileSync5, realpathSync, unlinkSync, writeFileSync } from "fs";
 import path12 from "path";
 var TOKENS_DEPENDENCY_RANGE = `^${TOKENS_DEPENDENCY_MIN_VERSION}`;
 var TAILWIND3_BASE_IMPORTS = [`${TOKENS_PACKAGE}/css`, `${TOKENS_PACKAGE}/css/shadcn`];
-var THEME_PACKAGE = "@axis-ds/theme";
 var THEME_MIN_VERSION = "1.3.0";
 function readText(file) {
-  return existsSync4(file) ? readFileSync3(file, "utf8") : null;
+  return existsSync4(file) ? readFileSync5(file, "utf8") : null;
 }
 function eolOf(text) {
   return text.includes("\r\n") ? "\r\n" : "\n";
@@ -3551,7 +3867,7 @@ function planThemeAdd(baseDirInput, brand) {
   let config;
   try {
     const parsed = JSON.parse(configText);
-    if (!isPlainObject2(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+    if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
     config = parsed;
   } catch (err) {
     plan.errors.push({ kind: "invalid-config", message: err.message });
@@ -3563,7 +3879,7 @@ function planThemeAdd(baseDirInput, brand) {
   }
   plan.tokens = resolveTokens(baseDir);
   if (plan.tokens.status === "ok" && plan.tokens.indexPath) {
-    const data = JSON.parse(readFileSync3(plan.tokens.indexPath, "utf8"));
+    const data = JSON.parse(readFileSync5(plan.tokens.indexPath, "utf8"));
     const entries = Array.isArray(data.brands) ? data.brands : [];
     const entry = entries.find((e) => e.name === brand);
     if (!entry) {
@@ -3585,7 +3901,7 @@ function planThemeAdd(baseDirInput, brand) {
   if (pkgText !== null) {
     try {
       const parsed = JSON.parse(pkgText);
-      if (!isPlainObject2(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+      if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
       pkg = parsed;
     } catch (err) {
       plan.errors.push({ kind: "invalid-package-json", message: err.message });
@@ -3597,7 +3913,7 @@ function planThemeAdd(baseDirInput, brand) {
   const tailwind4 = tailwind.major !== void 0 && tailwind.major >= 4;
   const requiredBaseImports = tailwind4 ? [
     TOKENS_TAILWIND4_ENTRY,
-    ...TAILWIND4_COMPONENT_PACKAGES.filter((n) => pkg !== void 0 && hasDependency2(pkg, n) !== void 0).map(
+    ...TAILWIND4_COMPONENT_PACKAGES.filter((n) => pkg !== void 0 && hasDependency(pkg, n) !== void 0).map(
       (n) => `${n}/tailwind.css`
     )
   ] : [...TAILWIND3_BASE_IMPORTS];
@@ -3614,7 +3930,7 @@ function planThemeAdd(baseDirInput, brand) {
       plan.writes = [];
       return plan;
     }
-    const before = readFileSync3(location.path, "utf8");
+    const before = readFileSync5(location.path, "utf8");
     const imported = findBrandImports(before);
     const otherBrands = [...new Set(imported.filter((n) => n !== brand))];
     const brandAdded = !imported.includes(brand);
@@ -3651,7 +3967,7 @@ function planThemeAdd(baseDirInput, brand) {
     const content = inspectTailwindContent(baseDir);
     plan.tailwindConfig = {
       configFile: configFile2,
-      presetMissing: configFile2 === void 0 || !hasTokensPresetReference(readFileSync3(path12.join(baseDir, configFile2), "utf8")),
+      presetMissing: configFile2 === void 0 || !hasTokensPresetReference(readFileSync5(path12.join(baseDir, configFile2), "utf8")),
       contentMissing: content?.targets.filter((t) => !t.covered) ?? [],
       contentUnknown: content !== null && (content.unreadable || content.dynamic)
     };
@@ -3664,12 +3980,12 @@ function planThemeAdd(baseDirInput, brand) {
   if (pkgText === null || pkg === void 0) {
     plan.dependency = { action: "no-package-json", upgrade, themeMissing: false, tokensAddCommand, themeAddCommand };
   } else {
-    const themeMissing = hasDependency2(pkg, THEME_PACKAGE) === void 0;
-    const declared = hasDependency2(pkg, TOKENS_PACKAGE);
+    const themeMissing = hasDependency(pkg, THEME_PACKAGE) === void 0;
+    const declared = hasDependency(pkg, TOKENS_PACKAGE);
     if (declared !== void 0) {
       plan.dependency = { action: "present", declaredRange: declared, upgrade, themeMissing, tokensAddCommand, themeAddCommand };
     } else {
-      const deps = isPlainObject2(pkg.dependencies) ? { ...pkg.dependencies } : {};
+      const deps = isPlainObject(pkg.dependencies) ? { ...pkg.dependencies } : {};
       deps[TOKENS_PACKAGE] = TOKENS_DEPENDENCY_RANGE;
       const next = { ...pkg, dependencies: deps };
       plan.dependency = { action: "add", upgrade, themeMissing, tokensAddCommand, themeAddCommand };
@@ -3754,6 +4070,25 @@ function applyThemeAdd(plan) {
 }
 
 // src/theme/index.ts
+function importOffset(css, spec) {
+  const escaped = spec.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const m = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${escaped}["']`).exec(css);
+  return m ? m.index : -1;
+}
+function baseImportLines(after, spec, brandImportPath2, file) {
+  if (spec.endsWith("/tailwind.css")) {
+    return [`  ${chalk9.green("\u2713")} ${file}: @import "${spec}"; \uCD94\uAC00(\uCEF4\uD3EC\uB10C\uD2B8 \uC2A4\uCE94 \uACBD\uB85C, \uC704\uCE58 \uBB34\uAD00)`];
+  }
+  const at = importOffset(after, spec);
+  const brandAt = importOffset(after, brandImportPath2);
+  if (brandAt === -1 || at !== -1 && at < brandAt) {
+    return [`  ${chalk9.green("\u2713")} ${file}: @import "${spec}"; \uCD94\uAC00(\uAE30\uBCF8 \uD1A0\uD070 CSS, \uBE0C\uB79C\uB4DC \uC55E)`];
+  }
+  return [
+    `  ${chalk9.green("\u2713")} ${file}: @import "${spec}"; \uCD94\uAC00(\uAE30\uBCF8 \uD1A0\uD070 CSS)`,
+    chalk9.yellow(`  ! \uC774 \uC904\uC774 \uBE0C\uB79C\uB4DC import \uB4A4\uC5D0 \uB4E4\uC5B4\uAC14\uC2B5\uB2C8\uB2E4. \uBE0C\uB79C\uB4DC \uAC12\uC774 \uAE30\uBCF8 \uD1A0\uD070\uC5D0 \uB36E\uC774\uBBC0\uB85C @import "${brandImportPath2}"; \uC55E\uC73C\uB85C \uC62E\uAE30\uC138\uC694`)
+  ];
+}
 function tokensInstallCommand(baseDir) {
   return addCommandFor(detectInstallCommand(baseDir), { [TOKENS_PACKAGE]: TOKENS_DEPENDENCY_RANGE });
 }
@@ -3941,8 +4276,9 @@ function renderThemeAdd(plan, written) {
   }
   const brandLine = `@import "${plan.importPath}";`;
   if (css?.action === "add" && css.file) {
+    const after = plan.writes.find((w) => w.file === css.file)?.after ?? "";
     for (const spec of css.baseImports) {
-      lines.push(`  ${chalk9.green("\u2713")} ${rel(plan, css.file)}: @import "${spec}"; \uCD94\uAC00(\uAE30\uBCF8 \uD1A0\uD070 CSS, \uBE0C\uB79C\uB4DC \uC55E)`);
+      lines.push(...baseImportLines(after, spec, plan.importPath, rel(plan, css.file)));
     }
     if (css.brandAdded) lines.push(`  ${chalk9.green("\u2713")} ${rel(plan, css.file)}: ${brandLine} \uCD94\uAC00`);
     else lines.push(`  ${chalk9.gray("-")} ${rel(plan, css.file)}: \uBE0C\uB79C\uB4DC import \uAC00 \uC774\uBBF8 \uC788\uC5B4 \uAC74\uB108\uB700`);
@@ -4002,7 +4338,8 @@ function renderThemeAdd(plan, written) {
     lines.push("", chalk9.bold(`Tailwind \uC124\uC815 (${tw.configFile ?? "tailwind.config"}, \uD30C\uC77C\uC740 \uACE0\uCE58\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4)`));
     if (tw.presetMissing) {
       lines.push(
-        chalk9.yellow(`  ! AXIS preset \uC774 \uC5C6\uC2B5\uB2C8\uB2E4. presets \uC5D0 \uB123\uC73C\uC138\uC694: presets: [require("${TOKENS_TAILWIND3_PRESET}")]`) + chalk9.gray(` (ESM \uC774\uBA74 import axisPreset from "${TOKENS_TAILWIND3_PRESET}")`)
+        // WI-0072: CommonJS 는 모든 tokens 버전에서 동작하는 `.default` 형태로 안내합니다(1.6.2 이하의 bare require 는 preset 이 빠짐)
+        chalk9.yellow(`  ! AXIS preset \uC774 \uC5C6\uC2B5\uB2C8\uB2E4. presets \uC5D0 \uB123\uC73C\uC138\uC694: presets: [${TOKENS_TAILWIND3_CJS_REQUIRE}]`) + chalk9.gray(` (ESM \xB7 TypeScript \uC774\uBA74 import axisPreset from "${TOKENS_TAILWIND3_PRESET}" \uB4A4 presets: [axisPreset])`)
       );
     }
     for (const t of tw.contentMissing) {
@@ -4017,6 +4354,13 @@ function renderThemeAdd(plan, written) {
   lines.push("", chalk9.bold(`\uBE0C\uB79C\uB4DC \uCF1C\uAE30 (ThemeProvider \uB294 ${THEME_PACKAGE} ${THEME_MIN_VERSION} \uC774\uC0C1)`));
   if (act?.found) {
     lines.push(`  ${chalk9.gray("-")} ${act.found} \uC5D0 \uBE0C\uB79C\uB4DC\uB97C \uCF1C\uB294 \uCF54\uB4DC(data-brand \xB7 setBrand \uB4F1)\uAC00 \uC788\uC2B5\uB2C8\uB2E4. "${plan.brand}" \uB85C \uCF1C\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694.`);
+    if (act.markupWithProvider) {
+      lines.push(
+        chalk9.yellow(
+          `  ! <html data-brand> \uC640 ThemeProvider \uB97C \uD568\uAED8 \uC4F0\uBA74 ${THEME_PACKAGE} ${THEME_MARKUP_BRAND_MIN_VERSION} \uC774\uC0C1\uC774\uC5B4\uC57C \uB9C8\uC6B4\uD2B8 \uB54C \uC9C0\uC6CC\uC9C0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uBCF8 \uD655\uC778: axis check`
+        )
+      );
+    }
   } else {
     lines.push(
       ...providerExample(plan.brand).split("\n").map((l) => l ? `  ${l}` : ""),
@@ -4387,7 +4731,7 @@ async function fetchRegistryJson(url, options = {}) {
 }
 
 // src/init/init.ts
-import { accessSync as accessSync2, constants as constants2, existsSync as existsSync6, lstatSync as lstatSync3, readFileSync as readFileSync4, realpathSync as realpathSync3, statSync as statSync4, writeFileSync as writeFileSync2 } from "fs";
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync6, lstatSync as lstatSync3, readFileSync as readFileSync6, realpathSync as realpathSync3, statSync as statSync4, writeFileSync as writeFileSync2 } from "fs";
 import path15 from "path";
 import chalk10 from "chalk";
 import fs12 from "fs-extra";
@@ -4644,7 +4988,7 @@ async function resolveInitAnswers(baseDirInput, tailwind4) {
 }
 function animationGuideLine(pkg, tailwind4, installCommand) {
   const name = tailwind4 ? ANIMATION_PLUGIN_TAILWIND4 : ANIMATION_PLUGIN_TAILWIND3;
-  if (pkg !== void 0 && (hasDependency2(pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0 || hasDependency2(pkg, ANIMATION_PLUGIN_TAILWIND4) !== void 0)) {
+  if (pkg !== void 0 && (hasDependency(pkg, ANIMATION_PLUGIN_TAILWIND3) !== void 0 || hasDependency(pkg, ANIMATION_PLUGIN_TAILWIND4) !== void 0)) {
     return void 0;
   }
   const add = `${addCommandFor(installCommand, {}).trimEnd()} ${name}`;
@@ -4659,15 +5003,15 @@ var TAILWIND4_TOKENS_VERSION = TAILWIND4_MIN_AXIS_VERSION;
 var TAILWIND4_CONFLICT_LINE = "  ! create-next-app \uAE30\uBCF8 globals.css \uC758 :root \xB7 @theme inline \xB7 @media (prefers-color-scheme: dark) \xB7 body \uBE14\uB85D\uC740 AXIS \uC640 \uAC19\uC740 \uC774\uB984(--background \xB7 --foreground \xB7 --color-background \xB7 --font-sans \xB7 --font-mono)\uC744 \uB2E4\uB978 \uAC12\uC73C\uB85C \uC815\uC758\uD569\uB2C8\uB2E4. \uC774 \uBE14\uB85D\uB4E4\uC744 \uC9C0\uC6B0\uC138\uC694.";
 function readPackageJsonSafe(baseDir) {
   try {
-    const text = readFileSync4(path15.join(baseDir, "package.json"), "utf8");
+    const text = readFileSync6(path15.join(baseDir, "package.json"), "utf8");
     const parsed = JSON.parse(text.startsWith(BOM) ? text.slice(1) : text);
-    return isPlainObject2(parsed) ? parsed : void 0;
+    return isPlainObject(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
 }
 function tailwind4GuideLines(pkg, installCommand, globalCss, baseDir) {
-  const used = TAILWIND4_COMPONENT_PACKAGES.filter((name) => pkg !== void 0 && hasDependency2(pkg, name) !== void 0);
+  const used = TAILWIND4_COMPONENT_PACKAGES.filter((name) => pkg !== void 0 && hasDependency(pkg, name) !== void 0);
   const lines = [
     `Tailwind 4: \uC804\uC5ED CSS(${globalCss}) \uB9E8 \uC704\uC5D0 \uB2E4\uC74C \uC904\uC744 \uB123\uC73C\uC138\uC694(\uD30C\uC77C\uC740 \uACE0\uCE58\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4).`,
     '  @import "tailwindcss";',
@@ -4680,7 +5024,7 @@ function tailwind4GuideLines(pkg, installCommand, globalCss, baseDir) {
     );
   }
   lines.push(TAILWIND4_CONFLICT_LINE);
-  if (pkg === void 0 || hasDependency2(pkg, TOKENS_PACKAGE) === void 0) {
+  if (pkg === void 0 || hasDependency(pkg, TOKENS_PACKAGE) === void 0) {
     const add = addCommandFor(installCommand, { [TOKENS_PACKAGE]: `^${TAILWIND4_TOKENS_VERSION}` });
     lines.push(`  ${TOKENS_PACKAGE} \uC124\uCE58: ${add}`);
   }
@@ -4743,7 +5087,7 @@ function planUtilsDependencies(baseDirInput) {
   if (!where.inside) return unwritable(`\uC2E4\uC81C \uC704\uCE58(${where.realPath})\uAC00 \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC \uBC16\uC785\uB2C8\uB2E4`);
   let text;
   try {
-    text = readFileSync4(pkgFile, "utf8");
+    text = readFileSync6(pkgFile, "utf8");
   } catch (err) {
     return unwritable(err.message);
   }
@@ -4752,7 +5096,7 @@ function planUtilsDependencies(baseDirInput) {
   let pkg;
   try {
     const parsed = JSON.parse(body);
-    if (!isPlainObject2(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+    if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
     pkg = parsed;
   } catch (err) {
     return unwritable(`JSON \uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${err.message}`);
@@ -4762,14 +5106,14 @@ function planUtilsDependencies(baseDirInput) {
   plan.addCommand = addCommandFor(installCommand, plan.ranges);
   const missing = {};
   for (const [name, range] of Object.entries(plan.ranges)) {
-    const declared = hasDependency2(pkg, name);
+    const declared = hasDependency(pkg, name);
     if (declared !== void 0) plan.present.push({ name, range: declared });
     else missing[name] = range;
   }
   plan.added = Object.keys(missing);
   plan.addCommand = addCommandFor(installCommand, plan.added.length > 0 ? missing : plan.ranges);
   if (plan.added.length === 0) return { ...plan, action: "present" };
-  if (pkg.dependencies !== void 0 && !isPlainObject2(pkg.dependencies)) {
+  if (pkg.dependencies !== void 0 && !isPlainObject(pkg.dependencies)) {
     return unwritable("dependencies \uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
   }
   try {
@@ -4786,7 +5130,7 @@ function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile
   const w = plan.write;
   if (plan.action !== "add" || !w) return false;
   const baseDir = path15.resolve(baseDirInput);
-  const current = existsSync6(w.file) ? readFileSync4(w.file, "utf8") : null;
+  const current = existsSync6(w.file) ? readFileSync6(w.file, "utf8") : null;
   if (current !== w.before) {
     throw new Error(`${w.file} \uC774 \uACC4\uD68D \uB4A4\uC5D0 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.`);
   }
@@ -4802,7 +5146,7 @@ function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile
     let restored;
     try {
       writeFile(w.file, w.before);
-      if (readFileSync4(w.file, "utf8") !== w.before) throw new Error("\uB418\uB3CC\uB9B0 \uB0B4\uC6A9\uC774 \uC6D0\uB798 \uB0B4\uC6A9\uACFC \uB2E4\uB985\uB2C8\uB2E4");
+      if (readFileSync6(w.file, "utf8") !== w.before) throw new Error("\uB418\uB3CC\uB9B0 \uB0B4\uC6A9\uC774 \uC6D0\uB798 \uB0B4\uC6A9\uACFC \uB2E4\uB985\uB2C8\uB2E4");
       restored = "\uC6D0\uB798 \uB0B4\uC6A9\uC73C\uB85C \uB418\uB3CC\uB838\uC2B5\uB2C8\uB2E4";
     } catch (restoreErr) {
       restored = `\uC6D0\uB798 \uB0B4\uC6A9\uC73C\uB85C \uB418\uB3CC\uB9AC\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4(${restoreErr.message}). \uD30C\uC77C\uC774 \uC798\uB838\uAC70\uB098 \uBE44\uC5C8\uC744 \uC218 \uC788\uC73C\uB2C8 \uBC84\uC804 \uAD00\uB9AC \uB3C4\uAD6C \uB4F1\uC73C\uB85C \uBCF5\uAD6C\uD558\uC138\uC694`;
@@ -4840,7 +5184,7 @@ function reportDependencies(plan, log) {
 async function existingConfig(baseDir) {
   try {
     const parsed = await readAxisConfig(baseDir);
-    return isPlainObject2(parsed) ? parsed : null;
+    return isPlainObject(parsed) ? parsed : null;
   } catch {
     return null;
   }
@@ -4913,7 +5257,7 @@ function planUtilsWrite(baseDirInput, utilsPath) {
     if (!target.isFile()) return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4` };
     let content2;
     try {
-      content2 = readFileSync4(utilsPath, "utf8");
+      content2 = readFileSync6(utilsPath, "utf8");
     } catch (e) {
       return { action: "reject", reason: `${shown} \uB9C1\uD06C \uB300\uC0C1(${real})\uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
     }
@@ -4928,7 +5272,7 @@ function planUtilsWrite(baseDirInput, utilsPath) {
   if (!st.isFile()) return { action: "reject", reason: `${shown} \uC774 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2C8\uB77C \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4` };
   let content;
   try {
-    content = readFileSync4(utilsPath, "utf8");
+    content = readFileSync6(utilsPath, "utf8");
   } catch (e) {
     return { action: "reject", reason: `\uAE30\uC874 ${shown} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${errCode(e)})` };
   }
@@ -5129,12 +5473,12 @@ import chalk12 from "chalk";
 import prompts3 from "prompts";
 
 // ../axis-registry-core/src/add/add.ts
-import { existsSync as existsSync8, readFileSync as readFileSync6, statSync as statSync5 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
 import path17 from "path";
 import fs13 from "fs-extra";
 
 // ../axis-registry-core/src/registry/bundled.ts
-import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
 import path16 from "path";
 import { fileURLToPath } from "url";
 function findBundledRegistryDir(moduleUrl = import.meta.url) {
@@ -5148,7 +5492,7 @@ function readBundledJson(dir, fileName) {
   const file = path16.join(dir, fileName);
   let text;
   try {
-    text = readFileSync5(file, "utf8");
+    text = readFileSync7(file, "utf8");
   } catch {
     throw new Error(`\uB3D9\uBD09 \uB808\uC9C0\uC2A4\uD2B8\uB9AC\uC5D0 ${fileName} \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4(${dir})`);
   }
@@ -5336,7 +5680,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((resolve3, reject) => {
+  return (input, init) => new Promise((resolve4, reject) => {
     let url;
     try {
       url = new URL(input);
@@ -5377,7 +5721,7 @@ function createPinnedFetch(options = {}) {
           if (failed) return;
           const body = Buffer.concat(chunks).toString("utf8");
           const status = res.statusCode ?? 0;
-          resolve3({ ok: status >= 200 && status < 300, status, text: async () => body });
+          resolve4({ ok: status >= 200 && status < 300, status, text: async () => body });
         });
       }
     );
@@ -5863,9 +6207,9 @@ function missingDependencies(root, items) {
   const installCommand = detectInstallCommand(root);
   let pkg;
   try {
-    const text = readFileSync6(path17.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
+    const text = readFileSync8(path17.join(root, "package.json"), "utf8").replace(/^\uFEFF/, "");
     const parsed = JSON.parse(text);
-    pkg = isPlainObject2(parsed) ? parsed : void 0;
+    pkg = isPlainObject(parsed) ? parsed : void 0;
   } catch {
     pkg = void 0;
   }
@@ -5874,7 +6218,7 @@ function missingDependencies(root, items) {
   for (const item of items) {
     for (const dep of item.dependencies) {
       const name = dependencyName(dep);
-      if (pkg !== void 0 && hasDependency2(pkg, name) !== void 0) continue;
+      if (pkg !== void 0 && hasDependency(pkg, name) !== void 0) continue;
       if (name in specs) continue;
       const explicit = dep.length > name.length ? dep.slice(name.length + 1) : void 0;
       specs[name] = explicit ?? ranges[name];
@@ -5984,7 +6328,7 @@ async function runAdd(cwd, requested, options, ctx) {
       continue;
     }
     try {
-      existing.set(file, readFileSync6(file.target, "utf8"));
+      existing.set(file, readFileSync8(file.target, "utf8"));
     } catch (e) {
       readErrors.push(
         `${file.item.name}: \uAE30\uC874 \uD30C\uC77C ${rel2(root, file.target)} \uC744 \uC77D\uC9C0 \uBABB\uD574 \uBE44\uAD50\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4(${e.code ?? e.message})`