@wp-typia/project-tools 0.16.5 → 0.16.7

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

@@ -12,10 +12,35 @@ export interface ReadlinePrompt {
     select<T extends string>(message: string, options: PromptOption<T>[], defaultValue?: number): Promise<T>;
     text(message: string, defaultValue: string, validate?: ValidateInput): Promise<string>;
 }
+/**
+ * Adapter interface for readline-style prompt interactions.
+ *
+ * Public CLI code uses the native readline implementation, while tests can
+ * substitute lightweight doubles that expose the same `question` and `close`
+ * methods.
+ */
+export interface ReadlineQuestionAdapter {
+    /** Close the underlying prompt interface and release any open handles. */
+    close(): void;
+    /**
+     * Render one prompt and resolve with the collected answer string.
+     *
+     * @param query Prompt text written to the active output stream.
+     * @param callback Callback that receives the entered answer.
+     */
+    question(query: string, callback: (answer: string) => void): void;
+}
 /**
  * Create the default readline-backed prompt implementation for the CLI.
  *
  * @returns A prompt adapter that reads from stdin and writes to stdout.
  */
 export declare function createReadlinePrompt(): ReadlinePrompt;
+/**
+ * Build a prompt adapter around a supplied readline-style question interface.
+ *
+ * This keeps the production CLI path unchanged while letting tests validate
+ * retry behavior without stubbing global stdin/stdout.
+ */
+export declare function createReadlinePromptWithInterface(rl: ReadlineQuestionAdapter): ReadlinePrompt;
 export {};

package/dist/runtime/cli-prompt.js

@@ -9,21 +9,32 @@ export function createReadlinePrompt() {
         input: process.stdin,
         output: process.stdout,
     });
