@slexkit/mcp 0.3.3 → 0.5.0

package/dist/data/llms-toolhost.txt

@@ -1,295 +1,3 @@
-# SlexKit ToolHost for LLMs
-
-ToolHost is the structured-input path for confirmations, choices, and forms. Do not use it for ordinary display-only UI.
-
-## ToolHost
-
-Raw Markdown: /docs/reference/toolhost.md
-
----
-title: ToolHost
-category: Reference
-status: ready
-order: 70
-summary: "Structured user-input UI for confirmations, choices, forms, templates, and submit boundaries."
-slexkitRenderMode: component
----
-
 # ToolHost
 
-ToolHost bridges AI tool calls to interactive UI. Instead of the AI executing tools server-side, ToolHost renders a structured input form in the browser and returns the user's response as a `ToolResult`.
-
-## Concepts
-
-When an AI model emits a tool call (e.g., `confirm-action`, `fill-form`), ToolHost compiles it into a standard `SlexExpression` and mounts it using the core runtime. The mounted UI has a **submit boundary** (`submit:actions` component) that settles a Promise with the user's input.
-
-ToolHost is **separate from display-oriented `slex` fences**. Display components render information; ToolHost components collect structured user input and return it programmatically.
-
-## Public API
-
-### `renderToolCall(call, container) → ToolRenderHandle`
-
-Compiles a tool call into a SlexExpression, mounts it, and returns a handle.
-
-```ts
-function renderToolCall(call: ToolCall, container: HTMLElement): ToolRenderHandle;
-```
-
-```ts
-type ToolRenderHandle = {
-  promise: Promise<ToolResult>;  // Resolves when user submits or ignores
-  dispose: () => void;           // Clean up the rendered UI
-};
-
-type ToolResult =
-  | { toolCallId?: string; toolName: string; status: "submitted"; value: Record<string, unknown> }
-  | { toolCallId?: string; toolName: string; status: "ignored"; value: null };
-```
-
-**Usage:**
-
-```js
-import { renderToolCall } from "slexkit";
-
-const handle = renderToolCall(
-  {
-    id: "call_001",
-    name: "confirm-action",
-    arguments: {
-      title: "Delete file?",
-      description: "This action cannot be undone.",
-      confirmLabel: "Delete",
-      requireReason: true,
-    },
-  },
-  document.getElementById("tool-container"),
-);
-
-handle.promise.then((result) => {
-  console.log(result.status); // "submitted" or "ignored"
-  console.log(result.value);  // { confirmed: true, reason: "Obsolete file" }
-  handle.dispose();
-});
-```
-
-### `registerToolTemplate(name, compiler)`
-
-Register a custom tool template. The compiler function receives the tool arguments and returns a `SlexExpression`.
-
-```ts
-function registerToolTemplate(name: string, compiler: ToolTemplateCompiler): void;
-
-type ToolTemplateCompiler<TArgs = Record<string, unknown>> = (
-  args: TArgs,
-  runtime: ToolRuntime,
-  call: ToolCall,
-) => SlexExpression;
-
-type ToolRuntime = {
-  submit: (value: Record<string, unknown>) => void;
-  ignore: () => void;
-};
-```
-
-## Built-in templates
-
-### `confirm-action`
-
-Yes/no confirmation dialog. Supports an optional reason field.
-
-**Arguments (`ConfirmActionArguments`):**
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `title` | `string` | `"Confirm action"` | Dialog title |
-| `description` | `string` | — | Optional explanation text |
-| `confirmLabel` | `string` | `"Confirm"` | Submit button label |
-| `ignoreLabel` | `string` | `"Ignore"` | Cancel button label |
-| `requireReason` | `boolean` | `false` | Show a reason text input |
-| `reasonLabel` | `string` | `"Reason"` | Label for the reason input |
-| `reasonPlaceholder` | `string` | `"Add a reason"` | Placeholder for the reason input |
-
-**Result value:**
-
-| Key | Type | Description |
-|-----|------|-------------|
-| `confirmed` | `boolean` | Always `true` when submitted |
-| `reason` | `string` | User's reason text (only if `requireReason: true`) |
-
-**Example:**
-
-```js
-renderToolCall({
-  name: "confirm-action",
-  arguments: {
-    title: "Delete project?",
-    description: "This will permanently delete all files.",
-    confirmLabel: "Delete",
-    requireReason: true,
-  },
-}, container);
-```
-
-### `choose-options` / `option-list`
-
-Single or multi-select option list. `option-list` is an alias for `choose-options` — behavior is identical.
-
-**Arguments (`ChooseOptionsArguments` / `OptionListArguments`):**
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `title` | `string` | `"Choose options"` | Dialog title |
-| `description` | `string` | — | Optional explanation text |
-| `options` / `items` | `OptionListItem[]` | `[]` | List of selectable items |
-| `multiple` | `boolean` | `true` | Allow multiple selection |
-| `selected` | `string[]` | auto | Pre-selected item IDs |
-| `minSelected` | `number` | `0` | Minimum required selections |
-| `maxSelected` | `number` | `Infinity` | Maximum allowed selections |
-| `submitLabel` | `string` | `"Submit"` | Submit button label |
-| `ignoreLabel` | `string` | `"Ignore"` | Cancel button label |
-
-**OptionListItem:**
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `label` | `string` | Display text (required) |
-| `id` | `string` | Unique identifier (defaults to `value` or index) |
-| `value` | `string` | Submitted value (defaults to `id`) |
-| `description` | `string` | Secondary text shown after label |
-| `selected` | `boolean` | Pre-selected state |
-| `disabled` | `boolean` | Disabled state |
-
-**Rendering:**
-- When `multiple: true` (default): renders **checkboxes**
-- When `multiple: false`: renders a **radio group**
-
-**Result value:**
-
-| Key | Type | Description |
-|-----|------|-------------|
-| `selected` | `string[]` | IDs of selected items |
-
-**Example:**
-
-```js
-renderToolCall({
-  name: "choose-options",
-  arguments: {
-    title: "Select dependencies",
-    options: [
-      { id: "react", label: "React", description: "UI library" },
-      { id: "vue", label: "Vue", description: "Progressive framework" },
-      { id: "svelte", label: "Svelte", description: "Compiled framework", selected: true },
-    ],
-    multiple: true,
-    minSelected: 1,
-    maxSelected: 2,
-  },
-}, container);
-```
-
-### `fill-form`
-
-Multi-field form with various field types.
-
-**Arguments (`FillFormArguments`):**
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `title` | `string` | `"Fill form"` | Form title |
-| `description` | `string` | — | Optional explanation text |
-| `fields` | `FormField[]` | `[]` | Form field definitions |
-| `values` | `Record<string, unknown>` | — | Initial field values |
-| `submitLabel` | `string` | `"Submit"` | Submit button label |
-| `ignoreLabel` | `string` | `"Ignore"` | Cancel button label |
-
-**FormField:**
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `name` | `string` | (required) | Field name (used as key in result value) |
-| `type` | `FormFieldType` | `"text"` | Field type |
-| `label` | `string` | `name` | Display label |
-| `description` | `string` | — | Help text below the field |
-| `placeholder` | `string` | — | Input placeholder |
-| `required` | `boolean` | `false` | Require non-empty value to submit |
-| `disabled` | `boolean` | `false` | Disable the field |
-| `value` | `unknown` | — | Initial value |
-| `options` | `Array<{label, value}>` | — | Options for `select` type |
-
-**FormFieldType:**
-
-| Type | Renders | Description |
-|------|---------|-------------|
-| `text` | `<input>` | Free-form text |
-| `number` | `<input type="number">` | Numeric input, value is `number \| null` |
-| `engineering` | `<input>` with SI prefix parsing | Accepts values like `"10kΩ"`, `"100nF"`, `"1.5MegHz"`. Parsed with `parseEngineeringNumber()`. State includes `raw`, `number`, `valid`, `prefix`, `unit`, `normalized` |
-| `select` | `<select>` | Dropdown from `options` array |
-| `checkbox` | Checkbox | Boolean toggle |
-| `switch` | Switch toggle | Boolean toggle (switch style) |
-
-**Result value:**
-
-An object with a key for each field name, containing the submitted value. For `engineering` fields, the raw input string is submitted. For `checkbox`/`switch` fields, a boolean is submitted. For `number` fields, a number or `null` is submitted.
-
-**Example:**
-
-```js
-renderToolCall({
-  name: "fill-form",
-  arguments: {
-    title: "New project",
-    fields: [
-      { name: "name", type: "text", label: "Project name", required: true },
-      { name: "framework", type: "select", label: "Framework", options: [
-        { label: "React", value: "react" },
-        { label: "Svelte", value: "svelte" },
-      ]},
-      { name: "resistance", type: "engineering", label: "Target resistance", placeholder: "e.g. 10kΩ" },
-      { name: "typescript", type: "checkbox", label: "Use TypeScript", value: true },
-    ],
-  },
-}, container);
-```
-
-## Writing a custom template
-
-Implement the `ToolTemplateCompiler` function and register it:
-
-```js
-import { registerToolTemplate, renderToolCall } from "slexkit";
-
-registerToolTemplate("greet-user", (args, runtime, call) => ({
-  namespace: `tool_greet_${Date.now()}`,
-  g: {
-    __slexkitTool: runtime,
-    name: args.name || "World",
-  },
-  layout: {
-    "card:tool": {
-      title: "Greeting",
-      "text:message": { "$content": "'Hello, ' + g.name + '!'" },
-      "submit:actions": {
-        returnKeys: ["name"],
-        submitLabel: args.submitLabel || "OK",
-        ignoreLabel: args.ignoreLabel || "Cancel",
-      },
-    },
-  },
-}));
-
-renderToolCall(
-  { name: "greet-user", arguments: { name: "Alice" } },
-  container,
-);
-```
-
-### Key patterns
-
-1. **`__slexkitTool`** — Set `g.__slexkitTool = runtime` to give expressions access to `submit()` and `ignore()`
-2. **`submit:actions`** — Always include a `submit:actions` component as the completion boundary. Set `returnKeys` to the property names that should be included in the result value
-3. **`canSubmit`** — Add a `g.canSubmit()` method to control the submit button's disabled state
-4. **Unique namespace** — Use a timestamp-based namespace to avoid collisions with other tool calls
-5. **Validation** — Implement validation logic in `g` methods and wire `$disabled` on the submit button
-
----
+ToolHost renders structured tool requests such as confirmation, option selection, and form filling. It is a host-controlled workflow and remains separate from ordinary display-oriented `slex` HTML. Tool results cross an explicit submit/ignore boundary; do not imitate tool submission with arbitrary artifact code.

