@wp-typia/project-tools 0.24.4 → 0.24.6

package/dist/runtime/built-in-block-non-ts-persistence-templates.d.ts

@@ -1,23 +1 @@
-/**
- * SCSS template for persistence block editor and frontend styles.
- *
- * @remarks Consumed by `buildPersistenceArtifacts()` with
- * `{{cssClassName}}` and `{{frontendCssClassName}}` scaffold placeholders.
- */
-export declare const PERSISTENCE_STYLE_TEMPLATE = ".{{cssClassName}} {\n\tborder: 1px solid #dcdcde;\n\tborder-radius: 12px;\n\tpadding: 16px;\n\tbackground: #fff;\n\n\t&__meta {\n\t\tcolor: #50575e;\n\t\tfont-size: 13px;\n\t\tmargin: 8px 0 0;\n\t}\n}\n\n.{{frontendCssClassName}} {\n\tdisplay: grid;\n\tgap: 12px;\n\tborder: 1px solid #dcdcde;\n\tborder-radius: 12px;\n\tpadding: 16px;\n\tbackground: #f6f7f7;\n\n\t&__count {\n\t\tdisplay: inline-flex;\n\t\tmin-width: 3rem;\n\t\tjustify-content: center;\n\t\tfont-weight: 700;\n\t}\n\n\t&__notice,\n\t&__error {\n\t\tmargin: 0;\n\t\tfont-size: 13px;\n\t}\n\n\t&__notice {\n\t\tcolor: #50575e;\n\t}\n\n\t&__error {\n\t\tcolor: #b32d2e;\n\t}\n\n\tbutton {\n\t\twidth: fit-content;\n\t}\n}\n";
-/**
- * Main PHP `render.php` template for the persistence block.
- *
- * @remarks Consumed by `buildPersistenceArtifacts()` with scaffold
- * placeholders for block identity, namespace, text domain, storage mode,
- * persistence policy, and frontend CSS class names.
- */
-export declare const PERSISTENCE_RENDER_TEMPLATE = "<?php\n/**\n * Dynamic render entry for the {{title}} block.\n *\n * @package {{pascalCase}}\n */\n\nif ( ! defined( 'ABSPATH' ) ) {\n\texit;\n}\n\n$validator_path = __DIR__ . '/typia-validator.php';\nif ( ! file_exists( $validator_path ) ) {\n\treturn '';\n}\n\n$validator = require $validator_path;\nif ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {\n\treturn '';\n}\n\n$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );\n$validation   = $validator->validate( $normalized );\n$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';\n\nif ( empty( $validation['valid'] ) || '' === $resource_key ) {\n\treturn '';\n}\n\n$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';\n$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';\n$content            = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';\n$post_id            = is_object( $block ) && isset( $block->context['postId'] )\n\t? (int) $block->context['postId']\n\t: (int) get_queried_object_id();\n$storage_mode       = '{{dataStorageMode}}';\n$persistence_policy = '{{persistencePolicy}}';\n\n{{phpPrefix}}_record_rendered_block_instance(\n\t(int) $post_id,\n\t'{{namespace}}/{{slugKebabCase}}',\n\t$resource_key\n);\n\n$notice_message     = 'authenticated' === $persistence_policy\n\t? __( 'Sign in to persist this counter.', '{{textDomain}}' )\n\t: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );\n$context            = array(\n\t'bootstrapReady'       => false,\n\t'buttonLabel'          => $button_label,\n\t'canWrite'             => false,\n\t'client'               => array(\n\t\t'writeExpiry' => 0,\n\t\t'writeNonce'  => '',\n\t\t'writeToken'  => '',\n\t),\n\t'count'                => 0,\n\t'error'                => '',\n\t'isBootstrapping'      => false,\n\t'isLoading'            => false,\n\t'isSaving'             => false,\n\t'isVisible'            => ! empty( $normalized['isVisible'] ),\n\t'persistencePolicy'    => $persistence_policy,\n\t'postId'               => (int) $post_id,\n\t'resourceKey'          => $resource_key,\n\t'storage'              => $storage_mode,\n);\n\n$wrapper_attributes = get_block_wrapper_attributes(\n\tarray(\n\t\t'data-wp-context'       => wp_json_encode( $context ),\n\t\t'data-wp-interactive'   => '{{slugKebabCase}}',\n\t\t'data-wp-init'          => 'callbacks.init',\n\t\t'data-wp-run--mounted' => 'callbacks.mounted',\n\t)\n);\n?>\n\n<div <?php echo $wrapper_attributes; ?>>\n\t<div class=\"{{frontendCssClassName}}\">\n\t\t<p class=\"{{frontendCssClassName}}__content\" style=\"<?php echo esc_attr( 'text-align:' . $alignment ); ?>\">\n\t\t\t<?php echo esc_html( $content ); ?>\n\t\t</p>\n\t\t<p\n\t\t\tclass=\"{{frontendCssClassName}}__notice\"\n\t\t\tdata-wp-bind--hidden=\"!context.bootstrapReady || context.canWrite\"\n\t\t\thidden\n\t\t>\n\t\t\t<?php echo esc_html( $notice_message ); ?>\n\t\t</p>\n\t\t<p\n\t\t\tclass=\"{{frontendCssClassName}}__error\"\n\t\t\trole=\"status\"\n\t\t\taria-live=\"polite\"\n\t\t\taria-atomic=\"true\"\n\t\t\tdata-wp-bind--hidden=\"!context.error\"\n\t\t\tdata-wp-text=\"context.error\"\n\t\t\thidden\n\t\t></p>\n\t\t<?php if ( ! empty( $normalized['showCount'] ) ) : ?>\n\t\t\t<span\n\t\t\t\tclass=\"{{frontendCssClassName}}__count\"\n\t\t\t\trole=\"status\"\n\t\t\t\taria-live=\"polite\"\n\t\t\t\taria-atomic=\"true\"\n\t\t\t\tdata-wp-text=\"context.count\"\n\t\t\t>\n\t\t\t\t0\n\t\t\t</span>\n\t\t<?php endif; ?>\n\t\t<button\n\t\t\ttype=\"button\"\n\t\t\tdisabled\n\t\t\tdata-wp-bind--disabled=\"!context.canWrite\"\n\t\t\tdata-wp-on--click=\"actions.increment\"\n\t\t>\n\t\t\t<?php echo esc_html( $button_label ); ?>\n\t\t</button>\n\t</div>\n</div>\n";
-/**
- * PHP helper template for persistence alternate render targets.
- *
- * @remarks Consumed by `buildPersistenceArtifacts()` for email, MJML,
- * plain-text, and web render entries with block identity, namespace, text
- * domain, storage, policy, frontend class, and title placeholders.
- */
-export declare const PERSISTENCE_RENDER_TARGETS_TEMPLATE = "<?php\n/**\n * Alternate render target helpers for the {{title}} block.\n *\n * @package {{pascalCase}}\n */\n\nif ( ! defined( 'ABSPATH' ) ) {\n\texit;\n}\n\nif ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_build_render_context' ) ) {\n\tfunction {{phpPrefix}}_{{slugSnakeCase}}_build_render_context( $attributes, $content, $block ) {\n\t\t$validator_path = __DIR__ . '/typia-validator.php';\n\t\tif ( ! file_exists( $validator_path ) ) {\n\t\t\treturn null;\n\t\t}\n\n\t\t$validator = require $validator_path;\n\t\tif ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {\n\t\t\treturn null;\n\t\t}\n\n\t\t$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );\n\t\t$validation   = $validator->validate( $normalized );\n\t\t$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';\n\n\t\tif ( empty( $validation['valid'] ) || '' === $resource_key ) {\n\t\t\treturn null;\n\t\t}\n\n\t\t$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';\n\t\t$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';\n\t\t$rendered_content   = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';\n\t\t$post_id            = is_object( $block ) && isset( $block->context['postId'] )\n\t\t\t? (int) $block->context['postId']\n\t\t\t: (int) get_queried_object_id();\n\t\t$storage_mode       = '{{dataStorageMode}}';\n\t\t$persistence_policy = '{{persistencePolicy}}';\n\n\t\t{{phpPrefix}}_record_rendered_block_instance(\n\t\t\t(int) $post_id,\n\t\t\t'{{namespace}}/{{slugKebabCase}}',\n\t\t\t$resource_key\n\t\t);\n\n\t\t$notice_message = 'authenticated' === $persistence_policy\n\t\t\t? __( 'Sign in to persist this counter.', '{{textDomain}}' )\n\t\t\t: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );\n\t\t$web_context = array(\n\t\t\t'bootstrapReady'       => false,\n\t\t\t'buttonLabel'          => $button_label,\n\t\t\t'canWrite'             => false,\n\t\t\t'client'               => array(\n\t\t\t\t'writeExpiry' => 0,\n\t\t\t\t'writeNonce'  => '',\n\t\t\t\t'writeToken'  => '',\n\t\t\t),\n\t\t\t'count'                => 0,\n\t\t\t'error'                => '',\n\t\t\t'isBootstrapping'      => false,\n\t\t\t'isLoading'            => false,\n\t\t\t'isSaving'             => false,\n\t\t\t'isVisible'            => ! empty( $normalized['isVisible'] ),\n\t\t\t'persistencePolicy'    => $persistence_policy,\n\t\t\t'postId'               => (int) $post_id,\n\t\t\t'resourceKey'          => $resource_key,\n\t\t\t'storage'              => $storage_mode,\n\t\t);\n\n\t\treturn array(\n\t\t\t'alignment'         => $alignment,\n\t\t\t'buttonLabel'       => $button_label,\n\t\t\t'content'           => $rendered_content,\n\t\t\t'frontendClassName' => '{{frontendCssClassName}}',\n\t\t\t'isVisible'         => ! empty( $normalized['isVisible'] ),\n\t\t\t'normalized'        => $normalized,\n\t\t\t'noticeMessage'     => $notice_message,\n\t\t\t'postId'            => (int) $post_id,\n\t\t\t'resourceKey'       => $resource_key,\n\t\t\t'showCount'         => ! empty( $normalized['showCount'] ),\n\t\t\t'title'             => {{titleJson}},\n\t\t\t'webContext'        => $web_context,\n\t\t);\n\t}\n}\n\nif ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_render_target' ) ) {\n\tfunction {{phpPrefix}}_{{slugSnakeCase}}_render_target( string $target, $attributes, $content = '', $block = null ): string {\n\t\t$context = {{phpPrefix}}_{{slugSnakeCase}}_build_render_context( $attributes, $content, $block );\n\t\tif ( null === $context || empty( $context['isVisible'] ) ) {\n\t\t\treturn '';\n\t\t}\n\n\t\t$target_context = apply_filters(\n\t\t\t'{{phpPrefix}}_{{slugSnakeCase}}_render_target_context',\n\t\t\t$context,\n\t\t\t$target,\n\t\t\t$attributes,\n\t\t\t$block\n\t\t);\n\n\t\t$markup = '';\n\t\tswitch ( $target ) {\n\t\t\tcase 'email':\n\t\t\t\t$parts = array(\n\t\t\t\t\t'<div class=\"' . esc_attr( $target_context['frontendClassName'] ) . '-email\">',\n\t\t\t\t\t'<p style=\"text-align:' . esc_attr( $target_context['alignment'] ) . ';\">' . esc_html( $target_context['content'] ) . '</p>',\n\t\t\t\t);\n\t\t\t\tif ( ! empty( $target_context['showCount'] ) ) {\n\t\t\t\t\t$parts[] = '<p><strong>' . esc_html__( 'Count', '{{textDomain}}' ) . ':</strong> ' . esc_html( (string) $target_context['webContext']['count'] ) . '</p>';\n\t\t\t\t}\n\t\t\t\t$parts[] = '<p>' . esc_html( $target_context['noticeMessage'] ) . '</p>';\n\t\t\t\t$parts[] = '</div>';\n\t\t\t\t$markup = implode( '', $parts );\n\t\t\t\tbreak;\n\t\t\tcase 'mjml':\n\t\t\t\t$markup = '<mjml><mj-body><mj-section><mj-column><mj-text align=\"' . esc_attr( $target_context['alignment'] ) . '\">' . esc_html( $target_context['content'] ) . '</mj-text>';\n\t\t\t\tif ( ! empty( $target_context['showCount'] ) ) {\n\t\t\t\t\t$markup .= '<mj-text>' . esc_html__( 'Count', '{{textDomain}}' ) . ': ' . esc_html( (string) $target_context['webContext']['count'] ) . '</mj-text>';\n\t\t\t\t}\n\t\t\t\t$markup .= '<mj-text>' . esc_html( $target_context['noticeMessage'] ) . '</mj-text></mj-column></mj-section></mj-body></mjml>';\n\t\t\t\tbreak;\n\t\t\tcase 'plain-text':\n\t\t\t\t$markup = implode(\n\t\t\t\t\t\"\\n\",\n\t\t\t\t\tarray_filter(\n\t\t\t\t\t\tarray(\n\t\t\t\t\t\t\t$target_context['title'],\n\t\t\t\t\t\t\t$target_context['content'],\n\t\t\t\t\t\t\t! empty( $target_context['showCount'] )\n\t\t\t\t\t\t\t\t? sprintf( '%s: %s', __( 'Count', '{{textDomain}}' ), (string) $target_context['webContext']['count'] )\n\t\t\t\t\t\t\t\t: null,\n\t\t\t\t\t\t\t$target_context['noticeMessage'],\n\t\t\t\t\t\t),\n\t\t\t\t\t\tstatic fn( $value ) => is_string( $value ) && '' !== $value\n\t\t\t\t\t)\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase 'web':\n\t\t\tdefault:\n\t\t\t\t$wrapper_attributes = get_block_wrapper_attributes(\n\t\t\t\t\tarray(\n\t\t\t\t\t\t'data-wp-context'      => wp_json_encode( $target_context['webContext'] ),\n\t\t\t\t\t\t'data-wp-interactive'  => '{{slugKebabCase}}',\n\t\t\t\t\t\t'data-wp-init'         => 'callbacks.init',\n\t\t\t\t\t\t'data-wp-run--mounted' => 'callbacks.mounted',\n\t\t\t\t\t)\n\t\t\t\t);\n\t\t\t\tob_start();\n\t\t\t\t?>\n<div <?php echo $wrapper_attributes; ?>>\n\t<div class=\"{{frontendCssClassName}}\">\n\t\t<p class=\"{{frontendCssClassName}}__content\" style=\"<?php echo esc_attr( 'text-align:' . $target_context['alignment'] ); ?>\">\n\t\t\t<?php echo esc_html( $target_context['content'] ); ?>\n\t\t</p>\n\t\t<p\n\t\t\tclass=\"{{frontendCssClassName}}__notice\"\n\t\t\tdata-wp-bind--hidden=\"!context.bootstrapReady || context.canWrite\"\n\t\t\thidden\n\t\t>\n\t\t\t<?php echo esc_html( $target_context['noticeMessage'] ); ?>\n\t\t</p>\n\t\t<p\n\t\t\tclass=\"{{frontendCssClassName}}__error\"\n\t\t\trole=\"status\"\n\t\t\taria-live=\"polite\"\n\t\t\taria-atomic=\"true\"\n\t\t\tdata-wp-bind--hidden=\"!context.error\"\n\t\t\tdata-wp-text=\"context.error\"\n\t\t\thidden\n\t\t></p>\n\t\t<?php if ( ! empty( $target_context['showCount'] ) ) : ?>\n\t\t\t<span\n\t\t\t\tclass=\"{{frontendCssClassName}}__count\"\n\t\t\t\trole=\"status\"\n\t\t\t\taria-live=\"polite\"\n\t\t\t\taria-atomic=\"true\"\n\t\t\t\tdata-wp-text=\"context.count\"\n\t\t\t>\n\t\t\t\t0\n\t\t\t</span>\n\t\t<?php endif; ?>\n\t\t<button\n\t\t\ttype=\"button\"\n\t\t\tdisabled\n\t\t\tdata-wp-bind--disabled=\"!context.canWrite\"\n\t\t\tdata-wp-on--click=\"actions.increment\"\n\t\t>\n\t\t\t<?php echo esc_html( $target_context['buttonLabel'] ); ?>\n\t\t</button>\n\t</div>\n</div>\n\t\t\t\t<?php\n\t\t\t\t$markup = (string) ob_get_clean();\n\t\t\t\tbreak;\n\t\t}\n\n\t\treturn apply_filters(\n\t\t\t'{{phpPrefix}}_{{slugSnakeCase}}_render_target_markup',\n\t\t\t$markup,\n\t\t\t$target,\n\t\t\t$target_context\n\t\t);\n\t}\n}\n";
+export * from "./templates/built-in-block-non-ts-persistence-templates.js";

