qtshadcn 0.0.5__tar.gz

qtshadcn-0.0.5/.editorconfig

@@ -0,0 +1,46 @@
+root = true
+
+[*]
+tab_width = 4
+end_of_line = lf
+max_line_length = 88
+ij_visual_guides = 88
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{js,py,html}]
+charset = utf-8
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+
+[.flake8]
+indent_style = space
+indent_size = 2
+
+[*.{py,pyw,ini}]
+indent_style = space
+indent_size = 4
+ij_python_from_import_parentheses_force_if_multiline = true
+
+[*.sh]
+end_of_line = lf
+indent_style = space
+indent_size = 2
+
+[*.{bat,cmd}]
+end_of_line = crlf
+indent_style = space
+indent_size = 2
+
+
+[*.{html,htm,css,scss,sass,less,js,jsx,ts,tsx,json,yml,yaml,xml,toml,md}]
+indent_style = space
+indent_size = 2

qtshadcn-0.0.5/.gemini/skills/commit-hygiene/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: commit-hygiene
+description: "Trigger: commit, git commit, conventional commit, branch cleanup, commit message. Enforce conventional commits and clean history for QtShadcn."
+license: Apache-2.0
+metadata:
+  author: BugCodeX
+  version: "1.0"
+---
+
+# Activation Contract
+
+Apply this skill on any commit creation, commit message review, or branch cleanup in the QtShadcn project.
+
+## Hard Rules
+
+- NEVER add `Co-Authored-By` or any AI attribution trailers
+- One logical change per commit — no "add X and fix Y and update docs"
+- Use imperative mood: "add" not "added", "fix" not "fixed"
+- Keep subject line ≤ 72 characters
+- Reference issue numbers when relevant: `feat: add border-radius scale to tokens (#12)`
+- Add a body separated by a blank line when the commit needs explanation
+- Use `type!: description` for breaking changes — the `!` signals a semver MAJOR bump
+
+## Format
+
+```text
+type: description
+```
+
+Validated by regex:
+
+```text
+^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)!?: .+
+```
+
+## Valid Types
+
+| Type | Use For |
+| ------ | --------- |
+| feat | New feature or behavior |
+| fix | Bug fix |
+| docs | Documentation only |
+| chore | Maintenance, dependencies, tooling |
+| refactor | Restructuring without behavior change |
+| test | Adding or fixing tests |
+| ci | CI/CD pipeline changes |
+| style | Formatting, whitespace, no logic change |
+| perf | Performance improvement |
+| build | Build system, Makefile, pyproject changes |
+| revert | Reverting a previous commit |
+
+## Examples
+
+```text
+feat: add border-radius scale to design tokens
+feat: add dark mode theme variant
+feat!: rename apply_theme() to load_theme() — breaking API change
+fix: handle missing token fallback in QSS output
+fix: resolve widget rendering on high-DPI displays
+refactor: extract token resolver to separate method
+test: add unit tests for missing token fallback
+docs: document token naming convention
+chore: update uv.lock after dependency bump
+build: add coverage target to Makefile
+```
+
+## Anti-patterns
+
+```text
+# BAD — vague
+update stuff
+
+# BAD — AI attribution
+feat: add feature
+
+Co-Authored-By: Claude <claude@anthropic.com>
+
+# BAD — multiple concerns
+feat: add token scale and fix parser bug and update docs
+
+# BAD — past tense
+fix: fixed the missing token fallback
+```

