jietuba

annotation/
├── screen_annotation.h/.cpp   # ScreenAnnotation — the session: a layer per screen, pass-through/drawing/hidden, cross-screen undo, focus hand-back; ScreenAnnotationShortcutHandler — keys while drawing
├── annotation_view.h/.cpp     # AnnotationView — one screen's drawing layer; as the canvas host it hands the shared toolbar to CanvasView
├── annotation_toolbar.h/.cpp  # AnnotationToolbar — floating toolbar with pass-through, clear, hide and exit; never takes the focus, kept out of captures and recordings
└── cursor_highlight.h/.cpp    # CursorHighlight and PointerLight — the light around the pointer and the click rings

barcode/
├── reader.h/.cpp         # read_codes / DecodedCode — zxing-cpp decoding; text, format and outline in reading order
├── result_window.h/.cpp  # BarcodeResultWindow — result window; screenshot and result list share the same numbers
└── barcode.h             # show_barcode_result — scan entry: decode the codes in the selection and open the result window (toolbar scan button)

canvas/
├── scene.h/.cpp                  # CanvasScene — canvas scene, extends QGraphicsScene
├── view.h/.cpp                   # CanvasView — canvas view, extends QGraphicsView
├── selection_model.h/.cpp        # SelectionModel — manages selected graphics items
├── undo.h/.cpp                   # CommandUndoStack — undo/redo stack (add, delete, batch, edit commands)
├── smart_edit_controller.h/.cpp  # SmartEditController — handles selection/edit mode switching
├── smart_selection_anim.h/.cpp   # SmartSelectionAnimator — tweens the selection when it hops between windows
├── handle_editor.h/.cpp          # LayerEditor / EditHandle — control point drag editing
├── gestures.h/.cpp               # Mouse gesture state machines — text edge drag, rubber-band select, pending click-to-edit
├── handle_overlay.h/.cpp         # HandleOverlayWidget — separate compositing layer for edit handles, avoids full-scene repaint
├── canvas_host.h/.cpp            # CanvasHost — what a window hosting the canvas view offers it (toolbar, magnifier …), shared by the screenshot and pin windows
└── items/
    ├── drawing_items.h/.cpp      # RectItem / EllipseItem / NumberItem, and the DrawingItemMixin all drawn items share
    ├── stroke_item.h/.cpp        # StrokeItem — pen/highlighter stroke; repaints only the chunks that changed or are exposed
    ├── background_item.h/.cpp    # BackgroundItem — selection area background
    ├── mosaic_item.h/.cpp        # MosaicItem — pixel mosaic item
    ├── spotlight_item.h/.cpp     # SpotlightItem / SpotlightCurtain — spotlight holes and their shared curtain
    ├── selection_item.h/.cpp     # SelectionItem — selection boundary display
    ├── arrow_item.h/.cpp         # ArrowItem — arrow item, geometry for nine shaft and head styles
    ├── text_item.h/.cpp          # TextItem — text item, outline/shadow/background and tri-state interaction frame
    ├── watermark_item.h/.cpp     # WatermarkItem / WatermarkStyle — watermark layer over the selection: tiled, a diamond grid, or at one of seven positions, multi-line, time stamps
    └── item_reference.h          # ItemReference / ItemLease — item ownership and lifetime: the scene owns attached items, undo commands own detached ones

capture/
├── capture_service.h/.cpp           # CaptureService — core screenshot logic
├── display_watcher.h/.cpp           # DisplayChangeWatcher — rebuilds the HDR capture session in the background after display changes
├── system_cursor.h/.cpp             # SystemCursor — snapshots the mouse pointer and draws it into screenshots
├── quick_capture_controller.h/.cpp  # QuickCaptureController — modifier-drag capture and action dispatch
├── window_finder.h/.cpp             # WindowFinder — smart window selection, cursor-based detection
└── msaa_element_finder.h/.cpp       # MSAAElementFinder — point query: background threads ask MSAA for the control under the pointer and its parent chain, for smart selection

