@lism-css/mcp 0.22.0 → 0.24.0

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

@@ -2,12 +2,9 @@
 
 `scroll-snap-*` 系のプロパティを CSS 変数経由でセットする Trait クラス。横スクロールカルーセルなどで子要素のスナップ位置を制御したい時に使う。
 
-## 基本情報
-
-- クラス名: `has--snap`
 - Lism props: `hasSnap`（`<Lism hasSnap>` 等）
-- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/has/_snap.scss
-- 公式ドキュメント: https://lism-css.com/docs/trait-class.md#has--snap
+
+公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class.md#has--snap
 
 ## SCSS 定義
 
@@ -30,39 +27,11 @@
 ## CSS 変数
 
 | 変数 | 役割 | デフォルト |
-|------|------|-----------|
+| --- | --- | --- |
 | `--snapType` | `scroll-snap-type` | `both mandatory` |
 | `--snapAlign` | 子要素の `scroll-snap-align` | `start` |
 | `--snapStop` | 子要素の `scroll-snap-stop` | `normal` |
 
-## Usage
-
-`ov="auto"`（または `overflow: auto`）と一緒に使い、スクロールコンテナとして成立させる必要がある。
-
-```html
-<div class="has--snap -ov:auto -ar:16/9 -bd">
-  <div class="l--frame -ar:16/9 -p:15"><img src="..." /></div>
-  <div class="l--frame -ar:16/9 -p:15"><img src="..." /></div>
-  <div class="l--frame -ar:16/9 -p:15"><img src="..." /></div>
-</div>
-```
-```jsx
-<Box hasSnap ov="auto" ar="16/9" bd>
-  <Frame ar="16/9" p="15"><img src="..." /></Frame>
-  <Frame ar="16/9" p="15"><img src="..." /></Frame>
-  <Frame ar="16/9" p="15"><img src="..." /></Frame>
-</Box>
-```
-
-### スナップ方向を水平だけに限定する例
-
-```html
-<div class="has--snap -ov:auto" style="--snapType: x mandatory">...</div>
-```
-```jsx
-<Box hasSnap ov="auto" style={{ '--snapType': 'x mandatory' }}>...</Box>
-```
-
 ## 関連
 
 - `-ov:*` プロパティクラス — スクロールコンテナ化に必須

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

@@ -2,12 +2,9 @@
 
 `transition` 系のプロパティを CSS 変数経由でセットする Trait クラス。主に `-hov:*` クラスと組み合わせて、ホバー時のスムーズな変化に使う。
 
-## 基本情報
-
-- クラス名: `has--transition`
 - Lism props: `hasTransition`（`<Lism hasTransition>` / `<Box hasTransition>` 等）
-- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/has/_transition.scss
-- 公式ドキュメント: https://lism-css.com/docs/trait-class.md#has--transition
+
+公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class.md#has--transition
 
 ## SCSS 定義
 
@@ -25,48 +22,13 @@
 ## CSS 変数
 
 | 変数 | 役割 | デフォルト |
-|------|------|-----------|
+| --- | --- | --- |
 | `--transitionProps` | transition 対象プロパティ | `all` |
 | `--duration` | トランジションの長さ | `var(--transition-duration, 0.25s)` |
 | `--ease` | イージング関数 | `ease` |
 | `--delay` | ディレイ | `0s` |
 | `--transition-duration` | 全体のデフォルト duration を `:root` などから上書きするためのグローバル変数 | `0.25s` |
 
-## Usage
-
-### 基本：`-hov:*` と組み合わせる
-
-```html
-<div class="has--transition -hov:-c" style="--transitionProps: color; --hov-c: var(--red);">Example</div>
-```
-```jsx
-<Lism hasTransition hov={{c: 'red'}} style={{ '--transitionProps': 'color'}}>Example</Lism>
-```
-
-### `duration` を個別に上書き
-
-```html
-<a class="is--boxLink has--transition -hov:-bdc -bd -p:20" style="--hov-bdc: var(--red); --duration: 0.5s">
-  ...
-</a>
-```
-```jsx
-<BoxLink href="###" hasTransition hov={{ bdc: 'red' }} bd p="20" style={{ '--duration': '.5s' }}>
-  ...
-</BoxLink>
-```
-
-### `box-shadow` を変化させる例
-
-```html
-<a href="###" class="is--boxLink has--transition -bxsh:10 -hov:-bxsh -bd -p:20" style="--hov-bxsh: var(--bxsh--40)">
-  ...
-</a>
-```
-```jsx
-<BoxLink href="###" hasTransition bxsh="10" hov={{ bxsh: '40' }} bd p="20">...</BoxLink>
-```
-
 ## 関連
 
 - [`-hov:*` プロパティクラス](../property-class.md) — ホバー時の変化を定義

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

