@wordpress/components 33.1.1-next.v.202605131006.0 → 34.0.0

package/build-types/navigation/types.d.ts

@@ -1,266 +0,0 @@
-/**
- * Internal dependencies
- */
-import type { ButtonProps } from '../button/types';
-type IfDiscriminantDefinedBothRequired<TDiscriminant, TOther> = {
-    [K in keyof (TDiscriminant & TOther)]: NonNullable<(TDiscriminant & TOther)[K]>;
-} | ({
-    [K in keyof TDiscriminant]?: never;
-} & {
-    [K in keyof TOther]?: TOther[K];
-});
-export type NavigationProps = {
-    /**
-     * The active item slug.
-     */
-    activeItem?: string;
-    /**
-     * The active menu slug.
-     *
-     * @default 'root'
-     */
-    activeMenu?: string;
-    /**
-     * The children components.
-     */
-    children?: React.ReactNode;
-    /**
-     * Optional classname for the component.
-     */
-    className?: string;
-    /**
-     * Callback used to sync the active menu between the external state
-     * and the Navigation's internal state.
-     */
-    onActivateMenu?: (activeMenuSlug: string) => void;
-};
-type _NavigationMenuSearchProps = IfDiscriminantDefinedBothRequired<{
-    /**
-     * When the `hasSearch` prop is `true`, this callback handles the search
-     * input's `onChange` event, making it controlled from the outside.
-     * When using this prop, the `search` prop should be also set.
-     */
-    onSearch: (searchString: string) => void;
-}, {
-    /**
-     * When the `hasSearch` is `true` and the `onSearch` prop is provided, this
-     * prop controls the value of the search input.
-     * Required when the `onSearch` prop is provided.
-     */
-    search: string;
-}>;
-export type NavigationMenuProps = _NavigationMenuSearchProps & {
-    /**
-     * The back button label used in nested menus.
-     * If not provided, the label will be inferred from the parent menu's title.
-     * If the parent menu's title is not available then it will default to "Back".
-     *
-     * @default parentMenuTitle ?? 'Back'
-     */
-    backButtonLabel?: string;
-    /**
-     * A callback to handle clicking on the back button.
-     * If this prop is provided then the back button will be shown.
-     */
-    onBackButtonClick?: React.MouseEventHandler<HTMLElement>;
-    /**
-     * The children components.
-     */
-    children?: React.ReactNode;
-    /**
-     * Optional classname for the component.
-     */
-    className?: string;
-    /**
-     * When `true`, enables the search feature on the menu title.
-     */
-    hasSearch?: boolean;
-    /**
-     * Indicates whether the menu is empty or not. Used together with the
-     * `hideIfTargetMenuEmpty` prop of `NavigationItem`.
-     */
-    isEmpty?: boolean;
-    /**
-     * Indicates whether the search is debouncing or not. In case of `true`, the
-     * "No results found." text is omitted. Used to prevent showing the
-     * "No results found." text between debounced searches.
-     */
-    isSearchDebouncing?: boolean;
-    /**
-     * The unique identifier of the menu.
-     * The root menu can omit this prop, and it will default to "root".
-     * All other menus need to specify it.
-     *
-     * @default 'root'
-     */
-    menu?: string;
-    /**
-     * The parent menu slug; used by nested menus to indicate their parent menu.
-     */
-    parentMenu?: string;
-    /**
-     * The menu title. It's also the field used by the menu search function.
-     */
-    title?: string;
-    /**
-     * Use this prop to render additional actions in the menu title.
-     */
-    titleAction?: React.ReactNode;
-};
-export type NavigationGroupProps = {
-    /**
-     * Optional classname for the component.
-     */
-    className?: string;
-    /**
-     * The group title.
-     */
-    title?: string;
-    /**
-     * The children components.
-     */
-    children: React.ReactNode;
-};
-type _NavigationItemButtonProps = (ButtonProps & {
-    /**
-     * If set to `true` the menu item will only act as a text-only item,
-     * rather than a `<button />` or `<a />` element.
-     */
-    isText?: false;
-}) | {
-    /**
-     * If set to `true` the menu item will only act as a text-only item,
-     * rather than a `<button />` or `<a />` element.
-     */
-    isText: true;
-};
-export type NavigationItemBaseProps = {
-    /**
-     * The item badge content.
-     */
-    badge?: string | number;
-    /**
-     * The children components. When not specified, the item will render the
-     * default item UI.
-     */
-    children?: React.ReactNode;
-    /**
-     * Optional classname for the component.
-     */
-    className?: string;
-    /**
-     * If provided, causes the component to render an `<a />` element
-     * instead of a `<button />` element.
-     */
-    href?: string;
-    /**
-     * If no `children` are passed, this prop allows to specify a custom icon for
-     * the menu item.
-     */
-    icon?: React.JSX.Element;
-    /**
-     * The unique identifier of the item.
-     */
-    item?: string;
-    /**
-     * The child menu slug. If provided, clicking on the item will navigate
-     * to the target menu.
-     */
-    navigateToMenu?: string;
-    /**
-     * Indicates whether this item should be hidden if the menu specified in
-     * `navigateToMenu` is marked as empty in the `isEmpty` prop.
-     * Used together with the `isEmpty` prop of `NavigationMenu`.
-     */
-    hideIfTargetMenuEmpty?: boolean;
-    /**
-     * A callback to handle clicking on a menu item.
-     *
-     * @default noop
-     */
-    onClick?: React.MouseEventHandler;
-    /**
-     * The item title.
-     */
-    title?: string;
-};
-export type NavigationItemProps = _NavigationItemButtonProps & NavigationItemBaseProps;
-export type NavigationItemBaseContentProps = Pick<NavigationItemProps, 'badge' | 'title'>;
-export type NavigationBackButtonProps = {
-    /**
-     * The text displayed for the button
-     */
-    backButtonLabel?: string;
-    /**
-     * Optional classname for the component.
-     */
-    className?: string;
-    /**
-     * If provided, causes the component to render an `<a />` element
-     * instead of a `<button />` element.
-     */
-    href?: string;
-    /**
-     * Callback function called when the button is clicked.
-     */
-    onClick?: React.MouseEventHandler;
-    /**
-     * Id of the parent menu
-     */
-    parentMenu?: string;
-};
-export type NavigationMenuTitleSearchProps = Pick<NavigationMenuProps, 'onSearch' | 'search' | 'title'> & {
-    debouncedSpeak: (message: string, ariaLive?: 'off' | 'polite' | 'assertive') => void;
-    onCloseSearch: () => void;
-};
-export type NavigationMenuTitleProps = Pick<NavigationMenuProps, 'hasSearch' | 'onSearch' | 'search' | 'title' | 'titleAction'>;
-export type NavigationSearchNoResultsFoundProps = Pick<NavigationMenuProps, 'search'>;
-export type Item = Omit<NavigationItemBaseProps, 'children'> & {
-    /**
-     * The group id
-     */
-    group?: string;
-    /**
-     * The menu id
-     */
-    menu?: string;
-    /**
-     * True is the item is currently visible (ie. the item is part
-     * of the active menu, and — if there is a search query — its title
-     * matches the search query).
-     */
-    _isVisible: boolean;
-};
-export type Menu = Omit<NavigationMenuProps, 'children'> & {
-    menu: string;
-};
-export type NavigationGroupContext = {
-    /**
-     * The unique id of the group
-     */
-    group?: string;
-};
-export type NavigationMenuContext = {
-    menu?: string;
-    search?: string;
-};
-export type NavigationContext = {
-    activeItem?: string;
-    activeMenu: string;
-    setActiveMenu: (parentMenu: string, animationDirection?: 'left' | 'right') => void;
-    navigationTree: {
-        items: Record<string, Item>;
-        getItem: (itemId: string) => Item | undefined;
-        addItem: (itemId: string, itemProps: Item) => void;
-        removeItem: (itemId: string) => void;
-        menus: Record<string, Menu>;
-        getMenu: (menuId: string) => Menu | undefined;
-        addMenu: (menuId: string, menuProps: Menu) => void;
-        removeMenu: (menuId: string) => void;
-        childMenu: Record<string, string[]>;
-        traverseMenu: (startMenu: string, callback: (menuObject: Menu) => boolean | undefined) => void;
-        isMenuEmpty: (menuId: string) => boolean;
-    };
-};
-export {};
-//# sourceMappingURL=types.d.ts.map