qtshadcn-0.0.5/.gemini/skills/release-notes/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: release-notes
+description: "Trigger: release, release notes, changelog, tag, version, what's new. Generate structured release notes for QtShadcn versions."
+license: Apache-2.0
+metadata:
+  author: BugCodeX
+  version: "1.0"
+---
+
+# Activation Contract
+
+Apply this skill when creating or updating release notes for any QtShadcn version tag.
+
+## Hard Rules
+
+- Read commits since the previous tag: `git log --oneline <prev>...<next>`
+- Group commits by conventional type — never dump a raw commit list
+- Omit `chore` and `ci` from user-facing sections unless they affect the public API
+- Use plain, clear language — this is read by library consumers, not contributors
+- **Omit empty sections entirely** — never write "No fixes in this release" or similar
+- Always include a Verification section with the commands to validate the release
+- Version format: `vMAJOR.MINOR.PATCH` (semver)
+
+## Output Format
+
+```markdown
+# QtShadcn vX.Y.Z
+
+## What's New
+<!-- feat commits: new capabilities the user gains -->
+- Short description of the feature
+
+## Changes
+<!-- refactor, perf, style, build commits with user impact -->
+- Short description of the change
+
+## Fixes
+<!-- fix commits -->
+- Short description of the fix
+
+## Verification
+<!-- always include — commands to validate this release works -->
+\`\`\`bash
+pip install qtshadcn==X.Y.Z
+python -c "import qtshadcn; print(qtshadcn.__version__)"
+make test
+\`\`\`
+```
+
+## Section Rules
+
+| Section | Include | Omit |
+| --------- | --------- | ------ |
+| What's New | `feat` commits | Internal refactors with no API change |
+| Changes | `refactor`, `perf`, `style`, `build` with user impact | Pure internal restructuring |
+| Fixes | `fix` commits | Typo fixes in comments or docs |
+| Verification | Always present | Nothing — this section is mandatory |
+
+## Examples
+
+```markdown
+# QtShadcn v0.0.3
+
+## What's New
+- Added `QToolButton` styling support
+
+## Verification
+\`\`\`bash
+pip install qtshadcn==0.0.3
+python -c "import qtshadcn; print(qtshadcn.__version__)"
+make test
+\`\`\`
+```
+
+## Anti-patterns
+
+```markdown
+# BAD — raw commit dump
+- 1fe7498 chore: bump version to 0.0.3
+- 0aeeaac feat: add QToolButton styling support
+
+# BAD — empty section filler
+## Fixes
+- No fixes in this release
+
+# BAD — missing Verification section
+## Fixes
+- resolve rendering bug
+(end of notes)
+
+# BAD — vague entries
+- Various improvements
+- Bug fixes
+```

qtshadcn-0.0.5/.github/workflows/publish-pypi.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build backend
+        run: python -m pip install --upgrade build
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Upload distributions for inspection
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish distributions to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download built distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

qtshadcn-0.0.5/.gitignore

@@ -0,0 +1,48 @@
+# ── Bytecode ────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*.pyo
+
+# ── Virtual environment ────────────────────────────────────
+.venv/
+venv/
+env/
+*.egg-info/
+*.egg
+
+# ── Build artifacts ────────────────────────────────────────
+dist/
+build/
+site/
+*.whl
+.atl/
+*.atl
+
+# ── Testing ────────────────────────────────────────────────
+.pytest_cache/
+.coverage
+htmlcov/
+coverage.xml
+
+# ── Linting / formatting ───────────────────────────────────
+.ruff_cache/
+
+# ── IDE ────────────────────────────────────────────────────
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# ── OS ─────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+
+# ── Environment ────────────────────────────────────────────
+.env
+.env.*
+
+# ── CodeGraph index (regenerated locally) ──────────────────
+.codegraph/
+
+# ── SDD / planning artifacts (local only) ──────────────────
+openspec/

