@wp-typia/project-tools 0.22.9 → 0.23.0

package/dist/runtime/workspace-inventory.js

@@ -1,928 +1,4 @@
-import { readFileSync } from "node:fs";
-import path from "node:path";
-import { readFile, writeFile } from "node:fs/promises";
-import ts from "typescript";
-import { REST_RESOURCE_METHOD_IDS } from "./cli-add-shared.js";
-import { escapeRegex } from "./php-utils.js";
-import { getPropertyNameText } from "./ts-property-names.js";
-function defineInventoryEntryParser() {
-    return (descriptor) => descriptor;
-}
-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 REST_RESOURCE_CONFIG_ENTRY_MARKER = "\t// wp-typia add rest-resource 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";
-const VARIATIONS_INTERFACE_SECTION = `
-
-export interface WorkspaceVariationConfig {
-\tblock: string;
-\tfile: string;
-\tslug: string;
-}
-`;
-const VARIATIONS_CONST_SECTION = `
-
-export const VARIATIONS: WorkspaceVariationConfig[] = [
-\t// wp-typia add variation entries
-];
-`;
-const BLOCK_STYLES_INTERFACE_SECTION = `
-
-export interface WorkspaceBlockStyleConfig {
-\tblock: string;
-\tfile: string;
-\tslug: string;
-}
-`;
-const BLOCK_STYLES_CONST_SECTION = `
-
-export const BLOCK_STYLES: WorkspaceBlockStyleConfig[] = [
-\t// wp-typia add style entries
-];
-`;
-const BLOCK_TRANSFORMS_INTERFACE_SECTION = `
-
-export interface WorkspaceBlockTransformConfig {
-\tblock: string;
-\tfile: string;
-\tfrom: string;
-\tslug: string;
-\tto: string;
-}
-`;
-const BLOCK_TRANSFORMS_CONST_SECTION = `
-
-export const BLOCK_TRANSFORMS: WorkspaceBlockTransformConfig[] = [
-\t// wp-typia add transform entries
-];
-`;
-const PATTERNS_INTERFACE_SECTION = `
-
-export interface WorkspacePatternConfig {
-\tfile: string;
-\tslug: string;
-}
-`;
-const PATTERNS_CONST_SECTION = `
-
-export const PATTERNS: WorkspacePatternConfig[] = [
-\t// wp-typia add pattern entries
-];
-`;
-const BINDING_SOURCES_INTERFACE_SECTION = `
-
-export interface WorkspaceBindingSourceConfig {
-\tattribute?: string;
-\tblock?: string;
-\teditorFile: string;
-\tserverFile: string;
-\tslug: string;
-}
-`;
-const BINDING_SOURCES_CONST_SECTION = `
-
-export const BINDING_SOURCES: WorkspaceBindingSourceConfig[] = [
-\t// wp-typia add binding-source entries
-];
-`;
-const REST_RESOURCES_INTERFACE_SECTION = `
-
-export interface WorkspaceRestResourceConfig {
-\tapiFile: string;
-\tclientFile: string;
-\tdataFile: string;
-\tmethods: Array< 'list' | 'read' | 'create' | 'update' | 'delete' >;
-\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;
-}
-`;
-const REST_RESOURCES_CONST_SECTION = `
-
-export const REST_RESOURCES: WorkspaceRestResourceConfig[] = [
-\t// wp-typia add rest-resource entries
-];
-`;
-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};
-`;
-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;
-}
-`;
-const ABILITIES_CONST_SECTION = `
-
-export const ABILITIES: WorkspaceAbilityConfig[] = [
-\t// wp-typia add ability entries
-];
-`;
-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;
-}
-`;
-const AI_FEATURES_CONST_SECTION = `
-
-export const AI_FEATURES: WorkspaceAiFeatureConfig[] = [
-\t// wp-typia add ai-feature entries
-];
-`;
-const ADMIN_VIEWS_INTERFACE_SECTION = `
-
-export interface WorkspaceAdminViewConfig {
-\tfile: string;
-\tphpFile: string;
-\tslug: string;
-\tsource?: string;
-}
-`;
-const ADMIN_VIEWS_CONST_SECTION = `
-
-export const ADMIN_VIEWS: WorkspaceAdminViewConfig[] = [
-\t// wp-typia add admin-view entries
-];
-`;
-const EDITOR_PLUGINS_INTERFACE_SECTION = `
-
-export interface WorkspaceEditorPluginConfig {
-\tfile: string;
-\tslug: string;
-\tslot: string;
-}
-`;
-const EDITOR_PLUGINS_CONST_SECTION = `
-
-export const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [
-\t// wp-typia add editor-plugin entries
-];
-`;
-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,
-    },
-};
-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: 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: "clientFile", required: true },
-                    { key: "dataFile", required: true },
-                    {
-                        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: "namespace", required: true },
-                    { key: "openApiFile", required: true },
-                    { key: "phpFile", required: true },
-                    { 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: 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,
-        },
-    },
-];
-function findExportedArrayLiteral(sourceFile, exportName) {
-    for (const statement of sourceFile.statements) {
-        if (!ts.isVariableStatement(statement)) {
-            continue;
-        }
-        if (!statement.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword)) {
-            continue;
-        }
-        for (const declaration of statement.declarationList.declarations) {
-            if (!ts.isIdentifier(declaration.name) || declaration.name.text !== exportName) {
-                continue;
-            }
-            if (declaration.initializer && ts.isArrayLiteralExpression(declaration.initializer)) {
-                return {
-                    array: declaration.initializer,
-                    found: true,
-                };
-            }
-            return {
-                array: null,
-                found: true,
-            };
-        }
-    }
-    return {
-        array: null,
-        found: false,
-    };
-}
-function getOptionalStringProperty(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 (ts.isStringLiteralLike(property.initializer)) {
-            return property.initializer.text;
-        }
-        throw new Error(`${entryName}[${elementIndex}] must use a string literal for "${key}" in scripts/block-config.ts.`);
-    }
-    return undefined;
-}
-function getOptionalStringArrayProperty(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 (!ts.isArrayLiteralExpression(property.initializer)) {
-            throw new Error(`${entryName}[${elementIndex}] must use an array literal for "${key}" in scripts/block-config.ts.`);
-        }
-        return property.initializer.elements.map((element, itemIndex) => {
-            if (!ts.isStringLiteralLike(element)) {
-                throw new Error(`${entryName}[${elementIndex}].${key}[${itemIndex}] must use a string literal in scripts/block-config.ts.`);
-            }
-            return element.text;
-        });
-    }
-    return undefined;
-}
-function isMissingRequiredInventoryValue(value) {
-    return value === undefined || (typeof value === "string" && value.length === 0);
-}
-function formatMissingRequiredInventoryFields(keys) {
-    return keys.length === 1
-        ? `required "${keys[0]}"`
-        : `required fields ${keys.map((key) => `"${key}"`).join(", ")}`;
-}
-function assertParsedInventoryEntry(entry, descriptor, elementIndex) {
-    const missingRequiredKeys = descriptor.fields
-        .filter((field) => field.required === true &&
-        isMissingRequiredInventoryValue(entry[field.key]))
-        .map((field) => field.key);
-    if (missingRequiredKeys.length > 0) {
-        throw new Error(`${descriptor.entryName}[${elementIndex}] is missing ${formatMissingRequiredInventoryFields(missingRequiredKeys)} in scripts/block-config.ts.`);
-    }
-}
-function parseInventoryEntries(arrayLiteral, descriptor) {
-    return arrayLiteral.elements.map((element, elementIndex) => {
-        if (!ts.isObjectLiteralExpression(element)) {
-            throw new Error(`${descriptor.entryName}[${elementIndex}] must be an object literal in scripts/block-config.ts.`);
-        }
-        const entry = {};
-        for (const field of descriptor.fields) {
-            const kind = field.kind ?? "string";
-            const value = kind === "stringArray"
-                ? getOptionalStringArrayProperty(descriptor.entryName, elementIndex, element, field.key)
-                : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
-            field.validate?.(value, {
-                elementIndex,
-                entryName: descriptor.entryName,
-                key: field.key,
-            });
-            entry[field.key] = value;
-        }
-        assertParsedInventoryEntry(entry, descriptor, elementIndex);
-        return entry;
-    });
-}
-function parseInventorySection(sourceFile, descriptor) {
-    if (!descriptor.parse) {
-        return {
-            entries: [],
-            found: false,
-        };
-    }
-    const exportName = descriptor.parse.exportName ?? descriptor.value?.name;
-    if (!exportName) {
-        throw new Error("Inventory parser descriptor is missing an export name.");
-    }
-    const exportedArray = findExportedArrayLiteral(sourceFile, exportName);
-    if (!exportedArray.found) {
-        if (descriptor.parse.required) {
-            throw new Error(`scripts/block-config.ts must export a ${exportName} array.`);
-        }
-        return {
-            entries: [],
-            found: false,
-        };
-    }
-    if (!exportedArray.array) {
-        if (descriptor.parse.required) {
-            throw new Error(`scripts/block-config.ts must export a ${exportName} array.`);
-        }
-        throw new Error(`scripts/block-config.ts must export ${exportName} as an array literal.`);
-    }
-    return {
-        entries: parseInventoryEntries(exportedArray.array, descriptor.parse.entry),
-        found: true,
-    };
-}
-/**
- * Parse workspace inventory entries from the source of `scripts/block-config.ts`.
- *
- * @param source Raw TypeScript source from `scripts/block-config.ts`.
- * @returns Parsed inventory sections without the resolved `blockConfigPath`.
- * @throws {Error} When `BLOCKS` is missing or any inventory entry is malformed.
- */
-export function parseWorkspaceInventorySource(source) {
-    const sourceFile = ts.createSourceFile("block-config.ts", source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-    const parsedInventory = {
-        abilities: [],
-        adminViews: [],
-        aiFeatures: [],
-        bindingSources: [],
-        blockStyles: [],
-        blockTransforms: [],
-        blocks: parseInventorySection(sourceFile, BLOCK_INVENTORY_SECTION).entries,
-        editorPlugins: [],
-        hasAbilitiesSection: false,
-        hasAdminViewsSection: false,
-        hasAiFeaturesSection: false,
-        hasBindingSourcesSection: false,
-        hasBlockStylesSection: false,
-        hasBlockTransformsSection: false,
-        hasEditorPluginsSection: false,
-        hasPatternsSection: false,
-        hasRestResourcesSection: false,
-        hasVariationsSection: false,
-        patterns: [],
-        restResources: [],
-        source,
-        variations: [],
-    };
-    const mutableInventory = parsedInventory;
-    for (const section of INVENTORY_SECTIONS) {
-        if (!section.parse) {
-            continue;
-        }
-        const parsedSection = parseInventorySection(sourceFile, section);
-        mutableInventory[section.parse.entriesKey] = parsedSection.entries;
-        if (section.parse.hasSectionKey) {
-            mutableInventory[section.parse.hasSectionKey] = parsedSection.found;
-        }
-    }
-    return parsedInventory;
-}
-/**
- * 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.
- *
- * @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 (typeof error === "object" &&
-            error !== null &&
-            "code" in error &&
-            error.code === "ENOENT") {
-            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 (typeof error === "object" &&
-            error !== null &&
-            "code" in error &&
-            error.code === "ENOENT") {
-            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 Use `getWorkspaceBlockSelectOptionsAsync()` from async command
- * paths. This helper intentionally remains sync-only for compatibility callers.
- *
- * @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);
-}
-function ensureWorkspaceInventorySections(source) {
-    let nextSource = source.trimEnd();
-    for (const section of INVENTORY_SECTIONS) {
-        if (section.interface &&
-            !hasExportedInterface(nextSource, section.interface.name)) {
-            nextSource += section.interface.section;
-        }
-        if (section.value && !hasExportedConst(nextSource, section.value.name)) {
-            nextSource += section.value.section;
-        }
-    }
-    return `${nextSource}\n`;
-}
-function hasExportedInterface(source, interfaceName) {
-    return new RegExp(`export\\s+interface\\s+${escapeRegex(interfaceName)}\\b`, "u").test(source);
-}
-function hasExportedConst(source, constName) {
-    return new RegExp(`export\\s+const\\s+${escapeRegex(constName)}\\b`, "u").test(source);
-}
-function appendEntriesAtMarker(source, marker, entries) {
-    if (entries.length === 0) {
-        return source;
-    }
-    if (!source.includes(marker)) {
-        throw new Error(`Workspace inventory marker "${marker}" is missing in scripts/block-config.ts.`);
-    }
-    return source.replace(marker, `${entries.join("\n")}\n${marker}`);
-}
-function appendInventorySectionEntries(source, options) {
-    let nextSource = source;
-    for (const section of [BLOCK_INVENTORY_SECTION, ...INVENTORY_SECTIONS]) {
-        if (!section.append) {
-            continue;
-        }
-        nextSource = appendEntriesAtMarker(nextSource, section.append.marker, options[section.append.optionKey] ?? []);
-    }
-    return nextSource;
-}
-function ensureInterfaceField(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) => {
-        if (new RegExp(`^[ \t]*${escapeRegex(fieldName)}\\??:`, "mu").test(body)) {
-            return match;
-        }
-        const lineEnding = start.endsWith("\r\n") ? "\r\n" : "\n";
-        const formattedFieldSource = `${fieldSource
-            .replace(/\r?\n$/u, "")
-            .split("\n")
-            .join(lineEnding)}${lineEnding}`;
-        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) => {
-        const fieldPattern = new RegExp(`(^([ \\t]*)${escapeRegex(fieldName)}\\??:\\s*\\{[ \\t]*\\r?\\n)([\\s\\S]*?)(^\\2\\};\\r?\\n?)`, "mu");
-        const fieldMatch = fieldPattern.exec(body);
-        if (!fieldMatch) {
-            return match;
-        }
-        const existingFieldSource = fieldMatch[0];
-        if (requiredFragments.every((fragment) => existingFieldSource.includes(fragment))) {
-            return match;
-        }
-        const lineEnding = start.endsWith("\r\n") ? "\r\n" : "\n";
-        const formattedFieldSource = `${fieldSource
-            .replace(/\r?\n$/u, "")
-            .split("\n")
-            .join(lineEnding)}${lineEnding}`;
-        return `${start}${body.slice(0, fieldMatch.index)}${formattedFieldSource}${body.slice(fieldMatch.index + existingFieldSource.length)}${end}`;
-    });
-}
-/**
- * Update `scripts/block-config.ts` source text with additional inventory entries.
- *
- * Missing inventory sections for variations, patterns, binding sources, REST
- * resources, workflow abilities, AI features, editor plugins, block styles, and
- * block transforms are created
- * automatically before new entries are appended at their marker comments.
- * When provided, `transformSource` runs before any entries are inserted.
- *
- * @param source Existing `scripts/block-config.ts` source.
- * @param options Entry lists plus an optional source transformer.
- * @returns Updated source text with all requested inventory entries appended.
- */
-export function updateWorkspaceInventorySource(source, options = {}) {
-    let nextSource = ensureWorkspaceInventorySections(source);
-    if (options.transformSource) {
-        nextSource = options.transformSource(nextSource);
-    }
-    nextSource = appendInventorySectionEntries(nextSource, options);
-    nextSource = ensureInterfaceField(nextSource, "WorkspaceBindingSourceConfig", "attribute", "\tattribute?: string;");
-    nextSource = ensureInterfaceField(nextSource, "WorkspaceBindingSourceConfig", "block", "\tblock?: string;");
-    nextSource = ensureInterfaceField(nextSource, "WorkspaceAbilityConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD);
-    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[];"]);
-    return nextSource;
-}
-/**
- * Append new entries to the canonical workspace inventory file on disk.
- *
- * @param projectDir Workspace root directory.
- * @param options Entry lists and optional source transform passed through to
- * `updateWorkspaceInventorySource`.
- * @returns Resolves once `scripts/block-config.ts` has been updated if needed.
- */
-export async function appendWorkspaceInventoryEntries(projectDir, options) {
-    const blockConfigPath = path.join(projectDir, "scripts", "block-config.ts");
-    const source = await readFile(blockConfigPath, "utf8");
-    const nextSource = updateWorkspaceInventorySource(source, options);
-    if (nextSource !== source) {
-        await writeFile(blockConfigPath, nextSource, "utf8");
-    }
-}
+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";