API

• createMotionInspector: inspección de desarrollo opcional, lotes nativos, propiedad, gráficos vinculantes y ajuste de resorte reproducible.

Animando

• recordInteraction / replayInteraction: seguimientos de desarrollo opcionales, reproducción de reloj controlado y sondas de regresión nativas. Disponible desde beta.18.
• sharedLayout(container, options): identidades compartidas opcionales en la misma página, instantáneas nativas, fundidos cruzados e interrupciones. Disponible desde beta.18.
• sharedNavigationEntry(frame, options): devolución de tarjeta/imagen nativa interactiva en páginas estables iOS y Android 14+. Disponible desde rc.1.
• resolveListTarget(context, options): resolución de celda actual limitada por clave estable para retorno compartido después de reciclar, desplazarse o reordenar. Disponible desde rc.1.
• entry.returnToSource(options?): devuelve una pose de fotografía retenida a través de la resolución de la celda actual, llevando la velocidad de traducción y el recorte de la ventana gráfica al vuelo nativo.
• sharedNavigation(frame, options): movimiento nativo opcional de imagen/tarjeta a través de rutas programáticas, etiquetas con alcance y respaldo limitado. Disponible desde rc.1.
• interactiveNavigation(frame, options): transiciones nativas de página con desplazamiento de borde iOS con cancelación, finalización de resorte con reconocimiento de velocidad e historial de núcleo/enrutador. Disponible desde rc.1.
• predictiveBack(view, values, options) — Progreso de retroceso del sistema nativo Android 14+, cancelación de resorte y un compromiso protegido. Disponible desde rc.1.
• animate(target, keyframes | preset, transition?) — caminos, colores, esquinas, bordes y sombras
• interactionSurface(target): opte por la geometría táctil nativa para un subárbol animado.
• animateLayout(container, change?, options?) — anima el siguiente diseño de los hijos directos de un contenedor.
• animateSize(view, dimensions, change?, options?) — anima el ancho/alto/automático real con reflujo de texto, pausa/reanudación y propiedad del alcance; realiza el diseño JS por cuadro.
• motionScope(): identificadores de animación propios, suscripciones y ciclo de vida de componentes.
• motionStates(targets, definitions, options?) — estados visuales con nombre coordinados e interrumpibles; attach() y ref() los mantiene en las vistas que se recrean y se puede realizar una transición diferenciar objetivos.
• motionValue(initial), bind(target, bindings) — un valor que impulsa varias propiedades y vistas; animate(), set() y stop() también toman un valor. scrollValue(scrollView, { axis? }) es un desplazamiento de desplazamiento como valor.
• springValue(source, options?): seguidores nativos retenidos con continuidad de posición/velocidad, cadenas nativas, asignaciones numéricas y capas de transformación/opacidad. Disponer de la suscripción con su ámbito de propiedad.
• gestures(surface, options?) y GestureSurface: panorámica/pellizco/rotación nativa, relaciones de derivación y transferencia central ScrollView, desde el punto de entrada opcional @rafaelaugusto/jolt/gestures.
• bottomSheet(panel, options): hoja en página opcional con transferencia de desplazamiento nativo, instantáneas dinámicas, seguimiento del teclado y acciones accesibles.
• reorder(list, options): reordenamiento opcional de Core ListView plano con teclas estables, alturas variables, desplazamiento de borde nativo y movimientos de teclado/accesibilidad.
• value.subscribe(listener, { immediate? }) — observar números, colores derivados y valores de desplazamiento en JavaScript; devuelve darse de baja.
• animate(value, target, { layer }), stop(value, { layer }) — capas escalares aditivas antes de las asignaciones.
• animate(target, { y }, { type: 'gravity' }) — caída balística y rebote hasta un aterrizaje fijo.
• decay(target, velocity, options?)
• gradient(target, options) — gradientes nativos lineales, radiales y cónicos con componentes mixtos de valor estático/de movimiento (GradientBindings); devuelve un Gradient con bind(), animate(), set(), stop(), suspend(), resume(), suspended y remove(). motionScope().gradient() and v-gradient lo posee para un alcance o una plantilla.
• stop(target, properties?)
• set(target, values) — aplica valores a la vez y detiene lo que los anima.
• playbackProgress(animation): progreso observable y de solo lectura en el reloj de una animación existente.
• timeline(steps): pausa y reanuda los pasos activos y pendientes juntos.
• @rafaelaugusto/jolt/native — registro de propiedad opcional, mapas nativos y cámaras SceneKit, luces y materiales y cámara FOV.
• sequence(steps) — pasos superpuestos y posiciones fijas.
• press(target, pressed?, transition?)
• drag(target, options?) — con value, el gesto controla un valor de movimiento en lugar de la vista.
• physicsWorld(container, bodies, options) — colisiones de círculos nativos, arrastrar/liberar y propiedad del ciclo de vida.
• shape(): dibujo de trazo SVG nativo y transformación de ruta coincidente.
• blur(): anima una cantidad de desenfoque nativa propia.
• GlassContainer / GlassView — fusión nativa iOS 26 Liquid Glass utilizando la reproducción de transformación existente.
• world.attach() / world.snapTo() — resortes de anclaje nativos y puntos de liberación.
• sensor(kind, options): fuentes nativas opcionales de rotación/gravedad para valores de movimiento, fijaciones y resortes.
• scrollHeader(list, options) — Composición nativa de Core ListView: héroe medido, paralaje, transferencia de título, sección fijada y anclajes de elementos estables.
• scrollLinked(scrollView, target, keyframes, { range, axis? }) — devuelve una función de limpieza.
• animateItems(list, keyframes | preset, options?) — filas tal como aparecen, con once; devuelve una función de limpieza.
• followKeyboard(target, options?) — mueve una vista con el teclado en iOS y Android 7+; devuelve una función de limpieza.
• onKeyboard(callback) — qué parte de la ventana cubre el teclado, con su sincronización; devuelve una función de limpieza.
• symbolEffect(image, effect, options?) — iOS SF Symbols.
• shimmer(target, options?) — iOS cargando marcadores de posición; devuelve una función de limpieza.
• liquid(image, options?) — iOS deformación de textura; devuelve un LiquidEffect con pause(), resume() y stop().
• imageEffect(image, name, options?) — ondulación nativa, distorsión táctil y disolución determinista; controles de reproducción y respaldo de compatibilidad explícito.
• zoomable(image, options?): pellizco de foto nativo, zoom con doble toque, panorámica limitada e intentos de descarte opcionales.
• loader(target, options?) — iOS indicadores de puntos, barras y anillos; devuelve una función de limpieza.
• reveal(target, options?), conceal(target, options?) — iOS transiciones de visibilidad circular; devolver un Animation.
• animateText(label, options?) — entradas letra por letra o palabra por palabra en iOS y Android; devuelve un Animation.
• animateText(label, options?) — iOS entradas letra por letra o palabra por palabra; devuelve un Animation.
• rollTo(label, value, options?) — dígitos continuos en iOS y Android; devuelve un Animation.
• confetti(target, options?), particles(target, options?) — efectos de partículas nativas iOS/Android; funciones de limpieza de retorno. Sin simulación JS ni devolución de llamada de pintura por cuadro; El dibujo Android comparte el hilo de la interfaz de usuario.

