✨ feat: add speak fns

Author: AkashiGakki

packages/browser/speak/index.md

@@ -0,0 +1,15 @@
+---
+category: '@Browser'
+---
+
+# speak
+
+speaks a message.
+
+## Usage
+
+```ts
+import { speak } from '@use-kit/functions'
+
+speak('Hi!')
+```

packages/browser/speak/index.ts

@@ -0,0 +1,25 @@
+export const speak = (
+  text: string,
+  lang = 'en-US',
+  rate = 1.0,
+  pitch = 1.0,
+  volume = 1.0) => {
+  if (typeof window !== 'undefined' && 'speechSynthesis' in window) {
+    try {
+      const utterance = new SpeechSynthesisUtterance(text)
+      utterance.lang = lang
+      utterance.rate = rate
+      utterance.pitch = pitch
+      utterance.volume = volume
+      window.speechSynthesis.speak(utterance)
+      return true
+    }
+    catch (error) {
+      return false
+    }
+  }
+  else {
+    console.warn('Speech synthesis is not supported in this environment.')
+    return false
+  }
+}

packages/docs/browser/speak/index.md

@@ -0,0 +1,15 @@
+---
+category: '@Browser'
+---
+
+# speak
+
+speaks a message.
+
+## Usage
+
+```ts
+import { speak } from '@use-kit/functions'
+
+speak('Hi!')
+```

packages/docs/core/cacheField/index.md

@@ -0,0 +1,23 @@
+---
+category: '@Core'
+---
+
+# cacheField
+
+Cache a field value.
+
+## Usage
+
+<!-- ```ts
+import { cacheField } from '@vueuse/core'
+
+const { value, set } = cacheField()
+set('foo', 'bar')
+value.value // 'bar'
+``` -->
+
+```ts
+import { cacheField } from '@use-kit/functions'
+
+const ret = await cacheField('a', 'test')
+```

packages/docs/core/isValidJSON/index.md

@@ -1 +1,15 @@
-// TODO:
+---
+category: '@Core'
+---
+
+# isValidJSON
+
+Validates if a string is a valid JSON.
+
+## Usage
+
+```ts
+import { isValidJSON } from '@use-kit/functions'
+
+isValidJSON('{ "foo": "bar" }') // true
+```

packages/docs/core/stringByteSize/index.md

@@ -1 +1,22 @@
 // TODO:
+---
+category: '@Core'
+---
+
+# stringByteSize
+
+Checks if a string is of a certain length.
+
+## Usage
+
+```ts
+import { stringByteSize } from '@use-kit/functions'
+
+stringByteSize('') // 0
+stringByteSize('a') // 1
+stringByteSize('ab') // 2
+stringByteSize('abc') // 3
+stringByteSize('abcd') // 4
+stringByteSize('abcde') // 5
+stringByteSize('😜') // 4
+```