slexkit 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to SlexKit.
 
+## v0.3.1 - Host stability and control rendering hardening
+
+### Added
+- Runtime style safety tests that block broad `:has()` selectors, `clip-path`, and slider track regressions in shipped CSS.
+- Regression coverage for disabled Switch, Checkbox, and Radio state attributes.
+
+### Changed
+- CI now installs dependencies with `bun install --frozen-lockfile` and runs lint before tests.
+- Disabled Switch, Checkbox, and Radio styling now uses explicit `data-disabled` attributes instead of broad relational selectors.
+- Select and sr-only helper styles avoid `clip-path` for better host and Obsidian CSS compatibility.
+
+### Fixed
+- Slider thumb rendering artifacts caused by painting the range track on the native input box.
+- Input focus visibility after removing custom engineering steppers.
+- Home RC example input labels now use native Input component labels instead of separate text labels.
+- Stat cards no longer clip updated text during cross-document state examples.
+- Markdown calculator examples no longer render duplicate section labels.
+
 ## v0.3.0 - Examples overhaul with component audit and i18n
 
 ### Added

package/README.md

@@ -15,7 +15,7 @@
     <a href="README.zh-CN.md">简体中文</a>
   </p>
   <p>
-    <img alt="version" src="https://img.shields.io/badge/version-0.2.0-18181b">
+    <img alt="version" src="https://img.shields.io/badge/version-0.3.1-18181b">
     <img alt="script" src="https://img.shields.io/badge/Slex-v0.1-18181b">
     <img alt="TypeScript" src="https://img.shields.io/badge/runtime-TypeScript-3178c6">
     <img alt="Svelte 5" src="https://img.shields.io/badge/components-Svelte_5-ff3e00">
@@ -31,6 +31,8 @@ It is built for chat messages, documents, agent panels, tool results, and AI-aut
 
 ## Installation
 
+> Just want to use SlexKit in Obsidian? Open **Settings -> Community plugins**, search for **SlexKit**, then install and enable it. The npm package below is for developers integrating SlexKit into web apps, Markdown renderers, Streamdown, or custom hosts.
+
 ```sh
 npm install slexkit
 ```
@@ -115,7 +117,6 @@ Markdown platforms without SlexKit support show the fallback text. Hosts with Sl
 | `@slexkit/components-svelte` | `npm install slexkit @slexkit/runtime @slexkit/components-svelte` | Svelte component registration |
 | `@slexkit/theme-shadcn` | `npm install @slexkit/theme-shadcn` | CSS theme tokens |
 | `@slexkit/streamdown` | `npm install slexkit @slexkit/theme-shadcn @slexkit/streamdown streamdown react react-dom` | React / Streamdown Markdown renderer |
-| `@slexkit/obsidian` | `npm install slexkit @slexkit/obsidian` | Obsidian plugin adapter |
 | `@slexkit/mcp` | `npx -y @slexkit/mcp` | Read-only MCP server for docs, examples, and source validation |
 
 See [Package Boundaries](site/content/reference/packages/en-US.md) for details.
@@ -127,7 +128,7 @@ See [Package Boundaries](site/content/reference/packages/en-US.md) for details.
 | Browser DOM | `mount()`, `ingest()`, `boot()`, `disposeNamespace()` |
 | Markdown renderers | `createSlexKitMarkdownRuntimeHost()` |
 | React / Streamdown | `@slexkit/streamdown` |
-| Obsidian | `@slexkit/obsidian` |
+| Obsidian | Install **SlexKit** from Community Plugins; release repo: <https://github.com/slexkit/obsidian-slexkit> |
 | AI agents | `@slexkit/mcp`, `llms.txt`, SlexKit skill docs |
 | Custom components | `register()`, `registerSvelteComponent()`, `registerSubset()` |
 

package/README.zh-CN.md

@@ -15,7 +15,7 @@
     <a href="README.md">English</a>
   </p>
   <p>
-    <img alt="version" src="https://img.shields.io/badge/version-0.2.0-18181b">
+    <img alt="version" src="https://img.shields.io/badge/version-0.3.1-18181b">
     <img alt="script" src="https://img.shields.io/badge/Slex-v0.1-18181b">
     <img alt="TypeScript" src="https://img.shields.io/badge/runtime-TypeScript-3178c6">
     <img alt="Svelte 5" src="https://img.shields.io/badge/components-Svelte_5-ff3e00">