package/dist/runtime/built-in-block-non-ts-persistence-templates.js

@@ -1,395 +1 @@
-/**
- * SCSS template for persistence block editor and frontend styles.
- *
- * @remarks Consumed by `buildPersistenceArtifacts()` with
- * `{{cssClassName}}` and `{{frontendCssClassName}}` scaffold placeholders.
- */
-export const PERSISTENCE_STYLE_TEMPLATE = `.{{cssClassName}} {
-	border: 1px solid #dcdcde;
-	border-radius: 12px;
-	padding: 16px;
-	background: #fff;
-
-	&__meta {
-		color: #50575e;
-		font-size: 13px;
-		margin: 8px 0 0;
-	}
-}
-
-.{{frontendCssClassName}} {
-	display: grid;
-	gap: 12px;
-	border: 1px solid #dcdcde;
-	border-radius: 12px;
-	padding: 16px;
-	background: #f6f7f7;
-
-	&__count {
-		display: inline-flex;
-		min-width: 3rem;
-		justify-content: center;
-		font-weight: 700;
-	}
-
-	&__notice,
-	&__error {
-		margin: 0;
-		font-size: 13px;
-	}
-
-	&__notice {
-		color: #50575e;
-	}
-
-	&__error {
-		color: #b32d2e;
-	}
-
-	button {
-		width: fit-content;
-	}
-}
-`;
-/**
- * Main PHP `render.php` template for the persistence block.
- *
- * @remarks Consumed by `buildPersistenceArtifacts()` with scaffold
- * placeholders for block identity, namespace, text domain, storage mode,
- * persistence policy, and frontend CSS class names.
- */
-export const PERSISTENCE_RENDER_TEMPLATE = `<?php
-/**
- * Dynamic render entry for the {{title}} block.
- *
- * @package {{pascalCase}}
- */
-
-if ( ! defined( 'ABSPATH' ) ) {
-	exit;
-}
-
-$validator_path = __DIR__ . '/typia-validator.php';
-if ( ! file_exists( $validator_path ) ) {
-	return '';
-}
-
-$validator = require $validator_path;
-if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {
-	return '';
-}
-
-$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
-$validation   = $validator->validate( $normalized );
-$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
-
-if ( empty( $validation['valid'] ) || '' === $resource_key ) {
-	return '';
-}
-
-$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';
-$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
-$content            = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';
-$post_id            = is_object( $block ) && isset( $block->context['postId'] )
-	? (int) $block->context['postId']
-	: (int) get_queried_object_id();
-$storage_mode       = '{{dataStorageMode}}';
-$persistence_policy = '{{persistencePolicy}}';
-
-{{phpPrefix}}_record_rendered_block_instance(
-	(int) $post_id,
-	'{{namespace}}/{{slugKebabCase}}',
-	$resource_key
-);
-
-$notice_message     = 'authenticated' === $persistence_policy
-	? __( 'Sign in to persist this counter.', '{{textDomain}}' )
-	: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
-$context            = array(
-	'bootstrapReady'       => false,
-	'buttonLabel'          => $button_label,
-	'canWrite'             => false,
-	'client'               => array(
-		'writeExpiry' => 0,
-		'writeNonce'  => '',
-		'writeToken'  => '',
-	),
-	'count'                => 0,
-	'error'                => '',
-	'isBootstrapping'      => false,
-	'isLoading'            => false,
-	'isSaving'             => false,
-	'isVisible'            => ! empty( $normalized['isVisible'] ),
-	'persistencePolicy'    => $persistence_policy,
-	'postId'               => (int) $post_id,
-	'resourceKey'          => $resource_key,
-	'storage'              => $storage_mode,
-);
-
-$wrapper_attributes = get_block_wrapper_attributes(
-	array(
-		'data-wp-context'       => wp_json_encode( $context ),
-		'data-wp-interactive'   => '{{slugKebabCase}}',
-		'data-wp-init'          => 'callbacks.init',
-		'data-wp-run--mounted' => 'callbacks.mounted',
-	)
-);
-?>
-
-<div <?php echo $wrapper_attributes; ?>>
-	<div class="{{frontendCssClassName}}">
-		<p class="{{frontendCssClassName}}__content" style="<?php echo esc_attr( 'text-align:' . $alignment ); ?>">
-			<?php echo esc_html( $content ); ?>
-		</p>
-		<p
-			class="{{frontendCssClassName}}__notice"
-			data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
-			hidden
-		>
-			<?php echo esc_html( $notice_message ); ?>
-		</p>
-		<p
-			class="{{frontendCssClassName}}__error"
-			role="status"
-			aria-live="polite"
-			aria-atomic="true"
-			data-wp-bind--hidden="!context.error"
-			data-wp-text="context.error"
-			hidden
-		></p>
-		<?php if ( ! empty( $normalized['showCount'] ) ) : ?>
-			<span
-				class="{{frontendCssClassName}}__count"
-				role="status"
-				aria-live="polite"
-				aria-atomic="true"
-				data-wp-text="context.count"
-			>
-				0
-			</span>
-		<?php endif; ?>
-		<button
-			type="button"
-			disabled
-			data-wp-bind--disabled="!context.canWrite"
-			data-wp-on--click="actions.increment"
-		>
-			<?php echo esc_html( $button_label ); ?>
-		</button>
-	</div>
-</div>
-`;
-/**
- * PHP helper template for persistence alternate render targets.
- *
- * @remarks Consumed by `buildPersistenceArtifacts()` for email, MJML,
- * plain-text, and web render entries with block identity, namespace, text
- * domain, storage, policy, frontend class, and title placeholders.
- */
-export const PERSISTENCE_RENDER_TARGETS_TEMPLATE = `<?php
-/**
- * Alternate render target helpers for the {{title}} block.
- *
- * @package {{pascalCase}}
- */
-
-if ( ! defined( 'ABSPATH' ) ) {
-	exit;
-}
-
-if ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_build_render_context' ) ) {
-	function {{phpPrefix}}_{{slugSnakeCase}}_build_render_context( $attributes, $content, $block ) {
-		$validator_path = __DIR__ . '/typia-validator.php';
-		if ( ! file_exists( $validator_path ) ) {
-			return null;
-		}
-
-		$validator = require $validator_path;
-		if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults' ) || ! method_exists( $validator, 'validate' ) ) {
-			return null;
-		}
-
-		$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
-		$validation   = $validator->validate( $normalized );
-		$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
-
-		if ( empty( $validation['valid'] ) || '' === $resource_key ) {
-			return null;
-		}
-
-		$alignment          = isset( $normalized['alignment'] ) ? (string) $normalized['alignment'] : 'left';
-		$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
-		$rendered_content   = isset( $normalized['content'] ) ? (string) $normalized['content'] : '';
-		$post_id            = is_object( $block ) && isset( $block->context['postId'] )
-			? (int) $block->context['postId']
-			: (int) get_queried_object_id();
-		$storage_mode       = '{{dataStorageMode}}';
-		$persistence_policy = '{{persistencePolicy}}';
-
-		{{phpPrefix}}_record_rendered_block_instance(
-			(int) $post_id,
-			'{{namespace}}/{{slugKebabCase}}',
-			$resource_key
-		);
-
-		$notice_message = 'authenticated' === $persistence_policy
-			? __( 'Sign in to persist this counter.', '{{textDomain}}' )
-			: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );
-		$web_context = array(
-			'bootstrapReady'       => false,
-			'buttonLabel'          => $button_label,
-			'canWrite'             => false,
-			'client'               => array(
-				'writeExpiry' => 0,
-				'writeNonce'  => '',
-				'writeToken'  => '',
-			),
-			'count'                => 0,
-			'error'                => '',
-			'isBootstrapping'      => false,
-			'isLoading'            => false,
-			'isSaving'             => false,
-			'isVisible'            => ! empty( $normalized['isVisible'] ),
-			'persistencePolicy'    => $persistence_policy,
-			'postId'               => (int) $post_id,
-			'resourceKey'          => $resource_key,
-			'storage'              => $storage_mode,
-		);
-
-		return array(
-			'alignment'         => $alignment,
-			'buttonLabel'       => $button_label,
-			'content'           => $rendered_content,
-			'frontendClassName' => '{{frontendCssClassName}}',
-			'isVisible'         => ! empty( $normalized['isVisible'] ),
-			'normalized'        => $normalized,
-			'noticeMessage'     => $notice_message,
-			'postId'            => (int) $post_id,
-			'resourceKey'       => $resource_key,
-			'showCount'         => ! empty( $normalized['showCount'] ),
-			'title'             => {{titleJson}},
-			'webContext'        => $web_context,
-		);
-	}
-}
-
-if ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_render_target' ) ) {
-	function {{phpPrefix}}_{{slugSnakeCase}}_render_target( string $target, $attributes, $content = '', $block = null ): string {
-		$context = {{phpPrefix}}_{{slugSnakeCase}}_build_render_context( $attributes, $content, $block );
-		if ( null === $context || empty( $context['isVisible'] ) ) {
-			return '';
-		}
-
-		$target_context = apply_filters(
-			'{{phpPrefix}}_{{slugSnakeCase}}_render_target_context',
-			$context,
-			$target,
-			$attributes,
-			$block
-		);
-
-		$markup = '';
-		switch ( $target ) {
-			case 'email':
-				$parts = array(
-					'<div class="' . esc_attr( $target_context['frontendClassName'] ) . '-email">',
-					'<p style="text-align:' . esc_attr( $target_context['alignment'] ) . ';">' . esc_html( $target_context['content'] ) . '</p>',
-				);
-				if ( ! empty( $target_context['showCount'] ) ) {
-					$parts[] = '<p><strong>' . esc_html__( 'Count', '{{textDomain}}' ) . ':</strong> ' . esc_html( (string) $target_context['webContext']['count'] ) . '</p>';
-				}
-				$parts[] = '<p>' . esc_html( $target_context['noticeMessage'] ) . '</p>';
-				$parts[] = '</div>';
-				$markup = implode( '', $parts );
-				break;
-			case 'mjml':
-				$markup = '<mjml><mj-body><mj-section><mj-column><mj-text align="' . esc_attr( $target_context['alignment'] ) . '">' . esc_html( $target_context['content'] ) . '</mj-text>';
-				if ( ! empty( $target_context['showCount'] ) ) {
-					$markup .= '<mj-text>' . esc_html__( 'Count', '{{textDomain}}' ) . ': ' . esc_html( (string) $target_context['webContext']['count'] ) . '</mj-text>';
-				}
-				$markup .= '<mj-text>' . esc_html( $target_context['noticeMessage'] ) . '</mj-text></mj-column></mj-section></mj-body></mjml>';
-				break;
-			case 'plain-text':
-				$markup = implode(
-					"\\n",
-					array_filter(
-						array(
-							$target_context['title'],
-							$target_context['content'],
-							! empty( $target_context['showCount'] )
-								? sprintf( '%s: %s', __( 'Count', '{{textDomain}}' ), (string) $target_context['webContext']['count'] )
-								: null,
-							$target_context['noticeMessage'],
-						),
-						static fn( $value ) => is_string( $value ) && '' !== $value
-					)
-				);
-				break;
-			case 'web':
-			default:
-				$wrapper_attributes = get_block_wrapper_attributes(
-					array(
-						'data-wp-context'      => wp_json_encode( $target_context['webContext'] ),
-						'data-wp-interactive'  => '{{slugKebabCase}}',
-						'data-wp-init'         => 'callbacks.init',
-						'data-wp-run--mounted' => 'callbacks.mounted',
-					)
-				);
-				ob_start();
-				?>
-<div <?php echo $wrapper_attributes; ?>>
-	<div class="{{frontendCssClassName}}">
-		<p class="{{frontendCssClassName}}__content" style="<?php echo esc_attr( 'text-align:' . $target_context['alignment'] ); ?>">
-			<?php echo esc_html( $target_context['content'] ); ?>
-		</p>
-		<p
-			class="{{frontendCssClassName}}__notice"
-			data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
-			hidden
-		>
-			<?php echo esc_html( $target_context['noticeMessage'] ); ?>
-		</p>
-		<p
-			class="{{frontendCssClassName}}__error"
-			role="status"
-			aria-live="polite"
-			aria-atomic="true"
-			data-wp-bind--hidden="!context.error"
-			data-wp-text="context.error"
-			hidden
-		></p>
-		<?php if ( ! empty( $target_context['showCount'] ) ) : ?>
-			<span
-				class="{{frontendCssClassName}}__count"
-				role="status"
-				aria-live="polite"
-				aria-atomic="true"
-				data-wp-text="context.count"
-			>
-				0
-			</span>
-		<?php endif; ?>
-		<button
-			type="button"
-			disabled
-			data-wp-bind--disabled="!context.canWrite"
-			data-wp-on--click="actions.increment"
-		>
-			<?php echo esc_html( $target_context['buttonLabel'] ); ?>
-		</button>
-	</div>
-</div>
-				<?php
-				$markup = (string) ob_get_clean();
-				break;
-		}
-
-		return apply_filters(
-			'{{phpPrefix}}_{{slugSnakeCase}}_render_target_markup',
-			$markup,
-			$target,
-			$target_context
-		);
-	}
-}
-`;
+export * from "./templates/built-in-block-non-ts-persistence-templates.js";

