@xenosystem/blocks 0.15.2 → 0.15.3

package/dist/ops/index.d.ts

@@ -449,6 +449,8 @@ declare class ConsoleController {
     /** Collapse adjacent duplicates. */
     setCollapse(collapse: boolean): void;
     /** Drop every record. Emits nothing — clearing a view is not an event a host acts on. */
+    /** Ask the host to recompute the records (a lint, an audit) — nothing changes here until it pushes. */
+    requestRefresh(): void;
     clear(): void;
     /**
      * A record was opened.
@@ -486,6 +488,7 @@ interface ConsoleRenderContext {
         rowHeight: number;
         showTimestamps: boolean;
         emptyHint?: string;
+        showRefresh?: boolean;
     };
 }
 /** Options for {@link createConsolePanel}. */
@@ -563,6 +566,7 @@ interface ConsoleViewModel {
     errors?: string;
     warns?: string;
     multiSource: boolean;
+    showRefresh: boolean;
     sources: ConsoleViewSource[];
     empty: boolean;
     emptyTitle: string;
@@ -585,6 +589,8 @@ type ConsoleUiIntent = {
     kind: 'copyVisible';
 } | {
     kind: 'clear';
+} | {
+    kind: 'refresh';
 } | {
     kind: 'source';
     id: string;
@@ -602,6 +608,7 @@ interface ConsoleViewOptions {
     rowHeight?: number;
     showTimestamps?: boolean;
     emptyHint?: string;
+    showRefresh?: boolean;
 }
 /** Derive the view from the live controller — the runtime calls this on every draw. */
 declare function consoleViewState(c: ConsoleController, options?: ConsoleViewOptions): ConsoleViewModel;

package/dist/ops/index.js

@@ -422,6 +422,10 @@ var ConsoleController = class {
     this.notify();
   }
   /** Drop every record. Emits nothing — clearing a view is not an event a host acts on. */
+  /** Ask the host to recompute the records (a lint, an audit) — nothing changes here until it pushes. */
+  requestRefresh() {
+    this.host.emit("refreshRequest", {});
+  }
   clear() {
     this.records = [];
     this.dropped = 0;
@@ -522,6 +526,12 @@ var consoleManifest = {
       name: "Context Menu Request",
       type: "object",
       description: "The host opens its own menu."
+    },
+    {
+      id: "refreshRequest",
+      name: "Refresh Requested",
+      type: "object",
+      description: "{} \u2014 the person pressed Refresh (config `showRefresh`), so a host whose records are a COMPUTATION (a lint, an audit, a query) re-runs it and pushes a `replace`. A live stream never shows the button."
     }
   ],
   commands: [
@@ -558,6 +568,13 @@ var consoleManifest = {
     }
   ],
   config: [
+    {
+      key: "showRefresh",
+      label: "Refresh button",
+      type: "boolean",
+      defaultValue: false,
+      description: "For records that are computed on demand rather than streamed: a Refresh button that emits `refreshRequest`."
+    },
     {
       key: "maxRecords",
       label: "Buffer size",
@@ -667,6 +684,7 @@ function consoleViewState(c, options = {}) {
     errors: s.counts.error > 0 ? String(s.counts.error) : void 0,
     warns: s.counts.warn > 0 ? String(s.counts.warn) : void 0,
     multiSource: s.sources.length > 1,
+    showRefresh: options.showRefresh === true,
     sources: s.sources.map((src) => ({ id: src.id, label: src.label ?? src.id, on: src.enabled, title: `${src.count} records` })),
     empty: s.rows.length === 0,
     emptyTitle: s.total > 0 ? "No matches" : "No output",
@@ -705,6 +723,9 @@ function applyConsoleUi(c, intent) {
     case "clear":
       c.clear();
       break;
+    case "refresh":
+      c.requestRefresh();
+      break;
     case "source":
       c.toggleSource(intent.id, intent.on);
       break;
@@ -725,7 +746,7 @@ var consoleViewManifest = {
   outputs: [{ id: "ui", name: "UI intent", type: "object", description: "{ kind, \u2026 } \u2014 applied by the runtime to the controller." }],
   commands: []
 };
-var EMPTY = { search: "", levels: [], level: "trace", multiSource: false, sources: [], empty: true, emptyTitle: "No output", emptyHint: "Run something to see its output here.", listed: false, rowHeight: 20, totalHeight: 0, offsetTop: 0, rows: [], countLabel: "0 of 0" };
+var EMPTY = { search: "", levels: [], level: "trace", multiSource: false, showRefresh: false, sources: [], empty: true, emptyTitle: "No output", emptyHint: "Run something to see its output here.", listed: false, rowHeight: 20, totalHeight: 0, offsetTop: 0, rows: [], countLabel: "0 of 0" };
 var BEHAVIOURS = {
   "ops/consolePanelView": (inputs) => inputs.view ?? EMPTY
 };
@@ -758,6 +779,7 @@ var CONSOLE_DECLARATION = {
               children: [
                 { component: "chrome/Badge", when: { input: "view.errors" }, props: { tone: { value: "error" } }, children: [text({ input: "view.errors" })] },
                 { component: "chrome/Badge", when: { input: "view.warns" }, props: { tone: { value: "warning" } }, children: [text({ input: "view.warns" })] },
+                { component: "chrome/IconButton", when: { input: "view.showRefresh" }, props: { icon: { node: { component: "icons/Refresh" } }, label: { value: "Refresh" } }, on: { onClick: ui("refresh") } },
                 { component: "chrome/IconButton", props: { icon: { node: { component: "icons/Copy" } }, label: { value: "Copy visible" } }, on: { onClick: ui("copyVisible") } },
                 { component: "chrome/IconButton", props: { icon: { node: { component: "icons/Clear" } }, label: { value: "Clear" } }, on: { onClick: ui("clear") } }
               ]
@@ -828,6 +850,7 @@ var CONSOLE_DECLARATION = {
 // src/ops/console/react/ConsolePanelView.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var CopyGlyph = ICONS["icons/Copy"];
+var RefreshGlyph = ICONS["icons/Refresh"];
 var ClearGlyph = ICONS["icons/Clear"];
 function ConsoleScroller({ controller, rowHeight = 20, children }) {
   const state = useSyncExternalStore(controller.subscribe, controller.getState, controller.getState);
@@ -882,6 +905,7 @@ function ConsolePanelView({ controller, ...options }) {
         right: /* @__PURE__ */ jsxs(ToolbarGroup, { end: true, children: [
           view.errors ? /* @__PURE__ */ jsx(Badge, { tone: "error", children: view.errors }) : null,
           view.warns ? /* @__PURE__ */ jsx(Badge, { tone: "warning", children: view.warns }) : null,
+          view.showRefresh ? /* @__PURE__ */ jsx(IconButton, { icon: /* @__PURE__ */ jsx(RefreshGlyph, {}), label: "Refresh", onClick: () => ui5({ kind: "refresh" }) }) : null,
           /* @__PURE__ */ jsx(IconButton, { icon: /* @__PURE__ */ jsx(CopyGlyph, {}), label: "Copy visible", onClick: () => ui5({ kind: "copyVisible" }) }),
           /* @__PURE__ */ jsx(IconButton, { icon: /* @__PURE__ */ jsx(ClearGlyph, {}), label: "Clear", onClick: () => ui5({ kind: "clear" }) })
         ] })
@@ -935,7 +959,8 @@ function createConsolePanel(options = {}) {
       const resolve = (config2) => ({
         rowHeight: numberConfig(config2.rowHeight, 20),
         showTimestamps: config2.showTimestamps !== false,
-        emptyHint: typeof config2.emptyHint === "string" ? config2.emptyHint : void 0
+        emptyHint: typeof config2.emptyHint === "string" ? config2.emptyHint : void 0,
+        showRefresh: config2.showRefresh === true
       });
       let renderConfig = resolve(host.config ?? {});
       let unrender = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenosystem/blocks",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "description": "XENO Blocks — rung 3 of the front ladder: components composed into a contract-bearing unit (manifest: ports, intents, commands, agent surface), rendered by @xenosystem/workbench. ONE package, one subpath per family (/auth, /edit, /data, /time, /ops, /trust, /agent), one named export per block — XENO PACKAGE NAMING - STANDARD.md.",
   "license": "UNLICENSED",
   "type": "module",