wp-typia 0.16.1 → 0.16.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -65,10 +65,10 @@
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.2",
-    "@wp-typia/project-tools": "0.16.0",
+    "@wp-typia/project-tools": "0.16.2",
     "better-result": "^2.7.0",
-    "react": "19.2.0",
-    "react-dom": "19.2.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "zod": "4.3.6"
   },
   "devDependencies": {

package/src/commands/add.ts

@@ -5,7 +5,7 @@ import { z } from "zod";
 
 import { getAddBlockDefaults } from "../config";
 import { resolveBundledModuleHref } from "../render-loader";
-import { executeAddCommand, getAddWorkspaceBlockOptions } from "../runtime-bridge";
+import { executeAddCommand } from "../runtime-bridge";
 import type { WpTypiaRenderArgs } from "./render-types";
 import { LazyFlow } from "../ui/lazy-flow";
 
@@ -94,7 +94,6 @@ export const addCommand = defineCommand({
 								template:
 									(args.flags.template as string | undefined) ?? config.template,
 							},
-							workspaceBlockOptions: getAddWorkspaceBlockOptions(args.cwd),
 						},
 					});
 				},

package/src/commands/doctor.ts

@@ -1,6 +1,5 @@
 import { defineCommand } from "@bunli/core";
-
-import { getDoctorChecks, runDoctor } from "@wp-typia/project-tools";
+import { executeDoctorCommand } from "../runtime-bridge";
 
 export const doctorCommand = defineCommand({
 	description: "Run repository and project diagnostics.",
@@ -10,6 +9,7 @@ export const doctorCommand = defineCommand({
 			args.agent ||
 			Boolean(args.context?.store?.isAIAgent);
 		if (prefersStructuredOutput) {
+			const { getDoctorChecks } = await import("@wp-typia/project-tools/cli-doctor");
 			const checks = await getDoctorChecks(args.cwd);
 			args.output({ checks });
 			if (checks.some((check) => check.status === "fail")) {
@@ -17,7 +17,7 @@ export const doctorCommand = defineCommand({
 			}
 			return;
 		}
-		await runDoctor(args.cwd);
+		await executeDoctorCommand(args.cwd);
 	},
 	name: "doctor",
 });

package/src/runtime-bridge.ts

@@ -3,29 +3,15 @@ import fs from "node:fs";
 import path from "node:path";
 
 import {
-	createReadlinePrompt,
-	formatRunScript,
-	formatAddHelpText,
-	formatMigrationHelpText,
 	formatTemplateDetails,
 	formatTemplateFeatures,
 	formatTemplateSummary,
-	getWorkspaceBlockSelectOptions,
 	getTemplateById,
-	getTemplateSelectOptions,
 	listTemplates,
-	parseMigrationArgs,
-	tryResolveWorkspaceProject,
-	runAddBindingSourceCommand,
-	runAddBlockCommand,
-	runAddHookedBlockCommand,
-	runAddPatternCommand,
-	runAddVariationCommand,
-	runDoctor,
-	runMigrationCommand,
-	runScaffoldFlow,
-} from "@wp-typia/project-tools";
-import type { ReadlinePrompt } from "@wp-typia/project-tools";
+} from "@wp-typia/project-tools/cli-templates";
+import { formatRunScript } from "@wp-typia/project-tools/package-managers";
+import { tryResolveWorkspaceProject } from "@wp-typia/project-tools/workspace-project";
+import type { ReadlinePrompt } from "@wp-typia/project-tools/cli-prompt";
 
 type CreateExecutionInput = {
 	projectDir: string;
@@ -72,6 +58,13 @@ type SyncProjectContext = {
 	scripts: Partial<Record<"sync" | "sync-rest" | "sync-types", string>>;
 };
 
+const loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add");
+const loadCliDoctorRuntime = () => import("@wp-typia/project-tools/cli-doctor");
+const loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt");
+const loadCliScaffoldRuntime = () => import("@wp-typia/project-tools/cli-scaffold");
+const loadCliTemplatesRuntime = () => import("@wp-typia/project-tools/cli-templates");
+const loadMigrationsRuntime = () => import("@wp-typia/project-tools/migrations");
+
 function printBlock(lines: string[], printLine: PrintLine): void {
 	for (const line of lines) {
 		printLine(line);
@@ -272,6 +265,15 @@ export async function executeCreateCommand({
 	interactive,
 	prompt,
 }: CreateExecutionInput): Promise<void> {
+	const [
+		{ createReadlinePrompt },
+		{ runScaffoldFlow },
+		{ getTemplateSelectOptions },
+	] = await Promise.all([
+		loadCliPromptRuntime(),
+		loadCliScaffoldRuntime(),
+		loadCliTemplatesRuntime(),
+	]);
 	const shouldPrompt =
 		interactive ?? (!Boolean(flags.yes) && Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY));
 	const activePrompt = shouldPrompt ? (prompt ?? createReadlinePrompt()) : undefined;
@@ -364,10 +366,13 @@ export async function executeAddCommand({
 	name,
 }: AddExecutionInput): Promise<void> {
 	if (!kind) {
+		const { formatAddHelpText } = await loadCliAddRuntime();
 		console.log(formatAddHelpText());
 		return;
 	}
 
+	const addRuntime = await loadCliAddRuntime();
+
 	if (kind === "variation") {
 		if (!name) {
 			throw new Error(
@@ -380,7 +385,7 @@ export async function executeAddCommand({
 			throw new Error("`wp-typia add variation` requires --block <block-slug>.");
 		}
 
-		const result = await runAddVariationCommand({
+		const result = await addRuntime.runAddVariationCommand({
 			blockName: blockSlug,
 			cwd,
 			variationName: name,
@@ -396,7 +401,7 @@ export async function executeAddCommand({
 			);
 		}
 
-		const result = await runAddPatternCommand({
+		const result = await addRuntime.runAddPatternCommand({
 			cwd,
 			patternName: name,
 		});
@@ -411,7 +416,7 @@ export async function executeAddCommand({
 			);
 		}
 
-		const result = await runAddBindingSourceCommand({
+		const result = await addRuntime.runAddBindingSourceCommand({
 			bindingSourceName: name,
 			cwd,
 		});
@@ -438,7 +443,7 @@ export async function executeAddCommand({
 			);
 		}
 
-		const result = await runAddHookedBlockCommand({
+		const result = await addRuntime.runAddHookedBlockCommand({
 			anchorBlockName,
 			blockName: name,
 			cwd,
@@ -468,7 +473,7 @@ export async function executeAddCommand({
 		);
 	}
 
-	const result = await runAddBlockCommand({
+	const result = await addRuntime.runAddBlockCommand({
 		blockName: name,
 		cwd,
 		dataStorageMode: readOptionalStringFlag(flags, "data-storage"),
@@ -524,9 +529,20 @@ export async function executeTemplatesCommand(
 }
 
 export async function executeDoctorCommand(cwd: string): Promise<void> {
+	const { runDoctor } = await loadCliDoctorRuntime();
 	await runDoctor(cwd);
 }
 
+export async function loadAddWorkspaceBlockOptions(cwd: string) {
+	const workspace = tryResolveWorkspaceProject(cwd);
+	if (!workspace) {
+		return [];
+	}
+
+	const { getWorkspaceBlockSelectOptions } = await loadCliAddRuntime();
+	return getWorkspaceBlockSelectOptions(workspace.projectDir);
+}
+
 export async function executeSyncCommand({
 	check = false,
 	cwd,
@@ -553,6 +569,8 @@ export async function executeMigrateCommand({
 	prompt,
 	renderLine,
 }: MigrateExecutionInput): Promise<void> {
+	const { formatMigrationHelpText, parseMigrationArgs, runMigrationCommand } =
+		await loadMigrationsRuntime();
 	if (!command) {
 		console.log(formatMigrationHelpText());
 		return;
@@ -587,13 +605,4 @@ export async function executeMigrateCommand({
 	});
 }
 
-export function getAddWorkspaceBlockOptions(cwd: string) {
-	const workspace = tryResolveWorkspaceProject(cwd);
-	if (!workspace) {
-		return [];
-	}
-
-	return getWorkspaceBlockSelectOptions(workspace.projectDir);
-}
-
-export { formatAddHelpText, formatMigrationHelpText, listTemplates };
+export { listTemplates };

package/src/ui/README.md

@@ -22,3 +22,22 @@ Alternate-buffer lifecycle contract:
 - Mounted flows must use the shared alternate-buffer lifecycle helper instead of ad hoc exit logic.
 - `create`, `add`, and `migrate` must always call `runtime.exit()` on submit success, cancel, and quit.
 - Runtime execution failures use exit-on-failure: report the error, then exit immediately.
+
+First-party form interaction contract:
+
+- `create`, `add`, and `migrate` use a shared first-party form layer instead of relying on `SchemaForm` field traversal.
+- Small viewport safety is part of the `wp-typia` contract: active fields must stay inside a scrollable viewport and footer help must not overlap the form body.
+- Keyboard traversal is owned locally by `wp-typia`.
+  - `Tab` / `Shift+Tab` move across the visible field order.
+  - Select fields handle arrow-key movement and preserve traversal when moving back out to the next field.
+  - Checkbox fields use `Space` / `Enter` to toggle without trapping focus.
+  - Hidden conditional fields must never keep focus or leak stale values into submit payloads.
+- `Ctrl+S` submit must stay reachable through the shared first-party field layer, not only through Bunli's form-level hotkeys.
+
+Regression and triage contract:
+
+- The committed regression contract is the first-party model and layout test suite under `packages/wp-typia/tests`.
+- `create-flow-layout.test.ts` keeps the small-viewport scroll model and checkbox-cluster ordering pinned.
+- `tui-interaction-models.test.ts` keeps visible field ordering and submit sanitization pinned for `add` and `migrate`.
+- The committed tests deliberately stop short of a repo-level PTY smoke because the alternate-buffer harness cost and flake surface outweighed the regression value for this round.
+- If a future regression needs terminal-level confirmation, reproduce it from the real `wp-typia` command first before classifying it as a Bunli-level issue.

package/src/ui/add-flow-model.ts

@@ -0,0 +1,120 @@
+import { z } from "zod";
+
+import {
+	FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+	FIRST_PARTY_TEXT_FIELD_BODY_HEIGHT,
+	getFirstPartyScrollTop,
+	getFirstPartyViewportHeight,
+} from "./first-party-form-model";
+
+export const addFlowSchema = z.object({
+	anchor: z.string().optional(),
+	block: z.string().optional(),
+	"data-storage": z.string().optional(),
+	kind: z
+		.enum(["block", "variation", "pattern", "binding-source", "hooked-block"])
+		.default("block"),
+	name: z.string().optional(),
+	"persistence-policy": z.string().optional(),
+	position: z.string().optional(),
+	template: z.string().optional(),
+});
+
+export type AddFlowValues = z.infer<typeof addFlowSchema>;
+
+export type AddFieldName =
+	| "kind"
+	| "name"
+	| "template"
+	| "block"
+	| "anchor"
+	| "position"
+	| "data-storage"
+	| "persistence-policy";
+
+const ADD_FIELD_ORDER = [
+	"kind",
+	"name",
+	"template",
+	"block",
+	"anchor",
+	"position",
+	"data-storage",
+	"persistence-policy",
+] as const satisfies ReadonlyArray<AddFieldName>;
+
+const ADD_FIELD_HEIGHTS: Record<AddFieldName, number> = {
+	anchor: FIRST_PARTY_TEXT_FIELD_BODY_HEIGHT,
+	block: FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+	"data-storage": FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+	kind: FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+	name: FIRST_PARTY_TEXT_FIELD_BODY_HEIGHT,
+	"persistence-policy": FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+	position: FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+	template: FIRST_PARTY_SELECT_FIELD_BODY_HEIGHT,
+};
+
+export function isAddPersistenceTemplate(template?: string): boolean {
+	return template === "persistence" || template === "compound";
+}
+
+export function getVisibleAddFieldNames(values: Partial<AddFlowValues>): Array<AddFieldName> {
+	switch (values.kind ?? "block") {
+		case "variation":
+			return ["kind", "name", "block"];
+		case "pattern":
+			return ["kind", "name"];
+		case "binding-source":
+			return ["kind", "name"];
+		case "hooked-block":
+			return ["kind", "name", "anchor", "position"];
+		case "block":
+		default:
+			return ADD_FIELD_ORDER.filter((name) => {
+				if (name === "data-storage" || name === "persistence-policy") {
+					return isAddPersistenceTemplate(values.template);
+				}
+				return name === "kind" || name === "name" || name === "template";
+			});
+	}
+}
+
+export function getAddViewportHeight(terminalHeight = 24): number {
+	return getFirstPartyViewportHeight(terminalHeight);
+}
+
+export function getAddScrollTop(options: {
+	activeFieldName: string | null;
+	values: Partial<AddFlowValues>;
+	viewportHeight: number;
+}): number {
+	const { activeFieldName, values, viewportHeight } = options;
+	return getFirstPartyScrollTop({
+		activeFieldName,
+		fieldHeights: ADD_FIELD_HEIGHTS,
+		visibleFieldNames: getVisibleAddFieldNames(values),
+		viewportHeight,
+	});
+}
+
+export function sanitizeAddSubmitValues(values: AddFlowValues): Record<string, unknown> {
+	const visibleFields = new Set(getVisibleAddFieldNames(values));
+	const sanitized: Record<string, unknown> = {};
+
+	for (const fieldName of visibleFields) {
+		const value = values[fieldName];
+		if (typeof value === "string") {
+			const trimmed = value.trim();
+			if (trimmed.length > 0) {
+				sanitized[fieldName] = trimmed;
+			}
+			continue;
+		}
+
+		if (value !== undefined && value !== null) {
+			sanitized[fieldName] = value;
+		}
+	}
+
+	return sanitized;
+}