@lism-css/mcp 0.26.0 → 0.28.0

package/dist/data/guides/references/authoring.md

@@ -1,13 +1,9 @@
 # 実装プランの作り方（C0–C8詳細・出力フォーマット）
 
-Lism CSSで新規UI・セクション・コンポーネントを書く前に作る「実装プラン」の詳細編です。実装フローの全体像・資料確認トリガー表・判定記号は`SKILL.md`を正本とします。ここでは各チェック項目（C0–C8）の詳細とプランの出力フォーマットをまとめます。
-
-判定記号（✅/🔁/⏸、`✅新規`・`✅例外`の注記を含む）の定義は`SKILL.md`の「判定記号」を参照してください。
+Lism CSSで新規UI・セクション・コンポーネントを書く前に作る「実装プラン」の詳細編。実装フロー・資料確認トリガー・判定記号（✅/🔁/⏸と注記）は`SKILL.md`が正本で、ここではC0–C8の詳細とプランの出力フォーマットだけを扱う。
 
 ## 資料確認
 
-どの操作の手前で何を読むかは`SKILL.md`の「資料確認トリガー」を正本とする。
-
 ### 初期確認（C0前に実行）
 
 新規UI/コンポーネント/セクション、またはスクショ/Figma等のデザイン再現では、C0に入る前に対象へ明らかに関係する最小限の詳細ファイルを実際に開く。
@@ -18,15 +14,15 @@ Lism CSSで新規UI・セクション・コンポーネントを書く前に作
 初期確認した資料: primitives/l--stack.md, primitives/l--columns.md, tokens.md
 ```
 
-新規UI/コンポーネント/セクションで初期確認した資料が空のまま実装に入ってはいけない。「必要なら参照」とだけ書くのも不可。軽微な既存パターン内の修正で既存コード確認のみで足りる場合は、その旨を明記する。
+空のまま、または「必要なら参照」とだけ書いて実装に入らない。既存コード確認だけで足りる軽微な修正では、その旨を書く。
 
 ### 資料確認の記録
 
-読んだ資料は「初期確認」「実装中」を区別して資料確認ログに記録する。提出前に、🔁が✅または⏸へ解消されたかを照合する。
+読んだ資料は「初期確認」「実装中」を区別して資料確認ログ（「出力フォーマット」参照）に記録する。
 
 ## C0–C8 実装前チェック詳細
 
-各Cは「列挙/照合・判定/決め方/参照先/よい例・避けたい例」の観点で判断します。
+各Cは「列挙/照合・判定/決め方/参照先/よい例・避けたい例」の観点で判断する。
 
 ### C0: 入力整理
 
@@ -40,8 +36,7 @@ Lism CSSで新規UI・セクション・コンポーネントを書く前に作
 
 - **列挙**: 縦並び/横並び/カラム/メディア枠/幅制御/オーバーレイ/全体リンクなどの構造、要素、heading level、landmark。
 - **照合・判定**: 標準Primitiveで組める→✅。カラム系など迷う→🔁。`@lism-css/ui`で済む→✅または🔁。使うPrimitive詳細を未読なら🔁のまま実装しない。
-- **決め方**: Layout Primitive→Trait→Atomic→UIコンポーネントの順。`<div>`+Property ClassやCSSで押し切らない。
-- **Primitive優先ガード**: `<div>`+CSSで押し切らず、`SKILL.md`の「目的別実装ガイド」で候補を先に確認する。この判断を書かずに実装しない。
+- **決め方**: `SKILL.md`の「目的別実装ガイド」で候補を先に確認し、Layout Primitive→Trait→Atomic→UIコンポーネントの順に選ぶ。`<div>`+Property ClassやCSSで押し切らない。この判断を書かずに実装しない。
 - **参照先**: `SKILL.md`の「目的別実装ガイド」、`primitive-class.md`、`primitives/l--*.md`、`trait-class.md`、`components-core.md`、`components-ui.md`、`antipatterns-layout.md#レイアウト選択ミス`。
 - **よい例・避けたい例**: OK=`<Columns cols={3}>`、`<Frame ar="16/9">`、Astroなら`import { Stack, Columns, Frame } from 'lism-css/astro'`。罠=素の`<div>`だらけ、`<div -d:grid gtc=...>`、手組みメディア枠、最外殻Wrapper。
 
@@ -56,10 +51,10 @@ Lism CSSで新規UI・セクション・コンポーネントを書く前に作
 ### C3: 命名設計
 
 - **列挙**: 新設する`b--`/`c--`のクラス名とBlock/Element/Modifier構造、独自CSSを置くLayer。
-- **照合・判定**: プレフィックス後の名前が規約に合う→✅。ハイフンや`__`がある→🔁。ベーススタイルを CSS 側で管理する共通基礎部品→`✅新規`（`b--`）。それ以外のカスタムクラス→`✅新規`（`c--`）。公開API・CMS・外部JS・E2E依存→⏸。独自CSSがLayer外になる→🔁。
-- **決め方**: `naming.md`に従う。Block名にハイフンは使わず、Element区切りは`_`ひとつ、Modifierは`--`ふたつ（`b--`も`c--`と同記法）。分類は`b--`の3条件（サイト共通の繰り返し利用・ベーススタイルを CSS 側で管理・ボタン/バッジ/カード級の粒度。`css-rules.md#block-classb--`参照）で決める（すべて満たす→`b--`／それ以外→`c--`）。独自CSSは必ず`@layer lism-custom {}`内に置く（`b--`のベーススタイルだけ`@layer lism-block {}`）。
-- **参照先**: `naming.md`、`css-rules.md#block-classb--`、`css-rules.md#custom-classc--`、`css-rules.md#独自クラスの選び方2分類`、`antipatterns-layout.md#クラス名の命名ミス`。
-- **よい例・避けたい例**: OK=`c--featureCard`、`c--featureCard_body`、既存命名がアンダースコア寄せなら`c--feature_card`。罠=`c--feature-card`、`c--hero__inner`（正しくは`c--hero_inner`）、`c--feature-card__body`（正しくは`c--featureCard_body`）。
+- **照合・判定**: プレフィックス後の名前が規約に合う→✅。ハイフンや`__`がある→🔁。CSSで参照しないElement（`c--name_elem`）を付けている→🔁（外す）。ベーススタイルを CSS 側で管理する共通基礎部品→`✅新規`（`b--`）。それ以外のカスタムクラス→`✅新規`（`c--`）。公開API・CMS・外部JS・E2E依存→⏸。独自CSSがLayer外になる→🔁。
+- **決め方**: 記法とBlock名の付け方は`naming.md`、`b--`/`c--`の分類（`b--`は3条件をすべて満たす時だけ）と置くLayerは`css-rules.md`に従う。
+- **参照先**: `naming.md`、`css-rules.md#block-classb--`、`css-rules.md#custom-classc--`、`css-rules.md#独自クラスの選び方2分類`、`antipatterns-layout.md#クラス名の命名ミス`、`antipatterns-layout.md#css-の無い-element-クラスを付ける`。
+- **よい例・避けたい例**: OK=`c--featureCard`、`c--featureCard_body`、既存命名がアンダースコア寄せなら`c--feature_card`。罠=`c--feature-card`、`c--hero__inner`（正しくは`c--hero_inner`）、`c--feature-card__body`（正しくは`c--featureCard_body`）、CSSで参照しない`c--featureCard_title`（外す）。
 
 ### C4: 状態・バリエーション設計
 
