@wp-typia/project-tools 0.18.0 → 0.19.1

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

@@ -307,6 +307,461 @@ $wrapper_attributes = get_block_wrapper_attributes(
 	</div>
 </div>
 `;
+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
+		);
+	}
+}
+`;
+const COMPOUND_PERSISTENCE_RENDER_TARGETS_TEMPLATE = `<?php
+/**
+ * Alternate render target helpers for the {{title}} compound parent 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'] : '';
+		$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';
+		$show_count         = ! empty( $normalized['showCount'] );
+		$show_dividers      = ! empty( $normalized['showDividers'] );
+		$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}}' );
+
+		if ( empty( $validation['valid'] ) || '' === $resource_key ) {
+			return null;
+		}
+
+		$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,
+			'persistencePolicy'    => $persistence_policy,
+			'postId'               => (int) $post_id,
+			'resourceKey'          => $resource_key,
+			'showCount'            => $show_count,
+			'storage'              => $storage_mode,
+		);
+
+		$allowed_inner_html = wp_kses_allowed_html( 'post' );
+
+		foreach ( $allowed_inner_html as &$allowed_attributes ) {
+			if ( ! is_array( $allowed_attributes ) ) {
+				continue;
+			}
+
+			$allowed_attributes['data-wp-bind--disabled'] = true;
+			$allowed_attributes['data-wp-bind--hidden'] = true;
+			$allowed_attributes['data-wp-bind--value'] = true;
+			$allowed_attributes['data-wp-class'] = true;
+			$allowed_attributes['data-wp-class--active'] = true;
+			$allowed_attributes['data-wp-context'] = true;
+			$allowed_attributes['data-wp-init'] = true;
+			$allowed_attributes['data-wp-interactive'] = true;
+			$allowed_attributes['data-wp-on--click'] = true;
+			$allowed_attributes['data-wp-on--mouseenter'] = true;
+			$allowed_attributes['data-wp-on--mouseleave'] = true;
+			$allowed_attributes['data-wp-run--mounted'] = true;
+			$allowed_attributes['data-wp-style--width'] = true;
+			$allowed_attributes['data-wp-text'] = true;
+		}
+		unset( $allowed_attributes );
+
+		return array(
+			'buttonLabel'       => $button_label,
+			'frontendClassName' => '{{cssClassName}}',
+			'heading'           => $heading,
+			'intro'             => $intro,
+			'isVisible'         => true,
+			'normalized'        => $normalized,
+			'noticeMessage'     => $notice_message,
+			'postId'            => (int) $post_id,
+			'resourceKey'       => $resource_key,
+			'sanitizedContent'  => wp_kses( $content, $allowed_inner_html ),
+			'showCount'         => $show_count,
+			'showDividers'      => $show_dividers,
+			'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 ) {
+			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">',
+					'<h3>' . esc_html( $target_context['heading'] ) . '</h3>',
+				);
+				if ( '' !== $target_context['intro'] ) {
+					$parts[] = '<p>' . esc_html( $target_context['intro'] ) . '</p>';
+				}
+				if ( ! empty( $target_context['showCount'] ) ) {
+					$parts[] = '<p><strong>' . esc_html__( 'Count', '{{textDomain}}' ) . ':</strong> ' . esc_html( (string) $target_context['webContext']['count'] ) . '</p>';
+				}
+				$parts[] = wp_kses_post( $target_context['sanitizedContent'] );
+				$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 font-weight="700">' . esc_html( $target_context['heading'] ) . '</mj-text>';
+				if ( '' !== $target_context['intro'] ) {
+					$markup .= '<mj-text>' . esc_html( $target_context['intro'] ) . '</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( wp_strip_all_tags( $target_context['sanitizedContent'] ) ) . '</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['heading'],
+							$target_context['intro'],
+							wp_strip_all_tags( $target_context['sanitizedContent'] ),
+							! 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(
+						'class'                => '{{cssClassName}}',
+						'data-show-dividers'   => $target_context['showDividers'] ? 'true' : 'false',
+						'data-wp-context'      => wp_json_encode( $target_context['webContext'] ),
+						'data-wp-init'         => 'callbacks.init',
+						'data-wp-interactive'  => '{{slugKebabCase}}',
+						'data-wp-run--mounted' => 'callbacks.mounted',
+					)
+				);
+				ob_start();
+				?>
+<div <?php echo $wrapper_attributes; ?>>
+	<h3 class="{{cssClassName}}__heading"><?php echo esc_html( $target_context['heading'] ); ?></h3>
+	<?php if ( '' !== $target_context['intro'] ) : ?>
+		<p class="{{cssClassName}}__intro"><?php echo esc_html( $target_context['intro'] ); ?></p>
+	<?php endif; ?>
+	<p
+		class="{{cssClassName}}__notice"
+		data-wp-bind--hidden="!context.bootstrapReady || context.canWrite"
+		hidden
+	>
+		<?php echo esc_html( $target_context['noticeMessage'] ); ?>
+	</p>
+	<p
+		class="{{cssClassName}}__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'] ) ) : ?>
+		<div class="{{cssClassName}}__counter">
+			<span
+				class="{{cssClassName}}__count"
+				role="status"
+				aria-live="polite"
+				aria-atomic="true"
+				data-wp-text="context.count"
+			>0</span>
+			<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>
+	<?php endif; ?>
+	<div class="{{cssClassName}}__items">
+		<?php echo wp_kses_post( $target_context['sanitizedContent'] ); ?>
+	</div>
+</div>
+				<?php
+				$markup = (string) ob_get_clean();
+				break;
+		}
+
+		return apply_filters(
+			'{{phpPrefix}}_{{slugSnakeCase}}_render_target_markup',
+			$markup,
+			$target,
+			$target_context
+		);
+	}
+}
+`;
 const COMPOUND_STYLE_TEMPLATE = `.{{cssClassName}} {
 	border: 1px solid #dcdcde;
 	border-radius: 12px;
@@ -346,6 +801,24 @@ function renderArtifact(relativePath, template, view) {
         source: source.endsWith("\n") ? source : `${source}\n`,
     };
 }
+function buildAlternateRenderEntryArtifact(relativePath, target, variables) {
+    const template = `<?php
+/**
+ * Alternate ${target} render entry for {{title}}.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+require_once __DIR__ . '/render-targets.php';
+
+return {{phpPrefix}}_{{slugSnakeCase}}_render_target( '${target}', $attributes, $content ?? '', $block ?? null );
+`;
+    return renderArtifact(relativePath, template, variables);
+}
 function toPhpSingleQuotedString(value) {
     return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
 }
@@ -363,10 +836,27 @@ function buildInteractivityArtifacts(variables) {
     ];
 }
 function buildPersistenceArtifacts(variables) {
-    return [
+    if (variables.hasAlternateRenderTargets !== "true") {
+        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.php", PERSISTENCE_RENDER_TEMPLATE, variables),
+        renderArtifact("src/render-targets.php", PERSISTENCE_RENDER_TARGETS_TEMPLATE, variables),
+        buildAlternateRenderEntryArtifact("src/render.php", "web", variables),
     ];
+    if (variables.hasAlternateEmailRenderTarget === "true") {
+        artifacts.push(buildAlternateRenderEntryArtifact("src/render-email.php", "email", variables));
+    }
+    if (variables.hasAlternateMjmlRenderTarget === "true") {
+        artifacts.push(buildAlternateRenderEntryArtifact("src/render-mjml.php", "mjml", variables));
+    }
+    if (variables.hasAlternatePlainTextRenderTarget === "true") {
+        artifacts.push(buildAlternateRenderEntryArtifact("src/render-text.php", "plain-text", variables));
+    }
+    return artifacts;
 }
 function buildCompoundArtifacts(variables) {
     const artifacts = [
@@ -377,6 +867,19 @@ function buildCompoundArtifacts(variables) {
             ...variables,
             titlePhpLiteral: toPhpSingleQuotedString(variables.title),
         };
+        if (variables.hasAlternateRenderTargets === "true") {
+            artifacts.push(renderArtifact(`src/blocks/${variables.slugKebabCase}/render-targets.php`, COMPOUND_PERSISTENCE_RENDER_TARGETS_TEMPLATE, renderView), buildAlternateRenderEntryArtifact(`src/blocks/${variables.slugKebabCase}/render.php`, "web", variables));
+            if (variables.hasAlternateEmailRenderTarget === "true") {
+                artifacts.push(buildAlternateRenderEntryArtifact(`src/blocks/${variables.slugKebabCase}/render-email.php`, "email", variables));
+            }
+            if (variables.hasAlternateMjmlRenderTarget === "true") {
+                artifacts.push(buildAlternateRenderEntryArtifact(`src/blocks/${variables.slugKebabCase}/render-mjml.php`, "mjml", variables));
+            }
+            if (variables.hasAlternatePlainTextRenderTarget === "true") {
+                artifacts.push(buildAlternateRenderEntryArtifact(`src/blocks/${variables.slugKebabCase}/render-text.php`, "plain-text", variables));
+            }
+            return artifacts;
+        }
         const renderSource = `<?php
 /**
  * Dynamic render entry for the {{title}} compound parent block.

package/dist/runtime/cli-add-block.d.ts

@@ -18,6 +18,9 @@ export declare function seedWorkspaceMigrationProject(projectDir: string, curren
  * workspace. Defaults to `process.cwd()`.
  * @param options.dataStorageMode Optional storage mode for persistence-capable
  * templates.
+ * @param options.innerBlocksPreset Optional compound-only InnerBlocks preset
+ * (`freeform`, `ordered`, `horizontal`, or `locked-structure`) that controls
+ * the generated authoring defaults for nested compound containers.
  * @param options.persistencePolicy Optional persistence policy for
  * persistence-capable templates.
  * @param options.templateId Built-in block family to scaffold. Defaults to
@@ -30,7 +33,7 @@ export declare function seedWorkspaceMigrationProject(projectDir: string, curren
  * workspace dependencies have not been installed yet, or target block paths
  * already exist.
  */
-export declare function runAddBlockCommand({ blockName, cwd, dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, selectExternalLayerId, templateId, }: RunAddBlockCommandOptions): Promise<{
+export declare function runAddBlockCommand({ alternateRenderTargets, blockName, cwd, dataStorageMode, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, selectExternalLayerId, templateId, }: RunAddBlockCommandOptions): Promise<{
     blockSlugs: string[];
     projectDir: string;
     templateId: AddBlockTemplateId;