Composables e utilitários
springs
Utilitários de mola amortecida, sem DOM: um passo de integração (`springStep`), presets (`snappy`, `bouncy`, `critical`) e leituras visuais derivadas do progresso.
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.
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
| Nome | Tipo | Descriçã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) => number | Converte bounce no fator de amortecimento ζ. |
springReadings | (t, doneOpacity?, strikeLag?) => leituras visuais | Escala, 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
SpringConfigexport interface SpringConfig {
visualDuration: number
bounce: number
}SPRING_PRESETSPresets snappy, bouncy e critical (visualDuration e bounce).
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>springStepUm passo de mola amortecida (sem dependências externas).
springStep(current: number, target: number, velocity: number, stiffness = 180, damping = 18, dt = 1 / 60): { value: number; velocity: number }zetaFromBounceConverte o bounce de um preset no amortecimento ζ.
zetaFromBounce(bounce: number): numberspringReadingsLeituras visuais (fillScale, boxScale, tickOffset, wordOpacity, ruleScale) a partir do progresso t.
springReadings(t: number, doneOpacity = 0.62, strikeLag = 0.12): { fillScale: number boxScale: number tickOffset: number wordOpacity: number ruleScale: number } Fonte: src/motion/springs.ts