ksk-design-system 2.1.1 → 2.3.0

package/AGENTS.md

@@ -56,6 +56,16 @@ UI を書く前に必ず確認すること:
 
 ---
 
+## DS公開通知
+
+DSへ依頼するときは、DSの通常issueとappの取り込み待ち通常issueを作成する。DS正本の作業ブランチで `node bin/init.js register-consumer-request --ds-issue N --consumer-issue URL` を実行し、台帳変更をPRに含める。未公開CLIで古いnpm版を起動しないようsourceのコマンドを使う。公開済みCLIでは `npx ksk-ds register-consumer-request` も同じ引数で使える。
+
+登録CLIは既存のgh認証で両issueを確認し、app issueへ `ds:waiting` を自動付与する。closedまたは `ds:released` のissueは降格させない。修正PR作成後は同じコマンドに `--fix-pr N` を付けて紐付ける。省略時は既存fixPrを維持し、累積台帳を削除しない。`--dry-run` は通信・書き込みなしのローカルプレビューで、issue実在や権限は確認しない。失敗は非zero。台帳保存後のラベル失敗は同じコマンドで再試行する。
+
+公開通知はDSの一括bump（`scripts/update-consumers.sh VERSION`）時だけ実行する。公開版に修正が含まれることを確認し、bump PR付きの通知と `ds:released` を付ける。6時間pollingとapp側workflow/scriptは廃止し、`init-release-notices` は移行案内を出して停止する。app側の取り込み・動作確認が完了するまで追従issueは閉じない。詳しくは [公開通知手順](https://github.com/ekusiek716/ksk-design-system/blob/main/docs/consumer-release-notices.md) を参照。
+
+同じapp issueに複数のDS依頼がある場合、公開台帳内の該当依頼がすべて公開・通知済みになるまで `ds:waiting` を残す（`ds:released` と併存する場合あり）。通知はrepo owner本人 `ekusiek716` のPAT認証が前提。通知失敗時は既存bump PRを保持して同じversion・対象repoの一括bumpを再実行し、通知runtime単独実行・並列実行はしない。
+
 ## このDSについて
 
 **KSK Design System** は、フリーランスデザイナー / エンジニア / PdM が **複数クライアント案件を1つのDSで高速に回す** ために設計された統合デザインシステムです。

package/CLAUDE.md

@@ -163,6 +163,16 @@ afterEach フックが全ストーリー（tags フィルタなし）に対し
 
 ---
 
+## DS公開通知
+
+DSへ依頼するときは、DSの通常issueとappの取り込み待ち通常issueを作成する。DS正本の作業ブランチで `node bin/init.js register-consumer-request --ds-issue N --consumer-issue URL` を実行し、台帳変更をPRに含める。未公開CLIで古いnpm版を起動しないようsourceのコマンドを使う。公開済みCLIでは `npx ksk-ds register-consumer-request` も同じ引数で使える。
+
+登録CLIは既存のgh認証で両issueを確認し、app issueへ `ds:waiting` を自動付与する。closedまたは `ds:released` のissueは降格させない。修正PR作成後は同じコマンドに `--fix-pr N` を付けて紐付ける。省略時は既存fixPrを維持し、累積台帳を削除しない。`--dry-run` は通信・書き込みなしのローカルプレビューで、issue実在や権限は確認しない。失敗は非zero。台帳保存後のラベル失敗は同じコマンドで再試行する。
+
+公開通知はDSの一括bump（`scripts/update-consumers.sh VERSION`）時だけ実行する。公開版に修正が含まれることを確認し、bump PR付きの通知と `ds:released` を付ける。6時間pollingとapp側workflow/scriptは廃止し、`init-release-notices` は移行案内を出して停止する。app側の取り込み・動作確認が完了するまで追従issueは閉じない。詳しくは [公開通知手順](https://github.com/ekusiek716/ksk-design-system/blob/main/docs/consumer-release-notices.md) を参照。
+
+同じapp issueに複数のDS依頼がある場合、公開台帳内の該当依頼がすべて公開・通知済みになるまで `ds:waiting` を残す（`ds:released` と併存する場合あり）。通知はrepo owner本人 `ekusiek716` のPAT認証が前提。通知失敗時は既存bump PRを保持して同じversion・対象repoの一括bumpを再実行し、通知runtime単独実行・並列実行はしない。
+
 ## このDSについて
 
 **KSK Design System** は、フリーランスデザイナー / エンジニア / PdM が **複数クライアント案件を1つのDSで高速に回す** ために設計された統合デザインシステムです。

package/DESIGN.md

@@ -12,18 +12,18 @@ colors:
   onPrimary: "#FFFFFF"
   # --- Neutral scale ---
   neutral0: "#FFFFFF"
-  neutral50: "#F9FAFB"
-  neutral100: "#F3F4F6"
-  neutral200: "#E5E7EB"
-  neutral500: "#6B7280"
-  neutral900: "#111827"
+  neutral50: "#FAFAFA"
+  neutral100: "#F4F4F5"
+  neutral200: "#E4E4E7"
+  neutral500: "#71717A"
+  neutral900: "#18181B"
   # --- Surface / Text / Border（semantic） ---
   surface: "#FFFFFF"          # var(--Surface-Primary)
-  surfaceMuted: "#F9FAFB"     # var(--Surface-Secondary)
-  textHigh: "#111827"         # var(--Text-High-Emphasis)
-  textMedium: "#374151"       # var(--Text-Medium-Emphasis)
-  textLow: "#4B5563"          # var(--Text-Low-Emphasis)
-  border: "#E5E7EB"           # var(--Border-Low-Emphasis)
+  surfaceMuted: "#FAFAFA"     # var(--Surface-Secondary)
+  textHigh: "#18181B"         # var(--Text-High-Emphasis)
+  textMedium: "#3F3F46"       # var(--Text-Medium-Emphasis)
+  textLow: "#52525B"          # var(--Text-Low-Emphasis)
+  border: "#E4E4E7"           # var(--Border-Low-Emphasis)
   focus: "#60A5FA"            # var(--Focus-High-Emphasis)
   # --- Semantic（status） ---
   success: "#15803D"
@@ -39,7 +39,7 @@ typography:
   caption:  { fontSize: "11px", lineHeight: "1.5",  fontWeight: 400 }   # typo-caption（注釈/法的表記専用。本文の下限は body=12px。10px の typo-body-xs は補助ラベル専用で本文禁止）
 rounded:
   sm: "4px"
-  surface: "8px"   # Card / Input / Popover  → var(--Radius-Surface)
+  surface: "14px"  # Card / Input / Popover  → var(--Radius-Surface)
   modal: "24px"    # 中央 Dialog / AlertDialog → var(--Radius-Modal)
   sheet: "32px"    # bottom / float Sheet     → var(--Radius-Sheet)
   full: "9999px"   # Button / Chip
@@ -50,8 +50,8 @@ spacing:
 elevation:                                          # 影色は neutral（Gray-900 ベース rgba(17,24,39,…)）でテーマ非依存
   sm: "0 1px 2px 0 rgba(0, 0, 0, 0.05)"
   md: "0 0 8px rgba(20, 20, 20, 0.08)"
-  lg: "0px 12px 32px -4px rgba(17, 24, 39, 0.12), 0px 8px 16px -6px rgba(17, 24, 39, 0.12)"
-  dialog: "0px 12px 32px -4px rgba(17, 24, 39, 0.12), 0px 8px 16px -6px rgba(17, 24, 39, 0.12), 0px 1px 4px 1px rgba(0, 0, 0, 0.2)"
+  lg: "0px 12px 32px -4px rgba(24, 24, 27, 0.12), 0px 8px 16px -6px rgba(24, 24, 27, 0.12)"
+  dialog: "0px 12px 32px -4px rgba(24, 24, 27, 0.12), 0px 8px 16px -6px rgba(24, 24, 27, 0.12), 0px 1px 4px 1px rgba(0, 0, 0, 0.2)"
 motion:                                            # 実体は var(--Motion-*)（src/styles/motion.css）
   microIn: "150ms ease-out"                        # --Motion-Duration-Fast  / fade-in / scale-in
   enter: "200ms ease-out"                          # --Motion-Duration-Base  / fade-in-up / slide-in
@@ -135,9 +135,9 @@ KSK の必須正本・publish 依存にせず、KSK 固有の multi-theme / nati
 | 用途 | トークン | 既定値(Blue) |
 |---|---|---|
 | ブランド | `var(--Brand-Primary)` | `#2563EB` |
-| 背景(白/薄灰) | `var(--Surface-Primary)` / `-Secondary` | `#FFFFFF` / `#F9FAFB` |
-| 文字(強/中/弱) | `var(--Text-High/Medium/Low-Emphasis)` <!-- docs-drift-ignore: --Text-High/Medium/Low-Emphasis --> | `#111827` / `#374151` / `#4B5563` |
-| 罫線 | `var(--Border-Low-Emphasis)` | `#E5E7EB` |
+| 背景(白/薄灰) | `var(--Surface-Primary)` / `-Secondary` | `#FFFFFF` / `#FAFAFA` |
+| 文字(強/中/弱) | `var(--Text-High/Medium/Low-Emphasis)` <!-- docs-drift-ignore: --Text-High/Medium/Low-Emphasis --> | `#18181B` / `#3F3F46` / `#52525B` |
+| 罫線 | `var(--Border-Low-Emphasis)` | `#E4E4E7` |
 | 状態 | `--Success/Warning/Caution/Info-Base` <!-- docs-drift-ignore: --Success/Warning/Caution/Info-Base --> | `#15803D` / `#C2410C` / `#DC2626` / `#2563EB` |
 
 - **状態色の正本**: 上記は `*-Base`。Caution/Info は Primitive **600**、Success/Warning は白文字 AA(4.5:1) 確保のため Primitive **700**（600 だと 3.3〜3.6:1）。`tokens.json` を正本とし、本表はその要約。

package/NATIVE_RECIPES.md

@@ -182,6 +182,8 @@ import { Button, PhotoHero, Screen } from "ksk-design-system/native/ui"
 
 Web では `CompactFilePicker` / `ImageAttachmentPicker` が hidden file input、trigger、preview、remove affordance を持ちます。Native では DocumentPicker / ImagePicker の起動だけ consumer が渡し、trigger と preview は DS が持ちます。
 
+`loadingLabel`（loading 中にボタンへ表示する文言）は web の既定が `"処理中"` なのに対し、native には既定値が無く、未指定時は native Button の spinner のみが表示されます（issue #539。web/native で意図的に非対称）。
+
 ```tsx
 <ImageAttachmentPicker
   multiple

package/PUBLISHING.md

@@ -244,6 +244,16 @@ publish.yml が失敗・スタックした場合の実行可能な手順は次
 それでも解消しない場合は、npm 側の障害か Trusted Publishing 設定（npmjs.com の
 Trusted Publisher 登録）を疑い、対応後に再度 workflow_dispatch で実行する。
 
+## 依頼元appへの公開通知
+
+DSへ依頼するときは、DSの通常issueとappの取り込み待ち通常issueを作成する。DS正本の作業ブランチで `node bin/init.js register-consumer-request --ds-issue N --consumer-issue URL` を実行し、台帳変更をPRに含める。未公開CLIで古いnpm版を起動しないようsourceのコマンドを使う。公開済みCLIでは `npx ksk-ds register-consumer-request` も同じ引数で使える。
+
+登録CLIは既存のgh認証で両issueを確認し、app issueへ `ds:waiting` を自動付与する。closedまたは `ds:released` のissueは降格させない。修正PR作成後は同じコマンドに `--fix-pr N` を付けて紐付ける。省略時は既存fixPrを維持し、累積台帳を削除しない。`--dry-run` は通信・書き込みなしのローカルプレビューで、issue実在や権限は確認しない。失敗は非zero。台帳保存後のラベル失敗は同じコマンドで再試行する。
+
+公開通知はDSの一括bump（`scripts/update-consumers.sh VERSION`）時だけ実行する。公開版に修正が含まれることを確認し、bump PR付きの通知と `ds:released` を付ける。6時間pollingとapp側workflow/scriptは廃止し、`init-release-notices` は移行案内を出して停止する。app側の取り込み・動作確認が完了するまで追従issueは閉じない。詳しくは [公開通知手順](https://github.com/ekusiek716/ksk-design-system/blob/main/docs/consumer-release-notices.md) を参照。
+
+同じapp issueに複数のDS依頼がある場合、公開台帳内の該当依頼がすべて公開・通知済みになるまで `ds:waiting` を残す（`ds:released` と併存する場合あり）。通知はrepo owner本人 `ekusiek716` のPAT認証が前提。通知失敗時は既存bump PRを保持して同じversion・対象repoの一括bumpを再実行し、通知runtime単独実行・並列実行はしない。
+
 ## 関連
 
 - [UPDATING.md](./UPDATING.md) — 消費側（DS を npm 依存に持つプロジェクト）向けのアップデート手順

package/README.md

@@ -76,14 +76,17 @@ DS のルールが適用されません。既存ファイルはスキップさ
 > として Critical 判定されるためです（LPM Firewall が 1.49.2 / 1.51.1 をこの理由でブロック判定）。
 > v1.59.0 以前から更新する場合、既に設置済みのファイルはそのまま使えます。
 
+<!-- consumer-example:css:start -->
 ```css
-/* globals.css / app.css（CSS の場所に応じて ../../ の数を調整） */
+/* src/styles/app.css（アプリのルートで一度だけ読み込む） */
 @import "tailwindcss";
 @import "ksk-design-system/preset";
 @import "ksk-design-system/themes/default";
-@import "./themes/my-client.css"; /* Brand 色を差し替えたテーマ */
 @source "../../node_modules/ksk-design-system/dist";
 ```
+<!-- consumer-example:css:end -->
+
+独自ブランドのテーマを使う場合は、この後にテーマCSSをimportしてください。
 
 Tailwind CSS v4 は `node_modules` を既定では走査しません。`@source` がないと、
 DS 内部だけで使うレイアウト・サイズ・状態クラスが生成されず、コンポーネントの表示や操作が崩れます。
@@ -94,9 +97,23 @@ consumer 側の Tailwind と DS を同じビルドで処理するため、上記
 DS のクラス CSS は生成されます（issue #258）。ただし consumer 自身のコードは
 consumer 側の走査対象なので、`@source` は引き続き推奨構成です。
 
+<!-- consumer-example:tsx:start -->
 ```tsx
-import { Button, Card, Input, FormField } from "ksk-design-system"
+import { Button, Input, Label } from "ksk-design-system"
+
+export function Example() {
+  return (
+    <form>
+      <Label htmlFor="company">会社名</Label>
+      <Input id="company" name="company" defaultValue="サンプル株式会社" />
+      <Button type="submit">保存</Button>
+    </form>
+  )
+}
 ```
+<!-- consumer-example:tsx:end -->
+
+DSリポジトリの開発者向け検査として、`npm run test:consumer:web` は、配布READMEの上記例を空consumerで型検査・CSSビルドし、Node SSRからChromiumへのhydrationと操作を検査します。初回は `npx playwright install chromium` が必要です。
 
 新規クライアント案件では、テーマファイルで `--Primitive-Brand-500` などブランドカラーの 10 行を定義するだけで、全コンポーネントがそのブランドカラーで動作します。
 
@@ -474,6 +491,16 @@ npm run metrics -- --range last-year
 
 > npm は匿名集計のため、CI やミラーの重複を含む **install 回数の目安** です（ユニークユーザー数ではありません）。
 
+## DS公開通知
+
+DSへ依頼するときは、DSの通常issueとappの取り込み待ち通常issueを作成する。DS正本の作業ブランチで `node bin/init.js register-consumer-request --ds-issue N --consumer-issue URL` を実行し、台帳変更をPRに含める。未公開CLIで古いnpm版を起動しないようsourceのコマンドを使う。公開済みCLIでは `npx ksk-ds register-consumer-request` も同じ引数で使える。
+
+登録CLIは既存のgh認証で両issueを確認し、app issueへ `ds:waiting` を自動付与する。closedまたは `ds:released` のissueは降格させない。修正PR作成後は同じコマンドに `--fix-pr N` を付けて紐付ける。省略時は既存fixPrを維持し、累積台帳を削除しない。`--dry-run` は通信・書き込みなしのローカルプレビューで、issue実在や権限は確認しない。失敗は非zero。台帳保存後のラベル失敗は同じコマンドで再試行する。
+
+公開通知はDSの一括bump（`scripts/update-consumers.sh VERSION`）時だけ実行する。公開版に修正が含まれることを確認し、bump PR付きの通知と `ds:released` を付ける。6時間pollingとapp側workflow/scriptは廃止し、`init-release-notices` は移行案内を出して停止する。app側の取り込み・動作確認が完了するまで追従issueは閉じない。詳しくは [公開通知手順](https://github.com/ekusiek716/ksk-design-system/blob/main/docs/consumer-release-notices.md) を参照。
+
+同じapp issueに複数のDS依頼がある場合、公開台帳内の該当依頼がすべて公開・通知済みになるまで `ds:waiting` を残す（`ds:released` と併存する場合あり）。通知はrepo owner本人 `ekusiek716` のPAT認証が前提。通知失敗時は既存bump PRを保持して同じversion・対象repoの一括bumpを再実行し、通知runtime単独実行・並列実行はしない。
+
 ## 📄 ライセンス
 
 [MIT](./LICENSE) © 奥野圭祐 (Keisuke Okuno)

package/RELEASE.md

@@ -74,6 +74,10 @@ GitHub Release の作成をスキップしてしまう。そのため:
 ローカルから `npm publish` を直接叩く経路は廃止した（publish.yml への一本化。
 下記参照）。
 
+## 未公開の修正
+
+- [#529](https://github.com/ekusiek716/ksk-design-system/issues/529): native Dialog のダークモードで、中央・上寄せの確認面が背景と同化する問題を修正。パネルに `surface.secondary` を使い、余白と角丸を見分けられるようにする。light・fullscreen の背景、寸法、safe-area は維持。公開後に利用アプリへ取り込み、実機で確認する。
+
 ## ホットフィックス履歴
 
 | 日付 | バージョン | 内容 | 影響 |

package/bin/consumer-release-notices.js

@@ -0,0 +1,138 @@
+import { existsSync, lstatSync, readFileSync, writeFileSync } from "node:fs"
+import { join, relative, resolve } from "node:path"
+import { spawnSync } from "node:child_process"
+import { parseConsumerIssue, validateContract } from "../templates/consumer-release-notices/check-ds-release.mjs"
+
+function positiveInt(value, name) {
+  if (!/^[1-9]\d*$/.test(String(value)) || !Number.isSafeInteger(Number(value))) {
+    throw new Error(`${name} must be a positive safe integer`)
+  }
+  return Number(value)
+}
+
+function issueUrl(value) {
+  if (typeof value !== "string" || /\s/.test(value)) throw new Error("consumer-issue must be a GitHub issue URL without whitespace")
+  const canonical = value.toLowerCase()
+  parseConsumerIssue(canonical)
+  return canonical
+}
+
+function statOrNull(path) {
+  try { return lstatSync(path) } catch (error) {
+    if (error.code === "ENOENT") return null
+    throw error
+  }
+}
+
+function safePath(root, path) {
+  let current = root
+  const parts = relative(root, path).split(/[\\/]/)
+  for (const [index, part] of parts.entries()) {
+    current = join(current, part)
+    const stat = statOrNull(current)
+    if (stat?.isSymbolicLink()) throw new Error(`Symlink is not allowed: ${current}`)
+    if (stat && index < parts.length - 1 && !stat.isDirectory()) throw new Error(`Not a directory: ${current}`)
+  }
+}
+
+export function validateConsumerRequests(registry) {
+  validateContract(registry)
+  for (const request of registry.requests) issueUrl(request.consumerIssue)
+  return registry
+}
+
+function github(runGh) {
+  return (endpoint, method = "GET", fields = {}, paginate = false) => {
+    const args = ["api", "--hostname", "github.com", endpoint, "--method", method]
+    if (paginate) args.push("--paginate", "--slurp")
+    for (const [key, value] of Object.entries(fields)) args.push("-f", `${key}=${value}`)
+    const result = runGh("gh", args, { encoding: "utf8", timeout: 30000, maxBuffer: 8 * 1024 * 1024 })
+    // Do not echo gh stderr: it may include credentials or private response details.
+    if (result.error || result.status !== 0) throw new Error(`GitHub ${method} failed: ${endpoint}. Check gh authentication/permissions and retry the same command.`)
+    try { return JSON.parse(result.stdout) } catch { throw new Error(`Invalid GitHub response: ${endpoint}`) }
+  }
+}
+
+function readIssue(api, repo, number) {
+  const issue = api(`repos/${repo}/issues/${number}`)
+  if (!issue || issue.pull_request || issue.number !== number ||
+      typeof issue.html_url !== "string" || issueUrl(issue.html_url) !== `https://github.com/${repo}/issues/${number}` ||
+      !["open", "closed"].includes(issue.state)) throw new Error(`Expected a regular issue: ${repo}#${number}`)
+  return issue
+}
+
+function ensureWaiting(api, repo, number) {
+  // Re-read after writing the registry so a retry cannot downgrade released/closed work.
+  const issue = readIssue(api, repo, number)
+  if (issue.state === "closed") return
+  const pages = api(`repos/${repo}/issues/${number}/labels?per_page=100`, "GET", {}, true)
+  if (!Array.isArray(pages) || pages.some((page) => !Array.isArray(page))) throw new Error("Invalid issue label response")
+  const labels = pages.flat()
+  if (labels.some((label) => typeof label?.name !== "string")) throw new Error("Invalid issue label response")
+  if (labels.some((label) => ["ds:released", "ds:waiting"].includes(label.name.toLowerCase()))) return
+  const endpoint = `repos/${repo}/labels/ds%3Awaiting`
+  try { api(endpoint) } catch {
+    try { api(`repos/${repo}/labels`, "POST", { name: "ds:waiting", color: "fbca04", description: "DS修正版の公開待ち" }) }
+    catch { api(endpoint) } // Another registration may have created the label concurrently.
+  }
+  api(`repos/${repo}/issues/${number}/labels`, "POST", { "labels[]": "ds:waiting" })
+  console.log(`Ensured ds:waiting on ${repo}#${number}`)
+}
+
+function register(args, cwd, runGh) {
+  const options = new Map()
+  for (let i = 0; i < args.length; i++) {
+    const key = args[i]
+    if (!["--ds-issue", "--consumer-issue", "--fix-pr", "--dry-run"].includes(key) || options.has(key)) throw new Error(`Unknown or duplicate option: ${key}`)
+    if (key === "--dry-run") options.set(key, true)
+    else {
+      const value = args[++i]
+      if (!value || value.startsWith("--")) throw new Error(`Missing value: ${key}`)
+      options.set(key, value)
+    }
+  }
+  const dsIssue = positiveInt(options.get("--ds-issue"), "ds-issue")
+  const consumerIssue = issueUrl(options.get("--consumer-issue"))
+  const fixPr = options.has("--fix-pr") ? positiveInt(options.get("--fix-pr"), "fix-pr") : undefined
+  const packagePath = join(cwd, "package.json")
+  const contracts = join(cwd, "contracts")
+  safePath(cwd, packagePath)
+  safePath(cwd, contracts)
+  if (!existsSync(join(cwd, ".git")) || !statOrNull(contracts)?.isDirectory() ||
+      !existsSync(packagePath) || JSON.parse(readFileSync(packagePath, "utf8")).name !== "ksk-design-system") {
+    throw new Error("Run registration at the DS source repo root (ksk-design-system + .git + contracts/), never in a consumer")
+  }
+  const path = join(contracts, "consumer-requests.json")
+  safePath(cwd, path)
+  const before = existsSync(path) ? readFileSync(path, "utf8") : null
+  const registry = before === null ? { schemaVersion: 1, requests: [] } : JSON.parse(before)
+  validateConsumerRequests(registry)
+  const existing = registry.requests.find((request) => request.dsIssue === dsIssue && issueUrl(request.consumerIssue) === consumerIssue)
+  if (existing) {
+    existing.consumerIssue = consumerIssue
+    if (fixPr !== undefined) existing.fixPr = fixPr
+  } else registry.requests.push({ dsIssue, consumerIssue, fixPr: fixPr ?? null })
+  const after = JSON.stringify(registry, null, 2) + "\n"
+  if (options.has("--dry-run")) { console.log(after.trimEnd()); return }
+  const api = github(runGh)
+  const target = parseConsumerIssue(consumerIssue)
+  readIssue(api, "ekusiek716/ksk-design-system", dsIssue)
+  readIssue(api, target.repo, target.number)
+  if (before === null || JSON.stringify(JSON.parse(before)) !== JSON.stringify(registry)) {
+    writeFileSync(path, after)
+    console.log(`Updated ${path}`)
+  } else console.log("Consumer request already registered (no-op)")
+  ensureWaiting(api, target.repo, target.number)
+}
+
+export function runConsumerReleaseNoticesCli(command, args, { cwd, runGh = spawnSync }) {
+  try {
+    if (command === "register-consumer-request") register(args, resolve(cwd), runGh)
+    else if (command === "init-release-notices") throw new Error("init-release-notices is retired: remove the consumer polling workflow/script. Release notices run only during the DS bulk bump (scripts/update-consumers.sh).")
+    else throw new Error(`Unknown command: ${command}`)
+    return 0
+  } catch (error) {
+    console.error(`[ksk-ds ${command}] ${error.message}`)
+    return 1
+  }
+}