package/build-types/navigation/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/navigation/types.ts"],"names":[],"mappings":"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"}

package/build-types/navigation/use-create-navigation-tree.d.ts

@@ -1,15 +0,0 @@
-import type { Item, Menu } from './types';
-export declare const useCreateNavigationTree: () => {
-    items: Record<string, Omit<Item, "children">>;
-    getItem: (key: string) => Omit<Item, "children">;
-    addItem: (key: string, value: Item) => void;
-    removeItem: (key: string) => void;
-    menus: Record<string, Omit<Menu, "children">>;
-    getMenu: (key: string) => Omit<Menu, "children">;
-    addMenu: (key: string, value: Menu) => void;
-    removeMenu: (key: string) => void;
-    childMenu: Record<string, string[]>;
-    traverseMenu: (startMenu: string, callback: (menuObject: Menu) => boolean | undefined) => void;
-    isMenuEmpty: (menuToCheck: string) => boolean;
-};
-//# sourceMappingURL=use-create-navigation-tree.d.ts.map

package/build-types/navigation/use-create-navigation-tree.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-create-navigation-tree.d.ts","sourceRoot":"","sources":["../../src/navigation/use-create-navigation-tree.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAqB,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;mBAyElB,MAAM,SAAS,IAAI;;;;+BAvBD,MAAM;CA+CzC,CAAC"}

