パイプライン概要

pnpm codegen は codegen/src/index.ts を実行します。完全なパイプラインは以下のとおりです：

package.json のバージョン番号
        │
        ▼
loadTokenFiles()          tokens/*.json をロード、Ajv 構造検証、flatten 扁平化
        │                  LoadedTokenFile[] を返す（各ファイルが namespace / isDark / flat を持つ）
        ▼
resolveTokens()           ref 解析（循環検出を含む）+ ダークのマージ
        │                  { tokenSet, orphanDarkPaths, refMap } を返す
        ▼
loadSpecs()               specs/*.json をロード（schema 検証）
loadCases()               cases/*.json をロード（schema 検証）
        │
        ▼
CodegenInput { tokens: tokenSet, specs, cases, version } を組み立てる
        │
        ▼
dist/ 全体を削除して再構築
        │
        ▼
5 つの target を順に実行 ──► android → ios → harmony → c → docs
        │                 各 target.generate(input) が GeneratedFile[] を返す
        ▼
dist/<outDir>/<relativePath> にファイル単位で書き出す

エントリファイル `codegen/src/index.ts`

定数

定数	値
`ROOT`	リポジトリルート（`import.meta.dirname` の 2 つ上）
`DIST`	`<ROOT>/dist`
`targets`	`[androidTarget, iosTarget, harmonyTarget, cTarget, docsTarget]`、順序は固定

`main()`

function main(): void

唯一のエントリ（index.ts は実体を何もエクスポートせず、main() は内部関数で、ファイル末尾から直接呼び出される）。手順：

readVersion() が package.json のバージョン番号を読む
loadTokenFiles() がトークンをロード
resolveTokens(files) が解決し、tokenSet を取る
loadSpecs() / loadCases() が契約と用例をロード
CodegenInput を組み立てる
existsSync(DIST) のとき rmSync(DIST, { recursive: true }) —— 削除してから再構築し、生成物に残骸がないことを保証する
target ごとに generate(input) を呼び、dist/<outDir>/<relativePath> に書き出し、生成物ごとに [target] path のログを出力
最終行で target 数、ファイル数、バージョンをまとめる

ファイルヘッダーのコメントがレッドライン 1 を明示しています：トークンの骨組みのみを生成し、UI 実装は一切生成しない。

中核インターフェース（`codegen/src/types.ts`）

以下はパイプラインで最もよく使う 4 つのインターフェースです。16 個の型エクスポートすべての完全なリファレンスは型定義 types.ts を参照してください。

`CodegenTarget`

interface CodegenTarget {
  name: string               // ログのプレフィックス（例 'android'）
  outDir: string             // dist 配下のサブディレクトリ名（例 'android'）
  generate(input: CodegenInput): GeneratedFile[]
}

各プラットフォーム target がこのインターフェースを実装します。プラットフォームの追加 = target を 1 つ追加し、targets 配列に加えることです。

`CodegenInput`

interface CodegenInput {
  tokens: TokenSet    // 解析済みのライトトークンセット + ダークオーバーライド
  specs: ComponentSpec[]   // 現在どの target も消費していない（将来のコンポーネントドキュメント / テスト生成用の予約）
  cases: ComponentCases[]  // 同上
  version: string     // package.json のバージョン番号。各生成物のヘッダーコメントに書き込む
}

`GeneratedFile`

interface GeneratedFile {
  relativePath: string  // dist/<outDir>/ からの相対出力パス
  content: string
}

`TokenSet`

interface TokenSet {
  tokens: ResolvedToken[]              // ライトトークン（path の辞書順）
  byPath: Map<string, ResolvedToken>   // パスによる高速検索
  dark: DarkOverrides                  // path -> ダークオーバーライド値
}

生成物の総数

target	ファイル数
android	2（`LhTokens.kt` + `LhDarkTokens.kt`）
ios	2〜3（+ `LhShadow.swift`、shadow トークンが存在する場合）
harmony	2〜3（+ `LhShadow.ets`）
c	2
docs	3

ios / harmony の投影ファイルは shadow トークンが存在するときのみ生成されるため、総ファイル数はトークンの内容によって変わります。dist/ の実際の生成物を基準にしてください。

モジュール	責務
load.ts	ロードと構造検証
resolve.ts	参照解決とダークのマージ
format.ts	中性値の解析と端ごとのフォーマット
tree.ts	フラットからネストへの変換
render.ts	テンプレートのレンダリング
types.ts	すべての型定義
targets/	5 つのプラットフォーム target
templates/	7 つの handlebars テンプレート

パイプライン概要

エントリファイル codegen/src/index.ts

定数

main()

中核インターフェース（codegen/src/types.ts）

CodegenTarget

CodegenInput

GeneratedFile

TokenSet