wp-typia 0.20.5 → 0.22.0

package/README.md

@@ -13,10 +13,15 @@ Use this package for new projects:
 Extend an existing workspace with:
 
 - `wp-typia add block counter-card --template basic`
+- `wp-typia add style callout-emphasis --block counter-card`
+- `wp-typia add transform quote-to-counter --from core/quote --to counter-card`
 - `wp-typia add binding-source hero-data`
+- `wp-typia add binding-source hero-data --block counter-card --attribute headline`
 - `wp-typia add rest-resource snapshots --namespace my-plugin/v1 --methods list,read,create`
 - `wp-typia add ability review-workflow`
 - `wp-typia add ai-feature brief-suggestions --namespace my-plugin/v1`
+- `wp-typia add editor-plugin review-workflow --slot sidebar`
+- `wp-typia add editor-plugin seo-notes --slot document-setting-panel`
 - `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

package/bin/argv-walker.d.ts

@@ -0,0 +1,19 @@
+export type ArgvWalkerMetadata = {
+  longValueOptions: Iterable<string>;
+  shortValueOptions: Iterable<string>;
+};
+
+export declare function collectPositionalIndexes(
+  argv: string[],
+  metadata: ArgvWalkerMetadata,
+): number[];
+
+export declare function findFirstPositionalIndex(
+  argv: string[],
+  metadata: ArgvWalkerMetadata,
+): number;
+
+export declare function findFirstPositional(
+  argv: string[],
+  metadata: ArgvWalkerMetadata,
+): string | undefined;

package/bin/argv-walker.js

@@ -0,0 +1,53 @@
+function normalizeOptionSet(values) {
+  return values instanceof Set ? values : new Set(values);
+}
+
+export function collectPositionalIndexes(argv, metadata) {
+  const longValueOptionSet = normalizeOptionSet(metadata.longValueOptions);
+  const shortValueOptionSet = normalizeOptionSet(metadata.shortValueOptions);
+  const positionalIndexes = [];
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--') {
+      for (let restIndex = index + 1; restIndex < argv.length; restIndex += 1) {
+        positionalIndexes.push(restIndex);
+      }
+      break;
+    }
+    if (!arg.startsWith('-') || arg === '-') {
+      positionalIndexes.push(index);
+      continue;
+    }
+    if (arg.startsWith('--')) {
+      if (arg.includes('=')) {
+        continue;
+      }
+      const next = argv[index + 1];
+      if (longValueOptionSet.has(arg) && next && !next.startsWith('-')) {
+        index += 1;
+      }
+      continue;
+    }
+    if (
+      arg.length === 2 &&
+      shortValueOptionSet.has(arg) &&
+      argv[index + 1] &&
+      !argv[index + 1].startsWith('-')
+    ) {
+      index += 1;
+    }
+  }
+
+  return positionalIndexes;
+}
+
+export function findFirstPositionalIndex(argv, metadata) {
+  const positionalIndexes = collectPositionalIndexes(argv, metadata);
+  return positionalIndexes[0] ?? -1;
+}
+
+export function findFirstPositional(argv, metadata) {
+  const firstPositionalIndex = findFirstPositionalIndex(argv, metadata);
+  return firstPositionalIndex === -1 ? undefined : argv[firstPositionalIndex];
+}

package/bin/routing-metadata.generated.d.ts

@@ -1,6 +1,8 @@
-// This file was automatically generated by `bun run generate`.
+// This file was automatically generated by `node scripts/generate-routing-metadata.mjs`.
 // Do not edit directly.
 
 export declare const fullRuntimeCommands: readonly string[];
+export declare const interactiveRuntimeCommands: readonly string[];
 export declare const longValueOptions: readonly string[];
+export declare const reservedCommands: readonly string[];
 export declare const shortValueOptions: readonly string[];

package/bin/routing-metadata.generated.js

@@ -1,44 +1,64 @@
-// This file was automatically generated by `bun run generate`.
+// This file was automatically generated by `node scripts/generate-routing-metadata.mjs`.
 // Do not edit directly.
 
 export const fullRuntimeCommands = Object.freeze([
-  "mcp",
-  "skills",
-  "completions",
-  "complete"
+  'mcp',
+  'skills',
+  'completions',
+  'complete',
+]);
+export const interactiveRuntimeCommands = Object.freeze([
+  'create',
+  'add',
+  'migrate',
 ]);
 export const longValueOptions = Object.freeze([
-  "--alternate-render-targets",
-  "--anchor",
-  "--block",
-  "--config",
-  "--current-migration-version",
-  "--data-storage",
-  "--external-layer-id",
-  "--external-layer-source",
-  "--format",
-  "--from-migration-version",
-  "--id",
-  "--inner-blocks-preset",
-  "--iterations",
-  "--methods",
-  "--migration-version",
-  "--namespace",
-  "--output-dir",
-  "--package-manager",
-  "--persistence-policy",
-  "--php-prefix",
-  "--position",
-  "--query-post-type",
-  "--seed",
-  "--slot",
-  "--template",
-  "--text-domain",
-  "--to-migration-version",
-  "--variant"
+  '--alternate-render-targets',
+  '--anchor',
+  '--attribute',
+  '--block',
+  '--config',
+  '--current-migration-version',
+  '--data-storage',
+  '--external-layer-id',
+  '--external-layer-source',
+  '--format',
+  '--from',
+  '--from-migration-version',
+  '--id',
+  '--inner-blocks-preset',
+  '--iterations',
+  '--methods',
+  '--migration-version',
+  '--namespace',
+  '--output-dir',
+  '--package-manager',
+  '--persistence-policy',
+  '--php-prefix',
+  '--position',
+  '--query-post-type',
+  '--seed',
+  '--slot',
+  '--source',
+  '--template',
+  '--text-domain',
+  '--to',
+  '--to-migration-version',
+  '--variant',
 ]);
-export const shortValueOptions = Object.freeze([
-  "-c",
-  "-p",
-  "-t"
+export const reservedCommands = Object.freeze([
+  'create',
+  'init',
+  'sync',
+  'add',
+  'migrate',
+  'templates',
+  'doctor',
+  'mcp',
+  'help',
+  'version',
+  'skills',
+  'completions',
+  'complete',
 ]);
+export const shortValueOptions = Object.freeze(['-c', '-p', '-t']);

package/bin/runtime-routing.d.ts

@@ -0,0 +1,34 @@
+type RuntimeRoutingValues = readonly string[] | ReadonlySet<string>;
+
+type RuntimeRoutingMetadata = {
+  longValueOptions: RuntimeRoutingValues;
+  reservedCommands: RuntimeRoutingValues;
+  shortValueOptions: RuntimeRoutingValues;
+};
+
+type RuntimeRoutingStream = {
+  isTTY?: boolean;
+};
+
+export declare function getRuntimeRoutingInvocation(
+  argv: readonly string[],
+  metadata: RuntimeRoutingMetadata,
+): {
+  command: string | undefined;
+  isSinglePositionalAlias: boolean;
+  positionals: string[];
+};
+
+export declare function shouldRouteToFullRuntime(options: {
+  argv: readonly string[];
+  fullRuntimeCommands: RuntimeRoutingValues;
+  hasBuiltRuntime: boolean;
+  hasWorkingBun: boolean;
+  interactiveRuntimeCommands: RuntimeRoutingValues;
+  longValueOptions: RuntimeRoutingValues;
+  reservedCommands: RuntimeRoutingValues;
+  shortValueOptions: RuntimeRoutingValues;
+  stdin?: RuntimeRoutingStream;
+  stdout?: RuntimeRoutingStream;
+  term?: string;
+}): boolean;

package/bin/runtime-routing.js

@@ -0,0 +1,124 @@
+import { collectPositionalIndexes } from './argv-walker.js';
+
+function normalizeSet(values) {
+  return values instanceof Set ? values : new Set(values);
+}
+
+function hasBooleanFlagBeforeTerminator(argv, longFlag, shortFlag) {
+  let matched = false;
+  for (const arg of argv) {
+    if (arg === '--') {
+      break;
+    }
+    if (arg === longFlag || (shortFlag && arg === shortFlag)) {
+      matched = true;
+      continue;
+    }
+    if (arg.startsWith(`${longFlag}=`)) {
+      const value = arg.slice(longFlag.length + 1).toLowerCase();
+      matched = value !== 'false' && value !== '0' && value !== 'no';
+    }
+  }
+
+  return matched;
+}
+
+function hasLongOptionBeforeTerminator(argv, optionName) {
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--') {
+      return false;
+    }
+    if (arg === optionName || arg.startsWith(`${optionName}=`)) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+function isInteractiveTerminal({ stdin, stdout, term }) {
+  return Boolean(stdin?.isTTY) && Boolean(stdout?.isTTY) && term !== 'dumb';
+}
+
+export function getRuntimeRoutingInvocation(argv, metadata) {
+  const positionalIndexes = collectPositionalIndexes(argv, metadata);
+  const positionals = positionalIndexes
+    .map((index) => argv[index])
+    .filter((value) => typeof value === 'string' && value.length > 0);
+  const command = positionals[0];
+  const reservedCommandSet = normalizeSet(metadata.reservedCommands);
+  const isSinglePositionalAlias =
+    Boolean(command) &&
+    positionals.length === 1 &&
+    !reservedCommandSet.has(command);
+
+  return {
+    command,
+    isSinglePositionalAlias,
+    positionals,
+  };
+}
+
+export function shouldRouteToFullRuntime({
+  argv,
+  fullRuntimeCommands,
+  hasBuiltRuntime,
+  hasWorkingBun,
+  interactiveRuntimeCommands,
+  longValueOptions,
+  reservedCommands,
+  shortValueOptions,
+  stdin = process.stdin,
+  stdout = process.stdout,
+  term = process.env.TERM,
+}) {
+  if (!hasWorkingBun || !hasBuiltRuntime) {
+    return false;
+  }
+
+  const fullRuntimeCommandSet = normalizeSet(fullRuntimeCommands);
+  const interactiveRuntimeCommandSet = normalizeSet(interactiveRuntimeCommands);
+  const invocation = getRuntimeRoutingInvocation(argv, {
+    longValueOptions,
+    reservedCommands,
+    shortValueOptions,
+  });
+
+  if (invocation.command && fullRuntimeCommandSet.has(invocation.command)) {
+    return true;
+  }
+
+  if (
+    !isInteractiveTerminal({
+      stdin,
+      stdout,
+      term,
+    })
+  ) {
+    return false;
+  }
+
+  if (
+    invocation.command === 'help' ||
+    invocation.command === 'version' ||
+    hasBooleanFlagBeforeTerminator(argv, '--help', '-h') ||
+    hasBooleanFlagBeforeTerminator(argv, '--version', '-v') ||
+    hasLongOptionBeforeTerminator(argv, '--format') ||
+    hasBooleanFlagBeforeTerminator(argv, '--yes', '-y')
+  ) {
+    return false;
+  }
+
+  if (
+    invocation.command &&
+    interactiveRuntimeCommandSet.has(invocation.command)
+  ) {
+    return true;
+  }
+
+  return (
+    invocation.isSinglePositionalAlias &&
+    interactiveRuntimeCommandSet.has('create')
+  );
+}

package/bin/wp-typia.js

@@ -1,125 +1,132 @@
 #!/usr/bin/env node
 
-import fs from "node:fs";
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import fs from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 import {
-	fullRuntimeCommands,
-	longValueOptions,
-	shortValueOptions,
-} from "./routing-metadata.generated.js";
-
-const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const cliEntrypoint = path.join(packageRoot, "dist-bunli", "cli.js");
-const nodeCliEntrypoint = path.join(packageRoot, "dist-bunli", "node-cli.js");
-const bunBinary = process.env.BUN_BIN || "bun";
+  fullRuntimeCommands,
+  interactiveRuntimeCommands,
+  longValueOptions,
+  reservedCommands,
+  shortValueOptions,
+} from './routing-metadata.generated.js';
+import {
+  getRuntimeRoutingInvocation,
+  shouldRouteToFullRuntime,
+} from './runtime-routing.js';
+
+const packageRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..',
+);
+const cliEntrypoint = path.join(packageRoot, 'dist-bunli', 'cli.js');
+const nodeCliEntrypoint = path.join(packageRoot, 'dist-bunli', 'node-cli.js');
+const bunBinary = process.env.BUN_BIN || 'bun';
 const fullRuntimeCommandSet = new Set(fullRuntimeCommands);
+const interactiveRuntimeCommandSet = new Set(interactiveRuntimeCommands);
 const longValueOptionSet = new Set(longValueOptions);
+const reservedCommandSet = new Set(reservedCommands);
 const shortValueOptionSet = new Set(shortValueOptions);
-const buildScriptEntrypoint = path.join(packageRoot, "scripts", "build-bunli-runtime.ts");
-const sourceCliEntrypoint = path.join(packageRoot, "src", "cli.ts");
+const buildScriptEntrypoint = path.join(
+  packageRoot,
+  'scripts',
+  'build-bunli-runtime.ts',
+);
+const sourceCliEntrypoint = path.join(packageRoot, 'src', 'cli.ts');
 const standaloneGuidance =
-	"Prefer not to install Bun? Use the standalone wp-typia binary from the GitHub release assets.";
-
-function firstPositional(argv) {
-	for (let index = 0; index < argv.length; index += 1) {
-		const arg = argv[index];
-		if (!arg || arg === "--") {
-			break;
-		}
-		if (shortValueOptionSet.has(arg) || longValueOptionSet.has(arg)) {
-			index += 1;
-			continue;
-		}
-		if (arg.startsWith("--")) {
-			const separatorIndex = arg.indexOf("=");
-			if (
-				separatorIndex > 0 &&
-				longValueOptionSet.has(arg.slice(0, separatorIndex))
-			) {
-				continue;
-			}
-		}
-		if (arg.startsWith("-") && arg !== "-") {
-			continue;
-		}
-		return arg;
-	}
-	return undefined;
-}
+  'Prefer not to install Bun? Use the standalone wp-typia binary from the GitHub release assets.';
 
 function isWorkingBunBinary() {
-	const bunCheck = spawnSync(bunBinary, ["--version"], {
-		env: process.env,
-		stdio: "ignore",
-	});
+  const bunCheck = spawnSync(bunBinary, ['--version'], {
+    env: process.env,
+    stdio: 'ignore',
+  });
 
-	return !bunCheck.error && bunCheck.status === 0;
+  return !bunCheck.error && bunCheck.status === 0;
 }
 
 function canAutobuildSourceCheckout() {
-	return fs.existsSync(buildScriptEntrypoint) && fs.existsSync(sourceCliEntrypoint);
+  return (
+    fs.existsSync(buildScriptEntrypoint) && fs.existsSync(sourceCliEntrypoint)
+  );
 }
 
 function ensureBuiltRuntime() {
-	if (fs.existsSync(cliEntrypoint) && fs.existsSync(nodeCliEntrypoint)) {
-		return true;
-	}
+  if (fs.existsSync(cliEntrypoint) && fs.existsSync(nodeCliEntrypoint)) {
+    return true;
+  }
 
-	if (!canAutobuildSourceCheckout() || !isWorkingBunBinary()) {
-		return false;
-	}
+  if (!canAutobuildSourceCheckout() || !isWorkingBunBinary()) {
+    return false;
+  }
 
-	const buildResult = spawnSync(bunBinary, ["run", "build"], {
-		cwd: packageRoot,
-		env: process.env,
-		stdio: "inherit",
-	});
+  const buildResult = spawnSync(bunBinary, ['run', 'build'], {
+    cwd: packageRoot,
+    env: process.env,
+    stdio: 'inherit',
+  });
 
-	if (buildResult.status !== 0) {
-		process.exit(buildResult.status ?? 1);
-	}
+  if (buildResult.status !== 0) {
+    process.exit(buildResult.status ?? 1);
+  }
 
-	return fs.existsSync(cliEntrypoint) && fs.existsSync(nodeCliEntrypoint);
+  return fs.existsSync(cliEntrypoint) && fs.existsSync(nodeCliEntrypoint);
 }
 
 const argv = process.argv.slice(2);
-const command = firstPositional(argv);
-const shouldUseFullRuntime = command ? fullRuntimeCommandSet.has(command) : false;
+const { command } = getRuntimeRoutingInvocation(argv, {
+  longValueOptions: longValueOptionSet,
+  reservedCommands: reservedCommandSet,
+  shortValueOptions: shortValueOptionSet,
+});
+const commandRequiresFullRuntime = command
+  ? fullRuntimeCommandSet.has(command)
+  : false;
 const hasBuiltRuntime = ensureBuiltRuntime();
 const hasWorkingBun = isWorkingBunBinary();
-
-// Keep common help on the human-readable Node fallback even when Bun is present.
+const shouldUseFullRuntime = shouldRouteToFullRuntime({
+  argv,
+  fullRuntimeCommands: fullRuntimeCommandSet,
+  hasBuiltRuntime,
+  hasWorkingBun,
+  interactiveRuntimeCommands: interactiveRuntimeCommandSet,
+  longValueOptions: longValueOptionSet,
+  reservedCommands: reservedCommandSet,
+  shortValueOptions: shortValueOptionSet,
+});
+
+// Keep common help and explicit non-TUI calls on the human-readable Node fallback
+// even when Bun is present.
 if (hasWorkingBun && hasBuiltRuntime && shouldUseFullRuntime) {
-	const result = spawnSync(bunBinary, [cliEntrypoint, ...argv], {
-		cwd: process.cwd(),
-		env: process.env,
-		stdio: "inherit",
-	});
-	process.exit(result.status ?? 1);
+  const result = spawnSync(bunBinary, [cliEntrypoint, ...argv], {
+    cwd: process.cwd(),
+    env: process.env,
+    stdio: 'inherit',
+  });
+  process.exit(result.status ?? 1);
 }
 
-if (shouldUseFullRuntime) {
-	if (!hasBuiltRuntime) {
-		console.error(
-			"Error: wp-typia could not locate its built CLI runtime. Reinstall the published package, or run `bun run build` when using a source checkout.",
-		);
-		process.exit(1);
-	}
-
-	console.error(
-		`Error: wp-typia ${command} requires Bun. Install Bun locally, run with bunx, or set BUN_BIN to a working Bun executable. ${standaloneGuidance}`,
-	);
-	process.exit(1);
+if (commandRequiresFullRuntime) {
+  if (!hasBuiltRuntime) {
+    console.error(
+      'Error: wp-typia could not locate its built CLI runtime. Reinstall the published package, or run `bun run build` when using a source checkout.',
+    );
+    process.exit(1);
+  }
+
+  console.error(
+    `Error: wp-typia ${command} requires Bun. Install Bun locally, run with bunx, or set BUN_BIN to a working Bun executable. ${standaloneGuidance}`,
+  );
+  process.exit(1);
 }
 
 if (!hasBuiltRuntime || !fs.existsSync(nodeCliEntrypoint)) {
-	console.error(
-		"Error: wp-typia could not locate its Node fallback runtime. Reinstall the published package, or run `bun run build` when using a source checkout.",
-	);
-	process.exit(1);
+  console.error(
+    'Error: wp-typia could not locate its Node fallback runtime. Reinstall the published package, or run `bun run build` when using a source checkout.',
+  );
+  process.exit(1);
 }
 
 const cliModule = await import(pathToFileURL(nodeCliEntrypoint).href);