@wordpress/block-editor 16.1.0 → 16.2.0

package/build-types/components/block-visibility/constants.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The viewports for which block visibility can be controlled.
+ */
+export type BlockVisibilityViewport = 'desktop' | 'tablet' | 'mobile';
+/**
+ * The choices for the block visibility.
+ *
+ * Duplicated in packages/editor/src/components/preview-dropdown/index.js (choices array)
+ * and packages/edit-site/src/components/block-editor/use-viewport-sync.js
+ * (VALID_DEVICE_TYPES). Update all three when adding new viewport types.
+ *
+ * @todo create a single source of truth for the viewport types.
+ */
+export declare const BLOCK_VISIBILITY_VIEWPORTS: {
+    desktop: {
+        label: import("@wordpress/i18n").TransformedText<"Desktop">;
+        icon: import("react").JSX.Element;
+        key: "desktop";
+    };
+    tablet: {
+        label: import("@wordpress/i18n").TransformedText<"Tablet">;
+        icon: import("react").JSX.Element;
+        key: "tablet";
+    };
+    mobile: {
+        label: import("@wordpress/i18n").TransformedText<"Mobile">;
+        icon: import("react").JSX.Element;
+        key: "mobile";
+    };
+};
+export declare const BLOCK_VISIBILITY_VIEWPORT_ENTRIES: [string, {
+    label: import("@wordpress/i18n").TransformedText<"Desktop">;
+    icon: import("react").JSX.Element;
+    key: "desktop";
+} | {
+    label: import("@wordpress/i18n").TransformedText<"Tablet">;
+    icon: import("react").JSX.Element;
+    key: "tablet";
+} | {
+    label: import("@wordpress/i18n").TransformedText<"Mobile">;
+    icon: import("react").JSX.Element;
+    key: "mobile";
+}][];
+//# sourceMappingURL=constants.d.ts.map

package/build-types/components/block-visibility/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/block-visibility/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;CAmBtC,CAAC;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;IAE7C,CAAC"}

package/build-types/components/block-visibility/use-block-visibility.d.ts

@@ -0,0 +1,35 @@
+import type { BlockVisibilityViewport } from './constants';
+/**
+ * Viewport breakpoints keyed by viewport. Desktop has no breakpoint: it
+ * applies above the largest configured one.
+ */
+type ViewportBreakpoints = Partial<Record<'mobile' | 'tablet', string>>;
+/**
+ * Block visibility metadata: `false` hides the block on all viewports,
+ * per-viewport `false` flags hide it on specific viewports.
+ */
+export type BlockVisibility = boolean | {
+    viewport?: Partial<Record<BlockVisibilityViewport, boolean>>;
+};
+type UseBlockVisibilityOptions = {
+    blockVisibility?: BlockVisibility;
+    deviceType?: BlockVisibilityViewport;
+    viewportSettings?: ViewportBreakpoints;
+    view?: Window;
+};
+/**
+ * Returns information about the current block visibility state.
+ *
+ * @param options                  Parameters to avoid extra store subscriptions.
+ * @param options.blockVisibility  Block visibility metadata.
+ * @param options.deviceType       Current device type.
+ * @param options.viewportSettings Viewport breakpoint settings.
+ * @param options.view             Window instance in which to perform viewport matching.
+ * @return Object with `isBlockCurrentlyHidden` and `currentViewport` properties.
+ */
+export default function useBlockVisibility({ blockVisibility, deviceType, viewportSettings, view, }?: UseBlockVisibilityOptions): {
+    isBlockCurrentlyHidden: boolean;
+    currentViewport: BlockVisibilityViewport;
+};
+export {};
+//# sourceMappingURL=use-block-visibility.d.ts.map

package/build-types/components/block-visibility/use-block-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-block-visibility.d.ts","sourceRoot":"","sources":["../../../src/components/block-visibility/use-block-visibility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D;;;GAGG;AACH,KAAK,mBAAmB,GAAG,OAAO,CAAE,MAAM,CAAE,QAAQ,GAAG,QAAQ,EAAE,MAAM,CAAE,CAAE,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,eAAe,GACxB,OAAO,GACP;IACA,QAAQ,CAAC,EAAE,OAAO,CAAE,MAAM,CAAE,uBAAuB,EAAE,OAAO,CAAE,CAAE,CAAC;CAChE,CAAC;AAQL,KAAK,yBAAyB,GAAG;IAChC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAE,EAC3C,eAAe,EACf,UAAsB,EACtB,gBAAgB,EAChB,IAAa,GACb,GAAE,yBAA8B,GAAI;IACpC,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,uBAAuB,CAAC;CACzC,CAuCA"}