@@ -2,77 +2,16 @@
 
 ボックス全体をクリック可能なリンク領域にするクラス。
 
-## 基本情報
-
-- クラス名: `is--boxLink`
-- コンポーネント: `<BoxLink>`
-- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_boxLink.scss
-- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--boxLink.md
+公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class/is--boxLink.md
 
 ## 専用Props
 
 | Prop | 説明 |
-|------|------|
+| --- | --- |
 | `href` | リンク先を指定。`href` があれば `<BoxLink>` 自体が `<a>` タグに、なければ `<div>` として出力される（**特殊挙動**） |
 
 通常の `<Lism>` エイリアスコンポーネントと異なり、`<BoxLink>` だけは `href` 指定の有無で出力タグが動的に切り替わります。
 
-## Usage
-
-BoxLink には主に2通りの使い方があります。
-
-### パターン1: `<BoxLink>` 自身を `<a>` にする
-
-`href` を指定すると `<BoxLink>` 自体が `<a>` タグとして出力されます。シンプルなカード全体リンクに最適。
-
-```jsx
-<BoxLink href="/article/1" p="30" bgc="base" bd bdrs="30" hov="-o">
-  <Group fz="xl" fw="bold">Heading text</Group>
-  <Text lh="s" mbs="15">記事の抜粋テキスト...</Text>
-  <Group fz="s" c="text-2" ta="right" lh="1" mbs="10">
-    MORE →
-  </Group>
-</BoxLink>
-```
-
-```html
-<a class="is--boxLink -hov:-o -p:30 -bgc:base -bd -bdrs:30" href="/article/1">
-  <p class="-fz:xl -fw:bold">Heading text</p>
-  <p class="-c:text-2 -lh:s -mbs:15">記事の抜粋テキスト...</p>
-  <p class="-fz:s -c:text-2 -ta:right -lh:1 -mbs:10">MORE →</p>
-</a>
-```
-
-### パターン2: `<div>` + 内部に `is--coverLink`
-
-`<BoxLink>` は `<div>` にしたまま、内部のアンカー要素に `is--coverLink` クラスを付けてボックス全体をクリック可能にします。**BoxLink 内部にさらに別のリンクを配置したい場合はこちらを選ぶこと**。
-
-```jsx
-<BoxLink as="section" p="30" bgc="base" bd bdrs="30" hasTransition hov="-bxsh">
-  <Group fz="xl" fw="bold">
-    <Link isCoverLink href="/article/1">
-      Heading link text
-    </Link>
-  </Group>
-  <Text c="text-2" lh="s" mbs="15">記事の抜粋テキスト...</Text>
-  <Group mbs="10">
-    <a href="/tag/foo" className="-hov:-o">Inner Link</a>
-  </Group>
-</BoxLink>
-```
-
-```html
-<div class="is--boxLink -hov:-bxsh -p:30 -bgc:base -bd -bdrs:30 has--transition">
-  <div class="-fz:xl -fw:bold">
-    <a class="is--coverLink" href="/article/1">Heading link text</a>
-  </div>
-  <p class="-c:text-2 -lh:s -mbs:15">記事の抜粋テキスト...</p>
-  <div class="-mbs:10">
-    <a href="/tag/foo" class="-hov:-o">Inner Link</a>
-  </div>
-</div>
-```
-
 ## Opt-in スタイル
 
 ### Tabキーフォーカス時のアウトラインをボックス全体に広げる

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

@@ -2,43 +2,16 @@
 
 `container-type` を宣言してコンテナクエリを有効にするクラス。レスポンシブ Property Class（`p={['10', '30']}` のような配列指定）を使うとき、基準要素として必要になります。
 
