@wp-typia/project-tools 0.23.0 → 0.24.0

package/templates/_shared/compound/core/scripts/sync-types-to-block-json.ts.mustache

@@ -1,9 +1,17 @@
 /* eslint-disable no-console */
+import fs from 'node:fs';
 import path from 'node:path';
 
-import { syncBlockMetadata } from '@wp-typia/block-runtime/metadata-core';
+import {
+	formatBlockPatternContentNestingDiagnostics,
+	validateBlockPatternContentNesting,
+	syncInnerBlocksTemplateModule,
+	syncBlockMetadata,
+	validateBlockNestingContract,
+	validateInnerBlocksTemplates,
+} from '@wp-typia/block-runtime/metadata-core';
 
-import { BLOCKS } from './block-config';
+import { BLOCK_NESTING, BLOCK_TEMPLATES, BLOCKS, PATTERNS } from './block-config';
 
 function parseCliOptions( argv: string[] ) {
 	const options = {
@@ -22,15 +30,108 @@ function parseCliOptions( argv: string[] ) {
 	return options;
 }
 
+function readWorkspaceBlockName( block: ( typeof BLOCKS )[ number ] ): string {
+	const blockJsonFile = path.join( 'src', 'blocks', block.slug, 'block.json' );
+	let blockJson: { name?: unknown };
+	try {
+		blockJson = JSON.parse( fs.readFileSync( blockJsonFile, 'utf8' ) ) as {
+			name?: unknown;
+		};
+	} catch ( error ) {
+		throw new Error(
+			`Failed to read block.json for block "${ block.slug }" at ${ blockJsonFile }: ${
+				error instanceof Error ? error.message : String( error )
+			}`
+		);
+	}
+	if ( typeof blockJson.name !== 'string' || blockJson.name.trim() === '' ) {
+		throw new Error( `${ blockJsonFile } must define a string "name".` );
+	}
+
+	return blockJson.name;
+}
+
+function readPatternFileContent( pattern: ( typeof PATTERNS )[ number ] ): string {
+	try {
+		return fs.readFileSync( pattern.file, 'utf8' );
+	} catch ( error ) {
+		throw new Error(
+			`Failed to read pattern "${ pattern.slug }" at ${ pattern.file }: ${
+				error instanceof Error ? error.message : String( error )
+			}`
+		);
+	}
+}
+
+function validatePatternContentNesting( knownBlockNames: readonly string[] ) {
+	const diagnostics = PATTERNS.flatMap( ( pattern ) => {
+		const content = readPatternFileContent( pattern );
+		return validateBlockPatternContentNesting( content, {
+			allowExternalBlockNames: true,
+			knownBlockNames,
+			nesting: BLOCK_NESTING,
+			patternFile: pattern.file,
+		} ).diagnostics;
+	} );
+	const warnings = diagnostics.filter(
+		( diagnostic ) => diagnostic.severity === 'warning'
+	);
+	const errors = diagnostics.filter(
+		( diagnostic ) => diagnostic.severity === 'error'
+	);
+
+	if ( warnings.length > 0 ) {
+		console.warn(
+			`⚠️ Pattern nesting validation warnings:\n${ formatBlockPatternContentNestingDiagnostics(
+				warnings
+			) }`
+		);
+	}
+
+	if ( errors.length > 0 ) {
+		throw new Error(
+			`Pattern content violates block nesting contract:\n${ formatBlockPatternContentNestingDiagnostics(
+				errors
+			) }`
+		);
+	}
+}
+
 async function main() {
 	const options = parseCliOptions( process.argv.slice( 2 ) );
+	const knownBlockNames = BLOCKS.map( readWorkspaceBlockName );
+	validateBlockNestingContract( BLOCK_NESTING, {
+		allowExternalBlockNames: true,
+		knownBlockNames,
+	} );
+	validateInnerBlocksTemplates( BLOCK_TEMPLATES, {
+		allowExternalBlockNames: true,
+		knownBlockNames,
+		nesting: BLOCK_NESTING,
+	} );
+	validatePatternContentNesting( knownBlockNames );
+	await syncInnerBlocksTemplateModule(
+		{
+			allowExternalBlockNames: true,
+			knownBlockNames,
+			nesting: BLOCK_NESTING,
+			outputFile: path.join( 'src', 'inner-blocks-templates.ts' ),
+			templates: BLOCK_TEMPLATES,
+		},
+		{
+			check: options.check,
+		}
+	);
 
 	for ( const block of BLOCKS ) {
 		const baseDir = path.join( 'src', 'blocks', block.slug );
 		const result = await syncBlockMetadata( {
+			allowExternalBlockNames: true,
 			blockJsonFile: path.join( baseDir, 'block.json' ),
 			jsonSchemaFile: path.join( baseDir, 'typia.schema.json' ),
+			knownBlockNames,
 			manifestFile: path.join( baseDir, 'typia.manifest.json' ),
+			nesting: BLOCK_NESTING,
 			openApiFile: path.join( baseDir, 'typia.openapi.json' ),
 			sourceTypeName: block.attributeTypeName,
 			typesFile: block.typesFile,

package/templates/_shared/compound/core/src/inner-blocks-templates.ts.mustache

@@ -0,0 +1,13 @@
+/* This file is generated by wp-typia. Do not edit manually. */
+
+export type WpTypiaInnerBlocksTemplateAttributes = Record<string, unknown>;
+export type WpTypiaInnerBlocksTemplateItem = [
+	blockName: string,
+	attributes?: WpTypiaInnerBlocksTemplateAttributes,
+	innerBlocks?: WpTypiaInnerBlocksTemplate,
+];
+export type WpTypiaInnerBlocksTemplate = WpTypiaInnerBlocksTemplateItem[];
+
+export const INNER_BLOCKS_TEMPLATES = {} satisfies Record<string, WpTypiaInnerBlocksTemplate>;
+
+export type WpTypiaInnerBlocksTemplateName = keyof typeof INNER_BLOCKS_TEMPLATES;

package/templates/_shared/compound/persistence/scripts/block-config.ts.mustache

@@ -1,4 +1,21 @@
-import { defineEndpointManifest } from '@wp-typia/block-runtime/metadata-core';
+import {
+	defineBlockNesting,
+	defineEndpointManifest,
+	defineInnerBlocksTemplates,
+} from '@wp-typia/block-runtime/metadata-core';
+
+export const BLOCK_NESTING = defineBlockNesting( {
+	// Add parent, ancestor, and allowedBlocks relationships here.
+} );
+
+export const BLOCK_TEMPLATES = defineInnerBlocksTemplates( {
+	// Add default InnerBlocks templates here.
+} );
+
+export interface WorkspacePatternConfig {
+	file: string;
+	slug: string;
+}
 
 export const BLOCKS = [
 	{
@@ -73,3 +90,7 @@ export const BLOCKS = [
 	},
 	// add-child: insert new block config entries here
 ] as const;
+
+export const PATTERNS: WorkspacePatternConfig[] = [
+	// wp-typia add pattern entries
+];