@maz-ui/mcp 5.0.0 → 5.1.0-beta.0

package/docs/ecosystem/utils/get-browser-locale.md

@@ -0,0 +1,35 @@
+---
+title: "getBrowserLocale"
+description: "Read the user's browser language tag (e.g. `'fr-FR'`, `'en-US'`) - returns `undefined` on the server."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/get-browser-locale"
+---
+
+# getBrowserLocale
+
+> Read the user's browser language tag (e.g. `'fr-FR'`, `'en-US'`) - returns `undefined` on the server.
+
+- Package: `@maz-ui/utils`
+- Import: `import { getBrowserLocale } from '@maz-ui/utils/helpers/getBrowserLocale'`
+- Web: https://maz-ui.com/ecosystem/utils/get-browser-locale
+
+## Usage
+
+```ts
+import { getBrowserLocale } from '@maz-ui/utils'
+
+const locale = getBrowserLocale() // 'fr-FR' | 'en-US' | … | undefined
+```
+
+## API
+
+```ts
+function getBrowserLocale(): string | undefined
+```
+
+Returns `navigator.language` on the client. On the server (no `navigator`), returns `undefined`.
+
+## Notes
+
+- For IP-based country detection instead of the browser-declared locale, see [`fetchLocaleIp`](./fetch-locale-ip.md).
+- The returned tag follows [BCP 47](https://www.rfc-editor.org/info/bcp47).

package/docs/ecosystem/utils/get-country-flag-url.md

@@ -0,0 +1,67 @@
+---
+title: "getCountryFlagUrl"
+description: "Get country flag from flagcdn.com with a simple function call"
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/get-country-flag-url"
+---
+
+# getCountryFlagUrl
+
+> Get country flag from flagcdn.com with a simple function call
+
+- Package: `@maz-ui/utils`
+- Import: `import { getCountryFlagUrl } from '@maz-ui/utils/helpers/getCountryFlagUrl'`
+- Web: https://maz-ui.com/ecosystem/utils/get-country-flag-url
+
+## Basic usage
+
+```vue
+<template>
+  <img :src="flagSrc" alt="Flag of France" />
+</template>
+
+<script lang="ts" setup >
+  import { getCountryFlagUrl } from '@maz-ui/utils'
+
+  const flagSrc = getCountryFlagUrl('FR')
+</script>
+```
+
+## Sizing
+
+**Details: Show full code**
+
+```vue
+<template>
+  <img
+    v-for="{ src, size, countryCode } in sizedFlags"
+    :key="src"
+    :src="src"
+    :alt="`${countryCode} Flag`"
+  />
+</template>
+
+<script lang="ts" setup>
+  import { computed } from 'vue'
+  import { getCountryFlagUrl } from '@maz-ui/utils'
+
+  const countryCode = ref('FR')
+
+  const sizedFlags = computed(() => {
+    const sizes: Size[] = [
+      '16x12',
+      '20x15',
+      '24x18',
+      '80x60',
+      'h80',
+      'w160',
+    ]
+
+    return sizes.map(size => ({
+      src: getCountryFlagUrl(countryCode.value, size),
+      size: size,
+      countryCode: countryCode.value
+    }))
+  })
+</script>
+```

package/docs/{src/ecosystem → ecosystem}/utils/get-error-message.md

@@ -1,11 +1,17 @@
 ---
-title: getErrorMessage
-description: Extract a human-readable message from anything thrown — `Error`, `string`, `{ message }` objects, or arbitrary values.
+title: "getErrorMessage"
+description: "Extract a human-readable message from anything thrown - `Error`, `string`, `{ message }` objects, or arbitrary values."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/get-error-message"
 ---
 
-# {{ $frontmatter.title }}
+# getErrorMessage
 
-{{ $frontmatter.description }}
+> Extract a human-readable message from anything thrown - `Error`, `string`, `{ message }` objects, or arbitrary values.
+
+- Package: `@maz-ui/utils`
+- Import: `import { getErrorMessage } from '@maz-ui/utils/helpers/getErrorMessage'`
+- Web: https://maz-ui.com/ecosystem/utils/get-error-message
 
 Especially useful inside `catch` blocks where the caught value is typed `unknown`.
 

package/docs/{src/ecosystem → ecosystem}/utils/idle-timeout.md

@@ -1,11 +1,17 @@
 ---
-title: IdleTimeout
-description: Detect user inactivity (mouse, keyboard, touch, scroll) and run a callback when the user becomes idle.
+title: "IdleTimeout"
+description: "Detect user inactivity (mouse, keyboard, touch, scroll) and run a callback when the user becomes idle."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/idle-timeout"
 ---
 
-# {{ $frontmatter.title }}
+# IdleTimeout
 
-{{ $frontmatter.description }}
+> Detect user inactivity (mouse, keyboard, touch, scroll) and run a callback when the user becomes idle.
+
+- Package: `@maz-ui/utils`
+- Import: `import { IdleTimeout } from '@maz-ui/utils/helpers/idleTimeout'`
+- Web: https://maz-ui.com/ecosystem/utils/idle-timeout
 
 `IdleTimeout` listens for a range of user-input events (`mousedown`, `keydown`, `touchstart`, `wheel`, …) on a target element. When none of them fire for `timeout` ms, the user is considered idle and your callback is invoked.
 
@@ -65,10 +71,10 @@ type IdleTimeoutCallback = (payload: {
 
 ### Methods
 
-- **`start()`** — Attach listeners and (re)start the timer. The constructor calls this automatically on the client.
-- **`pause()` / `resume()`** — Freeze and unfreeze the countdown without losing the elapsed time.
-- **`reset()`** — Restart the timer from scratch.
-- **`destroy()`** — Detach all listeners. The watcher cannot be reused after destroy.
+- **`start()`** - Attach listeners and (re)start the timer. The constructor calls this automatically on the client.
+- **`pause()` / `resume()`** - Freeze and unfreeze the countdown without losing the elapsed time.
+- **`reset()`** - Restart the timer from scratch.
+- **`destroy()`** - Detach all listeners. The watcher cannot be reused after destroy.
 
 ## Examples
 
@@ -87,4 +93,4 @@ const idle = new IdleTimeout(
 
 ## Related
 
-- [`UserVisibility`](./user-visibility) — track tab focus / visibility instead of in-page activity.
+- [`UserVisibility`](./user-visibility.md) - track tab focus / visibility instead of in-page activity.

package/docs/{src/ecosystem → ecosystem}/utils/index.md

@@ -1,20 +1,21 @@
 ---
-title: '@maz-ui/utils'
-description: Lightweight, tree-shakeable utility functions and TypeScript helpers for Vue, Nuxt and any JavaScript/TypeScript project.
+title: "@maz-ui/utils"
+description: "Lightweight, tree-shakeable utility functions and TypeScript helpers for Vue, Nuxt and any JavaScript/TypeScript project."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/"
 ---
 
-# {{ $frontmatter.title }}
+# @maz-ui/utils
 
-{{ $frontmatter.description }}
+> Lightweight, tree-shakeable utility functions and TypeScript helpers for Vue, Nuxt and any JavaScript/TypeScript project.
 
-<NpmBadge package="@maz-ui/utils" />
+- Package: `@maz-ui/utils`
+- Web: https://maz-ui.com/ecosystem/utils/
 
-`@maz-ui/utils` ships the runtime helpers and TypeScript type utilities that power maz-ui internally, packaged as a standalone, framework-agnostic library. No Vue dependency, no global side effects — just import what you need.
+`@maz-ui/utils` ships the runtime helpers and TypeScript type utilities that power maz-ui internally, packaged as a standalone, framework-agnostic library. No Vue dependency, no global side effects - just import what you need.
 
 ## Installation
 
-::: code-group
-
 ```bash [pnpm]
 pnpm add @maz-ui/utils
 ```
@@ -27,8 +28,6 @@ npm install @maz-ui/utils
 yarn add @maz-ui/utils
 ```
 
-:::
-
 ## Basic usage
 
 ```ts
@@ -43,11 +42,9 @@ await sleep(500)
 
 ## What's inside
 
-<UtilsCatalogue />
-
 ## Tree-shaking
 
-The package is published with `"sideEffects": false`. Named imports — `import { sleep } from '@maz-ui/utils'` — are statically analysed by Vite, Rollup, esbuild and webpack: any helper you don't reference is dropped from your bundle.
+The package is published with `"sideEffects": false`. Named imports - `import { sleep } from '@maz-ui/utils'` - are statically analysed by Vite, Rollup, esbuild and webpack: any helper you don't reference is dropped from your bundle.
 
 For granular bundling you can also import a single helper through its dedicated subpath:
 

package/docs/{src/ecosystem → ecosystem}/utils/is-client.md

@@ -1,11 +1,17 @@
 ---
-title: isClient
-description: Check whether the code is running in a browser environment (has a `document`).
+title: "isClient"
+description: "Check whether the code is running in a browser environment (has a `document`)."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/is-client"
 ---
 
-# {{ $frontmatter.title }}
+# isClient
 
-{{ $frontmatter.description }}
+> Check whether the code is running in a browser environment (has a `document`).
+
+- Package: `@maz-ui/utils`
+- Import: `import { isClient } from '@maz-ui/utils/helpers/isClient'`
+- Web: https://maz-ui.com/ecosystem/utils/is-client
 
 ## Usage
 
@@ -27,6 +33,6 @@ Returns `true` if `document` is defined, `false` otherwise (e.g. SSR, Node.js, W
 
 ## Notes
 
-- The opposite is [`isServer`](./is-server).
+- The opposite is [`isServer`](./is-server.md).
 - Implemented as a one-liner: `typeof document !== 'undefined'`.
 - Prefer this over checking `process.client` (Nuxt) or `import.meta.env.SSR` (Vite) when you want a framework-agnostic check.

package/docs/{src/ecosystem → ecosystem}/utils/is-equal.md

@@ -1,11 +1,17 @@
 ---
-title: isEqual
-description: Deep structural equality check for primitives, arrays, plain objects and Dates.
+title: "isEqual"
+description: "Deep structural equality check for primitives, arrays, plain objects and Dates."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/is-equal"
 ---
 
-# {{ $frontmatter.title }}
+# isEqual
 
-{{ $frontmatter.description }}
+> Deep structural equality check for primitives, arrays, plain objects and Dates.
+
+- Package: `@maz-ui/utils`
+- Import: `import { isEqual } from '@maz-ui/utils/helpers/isEqual'`
+- Web: https://maz-ui.com/ecosystem/utils/is-equal
 
 ## Usage
 
@@ -31,8 +37,8 @@ function isEqual(a: unknown, b: unknown): boolean
 
 ## Behaviour
 
-- **Primitives** (`null`, `undefined`, `string`, `number`, `boolean`, `symbol`, `bigint`) — compared with `===`.
-- **Dates** — compared by `getTime()`.
-- **Arrays** — same length and every element deeply equal.
-- **Plain objects** — same set of keys and every value deeply equal.
+- **Primitives** (`null`, `undefined`, `string`, `number`, `boolean`, `symbol`, `bigint`) - compared with `===`.
+- **Dates** - compared by `getTime()`.
+- **Arrays** - same length and every element deeply equal.
+- **Plain objects** - same set of keys and every value deeply equal.
 - **Anything else** (Maps, Sets, class instances, functions) is not specifically handled; comparisons fall back to `===`.

package/docs/{src/ecosystem → ecosystem}/utils/is-ios.md

@@ -1,11 +1,17 @@
 ---
-title: isIos
-description: Check whether the page runs on iOS or iPadOS, including iPads that report a desktop Mac user agent.
+title: "isIos"
+description: "Check whether the page runs on iOS or iPadOS, including iPads that report a desktop Mac user agent."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/is-ios"
 ---
 
-# {{ $frontmatter.title }}
+# isIos
 
-{{ $frontmatter.description }}
+> Check whether the page runs on iOS or iPadOS, including iPads that report a desktop Mac user agent.
+
+- Package: `@maz-ui/utils`
+- Import: `import { isIos } from '@maz-ui/utils/helpers/isIos'`
+- Web: https://maz-ui.com/ecosystem/utils/is-ios
 
 ## Usage
 
@@ -32,6 +38,6 @@ The check returns `true` when **either**:
 - the user agent contains `iPhone`, `iPad` or `iPod`;
 - the user agent contains `Macintosh` and the device has touch support (`navigator.maxTouchPoints > 1`) - iPadOS 13+ reports a desktop Mac user agent by default.
 
-::: tip
+**Tip:**
+
 Prefer feature detection when it exists (`CSS.supports`, `matchMedia`...). Use `isIos` for behaviors that are specific to the platform, like [preventIosInputZoom](./prevent-ios-input-zoom.md).
-:::

package/docs/ecosystem/utils/is-server.md

@@ -0,0 +1,37 @@
+---
+title: "isServer"
+description: "Check whether the code is running on the server (no `window` or `document`)."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/is-server"
+---
+
+# isServer
+
+> Check whether the code is running on the server (no `window` or `document`).
+
+- Package: `@maz-ui/utils`
+- Import: `import { isServer } from '@maz-ui/utils/helpers/isServer'`
+- Web: https://maz-ui.com/ecosystem/utils/is-server
+
+## Usage
+
+```ts
+import { isServer } from '@maz-ui/utils'
+
+if (isServer()) {
+  return placeholder
+}
+```
+
+## API
+
+```ts
+function isServer(): boolean
+```
+
+Returns `true` when either `document` or `window` is undefined - covers Node.js, Bun, Deno, Edge runtimes and Web Workers.
+
+## Notes
+
+- The opposite is [`isClient`](./is-client.md).
+- Useful for guarding `window`-dependent code from SSR errors.

package/docs/ecosystem/utils/is-standalone-mode.md

@@ -0,0 +1,49 @@
+---
+title: "isStandaloneMode"
+description: "Check whether the app is running as an installed Progressive Web App (PWA) rather than inside a browser tab."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/is-standalone-mode"
+---
+
+# isStandaloneMode
+
+> Check whether the app is running as an installed Progressive Web App (PWA) rather than inside a browser tab.
+
+- Package: `@maz-ui/utils`
+- Import: `import { isStandaloneMode } from '@maz-ui/utils/helpers/isStandaloneMode'`
+- Web: https://maz-ui.com/ecosystem/utils/is-standalone-mode
+
+## Usage
+
+```ts
+import { isStandaloneMode } from '@maz-ui/utils'
+
+if (isStandaloneMode()) {
+  console.log('Running as installed PWA')
+}
+```
+
+## API
+
+```ts
+function isStandaloneMode(): boolean
+```
+
+Returns `true` if the page is rendered in standalone display mode, `false` otherwise (including during SSR).
+
+## Detection rules
+
+The check returns `true` when **either**:
+
+- `window.matchMedia('(display-mode: standalone)').matches` - covers Chrome, Edge, Firefox, etc.
+- `navigator.standalone` is truthy - iOS Safari's legacy property.
+
+## Examples
+
+Hide install prompts when already installed:
+
+```ts
+if (!isStandaloneMode()) {
+  showInstallBanner()
+}
+```

package/docs/{src/ecosystem → ecosystem}/utils/kebab-case.md

@@ -1,11 +1,17 @@
 ---
-title: kebabCase
-description: Convert any common string casing to kebab-case — handles camelCase, PascalCase, snake_case, spaces and consecutive capitals.
+title: "kebabCase"
+description: "Convert any common string casing to kebab-case - handles camelCase, PascalCase, snake_case, spaces and consecutive capitals."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/kebab-case"
 ---
 
-# {{ $frontmatter.title }}
+# kebabCase
 
-{{ $frontmatter.description }}
+> Convert any common string casing to kebab-case - handles camelCase, PascalCase, snake_case, spaces and consecutive capitals.
+
+- Package: `@maz-ui/utils`
+- Import: `import { kebabCase } from '@maz-ui/utils/helpers/kebabCase'`
+- Web: https://maz-ui.com/ecosystem/utils/kebab-case
 
 ## Usage
 

package/docs/{src/ecosystem → ecosystem}/utils/normalize-string.md

@@ -1,11 +1,17 @@
 ---
-title: normalizeString
-description: Powerful string normalizer — strip accents, normalize whitespace, remove special characters, change case, and apply Unicode normalization forms.
+title: "normalizeString"
+description: "Powerful string normalizer - strip accents, normalize whitespace, remove special characters, change case, and apply Unicode normalization forms."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/normalize-string"
 ---
 
-# {{ $frontmatter.title }}
+# normalizeString
 
-{{ $frontmatter.description }}
+> Powerful string normalizer - strip accents, normalize whitespace, remove special characters, change case, and apply Unicode normalization forms.
+
+- Package: `@maz-ui/utils`
+- Import: `import { normalizeString } from '@maz-ui/utils/helpers/normalizeString'`
+- Web: https://maz-ui.com/ecosystem/utils/normalize-string
 
 The Swiss-army knife for turning user input into a safe, comparable, slug-ready string.
 

package/docs/{src/ecosystem → ecosystem}/utils/number.md

@@ -1,22 +1,19 @@
 ---
-title: formatNumber
-description: The module formatNumber is a function that formats numbers with the native api [Intl.NumberFormat](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) from browsers and Node.js
+title: "formatNumber"
+description: "The module formatNumber is a function that formats numbers with the native api [Intl.NumberFormat](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) from browsers and Node.js"
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/number"
 ---
 
-# {{ $frontmatter.title }}
+# formatNumber
 
-{{ $frontmatter.description }}
+> The module formatNumber is a function that formats numbers with the native api [Intl.NumberFormat](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) from browsers and Node.js
 
-> This module uses the native api [Intl.NumberFormat](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) from browsers
-
-<MazInput v-model="numberValue" type="number" />
+- Package: `@maz-ui/utils`
+- Import: `import { formatNumber } from '@maz-ui/utils/helpers/formatNumber'`
+- Web: https://maz-ui.com/ecosystem/utils/number
 
-<div
-  style="padding: 16px; margin-top: 16px; background-color: var(--maz-surface-300);"
-  class="maz:flex maz:flex-center maz:rounded-md maz:gap-0.5"
->
-  formatted value: <strong>{{ numberFormatted }}</strong>
-</div>
+> This module uses the native api [Intl.NumberFormat](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) from browsers
 
 ```vue
 <script lang="ts" setup>
@@ -52,14 +49,3 @@ const DEFAULT_OPTIONS: Intl.NumberFormatOptions = {
   minimumFractionDigits: 2,
 }
 ```
-
-<script lang="ts" setup>
-  import { formatNumber } from '@maz-ui/utils'
-  import { ref, computed } from 'vue'
-
-  const numberValue = ref(69)
-
-  const numberFormatted = computed(() =>
-    formatNumber(numberValue.value, 'en-US'),
-  )
-</script>

package/docs/{src/ecosystem → ecosystem}/utils/pascal-case.md

@@ -1,11 +1,17 @@
 ---
-title: pascalCase
-description: Convert any common string casing — kebab, snake, space-separated, camelCase or UPPERCASE — to PascalCase.
+title: "pascalCase"
+description: "Convert any common string casing - kebab, snake, space-separated, camelCase or UPPERCASE - to PascalCase."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/pascal-case"
 ---
 
-# {{ $frontmatter.title }}
+# pascalCase
 
-{{ $frontmatter.description }}
+> Convert any common string casing - kebab, snake, space-separated, camelCase or UPPERCASE - to PascalCase.
+
+- Package: `@maz-ui/utils`
+- Import: `import { pascalCase } from '@maz-ui/utils/helpers/pascalCase'`
+- Web: https://maz-ui.com/ecosystem/utils/pascal-case
 
 ## Usage
 
@@ -32,4 +38,4 @@ function pascalCase(str: string): string
 
 - Detects `-`, `_` and space separators automatically.
 - Handles ALL-CAPS inputs by lowercasing before re-capitalizing.
-- For fine-grained control, use [`normalizeString`](./normalize-string) with `{ case: 'PascalCase' }`.
+- For fine-grained control, use [`normalizeString`](./normalize-string.md) with `{ case: 'PascalCase' }`.

package/docs/{src/ecosystem → ecosystem}/utils/prevent-ios-input-zoom.md

@@ -1,11 +1,17 @@
 ---
-title: preventIosInputZoom
-description: Stop iOS from zooming the page when a form field gets the focus, without changing the design of the fields.
+title: "preventIosInputZoom"
+description: "Stop iOS from zooming the page when a form field gets the focus, without changing the design of the fields."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/prevent-ios-input-zoom"
 ---
 
-# {{ $frontmatter.title }}
+# preventIosInputZoom
 
-{{ $frontmatter.description }}
+> Stop iOS from zooming the page when a form field gets the focus, without changing the design of the fields.
+
+- Package: `@maz-ui/utils`
+- Import: `import { addViewportMaximumScale, preventIosInputZoom } from '@maz-ui/utils/helpers/preventIosInputZoom'`
+- Web: https://maz-ui.com/ecosystem/utils/prevent-ios-input-zoom
 
 ## Why
 
@@ -27,11 +33,12 @@ import { preventIosInputZoom } from '@maz-ui/utils'
 preventIosInputZoom()
 ```
 
-::: tip Nuxt
+**Tip: Nuxt**
+
 With [@maz-ui/nuxt](../nuxt.md), enable the `general.preventIosInputZoom` option instead.
-:::
 
-::: warning Head managers
+**Warning: Head managers**
+
 If your viewport is managed by a head manager (`@unhead/vue`, `@vueuse/head`...), it can overwrite a direct change of the DOM on its next render. Set the viewport through it with `addViewportMaximumScale` instead:
 
 ```ts
@@ -44,7 +51,6 @@ useHead({
   meta: [{ name: 'viewport', content: isIos() ? addViewportMaximumScale(viewport) : viewport }],
 })
 ```
-:::
 
 ## API
 

package/docs/{src/ecosystem → ecosystem}/utils/script-loader.md

@@ -1,11 +1,19 @@
 ---
-title: ScriptLoader
-description: Class to inject and cache a <script> tag in document head, with an awaitable load promise — ideal for third-party SDKs.
+title: "ScriptLoader"
+description: "Class to inject and cache a <script> tag in document head, with an awaitable load promise - ideal for third-party SDKs."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/script-loader"
 ---
 
-# {{ $frontmatter.title }}
+# ScriptLoader
 
-{{ $frontmatter.description }}
+> Class to inject and cache a <script> tag in document head, with an awaitable load promise - ideal for third-party SDKs.
+
+- Package: `@maz-ui/utils`
+- Import: `import { ScriptLoader } from '@maz-ui/utils/helpers/scriptLoader'`
+- Web: https://maz-ui.com/ecosystem/utils/script-loader
+
+Class to inject and cache a  tag in document head, with an awaitable load promise - ideal for third-party SDKs.
 
 `ScriptLoader` handles deduplication (won't inject the same script twice), error reporting, and optional one-time loading semantics.
 
@@ -43,16 +51,16 @@ interface ScriptLoaderOptions {
 
 | Option       | Type      | Default | Description                                                                  |
 | ------------ | --------- | ------- | ---------------------------------------------------------------------------- |
-| `identifier` | `string`  | —       | Unique key used to deduplicate the script across calls (set as `data-identifier`) |
-| `src`        | `string`  | —       | Script URL                                                                   |
+| `identifier` | `string`  | - | Unique key used to deduplicate the script across calls (set as `data-identifier`) |
+| `src`        | `string`  | - | Script URL                                                                   |
 | `once`       | `boolean` | `true`  | When `true`, skip injection if a script with the same identifier already loaded |
 | `async`      | `boolean` | `true`  | Sets the `async` attribute on the `<script>` tag                             |
 | `defer`      | `boolean` | `true`  | Sets the `defer` attribute on the `<script>` tag                             |
 
 ### Methods
 
-- **`load()`** — Inject the script (or resolve immediately if cached) and return a promise that resolves to the load `Event` once the script is ready.
-- **`removeTag(tag)`** — Remove an injected `<script>` tag by element reference or identifier string.
+- **`load()`** - Inject the script (or resolve immediately if cached) and return a promise that resolves to the load `Event` once the script is ready.
+- **`removeTag(tag)`** - Remove an injected `<script>` tag by element reference or identifier string.
 
 ## Errors
 

package/docs/{src/ecosystem → ecosystem}/utils/sleep.md

@@ -1,11 +1,17 @@
 ---
-title: sleep
-description: Pause execution for a given number of milliseconds. Returns a promise that resolves after the delay.
+title: "sleep"
+description: "Pause execution for a given number of milliseconds. Returns a promise that resolves after the delay."
+package: "@maz-ui/utils"
+url: "https://maz-ui.com/ecosystem/utils/sleep"
 ---
 
-# {{ $frontmatter.title }}
+# sleep
 
-{{ $frontmatter.description }}
+> Pause execution for a given number of milliseconds. Returns a promise that resolves after the delay.
+
+- Package: `@maz-ui/utils`
+- Import: `import { sleep } from '@maz-ui/utils/helpers/sleep'`
+- Web: https://maz-ui.com/ecosystem/utils/sleep
 
 ## Usage