@wp-typia/project-tools 0.24.4 → 0.24.6

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

@@ -0,0 +1,5 @@
+export declare const PERSISTENCE_EDIT_TEMPLATE = "import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport { __ } from '@wordpress/i18n';\nimport {\n\tAlignmentToolbar,\n\tBlockControls,\n\tInspectorControls,\n\tRichText,\n\tuseBlockProps,\n} from '@wordpress/block-editor';\nimport {\n\tNotice,\n\tPanelBody,\n\tTextControl,\n} from '@wordpress/components';\nimport currentManifest from './manifest-document';\nimport {\n\tInspectorFromManifest,\n\tuseEditorFields,\n\tuseTypedAttributeUpdater,\n} from '@wp-typia/block-runtime/inspector';\nimport type { {{pascalCase}}Attributes } from './types';\nimport {\n\tsanitize{{pascalCase}}Attributes,\n\tvalidate{{pascalCase}}Attributes,\n} from './validators';\nimport { useTypiaValidation } from './hooks';\n\ntype EditProps = BlockEditProps< {{pascalCase}}Attributes >;\n\nexport default function Edit( {\n\tattributes,\n\tsetAttributes,\n}: EditProps ) {\n\tconst editorFields = useEditorFields(\n\t\tcurrentManifest,\n\t\t{\n\t\t\tmanual: [ 'content', 'resourceKey' ],\n\t\t\tlabels: {\n\t\t\t\tbuttonLabel: __( 'Button Label', '{{textDomain}}' ),\n\t\t\t\tresourceKey: __( 'Resource Key', '{{textDomain}}' ),\n\t\t\t\tshowCount: __( 'Show Count', '{{textDomain}}' ),\n\t\t\t},\n\t\t}\n\t);\n\tconst { errorMessages, isValid } = useTypiaValidation(\n\t\tattributes,\n\t\tvalidate{{pascalCase}}Attributes\n\t);\n\tconst validateEditorUpdate = (\n\t\tnextAttributes: {{pascalCase}}Attributes\n\t) => {\n\t\ttry {\n\t\t\treturn {\n\t\t\t\tdata: sanitize{{pascalCase}}Attributes( nextAttributes ),\n\t\t\t\terrors: [],\n\t\t\t\tisValid: true as const,\n\t\t\t};\n\t\t} catch {\n\t\t\treturn validate{{pascalCase}}Attributes( nextAttributes );\n\t\t}\n\t};\n\tconst { updateField } = useTypedAttributeUpdater(\n\t\tattributes,\n\t\tsetAttributes,\n\t\tvalidateEditorUpdate\n\t);\n\tconst alignmentValue = editorFields.getStringValue(\n\t\tattributes,\n\t\t'alignment',\n\t\t'left'\n\t);\n\tconst persistencePolicy = '{{persistencePolicy}}';\n\tconst persistencePolicyDescription = __(\n\t\t{{persistencePolicyDescriptionJson}},\n\t\t'{{textDomain}}'\n\t);\n\n\treturn (\n\t\t<>\n\t\t\t<BlockControls>\n\t\t\t\t<AlignmentToolbar\n\t\t\t\t\tvalue={ alignmentValue }\n\t\t\t\t\tonChange={ ( value ) =>\n\t\t\t\t\t\tupdateField(\n\t\t\t\t\t\t\t'alignment',\n\t\t\t\t\t\t\t( value || alignmentValue ) as NonNullable< {{pascalCase}}Attributes[ 'alignment' ] >\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t</BlockControls>\n\t\t\t<InspectorControls>\n\t\t\t\t<InspectorFromManifest\n\t\t\t\t\tattributes={ attributes }\n\t\t\t\t\tfieldLookup={ editorFields }\n\t\t\t\t\tonChange={ updateField }\n\t\t\t\t\tpaths={ [ 'alignment', 'isVisible', 'showCount', 'buttonLabel' ] }\n\t\t\t\t\ttitle={ __( 'Persistence Settings', '{{textDomain}}' ) }\n\t\t\t\t>\n\t\t\t\t\t<TextControl\n\t\t\t\t\t\tlabel={ __( 'Resource Key', '{{textDomain}}' ) }\n\t\t\t\t\t\tvalue={ attributes.resourceKey ?? '' }\n\t\t\t\t\t\tonChange={ ( value ) => updateField( 'resourceKey', value ) }\n\t\t\t\t\t\thelp={ __( 'Stable persisted identifier used by the storage-backed counter endpoint.', '{{textDomain}}' ) }\n\t\t\t\t\t/>\n\t\t\t\t\t<Notice status=\"info\" isDismissible={ false }>\n\t\t\t\t\t\t{ __( 'Storage mode: {{dataStorageMode}}', '{{textDomain}}' ) }\n\t\t\t\t\t</Notice>\n\t\t\t\t\t<Notice status=\"info\" isDismissible={ false }>\n\t\t\t\t\t\t{ __( 'Persistence policy: {{persistencePolicy}}', '{{textDomain}}' ) }\n\t\t\t\t\t\t<br />\n\t\t\t\t\t\t{ persistencePolicyDescription }\n\t\t\t\t\t</Notice>\n\t\t\t\t\t<Notice status=\"info\" isDismissible={ false }>\n\t\t\t\t\t\t{ __( '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}}' ) }\n\t\t\t\t\t</Notice>\n\t\t\t\t</InspectorFromManifest>\n\t\t\t\t{ ! isValid && (\n\t\t\t\t\t<PanelBody\n\t\t\t\t\t\ttitle={ __( 'Validation Errors', '{{textDomain}}' ) }\n\t\t\t\t\t\tinitialOpen\n\t\t\t\t\t>\n\t\t\t\t\t\t{ errorMessages.map( ( error, index ) => (\n\t\t\t\t\t\t\t<Notice key={ index } status=\"error\" isDismissible={ false }>\n\t\t\t\t\t\t\t\t{ error }\n\t\t\t\t\t\t\t</Notice>\n\t\t\t\t\t\t) ) }\n\t\t\t\t\t</PanelBody>\n\t\t\t\t) }\n\t\t\t</InspectorControls>\n\t\t\t<div\n\t\t\t\t{ ...useBlockProps( {\n\t\t\t\t\tclassName: '{{cssClassName}}',\n\t\t\t\t\tstyle: {\n\t\t\t\t\t\ttextAlign:\n\t\t\t\t\t\t\talignmentValue as NonNullable< {{pascalCase}}Attributes[ 'alignment' ] >,\n\t\t\t\t\t},\n\t\t\t\t} ) }\n\t\t\t>\n\t\t\t\t<RichText\n\t\t\t\t\ttagName=\"p\"\n\t\t\t\t\tvalue={ attributes.content }\n\t\t\t\t\tonChange={ ( value ) => updateField( 'content', value ) }\n\t\t\t\t\tplaceholder={ __( {{titleJson}} + ' persistence block', '{{textDomain}}' ) }\n\t\t\t\t/>\n\t\t\t\t<p className=\"{{cssClassName}}__meta\">\n\t\t\t\t\t{ __( 'Resource key:', '{{textDomain}}' ) } { attributes.resourceKey || '\u2014' }\n\t\t\t\t</p>\n\t\t\t\t<p className=\"{{cssClassName}}__meta\">\n\t\t\t\t\t{ __( 'Storage mode:', '{{textDomain}}' ) } {{dataStorageMode}}\n\t\t\t\t</p>\n\t\t\t\t<p className=\"{{cssClassName}}__meta\">\n\t\t\t\t\t{ __( 'Persistence policy:', '{{textDomain}}' ) } {{persistencePolicy}}\n\t\t\t\t</p>\n\t\t\t\t{ ! isValid && (\n\t\t\t\t\t<Notice status=\"error\" isDismissible={ false }>\n\t\t\t\t\t\t<ul>\n\t\t\t\t\t\t\t{ errorMessages.map( ( error, index ) => <li key={ index }>{ error }</li> ) }\n\t\t\t\t\t\t</ul>\n\t\t\t\t\t</Notice>\n\t\t\t\t) }\n\t\t\t</div>\n\t\t</>\n\t);\n}\n";
+export declare const PERSISTENCE_INDEX_TEMPLATE = "import {\n\tregisterScaffoldBlockType,\n\ttype BlockConfiguration,\n} from '@wp-typia/block-types/blocks/registration';\nimport {\n\tbuildScaffoldBlockRegistration,\n\tparseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './style.scss';\n\nimport type { {{pascalCase}}Attributes } from './types';\n\nconst registration = buildScaffoldBlockRegistration(\n\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}Attributes >>( metadata ),\n\t{\n\t\tedit: Edit,\n\t\tsave: Save,\n\t}\n);\n\nregisterScaffoldBlockType(registration.name, registration.settings);\n";
+export declare const PERSISTENCE_SAVE_TEMPLATE = "export default function Save() {\n\t// This block is intentionally server-rendered. PHP bootstraps post context,\n\t// storage-backed state, and write-policy data before the frontend hydrates.\n\treturn null;\n}\n";
+export declare const PERSISTENCE_VALIDATORS_TEMPLATE = "import typia from 'typia';\nimport currentManifest from './manifest-defaults-document';\nimport type {\n\t{{pascalCase}}Attributes,\n\t{{pascalCase}}ValidationResult,\n} from './types';\nimport { generateResourceKey } from '@wp-typia/block-runtime/identifiers';\nimport { createTemplateValidatorToolkit } from './validator-toolkit';\n\nconst scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}Attributes >( {\n\tassert: typia.createAssert< {{pascalCase}}Attributes >(),\n\tclone: typia.misc.createClone< {{pascalCase}}Attributes >() as (\n\t\tvalue: {{pascalCase}}Attributes,\n\t) => {{pascalCase}}Attributes,\n\tis: typia.createIs< {{pascalCase}}Attributes >(),\n\tmanifest: currentManifest,\n\tprune: typia.misc.createPrune< {{pascalCase}}Attributes >(),\n\trandom: typia.createRandom< {{pascalCase}}Attributes >() as (\n\t\t...args: unknown[]\n\t) => {{pascalCase}}Attributes,\n\tfinalize: ( normalized ) => ( {\n\t\t...normalized,\n\t\tresourceKey:\n\t\t\tnormalized.resourceKey && normalized.resourceKey.length > 0\n\t\t\t\t? normalized.resourceKey\n\t\t\t\t: generateResourceKey( '{{slugKebabCase}}' ),\n\t} ),\n\tvalidate: typia.createValidate< {{pascalCase}}Attributes >(),\n} );\n\nexport const validators = scaffoldValidators.validators;\n\nexport const validate{{pascalCase}}Attributes =\n\tscaffoldValidators.validateAttributes as (\n\t\tattributes: unknown\n\t) => {{pascalCase}}ValidationResult;\n\nexport const sanitize{{pascalCase}}Attributes =\n\tscaffoldValidators.sanitizeAttributes as (\n\t\tattributes: Partial< {{pascalCase}}Attributes >\n\t) => {{pascalCase}}Attributes;\n\nexport const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;\n";
+export declare const PERSISTENCE_INTERACTIVITY_TEMPLATE = "import { getContext, store } from '@wordpress/interactivity';\nimport { generatePublicWriteRequestId } from '@wp-typia/block-runtime/identifiers';\n\nimport { fetchBootstrap, fetchState, writeState } from './api';\nimport type {\n\t{{pascalCase}}ClientState,\n\t{{pascalCase}}Context,\n\t{{pascalCase}}State,\n} from './types';\nimport type {\n\t{{pascalCase}}WriteStateRequest,\n} from './api-types';\n\nfunction hasExpiredPublicWriteToken(\n\texpiresAt?: number\n): boolean {\n\treturn (\n\t\ttypeof expiresAt === 'number' &&\n\t\texpiresAt > 0 &&\n\t\tDate.now() >= expiresAt * 1000\n\t);\n}\n\nfunction getWriteBlockedMessage(\n\tcontext: {{pascalCase}}Context\n): string {\n\treturn context.persistencePolicy === 'authenticated'\n\t\t? 'Sign in to persist this counter.'\n\t\t: 'Public writes are temporarily unavailable.';\n}\n\nconst BOOTSTRAP_MAX_ATTEMPTS = 3;\nconst BOOTSTRAP_RETRY_DELAYS_MS = [ 250, 500 ];\n\nasync function waitForBootstrapRetry( delayMs: number ): Promise< void > {\n\tawait new Promise( ( resolve ) => {\n\t\tsetTimeout( resolve, delayMs );\n\t} );\n}\n\nfunction getClientState(\n\tcontext: {{pascalCase}}Context\n): {{pascalCase}}ClientState {\n\tif ( context.client ) {\n\t\treturn context.client;\n\t}\n\n\tcontext.client = {\n\t\tbootstrapError: '',\n\t\twriteExpiry: 0,\n\t\twriteNonce: '',\n\t\twriteToken: '',\n\t};\n\n\treturn context.client;\n}\n\nfunction clearBootstrapError(\n\tcontext: {{pascalCase}}Context,\n\tclientState: {{pascalCase}}ClientState\n): void {\n\tif ( context.error === clientState.bootstrapError ) {\n\t\tcontext.error = '';\n\t}\n\tclientState.bootstrapError = '';\n}\n\nfunction setBootstrapError(\n\tcontext: {{pascalCase}}Context,\n\tclientState: {{pascalCase}}ClientState,\n\tmessage: string\n): void {\n\tclientState.bootstrapError = message;\n\tcontext.error = message;\n}\n\nconst { actions, state } = store( '{{slugKebabCase}}', {\n\tstate: {\n\t\tisHydrated: false,\n\t} as {{pascalCase}}State,\n\n\tactions: {\n\t\tasync loadState() {\n\t\t\tconst context = getContext< {{pascalCase}}Context >();\n\t\t\tif ( context.postId <= 0 || ! context.resourceKey ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tcontext.isLoading = true;\n\t\t\tcontext.error = '';\n\n\t\t\ttry {\n\t\t\t\tconst result = await fetchState( {\n\t\t\t\t\tpostId: context.postId,\n\t\t\t\t\tresourceKey: context.resourceKey,\n\t\t\t\t}, {\n\t\t\t\t\ttransportTarget: 'frontend',\n\t\t\t\t} );\n\t\t\t\tif ( ! result.isValid || ! result.data ) {\n\t\t\t\t\tcontext.error = result.errors[ 0 ]?.expected ?? 'Unable to load counter';\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tcontext.count = result.data.count;\n\t\t\t} catch ( error ) {\n\t\t\t\tcontext.error =\n\t\t\t\t\terror instanceof Error ? error.message : 'Unknown loading error';\n\t\t\t} finally {\n\t\t\t\tcontext.isLoading = false;\n\t\t\t}\n\t\t},\n\t\tasync loadBootstrap() {\n\t\t\tconst context = getContext< {{pascalCase}}Context >();\n\t\t\tconst clientState = getClientState( context );\n\t\t\tif ( context.postId <= 0 || ! context.resourceKey ) {\n\t\t\t\tcontext.bootstrapReady = true;\n\t\t\t\tcontext.canWrite = false;\n\t\t\t\tclientState.bootstrapError = '';\n\t\t\t\tclientState.writeExpiry = 0;\n\t\t\t\tclientState.writeNonce = '';\n\t\t\t\tclientState.writeToken = '';\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tcontext.isBootstrapping = true;\n\n\t\t\tlet bootstrapSucceeded = false;\n\t\t\tlet lastBootstrapError =\n\t\t\t\t'Unable to initialize write access';\n\t\t\tconst includePublicWriteCredentials = {{isPublicPersistencePolicy}};\n\t\t\tconst includeRestNonce = {{isAuthenticatedPersistencePolicy}};\n\n\t\t\tfor ( let attempt = 1; attempt <= BOOTSTRAP_MAX_ATTEMPTS; attempt += 1 ) {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await fetchBootstrap( {\n\t\t\t\t\t\tpostId: context.postId,\n\t\t\t\t\t\tresourceKey: context.resourceKey,\n\t\t\t\t\t}, {\n\t\t\t\t\t\ttransportTarget: 'frontend',\n\t\t\t\t\t} );\n\t\t\t\t\tif ( ! result.isValid || ! result.data ) {\n\t\t\t\t\t\tlastBootstrapError =\n\t\t\t\t\t\t\tresult.errors[ 0 ]?.expected ??\n\t\t\t\t\t\t\t'Unable to initialize write access';\n\t\t\t\t\t\tif ( attempt < BOOTSTRAP_MAX_ATTEMPTS ) {\n\t\t\t\t\t\t\tawait waitForBootstrapRetry(\n\t\t\t\t\t\t\t\tBOOTSTRAP_RETRY_DELAYS_MS[ attempt - 1 ] ?? 750\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\n\t\t\t\t\tclientState.writeExpiry =\n\t\t\t\t\t\tincludePublicWriteCredentials &&\n\t\t\t\t\t\t'publicWriteExpiresAt' in result.data &&\n\t\t\t\t\t\ttypeof result.data.publicWriteExpiresAt === 'number' &&\n\t\t\t\t\t\tresult.data.publicWriteExpiresAt > 0\n\t\t\t\t\t\t\t? result.data.publicWriteExpiresAt\n\t\t\t\t\t\t\t: 0;\n\t\t\t\t\tclientState.writeToken =\n\t\t\t\t\t\tincludePublicWriteCredentials &&\n\t\t\t\t\t\t'publicWriteToken' in result.data &&\n\t\t\t\t\t\ttypeof result.data.publicWriteToken === 'string' &&\n\t\t\t\t\t\tresult.data.publicWriteToken.length > 0\n\t\t\t\t\t\t\t? result.data.publicWriteToken\n\t\t\t\t\t\t\t: '';\n\t\t\t\t\tclientState.writeNonce =\n\t\t\t\t\t\tincludeRestNonce &&\n\t\t\t\t\t\t'restNonce' in result.data &&\n\t\t\t\t\t\ttypeof result.data.restNonce === 'string' &&\n\t\t\t\t\t\tresult.data.restNonce.length > 0\n\t\t\t\t\t\t\t? result.data.restNonce\n\t\t\t\t\t\t\t: '';\n\t\t\t\t\tcontext.bootstrapReady = true;\n\t\t\t\t\tcontext.canWrite =\n\t\t\t\t\t\tresult.data.canWrite === true &&\n\t\t\t\t\t\t(\n\t\t\t\t\t\t\tcontext.persistencePolicy === 'authenticated'\n\t\t\t\t\t\t\t\t? clientState.writeNonce.length > 0\n\t\t\t\t\t\t\t\t: clientState.writeToken.length > 0 &&\n\t\t\t\t\t\t\t\t\t! hasExpiredPublicWriteToken( clientState.writeExpiry )\n\t\t\t\t\t\t);\n\t\t\t\t\tclearBootstrapError( context, clientState );\n\t\t\t\t\tbootstrapSucceeded = true;\n\t\t\t\t\tbreak;\n\t\t\t\t} catch ( error ) {\n\t\t\t\t\tlastBootstrapError =\n\t\t\t\t\t\terror instanceof Error ? error.message : 'Unknown bootstrap error';\n\t\t\t\t\tif ( attempt < BOOTSTRAP_MAX_ATTEMPTS ) {\n\t\t\t\t\t\tawait waitForBootstrapRetry(\n\t\t\t\t\t\t\tBOOTSTRAP_RETRY_DELAYS_MS[ attempt - 1 ] ?? 750\n\t\t\t\t\t\t);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ( ! bootstrapSucceeded ) {\n\t\t\t\tcontext.bootstrapReady = false;\n\t\t\t\tcontext.canWrite = false;\n\t\t\t\tclientState.writeExpiry = 0;\n\t\t\t\tclientState.writeNonce = '';\n\t\t\t\tclientState.writeToken = '';\n\t\t\t\tsetBootstrapError( context, clientState, lastBootstrapError );\n\t\t\t}\n\t\t\tcontext.isBootstrapping = false;\n\t\t},\n\t\tasync increment() {\n\t\t\tconst context = getContext< {{pascalCase}}Context >();\n\t\t\tconst clientState = getClientState( context );\n\t\t\tif ( context.postId <= 0 || ! context.resourceKey ) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif ( ! context.bootstrapReady ) {\n\t\t\t\tawait actions.loadBootstrap();\n\t\t\t}\n\t\t\tif ( ! context.bootstrapReady ) {\n\t\t\t\tcontext.error = 'Write access is still initializing.';\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (\n\t\t\t\tcontext.persistencePolicy === 'public' &&\n\t\t\t\thasExpiredPublicWriteToken( clientState.writeExpiry )\n\t\t\t) {\n\t\t\t\tawait actions.loadBootstrap();\n\t\t\t}\n\t\t\tif (\n\t\t\t\tcontext.persistencePolicy === 'public' &&\n\t\t\t\thasExpiredPublicWriteToken( clientState.writeExpiry )\n\t\t\t) {\n\t\t\t\tcontext.canWrite = false;\n\t\t\t\tcontext.error = getWriteBlockedMessage( context );\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif ( ! context.canWrite ) {\n\t\t\t\tcontext.error = getWriteBlockedMessage( context );\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tcontext.isSaving = true;\n\t\t\tcontext.error = '';\n\n\t\t\ttry {\n\t\t\t\tconst request = {\n\t\t\t\t\tdelta: 1,\n\t\t\t\t\tpostId: context.postId,\n\t\t\t\t\tresourceKey: context.resourceKey,\n\t\t\t\t} as {{pascalCase}}WriteStateRequest;\n\t\t\t\tif ( {{isPublicPersistencePolicy}} ) {\n\t\t\t\t\trequest.publicWriteRequestId =\n\t\t\t\t\t\tgeneratePublicWriteRequestId() as {{pascalCase}}WriteStateRequest[ 'publicWriteRequestId' ];\n\t\t\t\t\tif ( clientState.writeToken.length > 0 ) {\n\t\t\t\t\t\trequest.publicWriteToken =\n\t\t\t\t\t\t\tclientState.writeToken as {{pascalCase}}WriteStateRequest[ 'publicWriteToken' ];\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst result = await writeState( request, {\n\t\t\t\t\trestNonce:\n\t\t\t\t\t\tclientState.writeNonce.length > 0\n\t\t\t\t\t\t\t? clientState.writeNonce\n\t\t\t\t\t\t\t: undefined,\n\t\t\t\t\ttransportTarget: 'frontend',\n\t\t\t\t} );\n\t\t\t\tif ( ! result.isValid || ! result.data ) {\n\t\t\t\t\tcontext.error = result.errors[ 0 ]?.expected ?? 'Unable to update counter';\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tcontext.count = result.data.count;\n\t\t\t\tcontext.storage = result.data.storage;\n\t\t\t} catch ( error ) {\n\t\t\t\tcontext.error =\n\t\t\t\t\terror instanceof Error ? error.message : 'Unknown update error';\n\t\t\t} finally {\n\t\t\t\tcontext.isSaving = false;\n\t\t\t}\n\t\t},\n\t},\n\n\tcallbacks: {\n\t\tinit() {\n\t\t\tconst context = getContext< {{pascalCase}}Context >();\n\t\t\tcontext.client = {\n\t\t\t\tbootstrapError: '',\n\t\t\t\twriteExpiry: 0,\n\t\t\t\twriteNonce: '',\n\t\t\t\twriteToken: '',\n\t\t\t};\n\t\t\tcontext.bootstrapReady = false;\n\t\t\tcontext.canWrite = false;\n\t\t\tcontext.count = 0;\n\t\t\tcontext.error = '';\n\t\t\tcontext.isBootstrapping = false;\n\t\t\tcontext.isLoading = false;\n\t\t\tcontext.isSaving = false;\n\t\t},\n\t\tmounted() {\n\t\t\tstate.isHydrated = true;\n\t\t\tif ( typeof document !== 'undefined' ) {\n\t\t\t\tdocument.documentElement.dataset[ '{{slugCamelCase}}Hydrated' ] = 'true';\n\t\t\t}\n\t\t\tvoid Promise.allSettled( [\n\t\t\t\tactions.loadState(),\n\t\t\t\tactions.loadBootstrap(),\n\t\t\t] );\n\t\t},\n\t},\n} );\n";

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

