How troazz/notecal works
notecal is a cross-platform calculator notepad: users edit plain-text notes, see line-by-line calculation results, and have notes saved automatically. The main path runs from the editor through the Tauri command bridge to the evaluation engine; separate branches manage note files, settings, rates, themes, onboarding, and updates. The CLI provides a second evaluation entry point. Some wiring is only documented or lies in unsampled excerpts, so those relationships are marked unverified rather than inferred as direct calls.
Main entry points: commands.rs Command bridge · lib.rs Expression engine · main.rs Tauri runtime · Editor.svelte Note editor
Components 29
Desktop interface
- Note editor
ui/src/Editor.svelte - Editor features
ui/src/editor - App shell
ui/src/App.svelte - Note switcher
ui/src/notes/Switcher.svelte - Note session
ui/src/notes/session.ts - First-run setup
ui/src/onboarding/Onboarding.svelte - Settings screen
ui/src/settings/Settings.svelte - Interface language
ui/src/i18n.svelte.ts
Application services
- Tauri runtime
src-tauri/src/main.rs - Command bridge
src-tauri/src/commands.rs - Evaluation service
src-tauri/src/evaluator.rs - Note storage
src-tauri/src/notes.rs - Disk change watcher
src-tauri/src/watch.rs - Theme service
src-tauri/src/theme.rs - Window pinning
src-tauri/src/pin.rs - Update checks
src-tauri/src/updates.rs
Calculation engine
- Expression engine
crates/notecal-core/src/lib.rs - Expression preprocessing
crates/notecal-core/src/preprocess.rs - Dates and zones
crates/notecal-core/src/datetime.rs - Zone aliases
crates/notecal-core/src/datetime/zones.rs - Result formatting
crates/notecal-core/src/format.rs - Calculation cheatsheet
crates/notecal-core/src/cheatsheet.rs - Command-line calculator
crates/notecal-cli/src/main.rs
User data and integrations
- Settings and definitions
crates/notecal-env/src/settings.rs - Atomic file access
crates/notecal-env/src/fs.rs - Cached exchange rates
crates/notecal-env/src/rates.rs - Exchange-rate service
- User and system themes
src-tauri/src/theme.rs
Other components
- Notecal user
Connections 36
- Notecal user → Note editor: edits notes
README.md - Note editor → Editor features: uses editor features
ui/src/Editor.svelte - App shell → Note editor: renders
ui/src/App.svelte - Note editor → Evaluation service: requests evaluation
- Evaluation service → Expression engine: evaluates expressions
- Expression engine → Expression preprocessing: preprocesses input
crates/notecal-core/src/lib.rs - Expression engine → Dates and zones: evaluates dates
crates/notecal-core/src/lib.rs - Dates and zones → Zone aliases: resolves zones
crates/notecal-core/src/datetime.rs - Expression engine → Result formatting: formats results
crates/notecal-core/src/lib.rs - Notecal user → Note switcher: chooses notes
README.md - Note switcher → Note session: opens and switches
ui/src/notes/Switcher.svelte - Note session → Command bridge: loads and saves
- Command bridge → Note storage: manages note files
src-tauri/src/commands.rs - Note storage → Atomic file access: writes atomically
src-tauri/src/notes.rs - Disk change watcher → Command bridge: reports disk changes
src-tauri/src/commands.rs - Tauri runtime → Command bridge: registers commands
src-tauri/src/main.rs - Tauri runtime → Evaluation service: initializes service
src-tauri/src/main.rs - Tauri runtime → Note storage: initializes storage
src-tauri/src/main.rs - Settings screen → Command bridge: updates settings
- First-run setup → Settings screen: uses settings API
ui/src/onboarding/Onboarding.svelte - Command bridge → Settings and definitions: loads and applies
src-tauri/src/commands.rs - Settings and definitions → Expression engine: derives engine settings
crates/notecal-env/src/settings.rs - Command bridge → Theme service: resolves themes
src-tauri/src/commands.rs - Notecal user → User and system themes: supplies palettes
README.md - Theme service → User and system themes: loads palettes
src-tauri/src/theme.rs - Tauri runtime → Window pinning: starts window controls
src-tauri/src/main.rs - Tauri runtime → Update checks: starts update checks
src-tauri/src/main.rs - Notecal user → Command-line calculator: enters calculation
README.md - Command-line calculator → Expression engine: evaluates input
- Expression engine → Calculation cheatsheet: provides examples
crates/notecal-core/src/lib.rs - Note switcher → Calculation cheatsheet: searches examples
- Tauri runtime → Cached exchange rates: loads cached rates
src-tauri/src/main.rs - Command bridge → Exchange-rate service: fetches rates
- Cached exchange rates → Atomic file access: persists cache
crates/notecal-env/src/rates.rs - App shell → Interface language: translates interface
ui/src/App.svelte - First-run setup → Interface language: translates setup
ui/src/onboarding/Onboarding.svelte