@wp-typia/project-tools 0.16.14 → 0.18.0

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

@@ -4,5 +4,5 @@ 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>;
     validate({ plan }: ValidateBlockInput): Promise<ValidateBlockResult>;
     render({ validated }: RenderBlockInput): Promise<RenderBlockResult>;
-    apply({ rendered, installDependencies, }: ApplyBlockInput): Promise<ScaffoldProjectResult>;
+    apply({ rendered, installDependencies, onProgress, }: ApplyBlockInput): Promise<ScaffoldProjectResult>;
 }

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

@@ -222,7 +222,7 @@ export class BlockGeneratorService {
         });
         return rendered;
     }
-    async apply({ rendered, installDependencies, }) {
+    async apply({ rendered, installDependencies, onProgress, }) {
         const cachedArtifacts = renderedArtifactCache.get(rendered);
         const currentVariablesFingerprint = createVariablesFingerprint(rendered.variables);
         const artifacts = cachedArtifacts &&
@@ -246,6 +246,7 @@ export class BlockGeneratorService {
                 codeArtifacts,
                 installDependencies,
                 noInstall: rendered.target.noInstall,
+                onProgress,
                 packageManager: rendered.target.packageManager,
                 projectDir: rendered.target.projectDir,
                 repositoryReference: rendered.target.repositoryReference,

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

@@ -1,7 +1,7 @@
 import type { PackageManagerId } from "./package-managers.js";
 import { type BuiltInTemplateId } from "./template-registry.js";
 import type { InstallDependenciesOptions } from "./scaffold-apply-utils.js";
-import type { DataStorageMode, PersistencePolicy, ScaffoldAnswers, ScaffoldTemplateVariables } from "./scaffold.js";
+import type { DataStorageMode, PersistencePolicy, ScaffoldAnswers, ScaffoldProgressEvent, ScaffoldTemplateVariables } from "./scaffold.js";
 export interface BlockSpec {
     block: {
         namespace: string;
@@ -27,6 +27,11 @@ export interface BlockSpec {
     project: {
         author: string;
     };
+    queryLoop: {
+        allowedControls: readonly string[];
+        enabled: boolean;
+        postType: string;
+    };
     runtime: {
         withMigrationUi: boolean;
         withTestPreset: boolean;
@@ -66,6 +71,7 @@ export interface PlanBlockInput {
     templateId: BuiltInTemplateId;
     variant?: string;
     withMigrationUi?: boolean;
+    queryPostType?: string;
     withTestPreset?: boolean;
     withWpEnv?: boolean;
 }
@@ -99,6 +105,7 @@ export interface RenderBlockResult extends ValidateBlockResult {
 export interface ApplyBlockInput {
     rendered: RenderBlockResult;
     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 buildTemplateVariablesFromBlockSpec(spec: BlockSpec): ScaffoldTemplateVariables;

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

@@ -24,6 +24,15 @@ function getBuiltInPersistenceSpec({ templateId, dataStorageMode, persistencePol
         enabled: false,
     };
 }
+const DEFAULT_QUERY_LOOP_ALLOWED_CONTROLS = [
+    "inherit",
+    "postType",
+    "order",
+    "sticky",
+    "taxQuery",
+    "author",
+    "search",
+];
 export function createBuiltInBlockSpec({ answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
     const template = getTemplateById(templateId);
     const metadataDefaults = getBuiltInTemplateMetadataDefaults(templateId);
@@ -52,6 +61,17 @@ export function createBuiltInBlockSpec({ answers, dataStorageMode, persistencePo
         project: {
             author: answers.author.trim(),
         },
+        queryLoop: templateId === "query-loop"
+            ? {
+                allowedControls: DEFAULT_QUERY_LOOP_ALLOWED_CONTROLS,
+                enabled: true,
+                postType: (answers.queryPostType ?? "post").trim() || "post",
+            }
+            : {
+                allowedControls: [],
+                enabled: false,
+                postType: "post",
+            },
         runtime: {
             withMigrationUi,
             withTestPreset,
@@ -82,6 +102,7 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
     const persistencePolicy = persistenceEnabled
         ? spec.persistence.persistencePolicy
         : "authenticated";
+    const queryVariationNamespace = `${namespace}/${slug}`;
     return {
         apiClientPackageVersion,
         author: spec.project.author,
@@ -101,7 +122,13 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
         dashCase: slug,
         dataStorageMode,
         description: spec.metadata.description,
+        descriptionJson: JSON.stringify(spec.metadata.description),
         frontendCssClassName: buildFrontendCssClassName(cssClassName),
+        queryAllowedControlsJson: JSON.stringify(spec.queryLoop.enabled ? spec.queryLoop.allowedControls : [], null, 2),
+        queryPostType: spec.queryLoop.enabled ? spec.queryLoop.postType : "post",
+        queryPostTypeJson: JSON.stringify(spec.queryLoop.enabled ? spec.queryLoop.postType : "post"),
+        queryVariationNamespace,
+        queryVariationNamespaceJson: JSON.stringify(queryVariationNamespace),
         isAuthenticatedPersistencePolicy: persistencePolicy === "authenticated" ? "true" : "false",
         isPublicPersistencePolicy: persistencePolicy === "public" ? "true" : "false",
         bootstrapCredentialDeclarations: persistencePolicy === "public"

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

@@ -115,6 +115,7 @@ function buildCompoundParentArtifact(variables) {
             icon: variables.icon,
             description: variables.description,
             example: {},
+            allowedBlocks: [`${variables.namespace}/${variables.slugKebabCase}-item`],
             supports: persistenceEnabled
                 ? {
                     html: false,

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

@@ -1,5 +1,5 @@
 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, SHARED_HOOKS_TEMPLATE, } from "./built-in-block-code-templates.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 { renderMustacheTemplateString } from "./template-render.js";
 function renderCodeTemplate(template, variables) {
     const rendered = renderMustacheTemplateString(template, variables);
@@ -162,6 +162,17 @@ function buildPersistenceCodeArtifacts(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.
  *
@@ -179,6 +190,8 @@ export function buildBuiltInCodeArtifacts({ templateId, variables, }) {
             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/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 { 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_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_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

@@ -1,8 +1,14 @@
 export const COMPOUND_CHILD_EDIT_TEMPLATE = `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
-import { RichText, useBlockProps } from '@wordpress/block-editor';
+import { InnerBlocks, RichText, useBlockProps } from '@wordpress/block-editor';
 import { Notice } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
 
+import metadata from './block-metadata';
+import {
+\tgetChildAllowedBlocks,
+\tgetChildTemplate,
+\thasNestedChildBlocks,
+} from '../{{slugKebabCase}}/children';
 import { useTypiaValidation } from './hooks';
 import type { {{pascalCase}}ItemAttributes } from './types';
 import {
@@ -21,6 +27,9 @@ export default function Edit( {
 \t\tattributes,
 \t\tvalidate{{pascalCase}}ItemAttributes
 \t);
+\tconst nestedAllowedBlocks = getChildAllowedBlocks( metadata.name );
+\tconst nestedTemplate = getChildTemplate( metadata.name );
+\tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );
 
 \treturn (
 \t\t<div { ...useBlockProps( { className: '{{compoundChildCssClassName}}' } ) }>
@@ -45,12 +54,24 @@ export default function Edit( {
 \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<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/>
+\t\t\t\t</div>
+\t\t\t) }
 \t\t</div>
 \t);
 }
 `;
-export const COMPOUND_CHILD_SAVE_TEMPLATE = `import { RichText, useBlockProps } from '@wordpress/block-editor';
+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( {
@@ -58,6 +79,8 @@ export default function Save( {
 }: {
 \tattributes: {{pascalCase}}ItemAttributes;
 } ) {
+\tconst showsNestedChildren = hasNestedChildBlocks( metadata.name );
+
 \treturn (
 \t\t<div { ...useBlockProps.save( { className: '{{compoundChildCssClassName}}' } ) }>
 \t\t\t<RichText.Content
@@ -70,6 +93,11 @@ export default function Save( {
 \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);
 }

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

@@ -3,4 +3,4 @@ export declare const COMPOUND_PARENT_SAVE_TEMPLATE = "import { InnerBlocks, Rich
 export declare const COMPOUND_PARENT_INDEX_TEMPLATE = "import {\n\tregisterScaffoldBlockType,\n\ttype BlockConfiguration,\n} from '@wp-typia/block-types/blocks/registration';\nimport {\n\tbuildScaffoldBlockRegistration,\n\tparseScaffoldBlockMetadata,\n} from '@wp-typia/block-runtime/blocks';\n\nimport Edit from './edit';\nimport Save from './save';\nimport metadata from './block-metadata';\nimport './style.scss';\n\nimport type { {{pascalCase}}Attributes } from './types';\n\nconst registration = buildScaffoldBlockRegistration(\n\tparseScaffoldBlockMetadata<BlockConfiguration< {{pascalCase}}Attributes >>( metadata ),\n\t{\n\t\tedit: Edit,\n\t\tsave: Save,\n\t}\n);\n\nregisterScaffoldBlockType(registration.name, registration.settings);\n";
 export declare const COMPOUND_LOCAL_HOOKS_TEMPLATE = "export {\n\tformatValidationError,\n\tformatValidationErrors,\n\tuseTypiaValidation,\n} from '../../hooks';\n\nexport type {\n\tTypiaValidationError,\n\tValidationResult,\n\tValidationState,\n} from '../../hooks';\n";
 export declare const COMPOUND_PARENT_VALIDATORS_TEMPLATE = "import typia from 'typia';\nimport currentManifest from './manifest-defaults-document';\nimport type {\n\t{{pascalCase}}Attributes,\n\t{{pascalCase}}ValidationResult,\n} from './types';\nimport { createTemplateValidatorToolkit } from '../../validator-toolkit';\n\nconst scaffoldValidators = createTemplateValidatorToolkit< {{pascalCase}}Attributes >( {\n\tassert: typia.createAssert< {{pascalCase}}Attributes >(),\n\tclone: typia.misc.createClone< {{pascalCase}}Attributes >() as (\n\t\tvalue: {{pascalCase}}Attributes,\n\t) => {{pascalCase}}Attributes,\n\tis: typia.createIs< {{pascalCase}}Attributes >(),\n\tmanifest: currentManifest,\n\tprune: typia.misc.createPrune< {{pascalCase}}Attributes >(),\n\trandom: typia.createRandom< {{pascalCase}}Attributes >() as (\n\t\t...args: unknown[]\n\t) => {{pascalCase}}Attributes,\n\tvalidate: typia.createValidate< {{pascalCase}}Attributes >(),\n} );\n\nexport const validate{{pascalCase}}Attributes =\n\tscaffoldValidators.validateAttributes as (\n\t\tattributes: unknown\n\t) => {{pascalCase}}ValidationResult;\n\nexport const validators = scaffoldValidators.validators;\n\nexport const sanitize{{pascalCase}}Attributes =\n\tscaffoldValidators.sanitizeAttributes as (\n\t\tattributes: Partial< {{pascalCase}}Attributes >\n\t) => {{pascalCase}}Attributes;\n\nexport const createAttributeUpdater = scaffoldValidators.createAttributeUpdater;\n";
-export declare const COMPOUND_CHILDREN_TEMPLATE = "import type { BlockTemplate } from '@wp-typia/block-types/blocks/registration';\n\nexport const DEFAULT_CHILD_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}-item';\n\nexport const ALLOWED_CHILD_BLOCKS = [\n\tDEFAULT_CHILD_BLOCK_NAME,\n\t// add-child: insert new allowed child block names here\n];\n\nexport const DEFAULT_CHILD_TEMPLATE: BlockTemplate = [\n\t[\n\t\tDEFAULT_CHILD_BLOCK_NAME,\n\t\t{\n\t\t\tbody: 'Add supporting details for the first internal item.',\n\t\t\ttitle: 'First Item',\n\t\t},\n\t],\n\t[\n\t\tDEFAULT_CHILD_BLOCK_NAME,\n\t\t{\n\t\t\tbody: 'Add supporting details for the second internal item.',\n\t\t\ttitle: 'Second Item',\n\t\t},\n\t],\n];\n";
+export declare const COMPOUND_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";

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

@@ -203,25 +203,145 @@ export const COMPOUND_CHILDREN_TEMPLATE = `import type { BlockTemplate } from '@
 
 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 interface CompoundChildSpec {
+\tancestorKeys: string[];
+\tblockName: string;
+\tbodyPlaceholder: string;
+\tcontainer: boolean;
+\tfolderSlug: string;
+\tkey: string;
+\tplacement: 'nested' | 'root';
+\tsupportsInserter: boolean;
+\ttemplateInstances: Array< Record< string, unknown > >;
+\ttitle: string;
+}
+
+const ROOT_BLOCK_NAME = '{{namespace}}/{{slugKebabCase}}';
 
-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],
+export const COMPOUND_CHILD_SPECS: CompoundChildSpec[] = [
+\t{
+\t\tancestorKeys: [],
+\t\tblockName: DEFAULT_CHILD_BLOCK_NAME,
+\t\tbodyPlaceholder: 'Add supporting details for this internal item.',
+\t\tcontainer: false,
+\t\tfolderSlug: '{{slugKebabCase}}-item',
+\t\tkey: 'item',
+\t\tplacement: 'root',
+\t\tsupportsInserter: false,
+\t\ttemplateInstances: [
+\t\t\t{
+\t\t\t\tbody: 'Add supporting details for the first internal item.',
+\t\t\t\ttitle: 'First Item',
+\t\t\t},
+\t\t\t{
+\t\t\t\tbody: 'Add supporting details for the second internal item.',
+\t\t\t\ttitle: 'Second Item',
+\t\t\t},
+\t\t],
+\t\ttitle: '{{compoundChildTitle}}',
+\t},
+\t// add-child: insert new child specs here
 ];
+
+function getChildSpecByKey( key: string ): CompoundChildSpec | undefined {
+\treturn COMPOUND_CHILD_SPECS.find( ( spec ) => spec.key === key );
+}
+
+function buildTemplateEntriesForSpec( spec: CompoundChildSpec ): BlockTemplate {
+\tconst nestedTemplate = buildNestedTemplateForKey( spec.key );
+
+\treturn spec.templateInstances.map( ( attributes ) =>
+\t\tnestedTemplate.length > 0
+\t\t\t? [ spec.blockName, attributes, nestedTemplate ]
+\t\t\t: [ spec.blockName, attributes ]
+\t);
+}
+
+function buildNestedTemplateForKey( key: string ): BlockTemplate {
+\treturn COMPOUND_CHILD_SPECS.filter(
+\t\t( spec ) =>
+\t\t\tspec.placement === 'nested' &&
+\t\t\tspec.ancestorKeys[ spec.ancestorKeys.length - 1 ] === key
+\t).flatMap( ( spec ) => buildTemplateEntriesForSpec( spec ) );
+}
+
+export const ALLOWED_CHILD_BLOCKS = COMPOUND_CHILD_SPECS.filter(
+\t( spec ) => spec.placement === 'root'
+).map( ( spec ) => spec.blockName );
+
+export const DEFAULT_CHILD_TEMPLATE: BlockTemplate =
+\tCOMPOUND_CHILD_SPECS.filter( ( spec ) => spec.placement === 'root' ).flatMap(
+\t\t( spec ) => buildTemplateEntriesForSpec( spec )
+\t);
+
+export function getChildSpec( blockName: string ): CompoundChildSpec | undefined {
+\treturn COMPOUND_CHILD_SPECS.find( ( spec ) => spec.blockName === blockName );
+}
+
+export function getChildAllowedBlocks(
+\tblockName: string
+): string[] | undefined {
+\tconst childSpec = getChildSpec( blockName );
+\tif ( ! childSpec ) {
+\t\treturn undefined;
+\t}
+
+\tconst directDescendants = COMPOUND_CHILD_SPECS.filter(
+\t\t( spec ) =>
+\t\t\tspec.placement === 'nested' &&
+\t\t\tspec.ancestorKeys[ spec.ancestorKeys.length - 1 ] === childSpec.key
+\t).map( ( spec ) => spec.blockName );
+
+\tif ( directDescendants.length > 0 ) {
+\t\treturn directDescendants;
+\t}
+
+\treturn childSpec.container ? [] : undefined;
+}
+
+export function getChildAncestorBlockNames(
+\tblockName: string
+): string[] | undefined {
+\tconst childSpec = getChildSpec( blockName );
+\tif ( ! childSpec || childSpec.ancestorKeys.length === 0 ) {
+\t\treturn undefined;
+\t}
+
+\treturn childSpec.ancestorKeys.flatMap( ( key ) => {
+\t\tconst ancestorSpec = getChildSpecByKey( key );
+\t\treturn ancestorSpec ? [ ancestorSpec.blockName ] : [];
+\t} );
+}
+
+export function getChildTemplate(
+\tblockName: string
+): BlockTemplate | undefined {
+\tconst childSpec = getChildSpec( blockName );
+\tif ( ! childSpec ) {
+\t\treturn undefined;
+\t}
+
+\tconst nestedTemplate = buildNestedTemplateForKey( childSpec.key );
+\tif ( nestedTemplate.length > 0 ) {
+\t\treturn nestedTemplate;
+\t}
+
+\treturn childSpec.container ? [] : undefined;
+}
+
+export function hasNestedChildBlocks( blockName: string ): boolean {
+\tconst childSpec = getChildSpec( blockName );
+\tif ( ! childSpec ) {
+\t\treturn false;
+\t}
+
+\treturn childSpec.container || buildNestedTemplateForKey( childSpec.key ).length > 0;
+}
+
+export function isRootCompoundChildBlock( blockName: string ): boolean {
+\tconst childSpec = getChildSpec( blockName );
+\treturn childSpec?.placement === 'root';
+}
+
+export { ROOT_BLOCK_NAME };
 `;

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

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

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

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

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

@@ -6,4 +6,5 @@ export { BLOCK_METADATA_WRAPPER_TEMPLATE, MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEM
 export { BASIC_EDIT_TEMPLATE, BASIC_INDEX_TEMPLATE, BASIC_SAVE_TEMPLATE, BASIC_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/basic.js";
 export { INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/interactivity.js";
 export { PERSISTENCE_EDIT_TEMPLATE, PERSISTENCE_INDEX_TEMPLATE, PERSISTENCE_INTERACTIVITY_TEMPLATE, PERSISTENCE_SAVE_TEMPLATE, PERSISTENCE_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/persistence.js";
+export { QUERY_LOOP_INDEX_TEMPLATE, } from "./built-in-block-code-templates/query-loop.js";
 export { COMPOUND_CHILD_EDIT_TEMPLATE, COMPOUND_CHILD_INDEX_TEMPLATE, COMPOUND_CHILDREN_TEMPLATE, COMPOUND_CHILD_SAVE_TEMPLATE, COMPOUND_CHILD_VALIDATORS_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, } from "./built-in-block-code-templates/compound.js";

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

@@ -6,4 +6,5 @@ export { BLOCK_METADATA_WRAPPER_TEMPLATE, MANIFEST_DEFAULTS_DOCUMENT_WRAPPER_TEM
 export { BASIC_EDIT_TEMPLATE, BASIC_INDEX_TEMPLATE, BASIC_SAVE_TEMPLATE, BASIC_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/basic.js";
 export { INTERACTIVITY_EDIT_TEMPLATE, INTERACTIVITY_INDEX_TEMPLATE, INTERACTIVITY_SAVE_TEMPLATE, INTERACTIVITY_SCRIPT_TEMPLATE, INTERACTIVITY_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/interactivity.js";
 export { PERSISTENCE_EDIT_TEMPLATE, PERSISTENCE_INDEX_TEMPLATE, PERSISTENCE_INTERACTIVITY_TEMPLATE, PERSISTENCE_SAVE_TEMPLATE, PERSISTENCE_VALIDATORS_TEMPLATE, } from "./built-in-block-code-templates/persistence.js";
+export { QUERY_LOOP_INDEX_TEMPLATE, } from "./built-in-block-code-templates/query-loop.js";
 export { COMPOUND_CHILD_EDIT_TEMPLATE, COMPOUND_CHILD_INDEX_TEMPLATE, COMPOUND_CHILDREN_TEMPLATE, COMPOUND_CHILD_SAVE_TEMPLATE, COMPOUND_CHILD_VALIDATORS_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, } from "./built-in-block-code-templates/compound.js";

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

@@ -555,6 +555,8 @@ export function buildBuiltInNonTsArtifacts({ templateId, variables, }) {
             return buildPersistenceArtifacts(variables);
         case "compound":
             return buildCompoundArtifacts(variables);
+        case "query-loop":
+            return [];
         default: {
             const unhandledTemplateId = templateId;
             throw new Error(`Unhandled built-in template id: ${unhandledTemplateId}`);

package/dist/runtime/cli-add-block.d.ts

@@ -27,7 +27,8 @@ export declare function seedWorkspaceMigrationProject(projectDir: string, curren
  * succeeds.
  * @throws {Error} When the template id is unknown, persistence flags are used
  * with unsupported templates, the command runs outside an official workspace,
- * or target block paths already exist.
+ * workspace dependencies have not been installed yet, or target block paths
+ * already exist.
  */
 export declare function runAddBlockCommand({ blockName, cwd, dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, selectExternalLayerId, templateId, }: RunAddBlockCommandOptions): Promise<{
     blockSlugs: string[];

package/dist/runtime/cli-add-block.js

@@ -15,8 +15,15 @@ import { buildConfigEntries, buildMigrationBlocks, buildServerTemplateRoot, } fr
 import { COMPOUND_SHARED_SUPPORT_FILES, collectLegacyCompoundValidatorPaths, ensureBlockConfigCanAddRestManifests, ensureCompoundWorkspaceSupportFiles, } from "./cli-add-block-legacy-validator.js";
 import { parseTemplateLocator, resolveTemplateSeed, } from "./template-source.js";
 import { resolveExternalTemplateLayers, } from "./template-layers.js";
+import { formatInstallCommand, } from "./package-managers.js";
 import { resolveOptionalInteractiveExternalLayerId, } from "./external-layer-selection.js";
 const COLLECTION_IMPORT_LINE = "import '../../collection';";
+// This is a lightweight preflight heuristic for the common install layouts:
+// node_modules for npm/pnpm/bun/yarn-classic and Yarn PnP marker files.
+// It intentionally favors fast user guidance over exhaustive detection, so
+// stale node_modules or hoisted installs outside the workspace root can still
+// fall through to deeper resolver errors.
+const WORKSPACE_INSTALL_MARKERS = ["node_modules", ".pnp.cjs", ".pnp.loader.mjs"];
 async function ensureCollectionImport(filePath) {
     await patchFile(filePath, (source) => {
         if (source.includes(COLLECTION_IMPORT_LINE)) {
@@ -69,6 +76,15 @@ function resolveExternalLayerSourceFromCaller(source, callerCwd) {
     }
     return path.resolve(callerCwd, source);
 }
+function hasInstalledWorkspaceDependencies(projectDir) {
+    return WORKSPACE_INSTALL_MARKERS.some((marker) => fs.existsSync(path.join(projectDir, marker)));
+}
+function assertWorkspaceDependenciesInstalled(workspace) {
+    if (hasInstalledWorkspaceDependencies(workspace.projectDir)) {
+        return;
+    }
+    throw new Error(`Workspace dependencies have not been installed yet. Run \`${formatInstallCommand(workspace.packageManager)}\` from the workspace root before using \`wp-typia add block ...\`.`);
+}
 async function copyScaffoldedBlockSlice(projectDir, templateId, tempProjectDir, variables, legacyValidatorPaths = []) {
     if (templateId === "compound") {
         await ensureCompoundWorkspaceSupportFiles(projectDir, tempProjectDir, legacyValidatorPaths);
@@ -248,7 +264,8 @@ export async function seedWorkspaceMigrationProject(projectDir, currentMigration
  * succeeds.
  * @throws {Error} When the template id is unknown, persistence flags are used
  * with unsupported templates, the command runs outside an official workspace,
- * or target block paths already exist.
+ * workspace dependencies have not been installed yet, or target block paths
+ * already exist.
  */
 export async function runAddBlockCommand({ blockName, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, selectExternalLayerId, templateId = "basic", }) {
     if (!isAddBlockTemplateId(templateId)) {
@@ -257,6 +274,7 @@ export async function runAddBlockCommand({ blockName, cwd = process.cwd(), dataS
     const resolvedTemplateId = templateId;
     assertPersistenceFlagsAllowed(resolvedTemplateId, { dataStorageMode, persistencePolicy });
     const workspace = resolveWorkspaceProject(cwd);
+    assertWorkspaceDependenciesInstalled(workspace);
     const normalizedExternalLayerId = normalizeExternalLayerOption(externalLayerId);
     const normalizedExternalLayerSource = resolveExternalLayerSourceFromCaller(normalizeExternalLayerOption(externalLayerSource), cwd);
     const resolvedExternalLayerSelection = await resolveOptionalInteractiveExternalLayerId({