@wp-typia/project-tools 0.16.2 → 0.16.5

package/templates/interactivity/src/types.ts.mustache

@@ -1,32 +0,0 @@
-import type { TextAlignment } from "@wp-typia/block-types/block-editor/alignment";
-import type {
-  TypiaValidationError,
-  ValidationResult,
-} from "@wp-typia/block-runtime/validation";
-import { tags } from "typia";
-
-export type { TypiaValidationError, ValidationResult } from "@wp-typia/block-runtime/validation";
-
-export interface {{pascalCase}}Attributes {
-  content: string & tags.MinLength<1> & tags.MaxLength<1000> & tags.Default<"">;
-  alignment?: TextAlignment & tags.Default<"left">;
-  isVisible?: boolean & tags.Default<true>;
-  interactiveMode?: ('click' | 'hover' | 'auto') & tags.Default<"click">;
-  animation?: ('none' | 'bounce' | 'pulse' | 'shake' | 'flip') & tags.Default<"none">;
-  clickCount?: number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<0>;
-  isAnimating?: boolean & tags.Default<false>;
-  showCounter?: boolean & tags.Default<true>;
-  maxClicks?: number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<10>;
-  autoPlayInterval?: number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<0>;
-  uniqueId?: string & tags.Default<"">;
-}
-
-export interface {{pascalCase}}Context {
-  clicks: number;
-  isAnimating: boolean;
-  isVisible: boolean;
-  lastInteraction: string;
-  animationClass: string;
-}
-
-export type {{pascalCase}}ValidationResult = ValidationResult<{{pascalCase}}Attributes>;

package/templates/interactivity/src/validators.ts.mustache

@@ -1,47 +0,0 @@
-import typia from 'typia';
-import currentManifest from "./typia.manifest.json";
-import { {{pascalCase}}Attributes, {{pascalCase}}ValidationResult } from "./types";
-import { generateScopedClientId } from "@wp-typia/block-runtime/identifiers";
-import { createTemplateValidatorToolkit } from "./validator-toolkit";
-
-const scaffoldValidators = createTemplateValidatorToolkit<{{pascalCase}}Attributes>({
-  assert: typia.createAssert<{{pascalCase}}Attributes>(),
-  clone: typia.misc.createClone<{{pascalCase}}Attributes>() as (
-    value: {{pascalCase}}Attributes,
-  ) => {{pascalCase}}Attributes,
-  is: typia.createIs<{{pascalCase}}Attributes>(),
-  manifest: currentManifest,
-  prune: typia.misc.createPrune<{{pascalCase}}Attributes>(),
-  random: typia.createRandom<{{pascalCase}}Attributes>() as (
-    ...args: unknown[]
-  ) => {{pascalCase}}Attributes,
-  finalize: (normalized) => ({
-    ...normalized,
-    uniqueId:
-      normalized.uniqueId && normalized.uniqueId.length > 0
-        ? normalized.uniqueId
-        : generateScopedClientId("{{slugKebabCase}}"),
-  }),
-  validate: typia.createValidate<{{pascalCase}}Attributes>(),
-});
-
-export const validate{{pascalCase}}Attributes =
-  scaffoldValidators.validateAttributes as (
-    attributes: unknown,
-  ) => {{pascalCase}}ValidationResult;
-
-export const validators = scaffoldValidators.validators;
-
-export const sanitize{{pascalCase}}Attributes =
-  scaffoldValidators.sanitizeAttributes as (
-    attributes: Partial<{{pascalCase}}Attributes>,
-  ) => {{pascalCase}}Attributes;
-
-/**
- * Runtime type guard for checking if an object is {{pascalCase}}Attributes.
- */
-export const is{{pascalCase}}Attributes = (obj: unknown): obj is {{pascalCase}}Attributes => {
-  return validators.is(obj);
-};
-
-export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;

package/templates/persistence/src/block.json.mustache

