@wp-typia/project-tools 0.24.4 → 0.24.5

package/dist/runtime/cli-add-filesystem.js

@@ -1,64 +1 @@
-import { promises as fsp } from "node:fs";
-import path from "node:path";
-import { readOptionalUtf8File } from "./fs-async.js";
-/**
- * Resolve the primary PHP bootstrap file for an official workspace.
- *
- * @param workspace Workspace metadata that provides `packageName` and `projectDir`.
- * @returns Absolute path to `<packageBase>.php` in the workspace root.
- */
-export function getWorkspaceBootstrapPath(workspace) {
-    const workspaceBaseName = workspace.packageName.split("/").pop() ?? workspace.packageName;
-    return path.join(workspace.projectDir, `${workspaceBaseName}.php`);
-}
-/**
- * Apply a text transform to an existing file only when the contents change.
- */
-export async function patchFile(filePath, transform) {
-    const currentSource = await fsp.readFile(filePath, "utf8");
-    const nextSource = transform(currentSource);
-    if (nextSource !== currentSource) {
-        await fsp.writeFile(filePath, nextSource, "utf8");
-    }
-}
-/**
- * Read a file when it exists and otherwise return `null`.
- */
-export async function readOptionalFile(filePath) {
-    return readOptionalUtf8File(filePath);
-}
-/**
- * Restore a file to its captured source, deleting it when the snapshot was `null`.
- */
-export async function restoreOptionalFile(filePath, source) {
-    if (source === null) {
-        await fsp.rm(filePath, { force: true });
-        return;
-    }
-    await fsp.mkdir(path.dirname(filePath), { recursive: true });
-    await fsp.writeFile(filePath, source, "utf8");
-}
-/**
- * Capture the current contents of a set of workspace files for rollback.
- */
-export async function snapshotWorkspaceFiles(filePaths) {
-    const uniquePaths = Array.from(new Set(filePaths));
-    return Promise.all(uniquePaths.map(async (filePath) => ({
-        filePath,
-        source: await readOptionalFile(filePath),
-    })));
-}
-/**
- * Undo a partially applied workspace mutation from a captured snapshot.
- */
-export async function rollbackWorkspaceMutation(snapshot) {
-    for (const targetPath of snapshot.targetPaths) {
-        await fsp.rm(targetPath, { force: true, recursive: true });
-    }
-    for (const snapshotDir of snapshot.snapshotDirs) {
-        await fsp.rm(snapshotDir, { force: true, recursive: true });
-    }
-    for (const { filePath, source } of snapshot.fileSources) {
-        await restoreOptionalFile(filePath, source);
-    }
-}
+export * from "./add/cli-add-filesystem.js";

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

@@ -1,4 +1 @@
-/**
- * Returns help text for the canonical `wp-typia add` subcommands.
- */
-export declare function formatAddHelpText(): string;
+export * from "./add/cli-add-help.js";

package/dist/runtime/cli-add-help.js

