@wp-typia/project-tools 0.23.1 → 0.24.0

package/dist/runtime/built-in-block-non-ts-interactivity-artifacts.d.ts

@@ -0,0 +1,9 @@
+import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+/**
+ * Builds the interactivity family non-TypeScript scaffold artifacts.
+ *
+ * @param variables Scaffold template variables used to render the artifact set.
+ * @returns The SCSS artifacts owned by the interactivity template family.
+ */
+export declare function buildInteractivityArtifacts(variables: ScaffoldTemplateVariables): BuiltInCodeArtifact[];

package/dist/runtime/built-in-block-non-ts-interactivity-artifacts.js

@@ -0,0 +1,83 @@
+import { renderArtifact } from "./built-in-block-non-ts-render-utils.js";
+const INTERACTIVITY_STYLE_TEMPLATE = `.{{cssClassName}} {
+  position: relative;
+  padding: 1rem;
+  border: 1px solid #dcdcde;
+  border-radius: 0.75rem;
+  background: #fff;
+
+  &__content {
+    display: grid;
+    gap: 0.75rem;
+  }
+
+  &__counter {
+    display: inline-flex;
+    gap: 0.35rem;
+    align-items: center;
+    font-size: 0.9rem;
+    font-weight: 600;
+  }
+
+  &__progress {
+    width: 100%;
+    height: 0.5rem;
+    overflow: hidden;
+    background: #f0f0f1;
+    border-radius: 999px;
+  }
+
+  &__progress-bar {
+    height: 100%;
+    background: #3858e9;
+    transition: width 0.2s ease;
+  }
+
+  &__animation {
+    min-height: 1.5rem;
+    font-size: 0.85rem;
+    color: #3858e9;
+    opacity: 0;
+    transition: opacity 0.2s ease;
+
+    &.is-active {
+      opacity: 1;
+    }
+  }
+
+  &__completion {
+    font-weight: 700;
+    color: #06752d;
+  }
+
+  &__reset {
+    align-self: start;
+    padding: 0.4rem 0.7rem;
+    border: 1px solid #dcdcde;
+    border-radius: 999px;
+    background: transparent;
+    cursor: pointer;
+  }
+}
+`;
+const INTERACTIVITY_EDITOR_STYLE_TEMPLATE = `/**
+ * {{title}} Block Editor Styles
+ */
+
+.{{cssClassName}} {
+	outline: 1px dashed #ddd;
+	outline-offset: -1px;
+}
+`;
+/**
+ * Builds the interactivity family non-TypeScript scaffold artifacts.
+ *
+ * @param variables Scaffold template variables used to render the artifact set.
+ * @returns The SCSS artifacts owned by the interactivity template family.
+ */
+export function buildInteractivityArtifacts(variables) {
+    return [
+        renderArtifact("src/editor.scss", INTERACTIVITY_EDITOR_STYLE_TEMPLATE, variables),
+        renderArtifact("src/style.scss", INTERACTIVITY_STYLE_TEMPLATE, variables),
+    ];
+}

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

@@ -0,0 +1,9 @@
+import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+/**
+ * Builds the persistence family non-TypeScript scaffold artifacts.
+ *
+ * @param variables Scaffold template variables used to render the artifact set.
+ * @returns The persistence SCSS and PHP artifacts for the selected render targets.
+ */
+export declare function buildPersistenceArtifacts(variables: ScaffoldTemplateVariables): BuiltInCodeArtifact[];

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

@@ -0,0 +1,33 @@
+import { buildAlternateRenderEntryArtifact, renderArtifact, } from "./built-in-block-non-ts-render-utils.js";
+import { PERSISTENCE_RENDER_TARGETS_TEMPLATE, PERSISTENCE_RENDER_TEMPLATE, PERSISTENCE_STYLE_TEMPLATE, } from "./built-in-block-non-ts-persistence-templates.js";
+import { getScaffoldAlternateRenderTargets } from "./scaffold-template-variable-groups.js";
+/**
+ * Builds the persistence family non-TypeScript scaffold artifacts.
+ *
+ * @param variables Scaffold template variables used to render the artifact set.
+ * @returns The persistence SCSS and PHP artifacts for the selected render targets.
+ */
+export function buildPersistenceArtifacts(variables) {
+    const alternateRenderTargets = getScaffoldAlternateRenderTargets(variables);
+    if (!alternateRenderTargets.enabled) {
+        return [
+            renderArtifact("src/style.scss", PERSISTENCE_STYLE_TEMPLATE, variables),
+            renderArtifact("src/render.php", PERSISTENCE_RENDER_TEMPLATE, variables),
+        ];
+    }
+    const artifacts = [
+        renderArtifact("src/style.scss", PERSISTENCE_STYLE_TEMPLATE, variables),
+        renderArtifact("src/render-targets.php", PERSISTENCE_RENDER_TARGETS_TEMPLATE, variables),
+        buildAlternateRenderEntryArtifact("src/render.php", "web", variables),
+    ];
+    if (alternateRenderTargets.hasEmail) {
+        artifacts.push(buildAlternateRenderEntryArtifact("src/render-email.php", "email", variables));
+    }
+    if (alternateRenderTargets.hasMjml) {
+        artifacts.push(buildAlternateRenderEntryArtifact("src/render-mjml.php", "mjml", variables));
+    }
+    if (alternateRenderTargets.hasPlainText) {
+        artifacts.push(buildAlternateRenderEntryArtifact("src/render-text.php", "plain-text", variables));
+    }
+    return artifacts;
+}

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