qtshadcn-0.0.5/.opencode/skills/commit-hygiene/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: commit-hygiene
+description: "Trigger: commit, git commit, conventional commit, branch cleanup, commit message. Enforce conventional commits and clean history for QtShadcn."
+license: Apache-2.0
+metadata:
+  author: gentleman-programming
+  version: "1.0"
+---
+
+# Activation Contract
+
+Apply this skill on any commit creation, commit message review, or branch cleanup in the QtShadcn project.
+
+## Hard Rules
+
+- NEVER add `Co-Authored-By` or any AI attribution trailers
+- One logical change per commit — no "add X and fix Y and update docs"
+- Use imperative mood: "add" not "added", "fix" not "fixed"
+- Keep subject line ≤ 72 characters
+- Reference issue numbers when relevant: `feat: add border-radius scale to tokens (#12)`
+- Add a body separated by a blank line when the commit needs explanation
+- Use `type!: description` for breaking changes — the `!` signals a semver MAJOR bump
+
+## Format
+
+```text
+type: description
+```
+
+Validated by regex:
+
+```text
+^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)!?: .+
+```
+
+## Valid Types
+
+| Type | Use For |
+| ------ | --------- |
+| feat | New feature or behavior |
+| fix | Bug fix |
+| docs | Documentation only |
+| chore | Maintenance, dependencies, tooling |
+| refactor | Restructuring without behavior change |
+| test | Adding or fixing tests |
+| ci | CI/CD pipeline changes |
+| style | Formatting, whitespace, no logic change |
+| perf | Performance improvement |
+| build | Build system, Makefile, pyproject changes |
+| revert | Reverting a previous commit |
+
+## Examples
+
+```text
+feat: add border-radius scale to design tokens
+feat: add dark mode theme variant
+feat!: rename apply_theme() to load_theme() — breaking API change
+fix: handle missing token fallback in QSS output
+fix: resolve widget rendering on high-DPI displays
+refactor: extract token resolver to separate method
+test: add unit tests for missing token fallback
+docs: document token naming convention
+chore: update uv.lock after dependency bump
+build: add coverage target to Makefile
+```
+
+## Anti-patterns
+
+```text
+# BAD — vague
+update stuff
+
+# BAD — AI attribution
+feat: add feature
+
+Co-Authored-By: Claude <claude@anthropic.com>
+
+# BAD — multiple concerns
+feat: add token scale and fix parser bug and update docs
+
+# BAD — past tense
+fix: fixed the missing token fallback
+```

qtshadcn-0.0.5/.opencode/skills/release-notes/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: release-notes
+description: "Trigger: release, release notes, changelog, tag, version, what's new. Generate structured release notes for QtShadcn versions."
+license: Apache-2.0
+metadata:
+  author: gentleman-programming
+  version: "1.0"
+---
+
+# Activation Contract
+
+Apply this skill when creating or updating release notes for any QtShadcn version tag.
+
+## Hard Rules
+
+- Read commits since the previous tag: `git log --oneline <prev>...<next>`
+- Group commits by conventional type — never dump a raw commit list
+- Omit `chore` and `ci` from user-facing sections unless they affect the public API
+- Use plain, clear language — this is read by library consumers, not contributors
+- **Omit empty sections entirely** — never write "No fixes in this release" or similar
+- Always include a Verification section with the commands to validate the release
+- Version format: `vMAJOR.MINOR.PATCH` (semver)
+
+## Output Format
+
+```markdown
+# QtShadcn vX.Y.Z
+
+## What's New
+<!-- feat commits: new capabilities the user gains -->
+- Short description of the feature
+
+## Changes
+<!-- refactor, perf, style, build commits with user impact -->
+- Short description of the change
+
+## Fixes
+<!-- fix commits -->
+- Short description of the fix
+
+## Verification
+<!-- always include — commands to validate this release works -->
+\`\`\`bash
+pip install qtshadcn==X.Y.Z
+python -c "import qtshadcn; print(qtshadcn.__version__)"
+make test
+\`\`\`
+```
+
+## Section Rules
+
+| Section | Include | Omit |
+| --------- | --------- | ------ |
+| What's New | `feat` commits | Internal refactors with no API change |
+| Changes | `refactor`, `perf`, `style`, `build` with user impact | Pure internal restructuring |
+| Fixes | `fix` commits | Typo fixes in comments or docs |
+| Verification | Always present | Nothing — this section is mandatory |
+
+## Examples
+
+```markdown
+# QtShadcn v0.0.3
+
+## What's New
+- Added `QToolButton` styling support
+
+## Verification
+\`\`\`bash
+pip install qtshadcn==0.0.3
+python -c "import qtshadcn; print(qtshadcn.__version__)"
+make test
+\`\`\`
+```
+
+## Anti-patterns
+
+```markdown
+# BAD — raw commit dump
+- 1fe7498 chore: bump version to 0.0.3
+- 0aeeaac feat: add QToolButton styling support
+
+# BAD — empty section filler
+## Fixes
+- No fixes in this release
+
+# BAD — missing Verification section
+## Fixes
+- resolve rendering bug
+(end of notes)
+
+# BAD — vague entries
+- Various improvements
+- Bug fixes
+```

qtshadcn-0.0.5/.python-version

@@ -0,0 +1 @@
+3.11

qtshadcn-0.0.5/AGENTS.md