@@ -31,6 +31,8 @@
 
 ## 安装
 
+> 只想在 Obsidian 里使用 SlexKit？打开 **Settings -> Community plugins**，搜索 **SlexKit**，安装并启用即可。下面的 npm 安装方式主要面向需要把 SlexKit 接入网页、Markdown renderer、Streamdown 或自定义宿主的开发者。
+
 ```sh
 npm install slexkit
 ```
@@ -115,7 +117,6 @@ import "slexkit/style.css";
 | `@slexkit/components-svelte` | `npm install slexkit @slexkit/runtime @slexkit/components-svelte` | Svelte 组件注册 |
 | `@slexkit/theme-shadcn` | `npm install @slexkit/theme-shadcn` | CSS 主题 token |
 | `@slexkit/streamdown` | `npm install slexkit @slexkit/theme-shadcn @slexkit/streamdown streamdown react react-dom` | React / Streamdown Markdown 渲染器 |
-| `@slexkit/obsidian` | `npm install slexkit @slexkit/obsidian` | Obsidian 插件适配器 |
 | `@slexkit/mcp` | `npx -y @slexkit/mcp` | 面向文档、示例和源码校验的只读 MCP 服务 |
 
 更多说明见 [Package Boundaries](site/content/reference/packages/zh-CN.md)。
@@ -127,7 +128,7 @@ import "slexkit/style.css";
 | 浏览器 DOM | `mount()`、`ingest()`、`boot()`、`disposeNamespace()` |
 | Markdown 渲染器 | `createSlexKitMarkdownRuntimeHost()` |
 | React / Streamdown | `@slexkit/streamdown` |
-| Obsidian | `@slexkit/obsidian` |
+| Obsidian | 从 Community Plugins 安装 **SlexKit**；发布仓库：<https://github.com/slexkit/obsidian-slexkit> |
 | AI Agents | `@slexkit/mcp`、`llms.txt`、SlexKit skill 文档 |
 | 自定义组件 | `register()`、`registerSvelteComponent()`、`registerSubset()` |
 

package/dist/ai/llms-components.txt

@@ -355,7 +355,6 @@ Since: 0.1.0
 - `min` (string | number; optional; dynamic): Minimum value used by numeric input controls.
 - `max` (string | number; optional; dynamic): Maximum value used by numeric input controls.
 - `step` (string | number; optional; dynamic): Step size used by numeric input controls.
-- `controls` (boolean; optional; dynamic; default: true): Show decrement and increment buttons for numeric inputs.
 - `onchange` (write-expression; optional; static): Write expression invoked when the value changes.
 
 ### Children
@@ -655,6 +654,8 @@ Since: 0.1.0
 - `content` (string; optional; dynamic): Alias for text.
 - `label` (string; optional; dynamic): Alias for text.
 - `variant` (string; optional; static; default: "default"; values: default, muted): Text visual variant.
+- `color` (string; optional; dynamic): Optional CSS color for controlled previews.
+- `size` (string | number; optional; dynamic): Optional font size. Numbers are treated as px.
 - `class` (string; optional; static): Additional host-controlled CSS class.
 
 ### Children

package/dist/ai/llms-full.txt

@@ -1,6 +1,6 @@
 # SlexKit Full LLM Documentation
 
-Version: 0.3.0
+Version: 0.3.1
 
 This file concatenates SlexKit's canonical English Markdown docs. `slex` fences are preserved exactly.
 
@@ -27,7 +27,7 @@ Source: README.md
     <a href="README.zh-CN.md">简体中文</a>
   </p>
   <p>
-    <img alt="version" src="https://img.shields.io/badge/version-0.2.0-18181b">
+    <img alt="version" src="https://img.shields.io/badge/version-0.3.1-18181b">
     <img alt="script" src="https://img.shields.io/badge/Slex-v0.1-18181b">
     <img alt="TypeScript" src="https://img.shields.io/badge/runtime-TypeScript-3178c6">
     <img alt="Svelte 5" src="https://img.shields.io/badge/components-Svelte_5-ff3e00">
@@ -43,6 +43,8 @@ It is built for chat messages, documents, agent panels, tool results, and AI-aut
 
 ## Installation
 
+> Just want to use SlexKit in Obsidian? Open **Settings -> Community plugins**, search for **SlexKit**, then install and enable it. The npm package below is for developers integrating SlexKit into web apps, Markdown renderers, Streamdown, or custom hosts.
+
 ```sh
 npm install slexkit
 ```
