npm - @wp-typia/project-tools - Versions diffs - 0.24.11 → 0.24.13 - Mend

@wp-typia/project-tools 0.24.11 → 0.24.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (72) hide show

package/dist/runtime/templates/built-in-block-non-ts-compound-templates.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@
  * plain-text, and web render entries with block identity, namespace, text
  * domain, storage, policy, CSS class, and title placeholders.
  */
-export declare const COMPOUND_PERSISTENCE_RENDER_TARGETS_TEMPLATE = "<?php\n/**\n * Alternate render target helpers for the {{title}} compound parent 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\t\t$heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};\n\t\t$intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';\n\t\t$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';\n\t\t$show_count         = ! empty( $normalized['showCount'] );\n\t\t$show_dividers      = ! empty( $normalized['showDividers'] );\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$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\n\t\tif ( empty( $validation['valid'] ) || '' === $resource_key ) {\n\t\t\treturn null;\n\t\t}\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$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'persistencePolicy'    => $persistence_policy,\n\t\t\t'postId'               => (int) $post_id,\n\t\t\t'resourceKey'          => $resource_key,\n\t\t\t'showCount'            => $show_count,\n\t\t\t'storage'              => $storage_mode,\n\t\t);\n\n\t\t$allowed_inner_html = wp_kses_allowed_html( 'post' );\n\n\t\tforeach ( $allowed_inner_html as &$allowed_attributes ) {\n\t\t\tif ( ! is_array( $allowed_attributes ) ) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t$allowed_attributes['data-wp-bind--disabled'] = true;\n\t\t\t$allowed_attributes['data-wp-bind--hidden'] = true;\n\t\t\t$allowed_attributes['data-wp-bind--value'] = true;\n\t\t\t$allowed_attributes['data-wp-class'] = true;\n\t\t\t$allowed_attributes['data-wp-class--active'] = true;\n\t\t\t$allowed_attributes['data-wp-context'] = true;\n\t\t\t$allowed_attributes['data-wp-init'] = true;\n\t\t\t$allowed_attributes['data-wp-interactive'] = true;\n\t\t\t$allowed_attributes['data-wp-on--click'] = true;\n\t\t\t$allowed_attributes['data-wp-on--mouseenter'] = true;\n\t\t\t$allowed_attributes['data-wp-on--mouseleave'] = true;\n\t\t\t$allowed_attributes['data-wp-run--mounted'] = true;\n\t\t\t$allowed_attributes['data-wp-style--width'] = true;\n\t\t\t$allowed_attributes['data-wp-text'] = true;\n\t\t}\n\t\tunset( $allowed_attributes );\n\n\t\treturn array(\n\t\t\t'buttonLabel'       => $button_label,\n\t\t\t'frontendClassName' => '{{cssClassName}}',\n\t\t\t'heading'           => $heading,\n\t\t\t'intro'             => $intro,\n\t\t\t'isVisible'         => true,\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'sanitizedContent'  => wp_kses( $content, $allowed_inner_html ),\n\t\t\t'showCount'         => $show_count,\n\t\t\t'showDividers'      => $show_dividers,\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 ) {\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'<h3>' . esc_html( $target_context['heading'] ) . '</h3>',\n\t\t\t\t);\n\t\t\t\tif ( '' !== $target_context['intro'] ) {\n\t\t\t\t\t$parts[] = '<p>' . esc_html( $target_context['intro'] ) . '</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[] = wp_kses_post( $target_context['sanitizedContent'] );\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 font-weight=\"700\">' . esc_html( $target_context['heading'] ) . '</mj-text>';\n\t\t\t\tif ( '' !== $target_context['intro'] ) {\n\t\t\t\t\t$markup .= '<mj-text>' . esc_html( $target_context['intro'] ) . '</mj-text>';\n\t\t\t\t}\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( wp_strip_all_tags( $target_context['sanitizedContent'] ) ) . '</mj-text>';\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['heading'],\n\t\t\t\t\t\t\t$target_context['intro'],\n\t\t\t\t\t\t\twp_strip_all_tags( $target_context['sanitizedContent'] ),\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'class'                => '{{cssClassName}}',\n\t\t\t\t\t\t'data-show-dividers'   => $target_context['showDividers'] ? 'true' : 'false',\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-init'         => 'callbacks.init',\n\t\t\t\t\t\t'data-wp-interactive'  => '{{slugKebabCase}}',\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<h3 class=\"{{cssClassName}}__heading\"><?php echo esc_html( $target_context['heading'] ); ?></h3>\n\t<?php if ( '' !== $target_context['intro'] ) : ?>\n\t\t<p class=\"{{cssClassName}}__intro\"><?php echo esc_html( $target_context['intro'] ); ?></p>\n\t<?php endif; ?>\n\t<p\n\t\tclass=\"{{cssClassName}}__notice\"\n\t\tdata-wp-bind--hidden=\"!context.bootstrapReady || context.canWrite\"\n\t\thidden\n\t>\n\t\t<?php echo esc_html( $target_context['noticeMessage'] ); ?>\n\t</p>\n\t<p\n\t\tclass=\"{{cssClassName}}__error\"\n\t\trole=\"status\"\n\t\taria-live=\"polite\"\n\t\taria-atomic=\"true\"\n\t\tdata-wp-bind--hidden=\"!context.error\"\n\t\tdata-wp-text=\"context.error\"\n\t\thidden\n\t></p>\n\t<?php if ( ! empty( $target_context['showCount'] ) ) : ?>\n\t\t<div class=\"{{cssClassName}}__counter\">\n\t\t\t<span\n\t\t\t\tclass=\"{{cssClassName}}__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>0</span>\n\t\t\t<button\n\t\t\t\ttype=\"button\"\n\t\t\t\tdisabled\n\t\t\t\tdata-wp-bind--disabled=\"!context.canWrite\"\n\t\t\t\tdata-wp-on--click=\"actions.increment\"\n\t\t\t>\n\t\t\t\t<?php echo esc_html( $target_context['buttonLabel'] ); ?>\n\t\t\t</button>\n\t\t</div>\n\t<?php endif; ?>\n\t<div class=\"{{cssClassName}}__items\">\n\t\t<?php echo wp_kses_post( $target_context['sanitizedContent'] ); ?>\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 declare const COMPOUND_PERSISTENCE_RENDER_TARGETS_TEMPLATE = "<?php\n/**\n * Alternate render target helpers for the {{title}} compound parent 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// Preserve the former implicit default only for legacy blocks that omit the key.\n\t\t// Explicitly stored empty keys remain invalid.\n\t\t$resource_key       = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';\n\t\t$heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};\n\t\t$intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';\n\t\t$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';\n\t\t$show_count         = ! empty( $normalized['showCount'] );\n\t\t$show_dividers      = ! empty( $normalized['showDividers'] );\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$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\n\t\tif ( empty( $validation['valid'] ) || '' === $resource_key ) {\n\t\t\treturn null;\n\t\t}\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$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'persistencePolicy'    => $persistence_policy,\n\t\t\t'postId'               => (int) $post_id,\n\t\t\t'resourceKey'          => $resource_key,\n\t\t\t'showCount'            => $show_count,\n\t\t\t'storage'              => $storage_mode,\n\t\t);\n\n\t\t$allowed_inner_html = wp_kses_allowed_html( 'post' );\n\n\t\tforeach ( $allowed_inner_html as &$allowed_attributes ) {\n\t\t\tif ( ! is_array( $allowed_attributes ) ) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t$allowed_attributes['data-wp-bind--disabled'] = true;\n\t\t\t$allowed_attributes['data-wp-bind--hidden'] = true;\n\t\t\t$allowed_attributes['data-wp-bind--value'] = true;\n\t\t\t$allowed_attributes['data-wp-class'] = true;\n\t\t\t$allowed_attributes['data-wp-class--active'] = true;\n\t\t\t$allowed_attributes['data-wp-context'] = true;\n\t\t\t$allowed_attributes['data-wp-init'] = true;\n\t\t\t$allowed_attributes['data-wp-interactive'] = true;\n\t\t\t$allowed_attributes['data-wp-on--click'] = true;\n\t\t\t$allowed_attributes['data-wp-on--mouseenter'] = true;\n\t\t\t$allowed_attributes['data-wp-on--mouseleave'] = true;\n\t\t\t$allowed_attributes['data-wp-run--mounted'] = true;\n\t\t\t$allowed_attributes['data-wp-style--width'] = true;\n\t\t\t$allowed_attributes['data-wp-text'] = true;\n\t\t}\n\t\tunset( $allowed_attributes );\n\n\t\treturn array(\n\t\t\t'buttonLabel'       => $button_label,\n\t\t\t'frontendClassName' => '{{cssClassName}}',\n\t\t\t'heading'           => $heading,\n\t\t\t'intro'             => $intro,\n\t\t\t'isVisible'         => true,\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'sanitizedContent'  => wp_kses( $content, $allowed_inner_html ),\n\t\t\t'showCount'         => $show_count,\n\t\t\t'showDividers'      => $show_dividers,\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 ) {\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'<h3>' . esc_html( $target_context['heading'] ) . '</h3>',\n\t\t\t\t);\n\t\t\t\tif ( '' !== $target_context['intro'] ) {\n\t\t\t\t\t$parts[] = '<p>' . esc_html( $target_context['intro'] ) . '</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[] = wp_kses_post( $target_context['sanitizedContent'] );\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 font-weight=\"700\">' . esc_html( $target_context['heading'] ) . '</mj-text>';\n\t\t\t\tif ( '' !== $target_context['intro'] ) {\n\t\t\t\t\t$markup .= '<mj-text>' . esc_html( $target_context['intro'] ) . '</mj-text>';\n\t\t\t\t}\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( wp_strip_all_tags( $target_context['sanitizedContent'] ) ) . '</mj-text>';\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['heading'],\n\t\t\t\t\t\t\t$target_context['intro'],\n\t\t\t\t\t\t\twp_strip_all_tags( $target_context['sanitizedContent'] ),\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'class'                => '{{cssClassName}}',\n\t\t\t\t\t\t'data-show-dividers'   => $target_context['showDividers'] ? 'true' : 'false',\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-init'         => 'callbacks.init',\n\t\t\t\t\t\t'data-wp-interactive'  => '{{slugKebabCase}}',\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<h3 class=\"{{cssClassName}}__heading\"><?php echo esc_html( $target_context['heading'] ); ?></h3>\n\t<?php if ( '' !== $target_context['intro'] ) : ?>\n\t\t<p class=\"{{cssClassName}}__intro\"><?php echo esc_html( $target_context['intro'] ); ?></p>\n\t<?php endif; ?>\n\t<p\n\t\tclass=\"{{cssClassName}}__notice\"\n\t\tdata-wp-bind--hidden=\"!context.bootstrapReady || context.canWrite\"\n\t\thidden\n\t>\n\t\t<?php echo esc_html( $target_context['noticeMessage'] ); ?>\n\t</p>\n\t<p\n\t\tclass=\"{{cssClassName}}__error\"\n\t\trole=\"status\"\n\t\taria-live=\"polite\"\n\t\taria-atomic=\"true\"\n\t\tdata-wp-bind--hidden=\"!context.error\"\n\t\tdata-wp-text=\"context.error\"\n\t\thidden\n\t></p>\n\t<?php if ( ! empty( $target_context['showCount'] ) ) : ?>\n\t\t<div class=\"{{cssClassName}}__counter\">\n\t\t\t<span\n\t\t\t\tclass=\"{{cssClassName}}__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>0</span>\n\t\t\t<button\n\t\t\t\ttype=\"button\"\n\t\t\t\tdisabled\n\t\t\t\tdata-wp-bind--disabled=\"!context.canWrite\"\n\t\t\t\tdata-wp-on--click=\"actions.increment\"\n\t\t\t>\n\t\t\t\t<?php echo esc_html( $target_context['buttonLabel'] ); ?>\n\t\t\t</button>\n\t\t</div>\n\t<?php endif; ?>\n\t<div class=\"{{cssClassName}}__items\">\n\t\t<?php echo wp_kses_post( $target_context['sanitizedContent'] ); ?>\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";
 /**
  * SCSS template for compound parent block styles.
  *
@@ -20,4 +20,4 @@ export declare const COMPOUND_STYLE_TEMPLATE = ".{{cssClassName}} {\n\tborder: 1
  * for block identity, namespace, text domain, storage mode, persistence policy,
  * CSS class names, and PHP-safe title output.
  */