@@ -1,55 +1 @@
-import { HOOKED_BLOCK_POSITION_IDS, } from "./hooked-blocks.js";
-import { ADD_BLOCK_TEMPLATE_IDS, EDITOR_PLUGIN_SLOT_IDS, REST_RESOURCE_METHOD_IDS, } from "./cli-add-types.js";
-import { WORKSPACE_TEMPLATE_PACKAGE, } from "./workspace-project.js";
-/**
- * Returns help text for the canonical `wp-typia add` subcommands.
- */
-export function formatAddHelpText() {
-    return `Usage:
-  wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>] [--dry-run]
-  wp-typia add block <name> [--template <${ADD_BLOCK_TEMPLATE_IDS.join("|")}>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--dry-run]
-  wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>] [--dry-run]
-  wp-typia add core-variation <block-name> <name> [--dry-run]
-  wp-typia add core-variation <name> --block <namespace/block> [--dry-run]
-	wp-typia add variation <name> --block <block-slug> [--dry-run]
-	wp-typia add style <name> --block <block-slug> [--dry-run]
-	wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug> [--dry-run]
-  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--catalog-title <title>] [--tags <tag,...>] [--tag <tag>...] [--thumbnail-url <url>] [--dry-run]
-  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]] [--dry-run]
-  wp-typia add contract <name> [--type <ExportedTypeName>] [--dry-run]
-  wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <${REST_RESOURCE_METHOD_IDS.join(",")}>] [--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--dry-run]
-  wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>] [--dry-run]
-  wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>] [--hide-from-rest] [--dry-run]
-  wp-typia add ability <name> [--dry-run]
-  wp-typia add ai-feature <name> [--namespace <vendor/v1>] [--dry-run]
-  wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <${HOOKED_BLOCK_POSITION_IDS.join("|")}> [--dry-run]
-  wp-typia add editor-plugin <name> [--slot <${EDITOR_PLUGIN_SLOT_IDS.join("|")}>] [--dry-run]
-
-Notes:
-  \`wp-typia add\` runs only inside official ${WORKSPACE_TEMPLATE_PACKAGE} workspaces scaffolded via \`wp-typia create <project-dir> --template workspace\`.
-  Pass \`--dry-run\` to preview the workspace files that would change without writing them.
-  Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
-  \`add core-variation\` registers editor-side variations for existing core or external blocks without generating block.json or Typia manifests.
-  Unknown \`core/*\` core-variation targets warn instead of failing so newer WordPress core blocks remain scaffoldable; third-party namespaces are allowed without local discovery.
-  \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
-  Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
-  Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
-  Generated admin-view workspaces add \`@wp-typia/dataviews\` and the needed WordPress DataViews packages as opt-in dependencies.
-  \`add integration-env\` generates an opt-in local smoke starter under \`scripts/integration-smoke/\`, updates \`.env.example\`, and can add \`@wordpress/env\` plus \`.wp-env.json\` when \`--wp-env\` is passed.
-  Pass \`--release-zip\` to add \`release:zip\`, \`release:zip:check\`, and \`qa:check\` scripts for plugin QA packaging.
-  Pass \`--service docker-compose\` to include a placeholder local service stack that can be adapted to project-specific dependencies.
-  \`query-loop\` is a create-time scaffold family. Use \`wp-typia create <project-dir> --template query-loop\` instead of \`wp-typia add block\`.
-  \`add variation\` targets an existing block slug from \`scripts/block-config.ts\`.
-  \`add style\` registers a Block Styles option for an existing generated block.
-  \`add transform\` adds a block-to-block transform into an existing generated block.
-  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\` and records typed catalog metadata in \`PATTERNS\`; pass \`--catalog-title "Hero Photo"\` to override the generated catalog title, pass \`--tags hero,landing\` for a comma-separated tag list, and repeat \`--tag hero --tag landing\` for single tag values.
-  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare an end-to-end bindable attribute on an existing generated block. Pass \`--from-post-meta\` or \`--post-meta\` to generate a source backed by a typed post-meta contract; \`--meta-path\` selects one top-level field as the default binding arg.
-  \`add contract\` registers a standalone TypeScript wire contract under \`src/contracts/\` and generates a stable JSON Schema artifact without creating PHP route glue.
-  \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`. Use \`--route-pattern\`, \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` when an existing WordPress controller or permission model needs to own part of the generated route surface.
-  Pass \`--manual\` with \`add rest-resource\` to track an external/provider REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files. Manual routes may still declare \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` as metadata for the route owner. Settings contracts can add \`--secret-field\` with \`--secret-preserve-on-empty\` metadata so generated schemas, clients, and admin forms treat blank secret submissions as preserve-by-default.
-  \`add post-meta\` scaffolds a typed post meta contract under \`src/post-meta/\`, generates a schema artifact, and wires \`register_post_meta()\` helpers under \`inc/post-meta/\`.
-  \`add ability\` scaffolds typed workflow abilities under \`src/abilities/\` and server registration under \`inc/abilities/\`.
-  \`add ai-feature\` scaffolds server-owned AI feature endpoints under \`src/ai-features/\` and PHP route glue under \`inc/ai-features/\`.
-  \`add hooked-block\` patches an existing workspace block's \`block.json\` \`blockHooks\` metadata.
-  \`add editor-plugin\` scaffolds a document-level editor extension under \`src/editor-plugins/\`; legacy aliases \`PluginSidebar\` and \`PluginDocumentSettingPanel\` resolve to \`sidebar\` and \`document-setting-panel\`.`;
-}
+export * from "./add/cli-add-help.js";

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