@@ -127,7 +129,6 @@ Markdown platforms without SlexKit support show the fallback text. Hosts with Sl
 | `@slexkit/components-svelte` | `npm install slexkit @slexkit/runtime @slexkit/components-svelte` | Svelte component registration |
 | `@slexkit/theme-shadcn` | `npm install @slexkit/theme-shadcn` | CSS theme tokens |
 | `@slexkit/streamdown` | `npm install slexkit @slexkit/theme-shadcn @slexkit/streamdown streamdown react react-dom` | React / Streamdown Markdown renderer |
-| `@slexkit/obsidian` | `npm install slexkit @slexkit/obsidian` | Obsidian plugin adapter |
 | `@slexkit/mcp` | `npx -y @slexkit/mcp` | Read-only MCP server for docs, examples, and source validation |
 
 See [Package Boundaries](site/content/reference/packages/en-US.md) for details.
@@ -139,7 +140,7 @@ See [Package Boundaries](site/content/reference/packages/en-US.md) for details.
 | Browser DOM | `mount()`, `ingest()`, `boot()`, `disposeNamespace()` |
 | Markdown renderers | `createSlexKitMarkdownRuntimeHost()` |
 | React / Streamdown | `@slexkit/streamdown` |
-| Obsidian | `@slexkit/obsidian` |
+| Obsidian | Install **SlexKit** from Community Plugins; release repo: <https://github.com/slexkit/obsidian-slexkit> |
 | AI agents | `@slexkit/mcp`, `llms.txt`, SlexKit skill docs |
 | Custom components | `register()`, `registerSvelteComponent()`, `registerSubset()` |
 
@@ -320,6 +321,8 @@ slexkitRenderMode: component
 
 # Getting Started
 
+> Just want to install the Obsidian plugin? Open **Settings -> Community plugins**, search for **SlexKit**, then install and enable it. The rest of this page is for developers integrating SlexKit into web apps, Markdown hosts, Streamdown, or custom runtimes.
+
 Install `slexkit`, mount a trusted fragment, and you're off. Hand off Markdown / React / Obsidian details to dedicated guides — this page keeps the core integration path focused.
 
 ## Installation Entry
@@ -343,7 +346,7 @@ For clearer package boundaries, choose scoped packages by host:
 | Official Svelte component registration | `npm install slexkit @slexkit/runtime @slexkit/components-svelte` |
 | Standalone shadcn-token theme CSS | `npm install @slexkit/theme-shadcn` |
 | React + Streamdown Markdown host | `npm install slexkit @slexkit/theme-shadcn @slexkit/streamdown streamdown react react-dom` |
-| Obsidian vault rendering | `npm install slexkit @slexkit/obsidian` |
+| Obsidian vault rendering | Install **SlexKit** from Obsidian Community Plugins |
 
 `@slexkit/runtime` and `@slexkit/components-svelte` are thin wrappers around the root package, not independent implementations.
 
@@ -458,17 +461,17 @@ slexkitRenderMode: component
 
 # Integration
 
-SlexKit ships two official plugins: Streamdown and Obsidian. Both process only explicit `slex` fences — they don't scan ordinary JavaScript, JSON, or unlabeled code blocks. For the full API and host contract, see the [Host Integration reference](/docs/reference/integration).
+SlexKit ships the Streamdown package in this repository and maintains the official Obsidian plugin in a separate release repository. Both integrations process only explicit `slex` fences — they don't scan ordinary JavaScript, JSON, or unlabeled code blocks. For the full API and host contract, see the [Host Integration reference](/docs/reference/integration).
 
 ## Plugin Selection
 
 | Host | Package | Use case | Runtime boundary |
 |---|---|---|---|
 | React / Streamdown | `@slexkit/streamdown` | Chat messages, AI output, React Markdown pages | trusted or secure |
-| Obsidian | `@slexkit/obsidian` | Slex fences in local vault reading mode | trusted readonly |
+| Obsidian | `slexkit/obsidian-slexkit` | Slex fences in local vault reading mode | trusted readonly |
 | Custom Markdown host | `slexkit` | Product-specific Markdown renderer or document viewer | trusted or secure |
 