@@ -0,0 +1,550 @@
+export const PERSISTENCE_EDIT_TEMPLATE = `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
+import { __ } from '@wordpress/i18n';
+import {
+	AlignmentToolbar,
+	BlockControls,
+	InspectorControls,
+	RichText,
+	useBlockProps,
+} from '@wordpress/block-editor';
+import {
+	Notice,
+	PanelBody,
+	TextControl,
+} from '@wordpress/components';
+import currentManifest from './manifest-document';
+import {
+	InspectorFromManifest,
+	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';
+
+type EditProps = BlockEditProps< {{pascalCase}}Attributes >;
+
+export default function Edit( {
+	attributes,
+	setAttributes,
+}: EditProps ) {
+	const editorFields = useEditorFields(
+		currentManifest,
+		{
+			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={ __( {{titleJson}} + ' 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>
+		</>
+	);
+}
+`;
+export const PERSISTENCE_INDEX_TEMPLATE = `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
+import {
+\tbuildScaffoldBlockRegistration,
+\tparseScaffoldBlockMetadata,
+} from '@wp-typia/block-runtime/blocks';
+
+import Edit from './edit';
+import Save from './save';
+import metadata from './block-metadata';
+import './style.scss';
+
+import type { {{pascalCase}}Attributes } from './types';
+
+const registration = buildScaffoldBlockRegistration(
+\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}Attributes >>( metadata ),
+\t{
+\t\tedit: Edit,
+\t\tsave: Save,
+\t}
+);
+
+registerScaffoldBlockType(registration.name, registration.settings);
+`;
+export const PERSISTENCE_SAVE_TEMPLATE = `export default function Save() {
+\t// This block is intentionally server-rendered. PHP bootstraps post context,
+\t// storage-backed state, and write-policy data before the frontend hydrates.
+\treturn null;
+}
+`;
+export const PERSISTENCE_VALIDATORS_TEMPLATE = `import typia from 'typia';
+import currentManifest from './manifest-defaults-document';
+import type {
+\t{{pascalCase}}Attributes,
+\t{{pascalCase}}ValidationResult,
+} from './types';
+import { generateResourceKey } from '@wp-typia/block-runtime/identifiers';
+import { createTemplateValidatorToolkit } from './validator-toolkit';
+
+const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}Attributes >( {
+\tassert: typia.createAssert< {{pascalCase}}Attributes >(),
+\tclone: typia.misc.createClone< {{pascalCase}}Attributes >() as (
+\t\tvalue: {{pascalCase}}Attributes,
+\t) => {{pascalCase}}Attributes,
+\tis: typia.createIs< {{pascalCase}}Attributes >(),
+\tmanifest: currentManifest,
+\tprune: typia.misc.createPrune< {{pascalCase}}Attributes >(),
+\trandom: typia.createRandom< {{pascalCase}}Attributes >() as (
+\t\t...args: unknown[]
+\t) => {{pascalCase}}Attributes,
+\tfinalize: ( normalized ) => ( {
+\t\t...normalized,
+\t\tresourceKey:
+\t\t\tnormalized.resourceKey && normalized.resourceKey.length > 0
+\t\t\t\t? normalized.resourceKey
+\t\t\t\t: generateResourceKey( '{{slugKebabCase}}' ),
+\t} ),
+\tvalidate: typia.createValidate< {{pascalCase}}Attributes >(),
+} );
+
+export const validators = scaffoldValidators.validators;
+
+export const validate{{pascalCase}}Attributes =
+\tscaffoldValidators.validateAttributes as (
+\t\tattributes: unknown
+\t) => {{pascalCase}}ValidationResult;
+
+export const sanitize{{pascalCase}}Attributes =
+\tscaffoldValidators.sanitizeAttributes as (
+\t\tattributes: Partial< {{pascalCase}}Attributes >
+\t) => {{pascalCase}}Attributes;
+
+export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;
+`;
+export const PERSISTENCE_INTERACTIVITY_TEMPLATE = `import { getContext, store } from '@wordpress/interactivity';
+import { generatePublicWriteRequestId } from '@wp-typia/block-runtime/identifiers';
+
+import { fetchBootstrap, fetchState, writeState } from './api';
+import type {
+\t{{pascalCase}}ClientState,
+\t{{pascalCase}}Context,
+\t{{pascalCase}}State,
+} from './types';
+import type {
+\t{{pascalCase}}WriteStateRequest,
+} from './api-types';
+
+function hasExpiredPublicWriteToken(
+\texpiresAt?: number
+): boolean {
+\treturn (
+\t\ttypeof expiresAt === 'number' &&
+\t\texpiresAt > 0 &&
+\t\tDate.now() >= expiresAt * 1000
+\t);
+}
+
+function getWriteBlockedMessage(
+\tcontext: {{pascalCase}}Context
+): string {
+\treturn context.persistencePolicy === 'authenticated'
+\t\t? 'Sign in to persist this counter.'
+\t\t: 'Public writes are temporarily unavailable.';
+}
+
+const BOOTSTRAP_MAX_ATTEMPTS = 3;
+const BOOTSTRAP_RETRY_DELAYS_MS = [ 250, 500 ];
+
+async function waitForBootstrapRetry( delayMs: number ): Promise< void > {
+\tawait new Promise( ( resolve ) => {
+\t\tsetTimeout( resolve, delayMs );
+\t} );
+}
+
+function getClientState(
+\tcontext: {{pascalCase}}Context
+): {{pascalCase}}ClientState {
+\tif ( context.client ) {
+\t\treturn context.client;
+\t}
+
+\tcontext.client = {
+\t\tbootstrapError: '',
+\t\twriteExpiry: 0,
+\t\twriteNonce: '',
+\t\twriteToken: '',
+\t};
+
+\treturn context.client;
+}
+
+function clearBootstrapError(
+\tcontext: {{pascalCase}}Context,
+\tclientState: {{pascalCase}}ClientState
+): void {
+\tif ( context.error === clientState.bootstrapError ) {
+\t\tcontext.error = '';
+\t}
+\tclientState.bootstrapError = '';
+}
+
+function setBootstrapError(
+\tcontext: {{pascalCase}}Context,
+\tclientState: {{pascalCase}}ClientState,
+\tmessage: string
+): void {
+\tclientState.bootstrapError = message;
+\tcontext.error = message;
+}
+
+const { actions, state } = store( '{{slugKebabCase}}', {
+\tstate: {
+\t\tisHydrated: false,
+\t} as {{pascalCase}}State,
+
+\tactions: {
+\t\tasync loadState() {
+\t\t\tconst context = getContext< {{pascalCase}}Context >();
+\t\t\tif ( context.postId <= 0 || ! context.resourceKey ) {
+\t\t\t\treturn;
+\t\t\t}
+
+\t\t\tcontext.isLoading = true;
+\t\t\tcontext.error = '';
+
+\t\t\ttry {
+\t\t\t\tconst result = await fetchState( {
+\t\t\t\t\tpostId: context.postId,
+\t\t\t\t\tresourceKey: context.resourceKey,
+\t\t\t\t}, {
+\t\t\t\t\ttransportTarget: 'frontend',
+\t\t\t\t} );
+\t\t\t\tif ( ! result.isValid || ! result.data ) {
+\t\t\t\t\tcontext.error = result.errors[ 0 ]?.expected ?? 'Unable to load counter';
+\t\t\t\t\treturn;
+\t\t\t\t}
+\t\t\t\tcontext.count = result.data.count;
+\t\t\t} catch ( error ) {
+\t\t\t\tcontext.error =
+\t\t\t\t\terror instanceof Error ? error.message : 'Unknown loading error';
+\t\t\t} finally {
+\t\t\t\tcontext.isLoading = false;
+\t\t\t}
+\t\t},
+\t\tasync loadBootstrap() {
+\t\t\tconst context = getContext< {{pascalCase}}Context >();
+\t\t\tconst clientState = getClientState( context );
+\t\t\tif ( context.postId <= 0 || ! context.resourceKey ) {
+\t\t\t\tcontext.bootstrapReady = true;
+\t\t\t\tcontext.canWrite = false;
+\t\t\t\tclientState.bootstrapError = '';
+\t\t\t\tclientState.writeExpiry = 0;
+\t\t\t\tclientState.writeNonce = '';
+\t\t\t\tclientState.writeToken = '';
+\t\t\t\treturn;
+\t\t\t}
+
+\t\t\tcontext.isBootstrapping = true;
+
+\t\t\tlet bootstrapSucceeded = false;
+\t\t\tlet lastBootstrapError =
+\t\t\t\t'Unable to initialize write access';
+\t\t\tconst includePublicWriteCredentials = {{isPublicPersistencePolicy}};
+\t\t\tconst includeRestNonce = {{isAuthenticatedPersistencePolicy}};
+
+\t\t\tfor ( let attempt = 1; attempt <= BOOTSTRAP_MAX_ATTEMPTS; attempt += 1 ) {
+\t\t\t\ttry {
+\t\t\t\t\tconst result = await fetchBootstrap( {
+\t\t\t\t\t\tpostId: context.postId,
+\t\t\t\t\t\tresourceKey: context.resourceKey,
+\t\t\t\t\t}, {
+\t\t\t\t\t\ttransportTarget: 'frontend',
+\t\t\t\t\t} );
+\t\t\t\t\tif ( ! result.isValid || ! result.data ) {
+\t\t\t\t\t\tlastBootstrapError =
+\t\t\t\t\t\t\tresult.errors[ 0 ]?.expected ??
+\t\t\t\t\t\t\t'Unable to initialize write access';
+\t\t\t\t\t\tif ( attempt < BOOTSTRAP_MAX_ATTEMPTS ) {
+\t\t\t\t\t\t\tawait waitForBootstrapRetry(
+\t\t\t\t\t\t\t\tBOOTSTRAP_RETRY_DELAYS_MS[ attempt - 1 ] ?? 750
+\t\t\t\t\t\t\t);
+\t\t\t\t\t\t\tcontinue;
+\t\t\t\t\t\t}
+\t\t\t\t\t\tbreak;
+\t\t\t\t\t}
+
+\t\t\t\t\tclientState.writeExpiry =
+\t\t\t\t\t\tincludePublicWriteCredentials &&
+\t\t\t\t\t\t'publicWriteExpiresAt' in result.data &&
+\t\t\t\t\t\ttypeof result.data.publicWriteExpiresAt === 'number' &&
+\t\t\t\t\t\tresult.data.publicWriteExpiresAt > 0
+\t\t\t\t\t\t\t? result.data.publicWriteExpiresAt
+\t\t\t\t\t\t\t: 0;
+\t\t\t\t\tclientState.writeToken =
+\t\t\t\t\t\tincludePublicWriteCredentials &&
+\t\t\t\t\t\t'publicWriteToken' in result.data &&
+\t\t\t\t\t\ttypeof result.data.publicWriteToken === 'string' &&
+\t\t\t\t\t\tresult.data.publicWriteToken.length > 0
+\t\t\t\t\t\t\t? result.data.publicWriteToken
+\t\t\t\t\t\t\t: '';
+\t\t\t\t\tclientState.writeNonce =
+\t\t\t\t\t\tincludeRestNonce &&
+\t\t\t\t\t\t'restNonce' in result.data &&
+\t\t\t\t\t\ttypeof result.data.restNonce === 'string' &&
+\t\t\t\t\t\tresult.data.restNonce.length > 0
+\t\t\t\t\t\t\t? result.data.restNonce
+\t\t\t\t\t\t\t: '';
+\t\t\t\t\tcontext.bootstrapReady = true;
+\t\t\t\t\tcontext.canWrite =
+\t\t\t\t\t\tresult.data.canWrite === true &&
+\t\t\t\t\t\t(
+\t\t\t\t\t\t\tcontext.persistencePolicy === 'authenticated'
+\t\t\t\t\t\t\t\t? clientState.writeNonce.length > 0
+\t\t\t\t\t\t\t\t: clientState.writeToken.length > 0 &&
+\t\t\t\t\t\t\t\t\t! hasExpiredPublicWriteToken( clientState.writeExpiry )
+\t\t\t\t\t\t);
+\t\t\t\t\tclearBootstrapError( context, clientState );
+\t\t\t\t\tbootstrapSucceeded = true;
+\t\t\t\t\tbreak;
+\t\t\t\t} catch ( error ) {
+\t\t\t\t\tlastBootstrapError =
+\t\t\t\t\t\terror instanceof Error ? error.message : 'Unknown bootstrap error';
+\t\t\t\t\tif ( attempt < BOOTSTRAP_MAX_ATTEMPTS ) {
+\t\t\t\t\t\tawait waitForBootstrapRetry(
+\t\t\t\t\t\t\tBOOTSTRAP_RETRY_DELAYS_MS[ attempt - 1 ] ?? 750
+\t\t\t\t\t\t);
+\t\t\t\t\t\tcontinue;
+\t\t\t\t\t}
+\t\t\t\t\tbreak;
+\t\t\t\t}
+\t\t\t}
+
+\t\t\tif ( ! bootstrapSucceeded ) {
+\t\t\t\tcontext.bootstrapReady = false;
+\t\t\t\tcontext.canWrite = false;
+\t\t\t\tclientState.writeExpiry = 0;
+\t\t\t\tclientState.writeNonce = '';
+\t\t\t\tclientState.writeToken = '';
+\t\t\t\tsetBootstrapError( context, clientState, lastBootstrapError );
+\t\t\t}
+\t\t\tcontext.isBootstrapping = false;
+\t\t},
+\t\tasync increment() {
+\t\t\tconst context = getContext< {{pascalCase}}Context >();
+\t\t\tconst clientState = getClientState( context );
+\t\t\tif ( context.postId <= 0 || ! context.resourceKey ) {
+\t\t\t\treturn;
+\t\t\t}
+\t\t\tif ( ! context.bootstrapReady ) {
+\t\t\t\tawait actions.loadBootstrap();
+\t\t\t}
+\t\t\tif ( ! context.bootstrapReady ) {
+\t\t\t\tcontext.error = 'Write access is still initializing.';
+\t\t\t\treturn;
+\t\t\t}
+\t\t\tif (
+\t\t\t\tcontext.persistencePolicy === 'public' &&
+\t\t\t\thasExpiredPublicWriteToken( clientState.writeExpiry )
+\t\t\t) {
+\t\t\t\tawait actions.loadBootstrap();
+\t\t\t}
+\t\t\tif (
+\t\t\t\tcontext.persistencePolicy === 'public' &&
+\t\t\t\thasExpiredPublicWriteToken( clientState.writeExpiry )
+\t\t\t) {
+\t\t\t\tcontext.canWrite = false;
+\t\t\t\tcontext.error = getWriteBlockedMessage( context );
+\t\t\t\treturn;
+\t\t\t}
+\t\t\tif ( ! context.canWrite ) {
+\t\t\t\tcontext.error = getWriteBlockedMessage( context );
+\t\t\t\treturn;
+\t\t\t}
+
+\t\t\tcontext.isSaving = true;
+\t\t\tcontext.error = '';
+
+\t\t\ttry {
+\t\t\t\tconst request = {
+\t\t\t\t\tdelta: 1,
+\t\t\t\t\tpostId: context.postId,
+\t\t\t\t\tresourceKey: context.resourceKey,
+\t\t\t\t} as {{pascalCase}}WriteStateRequest;
+\t\t\t\tif ( {{isPublicPersistencePolicy}} ) {
+\t\t\t\t\trequest.publicWriteRequestId =
+\t\t\t\t\t\tgeneratePublicWriteRequestId() as {{pascalCase}}WriteStateRequest[ 'publicWriteRequestId' ];
+\t\t\t\t\tif ( clientState.writeToken.length > 0 ) {
+\t\t\t\t\t\trequest.publicWriteToken =
+\t\t\t\t\t\t\tclientState.writeToken as {{pascalCase}}WriteStateRequest[ 'publicWriteToken' ];
+\t\t\t\t\t}
+\t\t\t\t}
+\t\t\t\tconst result = await writeState( request, {
+\t\t\t\t\trestNonce:
+\t\t\t\t\t\tclientState.writeNonce.length > 0
+\t\t\t\t\t\t\t? clientState.writeNonce
+\t\t\t\t\t\t\t: undefined,
+\t\t\t\t\ttransportTarget: 'frontend',
+\t\t\t\t} );
+\t\t\t\tif ( ! result.isValid || ! result.data ) {
+\t\t\t\t\tcontext.error = result.errors[ 0 ]?.expected ?? 'Unable to update counter';
+\t\t\t\t\treturn;
+\t\t\t\t}
+\t\t\t\tcontext.count = result.data.count;
+\t\t\t\tcontext.storage = result.data.storage;
+\t\t\t} catch ( error ) {
+\t\t\t\tcontext.error =
+\t\t\t\t\terror instanceof Error ? error.message : 'Unknown update error';
+\t\t\t} finally {
+\t\t\t\tcontext.isSaving = false;
+\t\t\t}
+\t\t},
+\t},
+
+\tcallbacks: {
+\t\tinit() {
+\t\t\tconst context = getContext< {{pascalCase}}Context >();
+\t\t\tcontext.client = {
+\t\t\t\tbootstrapError: '',
+\t\t\t\twriteExpiry: 0,
+\t\t\t\twriteNonce: '',
+\t\t\t\twriteToken: '',
+\t\t\t};
+\t\t\tcontext.bootstrapReady = false;
+\t\t\tcontext.canWrite = false;
+\t\t\tcontext.count = 0;
+\t\t\tcontext.error = '';
+\t\t\tcontext.isBootstrapping = false;
+\t\t\tcontext.isLoading = false;
+\t\t\tcontext.isSaving = false;
+\t\t},
+\t\tmounted() {
+\t\t\tstate.isHydrated = true;
+\t\t\tif ( typeof document !== 'undefined' ) {
+\t\t\t\tdocument.documentElement.dataset[ '{{slugCamelCase}}Hydrated' ] = 'true';
+\t\t\t}
+\t\t\tvoid Promise.allSettled( [
+\t\t\t\tactions.loadState(),
+\t\t\t\tactions.loadBootstrap(),
+\t\t\t] );
+\t\t},
+\t},
+} );
+`;