package/dist/data/llms.txt

@@ -1,90 +1,101 @@
 # SlexKit > Markdown-friendly reactive UI runtime for AI output
 
-## LLM Documentation Files
+Version: 0.5.0
 
-- [Full documentation](/llms-full.txt): all canonical English docs pages in one text file.
-- [Component reference](/llms-components.txt): component docs index plus generated props/state reference.
-- [Runtime docs](/llms-runtime.txt): runtime, host integration, and secure rendering docs.
-- [Capabilities](/llms-capabilities.txt): expression context, `std.*` standard library, and policy-gated `api.*`.
-- [ToolHost docs](/llms-toolhost.txt): structured user-input UI docs.
-- [Authoring rules](/llms-authoring.txt): concise rules for Markdown `slex` fences.
-- [AI manifest](/slexkit-ai-manifest.json): structured page, component, and hash metadata.
+## Machine-readable documentation
 
-SlexKit raw docs are Markdown (`.md`) with explicit `slex` fences. The interactive layer is the fenced `slex` source inside each Markdown page.
-
-Version: 0.3.3
-
-## Table of Contents
+- [Complete documentation](/llms-full.txt)
+- [Custom-element catalog and examples](/llms-components.txt)
+- [Runtime reference](/llms-runtime.txt)
+- [Sandbox SDK and capabilities](/llms-capabilities.txt)
+- [ToolHost reference](/llms-toolhost.txt)
+- [HTML authoring rules](/llms-authoring.txt)
+- [AI documentation manifest](/slexkit-ai-manifest.json)
+- [Standard manifest](/standard/slex-standard-manifest.json)
+- [HTML profile](/standard/slex-html-profile.json)
+- [Custom-element catalog](/standard/slex-custom-elements.catalog.json)
+- [Sandbox SDK](/standard/slex-sandbox-sdk.json)
+- [Static policy](/standard/slex-static-policy.json)
+- [HTML conformance fixtures](/standard/slex-html-conformance.json)
 
 ### Guides
