npm - mates-fullstack - Versions diffs - 1.0.0-beta.1 - Mend

mates-fullstack 1.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (202) hide show

package/README.md +311 -0
package/dist/arctic-auth.d.ts +101 -0
package/dist/arctic-auth.d.ts.map +1 -0
package/dist/arctic-auth.js +538 -0
package/dist/arctic-auth.js.map +1 -0
package/dist/asset-manifest.d.ts +14 -0
package/dist/asset-manifest.d.ts.map +1 -0
package/dist/asset-manifest.js +102 -0
package/dist/asset-manifest.js.map +1 -0
package/dist/browser.d.ts +18 -0
package/dist/browser.d.ts.map +1 -0
package/dist/browser.js +25 -0
package/dist/browser.js.map +1 -0
package/dist/build-esbuild.d.ts +29 -0
package/dist/build-esbuild.d.ts.map +1 -0
package/dist/build-esbuild.js +699 -0
package/dist/build-esbuild.js.map +1 -0
package/dist/build-prod.d.ts +126 -0
package/dist/build-prod.d.ts.map +1 -0
package/dist/build-prod.js +1014 -0
package/dist/build-prod.js.map +1 -0
package/dist/cli-new.d.ts +14 -0
package/dist/cli-new.d.ts.map +1 -0
package/dist/cli-new.js +637 -0
package/dist/cli-new.js.map +1 -0
package/dist/client.d.ts +43 -0
package/dist/client.d.ts.map +1 -0
package/dist/client.js +130 -0
package/dist/client.js.map +1 -0
package/dist/cors.d.ts +16 -0
package/dist/cors.d.ts.map +1 -0
package/dist/cors.js +60 -0
package/dist/cors.js.map +1 -0
package/dist/ctx.d.ts +78 -0
package/dist/ctx.d.ts.map +1 -0
package/dist/ctx.js +280 -0
package/dist/ctx.js.map +1 -0
package/dist/dev-watcher.d.ts +23 -0
package/dist/dev-watcher.d.ts.map +1 -0
package/dist/dev-watcher.js +136 -0
package/dist/dev-watcher.js.map +1 -0
package/dist/docs-generator.d.ts +69 -0
package/dist/docs-generator.d.ts.map +1 -0
package/dist/docs-generator.js +557 -0
package/dist/docs-generator.js.map +1 -0
package/dist/docs-page.d.ts +20 -0
package/dist/docs-page.d.ts.map +1 -0
package/dist/docs-page.js +1152 -0
package/dist/docs-page.js.map +1 -0
package/dist/download.d.ts +78 -0
package/dist/download.d.ts.map +1 -0
package/dist/download.js +202 -0
package/dist/download.js.map +1 -0
package/dist/env-loader.d.ts +76 -0
package/dist/env-loader.d.ts.map +1 -0
package/dist/env-loader.js +213 -0
package/dist/env-loader.js.map +1 -0
package/dist/errors.d.ts +146 -0
package/dist/errors.d.ts.map +1 -0
package/dist/errors.js +386 -0
package/dist/errors.js.map +1 -0
package/dist/head.d.ts +31 -0
package/dist/head.d.ts.map +1 -0
package/dist/head.js +245 -0
package/dist/head.js.map +1 -0
package/dist/index.d.ts +30 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +30 -0
package/dist/index.js.map +1 -0
package/dist/internal-prefixes.d.ts +16 -0
package/dist/internal-prefixes.d.ts.map +1 -0
package/dist/internal-prefixes.js +16 -0
package/dist/internal-prefixes.js.map +1 -0
package/dist/internal.d.ts +25 -0
package/dist/internal.d.ts.map +1 -0
package/dist/internal.js +25 -0
package/dist/internal.js.map +1 -0
package/dist/jwt.d.ts +166 -0
package/dist/jwt.d.ts.map +1 -0
package/dist/jwt.js +261 -0
package/dist/jwt.js.map +1 -0
package/dist/log.d.ts +44 -0
package/dist/log.d.ts.map +1 -0
package/dist/log.js +66 -0
package/dist/log.js.map +1 -0
package/dist/logger.d.ts +76 -0
package/dist/logger.d.ts.map +1 -0
package/dist/logger.js +138 -0
package/dist/logger.js.map +1 -0
package/dist/main-runner.d.ts +59 -0
package/dist/main-runner.d.ts.map +1 -0
package/dist/main-runner.js +157 -0
package/dist/main-runner.js.map +1 -0
package/dist/mates-auth.d.ts +82 -0
package/dist/mates-auth.d.ts.map +1 -0
package/dist/mates-auth.js +323 -0
package/dist/mates-auth.js.map +1 -0
package/dist/middleware.d.ts +30 -0
package/dist/middleware.d.ts.map +1 -0
package/dist/middleware.js +67 -0
package/dist/middleware.js.map +1 -0
package/dist/project-resolver.d.ts +102 -0
package/dist/project-resolver.d.ts.map +1 -0
package/dist/project-resolver.js +271 -0
package/dist/project-resolver.js.map +1 -0
package/dist/rate-limit.d.ts +37 -0
package/dist/rate-limit.d.ts.map +1 -0
package/dist/rate-limit.js +109 -0
package/dist/rate-limit.js.map +1 -0
package/dist/redirect.d.ts +84 -0
package/dist/redirect.d.ts.map +1 -0
package/dist/redirect.js +105 -0
package/dist/redirect.js.map +1 -0
package/dist/renderer.d.ts +91 -0
package/dist/renderer.d.ts.map +1 -0
package/dist/renderer.js +630 -0
package/dist/renderer.js.map +1 -0
package/dist/request-logger.d.ts +12 -0
package/dist/request-logger.d.ts.map +1 -0
package/dist/request-logger.js +55 -0
package/dist/request-logger.js.map +1 -0
package/dist/rest.d.ts +25 -0
package/dist/rest.d.ts.map +1 -0
package/dist/rest.js +93 -0
package/dist/rest.js.map +1 -0
package/dist/router.d.ts +71 -0
package/dist/router.d.ts.map +1 -0
package/dist/router.js +222 -0
package/dist/router.js.map +1 -0
package/dist/rpc-registry.d.ts +84 -0
package/dist/rpc-registry.d.ts.map +1 -0
package/dist/rpc-registry.js +271 -0
package/dist/rpc-registry.js.map +1 -0
package/dist/rpc-runner.d.ts +82 -0
package/dist/rpc-runner.d.ts.map +1 -0
package/dist/rpc-runner.js +564 -0
package/dist/rpc-runner.js.map +1 -0
package/dist/sanitize.d.ts +61 -0
package/dist/sanitize.d.ts.map +1 -0
package/dist/sanitize.js +193 -0
package/dist/sanitize.js.map +1 -0
package/dist/security-headers.d.ts +114 -0
package/dist/security-headers.d.ts.map +1 -0
package/dist/security-headers.js +121 -0
package/dist/security-headers.js.map +1 -0
package/dist/server-fn.d.ts +323 -0
package/dist/server-fn.d.ts.map +1 -0
package/dist/server-fn.js +373 -0
package/dist/server-fn.js.map +1 -0
package/dist/server-public.d.ts +13 -0
package/dist/server-public.d.ts.map +1 -0
package/dist/server-public.js +12 -0
package/dist/server-public.js.map +1 -0
package/dist/server-timeout.d.ts +38 -0
package/dist/server-timeout.d.ts.map +1 -0
package/dist/server-timeout.js +46 -0
package/dist/server-timeout.js.map +1 -0
package/dist/server.d.ts +100 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +1218 -0
package/dist/server.js.map +1 -0
package/dist/socket-router.d.ts +153 -0
package/dist/socket-router.d.ts.map +1 -0
package/dist/socket-router.js +612 -0
package/dist/socket-router.js.map +1 -0
package/dist/sso.d.ts +90 -0
package/dist/sso.d.ts.map +1 -0
package/dist/sso.js +261 -0
package/dist/sso.js.map +1 -0
package/dist/ssr-context.d.ts +49 -0
package/dist/ssr-context.d.ts.map +1 -0
package/dist/ssr-context.js +85 -0
package/dist/ssr-context.js.map +1 -0
package/dist/ssr-globals.d.ts +32 -0
package/dist/ssr-globals.d.ts.map +1 -0
package/dist/ssr-globals.js +1010 -0
package/dist/ssr-globals.js.map +1 -0
package/dist/ssr-template.d.ts +73 -0
package/dist/ssr-template.d.ts.map +1 -0
package/dist/ssr-template.js +507 -0
package/dist/ssr-template.js.map +1 -0
package/dist/stack-mapper.d.ts +25 -0
package/dist/stack-mapper.d.ts.map +1 -0
package/dist/stack-mapper.js +139 -0
package/dist/stack-mapper.js.map +1 -0
package/dist/stream.d.ts +89 -0
package/dist/stream.d.ts.map +1 -0
package/dist/stream.js +299 -0
package/dist/stream.js.map +1 -0
package/dist/upload.d.ts +69 -0
package/dist/upload.d.ts.map +1 -0
package/dist/upload.js +110 -0
package/dist/upload.js.map +1 -0
package/dist/validate.d.ts +58 -0
package/dist/validate.d.ts.map +1 -0
package/dist/validate.js +89 -0
package/dist/validate.js.map +1 -0
package/dist/verify-package.d.ts +3 -0
package/dist/verify-package.d.ts.map +1 -0
package/dist/verify-package.js +128 -0
package/dist/verify-package.js.map +1 -0
package/package.json +79 -0

