Composables e utilitários

springs

Composable / módulo

Utilitários de mola amortecida, sem DOM: um passo de integração (`springStep`), presets (`snappy`, `bouncy`, `critical`) e leituras visuais derivadas do progresso.

Importação
import { springStep, zetaFromBounce, springReadings } from 'vueui-nova-kit'

Uso

Para animar um número reativo na interface, prefira useSpringValue, que já chama springStep a cada frame e respeita prefers-reduced-motion. Esta API serve quando você mesmo conduz o loop ou precisa dos presets/leituras.

Exemplo
import { springStep, SPRING_PRESETS } from 'vueui-nova-kit'

let value = 0
let velocity = 0
const target = 1
function tick() {
  const step = springStep(value, target, velocity, 180, 18)
  value = step.value
  velocity = step.velocity
}

Retorno

NomeTipoDescrição
springStep(current, target, velocity, stiffness?, damping?, dt?) => { value, velocity }Avança um frame da mola amortecida.
SPRING_PRESETS{ snappy, bouncy, critical }Presets com visualDuration e bounce.
zetaFromBounce(bounce: number) => numberConverte bounce no fator de amortecimento ζ.
springReadings(t, doneOpacity?, strikeLag?) => leituras visuaisEscala, opacidade e offset derivados do progresso da mola.

Demo

Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.

API

SpringConfig
ts
export interface SpringConfig {
  visualDuration: number
  bounce: number
}
SPRING_PRESETS

Presets snappy, bouncy e critical (visualDuration e bounce).

ts
SPRING_PRESETS = { snappy: { visualDuration: 0.16, bounce: 0.1 }, bouncy: { visualDuration: 0.2, bounce: 0.35 }, critical: { visualDuration: 0.24, bounce: 0 }, } as const satisfies Record<string, SpringConfig>
springStep

Um passo de mola amortecida (sem dependências externas).

ts
springStep(current: number, target: number, velocity: number, stiffness = 180, damping = 18, dt = 1 / 60): { value: number; velocity: number }
zetaFromBounce

Converte o bounce de um preset no amortecimento ζ.

ts
zetaFromBounce(bounce: number): number
springReadings

Leituras visuais (fillScale, boxScale, tickOffset, wordOpacity, ruleScale) a partir do progresso t.

ts
springReadings(t: number, doneOpacity = 0.62, strikeLag = 0.12): { fillScale: number boxScale: number tickOffset: number wordOpacity: number ruleScale: number }

Fonte: src/motion/springs.ts