-export declare const COMPOUND_PERSISTENCE_RENDER_TEMPLATE = "<?php\n/**\n * Dynamic render entry for the {{title}} compound parent 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$heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};\n$intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';\n$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';\n$show_count         = ! empty( $normalized['showCount'] );\n$show_dividers      = ! empty( $normalized['showDividers'] );\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$notice_message    = 'authenticated' === $persistence_policy\n\t? __( 'Sign in to persist this counter.', '{{textDomain}}' )\n\t: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );\n\nif ( empty( $validation['valid'] ) || '' === $resource_key ) {\n\treturn '';\n}\n\n{{phpPrefix}}_record_rendered_block_instance(\n\t(int) $post_id,\n\t'{{namespace}}/{{slugKebabCase}}',\n\t$resource_key\n);\n\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'persistencePolicy'    => $persistence_policy,\n\t'postId'               => (int) $post_id,\n\t'resourceKey'          => $resource_key,\n\t'showCount'            => $show_count,\n\t'storage'              => $storage_mode,\n);\n\n$allowed_inner_html = wp_kses_allowed_html( 'post' );\n\nforeach ( $allowed_inner_html as &$allowed_attributes ) {\n\tif ( ! is_array( $allowed_attributes ) ) {\n\t\tcontinue;\n\t}\n\n\t$allowed_attributes['data-wp-bind--disabled'] = true;\n\t$allowed_attributes['data-wp-bind--hidden'] = true;\n\t$allowed_attributes['data-wp-bind--value'] = true;\n\t$allowed_attributes['data-wp-class'] = true;\n\t$allowed_attributes['data-wp-class--active'] = true;\n\t$allowed_attributes['data-wp-context'] = true;\n\t$allowed_attributes['data-wp-init'] = true;\n\t$allowed_attributes['data-wp-interactive'] = true;\n\t$allowed_attributes['data-wp-on--click'] = true;\n\t$allowed_attributes['data-wp-on--mouseenter'] = true;\n\t$allowed_attributes['data-wp-on--mouseleave'] = true;\n\t$allowed_attributes['data-wp-run--mounted'] = true;\n\t$allowed_attributes['data-wp-style--width'] = true;\n\t$allowed_attributes['data-wp-text'] = true;\n}\nunset( $allowed_attributes );\n\n$sanitized_content = wp_kses( $content, $allowed_inner_html );\n\n$wrapper_attributes = get_block_wrapper_attributes(\n\tarray(\n\t\t'class'                => '{{cssClassName}}',\n\t\t'data-show-dividers'   => $show_dividers ? 'true' : 'false',\n\t\t'data-wp-context'      => wp_json_encode( $context ),\n\t\t'data-wp-init'         => 'callbacks.init',\n\t\t'data-wp-interactive'  => '{{slugKebabCase}}',\n\t\t'data-wp-run--mounted' => 'callbacks.mounted',\n\t)\n);\n?>\n\n<div <?php echo $wrapper_attributes; ?>>\n\t<h3 class=\"{{cssClassName}}__heading\"><?php echo esc_html( $heading ); ?></h3>\n\t<?php if ( '' !== $intro ) : ?>\n\t\t<p class=\"{{cssClassName}}__intro\"><?php echo esc_html( $intro ); ?></p>\n\t<?php endif; ?>\n\t<p\n\t\tclass=\"{{cssClassName}}__notice\"\n\t\tdata-wp-bind--hidden=\"!context.bootstrapReady || context.canWrite\"\n\t\thidden\n\t>\n\t\t<?php echo esc_html( $notice_message ); ?>\n\t</p>\n\t<p\n\t\tclass=\"{{cssClassName}}__error\"\n\t\trole=\"status\"\n\t\taria-live=\"polite\"\n\t\taria-atomic=\"true\"\n\t\tdata-wp-bind--hidden=\"!context.error\"\n\t\tdata-wp-text=\"context.error\"\n\t\thidden\n\t></p>\n\t<?php if ( $show_count ) : ?>\n\t\t<div class=\"{{cssClassName}}__counter\">\n\t\t\t<span\n\t\t\t\tclass=\"{{cssClassName}}__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>0</span>\n\t\t\t<button\n\t\t\t\ttype=\"button\"\n\t\t\t\tdisabled\n\t\t\t\tdata-wp-bind--disabled=\"!context.canWrite\"\n\t\t\t\tdata-wp-on--click=\"actions.increment\"\n\t\t\t>\n\t\t\t\t<?php echo esc_html( $button_label ); ?>\n\t\t\t</button>\n\t\t</div>\n\t<?php endif; ?>\n\t<div class=\"{{cssClassName}}__items\">\n\t\t<?php echo $sanitized_content; ?>\n\t</div>\n</div>\n";
+export declare const COMPOUND_PERSISTENCE_RENDER_TEMPLATE = "<?php\n/**\n * Dynamic render entry for the {{title}} compound parent 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// Preserve the former implicit default only for legacy blocks that omit the key.\n// Explicitly stored empty keys remain invalid.\n$resource_key       = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';\n$heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};\n$intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';\n$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';\n$show_count         = ! empty( $normalized['showCount'] );\n$show_dividers      = ! empty( $normalized['showDividers'] );\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$notice_message    = 'authenticated' === $persistence_policy\n\t? __( 'Sign in to persist this counter.', '{{textDomain}}' )\n\t: __( 'Public writes are temporarily unavailable.', '{{textDomain}}' );\n\nif ( empty( $validation['valid'] ) || '' === $resource_key ) {\n\treturn '';\n}\n\n{{phpPrefix}}_record_rendered_block_instance(\n\t(int) $post_id,\n\t'{{namespace}}/{{slugKebabCase}}',\n\t$resource_key\n);\n\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'persistencePolicy'    => $persistence_policy,\n\t'postId'               => (int) $post_id,\n\t'resourceKey'          => $resource_key,\n\t'showCount'            => $show_count,\n\t'storage'              => $storage_mode,\n);\n\n$allowed_inner_html = wp_kses_allowed_html( 'post' );\n\nforeach ( $allowed_inner_html as &$allowed_attributes ) {\n\tif ( ! is_array( $allowed_attributes ) ) {\n\t\tcontinue;\n\t}\n\n\t$allowed_attributes['data-wp-bind--disabled'] = true;\n\t$allowed_attributes['data-wp-bind--hidden'] = true;\n\t$allowed_attributes['data-wp-bind--value'] = true;\n\t$allowed_attributes['data-wp-class'] = true;\n\t$allowed_attributes['data-wp-class--active'] = true;\n\t$allowed_attributes['data-wp-context'] = true;\n\t$allowed_attributes['data-wp-init'] = true;\n\t$allowed_attributes['data-wp-interactive'] = true;\n\t$allowed_attributes['data-wp-on--click'] = true;\n\t$allowed_attributes['data-wp-on--mouseenter'] = true;\n\t$allowed_attributes['data-wp-on--mouseleave'] = true;\n\t$allowed_attributes['data-wp-run--mounted'] = true;\n\t$allowed_attributes['data-wp-style--width'] = true;\n\t$allowed_attributes['data-wp-text'] = true;\n}\nunset( $allowed_attributes );\n\n$sanitized_content = wp_kses( $content, $allowed_inner_html );\n\n$wrapper_attributes = get_block_wrapper_attributes(\n\tarray(\n\t\t'class'                => '{{cssClassName}}',\n\t\t'data-show-dividers'   => $show_dividers ? 'true' : 'false',\n\t\t'data-wp-context'      => wp_json_encode( $context ),\n\t\t'data-wp-init'         => 'callbacks.init',\n\t\t'data-wp-interactive'  => '{{slugKebabCase}}',\n\t\t'data-wp-run--mounted' => 'callbacks.mounted',\n\t)\n);\n?>\n\n<div <?php echo $wrapper_attributes; ?>>\n\t<h3 class=\"{{cssClassName}}__heading\"><?php echo esc_html( $heading ); ?></h3>\n\t<?php if ( '' !== $intro ) : ?>\n\t\t<p class=\"{{cssClassName}}__intro\"><?php echo esc_html( $intro ); ?></p>\n\t<?php endif; ?>\n\t<p\n\t\tclass=\"{{cssClassName}}__notice\"\n\t\tdata-wp-bind--hidden=\"!context.bootstrapReady || context.canWrite\"\n\t\thidden\n\t>\n\t\t<?php echo esc_html( $notice_message ); ?>\n\t</p>\n\t<p\n\t\tclass=\"{{cssClassName}}__error\"\n\t\trole=\"status\"\n\t\taria-live=\"polite\"\n\t\taria-atomic=\"true\"\n\t\tdata-wp-bind--hidden=\"!context.error\"\n\t\tdata-wp-text=\"context.error\"\n\t\thidden\n\t></p>\n\t<?php if ( $show_count ) : ?>\n\t\t<div class=\"{{cssClassName}}__counter\">\n\t\t\t<span\n\t\t\t\tclass=\"{{cssClassName}}__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>0</span>\n\t\t\t<button\n\t\t\t\ttype=\"button\"\n\t\t\t\tdisabled\n\t\t\t\tdata-wp-bind--disabled=\"!context.canWrite\"\n\t\t\t\tdata-wp-on--click=\"actions.increment\"\n\t\t\t>\n\t\t\t\t<?php echo esc_html( $button_label ); ?>\n\t\t\t</button>\n\t\t</div>\n\t<?php endif; ?>\n\t<div class=\"{{cssClassName}}__items\">\n\t\t<?php echo $sanitized_content; ?>\n\t</div>\n</div>\n";

