@nbtca/prompt 1.3.2 → 1.4.2

package/dist/i18n/locales/en.json

@@ -8,7 +8,9 @@
     "error": "Error",
     "success": "Success",
     "goodbye": "Goodbye!",
-    "current": "current"
+    "current": "current",
+    "moreAbove": "{count} more above",
+    "moreBelow": "{count} more below"
   },
   "menu": {
     "events": "Events",
@@ -17,11 +19,16 @@
     "docsDesc": "Knowledge base",
     "status": "Status",
     "statusDesc": "Online status",
+    "timetable": "My Timetable",
+    "timetableDesc": "Sign in to JWXT, choose a term and export ICS",
     "links": "Links",
     "linksDesc": "website · GitHub · roadmap",
     "settings": "Settings",
     "settingsDesc": "language · theme · about",
-    "chooseAction": "nbtca"
+    "chooseAction": "nbtca",
+    "hintMove": "move",
+    "hintOpen": "open",
+    "hintQuit": "quit"
   },
   "about": {
     "title": "About",
@@ -58,18 +65,34 @@
     "pastEvents": "Past Events",
     "pastEventsDesc": "Recent activity history",
     "noPastEvents": "No past events in the last 30 days",
-    "viewPastDetail": "Select an event for details:"
+    "viewPastDetail": "Select an event for details:",
+    "next": "Next",
+    "recentActivity": "Recent",
+    "inPrefix": "in",
+    "startingNow": "starting now",
+    "thisWeek": "This Week",
+    "thisMonth": "This Month",
+    "search": "Search",
+    "searchPrompt": "Search events",
+    "searchPlaceholder": "keyword…",
+    "searchNoResults": "No matching events",
+    "exportIcs": "Export .ics",
+    "exportSuccess": "Saved",
+    "exportError": "Could not write the .ics file",
+    "recurringLabel": "recurring"
   },
   "docs": {
     "loading": "Loading documentation list...",
     "loadingDir": "Loading directory",
-    "categoryTutorial": "Tutorials",
+    "categoryAbout": "About NBTCA",
+    "categoryGuide": "Guide",
     "categoryRepairLogs": "Repair Logs",
     "categoryEvents": "Event Docs",
-    "categoryProcess": "Process",
+    "categoryConcepts": "Reference",
     "categoryRepair": "Repair",
     "categoryArchived": "Archived",
     "categoryReadme": "Project README",
+    "overviewLabel": "Overview",
     "chooseCategory": "Docs",
     "refreshCache": "Refresh cache",
     "cacheCleared": "Documentation cache cleared",
@@ -106,7 +129,10 @@
     "searching": "Searching documents...",
     "searchResults": "results found",
     "searchNoResults": "No documents match your search",
-    "loadingFile": "Loading"
+    "loadingFile": "Loading",
+    "readerLinksTitle": "Jump to",
+    "readerLinksHint": "links",
+    "readerNoLinks": "This page has no links to other docs"
   },
   "links": {
     "choose": "Links",
@@ -150,6 +176,114 @@
     "watchJsonConflict": "--watch cannot be used with --json.",
     "intervalNeedsWatch": "--interval requires --watch."
   },
