@wordpress/components 25.13.0 → 25.15.0

package/build-types/dropdown-menu-v2-ariakit/types.d.ts

@@ -1,168 +0,0 @@
-/// <reference types="react" />
-/**
- * External dependencies
- */
-import type * as Ariakit from '@ariakit/react';
-import type { Placement } from '@floating-ui/react-dom';
-export interface DropdownMenuContext {
-    /**
-     * The ariakit store shared across all DropdownMenu subcomponents.
-     */
-    store: Ariakit.MenuStore;
-    /**
-     * The variant used by the underlying menu popover.
-     */
-    variant?: 'toolbar';
-}
-export interface DropdownMenuProps {
-    /**
-     * The trigger button.
-     */
-    trigger: React.ReactElement;
-    /**
-     * The contents of the dropdown.
-     */
-    children?: React.ReactNode;
-    /**
-     * The open state of the dropdown menu when it is initially rendered. Use when
-     * not wanting to control its open state.
-     *
-     * @default false
-     */
-    defaultOpen?: boolean;
-    /**
-     * The controlled open state of the dropdown menu. Must be used in conjunction
-     * with `onOpenChange`.
-     */
-    open?: boolean;
-    /**
-     * Event handler called when the open state of the dropdown menu changes.
-     */
-    onOpenChange?: (open: boolean) => void;
-    /**
-     * The modality of the dropdown menu. When set to true, interaction with
-     * outside elements will be disabled and only menu content will be visible to
-     * screen readers.
-     *
-     * @default true
-     */
-    modal?: boolean;
-    /**
-     * The placement of the dropdown menu popover.
-     *
-     * @default 'bottom-start' for root-level menus, 'right-start' for nested menus
-     */
-    placement?: Placement;
-    /**
-     * The distance between the popover and the anchor element.
-     *
-     * @default 8 for root-level menus, 16 for nested menus
-     */
-    gutter?: number;
-    /**
-     * The skidding of the popover along the anchor element. Can be set to
-     * negative values to make the popover shift to the opposite side.
-     *
-     * @default 0 for root-level menus, -8 for nested menus
-     */
-    shift?: number;
-    /**
-     * Determines whether the menu popover will be hidden when the user presses
-     * the Escape key.
-     *
-     * @default `( event ) => { event.preventDefault(); return true; }`
-     */
-    hideOnEscape?: boolean | ((event: KeyboardEvent | React.KeyboardEvent<Element>) => boolean);
-}
-export interface DropdownMenuGroupProps {
-    /**
-     * The contents of the dropdown menu group.
-     */
-    children: React.ReactNode;
-}
-export interface DropdownMenuItemProps {
-    /**
-     * The contents of the menu item.
-     */
-    children: React.ReactNode;
-    /**
-     * The contents of the menu item's prefix.
-     */
-    prefix?: React.ReactNode;
-    /**
-     * The contents of the menu item's suffix.
-     */
-    suffix?: React.ReactNode;
-    /**
-     * Whether to hide the parent menu when the item is clicked.
-     *
-     * @default true
-     */
-    hideOnClick?: boolean;
-    /**
-     * Determines if the element is disabled.
-     */
-    disabled?: boolean;
-}
-export interface DropdownMenuCheckboxItemProps extends Omit<DropdownMenuItemProps, 'prefix' | 'hideOnClick'> {
-    /**
-     * Whether to hide the dropdown menu when the item is clicked.
-     *
-     * @default false
-     */
-    hideOnClick?: boolean;
-    /**
-     * The checkbox menu item's name.
-     */
-    name: string;
-    /**
-     * The checkbox item's value, useful when using multiple checkbox menu items
-     * associated to the same `name`.
-     */
-    value?: string;
-    /**
-     * The controlled checked state of the checkbox menu item.
-     */
-    checked?: boolean;
-    /**
-     * The checked state of the checkbox menu item when it is initially rendered.
-     * Use when not wanting to control its checked state.
-     */
-    defaultChecked?: boolean;
-    /**
-     * Event handler called when the checked state of the checkbox menu item changes.
-     */
-    onChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
-}
-export interface DropdownMenuRadioItemProps extends Omit<DropdownMenuItemProps, 'prefix' | 'hideOnClick'> {
-    /**
-     * Whether to hide the dropdown menu when the item is clicked.
-     *
-     * @default false
-     */
-    hideOnClick?: boolean;
-    /**
-     * The radio item's name.
-     */
-    name: string;
-    /**
-     * The radio item's value.
-     */
-    value: string | number;
-    /**
-     * The controlled checked state of the radio menu item.
-     */
-    checked?: boolean;
-    /**
-     * The checked state of the radio menu item when it is initially rendered.
-     * Use when not wanting to control its checked state.
-     */
-    defaultChecked?: boolean;
-    /**
-     * Event handler called when the checked radio menu item changes.
-     */
-    onChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
-}
-export interface DropdownMenuSeparatorProps {
-}
-//# sourceMappingURL=types.d.ts.map