package/dist/runtime/templates/built-in-block-non-ts-compound-templates.js CHANGED Viewed

@@ -30,7 +30,9 @@ if ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_build_render_context' )
 		$normalized         = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
 		$validation         = $validator->validate( $normalized );
-		$resource_key       = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+		// Preserve the former implicit default only for legacy blocks that omit the key.
+		// Explicitly stored empty keys remain invalid.
+		$resource_key       = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';
 		$heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};
 		$intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';
 		$button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';
@@ -321,7 +323,9 @@ if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults'
 $normalized         = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
 $validation         = $validator->validate( $normalized );
-$resource_key       = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+// Preserve the former implicit default only for legacy blocks that omit the key.
+// Explicitly stored empty keys remain invalid.
+$resource_key       = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';
 $heading            = isset( $normalized['heading'] ) ? (string) $normalized['heading'] : {{titlePhpLiteral}};
 $intro              = isset( $normalized['intro'] ) ? (string) $normalized['intro'] : '';
 $button_label       = isset( $normalized['buttonLabel'] ) ? (string) $normalized['buttonLabel'] : 'Persist Count';

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

@@ -12,7 +12,7 @@ export declare const PERSISTENCE_STYLE_TEMPLATE = ".{{cssClassName}} {\n\tborder
  * 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";
