wp-typia 0.11.1 → 0.12.0

package/.bunli/commands.gen.ts

@@ -0,0 +1,105 @@
+// This file was automatically generated by Bunli.
+// You should NOT make any changes in this file as it will be overwritten.
+
+import type { Command, CLI, GeneratedOptionMeta, RegisteredCommands, CommandOptions, GeneratedCommandMeta } from '@bunli/core'
+import { createGeneratedHelpers, registerGeneratedStore } from '@bunli/core'
+
+import Add from '../src/commands/add.js'
+import Create from '../src/commands/create.js'
+import Doctor from '../src/commands/doctor.js'
+import Mcp from '../src/commands/mcp.js'
+import Migrate from '../src/commands/migrate.js'
+import Templates from '../src/commands/templates.js'
+
+// Narrow list of command names to avoid typeof-cycles in types
+const names = ['add', 'create', 'doctor', 'mcp', 'migrate', 'templates'] as const
+type GeneratedNames = typeof names[number]
+
+const modules: Record<GeneratedNames, Command<any>> = {
+  'add': Add,
+  'create': Create,
+  'doctor': Doctor,
+  'mcp': Mcp,
+  'migrate': Migrate,
+  'templates': Templates
+} as const
+
+const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
+  'add': {
+      name: 'add',
+      description: 'Extend an official wp-typia workspace with blocks, variations, or patterns.',
+      path: './src/commands/add'
+    },
+  'create': {
+      name: 'create',
+      description: 'Scaffold a new wp-typia project.',
+      path: './src/commands/create'
+    },
+  'doctor': {
+      name: 'doctor',
+      description: 'Run repository and project diagnostics.',
+      path: './src/commands/doctor'
+    },
+  'mcp': {
+      name: 'mcp',
+      description: 'Inspect or sync schema-driven MCP metadata for wp-typia.',
+      path: './src/commands/mcp'
+    },
+  'migrate': {
+      name: 'migrate',
+      description: 'Run migration workflows for migration-capable wp-typia projects.',
+      path: './src/commands/migrate'
+    },
+  'templates': {
+      name: 'templates',
+      description: 'Inspect built-in and external scaffold templates.',
+      path: './src/commands/templates'
+    }
+} as const
+
+export const generated = registerGeneratedStore(createGeneratedHelpers(modules, metadata))
+
+export const commands = generated.commands
+export const commandMeta = generated.metadata
+
+export interface GeneratedCLI {
+  register(cli?: CLI<any>): GeneratedCLI
+  list(): Array<{
+    name: GeneratedNames
+    command: (typeof modules)[GeneratedNames]
+    metadata: (typeof metadata)[GeneratedNames]
+  }>
+  get<Name extends GeneratedNames>(name: Name): (typeof modules)[Name]
+  getMetadata<Name extends GeneratedNames>(name: Name): (typeof metadata)[Name]
+  getFlags<Name extends keyof RegisteredCommands & string>(name: Name): CommandOptions<Name>
+  getFlagsMeta<Name extends GeneratedNames>(name: Name): Record<string, GeneratedOptionMeta>
+  withCLI(cli: CLI<any>): { execute(name: string, options: unknown): Promise<void> }
+}
+
+export const cli: GeneratedCLI = {
+  register: (cliInstance?: CLI<any>) => { generated.register(cliInstance); return cli },
+  list: () => generated.list(),
+  get: <Name extends GeneratedNames>(name: Name) => generated.get(name),
+  getMetadata: <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name),
+  getFlags: <Name extends keyof RegisteredCommands & string>(name: Name) => generated.getFlags(name) as CommandOptions<Name>,
+  getFlagsMeta: <Name extends GeneratedNames>(name: Name) => generated.getFlagsMeta(name),
+  withCLI: (cliInstance) => generated.withCLI(cliInstance)
+}
+
+// Enhanced helper functions
+export const listCommands = () => generated.list().map(c => c.name)
+export const getCommandApi = <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name)
+export const getTypedFlags = <Name extends GeneratedNames>(name: Name) => generated.getFlags(name) as CommandOptions<Name>
+export const validateCommand = <Name extends GeneratedNames>(name: Name, flags: Record<string, unknown>) => generated.validateCommand(name, flags)
+export const findCommandByName = <Name extends GeneratedNames>(name: Name) => generated.findByName(name)
+export const findCommandsByDescription = (searchTerm: string) => generated.findByDescription(searchTerm)
+export const getCommandNames = () => generated.getCommandNames()
+
+// Auto-register on import for zero-config usage
+export default cli
+
+// Ensure module augmentation happens on import
+declare module '@bunli/core' {
+  // Precise key mapping without typeof cycles
+  interface RegisteredCommands extends Record<GeneratedNames, Command<any>> {}
+}

