omkit 0.8.23 → 0.8.25

package/dist/output/writers/report/report.js

@@ -102,6 +102,31 @@
       /[&<>"']/g,
       (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]
     );
+  /** A description key as a label: `docsUrl` / `docs-url` / `docs_url` → `Docs url`. */
+  const propLabel = (key) => {
+    const words = String(key)
+      .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+      .replace(/[-_]+/g, " ")
+      .trim()
+      .toLowerCase();
+    return words.charAt(0).toUpperCase() + words.slice(1);
+  };
+  /**
+   * Key/value rows for a `.describe(…)`: the summary, then every further prop in the order it
+   * was written. A list reads as its items joined; a web address becomes a link.
+   */
+  const descriptionRows = (d) =>
+    Object.entries(d)
+      .filter(([, v]) => v !== undefined && v !== null && v !== "")
+      .sort(([a], [b]) => (a === "summary" ? -1 : b === "summary" ? 1 : 0))
+      .map(([k, v]) => {
+        const text = Array.isArray(v) ? v.join(", ") : String(v);
+        const value = /^https?:\/\/\S+$/.test(text)
+          ? `<a href="${esc(text)}" target="_blank" rel="noopener">${esc(text)}</a>`
+          : esc(text);
+        return `<div class="k">${esc(propLabel(k))}</div><div class="v">${value}</div>`;
+      })
+      .join("");
   const basename = (p) => String(p).split(/[\\/]/).pop();
   const fileUrl = (p) =>
     "file:///" +
@@ -1558,7 +1583,7 @@
           ${call ? `<div class="tcall who-call">${callHtml(n, call)}</div>` : ""}
           <div class="kv">
             <div class="k">Duration</div><div class="v">${fmtDur(n.duration)}</div>
-            ${n.v.description ? `<div class="k">Summary</div><div class="v">${esc(n.v.description.summary)}</div>` : ""}
+            ${n.v.description ? descriptionRows(n.v.description) : ""}
             ${n.v.tags.length ? `<div class="k">Tags</div><div class="v">${chipsHtml(n.v.tags, Infinity, 40)}</div>` : ""}
             ${n.v.mcp ? `<div class="k">MCP</div><div class="v"><span class="badge-inline">${esc(n.v.mcp.mode)}</span></div>` : ""}
             <div class="k">Id</div><div class="v mono-sm">${esc(n.id)}</div>

package/dist/output/writers/views.d.ts

@@ -21,9 +21,10 @@ export interface NodeView {
     readonly duration: number;
     /** Absolute path to this node's own `.log`. */
     readonly logFile: string;
-    /** What the definition's `.describe()` said; absent when it said nothing. */
+    /** What the definition's `.describe()` said — its summary and any further props. */
     readonly description?: {
         readonly summary: string;
+        readonly [prop: string]: unknown;
     };
     /** The definition's `.mcp()` exposure; absent when it is not exposed. */
     readonly mcp?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omkit",
-  "version": "0.8.23",
+  "version": "0.8.25",
   "description": "A tiny runtime for developer workflows: typed actions that pass runtime capabilities and emit typed events, under one run and one shared log. The operational/runtime layer to tskb's knowledge layer.",
   "type": "module",
   "main": "./dist/index.js",