@@ -1,52 +0,0 @@
-{
-	"$schema": "https://schemas.wp.org/trunk/block.json",
-	"apiVersion": 3,
-	"name": "{{namespace}}/{{slugKebabCase}}",
-	"version": "{{blockMetadataVersion}}",
-	"title": "{{title}}",
-	"category": "{{category}}",
-	"icon": "{{icon}}",
-	"description": "{{description}}",
-	"example": {},
-	"supports": {
-		"html": false,
-		"align": true,
-		"anchor": true,
-		"className": true,
-		"interactivity": true
-	},
-	"attributes": {
-		"content": {
-			"type": "string",
-			"source": "html",
-			"selector": ".{{cssClassName}}__content",
-			"default": "{{title}} persistence block"
-		},
-		"alignment": {
-			"type": "string",
-			"enum": ["left", "center", "right"],
-			"default": "left"
-		},
-		"isVisible": {
-			"type": "boolean",
-			"default": true
-		},
-		"showCount": {
-			"type": "boolean",
-			"default": true
-		},
-		"buttonLabel": {
-			"type": "string",
-			"default": "Persist Count"
-		},
-		"resourceKey": {
-			"type": "string",
-			"default": ""
-		}
-	},
-	"textdomain": "{{textDomain}}",
-	"editorScript": "file:./index.js",
-	"style": "file:./style-index.css",
-	"viewScriptModule": "file:./interactivity.js",
-	"render": "file:./render.php"
-}

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

@@ -1,165 +0,0 @@
-import { __ } from '@wordpress/i18n';
-import {
-	AlignmentToolbar,
-	BlockControls,
-	InspectorControls,
-	RichText,
-	useBlockProps,
-} from '@wordpress/block-editor';
-import {
-	Notice,
-	PanelBody,
-	TextControl,
-} from '@wordpress/components';
-import currentManifest from './typia.manifest.json';
-import {
-	InspectorFromManifest,
-	type ManifestDocument,
-	useEditorFields,
-	useTypedAttributeUpdater,
-} from '@wp-typia/block-runtime/inspector';
-import type { {{pascalCase}}Attributes } from './types';
-import {
-	sanitize{{pascalCase}}Attributes,
-	validate{{pascalCase}}Attributes,
-} from './validators';
-import { useTypiaValidation } from './hooks';
-
-export default function Edit( {
-	attributes,
-	setAttributes,
-}: {
-	attributes: {{pascalCase}}Attributes;
-	setAttributes: ( attrs: Partial< {{pascalCase}}Attributes > ) => void;
-} ) {
-	const editorFields = useEditorFields(
-		currentManifest as ManifestDocument,
-		{
-			manual: [ 'content', 'resourceKey' ],
-			labels: {
-				buttonLabel: __( 'Button Label', '{{textDomain}}' ),
-				resourceKey: __( 'Resource Key', '{{textDomain}}' ),
-				showCount: __( 'Show Count', '{{textDomain}}' ),
-			},
-		}
-	);
-	const { errorMessages, isValid } = useTypiaValidation(
-		attributes,
-		validate{{pascalCase}}Attributes
-	);
-	const validateEditorUpdate = (
-		nextAttributes: {{pascalCase}}Attributes
-	) => {
-		try {
-			return {
-				data: sanitize{{pascalCase}}Attributes( nextAttributes ),
-				errors: [],
-				isValid: true as const,
-			};
-		} catch {
-			return validate{{pascalCase}}Attributes( nextAttributes );
-		}
-	};
-	const { updateField } = useTypedAttributeUpdater(
-		attributes,
-		setAttributes,
-		validateEditorUpdate
-	);
-	const alignmentValue = editorFields.getStringValue(
-		attributes,
-		'alignment',
-		'left'
-	);
-	const persistencePolicy = '{{persistencePolicy}}';
-	const persistencePolicyDescription = __(
-		{{persistencePolicyDescriptionJson}},
-		'{{textDomain}}'
-	);
-
-	return (
-		<>
-			<BlockControls>
-				<AlignmentToolbar
-					value={ alignmentValue }
-					onChange={ ( value ) =>
-						updateField(
-							'alignment',
-							( value || alignmentValue ) as NonNullable< {{pascalCase}}Attributes[ 'alignment' ] >
-						)
-					}
-				/>
-			</BlockControls>
-			<InspectorControls>
-				<InspectorFromManifest
-					attributes={ attributes }
-					fieldLookup={ editorFields }
-					onChange={ updateField }
-					paths={ [ 'alignment', 'isVisible', 'showCount', 'buttonLabel' ] }
-					title={ __( 'Persistence Settings', '{{textDomain}}' ) }
-				>
-					<TextControl
-						label={ __( 'Resource Key', '{{textDomain}}' ) }
-						value={ attributes.resourceKey ?? '' }
-						onChange={ ( value ) => updateField( 'resourceKey', value ) }
-						help={ __( 'Stable persisted identifier used by the storage-backed counter endpoint.', '{{textDomain}}' ) }
-					/>
-					<Notice status="info" isDismissible={ false }>
-						{ __( 'Storage mode: {{dataStorageMode}}', '{{textDomain}}' ) }
-					</Notice>
-					<Notice status="info" isDismissible={ false }>
-						{ __( 'Persistence policy: {{persistencePolicy}}', '{{textDomain}}' ) }
-						<br />
-						{ persistencePolicyDescription }
-					</Notice>
-					<Notice status="info" isDismissible={ false }>
-						{ __( 'Render mode: dynamic. `render.php` bootstraps durable post context, while fresh session-only write data is loaded from the dedicated `/bootstrap` endpoint after hydration.', '{{textDomain}}' ) }
-					</Notice>
-				</InspectorFromManifest>
-				{ ! isValid && (
-					<PanelBody
-						title={ __( 'Validation Errors', '{{textDomain}}' ) }
-						initialOpen
-					>
-						{ errorMessages.map( ( error, index ) => (
-							<Notice key={ index } status="error" isDismissible={ false }>
-								{ error }
-							</Notice>
-						) ) }
-					</PanelBody>
-				) }
-			</InspectorControls>
-			<div
-				{ ...useBlockProps( {
-					className: '{{cssClassName}}',
-					style: {
-						textAlign:
-							alignmentValue as NonNullable< {{pascalCase}}Attributes[ 'alignment' ] >,
-					},
-				} ) }
-			>
-				<RichText
-					tagName="p"
-					value={ attributes.content }
-					onChange={ ( value ) => updateField( 'content', value ) }
-					placeholder={ __( '{{title}} persistence block', '{{textDomain}}' ) }
-				/>
-				<p className="{{cssClassName}}__meta">
-					{ __( 'Resource key:', '{{textDomain}}' ) } { attributes.resourceKey || '—' }
-				</p>
-				<p className="{{cssClassName}}__meta">
-					{ __( 'Storage mode:', '{{textDomain}}' ) } {{dataStorageMode}}
-				</p>
-				<p className="{{cssClassName}}__meta">
-					{ __( 'Persistence policy:', '{{textDomain}}' ) } {{persistencePolicy}}
-				</p>
-				{ ! isValid && (
-					<Notice status="error" isDismissible={ false }>
-						<ul>
-							{ errorMessages.map( ( error, index ) => <li key={ index }>{ error }</li> ) }
-						</ul>
-					</Notice>
-				) }
-			</div>
-		</>
-	);
-}

