@slexkit/mcp 0.3.2 → 0.4.0

package/README.md

@@ -1,58 +1,85 @@
-# @slexkit/mcp
-
-Read-only MCP server for SlexKit docs, component APIs, examples, and source validation.
-
-## Configure
-
-```json
-{
-  "mcpServers": {
-    "slexkit": {
-      "command": "npx",
-      "args": ["-y", "@slexkit/mcp"]
-    }
-  }
-}
-```
-
-The same command shape works in clients such as Codex, Claude Desktop, and other MCP-compatible agent tools:
-
-```sh
-npx -y @slexkit/mcp
-```
-
-## Tools
-
-The server exposes three read-only tools:
-
-| Tool | Purpose |
-|------|---------|
-| `slexkitDocs` | Search or fetch generated Markdown docs, optionally including `std.*` and `api.*` capability metadata. |
-| `slexkitExamples` | Return component examples or generated templates such as `status`, `calculator`, `stdlib-calculator`, `secure-network-card`, `toolhost-form`, and `host-integration`. |
-| `slexkitValidate` | Parse Slex source and return diagnostics, warnings, component usage, `std.*` usage, and `api.*` usage. |
-
-Example validation request:
-
-```json
-{
-  "name": "slexkitValidate",
-  "arguments": {
-    "source": "{ slex: \"0.1\", namespace: \"demo\", layout: { \"text:message\": { text: \"Hello\" } } }"
-  }
-}
-```
-
-Successful validation returns structured content similar to:
-
-```json
-{
-  "ok": true,
-  "componentUsage": ["text"]
-}
-```
-
-Invalid source returns `ok: false` plus a SlexKit diagnostic with message, location, and excerpt.
-
-## Safety
-
-The MCP server is read-only. It serves bundled docs and generated metadata from the package, validates source text, and writes no project files.
+# @slexkit/mcp
+
+Read-only MCP server for SlexKit docs, component APIs, examples, and source validation.
+
+## Configure
+
+```json
+{
+  "mcpServers": {
+    "slexkit": {
+      "command": "npx",
+      "args": ["-y", "@slexkit/mcp"]
+    }
+  }
+}
+```
+
+The same command shape works in clients such as Codex, Claude Desktop, and other MCP-compatible agent tools:
+
+```sh
+npx -y @slexkit/mcp
+```
+
+## Tools
+
+The server exposes three read-only tools:
+
+| Tool | Purpose |
+|------|---------|
+| `slexkitDocs` | Search or fetch generated Markdown docs, standard artifact JSON, conformance reports, and optional `std.*` / `api.*` capability metadata. |
+| `slexkitExamples` | Return component examples or generated templates such as `status`, `calculator`, `stdlib-calculator`, `secure-network-card`, `toolhost-form`, and `host-integration`. |
+| `slexkitValidate` | Parse Slex source and return diagnostics, warnings, component usage, `std.*` usage, and `api.*` usage. |
+
+Example validation request:
+
+```json
+{
+  "name": "slexkitValidate",
+  "arguments": {
+    "source": "{ slex: \"0.1\", namespace: \"demo\", layout: { \"text:message\": { text: \"Hello\" } } }"
+  }
+}
+```
+
+Successful validation returns structured content similar to:
+
+```json
+{
+  "ok": true,
+  "schemaVersion": "2026-06",
+  "protocolVersion": "0.1",
+  "logicProfileVersion": "0.1",
+  "componentUsage": ["text"]
+}
+```
+
+Invalid source returns `ok: false` plus a SlexKit diagnostic with message, location, and excerpt.
+
+Fetch standard artifacts through `slexkitDocs`:
+
+```json
+{
+  "name": "slexkitDocs",
+  "arguments": {
+    "standardArtifact": "slex-standard-manifest.json"
+  }
+}
+```
+
+Available standard artifacts include `slex-expression.schema.json`, `slex-component-catalog.json`, `slex-logic-profile.json`, `slex-capabilities.catalog.json`, `slex-conformance.json`, and `slex-standard-manifest.json`.
+
+Run the bundled conformance fixtures through `slexkitDocs`:
+
+```json
+{
+  "name": "slexkitDocs",
+  "arguments": {
+    "conformanceReport": true
+  }
+}
+```
+
+## Safety
+
+The MCP server is read-only. It serves bundled docs and generated metadata from the package, validates source text, and writes no project files.

