@wp-typia/project-tools 0.24.3 → 0.24.5

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

@@ -0,0 +1,208 @@
+import { buildBuiltInNonTsArtifacts } from "./built-in-block-non-ts-artifacts.js";
+import { BASIC_EDIT_TEMPLATE, BASIC_INDEX_TEMPLATE, BASIC_SAVE_TEMPLATE, BASIC_VALIDATORS_TEMPLATE, BLOCK_METADATA_WRAPPER_TEMPLATE, COMPOUND_CHILD_EDIT_TEMPLATE, COMPOUND_CHILD_INDEX_TEMPLATE, COMPOUND_CHILD_SAVE_TEMPLATE, COMPOUND_CHILD_VALIDATORS_TEMPLATE, COMPOUND_CHILDREN_TEMPLATE, COMPOUND_LOCAL_HOOKS_TEMPLATE, COMPOUND_PARENT_EDIT_TEMPLATE, COMPOUND_PARENT_INDEX_TEMPLATE, COMPOUND_PARENT_SAVE_TEMPLATE, COMPOUND_PARENT_VALIDATORS_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_EDIT_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_INTERACTIVITY_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_SAVE_TEMPLATE, COMPOUND_PERSISTENCE_PARENT_VALIDATORS_TEMPLATE, INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_STORE_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEMPLATE, MANIFEST_DOCUMENT_WRAPPER_TEMPLATE, PERSISTENCE_EDIT_TEMPLATE, PERSISTENCE_INDEX_TEMPLATE, PERSISTENCE_INTERACTIVITY_TEMPLATE, PERSISTENCE_SAVE_TEMPLATE, PERSISTENCE_VALIDATORS_TEMPLATE, QUERY_LOOP_INDEX_TEMPLATE, SHARED_HOOKS_TEMPLATE, } from "./built-in-block-code-templates.js";
+import { getScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
+import { assertScaffoldTemplateCodeIdentifiers } from "./scaffold-template-assertions.js";
+import { renderMustacheTemplateString } from "./template-render.js";
+function renderCodeTemplate(template, variables) {
+    assertScaffoldTemplateCodeIdentifiers(variables);
+    const rendered = renderMustacheTemplateString(template, variables);
+    return rendered.endsWith("\n") ? rendered : `${rendered}\n`;
+}
+function createCodeArtifact(relativePath, template, variables) {
+    return {
+        relativePath,
+        source: renderCodeTemplate(template, variables),
+    };
+}
+function createCodeArtifacts(specs, variables) {
+    return specs.map((spec) => createCodeArtifact(spec.relativePath, spec.template, variables));
+}
+function createTypedJsonWrapperArtifacts(relativeDir, variables) {
+    return [
+        createCodeArtifact(`${relativeDir}/block-metadata.ts`, BLOCK_METADATA_WRAPPER_TEMPLATE, variables),
+        createCodeArtifact(`${relativeDir}/manifest-document.ts`, MANIFEST_DOCUMENT_WRAPPER_TEMPLATE, variables),
+        createCodeArtifact(`${relativeDir}/manifest-defaults-document.ts`, MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEMPLATE, variables),
+    ];
+}
+function ensureUniqueArtifactPaths(artifacts) {
+    const seenPaths = new Set();
+    for (const artifact of artifacts) {
+        if (seenPaths.has(artifact.relativePath)) {
+            throw new Error(`Duplicate built-in artifact path emitted: ${artifact.relativePath}`);
+        }
+        seenPaths.add(artifact.relativePath);
+    }
+    return artifacts;
+}
+function buildBasicCodeArtifacts(variables) {
+    return ensureUniqueArtifactPaths([
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/hooks.ts",
+                template: SHARED_HOOKS_TEMPLATE,
+            },
+        ], variables),
+        ...createTypedJsonWrapperArtifacts("src", variables),
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/edit.tsx",
+                template: BASIC_EDIT_TEMPLATE,
+            },
+            {
+                relativePath: "src/save.tsx",
+                template: BASIC_SAVE_TEMPLATE,
+            },
+            {
+                relativePath: "src/index.tsx",
+                template: BASIC_INDEX_TEMPLATE,
+            },
+            {
+                relativePath: "src/validators.ts",
+                template: BASIC_VALIDATORS_TEMPLATE,
+            },
+        ], variables),
+        ...buildBuiltInNonTsArtifacts({ templateId: "basic", variables }),
+    ]);
+}
+function buildInteractivityCodeArtifacts(variables) {
+    return ensureUniqueArtifactPaths([
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/hooks.ts",
+                template: SHARED_HOOKS_TEMPLATE,
+            },
+        ], variables),
+        ...createTypedJsonWrapperArtifacts("src", variables),
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/edit.tsx",
+                template: INTERACTIVITY_EDIT_TEMPLATE,
+            },
+            {
+                relativePath: "src/save.tsx",
+                template: INTERACTIVITY_SAVE_TEMPLATE,
+            },
+            {
+                relativePath: "src/index.tsx",
+                template: INTERACTIVITY_INDEX_TEMPLATE,
+            },
+            {
+                relativePath: "src/interactivity.ts",
+                template: INTERACTIVITY_SCRIPT_TEMPLATE,
+            },
+            {
+                relativePath: "src/interactivity-store.ts",
+                template: INTERACTIVITY_STORE_TEMPLATE,
+            },
+            {
+                relativePath: "src/validators.ts",
+                template: INTERACTIVITY_VALIDATORS_TEMPLATE,
+            },
+        ], variables),
+        ...buildBuiltInNonTsArtifacts({ templateId: "interactivity", variables }),
+    ]);
+}
+function buildCompoundCodeArtifacts(variables) {
+    const parentBasePath = `src/blocks/${variables.slugKebabCase}`;
+    const childBasePath = `src/blocks/${variables.slugKebabCase}-item`;
+    const compoundGroup = getScaffoldTemplateVariableGroups(variables).compound;
+    const compoundPersistenceEnabled = compoundGroup.enabled && compoundGroup.persistenceEnabled;
+    return ensureUniqueArtifactPaths([
+        createCodeArtifact("src/hooks.ts", SHARED_HOOKS_TEMPLATE, variables),
+        ...createTypedJsonWrapperArtifacts(parentBasePath, variables),
+        createCodeArtifact(`${parentBasePath}/edit.tsx`, compoundPersistenceEnabled
+            ? COMPOUND_PERSISTENCE_PARENT_EDIT_TEMPLATE
+            : COMPOUND_PARENT_EDIT_TEMPLATE, variables),
+        createCodeArtifact(`${parentBasePath}/save.tsx`, compoundPersistenceEnabled
+            ? COMPOUND_PERSISTENCE_PARENT_SAVE_TEMPLATE
+            : COMPOUND_PARENT_SAVE_TEMPLATE, variables),
+        createCodeArtifact(`${parentBasePath}/index.tsx`, COMPOUND_PARENT_INDEX_TEMPLATE, variables),
+        createCodeArtifact(`${parentBasePath}/hooks.ts`, COMPOUND_LOCAL_HOOKS_TEMPLATE, variables),
+        createCodeArtifact(`${parentBasePath}/validators.ts`, compoundPersistenceEnabled
+            ? COMPOUND_PERSISTENCE_PARENT_VALIDATORS_TEMPLATE
+            : COMPOUND_PARENT_VALIDATORS_TEMPLATE, variables),
+        createCodeArtifact(`${parentBasePath}/children.ts`, COMPOUND_CHILDREN_TEMPLATE, variables),
+        ...(compoundPersistenceEnabled
+            ? [
+                createCodeArtifact(`${parentBasePath}/interactivity.ts`, COMPOUND_PERSISTENCE_PARENT_INTERACTIVITY_TEMPLATE, variables),
+            ]
+            : []),
+        ...createTypedJsonWrapperArtifacts(childBasePath, variables),
+        createCodeArtifact(`${childBasePath}/edit.tsx`, COMPOUND_CHILD_EDIT_TEMPLATE, variables),
+        createCodeArtifact(`${childBasePath}/save.tsx`, COMPOUND_CHILD_SAVE_TEMPLATE, variables),
+        createCodeArtifact(`${childBasePath}/index.tsx`, COMPOUND_CHILD_INDEX_TEMPLATE, variables),
+        createCodeArtifact(`${childBasePath}/hooks.ts`, COMPOUND_LOCAL_HOOKS_TEMPLATE, variables),
+        createCodeArtifact(`${childBasePath}/validators.ts`, COMPOUND_CHILD_VALIDATORS_TEMPLATE, variables),
+        ...buildBuiltInNonTsArtifacts({ templateId: "compound", variables }),
+    ]);
+}
+function buildPersistenceCodeArtifacts(variables) {
+    return ensureUniqueArtifactPaths([
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/hooks.ts",
+                template: SHARED_HOOKS_TEMPLATE,
+            },
+        ], variables),
+        ...createTypedJsonWrapperArtifacts("src", variables),
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/edit.tsx",
+                template: PERSISTENCE_EDIT_TEMPLATE,
+            },
+            {
+                relativePath: "src/save.tsx",
+                template: PERSISTENCE_SAVE_TEMPLATE,
+            },
+            {
+                relativePath: "src/index.tsx",
+                template: PERSISTENCE_INDEX_TEMPLATE,
+            },
+            {
+                relativePath: "src/interactivity.ts",
+                template: PERSISTENCE_INTERACTIVITY_TEMPLATE,
+            },
+            {
+                relativePath: "src/validators.ts",
+                template: PERSISTENCE_VALIDATORS_TEMPLATE,
+            },
+        ], variables),
+        ...buildBuiltInNonTsArtifacts({ templateId: "persistence", variables }),
+    ]);
+}
+function buildQueryLoopCodeArtifacts(variables) {
+    return ensureUniqueArtifactPaths([
+        ...createCodeArtifacts([
+            {
+                relativePath: "src/index.ts",
+                template: QUERY_LOOP_INDEX_TEMPLATE,
+            },
+        ], variables),
+        ...buildBuiltInNonTsArtifacts({ templateId: "query-loop", variables }),
+    ]);
+}
+/**
+ * Build the emitter-owned scaffold files for a built-in template family.
+ *
+ * These artifacts are written after template copy so built-in structural,
+ * source, and adjacent generated files always come from the typed generator
+ * boundary rather than stale Mustache sources.
+ */
+export function buildBuiltInCodeArtifacts({ templateId, variables, }) {
+    switch (templateId) {
+        case "basic":
+            return buildBasicCodeArtifacts(variables);
+        case "interactivity":
+            return buildInteractivityCodeArtifacts(variables);
+        case "persistence":
+            return buildPersistenceCodeArtifacts(variables);
+        case "compound":
+            return buildCompoundCodeArtifacts(variables);
+        case "query-loop":
+            return buildQueryLoopCodeArtifacts(variables);
+        default: {
+            const unhandledTemplateId = templateId;
+            throw new Error(`Unhandled built-in template id: ${unhandledTemplateId}`);
+        }
+    }
+}

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

