docs: update API examples and improve code formatting

- Update API examples across multiple files to use correct function names and formatting
- Improve code formatting in API documentation to match TypeScript conventions
- Remove unused code examples and simplify existing ones
- Update function signatures and return types in documentation

Author: ryanuo

docs/.vitepress/theme/index.ts

@@ -1,7 +1,6 @@
 import type { EnhanceAppContext } from 'vitepress'
 import TwoslashFloatingVue from '@shikijs/vitepress-twoslash/client'
 import Theme from 'vitepress/theme'
-
 import '@shikijs/vitepress-twoslash/style.css'
 
 export default {

docs/api/browser/functions/getUrlParamsString.md

@@ -30,6 +30,6 @@ The URL to which parameters will be added, defaults to the current page URL
 
 ```ts twoslash
 import { getUrlParamsString } from '@ryanuo/utils'
-getUrlParamsString({ a: 1, b: 2 }) // '?a=1&b=2'
-getUrlParamsString({ a: 1, b: 2 }, 'https://www.example.com')
+getUrlParamsString({ a: '1', b: '2' }) // '?a=1&b=2'
+getUrlParamsString({ a: '1', b: '2', c: '3' }) // '?a=1&b=2&c=3'
 ```

docs/api/browser/functions/manageClasses.md

@@ -39,8 +39,6 @@ function manageClasses(
 
 ```ts twoslash
 import { manageClasses } from '@ryanuo/utils'
-const el = document.getElementById('myElement')
+const el = document.getElementById('myElement') as HTMLElement
 manageClasses(el, 'add', ['class1', 'class2'])
-manageClasses(el, 'remove', ['class1', 'class2'])
-manageClasses(el, 'toggle', ['class1', 'class2'])
 ```

docs/api/browser/functions/onceEventListener.md

@@ -38,8 +38,8 @@ function onceEventListener(
 ## Example
 
 ```ts twoslash
-import { once } from '@ryanuo/utils'
-once(document, 'click', (e) => {
+import { onceEventListener } from '@ryanuo/utils'
+onceEventListener(document, 'click', (e) => {
   console.log(e)
 })
 ```

docs/api/browser/variables/safeStorage.md

@@ -10,7 +10,7 @@ A simple storage wrapper that uses localStorage and sessionStorage.
 
 ## Example
 
-```
+```ts twoslash
 import { safeStorage } from '@ryanuo/utils'
 // Basic usage (localStorage)
 safeStorage.set('user', { name: 'John' })

docs/api/common/functions/debounce.md

@@ -63,6 +63,6 @@ Returns a new debounced function.
 import { debounce } from '@ryanuo/utils'
 const debouncedFn = debounce(() => {
   console.log('Debounced function executed')
-})
+}, 500, true)
 debouncedFn()
 ```

docs/api/common/functions/safeJSONParse.md

@@ -25,8 +25,8 @@ A successfully parsed JSON object, or null if parsing fails
 ## Example
 
 ```ts twoslash
-import { safeParseJSON } from '@ryanuo/utils'
+import { safeJSONParse } from '@ryanuo/utils'
 const json = '{"name": "John", "age": 30}'
-const obj = safeParseJSON(json)
+const obj = safeJSONParse(json)
 console.log(obj) // { name: 'John', age: 30 }
 ```

docs/api/common/functions/throttle.md

@@ -55,3 +55,11 @@ Returns a new throttled function.
 ### Returns
 
 `void`
+
+## Example
+
+```ts twoslash
+import { throttle } from '@ryanuo/utils'
+throttle(() => console.log('Hello, world!'), 1000, true)
+throttle(() => console.log('Hello, world!'), 1000, false)
+```

docs/api/finance/classes/CalculatorChain.md

@@ -11,8 +11,8 @@
 ## Example
 
 ```ts twoslash
-import { chain } from '@ryanuo/utils'
-chain(100)
+import { CalculatorChain } from '@ryanuo/utils'
+new CalculatorChain(100)
   .add(10)
   .sub(5)
   .mul(2)

docs/api/network/functions/getIndexedDBCache.md

@@ -37,6 +37,7 @@ IndexedDB 缓存对象
 ## Example
 
 ```ts twoslash
+import { getIndexedDBCache } from '@ryanuo/utils';
 // 使用示例
 const cache = await getIndexedDBCache('api-cache', 'responses');
 await cache.set('users', [{ id: 1, name: 'Alice' }]);