package/build-types/dropdown-menu-v2-ariakit/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dropdown-menu-v2-ariakit/types.ts"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,CAAE,IAAI,EAAE,OAAO,KAAM,IAAI,CAAC;IACzC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,YAAY,CAAC,EACV,OAAO,GACP,CAAE,CACF,KAAK,EAAE,aAAa,GAAG,KAAK,CAAC,aAAa,CAAE,OAAO,CAAE,KAChD,OAAO,CAAE,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,6BAChB,SAAQ,IAAI,CAAE,qBAAqB,EAAE,QAAQ,GAAG,aAAa,CAAE;IAC/D;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAE,gBAAgB,CAAE,KAAM,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,0BAChB,SAAQ,IAAI,CAAE,qBAAqB,EAAE,QAAQ,GAAG,aAAa,CAAE;IAC/D;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAE,gBAAgB,CAAE,KAAM,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,0BAA0B;CAAG"}

package/build-types/mobile/inserter-button/sparkles.d.ts

@@ -1,3 +0,0 @@
-export default sparkles;
-declare const sparkles: JSX.Element;
-//# sourceMappingURL=sparkles.d.ts.map

package/build-types/mobile/inserter-button/sparkles.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sparkles.d.ts","sourceRoot":"","sources":["../../../src/mobile/inserter-button/sparkles.js"],"names":[],"mappings":";AAKA,oCAOE"}

package/src/dropdown-menu-v2-ariakit/README.md