package/dist/docs-page.js ADDED Viewed

@@ -0,0 +1,1152 @@
+/**
+ * mates-fullstack — docs-page.ts
+ *
+ * Builds and serves a self-contained HTML API documentation page at /api/docs.
+ * Takes RouteDoc objects from docs-generator.ts and renders a dark-themed,
+ * developer-focused interactive docs UI with a Try-it panel.
+ */
+import { ERRORS_MODULE } from "./internal-prefixes.js";
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Build a complete self-contained HTML string for the /api/docs page.
+ * No external dependencies — all CSS and JS are inlined.
+ */
+export function buildDocsHtml(docs, dev) {
+    const endpointCount = docs.length;
+    const sidebarHtml = buildSidebar(docs);
+    const contentHtml = buildContent(docs);
+    const emptyNotice = docs.length === 0
+        ? `<div class="empty-notice">
+           <p>No RPC functions found. Make sure <code>server/api/</code> exists and ts-morph is installed.</p>
+           <pre>npm install -D ts-morph</pre>
+         </div>`
+        : "";
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>RPC Docs — mates-fullstack</title>
+  <style>${CSS}</style>
+</head>
+<body>
+  <header class="header">
+    <div class="header-left">
+      <span class="header-logo">mates-fullstack RPC</span>
+      <span class="header-path">/api/docs</span>
+    </div>
+    <div class="header-right">
+      <span class="badge badge-dev">${dev ? "DEV" : "PROD"}</span>
+    </div>
+  </header>
+  <div class="meta-bar">
+    <span>${endpointCount} RPC function${endpointCount !== 1 ? "s" : ""}</span>
+    <span class="dot">·</span>
+    <span>POST transport</span>
+    <span class="dot">·</span>
+    <span>first argument + return type</span>
+  </div>
+  ${emptyNotice}
+  ${docs.length > 0
+        ? `<div class="layout">
+    <nav class="sidebar" id="sidebar">
+      ${sidebarHtml}
+    </nav>
+    <main class="content" id="content">
+      ${contentHtml}
+    </main>
+  </div>`
+        : ""}
+  <script>${JS}</script>
+</body>
+</html>`;
+}
+/**
+ * Write the docs HTML page to an HTTP ServerResponse.
+ */
+export function serveDocsPage(res, docs, dev) {
+    const html = buildDocsHtml(docs, dev);
+    res.writeHead(200, {
+        "Content-Type": "text/html; charset=utf-8",
+        "Cache-Control": "no-store",
+    });
+    res.end(html);
+}
+// ─── Sidebar ──────────────────────────────────────────────────────────────────
+function buildSidebar(docs) {
+    // Group by file
+    const groups = new Map();
+    for (const doc of docs) {
+        const file = doc.fileRelPath ?? "unknown";
+        if (!groups.has(file))
+            groups.set(file, []);
+        groups.get(file).push(doc);
+    }
+    let html = "";
+    for (const [file, routes] of groups) {
+        const sectionId = fileToId(file);
+        html += `<div class="sidebar-group">
+      <div class="sidebar-file">${escHtml(file)}</div>
+      ${routes
+            .map((r) => {
+            const id = routeToId(r);
+            return `<a class="sidebar-link" href="#${id}" data-target="${id}">${escHtml(r.fnName)}</a>`;
+        })
+            .join("\n      ")}
+    </div>`;
+    }
+    return html;
+}
+// ─── Content ──────────────────────────────────────────────────────────────────
+function buildContent(docs) {
+    return docs
+        .map((doc) => {
+        const id = routeToId(doc);
+        const examplePayload = generateExamplePayload(doc.payload);
+        const exampleJson = JSON.stringify(examplePayload, null, 2);
+        return `<section class="route-section" id="${id}">
+  <div class="route-header">
+    <span class="method-badge">POST</span>
+    <span class="route-url">${escHtml(doc.url)}</span>
+  </div>
+  <div class="rpc-title">
+    <span class="rpc-file">${escHtml(doc.fileRelPath ?? "")}</span>
+    <span class="rpc-separator">:</span>
+    <span class="rpc-function">${escHtml(doc.fnName)}</span>
+  </div>
+  ${doc.description ? `<p class="route-desc">${escHtml(doc.description)}</p>` : ""}
+  ${doc.typed ? buildPayloadDocs(doc) : buildUntypedDocs()}
+  ${doc.typed ? buildResponseDocs(doc.response) : ""}
+  <div class="try-it-container">
+    <button class="try-it-toggle" data-id="${id}" aria-expanded="false">
+      ▶ Try it
+    </button>
+    <div class="try-it-panel" id="try-${id}" hidden>
+      <div class="try-it-body">
+        <label class="try-label">Payload</label>
+        <textarea class="try-textarea" id="payload-${id}" spellcheck="false">${escHtml(exampleJson)}</textarea>
+        <button class="try-send-btn" data-id="${id}" data-url="${escHtml(doc.url)}">Send</button>
+        <div class="try-response" id="resp-${id}" hidden>
+          <div class="try-response-meta" id="resp-meta-${id}"></div>
+          <pre class="try-response-body" id="resp-body-${id}"></pre>
+        </div>
+      </div>
+    </div>
+  </div>
+</section>`;
+    })
+        .join("\n");
+}
+// ─── Type rendering ───────────────────────────────────────────────────────────
+function buildUntypedDocs() {
+    return `<div class="type-section">
+  <div class="type-section-title">Payload</div>
+  <div class="type-note">Type extraction is only available for TypeScript RPC files.</div>
+</div>`;
+}
+function buildPayloadDocs(doc) {
+    const shape = doc.payload;
+    const argName = doc.firstArgName ?? "payload";
+    if (!shape) {
+        return `<div class="type-section">
+  <div class="type-section-title">First argument</div>
+  <span class="type-muted">(none)</span>
+</div>`;
+    }
+    const header = `<div class="type-section-title">Payload ${confidenceBadge(shape.confidence)}</div>`;
+    return `<div class="type-section">
+  ${header}
+  ${renderTypeTree(shape, argName)}
+</div>`;
+}
+function buildResponseDocs(shape) {
+    if (!shape) {
+        return `<div class="type-section">
+  <div class="type-section-title">Returns</div>
+  <span class="type-muted">void</span>
+</div>`;
+    }
+    const header = `<div class="type-section-title">Response ${confidenceBadge(shape.confidence)}</div>`;
+    return `<div class="type-section">
+  ${header}
+  ${renderTypeTree(shape, "response")}
+</div>`;
+}
+function renderTypeTree(shape, label) {
+    if (shape.kind === "array") {
+        const itemType = cleanTypeName(shape.itemType ?? shape.typeName);
+        if (shape.fields && shape.fields.length > 0) {
+            return `<details class="type-tree" open>
+  <summary><span class="tree-label">${escHtml(label)}</span><span class="tree-type">Array</span></summary>
+  <div class="tree-children">
+    <details class="type-tree type-tree-nested" open>
+      <summary><span class="tree-label">item</span><span class="tree-type">object</span></summary>
+      <ul class="tree-list">
+        ${shape.fields.map(renderTreeField).join("\n        ")}
+      </ul>
+    </details>
+  </div>
+</details>`;
+        }
+        return `<details class="type-tree" open>
+  <summary><span class="tree-label">${escHtml(label)}</span><span class="tree-type">Array&lt;${escHtml(itemType)}&gt;</span></summary>
+</details>`;
+    }
+    if (shape.kind === "object") {
+        const fields = shape.fields ?? [];
+        return `<details class="type-tree" open>
+  <summary><span class="tree-label">${escHtml(label)}</span><span class="tree-type">object</span></summary>
+  ${fields.length > 0
+            ? `<ul class="tree-list">
+        ${fields.map(renderTreeField).join("\n        ")}
+      </ul>`
+            : `<div class="tree-empty">no fields</div>`}
+</details>`;
+    }
+    return `<div class="type-leaf">
+  <span class="tree-label">${escHtml(label)}</span>
+  <span class="tree-type">${escHtml(shapeLabel(shape))}</span>
+</div>`;
+}
+function renderTreeField(field) {
+    const requiredBadge = field.required
+        ? `<span class="badge badge-required">required</span>`
+        : `<span class="badge badge-optional">optional</span>`;
+    const description = field.description
+        ? `<div class="tree-desc">${escHtml(field.description)}</div>`
+        : "";
+    return `<li class="tree-field">
+  <div class="tree-field-line">
+    <span class="tree-field-name">${escHtml(field.name)}</span><span class="tree-punct">:</span>
+    <code class="tree-field-type">${escHtml(cleanTypeName(field.type))}</code>
+    ${requiredBadge}
+  </div>
+  ${description}
+</li>`;
+}
+function shapeLabel(shape) {
+    if (!shape || !shape.kind)
+        return "unknown";
+    if (shape.kind === "array" && shape.fields && shape.fields.length > 0) {
+        return `${fieldsToInlineType(shape.fields)}[]`;
+    }
+    if (shape.kind === "object" && shape.fields && shape.fields.length > 0) {
+        return fieldsToInlineType(shape.fields);
+    }
+    return cleanTypeName(shape.typeName || shape.kind);
+}
+function fieldsToInlineType(fields) {
+    return `{ ${fields
+        .map((field) => {
+        const name = field.required ? field.name : `${field.name}?`;
+        return `${name}: ${cleanTypeName(field.type)}`;
+    })
+        .join("; ")} }`;
+}
+function cleanTypeName(typeName) {
+    return typeName
+        .replace(/import\(["'][^)]+["']\)\./g, "")
+        .replace(/import\(["'][^)]+["']\)/g, "");
+}
+function confidenceBadge(confidence) {
+    const label = confidence === "explicit"
+        ? "explicit"
+        : confidence === "inferred"
+            ? "inferred"
+            : "unknown";
+    return `<span class="confidence-badge confidence-${label}">${label}</span>`;
+}
+// ─── Example payload generation ───────────────────────────────────────────────
+function generateExamplePayload(shape) {
+    if (!shape)
+        return {};
+    switch (shape.kind) {
+        case "primitive": {
+            const t = shape.typeName;
+            if (t === "string")
+                return "";
+            if (t === "number")
+                return 0;
+            if (t === "boolean")
+                return false;
+            return null;
+        }
+        case "array":
+            return [];
+        case "object": {
+            if (!shape.fields || shape.fields.length === 0)
+                return {};
+            const obj = {};
+            for (const field of shape.fields) {
+                // FieldDoc.type is a string — produce a simple example based on the type string
+                obj[field.name] = exampleFromTypeString(field.type);
+            }
+            return obj;
+        }
+        case "union":
+        case "unknown":
+        default:
+            return {};
+    }
+}
+function exampleFromTypeString(typeName) {
+    switch (typeName) {
+        case "string":
+            return "";
+        case "number":
+            return 0;
+        case "boolean":
+            return false;
+        default:
+            if (typeName.endsWith("[]"))
+                return [];
+            return null;
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function escHtml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function fileToId(file) {
+    return "file-" + file.replace(/[^a-zA-Z0-9]/g, "-");
+}
+function routeToId(doc) {
+    return doc.url.replace(/\//g, "-").replace(/^-/, "");
+}
+// ─── Inline CSS ───────────────────────────────────────────────────────────────
+const CSS = `
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+:root {
+  --bg: #0f1117;
+  --surface: #1a1d27;
+  --surface-2: #1e2130;
+  --border: #2a2d3a;
+  --text: #e2e8f0;
+  --muted: #718096;
+  --accent: #4ade80;
+  --accent-bg: #14532d;
+  --required: #fbbf24;
+  --optional: #718096;
+  --code-bg: #111827;
+  --error: #f87171;
+  --link: #60a5fa;
+  --radius: 6px;
+  --font-mono: "Cascadia Code", "Fira Code", "Consolas", monospace;
+  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+}
+html, body {
+  height: 100%;
+  background: var(--bg);
+  color: var(--text);
+  font-family: var(--font-sans);
+  font-size: 14px;
+  line-height: 1.6;
+}
+/* Header */
+.header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 24px;
+  height: 52px;
+  background: var(--surface);
+  border-bottom: 1px solid var(--border);
+  position: sticky;
+  top: 0;
+  z-index: 100;
+}
+.header-left {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+.header-logo {
+  font-weight: 700;
+  font-size: 15px;
+  color: var(--text);
+  letter-spacing: -0.3px;
+}
+.header-path {
+  color: var(--muted);
+  font-family: var(--font-mono);
+  font-size: 12px;
+}
+.header-right {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+/* Meta bar */
+.meta-bar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 24px;
+  font-size: 12px;
+  color: var(--muted);
+  background: var(--surface);
+  border-bottom: 1px solid var(--border);
+}
+.dot { color: var(--border); }
+/* Badges */
+.badge {
+  display: inline-block;
+  padding: 2px 7px;
+  border-radius: 4px;
+  font-size: 11px;
+  font-weight: 600;
+  letter-spacing: 0.4px;
+  text-transform: uppercase;
+}
+.badge-dev { background: #1e3a5f; color: #60a5fa; }
+.badge-prod { background: #1a2e1a; color: var(--accent); }
+.badge-post { background: var(--accent-bg); color: var(--accent); }
+.badge-required { color: var(--required); background: transparent; padding: 0; font-size: 11px; font-weight: 500; text-transform: none; letter-spacing: 0; }
+.badge-optional { color: var(--optional); background: transparent; padding: 0; font-size: 11px; font-weight: 400; text-transform: none; letter-spacing: 0; }
+/* Layout */
+.layout {
+  display: flex;
+  height: calc(100vh - 88px);
+}
+/* Sidebar */
+.sidebar {
+  width: 220px;
+  min-width: 180px;
+  background: var(--surface);
+  border-right: 1px solid var(--border);
+  overflow-y: auto;
+  flex-shrink: 0;
+  padding: 16px 0;
+}
+.sidebar-group {
+  margin-bottom: 20px;
+}
+.sidebar-file {
+  padding: 4px 16px;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--muted);
+  text-transform: uppercase;
+  letter-spacing: 0.6px;
+  font-family: var(--font-mono);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.sidebar-link {
+  display: block;
+  padding: 5px 16px 5px 24px;
+  font-size: 13px;
+  color: var(--muted);
+  text-decoration: none;
+  border-left: 2px solid transparent;
+  transition: color 0.12s, border-color 0.12s, background 0.12s;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  font-family: var(--font-mono);
+}
+.sidebar-link:hover {
+  color: var(--text);
+  background: var(--surface-2);
+}
+.sidebar-link.active {
+  color: var(--accent);
+  border-left-color: var(--accent);
+  background: rgba(74, 222, 128, 0.06);
+}
+/* Content */
+.content {
+  flex: 1;
+  overflow-y: auto;
+  padding: 0;
+}
+/* Route section */
+.route-section {
+  padding: 28px 32px 28px 32px;
+  border-bottom: 1px solid var(--border);
+}
+.route-section:last-child {
+  border-bottom: none;
+}
+.route-header {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-bottom: 10px;
+  flex-wrap: wrap;
+}
+.method-badge {
+  display: inline-block;
+  background: var(--accent-bg);
+  color: var(--accent);
+  font-size: 11px;
+  font-weight: 700;
+  padding: 3px 8px;
+  border-radius: 4px;
+  letter-spacing: 0.5px;
+  font-family: var(--font-mono);
+  flex-shrink: 0;
+}
+.route-url {
+  font-family: var(--font-mono);
+  font-size: 15px;
+  font-weight: 600;
+  color: var(--text);
+  word-break: break-all;
+}
+.rpc-title {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+  margin: 10px 0 14px;
+  font-family: var(--font-mono);
+  flex-wrap: wrap;
+}
+.rpc-file {
+  color: var(--muted);
+  font-size: 13px;
+}
+.rpc-separator {
+  color: var(--border);
+}
+.rpc-function {
+  color: var(--text);
+  font-size: 18px;
+  font-weight: 700;
+}
+.route-file {
+  font-family: var(--font-mono);
+  font-size: 11px;
+  color: var(--muted);
+  margin-left: auto;
+}
+.route-desc {
+  color: var(--muted);
+  font-size: 13px;
+  margin-bottom: 16px;
+  max-width: 640px;
+}
+/* Type sections */
+.type-section {
+  margin: 14px 0;
+}
+.type-section-title {
+  font-size: 12px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: var(--muted);
+  margin-bottom: 8px;
+}
+.type-name {
+  text-transform: none;
+  font-weight: 500;
+  color: var(--text);
+  font-family: var(--font-mono);
+  letter-spacing: 0;
+}
+.type-line {
+  color: var(--text);
+  font-family: var(--font-mono);
+  font-size: 13px;
+  margin-bottom: 8px;
+}
+.type-line code {
+  color: var(--accent);
+  background: transparent;
+}
+.type-note {
+  max-width: 760px;
+  background: var(--code-bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  color: var(--muted);
+  font-size: 13px;
+  padding: 10px 12px;
+}
+.type-primitive {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  color: var(--text);
+}
+.confidence-badge {
+  display: inline-block;
+  vertical-align: 1px;
+  margin-left: 6px;
+  padding: 1px 6px;
+  border-radius: 999px;
+  font-size: 10px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.4px;
+}
+.confidence-explicit { color: var(--accent); background: rgba(74, 222, 128, 0.12); }
+.confidence-inferred { color: var(--link); background: rgba(96, 165, 250, 0.12); }
+.confidence-unknown { color: var(--required); background: rgba(251, 191, 36, 0.12); }
+.type-muted {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  color: var(--muted);
+}
+/* Type tree */
+.type-tree,
+.type-leaf {
+  max-width: 760px;
+  background: var(--code-bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  font-family: var(--font-mono);
+  font-size: 13px;
+  overflow: hidden;
+}
+.type-tree summary {
+  cursor: pointer;
+  list-style: none;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 12px;
+  color: var(--text);
+  user-select: none;
+}
+.type-tree summary::-webkit-details-marker { display: none; }
+.type-tree summary::before {
+  content: "▶";
+  color: var(--muted);
+  font-size: 10px;
+  transition: transform 0.12s ease;
+}
+.type-tree[open] > summary::before { transform: rotate(90deg); }
+.type-tree summary:hover {
+  background: rgba(255, 255, 255, 0.025);
+}
+.type-tree-nested {
+  margin: 8px 12px 12px;
+  background: rgba(255, 255, 255, 0.02);
+}
+.tree-children {
+  border-top: 1px solid var(--border);
+}
+.tree-list {
+  list-style: none;
+  padding: 4px 12px 10px 28px;
+  border-top: 1px solid var(--border);
+}
+.type-tree > .tree-list {
+  border-top: 1px solid var(--border);
+}
+.tree-field {
+  position: relative;
+  padding: 5px 0;
+}
+.tree-field::before {
+  content: "";
+  position: absolute;
+  left: -13px;
+  top: 0;
+  bottom: 0;
+  border-left: 1px solid var(--border);
+}
+.tree-field::after {
+  content: "";
+  position: absolute;
+  left: -13px;
+  top: 15px;
+  width: 9px;
+  border-top: 1px solid var(--border);
+}
+.tree-field:last-child::before { bottom: calc(100% - 15px); }
+.tree-field-line {
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+.tree-label,
+.tree-field-name {
+  color: var(--text);
+  font-weight: 600;
+}
+.tree-type,
+.tree-field-type {
+  color: var(--accent);
+  background: transparent;
+  font-family: var(--font-mono);
+}
+.tree-punct {
+  color: var(--muted);
+}
+.tree-desc {
+  color: var(--muted);
+  font-family: var(--font-sans);
+  font-size: 12px;
+  margin: 2px 0 0 0;
+}
+.tree-empty,
+.type-leaf {
+  color: var(--muted);
+  padding: 8px 12px;
+}
+.type-leaf {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+/* Field table */
+.field-table {
+  border-collapse: collapse;
+  width: 100%;
+  max-width: 640px;
+  font-size: 13px;
+}
+.field-table tr {
+  border-bottom: 1px solid var(--border);
+}
+.field-table tr:last-child {
+  border-bottom: none;
+}
+.field-name {
+  font-family: var(--font-mono);
+  color: var(--text);
+  padding: 6px 14px 6px 0;
+  min-width: 120px;
+  white-space: nowrap;
+}
+.field-type {
+  font-family: var(--font-mono);
+  color: var(--muted);
+  padding: 6px 14px 6px 0;
+  min-width: 80px;
+}
+.field-badge {
+  padding: 6px 14px 6px 0;
+  white-space: nowrap;
+}
+.field-desc {
+  color: var(--muted);
+  padding: 6px 0;
+  font-size: 12px;
+}
+/* Try-it */
+.try-it-container {
+  margin-top: 18px;
+}
+.try-it-toggle {
+  background: transparent;
+  border: 1px solid var(--border);
+  color: var(--muted);
+  font-size: 12px;
+  font-family: var(--font-mono);
+  padding: 5px 12px;
+  border-radius: var(--radius);
+  cursor: pointer;
+  transition: color 0.12s, border-color 0.12s, background 0.12s;
+  user-select: none;
+}
+.try-it-toggle:hover,
+.try-it-toggle[aria-expanded="true"] {
+  color: var(--accent);
+  border-color: var(--accent);
+  background: rgba(74, 222, 128, 0.06);
+}
+.try-it-panel {
+  background: var(--surface-2);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  margin-top: 10px;
+  overflow: hidden;
+}
+.try-it-body {
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.try-label {
+  font-size: 11px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: var(--muted);
+}
+.try-textarea {
+  background: var(--code-bg);
+  border: 1px solid var(--border);
+  color: var(--text);
+  font-family: var(--font-mono);
+  font-size: 12px;
+  padding: 10px 12px;
+  border-radius: 4px;
+  resize: vertical;
+  min-height: 80px;
+  outline: none;
+  width: 100%;
+  max-width: 640px;
+}
+.try-textarea:focus {
+  border-color: var(--accent);
+}
+.try-send-btn {
+  width: fit-content;
+  background: var(--accent-bg);
+  color: var(--accent);
+  border: 1px solid rgba(74, 222, 128, 0.3);
+  font-size: 13px;
+  font-weight: 600;
+  font-family: var(--font-sans);
+  padding: 6px 18px;
+  border-radius: var(--radius);
+  cursor: pointer;
+  transition: background 0.12s, border-color 0.12s;
+}
+.try-send-btn:hover {
+  background: rgba(74, 222, 128, 0.2);
+  border-color: var(--accent);
+}
+.try-send-btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+/* Response */
+.try-response {
+  max-width: 640px;
+}
+.try-response-meta {
+  font-size: 12px;
+  font-weight: 600;
+  font-family: var(--font-mono);
+  margin-bottom: 6px;
+}
+.try-response-meta.ok { color: var(--accent); }
+.try-response-meta.err { color: var(--error); }
+.try-response-body {
+  background: var(--code-bg);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 10px 12px;
+  font-family: var(--font-mono);
+  font-size: 12px;
+  color: var(--text);
+  overflow-x: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 360px;
+  overflow-y: auto;
+}
+.try-response-body.error-body { color: var(--error); }
+/* Empty notice */
+.empty-notice {
+  max-width: 520px;
+  margin: 64px auto;
+  padding: 32px;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  text-align: center;
+}
+.empty-notice p {
+  color: var(--muted);
+  margin-bottom: 16px;
+  font-size: 14px;
+}
+.empty-notice code {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  background: var(--code-bg);
+  padding: 2px 6px;
+  border-radius: 3px;
+  color: var(--text);
+}
+.empty-notice pre {
+  background: var(--code-bg);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 10px 14px;
+  font-family: var(--font-mono);
+  font-size: 13px;
+  color: var(--accent);
+  display: inline-block;
+}
+/* Scrollbar styling */
+::-webkit-scrollbar { width: 6px; height: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--border); border-radius: 3px; }
+::-webkit-scrollbar-thumb:hover { background: #3a3f52; }
+`;
+// ─── Inline JS ────────────────────────────────────────────────────────────────
+const JS = `
+(function () {
+  "use strict";
+  // ── Try-it toggle ────────────────────────────────────────────────────────
+  document.querySelectorAll(".try-it-toggle").forEach(function (btn) {
+    btn.addEventListener("click", function () {
+      var id = btn.getAttribute("data-id");
+      var panel = document.getElementById("try-" + id);
+      if (!panel) return;
+      var expanded = btn.getAttribute("aria-expanded") === "true";
+      if (expanded) {
+        btn.setAttribute("aria-expanded", "false");
+        btn.textContent = "▶ Try it";
+        panel.hidden = true;
+      } else {
+        btn.setAttribute("aria-expanded", "true");
+        btn.textContent = "▼ Try it";
+        panel.hidden = false;
+      }
+    });
+  });
+  // ── Send button ──────────────────────────────────────────────────────────
+  document.querySelectorAll(".try-send-btn").forEach(function (btn) {
+    btn.addEventListener("click", async function () {
+      var id = btn.getAttribute("data-id");
+      var url = btn.getAttribute("data-url");
+      var textarea = document.getElementById("payload-" + id);
+      var respContainer = document.getElementById("resp-" + id);
+      var respMeta = document.getElementById("resp-meta-" + id);
+      var respBody = document.getElementById("resp-body-" + id);
+      if (!textarea || !respContainer || !respMeta || !respBody) return;
+      var payload = textarea.value.trim();
+      var headers = { "Content-Type": "application/json" };
+      btn.disabled = true;
+      btn.textContent = "Sending…";
+      respMeta.textContent = "";
+      respMeta.className = "try-response-meta";
+      respBody.textContent = "";
+      respBody.className = "try-response-body";
+      respContainer.hidden = false;
+      var t0 = performance.now();
+      try {
+        var res = await fetch(url, {
+          method: "POST",
+          headers: headers,
+          credentials: "same-origin",
+          body: payload || "{}",
+        });
+        var elapsed = Math.round(performance.now() - t0);
+        var contentType = res.headers.get("content-type") || "";
+        var isOk = res.ok;
+        respMeta.className = "try-response-meta " + (isOk ? "ok" : "err");
+        respMeta.textContent = res.status + " " + res.statusText + "  " + elapsed + "ms";
+        if (contentType.includes("text/event-stream")) {
+          // Streaming response
+          respBody.textContent = "";
+          var reader = res.body.getReader();
+          var decoder = new TextDecoder();
+          var done = false;
+          while (!done) {
+            var chunk = await reader.read();
+            done = chunk.done;
+            if (chunk.value) {
+              respBody.textContent += decoder.decode(chunk.value, { stream: !done });
+            }
+          }
+        } else {
+          var text = await res.text();
+          try {
+            var json = JSON.parse(text);
+            if (!isOk) {
+              var errors = await import("${ERRORS_MODULE}");
+              if (errors.isMatesError(json)) {
+                var err = errors.reconstructError(json);
+                respBody.textContent = JSON.stringify({
+                  name: err.name,
+                  message: err.message,
+                  status: err.status,
+                  code: err.code,
+                  fields: err.fields,
+                  retryAfter: err.retryAfter,
+                }, null, 2);
+              } else {
+                respBody.textContent = JSON.stringify(json, null, 2);
+              }
+            } else {
+              respBody.textContent = JSON.stringify(json, null, 2);
+            }
+          } catch (_) {
+            respBody.textContent = text;
+          }
+          if (!isOk) {
+            respBody.classList.add("error-body");
+          }
+        }
+      } catch (err) {
+        var elapsed2 = Math.round(performance.now() - t0);
+        respMeta.className = "try-response-meta err";
+        respMeta.textContent = "Error  " + elapsed2 + "ms";
+        respBody.textContent = err && err.message ? err.message : String(err);
+        respBody.classList.add("error-body");
+      } finally {
+        btn.disabled = false;
+        btn.textContent = "Send";
+      }
+    });
+  });
+  // ── Sidebar active link (scroll spy) ─────────────────────────────────────
+  var sections = Array.from(document.querySelectorAll(".route-section"));
+  var links = Array.from(document.querySelectorAll(".sidebar-link"));
+  var content = document.getElementById("content");
+  function updateActive() {
+    var scrollTop = content ? content.scrollTop : window.scrollY;
+    var active = null;
+    for (var i = 0; i < sections.length; i++) {
+      var s = sections[i];
+      if (s.offsetTop <= scrollTop + 80) {
+        active = s.id;
+      }
+    }
+    links.forEach(function (link) {
+      var target = link.getAttribute("data-target");
+      if (target === active) {
+        link.classList.add("active");
+      } else {
+        link.classList.remove("active");
+      }
+    });
+  }
+  if (content) {
+    content.addEventListener("scroll", updateActive, { passive: true });
+  } else {
+    window.addEventListener("scroll", updateActive, { passive: true });
+  }
+  // Smooth scroll on sidebar link click
+  links.forEach(function (link) {
+    link.addEventListener("click", function (e) {
+      e.preventDefault();
+      var target = link.getAttribute("data-target");
+      var el = document.getElementById(target);
+      if (!el) return;
+      if (content) {
+        content.scrollTo({ top: el.offsetTop - 16, behavior: "smooth" });
+      } else {
+        el.scrollIntoView({ behavior: "smooth", block: "start" });
+      }
+    });
+  });
+  updateActive();
+})();
+`;
+//# sourceMappingURL=docs-page.js.map