wp-typia 0.12.0 → 0.13.0

package/README.md

@@ -8,6 +8,8 @@ Use this package for new installs:
 - `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 add binding-source hero-data`
+- `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>`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -64,7 +64,7 @@
     "@bunli/runtime": "0.3.1",
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
-    "@wp-typia/project-tools": "0.12.0",
+    "@wp-typia/project-tools": "0.13.0",
     "better-result": "^2.7.0",
     "react": "19.2.0",
     "react-dom": "19.2.0",

package/src/command-contract.ts

@@ -27,9 +27,11 @@ export const WP_TYPIA_TOP_LEVEL_COMMAND_NAMES = [
 
 const STRING_OPTION_NAMES_BY_COMMAND = {
 	add: new Set([
+		"anchor",
 		"block",
 		"data-storage",
 		"persistence-policy",
+		"position",
 		"template",
 	]),
 	create: new Set([
@@ -109,7 +111,7 @@ export const WP_TYPIA_FUTURE_COMMAND_TREE = [
 	{
 		description: "Extend an official wp-typia workspace.",
 		name: "add",
-		subcommands: ["block", "variation", "pattern"],
+		subcommands: ["block", "variation", "pattern", "binding-source", "hooked-block"],
 	},
 	{
 		description: "Run migration workflows.",

package/src/commands/add.ts

@@ -21,6 +21,10 @@ function loadAddFlow() {
 }
 
 const addOptions = {
+	anchor: {
+		description: "Anchor block name for hooked-block workflows.",
+		schema: z.string().optional(),
+	},
 	block: {
 		description: "Target block slug for variation workflows.",
 		schema: z.string().optional(),
@@ -33,6 +37,10 @@ const addOptions = {
 		description: "Persistence write policy for persistence-capable templates.",
 		schema: z.string().optional(),
 	},
+	position: {
+		description: "Hook position for hooked-block workflows.",
+		schema: z.string().optional(),
+	},
 	template: {
 		description: "Built-in block family for the new block.",
 		schema: z.string().optional(),
@@ -40,7 +48,7 @@ const addOptions = {
 };
 
 export const addCommand = defineCommand({
-	description: "Extend an official wp-typia workspace with blocks, variations, or patterns.",
+	description: "Extend an official wp-typia workspace with blocks, variations, patterns, binding sources, or hooked blocks.",
 	handler: async (args) => {
 		await executeAddCommand({
 			cwd: args.cwd,
@@ -67,17 +75,21 @@ export const addCommand = defineCommand({
 								"data-storage":
 									(args.flags["data-storage"] as string | undefined) ??
 									config["data-storage"],
+								anchor: (args.flags.anchor as string | undefined) ?? "",
 								block: (args.flags.block as string | undefined) ?? "",
 								kind:
 									(args.positional[0] as
 										| "block"
 										| "variation"
 										| "pattern"
+										| "binding-source"
+										| "hooked-block"
 										| undefined) ?? "block",
 								name: args.positional[1] ?? "",
 								"persistence-policy":
 									(args.flags["persistence-policy"] as string | undefined) ??
 									config["persistence-policy"],
+								position: (args.flags.position as string | undefined) ?? "after",
 								template:
 									(args.flags.template as string | undefined) ?? config.template,
 							},

package/src/runtime-bridge.ts

@@ -11,7 +11,9 @@ import {
 	listTemplates,
 	parseMigrationArgs,
 	tryResolveWorkspaceProject,
+	runAddBindingSourceCommand,
 	runAddBlockCommand,
+	runAddHookedBlockCommand,
 	runAddPatternCommand,
 	runAddVariationCommand,
 	runDoctor,
@@ -259,8 +261,56 @@ export async function executeAddCommand({
 		return;
 	}
 
+	if (kind === "binding-source") {
+		if (!name) {
+			throw new Error(
+				"`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name>.",
+			);
+		}
+
+		const result = await runAddBindingSourceCommand({
+			bindingSourceName: name,
+			cwd,
+		});
+		console.log(`✅ Added binding source ${result.bindingSourceSlug} in ${result.projectDir}.`);
+		return;
+	}
+
+	if (kind === "hooked-block") {
+		if (!name) {
+			throw new Error(
+				"`wp-typia add hooked-block` requires <block-slug>. Usage: wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <before|after|firstChild|lastChild>.",
+			);
+		}
+
+		const anchorBlockName = readOptionalStringFlag(flags, "anchor");
+		if (!anchorBlockName) {
+			throw new Error("`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
+		}
+
+		const position = readOptionalStringFlag(flags, "position");
+		if (!position) {
+			throw new Error(
+				"`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.",
+			);
+		}
+
+		const result = await runAddHookedBlockCommand({
+			anchorBlockName,
+			blockName: name,
+			cwd,
+			position,
+		});
+		console.log(
+			`✅ Added blockHooks metadata for ${result.blockSlug} relative to ${result.anchorBlockName} (${result.position}) in ${result.projectDir}.`,
+		);
+		return;
+	}
+
 	if (kind !== "block") {
-		throw new Error(`Unknown add kind "${kind}". Expected one of: block, variation, pattern.`);
+		throw new Error(
+			`Unknown add kind "${kind}". Expected one of: block, variation, pattern, binding-source, hooked-block.`,
+		);
 	}
 
 	if (!name) {

package/src/ui/add-flow.tsx

@@ -2,16 +2,19 @@ import { useState } from "react";
 
 import { useRuntime } from "@bunli/runtime/app";
 import { Alert, SchemaForm } from "@bunli/tui";
+import { HOOKED_BLOCK_POSITION_IDS } from "@wp-typia/project-tools";
 import { z } from "zod";
 
 import { executeAddCommand } from "../runtime-bridge";
 
 const addFlowSchema = z.object({
+	anchor: z.string().optional(),
 	block: z.string().optional(),
 	"data-storage": z.string().optional(),
-	kind: z.enum(["block", "variation", "pattern"]).default("block"),
+	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(),
 });
 
@@ -27,6 +30,16 @@ type AddFlowProps = {
 	}>;
 };
 
+const HOOKED_BLOCK_POSITION_DESCRIPTIONS: Record<
+	(typeof HOOKED_BLOCK_POSITION_IDS)[number],
+	string
+> = {
+	after: "Insert after the anchor block",
+	before: "Insert before the anchor block",
+	firstChild: "Insert as the first child of the anchor block",
+	lastChild: "Insert as the last child of the anchor block",
+};
+
 export function AddFlow({ cwd, initialValues, workspaceBlockOptions }: AddFlowProps) {
 	const runtime = useRuntime();
 	const [errorMessage, setErrorMessage] = useState<string | null>(null);
@@ -54,6 +67,16 @@ export function AddFlow({ cwd, initialValues, workspaceBlockOptions }: AddFlowPr
 								description: "Add a PHP block pattern shell",
 								value: "pattern",
 							},
+							{
+								name: "binding-source",
+								description: "Add a shared block bindings source",
+								value: "binding-source",
+							},
+							{
+								name: "hooked-block",
+								description: "Add block.json hook metadata to an existing block",
+								value: "hooked-block",
+							},
 						],
 					},
 					{
@@ -105,6 +128,36 @@ export function AddFlow({ cwd, initialValues, workspaceBlockOptions }: AddFlowPr
 						name: "name",
 						visibleWhen: (values) => values.kind === "pattern",
 					},
+					{
+						kind: "text",
+						label: "Binding source name",
+						name: "name",
+						visibleWhen: (values) => values.kind === "binding-source",
+					},
+					{
+						kind: workspaceBlockOptions.length > 0 ? "select" : "text",
+						label: "Target block",
+						name: "name",
+						options: workspaceBlockOptions,
+						visibleWhen: (values) => values.kind === "hooked-block",
+					},
+					{
+						kind: "text",
+						label: "Anchor block name",
+						name: "anchor",
+						visibleWhen: (values) => values.kind === "hooked-block",
+					},
+					{
+						kind: "select",
+						label: "Hook position",
+						name: "position",
+						options: HOOKED_BLOCK_POSITION_IDS.map((position) => ({
+							name: position,
+							description: HOOKED_BLOCK_POSITION_DESCRIPTIONS[position],
+							value: position,
+						})),
+						visibleWhen: (values) => values.kind === "hooked-block",
+					},
 					{
 						kind: "select",
 						label: "Data storage",