@@ -72,24 +67,24 @@ Lism CSSで新規UI・セクション・コンポーネントを書く前に作
 ### C5: 値・トークン照合
 
 - **列挙**: spacing/color/fz/radius/shadow/size/lh/ltsなど、使う予定の値をすべて列挙。
-- **照合・判定**: `tokens.md`に完全一致→✅。typo・既存規約上明確な置換→🔁（`tokens.md`で正規トークンを確認して置換し✅へ）。近似丸め・任意色・ブランド色・再現度の判断→⏸。`antipatterns.md`の「直書きしてよい例外」に該当→`✅例外`。`✅例外`にできるのはこの許可リストだけで、「ユーザー指示に基づく実測値」のような例外カテゴリを自作しない。
+- **照合・判定**: 「照合の手順」の3に従う（完全一致→✅／typo等の明確な置換→🔁にして`tokens.md`で確認後✅／近似丸め・任意色・ブランド色→⏸／許可リスト該当→`✅例外`）。
 - **決め方**: トークン値を流用。⏸は本ファイルの「デザインデータ取り込みフロー」に従い、トークン候補と差分表を出して確認まで書かない。CSSへ書く前に、Lism Props/Property Classで表せる値かも同時に確認する。インストール済みの`lism-css`がある環境では、実CSS（`main.css`）やコンポーネント実装でトークン・クラスの実在を確認してから採用するとtypoを防げる。
 - **参照先**: `tokens.md`、`property-class.md`、`antipatterns.md#token-typo存在しない値`、`antipatterns.md#px--固定値の直書き`。
 - **よい例・避けたい例**: OK=`-fz:xs -p:10 -bgc:base-2 -bdrs:10`。罠=`padding:13px`、`bgc="secondary"`。
 
 ### C6: レスポンシブ方針
 
-- **列挙**: 各値のbaseの値、切替BP（sm/md/lg）、container queryかmedia queryか、container運用なら祖先`isContainer`の有無、固定Grid化していないか。
-- **照合・判定**: baseの値あり・標準BP・必要な祖先あり→✅。base抜け・xs誤用→🔁。`$is_container_query:0`等でmedia query運用が確認できる場合は`isContainer`必須にしない→✅。固定列をレスポンシブ化するなど挙動変更→⏸。
-- **決め方**: baseの値を必ず置く。標準BPへ寄せる。同じ値の繰り返しは省略する。等幅カラムはまず`Columns cols={[1, null, 3]}`などPrimitiveのレスポンシブAPIで表せるか確認し、できない場合だけ`@container`/`@media`を自分で書く。
+- **列挙**: 各値のbaseと切替BP（sm/md/lg）、container queryかmedia queryか、container運用なら祖先`isContainer`の有無、固定Grid化していないか。
+- **照合・判定**: 標準BP・必要な祖先あり→✅。xs誤用→🔁。`$is_container_query:0`等でmedia query運用が確認できる場合は`isContainer`必須にしない→✅。固定列をレスポンシブ化するなど挙動変更→⏸。
+- **決め方**: 標準BPへ寄せる。同じ値の繰り返しは省略する。等幅カラムはまず`Columns cols={[1, null, 3]}`などPrimitiveのレスポンシブAPIで表せるか確認し、できない場合だけ`@container`/`@media`を自分で書く。
 - **参照先**: `responsive.md`、`trait-class/is--container.md`、`property-class.md`、`primitive-class.md#カラムレイアウト-primitive-の使い分けガイド`。
-- **よい例・避けたい例**: OK=`p={{ base: '20', md: '30' }}`+祖先`isContainer`、`<Columns cols={[1, null, 3]}>`。罠=`gtc="repeat(3,1fr)"`固定、カード列数のためだけに`@container`直書き、base抜け、container祖先なし。
+- **よい例・避けたい例**: OK=`p={{ base: '20', md: '30' }}`+祖先`isContainer`、`<Columns cols={[1, null, 3]}>`。罠=`gtc="repeat(3,1fr)"`固定、カード列数のためだけに`@container`直書き、container祖先なし。
 
 ### C7: CSSに書くもの/Propsに移すもの
 
 - **列挙**: CSSへ書く予定の各宣言を「Property Class/Propsへ移す宣言」と「CSSにしか書けない宣言」に分ける。`c--*`のCSSに残る宣言を実装プランに明記する。
 - **照合・判定**: `c--*`のクラスで1つの要素にだけ効く見た目の指定→✅マークアップへ。擬似クラス・擬似要素・状態切替・子孫セレクタ→✅CSSへ残す。C3で`b--`と決めた部品のベーススタイル→✅`@layer lism-block`へ残す（トークン使用。BP切替・hover・例外調整はProperty Class）。下表の宣言が`.c--*` CSSに残る→🔁未通過。
-- **決め方**: `-{prop}:{value}`またはLism Propsへ移す。`.c--*`はCSSが空でも何のパーツかを示す名前として残す。
+- **決め方**: `-{prop}:{value}`またはLism Propsへ移す。本体クラス`c--name`はCSSが空でも何のパーツかを示す名前として残す。ElementはCSSで参照しなくなったら外す。
 - **参照先**: `property-class.md`、`css-rules.md#custom-classc--`、`antipatterns.md#property-class-で書けるのに-css-で書く`。
 - **移行表**:
 
@@ -110,23 +105,19 @@ Lism CSSで新規UI・セクション・コンポーネントを書く前に作
 
 ### C8: 既定値の確認
 