package/README.md

@@ -6,8 +6,17 @@ Use this package for new installs:
 
 - `npx wp-typia create my-block`
 - `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`
+
+`wp-typia <project-dir>` remains available as a backward-compatible alias to
+`wp-typia create <project-dir>`.
 
 Compatibility notes:
 
-- `@wp-typia/create` remains available for existing installs and programmatic imports
-- `create-wp-typia` remains available only as the legacy initializer shim until it is archived
+- `@wp-typia/project-tools` is the canonical programmatic project orchestration package
+- `@wp-typia/create` is the deprecated legacy package shell
+- `create-wp-typia` is archived and should not be used for new installs
+
+Maintainers: see [`docs/bunli-cli-migration.md`](../../docs/bunli-cli-migration.md)
+for the active CLI ownership contract and the staged Bunli cutover plan.

package/bin/wp-typia.js

@@ -1,3 +1,38 @@
 #!/usr/bin/env node
 
-import "@wp-typia/create/cli";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const cliEntrypoint = path.join(packageRoot, "src", "cli.ts");
+const bunBinary = process.env.BUN_BIN || "bun";
+
+const result = spawnSync(
+	bunBinary,
+	[
+		"--eval",
+		`
+			const [moduleUrl, ...argv] = process.argv.slice(1);
+			const mod = await import(moduleUrl);
+			await mod.main(argv);
+		`,
+		pathToFileURL(cliEntrypoint).href,
+		...process.argv.slice(2),
+	],
+	{
+		cwd: process.cwd(),
+		env: process.env,
+		stdio: "inherit",
+	},
+);
+
+if (result.error) {
+	console.error(
+		"❌ wp-typia requires Bun 1.3.11+ to run the Bunli-powered CLI. Install Bun or set BUN_BIN to a compatible runtime.",
+	);
+	console.error(result.error instanceof Error ? result.error.message : result.error);
+	process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/bunli.config.ts

@@ -0,0 +1,31 @@
+import { defineConfig } from "@bunli/core";
+
+import packageJson from "./package.json";
+
+export const bunliConfig = defineConfig({
+	name: packageJson.name,
+	version: packageJson.version,
+	description: packageJson.description,
+	commands: {
+		entry: "./src/cli.ts",
+		directory: "./src/commands",
+		generateReport: true,
+	},
+	build: {
+		entry: "./src/cli.ts",
+		outdir: "./dist-bunli",
+		sourcemap: true,
+	},
+	test: {
+		pattern: ["tests/*.test.ts"],
+		coverage: false,
+		watch: false,
+	},
+	tui: {
+		renderer: {
+			bufferMode: "alternate",
+		},
+	},
+});
+
+export default bunliConfig;

package/package.json

@@ -1,17 +1,32 @@
 {
   "name": "wp-typia",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
-  "packageManager": "bun@1.3.10",
+  "packageManager": "bun@1.3.11",
   "type": "module",
   "bin": {
     "wp-typia": "bin/wp-typia.js"
   },
   "files": [
+    ".bunli/",
     "bin/",
+    "bunli.config.ts",
+    "src/",
     "README.md",
     "package.json"
   ],
+  "scripts": {
+    "generate": "bun scripts/generate-bunli-metadata.ts",
+    "build": "bun run generate",
+    "bunli:generate": "bun run generate",
+    "bunli:build": "bun run build",
+    "bunli:dev": "bun src/cli.ts",
+    "bunli:test": "bun test tests/*.test.ts",
+    "dev": "bun run generate && node bin/wp-typia.js",
+    "test": "cd ../wp-typia-project-tools && bun run build && cd ../wp-typia && bun run generate && bun test tests/*.test.ts",
+    "test:coverage": "cd ../wp-typia-project-tools && bun run build && cd ../wp-typia && bun run generate && bun test tests/*.test.ts --coverage --coverage-reporter=lcov --coverage-dir=coverage",
+    "clean": "rm -rf .bunli"
+  },
   "keywords": [
     "wordpress",
     "gutenberg",
@@ -37,9 +52,36 @@
   "engines": {
     "node": ">=20.0.0",
     "npm": ">=10.0.0",
-    "bun": ">=1.3.10"
+    "bun": ">=1.3.11"
   },
   "dependencies": {
-    "@wp-typia/create": "^0.11.1"
+    "@bunli/core": "0.9.0",
+    "@bunli/plugin-ai-detect": "0.6.4",
+    "@bunli/plugin-completions": "0.3.5",
+    "@bunli/plugin-config": "0.4.4",
+    "@bunli/plugin-mcp": "0.2.5",
+    "@bunli/plugin-skills": "0.1.0",
+    "@bunli/runtime": "0.3.1",
+    "@bunli/tui": "0.6.0",
+    "@bunli/utils": "0.6.0",
+    "@wp-typia/project-tools": "0.12.0",
+    "better-result": "^2.7.0",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@bunli/generator": "0.6.5",
+    "@bunli/test": "0.6.0",
+    "bunli": "0.9.0",
+    "typescript": "^5.9.2"
+  },
+  "optionalDependencies": {
+    "@opentui/core-darwin-arm64": "0.1.97",
+    "@opentui/core-darwin-x64": "0.1.97",
+    "@opentui/core-linux-arm64": "0.1.97",
+    "@opentui/core-linux-x64": "0.1.97",
+    "@opentui/core-win32-arm64": "0.1.97",
+    "@opentui/core-win32-x64": "0.1.97"
   }
 }

package/src/cli.ts

@@ -0,0 +1,126 @@
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+
+import { createCLI, type CLI } from "@bunli/core";
+import { aiAgentPlugin } from "@bunli/plugin-ai-detect";
+import { completionsPlugin } from "@bunli/plugin-completions";
+import { configMergerPlugin } from "@bunli/plugin-config";
+import { skillsPlugin } from "@bunli/plugin-skills";
+
+import packageJson from "../package.json";
+import { bunliConfig } from "../bunli.config";
+import { normalizeWpTypiaArgv } from "./command-contract";
+import { wpTypiaCommands } from "./command-list";
+import { WP_TYPIA_CONFIG_SOURCES } from "./config";
+import { createWpTypiaSkillsMetadataPlugin } from "./plugins/wp-typia-skills";
+import { wpTypiaUserConfigPlugin } from "./plugins/wp-typia-user-config";
+
+function extractWpTypiaConfigOverride(argv: string[]): {
+	argv: string[];
+	configOverridePath?: string;
+} {
+	const nextArgv: string[] = [];
+	let configOverridePath: string | undefined;
+
+	for (let index = 0; index < argv.length; index += 1) {
+		const arg = argv[index];
+		if (!arg) {
+			continue;
+		}
+
+		if (arg === "--config" || arg === "-c") {
+			const next = argv[index + 1];
+			if (!next || next.startsWith("-")) {
+				throw new Error(`\`${arg}\` requires a value.`);
+			}
+			configOverridePath = next;
+			index += 1;
+			continue;
+		}
+
+		if (arg.startsWith("--config=")) {
+			const inlineValue = arg.slice("--config=".length);
+			if (!inlineValue) {
+				throw new Error("`--config` requires a value.");
+			}
+			configOverridePath = inlineValue;
+			continue;
+		}
+
+		nextArgv.push(arg);
+	}
+
+	return {
+		argv: nextArgv,
+		configOverridePath,
+	};
+}
+
+function resolveGeneratedMetadataPath(moduleUrl: string): string {
+	const candidates = [
+		new URL("./.bunli/commands.gen.js", moduleUrl),
+		new URL("../lib/.bunli/commands.gen.js", moduleUrl),
+		new URL("../.bunli/commands.gen.ts", moduleUrl),
+	];
+
+	for (const candidate of candidates) {
+		const candidatePath = fileURLToPath(candidate);
+		if (fs.existsSync(candidatePath)) {
+			return candidatePath;
+		}
+	}
+
+	return fileURLToPath(new URL("../.bunli/commands.gen.ts", moduleUrl));
+}
+
+export async function createWpTypiaCli(options: {
+	configOverridePath?: string;
+} = {}): Promise<CLI> {
+	const cli = await createCLI({
+		...bunliConfig,
+		description: packageJson.description,
+		name: packageJson.name,
+		plugins: [
+			configMergerPlugin({
+				mergeStrategy: "deep",
+				sources: [...WP_TYPIA_CONFIG_SOURCES],
+			}),
+			wpTypiaUserConfigPlugin({
+				overrideSource: options.configOverridePath,
+			}),
+			aiAgentPlugin({}),
+			createWpTypiaSkillsMetadataPlugin(wpTypiaCommands),
+			skillsPlugin({
+				description: packageJson.description,
+			}),
+			completionsPlugin({
+				commandName: "wp-typia",
+				executable: "wp-typia",
+				generatedPath: resolveGeneratedMetadataPath(import.meta.url),
+			}),
+		],
+		version: packageJson.version,
+	});
+
+	for (const command of wpTypiaCommands) {
+		cli.command(command);
+	}
+
+	return cli;
+}
+
+export async function main(argv = process.argv.slice(2)): Promise<void> {
+	const normalizedArgv = normalizeWpTypiaArgv(argv);
+	const { argv: cliArgv, configOverridePath } = extractWpTypiaConfigOverride(normalizedArgv);
+	const cli = await createWpTypiaCli({ configOverridePath });
+	await cli.run(cliArgv);
+}
+
+if (import.meta.main) {
+	void main().catch((error) => {
+		console.error(error instanceof Error ? error.message : error);
+		process.exit(1);
+	});
+}
+
+export default createWpTypiaCli;

package/src/command-contract.ts

@@ -0,0 +1,232 @@
+export const WP_TYPIA_CANONICAL_CREATE_USAGE = "wp-typia create <project-dir>";
+export const WP_TYPIA_POSITIONAL_ALIAS_USAGE = "wp-typia <project-dir>";
+export const WP_TYPIA_CANONICAL_MIGRATE_USAGE = "wp-typia migrate <subcommand>";
+export const WP_TYPIA_DEPRECATED_MIGRATIONS_USAGE = "wp-typia migrations <subcommand>";
+export const WP_TYPIA_BUNLI_MIGRATION_DOC = "docs/bunli-cli-migration.md";
+
+export const WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES = [
+	"create",
+	"add",
+	"migrate",
+	"templates",
+	"doctor",
+	"mcp",
+	"skills",
+	"completions",
+	"complete",
+] as const;
+
+export const WP_TYPIA_TOP_LEVEL_COMMAND_NAMES = [
+	"create",
+	"add",
+	"migrate",
+	"templates",
+	"doctor",
+	"mcp",
+] as const;
+
+const STRING_OPTION_NAMES_BY_COMMAND = {
+	add: new Set([
+		"block",
+		"data-storage",
+		"persistence-policy",
+		"template",
+	]),
+	create: new Set([
+		"data-storage",
+		"namespace",
+		"package-manager",
+		"persistence-policy",
+		"php-prefix",
+		"template",
+		"text-domain",
+		"variant",
+	]),
+	migrate: new Set([
+		"current-migration-version",
+		"from-migration-version",
+		"iterations",
+		"migration-version",
+		"seed",
+		"to-migration-version",
+	]),
+} as const;
+
+const GLOBAL_STRING_OPTION_NAMES = new Set([
+	"config",
+	"format",
+	"id",
+	"output-dir",
+]);
+
+const SHORT_OPTION_NAMES_WITH_VALUES = new Set([
+	"c",
+	"p",
+	"t",
+]);
+
+function isLongOptionValueConsumer(optionName: string): boolean {
+	if (GLOBAL_STRING_OPTION_NAMES.has(optionName)) {
+		return true;
+	}
+
+	return Object.values(STRING_OPTION_NAMES_BY_COMMAND).some((optionNames) =>
+		optionNames.has(optionName as never),
+	);
+}
+
+function findFirstPositionalIndex(argv: string[]): number {
+	for (let index = 0; index < argv.length; index += 1) {
+		const arg = argv[index];
+		if (arg === "--") {
+			return index + 1 < argv.length ? index + 1 : -1;
+		}
+		if (!arg.startsWith("-") || arg === "-") {
+			return index;
+		}
+		if (arg.startsWith("--")) {
+			if (arg.includes("=")) {
+				continue;
+			}
+			if (isLongOptionValueConsumer(arg.slice(2))) {
+				index += 1;
+			}
+			continue;
+		}
+		if (arg.length === 2 && SHORT_OPTION_NAMES_WITH_VALUES.has(arg.slice(1))) {
+			index += 1;
+		}
+	}
+
+	return -1;
+}
+
+export const WP_TYPIA_FUTURE_COMMAND_TREE = [
+	{
+		description: "Scaffold a new wp-typia project.",
+		name: "create",
+	},
+	{
+		description: "Extend an official wp-typia workspace.",
+		name: "add",
+		subcommands: ["block", "variation", "pattern"],
+	},
+	{
+		description: "Run migration workflows.",
+		name: "migrate",
+		subcommands: [
+			"init",
+			"snapshot",
+			"diff",
+			"scaffold",
+			"plan",
+			"wizard",
+			"verify",
+			"doctor",
+			"fixtures",
+			"fuzz",
+		],
+	},
+	{
+		description: "Inspect scaffold templates.",
+		name: "templates",
+		subcommands: ["list", "inspect"],
+	},
+	{
+		description: "Run repository and project diagnostics.",
+		name: "doctor",
+	},
+	{
+		description: "Inspect or sync schema-driven MCP metadata.",
+		name: "mcp",
+		subcommands: ["list", "sync"],
+	},
+] as const;
+
+export function isReservedTopLevelCommandName(value: string): boolean {
+	return WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES.includes(
+		value as (typeof WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES)[number],
+	);
+}
+
+function assertStringOptionValues(argv: string[]): void {
+	const firstPositionalIndex = findFirstPositionalIndex(argv);
+	if (firstPositionalIndex === -1) {
+		return;
+	}
+
+	const commandName = argv[firstPositionalIndex] as keyof typeof STRING_OPTION_NAMES_BY_COMMAND;
+	const stringOptionNames = new Set<string>(GLOBAL_STRING_OPTION_NAMES);
+	for (const optionName of STRING_OPTION_NAMES_BY_COMMAND[commandName] ?? []) {
+		stringOptionNames.add(optionName);
+	}
+
+	for (let index = firstPositionalIndex + 1; index < argv.length; index += 1) {
+		const arg = argv[index];
+		if (arg === "--") {
+			break;
+		}
+		if (arg.length === 2 && arg.startsWith("-")) {
+			if (SHORT_OPTION_NAMES_WITH_VALUES.has(arg.slice(1))) {
+				const next = argv[index + 1];
+				if (!next || next.startsWith("-")) {
+					throw new Error(`\`${arg}\` requires a value.`);
+				}
+				index += 1;
+			}
+			continue;
+		}
+		if (!arg.startsWith("--")) {
+			continue;
+		}
+
+		const [rawName, inlineValue] = arg.slice(2).split("=", 2);
+		if (!stringOptionNames.has(rawName)) {
+			continue;
+		}
+
+		if (arg.includes("=")) {
+			if (!inlineValue) {
+				throw new Error(`\`--${rawName}\` requires a value.`);
+			}
+			continue;
+		}
+
+		const next = argv[index + 1];
+		if (!next || next.startsWith("-")) {
+			throw new Error(`\`--${rawName}\` requires a value.`);
+		}
+		index += 1;
+	}
+}
+
+export function normalizeWpTypiaArgv(argv: string[]): string[] {
+	const firstPositionalIndex = findFirstPositionalIndex(argv);
+	if (firstPositionalIndex === -1) {
+		return argv;
+	}
+
+	const firstPositional = argv[firstPositionalIndex];
+	if (!firstPositional) {
+		return argv;
+	}
+
+	if (firstPositional === "migrations") {
+		throw new Error(
+			"`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.",
+		);
+	}
+
+	if (isReservedTopLevelCommandName(firstPositional)) {
+		assertStringOptionValues(argv);
+		return argv;
+	}
+
+	const normalizedArgv = [
+		...argv.slice(0, firstPositionalIndex),
+		"create",
+		...argv.slice(firstPositionalIndex),
+	];
+	assertStringOptionValues(normalizedArgv);
+	return normalizedArgv;
+}

package/src/command-list.ts

@@ -0,0 +1,17 @@
+import type { Command } from "@bunli/core";
+
+import { addCommand } from "./commands/add";
+import { createCommand } from "./commands/create";
+import { doctorCommand } from "./commands/doctor";
+import { mcpCommand } from "./commands/mcp";
+import { migrateCommand } from "./commands/migrate";
+import { templatesCommand } from "./commands/templates";
+
+export const wpTypiaCommands: Command<any, any>[] = [
+	createCommand,
+	addCommand,
+	migrateCommand,
+	templatesCommand,
+	doctorCommand,
+	mcpCommand,
+];