+    return createReadlinePromptWithInterface(rl);
+}
+/**
+ * Build a prompt adapter around a supplied readline-style question interface.
+ *
+ * This keeps the production CLI path unchanged while letting tests validate
+ * retry behavior without stubbing global stdin/stdout.
+ */
+export function createReadlinePromptWithInterface(rl) {
     return {
         async text(message, defaultValue, validate) {
             const suffix = defaultValue ? ` (${defaultValue})` : "";
-            const answer = await new Promise((resolve) => {
-                rl.question(`${message}${suffix}: `, resolve);
-            });
-            const value = String(answer).trim() || defaultValue;
-            if (validate) {
-                const result = validate(value);
-                if (result !== true) {
-                    console.error(`❌ ${typeof result === "string" ? result : "Invalid input"}`);
-                    return this.text(message, defaultValue, validate);
+            while (true) {
+                const answer = await new Promise((resolve) => {
+                    rl.question(`${message}${suffix}: `, resolve);
+                });
+                const value = String(answer).trim() || defaultValue;
+                if (validate) {
+                    const result = validate(value);
+                    if (result !== true) {
+                        console.error(`❌ ${typeof result === "string" ? result : "Invalid input"}`);
+                        continue;
+                    }
                 }
+                return value;
             }
-            return value;
         },
         async select(message, options, defaultValue = 1) {
             if (options.length === 0) {
@@ -34,17 +45,18 @@ export function createReadlinePrompt() {
                 const hint = option.hint ? ` - ${option.hint}` : "";
                 console.log(`  ${index + 1}. ${option.label}${hint}`);
             });
-            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 directChoice = options.find((option) => option.value === answer);
-            if (directChoice) {
-                return directChoice.value;
+            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 directChoice = options.find((option) => option.value === answer);
+                if (directChoice) {
+                    return directChoice.value;
+                }
+                console.error(`❌ Invalid selection: ${answer}`);
             }
-            console.error(`❌ Invalid selection: ${answer}`);
-            return this.select(message, options, defaultValue);
         },
         close() {
             rl.close();

package/dist/runtime/cli-scaffold.js

@@ -4,8 +4,7 @@ import { collectScaffoldAnswers, DATA_STORAGE_MODES, PERSISTENCE_POLICIES, isDat
 import { formatInstallCommand, formatRunScript, } from "./package-managers.js";
 import { getPrimaryDevelopmentScript } from "./local-dev-presets.js";
 import { getOptionalOnboardingNote, getOptionalOnboardingSteps, } from "./scaffold-onboarding.js";
-import { isBuiltInTemplateId } from "./template-registry.js";
-const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
+import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, isBuiltInTemplateId, } from "./template-registry.js";
 function templateUsesPersistenceSettings(templateId, options) {
     if (templateId === "persistence") {
         return true;

package/dist/runtime/migration-types.d.ts

@@ -1,56 +1,12 @@
-export type JsonPrimitive = string | number | boolean | null;
-export type JsonValue = JsonPrimitive | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-export type ManifestTsKind = "string" | "number" | "boolean" | "array" | "object" | "union";
-export interface ManifestConstraints {
-    exclusiveMaximum?: number | null;
-    exclusiveMinimum?: number | null;
-    format?: string | null;
-    maxLength?: number | null;
-    maxItems?: number | null;
-    maximum?: number | null;
-    minLength?: number | null;
-    minItems?: number | null;
-    minimum?: number | null;
-    multipleOf?: number | null;
-    pattern?: string | null;
-    typeTag?: string | null;
-}
-export interface ManifestUnionMetadata {
-    discriminator: string;
-    branches: Record<string, ManifestAttribute>;
-}
-export interface ManifestTsMetadata {
-    items?: ManifestAttribute | null;
-    kind: ManifestTsKind;
-    properties?: Record<string, ManifestAttribute> | null;
-    required?: boolean;
-    union?: ManifestUnionMetadata | null;
-}
-export interface ManifestTypiaMetadata {
-    constraints: ManifestConstraints;
-    defaultValue?: JsonValue | null;
-    hasDefault?: boolean;
-}
-export interface ManifestWpMetadata {
-    defaultValue?: JsonValue | null;
-    enum?: JsonValue[] | null;
-    hasDefault?: boolean;
-    selector?: string | null;
-    source?: "html" | "text" | "rich-text" | null;
-    type?: string | null;
-}
-export interface ManifestAttribute {
-    ts: ManifestTsMetadata;
-    typia: ManifestTypiaMetadata;
-    wp: ManifestWpMetadata;
-}
-export interface ManifestDocument {
-    attributes?: Record<string, ManifestAttribute>;
-    manifestVersion?: number | null;
-    sourceType?: string | null;
-}
+/**
+ * Shared migration contract facade for project-tools runtime.
+ *
+ * Re-exports canonical manifest and migration contracts from
+ * `@wp-typia/block-runtime/migration-types` and layers project-tools-specific
+ * migration workspace types on top.
+ */
+import type { JsonValue, ManifestAttribute, ManifestDocument } from "@wp-typia/block-runtime/migration-types";
+export type { JsonPrimitive, JsonValue, ManifestAttribute, ManifestConstraints, ManifestDocument, ManifestTsKind, ManifestTsMetadata, ManifestTypiaMetadata, ManifestUnionMetadata, ManifestWpMetadata, } from "@wp-typia/block-runtime/migration-types";
 export interface ManifestSummaryAttribute {
     constraints: ManifestAttribute["typia"]["constraints"];
     defaultValue: ManifestAttribute["typia"]["defaultValue"] | null;

package/dist/runtime/scaffold.js

@@ -13,13 +13,12 @@ import { getStarterManifestFiles, stringifyStarterManifest } from "./starter-man
 import { toKebabCase, toPascalCase, toSnakeCase, toTitleCase, } from "./string-case.js";
 import { BUILTIN_BLOCK_METADATA_VERSION, COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS, getBuiltInTemplateMetadataDefaults, getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
 import { copyInterpolatedDirectory } from "./template-render.js";
-import { PROJECT_TOOLS_PACKAGE_ROOT, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from "./template-registry.js";
+import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, PROJECT_TOOLS_PACKAGE_ROOT, TEMPLATE_IDS, getTemplateById, isBuiltInTemplateId, } from "./template-registry.js";
 import { resolveTemplateSource } from "./template-source.js";
 import { BlockGeneratorService, buildTemplateVariablesFromBlockSpec, createBuiltInBlockSpec, } from "./block-generator-service.js";
 const BLOCK_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
 const PHP_PREFIX_PATTERN = /^[a-z_][a-z0-9_]*$/;
 const PHP_PREFIX_MAX_LENGTH = 50;
-const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
 const WORKSPACE_TEMPLATE_ALIAS = "workspace";
 const EPHEMERAL_NODE_MODULES_LINK_TYPE = process.platform === "win32" ? "junction" : "dir";
 const LOCKFILES = {

package/dist/runtime/template-source.js

@@ -9,7 +9,7 @@ import { pathToFileURL } from "node:url";
 import npa from "npm-package-arg";
 import semver from "semver";
 import { x as extractTarball } from "tar";
-import { BUILTIN_TEMPLATE_IDS, PROJECT_TOOLS_PACKAGE_ROOT, isBuiltInTemplateId, } from "./template-registry.js";
+import { BUILTIN_TEMPLATE_IDS, OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, PROJECT_TOOLS_PACKAGE_ROOT, isBuiltInTemplateId, } from "./template-registry.js";
 import { isPlainObject } from "./object-utils.js";
 import { getRemovedBuiltInTemplateMessage, isRemovedBuiltInTemplateId, } from "./template-defaults.js";
 import { getBuiltInTemplateLayerDirs, isOmittableBuiltInTemplateLayerDir, resolveBuiltInTemplateSource, } from "./template-builtins.js";
@@ -18,7 +18,6 @@ import { toSegmentPascalCase } from "./string-case.js";
 import { copyRawDirectory, copyRenderedDirectory } from "./template-render.js";
 const EXTERNAL_TEMPLATE_ENTRY_CANDIDATES = ["index.js", "index.cjs", "index.mjs"];
 const TEMPLATE_WARNING_MESSAGE = "wp-typia owns package/tooling/sync setup for generated projects, so this external template setting is ignored.";
-const OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE = "@wp-typia/create-workspace-template";
 function isTemplatePathLocator(templateId) {
     return path.isAbsolute(templateId) || templateId.startsWith("./") || templateId.startsWith("../");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.16.5",
+  "version": "0.16.7",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -75,7 +75,7 @@
     "prepack": "bun run build && node ./scripts/publish-manifest.mjs prepare",
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
-    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/cli-entry.test.ts tests/import-policy.test.ts",
+    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts",
     "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
     "test:migration-planning": "bun run build && bun test tests/migration-init.test.ts tests/migration-config.test.ts tests/migration-plan-wizard.test.ts",
@@ -114,9 +114,9 @@
     "bun": ">=1.3.11"
   },
   "dependencies": {
-    "@wp-typia/api-client": "^0.4.2",
-    "@wp-typia/block-runtime": "^0.4.5",
-    "@wp-typia/rest": "^0.3.5",
+    "@wp-typia/api-client": "^0.4.4",
+    "@wp-typia/block-runtime": "^0.4.7",
+    "@wp-typia/rest": "^0.3.7",
     "@wp-typia/block-types": "^0.2.1",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
@@ -126,8 +126,6 @@
     "typescript": "^5.9.2"
   },
   "devDependencies": {
-    "react": "^19.2.0",
-    "react-devtools-core": "^7.0.1",
-    "ws": "^8.18.0"
+    "react": "^19.2.0"
   }
 }

package/templates/_shared/base/package.json.mustache

@@ -28,6 +28,7 @@
     "@wordpress/scripts": "^30.22.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "@typia/unplugin": "^12.0.1",
+    "prettier": "3.8.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "typia": "^12.0.1"

package/templates/_shared/compound/core/package.json.mustache

@@ -31,7 +31,7 @@
     "@types/wordpress__blocks": "^12.5.18",
     "ajv": "^8.18.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "prettier": "2.8.8",
+    "prettier": "3.8.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "typia": "^12.0.1"

package/templates/_shared/compound/core/scripts/add-compound-child.ts.mustache

@@ -460,7 +460,8 @@ function renderEditFile(
 ): string {
 	const childCssClassName = buildBlockCssClassName( PARENT_BLOCK_NAMESPACE, childFolderSlug );
 
-	return `import { RichText, useBlockProps } from '@wordpress/block-editor';
+	return `import type { BlockEditProps } from '@wordpress/blocks';
+import { RichText, useBlockProps } from '@wordpress/block-editor';
 import { Notice } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
 
@@ -471,13 +472,12 @@ import {
 \tvalidate${ childInterfaceName },
 } from './validators';
 
+type EditProps = BlockEditProps< ${ childTypeName } >;
+
 export default function Edit( {
 \tattributes,
 \tsetAttributes,
-}: {
-\tattributes: ${ childTypeName };
-\tsetAttributes: ( attrs: Partial< ${ childTypeName } > ) => void;
-} ) {
+}: EditProps ) {
 \tconst updateAttribute = createAttributeUpdater( attributes, setAttributes );
 \tconst { errorMessages, isValid } = useTypiaValidation(
 \t\tattributes,

package/templates/_shared/compound/persistence/package.json.mustache

@@ -34,7 +34,7 @@
     "@types/wordpress__blocks": "^12.5.18",
     "ajv": "^8.18.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "prettier": "2.8.8",
+    "prettier": "3.8.2",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "typia": "^12.0.1"

package/templates/_shared/persistence/core/package.json.mustache

@@ -31,6 +31,7 @@
 		"@wordpress/scripts": "^30.22.0",
 		"eslint-plugin-jsx-a11y": "^6.10.2",
 		"@typia/unplugin": "^12.0.1",
+		"prettier": "3.8.2",
 		"tsx": "^4.20.5",
 		"typescript": "^5.9.2",
 		"typia": "^12.0.1"

package/templates/interactivity/package.json.mustache

@@ -25,9 +25,10 @@
 		"@types/wordpress__block-editor": "^11.5.17",
 		"@types/wordpress__blocks": "^12.5.18",
 		"@wordpress/browserslist-config": "^6.42.0",
-    "@wordpress/scripts": "^30.22.0",
+		"@wordpress/scripts": "^30.22.0",
 		"eslint-plugin-jsx-a11y": "^6.10.2",
 		"@typia/unplugin": "^12.0.1",
+		"prettier": "3.8.2",
 		"tsx": "^4.20.5",
 		"typescript": "^5.9.2",
 		"typia": "^12.0.1"