@wp-typia/project-tools 0.16.9 → 0.16.11

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

@@ -116,6 +116,36 @@ function defineNumberAttribute(spec) {
         sourceType: "number",
     });
 }
+function resolveBuiltInAttributeValue(value, context) {
+    if (typeof value === "function") {
+        return value(context);
+    }
+    return value;
+}
+function buildAttributesFromSpecs(specs, context) {
+    return specs.map((spec) => {
+        const resolvedSpec = {
+            blockJsonDefaultValue: resolveBuiltInAttributeValue(spec.blockJsonDefaultValue, context),
+            constraints: resolveBuiltInAttributeValue(spec.constraints, context),
+            defaultValue: resolveBuiltInAttributeValue(spec.defaultValue, context),
+            description: resolveBuiltInAttributeValue(spec.description, context),
+            enumValues: resolveBuiltInAttributeValue(spec.enumValues, context),
+            manifestDefaultValue: resolveBuiltInAttributeValue(spec.manifestDefaultValue, context),
+            name: spec.name,
+            optional: spec.optional,
+            selector: resolveBuiltInAttributeValue(spec.selector, context),
+            source: resolveBuiltInAttributeValue(spec.source, context),
+            typeExpression: resolveBuiltInAttributeValue(spec.typeExpression, context) ?? "unknown",
+        };
+        if (spec.attributeType === "boolean") {
+            return defineBooleanAttribute(resolvedSpec);
+        }
+        if (spec.attributeType === "number") {
+            return defineNumberAttribute(resolvedSpec);
+        }
+        return defineStringAttribute(resolvedSpec);
+    });
+}
 function buildManifestDocument(sourceType, attributes) {
     return {
         attributes: Object.fromEntries(attributes.map((attribute) => [
@@ -175,289 +205,327 @@ function emitTypesModule({ preambleLines, interfaces, typeAliases, }) {
 function stringifyBlockJsonDocument(document) {
     return `${JSON.stringify(document, null, "\t")}\n`;
 }
+const BASIC_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 1000,
+        },
+        defaultValue: "",
+        description: describe("Main block content"),
+        name: "content",
+        optional: false,
+        typeExpression: 'string & tags.MaxLength<1000> & tags.Default<"">',
+    },
+    {
+        attributeType: "string",
+        defaultValue: "left",
+        description: describe("Alignment"),
+        enumValues: [...BASIC_ALIGNMENT_VALUES],
+        name: "alignment",
+        optional: true,
+        typeExpression: 'TextAlignment & tags.Default<"left">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        description: describe("Visibility toggle"),
+        name: "isVisible",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 100,
+        },
+        defaultValue: "",
+        description: describe("Custom CSS class"),
+        name: "className",
+        optional: true,
+        typeExpression: 'string & tags.MaxLength<100> & tags.Default<"">',
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            format: "uuid",
+        },
+        description: describe("Generated runtime ID"),
+        name: "id",
+        optional: true,
+        typeExpression: 'string & tags.Format<"uuid">',
+    },
+    {
+        attributeType: "number",
+        constraints: {
+            typeTag: "uint32",
+        },
+        defaultValue: 1,
+        description: describe("Block version for migrations"),
+        name: "schemaVersion",
+        optional: true,
+        typeExpression: 'number & tags.Type<"uint32"> & tags.Default<1>',
+    },
+];
+const INTERACTIVITY_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 1000,
+        },
+        defaultValue: "",
+        name: "content",
+        optional: false,
+        selector: (variables) => `.${variables.cssClassName}__content`,
+        source: "html",
+        typeExpression: 'string & tags.MaxLength<1000> & tags.Default<"">',
+    },
+    {
+        attributeType: "string",
+        defaultValue: "left",
+        enumValues: [...ALIGNMENT_VALUES],
+        name: "alignment",
+        optional: true,
+        typeExpression: 'TextAlignment & tags.Default<"left">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "isVisible",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        defaultValue: "click",
+        enumValues: [...INTERACTIVE_MODE_VALUES],
+        name: "interactiveMode",
+        optional: true,
+        typeExpression: '("click" | "hover") & tags.Default<"click">',
+    },
+    {
+        attributeType: "string",
+        defaultValue: "none",
+        enumValues: [...ANIMATION_VALUES],
+        name: "animation",
+        optional: true,
+        typeExpression: '("none" | "bounce" | "pulse" | "shake" | "flip") & tags.Default<"none">',
+    },
+    {
+        attributeType: "number",
+        constraints: {
+            minimum: 0,
+            typeTag: "uint32",
+        },
+        defaultValue: 0,
+        name: "clickCount",
+        optional: true,
+        typeExpression: 'number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<0>',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: false,
+        name: "isAnimating",
+        optional: true,
+        typeExpression: "boolean & tags.Default<false>",
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showCounter",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "number",
+        constraints: {
+            minimum: 0,
+            typeTag: "uint32",
+        },
+        defaultValue: 10,
+        name: "maxClicks",
+        optional: true,
+        typeExpression: 'number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<10>',
+    },
+];
+const PERSISTENCE_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 250,
+            minLength: 1,
+        },
+        defaultValue: (variables) => `${variables.title} persistence block`,
+        name: "content",
+        optional: false,
+        selector: (variables) => `.${variables.cssClassName}__content`,
+        source: "html",
+        typeExpression: (variables) => `string & tags.MinLength<1> & tags.MaxLength<250> & tags.Default<${quote(`${variables.title} persistence block`)}>`,
+    },
+    {
+        attributeType: "string",
+        defaultValue: "left",
+        enumValues: [...ALIGNMENT_VALUES],
+        name: "alignment",
+        optional: true,
+        typeExpression: 'TextAlignment & tags.Default<"left">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "isVisible",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showCount",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 40,
+            minLength: 1,
+        },
+        defaultValue: "Persist Count",
+        name: "buttonLabel",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<40> & tags.Default<"Persist Count">',
+    },
+    {
+        attributeType: "string",
+        blockJsonDefaultValue: "",
+        constraints: {
+            maxLength: 100,
+            minLength: 1,
+        },
+        manifestDefaultValue: "primary",
+        name: "resourceKey",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<100> & tags.Default<"primary">',
+    },
+];
+const COMPOUND_PARENT_BASE_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 80,
+            minLength: 1,
+        },
+        defaultValue: (variables) => variables.title,
+        name: "heading",
+        optional: false,
+        selector: (variables) => `.${variables.cssClassName}__heading`,
+        source: "html",
+        typeExpression: (variables) => `string & tags.MinLength<1> & tags.MaxLength<80> & tags.Default<${quote(variables.title)}>`,
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 180,
+            minLength: 1,
+        },
+        defaultValue: "Add and reorder internal items inside this compound block.",
+        name: "intro",
+        optional: true,
+        selector: (variables) => `.${variables.cssClassName}__intro`,
+        source: "html",
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<180> & tags.Default<"Add and reorder internal items inside this compound block.">',
+    },
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showDividers",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+];
+const COMPOUND_PARENT_PERSISTENCE_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "boolean",
+        defaultValue: true,
+        name: "showCount",
+        optional: true,
+        typeExpression: "boolean & tags.Default<true>",
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 40,
+            minLength: 1,
+        },
+        defaultValue: "Persist Count",
+        name: "buttonLabel",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<40> & tags.Default<"Persist Count">',
+    },
+    {
+        attributeType: "string",
+        blockJsonDefaultValue: "",
+        constraints: {
+            maxLength: 100,
+            minLength: 1,
+        },
+        manifestDefaultValue: "primary",
+        name: "resourceKey",
+        optional: true,
+        typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<100> & tags.Default<"primary">',
+    },
+];
+const COMPOUND_CHILD_ATTRIBUTE_SPECS = [
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 80,
+            minLength: 1,
+        },
+        defaultValue: ({ childTitle }) => childTitle,
+        name: "title",
+        optional: false,
+        selector: ({ childCssClassName }) => childCssClassName ? `.${childCssClassName}__title` : null,
+        source: ({ childCssClassName }) => childCssClassName ? "html" : null,
+        typeExpression: ({ childTitle }) => `string & tags.MinLength<1> & tags.MaxLength<80> & tags.Default<${quote(childTitle)}>`,
+    },
+    {
+        attributeType: "string",
+        constraints: {
+            maxLength: 280,
+            minLength: 1,
+        },
+        defaultValue: ({ bodyPlaceholder }) => bodyPlaceholder,
+        name: "body",
+        optional: false,
+        selector: ({ childCssClassName }) => childCssClassName ? `.${childCssClassName}__body` : null,
+        source: ({ childCssClassName }) => childCssClassName ? "html" : null,
+        typeExpression: ({ bodyPlaceholder }) => `string & tags.MinLength<1> & tags.MaxLength<280> & tags.Default<${quote(bodyPlaceholder)}>`,
+    },
+];
 function buildBasicAttributes() {
-    return [
-        defineStringAttribute({
-            constraints: {
-                maxLength: 1000,
-            },
-            defaultValue: "",
-            description: describe("Main block content"),
-            name: "content",
-            optional: false,
-            typeExpression: 'string & tags.MaxLength<1000> & tags.Default<"">',
-        }),
-        defineStringAttribute({
-            defaultValue: "left",
-            description: describe("Alignment"),
-            enumValues: [...BASIC_ALIGNMENT_VALUES],
-            name: "alignment",
-            optional: true,
-            typeExpression: 'TextAlignment & tags.Default<"left">',
-        }),
-        defineBooleanAttribute({
-            defaultValue: true,
-            description: describe("Visibility toggle"),
-            name: "isVisible",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }),
-        defineStringAttribute({
-            constraints: {
-                maxLength: 100,
-            },
-            defaultValue: "",
-            description: describe("Custom CSS class"),
-            name: "className",
-            optional: true,
-            typeExpression: 'string & tags.MaxLength<100> & tags.Default<"">',
-        }),
-        defineStringAttribute({
-            constraints: {
-                format: "uuid",
-            },
-            description: describe("Generated runtime ID"),
-            name: "id",
-            optional: true,
-            typeExpression: 'string & tags.Format<"uuid">',
-        }),
-        defineNumberAttribute({
-            constraints: {
-                typeTag: "uint32",
-            },
-            defaultValue: 1,
-            description: describe("Block version for migrations"),
-            name: "schemaVersion",
-            optional: true,
-            typeExpression: 'number & tags.Type<"uint32"> & tags.Default<1>',
-        }),
-    ];
+    return buildAttributesFromSpecs(BASIC_ATTRIBUTE_SPECS, undefined);
 }
 function buildInteractivityAttributes(variables) {
-    return [
-        defineStringAttribute({
-            constraints: {
-                maxLength: 1000,
-            },
-            defaultValue: "",
-            name: "content",
-            optional: false,
-            selector: `.${variables.cssClassName}__content`,
-            source: "html",
-            typeExpression: 'string & tags.MaxLength<1000> & tags.Default<"">',
-        }),
-        defineStringAttribute({
-            defaultValue: "left",
-            enumValues: [...ALIGNMENT_VALUES],
-            name: "alignment",
-            optional: true,
-            typeExpression: 'TextAlignment & tags.Default<"left">',
-        }),
-        defineBooleanAttribute({
-            defaultValue: true,
-            name: "isVisible",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }),
-        defineStringAttribute({
-            defaultValue: "click",
-            enumValues: [...INTERACTIVE_MODE_VALUES],
-            name: "interactiveMode",
-            optional: true,
-            typeExpression: '("click" | "hover") & tags.Default<"click">',
-        }),
-        defineStringAttribute({
-            defaultValue: "none",
-            enumValues: [...ANIMATION_VALUES],
-            name: "animation",
-            optional: true,
-            typeExpression: '("none" | "bounce" | "pulse" | "shake" | "flip") & tags.Default<"none">',
-        }),
-        defineNumberAttribute({
-            constraints: {
-                minimum: 0,
-                typeTag: "uint32",
-            },
-            defaultValue: 0,
-            name: "clickCount",
-            optional: true,
-            typeExpression: 'number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<0>',
-        }),
-        defineBooleanAttribute({
-            defaultValue: false,
-            name: "isAnimating",
-            optional: true,
-            typeExpression: "boolean & tags.Default<false>",
-        }),
-        defineBooleanAttribute({
-            defaultValue: true,
-            name: "showCounter",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }),
-        defineNumberAttribute({
-            constraints: {
-                minimum: 0,
-                typeTag: "uint32",
-            },
-            defaultValue: 10,
-            name: "maxClicks",
-            optional: true,
-            typeExpression: 'number & tags.Minimum<0> & tags.Type<"uint32"> & tags.Default<10>',
-        }),
-    ];
+    return buildAttributesFromSpecs(INTERACTIVITY_ATTRIBUTE_SPECS, variables);
 }
 function buildPersistenceAttributes(variables) {
-    return [
-        defineStringAttribute({
-            constraints: {
-                maxLength: 250,
-                minLength: 1,
-            },
-            defaultValue: `${variables.title} persistence block`,
-            name: "content",
-            optional: false,
-            selector: `.${variables.cssClassName}__content`,
-            source: "html",
-            typeExpression: `string & tags.MinLength<1> & tags.MaxLength<250> & tags.Default<${quote(`${variables.title} persistence block`)}>`,
-        }),
-        defineStringAttribute({
-            defaultValue: "left",
-            enumValues: [...ALIGNMENT_VALUES],
-            name: "alignment",
-            optional: true,
-            typeExpression: 'TextAlignment & tags.Default<"left">',
-        }),
-        defineBooleanAttribute({
-            defaultValue: true,
-            name: "isVisible",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }),
-        defineBooleanAttribute({
-            defaultValue: true,
-            name: "showCount",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }),
-        defineStringAttribute({
-            constraints: {
-                maxLength: 40,
-                minLength: 1,
-            },
-            defaultValue: "Persist Count",
-            name: "buttonLabel",
-            optional: true,
-            typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<40> & tags.Default<"Persist Count">',
-        }),
-        defineStringAttribute({
-            blockJsonDefaultValue: "",
-            constraints: {
-                maxLength: 100,
-                minLength: 1,
-            },
-            manifestDefaultValue: "primary",
-            name: "resourceKey",
-            optional: true,
-            typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<100> & tags.Default<"primary">',
-        }),
-    ];
+    return buildAttributesFromSpecs(PERSISTENCE_ATTRIBUTE_SPECS, variables);
 }
 function buildCompoundParentAttributes(variables) {
-    const attributes = [
-        defineStringAttribute({
-            constraints: {
-                maxLength: 80,
-                minLength: 1,
-            },
-            defaultValue: variables.title,
-            name: "heading",
-            optional: false,
-            selector: `.${variables.cssClassName}__heading`,
-            source: "html",
-            typeExpression: `string & tags.MinLength<1> & tags.MaxLength<80> & tags.Default<${quote(variables.title)}>`,
-        }),
-        defineStringAttribute({
-            constraints: {
-                maxLength: 180,
-                minLength: 1,
-            },
-            defaultValue: "Add and reorder internal items inside this compound block.",
-            name: "intro",
-            optional: true,
-            selector: `.${variables.cssClassName}__intro`,
-            source: "html",
-            typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<180> & tags.Default<"Add and reorder internal items inside this compound block.">',
-        }),
-        defineBooleanAttribute({
-            defaultValue: true,
-            name: "showDividers",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }),
-    ];
-    if (variables.compoundPersistenceEnabled === "true") {
-        attributes.push(defineBooleanAttribute({
-            defaultValue: true,
-            name: "showCount",
-            optional: true,
-            typeExpression: "boolean & tags.Default<true>",
-        }), defineStringAttribute({
-            constraints: {
-                maxLength: 40,
-                minLength: 1,
-            },
-            defaultValue: "Persist Count",
-            name: "buttonLabel",
-            optional: true,
-            typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<40> & tags.Default<"Persist Count">',
-        }), defineStringAttribute({
-            blockJsonDefaultValue: "",
-            constraints: {
-                maxLength: 100,
-                minLength: 1,
-            },
-            manifestDefaultValue: "primary",
-            name: "resourceKey",
-            optional: true,
-            typeExpression: 'string & tags.MinLength<1> & tags.MaxLength<100> & tags.Default<"primary">',
-        }));
-    }
-    return attributes;
+    return buildAttributesFromSpecs(variables.compoundPersistenceEnabled === "true"
+        ? [
+            ...COMPOUND_PARENT_BASE_ATTRIBUTE_SPECS,
+            ...COMPOUND_PARENT_PERSISTENCE_ATTRIBUTE_SPECS,
+        ]
+        : COMPOUND_PARENT_BASE_ATTRIBUTE_SPECS, variables);
 }
 function buildCompoundChildAttributes(bodyPlaceholder = DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER, childTitle, childCssClassName) {
-    const titleSelector = childCssClassName
-        ? `.${childCssClassName}__title`
-        : null;
-    const bodySelector = childCssClassName
-        ? `.${childCssClassName}__body`
-        : null;
-    return [
-        defineStringAttribute({
-            constraints: {
-                maxLength: 80,
-                minLength: 1,
-            },
-            defaultValue: childTitle,
-            name: "title",
-            optional: false,
-            selector: titleSelector,
-            source: titleSelector ? "html" : null,
-            typeExpression: `string & tags.MinLength<1> & tags.MaxLength<80> & tags.Default<${quote(childTitle)}>`,
-        }),
-        defineStringAttribute({
-            constraints: {
-                maxLength: 280,
-                minLength: 1,
-            },
-            defaultValue: bodyPlaceholder,
-            name: "body",
-            optional: false,
-            selector: bodySelector,
-            source: bodySelector ? "html" : null,
-            typeExpression: `string & tags.MinLength<1> & tags.MaxLength<280> & tags.Default<${quote(bodyPlaceholder)}>`,
-        }),
-    ];
+    return buildAttributesFromSpecs(COMPOUND_CHILD_ATTRIBUTE_SPECS, {
+        bodyPlaceholder,
+        childCssClassName,
+        childTitle,
+    });
 }
 function buildBasicTypesSource(variables, attributes) {
     return emitTypesModule({

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

@@ -8,27 +8,27 @@ export declare const MANIFEST_DOCUMENT_WRAPPER_TEMPLATE = "import rawCurrentMani
 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";
 export declare const BASIC_EDIT_TEMPLATE = "/**\n * Editor component for {{title}} Block\n */\n\nimport type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport {\n  InspectorControls,\n  RichText,\n  useBlockProps,\n} from '@wordpress/block-editor';\nimport { Notice, PanelBody, TextControl } from '@wordpress/components';\nimport { __ } from '@wordpress/i18n';\nimport currentManifest from './manifest-document';\nimport {\n  InspectorFromManifest,\n  useEditorFields,\n  useTypedAttributeUpdater,\n} from '@wp-typia/block-runtime/inspector';\nimport { {{pascalCase}}Attributes } from './types';\nimport {\n  sanitize{{pascalCase}}Attributes,\n  validate{{pascalCase}}Attributes,\n} from './validators';\nimport { useTypiaValidation } from './hooks';\n\ntype EditProps = BlockEditProps<{{pascalCase}}Attributes>;\n\nconst validationErrorItemStyle = { color: '#cc1818', fontSize: '12px' };\nconst validationListStyle = { margin: 0, paddingLeft: '1em' };\n\nfunction Edit({ attributes, setAttributes }: EditProps) {\n  const isVisible = attributes.isVisible !== false;\n  const blockProps = useBlockProps({\n    className: `{{cssClassName}}${isVisible ? '' : ' is-hidden'}`,\n  });\n  const editorFields = useEditorFields(currentManifest, {\n    hidden: ['id', 'schemaVersion'],\n    manual: ['content'],\n    labels: {\n      alignment: __('Alignment', '{{textDomain}}'),\n      className: __('CSS Class', '{{textDomain}}'),\n      content: __('Content', '{{textDomain}}'),\n      isVisible: __('Visible', '{{textDomain}}'),\n    },\n  });\n  const classNameField = editorFields.getField('className');\n  const { errorMessages, isValid } = useTypiaValidation(\n    attributes,\n    validate{{pascalCase}}Attributes\n  );\n  const validateEditorUpdate = (nextAttributes: {{pascalCase}}Attributes) => {\n    try {\n      return {\n        data: sanitize{{pascalCase}}Attributes(nextAttributes),\n        errors: [],\n        isValid: true as const,\n      };\n    } catch {\n      return validate{{pascalCase}}Attributes(nextAttributes);\n    }\n  };\n  const { updateField } = useTypedAttributeUpdater(\n    attributes,\n    setAttributes,\n    validateEditorUpdate\n  );\n\n  return (\n    <>\n      <InspectorControls>\n        <InspectorFromManifest\n          attributes={attributes}\n          fieldLookup={editorFields}\n          onChange={updateField}\n          paths={['alignment', 'isVisible']}\n          title={__('Settings', '{{textDomain}}')}\n        >\n          <TextControl\n            label={__('Content', '{{textDomain}}')}\n            value={attributes.content || ''}\n            onChange={(value) => updateField('content', value)}\n            help={__('Mirrors the main block content.', '{{textDomain}}')}\n          />\n\n          <TextControl\n            label={classNameField?.label || __('CSS Class', '{{textDomain}}')}\n            value={attributes.className || ''}\n            onChange={(value) => updateField('className', value)}\n            help={__('Add an optional CSS class name.', '{{textDomain}}')}\n          />\n        </InspectorFromManifest>\n\n        {!isValid && (\n          <PanelBody title={__('Validation Errors', '{{textDomain}}')} initialOpen>\n            {errorMessages.map((error, index) => (\n              <div key={index} style={validationErrorItemStyle}>\n                \u2022 {error}\n              </div>\n            ))}\n          </PanelBody>\n        )}\n      </InspectorControls>\n\n      <div {...blockProps}>\n        <div className=\"{{cssClassName}}__content\">\n          <RichText\n            tagName=\"p\"\n            value={attributes.content || ''}\n            onChange={(value) => updateField('content', value)}\n            placeholder={__('Add your content...', '{{textDomain}}')}\n          />\n        </div>\n        {!isValid && (\n          <Notice status=\"error\" isDismissible={false}>\n            <p>\n              <strong>{__('Validation Errors', '{{textDomain}}')}</strong>\n            </p>\n            <ul style={validationListStyle}>\n              {errorMessages.map((error, index) => (\n                <li key={index}>{error}</li>\n              ))}\n            </ul>\n          </Notice>\n        )}\n      </div>\n    </>\n  );\n}\n\nexport default Edit;\n";
 export declare const BASIC_SAVE_TEMPLATE = "/**\n * Save/Frontend component for {{title}} Block\n */\n\nimport { RichText, useBlockProps } from '@wordpress/block-editor';\nimport { {{pascalCase}}Attributes } from './types';\n\ninterface SaveProps {\n  attributes: {{pascalCase}}Attributes;\n}\n\nexport default function Save({ attributes }: SaveProps) {\n  const isVisible = attributes.isVisible !== false;\n  const blockProps = useBlockProps.save({\n    className: `{{cssClassName}}${isVisible ? '' : ' is-hidden'}`,\n    hidden: isVisible ? undefined : true,\n    'aria-hidden': isVisible ? undefined : 'true',\n  });\n\n  return (\n    <div {...blockProps}>\n      <div\n        className=\"{{cssClassName}}__content\"\n        data-align={attributes.alignment || 'left'}\n      >\n        <RichText.Content tagName=\"p\" value={attributes.content} />\n      </div>\n    </div>\n  );\n}\n";
-export declare const BASIC_INDEX_TEMPLATE = "/**\n * WordPress {{title}} Block\n *\n * Typia-powered type-safe block\n */\n\nimport { registerBlockType } from '@wordpress/blocks';\nimport type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';\nimport type { BlockSupports } from '@wp-typia/block-types/blocks/supports';\nimport { __ } from '@wordpress/i18n';\nimport {\n  buildScaffoldBlockRegistration,\n  parseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\n// Import components\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './editor.scss';\nimport './style.scss';\n\n// Import types\nimport { {{pascalCase}}Attributes } from './types';\nimport { validators } from './validators';\n\nconst scaffoldSupports = {\n  html: false,\n  multiple: true,\n  align: ['wide', 'full'],\n} satisfies BlockSupports;\n\n// Register the block\nconst registration = buildScaffoldBlockRegistration(\n  parseScaffoldBlockMetadata<BlockConfiguration<{{pascalCase}}Attributes>>(metadata),\n  {\n    supports: scaffoldSupports,\n    example: {\n      attributes: validators.random(),\n    },\n    edit: Edit,\n    save: Save,\n  }\n);\n\nregisterBlockType<{{pascalCase}}Attributes>(registration.name, registration.settings);\n";
+export declare const BASIC_INDEX_TEMPLATE = "/**\n * WordPress {{title}} Block\n *\n * Typia-powered type-safe block\n */\n\nimport {\n  registerScaffoldBlockType,\n  type BlockConfiguration,\n} from '@wp-typia/block-types/blocks/registration';\nimport type { BlockSupports } from '@wp-typia/block-types/blocks/supports';\nimport { __ } from '@wordpress/i18n';\nimport {\n  buildScaffoldBlockRegistration,\n  parseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\n// Import components\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './editor.scss';\nimport './style.scss';\n\n// Import types\nimport { {{pascalCase}}Attributes } from './types';\nimport { validators } from './validators';\n\nconst scaffoldSupports = {\n  html: false,\n  multiple: true,\n  align: ['wide', 'full'],\n} satisfies BlockSupports;\n\n// Register the block\nconst registration = buildScaffoldBlockRegistration(\n  parseScaffoldBlockMetadata<BlockConfiguration<{{pascalCase}}Attributes>>(metadata),\n  {\n    supports: scaffoldSupports,\n    example: {\n      attributes: validators.random(),\n    },\n    edit: Edit,\n    save: Save,\n  }\n);\n\nregisterScaffoldBlockType(registration.name, registration.settings);\n";
 export declare const BASIC_VALIDATORS_TEMPLATE = "import typia from 'typia';\nimport currentManifest from \"./manifest-defaults-document\";\nimport { {{pascalCase}}Attributes, {{pascalCase}}ValidationResult } from \"./types\";\nimport { generateBlockId } from \"@wp-typia/block-runtime/identifiers\";\nimport { createTemplateValidatorToolkit } from \"./validator-toolkit\";\n\nconst scaffoldValidators = createTemplateValidatorToolkit<{{pascalCase}}Attributes>({\n  assert: typia.createAssert<{{pascalCase}}Attributes>(),\n  clone: typia.misc.createClone<{{pascalCase}}Attributes>() as (\n    value: {{pascalCase}}Attributes,\n  ) => {{pascalCase}}Attributes,\n  is: typia.createIs<{{pascalCase}}Attributes>(),\n  manifest: currentManifest,\n  prune: typia.misc.createPrune<{{pascalCase}}Attributes>(),\n  random: typia.createRandom<{{pascalCase}}Attributes>() as (\n    ...args: unknown[]\n  ) => {{pascalCase}}Attributes,\n  finalize: (normalized) => ({\n    ...normalized,\n    id: normalized.id && normalized.id.length > 0 ? normalized.id : generateBlockId(),\n  }),\n  validate: typia.createValidate<{{pascalCase}}Attributes>(),\n});\n\nexport const validate{{pascalCase}}Attributes =\n  scaffoldValidators.validateAttributes as (\n    attributes: unknown,\n  ) => {{pascalCase}}ValidationResult;\n\nexport const validators = scaffoldValidators.validators;\n\nexport const sanitize{{pascalCase}}Attributes =\n  scaffoldValidators.sanitizeAttributes as (\n    attributes: Partial<{{pascalCase}}Attributes>,\n  ) => {{pascalCase}}Attributes;\n\nexport const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;\n";
 export declare const INTERACTIVITY_EDIT_TEMPLATE = "import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport { __ } from '@wordpress/i18n';\nimport { useBlockProps, InspectorControls, RichText, BlockControls, AlignmentToolbar } from '@wordpress/block-editor';\nimport { PanelBody, RangeControl, Button, Notice } from '@wordpress/components';\nimport { useState } from '@wordpress/element';\nimport currentManifest from './manifest-document';\nimport {\n  InspectorFromManifest,\n  useEditorFields,\n  useTypedAttributeUpdater,\n} from '@wp-typia/block-runtime/inspector';\nimport type { {{pascalCase}}Attributes } from './types';\nimport {\n  sanitize{{pascalCase}}Attributes,\n  validate{{pascalCase}}Attributes,\n} from './validators';\nimport { useTypiaValidation } from './hooks';\n\ntype EditProps = BlockEditProps<{{pascalCase}}Attributes>;\n\nconst actionButtonRowStyle = { display: 'flex', gap: '8px', marginTop: '16px' };\nconst validationListStyle = { margin: 0, paddingLeft: '1em' };\n\nexport default function Edit({ attributes, setAttributes, isSelected }: EditProps) {\n  const [isPreviewing, setIsPreviewing] = useState(false);\n  const editorFields = useEditorFields(currentManifest, {\n    manual: ['content', 'clickCount', 'maxClicks'],\n    labels: {\n      alignment: __('Alignment', '{{textDomain}}'),\n      animation: __('Animation', '{{textDomain}}'),\n      interactiveMode: __('Interactive Mode', '{{textDomain}}'),\n      isVisible: __('Visible', '{{textDomain}}'),\n      showCounter: __('Show Counter', '{{textDomain}}'),\n    },\n  });\n  const { errorMessages, isValid } = useTypiaValidation(\n    attributes,\n    validate{{pascalCase}}Attributes,\n  );\n  const validateEditorUpdate = (nextAttributes: {{pascalCase}}Attributes) => {\n    try {\n      return {\n        data: sanitize{{pascalCase}}Attributes(nextAttributes),\n        errors: [],\n        isValid: true as const,\n      };\n    } catch {\n      return validate{{pascalCase}}Attributes(nextAttributes);\n    }\n  };\n  const { updateField } = useTypedAttributeUpdater(\n    attributes,\n    setAttributes,\n    validateEditorUpdate\n  );\n  const alignmentValue = editorFields.getStringValue(\n    attributes,\n    'alignment',\n    'left'\n  ) as NonNullable<{{pascalCase}}Attributes['alignment']>;\n  const clickCount = attributes.clickCount ?? 0;\n  const isVisible = editorFields.getBooleanValue(\n    attributes,\n    'isVisible',\n    true\n  );\n  const isAnimating = attributes.isAnimating ?? false;\n  const maxClicks = attributes.maxClicks ?? 0;\n  const showCounter = editorFields.getBooleanValue(\n    attributes,\n    'showCounter',\n    true\n  );\n  const interactiveMode = editorFields.getStringValue(\n    attributes,\n    'interactiveMode',\n    'click'\n  ) as NonNullable<{{pascalCase}}Attributes['interactiveMode']>;\n  const animation = editorFields.getStringValue(\n    attributes,\n    'animation',\n    'none'\n  ) as NonNullable<{{pascalCase}}Attributes['animation']>;\n\n  const blockProps = useBlockProps({\n    className: `{{cssClassName}} {{cssClassName}}--${interactiveMode}`,\n    'data-wp-interactive': '{{slugKebabCase}}',\n    'data-wp-context': JSON.stringify({\n      clicks: clickCount,\n      isAnimating,\n      isVisible,\n      animation,\n      maxClicks,\n    })\n  });\n  const previewContentStyle = { textAlign: alignmentValue };\n  const progressBarStyle = { width: `${(clickCount / maxClicks) * 100}%` };\n\n  const resetCounter = () => {\n    updateField('clickCount', 0);\n    updateField('isAnimating', false);\n  };\n\n  const testAnimation = () => {\n    updateField('isAnimating', true);\n    setTimeout(() => {\n      updateField('isAnimating', false);\n    }, 1000);\n  };\n\n  return (\n    <>\n      <BlockControls>\n        <AlignmentToolbar\n          value={alignmentValue}\n          onChange={(value) => updateField('alignment', (value || alignmentValue) as NonNullable<{{pascalCase}}Attributes['alignment']>)}\n        />\n      </BlockControls>\n\n      <InspectorControls>\n        <InspectorFromManifest\n          attributes={attributes}\n          fieldLookup={editorFields}\n          onChange={updateField}\n          paths={['alignment', 'interactiveMode', 'animation', 'showCounter', 'isVisible']}\n          title={__('Interactive Settings', '{{textDomain}}')}\n        />\n\n        <PanelBody title={__('Counter Settings', '{{textDomain}}')}>\n          <RangeControl\n            label={__('Max Clicks', '{{textDomain}}')}\n            value={maxClicks}\n            onChange={(value) => updateField('maxClicks', value ?? maxClicks)}\n            min={0}\n            max={100}\n            help={__('Set to 0 for unlimited clicks', '{{textDomain}}')}\n          />\n\n          <div style={actionButtonRowStyle}>\n            <Button\n              variant=\"secondary\"\n              onClick={resetCounter}\n              isSmall\n            >\n              {__('Reset Counter', '{{textDomain}}')}\n            </Button>\n            <Button\n              variant=\"secondary\"\n              onClick={testAnimation}\n              isSmall\n            >\n              {__('Test Animation', '{{textDomain}}')}\n            </Button>\n          </div>\n        </PanelBody>\n\n        {!isValid && (\n          <PanelBody title={__('Validation Errors', '{{textDomain}}')} initialOpen>\n            {errorMessages.map((error, index) => (\n              <Notice key={index} status=\"error\" isDismissible={false}>\n                {error}\n              </Notice>\n            ))}\n          </PanelBody>\n        )}\n\n        {isSelected && (\n          <PanelBody title={__('Preview', '{{textDomain}}')}>\n            <Button\n              variant={isPreviewing ? 'primary' : 'secondary'}\n              onClick={() => setIsPreviewing(!isPreviewing)}\n              aria-pressed={isPreviewing}\n              isSmall\n            >\n              {isPreviewing\n                ? __('Disable Preview Mode', '{{textDomain}}')\n                : __('Enable Preview Mode', '{{textDomain}}')}\n            </Button>\n\n            {clickCount > 0 && (\n              <Notice status=\"info\" isDismissible={false}>\n                {__('Current clicks:', '{{textDomain}}')} {clickCount}\n                {maxClicks > 0 && ` / ${maxClicks}`}\n              </Notice>\n            )}\n          </PanelBody>\n        )}\n      </InspectorControls>\n\n      <div {...blockProps}>\n        <div\n          className={`{{cssClassName}}__content ${isAnimating ? 'is-animating' : ''}`}\n          style={previewContentStyle}\n          data-wp-on--click={isPreviewing ? 'actions.handleClick' : undefined}\n          data-wp-on--mouseenter={isPreviewing && interactiveMode === 'hover' ? 'actions.handleMouseEnter' : undefined}\n          data-wp-on--mouseleave={isPreviewing && interactiveMode === 'hover' ? 'actions.handleMouseLeave' : undefined}\n        >\n          <RichText\n            tagName=\"p\"\n            value={attributes.content}\n            onChange={(value) => updateField('content', value)}\n            placeholder={__( {{titleJson}} + ' \u2013 click me to interact!', '{{textDomain}}')}\n          />\n\n          {!isValid && (\n            <Notice status=\"error\" isDismissible={false}>\n              <p>\n                <strong>{__('Validation Errors', '{{textDomain}}')}</strong>\n              </p>\n              <ul style={validationListStyle}>\n                {errorMessages.map((error, index) => (\n                  <li key={index}>{error}</li>\n                ))}\n              </ul>\n            </Notice>\n          )}\n\n          {showCounter && (\n            <div className=\"{{cssClassName}}__counter\">\n              <span className=\"{{cssClassName}}__counter-label\">\n                {__('Clicks:', '{{textDomain}}')}\n              </span>\n              <span\n                className=\"{{cssClassName}}__counter-value\"\n                data-wp-text=\"state.clicks\"\n              >\n                {clickCount}\n              </span>\n            </div>\n          )}\n\n          {maxClicks > 0 && (\n            <div className=\"{{cssClassName}}__progress\">\n              <div\n                className=\"{{cssClassName}}__progress-bar\"\n                style={progressBarStyle}\n                data-wp-style--width=\"state.progress + '%'\"\n              />\n            </div>\n          )}\n\n          {animation !== 'none' && (\n            <div\n              className={`{{cssClassName}}__animation ${isAnimating ? 'is-active' : ''}`}\n              data-wp-class--is-active=\"state.isAnimating\"\n            >\n              {animation}\n            </div>\n          )}\n        </div>\n      </div>\n    </>\n  );\n}\n";
 export declare const INTERACTIVITY_SAVE_TEMPLATE = "import { useBlockProps, RichText } from '@wordpress/block-editor';\nimport { __ } from '@wordpress/i18n';\nimport type { {{pascalCase}}Attributes } from './types';\n\nexport default function Save({ attributes }: { attributes: {{pascalCase}}Attributes }) {\n  const clickCount = attributes.clickCount ?? 0;\n  const interactiveMode = attributes.interactiveMode ?? 'click';\n  const animation = attributes.animation ?? 'none';\n  const isAnimating = attributes.isAnimating ?? false;\n  const isVisible = attributes.isVisible ?? true;\n  const maxClicks = attributes.maxClicks ?? 0;\n  const showCounter = attributes.showCounter ?? true;\n  const contentStyle = { textAlign: attributes.alignment };\n  const blockProps = useBlockProps.save({\n    className: `{{cssClassName}} {{cssClassName}}--${interactiveMode}`,\n    'data-wp-interactive': '{{slugKebabCase}}',\n    'data-wp-context': JSON.stringify({\n      clicks: clickCount,\n      isAnimating,\n      isVisible,\n      animation,\n      maxClicks,\n    })\n  });\n\n  return (\n    <div {...blockProps}>\n      <div\n        className={`{{cssClassName}}__content ${isAnimating ? 'is-animating' : ''}`}\n        style={contentStyle}\n        data-wp-on--click=\"actions.handleClick\"\n        data-wp-on--mouseenter={interactiveMode === 'hover' ? 'actions.handleMouseEnter' : undefined}\n        data-wp-on--mouseleave={interactiveMode === 'hover' ? 'actions.handleMouseLeave' : undefined}\n        data-wp-bind--hidden=\"!state.isVisible\"\n      >\n        <RichText.Content\n          tagName=\"p\"\n          value={attributes.content}\n          className=\"{{cssClassName}}__text\"\n        />\n\n        {showCounter && (\n          <div\n            className=\"{{cssClassName}}__counter\"\n            role=\"status\"\n            aria-live=\"polite\"\n            aria-atomic=\"true\"\n          >\n            <span className=\"{{cssClassName}}__counter-label\">\n              { __( 'Clicks:', '{{textDomain}}' ) }\n            </span>\n            <span\n              className=\"{{cssClassName}}__counter-value\"\n              data-wp-text=\"state.clicks\"\n            >\n              {clickCount}\n            </span>\n          </div>\n        )}\n\n        {maxClicks > 0 && (\n          <div className=\"{{cssClassName}}__progress\">\n            <div\n              className=\"{{cssClassName}}__progress-bar\"\n              role=\"progressbar\"\n              aria-label={ __( 'Click progress', '{{textDomain}}' ) }\n              aria-valuemin={0}\n              aria-valuemax={maxClicks}\n              aria-valuenow={Math.min(clickCount, maxClicks)}\n              data-wp-bind--aria-valuenow=\"state.clampedClicks\"\n              data-wp-style--width=\"state.progress + '%'\"\n            />\n          </div>\n        )}\n\n        <div\n          className={`{{cssClassName}}__animation ${animation}`}\n          aria-hidden=\"true\"\n          data-wp-class--is-active=\"state.isAnimating\"\n        />\n\n        {maxClicks > 0 && (\n          <div\n            className=\"{{cssClassName}}__completion\"\n            role=\"status\"\n            aria-live=\"polite\"\n            aria-atomic=\"true\"\n            data-wp-bind--hidden=\"!state.isComplete\"\n          >\n            { __( '\uD83C\uDF89 Complete!', '{{textDomain}}' ) }\n          </div>\n        )}\n\n        <button\n          className=\"{{cssClassName}}__reset\"\n          data-wp-on--click=\"actions.reset\"\n          aria-label={ __( 'Reset counter', '{{textDomain}}' ) }\n        >\n          <span aria-hidden=\"true\">\u21BB</span>\n          <span className=\"screen-reader-text\">\n            { __( 'Reset counter', '{{textDomain}}' ) }\n          </span>\n        </button>\n      </div>\n    </div>\n  );\n}\n";
-export declare const INTERACTIVITY_INDEX_TEMPLATE = "import { registerBlockType } from '@wordpress/blocks';\nimport type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';\nimport type { BlockSupports } from '@wp-typia/block-types/blocks/supports';\nimport {\n  buildScaffoldBlockRegistration,\n  parseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './editor.scss';\nimport './style.scss';\n\nimport type { {{pascalCase}}Attributes } from './types';\n\nconst scaffoldSupports = {\n  html: false,\n  align: true,\n  anchor: true,\n  className: true,\n  interactivity: true,\n} satisfies BlockSupports;\n\nconst registration = buildScaffoldBlockRegistration(\n  parseScaffoldBlockMetadata<BlockConfiguration<{{pascalCase}}Attributes>>(metadata),\n  {\n    supports: scaffoldSupports,\n    edit: Edit,\n    save: Save,\n  }\n);\n\nregisterBlockType<{{pascalCase}}Attributes>(registration.name, registration.settings);\n";
+export declare const INTERACTIVITY_INDEX_TEMPLATE = "import {\n  registerScaffoldBlockType,\n  type BlockConfiguration,\n} from '@wp-typia/block-types/blocks/registration';\nimport type { BlockSupports } from '@wp-typia/block-types/blocks/supports';\nimport {\n  buildScaffoldBlockRegistration,\n  parseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './editor.scss';\nimport './style.scss';\n\nimport type { {{pascalCase}}Attributes } from './types';\n\nconst scaffoldSupports = {\n  html: false,\n  align: true,\n  anchor: true,\n  className: true,\n  interactivity: true,\n} satisfies BlockSupports;\n\nconst registration = buildScaffoldBlockRegistration(\n  parseScaffoldBlockMetadata<BlockConfiguration<{{pascalCase}}Attributes>>(metadata),\n  {\n    supports: scaffoldSupports,\n    edit: Edit,\n    save: Save,\n  }\n);\n\nregisterScaffoldBlockType(registration.name, registration.settings);\n";
 export declare const INTERACTIVITY_SCRIPT_TEMPLATE = "/**\n * WordPress Interactivity API implementation for {{title}} block\n */\nimport { store, getContext, getElement, withSyncEvent } from '@wordpress/interactivity';\nimport type { {{pascalCase}}Context } from './types';\n\nfunction getBlockContext() {\n  return getContext<{{pascalCase}}Context>();\n}\n\n// Store configuration\nstore('{{slugKebabCase}}', {\n  // State - reactive data that updates the UI\n  state: {\n    get clicks() {\n      return getBlockContext().clicks;\n    },\n    get isAnimating() {\n      return getBlockContext().isAnimating;\n    },\n    get isVisible() {\n      return getBlockContext().isVisible;\n    },\n    get progress() {\n      const context = getBlockContext();\n      const clampedClicks =\n        context.maxClicks > 0\n          ? Math.min(context.clicks, context.maxClicks)\n          : context.clicks;\n      return context.maxClicks > 0 ? (clampedClicks / context.maxClicks) * 100 : 0;\n    },\n    get clampedClicks() {\n      const context = getBlockContext();\n      return context.maxClicks > 0\n        ? Math.min(context.clicks, context.maxClicks)\n        : context.clicks;\n    },\n    get isComplete() {\n      const context = getBlockContext();\n      return context.clicks >= context.maxClicks && context.maxClicks > 0;\n    }\n  },\n\n  // Actions - user interactions\n  actions: {\n    // Handle block click\n    handleClick: () => {\n      const context = getBlockContext();\n      const { ref } = getElement();\n\n      if (!ref) {\n        return;\n      }\n\n      if (context.maxClicks > 0 && context.clicks >= context.maxClicks) {\n        return;\n      }\n\n      const previousClicks = context.clicks;\n\n      // Increment click counter\n      context.clicks += 1;\n\n      // Trigger animation\n      if (context.animation !== 'none') {\n        context.isAnimating = true;\n        setTimeout(() => {\n          context.isAnimating = false;\n        }, 1000);\n      }\n\n      // Emit custom event\n      ref.dispatchEvent(new CustomEvent('{{slugKebabCase}}:click', {\n        detail: { clicks: context.clicks }\n      }));\n\n      // Check if max clicks reached\n      if (context.maxClicks > 0 && previousClicks < context.maxClicks && context.clicks === context.maxClicks) {\n        ref.dispatchEvent(new CustomEvent('{{slugKebabCase}}:complete', {\n          detail: { totalClicks: context.clicks }\n        }));\n      }\n    },\n\n    // Handle hover events\n    handleMouseEnter: () => {\n      const context = getBlockContext();\n      if (context.animation === 'none') return;\n      context.isAnimating = true;\n    },\n\n    handleMouseLeave: () => {\n      const context = getBlockContext();\n      if (context.animation === 'none') return;\n      context.isAnimating = false;\n    },\n\n    // Reset counter\n    reset: withSyncEvent((event: Event) => {\n      event.stopPropagation();\n      const context = getBlockContext();\n      context.clicks = 0;\n      context.isAnimating = false;\n    })\n  }\n});\n";
 export declare const INTERACTIVITY_VALIDATORS_TEMPLATE = "import typia from 'typia';\nimport currentManifest from \"./manifest-defaults-document\";\nimport { {{pascalCase}}Attributes, {{pascalCase}}ValidationResult } from \"./types\";\nimport { createTemplateValidatorToolkit } from \"./validator-toolkit\";\n\nconst scaffoldValidators = createTemplateValidatorToolkit<{{pascalCase}}Attributes>({\n  assert: typia.createAssert<{{pascalCase}}Attributes>(),\n  clone: typia.misc.createClone<{{pascalCase}}Attributes>() as (\n    value: {{pascalCase}}Attributes,\n  ) => {{pascalCase}}Attributes,\n  is: typia.createIs<{{pascalCase}}Attributes>(),\n  manifest: currentManifest,\n  prune: typia.misc.createPrune<{{pascalCase}}Attributes>(),\n  random: typia.createRandom<{{pascalCase}}Attributes>() as (\n    ...args: unknown[]\n  ) => {{pascalCase}}Attributes,\n  validate: typia.createValidate<{{pascalCase}}Attributes>(),\n});\n\nexport const validate{{pascalCase}}Attributes =\n  scaffoldValidators.validateAttributes as (\n    attributes: unknown,\n  ) => {{pascalCase}}ValidationResult;\n\nexport const validators = scaffoldValidators.validators;\n\nexport const sanitize{{pascalCase}}Attributes =\n  scaffoldValidators.sanitizeAttributes as (\n    attributes: Partial<{{pascalCase}}Attributes>,\n  ) => {{pascalCase}}Attributes;\n\n/**\n * Runtime type guard for checking if an object is {{pascalCase}}Attributes.\n */\nexport const is{{pascalCase}}Attributes = (obj: unknown): obj is {{pascalCase}}Attributes => {\n  return validators.is(obj);\n};\n\nexport const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;\n";
 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 { registerBlockType } from '@wordpress/blocks';\nimport type { BlockConfiguration } 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\nregisterBlockType< {{pascalCase}}Attributes >(\n\tregistration.name,\n\tregistration.settings\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";
 export declare const COMPOUND_PARENT_EDIT_TEMPLATE = "import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport { __ } from '@wordpress/i18n';\nimport {\n\tInspectorControls,\n\tInnerBlocks,\n\tRichText,\n\tuseBlockProps,\n} from '@wordpress/block-editor';\nimport { Notice, PanelBody, ToggleControl } from '@wordpress/components';\n\nimport {\n\tALLOWED_CHILD_BLOCKS,\n\tDEFAULT_CHILD_TEMPLATE,\n} from './children';\nimport { useTypiaValidation } from './hooks';\nimport type { {{pascalCase}}Attributes } from './types';\nimport {\n\tcreateAttributeUpdater,\n\tvalidate{{pascalCase}}Attributes,\n} from './validators';\n\ntype EditProps = BlockEditProps< {{pascalCase}}Attributes >;\n\nexport default function Edit( {\n\tattributes,\n\tsetAttributes,\n}: EditProps ) {\n\tconst { errorMessages, isValid } = useTypiaValidation(\n\t\tattributes,\n\t\tvalidate{{pascalCase}}Attributes\n\t);\n\tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );\n\tconst blockProps = useBlockProps( {\n\t\tclassName: '{{cssClassName}}',\n\t} );\n\n\treturn (\n\t\t<>\n\t\t\t<InspectorControls>\n\t\t\t\t<PanelBody title={ __( 'Compound Settings', '{{textDomain}}' ) }>\n\t\t\t\t\t<ToggleControl\n\t\t\t\t\t\tlabel={ __( 'Show dividers between items', '{{textDomain}}' ) }\n\t\t\t\t\t\tchecked={ attributes.showDividers ?? true }\n\t\t\t\t\t\tonChange={ ( value ) => updateAttribute( 'showDividers', value ) }\n\t\t\t\t\t/>\n\t\t\t\t</PanelBody>\n\t\t\t\t{ ! isValid && (\n\t\t\t\t\t<PanelBody title={ __( 'Validation Errors', '{{textDomain}}' ) } initialOpen>\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 { ...blockProps }>\n\t\t\t\t<RichText\n\t\t\t\t\ttagName=\"h3\"\n\t\t\t\t\tclassName=\"{{cssClassName}}__heading\"\n\t\t\t\t\tvalue={ attributes.heading }\n\t\t\t\t\tonChange={ ( heading ) => updateAttribute( 'heading', heading ) }\n\t\t\t\t\tplaceholder={ __( {{titleJson}}, '{{textDomain}}' ) }\n\t\t\t\t/>\n\t\t\t\t<RichText\n\t\t\t\t\ttagName=\"p\"\n\t\t\t\t\tclassName=\"{{cssClassName}}__intro\"\n\t\t\t\t\tvalue={ attributes.intro ?? '' }\n\t\t\t\t\tonChange={ ( intro ) => updateAttribute( 'intro', intro ) }\n\t\t\t\t\tplaceholder={ __(\n\t\t\t\t\t\t'Add and reorder internal items inside this compound block.',\n\t\t\t\t\t\t'{{textDomain}}'\n\t\t\t\t\t) }\n\t\t\t\t/>\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\t<div className=\"{{cssClassName}}__items\">\n\t\t\t\t\t<InnerBlocks\n\t\t\t\t\t\tallowedBlocks={ ALLOWED_CHILD_BLOCKS }\n\t\t\t\t\t\trenderAppender={ InnerBlocks.ButtonBlockAppender }\n\t\t\t\t\t\ttemplate={ DEFAULT_CHILD_TEMPLATE }\n\t\t\t\t\t\ttemplateLock={ false }\n\t\t\t\t\t/>\n\t\t\t\t</div>\n\t\t\t</div>\n\t\t</>\n\t);\n}\n";
 export declare const COMPOUND_PARENT_SAVE_TEMPLATE = "import { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';\n\nimport type { {{pascalCase}}Attributes } from './types';\n\nexport default function Save( {\n\tattributes,\n}: {\n\tattributes: {{pascalCase}}Attributes;\n} ) {\n\treturn (\n\t\t<div\n\t\t\t{ ...useBlockProps.save( {\n\t\t\t\tclassName: '{{cssClassName}}',\n\t\t\t\t'data-show-dividers': ( attributes.showDividers ?? true ) ? 'true' : 'false',\n\t\t\t} ) }\n\t\t>\n\t\t\t<RichText.Content\n\t\t\t\ttagName=\"h3\"\n\t\t\t\tclassName=\"{{cssClassName}}__heading\"\n\t\t\t\tvalue={ attributes.heading }\n\t\t\t/>\n\t\t\t<RichText.Content\n\t\t\t\ttagName=\"p\"\n\t\t\t\tclassName=\"{{cssClassName}}__intro\"\n\t\t\t\tvalue={ attributes.intro ?? '' }\n\t\t\t/>\n\t\t\t<div className=\"{{cssClassName}}__items\">\n\t\t\t\t<InnerBlocks.Content />\n\t\t\t</div>\n\t\t</div>\n\t);\n}\n";
-export declare const COMPOUND_PARENT_INDEX_TEMPLATE = "import { registerBlockType } from '@wordpress/blocks';\nimport type { BlockConfiguration } 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\nregisterBlockType< {{pascalCase}}Attributes >(\n\tregistration.name,\n\tregistration.settings\n);\n";
+export declare const COMPOUND_PARENT_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 COMPOUND_LOCAL_HOOKS_TEMPLATE = "export {\n\tformatValidationError,\n\tformatValidationErrors,\n\tuseTypiaValidation,\n} from '../../hooks';\n\nexport type {\n\tTypiaValidationError,\n\tValidationResult,\n\tValidationState,\n} from '../../hooks';\n";
 export declare const COMPOUND_PARENT_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 { 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\tvalidate: typia.createValidate< {{pascalCase}}Attributes >(),\n} );\n\nexport const validate{{pascalCase}}Attributes =\n\tscaffoldValidators.validateAttributes as (\n\t\tattributes: unknown\n\t) => {{pascalCase}}ValidationResult;\n\nexport const validators = scaffoldValidators.validators;\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 COMPOUND_CHILDREN_TEMPLATE = "import type { BlockTemplate } from '@wp-typia/block-types/blocks/registration';\n\nexport const DEFAULT_CHILD_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}-item';\n\nexport const ALLOWED_CHILD_BLOCKS = [\n\tDEFAULT_CHILD_BLOCK_NAME,\n\t// add-child: insert new allowed child block names here\n];\n\nexport const DEFAULT_CHILD_TEMPLATE: BlockTemplate = [\n\t[\n\t\tDEFAULT_CHILD_BLOCK_NAME,\n\t\t{\n\t\t\tbody: 'Add supporting details for the first internal item.',\n\t\t\ttitle: 'First Item',\n\t\t},\n\t],\n\t[\n\t\tDEFAULT_CHILD_BLOCK_NAME,\n\t\t{\n\t\t\tbody: 'Add supporting details for the second internal item.',\n\t\t\ttitle: 'Second Item',\n\t\t},\n\t],\n];\n";
 export declare const COMPOUND_CHILD_EDIT_TEMPLATE = "import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport { RichText, useBlockProps } from '@wordpress/block-editor';\nimport { Notice } from '@wordpress/components';\nimport { __ } from '@wordpress/i18n';\n\nimport { useTypiaValidation } from './hooks';\nimport type { {{pascalCase}}ItemAttributes } from './types';\nimport {\n\tcreateAttributeUpdater,\n\tvalidate{{pascalCase}}ItemAttributes,\n} from './validators';\n\ntype EditProps = BlockEditProps< {{pascalCase}}ItemAttributes >;\n\nexport default function Edit( {\n\tattributes,\n\tsetAttributes,\n}: EditProps ) {\n\tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );\n\tconst { errorMessages, isValid } = useTypiaValidation(\n\t\tattributes,\n\t\tvalidate{{pascalCase}}ItemAttributes\n\t);\n\n\treturn (\n\t\t<div { ...useBlockProps( { className: '{{compoundChildCssClassName}}' } ) }>\n\t\t\t<RichText\n\t\t\t\ttagName=\"h4\"\n\t\t\t\tclassName=\"{{compoundChildCssClassName}}__title\"\n\t\t\t\tvalue={ attributes.title ?? '' }\n\t\t\t\tonChange={ ( title ) => updateAttribute( 'title', title ) }\n\t\t\t\tplaceholder={ __( {{compoundChildTitleJson}}, '{{textDomain}}' ) }\n\t\t\t/>\n\t\t\t<RichText\n\t\t\t\ttagName=\"p\"\n\t\t\t\tclassName=\"{{compoundChildCssClassName}}__body\"\n\t\t\t\tvalue={ attributes.body ?? '' }\n\t\t\t\tonChange={ ( body ) => updateAttribute( 'body', body ) }\n\t\t\t\tplaceholder={ __( 'Add supporting details for this internal item.', '{{textDomain}}' ) }\n\t\t\t/>\n\t\t\t{ ! isValid && (\n\t\t\t\t<Notice status=\"error\" isDismissible={ false }>\n\t\t\t\t\t<ul>\n\t\t\t\t\t\t{ errorMessages.map( ( error, index ) => <li key={ index }>{ error }</li> ) }\n\t\t\t\t\t</ul>\n\t\t\t\t</Notice>\n\t\t\t) }\n\t\t</div>\n\t);\n}\n";
 export declare const COMPOUND_CHILD_SAVE_TEMPLATE = "import { RichText, useBlockProps } from '@wordpress/block-editor';\n\nimport type { {{pascalCase}}ItemAttributes } from './types';\n\nexport default function Save( {\n\tattributes,\n}: {\n\tattributes: {{pascalCase}}ItemAttributes;\n} ) {\n\treturn (\n\t\t<div { ...useBlockProps.save( { className: '{{compoundChildCssClassName}}' } ) }>\n\t\t\t<RichText.Content\n\t\t\t\ttagName=\"h4\"\n\t\t\t\tclassName=\"{{compoundChildCssClassName}}__title\"\n\t\t\t\tvalue={ attributes.title }\n\t\t\t/>\n\t\t\t<RichText.Content\n\t\t\t\ttagName=\"p\"\n\t\t\t\tclassName=\"{{compoundChildCssClassName}}__body\"\n\t\t\t\tvalue={ attributes.body }\n\t\t\t/>\n\t\t</div>\n\t);\n}\n";
-export declare const COMPOUND_CHILD_INDEX_TEMPLATE = "import { registerBlockType } from '@wordpress/blocks';\nimport type { BlockConfiguration } 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 '../{{slugKebabCase}}/style.scss';\n\nimport type { {{pascalCase}}ItemAttributes } from './types';\n\nconst registration = buildScaffoldBlockRegistration(\n\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}ItemAttributes >>( metadata ),\n\t{\n\t\tedit: Edit,\n\t\tsave: Save,\n\t}\n);\n\nregisterBlockType< {{pascalCase}}ItemAttributes >(\n\tregistration.name,\n\tregistration.settings\n);\n";
+export declare const COMPOUND_CHILD_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 '../{{slugKebabCase}}/style.scss';\n\nimport type { {{pascalCase}}ItemAttributes } from './types';\n\nconst registration = buildScaffoldBlockRegistration(\n\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}ItemAttributes >>( metadata ),\n\t{\n\t\tedit: Edit,\n\t\tsave: Save,\n\t}\n);\n\nregisterScaffoldBlockType(registration.name, registration.settings);\n";
 export declare const COMPOUND_CHILD_VALIDATORS_TEMPLATE = "import typia from 'typia';\nimport currentManifest from './manifest-defaults-document';\nimport type {\n\t{{pascalCase}}ItemAttributes,\n\t{{pascalCase}}ItemValidationResult,\n} from './types';\nimport { createTemplateValidatorToolkit } from '../../validator-toolkit';\n\nconst scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}ItemAttributes >( {\n\tassert: typia.createAssert< {{pascalCase}}ItemAttributes >(),\n\tclone: typia.misc.createClone< {{pascalCase}}ItemAttributes >() as (\n\t\tvalue: {{pascalCase}}ItemAttributes,\n\t) => {{pascalCase}}ItemAttributes,\n\tis: typia.createIs< {{pascalCase}}ItemAttributes >(),\n\tmanifest: currentManifest,\n\tprune: typia.misc.createPrune< {{pascalCase}}ItemAttributes >(),\n\trandom: typia.createRandom< {{pascalCase}}ItemAttributes >() as (\n\t\t...args: unknown[]\n\t) => {{pascalCase}}ItemAttributes,\n\tvalidate: typia.createValidate< {{pascalCase}}ItemAttributes >(),\n} );\n\nexport const validate{{pascalCase}}ItemAttributes =\n\tscaffoldValidators.validateAttributes as (\n\t\tattributes: unknown\n\t) => {{pascalCase}}ItemValidationResult;\n\nexport const validators = scaffoldValidators.validators;\n\nexport const sanitize{{pascalCase}}ItemAttributes =\n\tscaffoldValidators.sanitizeAttributes as (\n\t\tattributes: Partial< {{pascalCase}}ItemAttributes >\n\t) => {{pascalCase}}ItemAttributes;\n\nexport const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;\n";
 export declare const COMPOUND_PERSISTENCE_PARENT_EDIT_TEMPLATE = "import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport { __ } from '@wordpress/i18n';\nimport {\n\tInspectorControls,\n\tInnerBlocks,\n\tRichText,\n\tuseBlockProps,\n} from '@wordpress/block-editor';\nimport {\n\tNotice,\n\tPanelBody,\n\tTextControl,\n\tToggleControl,\n} from '@wordpress/components';\n\nimport {\n\tALLOWED_CHILD_BLOCKS,\n\tDEFAULT_CHILD_TEMPLATE,\n} from './children';\nimport { useTypiaValidation } from './hooks';\nimport type { {{pascalCase}}Attributes } from './types';\nimport {\n\tcreateAttributeUpdater,\n\tvalidate{{pascalCase}}Attributes,\n} from './validators';\n\ntype EditProps = BlockEditProps< {{pascalCase}}Attributes >;\n\nexport default function Edit( {\n\tattributes,\n\tsetAttributes,\n}: EditProps ) {\n\tconst { errorMessages, isValid } = useTypiaValidation(\n\t\tattributes,\n\t\tvalidate{{pascalCase}}Attributes\n\t);\n\tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );\n\tconst blockProps = useBlockProps( {\n\t\tclassName: '{{cssClassName}}',\n\t} );\n\n\treturn (\n\t\t<>\n\t\t\t<InspectorControls>\n\t\t\t\t<PanelBody title={ __( 'Compound Settings', '{{textDomain}}' ) }>\n\t\t\t\t\t<ToggleControl\n\t\t\t\t\t\tlabel={ __( 'Show dividers between items', '{{textDomain}}' ) }\n\t\t\t\t\t\tchecked={ attributes.showDividers ?? true }\n\t\t\t\t\t\tonChange={ ( value ) => updateAttribute( 'showDividers', value ) }\n\t\t\t\t\t/>\n\t\t\t\t\t<ToggleControl\n\t\t\t\t\t\tlabel={ __( 'Show persisted count', '{{textDomain}}' ) }\n\t\t\t\t\t\tchecked={ attributes.showCount ?? true }\n\t\t\t\t\t\tonChange={ ( value ) => updateAttribute( 'showCount', value ) }\n\t\t\t\t\t/>\n\t\t\t\t\t<TextControl\n\t\t\t\t\t\tlabel={ __( 'Button label', '{{textDomain}}' ) }\n\t\t\t\t\t\tvalue={ attributes.buttonLabel ?? 'Persist Count' }\n\t\t\t\t\t\tonChange={ ( buttonLabel ) => updateAttribute( 'buttonLabel', buttonLabel ) }\n\t\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={ ( resourceKey ) => updateAttribute( 'resourceKey', resourceKey ) }\n\t\t\t\t\t\thelp={ __( 'Stable key used by the persisted 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</Notice>\n\t\t\t\t</PanelBody>\n\t\t\t\t{ ! isValid && (\n\t\t\t\t\t<PanelBody title={ __( 'Validation Errors', '{{textDomain}}' ) } initialOpen>\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 { ...blockProps }>\n\t\t\t\t<RichText\n\t\t\t\t\ttagName=\"h3\"\n\t\t\t\t\tclassName=\"{{cssClassName}}__heading\"\n\t\t\t\t\tvalue={ attributes.heading }\n\t\t\t\t\tonChange={ ( heading ) => updateAttribute( 'heading', heading ) }\n\t\t\t\t\tplaceholder={ __( {{titleJson}}, '{{textDomain}}' ) }\n\t\t\t\t/>\n\t\t\t\t<RichText\n\t\t\t\t\ttagName=\"p\"\n\t\t\t\t\tclassName=\"{{cssClassName}}__intro\"\n\t\t\t\t\tvalue={ attributes.intro ?? '' }\n\t\t\t\t\tonChange={ ( intro ) => updateAttribute( 'intro', intro ) }\n\t\t\t\t\tplaceholder={ __(\n\t\t\t\t\t\t'Add and reorder internal items inside this compound block.',\n\t\t\t\t\t\t'{{textDomain}}'\n\t\t\t\t\t) }\n\t\t\t\t/>\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\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<div className=\"{{cssClassName}}__items\">\n\t\t\t\t\t<InnerBlocks\n\t\t\t\t\t\tallowedBlocks={ ALLOWED_CHILD_BLOCKS }\n\t\t\t\t\t\trenderAppender={ InnerBlocks.ButtonBlockAppender }\n\t\t\t\t\t\ttemplate={ DEFAULT_CHILD_TEMPLATE }\n\t\t\t\t\t\ttemplateLock={ false }\n\t\t\t\t\t/>\n\t\t\t\t</div>\n\t\t\t</div>\n\t\t</>\n\t);\n}\n";
 export declare const COMPOUND_PERSISTENCE_PARENT_SAVE_TEMPLATE = "export default function Save() {\n\treturn null;\n}\n";

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

@@ -211,8 +211,10 @@ export const BASIC_INDEX_TEMPLATE = `/**
  * Typia-powered type-safe block
  */
 
-import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
+import {
+  registerScaffoldBlockType,
+  type BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
 import type { BlockSupports } from '@wp-typia/block-types/blocks/supports';
 import { __ } from '@wordpress/i18n';
 import {
@@ -250,7 +252,7 @@ const registration = buildScaffoldBlockRegistration(
   }
 );
 
-registerBlockType<{{pascalCase}}Attributes>(registration.name, registration.settings);
+registerScaffoldBlockType(registration.name, registration.settings);
 `;
 export const BASIC_VALIDATORS_TEMPLATE = `import typia from 'typia';
 import currentManifest from "./manifest-defaults-document";
@@ -653,8 +655,10 @@ export default function Save({ attributes }: { attributes: {{pascalCase}}Attribu
   );
 }
 `;
-export const INTERACTIVITY_INDEX_TEMPLATE = `import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
+export const INTERACTIVITY_INDEX_TEMPLATE = `import {
+  registerScaffoldBlockType,
+  type BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
 import type { BlockSupports } from '@wp-typia/block-types/blocks/supports';
 import {
   buildScaffoldBlockRegistration,
@@ -686,7 +690,7 @@ const registration = buildScaffoldBlockRegistration(
   }
 );
 
-registerBlockType<{{pascalCase}}Attributes>(registration.name, registration.settings);
+registerScaffoldBlockType(registration.name, registration.settings);
 `;
 export const INTERACTIVITY_SCRIPT_TEMPLATE = `/**
  * WordPress Interactivity API implementation for {{title}} block
@@ -1000,8 +1004,10 @@ export default function Edit( {
 	);
 }
 `;
-export const PERSISTENCE_INDEX_TEMPLATE = `import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
+export const PERSISTENCE_INDEX_TEMPLATE = `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
 import {
 	buildScaffoldBlockRegistration,
 	parseScaffoldBlockMetadata,
@@ -1022,10 +1028,7 @@ const registration = buildScaffoldBlockRegistration(
 	}
 );
 
-registerBlockType< {{pascalCase}}Attributes >(
-	registration.name,
-	registration.settings
-);
+registerScaffoldBlockType(registration.name, registration.settings);
 `;
 export const PERSISTENCE_SAVE_TEMPLATE = `export default function Save() {
 	// This block is intentionally server-rendered. PHP bootstraps post context,
@@ -1513,8 +1516,10 @@ export default function Save( {
 	);
 }
 `;
-export const COMPOUND_PARENT_INDEX_TEMPLATE = `import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
+export const COMPOUND_PARENT_INDEX_TEMPLATE = `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
 import {
 	buildScaffoldBlockRegistration,
 	parseScaffoldBlockMetadata,
@@ -1535,10 +1540,7 @@ const registration = buildScaffoldBlockRegistration(
 	}
 );
 
-registerBlockType< {{pascalCase}}Attributes >(
-	registration.name,
-	registration.settings
-);
+registerScaffoldBlockType(registration.name, registration.settings);
 `;
 export const COMPOUND_LOCAL_HOOKS_TEMPLATE = `export {
 	formatValidationError,
@@ -1690,8 +1692,10 @@ export default function Save( {
 	);
 }
 `;
-export const COMPOUND_CHILD_INDEX_TEMPLATE = `import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
+export const COMPOUND_CHILD_INDEX_TEMPLATE = `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
 import {
 	buildScaffoldBlockRegistration,
 	parseScaffoldBlockMetadata,
@@ -1712,10 +1716,7 @@ const registration = buildScaffoldBlockRegistration(
 	}
 );
 
-registerBlockType< {{pascalCase}}ItemAttributes >(
-	registration.name,
-	registration.settings
-);
+registerScaffoldBlockType(registration.name, registration.settings);
 `;
 export const COMPOUND_CHILD_VALIDATORS_TEMPLATE = `import typia from 'typia';
 import currentManifest from './manifest-defaults-document';

package/dist/runtime/cli-help.js

@@ -33,7 +33,7 @@ Built-in templates: ${TEMPLATE_IDS.join(", ")}
 Package managers: ${PACKAGE_MANAGER_IDS.join(", ")}
 Notes:
   \`wp-typia create\` is the canonical scaffold command.
-  \`wp-typia <project-dir>\` remains a backward-compatible alias to \`create\`.
+  \`wp-typia <project-dir>\` remains a backward-compatible alias to \`create\` when \`<project-dir>\` is the only positional argument.
   Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
   \`add variation\` uses an existing workspace block from \`scripts/block-config.ts\`.
   \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/\`.

package/dist/runtime/cli-scaffold.js

@@ -108,7 +108,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
         ? externalLayerSource.trim()
         : undefined;
     if (!projectInput) {
-        throw new Error("Project directory is required. Usage: wp-typia create <project-dir> (or wp-typia <project-dir>).");
+        throw new Error("Project directory is required. Usage: wp-typia create <project-dir> (or wp-typia <project-dir> when <project-dir> is the only positional argument).");
     }
     const resolvedTemplateId = await resolveTemplateId({
         templateId,

package/dist/runtime/migration-ui-capability.js

@@ -41,7 +41,7 @@ function injectBefore(source, needle, insertion) {
     return source.replace(needle, `${insertion}\n${needle}`);
 }
 function injectAfterBlockMetadataImport(source, insertion) {
-    let nextSource = injectAfter(source, BLOCK_METADATA_IMPORT_LINE, insertion);
+    const nextSource = injectAfter(source, BLOCK_METADATA_IMPORT_LINE, insertion);
     if (nextSource !== source) {
         return nextSource;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.9",
+  "version": "0.16.11",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -121,8 +121,8 @@
   "dependencies": {
     "@wp-typia/api-client": "^0.4.4",
     "@wp-typia/block-runtime": "^0.4.8",
-    "@wp-typia/rest": "^0.3.7",
-    "@wp-typia/block-types": "^0.2.2",
+    "@wp-typia/rest": "^0.3.8",
+    "@wp-typia/block-types": "^0.2.4",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
     "semver": "^7.7.3",

package/templates/_shared/compound/core/scripts/add-compound-child.ts.mustache

@@ -576,8 +576,10 @@ export default function Save( {
 }
 
 function renderIndexFile( childTypeName: string, childFolderSlug: string ): string {
-return `import { registerBlockType } from '@wordpress/blocks';
-import type { BlockConfiguration } from '@wp-typia/block-types/blocks/registration';
+return `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
 import {
 \tbuildScaffoldBlockRegistration,
 \tparseScaffoldBlockMetadata,
@@ -598,10 +600,7 @@ const registration = buildScaffoldBlockRegistration(
 \t}
 );
 
-registerBlockType< ${ childTypeName } >(
-\tregistration.name,
-\tregistration.settings
-);
+registerScaffoldBlockType( registration.name, registration.settings );
 `;
 }