@nbtca/prompt 1.3.2 → 1.4.1

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

@@ -0,0 +1,317 @@
+import { c, type, space, glyph } from '../../core/theme.js';
+import { pickIcon } from '../../core/icons.js';
+import { t, fmt } from '../../i18n/index.js';
+import { renderListFieldWithContext } from '../fields/list-field.js';
+import { currentWeekNumber, campusWeekday, meetingsOnDay, nextMeeting } from '../../features/schedule-query.js';
+import { renderNextClassBanner, renderWeekGrid, renderUnresolvedItems, renderTodayTimeline, weekdayShortLabel, renderTermDensity, renderMeetingDetail, renderDayTimeline, renderDaySwitcher, } from '../../features/schedule-render.js';
+import { renderEventBrief } from '../../features/calendar.js';
+import { visualWidth, wrapAnsiToVisualWidth } from '../../core/text.js';
+function heading(label) {
+    return `${space.indent}${type.heading(label)}`;
+}
+function hint(label) {
+    return `${space.indent}${type.hint(label)}`;
+}
+function wrappedIndentedLines(label, cols, style) {
+    const width = Number.isFinite(cols) ? Math.max(1, Math.floor(cols)) : Number.POSITIVE_INFINITY;
+    const indent = visualWidth(space.indent) < width ? space.indent : '';
+    const contentWidth = Math.max(1, width - visualWidth(indent));
+    return wrapAnsiToVisualWidth(style(label), contentWidth).map((part) => `${indent}${part}`);
+}
+function headingLines(label, cols) {
+    return wrappedIndentedLines(label, cols, type.heading);
+}
+function hintLines(label, cols) {
+    return wrappedIndentedLines(label, cols, type.hint);
+}
+function wrappedRenderedLine(line, cols) {
+    const content = line.startsWith(space.indent) ? line.slice(space.indent.length) : line;
+    return wrappedIndentedLines(content, cols, (value) => value);
+}
+export function hubShortcuts(tt) {
+    const trans = t();
+    const shortcuts = [
+        { key: 'w', label: trans.timetable.hubFullGrid },
+        { key: 't', label: trans.timetable.hubTermDensity },
+        { key: 's', label: trans.timetable.hubSwitchTerm },
+        { key: 'e', label: trans.timetable.hubExport },
+    ];
+    if (tt.unresolvedItems.length > 0) {
+        shortcuts.push({
+            key: 'u',
+            label: `${pickIcon('⚠', '!')} ${tt.unresolvedItems.length}`,
+            showKey: false,
+            warn: true,
+        });
+    }
+    shortcuts.push({ key: 'x', label: trans.timetable.hubLogout });
+    return shortcuts;
+}
+function renderShortcutLines(shortcuts, cols, compact = false) {
+    const available = Math.max(1, cols - visualWidth(space.indent));
+    const parts = shortcuts.map((shortcut) => {
+        const text = compact
+            ? shortcut.showKey === false ? `[${shortcut.key}] ${shortcut.label}` : `[${shortcut.key}]`
+            : shortcut.showKey === false ? `[${shortcut.label}]` : `[${shortcut.key}] ${shortcut.label}`;
+        return shortcut.warn ? c.warn(text) : type.hint(text);
+    });
+    const lines = [];
+    let current = '';
+    for (const part of parts) {
+        const next = current ? `${current}  ${part}` : part;
+        if (current && visualWidth(next) > available) {
+            lines.push(`${space.indent}${current}`);
+            current = part;
+        }
+        else {
+            current = next;
+        }
+    }
+    if (current)
+        lines.push(`${space.indent}${current}`);
+    return lines;
+}
+function hubPreGridLines(state, now, cols) {
+    const trans = t();
+    const tt = state.timetable;
+    if (!tt || !state.weekOne)
+        return null;
+    const week = currentWeekNumber(state.weekOne, now);
+    const lines = [];
+    const banner = renderNextClassBanner(nextMeeting(tt.meetings, tt.periods, state.weekOne, now), now, cols);
+    lines.push(banner || hint(trans.timetable.noNextClass));
+    lines.push('');
+    const todayWd = campusWeekday(now);
+    if (week < 1) {
+        // weekOne can be a *future* date -- auto-inferred while on break, it
+        // deliberately points at the upcoming term (see academic-calendar.ts)
+        // so it's ready the moment classes start. There is no "today" to show
+        // yet, but the timetable's real week-1 data is already fetched -- show
+        // it as an explicit preview rather than showing no grid at all
+        // regardless of terminal height. The "Week 1 preview" heading keeps it
+        // unambiguous that this isn't "happening right now".
+        lines.push(heading(trans.timetable.termNotStarted));
+        lines.push(hint(fmt(trans.timetable.termStartsIn, {
+            date: state.weekOne,
+            days: String(daysBetween(now, new Date(`${state.weekOne}T00:00:00`))),
+        })));
+        lines.push('');
+        lines.push(heading(trans.timetable.termPreviewWeek));
+        return { inlineLines: lines, fallbackLines: [...lines], week: 1, tt };
+    }
+    const today = meetingsOnDay(tt.meetings, todayWd, week);
+    const weekHeading = heading(trans.timetable.hubWeek);
+    const inlineLines = [
+        ...lines,
+        heading(fmt(trans.timetable.todayHeading, { weekday: weekdayShortLabel(todayWd), week: String(week) })),
+        ...renderTodayTimeline(today, tt.periods, now, cols).split('\n'),
+        weekHeading,
+    ];
+    return { inlineLines, fallbackLines: [...lines, weekHeading], week, tt };
+}
+// Below this width, even an all-empty grid's own per-column floor (3, plus
+// row-head and separator overhead) leaves each of the 7 columns too cramped
+// to show real content -- a technically-fitting but practically unreadable
+// grid isn't better than the single-day view, so width gates the decision
+// just as much as height does.
+const MIN_GRID_COLS = 100;
+/** The one place that decides "does the real week grid fit inline (plus a
+ * floor reserved for the shortcut bar), or does the hub fall back to the
+ * single-day view." Both branches represent the exact same gridCursor, just
+ * rendered differently, so unlike the old non-interactive strip fallback
+ * this decision no longer needs to be exposed to key handling -- arrow
+ * keys/Enter are always meaningful in hub mode regardless of which branch is
+ * currently on screen. */
+function gridFitsInline(precedingLineCount, tt, week, now, bodyRows, cols, cursor, reservedRows) {
+    if (cols < MIN_GRID_COLS)
+        return false;
+    const gridLines = renderWeekGrid(tt.meetings, tt.periods, week, now, cols, cursor).split('\n');
+    return precedingLineCount + gridLines.length <= bodyRows - reservedRows;
+}
+/** Renders the full weekday x period grid if it (plus a floor reserved for
+ * the shortcut bar) fits within bodyRows and cols, otherwise a single day's
+ * detailed timeline -- the day the cursor's own weekday points at (today, by
+ * default). A large terminal genuinely has no excuse to not show the whole
+ * week; a small one is better served by one day shown properly than seven
+ * days crammed into unreadable slivers. Shared by the "this week" and "term
+ * hasn't started yet, preview week 1" branches of renderHubBody -- the same
+ * measure-and-fallback decision, just against a different week number. */
+function renderAdaptiveWeekGrid(inlineLines, fallbackLines, tt, week, todayWd, now, bodyRows, cols, cursor, reservedRows) {
+    if (gridFitsInline(inlineLines.length, tt, week, now, bodyRows, cols, cursor, reservedRows)) {
+        return [...inlineLines, ...renderWeekGrid(tt.meetings, tt.periods, week, now, cols, cursor).split('\n')];
+    }
+    const selectedWd = cursor?.weekday ?? todayWd;
+    const dayMeetings = meetingsOnDay(tt.meetings, selectedWd, week);
+    return [
+        ...fallbackLines,
+        renderDaySwitcher(selectedWd, todayWd, cols),
+        ...renderDayTimeline(dayMeetings, tt.periods, now, selectedWd === todayWd, cursor?.period, cols).split('\n'),
+    ];
+}
+function renderHubBody(state, now, bodyRows, cols) {
+    const tt = state.timetable;
+    const pre = hubPreGridLines(state, now, cols);
+    const shortcuts = tt ? hubShortcuts(tt) : [];
+    const rows = Math.max(0, Math.floor(bodyRows));
+    const build = (shortcutLines) => {
+        const tail = [];
+        if (pre && (state.statusMessage || shortcutLines.length > 0))
+            tail.push('');
+        if (state.statusMessage) {
+            tail.push(...hintLines(state.statusMessage, cols));
+            if (shortcutLines.length > 0)
+                tail.push('');
+        }
+        tail.push(...shortcutLines);
+        const content = pre
+            ? renderAdaptiveWeekGrid(pre.inlineLines, pre.fallbackLines, pre.tt, pre.week, campusWeekday(now), now, rows, cols, state.gridCursor, tail.length)
+            : [];
+        return { content, tail };
+    };
+    const full = build(renderShortcutLines(shortcuts, cols));
+    if (full.content.length + full.tail.length <= rows)
+        return [...full.content, ...full.tail];
+    const compact = build(renderShortcutLines(shortcuts, cols, true));
+    if (compact.tail.length >= rows)
+        return rows > 0 ? compact.tail.slice(-rows) : [];
+    return [
+        ...compact.content.slice(0, rows - compact.tail.length),
+        ...compact.tail,
+    ];
+}
+const TERM_PROGRESS_WIDTH = 20;
+function renderTermProgressBar(w, now, cols) {
+    if (!w.nextBreakStart)
+        return null;
+    const weekOneMs = new Date(`${w.weekOneMonday}T00:00:00`).getTime();
+    const nextBreakMs = new Date(`${w.nextBreakStart}T00:00:00`).getTime();
+    const totalWeeks = Math.max(1, Math.round((nextBreakMs - weekOneMs) / (7 * 86400000)));
+    const currentWeek = currentWeekNumber(w.weekOneMonday, now);
+    const labelText = fmt(t().timetable.weekLabel2, { week: `${currentWeek}/${totalWeeks}` });
+    const label = type.hint(labelText);
+    const width = Number.isFinite(cols) ? Math.max(1, Math.floor(cols)) : Number.POSITIVE_INFINITY;
+    const indent = visualWidth(space.indent) < width ? space.indent : '';
+    const contentWidth = Math.max(1, width - visualWidth(indent));
+    const inlineBarWidth = Math.min(TERM_PROGRESS_WIDTH, contentWidth - visualWidth(label) - 2);
+    const barWidth = inlineBarWidth >= 1 ? inlineBarWidth : Math.min(TERM_PROGRESS_WIDTH, contentWidth);
+    const filledCols = Math.max(0, Math.min(barWidth, Math.round((currentWeek / totalWeeks) * barWidth)));
+    const filledChar = glyph.barFilled();
+    const emptyChar = glyph.barEmpty();
+    const bar = type.body(filledChar.repeat(filledCols) + emptyChar.repeat(barWidth - filledCols));
+    return inlineBarWidth >= 1
+        ? [`${indent}${bar}  ${label}`]
+        : [`${indent}${bar}`, ...hintLines(labelText, cols)];
+}
+function daysBetween(a, b) {
+    return Math.max(0, Math.ceil((b.getTime() - a.getTime()) / 86400000));
+}
+function renderPublicBody(state, now, bodyRows, cols) {
+    const trans = t();
+    const lines = [];
+    const w = state.publicWindow;
+    if (w === undefined) {
+        lines.push(...hintLines(trans.common.loading, cols));
+    }
+    else if (w === null) {
+        lines.push(...hintLines(trans.timetable.publicUnavailable, cols));
+    }
+    else if (w.status === 'onBreak') {
+        lines.push(...headingLines(fmt(trans.timetable.onBreak, { title: w.breakTitle }), cols));
+    }
+    else {
+        const semesterLabel = w.semester === '1' ? trans.timetable.semester1 : trans.timetable.semester2;
+        lines.push(...headingLines(`${fmt(trans.timetable.academicYearSuffix, { year: w.academicYear })} · ${semesterLabel} · ${fmt(trans.timetable.weekLabel2, { week: String(w.currentWeek) })}`, cols));
+        const bar = renderTermProgressBar(w, now, cols);
+        if (bar)
+            lines.push(...bar);
+        if (w.nextBreakStart && w.nextBreakTitle) {
+            lines.push(...hintLines(fmt(trans.timetable.daysUntilBreak, {
+                title: w.nextBreakTitle,
+                days: String(daysBetween(now, new Date(`${w.nextBreakStart}T00:00:00`))),
+            }), cols));
+        }
+    }
+    lines.push('');
+    const loginLines = [...hintLines(trans.timetable.publicLoginHint, cols), ''];
+    const rows = Number.isFinite(bodyRows)
+        ? Math.max(0, Math.floor(bodyRows))
+        : Number.POSITIVE_INFINITY;
+    const fieldRows = state.publicField
+        ? Math.min(3, rows, state.publicField.render(Number.POSITIVE_INFINITY, cols).length)
+        : 0;
+    if (state.publicUpcoming && state.publicUpcoming.length > 0) {
+        const activityHeading = headingLines(trans.calendar.recentActivity, cols);
+        const eventBudget = Math.max(0, rows - lines.length - activityHeading.length - 1 - loginLines.length - fieldRows);
+        const eventLines = [];
+        for (const event of state.publicUpcoming) {
+            const wrapped = wrappedRenderedLine(renderEventBrief(event, now), cols);
+            if (eventLines.length + wrapped.length > eventBudget)
+                break;
+            eventLines.push(...wrapped);
+        }
+        if (eventLines.length > 0)
+            lines.push(...activityHeading, ...eventLines, '');
+    }
+    lines.push(...loginLines);
+    return state.publicField
+        ? renderListFieldWithContext(lines, state.publicField, bodyRows, cols)
+        : lines;
+}
+export function renderSchedule(state, now, bodyRows = 100, cols = 80) {
+    const trans = t();
+    switch (state.mode) {
+        case 'loading':
+            return hintLines(trans.common.loading, cols);
+        case 'public':
+            return renderPublicBody(state, now, bodyRows, cols);
+        case 'needsLoginId':
+            return [
+                ...(state.errorMessage ? [...hintLines(state.errorMessage, cols), ''] : []),
+                ...(state.idField?.render(cols) ?? []),
+            ];
+        case 'needsLoginPassword':
+            return state.passwordField?.render(cols) ?? [];
+        case 'authenticating':
+            return hintLines(state.statusMessage ?? trans.common.loading, cols);
+        case 'needsWeekOne':
+            return [
+                ...(state.errorMessage ? [...hintLines(state.errorMessage, cols), ''] : []),
+                ...(state.weekOneField?.render(cols) ?? []),
+            ];
+        case 'hub':
+            return renderHubBody(state, now, bodyRows, cols);
+        case 'week': {
+            if (!state.timetable || !state.weekOne)
+                return [hint(trans.timetable.genericError)];
+            const week = currentWeekNumber(state.weekOne, now);
+            const weekLines = [heading(trans.timetable.hubWeek), ''];
+            // Standalone week mode gets the *whole* bodyRows to itself (no
+            // banner/today-section eating into it first, unlike the hub's own
+            // inline area) -- reached via the `w` shortcut specifically so a
+            // marginal terminal that couldn't fit the grid inline the hub still
+            // gets a real shot at it here, falling back to the single-day view
+            // only if even the full screen isn't enough.
+            return renderAdaptiveWeekGrid(weekLines, weekLines, state.timetable, week, campusWeekday(now), now, bodyRows, cols, state.gridCursor, 2);
+        }
+        case 'termDensity':
+            return state.timetable && state.weekOne
+                ? renderTermDensity(state.timetable.meetings, state.weekOne, currentWeekNumber(state.weekOne, now), cols).split('\n')
+                : [hint(trans.timetable.genericError)];
+        case 'termPicker':
+            return state.termField?.render(bodyRows, cols) ?? [];
+        case 'unresolved':
+            return [
+                heading(trans.timetable.unresolvedTitle),
+                '',
+                ...renderUnresolvedItems(state.timetable?.unresolvedItems ?? [], cols).split('\n'),
+            ];
+        case 'meetingDetail':
+            return state.detailMeeting && state.timetable
+                ? renderMeetingDetail(state.detailMeeting, state.timetable.periods, cols).split('\n')
+                : [hint(trans.timetable.genericError)];
+        case 'error':
+            return hintLines(state.errorMessage ?? trans.timetable.genericError, cols);
+        default:
+            return [];
+    }
+}