@spectrabrain/eds 0.1.0 → 0.2.0

package/dist/tokens.mjs

@@ -408,6 +408,276 @@ var tokenMap = /* @__PURE__ */ Object.freeze({
     "value": "#FDE047",
     "cssVariable": "--eds-color-stroke-warning-weak"
   },
+  "radius-1": {
+    "name": "radius-1",
+    "type": "dimension",
+    "value": {
+      "value": 2,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-1"
+  },
+  "radius-10": {
+    "name": "radius-10",
+    "type": "dimension",
+    "value": {
+      "value": 999,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-10"
+  },
+  "radius-2": {
+    "name": "radius-2",
+    "type": "dimension",
+    "value": {
+      "value": 4,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-2"
+  },
+  "radius-3": {
+    "name": "radius-3",
+    "type": "dimension",
+    "value": {
+      "value": 6,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-3"
+  },
+  "radius-4": {
+    "name": "radius-4",
+    "type": "dimension",
+    "value": {
+      "value": 8,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-4"
+  },
+  "radius-5": {
+    "name": "radius-5",
+    "type": "dimension",
+    "value": {
+      "value": 10,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-5"
+  },
+  "radius-6": {
+    "name": "radius-6",
+    "type": "dimension",
+    "value": {
+      "value": 12,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-6"
+  },
+  "radius-7": {
+    "name": "radius-7",
+    "type": "dimension",
+    "value": {
+      "value": 14,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-7"
+  },
+  "radius-8": {
+    "name": "radius-8",
+    "type": "dimension",
+    "value": {
+      "value": 16,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-8"
+  },
+  "radius-9": {
+    "name": "radius-9",
+    "type": "dimension",
+    "value": {
+      "value": 20,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-9"
+  },
+  "radius-none": {
+    "name": "radius-none",
+    "type": "dimension",
+    "value": {
+      "value": 0,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-radius-none"
+  },
+  "spacing-0.5": {
+    "name": "spacing-0.5",
+    "type": "dimension",
+    "value": {
+      "value": 2,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-0\\.5"
+  },
+  "spacing-1": {
+    "name": "spacing-1",
+    "type": "dimension",
+    "value": {
+      "value": 4,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-1"
+  },
+  "spacing-1.5": {
+    "name": "spacing-1.5",
+    "type": "dimension",
+    "value": {
+      "value": 6,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-1\\.5"
+  },
+  "spacing-10": {
+    "name": "spacing-10",
+    "type": "dimension",
+    "value": {
+      "value": 40,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-10"
+  },
+  "spacing-11": {
+    "name": "spacing-11",
+    "type": "dimension",
+    "value": {
+      "value": 44,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-11"
+  },
+  "spacing-12": {
+    "name": "spacing-12",
+    "type": "dimension",
+    "value": {
+      "value": 48,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-12"
+  },
+  "spacing-2": {
+    "name": "spacing-2",
+    "type": "dimension",
+    "value": {
+      "value": 8,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-2"
+  },
+  "spacing-2.5": {
+    "name": "spacing-2.5",
+    "type": "dimension",
+    "value": {
+      "value": 10,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-2\\.5"
+  },
+  "spacing-3": {
+    "name": "spacing-3",
+    "type": "dimension",
+    "value": {
+      "value": 12,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-3"
+  },
+  "spacing-3.5": {
+    "name": "spacing-3.5",
+    "type": "dimension",
+    "value": {
+      "value": 14,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-3\\.5"
+  },
+  "spacing-4": {
+    "name": "spacing-4",
+    "type": "dimension",
+    "value": {
+      "value": 16,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-4"
+  },
+  "spacing-4.5": {
+    "name": "spacing-4.5",
+    "type": "dimension",
+    "value": {
+      "value": 18,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-4\\.5"
+  },
+  "spacing-5": {
+    "name": "spacing-5",
+    "type": "dimension",
+    "value": {
+      "value": 20,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-5"
+  },
+  "spacing-6": {
+    "name": "spacing-6",
+    "type": "dimension",
+    "value": {
+      "value": 24,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-6"
+  },
+  "spacing-7": {
+    "name": "spacing-7",
+    "type": "dimension",
+    "value": {
+      "value": 28,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-7"
+  },
+  "spacing-7.5": {
+    "name": "spacing-7.5",
+    "type": "dimension",
+    "value": {
+      "value": 30,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-7\\.5"
+  },
+  "spacing-8": {
+    "name": "spacing-8",
+    "type": "dimension",
+    "value": {
+      "value": 32,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-8"
+  },
+  "spacing-9": {
+    "name": "spacing-9",
+    "type": "dimension",
+    "value": {
+      "value": 36,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-9"
+  },
+  "spacing-none": {
+    "name": "spacing-none",
+    "type": "dimension",
+    "value": {
+      "value": 0,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-spacing-none"
+  },
   "typography-body1-fontFamily": {
     "name": "typography-body1-fontFamily",
     "type": "fontFamily",
@@ -1210,6 +1480,36 @@ var tokenNames = /* @__PURE__ */ Object.freeze([
   "color-stroke-positive-weak",
   "color-stroke-warning-primary",
   "color-stroke-warning-weak",
+  "radius-1",
+  "radius-10",
+  "radius-2",
+  "radius-3",
+  "radius-4",
+  "radius-5",
+  "radius-6",
+  "radius-7",
+  "radius-8",
+  "radius-9",
+  "radius-none",
+  "spacing-0.5",
+  "spacing-1",
+  "spacing-1.5",
+  "spacing-10",
+  "spacing-11",
+  "spacing-12",
+  "spacing-2",
+  "spacing-2.5",
+  "spacing-3",
+  "spacing-3.5",
+  "spacing-4",
+  "spacing-4.5",
+  "spacing-5",
+  "spacing-6",
+  "spacing-7",
+  "spacing-7.5",
+  "spacing-8",
+  "spacing-9",
+  "spacing-none",
   "typography-body1-fontFamily",
   "typography-body1-fontSize",
   "typography-body1-fontWeight",
@@ -1300,7 +1600,7 @@ function cssVar(name) {
   if (!tokenNames.includes(name)) {
     throw new Error("Unknown semantic token: " + name);
   }
-  return "var(--eds-" + name + ")";
+  return "var(" + tokenMap[name].cssVariable + ")";
 }
 
 export { cssVar, tokenNames, tokens };

package/llms.txt

@@ -1,19 +1,25 @@
-# EVA Design System AI 문서 인덱스
+# EVA Design System (@spectrabrain/eds)
 
-이 패키지는 React 웹용 EVA 디자인 시스템입니다. 소비처 AI는 `require.resolve("@spectrabrain/eds/package.json")`로 설치된 package root를 찾은 뒤 다음 순서로 문서를 읽습니다. 아래 경로는 모두 package root 기준 파일 경로입니다. 필수 읽기는 1번 하나이며 나머지는 조건에 해당할 때만 읽습니다. 읽기 순서와 조건의 기계용 원천은 `AI_CONTEXT.json`의 `readOrder`이며, 이 문서와 다르면 `AI_CONTEXT.json`을 따릅니다.
+> React 웹용 EVA 디자인 시스템 패키지입니다. 소비처 AI는 package root(`require.resolve("@spectrabrain/eds/package.json")`의 디렉터리)의 `QUICKSTART.md` 하나를 먼저 읽고, 나머지는 아래 조건에 해당할 때만 읽습니다. 같은 목록의 기계용 원천은 `AI_CONTEXT.json`의 `readOrder`입니다.
 
-1. `QUICKSTART.md`: 규칙, 명령, 더 읽을 문서의 조건입니다. 필수입니다.
-2. `CONSUMER_AGENT.md`: setup·sync·doctor를 다룰 때 managed block, 패키지 매니저별 `init`, font 정책, 보고 형식을 확인합니다.
-3. `AI.md`: 공개 범위와 금지 사례를 확인할 때 읽습니다.
-4. `TOKEN_CONTEXT.md`: token을 직접 고를 때 semantic color·typography의 역할을 확인합니다.
-5. `TAILWIND_V4.md`: Tailwind CSS v4에서 token을 사용할 때 읽습니다.
-6. `dist/tokens.json`: token, CSS variable, Tailwind alias를 고를 때 설치된 버전의 공개 token 이름을 확인합니다.
-7. `dist/components/Button/README.md`: Button을 사용할 때 개요·사용 맥락·API를 읽습니다.
-8. `dist/components/Button/spec.json`: Button API나 접근성 동작을 구현할 때 허용 조합, 접근성 계약, `api.iconNames` 아이콘 목록을 확인합니다.
-9. `CHANGELOG.md`: EDS 버전을 올린 뒤 바뀐 내용을 확인할 때 읽습니다.
+EDS 내부 소스로 동작을 추론하지 않고 공개 문서와 TypeScript contract를 기준으로 합니다. 링크는 모두 package root 기준 경로입니다.
 
-설치 방법과 CSS 진입점은 `README.md`에서 확인합니다. `dist/` 아래 파일은 `@spectrabrain/eds/tokens.json`, `@spectrabrain/eds/components/Button/spec.json`처럼 `dist/`를 뗀 export 경로로도 읽을 수 있습니다.
+## 필수
 
-npm 10·11에서는 EDS `postinstall`이 소비처 `package.json`에 `sync:eds`·`eds:doctor` script를 등록하고, 그 밖의 환경에서는 `npx @spectrabrain/eds init`이 같은 script를 등록합니다. 설치·업데이트 후 소비처는 `npm run sync:eds`를 명시적으로 실행해 Tailwind root CSS import, Tailwind alias, `AGENTS.md` managed block을 갱신하며, `npm run eds:doctor`로 동기화 상태를 점검합니다. EDS text style은 `@spectrabrain/eds/fonts.css`가 선언하는 font family를 참조하므로 `styles.css` 또는 `fonts.css` import를 생략하지 않습니다.
+- [QUICKSTART.md](./QUICKSTART.md): UI 작업 규칙, 완료 기준과 doctor 실패 시 복구 순서, 명령(`npm run sync:eds`, `npm run eds:doctor`), 조건부 문서 목록입니다.
 
-문서에 없는 API나 시각 상태를 추측하지 않습니다. 구현보다 공개 문서와 TypeScript contract를 우선합니다.
+## 조건부
+
+- [CONSUMER_AGENT.md](./CONSUMER_AGENT.md): 소비처 `AGENTS.md`에 `<!-- EDS:BEGIN -->` block이 없거나, sync·doctor가 exit 2이거나 sync 뒤에도 doctor가 exit 1이거나, 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`에 없는 컴포넌트를 요구할 때 읽습니다.
+- [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/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`에 있습니다.
+- [CHANGELOG.md](./CHANGELOG.md): EDS 버전을 올렸을 때(설치된 버전이 `AGENTS.md`의 `EDS:VERSION` 줄보다 높을 때) 읽습니다.
+
+## Optional
+
+- [README.md](./README.md): 사람을 위한 설치 안내와 공개 경로 표입니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrabrain/eds",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "EVA services' shared React design system",
   "author": "SpectraBrain",
   "license": "UNLICENSED",
@@ -25,6 +25,7 @@
     "llms.txt",
     "TAILWIND_V4.md",
     "QUICKSTART.md",
+    "FRONTEND_CONVENTIONS.md",
     "CHANGELOG.md",
     "consumer-postinstall.mjs",
     "consumer",
@@ -140,6 +141,7 @@
     "./llms.txt": "./llms.txt",
     "./TAILWIND_V4.md": "./TAILWIND_V4.md",
     "./QUICKSTART.md": "./QUICKSTART.md",
+    "./FRONTEND_CONVENTIONS.md": "./FRONTEND_CONVENTIONS.md",
     "./package.json": "./package.json"
   }
 }