@wp-typia/project-tools 0.18.0 → 0.19.1

package/dist/runtime/alternate-render-targets.d.ts

@@ -0,0 +1,5 @@
+export declare const ALTERNATE_RENDER_TARGET_IDS: readonly ["email", "mjml", "plain-text"];
+export type AlternateRenderTargetId = (typeof ALTERNATE_RENDER_TARGET_IDS)[number];
+export declare function isAlternateRenderTargetId(value: string): value is AlternateRenderTargetId;
+export declare function parseAlternateRenderTargets(value?: string): AlternateRenderTargetId[];
+export declare function formatAlternateRenderTargets(targets: readonly AlternateRenderTargetId[]): string;

package/dist/runtime/alternate-render-targets.js

@@ -0,0 +1,29 @@
+export const ALTERNATE_RENDER_TARGET_IDS = [
+    "email",
+    "mjml",
+    "plain-text",
+];
+export function isAlternateRenderTargetId(value) {
+    return ALTERNATE_RENDER_TARGET_IDS.includes(value);
+}
+export function parseAlternateRenderTargets(value) {
+    if (typeof value !== "string") {
+        return [];
+    }
+    const normalized = value
+        .split(",")
+        .map((entry) => entry.trim().toLowerCase())
+        .filter(Boolean);
+    if (normalized.length === 0) {
+        return [];
+    }
+    const deduped = Array.from(new Set(normalized));
+    const invalid = deduped.filter((entry) => !isAlternateRenderTargetId(entry));
+    if (invalid.length > 0) {
+        throw new Error(`Unsupported alternate render target${invalid.length > 1 ? "s" : ""} "${invalid.join(", ")}". Expected one of: ${ALTERNATE_RENDER_TARGET_IDS.join(", ")}.`);
+    }
+    return deduped;
+}
+export function formatAlternateRenderTargets(targets) {
+    return targets.join(", ");
+}

package/dist/runtime/block-generator-service-core.d.ts