package/dist/runtime/built-in-block-non-ts-render-utils.d.ts

@@ -1,27 +1 @@
-import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
-import type { ScaffoldTemplateVariables } from "./scaffold.js";
-/**
- * Renders a non-TypeScript artifact and normalizes the output to a trailing newline.
- *
- * @param relativePath Relative output path for the generated artifact.
- * @param template Mustache template source to render.
- * @param view Template view data passed to the Mustache renderer.
- * @returns A built-in code artifact with normalized source text.
- */
-export declare function renderArtifact(relativePath: string, template: string, view: Record<string, unknown>): BuiltInCodeArtifact;
-/**
- * Builds a PHP entrypoint for a specific alternate render target.
- *
- * @param relativePath Relative output path for the generated PHP file.
- * @param target Alternate render target identifier to dispatch.
- * @param variables Scaffold template variables used to render the entrypoint.
- * @returns A built-in code artifact for the requested alternate render target.
- */
-export declare function buildAlternateRenderEntryArtifact(relativePath: string, target: "email" | "mjml" | "plain-text" | "web", variables: ScaffoldTemplateVariables): BuiltInCodeArtifact;
-/**
- * Escapes a string for safe embedding in a PHP single-quoted literal.
- *
- * @param value Source string to escape.
- * @returns A PHP single-quoted string literal.
- */
-export declare function toPhpSingleQuotedString(value: string): string;
+export * from "./templates/built-in-block-non-ts-render-utils.js";

