@wp-typia/project-tools 0.16.8 → 0.16.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.8",
+  "version": "0.16.9",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -17,6 +17,11 @@
       "import": "./dist/runtime/cli-add.js",
       "default": "./dist/runtime/cli-add.js"
     },
+    "./cli-diagnostics": {
+      "types": "./dist/runtime/cli-diagnostics.d.ts",
+      "import": "./dist/runtime/cli-diagnostics.js",
+      "default": "./dist/runtime/cli-diagnostics.js"
+    },
     "./cli-doctor": {
       "types": "./dist/runtime/cli-doctor.d.ts",
       "import": "./dist/runtime/cli-doctor.js",
@@ -115,9 +120,9 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.4",
-    "@wp-typia/block-runtime": "^0.4.7",
+    "@wp-typia/block-runtime": "^0.4.8",
     "@wp-typia/rest": "^0.3.7",
-    "@wp-typia/block-types": "^0.2.1",
+    "@wp-typia/block-types": "^0.2.2",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
     "semver": "^7.7.3",

package/templates/_shared/base/src/validator-toolkit.ts.mustache

@@ -1,8 +1,8 @@
-import type { ManifestDefaultsDocument } from '@wp-typia/block-runtime/defaults';
 import {
 	createScaffoldValidatorToolkit,
 	type ScaffoldValidatorToolkitOptions,
 } from '@wp-typia/block-runtime/validation';
+import { parseManifestDefaultsDocument } from '@wp-typia/block-runtime/defaults';
 
 interface TemplateValidatorFunctions< T extends object > {
 	assert: ScaffoldValidatorToolkitOptions< T >['assert'];
@@ -32,7 +32,7 @@ export function createTemplateValidatorToolkit< T extends object >( {
 	validate,
 }: TemplateValidatorToolkitOptions< T > ) {
 	return createScaffoldValidatorToolkit< T >( {
-		manifest: manifest as ManifestDefaultsDocument,
+		manifest: parseManifestDefaultsDocument( manifest ),
 		validate,
 		assert,
 		is,

package/templates/_shared/compound/core/scripts/add-compound-child.ts.mustache

@@ -410,12 +410,42 @@ export const useTypiaValidation = createUseTypiaValidationHook( {
 `;
 }
 
+function renderBlockMetadataFile(): string {
+	return `import rawMetadata from './block.json';
+import { defineScaffoldBlockMetadata } from '@wp-typia/block-runtime/blocks';
+
+const metadata = defineScaffoldBlockMetadata( rawMetadata );
+
+export default metadata;
+`;
+}
+
+function renderManifestDocumentFile(): string {
+	return `import rawCurrentManifest from './typia.manifest.json';
+import { defineManifestDocument } from '@wp-typia/block-runtime/editor';
+
+const currentManifest = defineManifestDocument( rawCurrentManifest );
+
+export default currentManifest;
+`;
+}
+
+function renderManifestDefaultsDocumentFile(): string {
+	return `import rawCurrentManifest from './typia.manifest.json';
+import { defineManifestDefaultsDocument } from '@wp-typia/block-runtime/defaults';
+
+const currentManifest = defineManifestDefaultsDocument( rawCurrentManifest );
+
+export default currentManifest;
+`;
+}
+
 function renderValidatorsFile(
 	childTypeName: string,
 	childInterfaceName: string
 ): string {
 	return `import typia from 'typia';
-import currentManifest from './typia.manifest.json';
+import currentManifest from './manifest-defaults-document';
 import type {
 \t${ childTypeName },
 \t${ childInterfaceName }ValidationResult,
@@ -460,7 +490,7 @@ function renderEditFile(
 ): string {
 	const childCssClassName = buildBlockCssClassName( PARENT_BLOCK_NAMESPACE, childFolderSlug );
 
-	return `import type { BlockEditProps } from '@wordpress/blocks';
+	return `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
 import { RichText, useBlockProps } from '@wordpress/block-editor';
 import { Notice } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
@@ -546,26 +576,27 @@ export default function Save( {
 }
 
 function renderIndexFile( childTypeName: string, childFolderSlug: string ): string {
-	return `import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wordpress/blocks';
+return `import { registerBlockType } from '@wordpress/blocks';
+import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
 import {
 \tbuildScaffoldBlockRegistration,
-\ttype ScaffoldBlockMetadata,
+\tparseScaffoldBlockMetadata,
 } from '@wp-typia/block-runtime/blocks';
 
 import Edit from './edit';
 import Save from './save';
-import metadata from './block.json';
+import metadata from './block-metadata';
 import '${ PARENT_STYLE_IMPORT }';
 
 import type { ${ childTypeName } } from './types';
 
-const registration = buildScaffoldBlockRegistration<
-\tBlockConfiguration< ${ childTypeName } >
->( metadata as ScaffoldBlockMetadata, {
-\tedit: Edit,
-\tsave: Save,
-} );
+const registration = buildScaffoldBlockRegistration(
+\tparseScaffoldBlockMetadata<BlockConfiguration< ${ childTypeName } >>( metadata ),
+\t{
+\t\tedit: Edit,
+\t\tsave: Save,
+\t}
+);
 
 registerBlockType< ${ childTypeName } >(
 \tregistration.name,
@@ -625,6 +656,21 @@ function main() {
 		renderStarterManifestFile( childTypeName, childTitle ),
 		'utf8'
 	);
+	fs.writeFileSync(
+		path.join( childDir, 'block-metadata.ts' ),
+		renderBlockMetadataFile(),
+		'utf8'
+	);
+	fs.writeFileSync(
+		path.join( childDir, 'manifest-document.ts' ),
+		renderManifestDocumentFile(),
+		'utf8'
+	);
+	fs.writeFileSync(
+		path.join( childDir, 'manifest-defaults-document.ts' ),
+		renderManifestDefaultsDocumentFile(),
+		'utf8'
+	);
 	fs.writeFileSync( path.join( childDir, 'hooks.ts' ), renderHooksFile(), 'utf8' );
 	fs.writeFileSync(
 		path.join( childDir, 'validators.ts' ),

package/templates/_shared/migration-ui/common/src/migrations/helpers.ts

@@ -1,42 +1,12 @@
-export interface ManifestUnion {
-	branches: Record< string, ManifestAttribute >;
-	discriminator: string;
-}
-
-export interface ManifestAttribute {
-	typia: {
-		constraints: {
-			format: string | null;
-			maxLength: number | null;
-			maximum: number | null;
-			minLength: number | null;
-			minimum: number | null;
-			pattern: string | null;
-			typeTag: string | null;
-		};
-		defaultValue: unknown;
-		hasDefault: boolean;
-	};
-	ts: {
-		items: ManifestAttribute | null;
-		kind: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'union';
-		properties: Record< string, ManifestAttribute > | null;
-		required: boolean;
-		union: ManifestUnion | null;
-	};
-	wp: {
-		defaultValue: unknown;
-		enum: Array< string | number | boolean > | null;
-		hasDefault: boolean;
-		type: 'string' | 'number' | 'boolean' | 'array' | 'object';
-	};
-}
+import type {
+	ManifestAttribute,
+	ManifestDocument,
+} from '@wp-typia/block-runtime/migration-types';
 
-export interface ManifestDocument {
-	attributes: Record< string, ManifestAttribute >;
-	manifestVersion: 2;
-	sourceType: string;
-}
+export type {
+	ManifestAttribute,
+	ManifestDocument,
+} from '@wp-typia/block-runtime/migration-types';
 
 export interface MigrationRiskBucket {
 	count: number;
@@ -282,7 +252,7 @@ export function manifestMatchesDocument(
 	manifest: ManifestDocument,
 	attributes: Record< string, unknown >
 ): boolean {
-	for ( const [ key, attribute ] of Object.entries( manifest.attributes ) ) {
+	for ( const [ key, attribute ] of Object.entries( manifest.attributes ?? {} ) ) {
 		const value = attributes[ key ];
 		if (
 			( value === undefined || value === null ) &&
@@ -304,20 +274,22 @@ export function summarizeVersionDelta(
 	legacyManifest: ManifestDocument,
 	currentManifest: ManifestDocument
 ): { added: string[]; removed: string[]; changed: string[] } {
-	const added = Object.keys( currentManifest.attributes ).filter(
-		( key ) => ! ( key in legacyManifest.attributes )
+	const currentAttributes = currentManifest.attributes ?? {};
+	const legacyAttributes = legacyManifest.attributes ?? {};
+	const added = Object.keys( currentAttributes ).filter(
+		( key ) => ! ( key in legacyAttributes )
 	);
-	const removed = Object.keys( legacyManifest.attributes ).filter(
-		( key ) => ! ( key in currentManifest.attributes )
+	const removed = Object.keys( legacyAttributes ).filter(
+		( key ) => ! ( key in currentAttributes )
 	);
-	const changed = Object.keys( currentManifest.attributes ).filter(
+	const changed = Object.keys( currentAttributes ).filter(
 		( key ) => {
-			if ( ! ( key in legacyManifest.attributes ) ) {
+			if ( ! ( key in legacyAttributes ) ) {
 				return false;
 			}
 			return (
-				JSON.stringify( currentManifest.attributes[ key ] ) !==
-				JSON.stringify( legacyManifest.attributes[ key ] )
+				JSON.stringify( currentAttributes[ key ] ) !==
+				JSON.stringify( legacyAttributes[ key ] )
 			);
 		}
 	);

package/templates/_shared/migration-ui/common/src/migrations/index.ts

@@ -1,5 +1,7 @@
 import apiFetch from '@wordpress/api-fetch';
-import { parse, serialize, type BlockInstance } from '@wordpress/blocks';
+import { parse, serialize } from '@wordpress/blocks';
+import type { BlockInstance } from '@wp-typia/block-types/blocks/registration';
+import { parseManifestDocument } from '@wp-typia/block-runtime/editor';
 import typia from 'typia';
 
 import migrationBlocks from './generated';
@@ -148,6 +150,36 @@ interface MigrationResolution {
 	preview: MigrationPreview;
 }
 
+const manifestDocumentCache = new WeakMap< object, ManifestDocument >();
+
+function parseCachedManifestDocument( manifest: unknown ): ManifestDocument {
+	if ( typeof manifest !== 'object' || manifest === null ) {
+		return parseManifestDocument< ManifestDocument >( manifest );
+	}
+
+	const cached = manifestDocumentCache.get( manifest );
+	if ( cached ) {
+		return cached;
+	}
+
+	const parsed = parseManifestDocument< ManifestDocument >( manifest );
+	manifestDocumentCache.set( manifest, parsed );
+	return parsed;
+}
+
+function getCurrentManifestDocument(
+	target: MigrationTargetRuntime
+): ManifestDocument {
+	return parseCachedManifestDocument( target.registry.currentManifest );
+}
+
+function getLegacyManifestDocument(
+	target: MigrationTargetRuntime,
+	entry: MigrationTargetRuntime[ 'registry' ][ 'entries' ][ number ]
+): ManifestDocument {
+	return parseCachedManifestDocument( entry.manifest );
+}
+
 const EMPTY_RISK_SUMMARY: MigrationRiskSummary = {
 	additive: {
 		count: 0,
@@ -633,8 +665,7 @@ function resolveMigrationState(
 			preview: createPreview( {
 				after: attributes,
 				before: attributes,
-				currentManifest:
-					target.registry.currentManifest as ManifestDocument,
+				currentManifest: getCurrentManifestDocument( target ),
 				legacyManifest: null,
 				status: 'current',
 				unresolved: [],
@@ -646,7 +677,7 @@ function resolveMigrationState(
 	for ( const entry of target.registry.entries ) {
 		if (
 			manifestMatchesDocument(
-				entry.manifest as ManifestDocument,
+				getLegacyManifestDocument( target, entry ),
 				attributes
 			)
 		) {
@@ -669,16 +700,15 @@ function resolveMigrationState(
 					? ( migrated as Record< string, unknown > )
 					: null,
 				before: attributes,
-				currentManifest:
-					target.registry.currentManifest as ManifestDocument,
-				legacyManifest: entry.manifest as ManifestDocument,
+				currentManifest: getCurrentManifestDocument( target ),
+				legacyManifest: getLegacyManifestDocument( target, entry ),
 				status,
 				unresolved,
 				validationErrors,
 			} );
 			const delta = summarizeVersionDelta(
-				entry.manifest as ManifestDocument,
-				target.registry.currentManifest as ManifestDocument
+				getLegacyManifestDocument( target, entry ),
+				getCurrentManifestDocument( target )
 			);
 
 			return {
@@ -727,8 +757,7 @@ function resolveMigrationState(
 		preview: createPreview( {
 			after: null,
 			before: attributes,
-			currentManifest:
-				target.registry.currentManifest as ManifestDocument,
+			currentManifest: getCurrentManifestDocument( target ),
 			legacyManifest: null,
 			status: 'unknown',
 			unresolved: [