package/dist/runtime/templates/built-in-block-code-templates/query-loop.d.ts

@@ -0,0 +1 @@
+export declare const QUERY_LOOP_INDEX_TEMPLATE = "import { registerBlockVariation } from '@wordpress/blocks';\nimport type { BlockVariation } from '@wp-typia/block-types/blocks/registration';\nimport { __ } from '@wordpress/i18n';\nimport {\n  getQueryLoopCustomAllowedControls,\n  getQueryLoopCustomQuerySeed,\n  registerQueryLoopEditorExtensions,\n} from './query-extension';\n\ntype QueryLoopVariationAttributes = {\n  namespace?: string;\n  query?: {\n    inherit?: boolean;\n    order?: 'asc' | 'desc';\n    orderBy?: string;\n    perPage?: number;\n    postType?: string;\n    wpTypiaVariation?: string;\n    [key: string]: unknown;\n  };\n};\n\ntype QueryLoopVariation = BlockVariation<QueryLoopVariationAttributes> & {\n  allowedControls: string[];\n};\n\nconst VARIATION_NAME = {{queryVariationNamespaceJson}};\nconst DEFAULT_ALLOWED_CONTROLS = {{queryAllowedControlsJson}};\nconst customQuerySeed = getQueryLoopCustomQuerySeed();\nconst allowedControls = Array.from(\n  new Set([...DEFAULT_ALLOWED_CONTROLS, ...getQueryLoopCustomAllowedControls()]),\n);\n\nconst queryLoopVariation = {\n  name: VARIATION_NAME,\n  title: __({{titleJson}}, '{{textDomain}}'),\n  description: __({{descriptionJson}}, '{{textDomain}}'),\n  scope: ['inserter'],\n  isActive: ['namespace'],\n  attributes: {\n    namespace: VARIATION_NAME,\n    query: {\n      inherit: false,\n      order: 'desc',\n      orderBy: 'date',\n      perPage: 6,\n      postType: {{queryPostTypeJson}},\n      ...customQuerySeed,\n      wpTypiaVariation: VARIATION_NAME,\n    },\n  },\n  allowedControls,\n  innerBlocks: [\n    [\n      'core/post-template',\n      {},\n      [\n        ['core/post-featured-image'],\n        ['core/post-title', { isLink: true }],\n        ['core/post-excerpt'],\n      ],\n    ],\n    ['core/query-pagination'],\n    ['core/query-no-results'],\n  ],\n} satisfies QueryLoopVariation;\n\nregisterBlockVariation('core/query', queryLoopVariation);\nregisterQueryLoopEditorExtensions({ variationName: VARIATION_NAME });\n";

