@wp-typia/project-tools 0.22.10 → 0.23.1

package/dist/runtime/workspace-inventory-section-descriptors.js

@@ -0,0 +1,435 @@
+import { MANUAL_REST_CONTRACT_AUTH_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, REST_RESOURCE_METHOD_IDS, } from "./cli-add-shared.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, CONTRACTS_CONST_SECTION, CONTRACTS_INTERFACE_SECTION, CONTRACT_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";
+import { defineInventoryEntryParser, } from "./workspace-inventory-parser-validation.js";
+/**
+ * Descriptor for the required `BLOCKS` inventory section.
+ *
+ * Runtime readers use its `parse` contract to require the exported `BLOCKS`
+ * array and validate required block entry fields; mutation helpers use its
+ * `append` marker to insert generated block entries without duplicating section
+ * knowledge.
+ */
+export const BLOCK_INVENTORY_SECTION = {
+    append: {
+        marker: BLOCK_CONFIG_ENTRY_MARKER,
+        optionKey: "blockEntries",
+    },
+    parse: {
+        entriesKey: "blocks",
+        entry: defineInventoryEntryParser()({
+            entryName: "BLOCKS",
+            fields: [
+                { key: "apiTypesFile" },
+                { key: "attributeTypeName" },
+                { key: "openApiFile" },
+                { key: "slug", required: true },
+                { key: "typesFile", required: true },
+            ],
+        }),
+        exportName: "BLOCKS",
+        required: true,
+    },
+};
+/**
+ * Descriptors for optional workspace inventory sections beyond `BLOCKS`.
+ *
+ * Each descriptor centralizes append markers, exported interface/value repair
+ * sections, parser entry metadata such as `entriesKey` and `entryName`, and
+ * optional section flags so add, doctor, read, and mutation flows share one
+ * runtime contract when adding new inventory domains.
+ */
+export const INVENTORY_SECTIONS = [
+    {
+        append: {
+            marker: VARIATION_CONFIG_ENTRY_MARKER,
+            optionKey: "variationEntries",
+        },
+        interface: {
+            name: "WorkspaceVariationConfig",
+            section: VARIATIONS_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "variations",
+            entry: defineInventoryEntryParser()({
+                entryName: "VARIATIONS",
+                fields: [
+                    { key: "block", required: true },
+                    { key: "file", required: true },
+                    { key: "slug", required: true },
+                ],
+            }),
+            hasSectionKey: "hasVariationsSection",
+        },
+        value: {
+            name: "VARIATIONS",
+            section: VARIATIONS_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: BLOCK_STYLE_CONFIG_ENTRY_MARKER,
+            optionKey: "blockStyleEntries",
+        },
+        interface: {
+            name: "WorkspaceBlockStyleConfig",
+            section: BLOCK_STYLES_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "blockStyles",
+            entry: defineInventoryEntryParser()({
+                entryName: "BLOCK_STYLES",
+                fields: [
+                    { key: "block", required: true },
+                    { key: "file", required: true },
+                    { key: "slug", required: true },
+                ],
+            }),
+            hasSectionKey: "hasBlockStylesSection",
+        },
+        value: {
+            name: "BLOCK_STYLES",
+            section: BLOCK_STYLES_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER,
+            optionKey: "blockTransformEntries",
+        },
+        interface: {
+            name: "WorkspaceBlockTransformConfig",
+            section: BLOCK_TRANSFORMS_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "blockTransforms",
+            entry: defineInventoryEntryParser()({
+                entryName: "BLOCK_TRANSFORMS",
+                fields: [
+                    { key: "block", required: true },
+                    { key: "file", required: true },
+                    { key: "from", required: true },
+                    { key: "slug", required: true },
+                    { key: "to", required: true },
+                ],
+            }),
+            hasSectionKey: "hasBlockTransformsSection",
+        },
+        value: {
+            name: "BLOCK_TRANSFORMS",
+            section: BLOCK_TRANSFORMS_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: PATTERN_CONFIG_ENTRY_MARKER,
+            optionKey: "patternEntries",
+        },
+        interface: {
+            name: "WorkspacePatternConfig",
+            section: PATTERNS_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "patterns",
+            entry: defineInventoryEntryParser()({
+                entryName: "PATTERNS",
+                fields: [
+                    { key: "file", required: true },
+                    { key: "slug", required: true },
+                ],
+            }),
+            hasSectionKey: "hasPatternsSection",
+        },
+        value: {
+            name: "PATTERNS",
+            section: PATTERNS_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: BINDING_SOURCE_CONFIG_ENTRY_MARKER,
+            optionKey: "bindingSourceEntries",
+        },
+        interface: {
+            name: "WorkspaceBindingSourceConfig",
+            section: BINDING_SOURCES_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "bindingSources",
+            entry: defineInventoryEntryParser()({
+                entryName: "BINDING_SOURCES",
+                fields: [
+                    { key: "attribute" },
+                    { key: "block" },
+                    { key: "editorFile", required: true },
+                    { key: "serverFile", required: true },
+                    { key: "slug", required: true },
+                ],
+            }),
+            hasSectionKey: "hasBindingSourcesSection",
+        },
+        value: {
+            name: "BINDING_SOURCES",
+            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,
+            optionKey: "restResourceEntries",
+        },
+        interface: {
+            name: "WorkspaceRestResourceConfig",
+            section: REST_RESOURCES_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "restResources",
+            entry: defineInventoryEntryParser()({
+                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: "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",
+                        required: true,
+                        validate: (value, context) => {
+                            const methods = Array.isArray(value) ? value : [];
+                            const invalidMethods = methods.filter((method) => !REST_RESOURCE_METHOD_IDS.includes(method));
+                            if (invalidMethods.length > 0) {
+                                throw new Error(`${context.entryName}[${context.elementIndex}].${context.key} includes unsupported values: ${invalidMethods.join(", ")}.`);
+                            }
+                        },
+                    },
+                    {
+                        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: "pathPattern" },
+                    { key: "permissionCallback" },
+                    { key: "phpFile" },
+                    { key: "queryTypeName" },
+                    { key: "responseTypeName" },
+                    { key: "routePattern" },
+                    { key: "secretFieldName" },
+                    { key: "secretPreserveOnEmpty", kind: "boolean" },
+                    { key: "secretStateFieldName" },
+                    { key: "slug", required: true },
+                    { key: "typesFile", required: true },
+                    { key: "validatorsFile", required: true },
+                ],
+            }),
+            hasSectionKey: "hasRestResourcesSection",
+        },
+        value: {
+            name: "REST_RESOURCES",
+            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,
+            optionKey: "abilityEntries",
+        },
+        interface: {
+            name: "WorkspaceAbilityConfig",
+            section: ABILITIES_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "abilities",
+            entry: defineInventoryEntryParser()({
+                entryName: "ABILITIES",
+                fields: [
+                    { key: "clientFile", required: true },
+                    { key: "configFile", required: true },
+                    { key: "dataFile", required: true },
+                    { key: "inputSchemaFile", required: true },
+                    { key: "inputTypeName", required: true },
+                    { key: "outputSchemaFile", required: true },
+                    { key: "outputTypeName", required: true },
+                    { key: "phpFile", required: true },
+                    { key: "slug", required: true },
+                    { key: "typesFile", required: true },
+                ],
+            }),
+            hasSectionKey: "hasAbilitiesSection",
+        },
+        value: {
+            name: "ABILITIES",
+            section: ABILITIES_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: AI_FEATURE_CONFIG_ENTRY_MARKER,
+            optionKey: "aiFeatureEntries",
+        },
+        interface: {
+            name: "WorkspaceAiFeatureConfig",
+            section: AI_FEATURES_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "aiFeatures",
+            entry: defineInventoryEntryParser()({
+                entryName: "AI_FEATURES",
+                fields: [
+                    { key: "aiSchemaFile", required: true },
+                    { key: "apiFile", required: true },
+                    { key: "clientFile", required: true },
+                    { key: "dataFile", required: true },
+                    { key: "namespace", required: true },
+                    { key: "openApiFile", required: true },
+                    { key: "phpFile", required: true },
+                    { key: "slug", required: true },
+                    { key: "typesFile", required: true },
+                    { key: "validatorsFile", required: true },
+                ],
+            }),
+            hasSectionKey: "hasAiFeaturesSection",
+        },
+        value: {
+            name: "AI_FEATURES",
+            section: AI_FEATURES_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: ADMIN_VIEW_CONFIG_ENTRY_MARKER,
+            optionKey: "adminViewEntries",
+        },
+        interface: {
+            name: "WorkspaceAdminViewConfig",
+            section: ADMIN_VIEWS_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "adminViews",
+            entry: defineInventoryEntryParser()({
+                entryName: "ADMIN_VIEWS",
+                fields: [
+                    { key: "file", required: true },
+                    { key: "phpFile", required: true },
+                    { key: "slug", required: true },
+                    { key: "source" },
+                ],
+            }),
+            hasSectionKey: "hasAdminViewsSection",
+        },
+        value: {
+            name: "ADMIN_VIEWS",
+            section: ADMIN_VIEWS_CONST_SECTION,
+        },
+    },
+    {
+        append: {
+            marker: EDITOR_PLUGIN_CONFIG_ENTRY_MARKER,
+            optionKey: "editorPluginEntries",
+        },
+        interface: {
+            name: "WorkspaceEditorPluginConfig",
+            section: EDITOR_PLUGINS_INTERFACE_SECTION,
+        },
+        parse: {
+            entriesKey: "editorPlugins",
+            entry: defineInventoryEntryParser()({
+                entryName: "EDITOR_PLUGINS",
+                fields: [
+                    { key: "file", required: true },
+                    { key: "slug", required: true },
+                    { key: "slot", required: true },
+                ],
+            }),
+            hasSectionKey: "hasEditorPluginsSection",
+        },
+        value: {
+            name: "EDITOR_PLUGINS",
+            section: EDITOR_PLUGINS_CONST_SECTION,
+        },
+    },
+];

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\tsecretPreserveOnEmpty?: boolean;\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,64 @@ 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;
+\tsecretPreserveOnEmpty?: boolean;
+\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 +155,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,47 @@ 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;
+    secretPreserveOnEmpty?: boolean;
+    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 +168,7 @@ export interface WorkspaceInventory {
     blocks: WorkspaceBlockInventoryEntry[];
     blockStyles: WorkspaceBlockStyleInventoryEntry[];
     blockTransforms: WorkspaceBlockTransformInventoryEntry[];
+    contracts: WorkspaceContractInventoryEntry[];
     abilities: WorkspaceAbilityInventoryEntry[];
     aiFeatures: WorkspaceAiFeatureInventoryEntry[];
     hasAbilitiesSection: boolean;
@@ -132,12 +177,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 +210,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[];