st3v3nmw
diff --git a/‎.prettierignore‎
Lines changed: 1 addition & 0 deletions b/‎.prettierignore‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎esbuild.config.mjs‎
Lines changed: 15 additions & 3 deletions b/‎esbuild.config.mjs‎
Lines changed: 15 additions & 3 deletions
diff --git a/‎pnpm-workspace.yaml‎
Lines changed: 5 additions & 0 deletions b/‎pnpm-workspace.yaml‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎src/data/settings.ts‎
Lines changed: 68 additions & 0 deletions b/‎src/data/settings.ts‎
Lines changed: 68 additions & 0 deletions
diff --git a/‎src/lang/base-locale.ts‎
Lines changed: 18 additions & 0 deletions b/‎src/lang/base-locale.ts‎
Lines changed: 18 additions & 0 deletions
diff --git a/‎src/lang/locale/en.ts‎
Lines changed: 25 additions & 0 deletions b/‎src/lang/locale/en.ts‎
Lines changed: 25 additions & 0 deletions
diff --git a/‎src/lang/locale/zh-cn.ts‎
Lines changed: 19 additions & 0 deletions b/‎src/lang/locale/zh-cn.ts‎
Lines changed: 19 additions & 0 deletions
@@ -1,6 +1,7 @@
 build
 coverage
 node_modules
+styles.css
 pnpm-lock.yaml
 docs/vaults/
 tests/vaults/
@@ -3,21 +3,26 @@ import esbuild from "esbuild";
 import fs from "fs";
 import { builtinModules } from "node:module";
 import path from "path";
+import prettier from "prettier";
 import process from "process";
 
 const prod = process.argv[2] === "production";
 
