refactor to seperate nicegui, stylesheet, session

.env.example

@@ -14,6 +14,7 @@ DATA_PATH=src/spanselector/data/sample.csv
 HOST=127.0.0.1
 PORT=8080
 # RELOAD=false
+# SHOW=true
 
 # Optional: Logging level (DEBUG, INFO, WARNING, ERROR)
 # LOG_LEVEL=INFO

.github/workflows/ci.yml

@@ -9,20 +9,16 @@ permissions:
   contents: read
 
 jobs:
-  quality:
-    name: Python ${{ matrix.python-version }}
+  static-analysis:
+    name: Static analysis (Ruff + mypy)
     runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v7
       - name: Install uv
         uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: "3.13"
           enable-cache: true
       - name: Install dependencies
         run: uv sync --locked --extra dev
@@ -32,14 +28,43 @@ jobs:
         run: uv run ruff format --check .
       - name: Type check
         run: uv run mypy src/spanselector
+
+  tests:
+    name: Tests / Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --locked --extra dev
       - name: Test
         run: uv run pytest
+
+  package:
+    name: Package / Build distributions
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.13"
+          enable-cache: true
       - name: Build package
-        if: matrix.python-version == '3.13'
         run: uv build
 
   browser-tests:
-    name: Selection in ${{ matrix.browser }}
+    name: E2E / Selection / ${{ matrix.browser }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false

.pre-commit-config.yaml

@@ -0,0 +1,62 @@
+minimum_pre_commit_version: "4.0.0"
+default_install_hook_types: [pre-commit]
+
+# These local hooks intentionally mirror .github/workflows/ci.yml. They run
+# against the whole repository so documentation-only commits cannot bypass CI.
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-lint
+        name: CI / Ruff lint
+        entry: uv run --locked --extra dev ruff check .
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: ruff-format
+        name: CI / Ruff format
+        entry: uv run --locked --extra dev ruff format --check .
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: mypy
+        name: CI / mypy
+        entry: uv run --locked --extra dev mypy --no-incremental src/spanselector
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: pytest
+        name: CI / pytest
+        entry: uv run --locked --extra dev pytest
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: build
+        name: CI / package build
+        entry: uv build
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: e2e-chromium
+        name: CI / Playwright Chromium
+        entry: >-
+          uv run --locked --extra dev --extra e2e pytest tests/e2e --run-e2e
+          --browser chromium --no-cov --tracing retain-on-failure
+          --screenshot only-on-failure
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: e2e-firefox
+        name: CI / Playwright Firefox
+        entry: >-
+          uv run --locked --extra dev --extra e2e pytest tests/e2e --run-e2e
+          --browser firefox --no-cov --tracing retain-on-failure
+          --screenshot only-on-failure
+        language: system
+        pass_filenames: false
+        always_run: true

CONTRIBUTING.md

@@ -6,12 +6,23 @@ strengthen the local span-annotation loop before expanding its product surface.
 ## Set up
 
 ```bash
-uv sync --extra dev
+uv sync --extra dev --extra e2e
+uv run playwright install chromium firefox
+uv run pre-commit install
 uv run spanselector
 ```
 
 ## Before opening a pull request
 
+Every commit runs the same lint, format, type, test, build, and browser checks as CI. To run the
+complete gate without creating a commit:
+
+```bash
+uv run pre-commit run --all-files
+```
+
+The individual commands are:
+
 ```bash
 uv run ruff format --check .
 uv run ruff check .

pyproject.toml

@@ -39,6 +39,7 @@ Issues = "https://github.com/wiperpaul/span-annotator/issues"
 
 [project.optional-dependencies]
 dev = [
+    "pre-commit>=4.0",
     "pytest>=7.4",
     "pytest-cov>=4.1",
     "ruff>=0.2.0",
@@ -78,4 +79,4 @@ ignore_missing_imports = true
 where = ["src"]
 
 [tool.setuptools.package-data]
-spanselector = ["data/*.csv", "schemas/*.yaml"]
+spanselector = ["assets/*.css", "data/*.csv", "schemas/*.yaml"]