@@ -0,0 +1,4 @@
+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 {\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";

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

@@ -0,0 +1,249 @@
+export const BASIC_EDIT_TEMPLATE = `/**
+ * Editor component for {{title}} Block
+ */
+
+import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
+import {
+  InspectorControls,
+  RichText,
+  useBlockProps,
+} from '@wordpress/block-editor';
+import { Notice, PanelBody, TextControl } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+import currentManifest from './manifest-document';
+import {
+  InspectorFromManifest,
+  useEditorFields,
+  useTypedAttributeUpdater,
+} from '@wp-typia/block-runtime/inspector';
+import { {{pascalCase}}Attributes } from './types';
+import {
+  sanitize{{pascalCase}}Attributes,
+  validate{{pascalCase}}Attributes,
+} from './validators';
+import { useTypiaValidation } from './hooks';
+
+type EditProps = BlockEditProps<{{pascalCase}}Attributes>;
+
+const validationErrorItemStyle = { color: '#cc1818', fontSize: '12px' };
+const validationListStyle = { margin: 0, paddingLeft: '1em' };
+
+function Edit({ attributes, setAttributes }: EditProps) {
+  const isVisible = attributes.isVisible !== false;
+  const blockProps = useBlockProps({
+    className: \`{{cssClassName}}\${isVisible ? '' : ' is-hidden'}\`,
+  });
+  const editorFields = useEditorFields(currentManifest, {
+    hidden: ['id', 'schemaVersion'],
+    manual: ['content'],
+    labels: {
+      alignment: __('Alignment', '{{textDomain}}'),
+      className: __('CSS Class', '{{textDomain}}'),
+      content: __('Content', '{{textDomain}}'),
+      isVisible: __('Visible', '{{textDomain}}'),
+    },
+  });
+  const classNameField = editorFields.getField('className');
+  const { errorMessages, isValid } = useTypiaValidation(
+    attributes,
+    validate{{pascalCase}}Attributes
+  );
+  const validateEditorUpdate = (nextAttributes: {{pascalCase}}Attributes) => {
+    try {
+      return {
+        data: sanitize{{pascalCase}}Attributes(nextAttributes),
+        errors: [],
+        isValid: true as const,
+      };
+    } catch {
+      return validate{{pascalCase}}Attributes(nextAttributes);
+    }
+  };
+  const { updateField } = useTypedAttributeUpdater(
+    attributes,
+    setAttributes,
+    validateEditorUpdate
+  );
+
+  return (
+    <>
+      <InspectorControls>
+        <InspectorFromManifest
+          attributes={attributes}
+          fieldLookup={editorFields}
+          onChange={updateField}
+          paths={['alignment', 'isVisible']}
+          title={__('Settings', '{{textDomain}}')}
+        >
+          <TextControl
+            label={__('Content', '{{textDomain}}')}
+            value={attributes.content || ''}
+            onChange={(value) => updateField('content', value)}
+            help={__('Mirrors the main block content.', '{{textDomain}}')}
+          />
+
+          <TextControl
+            label={classNameField?.label || __('CSS Class', '{{textDomain}}')}
+            value={attributes.className || ''}
+            onChange={(value) => updateField('className', value)}
+            help={__('Add an optional CSS class name.', '{{textDomain}}')}
+          />
+        </InspectorFromManifest>
+
+        {!isValid && (
+          <PanelBody title={__('Validation Errors', '{{textDomain}}')} initialOpen>
+            {errorMessages.map((error, index) => (
+              <div key={index} style={validationErrorItemStyle}>
+                • {error}
+              </div>
+            ))}
+          </PanelBody>
+        )}
+      </InspectorControls>
+
+      <div {...blockProps}>
+        <div className="{{cssClassName}}__content">
+          <RichText
+            tagName="p"
+            value={attributes.content || ''}
+            onChange={(value) => updateField('content', value)}
+            placeholder={__('Add your content...', '{{textDomain}}')}
+          />
+        </div>
+        {!isValid && (
+          <Notice status="error" isDismissible={false}>
+            <p>
+              <strong>{__('Validation Errors', '{{textDomain}}')}</strong>
+            </p>
+            <ul style={validationListStyle}>
+              {errorMessages.map((error, index) => (
+                <li key={index}>{error}</li>
+              ))}
+            </ul>
+          </Notice>
+        )}
+      </div>
+    </>
+  );
+}
+
+export default Edit;
+`;
+export const BASIC_SAVE_TEMPLATE = `/**
+ * Save/Frontend component for {{title}} Block
+ */
+
+import { RichText, useBlockProps } from '@wordpress/block-editor';
+import { {{pascalCase}}Attributes } from './types';
+
+interface SaveProps {
+  attributes: {{pascalCase}}Attributes;
+}
+
+export default function Save({ attributes }: SaveProps) {
+  const isVisible = attributes.isVisible !== false;
+  const blockProps = useBlockProps.save({
+    className: \`{{cssClassName}}\${isVisible ? '' : ' is-hidden'}\`,
+    hidden: isVisible ? undefined : true,
+    'aria-hidden': isVisible ? undefined : 'true',
+  });
+
+  return (
+    <div {...blockProps}>
+      <div
+        className="{{cssClassName}}__content"
+        data-align={attributes.alignment || 'left'}
+      >
+        <RichText.Content tagName="p" value={attributes.content} />
+      </div>
+    </div>
+  );
+}
+`;
+export const BASIC_INDEX_TEMPLATE = `/**
+ * WordPress {{title}} Block
+ *
+ * Typia-powered type-safe block
+ */
+
+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 {
+  buildScaffoldBlockRegistration,
+  parseScaffoldBlockMetadata,
+} from '@wp-typia/block-runtime/blocks';
+
+// Import components
+import Edit from './edit';
+import Save from './save';
+import metadata from './block-metadata';
+import './editor.scss';
+import './style.scss';
+
+// Import types
+import { {{pascalCase}}Attributes } from './types';
+import { validators } from './validators';
+
+const scaffoldSupports = {
+  html: false,
+  multiple: true,
+  align: ['wide', 'full'],
+} satisfies BlockSupports;
+
+// Register the block
+const registration = buildScaffoldBlockRegistration(
+  parseScaffoldBlockMetadata<BlockConfiguration<{{pascalCase}}Attributes>>(metadata),
+  {
+    supports: scaffoldSupports,
+    example: {
+      attributes: validators.random(),
+    },
+    edit: Edit,
+    save: Save,
+  }
+);
+
+registerScaffoldBlockType(registration.name, registration.settings);
+`;
+export const BASIC_VALIDATORS_TEMPLATE = `import typia from 'typia';
+import currentManifest from "./manifest-defaults-document";
+import { {{pascalCase}}Attributes, {{pascalCase}}ValidationResult } from "./types";
+import { generateBlockId } from "@wp-typia/block-runtime/identifiers";
+import { createTemplateValidatorToolkit } from "./validator-toolkit";
+
+const scaffoldValidators = createTemplateValidatorToolkit<{{pascalCase}}Attributes>({
+  assert: typia.createAssert<{{pascalCase}}Attributes>(),
+  clone: typia.misc.createClone<{{pascalCase}}Attributes>() as (
+    value: {{pascalCase}}Attributes,
+  ) => {{pascalCase}}Attributes,
+  is: typia.createIs<{{pascalCase}}Attributes>(),
+  manifest: currentManifest,
+  prune: typia.misc.createPrune<{{pascalCase}}Attributes>(),
+  random: typia.createRandom<{{pascalCase}}Attributes>() as (
+    ...args: unknown[]
+  ) => {{pascalCase}}Attributes,
+  finalize: (normalized) => ({
+    ...normalized,
+    id: normalized.id && normalized.id.length > 0 ? normalized.id : generateBlockId(),
+  }),
+  validate: typia.createValidate<{{pascalCase}}Attributes>(),
+});
+
+export const validate{{pascalCase}}Attributes =
+  scaffoldValidators.validateAttributes as (
+    attributes: unknown,
+  ) => {{pascalCase}}ValidationResult;
+
+export const validators = scaffoldValidators.validators;
+
+export const sanitize{{pascalCase}}Attributes =
+  scaffoldValidators.sanitizeAttributes as (
+    attributes: Partial<{{pascalCase}}Attributes>,
+  ) => {{pascalCase}}Attributes;
+
+export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;
+`;

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

@@ -0,0 +1,4 @@
+export declare const COMPOUND_CHILD_EDIT_TEMPLATE = "import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';\nimport { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';\nimport { Notice } from '@wordpress/components';\nimport { __ } from '@wordpress/i18n';\n\nimport metadata from './block-metadata';\nimport {\n\tgetChildInnerBlocksPropsOptions,\n\thasNestedChildBlocks,\n} from '../{{slugKebabCase}}/children';\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 >;\ntype CompoundInnerBlocksProps = Parameters< typeof InnerBlocks >[ 0 ] & {\n\tdefaultBlock?: [ string, Record< string, unknown > ];\n\tdirectInsert?: boolean;\n};\n\nconst TypedInnerBlocks = InnerBlocks as unknown as (\n\tprops: CompoundInnerBlocksProps\n) => ReturnType< typeof InnerBlocks >;\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\tconst nestedInnerBlocksPropsOptions = getChildInnerBlocksPropsOptions(\n\t\tmetadata.name\n\t);\n\tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );\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\t{ showsNestedChildren && (\n\t\t\t\t<div className=\"{{compoundChildCssClassName}}__children\">\n\t\t\t\t\t<TypedInnerBlocks\n\t\t\t\t\t\t{ ...( nestedInnerBlocksPropsOptions ?? {} ) }\n\t\t\t\t\t/>\n\t\t\t\t</div>\n\t\t\t) }\n\t\t</div>\n\t);\n}\n";
+export declare const COMPOUND_CHILD_SAVE_TEMPLATE = "import { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';\n\nimport metadata from './block-metadata';\nimport { hasNestedChildBlocks } from '../{{slugKebabCase}}/children';\nimport type { {{pascalCase}}ItemAttributes } from './types';\n\nexport default function Save( {\n\tattributes,\n}: {\n\tattributes: {{pascalCase}}ItemAttributes;\n} ) {\n\tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );\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\t{ showsNestedChildren && (\n\t\t\t\t<div className=\"{{compoundChildCssClassName}}__children\">\n\t\t\t\t\t<InnerBlocks.Content />\n\t\t\t\t</div>\n\t\t\t) }\n\t\t</div>\n\t);\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";

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

@@ -0,0 +1,171 @@
+export const COMPOUND_CHILD_EDIT_TEMPLATE = `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
+import { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';
+import { Notice } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+
+import metadata from './block-metadata';
+import {
+\tgetChildInnerBlocksPropsOptions,
+\thasNestedChildBlocks,
+} from '../{{slugKebabCase}}/children';
+import { useTypiaValidation } from './hooks';
+import type { {{pascalCase}}ItemAttributes } from './types';
+import {
+\tcreateAttributeUpdater,
+\tvalidate{{pascalCase}}ItemAttributes,
+} from './validators';
+
+type EditProps = BlockEditProps< {{pascalCase}}ItemAttributes >;
+type CompoundInnerBlocksProps = Parameters< typeof InnerBlocks >[ 0 ] & {
+\tdefaultBlock?: [ string, Record< string, unknown > ];
+\tdirectInsert?: boolean;
+};
+
+const TypedInnerBlocks = InnerBlocks as unknown as (
+\tprops: CompoundInnerBlocksProps
+) => ReturnType< typeof InnerBlocks >;
+
+export default function Edit( {
+\tattributes,
+\tsetAttributes,
+}: EditProps ) {
+\tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );
+\tconst { errorMessages, isValid } = useTypiaValidation(
+\t\tattributes,
+\t\tvalidate{{pascalCase}}ItemAttributes
+\t);
+\tconst nestedInnerBlocksPropsOptions = getChildInnerBlocksPropsOptions(
+\t\tmetadata.name
+\t);
+\tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );
+
+\treturn (
+\t\t<div { ...useBlockProps( { className: '{{compoundChildCssClassName}}' } ) }>
+\t\t\t<RichText
+\t\t\t\ttagName="h4"
+\t\t\t\tclassName="{{compoundChildCssClassName}}__title"
+\t\t\t\tvalue={ attributes.title ?? '' }
+\t\t\t\tonChange={ ( title ) => updateAttribute( 'title', title ) }
+\t\t\t\tplaceholder={ __( {{compoundChildTitleJson}}, '{{textDomain}}' ) }
+\t\t\t/>
+\t\t\t<RichText
+\t\t\t\ttagName="p"
+\t\t\t\tclassName="{{compoundChildCssClassName}}__body"
+\t\t\t\tvalue={ attributes.body ?? '' }
+\t\t\t\tonChange={ ( body ) => updateAttribute( 'body', body ) }
+\t\t\t\tplaceholder={ __( 'Add supporting details for this internal item.', '{{textDomain}}' ) }
+\t\t\t/>
+\t\t\t{ ! isValid && (
+\t\t\t\t<Notice status="error" isDismissible={ false }>
+\t\t\t\t\t<ul>
+\t\t\t\t\t\t{ errorMessages.map( ( error, index ) => <li key={ index }>{ error }</li> ) }
+\t\t\t\t\t</ul>
+\t\t\t\t</Notice>
+\t\t\t) }
+\t\t\t{ showsNestedChildren && (
+\t\t\t\t<div className="{{compoundChildCssClassName}}__children">
+\t\t\t\t\t<TypedInnerBlocks
+\t\t\t\t\t\t{ ...( nestedInnerBlocksPropsOptions ?? {} ) }
+\t\t\t\t\t/>
+\t\t\t\t</div>
+\t\t\t) }
+\t\t</div>
+\t);
+}
+`;
+export const COMPOUND_CHILD_SAVE_TEMPLATE = `import { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';
+
+import metadata from './block-metadata';
+import { hasNestedChildBlocks } from '../{{slugKebabCase}}/children';
+import type { {{pascalCase}}ItemAttributes } from './types';
+
+export default function Save( {
+\tattributes,
+}: {
+\tattributes: {{pascalCase}}ItemAttributes;
+} ) {
+\tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );
+
+\treturn (
+\t\t<div { ...useBlockProps.save( { className: '{{compoundChildCssClassName}}' } ) }>
+\t\t\t<RichText.Content
+\t\t\t\ttagName="h4"
+\t\t\t\tclassName="{{compoundChildCssClassName}}__title"
+\t\t\t\tvalue={ attributes.title }
+\t\t\t/>
+\t\t\t<RichText.Content
+\t\t\t\ttagName="p"
+\t\t\t\tclassName="{{compoundChildCssClassName}}__body"
+\t\t\t\tvalue={ attributes.body }
+\t\t\t/>
+\t\t\t{ showsNestedChildren && (
+\t\t\t\t<div className="{{compoundChildCssClassName}}__children">
+\t\t\t\t\t<InnerBlocks.Content />
+\t\t\t\t</div>
+\t\t\t) }
+\t\t</div>
+\t);
+}
+`;
+export const COMPOUND_CHILD_INDEX_TEMPLATE = `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
+import {
+\tbuildScaffoldBlockRegistration,
+\tparseScaffoldBlockMetadata,
+} from '@wp-typia/block-runtime/blocks';
+
+import Edit from './edit';
+import Save from './save';
+import metadata from './block-metadata';
+import '../{{slugKebabCase}}/style.scss';
+
+import type { {{pascalCase}}ItemAttributes } from './types';
+
+const registration = buildScaffoldBlockRegistration(
+\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}ItemAttributes >>( metadata ),
+\t{
+\t\tedit: Edit,
+\t\tsave: Save,
+\t}
+);
+
+registerScaffoldBlockType(registration.name, registration.settings);
+`;
+export const COMPOUND_CHILD_VALIDATORS_TEMPLATE = `import typia from 'typia';
+import currentManifest from './manifest-defaults-document';
+import type {
+\t{{pascalCase}}ItemAttributes,
+\t{{pascalCase}}ItemValidationResult,
+} from './types';
+import { createTemplateValidatorToolkit } from '../../validator-toolkit';
+
+const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}ItemAttributes >( {
+\tassert: typia.createAssert< {{pascalCase}}ItemAttributes >(),
+\tclone: typia.misc.createClone< {{pascalCase}}ItemAttributes >() as (
+\t\tvalue: {{pascalCase}}ItemAttributes,
+\t) => {{pascalCase}}ItemAttributes,
+\tis: typia.createIs< {{pascalCase}}ItemAttributes >(),
+\tmanifest: currentManifest,
+\tprune: typia.misc.createPrune< {{pascalCase}}ItemAttributes >(),
+\trandom: typia.createRandom< {{pascalCase}}ItemAttributes >() as (
+\t\t...args: unknown[]
+\t) => {{pascalCase}}ItemAttributes,
+\tvalidate: typia.createValidate< {{pascalCase}}ItemAttributes >(),
+} );
+
+export const validate{{pascalCase}}ItemAttributes =
+\tscaffoldValidators.validateAttributes as (
+\t\tattributes: unknown
+\t) => {{pascalCase}}ItemValidationResult;
+
+export const validators = scaffoldValidators.validators;
+
+export const sanitize{{pascalCase}}ItemAttributes =
+\tscaffoldValidators.sanitizeAttributes as (
+\t\tattributes: Partial< {{pascalCase}}ItemAttributes >
+\t) => {{pascalCase}}ItemAttributes;
+
+export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;
+`;