wp-typia 0.22.10 → 0.23.0

package/dist-bunli/{cli-3fzqhpx9.js → cli-ts9thts5.js}

@@ -170926,6 +170926,18 @@ var REST_RESOURCE_METHOD_IDS = [
   "update",
   "delete"
 ];
+var MANUAL_REST_CONTRACT_HTTP_METHOD_IDS = [
+  "DELETE",
+  "GET",
+  "PATCH",
+  "POST",
+  "PUT"
+];
+var MANUAL_REST_CONTRACT_AUTH_IDS = [
+  "authenticated",
+  "public",
+  "public-write-protected"
+];
 var EDITOR_PLUGIN_SLOT_IDS = ["sidebar", "document-setting-panel"];
 var EDITOR_PLUGIN_SLOT_ALIASES = {
   PluginDocumentSettingPanel: "document-setting-panel",
@@ -170940,6 +170952,10 @@ function resolveEditorPluginSlotAlias(slot) {
   }
   return EDITOR_PLUGIN_SLOT_ALIASES[trimmed];
 }
+var INTEGRATION_ENV_SERVICE_IDS = [
+  "none",
+  "docker-compose"
+];
 var ADD_BLOCK_TEMPLATE_IDS = [
   "basic",
   "interactivity",
@@ -171038,7 +171054,97 @@ function toTitleCase(input) {
 
 // ../wp-typia-project-tools/src/runtime/cli-add-validation.ts
 var WORKSPACE_GENERATED_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
+var WORDPRESS_POST_TYPE_PATTERN = /^[a-z0-9_][a-z0-9_-]*$/u;
+var TYPESCRIPT_IDENTIFIER_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+var TYPESCRIPT_RESERVED_IDENTIFIERS = new Set([
+  "abstract",
+  "any",
+  "as",
+  "asserts",
+  "async",
+  "await",
+  "bigint",
+  "boolean",
+  "break",
+  "case",
+  "catch",
+  "class",
+  "const",
+  "constructor",
+  "continue",
+  "debugger",
+  "declare",
+  "default",
+  "delete",
+  "do",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "finally",
+  "for",
+  "from",
+  "function",
+  "get",
+  "global",
+  "if",
+  "implements",
+  "import",
+  "in",
+  "infer",
+  "instanceof",
+  "interface",
+  "intrinsic",
+  "is",
+  "keyof",
+  "let",
+  "module",
+  "namespace",
+  "never",
+  "new",
+  "null",
+  "number",
+  "object",
+  "of",
+  "out",
+  "override",
+  "package",
+  "private",
+  "protected",
+  "public",
+  "readonly",
+  "require",
+  "return",
+  "satisfies",
+  "set",
+  "static",
+  "string",
+  "super",
+  "switch",
+  "symbol",
+  "this",
+  "throw",
+  "true",
+  "try",
+  "type",
+  "typeof",
+  "undefined",
+  "unique",
+  "unknown",
+  "using",
+  "var",
+  "void",
+  "while",
+  "with",
+  "yield"
+]);
 var REST_RESOURCE_NAMESPACE_PATTERN = /^[a-z][a-z0-9-]*(?:\/[a-z0-9-]+)+$/u;
+var PHP_IDENTIFIER_PATTERN = "[A-Za-z_][A-Za-z0-9_]*";
+var PHP_QUALIFIED_NAME_PATTERN = new RegExp(`^\\\\?${PHP_IDENTIFIER_PATTERN}(?:\\\\${PHP_IDENTIFIER_PATTERN})*$`, "u");
+var PHP_CALLBACK_REFERENCE_PATTERN = new RegExp(`^\\\\?${PHP_IDENTIFIER_PATTERN}(?:\\\\${PHP_IDENTIFIER_PATTERN})*(?:::${PHP_IDENTIFIER_PATTERN})?$`, "u");
+var REST_ROUTE_NAMED_CAPTURE_PATTERN = /\(\?P<([A-Za-z_][A-Za-z0-9_]*)>/gu;
+var REST_ROUTE_UNSUPPORTED_CAPTURE_PATTERN = /\((?!\?(?:P<[A-Za-z_][A-Za-z0-9_]*>|:))/u;
 function assertValidGeneratedSlug(label, slug, usage) {
   if (!slug) {
     throw new Error(`${label} is required. Use \`${usage}\`.`);
@@ -171048,6 +171154,19 @@ function assertValidGeneratedSlug(label, slug, usage) {
   }
   return slug;
 }
+function assertValidTypeScriptIdentifier(label, value, usage) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    throw new Error(`${label} is required. Use \`${usage}\`.`);
+  }
+  if (!TYPESCRIPT_IDENTIFIER_PATTERN.test(trimmed)) {
+    throw new Error(`${label} must be a valid TypeScript identifier, such as ExternalRetrieveResponse.`);
+  }
+  if (TYPESCRIPT_RESERVED_IDENTIFIERS.has(trimmed)) {
+    throw new Error(`${label} must not be a reserved TypeScript keyword, such as ${trimmed}.`);
+  }
+  return trimmed;
+}
 function assertValidRestResourceNamespace(namespace) {
   const trimmed = namespace.trim();
   if (!trimmed) {
@@ -171061,6 +171180,34 @@ function assertValidRestResourceNamespace(namespace) {
 function resolveRestResourceNamespace(workspaceNamespace, namespace) {
   return assertValidRestResourceNamespace(namespace ?? `${workspaceNamespace}/v1`);
 }
+function assertValidPostMetaPostType(postType) {
+  const trimmed = postType.trim();
+  if (!trimmed) {
+    throw new Error("`wp-typia add post-meta` requires --post-type <post-type>.");
+  }
+  if (trimmed.length > 20) {
+    throw new Error("Post meta post type must be 20 characters or fewer.");
+  }
+  if (!WORDPRESS_POST_TYPE_PATTERN.test(trimmed)) {
+    throw new Error("Post meta post type must use a WordPress post type key such as `post` or `example_post_type`.");
+  }
+  return trimmed;
+}
+function resolvePostMetaKey({
+  metaKey,
+  phpPrefix,
+  slug
+}) {
+  const resolvedMetaKey = metaKey ?? `_${toSnakeCase(`${phpPrefix}_${slug}`)}`;
+  const trimmed = resolvedMetaKey.trim();
+  if (!trimmed) {
+    throw new Error("Post meta key cannot be empty.");
+  }
+  if (/[\p{Cc}\s]/u.test(trimmed)) {
+    throw new Error("Post meta key must not contain whitespace or control characters.");
+  }
+  return trimmed;
+}
 function assertValidRestResourceMethods(methods) {
   const rawMethods = typeof methods === "string" && methods.trim().length > 0 ? methods.split(",").map((value) => value.trim()).filter(Boolean) : ["list", "read", "create"];
   const normalizedMethods = Array.from(new Set(rawMethods));
@@ -171073,6 +171220,91 @@ function assertValidRestResourceMethods(methods) {
   }
   return normalizedMethods;
 }
+function resolveOptionalPhpCallbackReference(label, callback) {
+  if (callback == null) {
+    return;
+  }
+  const trimmed = callback.trim();
+  if (!trimmed) {
+    throw new Error(`${label} cannot be empty.`);
+  }
+  if (!PHP_CALLBACK_REFERENCE_PATTERN.test(trimmed)) {
+    throw new Error(`${label} must be a PHP function reference or ClassName::method callback.`);
+  }
+  return trimmed;
+}
+function resolveOptionalPhpClassReference(label, classReference) {
+  if (classReference == null) {
+    return;
+  }
+  const trimmed = classReference.trim();
+  if (!trimmed) {
+    throw new Error(`${label} cannot be empty.`);
+  }
+  if (!PHP_QUALIFIED_NAME_PATTERN.test(trimmed)) {
+    throw new Error(`${label} must be a PHP class reference such as Demo_Rest_Controller or Vendor\\Plugin\\Controller.`);
+  }
+  return trimmed;
+}
+function assertValidManualRestContractHttpMethod(method = "GET") {
+  const normalized = method.trim().toUpperCase();
+  if (MANUAL_REST_CONTRACT_HTTP_METHOD_IDS.includes(normalized)) {
+    return normalized;
+  }
+  throw new Error(`Manual REST contract method must be one of: ${MANUAL_REST_CONTRACT_HTTP_METHOD_IDS.join(", ")}.`);
+}
+function assertValidManualRestContractAuth(auth = "public") {
+  const normalized = auth.trim().toLowerCase();
+  if (MANUAL_REST_CONTRACT_AUTH_IDS.includes(normalized)) {
+    return normalized;
+  }
+  throw new Error(`Manual REST contract auth must be one of: ${MANUAL_REST_CONTRACT_AUTH_IDS.join(", ")}.`);
+}
+function resolveRestRoutePathPattern(options) {
+  const explicitPath = typeof options.pathPattern === "string" ? options.pathPattern.trim() : undefined;
+  if (explicitPath === "") {
+    throw new Error(options.emptyMessage);
+  }
+  const trimmed = explicitPath ?? options.defaultPath;
+  if (/^https?:\/\//iu.test(trimmed)) {
+    throw new Error(`${options.label} must be a route pattern relative to the namespace, not an absolute URL.`);
+  }
+  const withLeadingSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+  if (!withLeadingSlash || withLeadingSlash === "/") {
+    throw new Error(options.emptyMessage);
+  }
+  if (/\s/u.test(withLeadingSlash)) {
+    throw new Error(`${options.label} must not contain whitespace.`);
+  }
+  return withLeadingSlash;
+}
+function isGeneratedRestResourceRoutePatternCompatible(routePattern) {
+  const namedCaptures = Array.from(routePattern.matchAll(REST_ROUTE_NAMED_CAPTURE_PATTERN), (match) => match[1]);
+  const hasRegexGroup = routePattern.includes("(");
+  const hasUnsupportedCapture = REST_ROUTE_UNSUPPORTED_CAPTURE_PATTERN.test(routePattern);
+  return !hasUnsupportedCapture && (!hasRegexGroup || namedCaptures.length === 1 && namedCaptures[0] === "id");
+}
+function resolveManualRestContractPathPattern(slug, pathPattern) {
+  return resolveRestRoutePathPattern({
+    defaultPath: `/${slug}`,
+    emptyMessage: "Manual REST contract path is required. Use `--path <route-pattern>` such as `/external-record/(?P<id>[\\d]+)`.",
+    label: "Manual REST contract path",
+    pathPattern
+  });
+}
+function resolveGeneratedRestResourceRoutePattern(slug, routePattern) {
+  const resolvedRoutePattern = resolveRestRoutePathPattern({
+    defaultPath: `/${slug}/item`,
+    emptyMessage: "Generated REST resource route pattern is required. Use `--route-pattern <route-pattern>` such as `/records/(?P<id>[\\d]+)`.",
+    label: "Generated REST resource route pattern",
+    pathPattern: routePattern
+  });
+  const hasExplicitRoutePattern = typeof routePattern === "string" && routePattern.trim().length > 0;
+  if (hasExplicitRoutePattern && !isGeneratedRestResourceRoutePatternCompatible(resolvedRoutePattern)) {
+    throw new Error("Generated REST resource route pattern must use only an `(?P<id>...)` named capture when using regex groups.");
+  }
+  return resolvedRoutePattern;
+}
 function assertValidHookedBlockPosition(position) {
   if (HOOKED_BLOCK_POSITION_IDS.includes(position)) {
     return position;
@@ -171105,6 +171337,13 @@ function assertValidEditorPluginSlot(slot = "sidebar") {
   }
   throw new Error(`Editor plugin slot must be one of: ${EDITOR_PLUGIN_SLOT_IDS.join(", ")}. Legacy aliases: PluginSidebar, PluginDocumentSettingPanel.`);
 }
+function assertValidIntegrationEnvService(service = "none") {
+  const trimmed = service.trim();
+  if (INTEGRATION_ENV_SERVICE_IDS.includes(trimmed)) {
+    return trimmed;
+  }
+  throw new Error(`Integration environment service must be one of: ${INTEGRATION_ENV_SERVICE_IDS.join(", ")}.`);
+}
 
 // ../wp-typia-project-tools/src/runtime/fs-async.ts
 import { promises as fsp } from "fs";
@@ -171141,12 +171380,16 @@ 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]
@@ -171160,13 +171403,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.
@@ -171443,6 +171691,40 @@ var REST_RESOURCE_COLLISION_DESCRIPTOR = {
     message: ({ slug }) => `A REST resource inventory entry already exists for ${slug}. Choose a different name.`
   }
 };
+var POST_META_COLLISION_DESCRIPTOR = {
+  filesystemCollisions: [
+    {
+      label: "A post meta contract",
+      relativePath: ({ slug }) => path3.join("src", "post-meta", slug)
+    },
+    {
+      label: "A post meta bootstrap",
+      relativePath: ({ slug }) => path3.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.`
+  }
+};
+var CONTRACT_COLLISION_DESCRIPTOR = {
+  filesystemCollisions: [
+    {
+      label: "A standalone contract",
+      relativePath: ({ slug }) => path3.join("src", "contracts", `${slug}.ts`)
+    },
+    {
+      label: "A standalone contract schema",
+      relativePath: ({ slug }) => path3.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.`
+  }
+};
 var ADMIN_VIEW_COLLISION_DESCRIPTOR = {
   filesystemCollisions: [
     {
@@ -171555,6 +171837,25 @@ function assertRestResourceDoesNotExist(projectDir, restResourceSlug, inventory)
     projectDir
   });
 }
+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.`);
+  }
+}
+function assertContractDoesNotExist(projectDir, contractSlug, inventory) {
+  assertAddKindScaffoldDoesNotExist({
+    context: { slug: contractSlug },
+    descriptor: CONTRACT_COLLISION_DESCRIPTOR,
+    inventory,
+    projectDir
+  });
+}
 function assertAdminViewDoesNotExist(projectDir, adminViewSlug, inventory) {
   assertAddKindScaffoldDoesNotExist({
     context: { slug: adminViewSlug },
@@ -171611,7 +171912,9 @@ var BLOCK_STYLE_CONFIG_ENTRY_MARKER = "\t// wp-typia add style entries";
 var BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER = "\t// wp-typia add transform entries";
 var PATTERN_CONFIG_ENTRY_MARKER = "\t// wp-typia add pattern entries";
 var BINDING_SOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add binding-source entries";
+var CONTRACT_CONFIG_ENTRY_MARKER = "\t// wp-typia add contract entries";
 var REST_RESOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add rest-resource entries";
+var POST_META_CONFIG_ENTRY_MARKER = "\t// wp-typia add post-meta entries";
 var ABILITY_CONFIG_ENTRY_MARKER = "\t// wp-typia add ability entries";
 var AI_FEATURE_CONFIG_ENTRY_MARKER = "\t// wp-typia add ai-feature entries";
 var ADMIN_VIEW_CONFIG_ENTRY_MARKER = "\t// wp-typia add admin-view entries";
@@ -171689,23 +171992,63 @@ export const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [
 	// wp-typia add binding-source entries
 ];
 `;
+var CONTRACTS_INTERFACE_SECTION = `
+
+export interface WorkspaceContractConfig {
+	schemaFile: string;
+	slug: string;
+	sourceTypeName: string;
+	typesFile: string;
+}
+`;
+var CONTRACTS_CONST_SECTION = `
+
+export const CONTRACTS: WorkspaceContractConfig[] = [
+	// wp-typia add contract entries
+];
+`;
 var REST_RESOURCES_INTERFACE_SECTION = `
 
-export interface WorkspaceRestResourceConfig {
+export interface WorkspaceRestResourceBaseConfig {
 	apiFile: string;
+	auth?: 'authenticated' | 'public' | 'public-write-protected';
+	bodyTypeName?: string;
 	clientFile: string;
-	dataFile: string;
-	methods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
+	controllerClass?: string;
+	controllerExtends?: string;
 	namespace: string;
 	openApiFile: string;
-	phpFile: string;
+	permissionCallback?: string;
 	restManifest?: ReturnType<
 		typeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
 	>;
+	secretFieldName?: string;
+	secretStateFieldName?: string;
 	slug: string;
 	typesFile: string;
 	validatorsFile: string;
 }
+
+export interface GeneratedWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {
+	dataFile: string;
+	methods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
+	mode?: 'generated';
+	phpFile: string;
+	routePattern?: string;
+}
+
+export interface ManualWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {
+	method: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+	methods: [];
+	mode: 'manual';
+	pathPattern: string;
+	queryTypeName: string;
+	responseTypeName: string;
+}
+
+export type WorkspaceRestResourceConfig =
+	| GeneratedWorkspaceRestResourceConfig
+	| ManualWorkspaceRestResourceConfig;
 `;
 var REST_RESOURCES_CONST_SECTION = `
 
@@ -171713,6 +172056,25 @@ export const REST_RESOURCES: WorkspaceRestResourceConfig[] = [
 	// wp-typia add rest-resource entries
 ];
 `;
+var POST_META_INTERFACE_SECTION = `
+
+export interface WorkspacePostMetaConfig {
+	metaKey: string;
+	phpFile: string;
+	postType: string;
+	schemaFile: string;
+	showInRest: boolean;
+	slug: string;
+	sourceTypeName: string;
+	typesFile: string;
+}
+`;
+var POST_META_CONST_SECTION = `
+
+export const POST_META: WorkspacePostMetaConfig[] = [
+	// wp-typia add post-meta entries
+];
+`;
 var WORKSPACE_COMPATIBILITY_CONFIG_FIELD = `	compatibility?: {
 		hardMinimums: {
 			php?: string;
@@ -171960,6 +172322,33 @@ var INVENTORY_SECTIONS = [
       section: BINDING_SOURCES_CONST_SECTION
     }
   },
+  {
+    append: {
+      marker: CONTRACT_CONFIG_ENTRY_MARKER,
+      optionKey: "contractEntries"
+    },
+    interface: {
+      name: "WorkspaceContractConfig",
+      section: CONTRACTS_INTERFACE_SECTION
+    },
+    parse: {
+      entriesKey: "contracts",
+      entry: defineInventoryEntryParser()({
+        entryName: "CONTRACTS",
+        fields: [
+          { key: "schemaFile", required: true },
+          { key: "slug", required: true },
+          { key: "sourceTypeName", required: true },
+          { key: "typesFile", required: true }
+        ]
+      }),
+      hasSectionKey: "hasContractsSection"
+    },
+    value: {
+      name: "CONTRACTS",
+      section: CONTRACTS_CONST_SECTION
+    }
+  },
   {
     append: {
       marker: REST_RESOURCE_CONFIG_ENTRY_MARKER,
@@ -171975,8 +172364,27 @@ var INVENTORY_SECTIONS = [
         entryName: "REST_RESOURCES",
         fields: [
           { key: "apiFile", required: true },
+          {
+            key: "auth",
+            validate: (value, context) => {
+              if (typeof value === "string" && !MANUAL_REST_CONTRACT_AUTH_IDS.includes(value)) {
+                throw new Error(`${context.entryName}[${context.elementIndex}].${context.key} must be one of: ${MANUAL_REST_CONTRACT_AUTH_IDS.join(", ")}.`);
+              }
+            }
+          },
+          { key: "bodyTypeName" },
           { key: "clientFile", required: true },
-          { key: "dataFile", required: true },
+          { key: "controllerClass" },
+          { key: "controllerExtends" },
+          { key: "dataFile" },
+          {
+            key: "method",
+            validate: (value, context) => {
+              if (typeof value === "string" && !MANUAL_REST_CONTRACT_HTTP_METHOD_IDS.includes(value)) {
+                throw new Error(`${context.entryName}[${context.elementIndex}].${context.key} must be one of: ${MANUAL_REST_CONTRACT_HTTP_METHOD_IDS.join(", ")}.`);
+              }
+            }
+          },
           {
             key: "methods",
             kind: "stringArray",
@@ -171989,9 +172397,24 @@ var INVENTORY_SECTIONS = [
               }
             }
           },
+          {
+            key: "mode",
+            validate: (value, context) => {
+              if (typeof value === "string" && value !== "generated" && value !== "manual") {
+                throw new Error(`${context.entryName}[${context.elementIndex}].${context.key} must be generated or manual.`);
+              }
+            }
+          },
           { key: "namespace", required: true },
           { key: "openApiFile", required: true },
-          { key: "phpFile", required: true },
+          { key: "pathPattern" },
+          { key: "permissionCallback" },
+          { key: "phpFile" },
+          { key: "queryTypeName" },
+          { key: "responseTypeName" },
+          { key: "routePattern" },
+          { key: "secretFieldName" },
+          { key: "secretStateFieldName" },
           { key: "slug", required: true },
           { key: "typesFile", required: true },
           { key: "validatorsFile", required: true }
@@ -172004,6 +172427,37 @@ var INVENTORY_SECTIONS = [
       section: REST_RESOURCES_CONST_SECTION
     }
   },
+  {
+    append: {
+      marker: POST_META_CONFIG_ENTRY_MARKER,
+      optionKey: "postMetaEntries"
+    },
+    interface: {
+      name: "WorkspacePostMetaConfig",
+      section: POST_META_INTERFACE_SECTION
+    },
+    parse: {
+      entriesKey: "postMeta",
+      entry: defineInventoryEntryParser()({
+        entryName: "POST_META",
+        fields: [
+          { key: "metaKey", required: true },
+          { key: "phpFile", required: true },
+          { key: "postType", required: true },
+          { key: "schemaFile", required: true },
+          { key: "showInRest", kind: "boolean", required: true },
+          { key: "slug", required: true },
+          { key: "sourceTypeName", required: true },
+          { key: "typesFile", required: true }
+        ]
+      }),
+      hasSectionKey: "hasPostMetaSection"
+    },
+    value: {
+      name: "POST_META",
+      section: POST_META_CONST_SECTION
+    }
+  },
   {
     append: {
       marker: ABILITY_CONFIG_ENTRY_MARKER,
@@ -172190,6 +172644,25 @@ function getOptionalStringArrayProperty(entryName, elementIndex, objectLiteral,
   }
   return;
 }
+function getOptionalBooleanProperty(entryName, elementIndex, objectLiteral, key) {
+  for (const property of objectLiteral.properties) {
+    if (!import_typescript2.default.isPropertyAssignment(property)) {
+      continue;
+    }
+    const propertyName = getPropertyNameText(property.name);
+    if (propertyName !== key) {
+      continue;
+    }
+    if (property.initializer.kind === import_typescript2.default.SyntaxKind.TrueKeyword) {
+      return true;
+    }
+    if (property.initializer.kind === import_typescript2.default.SyntaxKind.FalseKeyword) {
+      return false;
+    }
+    throw new Error(`${entryName}[${elementIndex}] must use a boolean literal for "${key}" in scripts/block-config.ts.`);
+  }
+  return;
+}
 function isMissingRequiredInventoryValue(value) {
   return value === undefined || typeof value === "string" && value.length === 0;
 }
@@ -172210,7 +172683,7 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
     const entry = {};
     for (const field of descriptor.fields) {
       const kind = field.kind ?? "string";
-      const value = kind === "stringArray" ? getOptionalStringArrayProperty(descriptor.entryName, elementIndex, element, field.key) : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
+      const value = kind === "stringArray" ? getOptionalStringArrayProperty(descriptor.entryName, elementIndex, element, field.key) : kind === "boolean" ? getOptionalBooleanProperty(descriptor.entryName, elementIndex, element, field.key) : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
       field.validate?.(value, {
         elementIndex,
         entryName: descriptor.entryName,
@@ -172264,6 +172737,7 @@ function parseWorkspaceInventorySource(source) {
     blockStyles: [],
     blockTransforms: [],
     blocks: parseInventorySection(sourceFile, BLOCK_INVENTORY_SECTION).entries,
+    contracts: [],
     editorPlugins: [],
     hasAbilitiesSection: false,
     hasAdminViewsSection: false,
@@ -172271,11 +172745,14 @@ function parseWorkspaceInventorySource(source) {
     hasBindingSourcesSection: false,
     hasBlockStylesSection: false,
     hasBlockTransformsSection: false,
+    hasContractsSection: false,
     hasEditorPluginsSection: false,
     hasPatternsSection: false,
+    hasPostMetaSection: false,
     hasRestResourcesSection: false,
     hasVariationsSection: false,
     patterns: [],
+    postMeta: [],
     restResources: [],
     source,
     variations: []
@@ -172717,7 +173194,7 @@ function replacePhpFunctionDefinition(source, functionName, replacement, options
 function ensureWorkspaceInventorySections(source) {
   let nextSource = source.trimEnd();
   for (const section of INVENTORY_SECTIONS) {
-    if (section.interface && !hasExportedInterface(nextSource, section.interface.name)) {
+    if (section.interface && !hasExportedTypeDeclaration(nextSource, section.interface.name)) {
       nextSource += section.interface.section;
     }
     if (section.value && !hasExportedConst(nextSource, section.value.name)) {
@@ -172727,8 +173204,8 @@ function ensureWorkspaceInventorySections(source) {
   return `${nextSource}
 `;
 }
-function hasExportedInterface(source, interfaceName) {
-  return new RegExp(`export\\s+interface\\s+${escapeRegex(interfaceName)}\\b`, "u").test(source);
+function hasExportedTypeDeclaration(source, interfaceName) {
+  return new RegExp(`export\\s+(?:interface|type)\\s+${escapeRegex(interfaceName)}\\b`, "u").test(source);
 }
 function hasExportedConst(source, constName) {
   return new RegExp(`export\\s+const\\s+${escapeRegex(constName)}\\b`, "u").test(source);
@@ -172781,6 +173258,37 @@ function ensureInterfaceField(source, interfaceName, fieldName, fieldSource) {
     return `${start}${body}${body.length > 0 && !body.endsWith(lineEnding) ? lineEnding : ""}${formattedFieldSource}${end}`;
   });
 }
+function upsertInterfaceField(source, interfaceName, fieldName, fieldSource) {
+  const interfacePattern = new RegExp(`(export\\s+interface\\s+${escapeRegex(interfaceName)}\\s*\\{\\r?\\n)([\\s\\S]*?)(\\r?\\n\\})`, "u");
+  return source.replace(interfacePattern, (match, start, body, end) => {
+    const lineEnding = start.endsWith(`\r
+`) ? `\r
+` : `
+`;
+    const formattedFieldSource = `${fieldSource.replace(/\r?\n$/u, "").split(`
+`).join(lineEnding)}${lineEnding}`;
+    const existingFieldPattern = new RegExp(`(^[ \\t]*${escapeRegex(fieldName)}\\??:\\s*[^;\\r\\n]+;?\\r?\\n?)`, "mu");
+    const existingFieldMatch = existingFieldPattern.exec(body);
+    if (existingFieldMatch?.[0]) {
+      if (existingFieldMatch[0].trim() === fieldSource.trim()) {
+        return match;
+      }
+      return `${start}${body.slice(0, existingFieldMatch.index)}${formattedFieldSource}${body.slice(existingFieldMatch.index + existingFieldMatch[0].length)}${end}`;
+    }
+    const memberPattern = /^[ \t]*([A-Za-z_$][\w$]*)\??:/gmu;
+    for (const member of body.matchAll(memberPattern)) {
+      const memberIndex = member.index;
+      const memberName = member[1];
+      if (memberIndex === undefined || !memberName) {
+        continue;
+      }
+      if (memberName.localeCompare(fieldName) > 0) {
+        return `${start}${body.slice(0, memberIndex)}${formattedFieldSource}${body.slice(memberIndex)}${end}`;
+      }
+    }
+    return `${start}${body}${body.length > 0 && !body.endsWith(lineEnding) ? lineEnding : ""}${formattedFieldSource}${end}`;
+  });
+}
 function normalizeInterfaceFieldBlock(source, interfaceName, fieldName, fieldSource, requiredFragments) {
   const interfacePattern = new RegExp(`(export\\s+interface\\s+${escapeRegex(interfaceName)}\\s*\\{\\r?\\n)([\\s\\S]*?)(\\r?\\n\\})`, "u");
   return source.replace(interfacePattern, (match, start, body, end) => {
@@ -172814,6 +173322,25 @@ function updateWorkspaceInventorySource(source, options = {}) {
   nextSource = normalizeInterfaceFieldBlock(nextSource, "WorkspaceAbilityConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD, ["optionalFeatureIds: string[];", "requiredFeatureIds: string[];"]);
   nextSource = ensureInterfaceField(nextSource, "WorkspaceAiFeatureConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD);
   nextSource = normalizeInterfaceFieldBlock(nextSource, "WorkspaceAiFeatureConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD, ["optionalFeatureIds: string[];", "requiredFeatureIds: string[];"]);
+  for (const [fieldName, fieldSource] of [
+    ["auth", "\tauth?: 'authenticated' | 'public' | 'public-write-protected';"],
+    ["bodyTypeName", "\tbodyTypeName?: string;"],
+    ["controllerClass", "\tcontrollerClass?: string;"],
+    ["controllerExtends", "\tcontrollerExtends?: string;"],
+    ["dataFile", "\tdataFile?: string;"],
+    ["method", "\tmethod?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';"],
+    ["mode", "\tmode?: 'generated' | 'manual';"],
+    ["pathPattern", "\tpathPattern?: string;"],
+    ["permissionCallback", "\tpermissionCallback?: string;"],
+    ["phpFile", "\tphpFile?: string;"],
+    ["queryTypeName", "\tqueryTypeName?: string;"],
+    ["responseTypeName", "\tresponseTypeName?: string;"],
+    ["routePattern", "\troutePattern?: string;"],
+    ["secretFieldName", "\tsecretFieldName?: string;"],
+    ["secretStateFieldName", "\tsecretStateFieldName?: string;"]
+  ]) {
+    nextSource = upsertInterfaceField(nextSource, "WorkspaceRestResourceConfig", fieldName, fieldSource);
+  }
   return nextSource;
 }
 async function appendWorkspaceInventoryEntries(projectDir, options) {
@@ -172824,6 +173351,6 @@ async function appendWorkspaceInventoryEntries(projectDir, options) {
     await writeFile(blockConfigPath, nextSource, "utf8");
   }
 }
-export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, REST_RESOURCE_METHOD_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, resolveRestResourceNamespace, assertValidRestResourceMethods, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
+export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, REST_RESOURCE_METHOD_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, MANUAL_REST_CONTRACT_AUTH_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, assertValidTypeScriptIdentifier, resolveRestResourceNamespace, assertValidPostMetaPostType, resolvePostMetaKey, assertValidRestResourceMethods, resolveOptionalPhpCallbackReference, resolveOptionalPhpClassReference, assertValidManualRestContractHttpMethod, assertValidManualRestContractAuth, isGeneratedRestResourceRoutePatternCompatible, resolveManualRestContractPathPattern, resolveGeneratedRestResourceRoutePattern, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, assertValidIntegrationEnvService, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertPostMetaDoesNotExist, assertContractDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
 
-//# debugId=10B8DF3957EF445164756E2164756E21
+//# debugId=E79B1182F12A2D7664756E2164756E21