package/dist/runtime/built-in-block-non-ts-render-utils.js

@@ -1,53 +1 @@
-import { assertScaffoldTemplateCodeIdentifiers } from "./scaffold-template-assertions.js";
-import { renderMustacheTemplateString } from "./template-render.js";
-/**
- * Renders a non-TypeScript artifact and normalizes the output to a trailing newline.
- *
- * @param relativePath Relative output path for the generated artifact.
- * @param template Mustache template source to render.
- * @param view Template view data passed to the Mustache renderer.
- * @returns A built-in code artifact with normalized source text.
- */
-export function renderArtifact(relativePath, template, view) {
-    assertScaffoldTemplateCodeIdentifiers(view);
-    const source = renderMustacheTemplateString(template, view);
-    return {
-        relativePath,
-        source: source.endsWith("\n") ? source : `${source}\n`,
-    };
-}
-/**
- * Builds a PHP entrypoint for a specific alternate render target.
- *
- * @param relativePath Relative output path for the generated PHP file.
- * @param target Alternate render target identifier to dispatch.
- * @param variables Scaffold template variables used to render the entrypoint.
- * @returns A built-in code artifact for the requested alternate render target.
- */
-export function buildAlternateRenderEntryArtifact(relativePath, target, variables) {
-    const template = `<?php
-/**
- * Alternate ${target} render entry for {{title}}.
- *
- * @package {{pascalCase}}
- */
-
-if ( ! defined( 'ABSPATH' ) ) {
-\texit;
-}
-
-require_once __DIR__ . '/render-targets.php';
-
-return {{phpPrefix}}_{{slugSnakeCase}}_render_target( '${target}', $attributes, $content ?? '', $block ?? null );
-`;
-    return renderArtifact(relativePath, template, variables);
-}
-/**
- * Escapes a string for safe embedding in a PHP single-quoted literal.
- *
- * @param value Source string to escape.
- * @returns A PHP single-quoted string literal.
- */
-export function toPhpSingleQuotedString(value) {
-    return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
-}
+export * from "./templates/built-in-block-non-ts-render-utils.js";