-- [README](/README.md): Root package overview and installation matrix.
-- [SlexKit Introduction](/docs/guides/intro.md): What SlexKit is and where it fits.
-- [Quick Start](/docs/guides/quick-start.md): Install SlexKit and render a first Markdown-friendly Slex source.
-- [Integration](/docs/guides/integration.md): React/Streamdown and Obsidian host plugins for explicit Slex fences.
-- [Design Guidelines](/docs/guides/design.md): Design and authoring guidelines for SlexKit components and docs.
-- [Secure Runtime Setup](/docs/guides/security-runtime.md): Decision and setup guide for rendering untrusted or agent-generated Slex source.
+
 - [AI / Agents](/docs/guides/ai-agents.md): LLM docs, MCP server, skills, and authoring rules for SlexKit agents.
+- [Design Philosophy](/docs/guides/design.md): Design principles for live Markdown, components, and agent-generated UI.
+- [Getting Started](/docs/guides/quick-start.md): Install SlexKit, mount a first fragment, and keep readable Markdown fallback.
+- [Integration](/docs/guides/integration.md): Connect SlexKit to assistant-ui, Streamdown, Tiptap, Obsidian, or a custom Markdown renderer.
+- [Secure Runtime Setup](/docs/guides/security-runtime.md): Run unreviewed user input, third-party Markdown, or agent output in the isolated HTML document host.
+- [SlexKit Introduction](/docs/guides/intro.md): Markdown-friendly reactive UI runtime for explicit slex fences.
 
 ### Examples
