@wp-typia/project-tools 0.22.9 → 0.23.0

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

@@ -0,0 +1,98 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { isFileNotFoundError } from "./fs-async.js";
+import { parseWorkspaceInventorySource } from "./workspace-inventory-parser.js";
+/**
+ * Synchronously read and parse the canonical workspace inventory file.
+ *
+ * This compatibility helper is intentionally sync-only for callers that expose
+ * 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.
+ */
+export function readWorkspaceInventory(projectDir) {
+    const blockConfigPath = path.join(projectDir, "scripts", "block-config.ts");
+    let source;
+    try {
+        source = readFileSync(blockConfigPath, "utf8");
+    }
+    catch (error) {
+        if (isFileNotFoundError(error)) {
+            throw new Error(`Workspace inventory file is missing at ${blockConfigPath}. Expected scripts/block-config.ts to exist.`);
+        }
+        throw error;
+    }
+    return {
+        blockConfigPath,
+        ...parseWorkspaceInventorySource(source),
+    };
+}
+/**
+ * Asynchronously read and parse the canonical workspace inventory file.
+ *
+ * @param projectDir Workspace root directory.
+ * @returns Parsed `WorkspaceInventory` including the resolved `blockConfigPath`.
+ * @throws {Error} When `scripts/block-config.ts` is missing or invalid.
+ */
+export async function readWorkspaceInventoryAsync(projectDir) {
+    const blockConfigPath = path.join(projectDir, "scripts", "block-config.ts");
+    let source;
+    try {
+        source = await readFile(blockConfigPath, "utf8");
+    }
+    catch (error) {
+        if (isFileNotFoundError(error)) {
+            throw new Error(`Workspace inventory file is missing at ${blockConfigPath}. Expected scripts/block-config.ts to exist.`);
+        }
+        throw error;
+    }
+    return {
+        blockConfigPath,
+        ...parseWorkspaceInventorySource(source),
+    };
+}
+function toWorkspaceBlockSelectOptions(blocks) {
+    return blocks.map((block) => ({
+        description: block.typesFile,
+        name: block.slug,
+        value: block.slug,
+    }));
+}
+/**
+ * Synchronously return select options for the current workspace block inventory.
+ *
+ * The `description` field mirrors `block.typesFile`, while `name` and `value`
+ * both map to the block slug for use in interactive add flows.
+ *
+ * @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.
+ */
+export function getWorkspaceBlockSelectOptions(projectDir) {
+    return toWorkspaceBlockSelectOptions(readWorkspaceInventory(projectDir).blocks);
+}
+/**
+ * Asynchronously return select options for the current workspace block inventory.
+ *
+ * The returned option shape matches `getWorkspaceBlockSelectOptions()` while
+ * avoiding synchronous inventory reads in interactive or async command paths.
+ *
+ * @param projectDir Workspace root directory.
+ * @returns Block options for variation-target selection.
+ */
+export async function getWorkspaceBlockSelectOptionsAsync(projectDir) {
+    return toWorkspaceBlockSelectOptions((await readWorkspaceInventoryAsync(projectDir)).blocks);
+}

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