@@ -1,11 +1 @@
-/**
- * Canonical top-level `wp-typia add` kind ids shared by the CLI command
- * registry, routing metadata generation, and project-tools runtime helpers.
- *
- * Keep this order stable because it drives help output and command metadata.
- */
-export declare const ADD_KIND_IDS: readonly ["admin-view", "block", "integration-env", "core-variation", "variation", "style", "transform", "pattern", "binding-source", "contract", "rest-resource", "post-meta", "ability", "ai-feature", "hooked-block", "editor-plugin"];
-/**
- * Union of supported top-level `wp-typia add` kind ids.
- */
-export type AddKindId = (typeof ADD_KIND_IDS)[number];
+export * from "./add/cli-add-kind-ids.js";

package/dist/runtime/cli-add-kind-ids.js

@@ -1,24 +1 @@
-/**
- * Canonical top-level `wp-typia add` kind ids shared by the CLI command
- * registry, routing metadata generation, and project-tools runtime helpers.
- *
- * Keep this order stable because it drives help output and command metadata.
- */
-export const ADD_KIND_IDS = [
-    "admin-view",
-    "block",
-    "integration-env",
-    "core-variation",
-    "variation",
-    "style",
-    "transform",
-    "pattern",
-    "binding-source",
-    "contract",
-    "rest-resource",
-    "post-meta",
-    "ability",
-    "ai-feature",
-    "hooked-block",
-    "editor-plugin",
-];
+export * from "./add/cli-add-kind-ids.js";

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

@@ -1,7 +1 @@
-export { normalizeBlockSlug, } from "./scaffold-identifiers.js";
-export * from "./cli-add-types.js";
-export * from "./cli-add-validation.js";
-export * from "./cli-add-filesystem.js";
-export * from "./cli-add-block-json.js";
-export * from "./cli-add-collision.js";
-export * from "./cli-add-help.js";
+export * from "./add/cli-add-shared.js";

package/dist/runtime/cli-add-shared.js

@@ -1,7 +1 @@
-export { normalizeBlockSlug, } from "./scaffold-identifiers.js";
-export * from "./cli-add-types.js";
-export * from "./cli-add-validation.js";
-export * from "./cli-add-filesystem.js";
-export * from "./cli-add-block-json.js";
-export * from "./cli-add-collision.js";
-export * from "./cli-add-help.js";
+export * from "./add/cli-add-shared.js";

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