clipboard/
├── controllers/                        # Control layer — history loading, paste flow, menus, selection state
│   ├── clipboard_controller.h/.cpp     # ClipboardController — loading, pasting, context menu logic
│   ├── selection_manager.h/.cpp        # SelectionManager — list selection state
│   ├── context_menu_controller.h/.cpp  # ClipboardContextMenuController — assembles context menu data and actions
│   ├── foreground_tracker.h/.cpp       # ForegroundWindowTracker — remembers the window to paste into
│   └── paste_keystroke.h/.cpp          # Restores focus to the target window, then sends Ctrl+V
├── core/                               # Data layer — pyclipboard wrapper, models, group types
│   ├── manager.h/.cpp                  # ClipboardManager — storage, monitoring, and paste API
│   ├── models.h/.cpp                   # ClipboardItem / Group models
│   └── text_transform.h/.cpp           # Plain-text transforms — pure functions behind "paste special"
├── services/                           # Service layer — file payloads, group rules, import/export, save logic
│   ├── file_payload_service.h/.cpp     # file payload JSON + legacy format compatibility
│   ├── group_service.h/.cpp            # group icon/name/delete helpers
│   ├── import_export_service.h/.cpp    # CSV import/export for text items
│   └── manage_dialog_service.h/.cpp    # persistence logic for the management window
└── ui/
    ├── layout_scale.h/.cpp             # Shared size metrics for the management dialog
    ├── image_item_actions.h/.cpp       # load and save-as for image items, shared by both windows
    ├── group_kind_style.h/.cpp         # Identifying colours and line icons of the group types, shared by the sidebar rows and the type cards
    ├── dialogs/
    │   └── manage_dialog.h/.cpp        # three-pane management window for groups and content
    ├── forms/
    │   ├── group_form.h/.cpp
    │   ├── text_content_form.h/.cpp
    │   ├── file_content_form.h/.cpp
    │   ├── import_export_form.h/.cpp
    │   ├── group_icon_picker.h/.cpp
    │   ├── form_widgets.h/.cpp
    │   └── image_content_form.h/.cpp
    ├── menus/
    │   └── action_menu.h/.cpp
    ├── mixins/
    │   └── frameless_mixin.h/.cpp
    ├── panels/
    │   └── setting_panel.h/.cpp
    ├── resources/
    │   └── emoji_data.h/.cpp
    ├── theme/
    │   ├── themes.h/.cpp
    │   ├── theme_styles.h/.cpp
    │   └── chevron.h/.cpp              # Drop-down chevron images drawn per colour and size and cached for the style sheets
    ├── widgets/
    │   ├── group_bar.h/.cpp
    │   ├── item_delegate.h/.cpp
    │   ├── item_drag.h/.cpp            # Dragging history items out: text, HTML, images and files, written only when a target asks for files
    │   ├── selection_bar.h/.cpp        # The bar under the list during multiple selection: count, paste, save and other actions
    │   ├── preview_popup.h/.cpp
    │   ├── quick_edit_popup.h/.cpp
    │   ├── manage_rows.h/.cpp
    │   └── reorder_list.h/.cpp
    └── windows/
        ├── clipboard_window.h/.cpp     # history window, search, preview, quick paste
        └── pin_window.h/.cpp           # create pins from history items