-- **列挙**: 使うPrimitiveが既に持つ既定CSSを確認し、同値をProps/Property Classで重ねていないか。
+- **列挙**: 使うPrimitiveが既に持つ既定CSSを確認し、同値をProps/Property Classで重ねていないか。セマンティックコンポーネント（`Text`/`Inline`/`Group`等）にデフォルト要素と同じ`as`を付けていないか。
 - **照合・判定**: 既定と同値→足さない。既定と違う意図的上書き→✅。ガイドに未整備のPrimitive既定→今後の整備対象にする。
 - **決め方**: `primitives/l--*.md`の「既定の挙動」を見る。念のための`ai="center"`/`ov="hidden"`/直下img`w/h/object-fit`を足さない。
-- **参照先**: `primitives/l--cluster.md`、`primitives/l--frame.md`、`primitive-class.md`、`components-core.md`。
-- **よい例・避けたい例**: OK=`<Cluster g="15">`、`<Frame ar="16/9"><img /></Frame>`。罠=`<Cluster fxw="wrap" ai="center">`、Frame直下imgに`-w:100%`や`object-fit`。
+- **参照先**: `primitives/l--cluster.md`、`primitives/l--frame.md`、`primitive-class.md`、`components-core.md#セマンティックコンポーネント`。
+- **よい例・避けたい例**: OK=`<Cluster g="15">`、`<Frame ar="16/9"><img /></Frame>`。罠=`<Cluster fxw="wrap" ai="center">`、Frame直下imgに`-w:100%`や`object-fit`、`<Text as="p">`。
 
 ## 出力フォーマット
 
-実装前チェックの成果物を実装プランと呼びます。各行に必ず判定記号（定義は`SKILL.md`参照）を付け、⏸が残る項目はその部分を実装しないで先にユーザー確認します。
-
-値照合付きレベルでは、実装プラン全体をチャットの返答としてではなく`.lism/plan.md`として保存します（固定名・上書き。冒頭のメタデータヘッダに日時・対象タスク・スケール前提とその判定根拠を書く）。規約は[`verification.md`](./verification.md)を参照してください。
+実装前チェックの成果物を実装プランと呼ぶ。各行に判定記号を付ける。値照合付きレベルでは`.lism/plan.md`へ保存する（規約は[`verification.md`](./verification.md)）。
 
 ### 軽量レベル
 
-小変更では3〜5行で十分です。
-
-例:
+例（3〜5行）:
 
 ```md
 - ✅ 構造: 既存`Stack`内へ1項目追加。Primitive変更なし。
@@ -138,7 +129,7 @@ Lism CSSで新規UI・セクション・コンポーネントを書く前に作
 
 #### 資料確認ログ
 
-SKILL.md以外に実際に開いたファイルや外部サイトのページurlを、「初期確認」と「実装中」に分けて列挙します。
+SKILL.md以外に実際に開いたファイルや外部サイトのページurlを、「初期確認」と「実装中」に分けて列挙する。
 
 例:
 | タイミング | 種類 | 確認した資料 | 用途 |
@@ -147,19 +138,17 @@ SKILL.md以外に実際に開いたファイルや外部サイトのページurl
 | 実装中 | 📄 | `tokens.md` | デザイン値とトークン照合（トークン丸めトリガー） |
 | 実装中 | URL | `https://lism-css.com/docs/naming.md` | `c--*`命名トリガー |
 
-各行は実装プランの判断項目（特に🔁）と対応させ、提出前に🔁が✅/⏸へ解消されたかを照合します。
+各行を実装プランの判断項目（特に🔁）と対応させる。
 
 #### 🔁判断行
 
-未読の判断項目そのものに🔁と読む資料を紐づけます。
+未読の判断項目そのものに🔁と読む資料を紐づける。資料を読んだら同じ行を✅または⏸へ更新する。
 
 | 判断項目 | 採用案 | 読む資料 | 判定 |
 | --- | --- | --- | --- |
 | カード一覧 | `Columns cols={[1, null, 3]}` | `primitives/l--columns.md` | 🔁 |
 | hover指定 | `hov={{ bgc: 'base-2' }}` | `property-class/hov.md` | 🔁 |
 
-対応資料を読んだら、同じ判断行を✅または⏸へ更新します。提出前に🔁が残っている場合は未通過です。
-
 #### 構造表
 
 | 対象領域 | 採用Primitive・コンポーネント | 理由 | 参照先 | 判定 |
@@ -168,7 +157,7 @@ SKILL.md以外に実際に開いたファイルや外部サイトのページurl
 
 #### トークン表
 
-値照合付きでは`デザイン値`と`差分`列を必須にします。
+値照合付きでは`デザイン値`と`差分`列を必須にする。
 
 | 用途 | デザイン値 | 採用トークン | 差分 | 判定 |
 | --- | --- | --- | --- | --- |
@@ -197,9 +186,9 @@ SKILL.md以外に実際に開いたファイルや外部サイトのページurl
 
 #### 入力種別と既定動作
 
-デザイン値の扱いは、入力の種類とプロジェクトの段階で決まります。「正確に再現して」等の指示があってもこの分岐が既定動作で、ユーザー指示を根拠に`✅例外`を自作してはいけません。
+デザイン値の扱いは、入力の種類とプロジェクトの段階で決まる。「正確に再現して」等の指示があってもこの分岐が既定動作。
 
-この表は⏸確認を省略する許可ではありません。丸め・任意色などの⏸判定自体は最小ゲート・C5のとおりで、既定動作は「確認時に第一候補として提示する案」と「確認が取れない場合に前提として選ぶ選択肢」を定めるものです（`SKILL.md`「判定記号」の⏸運用を参照）。
+この表は⏸確認を省略する許可ではない。既定動作は、確認時に第一候補として出す案と、確認が取れない時に`✅前提`として選ぶ選択肢（`SKILL.md`「判定記号」の⏸の項）を定める。
 
 | 入力 | 既定動作 |
 | --- | --- |
@@ -215,28 +204,27 @@ SKILL.md以外に実際に開いたファイルや外部サイトのページurl
    - 完全一致→✅そのまま採用。
    - typo・既存規約上明確な置換（`secondary`→`base-2`など）→`tokens.md`で正規トークンを確認して置換し、✅にする（ユーザー確認は不要）。
    - 近似丸め・任意色・ブランド色・密度/再現度の判断→⏸。A=最寄りトークンに丸める/B=カスタムトークン化または基準値（`--s-unit`等）の上書き/C=px直書き（例外）を提示する。この選択肢の定義はここが正本。
+   - `antipatterns.md`の「直書きしてよい例外」に該当→`✅例外`（条件は`SKILL.md`「判定記号」）。
 4. **カスタムトークン化の条件**: 同値が複数箇所で再利用される、またはデザインシステム上の意味を持つ場合は候補にする。1回限りの局所値は丸めか例外で済ませる。
 5. **デザインデータが無い場合**: 差分表は省略し、既存トークンから意味が近い値を選ぶ。新規数値が必要な時だけ⏸にする。
 
