@wp-typia/project-tools 0.20.1 → 0.21.0

package/dist/runtime/workspace-inventory.js

@@ -3,13 +3,17 @@ 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";
 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`.
  */
@@ -28,6 +32,36 @@ 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 {
@@ -44,6 +78,8 @@ export const PATTERNS: WorkspacePatternConfig[] = [
 const BINDING_SOURCES_INTERFACE_SECTION = `
 
 export interface WorkspaceBindingSourceConfig {
+\tattribute?: string;
+\tblock?: string;
 \teditorFile: string;
 \tserverFile: string;
 \tslug: string;
@@ -135,6 +171,21 @@ 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 {
@@ -254,6 +305,32 @@ function parseVariationEntries(arrayLiteral) {
         };
     });
 }
+function parseBlockStyleEntries(arrayLiteral) {
+    return arrayLiteral.elements.map((element, elementIndex) => {
+        if (!ts.isObjectLiteralExpression(element)) {
+            throw new Error(`BLOCK_STYLES[${elementIndex}] must be an object literal in scripts/block-config.ts.`);
+        }
+        return {
+            block: getRequiredStringProperty("BLOCK_STYLES", elementIndex, element, "block"),
+            file: getRequiredStringProperty("BLOCK_STYLES", elementIndex, element, "file"),
+            slug: getRequiredStringProperty("BLOCK_STYLES", elementIndex, element, "slug"),
+        };
+    });
+}
+function parseBlockTransformEntries(arrayLiteral) {
+    return arrayLiteral.elements.map((element, elementIndex) => {
+        if (!ts.isObjectLiteralExpression(element)) {
+            throw new Error(`BLOCK_TRANSFORMS[${elementIndex}] must be an object literal in scripts/block-config.ts.`);
+        }
+        return {
+            block: getRequiredStringProperty("BLOCK_TRANSFORMS", elementIndex, element, "block"),
+            file: getRequiredStringProperty("BLOCK_TRANSFORMS", elementIndex, element, "file"),
+            from: getRequiredStringProperty("BLOCK_TRANSFORMS", elementIndex, element, "from"),
+            slug: getRequiredStringProperty("BLOCK_TRANSFORMS", elementIndex, element, "slug"),
+            to: getRequiredStringProperty("BLOCK_TRANSFORMS", elementIndex, element, "to"),
+        };
+    });
+}
 function parsePatternEntries(arrayLiteral) {
     return arrayLiteral.elements.map((element, elementIndex) => {
         if (!ts.isObjectLiteralExpression(element)) {
@@ -271,6 +348,8 @@ function parseBindingSourceEntries(arrayLiteral) {
             throw new Error(`BINDING_SOURCES[${elementIndex}] must be an object literal in scripts/block-config.ts.`);
         }
         return {
+            attribute: getOptionalStringProperty("BINDING_SOURCES", elementIndex, element, "attribute"),
+            block: getOptionalStringProperty("BINDING_SOURCES", elementIndex, element, "block"),
             editorFile: getRequiredStringProperty("BINDING_SOURCES", elementIndex, element, "editorFile"),
             serverFile: getRequiredStringProperty("BINDING_SOURCES", elementIndex, element, "serverFile"),
             slug: getRequiredStringProperty("BINDING_SOURCES", elementIndex, element, "slug"),
@@ -351,6 +430,19 @@ function parseEditorPluginEntries(arrayLiteral) {
         };
     });
 }
+function parseAdminViewEntries(arrayLiteral) {
+    return arrayLiteral.elements.map((element, elementIndex) => {
+        if (!ts.isObjectLiteralExpression(element)) {
+            throw new Error(`ADMIN_VIEWS[${elementIndex}] must be an object literal in scripts/block-config.ts.`);
+        }
+        return {
+            file: getRequiredStringProperty("ADMIN_VIEWS", elementIndex, element, "file"),
+            phpFile: getRequiredStringProperty("ADMIN_VIEWS", elementIndex, element, "phpFile"),
+            slug: getRequiredStringProperty("ADMIN_VIEWS", elementIndex, element, "slug"),
+            source: getOptionalStringProperty("ADMIN_VIEWS", elementIndex, element, "source"),
+        };
+    });
+}
 /**
  * Parse workspace inventory entries from the source of `scripts/block-config.ts`.
  *
@@ -365,15 +457,24 @@ export function parseWorkspaceInventorySource(source) {
         throw new Error("scripts/block-config.ts must export a BLOCKS array.");
     }
     const variationArray = findExportedArrayLiteral(sourceFile, "VARIATIONS");
+    const blockStyleArray = findExportedArrayLiteral(sourceFile, "BLOCK_STYLES");
+    const blockTransformArray = findExportedArrayLiteral(sourceFile, "BLOCK_TRANSFORMS");
     const patternArray = findExportedArrayLiteral(sourceFile, "PATTERNS");
     const bindingSourceArray = findExportedArrayLiteral(sourceFile, "BINDING_SOURCES");
     const restResourceArray = findExportedArrayLiteral(sourceFile, "REST_RESOURCES");
     const abilityArray = findExportedArrayLiteral(sourceFile, "ABILITIES");
     const aiFeatureArray = findExportedArrayLiteral(sourceFile, "AI_FEATURES");
+    const adminViewArray = findExportedArrayLiteral(sourceFile, "ADMIN_VIEWS");
     const editorPluginArray = findExportedArrayLiteral(sourceFile, "EDITOR_PLUGINS");
     if (variationArray.found && !variationArray.array) {
         throw new Error("scripts/block-config.ts must export VARIATIONS as an array literal.");
     }
+    if (blockStyleArray.found && !blockStyleArray.array) {
+        throw new Error("scripts/block-config.ts must export BLOCK_STYLES as an array literal.");
+    }
+    if (blockTransformArray.found && !blockTransformArray.array) {
+        throw new Error("scripts/block-config.ts must export BLOCK_TRANSFORMS as an array literal.");
+    }
     if (patternArray.found && !patternArray.array) {
         throw new Error("scripts/block-config.ts must export PATTERNS as an array literal.");
     }
@@ -389,19 +490,30 @@ export function parseWorkspaceInventorySource(source) {
     if (aiFeatureArray.found && !aiFeatureArray.array) {
         throw new Error("scripts/block-config.ts must export AI_FEATURES as an array literal.");
     }
+    if (adminViewArray.found && !adminViewArray.array) {
+        throw new Error("scripts/block-config.ts must export ADMIN_VIEWS as an array literal.");
+    }
     if (editorPluginArray.found && !editorPluginArray.array) {
         throw new Error("scripts/block-config.ts must export EDITOR_PLUGINS as an array literal.");
     }
     return {
         abilities: abilityArray.array ? parseAbilityEntries(abilityArray.array) : [],
+        adminViews: adminViewArray.array ? parseAdminViewEntries(adminViewArray.array) : [],
         aiFeatures: aiFeatureArray.array ? parseAiFeatureEntries(aiFeatureArray.array) : [],
         bindingSources: bindingSourceArray.array
             ? parseBindingSourceEntries(bindingSourceArray.array)
             : [],
+        blockStyles: blockStyleArray.array ? parseBlockStyleEntries(blockStyleArray.array) : [],
+        blockTransforms: blockTransformArray.array
+            ? parseBlockTransformEntries(blockTransformArray.array)
+            : [],
         blocks: parseBlockEntries(blockArray.array),
         hasAbilitiesSection: abilityArray.found,
+        hasAdminViewsSection: adminViewArray.found,
         hasAiFeaturesSection: aiFeatureArray.found,
         hasBindingSourcesSection: bindingSourceArray.found,
+        hasBlockStylesSection: blockStyleArray.found,
+        hasBlockTransformsSection: blockTransformArray.found,
         hasEditorPluginsSection: editorPluginArray.found,
         hasPatternsSection: patternArray.found,
         hasRestResourcesSection: restResourceArray.found,
@@ -468,6 +580,18 @@ function ensureWorkspaceInventorySections(source) {
     if (!/export\s+const\s+VARIATIONS\b/u.test(nextSource)) {
         nextSource += VARIATIONS_CONST_SECTION;
     }
+    if (!/export\s+interface\s+WorkspaceBlockStyleConfig\b/u.test(nextSource)) {
+        nextSource += BLOCK_STYLES_INTERFACE_SECTION;
+    }
+    if (!/export\s+const\s+BLOCK_STYLES\b/u.test(nextSource)) {
+        nextSource += BLOCK_STYLES_CONST_SECTION;
+    }
+    if (!/export\s+interface\s+WorkspaceBlockTransformConfig\b/u.test(nextSource)) {
+        nextSource += BLOCK_TRANSFORMS_INTERFACE_SECTION;
+    }
+    if (!/export\s+const\s+BLOCK_TRANSFORMS\b/u.test(nextSource)) {
+        nextSource += BLOCK_TRANSFORMS_CONST_SECTION;
+    }
     if (!/export\s+interface\s+WorkspacePatternConfig\b/u.test(nextSource)) {
         nextSource += PATTERNS_INTERFACE_SECTION;
     }
@@ -498,6 +622,12 @@ function ensureWorkspaceInventorySections(source) {
     if (!/export\s+const\s+AI_FEATURES\b/u.test(nextSource)) {
         nextSource += AI_FEATURES_CONST_SECTION;
     }
+    if (!/export\s+interface\s+WorkspaceAdminViewConfig\b/u.test(nextSource)) {
+        nextSource += ADMIN_VIEWS_INTERFACE_SECTION;
+    }
+    if (!/export\s+const\s+ADMIN_VIEWS\b/u.test(nextSource)) {
+        nextSource += ADMIN_VIEWS_CONST_SECTION;
+    }
     if (!/export\s+interface\s+WorkspaceEditorPluginConfig\b/u.test(nextSource)) {
         nextSource += EDITOR_PLUGINS_INTERFACE_SECTION;
     }
@@ -515,9 +645,6 @@ function appendEntriesAtMarker(source, marker, entries) {
     }
     return source.replace(marker, `${entries.join("\n")}\n${marker}`);
 }
-function escapeRegex(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
 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) => {
@@ -547,7 +674,8 @@ function ensureInterfaceField(source, interfaceName, fieldName, fieldSource) {
  * 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, and editor plugins are created
+ * 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.
  *
@@ -555,18 +683,23 @@ function ensureInterfaceField(source, interfaceName, fieldName, fieldSource) {
  * @param options Entry lists plus an optional source transformer.
  * @returns Updated source text with all requested inventory entries appended.
  */
-export function updateWorkspaceInventorySource(source, { blockEntries = [], bindingSourceEntries = [], abilityEntries = [], aiFeatureEntries = [], editorPluginEntries = [], patternEntries = [], restResourceEntries = [], variationEntries = [], transformSource, } = {}) {
+export function updateWorkspaceInventorySource(source, { blockEntries = [], blockStyleEntries = [], blockTransformEntries = [], bindingSourceEntries = [], abilityEntries = [], adminViewEntries = [], aiFeatureEntries = [], editorPluginEntries = [], patternEntries = [], restResourceEntries = [], variationEntries = [], transformSource, } = {}) {
     let nextSource = ensureWorkspaceInventorySections(source);
     if (transformSource) {
         nextSource = transformSource(nextSource);
     }
     nextSource = appendEntriesAtMarker(nextSource, BLOCK_CONFIG_ENTRY_MARKER, blockEntries);
     nextSource = appendEntriesAtMarker(nextSource, VARIATION_CONFIG_ENTRY_MARKER, variationEntries);
+    nextSource = appendEntriesAtMarker(nextSource, BLOCK_STYLE_CONFIG_ENTRY_MARKER, blockStyleEntries);
+    nextSource = appendEntriesAtMarker(nextSource, BLOCK_TRANSFORM_CONFIG_ENTRY_MARKER, blockTransformEntries);
     nextSource = appendEntriesAtMarker(nextSource, PATTERN_CONFIG_ENTRY_MARKER, patternEntries);
     nextSource = appendEntriesAtMarker(nextSource, BINDING_SOURCE_CONFIG_ENTRY_MARKER, bindingSourceEntries);
     nextSource = appendEntriesAtMarker(nextSource, REST_RESOURCE_CONFIG_ENTRY_MARKER, restResourceEntries);
     nextSource = appendEntriesAtMarker(nextSource, ABILITY_CONFIG_ENTRY_MARKER, abilityEntries);
     nextSource = appendEntriesAtMarker(nextSource, AI_FEATURE_CONFIG_ENTRY_MARKER, aiFeatureEntries);
+    nextSource = appendEntriesAtMarker(nextSource, ADMIN_VIEW_CONFIG_ENTRY_MARKER, adminViewEntries);
+    nextSource = ensureInterfaceField(nextSource, "WorkspaceBindingSourceConfig", "attribute", "\tattribute?: string;");
+    nextSource = ensureInterfaceField(nextSource, "WorkspaceBindingSourceConfig", "block", "\tblock?: string;");
     nextSource = ensureInterfaceField(nextSource, "WorkspaceAbilityConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD);
     nextSource = ensureInterfaceField(nextSource, "WorkspaceAiFeatureConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD);
     nextSource = appendEntriesAtMarker(nextSource, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, editorPluginEntries);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -105,7 +105,7 @@
     "prepack": "bun run build && node ./scripts/publish-manifest.mjs prepare",
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
-    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
+    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/package-versions.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
     "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
     "test:migration-planning": "bun run build && bun test tests/migration-init.test.ts tests/migration-config.test.ts tests/migration-plan-wizard.test.ts",