@@ -0,0 +1,103 @@
+# AGENTS.md — QtShadcn
+
+Modern styling and theming framework for Qt/PySide6 applications, inspired by [shadcn/ui](https://ui.shadcn.com).
+
+---
+
+## Project Overview
+
+QtShadcn loads a local **XML theme file** with `<light>` and `<dark>` palettes, resolves design tokens, renders a QSS stylesheet via Jinja2, and applies it to a `QApplication` in one call.
+
+- **Language**: Python ≥ 3.11
+- **Package manager**: `uv`
+- **Build backend**: Hatchling
+- **Test runner**: pytest
+- **Linter/formatter**: ruff (line length: 100)
+- **Type checker**: ty
+- **Docs**: MkDocs + Material theme
+
+---
+
+## Repository Structure
+
+```text
+qtshadcn/
+├── app.py          # Public API: apply_theme(), get_theme(), ThemeConfig
+├── models.py       # Pydantic models: ShadcnTheme, ShadcnThemeTokens, ThemeConfig
+├── parser.py       # XML theme parser
+├── styles/
+│   └── shadcn.jinja  # QSS template — the ONLY file for widget styles
+├── themes/
+│   └── default.xml   # Default light/dark token values
+├── tokens/
+│   ├── colors.py     # alpha(), mix() helpers
+│   ├── radius.py     # class_px() helper
+│   └── scale.py      # spacing_px(), TEXT_*, FONT_WEIGHT_* constants
+└── fonts/            # Bundled font files
+tests/
+├── test_app.py
+├── test_integration.py
+├── test_models.py
+├── test_parser.py
+├── test_renderer.py  # QSS output assertions
+└── test_tokens.py
+```
+
+---
+
+## Development Commands
+
+```bash
+make install-dev   # set up the virtual environment (uv sync --extra dev)
+make lint          # ruff check (report only)
+make format        # ruff format + ruff check --fix
+make type-check    # ty check
+make test          # pytest
+make test-cov      # pytest with HTML coverage report
+make docs-serve    # live-reload docs at http://127.0.0.1:8000
+make build         # wheel + sdist
+make clean         # remove dist/, caches, .coverage
+```
+
+---
+
+## Coding Conventions
+
+- **Docstrings**: required on all public modules, classes, and functions (pydocstyle enforced via ruff `D` rules)
+- **Imports**: isort-ordered (`I` rules); no star imports
+- **Quotes**: double quotes
+- **Indent**: spaces
+- **Line length**: 100 characters (E501 ignored in ruff, but keep it reasonable)
+- **Type annotations**: required on all public functions; `ty` must pass with no warnings
+- **Tests**: no docstrings required in `tests/` or `examples/`
+
+---
+
+## Architecture Rules
+
+- **Widget styles belong in `qtshadcn/styles/shadcn.jinja` only** — do not create new QSS files
+- **No hardcoded colors or pixel values in the Jinja template** — use tokens and helpers exclusively
+- **Token helpers** (`colors.alpha`, `colors.mix`, `radius.class_px`, `scale.spacing_px`) are the only way to transform token values
+- **Theme tokens are defined in XML** (`themes/default.xml`) — do not add Python-level color constants
+- **Public API surface**: `apply_theme()`, `get_theme()`, `ThemeConfig`, `ShadcnThemeTokens` — keep it minimal
+
+---
+
+## Skills
+
+These skills are active for this project. Read the corresponding `SKILL.md` before performing the related task.
+
+| Skill              | When to use                                                  | Path                                                         |
+|--------------------|--------------------------------------------------------------|--------------------------------------------------------------|
+| `commit-hygiene`   | Any commit creation, message review, or branch cleanup       | [SKILL.md](.gemini/skills/commit-hygiene/SKILL.md)           |
+| `release-notes`    | Creating or updating release notes for any version tag       | [SKILL.md](.gemini/skills/release-notes/SKILL.md)            |
+
+---
+
+## Versioning
+
+Follows [semver](https://semver.org). Version is defined in `pyproject.toml` and must match the git tag (`vMAJOR.MINOR.PATCH`).
+
+- `feat!:` commits → MAJOR bump
+- `feat:` commits → MINOR bump
+- `fix:` commits → PATCH bump

qtshadcn-0.0.5/LICENSE

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