@nbtca/prompt 1.1.0 → 1.1.2

package/dist/core/logo.js

@@ -1,70 +1,47 @@
 /**
- * Smart logo display module
- * Attempts to display iTerm2 image format logo, falls back to ASCII art
+ * Startup logo: a high-precision braille dot-matrix render of the NBTCA emblem
+ * (generated from CA-logo.svg), shown with the brand blue->cyan gradient.
+ * Falls back to plain ASCII on terminals without Unicode/braille support.
  */
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import gradient from 'gradient-string';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-/**
- * Create blue-toned gradient effect
- */
-function createBlueGradient(text) {
-    const blueGradient = gradient([
-        { color: '#1e3a8a', pos: 0 }, // Deep blue
-        { color: '#0ea5e9', pos: 0.5 }, // Sky blue
-        { color: '#06b6d4', pos: 1 } // Cyan
-    ]);
-    return blueGradient(text);
-}
-/**
- * Display description text (instant, no animation)
- */
-function printDescription() {
-    const tagline = 'To be at the intersection of technology and liberal arts.';
-    console.log();
-    if (process.env['NO_COLOR']) {
-        console.log(tagline);
+import { useUnicodeIcons } from './icons.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TAGLINE = 'To be at the intersection of technology and liberal arts.';
+// Brand gradient: emblem blue -> sky -> cyan.
+const brand = gradient([
+    { color: '#124689', pos: 0 },
+    { color: '#0ea5e9', pos: 0.55 },
+    { color: '#06b6d4', pos: 1 },
+]);
+function readArt(file) {
+    try {
+        return readFileSync(join(__dirname, '../logo', file), 'utf-8').replace(/\s+$/, '');
     }
-    else {
-        console.log(createBlueGradient(tagline));
+    catch {
+        return null;
     }
-    console.log();
 }
-/**
- * Attempt to read and display logo file
- */
+function paint(text, color) {
+    if (!color)
+        return text;
+    // multiline keeps the gradient aligned down the whole block; fall back to a
+    // per-line gradient if the installed gradient-string lacks .multiline.
+    const fn = brand;
+    return typeof fn.multiline === 'function'
+        ? fn.multiline(text)
+        : text.split('\n').map((line) => brand(line)).join('\n');
+}
 export function printLogo() {
-    if (!process.stdout.isTTY) {
+    if (!process.stdout.isTTY)
         return;
-    }
-    try {
-        const logoPath = join(__dirname, '../logo/logo.txt');
-        const logoContent = readFileSync(logoPath, 'utf-8');
-        if (logoContent && logoContent.length > 100) {
-            console.log(logoContent);
-            printDescription();
-            return;
-        }
-    }
-    catch {
-        // iTerm2 logo read failed, continue trying ASCII logo
-    }
-    try {
-        const asciiLogoPath = join(__dirname, '../logo/ascii-logo.txt');
-        const asciiContent = readFileSync(asciiLogoPath, 'utf-8');
-        console.log();
-        const lines = asciiContent.split('\n').filter(line => line.trim());
-        lines.forEach(line => {
-            console.log(createBlueGradient(line));
-        });
-        printDescription();
-    }
-    catch {
-        console.log();
-        console.log(createBlueGradient('  NBTCA'));
-        printDescription();
-    }
+    const color = !process.env['NO_COLOR'];
+    const art = useUnicodeIcons() ? readArt('ca-dotmatrix.txt') : readArt('ascii-logo.txt');
+    console.log();
+    console.log(paint(art ?? 'NBTCA', color));
+    console.log();
+    console.log(color ? brand(TAGLINE) : TAGLINE);
+    console.log();
 }

package/dist/features/docs.js

@@ -1,7 +1,3 @@
-/**
- * 知识库终端查看模块
- * 获取并渲染Markdown文档
- */
 import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
 import chalk from 'chalk';
@@ -10,9 +6,10 @@ import { select, isCancel, confirm, text } from '@clack/prompts';
 import { error, warning, success, createSpinner } from '../core/ui.js';
 import { pickIcon } from '../core/icons.js';
 import { spawn, execFileSync } from 'child_process';
-import { APP_INFO, GITHUB_REPO, URLS } from '../config/data.js';
+import { URLS } from '../config/data.js';
 import { t, fmt } from '../i18n/index.js';
 import { setVimKeysActive } from '../core/vim-keys.js';
+import { createDocsClient, DocsFetchError } from '@nbtca/docs';
 function detectTerminalType() {
     const term = (process.env['TERM'] || '').toLowerCase();
     const termProgram = (process.env['TERM_PROGRAM'] || '').toLowerCase();
@@ -100,15 +97,10 @@ function getRendererOptions(type) {
         }
     };
 }
-// ─── GitHub data layer ────────────────────────────────────────────────────────
-const GITHUB_TOKEN = process.env['GITHUB_TOKEN'] || process.env['GH_TOKEN'];
-const SKIP_NAMES = new Set(['node_modules', 'package.json', 'pnpm-lock.yaml']);
-const DIR_CACHE_TTL_MS = 5 * 60 * 1000;
-const FILE_CACHE_TTL_MS = 10 * 60 * 1000;
 const RENDER_CACHE_TTL_MS = 10 * 60 * 1000;
-const dirCache = new Map();
-const fileCache = new Map();
+const RENDER_CACHE_MAX = 50;
 const renderCache = new Map();
+let docsClient = createDocsClient();
 function getDocCategories() {
     const trans = t();
     return [
@@ -120,143 +112,44 @@ function getDocCategories() {
         { name: trans.docs.categoryArchived, path: 'archived' },
     ];
 }
-function getFreshCacheValue(cache, key) {
-    const entry = cache.get(key);
-    if (!entry)
-        return null;
-    if (entry.expiresAt > Date.now())
-        return entry.value;
-    return null;
-}
-function getAnyCacheValue(cache, key) {
-    const entry = cache.get(key);
-    return entry?.value ?? null;
+function getFreshRender(key) {
+    const entry = renderCache.get(key);
+    return entry && entry.expiresAt > Date.now() ? entry.value : null;
 }
-function setCacheValue(cache, key, value, ttlMs) {
-    cache.set(key, { value, expiresAt: Date.now() + ttlMs });
-}
-const DIR_CACHE_MAX = 30;
-const FILE_CACHE_MAX = 50;
-const RENDER_CACHE_MAX = 50;
-function evictStalest(cache, maxSize) {
-    if (cache.size <= maxSize)
-        return;
-    const oldest = [...cache.entries()]
-        .sort((a, b) => a[1].expiresAt - b[1].expiresAt)
-        .slice(0, cache.size - maxSize);
-    for (const [key] of oldest)
-        cache.delete(key);
+function setRender(key, value) {
+    renderCache.set(key, { value, expiresAt: Date.now() + RENDER_CACHE_TTL_MS });
+    if (renderCache.size > RENDER_CACHE_MAX) {
+        const oldest = [...renderCache.entries()].sort((a, b) => a[1].expiresAt - b[1].expiresAt)[0];
+        if (oldest)
+            renderCache.delete(oldest[0]);
+    }
 }
 function contentFingerprint(content) {
-    const head = content.slice(0, 80);
-    const tail = content.slice(-80);
-    return `${content.length}:${head}:${tail}`;
+    return `${content.length}:${content.slice(0, 80)}:${content.slice(-80)}`;
 }
 export function clearDocsCache() {
-    dirCache.clear();
-    fileCache.clear();
+    docsClient = createDocsClient(); // fresh instance resets dir + file caches
     renderCache.clear();
 }
-async function fetchGitHubDirectory(path = '', options = {}) {
-    const cacheKey = path || '__root__';
-    if (!options.forceRefresh) {
-        const cached = getFreshCacheValue(dirCache, cacheKey);
-        if (cached) {
-            return { data: cached, fromCache: true, staleFallback: false };
-        }
-    }
-    const url = `https://api.github.com/repos/${GITHUB_REPO.owner}/${GITHUB_REPO.repo}/contents/${path}?ref=${GITHUB_REPO.branch}`;
+async function fetchDirectory(path = '') {
     try {
-        const headers = {
-            'Accept': 'application/vnd.github.v3+json',
-            'User-Agent': `NBTCA-CLI/${APP_INFO.version}`,
-        };
-        if (GITHUB_TOKEN)
-            headers['Authorization'] = `Bearer ${GITHUB_TOKEN}`;
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 10000);
-        const response = await fetch(url, { signal: controller.signal, headers });
-        clearTimeout(timeout);
-        if (!response.ok) {
-            const trans = t();
-            if (response.status === 403) {
-                const rateLimitRemaining = response.headers.get('x-ratelimit-remaining');
-                const rateLimitReset = response.headers.get('x-ratelimit-reset');
-                if (rateLimitRemaining === '0' && rateLimitReset) {
-                    const resetDate = new Date(Number.parseInt(rateLimitReset, 10) * 1000);
-                    throw new Error(`${fmt(trans.docs.githubRateLimited, { time: resetDate.toLocaleTimeString() })}\n${trans.docs.githubTokenHint}`);
-                }
-                throw new Error(`${trans.docs.githubForbidden}\n${trans.docs.githubTokenHint}`);
-            }
-            throw new Error(`HTTP ${response.status}`);
-        }
-        const data = (await response.json());
-        const items = data
-            .filter((item) => !item.name.startsWith('.') &&
-            !SKIP_NAMES.has(item.name) &&
-            !(item.type === 'file' && !item.name.endsWith('.md')))
-            .map((item) => ({
-            name: item.name,
-            path: item.path,
-            type: (item.type === 'dir' ? 'dir' : 'file'),
-            sha: item.sha
-        }))
-            .sort((a, b) => {
-            if (a.type === 'dir' && b.type === 'file')
-                return -1;
-            if (a.type === 'file' && b.type === 'dir')
-                return 1;
-            return a.name.localeCompare(b.name);
-        });
-        setCacheValue(dirCache, cacheKey, items, DIR_CACHE_TTL_MS);
-        evictStalest(dirCache, DIR_CACHE_MAX);
-        return { data: items, fromCache: false, staleFallback: false };
+        return await docsClient.listDir(path);
     }
     catch (err) {
-        const staleCached = getAnyCacheValue(dirCache, cacheKey);
-        if (staleCached) {
-            return { data: staleCached, fromCache: true, staleFallback: true };
-        }
         const trans = t();
-        const errorMessage = err instanceof Error
-            ? (err.name === 'AbortError' ? 'Request timed out' : err.message)
+        const msg = err instanceof DocsFetchError
+            ? (err.status === 403 ? `${trans.docs.githubForbidden}\n${trans.docs.githubTokenHint}` : `HTTP ${err.status}`)
             : String(err);
-        throw new Error(fmt(trans.docs.fetchDirFailed, { error: errorMessage }));
+        throw new Error(fmt(trans.docs.fetchDirFailed, { error: msg }));
     }
 }
-async function fetchGitHubRawContent(path, options = {}) {
-    if (!options.forceRefresh) {
-        const cached = getFreshCacheValue(fileCache, path);
-        if (cached) {
-            return { data: cached, fromCache: true, staleFallback: false };
-        }
-    }
-    const url = `https://raw.githubusercontent.com/${GITHUB_REPO.owner}/${GITHUB_REPO.repo}/${GITHUB_REPO.branch}/${path}`;
+async function fetchFileContent(path) {
     try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 15000);
-        const response = await fetch(url, {
-            signal: controller.signal,
-            headers: { 'User-Agent': `NBTCA-CLI/${APP_INFO.version}` },
-        });
-        clearTimeout(timeout);
-        if (!response.ok)
-            throw new Error(`HTTP ${response.status}`);
-        const content = await response.text();
-        setCacheValue(fileCache, path, content, FILE_CACHE_TTL_MS);
-        evictStalest(fileCache, FILE_CACHE_MAX);
-        return { data: content, fromCache: false, staleFallback: false };
+        return await docsClient.getFile(path);
     }
     catch (err) {
-        const staleCached = getAnyCacheValue(fileCache, path);
-        if (staleCached) {
-            return { data: staleCached, fromCache: true, staleFallback: true };
-        }
         const trans = t();
-        const errorMessage = err instanceof Error
-            ? (err.name === 'AbortError' ? 'Request timed out' : err.message)
-            : String(err);
-        throw new Error(fmt(trans.docs.fetchFileFailed, { error: errorMessage }));
+        throw new Error(fmt(trans.docs.fetchFileFailed, { error: String(err) }));
     }
 }
 // ─── Content cleaning ─────────────────────────────────────────────────────────
@@ -401,12 +294,8 @@ async function browseDirectory(initialPath = '') {
         let items;
         try {
             const s = createSpinner(currentPath ? `${trans.docs.loadingDir}: ${currentPath}` : trans.docs.loading);
-            const result = await fetchGitHubDirectory(currentPath);
-            items = result.data;
+            items = await fetchDirectory(currentPath);
             s.stop(currentPath || trans.docs.chooseDoc);
-            if (result.staleFallback) {
-                warning(trans.docs.usingCachedData);
-            }
         }
         catch (err) {
             error(trans.docs.loadError);
@@ -465,13 +354,9 @@ async function viewMarkdownFile(filePath) {
         try {
             ensureMarkedConfigured();
             const s = createSpinner(`${trans.docs.loadingFile}: ${filePath}`);
-            const rawResult = await fetchGitHubRawContent(filePath);
-            if (rawResult.staleFallback) {
-                warning(trans.docs.usingCachedData);
-            }
-            const rawContent = rawResult.data;
+            const rawContent = await fetchFileContent(filePath);
             const fingerprint = contentFingerprint(rawContent);
-            const cachedRendered = getFreshCacheValue(renderCache, filePath);
+            const cachedRendered = getFreshRender(filePath);
             let renderedDoc;
             if (cachedRendered && cachedRendered.fingerprint === fingerprint) {
                 renderedDoc = cachedRendered;
@@ -482,8 +367,7 @@ async function viewMarkdownFile(filePath) {
                 const readTime = estimateReadTime(cleaned);
                 const rendered = await marked(cleaned);
                 renderedDoc = { fingerprint, cleaned, rendered, title, readTime };
-                setCacheValue(renderCache, filePath, renderedDoc, RENDER_CACHE_TTL_MS);
-                evictStalest(renderCache, RENDER_CACHE_MAX);
+                setRender(filePath, renderedDoc);
             }
             s.stop(`${chalk.bold(renderedDoc.title)}  ${chalk.dim(renderedDoc.readTime)}`);
             if (hasGlow()) {
@@ -560,30 +444,18 @@ async function searchDocs() {
     const results = [];
     try {
         const fetches = await Promise.allSettled(categories.map(async (cat) => {
-            const res = await fetchGitHubDirectory(cat.path);
-            return { items: res.data, category: cat.name };
+            const items = await fetchDirectory(cat.path);
+            return { items, category: cat.name };
         }));
         for (const result of fetches) {
             if (result.status !== 'fulfilled')
                 continue;
             for (const item of result.value.items) {
-                const nameLC = item.name.toLowerCase();
-                if (nameLC.includes(keyword)) {
+                if (item.name.toLowerCase().includes(keyword)) {
                     results.push({ name: item.name, path: item.path, category: result.value.category });
                 }
             }
         }
-        // Also search already-cached file content
-        for (const [cachedPath, entry] of fileCache) {
-            if (results.some(r => r.path === cachedPath))
-                continue;
-            if (entry.value.toLowerCase().includes(keyword)) {
-                const name = cachedPath.split('/').pop() || cachedPath;
-                const parentDir = cachedPath.split('/').slice(0, -1).join('/');
-                const matchedCat = categories.find(c => parentDir.startsWith(c.path));
-                results.push({ name, path: cachedPath, category: matchedCat?.name ?? parentDir });
-            }
-        }
         s.stop(`${results.length} ${trans.docs.searchResults}`);
     }
     catch {

package/dist/logo/ca-dotmatrix.txt

@@ -0,0 +1,16 @@
+⠀⠀⠀⠀⠀⠀⠀⠀⢀⣠⣴⡶⢞⢛⣛⣛⣛⣛⣛⡳⠶⣦⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⢀⣤⠾⡋⠁⠘⢽⣛⣿⣯⣿⣭⣯⣿⣛⡁⢴⣮⡝⠷⣤⡀⠀⠀⠀⠀⠀
+⠀⠀⠀⢀⣴⢟⣵⡿⣻⡵⠞⠋⠉⠀⠀⠀⠀⠀⠀⠉⠙⠳⢮⣟⢷⣎⡻⣦⡀⠀⠀⠀
+⠀⠀⣠⡟⣵⡦⣩⠞⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠳⣝⢿⣎⣻⣄⠀⠀
+⠀⣰⠏⣼⣎⣾⡥⠶⠶⠶⠶⢤⣀⠀⠀⠀⠀⠀⣠⡤⠶⠶⠶⠦⣄⡈⢷⣻⣯⠹⣆⠀
+⢰⣟⣾⣿⣾⣥⠀⢀⣀⣀⣀⡀⠈⠳⡄⠀⣴⣯⣅⠀⢀⣀⣀⣀⠀⠙⢮⣷⡹⣃⢻⡆
+⣾⢱⣬⣿⣿⣿⠟⠋⠉⠀⠈⠉⠳⣄⣿⠐⣿⣿⣿⠞⠉⠉⠉⠉⠙⢦⣀⡟⣧⠿⠬⣷
+⣿⢸⡅⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⢰⣶⣿
+⣿⢨⣁⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⢸⢿⣿
+⢿⡸⣿⢿⡄⣧⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣸⠃⢠⡟⠈⢉⡿
+⠸⣧⢷⣏⢷⠘⣆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⠏⠀⡾⣭⡷⣿⠇
+⠀⠹⣎⢽⣎⢷⡘⢧⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣴⠋⢀⡾⣵⡦⣰⠏⠀
+⠀⠀⠙⣧⡻⣷⣝⢦⡙⠲⣤⣀⠀⠀⠀⠀⠀⠀⠀⢀⣠⡴⠋⢁⡴⣫⣌⢛⣼⠋⠀⠀
+⠀⠀⠀⠈⠻⣮⡿⣡⣽⡳⢤⣍⡙⠓⠒⠶⠖⠒⠛⢉⣡⡤⣞⣫⣦⢙⣵⠟⠁⠀⠀⠀
+⠀⠀⠀⠀⠀⠈⠛⢷⣍⡁⠷⣞⣭⣟⣟⣟⣛⢛⣿⣭⣵⠆⢛⣩⡷⠛⠁⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠻⠶⢯⣭⣭⣭⣭⣭⣭⡽⠶⠟⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbtca/prompt",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
@@ -39,6 +39,7 @@
   ],
   "dependencies": {
     "@clack/prompts": "^1.2.0",
+    "@nbtca/docs": "^0.1.0",
     "@nbtca/nbtcal": "^0.2.1",
     "chalk": "^5.6.2",
     "gradient-string": "^3.0.0",

package/dist/logo/logo.txt

@@ -1,12 +0,0 @@
-⠀⠀⠀⠀⠀⠀⣀⠤⡐⣒⣈⡉⡉⠁⠒⠂⠤⣀⠀⠀⠀⠀⠀⠀
-⠀⠀⠀⢀⠔⣋⠄⣀⠤⠜⠒⠒⠒⠒⠣⠤⣁⢤⢙⠢⡀⠀⠀⠀
-⠀⠀⡴⣡⠈⡥⠊⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠑⢬⡠⡈⢦⠀⠀
-⠀⡜⡀⢪⠮⠐⠒⠂⠠⢀⠀⠀⠀⡀⠄⠐⠒⠀⠄⡑⡔⢀⢣⠀
-⠸⠀⢳⣷⣆⠠⠀⠀⠠⡀⠱⠀⣾⣶⣀⠤⠀⠠⢄⠈⠞⡈⡀⠇
-⡇⠄⠸⠉⠁⠀⠀⠀⠀⠈⠈⠀⠉⠉⠀⠀⠀⠀⠀⠁⠀⠇⣠⢸
-⡇⠍⢠⢀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⡄⢋⢸
-⢱⠀⠘⡄⠆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠇⢠⠃⠀⡎
-⠀⢆⢺⠐⡌⢀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⠎⢠⢢⡁⡰⠀
-⠀⠈⠣⡂⢪⠢⡁⠢⢀⡀⠀⠀⠀⠀⣀⠠⠒⢁⠔⠅⢈⠜⠁⠀
-⠀⠀⠀⠙⠢⡀⠴⠑⢂⠤⠉⢉⡉⠁⠤⠐⠊⠤⢅⠔⠋⠀⠀⠀
-⠀⠀⠀⠀⠀⠈⠑⠢⠤⣐⣘⣒⣁⣒⣐⠤⠔⠊⠁⠀⠀⠀⠀⠀