+  "timetable": {
+    "menuTitle": "My Timetable",
+    "actionExport": "Export ICS",
+    "actionTerms": "List terms",
+    "actionLogin": "Sign in or refresh session",
+    "actionLogout": "Sign out",
+    "actionStatus": "Login status",
+    "termPrompt": "Term code",
+    "termPromptHint": "Leave empty for current, for example 2026:3",
+    "unknownCommand": "Unknown timetable command. Use login, logout, status, terms, or export.",
+    "loggedOut": "Local login session cleared.",
+    "savedStatus": "A login session is saved{account}.",
+    "noSavedStatus": "No login session is saved.",
+    "loginSaved": "Login verified and session saved.",
+    "loginOneShot": "Login verified; no session was saved.",
+    "loginWillSave": "A local bearer session will be saved after success; use --one-shot to avoid this.",
+    "sessionRefreshFailed": "The operation completed, but the saved session expiry could not be refreshed.",
+    "candidateTerms": "Candidate JWXT terms (not every term necessarily has a personal timetable):",
+    "semesterNumber": "Semester {number}",
+    "expiredRelogin": "The saved login session expired. Please sign in again.",
+    "studentId": "Student id",
+    "studentIdHint": "Sent only to the school authentication service",
+    "password": "Password",
+    "passwordHint": "Input is masked and never saved",
+    "weekOne": "First teaching Monday (YYYY-MM-DD)",
+    "weekOneHint": "JWXT returned no start date; confirm it against the official calendar",
+    "exported": "Exported {count} timetable meetings to {file}",
+    "warnings": "{count} record(s) could not be fully resolved; verify the imported calendar.",
+    "unresolvedPractice": "{count} practice record(s) lacked a confirmed weekday/period and were not added to the ICS.",
+    "calendarName": "{year} {semester} Timetable",
+    "invalidOption": "Option {flag} is not valid for this timetable command.",
+    "invalidArguments": "Too many timetable arguments. Use login, logout, status, terms, or export.",
+    "noSession": "No usable login session. Run `nbtca schedule login` in an interactive terminal.",
+    "invalidCredentials": "The student id or password was rejected.",
+    "accountLocked": "The account is temporarily locked. Try later or use the official school page.",
+    "accountInactive": "The account is inactive. Activate it on the official school page first.",
+    "challenge": "The school requires a slider or browser challenge; CLI login stopped safely.",
+    "sessionExpired": "The login session expired. Please sign in again.",
+    "timeout": "The school service timed out.",
+    "network": "Could not connect to the school service.",
+    "untrustedUrl": "The school returned an unapproved redirect; the request stopped safely.",
+    "httpError": "The school login service returned an error status.",
+    "loginChanged": "The school login page changed; credentials were not submitted.",
+    "unexpectedResponse": "A valid JWXT session could not be confirmed after login.",
+    "missingDates": "JWXT returned no calendar dates. Provide --week-one=YYYY-MM-DD.",
+    "missingPeriod": "JWXT returned no usable period times, so export cannot continue safely.",
+    "termMismatch": "JWXT returned a different academic term. Try again.",
+    "invalidData": "The timetable response format is not currently recognized.",
+    "unknownTerm": "Unknown term. Run `nbtca schedule terms` first.",
+    "noTerms": "JWXT returned no available terms.",
+    "currentTermUnknown": "JWXT did not identify one current term. Choose one with --term=year:code.",
+    "genericError": "The timetable operation failed.",
+    "hubToday": "Today",
+    "hubWeek": "This week",
+    "hubSwitchTerm": "Switch term",
+    "hubExport": "Export .ics",
+    "hubLogout": "Log out",
+    "hubUnresolved": "Needs attention",
+    "unresolvedTitle": "Needs attention",
+    "unresolvedEmpty": "Nothing needs attention",
+    "unresolvedUnknownItem": "Unnamed item",
+    "nextClass": "Next",
+    "noClassToday": "No classes today",
+    "noNextClass": "No upcoming classes",
+    "nowLabel": "now",
+    "weekLabel": "Week",
+    "promptWeekOne": "First-week Monday (YYYY-MM-DD)",
+    "menuEntry": "Schedule",
+    "semester1": "Term 1",
+    "semester2": "Term 2",
+    "weekLabel2": "Week {week}",
+    "academicYearSuffix": "{year}",
+    "onBreak": "On break · {title}",
+    "publicUnavailable": "Academic calendar not available yet",
+    "daysUntilBreak": "{days} days until {title}",
+    "publicLoginAction": "Log in to see my timetable",
+    "publicLoginHint": "Log in to export your timetable (.ics)",
+    "weekOneAutoFailed": "Couldn't infer the term's first week automatically — please confirm it once",
+    "weekdayMon": "Mon",
+    "weekdayTue": "Tue",
+    "weekdayWed": "Wed",
+    "weekdayThu": "Thu",
+    "weekdayFri": "Fri",
+    "weekdaySat": "Sat",
+    "weekdaySun": "Sun",
+    "todayHeading": "Today · {weekday} · Week {week}",
+    "classDone": "Done",
+    "classLive": "In progress",
+    "minutesRemaining": "{minutes}m left",
+    "timelineEnd": "—",
+    "termNotStarted": "Term hasn't started yet",
+    "termStartsIn": "Classes begin {date} · {days} days to go",
+    "hubTermDensity": "Term density",
+    "termDensityTitle": "Term density",
+    "termDensityThisWeek": "This week",
+    "weekOverviewTitle": "Week overview",
+    "weekAheadClasses": "Classes",
+    "weekAheadBusy": "Busy",
+    "weekAheadFree": "Free",
+    "weekAheadNone": "N/A",
+    "termPreviewWeek": "Week 1 preview",
+    "hubFullGrid": "Full grid",
+    "detailTime": "Time",
+    "detailLocation": "Location",
+    "detailTeacher": "Teacher",
+    "detailWeeks": "Weeks",
+    "teacherSeparator": ", "
+  },
   "theme": {
     "current": "Current theme settings",
     "chooseAction": "Settings",
@@ -197,11 +331,15 @@
     "cmdTheme": "View or set theme",
     "cmdLang": "Set language",
     "cmdUpdate": "Check for updates",
+    "cmdSchedule": "Personal timetable login, term lookup and ICS export",
     "flagVersion": "Show version",
     "flagHelp": "Show help",
     "flagOpen": "Open in browser (URL commands)",
     "flagJson": "JSON output (events, status)",
     "flagToday": "Today only (events)",
+    "flagWeek": "Events this week",
+    "flagMonth": "Events this month",
+    "flagSearch": "Filter events by keyword",
     "flagNext": "Limit to next N (events)",
     "flagWatch": "Live refresh (status)",
     "flagInterval": "Refresh interval (status --watch)",
@@ -210,6 +348,11 @@
     "flagHeatmap": "Activity heatmap (events)",
     "flagPlain": "Disable colors",
     "flagNoLogo": "Skip logo",
+    "flagOneShot": "Do not read or save a login session",
+    "flagNoSave": "Alias for --one-shot",
+    "flagTerm": "Select a term (for example 2026:3)",
+    "flagOutput": "ICS output path",
+    "flagWeekOne": "First teaching Monday when JWXT has no dates",
     "unknownCommand": "Unknown command: {command}",
     "unknownCommandHint": "Run `nbtca --help` to see available commands.",
     "unknownFlag": "Unknown flag: {flag}",

package/dist/i18n/locales/zh.json

@@ -8,7 +8,9 @@
     "error": "错误",
     "success": "成功",
     "goodbye": "再见！",
-    "current": "当前"
+    "current": "当前",
+    "moreAbove": "上方还有 {count} 项",
+    "moreBelow": "下方还有 {count} 项"
   },
   "menu": {
     "events": "活动",
@@ -17,11 +19,16 @@
     "docsDesc": "知识库",
     "status": "状态",
     "statusDesc": "在线状态",
+    "timetable": "我的课表",
+    "timetableDesc": "登录教务、查询学期并导出 ICS",
     "links": "链接",
     "linksDesc": "官网 · GitHub · 路线图",
     "settings": "设置",
     "settingsDesc": "语言 · 主题 · 关于",
-    "chooseAction": "nbtca"
+    "chooseAction": "nbtca",
+    "hintMove": "移动",
+    "hintOpen": "打开",
+    "hintQuit": "退出"
   },
   "about": {
     "title": "关于",
@@ -58,18 +65,34 @@
     "pastEvents": "历史活动",
     "pastEventsDesc": "近期活动记录",
     "noPastEvents": "最近 30 天内暂无历史活动",
-    "viewPastDetail": "选择活动查看详情:"
+    "viewPastDetail": "选择活动查看详情:",
+    "next": "下一场",
+    "recentActivity": "近期动态",
+    "inPrefix": "还有",
+    "startingNow": "即将开始",
+    "thisWeek": "本周",
+    "thisMonth": "本月",
+    "search": "搜索",
+    "searchPrompt": "搜索活动",
+    "searchPlaceholder": "关键词…",
+    "searchNoResults": "没有匹配的活动",
+    "exportIcs": "导出 .ics",
+    "exportSuccess": "已保存",
+    "exportError": "无法写入 .ics 文件",
+    "recurringLabel": "循环"
   },
   "docs": {
     "loading": "正在加载文档列表...",
     "loadingDir": "正在加载目录",
-    "categoryTutorial": "教程",
+    "categoryAbout": "认识 NBTCA",
+    "categoryGuide": "指南",
     "categoryRepairLogs": "维修日记",
     "categoryEvents": "活动文档",
-    "categoryProcess": "流程",
+    "categoryConcepts": "参考",
     "categoryRepair": "维修",
     "categoryArchived": "归档",
     "categoryReadme": "项目说明 (README)",
+    "overviewLabel": "总览",
     "chooseCategory": "文档",
     "refreshCache": "刷新缓存",
     "cacheCleared": "文档缓存已清除",
@@ -106,7 +129,10 @@
     "searching": "正在搜索文档...",
     "searchResults": "个结果",
     "searchNoResults": "未找到匹配的文档",
-    "loadingFile": "正在加载"
+    "loadingFile": "正在加载",
+    "readerLinksTitle": "跳转到",
+    "readerLinksHint": "链接",
+    "readerNoLinks": "本页没有指向其他文档的链接"
   },
   "links": {
     "choose": "链接",
@@ -150,6 +176,114 @@
     "watchJsonConflict": "--watch 不能和 --json 同时使用。",
     "intervalNeedsWatch": "--interval 需要配合 --watch 使用。"
   },