package/build-types/navigation/use-navigation-tree-nodes.d.ts

@@ -1,10 +0,0 @@
-export declare function useNavigationTreeNodes<TNode extends {
-    children?: React.ReactNode;
-    [key: string]: unknown;
-}>(): {
-    nodes: Record<string, Omit<TNode, "children">>;
-    getNode: (key: string) => Omit<TNode, "children">;
-    addNode: (key: string, value: TNode) => void;
-    removeNode: (key: string) => void;
-};
-//# sourceMappingURL=use-navigation-tree-nodes.d.ts.map

package/build-types/navigation/use-navigation-tree-nodes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-navigation-tree-nodes.d.ts","sourceRoot":"","sources":["../../src/navigation/use-navigation-tree-nodes.tsx"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,CACrC,KAAK,SAAS;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,CAAE,GAAG,EAAE,MAAM,GAAI,OAAO,CAAA;CAAE;;mBAM/C,MAAM;mBAEN,MAAM,SAAS,KAAK;;EAgB3C"}

package/build-types/navigation/utils.d.ts

@@ -1,3 +0,0 @@
-export declare const normalizeInput: (input: string) => string;
-export declare const normalizedSearch: (title: string, search: string) => boolean;
-//# sourceMappingURL=utils.d.ts.map

package/build-types/navigation/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/navigation/utils.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,UAAY,MAAM,WACa,CAAC;AAE3D,eAAO,MAAM,gBAAgB,UAAY,MAAM,UAAU,MAAM,YACI,CAAC"}

package/src/draggable/style.scss

@@ -1,21 +0,0 @@
-@use "@wordpress/base-styles/z-index" as *;
-
-body.is-dragging-components-draggable {
-	cursor: move;/* Fallback for IE/Edge < 14 */
-	cursor: grabbing !important;
-}
-
-.components-draggable__invisible-drag-image {
-	position: fixed;
-	left: -1000px;
-	height: 50px;
-	width: 50px;
-}
-
-.components-draggable__clone {
-	position: fixed;
-	padding: 0; // Should match clonePadding variable.
-	background: transparent;
-	pointer-events: none;
-	z-index: z-index(".components-draggable__clone");
-}

package/src/navigation/README.md

