@wp-typia/project-tools 0.16.14 → 0.17.0

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

@@ -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;
 }

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-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/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-help.js

@@ -11,6 +11,7 @@ import { TEMPLATE_IDS } from "./template-registry.js";
 export function formatHelpText() {
     return `Usage:
   wp-typia create <project-dir> [--template <basic|interactivity>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template query-loop] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--query-post-type <post-type>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--no-install] [--package-manager <id>]
   wp-typia create <project-dir> [--template <./path|github:owner/repo/path[#ref]>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--no-install] [--package-manager <id>]
   wp-typia create <project-dir> [--template <npm-package>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--no-install] [--package-manager <id>]
   wp-typia create <project-dir> [--template persistence] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--no-install] [--package-manager <id>]

package/dist/runtime/cli-scaffold.d.ts

@@ -34,6 +34,7 @@ interface RunScaffoldFlowOptions {
     phpPrefix?: string;
     projectInput: string;
     promptText?: Parameters<typeof collectScaffoldAnswers>[0]["promptText"];
+    queryPostType?: string;
     selectDataStorage?: () => Promise<DataStorageMode>;
     selectExternalLayerId?: (options: ExternalLayerSelectionOption[]) => Promise<string>;
     selectPackageManager?: () => Promise<PackageManagerId>;
@@ -73,7 +74,7 @@ export declare function getOptionalOnboarding({ availableScripts, packageManager
  * project.
  * @returns The scaffold result together with next-step guidance.
  */
-export declare function runScaffoldFlow({ projectInput, cwd, templateId, dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, packageManager, namespace, textDomain, phpPrefix, yes, noInstall, isInteractive, allowExistingDir, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }: RunScaffoldFlowOptions): Promise<{
+export declare function runScaffoldFlow({ projectInput, cwd, templateId, dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, packageManager, namespace, textDomain, phpPrefix, queryPostType, yes, noInstall, isInteractive, allowExistingDir, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }: RunScaffoldFlowOptions): Promise<{
     optionalOnboarding: OptionalOnboardingGuidance;
     projectDir: string;
     projectInput: string;

package/dist/runtime/cli-scaffold.js

@@ -135,7 +135,7 @@ export function getOptionalOnboarding({ availableScripts, packageManager, templa
  * project.
  * @returns The scaffold result together with next-step guidance.
  */
-export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templateId, dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, packageManager, namespace, textDomain, phpPrefix, yes = false, noInstall = false, isInteractive = false, allowExistingDir = false, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies = undefined, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }) {
+export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templateId, dataStorageMode, externalLayerId, externalLayerSource, persistencePolicy, packageManager, namespace, textDomain, phpPrefix, queryPostType, yes = false, noInstall = false, isInteractive = false, allowExistingDir = false, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies = undefined, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }) {
     const normalizedExternalLayerId = typeof externalLayerId === "string" && externalLayerId.trim().length > 0
         ? externalLayerId.trim()
         : undefined;
@@ -228,6 +228,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
             persistencePolicy: resolvedPersistencePolicy,
             phpPrefix,
             projectName,
+            queryPostType,
             templateId: resolvedTemplateId,
             textDomain,
             yes,

package/dist/runtime/local-dev-presets.js

@@ -13,6 +13,12 @@ import { copyInterpolatedDirectory } from "./template-render.js";
 function templateHasPersistenceSync(templateId, compoundPersistenceEnabled) {
     return templateId === "persistence" || (templateId === "compound" && compoundPersistenceEnabled);
 }
+function templateSupportsGeneratedSyncWatchers(templateId) {
+    return (templateId === "basic" ||
+        templateId === "interactivity" ||
+        templateId === "persistence" ||
+        templateId === "compound");
+}
 function getWatchSyncTypesScript(packageManager, templateId) {
     if (templateId === "compound") {
         return `chokidar "src/blocks/**/types.ts" "scripts/block-config.ts" --debounce 200 -c "${formatRunScript(packageManager, "sync-types")}"`;
@@ -80,11 +86,16 @@ export async function applyLocalDevPresetFiles({ projectDir, variables, withTest
  */
 export async function applyGeneratedProjectDxPackageJson({ compoundPersistenceEnabled = false, packageManager, projectDir, templateId, withTestPreset = false, withWpEnv = false, }) {
     const hasPersistenceSync = templateHasPersistenceSync(templateId, compoundPersistenceEnabled);
+    const supportsGeneratedSyncWatchers = templateSupportsGeneratedSyncWatchers(templateId);
     await mutatePackageJson(projectDir, (packageJson) => {
         packageJson.devDependencies = {
             ...(packageJson.devDependencies ?? {}),
-            "chokidar-cli": "^3.0.0",
-            concurrently: "^9.0.1",
+            ...(supportsGeneratedSyncWatchers
+                ? {
+                    "chokidar-cli": "^3.0.0",
+                    concurrently: "^9.0.1",
+                }
+                : {}),
         };
         if (withWpEnv || withTestPreset) {
             packageJson.devDependencies["@wordpress/env"] = "^11.2.0";
@@ -95,12 +106,16 @@ export async function applyGeneratedProjectDxPackageJson({ compoundPersistenceEn
         const scripts = {
             ...(packageJson.scripts ?? {}),
         };
-        scripts["start:editor"] = "wp-scripts start --experimental-modules";
-        scripts["watch:sync-types"] = getWatchSyncTypesScript(packageManager, templateId);
+        if (supportsGeneratedSyncWatchers) {
+            scripts["start:editor"] = "wp-scripts start --experimental-modules";
+            scripts["watch:sync-types"] = getWatchSyncTypesScript(packageManager, templateId);
+        }
         if (hasPersistenceSync) {
             scripts["watch:sync-rest"] = getWatchSyncRestScript(packageManager, templateId);
         }
-        scripts.dev = getDevScript(packageManager, compoundPersistenceEnabled, templateId);
+        if (supportsGeneratedSyncWatchers) {
+            scripts.dev = getDevScript(packageManager, compoundPersistenceEnabled, templateId);
+        }
         if (withWpEnv) {
             scripts["wp-env:start"] = "wp-env start";
             scripts["wp-env:stop"] = "wp-env stop";
@@ -123,10 +138,5 @@ export async function applyGeneratedProjectDxPackageJson({ compoundPersistenceEn
  * scaffolded template.
  */
 export function getPrimaryDevelopmentScript(templateId) {
-    return templateId === "basic" ||
-        templateId === "interactivity" ||
-        templateId === "persistence" ||
-        templateId === "compound"
-        ? "dev"
-        : "start";
+    return templateSupportsGeneratedSyncWatchers(templateId) ? "dev" : "start";
 }

package/dist/runtime/scaffold-answer-resolution.d.ts

@@ -34,4 +34,4 @@ export declare function resolvePackageManagerId({ packageManager, yes, isInterac
  * @param options Answer collection inputs including prompt callbacks and explicit overrides.
  * @returns The normalized scaffold answers used for rendering and file generation.
  */
-export declare function collectScaffoldAnswers({ projectName, templateId, yes, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, textDomain, }: CollectScaffoldAnswersOptions): Promise<ScaffoldAnswers>;
+export declare function collectScaffoldAnswers({ projectName, templateId, yes, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, queryPostType, textDomain, }: CollectScaffoldAnswersOptions): Promise<ScaffoldAnswers>;

package/dist/runtime/scaffold-answer-resolution.js

@@ -37,11 +37,32 @@ export function getDefaultAnswers(projectName, templateId) {
         namespace: slugDefault,
         persistencePolicy: templateId === 'persistence' ? 'authenticated' : undefined,
         phpPrefix: toSnakeCase(slugDefault),
+        queryPostType: templateId === 'query-loop' ? 'post' : undefined,
         slug: slugDefault,
         textDomain: slugDefault,
         title: toTitleCase(slugDefault),
     };
 }
+function validateQueryPostType(value) {
+    const normalizedValue = value.trim().toLowerCase();
+    if (normalizedValue.length === 0) {
+        return 'Query post type is required.';
+    }
+    if (!/^[a-z0-9_-]{1,20}$/u.test(normalizedValue)) {
+        return 'Query post type must be lowercase, 1-20 chars, and only a-z, 0-9, "_" or "-".';
+    }
+    return true;
+}
+function normalizeQueryPostType(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalizedValue = value.trim().toLowerCase();
+    if (validateQueryPostType(normalizedValue) !== true) {
+        throw new Error('Query post type must be lowercase, 1-20 chars, and only a-z, 0-9, "_" or "-".');
+    }
+    return normalizedValue;
+}
 function normalizeTemplateSelection(templateId) {
     return templateId === WORKSPACE_TEMPLATE_ALIAS
         ? OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE
@@ -96,7 +117,7 @@ export async function resolvePackageManagerId({ packageManager, yes = false, isI
  * @param options Answer collection inputs including prompt callbacks and explicit overrides.
  * @returns The normalized scaffold answers used for rendering and file generation.
  */
-export async function collectScaffoldAnswers({ projectName, templateId, yes = false, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, textDomain, }) {
+export async function collectScaffoldAnswers({ projectName, templateId, yes = false, dataStorageMode, namespace, persistencePolicy, phpPrefix, promptText, queryPostType, textDomain, }) {
     const defaults = getDefaultAnswers(projectName, templateId);
     if (yes) {
         const identifiers = resolveScaffoldIdentifiers({
@@ -111,6 +132,7 @@ export async function collectScaffoldAnswers({ projectName, templateId, yes = fa
             namespace: identifiers.namespace,
             persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
             phpPrefix: identifiers.phpPrefix,
+            queryPostType: normalizeQueryPostType(queryPostType ?? defaults.queryPostType),
             textDomain: identifiers.textDomain,
         };
     }
@@ -130,6 +152,9 @@ export async function collectScaffoldAnswers({ projectName, templateId, yes = fa
         namespace: identifiers.namespace,
         persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
         phpPrefix: identifiers.phpPrefix,
+        queryPostType: templateId === 'query-loop'
+            ? normalizeQueryPostType(await promptText('Query post type', queryPostType ?? defaults.queryPostType ?? 'post', validateQueryPostType))
+            : normalizeQueryPostType(queryPostType ?? defaults.queryPostType),
         slug: identifiers.slug,
         textDomain: identifiers.textDomain,
         title: await promptText('Block title', toTitleCase(identifiers.slug)),

package/dist/runtime/scaffold-documents.js

@@ -37,6 +37,13 @@ export function buildReadme(templateId, variables, packageManager, { withMigrati
     const migrationSection = withMigrationUi
         ? `## Migration UI\n\nThis scaffold already includes an initialized migration workspace at \`v1\`, generated deprecated/runtime artifacts, and an editor-embedded migration dashboard. Migration versions are schema lineage labels and are separate from your package or plugin release version. Use the existing CLI commands to snapshot, diff, scaffold, verify, and fuzz future schema changes.\n\n\`\`\`bash\n${formatRunScript(packageManager, 'migration:doctor')}\n${formatRunScript(packageManager, 'migration:verify')}\n${formatRunScript(packageManager, 'migration:fuzz')}\n\`\`\`\n\nRun \`migration:init\` only when retrofitting migration support into an older project that was not scaffolded with \`--with-migration-ui\`.`
         : '';
+    const advancedSyncSection = optionalOnboardingSteps.length > 0
+        ? `## Advanced Sync\n\n\`\`\`bash\n${optionalOnboardingSteps.join('\n')}\n\`\`\`\n\n${getOptionalOnboardingNote(packageManager, templateId, {
+            compoundPersistenceEnabled,
+        })}`
+        : `## Artifact Refresh\n\n${getOptionalOnboardingNote(packageManager, templateId, {
+            compoundPersistenceEnabled,
+        })}`;
     return `# ${variables.title}
 
 ${variables.description}
@@ -63,15 +70,7 @@ ${formatRunScript(packageManager, 'build')}
 ${formatRunScript(packageManager, 'typecheck')}
 \`\`\`
 
-## Advanced Sync
-
-\`\`\`bash
-${optionalOnboardingSteps.join('\n')}
-\`\`\`
-
-${getOptionalOnboardingNote(packageManager, templateId, {
-        compoundPersistenceEnabled,
-    })}
+${advancedSyncSection}
 
 ## Before First Commit
 

package/dist/runtime/scaffold-onboarding.js

@@ -13,6 +13,9 @@ function templateHasPersistenceSync(templateId, { compoundPersistenceEnabled = f
  * Returns the optional sync script names to suggest for a template.
  */
 export function getOptionalSyncScriptNames(templateId, options = {}) {
+    if (templateId === "query-loop") {
+        return [];
+    }
     const availableScripts = new Set(options.availableScripts ?? []);
     if (availableScripts.has("sync")) {
         return ["sync"];
@@ -37,6 +40,9 @@ export function getOptionalOnboardingSteps(packageManager, templateId, options =
  * Returns the quick-start note explaining the scaffold's primary local loop.
  */
 export function getQuickStartWorkflowNote(packageManager, templateId = "basic", options = {}) {
+    if (templateId === "query-loop") {
+        return `${formatRunScript(packageManager, "start")} runs the editor build/watch loop that registers your Query Loop variation in the block editor. This scaffold is editor-facing by design: update \`src/index.ts\` when you want to change the variation namespace, default query, allowed controls, or the minimal inline starter layout, update \`src/patterns/*.php\` when you want richer connected layout presets in the inserter, use \`src/query-extension.ts\` when the variation needs custom query params or optional editor-side hooks, and mirror frontend/editor preview query mapping in \`inc/query-runtime.php\`.`;
+    }
     const developmentScript = getPrimaryDevelopmentScript(templateId);
     const devCommand = formatRunScript(packageManager, developmentScript);
     const startCommand = formatRunScript(packageManager, "start");