package/dist/runtime/templates/built-in-block-code-templates/query-loop.js

@@ -0,0 +1,70 @@
+export const QUERY_LOOP_INDEX_TEMPLATE = `import { registerBlockVariation } from '@wordpress/blocks';
+import type { BlockVariation } from '@wp-typia/block-types/blocks/registration';
+import { __ } from '@wordpress/i18n';
+import {
+  getQueryLoopCustomAllowedControls,
+  getQueryLoopCustomQuerySeed,
+  registerQueryLoopEditorExtensions,
+} from './query-extension';
+
+type QueryLoopVariationAttributes = {
+  namespace?: string;
+  query?: {
+    inherit?: boolean;
+    order?: 'asc' | 'desc';
+    orderBy?: string;
+    perPage?: number;
+    postType?: string;
+    wpTypiaVariation?: string;
+    [key: string]: unknown;
+  };
+};
+
+type QueryLoopVariation = BlockVariation<QueryLoopVariationAttributes> & {
+  allowedControls: string[];
+};
+
+const VARIATION_NAME = {{queryVariationNamespaceJson}};
+const DEFAULT_ALLOWED_CONTROLS = {{queryAllowedControlsJson}};
+const customQuerySeed = getQueryLoopCustomQuerySeed();
+const allowedControls = Array.from(
+  new Set([...DEFAULT_ALLOWED_CONTROLS, ...getQueryLoopCustomAllowedControls()]),
+);
+
+const queryLoopVariation = {
+  name: VARIATION_NAME,
+  title: __({{titleJson}}, '{{textDomain}}'),
+  description: __({{descriptionJson}}, '{{textDomain}}'),
+  scope: ['inserter'],
+  isActive: ['namespace'],
+  attributes: {
+    namespace: VARIATION_NAME,
+    query: {
+      inherit: false,
+      order: 'desc',
+      orderBy: 'date',
+      perPage: 6,
+      postType: {{queryPostTypeJson}},
+      ...customQuerySeed,
+      wpTypiaVariation: VARIATION_NAME,
+    },
+  },
+  allowedControls,
+  innerBlocks: [
+    [
+      'core/post-template',
+      {},
+      [
+        ['core/post-featured-image'],
+        ['core/post-title', { isLink: true }],
+        ['core/post-excerpt'],
+      ],
+    ],
+    ['core/query-pagination'],
+    ['core/query-no-results'],
+  ],
+} satisfies QueryLoopVariation;
+
+registerBlockVariation('core/query', queryLoopVariation);
+registerQueryLoopEditorExtensions({ variationName: VARIATION_NAME });
+`;

