@spectrabrain/eds 0.0.3 → 0.1.0

package/dist/tokens.mjs

@@ -1,5 +1,5 @@
 // src/generated/tokens.ts
-var tokenMap = {
+var tokenMap = /* @__PURE__ */ Object.freeze({
   "color-bg-brand-primary": {
     "name": "color-bg-brand-primary",
     "type": "color",
@@ -12,6 +12,18 @@ var tokenMap = {
     "value": "#DB3700",
     "cssVariable": "--eds-color-bg-brand-primary-hover"
   },
+  "color-bg-brand-weak": {
+    "name": "color-bg-brand-weak",
+    "type": "color",
+    "value": "#FFA081",
+    "cssVariable": "--eds-color-bg-brand-weak"
+  },
+  "color-bg-brand-weak-hover": {
+    "name": "color-bg-brand-weak-hover",
+    "type": "color",
+    "value": "#FF7141",
+    "cssVariable": "--eds-color-bg-brand-weak-hover"
+  },
   "color-bg-critical-primary": {
     "name": "color-bg-critical-primary",
     "type": "color",
@@ -27,13 +39,13 @@ var tokenMap = {
   "color-bg-critical-weak": {
     "name": "color-bg-critical-weak",
     "type": "color",
-    "value": "#FEF2F2",
+    "value": "#FEE2E2",
     "cssVariable": "--eds-color-bg-critical-weak"
   },
   "color-bg-critical-weak-hover": {
     "name": "color-bg-critical-weak-hover",
     "type": "color",
-    "value": "#FEE2E2",
+    "value": "#FECACA",
     "cssVariable": "--eds-color-bg-critical-weak-hover"
   },
   "color-bg-disabled": {
@@ -57,13 +69,13 @@ var tokenMap = {
   "color-bg-informative-weak": {
     "name": "color-bg-informative-weak",
     "type": "color",
-    "value": "#EFF6FF",
+    "value": "#DBEAFE",
     "cssVariable": "--eds-color-bg-informative-weak"
   },
   "color-bg-informative-weak-hover": {
     "name": "color-bg-informative-weak-hover",
     "type": "color",
-    "value": "#DBEAFE",
+    "value": "#BFDBFE",
     "cssVariable": "--eds-color-bg-informative-weak-hover"
   },
   "color-bg-layer-basement": {
@@ -72,6 +84,12 @@ var tokenMap = {
     "value": "#F3F4F6",
     "cssVariable": "--eds-color-bg-layer-basement"
   },
+  "color-bg-layer-basement-hover": {
+    "name": "color-bg-layer-basement-hover",
+    "type": "color",
+    "value": "#ECEEF1",
+    "cssVariable": "--eds-color-bg-layer-basement-hover"
+  },
   "color-bg-layer-default": {
     "name": "color-bg-layer-default",
     "type": "color",
@@ -147,13 +165,13 @@ var tokenMap = {
   "color-bg-positive-weak": {
     "name": "color-bg-positive-weak",
     "type": "color",
-    "value": "#F0FDF4",
+    "value": "#DCFCE7",
     "cssVariable": "--eds-color-bg-positive-weak"
   },
   "color-bg-positive-weak-hover": {
     "name": "color-bg-positive-weak-hover",
     "type": "color",
-    "value": "#DCFCE7",
+    "value": "#BBF7D0",
     "cssVariable": "--eds-color-bg-positive-weak-hover"
   },
   "color-bg-transparent": {
@@ -183,13 +201,13 @@ var tokenMap = {
   "color-bg-warning-weak": {
     "name": "color-bg-warning-weak",
     "type": "color",
-    "value": "#FEFCE8",
+    "value": "#FEF9C3",
     "cssVariable": "--eds-color-bg-warning-weak"
   },
   "color-bg-warning-weak-hover": {
     "name": "color-bg-warning-weak-hover",
     "type": "color",
-    "value": "#FEF9C3",
+    "value": "#FEF08A",
     "cssVariable": "--eds-color-bg-warning-weak-hover"
   },
   "color-fg-brand": {
@@ -291,7 +309,7 @@ var tokenMap = {
   "color-fg-warning-contrast": {
     "name": "color-fg-warning-contrast",
     "type": "color",
-    "value": "#713F12",
+    "value": "#A16207",
     "cssVariable": "--eds-color-fg-warning-contrast"
   },
   "color-stroke-brand-primary": {
@@ -351,9 +369,15 @@ var tokenMap = {
   "color-stroke-neutral-secondary": {
     "name": "color-stroke-neutral-secondary",
     "type": "color",
-    "value": "#E5E7EB",
+    "value": "#9CA3AF",
     "cssVariable": "--eds-color-stroke-neutral-secondary"
   },
+  "color-stroke-neutral-tertiary": {
+    "name": "color-stroke-neutral-tertiary",
+    "type": "color",
+    "value": "#E5E7EB",
+    "cssVariable": "--eds-color-stroke-neutral-tertiary"
+  },
   "color-stroke-neutral-weak": {
     "name": "color-stroke-neutral-weak",
     "type": "color",
@@ -900,6 +924,49 @@ var tokenMap = {
     },
     "cssVariable": "--eds-typography-heading3-lineHeight"
   },
+  "typography-heading4-fontFamily": {
+    "name": "typography-heading4-fontFamily",
+    "type": "fontFamily",
+    "value": [
+      "Pretendard",
+      "system-ui",
+      "sans-serif"
+    ],
+    "cssVariable": "--eds-typography-heading4-fontFamily"
+  },
+  "typography-heading4-fontSize": {
+    "name": "typography-heading4-fontSize",
+    "type": "dimension",
+    "value": {
+      "value": 1.25,
+      "unit": "rem"
+    },
+    "cssVariable": "--eds-typography-heading4-fontSize"
+  },
+  "typography-heading4-fontWeight": {
+    "name": "typography-heading4-fontWeight",
+    "type": "fontWeight",
+    "value": 550,
+    "cssVariable": "--eds-typography-heading4-fontWeight"
+  },
+  "typography-heading4-letterSpacing": {
+    "name": "typography-heading4-letterSpacing",
+    "type": "dimension",
+    "value": {
+      "value": -0.2,
+      "unit": "px"
+    },
+    "cssVariable": "--eds-typography-heading4-letterSpacing"
+  },
+  "typography-heading4-lineHeight": {
+    "name": "typography-heading4-lineHeight",
+    "type": "dimension",
+    "value": {
+      "value": 2,
+      "unit": "rem"
+    },
+    "cssVariable": "--eds-typography-heading4-lineHeight"
+  },
   "typography-title1-fontFamily": {
     "name": "typography-title1-fontFamily",
     "type": "fontFamily",
@@ -1072,11 +1139,13 @@ var tokenMap = {
     },
     "cssVariable": "--eds-typography-title4-lineHeight"
   }
-};
-var tokens = Object.freeze(tokenMap);
-var tokenNames = Object.freeze([
+});
+var tokens = tokenMap;
+var tokenNames = /* @__PURE__ */ Object.freeze([
   "color-bg-brand-primary",
   "color-bg-brand-primary-hover",
+  "color-bg-brand-weak",
+  "color-bg-brand-weak-hover",
   "color-bg-critical-primary",
   "color-bg-critical-primary-hover",
   "color-bg-critical-weak",
@@ -1087,6 +1156,7 @@ var tokenNames = Object.freeze([
   "color-bg-informative-weak",
   "color-bg-informative-weak-hover",
   "color-bg-layer-basement",
+  "color-bg-layer-basement-hover",
   "color-bg-layer-default",
   "color-bg-layer-default-hover",
   "color-bg-layer-floating",
@@ -1134,6 +1204,7 @@ var tokenNames = Object.freeze([
   "color-stroke-neutral-contrast",
   "color-stroke-neutral-primary",
   "color-stroke-neutral-secondary",
+  "color-stroke-neutral-tertiary",
   "color-stroke-neutral-weak",
   "color-stroke-positive-primary",
   "color-stroke-positive-weak",
@@ -1199,6 +1270,11 @@ var tokenNames = Object.freeze([
   "typography-heading3-fontWeight",
   "typography-heading3-letterSpacing",
   "typography-heading3-lineHeight",
+  "typography-heading4-fontFamily",
+  "typography-heading4-fontSize",
+  "typography-heading4-fontWeight",
+  "typography-heading4-letterSpacing",
+  "typography-heading4-lineHeight",
   "typography-title1-fontFamily",
   "typography-title1-fontSize",
   "typography-title1-fontWeight",
@@ -1221,11 +1297,10 @@ var tokenNames = Object.freeze([
   "typography-title4-lineHeight"
 ]);
 function cssVar(name) {
-  const token = tokens[name];
-  if (!token) {
+  if (!tokenNames.includes(name)) {
     throw new Error("Unknown semantic token: " + name);
   }
-  return "var(" + token.cssVariable + ")";
+  return "var(--eds-" + name + ")";
 }
 
 export { cssVar, tokenNames, tokens };

package/llms.txt

@@ -1,11 +1,19 @@
 # EVA Design System AI 문서 인덱스
 
-이 패키지는 React 웹용 EVA 디자인 시스템입니다. 다음 순서로 문서를 읽습니다.
+이 패키지는 React 웹용 EVA 디자인 시스템입니다. 소비처 AI는 `require.resolve("@spectrabrain/eds/package.json")`로 설치된 package root를 찾은 뒤 다음 순서로 문서를 읽습니다. 아래 경로는 모두 package root 기준 파일 경로입니다. 필수 읽기는 1번 하나이며 나머지는 조건에 해당할 때만 읽습니다. 읽기 순서와 조건의 기계용 원천은 `AI_CONTEXT.json`의 `readOrder`이며, 이 문서와 다르면 `AI_CONTEXT.json`을 따릅니다.
 
-1. [AI 사용 규칙](./AI.md)을 읽고 공개 범위와 금지 사례를 확인합니다.
-2. [Button 개요·사용 맥락·API](./dist/components/Button/README.md)를 읽은 뒤 컴포넌트를 사용합니다.
-3. [Button 공개 manifest](./dist/components/Button/spec.json)에서 허용 조합과 접근성 계약을 확인합니다.
-4. [semantic token manifest](./dist/tokens.json)에서 사용 가능한 token 이름을 확인합니다.
-5. [npm 소비자 안내](./README.md)에서 설치와 CSS 진입점을 확인합니다.
+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 버전을 올린 뒤 바뀐 내용을 확인할 때 읽습니다.
 
-문서에 없는 API나 시각 상태를 추측하지 않습니다. 구현보다 문서와 TypeScript contract를 우선합니다.
+설치 방법과 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를 생략하지 않습니다.
+
+문서에 없는 API나 시각 상태를 추측하지 않습니다. 구현보다 공개 문서와 TypeScript contract를 우선합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrabrain/eds",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "EVA services' shared React design system",
   "author": "SpectraBrain",
   "license": "UNLICENSED",
@@ -8,13 +8,31 @@
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "tokens": [
+        "./dist/tokens.d.ts"
+      ]
+    }
+  },
   "files": [
     "dist",
     "README.md",
     "AI.md",
+    "AI_CONTEXT.json",
+    "CONSUMER_AGENT.md",
+    "TOKEN_CONTEXT.md",
     "llms.txt",
+    "TAILWIND_V4.md",
+    "QUICKSTART.md",
+    "CHANGELOG.md",
+    "consumer-postinstall.mjs",
+    "consumer",
     "NOTICE"
   ],
+  "bin": {
+    "eds": "./consumer/cli.mjs"
+  },
   "scripts": {
     "tokens:generate": "tsx scripts/build-tokens.ts",
     "components:generate": "tsx scripts/build-components.ts",
@@ -22,6 +40,7 @@
     "tokens:validate": "tsx scripts/build-tokens.ts --validate",
     "tokens:connectivity": "tsx scripts/check-token-connectivity.ts",
     "tokens:connectivity:strict": "npm run tokens:connectivity -- --strict",
+    "tokens:contrast": "npm run tokens:generate && tsx scripts/check-token-contrast.ts",
     "library:build": "tsup",
     "fonts:build": "tsx scripts/build-font-assets.ts",
     "tokens:build": "npm run typecheck && npm run library:build && npm run component-manifest:generate && npm run fonts:build && npm run public-boundary:check",
@@ -32,6 +51,7 @@
     "typecheck": "npm run tokens:generate && npm run components:generate && npm run component-manifest:generate && tsc --noEmit",
     "build": "npm run tokens:build",
     "package:check": "node scripts/check-package-exports.mjs",
+    "postinstall": "node ./consumer-postinstall.mjs",
     "prepack": "npm run tokens:build",
     "test:unit": "vitest run",
     "test": "npm run tokens:build && npm run test:unit"
@@ -45,7 +65,9 @@
   "sideEffects": [
     "./dist/tokens.css",
     "./dist/styles.css",
-    "./dist/fonts.css"
+    "./dist/fonts.css",
+    "./dist/components.css",
+    "./dist/base.css"
   ],
   "peerDependencies": {
     "react": ">=18.2 <20"
@@ -105,10 +127,19 @@
     "./tokens.css": "./dist/tokens.css",
     "./styles.css": "./dist/styles.css",
     "./fonts.css": "./dist/fonts.css",
+    "./components.css": "./dist/components.css",
+    "./base.css": "./dist/base.css",
     "./tokens.json": "./dist/tokens.json",
     "./components/Button/README.md": "./dist/components/Button/README.md",
     "./components/Button/spec.json": "./dist/components/Button/spec.json",
+    "./CONSUMER_AGENT.md": "./CONSUMER_AGENT.md",
+    "./AI.md": "./AI.md",
+    "./CHANGELOG.md": "./CHANGELOG.md",
+    "./AI_CONTEXT.json": "./AI_CONTEXT.json",
+    "./TOKEN_CONTEXT.md": "./TOKEN_CONTEXT.md",
     "./llms.txt": "./llms.txt",
+    "./TAILWIND_V4.md": "./TAILWIND_V4.md",
+    "./QUICKSTART.md": "./QUICKSTART.md",
     "./package.json": "./package.json"
   }
 }