chroma-ux 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# chroma-ux
+
+OKLCH 기반 UX/UI 디자인 토큰 생성 라이브러리. **런타임 의존성 0**, ESM/CJS 지원.
+
+- **Primary 고정**: 브랜드 Primary 색상을 라이트/다크 모드별로 고정
+- **라이트·다크 동시 생성**: 한 번의 호출로 두 테마 토큰 세트 생성
+- **확장 토큰**: 버튼 상태(hover/pressed/disabled), semantic, border/divider/focusRing
+- **접근성**: WCAG AA/AAA, CVD(색약/색맹) 시뮬레이션
+
+---
+
+## 한 줄로 시작하기 (npx)
+
+설치 없이 바로 사용:
+
+```bash
+# Primary 색상만 넣으면 JSON 토큰 출력
+npx chroma-ux 5B5FF5
+
+# CSS 변수로 출력
+npx chroma-ux #5B5FF5 --css
+```
+
+---
+
+## 설치
+
+```bash
+npm install chroma-ux
+```
+
+---
+
+## 사용법
+
+### ESM
+
+```javascript
+import { recommendTokensDual } from "chroma-ux";
+
+const { light, dark } = recommendTokensDual({
+  primaryHex: "#5B5FF5",
+  contrastTarget: "AA",
+  randomSeed: 42,
+});
+
+console.log(light.tokens.primary);   // #5B5FF5
+console.log(dark.tokens.background);
+```
+
+### CJS
+
+```javascript
+const { recommendTokensDual } = require("chroma-ux");
+
+const result = recommendTokensDual({ primaryHex: "#5B5FF5" });
+```
+
+### JSON 내보내기
+
+```javascript
+import { recommendTokensDualAsJson } from "chroma-ux";
+
+const json = recommendTokensDualAsJson({ primaryHex: "#5B5FF5" });
+```
+
+---
+
+## API
+
+### `recommendTokensDual(options)`
+
+| 옵션 | 기본값 | 설명 |
+|------|-------|------|
+| `primaryHex` | **필수** | 브랜드 Primary (hex) |
+| `primaryDarkHex` | `primaryHex` | 다크 전용 Primary |
+| `seedHex` | - | 중성/액센트 시드 |
+| `contrastTarget` | `"AA"` | `"AA"` \| `"AAA"` |
+| `iterations` | `3500` | 최적화 반복 수 |
+| `randomSeed` | 랜덤 | 재현용 시드 |
+
+### `validateTokens(tokens, target?, cvdModes?)`
+
+대비·상태 검증.
+
+---
+
+## npm 배포
+
+**배포되는 파일**: `dist`(빌드 결과) + `bin`(CLI)만 포함. 소스(`src`, `build.js`)는 제외됩니다.
+
+```bash
+# 1. npm 로그인 (최초 1회)
+npm login
+
+# 2. 패키지명 중복 확인 (chroma-ux가 이미 있으면 다른 이름 사용)
+npm search chroma-ux
+
+# 3. package.json의 repository.url을 본인 GitHub으로 수정
+
+# 4. 배포
+npm publish
+```
+
+배포 시 `prepublishOnly`가 자동으로 `npm run build`를 실행해 `dist`를 생성합니다.
+
+---
+
+## 라이선스
+
+MIT

package/bin/cli.cjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+
+const { recommendTokensDual, recommendTokensDualAsJson } = require("../dist/cjs/index.cjs");
+
+const args = process.argv.slice(2);
+const hexArg = args.find((a) => /^#?[0-9A-Fa-f]{6}$/.test(a.replace("#", "")));
+const primaryHex = hexArg ? ("#" + hexArg.replace(/^#/, "")) : null;
+
+if (!primaryHex) {
+  console.error(`
+chroma-ux — Primary 색상으로 라이트/다크 토큰 생성
+
+사용법:
+  npx chroma-ux <primary-hex>
+
+예시:
+  npx chroma-ux 5B5FF5
+  npx chroma-ux #5B5FF5
+
+옵션:
+  --json    JSON 형식으로 출력 (기본)
+  --css     CSS 변수 형식으로 출력
+`);
+  process.exit(1);
+}
+
+const format = args.includes("--css") ? "css" : "json";
+const result = recommendTokensDual({
+  primaryHex,
+  contrastTarget: "AA",
+  iterations: 3000,
+  randomSeed: 42,
+});
+
+if (format === "css") {
+  const { light, dark } = result;
+  console.log("/* Light theme */");
+  console.log(":root {");
+  Object.entries(light.tokens).forEach(([k, v]) => {
+    if (typeof v === "string" && v.startsWith("#")) {
+      console.log(`  --color-${k.replace(/([A-Z])/g, "-$1").toLowerCase()}: ${v};`);
+    }
+  });
+  console.log("}\n");
+  console.log("/* Dark theme */");
+  console.log('[data-theme="dark"] {');
+  Object.entries(dark.tokens).forEach(([k, v]) => {
+    if (typeof v === "string" && v.startsWith("#")) {
+      console.log(`  --color-${k.replace(/([A-Z])/g, "-$1").toLowerCase()}: ${v};`);
+    }
+  });
+  console.log("}");
+} else {
+  console.log(recommendTokensDualAsJson({ primaryHex, contrastTarget: "AA", randomSeed: 42 }));
+}