chemvas 0.1.0__tar.gz

chemvas-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 daehyupsohn
+
+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.

chemvas-0.1.0/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: chemvas
+Version: 0.1.0
+Summary: A PyQt-based chemical drawing canvas.
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10
+Requires-Dist: PyQt6>=6.7
+Provides-Extra: dev
+Requires-Dist: coverage[toml]>=7; extra == "dev"
+Requires-Dist: mypy>=1.19; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Provides-Extra: rdkit
+Requires-Dist: rdkit>=2024.9; extra == "rdkit"
+Dynamic: license-file
+
+<p align="center">
+  <img src="docs/images/banner.png" alt="Chemvas — 2D chemical structure drawing canvas" width="680">
+</p>
+
+<p align="center">
+  <a href="https://github.com/dhsohn/Chemvas/actions/workflows/ci.yml"><img src="https://github.com/dhsohn/Chemvas/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.12%2B-blue.svg" alt="Python 3.12+"></a>
+</p>
+
+<p align="center"><b>English</b> · <a href="README.ko.md">한국어</a></p>
+
+A lightweight, PyQt6-based 2D chemical structure drawing app for quickly sketching
+molecules and reaction schemes — and exporting publication-ready figures.
+
+![Chemvas — a Base/THF reaction scheme and several organocatalyst structures drawn on the canvas](docs/images/demo.png)
+
+Chemvas lets you combine molecular bonds/rings/labels, arrows, and bracket
+annotations on a single canvas. The default style follows the ACS 1996 conventions,
+and the goal is to draft figures for lab notebooks or papers fast. RDKit is an
+optional backend used for SMILES import, formula/weight calculation, and 2D→3D
+conversion — Chemvas runs without it.
+
+## Features
+
+- **Bonds** — single / double / triple, bold, wedge & hash; 30° angle snapping and
+  a consistent default bond length.
+- **Rings & templates** — benzene, cycloalkanes, chair/boat conformers placed by
+  live preview and click-to-insert.
+- **Arrows** — reaction, equilibrium, resonance, curved, and dashed arrows with
+  adjustable width and head scale.
+- **Brackets & annotations** — square / round / curly brackets, dagger (`†`) and
+  double dagger (`‡`) annotation objects.
+- **Atom labels** — elements, charges, radicals, and common alias labels
+  (`Me`, `Et`, `OH`, `Ph`, `OMe`, `Boc`, `CO2Me`, `t-Bu`, `i-Pr`).
+- **SMILES import** _(RDKit)_ — type a SMILES string, preview it under the cursor,
+  and click to place it on the canvas.
+- **Molecule Info window** _(RDKit)_ — 3D preview (drag to rotate, scroll to zoom)
+  plus molecular formula and weight for the current selection.
+- **Figure export** — plain SVG / PDF / PNG / TIFF with outlined glyphs (so screen,
+  vector, and raster output never diverge) and deterministic physical sizing
+  (bond-length or 84 / 174 mm column fit), independent of zoom. Editable Chemvas
+  SVG is opt-in and embeds the source document in SVG metadata.
+- **2D→3D `.xyz` export** _(RDKit)_ — convert the current molecule or atom/bond
+  selection into 3D coordinates; charges/radicals and wedge/hash stereo are carried
+  through, and common alias labels are expanded into explicit fragments.
+- **Editing** — select / move, horizontal & vertical flip, perspective rotation,
+  and delta-based undo/redo.
+- **ChemDraw-compatible shortcuts** — a substantial subset (see below).
+- **Save / load** — `.chemvas` JSON documents preserve the full working state.
+
+## Install
+
+Requires **Python 3.12+** and **PyQt6**.
+
+```bash
+# from a clone of this repo
+python -m pip install -e .
+
+# optional: enable SMILES / formula / 3D features
+python -m pip install -e ".[rdkit]"
+```
+
+> A PyPI release and prebuilt binaries are on the roadmap (see below). For now,
+> install from source.
+
+## Running
+
+```bash
+python app/main.py    # development tree
+chemvas               # after install
+```
+
+Pick a tool from the left toolbar and click/drag on the canvas to draw. Enter a
+SMILES string in the top input and press **Render** to enter placement mode: move
+the mouse to preview, click to insert, `Esc` to cancel. Templates work the same
+preview-and-click way.
+
+## Examples
+
+Open [`examples/template1.chemvas`](examples/template1.chemvas) via **File ▸ Open** to
+explore the document shown above — a reaction scheme plus several organocatalyst
+structures.
+
+## File format
+
+File ▸ Save / Open works with `.chemvas` files — a JSON-based format holding the
+molecule model, annotations, arrows, bracket annotations, and settings:
+
+```json
+{ "type": "chemvas", "version": 1, "state": { /* ... */ } }
+```
+
+Figure export defaults to plain SVG without Chemvas source metadata. Choose
+**Editable Chemvas SVG** only when you want the SVG to carry the original
+document payload for round-tripping back into Chemvas.
+
+## 3D export & Molecule Info
+
+- Export scope is the current chemical graph or the current atom/bond selection.
+  Arrows, bracket annotations, and free text are **not** included in `.xyz`.
+- `+`/`-`/radical marks become formal charges / radical electrons; wedge/hash bonds
+  on single bonds become RDKit stereochemistry hints.
+- Unsupported labels, mis-connected aliases, and invalid wedge/hash use fail with an
+  explicit error message instead of guessing.
+- `.xyz` stores element symbols and 3D coordinates only — it is **not** a full
+  round-trip of bond orders, stereochemistry, or reaction semantics.
+
+## Keyboard shortcuts
+
+Chemvas supports a major subset of ChemDraw-compatible shortcuts.
+
+- **Empty canvas (tool hotkeys):** Select/Marquee `Space`, Bond `X`, Atom/Text `T`,
+  Arrow `E`, Benzene `J`, Brackets `Shift+T`, Orbitals `Shift+G`,
+  Chemical symbols `Shift+E`, Perspective `Alt+D`
+- **Atom hotkeys (hover over an atom):** element/alias labels
+  `c n o s p f h b i l m e r x d` and `Shift+f/p/a/b/s/n/e/z/m/l/o/q/h/y`, charge `+`/`-`,
+  edit label `Enter`, sprout `0/1/2/3/a/4/5/6/7/8/9/z/v/u` (`9` = gem-dimethyl)
+- **Bond hotkeys (hover over a bond):** Single `1`, Double `2`, Triple `3`,
+  Bold `b`/`Shift+B`, Wedge `w`, Hash `h`/`Shift+H`, Dashed `d`/`Shift+D`,
+  double-bond position `l`/`c`/`r`, Benzene fusion `a`,
+  Ring fusion `4/5/6/7/8`, Chair fusion `9/0`
+- **Objects:** Flip Horizontal `Ctrl+Shift+H`, Flip Vertical `Ctrl+Shift+V`,
+  Rotate selection `Alt+Up/Down` (15°) and `Alt+Left/Right` (1°),
+  Nudge selection `Shift+Arrows` (10 pt)
+- **View:** Actual size `F5`, Fit to window `F6`, Magnify `F7`, Reduce `F8`
+- **File / edit:** Save / Open / Undo / Redo (platform defaults), `Ctrl+A` (select
+  all, switches to the Select tool), `Ctrl+C` (copy
+  selection as image), `Ctrl+X` (cut selection), `Ctrl+G` / `Ctrl+Shift+G`
+  (group / ungroup selection), `Delete`/`Backspace` (delete
+  selection, or edit/delete the hovered atom/bond), `Esc` (cancel template /
+  SMILES insertion)
+
+## Development
+
+CI runs `ruff`, `mypy`, and the test suite headlessly (`QT_QPA_PLATFORM=offscreen`).
+See [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, how to run the tests, and the
+**architecture conventions** — the codebase is split into many small
+`*_ports` / `*_access` / `*_state` / `*_service` modules **on purpose**, and that
+boundary is enforced by a test. Read CONTRIBUTING before restructuring anything.
+
+The high-level design is in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
+
+## Roadmap / not yet supported
+
+These are known gaps, not bugs — contributions welcome:
+
+- **Bond-aware interchange:** MOL / SDF **import**, and SDF (multi-molecule) export.
+  `.mol` export, SMILES export ("copy as SMILES"), and InChI / InChIKey have landed.
+- **Vector clipboard:** `Ctrl+C` currently copies a PNG only; PDF/SVG clipboard
+  flavors (for pasting into Illustrator / Office as vector) are planned.
+- **Distribution:** PyPI release and one-file desktop binaries.
+- **Multi-molecule / reaction-scheme 3D export** and richer template libraries.
+
+## License
+
+[MIT License](LICENSE)

chemvas-0.1.0/README.md

@@ -0,0 +1,157 @@
+<p align="center">
+  <img src="docs/images/banner.png" alt="Chemvas — 2D chemical structure drawing canvas" width="680">
+</p>
+
+<p align="center">
+  <a href="https://github.com/dhsohn/Chemvas/actions/workflows/ci.yml"><img src="https://github.com/dhsohn/Chemvas/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.12%2B-blue.svg" alt="Python 3.12+"></a>
+</p>
+
+<p align="center"><b>English</b> · <a href="README.ko.md">한국어</a></p>
+
+A lightweight, PyQt6-based 2D chemical structure drawing app for quickly sketching
+molecules and reaction schemes — and exporting publication-ready figures.
+
+![Chemvas — a Base/THF reaction scheme and several organocatalyst structures drawn on the canvas](docs/images/demo.png)
+
+Chemvas lets you combine molecular bonds/rings/labels, arrows, and bracket
+annotations on a single canvas. The default style follows the ACS 1996 conventions,
+and the goal is to draft figures for lab notebooks or papers fast. RDKit is an
+optional backend used for SMILES import, formula/weight calculation, and 2D→3D
+conversion — Chemvas runs without it.
+
+## Features
+
+- **Bonds** — single / double / triple, bold, wedge & hash; 30° angle snapping and
+  a consistent default bond length.
+- **Rings & templates** — benzene, cycloalkanes, chair/boat conformers placed by
+  live preview and click-to-insert.
+- **Arrows** — reaction, equilibrium, resonance, curved, and dashed arrows with
+  adjustable width and head scale.
+- **Brackets & annotations** — square / round / curly brackets, dagger (`†`) and
+  double dagger (`‡`) annotation objects.
+- **Atom labels** — elements, charges, radicals, and common alias labels
+  (`Me`, `Et`, `OH`, `Ph`, `OMe`, `Boc`, `CO2Me`, `t-Bu`, `i-Pr`).
+- **SMILES import** _(RDKit)_ — type a SMILES string, preview it under the cursor,
+  and click to place it on the canvas.
+- **Molecule Info window** _(RDKit)_ — 3D preview (drag to rotate, scroll to zoom)
+  plus molecular formula and weight for the current selection.
+- **Figure export** — plain SVG / PDF / PNG / TIFF with outlined glyphs (so screen,
+  vector, and raster output never diverge) and deterministic physical sizing
+  (bond-length or 84 / 174 mm column fit), independent of zoom. Editable Chemvas
+  SVG is opt-in and embeds the source document in SVG metadata.
+- **2D→3D `.xyz` export** _(RDKit)_ — convert the current molecule or atom/bond
+  selection into 3D coordinates; charges/radicals and wedge/hash stereo are carried
+  through, and common alias labels are expanded into explicit fragments.
+- **Editing** — select / move, horizontal & vertical flip, perspective rotation,
+  and delta-based undo/redo.
+- **ChemDraw-compatible shortcuts** — a substantial subset (see below).
+- **Save / load** — `.chemvas` JSON documents preserve the full working state.
+
+## Install
+
+Requires **Python 3.12+** and **PyQt6**.
+
+```bash
+# from a clone of this repo
+python -m pip install -e .
+
+# optional: enable SMILES / formula / 3D features
+python -m pip install -e ".[rdkit]"
+```
+
+> A PyPI release and prebuilt binaries are on the roadmap (see below). For now,
+> install from source.
+
+## Running
+
+```bash
+python app/main.py    # development tree
+chemvas               # after install
+```
+
+Pick a tool from the left toolbar and click/drag on the canvas to draw. Enter a
+SMILES string in the top input and press **Render** to enter placement mode: move
+the mouse to preview, click to insert, `Esc` to cancel. Templates work the same
+preview-and-click way.
+
+## Examples
+
+Open [`examples/template1.chemvas`](examples/template1.chemvas) via **File ▸ Open** to
+explore the document shown above — a reaction scheme plus several organocatalyst
+structures.
+
+## File format
+
+File ▸ Save / Open works with `.chemvas` files — a JSON-based format holding the
+molecule model, annotations, arrows, bracket annotations, and settings:
+
+```json
+{ "type": "chemvas", "version": 1, "state": { /* ... */ } }
+```
+
+Figure export defaults to plain SVG without Chemvas source metadata. Choose
+**Editable Chemvas SVG** only when you want the SVG to carry the original
+document payload for round-tripping back into Chemvas.
+
+## 3D export & Molecule Info
+
+- Export scope is the current chemical graph or the current atom/bond selection.
+  Arrows, bracket annotations, and free text are **not** included in `.xyz`.
+- `+`/`-`/radical marks become formal charges / radical electrons; wedge/hash bonds
+  on single bonds become RDKit stereochemistry hints.
+- Unsupported labels, mis-connected aliases, and invalid wedge/hash use fail with an
+  explicit error message instead of guessing.
+- `.xyz` stores element symbols and 3D coordinates only — it is **not** a full
+  round-trip of bond orders, stereochemistry, or reaction semantics.
+
+## Keyboard shortcuts
+
+Chemvas supports a major subset of ChemDraw-compatible shortcuts.
+
+- **Empty canvas (tool hotkeys):** Select/Marquee `Space`, Bond `X`, Atom/Text `T`,
+  Arrow `E`, Benzene `J`, Brackets `Shift+T`, Orbitals `Shift+G`,
+  Chemical symbols `Shift+E`, Perspective `Alt+D`
+- **Atom hotkeys (hover over an atom):** element/alias labels
+  `c n o s p f h b i l m e r x d` and `Shift+f/p/a/b/s/n/e/z/m/l/o/q/h/y`, charge `+`/`-`,
+  edit label `Enter`, sprout `0/1/2/3/a/4/5/6/7/8/9/z/v/u` (`9` = gem-dimethyl)
+- **Bond hotkeys (hover over a bond):** Single `1`, Double `2`, Triple `3`,
+  Bold `b`/`Shift+B`, Wedge `w`, Hash `h`/`Shift+H`, Dashed `d`/`Shift+D`,
+  double-bond position `l`/`c`/`r`, Benzene fusion `a`,
+  Ring fusion `4/5/6/7/8`, Chair fusion `9/0`
+- **Objects:** Flip Horizontal `Ctrl+Shift+H`, Flip Vertical `Ctrl+Shift+V`,
+  Rotate selection `Alt+Up/Down` (15°) and `Alt+Left/Right` (1°),
+  Nudge selection `Shift+Arrows` (10 pt)
+- **View:** Actual size `F5`, Fit to window `F6`, Magnify `F7`, Reduce `F8`
+- **File / edit:** Save / Open / Undo / Redo (platform defaults), `Ctrl+A` (select
+  all, switches to the Select tool), `Ctrl+C` (copy
+  selection as image), `Ctrl+X` (cut selection), `Ctrl+G` / `Ctrl+Shift+G`
+  (group / ungroup selection), `Delete`/`Backspace` (delete
+  selection, or edit/delete the hovered atom/bond), `Esc` (cancel template /
+  SMILES insertion)
+
+## Development
+
+CI runs `ruff`, `mypy`, and the test suite headlessly (`QT_QPA_PLATFORM=offscreen`).
+See [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, how to run the tests, and the
+**architecture conventions** — the codebase is split into many small
+`*_ports` / `*_access` / `*_state` / `*_service` modules **on purpose**, and that
+boundary is enforced by a test. Read CONTRIBUTING before restructuring anything.
+
+The high-level design is in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
+
+## Roadmap / not yet supported
+
+These are known gaps, not bugs — contributions welcome:
+
+- **Bond-aware interchange:** MOL / SDF **import**, and SDF (multi-molecule) export.
+  `.mol` export, SMILES export ("copy as SMILES"), and InChI / InChIKey have landed.
+- **Vector clipboard:** `Ctrl+C` currently copies a PNG only; PDF/SVG clipboard
+  flavors (for pasting into Illustrator / Office as vector) are planned.
+- **Distribution:** PyPI release and one-file desktop binaries.
+- **Multi-molecule / reaction-scheme 3D export** and richer template libraries.
+
+## License
+
+[MIT License](LICENSE)

chemvas-0.1.0/app/chemvas/__init__.py

@@ -0,0 +1,4 @@
+"""Chemvas application package."""
+
+__version__ = "0.1.0"
+

chemvas-0.1.0/app/chemvas/__main__.py

@@ -0,0 +1,5 @@
+from chemvas.main import main
+
+if __name__ == "__main__":
+    main()
+

chemvas-0.1.0/app/chemvas/assets/icon/chemvas.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <rect x="88" y="88" width="848" height="848" rx="190" fill="#0d9488"/>
+  <polygon points="512,277 715.5,394.5 715.5,629.5 512,747 308.5,629.5 308.5,394.5"
+           fill="none" stroke="#ffffff" stroke-width="46" stroke-linejoin="round"/>
+  <circle cx="512" cy="512" r="112" fill="none" stroke="#ffffff" stroke-width="36"/>
+</svg>

chemvas-0.1.0/app/chemvas/branding.py

@@ -0,0 +1,40 @@
+"""Application branding: identity strings and the window/app icon.
+
+The icon assets live in ``assets/icon`` inside this package (so they ship in the
+wheel) and are regenerated from ``chemvas.svg`` by ``scripts/generate_icons.py``.
+``app_icon`` assembles a multi-resolution ``QIcon`` from the runtime PNG set,
+falling back to the master SVG if the PNGs are missing. A ``QApplication`` must
+already exist before this is called.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from PyQt6.QtCore import QSize
+from PyQt6.QtGui import QIcon
+
+from chemvas import __version__
+
+APP_NAME = "Chemvas"
+APP_VERSION = __version__
+
+_ICON_DIR = Path(__file__).resolve().parent / "assets" / "icon"
+_ICON_PNG_SIZES = (16, 32, 64, 128, 256, 512)
+
+
+def app_icon() -> QIcon:
+    """A multi-resolution app icon, or an empty ``QIcon`` if assets are absent."""
+    icon = QIcon()
+    for size in _ICON_PNG_SIZES:
+        png = _ICON_DIR / f"chemvas-{size}.png"
+        if png.exists():
+            icon.addFile(str(png), QSize(size, size))
+    if icon.isNull():
+        svg = _ICON_DIR / "chemvas.svg"
+        if svg.exists():
+            icon.addFile(str(svg))
+    return icon
+
+
+__all__ = ["APP_NAME", "APP_VERSION", "app_icon"]

chemvas-0.1.0/app/chemvas/file_open.py

@@ -0,0 +1,60 @@
+"""macOS 'open document' handling.
+
+On macOS, double-clicking a ``.chemvas`` file (or dropping it on the Dock icon)
+delivers a ``QEvent.FileOpen`` Apple Event rather than a command-line argument;
+Windows and Linux pass the path in ``argv``, which ``main()`` reads directly via
+``_startup_document_path``. Install :class:`FileOpenEventFilter` on the
+``QApplication`` (with :func:`open_document` as its handler) so those events reach
+the document loader too.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import cast
+
+from PyQt6.QtCore import QEvent, QObject
+from PyQt6.QtGui import QFileOpenEvent
+
+
+class FileOpenEventFilter(QObject):
+    def __init__(self, handler: Callable[[str], None]) -> None:
+        super().__init__()
+        self._handler = handler
+
+    def eventFilter(self, obj: QObject | None, event: QEvent | None) -> bool:
+        if event is not None and event.type() == QEvent.Type.FileOpen:
+            path = cast(QFileOpenEvent, event).file()
+            if path:
+                self._handler(path)
+            return True
+        return False
+
+
+def open_document(path: str) -> None:
+    """Open ``path`` honoring Chemvas's single-document-per-window model.
+
+    Reuses a blank, unsaved, single-canvas window (the empty window opened at
+    startup) when one is available, so a cold-start file open doesn't leave an
+    extra empty window behind. Otherwise opens the document in a fresh window —
+    matching the File ▸ Open action rather than adding a tab to an existing,
+    already-occupied window. The destination window is resolved only after the
+    file reads successfully, so an unreadable file never spawns an empty window.
+    """
+    from ui.main_window_app import open_new_window, open_windows
+    from ui.main_window_ports import services_for_window
+
+    windows = open_windows()
+    reference = windows[-1] if windows else open_new_window()
+    services = services_for_window(reference)
+    documents = services.canvas_document_service
+
+    def target_provider() -> object:
+        if documents.reusable_open_target(reference) is not None:
+            return reference
+        return open_new_window(reference)
+
+    services.document_action_service.load_canvas_from_path(reference, path, target_provider=target_provider)
+
+
+__all__ = ["FileOpenEventFilter", "open_document"]

chemvas-0.1.0/app/chemvas/main.py

@@ -0,0 +1,91 @@
+from __future__ import annotations
+
+import os
+import sys
+import threading
+from collections.abc import Iterator
+from contextlib import contextmanager
+from pathlib import Path
+
+IGNORED_STDERR_SUBSTRINGS = (
+    "TSM AdjustCapsLockLEDForKeyTransitionHandling",
+    "error messaging the mach port for IMKCFRunLoopWakeUpReliable",
+    "qt.qpa.keymapper: Mismatch between Cocoa",
+)
+
+STARTUP_DOCUMENT_SUFFIXES = frozenset((".chemvas", ".json", ".svg"))
+
+
+def _should_filter_stderr(platform: str | None = None) -> bool:
+    return (platform or sys.platform) == "darwin"
+
+
+def _startup_document_path(argv: list[str]) -> str | None:
+    for argument in argv[1:]:
+        if argument.startswith("-"):
+            continue
+        if Path(argument).suffix.lower() in STARTUP_DOCUMENT_SUFFIXES:
+            return argument
+    return None
+
+
+def _stderr_filter_loop(
+    read_fd: int,
+    write_fd: int,
+    ignored_substrings: tuple[str, ...] = IGNORED_STDERR_SUBSTRINGS,
+) -> None:
+    with os.fdopen(read_fd, "r", buffering=1) as reader, os.fdopen(write_fd, "w", buffering=1) as writer:
+        for line in reader:
+            if any(fragment in line for fragment in ignored_substrings):
+                continue
+            writer.write(line)
+            writer.flush()
+
+
+@contextmanager
+def _filtered_stderr(stderr_fd: int = 2, platform: str | None = None) -> Iterator[None]:
+    if not _should_filter_stderr(platform):
+        yield
+        return
+
+    restore_stderr_fd = os.dup(stderr_fd)
+    forward_stderr_fd = os.dup(stderr_fd)
+    read_fd, write_fd = os.pipe()
+    thread = threading.Thread(target=_stderr_filter_loop, args=(read_fd, forward_stderr_fd), daemon=True)
+    os.dup2(write_fd, stderr_fd)
+    os.close(write_fd)
+    thread.start()
+    try:
+        yield
+    finally:
+        os.dup2(restore_stderr_fd, stderr_fd)
+        os.close(restore_stderr_fd)
+        thread.join(timeout=1.0)
+
+
+def main() -> None:
+    with _filtered_stderr():
+        from PyQt6.QtWidgets import QApplication
+        from ui.main_window_app import open_new_window
+
+        from chemvas.branding import APP_NAME, APP_VERSION, app_icon
+        from chemvas.file_open import FileOpenEventFilter, open_document
+
+        app = QApplication(sys.argv)
+        app.setApplicationName(APP_NAME)
+        app.setApplicationDisplayName(APP_NAME)
+        app.setApplicationVersion(APP_VERSION)
+        app.setOrganizationName(APP_NAME)
+        app.setDesktopFileName("chemvas")
+        app.setWindowIcon(app_icon())
+
+        file_open_filter = FileOpenEventFilter(open_document)
+        app.installEventFilter(file_open_filter)
+
+        window = open_new_window()
+        startup_document_path = _startup_document_path(sys.argv)
+        if startup_document_path is not None:
+            from ui.main_window_ports import services_for_window
+
+            services_for_window(window).document_action_service.load_canvas_from_path(window, startup_document_path)
+        app.exec()