pyzed-ui 0.2.0__tar.gz

pyzed_ui-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Lint y tests (Linux)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+      - uses: Swatinem/rust-cache@v2
+      - name: Lint Rust
+        run: |
+          cargo fmt --check
+          cargo clippy -- -D warnings
+      - name: Build and install
+        run: |
+          python -m venv .venv
+          .venv/bin/pip install maturin pytest
+          .venv/bin/maturin develop --release
+      - name: Run tests
+        run: .venv/bin/python -m pytest -q tests
+
+  wheels:
+    name: Wheel (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+          manylinux: "2_28"
+      - name: Test the wheel
+        shell: bash
+        run: |
+          python -m pip install pytest
+          python -m pip install --no-index --find-links dist pyzed-ui
+          python -m pytest -q tests
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.os }}
+          path: dist/*.whl
+
+  changelog:
+    name: Changelog
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Generate changelog
+        run: |
+          python -m pip install git-cliff
+          python scripts/changelog.py --preview | tee -a "$GITHUB_STEP_SUMMARY"

pyzed_ui-0.2.0/.github/workflows/docs.yml

@@ -0,0 +1,91 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "CHANGELOG.md"
+      - "examples/**"
+      - "python/**"
+      - "src/**"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "CHANGELOG.md"
+      - "examples/**"
+      - "python/**"
+      - "src/**"
+      - ".github/workflows/docs.yml"
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build site
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: docs/package-lock.json
+      - name: Install
+        working-directory: docs
+        run: npm ci
+      - name: Build (reads CHANGELOG.md and marks the latest stable release)
+        working-directory: docs
+        run: npm run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/dist
+
+  api-reference:
+    name: API reference up to date
+    runs-on: ubuntu-latest
+    if: github.event_name != 'release'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: Build and install
+        run: |
+          python -m venv .venv
+          .venv/bin/pip install maturin
+          .venv/bin/maturin develop --release
+      - name: Check (warnings only)
+        run: |
+          .venv/bin/python docs/scripts/gen_api.py --check | sed 's/^/::warning title=Docs::/' || true
+          .venv/bin/python docs/scripts/gen_api.py > /dev/null
+          if ! git diff --quiet -- docs/src/content/docs/reference; then
+            echo "::warning title=Docs::The API reference is out of date. Run 'python docs/scripts/gen_api.py' and commit the result."
+            git diff --stat -- docs/src/content/docs/reference
+          fi
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/main' || github.event_name == 'release')
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

pyzed_ui-0.2.0/.github/workflows/pr-title.yml

@@ -0,0 +1,33 @@
+name: PR title
+
+# El changelog se genera de los commits convencionales; con "squash merge" el
+# título del PR es el mensaje del commit, así que lo validamos aquí.
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  conventional:
+    name: Título convencional
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            perf
+            refactor
+            style
+            docs
+            test
+            build
+            ci
+            chore
+            revert
+          requireScope: false

pyzed_ui-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,202 @@
+name: Release
+
+# Se dispara al empujar un tag vX.Y.Z (o vX.Y.Z-rc.N, -beta.N, ... para
+# pre-releases). Compila wheels y sdist, los prueba, publica en PyPI con
+# Trusted Publishing, crea la GitHub Release con sus notas y actualiza
+# CHANGELOG.md en main y redespliega la web de documentación.
+on:
+  push:
+    tags: ["v[0-9]+.[0-9]+.[0-9]+*"]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Tag existente a (re)publicar, p. ej. v0.2.0
+        required: true
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  TAG: ${{ inputs.tag || github.ref_name }}
+
+jobs:
+  meta:
+    name: Verificar versión
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.meta.outputs.tag }}
+      prerelease: ${{ steps.meta.outputs.prerelease }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ env.TAG }}
+      - id: meta
+        name: El tag coincide con Cargo.toml
+        run: |
+          version=$(sed -n 's/^version = "\(.*\)"$/\1/p' Cargo.toml | head -n1)
+          if [ "v$version" != "$TAG" ]; then
+            echo "::error::El tag $TAG no coincide con la versión de Cargo.toml ($version)"
+            exit 1
+          fi
+          case "$version" in
+            *-*) prerelease=true ;;
+            *) prerelease=false ;;
+          esac
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+          echo "prerelease=$prerelease" >> "$GITHUB_OUTPUT"
+
+  wheels:
+    name: Wheel ${{ matrix.name }}
+    needs: meta
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: true
+      matrix:
+        include:
+          - { name: linux-x86_64, runner: ubuntu-latest, target: x86_64, test: true }
+          - { name: linux-aarch64, runner: ubuntu-24.04-arm, target: aarch64, test: true }
+          - { name: macos-arm64, runner: macos-latest, target: aarch64-apple-darwin, test: true }
+          - { name: macos-x86_64, runner: macos-latest, target: x86_64-apple-darwin, test: false }
+          - { name: windows-x64, runner: windows-latest, target: x64, test: true }
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.meta.outputs.tag }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: "2_28"
+      - name: Test the wheel
+        if: matrix.test
+        shell: bash
+        run: |
+          python -m pip install pytest
+          python -m pip install --no-index --find-links dist pyzed-ui
+          python -m pytest -q tests
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ matrix.name }}
+          path: dist/*.whl
+
+  sdist:
+    name: sdist
+    needs: meta
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.meta.outputs.tag }}
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-sdist
+          path: dist/*.tar.gz
+
+  pypi:
+    name: Publicar en PyPI
+    needs: [meta, wheels, sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/pyzed-ui/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          merge-multiple: true
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+  github-release:
+    name: GitHub Release
+    needs: [meta, pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.meta.outputs.tag }}
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          merge-multiple: true
+          path: dist
+      - name: Crear la release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PRERELEASE: ${{ needs.meta.outputs.prerelease }}
+        run: |
+          python -m pip install git-cliff
+          python scripts/changelog.py --notes "$TAG" > notes.md
+          printf '\n\n```\npip install pyzed-ui==%s\n```\n' "${TAG#v}" >> notes.md
+          flags=(--title "$TAG" --notes-file notes.md --verify-tag)
+          if [ "$PRERELEASE" = true ]; then flags+=(--prerelease --latest=false); else flags+=(--latest); fi
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            gh release upload "$TAG" dist/* --clobber
+            gh release edit "$TAG" --notes-file notes.md
+          else
+            gh release create "$TAG" dist/* "${flags[@]}"
+          fi
+
+  changelog:
+    name: Actualizar CHANGELOG y docs
+    needs: [meta, github-release]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Añadir la versión a CHANGELOG.md
+        run: |
+          python -m pip install git-cliff
+          python scripts/changelog.py --update "$TAG"
+      - name: Commit en main
+        run: |
+          if git diff --quiet -- CHANGELOG.md; then
+            echo "CHANGELOG.md ya estaba al día"
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add CHANGELOG.md
+          git commit -m "chore(release): changelog $TAG"
+          git push origin HEAD:main
+      - name: Redesplegar la web de documentación
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          # Ni el push ni la release hechos con GITHUB_TOKEN disparan otros
+          # workflows, así que lanzamos el de la web explícitamente (si existe).
+          if gh workflow view docs.yml >/dev/null 2>&1; then
+            gh workflow run docs.yml --ref main
+          else
+            echo "No hay workflow docs.yml todavía; nada que redesplegar."
+          fi

pyzed_ui-0.2.0/.gitignore

@@ -0,0 +1,9 @@
+/target
+__pycache__/
+*.py[cod]
+*.so
+*.pyd
+.venv/
+dist/
+*.egg-info/
+.pytest_cache/

pyzed_ui-0.2.0/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+Todos los cambios relevantes de Pyzed se registran aquí. El formato sigue
+[Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y el proyecto usa
+[versionado semántico](https://semver.org/lang/es/).
+
+Cada versión es un encabezado `## [X.Y.Z] - AAAA-MM-DD` con las secciones que apliquen:
+`### Breaking changes`, `### Añadido`, `### Cambiado`, `### Corregido`, `### Eliminado`.
+Las versiones con sufijo (`1.0.0-rc.1`, `0.2.0b1`) se consideran preliminares.
+La web de documentación lee este archivo en cada build y marca la última versión estable.
+
+## [Sin publicar]
+
+## [0.2.0] - 2026-10-18
+
+Primera versión publicada en PyPI como `pyzed-ui`.
+
+### Breaking changes
+
+- `App.run()` lanza un error si se llama por segunda vez en el mismo proceso.
+
+### Añadido
+
+- Varias ventanas por app: abrir y cerrar ventanas extra, hooks y comandos de ventana (`Window`).
+- Soporte async: corrutinas, generadores y generadores async desde `update` o `Command.perform`.
+- Suscripciones: temporizadores con `pz.every` y flujos con `pz.listen`.
+- Widgets nuevos: `image` (mapas de bits), `image_viewer`, `canvas` con `pz.draw`, `rich_text`, `markdown`, `qr_code`, `pick_list`, `radio`, `split`, `pin`, `grid` y `responsive`; degradados y más opciones de estilo.
+- Componentes nuevos en `pyzed.ui`: `select`, `radio_group`, `number_field`, `split_button`, `chip`, `disclosure`, `callout`, `table`, `facepile`, `diff_stat`, gráficos, `spinner`, `popover`, `markdown`, `split` y `stat`.
+- Theming: importar temas de Zed, temas Ayu, Gruvbox y One incluidos, `Theme.generate()` y cambio automático entre claro y oscuro.
+- Editor: scroll horizontal con el margen de números fijo, números de línea correctos con `wrap`, línea activa, autoscroll del cursor y PageUp/PageDown.
+- Ejemplos basados en las demos de Iced (todos, game of life, reloj, cronómetro, descargas, websocket, varias ventanas, visor de imágenes, markdown, QR, estilos, menú contextual, paneles) y un tutorial de cinco pasos.
+- Web de documentación con guías, tutoriales, referencia de la API e ilustraciones de componentes.
+- Workflows de CI y de release: wheels para Linux, macOS y Windows publicados en PyPI.
+
+### Corregido
+
+- Las imágenes se recortan y redondean bien en todos los renderizadores, también en las capturas sin GPU.
+
+## [0.1.0] - 2026-10-18
+
+Primera versión.
+
+### Añadido
+
+- Runtime al estilo Elm sobre Iced 0.14 (`App`, `update`, `view`, `on_start`, `on_key`).
+- Mensajes como cualquier valor de Python o como callables que se llaman directamente.
+- `Command`: `exit`, `focus`, `set_editor_text`, `set_editor_cursor`, `scroll_to_end`, `batch`, `message` y `perform` (trabajo en un hilo).
+- `pz.post()` para enviar mensajes desde otros hilos.
+- Widgets base: `text`, `column`, `row`, `container`, `center`, `button`, `text_input`, `scrollable`, `space`, `rule`, `mouse_area`, `stack`, `opaque`, `hover`, `tooltip`, `checkbox`, `toggler`, `slider`, `progress_bar`, `code_editor`, `svg` e `icon`.
+- Unos 40 componentes al estilo Zed en `pyzed.ui`: botones, formularios, listas, árbol de archivos, pestañas, workspace con docks, paleta de comandos, toasts, editor de código y terminal.
+- Temas One Dark, One Light y Gruvbox Dark con los tokens de color de Zed, y `Theme.derive()`.
+- Fuentes IBM Plex e iconos Lucide incluidos.
+- Capturas fuera de pantalla con `app.screenshot()` (sin GPU ni display).
+- CLI: `pyzed new` y `pyzed icons`.