@nbtca/prompt 1.5.4 → 1.5.6

package/dist/app/app.js

@@ -76,7 +76,7 @@ export async function runApp() {
         const active = nativeViews[view];
         const tabs = getAppTabs();
         const chrome = resolveChromeLayout(rows);
-        const header = renderHeader(tabs, view, cols, chrome.headerLines);
+        const header = renderHeader(tabs, view, cols, chrome.headerLines, active?.contextPath?.());
         const body = active?.render(ctx) ?? [];
         const bodyScroll = active?.capturesInput?.() ? Number.MAX_SAFE_INTEGER : scroll;
         const height = computeBodyRows(rows, chrome.headerLines, chrome.footerLines);

package/dist/app/chrome.js

@@ -1,7 +1,7 @@
 import { type, space, glyph, brandMark } from '../core/theme.js';
 import { pickIcon } from '../core/icons.js';
 import { t } from '../i18n/index.js';
-import { visualWidth } from '../core/text.js';
+import { clipAnsiToVisualWidth, visualWidth } from '../core/text.js';
 export const HEADER_LINES = 3;
 export const FOOTER_LINES = 2;
 export function resolveChromeLayout(rows) {
@@ -58,11 +58,33 @@ function renderTabs(views, active, cols) {
         return activeNumber;
     return type.active(String(activeIndex + 1));
 }
-export function renderHeader(views, active, cols, lineCount = HEADER_LINES) {
+export function renderContextPath(segments, cols) {
+    const chevron = pickIcon('›', '>');
+    const ellipsis = pickIcon('…', '...');
+    const width = Number.isFinite(cols) ? Math.max(1, Math.floor(cols)) : Number.POSITIVE_INFINITY;
+    for (let start = 0; start < segments.length; start += 1) {
+        const shown = segments.slice(start);
+        const last = shown.length - 1;
+        const plain = [...(start > 0 ? [ellipsis] : []), ...shown].join(` ${chevron} `);
+        if (visualWidth(space.indent + plain) > width)
+            continue;
+        const styled = shown
+            .map((segment, index) => (index === last ? type.label(segment) : type.hint(segment)))
+            .join(type.hint(` ${chevron} `));
+        return space.indent + (start > 0 ? type.hint(`${ellipsis} ${chevron} `) : '') + styled;
+    }
+    const leaf = segments[segments.length - 1] ?? '';
+    const indent = visualWidth(space.indent) < width ? space.indent : '';
+    const room = Math.max(1, width - visualWidth(indent));
+    return indent + type.label(clipAnsiToVisualWidth(leaf, room));
+}
+export function renderHeader(views, active, cols, lineCount = HEADER_LINES, contextPath) {
     if (lineCount === 0)
         return [];
     const mark = brandMark('nbtca');
-    const brand = `${visualWidth(space.indent + mark) <= cols ? space.indent : ''}${mark}`;
+    const brand = contextPath && contextPath.length > 0
+        ? renderContextPath(contextPath, cols)
+        : `${visualWidth(space.indent + mark) <= cols ? space.indent : ''}${mark}`;
     const tabs = renderTabs(views, active, cols);
     const rule = renderRule(cols);
     if (lineCount === 1)

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

@@ -1,14 +1,14 @@
 import { type, space } from '../../core/theme.js';
 import { t } from '../../i18n/index.js';
 import { renderListFieldWithContext } from '../fields/list-field.js';
-import { visualWidth, wrapAnsiToVisualWidth, wrapAnsiWithIndent } from '../../core/text.js';
+import { visualWidth, wrapAnsiHanging, wrapAnsiWithIndent } from '../../core/text.js';
 import { loadingLines } from '../../core/components/spinner.js';
 function hintLines(label, cols) {
     return wrapAnsiWithIndent(type.hint(label), cols, space.indent);
 }
 function renderReader(lines, cols) {
     const contentWidth = Math.max(1, Math.min(80, cols - visualWidth(space.indent)));
-    return lines.flatMap((line) => wrapAnsiToVisualWidth(line, contentWidth).map((part) => `${space.indent}${part}`));
+    return lines.flatMap((line) => wrapAnsiHanging(line, contentWidth).map((part) => `${space.indent}${part}`));
 }
 function listFieldForState(state) {
     switch (state.mode) {

package/dist/app/views/docs.js

@@ -29,6 +29,9 @@ const DOC_HINT_WIDTH = 44;
 function isLifecycleActive(ctx, generation) {
     return generation === lifecycleGeneration && ctx.signal?.aborted !== true;
 }
+function dedupeAdjacent(segments) {
+    return segments.filter((segment, index) => segment !== segments[index - 1]);
+}
 function backLabel() {
     return t().common.back;
 }
@@ -419,6 +422,35 @@ export const docsView = {
     capturesInput() {
         return state.mode === 'search';
     },
+    contextPath() {
+        const trans = t();
+        const section = sections.find((candidate) => candidate.key === currentSectionKey);
+        const branch = currentArchivedGroupKey !== null
+            ? [trans.docs.categoryArchived, currentArchivedGroupKey]
+            : section
+                ? [section.label]
+                : [];
+        switch (state.mode) {
+            case 'reader':
+            case 'readerLoading':
+                return dedupeAdjacent([
+                    trans.menu.docs,
+                    ...branch,
+                    ...(state.readerTitle ? [state.readerTitle] : []),
+                ]);
+            case 'files':
+            case 'archivedFiles':
+            case 'archivedGroups':
+                return [trans.menu.docs, ...branch];
+            case 'sections':
+            case 'search':
+            case 'searchLoading':
+            case 'searchResults':
+            case 'loading':
+            case 'error':
+                return undefined;
+        }
+    },
     scrollsBody() {
         return state.mode === 'reader' && state.readerLinksField === undefined;
     },

package/dist/core/text.js

@@ -212,8 +212,37 @@ function renderWrappedSegment(tokens, start, end, activeSgr, activeOsc8) {
     const osc8AtEnd = advanceOsc8(activeOsc8, tokens, start, end);
     return osc8AtEnd ? `${withReset}${OSC8_CLOSE}` : withReset;
 }
-export function wrapAnsiToVisualWidth(str, maxWidth) {
+const NO_LINE_START = /^[。．、，；：？！）］｝〉》」』】〕・ー～…‥%‰°℃,.;:?!)\]}>]$/u;
+const NO_LINE_END = /^[（［｛〈《「『【〔([{<]$/u;
+function visibleAt(tokens, index) {
+    const token = tokens[index];
+    return token && !token.sgr && token.width > 0 ? token : undefined;
+}
+/**
+ * Pulls a break earlier so a line never begins with closing punctuation or ends
+ * with an opening bracket. Moving the break back keeps every line inside the
+ * width, which letting the character hang past the edge would not.
+ */
+function applyKinsoku(tokens, start, end) {
+    let candidate = end;
+    while (candidate > start + 1) {
+        const opensNext = visibleAt(tokens, candidate);
+        const closesLine = visibleAt(tokens, candidate - 1);
+        if (opensNext && NO_LINE_START.test(opensNext.raw)) {
+            candidate -= 1;
+            continue;
+        }
+        if (closesLine && NO_LINE_END.test(closesLine.raw)) {
+            candidate -= 1;
+            continue;
+        }
+        return candidate;
+    }
+    return end;
+}
+export function wrapAnsiToVisualWidth(str, maxWidth, continuationWidth = maxWidth) {
     const widthLimit = Math.max(1, Math.floor(maxWidth));
+    const nextLimit = Math.max(1, Math.floor(continuationWidth));
     if (!Number.isFinite(maxWidth) || visualWidth(str) <= widthLimit)
         return [str];
     const tokens = tokenizeForWrapping(str);
@@ -234,7 +263,8 @@ export function wrapAnsiToVisualWidth(str, maxWidth) {
                 index += 1;
                 continue;
             }
-            if (width + token.width > widthLimit && hasVisible)
+            const limit = lines.length === 0 ? widthLimit : nextLimit;
+            if (width + token.width > limit && hasVisible)
                 break;
             width += token.width;
             hasVisible = true;
@@ -260,6 +290,11 @@ export function wrapAnsiToVisualWidth(str, maxWidth) {
             end = Math.max(index, start + 1);
             next = end;
         }
+        if (end === next) {
+            const adjusted = applyKinsoku(tokens, start, end);
+            end = adjusted;
+            next = adjusted;
+        }
         lines.push(renderWrappedSegment(tokens, start, end, activeSgr, activeOsc8));
         activeSgr = advanceSgr(activeSgr, tokens, start, next);
         activeOsc8 = advanceOsc8(activeOsc8, tokens, start, next);
@@ -267,6 +302,18 @@ export function wrapAnsiToVisualWidth(str, maxWidth) {
     }
     return lines.length > 0 ? lines : [''];
 }
+const LEADING_MARKER = /^(\s*)((?:[-*+•]|\d{1,3}[.)])\s+)?/u;
+export function wrapAnsiHanging(str, maxWidth) {
+    const width = Number.isFinite(maxWidth)
+        ? Math.max(1, Math.floor(maxWidth))
+        : Number.POSITIVE_INFINITY;
+    const match = LEADING_MARKER.exec(stripAnsi(str));
+    const hang = visualWidth((match?.[1] ?? '') + (match?.[2] ?? ''));
+    if (hang === 0 || hang >= width)
+        return wrapAnsiToVisualWidth(str, width);
+    const continuation = ' '.repeat(hang);
+    return wrapAnsiToVisualWidth(str, width, width - hang).map((line, index) => index === 0 ? line : continuation + line);
+}
 export function wrapAnsiWithIndent(str, maxWidth, preferredIndent = '') {
     const width = Number.isFinite(maxWidth)
         ? Math.max(1, Math.floor(maxWidth))

package/package.json

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