-## 基本情報
-
-- クラス名: `is--container`
-- コンポーネント: `<Container>`
-- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_container.scss
-- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--container.md
+公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class/is--container.md
 
 ## 使い方
 
 `<Container>` は `<Lism isContainer>` のエイリアスです。`isContainer` Prop は他のコンポーネントにも使用できます（例: `<Flow isContainer>`）。
 
 | Prop | 出力 |
-|------|------|
+| --- | --- |
 | `isContainer` | `is--container` |
 
-## Usage
-
-### 使用例
-
-```jsx
-<Container isWrapper="s" p="20">
-  <Box bd p={['10', '30']}>
-    このBOXは、padding が切り替わります
-  </Box>
-</Container>
-```
-
-```html
-<div class="is--container is--wrapper -contentSize:s -p:20">
-  <div class="l--box -bd -p:10 -p_sm" style="--p_sm: var(--s30)">
-    このBOXは、padding が切り替わります
-  </div>
-</div>
-```
-
-子要素側は `p={['10', '30']}` のようなブレイクポイント配列指定にすることで、親の `is--container` を基準としたコンテナクエリで値が切り替わります。
-
 ## `--sz--bleed` の提供
 
 最外側の `is--container` は直下の子要素に `--sz--bleed: 100cqi` をセットします。`-max-sz:bleed` はこの値を参照しており、最外側の `is--container` 基準の幅まで広がります（ネストされた `is--container` は `--sz--bleed` を再上書きしないため、内側の子要素は外側の値を inherit で参照します）。

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

@@ -2,68 +2,12 @@
 
 `position: absolute` で親要素の上に被せて配置するオーバーレイ用クラス。親には `pos="relative"` が必要です。
 
-## 基本情報
-
-- クラス名: `is--layer`
-- コンポーネント: `<Layer>`
-- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_layer.scss
-- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--layer.md
+公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class/is--layer.md
 
 ## 使い方
 
 `<Layer>` は `<Lism isLayer>` のエイリアスです。他コンポーネントにも `isLayer` Prop で付与できます（例: `<Frame isLayer>`）。
 
-## Usage
-
-### 基本的な使い方
-
-親要素に `pos="relative"` を指定し、子に `<Layer>` を置くことで上に重なるオーバーレイになります。
-
-```jsx
-<Box pos="relative" py="40">
-  <Text fz="2xl" fw="bold" ta="center">BACKGROUND</Text>
-  <Layer p="15" bgc="purple:10%">
-    <p>Layer Contents...</p>
-  </Layer>
-</Box>
-```
-
-```html
-<div class="l--box -pos:relative -py:40">
-  <p class="-fz:2xl -fw:bold -ta:center">BACKGROUND</p>
-  <div class="is--layer -p:15 -bgc" style="--bgc: color-mix(in srgb, var(--purple) 10%, transparent)">
-    <p>Layer Contents...</p>
-  </div>
-</div>
-```
-
-### backdrop-filter の活用
-
-`style` プロパティで `backdropFilter` を直接指定すると、背景をブラー・セピアなどの効果で加工できます。
-
-```jsx
-<Frame ar="2/1" pos="relative">
-  <img src="/img/a-1.jpg" alt="" width="960" height="640" />
-  <Layer style={{ backdropFilter: 'contrast(1.1) sepia(0.4)' }} />
-</Frame>
-```
-
-### メディアレイヤー（画像を背景にする）
-
-`<Frame isLayer>` でメディアをレイヤー化して背景画像として配置し、さらに `<Layer>` で暗幕を重ね、本文は `pos="relative"` で上にのせる構成が定番です。
-
-```jsx
-<Box pos="relative" py="50" px="40">
-  <Frame isLayer>
-    <Media src="/img/a-2.jpg" alt="" width="960" height="640" />
-  </Frame>
-  <Layer bgc="black:50%" />
-  <Stack pos="relative" g="30" c="white">
-    <p>本文テキスト...</p>
-  </Stack>
-</Box>
-```
-
 ## 関連プリミティブ
 
 - [l--frame](../primitives/l--frame.md) — `isLayer` 併用でメディア背景のレイヤー化

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