package/build-types/lock-unlock.d.ts

@@ -0,0 +1,2 @@
+export declare const lock: (object: unknown, privateData: unknown) => void, unlock: <T = any>(object: unknown) => T;
+//# sourceMappingURL=lock-unlock.d.ts.map

package/build-types/lock-unlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-unlock.d.ts","sourceRoot":"","sources":["../src/lock-unlock.ts"],"names":[],"mappings":"AAEA,eAAO,MAAQ,IAAI,mDAAE,MAAM,iCAIzB,CAAC"}

package/build-types/utils/fit-text-frontend.d.ts

@@ -1,7 +1,2 @@
-/**
- * Frontend fit text functionality.
- * Automatically detects and initializes fit text on blocks with the has-fit-text class.
- * Supports both initial page load and Interactivity API client-side navigation.
- */
 export {};
 //# sourceMappingURL=fit-text-frontend.d.ts.map

package/build-types/utils/fit-text-frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fit-text-frontend.d.ts","sourceRoot":"","sources":["../../src/utils/fit-text-frontend.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
+{"version":3,"file":"fit-text-frontend.d.ts","sourceRoot":"","sources":["../../src/utils/fit-text-frontend.ts"],"names":[],"mappings":""}

package/build-types/utils/format-font-style.d.ts