@@ -1,331 +0,0 @@
-# `DropdownMenu` (v2)
-
-<div class="callout callout-alert">
-This feature is still experimental. “Experimental” means this is an early implementation subject to drastic and breaking changes.
-</div>
-
-`DropdownMenu` displays a menu to the user (such as a set of actions or functions) triggered by a button.
-
-
-## Design guidelines
-
-### Usage
-
-#### When to use a DropdownMenu
-
-Use a DropdownMenu when you want users to:
-
--   Choose an action or change a setting from a list, AND
--   Only see the available choices contextually.
-
-`DropdownMenu` is a React component to render an expandable menu of buttons. It is similar in purpose to a `<select>` element, with the distinction that it does not maintain a value. Instead, each option behaves as an action button.
-
-If you need to display all the available options at all times, consider using a Toolbar instead. Use a `DropdownMenu` to display a list of actions after the user interacts with a button.
-
-**Do**
-Use a `DropdownMenu` to display a list of actions after the user interacts with an icon.
-
-**Don’t** use a `DropdownMenu` for important actions that should always be visible. Use a `Toolbar` instead.
-
-**Don’t**
-Don’t use a `DropdownMenu` for frequently used actions. Use a `Toolbar` instead.
-
-#### Behavior
-
-Generally, the parent button should indicate that interacting with it will show a `DropdownMenu`.
-
-The parent button should retain the same visual styling regardless of whether the `DropdownMenu` is displayed or not.
-
-#### Placement
-
-The `DropdownMenu` should typically appear directly below, or below and to the left of, the parent button. If there isn’t enough space below to display the full `DropdownMenu`, it can be displayed instead above the parent button.
-
-## Development guidelines
-
-This component is still highly experimental, and it's not normally accessible to consumers of the `@wordpress/components` package.
-
-The component exposes a set of components that are meant to be used in combination with each other in order to implement a `DropdownMenu` correctly.
-
-### `DropdownMenu`
-
-The root component, used to specify the menu's trigger and its contents.
-
-#### Props
-
-The component accepts the following props:
-
-##### `trigger`: `React.ReactNode`
-
-The trigger button
-
-- Required: yes
-
-##### `children`: `React.ReactNode`
-
-The contents of the dropdown
-
-- Required: yes
-
-##### `defaultOpen`: `boolean`
-
-The open state of the dropdown menu when it is initially rendered. Use when not wanting to control its open state.
-
-- Required: no
-- Default: `false`
-
-##### `open`: `boolean`
-
-The controlled open state of the dropdown menu. Must be used in conjunction with `onOpenChange`.
-
-- Required: no
-
-##### `onOpenChange`: `(open: boolean) => void`
-
-Event handler called when the open state of the dropdown menu changes.
-
-- Required: no
-
-##### `modal`: `boolean`
-
-The modality of the dropdown menu. When set to true, interaction with outside elements will be disabled and only menu content will be visible to screen readers.
-
-- Required: no
-- Default: `true`
-
-##### `placement`: ``'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end'`
-
-The placement of the dropdown menu popover.
-
-- Required: no
-- Default: `'bottom-start'` for root-level menus, `'right-start'` for nested menus
-
-##### `gutter`: `number`
-
-The distance in pixels from the trigger.
-
-- Required: no
-- Default: `8` for root-level menus, `16` for nested menus
-
-##### `shift`: `number`
-
-The skidding of the popover along the anchor element. Can be set to negative values to make the popover shift to the opposite side.
-
-- Required: no
-- Default: `0` for root-level menus, `-8` for nested menus
-
-### `DropdownMenuItem`
-
-Used to render a menu item.
-
-#### Props
-
-The component accepts the following props:
-
-##### `children`: `React.ReactNode`
-
-The contents of the item
-
-- Required: yes
-
-##### `prefix`: `React.ReactNode`
-
-The contents of the item's prefix.
-
-- Required: no
-
-##### `suffix`: `React.ReactNode`
-
-The contents of the item's suffix.
-
-- Required: no
-
-##### `hideOnClick`: `boolean`
-
-Whether to hide the dropdown menu when the menu item is clicked.
-
-- Required: no
-- Default: `true`
-
-##### `disabled`: `boolean`
-
-Determines if the element is disabled.
-
-- Required: no
-- Default: `false`
-
-### `DropdownMenuCheckboxItem`
-
-Used to render a checkbox item.
-
-#### Props
-
-The component accepts the following props:
-
-##### `children`: `React.ReactNode`
-
-The contents of the item
-
-- Required: yes
-
-##### `suffix`: `React.ReactNode`
-
-The contents of the item's suffix.
-
-- Required: no
-
-##### `hideOnClick`: `boolean`
-
-Whether to hide the dropdown menu when the menu item is clicked.
-
-- Required: no
-- Default: `false`
-
-##### `disabled`: `boolean`
-
-Determines if the element is disabled.
-
-- Required: no
-- Default: `false`
-
-##### `name`: `string`
-
-The checkbox item's name.
-
-- Required: yes
-
-##### `value`: `string`
-
-The checkbox item's value, useful when using multiple checkbox items
- associated to the same `name`.
-
-- Required: no
-
-##### `checked`: `boolean`
-
-The checkbox item's value, useful when using multiple checkbox items
- associated to the same `name`.
-
-- Required: no
-
-##### `defaultChecked`: `boolean`
-
-The checked state of the checkbox menu item when it is initially rendered. Use when not wanting to control its checked state.
-
-- Required: no
-
-##### `onChange`: `( event: React.ChangeEvent< HTMLInputElement > ) => void;`
-
-Event handler called when the checked state of the checkbox menu item changes.
-
-- Required: no
-
-### `DropdownMenuRadioItem`
-
-Used to render a radio item.
-
-#### Props
-
-The component accepts the following props:
-
-##### `children`: `React.ReactNode`
-
-The contents of the item
-
-- Required: yes
-
-##### `suffix`: `React.ReactNode`
-
-The contents of the item's suffix.
-
-- Required: no
-
-##### `hideOnClick`: `boolean`
-
-Whether to hide the dropdown menu when the menu item is clicked.
-
-- Required: no
-- Default: `false`
-
-##### `disabled`: `boolean`
-
-Determines if the element is disabled.
-
-- Required: no
-- Default: `false`
-
-##### `name`: `string`
-
-The radio item's name.
-
-- Required: yes
-
-##### `value`: `string | number`
-
-The radio item's value.
-
-- Required: yes
-
-##### `checked`: `boolean`
-
-The checkbox item's value, useful when using multiple checkbox items
- associated to the same `name`.
-
-- Required: no
-
-##### `defaultChecked`: `boolean`
-
-The checked state of the radio menu item when it is initially rendered. Use when not wanting to control its checked state.
-
-- Required: no
-
-##### `onChange`: `( event: React.ChangeEvent< HTMLInputElement > ) => void;`
-
-Event handler called when the checked radio menu item changes.
-
-- Required: no
-
-### `DropdownMenuItemLabel`
-
-Used to render the menu item's label.
-
-#### Props
-
-The component accepts the following props:
-
-##### `children`: `React.ReactNode`
-
-The label contents.
-
-- Required: yes
-
-### `DropdownMenuItemHelpText`
-
-Used to render the menu item's help text.
-
-#### Props
-
-The component accepts the following props:
-
-##### `children`: `React.ReactNode`
-
-The help text contents.
-
-- Required: yes
-
-### `DropdownMenuGroup`
-
-Used to group menu items.
-
-#### Props
-
-The component accepts the following props:
-
-##### `children`: `React.ReactNode`
-
-The contents of the group.
-
-- Required: yes
-
-### `DropdownMenuSeparatorProps`
-
-Used to render a visual separator.