@nbtca/prompt 1.4.2 → 1.5.0

package/dist/config/preferences.js

@@ -1,10 +1,13 @@
 import fs from 'fs';
 import path from 'path';
+import chalk from 'chalk';
 import { getConfigDir, getWritableConfigDir } from './paths.js';
 const DEFAULT_PREFERENCES = {
     iconMode: 'auto',
     colorMode: 'auto',
 };
+const detectedColorLevel = chalk.level;
+const inheritedNoColor = process.env['NO_COLOR'];
 function getPreferencesPath() {
     return path.join(getConfigDir(), 'preferences.json');
 }
@@ -50,30 +53,34 @@ export function resetPreferences() {
     return savePreferences({ ...DEFAULT_PREFERENCES });
 }
 export function resolveIconMode() {
-    const env = (process.env['NBTCA_ICON_MODE'] || '').toLowerCase();
+    const env = (process.env['NBTCA_ICON_MODE'] ?? '').toLowerCase();
     if (env === 'ascii' || env === 'unicode' || env === 'auto') {
         return env;
     }
     return loadPreferences().iconMode;
 }
 export function resolveColorMode() {
-    const env = (process.env['NBTCA_COLOR_MODE'] || '').toLowerCase();
+    const env = (process.env['NBTCA_COLOR_MODE'] ?? '').toLowerCase();
     if (env === 'on' || env === 'off' || env === 'auto') {
         return env;
     }
     return loadPreferences().colorMode;
 }
 export function applyColorModePreference(forcePlain) {
-    if (forcePlain) {
-        process.env['NO_COLOR'] = '1';
-        return;
-    }
-    const mode = resolveColorMode();
+    const mode = forcePlain ? 'off' : resolveColorMode();
     if (mode === 'off') {
         process.env['NO_COLOR'] = '1';
+        chalk.level = 0;
         return;
     }
     if (mode === 'on') {
         delete process.env['NO_COLOR'];
+        chalk.level = 3;
+        return;
     }
+    if (inheritedNoColor === undefined)
+        delete process.env['NO_COLOR'];
+    else
+        process.env['NO_COLOR'] = inheritedNoColor;
+    chalk.level = detectedColorLevel;
 }

package/dist/core/calendar-day.js

@@ -0,0 +1,37 @@
+const DAY_MS = 86_400_000;
+const LOCAL_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+export function parseLocalDate(value) {
+    const match = LOCAL_DATE_PATTERN.exec(value);
+    if (!match)
+        throw new RangeError(`Invalid local date: ${value}`);
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const date = new Date(0);
+    date.setHours(0, 0, 0, 0);
+    date.setFullYear(year, month - 1, day);
+    if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+        throw new RangeError(`Invalid local date: ${value}`);
+    }
+    return date;
+}
+export function parseLocalMonday(value) {
+    const date = parseLocalDate(value);
+    if (date.getDay() !== 1)
+        throw new RangeError(`Local date is not a Monday: ${value}`);
+    return date;
+}
+export function addLocalDays(date, days) {
+    const result = new Date(date.getTime());
+    result.setDate(result.getDate() + days);
+    return result;
+}
+function localDayIndex(date) {
+    const index = new Date(0);
+    index.setUTCHours(0, 0, 0, 0);
+    index.setUTCFullYear(date.getFullYear(), date.getMonth(), date.getDate());
+    return index.getTime() / DAY_MS;
+}
+export function localDayDifference(start, end) {
+    return localDayIndex(end) - localDayIndex(start);
+}

package/dist/core/capabilities.js

@@ -1,5 +1,8 @@
 import { useUnicodeIcons } from './icons.js';
 import { resolveColorMode } from '../config/preferences.js';
