@wordpress/editor 14.0.3 → 14.2.0

package/build-style/style.css

@@ -645,11 +645,6 @@ body.is-fullscreen-mode .interface-interface-skeleton {
 .editor-create-template-part-modal {
   z-index: 1000001;
 }
-@media (min-width: 600px) {
-  .editor-create-template-part-modal .components-modal__frame {
-    max-width: 500px;
-  }
-}
 
 .editor-create-template-part-modal__area-radio-group {
   width: 100%;
@@ -1277,7 +1272,6 @@ body.is-fullscreen-mode .interface-interface-skeleton {
 .editor-keyboard-shortcut-help-modal__shortcut-description {
   flex: 1;
   margin: 0;
-  flex-basis: auto;
 }
 .editor-keyboard-shortcut-help-modal__shortcut-key-combination {
   display: block;
@@ -1475,6 +1469,9 @@ body.is-fullscreen-mode .interface-interface-skeleton {
 .editor-post-card-panel__icon.is-sync {
   fill: var(--wp-block-synced-color);
 }
+.editor-post-card-panel__icon.is-sync + .editor-post-card-panel__title {
+  color: var(--wp-block-synced-color);
+}
 
 .editor-post-card-panel__title-badge {
   background: #f0f0f0;
@@ -1672,7 +1669,7 @@ body.is-fullscreen-mode .interface-interface-skeleton {
 }
 
 .editor-post-panel__row-label {
-  width: 30%;
+  width: 38%;
   flex-shrink: 0;
   min-height: 32px;
   display: flex;
@@ -2002,9 +1999,13 @@ body.is-fullscreen-mode .interface-interface-skeleton {
   padding: 0;
   margin-bottom: 8px;
 }
+.editor-change-status__content p.components-base-control__help:has(.components-checkbox-control__help) {
+  margin-top: 4px;
+}
 
-.editor-post-sticky__toggle-control {
-  padding: 6px 12px;
+.editor-post-sticky__checkbox-control {
+  border-top: 1px solid #e0e0e0;
+  padding-top: 16px;
 }
 
 .editor-post-sync-status__value {

package/build-types/dataviews/store/private-actions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WordPress dependencies
+ */
+import type { Action, AnyItem } from '@wordpress/dataviews';
+export declare function registerEntityAction<Item extends AnyItem>(kind: string, name: string, config: Action<Item>): {
+    type: "REGISTER_ENTITY_ACTION";
+    kind: string;
+    name: string;
+    config: Action<Item>;
+};
+export declare function unregisterEntityAction(kind: string, name: string, actionId: string): {
+    type: "UNREGISTER_ENTITY_ACTION";
+    kind: string;
+    name: string;
+    actionId: string;
+};
+//# sourceMappingURL=private-actions.d.ts.map

package/build-types/dataviews/store/private-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-actions.d.ts","sourceRoot":"","sources":["../../../src/dataviews/store/private-actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,oBAAoB,CAAE,IAAI,SAAS,OAAO,EACzD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAE,IAAI,CAAE;;;;;EAQtB;AAED,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM;;;;;EAQhB"}

package/build-types/dataviews/store/private-selectors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WordPress dependencies
+ */
+import type { Action } from '@wordpress/dataviews';
+/**
+ * Internal dependencies
+ */
+import type { State } from './reducer';
+export declare function getEntityActions(state: State, kind: string, name: string): Action<any>[];
+//# sourceMappingURL=private-selectors.d.ts.map

package/build-types/dataviews/store/private-selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-selectors.d.ts","sourceRoot":"","sources":["../../../src/dataviews/store/private-selectors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIvC,wBAAgB,gBAAgB,CAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAEzE"}

package/build-types/dataviews/store/reducer.d.ts

@@ -0,0 +1,11 @@
+import type { Action } from '@wordpress/dataviews';
+type ReduxAction = ReturnType<typeof import('./private-actions').registerEntityAction> | ReturnType<typeof import('./private-actions').unregisterEntityAction>;
+export type ActionState = Record<string, Record<string, Action<any>[]>>;
+export type State = {
+    actions: ActionState;
+};
+declare const _default: import("redux").Reducer<import("redux").CombinedState<{
+    actions: never;
+}>, ReduxAction>;
+export default _default;
+//# sourceMappingURL=reducer.d.ts.map

package/build-types/dataviews/store/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../src/dataviews/store/reducer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,KAAK,WAAW,GACb,UAAU,CAAE,cAAc,mBAAmB,EAAE,oBAAoB,CAAE,GACrE,UAAU,CAAE,cAAc,mBAAmB,EAAE,sBAAsB,CAAE,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,GAAG,CAAE,EAAE,CAAE,CAAE,CAAC;AAC9E,MAAM,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,WAAW,CAAC;CACrB,CAAC;;;;AA2BF,wBAEI"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/editor",
-	"version": "14.0.3",
+	"version": "14.2.0",
 	"description": "Enhanced block editor for WordPress posts.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -32,39 +32,39 @@
 	],
 	"dependencies": {
 		"@babel/runtime": "^7.16.0",
-		"@wordpress/a11y": "^4.0.1",
-		"@wordpress/api-fetch": "^7.0.1",
-		"@wordpress/blob": "^4.0.1",
-		"@wordpress/block-editor": "^13.0.3",
-		"@wordpress/blocks": "^13.0.3",
-		"@wordpress/commands": "^1.0.3",
-		"@wordpress/components": "^28.0.3",
-		"@wordpress/compose": "^7.0.1",
-		"@wordpress/core-data": "^7.0.3",
-		"@wordpress/data": "^10.0.2",
-		"@wordpress/date": "^5.0.1",
-		"@wordpress/deprecated": "^4.0.1",
-		"@wordpress/dom": "^4.0.1",
-		"@wordpress/element": "^6.0.1",
-		"@wordpress/hooks": "^4.0.1",
-		"@wordpress/html-entities": "^4.0.1",
-		"@wordpress/i18n": "^5.0.1",
-		"@wordpress/icons": "^10.0.2",
-		"@wordpress/interface": "^6.0.3",
-		"@wordpress/keyboard-shortcuts": "^5.0.2",
-		"@wordpress/keycodes": "^4.0.1",
-		"@wordpress/media-utils": "^5.0.1",
-		"@wordpress/notices": "^5.0.2",
-		"@wordpress/patterns": "^2.0.3",
-		"@wordpress/plugins": "^7.0.3",
-		"@wordpress/preferences": "^4.0.3",
-		"@wordpress/private-apis": "^1.0.2",
-		"@wordpress/reusable-blocks": "^5.0.3",
-		"@wordpress/rich-text": "^7.0.2",
-		"@wordpress/server-side-render": "^5.0.3",
-		"@wordpress/url": "^4.0.1",
-		"@wordpress/warning": "^3.0.1",
-		"@wordpress/wordcount": "^4.0.1",
+		"@wordpress/a11y": "^4.2.0",
+		"@wordpress/api-fetch": "^7.2.0",
+		"@wordpress/blob": "^4.2.0",
+		"@wordpress/block-editor": "^13.2.0",
+		"@wordpress/blocks": "^13.2.0",
+		"@wordpress/commands": "^1.2.0",
+		"@wordpress/components": "^28.2.0",
+		"@wordpress/compose": "^7.2.0",
+		"@wordpress/core-data": "^7.2.0",
+		"@wordpress/data": "^10.2.0",
+		"@wordpress/date": "^5.2.0",
+		"@wordpress/deprecated": "^4.2.0",
+		"@wordpress/dom": "^4.2.0",
+		"@wordpress/element": "^6.2.0",
+		"@wordpress/hooks": "^4.2.0",
+		"@wordpress/html-entities": "^4.2.0",
+		"@wordpress/i18n": "^5.2.0",
+		"@wordpress/icons": "^10.2.0",
+		"@wordpress/interface": "^6.2.0",
+		"@wordpress/keyboard-shortcuts": "^5.2.0",
+		"@wordpress/keycodes": "^4.2.0",
+		"@wordpress/media-utils": "^5.2.0",
+		"@wordpress/notices": "^5.2.0",
+		"@wordpress/patterns": "^2.2.0",
+		"@wordpress/plugins": "^7.2.0",
+		"@wordpress/preferences": "^4.2.0",
+		"@wordpress/private-apis": "^1.2.0",
+		"@wordpress/reusable-blocks": "^5.2.0",
+		"@wordpress/rich-text": "^7.2.0",
+		"@wordpress/server-side-render": "^5.2.0",
+		"@wordpress/url": "^4.2.0",
+		"@wordpress/warning": "^3.2.0",
+		"@wordpress/wordcount": "^4.2.0",
 		"change-case": "^4.1.2",
 		"client-zip": "^2.4.5",
 		"clsx": "^2.1.1",
@@ -83,5 +83,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "9dd5f8dcfa4fc7242e5d48be20ee789ad087b432"
+	"gitHead": "aa5b14bb5bdbb8d8a02914e154c3bc1c2f18ace6"
 }

package/src/components/create-template-part-modal/index.js

@@ -53,6 +53,8 @@ export default function CreateTemplatePartModal( {
 			title={ modalTitle || defaultModalTitle }
 			onRequestClose={ restProps.closeModal }
 			overlayClassName="editor-create-template-part-modal"
+			focusOnMount="firstContentElement"
+			size="medium"
 		>
 			<CreateTemplatePartModalContents { ...restProps } />
 		</Modal>

package/src/components/create-template-part-modal/style.scss

@@ -1,11 +1,5 @@
 .editor-create-template-part-modal {
 	z-index: z-index(".editor-create-template-part-modal");
-
-	.components-modal__frame {
-		@include break-small {
-			max-width: 500px;
-		}
-	}
 }
 
 .editor-create-template-part-modal__area-radio-group {

package/src/components/document-bar/index.js

@@ -52,10 +52,15 @@ const MotionButton = motion( Button );
  * ```jsx
  * <DocumentBar />
  * ```
+ * @param {Object}                                   props       The component props.
+ * @param {string}                                   props.title A title for the document, defaulting to the document or
+ *                                                               template title currently being edited.
+ * @param {import("@wordpress/components").IconType} props.icon  An icon for the document, defaulting to an icon for document
+ *                                                               or template currently being edited.
  *
  * @return {JSX.Element} The rendered DocumentBar component.
  */
-export default function DocumentBar() {
+export default function DocumentBar( props ) {
 	const {
 		postType,
 		documentTitle,
@@ -111,7 +116,9 @@ export default function DocumentBar() {
 	const isTemplate = TEMPLATE_POST_TYPES.includes( postType );
 	const isGlobalEntity = GLOBAL_POST_TYPES.includes( postType );
 	const hasBackButton = !! onNavigateToPreviousEntityRecord;
-	const title = isTemplate ? templateTitle : documentTitle;
+	const entityTitle = isTemplate ? templateTitle : documentTitle;
+	const title = props.title || entityTitle;
+	const icon = props.icon || templateIcon;
 
 	const mounted = useRef( false );
 	useEffect( () => {
@@ -180,12 +187,12 @@ export default function DocumentBar() {
 							isReducedMotion ? { duration: 0 } : undefined
 						}
 					>
-						<BlockIcon icon={ templateIcon } />
+						<BlockIcon icon={ icon } />
 						<Text
 							size="body"
 							as="h1"
 							aria-label={
-								TYPE_LABELS[ postType ]
+								! props.title && TYPE_LABELS[ postType ]
 									? // eslint-disable-next-line @wordpress/valid-sprintf
 									  sprintf( TYPE_LABELS[ postType ], title )
 									: undefined

package/src/components/editor/index.js

@@ -20,20 +20,16 @@ function Editor( {
 	templateId,
 	settings,
 	children,
+	initialEdits,
 
 	// This could be part of the settings.
 	onActionPerformed,
 
 	// The following abstractions are not ideal but necessary
 	// to account for site editor and post editor differences for now.
-	className,
-	styles,
-	customSaveButton,
-	forceDisableBlockTools,
-	title,
-	iframeProps,
+	extraContent,
 	extraSidebarPanels,
-	enableRegionNavigation = true,
+	...props
 } ) {
 	const { post, template, hasLoadedPost } = useSelect(
 		( select ) => {
@@ -59,12 +55,7 @@ function Editor( {
 	);
 
 	return (
-		<ExperimentalEditorProvider
-			post={ post }
-			__unstableTemplate={ template }
-			settings={ settings }
-			useSubRegistry={ false }
-		>
+		<>
 			{ hasLoadedPost && ! post && (
 				<Notice status="warning" isDismissible={ false }>
 					{ __(
@@ -72,21 +63,25 @@ function Editor( {
 					) }
 				</Notice>
 			) }
-			<EditorInterface
-				className={ className }
-				styles={ styles }
-				enableRegionNavigation={ enableRegionNavigation }
-				customSaveButton={ customSaveButton }
-				forceDisableBlockTools={ forceDisableBlockTools }
-				title={ title }
-				iframeProps={ iframeProps }
-			/>
-			<Sidebar
-				onActionPerformed={ onActionPerformed }
-				extraPanels={ extraSidebarPanels }
-			/>
-			{ children }
-		</ExperimentalEditorProvider>
+			{ !! post && (
+				<ExperimentalEditorProvider
+					post={ post }
+					__unstableTemplate={ template }
+					settings={ settings }
+					initialEdits={ initialEdits }
+					useSubRegistry={ false }
+				>
+					<EditorInterface { ...props }>
+						{ extraContent }
+					</EditorInterface>
+					<Sidebar
+						onActionPerformed={ onActionPerformed }
+						extraPanels={ extraSidebarPanels }
+					/>
+					{ children }
+				</ExperimentalEditorProvider>
+			) }
+		</>
 	);
 }
 

package/src/components/editor-interface/index.js

@@ -57,6 +57,7 @@ export default function EditorInterface( {
 	customSaveButton,
 	forceDisableBlockTools,
 	title,
+	icon,
 	iframeProps,
 } ) {
 	const {
@@ -140,6 +141,7 @@ export default function EditorInterface( {
 						customSaveButton={ customSaveButton }
 						forceDisableBlockTools={ forceDisableBlockTools }
 						title={ title }
+						icon={ icon }
 					/>
 				)
 			}

package/src/components/entities-saved-states/hooks/use-is-dirty.js

@@ -5,6 +5,15 @@ import { useSelect } from '@wordpress/data';
 import { store as coreStore } from '@wordpress/core-data';
 import { useMemo, useState } from '@wordpress/element';
 
+/**
+ * Custom hook that determines if any entities are dirty (edited) and provides a way to manage selected/unselected entities.
+ *
+ * @return {Object} An object containing the following properties:
+ *   - dirtyEntityRecords: An array of dirty entity records.
+ *   - isDirty: A boolean indicating if there are any dirty entity records.
+ *   - setUnselectedEntities: A function to set the unselected entities.
+ *   - unselectedEntities: An array of unselected entities.
+ */
 export const useIsDirty = () => {
 	const { editedEntities, siteEdits, siteEntityConfig } = useSelect(
 		( select ) => {

package/src/components/entities-saved-states/index.js

@@ -26,6 +26,15 @@ function identity( values ) {
 	return values;
 }
 
+/**
+ * Renders the component for managing saved states of entities.
+ *
+ * @param {Object}   props              The component props.
+ * @param {Function} props.close        The function to close the dialog.
+ * @param {Function} props.renderDialog The function to render the dialog.
+ *
+ * @return {JSX.Element} The rendered component.
+ */
 export default function EntitiesSavedStates( {
 	close,
 	renderDialog = undefined,
@@ -40,6 +49,23 @@ export default function EntitiesSavedStates( {
 	);
 }
 
+/**
+ * Renders a panel for saving entities with dirty records.
+ *
+ * @param {Object}   props                       The component props.
+ * @param {string}   props.additionalPrompt      Additional prompt to display.
+ * @param {Function} props.close                 Function to close the panel.
+ * @param {Function} props.onSave                Function to call when saving entities.
+ * @param {boolean}  props.saveEnabled           Flag indicating if save is enabled.
+ * @param {string}   props.saveLabel             Label for the save button.
+ * @param {Function} props.renderDialog          Function to render a custom dialog.
+ * @param {Array}    props.dirtyEntityRecords    Array of dirty entity records.
+ * @param {boolean}  props.isDirty               Flag indicating if there are dirty entities.
+ * @param {Function} props.setUnselectedEntities Function to set unselected entities.
+ * @param {Array}    props.unselectedEntities    Array of unselected entities.
+ *
+ * @return {JSX.Element} The rendered component.
+ */
 export function EntitiesSavedStatesExtensible( {
 	additionalPrompt = undefined,
 	close,

package/src/components/global-keyboard-shortcuts/index.js

@@ -12,7 +12,7 @@ import { store as blockEditorStore } from '@wordpress/block-editor';
 import { store as editorStore } from '../../store';
 
 /**
- * Component handles the keyboard shortcuts for the editor.
+ * Handles the keyboard shortcuts for the editor.
  *
  * It provides functionality for various keyboard shortcuts such as toggling editor mode,
  * toggling distraction-free mode, undo/redo, saving the post, toggling list view,

package/src/components/header/index.js

@@ -51,6 +51,7 @@ function Header( {
 	forceDisableBlockTools,
 	setEntitiesSavedStatesCallback,
 	title,
+	icon,
 } ) {
 	const isWideViewport = useViewportMatch( 'large' );
 	const isLargeViewport = useViewportMatch( 'medium' );
@@ -116,7 +117,7 @@ function Header( {
 							! isBlockToolsCollapsed && hasTopToolbar,
 					} ) }
 				>
-					{ ! title ? <DocumentBar /> : title }
+					<DocumentBar title={ title } icon={ icon } />
 				</div>
 			</motion.div>
 			<motion.div

package/src/components/index.js

@@ -105,5 +105,21 @@ export { default as CharacterCount } from './character-count';
 export { default as EditorProvider } from './provider';
 
 export * from './deprecated';
+
+/**
+ * Handles the keyboard shortcuts for the editor.
+ *
+ * It provides functionality for various keyboard shortcuts such as toggling editor mode,
+ * toggling distraction-free mode, undo/redo, saving the post, toggling list view,
+ * and toggling the sidebar.
+ */
 export const VisualEditorGlobalKeyboardShortcuts = EditorKeyboardShortcuts;
+
+/**
+ * Handles the keyboard shortcuts for the editor.
+ *
+ * It provides functionality for various keyboard shortcuts such as toggling editor mode,
+ * toggling distraction-free mode, undo/redo, saving the post, toggling list view,
+ * and toggling the sidebar.
+ */
 export const TextEditorGlobalKeyboardShortcuts = EditorKeyboardShortcuts;

package/src/components/keyboard-shortcut-help-modal/style.scss

@@ -33,9 +33,6 @@
 	&__shortcut-description {
 		flex: 1;
 		margin: 0;
-
-		// IE 11 flex item fix - ensure the item does not collapse.
-		flex-basis: auto;
 	}
 
 	&__shortcut-key-combination {