@@ -1,409 +1 @@
-import { PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, type PatternCatalogScope } from "./pattern-catalog.js";
-import type { FullBlockNameDiagnostics } from "./block-targets.js";
-export { ADD_KIND_IDS } from "./cli-add-kind-ids.js";
-export type { AddKindId } from "./cli-add-kind-ids.js";
-export { PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, };
-export type { PatternCatalogScope };
-/**
- * Supported plugin-level REST resource methods accepted by
- * `wp-typia add rest-resource --methods`.
- */
-export declare const REST_RESOURCE_METHOD_IDS: readonly ["list", "read", "create", "update", "delete"];
-/**
- * Union of supported plugin-level REST resource method ids.
- */
-export type RestResourceMethodId = (typeof REST_RESOURCE_METHOD_IDS)[number];
-/**
- * Supported HTTP methods accepted by manual REST contract mode.
- */
-export declare const MANUAL_REST_CONTRACT_HTTP_METHOD_IDS: readonly ["DELETE", "GET", "PATCH", "POST", "PUT"];
-/**
- * Union of supported manual REST contract HTTP methods.
- */
-export type ManualRestContractHttpMethodId = (typeof MANUAL_REST_CONTRACT_HTTP_METHOD_IDS)[number];
-/**
- * Supported auth intent values accepted by manual REST contract mode.
- */
-export declare const MANUAL_REST_CONTRACT_AUTH_IDS: readonly ["authenticated", "public", "public-write-protected"];
-/**
- * Union of supported manual REST contract auth intents.
- */
-export type ManualRestContractAuthId = (typeof MANUAL_REST_CONTRACT_AUTH_IDS)[number];
-/**
- * Canonical editor-plugin shell surface ids accepted by
- * `wp-typia add editor-plugin --slot`.
- */
-export declare const EDITOR_PLUGIN_SLOT_IDS: readonly ["sidebar", "document-setting-panel"];
-/**
- * Union of canonical editor-plugin shell surface ids.
- */
-export type EditorPluginSlotId = (typeof EDITOR_PLUGIN_SLOT_IDS)[number];
-/**
- * Legacy and canonical editor-plugin slot aliases keyed by user-facing input.
- */
-export declare const EDITOR_PLUGIN_SLOT_ALIASES: {
-    readonly PluginDocumentSettingPanel: "document-setting-panel";
-    readonly PluginSidebar: "sidebar";
-    readonly "document-setting-panel": "document-setting-panel";
-    readonly sidebar: "sidebar";
-};
-/**
- * Resolve a user-provided editor-plugin slot alias to its canonical id.
- *
- * @param slot Raw slot value from CLI input.
- * @returns The canonical slot id, or `undefined` when unsupported.
- */
-export declare function resolveEditorPluginSlotAlias(slot: string): EditorPluginSlotId | undefined;
-/**
- * Optional local service starter ids accepted by
- * `wp-typia add integration-env --service`.
- */
-export declare const INTEGRATION_ENV_SERVICE_IDS: readonly ["none", "docker-compose"];
-/**
- * Union of supported local service starter ids.
- */
-export type IntegrationEnvServiceId = (typeof INTEGRATION_ENV_SERVICE_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"];
-/**
- * Union of supported built-in block template ids.
- */
-export type AddBlockTemplateId = (typeof ADD_BLOCK_TEMPLATE_IDS)[number];
-/**
- * Suggest the closest supported add-block template id for typo diagnostics.
- *
- * @param templateId Raw `wp-typia add block --template` value.
- * @returns The closest supported template id when it is within the shared
- * close-id threshold, otherwise `null`.
- */
-export declare function suggestAddBlockTemplateId(templateId: string): AddBlockTemplateId | null;
-/**
- * Options for `wp-typia add variation`.
- *
- * @property blockName Existing workspace block slug that owns the variation.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property variationName Human-entered variation name normalized into a slug.
- */
-export interface RunAddVariationCommandOptions {
-    blockName: string;
-    cwd?: string;
-    variationName: string;
-}
-/**
- * Options for `wp-typia add core-variation`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property targetBlockName Full `namespace/block` name that receives the variation.
- * @property targetBlockNameDiagnostics Optional diagnostics for positional target
- * block names. Omitted callers keep legacy target diagnostics.
- * @property variationName Human-entered variation name normalized into a slug.
- */
-export interface RunAddCoreVariationCommandOptions {
-    cwd?: string;
-    targetBlockName: string;
-    targetBlockNameDiagnostics?: string | FullBlockNameDiagnostics;
-    variationName: string;
-}
-/**
- * Options for `wp-typia add style`.
- *
- * @property blockName Existing workspace block slug that owns the style.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @property styleName Human-entered style name that will be normalized into the
- * generated style slug.
- */
-export interface RunAddBlockStyleCommandOptions {
-    blockName: string;
-    cwd?: string;
-    styleName: string;
-}
-/**
- * Options for `wp-typia add transform`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @property fromBlockName Full `namespace/block` source block name accepted by
- * WordPress block transform definitions.
- * @property toBlockName Existing workspace block slug or full block name that
- * owns the generated transform.
- * @property transformName Human-entered transform name that will be normalized
- * into the generated transform slug.
- */
-export interface RunAddBlockTransformCommandOptions {
-    cwd?: string;
-    fromBlockName: string;
-    toBlockName: string;
-    transformName: string;
-}
-/**
- * Options for `wp-typia add pattern`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property patternName Human-entered pattern name normalized into a slug.
- */
-export interface RunAddPatternCommandOptions {
-    catalogTitle?: string;
-    contentFile?: string;
-    cwd?: string;
-    patternName: string;
-    patternScope?: PatternCatalogScope | string;
-    sectionRole?: string;
-    tags?: readonly string[] | string;
-    thumbnailUrl?: string;
-}
-/**
- * Options for `wp-typia add binding-source`.
- *
- * @property attributeName Optional block attribute to bind when `blockName` is provided.
- * @property blockName Optional existing workspace block slug or full block name.
- * @property bindingSourceName Human-entered binding source name normalized into a slug.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property metaPath Optional top-level post-meta field used as the default
- * source argument when `postMetaName` is provided.
- * @property postMetaName Optional generated post-meta contract slug used to
- * back the binding source with `get_post_meta()`.
- */
-export interface RunAddBindingSourceCommandOptions {
-    attributeName?: string;
-    blockName?: string;
-    bindingSourceName: string;
-    cwd?: string;
-    metaPath?: string;
-    postMetaName?: string;
-}
-/**
- * Options for `wp-typia add contract`.
- *
- * @property contractName Human-entered contract name normalized into a stable slug.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property typeName Optional exported TypeScript type or interface name. Defaults
- * to the PascalCase version of `contractName`.
- */
-export interface RunAddContractCommandOptions {
-    contractName: string;
-    cwd?: string;
-    typeName?: string;
-}
-/**
- * Options for `wp-typia add post-meta`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property hideFromRest Whether to keep the generated meta key out of REST and
- * editor responses. Defaults to REST/editor exposure being enabled.
- * @property metaKey Optional WordPress meta key. Defaults to
- * `_<phpPrefix>_<postMetaName>`.
- * @property postMetaName Human-entered post-meta contract name normalized into
- * a stable slug.
- * @property postType WordPress post type key, 20 characters or fewer, that owns
- * the generated meta key.
- * @property typeName Optional exported TypeScript type or interface name.
- * Defaults to `<PascalName>Meta`.
- */
-export interface RunAddPostMetaCommandOptions {
-    cwd?: string;
-    hideFromRest?: boolean;
-    metaKey?: string;
-    postMetaName: string;
-    postType: string;
-    typeName?: string;
-}
-/**
- * Options for `wp-typia add rest-resource`.
- *
- * Passing `manual: true` records a type-only external REST route contract. In
- * manual mode wp-typia still owns TypeScript contracts, validators, OpenAPI,
- * generated clients, and drift checks, but it does not create PHP route glue.
- *
- * @property auth Optional auth intent for manual mode. Defaults to public.
- * @property bodyTypeName Optional exported TypeScript body type for manual
- * mode. Defaults to `<PascalName>Request` for write methods.
- * @property controllerClass Optional REST controller class reference. Generated
- * routes delegate through it; manual/provider routes record it as owner metadata.
- * @property controllerExtends Optional base class for the generated controller
- * wrapper or declared manual/provider controller owner.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property manual Whether to scaffold a type-only external REST contract.
- * @property method HTTP method for manual REST contract mode. Defaults to GET.
- * @property methods Optional comma-separated REST method list.
- * @property namespace Optional REST namespace, defaulting to the workspace namespace.
- * @property permissionCallback Optional PHP callback used for generated REST
- * route permission checks or declared manual/provider route ownership.
- * @property pathPattern Route path pattern for manual mode, relative to the
- * namespace. Defaults to `/<name>`.
- * @property queryTypeName Optional exported TypeScript query type for manual
- * mode. Defaults to `<PascalName>Query`.
- * @property restResourceName Human-entered resource name normalized into a slug.
- * @property responseTypeName Optional exported TypeScript response type for
- * manual mode. Defaults to `<PascalName>Response`.
- * @property routePattern Optional generated item route pattern, or manual
- * provider-route alias for `pathPattern`, relative to the namespace.
- * Generated mode defaults to `/<name>/item`; manual mode defaults to `/<name>`.
- * @property secretFieldName Optional write-only secret field name for manual
- * settings contracts. Requires a request body.
- * @property secretHasValueFieldName Optional alias for `secretStateFieldName`
- * when the response field is a safe presence indicator.
- * @property secretMaskedResponseFieldName Optional alias for
- * `secretStateFieldName` when the response field represents masked state.
- * @property secretPreserveOnEmpty Whether blank secret submissions should
- * preserve the existing value. Defaults to true when `secretFieldName` is set.
- * @property secretStateFieldName Optional masked response boolean field for
- * `secretFieldName`. Defaults to `has<PascalSecretField>`.
- */
-export interface RunAddRestResourceCommandOptions {
-    auth?: string;
-    bodyTypeName?: string;
-    controllerClass?: string;
-    controllerExtends?: string;
-    cwd?: string;
-    manual?: boolean;
-    method?: string;
-    methods?: string;
-    namespace?: string;
-    permissionCallback?: string;
-    pathPattern?: string;
-    queryTypeName?: string;
-    restResourceName: string;
-    responseTypeName?: string;
-    routePattern?: string;
-    secretFieldName?: string;
-    secretHasValueFieldName?: string;
-    secretMaskedResponseFieldName?: string;
-    secretPreserveOnEmpty?: boolean;
-    secretStateFieldName?: string;
-}
-/**
- * Options for `wp-typia add admin-view`.
- *
- * @property adminViewName Human-entered admin screen name that will be
- * normalized into the generated slug.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @property source Optional data source locator. `rest-resource:<slug>` wires
- * the generated screen to an existing list-capable REST resource.
- * `core-data:<kind>/<name>` binds the screen to a supported WordPress-owned
- * entity collection such as `core-data:postType/post`.
- */
-export interface RunAddAdminViewCommandOptions {
-    adminViewName: string;
-    cwd?: string;
-    source?: string;
-}
-/**
- * Options for `wp-typia add ability`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @property abilityName Human-entered workflow ability name that will be
- * normalized into the generated slug.
- */
-export interface RunAddAbilityCommandOptions {
-    abilityName: string;
-    cwd?: string;
-}
-/**
- * Options for `wp-typia add ai-feature`.
- *
- * @property aiFeatureName Human-entered AI feature name normalized into a slug.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property namespace Optional REST namespace, defaulting to the workspace namespace.
- */
-export interface RunAddAiFeatureCommandOptions {
-    aiFeatureName: string;
-    cwd?: string;
-    namespace?: string;
-}
-/**
- * Options for `wp-typia add hooked-block`.
- *
- * @property anchorBlockName Full `namespace/block` anchor block name.
- * @property blockName Existing workspace block slug that receives metadata.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property position Hook position accepted by WordPress block hooks.
- */
-export interface RunAddHookedBlockCommandOptions {
-    anchorBlockName: string;
-    blockName: string;
-    cwd?: string;
-    position: string;
-}
-/**
- * Options for `wp-typia add editor-plugin`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @property editorPluginName Human-entered editor plugin name that will be
- * normalized into the generated slug.
- * @property slot Optional editor shell slot. Defaults to `sidebar`.
- */
-export interface RunAddEditorPluginCommandOptions {
-    cwd?: string;
-    editorPluginName: string;
-    slot?: string;
-}
-/**
- * Options for `wp-typia add integration-env`.
- *
- * @property cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @property integrationEnvName Human-entered environment name that will be
- * normalized into script and documentation paths.
- * @property service Optional local service starter. Defaults to `none`.
- * @property withReleaseZip Whether to add release zip packaging scripts.
- * @property withWpEnv Whether to add a local `@wordpress/env` preset and scripts.
- */
-export interface RunAddIntegrationEnvCommandOptions {
-    cwd?: string;
-    integrationEnvName: string;
-    service?: string;
-    withReleaseZip?: boolean;
-    withWpEnv?: boolean;
-}
-/**
- * Options for `wp-typia add block`.
- *
- * @property alternateRenderTargets Optional comma-separated alternate render targets.
- * @property blockName Human-entered block name normalized into a slug.
- * @property cwd Working directory used to resolve the nearest official workspace.
- * @property dataStorageMode Optional persistence storage mode.
- * @property externalLayerId Optional external layer id to apply.
- * @property externalLayerSource Optional local, GitHub, or npm external layer source.
- * @property innerBlocksPreset Optional compound block inner blocks preset.
- * @property persistencePolicy Optional persistence access policy.
- * @property selectExternalLayerId Optional selector for interactive external layer choice.
- * @property templateId Optional built-in block template id.
- */
-export interface RunAddBlockCommandOptions {
-    alternateRenderTargets?: string;
-    blockName: string;
-    cwd?: string;
-    dataStorageMode?: string;
-    externalLayerId?: string;
-    externalLayerSource?: string;
-    innerBlocksPreset?: string;
-    persistencePolicy?: string;
-    selectExternalLayerId?: (options: Array<{
-        description?: string;
-        extends: string[];
-        id: string;
-    }>) => Promise<string>;
-    templateId?: string;
-}
-/**
- * Captured workspace mutation state used to roll back partial add operations.
- */
-export interface WorkspaceMutationSnapshot {
-    /** Snapshots of file contents taken before the mutation starts. */
-    fileSources: Array<{
-        /** Absolute file path recorded for rollback. */
-        filePath: string;
-        /** Previous file contents, or `null` when the file did not exist. */
-        source: string | null;
-    }>;
-    /** Snapshot directories created while seeding migration history. */
-    snapshotDirs: string[];
-    /** Files or directories created by the mutation that should be removed on rollback. */
-    targetPaths: string[];
-}
+export * from "./add/cli-add-types.js";