@wp-typia/project-tools 0.16.13 → 0.17.0

package/README.md

@@ -12,7 +12,6 @@ Package roles:
   templates no longer ship structural, TS/TSX, style, or block-local `render.php`
   Mustache files.
 - `@wp-typia/block-runtime/*` owns generated-project runtime helpers.
-- `@wp-typia/create` is the deprecated legacy package shell.
 
 Supported public imports:
 

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-prompt.js

@@ -18,18 +18,17 @@ export function createReadlinePrompt() {
  * retry behavior without stubbing global stdin/stdout.
  */
 export function createReadlinePromptWithInterface(rl) {
+    const askQuestion = (query) => new Promise((resolve) => {
+        rl.question(query, resolve);
+    });
     return {
         async text(message, defaultValue, validate) {
-            const suffix = defaultValue ? ` (${defaultValue})` : "";
             while (true) {
-                const answer = await new Promise((resolve) => {
-                    rl.question(`${message}${suffix}: `, resolve);
-                });
-                const value = String(answer).trim() || defaultValue;
+                const value = normalizePromptAnswer(await askQuestion(formatTextPrompt(message, defaultValue))) || defaultValue;
                 if (validate) {
                     const result = validate(value);
                     if (result !== true) {
-                        console.error(`❌ ${typeof result === "string" ? result : "Invalid input"}`);
+                        console.error(formatValidationError(message, result, defaultValue));
                         continue;
                     }
                 }
@@ -40,22 +39,22 @@ export function createReadlinePromptWithInterface(rl) {
             if (options.length === 0) {
                 throw new Error(`select() requires at least one option for prompt: ${message}`);
             }
-            console.log(message);
-            options.forEach((option, index) => {
-                const hint = option.hint ? ` - ${option.hint}` : "";
-                console.log(`  ${index + 1}. ${option.label}${hint}`);
-            });
+            const resolvedDefaultIndex = getResolvedDefaultIndex(options, defaultValue);
+            renderSelectPrompt(message, options, resolvedDefaultIndex);
             while (true) {
-                const answer = await this.text("Choice", String(defaultValue));
-                const numericChoice = Number(answer);
-                if (!Number.isNaN(numericChoice) && options[numericChoice - 1]) {
-                    return options[numericChoice - 1].value;
+                const answer = normalizePromptAnswer(await askQuestion(formatChoicePrompt(resolvedDefaultIndex)));
+                if (answer.length === 0) {
+                    return options[resolvedDefaultIndex].value;
+                }
+                const selection = resolvePromptSelection(options, answer);
+                if (selection) {
+                    return selection.value;
                 }
-                const directChoice = options.find((option) => option.value === answer);
-                if (directChoice) {
-                    return directChoice.value;
+                if (isPromptHelpToken(answer)) {
+                    renderSelectPrompt(message, options, resolvedDefaultIndex);
+                    continue;
                 }
-                console.error(`❌ Invalid selection: ${answer}`);
+                console.error(formatInvalidSelectionError(answer, options, resolvedDefaultIndex));
             }
         },
         close() {
@@ -63,3 +62,63 @@ export function createReadlinePromptWithInterface(rl) {
         },
     };
 }
+function normalizePromptAnswer(value) {
+    return String(value).trim();
+}
+function normalizePromptToken(value) {
+    return value.trim().toLowerCase();
+}
+function getResolvedDefaultIndex(options, defaultValue) {
+    const candidateIndex = Number.isInteger(defaultValue) ? defaultValue - 1 : -1;
+    return options[candidateIndex] ? candidateIndex : 0;
+}
+function formatTextPrompt(message, defaultValue) {
+    const suffix = defaultValue.length > 0 ? ` [default: ${defaultValue}]` : "";
+    return `${message}${suffix}: `;
+}
+function formatValidationError(message, result, defaultValue) {
+    const detail = typeof result === "string" ? result : "Invalid input";
+    const retryHint = defaultValue.length > 0 ? ` Press Enter to keep "${defaultValue}".` : "";
+    return `❌ ${message}: ${detail}.${retryHint}`;
+}
+function formatChoicePrompt(defaultIndex) {
+    return `Choice [default: ${defaultIndex + 1}, ? for options]: `;
+}
+function renderSelectPrompt(message, options, defaultIndex) {
+    console.log(message);
+    console.log("  Enter a number, option label, or option value. Press Enter to keep the default, or type ? to list choices again.");
+    options.forEach((option, index) => {
+        const defaultMarker = index === defaultIndex ? " (default)" : "";
+        const valueHint = normalizePromptToken(option.label) === normalizePromptToken(option.value)
+            ? ""
+            : ` [${option.value}]`;
+        console.log(`  ${index + 1}. ${option.label}${valueHint}${defaultMarker}`);
+        if (option.hint) {
+            console.log(`     ${option.hint}`);
+        }
+    });
+}
+function isPromptHelpToken(answer) {
+    const normalized = normalizePromptToken(answer);
+    return normalized === "?" || normalized === "help" || normalized === "list";
+}
+function resolvePromptSelection(options, answer) {
+    const numericChoice = Number(answer);
+    if (!Number.isNaN(numericChoice) && options[numericChoice - 1]) {
+        return options[numericChoice - 1];
+    }
+    const normalizedAnswer = normalizePromptToken(answer);
+    return options.find((option) => {
+        const normalizedLabel = normalizePromptToken(option.label);
+        const normalizedValue = normalizePromptToken(option.value);
+        return normalizedAnswer === normalizedLabel || normalizedAnswer === normalizedValue;
+    });
+}
+function formatInvalidSelectionError(answer, options, defaultIndex) {
+    const optionValues = options.map((option) => option.value).join(", ");
+    return [
+        `❌ Invalid selection: ${answer}.`,
+        `Enter 1-${options.length}, one of: ${optionValues},`,
+        `or press Enter for "${options[defaultIndex].label}".`,
+    ].join(" ");
+}

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

@@ -0,0 +1,37 @@
+import type { PackageManagerId } from './package-managers.js';
+import type { CollectScaffoldAnswersOptions, ResolvePackageManagerOptions, ResolveTemplateOptions, ScaffoldAnswers } from './scaffold.js';
+/**
+ * Detect the current author name from local Git config.
+ *
+ * @returns The configured Git author name, or `"Your Name"` when unavailable.
+ */
+export declare function detectAuthor(): string;
+/**
+ * Compute the default scaffold answers for one project and template pair.
+ *
+ * @param projectName User-supplied project directory or block name seed.
+ * @param templateId Selected scaffold template identifier.
+ * @returns Normalized default answers for scaffold prompts and non-interactive flows.
+ */
+export declare function getDefaultAnswers(projectName: string, templateId: string): ScaffoldAnswers;
+/**
+ * Resolve the scaffold template id from flags, defaults, and interactive selection.
+ *
+ * @param options Template resolution options for interactive and non-interactive flows.
+ * @returns The normalized template identifier to scaffold.
+ */
+export declare function resolveTemplateId({ templateId, yes, isInteractive, selectTemplate, }: ResolveTemplateOptions): Promise<string>;
+/**
+ * Resolve the package manager id from flags, defaults, and interactive selection.
+ *
+ * @param options Package manager resolution options for interactive and non-interactive flows.
+ * @returns The normalized package manager id.
+ */
+export declare function resolvePackageManagerId({ packageManager, yes, isInteractive, selectPackageManager, }: ResolvePackageManagerOptions): Promise<PackageManagerId>;
+/**
+ * Collect scaffold answers from defaults, CLI overrides, and optional prompts.
+ *
+ * @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, queryPostType, textDomain, }: CollectScaffoldAnswersOptions): Promise<ScaffoldAnswers>;