@wp-typia/project-tools 0.22.10 → 0.23.0

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

@@ -82,6 +82,31 @@ export declare function assertBindingSourceDoesNotExist(projectDir: string, bind
  * @throws {Error} When REST resource files or inventory entry already exist.
  */
 export declare function assertRestResourceDoesNotExist(projectDir: string, restResourceSlug: string, inventory: WorkspaceInventory): void;
+/**
+ * Ensure a post-meta contract scaffold does not already exist on disk or in
+ * inventory.
+ *
+ * Also prevents accidentally registering the same meta key for the same post
+ * type through a second generated contract.
+ *
+ * @param projectDir Absolute workspace root used to resolve scaffold paths.
+ * @param postMetaSlug Normalized post-meta contract slug.
+ * @param postType WordPress post type scope.
+ * @param metaKey WordPress meta key.
+ * @param inventory Current workspace inventory used for duplicate detection.
+ * @throws {Error} When post-meta files or inventory entries already exist.
+ */
+export declare function assertPostMetaDoesNotExist(projectDir: string, postMetaSlug: string, postType: string, metaKey: string, inventory: WorkspaceInventory): void;
+/**
+ * Ensure a standalone contract scaffold does not already exist on disk or in
+ * inventory.
+ *
+ * @param projectDir Absolute workspace root used to resolve scaffold paths.
+ * @param contractSlug Normalized contract slug that would be created.
+ * @param inventory Current workspace inventory used for duplicate detection.
+ * @throws {Error} When contract files or inventory entry already exist.
+ */
+export declare function assertContractDoesNotExist(projectDir: string, contractSlug: string, inventory: WorkspaceInventory): void;
 /**
  * Ensure a DataViews admin screen scaffold does not already exist on disk or in
  * the workspace inventory.

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

@@ -127,6 +127,40 @@ const REST_RESOURCE_COLLISION_DESCRIPTOR = {
         message: ({ slug }) => `A REST resource inventory entry already exists for ${slug}. Choose a different name.`,
     },
 };
+const POST_META_COLLISION_DESCRIPTOR = {
+    filesystemCollisions: [
+        {
+            label: "A post meta contract",
+            relativePath: ({ slug }) => path.join("src", "post-meta", slug),
+        },
+        {
+            label: "A post meta bootstrap",
+            relativePath: ({ slug }) => path.join("inc", "post-meta", `${slug}.php`),
+        },
+    ],
+    inventoryCollision: {
+        entries: (inventory) => inventory.postMeta,
+        exists: (entry, { slug }) => entry.slug === slug,
+        message: ({ slug }) => `A post meta inventory entry already exists for ${slug}. Choose a different name.`,
+    },
+};
+const CONTRACT_COLLISION_DESCRIPTOR = {
+    filesystemCollisions: [
+        {
+            label: "A standalone contract",
+            relativePath: ({ slug }) => path.join("src", "contracts", `${slug}.ts`),
+        },
+        {
+            label: "A standalone contract schema",
+            relativePath: ({ slug }) => path.join("src", "contracts", `${slug}.schema.json`),
+        },
+    ],
+    inventoryCollision: {
+        entries: (inventory) => inventory.contracts,
+        exists: (entry, { slug }) => entry.slug === slug,
+        message: ({ slug }) => `A standalone contract inventory entry already exists for ${slug}. Choose a different name.`,
+    },
+};
 const ADMIN_VIEW_COLLISION_DESCRIPTOR = {
     filesystemCollisions: [
         {
@@ -296,6 +330,48 @@ export function assertRestResourceDoesNotExist(projectDir, restResourceSlug, inv
         projectDir,
     });
 }
+/**
+ * Ensure a post-meta contract scaffold does not already exist on disk or in
+ * inventory.
+ *
+ * Also prevents accidentally registering the same meta key for the same post
+ * type through a second generated contract.
+ *
+ * @param projectDir Absolute workspace root used to resolve scaffold paths.
+ * @param postMetaSlug Normalized post-meta contract slug.
+ * @param postType WordPress post type scope.
+ * @param metaKey WordPress meta key.
+ * @param inventory Current workspace inventory used for duplicate detection.
+ * @throws {Error} When post-meta files or inventory entries already exist.
+ */
+export function assertPostMetaDoesNotExist(projectDir, postMetaSlug, postType, metaKey, inventory) {
+    assertAddKindScaffoldDoesNotExist({
+        context: { metaKey, postType, slug: postMetaSlug },
+        descriptor: POST_META_COLLISION_DESCRIPTOR,
+        inventory,
+        projectDir,
+    });
+    if (inventory.postMeta.some((entry) => entry.postType === postType && entry.metaKey === metaKey)) {
+        throw new Error(`A post meta inventory entry already registers ${metaKey} for ${postType}. Choose a different meta key or post type.`);
+    }
+}
+/**
+ * Ensure a standalone contract scaffold does not already exist on disk or in
+ * inventory.
+ *
+ * @param projectDir Absolute workspace root used to resolve scaffold paths.
+ * @param contractSlug Normalized contract slug that would be created.
+ * @param inventory Current workspace inventory used for duplicate detection.
+ * @throws {Error} When contract files or inventory entry already exist.
+ */
+export function assertContractDoesNotExist(projectDir, contractSlug, inventory) {
+    assertAddKindScaffoldDoesNotExist({
+        context: { slug: contractSlug },
+        descriptor: CONTRACT_COLLISION_DESCRIPTOR,
+        inventory,
+        projectDir,
+    });
+}
 /**
  * Ensure a DataViews admin screen scaffold does not already exist on disk or in
  * the workspace inventory.

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

@@ -8,12 +8,16 @@ 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] [--service <none|docker-compose>] [--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> [--dry-run]
   wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--dry-run]
-  wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <${REST_RESOURCE_METHOD_IDS.join(",")}>] [--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>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--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]
@@ -27,13 +31,18 @@ Notes:
   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 \`--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/\`.
   \`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.
-  \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`.
+  \`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 REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files.
+  \`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.

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

@@ -4,7 +4,7 @@
  *
  * Keep this order stable because it drives help output and command metadata.
  */
-export declare const ADD_KIND_IDS: readonly ["admin-view", "block", "variation", "style", "transform", "pattern", "binding-source", "rest-resource", "ability", "ai-feature", "hooked-block", "editor-plugin"];
+export declare const ADD_KIND_IDS: readonly ["admin-view", "block", "integration-env", "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.
  */

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

@@ -7,12 +7,15 @@
 export const ADD_KIND_IDS = [
     "admin-view",
     "block",
+    "integration-env",
     "variation",
     "style",
     "transform",
     "pattern",
     "binding-source",
+    "contract",
     "rest-resource",
+    "post-meta",
     "ability",
     "ai-feature",
     "hooked-block",

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

@@ -9,6 +9,22 @@ export declare const REST_RESOURCE_METHOD_IDS: readonly ["list", "read", "create
  * 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`.
@@ -34,6 +50,15 @@ export declare const EDITOR_PLUGIN_SLOT_ALIASES: {
  * @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`.
  */
@@ -118,19 +143,95 @@ export interface RunAddBindingSourceCommandOptions {
     bindingSourceName: string;
     cwd?: 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 generated REST controller class reference.
+ * When present, route callbacks delegate through an instantiated controller.
+ * @property controllerExtends Optional base class for the generated controller
+ * wrapper when `controllerClass` is a global class name.
  * @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.
+ * @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, relative to the
+ * namespace. Defaults to `/<name>/item`.
+ * @property secretFieldName Optional write-only secret field name for manual
+ * settings contracts. Requires a request body.
+ * @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;
+    secretStateFieldName?: string;
 }
 /**
  * Options for `wp-typia add admin-view`.
@@ -201,6 +302,22 @@ export interface RunAddEditorPluginCommandOptions {
     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 withWpEnv Whether to add a local `@wordpress/env` preset and scripts.
+ */
+export interface RunAddIntegrationEnvCommandOptions {
+    cwd?: string;
+    integrationEnvName: string;
+    service?: string;
+    withWpEnv?: boolean;
+}
 /**
  * Options for `wp-typia add block`.
  *

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

@@ -11,6 +11,24 @@ export const REST_RESOURCE_METHOD_IDS = [
     "update",
     "delete",
 ];
+/**
+ * Supported HTTP methods accepted by manual REST contract mode.
+ */
+export const MANUAL_REST_CONTRACT_HTTP_METHOD_IDS = [
+    "DELETE",
+    "GET",
+    "PATCH",
+    "POST",
+    "PUT",
+];
+/**
+ * Supported auth intent values accepted by manual REST contract mode.
+ */
+export const MANUAL_REST_CONTRACT_AUTH_IDS = [
+    "authenticated",
+    "public",
+    "public-write-protected",
+];
 /**
  * Canonical editor-plugin shell surface ids accepted by
  * `wp-typia add editor-plugin --slot`.
@@ -38,6 +56,14 @@ export function resolveEditorPluginSlotAlias(slot) {
     }
     return EDITOR_PLUGIN_SLOT_ALIASES[trimmed];
 }
+/**
+ * Optional local service starter ids accepted by
+ * `wp-typia add integration-env --service`.
+ */
+export const INTEGRATION_ENV_SERVICE_IDS = [
+    "none",
+    "docker-compose",
+];
 /**
  * Supported built-in block families accepted by `wp-typia add block --template`.
  */

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

@@ -1,5 +1,5 @@
 import { type HookedBlockPositionId } from "./hooked-blocks.js";
-import { type AddBlockTemplateId, type EditorPluginSlotId, type RestResourceMethodId } from "./cli-add-types.js";
+import { type AddBlockTemplateId, type EditorPluginSlotId, type IntegrationEnvServiceId, type ManualRestContractAuthId, type ManualRestContractHttpMethodId, type RestResourceMethodId } from "./cli-add-types.js";
 /**
  * Namespace format accepted by plugin-level REST resources.
  */
@@ -14,6 +14,16 @@ export declare const REST_RESOURCE_NAMESPACE_PATTERN: RegExp;
  * @throws {Error} When the slug is empty or contains unsupported characters.
  */
 export declare function assertValidGeneratedSlug(label: string, slug: string, usage: string): string;
+/**
+ * Validate a source type name used by generated schema artifact workflows.
+ *
+ * @param label Human-readable field label used in error messages.
+ * @param value TypeScript identifier candidate from CLI input or defaults.
+ * @param usage CLI usage hint shown when the identifier is empty.
+ * @returns The trimmed, validated TypeScript identifier.
+ * @throws {Error} When the value is empty or not a TypeScript identifier.
+ */
+export declare function assertValidTypeScriptIdentifier(label: string, value: string, usage: string): string;
 /**
  * Validate a REST resource namespace.
  *
@@ -31,6 +41,26 @@ export declare function assertValidRestResourceNamespace(namespace: string): str
  * @throws {Error} When the resolved namespace is invalid.
  */
 export declare function resolveRestResourceNamespace(workspaceNamespace: string, namespace?: string): string;
+/**
+ * Validate a WordPress post type key used as post-meta scope.
+ *
+ * @param postType Raw post type key from CLI input.
+ * @returns The trimmed post type key.
+ * @throws {Error} When the key is empty or contains unsupported characters.
+ */
+export declare function assertValidPostMetaPostType(postType: string): string;
+/**
+ * Resolve a post-meta key from explicit input or the workspace slug default.
+ *
+ * @param options Optional explicit meta key plus workspace prefix and slug.
+ * @returns A validated post-meta key.
+ * @throws {Error} When the key is empty or contains whitespace/control characters.
+ */
+export declare function resolvePostMetaKey({ metaKey, phpPrefix, slug, }: {
+    metaKey?: string;
+    phpPrefix: string;
+    slug: string;
+}): string;
 /**
  * Parse and validate REST resource method ids from a comma-separated list.
  *
@@ -39,6 +69,57 @@ export declare function resolveRestResourceNamespace(workspaceNamespace: string,
  * @throws {Error} When any method is unsupported or the list is empty.
  */
 export declare function assertValidRestResourceMethods(methods?: string): RestResourceMethodId[];
+/**
+ * Validate a PHP callable reference supplied to generated REST route metadata.
+ *
+ * @param label Human-readable field label for errors.
+ * @param callback Optional PHP function or `ClassName::method` callback string.
+ * @returns The trimmed callback when present.
+ * @throws {Error} When the callback cannot be emitted as a safe PHP callable string.
+ */
+export declare function resolveOptionalPhpCallbackReference(label: string, callback?: string): string | undefined;
+/**
+ * Validate a PHP class reference used by generated REST controller wrappers.
+ *
+ * @param label Human-readable field label for errors.
+ * @param classReference Optional PHP class name.
+ * @returns The trimmed class reference when present.
+ * @throws {Error} When the class reference cannot be emitted safely.
+ */
+export declare function resolveOptionalPhpClassReference(label: string, classReference?: string): string | undefined;
+/**
+ * Normalize and validate the HTTP method used by a manual REST contract.
+ *
+ * @param method Optional method input. Defaults to GET.
+ * @returns A canonical uppercase HTTP method.
+ * @throws {Error} When the method is unsupported.
+ */
+export declare function assertValidManualRestContractHttpMethod(method?: string): ManualRestContractHttpMethodId;
+/**
+ * Normalize and validate the auth intent used by a manual REST contract.
+ *
+ * @param auth Optional auth intent input. Defaults to public.
+ * @returns A canonical auth intent.
+ * @throws {Error} When the auth intent is unsupported.
+ */
+export declare function assertValidManualRestContractAuth(auth?: string): ManualRestContractAuthId;
+/**
+ * Check whether a generated REST item route keeps the generated `id` contract aligned.
+ *
+ * @param routePattern Route pattern relative to the namespace.
+ * @returns True when the pattern has no regex groups or uses only `(?P<id>...)`.
+ */
+export declare function isGeneratedRestResourceRoutePatternCompatible(routePattern: string): boolean;
+export declare function resolveManualRestContractPathPattern(slug: string, pathPattern?: string): string;
+/**
+ * Normalize and validate a generated REST resource item route pattern.
+ *
+ * @param slug Generated resource slug used for the default item route path.
+ * @param routePattern Optional route path pattern, relative to the namespace.
+ * @returns A route pattern with a leading slash.
+ * @throws {Error} When the route pattern is empty or clearly not a route path.
+ */
+export declare function resolveGeneratedRestResourceRoutePattern(slug: string, routePattern?: string): string;
 /**
  * Validate a hooked block insertion position.
  *
@@ -85,3 +166,11 @@ export declare function assertValidHookAnchor(anchorBlockName: string): string;
  * @throws {Error} When the slot is not supported by the workspace scaffold.
  */
 export declare function assertValidEditorPluginSlot(slot?: string): EditorPluginSlotId;
+/**
+ * Validate and normalize the optional integration environment service starter.
+ *
+ * @param service Optional service starter id. Defaults to `none`.
+ * @returns The canonical integration environment service id.
+ * @throws {Error} When the service starter is unsupported.
+ */
+export declare function assertValidIntegrationEnvService(service?: string): IntegrationEnvServiceId;