@@ -2,19 +2,14 @@
 
 直下のコンテンツ幅を一括制御するクラス。`max-width` とセンタリングを担い、記事・セクションのコンテンツ幅の統一に使います。
 
-## 基本情報
-
-- クラス名: `is--wrapper`
-- コンポーネント: `<Wrapper>`
-- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_wrapper.scss
-- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--wrapper.md
+公式ドキュメント（使い方・コード例）: https://lism-css.com/docs/trait-class/is--wrapper.md
 
 ## 使い方
 
 `<Wrapper>` は `<Lism isWrapper>` のエイリアスです。`isWrapper` Prop は他のコンポーネントにも使用できます（例: `<Flow isWrapper>`）。
 
 | 指定 | 出力 |
-|------|------|
+| --- | --- |
 | `isWrapper` | `is--wrapper` |
 | `isWrapper="s"` | `is--wrapper -contentSize:s` |
 | `isWrapper="m"` | `is--wrapper -contentSize:m` |
@@ -25,7 +20,7 @@
 ## 専用Props
 
 | Prop | 説明 |
-|------|------|
+| --- | --- |
 | `contentSize` | コンテンツサイズ。`s` / `m` / `l` / `xl` / トークン / 任意値 |
 
 ```jsx
@@ -34,66 +29,22 @@
 <Wrapper contentSize="s" layout="flow" isContainer>...</Wrapper>
 ```
 
-## Usage
-
-### `layout` との組み合わせ
-
-```jsx
-<Wrapper layout="flow" p="20">
-  <p>Content</p>
-  <p>Content</p>
-</Wrapper>
-```
-
-```html
-<div class="l--flow is--wrapper -p:20">
-  <p>Content</p>
-  <p>Content</p>
-</div>
-```
-
-### `contentSize` 指定
-
-```jsx
-<Wrapper contentSize="s" layout="flow" p="20">
-  <p>Content</p>
-  <p>Content</p>
-</Wrapper>
-```
-
-```html
-<div class="l--flow is--wrapper -contentSize:s -p:20">
-  <p>Content</p>
-  <p>Content</p>
-</div>
-```
-
-### 任意値のコンテンツ幅
-
-```jsx
-<Lism isWrapper="20rem" p="20">
-  <div>Contents...</div>
-</Lism>
-```
-
-```html
-<div class="is--wrapper -p:20" style="--contentSize: 20rem">
-  <div>Contents...</div>
-</div>
-```
-
 ## 直下の子要素の挙動
 
 `is--wrapper` 直下の子要素には次のスタイルが当たる：
 
 ```scss
-.is--wrapper > * {
-  inline-size: 100%;
-  max-inline-size: min(100%, var(--contentSize));
-  margin-inline: auto;
+.is--wrapper {
+  --contentSize: var(--sz--m, 100%);
+  > * {
+    inline-size: 100%;
+    max-inline-size: min(100%, var(--contentSize));
+    margin-inline: auto;
+  }
 }
 ```
 
+- `--contentSize` の初期値は `var(--sz--m, 100%)`（`m` 相当）。`-contentSize:s` / `-contentSize:m` / `-contentSize:l` / `-contentSize:xl` のプリセットクラスは `contentSize` Prop の auto-generated 出力から props 層へ自動生成される
 - `inline-size: 100%` により、自然幅が `--contentSize` 未満の要素（短い段落、`<table>` など）も常に親幅まで広げてから `max-inline-size` で制限される。これにより `l--stack` などの flex 縦並び配下でも横幅が揃い、ガタつきが起きない
 - `<table>` を直下に置くと内容依存の自然幅にはならず、常に wrapper 幅まで広がる。テーブルの自然幅を保ちたい場合は `is--wrapper` を直接の親にしないように、間に別の要素を挟む
 

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