package/bin/init.js

@@ -59,6 +59,9 @@ if (cmd === "help" || cmd === "--help" || cmd === "-h") {
 使い方:
   npx ksk-design-system init          AI ルールファイルを設置
   npx ksk-design-system init --force  既存ファイルを上書き
+  npx ksk-ds register-consumer-request --ds-issue N --consumer-issue URL [--fix-pr N] [--dry-run]
+                                     DS依頼を登録しapp issueへds:waitingを付与（gh認証使用）
+  npx ksk-ds init-release-notices     廃止済み。一括bump時の公開通知へ移行
   npx ksk-design-system demo [dir]    DS リポを clone + npm install（お試し）
                                       dir 省略時は ./ksk-ds-demo
   npx ksk-ds lint src                 DS-first ルール違反を検査
@@ -75,6 +78,11 @@ if (cmd === "help" || cmd === "--help" || cmd === "-h") {
   await exitWith(0)
 }
 
+if (cmd === "register-consumer-request" || cmd === "init-release-notices") {
+  const { runConsumerReleaseNoticesCli } = await import("./consumer-release-notices.js")
+  await exitWith(runConsumerReleaseNoticesCli(cmd, args.slice(1), { cwd: process.cwd(), pkgRoot }))
+}
+
 if (cmd === "lint") {
   const { runLintCli } = await import("./lint.js")
   const status = await runLintCli(args.slice(1), { cwd: process.cwd(), pkgRoot })

package/contracts/components.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "name": "KSK Design System — Component Contracts",
-    "version": "2.1.1",
+    "version": "2.3.0",
     "description": "全コンポーネントの構造化定義。バリアント・アクセシビリティ要件・使用ルールを機械可読形式で管理。",
     "counts": {
       "ui": 68,
@@ -1657,10 +1657,14 @@
         "compactStatus",
         "actions"
       ],
+      "props": {
+        "verticalAlignment": "\"center\" | \"top\" (既定 \"center\") — ヘッダー行の縦位置。複数行 brand で status/actions が中央へ下がるのを防ぐ。top でも status/actions 内部は中央揃えのまま（native と同仕様。issue #536）"
+      },
       "rules": [
         "ブランド/ロゴは brand slot に置く",
         "長い同期状態は status と compactStatus の両方を渡す",
-        "右側 actions のために brand に flex-shrink をかけない"
+        "右側 actions のために brand に flex-shrink をかけない",
+        "複数行になり得る brand を使うときは verticalAlignment=\"top\" を検討する（既定は上下中央）"
       ]
     },
     {
@@ -2380,9 +2384,13 @@
         "grid",
         "list"
       ],
+      "props": {
+        "loadingLabel": "ReactNode (既定 \"処理中\") — loading 時にボタンへ表示する文言。i18n対応（issue #539）。native は既定値を持たず、未指定時は native Button の spinner のみを表示する（web/native で意図的に非対称。scripts/check-native-parity.mjs の INTENTIONAL_DEFAULT_GAPS 参照）"
+      },
       "accessibility": [
         "img alt",
-        "remove button aria-label"
+        "remove button aria-label",
+        "aria-busy on trigger button while loading（テスト/自動化向けの状態フック。loading 中はボタン自体が disabled になるため、スクリーンリーダーへの読み上げ効果は限定的）"
       ],
       "rules": [
         "consumer 側で hidden input + Button trigger を重複実装しない",

package/contracts/consumer-requests.json

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "requests": [
+    {
+      "dsIssue": 531,
+      "consumerIssue": "https://github.com/ekusiek716/trip-todo/issues/168",
+      "fixPr": 532
+    }
+  ]
+}

package/contracts/token-hex-cache.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "name": "KSK Design System — Semantic Token Hex Cache",
-    "version": "2.1.1",
+    "version": "2.3.0",
     "description": "semantic / semanticDark トークン（var(--Primitive-*) 参照）を実 hex に解決したサイドカー生成物。hex はデフォルト（Blue）テーマでの解決値であり、Brand 系（meta.themeDependentKeys に列挙）はテーマ差し替え（orange/green/violet 等）で実色が変わる。テーマ別の完全解決値は `ksk-design-system/native` エクスポート（バンドル済み native トークンモジュール）の themes を参照。tokens.json 本体のスキーマは変更せず、AI がこのファイルだけで実色を把握できるようにし、primitive 値の変更による semantic 実色のドリフトを --check で機械検出する。",
     "generatedBy": "scripts/generate-token-hex-cache.mjs",
     "theme": "default",
@@ -288,10 +288,10 @@
   },
   "semantic": {
     "surface.primary": "#FFFFFF",
-    "surface.secondary": "#F9FAFB",
-    "surface.tertiary": "#F3F4F6",
-    "surface.quaternary": "#E5E7EB",
-    "surface.inverse": "#111827",
+    "surface.secondary": "#FAFAFA",
+    "surface.tertiary": "#F4F4F5",
+    "surface.quaternary": "#E4E4E7",
+    "surface.inverse": "#18181B",
     "surface.accent-primary": "#3B82F6",
     "surface.accent-primary-light": "#EFF6FF",
     "surface.caution": "#FEF2F2",
@@ -299,11 +299,11 @@
     "surface.warning": "#FFFBEB",
     "surface.info": "#EFF6FF",
     "surface.caution-strong": "#EF4444",
-    "surface.disable": "#F3F4F6",
-    "text.high-emphasis": "#111827",
-    "text.medium-emphasis": "#374151",
-    "text.low-emphasis": "#4B5563",
-    "text.disable": "#9CA3AF",
+    "surface.disable": "#F4F4F5",
+    "text.high-emphasis": "#18181B",
+    "text.medium-emphasis": "#3F3F46",
+    "text.low-emphasis": "#52525B",
+    "text.disable": "#A1A1AA",
     "text.on-inverse": "#FFFFFF",
     "text.on-media": "#FFFFFF",
     "text.accent-primary": "#2563EB",
@@ -312,10 +312,10 @@
     "text.warning": "#C2410C",
     "text.info": "#2563EB",
     "text.caution-on-inverse": "#F87171",
-    "object.high-emphasis": "#111827",
-    "object.medium-emphasis": "#4B5563",
-    "object.low-emphasis": "#9CA3AF",
-    "object.disable": "#D1D5DB",
+    "object.high-emphasis": "#18181B",
+    "object.medium-emphasis": "#52525B",
+    "object.low-emphasis": "#A1A1AA",
+    "object.disable": "#D4D4D8",
     "object.on-inverse": "#FFFFFF",
     "object.accent-primary": "#3B82F6",
     "object.caution": "#EF4444",
@@ -323,9 +323,9 @@
     "object.warning": "#F97316",
     "object.info": "#3B82F6",
     "object.rating": "#F59E0B",
-    "border.high-emphasis": "#374151",
-    "border.medium-emphasis": "#D1D5DB",
-    "border.low-emphasis": "#E5E7EB",
+    "border.high-emphasis": "#3F3F46",
+    "border.medium-emphasis": "#D4D4D8",
+    "border.low-emphasis": "#E4E4E7",
     "border.accent-primary": "#3B82F6",
     "border.caution": "#EF4444",
     "border.success": "#22C55E",
@@ -341,13 +341,13 @@
     "brand.amazon": "#232F3E",
     "hover.primary-button": "#1D4ED8",
     "hover.secondary-button": "#EFF6FF",
-    "hover.tertiary-button": "#F3F4F6",
-    "hover.ghost-button": "#F3F4F6",
+    "hover.tertiary-button": "#F4F4F5",
+    "hover.ghost-button": "#F4F4F5",
     "hover.destructive-button": "#B91C1C",
     "active.primary-button": "#1E40AF",
     "active.destructive-button": "#991B1B",
     "active.secondary-button": "#DBEAFE",
-    "active.tertiary-button": "#E5E7EB",
+    "active.tertiary-button": "#E4E4E7",
     "focus.high-emphasis": "#60A5FA",
     "caution.base": "#DC2626",
     "caution.action": "#B91C1C",
@@ -408,10 +408,10 @@
     "categorical.16.bold": "#6D28D9"
   },
   "semanticDark": {
-    "surface.primary": "#111827",
-    "surface.secondary": "#1F2937",
-    "surface.tertiary": "#374151",
-    "surface.quaternary": "#4B5563",
+    "surface.primary": "#18181B",
+    "surface.secondary": "#27272A",
+    "surface.tertiary": "#3F3F46",
+    "surface.quaternary": "#52525B",
     "surface.inverse": "#FFFFFF",
     "surface.accent-primary": "#3B82F6",
     "surface.accent-primary-light": "#1E3A8A",
@@ -420,8 +420,8 @@
     "surface.warning": "#78350F",
     "surface.info": "#1E3A8A",
     "surface.caution-strong": "#EF4444",
-    "surface.disable": "#1F2937",
-    "text.on-inverse": "#111827",
+    "surface.disable": "#27272A",
+    "text.on-inverse": "#18181B",
     "text.on-media": "#FFFFFF",
     "text.accent-primary": "#60A5FA",
     "text.success": "#4ADE80",
@@ -429,8 +429,8 @@
     "text.warning": "#FB923C",
     "text.info": "#60A5FA",
     "text.caution-on-inverse": "#B91C1C",
-    "text.on-inverse-secondary": "#374151",
-    "object.on-inverse": "#111827",
+    "text.on-inverse-secondary": "#3F3F46",
+    "object.on-inverse": "#18181B",
     "object.accent-primary": "#60A5FA",
     "object.caution": "#F87171",
     "object.success": "#4ADE80",