package/dist/runtime/cli/cli-core.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Public runtime helper barrel consumed by the canonical `wp-typia` package.
+ *
+ * These exports do not make `@wp-typia/project-tools` the CLI owner again. Command
+ * taxonomy, help text ownership, and published bin responsibility stay in
+ * `packages/wp-typia`.
+ *
+ * Import `formatAddHelpText`, `runAddBlockCommand`,
+ * `runAddVariationCommand`, `runAddPatternCommand`,
+ * `runAddBindingSourceCommand`, `runAddHookedBlockCommand`,
+ * `runAddAdminViewCommand` for DataViews-backed admin screen scaffolds,
+ * `runAddAbilityCommand` for typed workflow ability scaffolds,
+ * and `HOOKED_BLOCK_POSITION_IDS`,
+ * `getWorkspaceBlockSelectOptions`, `getWorkspaceBlockSelectOptionsAsync`, and
+ * `seedWorkspaceMigrationProject` for
+ * explicit `wp-typia add` flows,
+ * `runAddAiFeatureCommand` for server-owned WordPress AI feature scaffolds,
+ * `runAddContractCommand` for standalone TypeScript schema artifacts,
+ * `runAddRestResourceCommand` for plugin-level REST resource scaffolds,
+ * `getDoctorChecks`, `runDoctor`, and `DoctorCheck` for diagnostics,
+ * `createCliCommandError`, `createCliDiagnosticCodeError`,
+ * `CLI_DIAGNOSTIC_CODES`, `CLI_DIAGNOSTIC_CODE_METADATA`,
+ * `getCliDiagnosticCodeMetadata`, and `formatCliDiagnosticError` for shared
+ * non-interactive failure rendering and explicit diagnostic-code ownership,
+ * `formatHelpText` for top-level CLI usage output, scaffold helpers such as
+ * `createReadlinePrompt`, `getNextSteps`, `getOptionalOnboarding`,
+ * `runScaffoldFlow`, and `ReadlinePrompt` for interactive project creation,
+ * and template helpers such as `formatTemplateDetails`,
+ * `formatTemplateFeatures`, `formatTemplateSummary`, `getTemplateById`,
+ * `getTemplateSelectOptions`, `listTemplates`, and `isBuiltInTemplateId` for
+ * template inspection flows.
+ */
+export { createDoctorRunSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, runDoctor, type DoctorCheck, type DoctorCheckScope, type DoctorExitPolicy, type DoctorFailureSummary, type DoctorRunSummary, } from "../doctor/cli-doctor.js";
+export { createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODE_METADATA, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatDoctorCheckLine, formatDoctorSummaryLine, getCliDiagnosticCodeMetadata, getDoctorFailureDetailLines, getFailingDoctorChecks, isCliDiagnosticError, } from "./cli-diagnostics.js";
+export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, } from "./cli-diagnostics.js";
+export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, PATTERN_CATALOG_SCOPE_IDS, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "../add/cli-add.js";
+export type { PatternCatalogScope } from "../add/cli-add.js";
+export { COMPOUND_INNER_BLOCKS_PRESET_IDS, getCompoundInnerBlocksPresetDefinition, } from "../add/compound-inner-blocks.js";
+export type { CompoundInnerBlocksPresetId } from "../add/compound-inner-blocks.js";
+export { HOOKED_BLOCK_POSITION_IDS } from "../add/hooked-blocks.js";
+export type { EditorPluginSlotId } from "../add/cli-add.js";
+export type { WorkspaceBlockSelectOption } from "../workspace/workspace-inventory.js";
+export type { HookedBlockPositionId } from "../add/hooked-blocks.js";
+export { formatHelpText } from "./cli-help.js";
+export { getNextSteps, getOptionalOnboarding, runScaffoldFlow, } from "../templates/cli-scaffold.js";
+export { createReadlinePrompt, type ReadlinePrompt } from "./cli-prompt.js";
+export { formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getTemplateById, getTemplateSelectOptions, isBuiltInTemplateId, listTemplates, } from "../templates/cli-templates.js";