@@ -6,8 +6,8 @@ Lism CSS では、要素に対して宣言的に「役割」や「機能」を
 ## TOC
 
 - [プレフィックス一覧](#プレフィックス一覧)
-- [`is--` Trait（役割宣言）](#is-- trait役割宣言)
-- [`has--` Trait（機能付与）](#has-- trait機能付与)
+- [`is--` Trait（役割宣言）](#is---trait役割宣言)
+- [`has--` Trait（機能付与）](#has---trait機能付与)
 
 [詳細](https://lism-css.com/docs/trait-class.md)
 
@@ -16,11 +16,11 @@ Lism CSS では、要素に対して宣言的に「役割」や「機能」を
 ## プレフィックス一覧
 
 | プレフィックス | 種類 | レイヤー | 役割 |
-|--------------|------|---------|------|
+| --- | --- | --- | --- |
 | `is--` | Trait（役割宣言） | `lism-trait` | 要素に「〜である」という役割・存在を宣言する |
 | `has--` | Trait（機能付与） | `lism-trait` | 要素に「〜を持つ」という単一機能を付与する。CSS 変数でカスタマイズ可能 |
 
-併用ルールおよび `is--` / `has--` の判定軸は [css-rules.md](./css-rules.md#プレフィックスとクラス分類) を参照してください。
+併用ルールおよび `is--` / `has--` の判定軸は [css-rules.md](./css-rules.md#クラス分類とプレフィックス) を参照してください。
 
 
 ## `is--` Trait（役割宣言）
@@ -28,7 +28,7 @@ Lism CSS では、要素に対して宣言的に「役割」や「機能」を
 要素に**役割・存在の宣言**を付与するクラスです。他の Primitive / Component と自由に組み合わせられます。
 
 | クラス | 用途 |
-|--------|------|
+| --- | --- |
 | `is--container` | コンテナクエリの基準要素を定義する（`container-type: inline-size`を付与する）。Lism のレスポンシブ機能の判定基準となるラッパーに付与する |
 | `is--wrapper` | 直下の子要素のコンテンツ幅を一括で制限する。`-contentSize:s` / `-contentSize:m` / `-contentSize:l` / `-contentSize:xl` で事前定義したプリセットサイズを指定可能（デフォルト: `--sz--m`）。セクション・ヘッダー・フッター・記事コンテンツなどで、共通したコンテンツ幅を使用する |
 | `is--layer` | 親要素全体に被さる絶対配置レイヤー（`position: absolute; inset: 0;`）。背景画像・カラーオーバーレイ・フィルターレイヤー・コンテンツ等を重ねて表示する |
@@ -51,7 +51,7 @@ Lism コンポーネントでは `isContainer`, `isLayer` 等の Props として
 要素に**単一機能の trait を付与**するクラスです。CSS 変数によりカスタマイズポイントを提供します。
 
 | クラス | 用途 | 主な CSS 変数 |
-|--------|------|--------------|
+| --- | --- | --- |
 | `has--transition` | transition プロパティをまとめてセット。主に hoverクラス（`-hov:*`）と組み合わせて使用 | `--transitionProps`, `--duration`, `--ease`, `--delay`（グローバル上書きは `--transition-duration`） |
 | `has--gutter` | コンテンツの左右に統一した余白（gutter）を設定する | `--gutter`（基準値: `--gutter--base`、初期値 `var(--s30)`） |
 | `has--snap` | `scroll-snap-` 系プロパティを CSS 変数経由でセットできるようにする | `--snapType`, `--snapAlign` 等 |
@@ -68,8 +68,8 @@ Lism コンポーネントでは `hasTransition`, `hasGutter`, `hasSnap`, `hasMa
 
 ## `is--` と `has--` の判断軸
 
-| | `is--` | `has--` |
-|---|---|---|
+|  | `is--` | `has--` |
+| --- | --- | --- |
 | 意味 | 〜である（役割・存在の宣言） | 〜を持つ（機能の付与） |
 | CSS 変数 | 必須ではない | 必須（カスタマイズポイント） |
 

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

@@ -25,7 +25,7 @@ Lism コンポーネントでの `util` prop による指定方法は [component
 以下は `lism-css` コアの CSS に組み込まれているユーティリティクラスです。
 
 | クラス | 用途 | ソースファイル |
-|--------|------|---------------|
+| --- | --- | --- |
 | `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) |

package/dist/data/meta.js

@@ -1,5 +1,6 @@
+import { packageVersion } from '../lib/version.js';
 export const meta = {
-    generatedAt: '2026-05-28',
-    sourceCommit: '3c46037f',
-    docsVersion: '0.1.0',
+    generatedAt: '2026-07-06',
+    sourceCommit: '61898938',
+    docsVersion: packageVersion,
 };

package/dist/index.js

@@ -2,6 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { preloadAll } from './lib/load-data.js';
 import { preloadGuides } from './lib/load-markdown.js';
+import { packageVersion } from './lib/version.js';
 import { registerGetOverview } from './tools/get-overview.js';
 import { registerGetTokens } from './tools/get-tokens.js';
 import { registerGetPropsSystem } from './tools/get-props-system.js';
@@ -14,7 +15,9 @@ async function main() {
     preloadGuides();
     const server = new McpServer({
         name: 'lism-css',
-        version: '0.1.0',
+        version: packageVersion,
+    }, {
+        instructions: 'Documentation server for the Lism CSS framework (lism-css). Recommended workflow: call get_overview FIRST to load foundational context, then use get_component for a known component, get_props_system for a known prop or CSS property, or get_guide for a broad topic. Use search_docs only as a fallback keyword search when other tools do not cover the need. Use convert_css to migrate existing CSS to Lism props in bulk. All tools are read-only. Guide content is written in Japanese.',
     });
     registerGetOverview(server);
     registerGetTokens(server);

package/dist/lib/load-markdown.d.ts

@@ -1,6 +1,10 @@
+/** skills/ を直接参照しているか（= モノレポ開発時）。npm 配布物（dist/data/guides/）を使っている場合は false。 */
+export declare const isRunningFromSource: boolean;
 /** guides/ ディレクトリから Markdown ファイルを読み込む（キャッシュ付き）。
  *  filename にはサブディレクトリを含む posix 区切りの相対パス（例: `primitives/l--flex.md`）を渡せる。 */
 export declare function loadMarkdown(filename: string): string;
+/** Prop 検索用の Markdown（property-class.md + 分冊の all-props.md）を結合して返す */
+export declare function loadPropsMarkdown(): string;
 /** 利用可能なガイドファイル名の一覧（サブディレクトリ配下も含む）を返す */
 export declare function getGuideFilenames(): string[];
 /** 起動時に全ガイドを一括読み込みしてキャッシュに載せる */

package/dist/lib/load-markdown.js

@@ -7,6 +7,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const skillsDir = resolve(__dirname, '..', '..', '..', '..', 'skills', 'lism-css-guide');
 const distDir = resolve(__dirname, '..', 'data', 'guides');
 const guidesDir = existsSync(skillsDir) ? skillsDir : distDir;
+/** skills/ を直接参照しているか（= モノレポ開発時）。npm 配布物（dist/data/guides/）を使っている場合は false。 */
+export const isRunningFromSource = guidesDir === skillsDir;
 const cache = new Map();
 /** guides/ ディレクトリから Markdown ファイルを読み込む（キャッシュ付き）。
  *  filename にはサブディレクトリを含む posix 区切りの相対パス（例: `primitives/l--flex.md`）を渡せる。 */
@@ -18,6 +20,14 @@ export function loadMarkdown(filename) {
     cache.set(filename, content);
     return content;
 }
+// Prop 検索・変換で参照するファイル群。
+// 全 Prop の実テーブルは property-class/all-props.md に分冊されているため、
+// property-class.md 単体では bd 系などの一部しか拾えない（#474）。
+const PROP_SOURCE_FILES = ['property-class.md', 'property-class/all-props.md'];
+/** Prop 検索用の Markdown（property-class.md + 分冊の all-props.md）を結合して返す */
+export function loadPropsMarkdown() {
+    return PROP_SOURCE_FILES.map((filename) => loadMarkdown(filename)).join('\n\n');
+}
 /** guidesDir 配下を再帰的に走査し、`.md` ファイルの相対パス（posix 区切り）を返す */
 function walkMarkdownFiles(dir, baseDir = dir) {
     const results = [];

package/dist/lib/markdown-utils.d.ts

@@ -20,7 +20,7 @@ export interface PropRow {
     cssProperty: string;
     /** 所属する ### セクション名 */
     sectionName: string;
-    /** プリセット値クラス列の生テキスト（例: "-fz:root, -fz:base, ..."） */
+    /** プリセット値クラス列の生テキスト（例: "-fz:base, -fz:5xl, ..."） */
     presetColumn: string;
 }
 /**

package/dist/lib/response.d.ts

@@ -6,9 +6,14 @@ type ToolResult = {
         text: string;
     }[];
     isError?: boolean;
+    structuredContent?: Record<string, unknown>;
 };
 export declare function success(data: Record<string, unknown>): ToolResult;
+/** 候補を提示して次の行動を促す正常応答（isError は付けない）。 */
 export declare function notFound(message: string, extra?: Record<string, unknown>): ToolResult;
 export declare function error(message: string, extra?: Record<string, unknown>): ToolResult;
 export declare function markdownResponse(text: string): ToolResult;
+/** ガイド/データ読み込み失敗時の共通エラー。
+ *  npx 配布環境のユーザーに「pnpm build して」という実行不可能な指示を出さないよう、実行環境で文言を分ける */
+export declare function loadFailureError(what: string, e: unknown): ToolResult;
 export {};

package/dist/lib/response.js

@@ -1,4 +1,5 @@
 import { meta } from '../data/meta.js';
+import { isRunningFromSource } from './load-markdown.js';
 export const READ_ONLY_ANNOTATIONS = {
     readOnlyHint: true,
     destructiveHint: false,
@@ -6,13 +7,16 @@ export const READ_ONLY_ANNOTATIONS = {
     openWorldHint: false,
 };
 export function success(data) {
+    const payload = { meta, ...data };
     return {
-        content: [{ type: 'text', text: JSON.stringify({ meta, ...data }, null, 2) }],
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
     };
 }
+/** 候補を提示して次の行動を促す正常応答（isError は付けない）。 */
 export function notFound(message, extra) {
     return {
-        content: [{ type: 'text', text: JSON.stringify({ meta, error: message, ...extra }, null, 2) }],
+        content: [{ type: 'text', text: JSON.stringify({ meta, message, ...extra }, null, 2) }],
     };
 }
 export function error(message, extra) {
@@ -26,3 +30,12 @@ export function markdownResponse(text) {
         content: [{ type: 'text', text }],
     };
 }
+/** ガイド/データ読み込み失敗時の共通エラー。
+ *  npx 配布環境のユーザーに「pnpm build して」という実行不可能な指示を出さないよう、実行環境で文言を分ける */
+export function loadFailureError(what, e) {
+    const detail = e instanceof Error ? e.message : String(e);
+    const hint = isRunningFromSource
+        ? 'Run "pnpm build" in packages/mcp and retry.'
+        : 'The bundled data may be missing or corrupted — try reinstalling @lism-css/mcp (e.g. "npx -y @lism-css/mcp@latest").';
+    return error(`Failed to load ${what}: ${detail}. ${hint}`);
+}

package/dist/lib/schemas.d.ts

@@ -1,4 +1,17 @@
 import { z } from 'zod';
+export declare const MetaInfoSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    sourceCommit: z.ZodString;
+    docsVersion: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    generatedAt: string;
+    sourceCommit: string;
+    docsVersion: string;
+}, {
+    generatedAt: string;
+    sourceCommit: string;
+    docsVersion: string;
+}>;
 export declare const DocsEntrySchema: z.ZodObject<{
     sourcePath: z.ZodString;
     title: z.ZodString;
@@ -24,3 +37,25 @@ export declare const DocsEntrySchema: z.ZodObject<{
     keywords: string[];
     snippet: string;
 }>;
+export declare const SearchResultSchema: z.ZodObject<{
+    sourcePath: z.ZodString;
+    url: z.ZodString;
+    heading: z.ZodString;
+    snippet: z.ZodString;
+    score: z.ZodNumber;
+    nextTool: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sourcePath: string;
+    snippet: string;
+    url: string;
+    heading: string;
+    score: number;
+    nextTool: string | null;
+}, {
+    sourcePath: string;
+    snippet: string;
+    url: string;
+    heading: string;
+    score: number;
+    nextTool: string | null;
+}>;