+  "timetable": {
+    "menuTitle": "我的课表",
+    "actionExport": "导出 ICS",
+    "actionTerms": "查看学期",
+    "actionLogin": "登录或刷新会话",
+    "actionLogout": "退出登录",
+    "actionStatus": "登录状态",
+    "termPrompt": "学期代码",
+    "termPromptHint": "留空使用当前学期，例如 2026:3",
+    "unknownCommand": "未知课表命令。可用：login、logout、status、terms、export。",
+    "loggedOut": "本地登录状态已清除。",
+    "savedStatus": "已保存登录状态{account}。",
+    "noSavedStatus": "没有保存的登录状态。",
+    "loginSaved": "登录验证成功，状态已保存。",
+    "loginOneShot": "登录验证成功；本次未保存登录状态。",
+    "loginWillSave": "成功后将保存本地登录状态（承载凭据）；如不希望保存，请使用 --one-shot。",
+    "sessionRefreshFailed": "操作已完成，但未能刷新本地登录状态的有效期。",
+    "candidateTerms": "教务候选学期（不代表每个学期都有个人课表）：",
+    "semesterNumber": "第{number}学期",
+    "expiredRelogin": "已保存的登录状态过期，请重新登录。",
+    "studentId": "学号",
+    "studentIdHint": "仅发送给学校统一认证",
+    "password": "密码",
+    "passwordHint": "输入内容不会显示或保存",
+    "weekOne": "第一教学周周一（YYYY-MM-DD）",
+    "weekOneHint": "教务响应不含开学日期，请按官方校历确认",
+    "exported": "已导出 {count} 条课程安排到 {file}",
+    "warnings": "有 {count} 条数据未能完整解析；请导入后核对。",
+    "unresolvedPractice": "有 {count} 条实践安排缺少已确认的星期/节次，未写入 ICS。",
+    "calendarName": "{year}{semester}课表",
+    "invalidOption": "选项 {flag} 不适用于当前课表命令。",
+    "invalidArguments": "课表命令参数过多；可用：login、logout、status、terms、export。",
+    "noSession": "当前没有可用登录状态；请在交互终端运行 `nbtca schedule login`。",
+    "invalidCredentials": "学号或密码不正确。",
+    "accountLocked": "账户暂时被锁定，请稍后再试或通过学校页面处理。",
+    "accountInactive": "账户尚未激活，请先通过学校官方页面激活。",
+    "challenge": "学校要求滑块或其他浏览器验证，本次 CLI 登录已安全中止。",
+    "sessionExpired": "登录状态已过期，请重新登录。",
+    "timeout": "学校服务响应超时。",
+    "network": "无法连接学校服务。",
+    "untrustedUrl": "学校返回了未授权的登录跳转，已安全中止。",
+    "httpError": "学校登录服务返回了错误状态。",
+    "loginChanged": "学校登录页结构已经变化，当前版本未提交凭据。",
+    "unexpectedResponse": "登录后未能确认有效的教务会话。",
+    "missingDates": "教务响应没有可用日期，请用 --week-one=YYYY-MM-DD 指定第一周周一。",
+    "missingPeriod": "教务响应缺少课程节次时间，无法安全导出。",
+    "termMismatch": "教务系统返回了不同学期，请重试。",
+    "invalidData": "课表数据格式暂时无法识别。",
+    "unknownTerm": "未知学期；请先运行 `nbtca schedule terms`。",
+    "noTerms": "教务系统没有返回可用学期。",
+    "currentTermUnknown": "教务没有标出唯一的当前学期；请用 --term=学年:代码 指定。",
+    "genericError": "课表操作失败。",
+    "hubToday": "今日",
+    "hubWeek": "本周",
+    "hubSwitchTerm": "切换学期",
+    "hubExport": "导出 .ics",
+    "hubLogout": "退出登录",
+    "hubUnresolved": "待处理事项",
+    "unresolvedTitle": "待处理事项",
+    "unresolvedEmpty": "没有待处理事项",
+    "unresolvedUnknownItem": "未命名安排",
+    "nextClass": "下一节",
+    "noClassToday": "今天没有课",
+    "noNextClass": "没有即将开始的课",
+    "nowLabel": "进行中",
+    "weekLabel": "第",
+    "promptWeekOne": "第一周周一 (YYYY-MM-DD)",
+    "menuEntry": "课表",
+    "semester1": "第一学期",
+    "semester2": "第二学期",
+    "weekLabel2": "第 {week} 周",
+    "academicYearSuffix": "{year}学年",
+    "onBreak": "假期中 · {title}",
+    "publicUnavailable": "校历数据暂不可用",
+    "daysUntilBreak": "距离{title}还有 {days} 天",
+    "publicLoginAction": "登录查看我的课表",
+    "publicLoginHint": "登录后可导出课表 (.ics)",
+    "weekOneAutoFailed": "未能从校历自动推算学期第一周，请手动确认一次",
+    "weekdayMon": "一",
+    "weekdayTue": "二",
+    "weekdayWed": "三",
+    "weekdayThu": "四",
+    "weekdayFri": "五",
+    "weekdaySat": "六",
+    "weekdaySun": "日",
+    "todayHeading": "今日 · 周{weekday} · 第{week}教学周",
+    "classDone": "已结束",
+    "classLive": "进行中",
+    "minutesRemaining": "还剩 {minutes} 分钟",
+    "timelineEnd": "无",
+    "termNotStarted": "本学期尚未开始",
+    "termStartsIn": "{date} 开学 · 还有 {days} 天",
+    "hubTermDensity": "学期活跃度",
+    "termDensityTitle": "学期活跃度",
+    "termDensityThisWeek": "本周",
+    "weekOverviewTitle": "本周概览",
+    "weekAheadClasses": "课程",
+    "weekAheadBusy": "较满",
+    "weekAheadFree": "较空",
+    "weekAheadNone": "无",
+    "termPreviewWeek": "第一周预览",
+    "hubFullGrid": "完整课表",
+    "detailTime": "时间",
+    "detailLocation": "地点",
+    "detailTeacher": "教师",
+    "detailWeeks": "周次",
+    "teacherSeparator": "、"
+  },
   "theme": {
     "current": "当前主题设置",
     "chooseAction": "设置",
@@ -197,11 +331,15 @@
     "cmdTheme": "查看或设置主题",
     "cmdLang": "设置语言",
     "cmdUpdate": "检查更新",
+    "cmdSchedule": "个人课表登录、学期查询与 ICS 导出",
     "flagVersion": "显示版本号",
     "flagHelp": "显示帮助",
     "flagOpen": "在浏览器中打开（URL 命令）",
     "flagJson": "JSON 输出（events, status）",
     "flagToday": "仅显示今日（events）",
+    "flagWeek": "本周活动",
+    "flagMonth": "本月活动",
+    "flagSearch": "按关键词过滤活动",
     "flagNext": "限制为前 N 个（events）",
     "flagWatch": "实时刷新（status）",
     "flagInterval": "刷新间隔（status --watch）",
@@ -210,6 +348,11 @@
     "flagHeatmap": "活动热力图 (events)",
     "flagPlain": "禁用颜色",
     "flagNoLogo": "跳过 Logo",
+    "flagOneShot": "不读取或保存登录状态",
+    "flagNoSave": "--one-shot 的别名",
+    "flagTerm": "选择学年学期（例如 2026:3）",
+    "flagOutput": "ICS 输出路径",
+    "flagWeekOne": "第一教学周周一（教务未返回日期时使用）",
     "unknownCommand": "未知命令: {command}",
     "unknownCommandHint": "运行 `nbtca --help` 查看可用命令。",
     "unknownFlag": "未知选项: {flag}",

package/dist/index.js

@@ -1,6 +1,3 @@
-/**
- * NBTCA Prompt entry point
- */
 import chalk from 'chalk';
 import open from 'open';
 import { main } from './main.js';
@@ -11,10 +8,11 @@ import { pickIcon } from './core/icons.js';
 import { applyColorModePreference } from './config/preferences.js';
 import { openDocsInBrowser } from './features/docs.js';
 import { runThemeCommand } from './features/theme.js';
-import { setLanguage, t, fmt } from './i18n/index.js';
+import { saveLanguagePreference, t, fmt } from './i18n/index.js';
 import { clearScreen, handleGracefulExit } from './core/ui.js';
 import { APP_INFO, URLS } from './config/data.js';
 import { runUpdateCheck } from './features/update.js';
+import { runStudentTimetableCommand } from './features/student-timetable.js';
 const ACTION_ALIASES = {
     events: 'events',
     event: 'events',
@@ -36,8 +34,11 @@ const URL_ACTIONS = {
     github: URLS.github,
     roadmap: URLS.roadmap
 };
-const KNOWN_FLAGS = new Set(['--help', '--version', '--open', '--json', '--plain', '--no-logo', '--watch', '--today', '--heatmap']);
-const KNOWN_FLAG_PREFIXES = ['--interval=', '--timeout=', '--retries=', '--next='];
+const KNOWN_FLAGS = new Set([
+    '--help', '--version', '--open', '--json', '--plain', '--no-logo', '--watch', '--today', '--heatmap',
+    '--week', '--month', '--one-shot', '--no-save',
+]);
+const KNOWN_FLAG_PREFIXES = ['--interval=', '--timeout=', '--retries=', '--next=', '--search=', '--term=', '--output=', '--week-one='];
 const STATUS_WATCH_INTERVAL_MIN = 3;
 const STATUS_WATCH_INTERVAL_MAX = 300;
 const STATUS_TIMEOUT_MIN = 1000;
@@ -75,6 +76,11 @@ function getAllowedFlagsFor(command) {
         return allowed;
     if (command === 'theme')
         return allowed;
+    if (command === 'schedule' || command === 'timetable') {
+        allowed.add('--one-shot');
+        allowed.add('--no-save');
+        return allowed;
+    }
     const action = ACTION_ALIASES[command];
     if (!action)
         return allowed;
@@ -83,6 +89,8 @@ function getAllowedFlagsFor(command) {
             allowed.add('--json');
             allowed.add('--today');
             allowed.add('--heatmap');
+            allowed.add('--week');
+            allowed.add('--month');
             return allowed;
         case 'status':
             allowed.add('--json');
@@ -103,9 +111,12 @@ function getAllowedFlagsFor(command) {
 function getAllowedFlagPrefixesFor(command) {
     if (!command)
         return [];
+    if (command === 'schedule' || command === 'timetable') {
+        return ['--term=', '--output=', '--week-one='];
+    }
     const action = ACTION_ALIASES[command];
     if (action === 'events')
-        return ['--next='];
+        return ['--next=', '--search='];
     if (action === 'status')
         return ['--interval=', '--timeout=', '--retries='];
     return [];
@@ -149,6 +160,8 @@ function printHelp() {
     console.log(`  events         ${trans.menu.eventsDesc}`);
     console.log(`  docs           ${trans.menu.docsDesc}`);
     console.log(`  status         ${trans.menu.statusDesc}`);
+    console.log('  schedule <login|logout|status|terms|export>');
+    console.log(`                 ${c.cmdSchedule}`);
     console.log(`  website        ${c.cmdWebsite}`);
     console.log(`  github         ${c.cmdGithub}`);
     console.log(`  roadmap        ${c.cmdRoadmap}`);
@@ -164,6 +177,9 @@ function printHelp() {
     console.log(`  --json             ${c.flagJson}`);
     console.log(`  --heatmap          ${c.flagHeatmap}`);
     console.log(`  --today            ${c.flagToday}`);
+    console.log(`  --week             ${c.flagWeek}`);
+    console.log(`  --month            ${c.flagMonth}`);
+    console.log(`  --search=<q>       ${c.flagSearch}`);
     console.log(`  --next=<n>         ${c.flagNext}`);
     console.log(`  --watch            ${c.flagWatch}`);
     console.log(`  --interval=<s>     ${c.flagInterval}`);
@@ -171,6 +187,11 @@ function printHelp() {
     console.log(`  --retries=<n>      ${c.flagRetries}`);
     console.log(`  --plain            ${c.flagPlain}`);
     console.log(`  --no-logo          ${c.flagNoLogo}`);
+    console.log(`  --one-shot         ${c.flagOneShot}`);
+    console.log(`  --no-save          ${c.flagNoSave}`);
+    console.log(`  --term=<year:code> ${c.flagTerm}`);
+    console.log(`  --output=<path>    ${c.flagOutput}`);
+    console.log(`  --week-one=<date>  ${c.flagWeekOne}`);
 }
 async function runEventsCommand(flags) {
     if (flags.has('--heatmap')) {
@@ -184,7 +205,26 @@ async function runEventsCommand(flags) {
         }
         return;
     }
-    let events = await fetchEvents();
+    const { weekRange, monthRange } = await import('./features/calendar-query.js');
+    const { fetchInRange } = await import('./features/calendar.js');
+    const now0 = new Date();
+    let events;
+    if (flags.has('--week')) {
+        const r = weekRange(now0);
+        events = await fetchInRange(r.start, r.end);
+    }
+    else if (flags.has('--month')) {
+        const r = monthRange(now0);
+        events = await fetchInRange(r.start, r.end);
+    }
+    else {
+        events = await fetchEvents();
+    }
+    const searchFlag = Array.from(flags).find(f => f.startsWith('--search='));
+    if (searchFlag) {
+        const q = searchFlag.slice('--search='.length).toLowerCase();
+        events = events.filter(e => `${e.title} ${e.location}`.toLowerCase().includes(q));
+    }
     if (flags.has('--today')) {
         const now = new Date();
         events = events.filter(e => {
@@ -333,7 +373,7 @@ async function runCommandMode(argv) {
             console.error(chalk.red(t().cli.invalidLang));
             process.exit(1);
         }
-        const persisted = setLanguage(language);
+        const persisted = saveLanguagePreference(language);
         if (persisted) {
             console.log(chalk.green(`${pickIcon('✓', 'OK')}: ${t().language.changed}`));
         }
@@ -357,6 +397,17 @@ async function runCommandMode(argv) {
         await runUpdateCheck();
         return;
     }
+    if (command === 'schedule' || command === 'timetable') {
+        if (args.length > 1) {
+            console.error(chalk.red(t().timetable.invalidArguments));
+            process.exitCode = 1;
+            return;
+        }
+        const exitCode = await runStudentTimetableCommand(args[0], { flags });
+        if (exitCode !== 0)
+            process.exitCode = exitCode;
+        return;
+    }
     const action = ACTION_ALIASES[command];
     if (!action) {
         const cliT = t().cli;
@@ -390,7 +441,7 @@ async function runCommandMode(argv) {
         return;
     }
     if (action === 'about') {
-        const { note } = await import('@clack/prompts');
+        const { note } = await import('./core/components/note.js');
         const { padEndV } = await import('./core/text.js');
         const pad = 12;
         const row = (label, value) => `${chalk.dim(padEndV(label, pad))}${value}`;
@@ -410,7 +461,6 @@ async function runCommandMode(argv) {
         note(content, trans.about.title);
         return;
     }
-    // URL actions: repair, website, github, roadmap
     const mappedUrl = URL_ACTIONS[action];
     if (mappedUrl) {
         if (flags.has('--open')) {

package/dist/logo/ca-dotmatrix-large.txt

@@ -0,0 +1,26 @@
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⣤⡶⠶⠾⠟⠛⠛⠛⠛⠻⠷⠶⢶⣤⣤⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣠⣴⠾⠛⢩⠥⠀⠤⡄⡔⡖⡆⡖⡆⡆⡄⡖⣠⣄⣀⠈⠉⠛⠷⣦⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣠⡶⠟⠉⠀⠀⠀⠘⠤⠂⢑⣁⣁⣥⣤⣧⣤⣤⣤⣁⣁⡀⠃⠀⠴⢿⢀⣀⠉⠛⢶⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⢀⣴⠟⠉⡰⣄⢛⠆⢂⣠⡴⠶⠛⠋⠉⠁⠀⠀⠀⠀⠀⠀⠈⠉⠙⠛⠶⢦⣌⡐⠃⣰⡂⣀⠉⠻⣦⡀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⢀⣴⠟⠁⠠⣮⡣⠈⣡⡶⠛⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⢶⣄⡘⠴⡡⢄⠈⠻⣦⡀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⢠⡾⠃⣐⢤⡀⢉⣴⠟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠻⣦⡁⠔⣣⡄⠘⢷⡄⠀⠀⠀⠀
+⠀⠀⠀⣰⡟⠀⡄⠨⠇⣠⠟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠻⣆⠙⡥⣂⠄⢻⣆⠀⠀⠀
+⠀⠀⣰⡟⠀⢖⣪⢁⣼⣯⠴⠖⠚⠛⠛⠛⠓⠒⠦⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣠⠴⠖⠒⠛⠛⠒⠲⠶⢤⣀⠀⠙⣧⡈⣕⣲⠀⢻⣆⠀⠀
+⠀⢰⡟⠠⢌⡱⣠⡞⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠢⡀⠀⠀⠀⠀⣠⠞⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠓⢦⡈⢷⡀⢒⡣⠀⢻⡆⠀
+⠀⣿⠁⠬⠕⣶⣿⣿⣿⣆⠀⢀⣠⡤⠤⠤⠤⢤⣀⡀⠀⠀⠙⣆⠀⠀⣼⣿⣿⣷⡄⠀⢀⣀⣤⠤⠤⢤⣄⣀⠀⠀⠀⠳⡜⣧⠀⡀⢀⠈⣿⠀
+⢸⡏⠠⠤⡄⢿⣿⣿⣿⣿⠞⠋⠁⠀⠀⠀⠀⠀⠀⠙⠦⣀⠀⣸⠀⠀⣿⣿⣿⣿⣷⠞⠋⠁⠀⠀⠀⠀⠀⠈⠓⢤⡀⠀⣷⢹⡆⢓⣪⣄⢹⡇
+⣾⠇⢠⠵⠁⣼⠛⠛⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠉⠀⠀⠉⠛⠛⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠁⠈⣧⠀⣀⣀⠸⣷
+⣿⠀⢨⡤⠀⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⠀⠴⠥⠀⣿
+⣿⠀⠈⠉⠀⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⠀⣉⣏⠀⣿
+⢿⡆⠈⠴⠒⢿⡀⠀⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⡄⠀⠀⢀⡟⠠⠤⢴⢰⡿
+⢸⣇⠀⠯⠍⠻⣇⠀⢹⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⠇⠀⠀⣸⠇⠀⠀⠈⣸⡇
+⠀⣿⡀⠸⠩⠂⢻⡄⠈⢧⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⡟⠀⠀⢠⡟⠀⠤⣠⢀⣿⠀
+⠀⠸⣧⠐⢨⠁⡄⢷⡀⠈⢧⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⡾⠁⠀⢀⡾⠁⢏⡱⠈⣼⠇⠀
+⠀⠀⠹⣧⠈⢩⢒⡈⢻⡄⠈⠳⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣠⠞⠀⠀⢠⡟⢡⠦⣄⠀⣼⠏⠀⠀
+⠀⠀⠀⠹⣧⡀⠡⣊⠄⠙⣦⡀⠈⠳⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣠⠞⠁⠀⢀⣴⠏⠰⣺⠉⢀⣼⠏⠀⠀⠀
+⠀⠀⠀⠀⠘⢷⡌⠁⠤⢇⢈⠻⣦⡀⠈⠓⢦⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣠⡴⠛⠁⠀⢀⣴⠟⢡⡢⡀⠀⢠⡾⠃⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠈⠻⣦⡀⠑⢋⠔⠀⠙⠶⣄⡀⠈⠙⠛⠶⠦⣤⣤⣤⣤⣤⣤⣤⠴⠶⠚⠉⠁⠀⢀⣠⠶⠋⣁⠈⠳⠍⢀⣴⠟⠁⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠈⠻⣦⣀⠀⠴⢱⢲⠈⠙⠓⠶⣤⣄⣀⡀⠀⠀⠀⠀⠀⠀⢀⣀⣠⣤⠶⠞⠋⠥⡰⣘⢌⠂⣀⣴⠟⠁⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠷⣦⣀⠁⠀⠎⡔⡔⢢⠈⢉⢉⡛⠛⠛⠛⠛⠛⢉⡉⡅⡄⢂⢂⠀⠓⠃⣀⣴⠾⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠻⢶⣤⣀⡈⠁⠃⠆⠠⠆⠶⠇⠕⠇⠼⠐⠙⠸⠈⢁⣀⣤⡶⠟⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠛⠛⠷⠶⢶⣦⣤⣤⣤⣤⣴⡶⠶⠾⠛⠛⠉⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

package/dist/logo/ca-dotmatrix-small.txt

@@ -0,0 +1,12 @@
+⠀⠀⠀⠀⠀⠀⣠⠤⠒⠊⠉⢉⢉⢉⡑⠒⠤⣄⠀⠀⠀⠀⠀⠀
+⠀⠀⠀⢀⠔⠉⠄⣀⠥⠒⠒⠊⠐⠒⠒⠤⣁⠢⡉⠢⡀⠀⠀⠀
+⠀⠀⡔⢁⢈⠔⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠢⡀⡈⢢⠀⠀
+⠀⡞⠠⢠⠇⠒⠒⠒⠂⢄⠀⠀⠀⡠⠄⠒⠒⠂⠤⡘⡄⢀⢳⠀
+⡸⠀⢺⣷⣆⠤⠐⠒⠠⠀⠱⠀⣾⣶⡠⠄⠐⠀⠄⠈⠺⡄⡀⢇
+⡇⠀⠸⠉⠁⠀⠀⠀⠀⠀⠉⠀⠉⠉⠀⠀⠀⠀⠀⠈⠁⠇⠀⢸
+⡇⠠⢰⢀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⡆⠙⢸
+⢱⠐⠉⡄⠆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⠇⢠⠃⠀⡎
+⠀⢧⠠⠘⡌⠢⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⠊⢠⢃⠄⡼⠀
+⠀⠀⠣⡀⢨⠢⣈⠢⢄⣀⠀⠀⠀⢀⣀⠤⠊⣀⠔⡡⢉⠜⠀⠀
+⠀⠀⠀⠈⠢⣐⠀⢉⡒⠤⠬⠍⠩⠤⠤⠒⠉⠀⣀⠔⠁⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠙⠒⠤⢅⣀⣀⣁⣈⡨⠤⠒⠋⠀⠀⠀⠀⠀⠀