@cakejp/design-system 0.3.2 → 0.3.4

package/PUBLISHING.md

@@ -0,0 +1,106 @@
+# 公開とタグ付け（人向けクイックガイド）
+
+@cakejp/design-system を npm に公開する方法と、Git タグの仕組みについて。
+
+詳しい運用ルール（曜日・週次フロー等）は [`RELEASE.md`](./RELEASE.md) を参照。
+
+---
+
+## 結論 — やること
+
+1. **main に変更をマージ**（PR 経由）
+2. **`package.json` の `version` を上げる**（例: `0.3.3` → `0.3.4`）
+3. **`gh workflow run publish.yml -f dry_run=false`** を実行
+   → 自動で npm publish + Git タグ作成（`v0.3.4`）まで一気にやる
+
+タグは **手動で打たない**。Action が自動で作る。
+
+---
+
+## アクション（GitHub Actions）の実行方法
+
+### A. GitHub の Web UI からポチる
+
+1. https://github.com/flashpark/cake-design-system にアクセス
+2. 上の「**Actions**」タブをクリック
+3. 左サイドバーの「**Publish to npm**」を選択
+4. 右上の「**Run workflow**」ボタン
+5. ダイアログで `Branch: main` のまま、`Dry run` のチェックは外す
+6. 緑の「**Run workflow**」を押す
+
+### B. ターミナルから一発
+
+```bash
+# 念のため事前確認（npm publish --dry-run のみ実行、本番に影響なし）
+gh workflow run publish.yml -f dry_run=true
+
+# 本番 publish + タグ作成
+gh workflow run publish.yml -f dry_run=false
+```
+
+---
+
+## タグ付けはどうなってる？
+
+### 自動
+
+`gh workflow run publish.yml` 実行時に **デフォルトで Git タグ `v{version}` が自動作成・push** される。
+
+- `package.json` の `version: 0.3.4` で実行 → `v0.3.4` タグが main にぶら下がる
+- 既にタグ存在する場合は skip（重複エラーにならない）
+
+### 手動で打ちたいケース
+
+通常は不要。やるなら：
+
+```bash
+git tag v0.3.4
+git push origin v0.3.4
+```
+
+### タグを作らずに publish したい
+
+`tag_after_publish: false` を指定:
+
+```bash
+gh workflow run publish.yml -f dry_run=false -f tag_after_publish=false
+```
+
+---
+
+## 何が公開されたか確認
+
+```bash
+# npm に反映されたか
+npm view @cakejp/design-system version
+# → 例: 0.3.4
+
+# 全 version 一覧
+npm view @cakejp/design-system versions
+
+# タグ一覧
+git fetch --tags origin
+git tag --list | sort -V
+```
+
+公開直後は npm のキャッシュ反映に **30〜90 秒**かかる。
+
+---
+
+## トラブルシュート
+
+| 症状 | 確認 |
+|------|------|
+| Action 実行できない | Settings > Actions > Workflow permissions が `Read and write` か |
+| publish が失敗する | NPM_TOKEN が有効期限切れの可能性 |
+| タグが作られない | Workflow ログで「Create release tag」step を確認 |
+| 「金曜にやるな」と怒られる | [`RELEASE.md`](./RELEASE.md) の Read-Only Friday ルール参照 |
+
+---
+
+## 関連ドキュメント
+
+- [`RELEASE.md`](./RELEASE.md) — 詳細運用ルール（曜日・チェックリスト・緊急 hotfix 等）
+- [`CHANGELOG.md`](./CHANGELOG.md) — 各バージョンの変更履歴
+- [`MIGRATION.md`](./MIGRATION.md) — メジャーバージョンの移行手順
+- [`.github/workflows/publish.yml`](./.github/workflows/publish.yml) — Workflow 定義

package/README.md

@@ -36,9 +36,28 @@ import "@cakejp/design-system/dist/index.css"
 - [Storybook](https://flashpark.github.io/cake-design-system/) — 全コンポーネントのカタログ
 - [CHANGELOG.md](./CHANGELOG.md) — リリース履歴
 - [MIGRATION.md](./MIGRATION.md) — バージョン間移行ガイド
-- [RELEASE.md](./RELEASE.md) — リリース運用ルール（週1手動）
+- [PUBLISHING.md](./PUBLISHING.md) — 公開とタグ付けのクイックガイド（人向け）
+- [RELEASE.md](./RELEASE.md) — リリース運用ルール（週1手動・詳細）
 - [CLAUDE.md](./CLAUDE.md) — AI エージェント向け使用ルール
 
+## 公開とタグ付け（メンテナ向け）
+
+このパッケージの新バージョンを npm に公開する方法:
+
+1. **main に変更をマージ**（PR 経由）
+2. **`package.json` の `version` を上げる**（例: `0.3.3` → `0.3.4`）
+3. **GitHub Actions を実行**:
+   - Web UI: Actions タブ > 「Publish to npm」 > 「Run workflow」
+   - またはターミナル: `gh workflow run publish.yml -f dry_run=false`
+4. Workflow が以下を自動でやる:
+   - `npm publish`
+   - **Git タグ `v{version}` の作成と push**
+
+**タグは手動で打たない**（Action が自動で作成）。
+手動で `git tag` を作る必要はありません。
+
+詳細は [PUBLISHING.md](./PUBLISHING.md) と [RELEASE.md](./RELEASE.md) を参照。
+
 ## バージョン移行
 
 ### v0.2.x → v0.3.0

package/dist/index.js

@@ -3691,7 +3691,7 @@ function fe({
       f,
       {
         className: s(
-          "min-w-0 truncate text-[var(--Text-High-Emphasis)]",
+          "text-[var(--Text-High-Emphasis)]",
           wr[h]
         ),
         children: t

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cakejp/design-system",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "type": "module",
   "description": "Cake.jp Design System — UI コンポーネント・カラートークン・タイポグラフィ",
   "license": "UNLICENSED",
@@ -36,6 +36,7 @@
     "CLAUDE.md",
     "CLAUDE_PRODUCTION.md",
     "MIGRATION.md",
+    "PUBLISHING.md",
     "RELEASE.md",
     "bin",
     "component-registry.json",