@@ -55,6 +61,9 @@ export function getQuickStartWorkflowNote(packageManager, templateId = "basic",
  * Returns the onboarding note explaining when manual sync is optional.
  */
 export function getOptionalOnboardingNote(packageManager, templateId = "basic", options = {}) {
+    if (templateId === "query-loop") {
+        return `This scaffold does not generate \`block.json\` or Typia manifests. Edit \`src/index.ts\` to change the variation contract, edit \`src/patterns/*.php\` when you want richer connected layouts beyond the inline fallback, edit \`src/query-extension.ts\` when you need variation-specific query params or custom editor hooks, and edit \`inc/query-runtime.php\` when those params need frontend or editor preview parity. Then rerun ${formatRunScript(packageManager, "build")}, ${formatRunScript(packageManager, "start")}, or ${formatRunScript(packageManager, "typecheck")} as needed.`;
+    }
     const optionalSyncScripts = getOptionalSyncScriptNames(templateId, options);
     const hasUnifiedSync = optionalSyncScripts.includes("sync");
     const syncSteps = optionalSyncScripts.map((scriptName) => formatRunScript(packageManager, scriptName));
@@ -100,6 +109,9 @@ export function getInitialCommitNote() {
  * Returns source-of-truth guidance for generated artifacts by template mode.
  */
 export function getTemplateSourceOfTruthNote(templateId, { compoundPersistenceEnabled = false } = {}) {
+    if (templateId === "query-loop") {
+        return "`src/index.ts` remains the source of truth for the Query Loop variation name, default query attributes, `allowedControls`, and the minimal inline starter `innerBlocks`. Use `src/patterns/*.php` for richer connected layout presets that stay tied to the same variation namespace, use `src/query-extension.ts` for custom query seed values or optional editor-only hook registration, and use `inc/query-runtime.php` to keep frontend and editor preview query mapping aligned for those custom keys. The generated plugin bootstrap should stay focused on script registration, pattern loading, and explicit runtime glue for the variation.";
+    }
     if (templateId === "compound") {
         const compoundBase = "`src/blocks/*/types.ts` files remain the source of truth for each block's `block.json`, `typia.manifest.json`, and `typia-validator.php`. Fresh scaffolds include starter `typia.manifest.json` files so editor imports resolve before the first sync.";
         if (compoundPersistenceEnabled) {

package/dist/runtime/scaffold-template-variables.js

@@ -73,7 +73,13 @@ export function getTemplateVariables(templateId, answers) {
         dataStorageMode,
         dashCase: slug,
         description,
+        descriptionJson: JSON.stringify(description),
         frontendCssClassName: buildFrontendCssClassName(cssClassName),
+        queryAllowedControlsJson: JSON.stringify([], null, 2),
+        queryPostType: answers.queryPostType?.trim() || 'post',
+        queryPostTypeJson: JSON.stringify(answers.queryPostType?.trim() || 'post'),
+        queryVariationNamespace: `${namespace}/${slug}`,
+        queryVariationNamespaceJson: JSON.stringify(`${namespace}/${slug}`),
         isAuthenticatedPersistencePolicy: persistencePolicy === 'authenticated' ? 'true' : 'false',
         isPublicPersistencePolicy: persistencePolicy === 'public' ? 'true' : 'false',
         bootstrapCredentialDeclarations: persistencePolicy === 'public'

package/dist/runtime/scaffold.d.ts

@@ -15,6 +15,7 @@ export interface ScaffoldAnswers {
     persistencePolicy?: PersistencePolicy;
     /** Snake_case PHP symbol prefix used for generated functions, constants, and keys. */
     phpPrefix?: string;
+    queryPostType?: string;
     slug: string;
     /** Kebab-case WordPress text domain used in block metadata and i18n strings. */
     textDomain?: string;
@@ -46,6 +47,7 @@ export interface ScaffoldTemplateVariables extends Record<string, string> {
     dashCase: string;
     dataStorageMode: DataStorageMode;
     description: string;
+    descriptionJson: string;
     frontendCssClassName: string;
     keyword: string;
     namespace: string;
@@ -53,6 +55,11 @@ export interface ScaffoldTemplateVariables extends Record<string, string> {
     pascalCase: string;
     phpPrefix: string;
     phpPrefixUpper: string;
+    queryAllowedControlsJson: string;
+    queryPostTypeJson: string;
+    queryPostType: string;
+    queryVariationNamespace: string;
+    queryVariationNamespaceJson: string;
     isAuthenticatedPersistencePolicy: "false" | "true";
     isPublicPersistencePolicy: "false" | "true";
     bootstrapCredentialDeclarations: string;
@@ -106,6 +113,7 @@ export interface CollectScaffoldAnswersOptions {
     projectName: string;
     promptText?: (message: string, defaultValue: string, validate?: (value: string) => true | string) => Promise<string>;
     persistencePolicy?: PersistencePolicy;
+    queryPostType?: string;
     textDomain?: string;
     templateId: string;
     withTestPreset?: boolean;

package/dist/runtime/template-defaults.d.ts

@@ -22,6 +22,10 @@ export declare const BUILTIN_TEMPLATE_METADATA_DEFAULTS: Readonly<{
         category: "widgets";
         icon: "screenoptions";
     }>;
+    "query-loop": Readonly<{
+        category: "widgets";
+        icon: "query-pagination";
+    }>;
 }>;
 /**
  * Shared hidden child block metadata defaults for compound scaffolds.
@@ -56,6 +60,9 @@ export declare function getBuiltInTemplateMetadataDefaults(templateId: keyof typ
 }> | Readonly<{
     category: "widgets";
     icon: "screenoptions";
+}> | Readonly<{
+    category: "widgets";
+    icon: "query-pagination";
 }>;
 /**
  * Checks whether a template id points at a removed built-in scaffold.

package/dist/runtime/template-defaults.js

@@ -22,6 +22,10 @@ export const BUILTIN_TEMPLATE_METADATA_DEFAULTS = Object.freeze({
         category: "widgets",
         icon: "screenoptions",
     }),
+    "query-loop": Object.freeze({
+        category: "widgets",
+        icon: "query-pagination",
+    }),
 });
 /**
  * Shared hidden child block metadata defaults for compound scaffolds.

package/dist/runtime/template-registry.d.ts

@@ -14,7 +14,7 @@ export declare const SHARED_MIGRATION_UI_TEMPLATE_ROOT: string;
 export declare const SHARED_WORKSPACE_TEMPLATE_ROOT: string;
 export declare const SHARED_TEST_PRESET_TEMPLATE_ROOT: string;
 export declare const SHARED_WP_ENV_PRESET_TEMPLATE_ROOT: string;
-export declare const BUILTIN_TEMPLATE_IDS: readonly ["basic", "interactivity", "persistence", "compound"];
+export declare const BUILTIN_TEMPLATE_IDS: readonly ["basic", "interactivity", "persistence", "compound", "query-loop"];
 export declare const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
 export type BuiltInTemplateId = (typeof BUILTIN_TEMPLATE_IDS)[number];
 export type PersistencePolicy = "authenticated" | "public";

package/dist/runtime/template-registry.js

@@ -40,7 +40,13 @@ export const SHARED_MIGRATION_UI_TEMPLATE_ROOT = path.join(SHARED_TEMPLATE_ROOT,
 export const SHARED_WORKSPACE_TEMPLATE_ROOT = path.join(SHARED_TEMPLATE_ROOT, "workspace");
 export const SHARED_TEST_PRESET_TEMPLATE_ROOT = path.join(SHARED_PRESET_TEMPLATE_ROOT, "test-preset");
 export const SHARED_WP_ENV_PRESET_TEMPLATE_ROOT = path.join(SHARED_PRESET_TEMPLATE_ROOT, "wp-env");
-export const BUILTIN_TEMPLATE_IDS = ["basic", "interactivity", "persistence", "compound"];
+export const BUILTIN_TEMPLATE_IDS = [
+    "basic",
+    "interactivity",
+    "persistence",
+    "compound",
+    "query-loop",
+];
 export const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
 export const TEMPLATE_REGISTRY = Object.freeze([
     {
@@ -71,6 +77,13 @@ export const TEMPLATE_REGISTRY = Object.freeze([
         features: ["InnerBlocks", "Hidden child blocks", "Optional persistence layer"],
         templateDir: path.join(TEMPLATE_ROOT, "compound"),
     },
+    {
+        id: "query-loop",
+        description: "A Query Loop block variation scaffold with stable namespace-based identity, inline starter layout, connected pattern presets, custom query seams, and runtime parity hooks",
+        defaultCategory: getBuiltInTemplateMetadataDefaults("query-loop").category,
+        features: ["core/query variation", "Default innerBlocks", "Connected patterns", "Custom query hooks", "Runtime parity hooks", "Allowed controls"],
+        templateDir: path.join(TEMPLATE_ROOT, "query-loop"),
+    },
     {
         id: OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE,
         description: "The official empty workspace template that powers `wp-typia add ...` workflows",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.14",
+  "version": "0.17.0",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",

package/templates/query-loop/inc/query-runtime.php.mustache

@@ -0,0 +1,85 @@
+<?php
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+function {{phpPrefix}}_get_query_loop_variation_name() {
+	return '{{namespace}}/{{slug}}';
+}
+
+function {{phpPrefix}}_get_query_loop_variation_marker_key() {
+	return 'wpTypiaVariation';
+}
+
+function {{phpPrefix}}_extract_query_loop_request_query( WP_REST_Request $request ) {
+	$params = $request->get_params();
+
+	if ( isset( $params['query'] ) && is_array( $params['query'] ) ) {
+		return $params['query'];
+	}
+
+	return is_array( $params ) ? $params : array();
+}
+
+function {{phpPrefix}}_map_query_loop_custom_query_vars( array $query_vars, array $source_query ) {
+	unset( $query_vars[ {{phpPrefix}}_get_query_loop_variation_marker_key() ] );
+
+	$allowed_custom_query_values = array(
+		// 'featuredOnly' => isset( $source_query['featuredOnly'] ) ? (bool) $source_query['featuredOnly'] : null,
+		// 'eventStatus' => isset( $source_query['eventStatus'] ) ? sanitize_text_field( $source_query['eventStatus'] ) : null,
+	);
+
+	// Mirror only known custom query keys from `src/query-extension.ts` here when
+	// they should affect frontend rendering or editor preview requests. Sanitize
+	// and cast values before copying them into WP_Query vars; do not merge the
+	// raw source query wholesale.
+	foreach ( $allowed_custom_query_values as $key => $value ) {
+		if ( null === $value ) {
+			continue;
+		}
+
+		$query_vars[ $key ] = $value;
+	}
+
+	return $query_vars;
+}
+
+function {{phpPrefix}}_filter_query_loop_block_query_vars( $query_vars, $block, $page ) {
+	if ( ! is_array( $query_vars ) ) {
+		return $query_vars;
+	}
+
+	$attrs = is_array( $block ) && isset( $block['attrs'] ) && is_array( $block['attrs'] )
+		? $block['attrs']
+		: array();
+	$namespace = isset( $attrs['namespace'] ) && is_string( $attrs['namespace'] )
+		? $attrs['namespace']
+		: null;
+	$source_query = isset( $attrs['query'] ) && is_array( $attrs['query'] )
+		? $attrs['query']
+		: array();
+
+	if ( {{phpPrefix}}_get_query_loop_variation_name() !== $namespace ) {
+		return $query_vars;
+	}
+
+	return {{phpPrefix}}_map_query_loop_custom_query_vars( $query_vars, $source_query );
+}
+
+function {{phpPrefix}}_filter_query_loop_editor_preview_query_vars( $query_vars, $request ) {
+	if ( ! is_array( $query_vars ) || ! $request instanceof WP_REST_Request ) {
+		return $query_vars;
+	}
+
+	$source_query = {{phpPrefix}}_extract_query_loop_request_query( $request );
+	$marker_key = {{phpPrefix}}_get_query_loop_variation_marker_key();
+	$variation_name = isset( $source_query[ $marker_key ] ) && is_string( $source_query[ $marker_key ] )
+		? $source_query[ $marker_key ]
+		: null;
+
+	if ( {{phpPrefix}}_get_query_loop_variation_name() !== $variation_name ) {
+		return $query_vars;
+	}
+
+	return {{phpPrefix}}_map_query_loop_custom_query_vars( $query_vars, $source_query );
+}

package/templates/query-loop/package.json.mustache

@@ -0,0 +1,32 @@
+{
+  "name": "{{slug}}",
+  "version": "0.1.0",
+  "packageManager": "bun@1.3.11",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "license": "GPL-2.0-or-later",
+  "main": "build/index.js",
+  "scripts": {
+    "build": "wp-scripts build --experimental-modules",
+    "start": "wp-scripts start --experimental-modules",
+    "dev": "wp-scripts start --experimental-modules",
+    "lint:js": "wp-scripts lint-js",
+    "lint": "bun run lint:js",
+    "format": "wp-scripts format",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@wp-typia/block-types": "{{blockTypesPackageVersion}}",
+    "@types/wordpress__block-editor": "^11.5.17",
+    "@types/wordpress__blocks": "^12.5.18",
+    "@wordpress/browserslist-config": "^6.42.0",
+    "@wordpress/scripts": "^30.22.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "prettier": "3.8.2",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "@wordpress/blocks": "^15.2.0",
+    "@wordpress/i18n": "^6.2.0"
+  }
+}

package/templates/query-loop/src/patterns/grid.php.mustache

@@ -0,0 +1,49 @@
+<?php
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$content = sprintf(
+	<<<'HTML'
+<!-- wp:query {"namespace":"{{namespace}}/{{slug}}","query":{"inherit":false,"postType":"{{queryPostType}}","perPage":6,"order":"desc","orderBy":"date","wpTypiaVariation":"{{namespace}}/{{slug}}"},"displayLayout":{"type":"grid","columns":3}} -->
+<div class="wp-block-query">
+	<!-- wp:post-template -->
+	<!-- wp:group {"style":{"spacing":{"blockGap":"0.75rem","padding":{"top":"1rem","right":"1rem","bottom":"1rem","left":"1rem"}}},"layout":{"type":"constrained"}} -->
+	<div class="wp-block-group" style="padding-top:1rem;padding-right:1rem;padding-bottom:1rem;padding-left:1rem">
+		<!-- wp:post-featured-image /-->
+		<!-- wp:post-title {"isLink":true} /-->
+		<!-- wp:post-excerpt /-->
+	</div>
+	<!-- /wp:group -->
+	<!-- /wp:post-template -->
+
+	<!-- wp:query-pagination -->
+	<!-- wp:query-pagination-previous /-->
+	<!-- wp:query-pagination-numbers /-->
+	<!-- wp:query-pagination-next /-->
+	<!-- /wp:query-pagination -->
+
+	<!-- wp:query-no-results -->
+	<!-- wp:paragraph -->
+	<p>%s</p>
+	<!-- /wp:paragraph -->
+	<!-- /wp:query-no-results -->
+</div>
+<!-- /wp:query -->
+HTML,
+	esc_html__( 'No items matched this preset yet.', '{{textDomain}}' )
+);
+
+register_block_pattern(
+	'{{namespace}}/{{slug}}-grid',
+	array(
+		'title'         => __( '{{title}} Grid', '{{textDomain}}' ),
+		'description'   => __( 'A connected grid layout preset for the {{title}} Query Loop variation.', '{{textDomain}}' ),
+		'categories'    => array( '{{slug}}-query-loop' ),
+		'blockTypes'    => array( 'core/query' ),
+		'postTypes'     => array( '{{queryPostType}}' ),
+		'inserter'      => true,
+		'viewportWidth' => 1280,
+		'content'       => $content,
+	)
+);

package/templates/query-loop/src/patterns/list.php.mustache

@@ -0,0 +1,48 @@
+<?php
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+$content = sprintf(
+	<<<'HTML'
+<!-- wp:query {"namespace":"{{namespace}}/{{slug}}","query":{"inherit":false,"postType":"{{queryPostType}}","perPage":4,"order":"desc","orderBy":"date","wpTypiaVariation":"{{namespace}}/{{slug}}"}} -->
+<div class="wp-block-query">
+	<!-- wp:post-template -->
+	<!-- wp:group {"style":{"spacing":{"blockGap":"1rem","padding":{"top":"1.25rem","bottom":"1.25rem"}}},"layout":{"type":"constrained"}} -->
+	<div class="wp-block-group" style="padding-top:1.25rem;padding-bottom:1.25rem">
+		<!-- wp:post-title {"isLink":true} /-->
+		<!-- wp:post-date /-->
+		<!-- wp:post-excerpt {"moreText":"Continue reading"} /-->
+	</div>
+	<!-- /wp:group -->
+	<!-- /wp:post-template -->
+
+	<!-- wp:query-pagination -->
+	<!-- wp:query-pagination-previous /-->
+	<!-- wp:query-pagination-next /-->
+	<!-- /wp:query-pagination -->
+
+	<!-- wp:query-no-results -->
+	<!-- wp:paragraph -->
+	<p>%s</p>
+	<!-- /wp:paragraph -->
+	<!-- /wp:query-no-results -->
+</div>
+<!-- /wp:query -->
+HTML,
+	esc_html__( 'No items matched this preset yet.', '{{textDomain}}' )
+);
+
+register_block_pattern(
+	'{{namespace}}/{{slug}}-list',
+	array(
+		'title'         => __( '{{title}} List', '{{textDomain}}' ),
+		'description'   => __( 'A connected list layout preset for the {{title}} Query Loop variation.', '{{textDomain}}' ),
+		'categories'    => array( '{{slug}}-query-loop' ),
+		'blockTypes'    => array( 'core/query' ),
+		'postTypes'     => array( '{{queryPostType}}' ),
+		'inserter'      => true,
+		'viewportWidth' => 1280,
+		'content'       => $content,
+	)
+);

package/templates/query-loop/src/query-extension.ts.mustache

@@ -0,0 +1,41 @@
+export type QueryLoopEditorExtensionContext = {
+  variationName: string;
+};
+
+export type QueryLoopCustomQuerySeed = Record<string, unknown>;
+
+/**
+ * Extend the generated Query Loop variation with variation-specific query params.
+ *
+ * Add custom keys here only when the variation should always seed them. Runtime
+ * parity hooks in `inc/query-runtime.php` can read the same keys later from the
+ * Query Loop `query` object.
+ */
+export function getQueryLoopCustomQuerySeed(): QueryLoopCustomQuerySeed {
+  return {};
+}
+
+/**
+ * Add extra inspector controls by key when your custom query seed needs them.
+ *
+ * Keep the generated defaults in `src/index.ts` and return only the additional
+ * control ids that your variation-specific query params rely on.
+ */
+export function getQueryLoopCustomAllowedControls(): string[] {
+  return [];
+}
+
+/**
+ * Register optional editor-only extension hooks for custom Query Loop params.
+ *
+ * This stays a no-op by default. When you need custom inspector UI, add your
+ * `editor.BlockEdit` filters or other editor hooks here so `src/index.ts` can
+ * keep variation registration focused on identity and default query values. If
+ * those hooks introduce frontend-affecting query params, mirror them in
+ * `inc/query-runtime.php` so editor preview and frontend rendering stay aligned.
+ */
+export function registerQueryLoopEditorExtensions(
+  _context: QueryLoopEditorExtensionContext,
+): void {
+  // Add optional editor hooks here when this variation introduces custom query UI.
+}

package/templates/query-loop/src/validator-toolkit.ts.mustache

@@ -0,0 +1 @@
+export {};

package/templates/query-loop/webpack.config.js.mustache

@@ -0,0 +1,16 @@
+const path = require("node:path");
+const defaultConfig = require("@wordpress/scripts/config/webpack.config");
+
+const queryLoopEntry = {
+	index: path.resolve(process.cwd(), "src/index.ts"),
+};
+
+module.exports = Array.isArray(defaultConfig)
+	? defaultConfig.map((config) => ({
+			...config,
+			entry: config?.output?.module ? config.entry : queryLoopEntry,
+		}))
+	: {
+			...defaultConfig,
+			entry: queryLoopEntry,
+		};

package/templates/query-loop/{{slugKebabCase}}.php.mustache

@@ -0,0 +1,84 @@
+<?php
+/**
+ * Plugin Name:       {{title}}
+ * Description:       {{description}}
+ * Version:           0.1.0
+ * Requires at least: 6.7
+ * Tested up to:      6.9
+ * Requires PHP:      8.0
+ * Author:            {{author}}
+ * License:           GPL-2.0-or-later
+ * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
+ * Text Domain:       {{textDomain}}
+ * Domain Path:       /languages
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+require_once __DIR__ . '/inc/query-runtime.php';
+
+function {{phpPrefix}}_load_textdomain() {
+	load_plugin_textdomain(
+		'{{textDomain}}',
+		false,
+		dirname( plugin_basename( __FILE__ ) ) . '/languages'
+	);
+}
+
+function {{phpPrefix}}_register_query_loop_pattern_category() {
+	if ( ! function_exists( 'register_block_pattern_category' ) ) {
+		return;
+	}
+
+	register_block_pattern_category(
+		'{{slug}}-query-loop',
+		array(
+			'label' => __( '{{title}} Query Loop', '{{textDomain}}' ),
+		)
+	);
+}
+
+function {{phpPrefix}}_register_query_loop_patterns() {
+	if ( ! function_exists( 'register_block_pattern' ) ) {
+		return;
+	}
+
+	foreach ( glob( __DIR__ . '/src/patterns/*.php' ) ?: array() as $pattern_module ) {
+		require $pattern_module;
+	}
+}
+
+function {{phpPrefix}}_register_query_loop_variation_script() {
+	$script_path      = __DIR__ . '/build/index.js';
+	$script_asset_path = __DIR__ . '/build/index.asset.php';
+
+	if ( ! file_exists( $script_path ) || ! file_exists( $script_asset_path ) ) {
+		return;
+	}
+
+	$asset = require $script_asset_path;
+	$handle = '{{phpPrefix}}_query_loop_variation';
+
+	wp_register_script(
+		$handle,
+		plugins_url( 'build/index.js', __FILE__ ),
+		is_array( $asset ) && isset( $asset['dependencies'] ) ? $asset['dependencies'] : array(),
+		is_array( $asset ) && isset( $asset['version'] ) ? $asset['version'] : filemtime( $script_path ),
+		true
+	);
+	wp_set_script_translations( $handle, '{{textDomain}}', __DIR__ . '/languages' );
+}
+
+function {{phpPrefix}}_enqueue_query_loop_variation_script() {
+	{{phpPrefix}}_register_query_loop_variation_script();
+	wp_enqueue_script( '{{phpPrefix}}_query_loop_variation' );
+}
+
+add_action( 'init', '{{phpPrefix}}_load_textdomain' );
+add_action( 'init', '{{phpPrefix}}_register_query_loop_pattern_category' );
+add_action( 'init', '{{phpPrefix}}_register_query_loop_patterns', 20 );
+add_action( 'enqueue_block_editor_assets', '{{phpPrefix}}_enqueue_query_loop_variation_script' );
+add_filter( 'query_loop_block_query_vars', '{{phpPrefix}}_filter_query_loop_block_query_vars', 10, 3 );
+add_filter( 'rest_{{queryPostType}}_query', '{{phpPrefix}}_filter_query_loop_editor_preview_query_vars', 10, 2 );