core/
├── bootstrap.h/.cpp            # PreloadManager — startup bootstrap, env init, DPI, single instance
├── data_location.h/.cpp        # Where the settings file lives: settings.ini next to the exe when there is one, else %APPDATA%\Jietuba
├── game_mode_monitor.h/.cpp    # GameModeMonitor — follows foreground switches to tell when a game is in front, for "Pause Hotkeys While Gaming"
├── elevation.h/.cpp            # Run as administrator — elevation state, scheduled task for sign-in
├── logger.h/.cpp               # Logger — file + console logging (debug/info/warning/error/exception)
├── crash_handler.h/.cpp        # install_crash_hooks() — global exception catching
├── resource_manager.h/.cpp     # ResourceManager — SVG/image resource loading
├── theme.h/.cpp                # ThemeManager — application theme colors
├── ui_scale.h/.cpp             # UIScaleManager — one scale factor for toolbars, panels and popups
├── i18n.h/.cpp                 # I18nManager / XmlTranslator / tr() — internationalization
├── shortcut_manager.h/.cpp     # HotkeySystem / ShortcutManager — global & in-app hotkeys
├── global_hotkey.h/.cpp        # Global hotkey key names and routing: system registration, hook takeover, or rejected
├── input_hub.h/.cpp            # Shared global input: hooks off the GUI thread, events as Qt signals
├── input_engine.h/.cpp         # Input state machine — gestures, hotkeys, shortcut recording, watchers
├── input_hooks.h/.cpp          # Low-level mouse/keyboard and foreground hooks on their own thread
├── quick_capture_input.h/.cpp  # Global mouse shortcut drag input on the shared input hub
├── last_capture_region.h/.cpp  # In-memory "last capture region" for the restore-region hotkey
├── save.h/.cpp                 # SaveService — file save service (auto naming, high-quality PDF output)
├── export.h/.cpp               # ExportService — image export
├── clipboard_utils.h/.cpp      # copy_image_to_clipboard() — copy images to system clipboard
├── platform_utils.h/.cpp       # DPI awareness, AppUserModelID, Windows API utilities
├── qt_utils.h/.cpp             # safe_disconnect() — Qt signal safe disconnect
├── constants.h/.cpp            # Global constants (fonts, paths, etc.)
├── background_tasks.h/.cpp     # Background save tracking
├── update_cache.h/.cpp         # Updater cache cleanup
├── updater_process.h/.cpp      # Rust updater JSONL process adapter
├── update_controller.h/.cpp    # Update download and safe restart coordination
├── update_checker.h/.cpp       # Asynchronous GitHub release lookup and version comparison
├── ui_theme.h/.cpp             # UIThemeManager — light/dark appearance for app windows and native Qt widgets
├── east_asian_width.h/.cpp     # is_east_asian_wide — whether a code point is wide or fullwidth (East Asian Width W/F)
├── east_asian_width.inc        # East Asian Width table (generated by a script)
├── hooks.h                     # HookList — callbacks on an object's extension point, called in registration order and removable by id
├── html_entities.inc           # HTML named character reference table (generated by a script)
├── html_unescape.h/.cpp        # html_unescape — decode named and numeric HTML character references
├── http_client.h/.cpp          # http_request — one blocking exchange through the system's WinHTTP with the system proxy; tells HTTP errors, timeouts and network failures apart; cancellable
├── native.h                    # Declarations of the C interface to the Rust libraries (cpp/native)
├── text_utils.h/.cpp           # left_chars — truncate to a number of characters without splitting a surrogate pair
└── serial_executor.h           # SerialExecutor — runs tasks one at a time in submission order on a dedicated thread

gif/
├── record_window.h/.cpp        # GifRecordWindow / AppState — state machine coordinator (3-layer window)
├── overlay.h/.cpp              # CaptureOverlay / OverlayMode — capture overlay, region adjustment
├── drawing_view.h/.cpp         # GifDrawingView / GifDrawingScene — drawing during recording
├── record_toolbar.h/.cpp       # RecordToolbar — start/pause/stop controls
├── frame_recorder.h/.cpp       # FrameRecorder / FrameData / CursorSnapshot — frame sampling
├── video_recorder.h/.cpp       # VideoRecorder — bounded JSONL control of the MP4 recording worker
├── video_settings.h/.cpp       # RecordingOptions — independent video FPS/bitrate/audio settings
├── playback_engine.h/.cpp      # PlaybackEngine / PlayState — frame playback and preview
├── playback_controller.h/.cpp  # PlaybackController — playback UI and export management
├── playback_toolbar.h/.cpp     # PlaybackToolbar / RangeSlider — progress bar, speed control
├── composer.h/.cpp             # ComposeWorker / ComposerProgressDialog — GIF/video composition
├── cursor_overlay.h/.cpp       # CursorOverlay — cursor rendering and click animation
├── _widgets.h/.cpp             # ClickMenuButton / svg_icon() — custom widgets
└── gifrecorder.h/.cpp          # C++ handles over the native gifrecorder — frame store, frame decoder, recording session, cursor sprites