-- [你的第一个 SlexKit 卡片](/zh-CN/examples/hello-slexkit.md): 零交互、纯展示的静态卡片，展示 SlexKit 声明式 DSL 的渲染效果。
-- [第一个交互：滑块操控数据](/zh-CN/examples/first-interaction.md): 在 SlexKit 卡片引入 g 对象和第一个滑块交互，体验响应式数据绑定。
-- [多输入协同：两个滑块联动](/zh-CN/examples/multi-input-coordination.md): 两个 slider 相互影响，引入 g 方法、formula 组件和条件渲染。
-- [分支与切换：模式选择器](/zh-CN/examples/tabs-and-branching.md): 用 select 实现场景切换，展示 UI = f(state) 的分支渲染模式。
-- [五险一金计算器](/zh-CN/examples/salary-calculator.md): 输入工资基数和城市，计算五险一金明细，显示个人缴纳、单位缴纳和总计。
-- [软件项目成本估算器](/zh-CN/examples/project-cost-estimator.md): 输入团队规模、开发周期和人员成本，计算项目总成本和人均成本。
-- [分压器计算器](/zh-CN/examples/voltage-divider.md): 输入电压和两个电阻值，计算分压输出，并评估负载效应带来的误差。
-- [RC 低通滤波器](/zh-CN/examples/rc-low-pass-filter.md): 用电阻和电容搭建的频率选择电路，计算截止频率和任意频率下的增益衰减。
-- [波特率误差计算器](/zh-CN/examples/baud-rate-calculator.md): 输入晶振频率和目标波特率，计算 UART 波特率误差百分比，判断通信可靠性。
-- [搜索与过滤表格](/zh-CN/examples/search-filter-table.md): 搜索输入框实时过滤表格行，点击行展开详情，展示 input + 动态 table + collapsible 组合。
-- [项目仪表盘](/zh-CN/examples/project-dashboard.md): 用 section + grid 搭建信息仪表盘，覆盖 Sprint 进度、质量指标和团队健康度的多卡片联动。
-- [ToolHost 表单提问](/zh-CN/examples/form-wizard-steps.md): AI 对话过程中突然需要收集用户信息，弹出表单卡片等待用户提交，提交后显示结果。
-- [技术选型评估](/zh-CN/examples/tech-selection-evaluator.md): 评估不同技术方案的优劣，通过跨 fence 联动实现参数选择、评分分析和结论推荐。
-- [ToolHost 对话演示](/zh-CN/examples/toolhost-demo.md): 展示 SlexKit 的 ToolHost 能力：在 AI 对话流中内嵌交互式表单，收集用户输入后返回结构化 ToolResult。
-- [自建还是外购决策](/zh-CN/examples/roi-estimator.md): 自建还是外购决策矩阵——功能覆盖、成本对比、时间线、风险四维度评估，自动推荐方案。
-- [跨文档状态实验室](/zh-CN/examples/cross-doc-state-lab.md): 展示 SlexKit 最独特的跨 fence 状态共享——文档不同位置的多块 slex 代码共享同一个响应式 g 对象。
-- [JSONPlaceholder 网络请求实验台](/zh-CN/examples/network-policy-fetch-card.md): 用 JSONPlaceholder 演示 secure runtime 如何把用户触发的网络请求交给 host policy 审核和代理。
+
+- [Artifact Shared JSON Lab](/docs/examples/cross-doc-state-lab.md): Publish and subscribe to bounded JSON through artifact-local slex.shared without sharing DOM or module globals.
+- [assistant-ui Integration](/docs/examples/assistant-ui-host.md): assistant-ui adapter for rendering explicit slex fences inside Streamdown text message parts.
+- [Baud Rate Error Calculator](/docs/examples/baud-rate-calculator.md): Enter crystal frequency and target baud rate to calculate UART baud rate error percentage and judge communication reliability.
+- [Branching: Mode Selector](/docs/examples/tabs-and-branching.md): Use select to switch the mode state and render different inputs and results.
+- [Build vs Buy Decision](/docs/examples/roi-estimator.md): A build-vs-buy decision matrix — four-dimension evaluation across feature coverage, cost, timeline, and risk with automatic recommendation.
+- [First Interaction: Button Counter](/docs/examples/first-interaction.md): A button updates a stat through native click handling and live component properties.
+- [First SlexKit Card](/docs/examples/hello-slexkit.md): A static card with text and badge custom elements; no script is required.
+- [JSONPlaceholder Network Request Lab](/docs/examples/network-policy-fetch-card.md): Uses JSONPlaceholder to demonstrate how the secure runtime delegates user-triggered network requests to host policy for review and proxying.
+- [Multi-Input Coordination](/docs/examples/multi-input-coordination.md): An input and slider feed one JavaScript calculation through native input events.
+- [Project Dashboard](/docs/examples/project-dashboard.md): Build an information dashboard with section + grid — covering Sprint progress, quality metrics, and team health with multi-card coordination.
+- [RC Low-Pass Filter](/docs/examples/rc-low-pass-filter.md): A frequency-selective circuit built with a resistor and capacitor — calculate cutoff frequency and gain attenuation at any frequency.
+- [Search and Filter Table](/docs/examples/search-filter-table.md): A search input filters table rows in real time and uses collapsible for row details.
+- [Semantic Details Layout](/docs/examples/tech-selection-evaluator.md): Use native section and details elements when no documented compound custom element matches the content.
+- [Social Insurance Calculator](/docs/examples/salary-calculator.md): Enter a salary and city to calculate China's social insurance breakdown — showing personal contributions, employer contributions, and take-home pay.
+- [Software Project Cost Estimator](/docs/examples/project-cost-estimator.md): Enter team size, development timeline, and per-person cost to calculate total project cost and monthly burn rate.
+- [Streamdown Integration](/docs/examples/streamdown-host.md): A React/Streamdown adapter that takes over explicit slex fences and leaves ordinary Markdown and code blocks to Streamdown.
+- [Tiptap Editor Integration](/docs/examples/tiptap-host.md): A Tiptap CodeBlock adapter that previews explicit slex blocks while preserving ordinary code blocks and Markdown import/export.
+- [ToolHost Form Question](/docs/examples/form-wizard-steps.md): ToolHost renders a form card during a conversation, collects project fields, and submits structured results.
+- [ToolHost Tool Call UI](/docs/examples/toolhost-demo.md): Render a function_call as an inline tool card, then write the submitted result back as function_call_output.
+- [Voltage Divider Calculator](/docs/examples/voltage-divider.md): Enter input voltage and two resistor values to calculate divider output voltage and evaluate load effect error.
 
 ### Components
