# Estabilidad y limitaciones conocidas

> Qué promete Pyzed 1.x sobre su API de Python, cómo se retiran funciones de una versión a otra y qué no hace todavía el framework.

Source: https://albakore.github.io/pyzed/es/guides/stability/

## Versiones

Desde la 1.0.0, Pyzed sigue el [versionado semántico](https://semver.org/lang/es/):

- Las versiones **patch** (`1.0.x`) solo corrigen errores.
- Las versiones **minor** (`1.x.0`) añaden funciones y nunca rompen el código que usa la API pública.
- Las versiones **major** (`2.0.0`) son las únicas que pueden quitar o cambiar API pública.

La API pública es todo lo documentado en la [referencia de la API](https://albakore.github.io/pyzed/es/reference/app/) y en estas guías. Los
nombres que empiezan con guion bajo y todo lo que está en `pyzed.designer` son internos y pueden cambiar en
cualquier versión.

`pyzed.agents`, `pyzed.mcp` y la API de animaciones son **provisionales** en 1.x: siguen las mismas reglas, pero
una versión minor todavía puede ajustar detalles que resulten equivocados, y el cambio siempre aparece en
*Breaking Changes* en las [notas de versión](https://albakore.github.io/pyzed/es/changelog/).

## Deprecaciones

Antes de quitar API pública, sigue funcionando al menos durante una versión minor y avisa con un
`DeprecationWarning` que nombra su reemplazo. Se quita en la siguiente versión major.

Los archivos de Pyzed Design (`.pzform` y componentes) llevan una versión de formato. Pyzed abre los de su
versión y anteriores, y rechaza un archivo guardado por un Pyzed más nuevo en lugar de perder en silencio lo que
no conoce.

## Limitaciones conocidas

| Área | Limitación |
| --- | --- |
| Accesibilidad | Todavía no hay soporte para lectores de pantalla, y el foco solo pasa de un campo a otro desde el código (`Command.focus`), no con Tab. |
| Efectos | `glass`, `bloom` y `glow` se dibujan con degradados y sombras: no se desenfoca lo que hay detrás de un panel. |
| Animaciones | Se pueden animar 11 propiedades (opacidad, posición, escala, colores, radio, grosor del borde y glow); el tamaño, la rotación y el padding no. |
| Muchos datos | Las listas y tablas virtuales necesitan filas de la misma altura. Cada actualización sigue llamando a `view()`; [`@pz.memo`](https://albakore.github.io/pyzed/es/guides/performance/) se salta los subárboles que no cambiaron. |
| Plataformas | En Linux los wheels necesitan glibc 2.28 o posterior, o musl (Alpine), donde el motor de audio no tiene dispositivos de sonido. Las builds de Pyzed Design todavía no están firmadas. |
| Python | Python free-threaded (3.13t, 3.14t) no está soportado. Pyzed necesita Python 3.10 o posterior. |