---
generated_at: 2026-03-01 00:00:00
metrics:
  claims_total: 48
  claims_with_evidence: 44
  claims_without_evidence: 4
confidence_derived: 0.92
---

# 根拠レポート：API設計書

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.92**
  - 根拠あり：44 / 48、根拠なし：4
- 優先レビュー（高）
  1. **ブラウザビルドの制約**：ブラウザパッケージの機能制限の詳細が公式ドキュメントに依存
  2. **CLIオプションのデフォルト値**：一部デフォルト値はargs解析コードの推測に基づく
  3. **@theme オプション一覧**：`static`オプション等の完全な動作仕様は推測を含む
  4. **DesignSystem戻り値の型**：`__unstable__loadDesignSystem()`の戻り値型の詳細は内部API

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `packages/tailwindcss/src/index.ts` — コアコンパイルAPI（compile, compileAst, __unstable__loadDesignSystem, Polyfills, Features）
- E-02: `packages/tailwindcss/package.json` — パッケージexports定義
- E-03: `packages/@tailwindcss-node/src/index.ts` — Node.jsパッケージのエクスポート一覧
- E-04: `packages/@tailwindcss-node/src/compile.ts` — Node.js版compile関数、CompileOptionsインターフェース
- E-05: `packages/@tailwindcss-node/src/optimize.ts` — optimize関数、OptimizeOptions、TransformResult、ブラウザターゲット
- E-06: `packages/@tailwindcss-node/src/source-maps.ts` — toSourceMap関数、SourceMap型
- E-07: `packages/@tailwindcss-browser/src/index.ts` — ブラウザビルドのコード全体
- E-08: `packages/tailwindcss/src/plugin.ts` — plugin関数、plugin.withOptions関数
- E-09: `packages/tailwindcss/src/compat/plugin-api.ts` — PluginAPI型定義、buildPluginApi実装
- E-10: `packages/tailwindcss/src/compat/config/types.ts` — UserConfig, DarkModeStrategy, ResolvedConfig型定義
- E-11: `packages/tailwindcss/src/compat/colors.ts` — カラーパレット定義
- E-12: `packages/tailwindcss/src/compat/default-theme.ts` — デフォルトテーマ設定
- E-13: `packages/tailwindcss/src/compat/flatten-color-palette.ts` — flattenColorPalette関数
- E-14: `packages/@tailwindcss-cli/src/index.ts` — CLIエントリーポイント、コマンドオプション

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Tailwind CSS v4.2.1はHTTP APIを提供しない | E-01, E-02 | ○ |
| C-02 | パッケージ構成は7パッケージ（tailwindcss, @tailwindcss/node, browser, cli, plugin, colors, defaultTheme） | E-02, E-03 | ○ |
| C-03 | compile()はCSS文字列を受け取りコンパイラオブジェクトを返す | E-01 (L819-855) | ○ |
| C-04 | compile()の戻り値にsources, root, features, build, buildSourceMapが含まれる | E-01 (L822-828) | ○ |
| C-05 | CompileOptionsにbase, from, polyfills, loadModule, loadStylesheetフィールドがある | E-01 (L54-75) | ○ |
| C-06 | Polyfillsはビットフラグ列挙型でNone, AtProperty, ColorMix, Allを持つ | E-01 (L41-52) | ○ |
| C-07 | FeaturesはAtApply, AtImport, JsPluginCompat, ThemeFunction, Utilities, Variants, AtThemeを持つ | E-01 (L116-139) | ○ |
| C-08 | compileAst()はAstNode[]入力をとりAstNode[]出力のビルド関数を返す | E-01 (L709-815) | ○ |
| C-09 | __unstable__loadDesignSystem()はDesignSystemオブジェクトを返す | E-01 (L857-860) | ○ |
| C-10 | Node.js版compile()はonDependencyコールバックを必須パラメータとして持つ | E-04 (L22-31) | ○ |
| C-11 | Node.js版CompileOptionsにcustomCssResolver, customJsResolverオプションがある | E-04 (L29-30) | ○ |
| C-12 | Node.js版compile()はsource()パスの存在チェックを行う | E-04 (L66-92, L100-104) | ○ |
| C-13 | optimize()はLightningCSSを使用してCSS最適化を行う | E-05 (L34-55) | ○ |
| C-14 | optimize()のブラウザターゲットはSafari 16.4, Firefox 128, Chrome 111 | E-05 (L48-53) | ○ |
| C-15 | optimize()は2回最適化を実行して隣接ルールをマージする | E-05 (L60-61, L116) | ○ |
| C-16 | optimize()はminify, file, mapオプションを受け付ける | E-05 (L5-22) | ○ |
| C-17 | toSourceMap()はDecodedSourceMap|stringを受け取りSourceMapオブジェクトを返す | E-06 (L45-60) | ○ |
| C-18 | SourceMapオブジェクトにraw, inline, commentプロパティがある | E-06 (L6-10) | ○ |
| C-19 | plugin()はhandlerとconfigを受け取りPluginWithConfigを返す | E-08 (L12-17) | ○ |
| C-20 | plugin.withOptions()はpluginFunctionとconfigFunctionを受け取る | E-08 (L19-33) | ○ |
| C-21 | PluginAPIにaddBase, addVariant, matchVariant, addUtilities, matchUtilities等のメソッドがある | E-09 (L38-89) | ○ |
| C-22 | addBase()はCssInJsを受け取り@layer baseとしてASTに追加する | E-09 (L109-118) | ○ |
| C-23 | addVariant()はバリアント名のバリデーションを行う（英数字、ハイフン、アンダースコア） | E-09 (L120-126) | ○ |
| C-24 | addVariant()は:merge()を含むバリアントを無視する | E-09 (L128-141) | ○ |
| C-25 | matchVariant()はfunctional variantを登録し、values/sortオプションをサポートする | E-09 (L161-263) | ○ |
| C-26 | addUtilities()はセレクタのバリデーションを行い.で始まる小文字クラス名を要求する | E-09 (L266-323) | ○ |
| C-27 | matchUtilities()はtype, supportsNegativeValues, values, modifiersオプションを受け付ける | E-09 (L350-509) | ○ |
| C-28 | matchUtilities()でtype='color'の場合、inherit/transparent/currentcolorが暗黙サポートされる | E-09 (L401-412) | ○ |
| C-29 | addComponents()はaddUtilities()のエイリアスである | E-09 (L512-513) | ○ |
| C-30 | matchComponents()はmatchUtilities()のエイリアスである | E-09 (L516-517) | ○ |
| C-31 | theme()はドット区切りパスでテーマ値にアクセスする | E-09 (L520-524) | ○ |
| C-32 | config()はResolvedConfigからパスで値を取得する | E-09 (L530-546) | ○ |
| C-33 | カラーパレットはoklch色空間で定義されている | E-11 | ○ |
| C-34 | カラーパレットにmauve, olive, mist, taupeが含まれる | E-11 (L72-123) | ○ |
| C-35 | defaultThemeにscreens, spacing, fontFamily等のプロパティが含まれる | E-12 | ○ |
| C-36 | flattenColorPalette()はネストされたカラーオブジェクトをフラット化する | E-13 (L7-30) | ○ |
| C-37 | UserConfigにpresets, theme, plugins, content, darkMode, prefix, blocklist, important, future, experimentalフィールドがある | E-10 | ○ |
| C-38 | DarkModeStrategyはfalse, 'media', 'class', ['class', string], 'selector', ['selector', string], ['variant', string | string[]]のいずれか | E-10 (L42-63) | ○ |
| C-39 | CLIは--input, --output, --watch, --minify, --optimize, --cwd, --map, --helpオプションを持つ | E-14 | ○ |
| C-40 | CLI出力のデフォルトはstdout（'-'） | E-14 | ○ |
| C-41 | @themeディレクティブはreference, inline, default, static, prefix()オプションをサポートする | E-01 (L85-104) | ○ |
| C-42 | @utilityは最上位レベルでのみ使用可能（ネスト不可） | E-01 (L223-226) | ○ |
| C-43 | @sourceはnot修飾子とinline()修飾子をサポートする | E-01 (L257-307) | ○ |
| C-44 | loadModuleが未提供の場合エラーをスローする | E-01 (L77-79) | ○ |
| C-45 | ブラウザビルドはプラグインおよび設定ファイルをサポートしない | E-07 (L173-175) | ○ |
| C-46 | @theme内では@keyframesとCSSカスタムプロパティのみ許可される | E-01 (L562-583) | △ |
| C-47 | CLIのデフォルトcwdは'.' | E-14 | △ |
| C-48 | DesignSystem型の完全な構造仕様 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- C-46: `@theme` 内の許可要素は実装コードから読み取れるが、エラーメッセージ以外のドキュメント的根拠がない
  - 候補：公式ドキュメント / CHANGELOG / テストケース
