@nbtca/prompt 1.5.8 → 1.5.9

package/dist/app/views/docs.js

@@ -7,7 +7,7 @@ import { pickIcon } from '../../core/icons.js';
 import { glyph } from '../../core/theme.js';
 import { fmt, getCurrentLanguage, t } from '../../i18n/index.js';
 import { sanitizeTerminalLine, truncate } from '../../core/text.js';
-import { localizeDocSections, fetchSections, fetchDocMetadata, fetchSectionMetadata, searchDocuments, getArchivedGroups, displayDocTitle, loadDocForReader, openDocsInBrowser, docsUrlFromPath, clearDocsCache, } from '../../features/docs.js';
+import { localizeDocSections, fetchSections, peekSections, fetchDocMetadata, fetchSectionMetadata, searchDocuments, getArchivedGroups, displayDocTitle, loadDocForReader, openDocsInBrowser, docsUrlFromPath, clearDocsCache, } from '../../features/docs.js';
 let state = { mode: 'loading' };
 let sections = [];
 let archivedGroups = new Map();
@@ -29,6 +29,9 @@ const DOC_HINT_WIDTH = 44;
 function isLifecycleActive(ctx, generation) {
     return generation === lifecycleGeneration && ctx.signal?.aborted !== true;
 }
+function sectionsSignature(value) {
+    return value.map((section) => `${section.key}:${String(section.files.length)}`).join('|');
+}
 function dedupeAdjacent(segments) {
     return segments.filter((segment, index) => segment !== segments[index - 1]);
 }
@@ -379,16 +382,27 @@ export const docsView = {
             return;
         }
         const requestId = ++sectionsRequestId;
-        state = { mode: 'loading' };
+        const cached = peekSections();
+        if (cached) {
+            sections = localizeDocSections(cached, t());
+            loadedLanguage = getCurrentLanguage();
+            goToSections();
+        }
+        else {
+            state = { mode: 'loading' };
+        }
         ctx.rerender();
         try {
             const nextSections = await fetchSections(ctx.signal);
             if (!isLifecycleActive(ctx, generation) || requestId !== sectionsRequestId)
                 return;
-            sections = nextSections;
+            const localized = localizeDocSections(nextSections, t());
+            const changed = sectionsSignature(localized) !== sectionsSignature(sections);
+            sections = localized;
             loaded = true;
             loadedLanguage = getCurrentLanguage();
-            goToSections();
+            if (!cached || changed || state.mode !== 'sections')
+                goToSections();
         }
         catch {
             if (!isLifecycleActive(ctx, generation) || requestId !== sectionsRequestId)

package/dist/features/docs-store.js

@@ -0,0 +1,34 @@
+import fs from 'fs';
+import path from 'path';
+import { getStateDir, getWritableStateDir } from '../config/paths.js';
+const INDEX_FILE = 'docs-index.json';
+const MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+function isDocItem(value) {
+    const item = value;
+    return (typeof item?.name === 'string' &&
+        typeof item.path === 'string' &&
+        (item.type === 'file' || item.type === 'dir'));
+}
+export function saveDocsIndex(docs, dir) {
+    try {
+        fs.writeFileSync(path.join(dir ?? getWritableStateDir(), INDEX_FILE), JSON.stringify(docs), {
+            encoding: 'utf8',
+            mode: 0o600,
+        });
+    }
+    catch {
+        /* best effort */
+    }
+}
+export function loadDocsIndex(dir, maxAgeMs = MAX_AGE_MS) {
+    try {
+        const file = path.join(dir ?? getStateDir(), INDEX_FILE);
+        if (Date.now() - fs.statSync(file).mtimeMs > maxAgeMs)
+            return null;
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+        return Array.isArray(parsed) && parsed.every(isDocItem) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/features/docs.js

@@ -11,6 +11,7 @@ import { spawn, execFileSync } from 'child_process';
 import { URLS } from '../config/data.js';
 import { t, fmt, getCurrentLanguage } from '../i18n/index.js';
 import { enterScreen, breadcrumb } from '../core/transitions.js';
+import { loadDocsIndex, saveDocsIndex } from './docs-store.js';
 import { sanitizeTerminalLine, sanitizeTerminalText, stripAnsi, truncate } from '../core/text.js';
 import { clearDocsClients, runDocsClientOperation } from './docs-client.js';
 import { launchBrowserUrl } from './links.js';
@@ -742,7 +743,20 @@ export async function fetchAllDocs(signal) {
     return runDocsClientOperation(signal, (client) => client.listAll());
 }
 export async function fetchSections(signal) {
-    return buildSections(await fetchAllDocs(signal));
+    const docs = await fetchAllDocs(signal);
+    saveDocsIndex(docs);
+    return buildSections(docs);
+}
+export function peekSections() {
+    const docs = loadDocsIndex();
+    if (!docs)
+        return null;
+    try {
+        return buildSections(docs);
+    }
+    catch {
+        return null;
+    }
 }
 async function loadSections() {
     const trans = t();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbtca/prompt",
-  "version": "1.5.8",
+  "version": "1.5.9",
   "type": "module",
   "main": "dist/index.js",
   "exports": {