+// The published plugin expects CSS at the repository root, not under build/.
+// We also normalize the generated stylesheet through Prettier so CI does not
+// fail on formatting differences introduced by the bundler output.
 const moveToRootPlugin = {
     name: "move-to-root",
     setup(build) {
-        build.onEnd((_) => {
+        build.onEnd(async (_) => {
             const cssFile = path.join("build", "main.css");
             const targetFile = "styles.css";
 
             if (fs.existsSync(cssFile)) {
                 let contents = fs.readFileSync(cssFile, "utf8");
                 // Remove source map comment
                 contents = contents.replace(/\/\*#\s*sourceMappingURL=.*?\*\/\s*$/s, "");
+                contents = await prettier.format(contents, { filepath: targetFile });
                 fs.writeFileSync(targetFile, contents);
                 fs.rmSync(cssFile);
 
@@ -45,8 +50,15 @@ const context = await esbuild.context({
 });
 
 if (prod) {
-    context.rebuild().catch(() => process.exit(1));
-    context.dispose();
+    try {
+        // Production mode must await rebuild/dispose so async post-processing of
+        // styles.css has finished before the process exits.
+        await context.rebuild();
+    } catch {
+        process.exit(1);
+    } finally {
+        await context.dispose();
+    }
 } else {
     context.watch().catch(() => process.exit(1));
 }
@@ -0,0 +1,5 @@
+packages:
+    - "."
+
+onlyBuiltDependencies:
+    - "."
@@ -23,6 +23,16 @@ export interface SRSettings {
     multilineReversedCardSeparator: string;
     multilineCardEndMarker: string;
     editLaterTag: string | undefined;
+    // Reminder settings are intentionally limited to "when and how to nudge the user back
+    // into review". They do not model richer calendar-style scheduling for reminder delivery.
+    enableReviewReminders: boolean;
+    reviewReminderIntervalMinutes: number;
+    reviewReminderCheckOnStartup: boolean;
+    reviewReminderMessage: string;
+    reviewReminderAutoOpen: boolean;
+    reviewReminderShowNotice: boolean;
+    reviewReminderPlaySound: boolean;
+    reviewReminderBounceDock: boolean;
 
     // notes
     enableNoteReviewPaneOnStartup: boolean;
@@ -104,6 +114,14 @@ export const DEFAULT_SETTINGS: SRSettings = {
     multilineReversedCardSeparator: "??",
     multilineCardEndMarker: "",
     editLaterTag: undefined,
+    enableReviewReminders: false,
+    reviewReminderIntervalMinutes: 5,
+    reviewReminderCheckOnStartup: false,
+    reviewReminderMessage: "",
+    reviewReminderAutoOpen: true,
+    reviewReminderShowNotice: true,
+    reviewReminderPlaySound: true,
+    reviewReminderBounceDock: true,
     randomizeCardOrder: undefined,
 
     // notes
@@ -214,6 +232,56 @@ export function upgradeSettings(settings: SRSettings) {
     if (settings.fsrsDesiredRetention === null || settings.fsrsDesiredRetention === undefined) {
         settings.fsrsDesiredRetention = DEFAULT_SETTINGS.fsrsDesiredRetention;
     }
+
+    // Only published reminder settings are upgraded here. We deliberately do not preserve
+    // unpublished draft field names from this feature branch, so the shipped schema stays clean.
+    if (settings.enableReviewReminders === null || settings.enableReviewReminders === undefined) {
+        settings.enableReviewReminders = DEFAULT_SETTINGS.enableReviewReminders;
+    }
+
+    if (
+        settings.reviewReminderIntervalMinutes === null ||
+        settings.reviewReminderIntervalMinutes === undefined ||
+        settings.reviewReminderIntervalMinutes < 1
+    ) {
+        settings.reviewReminderIntervalMinutes = DEFAULT_SETTINGS.reviewReminderIntervalMinutes;
+    }
+
+    if (
+        settings.reviewReminderCheckOnStartup === null ||
+        settings.reviewReminderCheckOnStartup === undefined
+    ) {
+        settings.reviewReminderCheckOnStartup = DEFAULT_SETTINGS.reviewReminderCheckOnStartup;
+    }
+
+    if (settings.reviewReminderMessage === null || settings.reviewReminderMessage === undefined) {
+        settings.reviewReminderMessage = DEFAULT_SETTINGS.reviewReminderMessage;
+    }
+
+    if (settings.reviewReminderAutoOpen === null || settings.reviewReminderAutoOpen === undefined) {
+        settings.reviewReminderAutoOpen = DEFAULT_SETTINGS.reviewReminderAutoOpen;
+    }
+
+    if (
+        settings.reviewReminderShowNotice === null ||
+        settings.reviewReminderShowNotice === undefined
+    ) {
+        settings.reviewReminderShowNotice = DEFAULT_SETTINGS.reviewReminderShowNotice;
+    }
+
+    if (
+        settings.reviewReminderPlaySound === null ||
+        settings.reviewReminderPlaySound === undefined
+    ) {
+        settings.reviewReminderPlaySound = DEFAULT_SETTINGS.reviewReminderPlaySound;
+    }
+
+    if (
+        settings.reviewReminderBounceDock === null ||
+        settings.reviewReminderBounceDock === undefined
+    ) {
+        settings.reviewReminderBounceDock = DEFAULT_SETTINGS.reviewReminderBounceDock;
+    }
 }
 
 export class SettingsUtil {
 
@@ -125,6 +125,24 @@ export interface IBaseLocale {
     REVIEW_DECK_ORDER_PREV_DECK_COMPLETE_SEQUENTIAL: string;
     REVIEW_DECK_ORDER_PREV_DECK_COMPLETE_RANDOM: string;
     REVIEW_DECK_ORDER_RANDOM_DECK_AND_CARD: string;
+    REVIEW_REMINDER_NOTICE: string;
+    REVIEW_REMINDERS: string;
+    REVIEW_REMINDERS_DESC: string;
+    REVIEW_REMINDER_CHECK_ON_STARTUP: string;
+    REVIEW_REMINDER_CHECK_ON_STARTUP_DESC: string;
+    REVIEW_REMINDER_INTERVAL: string;
+    REVIEW_REMINDER_INTERVAL_DESC: string;
+    REVIEW_REMINDER_INTERVAL_MIN_WARNING: string;
+    REVIEW_REMINDER_MESSAGE: string;
+    REVIEW_REMINDER_MESSAGE_DESC: string;
+    REVIEW_REMINDER_AUTO_OPEN: string;
+    REVIEW_REMINDER_AUTO_OPEN_DESC: string;
+    REVIEW_REMINDER_SHOW_NOTICE: string;
+    REVIEW_REMINDER_SHOW_NOTICE_DESC: string;
+    REVIEW_REMINDER_PLAY_SOUND: string;
+    REVIEW_REMINDER_PLAY_SOUND_DESC: string;
+    REVIEW_REMINDER_BOUNCE_DOCK: string;
+    REVIEW_REMINDER_BOUNCE_DOCK_DESC: string;
     DISABLE_CLOZE_CARDS: string;
     CONVERT_CLOZE_PATTERNS_TO_INPUTS: string;
     CONVERT_CLOZE_PATTERNS_TO_INPUTS_DESC: string;
 
@@ -58,6 +58,8 @@ const en: IBaseLocale = {
     RESPONSE_RECEIVED: "Response received.",
     NO_DECK_EXISTS: "No deck exists for ${deckName}",
     ALL_CAUGHT_UP: "You're all caught up now :D.",
+    REVIEW_REMINDER_NOTICE:
+        "Flashcards are ready to review. Return to Obsidian to continue learning.",
 
     // scheduling.ts
     DAYS_STR_IVL: "${interval} day(s)",
@@ -152,6 +154,29 @@ const en: IBaseLocale = {
     REVIEW_DECK_ORDER_PREV_DECK_COMPLETE_RANDOM:
         "Randomly (once all cards in previous deck reviewed)",
     REVIEW_DECK_ORDER_RANDOM_DECK_AND_CARD: "Random card from random deck",
+    REVIEW_REMINDERS: "Review reminders",
+    REVIEW_REMINDERS_DESC:
+        "Periodically checks for new or due flashcards and reminds you when cards are ready to review.",
+    REVIEW_REMINDER_CHECK_ON_STARTUP: "Check immediately on startup",
+    REVIEW_REMINDER_CHECK_ON_STARTUP_DESC:
+        "Runs one check when Obsidian startup layout is ready, without waiting for the first interval.",
+    REVIEW_REMINDER_INTERVAL: "Reminder interval (minutes)",
+    REVIEW_REMINDER_INTERVAL_DESC:
+        "Checks every N minutes. Minimum 1 minute, maximum 1440 minutes.",
+    REVIEW_REMINDER_INTERVAL_MIN_WARNING: "Reminder interval must be a number between 1 and 1440.",
+    REVIEW_REMINDER_MESSAGE: "Reminder message",
+    REVIEW_REMINDER_MESSAGE_DESC:
+        "Optional custom message shown in the reminder notice. Leave empty to use the default message.",
+    REVIEW_REMINDER_AUTO_OPEN: "Automatically open review",
+    REVIEW_REMINDER_AUTO_OPEN_DESC:
+        "When enabled, reminders open the existing flashcard review session directly.",
+    REVIEW_REMINDER_SHOW_NOTICE: "Show notice when reminding",
+    REVIEW_REMINDER_SHOW_NOTICE_DESC: "Displays a temporary notice when a review reminder fires.",
+    REVIEW_REMINDER_PLAY_SOUND: "Play sound when reminding",
+    REVIEW_REMINDER_PLAY_SOUND_DESC: "Plays a short alert sound when a review reminder fires.",
+    REVIEW_REMINDER_BOUNCE_DOCK: "Bounce dock icon when reminding",
+    REVIEW_REMINDER_BOUNCE_DOCK_DESC:
+        "On desktop, bounces the dock icon when a review reminder fires.",
     DISABLE_CLOZE_CARDS: "Disable cloze cards?",
     CONVERT_CLOZE_PATTERNS_TO_INPUTS: "Convert cloze patterns to input fields",
     CONVERT_CLOZE_PATTERNS_TO_INPUTS_DESC:
 
@@ -46,6 +46,7 @@ const zhCN: IBaseLocale = {
     RESPONSE_RECEIVED: "反馈已收到",
     NO_DECK_EXISTS: "没有 ${deckName} 卡组",
     ALL_CAUGHT_UP: "都复习完啦，你真棒！",
+    REVIEW_REMINDER_NOTICE: "闪卡已经可以复习了。回到 Obsidian 继续学习。",
 
     // scheduling.ts
     DAYS_STR_IVL: "${interval}天",
@@ -115,6 +116,24 @@ const zhCN: IBaseLocale = {
     REVIEW_DECK_ORDER_PREV_DECK_COMPLETE_SEQUENTIAL: "顺序 (在前一卡片组内卡片都复习完后)",
     REVIEW_DECK_ORDER_PREV_DECK_COMPLETE_RANDOM: "乱序 (在前一卡片组内卡片都复习完后)",
     REVIEW_DECK_ORDER_RANDOM_DECK_AND_CARD: "卡片组及卡片都乱序",
+    REVIEW_REMINDERS: "复习提醒",
+    REVIEW_REMINDERS_DESC: "定期检查是否有新的或到期的闪卡，并在可以复习时提醒你。",
+    REVIEW_REMINDER_CHECK_ON_STARTUP: "启动后立即检查",
+    REVIEW_REMINDER_CHECK_ON_STARTUP_DESC:
+        "在 Obsidian 布局就绪后立即执行一次检查，不等待首次周期触发。",
+    REVIEW_REMINDER_INTERVAL: "提醒间隔（分钟）",
+    REVIEW_REMINDER_INTERVAL_DESC: "每 N 分钟检查一次。最小 1 分钟，最大 1440 分钟。",
+    REVIEW_REMINDER_INTERVAL_MIN_WARNING: "提醒间隔必须是 1 到 1440 之间的数字。",
+    REVIEW_REMINDER_MESSAGE: "提醒消息",
+    REVIEW_REMINDER_MESSAGE_DESC: "可选的自定义提醒文案。留空时使用默认消息。",
+    REVIEW_REMINDER_AUTO_OPEN: "自动打开复习",
+    REVIEW_REMINDER_AUTO_OPEN_DESC: "启用后，提醒触发时会直接打开现有的闪卡复习界面。",
+    REVIEW_REMINDER_SHOW_NOTICE: "提醒时显示通知",
+    REVIEW_REMINDER_SHOW_NOTICE_DESC: "提醒触发时显示一个临时通知。",
+    REVIEW_REMINDER_PLAY_SOUND: "提醒时播放声音",
+    REVIEW_REMINDER_PLAY_SOUND_DESC: "提醒触发时播放一段简短提示音。",
+    REVIEW_REMINDER_BOUNCE_DOCK: "提醒时弹跳 Dock 图标",
+    REVIEW_REMINDER_BOUNCE_DOCK_DESC: "在桌面端，提醒触发时弹跳 Dock 图标。",
     DISABLE_CLOZE_CARDS: "不进行完形填空",
     CONVERT_CLOZE_PATTERNS_TO_INPUTS: "Convert cloze patterns to input fields",
     CONVERT_CLOZE_PATTERNS_TO_INPUTS_DESC:
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +packages:
 +    - "."
++
 +onlyBuiltDependencies:
 +    - "."