difflicious 0.11.0__tar.gz → 0.12.0__tar.gz

difflicious-0.12.0/.github/workflows/pages.yml

@@ -0,0 +1,39 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/site/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/configure-pages@v5
+      - uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs/site
+          destination: ./_site
+      - uses: actions/upload-pages-artifact@v3
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

{difflicious-0.11.0 → difflicious-0.12.0}/CHANGELOG.md

@@ -5,10 +5,23 @@ All notable changes to difflicious will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.11.0] - 2026-02-28
+## [0.12.0] - 2026-04-14
+
+### Presentation Layer Separation
+
+Enforced explicit contracts between the data, service, template, CSS, and JS layers. Full design rationale in [`docs/presentation-layer-separation.md`](docs/presentation-layer-separation.md).
 
 ### Changed
-- Pipeline test release — verifying PyPI and Docker Hub publishing workflows
+- **Removed dual state** — deleted `state.js` and `file-operations.js`; `diffStore` is now the single source of truth for expansion state
+- **Template→JS contract** — all JS query-hook CSS selectors prefixed `js-` (e.g. `js-hunk`, `js-expansion-btn`) to distinguish them from styled classes
+- **Template→CSS contract** — inline Tailwind colour utilities moved to semantic component classes (`.file-card`, `.file-card-header`, `.file-card-nav-btn`)
+- **ThemeStore init** — reads initial theme from the server-rendered `data-theme` DOM attribute only; no redundant localStorage/matchMedia read on boot
+
+### Fixed
+- **Flash of unstyled content** — added the missing `[x-cloak] { display: none !important }` CSS rule; every prior `x-cloak` attribute was inert without it
+- **Flash of expansion state** — server now embeds repo name as `window.DIFFLICIOUS_REPO`; an inline pre-warming script reads localStorage before Alpine boots so the first render reflects saved state
+- **File content animation** — removed vertical scale transform; transition is now a plain opacity fade
+- **Ctrl+C shutdown** — SIGINT now triggers `os._exit(0)` matching the existing SIGTERM handler, so a single keypress exits cleanly regardless of open SSE connections
 
 ## [1.0.0] - 2026-02-06
 

{difflicious-0.11.0 → difflicious-0.12.0}/CLAUDE.md

@@ -535,7 +535,8 @@ The application is designed for multiple distribution channels:
 - `README.md` - User-facing documentation and installation instructions
 - `CLAUDE.md` - This file - AI assistant guidance and codebase overview
 - `PLAN.md` - Original project plan and technical decisions
-- `CONTRIBUTING.md` - Contribution guidelines
+- `CONTRIBUTING.md` - Brief contribution pointer
+- `DEVELOPING.md` - Full development setup, workflow, and conventions
 - `CHANGELOG.md` - Version history and changes
 - `INSTALLATION.md` - Installation and usage guide (PyPI, Docker, configuration)
 

difflicious-0.12.0/CONTRIBUTING.md

@@ -0,0 +1,8 @@
+# Contributing to Difflicious
+
+Contributions are welcome. Please see [DEVELOPING.md](DEVELOPING.md) for:
+
+- Development environment setup
+- Running tests and quality checks
+- Code style and conventions
+- Submitting pull requests

difflicious-0.11.0/CONTRIBUTING.md → difflicious-0.12.0/DEVELOPING.md

@@ -1,36 +1,20 @@
-# Contributing to Difflicious
+# Developing Difflicious
 
-Thank you for your interest in contributing to difflicious! This document provides guidelines and instructions for development setup and making contributions.
+This document covers development environment setup, workflow, and code conventions.
 
 ## Table of Contents
 