@@ -1,7 +1,7 @@
 import { type ApplyBlockInput, type PlanBlockInput, type PlanBlockResult, type RenderBlockInput, type RenderBlockResult, type ValidateBlockInput, type ValidateBlockResult } from "./block-generator-service-spec.js";
 import type { ScaffoldProjectResult } from "./scaffold.js";
 export declare class BlockGeneratorService {
-    plan({ allowExistingDir, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }: PlanBlockInput): Promise<PlanBlockResult>;
+    plan({ allowExistingDir, alternateRenderTargets, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }: PlanBlockInput): Promise<PlanBlockResult>;
     validate({ plan }: ValidateBlockInput): Promise<ValidateBlockResult>;
     render({ validated }: RenderBlockInput): Promise<RenderBlockResult>;
     apply({ rendered, installDependencies, onProgress, }: ApplyBlockInput): Promise<ScaffoldProjectResult>;

package/dist/runtime/block-generator-service-core.js

@@ -7,6 +7,7 @@ import { resolveTemplateSeed, parseTemplateLocator } from "./template-source.js"
 import { assertExternalTemplateLayersDoNotWriteProtectedOutputs, resolveExternalTemplateLayers, } from "./template-layers.js";
 import { getBuiltInTemplateOverlayDir, getBuiltInTemplateSharedLayerDirs, resolveBuiltInTemplateSource, resolveBuiltInTemplateSourceFromLayerDirs, } from "./template-builtins.js";
 import { buildTemplateVariablesFromBlockSpec, createBuiltInBlockSpec, } from "./block-generator-service-spec.js";
+import { assertBuiltInTemplateVariantAllowed, assertExternalLayerCompositionOptions, } from "./cli-validation.js";
 const renderedArtifactCache = new WeakMap();
 function createVariablesFingerprint(variables) {
     return stableJsonStringify(variables);
@@ -82,9 +83,10 @@ async function runCleanupGroup(label, cleanups) {
     }
 }
 export class BlockGeneratorService {
-    async plan({ allowExistingDir = false, answers, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall = false, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+    async plan({ allowExistingDir = false, alternateRenderTargets, answers, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall = false, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
         return {
             spec: createBuiltInBlockSpec({
+                alternateRenderTargets,
                 answers,
                 dataStorageMode,
                 persistencePolicy,
@@ -108,12 +110,14 @@ export class BlockGeneratorService {
         };
     }
     async validate({ plan }) {
-        if (plan.target.externalLayerId && !plan.target.externalLayerSource) {
-            throw new Error("externalLayerId requires externalLayerSource when composing built-in template layers.");
-        }
-        if (plan.target.variant) {
-            throw new Error(`--variant is only supported for official external template configs. Received variant "${plan.target.variant}" for built-in template "${plan.spec.template.family}".`);
-        }
+        assertExternalLayerCompositionOptions({
+            externalLayerId: plan.target.externalLayerId,
+            externalLayerSource: plan.target.externalLayerSource,
+        });
+        assertBuiltInTemplateVariantAllowed({
+            templateId: plan.spec.template.family,
+            variant: plan.target.variant,
+        });
         return plan;
     }
     async render({ validated }) {

package/dist/runtime/block-generator-service-spec.d.ts

@@ -1,14 +1,20 @@
 import type { PackageManagerId } from "./package-managers.js";
+import { type AlternateRenderTargetId } from "./alternate-render-targets.js";
+import { type CompoundInnerBlocksPresetId } from "./compound-inner-blocks.js";
 import { type BuiltInTemplateId } from "./template-registry.js";
 import type { InstallDependenciesOptions } from "./scaffold-apply-utils.js";
 import type { DataStorageMode, PersistencePolicy, ScaffoldAnswers, ScaffoldProgressEvent, ScaffoldTemplateVariables } from "./scaffold.js";
 export interface BlockSpec {
+    alternateRenderTargets: readonly AlternateRenderTargetId[];
     block: {
         namespace: string;
         phpPrefix: string;
         slug: string;
         textDomain: string;
     };
+    compound: {
+        innerBlocksPreset: CompoundInnerBlocksPresetId;
+    };
     metadata: {
         category: string;
         description: string;
@@ -57,6 +63,7 @@ export interface BlockGenerationTarget {
 }
 export interface PlanBlockInput {
     allowExistingDir?: boolean;
+    alternateRenderTargets?: string;
     answers: ScaffoldAnswers;
     cwd?: string;
     dataStorageMode?: DataStorageMode;
@@ -107,5 +114,5 @@ export interface ApplyBlockInput {
     installDependencies?: ((options: InstallDependenciesOptions) => Promise<void>) | undefined;
     onProgress?: ((event: ScaffoldProgressEvent) => void | Promise<void>) | undefined;
 }
-export declare function createBuiltInBlockSpec({ answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi, withTestPreset, withWpEnv, }: Omit<PlanBlockInput, "allowExistingDir" | "cwd" | "noInstall" | "packageManager" | "projectDir" | "variant">): BlockSpec;
+export declare function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi, withTestPreset, withWpEnv, }: Omit<PlanBlockInput, "allowExistingDir" | "cwd" | "noInstall" | "packageManager" | "projectDir" | "variant">): BlockSpec;
 export declare function buildTemplateVariablesFromBlockSpec(spec: BlockSpec): ScaffoldTemplateVariables;

package/dist/runtime/block-generator-service-spec.js

@@ -1,8 +1,11 @@
 import { getPackageVersions } from "./package-versions.js";
 import { BUILTIN_BLOCK_METADATA_VERSION, COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS, getBuiltInTemplateMetadataDefaults, } from "./template-defaults.js";
+import { formatAlternateRenderTargets, parseAlternateRenderTargets, } from "./alternate-render-targets.js";
+import { DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID, getCompoundInnerBlocksPresetDefinition, } from "./compound-inner-blocks.js";
 import { getTemplateById, } from "./template-registry.js";
 import { toPascalCase, toSnakeCase, } from "./string-case.js";
 import { buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, } from "./scaffold-identifiers.js";
+import { attachScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
 function getBuiltInPersistenceSpec({ templateId, dataStorageMode, persistencePolicy, }) {
     if (templateId === "persistence") {
         return {
@@ -33,7 +36,7 @@ const DEFAULT_QUERY_LOOP_ALLOWED_CONTROLS = [
     "author",
     "search",
 ];
-export function createBuiltInBlockSpec({ answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+export function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
     const template = getTemplateById(templateId);
     const metadataDefaults = getBuiltInTemplateMetadataDefaults(templateId);
     const identifiers = resolveScaffoldIdentifiers({
@@ -44,8 +47,17 @@ export function createBuiltInBlockSpec({ answers, dataStorageMode, persistencePo
     });
     const resolvedDataStorageMode = dataStorageMode ?? answers.dataStorageMode;
     const resolvedPersistencePolicy = persistencePolicy ?? answers.persistencePolicy;
+    const parsedAlternateRenderTargets = parseAlternateRenderTargets(alternateRenderTargets);
+    const innerBlocksPreset = templateId === "compound"
+        ? (answers.compoundInnerBlocksPreset ??
+            DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID)
+        : DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID;
     return {
+        alternateRenderTargets: parsedAlternateRenderTargets,
         block: identifiers,
+        compound: {
+            innerBlocksPreset,
+        },
         metadata: {
             category: metadataDefaults.category,
             description: answers.description.trim(),
@@ -94,16 +106,25 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
     const textDomain = spec.block.textDomain;
     const phpPrefix = spec.block.phpPrefix;
     const phpPrefixUpper = phpPrefix.toUpperCase();
+    const alternateRenderTargets = [...spec.alternateRenderTargets];
+    const hasAlternateEmailRenderTarget = alternateRenderTargets.includes("email");
+    const hasAlternateMjmlRenderTarget = alternateRenderTargets.includes("mjml");
+    const hasAlternatePlainTextRenderTarget = alternateRenderTargets.includes("plain-text");
     const compoundChildTitle = `${title} Item`;
     const cssClassName = buildBlockCssClassName(namespace, slug);
     const compoundChildCssClassName = buildBlockCssClassName(namespace, `${slug}-item`);
+    const compoundInnerBlocksPreset = spec.compound.innerBlocksPreset;
+    const compoundInnerBlocksPresetDefinition = getCompoundInnerBlocksPresetDefinition(compoundInnerBlocksPreset);
+    const compoundInnerBlocksOrientation = compoundInnerBlocksPresetDefinition.orientation ?? "";
     const persistenceEnabled = spec.persistence.enabled;
     const dataStorageMode = persistenceEnabled ? spec.persistence.dataStorageMode : "custom-table";
     const persistencePolicy = persistenceEnabled
         ? spec.persistence.persistencePolicy
         : "authenticated";
     const queryVariationNamespace = `${namespace}/${slug}`;
-    return {
+    const flatVariables = {
+        alternateRenderTargetsCsv: formatAlternateRenderTargets(alternateRenderTargets),
+        alternateRenderTargetsJson: JSON.stringify(alternateRenderTargets),
         apiClientPackageVersion,
         author: spec.project.author,
         blockRuntimePackageVersion,
@@ -117,6 +138,29 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
         compoundChildIcon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
         compoundChildTitleJson: JSON.stringify(compoundChildTitle),
         compoundPersistenceEnabled: spec.template.family === "compound" && persistenceEnabled ? "true" : "false",
+        compoundInnerBlocksDirectInsert: compoundInnerBlocksPresetDefinition.directInsert ? "true" : "false",
+        compoundInnerBlocksOrientation: compoundInnerBlocksOrientation,
+        compoundInnerBlocksOrientationExpression: compoundInnerBlocksPresetDefinition.orientation
+            ? `'${compoundInnerBlocksPresetDefinition.orientation}'`
+            : "undefined",
+        compoundInnerBlocksPreset,
+        compoundInnerBlocksPresetDescription: compoundInnerBlocksPresetDefinition.description,
+        compoundInnerBlocksPresetLabel: compoundInnerBlocksPresetDefinition.label,
+        compoundInnerBlocksTemplateLockExpression: compoundInnerBlocksPresetDefinition.templateLock === false
+            ? "false"
+            : `'${compoundInnerBlocksPresetDefinition.templateLock}'`,
+        hasAlternateEmailRenderTarget: hasAlternateEmailRenderTarget
+            ? "true"
+            : "false",
+        hasAlternateMjmlRenderTarget: hasAlternateMjmlRenderTarget
+            ? "true"
+            : "false",
+        hasAlternatePlainTextRenderTarget: hasAlternatePlainTextRenderTarget
+            ? "true"
+            : "false",
+        hasAlternateRenderTargets: alternateRenderTargets.length > 0
+            ? "true"
+            : "false",
         projectToolsPackageVersion,
         cssClassName,
         dashCase: slug,
@@ -163,4 +207,206 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
         titleCase: pascalCase,
         persistencePolicy,
     };
+    const shared = {
+        author: spec.project.author,
+        blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
+        category: spec.metadata.category,
+        cssClassName,
+        description: spec.metadata.description,
+        descriptionJson: flatVariables.descriptionJson,
+        frontendCssClassName: flatVariables.frontendCssClassName,
+        icon: spec.metadata.icon,
+        keyword: spec.metadata.keyword,
+        namespace,
+        pascalCase,
+        phpPrefix,
+        phpPrefixUpper,
+        slug,
+        slugCamelCase: flatVariables.slugCamelCase,
+        slugKebabCase: slug,
+        slugSnakeCase,
+        textDomain,
+        title,
+        titleCase: pascalCase,
+        titleJson: flatVariables.titleJson,
+        versions: {
+            apiClient: apiClientPackageVersion,
+            blockRuntime: blockRuntimePackageVersion,
+            blockTypes: blockTypesPackageVersion,
+            projectTools: projectToolsPackageVersion,
+            rest: restPackageVersion,
+        },
+    };
+    const alternateRenderTargetsGroup = {
+        csv: flatVariables.alternateRenderTargetsCsv,
+        enabled: alternateRenderTargets.length > 0,
+        hasEmail: hasAlternateEmailRenderTarget,
+        hasMjml: hasAlternateMjmlRenderTarget,
+        hasPlainText: hasAlternatePlainTextRenderTarget,
+        json: flatVariables.alternateRenderTargetsJson,
+        targets: alternateRenderTargets,
+    };
+    const compoundGroup = {
+        child: {
+            category: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.category,
+            cssClassName: compoundChildCssClassName,
+            icon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
+            title: compoundChildTitle,
+            titleJson: JSON.stringify(compoundChildTitle),
+        },
+        enabled: true,
+        innerBlocks: {
+            description: compoundInnerBlocksPresetDefinition.description,
+            directInsert: compoundInnerBlocksPresetDefinition.directInsert,
+            label: compoundInnerBlocksPresetDefinition.label,
+            orientation: compoundInnerBlocksOrientation,
+            orientationExpression: compoundInnerBlocksPresetDefinition.orientation
+                ? `'${compoundInnerBlocksPresetDefinition.orientation}'`
+                : "undefined",
+            preset: compoundInnerBlocksPreset,
+            templateLockExpression: compoundInnerBlocksPresetDefinition.templateLock === false
+                ? "false"
+                : `'${compoundInnerBlocksPresetDefinition.templateLock}'`,
+        },
+        persistenceEnabled: persistenceEnabled,
+    };
+    const persistenceGroup = persistenceEnabled
+        ? {
+            auth: {
+                bootstrapCredentialDeclarations: flatVariables.bootstrapCredentialDeclarations,
+                descriptionJson: flatVariables.persistencePolicyDescriptionJson,
+                intent: flatVariables.restWriteAuthIntent,
+                isAuthenticated: persistencePolicy === "authenticated",
+                isPublic: persistencePolicy === "public",
+                mechanism: flatVariables.restWriteAuthMechanism,
+                mode: flatVariables.restWriteAuthMode,
+                publicWriteRequestIdDeclaration: flatVariables.publicWriteRequestIdDeclaration,
+            },
+            dataStorageMode,
+            enabled: true,
+            policy: persistencePolicy,
+            scope: spec.persistence.scope,
+        }
+        : null;
+    const queryLoopGroup = {
+        allowedControls: spec.queryLoop.allowedControls,
+        allowedControlsJson: flatVariables.queryAllowedControlsJson,
+        enabled: true,
+        postType: spec.queryLoop.postType,
+        postTypeJson: flatVariables.queryPostTypeJson,
+        variationNamespace: queryVariationNamespace,
+        variationNamespaceJson: flatVariables.queryVariationNamespaceJson,
+    };
+    switch (spec.template.family) {
+        case "basic":
+            return attachScaffoldTemplateVariableGroups(flatVariables, {
+                alternateRenderTargets: alternateRenderTargetsGroup,
+                compound: {
+                    enabled: false,
+                    persistenceEnabled: false,
+                },
+                persistence: {
+                    enabled: false,
+                    scope: "none",
+                },
+                queryLoop: {
+                    enabled: false,
+                },
+                shared,
+                template: {
+                    description: spec.template.description,
+                },
+                templateFamily: "basic",
+            });
+        case "interactivity":
+            return attachScaffoldTemplateVariableGroups(flatVariables, {
+                alternateRenderTargets: alternateRenderTargetsGroup,
+                compound: {
+                    enabled: false,
+                    persistenceEnabled: false,
+                },
+                persistence: {
+                    enabled: false,
+                    scope: "none",
+                },
+                queryLoop: {
+                    enabled: false,
+                },
+                shared,
+                template: {
+                    description: spec.template.description,
+                },
+                templateFamily: "interactivity",
+            });
+        case "persistence": {
+            if (persistenceGroup === null) {
+                throw new Error("Persistence scaffolds must provide persistence template variables.");
+            }
+            return attachScaffoldTemplateVariableGroups(flatVariables, {
+                alternateRenderTargets: alternateRenderTargetsGroup,
+                compound: {
+                    enabled: false,
+                    persistenceEnabled: false,
+                },
+                persistence: {
+                    ...persistenceGroup,
+                    scope: "single",
+                },
+                queryLoop: {
+                    enabled: false,
+                },
+                shared,
+                template: {
+                    description: spec.template.description,
+                },
+                templateFamily: "persistence",
+            });
+        }
+        case "compound": {
+            const compoundPersistenceGroup = persistenceGroup === null
+                ? {
+                    enabled: false,
+                    scope: "none",
+                }
+                : {
+                    ...persistenceGroup,
+                    scope: "compound-parent",
+                };
+            return attachScaffoldTemplateVariableGroups(flatVariables, {
+                alternateRenderTargets: alternateRenderTargetsGroup,
+                compound: compoundGroup,
+                persistence: compoundPersistenceGroup,
+                queryLoop: {
+                    enabled: false,
+                },
+                shared,
+                template: {
+                    description: spec.template.description,
+                },
+                templateFamily: "compound",
+            });
+        }
+        case "query-loop":
+            return attachScaffoldTemplateVariableGroups(flatVariables, {
+                alternateRenderTargets: alternateRenderTargetsGroup,
+                compound: {
+                    enabled: false,
+                    persistenceEnabled: false,
+                },
+                persistence: {
+                    enabled: false,
+                    scope: "none",
+                },
+                queryLoop: queryLoopGroup,
+                shared,
+                template: {
+                    description: spec.template.description,
+                },
+                templateFamily: "query-loop",
+            });
+        default: {
+            const unreachableTemplateFamily = spec.template.family;
+            throw new Error(`Unhandled scaffold template family: ${unreachableTemplateFamily}`);
+        }
+    }
 }

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

@@ -1,5 +1,6 @@
 import { buildBasicAttributes, buildBlockJsonAttributes, buildCompoundChildAttributes, buildCompoundParentAttributes, buildInteractivityAttributes, buildManifestDocument, buildPersistenceAttributes, DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER, } from "./built-in-block-artifact-documents.js";
 import { buildBasicTypesSource, buildCompoundChildTypesSource, buildCompoundTypesSource, buildInteractivityTypesSource, buildPersistenceTypesSource, } from "./built-in-block-artifact-types.js";
+import { getScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
 function stringifyBlockJsonDocument(document) {
     return `${JSON.stringify(document, null, "\t")}\n`;
 }
@@ -103,7 +104,8 @@ function buildPersistenceArtifact(variables) {
 }
 function buildCompoundParentArtifact(variables) {
     const attributes = buildCompoundParentAttributes(variables);
-    const persistenceEnabled = variables.compoundPersistenceEnabled === "true";
+    const compoundGroup = getScaffoldTemplateVariableGroups(variables).compound;
+    const persistenceEnabled = compoundGroup.enabled && compoundGroup.persistenceEnabled;
     return {
         blockJsonDocument: {
             $schema: "https://schemas.wp.org/trunk/block.json",

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

@@ -1,5 +1,6 @@
 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_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 { renderMustacheTemplateString } from "./template-render.js";
 function renderCodeTemplate(template, variables) {
     const rendered = renderMustacheTemplateString(template, variables);
@@ -98,7 +99,8 @@ function buildInteractivityCodeArtifacts(variables) {
 function buildCompoundCodeArtifacts(variables) {
     const parentBasePath = `src/blocks/${variables.slugKebabCase}`;
     const childBasePath = `src/blocks/${variables.slugKebabCase}-item`;
-    const compoundPersistenceEnabled = variables.compoundPersistenceEnabled === "true";
+    const compoundGroup = getScaffoldTemplateVariableGroups(variables).compound;
+    const compoundPersistenceEnabled = compoundGroup.enabled && compoundGroup.persistenceEnabled;
     return ensureUniqueArtifactPaths([
         createCodeArtifact("src/hooks.ts", SHARED_HOOKS_TEMPLATE, variables),
         ...createTypedJsonWrapperArtifacts(parentBasePath, variables),

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

@@ -1,4 +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\tgetChildAllowedBlocks,\n\tgetChildTemplate,\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 >;\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 nestedAllowedBlocks = getChildAllowedBlocks( metadata.name );\n\tconst nestedTemplate = getChildTemplate( metadata.name );\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<InnerBlocks\n\t\t\t\t\t\tallowedBlocks={ nestedAllowedBlocks }\n\t\t\t\t\t\trenderAppender={ InnerBlocks.ButtonBlockAppender }\n\t\t\t\t\t\ttemplate={ nestedTemplate }\n\t\t\t\t\t\ttemplateLock={ false }\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_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/built-in-block-code-templates/compound-child.js

@@ -5,8 +5,7 @@ import { __ } from '@wordpress/i18n';
 
 import metadata from './block-metadata';
 import {
-\tgetChildAllowedBlocks,
-\tgetChildTemplate,
+\tgetChildInnerBlocksPropsOptions,
 \thasNestedChildBlocks,
 } from '../{{slugKebabCase}}/children';
 import { useTypiaValidation } from './hooks';
@@ -17,6 +16,14 @@ import {
 } 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,
@@ -27,8 +34,9 @@ export default function Edit( {
 \t\tattributes,
 \t\tvalidate{{pascalCase}}ItemAttributes
 \t);
-\tconst nestedAllowedBlocks = getChildAllowedBlocks( metadata.name );
-\tconst nestedTemplate = getChildTemplate( metadata.name );
+\tconst nestedInnerBlocksPropsOptions = getChildInnerBlocksPropsOptions(
+\t\tmetadata.name
+\t);
 \tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );
 
 \treturn (
@@ -56,11 +64,8 @@ export default function Edit( {
 \t\t\t) }
 \t\t\t{ showsNestedChildren && (
 \t\t\t\t<div className="{{compoundChildCssClassName}}__children">
-\t\t\t\t\t<InnerBlocks
-\t\t\t\t\t\tallowedBlocks={ nestedAllowedBlocks }
-\t\t\t\t\t\trenderAppender={ InnerBlocks.ButtonBlockAppender }
-\t\t\t\t\t\ttemplate={ nestedTemplate }
-\t\t\t\t\t\ttemplateLock={ false }
+\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) }

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

@@ -1,6 +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_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\tgetRootInnerBlocksPropsOptions,\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 >;\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 { 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\tconst rootInnerBlocksPropsOptions = getRootInnerBlocksPropsOptions();\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<TypedInnerBlocks { ...rootInnerBlocksPropsOptions } />\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 interface CompoundChildSpec {\n\tancestorKeys: string[];\n\tblockName: string;\n\tbodyPlaceholder: string;\n\tcontainer: boolean;\n\tfolderSlug: string;\n\tkey: string;\n\tplacement: 'nested' | 'root';\n\tsupportsInserter: boolean;\n\ttemplateInstances: Array< Record< string, unknown > >;\n\ttitle: string;\n}\n\nconst ROOT_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}';\n\nexport const COMPOUND_CHILD_SPECS: CompoundChildSpec[] = [\n\t{\n\t\tancestorKeys: [],\n\t\tblockName: DEFAULT_CHILD_BLOCK_NAME,\n\t\tbodyPlaceholder: 'Add supporting details for this internal item.',\n\t\tcontainer: false,\n\t\tfolderSlug: '{{slugKebabCase}}-item',\n\t\tkey: 'item',\n\t\tplacement: 'root',\n\t\tsupportsInserter: false,\n\t\ttemplateInstances: [\n\t\t\t{\n\t\t\t\tbody: 'Add supporting details for the first internal item.',\n\t\t\t\ttitle: 'First Item',\n\t\t\t},\n\t\t\t{\n\t\t\t\tbody: 'Add supporting details for the second internal item.',\n\t\t\t\ttitle: 'Second Item',\n\t\t\t},\n\t\t],\n\t\ttitle: '{{compoundChildTitle}}',\n\t},\n\t// add-child: insert new child specs here\n];\n\nfunction getChildSpecByKey( key: string ): CompoundChildSpec | undefined {\n\treturn COMPOUND_CHILD_SPECS.find( ( spec ) => spec.key === key );\n}\n\nfunction buildTemplateEntriesForSpec( spec: CompoundChildSpec ): BlockTemplate {\n\tconst nestedTemplate = buildNestedTemplateForKey( spec.key );\n\n\treturn spec.templateInstances.map( ( attributes ) =>\n\t\tnestedTemplate.length > 0\n\t\t\t? [ spec.blockName, attributes, nestedTemplate ]\n\t\t\t: [ spec.blockName, attributes ]\n\t);\n}\n\nfunction buildNestedTemplateForKey( key: string ): BlockTemplate {\n\treturn COMPOUND_CHILD_SPECS.filter(\n\t\t( spec ) =>\n\t\t\tspec.placement === 'nested' &&\n\t\t\tspec.ancestorKeys[ spec.ancestorKeys.length - 1 ] === key\n\t).flatMap( ( spec ) => buildTemplateEntriesForSpec( spec ) );\n}\n\nexport const ALLOWED_CHILD_BLOCKS = COMPOUND_CHILD_SPECS.filter(\n\t( spec ) => spec.placement === 'root'\n).map( ( spec ) => spec.blockName );\n\nexport const DEFAULT_CHILD_TEMPLATE: BlockTemplate =\n\tCOMPOUND_CHILD_SPECS.filter( ( spec ) => spec.placement === 'root' ).flatMap(\n\t\t( spec ) => buildTemplateEntriesForSpec( spec )\n\t);\n\nexport function getChildSpec( blockName: string ): CompoundChildSpec | undefined {\n\treturn COMPOUND_CHILD_SPECS.find( ( spec ) => spec.blockName === blockName );\n}\n\nexport function getChildAllowedBlocks(\n\tblockName: string\n): string[] | undefined {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec ) {\n\t\treturn undefined;\n\t}\n\n\tconst directDescendants = COMPOUND_CHILD_SPECS.filter(\n\t\t( spec ) =>\n\t\t\tspec.placement === 'nested' &&\n\t\t\tspec.ancestorKeys[ spec.ancestorKeys.length - 1 ] === childSpec.key\n\t).map( ( spec ) => spec.blockName );\n\n\tif ( directDescendants.length > 0 ) {\n\t\treturn directDescendants;\n\t}\n\n\treturn childSpec.container ? [] : undefined;\n}\n\nexport function getChildAncestorBlockNames(\n\tblockName: string\n): string[] | undefined {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec || childSpec.ancestorKeys.length === 0 ) {\n\t\treturn undefined;\n\t}\n\n\treturn childSpec.ancestorKeys.flatMap( ( key ) => {\n\t\tconst ancestorSpec = getChildSpecByKey( key );\n\t\treturn ancestorSpec ? [ ancestorSpec.blockName ] : [];\n\t} );\n}\n\nexport function getChildTemplate(\n\tblockName: string\n): BlockTemplate | undefined {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec ) {\n\t\treturn undefined;\n\t}\n\n\tconst nestedTemplate = buildNestedTemplateForKey( childSpec.key );\n\tif ( nestedTemplate.length > 0 ) {\n\t\treturn nestedTemplate;\n\t}\n\n\treturn childSpec.container ? [] : undefined;\n}\n\nexport function hasNestedChildBlocks( blockName: string ): boolean {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec ) {\n\t\treturn false;\n\t}\n\n\treturn childSpec.container || buildNestedTemplateForKey( childSpec.key ).length > 0;\n}\n\nexport function isRootCompoundChildBlock( blockName: string ): boolean {\n\tconst childSpec = getChildSpec( blockName );\n\treturn childSpec?.placement === 'root';\n}\n\nexport { ROOT_BLOCK_NAME };\n";
+export declare const COMPOUND_CHILDREN_TEMPLATE = "import type { BlockTemplate } from '@wp-typia/block-types/blocks/registration';\nimport { InnerBlocks } from '@wordpress/block-editor';\n\nexport const DEFAULT_CHILD_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}-item';\n\nexport interface CompoundChildSpec {\n\tancestorKeys: string[];\n\tblockName: string;\n\tbodyPlaceholder: string;\n\tcontainer: boolean;\n\tfolderSlug: string;\n\tkey: string;\n\tplacement: 'nested' | 'root';\n\tsupportsInserter: boolean;\n\ttemplateInstances: Array< Record< string, unknown > >;\n\ttitle: string;\n}\n\nexport interface CompoundInnerBlocksConfig {\n\tdefaultBlock?: [ string, Record< string, unknown > ];\n\tdirectInsert: boolean;\n\torientation?: 'horizontal' | 'vertical';\n\ttemplate?: BlockTemplate;\n\ttemplateLock: false | 'insert' | 'all';\n}\n\nexport type CompoundInnerBlocksPropsOptions = CompoundInnerBlocksConfig & {\n\trenderAppender?: typeof InnerBlocks.ButtonBlockAppender;\n};\n\nexport const ROOT_INNER_BLOCKS_PRESET_ID = '{{compoundInnerBlocksPreset}}';\nexport const ROOT_INNER_BLOCKS_PRESET_DESCRIPTION =\n\t'{{compoundInnerBlocksPresetDescription}}';\n\nconst BASE_INNER_BLOCKS_CONFIG: Omit<\n\tCompoundInnerBlocksConfig,\n\t'defaultBlock' | 'template'\n> = {\n\tdirectInsert: {{compoundInnerBlocksDirectInsert}},\n\torientation: {{compoundInnerBlocksOrientationExpression}},\n\ttemplateLock: {{compoundInnerBlocksTemplateLockExpression}},\n};\n\nconst ROOT_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}';\n\nexport const COMPOUND_CHILD_SPECS: CompoundChildSpec[] = [\n\t{\n\t\tancestorKeys: [],\n\t\tblockName: DEFAULT_CHILD_BLOCK_NAME,\n\t\tbodyPlaceholder: 'Add supporting details for this internal item.',\n\t\tcontainer: false,\n\t\tfolderSlug: '{{slugKebabCase}}-item',\n\t\tkey: 'item',\n\t\tplacement: 'root',\n\t\tsupportsInserter: false,\n\t\ttemplateInstances: [\n\t\t\t{\n\t\t\t\tbody: 'Add supporting details for the first internal item.',\n\t\t\t\ttitle: 'First Item',\n\t\t\t},\n\t\t\t{\n\t\t\t\tbody: 'Add supporting details for the second internal item.',\n\t\t\t\ttitle: 'Second Item',\n\t\t\t},\n\t\t],\n\t\ttitle: '{{compoundChildTitle}}',\n\t},\n\t// add-child: insert new child specs here\n];\n\nfunction buildTemplateEntriesForSpec( spec: CompoundChildSpec ): BlockTemplate {\n\tconst nestedTemplate = buildNestedTemplateForKey( spec.key );\n\n\treturn spec.templateInstances.map( ( attributes ) =>\n\t\tnestedTemplate.length > 0\n\t\t\t? [ spec.blockName, attributes, nestedTemplate ]\n\t\t\t: [ spec.blockName, attributes ]\n\t);\n}\n\nfunction buildNestedTemplateForKey( key: string ): BlockTemplate {\n\treturn COMPOUND_CHILD_SPECS.filter(\n\t\t( spec ) =>\n\t\t\tspec.placement === 'nested' &&\n\t\t\tspec.ancestorKeys[ spec.ancestorKeys.length - 1 ] === key\n\t).flatMap( ( spec ) => buildTemplateEntriesForSpec( spec ) );\n}\n\nexport const DEFAULT_CHILD_TEMPLATE: BlockTemplate =\n\tCOMPOUND_CHILD_SPECS.filter( ( spec ) => spec.placement === 'root' ).flatMap(\n\t\t( spec ) => buildTemplateEntriesForSpec( spec )\n\t);\n\nfunction buildDefaultBlockEntry(\n\ttemplate?: BlockTemplate\n): [ string, Record< string, unknown > ] | undefined {\n\tif (\n\t\t! BASE_INNER_BLOCKS_CONFIG.directInsert ||\n\t\t! Array.isArray( template ) ||\n\t\ttemplate.length === 0 ||\n\t\ttypeof template[ 0 ]?.[ 0 ] !== 'string'\n\t) {\n\t\treturn undefined;\n\t}\n\n\treturn [ template[ 0 ][ 0 ], {} ];\n}\n\nfunction buildInnerBlocksPropsOptions(\n\tconfig: CompoundInnerBlocksConfig\n): CompoundInnerBlocksPropsOptions {\n\treturn {\n\t\t...config,\n\t\trenderAppender:\n\t\t\tconfig.templateLock === 'all'\n\t\t\t\t? undefined\n\t\t\t\t: InnerBlocks.ButtonBlockAppender,\n\t};\n}\n\nexport function getRootInnerBlocksConfig(): CompoundInnerBlocksConfig {\n\treturn {\n\t\t...BASE_INNER_BLOCKS_CONFIG,\n\t\tdefaultBlock: buildDefaultBlockEntry( DEFAULT_CHILD_TEMPLATE ),\n\t\ttemplate: DEFAULT_CHILD_TEMPLATE,\n\t};\n}\n\nexport function getRootInnerBlocksPropsOptions(): CompoundInnerBlocksPropsOptions {\n\treturn buildInnerBlocksPropsOptions( getRootInnerBlocksConfig() );\n}\n\nexport function getChildSpec( blockName: string ): CompoundChildSpec | undefined {\n\treturn COMPOUND_CHILD_SPECS.find( ( spec ) => spec.blockName === blockName );\n}\n\nexport function getChildTemplate(\n\tblockName: string\n): BlockTemplate | undefined {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec ) {\n\t\treturn undefined;\n\t}\n\n\tconst nestedTemplate = buildNestedTemplateForKey( childSpec.key );\n\tif ( nestedTemplate.length > 0 ) {\n\t\treturn nestedTemplate;\n\t}\n\n\treturn childSpec.container ? [] : undefined;\n}\n\nexport function getChildInnerBlocksConfig(\n\tblockName: string\n): CompoundInnerBlocksConfig | undefined {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec ) {\n\t\treturn undefined;\n\t}\n\n\tconst template = getChildTemplate( blockName );\n\n\tif ( ! childSpec.container && ! template ) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\t...BASE_INNER_BLOCKS_CONFIG,\n\t\tdefaultBlock: buildDefaultBlockEntry( template ),\n\t\ttemplate,\n\t};\n}\n\nexport function getChildInnerBlocksPropsOptions(\n\tblockName: string\n): CompoundInnerBlocksPropsOptions | undefined {\n\tconst config = getChildInnerBlocksConfig( blockName );\n\tif ( ! config ) {\n\t\treturn undefined;\n\t}\n\n\treturn buildInnerBlocksPropsOptions( config );\n}\n\nexport function hasNestedChildBlocks( blockName: string ): boolean {\n\tconst childSpec = getChildSpec( blockName );\n\tif ( ! childSpec ) {\n\t\treturn false;\n\t}\n\n\treturn childSpec.container || buildNestedTemplateForKey( childSpec.key ).length > 0;\n}\n\nexport function isRootCompoundChildBlock( blockName: string ): boolean {\n\tconst childSpec = getChildSpec( blockName );\n\treturn childSpec?.placement === 'root';\n}\n\nexport { ROOT_BLOCK_NAME };\n";