ocr/
├── ocr_manager.h/.cpp        # OCRManager — engine choice, loading, release, unified recognition interface
├── ocr_line_geometry.h/.cpp  # Reading frame and character positions of a recognized line, estimated from character widths when the engine gives none
├── ppocr_models.h/.cpp       # PP-OCR models: models/ folder, built-in catalog, import, removal, download via the updater
├── snipping_tool_ocr.h/.cpp  # SnippingToolOcr — locate the Snipping Tool, copy its OCR files, pad and recognize
└── bundled_runtime.h/.cpp    # bundled_runtime — the onnxruntime.dll embedded in the Full exe, written into models/ at startup when missing or unusable

pin/
├── pin_window.h/.cpp             # PinWindow — draggable, zoomable, always-on-top image window
├── pin_canvas_view.h/.cpp        # PinCanvasView — pin canvas view (sole content renderer)
├── pin_canvas.h/.cpp             # Pin canvas object
├── pin_manager.h/.cpp            # PinManager — manages all pin windows (singleton)
├── pin_toolbar.h/.cpp            # PinToolbar — pin toolbar
├── pin_controls.h/.cpp           # PinControlButtons — close, edit, copy buttons
├── pin_hover.h/.cpp              # PinHoverControls — decides when hover buttons and toolbar show
├── pin_context_menu.h/.cpp       # PinContextMenu — right-click menu
├── pin_border_overlay.h/.cpp     # PinBorderOverlay — border effect overlay
├── pin_click_through_bar.h/.cpp  # PinClickThroughBar — move / opacity / exit bar while clicks pass through
├── pin_ocr_manager.h/.cpp        # PinOCRManager / PinOcrThread — async OCR recognition
├── pin_shortcut.h/.cpp           # PinShortcutController — normal/edit mode shortcuts
├── pin_thumbnail.h/.cpp          # PinThumbnailMode — thumbnail mode
├── pin_translation.h/.cpp        # PinTranslationHelper — translation helper
├── pin_image_transform.h/.cpp    # PinImageTransform — rotate, flip, etc.
├── ocr_text_layout.h/.cpp        # OcrTextLayout — the pin's recognized text and selection, in image pixels
├── pin_text_selection.h/.cpp     # PinTextSelection — selecting text on a pin by dragging, double-clicking or Ctrl+A, and its highlight
└── pin_text_mode.h/.cpp          # PinTextPanel / PinTextEdit — text mode: the pin shown as editable recognized text

settings/
├── app_settings.inc          # The settings table: one row per setting (key, type, default, scope), generating the typed accessors, defaults and import list
├── tool_settings.h/.cpp      # ToolSettingsManager / ToolSettings — tool color, size, hotkey config
├── data_folder.h/.cpp        # At startup: takes in the settings older versions kept in the registry, and keeps the autostart entries in line with the switch
├── settings_transfer.h/.cpp  # Import settings from another settings.ini or a JSON file exported by earlier versions
├── color_formats.h/.cpp      # magnifier color format templates: render, load, save
└── special_paste.h/.cpp      # special paste menu: built-in options, order and on/off state

stitch/
├── auto_scroll.h/.cpp                  # AutoScroller — auto scroll: step size from stitch results, stops at the end or on mouse move
├── change_watch.h/.cpp                 # ChangeWatch — watches the capture area in the background and captures whenever the view changes
├── incremental.h/.cpp                  # IncrementalStitcher — background stitching, preview thumbnails
├── jietuba_long_stitch_unified.h/.cpp  # Stitching interface (calls the Rust longstitch)
├── scroll_window.h/.cpp                # ScrollCaptureWindow — scroll capture window
└── scroll_toolbar.h/.cpp               # Scroll capture toolbar

