vueuse-math-skilld
Skill184 starsChanged 37 days agoMITView on GitHub
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.
- Installs packages
In this repository35 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- floating-ui-vue-skilldSkill
- formkit-core-skilldSkill
- motion-v-skilldSkill
- pinia-colada-skilldSkill
- pinia-skilldSkill
- primevue-skilldSkill
- quasar-skilldSkill
- reka-ui-skilldSkill
- shadcn-vue-skilldSkill
- slidev-cli-skilldSkill
- tanstack-ai-vue-skilldSkill
- tanstack-vue-form-skilldSkill
- tanstack-vue-query-skilldSkill
- tanstack-vue-router-skilldSkill
- tanstack-vue-store-skilldSkill
- tanstack-vue-table-skilldSkill
- tanstack-vue-virtual-skilldSkill
- tresjs-core-skilldSkill
- unhead-vue-skilldSkill
- unovis-ts-skilldSkill
- unovis-vue-skilldSkill
- vee-validate-skilldSkill
- vitepress-skilldSkill
- vue-data-ui-skilldSkill
- vue-i18n-skilldSkill
- vue-router-skilldSkill
- vue-skilldSkill
- vue-test-utils-skilldSkill
- vuetify-skilldSkill
- vueuse-components-skilldSkill
- vueuse-core-skilldSkill
- vueuse-integrations-skilldSkill
- vueuse-motion-skilldSkill
- vueuse-shared-skilldSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 0 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 43
Read-only clamp; pass a getter or readonly ref (dist/index.js:113):
- Very specific: line 87
Never use the aliases and, or, not.
- Very specific: line 94
Prefer these composables over computed(() => Math.x(...)) in templates and watchers.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
@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 10Read-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.15Combine 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).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

