Changelog
=========

All notable changes to this project are documented here.
The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.1.0/>`_.

1.15.0 (2026-07-24)
-------------------

Added
^^^^^

- **``F2`` shortcut for the "Rename selection" button** — clicking the button moved keyboard focus away from the file list, preventing further arrow-key navigation until it regained focus; a shortcut triggers the action without stealing focus. Also added to the shortcuts window (F1) and to the button's tooltip.
- **Hidden catalogs** — catalogs whose name starts with ``.`` or ``-`` are now excluded from the Catalog menu and the "Delete catalog…" list. ``list_catalogs()`` gained an ``include_hidden`` keyword argument (default ``False``) to opt into seeing them. Switching to a hidden catalog no longer overwrites ``catalog.conf``, so restarting the app always resumes the last non-hidden catalog rather than a hidden one.
- **Optional positional CLI argument to load a specific catalog at startup** — ``pbpicat <name>`` (may be a hidden catalog; a name starting with ``-`` must be passed after ``--``, e.g. ``pbpicat -- -secret``). If no catalog with that name exists, a warning dialog is shown and startup falls back to the normal behaviour (last opened catalog).
- **"Sort ↓" / "Sort ↑" buttons in the history edit windows** (``Settings → Histories…``) alongside the existing Move up/down — sort ascending/descending, locale-aware (``QCollator`` using the interface's display language) and insensitive to case and diacritics (``O=o=Ô=Ǫ``, ``Œ=OE=œ``). Disabled when fewer than 2 items are in the list. Empty-string entries always sort to the end, regardless of direction.

Changed
^^^^^^^

- **"New catalog…" / "Duplicate catalog…" — name already taken** — previously just showed a blocking "Already exists" error and cancelled. Now asks whether to open the existing catalog instead (checked against *all* catalogs, including hidden ones); choosing "Open" switches to it, otherwise the action is cancelled as before.

Fixed
^^^^^

- **Arrow-key navigation jumped to the first row after renaming a file (not the first in the list) with the ``F2`` shortcut** — renaming triggers a disk change that ``QFileSystemWatcher`` picks up shortly after ``refresh_and_select()``'s own refresh already ran, restarting the 400 ms debounce and firing a second, redundant ``_refresh_preserve_selection()``. That method (and ``refresh_and_select_paths()``) restored the previous *selection* after the table rebuild but never restored the *current index*, which the rebuild invalidates — so the renamed-to row stayed visibly selected while ``currentIndex()`` was ``-1``, and the next arrow-key press navigated as if starting from row 0. Both methods now delegate to a new shared ``_select_paths_and_set_current()`` helper, which also calls ``selectionModel().setCurrentIndex()`` for the first restored row — centralizing the fix instead of duplicating it in both call sites.


1.14.0 (2026-07-19)
-------------------

Added
^^^^^

- **README link to the documentation** — ``README.md`` now links to the [Read the Docs site](https://pbpicat.readthedocs.io).

Fixed
^^^^^

- ``docs/conf.py``: the ``## [Unreleased]`` section of ``CHANGELOG.md`` was dropped by the RST changelog generator except for its orphaned ``### Added``/``### Changed``/... subheadings, which were emitted without content and at an incorrect nesting level. ``[Unreleased]`` is now recognised like a dated release and included only when it has actual content.
- **Application froze (hard hang, required killing the process) after renaming a couple of files in a row with the image viewer open** — each rename made ``refresh_and_select()`` reload the full-size image synchronously on the GUI thread (``ImageViewer.load_image`` → ``load_pixmap``) while ``_start_worker()`` concurrently spawned ``_ThumbnailWorker`` background threads decoding thumbnails (``load_qimage``) for the same refreshed rows. Qt's ``QImageReader``/image-format plugins are not safe to invoke concurrently from multiple threads, and decoding from the GUI thread at the same time as a worker thread deadlocked inside ``QImageReader.read()``. Confirmed via a repro script that reliably hung the process, with ``faulthandler`` stack dumps (triggered by ``SIGABRT``) pinpointing both the GUI thread and worker threads blocked in ``QImageReader.read()`` simultaneously. ``image_io.py``'s ``load_qimage()`` and ``load_pixmap()`` now serialize all Qt decodes behind a shared ``threading.Lock``.
- ``FileListWidget.refresh_and_select()`` did not stop the pending ``_refresh_debounce`` timer before refreshing, unlike its sibling refresh methods, allowing a directory-watcher-triggered refresh to fire redundantly right after a rename's explicit refresh.
- **``pbpicat.svg``** — replaced the ``style="width: 100%; height: 100%;"`` attribute with explicit ``width="1024" height="1024"``, matching the convention used by icons in other applications.


1.13.0 (2026-07-07)
-------------------

Added
^^^^^

- **Sphinx/ReadTheDocs documentation** — ``docs/`` (user guide, API reference, changelog generated from ``CHANGELOG.md`` at build time, app icon reused as logo/favicon) and a ``CODING.md`` developer guide covering versioning, changelog, and release conventions. Wired into ``make docs``/``make docs-live``, ``.readthedocs.yaml``, and a CI job that builds the docs on every push.


1.12.0 (2026-07-06)
-------------------

Fixed
^^^^^

- **Large photos (50-100 MP phone cameras) rejected with ``qt.gui.imageio: QImageIOHandler: Rejecting image as it exceeds the current allocation limit of 256 megabytes`` when opened in the viewer** — Qt's default 256 MiB allocation limit is checked against the image's undecoded dimensions; a 50+ MP photo decodes to 200-400 MB as RGB32, exceeding it, which made Qt reject the read outright and fall back to a much slower full-resolution Pillow decode just to display the file. ``image_io.py``'s ``_make_reader()`` now raises the limit to 1024 MiB (``_ALLOCATION_LIMIT_MIB``). Thumbnail generation was never affected (it downscales via ``setScaledSize()``, checked against the target size, not the source).
- **Batch rotation stopped at the first failing file** — when rotating multiple selected files and one failed (e.g. a truncated JPEG), ``_rotate_images()`` stopped processing the rest of the selection. Now continues with the remaining files, and a single dialog lists all failures with their respective file name and message.
- **Rotation errors did not show which file caused them** — ``QMessageBox`` for both rotation failures and undo failures showed only the raw error text (e.g. "Premature end of JPEG file"), with no way to tell which file among the selection was at fault. Both dialogs now prefix the message with the file name.
- **Rotation on a genuinely truncated JPEG failed with the cryptic ``jpegtran`` message "Premature end of JPEG file"** — some files (e.g. panorama shots) are missing a small amount of data at the end, most likely from an incomplete write by the camera; ``jpegtran`` correctly refuses to rotate them since it cannot reconstruct the missing DCT blocks losslessly. Added a user-friendly explanation shown above the raw ``jpegtran`` message in ``rotate_lossless()``'s ``RuntimeError`` (``_jpegtran_error_hints()`` in ``image_ops.py``).
- **Some JPEGs triggered a permanent ``qt.gui.imageio.jpeg: Corrupt JPEG data: N extraneous bytes before marker 0xd9`` warning** — trailing garbage bytes before the EOI marker (seen on some camera/app-produced JPEGs). Unlike the SOS defect above, there is no safe byte-level fix (the exact boundary between real entropy data and garbage can't be determined without a full Huffman decode), and it also has no practical impact: Qt/Pillow decode the image fine regardless. Silenced via ``QLoggingCategory.setFilterRules("qt.gui.imageio.jpeg=false")`` in ``__main__.py``.
- **JPEGs from some phone cameras (e.g. certain Samsung front-camera modules) triggered a permanent ``qt.gui.imageio.jpeg: Invalid SOS parameters for sequential JPEG`` warning, displayed without EXIF auto-rotation, and failed lossless rotation** — these files have a malformed SOS header (``Se=0`` instead of the mandatory ``63`` for baseline JPEGs), which ``jpegtran`` rejects outright and Qt's decoder merely warns about. Added ``repair_jpeg_sos()`` in ``image_ops.py``, a lossless header fix (no entropy-coded data touched, no-op on well-formed files) applied before both Qt decoding (``image_io.py``) and ``jpegtran`` invocation. Also fixed ``load_pixmap()``'s ``auto_rotate=True`` fast path, which used a bare ``QPixmap(str(path))`` and never actually enabled Qt's ``setAutoTransform``, silently skipping EXIF auto-rotation in the main viewer (thumbnails were unaffected, as they already went through ``QImageReader`` with ``setAutoTransform``).
- **Double-click on image opens viewer with spurious "Cannot display multiple files simultaneously" error** — Qt's ``ExtendedSelection`` mode emits ``itemSelectionChanged`` twice during a double-click (clear then re-select), causing ``_on_selection_changed`` to see 0 rows and wrongly trigger the multi-file message. Fixed by ignoring the transient empty-selection state (``len(rows) == 0``) in ``_on_selection_changed``.
- **File list selection jumps to row 0 after opening image viewer** — ``focusInEvent`` called ``selectRow(0)`` whenever focus returned via a non-mouse event and the selection appeared empty, which happened when the viewer window stole focus. Fixed by skipping the auto-select-first-row logic while the image viewer is visible.
- **Mouse-wheel scrolling through a long file list could stall repeatedly** — restarting the visible-thumbnails worker (on each scroll-driven debounce firing) used to block the GUI thread waiting for the previous worker's current in-flight JPEG decode to finish; with large real photos and many debounce firings over a long scroll session, this added up to noticeable stalls, especially scrolling back up through thousands of rows. Restarting on scroll/resize now cancels the previous worker without blocking (``_cancel_worker_async()``), since the table itself isn't being rebuilt and a stray late thumbnail from the cancelled thread simply lands on a still-valid row.
- **Wheel/keyboard scrolling a long distance still felt slow, worse the further travelled** — unlike a scrollbar-handle drag (a single jump to a destination, loading only its final position), traversing the list with the mouse wheel passes through every intermediate row, and each pause between wheel notches longer than the debounce interval (previously 100 ms) triggered a batch load for that transient position — so the number of batches triggered, and the cumulative lag, scaled with the distance scrolled rather than the destination itself. Raised the debounce to 400 ms, comfortably longer than typical inter-notch gaps during continuous scrolling, so intermediate positions are skipped and only the position where scrolling actually settles gets loaded.
- **Rotation-error dialog could grow unusably tall with a large selection** — rotating thousands of files with many failures joined every file's error into one long plain message, pushing the OK button off-screen. The dialog now shows a short summary with the full per-file list in a collapsible/scrollable "Show Details" section (``QMessageBox.setDetailedText()``) instead.

Added
^^^^^

- **Keyboard shortcuts F9 / F10** for "Apply EXIF orientation" and "Force EXIF orientation to 0°", previously accessible only via menu/toolbar. Follows the existing F6/F7/F8 rotation shortcut sequence.
- **Missing SVG icons** (``auto-rotate``, ``object-rotate-left``, ``object-rotate-right``, ``object-flip-vertical``, ``reset-exif``, ``folder-new``, ``folder-open``) — buttons and actions with no SVG fallback file displayed no icon on systems without an icon theme (e.g. Linux bundle).

Changed
^^^^^^^

- **Thumbnail loading in the file list is now viewport-lazy** — previously, opening or refreshing a directory queued thumbnail generation for every file up front, in a single background thread, one at a time. On directories with thousands of files this could take many minutes, and files near the end of the list would sit without a thumbnail the whole time. ``_start_worker()`` now only loads thumbnails for rows currently visible (plus one screenful of margin), and re-triggers on scroll/resize (debounced) so thumbnails pop in on demand as the list is scrolled. Directory load/refresh time is no longer proportional to the total file count. Dragging the scrollbar handle across a long list skips loading until the handle is released, instead of loading a batch at every intermediate position passed through during the drag (which could add up to nearly as many decodes as loading everything).
- **Thumbnails for a freshly-scrolled-to batch of rows now load in parallel** (up to 4 concurrent ``_ThumbnailWorker`` threads, capped by CPU count) instead of one thread decoding the whole visible batch sequentially — cuts the delay before icons appear after landing on a new scroll position.
- **"Reset EXIF orientation" renamed to "Force EXIF orientation to 0°"** — the previous wording didn't make clear what the action actually does (menu/toolbar/shortcuts window/status tip).
- **File list column header** — now shows the number of selected files alongside the total (``File name (sel/n)``) whenever 2 or more files are selected, instead of only the total (``File name (n)``). A single selected file still shows just the total, since the count is redundant there.
- **``_linux.py`` — ``open_default``** now uses ``subprocess.Popen(["xdg-open", …])`` instead of ``QDesktopServices.openUrl()``, which bypassed the user's MIME association and always opened ``xed`` instead of the actual default application.
- **SVG icons** — all files replaced with high-resolution (1024×1024) versions with a consistent blue rounded-square background; ``pbpicat.svg`` simplified (534 KB → 24 KB).
- **SVG file names** normalised: hyphens only (no underscores), semantic names (``history``, ``duplicate``, ``rename-template``, ``reset-exif``, ``auto-rotate``, ``open-with``, ``zoom-fit``, ``zoom-in``, ``zoom-out``, ``zoom-original``, ``zoom-width``, ``zoom-height``).
- **``file_list_widget.py``** — direct ``QDesktopServices.openUrl()`` calls for sidecars and videos now go through ``open_default()``.

Removed
^^^^^^^

- Obsolete SVG files: ``document-open-recent.svg``, ``edit-copy.svg``, ``template.svg``, ``open_with.svg``, ``zoom_fit.svg``, ``zoom_in.svg``, ``zoom_out.svg``, ``zoom_original.svg``, ``zoom_width.svg``, ``zoom_height.svg``.


1.11.0 (2026-06-24)
-------------------

Added
^^^^^

- **``hooks/pyi_rth_fonts.py``** — PyInstaller runtime hook for portable
  fontconfig on Linux.  At frozen-app startup (before Qt initialises) it writes
  a minimal ``fonts.conf`` into ``sys._MEIPASS`` pointing to the bundled ``fonts/``
  directory and the system ``/etc/fonts/fonts.conf``, sets ``FONTCONFIG_FILE``, then
  calls ``FcFini()``/``FcInit()`` via ctypes to force fontconfig to re-read the
  variable before ``QFontDatabase`` is populated.  The hook is no-op on non-Linux
  platforms and in non-frozen runs.
- **Conda fonts bundled in ``pbpicat.spec``** — the ``$CONDA_PREFIX/fonts/``
  directory is included as ``fonts/`` in the frozen bundle when it exists; the
  runtime hook above uses this directory.  ``hooks/pyi_rth_fonts.py`` is
  registered as a runtime hook in the spec.
- **``use_trash`` setting** (default ``true``) — new *Behaviour* tab in *Settings →
  Catalog configuration…* with a *Move deleted files to trash* checkbox; when
  enabled, deletions are routed through ``QFile.moveToTrash()`` instead of
  ``Path.unlink()``.
- **``_delete_rows_and_select(next_row)``** in ``FileListWidget`` — removes only the
  rows corresponding to deleted files from the table without restarting the
  thumbnail worker for remaining rows; replaces the previous full-refresh call
  after deletion.
- **``fonts-conda-ecosystem``** added to ``environment.yml`` (Ubuntu, DejaVu,
  Inconsolata, SourceCodePro); these fonts are already bundled into the frozen
  binary via ``pbpicat.spec`` but were missing from the environment declaration,
  so a fresh ``conda env create`` would produce a bundle with no fonts.
- **``_load_bundled_fonts(app)``** in ``__main__.py``: registers all bundled ``.ttf``
  files into ``QFontDatabase`` and explicitly sets **Ubuntu** as the application
  font.  The ``libfontconfig.so`` bundled by PyInstaller has its default config
  path hardcoded to the build machine's conda prefix; on any other machine that
  path is absent and fontconfig fails silently, leaving Qt with no valid system
  font and an unpredictable default.  Forcing Ubuntu bypasses fontconfig for
  font selection while the runtime hook (``pyi_rth_fonts.py``) still provides a
  portable ``fonts.conf`` so rendering settings (anti-aliasing, hinting…) are
  inherited from the system ``/etc/fonts/fonts.conf``.
- **``--dev-config-dir DIR`` CLI flag** — overrides the XDG configuration directory at launch, enabling isolated test runs without touching the real config.
- **``set_base_dir()``** in ``config.py`` — public function to redirect ``_BASE_DIR``, ``_CATALOG_CONF``, and ``_GLOBAL_CONFIG_PATH`` before ``init_catalogs()`` is called.
- **``make run ARGS="..."``** — the ``run`` Makefile target now forwards ``$(ARGS)`` to the Python invocation so extra flags can be passed from the command line.
- **``argparse_qt.py``** — new module exposing ``add_qt_arguments(parser)``: adds all Qt command-line flags as ``--double-dash`` argparse options grouped under *Qt options*; each option appends its single-dash equivalent to ``args.qt_args`` for direct forwarding to ``QApplication``. Qt options are hidden from the ``usage:`` line to reduce noise while remaining fully visible in the ``--help`` output.
- **Ctrl+right-click zoom out** in the image viewer — symmetric with Ctrl+left-click zoom in; both center the zoom on the clicked pixel.
- **Mouse shortcuts section** in the shortcuts window — viewer mouse shortcuts (pan, center on point, zoom in/out centered on point) listed under a *Mouse* subsection alongside the existing *Keyboard* subsection.
- **``app_qsettings()``** in ``config.py`` — application-level ``QSettings`` stored in ``~/.config/pbpicat/app.conf``, independent of the active catalog.
- **Persistent window geometry** — position and size of all windows (main window, image viewer, shortcuts, settings, global settings, field histories) are saved and restored between sessions; stored at application level so they survive catalog changes. The *About* dialog is excluded.
- **Qt built-in translations** — standard dialog button labels (*OK*, *Cancel*, *Close*, *Yes*, *No*, …) are now displayed in the active UI language by loading the appropriate ``qtbase_<lang>.qm`` file at startup.

Changed
^^^^^^^

- **Any catalog can now be deleted** — the hard-coded protection of the ``"default"`` catalog is removed; the UI prevents deleting the *last* remaining catalog instead (message: *"The last catalog cannot be deleted."*). When the active catalog is deleted the app switches to the next available catalog instead of always falling back to ``"default"``.
- **``load_current_catalog_name()``** — falls back to the first available catalog (instead of ``"default"``) when ``catalog.conf`` is absent or invalid.
- **``init_catalogs()``** — no longer creates the ``default`` directory unconditionally; it only creates it when no catalog exists yet.
- **``fix_po_files.py``** — now also strips pybabel location comments (``#: file.py:N``) to eliminate spurious line-number churn in ``.po`` diffs.
- **Shortcuts window renamed** — formerly *Keyboard shortcuts*, now *Shortcuts*; made non-modal so it can stay open while working.
- **Key names localised** — *Del* and *Esc* now display as *Suppr* and *Échap* on French keyboards via ``QKeySequence.toString(NativeText)``; mouse button names (*left-click*, *right-click*) are translated into each UI language.
- **Deletion confirmation dialog** — wording now adapts to the ``use_trash`` setting: *"Move to trash: …"* / *"Move N files to trash?"* when trash is enabled; existing *"Permanently delete"* wording otherwise.
- **Empty parent directory cleanup skipped in trash mode** — when ``use_trash`` is enabled the post-deletion directory sweep is omitted; the OS trash mechanism handles the directory state.


1.10.1 (2026-06-14)
-------------------

Fixed
^^^^^

- **About dialog shows wrong version in bundle** — ``copy_metadata("pbpicat")`` is now included in ``pbpicat.spec`` so that ``importlib.metadata.version()`` resolves correctly at runtime inside a PyInstaller bundle. ``make dist`` now runs ``pip install -e .`` beforehand to ensure package metadata matches ``pyproject.toml``.

Changed
^^^^^^^

- **``bump_version.py``** — removed the stale regex entry for ``src/pbpicat/__main__.py`` (no longer contains a hardcoded version string).


1.10.0 (2026-06-14)
-------------------

Added
^^^^^

- **Reset EXIF orientation** — new *Images* menu entry and ImageViewer toolbar button (*Reset EXIF orientation*) that sets the EXIF Orientation tag to 1 (normal) without rotating pixels. Disabled when the selected image has no orientation tag. Undoable (``("reset_exif", [(path, orig_orient)])``); status bar shows the count of affected files; undo restores the original tag value.
- **``exif_auto_rotate`` setting** (default ``true``) — new boolean config key; when false, thumbnails and the ImageViewer display images without applying the EXIF Orientation tag. Exposed in *Settings → Catalog configuration… → Images* as the "Apply EXIF rotation" checkbox. Changing the setting live reloads the current image in an open viewer via ``set_auto_rotate()``.
- **F6 / F7 / F8 keyboard shortcuts** for rotation — *Rotate 90° CCW* (F6), *Rotate 180°* (F7), *Rotate 90° CW* (F8) in the main window; entries added to the keyboard shortcuts dialog.
- **X and Z as aliases in ImageViewer** — X = Fit window (alias for 0), Z = Actual size / 1:1 (alias for 1); toolbar tooltips updated to show both keys.
- **Ctrl+click in ImageViewer** — zooms to the clicked point in CUSTOM mode (previously this was done via double-click).
- **``_sanitize_exif_for_dump()``** in ``image_ops.py`` — converts Undefined-typed EXIF tags stored as plain integers (seen with some camera firmware) to bytes before calling ``piexif.dump()``.

Changed
^^^^^^^

- **``load_qimage`` / ``load_pixmap``** — added ``auto_rotate`` parameter (default ``True``); the Pillow path now calls ``ImageOps.exif_transpose()`` when ``auto_rotate=True``; the ``QImageReader`` path uses ``setAutoTransform(auto_rotate)``.
- **``set_exif_orientation()``** — reads raw EXIF bytes via Pillow (``img.info["exif"]``) before calling ``piexif.load()`` to avoid failures on certain JPEG files; is a no-op when the file has no EXIF block; calls ``_sanitize_exif_for_dump()`` before ``piexif.dump()``.
- **Double-click in ImageViewer** — now centers the viewport on the clicked point instead of zooming to it.
- **ImageViewer scroll centering** — on mode switch (Fit / 1:1 / Width / Height) and on image load the viewport is now centered; proportional scroll preservation is restricted to CUSTOM zoom mode.
- **``tools/fix_po_dates.py`` → ``tools/fix_po_files.py``** — file renamed; ``make translate`` updated accordingly.
- **``ruff-pre-commit``** — updated from ``v0.15.15`` to ``v0.15.17`` in ``.pre-commit-config.yaml``; frozen commit hash replaced with version tag.

Fixed
^^^^^

- **Zoom step additive instead of multiplicative** — zoom in/out now adds/subtracts the configured step in percentage points (e.g. 23% → 48% → 73% with a 25% step) instead of multiplying by a factor (which gave 23% → 29% → 36%).
- **``set_exif_orientation()`` crash on non-standard EXIF** — ``piexif.dump()`` raised a type error when camera firmware had stored Undefined-typed values as integers instead of bytes; fixed by sanitizing with ``_sanitize_exif_for_dump()`` before dumping.


1.9.0 (2026-06-13)
------------------

Added
^^^^^

- **Lossless rotation** — new *Images* menu entries *Rotate 90° CCW*, *Rotate 90° CW*, *Rotate 180°*, and *Apply EXIF orientation*; same buttons in the ImageViewer toolbar between zoom controls and action buttons.
  - JPEG: uses ``jpegtran`` (bundled in the PyInstaller executable); raises a ``RuntimeError`` shown as a warning dialog if unavailable.
  - Other formats (PNG, TIFF, BMP, WebP): uses Pillow — always lossless.
  - After JPEG rotation the EXIF Orientation tag is stripped via ``piexif``.
  - *Apply EXIF orientation* is disabled when the selected image has no EXIF orientation tag; enabled/disabled state is kept in sync with the selection.
- **Rotation undo** — rotation operations are pushed to ``_undo_stack`` as ``("rotation", [(path, undo_op, orig_orient)])`` and undone by the existing Undo button; the button label changes to *Undo rotation (N)*.
- **``image_ops.py``** — new module: ``is_jpeg``, ``get_exif_orientation``, ``set_exif_orientation``, ``_strip_jpeg_orientation``, ``_find_jpegtran``, ``_jpeg_apply``, ``_pil_apply``, ``_pil_save_lossless``, ``rotate_lossless``.
- **``piexif`` dependency** — added to ``pyproject.toml``, ``environment.yml``, and as a PyInstaller hidden import.
- **``jpegtran`` in PyInstaller bundle** — ``pbpicat.spec`` now locates ``jpegtran`` via ``shutil.which`` at build time and includes it as a binary; ``_find_jpegtran`` checks ``sys._MEIPASS`` first.
- **``tools/fix_po_dates.py``** — normalises ``POT-Creation-Date`` and ``PO-Revision-Date`` headers to eliminate spurious diffs between locales.
- **``tools/po_check.py``** — inspects ``.po`` files (statistics, untranslated entries, pattern search) without grepping or calling msgfmt (both break on multi-line entries).
- **i18n strings** — translated rotation action labels and status messages in all eight locales (de, en, es, fr, it, ru, vi, zh_CN).

Changed
^^^^^^^

- **``make translate``** — now passes ``--no-location`` to ``pybabel extract`` (removes file/line references from ``.pot``) and runs ``tools/fix_po_dates.py`` after ``pybabel update`` to keep date headers stable.
- **ImageViewer toolbar** — rotation buttons (↺ ↻ ↕ EXIF) inserted between zoom controls and action buttons; *Apply EXIF orientation* button disabled when loaded image has no orientation tag.
- **SPEC.md** — updated to document lossless rotation actions, their enabled/disabled rules, and the revised ImageViewer toolbar layout.
- **README.md** — updated to document lossless rotation, Open/Open with actions, keyboard navigation, Renumber from 1, ImageViewer keyboard shortcuts, and the Settings menu restructuring (Catalog configuration vs. Program settings).

Fixed
^^^^^

- **Row selection on click after scroll** — clicking the Nth visible row (after scrolling) previously selected the Nth row from the top of the list instead of the actual clicked row. Root cause: ``focusInEvent`` called ``selectRow(0)`` before the click was processed, scrolling the viewport and shifting row coordinates. Fixed by skipping auto-select when ``event.reason() == MouseFocusReason``.


1.8.0 (2026-06-08)
------------------

Added
^^^^^

- **About dialog enriched** — now shows Python version, PySide6 version, platform string, and author(s) as clickable ``mailto:`` links read from package metadata.
- **Menu icons** — all menu-bar actions (File, Catalog, Images, Settings, Help) now display icons; new SVG assets created for *Quit*, *Duplicate*, *Refresh*, *Catalog configuration*, *History*, *Program settings*, *Keyboard shortcuts*, and *About*.
- **Context menu icons** — the file-list context menu reuses the same ``QAction`` objects as the *Images* menu, ensuring identical icons, labels, shortcuts and enabled/disabled state at all times.
- **``ui/icons.py``** — shared ``get_icon(svg_name, theme_name, text_fallback)`` helper that resolves icons via FreeDesktop theme → bundled SVG → text fallback; consolidates previously duplicated logic from ``image_viewer.py``.
- **Keyboard shortcuts dialog** — added missing entries: Ctrl+Z (Undo rename), Ctrl+O (Open), Ctrl+Shift+O (Open with), Ctrl+N (New catalog), Ctrl+Shift+D (Duplicate catalog); Del and Escape now rendered via ``QKeySequence.toString(NativeText)`` for correct localisation.
- **Undo rename shortcut** — Ctrl+Z activates the *Undo rename* button.

Changed
^^^^^^^

- **Version read from package metadata** — ``importlib.metadata`` replaces the hardcoded version string in ``__main__.py``; the About dialog always shows the installed version.
- **Context menu selects clicked row** — right-clicking an unselected row now selects it before the menu appears, so actions operate on the expected file.

Fixed
^^^^^

- **PyInstaller bundle crash on startup** — ``email`` was listed in ``excludes`` but is required by ``importlib.metadata`` at import time and by ``email.utils`` in the About dialog; removed from excludes.
- **Menu icons missing in PyInstaller bundle** — ``_RESOURCE_DIR`` in ``ui/icons.py`` was computed from ``__file__``, which points inside the package directory in the bundle; now uses ``sys._MEIPASS`` when available, matching the actual extraction path of bundled SVG assets.


1.7.0 (2026-06-08)
------------------

Added
^^^^^

- **Images menu** — new *Images* menu (between *Catalog* and *Settings*) with *Open* (Ctrl+O), *Open with…* (Ctrl+Shift+O), *Template*, *Delete* (Del), and *Refresh* (F5) actions.
- **Open / Open with** — *Open* launches the selected file(s) with the system default application; *Open with…* prompts for a specific application. Both actions are available in the file-list context menu and the image-viewer toolbar.
- **Platform helpers** — new ``platform/`` package providing XDG/Linux (application picker dialog), macOS (``open -a``), and Windows (``ShellExecuteW``) implementations for *Open with*.
- **Image viewer toolbar extended** — *Open*, *Open with*, *Template*, and *Delete* buttons added after the zoom controls.
- **Confirm deletions setting** — new catalog setting (default: on) that requires confirmation before deleting files; a configurable threshold controls whether individual file names are listed.
- **Keyboard navigation** — Left/Right arrows in the file list transfer focus to the directory tree; Right arrow on a tree leaf transfers focus back to the file list.
- **Return/Enter opens file** — pressing Return or Enter in the file list opens the image viewer (images) or the default external application (other media).
- **Auto-select on focus** — when the file list gains focus with no active selection, the first row is automatically selected.
- **New keyboard shortcuts** — Ctrl+, opens catalog settings; Ctrl+Alt+, opens program settings; both are also shown in the keyboard-shortcuts dialog.
- **Status tips on all menu actions** — every menu entry now has a descriptive status-bar tip.
- **Duplicate catalog** (Ctrl+Shift+D) — copies the current catalog's settings and field history to a new catalog name.
- **Undo rename counter** — the *Undo rename* button shows ``N/total`` (renames pending / total done in the session), e.g. *Undo rename 3/17*.
- **Auto-select restored files after undo** — after undoing a rename or renumber, the files moved back to their original location are automatically selected in the file list.
- **Test suite** — 551 tests across 14 modules at 98 % overall coverage; all non-UI modules and most UI modules at 100 %.

Changed
^^^^^^^

- **"Refresh" moved to *Images* menu** — the *Refresh* action (F5) is the last entry of the *Images* menu; the now-empty *View* menu is removed.
- **Multi-selection in image viewer** — selecting more than one file while the viewer is open shows an informational message instead of closing the viewer.
- ***Catalog configuration…* renamed** — the menu entry was previously labelled *Configuration…* under *Settings*.
- **``config_dir()`` moved to ``platform/``** — each platform module now exposes ``config_dir()`` returning the OS-native configuration directory (``$XDG_CONFIG_HOME/pbpicat`` on Linux, ``~/Library/Application Support/pbpicat`` on macOS, ``%APPDATA%\pbpicat`` on Windows). ``config.py`` no longer contains XDG-specific or OS-specific code.

Fixed
^^^^^

- **Multi-selection lost after undo** — ``refresh_and_select_paths`` cancels the filesystem-watcher debounce before refreshing, and ``_refresh_preserve_selection`` now restores all previously selected rows instead of only the first.
- **Image viewer auto-updated on directory change** — the viewer no longer changes image when the file list loads a new directory or gains focus (auto-select row 0); it updates only on explicit user selection.


1.6.3 (2026-06-01)
------------------

Changed
^^^^^^^

- **Build toolchain migrated to pybabel** — ``xgettext``, ``msgmerge``, ``msgfmt``, and ``msginit`` replaced by ``pybabel extract``, ``update``, ``compile``, and ``init``. Removes the system ``gettext`` dependency; ``babel`` is now the sole i18n build tool.
- **Dist artifact names lowercased** — executables are now named ``pbpicat-<version>-<os>-<arch>`` (was ``PBPicat-…``).

Removed
^^^^^^^

- Compiled ``.mo`` files are no longer tracked in git; they are generated at build time.


1.6.2 (2026-06-01)
------------------

Added
^^^^^

- **markdownlint-cli2 pre-commit hook** — Markdown files are now linted automatically on commit.

Fixed
^^^^^

- **CI release asset names** — the build workflow now passes ``PBPICAT_VERSION`` to PyInstaller via ``github.ref_name``, so release assets are correctly named ``PBPicat-<version>-…`` instead of ``PBPicat-dev-…``.

Changed
^^^^^^^

- Updated ``SPEC.md`` with v1.6.1 specifications.


1.6.1 (2026-06-01)
------------------

Added
^^^^^

- **Keyboard shortcuts for main window menus** — ``Ctrl+Q`` (Quit), ``Ctrl+N`` (New catalog), ``F5`` (Refresh), ``F1`` (Keyboard shortcuts dialog).
- **Version in About dialog** — the application version number is now displayed in *Help → About*.
- **Image viewer toolbar and shortcuts aligned with PBPrompt** — toolbar order: Fit | 1:1 | Width | Height | + | −; bare-key shortcuts: ``0`` = Fit, ``1`` = 1:1, ``W`` = Width, ``H`` = Height, ``+``/``−`` = Zoom in/out.
- **SVG icons for image viewer** — zoom toolbar buttons now use the same SVG icons as PBPrompt (FreeDesktop theme → bundled SVG → text fallback).

Changed
^^^^^^^

- ``tools/git_version.sh`` now uses ``git status --porcelain`` to detect a dirty working tree (catches untracked files in addition to modified tracked files).


1.6.0 (2026-06-01)
------------------

Added
^^^^^

- **Delete key shortcut** — pressing ``Del`` in the file list deletes the selected file(s) and their sidecars; the shortcut is shown in the context menu alongside the *Delete* action.
- **Delete from image viewer** — pressing ``Del`` while the image viewer is open deletes the currently displayed image and its sidecars; the confirmation dialog is parented to the viewer so it stays in the foreground.
- **Keyboard shortcuts help** — new *Help → Keyboard shortcuts…* menu entry opens an HTML dialog listing all shortcuts for both the main window and the image viewer.
- **Auto-select next file after deletion** — after deleting file(s), the file immediately following the last deleted entry is automatically selected (or the last file if the deleted entry was the last one).

Fixed
^^^^^

- After deleting a file, the ``QFileSystemWatcher``-triggered auto-refresh (400 ms debounce) was clearing the selection; the debounced refresh now preserves the current selection by path.


1.5.0 (2026-05-29)
------------------

Added
^^^^^

- **Delete empty sidecar files on load** — new option *Delete empty sidecar files when loading a directory* in *Configuration → Sidecar Extensions* (checked by default); zero-byte sidecar files, including orphans, are automatically deleted when entering a directory.
- **Close image viewer with Escape** — pressing Escape when the image viewer window has focus closes it.

Fixed
^^^^^

- A sidecar created by double-clicking the sidecar column was immediately deleted by the empty-file cleanup triggered on refresh; newly created sidecars are now protected until the editor writes content.


1.4.0 (2026-05-23)
------------------

Added
^^^^^

- **Directory tree context menu** — right-clicking a folder in the directory tree now shows a context menu with an *Open* action that opens the folder in the system file manager.
- **Auto-refresh on disk changes** — the file list now watches the current directory with ``QFileSystemWatcher`` and refreshes automatically (400 ms debounce) when files are added, removed, or renamed on disk.

Fixed
^^^^^

- Directory tree scroll-to was unreliable when the widget was not yet visible at selection time; scrolling is now deferred through ``showEvent`` and re-triggered whenever an ancestor directory finishes loading, keeping the selected folder centred in view.


1.3.0 (2026-05-17)
------------------

Added
^^^^^

- **Global program settings** — new *Settings → Program settings…* dialog (separated from per-catalog configuration by a menu separator) for settings that apply to the whole program rather than a single catalog.
- **Default sidecar extensions (global)** — the global settings dialog lets you define the list of sidecar extensions that new catalogs receive on creation; supports multi-dot extensions (e.g. ``.prompt.txt``); includes a *Restore built-in defaults* button.
- **Language selection moved to global settings** — the interface language is now a program-level preference (stored in ``global_settings.json``, independent of any catalog); requires a restart.
- **New catalog initialisation** — a newly created catalog inherits the global default sidecar extensions instead of the hard-coded built-in list.
- **Restore missing defaults — Video** — new button in *Configuration → Video* tab to non-destructively add any missing built-in video extensions.
- **Restore missing defaults — Sidecar** — new button in *Configuration → Sidecar extensions* tab to non-destructively add any missing global-default sidecar extensions.
- **Pillow / pillow-heif image support** — Pillow and pillow-heif are now runtime dependencies; formats that Qt cannot decode natively (HEIC, HEIF, AVIF, JPEG 2000, PCX, …) are loaded via a Pillow fallback in both the thumbnail worker and the image viewer.
- **Expanded default image extension list** — ``DEFAULT_IMAGE_EXTENSIONS`` now covers 46 formats including modern (HEIC, AVIF, JXL), RAW (Canon, Nikon, Sony, Fujifilm, …), HDR, JPEG 2000, and legacy raster formats.
- **Multi-language UI** — translation files for German, Spanish, Italian, Russian, Vietnamese, and Simplified Chinese added alongside the existing English and French.
- **``tools/bump_version.py``** — script to increment or force the project version (``major``, ``minor``, ``patch``, ``set x.y.z``); updates ``pyproject.toml``, ``__main__.py``, and the EN/FR PO headers in one step. Exposed via ``make bump-major / bump-minor / bump-patch / bump-set``.

Changed
^^^^^^^

- **Settings menu layout** — *Program settings…* moved to the bottom of the *Settings* menu, separated by a divider to distinguish program-level settings from catalog-level ones (*Configuration…* and *History…*).
- **Translation headers** — PO file headers corrected: project name changed from ``PBCategory`` to ``PBPicat``, version aligned with the project version.
- **Translation review markers** — all existing translated strings in non-English locales (DE, ES, FR, IT, RU, VI, ZH_CN) are now tagged ``==AUTO==`` to indicate they are pending human review.


1.2.0 (2026-05-15)
------------------

Added
^^^^^

- **Create sidecar on double-click** — double-clicking the sidecar column of a file with no sidecar creates an empty file with the configurable default extension and opens it in the system editor.
- **Default sidecar creation extension** — new ``sidecar_new_extension`` setting (default ``.xmp``), configurable in *Preferences → Sidecar Extensions* via a combo box populated from the active extension list.
- **Renumber from 1** — new button next to *Rename all*; renames all displayed files in-place starting from 1 according to the current schema's numeric field. Images and videos have separate counters. Supports undo via the existing *Undo last rename* button. No-ops (already correctly numbered) are detected and reported without prompting.
- **Multi-file delete** — right-clicking a selected file now deletes all selected files and their sidecars in a single confirmed operation.
- **Recursive empty directory cleanup** — after deletion, parent directories that become empty are removed recursively, matching the behaviour of rename.

Fixed
^^^^^

- Sidecar column displayed only the last extension component for multi-dot extensions (e.g. ``.txt`` instead of ``.prompt.txt``).
- Undo of renumber failed with a "files already exist" error due to circular name conflicts; undo now uses the same two-phase rename as execution.


1.1.0 (2026-05-13)
------------------

Fixed
^^^^^

- Application icon (``pbpicat.svg``) not found when running from a PyInstaller bundle; resource path now resolves via ``sys._MEIPASS`` in frozen mode.

Removed
^^^^^^^

- PNG icon generation script (``scripts/make_png.py``) and associated ``make png`` target; the SVG is used directly.


1.0.0 (2026-05-03)
------------------

Initial release.

Features
^^^^^^^^

- **Rename schema** — N configurable text fields (6 by default) that build both the destination directory tree and the filename prefix. One optional numeric counter field (``###``) auto-increments from the existing maximum, with separate counters for images and videos.
- **Sidecar support** — sidecar files (``.xmp``, ``.dop``, ``.pp3``, …) are renamed alongside their parent file automatically. Extensions are configurable and support multiple dots.
- **Video marker** — optional text marker inserted at a configurable position in the filename to distinguish video files from images.
- **File panel** — directory tree on the left, file list on the right with async thumbnails, sidecar indicators, and hover preview of the resulting filename.
- **Sidecar content filter** — filter the file list by a Python regex matched against sidecar file contents; only files with at least one matching sidecar are shown.
- **Context menu** — right-click a file to infer schema fields from its name (*Template*) or permanently delete it and its sidecars (*Delete*).
- **Multi-level undo** — click *Undo last rename* repeatedly to reverse successive rename operations one by one.
- **Catalog system** — named configuration profiles, each with independent settings, field histories, and window state. The ``default`` catalog always exists and cannot be deleted.
- **Image viewer** — double-click a thumbnail to open a zoomable viewer; it stays open and follows selection after rename or delete.
- **Internationalisation** — English and French interface; language selectable in Preferences (restart required).
- **Standalone executables** — pre-built binaries for Linux, macOS, and Windows via PyInstaller; no Python installation required.