-- [Accordion](/docs/components/accordion.md): Expandable grouped panels.
+
+- [Accordion](/docs/components/accordion.md): Multi-panel collapse for FAQs or grouped details.
 - [Badge](/docs/components/badge.md): Compact label for status or classification.
-- [Button](/docs/components/button.md): Action trigger.
-- [Callout](/docs/components/callout.md): Highlighted contextual message.
-- [Card](/docs/components/card.md): Bordered grouping container.
-- [Checkbox](/docs/components/checkbox.md): Boolean checkbox input.
-- [Code Block](/docs/components/code-block.md): Formatted code or log block.
-- [Collapsible](/docs/components/collapsible.md): Single expandable region.
-- [Column](/docs/components/column.md): Vertical layout container.
-- [Divider](/docs/components/divider.md): Visual separator.
+- [Button](/docs/components/button.md): Action trigger button.
+- [Callout](/docs/components/callout.md): Highlighted contextual message for notes, warnings, and tips.
+- [Card](/docs/components/card.md): Grouping container for related content.
+- [Checkbox](/docs/components/checkbox.md): Boolean checkbox for confirmations and multi-select.
+- [Code Block](/docs/components/code-block.md): Code or configuration snippet display.
+- [Collapsible](/docs/components/collapsible.md): Single expandable content area.
+- [Column](/docs/components/column.md): Vertical layout container for forms, text, and control groups.
+- [Divider](/docs/components/divider.md): Separator line, optionally with label.
 - [Formula](/docs/components/formula.md): Reactive KaTeX formula display.