-`--s-unit`などの基準値をプロジェクトが上書きしているとpxの完全一致判定が変わります。値照合付きでは上書きの有無を先に確認してください。
-
-プロセス違反の実例（NG）:
+`--s-unit`などの基準値をプロジェクトが上書きしているとpxの完全一致判定が変わる。値照合付きでは上書きの有無を先に確認する。
 
-- C5に「ユーザー要件の『正確に再現』に基づくページ固有実測値として採用」のような1行を書いて値照合を包括免除し、差分表を省略する。値照合付きレベルでトークン差分表の無い実装プランは無効。
+実測pxを包括的に例外化するNG例は[`antipatterns.md`](../antipatterns.md#px--固定値の直書き)の「実測pxの包括例外化」。
 
 #### 値マッピングの初期すり合わせ
 
-デザインシステムが未確立のプロジェクトで初期実装を任された場合は、値ごとに⏸を出すのではなく、実装前にマッピング方針を一括ですり合わせます。トークン差分表と確認事項表をこの一括確認の提出物として使います。
+デザインシステムが未確立のプロジェクトで初期実装を任された場合は、値ごとに⏸を出すのではなく、実装前にマッピング方針を一括ですり合わせる。トークン差分表と確認事項表をこの一括確認の提出物として使う。
 
 - スペース・サイズ・タイポグラフィ: どの範囲を最寄りトークンへ丸め、どこを具体値（px直書き・カスタムトークン）にするかの境界。
 - カラー: デザイン内の各色をどのセマンティックカラー（`--brand`/`--accent`/`--base`/`--base-2`/`--text`/`--text-2`等）へ割り当てるか。
 - デザイン画像しか無い場合は、書き出し倍率・想定キャンバス幅の前提もここで確認する。倍率はC0の実測・整合チェックで確定してから提示する。
 
-ユーザー確認が取れない場合は、原則準拠側（最寄りトークンへの丸め・セマンティック割り当て案）を前提として実装プランに明示して進め、完了報告で代替案とともに列挙します（`SKILL.md`「判定記号」の⏸運用を参照）。
+確認が取れない場合の進め方は`SKILL.md`「判定記号」の⏸の項。
 
 ### 提出前セルフチェックへの接続
 
-実装後、実行レベルが「通常」「値照合付き」の場合は、実装プランと実装を1行ずつ照合します（チェック項目とレベル別の扱いは`SKILL.md`の「提出前セルフチェック」を参照）。この照合とルール照合は、サブエージェント／タスク委任機能が使える環境では評価サブエージェントに実行させ、報告を`.lism/review.md`へ保存します（[`verification.md`](./verification.md)）。
+`SKILL.md`「提出前セルフチェック」で実装プランと実装を照合した時の分類例:
 
 | 計画項目 | 実装結果 | 分類 | 対応 |
 | --- | --- | --- | --- |

package/dist/data/guides/references/page-sections.md

@@ -40,7 +40,7 @@ import { Group, Wrapper, Cluster, Link } from 'lism-css/astro';
 ```jsx
 import { Group, Wrapper, Stack, Cluster, Heading, Text } from 'lism-css/astro';
 
-<Group as="section" className="c--frontHero" bgc="base-2" py={['60', null, '80']} hasGutter isContainer>
+<Group as="section" className="c--frontHero" bgc="base-2" py={['60', null, '70']} hasGutter isContainer>
   <Wrapper contentSize="l">
     <Stack g="30" ai="center" ta="center">
       <Heading level="1" fz={['3xl', null, '5xl']}>キャッチコピー</Heading>

package/dist/data/guides/references/verification.md

@@ -1,8 +1,8 @@
 # 検証の分離（`.lism/`規約と評価サブエージェント）
 
-提出前チェックの実行を実装担当の本人から分離し、実装プランと評価結果をユーザーが後から確認できるファイルとして残すための規約です。実装フロー・チェック項目の正本は`SKILL.md`（実装フロー・提出前セルフチェック）、実装プランの中身と書式は[`authoring.md`](./authoring.md)を参照してください。
+提出前チェックの実行を実装担当の本人から分離し、実装プランと評価結果をユーザーが後から確認できるファイルとして残すための規約。フローとチェック項目は`SKILL.md`、実装プランの書式は[`authoring.md`](./authoring.md)が正本。
 
-`lism-css-guide`の実装フローでは、事前チェック実行レベルが「通常」「値照合付き」の場合だけこの規約を適用します。「不要」「軽量」では`.lism/`へのファイル作成も評価サブエージェントへの委任も行いません（`SKILL.md`「事前チェック実行レベル」参照）。このレベル条件は`lism-css-guide`固有のもので、`.lism/`規約をここから参照する他のスキル（`lism-css-refactor`等）には適用されません。他のスキルからの利用時は、ファイルを作るかどうかは各スキル側の手順に従ってください。
+`lism-css-guide`では実行レベルが「通常」「値照合付き」の時だけ適用する（「不要」「軽量」では`.lism/`も評価委任も無し）。このレベル条件は`lism-css-guide`固有で、`.lism/`規約を参照する他のスキル（`lism-css-refactor`等）ではファイルを作るかどうかを各スキルの手順に従う。
 
 ## `.lism/`作業ディレクトリ
 
@@ -11,7 +11,7 @@ Lism実装作業の成果物（実装プラン・評価報告）は、プロジ
 | ファイル | 内容 | 作成タイミング |
 | --- | --- | --- |
 | `.lism/plan.md` | 実装プラン（トークン差分表・構成表を含む） | 値照合付きレベルの実装前チェック時 |
-| `.lism/review.md` | 評価サブエージェント（委任できない環境では本人）による評価報告 | 通常・値照合付きレベルの提出前セルフチェック時（不要・軽量では作成しない） |
+| `.lism/review.md` | 評価サブエージェント（委任できない環境では本人）による評価報告 | 通常・値照合付きレベルの提出前セルフチェック時 |
 
 - **固定名・上書き方式**。タスクごとに別名を作らない。照合先が一意に決まることが、評価サブエージェントや将来の機械チェックの前提になる。複数タスクの文脈は各ファイル冒頭のメタデータヘッダで区別する。
 - メタデータヘッダには日時・対象タスク・スケール前提（デザイン再現時。判定根拠付き）を書く。
@@ -30,7 +30,7 @@ scale: PNGは2880px幅=1440px設計の2x書き出し（画像実寸と行送り
 
 ## 評価サブエージェントへの委任
 
-提出前セルフチェックを実装した本人だけで行うと、「正確に再現する」等のゴールへの執着や、自分で立てたプランを疑いにくくなる心理から、例外を自己承認してしまいやすくなります。サブエージェント／タスク委任機能が使える環境では、照合を読み取り専用の評価サブエージェントに委任します。使えない環境では、同じ照合を本人が`SKILL.md`「提出前セルフチェック」の順に自分で実行します。
+本人だけの照合は自分のプランを疑いにくく、例外を自己承認しやすい。委任できる環境では読み取り専用の評価サブエージェントに委任し、できない環境では本人が`SKILL.md`「提出前セルフチェック」の順に行う。
 
 運用ルール:
 

package/dist/data/guides/responsive.md

@@ -34,7 +34,7 @@ Smartphone ──┬── Tablet (Portrait) ──┬── Tablet (Landscape)
 
 **`xs` / `xl` は opt-in**:
 - デフォルト値は `0`（無効）で、CSS は出力されません。`lism.config.js` の `breakpoints` でサイズを与えると有効化されます（customize.md 参照）。
-- 型（Lism コンポーネント）でも `sm` / `md` / `lg` のみがデフォルトで補完・許可されます。`xs` / `xl` を使う場合は `declare module 'lism-css'` で `BreakpointRegistry` を拡張して解禁します。
+- 型（Lism コンポーネント）でも `sm` / `md` / `lg` のみがデフォルトで補完・許可されます。`@lism-css/plugin` の統合プラグイン使用時は有効化した BP を反映した `lism-env.d.ts` が自動生成されるため手書き不要（customize.md 参照）。プラグインを使わない構成では `declare module 'lism-css'` で `BreakpointRegistry` を拡張して解禁します。
 
   ```ts
   // src/lism.d.ts など
@@ -85,6 +85,7 @@ Smartphone ──┬── Tablet (Portrait) ──┬── Tablet (Landscape)
 **仕組み:**
 - BPクラス `-{prop}_{bp}` は `@container (min-width: ...)` 内で発火し、`--{prop}_{bp}` 変数で切り替え先の値を指定
 - コンテナクエリ採用のため、レスポンシブ値を使うには祖先要素に `is--container` などコンテナ宣言が必要
+- base 値は任意。省くと BP 未満はそのプロパティの既定値のまま（例: `-d_sm` + `--d_sm: none` で sm 以上だけ非表示）
 - 出力形式はプロパティによって 2 パターン（基本 / 例外）
 
 **基本パターン** — BP 用変数を直接読む:
@@ -125,37 +126,16 @@ Smartphone ──┬── Tablet (Portrait) ──┬── Tablet (Landscape)
 
 ## Authoring時の確認ルール
 
-### base値を必ず置く
-
-BP専用値だけを書くと、BP未満で値が未指定になります。配列では先頭、オブジェクトでは`base`、HTMLでは`-{prop}:{value}`を必ず置きます。
-
-| NG | OK |
-| --- | --- |
-| `<Box p={{ sm: 30 }}>` | `<Box p={{ base: '20', sm: '30' }}>` |
-| `<div class="-p_sm" style="--p_sm:var(--s30)">` | `<div class="-p:20 -p_sm" style="--p_sm:var(--s30)">` |
+NG→OK例は [antipatterns-layout.md](./antipatterns-layout.md#レスポンシブ抜け) の「レスポンシブ抜け」「レスポンシブ配列の冗長指定」を参照。
 
 ### 冗長配列は圧縮する
 
-前のBPと同じ値を繰り返さない。変わらないBPは`null`でスキップし、全BPで同じ値なら単一値にします。
-
-| NG | OK |
-| --- | --- |
-| `fxd={['column', 'column', 'row']}` | `fxd={['column', null, 'row']}` |
-| `p={['20', '20', '20']}` | `p="20"` |
-| `cols={[1, 1, 3]}` | `cols={[1, null, 3]}` |
-
-ただし、既存コードの型・生成仕様で`null`が使えない場合は既存パターンを優先します。レスポンシブ差分を誤って単一値化しないでください。
+前のBPと同じ値を繰り返さない。変わらないBPは`null`でスキップし、全BPで同じ値なら単一値にします。ただし、既存コードの型・生成仕様で`null`が使えない場合は既存パターンを優先し、レスポンシブ差分を誤って単一値化しないでください。
 
 ### container query運用では祖先`isContainer`を確認する
 
 デフォルトではレスポンシブProperty Classは`@container`で発火します。レスポンシブ値を載せる要素の祖先に`isContainer`/`is--container`があるか確認してください。
 
-```jsx
-<Stack isContainer>
-  <Box p={{ base: '20', md: '40' }}>...</Box>
-</Stack>
-```
-
 `$is_container_query:0`などの設定でmedia query運用が確認できる場合は、`isContainer`祖先は必須ではありません。設定が不明な場合は、既存SCSS設定・`customize.md`・生成CSSを確認してから判断してください。
 
 ### `isContainer`を置く位置で挙動が変わる

package/dist/data/guides/set-class.md

@@ -74,7 +74,7 @@ Lism CSSでは、クラスを持つリスト（`ul` / `ol`）ではスタイル
 
 ## `set--bxsh`
 
-`SHADOW` トークン変数（`--bxsh--{N}`）を再計算するためのクラスです。`:root` で定義される `--shc`（影の色）を特定要素で上書きしたい時に利用します。
+`SHADOW` トークン変数（`--bxsh--{N}`）を再計算するためのクラスです。`:root` で定義される `--shc`（影の色）を特定要素で上書きしたい時に利用します。近い側の影色 `--shc--near` も `--shc` から再計算されるため、2層の影がまとめて変わります。
 
 使用例:
 ```html
@@ -191,7 +191,7 @@ Lism CSSでは、クラスを持つリスト（`ul` / `ol`）ではスタイル
 
 ## `set--s`
 
-余白トークン（`--s5`〜`--s80`）を現在のフォントサイズ基準で再計算するためのクラスです。ButtonやBadgeなど、内部余白を要素自身のfont-sizeに追従させたい時に利用します。
+余白トークン（`--s5`〜`--s70`）を現在のフォントサイズ基準で再計算するためのクラスです。ButtonやBadgeなど、内部余白を要素自身のfont-sizeに追従させたい時に利用します。
 
 詳細なスケールと使い方は[tokens.mdの`set--s`ユーティリティ](./tokens.md#set--s-ユーティリティ)を参照してください。
 

package/dist/data/guides/tokens.md

@@ -30,14 +30,15 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
 
 | カテゴリ | トークン値 | CSS変数パターン | 例 |
 | --- | --- | --- | --- |
-| 余白 (space) | `5`, `10`, `15`, `20`, `25`, `30`, `35`, `40`, `50`, `60`, `70`, `80` | `--s{N}` | `--s20` |
+| 余白 (space) | `5`, `10`, `15`, `20`, `25`, `30`, `35`, `40`, `45`, `50`, `60`, `70` | `--s{N}` | `--s20` |
 | フォントサイズ (fz) | `base`, `2xs`, `xs`, `s`, `m`, `l`, `xl`, `2xl`, `3xl`, `4xl`, `5xl` | `--fz--{key}` | `--fz--l` |
-| ハーフレディング・行間 (hl/lh) | `base`, `xs`, `s`, `l` | `--hl--{key}` | `--hl--s` |
-| 字間 (lts) | `base`, `s`, `l`, `xl` | `--lts--{key}` | `--lts--s` |
+| ハーフレディング (hl) | `base`, `xs`, `s`, `l`, `xl` | `--hl--{key}` | `--hl--s` |
+| 行間比率 (lh) | `xs`, `s`, `m`, `l`, `xl` | `--lh--{key}` | `--lh--m` |
+| 字間 (lts) | `base`, `xs`, `s`, `l`, `xl` | `--lts--{key}` | `--lts--s` |
 | フォント (ff) | `base`, `accent`, `mono` | `--ff--{key}` | `--ff--mono` |
 | ウェイト (fw) | `light`, `normal`, `bold` | `--fw--{key}` | `--fw--bold` |
 | 透明度 (o) | `mp`, `p`, `pp`, `ppp` | `--o--{key}` | `--o--p` |
-| 角丸 (bdrs) | `10`, `20`, `30`, `40`, `99`, `inner` | `--bdrs--{key}` | `--bdrs--20` |
+| 角丸 (bdrs) | `10`, `20`, `30`, `40`, `50`, `99`, `inner` | `--bdrs--{key}` | `--bdrs--20` |
 | 影 (bxsh) | `10`, `20`, `30`, `40`, `50` | `--bxsh--{N}` | `--bxsh--20` |
 | サイズ (sz) | `xs`, `s`, `m`, `l`, `xl` | `--sz--{key}` | `--sz--l` |
 | アスペクト比 (ar) | `og` | `--ar--{key}` | `--ar--og` |
@@ -51,7 +52,7 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
 
 ## 余白 (space)
 
-フィボナッチ数列ベースのスケーリング。`--s-unit`（デフォルト `calc(var(--fz--base) * 0.5)` ＝ ≒ 8px）を基準単位とする。
+フィボナッチ数列ベースのスケーリング。`--s-unit`（デフォルト `0.5rem` ≒ 8px）を基準単位とする。
 
 | CSS変数 | 値 | 実サイズ目安 |
 | --- | --- | --- |
@@ -63,16 +64,16 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
 | `--s30` | `calc(var(--s-unit) * 3)` | ≒ 24px |
 | `--s35` | `calc(var(--s-unit) * 4)` | ≒ 32px |
 | `--s40` | `calc(var(--s-unit) * 5)` | ≒ 40px |
+| `--s45` | `calc(var(--s-unit) * 6.5)` | ≒ 52px |
 | `--s50` | `calc(var(--s-unit) * 8)` | ≒ 64px |
 | `--s60` | `calc(var(--s-unit) * 13)` | ≒ 104px |
 | `--s70` | `calc(var(--s-unit) * 21)` | ≒ 168px |
-| `--s80` | `calc(var(--s-unit) * 34)` | ≒ 272px |
 
-`--s40` 以降の主軸は係数 `1, 2, 3, 5, 8, 13, 21, 34`（フィボナッチ数列）に基づく。`--s5`〜`--s35` の前半部分は、主軸トークン間を補う中間値（4px / 12px / 20px / 32px 相当）として配置している。`--s-unit` を上書きするとスケール全体を比例的に調整できる。
+10 刻みの主軸は係数 `1, 2, 3, 5, 8, 13, 21`（フィボナッチ数列）に基づき、タイポグラフィの縦のリズムを作る。5 刻み（`--s5`〜`--s45`）は主軸トークン間のちょうど中間値（4px / 12px / 20px / 32px / 52px 相当）で、縦のリズムに縛られない水平方向の gap / padding 用。中間値は `50` まで。`--s-unit` を上書きするとスケール全体を比例的に調整できる。`--fz--base` を流体値にしていて余白も連動させたい場合は、`:root` で `--s-unit: calc(var(--fz--base) * 0.5)` に上書きする。
 
 ### `set--s` ユーティリティ
 
-`set--s` クラスを当てた要素のスコープ内では `--s-unit` が `0.5em` に切り替わり、`--s10`〜`--s80` が現在のフォントサイズ基準で再計算される。Button / Badge / インライン要素など、内部余白をフォントサイズに追従させたい部品で使う。
+`set--s` クラスを当てた要素のスコープ内では `--s-unit` が `0.5em` に切り替わり、`--s10`〜`--s70` が現在のフォントサイズ基準で再計算される。Button / Badge / インライン要素など、内部余白をフォントサイズに追従させたい部品で使う。
 
 ```html
 <!-- ボタンの padding が button 自身の font-size に追従する -->
@@ -109,7 +110,9 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
 
 ## 行間 (hl/lh)
 
-ハーフレディングの大きさ。Lism CSSでは、`line-height` は `calc(1em + var(--hl) * 2)` で算出される。`--hl-unit`（≒ 2px）を基準単位とする。
+`line-height` は全要素で `var(--lh, calc(1em + var(--hl) * 2))` として算出される。既定は `--hl`（ハーフレディング）で管理し、`--lh` がセットされていればそちらが優先される。
+
+`hl` はハーフレディングの大きさ。`--hl-unit`（≒ 2px）を基準単位とする。
 
 | CSS変数 | 値 | 説明 |
 | --- | --- | --- |
@@ -117,16 +120,32 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
 | `--hl--s` | `calc(var(--hl-unit) * 2)` | 小さめの行間（≒ 4px） |
 | `--hl--base` | `calc(var(--hl-unit) * 3)` | 基本の行間（≒ 6px） |
 | `--hl--l` | `calc(var(--hl-unit) * 4)` | 大きめの行間（≒ 8px） |
+| `--hl--xl` | `calc(var(--hl-unit) * 5)` | より大きな行間（≒ 10px） |
+
+`--fz--base` を流体値にしていて行間も連動させたい場合は、`:root` で `--hl-unit: calc(var(--fz--base) * 0.125)` に上書きする。
+
+`lh` は `line-height` を倍率で指定するトークン。`hl` が fz 非依存の固定量なのに対し、fz に比例した行送りを保ちたい場合に使う。
+
+| CSS変数 | 値 |
+| --- | --- |
+| `--lh--xs` | `1.25` |
+| `--lh--s` | `1.5` |
+| `--lh--m` | `1.75` |
+| `--lh--l` | `2` |
+| `--lh--xl` | `2.25` |
 
 
 ## 字間 (lts)
 
 | CSS変数 | 値 | 説明 |
 | --- | --- | --- |
-| `--lts--base` | `normal` | 基本の文字間隔 |
-| `--lts--s` | `-0.025em` | 狭めの文字間隔 |
-| `--lts--l` | `0.05em` | 広めの文字間隔 |
-| `--lts--xl` | `0.1em` | より広い文字間隔 |
+| `--lts--base` | `0em` | 基本の文字間隔。長さで指定（`normal` 不可） |
+| `--lts--xs` | `calc(var(--lts--base) - 0.05em)` | より狭い文字間隔 |
+| `--lts--s` | `calc(var(--lts--base) - 0.025em)` | 狭めの文字間隔 |
+| `--lts--l` | `calc(var(--lts--base) + 0.05em)` | 広めの文字間隔 |
+| `--lts--xl` | `calc(var(--lts--base) + 0.1em)` | より広い文字間隔 |
+
+`xs`〜`xl` は `--lts--base` からの相対値。`:root` で `--lts--base` を変えると全体が連動する（子孫要素での上書きは `xs`〜`xl` に伝わらない）。
 
 
 ## フォント (ff)
@@ -163,32 +182,37 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
 
 ## 角丸 (bdrs)
 
+増分が0.125remずつ大きくなる二階等差数列のスケール。
+
 | CSS変数 | 値 | 説明 |
 | --- | --- | --- |
 | `--bdrs--10` | `0.25rem` | ≒ 4px |
-| `--bdrs--20` | `0.5rem` | ≒ 8px |
-| `--bdrs--30` | `1rem` | ≒ 16px |
-| `--bdrs--40` | `1.5rem` | ≒ 24px |
+| `--bdrs--20` | `0.375rem` | ≒ 6px |
+| `--bdrs--30` | `0.625rem` | ≒ 10px |
+| `--bdrs--40` | `1rem` | ≒ 16px |
+| `--bdrs--50` | `1.5rem` | ≒ 24px |
 | `--bdrs--99` | `99rem` | 完全な丸（pill） |
-| `--bdrs--inner` | `calc(var(--bdrs, 0px) - var(--p, 0px))` | 内側の角丸（親要素に合わせる） |
+| `--bdrs--inner` | `calc(var(--bdrs, 0px) - var(--p, 0px) + 1px)` | 内側の角丸（親要素に合わせる） |
 
 
 ## 影 (bxsh)
 
-`--shc`（シャドウカラー）と `--shsz--{N}`（シャドウサイズ）を組み合わせて構成される。要素ごとに `--shc` を上書きして再計算したい場合は、`set--bxsh` クラスを併用する。
+要素に近い薄い影と主となる影の2層で構成される。近い側の影は、1段小さいシャドウサイズ `--shsz--{N}` と、`--shc`（シャドウカラー）を50%薄めた `--shc--near` を使う。要素ごとに `--shc` を上書きして再計算したい場合は、`set--bxsh` クラスを併用する（`--shc--near` も `--shc` から再計算される）。
 
 | CSS変数 | 値 |
 | --- | --- |
-| `--bxsh--10` | `var(--shsz--10) var(--shc)` |
-| `--bxsh--20` | `var(--shsz--20) var(--shc)` |
-| `--bxsh--30` | `var(--shsz--30) var(--shc)` |
-| `--bxsh--40` | `var(--shsz--40) var(--shc)` |
-| `--bxsh--50` | `var(--shsz--50) var(--shc)` |
+| `--bxsh--10` | `var(--shsz--5) var(--shc--near), var(--shsz--10) var(--shc)` |
+| `--bxsh--20` | `var(--shsz--10) var(--shc--near), var(--shsz--20) var(--shc)` |
+| `--bxsh--30` | `var(--shsz--20) var(--shc--near), var(--shsz--30) var(--shc)` |
+| `--bxsh--40` | `var(--shsz--30) var(--shc--near), var(--shsz--40) var(--shc)` |
+| `--bxsh--50` | `var(--shsz--40) var(--shc--near), var(--shsz--50) var(--shc)` |
 
 | CSS変数 | 初期値 |
 | --- | --- |
-| `--shadow` | `hsl(220 4% 8% / 12%)` |
+| `--shadow` | `hsl(220 2% 4% / 8%)` |
 | `--shc` | `var(--shadow)` |
+| `--shc--near` | `color-mix(in srgb, var(--shc), transparent 50%)` |
+| `--shsz--5` | `0px 0px 1px` |
 | `--shsz--10` | `0px 1px 3px` |
 | `--shsz--20` | `0px 2px 6px` |
 | `--shsz--30` | `0px 4px 12px` |

package/dist/data/guides/trait-class/has--transition.md

@@ -3,9 +3,24 @@
 `transition` 系のプロパティを CSS 変数経由でセットする Trait クラス。主に `-hov:*` クラスと組み合わせて、ホバー時のスムーズな変化に使う。
 
 - Lism props: `hasTransition`（`<Lism hasTransition>` / `<Box hasTransition>` 等）
+- 文字列を渡すと `--transitionProps` として出力される: `<Box hasTransition="color, opacity">` → `class="has--transition" style="--transitionProps: color, opacity"`
 
 公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class.md#has--transition
 
+## 対象プロパティは明示指定する
+
+`--transitionProps` の初期値は `all` ではなく、色・影・透明度・transform 系・filter 系に限定したリスト。`all` はページ読み込み時やレイアウト変化時に意図しないアニメーション（ちらつき）を起こすため使わない。
+
+実際に変化させるプロパティだけを `--transitionProps`（Lism props では `hasTransition="..."`）で明示指定する。初期値のリストに無いプロパティ（`padding`, `width`, `border-width` 等）を変化させる場合は必ず指定が要る。
+
+```html
+<a class="is--boxLink has--transition -hov:-bxsh" style="--transitionProps: box-shadow; --hov-bxsh: var(--bxsh--40)">...</a>
+```
+
+```jsx
+<BoxLink hasTransition="box-shadow" hov={{ bxsh: '40' }}>...</BoxLink>
+```
+
 ## SCSS 定義
 
 ```scss
@@ -13,7 +28,7 @@
   --duration: var(--transition-duration, 0.25s);
   --ease: ease;
   --delay: 0s;
-  --transitionProps: all;
+  --transitionProps: color, background-color, border-color, box-shadow, scale, rotate, translate, transform, opacity, filter, backdrop-filter;
   transition: var(--duration) var(--ease) var(--delay);
   transition-property: var(--transitionProps);
 }
@@ -23,7 +38,7 @@
 
 | 変数 | 役割 | デフォルト |
 | --- | --- | --- |
-| `--transitionProps` | transition 対象プロパティ | `all` |
+| `--transitionProps` | transition 対象プロパティ | `color, background-color, border-color, box-shadow, scale, rotate, translate, transform, opacity, filter, backdrop-filter` |
 | `--duration` | トランジションの長さ | `var(--transition-duration, 0.25s)` |
 | `--ease` | イージング関数 | `ease` |
 | `--delay` | ディレイ | `0s` |

package/dist/data/guides/trait-class.md

@@ -52,26 +52,15 @@ Lism コンポーネントでは `isContainer`, `isLayer` 等の Props として
 
 | クラス | 用途 | 主な CSS 変数 |
 | --- | --- | --- |
-| `has--transition` | transition プロパティをまとめてセット。主に hoverクラス（`-hov:*`）と組み合わせて使用 | `--transitionProps`, `--duration`, `--ease`, `--delay`（グローバル上書きは `--transition-duration`） |
+| `has--transition` | transition プロパティをまとめてセット。主に hoverクラス（`-hov:*`）と組み合わせて使用。対象プロパティは `--transitionProps` で明示指定する（初期値は `all` ではなく色・影・透明度・transform 系・filter 系に限定） | `--transitionProps`, `--duration`, `--ease`, `--delay`（グローバル上書きは `--transition-duration`） |
 | `has--gutter` | コンテンツの左右に統一した余白（gutter）を設定する | `--gutter`（基準値: `--gutter--base`、初期値 `var(--s30)`） |
 | `has--snap` | `scroll-snap-` 系プロパティを CSS 変数経由でセットできるようにする | `--snapType`, `--snapAlign` 等 |
 | `has--mask` | `--maskImg` 変数と組み合わせて、要素自身にマスクを適用する | `--maskImg`, `--maskPos`（`50%`）, `--maskSize`（`contain`）, `--maskRepeat`（`no-repeat`） |
 
-Lism コンポーネントでは `hasTransition`, `hasGutter`, `hasSnap`, `hasMask` という Props として利用できます（例: `<Lism hasTransition>`）。
+Lism コンポーネントでは `hasTransition`, `hasGutter`, `hasSnap`, `hasMask` という Props として利用できます（例: `<Lism hasTransition>`）。`hasTransition` は文字列も受け付け、`--transitionProps` として出力されます（例: `<Lism hasTransition="color, opacity">`）。
 
 詳細は以下の個別ドキュメントを参照してください:
 - [has--transition](./trait-class/has--transition.md)
 - [has--gutter](./trait-class/has--gutter.md)
 - [has--snap](./trait-class/has--snap.md)
 - [has--mask](./trait-class/has--mask.md)
-
-
-## `is--` と `has--` の判断軸
-
-|  | `is--` | `has--` |
-| --- | --- | --- |
-| 意味 | 〜である（役割・存在の宣言） | 〜を持つ（機能の付与） |
-| CSS 変数 | 必須ではない | 必須（カスタマイズポイント） |
-
-- その要素が **何であるか**（役割）を表すなら → `is--`
-- その要素に **どんな機能を持たせるか**（カスタマイズポイント付き）なら → `has--`

package/dist/data/guides/utility-class.md

@@ -29,8 +29,6 @@ Lism コンポーネントでの `util` prop による指定方法は [component
 | `u--trim` | ハーフレディングのネガティブマージンでテキスト上下の余白を詰める | [`_trim.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_trim.scss) |
 | `u--trimAll` | 直下の子要素（`:empty`, `figure`, `picture`, `video`, `button`, `textarea`, `table` を除く）にハーフレディングトリムを一括適用する除外方式のクラス | [`_trim.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_trim.scss) |
 | `u--cbox` | `--keycolor` を使い `color-mix()` で `--c` / `--bgc` / `--bdc` を自動生成する色付きボックス | [`_cbox.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_cbox.scss) |
-| `u--divide` | Grid / Flex の子要素**間**にのみ `box-shadow` で区切り線を表示する | [`_divide.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_divide.scss) |
-| `u--enclose` | Grid / Flex の各子要素を `box-shadow` で枠囲みし、table セル風に表示する | [`_divide.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_divide.scss) |
 | `u--srOnly` | スクリーンリーダー専用（視覚的に非表示）。`clip-path: inset(50%)` で実装 | [`_srOnly.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_srOnly.scss) |
 | `u--clipText` | テキストで背景をクリッピング（`background-clip: text`） | [`_clipText.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_clipText.scss) |
 
@@ -43,19 +41,12 @@ Lism コンポーネントでの `util` prop による指定方法は [component
 
 <!-- u--trim: テキスト余白の詰め -->
 <p class="u--trim">テキスト...</p>
-
-<!-- u--divide: グリッド子要素間の区切り線 -->
-<div class="l--grid u--divide" style="--gtc: 1fr 1fr">
-  <div>A</div>
-  <div>B</div>
-</div>
 ```
 
 ```jsx
 // JSX での使用（className で指定）
 <Lism className="u--cbox" keycolor="red" bd p="20">...</Lism>
 <Text className="u--trim">テキスト...</Text>
-<Grid className="u--divide" gtc="1fr 1fr">...</Grid>
 ```
 
 
@@ -64,6 +55,7 @@ Lism コンポーネントでの `util` prop による指定方法は [component
 コアには含まれないが、ドキュメントで紹介されている追加ユーティリティの例:
 
 - `u--inlineCenter`: 絵文字やインラインアイコンをテキスト中央に揃える
+- `u--divide` / `u--enclose`: Grid / Flex の子要素間の区切り線・セル枠を `gap` と子要素の `box-shadow` で描く。描画が `border` より粗く、並び方向が切り替わるレイアウトでは `bdw` のブレイクポイント切り替えを優先する
 
 これらは必要に応じて自分で CSS を追加して使用します。
 

package/dist/data/meta.js

@@ -1,6 +1,6 @@
 import { packageVersion } from '../lib/version.js';
 export const meta = {
-    generatedAt: '2026-08-16',
-    sourceCommit: '06107666',
+    generatedAt: '2026-09-02',
+    sourceCommit: 'efc6ab9a',
     docsVersion: packageVersion,
 };