Feature Map

Feature Map

Use this page when the task starts from a product feature instead of a file name.

Reader Shell And Chrome

• mac-app/ReaderWindowController.swift: central reader state and shared controls.
• mac-app/ReaderWindowController+UI.swift: top toolbar, bottom bar, layout constraints.
• mac-app/ReaderWindowController+Theme.swift: light/dark reader chrome styling.
• mac-app/ReaderChromeViews.swift: custom chrome controls and clipped containers.
• mac-app/ReaderWindow.swift: window drag/drop behavior.

PDF Reading And Page Turns

• mac-app/PDFReaderView.swift: PDFKit view subclass and edge paging events.
• mac-app/PDFPagingPolicy.swift: page turn thresholds and duplicate-turn guard.
• mac-app/ReaderContentBackend.swift: typed PDFKit/WebKit navigation and zoom adapters.
• mac-app/ReaderWindowController+Navigation.swift: page navigation commands.

EPUB And DOCX Reading

• mac-app/DocumentLoading.swift: shared document model and loader entry point.
• mac-app/DocumentLoading+EPUB.swift: EPUB package, cover, TOC, and resources.
• mac-app/DocumentLoading+DOCX.swift: DOCX paragraph, table, and media rendering.
• mac-app/DocumentLoading+DOCXStreaming.swift: cancellable streaming XML rendering.
• mac-app/DocumentLoading+DOCXCache.swift and mac-app/DOCXPreparedCache.swift: selective extraction, verified prepared output, concurrent publication, and bounded cache cleanup.
• mac-app/DocumentLoading+HTML.swift: generated HTML wrapper and rewriting.
• mac-app/Resources/reader-web.js: WebKit reader behavior, selection, and highlights.

AI Chat

• mac-app/AIChatPanel.swift: AI panel state.
• mac-app/AIChatPanel+Actions.swift: summary, translation, explanation, follow-up actions.
• mac-app/AIChatPanel+Requests.swift: streaming request lifecycle and retry/cancel.
• mac-app/AIClient.swift: provider HTTP and streaming client.
• mac-app/AIResponseTextFormatter.swift: visible answer cleanup and translation formatting.
• mac-app/AIPromptStore.swift and mac-app/AIPrompts.json: built-in prompt templates.

Whole-Book AI Analysis Cache

• mac-app/ReaderWindowController+Embedding*.swift: indexing lifecycle, progress, controls, and retrieval.
• mac-app/PDFDocumentAgentIndex.swift: PDF chunking and evidence retrieval.
• mac-app/PDFEmbeddingStore.swift: SQLite embedding cache.
• mac-app/EmbeddingClient.swift: embedding API calls.
• mac-app/AISettingsPanelController+ModelEmbedding.swift: embedding model settings.

Vocabulary And Review

• mac-app/ReaderWindowController+Vocabulary*.swift: vocabulary capture, review UI, navigation, export, persistence.
• mac-app/VocabularySRS.swift: spaced repetition scoring.
• mac-app/VocabularyLearningStats.swift: current-book learning stats and stat card presentation items.
• mac-app/WordRecordSQLiteStore.swift: persistent vocabulary record database.
• mac-app/PDFWordRecordStore.swift and mac-app/WebWordRecordStore.swift: document-specific word records.
• mac-app/VocabularyExporter.swift: Markdown and Anki CSV export.

Reading Notes

• mac-app/ReaderWindowController+ReadingNotes.swift: note creation, saving, navigation, export, deletion, and favorite toggling.
• mac-app/ReadingNoteStore.swift: persistent note database and schema migration.
• mac-app/ReadingNotesPanelController.swift: reading note list panel, search, and row callbacks.
• mac-app/ReadingNoteRowView.swift: note list row UI with open, favorite, and delete actions.
• mac-app/ReadingNotePanelController*.swift: note editor, Markdown editing, images, AI actions, and note menu actions.
• mac-app/ReadingNoteListPresenter.swift: list sorting, search filtering, and row view models.

Persistence Helpers

• mac-app/SQLiteSchemaMigrator.swift: shared SQLite column migration helper used by reading notes and vocabulary records.
• mac-app/UserDataBackupService*.swift: validated backup packages and journaled cold-start restoration.
• mac-app/AppDelegate+UserDataBackup.swift: File menu backup/restore workflow and startup recovery.
• mac-app/LocalEncryptedStore.swift: on-demand Keychain storage for API credentials; credentials are excluded from user-data backups.

TTS And Read Aloud

• mac-app/SpeechPlaybackCoordinator.swift: runtime selection, text segmentation, audio generation, playback, and progress notifications.
• mac-app/SpeechRuntimeResourceManager.swift: speech runtime install state, download URLs, model sizes, compatibility, and cleanup.
• mac-app/RuntimeDownload.swift: runtime download progress, resume data, cancellation, and HTTP error handling.
• mac-app/AISettingsPanelController+Speech.swift: settings actions for model selection, download, pause/resume, delete, and compatibility warnings.
• mac-app/AISettingsPanelController+Build.swift: read-aloud settings controls and runtime status rows.
• mac-app/ReaderWindowController+ReadAloud.swift: PDF and EPUB/DOCX read-aloud entry points.
• mac-app/ReaderWindowController+ReadAloudProgress.swift: read-aloud segment underline/highlight updates.
• docs/wiki/tts.md: detailed TTS code map and runtime rules.

Bookshelf And Session Restore

• mac-app/RecentDocumentsPanelController*.swift: bookshelf UI and actions.
• mac-app/RecentDocumentsStore.swift: recent document persistence.
• mac-app/ReaderWindowController+DocumentShelf.swift: shelf presentation and document actions.
• mac-app/ReaderSessionStore.swift and mac-app/ReaderWindowController+Session.swift: reading position/session persistence.

Release, Updates, And Website

• mac-app/AppDelegate+Updates.swift: Sparkle update UI and manual update checks.
• mac-app/UpdateFailureClassifier.swift: user-facing update failure classification.
• docs/appcast.xml: Sparkle feed.
• docs/index.html: public download page.
• scripts/release_pkg.sh and scripts/publish_release.sh: package and publish workflow.
• scripts/update_wiki.sh: Wiki generation and sync workflow.