@wordpress/patterns 1.1.0

package/src/lock-unlock.js

@@ -0,0 +1,9 @@
+/**
+ * WordPress dependencies
+ */
+import { __dangerousOptInToUnstableAPIsOnlyForCoreModules } from '@wordpress/private-apis';
+export const { lock, unlock } =
+	__dangerousOptInToUnstableAPIsOnlyForCoreModules(
+		'I know using unstable features means my plugin or theme will inevitably break on the next WordPress release.',
+		'@wordpress/patterns'
+	);

package/src/private-apis.js

@@ -0,0 +1,12 @@
+/**
+ * Internal dependencies
+ */
+import { lock } from './lock-unlock';
+import CreatePatternModal from './components/create-pattern-modal';
+import PatternsMenuItems from './components';
+
+export const privateApis = {};
+lock( privateApis, {
+	CreatePatternModal,
+	PatternsMenuItems,
+} );

package/src/store/actions.js

@@ -0,0 +1,99 @@
+/**
+ * WordPress dependencies
+ */
+
+import { parse, serialize, createBlock } from '@wordpress/blocks';
+import { store as coreStore } from '@wordpress/core-data';
+import { store as blockEditorStore } from '@wordpress/block-editor';
+
+/**
+ * Returns a generator converting one or more static blocks into a pattern, or creating a new empty pattern.
+ *
+ * @param {string}             title     Pattern title.
+ * @param {'full'|'unsynced'}  syncType  They way block is synced, 'full' or 'unsynced'.
+ * @param {string[]|undefined} clientIds Optional client IDs of blocks to convert to pattern.
+ */
+export const __experimentalCreatePattern =
+	( title, syncType, clientIds ) =>
+	async ( { registry, dispatch } ) => {
+		const meta =
+			syncType === 'unsynced'
+				? {
+						wp_pattern_sync_status: syncType,
+				  }
+				: undefined;
+
+		const reusableBlock = {
+			title,
+			content: clientIds
+				? serialize(
+						registry
+							.select( blockEditorStore )
+							.getBlocksByClientId( clientIds )
+				  )
+				: undefined,
+			status: 'publish',
+			meta,
+		};
+
+		const updatedRecord = await registry
+			.dispatch( coreStore )
+			.saveEntityRecord( 'postType', 'wp_block', reusableBlock );
+
+		if ( syncType === 'unsynced' || ! clientIds ) {
+			return updatedRecord;
+		}
+
+		const newBlock = createBlock( 'core/block', {
+			ref: updatedRecord.id,
+		} );
+		registry
+			.dispatch( blockEditorStore )
+			.replaceBlocks( clientIds, newBlock );
+		dispatch.__experimentalSetEditingPattern( newBlock.clientId, true );
+		return updatedRecord;
+	};
+
+/**
+ * Returns a generator converting a synced pattern block into a static block.
+ *
+ * @param {string} clientId The client ID of the block to attach.
+ */
+export const __experimentalConvertSyncedPatternToStatic =
+	( clientId ) =>
+	( { registry } ) => {
+		const oldBlock = registry
+			.select( blockEditorStore )
+			.getBlock( clientId );
+		const pattern = registry
+			.select( 'core' )
+			.getEditedEntityRecord(
+				'postType',
+				'wp_block',
+				oldBlock.attributes.ref
+			);
+
+		const newBlocks = parse(
+			typeof pattern.content === 'function'
+				? pattern.content( pattern )
+				: pattern.content
+		);
+		registry
+			.dispatch( blockEditorStore )
+			.replaceBlocks( oldBlock.clientId, newBlocks );
+	};
+
+/**
+ * Returns an action descriptor for SET_EDITING_PATTERN action.
+ *
+ * @param {string}  clientId  The clientID of the pattern to target.
+ * @param {boolean} isEditing Whether the block should be in editing state.
+ * @return {Object} Action descriptor.
+ */
+export function __experimentalSetEditingPattern( clientId, isEditing ) {
+	return {
+		type: 'SET_EDITING_PATTERN',
+		clientId,
+		isEditing,
+	};
+}

package/src/store/constants.js

@@ -0,0 +1,4 @@
+/**
+ * Module Constants
+ */
+export const STORE_NAME = 'core/patterns';

package/src/store/index.js

@@ -0,0 +1,38 @@
+/**
+ * WordPress dependencies
+ */
+import { createReduxStore, register } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import reducer from './reducer';
+import * as actions from './actions';
+import { STORE_NAME } from './constants';
+import * as selectors from './selectors';
+
+/**
+ * Post editor data store configuration.
+ *
+ * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#registerStore
+ *
+ * @type {Object}
+ */
+export const storeConfig = {
+	reducer,
+	selectors,
+	actions,
+};
+
+/**
+ * Store definition for the editor namespace.
+ *
+ * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#createReduxStore
+ *
+ * @type {Object}
+ */
+export const store = createReduxStore( STORE_NAME, {
+	...storeConfig,
+} );
+
+register( store );

package/src/store/reducer.js

@@ -0,0 +1,19 @@
+/**
+ * WordPress dependencies
+ */
+import { combineReducers } from '@wordpress/data';
+
+export function isEditingPattern( state = {}, action ) {
+	if ( action?.type === 'SET_EDITING_PATTERN' ) {
+		return {
+			...state,
+			[ action.clientId ]: action.isEditing,
+		};
+	}
+
+	return state;
+}
+
+export default combineReducers( {
+	isEditingPattern,
+} );

package/src/store/selectors.js

@@ -0,0 +1,10 @@
+/**
+ * Returns true if pattern is in the editing state.
+ *
+ * @param {Object} state    Global application state.
+ * @param {number} clientId the clientID of the block.
+ * @return {boolean} Whether the pattern is in the editing state.
+ */
+export function __experimentalIsEditingPattern( state, clientId ) {
+	return state.isEditingPattern[ clientId ];
+}

package/src/style.scss

@@ -0,0 +1 @@
+@import "./components/style.scss";