wp-typia 0.16.15 → 0.17.0

package/README.md

@@ -5,6 +5,7 @@ Canonical CLI package for `wp-typia`.
 Use this package for new installs:
 
 - `npx wp-typia create my-block`
+- `npx wp-typia create my-books --template query-loop --query-post-type book`
 - `bunx wp-typia create my-block`
 - `npx wp-typia create my-plugin --template @wp-typia/create-workspace-template`
 - `wp-typia add block counter-card --template basic`

package/dist-bunli/.bunli/commands.gen.js

@@ -211121,6 +211121,10 @@ var init_template_defaults = __esm(() => {
     compound: Object.freeze({
       category: "widgets",
       icon: "screenoptions"
+    }),
+    "query-loop": Object.freeze({
+      category: "widgets",
+      icon: "query-pagination"
     })
   });
   COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS = Object.freeze({
@@ -211192,7 +211196,13 @@ var init_template_registry = __esm(() => {
   SHARED_WORKSPACE_TEMPLATE_ROOT = path25.join(SHARED_TEMPLATE_ROOT, "workspace");
   SHARED_TEST_PRESET_TEMPLATE_ROOT = path25.join(SHARED_PRESET_TEMPLATE_ROOT, "test-preset");
   SHARED_WP_ENV_PRESET_TEMPLATE_ROOT = path25.join(SHARED_PRESET_TEMPLATE_ROOT, "wp-env");
-  BUILTIN_TEMPLATE_IDS = ["basic", "interactivity", "persistence", "compound"];
+  BUILTIN_TEMPLATE_IDS = [
+    "basic",
+    "interactivity",
+    "persistence",
+    "compound",
+    "query-loop"
+  ];
   TEMPLATE_REGISTRY = Object.freeze([
     {
       id: "basic",
@@ -211222,6 +211232,13 @@ var init_template_registry = __esm(() => {
       features: ["InnerBlocks", "Hidden child blocks", "Optional persistence layer"],
       templateDir: path25.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: path25.join(TEMPLATE_ROOT, "query-loop")
+    },
     {
       id: OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE,
       description: "The official empty workspace template that powers `wp-typia add ...` workflows",
@@ -211867,6 +211884,9 @@ import path27 from "path";
 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 "${formatRunScript2(packageManager, "sync-types")}"`;
@@ -211943,11 +211963,14 @@ async function applyGeneratedProjectDxPackageJson({
   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";
@@ -211958,12 +211981,16 @@ async function applyGeneratedProjectDxPackageJson({
     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";
@@ -211980,7 +212007,7 @@ async function applyGeneratedProjectDxPackageJson({
   });
 }
 function getPrimaryDevelopmentScript(templateId) {
-  return templateId === "basic" || templateId === "interactivity" || templateId === "persistence" || templateId === "compound" ? "dev" : "start";
+  return templateSupportsGeneratedSyncWatchers(templateId) ? "dev" : "start";
 }
 var init_local_dev_presets = __esm(() => {
   init_package_managers();
@@ -212265,6 +212292,9 @@ function templateHasPersistenceSync2(templateId, { compoundPersistenceEnabled =
   return templateId === "persistence" || templateId === "compound" && compoundPersistenceEnabled;
 }
 function getOptionalSyncScriptNames(templateId, options = {}) {
+  if (templateId === "query-loop") {
+    return [];
+  }
   const availableScripts = new Set(options.availableScripts ?? []);
   if (availableScripts.has("sync")) {
     return ["sync"];
@@ -212282,6 +212312,9 @@ function getOptionalOnboardingSteps(packageManager, templateId, options = {}) {
   return getOptionalSyncScriptNames(templateId, options).map((scriptName) => formatRunScript2(packageManager, scriptName));
 }
 function getQuickStartWorkflowNote(packageManager, templateId = "basic", options = {}) {
+  if (templateId === "query-loop") {
+    return `${formatRunScript2(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 = formatRunScript2(packageManager, developmentScript);
   const startCommand = formatRunScript2(packageManager, "start");
@@ -212297,6 +212330,9 @@ function getQuickStartWorkflowNote(packageManager, templateId = "basic", options
   return `${devCommand} keeps the editor and type-derived artifacts moving together during local development. Use ${startCommand} when you want a one-shot sync plus editor startup without the long-running watch loop.`;
 }
 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 ${formatRunScript2(packageManager, "build")}, ${formatRunScript2(packageManager, "start")}, or ${formatRunScript2(packageManager, "typecheck")} as needed.`;
+  }
   const optionalSyncScripts = getOptionalSyncScriptNames(templateId, options);
   const hasUnifiedSync = optionalSyncScripts.includes("sync");
   const syncSteps = optionalSyncScripts.map((scriptName) => formatRunScript2(packageManager, scriptName));
@@ -212326,6 +212362,9 @@ function getInitialCommitNote() {
   return "Skip `git init` if this directory already lives inside an existing repository. If you want generated artifacts refreshed before the first checkpoint, run your manual sync step first and then create the commit.";
 }
 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) {
@@ -212456,6 +212495,20 @@ ${formatRunScript2(packageManager, "migration:fuzz")}
 \`\`\`
 
 Run \`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
+
+\`\`\`bash
+${optionalOnboardingSteps.join(`
+`)}
+\`\`\`
+
+${getOptionalOnboardingNote(packageManager, templateId, {
+    compoundPersistenceEnabled
+  })}` : `## Artifact Refresh
+
+${getOptionalOnboardingNote(packageManager, templateId, {
+    compoundPersistenceEnabled
+  })}`;
   return `# ${variables.title}
 
 ${variables.description}
@@ -212482,16 +212535,7 @@ ${formatRunScript2(packageManager, "build")}
 ${formatRunScript2(packageManager, "typecheck")}
 \`\`\`
 
-## Advanced Sync
-
-\`\`\`bash
-${optionalOnboardingSteps.join(`
-`)}
-\`\`\`
-
-${getOptionalOnboardingNote(packageManager, templateId, {
-    compoundPersistenceEnabled
-  })}
+${advancedSyncSection}
 
 ## Before First Commit
 
@@ -222121,6 +222165,15 @@ function createBuiltInBlockSpec({
     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,
@@ -222155,6 +222208,7 @@ function buildTemplateVariablesFromBlockSpec(spec) {
   const persistenceEnabled = spec.persistence.enabled;
   const dataStorageMode = persistenceEnabled ? spec.persistence.dataStorageMode : "custom-table";
   const persistencePolicy = persistenceEnabled ? spec.persistence.persistencePolicy : "authenticated";
+  const queryVariationNamespace = `${namespace}/${slug}`;
   return {
     apiClientPackageVersion,
     author: spec.project.author,
@@ -222174,7 +222228,13 @@ 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" ? `publicWriteExpiresAt?: number & tags.Type< 'uint32' >;
@@ -222203,11 +222263,21 @@ function buildTemplateVariablesFromBlockSpec(spec) {
     persistencePolicy
   };
 }
+var DEFAULT_QUERY_LOOP_ALLOWED_CONTROLS;
 var init_block_generator_service_spec = __esm(() => {
   init_package_versions();
   init_template_defaults();
   init_template_registry();
   init_scaffold_identifiers();
+  DEFAULT_QUERY_LOOP_ALLOWED_CONTROLS = [
+    "inherit",
+    "postType",
+    "order",
+    "sticky",
+    "taxQuery",
+    "author",
+    "search"
+  ];
 });
 
 // ../wp-typia-project-tools/src/runtime/built-in-block-non-ts-artifacts.ts
@@ -222421,6 +222491,8 @@ function buildBuiltInNonTsArtifacts({
       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}`);
@@ -224145,6 +224217,78 @@ const { actions, state } = store( '{{slugKebabCase}}', {
 } );
 `;
 
+// ../wp-typia-project-tools/src/runtime/built-in-block-code-templates/query-loop.ts
+var 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 });
+`;
+
 // ../wp-typia-project-tools/src/runtime/built-in-block-code-templates/compound-parent.ts
 var COMPOUND_PARENT_EDIT_TEMPLATE = `import type { BlockEditProps } from '@wp-typia/block-types/blocks/registration';
 import { __ } from '@wordpress/i18n';
@@ -225147,6 +225291,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 })
+  ]);
+}
 function buildBuiltInCodeArtifacts({
   templateId,
   variables
@@ -225160,6 +225315,8 @@ function buildBuiltInCodeArtifacts({
       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}`);
@@ -225472,102 +225629,6 @@ var init_block_generator_service = __esm(() => {
   init_block_generator_service_core();
 });
 
-// ../wp-typia-project-tools/src/runtime/scaffold-template-variables.ts
-function getTemplateVariables(templateId, answers) {
-  if (isBuiltInTemplateId(templateId)) {
-    return buildTemplateVariablesFromBlockSpec(createBuiltInBlockSpec({
-      answers,
-      dataStorageMode: answers.dataStorageMode,
-      persistencePolicy: answers.persistencePolicy,
-      templateId
-    }));
-  }
-  const {
-    apiClientPackageVersion,
-    blockRuntimePackageVersion,
-    blockTypesPackageVersion,
-    projectToolsPackageVersion,
-    restPackageVersion
-  } = getPackageVersions();
-  const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
-  const metadataDefaults = isBuiltInTemplateId(templateId) ? getBuiltInTemplateMetadataDefaults(templateId) : null;
-  const identifiers = resolveScaffoldIdentifiers({
-    namespace: answers.namespace,
-    phpPrefix: answers.phpPrefix,
-    slug: answers.slug,
-    textDomain: answers.textDomain
-  });
-  const slug = identifiers.slug;
-  const slugSnakeCase = toSnakeCase(slug);
-  const pascalCase = toPascalCase(slug);
-  const title = answers.title.trim();
-  const namespace = identifiers.namespace;
-  const description = answers.description.trim();
-  const textDomain = identifiers.textDomain;
-  const phpPrefix = identifiers.phpPrefix;
-  const phpPrefixUpper = phpPrefix.toUpperCase();
-  const compoundChildTitle = `${title} Item`;
-  const cssClassName = buildBlockCssClassName(namespace, slug);
-  const compoundChildCssClassName = buildBlockCssClassName(namespace, `${slug}-item`);
-  const compoundPersistenceEnabled = templateId === "persistence" ? true : templateId === "compound" ? Boolean(answers.dataStorageMode || answers.persistencePolicy) : false;
-  const dataStorageMode = templateId === "persistence" || compoundPersistenceEnabled ? answers.dataStorageMode ?? "custom-table" : "custom-table";
-  const persistencePolicy = templateId === "persistence" || compoundPersistenceEnabled ? answers.persistencePolicy ?? "authenticated" : "authenticated";
-  return {
-    apiClientPackageVersion,
-    author: answers.author.trim(),
-    blockRuntimePackageVersion,
-    blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
-    blockTypesPackageVersion,
-    category: metadataDefaults?.category ?? template?.defaultCategory ?? "widgets",
-    icon: metadataDefaults?.icon ?? "smiley",
-    compoundChildTitle,
-    compoundChildCategory: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.category,
-    compoundChildCssClassName,
-    compoundChildIcon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
-    compoundChildTitleJson: JSON.stringify(compoundChildTitle),
-    compoundPersistenceEnabled: compoundPersistenceEnabled ? "true" : "false",
-    projectToolsPackageVersion,
-    cssClassName,
-    dataStorageMode,
-    dashCase: slug,
-    description,
-    frontendCssClassName: buildFrontendCssClassName(cssClassName),
-    isAuthenticatedPersistencePolicy: persistencePolicy === "authenticated" ? "true" : "false",
-    isPublicPersistencePolicy: persistencePolicy === "public" ? "true" : "false",
-    bootstrapCredentialDeclarations: persistencePolicy === "public" ? `publicWriteExpiresAt?: number & tags.Type< 'uint32' >;
-	publicWriteToken?: string & tags.MinLength< 1 > & tags.MaxLength< 512 >;` : "restNonce?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
-    persistencePolicyDescriptionJson: JSON.stringify(persistencePolicy === "authenticated" ? "Writes require a logged-in user and a valid REST nonce." : "Anonymous writes use signed short-lived public tokens, per-request ids, and coarse rate limiting."),
-    keyword: slug.replace(/-/g, " "),
-    namespace,
-    needsMigration: "{{needsMigration}}",
-    pascalCase,
-    phpPrefix,
-    phpPrefixUpper,
-    restPackageVersion,
-    publicWriteRequestIdDeclaration: persistencePolicy === "public" ? "publicWriteRequestId: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;" : "publicWriteRequestId?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
-    restWriteAuthIntent: persistencePolicy === "public" ? "public-write-protected" : "authenticated",
-    restWriteAuthMechanism: persistencePolicy === "public" ? "public-signed-token" : "rest-nonce",
-    restWriteAuthMode: persistencePolicy === "public" ? "public-signed-token" : "authenticated-rest-nonce",
-    slug,
-    slugCamelCase: pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1),
-    slugKebabCase: slug,
-    slugSnakeCase,
-    textDomain,
-    textdomain: textDomain,
-    title,
-    titleJson: JSON.stringify(title),
-    titleCase: pascalCase,
-    persistencePolicy
-  };
-}
-var init_scaffold_template_variables = __esm(() => {
-  init_block_generator_service();
-  init_package_versions();
-  init_scaffold_identifiers();
-  init_template_defaults();
-  init_template_registry();
-});
-
 // ../wp-typia-project-tools/src/runtime/scaffold-answer-resolution.ts
 import { execSync as execSync4 } from "child_process";
 function detectAuthor() {
@@ -225590,11 +225651,32 @@ 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(value2) {
+  const normalizedValue = value2.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(value2) {
+  if (typeof value2 !== "string") {
+    return;
+  }
+  const normalizedValue = value2.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 : templateId;
 }
@@ -225648,6 +225730,7 @@ async function collectScaffoldAnswers({
   persistencePolicy,
   phpPrefix,
   promptText,
+  queryPostType,
   textDomain
 }) {
   const defaults = getDefaultAnswers(projectName, templateId);
@@ -225664,6 +225747,7 @@ async function collectScaffoldAnswers({
       namespace: identifiers2.namespace,
       persistencePolicy: persistencePolicy ?? defaults.persistencePolicy,
       phpPrefix: identifiers2.phpPrefix,
+      queryPostType: normalizeQueryPostType(queryPostType ?? defaults.queryPostType),
       textDomain: identifiers2.textDomain
     };
   }
@@ -225683,6 +225767,7 @@ async function collectScaffoldAnswers({
     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))
@@ -225696,6 +225781,108 @@ var init_scaffold_answer_resolution = __esm(() => {
   init_template_defaults();
 });
 
+// ../wp-typia-project-tools/src/runtime/scaffold-template-variables.ts
+function getTemplateVariables(templateId, answers) {
+  if (isBuiltInTemplateId(templateId)) {
+    return buildTemplateVariablesFromBlockSpec(createBuiltInBlockSpec({
+      answers,
+      dataStorageMode: answers.dataStorageMode,
+      persistencePolicy: answers.persistencePolicy,
+      templateId
+    }));
+  }
+  const {
+    apiClientPackageVersion,
+    blockRuntimePackageVersion,
+    blockTypesPackageVersion,
+    projectToolsPackageVersion,
+    restPackageVersion
+  } = getPackageVersions();
+  const template = isBuiltInTemplateId(templateId) ? getTemplateById(templateId) : null;
+  const metadataDefaults = isBuiltInTemplateId(templateId) ? getBuiltInTemplateMetadataDefaults(templateId) : null;
+  const identifiers = resolveScaffoldIdentifiers({
+    namespace: answers.namespace,
+    phpPrefix: answers.phpPrefix,
+    slug: answers.slug,
+    textDomain: answers.textDomain
+  });
+  const slug = identifiers.slug;
+  const slugSnakeCase = toSnakeCase(slug);
+  const pascalCase = toPascalCase(slug);
+  const title = answers.title.trim();
+  const namespace = identifiers.namespace;
+  const description = answers.description.trim();
+  const textDomain = identifiers.textDomain;
+  const phpPrefix = identifiers.phpPrefix;
+  const phpPrefixUpper = phpPrefix.toUpperCase();
+  const compoundChildTitle = `${title} Item`;
+  const cssClassName = buildBlockCssClassName(namespace, slug);
+  const compoundChildCssClassName = buildBlockCssClassName(namespace, `${slug}-item`);
+  const compoundPersistenceEnabled = templateId === "persistence" ? true : templateId === "compound" ? Boolean(answers.dataStorageMode || answers.persistencePolicy) : false;
+  const dataStorageMode = templateId === "persistence" || compoundPersistenceEnabled ? answers.dataStorageMode ?? "custom-table" : "custom-table";
+  const persistencePolicy = templateId === "persistence" || compoundPersistenceEnabled ? answers.persistencePolicy ?? "authenticated" : "authenticated";
+  return {
+    apiClientPackageVersion,
+    author: answers.author.trim(),
+    blockRuntimePackageVersion,
+    blockMetadataVersion: BUILTIN_BLOCK_METADATA_VERSION,
+    blockTypesPackageVersion,
+    category: metadataDefaults?.category ?? template?.defaultCategory ?? "widgets",
+    icon: metadataDefaults?.icon ?? "smiley",
+    compoundChildTitle,
+    compoundChildCategory: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.category,
+    compoundChildCssClassName,
+    compoundChildIcon: COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS.icon,
+    compoundChildTitleJson: JSON.stringify(compoundChildTitle),
+    compoundPersistenceEnabled: compoundPersistenceEnabled ? "true" : "false",
+    projectToolsPackageVersion,
+    cssClassName,
+    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" ? `publicWriteExpiresAt?: number & tags.Type< 'uint32' >;
+	publicWriteToken?: string & tags.MinLength< 1 > & tags.MaxLength< 512 >;` : "restNonce?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
+    persistencePolicyDescriptionJson: JSON.stringify(persistencePolicy === "authenticated" ? "Writes require a logged-in user and a valid REST nonce." : "Anonymous writes use signed short-lived public tokens, per-request ids, and coarse rate limiting."),
+    keyword: slug.replace(/-/g, " "),
+    namespace,
+    needsMigration: "{{needsMigration}}",
+    pascalCase,
+    phpPrefix,
+    phpPrefixUpper,
+    restPackageVersion,
+    publicWriteRequestIdDeclaration: persistencePolicy === "public" ? "publicWriteRequestId: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;" : "publicWriteRequestId?: string & tags.MinLength< 1 > & tags.MaxLength< 128 >;",
+    restWriteAuthIntent: persistencePolicy === "public" ? "public-write-protected" : "authenticated",
+    restWriteAuthMechanism: persistencePolicy === "public" ? "public-signed-token" : "rest-nonce",
+    restWriteAuthMode: persistencePolicy === "public" ? "public-signed-token" : "authenticated-rest-nonce",
+    slug,
+    slugCamelCase: pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1),
+    slugKebabCase: slug,
+    slugSnakeCase,
+    textDomain,
+    textdomain: textDomain,
+    title,
+    titleJson: JSON.stringify(title),
+    titleCase: pascalCase,
+    persistencePolicy
+  };
+}
+var init_scaffold_template_variables = __esm(() => {
+  init_block_generator_service();
+  init_package_versions();
+  init_scaffold_identifiers();
+  init_template_defaults();
+  init_template_registry();
+});
+
 // ../wp-typia-project-tools/src/runtime/scaffold.ts
 import fs33 from "fs";
 import { promises as fsp13 } from "fs";
@@ -225861,6 +226048,7 @@ var init_scaffold = __esm(() => {
   init_template_registry();
   init_template_source();
   init_block_generator_service();
+  init_scaffold_answer_resolution();
   init_scaffold_template_variables();
   init_scaffold_identifiers();
   init_scaffold_answer_resolution();
@@ -227897,6 +228085,7 @@ async function runScaffoldFlow({
   namespace,
   textDomain,
   phpPrefix,
+  queryPostType,
   yes = false,
   noInstall = false,
   isInteractive = false,
@@ -228000,6 +228189,7 @@ async function runScaffoldFlow({
       persistencePolicy: resolvedPersistencePolicy,
       phpPrefix,
       projectName,
+      queryPostType,
       templateId: resolvedTemplateId,
       textDomain,
       yes,
@@ -280984,6 +281174,7 @@ async function executeCreateCommand({
       phpPrefix: readOptionalLooseStringFlag(flags2, "php-prefix"),
       projectInput: projectDir,
       promptText: activePrompt ? (message, defaultValue, validate) => activePrompt.text(message, defaultValue, validate) : undefined,
+      queryPostType: readOptionalLooseStringFlag(flags2, "query-post-type"),
       selectDataStorage: activePrompt ? () => activePrompt.select("Select a data storage mode", [...DATA_STORAGE_PROMPT_OPTIONS], 1) : undefined,
       selectExternalLayerId: shouldPromptForExternalLayerSelection && activePrompt ? (options) => activePrompt.select("Select an external layer", toExternalLayerPromptOptions(options), 1) : undefined,
       selectPackageManager: activePrompt ? () => activePrompt.select("Select a package manager", [...PACKAGE_MANAGER_PROMPT_OPTIONS], 1) : undefined,
@@ -281823,6 +282014,10 @@ var createOptions = {
     description: "Custom PHP symbol prefix.",
     schema: exports_external.string().optional()
   },
+  "query-post-type": {
+    description: "Default post type assigned to Query Loop variation scaffolds.",
+    schema: exports_external.string().optional()
+  },
   template: {
     description: "Template id or external template package.",
     schema: exports_external.string().optional(),
@@ -281894,6 +282089,7 @@ var createCommand = defineCommand({
             "package-manager": args.flags["package-manager"] ?? config2["package-manager"],
             "persistence-policy": args.flags["persistence-policy"] ?? config2["persistence-policy"],
             "php-prefix": args.flags["php-prefix"] ?? config2["php-prefix"],
+            "query-post-type": args.flags["query-post-type"] ?? config2["query-post-type"],
             "project-dir": args.positional[0] ?? "",
             template: args.flags.template ?? config2.template,
             "text-domain": args.flags["text-domain"] ?? config2["text-domain"],
@@ -282799,4 +282995,4 @@ export {
   cli
 };
 
-//# debugId=49D9C09383E8F29664756E2164756E21
+//# debugId=9E22CBAFF8C72AF964756E2164756E21