@spectrabrain/eds 0.2.2 → 0.3.1

package/consumer/cli.mjs

@@ -8,13 +8,13 @@ const usage = [
   "Usage: eds <command> [options]",
   "",
   "Commands:",
-  "  init      Register sync:eds and eds:doctor, plus pretypecheck/prebuild (eds doctor) when typecheck/build exist,",
-  "            write allowScripts on npm 12+, then run sync. Run it in the package that declares @spectrabrain/eds",
+  "  init      Add sync:eds and eds:doctor when missing; add pretypecheck/prebuild when target scripts exist",
+  "            and hooks are missing; write allowScripts on npm 12+, then sync in the package declaring @spectrabrain/eds",
   "  sync      Generate src/styles/eds-tokens.css, wire the Tailwind root CSS and update AGENTS.md",
   "            and the @AGENTS.md import in CLAUDE.md (or .claude/CLAUDE.md) and GEMINI.md when they exist",
   "            (without a Tailwind root only those change); notes say when an agent may not load the block",
-  "  doctor    Check whether sync is up to date, the EDS font is imported and every eds-* class in the sources",
-  "            is a public token (exit 1 when something is off)",
+  "  doctor    Check sync status and the EDS font import; with a Tailwind CSS v4 root, also check that each eds-*",
+  "            class in the sources is a public token (exit 1 when something is off)",
   "  align     One-time reorganization of a Vite + React frontend into the EVA conventions (FRONTEND_CONVENTIONS.md):",
   "            write .eds/align/PLAN.md, the steps an AI agent follows, plus templates; source files are not changed",
   "",
@@ -25,9 +25,9 @@ const usage = [
   "  --no-allow-scripts         init: do not write allowScripts to package.json on npm 12+",
   "  --print-ci github|gitlab   init: print a CI job that runs eds doctor with this repository's package manager",
   "  --warn                     doctor: report findings but exit 0 (same as EDS_DOCTOR=warn)",
-  "  --scan                     doctor: also list Tailwind palette and arbitrary color classes that bypass the EDS tokens",
-  "  --check                    align: check the conventions and that no backend or out-of-package file changed since",
-  "                             the plan's base commit (exit 1 when something is off)",
+  "  --scan                     doctor: with a Tailwind CSS v4 root, also list palette and arbitrary color classes that bypass EDS tokens",
+  "  --check                    align: check conventions and protected, preserved and out-of-package files",
+  "                             since the plan's base commit; repository root lockfiles are excluded (exit 1 on error)",
   "  --frontend <dir>           align: the frontend package when the current directory is not it",
   "  --help                     Show this message",
   "",

package/dist/components/Button/README.md

@@ -109,7 +109,7 @@ Layout은 prop으로 지정하지 않고 슬롯 조합에서 추론합니다.
 | `aria-label` | 선택적인 `string`이며, 지정하면 비어 있지 않아야 합니다. icon-only에서는 항상 지정합니다. |
 | `disabled` | `boolean`입니다. native button은 `disabled`, link는 href 제거·`aria-disabled="true"`·`tabIndex={-1}`를 적용합니다. |
 | `loading` | `boolean`입니다. label·아이콘 공간을 유지한 progress circle을 표시하고 상호작용을 차단하며 `aria-busy="true"`를 적용합니다. |
-| `className` | `string`입니다. 허용 범위는 `QUICKSTART.md` 규칙 5를 따릅니다. |
+| `className` | `string`입니다. 허용 범위는 `QUICKSTART.md`의 `className` 규칙을 따릅니다. |
 | `style` | 지원하지 않습니다(`never`). 스타일 override는 공개 API가 아닙니다. |
 | `aria-*` / `data-*` | 각 branch의 native HTML 속성으로 전달할 수 있습니다. |
 | `ref` | branch에 따라 `HTMLButtonElement` 또는 `HTMLAnchorElement`를 전달합니다. |

package/dist/components/Button/spec.json

@@ -1,6 +1,6 @@
 {
   "specVersion": 1,
-  "packageVersion": "0.2.2",
+  "packageVersion": "0.3.1",
   "name": "Button",
   "purpose": "사용자가 즉시 실행할 수 있는 행동과 탐색을 표현하는 인터랙티브 요소입니다.",
   "usageContexts": [
@@ -258,7 +258,7 @@
   },
   "accessibility": {
     "iconOnlyName": "icon-only의 아이콘은 aria-hidden이므로 항상 비어 있지 않은 aria-label 또는 aria-labelledby로 이름을 지정합니다. 타입이 이를 요구하지 않아 빠뜨려도 typecheck가 통과하며, 빈 aria-label은 render 오류입니다.",
-    "loading": "loading 중에도 label·아이콘 공간과 accessible name을 유지합니다. native button은 disabled가 되어 포커스를 잃을 수 있으므로, 끝나면 포커스를 원래 Button이나 결과 요소로 옮기고 결과는 Button 밖의 status·alert 영역으로 알립니다."
+    "loading": "loading 중에도 label·아이콘 공간과 accessible name을 유지합니다. native button은 disabled가 되어 포커스를 잃을 수 있으므로, 끝나면 포커스를 원래 Button이나 결과 요소로 옮기고 결과는 Button 밖의 status·alert 영역으로 알립니다. prefers-reduced-motion: reduce에서는 progress 회전 애니메이션을 끕니다."
   },
   "unsupportedProps": [
     {

package/dist/components.css

@@ -106,17 +106,17 @@
   --eds-button-style-neutral-link-loading-progressCircle-trackColor: #6B7280;
   --eds-button-style-neutral-link-loading-root-backgroundColor: var(--eds-color-bg-transparent-hover);
   --eds-button-style-neutral-outline-disabled-label-color: var(--eds-color-fg-disabled);
-  --eds-button-style-neutral-outline-disabled-root-backgroundColor: var(--eds-color-bg-transparent);
-  --eds-button-style-neutral-outline-disabled-root-borderColor: var(--eds-color-stroke-neutral-secondary);
+  --eds-button-style-neutral-outline-disabled-root-backgroundColor: var(--eds-color-bg-neutral-primary);
+  --eds-button-style-neutral-outline-disabled-root-borderColor: var(--eds-color-stroke-neutral-tertiary);
   --eds-button-style-neutral-outline-disabled-root-borderWidth: 1px;
   --eds-button-style-neutral-outline-enabled-label-color: var(--eds-color-fg-neutral);
-  --eds-button-style-neutral-outline-enabled-root-backgroundColor: var(--eds-color-bg-transparent);
-  --eds-button-style-neutral-outline-enabled-root-borderColor: var(--eds-color-stroke-neutral-secondary);
+  --eds-button-style-neutral-outline-enabled-root-backgroundColor: var(--eds-color-bg-neutral-primary);
+  --eds-button-style-neutral-outline-enabled-root-borderColor: var(--eds-color-stroke-neutral-tertiary);
   --eds-button-style-neutral-outline-enabled-root-borderWidth: 1px;
-  --eds-button-style-neutral-outline-hover-root-backgroundColor: var(--eds-color-bg-transparent-hover);
+  --eds-button-style-neutral-outline-hover-root-backgroundColor: var(--eds-color-bg-neutral-primary-hover);
   --eds-button-style-neutral-outline-loading-progressCircle-rangeColor: var(--eds-color-fg-neutral);
   --eds-button-style-neutral-outline-loading-progressCircle-trackColor: #D1D5DB;
-  --eds-button-style-neutral-outline-loading-root-backgroundColor: var(--eds-color-bg-transparent-hover);
+  --eds-button-style-neutral-outline-loading-root-backgroundColor: var(--eds-color-bg-neutral-primary-hover);
   --eds-button-style-neutral-solid-disabled-label-color: var(--eds-color-fg-disabled);
   --eds-button-style-neutral-solid-disabled-root-backgroundColor: var(--eds-color-bg-disabled);
   --eds-button-style-neutral-solid-enabled-label-color: var(--eds-color-fg-neutral-inverted);
@@ -267,7 +267,7 @@
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .eds-button__progressCircle > svg {
+  .eds-button__button[data-loading="true"] .eds-button__progressCircle > svg {
     animation: none;
     will-change: auto;
   }

package/llms.txt

@@ -1,23 +1,21 @@
 # EVA Design System (@spectrabrain/eds)
 
-> React 웹용 EVA 디자인 시스템 패키지입니다. 소비처 AI는 package root(`require.resolve("@spectrabrain/eds/package.json")`의 디렉터리)의 `QUICKSTART.md` 하나를 먼저 읽고, 나머지는 아래 조건에 해당할 때만 읽습니다. 같은 목록의 기계용 원천은 `AI_CONTEXT.json`의 `readOrder`입니다.
-
-EDS 내부 소스로 동작을 추론하지 않고 공개 문서와 TypeScript contract를 기준으로 합니다. 링크는 모두 package root 기준 경로입니다.
+> 소비처 AI는 package root의 `QUICKSTART.md`를 먼저 읽고, 나머지는 아래 조건에 해당할 때만 읽습니다. 기계용 경로와 조건은 `AI_CONTEXT.json`의 `readOrder`에 있습니다.
 
 ## 필수
 
-- [QUICKSTART.md](./QUICKSTART.md): UI 작업 규칙, 완료 기준과 doctor 실패 시 복구 순서, 명령(`npm run sync:eds`, `npm run eds:doctor`), 조건부 문서 목록입니다.
+- [QUICKSTART.md](./QUICKSTART.md): UI 작업 규칙, 완료 기준, doctor 복구 순서와 조건별 문서 안내입니다.
 
 ## 조건부
 
-- [CONSUMER_AGENT.md](./CONSUMER_AGENT.md): 소비처 `AGENTS.md`에 `<!-- EDS:BEGIN -->` block이 없거나, sync·doctor가 exit 2이거나 sync 뒤에도 doctor가 exit 1이거나, EDS 버전을 올렸거나, 사용자가 프로토타입을 EVA 구조로 정리하라고 요청했을 때(`eds align`) 읽습니다.
+- [CONSUMER_AGENT.md](./CONSUMER_AGENT.md): 소비처 `AGENTS.md`에 `<!-- EDS:BEGIN -->` block이 없거나, `eds doctor`가 exit 1·2 또는 `eds sync`가 exit 2로 끝나거나, sync 복구가 불분명하거나, EDS 버전을 올렸거나, 사용자가 프로토타입을 EVA 구조로 정리하라고 요청했을 때(`eds align`) 읽습니다.
 - [TOKEN_CONTEXT.md](./TOKEN_CONTEXT.md): EDS 컴포넌트 prop 밖에서 color·typography·spacing·radius token을 지정하거나 바꿀 때 읽습니다. Tailwind 없이 CSS variable이나 `cssVar()`로 쓰는 경우도 포함합니다.
 - [TAILWIND_V4.md](./TAILWIND_V4.md): Tailwind CSS v4 adapter나 root CSS 배선을 설정하거나 고칠 때 읽습니다.
-- [AI.md](./AI.md): 요청이 dark theme, 생성된 class 밖의 Tailwind utility, `AI_CONTEXT.json` `components`에 없는 컴포넌트를 요구할 때 읽습니다.
+- [AI.md](./AI.md): 요청이 dark theme, EDS Tailwind plugin, 생성 CSS에 없는 EDS token utility alias, `AI_CONTEXT.json` `components`에 없는 컴포넌트를 요구할 때 읽습니다.
 - [FRONTEND_CONVENTIONS.md](./FRONTEND_CONVENTIONS.md): `.eds/align/PLAN.md`가 있거나(`eds align` 진행 중), 소비처 `AGENTS.md`가 구조·라이브러리·코드 패턴 변경에 이 문서를 가리킬 때 읽습니다.
-- [dist/components/Button/README.md](./dist/components/Button/README.md): Button을 쓸 때 사용 맥락, role·variant 선택, prop, 접근성, 목록 밖 아이콘 규칙을 읽습니다.
+- [dist/components/Button/README.md](./dist/components/Button/README.md): 요청이 Button으로 해결될 수 있는지 판단할 때 사용 맥락과 role·variant 선택 기준을 읽고, 선택하면 prop·접근성 계약을 따릅니다.
 - [dist/components/Button/spec.json](./dist/components/Button/spec.json): `api.iconNames`의 아이콘 이름을 확인하거나 도구가 기계용 계약을 읽을 때 씁니다.
-- [dist/tokens.json](./dist/tokens.json): 도구·스크립트가 기계용 token manifest와 public 이름→CSS variable mapping을 읽거나, Tailwind 없이 쓸 `var(--eds-*)` 이름을 확인할 때 씁니다. class 이름은 `src/styles/eds-tokens.css`에 있습니다.
+- [dist/tokens.json](./dist/tokens.json): 도구·스크립트가 기계용 token manifest와 public 이름→CSS variable mapping을 읽거나, Tailwind 없이 쓸 `var(--eds-*)` 이름을 확인할 때 씁니다. Tailwind CSS v4 root를 sync한 소비처에서는 생성 class 이름을 `src/styles/eds-tokens.css`에서 확인합니다.
 - [CHANGELOG.md](./CHANGELOG.md): EDS 버전을 올렸을 때(설치된 버전이 `AGENTS.md`의 `EDS:VERSION` 줄보다 높을 때) 읽습니다.
 
 ## Optional

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrabrain/eds",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "EVA services' shared React design system",
   "author": "SpectraBrain",
   "license": "UNLICENSED",
@@ -87,7 +87,7 @@
     "@vitest/browser-playwright": "4.1.6",
     "axe-core": "^4.11.0",
     "jsdom": "^26.1.0",
-    "playwright": "1.63.0",
+    "playwright": "1.61.1",
     "postcss": "^8.5.6",
     "postcss-modules": "^6.0.1",
     "react": "^19.2.8",

package/consumer/align/templates/env.mock

@@ -1 +0,0 @@
-VITE_API_MOCKING=true

package/consumer/align/templates/src/mocks/browser.ts

@@ -1,5 +0,0 @@
-import { setupWorker } from "msw/browser";
-import { handlers } from "./handlers";
-
-// The Service Worker that answers API requests in npm run dev:mock.
-export const worker = setupWorker(...handlers);

package/consumer/align/templates/src/mocks/handlers.ts

@@ -1,4 +0,0 @@
-import type { RequestHandler } from "msw";
-
-// Spread each domain's handlers from mocks/<domain>/index.ts, for example ...accountHandlers.
-export const handlers: RequestHandler[] = [];