{"_id":"@akiy2009/token-forge","name":"@akiy2009/token-forge","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.3":{"name":"@akiy2009/token-forge","version":"1.0.3","description":"Design-token-first color utilities + robust CLI. Normalize tokens, generate scales, support alpha blending and PostCSS plugin. CLI: adt-optimize.","main":"dist/cjs/index.cjs.js","module":"dist/esm/index.esm.js","types":"dist/types/index.d.ts","bin":{"adt-optimize":"dist/bin/adt-optimize.cjs"},"scripts":{"clean":"rm -rf dist","build":"rollup -c","prepare":"npm run build","test":"node dist/test/example.cjs.js || node dist/test/example.esm.js","lint":"echo \"no lint configured\""},"keywords":["design-tokens","postcss","contrast","accessibility","color","cli"],"author":{"name":"akiy2009"},"license":"Apache License 2.0","dependencies":{"postcss":"^8 || ^9","postcss-value-parser":"^4.2.0"},"devDependencies":{"@rollup/plugin-commonjs":"^26.0.0","@rollup/plugin-node-resolve":"^15.0.0","@rollup/plugin-terser":"^0.4.4","@rollup/plugin-typescript":"^10.0.0","rollup":"^3.0.0","typescript":"^5.0.0"},"peerDependencies":{"postcss":"^8 || ^9"},"exports":{".":"./dist/esm/index.esm.js","./postcss":"./dist/esm/postcss-plugin.esm.js"},"_id":"@akiy2009/token-forge@1.0.3","gitHead":"39e47c40d9cd3d212982e644948941538011c4e4","_nodeVersion":"22.14.0","_npmVersion":"11.2.0","dist":{"integrity":"sha512-cLuDVVbkDg2nqVv8Ng2IykWIwZwS4t5nKrf8um+/3uu45hipqWCUhsD69AB1T7/6v22OiwY4rBg5rFpRyb3Khw==","shasum":"0e685fe157be4178f1f18b6f1148e09017a8d03f","tarball":"https://registry.npmjs.org/@akiy2009/token-forge/-/token-forge-1.0.3.tgz","fileCount":22,"unpackedSize":899959,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCHh/Deh3V53SUwGEAUfMLA6k7zGByO1AfkmbU8y/SnZAIhALv4ni2+PpQEwuN8N5n/lCfcqLnabiPLkT0RnPMSOxl6"}]},"_npmUser":{"name":"akiy2009","email":"y.akitaka2009@icloud.com"},"directories":{},"maintainers":[{"name":"akiy2009","email":"y.akitaka2009@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/token-forge_1.0.3_1773330756458_0.3981971767164354"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-12T15:52:36.347Z","1.0.3":"2026-03-12T15:52:36.690Z","modified":"2026-03-12T15:52:36.917Z"},"maintainers":[{"name":"akiy2009","email":"y.akitaka2009@icloud.com"}],"description":"Design-token-first color utilities + robust CLI. Normalize tokens, generate scales, support alpha blending and PostCSS plugin. CLI: adt-optimize.","keywords":["design-tokens","postcss","contrast","accessibility","color","cli"],"author":{"name":"akiy2009"},"license":"Apache License 2.0","readme":"# Token Forge\r\n_デザイントークン自動最適化ツール_ \r\n\r\n\r\n### **パッケージ名:** `@akiy2009/token-forge`\r\n---\r\n\r\n## ✨ 概要\r\n\r\n**Token Forge** は、デザイントークンを自動で最適化し、  \r\n背景色に合わせたコントラスト調整・色相/明度/彩度の微調整により、  \r\n一貫性がありアクセシブルな UI カラーを生成する軽量ツールです。\r\n\r\n以下のユースケースに最適です：\r\n\r\n- デザインシステムの色を自動で WCAG 対応させたい  \r\n- CSS 変数（`--color-primary` など）をバラつきなく整えたい  \r\n- JSON トークンを自動で正規化 → 最適化したい  \r\n- PostCSS と組み合わせてビルド時に自動修正したい\r\n\r\nCLI と PostCSS プラグインのどちらでも利用できます。\r\n\r\n---\r\n\r\n## 🚀 特徴\r\n\r\n- 🎨 **背景色に合わせた自動コントラスト調整（WCAG AA / AAA 対応）**\r\n- 🔧 **色相・明度・彩度（HSL）のバランス補正**\r\n- 🏷️ JSON / CSS トークンを自動で正規化\r\n- 🗂️ CSS 変数・JSON の両方にフル対応\r\n- ⚡ 使いやすい CLI ツール  \r\n- 🧩 PostCSS プラグインとしても動作\r\n- 📦 ランタイム依存ほぼゼロの軽量設計\r\n\r\n---\r\n\r\n## 📦 インストール\r\n\r\nnpm からインストール：\r\n\r\n```sh\r\nnpm install @akiy2009/token-forge\r\n```\r\nnpx で即実行：\r\n\r\n```sh\r\nnpx adt-optimize --help\r\n```\r\n\r\n## 🛠 使い方（CLI）\r\n🔹 基本\r\n```sh\r\nadt-optimize --input tokens.json --output tokens.fixed.json\r\n```\r\n\r\n🔹 CSS 変数の場合\r\n```sh\r\nadt-optimize --input styles.css --output styles.fixed.css --format css\r\n```\r\n\r\n## ⚙ オプション一覧\r\n| オプション                  | 説明                 |                |\r\n| ---------------------- | ------------------ | -------------- |\r\n| `--input <file>`       | 入力ファイル（CSS / JSON） |                |\r\n| `--output <file>`      | 出力先ファイル            |                |\r\n| `--format css          | json`              | 出力形式を強制指定      |\r\n| `--target-contrast 4.5 | 7.0`               | WCAG の目標コントラスト |\r\n| `--preset wcag-aa      | wcag-aaa`          | アクセシビリティプリセット  |\r\n| `--colors-only`        | カラー系トークンのみ処理       |                |\r\n| `--dry-run`            | 出力ファイルを作らず標準出力へ    |                |\r\n\r\n## PostCSS プラグインとして使用\r\n\r\npostcss.config.js に追加：\r\n```sh\r\nmodule.exports = {\r\n  plugins: [\r\n    require(\"@gakuseibot/auto-design-tokens-optimizer/postcss\")({\r\n      targetContrast: 4.5,\r\n      adjustHue: true,\r\n      adjustSaturation: true\r\n    })\r\n  ]\r\n};\r\n```\r\n## 🗂 JSON トークン例\r\n入力: tokens.json\r\n```sh\r\n{\r\n  \"primary\": \"#4c8cff\",\r\n  \"background\": \"#ffffff\",\r\n  \"success\": \"#28c76f\"\r\n}\r\n```\r\n\r\n出力: tokens.fixed.json\r\n```sh\r\n{\r\n  \"primary\": \"#2d6fe8\",\r\n  \"background\": \"#ffffff\",\r\n  \"success\": \"#219c58\"\r\n}\r\n```\r\n※ 値は例示であり正確ではありません。\r\n\r\n## 📁 プロジェクト構成\r\n```sh\r\nsrc/\r\n  color.ts\r\n  tokens.ts\r\n  optimizer.ts\r\n  cli-core.ts\r\n  postcss-plugin.ts\r\n  utils.ts\r\nbin/\r\n  adt-optimize.js\r\n```\r\n## 📄 ライセンス\r\nこのプロジェクトは Apache License 2.0 の下で公開されています。\r\n\r\n## 📬 連絡先\r\n改善案・バグ報告・Pull Request などはお気軽にどうぞ。  \r\nEmail: akiy2009_dev@outlook.jp  \r\nDiscord: @aki._.yama  \r\n\r\n## ⭐ サポート\r\n良いと思ったら GitHub リポジトリにスターをお願いします！\r\n開発継続の大きな励みになります。\r\n","readmeFilename":"README.md","_rev":"1-f9f13c517c9a17f13b660dd4427d9760"}