@axis-ds/cli 1.2.1 → 1.4.0

package/README.md

@@ -23,6 +23,28 @@ axis add button
 axis list
 ```
 
+## 프로젝트 초기화 (`axis init`)
+
+- `axis.config.json` 과 `cn()` 을 담은 `utils.ts` 를 만들고, `clsx` · `tailwind-merge` 가 `package.json` 에 없으면 `dependencies` 에 더합니다. 설치는 실행하지 않고 명령만 안내합니다.
+- `tailwind-merge` 범위와 아래 안내는 프로젝트의 Tailwind 버전(설치본, 없으면 `package.json` 선언)으로 정합니다. 판정하지 못하면 Tailwind 3 으로 봅니다.
+- Tailwind 4 이상이면 전역 CSS 에 넣을 줄을 안내합니다. CSS 파일은 고치지 않습니다.
+
+  ```css
+  @import "tailwindcss";
+  @import "@axis-ds/tokens/css/tailwind4";
+  @import "@axis-ds/ui-react/tailwind.css"; /* npm 패키지 컴포넌트를 쓸 때, agentic-ui 도 같은 방식 */
+  ```
+
+  - 컴포넌트 패키지 줄은 `package.json` 에 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 만큼 냅니다. 선언이 없으면 예시 한 줄만 냅니다(`axis add` 로 복사한 컴포넌트는 프로젝트 소스라 따로 넣을 필요가 없습니다).
+  - create-next-app 기본 `globals.css` 의 `:root` · `@theme inline` · `@media (prefers-color-scheme: dark)` · `body` 블록이 AXIS 와 같은 이름(`--background` · `--foreground` · `--color-background` · `--font-sans` · `--font-mono`)을 다른 값으로 정의하니 지우라는 주의를 함께 냅니다(Quick Start 가이드 「Tailwind CSS 4」와 같은 내용).
+  - `@axis-ds/tokens` 가 `package.json` 에 없으면 lockfile 에 맞춘 설치 명령(예: `pnpm add "@axis-ds/tokens@^1.4.0"`)을 안내합니다. 토큰 진입점은 1.4.0 부터 있습니다.
+  - `package.json` 에 선언된 `@axis-ds/tokens` · `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 의 버전 조건(`axis check` 와 같은 함수 · 같은 판정). 설치본을 먼저 보고, 없으면 선언 범위를 봅니다:
+    - 설치본: `node_modules/<패키지>/package.json` 의 `version` 이 정확한 버전이면 그것으로 판정합니다. 1.4.0 이상이면 선언이 `^1.3.0` · `1.x` · `catalog:` 여도 안내하지 않고, 미만이면(`1.4.0-beta.1` 포함) 설치본 버전을 보여 주며 `^1.4.0` 으로 올리는 명령을 냅니다(예: `설치본(@axis-ds/tokens 1.3.0, 선언 ^1.4.0)을 올리세요: pnpm add "@axis-ds/tokens@^1.4.0"`). 다만 설치본이 미만이어도 선언 하한을 읽을 수 없으면(`catalog:` · `npm:` · `latest` · `||` 등) 명령을 내지 않고 선언이 가리키는 버전을 1.4.0 이상으로 올린 뒤 다시 설치하라는 줄만 냅니다(선언을 덮어쓰지 않음).
+    - 설치본이 없을 때 선언 범위의 하한이 1.4.0 미만이면(예: `^1.3.0` · `1.x` · `1.3.0 - 1.5.0` · `^1.4.0-beta.1`) 그 패키지들을 `^1.4.0` 으로 올리는 명령(예: `pnpm add "@axis-ds/tokens@^1.4.0"`)을 냅니다. 하이픈 범위는 왼쪽 버전을, 비교자 여러 개(`>=1.2 >=1.4`)는 가장 높은 하한을 봅니다.
+    - 하한을 읽을 수 없으면(`catalog:` · `latest` · `||` · `<2` · `*` 등) 선언을 덮어쓰는 명령 대신 「설치된 버전이 1.4.0 이상인지 확인하세요」를 냅니다.
+    - `workspace:` 프로토콜은 모노레포 링크라 설치본과 관계없이 안내하지 않습니다(링크된 패키지의 `version` 은 배포 전 소스의 값이라 1.4.0 미만이어도 진입점이 없다는 근거가 아닙니다).
+  - Tailwind 4 에는 설정 파일이 없으므로 `axis.config.json` 에 `tailwindConfig` 를 적지 않고, 대화형 실행에서도 묻지 않습니다. Tailwind 3 은 종전과 같습니다.
+
 ## 브랜드 테마 (`axis theme`)
 
 프로젝트에 설치된 `@axis-ds/tokens`(1.3.0 이상)의 브랜드를 조회하고 적용합니다. 세 명령 모두 `-d, --dir <path>` 로 대상 디렉터리를 받습니다(기본: 현재 디렉터리).
@@ -44,6 +66,22 @@ axis theme add ontology
 - `@axis-ds/tokens` 가 없거나 1.3.0 미만이면 목록 대신 설치 · 업그레이드 안내를 내고 종료 코드 1 로 끝납니다.
 - `axis check` 는 `axis.config.json` 의 `brand` 와 CSS 의 브랜드 import 가 맞는지도 봅니다.
 
