@poe-platform/safe-js 0.1.608 → 0.1.609

package/dist/safe-js/chunks/{cli-runtime-VLWGT5A5.js → cli-runtime-LZP2LBNP.js}

@@ -15,7 +15,7 @@ import {
 } from "./chunk-EWBAW6TL.js";
 import {
   parseMcpConfig
-} from "./chunk-3XEB5VOF.js";
+} from "./chunk-YPVGFXBW.js";
 import {
   lint
 } from "./chunk-V3HUN3KA.js";
@@ -263,7 +263,7 @@ async function runScriptFile(filepath, parsed, options) {
     import("./dump-VMJ4VMRG.js"),
     import("./runtime-modules-CFVIFXKY.js"),
     import("./fs-NI2LBAR6.js"),
-    import("./mcp-VOKLK2OR.js")
+    import("./mcp-R5ZZ2OSB.js")
   ]);
   const loaded = loadExecutableSource(filepath, await options.readFile(filepath, "utf8"));
   const meta = {
@@ -682,4 +682,4 @@ export {
   exitCodeForError,
   runCli
 };
-//# sourceMappingURL=cli-runtime-VLWGT5A5.js.map
+//# sourceMappingURL=cli-runtime-LZP2LBNP.js.map

package/dist/safe-js/chunks/{mcp-VOKLK2OR.js → mcp-R5ZZ2OSB.js}

@@ -1,11 +1,11 @@
 import {
   makeMcpModule
-} from "./chunk-UGKBY5DP.js";
-import "./chunk-3XEB5VOF.js";
+} from "./chunk-OCDABGFC.js";
+import "./chunk-YPVGFXBW.js";
 import "./chunk-NRMLGDZI.js";
 import "./chunk-QY3SVPUP.js";
 import "./chunk-4YIDX44G.js";
 export {
   makeMcpModule
 };
-//# sourceMappingURL=mcp-VOKLK2OR.js.map
+//# sourceMappingURL=mcp-R5ZZ2OSB.js.map

package/dist/safe-js/cli.js

@@ -13,7 +13,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 async function runCli(argv, options = {}) {
   if (!argv.includes("--help") && !argv.includes("-h")) {
-    const runtime = await import("./chunks/cli-runtime-VLWGT5A5.js");
+    const runtime = await import("./chunks/cli-runtime-LZP2LBNP.js");
     return runtime.runCli(argv, options, createUsage());
   }
   const brokenPipe = createBrokenPipeState();
@@ -32,7 +32,7 @@ async function runCli(argv, options = {}) {
         stderr.write(`${error instanceof Error ? error.message : String(error)}
 `);
         if (brokenPipe.closed) return 0;
-        const { exitCodeForError } = await import("./chunks/cli-runtime-VLWGT5A5.js");
+        const { exitCodeForError } = await import("./chunks/cli-runtime-LZP2LBNP.js");
         return exitCodeForError(error);
       }
     }

package/dist/safe-js/index.js

@@ -6,7 +6,7 @@ import {
 } from "./chunks/chunk-OYDR72TJ.js";
 import {
   makeMcpModule
-} from "./chunks/chunk-UGKBY5DP.js";
+} from "./chunks/chunk-OCDABGFC.js";
 import {
   AgentSpawnError,
   EnvAccessError,
@@ -30,7 +30,7 @@ import {
 } from "./chunks/chunk-EWBAW6TL.js";
 import {
   parseMcpConfig
-} from "./chunks/chunk-3XEB5VOF.js";
+} from "./chunks/chunk-YPVGFXBW.js";
 import {
   lint
 } from "./chunks/chunk-V3HUN3KA.js";

package/dist/toolcraft-design/command-registry.d.ts

@@ -0,0 +1,11 @@
+export interface DesignCommand {
+    id: string;
+    label: string;
+    keys: readonly string[];
+    enabled?: () => boolean;
+    run: () => void;
+}
+export declare function createCommandRegistry(commands: readonly DesignCommand[]): {
+    dispatch(key: string): boolean;
+    list(): DesignCommand[];
+};

