@nbtca/prompt 1.4.2 → 1.5.1

package/dist/app/views/docs.js

@@ -4,8 +4,9 @@ import { TextField } from '../fields/text-field.js';
 import { renderDocs } from './docs-render.js';
 import { setVimKeysActive } from '../../core/vim-keys.js';
 import { pickIcon } from '../../core/icons.js';
-import { getCurrentLanguage, t } from '../../i18n/index.js';
-import { localizeDocSections, fetchSections, fetchAllDocs, getArchivedGroups, cleanFileName, displayDocTitle, loadDocForReader, openDocsInBrowser, clearDocsCache, } from '../../features/docs.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';
 let state = { mode: 'loading' };
 let sections = [];
 let archivedGroups = new Map();
@@ -14,19 +15,59 @@ let loadedLanguage = null;
 let currentSectionKey = null;
 let currentArchivedGroupKey = null;
 let currentSearchResults = [];
-// In-app reader navigation: readerCurrentPath is the doc on screen right
-// now; readerNavStack holds the paths of docs visited before it (pushed
-// only when following a link forward, popped on Esc); readerPrevState is
-// whichever file-listing state (files/archivedFiles/searchResults) the
-// reader was entered from, restored once the nav stack empties.
+let sectionsRequestId = 0;
+let metadataRequestId = 0;
+let searchRequestId = 0;
 let readerCurrentPath = null;
 let readerNavStack = [];
 let readerPrevState = null;
 let readerLoadingPrevState = null;
 let readerRequestId = 0;
+let lifecycleGeneration = 0;
+const DOC_HINT_WIDTH = 44;
+function isLifecycleActive(ctx, generation) {
+    return generation === lifecycleGeneration && ctx.signal?.aborted !== true;
+}
 function backLabel() {
     return t().common.back;
 }
