@wp-typia/create-workspace-template 0.14.0 → 0.16.0

package/README.md

@@ -12,6 +12,11 @@ The generated project starts with an empty `src/blocks/*` workspace shell and is
 
 ```bash
 wp-typia add block my-block --template basic
+wp-typia add style callout-emphasis --block my-block
+wp-typia add transform quote-to-block --from core/quote --to my-block
 wp-typia add binding-source hero-data
+wp-typia add binding-source hero-data --block my-block --attribute headline
+wp-typia add editor-plugin review-workflow --slot sidebar
+wp-typia add editor-plugin seo-notes --slot document-setting-panel
 wp-typia add hooked-block my-block --anchor core/post-content --position after
 ```

package/README.md.mustache

@@ -20,11 +20,15 @@ wp-typia add block counter-card --template persistence --data-storage custom-tab
 wp-typia add block faq-stack --template compound --data-storage custom-table --persistence-policy public
 ```
 
-Variations and patterns can also be added after the first block exists:
+Variations, block styles, transforms, patterns, and REST resources can also be
+added after the first block exists:
 
 ```bash
 wp-typia add variation hero-card --block counter-card
+wp-typia add style callout-emphasis --block counter-card
+wp-typia add transform quote-to-counter --from core/quote --to counter-card
 wp-typia add pattern hero-layout
