@slexkit/mcp 0.2.0 → 0.3.0

package/README.md

@@ -27,9 +27,9 @@ The server exposes three read-only tools:
 
 | Tool | Purpose |
 |------|---------|
-| `slexkitDocs` | Search or fetch generated Markdown docs, including runtime, security, package, ToolHost, and component pages. |
-| `slexkitExamples` | Return component examples or generated templates such as `status`, `calculator`, `toolhost-form`, and `host-integration`. |
-| `slexkitValidate` | Parse Slex source and return diagnostics plus detected component usage. |
+| `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:
 

package/dist/data/llms-authoring.txt

@@ -7,6 +7,7 @@ SlexKit's agent-readable source is Markdown with explicit `slex` fences. Do not
 - Emit explicit `slex` fenced code blocks for display-oriented interactive UI.
 - Use a Slex expression envelope: `slex`, `namespace`, `g`, and `layout`.
 - Put mutable state and helper functions in `g`; put component structure in `layout`.
+- Use `std.*` for common calculations, formatting, units, and small statistics.
 - Use component keys in `type:identifier` form, such as `card:summary`.
 - Use `$` read-pipes for dynamic props and `on*` write-pipes for event handlers.
 - Include readable Markdown fallback text after the fence.
@@ -18,6 +19,7 @@ SlexKit's agent-readable source is Markdown with explicit `slex` fences. Do not
 - Do not ask hosts to scan plain JavaScript, JSON, or untagged code blocks.
 - Do not wrap ordinary status cards or summaries in ToolHost.
 - Do not bypass the sandbox for untrusted source.
+- Do not use native `fetch`, `XMLHttpRequest`, `WebSocket`, `setTimeout`, or `requestAnimationFrame` in secure mode; use policy-gated `api.*` instead.
 - Do not invent `.mdx` routes for SlexKit docs.
 
 ## Display UI Example

package/dist/data/llms-capabilities.txt

@@ -0,0 +1,126 @@
+# SlexKit Capabilities for LLMs
+
+Use `std.*` for pure deterministic calculations and formatting. Use `api.*` only for host-injected or secure-runtime capabilities that may require policy.
+
+## Expression Context
+
+- `g` (always): Reactive state proxy.
+- `std` (always): Pure deterministic SlexKit standard library.
+- `api` (host-injected): Host or secure runtime capability object.
+- `$event` (event handlers): Event payload for on* handlers.
+- `$item` ($for): Current array item.
+- `$index` ($for): Current item index.
+- `$key` ($for): Current item key.
+
+## std.math
+
+Small numeric helpers for common interactive calculations.
+
+- `std.math.clamp(value, min, max)`: Clamp a number into a range. Example: `std.math.clamp(g.score, 0, 100)`
+- `std.math.round(value, digits = 0)`: Round with a fixed number of decimal digits. Example: `std.math.round(g.latency, 1)`
+- `std.math.safeDivide(numerator, denominator, fallback = 0)`: Divide with a fallback for zero or invalid denominators. Example: `std.math.safeDivide(g.used, g.total, 0)`
+- `std.math.percent(part, total, digits = 1)`: Return part / total as a percentage number. Example: `std.math.percent(g.done, g.total, 1)`
+- `std.math.lerp(start, end, t)`: Linear interpolation. Example: `std.math.lerp(0, 100, g.progress)`
+
+## std.stats
+
+Finite-number aggregations for arrays.
+
+- `std.stats.sum(values)`: Sum finite numeric values. Empty arrays return 0. Example: `std.stats.sum(g.samples)`
+- `std.stats.mean(values)`: Average finite numeric values. Empty arrays return NaN. Example: `std.stats.mean(g.samples)`
+- `std.stats.min(values)`: Minimum finite numeric value. Empty arrays return NaN. Example: `std.stats.min(g.samples)`
+- `std.stats.max(values)`: Maximum finite numeric value. Empty arrays return NaN. Example: `std.stats.max(g.samples)`
+- `std.stats.median(values)`: Median finite numeric value. Empty arrays return NaN. Example: `std.stats.median(g.samples)`
+
+## std.format
+
+Deterministic display formatting with en-US defaults.
+
+- `std.format.fixed(value, digits = 2)`: Format a number with fixed decimal places. Example: `std.format.fixed(g.voltage, 3)`
+- `std.format.number(value, digits = 0, locale = 'en-US')`: Locale number formatting. Example: `std.format.number(g.requests)`
+- `std.format.compact(value, digits = 1, locale = 'en-US')`: Compact number formatting. Example: `std.format.compact(g.users)`
+- `std.format.percent(ratio, digits = 1)`: Format a ratio as a percentage string. Example: `std.format.percent(g.done / g.total, 1)`
+- `std.format.currency(value, currency = 'USD', locale = 'en-US')`: Format a currency value. Example: `std.format.currency(g.revenue, 'USD')`
+
+## std.units
+
+Small unit display helpers for common dashboards.
+
+- `std.units.withUnit(value, unit, digits = 2)`: Format a value with a unit suffix. Example: `std.units.withUnit(g.power, 'W', 1)`
+- `std.units.bytes(value, digits = 1)`: Format bytes as B, KB, MB, GB, TB, or PB. Example: `std.units.bytes(g.payloadBytes)`
+- `std.units.duration(ms, digits = 1)`: Format milliseconds as ms, s, min, or h. Example: `std.units.duration(g.elapsedMs)`
+- `std.units.si(value, unit = '', digits = 2)`: Format with SI prefixes. Example: `std.units.si(g.frequency, 'Hz', 2)`
+
+## Policy-Gated Runtime API
+
+- `api.get(url, options)` (network, secure default: denied): Policy-gated GET request.
+- `api.post(url, body, options)` (network, secure default: denied): Policy-gated POST request.
+- `api.fetch(url, options)` (network, secure default: denied): Policy-gated GET or POST request.
+- `api.setTimeout(fn, ms)` (timer, secure default: denied): Policy-gated timeout.
+- `api.clearTimeout(id)` (timer, secure default: denied): Clear a policy-gated timeout.
+- `api.setInterval(fn, ms)` (timer, secure default: denied): Policy-gated interval.
+- `api.clearInterval(id)` (timer, secure default: denied): Clear a policy-gated interval.
+- `api.raf(fn)` (animation, secure default: denied): Policy-gated animation frame.
+- `api.cancelRaf(id)` (animation, secure default: denied): Cancel a policy-gated animation frame.
+- `api.createCanvas(width, height)` (canvas, secure default: denied): Create a policy-counted canvas.
+- `api.getCanvasContext(canvas, contextId, options)` (canvas, secure default: denied): Get a policy-checked canvas context.
+- `api.onDispose(fn)` (lifecycle, secure default: available): Register runtime cleanup.
+- `api.now()` (lifecycle, secure default: available): Runtime clock.
+- `api.isTimeoutError(error)` (diagnostics, secure default: available): Check timeout errors.
+- `api.isNetworkError(error)` (diagnostics, secure default: available): Check network errors.
+- `api.isPolicyError(error)` (diagnostics, secure default: available): Check policy errors.
+- `api.errorMessage(error)` (diagnostics, secure default: available): Extract a displayable error message.
+
+Secure mode blocks native `fetch`, `XMLHttpRequest`, `WebSocket`, `setTimeout`, `setInterval`, and `requestAnimationFrame`. Use `api.get`, `api.post`, `api.fetch`, `api.setTimeout`, `api.setInterval`, and `api.raf` when host policy enables them.
+
+## Recipe: Std Calculator
+
+```slex
+{
+  slex: "0.1",
+  namespace: "std_calculator",
+  g: { done: 7, total: 12, samples: [120, 95, 143, 110], bytes: 1536000 },
+  layout: {
+    "card:summary": {
+      title: "Stdlib calculator",
+      "stat:progress": { label: "Progress", "$value": "std.format.percent(std.math.safeDivide(g.done, g.total), 1)" },
+      "stat:average": { label: "Average", "$value": "std.format.fixed(std.stats.mean(g.samples), 1)", unit: "ms" },
+      "stat:payload": { label: "Payload", "$value": "std.units.bytes(g.bytes)" }
+    }
+  }
+}
+```
+
+## Recipe: Secure Network Card
+
+```slex
+{
+  slex: "0.1",
+  namespace: "secure_network_card",
+  g: {
+    status: "idle",
+    async load() {
+      this.status = "loading";
+      try {
+        var result = await api.get("https://api.example.com/status", { credentials: "omit" });
+        this.status = "HTTP " + result.status;
+      } catch (error) {
+        this.status = api.isPolicyError(error) ? "blocked by policy" : api.errorMessage(error);
+      }
+    }
+  },
+  layout: {
+    "card:network": {
+      title: "Secure network card",
+      "button:load": { label: "Load", onclick: "g.load()" },
+      "text:status": { "$text": "g.status" }
+    }
+  }
+}
+```
+
+## Recipe: Timer and Animation Policy
+
+- Timers are disabled in secure mode unless `policy.timer.enabled` is true.
+- Use `api.setTimeout` and `api.setInterval`; do not use native scheduling globals.
+- Animation is disabled unless `policy.animation.enabled` is true; use `api.raf`.

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: 28
+Public component count: 29
 
 ## Disclosure
 
@@ -39,6 +39,12 @@ Public component count: 28
 - [Slider](/docs/components/slider.md): `slider` - Numeric range input.
 - [Switch](/docs/components/switch.md): `switch` - Boolean switch input.
 
+## Display
+
+- [Formula](/docs/components/formula.md): `formula` - Reactive KaTeX formula display.
+- [Stat](/docs/components/stat.md): `stat` - Metric display.
+- [Text](/docs/components/text.md): `text` - Plain text display.
+
 ## Component
 
 - [Icon](/docs/components/icon.md): `icon` - Shared icon field capability.
@@ -52,11 +58,6 @@ Public component count: 28
 - [Progress](/docs/components/progress.md): `progress` - Progress bar.
 - [Toast](/docs/components/toast.md): `toast` - Transient notification.
 
-## Display
-
-- [Stat](/docs/components/stat.md): `stat` - Metric display.
-- [Text](/docs/components/text.md): `text` - Plain text display.
-
 ## Data
 
 - [Table](/docs/components/table.md): `table` - Simple data table.
@@ -265,6 +266,26 @@ No child components.
 
 ---
 
+## Formula API (`formula`)
+
+Category: Display
+Status: ready
+State mode: none
+Since: 0.1.0
+
+### Props
+- `tex` (string; optional; dynamic): KaTeX source to render.
+- `formula` (string; optional; dynamic): Alias for tex.
+- `value` (string; optional; dynamic): Alias for tex.
+- `displayMode` (boolean; optional; static; default: true): Render as display math when true; inline math when false.
+- `display` (boolean; optional; static; default: true): Alias for displayMode.
+- `block` (boolean; optional; static; default: true): Alias for displayMode.
+
+### Children
+No child components.
+
+---
+
 ## Grid API (`grid`)
 
 Category: Layout