text_recognition/
├── layout.h/.cpp         # layout — lays recognized lines out as text: joins wrapped lines, removes spaces between CJK characters, converts punctuation width
├── placement.h/.cpp      # placement — where the result window goes (positions only, no window access)
├── recognizer.h/.cpp     # RecognizeThread — recognizes one image on a worker thread and reports the result
├── result_window.h/.cpp  # TextRecognitionWindow — the result window: an editable text box, a copy button and the layout menu
└── text_recognition.h    # recognize_async / show_text_recognition — entry points: background recognition, opening the result window, copying the result

tools/
├── base.h/.cpp            # Tool / ToolContext — abstract base class
├── controller.h/.cpp      # ToolController — tool switching and state management
├── action.h/.cpp          # ActionTools — copy, save, cancel actions
├── pen.h/.cpp             # PenTool — freehand drawing
├── rect.h/.cpp            # RectTool — rectangle (filled/outlined)
├── ellipse.h/.cpp         # EllipseTool — ellipse
├── arrow.h/.cpp           # ArrowTool — arrow
├── text.h/.cpp            # TextTool — text
├── number.h/.cpp          # NumberTool — auto-incrementing numbers
├── highlighter.h/.cpp     # HighlighterTool — highlighter
├── mosaic.h/.cpp          # MosaicTool — pixel mosaic
├── spotlight.h/.cpp       # SpotlightTool — spotlight (dims outside the box)
├── watermark.h/.cpp       # WatermarkTool — adds the watermark, changes its text and style, remembers whether the last screenshot had one
├── cursor.h               # CursorTool — cursor/selection
├── eraser.h/.cpp          # EraserTool — eraser
└── cursor_manager.h/.cpp  # CursorManager — cursor style manager

translation/
├── provider.h/.cpp                      # TranslationProvider / ProviderMetadata — provider contract
├── registry.h/.cpp                      # ProviderRegistry — provider registration and factory
├── service.h/.cpp                       # TranslationService — provider selection and orchestration
├── models.h/.cpp                        # TranslationRequest / TranslationResult — provider-neutral models
├── worker.h/.cpp                        # TranslationWorker — shared Qt worker for all providers
├── providers/                           # provider implementations
│   ├── deepl.h/.cpp                     # DeepL
│   ├── google.h/.cpp                    # Google
│   ├── azure.h/.cpp                     # Azure
│   ├── amazon.h/.cpp                    # Amazon
│   ├── baidu.h/.cpp                     # Baidu
│   ├── tencent.h/.cpp                   # Tencent Cloud
│   ├── volcengine.h/.cpp                # Volcengine
│   ├── youdao.h/.cpp                    # Youdao
│   ├── custom_llm.h/.cpp                # Custom OpenAI-compatible service (Ollama, LM Studio…)
│   ├── deepseek.h/.cpp                  # DeepSeek (LLM)
│   ├── openai_compatible.h/.cpp         # Base class for OpenAI-compatible endpoints
│   └── common.h                         # Response parsing and error-body helpers shared by the providers
├── smart_translation_controller.h/.cpp  # SmartTranslationController — one-hotkey text probe and popup routing
├── translation_popup.h/.cpp             # TranslationPopup — compact popup (selected text / typed input)
├── deepl_service.h/.cpp                 # DeepLService / DeepLResult — legacy async DeepL API calls
├── languages.h                          # translation_languages / source_languages — supported language list & codes
├── translation_manager.h/.cpp           # TranslationManager — translation window manager (singleton)
├── translation_dialog.h/.cpp            # TranslationDialog — translation result window
├── speech_service.h/.cpp                # SpeechService / SapiBackend — reads translations aloud through the system SAPI, matching voices by language, one reading at a time
└── ui/
    └── widgets.h/.cpp                   # Translation widgets

