@wp-typia/project-tools 0.16.0 → 0.16.1

package/dist/runtime/cli-help.js

@@ -34,7 +34,7 @@ Package managers: ${PACKAGE_MANAGER_IDS.join(", ")}
 Notes:
   \`wp-typia create\` is the canonical scaffold command.
   \`wp-typia <project-dir>\` remains a backward-compatible alias to \`create\`.
-  Use \`--template @wp-typia/create-workspace-template\` for the official empty workspace scaffold behind \`wp-typia add ...\`.
+  Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
   \`add variation\` uses an existing workspace block from \`scripts/block-config.ts\`.
   \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/\`.
   \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`.

package/dist/runtime/scaffold.js

@@ -19,6 +19,7 @@ const BLOCK_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
 const PHP_PREFIX_PATTERN = /^[a-z_][a-z0-9_]*$/;
 const PHP_PREFIX_MAX_LENGTH = 50;
 const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
+const WORKSPACE_TEMPLATE_ALIAS = "workspace";
 const EPHEMERAL_NODE_MODULES_LINK_TYPE = process.platform === "win32" ? "junction" : "dir";
 const LOCKFILES = {
     bun: ["bun.lock", "bun.lockb"],
@@ -138,15 +139,21 @@ export function getDefaultAnswers(projectName, templateId) {
         title: toTitleCase(slugDefault),
     };
 }
