@types/wordpress__block-editor 11.5.12 → 11.5.14

wordpress__block-editor/README.md

@@ -8,8 +8,8 @@ This package contains type definitions for @wordpress/block-editor (https://gith
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/wordpress__block-editor.
 
 ### Additional Details
- * Last updated: Sat, 16 Mar 2024 12:09:31 GMT
- * Dependencies: [@types/react](https://npmjs.com/package/@types/react), [@types/wordpress__blocks](https://npmjs.com/package/@types/wordpress__blocks), [@types/wordpress__components](https://npmjs.com/package/@types/wordpress__components), [@types/wordpress__keycodes](https://npmjs.com/package/@types/wordpress__keycodes), [@wordpress/data](https://npmjs.com/package/@wordpress/data), [@wordpress/element](https://npmjs.com/package/@wordpress/element), [react-autosize-textarea](https://npmjs.com/package/react-autosize-textarea)
+ * Last updated: Wed, 03 Apr 2024 18:35:48 GMT
+ * Dependencies: [@types/react](https://npmjs.com/package/@types/react), [@types/wordpress__blocks](https://npmjs.com/package/@types/wordpress__blocks), [@wordpress/components](https://npmjs.com/package/@wordpress/components), [@wordpress/data](https://npmjs.com/package/@wordpress/data), [@wordpress/element](https://npmjs.com/package/@wordpress/element), [@wordpress/keycodes](https://npmjs.com/package/@wordpress/keycodes), [react-autosize-textarea](https://npmjs.com/package/react-autosize-textarea)
 
 # Credits
 These definitions were written by [Derek Sifford](https://github.com/dsifford), [Jon Surrell](https://github.com/sirreal), and [Dennis Snell](https://github.com/dmsnell).

wordpress__block-editor/components/alignment-toolbar.d.ts

@@ -1,12 +1,12 @@
-import { Dashicon } from "@wordpress/components";
-import { ComponentType, JSX } from "react";
+import { IconType } from "@wordpress/components";
+import { ComponentType } from "react";
 
 declare namespace AlignmentToolbar {
     interface Props {
         alignmentControls?:
             | Array<{
                 align: string;
-                icon: Dashicon.Icon | JSX.Element;
+                icon: IconType;
                 title: string;
             }>
             | undefined;

wordpress__block-editor/components/block-controls.d.ts

@@ -1,14 +1,29 @@
-import { Slot, Toolbar } from "@wordpress/components";
-import { FC, JSX, ReactNode } from "react";
+import { Slot, ToolbarGroup } from "@wordpress/components";
+import { ComponentProps, FC, JSX, ReactNode } from "react";
+
+type GetArrayTypeFromPossibleNestedArray<TestType extends Record<string, unknown> | Array<Record<string, unknown>>> =
+    TestType extends Array<Record<string, unknown>> ? TestType[number] : TestType;
+type BlockControlControlsType = GetArrayTypeFromPossibleNestedArray<
+    NonNullable<Parameters<typeof ToolbarGroup>[0]["controls"]>[number]
+>;
 
 declare namespace BlockControls {
-    interface Props extends Pick<Toolbar.Props, "controls"> {
+    type BlockControlGroup =
+        | "default"
+        | "block"
+        | "inline"
+        | "other"
+        | "parent";
+
+    interface Props {
+        controls?: Array<BlockControlControlsType | BlockControlControlsType[]>;
         children: ReactNode;
+        group?: BlockControlGroup | undefined;
     }
 }
 declare const BlockControls: {
     (props: BlockControls.Props): JSX.Element;
-    Slot: FC<Omit<Slot.Props, "name">>;
+    Slot: FC<Omit<ComponentProps<typeof Slot>, "name">>;
 };
 
 export default BlockControls;

wordpress__block-editor/components/block-format-controls.d.ts

@@ -1,5 +1,5 @@
 import { Slot } from "@wordpress/components";
-import { FC, JSX, ReactNode } from "react";
+import { ComponentProps, FC, JSX, ReactNode } from "react";
 
 declare namespace BlockFormatControls {
     interface Props {
@@ -8,7 +8,7 @@ declare namespace BlockFormatControls {
 }
 declare const BlockFormatControls: {
     (props: BlockFormatControls.Props): JSX.Element;
-    Slot: FC<Omit<Slot.Props, "name">>;
+    Slot: FC<Omit<ComponentProps<typeof Slot>, "name">>;
 };
 
 export default BlockFormatControls;

wordpress__block-editor/components/block-icon.d.ts

@@ -1,10 +1,10 @@
-import { Icon } from "@wordpress/components";
+import { IconType } from "@wordpress/components";
 import { ComponentType } from "react";
 
 declare namespace BlockIcon {
     interface Props {
         className?: string | undefined;
-        icon: Icon.Props<any>["icon"];
+        icon: IconType | null;
         showColors?: boolean | undefined;
     }
 }

wordpress__block-editor/components/font-sizes.d.ts

@@ -1,10 +1,10 @@
-import { FontSizePicker as FSP } from "@wordpress/components";
-import { ComponentType } from "react";
+import { FontSizePicker as FSP } from "@wordpress/components/";
+import { ComponentProps, ComponentType } from "react";
 
 import { EditorFontSize } from "../";
 
 export namespace FontSizePicker {
-    type Props = Omit<FSP.Props, "disableCustomFontSizes" | "fontSizes">;
+    type Props = Omit<ComponentProps<typeof FSP>, "disableCustomFontSizes" | "fontSizes">;
 }
 export const FontSizePicker: ComponentType<FontSizePicker.Props>;
 

wordpress__block-editor/components/inner-blocks.d.ts

@@ -1,5 +1,5 @@
 import { TemplateArray } from "@wordpress/blocks";
-import { ComponentType, JSX, Ref } from "react";
+import { ComponentType, JSX, ReactElement, Ref } from "react";
 
 import { EditorTemplateLock } from "../";
 
@@ -40,6 +40,22 @@ declare namespace InnerBlocks {
          * If the block is a top level block: the locking of the Custom Post Type is used.
          */
         templateLock?: EditorTemplateLock | undefined;
+
+        /**
+         * By default, InnerBlocks expects its blocks to be shown in a vertical list. A valid use-case is to style inner blocks to appear
+         * horizontally, for instance by adding CSS flex or grid properties to the inner blocks wrapper. When blocks are styled in such
+         * a way, the orientation prop can be set to indicate that a horizontal layout is being used.
+         * Specifying this prop does not affect the layout of the inner blocks, but results in the block mover icons in the child blocks
+         * being displayed horizontally, and also ensures that drag and drop works correctly.
+         */
+        orientation?: "vertical" | "horizontal" | undefined;
+
+        /**
+         * Determines which block types should be shown in the block inserter. For example, when inserting a block within the Navigation
+         * block we specify `core/navigation-link` and `core/navigation-link/page` as these are the most commonly used inner blocks.
+         * `prioritizedInserterBlocks` takes an array of the form {blockName}/{variationName}, where {variationName} is optional.
+         */
+        prioritizedInserterBlocks?: string[] | undefined;
     }
 }
 declare const InnerBlocks: {
@@ -61,7 +77,9 @@ export interface UseInnerBlocksProps {
     <Props extends Record<string, unknown>>(
         props?: Props & { ref?: Ref<unknown> },
         options?: InnerBlocks.Props,
-    ): Omit<Props, "ref"> & Merged & Reserved;
+    ): Omit<Props, "ref"> & Merged & Reserved & {
+        children: ReactElement;
+    };
 
     save: (props?: Record<string, unknown>) => Record<string, unknown>;
 }

wordpress__block-editor/components/inserter.d.ts

@@ -1,8 +1,8 @@
 import { Dropdown } from "@wordpress/components";
-import { ComponentType } from "react";
+import { ComponentProps, ComponentType } from "react";
 
 declare namespace Inserter {
-    interface Props extends Partial<Pick<Dropdown.Props, "position" | "renderToggle">> {
+    interface Props extends Partial<Pick<ComponentProps<typeof Dropdown>, "position" | "renderToggle">> {
         clientId?: string | undefined;
         disabled?: boolean | undefined;
         isAppender?: boolean | undefined;

wordpress__block-editor/components/inspector-advanced-controls.d.ts

@@ -1,5 +1,5 @@
 import { Slot } from "@wordpress/components";
-import { FC, JSX, ReactNode } from "react";
+import { ComponentProps, FC, JSX, ReactNode } from "react";
 
 declare namespace InspectorAdvancedControls {
     interface Props {
@@ -8,7 +8,7 @@ declare namespace InspectorAdvancedControls {
 }
 declare const InspectorAdvancedControls: {
     (props: InspectorAdvancedControls.Props): JSX.Element;
-    Slot: FC<Omit<Slot.Props, "name">>;
+    Slot: FC<Omit<ComponentProps<typeof Slot>, "name">>;
 };
 
 export default InspectorAdvancedControls;

wordpress__block-editor/components/inspector-controls.d.ts

@@ -1,5 +1,5 @@
 import { Slot } from "@wordpress/components";
-import { FC, JSX, ReactNode } from "react";
+import { ComponentProps, FC, JSX, ReactNode } from "react";
 
 declare namespace InspectorControls {
     interface Props {
@@ -9,7 +9,7 @@ declare namespace InspectorControls {
 }
 declare const InspectorControls: {
     (props: InspectorControls.Props): JSX.Element;
-    Slot: FC<Omit<Slot.Props, "name">>;
+    Slot: FC<Omit<ComponentProps<typeof Slot>, "name">>;
 };
 
 export default InspectorControls;

wordpress__block-editor/components/media-placeholder.d.ts

@@ -1,11 +1,11 @@
 /* eslint-disable @definitelytyped/no-unnecessary-generics */
-import { Dashicon, DropZone } from "@wordpress/components";
-import { ComponentType, JSX, MouseEventHandler } from "react";
+import { DropZone, IconType } from "@wordpress/components";
+import { ComponentProps, JSX, MouseEventHandler } from "react";
 
 declare namespace MediaPlaceholder {
     type MediaPlaceholderMultipleAction = "add";
 
-    interface Props<T extends boolean> extends Pick<DropZone.Props, "onHTMLDrop"> {
+    interface Props<T extends boolean> extends Pick<ComponentProps<typeof DropZone>, "onHTMLDrop"> {
         /**
          * A string passed to `FormFileUpload` that tells the browser which file types can be uploaded
          * to the upload window the browser use e.g: `image#<{(|,video#<{(|`.
@@ -47,7 +47,7 @@ declare namespace MediaPlaceholder {
         /**
          * Icon to display left of the title.
          */
-        icon?: Dashicon.Icon | JSX.Element | undefined;
+        icon?: IconType | undefined;
         /**
          * If `true`, the property changes the look of the placeholder to be adequate to scenarios
          * where new files are added to an already existing set of files, e.g., adding files to a

wordpress__block-editor/components/navigable-toolbar.d.ts

@@ -1,8 +1,8 @@
 import { NavigableMenu } from "@wordpress/components";
-import { ComponentType } from "react";
+import { ComponentProps, ComponentType } from "react";
 
 declare namespace NavigableToolbar {
-    interface Props extends NavigableMenu.Props {
+    interface Props extends ComponentProps<typeof NavigableMenu> {
         focusOnMount?: boolean | undefined;
     }
 }

wordpress__block-editor/components/panel-color-settings.d.ts

@@ -1,12 +1,12 @@
 import { ColorPalette, PanelBody } from "@wordpress/components";
-import { ComponentType } from "react";
+import { ComponentProps, ComponentType } from "react";
 
 declare namespace PanelColorSettings {
     type ColorSetting =
-        & Partial<ColorPalette.Props>
-        & Pick<ColorPalette.Props, "onChange" | "value">
+        & Partial<ComponentProps<typeof ColorPalette>>
+        & Pick<ComponentProps<typeof ColorPalette>, "onChange" | "value">
         & { label: string };
-    interface Props extends Omit<PanelBody.Props, "children"> {
+    interface Props extends Omit<ComponentProps<typeof PanelBody>, "children"> {
         colorSettings: ColorSetting[];
         disableCustomColors?: boolean | undefined;
     }

wordpress__block-editor/components/rich-text.d.ts

@@ -2,7 +2,7 @@
 import { BlockInstance } from "@wordpress/blocks";
 import { Autocomplete, ToolbarButton } from "@wordpress/components";
 import { displayShortcut, rawShortcut } from "@wordpress/keycodes";
-import { ComponentType, HTMLProps, JSX, ReactNode } from "react";
+import { ComponentProps, ComponentType, HTMLProps, JSX } from "react";
 
 declare namespace RichText {
     interface Props<T extends keyof HTMLElementTagNameMap> extends Omit<HTMLProps<T>, "onChange"> {
@@ -14,7 +14,7 @@ declare namespace RichText {
         /**
          * A list of autocompleters to use instead of the default.
          */
-        autocompleters?: Array<Autocomplete.Completer<any>> | undefined;
+        autocompleters?: ComponentProps<typeof Autocomplete>["completers"] | undefined;
         children?: never | undefined;
         className?: string | undefined;
         identifier?: string | undefined;
@@ -48,7 +48,7 @@ declare namespace RichText {
          * off. Here you should create a new block with that content and return it. Note that you
          * also need to provide `onReplace` in order for this to take any effect.
          */
-        onSplit?(value: string): void;
+        onSplit?(value: string, isOriginal?: boolean): void;
         onTagNameChange?(tagName: keyof HTMLElementTagNameMap): void;
         /**
          * Placeholder text to show when the field is empty, similar to the `input` and `textarea`
@@ -94,7 +94,7 @@ export namespace RichTextShortcut {
 export const RichTextShortcut: ComponentType<RichTextShortcut.Props>;
 
 export namespace RichTextToolbarButton {
-    interface Props extends ToolbarButton.Props {
+    interface Props extends ComponentProps<typeof ToolbarButton> {
         name?: string | undefined;
         shortcutType?: keyof typeof displayShortcut | undefined;
         shortcutCharacter?: string | undefined;

wordpress__block-editor/components/url-popover.d.ts

@@ -1,8 +1,8 @@
 import { Popover } from "@wordpress/components";
-import { ComponentType, JSX, ReactNode } from "react";
+import { ComponentProps, ComponentType, JSX, ReactNode } from "react";
 
 declare namespace URLPopover {
-    interface Props extends Popover.Props {
+    type Props = ComponentProps<typeof Popover> & {
         additionalControls?: ReactNode | undefined;
         /**
          * Callback used to return the React Elements that will be rendered inside the settings
@@ -10,7 +10,7 @@ declare namespace URLPopover {
          * that allows the user to open and close the settings drawer.
          */
         renderSettings?(): JSX.Element;
-    }
+    };
 }
 declare const URLPopover: ComponentType<URLPopover.Props>;
 

wordpress__block-editor/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/wordpress__block-editor",
-    "version": "11.5.12",
+    "version": "11.5.14",
     "description": "TypeScript definitions for @wordpress/block-editor",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/wordpress__block-editor",
     "license": "MIT",
@@ -32,12 +32,12 @@
     "dependencies": {
         "@types/react": "*",
         "@types/wordpress__blocks": "*",
-        "@types/wordpress__components": "*",
-        "@types/wordpress__keycodes": "*",
         "@wordpress/data": "^9.13.0",
+        "@wordpress/components": "^27.2.0",
         "@wordpress/element": "^5.0.0",
+        "@wordpress/keycodes": "^3.54.0",
         "react-autosize-textarea": "^7.1.0"
     },
-    "typesPublisherContentHash": "1d55a5822166f52b50696464fca3b46ddc96210549b93aec73129f2df6feaa38",
+    "typesPublisherContentHash": "19c44a95a4e9d75add8b0f3743db26b18e6f783247a17a26ea40252a0cfe4c27",
     "typeScriptVersion": "4.7"
 }