@@ -1,6 +1,3 @@
-/**
- * Internal dependencies
- */
 import type { FormattedFont } from './types';
 /**
  * Formats font styles to human readable names.

package/build-types/utils/format-font-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-font-style.d.ts","sourceRoot":"","sources":["../../src/utils/format-font-style.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,GAC3C,aAAa,CA4Bf"}
+{"version":3,"file":"format-font-style.d.ts","sourceRoot":"","sources":["../../src/utils/format-font-style.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,GAC3C,aAAa,CA4Bf"}

package/build-types/utils/format-font-weight.d.ts

@@ -1,6 +1,3 @@
-/**
- * Internal dependencies
- */
 import type { FormattedFont } from './types';
 /**
  * Formats font weights to human readable names.

package/build-types/utils/format-font-weight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-font-weight.d.ts","sourceRoot":"","sources":["../../src/utils/format-font-weight.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,GAC5C,aAAa,CAmDf"}
+{"version":3,"file":"format-font-weight.d.ts","sourceRoot":"","sources":["../../src/utils/format-font-weight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,GAC5C,aAAa,CAmDf"}

package/build-types/utils/get-font-styles-and-weights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-font-styles-and-weights.d.ts","sourceRoot":"","sources":["../../src/utils/get-font-styles-and-weights.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,MAAM,SAAS,CAAC;AAwDjB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,eAAe,EAAE,cAAc,EAAE,GAAG,SAAS;;;;;;EA4H7C"}
+{"version":3,"file":"get-font-styles-and-weights.d.ts","sourceRoot":"","sources":["../../src/utils/get-font-styles-and-weights.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,MAAM,SAAS,CAAC;AAwDjB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,eAAe,EAAE,cAAc,EAAE,GAAG,SAAS;;;;;;EA4H7C"}

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

@@ -1 +1 @@
-{"version":3,"file":"pasting.d.ts","sourceRoot":"","sources":["../../src/utils/pasting.ts"],"names":[],"mappings":"AAkDA,wBAAgB,iBAAiB,CAAE,EAClC,aAAa,GACb,EAAE;IACF,aAAa,EAAE,YAAY,CAAC;CAC5B;;;;;;;;cA2BA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,WA+BZ"}
+{"version":3,"file":"pasting.d.ts","sourceRoot":"","sources":["../../src/utils/pasting.ts"],"names":[],"mappings":"AA+CA,wBAAgB,iBAAiB,CAAE,EAClC,aAAa,GACb,EAAE;IACF,aAAa,EAAE,YAAY,CAAC;CAC5B;;;;;;;;cA2BA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,WA+BZ"}

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

@@ -1 +1 @@
-{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/utils/selection.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,GAAG,SAAS,sBAetD;AAED,KAAK,uBAAuB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAE,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAE,CAAC;CAClD,CAAC;AAEF,wBAAgB,wBAAwB,CAAE,SAAS,EAAE,uBAAuB,sBAO3E"}
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/utils/selection.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,GAAG,SAAS,sBAetD;AAED,KAAK,uBAAuB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAE,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAE,CAAC;CAClD,CAAC;AAEF,wBAAgB,wBAAwB,CAAE,SAAS,EAAE,uBAAuB,sBAO3E"}

package/build-types/utils/transform-styles/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * Internal dependencies
- */
 import type { EditorStyle, TransformOptions } from './types';
 /**
  * Applies a series of CSS rule transforms to wrap selectors inside a given class and/or rewrite URLs depending on the parameters passed.

package/build-types/utils/transform-styles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/transform-styles/index.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAyJ7D;;;;;;;GAOG;AACH,QAAA,MAAM,eAAe,WACZ,WAAW,EAAE,+CAEF,gBAAgB,UAenC,CAAC;eAEa,eAAe"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/transform-styles/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAyJ7D;;;;;;;GAOG;AACH,QAAA,MAAM,eAAe,WACZ,WAAW,EAAE,+CAEF,gBAAgB,UAenC,CAAC;eAEa,eAAe"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/block-editor",
-	"version": "16.1.0",
+	"version": "16.2.0",
 	"description": "Generic block editor.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -60,43 +60,44 @@
 	],
 	"dependencies": {
 		"@react-spring/web": "^9.4.5",
-		"@wordpress/a11y": "^4.52.0",
-		"@wordpress/base-styles": "^12.0.0",
-		"@wordpress/blob": "^4.52.0",
-		"@wordpress/block-serialization-default-parser": "^5.52.0",
-		"@wordpress/blocks": "^15.25.0",
-		"@wordpress/commands": "^1.52.0",
-		"@wordpress/components": "^38.0.0",
-		"@wordpress/compose": "^8.5.0",
-		"@wordpress/data": "^10.52.0",
-		"@wordpress/dataviews": "^17.3.0",
-		"@wordpress/date": "^5.52.0",
-		"@wordpress/deprecated": "^4.52.0",
-		"@wordpress/dom": "^4.52.0",
-		"@wordpress/element": "^8.4.0",
-		"@wordpress/escape-html": "^3.52.0",
-		"@wordpress/global-styles-engine": "^1.19.0",
-		"@wordpress/hooks": "^4.52.0",
-		"@wordpress/html-entities": "^4.52.0",
-		"@wordpress/i18n": "^6.25.0",
-		"@wordpress/icons": "^15.3.0",
-		"@wordpress/image-cropper": "^1.16.0",
-		"@wordpress/interactivity": "^6.52.0",
-		"@wordpress/is-shallow-equal": "^5.52.0",
-		"@wordpress/keyboard-shortcuts": "^5.52.0",
-		"@wordpress/keycodes": "^4.52.0",
-		"@wordpress/notices": "^5.52.0",
-		"@wordpress/preferences": "^4.52.0",
-		"@wordpress/priority-queue": "^3.52.0",
-		"@wordpress/private-apis": "^1.52.0",
-		"@wordpress/rich-text": "^7.52.0",
-		"@wordpress/style-engine": "^2.52.0",
-		"@wordpress/token-list": "^3.52.0",
-		"@wordpress/ui": "^0.19.0",
-		"@wordpress/upload-media": "^0.37.0",
-		"@wordpress/url": "^4.52.0",
-		"@wordpress/warning": "^3.52.0",
-		"@wordpress/wordcount": "^4.52.0",
+		"@wordpress/a11y": "^4.53.0",
+		"@wordpress/base-styles": "^12.1.0",
+		"@wordpress/blob": "^4.53.0",
+		"@wordpress/block-serialization-default-parser": "^5.53.0",
+		"@wordpress/blocks": "^15.26.0",
+		"@wordpress/commands": "^1.53.0",
+		"@wordpress/components": "^39.0.0",
+		"@wordpress/compose": "^8.6.0",
+		"@wordpress/data": "^10.53.0",
+		"@wordpress/dataviews": "^18.0.0",
+		"@wordpress/date": "^5.53.0",
+		"@wordpress/deprecated": "^4.53.0",
+		"@wordpress/dom": "^4.53.0",
+		"@wordpress/element": "^8.5.0",
+		"@wordpress/escape-html": "^3.53.0",
+		"@wordpress/global-styles-engine": "^1.20.0",
+		"@wordpress/hooks": "^4.53.0",
+		"@wordpress/html-entities": "^4.53.0",
+		"@wordpress/i18n": "^6.26.0",
+		"@wordpress/icons": "^15.4.0",
+		"@wordpress/image-cropper": "^1.17.0",
+		"@wordpress/interactivity": "^6.53.0",
+		"@wordpress/is-shallow-equal": "^5.53.0",
+		"@wordpress/kebab-case": "^1.0.0",
+		"@wordpress/keyboard-shortcuts": "^5.53.0",
+		"@wordpress/keycodes": "^4.53.0",
+		"@wordpress/notices": "^5.53.0",
+		"@wordpress/preferences": "^4.53.0",
+		"@wordpress/priority-queue": "^3.53.0",
+		"@wordpress/private-apis": "^1.53.0",
+		"@wordpress/rich-text": "^7.53.0",
+		"@wordpress/style-engine": "^2.53.0",
+		"@wordpress/token-list": "^3.53.0",
+		"@wordpress/ui": "^0.20.0",
+		"@wordpress/upload-media": "^0.38.0",
+		"@wordpress/url": "^4.53.0",
+		"@wordpress/warning": "^3.53.0",
+		"@wordpress/wordcount": "^4.53.0",
 		"change-case": "^4.1.2",
 		"clsx": "^2.1.1",
 		"colord": "^2.9.3",
@@ -112,12 +113,12 @@
 		"remove-accents": "^0.5.0"
 	},
 	"devDependencies": {
-		"@ariakit/test": "^0.4.13",
+		"@ariakit/test": "^0.7.2",
 		"@testing-library/dom": "^10.4.1",
 		"@testing-library/react": "^16.3.2",
 		"@testing-library/user-event": "^14.6.1",
 		"@types/postcss-prefix-selector": "^1.16.3",
-		"@wordpress/block-library": "^10.3.0",
+		"@wordpress/block-library": "^10.4.0",
 		"deep-freeze": "^0.0.1",
 		"storybook": "^10.4.3"
 	},
@@ -134,5 +135,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "7e8b17a983f9391d3ebc7717af2a1c9ed7efc7ab"
+	"gitHead": "989764d42ff93e33684aaf0b96a5b7f3d9bbff52"
 }

package/src/autocompleters/block.js

@@ -1,6 +1,3 @@
-/**
- * WordPress dependencies
- */
 import { useSelect } from '@wordpress/data';
 import {
 	cloneBlock,
@@ -9,10 +6,6 @@ import {
 	store as blocksStore,
 } from '@wordpress/blocks';
 import { useMemo } from '@wordpress/element';
-
-/**
- * Internal dependencies
- */
 import { searchBlockItems } from '../components/inserter/search-items';
 import useBlockTypesState from '../components/inserter/hooks/use-block-types-state';
 import BlockIcon from '../components/block-icon';

package/src/autocompleters/test/block.js

@@ -1,11 +1,4 @@
-/**
- * WordPress dependencies
- */
 import { registerBlockType, unregisterBlockType } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
 import blockCompleter from '../block';
 
 describe( 'block autocompleter', () => {

package/src/components/alignment-control/index.js

@@ -1,6 +1,3 @@
-/**
- * Internal dependencies
- */
 import AlignmentUI from './ui';
 
 const AlignmentControl = ( props ) => {

package/src/components/alignment-control/stories/aliginment-toolbar.story.jsx

@@ -1,11 +1,4 @@
-/**
- * WordPress dependencies
- */
 import { useState } from '@wordpress/element';
-
-/**
- * Internal dependencies
- */
 import { AlignmentToolbar } from '..';
 
 /**

package/src/components/alignment-control/stories/index.story.jsx

@@ -1,11 +1,4 @@
-/**
- * WordPress dependencies
- */
 import { useState } from '@wordpress/element';
-
-/**
- * Internal dependencies
- */
 import { AlignmentControl } from '../';
 
 /**

package/src/components/alignment-control/test/index.js

@@ -1,17 +1,6 @@
-/**
- * External dependencies
- */
 import { render, screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
-
-/**
- * WordPress dependencies
- */
 import { alignLeft, alignCenter } from '@wordpress/icons';
-
-/**
- * Internal dependencies
- */
 import AlignmentUI from '../ui';
 
 describe( 'AlignmentUI', () => {

package/src/components/alignment-control/ui.js

@@ -1,6 +1,3 @@
-/**
- * WordPress dependencies
- */
 import { __, isRTL } from '@wordpress/i18n';
 import { ToolbarDropdownMenu, ToolbarGroup } from '@wordpress/components';
 import { alignLeft, alignRight, alignCenter } from '@wordpress/icons';

package/src/components/autocomplete/index.js

@@ -1,6 +1,3 @@
-/**
- * WordPress dependencies
- */
 import { applyFilters, hasFilter } from '@wordpress/hooks';
 import {
 	Autocomplete as WCAutocomplete,
@@ -8,10 +5,6 @@ import {
 } from '@wordpress/components';
 import { useMemo } from '@wordpress/element';
 import { getDefaultBlockName, getBlockSupport } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
 import { useBlockEditContext } from '../block-edit/context';
 import blockAutocompleter from '../../autocompleters/block';
 

package/src/components/background-image-control/index.js

@@ -1,11 +1,4 @@
-/**
- * External dependencies
- */
 import clsx from 'clsx';
-
-/**
- * WordPress dependencies
- */
 import {
 	ToggleControl,
 	__experimentalToggleGroupControl as ToggleGroupControl,
@@ -34,10 +27,6 @@ import { useDispatch, useSelect } from '@wordpress/data';
 import { focus } from '@wordpress/dom';
 import { isBlobURL } from '@wordpress/blob';
 import { getResolvedValue } from '@wordpress/global-styles-engine';
-
-/**
- * Internal dependencies
- */
 import { hasBackgroundImageValue } from '../global-styles/background-panel';
 import {
 	InheritanceResetButton,
@@ -46,7 +35,6 @@ import {
 import { setImmutably } from '../../utils/object';
 import MediaReplaceFlow from '../media-replace-flow';
 import { store as blockEditorStore } from '../../store';
-
 import {
 	globalStylesDataKey,
 	globalStylesLinksDataKey,

package/src/components/background-image-control/test/index.js

@@ -1,7 +1,3 @@
-/**
- * Internal dependencies
- */
-
 import { backgroundPositionToCoords, coordsToBackgroundPosition } from '../';
 
 describe( 'backgroundPositionToCoords', () => {

package/src/components/block-actions/README.md

@@ -0,0 +1,67 @@
+# Block Actions
+
+`BlockActions` provides handlers for acting on a set of blocks — duplicating, removing, inserting, grouping, ungrouping, and pasting styles — along with flags describing which of those actions are available. It renders no UI of its own; consumers supply a render prop and build their own controls.
+
+_Note:_ This component is internal to the block editor. It is not exported from `@wordpress/block-editor`, so it can only be imported relatively from within the package.
+
+## Development guidelines
+
+### Usage
+
+```jsx
+import BlockActions from '../block-actions';
+
+<BlockActions clientIds={ selectedBlockIds }>
+	{ ( { onDuplicate, canDuplicate, onRemove, canRemove } ) => (
+		<>
+			{ canDuplicate && (
+				<button onClick={ onDuplicate }>Duplicate</button>
+			) }
+			{ canRemove && <button onClick={ onRemove }>Remove</button> }
+		</>
+	) }
+</BlockActions>;
+```
+
+### Props
+
+#### `clientIds`
+
+-   **Type:** `String[]`
+
+The client IDs of the blocks to act on.
+
+#### `children`
+
+-   **Type:** `Function`
+
+A render prop called with a single object argument. Its properties are:
+
+Availability flags:
+
+-   `canRemove` (`Boolean`): Whether the blocks can be removed.
+-   `canDuplicate` (`Boolean`): Whether every block supports multiple instances and can be inserted into the current parent.
+-   `canInsertBlock` (`Boolean`): Whether a new block can be inserted next to the blocks.
+-   `canCopyStyles` (`Boolean`): Whether every block supports color or typography, and so has styles to copy.
+
+Action handlers:
+
+-   `onDuplicate` (`Function`): Duplicates the blocks. Returns the result of the `duplicateBlocks` dispatch.
+-   `onRemove` (`Function`): Removes the blocks. Returns the result of the `removeBlocks` dispatch.
+-   `onInsertBefore` (`Function`): Inserts a default block before the first block.
+-   `onInsertAfter` (`Function`): Inserts a default block after the last block.
+-   `onGroup` (`Function`): Replaces the blocks with a single grouping block containing them.
+-   `onUngroup` (`Function`): Replaces the block with its inner blocks.
+-   `onCopy` (`Function`): Flashes a single selected block to signal it was copied. Writing to the clipboard is the consumer's responsibility.
+-   `onPasteStyles` (`Function`): Applies the copied styles to the blocks. Returns a `Promise`.
+
+#### `__experimentalUpdateSelection`
+
+-   **Type:** `Boolean`
+-   **Default:** `true`
+
+Whether the block selection should be updated after duplicating or removing. Passed straight through to the `duplicateBlocks` and `removeBlocks` actions.
+
+## Related components
+
+Block Editor components are components that can be used to compose the UI of your block editor. Thus, they can only be used under a [`BlockEditorProvider`](https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/provider/README.md) in the components tree.

package/src/components/block-actions/index.js

@@ -1,18 +1,8 @@
-/**
- * WordPress dependencies
- */
 import { useDispatch, useSelect } from '@wordpress/data';
-import {
-	hasBlockSupport,
-	switchToBlockType,
-	store as blocksStore,
-} from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
+import { hasBlockSupport, store as blocksStore } from '@wordpress/blocks';
 import usePasteStyles from '../use-paste-styles';
 import { store as blockEditorStore } from '../../store';
+import { groupBlocks } from '../../utils/group-blocks';
 
 export default function BlockActions( {
 	clientIds,
@@ -106,8 +96,7 @@ export default function BlockActions( {
 
 			const groupingBlockName = getGroupingBlockName();
 
-			// Activate the `transform` on `core/group` which does the conversion.
-			const newBlocks = switchToBlockType(
+			const newBlocks = groupBlocks(
 				getBlocksByClientId( clientIds ),
 				groupingBlockName
 			);

package/src/components/block-alignment-control/constants.js

@@ -1,6 +1,3 @@
-/**
- * WordPress dependencies
- */
 import { __, _x } from '@wordpress/i18n';
 import {
 	alignNone,

package/src/components/block-alignment-control/index.js

@@ -1,6 +1,3 @@
-/**
- * Internal dependencies
- */
 import BlockAlignmentUI from './ui';
 
 const BlockAlignmentControl = ( props ) => {

package/src/components/block-alignment-control/test/index.js

@@ -1,12 +1,5 @@
-/**
- * External dependencies
- */
 import { render, screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
-
-/**
- * Internal dependencies
- */
 import BlockAlignmentUI from '../ui';
 
 describe( 'BlockAlignmentUI', () => {

package/src/components/block-alignment-control/ui.js

@@ -1,11 +1,4 @@
-/**
- * External dependencies
- */
 import clsx from 'clsx';
-
-/**
- * WordPress dependencies
- */
 import { __ } from '@wordpress/i18n';
 import {
 	ToolbarDropdownMenu,
@@ -13,10 +6,6 @@ import {
 	MenuGroup,
 	MenuItem,
 } from '@wordpress/components';
-
-/**
- * Internal dependencies
- */
 import useAvailableAlignments from './use-available-alignments';
 import { BLOCK_ALIGNMENTS_CONTROLS, DEFAULT_CONTROL } from './constants';
 

package/src/components/block-alignment-control/use-available-alignments.js

@@ -1,11 +1,4 @@
-/**
- * WordPress dependencies
- */
 import { useSelect } from '@wordpress/data';
-
-/**
- * Internal dependencies
- */
 import { useLayout } from '../block-list/layout';
 import { store as blockEditorStore } from '../../store';
 import { getLayoutType } from '../../layouts';

package/src/components/block-alignment-matrix-control/index.js

@@ -1,6 +1,3 @@
-/**
- * WordPress dependencies
- */
 import { __ } from '@wordpress/i18n';
 import { DOWN } from '@wordpress/keycodes';
 import {

package/src/components/block-alignment-matrix-control/stories/index.story.jsx

@@ -1,11 +1,4 @@
-/**
- * WordPress dependencies
- */
 import { useState } from '@wordpress/element';
-
-/**
- * Internal dependencies
- */
 import BlockAlignmentMatrixControl from '../';
 
 const meta = {

package/src/components/block-allowed-blocks/allowed-blocks-control.js

@@ -1,15 +1,8 @@
-/**
- * WordPress dependencies
- */
 import { BaseControl, Button } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
 import { useState } from '@wordpress/element';
 import { useSelect } from '@wordpress/data';
 import { hasBlockSupport, store as blocksStore } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
 import BlockAllowedBlocksModal from './modal';
 import { store as blockEditorStore } from '../../store';