@wp-typia/project-tools 0.23.1 → 0.24.0

package/dist/runtime/workspace-inventory-templates.d.ts

@@ -23,9 +23,9 @@ export declare const BLOCK_STYLES_INTERFACE_SECTION = "\n\nexport interface Work
 export declare const BLOCK_STYLES_CONST_SECTION = "\n\nexport const BLOCK_STYLES: WorkspaceBlockStyleConfig[] = [\n\t// wp-typia add style entries\n];\n";
 export declare const BLOCK_TRANSFORMS_INTERFACE_SECTION = "\n\nexport interface WorkspaceBlockTransformConfig {\n\tblock: string;\n\tfile: string;\n\tfrom: string;\n\tslug: string;\n\tto: string;\n}\n";
 export declare const BLOCK_TRANSFORMS_CONST_SECTION = "\n\nexport const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [\n\t// wp-typia add transform entries\n];\n";
-export declare const PATTERNS_INTERFACE_SECTION = "\n\nexport interface WorkspacePatternConfig {\n\tfile: string;\n\tslug: string;\n}\n";
+export declare const PATTERNS_INTERFACE_SECTION = "\n\nexport interface WorkspacePatternConfig {\n\tcontentFile?: string;\n\tfile?: string;\n\tscope?: 'full' | 'section';\n\tsectionRole?: string;\n\tslug: string;\n\ttags?: string[];\n\tthumbnailUrl?: string;\n\ttitle?: string;\n}\n";
 export declare const PATTERNS_CONST_SECTION = "\n\nexport const PATTERNS: WorkspacePatternConfig[] = [\n\t// wp-typia add pattern entries\n];\n";
-export declare const BINDING_SOURCES_INTERFACE_SECTION = "\n\nexport interface WorkspaceBindingSourceConfig {\n\tattribute?: string;\n\tblock?: string;\n\teditorFile: string;\n\tserverFile: string;\n\tslug: string;\n}\n";
+export declare const BINDING_SOURCES_INTERFACE_SECTION = "\n\nexport interface WorkspaceBindingSourceConfig {\n\tattribute?: string;\n\tblock?: string;\n\teditorFile: string;\n\tmetaPath?: string;\n\tpostMeta?: string;\n\tserverFile: string;\n\tslug: string;\n}\n";
 export declare const BINDING_SOURCES_CONST_SECTION = "\n\nexport const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [\n\t// wp-typia add binding-source entries\n];\n";
 export declare const CONTRACTS_INTERFACE_SECTION = "\n\nexport interface WorkspaceContractConfig {\n\tschemaFile: string;\n\tslug: string;\n\tsourceTypeName: string;\n\ttypesFile: string;\n}\n";
 export declare const CONTRACTS_CONST_SECTION = "\n\nexport const CONTRACTS: WorkspaceContractConfig[] = [\n\t// wp-typia add contract entries\n];\n";

package/dist/runtime/workspace-inventory-templates.js

@@ -64,8 +64,14 @@ export const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [
 export const PATTERNS_INTERFACE_SECTION = `
 
 export interface WorkspacePatternConfig {
-\tfile: string;
+\tcontentFile?: string;
+\tfile?: string;
+\tscope?: 'full' | 'section';
+\tsectionRole?: string;
 \tslug: string;
+\ttags?: string[];
+\tthumbnailUrl?: string;
+\ttitle?: string;
 }
 `;
 export const PATTERNS_CONST_SECTION = `
@@ -80,6 +86,8 @@ export interface WorkspaceBindingSourceConfig {
 \tattribute?: string;
 \tblock?: string;
 \teditorFile: string;
+\tmetaPath?: string;
+\tpostMeta?: string;
 \tserverFile: string;
 \tslug: string;
 }

package/dist/runtime/workspace-inventory-types.d.ts

@@ -23,13 +23,21 @@ export interface WorkspaceBlockTransformInventoryEntry {
     to: string;
 }
 export interface WorkspacePatternInventoryEntry {
-    file: string;
+    contentFile?: string;
+    file?: string;
+    scope?: string;
+    sectionRole?: string;
     slug: string;
+    tags?: string[];
+    thumbnailUrl?: string;
+    title?: string;
 }
 export interface WorkspaceBindingSourceInventoryEntry {
     attribute?: string;
     block?: string;
     editorFile: string;
+    metaPath?: string;
+    postMeta?: string;
     serverFile: string;
     slug: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -92,6 +92,11 @@
       "import": "./dist/runtime/package-managers.js",
       "default": "./dist/runtime/package-managers.js"
     },
+    "./pattern-catalog": {
+      "types": "./dist/runtime/pattern-catalog.d.ts",
+      "import": "./dist/runtime/pattern-catalog.js",
+      "default": "./dist/runtime/pattern-catalog.js"
+    },
     "./schema-core": {
       "types": "./dist/runtime/schema-core.d.ts",
       "import": "./dist/runtime/schema-core.js",
@@ -161,9 +166,9 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/block-runtime": "^0.6.1",
+    "@wp-typia/block-runtime": "^0.7.0",
     "@wp-typia/rest": "^0.3.13",
-    "@wp-typia/block-types": "^0.2.4",
+    "@wp-typia/block-types": "^0.3.0",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
     "semver": "^7.7.3",

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

@@ -1,3 +1,21 @@
+import {
+	defineBlockNesting,
+	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 = [
 	{
 		attributeTypeName: '{{pascalCase}}Attributes',
@@ -11,3 +29,7 @@ export const BLOCKS = [
 	},
 	// add-child: insert new block config entries here
 ] as const;
+
+export const PATTERNS: WorkspacePatternConfig[] = [
+	// wp-typia add pattern entries
+];

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
+];