@slexkit/mcp 0.2.0 → 0.3.1

package/dist/data/llms-runtime.txt

@@ -51,7 +51,7 @@ ComponentKey = ComponentType ":" Identifier
 - Named components use `Identifier` for instance state and lifecycle hooks.
 - Keys without `:` are not rendered as component nodes.
 
-Reserved context names: `g`, `api`, `$event`, `$item`, `$index`, `$key`.
+Reserved context names: `g`, `std`, `api`, `$event`, `$item`, `$index`, `$key`.
 
 ## 3. Props classification
 
@@ -108,6 +108,7 @@ Expressions can access these variables:
 | Variable           | Type                          | Scope                    |
 | ------------------ | ----------------------------- | ------------------------ |
 | `g`                | Reactive state proxy          | Always                   |
+| `std`              | Pure SlexKit standard library | Always                   |
 | Component state    | e.g. `slider.value`           | Named components         |
 | `api`              | Host-injected object          | If `api` option provided |
 | `$event`           | Event data                    | `on*` handlers only      |
@@ -116,6 +117,8 @@ Expressions can access these variables:
 | `$key`             | Current item key              | `$for` context only      |
 | Named `$for` alias | e.g. `user` for `"card:user"` | `$for` context only      |
 
+`std` contains deterministic helpers for math, formatting, units, and small statistics. Sensitive capabilities stay under host-injected `api.*` and may require secure runtime policy.
+
 Expression evaluation errors are caught and produce a warning with namespace and path information. The last known value is returned as a fallback.
 
 ## 6. Component instance state
@@ -524,6 +527,7 @@ The `RenderContext` provides:
 | Property | Type | Description |
 |----------|------|-------------|
 | `g` | reactive proxy | Global state |
+| `std` | `SlexKitStdlib` | Pure deterministic helpers |
 | `api` | `Record<string, unknown>` | Host-injected capabilities |
 | `dir` | `"ltr"` or `"rtl"` | Resolved direction |
 | `labels` | `Partial<Record<string, string>>` | Runtime labels |
@@ -591,6 +595,8 @@ type MountOptions = {
 
 Calling `mount()` again on the same `container` clears the old root first, then appends a new root. The returned cleanup only unmounts the current root; it does not delete the namespace store.
 
+Every expression receives `std`, SlexKit's pure deterministic standard library. Hosts can still inject capability objects through `api`, but network, timers, animation, and canvas should remain policy-gated in secure mode.
+
 ### `ingest(input)`
 
 Ingests state-only Slex: updates `g` without rendering UI. Used by the Markdown runtime host for state-only fences. Returns `true` if parsing succeeded.
@@ -943,16 +949,16 @@ The renderer handles `slex` fences. It supports both trusted and secure runtime
 
 ## Obsidian integration
 
-The `@slexkit/obsidian` package registers the `slex` fenced code block processor in Obsidian:
+The official Obsidian plugin lives in <https://github.com/slexkit/obsidian-slexkit> and registers the `slex` fenced code block processor:
 
 ```ts
-// In the Obsidian plugin:
+// In the plugin:
 registerMarkdownCodeBlockProcessor("slex", (source, el, ctx) => { ... });
 ```
 
 The adapter renders blocks in **reading mode only** and does not write back to the vault. Blocks within the same note share a trusted artifact runtime.
 
-**Important**: The Obsidian adapter uses trusted mode because it renders content from the user's login vault. It is not designed as a security boundary for untrusted or agent-generated Markdown.
+**Important**: The Obsidian adapter uses trusted mode because it renders content from the user's local vault. It is not designed as a security boundary for untrusted or agent-generated Markdown.
 
 ## Writing a custom host adapter
 
@@ -1332,7 +1338,6 @@ slexkit (root - real code)
  @slexkit/components-svelte (thin wrapper) ─── re-exports slexkit/components-svelte
  @slexkit/theme-shadcn ─── CSS only
  @slexkit/streamdown ─── React/Streamdown renderer
- @slexkit/obsidian ─── Obsidian plugin
  @slexkit/mcp ─── read-only MCP server for AI agents
 ```
 
@@ -1424,15 +1429,15 @@ export function Message({ markdown }: { markdown: string }) {
 
 Processes `slex` fences. Supports both trusted and secure runtime modes.
 
-## @slexkit/obsidian
+## Obsidian plugin
 
-Obsidian plugin adapter. Registers SlexKit fenced code block processors and renders local vault content in reading mode.
+The official Obsidian plugin lives in a separate release repository: <https://github.com/slexkit/obsidian-slexkit>.
 
-```sh
-npm install slexkit @slexkit/obsidian
-```
+Install **SlexKit** through Obsidian Community Plugins for normal vault use. Use BRAT or manual GitHub release assets only when testing unreleased builds from `slexkit/obsidian-slexkit`.
+
+The community plugin is currently desktop-only and compatible with Obsidian 1.5.0+. Mobile support should be enabled only after real mobile vault testing.
 
-The adapter uses trusted runtime mode -it renders content from the user's local vault and is not designed as a sandbox for third-party or agent-generated Markdown. Obsidian secure sandbox support is not part of the v0 adapter.
+The adapter uses trusted runtime mode - it renders content from the user's local vault and is not designed as a sandbox for third-party or agent-generated Markdown. Secure sandbox support is not part of the v0 adapter.
 
 ## @slexkit/mcp
 
@@ -1453,7 +1458,7 @@ The server does not modify project files. Use it when an agent needs current Sle
 | With Svelte components | `npm install slexkit @slexkit/runtime @slexkit/components-svelte` |
 | Add shadcn theme | `npm install @slexkit/theme-shadcn` |
 | React/Streamdown host | `npm install slexkit @slexkit/theme-shadcn @slexkit/streamdown streamdown react react-dom` |
-| Obsidian plugin | `npm install slexkit @slexkit/obsidian` |
+| Obsidian plugin | Install **SlexKit** from Obsidian Community Plugins |
 | AI agent MCP server | `npx -y @slexkit/mcp` |
 
 ## v0 packaging strategy
@@ -1470,6 +1475,6 @@ bun run test
 bun run smoke:release
 ```
 
-The release smoke packs and installs every scoped package, verifies public entry points, verifies CSS subpath exports, loads the Obsidian CJS bundle with an Obsidian module mock, and starts the MCP stdio binary to check `initialize`, `tools/list`, and `slexkitValidate`.
+The release smoke packs and installs every scoped package in this repository, verifies public entry points, verifies CSS subpath exports, and starts the MCP stdio binary to check `initialize`, `tools/list`, and `slexkitValidate`.
 
 ---

package/dist/data/llms.txt

@@ -5,13 +5,14 @@
 - [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.
 
 SlexKit raw docs are Markdown (`.md`) with explicit `slex` fences. The interactive layer is the fenced `slex` source inside each Markdown page.
 
-Version: 0.2.0
+Version: 0.3.1
 
 ## Table of Contents
 
@@ -24,6 +25,25 @@ Version: 0.2.0
 - [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.
 
+### 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 审核和代理。
+
 ### Components
 - [Accordion](/docs/components/accordion.md): Expandable grouped panels.
 - [Badge](/docs/components/badge.md): Compact label for status or classification.
@@ -35,6 +55,7 @@ Version: 0.2.0
 - [Collapsible](/docs/components/collapsible.md): Single expandable region.
 - [Column](/docs/components/column.md): Vertical layout container.
 - [Divider](/docs/components/divider.md): Visual separator.
+- [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.