@wp-typia/project-tools 0.11.1 → 0.13.0

package/dist/runtime/cli-add.d.ts

@@ -1,13 +1,34 @@
+import { getWorkspaceBlockSelectOptions } from "./workspace-inventory.js";
+import { type HookedBlockPositionId } from "./hooked-blocks.js";
 /**
  * Supported top-level `wp-typia add` kinds exposed by the canonical CLI.
  */
-export declare const ADD_KIND_IDS: readonly ["block", "variation", "pattern"];
+export declare const ADD_KIND_IDS: readonly ["block", "variation", "pattern", "binding-source", "hooked-block"];
 export type AddKindId = (typeof ADD_KIND_IDS)[number];
 /**
  * Supported built-in block families accepted by `wp-typia add block --template`.
  */
 export declare const ADD_BLOCK_TEMPLATE_IDS: readonly ["basic", "interactivity", "persistence", "compound"];
 export type AddBlockTemplateId = (typeof ADD_BLOCK_TEMPLATE_IDS)[number];
+interface RunAddVariationCommandOptions {
+    blockName: string;
+    cwd?: string;
+    variationName: string;
+}
+interface RunAddPatternCommandOptions {
+    cwd?: string;
+    patternName: string;
+}
+interface RunAddBindingSourceCommandOptions {
+    bindingSourceName: string;
+    cwd?: string;
+}
+interface RunAddHookedBlockCommandOptions {
+    anchorBlockName: string;
+    blockName: string;
+    cwd?: string;
+    position: string;
+}
 interface RunAddBlockCommandOptions {
     blockName: string;
     cwd?: string;
@@ -32,7 +53,82 @@ export declare function runAddBlockCommand({ blockName, cwd, dataStorageMode, pe
     templateId: AddBlockTemplateId;
 }>;
 /**
- * Returns the current placeholder guidance for unsupported `wp-typia add` kinds.
+ * Add one variation entry to an existing workspace block.
+ *
+ * @param options Command options for the variation scaffold workflow.
+ * @param options.blockName Target workspace block slug that will own the variation.
+ * @param options.cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @param options.variationName Human-entered variation name that will be normalized
+ * and validated before files are written.
+ * @returns A promise that resolves with the normalized `blockSlug`,
+ * `variationSlug`, and owning `projectDir` after the variation files and
+ * inventory entry have been written successfully.
+ * @throws {Error} When the command is run outside an official workspace, when
+ * the target block is unknown, when the variation slug is invalid, or when a
+ * conflicting file or inventory entry already exists.
+ */
+export declare function runAddVariationCommand({ blockName, cwd, variationName, }: RunAddVariationCommandOptions): Promise<{
+    blockSlug: string;
+    projectDir: string;
+    variationSlug: string;
+}>;
+/**
+ * Add one PHP block pattern shell to an official workspace project.
+ *
+ * @param options Command options for the pattern scaffold workflow.
+ * @param options.cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @param options.patternName Human-entered pattern name that will be normalized
+ * and validated before files are written.
+ * @returns A promise that resolves with the normalized `patternSlug` and
+ * owning `projectDir` after the pattern file and inventory entry have been
+ * written successfully.
+ * @throws {Error} When the command is run outside an official workspace, when
+ * the pattern slug is invalid, or when a conflicting file or inventory entry
+ * already exists.
+ */
+export declare function runAddPatternCommand({ cwd, patternName, }: RunAddPatternCommandOptions): Promise<{
+    patternSlug: string;
+    projectDir: string;
+}>;
+/**
+ * Add one block binding source scaffold to an official workspace project.
+ *
+ * @param options Command options for the binding-source scaffold workflow.
+ * @param options.bindingSourceName Human-entered binding source name that will
+ * be normalized and validated before files are written.
+ * @param options.cwd Working directory used to resolve the nearest official
+ * workspace. Defaults to `process.cwd()`.
+ * @returns A promise that resolves with the normalized `bindingSourceSlug` and
+ * owning `projectDir` after the server/editor files and inventory entry have
+ * been written successfully.
+ * @throws {Error} When the command is run outside an official workspace, when
+ * the slug is invalid, or when a conflicting file or inventory entry exists.
  */
-export declare function createAddPlaceholderMessage(kind: Exclude<AddKindId, "block">): string;
-export {};
+export declare function runAddBindingSourceCommand({ bindingSourceName, cwd, }: RunAddBindingSourceCommandOptions): Promise<{
+    bindingSourceSlug: string;
+    projectDir: string;
+}>;
+/**
+ * Add one `blockHooks` entry to an existing official workspace block.
+ *
+ * @param options Command options for the hooked-block workflow.
+ * @param options.anchorBlockName Full block name that will anchor the insertion.
+ * @param options.blockName Existing workspace block slug to patch.
+ * @param options.cwd Working directory used to resolve the nearest official workspace.
+ * Defaults to `process.cwd()`.
+ * @param options.position Hook position to store in `block.json`.
+ * @returns A promise that resolves with the normalized target block slug, anchor
+ * block name, position, and owning project directory after `block.json` is written.
+ * @throws {Error} When the command is run outside an official workspace, when
+ * the target block is unknown, when required flags are missing, or when the
+ * block already defines a hook for the requested anchor.
+ */
+export declare function runAddHookedBlockCommand({ anchorBlockName, blockName, cwd, position, }: RunAddHookedBlockCommandOptions): Promise<{
+    anchorBlockName: string;
+    blockSlug: string;
+    position: HookedBlockPositionId;
+    projectDir: string;
+}>;
+export { getWorkspaceBlockSelectOptions };