-- [Grid](/docs/components/grid.md): Responsive grid container.
-- [Icon](/docs/components/icon.md): Shared icon field capability.
-- [Input](/docs/components/input.md): Text or engineering-value input.
-- [Link](/docs/components/link.md): Inline navigation link.
-- [Playground](/docs/components/playground.md): Interactive source preview.
+- [Grid](/docs/components/grid.md): Responsive equal-width grid for sibling cards, metrics, and field groups.
+- [Icon](/docs/components/icon.md): Shared icon field capability used by all icon-supporting components.
+- [Input](/docs/components/input.md): Single-line text or engineering value input.
+- [Link](/docs/components/link.md): Navigation or lightweight jump action.
+- [Playground](/docs/components/playground.md): Optional HTML editor and isolated preview registered explicitly from slexkit/tooling.
 - [Progress](/docs/components/progress.md): Progress bar.
-- [Radio Group](/docs/components/radio-group.md): Single-choice option group.
-- [Row](/docs/components/row.md): Horizontal layout container.
-- [Section](/docs/components/section.md): Page section with optional heading chrome.
-- [Select](/docs/components/select.md): Dropdown selection input.
+- [Radio Group](/docs/components/radio-group.md): Mutually exclusive radio selection.
+- [Row](/docs/components/row.md): Horizontal layout container for toolbars, status lines, and button groups.
+- [Section](/docs/components/section.md): Page section with title, subtitle, optional action, and content area.
+- [Select](/docs/components/select.md): Single-select dropdown.
 - [Slider](/docs/components/slider.md): Numeric range input.