package/dist/data/llms-components.txt

@@ -2,7 +2,7 @@
 
 Use these components inside Markdown `slex` fences. Raw component docs are ordinary `.md` pages that preserve `slex` examples.
 
-Public component count: 29
+Public component count: 28
 
 ## Disclosure
 
@@ -21,11 +21,10 @@ Public component count: 29
 ## Action
 
 - [Button](/docs/components/button.md): `button` - Action trigger.
-- [Submit](/docs/components/submit.md): `submit` - ToolHost submit and ignore controls.
 
 ## Layout
 
-- [Card](/docs/components/card.md): `card` - Bordered grouping container.
+- [Card](/docs/components/card.md): `card` - Grouping container for related content.
 - [Column](/docs/components/column.md): `column` - Vertical layout container.
 - [Grid](/docs/components/grid.md): `grid` - Responsive grid container.
 - [Row](/docs/components/row.md): `row` - Horizontal layout container.
@@ -168,6 +167,7 @@ Since: 0.1.0
 - `title` (string; optional; dynamic): Card title.
 - `icon` (string; optional; static): Icon name shown before the title.
 - `tone` (string; optional; static; values: info, success, warning, danger, muted): Optional semantic tone for the card surface.
+- `variant` (string; optional; static; values: tool): Use tool for ToolHost input cards with compact chrome.
 
 ### Children
 Nested component fields are rendered as child content in field order.
@@ -446,8 +446,10 @@ Since: 0.1.0
 - `icon` (string; optional; static): Icon name shown before the group label.
 - `options` (array; optional; static): Options with label, value, and optional icon.
 - `options[].icon` (string; optional; static): Icon name shown before a single option label.
+- `options[].description` (string; optional; static): Secondary text shown below the option label.
 - `disabled` (boolean; optional; dynamic; default: false): Disable every radio option in the group.
 - `orientation` (string; optional; static; default: "vertical"; values: vertical, horizontal): Radio option layout direction.
+- `variant` (string; optional; static; values: list): Use list for full-row option surfaces in ToolHost decision cards.
 - `haptic` (boolean; optional; static; default: true): Enable vibration feedback on supported devices.
 - `haptics` (boolean; optional; static; default: true): Alias for haptic.
 - `name` (string; optional; static): Native radio group name shared by options.
@@ -469,6 +471,7 @@ Since: 0.1.0
 - `justify` (string; optional; static; default: "start"; values: start, center, end, space-between, space-around): Main-axis distribution.
 - `align` (string; optional; static; default: "center"; values: start, center, end, baseline, stretch): Cross-axis alignment.
 - `gap` (string; optional; dynamic): Spacing between children.
+- `variant` (string; optional; static; values: actions): Use actions for compact ToolHost action rows.
 
 ### Children
 Nested component fields are rendered as child content in field order.
@@ -565,24 +568,6 @@ No child components.
 
 ---
 
-## Submit API (`submit`)
-
-Category: Action
-Status: ready
-State mode: none
-Since: 0.1.0
-
-### Props
-- `submitLabel` (string; optional; static; default: "Submit"): Submit button text.
-- `ignoreLabel` (string; optional; static; default: "Ignore"): Ignore button text.
-- `returnKeys` (string[]; optional; static): State field paths returned to ToolHost.
-- `disabled` (boolean; optional; dynamic; default: false): Disable submit action.
-
-### Children
-No child components.
-
----
-
 ## Switch API (`switch`)
 
 Category: Input