-- [Getting Started](#getting-started)
-- [Development Setup](#development-setup)
+- [Setup](#setup)
 - [Development Workflow](#development-workflow)
 - [Testing](#testing)
 - [Code Style](#code-style)
-- [Making Changes](#making-changes)
+- [Commit Messages](#commit-messages)
 - [Submitting Changes](#submitting-changes)
 - [Releasing New Versions](#releasing-new-versions)
 - [Development Commands](#development-commands)
 - [Project Structure](#project-structure)
-- [Getting Help](#getting-help)
 
-## Getting Started
-
-1. **Fork the repository** on GitHub
-2. **Clone your fork**:
-   ```bash
-   git clone https://github.com/YOUR_USERNAME/difflicious.git
-   cd difflicious
-   ```
-3. **Add the upstream repository**:
-   ```bash
-   git remote add upstream https://github.com/insipid/difflicious.git
-   ```
-4. **Create a branch** for your changes
-
-## Development Setup
+## Setup
 
 ### Prerequisites
 
@@ -217,9 +201,7 @@ This ensures:
 - All tests pass
 - Code is formatted correctly
 
-## Making Changes
-
-### Commit Messages
+## Commit Messages
 
 Write clear, descriptive commit messages:
 
@@ -482,15 +464,3 @@ difflicious/
 └── README.md                 # Project overview
 ```
 
-## Getting Help
-
-If you need help:
-- **Check existing issues** on GitHub
-- **Open a new issue** with questions
-- **Ask in discussions** for non-urgent queries
-- **Check the README** for project overview
-- **Read existing code** for examples
-
-## Thank You
-
-Contributions are what make open source great. Thank you for taking the time to contribute to difflicious!

{difflicious-0.11.0 → difflicious-0.12.0}/INSTALLATION.md

@@ -207,9 +207,23 @@ docker-compose up
 
 ### Font Customization
 
-For the full list of fonts and examples, see the
-[README font customization section](../README.md#font-customization). The key
-configuration point is still the `DIFFLICIOUS_FONT` environment variable.
+Set the `DIFFLICIOUS_FONT` environment variable to choose a programming font:
+
+| Key | Font |
+|-----|------|
+| `jetbrains-mono` | JetBrains Mono (default) |
+| `fira-code` | Fira Code |
+| `source-code-pro` | Source Code Pro |
+| `ibm-plex-mono` | IBM Plex Mono |
+| `roboto-mono` | Roboto Mono |
+| `inconsolata` | Inconsolata |
+
+```bash
+DIFFLICIOUS_FONT=fira-code difflicious
+
+# List all available fonts
+difflicious --list-fonts
+```
 
 ### Disable Google Fonts
 
@@ -277,7 +291,6 @@ For more troubleshooting help, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
 
 ## Next Steps
 
-- Learn how to [contribute](CONTRIBUTING.md) to difflicious
 - Check [troubleshooting](TROUBLESHOOTING.md) for common issues
 - Read the main [README](../README.md) for features
-- Explore the [development setup](CONTRIBUTING.md#development-setup) for hacking on difflicious
+- Explore [DEVELOPING.md](../DEVELOPING.md) for development setup and workflow

difflicious-0.12.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: difflicious
+Version: 0.12.0
+Summary: A sleek web-based git diff visualization tool for developers
+Project-URL: Homepage, https://github.com/insipid/difflicious
+Project-URL: Repository, https://github.com/insipid/difflicious
+Project-URL: Issues, https://github.com/insipid/difflicious/issues
+Project-URL: Documentation, https://github.com/insipid/difflicious#readme
+Project-URL: Changelog, https://github.com/insipid/difflicious/blob/main/CHANGELOG.md
+Author: Drew
+License: MIT
+License-File: LICENSE
+Keywords: development,diff,git,visualization,web
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Text Processing :: General
+Requires-Python: >=3.9
+Requires-Dist: click<9.0,>=8.0.0
+Requires-Dist: flask<3.0,>=2.3.0
+Requires-Dist: gitpython<4.0,>=3.1.40
+Requires-Dist: jinja-partials<1.0,>=0.2.0
+Requires-Dist: markupsafe<3.0,>=2.1.0
+Requires-Dist: pygments<3.0,>=2.17.0
+Requires-Dist: unidiff<1.0,>=0.7.5
+Requires-Dist: waitress>=3.0.0
+Requires-Dist: watchdog<4.0,>=3.0.0
+Description-Content-Type: text/markdown
+
+# Difflicious
+
+[![PyPI version](https://img.shields.io/pypi/v/difflicious.svg)](https://pypi.org/project/difflicious/)
+[![Python versions](https://img.shields.io/pypi/pyversions/difflicious.svg)](https://pypi.org/project/difflicious/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A local web application for reviewing git diffs. Run it in your working directory and view your changes in a browser with side-by-side visualization, syntax highlighting, and context expansion.
+
+## Screenshots
+
+| Light mode | Dark mode |
+|------------|-----------|
+| ![Light mode](docs/screenshots/light.png) | ![Dark mode](docs/screenshots/dark.png) |
+
+> To regenerate: `uv run python scripts/screenshot.py`
+> Prerequisites: `uv add --dev playwright && uv run playwright install chromium`
+
+## Installation
+
+```bash
+pip install difflicious
+difflicious
+```
+
+Open `http://localhost:5000` in your browser.
+
+See [INSTALLATION.md](INSTALLATION.md) for Docker, source installation, and full configuration options.
+
+## Features
+
+- Side-by-side diff view with line numbering
+- Syntax highlighting for 100+ languages (via Pygments)
+- Context expansion to see more surrounding code
+- Search and filter across files
+- Light and dark themes
+- Live auto-reload on file changes (SSE)
+- Font customization via `DIFFLICIOUS_FONT` environment variable
+
+## Configuration
+
+Set environment variables to configure behavior:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DIFFLICIOUS_PORT` | `5000` | Port to listen on |
+| `DIFFLICIOUS_HOST` | `127.0.0.1` | Host to bind to |
+| `DIFFLICIOUS_FONT` | `jetbrains-mono` | Code font (see `--list-fonts`) |
+| `DIFFLICIOUS_DISABLE_GOOGLE_FONTS` | `false` | Use system fonts only |
+| `DIFFLICIOUS_AUTO_RELOAD` | `true` | Auto-reload on file changes |
+| `DIFFLICIOUS_DEBUG` | `false` | Verbose debug logging |
+
+See [INSTALLATION.md](INSTALLATION.md) for full configuration details.
+
+## Technology
+
+- **Backend**: Flask, GitPython, Pygments, unidiff
+- **Frontend**: Alpine.js, Tailwind CSS
+- **Real-time**: Server-Sent Events
+
+## Documentation
+
+- [INSTALLATION.md](INSTALLATION.md) — installation options, configuration, environment variables
+- [DEVELOPING.md](DEVELOPING.md) — development setup, testing, code conventions
+- [CHANGELOG.md](CHANGELOG.md) — version history
+- [docs/CSS-STYLE-GUIDE.md](docs/CSS-STYLE-GUIDE.md) — CSS conventions and design tokens
+- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — common issues
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT License — see [LICENSE](LICENSE) file for details.

difflicious-0.12.0/README.md

@@ -0,0 +1,74 @@
+# Difflicious
+
+[![PyPI version](https://img.shields.io/pypi/v/difflicious.svg)](https://pypi.org/project/difflicious/)
+[![Python versions](https://img.shields.io/pypi/pyversions/difflicious.svg)](https://pypi.org/project/difflicious/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A local web application for reviewing git diffs. Run it in your working directory and view your changes in a browser with side-by-side visualization, syntax highlighting, and context expansion.
+
+## Screenshots
+
+| Light mode | Dark mode |
+|------------|-----------|
+| ![Light mode](docs/screenshots/light.png) | ![Dark mode](docs/screenshots/dark.png) |
+
+> To regenerate: `uv run python scripts/screenshot.py`
+> Prerequisites: `uv add --dev playwright && uv run playwright install chromium`
+
+## Installation
+
+```bash
+pip install difflicious
+difflicious
+```
+
+Open `http://localhost:5000` in your browser.
+
+See [INSTALLATION.md](INSTALLATION.md) for Docker, source installation, and full configuration options.
+
+## Features
+
+- Side-by-side diff view with line numbering
+- Syntax highlighting for 100+ languages (via Pygments)
+- Context expansion to see more surrounding code
+- Search and filter across files
+- Light and dark themes
+- Live auto-reload on file changes (SSE)
+- Font customization via `DIFFLICIOUS_FONT` environment variable
+
+## Configuration
+
+Set environment variables to configure behavior:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DIFFLICIOUS_PORT` | `5000` | Port to listen on |
+| `DIFFLICIOUS_HOST` | `127.0.0.1` | Host to bind to |
+| `DIFFLICIOUS_FONT` | `jetbrains-mono` | Code font (see `--list-fonts`) |
+| `DIFFLICIOUS_DISABLE_GOOGLE_FONTS` | `false` | Use system fonts only |
+| `DIFFLICIOUS_AUTO_RELOAD` | `true` | Auto-reload on file changes |
+| `DIFFLICIOUS_DEBUG` | `false` | Verbose debug logging |
+
+See [INSTALLATION.md](INSTALLATION.md) for full configuration details.
+
+## Technology
+
+- **Backend**: Flask, GitPython, Pygments, unidiff
+- **Frontend**: Alpine.js, Tailwind CSS
+- **Real-time**: Server-Sent Events
+
+## Documentation
+
+- [INSTALLATION.md](INSTALLATION.md) — installation options, configuration, environment variables
+- [DEVELOPING.md](DEVELOPING.md) — development setup, testing, code conventions
+- [CHANGELOG.md](CHANGELOG.md) — version history
+- [docs/CSS-STYLE-GUIDE.md](docs/CSS-STYLE-GUIDE.md) — CSS conventions and design tokens
+- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — common issues
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT License — see [LICENSE](LICENSE) file for details.