translations/
├── app_zh.xml / app_en.xml  # Chinese / English source files
├── app_ja.xml / app_ko.xml  # Japanese / Korean source files
├── app_zh_TW.xml            # Traditional Chinese (Taiwan) source file
└── app_*.qm                 # compiled Qt binaries (e.g. app_zh.qm)

ui/
├── toolbar.h/.cpp                   # Toolbar / ToolbarDragHandle — draggable toolbar base class
├── toolbar_layout.h/.cpp            # screenshot / pin toolbar button layouts (order / visibility): normalize, load, save
├── toolbar_layout_dialog.h/.cpp     # ToolbarLayoutDialog — screenshot / pin toolbar layout editor
├── reorderable_rows.h/.cpp          # DragGrip / DraggableRow / ReorderableRowList — drag-to-reorder rows
├── tray_menu.h/.cpp                 # CustomTrayMenu — system tray menu
├── screenshot_window.h/.cpp         # ScreenshotWindow — full-screen capture window (region drawing)
├── quick_capture_overlay.h/.cpp     # Transparent quick capture layer reusing the normal selection, coordinates and magnifier
├── update_dialog.h/.cpp             # Update notes and download progress
├── dialogs.h/.cpp                   # StandardDialog — confirm, warning, info, error dialogs
├── toast.h/.cpp                     # Toast — one-line hint by the cursor that never takes focus
├── submenu_position.h/.cpp          # Cascading submenus: which way they open and how they hug the parent item
├── magnifier.h/.cpp                 # MagnifierOverlay — pixel-level magnifier
├── color_picker_button.h/.cpp       # ColorPickerButton — color selection button
├── color_picker_dialog.h/.cpp       # Color picker window: saturation/value square, hue and opacity sliders, eyedropper
├── save_image_dialog.h/.cpp         # SaveImageDialog — save image dialog: frequent folder tags, format and quality
├── screenshot_countdown.h/.cpp      # ScreenshotCountdown — countdown before a delayed screenshot
├── hotkey_edit.h/.cpp               # HotkeyEdit — global hotkey editor
├── inapp_key_edit.h/.cpp            # InAppKeyEdit — in-app shortcut editor
├── key_chip.h/.cpp                  # KeyChipLineEdit / StatusIcon — shared shortcut chip look
├── mask_overlay.h/.cpp              # mask overlay layer
├── selection_overlay.h/.cpp         # SelectionOverlayWidget — selection chrome layer above the mask
├── base_settings_panel.h/.cpp       # BaseSettingsPanel / StepperWidget — settings panel base class
├── paint_settings_panel.h/.cpp      # PaintSettingsPanel — brush settings panel
├── shape_settings_panel.h/.cpp      # ShapeSettingsPanel — shape settings panel
├── text_settings_panel.h/.cpp       # TextSettingsPanel — text settings panel
├── arrow_settings_panel.h/.cpp      # ArrowSettingsPanel — arrow settings panel
├── number_settings_panel.h/.cpp     # number tool settings panel
├── mosaic_settings_panel.h/.cpp     # mosaic tool settings panel
├── watermark_settings_panel.h/.cpp  # watermark panel: text, position, style popup (opacity/size/spacing/angle/grid lines/color), font
├── watermark_input_dialog.h/.cpp    # WatermarkInputDialog — multi-line watermark text with time insertion and preview
├── initial_selection.h/.cpp         # InitialSelectionGate — holds the capture window back until the first point query returns (at most 50 ms), so the first frame already shows a selection
│
├── fluent_lite/                     # Fluent-style lightweight component library
│   ├── buttons.h/.cpp               # buttons
│   ├── cards.h/.cpp                 # cards
│   ├── icons.h/.cpp                 # icons
│   ├── inputs.h/.cpp                # inputs
│   ├── labels.h/.cpp                # labels
│   ├── navigation.h/.cpp            # navigation
│   ├── segmented.h/.cpp             # segmented controls
│   ├── switch.h/.cpp                # switch
│   ├── theme.h/.cpp                 # theme
│   ├── titlebar.h/.cpp              # title bar
│   ├── frameless.h/.cpp             # frameless windows
│   ├── text_context_menu.h/.cpp     # text context menu
│   └── fluent_lite.h/.cpp           # Umbrella header and the check button
│
├── settings_ui/                     # Application settings dialog
│   ├── dialog.h/.cpp                # SettingsDialog — tabbed settings dialog
│   ├── components.h/.cpp            # SettingCardGroup / ToggleSwitch — setting components
│   ├── page_appearance.cpp          # Appearance settings (theme, language)
│   ├── page_capture.cpp             # Capture settings
│   ├── page_quick_actions.cpp       # Quick actions settings (skip confirm or result windows)
│   ├── color_format_dialog.h/.cpp   # ColorFormatDialog — magnifier color format editor
│   ├── ppocr_model_dialog.h/.cpp    # PpocrModelDialog — download, add, and delete PP-OCR models
│   ├── page_clipboard.cpp           # Clipboard settings
│   ├── special_paste_dialog.h/.cpp  # SpecialPasteDialog — reorder and toggle special paste menu items
│   ├── page_hotkey.cpp              # Hotkey settings
│   ├── page_mouse.cpp               # Mouse shortcut settings
│   ├── page_pin.cpp                 # Pin settings (behavior, appearance, click-through)
│   ├── page_screen_annotation.cpp   # Screen annotation settings
│   ├── page_translation.cpp         # Translation settings
│   ├── provider_fields.cpp          # Translation provider fields: read/write config and widget values from declarations
│   ├── page_log.cpp                 # Log settings
│   ├── page_developer.cpp           # Developer settings
│   ├── page_misc.cpp                # Miscellaneous settings
│   ├── page_about.cpp               # About page
│   ├── mouse_binding_editor.h       # MouseBindingEditor — picker for a mouse shortcut's modifiers and gesture
│   └── pages.h                      # Declarations of the settings page builders
│
├── welcome/                         # First-run welcome wizard (8-page guided setup)
│   ├── wizard.h/.cpp                # WelcomeWizard — wizard main window
│   ├── base_page.h/.cpp             # BasePage — wizard page base class
│   ├── page1_welcome.cpp            # Welcome page
│   ├── page2_screenshot.cpp         # Screenshot hotkey setup page
│   ├── page3_clipboard.cpp          # Clipboard hotkey setup page
│   ├── page5_translation.cpp        # Translation feature intro page
│   ├── page6_finish.cpp             # Finish page
│   ├── page_hotkeys.cpp             # Global hotkey page — six hotkeys share one conflict domain, set and validated together
│   ├── page_mouse_shortcuts.cpp     # Global mouse shortcut page — hold modifiers and drag to capture or act at once
│   ├── page_screen_annotation.cpp   # Screen annotation page — a demo and its hotkeys
│   └── pages.h                      # Declarations of the wizard pages
│
└── selection_info/                  # Selection info UI
    ├── controller.h/.cpp            # Selection info controller
    ├── panel.h/.cpp                 # Selection info panel (dimensions, coordinates)
    ├── border_shadow.h/.cpp         # Selection border shadow effect
    ├── lock_ratio.h/.cpp            # Aspect ratio lock
    └── rounded_corners.h/.cpp       # Rounded corner capture