+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// Preserve the former implicit default only for legacy blocks that omit the key.\n// Explicitly stored empty keys remain invalid.\n$resource_key = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';\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.
  *
@@ -20,4 +20,4 @@ export declare const PERSISTENCE_RENDER_TEMPLATE = "<?php\n/**\n * Dynamic rende
  * 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 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// Preserve the former implicit default only for legacy blocks that omit the key.\n\t\t// Explicitly stored empty keys remain invalid.\n\t\t$resource_key = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';\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";

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

@@ -81,7 +81,9 @@ if ( ! is_object( $validator ) || ! method_exists( $validator, 'apply_defaults'
 $normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
 $validation   = $validator->validate( $normalized );
-$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+// Preserve the former implicit default only for legacy blocks that omit the key.
+// Explicitly stored empty keys remain invalid.
+$resource_key = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';
 if ( empty( $validation['valid'] ) || '' === $resource_key ) {
 	return '';
@@ -211,7 +213,9 @@ if ( ! function_exists( '{{phpPrefix}}_{{slugSnakeCase}}_build_render_context' )
 		$normalized   = $validator->apply_defaults( is_array( $attributes ) ? $attributes : array() );
 		$validation   = $validator->validate( $normalized );
-		$resource_key = isset( $normalized['resourceKey'] ) ? (string) $normalized['resourceKey'] : '';
+		// Preserve the former implicit default only for legacy blocks that omit the key.
+		// Explicitly stored empty keys remain invalid.
+		$resource_key = array_key_exists( 'resourceKey', $normalized ) ? (string) $normalized['resourceKey'] : 'primary';
 		if ( empty( $validation['valid'] ) || '' === $resource_key ) {
 			return null;

package/dist/runtime/templates/cli-scaffold-emission.d.ts CHANGED Viewed

@@ -15,7 +15,9 @@ export interface ScaffoldDryRunPlan {
      */
     dependencyInstall: "skipped-by-flag" | "would-install";
     /**
-     * Sorted project-relative paths that would be written by the scaffold.
+     * Sorted project-relative paths guaranteed by the selected scaffold flags.
+     * Compiler-derived paths are omitted with --no-install because their
+     * availability then depends on the caller's local generator dependencies.
      */
     files: string[];
 }
@@ -83,6 +85,10 @@ export interface ScaffoldEmissionOptions {
      * Absolute target directory for the generated project.
      */
     projectDir: string;
+    /**
+     * Internal preview control for compiler-backed metadata and REST seeding.
+     */
+    seedCompilerArtifacts?: boolean;
     /**
      * Resolved template id or external template locator to render.
      */

package/dist/runtime/templates/cli-scaffold-emission.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { assertDryRunTargetDirectoryReady, listRelativeProjectFiles, } from "./cli-scaffold-files.js";
 import { scaffoldProject } from "./scaffold.js";
+import { collectBuiltInCompilerArtifactPaths } from "./scaffold-compiler-artifacts.js";
 import { createManagedTempRoot } from "../shared/temp-roots.js";
 /**
  * Emit scaffold files into the target project directory.
@@ -27,8 +28,16 @@ export async function buildScaffoldDryRunPlan(options) {
             allowExistingDir: false,
             noInstall: true,
             projectDir: previewProjectDir,
+            seedCompilerArtifacts: false,
         });
-        const files = await listRelativeProjectFiles(previewProjectDir);
+        const files = [
+            ...new Set([
+                ...(await listRelativeProjectFiles(previewProjectDir)),
+                ...(options.noInstall
+                    ? []
+                    : collectBuiltInCompilerArtifactPaths(result.templateId, result.variables)),
+            ]),
+        ].sort((left, right) => left.localeCompare(right));
         return {
             plan: {
                 dependencyInstall: options.noInstall

package/dist/runtime/templates/cli-templates.d.ts CHANGED Viewed

@@ -1,5 +1,52 @@
 import { getTemplateById, getTemplateSelectOptions, isBuiltInTemplateId, listTemplates } from "./template-registry.js";
 import type { TemplateDefinition } from "./template-registry.js";
+/**
+ * Stable logical source metadata exposed by structured template discovery.
+ *
+ * Filesystem paths remain an internal implementation detail used to render a
+ * template. CLI consumers receive a built-in id or official package locator
+ * instead, so output is reproducible across npm caches and worktrees.
+ */
+export type CliTemplateSource = {
+    kind: "built-in";
+    id: string;
+} | {
+    kind: "npm";
+    packageName: string;
+    alias: string;
+};
+/** Public template metadata returned by `templates ... --format json`. */
+export interface CliTemplateMetadata {
+    id: string;
+    description: string;
+    defaultCategory: string;
+    features: string[];
+    source: CliTemplateSource;
+}
+/**
+ * Converts internal template registry metadata into a portable CLI payload.
+ *
+ * @param template Internal template definition used for scaffold resolution.
+ * @returns Stable public metadata without the installation-local template directory.
+ */
+export declare function toCliTemplateMetadata(template: TemplateDefinition): CliTemplateMetadata;
+/** Returns all registered templates as portable structured-output metadata. */
+export declare function listCliTemplateMetadata(): readonly CliTemplateMetadata[];
+/**
+ * Finds one registered template as portable structured-output metadata.
+ *
+ * @param templateId Built-in id, official package name, or workspace alias.
+ * @returns Stable public metadata, or `undefined` when the id is not registered.
+ */
+export declare function findCliTemplateMetadata(templateId: string): CliTemplateMetadata | undefined;
+/**
+ * Resolves one registered template as portable structured-output metadata.
+ *
+ * @param templateId Built-in id, official package name, or workspace alias.
+ * @returns Stable public metadata for the requested template.
+ * @throws {Error} When the id does not match a registered template or alias.
+ */
+export declare function getCliTemplateMetadata(templateId: string): CliTemplateMetadata;
 /**
  * Format one line of template list output for a built-in template.
  *

package/dist/runtime/templates/cli-templates.js CHANGED Viewed

@@ -1,4 +1,53 @@
-import { OFFICIAL_WORKSPACE_TEMPLATE_ALIAS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, getUserFacingTemplateId, getTemplateById, getTemplateSelectOptions, isBuiltInTemplateId, listTemplates, } from "./template-registry.js";
+import { OFFICIAL_WORKSPACE_TEMPLATE_ALIAS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, getUserFacingTemplateId, getTemplateById, getTemplateSelectOptions, isBuiltInTemplateId, listTemplates, normalizeTemplateLookupId, } from "./template-registry.js";
+/**
+ * Converts internal template registry metadata into a portable CLI payload.
+ *
+ * @param template Internal template definition used for scaffold resolution.
+ * @returns Stable public metadata without the installation-local template directory.
+ */
+export function toCliTemplateMetadata(template) {
+    return {
+        id: template.id,
+        description: template.description,
+        defaultCategory: template.defaultCategory,
+        features: [...template.features],
+        source: isBuiltInTemplateId(template.id)
+            ? {
+                kind: "built-in",
+                id: template.id,
+            }
+            : {
+                kind: "npm",
+                packageName: OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE,
+                alias: OFFICIAL_WORKSPACE_TEMPLATE_ALIAS,
+            },
+    };
+}
+/** Returns all registered templates as portable structured-output metadata. */
+export function listCliTemplateMetadata() {
+    return listTemplates().map(toCliTemplateMetadata);
+}
+/**
+ * Finds one registered template as portable structured-output metadata.
+ *
+ * @param templateId Built-in id, official package name, or workspace alias.
+ * @returns Stable public metadata, or `undefined` when the id is not registered.
+ */
+export function findCliTemplateMetadata(templateId) {
+    const normalizedTemplateId = normalizeTemplateLookupId(templateId);
+    const template = listTemplates().find((entry) => entry.id === normalizedTemplateId);
+    return template ? toCliTemplateMetadata(template) : undefined;
+}
+/**
+ * Resolves one registered template as portable structured-output metadata.
+ *
+ * @param templateId Built-in id, official package name, or workspace alias.
+ * @returns Stable public metadata for the requested template.
+ * @throws {Error} When the id does not match a registered template or alias.
+ */
+export function getCliTemplateMetadata(templateId) {
+    return toCliTemplateMetadata(getTemplateById(templateId));
+}
 /**
  * Format one line of template list output for a built-in template.
  *

package/dist/runtime/templates/local-dev-presets.js CHANGED Viewed

@@ -52,7 +52,7 @@ function getDevScript(packageManager, compoundPersistenceEnabled, templateId) {
     syncProcesses.push(`"${formatRunScript(packageManager, "start:editor")}"`);
     names.push("editor");
     colors.push("blue");
-    return `concurrently -k -n ${names.join(",")} -c ${colors.join(",")} ${syncProcesses.join(" ")}`;
+    return `${formatRunScript(packageManager, "sync")} && concurrently -k -n ${names.join(",")} -c ${colors.join(",")} ${syncProcesses.join(" ")}`;
 }
 async function mutatePackageJson(projectDir, mutate) {
     const packageJsonPath = path.join(projectDir, "package.json");

package/dist/runtime/templates/scaffold-apply-utils.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { type BuiltInBlockArtifact } from "./built-in-block-artifacts.js";
 import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
 import { type BuiltInTemplateId } from "./template-registry.js";
-import type { PackageManagerId } from "../shared/package-managers.js";
+import { type PackageManagerId } from "../shared/package-managers.js";
 export { applyWorkspaceMigrationCapability, isOfficialWorkspaceProject, } from "./scaffold-bootstrap.js";
 import type { ScaffoldProgressEvent, ScaffoldTemplateVariables } from "./scaffold.js";
 export { buildGitignore, buildReadme, mergeTextLines } from "./scaffold-documents.js";
@@ -11,11 +11,6 @@ export interface InstallDependenciesOptions {
 }
 export declare function ensureDirectory(targetDir: string, allowExisting?: boolean): Promise<void>;
 export declare function writeStarterManifestFiles(targetDir: string, templateId: string, variables: ScaffoldTemplateVariables, artifacts?: readonly BuiltInBlockArtifact[]): Promise<void>;
-/**
- * Seed REST-derived persistence artifacts into a newly scaffolded built-in
- * project before the first manual `sync-rest` run.
- */
-export declare function seedBuiltInPersistenceArtifacts(targetDir: string, templateId: BuiltInTemplateId, variables: ScaffoldTemplateVariables): Promise<void>;
 export declare function normalizePackageManagerFiles(targetDir: string, packageManagerId: PackageManagerId): Promise<void>;
 export declare function removeQueryLoopPlaceholderFiles(projectDir: string, templateId: string): Promise<void>;
 export declare function removeUnexpectedLockfiles(targetDir: string, packageManagerId: PackageManagerId): Promise<void>;
@@ -32,7 +27,7 @@ export declare function defaultInstallDependencies({ projectDir, packageManager,
  * Applies a built-in scaffold into the target directory, including generated
  * code artifacts, starter manifests, preset files, and placeholder rewrites.
  */
-export declare function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir, templateId, variables, artifacts, codeArtifacts, readmeContent, gitignoreContent, allowExistingDir, packageManager, withMigrationUi, withTestPreset, withWpEnv, noInstall, installDependencies, repositoryReference, onProgress, }: {
+export declare function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir, templateId, variables, artifacts, codeArtifacts, readmeContent, gitignoreContent, allowExistingDir, packageManager, withMigrationUi, withTestPreset, withWpEnv, noInstall, installDependencies, repositoryReference, onProgress, seedCompilerArtifacts, }: {
     projectDir: string;
     templateDir: string;
     templateId: BuiltInTemplateId;
@@ -50,4 +45,5 @@ export declare function applyBuiltInScaffoldProjectFiles({ projectDir, templateD
     installDependencies?: ((options: InstallDependenciesOptions) => Promise<void>) | undefined;
     repositoryReference?: string;
     onProgress?: ((event: ScaffoldProgressEvent) => void | Promise<void>) | undefined;
-}): Promise<void>;
+    seedCompilerArtifacts?: boolean;
+}): Promise<string[]>;

package/dist/runtime/templates/scaffold-apply-utils.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { execSync } from "node:child_process";
+import { syncBlockMetadata } from "@wp-typia/block-runtime/metadata-core";
 import { applyGeneratedProjectDxPackageJson, applyLocalDevPresetFiles, } from "./local-dev-presets.js";
 import { applyMigrationUiCapability } from "../migration/migration-ui-capability.js";
 import { syncPersistenceRestArtifacts, } from "../add/persistence-rest-artifacts.js";
@@ -8,10 +9,13 @@ import { buildGitignore, buildReadme, mergeTextLines, } from "./scaffold-documen
 import { getStarterManifestFiles, stringifyStarterManifest, } from "./starter-manifests.js";
 import { formatNonEmptyTargetDirectoryError, } from "./scaffold-bootstrap.js";
 import { stringifyBuiltInBlockJsonDocument, } from "./built-in-block-artifacts.js";
+import { buildBuiltInBlockMetadataSyncOptions, buildBuiltInPersistenceRestSyncOptions, } from "./scaffold-compiler-artifacts.js";
+import { getDeferredCompilerArtifactsWarning } from "./scaffold-onboarding.js";
 import { PROJECT_TOOLS_PACKAGE_ROOT, } from "./template-registry.js";
 import { copyInterpolatedDirectory } from "./template-render.js";
 import { formatInstallCommand, transformPackageManagerText, } from "../shared/package-managers.js";
 import { pathExists, readOptionalUtf8File, } from "../shared/fs-async.js";
+import { readJsonFile } from "../shared/json-utils.js";
 import { normalizePackageJson } from "./scaffold-package-manager-files.js";
 export { applyWorkspaceMigrationCapability, isOfficialWorkspaceProject, } from "./scaffold-bootstrap.js";
 import { replaceRepositoryReferencePlaceholders, resolveScaffoldRepositoryReference, } from "./scaffold-repository-reference.js";
@@ -82,48 +86,45 @@ async function withEphemeralScaffoldNodeModules(targetDir, callback) {
     const targetNodeModulesPath = path.join(targetDir, "node_modules");
     if (await pathExists(targetNodeModulesPath)) {
         await callback();
-        return;
+        return true;
     }
     const sourceNodeModulesPath = await resolveScaffoldGeneratorNodeModulesPath();
     if (!sourceNodeModulesPath) {
-        throw new Error("Unable to resolve a node_modules directory with typia for scaffold-time REST artifact generation.");
+        return false;
     }
     await fsp.symlink(sourceNodeModulesPath, targetNodeModulesPath, EPHEMERAL_NODE_MODULES_LINK_TYPE);
     try {
         await callback();
+        return true;
     }
     finally {
         await fsp.rm(targetNodeModulesPath, { force: true, recursive: true });
     }
 }
-/**
- * Seed REST-derived persistence artifacts into a newly scaffolded built-in
- * project before the first manual `sync-rest` run.
- */
-export async function seedBuiltInPersistenceArtifacts(targetDir, templateId, variables) {
-    const needsPersistenceArtifacts = templateId === "persistence" ||
-        (templateId === "compound" && isCompoundPersistenceEnabled(variables));
-    if (!needsPersistenceArtifacts) {
-        return;
+async function seedBuiltInCompilerArtifacts(targetDir, templateId, artifacts, variables) {
+    const blockMetadataSyncOptions = buildBuiltInBlockMetadataSyncOptions(targetDir, templateId, artifacts);
+    const persistenceSyncOptions = buildBuiltInPersistenceRestSyncOptions(targetDir, templateId, variables);
+    if (blockMetadataSyncOptions.length === 0 && !persistenceSyncOptions) {
+        return true;
     }
-    await withEphemeralScaffoldNodeModules(targetDir, async () => {
-        if (templateId === "persistence") {
-            await syncPersistenceRestArtifacts({
-                apiTypesFile: path.join("src", "api-types.ts"),
-                outputDir: "src",
-                projectDir: targetDir,
-                variables,
-            });
-            return;
+    return withEphemeralScaffoldNodeModules(targetDir, async () => {
+        for (const options of blockMetadataSyncOptions) {
+            await syncBlockMetadata(options);
+        }
+        if (persistenceSyncOptions) {
+            await syncPersistenceRestArtifacts(persistenceSyncOptions);
         }
-        await syncPersistenceRestArtifacts({
-            apiTypesFile: path.join("src", "blocks", variables.slugKebabCase, "api-types.ts"),
-            outputDir: path.join("src", "blocks", variables.slugKebabCase),
-            projectDir: targetDir,
-            variables,
-        });
     });
 }
+async function readScaffoldScriptNames(projectDir) {
+    try {
+        const packageJson = await readJsonFile(path.join(projectDir, "package.json"), { context: "generated scaffold package manifest" });
+        return Object.keys(packageJson.scripts ?? {});
+    }
+    catch {
+        return [];
+    }
+}
 export async function normalizePackageManagerFiles(targetDir, packageManagerId) {
     const yarnRcPath = path.join(targetDir, ".yarnrc.yml");
     if (packageManagerId === "yarn") {
@@ -201,7 +202,8 @@ export async function defaultInstallDependencies({ projectDir, packageManager, }
  * Applies a built-in scaffold into the target directory, including generated
  * code artifacts, starter manifests, preset files, and placeholder rewrites.
  */
-export async function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir, templateId, variables, artifacts, codeArtifacts, readmeContent, gitignoreContent, allowExistingDir = false, packageManager, withMigrationUi = false, withTestPreset = false, withWpEnv = false, noInstall = false, installDependencies, repositoryReference, onProgress, }) {
+export async function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir, templateId, variables, artifacts, codeArtifacts, readmeContent, gitignoreContent, allowExistingDir = false, packageManager, withMigrationUi = false, withTestPreset = false, withWpEnv = false, noInstall = false, installDependencies, repositoryReference, onProgress, seedCompilerArtifacts = true, }) {
+    const warnings = [];
     await ensureDirectory(projectDir, allowExistingDir);
     await reportScaffoldProgress(onProgress, {
         detail: "Copying built-in template files and writing generated source modules.",
@@ -221,7 +223,6 @@ export async function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir
         title: "Seeding scaffold artifacts",
     });
     await writeStarterManifestFiles(projectDir, templateId, variables, artifacts);
-    await seedBuiltInPersistenceArtifacts(projectDir, templateId, variables);
     await applyLocalDevPresetFiles({
         projectDir,
         variables,
@@ -280,4 +281,19 @@ export async function applyBuiltInScaffoldProjectFiles({ projectDir, templateDir
             packageManager,
         });
     }
+    if (seedCompilerArtifacts) {
+        const seededCompilerArtifacts = await seedBuiltInCompilerArtifacts(projectDir, templateId, artifacts ?? [], variables);
+        if (!seededCompilerArtifacts) {
+            const warning = getDeferredCompilerArtifactsWarning(packageManager, templateId, {
+                availableScripts: await readScaffoldScriptNames(projectDir),
+            });
+            warnings.push(warning);
+            await reportScaffoldProgress(onProgress, {
+                detail: warning,
+                phase: "seed-artifacts",
+                title: "Deferring compiler-derived artifacts",
+            });
+        }
+    }
+    return warnings;
 }

package/dist/runtime/templates/scaffold-compiler-artifacts.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import type { SyncBlockMetadataOptions } from "@wp-typia/block-runtime/metadata-core";
+import { type SyncPersistenceRestArtifactsOptions } from "../add/persistence-rest-artifacts.js";
+import type { BuiltInBlockArtifact } from "./built-in-block-artifacts.js";
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+import { type BuiltInTemplateId } from "./template-registry.js";
+/**
+ * Build the canonical sync options for each typed block in a built-in scaffold.
+ */
+export declare function buildBuiltInBlockMetadataSyncOptions(projectDir: string, templateId: BuiltInTemplateId, artifacts: readonly BuiltInBlockArtifact[]): SyncBlockMetadataOptions[];
+/**
+ * Resolve the canonical REST sync input for a persistence-enabled scaffold.
+ */
+export declare function buildBuiltInPersistenceRestSyncOptions(projectDir: string, templateId: BuiltInTemplateId, variables: ScaffoldTemplateVariables): SyncPersistenceRestArtifactsOptions | null;
+/**
+ * Collect every compiler-derived path without executing the compiler.
+ */
+export declare function collectBuiltInCompilerArtifactPaths(templateId: string, variables: ScaffoldTemplateVariables): string[];