package/dist/runtime/cli/cli-core.js

@@ -0,0 +1,41 @@
+/**
+ * Public runtime helper barrel consumed by the canonical `wp-typia` package.
+ *
+ * These exports do not make `@wp-typia/project-tools` the CLI owner again. Command
+ * taxonomy, help text ownership, and published bin responsibility stay in
+ * `packages/wp-typia`.
+ *
+ * Import `formatAddHelpText`, `runAddBlockCommand`,
+ * `runAddVariationCommand`, `runAddPatternCommand`,
+ * `runAddBindingSourceCommand`, `runAddHookedBlockCommand`,
+ * `runAddAdminViewCommand` for DataViews-backed admin screen scaffolds,
+ * `runAddAbilityCommand` for typed workflow ability scaffolds,
+ * and `HOOKED_BLOCK_POSITION_IDS`,
+ * `getWorkspaceBlockSelectOptions`, `getWorkspaceBlockSelectOptionsAsync`, and
+ * `seedWorkspaceMigrationProject` for
+ * explicit `wp-typia add` flows,
+ * `runAddAiFeatureCommand` for server-owned WordPress AI feature scaffolds,
+ * `runAddContractCommand` for standalone TypeScript schema artifacts,
+ * `runAddRestResourceCommand` for plugin-level REST resource scaffolds,
+ * `getDoctorChecks`, `runDoctor`, and `DoctorCheck` for diagnostics,
+ * `createCliCommandError`, `createCliDiagnosticCodeError`,
+ * `CLI_DIAGNOSTIC_CODES`, `CLI_DIAGNOSTIC_CODE_METADATA`,
+ * `getCliDiagnosticCodeMetadata`, and `formatCliDiagnosticError` for shared
+ * non-interactive failure rendering and explicit diagnostic-code ownership,
+ * `formatHelpText` for top-level CLI usage output, scaffold helpers such as
+ * `createReadlinePrompt`, `getNextSteps`, `getOptionalOnboarding`,
+ * `runScaffoldFlow`, and `ReadlinePrompt` for interactive project creation,
+ * and template helpers such as `formatTemplateDetails`,
+ * `formatTemplateFeatures`, `formatTemplateSummary`, `getTemplateById`,
+ * `getTemplateSelectOptions`, `listTemplates`, and `isBuiltInTemplateId` for
+ * template inspection flows.
+ */
+export { createDoctorRunSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, runDoctor, } from "../doctor/cli-doctor.js";
+export { createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODE_METADATA, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatDoctorCheckLine, formatDoctorSummaryLine, getCliDiagnosticCodeMetadata, getDoctorFailureDetailLines, getFailingDoctorChecks, isCliDiagnosticError, } from "./cli-diagnostics.js";
+export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, PATTERN_CATALOG_SCOPE_IDS, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "../add/cli-add.js";
+export { COMPOUND_INNER_BLOCKS_PRESET_IDS, getCompoundInnerBlocksPresetDefinition, } from "../add/compound-inner-blocks.js";
+export { HOOKED_BLOCK_POSITION_IDS } from "../add/hooked-blocks.js";
+export { formatHelpText } from "./cli-help.js";
+export { getNextSteps, getOptionalOnboarding, runScaffoldFlow, } from "../templates/cli-scaffold.js";
+export { createReadlinePrompt } from "./cli-prompt.js";
+export { formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getTemplateById, getTemplateSelectOptions, isBuiltInTemplateId, listTemplates, } from "../templates/cli-templates.js";