0.0.1

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: pomponchik
+
+---
+
+## Short description
+
+Replace this text with a short description of the error and the behavior that you expected to see instead.
+
+
+## Describe the bug in detail
+
+Please add a test that reproduces the bug (i.e., currently fails):
+
+```python
+def test_your_bug():
+    ...
+```
+
+When writing the test, please ensure compatibility with the [`pytest`](https://docs.pytest.org/) framework.
+
+If for some reason you cannot describe the error in the test format, describe the steps to reproduce it here.
+
+
+## Environment
+ - OS: ...
+ - Python version (the output of the `python --version` command): ...
+ - Version of this package: ...

.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,26 @@
+---
+name: Documentation fix
+about: Add something to the documentation, delete it, or change it
+title: ''
+labels: documentation
+assignees: pomponchik
+---
+
+## It's cool that you're here!
+
+Documentation is an important part of the project; we strive to make it high-quality and keep it up to date. Please adjust this template by outlining your proposal.
+
+
+## Type of action
+
+What do you want to do: remove something, add something, or change something?
+
+
+## Where?
+
+Specify which part of the documentation you want to change. For example, the name of an existing documentation section or a line number in `README.md`.
+
+
+## The essence
+
+Please describe the essence of the proposed change.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: pomponchik
+
+---
+
+## Short description
+
+What do you propose and why do you consider it important?
+
+
+## Some details
+
+If you can, provide code examples that will show how your proposal will work. Also, if you can, indicate which alternative approaches you have considered. And finally, describe how you propose to verify that your idea is implemented correctly, if at all possible.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,12 @@
+---
+name: Question or consultation
+about: Ask anything about this project
+title: ''
+labels: question
+assignees: pomponchik
+
+---
+
+## Your question
+
+Here you can freely describe your question about the project. Please read the documentation provided before doing this, and ask the question only if it is not answered there. In addition, please keep in mind that this is a free non-commercial project and user support is optional for its author. Response times are not guaranteed.

.github/workflows/lint.yml

@@ -0,0 +1,63 @@
+name: Lint
+
+on:
+  push
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14', '3.14t', '3.15']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+          python-version: ${{ matrix.python-version }}
+          # Prerelease CPython ABIs can change; keep 3.15 aligned with current wheels.
+          allow-prereleases: true
+          check-latest: ${{ matrix.python-version == '3.15' }}
+
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      shell: bash
+      run: uv pip install --system -r requirements_dev.txt
+
+    - name: Install the library
+      shell: bash
+      run: uv pip install --system .
+
+    - name: Run ruff
+      shell: bash
+      run: ruff check wasmgpu
+
+    - name: Run ruff for tests
+      shell: bash
+      run: ruff check tests
+
+    - name: Run mypy
+      shell: bash
+      run: >-
+        mypy
+        --show-error-codes
+        --strict
+        --disallow-any-decorated
+        --disallow-any-explicit
+        --disallow-any-expr
+        --disallow-any-generics
+        --disallow-any-unimported
+        --disallow-subclassing-any
+        --warn-return-any
+        wasmgpu
+
+    - name: Run mypy for tests
+      shell: bash
+      run: mypy --exclude '^tests/typing/' tests

.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  pypi-publish:
+    name: upload release to PyPI
+    runs-on: ubuntu-latest
+    # Specifying a GitHub environment is optional, but strongly encouraged
+    environment: release
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+            python-version: '3.13'
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        shell: bash
+        run: uv pip install --system -r requirements_dev.txt
+
+      - name: Build the project
+        shell: bash
+        run: python -m build .
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/tests_and_coverage.yml

@@ -0,0 +1,68 @@
+name: Tests
+
+on:
+  push
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [macos-latest, ubuntu-latest, windows-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14', '3.14t', '3.15']
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+          python-version: ${{ matrix.python-version }}
+          # Prerelease CPython ABIs can change; keep 3.15 aligned with current wheels.
+          allow-prereleases: true
+          check-latest: ${{ matrix.python-version == '3.15' }}
+
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      shell: bash
+      run: |
+        uv pip install --system -r requirements_dev.txt
+        uv pip install --system .
+
+    - name: Test Python validation and configuration (no GPU required)
+      shell: bash
+      run: |
+        coverage erase
+        coverage run -m pytest -m 'not gpu' --cache-clear
+        coverage combine
+        coverage report -m
+        coverage xml
+      # This report covers only tests that require no GPU. GPU execution and
+      # shader conformance are verified locally; these jobs do not claim that
+      # skipped GPU tests passed. Never enable a software execution fallback.
+
+    - name: Build source distribution and wheel
+      shell: bash
+      run: python -m build
+
+    - name: Upload Python-only coverage to Coveralls
+      if: runner.os == 'Linux' && matrix.python-version == '3.11'
+      env:
+        COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}
+      uses: coverallsapp/github-action@v2
+      with:
+        format: cobertura
+        file: coverage.xml
+        flag-name: python-only
+      continue-on-error: true
+
+    - name: Upload Python-only coverage report
+      if: runner.os == 'Linux' && matrix.python-version == '3.11'
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-only-coverage
+        path: coverage.xml

.gitignore

@@ -0,0 +1,21 @@
+.DS_Store
+__pycache__
+venv
+.pytest_cache
+build
+dist
+*.egg-info
+test.py
+.coverage
+.coverage.*
+.idea
+.ruff_cache
+.mutmut-cache
+.mypy_cache
+html
+CLAUDE.md
+.claude
+mutants
+planning_features.md
+coverage.xml
+/tests/benchmark-results.json

MANIFEST.in

@@ -0,0 +1,3 @@
+include requirements_dev.txt
+recursive-include tests *.py *.c *.rs *.wasm *.zip *.md *.json
+exclude tests/benchmark-results.json