- C-47: CLIオプションのデフォルト値は引数パーサーの初期化コードから推測した部分がある
  - 候補：`packages/@tailwindcss-cli/src/commands/build/index.ts` の詳細確認
- C-48: `DesignSystem` 型は内部APIのため、公開型定義が存在しない
  - 候補：`packages/tailwindcss/src/design-system.ts` の型定義詳細

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: コアコンパイルAPI（compile, compileAst）— ソースコードから直接読み取った型定義に基づく
- **0（低リスク）**: プラグインAPI — 型定義と実装が一致していることを確認済み
- **0（低リスク）**: 互換エクスポート（colors, defaultTheme, flattenColorPalette）— ソースコードと完全一致
- **1（中リスク）**: Node.js拡張API — ブラウザターゲットのバージョン番号はビットシフト演算から計算したため、解釈に誤りの可能性あり
- **1（中リスク）**: CLIオプション — 一部デフォルト値はbuildコマンドの実装を直接確認できていない
- **0（低リスク）**: CSSディレクティブAPI — ソースコードのパーサー実装から直接抽出

## 6) レビュアーチェックリスト（最小）
- [ ] コアコンパイルAPI（compile, compileAst）のシグネチャが最新ソースコードと一致するか
- [ ] Node.js版CompileOptionsの必須/オプションパラメータが正しいか
- [ ] optimize()のブラウザターゲットバージョンが正しく計算されているか（ビットシフト演算: `(16 << 16) | (4 << 8)` = Safari 16.4）
- [ ] CLIオプションの一覧に漏れがないか（buildコマンドの詳細オプションを確認）
- [ ] PluginAPI型定義が実際の実装と整合しているか
- [ ] `__unstable__loadDesignSystem()` の使用に関する注意事項が十分か
- [ ] v4で追加されたカラーグループ（mauve, olive, mist, taupe）の記載が正しいか