+## 프로젝트 검증 (`axis check`)
+
+- Tailwind 구성 항목: Tailwind 4 이상(설치본, 없으면 `package.json` 선언으로 판정)은 설정 파일 대신 전역 CSS(`globals.css` · `app/globals.css` · `src/app/globals.css` · `src/globals.css` · `styles/globals.css` 순으로 처음 찾은 파일 하나)를 봅니다. Tailwind 3 이하는 `tailwind.config.ts` · `.js` · `.mjs` · `.cjs` 를 찾습니다.
+  - Tailwind 4: `@import "tailwindcss"` 가 있는 CSS 에서 아래 문제가 하나도 없으면 PASS 이고, 하나라도 있으면 WARN 입니다(블록 주석 안은 없는 것으로 봅니다). `@import "tailwindcss"` 가 없으면 그 WARN 하나만 냅니다.
+    1. 토큰 진입점 `@import "@axis-ds/tokens/css/tailwind4";` 이 없음 → 문구에 넣을 import 줄. 진입점이 없으면 `bg-primary` · `rounded-md` 같은 AXIS 매핑이 만들어지지 않습니다. `@axis-ds/tokens/css` · `css/shadcn` · `tailwind`(Tailwind 3 preset)는 진입점으로 치지 않습니다.
+    2. `package.json` 에 선언된 `@axis-ds/ui-react` · `@axis-ds/agentic-ui` 의 `tailwind.css` import 가 없음 → 빠진 import 줄. 선언이 없으면(복사 설치) 요구하지 않습니다. `tailwind.css` 대신 그 패키지를 가리키는 `@source` 를 같은 CSS 에 직접 썼으면(예: `@source "../node_modules/@axis-ds/ui-react/dist";`, 작은따옴표 · 다른 상대 경로 포함) 스캔 경로가 있는 것으로 봅니다. 경로 문자열에 `@axis-ds/<패키지>` 가 들어 있고 그 바로 뒤가 경로 끝 · `/` · `\` 이면(`@axis-ds/ui-react-extra` 같은 다른 이름은 아님) 그 패키지를 가리킨다고 판정합니다(경로가 실제로 있는지는 보지 않음). 주석 안 · `@source not` · `@source inline()` 은 인정하지 않고, brace 확장(`@source "{…/@axis-ds/ui-react,…}/dist"`) · `@import "…" source("…")` 형태도 인정하지 않습니다(WARN 쪽으로 판정).
+    3. 진입점이 있는데 create-next-app 기본 정의가 남음 → 실제로 남은 정의 이름(예: `--font-sans` 만 남았으면 `@theme --font-sans: var(--font-geist-sans)` 만 표시). `--background` · `--foreground` 를 색값(`#ffffff` · `rgb()` · `oklch()` 등)으로 정의, `--color-background: var(--background)` 류, `--font-sans` · `--font-mono: var(--font-geist-*)`, `background` · `color: var(--background)` 류 직접 사용을 봅니다(create-next-app 15.5.28 기본 `globals.css` 실물 기준). AXIS 의 HSL 삼중값(`0 0% 100%`) 재정의나 `hsl(var(--background))` 는 걸리지 않습니다. 표시 앞머리(`:root 색값` · `@theme` · `body`)는 create-next-app 기본 블록 이름이라, 같은 선언이 다른 선택자에 있어도 그 이름으로 표시됩니다.
+    4. 진입점이 있는데 `@axis-ds/tokens` 가 아래 버전 조건에 걸림.
+    5. `@axis-ds/ui-react/tailwind.css` · `@axis-ds/agentic-ui/tailwind.css` 를 import 하는데 그 패키지가 아래 버전 조건에 걸림(`tailwind.css` 는 1.4.0 부터 있음). 직접 `@source` 로 스캔하는 패키지는 `tailwind.css` 가 필요 없으므로 이 문제를 만들지 않습니다.
+  - 문제가 여럿이면 위 순서대로 ` / ` 로 이어 한 항목에 냅니다. 끝에는 `package.json` 에 선언된 세 AXIS 패키지 가운데 1.4.0 미만인 것을 `(1.4.0 이상 필요: @axis-ds/tokens ^1.3.0)`, 판정할 수 없는 것을 `(설치된 버전이 1.4.0 이상인지 확인하세요: @axis-ds/agentic-ui catalog:)` 로 한 번 덧붙입니다. 버전은 `axis init` 과 같은 함수로 판정합니다: 설치본(`node_modules/<패키지>/package.json` 의 정확한 `version`)이 있으면 그것으로 보고(`(1.4.0 이상 필요: @axis-ds/ui-react 설치본 1.3.0)`, 1.4.0 이상이면 선언과 관계없이 넣지 않음), 없으면 선언 범위의 하한, 하한도 읽을 수 없으면(`catalog:` · `latest` · `||` 등) 판정 불가입니다. `workspace:` 는 넣지 않습니다.
+  - 문구 예: `Tailwind 4: globals.css에 AXIS 토큰 진입점이 없습니다 → @import "@axis-ds/tokens/css/tailwind4"; / 컴포넌트 스캔 경로(tailwind.css)가 없습니다 → @import "@axis-ds/ui-react/tailwind.css"; (1.4.0 이상 필요: @axis-ds/tokens ^1.3.0 · @axis-ds/ui-react ^1.3.0)`
+  - Tailwind 3: `tailwind.config.ts` 에 `--background` · `hsl(var(` 가 있으면 종전 문구로 PASS 입니다. 그렇지 않아도 설정 파일(`.ts` · `.js` · `.mjs` · `.cjs`)이 `@axis-ds/tokens/tailwind` preset 을 `require` · `import` 하면(주석 밖) `tailwind.config.mjs에 AXIS 토큰이 설정되어 있습니다 (@axis-ds/tokens/tailwind preset)` 처럼 PASS 입니다. 1.3.0 에서는 preset 만 쓰는 `.ts` 가 WARN(`AXIS 토큰 설정이 없습니다`), `.js` · `.mjs` · `.cjs` 가 WARN(`TypeScript 권장`)이었습니다.
+- globals.css 항목: 같은 후보에서 처음 찾은 CSS 하나를 봅니다. `--background` 와 `--primary` 를 직접 정의하거나, `@axis-ds/tokens/css` · `@axis-ds/tokens/css/shadcn` · `@axis-ds/tokens/css/tailwind4` 를 import 하면(블록 주석 밖, 작은따옴표 · `url()` · `layer()` 표기 포함) PASS 입니다. import 로 인정한 경우 문구 끝에 `(@axis-ds/tokens/css/tailwind4 import)` 처럼 경로가 붙습니다. 1.4.0 부터이고, 이전에는 import 만 있으면 WARN 이었습니다.
+- FAIL 이 하나라도 있으면 종료 코드 1 로 끝납니다. WARN 만 있으면 0 입니다(1.3.0 부터, 이전에는 결과와 관계없이 0).
+- MCP `axis.check_project` 도 같은 항목 · 문구를 냅니다.
+
 ## 문서
 
 자세한 사용법은 [AXIS Design System 문서](https://axis.minu.best)를 참고하세요.

package/dist/index.js

@@ -1580,7 +1580,7 @@ function createInitConfig(answers, registry) {
   return {
     $schema: AXIS_CONFIG_SCHEMA_URL,
     componentsDir: answers.componentsDir,
-    tailwindConfig: answers.tailwindConfig,
+    ...answers.tailwindConfig !== void 0 ? { tailwindConfig: answers.tailwindConfig } : {},
     globalCss: answers.globalCss,
     registry
   };
@@ -2099,6 +2099,438 @@ function getBrand(baseDir, name) {
   };
 }
 
+// src/template/tailwind-core.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join2, resolve as resolve2 } from "path";
+function hasDependency(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 isPlainObject(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);
+  if (!m) return void 0;
+  if (/^v?0\.0\.0-/.test(token)) return void 0;
+  return { major: Number(m[1]), minor: m[2], patch: m[3] };
+}
+var isWild = (part) => part === void 0 || /^[xX*]$/.test(part);
+function comparatorBounds(op, v) {
+  switch (op) {
+    case ">=":
+      return { lower: v.major };
+    case ">":
+      return { lower: isWild(v.minor) ? v.major + 1 : v.major };
+    case "<=":
+      return { upper: v.major };
+    case "<": {
+      const zeroOrWild = (part) => isWild(part) || Number(part) === 0;
+      return { upper: zeroOrWild(v.minor) && zeroOrWild(v.patch) ? v.major - 1 : v.major };
+    }
+    default:
+      return { lower: v.major, upper: v.major };
+  }
+}
+function tailwindMajorBounds(range) {
+  const r = range.trim();
+  if (r === "" || r.includes("||")) return void 0;
+  const simple = new RegExp(`^(?:\\^|~|=)?\\s*(${VERSION})$`).exec(r);
+  if (simple) {
+    const v = versionParts(simple[1]);
+    return v ? { lower: v.major, upper: v.major } : void 0;
+  }
+  const hyphen = new RegExp(`^(${VERSION})\\s+-\\s+(${VERSION})$`).exec(r);
+  if (hyphen) {
+    const tokens2 = r.split(/\s+-\s+/);
+    const a = versionParts(tokens2[0]);
+    const b = versionParts(tokens2[1]);
+    return a && b && a.major <= b.major ? { lower: a.major, upper: b.major } : void 0;
+  }
+  const tokens = r.replace(/(>=|<=|>|<|=)\s+/g, "$1").split(/\s+/);
+  const lowers = [];
+  const uppers = [];
+  for (const t of tokens) {
+    const c = /^(>=|<=|>|<|=)(.+)$/.exec(t);
+    if (!c) return void 0;
+    const v = versionParts(c[2]);
+    if (v === void 0) return void 0;
+    const b = comparatorBounds(c[1], v);
+    if (b.lower !== void 0) lowers.push(b.lower);
+    if (b.upper !== void 0) uppers.push(b.upper);
+  }
+  if (lowers.length === 0) return void 0;
+  const lower = Math.max(...lowers);
+  const upper = uppers.length > 0 ? Math.min(...uppers) : void 0;
+  if (upper !== void 0 && upper < lower) return void 0;
+  return upper !== void 0 ? { lower, upper } : { lower };
+}
+function majorWithin(major, bounds) {
+  return major >= bounds.lower && (bounds.upper === void 0 || major <= bounds.upper);
+}
+function majorFromVersion(version) {
+  if (typeof version !== "string") return void 0;
+  const v = version.trim();
+  const m = /^v?(\d+)\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]*)?$/.exec(v);
+  if (!m || /^v?0\.0\.0-/.test(v)) return void 0;
+  return Number(m[1]);
+}
+function detectTailwind(baseDirInput, pkg) {
+  const baseDir = resolve2(baseDirInput);
+  const installedFile = join2(baseDir, "node_modules", "tailwindcss", "package.json");
+  const declared = pkg ? hasDependency(pkg, "tailwindcss") : void 0;
+  const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
+  const declaredMajor = bounds?.lower;
+  try {
+    const installed = JSON.parse(readFileSync2(installedFile, "utf8"));
+    const version = isPlainObject(installed) ? installed.version : void 0;
+    const major = majorFromVersion(version);
+    if (major !== void 0) {
+      const found = { major, source: "installed", value: String(version) };
+      if (declared !== void 0 && bounds !== void 0 && !majorWithin(major, bounds)) {
+        found.mismatch = { declared, declaredMajor: bounds.lower };
+      }
+      return found;
+    }
+  } catch {
+  }
+  if (declared !== void 0) {
+    if (declaredMajor !== void 0) return { major: declaredMajor, source: "declared", value: declared };
+    return { source: "none", value: declared };
+  }
+  return { source: "none" };
+}
+var TAILWIND_CONFIG_FILES = [
+  "tailwind.config.ts",
+  "tailwind.config.js",
+  "tailwind.config.mjs",
+  "tailwind.config.cjs"
+];
+var TAILWIND_CSS_CANDIDATES = [
+  "globals.css",
+  "app/globals.css",
+  "src/app/globals.css",
+  "src/globals.css",
+  "styles/globals.css"
+];
+var TAILWIND_IMPORT = /@import\s+(?:url\(\s*)?["']tailwindcss["']/;
+function stripCssComments(css) {
+  return css.replace(/\/\*[\s\S]*?\*\//g, "");
+}
+function hasTailwindImport(css) {
+  return TAILWIND_IMPORT.test(stripCssComments(css));
+}
+var TOKENS_TAILWIND4_ENTRY = "@axis-ds/tokens/css/tailwind4";
+var TOKENS_TAILWIND4_IMPORT_LINE = `@import "${TOKENS_TAILWIND4_ENTRY}";`;
+var TOKENS_TAILWIND4_IMPORT = /@import\s+(?:url\(\s*)?["']@axis-ds\/tokens\/css\/tailwind4["']/;
+function hasTokensTailwind4Import(css) {
+  return TOKENS_TAILWIND4_IMPORT.test(stripCssComments(css));
+}
+var TOKENS_CSS_IMPORT = /@import\s+(?:url\(\s*)?["'](@axis-ds\/tokens\/css(?:\/shadcn|\/tailwind4)?)["']/;
+function findTokensCssImport(css) {
+  return TOKENS_CSS_IMPORT.exec(stripCssComments(css))?.[1];
+}
+function checkGlobalsCss(baseDirInput) {
+  const baseDir = resolve2(baseDirInput);
+  for (const candidate of TAILWIND_CSS_CANDIDATES) {
+    const file = join2(baseDir, candidate);
+    if (!existsSync2(file)) continue;
+    const content = readFileSync2(file, "utf8");
+    if (content.includes("--background") && content.includes("--primary")) {
+      return { name: "globals.css", severity: "pass", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4` };
+    }
+    const imported = findTokensCssImport(content);
+    if (imported !== void 0) {
+      return { name: "globals.css", severity: "pass", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC788\uC2B5\uB2C8\uB2E4 (${imported} import)` };
+    }
+    return { name: "globals.css", severity: "warn", message: `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4` };
+  }
+  return { name: "globals.css", severity: "fail", message: "globals.css \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4" };
+}
+var TAILWIND4_MIN_AXIS_VERSION = "1.4.0";
+var TAILWIND4_AXIS_PACKAGES = ["@axis-ds/tokens", "@axis-ds/ui-react", "@axis-ds/agentic-ui"];
+function lowerOf(token) {
+  const v = versionParts(token);
+  if (!v) return void 0;
+  const num = (part) => isWild(part) ? 0 : Number(part);
+  const pre = /^v?\d+(?:\.(?:\d+|[xX*]))?(?:\.(?:\d+|[xX*]))?-/.test(token);
+  return { core: [v.major, num(v.minor), num(v.patch)], pre };
+}
+function compareLower(a, b) {
+  for (let i = 0; i < 3; i++) {
+    if (a.core[i] !== b.core[i]) return a.core[i] - b.core[i];
+  }
+  return Number(b.pre) - Number(a.pre);
+}
+function rangeLowerVersion(range) {
+  const r = range.trim();
+  if (r === "" || r.includes("||")) return void 0;
+  const simple = new RegExp(`^(?:\\^|~|=)?\\s*(${VERSION})$`).exec(r);
+  if (simple) return lowerOf(simple[1]);
+  if (new RegExp(`^(${VERSION})\\s+-\\s+(${VERSION})$`).test(r)) {
+    const [a, b] = r.split(/\s+-\s+/);
+    return lowerOf(b) ? lowerOf(a) : void 0;
+  }
+  const tokens = r.replace(/(>=|<=|>|<|=)\s+/g, "$1").split(/\s+/);
+  let lower;
+  for (const t of tokens) {
+    const c = /^(>=|<=|>|<|=)(.+)$/.exec(t);
+    if (!c) return void 0;
+    const v = versionParts(c[2]);
+    const low = lowerOf(c[2]);
+    if (!v || !low) return void 0;
+    let candidate;
+    if (c[1] === ">=" || c[1] === "=") candidate = low;
+    else if (c[1] === ">") {
+      if (isWild(v.minor)) candidate = { core: [v.major + 1, 0, 0], pre: false };
+      else if (isWild(v.patch)) candidate = { core: [v.major, Number(v.minor) + 1, 0], pre: false };
+      else candidate = { core: [v.major, Number(v.minor), Number(v.patch) + 1], pre: false };
+    }
+    if (candidate && (!lower || compareLower(candidate, lower) > 0)) lower = candidate;
+  }
+  return lower;
+}
+function rangeLowerAtLeast(range, min) {
+  const lower = rangeLowerVersion(range);
+  const target = lowerOf(min);
+  if (!lower || !target) return void 0;
+  return compareLower(lower, target) >= 0;
+}
+function exactVersion(version) {
+  if (typeof version !== "string") return void 0;
+  const v = version.trim();
+  if (!/^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(v) || /^v?0\.0\.0-/.test(v)) return void 0;
+  return v;
+}
+function installedVersion(baseDir, name) {
+  try {
+    const parsed = JSON.parse(readFileSync2(join2(baseDir, "node_modules", ...name.split("/"), "package.json"), "utf8"));
+    return isPlainObject(parsed) ? exactVersion(parsed.version) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function axisPackagesBelowTailwind4(pkg, baseDirInput) {
+  if (!pkg) return [];
+  const baseDir = baseDirInput !== void 0 ? resolve2(baseDirInput) : void 0;
+  const out = [];
+  const min = lowerOf(TAILWIND4_MIN_AXIS_VERSION);
+  for (const name of TAILWIND4_AXIS_PACKAGES) {
+    const range = hasDependency(pkg, name);
+    if (range === void 0 || range.trim().startsWith("workspace:")) continue;
+    const installed = baseDir !== void 0 ? installedVersion(baseDir, name) : void 0;
+    const installedLower = installed !== void 0 ? lowerOf(installed) : void 0;
+    if (installed !== void 0 && installedLower !== void 0) {
+      if (compareLower(installedLower, min) < 0) out.push({ name, range, status: "below", source: "installed", installed });
+      continue;
+    }
+    const atLeast = rangeLowerAtLeast(range, TAILWIND4_MIN_AXIS_VERSION);
+    if (atLeast === false) out.push({ name, range, status: "below", source: "declared" });
+    else if (atLeast === void 0) out.push({ name, range, status: "unknown", source: "declared" });
+  }
+  return out;
+}
+function axisPackageVersionLabel(issue) {
+  return issue.source === "installed" ? `${issue.name} \uC124\uCE58\uBCF8 ${issue.installed}` : `${issue.name} ${issue.range}`;
+}
+var declaredList = (issues) => issues.map(axisPackageVersionLabel).join(" \xB7 ");
+function tailwind4VersionNote(issues) {
+  const below = issues.filter((i) => i.status === "below");
+  const unknown = issues.filter((i) => i.status === "unknown");
+  let note = "";
+  if (below.length > 0) note += ` (${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1 \uD544\uC694: ${declaredList(below)})`;
+  if (unknown.length > 0) note += ` (\uC124\uCE58\uB41C \uBC84\uC804\uC774 ${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC778\uC9C0 \uD655\uC778\uD558\uC138\uC694: ${declaredList(unknown)})`;
+  return note;
+}
+var TAILWIND4_COMPONENT_PACKAGES = ["@axis-ds/ui-react", "@axis-ds/agentic-ui"];
+function componentTailwindImportLine(name) {
+  return `@import "${name}/tailwind.css";`;
+}
+var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function hasComponentTailwindImport(css, name) {
+  const re = new RegExp(`@import\\s+(?:url\\(\\s*)?["']${escapeRegExp(name)}/tailwind\\.css["']`);
+  return re.test(stripCssComments(css));
+}
+function hasComponentSource(css, name) {
+  const re = new RegExp(`@source\\s+(["'])(?!@axis-ds/)[^"'\\n]*${escapeRegExp(name)}(?:[/\\\\][^"'\\n]*)?\\1`);
+  return re.test(stripCssComments(css));
+}
+var CREATE_NEXT_APP_DEFAULTS = [
+  {
+    prefix: ":root \uC0C9\uAC12",
+    pattern: /(?<![\w-])(--(?:background|foreground))\s*:\s*(?:#[0-9a-fA-F]{3,8}\b|(?:rgba?|hsla?|hwb|oklch|oklab|lab|lch|color)\()/g,
+    item: (m) => m[1]
+  },
+  {
+    prefix: "@theme",
+    pattern: /(?<![\w-])(--color-(?:background|foreground))\s*:\s*var\(\s*(--(?:background|foreground))\s*\)/g,
+    item: (m) => `${m[1]}: var(${m[2]})`
+  },
+  {
+    prefix: "@theme",
+    pattern: /(?<![\w-])(--font-(?:sans|mono))\s*:\s*var\(\s*(--font-geist-(?:sans|mono))\s*\)/g,
+    item: (m) => `${m[1]}: var(${m[2]})`
+  },
+  {
+    prefix: "body",
+    pattern: /(?<![\w-])(background|background-color|color)\s*:\s*var\(\s*(--(?:background|foreground))\s*\)/g,
+    item: (m) => `${m[1]}: var(${m[2]})`
+  }
+];
+function findCreateNextAppDefaults(css) {
+  const body = stripCssComments(css);
+  const labels = [];
+  for (const d of CREATE_NEXT_APP_DEFAULTS) {
+    const items = [];
+    for (const m of body.matchAll(d.pattern)) {
+      const item = d.item(m);
+      if (!items.includes(item)) items.push(item);
+    }
+    if (items.length > 0) labels.push(`${d.prefix} ${items.join(", ")}`);
+  }
+  return labels;
+}
+function stripJsComments(src) {
+  let out = "";
+  let i = 0;
+  const n = src.length;
+  while (i < n) {
+    const c = src[i];
+    const d = src[i + 1];
+    if (c === '"' || c === "'" || c === "`") {
+      let j = i + 1;
+      while (j < n && src[j] !== c) {
+        if (src[j] === "\\") j++;
+        else if (c !== "`" && src[j] === "\n") break;
+        j++;
+      }
+      out += src.slice(i, j + 1);
+      i = j + 1;
+      continue;
+    }
+    if (c === "/" && d === "/") {
+      const end = src.indexOf("\n", i);
+      i = end === -1 ? n : end;
+      continue;
+    }
+    if (c === "/" && d === "*") {
+      const end = src.indexOf("*/", i + 2);
+      i = end === -1 ? n : end + 2;
+      out += " ";
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+var TOKENS_TAILWIND3_PRESET = "@axis-ds/tokens/tailwind";
+var PRESET_REFERENCE = /(?:\brequire\s*\(\s*|\bimport\s*\(\s*|\bfrom\s*|\bimport\s+)(["'])@axis-ds\/tokens\/tailwind\1/;
+function hasTokensPresetReference(source) {
+  return PRESET_REFERENCE.test(stripJsComments(source));
+}
+var PRESET_PASS_SUFFIX = `\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 (${TOKENS_TAILWIND3_PRESET} preset)`;
+function readPackageJson(baseDir) {
+  try {
+    const parsed = JSON.parse(readFileSync2(join2(baseDir, "package.json"), "utf8"));
+    return isPlainObject(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function tailwind4Issues(css, pkg, versions) {
+  const issues = [];
+  const hasEntry = hasTokensTailwind4Import(css);
+  if (!hasEntry) issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${TOKENS_TAILWIND4_IMPORT_LINE}`);
+  const missing = TAILWIND4_COMPONENT_PACKAGES.filter(
+    (name) => pkg !== void 0 && hasDependency(pkg, name) !== void 0 && !hasComponentTailwindImport(css, name) && !hasComponentSource(css, name)
+  );
+  if (missing.length > 0) {
+    issues.push(`\uCEF4\uD3EC\uB10C\uD2B8 \uC2A4\uCE94 \uACBD\uB85C(tailwind.css)\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 ${missing.map(componentTailwindImportLine).join(" ")}`);
+  }
+  if (hasEntry) {
+    const defaults = findCreateNextAppDefaults(css);
+    if (defaults.length > 0) issues.push(`create-next-app \uAE30\uBCF8 \uC815\uC758\uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4(${defaults.join(" \xB7 ")}) \u2192 \uC9C0\uC6B0\uC138\uC694`);
+    if (versions.some((v) => v.name === TAILWIND4_AXIS_PACKAGES[0])) {
+      issues.push(`AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC9C0\uB9CC ${TAILWIND4_AXIS_PACKAGES[0]} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
+    }
+  }
+  for (const name of TAILWIND4_COMPONENT_PACKAGES) {
+    if (hasComponentTailwindImport(css, name) && versions.some((v) => v.name === name)) {
+      issues.push(`${name}/tailwind.css import \uAC00 \uC788\uC9C0\uB9CC ${name} \uBC84\uC804 \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4`);
+    }
+  }
+  return issues;
+}
+function checkTailwindSetup(baseDirInput) {
+  const baseDir = resolve2(baseDirInput);
+  const pkg = readPackageJson(baseDir);
+  const tailwind = detectTailwind(baseDir, pkg);
+  if (tailwind.major !== void 0 && tailwind.major >= 4) {
+    const label = `Tailwind ${tailwind.major}`;
+    for (const candidate of TAILWIND_CSS_CANDIDATES) {
+      const file = join2(baseDir, candidate);
+      if (!existsSync2(file)) continue;
+      const css = readFileSync2(file, "utf8");
+      if (!hasTailwindImport(css)) {
+        return {
+          name: "tailwind.config",
+          severity: "warn",
+          message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
+        };
+      }
+      const versions = axisPackagesBelowTailwind4(pkg, baseDir);
+      const issues = tailwind4Issues(css, pkg, versions);
+      if (issues.length > 0) {
+        return {
+          name: "tailwind.config",
+          severity: "warn",
+          message: `${label}: ${candidate}\uC5D0 ${issues.join(" / ")}${tailwind4VersionNote(versions)}`
+        };
+      }
+      return {
+        name: "tailwind.config",
+        severity: "pass",
+        message: `${label}: ${candidate}\uC5D0 @import "tailwindcss" \uC640 AXIS \uD1A0\uD070 \uC9C4\uC785\uC810\uC774 \uC788\uC2B5\uB2C8\uB2E4`
+      };
+    }
+    return {
+      name: "tailwind.config",
+      severity: "warn",
+      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 (existsSync2(tsPath)) {
+    const content = readFileSync2(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" };
+    }
+    if (hasTokensPresetReference(content)) {
+      return { name: "tailwind.config", severity: "pass", message: `tailwind.config.ts${PRESET_PASS_SUFFIX}` };
+    }
+    return { name: "tailwind.config", severity: "warn", message: "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+  }
+  for (const file of otherFiles) {
+    const path13 = join2(baseDir, file);
+    if (existsSync2(path13)) {
+      if (hasTokensPresetReference(readFileSync2(path13, "utf8"))) {
+        return { name: "tailwind.config", severity: "pass", message: `${file}${PRESET_PASS_SUFFIX}` };
+      }
+      return { name: "tailwind.config", severity: "warn", message: `${file} \uC874\uC7AC (TypeScript \uAD8C\uC7A5)` };
+    }
+  }
+  return { name: "tailwind.config", severity: "fail", message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" };
+}
+
 // src/template/template-check.ts
 var SEVERITY_ICON = {
   pass: chalk6.green("PASS"),
@@ -2109,8 +2541,8 @@ async function collectCheckResults(dir) {
   const baseDir = path8.resolve(dir || ".");
   const results = [];
   results.push(await checkFileExists(baseDir, "axis.config.json", "axis.config.json"));
-  results.push(await checkTailwindConfig(baseDir));
-  results.push(await checkGlobalsCss(baseDir));
+  results.push(checkTailwindSetup(baseDir));
+  results.push(checkGlobalsCss(baseDir));
   results.push(await checkUtils(baseDir));
   results.push(await checkDependencies(baseDir));
   const brand = checkBrand(baseDir);
@@ -2148,6 +2580,7 @@ async function runCheck(dir) {
   } else {
     console.log(chalk6.green("\n\uBAA8\uB4E0 \uAC80\uC99D\uC744 \uD1B5\uACFC\uD588\uC2B5\uB2C8\uB2E4!"));
   }
+  return { pass: passCount, warn: warnCount, fail: failCount };
 }
 async function checkFileExists(baseDir, fileName, label) {
   const exists = await fs9.pathExists(path8.join(baseDir, fileName));
@@ -2157,57 +2590,6 @@ async function checkFileExists(baseDir, fileName, label) {
     message: exists ? `${label} \uD30C\uC77C\uC774 \uC874\uC7AC\uD569\uB2C8\uB2E4` : `${label} \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2192 'axis init'\uC744 \uC2E4\uD589\uD558\uC138\uC694`
   };
 }
-async function checkTailwindConfig(baseDir) {
-  const tsPath = path8.join(baseDir, "tailwind.config.ts");
-  const jsPath = path8.join(baseDir, "tailwind.config.js");
-  if (await fs9.pathExists(tsPath)) {
-    const content = await fs9.readFile(tsPath, "utf-8");
-    const hasTokens = content.includes("--background") || content.includes("hsl(var(");
-    return {
-      name: "tailwind.config",
-      severity: hasTokens ? "pass" : "warn",
-      message: hasTokens ? "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4" : "tailwind.config.ts\uC5D0 AXIS \uD1A0\uD070 \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-    };
-  }
-  if (await fs9.pathExists(jsPath)) {
-    return {
-      name: "tailwind.config",
-      severity: "warn",
-      message: "tailwind.config.js \uC874\uC7AC (TypeScript \uAD8C\uC7A5)"
-    };
-  }
-  return {
-    name: "tailwind.config",
-    severity: "fail",
-    message: "tailwind.config \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
-  };
-}
-async function checkGlobalsCss(baseDir) {
-  const candidates = [
-    "globals.css",
-    "app/globals.css",
-    "src/app/globals.css",
-    "src/globals.css",
-    "styles/globals.css"
-  ];
-  for (const candidate of candidates) {
-    const fullPath = path8.join(baseDir, candidate);
-    if (await fs9.pathExists(fullPath)) {
-      const content = await fs9.readFile(fullPath, "utf-8");
-      const hasTokens = content.includes("--background") && content.includes("--primary");
-      return {
-        name: "globals.css",
-        severity: hasTokens ? "pass" : "warn",
-        message: hasTokens ? `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC815\uC758\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4` : `${candidate}\uC5D0 AXIS CSS \uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`
-      };
-    }
-  }
-  return {
-    name: "globals.css",
-    severity: "fail",
-    message: "globals.css \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4"
-  };
-}
 async function checkUtils(baseDir) {
   const candidates = [
     "lib/utils.ts",
@@ -2402,7 +2784,8 @@ function registerTemplateCommand(program2) {
 }
 function registerCheckCommand(program2) {
   program2.command("check").description("AXIS \uD504\uB85C\uC81D\uD2B8 \uC124\uC815 \uAC80\uC99D").option("-d, --dir <path>", "\uB300\uC0C1 \uB514\uB809\uD1A0\uB9AC").action(async (options) => {
-    await runCheck(options.dir);
+    const summary = await runCheck(options.dir);
+    if (summary.fail > 0) process.exitCode = 1;
   });
 }
 
@@ -2411,12 +2794,12 @@ import chalk8 from "chalk";
 import path10 from "path";
 
 // src/theme/theme-add.ts
-import { accessSync, constants, existsSync as existsSync2, readFileSync as readFileSync2, realpathSync, unlinkSync, writeFileSync } from "fs";
+import { accessSync, constants, existsSync as existsSync3, readFileSync as readFileSync3, realpathSync, unlinkSync, writeFileSync } from "fs";
 import path9 from "path";
 var TOKENS_DEPENDENCY_RANGE = `^${MIN_BRAND_TOKENS_VERSION}`;
 var THEME_PACKAGE = "@axis-ds/theme";
 function readText(file) {
-  return existsSync2(file) ? readFileSync2(file, "utf8") : null;
+  return existsSync3(file) ? readFileSync3(file, "utf8") : null;
 }
 function eolOf(text) {
   return text.includes("\r\n") ? "\r\n" : "\n";
@@ -2492,12 +2875,12 @@ function isStylesheet(realPath) {
   return path9.extname(realPath).toLowerCase() === ".css";
 }
 function detectInstallCommand(baseDir) {
-  if (existsSync2(path9.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
-  if (existsSync2(path9.join(baseDir, "yarn.lock"))) return "yarn install";
-  if (existsSync2(path9.join(baseDir, "package-lock.json"))) return "npm install";
+  if (existsSync3(path9.join(baseDir, "pnpm-lock.yaml"))) return "pnpm install";
+  if (existsSync3(path9.join(baseDir, "yarn.lock"))) return "yarn install";
+  if (existsSync3(path9.join(baseDir, "package-lock.json"))) return "npm install";
   return "pnpm install";
 }
-function hasDependency(pkg, name) {
+function hasDependency2(pkg, name) {
   for (const field of ["dependencies", "devDependencies"]) {
     const deps = pkg[field];
     if (typeof deps === "object" && deps !== null && name in deps) {
@@ -2506,7 +2889,7 @@ function hasDependency(pkg, name) {
   }
   return void 0;
 }
-function isPlainObject(value) {
+function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function planThemeAdd(baseDirInput, brand) {
@@ -2531,7 +2914,7 @@ function planThemeAdd(baseDirInput, brand) {
   let config;
   try {
     const parsed = JSON.parse(configText);
-    if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+    if (!isPlainObject2(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 });
@@ -2543,7 +2926,7 @@ function planThemeAdd(baseDirInput, brand) {
   }
   plan.tokens = resolveTokens(baseDir);
   if (plan.tokens.status === "ok" && plan.tokens.indexPath) {
-    const data = JSON.parse(readFileSync2(plan.tokens.indexPath, "utf8"));
+    const data = JSON.parse(readFileSync3(plan.tokens.indexPath, "utf8"));
     const entries = Array.isArray(data.brands) ? data.brands : [];
     const entry = entries.find((e) => e.name === brand);
     if (!entry) {
@@ -2572,7 +2955,7 @@ function planThemeAdd(baseDirInput, brand) {
       plan.writes = [];
       return plan;
     }
-    const before = readFileSync2(location.path, "utf8");
+    const before = readFileSync3(location.path, "utf8");
     const imported = findBrandImports(before);
     const otherBrands = [...new Set(imported.filter((n) => n !== brand))];
     if (imported.includes(brand)) {
@@ -2598,19 +2981,19 @@ function planThemeAdd(baseDirInput, brand) {
     let pkg;
     try {
       const parsed = JSON.parse(pkgText);
-      if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+      if (!isPlainObject2(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 });
       plan.writes = [];
       return plan;
     }
-    const themeMissing = hasDependency(pkg, THEME_PACKAGE) === void 0;
-    const declared = hasDependency(pkg, TOKENS_PACKAGE);
+    const themeMissing = hasDependency2(pkg, THEME_PACKAGE) === void 0;
+    const declared = hasDependency2(pkg, TOKENS_PACKAGE);
     if (declared !== void 0) {
       plan.dependency = { action: "present", declaredRange: declared, upgrade, themeMissing };
     } else {
-      const deps = isPlainObject(pkg.dependencies) ? { ...pkg.dependencies } : {};
+      const deps = isPlainObject2(pkg.dependencies) ? { ...pkg.dependencies } : {};
       deps[TOKENS_PACKAGE] = TOKENS_DEPENDENCY_RANGE;
       const next = { ...pkg, dependencies: deps };
       plan.dependency = { action: "add", upgrade, themeMissing };
@@ -2990,7 +3373,7 @@ import chalk10 from "chalk";
 import prompts2 from "prompts";
 
 // src/init/init.ts
-import { accessSync as accessSync2, constants as constants2, existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { accessSync as accessSync2, constants as constants2, existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
 import path11 from "path";
 import chalk9 from "chalk";
 import fs10 from "fs-extra";
@@ -2999,98 +3382,6 @@ var TAILWIND_MERGE_RANGES = {
   tailwind4: "^3.4.0",
   tailwind3: "^2.6.0"
 };
-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);
-  if (!m) return void 0;
-  if (/^v?0\.0\.0-/.test(token)) return void 0;
-  return { major: Number(m[1]), minor: m[2], patch: m[3] };
-}
-var isWild = (part) => part === void 0 || /^[xX*]$/.test(part);
-function comparatorBounds(op, v) {
-  switch (op) {
-    case ">=":
-      return { lower: v.major };
-    case ">":
-      return { lower: isWild(v.minor) ? v.major + 1 : v.major };
-    case "<=":
-      return { upper: v.major };
-    case "<": {
-      const zeroOrWild = (part) => isWild(part) || Number(part) === 0;
-      return { upper: zeroOrWild(v.minor) && zeroOrWild(v.patch) ? v.major - 1 : v.major };
-    }
-    default:
-      return { lower: v.major, upper: v.major };
-  }
-}
-function tailwindMajorBounds(range) {
-  const r = range.trim();
-  if (r === "" || r.includes("||")) return void 0;
-  const simple = new RegExp(`^(?:\\^|~|=)?\\s*(${VERSION})$`).exec(r);
-  if (simple) {
-    const v = versionParts(simple[1]);
-    return v ? { lower: v.major, upper: v.major } : void 0;
-  }
-  const hyphen = new RegExp(`^(${VERSION})\\s+-\\s+(${VERSION})$`).exec(r);
-  if (hyphen) {
-    const tokens2 = r.split(/\s+-\s+/);
-    const a = versionParts(tokens2[0]);
-    const b = versionParts(tokens2[1]);
-    return a && b && a.major <= b.major ? { lower: a.major, upper: b.major } : void 0;
-  }
-  const tokens = r.replace(/(>=|<=|>|<|=)\s+/g, "$1").split(/\s+/);
-  const lowers = [];
-  const uppers = [];
-  for (const t of tokens) {
-    const c = /^(>=|<=|>|<|=)(.+)$/.exec(t);
-    if (!c) return void 0;
-    const v = versionParts(c[2]);
-    if (v === void 0) return void 0;
-    const b = comparatorBounds(c[1], v);
-    if (b.lower !== void 0) lowers.push(b.lower);
-    if (b.upper !== void 0) uppers.push(b.upper);
-  }
-  if (lowers.length === 0) return void 0;
-  const lower = Math.max(...lowers);
-  const upper = uppers.length > 0 ? Math.min(...uppers) : void 0;
-  if (upper !== void 0 && upper < lower) return void 0;
-  return upper !== void 0 ? { lower, upper } : { lower };
-}
-function majorWithin(major, bounds) {
-  return major >= bounds.lower && (bounds.upper === void 0 || major <= bounds.upper);
-}
-function majorFromVersion(version) {
-  if (typeof version !== "string") return void 0;
-  const v = version.trim();
-  const m = /^v?(\d+)\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]*)?$/.exec(v);
-  if (!m || /^v?0\.0\.0-/.test(v)) return void 0;
-  return Number(m[1]);
-}
-function detectTailwind(baseDirInput, pkg) {
-  const baseDir = path11.resolve(baseDirInput);
-  const installedFile = path11.join(baseDir, "node_modules", "tailwindcss", "package.json");
-  const declared = pkg ? hasDependency(pkg, "tailwindcss") : void 0;
-  const bounds = declared !== void 0 ? tailwindMajorBounds(declared) : void 0;
-  const declaredMajor = bounds?.lower;
-  try {
-    const installed = JSON.parse(readFileSync3(installedFile, "utf8"));
-    const version = isPlainObject(installed) ? installed.version : void 0;
-    const major = majorFromVersion(version);
-    if (major !== void 0) {
-      const found = { major, source: "installed", value: String(version) };
-      if (declared !== void 0 && bounds !== void 0 && !majorWithin(major, bounds)) {
-        found.mismatch = { declared, declaredMajor: bounds.lower };
-      }
-      return found;
-    }
-  } catch {
-  }
-  if (declared !== void 0) {
-    if (declaredMajor !== void 0) return { major: declaredMajor, source: "declared", value: declared };
-    return { source: "none", value: declared };
-  }
-  return { source: "none" };
-}
 function selectUtilsDependencies(tailwind) {
   return {
     clsx: CLSX_RANGE,
@@ -3132,6 +3423,70 @@ var INIT_DEFAULTS = {
   globalCss: "./src/app/globals.css"
 };
 var INIT_NEXT_STEP_COMMAND = "npx @axis-ds/cli add button";
+function isTailwind4(tailwind) {
+  return tailwind.major !== void 0 && tailwind.major >= 4;
+}
+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(path11.join(baseDir, "package.json"), "utf8");
+    const parsed = JSON.parse(text.startsWith(BOM) ? text.slice(1) : text);
+    return isPlainObject2(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 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";',
+    `  ${TOKENS_TAILWIND4_IMPORT_LINE}`,
+    ...used.map((name) => `  ${componentTailwindImportLine(name)}`)
+  ];
+  if (used.length === 0) {
+    lines.push(
+      `  npm \uD328\uD0A4\uC9C0 \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uC4F0\uBA74 \uADF8 \uD328\uD0A4\uC9C0\uC758 tailwind.css \uB3C4 \uB123\uC73C\uC138\uC694(\uC608: @import "${TAILWIND4_COMPONENT_PACKAGES[0]}/tailwind.css";).`
+    );
+  }
+  lines.push(TAILWIND4_CONFLICT_LINE);
+  if (pkg === void 0 || hasDependency2(pkg, TOKENS_PACKAGE) === void 0) {
+    const add = addCommandFor(installCommand, { [TOKENS_PACKAGE]: `^${TAILWIND4_TOKENS_VERSION}` });
+    lines.push(`  ${TOKENS_PACKAGE} \uC124\uCE58: ${add}`);
+  }
+  const versions = axisPackagesBelowTailwind4(pkg, baseDir);
+  const unknown = versions.filter((v) => v.status === "unknown");
+  const declaredOf = (list) => list.map(axisPackageVersionLabel).join(" \xB7 ");
+  const upgradeOf = (list) => addCommandFor(installCommand, Object.fromEntries(list.map((b) => [b.name, `^${TAILWIND4_MIN_AXIS_VERSION}`])));
+  const belowDeclared = versions.filter((v) => v.status === "below" && v.source === "declared");
+  const readableRange = (v) => rangeLowerAtLeast(v.range, TAILWIND4_MIN_AXIS_VERSION) !== void 0;
+  const installedBelow = versions.filter((v) => v.status === "below" && v.source === "installed");
+  const belowInstalled = installedBelow.filter(readableRange);
+  const belowInstalledOpaque = installedBelow.filter((v) => !readableRange(v));
+  const installedOf = (list) => list.map((v) => `${v.name} ${v.installed}, \uC120\uC5B8 ${v.range}`).join(" \xB7 ");
+  if (belowDeclared.length > 0) {
+    lines.push(
+      `  ! Tailwind 4 \uC9C4\uC785\uC810\uC740 ${TAILWIND4_MIN_AXIS_VERSION} \uBD80\uD130 \uC788\uC2B5\uB2C8\uB2E4. \uC120\uC5B8(${declaredOf(belowDeclared)})\uC744 \uC62C\uB9AC\uC138\uC694: ${upgradeOf(belowDeclared)}`
+    );
+  }
+  if (belowInstalled.length > 0) {
+    lines.push(
+      `  ! Tailwind 4 \uC9C4\uC785\uC810\uC740 ${TAILWIND4_MIN_AXIS_VERSION} \uBD80\uD130 \uC788\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uBCF8(${installedOf(belowInstalled)})\uC744 \uC62C\uB9AC\uC138\uC694: ${upgradeOf(belowInstalled)}`
+    );
+  }
+  if (belowInstalledOpaque.length > 0) {
+    lines.push(
+      `  ! Tailwind 4 \uC9C4\uC785\uC810\uC740 ${TAILWIND4_MIN_AXIS_VERSION} \uBD80\uD130 \uC788\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uBCF8(${installedOf(belowInstalledOpaque)})\uC774 ${TAILWIND4_MIN_AXIS_VERSION} \uBBF8\uB9CC\uC785\uB2C8\uB2E4. \uC120\uC5B8\uC774 \uAC00\uB9AC\uD0A4\uB294 \uBC84\uC804\uC744 ${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC73C\uB85C \uC62C\uB9B0 \uB4A4 \uB2E4\uC2DC \uC124\uCE58\uD558\uC138\uC694(\uC120\uC5B8\uC740 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4).`
+    );
+  }
+  if (unknown.length > 0) {
+    lines.push(
+      `  ! Tailwind 4 \uC9C4\uC785\uC810\uC740 ${TAILWIND4_MIN_AXIS_VERSION} \uBD80\uD130 \uC788\uC2B5\uB2C8\uB2E4. \uC120\uC5B8(${declaredOf(unknown)})\uC73C\uB85C\uB294 \uBC84\uC804\uC744 \uD310\uC815\uD560 \uC218 \uC5C6\uC73C\uB2C8 \uC124\uCE58\uB41C \uBC84\uC804\uC774 ${TAILWIND4_MIN_AXIS_VERSION} \uC774\uC0C1\uC778\uC9C0 \uD655\uC778\uD558\uC138\uC694.`
+    );
+  }
+  return lines;
+}
 var BOM = "\uFEFF";
 function addCommandFor(installCommand, deps) {
   const specs = Object.entries(deps).map(([name, range]) => `"${name}@${range}"`).join(" ");
@@ -3154,7 +3509,7 @@ function planUtilsDependencies(baseDirInput) {
     addCommand: addCommandFor(installCommand, ranges0)
   };
   const pkgFile = path11.join(baseDir, "package.json");
-  if (!existsSync3(pkgFile)) return plan;
+  if (!existsSync4(pkgFile)) return plan;
   const unwritable = (reason) => ({ ...plan, action: "unwritable", reason });
   let where;
   try {
@@ -3165,7 +3520,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 = readFileSync3(pkgFile, "utf8");
+    text = readFileSync4(pkgFile, "utf8");
   } catch (err) {
     return unwritable(err.message);
   }
@@ -3174,7 +3529,7 @@ function planUtilsDependencies(baseDirInput) {
   let pkg;
   try {
     const parsed = JSON.parse(body);
-    if (!isPlainObject(parsed)) throw new Error("\uCD5C\uC0C1\uC704\uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
+    if (!isPlainObject2(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}`);
@@ -3184,14 +3539,14 @@ function planUtilsDependencies(baseDirInput) {
   plan.addCommand = addCommandFor(installCommand, plan.ranges);
   const missing = {};
   for (const [name, range] of Object.entries(plan.ranges)) {
-    const declared = hasDependency(pkg, name);
+    const declared = hasDependency2(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 && !isPlainObject(pkg.dependencies)) {
+  if (pkg.dependencies !== void 0 && !isPlainObject2(pkg.dependencies)) {
     return unwritable("dependencies \uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4");
   }
   try {
@@ -3208,7 +3563,7 @@ function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile
   const w = plan.write;
   if (plan.action !== "add" || !w) return false;
   const baseDir = path11.resolve(baseDirInput);
-  const current = existsSync3(w.file) ? readFileSync3(w.file, "utf8") : null;
+  const current = existsSync4(w.file) ? readFileSync4(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.`);
   }
@@ -3224,7 +3579,7 @@ function applyUtilsDependencies(baseDirInput, plan, writeFile = defaultWriteFile
     let restored;
     try {
       writeFile(w.file, w.before);
-      if (readFileSync3(w.file, "utf8") !== w.before) throw new Error("\uB418\uB3CC\uB9B0 \uB0B4\uC6A9\uC774 \uC6D0\uB798 \uB0B4\uC6A9\uACFC \uB2E4\uB985\uB2C8\uB2E4");
+      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");
       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`;
@@ -3261,10 +3616,12 @@ function reportDependencies(plan, log) {
 }
 async function runInit(baseDirInput, answers, registryUrl, log = console.log) {
   const baseDir = path11.resolve(baseDirInput);
+  const plan = planUtilsDependencies(baseDir);
+  const tailwind4 = isTailwind4(plan.tailwind);
   const axisConfig = createInitConfig(
     {
       componentsDir: answers.componentsDir,
-      tailwindConfig: answers.tailwindConfig,
+      tailwindConfig: tailwind4 ? void 0 : answers.tailwindConfig,
       globalCss: answers.globalCss
     },
     registryUrl
@@ -3275,7 +3632,6 @@ async function runInit(baseDirInput, answers, registryUrl, log = console.log) {
   await fs10.ensureDir(path11.dirname(utilsPath));
   await fs10.writeFile(utilsPath, UTILS_TS_CONTENT);
   log(chalk9.green("\u2713 utils.ts \uC0DD\uC131 \uC644\uB8CC"));
-  const plan = planUtilsDependencies(baseDir);
   try {
     applyUtilsDependencies(baseDir, plan);
   } catch (err) {
@@ -3286,6 +3642,17 @@ async function runInit(baseDirInput, answers, registryUrl, log = console.log) {
     return;
   }
   reportDependencies(plan, log);
+  if (tailwind4) {
+    const [head, ...rest] = tailwind4GuideLines(
+      readPackageJsonSafe(baseDir),
+      plan.installCommand,
+      answers.globalCss,
+      baseDir
+    );
+    log(chalk9.blue(`
+${head}`));
+    for (const line of rest) log(line.startsWith("  !") ? chalk9.yellow(line) : chalk9.cyan(line));
+  }
   log(chalk9.blue("\n\uCD08\uAE30\uD654 \uC644\uB8CC! \uC774\uC81C \uB2E4\uC74C \uBA85\uB839\uC5B4\uB85C \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uCD94\uAC00\uD558\uC138\uC694:"));
   log(chalk9.cyan(`  ${INIT_NEXT_STEP_COMMAND}
 `));
@@ -3295,6 +3662,7 @@ async function runInit(baseDirInput, answers, registryUrl, log = console.log) {
 function registerInitCommand(program2, registryUrl) {
   program2.command("init").description("\uD504\uB85C\uC81D\uD2B8\uC5D0 AXIS Design System \uCD08\uAE30\uD654").option("-y, --yes", "\uAE30\uBCF8\uAC12\uC73C\uB85C \uC790\uB3D9 \uC124\uC815").action(async (options) => {
     console.log(chalk10.blue("\n\u{1F3A8} AXIS Design System \uCD08\uAE30\uD654\n"));
+    const tailwind4 = isTailwind4(planUtilsDependencies(process.cwd()).tailwind);
     const config = options.yes ? { ...INIT_DEFAULTS } : await prompts2([
       {
         type: "text",
@@ -3303,7 +3671,7 @@ function registerInitCommand(program2, registryUrl) {
         initial: INIT_DEFAULTS.componentsDir
       },
       {
-        type: "text",
+        type: tailwind4 ? null : "text",
         name: "tailwindConfig",
         message: "Tailwind \uC124\uC815 \uD30C\uC77C:",
         initial: INIT_DEFAULTS.tailwindConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axis-ds/cli",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "type": "module",
   "description": "AXIS Design System - CLI for adding components (shadcn compatible)",
   "publishConfig": {