@wp-typia/project-tools 0.16.10 → 0.16.12

package/dist/runtime/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/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 { 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 {\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/built-in-block-code-templates/compound-child.js

@@ -0,0 +1,138 @@
+export const COMPOUND_CHILD_EDIT_TEMPLATE = `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
+import { RichText, useBlockProps } from '@wordpress/block-editor';
+import { Notice } from '@wordpress/components';
+import { __ } from '@wordpress/i18n';
+
+import { useTypiaValidation } from './hooks';
+import type { {{pascalCase}}ItemAttributes } from './types';
+import {
+\tcreateAttributeUpdater,
+\tvalidate{{pascalCase}}ItemAttributes,
+} from './validators';
+
+type EditProps = BlockEditProps< {{pascalCase}}ItemAttributes >;
+
+export default function Edit( {
+\tattributes,
+\tsetAttributes,
+}: EditProps ) {
+\tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );
+\tconst { errorMessages, isValid } = useTypiaValidation(
+\t\tattributes,
+\t\tvalidate{{pascalCase}}ItemAttributes
+\t);
+
+\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</div>
+\t);
+}
+`;
+export const COMPOUND_CHILD_SAVE_TEMPLATE = `import { RichText, useBlockProps } from '@wordpress/block-editor';
+
+import type { {{pascalCase}}ItemAttributes } from './types';
+
+export default function Save( {
+\tattributes,
+}: {
+\tattributes: {{pascalCase}}ItemAttributes;
+} ) {
+\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</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;
+`;

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

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

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

@@ -0,0 +1,227 @@
+export const COMPOUND_PARENT_EDIT_TEMPLATE = `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
+import { __ } from '@wordpress/i18n';
+import {
+	InspectorControls,
+	InnerBlocks,
+	RichText,
+	useBlockProps,
+} from '@wordpress/block-editor';
+import { Notice, PanelBody, ToggleControl } from '@wordpress/components';
+
+import {
+	ALLOWED_CHILD_BLOCKS,
+	DEFAULT_CHILD_TEMPLATE,
+} from './children';
+import { useTypiaValidation } from './hooks';
+import type { {{pascalCase}}Attributes } from './types';
+import {
+	createAttributeUpdater,
+	validate{{pascalCase}}Attributes,
+} from './validators';
+
+type EditProps = BlockEditProps< {{pascalCase}}Attributes >;
+
+export default function Edit( {
+	attributes,
+	setAttributes,
+}: EditProps ) {
+	const { errorMessages, isValid } = useTypiaValidation(
+		attributes,
+		validate{{pascalCase}}Attributes
+	);
+	const updateAttribute = createAttributeUpdater( attributes, setAttributes );
+	const blockProps = useBlockProps( {
+		className: '{{cssClassName}}',
+	} );
+
+	return (
+		<>
+			<InspectorControls>
+				<PanelBody title={ __( 'Compound Settings', '{{textDomain}}' ) }>
+					<ToggleControl
+						label={ __( 'Show dividers between items', '{{textDomain}}' ) }
+						checked={ attributes.showDividers ?? true }
+						onChange={ ( value ) => updateAttribute( 'showDividers', value ) }
+					/>
+				</PanelBody>
+				{ ! isValid && (
+					<PanelBody title={ __( 'Validation Errors', '{{textDomain}}' ) } initialOpen>
+						{ errorMessages.map( ( error, index ) => (
+							<Notice key={ index } status="error" isDismissible={ false }>
+								{ error }
+							</Notice>
+						) ) }
+					</PanelBody>
+				) }
+			</InspectorControls>
+			<div { ...blockProps }>
+				<RichText
+					tagName="h3"
+					className="{{cssClassName}}__heading"
+					value={ attributes.heading }
+					onChange={ ( heading ) => updateAttribute( 'heading', heading ) }
+					placeholder={ __( {{titleJson}}, '{{textDomain}}' ) }
+				/>
+				<RichText
+					tagName="p"
+					className="{{cssClassName}}__intro"
+					value={ attributes.intro ?? '' }
+					onChange={ ( intro ) => updateAttribute( 'intro', intro ) }
+					placeholder={ __(
+						'Add and reorder internal items inside this compound block.',
+						'{{textDomain}}'
+					) }
+				/>
+				{ ! isValid && (
+					<Notice status="error" isDismissible={ false }>
+						<ul>
+							{ errorMessages.map( ( error, index ) => <li key={ index }>{ error }</li> ) }
+						</ul>
+					</Notice>
+				) }
+				<div className="{{cssClassName}}__items">
+					<InnerBlocks
+						allowedBlocks={ ALLOWED_CHILD_BLOCKS }
+						renderAppender={ InnerBlocks.ButtonBlockAppender }
+						template={ DEFAULT_CHILD_TEMPLATE }
+						templateLock={ false }
+					/>
+				</div>
+			</div>
+		</>
+	);
+}
+`;
+export const COMPOUND_PARENT_SAVE_TEMPLATE = `import { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';
+
+import type { {{pascalCase}}Attributes } from './types';
+
+export default function Save( {
+	attributes,
+}: {
+	attributes: {{pascalCase}}Attributes;
+} ) {
+	return (
+		<div
+			{ ...useBlockProps.save( {
+				className: '{{cssClassName}}',
+				'data-show-dividers': ( attributes.showDividers ?? true ) ? 'true' : 'false',
+			} ) }
+		>
+			<RichText.Content
+				tagName="h3"
+				className="{{cssClassName}}__heading"
+				value={ attributes.heading }
+			/>
+			<RichText.Content
+				tagName="p"
+				className="{{cssClassName}}__intro"
+				value={ attributes.intro ?? '' }
+			/>
+			<div className="{{cssClassName}}__items">
+				<InnerBlocks.Content />
+			</div>
+		</div>
+	);
+}
+`;
+export const COMPOUND_PARENT_INDEX_TEMPLATE = `import {
+\tregisterScaffoldBlockType,
+\ttype BlockConfiguration,
+} from '@wp-typia/block-types/blocks/registration';
+import {
+\tbuildScaffoldBlockRegistration,
+\tparseScaffoldBlockMetadata,
+} from '@wp-typia/block-runtime/blocks';
+
+import Edit from './edit';
+import Save from './save';
+import metadata from './block-metadata';
+import './style.scss';
+
+import type { {{pascalCase}}Attributes } from './types';
+
+const registration = buildScaffoldBlockRegistration(
+\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}Attributes >>( metadata ),
+\t{
+\t\tedit: Edit,
+\t\tsave: Save,
+\t}
+);
+
+registerScaffoldBlockType(registration.name, registration.settings);
+`;
+export const COMPOUND_LOCAL_HOOKS_TEMPLATE = `export {
+	formatValidationError,
+	formatValidationErrors,
+	useTypiaValidation,
+} from '../../hooks';
+
+export type {
+	TypiaValidationError,
+	ValidationResult,
+	ValidationState,
+} from '../../hooks';
+`;
+export const COMPOUND_PARENT_VALIDATORS_TEMPLATE = `import typia from 'typia';
+import currentManifest from './manifest-defaults-document';
+import type {
+\t{{pascalCase}}Attributes,
+\t{{pascalCase}}ValidationResult,
+} from './types';
+import { createTemplateValidatorToolkit } from '../../validator-toolkit';
+
+const scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}Attributes >( {
+\tassert: typia.createAssert< {{pascalCase}}Attributes >(),
+\tclone: typia.misc.createClone< {{pascalCase}}Attributes >() as (
+\t\tvalue: {{pascalCase}}Attributes,
+\t) => {{pascalCase}}Attributes,
+\tis: typia.createIs< {{pascalCase}}Attributes >(),
+\tmanifest: currentManifest,
+\tprune: typia.misc.createPrune< {{pascalCase}}Attributes >(),
+\trandom: typia.createRandom< {{pascalCase}}Attributes >() as (
+\t\t...args: unknown[]
+\t) => {{pascalCase}}Attributes,
+\tvalidate: typia.createValidate< {{pascalCase}}Attributes >(),
+} );
+
+export const validate{{pascalCase}}Attributes =
+\tscaffoldValidators.validateAttributes as (
+\t\tattributes: unknown
+\t) => {{pascalCase}}ValidationResult;
+
+export const validators = scaffoldValidators.validators;
+
+export const sanitize{{pascalCase}}Attributes =
+\tscaffoldValidators.sanitizeAttributes as (
+\t\tattributes: Partial< {{pascalCase}}Attributes >
+\t) => {{pascalCase}}Attributes;
+
+export const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;
+`;
+export const COMPOUND_CHILDREN_TEMPLATE = `import type { BlockTemplate } from '@wp-typia/block-types/blocks/registration';
+
+export const DEFAULT_CHILD_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}-item';
+
+export const ALLOWED_CHILD_BLOCKS = [
+\tDEFAULT_CHILD_BLOCK_NAME,
+\t// add-child: insert new allowed child block names here
+];
+
+export const DEFAULT_CHILD_TEMPLATE: BlockTemplate = [
+\t[
+\t\tDEFAULT_CHILD_BLOCK_NAME,
+\t\t{
+\t\t\tbody: 'Add supporting details for the first internal item.',
+\t\t\ttitle: 'First Item',
+\t\t},
+\t],
+\t[
+\t\tDEFAULT_CHILD_BLOCK_NAME,
+\t\t{
+\t\t\tbody: 'Add supporting details for the second internal item.',
+\t\t\ttitle: 'Second Item',
+\t\t},
+\t],
+];
+`;