From 9586afc8bf2b09450a01a3061b8c27a546f96d78 Mon Sep 17 00:00:00 2001 From: Segun Adebayo Date: Thu, 19 Mar 2026 17:56:50 +0200 Subject: [PATCH] docs: update snippets --- .../data/snippets/react/accordion/usage.mdx | 2 +- .../react/angle-slider/tick-marks.mdx | 2 +- .../snippets/react/angle-slider/usage.mdx | 5 ++-- .../snippets/react/avatar/component.api.mdx | 1 + website/data/snippets/react/avatar/usage.mdx | 5 ++-- .../data/snippets/react/carousel/usage.mdx | 2 +- .../data/snippets/react/checkbox/usage.mdx | 2 +- .../snippets/react/color-picker/usage.mdx | 2 +- .../data/snippets/react/combobox/usage.mdx | 2 +- .../data/snippets/react/date-input/usage.mdx | 2 +- .../data/snippets/react/date-picker/usage.mdx | 2 +- .../snippets/react/dialog/initial-focus.mdx | 2 +- website/data/snippets/react/dialog/usage.mdx | 3 ++- .../react/editable/custom-controls.mdx | 9 ++++---- .../data/snippets/react/editable/usage.mdx | 5 ++-- .../data/snippets/react/file-upload/usage.mdx | 2 +- .../data/snippets/react/hover-card/usage.mdx | 5 ++-- .../snippets/react/image-cropper/usage.mdx | 2 +- .../snippets/react/listbox/grid-usage.mdx | 2 +- website/data/snippets/react/listbox/usage.mdx | 2 +- .../data/snippets/react/menu/context-menu.mdx | 5 ++-- .../data/snippets/react/menu/nested-menu.mdx | 6 ++--- .../data/snippets/react/menu/option-items.mdx | 2 +- website/data/snippets/react/menu/usage.mdx | 2 +- .../react/navigation-menu/controlled.mdx | 2 +- .../snippets/react/navigation-menu/usage.mdx | 2 +- .../react/navigation-menu/viewport-usage.mdx | 2 +- .../react/navigation-menu/with-indicator.mdx | 2 +- .../snippets/react/number-input/scrubber.mdx | 5 ++-- .../snippets/react/number-input/usage.mdx | 2 +- .../data/snippets/react/pagination/usage.mdx | 5 ++-- .../snippets/react/password-input/usage.mdx | 2 +- .../data/snippets/react/pin-input/usage.mdx | 5 ++-- .../snippets/react/popover/initial-focus.mdx | 2 +- .../react/popover/render-in-portal.mdx | 6 ++--- website/data/snippets/react/popover/usage.mdx | 2 +- .../data/snippets/react/progress/circular.mdx | 2 +- .../data/snippets/react/progress/usage.mdx | 2 +- website/data/snippets/react/qr-code/usage.mdx | 2 +- .../data/snippets/react/radio-group/usage.mdx | 5 ++-- .../snippets/react/range-slider/usage.mdx | 5 ++-- .../snippets/react/rating-group/usage.mdx | 5 ++-- .../data/snippets/react/scroll-area/usage.mdx | 2 +- .../react/segmented-control/usage.mdx | 5 ++-- .../snippets/react/select/usage-with-form.mdx | 2 +- website/data/snippets/react/select/usage.mdx | 4 ++-- .../snippets/react/signature-pad/usage.mdx | 4 ++-- .../data/snippets/react/slider/tick-marks.mdx | 2 +- website/data/snippets/react/slider/usage.mdx | 5 ++-- .../data/snippets/react/splitter/usage.mdx | 4 ++-- website/data/snippets/react/steps/usage.mdx | 2 +- website/data/snippets/react/switch/usage.mdx | 7 +++--- website/data/snippets/react/tabs/usage.mdx | 5 ++-- .../snippets/react/tabs/with-indicator.mdx | 2 +- .../data/snippets/react/tags-input/usage.mdx | 5 ++-- website/data/snippets/react/timer/usage.mdx | 3 ++- website/data/snippets/react/toast/usage.mdx | 2 +- .../snippets/react/toast/using-portal.mdx | 2 +- website/data/snippets/react/toc/usage.mdx | 5 ++-- .../snippets/react/toggle-group/usage.mdx | 2 +- website/data/snippets/react/tooltip/usage.mdx | 5 ++-- website/data/snippets/solid/avatar/usage.mdx | 3 ++- .../data/snippets/solid/date-input/usage.mdx | 4 ++-- .../data/snippets/solid/date-picker/usage.mdx | 3 ++- website/data/snippets/solid/drawer/usage.mdx | 4 ++-- .../data/snippets/solid/hover-card/usage.mdx | 4 ++-- .../data/snippets/solid/presence/usage.mdx | 2 +- .../data/snippets/solid/progress/circular.mdx | 2 +- .../data/snippets/solid/progress/usage.mdx | 2 +- .../snippets/solid/select/usage-with-form.mdx | 15 ++++++------ website/data/snippets/solid/switch/usage.mdx | 2 +- .../svelte/angle-slider/tick-marks.mdx | 6 ++--- .../data/snippets/svelte/clipboard/usage.mdx | 9 +++++--- .../data/snippets/svelte/date-input/usage.mdx | 23 ++++++++++--------- .../svelte/navigation-menu/controlled.mdx | 16 +++++++------ website/data/snippets/vue/clipboard/usage.mdx | 2 +- .../data/snippets/vue/date-input/usage.mdx | 12 +++++----- website/data/snippets/vue/drawer/usage.mdx | 2 +- .../snippets/vue/floating-panel/usage.mdx | 2 +- .../data/snippets/vue/listbox/grid-usage.mdx | 2 +- website/data/snippets/vue/listbox/usage.mdx | 2 +- website/data/snippets/vue/marquee/usage.mdx | 2 +- .../vue/navigation-menu/controlled.mdx | 20 ++++++++-------- .../snippets/vue/navigation-menu/usage.mdx | 10 ++++---- .../vue/navigation-menu/viewport-usage.mdx | 10 ++++---- .../snippets/vue/password-input/usage.mdx | 2 +- .../data/snippets/vue/scroll-area/usage.mdx | 2 +- .../data/snippets/vue/signature-pad/usage.mdx | 2 +- website/data/snippets/vue/steps/usage.mdx | 2 +- website/data/snippets/vue/tour/usage.mdx | 2 +- 90 files changed, 199 insertions(+), 170 deletions(-) diff --git a/website/data/snippets/react/accordion/usage.mdx b/website/data/snippets/react/accordion/usage.mdx index 07be898db8..9229515939 100644 --- a/website/data/snippets/react/accordion/usage.mdx +++ b/website/data/snippets/react/accordion/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as accordion from "@zag-js/accordion" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/angle-slider/tick-marks.mdx b/website/data/snippets/react/angle-slider/tick-marks.mdx index af4be5990b..b6a68822ad 100644 --- a/website/data/snippets/react/angle-slider/tick-marks.mdx +++ b/website/data/snippets/react/angle-slider/tick-marks.mdx @@ -1,4 +1,4 @@ -```jsx {7-11} +```tsx {7-11} //...
diff --git a/website/data/snippets/react/angle-slider/usage.mdx b/website/data/snippets/react/angle-slider/usage.mdx index 902e6cdfbb..950c1886ac 100644 --- a/website/data/snippets/react/angle-slider/usage.mdx +++ b/website/data/snippets/react/angle-slider/usage.mdx @@ -1,9 +1,10 @@ -```jsx +```tsx import * as angleSlider from "@zag-js/angle-slider" import { normalizeProps, useMachine } from "@zag-js/react" +import { useId } from "react" export function AngleSlider() { - const service = useMachine(angleSlider.machine, { id: "1" }) + const service = useMachine(angleSlider.machine, { id: useId() }) const api = angleSlider.connect(service, normalizeProps) diff --git a/website/data/snippets/react/avatar/component.api.mdx b/website/data/snippets/react/avatar/component.api.mdx index b871b35982..b7304699c5 100644 --- a/website/data/snippets/react/avatar/component.api.mdx +++ b/website/data/snippets/react/avatar/component.api.mdx @@ -1,6 +1,7 @@ ```tsx import * as avatar from "@zag-js/avatar" import { useMachine, normalizeProps } from "@zag-js/react" +import { useId } from "react" export interface AvatarProps extends Omit { /** diff --git a/website/data/snippets/react/avatar/usage.mdx b/website/data/snippets/react/avatar/usage.mdx index ce41261a63..53d355034c 100644 --- a/website/data/snippets/react/avatar/usage.mdx +++ b/website/data/snippets/react/avatar/usage.mdx @@ -1,9 +1,10 @@ -```jsx +```tsx import * as avatar from "@zag-js/avatar" import { useMachine, normalizeProps } from "@zag-js/react" +import { useId } from "react" function Avatar() { - const service = useMachine(avatar.machine, { id: "1" }) + const service = useMachine(avatar.machine, { id: useId() }) const api = avatar.connect(service, normalizeProps) diff --git a/website/data/snippets/react/carousel/usage.mdx b/website/data/snippets/react/carousel/usage.mdx index 43168dc1a9..14c90c1495 100644 --- a/website/data/snippets/react/carousel/usage.mdx +++ b/website/data/snippets/react/carousel/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as carousel from "@zag-js/carousel" import { normalizeProps, useMachine } from "@zag-js/react" diff --git a/website/data/snippets/react/checkbox/usage.mdx b/website/data/snippets/react/checkbox/usage.mdx index 01eb718bd9..0a40c50fec 100644 --- a/website/data/snippets/react/checkbox/usage.mdx +++ b/website/data/snippets/react/checkbox/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as checkbox from "@zag-js/checkbox" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/color-picker/usage.mdx b/website/data/snippets/react/color-picker/usage.mdx index f4b44221c9..61c2485137 100644 --- a/website/data/snippets/react/color-picker/usage.mdx +++ b/website/data/snippets/react/color-picker/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as colorPicker from "@zag-js/color-picker" import { normalizeProps, useMachine } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/combobox/usage.mdx b/website/data/snippets/react/combobox/usage.mdx index 465c1f380d..9d1c28b7a2 100644 --- a/website/data/snippets/react/combobox/usage.mdx +++ b/website/data/snippets/react/combobox/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as combobox from "@zag-js/combobox" import { useMachine, normalizeProps } from "@zag-js/react" import { useState, useId } from "react" diff --git a/website/data/snippets/react/date-input/usage.mdx b/website/data/snippets/react/date-input/usage.mdx index 710a3c68f3..043b885775 100644 --- a/website/data/snippets/react/date-input/usage.mdx +++ b/website/data/snippets/react/date-input/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as dateInput from "@zag-js/date-input" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/date-picker/usage.mdx b/website/data/snippets/react/date-picker/usage.mdx index bdd131c089..5ca879fa04 100644 --- a/website/data/snippets/react/date-picker/usage.mdx +++ b/website/data/snippets/react/date-picker/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as datepicker from "@zag-js/date-picker" import { useMachine, normalizeProps, Portal } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/dialog/initial-focus.mdx b/website/data/snippets/react/dialog/initial-focus.mdx index ef6708c884..e82d8785eb 100644 --- a/website/data/snippets/react/dialog/initial-focus.mdx +++ b/website/data/snippets/react/dialog/initial-focus.mdx @@ -1,4 +1,4 @@ -```jsx {3,6,13} +```tsx {3,6,13} export function Dialog() { // initial focused element ref const inputRef = useRef(null) diff --git a/website/data/snippets/react/dialog/usage.mdx b/website/data/snippets/react/dialog/usage.mdx index 5afc1840c3..ffc057b7ab 100644 --- a/website/data/snippets/react/dialog/usage.mdx +++ b/website/data/snippets/react/dialog/usage.mdx @@ -1,9 +1,10 @@ ```tsx import * as dialog from "@zag-js/dialog" import { useMachine, normalizeProps, Portal } from "@zag-js/react" +import { useId } from "react" export function Dialog() { - const service = useMachine(dialog.machine, { id: "1" }) + const service = useMachine(dialog.machine, { id: useId() }) const api = dialog.connect(service, normalizeProps) diff --git a/website/data/snippets/react/editable/custom-controls.mdx b/website/data/snippets/react/editable/custom-controls.mdx index a6f66d1c25..708e9b63e1 100644 --- a/website/data/snippets/react/editable/custom-controls.mdx +++ b/website/data/snippets/react/editable/custom-controls.mdx @@ -1,11 +1,12 @@ -```jsx +```tsx import * as editable from "@zag-js/editable" -import { useMachine } from "@zag-js/react" +import { useMachine, normalizeProps } from "@zag-js/react" +import { useId } from "react" export default function Editable() { - const service = useMachine(editable.machine, { id: "1" }) + const service = useMachine(editable.machine, { id: useId() }) - const api = editable.connect(service) + const api = editable.connect(service, normalizeProps) return (
diff --git a/website/data/snippets/react/editable/usage.mdx b/website/data/snippets/react/editable/usage.mdx index 497fcefcbd..fff58da608 100644 --- a/website/data/snippets/react/editable/usage.mdx +++ b/website/data/snippets/react/editable/usage.mdx @@ -1,9 +1,10 @@ -```jsx +```tsx import * as editable from "@zag-js/editable" import { useMachine, normalizeProps } from "@zag-js/react" +import { useId } from "react" export default function Editable() { - const service = useMachine(editable.machine, { id: "1" }) + const service = useMachine(editable.machine, { id: useId() }) const api = editable.connect(service, normalizeProps) diff --git a/website/data/snippets/react/file-upload/usage.mdx b/website/data/snippets/react/file-upload/usage.mdx index 79bb742d6c..3ae63a7111 100644 --- a/website/data/snippets/react/file-upload/usage.mdx +++ b/website/data/snippets/react/file-upload/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as fileUpload from "@zag-js/file-upload" import { normalizeProps, useMachine } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/hover-card/usage.mdx b/website/data/snippets/react/hover-card/usage.mdx index d189299c74..51a2357c34 100644 --- a/website/data/snippets/react/hover-card/usage.mdx +++ b/website/data/snippets/react/hover-card/usage.mdx @@ -1,9 +1,10 @@ -```jsx +```tsx import * as hoverCard from "@zag-js/hover-card" import { useMachine, normalizeProps, Portal } from "@zag-js/react" +import { useId } from "react" function HoverCard() { - const service = useMachine(hoverCard.machine, { id: "1" }) + const service = useMachine(hoverCard.machine, { id: useId() }) const api = hoverCard.connect(service, normalizeProps) diff --git a/website/data/snippets/react/image-cropper/usage.mdx b/website/data/snippets/react/image-cropper/usage.mdx index 1c5468e172..6d792dd4e8 100644 --- a/website/data/snippets/react/image-cropper/usage.mdx +++ b/website/data/snippets/react/image-cropper/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as imageCropper from "@zag-js/image-cropper" import { normalizeProps, useMachine } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/listbox/grid-usage.mdx b/website/data/snippets/react/listbox/grid-usage.mdx index b3fe9fb8d3..be477e0ec8 100644 --- a/website/data/snippets/react/listbox/grid-usage.mdx +++ b/website/data/snippets/react/listbox/grid-usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as listbox from "@zag-js/listbox" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/listbox/usage.mdx b/website/data/snippets/react/listbox/usage.mdx index bfe567681d..c9552f77b4 100644 --- a/website/data/snippets/react/listbox/usage.mdx +++ b/website/data/snippets/react/listbox/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as listbox from "@zag-js/listbox" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/menu/context-menu.mdx b/website/data/snippets/react/menu/context-menu.mdx index db49680c6a..e9616811cc 100644 --- a/website/data/snippets/react/menu/context-menu.mdx +++ b/website/data/snippets/react/menu/context-menu.mdx @@ -1,9 +1,10 @@ -```jsx +```tsx import * as menu from "@zag-js/menu" import { useMachine, normalizeProps } from "@zag-js/react" +import { useId } from "react" export function ContextMenu() { - const service = useMachine(menu.machine, { id: "1" }) + const service = useMachine(menu.machine, { id: useId() }) const api = menu.connect(service, normalizeProps) return ( diff --git a/website/data/snippets/react/menu/nested-menu.mdx b/website/data/snippets/react/menu/nested-menu.mdx index f44326a67d..9bafe53d37 100644 --- a/website/data/snippets/react/menu/nested-menu.mdx +++ b/website/data/snippets/react/menu/nested-menu.mdx @@ -1,12 +1,12 @@ ```tsx import * as menu from "@zag-js/menu" import { useMachine, normalizeProps, Portal } from "@zag-js/react" -import { useEffect } from "react" +import { useEffect, useId } from "react" export function NestedMenu() { // Level 1 - File Menu const fileMenuService = useMachine(menu.machine, { - id: "1", + id: useId(), "aria-label": "File", }) @@ -14,7 +14,7 @@ export function NestedMenu() { // Level 2 - Share Menu const shareMenuService = useMachine(menu.machine, { - id: "2", + id: useId(), "aria-label": "Share", }) diff --git a/website/data/snippets/react/menu/option-items.mdx b/website/data/snippets/react/menu/option-items.mdx index ac8e785b87..bb1aed9456 100644 --- a/website/data/snippets/react/menu/option-items.mdx +++ b/website/data/snippets/react/menu/option-items.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as menu from "@zag-js/menu" import { useMachine, normalizeProps } from "@zag-js/react" import { useState } from "react" diff --git a/website/data/snippets/react/menu/usage.mdx b/website/data/snippets/react/menu/usage.mdx index 1373ed03e7..b76fdca8d2 100644 --- a/website/data/snippets/react/menu/usage.mdx +++ b/website/data/snippets/react/menu/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as menu from "@zag-js/menu" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/navigation-menu/controlled.mdx b/website/data/snippets/react/navigation-menu/controlled.mdx index eb5a0e739d..d34e596127 100644 --- a/website/data/snippets/react/navigation-menu/controlled.mdx +++ b/website/data/snippets/react/navigation-menu/controlled.mdx @@ -1,4 +1,4 @@ -```jsx {1,4-8} +```tsx {1,4-8} import { useState } from "react" export function NavigationMenu() { diff --git a/website/data/snippets/react/navigation-menu/usage.mdx b/website/data/snippets/react/navigation-menu/usage.mdx index 4485da5b46..ccfa102cce 100644 --- a/website/data/snippets/react/navigation-menu/usage.mdx +++ b/website/data/snippets/react/navigation-menu/usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as navigationMenu from "@zag-js/navigation-menu" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/navigation-menu/viewport-usage.mdx b/website/data/snippets/react/navigation-menu/viewport-usage.mdx index 705662dfdf..9a7e73858e 100644 --- a/website/data/snippets/react/navigation-menu/viewport-usage.mdx +++ b/website/data/snippets/react/navigation-menu/viewport-usage.mdx @@ -1,4 +1,4 @@ -```jsx +```tsx import * as navigationMenu from "@zag-js/navigation-menu" import { useMachine, normalizeProps } from "@zag-js/react" import { useId } from "react" diff --git a/website/data/snippets/react/navigation-menu/with-indicator.mdx b/website/data/snippets/react/navigation-menu/with-indicator.mdx index 3a17c1be2b..70a454d7ba 100644 --- a/website/data/snippets/react/navigation-menu/with-indicator.mdx +++ b/website/data/snippets/react/navigation-menu/with-indicator.mdx @@ -1,4 +1,4 @@ -```jsx {3-5} +```tsx {3-5}