Ir al contenido

Actualización

Actualiza paquetes compatibles y revisa las notas de migración.

La versión experimental 0.1.0-alpha.2 está disponible en npm. Consulta las versiones exactas en la guía de instalación.

Todos los paquetes públicos @domfx comparten una versión, así que usa la misma versión de todos los paquetes @domfx. Un paquete puede recibir una versión nueva sin cambios propios. Consulta los registros de cambios, las notas de publicación y el rango de peerDependencies del adaptador GSAP.

Fija las versiones que verificaste y guarda el archivo de bloqueo de dependencias en el control de versiones. Actualiza el adaptador GSAP opcional cuando sea necesario; los efectos independientes no dependen de él. Reinstala y ejecuta la compilación y las comprobaciones de tipos de tu aplicación.

Las etiquetas de npm pueden cambiar; latest no garantiza una API estable. Fija versiones exactas en lugar de depender de una etiqueta que puede cambiar. Durante 0.x, los cambios incompatibles requieren una versión menor con notas de migración explícitas. Las API alfa pueden cambiar; un parche compatible debe conservar el contrato documentado. Desde 1.0.0-beta.0, se aplica la política de estabilidad.

Prueba tu objetivo y línea de tiempo: avance y retroceso, selección de texto y controles originales, comportamiento con movimiento reducido o efectos no disponibles, actualización de captura, desmontaje y nuevo montaje. Elimina efectos y enlaces obsoletos antes de crear sustitutos. Corrige la condición de indisponibilidad antes de reintentar explícitamente; no añadas otro enlace para recuperar el efecto.

Conserva el archivo de bloqueo anterior para volver a las versiones previas. Si falla una actualización, informa de versiones de paquetes, entorno, código de motivo y mensaje de diagnóstico junto con un ejemplo mínimo reproducible. Consulta solución de problemas.

Desde 1.0.0-beta.0, la API pública queda congelada. El contrato estable cubre:

  • todas las exportaciones de @domfx/browser, @domfx/core y @domfx/gsap: nombres, tipos y firmas;
  • el comportamiento documentado: rangos y valores predeterminados de las opciones, qué entradas lanzan un error y cuál, los estados de lifecycle, los códigos de reason, los códigos de CaptureError, ready, refresh(), retry(), dispose() y cómo avanzan y retroceden los enlaces GSAP.

No cubre @domfx/browser/experimental, los píxeles exactos ni el ajuste visual, las cifras de rendimiento o memoria, el lienzo del efecto y sus atributos, el texto de reasonDetail, la salida de diagnóstico ni nada sin documentar. Los cambios en la apariencia predeterminada de un efecto se indican en el registro de cambios.

Durante la beta, la API congelada solo cambia para corregir un defecto del contrato. Cada cambio de este tipo incluye una nota de migración y, cuando sea posible, una obsolescencia previa. Desde 1.0.0, los cambios incompatibles solo llegan en una versión mayor.

Una API obsoleta se marca con @deprecated, así que los editores la muestran tachada, y aparece con su sustituta en el registro de cambios y en esta página. Sigue funcionando sin cambios durante al menos una versión menor y hasta la siguiente versión mayor, que la elimina. domfx no muestra avisos de obsolescencia en tiempo de ejecución.

Una versión menor puede añadir valores a EffectReason, CaptureErrorCode y EffectName. Trata los valores desconocidos con una rama predeterminada. Un switch exhaustivo de TypeScript que asigna el valor a never puede dejar de compilar tras una versión así; es lo esperado, no un cambio incompatible. Eliminar o renombrar un valor sí es incompatible.

La próxima versión elimina dos opciones. Ambas lanzan un error al crear el efecto en JavaScript y no superan la comprobación de tipos en TypeScript.

  • clock: 'ambient': usa clock: 'auto', que tiene el mismo comportamiento temporal. El valor antiguo lanza invalid-clock-mode.
  • flameHeight de Fire: omítelo para usar la apariencia predeterminada, que es el antiguo valor predeterminado de 24, o usa flameReach para dimensionar las llamas en relación con el objetivo. Ya no es posible usar llamas con un tamaño personalizado en píxeles. La opción antigua lanza invalid-fire-parameter.

El tamaño relativo está disponible en 0.1.0-alpha.2. Elige los campos de la referencia de tu efecto. Omitirlos conserva la apariencia predeterminada. En las opciones emparejadas, la que omitas vale cero.

En el modo relativo, la intensidad cambia la fuerza visual sin cambiar el alcance ni la profundidad configurados. Las opciones de tamaño se fijan al crear el efecto: libera la instancia y crea otra para cambiarlas. Revisa sus límites de captura antes de cambiar de modo.

Slime también ofrece dripDensity (0–1, valor predeterminado 0.56). Los valores más altos añaden más gotas sin cambiar su tamaño, recorrido o ritmo. Se fija al crear el efecto y no activa el tamaño relativo por sí sola. Consulta las opciones de Slime.

Usa clock: 'auto' para la animación automática. El valor predeterminado sigue siendo 'manual' para el control externo.

La próxima versión elimina los enlaces con nombres Fire. Cambia bindFire por bindEffect, bindFireAsync por bindEffectAsync, FireBindingOptions por EffectBindingOptions, FireBinding por EffectBinding y AsyncFireBinding por AsyncEffectBinding. El comportamiento no cambia: los enlaces conservan los valores iniciales fijos, la interpolación lineal y los objetivos privados de animación. Consulta los enlaces con valores iniciales fijos.

Para encadenar animaciones GSAP, usa llamadas nativas a .to(effect, ...) para que cada segmento parta de los valores anteriores. Cambiar desde los enlaces modifica este comportamiento y permite que killTweensOf(effect) y la sobrescritura de propiedades actúen directamente sobre la instancia. Registra la limpieza antes de que termine la configuración; consulta la guía de GSAP.

La próxima versión reduce las exportaciones de captura.

  • captureElement y CaptureFrame: impórtalos desde @domfx/browser/experimental. Ya no se exportan desde @domfx/browser, y CaptureFrame ya no se exporta desde @domfx/core. @domfx/browser/experimental es inestable y puede cambiar en cualquier versión.
  • classifyAlpha: se eliminó de @domfx/core. Compara tú mismo el alfa de un fotograma: frame.pixels[index * 4 + 3] >= 128.
  • CaptureError y CaptureErrorCode: no cambian. refresh() sigue rechazando con CaptureError, así que comprueba su code.