target es una vista o cualquier cosa que contenga una (una referencia de plantilla, un ElementRef). animate(), decay(), stop(), set() y los pasos de secuencia también aceptan matrices de objetivos.

Las opciones animate() también aceptan haptic: light, medium, heavy, { style, times } o false. Los comentarios son compatibles con iOS y Android, respetando la configuración del dispositivo.

Animaciones

Lo que devuelve animate(), decay(), sequence() y los pasos de una secuencia: await it, lee finished, o llama a stop(). Se resuelve con true cuando se reproduce hasta el final y false cuando se detiene o toma el control, y la cancelación nunca rechaza. Los errores de configuración de secuencia/devolución de llamada pueden rechazar finished después de cancelar su otro trabajo.

animate() y decay() devuelven PlaybackAnimation: el ciclo de vida base más pause(), play(), progress grabable y paused/duration de solo lectura. Los controladores de secuencia y efecto mantienen el contrato base Animation.

Transiciones

• Resortes: 'smooth' | 'snappy' | 'bouncy', { bounce, duration, velocity } o { stiffness, damping, mass, velocity }.
• Preadolescentes: { duration, ease, times, easeTrack }.
• Sincronización: delay, repeat, repeatType: 'loop' | 'reverse', repeatDelay, stagger: number | { each, from }.
• Capas: layer: 'name' se reproduce encima de otras animaciones de la propiedad; stop(target, properties, { layer }) detiene una capa.
• Por propiedad: cualquier nombre de propiedad asignado a su propia transición.
• Fotogramas clave relativos: { relative: true } agrega desplazamientos de traslación/rotación y multiplica escala/opacidad por sus valores iniciales.

Ayudantes

definePreset(name, preset), presets, springs, origamiSpring({ friction, tension }), cubicBezier. Consulte ajustes preestablecidos personalizados para obtener información sobre el registro y los nombres escritos.

Vue

@rafaelaugusto/jolt/vue es un punto de entrada independiente para NativeScript-Vue 3: vAnimate (v-animate), vPress (v-press), JoltTransition, transitionHooks(props), useMotionScope(), useReducedMotion(), useKeyboard(), useMotionValue(), useBinding(), useScrollValue() y install(app), también la exportación predeterminada para app.use(). Tipos: AnimateValue, PressValue, TransitionProps. Ver el Guía Vue.

Tipos

Step, SequenceOptions, SequencePosition, JoltConfig, KeyframeProperty, ScrollLinkedOptions, KeyboardOptions, ItemsOptions, ColorValue, ColorKeyframes, Keyframes, Transition, Spring, Tween, Preset, Presets, PresetName, SpringName, Easing, Animation, Target, DecayVelocity, DecayOptions, SymbolEffect, SymbolEffectName, SymbolEffectOptions, ShimmerOptions, LiquidOptions, LiquidEffect, LoaderOptions, LoaderStyle, TextOptions, RollOptions, RevealOptions, ConcealOptions, Haptic, HapticOptions, HapticStyle, ConfettiOptions, ParticleOptions y el resto exportados del paquete. configure({ timeScale }) establece la velocidad de reproducción global para las animaciones iniciadas posteriormente. configure({ timeScale, reducedMotion }) establece la velocidad de reproducción global y la preferencia de movimiento reducido ('user', 'always' o 'never') para las animaciones iniciadas posteriormente. reducedMotion() and onReducedMotion(callback) lee y observa esa preferencia.

Tipos

• SceneKit entorno y entradas de sombreado — iluminación nativa y uniformes escalares/vectoriales tipificados.