@@ -0,0 +1,23 @@
+/**
+ * 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";

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

@@ -0,0 +1,395 @@
+/**
+ * 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
+		);
+	}
+}
+`;

package/dist/runtime/cli-add-collision.js

@@ -90,6 +90,14 @@ const PATTERN_COLLISION_DESCRIPTOR = {
             label: "A pattern",
             relativePath: ({ slug }) => path.join("src", "patterns", `${slug}.php`),
         },
+        {
+            label: "A full pattern",
+            relativePath: ({ slug }) => path.join("src", "patterns", "full", `${slug}.php`),
+        },
+        {
+            label: "A section pattern",
+            relativePath: ({ slug }) => path.join("src", "patterns", "sections", `${slug}.php`),
+        },
     ],
     inventoryCollision: {
         entries: (inventory) => inventory.patterns,

package/dist/runtime/cli-add-help.js

@@ -9,11 +9,13 @@ export function formatAddHelpText() {
   wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>] [--dry-run]
   wp-typia add block <name> [--template <${ADD_BLOCK_TEMPLATE_IDS.join("|")}>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--dry-run]
   wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>] [--dry-run]
-  wp-typia add variation <name> --block <block-slug> [--dry-run]
-  wp-typia add style <name> --block <block-slug> [--dry-run]
-  wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug> [--dry-run]
-  wp-typia add pattern <name> [--dry-run]
-  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--dry-run]
+  wp-typia add core-variation <block-name> <name> [--dry-run]
+  wp-typia add core-variation <name> --block <namespace/block> [--dry-run]
+	wp-typia add variation <name> --block <block-slug> [--dry-run]
+	wp-typia add style <name> --block <block-slug> [--dry-run]
+	wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug> [--dry-run]
+  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--tags <tag,...>] [--thumbnail-url <url>] [--dry-run]
+  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]] [--dry-run]
   wp-typia add contract <name> [--type <ExportedTypeName>] [--dry-run]
   wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <${REST_RESOURCE_METHOD_IDS.join(",")}>] [--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--dry-run]
   wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>] [--dry-run]
@@ -27,6 +29,7 @@ Notes:
   \`wp-typia add\` runs only inside official ${WORKSPACE_TEMPLATE_PACKAGE} workspaces scaffolded via \`wp-typia create <project-dir> --template workspace\`.
   Pass \`--dry-run\` to preview the workspace files that would change without writing them.
   Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
+  \`add core-variation\` registers editor-side variations for existing core or external blocks without generating block.json or Typia manifests.
   \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
   Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
   Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
@@ -38,8 +41,8 @@ Notes:
   \`add variation\` targets an existing block slug from \`scripts/block-config.ts\`.
   \`add style\` registers a Block Styles option for an existing generated block.
   \`add transform\` adds a block-to-block transform into an existing generated block.
-  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/\`.
-  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare an end-to-end bindable attribute on an existing generated block.
+  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\` and records typed catalog metadata in \`PATTERNS\`.
+  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare an end-to-end bindable attribute on an existing generated block. Pass \`--from-post-meta\` or \`--post-meta\` to generate a source backed by a typed post-meta contract; \`--meta-path\` selects one top-level field as the default binding arg.
   \`add contract\` registers a standalone TypeScript wire contract under \`src/contracts/\` and generates a stable JSON Schema artifact without creating PHP route glue.
   \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`. Use \`--route-pattern\`, \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` when an existing WordPress controller or permission model needs to own part of the generated route surface.
   Pass \`--manual\` with \`add rest-resource\` to track an external/provider REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files. Manual routes may still declare \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` as metadata for the route owner. Settings contracts can add \`--secret-field\` with \`--secret-preserve-on-empty\` metadata so generated schemas, clients, and admin forms treat blank secret submissions as preserve-by-default.

package/dist/runtime/cli-add-kind-ids.d.ts

@@ -4,7 +4,7 @@
  *
  * Keep this order stable because it drives help output and command metadata.
  */
-export declare const ADD_KIND_IDS: readonly ["admin-view", "block", "integration-env", "variation", "style", "transform", "pattern", "binding-source", "contract", "rest-resource", "post-meta", "ability", "ai-feature", "hooked-block", "editor-plugin"];
+export declare const ADD_KIND_IDS: readonly ["admin-view", "block", "integration-env", "core-variation", "variation", "style", "transform", "pattern", "binding-source", "contract", "rest-resource", "post-meta", "ability", "ai-feature", "hooked-block", "editor-plugin"];
 /**
  * Union of supported top-level `wp-typia add` kind ids.
  */

package/dist/runtime/cli-add-kind-ids.js

@@ -8,6 +8,7 @@ export const ADD_KIND_IDS = [
     "admin-view",
     "block",
     "integration-env",
+    "core-variation",
     "variation",
     "style",
     "transform",