+function optionalHint(hint) {
+    return hint === undefined ? {} : { hint };
+}
+function docHint(value) {
+    return value ? truncate(value, DOC_HINT_WIDTH) : undefined;
+}
+function withoutReaderLinksField(value) {
+    const next = { ...value };
+    delete next.readerLinksField;
+    return next;
+}
+function withoutErrorMessage(value) {
+    const next = { ...value };
+    delete next.errorMessage;
+    return next;
+}
+async function runBrowserOpen(ctx, path) {
+    let opened;
+    await ctx.runClassic(async () => {
+        opened =
+            path === undefined
+                ? await openDocsInBrowser(undefined, ctx.signal)
+                : await openDocsInBrowser(path, ctx.signal);
+    });
+    return opened;
+}
+async function openBrowserFromView(ctx, path, generation = lifecycleGeneration) {
+    const opened = await runBrowserOpen(ctx, path);
+    if (!isLifecycleActive(ctx, generation) || opened === true)
+        return;
+    const url = docsUrlFromPath(path);
+    state = {
+        ...state,
+        errorMessage: sanitizeTerminalLine(`${t().docs.browserError}. ${fmt(t().links.openManually, { url })}`),
+    };
+    ctx.rerender();
+}
 function buildSectionsField() {
     const trans = t();
     const options = [
@@ -39,12 +80,16 @@ function buildSectionsField() {
 }
 function buildFilesField(section, maxVisible, initialIndex = 0) {
     const trans = t();
-    const isIndex = (f) => f.name === 'index.md' || f.name.startsWith('index.');
+    const isIndex = (file) => file.name === 'index.md' || file.name.startsWith('index.');
     const index = section.files.find(isIndex);
     const files = section.files.filter((f) => !isIndex(f));
     const options = [
         ...(index ? [{ value: index.path, label: trans.docs.overviewLabel }] : []),
-        ...files.map((f) => ({ value: f.path, label: displayDocTitle(f.path, f.name) })),
+        ...files.map((file) => ({
+            value: file.path,
+            label: displayDocTitle(file.name, file.title),
+            ...optionalHint(docHint(file.summary)),
+        })),
         { value: '__back__', label: backLabel() },
     ];
     return new ListField({ title: section.label, options, maxVisible, initialIndex });
@@ -63,7 +108,7 @@ function buildArchivedGroupsField(groups, maxVisible, initialIndex = 0) {
         return a.localeCompare(b);
     });
     const options = [
-        ...sortedKeys.map((k) => ({ value: k, label: k, hint: String(groups.get(k).length) })),
+        ...sortedKeys.map((k) => ({ value: k, label: k, hint: String(groups.get(k)?.length ?? 0) })),
         { value: '__back__', label: backLabel() },
     ];
     return new ListField({ title: trans.docs.categoryArchived, options, maxVisible, initialIndex });
@@ -74,11 +119,22 @@ function buildArchivedFilesField(groupKey, groupFiles, maxVisible, initialIndex
     const options = [
         ...groupFiles.map((f) => {
             const sub = f.path.split('/').slice(2, -1).join('/');
-            return { value: f.path, label: cleanFileName(f.name), hint: subDirs.size > 1 ? sub : undefined };
+            return {
+                value: f.path,
+                label: displayDocTitle(f.name, f.title),
+                ...optionalHint(docHint(subDirs.size > 1
+                    ? [sanitizeTerminalLine(sub), f.summary].filter(Boolean).join(' · ')
+                    : f.summary)),
+            };
         }),
         { value: '__back__', label: backLabel() },
     ];
-    return new ListField({ title: `${trans.docs.categoryArchived} · ${groupKey}`, options, maxVisible, initialIndex });
+    return new ListField({
+        title: `${trans.docs.categoryArchived} · ${groupKey}`,
+        options,
+        maxVisible,
+        initialIndex,
+    });
 }
 function buildReaderLinksField(links, maxVisible, initialIndex = 0) {
     const trans = t();
@@ -93,8 +149,12 @@ function buildSearchResultsField(matches, maxVisible, initialIndex = 0) {
     const options = [
         ...matches.map((result) => ({
             value: result.path,
-            label: displayDocTitle(result.path, result.name),
-            hint: result.path.includes('/') ? result.path.split('/').slice(0, -1).join('/') : undefined,
+            label: displayDocTitle(result.name, result.title),
+            ...optionalHint(docHint(result.excerpt ||
+                result.summary ||
+                (result.path.includes('/')
+                    ? sanitizeTerminalLine(result.path.split('/').slice(0, -1).join('/'))
+                    : undefined))),
         })),
         { value: '__back__', label: backLabel() },
     ];
@@ -107,7 +167,10 @@ function relocalizeStateFields(value, maxVisible) {
     if (value.mode === 'files' && currentSectionKey) {
         const section = sections.find((candidate) => candidate.key === currentSectionKey);
         return section
-            ? { ...value, filesField: buildFilesField(section, maxVisible, value.filesField?.selectedIndex) }
+            ? {
+                ...value,
+                filesField: buildFilesField(section, maxVisible, value.filesField?.selectedIndex),
+            }
             : value;
     }
     if (value.mode === 'archivedGroups') {
@@ -142,11 +205,115 @@ function goToSections() {
     currentSearchResults = [];
     state = { mode: 'sections', sectionsField: buildSectionsField() };
 }
-/** Enters (or re-enters) the reader on `path`. `pushCurrent` distinguishes
- * following a link forward (push readerCurrentPath so Esc can return to it)
- * from navigating backward or entering fresh from a file list (nothing to
- * push -- the caller has already saved/cleared readerPrevState itself). */
+function replaceSection(section) {
+    sections = sections.map((current) => (current.key === section.key ? section : current));
+}
+async function openSectionFiles(ctx, section) {
+    const generation = lifecycleGeneration;
+    if (!isLifecycleActive(ctx, generation))
+        return;
+    const requestId = ++metadataRequestId;
+    currentSectionKey = section.key;
+    state = {
+        mode: 'files',
+        filesField: buildFilesField(section, computeMaxVisible(ctx.bodyRows)),
+    };
+    ctx.rerender();
+    try {
+        const hydrated = await fetchSectionMetadata(section, ctx.signal);
+        if (!isLifecycleActive(ctx, generation) ||
+            requestId !== metadataRequestId ||
+            state.mode !== 'files' ||
+            currentSectionKey !== section.key)
+            return;
+        const localized = localizeDocSections([hydrated], t())[0] ?? hydrated;
+        replaceSection(localized);
+        state = {
+            mode: 'files',
+            filesField: buildFilesField(localized, computeMaxVisible(ctx.bodyRows), state.filesField?.selectedIndex),
+        };
+    }
+    catch {
+        if (!isLifecycleActive(ctx, generation) ||
+            requestId !== metadataRequestId ||
+            state.mode !== 'files' ||
+            currentSectionKey !== section.key)
+            return;
+        state = { ...state, errorMessage: t().docs.loadError };
+    }
+    if (isLifecycleActive(ctx, generation))
+        ctx.rerender();
+}
+async function openArchivedFiles(ctx, groupKey, groupFiles) {
+    const generation = lifecycleGeneration;
+    if (!isLifecycleActive(ctx, generation))
+        return;
+    const requestId = ++metadataRequestId;
+    currentArchivedGroupKey = groupKey;
+    state = {
+        mode: 'archivedFiles',
+        archivedFilesField: buildArchivedFilesField(groupKey, groupFiles, computeMaxVisible(ctx.bodyRows)),
+    };
+    ctx.rerender();
+    try {
+        const hydrated = await fetchDocMetadata(groupFiles, ctx.signal);
+        if (!isLifecycleActive(ctx, generation) ||
+            requestId !== metadataRequestId ||
+            state.mode !== 'archivedFiles' ||
+            currentArchivedGroupKey !== groupKey)
+            return;
+        archivedGroups.set(groupKey, hydrated);
+        state = {
+            mode: 'archivedFiles',
+            archivedFilesField: buildArchivedFilesField(groupKey, hydrated, computeMaxVisible(ctx.bodyRows), state.archivedFilesField?.selectedIndex),
+        };
+    }
+    catch {
+        if (!isLifecycleActive(ctx, generation) ||
+            requestId !== metadataRequestId ||
+            state.mode !== 'archivedFiles' ||
+            currentArchivedGroupKey !== groupKey)
+            return;
+        state = {
+            ...state,
+            errorMessage: t().docs.loadError,
+        };
+    }
+    if (isLifecycleActive(ctx, generation))
+        ctx.rerender();
+}
+async function runSearch(ctx, query) {
+    const generation = lifecycleGeneration;
+    if (!isLifecycleActive(ctx, generation))
+        return;
+    const requestId = ++searchRequestId;
+    state = { mode: 'searchLoading' };
+    ctx.rerender();
+    try {
+        const matches = await searchDocuments(query, ctx.signal);
+        if (!isLifecycleActive(ctx, generation) || requestId !== searchRequestId)
+            return;
+        currentSearchResults = matches;
+        state = {
+            mode: 'searchResults',
+            searchResultsEmpty: matches.length === 0,
+            searchResultsField: buildSearchResultsField(matches, computeMaxVisible(ctx.bodyRows)),
+        };
+    }
+    catch {
+        if (!isLifecycleActive(ctx, generation) || requestId !== searchRequestId)
+            return;
+        currentSearchResults = [];
+        goToSections();
+        state = { ...state, errorMessage: t().docs.loadError };
+    }
+    if (isLifecycleActive(ctx, generation))
+        ctx.rerender();
+}
 async function openInReader(ctx, path, pushCurrent) {
+    const generation = lifecycleGeneration;
+    if (!isLifecycleActive(ctx, generation))
+        return;
     const requestId = ++readerRequestId;
     const previousState = state;
     const previousPath = readerCurrentPath;
@@ -154,30 +321,33 @@ async function openInReader(ctx, path, pushCurrent) {
     state = { mode: 'readerLoading' };
     ctx.rerender();
     try {
-        const doc = await loadDocForReader(path);
-        if (requestId !== readerRequestId)
+        const doc = await loadDocForReader(path, ctx.signal);
+        if (!isLifecycleActive(ctx, generation) || requestId !== readerRequestId)
             return;
         if (pushCurrent && previousPath)
             readerNavStack.push(previousPath);
         readerCurrentPath = path;
         readerLoadingPrevState = null;
-        state = { mode: 'reader', readerTitle: doc.title, readerLines: doc.lines, readerLinks: doc.links };
+        state = {
+            mode: 'reader',
+            readerTitle: doc.title,
+            readerLines: doc.lines,
+            readerLinks: doc.links,
+        };
         ctx.resetScroll();
     }
     catch {
-        if (requestId !== readerRequestId)
+        if (!isLifecycleActive(ctx, generation) || requestId !== readerRequestId)
             return;
         readerLoadingPrevState = null;
         const fallbackState = pushCurrent && previousState.mode === 'reader'
-            ? { ...previousState, readerLinksField: undefined }
+            ? withoutReaderLinksField(previousState)
             : previousState;
         state = { ...fallbackState, errorMessage: t().docs.loadError };
     }
-    ctx.rerender();
+    if (isLifecycleActive(ctx, generation))
+        ctx.rerender();
 }
-/** Enters the reader from a file-listing mode (files/archivedFiles/
- * searchResults) -- saves that listing so Esc can restore it once the nav
- * stack (built by following links from here) empties back out. */
 function enterReaderFrom(ctx, path) {
     readerPrevState = state;
     readerNavStack = [];
@@ -188,6 +358,9 @@ export const docsView = {
     id: 'docs',
     title: t().menu.docs,
     async load(ctx) {
+        const generation = loaded ? lifecycleGeneration : ++lifecycleGeneration;
+        if (!isLifecycleActive(ctx, generation))
+            return;
         if (loaded) {
             const language = getCurrentLanguage();
             if (loadedLanguage !== language) {
@@ -201,23 +374,36 @@ export const docsView = {
             }
             return;
         }
+        const requestId = ++sectionsRequestId;
         state = { mode: 'loading' };
         ctx.rerender();
         try {
-            sections = await fetchSections();
+            const nextSections = await fetchSections(ctx.signal);
+            if (!isLifecycleActive(ctx, generation) || requestId !== sectionsRequestId)
+                return;
+            sections = nextSections;
             loaded = true;
             loadedLanguage = getCurrentLanguage();
             goToSections();
         }
         catch {
+            if (!isLifecycleActive(ctx, generation) || requestId !== sectionsRequestId)
+                return;
             state = { mode: 'error', errorMessage: t().docs.loadError };
         }
-        ctx.rerender();
+        if (isLifecycleActive(ctx, generation))
+            ctx.rerender();
+    },
+    dispose() {
+        lifecycleGeneration += 1;
+        sectionsRequestId += 1;
+        metadataRequestId += 1;
+        searchRequestId += 1;
+        readerRequestId += 1;
+        clearDocsCache();
+        setVimKeysActive(true);
     },
     render(ctx) {
-        // Sync every visible field's scroll window to the *current* terminal
-        // size on every frame (not just construction time) — this is what
-        // keeps a long list correctly windowed across a live resize.
         const maxVisible = computeMaxVisible(ctx.bodyRows);
         state.filesField?.setMaxVisible(maxVisible);
         state.archivedGroupsField?.setMaxVisible(maxVisible);
@@ -226,13 +412,24 @@ export const docsView = {
         state.readerLinksField?.setMaxVisible(maxVisible);
         return renderDocs(state, ctx.size.cols, ctx.bodyRows);
     },
+    isBusy() {
+        return (state.mode === 'loading' || state.mode === 'searchLoading' || state.mode === 'readerLoading');
+    },
     capturesInput() {
         return state.mode === 'search';
     },
+    capturesPageKeys() {
+        return (state.mode === 'sections' ||
+            state.mode === 'files' ||
+            state.mode === 'archivedGroups' ||
+            state.mode === 'archivedFiles' ||
+            state.mode === 'searchResults' ||
+            (state.mode === 'reader' && state.readerLinksField !== undefined));
+    },
     footerHint(tabCount, cols = Number.POSITIVE_INFINITY) {
         if (state.mode === 'search')
             return captureFooterHint(cols);
-        if (state.mode === 'loading' || state.mode === 'error')
+        if (state.mode === 'loading' || state.mode === 'searchLoading' || state.mode === 'error')
             return passiveFooterHint(tabCount, cols);
         if (state.mode === 'readerLoading') {
             return fitFooterHint(cols, `${digitTabHint(tabCount)}q ${t().menu.hintQuit}`, `${digitTabHint(tabCount)}q`, 'q');
@@ -250,6 +447,11 @@ export const docsView = {
         return undefined;
     },
     handleBack(ctx) {
+        if (state.mode === 'searchLoading') {
+            searchRequestId++;
+            goToSections();
+            return true;
+        }
         if (state.mode === 'reader' || state.mode === 'readerLoading') {
             if (state.mode === 'readerLoading') {
                 const previousState = readerLoadingPrevState;
@@ -261,7 +463,7 @@ export const docsView = {
                 return true;
             }
             if (state.readerLinksField) {
-                state = { ...state, readerLinksField: undefined };
+                state = withoutReaderLinksField(state);
                 return true;
             }
             const prevPath = readerNavStack.pop();
@@ -278,7 +480,10 @@ export const docsView = {
             return false;
         }
         if (state.mode === 'archivedFiles') {
-            state = { mode: 'archivedGroups', archivedGroupsField: buildArchivedGroupsField(archivedGroups, computeMaxVisible(ctx.bodyRows)) };
+            state = {
+                mode: 'archivedGroups',
+                archivedGroupsField: buildArchivedGroupsField(archivedGroups, computeMaxVisible(ctx.bodyRows)),
+            };
             return true;
         }
         if (state.mode === 'search') {
@@ -286,7 +491,9 @@ export const docsView = {
             goToSections();
             return true;
         }
-        if (state.mode === 'files' || state.mode === 'archivedGroups' || state.mode === 'searchResults') {
+        if (state.mode === 'files' ||
+            state.mode === 'archivedGroups' ||
+            state.mode === 'searchResults') {
             goToSections();
             return true;
         }
@@ -294,7 +501,7 @@ export const docsView = {
     },
     handleKey(key, ctx) {
         if (state.mode !== 'error' && state.errorMessage)
-            state = { ...state, errorMessage: undefined };
+            state = withoutErrorMessage(state);
         switch (state.mode) {
             case 'sections': {
                 const result = state.sectionsField?.handleKey(key);
@@ -302,11 +509,21 @@ export const docsView = {
                     return;
                 if (result.selected === '__search__') {
                     setVimKeysActive(false);
-                    state = { mode: 'search', searchField: new TextField({ message: t().docs.searchPrompt, placeholder: t().docs.searchPlaceholder, allowEmpty: true }) };
+                    state = {
+                        mode: 'search',
+                        searchField: new TextField({
+                            message: t().docs.searchPrompt,
+                            placeholder: t().docs.searchPlaceholder,
+                            allowEmpty: true,
+                        }),
+                    };
                     return;
                 }
                 if (result.selected === '__refresh__') {
                     clearDocsCache();
+                    sectionsRequestId++;
+                    metadataRequestId++;
+                    searchRequestId++;
                     loaded = false;
                     loadedLanguage = null;
                     sections = [];
@@ -319,25 +536,28 @@ export const docsView = {
                     readerPrevState = null;
                     readerLoadingPrevState = null;
                     readerRequestId++;
-                    void docsView.load?.(ctx);
+                    void docsView.load(ctx);
                     return;
                 }
                 if (result.selected === '__browser__') {
-                    void ctx.runClassic(() => openDocsInBrowser());
+                    void openBrowserFromView(ctx);
                     return;
                 }
                 const section = sections.find((s) => s.key === result.selected);
                 if (!section)
                     return;
                 if (section.key === 'archived') {
+                    metadataRequestId++;
                     currentSectionKey = null;
                     currentArchivedGroupKey = null;
                     archivedGroups = getArchivedGroups(section.files);
-                    state = { mode: 'archivedGroups', archivedGroupsField: buildArchivedGroupsField(archivedGroups, computeMaxVisible(ctx.bodyRows)) };
+                    state = {
+                        mode: 'archivedGroups',
+                        archivedGroupsField: buildArchivedGroupsField(archivedGroups, computeMaxVisible(ctx.bodyRows)),
+                    };
                 }
                 else {
-                    currentSectionKey = section.key;
-                    state = { mode: 'files', filesField: buildFilesField(section, computeMaxVisible(ctx.bodyRows)) };
+                    void openSectionFiles(ctx, section);
                 }
                 return;
             }
@@ -360,9 +580,8 @@ export const docsView = {
                     goToSections();
                     return;
                 }
-                currentArchivedGroupKey = result.selected;
                 const groupFiles = archivedGroups.get(result.selected) ?? [];
-                state = { mode: 'archivedFiles', archivedFilesField: buildArchivedFilesField(result.selected, groupFiles, computeMaxVisible(ctx.bodyRows)) };
+                void openArchivedFiles(ctx, result.selected, groupFiles);
                 return;
             }
             case 'archivedFiles': {
@@ -371,7 +590,10 @@ export const docsView = {
                     return;
                 if (result.selected === '__back__') {
                     currentArchivedGroupKey = null;
-                    state = { mode: 'archivedGroups', archivedGroupsField: buildArchivedGroupsField(archivedGroups, computeMaxVisible(ctx.bodyRows)) };
+                    state = {
+                        mode: 'archivedGroups',
+                        archivedGroupsField: buildArchivedGroupsField(archivedGroups, computeMaxVisible(ctx.bodyRows)),
+                    };
                     return;
                 }
                 enterReaderFrom(ctx, result.selected);
@@ -391,19 +613,7 @@ export const docsView = {
                         goToSections();
                         return;
                     }
-                    void fetchAllDocs().then((all) => {
-                        const matches = all.filter((item) => item.path.toLowerCase().includes(query));
-                        currentSearchResults = matches;
-                        state = {
-                            mode: 'searchResults',
-                            searchResultsEmpty: matches.length === 0,
-                            searchResultsField: buildSearchResultsField(matches, computeMaxVisible(ctx.bodyRows)),
-                        };
-                        ctx.rerender();
-                    }).catch(() => {
-                        state = { mode: 'error', errorMessage: t().docs.loadError };
-                        ctx.rerender();
-                    });
+                    void runSearch(ctx, query);
                 }
                 return;
             }
@@ -422,28 +632,30 @@ export const docsView = {
                 if (state.readerLinksField) {
                     const result = state.readerLinksField.handleKey(key);
                     if (result.cancelled || result.selected === '__back__') {
-                        state = { ...state, readerLinksField: undefined };
+                        state = withoutReaderLinksField(state);
                         return;
                     }
                     if (result.selected)
                         void openInReader(ctx, result.selected, true);
                     return;
                 }
-                // 'f' (Vimium/vim-browser-extension convention: "follow a link"),
-                // not 'l' -- core/vim-keys.ts already reserves 'l' globally,
-                // ranger-style, as an alias for Enter/confirm (vimActive defaults
-                // to true), so a literal 'l' keypress never even reaches here.
                 if (key === 'f' && (state.readerLinks?.length ?? 0) > 0) {
-                    state = { ...state, readerLinksField: buildReaderLinksField(state.readerLinks ?? [], computeMaxVisible(ctx.bodyRows)) };
+                    state = {
+                        ...state,
+                        readerLinksField: buildReaderLinksField(state.readerLinks ?? [], computeMaxVisible(ctx.bodyRows)),
+                    };
                     return;
                 }
                 if (key === 'b') {
-                    void ctx.runClassic(() => openDocsInBrowser(readerCurrentPath ?? undefined));
+                    void openBrowserFromView(ctx, readerCurrentPath ?? undefined);
                     return;
                 }
                 return;
             }
-            default:
+            case 'error':
+            case 'loading':
+            case 'readerLoading':
+            case 'searchLoading':
                 return;
         }
     },

package/dist/app/views/events-render.js

@@ -3,29 +3,15 @@ import { t } from '../../i18n/index.js';
 import { renderListFieldWithContext } from '../fields/list-field.js';
 import { renderCountdownBanner, renderEventBrief } from '../../features/calendar.js';
 import { renderHeatmap } from '../../features/calendar-heatmap.js';
-import { visualWidth, wrapAnsiToVisualWidth } from '../../core/text.js';
+import { wrapAnsiWithIndent } from '../../core/text.js';
+import { loadingLines } from '../../core/components/spinner.js';
 function wrappedIndentedLines(label, cols, style) {
-    const width = Number.isFinite(cols) ? Math.max(1, Math.floor(cols ?? 1)) : Number.POSITIVE_INFINITY;
-    const styled = style(label);
-    const styledWidth = visualWidth(styled);
-    const preferredIndent = visualWidth(space.indent) < width ? space.indent : '';
-    const indent = preferredIndent
-        && styledWidth > width - visualWidth(preferredIndent)
-        && styledWidth <= width
-        ? ''
-        : preferredIndent;
-    const contentWidth = Math.max(1, width - visualWidth(indent));
-    return wrapAnsiToVisualWidth(styled, contentWidth).map((line) => `${indent}${line}`);
+    return wrapAnsiWithIndent(style(label), cols ?? Number.POSITIVE_INFINITY, space.indent);
 }
 function wrappedRenderedLine(line, cols) {
     const content = line.startsWith(space.indent) ? line.slice(space.indent.length) : line;
     return wrappedIndentedLines(content, cols, (value) => value);
 }
-// Lines a fully-expanded hub needs: banner+blank (2) + heatmap+blank (12) +
-// recent-activity heading+up to 5 events+blank (7) + hubField
-// (title+blank+6 options, 8) = 29. Below this, a terminal can't fit the
-// heatmap without pushing the menu into scroll territory — better to keep
-// it as the existing drill-down destination than show a truncated grid.
 const EXPANDED_HUB_MIN_BODY_ROWS = 29;
 function renderHubBody(state, now, bodyRows, cols) {
     const trans = t();
@@ -38,7 +24,10 @@ function renderHubBody(state, now, bodyRows, cols) {
         lines.push(...banner.split('\n'), '');
     const buckets = state.heatmapBuckets;
     if (bodyRows >= EXPANDED_HUB_MIN_BODY_ROWS && buckets && buckets.length > 0) {
-        lines.push(...renderHeatmap(buckets, now, { color: true, cols }).split('\n'));
+        lines.push(...renderHeatmap(buckets, now, {
+            color: true,
+            ...(cols === undefined ? {} : { cols }),
+        }).split('\n'));
         lines.push('');
     }
     if (state.recentEvents && state.recentEvents.length > 0) {
@@ -73,16 +62,15 @@ export function renderEvents(state, now, bodyRows = 100, cols) {
     const trans = t();
     switch (state.mode) {
         case 'loading':
-            return wrappedIndentedLines(trans.calendar.loading, cols, type.hint);
+            return loadingLines(trans.calendar.loading, cols);
         case 'hub':
             return renderHubBody(state, now, bodyRows, cols);
         case 'heatmap':
-            // renderHeatmap() already prints its own title (space.indent +
-            // type.heading), so this mode doesn't add a second heading on top —
-            // unlike Schedule's 'week'/'unresolved' modes, which wrap a
-            // title-less renderer.
             return state.heatmapBuckets && state.heatmapBuckets.length > 0
-                ? renderHeatmap(state.heatmapBuckets, now, { color: true, cols }).split('\n')
+                ? renderHeatmap(state.heatmapBuckets, now, {
+                    color: true,
+                    ...(cols === undefined ? {} : { cols }),
+                }).split('\n')
                 : wrappedIndentedLines(trans.calendar.noEvents, cols, type.hint);
         case 'list':
             return state.listField?.render(bodyRows, cols) ?? [];
@@ -92,14 +80,20 @@ export function renderEvents(state, now, bodyRows = 100, cols) {
                 ...wrappedIndentedLines(state.detailMeta ?? '', cols, type.hint),
                 '',
                 ...(state.detailDescription
-                    ? state.detailDescription.split('\n').flatMap((line) => wrappedIndentedLines(line, cols, type.body))
+                    ? state.detailDescription
+                        .split('\n')
+                        .flatMap((line) => wrappedIndentedLines(line, cols, type.body))
                     : wrappedIndentedLines(trans.calendar.noDescription, cols, type.hint)),
                 '',
-                ...(state.statusMessage ? [...wrappedIndentedLines(state.statusMessage, cols, type.hint), ''] : []),
+                ...(state.statusMessage
+                    ? [...wrappedIndentedLines(state.statusMessage, cols, type.hint), '']
+                    : []),
             ];
             return state.detailField
                 ? renderListFieldWithContext(context, state.detailField, bodyRows, cols)
-                : Number.isFinite(bodyRows) ? context.slice(0, Math.max(0, Math.floor(bodyRows))) : context;
+                : Number.isFinite(bodyRows)
+                    ? context.slice(0, Math.max(0, Math.floor(bodyRows)))
+                    : context;
         }
         case 'search':
             return state.searchField?.render(cols) ?? [];