+wp-typia add rest-resource snapshots --namespace {{namespace}}/v1 --methods list,read,create
 ```
 
 ## Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/create-workspace-template",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Official empty wp-typia workspace template package",
   "packageManager": "bun@1.3.11",
   "type": "module",

package/package.json.mustache

@@ -29,6 +29,7 @@
     "@wp-typia/api-client": "{{apiClientPackageVersion}}",
     "@wp-typia/block-runtime": "{{blockRuntimePackageVersion}}",
     "@wp-typia/block-types": "{{blockTypesPackageVersion}}",
+    "@wp-typia/project-tools": "{{projectToolsPackageVersion}}",
     "@wp-typia/rest": "{{restPackageVersion}}",
     "@typia/unplugin": "^12.0.1",
     "@types/node": "^24.5.2",
@@ -36,7 +37,6 @@
     "@types/wordpress__blocks": "^12.5.18",
     "@wordpress/browserslist-config": "^6.42.0",
     "@wordpress/scripts": "^30.22.0",
-    "ajv": "^8.18.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
@@ -47,8 +47,10 @@
     "@wordpress/block-editor": "^15.2.0",
     "@wordpress/blocks": "^15.2.0",
     "@wordpress/components": "^30.2.0",
+    "@wordpress/editor": "^14.44.0",
     "@wordpress/element": "^6.29.0",
     "@wordpress/i18n": "^6.2.0",
-    "@wordpress/interactivity": "^6.29.0"
+    "@wordpress/interactivity": "^6.29.0",
+    "@wordpress/plugins": "^7.44.0"
   }
 }

package/scripts/block-config.ts.mustache

@@ -15,17 +15,62 @@ export interface WorkspaceVariationConfig {
 	slug: string;
 }
 
+export interface WorkspaceBlockStyleConfig {
+	block: string;
+	file: string;
+	slug: string;
+}
+
+export interface WorkspaceBlockTransformConfig {
+	block: string;
+	file: string;
+	from: string;
+	slug: string;
+	to: string;
+}
+
 export interface WorkspacePatternConfig {
 	file: string;
 	slug: string;
 }
 
 export interface WorkspaceBindingSourceConfig {
+	attribute?: string;
+	block?: string;
 	editorFile: string;
 	serverFile: string;
 	slug: string;
 }
 
+export interface WorkspaceRestResourceConfig {
+	apiFile: string;
+	clientFile: string;
+	dataFile: string;
+	methods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
+	namespace: string;
+	openApiFile: string;
+	phpFile: string;
+	restManifest?: ReturnType<
+		typeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
+	>;
+	slug: string;
+	typesFile: string;
+	validatorsFile: string;
+}
+
+export interface WorkspaceEditorPluginConfig {
+	file: string;
+	slug: string;
+	slot: string;
+}
+
+export interface WorkspaceAdminViewConfig {
+	file: string;
+	phpFile: string;
+	slug: string;
+	source?: string;
+}
+
 export const BLOCKS: WorkspaceBlockConfig[] = [
 	// wp-typia add block entries
 ];
@@ -34,6 +79,14 @@ export const VARIATIONS: WorkspaceVariationConfig[] = [
 	// wp-typia add variation entries
 ];
 
+export const BLOCK_STYLES: WorkspaceBlockStyleConfig[] = [
+	// wp-typia add style entries
+];
+
+export const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [
+	// wp-typia add transform entries
+];
+
 export const PATTERNS: WorkspacePatternConfig[] = [
 	// wp-typia add pattern entries
 ];
@@ -41,3 +94,15 @@ export const PATTERNS: WorkspacePatternConfig[] = [
 export const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [
 	// wp-typia add binding-source entries
 ];
+
+export const REST_RESOURCES: WorkspaceRestResourceConfig[] = [
+	// wp-typia add rest-resource entries
+];
+
+export const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [
+	// wp-typia add editor-plugin entries
+];
+
+export const ADMIN_VIEWS: WorkspaceAdminViewConfig[] = [
+	// wp-typia add admin-view entries
+];

package/scripts/build-workspace.mjs.mustache

@@ -22,7 +22,14 @@ function getBlockSlugs() {
 }
 
 function hasSharedEditorEntries() {
-	for ( const relativePath of [ 'src/bindings/index.ts', 'src/bindings/index.js' ] ) {
+	for ( const relativePath of [
+		'src/bindings/index.ts',
+		'src/bindings/index.js',
+		'src/editor-plugins/index.ts',
+		'src/editor-plugins/index.js',
+		'src/admin-views/index.ts',
+		'src/admin-views/index.js',
+	] ) {
 		if ( fs.existsSync( path.join( process.cwd(), relativePath ) ) ) {
 			return true;
 		}

package/scripts/sync-rest-contracts.ts.mustache

@@ -8,7 +8,12 @@ import {
 	syncTypeSchemas,
 } from '@wp-typia/block-runtime/metadata-core';
 
-import { BLOCKS, type WorkspaceBlockConfig } from './block-config';
+import {
+	BLOCKS,
+	REST_RESOURCES,
+	type WorkspaceBlockConfig,
+	type WorkspaceRestResourceConfig,
+} from './block-config';
 
 function parseCliOptions( argv: string[] ) {
 	const options = {
@@ -42,6 +47,25 @@ function isRestEnabledBlock(
 	);
 }
 
+function isWorkspaceRestResource(
+	resource: WorkspaceRestResourceConfig
+): resource is WorkspaceRestResourceConfig & {
+	clientFile: string;
+	openApiFile: string;
+	restManifest: NonNullable< WorkspaceRestResourceConfig[ 'restManifest' ] >;
+	typesFile: string;
+	validatorsFile: string;
+} {
+	return (
+		typeof resource.clientFile === 'string' &&
+		typeof resource.openApiFile === 'string' &&
+		typeof resource.typesFile === 'string' &&
+		typeof resource.validatorsFile === 'string' &&
+		typeof resource.restManifest === 'object' &&
+		resource.restManifest !== null
+	);
+}
+
 async function assertTypeArtifactsCurrent( block: WorkspaceBlockConfig ) {
 	const report = await runSyncBlockMetadata(
 		{
@@ -73,12 +97,13 @@ async function assertTypeArtifactsCurrent( block: WorkspaceBlockConfig ) {
 async function main() {
 	const options = parseCliOptions( process.argv.slice( 2 ) );
 	const restBlocks = BLOCKS.filter( isRestEnabledBlock );
+	const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );
 
-	if ( restBlocks.length === 0 ) {
+	if ( restBlocks.length === 0 && restResources.length === 0 ) {
 		console.log(
 			options.check
-				? 'ℹ️ No REST-enabled workspace blocks are registered yet. `sync-rest --check` is already clean.'
-				: 'ℹ️ No REST-enabled workspace blocks are registered yet.'
+				? 'ℹ️ No REST-enabled workspace blocks or plugin-level REST resources are registered yet. `sync-rest --check` is already clean.'
+				: 'ℹ️ No REST-enabled workspace blocks or plugin-level REST resources are registered yet.'
 		);
 		return;
 	}
@@ -142,10 +167,59 @@ async function main() {
 		);
 	}
 
+	for ( const resource of restResources ) {
+		const contracts = resource.restManifest.contracts;
+
+		for ( const [ baseName, contract ] of Object.entries( contracts ) ) {
+			await syncTypeSchemas(
+				{
+					jsonSchemaFile: path.join(
+						path.dirname( resource.typesFile ),
+						'api-schemas',
+						`${ baseName }.schema.json`
+					),
+					openApiFile: path.join(
+						path.dirname( resource.typesFile ),
+						'api-schemas',
+						`${ baseName }.openapi.json`
+					),
+					sourceTypeName: contract.sourceTypeName,
+					typesFile: resource.typesFile,
+				},
+				{
+					check: options.check,
+				}
+			);
+		}
+
+		await syncRestOpenApi(
+			{
+				manifest: resource.restManifest,
+				openApiFile: resource.openApiFile,
+				typesFile: resource.typesFile,
+			},
+			{
+				check: options.check,
+			}
+		);
+
+		await syncEndpointClient(
+			{
+				clientFile: resource.clientFile,
+				manifest: resource.restManifest,
+				typesFile: resource.typesFile,
+				validatorsFile: resource.validatorsFile,
+			},
+			{
+				check: options.check,
+			}
+		);
+	}
+
 	console.log(
 		options.check
-			? '✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date with the TypeScript types!'
-			: '✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated from TypeScript types!'
+			? '✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date for workspace blocks and plugin-level resources!'
+			: '✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated for workspace blocks and plugin-level resources!'
 	);
 }
 

package/src/editor-plugins/.gitkeep

@@ -0,0 +1 @@
+

package/webpack.config.js.mustache

@@ -189,14 +189,29 @@ function getEditorEntries() {
 function getSharedEditorEntries() {
 	const entries = [];
 
-	for ( const relativePath of [ 'src/bindings/index.ts', 'src/bindings/index.js' ] ) {
-		const entryPath = path.resolve( process.cwd(), relativePath );
-		if ( ! fs.existsSync( entryPath ) ) {
-			continue;
-		}
+	for ( const [ entryName, candidates ] of [
+		[
+			'bindings/index',
+			[ 'src/bindings/index.ts', 'src/bindings/index.js' ],
+		],
+		[
+			'editor-plugins/index',
+			[ 'src/editor-plugins/index.ts', 'src/editor-plugins/index.js' ],
+		],
+		[
+			'admin-views/index',
+			[ 'src/admin-views/index.ts', 'src/admin-views/index.js' ],
+		],
+	] ) {
+		for ( const relativePath of candidates ) {
+			const entryPath = path.resolve( process.cwd(), relativePath );
+			if ( ! fs.existsSync( entryPath ) ) {
+				continue;
+			}
 
-		entries.push( [ 'bindings/index', entryPath ] );
-		break;
+			entries.push( [ entryName, entryPath ] );
+			break;
+		}
 	}
 
 	return Object.fromEntries( entries );

package/{{slugKebabCase}}.php.mustache

@@ -117,6 +117,42 @@ function {{phpPrefix}}_enqueue_binding_sources_editor() {
 	);
 }
 
+function {{phpPrefix}}_enqueue_editor_plugins_editor() {
+	$script_path = __DIR__ . '/build/editor-plugins/index.js';
+	$asset_path  = __DIR__ . '/build/editor-plugins/index.asset.php';
+	$style_path  = __DIR__ . '/build/editor-plugins/style-index.css';
+	$style_rtl_path = __DIR__ . '/build/editor-plugins/style-index-rtl.css';
+
+	if ( ! file_exists( $script_path ) || ! file_exists( $asset_path ) ) {
+		return;
+	}
+
+	$asset = require $asset_path;
+	if ( ! is_array( $asset ) ) {
+		$asset = array();
+	}
+
+	wp_enqueue_script(
+		'{{slugKebabCase}}-editor-plugins',
+		plugins_url( 'build/editor-plugins/index.js', __FILE__ ),
+		isset( $asset['dependencies'] ) && is_array( $asset['dependencies'] ) ? $asset['dependencies'] : array(),
+		isset( $asset['version'] ) ? $asset['version'] : filemtime( $script_path ),
+		true
+	);
+
+	if ( file_exists( $style_path ) ) {
+		wp_enqueue_style(
+			'{{slugKebabCase}}-editor-plugins',
+			plugins_url( 'build/editor-plugins/style-index.css', __FILE__ ),
+			array(),
+			isset( $asset['version'] ) ? $asset['version'] : filemtime( $style_path )
+		);
+		if ( file_exists( $style_rtl_path ) ) {
+			wp_style_add_data( '{{slugKebabCase}}-editor-plugins', 'rtl', 'replace' );
+		}
+	}
+}
+
 function {{phpPrefix}}_register_pattern_category() {
 	if ( function_exists( 'register_block_pattern_category' ) ) {
 		register_block_pattern_category(
@@ -143,3 +179,4 @@ add_action( 'init', '{{phpPrefix}}_register_binding_sources', 20 );
 add_action( 'init', '{{phpPrefix}}_register_pattern_category' );
 add_action( 'init', '{{phpPrefix}}_register_patterns', 20 );
 add_action( 'enqueue_block_editor_assets', '{{phpPrefix}}_enqueue_binding_sources_editor' );
+add_action( 'enqueue_block_editor_assets', '{{phpPrefix}}_enqueue_editor_plugins_editor' );