+function isTty(value) {
+    return value === true;
+}
 export function deriveReducedMotion(o) {
     const env = o.env ?? process.env;
     if (!o.isTTY)
@@ -8,7 +11,7 @@ export function deriveReducedMotion(o) {
         return true;
     if (env['CI'])
         return true;
-    if ((env['TERM'] || '').toLowerCase() === 'dumb')
+    if ((env['TERM'] ?? '').toLowerCase() === 'dumb')
         return true;
     if (!o.color)
         return true;
@@ -24,13 +27,13 @@ function detectColor() {
         return false;
     if (mode === 'on')
         return true;
-    return !!process.stdout.isTTY;
+    return isTty(process.stdout.isTTY);
 }
 let cached = null;
 export function getCapabilities() {
     if (cached)
         return cached;
-    const isTTY = !!process.stdout.isTTY && !!process.stdin.isTTY;
+    const isTTY = isTty(process.stdout.isTTY) && isTty(process.stdin.isTTY);
     const unicode = useUnicodeIcons();
     const color = detectColor();
     const reducedMotion = deriveReducedMotion({ isTTY, color, unicode });

package/dist/core/components/confirm.js

@@ -19,12 +19,13 @@ export function parseConfirmData(data) {
 export function renderConfirm(opts) {
     const cursor = glyph.cursor();
     const gap = ' '.repeat(cursor.length);
-    const yes = opts.value ? `${type.active(cursor)} ${type.active('Yes')}` : `${gap} ${type.body('Yes')}`;
-    const no = opts.value ? `${gap} ${type.body('No')}` : `${type.active(cursor)} ${type.active('No')}`;
-    return [
-        space.indent + type.label(opts.message),
-        `${space.indent}${yes}   ${no}`,
-    ].join('\n');
+    const yes = opts.value
+        ? `${type.active(cursor)} ${type.active('Yes')}`
+        : `${gap} ${type.body('Yes')}`;
+    const no = opts.value
+        ? `${gap} ${type.body('No')}`
+        : `${type.active(cursor)} ${type.active('No')}`;
+    return [space.indent + type.label(opts.message), `${space.indent}${yes}   ${no}`].join('\n');
 }
 export function runConfirm(config) {
     return new Promise((resolve) => {
@@ -47,12 +48,12 @@ export function runConfirm(config) {
                 finish(value);
                 return;
             }
-            if (ev === 'yes' && value !== true) {
+            if (ev === 'yes' && !value) {
                 value = true;
                 paint();
                 return;
             }
-            if (ev === 'no' && value !== false) {
+            if (ev === 'no' && value) {
                 value = false;
                 paint();
                 return;

package/dist/core/components/menu.js

@@ -6,26 +6,52 @@ import { t } from '../../i18n/index.js';
 export function parseKey(data) {
     const s = data.toString();
     switch (s) {
-        case '\x1b[A': return 'up';
-        case '\x1b[B': return 'down';
-        case '\x1b[H': return 'home';
-        case '\x1b[F': return 'end';
+        case '\x1b[A':
+            return 'up';
+        case '\x1b[B':
+            return 'down';
+        case '\x1b[5~':
+            return 'pageUp';
+        case '\x1b[6~':
+            return 'pageDown';
+        case '\x1b[H':
+        case '\x1b[1~':
+        case '\x1bOH':
+            return 'home';
+        case '\x1b[F':
+        case '\x1b[4~':
+        case '\x1bOF':
+            return 'end';
         case '\r':
-        case '\n': return 'enter';
+        case '\n':
+            return 'enter';
         case '\x03':
-        case '\x1b': return 'cancel';
-        default: return 'none';
+        case '\x1b':
+            return 'cancel';
+        default:
+            return 'none';
     }
 }
-export function nextIndex(current, key, len) {
+export function nextIndex(current, key, len, pageSize = 5) {
     if (len <= 0)
         return 0;
     switch (key) {
-        case 'up': return (current - 1 + len) % len;
-        case 'down': return (current + 1) % len;
-        case 'home': return 0;
-        case 'end': return len - 1;
-        default: return current;
+        case 'up':
+            return (current - 1 + len) % len;
+        case 'down':
+            return (current + 1) % len;
+        case 'pageUp':
+            return Math.max(0, current - Math.max(1, pageSize));
+        case 'pageDown':
+            return Math.min(len - 1, current + Math.max(1, pageSize));
+        case 'home':
+            return 0;
+        case 'end':
+            return len - 1;
+        case 'enter':
+        case 'cancel':
+        case 'none':
+            return current;
     }
 }
 function normalizedWidth(cols) {
@@ -51,8 +77,7 @@ export function renderMenuOption(option, selected, labelWidth = visualWidth(opti
     const padded = padEndV(option.label, paddedWidth);
     const label = selected ? type.active(padded) : type.body(padded);
     const hint = option.hint ? `  ${type.hint(option.hint)}` : '';
-    return wrapAnsiToVisualWidth(`${label}${hint}`, contentWidth)
-        .map((line, index) => `${index === 0 ? prefix : continuation}${line}`);
+    return wrapAnsiToVisualWidth(`${label}${hint}`, contentWidth).map((line, index) => `${index === 0 ? prefix : continuation}${line}`);
 }
 export function renderMenu(state, cols = Number.POSITIVE_INFINITY) {
     const labelWidth = state.options.reduce((width, option) => Math.max(width, visualWidth(option.label)), 0);
@@ -86,7 +111,7 @@ export function runMenu(config) {
             title: config.title,
             options: config.options,
             selectedIndex: index,
-            footer: config.footer,
+            ...(config.footer === undefined ? {} : { footer: config.footer }),
         }));
         const cleanup = () => {
             stdin.removeListener('data', onData);

package/dist/core/components/messages.js

@@ -10,7 +10,15 @@ export function renderMessage(kind, msg) {
     const m = MARKERS[kind];
     return `${space.indent}${m.color(m.icon())} ${msg}`;
 }
-export function success(msg) { console.log(renderMessage('success', msg)); }
-export function error(msg) { console.log(renderMessage('error', msg)); }
-export function warning(msg) { console.log(renderMessage('warn', msg)); }
-export function info(msg) { console.log(renderMessage('info', msg)); }
+export function success(msg) {
+    console.log(renderMessage('success', msg));
+}
+export function error(msg) {
+    console.log(renderMessage('error', msg));
+}
+export function warning(msg) {
+    console.log(renderMessage('warn', msg));
+}
+export function info(msg) {
+    console.log(renderMessage('info', msg));
+}

package/dist/core/components/painter.js

@@ -11,7 +11,9 @@ export function frameRows(frame, cols) {
  * Returns a paint() closure that redraws a fixed-line-count frame in place,
  * erasing the previous frame first. `write` is injectable for tests.
  */
-export function createPainter(frame, write = (s) => { process.stdout.write(s); }) {
+export function createPainter(frame, write = (s) => {
+    process.stdout.write(s);
+}) {
     let painted = 0;
     return () => {
         const f = frame();

package/dist/core/components/spinner.js

@@ -9,16 +9,21 @@ export function renderSpinnerFrame(frame, msg) {
     return `${space.indent}${c.accent(frame)} ${msg}`;
 }
 export function startSpinner(msg = '', opts = {}) {
-    const write = opts.write ?? ((s) => { process.stdout.write(s); });
+    const write = opts.write ??
+        ((s) => {
+            process.stdout.write(s);
+        });
     const reduced = opts.reducedMotion ?? getCapabilities().reducedMotion;
     const frames = pickIcon('u', 'a') === 'u' ? FRAMES_UNICODE : FRAMES_ASCII;
     let current = msg;
     let timer = null;
     let i = 0;
-    const clearLine = () => write(ansi.cursorToCol0 + ansi.eraseDown);
+    const clearLine = () => {
+        write(ansi.cursorToCol0 + ansi.eraseDown);
+    };
     const paint = () => {
         clearLine();
-        write(renderSpinnerFrame(frames[i % frames.length], current));
+        write(renderSpinnerFrame(frames.at(i % frames.length) ?? '|', current));
         i++;
     };
     if (!reduced) {
@@ -40,8 +45,14 @@ export function startSpinner(msg = '', opts = {}) {
             write(line + '\n');
     };
     return {
-        message: (m) => { current = m; },
-        stop: (m) => finish(m ? renderMessage('success', m) : null),
-        error: (m) => finish(m ? renderMessage('error', m) : null),
+        message: (m) => {
+            current = m;
+        },
+        stop: (m) => {
+            finish(m ? renderMessage('success', m) : null);
+        },
+        error: (m) => {
+            finish(m ? renderMessage('error', m) : null);
+        },
     };
 }

package/dist/core/components/text-input.js

@@ -2,28 +2,34 @@ import { glyph, type, space } from '../theme.js';
 import { startRawInput } from './input-session.js';
 import { setVimKeysActive } from '../vim-keys.js';
 import { createPainter } from './painter.js';
-import { visualWidth, wrapAnsiToVisualWidth } from '../text.js';
+import { visualWidth, truncateStart, wrapAnsiToVisualWidth } from '../text.js';
+import { pickIcon } from '../icons.js';
+const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+function graphemes(value) {
+    return Array.from(GRAPHEME_SEGMENTER.segment(value), ({ segment }) => segment);
+}
 export function parseInputData(data) {
     const s = data.toString();
     if (s === '\r' || s === '\n')
         return { type: 'enter' };
     if (s === '\x03')
-        return { type: 'cancel' }; // ctrl-c
+        return { type: 'cancel' };
     if (s === '\x1b')
-        return { type: 'cancel' }; // bare esc
+        return { type: 'cancel' };
     if (s === '\x7f' || s === '\b')
         return { type: 'backspace' };
     if (s.startsWith('\x1b'))
-        return { type: 'none' }; // escape sequence (arrows, etc.)
-    // printable run: drop control chars, keep the rest (supports paste / batched keys)
-    const text = [...s].filter((ch) => ch >= ' ' && ch !== '\x7f').join('');
+        return { type: 'none' };
+    const text = graphemes(s)
+        .filter((ch) => ch >= ' ' && ch !== '\x7f')
+        .join('');
     return text.length > 0 ? { type: 'char', ch: text } : { type: 'none' };
 }
 export function applyInputEvent(value, ev) {
     if (ev.type === 'char')
         return value + ev.ch;
     if (ev.type === 'backspace')
-        return [...value].slice(0, -1).join('');
+        return graphemes(value).slice(0, -1).join('');
     return value;
 }
 export function renderInput(opts) {
@@ -32,21 +38,21 @@ export function renderInput(opts) {
         : Number.POSITIVE_INFINITY;
     const indent = visualWidth(space.indent) < width ? space.indent : '';
     const messageWidth = Math.max(1, width - visualWidth(indent));
-    const messageLines = wrapAnsiToVisualWidth(type.label(opts.message), messageWidth)
-        .map((line) => `${indent}${line}`);
+    const messageLines = wrapAnsiToVisualWidth(type.label(opts.message), messageWidth).map((line) => `${indent}${line}`);
     const visibleValue = opts.secret
-        ? (opts.mask ?? '*').repeat([...opts.value].length)
+        ? (opts.mask ?? '*').repeat(graphemes(opts.value).length)
         : opts.value;
-    const shown = opts.value.length > 0
-        ? type.body(visibleValue)
-        : type.hint(opts.placeholder ?? '');
     const cursor = type.active(glyph.cursor());
     const prefixes = [`${space.indent}${cursor} `, `${cursor} `, cursor, ''];
     const prefix = prefixes.find((candidate) => visualWidth(candidate) < width) ?? '';
     const continuation = ' '.repeat(visualWidth(prefix));
     const inputWidth = Math.max(1, width - visualWidth(prefix));
-    const inputLines = wrapAnsiToVisualWidth(shown, inputWidth)
-        .map((line, index) => `${index === 0 ? prefix : continuation}${line}`);
+    const shown = opts.value.length > 0
+        ? type.body(truncateStart(visibleValue, inputWidth, pickIcon('…', '<')))
+        : type.hint(opts.placeholder ?? '');
+    const inputLines = opts.value.length > 0
+        ? [`${prefix}${shown}`]
+        : wrapAnsiToVisualWidth(shown, inputWidth).map((line, index) => `${index === 0 ? prefix : continuation}${line}`);
     return [...messageLines, ...inputLines].join('\n');
 }
 export function runTextInput(config) {
@@ -55,9 +61,9 @@ export function runTextInput(config) {
         const frame = () => renderInput({
             message: config.message,
             value,
-            placeholder: config.placeholder,
-            secret: config.secret,
-            mask: config.mask,
+            ...(config.placeholder === undefined ? {} : { placeholder: config.placeholder }),
+            ...(config.secret === undefined ? {} : { secret: config.secret }),
+            ...(config.mask === undefined ? {} : { mask: config.mask }),
         });
         const paint = createPainter(frame);
         const onData = (data) => {

package/dist/core/icons.js

@@ -1,6 +1,6 @@
 import { resolveIconMode } from '../config/preferences.js';
 function localeSupportsUnicode() {
-    const locale = `${process.env['LC_ALL'] || ''} ${process.env['LANG'] || ''}`.toLowerCase();
+    const locale = `${process.env['LC_ALL'] ?? ''} ${process.env['LANG'] ?? ''}`.toLowerCase();
     return locale.includes('utf-8') || locale.includes('utf8');
 }
 let cachedUseUnicode = null;
@@ -16,7 +16,7 @@ export function useUnicodeIcons() {
         cachedUseUnicode = true;
         return true;
     }
-    const term = (process.env['TERM'] || '').toLowerCase();
+    const term = (process.env['TERM'] ?? '').toLowerCase();
     if (!process.stdout.isTTY || term === 'dumb') {
         cachedUseUnicode = false;
         return false;

package/dist/core/logo.js

@@ -6,6 +6,7 @@ import { useUnicodeIcons } from './icons.js';
 import { APP_INFO } from '../config/data.js';
 import { typeReveal, materializeBraille } from './motion.js';
 import { brandGradient as brand } from './theme.js';
+import { visualWidth } from './text.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TAGLINE = 'To be at the intersection of technology and liberal arts.';
 function readArt(file) {
@@ -22,8 +23,8 @@ const LOGO_TIERS = [
     { file: 'ca-dotmatrix-small.txt', minCols: 0, minRows: 0 },
 ];
 function dotmatrixFile() {
-    const cols = process.stdout.columns ?? 0;
-    const rows = process.stdout.rows ?? 0;
+    const cols = process.stdout.columns;
+    const rows = process.stdout.rows;
     const tier = LOGO_TIERS.find((t) => cols >= t.minCols && rows >= t.minRows);
     return tier?.file ?? 'ca-dotmatrix-small.txt';
 }
@@ -33,12 +34,21 @@ function paint(text, color) {
     const fn = brand;
     return typeof fn.multiline === 'function'
         ? fn.multiline(text)
-        : text.split('\n').map((line) => brand(line)).join('\n');
+        : text
+            .split('\n')
+            .map((line) => brand(line))
+            .join('\n');
 }
 function loadArt() {
     const art = useUnicodeIcons() ? readArt(dotmatrixFile()) : readArt('ascii-logo.txt');
     return art ?? 'NBTCA';
 }
+export function startupFitsTerminal(rows, cols, art) {
+    const lines = art.split('\n');
+    const fitsRows = rows === undefined || rows >= lines.length + 5;
+    const fitsCols = cols === undefined || lines.every((line) => visualWidth(line) <= cols);
+    return fitsRows && fitsCols;
+}
 export function buildLogoLines() {
     const color = !process.env['NO_COLOR'];
     const paintedArt = paint(loadArt(), color).split('\n');
@@ -54,8 +64,16 @@ export function buildLogoLines() {
 export async function runStartup() {
     if (!process.stdout.isTTY)
         return;
+    const art = loadArt();
+    if (!startupFitsTerminal(process.stdout.rows, process.stdout.columns, art))
+        return;
     const color = !process.env['NO_COLOR'];
     process.stdout.write('\n');
-    await materializeBraille(loadArt(), (s) => paint(s, color));
-    await typeReveal(['', color ? brand(TAGLINE) : TAGLINE, chalk.dim(`@nbtca/prompt  v${APP_INFO.version}`), '']);
+    await materializeBraille(art, (s) => paint(s, color));
+    await typeReveal([
+        '',
+        color ? brand(TAGLINE) : TAGLINE,
+        chalk.dim(`@nbtca/prompt  v${APP_INFO.version}`),
+        '',
+    ]);
 }

package/dist/core/motion.js

@@ -1,10 +1,14 @@
 import { getCapabilities } from './capabilities.js';
 import { ansi } from './canvas.js';
+const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 export async function typeReveal(lines, opts = {}) {
-    const write = opts.write ?? ((s) => { process.stdout.write(s); });
+    const write = opts.write ??
+        ((s) => {
+            process.stdout.write(s);
+        });
     const reduced = opts.reducedMotion ?? getCapabilities().reducedMotion;
     if (reduced) {
         write(lines.join('\n') + '\n');
@@ -21,31 +25,29 @@ function brailleMask(ch) {
     const code = ch.codePointAt(0) ?? 0;
     return code >= BRAILLE_BASE && code <= BRAILLE_BASE + 0xff ? code - BRAILLE_BASE : -1;
 }
-/**
- * Reveals a block of braille dot-matrix art by assembling it dot-by-dot in
- * scattered order, rather than popping it in line by line -- a reveal that
- * matches what the art actually is (an addressable grid of dots) instead of
- * reusing the plain-text typewriter effect built for prose. Non-braille
- * characters (spaces, stray ASCII) pass through unchanged on every frame.
- */
 export async function materializeBraille(art, paint, opts = {}) {
-    const write = opts.write ?? ((s) => { process.stdout.write(s); });
+    const write = opts.write ??
+        ((s) => {
+            process.stdout.write(s);
+        });
     const reduced = opts.reducedMotion ?? getCapabilities().reducedMotion;
     const lines = art.split('\n');
-    const charGrid = lines.map((line) => [...line]);
+    const charGrid = lines.map((line) => Array.from(GRAPHEME_SEGMENTER.segment(line), ({ segment }) => segment));
     const maskGrid = charGrid.map((row) => row.map(brailleMask));
     if (reduced || !maskGrid.some((row) => row.some((m) => m > 0))) {
         write(paint(art) + '\n');
         return;
     }
     const dots = [];
-    maskGrid.forEach((row, r) => row.forEach((mask, c) => {
-        if (mask <= 0)
-            return;
-        for (let bit = 0; bit < 8; bit++)
-            if (mask & (1 << bit))
-                dots.push([r, c, bit]);
-    }));
+    maskGrid.forEach((row, r) => {
+        row.forEach((mask, c) => {
+            if (mask <= 0)
+                return;
+            for (let bit = 0; bit < 8; bit++)
+                if (mask & (1 << bit))
+                    dots.push([r, c, bit]);
+        });
+    });
     const rand = opts.random ?? Math.random;
     for (let i = dots.length - 1; i > 0; i--) {
         const j = Math.floor(rand() * (i + 1));
@@ -56,12 +58,16 @@ export async function materializeBraille(art, paint, opts = {}) {
         }
     }
     const acc = maskGrid.map((row) => row.map(() => 0));
-    const renderFrame = () => charGrid.map((row, r) => row.map((original, c) => {
+    const renderFrame = () => charGrid
+        .map((row, r) => row
+        .map((original, c) => {
         const mask = maskGrid[r]?.[c] ?? -1;
         if (mask <= 0)
             return original;
         return String.fromCodePoint(BRAILLE_BASE + (acc[r]?.[c] ?? 0));
-    }).join('')).join('\n');
+    })
+        .join(''))
+        .join('\n');
     const frameCount = Math.max(1, opts.frames ?? 12);
     const frameMs = opts.frameMs ?? 35;
     let shown = 0;