feat: add math notebook (#677)

* feat: add math notebook

* refactor: reorganize math-notebook composables

* refactor(i18n): update math-notebook namespace to mathNotebook and standardize keys

* feat(currency): remove fallback rates and handle unavailability

* feat(math-engine): add support for dotted date parsing and assignments

* feat(math-editor): add syntax highlighting & fix scroll

* feat: new style copy interactions with hover effects

* feat: improve UI interactions

* refactor(math-engine): rename constants to mc/math for rebranding

* refactor: update date formatting in SheetList to use date-fns

* feat: add help button to open documentation

Author: antonreshetov

package.json

@@ -33,6 +33,8 @@
     "copy:locales": "node scripts/copy-locales.js",
     "bench:load-test": "node scripts/bench-load-test.js",
     "bench:seed": "node scripts/bench-seed.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
     "release": "bumpp -c 'build: release v' -t",
@@ -76,6 +78,7 @@
     "marked": "^15.0.8",
     "markmap-lib": "^0.18.11",
     "markmap-view": "^0.18.10",
+    "mathjs": "^15.1.1",
     "mermaid": "^11.6.0",
     "nanoid": "^3.3.8",
     "nearest-color": "^0.4.4",
@@ -128,6 +131,7 @@
     "unplugin-auto-import": "^19.1.0",
     "unplugin-vue-components": "^28.4.0",
     "vite": "^6.1.1",
+    "vitest": "^4.0.18",
     "vue": "^3.5.13",
     "vue-router": "^4.5.0"
   },

pnpm-lock.yaml

@@ -0,0 +1,82 @@
+import { store } from './store'
+
+const CACHE_TTL = 1000 * 60 * 60
+
+interface CurrencyRatesApiResponse {
+  result?: string
+  rates?: Record<string, number>
+  time_last_update_unix?: number
+}
+
+export interface CurrencyRatesPayload {
+  rates: Record<string, number>
+  fetchedAt: number
+  source: 'live' | 'cache' | 'unavailable'
+}
+
+function normalizeRates(rates: Record<string, number>) {
+  const normalized: Record<string, number> = { USD: 1 }
+
+  Object.entries(rates).forEach(([code, value]) => {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+      normalized[code] = value
+    }
+  })
+
+  normalized.USD = 1
+
+  return normalized
+}
+
+export async function getCurrencyRates(): Promise<CurrencyRatesPayload> {
+  const cached = store.currencyRates.get('cache')
+
+  if (cached && Date.now() - cached.fetchedAt < CACHE_TTL) {
+    return {
+      ...cached,
+      source: 'cache',
+    }
+  }
+
+  try {
+    const response = await fetch('https://open.er-api.com/v6/latest/USD')
+    if (!response.ok) {
+      throw new Error(
+        `Currency rates request failed with status ${response.status}`,
+      )
+    }
+
+    const data = (await response.json()) as CurrencyRatesApiResponse
+    if (data.result !== 'success' || !data.rates) {
+      throw new Error('Currency rates response is invalid')
+    }
+
+    const payload = {
+      rates: normalizeRates(data.rates),
+      fetchedAt: data.time_last_update_unix
+        ? data.time_last_update_unix * 1000
+        : Date.now(),
+    }
+
+    store.currencyRates.set('cache', payload)
+
+    return {
+      ...payload,
+      source: 'live',
+    }
+  }
+  catch {
+    if (cached) {
+      return {
+        ...cached,
+        source: 'cache',
+      }
+    }
+
+    return {
+      rates: {},
+      fetchedAt: 0,
+      source: 'unavailable',
+    }
+  }
+}

src/main/currencyRates.ts

@@ -6,7 +6,8 @@
     "update": "Check for Updates...",
     "quit": "Quit massCode",
     "about": "About massCode",
-    "hide": "Hide massCode"
+    "hide": "Hide massCode",
+    "mathNotebook": "Math Notebook"
   },
   "help": {
     "label": "Help",

src/main/i18n/locales/en_US/menu.json

@@ -114,10 +114,19 @@
     "selectedMultiple": "{{count}} Snippets Selected",
     "noSelected": "No Snippet Selected"
   },
+  "mathNotebook": {
+    "label": "Math Notebook",
+    "sheetList": "Sheet List",
+    "newSheet": "New Sheet",
+    "untitled": "Untitled",
+    "copied": "Copied",
+    "currencyUnavailable": "Currency rates service unavailable"
+  },
   "placeholder": {
     "emptyTagList": "Add tags to snippets to see them here",
     "emptyFoldersList": "No Folders",
     "emptySnippetsList": "No Snippets",
+    "emptySheetList": "No Sheets",
     "search": "Search",
     "addTag": "Add Tag"
   }

src/main/i18n/locales/en_US/ui.json

@@ -1,6 +1,11 @@
 import { app, ipcMain, shell } from 'electron'
+import { getCurrencyRates } from '../../currencyRates'
 
 export function registerSystemHandlers() {
+  ipcMain.handle('system:currency-rates', () => {
+    return getCurrencyRates()
+  })
+
   ipcMain.handle('system:reload', () => {
     app.relaunch()
     app.quit()

src/main/ipc/handlers/system.ts

@@ -93,6 +93,12 @@ const appMenuItems: MenuConfig[] = [
     accelerator: 'CommandOrControl+.',
     click: () => send('main-menu:goto-devtools'),
   },
+  {
+    id: 'math-notebook',
+    label: i18n.t('menu:app.mathNotebook'),
+    accelerator: 'CommandOrControl+Shift+.',
+    click: () => send('main-menu:goto-math-notebook'),
+  },
   {
     type: 'separator' as any,
   },

src/main/menu/main.ts

@@ -1,4 +1,8 @@
-import type { AppStore, PreferencesStore } from './store/types'
+import type {
+  AppStore,
+  MathNotebookStore,
+  PreferencesStore,
+} from './store/types'
 import type { EventCallback } from './types'
 import type { Channel } from './types/ipc'
 import { contextBridge, ipcRenderer } from 'electron'
@@ -39,6 +43,15 @@ contextBridge.exposeInMainWorld('electron', {
       ) => store.preferences.set(name, value),
       delete: (name: keyof PreferencesStore) => store.preferences.delete(name),
     },
+    mathNotebook: {
+      get: (name: keyof MathNotebookStore) => store.mathNotebook.get(name),
+      set: <T extends keyof MathNotebookStore>(
+        name: T,
+        value: MathNotebookStore[T],
+      ) => store.mathNotebook.set(name, value),
+      delete: (name: keyof MathNotebookStore) =>
+        store.mathNotebook.delete(name),
+    },
   },
   i18n: {
     t: (key: string, options?: any) => i18n.t(key, options),

src/main/preload.ts

@@ -1,7 +1,11 @@
 import app from './module/app'
+import currencyRates from './module/currency-rates'
+import mathNotebook from './module/math-notebook'
 import preferences from './module/preferences'
 
 export const store = {
   app,
+  currencyRates,
   preferences,
+  mathNotebook,
 }

src/main/store/index.ts

@@ -0,0 +1,11 @@
+import type { CurrencyRatesStore } from '../types'
+import Store from 'electron-store'
+
+export default new Store<CurrencyRatesStore>({
+  name: 'currency-rates',
+  cwd: 'v2',
+
+  defaults: {
+    cache: null,
+  },
+})