@wp-typia/project-tools 0.22.10 → 0.23.0

package/dist/runtime/workspace-inventory-mutations.js

@@ -7,7 +7,7 @@ function ensureWorkspaceInventorySections(source) {
     let nextSource = source.trimEnd();
     for (const section of INVENTORY_SECTIONS) {
         if (section.interface &&
-            !hasExportedInterface(nextSource, section.interface.name)) {
+            !hasExportedTypeDeclaration(nextSource, section.interface.name)) {
             nextSource += section.interface.section;
         }
         if (section.value && !hasExportedConst(nextSource, section.value.name)) {
@@ -16,8 +16,8 @@ function ensureWorkspaceInventorySections(source) {
     }
     return `${nextSource}\n`;
 }
-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);
@@ -67,6 +67,36 @@ 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\n") ? "\r\n" : "\n";
+        const formattedFieldSource = `${fieldSource
+            .replace(/\r?\n$/u, "")
+            .split("\n")
+            .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) => {
@@ -112,6 +142,25 @@ export 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;
 }
 /**

package/dist/runtime/workspace-inventory-parser.d.ts

@@ -1,4 +1,5 @@
 import type { WorkspaceInventory, WorkspaceInventoryAppendOptionKey, WorkspaceInventoryEntriesKey, WorkspaceInventorySectionFlagKey } from "./workspace-inventory-types.js";
+type InventoryEntryFieldValue = string | string[] | boolean | undefined;
 type InventoryEntryFieldValidationContext = {
     elementIndex: number;
     entryName: string;
@@ -6,9 +7,9 @@ type InventoryEntryFieldValidationContext = {
 };
 type InventoryEntryFieldDescriptor = {
     key: string;
-    kind?: "string" | "stringArray";
+    kind?: "boolean" | "string" | "stringArray";
     required?: boolean;
-    validate?: (value: string | string[] | undefined, context: InventoryEntryFieldValidationContext) => void;
+    validate?: (value: InventoryEntryFieldValue, context: InventoryEntryFieldValidationContext) => void;
 };
 type InventoryEntryParserDescriptor = {
     entryName: string;

package/dist/runtime/workspace-inventory-parser.js

@@ -1,7 +1,7 @@
 import ts from "typescript";
-import { REST_RESOURCE_METHOD_IDS } from "./cli-add-shared.js";
+import { MANUAL_REST_CONTRACT_AUTH_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, REST_RESOURCE_METHOD_IDS, } from "./cli-add-shared.js";
 import { getPropertyNameText } from "./ts-property-names.js";
-import { ABILITY_CONFIG_ENTRY_MARKER, ABILITIES_CONST_SECTION, ABILITIES_INTERFACE_SECTION, ADMIN_VIEW_CONFIG_ENTRY_MARKER, ADMIN_VIEWS_CONST_SECTION, ADMIN_VIEWS_INTERFACE_SECTION, AI_FEATURES_CONST_SECTION, AI_FEATURES_INTERFACE_SECTION, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCES_CONST_SECTION, BINDING_SOURCES_INTERFACE_SECTION, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLES_CONST_SECTION, BLOCK_STYLES_INTERFACE_SECTION, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORMS_CONST_SECTION, BLOCK_TRANSFORMS_INTERFACE_SECTION, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, EDITOR_PLUGINS_CONST_SECTION, EDITOR_PLUGINS_INTERFACE_SECTION, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERNS_CONST_SECTION, PATTERNS_INTERFACE_SECTION, PATTERN_CONFIG_ENTRY_MARKER, REST_RESOURCES_CONST_SECTION, REST_RESOURCES_INTERFACE_SECTION, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATIONS_CONST_SECTION, VARIATIONS_INTERFACE_SECTION, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
+import { ABILITY_CONFIG_ENTRY_MARKER, ABILITIES_CONST_SECTION, ABILITIES_INTERFACE_SECTION, ADMIN_VIEW_CONFIG_ENTRY_MARKER, ADMIN_VIEWS_CONST_SECTION, ADMIN_VIEWS_INTERFACE_SECTION, AI_FEATURES_CONST_SECTION, AI_FEATURES_INTERFACE_SECTION, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCES_CONST_SECTION, BINDING_SOURCES_INTERFACE_SECTION, BINDING_SOURCE_CONFIG_ENTRY_MARKER, CONTRACTS_CONST_SECTION, CONTRACTS_INTERFACE_SECTION, CONTRACT_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLES_CONST_SECTION, BLOCK_STYLES_INTERFACE_SECTION, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORMS_CONST_SECTION, BLOCK_TRANSFORMS_INTERFACE_SECTION, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, EDITOR_PLUGINS_CONST_SECTION, EDITOR_PLUGINS_INTERFACE_SECTION, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERNS_CONST_SECTION, PATTERNS_INTERFACE_SECTION, PATTERN_CONFIG_ENTRY_MARKER, POST_META_CONFIG_ENTRY_MARKER, POST_META_CONST_SECTION, POST_META_INTERFACE_SECTION, REST_RESOURCES_CONST_SECTION, REST_RESOURCES_INTERFACE_SECTION, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATIONS_CONST_SECTION, VARIATIONS_INTERFACE_SECTION, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
 function defineInventoryEntryParser() {
     return (descriptor) => descriptor;
 }
@@ -160,6 +160,33 @@ export const 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,
@@ -175,8 +202,29 @@ export const 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",
@@ -189,9 +237,26 @@ export const 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 },
@@ -204,6 +269,37 @@ export const 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,
@@ -392,6 +488,25 @@ function getOptionalStringArrayProperty(entryName, elementIndex, objectLiteral,
     }
     return undefined;
 }
+function getOptionalBooleanProperty(entryName, elementIndex, objectLiteral, key) {
+    for (const property of objectLiteral.properties) {
+        if (!ts.isPropertyAssignment(property)) {
+            continue;
+        }
+        const propertyName = getPropertyNameText(property.name);
+        if (propertyName !== key) {
+            continue;
+        }
+        if (property.initializer.kind === ts.SyntaxKind.TrueKeyword) {
+            return true;
+        }
+        if (property.initializer.kind === ts.SyntaxKind.FalseKeyword) {
+            return false;
+        }
+        throw new Error(`${entryName}[${elementIndex}] must use a boolean literal for "${key}" in scripts/block-config.ts.`);
+    }
+    return undefined;
+}
 function isMissingRequiredInventoryValue(value) {
     return (value === undefined || (typeof value === "string" && value.length === 0));
 }
@@ -419,7 +534,9 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
             const kind = field.kind ?? "string";
             const value = kind === "stringArray"
                 ? getOptionalStringArrayProperty(descriptor.entryName, elementIndex, element, field.key)
-                : getOptionalStringProperty(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,
@@ -480,6 +597,7 @@ export function parseWorkspaceInventorySource(source) {
         blockStyles: [],
         blockTransforms: [],
         blocks: parseInventorySection(sourceFile, BLOCK_INVENTORY_SECTION).entries,
+        contracts: [],
         editorPlugins: [],
         hasAbilitiesSection: false,
         hasAdminViewsSection: false,
@@ -487,11 +605,14 @@ export 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: [],

package/dist/runtime/workspace-inventory-read.d.ts

@@ -6,6 +6,11 @@ import type { WorkspaceBlockSelectOption, WorkspaceInventory } from "./workspace
  * synchronous APIs. Prefer `readWorkspaceInventoryAsync()` from async command
  * paths so workspace reads do not block the event loop.
  *
+ * @deprecated Since 0.22.10. Use `readWorkspaceInventoryAsync()` from async
+ * command paths. Removal target: not currently scheduled; this sync
+ * compatibility helper remains available until release notes announce a
+ * versioned target.
+ *
  * @param projectDir Workspace root directory.
  * @returns Parsed `WorkspaceInventory` including the resolved `blockConfigPath`.
  * @throws {Error} When `scripts/block-config.ts` is missing or invalid.
@@ -25,8 +30,10 @@ export declare function readWorkspaceInventoryAsync(projectDir: string): Promise
  * The `description` field mirrors `block.typesFile`, while `name` and `value`
  * both map to the block slug for use in interactive add flows.
  *
- * @deprecated Use `getWorkspaceBlockSelectOptionsAsync()` from async command
- * paths. This helper intentionally remains sync-only for compatibility callers.
+ * @deprecated Since 0.22.10. Use `getWorkspaceBlockSelectOptionsAsync()` from
+ * async command paths. Removal target: not currently scheduled; this sync
+ * compatibility helper remains available until release notes announce a
+ * versioned target.
  *
  * @param projectDir Workspace root directory.
  * @returns Block options for variation-target selection.

package/dist/runtime/workspace-inventory-read.js

@@ -10,6 +10,11 @@ import { parseWorkspaceInventorySource } from "./workspace-inventory-parser.js";
  * synchronous APIs. Prefer `readWorkspaceInventoryAsync()` from async command
  * paths so workspace reads do not block the event loop.
  *
+ * @deprecated Since 0.22.10. Use `readWorkspaceInventoryAsync()` from async
+ * command paths. Removal target: not currently scheduled; this sync
+ * compatibility helper remains available until release notes announce a
+ * versioned target.
+ *
  * @param projectDir Workspace root directory.
  * @returns Parsed `WorkspaceInventory` including the resolved `blockConfigPath`.
  * @throws {Error} When `scripts/block-config.ts` is missing or invalid.
@@ -68,8 +73,10 @@ function toWorkspaceBlockSelectOptions(blocks) {
  * The `description` field mirrors `block.typesFile`, while `name` and `value`
  * both map to the block slug for use in interactive add flows.
  *
- * @deprecated Use `getWorkspaceBlockSelectOptionsAsync()` from async command
- * paths. This helper intentionally remains sync-only for compatibility callers.
+ * @deprecated Since 0.22.10. Use `getWorkspaceBlockSelectOptionsAsync()` from
+ * async command paths. Removal target: not currently scheduled; this sync
+ * compatibility helper remains available until release notes announce a
+ * versioned target.
  *
  * @param projectDir Workspace root directory.
  * @returns Block options for variation-target selection.

package/dist/runtime/workspace-inventory-templates.d.ts

@@ -4,7 +4,12 @@ export declare const BLOCK_STYLE_CONFIG_ENTRY_MARKER = "\t// wp-typia add style
 export declare const BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER = "\t// wp-typia add transform entries";
 export declare const PATTERN_CONFIG_ENTRY_MARKER = "\t// wp-typia add pattern entries";
 export declare const BINDING_SOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add binding-source entries";
+export declare const CONTRACT_CONFIG_ENTRY_MARKER = "\t// wp-typia add contract entries";
 export declare const REST_RESOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add rest-resource entries";
+/**
+ * Marker used to append generated post-meta entries into `POST_META`.
+ */
+export declare const POST_META_CONFIG_ENTRY_MARKER = "\t// wp-typia add post-meta entries";
 export declare const ABILITY_CONFIG_ENTRY_MARKER = "\t// wp-typia add ability entries";
 export declare const AI_FEATURE_CONFIG_ENTRY_MARKER = "\t// wp-typia add ai-feature entries";
 export declare const ADMIN_VIEW_CONFIG_ENTRY_MARKER = "\t// wp-typia add admin-view entries";
@@ -22,8 +27,18 @@ export declare const PATTERNS_INTERFACE_SECTION = "\n\nexport interface Workspac
 export declare const PATTERNS_CONST_SECTION = "\n\nexport const PATTERNS: WorkspacePatternConfig[] = [\n\t// wp-typia add pattern entries\n];\n";
 export declare const BINDING_SOURCES_INTERFACE_SECTION = "\n\nexport interface WorkspaceBindingSourceConfig {\n\tattribute?: string;\n\tblock?: string;\n\teditorFile: string;\n\tserverFile: string;\n\tslug: string;\n}\n";
 export declare const BINDING_SOURCES_CONST_SECTION = "\n\nexport const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [\n\t// wp-typia add binding-source entries\n];\n";
-export declare const REST_RESOURCES_INTERFACE_SECTION = "\n\nexport interface WorkspaceRestResourceConfig {\n\tapiFile: string;\n\tclientFile: string;\n\tdataFile: string;\n\tmethods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;\n\tnamespace: string;\n\topenApiFile: string;\n\tphpFile: string;\n\trestManifest?: ReturnType<\n\t\ttypeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest\n\t>;\n\tslug: string;\n\ttypesFile: string;\n\tvalidatorsFile: string;\n}\n";
+export declare const CONTRACTS_INTERFACE_SECTION = "\n\nexport interface WorkspaceContractConfig {\n\tschemaFile: string;\n\tslug: string;\n\tsourceTypeName: string;\n\ttypesFile: string;\n}\n";
+export declare const CONTRACTS_CONST_SECTION = "\n\nexport const CONTRACTS: WorkspaceContractConfig[] = [\n\t// wp-typia add contract entries\n];\n";
+export declare const REST_RESOURCES_INTERFACE_SECTION = "\n\nexport interface WorkspaceRestResourceBaseConfig {\n\tapiFile: string;\n\tauth?: 'authenticated' | 'public' | 'public-write-protected';\n\tbodyTypeName?: string;\n\tclientFile: string;\n\tcontrollerClass?: string;\n\tcontrollerExtends?: string;\n\tnamespace: string;\n\topenApiFile: string;\n\tpermissionCallback?: string;\n\trestManifest?: ReturnType<\n\t\ttypeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest\n\t>;\n\tsecretFieldName?: string;\n\tsecretStateFieldName?: string;\n\tslug: string;\n\ttypesFile: string;\n\tvalidatorsFile: string;\n}\n\nexport interface GeneratedWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {\n\tdataFile: string;\n\tmethods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;\n\tmode?: 'generated';\n\tphpFile: string;\n\troutePattern?: string;\n}\n\nexport interface ManualWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {\n\tmethod: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';\n\tmethods: [];\n\tmode: 'manual';\n\tpathPattern: string;\n\tqueryTypeName: string;\n\tresponseTypeName: string;\n}\n\nexport type WorkspaceRestResourceConfig =\n\t| GeneratedWorkspaceRestResourceConfig\n\t| ManualWorkspaceRestResourceConfig;\n";
 export declare const REST_RESOURCES_CONST_SECTION = "\n\nexport const REST_RESOURCES: WorkspaceRestResourceConfig[] = [\n\t// wp-typia add rest-resource entries\n];\n";
+/**
+ * Template inserted when repairing `WorkspacePostMetaConfig` in block-config.
+ */
+export declare const POST_META_INTERFACE_SECTION = "\n\nexport interface WorkspacePostMetaConfig {\n\tmetaKey: string;\n\tphpFile: string;\n\tpostType: string;\n\tschemaFile: string;\n\tshowInRest: boolean;\n\tslug: string;\n\tsourceTypeName: string;\n\ttypesFile: string;\n}\n";
+/**
+ * Template inserted when repairing the `POST_META` inventory array.
+ */
+export declare const POST_META_CONST_SECTION = "\n\nexport const POST_META: WorkspacePostMetaConfig[] = [\n\t// wp-typia add post-meta entries\n];\n";
 export declare const WORKSPACE_COMPATIBILITY_CONFIG_FIELD = "\tcompatibility?: {\n\t\thardMinimums: {\n\t\t\tphp?: string;\n\t\t\twordpress?: string;\n\t\t};\n\t\tmode: 'baseline' | 'optional' | 'required';\n\t\toptionalFeatureIds: string[];\n\t\toptionalFeatures: string[];\n\t\trequiredFeatureIds: string[];\n\t\trequiredFeatures: string[];\n\t\truntimeGates: string[];\n\t};\n";
 export declare const ABILITIES_INTERFACE_SECTION = "\n\nexport interface WorkspaceAbilityConfig {\n\tclientFile: string;\n\tcompatibility?: {\n\t\thardMinimums: {\n\t\t\tphp?: string;\n\t\t\twordpress?: string;\n\t\t};\n\t\tmode: 'baseline' | 'optional' | 'required';\n\t\toptionalFeatureIds: string[];\n\t\toptionalFeatures: string[];\n\t\trequiredFeatureIds: string[];\n\t\trequiredFeatures: string[];\n\t\truntimeGates: string[];\n\t};\n\tconfigFile: string;\n\tdataFile: string;\n\tinputSchemaFile: string;\n\tinputTypeName: string;\n\toutputSchemaFile: string;\n\toutputTypeName: string;\n\tphpFile: string;\n\tslug: string;\n\ttypesFile: string;\n}\n";
 export declare const ABILITIES_CONST_SECTION = "\n\nexport const ABILITIES: WorkspaceAbilityConfig[] = [\n\t// wp-typia add ability entries\n];\n";

package/dist/runtime/workspace-inventory-templates.js

@@ -4,7 +4,12 @@ export const BLOCK_STYLE_CONFIG_ENTRY_MARKER = "\t// wp-typia add style entries"
 export const BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER = "\t// wp-typia add transform entries";
 export const PATTERN_CONFIG_ENTRY_MARKER = "\t// wp-typia add pattern entries";
 export const BINDING_SOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add binding-source entries";
+export const CONTRACT_CONFIG_ENTRY_MARKER = "\t// wp-typia add contract entries";
 export const REST_RESOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add rest-resource entries";
+/**
+ * Marker used to append generated post-meta entries into `POST_META`.
+ */
+export const POST_META_CONFIG_ENTRY_MARKER = "\t// wp-typia add post-meta entries";
 export const ABILITY_CONFIG_ENTRY_MARKER = "\t// wp-typia add ability entries";
 export const AI_FEATURE_CONFIG_ENTRY_MARKER = "\t// wp-typia add ai-feature entries";
 export const ADMIN_VIEW_CONFIG_ENTRY_MARKER = "\t// wp-typia add admin-view entries";
@@ -85,23 +90,63 @@ export const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [
 \t// wp-typia add binding-source entries
 ];
 `;
+export const CONTRACTS_INTERFACE_SECTION = `
+
+export interface WorkspaceContractConfig {
+\tschemaFile: string;
+\tslug: string;
+\tsourceTypeName: string;
+\ttypesFile: string;
+}
+`;
+export const CONTRACTS_CONST_SECTION = `
+
+export const CONTRACTS: WorkspaceContractConfig[] = [
+\t// wp-typia add contract entries
+];
+`;
 export const REST_RESOURCES_INTERFACE_SECTION = `
 
-export interface WorkspaceRestResourceConfig {
+export interface WorkspaceRestResourceBaseConfig {
 \tapiFile: string;
+\tauth?: 'authenticated' | 'public' | 'public-write-protected';
+\tbodyTypeName?: string;
 \tclientFile: string;
-\tdataFile: string;
-\tmethods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
+\tcontrollerClass?: string;
+\tcontrollerExtends?: string;
 \tnamespace: string;
 \topenApiFile: string;
-\tphpFile: string;
+\tpermissionCallback?: string;
 \trestManifest?: ReturnType<
 \t\ttypeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
 \t>;
+\tsecretFieldName?: string;
+\tsecretStateFieldName?: string;
 \tslug: string;
 \ttypesFile: string;
 \tvalidatorsFile: string;
 }
+
+export interface GeneratedWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {
+\tdataFile: string;
+\tmethods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
+\tmode?: 'generated';
+\tphpFile: string;
+\troutePattern?: string;
+}
+
+export interface ManualWorkspaceRestResourceConfig extends WorkspaceRestResourceBaseConfig {
+\tmethod: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+\tmethods: [];
+\tmode: 'manual';
+\tpathPattern: string;
+\tqueryTypeName: string;
+\tresponseTypeName: string;
+}
+
+export type WorkspaceRestResourceConfig =
+\t| GeneratedWorkspaceRestResourceConfig
+\t| ManualWorkspaceRestResourceConfig;
 `;
 export const REST_RESOURCES_CONST_SECTION = `
 
@@ -109,6 +154,31 @@ export const REST_RESOURCES: WorkspaceRestResourceConfig[] = [
 \t// wp-typia add rest-resource entries
 ];
 `;
+/**
+ * Template inserted when repairing `WorkspacePostMetaConfig` in block-config.
+ */
+export const POST_META_INTERFACE_SECTION = `
+
+export interface WorkspacePostMetaConfig {
+\tmetaKey: string;
+\tphpFile: string;
+\tpostType: string;
+\tschemaFile: string;
+\tshowInRest: boolean;
+\tslug: string;
+\tsourceTypeName: string;
+\ttypesFile: string;
+}
+`;
+/**
+ * Template inserted when repairing the `POST_META` inventory array.
+ */
+export const POST_META_CONST_SECTION = `
+
+export const POST_META: WorkspacePostMetaConfig[] = [
+\t// wp-typia add post-meta entries
+];
+`;
 export const WORKSPACE_COMPATIBILITY_CONFIG_FIELD = `\tcompatibility?: {
 \t\thardMinimums: {
 \t\t\tphp?: string;

package/dist/runtime/workspace-inventory-types.d.ts

@@ -33,6 +33,19 @@ export interface WorkspaceBindingSourceInventoryEntry {
     serverFile: string;
     slug: string;
 }
+/**
+ * Standalone TypeScript contract entry parsed from `scripts/block-config.ts`.
+ *
+ * These contracts generate JSON Schema artifacts without owning a WordPress REST
+ * route, so smoke tests and external integrations can reference stable schema
+ * names from the workspace inventory.
+ */
+export interface WorkspaceContractInventoryEntry {
+    schemaFile: string;
+    slug: string;
+    sourceTypeName: string;
+    typesFile: string;
+}
 /**
  * REST-resource entry parsed from `scripts/block-config.ts`.
  *
@@ -42,16 +55,46 @@ export interface WorkspaceBindingSourceInventoryEntry {
  */
 export interface WorkspaceRestResourceInventoryEntry {
     apiFile: string;
+    auth?: string;
+    bodyTypeName?: string;
     clientFile: string;
-    dataFile: string;
+    controllerClass?: string;
+    controllerExtends?: string;
+    dataFile?: string;
+    method?: string;
     methods: string[];
+    mode?: "generated" | "manual";
     namespace: string;
     openApiFile: string;
-    phpFile: string;
+    pathPattern?: string;
+    permissionCallback?: string;
+    phpFile?: string;
+    queryTypeName?: string;
+    responseTypeName?: string;
+    routePattern?: string;
+    secretFieldName?: string;
+    secretStateFieldName?: string;
     slug: string;
     typesFile: string;
     validatorsFile: string;
 }
+/**
+ * Post-meta contract entry parsed from `scripts/block-config.ts`.
+ *
+ * The TypeScript source and schema artifact define the persisted meta value
+ * shape, while the PHP file registers the matching WordPress post-meta key for
+ * the declared post type scope.
+ */
+export interface WorkspacePostMetaInventoryEntry {
+    metaKey: string;
+    phpFile: string;
+    postType: string;
+    schemaFile: string;
+    showInRest: boolean;
+    slug: string;
+    sourceTypeName: string;
+    typesFile: string;
+}
 /**
  * Ability entry parsed from `scripts/block-config.ts`.
  *
@@ -124,6 +167,7 @@ export interface WorkspaceInventory {
     blocks: WorkspaceBlockInventoryEntry[];
     blockStyles: WorkspaceBlockStyleInventoryEntry[];
     blockTransforms: WorkspaceBlockTransformInventoryEntry[];
+    contracts: WorkspaceContractInventoryEntry[];
     abilities: WorkspaceAbilityInventoryEntry[];
     aiFeatures: WorkspaceAiFeatureInventoryEntry[];
     hasAbilitiesSection: boolean;
@@ -132,12 +176,15 @@ export interface WorkspaceInventory {
     hasAiFeaturesSection: boolean;
     hasBlockStylesSection: boolean;
     hasBlockTransformsSection: boolean;
+    hasContractsSection: boolean;
     hasEditorPluginsSection: boolean;
     hasPatternsSection: boolean;
+    hasPostMetaSection: boolean;
     hasRestResourcesSection: boolean;
     hasVariationsSection: boolean;
     editorPlugins: WorkspaceEditorPluginInventoryEntry[];
     patterns: WorkspacePatternInventoryEntry[];
+    postMeta: WorkspacePostMetaInventoryEntry[];
     restResources: WorkspaceRestResourceInventoryEntry[];
     source: string;
     variations: WorkspaceVariationInventoryEntry[];
@@ -162,8 +209,10 @@ export type WorkspaceInventoryUpdateOptions = {
     blockStyleEntries?: string[];
     blockTransformEntries?: string[];
     bindingSourceEntries?: string[];
+    contractEntries?: string[];
     editorPluginEntries?: string[];
     patternEntries?: string[];
+    postMetaEntries?: string[];
     restResourceEntries?: string[];
     transformSource?: (source: string) => string;
     variationEntries?: string[];

package/dist/runtime/workspace-inventory.d.ts

@@ -1,5 +1,5 @@
-export { ABILITY_CONFIG_ENTRY_MARKER, ADMIN_VIEW_CONFIG_ENTRY_MARKER, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERN_CONFIG_ENTRY_MARKER, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
+export { ABILITY_CONFIG_ENTRY_MARKER, ADMIN_VIEW_CONFIG_ENTRY_MARKER, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, CONTRACT_CONFIG_ENTRY_MARKER, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERN_CONFIG_ENTRY_MARKER, POST_META_CONFIG_ENTRY_MARKER, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
 export { parseWorkspaceInventorySource } from "./workspace-inventory-parser.js";
 export { getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, readWorkspaceInventory, readWorkspaceInventoryAsync, } from "./workspace-inventory-read.js";
 export { appendWorkspaceInventoryEntries, updateWorkspaceInventorySource, } from "./workspace-inventory-mutations.js";
-export type { WorkspaceAbilityInventoryEntry, WorkspaceAdminViewInventoryEntry, WorkspaceAiFeatureInventoryEntry, WorkspaceBindingSourceInventoryEntry, WorkspaceBlockInventoryEntry, WorkspaceBlockSelectOption, WorkspaceBlockStyleInventoryEntry, WorkspaceBlockTransformInventoryEntry, WorkspaceEditorPluginInventoryEntry, WorkspaceInventory, WorkspacePatternInventoryEntry, WorkspaceRestResourceInventoryEntry, WorkspaceVariationInventoryEntry, } from "./workspace-inventory-types.js";
+export type { WorkspaceAbilityInventoryEntry, WorkspaceAdminViewInventoryEntry, WorkspaceAiFeatureInventoryEntry, WorkspaceBindingSourceInventoryEntry, WorkspaceBlockInventoryEntry, WorkspaceBlockSelectOption, WorkspaceBlockStyleInventoryEntry, WorkspaceBlockTransformInventoryEntry, WorkspaceContractInventoryEntry, WorkspaceEditorPluginInventoryEntry, WorkspaceInventory, WorkspacePatternInventoryEntry, WorkspacePostMetaInventoryEntry, WorkspaceRestResourceInventoryEntry, WorkspaceVariationInventoryEntry, } from "./workspace-inventory-types.js";

package/dist/runtime/workspace-inventory.js

@@ -1,4 +1,4 @@
-export { ABILITY_CONFIG_ENTRY_MARKER, ADMIN_VIEW_CONFIG_ENTRY_MARKER, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERN_CONFIG_ENTRY_MARKER, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
+export { ABILITY_CONFIG_ENTRY_MARKER, ADMIN_VIEW_CONFIG_ENTRY_MARKER, AI_FEATURE_CONFIG_ENTRY_MARKER, BINDING_SOURCE_CONFIG_ENTRY_MARKER, BLOCK_CONFIG_ENTRY_MARKER, BLOCK_STYLE_CONFIG_ENTRY_MARKER, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, CONTRACT_CONFIG_ENTRY_MARKER, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, PATTERN_CONFIG_ENTRY_MARKER, POST_META_CONFIG_ENTRY_MARKER, REST_RESOURCE_CONFIG_ENTRY_MARKER, VARIATION_CONFIG_ENTRY_MARKER, } from "./workspace-inventory-templates.js";
 export { parseWorkspaceInventorySource } from "./workspace-inventory-parser.js";
 export { getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, readWorkspaceInventory, readWorkspaceInventoryAsync, } from "./workspace-inventory-read.js";
 export { appendWorkspaceInventoryEntries, updateWorkspaceInventorySource, } from "./workspace-inventory-mutations.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.22.10",
+  "version": "0.23.0",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -161,7 +161,7 @@
   },
   "dependencies": {
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/block-runtime": "^0.5.1",
+    "@wp-typia/block-runtime": "^0.6.0",
     "@wp-typia/rest": "^0.3.13",
     "@wp-typia/block-types": "^0.2.4",
     "mustache": "^4.2.0",