@nbtca/prompt 1.3.1 → 1.4.1

package/dist/features/calendar.js

@@ -1,13 +1,18 @@
-import { loadCalendar, FeedFetchError, FeedParseError } from '@nbtca/nbtcal';
+import { loadCalendar, FeedFetchError, FeedParseError, eventToICS } from '@nbtca/nbtcal';
 import chalk from 'chalk';
-import { select, isCancel } from '@clack/prompts';
-import { createSpinner } from '../core/ui.js';
-import { c } from '../core/theme.js';
+import { createSpinner, success, error } from '../core/ui.js';
+import { c, type, space, glyph } from '../core/theme.js';
+import { runMenu, menuFooter } from '../core/components/menu.js';
+import { runTextInput } from '../core/components/text-input.js';
 import { pickIcon } from '../core/icons.js';
-import { padEndV, truncate } from '../core/text.js';
+import { padEndV, truncate, visualWidth, wrapAnsiToVisualWidth } from '../core/text.js';
 import { t } from '../i18n/index.js';
+import { enterScreen, breadcrumb } from '../core/transitions.js';
 import { URLS } from '../config/data.js';
 import { renderHeatmap } from './calendar-heatmap.js';
+import { countdownParts, isCountdownUrgent, buildExportFilename, weekRange, monthRange, filterEvents } from './calendar-query.js';
+import { writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
 function formatDate(date) {
     const now = new Date();
     const month = String(date.getMonth() + 1).padStart(2, '0');
@@ -22,7 +27,7 @@ function formatTime(date) {
     const minutes = String(date.getMinutes()).padStart(2, '0');
     return `${hours}:${minutes}`;
 }
-async function loadCalendarOrThrow() {
+export async function loadCalendarOrThrow() {
     try {
         return await loadCalendar({ timeoutMs: 15000 });
     }
@@ -42,11 +47,16 @@ export function toDisplayEvent(e) {
         location: e.location ?? trans.calendar.tbdLocation,
         description: e.description ?? '',
         startDate: e.start,
+        recurring: e.recurring,
+        uid: e.uid,
     };
 }
 export async function fetchEvents() {
     return (await loadCalendarOrThrow()).upcoming({ days: 30 }).map(toDisplayEvent);
 }
+export async function fetchInRange(start, end) {
+    return (await loadCalendarOrThrow()).inRange(start, end).map(toDisplayEvent);
+}
 export async function fetchHeatmapBuckets() {
     const now = new Date();
     const start = new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);
@@ -60,13 +70,15 @@ export function serializeEvents(events) {
         location: event.location,
         description: event.description,
         startDateISO: event.startDate.toISOString(),
+        recurring: event.recurring,
+        uid: event.uid,
     }));
 }
 export function renderEventsTable(events, options) {
     const trans = t();
     const useColor = options?.color !== false;
     if (events.length === 0)
-        return `  ${trans.calendar.noEvents}`;
+        return `${space.indent}${type.hint(trans.calendar.noEvents)}`;
     const id = (s) => s;
     const applyDim = useColor ? chalk.dim : id;
     const applyCyan = useColor ? chalk.cyan : id;
@@ -89,32 +101,66 @@ export function renderEventsTable(events, options) {
     for (const event of events) {
         const dateTime = event.time ? `${event.date} ${event.time}` : event.date;
         const dateCol = padEndV(applyCyan(dateTime), dateWidth);
-        const titleCol = padEndV(applyBold(truncate(event.title, titleWidth)), titleWidth);
+        const marker = event.recurring ? `${pickIcon('↻', '~')} ` : '';
+        const titleText = truncate(`${marker}${event.title}`, titleWidth);
+        const titleCol = padEndV(applyBold(titleText), titleWidth);
         const locCol = applyGray(truncate(event.location, locWidth));
         lines.push(`  ${dateCol}  ${titleCol}  ${locCol}`);
     }
     return lines.join('\n');
 }
+/** One compact line for an "at a glance" activity briefing: date/time · title,
+ * with today's events picked out (bold + accent) so the one thing worth
+ * noticing doesn't read the same as everything else in the list — and a
+ * recurring marker, matching renderEventsTable's convention. Shared by Home's
+ * dashboard panel and the Events hub so the two surfaces read consistently
+ * instead of drifting into slightly different formats. */
+export function renderEventBrief(e, now) {
+    const dot = pickIcon('·', '-');
+    const isToday = e.startDate.getFullYear() === now.getFullYear()
+        && e.startDate.getMonth() === now.getMonth()
+        && e.startDate.getDate() === now.getDate();
+    const dateTime = `${e.date}${e.time ? ' ' + e.time : ''}`;
+    // "Today" gets one consistent brand-colored signal across marker/date/
+    // title — c.warn (yellow) stays reserved for genuine time-pressure
+    // urgency (isCountdownUrgent below), not "happens today" alone, so the
+    // two alert levels never compete for the same color on one line.
+    const marker = isToday ? type.active(pickIcon('●', '*')) : type.hint(pickIcon('·', '-'));
+    const dateStyled = isToday ? type.active(dateTime) : type.hint(dateTime);
+    const titleStyled = isToday ? type.active(e.title) : type.body(e.title);
+    const recurringMark = e.recurring ? ` ${pickIcon('↻', '~')}` : '';
+    return `${space.indent}${marker} ${dateStyled}  ${dot}  ${titleStyled}${recurringMark}`;
+}
+export function renderCountdownBanner(event, now, cols = Number.POSITIVE_INFINITY) {
+    if (!event)
+        return '';
+    const trans = t();
+    const p = countdownParts(event.startDate, now);
+    const inp = trans.calendar.inPrefix;
+    const when = p.past
+        ? trans.calendar.startingNow
+        : p.days > 0
+            ? `${inp} ${p.days}d ${p.hours}h`
+            : p.hours > 0
+                ? `${inp} ${p.hours}h ${p.minutes}m`
+                : `${inp} ${p.minutes}m`;
+    const whenStyled = isCountdownUrgent(p) ? c.warn(when) : type.hint(when);
+    const dot = pickIcon('·', '-');
+    const width = Number.isFinite(cols) ? Math.max(1, Math.floor(cols)) : Number.POSITIVE_INFINITY;
+    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 contentWidth = Math.max(1, width - visualWidth(prefix));
+    const content = `${type.label(trans.calendar.next)}  ${dot}  ${type.body(event.title)}  ${dot}  ${whenStyled}`;
+    return wrapAnsiToVisualWidth(content, contentWidth)
+        .map((line, index) => `${index === 0 ? prefix : continuation}${line}`)
+        .join('\n');
+}
 function renderSubscribeHint() {
     const icon = pickIcon('◆', '*');
     console.log(c.muted(`  ${icon} ${t().calendar.subscribeHint}: ${URLS.calendar}`));
 }
-async function showEventDetail(event) {
-    const trans = t();
-    console.log();
-    console.log(chalk.bold.cyan(`  ${event.title}`));
-    console.log(c.muted(`  ${event.date}${event.time ? ' ' + event.time : ''}  ${pickIcon('·', '|')}  ${event.location}`));
-    if (event.description) {
-        console.log();
-        for (const line of event.description.trim().split('\n')) {
-            console.log(`  ${line}`);
-        }
-    }
-    else {
-        console.log(c.muted(`  ${trans.calendar.noDescription}`));
-    }
-    console.log();
-}
 /** Startup preview: auto-loads and displays upcoming events, then returns. */
 export async function showEventsPreview() {
     const trans = t();
@@ -139,107 +185,142 @@ export async function showEventsPreview() {
         console.log();
     }
 }
-/** Submenu: choose between upcoming and past events. */
-export async function showCalendarMenu() {
-    const trans = t();
-    const choice = await select({
-        message: trans.menu.chooseAction,
-        options: [
-            { value: 'upcoming', label: trans.menu.events, hint: trans.menu.eventsDesc },
-            { value: 'past', label: trans.calendar.pastEvents, hint: trans.calendar.pastEventsDesc },
-            { value: '__back__', label: c.muted(trans.common.back) },
-        ],
-    });
-    if (isCancel(choice) || choice === '__back__')
-        return;
-    if (choice === 'upcoming')
-        await showCalendar();
-    else if (choice === 'past')
-        await showPastEvents();
-}
-/** Past events: shows historical events from the last 30 days with detail selection. */
-export async function showPastEvents() {
+/** Full interactive calendar hub: countdown + heatmap + a menu of range/search/past views. */
+export async function showCalendar() {
     const trans = t();
-    const s = createSpinner(trans.calendar.pastLoading);
+    await enterScreen(breadcrumb(trans.menu.events));
+    const spinner = createSpinner(trans.calendar.loading);
+    let cal;
     try {
-        const cal = await loadCalendarOrThrow();
-        const events = cal.past({ days: 30 }).reverse().map(toDisplayEvent);
-        if (events.length === 0) {
-            s.stop(trans.calendar.noPastEvents);
-            console.log();
-            return;
-        }
-        s.stop(`${events.length} ${trans.calendar.eventsFound}`);
-        console.log();
-        console.log(renderEventsTable(events, { color: true }));
-        console.log();
-        const options = [
-            ...events.map((e, i) => ({
-                value: String(i),
-                label: `${e.date}${e.time ? ' ' + e.time : ''}  ${e.title}`,
-                hint: e.location,
-            })),
-            { value: '__back__', label: c.muted(trans.common.back) },
-        ];
-        const selected = await select({ message: trans.calendar.viewPastDetail, options });
-        if (!isCancel(selected) && selected !== '__back__') {
-            const event = events[Number.parseInt(selected, 10)];
-            if (event)
-                await showEventDetail(event);
-        }
+        cal = await loadCalendarOrThrow();
+        spinner.stop();
     }
     catch {
-        s.error(trans.calendar.error);
+        spinner.error(trans.calendar.error);
         console.log(c.muted('  ' + trans.calendar.errorHint));
         console.log();
+        return;
     }
-}
-/** Full interactive calendar: heatmap + event list + detail selection. */
-export async function showCalendar() {
-    const trans = t();
-    const s = createSpinner(trans.calendar.loading);
-    try {
-        const cal = await loadCalendarOrThrow();
-        const events = cal.upcoming({ days: 30 }).map(toDisplayEvent);
-        const now = new Date();
-        const heatmapBuckets = cal.heatmap({
-            start: new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000),
-            end: now,
-            bucket: 'day',
+    const now = new Date();
+    const upcoming = cal.upcoming({ days: 30 });
+    console.log();
+    console.log(renderCountdownBanner(upcoming[0] ? toDisplayEvent(upcoming[0]) : undefined, now));
+    console.log();
+    console.log(renderHeatmap(cal.heatmap({ start: new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000), end: now, bucket: 'day' }), now, { color: true }));
+    console.log();
+    while (true) {
+        const action = await runMenu({
+            title: trans.calendar.viewDetail,
+            options: [
+                { value: 'upcoming', label: trans.menu.events, hint: String(upcoming.length) },
+                { value: 'week', label: trans.calendar.thisWeek },
+                { value: 'month', label: trans.calendar.thisMonth },
+                { value: 'search', label: trans.calendar.search },
+                { value: 'past', label: trans.calendar.pastEvents },
+            ],
+            footer: menuFooter(),
         });
-        if (events.length === 0) {
-            s.stop(trans.calendar.noEvents);
-            console.log();
-            console.log(renderHeatmap(heatmapBuckets, now, { color: true }));
-            console.log();
+        if (action === null)
             return;
+        if (action === 'upcoming')
+            await showEventList(upcoming, trans.menu.events);
+        else if (action === 'week') {
+            const r = weekRange(now);
+            await showEventList(cal.inRange(r.start, r.end), trans.calendar.thisWeek);
         }
-        s.stop(`${events.length} ${trans.calendar.eventsFound}`);
-        console.log();
-        console.log(renderHeatmap(heatmapBuckets, now, { color: true }));
+        else if (action === 'month') {
+            const r = monthRange(now);
+            await showEventList(cal.inRange(r.start, r.end), trans.calendar.thisMonth);
+        }
+        else if (action === 'search')
+            await showSearch(cal);
+        else if (action === 'past')
+            await showEventList(cal.past({ days: 30 }).reverse(), trans.calendar.pastEvents);
+    }
+}
+async function showEventList(events, title) {
+    const trans = t();
+    if (events.length === 0) {
+        console.log(`${space.indent}${type.hint(trans.calendar.noEvents)}`);
         console.log();
-        console.log(renderEventsTable(events, { color: true }));
+        return;
+    }
+    const display = events.map(toDisplayEvent);
+    console.log();
+    console.log(renderEventsTable(display, { color: true }));
+    console.log();
+    const selected = await runMenu({
+        title,
+        options: events.map((_e, i) => ({
+            value: String(i),
+            label: `${display[i].date}${display[i].time ? ' ' + display[i].time : ''}  ${display[i].title}`,
+            hint: display[i].location,
+        })),
+        footer: menuFooter(),
+    });
+    if (selected === null)
+        return;
+    const raw = events[Number.parseInt(selected, 10)];
+    if (raw)
+        await showEventDetailRaw(raw);
+}
+async function showEventDetailRaw(raw) {
+    const trans = t();
+    const e = toDisplayEvent(raw);
+    console.log();
+    console.log(chalk.bold.cyan(`  ${e.title}`));
+    console.log(c.muted(`  ${e.date}${e.time ? ' ' + e.time : ''}  ${pickIcon('·', '|')}  ${e.location}`));
+    if (raw.recurring)
+        console.log(c.muted(`  ${pickIcon('↻', '~')} ${trans.calendar.recurringLabel}`));
+    if (e.description) {
         console.log();
-        renderSubscribeHint();
+        for (const line of e.description.trim().split('\n'))
+            console.log(`  ${line}`);
+    }
+    else
+        console.log(c.muted(`  ${trans.calendar.noDescription}`));
+    console.log();
+    const action = await runMenu({
+        title: e.title,
+        options: [{ value: 'export', label: trans.calendar.exportIcs }],
+        footer: menuFooter(),
+    });
+    if (action === 'export') {
+        const res = exportEventIcs(raw);
+        if (res.ok)
+            success(`${trans.calendar.exportSuccess}: ${res.path}`);
+        else
+            error(`${trans.calendar.exportError}: ${res.error ?? ''}`);
+    }
+}
+async function showSearch(cal) {
+    const trans = t();
+    const query = await runTextInput({ message: trans.calendar.searchPrompt, placeholder: trans.calendar.searchPlaceholder });
+    if (query === null || !query.trim())
+        return;
+    const now = new Date();
+    const pool = cal.inRange(now, new Date(now.getTime() + 365 * 24 * 60 * 60 * 1000));
+    const results = filterEvents(pool, query);
+    if (results.length === 0) {
+        console.log(`${space.indent}${type.hint(trans.calendar.searchNoResults)}`);
         console.log();
-        const options = [
-            ...events.map((e, i) => ({
-                value: String(i),
-                label: `${e.date}${e.time ? ' ' + e.time : ''}  ${e.title}`,
-                hint: e.location,
-            })),
-            { value: '__back__', label: c.muted(trans.common.back) },
-        ];
-        const selected = await select({ message: trans.calendar.viewDetail, options });
-        if (!isCancel(selected) && selected !== '__back__') {
-            const event = events[Number.parseInt(selected, 10)];
-            if (event)
-                await showEventDetail(event);
+        return;
+    }
+    await showEventList(results, `${trans.calendar.search}: ${query.trim()}`);
+}
+export function exportEventIcs(event, dir = process.cwd()) {
+    const base = buildExportFilename(event);
+    let path = join(dir, base);
+    try {
+        let n = 1;
+        while (existsSync(path)) {
+            path = join(dir, base.replace(/\.ics$/, `-${n}.ics`));
+            n++;
         }
+        writeFileSync(path, eventToICS(event), 'utf-8');
+        return { ok: true, path };
     }
-    catch {
-        s.error(trans.calendar.error);
-        console.log(c.muted('  ' + trans.calendar.errorHint));
-        console.log();
+    catch (err) {
+        return { ok: false, path, error: err instanceof Error ? err.message : String(err) };
     }
 }