@@ -0,0 +1,50 @@
+export declare const BLOCK_CONFIG_ENTRY_MARKER = "\t// wp-typia add block entries";
+export declare const VARIATION_CONFIG_ENTRY_MARKER = "\t// wp-typia add variation entries";
+export declare const BLOCK_STYLE_CONFIG_ENTRY_MARKER = "\t// wp-typia add style entries";
+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";
+/**
+ * Marker used to append generated editor-plugin entries into `EDITOR_PLUGINS`.
+ */
+export declare const EDITOR_PLUGIN_CONFIG_ENTRY_MARKER = "\t// wp-typia add editor-plugin entries";
+export declare const VARIATIONS_INTERFACE_SECTION = "\n\nexport interface WorkspaceVariationConfig {\n\tblock: string;\n\tfile: string;\n\tslug: string;\n}\n";
+export declare const VARIATIONS_CONST_SECTION = "\n\nexport const VARIATIONS: WorkspaceVariationConfig[] = [\n\t// wp-typia add variation entries\n];\n";
+export declare const BLOCK_STYLES_INTERFACE_SECTION = "\n\nexport interface WorkspaceBlockStyleConfig {\n\tblock: string;\n\tfile: string;\n\tslug: string;\n}\n";
+export declare const BLOCK_STYLES_CONST_SECTION = "\n\nexport const BLOCK_STYLES: WorkspaceBlockStyleConfig[] = [\n\t// wp-typia add style entries\n];\n";
+export declare const BLOCK_TRANSFORMS_INTERFACE_SECTION = "\n\nexport interface WorkspaceBlockTransformConfig {\n\tblock: string;\n\tfile: string;\n\tfrom: string;\n\tslug: string;\n\tto: string;\n}\n";
+export declare const BLOCK_TRANSFORMS_CONST_SECTION = "\n\nexport const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [\n\t// wp-typia add transform entries\n];\n";
+export declare const PATTERNS_INTERFACE_SECTION = "\n\nexport interface WorkspacePatternConfig {\n\tfile: string;\n\tslug: string;\n}\n";
+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 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";
+export declare const AI_FEATURES_INTERFACE_SECTION = "\n\nexport interface WorkspaceAiFeatureConfig {\n\taiSchemaFile: string;\n\tapiFile: string;\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\tdataFile: string;\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 AI_FEATURES_CONST_SECTION = "\n\nexport const AI_FEATURES: WorkspaceAiFeatureConfig[] = [\n\t// wp-typia add ai-feature entries\n];\n";
+export declare const ADMIN_VIEWS_INTERFACE_SECTION = "\n\nexport interface WorkspaceAdminViewConfig {\n\tfile: string;\n\tphpFile: string;\n\tslug: string;\n\tsource?: string;\n}\n";
+export declare const ADMIN_VIEWS_CONST_SECTION = "\n\nexport const ADMIN_VIEWS: WorkspaceAdminViewConfig[] = [\n\t// wp-typia add admin-view entries\n];\n";
+export declare const EDITOR_PLUGINS_INTERFACE_SECTION = "\n\nexport interface WorkspaceEditorPluginConfig {\n\tfile: string;\n\tslug: string;\n\tslot: string;\n}\n";
+export declare const EDITOR_PLUGINS_CONST_SECTION = "\n\nexport const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [\n\t// wp-typia add editor-plugin entries\n];\n";

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

@@ -0,0 +1,268 @@
+export const BLOCK_CONFIG_ENTRY_MARKER = "\t// wp-typia add block entries";
+export const VARIATION_CONFIG_ENTRY_MARKER = "\t// wp-typia add variation entries";
+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";
+/**
+ * Marker used to append generated editor-plugin entries into `EDITOR_PLUGINS`.
+ */
+export const EDITOR_PLUGIN_CONFIG_ENTRY_MARKER = "\t// wp-typia add editor-plugin entries";
+export const VARIATIONS_INTERFACE_SECTION = `
+
+export interface WorkspaceVariationConfig {
+\tblock: string;
+\tfile: string;
+\tslug: string;
+}
+`;
+export const VARIATIONS_CONST_SECTION = `
+
+export const VARIATIONS: WorkspaceVariationConfig[] = [
+\t// wp-typia add variation entries
+];
+`;
+export const BLOCK_STYLES_INTERFACE_SECTION = `
+
+export interface WorkspaceBlockStyleConfig {
+\tblock: string;
+\tfile: string;
+\tslug: string;
+}
+`;
+export const BLOCK_STYLES_CONST_SECTION = `
+
+export const BLOCK_STYLES: WorkspaceBlockStyleConfig[] = [
+\t// wp-typia add style entries
+];
+`;
+export const BLOCK_TRANSFORMS_INTERFACE_SECTION = `
+
+export interface WorkspaceBlockTransformConfig {
+\tblock: string;
+\tfile: string;
+\tfrom: string;
+\tslug: string;
+\tto: string;
+}
+`;
+export const BLOCK_TRANSFORMS_CONST_SECTION = `
+
+export const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [
+\t// wp-typia add transform entries
+];
+`;
+export const PATTERNS_INTERFACE_SECTION = `
+
+export interface WorkspacePatternConfig {
+\tfile: string;
+\tslug: string;
+}
+`;
+export const PATTERNS_CONST_SECTION = `
+
+export const PATTERNS: WorkspacePatternConfig[] = [
+\t// wp-typia add pattern entries
+];
+`;
+export const BINDING_SOURCES_INTERFACE_SECTION = `
+
+export interface WorkspaceBindingSourceConfig {
+\tattribute?: string;
+\tblock?: string;
+\teditorFile: string;
+\tserverFile: string;
+\tslug: string;
+}
+`;
+export const BINDING_SOURCES_CONST_SECTION = `
+
+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 WorkspaceRestResourceBaseConfig {
+\tapiFile: string;
+\tauth?: 'authenticated' | 'public' | 'public-write-protected';
+\tbodyTypeName?: string;
+\tclientFile: string;
+\tcontrollerClass?: string;
+\tcontrollerExtends?: string;
+\tnamespace: string;
+\topenApiFile: 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 = `
+
+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;
+\t\t\twordpress?: string;
+\t\t};
+\t\tmode: 'baseline' | 'optional' | 'required';
+\t\toptionalFeatureIds: string[];
+\t\toptionalFeatures: string[];
+\t\trequiredFeatureIds: string[];
+\t\trequiredFeatures: string[];
+\t\truntimeGates: string[];
+\t};
+`;
+export const ABILITIES_INTERFACE_SECTION = `
+
+export interface WorkspaceAbilityConfig {
+\tclientFile: string;
+${WORKSPACE_COMPATIBILITY_CONFIG_FIELD}\tconfigFile: string;
+\tdataFile: string;
+\tinputSchemaFile: string;
+\tinputTypeName: string;
+\toutputSchemaFile: string;
+\toutputTypeName: string;
+\tphpFile: string;
+\tslug: string;
+\ttypesFile: string;
+}
+`;
+export const ABILITIES_CONST_SECTION = `
+
+export const ABILITIES: WorkspaceAbilityConfig[] = [
+\t// wp-typia add ability entries
+];
+`;
+export const AI_FEATURES_INTERFACE_SECTION = `
+
+export interface WorkspaceAiFeatureConfig {
+\taiSchemaFile: string;
+\tapiFile: string;
+\tclientFile: string;
+${WORKSPACE_COMPATIBILITY_CONFIG_FIELD}\tdataFile: string;
+\tnamespace: string;
+\topenApiFile: string;
+\tphpFile: string;
+\trestManifest?: ReturnType<
+\t\ttypeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
+\t>;
+\tslug: string;
+\ttypesFile: string;
+\tvalidatorsFile: string;
+}
+`;
+export const AI_FEATURES_CONST_SECTION = `
+
+export const AI_FEATURES: WorkspaceAiFeatureConfig[] = [
+\t// wp-typia add ai-feature entries
+];
+`;
+export const ADMIN_VIEWS_INTERFACE_SECTION = `
+
+export interface WorkspaceAdminViewConfig {
+\tfile: string;
+\tphpFile: string;
+\tslug: string;
+\tsource?: string;
+}
+`;
+export const ADMIN_VIEWS_CONST_SECTION = `
+
+export const ADMIN_VIEWS: WorkspaceAdminViewConfig[] = [
+\t// wp-typia add admin-view entries
+];
+`;
+export const EDITOR_PLUGINS_INTERFACE_SECTION = `
+
+export interface WorkspaceEditorPluginConfig {
+\tfile: string;
+\tslug: string;
+\tslot: string;
+}
+`;
+export const EDITOR_PLUGINS_CONST_SECTION = `
+
+export const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [
+\t// wp-typia add editor-plugin entries
+];
+`;

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

@@ -0,0 +1,220 @@
+export interface WorkspaceBlockInventoryEntry {
+    apiTypesFile?: string;
+    attributeTypeName?: string;
+    openApiFile?: string;
+    slug: string;
+    typesFile: string;
+}
+export interface WorkspaceVariationInventoryEntry {
+    block: string;
+    file: string;
+    slug: string;
+}
+export interface WorkspaceBlockStyleInventoryEntry {
+    block: string;
+    file: string;
+    slug: string;
+}
+export interface WorkspaceBlockTransformInventoryEntry {
+    block: string;
+    file: string;
+    from: string;
+    slug: string;
+    to: string;
+}
+export interface WorkspacePatternInventoryEntry {
+    file: string;
+    slug: string;
+}
+export interface WorkspaceBindingSourceInventoryEntry {
+    attribute?: string;
+    block?: string;
+    editorFile: string;
+    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`.
+ *
+ * Each file path is stored relative to the workspace root so doctor checks and
+ * workspace mutation helpers can resolve the generated TypeScript, OpenAPI, and
+ * PHP route artifacts without guessing their locations.
+ */
+export interface WorkspaceRestResourceInventoryEntry {
+    apiFile: string;
+    auth?: string;
+    bodyTypeName?: string;
+    clientFile: string;
+    controllerClass?: string;
+    controllerExtends?: string;
+    dataFile?: string;
+    method?: string;
+    methods: string[];
+    mode?: "generated" | "manual";
+    namespace: string;
+    openApiFile: 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`.
+ *
+ * Each file path stays relative to the workspace root so doctor checks, schema
+ * sync scripts, and generated admin/editor helpers can resolve typed workflow
+ * artifacts without guessing their locations.
+ */
+export interface WorkspaceAbilityInventoryEntry {
+    clientFile: string;
+    configFile: string;
+    dataFile: string;
+    inputSchemaFile: string;
+    inputTypeName: string;
+    outputSchemaFile: string;
+    outputTypeName: string;
+    phpFile: string;
+    slug: string;
+    typesFile: string;
+}
+/**
+ * AI-feature entry parsed from `scripts/block-config.ts`.
+ *
+ * Each file path stays relative to the workspace root so doctor checks, add
+ * workflows, and split sync scripts can reason about the REST and AI-safe
+ * artifacts without guessing their locations.
+ */
+export interface WorkspaceAiFeatureInventoryEntry {
+    aiSchemaFile: string;
+    apiFile: string;
+    clientFile: string;
+    dataFile: string;
+    namespace: string;
+    openApiFile: string;
+    phpFile: string;
+    slug: string;
+    typesFile: string;
+    validatorsFile: string;
+}
+/**
+ * DataViews admin-screen entry parsed from `scripts/block-config.ts`.
+ *
+ * @property file Relative path to the generated admin view shared entry file.
+ * @property phpFile Relative path to the generated WordPress admin page glue.
+ * @property slug Normalized admin view slug.
+ * @property source Optional source locator such as `rest-resource:products` or
+ * `core-data:postType/post`.
+ */
+export interface WorkspaceAdminViewInventoryEntry {
+    file: string;
+    phpFile: string;
+    slug: string;
+    source?: string;
+}
+/**
+ * Editor-plugin entry parsed from `scripts/block-config.ts`.
+ *
+ * @property file Relative path to the generated editor plugin entry file.
+ * @property slug Normalized editor plugin slug.
+ * @property slot Canonical editor shell slot for the plugin scaffold.
+ */
+export interface WorkspaceEditorPluginInventoryEntry {
+    file: string;
+    slug: string;
+    slot: string;
+}
+export interface WorkspaceInventory {
+    adminViews: WorkspaceAdminViewInventoryEntry[];
+    bindingSources: WorkspaceBindingSourceInventoryEntry[];
+    blockConfigPath: string;
+    blocks: WorkspaceBlockInventoryEntry[];
+    blockStyles: WorkspaceBlockStyleInventoryEntry[];
+    blockTransforms: WorkspaceBlockTransformInventoryEntry[];
+    contracts: WorkspaceContractInventoryEntry[];
+    abilities: WorkspaceAbilityInventoryEntry[];
+    aiFeatures: WorkspaceAiFeatureInventoryEntry[];
+    hasAbilitiesSection: boolean;
+    hasAdminViewsSection: boolean;
+    hasBindingSourcesSection: boolean;
+    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[];
+}
+export type WorkspaceBlockSelectOption = {
+    description: string;
+    name: string;
+    value: string;
+};
+export type WorkspaceInventoryParseResult = Omit<WorkspaceInventory, "blockConfigPath">;
+export type WorkspaceInventoryEntriesKey = {
+    [Key in keyof WorkspaceInventoryParseResult]: WorkspaceInventoryParseResult[Key] extends unknown[] ? Key : never;
+}[keyof WorkspaceInventoryParseResult];
+export type WorkspaceInventorySectionFlagKey = {
+    [Key in keyof WorkspaceInventoryParseResult]: WorkspaceInventoryParseResult[Key] extends boolean ? Key : never;
+}[keyof WorkspaceInventoryParseResult];
+export type WorkspaceInventoryUpdateOptions = {
+    abilityEntries?: string[];
+    adminViewEntries?: string[];
+    aiFeatureEntries?: string[];
+    blockEntries?: string[];
+    blockStyleEntries?: string[];
+    blockTransformEntries?: string[];
+    bindingSourceEntries?: string[];
+    contractEntries?: string[];
+    editorPluginEntries?: string[];
+    patternEntries?: string[];
+    postMetaEntries?: string[];
+    restResourceEntries?: string[];
+    transformSource?: (source: string) => string;
+    variationEntries?: string[];
+};
+export type WorkspaceInventoryAppendOptionKey = Exclude<keyof WorkspaceInventoryUpdateOptions, "transformSource">;

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

@@ -0,0 +1 @@
+export {};