vueuse-math-skilld
Math composables for Vue 3 from @vueuse/math. Use when writing or debugging code that imports "@vueuse/math", or when clamping, projecting, rounding, averaging, summing, or combining reactive numbers in Vue.
How do I install this agent skill?
npx skills add https://github.com/skilld-dev/vue-ecosystem-skills --skill vueuse-math-skilldIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides documentation and usage examples for the @vueuse/math library, a set of reactive math composables for Vue 3. The analysis found no security issues or malicious patterns.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
@vueuse/math 15.0.0
Reactive math for Vue 3. Every composable resolves inputs with toValue inside a computed, so arguments accept plain numbers, refs, or getters (MaybeRefOrGetter<number>), and the result is a ComputedRef<number> that tracks every input (dist/index.js:70-71). The one exception: useClamp with a mutable ref returns a writable computed (dist/index.d.ts:83).
Environment
- Install:
npm i @vueuse/math @vueuse/core(README.md:10).@vueuse/coreis needed only when combining with core functions such aswhenever. - Vue
^3.5.0peer dependency (package.json:42), minimum since v14. - Node.js
>= 22(package.json:39); v15 dropped Node.js 20 (release). - ESM-only since v13:
"type": "module", no CommonJS build (package.json:3; release). Use dynamicimport()if a CJS context must load it. "sideEffects": false(package.json:24): unused composables tree shake away.- Runtime dependency:
@vueuse/shared@15.0.0(package.json:45), which suppliesclampandreactify. - Entry
dist/index.js, typesdist/index.d.ts(package.json:30,34).
Exports
From dist/index.d.ts:167:
- Functions:
createGenericProjection,createProjection,logicAnd,logicNot,logicOr,useAbs,useAverage,useCeil,useClamp,useFloor,useMath,useMax,useMin,usePrecision,useProjection,useRound,useSum,useTrunc - Types:
ProjectorFunction,UseProjection,UseMathKeys,UseMathReturn,UsePrecisionOptions - Deprecated aliases:
and,or,not(dist/index.d.ts:20-21,32-33,44-45)
Signatures, behavior notes, and per-function examples: references/api.md. Version-specific changes: references/migrations.md.
Common tasks
Writable clamped state; pass a mutable ref so assignments are clamped automatically:
import { useClamp } from '@vueuse/math'
const level = ref(0)
const clamped = useClamp(level, 0, 10)
clamped.value = 15 // clamped.value and level.value are 10
Read-only clamp; pass a getter or readonly ref (dist/index.js:113):
const ratio = useClamp(() => raw.value / total.value, 0, 1)
Aggregate fixed refs with rest arguments instead of building an array (dist/index.d.ts:154-155):
const total = useSum(refA, refB, refC)
const peak = useMax(refA, refB, refC)
Map a value between domains, for sliders, charts, or progress UIs:
const progress = useProjection(scrollY, [0, pageHeight], [0, 100])
Reuse one projection across components; domains may be reactive:
const toPercent = createProjection(domain, [0, 100])
const a = toPercent(inputA)
Round to decimal places and keep a number, not the string toFixed returns:
const price = usePrecision(ref(3.1415), 2) // 3.14
const up = usePrecision(ref(3.1415), 2, { math: 'ceil' }) // 3.15
Combine boolean flags reactively, then feed side effects to whenever from @vueuse/core:
import { whenever } from '@vueuse/core'
import { logicAnd } from '@vueuse/math'
whenever(logicAnd(ready, hasData), run)
Rules and pitfalls
- Never use the aliases
and,or,not; deprecated since v14 in favor oflogicAnd,logicOr,logicNot(dist/index.d.ts:20,32,44; release). useAveragedivides byarray.lengthwith no empty check: empty input yieldsNaN(dist/index.js:91-96). Guard the empty case yourself.useMax()with no inputs resolves to-InfinityanduseMin()toInfinity, because both spread intoMath.max/Math.min(dist/index.js:157-176).- Aggregations (
useSum,useAverage,useMin,useMax) accept refs, getters, numbers, arrays of those, and flatten nested arrays one level viatoValueArgsFlat(dist/index.js:75-81). usePrecisionavoids float drift by scaling through the decimal string of the value (accurateMultiply,dist/index.js:187-193);options.mathdefaults to'round'(dist/index.d.ts:122).useMathaccepts onlyMathkeys that are functions, such as'pow'or'sqrt', never constants likePI(dist/index.d.ts:96).- Projection is linear by default:
(input - from[0]) / (from[1] - from[0]) * (to[1] - to[0]) + to[0](dist/index.js:12-14). For non-linear mapping (log scales, easing), pass a customprojector, or usecreateGenericProjectionfor non-number domains (dist/index.d.ts:4-6). - Prefer these composables over
computed(() => Math.x(...))in templates and watchers; they centralize theMathcall, stay reactive to every argument, and carry@__NO_SIDE_EFFECTS__annotations for tree shaking (dist/index.js:4,15,111).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/skilld-dev/vue-ecosystem-skills/vueuse-math-skilld">View vueuse-math-skilld on skillZs</a>