@@ -1,267 +0,0 @@
-# Navigation
-
-<div class="callout callout-alert">
-This component is deprecated. Consider using `Navigator` instead.
-</div>
-
-<div class="callout callout-alert">
-This feature is still experimental. “Experimental” means this is an early implementation subject to drastic and breaking changes.
-</div>
-
-Render a navigation list with optional groupings and hierarchy.
-
-## Usage
-
-```jsx
-import {
-	__experimentalNavigation as Navigation,
-	__experimentalNavigationGroup as NavigationGroup,
-	__experimentalNavigationItem as NavigationItem,
-	__experimentalNavigationMenu as NavigationMenu,
-} from '@wordpress/components';
-
-const MyNavigation = () => (
-	<Navigation>
-		<NavigationMenu title="Home">
-			<NavigationGroup title="Group 1">
-				<NavigationItem item="item-1" title="Item 1" />
-				<NavigationItem item="item-2" title="Item 2" />
-			</NavigationGroup>
-			<NavigationGroup title="Group 2">
-				<NavigationItem
-					item="item-3"
-					navigateToMenu="category"
-					title="Category"
-				/>
-			</NavigationGroup>
-		</NavigationMenu>
-
-		<NavigationMenu
-			backButtonLabel="Home"
-			menu="category"
-			parentMenu="root"
-			title="Category"
-		>
-			<NavigationItem badge="1" item="child-1" title="Child 1" />
-			<NavigationItem item="child-2" title="Child 2" />
-		</NavigationMenu>
-	</Navigation>
-);
-```
-
-## Navigation Props
-
-`Navigation` supports the following props.
-
-### `activeItem`
-
--   Type: `string`
--   Required: No
-
-The active item slug.
-
-### `activeMenu`
-
--   Type: `string`
--   Required: No
--   Default: "root"
-
-The active menu slug.
-
-### className
-
--   Type: `string`
--   Required: No
-
-Optional className for the `Navigation` component.
-
-### `onActivateMenu`
-
--   Type: `function`
--   Required: No
-
-Sync the active menu between the external state and the Navigation's internal state.
-
-## Navigation Menu Props
-
-`NavigationMenu` supports the following props.
-
-### `backButtonLabel`
-
--   Type: `string`
--   Required: No
--   Default: parent menu's title or "Back"
-
-The back button label used in nested menus. If not provided, the label will be inferred from the parent menu's title.
-If for some reason the parent menu's title is not available then it will default to "Back".
-
-### `onBackButtonClick`
-
--   Type: `function`
--   Required: No
-
-A callback to handle clicking on the back button. If this prop is provided then the back button will be shown.
-
-### className
-
--   Type: `string`
--   Required: No
-
-Optional className for the `NavigationMenu` component.
-
-### hasSearch
-
--   Type: `boolean`
--   Required: No
-
-Enable the search feature on the menu title.
-
-### `menu`
-
--   Type: `string`
--   Required: No
--   Default: "root"
-
-The unique identifier of the menu. The root menu can omit this, and it will default to "root"; all other menus need to specify it.
-
-### onSearch
-
--   Type: `( searchString: string ) => void;`
--   Required: No
-
-When `hasSearch` is active, this function handles the search input's `onChange` event, making it controlled from the outside. It requires setting the `search` prop as well.
-
-### isSearchDebouncing
-
--   Type: `boolean`
--   Required: No
-
-Indicates whether the search is debouncing or not. In case of `true` the "No results found." text is omitted. Used to prevent showing "No results found." text between debounced searches.
-
-### `parentMenu`
-
--   Type: `string`
--   Required: No
-
-The parent menu slug; used by nested menus to indicate their parent menu.
-
-### search
-
--   Type: `string`
--   Required: No
-
-When `hasSearch` is active and `onSearch` is provided, this controls the value of the search input. Required when the `onSearch` prop is provided.
-
-### `isEmpty`
-
--   Type: `boolean`
--   Required: No
-
-Indicates whether the menu is empty or not. Used together with the `hideIfTargetMenuEmpty` prop of Navigation Item.
-
-### `title`
-
--   Type: `string`
--   Required: No
-
-The menu title. It's also the field used by the menu search function.
-
-### `titleAction`
-
--   Type: `React.ReactNode`
--   Required: No
-
-Use this prop to render additional actions in the menu title.
-
-## Navigation Group Props
-
-`NavigationGroup` supports the following props.
-
-### className
-
--   Type: `string`
--   Required: No
-
-Optional className for the `NavigationGroup` component.
-
-### `title`
-
--   Type: `string`
--   Required: No
-
-The group title.
-
-## Navigation Item Props
-
-`NavigationItem` supports the following props.
-
-### `badge`
-
--   Type: `string|Number`
--   Required: No
-
-The item badge content.
-
-### className
-
--   Type: `string`
--   Required: No
-
-Optional className for the `NavigationItem` component.
-
-### `href`
-
--   Type: `string`
--   Required: No
-
-If provided, renders `a` instead of `button`.
-
-### `icon`
-
--   Type: `React.JSX.Element`
--   Required: No
-
-If no `children` are passed, this prop allows to specify a custom icon for the menu item.
-
-### `item`
-
--   Type: `string`
--   Required: No
-
-The unique identifier of the item.
-
-### `navigateToMenu`
-
--   Type: `string`
--   Required: No
-
-The child menu slug. If provided, clicking on the item will navigate to the target menu.
-
-### `hideIfTargetMenuEmpty`
-
--   Type: `boolean`
--   Required: No
-
-Indicates whether this item should be hidden if the menu specified in `navigateToMenu` is marked as empty in the `isEmpty` prop. Used together with the `isEmpty` prop of Navigation Menu.
-
-### `onClick`
-
--   Type: `React.MouseEventHandler`
--   Required: No
-
-A callback to handle clicking on a menu item.
-
-### `isText`
-
--   Type: `boolean`
--   Required: No
--   Default: false
-
-If set to true then the menu item will only act as a text-only item rather than a button.
-
-### `title`
-
--   Type: `string`
--   Required: No
-
-The item title.

