feat(useMin): new function

packages/math/index.ts

@@ -6,5 +6,6 @@ export * from './logicOr'
 export * from './useCeil'
 export * from './useClamp'
 export * from './useFloor'
+export * from './useMinimum'
 export * from './useProjection'
 export * from './useRound'

packages/math/useMinimum/demo.vue

@@ -0,0 +1,33 @@
+<script setup lang="ts">
+import { ref } from 'vue'
+import { useMinimum } from '@vueuse/math'
+const min1 = ref(10)
+const min2 = ref(20)
+const result = useMinimum(min1, min2)
+</script>
+
+<template>
+  <div>
+    <div>
+      min1:
+      <input v-model="min1" type="number">
+      <button @click="min1--">
+        min1 -= 1
+      </button>
+      <button @click="min1++">
+        min1 += 1
+      </button>
+    </div>
+    <div>
+      min2:
+      <input v-model="min2" type="number">
+      <button @click="min2--">
+        min2 -= 1
+      </button>
+      <button @click="min2++">
+        min2 += 1
+      </button>
+    </div>
+    result:{{ result }}
+  </div>
+</template>

packages/math/useMinimum/index.md

@@ -0,0 +1,20 @@
+---
+category: '@Math'
+---
+
+# useMinimum
+
+Reactively get minimum of values.
+
+## Usage
+
+```ts
+import { useMinimum } from '@vueuse/math'
+
+const min1 = ref(10)
+const min2 = ref(20)
+const result = useMinimum(min1, min2)
+// result.value is 10
+min2.value = 5
+// result.value is 5 now
+```

packages/math/useMinimum/index.test.ts

@@ -0,0 +1,44 @@
+import { ref } from 'vue-demi'
+import { useMin, useMinimum } from '.'
+
+describe('useClamp', () => {
+  it('should be defined', () => {
+    expect(useMin).toBeDefined()
+    expect(useMinimum).toBeDefined()
+  })
+
+  it('should accept numbers', () => {
+    const v = useMinimum(0, 100)
+    expect(v.value).toBe(0)
+  })
+
+  it('should accept refs', () => {
+    const value1 = ref(10)
+    const value2 = ref(100)
+    const value3 = ref(1000)
+
+    const v = useMinimum(value1, value2, value3)
+    expect(v.value).toBe(10)
+
+    value1.value = 9
+    expect(v.value).toBe(9)
+
+    value2.value = 8
+    expect(v.value).toBe(8)
+
+    value3.value = 7
+    expect(v.value).toBe(7)
+  })
+
+  it('should accept numbers and refs', () => {
+    const value1 = 10
+    const value2 = ref(100)
+
+    const v = useMinimum(50, value1, value2)
+
+    expect(v.value).toBe(10)
+
+    value2.value = 9
+    expect(v.value).toBe(9)
+  })
+})

packages/math/useMinimum/index.ts

@@ -0,0 +1,18 @@
+import { computed } from 'vue-demi'
+import type { MaybeComputedRef } from '@vueuse/shared'
+import { resolveUnref } from '@vueuse/shared'
+
+/**
+ * Reactively get minimum of values.
+ *
+ * @see https://vueuse.org/useMinimum
+ * @param values
+ */
+export function useMinimum(...mins: MaybeComputedRef<number>[]) {
+  return computed<number>(() =>
+    Math.min(...mins.map(value => resolveUnref(value))),
+  )
+}
+
+// alias
+export { useMinimum as useMin }