+function normalizeTemplateSelection(templateId) {
+    return templateId === WORKSPACE_TEMPLATE_ALIAS
+        ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
+        : templateId;
+}
 export async function resolveTemplateId({ templateId, yes = false, isInteractive = false, selectTemplate, }) {
     if (templateId) {
+        const normalizedTemplateId = normalizeTemplateSelection(templateId);
         if (isRemovedBuiltInTemplateId(templateId)) {
             throw new Error(getRemovedBuiltInTemplateMessage(templateId));
         }
-        if (isBuiltInTemplateId(templateId)) {
-            return getTemplateById(templateId).id;
+        if (isBuiltInTemplateId(normalizedTemplateId)) {
+            return getTemplateById(normalizedTemplateId).id;
         }
-        return templateId;
+        return normalizedTemplateId;
     }
     if (yes) {
         return "basic";
@@ -154,7 +161,7 @@ export async function resolveTemplateId({ templateId, yes = false, isInteractive
     if (!isInteractive || !selectTemplate) {
         throw new Error(`Template is required in non-interactive mode. Use --template <${TEMPLATE_IDS.join("|")}|./path|github:owner/repo/path[#ref]|npm-package>.`);
     }
-    return selectTemplate();
+    return normalizeTemplateSelection(await selectTemplate());
 }
 export async function resolvePackageManagerId({ packageManager, yes = false, isInteractive = false, selectPackageManager, }) {
     if (packageManager) {
@@ -628,14 +635,15 @@ async function applyWorkspaceMigrationCapability(projectDir, packageManager) {
     writeInitialMigrationScaffold(projectDir, "v1", []);
 }
 export async function scaffoldProject({ projectDir, templateId, answers, dataStorageMode, persistencePolicy, packageManager, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+    const resolvedTemplateId = normalizeTemplateSelection(templateId);
     const resolvedPackageManager = getPackageManager(packageManager).id;
-    const isBuiltInTemplate = isBuiltInTemplateId(templateId);
-    const variables = getTemplateVariables(templateId, {
+    const isBuiltInTemplate = isBuiltInTemplateId(resolvedTemplateId);
+    const variables = getTemplateVariables(resolvedTemplateId, {
         ...answers,
         dataStorageMode: dataStorageMode ?? answers.dataStorageMode,
         persistencePolicy: persistencePolicy ?? answers.persistencePolicy,
     });
-    const templateSource = await resolveTemplateSource(templateId, cwd, variables, variant);
+    const templateSource = await resolveTemplateSource(resolvedTemplateId, cwd, variables, variant);
     const supportsMigrationUi = isBuiltInTemplate || templateSource.isOfficialWorkspaceTemplate === true;
     if (withMigrationUi && !supportsMigrationUi) {
         await templateSource.cleanup?.();
@@ -652,8 +660,8 @@ export async function scaffoldProject({ projectDir, templateId, answers, dataSto
     }
     const isOfficialWorkspace = isOfficialWorkspaceProject(projectDir);
     if (isBuiltInTemplate) {
-        await writeStarterManifestFiles(projectDir, templateId, variables);
-        await seedBuiltInPersistenceArtifacts(projectDir, templateId, variables);
+        await writeStarterManifestFiles(projectDir, resolvedTemplateId, variables);
+        await seedBuiltInPersistenceArtifacts(projectDir, resolvedTemplateId, variables);
         await applyLocalDevPresetFiles({
             projectDir,
             variables,
@@ -664,7 +672,7 @@ export async function scaffoldProject({ projectDir, templateId, answers, dataSto
             await applyMigrationUiCapability({
                 packageManager: resolvedPackageManager,
                 projectDir,
-                templateId,
+                templateId: resolvedTemplateId,
                 variables,
             });
         }
@@ -674,7 +682,7 @@ export async function scaffoldProject({ projectDir, templateId, answers, dataSto
     }
     const readmePath = path.join(projectDir, "README.md");
     if (!fs.existsSync(readmePath)) {
-        await fsp.writeFile(readmePath, buildReadme(templateId, variables, resolvedPackageManager, {
+        await fsp.writeFile(readmePath, buildReadme(resolvedTemplateId, variables, resolvedPackageManager, {
             withMigrationUi: isBuiltInTemplate || isOfficialWorkspace ? withMigrationUi : false,
             withTestPreset: isBuiltInTemplate ? withTestPreset : false,
             withWpEnv: isBuiltInTemplate ? withWpEnv : false,
@@ -691,7 +699,7 @@ export async function scaffoldProject({ projectDir, templateId, answers, dataSto
             compoundPersistenceEnabled: variables.compoundPersistenceEnabled === "true",
             packageManager: resolvedPackageManager,
             projectDir,
-            templateId,
+            templateId: resolvedTemplateId,
             withTestPreset,
             withWpEnv,
         });
@@ -709,7 +717,7 @@ export async function scaffoldProject({ projectDir, templateId, answers, dataSto
     return {
         projectDir,
         selectedVariant: templateSource.selectedVariant ?? null,
-        templateId,
+        templateId: resolvedTemplateId,
         packageManager: resolvedPackageManager,
         variables,
         warnings: templateSource.warnings ?? [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.2",
-    "@wp-typia/block-runtime": "^0.4.3",
+    "@wp-typia/block-runtime": "^0.4.4",
     "@wp-typia/rest": "^0.3.5",
     "@wp-typia/block-types": "^0.2.1",
     "mustache": "^4.2.0",

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

@@ -346,8 +346,15 @@ function renderBlockJson(
 	) }\n`;
 }
 
-function renderTypesFile( childTypeName: string, childTitle: string ): string {
-	return `import { tags } from 'typia';
+function renderTypesFile(
+	childTypeName: string,
+	childInterfaceName: string,
+	childTitle: string
+): string {
+	return `import type { ValidationResult } from '@wp-typia/block-runtime/validation';
+import { tags } from 'typia';
+
+export type { ValidationResult } from '@wp-typia/block-runtime/validation';
 
 export interface ${ childTypeName } {
 \ttitle: string &
@@ -359,6 +366,8 @@ export interface ${ childTypeName } {
 \t\ttags.MaxLength< 280 > &
 \t\ttags.Default< ${ JSON.stringify( CHILD_PLACEHOLDER ) } >;
 }
+
+export type ${ childInterfaceName }ValidationResult = ValidationResult< ${ childTypeName } >;
 `;
 }
 
@@ -407,36 +416,37 @@ function renderValidatorsFile(
 ): string {
 	return `import typia from 'typia';
 import currentManifest from './typia.manifest.json';
-import {
-\ttype ManifestDefaultsDocument,
-} from '@wp-typia/block-runtime/defaults';
-import {
-\tcreateScaffoldValidatorToolkit,
-} from '@wp-typia/block-runtime/validation';
-
-import type { ${ childTypeName } } from './types';
-
-const validate = typia.createValidate< ${ childTypeName } >();
-const assert = typia.createAssert< ${ childTypeName } >();
-const is = typia.createIs< ${ childTypeName } >();
-const random = typia.createRandom< ${ childTypeName } >();
-const clone = typia.misc.createClone< ${ childTypeName } >();
-const prune = typia.misc.createPrune< ${ childTypeName } >();
-const scaffoldValidators = createScaffoldValidatorToolkit< ${ childTypeName } >( {
-\tmanifest: currentManifest as ManifestDefaultsDocument,
-\tvalidate,
-\tassert,
-\tis,
-\trandom,
-\tclone,
-\tprune,
+import type {
+\t${ childTypeName },
+\t${ childInterfaceName }ValidationResult,
+} from './types';
+import { createTemplateValidatorToolkit } from '../../validator-toolkit';
+
+const scaffoldValidators = createTemplateValidatorToolkit< ${ childTypeName } >( {
+\tassert: typia.createAssert< ${ childTypeName } >(),
+\tclone: typia.misc.createClone< ${ childTypeName } >() as (
+\t\tvalue: ${ childTypeName },
+\t) => ${ childTypeName },
+\tis: typia.createIs< ${ childTypeName } >(),
+\tmanifest: currentManifest,
+\tprune: typia.misc.createPrune< ${ childTypeName } >(),
+\trandom: typia.createRandom< ${ childTypeName } >() as (
+\t\t...args: unknown[]
+\t) => ${ childTypeName },
+\tvalidate: typia.createValidate< ${ childTypeName } >(),
 } );
 
-export const validate${ childInterfaceName } = scaffoldValidators.validateAttributes;
+export const validate${ childInterfaceName } =
+\tscaffoldValidators.validateAttributes as (
+\t\tattributes: unknown
+\t) => ${ childInterfaceName }ValidationResult;
 
 export const validators = scaffoldValidators.validators;
 
-export const sanitize${ childInterfaceName } = scaffoldValidators.sanitizeAttributes;
+export const sanitize${ childInterfaceName } =
+\tscaffoldValidators.sanitizeAttributes as (
+\t\tattributes: Partial< ${ childTypeName } >
+\t) => ${ childTypeName };
 
 export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;
 `;
@@ -605,7 +615,11 @@ function main() {
 		renderBlockJson( childBlockName, childFolderSlug, childTitle ),
 		'utf8'
 	);
-	fs.writeFileSync( path.join( childDir, 'types.ts' ), renderTypesFile( childTypeName, childTitle ), 'utf8' );
+	fs.writeFileSync(
+		path.join( childDir, 'types.ts' ),
+		renderTypesFile( childTypeName, childInterfaceName, childTitle ),
+		'utf8'
+	);
 	fs.writeFileSync(
 		path.join( childDir, 'typia.manifest.json' ),
 		renderStarterManifestFile( childTypeName, childTitle ),

package/templates/_shared/compound/persistence/src/blocks/{{slugKebabCase}}/interactivity.ts.mustache

@@ -123,6 +123,8 @@ const { actions, state } = store( '{{slugKebabCase}}', {
 			let bootstrapSucceeded = false;
 			let lastBootstrapError =
 				'Unable to initialize write access';
+			const includePublicWriteCredentials = {{isPublicPersistencePolicy}};
+			const includeRestNonce = {{isAuthenticatedPersistencePolicy}};
 
 			for ( let attempt = 1; attempt <= BOOTSTRAP_MAX_ATTEMPTS; attempt += 1 ) {
 				try {
@@ -146,16 +148,22 @@ const { actions, state } = store( '{{slugKebabCase}}', {
 					}
 
 					clientState.writeExpiry =
+						includePublicWriteCredentials &&
+						'publicWriteExpiresAt' in result.data &&
 						typeof result.data.publicWriteExpiresAt === 'number' &&
 						result.data.publicWriteExpiresAt > 0
 							? result.data.publicWriteExpiresAt
 							: 0;
 					clientState.writeToken =
+						includePublicWriteCredentials &&
+						'publicWriteToken' in result.data &&
 						typeof result.data.publicWriteToken === 'string' &&
 						result.data.publicWriteToken.length > 0
 							? result.data.publicWriteToken
 							: '';
 					clientState.writeNonce =
+						includeRestNonce &&
+						'restNonce' in result.data &&
 						typeof result.data.restNonce === 'string' &&
 						result.data.restNonce.length > 0
 							? result.data.restNonce

package/templates/_shared/compound/persistence-auth/{{slugKebabCase}}.php.mustache

@@ -79,7 +79,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -110,7 +110,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -122,7 +122,7 @@ function {{phpPrefix}}_get_rest_build_dir() {
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -144,7 +144,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -188,7 +188,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/_shared/compound/persistence-public/{{slugKebabCase}}.php.mustache

@@ -82,7 +82,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -113,7 +113,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -125,7 +125,7 @@ function {{phpPrefix}}_get_rest_build_dir() {
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -147,7 +147,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -191,7 +191,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/_shared/persistence/auth/{{slugKebabCase}}.php.mustache

@@ -84,7 +84,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -115,7 +115,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -127,7 +127,7 @@ function {{phpPrefix}}_get_rest_build_dir() {
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -149,7 +149,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -193,7 +193,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/_shared/persistence/core/src/interactivity.ts.mustache

@@ -126,6 +126,7 @@ const { actions, state } = store( '{{slugKebabCase}}', {
 			let bootstrapSucceeded = false;
 			let lastBootstrapError =
 				'Unable to initialize write access';
+			const includePublicWriteCredentials = {{isPublicPersistencePolicy}};
 			const includeRestNonce = {{isAuthenticatedPersistencePolicy}};
 
 			for ( let attempt = 1; attempt <= BOOTSTRAP_MAX_ATTEMPTS; attempt += 1 ) {
@@ -150,11 +151,15 @@ const { actions, state } = store( '{{slugKebabCase}}', {
 					}
 
 					clientState.writeExpiry =
+						includePublicWriteCredentials &&
+						'publicWriteExpiresAt' in result.data &&
 						typeof result.data.publicWriteExpiresAt === 'number' &&
 						result.data.publicWriteExpiresAt > 0
 							? result.data.publicWriteExpiresAt
 							: 0;
 					clientState.writeToken =
+						includePublicWriteCredentials &&
+						'publicWriteToken' in result.data &&
 						typeof result.data.publicWriteToken === 'string' &&
 						result.data.publicWriteToken.length > 0
 							? result.data.publicWriteToken

package/templates/_shared/persistence/core/{{slugKebabCase}}.php.mustache

@@ -81,7 +81,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -112,7 +112,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -170,7 +170,7 @@ function {{phpPrefix}}_validate_and_sanitize_request( $value, $schema_name, $par
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -191,7 +191,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -235,7 +235,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/_shared/persistence/public/{{slugKebabCase}}.php.mustache

@@ -87,7 +87,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -118,7 +118,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -130,7 +130,7 @@ function {{phpPrefix}}_get_rest_build_dir() {
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -152,7 +152,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -196,7 +196,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/_shared/workspace/persistence-auth/server.php.mustache

@@ -7,6 +7,8 @@ if ( ! defined( 'ABSPATH' ) ) {
 require_once __DIR__ . '/inc/rest-shared.php';
 require_once __DIR__ . '/inc/rest-auth.php';
 
+define( '{{phpPrefixUpper}}_DATA_STORAGE_MODE', '{{dataStorageMode}}' );
+
 function {{phpPrefix}}_get_rest_build_dir() {
 	return dirname( __DIR__, 3 ) . '/build/blocks/{{slugKebabCase}}';
 }
@@ -50,7 +52,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -81,7 +83,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -89,7 +91,7 @@ function {{phpPrefix}}_ensure_storage_installed() {
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -110,7 +112,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -154,7 +156,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/_shared/workspace/persistence-public/server.php.mustache

@@ -7,6 +7,8 @@ if ( ! defined( 'ABSPATH' ) ) {
 require_once __DIR__ . '/inc/rest-shared.php';
 require_once __DIR__ . '/inc/rest-public.php';
 
+define( '{{phpPrefixUpper}}_DATA_STORAGE_MODE', '{{dataStorageMode}}' );
+
 function {{phpPrefix}}_get_rest_build_dir() {
 	return dirname( __DIR__, 3 ) . '/build/blocks/{{slugKebabCase}}';
 }
@@ -50,7 +52,7 @@ function {{phpPrefix}}_with_counter_lock( $post_id, $resource_key, $callback ) {
 }
 
 function {{phpPrefix}}_maybe_install_storage() {
-	if ( 'custom-table' !== '{{dataStorageMode}}' ) {
+	if ( 'custom-table' !== {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		return;
 	}
 
@@ -81,7 +83,7 @@ function {{phpPrefix}}_maybe_install_storage() {
 }
 
 function {{phpPrefix}}_ensure_storage_installed() {
-	if ( 'custom-table' === '{{dataStorageMode}}' && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE && '1.0.0' !== get_option( '{{phpPrefix}}_storage_version', '' ) ) {
 		{{phpPrefix}}_maybe_install_storage();
 	}
 }
@@ -89,7 +91,7 @@ function {{phpPrefix}}_ensure_storage_installed() {
 function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name = {{phpPrefix}}_get_counter_table_name();
 		$count      = $wpdb->get_var(
 			$wpdb->prepare(
@@ -110,7 +112,7 @@ function {{phpPrefix}}_get_counter( $post_id, $resource_key ) {
 function {{phpPrefix}}_increment_counter( $post_id, $resource_key, $delta ) {
 	global $wpdb;
 
-	if ( 'custom-table' === '{{dataStorageMode}}' ) {
+	if ( 'custom-table' === {{phpPrefixUpper}}_DATA_STORAGE_MODE ) {
 		$table_name    = {{phpPrefix}}_get_counter_table_name();
 		$delta_value   = (int) $delta;
 		$initial_count = max( 0, $delta_value );
@@ -154,7 +156,7 @@ function {{phpPrefix}}_build_state_response( $post_id, $resource_key, $count ) {
 		'postId'      => (int) $post_id,
 		'resourceKey' => (string) $resource_key,
 		'count'       => (int) $count,
-		'storage'     => '{{dataStorageMode}}',
+		'storage'     => {{phpPrefixUpper}}_DATA_STORAGE_MODE,
 	);
 }
 

package/templates/compound/src/blocks/{{slugKebabCase}}/types.ts.mustache

@@ -1,5 +1,8 @@
+import type { ValidationResult } from '@wp-typia/block-runtime/validation';
 import { tags } from 'typia';
 
+export type { ValidationResult } from '@wp-typia/block-runtime/validation';
+
 export interface {{pascalCase}}Attributes {
 	heading: string &
 		tags.MinLength< 1 > &
@@ -11,3 +14,5 @@ export interface {{pascalCase}}Attributes {
 		tags.Default< 'Add and reorder internal items inside this compound block.' >;
 	showDividers?: boolean & tags.Default< true >;
 }
+
+export type {{pascalCase}}ValidationResult = ValidationResult< {{pascalCase}}Attributes >;

package/templates/compound/src/blocks/{{slugKebabCase}}/validators.ts.mustache

@@ -1,6 +1,9 @@
 import typia from 'typia';
 import currentManifest from './typia.manifest.json';
-import type { {{pascalCase}}Attributes } from './types';
+import type {
+	{{pascalCase}}Attributes,
+	{{pascalCase}}ValidationResult,
+} from './types';
 import { createTemplateValidatorToolkit } from '../../validator-toolkit';
 
 const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}Attributes >( {
@@ -18,11 +21,15 @@ const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}Attribu
 } );
 
 export const validate{{pascalCase}}Attributes =
-	scaffoldValidators.validateAttributes;
+	scaffoldValidators.validateAttributes as (
+		attributes: unknown
+	) => {{pascalCase}}ValidationResult;
 
 export const validators = scaffoldValidators.validators;
 
 export const sanitize{{pascalCase}}Attributes =
-	scaffoldValidators.sanitizeAttributes;
+	scaffoldValidators.sanitizeAttributes as (
+		attributes: Partial< {{pascalCase}}Attributes >
+	) => {{pascalCase}}Attributes;
 
 export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;

package/templates/compound/src/blocks/{{slugKebabCase}}-item/types.ts.mustache

@@ -1,5 +1,8 @@
+import type { ValidationResult } from '@wp-typia/block-runtime/validation';
 import { tags } from 'typia';
 
+export type { ValidationResult } from '@wp-typia/block-runtime/validation';
+
 export interface {{pascalCase}}ItemAttributes {
 	title: string &
 		tags.MinLength< 1 > &
@@ -10,3 +13,5 @@ export interface {{pascalCase}}ItemAttributes {
 		tags.MaxLength< 280 > &
 		tags.Default< 'Add supporting details for this internal item.' >;
 }
+
+export type {{pascalCase}}ItemValidationResult = ValidationResult< {{pascalCase}}ItemAttributes >;

package/templates/compound/src/blocks/{{slugKebabCase}}-item/validators.ts.mustache

@@ -1,6 +1,9 @@
 import typia from 'typia';
 import currentManifest from './typia.manifest.json';
-import type { {{pascalCase}}ItemAttributes } from './types';
+import type {
+	{{pascalCase}}ItemAttributes,
+	{{pascalCase}}ItemValidationResult,
+} from './types';
 import { createTemplateValidatorToolkit } from '../../validator-toolkit';
 
 const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}ItemAttributes >( {
@@ -18,11 +21,15 @@ const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}ItemAtt
 } );
 
 export const validate{{pascalCase}}ItemAttributes =
-	scaffoldValidators.validateAttributes;
+	scaffoldValidators.validateAttributes as (
+		attributes: unknown
+	) => {{pascalCase}}ItemValidationResult;
 
 export const validators = scaffoldValidators.validators;
 
 export const sanitize{{pascalCase}}ItemAttributes =
-	scaffoldValidators.sanitizeAttributes;
+	scaffoldValidators.sanitizeAttributes as (
+		attributes: Partial< {{pascalCase}}ItemAttributes >
+	) => {{pascalCase}}ItemAttributes;
 
 export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;

package/templates/interactivity/src/edit.tsx.mustache

@@ -258,7 +258,7 @@ export default function Edit({ attributes, setAttributes, isSelected }: {
           {animation !== 'none' && (
             <div
               className={`{{cssClassName}}__animation ${attributes.isAnimating ? 'is-active' : ''}`}
-              data-wp-class="is-active"
+              data-wp-class--is-active="state.isAnimating"
             >
               {animation}
             </div>

package/templates/interactivity/src/save.tsx.mustache

@@ -70,7 +70,7 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
         <div
           className={`{{cssClassName}}__animation ${attributes.animation}`}
           aria-hidden="true"
-          data-wp-class="is-active"
+          data-wp-class--is-active="state.isAnimating"
         />
 
         {attributes.maxClicks > 0 && (

package/templates/persistence/src/edit.tsx.mustache

@@ -66,7 +66,7 @@ export default function Edit( {
 		validateEditorUpdate
 	);
 	const alignmentValue = editorFields.getStringValue(
-		attributes as unknown as Record< string, unknown >,
+		attributes,
 		'alignment',
 		'left'
 	);
@@ -91,7 +91,7 @@ export default function Edit( {
 			</BlockControls>
 			<InspectorControls>
 				<InspectorFromManifest
-					attributes={ attributes as unknown as Record< string, unknown > }
+					attributes={ attributes }
 					fieldLookup={ editorFields }
 					onChange={ updateField }
 					paths={ [ 'alignment', 'isVisible', 'showCount', 'buttonLabel' ] }