package/src/navigation/back-button/index.tsx

@@ -1,73 +0,0 @@
-/**
- * External dependencies
- */
-import clsx from 'clsx';
-/**
- * WordPress dependencies
- */
-import { forwardRef } from '@wordpress/element';
-import { __, isRTL } from '@wordpress/i18n';
-import { Icon, chevronLeft, chevronRight } from '@wordpress/icons';
-
-/**
- * Internal dependencies
- */
-import { useNavigationContext } from '../context';
-import { MenuBackButtonUI } from '../styles/navigation-styles';
-
-import type { NavigationBackButtonProps } from '../types';
-
-function UnforwardedNavigationBackButton(
-	{
-		backButtonLabel,
-		className,
-		href,
-		onClick,
-		parentMenu,
-	}: NavigationBackButtonProps,
-	ref: React.ForwardedRef< HTMLAnchorElement | HTMLButtonElement >
-) {
-	const { setActiveMenu, navigationTree } = useNavigationContext();
-
-	const classes = clsx( 'components-navigation__back-button', className );
-
-	const parentMenuTitle =
-		parentMenu !== undefined
-			? navigationTree.getMenu( parentMenu )?.title
-			: undefined;
-
-	const handleOnClick: React.MouseEventHandler< HTMLElement > = ( event ) => {
-		if ( typeof onClick === 'function' ) {
-			onClick( event );
-		}
-
-		const animationDirection = isRTL() ? 'left' : 'right';
-		if ( parentMenu && ! event.defaultPrevented ) {
-			setActiveMenu( parentMenu, animationDirection );
-		}
-	};
-	const icon = isRTL() ? chevronRight : chevronLeft;
-	return (
-		<MenuBackButtonUI
-			__next40pxDefaultSize
-			className={ classes }
-			href={ href }
-			variant="tertiary"
-			ref={ ref }
-			onClick={ handleOnClick }
-		>
-			<Icon icon={ icon } />
-			{ backButtonLabel || parentMenuTitle || __( 'Back' ) }
-		</MenuBackButtonUI>
-	);
-}
-
-/**
- * @deprecated Use `Navigator` instead.
- */
-export const NavigationBackButton = forwardRef(
-	UnforwardedNavigationBackButton
-);
-NavigationBackButton.displayName = 'NavigationBackButton';
-
-export default NavigationBackButton;

package/src/navigation/constants.tsx

@@ -1,2 +0,0 @@
-export const ROOT_MENU = 'root';
-export const SEARCH_FOCUS_DELAY = 100;