-Use the packaged plugin when the host is Streamdown or Obsidian. Use `createSlexKitMarkdownRuntimeHost` directly for custom Markdown renderers.
+Use the packaged plugin when the host is Streamdown. Use the separate [SlexKit plugin repository](https://github.com/slexkit/obsidian-slexkit) for Obsidian installs and releases. Use `createSlexKitMarkdownRuntimeHost` directly for custom Markdown renderers.
 
 Package installation details and release boundaries are tracked in [Package Boundaries](/docs/reference/packages).
 
@@ -559,15 +562,26 @@ The secure runtime deployment checklist lives in [Secure Runtime Setup](security
 
 ## Obsidian
 
+> If your goal is only to install the Obsidian plugin, you do not need the developer integration material above. Search for **SlexKit** in Obsidian **Community plugins**, then install and enable it.
+
 The Obsidian plugin targets local vault content. It registers a `slex` code block processor in reading mode, renders the fence as a readonly interactive fragment, and does not write output back to notes.
 
-Build the plugin:
+Install the plugin from Obsidian Community Plugins:
 
-```sh
-bun run --filter @slexkit/obsidian build
+1. Open **Settings -> Community plugins**.
+2. Disable **Restricted mode** if needed.
+3. Search for **SlexKit**.
+4. Install and enable the plugin.
+
+The current community release is desktop-only until mobile vault testing is complete. The plugin is compatible with Obsidian 1.5.0+.
+
+BRAT and manual release assets remain useful for testing unreleased builds:
+
+```text
+BRAT repository: https://github.com/slexkit/obsidian-slexkit
 ```
 
-Copy release assets into the vault:
+Manual installs copy the GitHub release assets into the vault:
 
 ```text
 .obsidian/plugins/slexkit/
@@ -603,7 +617,7 @@ Blocks in the same note share one Markdown artifact runtime, so a state-only fen
 
 ## Obsidian Boundary
 
-`@slexkit/obsidian` v0 is a trusted readonly adapter. Content comes from the user's local vault; the plugin is not a sandbox for third-party Markdown or agent output.
+The official plugin is a trusted readonly adapter. Content comes from the user's local vault; the plugin is not a sandbox for third-party Markdown or agent output.
 
 For untrusted content, use secure mode in a web host with an explicit sandbox frame and host policy.
 
@@ -1058,7 +1072,7 @@ For exact policy fields and allowed adapter hooks, use the [Security Runtime Con
 
 `@slexkit/streamdown` can run trusted or secure. Use secure mode for chat messages and agent output unless the message source is already trusted by the host.
 
-`@slexkit/obsidian` v0 is a trusted readonly adapter for local vault content. It should not be used as the isolation boundary for third-party Markdown or direct agent output.
+The official Obsidian plugin is a trusted readonly adapter for local vault content. It should not be used as the isolation boundary for third-party Markdown or direct agent output.
 
 Custom Markdown hosts should still process only fences whose language is exactly `slex` and should preserve readable Markdown fallback for non-SlexKit environments.
 
@@ -1347,7 +1361,7 @@ Source: content/examples/first-interaction/zh-CN.md
           step: 1,
           onchange: "g.count = Number($event)"
         },
-        "stat:count": { label: "当前数值", "$value": "g.count" },
+        "stat:countStat": { label: "当前数值", "$value": "g.count" },
         "badge:level": {
           "$label": "g.count < 30 ? '低' : g.count < 70 ? '中' : '高'",
           "$tone": "g.count < 30 ? 'success' : g.count < 70 ? 'warning' : 'danger'"
@@ -1537,7 +1551,6 @@ Source: content/examples/salary-calculator/zh-CN.md
   },
   layout: {
     "section:salary": {
-      eyebrow: "计算器",
       title: "五险一金计算器",
       subtitle: "输入税前工资和城市，实时计算五险一金明细。",
       "grid:params": {
@@ -1642,7 +1655,6 @@ Source: content/examples/project-cost-estimator/zh-CN.md
   },
   layout: {
     "section:estimator": {
-      eyebrow: "计算器",
       title: "软件项目成本估算器",
       subtitle: "输入团队配置和周期，成本自动算出来。",
       "card:estimator": {
@@ -1762,7 +1774,6 @@ Source: content/examples/voltage-divider/zh-CN.md
   },
   layout: {
     "section:divider": {
-      eyebrow: "计算器",
       title: "分压器计算器",
       subtitle: "两个电阻串联，从中间引出电压。",
       "card:divider": {
@@ -1845,7 +1856,6 @@ $$|H(f)| = \frac{1}{\sqrt{1 + (f/f_c)^2}}$$
   },
   layout: {
     "section:params": {
-      eyebrow: "计算器",
       title: "RC 低通滤波器",
       subtitle: "一个电阻加一个电容，把高频噪声滤掉。",
       "card:params": {
@@ -1961,8 +1971,7 @@ $$Error = \frac{|BR_{actual} - BR_{target}|}{BR_{target}} \times 100\%$$
     tone: function () { var e = this.error(); return e < 0.5 ? "success" : e < 2 ? "info" : e < 5 ? "warning" : "danger"; }
   },
   layout: {
-    "section:baud": {
-      eyebrow: "计算器",
+    "section:baudCalculator": {
       title: "波特率误差计算器",
       subtitle: "输入晶振频率和目标波特率，计算误差。",
       "card:baud": {
@@ -2155,7 +2164,7 @@ Source: content/examples/project-dashboard/zh-CN.md
         "card:sprint": {
           title: "Sprint 进度",
           "progress:sp": { label: "完成度", "$value": "g.sprintProgress" },
-          "stat:scope": { "$label": "范围状态", "$value": "g.scopeStatus()" },
+          "stat:scope": { label: "范围状态", "$value": "g.scopeStatus()" },
           "badge:flag": { "$label": "g.scope === 'on-track' ? '正常' : g.scope === 'at-risk' ? '⚠ 预警' : '🚨 偏离'", "$tone": "g.scope === 'on-track' ? 'success' : g.scope === 'at-risk' ? 'warning' : 'danger'" }
         },
         "card:quality": {
@@ -2630,7 +2639,10 @@ Source: content/examples/cross-doc-state-lab/zh-CN.md
   layout: {
     "card:a": {
       title: "观察面板 A — 纯文本样式",
-      "stat:size": { "$label": "'字体大小：' + g.size + 'px'", "$value": "g.color" },
+      "column:stylePreview": {
+        "text:styleMeta": { "$text": "'字体大小：' + g.size + 'px'" },
+        "text:styledValue": { "$text": "g.color", "$color": "g.color", "$size": "g.size" }
+      },
       "callout:preview": {
         "$tone": "g.theme === 'dark' ? 'danger' : g.theme === 'info' ? 'info' : 'success'",
         "$text": "g.theme === 'dark' ? '暗色模式：适合夜间阅读的配色方案。' : g.theme === 'info' ? '信息模式：用于强调技术细节。' : '明亮模式：默认的文档阅读配色。'"
@@ -4090,8 +4102,8 @@ Single-line text input with controlled value, placeholder, label, description, n
 - Related components: `select` for option selection, `slider` for numeric ranges.
 - Typically placed inside a `column` to compose forms.
 - Use `$value` and `onchange` for state binding.
-- Numeric inputs show decrement and increment buttons by default. Use `step`, `min`, and `max` to define quick-adjust behavior, or set `controls: false` to hide them.
-- `onchange` fires when the user edits the value or clicks a step control.
+- Numeric and engineering inputs render only the native input. Use `slider` for range adjustment; SlexKit no longer adds custom decrement or increment buttons.
+- `onchange` fires when the user edits the value.
 - `type: "number"` still emits a string value. Convert with `Number($event)` or use `type: "engineering"` to read parsed results.
 - Use `invalid` plus `error` for validation feedback. Error text is linked through `aria-describedby`.
 
@@ -4158,7 +4170,7 @@ Supports scientific notation and SI prefixes: `p`, `n`, `u`, `µ`, `m`, `k`, `K`
 
 ## API Reference {#api}
 
-<!-- slex:spec-api:start component="input" sourceHash="08bdd046" -->
+<!-- slex:spec-api:start component="input" sourceHash="a1afe57e" -->
 | Field | Type | Required | Dynamic | Default | Description |
 |---|---|---|---|---|---|
 | `value` | string | No | Yes |  | Current input value. |
@@ -4181,7 +4193,6 @@ Supports scientific notation and SI prefixes: `p`, `n`, `u`, `µ`, `m`, `k`, `K`
 | `min` | string \| number | No | Yes |  | Minimum value used by numeric input controls. |
 | `max` | string \| number | No | Yes |  | Maximum value used by numeric input controls. |
 | `step` | string \| number | No | Yes |  | Step size used by numeric input controls. |
-| `controls` | boolean | No | Yes | `true` | Show decrement and increment buttons for numeric inputs. |
 | `onchange` | write-expression | No | No |  | Write expression invoked when the value changes. |
 <!-- slex:spec-api:end -->
 
@@ -5256,13 +5267,15 @@ Output text content for status messages, descriptions, and result display.
 
 ## API Reference {#api}
 
-<!-- slex:spec-api:start component="text" sourceHash="32589fbc" -->
+<!-- slex:spec-api:start component="text" sourceHash="745fea9a" -->
 | Field | Type | Required | Dynamic | Default | Description |
 |---|---|---|---|---|---|
 | `text` | string | No | Yes |  | Displayed text. |
 | `content` | string | No | Yes |  | Alias for text. |
 | `label` | string | No | Yes |  | Alias for text. |
 | `variant` | string: default, muted | No | No | `"default"` | Text visual variant. |
+| `color` | string | No | Yes |  | Optional CSS color for controlled previews. |
+| `size` | string \| number | No | Yes |  | Optional font size. Numbers are treated as px. |
 | `class` | string | No | No |  | Additional host-controlled CSS class. |
 <!-- slex:spec-api:end -->
 
@@ -6322,16 +6335,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
 
@@ -6715,7 +6728,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
 ```
 
@@ -6807,15 +6819,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
 
@@ -6836,7 +6848,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
@@ -6853,7 +6865,7 @@ 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`.
 
 ---
 
@@ -7489,7 +7501,7 @@ A generation should include a plain Markdown fallback so the output degrades gra
 
 ~~~~md
 ```slex
-{ namespace: "status", ... }
+{ namespace: "status", layout: { "badge:state": { label: "3/4 complete", tone: "info" } } }
 ```
 
 **Status:** 3/4 complete
@@ -7562,6 +7574,24 @@ slexkitRenderMode: component
 
 All notable changes to SlexKit.
 
+## v0.3.1 - Host stability and control rendering hardening
+
+### Added
+- Runtime style safety tests that block broad `:has()` selectors, `clip-path`, and slider track regressions in shipped CSS.
+- Regression coverage for disabled Switch, Checkbox, and Radio state attributes.
+
+### Changed
+- CI now installs dependencies with `bun install --frozen-lockfile` and runs lint before tests.
+- Disabled Switch, Checkbox, and Radio styling now uses explicit `data-disabled` attributes instead of broad relational selectors.
+- Select and sr-only helper styles avoid `clip-path` for better host and Obsidian CSS compatibility.
+
+### Fixed
+- Slider thumb rendering artifacts caused by painting the range track on the native input box.
+- Input focus visibility after removing custom engineering steppers.
+- Home RC example input labels now use native Input component labels instead of separate text labels.
+- Stat cards no longer clip updated text during cross-document state examples.
+- Markdown calculator examples no longer render duplicate section labels.
+
 ## v0.3.0 - Examples overhaul with component audit and i18n
 
 ### Added
@@ -7976,7 +8006,6 @@ Since: 0.1.0
 - `min` (string | number; optional; dynamic): Minimum value used by numeric input controls.
 - `max` (string | number; optional; dynamic): Maximum value used by numeric input controls.
 - `step` (string | number; optional; dynamic): Step size used by numeric input controls.
-- `controls` (boolean; optional; dynamic; default: true): Show decrement and increment buttons for numeric inputs.
 - `onchange` (write-expression; optional; static): Write expression invoked when the value changes.
 
 ### Children
@@ -8276,6 +8305,8 @@ Since: 0.1.0
 - `content` (string; optional; dynamic): Alias for text.
 - `label` (string; optional; dynamic): Alias for text.
 - `variant` (string; optional; static; default: "default"; values: default, muted): Text visual variant.
+- `color` (string; optional; dynamic): Optional CSS color for controlled previews.
+- `size` (string | number; optional; dynamic): Optional font size. Numbers are treated as px.
 - `class` (string; optional; static): Additional host-controlled CSS class.
 
 ### Children

package/dist/ai/llms-runtime.txt

@@ -949,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
 
@@ -1338,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
 ```
 
@@ -1430,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
 
@@ -1459,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
@@ -1476,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/ai/llms.txt

@@ -12,7 +12,7 @@
 
 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.0
+Version: 0.3.1
 
 ## Table of Contents