package/templates/persistence/src/render.php.mustache

@@ -1,120 +0,0 @@
-<?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>

package/templates/persistence/src/style.scss.mustache

@@ -1,46 +0,0 @@
-.{{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;
-	}
-}

package/templates/persistence/src/types.ts.mustache

@@ -1,59 +0,0 @@
-import type { TextAlignment } from '@wp-typia/block-types/block-editor/alignment';
-import type {
-	TypiaValidationError,
-	ValidationResult,
-} from '@wp-typia/block-runtime/validation';
-import { tags } from 'typia';
-
-export type {
-	TypiaValidationError,
-	ValidationResult,
-} from '@wp-typia/block-runtime/validation';
-
-export interface {{pascalCase}}Attributes {
-	content: string &
-		tags.MinLength< 1 > &
-		tags.MaxLength< 250 > &
-		tags.Default< '{{title}} persistence block' >;
-	alignment?: TextAlignment & tags.Default< 'left' >;
-	isVisible?: boolean & tags.Default< true >;
-	showCount?: boolean & tags.Default< true >;
-	buttonLabel?: string &
-		tags.MinLength< 1 > &
-		tags.MaxLength< 40 > &
-		tags.Default< 'Persist Count' >;
-	resourceKey?: string &
-		tags.MinLength< 1 > &
-		tags.MaxLength< 100 > &
-		tags.Default< 'primary' >;
-}
-
-export interface {{pascalCase}}Context {
-	buttonLabel: string;
-	bootstrapReady: boolean;
-	canWrite: boolean;
-	count: number;
-	error: string;
-	isBootstrapping: boolean;
-	isLoading: boolean;
-	isSaving: boolean;
-	persistencePolicy: 'authenticated' | 'public';
-	postId: number;
-	resourceKey: string;
-	storage: 'post-meta' | 'custom-table';
-	isVisible: boolean;
-	client?: {{pascalCase}}ClientState;
-}
-
-export interface {{pascalCase}}State {
-	isHydrated: boolean;
-}
-
-export interface {{pascalCase}}ClientState {
-	bootstrapError: string;
-	writeExpiry: number;
-	writeNonce: string;
-	writeToken: string;
-}
-
-export type {{pascalCase}}ValidationResult = ValidationResult< {{pascalCase}}Attributes >;