verdiclip 0.2.0__tar.gz

verdiclip-0.2.0/ATTRIBUTION.md

@@ -0,0 +1,37 @@
+# Attribution
+
+## Inspiration
+
+**VerdiClip** is an independent, clean-room screenshot and annotation tool for
+Windows. It was created as an original work inspired by the publicly observable
+features and user experience of [Greenshot](https://getgreenshot.org/), a free
+and open-source screenshot tool.
+
+VerdiClip is a distinct product with its own name and branding; it is not
+affiliated with, endorsed by, or named after Greenshot.
+
+## Legal Notice
+
+- **No code, assets, icons, or other copyrighted materials from Greenshot have
+  been used in VerdiClip.** This is a clean-room implementation built from
+  scratch using different technologies (Python, Qt) than Greenshot (.NET, C#).
+
+- **VerdiClip does not use the Greenshot name or logo in its branding.** The
+  Greenshot trademark and logo are the property of the Greenshot development
+  team.
+
+- **VerdiClip is licensed under the MIT License**, which is legally appropriate
+  for an independent implementation that does not derive from GPL-licensed
+  source code.
+
+## Greenshot
+
+Greenshot is licensed under the
+[GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html).
+For more information about Greenshot, visit:
+
+- Website: <https://getgreenshot.org/>
+- Repository: <https://github.com/greenshot/greenshot>
+
+We are grateful to the Greenshot team for creating an excellent tool that has
+set the standard for screenshot software on Windows.

verdiclip-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mike Hill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

verdiclip-0.2.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: verdiclip
+Version: 0.2.0
+Summary: Fast, faithful screenshot capture and annotation for Windows.
+Keywords: screenshot,annotation,screen-capture,windows
+Author: Mike Hill
+Author-email: Mike Hill <mike@mikejhill.com>
+License-Expression: MIT
+License-File: ATTRIBUTION.md
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics :: Editors
+Classifier: Topic :: Multimedia :: Graphics :: Capture :: Screen Capture
+Requires-Dist: mss>=10.2.0
+Requires-Dist: pyside6-essentials>=6.11.2
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/mikejhill/verdiclip
+Project-URL: Documentation, https://github.com/mikejhill/verdiclip#readme
+Project-URL: Changelog, https://github.com/mikejhill/verdiclip/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/mikejhill/verdiclip/issues
+Description-Content-Type: text/markdown
+
+# VerdiClip
+
+[![CI](https://github.com/mikejhill/verdiclip/actions/workflows/ci.yml/badge.svg)](https://github.com/mikejhill/verdiclip/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/verdiclip.svg)](https://pypi.org/project/verdiclip/)
+[![Python](https://img.shields.io/pypi/pyversions/verdiclip.svg)](https://pypi.org/project/verdiclip/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Fast, faithful screenshots for Windows: grab a precise piece of the screen, mark it up, and put it where it needs to go — in seconds.
+
+![VerdiClip editor in the light theme, showing numbered steps, a labeled callout, an arrow, a highlight, and an obfuscated password](docs/images/editor-light.png)
+
+VerdiClip is an independent, clean-room project. See [ATTRIBUTION.md](ATTRIBUTION.md) for credits.
+
+## Install
+
+Requires Windows 10 or later and Python 3.13+.
+
+```bash
+uv tool install verdiclip
+```
+
+Or with pip: `pip install verdiclip`. Then run `verdiclip` (or `verdiclip-gui` for no console window) and VerdiClip sits in the system tray.
+
+## Capture
+
+| Do this | Press |
+| --- | --- |
+| Drag a region, or click a window | `PrtSc` (or left-click the tray icon) |
+| Capture the active window | `Alt+PrtSc` |
+| Capture every monitor | `Ctrl+PrtSc` |
+| Repeat the last capture | `Shift+PrtSc` |
+
+![The capture overlay: the frozen screen is dimmed, the window under the cursor is outlined with its title, and a magnifier shows the exact pixels](docs/images/capture.png)
+
+While selecting, the screen is frozen so you get exactly what you saw. A magnifier follows the cursor, arrow keys nudge it by a pixel (`Ctrl` for 10), clicking without dragging captures the window under the cursor, and `Esc` cancels.
+
+If Windows or another screenshot tool already owns `PrtSc`, VerdiClip tells you which hotkeys are taken; everything is still available from the tray menu, and you can choose other keys in Settings.
+
+## Annotate
+
+| Tools | | Actions | |
+| --- | --- | --- | --- |
+| `V` Select | `T` Text | `Ctrl+Shift+C` Copy image | `Ctrl+Z` / `Ctrl+Y` Undo / redo |
+| `C` Crop | `N` Counter | `Ctrl+S` Save (auto-named) | `Ctrl+C` / `Ctrl+V` Copy / paste marks |
+| `R` Rectangle | `H` Highlight | `Ctrl+Shift+S` Save as | `Delete` Remove selection |
+| `E` Ellipse | `O` Obfuscate | `Ctrl+P` Print | Arrows Nudge (`Ctrl` = 10 px) |
+| `L` Line | `F` Freehand | `Ctrl+wheel` Zoom | `Space`+drag Pan |
+| `A` Arrow | | `Ctrl+0` / `Ctrl+Shift+F` 100% / fit | `Esc` Back out one step |
+
+- **Labels in boxes.** After drawing a rectangle or ellipse, just type — the text is centered and wraps inside it. Double-click (or `Enter`/`F2`) to edit later; `Esc` skips.
+- **Shift** draws squares, circles, and 45° lines.
+- **Your styles stick.** Colors, fills, widths, and fonts you pick are remembered per tool for the next screenshot.
+- **Everything is undoable**, including crop, which never throws pixels away.
+- **The quickest path**: draw, `Esc` until nothing is selected, `Enter` — the image is on the clipboard and the editor closes. Nothing you haven't copied, saved, or printed is ever discarded without asking.
+
+![The editor in the dark theme](docs/images/editor-dark.png)
+
+## Settings
+
+Open from the tray menu or with `Ctrl+,` in any editor.
+
+![The Settings dialog: after-capture actions can be combined](docs/images/settings.png)
+
+- **After capturing** — any combination of: open in the editor, copy to the clipboard, save to the output folder.
+- **Hotkeys** — validated as you type; conflicts are reported.
+- **Output** — folder, file-name pattern (`{date}`, `{time}`, `{title}`, `{counter}`) with a live preview, format, JPEG quality.
+- **Editor** — default color, width, and font.
+- **General** — light, dark, or match-Windows theme; start at sign-in.
+
+## Command line
+
+```bash
+verdiclip capture screen -o shot.png
+verdiclip capture region --region 0,0,1280,720 --clipboard
+verdiclip capture window --delay 3
+verdiclip open picture.png          # Opens in the running instance if there is one
+```
+
+## How it is built
+
+Start with [docs/design/philosophy.md](docs/design/philosophy.md): the core purpose, the principles, and the architecture. [docs/design/ux-contract.md](docs/design/ux-contract.md) specifies every interaction; each item has an automated journey test.
+
+In short: an edit session is an immutable base image, a non-destructive crop, and a list of immutable annotation values. The only way to change it is a command through the undo history, and one renderer draws both the canvas and the exported image.
+
+## Development
+
+Requires Windows 10+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv sync                  # Create .venv and install dependencies
+uv run verdiclip         # Run the tray app
+uv run poe               # List tasks
+uv run poe fix           # Format and auto-fix lint
+uv run poe check         # Format check, lint, strict type check, tests with coverage
+uv run poe ux            # UX journey tests only
+uv run poe ux-snapshots  # Journeys plus a PNG per step in docs/ux/snapshots
+uv run poe ux-gallery    # Key screens in light and dark themes (docs/ux/gallery)
+```
+
+`uv run poe check` is the quality gate: ruff (broad rule set), ty with every rule at error, and pytest with ≥ 90% branch coverage. Regenerate the README screenshots with `uv run python scripts/ux_gallery.py --readme-dir docs/images`. Before a release, also run the manual checklist at the end of the UX contract. See [CONTRIBUTING.md](CONTRIBUTING.md) for commit conventions and releases.
+
+## License
+
+[MIT](LICENSE)

verdiclip-0.2.0/README.md

@@ -0,0 +1,104 @@
+# VerdiClip
+
+[![CI](https://github.com/mikejhill/verdiclip/actions/workflows/ci.yml/badge.svg)](https://github.com/mikejhill/verdiclip/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/verdiclip.svg)](https://pypi.org/project/verdiclip/)
+[![Python](https://img.shields.io/pypi/pyversions/verdiclip.svg)](https://pypi.org/project/verdiclip/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Fast, faithful screenshots for Windows: grab a precise piece of the screen, mark it up, and put it where it needs to go — in seconds.
+
+![VerdiClip editor in the light theme, showing numbered steps, a labeled callout, an arrow, a highlight, and an obfuscated password](docs/images/editor-light.png)
+
+VerdiClip is an independent, clean-room project. See [ATTRIBUTION.md](ATTRIBUTION.md) for credits.
+
+## Install
+
+Requires Windows 10 or later and Python 3.13+.
+
+```bash
+uv tool install verdiclip
+```
+
+Or with pip: `pip install verdiclip`. Then run `verdiclip` (or `verdiclip-gui` for no console window) and VerdiClip sits in the system tray.
+
+## Capture
+
+| Do this | Press |
+| --- | --- |
+| Drag a region, or click a window | `PrtSc` (or left-click the tray icon) |
+| Capture the active window | `Alt+PrtSc` |
+| Capture every monitor | `Ctrl+PrtSc` |
+| Repeat the last capture | `Shift+PrtSc` |
+
+![The capture overlay: the frozen screen is dimmed, the window under the cursor is outlined with its title, and a magnifier shows the exact pixels](docs/images/capture.png)
+
+While selecting, the screen is frozen so you get exactly what you saw. A magnifier follows the cursor, arrow keys nudge it by a pixel (`Ctrl` for 10), clicking without dragging captures the window under the cursor, and `Esc` cancels.
+
+If Windows or another screenshot tool already owns `PrtSc`, VerdiClip tells you which hotkeys are taken; everything is still available from the tray menu, and you can choose other keys in Settings.
+
+## Annotate
+
+| Tools | | Actions | |
+| --- | --- | --- | --- |
+| `V` Select | `T` Text | `Ctrl+Shift+C` Copy image | `Ctrl+Z` / `Ctrl+Y` Undo / redo |
+| `C` Crop | `N` Counter | `Ctrl+S` Save (auto-named) | `Ctrl+C` / `Ctrl+V` Copy / paste marks |
+| `R` Rectangle | `H` Highlight | `Ctrl+Shift+S` Save as | `Delete` Remove selection |
+| `E` Ellipse | `O` Obfuscate | `Ctrl+P` Print | Arrows Nudge (`Ctrl` = 10 px) |
+| `L` Line | `F` Freehand | `Ctrl+wheel` Zoom | `Space`+drag Pan |
+| `A` Arrow | | `Ctrl+0` / `Ctrl+Shift+F` 100% / fit | `Esc` Back out one step |
+
+- **Labels in boxes.** After drawing a rectangle or ellipse, just type — the text is centered and wraps inside it. Double-click (or `Enter`/`F2`) to edit later; `Esc` skips.
+- **Shift** draws squares, circles, and 45° lines.
+- **Your styles stick.** Colors, fills, widths, and fonts you pick are remembered per tool for the next screenshot.
+- **Everything is undoable**, including crop, which never throws pixels away.
+- **The quickest path**: draw, `Esc` until nothing is selected, `Enter` — the image is on the clipboard and the editor closes. Nothing you haven't copied, saved, or printed is ever discarded without asking.
+
+![The editor in the dark theme](docs/images/editor-dark.png)
+
+## Settings
+
+Open from the tray menu or with `Ctrl+,` in any editor.
+
+![The Settings dialog: after-capture actions can be combined](docs/images/settings.png)
+
+- **After capturing** — any combination of: open in the editor, copy to the clipboard, save to the output folder.
+- **Hotkeys** — validated as you type; conflicts are reported.
+- **Output** — folder, file-name pattern (`{date}`, `{time}`, `{title}`, `{counter}`) with a live preview, format, JPEG quality.
+- **Editor** — default color, width, and font.
+- **General** — light, dark, or match-Windows theme; start at sign-in.
+
+## Command line
+
+```bash
+verdiclip capture screen -o shot.png
+verdiclip capture region --region 0,0,1280,720 --clipboard
+verdiclip capture window --delay 3
+verdiclip open picture.png          # Opens in the running instance if there is one
+```
+
+## How it is built
+
+Start with [docs/design/philosophy.md](docs/design/philosophy.md): the core purpose, the principles, and the architecture. [docs/design/ux-contract.md](docs/design/ux-contract.md) specifies every interaction; each item has an automated journey test.
+
+In short: an edit session is an immutable base image, a non-destructive crop, and a list of immutable annotation values. The only way to change it is a command through the undo history, and one renderer draws both the canvas and the exported image.
+
+## Development
+
+Requires Windows 10+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv sync                  # Create .venv and install dependencies
+uv run verdiclip         # Run the tray app
+uv run poe               # List tasks
+uv run poe fix           # Format and auto-fix lint
+uv run poe check         # Format check, lint, strict type check, tests with coverage
+uv run poe ux            # UX journey tests only
+uv run poe ux-snapshots  # Journeys plus a PNG per step in docs/ux/snapshots
+uv run poe ux-gallery    # Key screens in light and dark themes (docs/ux/gallery)
+```
+
+`uv run poe check` is the quality gate: ruff (broad rule set), ty with every rule at error, and pytest with ≥ 90% branch coverage. Regenerate the README screenshots with `uv run python scripts/ux_gallery.py --readme-dir docs/images`. Before a release, also run the manual checklist at the end of the UX contract. See [CONTRIBUTING.md](CONTRIBUTING.md) for commit conventions and releases.
+
+## License
+
+[MIT](LICENSE)

verdiclip-0.2.0/pyproject.toml

@@ -0,0 +1,240 @@
+[project]
+name = "verdiclip"
+version = "0.2.0"
+description = "Fast, faithful screenshot capture and annotation for Windows."
+readme = "README.md"
+license = "MIT"
+license-files = [
+    "LICENSE",
+    "ATTRIBUTION.md",
+]
+requires-python = ">=3.13"
+keywords = [
+    "screenshot",
+    "annotation",
+    "screen-capture",
+    "windows",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Graphics :: Editors",
+    "Topic :: Multimedia :: Graphics :: Capture :: Screen Capture",
+]
+dependencies = [
+    "mss>=10.2.0",
+    "pyside6-essentials>=6.11.2",
+]
+
+[[project.authors]]
+name = "Mike Hill"
+email = "mike@mikejhill.com"
+
+[project.urls]
+Homepage = "https://github.com/mikejhill/verdiclip"
+Documentation = "https://github.com/mikejhill/verdiclip#readme"
+Changelog = "https://github.com/mikejhill/verdiclip/blob/main/CHANGELOG.md"
+Issues = "https://github.com/mikejhill/verdiclip/issues"
+
+[project.scripts]
+verdiclip = "verdiclip.__main__:Application.main"
+
+[project.gui-scripts]
+verdiclip-gui = "verdiclip.__main__:Application.main"
+
+[build-system]
+requires = ["uv_build>=0.11.1,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+target-version = "py313"
+line-length = 88
+src = [
+    "src",
+    "tests",
+]
+
+[tool.ruff.lint]
+select = [
+    "A",
+    "ANN",
+    "ARG",
+    "B",
+    "BLE",
+    "C4",
+    "C90",
+    "D",
+    "DTZ",
+    "E",
+    "ERA",
+    "F",
+    "FA",
+    "FBT",
+    "G",
+    "I",
+    "LOG",
+    "N",
+    "PERF",
+    "PGH",
+    "PIE",
+    "PL",
+    "PT",
+    "PTH",
+    "RET",
+    "RSE",
+    "RUF",
+    "S",
+    "SIM",
+    "T20",
+    "TID",
+    "TRY",
+    "UP",
+    "W",
+]
+ignore = [
+    "D107",
+    "TRY003",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",
+    "PLR2004",
+]
+
+[tool.ruff.lint.pep8-naming]
+extend-ignore-names = [
+    "paintEvent",
+    "mousePressEvent",
+    "mouseMoveEvent",
+    "mouseReleaseEvent",
+    "mouseDoubleClickEvent",
+    "keyPressEvent",
+    "keyReleaseEvent",
+    "wheelEvent",
+    "resizeEvent",
+    "closeEvent",
+    "showEvent",
+    "focusOutEvent",
+    "dragEnterEvent",
+    "dropEvent",
+    "nativeEventFilter",
+    "leaveEvent",
+    "enterEvent",
+    "sizeHint",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty.environment]
+python-platform = "win32"
+
+[tool.ty.rules]
+all = "error"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "-ra",
+    "--import-mode=importlib",
+]
+xfail_strict = true
+qt_api = "pyside6"
+markers = [
+    "ux: user journey test proving a UX contract item",
+    "ux_budget: journey test that enforces a latency budget",
+]
+
+[tool.coverage.run]
+source = ["verdiclip"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+skip_covered = true
+exclude_also = ["if __name__ == .__main__.:"]
+
+[tool.poe.tasks.format]
+cmd = "ruff format ."
+help = "Format code"
+
+[tool.poe.tasks.format-check]
+cmd = "ruff format --check ."
+help = "Check formatting"
+
+[tool.poe.tasks.lint]
+cmd = "ruff check ."
+help = "Lint code"
+
+[tool.poe.tasks.lint-fix]
+cmd = "ruff check . --fix"
+help = "Lint and auto-fix"
+
+[tool.poe.tasks.typecheck]
+cmd = "ty check"
+help = "Type check (strict)"
+
+[tool.poe.tasks.test]
+cmd = "pytest --cov"
+help = "Run tests with coverage"
+
+[tool.poe.tasks.ux]
+cmd = "pytest -m ux tests/ux"
+help = "Run UX journey tests only"
+
+[tool.poe.tasks.ux-gallery]
+cmd = "python scripts/ux_gallery.py"
+help = "Render key screens in light and dark themes into docs/ux/gallery for design review"
+
+[tool.poe.tasks.ux-snapshots]
+cmd = "pytest -m ux tests/ux --ux-snapshots=docs/ux/snapshots"
+help = "Run UX journeys and save a PNG per step for review"
+
+[tool.poe.tasks.lint-workflows]
+shell = "uvx --from actionlint-py actionlint && uvx zizmor --offline .github/workflows"
+help = "Lint GitHub Actions workflows (actionlint + zizmor)"
+
+[tool.poe.tasks.fix]
+sequence = [
+    "format",
+    "lint-fix",
+]
+help = "Auto-fix formatting and lint"
+
+[tool.poe.tasks.check]
+sequence = [
+    "format-check",
+    "lint",
+    "typecheck",
+    "test",
+]
+help = "Run every quality gate"
+
+[dependency-groups]
+dev = [
+    "poethepoet>=0.48.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "pytest-qt>=4.5.0",
+    "ruff>=0.16.10",
+    "ty>=0.0.85",
+]

verdiclip-0.2.0/pyproject.toml.orig

@@ -0,0 +1,133 @@
+[project]
+name = "verdiclip"
+version = "0.2.0"
+description = "Fast, faithful screenshot capture and annotation for Windows."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE", "ATTRIBUTION.md"]
+authors = [{ name = "Mike Hill", email = "mike@mikejhill.com" }]
+requires-python = ">=3.13"
+keywords = ["screenshot", "annotation", "screen-capture", "windows"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Graphics :: Editors",
+    "Topic :: Multimedia :: Graphics :: Capture :: Screen Capture",
+]
+dependencies = [
+    "mss>=10.2.0",
+    "pyside6-essentials>=6.11.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/mikejhill/verdiclip"
+Documentation = "https://github.com/mikejhill/verdiclip#readme"
+Changelog = "https://github.com/mikejhill/verdiclip/blob/main/CHANGELOG.md"
+Issues = "https://github.com/mikejhill/verdiclip/issues"
+
+[project.scripts]
+verdiclip = "verdiclip.__main__:Application.main"
+
+[project.gui-scripts]
+verdiclip-gui = "verdiclip.__main__:Application.main"
+
+[build-system]
+requires = ["uv_build>=0.11.1,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+target-version = "py313"
+line-length = 88
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "A", "ANN", "ARG", "B", "BLE", "C4", "C90", "D", "DTZ", "E", "ERA", "F",
+    "FA", "FBT", "G", "I", "LOG", "N", "PERF", "PGH", "PIE", "PL", "PT", "PTH",
+    "RET", "RSE", "RUF", "S", "SIM", "T20", "TID", "TRY", "UP", "W",
+]
+ignore = [
+    "D107",    # __init__ docstring: the class docstring covers it
+    "TRY003",  # long messages in raise: context-rich messages are required here
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101", "PLR2004"]
+
+[tool.ruff.lint.pep8-naming]
+# Qt virtual overrides must keep Qt's camelCase names.
+extend-ignore-names = [
+    "paintEvent", "mousePressEvent", "mouseMoveEvent", "mouseReleaseEvent",
+    "mouseDoubleClickEvent", "keyPressEvent", "keyReleaseEvent", "wheelEvent",
+    "resizeEvent", "closeEvent", "showEvent", "focusOutEvent", "dragEnterEvent",
+    "dropEvent", "nativeEventFilter", "leaveEvent", "enterEvent", "sizeHint",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.mccabe]
+max-complexity = 10
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ty.environment]
+# A Windows-only app: type-check against Windows APIs on any host
+python-platform = "win32"
+
+[tool.ty.rules]
+all = "error"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["--strict-markers", "--strict-config", "-ra", "--import-mode=importlib"]
+xfail_strict = true
+qt_api = "pyside6"
+markers = [
+    "ux: user journey test proving a UX contract item",
+    "ux_budget: journey test that enforces a latency budget",
+]
+
+[tool.coverage.run]
+source = ["verdiclip"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+skip_covered = true
+exclude_also = ["if __name__ == .__main__.:"]
+
+[tool.poe.tasks]
+format = { cmd = "ruff format .", help = "Format code" }
+format-check = { cmd = "ruff format --check .", help = "Check formatting" }
+lint = { cmd = "ruff check .", help = "Lint code" }
+lint-fix = { cmd = "ruff check . --fix", help = "Lint and auto-fix" }
+typecheck = { cmd = "ty check", help = "Type check (strict)" }
+test = { cmd = "pytest --cov", help = "Run tests with coverage" }
+ux = { cmd = "pytest -m ux tests/ux", help = "Run UX journey tests only" }
+ux-gallery = { cmd = "python scripts/ux_gallery.py", help = "Render key screens in light and dark themes into docs/ux/gallery for design review" }
+ux-snapshots = { cmd = "pytest -m ux tests/ux --ux-snapshots=docs/ux/snapshots", help = "Run UX journeys and save a PNG per step for review" }
+lint-workflows = { shell = "uvx --from actionlint-py actionlint && uvx zizmor --offline .github/workflows", help = "Lint GitHub Actions workflows (actionlint + zizmor)" }
+fix = { sequence = ["format", "lint-fix"], help = "Auto-fix formatting and lint" }
+check = { sequence = ["format-check", "lint", "typecheck", "test"], help = "Run every quality gate" }
+
+[dependency-groups]
+dev = [
+    "poethepoet>=0.48.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+    "pytest-qt>=4.5.0",
+    "ruff>=0.16.10",
+    "ty>=0.0.85",
+]