From 790ef40254abe87b9cff2c852eadb8eb4e8c54e2 Mon Sep 17 00:00:00 2001
From: Anthony Fu <anthonyfu117@hotmail.com>
Date: Thu, 4 Aug 2022 12:16:50 +0800
Subject: [PATCH] fix(useToFixed): deprecated in favor of `usePrecision`

close #2015 close #2024
---
 packages/.vitepress/theme/components/FunctionBadge.vue | 10 ++++++++--
 packages/math/index.ts                                 |  1 +
 packages/math/useToFixed/index.md                      |  5 +++++
 packages/math/useToFixed/index.ts                      |  8 +++-----
 packages/metadata/scripts/update.ts                    |  2 +-
 5 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/packages/.vitepress/theme/components/FunctionBadge.vue b/packages/.vitepress/theme/components/FunctionBadge.vue
index f53aafa6aaf..8ef9ab725d8 100644
--- a/packages/.vitepress/theme/components/FunctionBadge.vue
+++ b/packages/.vitepress/theme/components/FunctionBadge.vue
@@ -29,8 +29,14 @@ const link = computed(() => {
 </script>
 
 <template>
-  <div text="sm" flex="~ gap1" items-center>
-    <a v-bind="link" bg="gray-400/5" p="x-1.5 y-0.5" class="rounded items-center" flex="inline gap-1 none" my-auto>
+  <div
+    text="sm" flex="~ gap1" items-center
+    :class="fn.deprecated ? 'op80 saturate-0' : ''"
+  >
+    <a
+      v-bind="link" bg="gray-400/5" p="x-1.5 y-0.5" class="rounded items-center" flex="inline gap-1 none" my-auto
+      :class="fn.deprecated ? 'line-through !decoration-solid' : ''"
+    >
       <span v-html="styledName(fn.name)" />
       <i v-if="fn.external" i-carbon-launch class="opacity-80 text-xs" />
     </a>
diff --git a/packages/math/index.ts b/packages/math/index.ts
index fe6d640723c..93b53308fab 100644
--- a/packages/math/index.ts
+++ b/packages/math/index.ts
@@ -11,6 +11,7 @@ export * from './useFloor'
 export * from './useMath'
 export * from './useMax'
 export * from './useMin'
+export * from './usePrecision'
 export * from './useProjection'
 export * from './useRound'
 export * from './useSum'
diff --git a/packages/math/useToFixed/index.md b/packages/math/useToFixed/index.md
index 7e7d7769a34..b5f633c628a 100644
--- a/packages/math/useToFixed/index.md
+++ b/packages/math/useToFixed/index.md
@@ -1,7 +1,12 @@
 ---
 category: '@Math'
+deprecated: true
 ---
 
+::: warning
+**Deprecated**. Please use `usePrecision` instead.
+:::
+
 # useToFixed
 
 Reactive `toFixed`.
diff --git a/packages/math/useToFixed/index.ts b/packages/math/useToFixed/index.ts
index 754864c3efc..0c015ae1750 100644
--- a/packages/math/useToFixed/index.ts
+++ b/packages/math/useToFixed/index.ts
@@ -3,16 +3,14 @@ import { computed } from 'vue-demi'
 import type { MaybeComputedRef } from '@vueuse/shared'
 import { resolveUnref } from '@vueuse/shared'
 
-/**
- * Reactive `toFixed`
- *
- * @see https://vueuse.org/useToFixed
- */
 export interface FixedTypes {
   type?: 'string' | 'number'
   math?: 'floor' | 'ceil' | 'round'
 }
 
+/**
+ * @deprecated use `usePrecision` instead
+ */
 export function useToFixed(
   value: MaybeComputedRef<number | string>,
   digits: MaybeComputedRef<number>,
diff --git a/packages/metadata/scripts/update.ts b/packages/metadata/scripts/update.ts
index a4483dade6a..eae7b08b495 100644
--- a/packages/metadata/scripts/update.ts
+++ b/packages/metadata/scripts/update.ts
@@ -104,7 +104,7 @@ export async function readMetadata() {
       fn.category = ['core', 'shared'].includes(pkg.name) ? category : `@${pkg.display}`
       fn.description = description
 
-      if (description.includes('DEPRECATED'))
+      if (description.includes('DEPRECATED') || frontmatter.deprecated)
         fn.deprecated = true
 
       if (alias?.length)