video/
└── worker.h/.cpp  # worker_main — entry of the MP4 recording process: JSON-line commands on stdin, JSON-line events on stdout; frames stay inside the native recorder

tests/
├── test_barcode.cpp               # QR code and barcode reading
├── test_bundled_runtime.cpp       # Writing the Full package's embedded runtime
├── test_canvas_items.cpp          # Canvas items: handles, borders and appearance settings
├── test_canvas_parity.cpp         # Canvas drawing geometry, pixels, undo and ownership
├── test_canvas_view.cpp           # Canvas view
├── test_capture_finders.cpp       # Window lookup and the system pointer on the real desktop (desktop test)
├── test_clipboard.cpp             # Clipboard logic and context menus
├── test_clipboard_backend.cpp     # Clipboard backend: the database and the system clipboard watcher
├── test_clipboard_controller.cpp  # Clipboard window controller: paging, filters, groups, pasting
├── test_clipboard_drag.cpp        # Dragging clipboard items out: the formats each target gets and files written on demand
├── test_clipboard_manage.cpp      # Clipboard management window
├── test_clipboard_selection.cpp   # Keyboard and mouse selection in the clipboard list
├── test_clipboard_ui.cpp          # The clipboard backend, windows and settings together
├── test_clipboard_widgets.cpp     # Clipboard widgets: row painting, preview popups, gear menu, themes
├── test_clipboard_window.cpp      # Clicks, keys and menus of the clipboard window
├── test_core.cpp                  # Core: global hotkeys, log texts, the administrator task, single-instance hand-off
├── test_data_folder.cpp           # Settings file location, registry vs INI, migrating older settings, autostart entries
├── test_freehand.cpp              # Pen stroke smoothing, snapping and chunked repainting
├── test_gif.cpp                   # GIF/MP4 recording, playback and export
├── test_gif_playback.cpp          # GIF playback: decoding and playing at the display size
├── test_hdr_capture.cpp           # HDR capture (desktop test)
├── test_http_providers.cpp        # The HTTP client and providers with a configurable address
├── test_input_engine.cpp          # Input state machine: gestures, hotkeys, shortcut recording
├── test_input_hooks.cpp           # The input hook thread on the real desktop, driven by injected input (desktop test)
├── test_logger.cpp                # Logging
├── test_main_app.cpp              # Main app: tray, hotkeys, capture flow and global input (desktop test)
├── test_msaa_element_finder.cpp   # Point query and first-frame selection
├── test_ocr_manager.cpp           # OCR engine and model management
├── test_parity.cpp                # Selection state, last region, toolbar layout, scale rounding, setting defaults and persistence
├── test_pin.cpp                   # Pin: rotation, OCR coordinate mapping and window behaviour
├── test_platform.cpp              # Platform helpers: processes, DPI, autostart, crash log
├── test_ppocr_models.cpp          # PP-OCR model download, adding and catalog
├── test_result_windows.cpp        # OCR and barcode result windows
├── test_sandbox.cpp               # Linked into every test program: points settings, data and logs at a temporary folder
├── test_save_image_dialog.cpp     # Save image dialog: folder tags, format and quality
├── test_screen_annotation.cpp     # Screen annotation: per-screen layers, click-through and focus, cross-screen undo, screens plugged in or out
├── test_screenshot_window.cpp     # Screenshot window
├── test_scroll_capture.cpp        # Scroll capture
├── test_settings_window.cpp       # Settings window
├── test_shortcut_manager.cpp      # Shortcut manager and global hooks
├── test_smart_selection.cpp       # Smart selection over real windows (desktop test)
├── test_snipping_tool_ocr.cpp     # Snipping Tool OCR binding (against a fake oneocr.dll)
├── test_stitch.cpp                # Long screenshot stitching
├── test_text_recognition.cpp      # Text recognition: layout and window placement
├── test_translation.cpp           # Translation providers, registry and service
├── test_translation_speech.cpp    # Reading translations aloud (a fake backend, no system voice)
├── test_translation_ui.cpp        # Translation window and popup
├── test_ui_widgets.cpp            # Shared widgets: toolbar, settings panels, hotkey editors and more
├── test_update.cpp                # Update check and one-click update (against a fake updater)
├── clipboard_test_support.h       # Shared setup of the clipboard tests
├── caption_check.h                # Checks that self-drawn windows share one caption layout (icon on the left, then the title)
├── save_dialog_answerer.h         # Answers the save image dialog in tests
├── fake_oneocr.cpp                # Stand-in for the Snipping Tool's oneocr.dll in tests (including variants missing functions)
├── fake_updater.cpp               # Stand-in for the updater helper in tests
├── leak_check.h/.cpp              # Leak mode: runs the tests three times and finds leaks on the debug heap
└── fixtures/                      # Expected-result data (committed, not regenerated)