package/dist/runtime/templates/built-in-block-code-templates/shared.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Template for the shared validation hooks module used by built-in scaffolds.
+ */
+export declare const SHARED_HOOKS_TEMPLATE = "import { useMemo } from '@wordpress/element';\n\nimport {\n\tcreateUseTypiaValidationHook,\n\tformatValidationError,\n\tformatValidationErrors,\n} from '@wp-typia/block-runtime/validation';\n\nexport {\n\tformatValidationError,\n\tformatValidationErrors,\n\ttype TypiaValidationError,\n\ttype ValidationResult,\n\ttype ValidationState,\n} from '@wp-typia/block-runtime/validation';\n\nexport const useTypiaValidation = createUseTypiaValidationHook( {\n\tuseMemo,\n} );\n";
+/**
+ * Template for the generated block metadata wrapper around `block.json`.
+ */
+export declare const BLOCK_METADATA_WRAPPER_TEMPLATE = "import rawMetadata from './block.json';\nimport { defineScaffoldBlockMetadata } from '@wp-typia/block-runtime/blocks';\n\nconst metadata = defineScaffoldBlockMetadata(rawMetadata);\n\nexport default metadata;\n";
+/**
+ * Template for the generated manifest document wrapper around `typia.manifest.json`.
+ */
+export declare const MANIFEST_DOCUMENT_WRAPPER_TEMPLATE = "import rawCurrentManifest from './typia.manifest.json';\nimport { defineManifestDocument } from '@wp-typia/block-runtime/editor';\n\nconst currentManifest = defineManifestDocument(rawCurrentManifest);\n\nexport default currentManifest;\n";
+/**
+ * Template for the generated manifest-defaults wrapper used by validators.
+ */
+export declare const MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEMPLATE = "import rawCurrentManifest from './typia.manifest.json';\nimport { defineManifestDefaultsDocument } from '@wp-typia/block-runtime/defaults';\n\nconst currentManifest = defineManifestDefaultsDocument(rawCurrentManifest);\n\nexport default currentManifest;\n";