package/dist/toolcraft-design/dashboard/dashboard.d.ts

@@ -1,3 +1,4 @@
+import { type RenderPerformanceSnapshot } from "../render-performance.js";
 import type { FooterHint } from "./components/footer.js";
 import type { Command, DashboardStats, OutputItem } from "./types.js";
 export type DashboardOptions = {
@@ -8,6 +9,8 @@ export type DashboardOptions = {
     hints?: FooterHint[];
     stdin?: NodeJS.ReadStream;
     stdout?: NodeJS.WriteStream;
+    /** Observe bounded performance snapshots without forcing idle repaints. */
+    onPerformance?: (stats: RenderPerformanceSnapshot) => void;
 };
 export type Dashboard = {
     start(): void;
@@ -16,5 +19,6 @@ export type Dashboard = {
     updateStats(stats: Partial<DashboardStats>): void;
     onCommand(handler: (cmd: Command) => void): void;
     destroy(): void;
+    getPerformance(): RenderPerformanceSnapshot;
 };
 export declare function createDashboard(opts?: DashboardOptions): Dashboard;

package/dist/toolcraft-design/dashboard/index.d.ts

@@ -1,4 +1,6 @@
 export { createDashboard } from "./dashboard.js";
+export { createDashboardLineBuffer, createStreamingDashboardLineBuffer } from "./line-buffer.js";
+export { limitOutputPreview, createOutputPreviewBuffer } from "./output-preview.js";
 export { shouldUseInteractiveDashboard } from "./should-use-dashboard.js";
 export type { Dashboard, DashboardOptions } from "./dashboard.js";
 export { renderDashboardSnapshot } from "./snapshot.js";

package/dist/toolcraft-design/dashboard/line-buffer.d.ts

@@ -0,0 +1,9 @@
+export declare function createDashboardLineBuffer(emit: (line: string) => void): {
+    push(chunk: string): void;
+    flush(): void;
+    preview(): string;
+};
+export declare function createStreamingDashboardLineBuffer(emit: (line: string, id: string) => void): {
+    push(chunk: string): void;
+    flush(): void;
+};

package/dist/toolcraft-design/dashboard/output-preview.d.ts

@@ -0,0 +1,9 @@
+export declare const MAX_OUTPUT_PREVIEW_CHARS = 16384;
+export declare const OUTPUT_TRUNCATION_NOTICE = "[Output truncated: showing latest text]\n";
+export declare function retainOutputTail(text: string, maxChars: number): string;
+export declare function limitOutputPreview(text: string): string;
+/** Keep live deltas bounded without rebuilding the complete preview for every delta. */
+export declare function createOutputPreviewBuffer(): {
+    push(text: string): void;
+    text(): string;
+};

package/dist/toolcraft-design/dashboard/types.d.ts

@@ -1,5 +1,7 @@
 export type OutputItemKind = "info" | "success" | "error" | "tool" | "status";
 export type OutputItem = {
+    /** Reusing an id replaces its retained preview in place, without changing held history. */
+    id?: string;
     kind: OutputItemKind;
     text: string;
     ts: number;
@@ -13,7 +15,7 @@ export type DashboardStats = {
     elapsedMs: number;
     currentAction?: string;
 };
-export type Command = "quit" | "forceQuit" | "edit" | "pause" | "retry" | "view-log";
+export type Command = "quit" | "forceQuit" | "edit" | "pause" | "retry" | "view-log" | "scroll-up" | "scroll-down" | "page-up" | "page-down" | "follow" | "render-stats";
 export type DashboardState = {
     output: OutputItem[];
     stats: DashboardStats;

package/dist/toolcraft-design/event-groups.d.ts

@@ -0,0 +1,19 @@
+export interface GroupEvent {
+    id: string;
+    text: string;
+    error?: boolean;
+}
+export interface EventGroupRow extends GroupEvent {
+    groupId: string;
+    header?: boolean;
+    expanded?: boolean;
+}
+export declare function createEventGroups({ capacity, children }: {
+    capacity: number;
+    children: number;
+}): {
+    append(groupId: string, event: GroupEvent): void;
+    toggle(groupId: string): void;
+    rows(offset: number, height: number): EventGroupRow[];
+};
+export declare function renderEventGroupRows(rows: readonly EventGroupRow[], width: number): string[];

package/dist/toolcraft-design/index.d.ts

@@ -34,7 +34,7 @@ export type { RenderTemplateOptions, TemplateEscape } from "./components/templat
 export { openExternal } from "./components/browser.js";
 export * as acp from "./acp/index.js";
 export * as dashboard from "./dashboard/index.js";
-export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/index.js";
+export { createDashboard, createDashboardLineBuffer, createStreamingDashboardLineBuffer, shouldUseInteractiveDashboard } from "./dashboard/index.js";
 export type { Dashboard, DashboardOptions } from "./dashboard/index.js";
 export * as explorer from "./explorer/index.js";
 export { runExplorer, singleDetail, normalizeExplorerConfig } from "./explorer/index.js";
@@ -60,3 +60,8 @@ export { Screen } from "./screen/screen.js";
 export type { Cell as ScreenCell, ScreenSize, ScreenSurface } from "./screen/screen.js";
 export { packStyle, styleToSgrDelta } from "./screen/style.js";
 export type { PackedStyle } from "./screen/style.js";
+export { createRenderPerformanceMonitor, formatRenderPerformance } from "./render-performance.js";
+export type { RenderPerformanceSnapshot, RenderPercentiles } from "./render-performance.js";
+export { createViewport, selectViewportTail } from "./viewport.js";
+export { createNotices, createCommandRegistry, createOverlayManager, createEventGroups, createTaskTree, renderTaskRows, renderEventGroupRows, renderProgressGroup, createMetric, renderNotice } from "./primitives.js";
+export type { DesignCommand, GroupEvent, EventGroupRow, TaskNode, ProgressItem, InlineNotice } from "./primitives.js";

package/dist/toolcraft-design/inline-notice.d.ts

@@ -0,0 +1,14 @@
+export interface InlineNotice {
+    level: "info" | "success" | "warning" | "error";
+    text: string;
+}
+export declare function renderNotice(notice: InlineNotice, width: number): string;
+/** Notices expire during reads, so an idle terminal needs no repaint timer. */
+export declare function createNotices({ capacity, now }: {
+    capacity: number;
+    now?: () => number;
+}): {
+    put(id: string, notice: InlineNotice, durationMs?: number): void;
+    dismiss(id: string): void;
+    list(): InlineNotice[];
+};

package/dist/toolcraft-design/metric.d.ts

@@ -0,0 +1,8 @@
+export declare function createMetric({ capacity, unit }: {
+    capacity: number;
+    unit: string;
+}): {
+    push(value: number | null): void;
+    samples(): (number | null)[];
+    render(width: number): string;
+};

package/dist/toolcraft-design/overlay-manager.d.ts

@@ -0,0 +1,6 @@
+export declare function createOverlayManager(initialFocus: string): {
+    open(focus: string): AbortSignal;
+    close(): boolean;
+    focus(): string;
+    dispose(): void;
+};

package/dist/toolcraft-design/primitives.d.ts

@@ -0,0 +1,12 @@
+export { createCommandRegistry } from "./command-registry.js";
+export type { DesignCommand } from "./command-registry.js";
+export { createOverlayManager } from "./overlay-manager.js";
+export { createEventGroups, renderEventGroupRows } from "./event-groups.js";
+export type { GroupEvent, EventGroupRow } from "./event-groups.js";
+export { createTaskTree, renderTaskRows } from "./task-tree.js";
+export type { TaskNode } from "./task-tree.js";
+export { renderProgressGroup } from "./progress-group.js";
+export type { ProgressItem } from "./progress-group.js";
+export { createMetric } from "./metric.js";
+export { renderNotice, createNotices } from "./inline-notice.js";
+export type { InlineNotice } from "./inline-notice.js";

package/dist/toolcraft-design/progress-group.d.ts

@@ -0,0 +1,7 @@
+export interface ProgressItem {
+    label: string;
+    completed?: number;
+    total?: number;
+    status?: "running" | "success" | "error";
+}
+export declare function renderProgressGroup(items: readonly ProgressItem[], width: number): string[];

package/dist/toolcraft-design/render-performance.d.ts

@@ -0,0 +1,33 @@
+export interface RenderPercentiles {
+    p50: number;
+    p95: number;
+    max: number;
+}
+export interface RenderPerformanceSnapshot {
+    /** Rolling one-second repaint dispatch rate, with 10ms bucket resolution. */
+    fps: number;
+    frames: number;
+    renders: number;
+    requests: number;
+    coalesced: number;
+    changedCells: number;
+    sampleCount: number;
+    /** Paints exceeding the 60Hz frame budget (16.67ms), cumulative. */
+    slowFrames: number;
+    longestRenderMs: number;
+    renderMs: RenderPercentiles;
+    /** Time from oldest pending input to flush enqueue; terminal presentation is not observable. */
+    inputMs: RenderPercentiles;
+}
+export declare function createRenderPerformanceMonitor(options?: {
+    now?: () => number;
+    sampleSize?: number;
+}): {
+    request(kind: "input" | "update" | "resize"): void;
+    begin(): number;
+    end(startedAt: number, frame: {
+        changedCells: number;
+    }): void;
+    snapshot(): RenderPerformanceSnapshot;
+};
+export declare function formatRenderPerformance(stats: RenderPerformanceSnapshot, width: number): string;

package/dist/toolcraft-design/task-tree.d.ts

@@ -0,0 +1,22 @@
+export interface TaskNode {
+    id: string;
+    parentId?: string;
+    label: string;
+    status: "pending" | "running" | "success" | "error";
+    durationMs?: number;
+}
+export declare function createTaskTree({ capacity }?: {
+    capacity?: number;
+}): {
+    upsert(node: TaskNode): void;
+    remove(id: string): void;
+    toggle(id: string): void;
+    rows(offset: number, height: number): (TaskNode & {
+        depth: number;
+        collapsed: boolean;
+    })[];
+};
+export declare function renderTaskRows(rows: readonly (TaskNode & {
+    depth: number;
+    collapsed: boolean;
+})[], width: number): string[];

package/dist/toolcraft-design/viewport.d.ts

@@ -0,0 +1,18 @@
+/** Select wrapped rows from the tail, retaining only one viewport of rows. */
+export declare function selectViewportTail<T, R>(items: readonly T[], height: number, offset: number, renderRows: (item: T) => readonly R[]): {
+    rows: R[];
+    offset: number;
+};
+export declare function createViewport<T extends {
+    id: string;
+}>({ capacity }: {
+    capacity: number;
+}): {
+    append(item: T): void;
+    scroll(delta: number): void;
+    items(): readonly T[];
+    offset(): number;
+    unseen(): number;
+    find(predicate: (item: T) => boolean): number;
+    follow(): void;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-js",
-  "version": "0.1.608",
+  "version": "0.1.609",
   "description": "Budgeted JavaScript interpreter with explicit host capabilities and resumable execution",
   "type": "module",
   "license": "MIT",
@@ -68,7 +68,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.608",
+    "@poe-platform/safe-fs": "0.1.609",
     "temporal-polyfill": "1.0.4",
     "@petamoriken/float16": "^3.9.3",
     "@formatjs/intl-localematcher": "0.8.13",