wp-typia 0.16.10 → 0.16.12

package/README.md

@@ -12,7 +12,8 @@ Use this package for new installs:
 - `wp-typia add hooked-block counter-card --anchor core/post-content --position after`
 
 `wp-typia <project-dir>` remains available as a backward-compatible alias to
-`wp-typia create <project-dir>`.
+`wp-typia create <project-dir>` when `<project-dir>` is the only positional
+argument.
 
 Compatibility notes:
 
@@ -26,5 +27,6 @@ for the active CLI ownership contract and the staged Bunli cutover plan.
 Project meta docs:
 
 - [Upgrade Guide](https://github.com/imjlk/wp-typia/blob/main/UPGRADE.md)
+- [License](https://github.com/imjlk/wp-typia/blob/main/LICENSE)
 - [Security Policy](https://github.com/imjlk/wp-typia/blob/main/SECURITY.md)
 - [Contributing Guide](https://github.com/imjlk/wp-typia/blob/main/CONTRIBUTING.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.16.10",
+  "version": "0.16.12",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -65,7 +65,7 @@
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.4",
-    "@wp-typia/project-tools": "0.16.9",
+    "@wp-typia/project-tools": "0.16.11",
     "better-result": "^2.7.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",

package/src/command-contract.ts

@@ -84,13 +84,24 @@ function isLongOptionValueConsumer(optionName: string): boolean {
 }
 
 function findFirstPositionalIndex(argv: string[]): number {
+	const positionalIndexes = collectPositionalIndexes(argv);
+	return positionalIndexes[0] ?? -1;
+}
+
+function collectPositionalIndexes(argv: string[]): number[] {
+	const positionalIndexes: number[] = [];
+
 	for (let index = 0; index < argv.length; index += 1) {
 		const arg = argv[index];
 		if (arg === "--") {
-			return index + 1 < argv.length ? index + 1 : -1;
+			for (let restIndex = index + 1; restIndex < argv.length; restIndex += 1) {
+				positionalIndexes.push(restIndex);
+			}
+			break;
 		}
 		if (!arg.startsWith("-") || arg === "-") {
-			return index;
+			positionalIndexes.push(index);
+			continue;
 		}
 		if (arg.startsWith("--")) {
 			if (arg.includes("=")) {
@@ -106,7 +117,7 @@ function findFirstPositionalIndex(argv: string[]): number {
 		}
 	}
 
-	return -1;
+	return positionalIndexes;
 }
 
 export const WP_TYPIA_FUTURE_COMMAND_TREE = [
@@ -213,7 +224,8 @@ function assertStringOptionValues(argv: string[]): void {
 }
 
 export function normalizeWpTypiaArgv(argv: string[]): string[] {
-	const firstPositionalIndex = findFirstPositionalIndex(argv);
+	const positionalIndexes = collectPositionalIndexes(argv);
+	const firstPositionalIndex = positionalIndexes[0] ?? -1;
 	if (firstPositionalIndex === -1) {
 		return argv;
 	}
@@ -234,6 +246,17 @@ export function normalizeWpTypiaArgv(argv: string[]): string[] {
 		return argv;
 	}
 
+	if (positionalIndexes.length > 1) {
+		const extraPositionals = positionalIndexes
+			.slice(1)
+			.map((index) => argv[index])
+			.filter((value): value is string => typeof value === "string" && value.length > 0);
+
+		throw new Error(
+			`The positional alias only accepts a single project directory. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for scaffold invocations with additional positional arguments, or check the command spelling if you meant another top-level command. Extra positional arguments: ${extraPositionals.map((value) => `\`${value}\``).join(", ")}.`,
+		);
+	}
+
 	const normalizedArgv = [
 		...argv.slice(0, firstPositionalIndex),
 		"create",