toolcraft-openapi 0.0.127 → 0.0.129

package/dist/composition.json

@@ -38,12 +38,12 @@
     },
     {
       "name": "toolcraft-openapi",
-      "version": "0.0.127",
+      "version": "0.0.129",
       "license": "MIT"
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.127",
+      "version": "0.0.129",
       "license": "MIT"
     },
     {

package/node_modules/toolcraft-design/dist/explorer/actions.d.ts

@@ -6,6 +6,7 @@ type ExplorerKeypressEvent = Extract<ExplorerEvent, {
 }>["key"];
 export type ActionRuntimeHandles = {
     refresh: () => Promise<void>;
+    reloadDetail: (rowId?: string) => void;
     suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
     openModal: (content: {
         title: string;

package/node_modules/toolcraft-design/dist/explorer/actions.js

@@ -19,6 +19,7 @@ export function buildActionContext(state, _action, source, runtimeHandles, rowsO
         item: source === "detail" ? currentDetailItem(state) : undefined,
         filter: state.filter,
         refresh: runtimeHandles.refresh,
+        reloadDetail: runtimeHandles.reloadDetail,
         suspendAnd: runtimeHandles.suspendAnd,
         openModal: runtimeHandles.openModal,
         toast: runtimeHandles.toast,

package/node_modules/toolcraft-design/dist/explorer/reducer.js

@@ -4,6 +4,7 @@ import { REGION_ALL, REGION_DETAIL, REGION_FOOTER, REGION_HEADER, REGION_LIST, R
 const NO_EFFECTS = [];
 const DEFAULT_ACTION_HANDLES = {
     refresh: async () => undefined,
+    reloadDetail: () => undefined,
     suspendAnd: async (fn) => fn(),
     openModal: () => undefined,
     toast: () => undefined,

package/node_modules/toolcraft-design/dist/explorer/runtime.js

@@ -44,6 +44,9 @@ class ExplorerRuntime {
             refresh: async () => {
                 await this.refreshRowsFromSource();
             },
+            reloadDetail: (rowId) => {
+                this.reloadFocusedDetail(rowId);
+            },
             suspendAnd: async (fn) => this.suspendAnd(fn),
             openModal: (content) => {
                 this.dispatch({ type: "modalOpened", title: content.title, content: content.content });
@@ -62,6 +65,10 @@ class ExplorerRuntime {
             this.settle = { resolve, reject };
             try {
                 this.startTerminal();
+                if (this.config.initialRows !== undefined && this.config.initialRows.length > 0) {
+                    // Seed list/detail before first paint so callers with known rows avoid an empty flash.
+                    this.dispatch({ type: "rowsLoaded", rows: this.config.initialRows });
+                }
                 this.render();
                 this.loadRows().catch((error) => {
                     this.fail(error);
@@ -145,13 +152,25 @@ class ExplorerRuntime {
             rows: this.state.size.rows,
             detailHidden: this.state.layout === "narrow-list-only" || this.state.layout === "too-narrow"
         });
-        void this.detailJobs.schedule(rowId, (ctx) => this.config.detail.items(row, ctx), {
+        const reloadDetail = () => this.reloadFocusedDetail(rowId);
+        void this.detailJobs.schedule(rowId, (ctx) => this.config.detail.items(row, { ...ctx, reloadDetail }), {
             width: layout.detail.width,
             height: layout.detail.height,
             row,
-            signal: new AbortController().signal
+            signal: new AbortController().signal,
+            reloadDetail
         });
     }
+    reloadFocusedDetail(rowId) {
+        const focusedId = this.state.detail.rowId;
+        if (focusedId === null) {
+            return;
+        }
+        if (rowId !== undefined && rowId !== focusedId) {
+            return;
+        }
+        this.renderDetail(focusedId);
+    }
     loadDetailContent(rowId, token, items) {
         const row = this.state.rows.find((candidate) => candidate.id === rowId);
         if (row === undefined) {

package/node_modules/toolcraft-design/dist/explorer/state.d.ts

@@ -30,6 +30,8 @@ export interface DetailCtx {
     height: number;
     signal: AbortSignal;
     row: Row;
+    /** Re-run detail.items for the focused row and repaint the preview pane. */
+    reloadDetail?: () => void;
 }
 export interface Action<R> {
     id: string;
@@ -47,6 +49,8 @@ export interface ActionContext<R> {
     item?: DetailItem;
     filter: string;
     refresh: () => Promise<void>;
+    /** Re-run detail.items for the focused row and repaint the preview pane. */
+    reloadDetail: () => void;
     suspendAnd: <T>(fn: () => Promise<T>) => Promise<T>;
     openModal: (content: {
         title: string;
@@ -73,6 +77,8 @@ export interface ExplorerConfig<R> {
     keybindOverrides?: Record<string, string | string[]>;
     emptyHint?: string;
     initialFilter?: string;
+    /** Synchronous first paint rows; still refreshed via `rows()` after start. */
+    initialRows?: Row[];
 }
 export declare const REGION_HEADER: number;
 export declare const REGION_LIST: number;

package/node_modules/toolcraft-design/dist/explorer/state.js

@@ -17,23 +17,26 @@ export function createInitialState(config, size) {
         rows: normalizeSize(size.rows)
     };
     const multiSelect = config.multiSelect ?? true;
+    const initialRows = config.initialRows ?? [];
+    const initialFilter = config.initialFilter ?? "";
+    // Defer filtering to first rowsLoaded when empty; seed list immediately when provided.
     return {
         title: config.title,
         emptyHint: config.emptyHint ?? "No detail",
-        rows: [],
-        filtered: [],
+        rows: initialRows,
+        filtered: initialRows.map((_, index) => index),
         matchPositions: new Map(),
         cursor: 0,
-        filter: config.initialFilter ?? "",
+        filter: initialFilter,
         filterFocused: false,
         focused: "list",
         detail: {
-            rowId: null,
+            rowId: initialRows[0]?.id ?? null,
             items: null,
             cursor: 0,
             scroll: 0,
-            token: 0,
-            loading: false
+            token: initialRows.length > 0 ? 1 : 0,
+            loading: initialRows.length > 0
         },
         selected: new Set(),
         multiSelect,

package/node_modules/toolcraft-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.127",
+  "version": "0.0.129",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-openapi",
-  "version": "0.0.127",
+  "version": "0.0.129",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -30,7 +30,7 @@
     "toolcraft-openapi-generate": "dist/bin/generate.js"
   },
   "dependencies": {
-    "toolcraft": "0.0.127",
+    "toolcraft": "0.0.129",
     "auth-store": "^0.0.1",
     "fast-string-width": "^3.0.2",
     "fast-wrap-ansi": "^0.2.0",
@@ -46,7 +46,7 @@
     "directory": "packages/toolcraft-openapi"
   },
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.127",
+    "toolcraft-schema": "0.0.129",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*"
   },