-- [Stat](/docs/components/stat.md): Metric display.
-- [Submit](/docs/components/submit.md): ToolHost submit and ignore controls.
-- [Switch](/docs/components/switch.md): Boolean switch input.
-- [Table](/docs/components/table.md): Simple data table.
+- [Stat](/docs/components/stat.md): Metric display with label, value, unit, and semantic tone.
+- [Submit](/docs/components/submit.md): ToolHost-only submit action that returns current selection or form values to the host.
+- [Switch](/docs/components/switch.md): Boolean toggle input for instant settings.
+- [Table](/docs/components/table.md): Structured table with columns and rows.
 - [Tabs](/docs/components/tabs.md): Tabbed view switcher.
-- [Text](/docs/components/text.md): Plain text display.
-- [Toast](/docs/components/toast.md): Transient notification.
+- [Text](/docs/components/text.md): Short text output for status, description, and results.
+- [Toast](/docs/components/toast.md): Transient notification with semantic type.
+- [ToolHost Step](/docs/components/step.md): ToolHost-only step page for collecting multiple human inputs inside one function call.
 
 ### Reference
-- [Slex Specification](/docs/reference/spec.md): Public Slex expression envelope, component keys, props, directives, and lifecycle.
-- [Slex Usage Reference](/docs/reference/usage.md): Slex source structure, props, directives, events, theming, custom components, and ToolHost boundaries.
-- [Runtime Model](/docs/reference/runtime.md): Mounting, ingestion, boot, namespace store, lifecycle, and runtime APIs.
-- [Host Integration](/docs/reference/integration.md): Markdown renderers, Streamdown, Obsidian, custom hosts, and artifact lifecycle.
-- [Security Runtime](/docs/reference/security.md): Threat model, sandbox iframe, postMessage bridge, policy, and fail-closed behavior.
-- [Package Boundaries](/docs/reference/packages.md): Package relationships, installation matrix, and packaging strategy.
-- [ToolHost](/docs/reference/toolhost.md): Tool call rendering, built-in templates, custom templates, and submit boundaries.
-- [Icon System](/docs/reference/icons.md): Phosphor icons, custom icon registration, Iconify fallback, and API reference.
-- [Design Rationale](/docs/reference/rationale.md): Why SlexKit uses object literals, expressions, explicit fences, and secure/trusted modes.
+
+- [Design Rationale](/docs/reference/rationale.md): Why SlexKit uses standards-based HTML/JavaScript with an isolated document lifecycle.
+- [Host Integration](/docs/reference/integration.md): HTML document host integration for Streamdown, assistant-ui, Tiptap, note hosts, and custom adapters.
+- [Icon System](/docs/reference/icons.md): Phosphor icons, custom icon registration, Iconify fallback, and component icon usage.
+- [Packages](/docs/reference/packages.md): SlexKit npm package roles, install combinations, publish contents, and release checks.
+- [Runtime Model](/docs/reference/runtime.md): HTML mounting, artifact updates, isolated lifecycle hooks, snapshots, shared JSON state, and static inspection.
+- [Security Runtime Contract](/docs/reference/security.md): Threat model, sandbox iframe deployment, host policy, postMessage bridge, and fail-closed behavior.
+- [Slex HTML Profile html-1](/docs/reference/spec.md): HTML source profile, sandbox SDK, update identity, lifecycle, and static inspection contract.
+- [Slex Standard Artifacts](/docs/reference/standard.md): Generated metadata for the html-1 profile, custom elements, sandbox SDK, static policy, conformance fixtures, and hashes.
+- [Slex Usage Reference](/docs/reference/usage.md): HTML source structure, attributes, live properties, native events, slots, theming, and lifecycle hooks.
+- [ToolHost](/docs/reference/toolhost.md): Structured user-input UI for confirmations, choices, forms, and templates.
 
 ### Releases
+
 - [Changelog](/docs/releases/changelog.md): Release notes and notable changes for SlexKit.