@wp-typia/project-tools 0.22.7 → 0.22.9

package/dist/runtime/ts-property-names.js

@@ -0,0 +1,16 @@
+import ts from "typescript";
+/**
+ * Extract the literal text for TypeScript property names this runtime supports.
+ *
+ * Computed property names are intentionally not resolved because their runtime
+ * values are not statically knowable from the syntax node alone.
+ *
+ * @param name TypeScript property name node.
+ * @returns Identifier, string-literal, or numeric-literal text; otherwise `null`.
+ */
+export function getPropertyNameText(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {
+        return name.text;
+    }
+    return null;
+}

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

@@ -142,6 +142,11 @@ export interface WorkspaceInventory {
     source: string;
     variations: WorkspaceVariationInventoryEntry[];
 }
+export type WorkspaceBlockSelectOption = {
+    description: string;
+    name: string;
+    value: string;
+};
 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";
@@ -179,7 +184,11 @@ type WorkspaceInventoryUpdateOptions = {
  */
 export declare function parseWorkspaceInventorySource(source: string): Omit<WorkspaceInventory, "blockConfigPath">;
 /**
- * Read and parse the canonical workspace inventory file.
+ * 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`.
@@ -187,19 +196,36 @@ export declare function parseWorkspaceInventorySource(source: string): Omit<Work
  */
 export declare function readWorkspaceInventory(projectDir: string): WorkspaceInventory;
 /**
- * Return select options for the current workspace block inventory.
+ * 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 declare function readWorkspaceInventoryAsync(projectDir: string): Promise<WorkspaceInventory>;
+/**
+ * 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 declare function getWorkspaceBlockSelectOptions(projectDir: string): Array<{
-    description: string;
-    name: string;
-    value: string;
-}>;
+export declare function getWorkspaceBlockSelectOptions(projectDir: string): WorkspaceBlockSelectOption[];
+/**
+ * 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 declare function getWorkspaceBlockSelectOptionsAsync(projectDir: string): Promise<WorkspaceBlockSelectOption[]>;
 /**
  * Update `scripts/block-config.ts` source text with additional inventory entries.
  *

package/dist/runtime/workspace-inventory.js

@@ -1,11 +1,12 @@
-import fs from "node:fs";
+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";
-function defineInventoryEntryParser(descriptor) {
-    return descriptor;
+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";
@@ -212,7 +213,7 @@ const BLOCK_INVENTORY_SECTION = {
     },
     parse: {
         entriesKey: "blocks",
-        entry: defineInventoryEntryParser({
+        entry: defineInventoryEntryParser()({
             entryName: "BLOCKS",
             fields: [
                 { key: "apiTypesFile" },
@@ -238,7 +239,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "variations",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "VARIATIONS",
                 fields: [
                     { key: "block", required: true },
@@ -264,7 +265,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "blockStyles",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "BLOCK_STYLES",
                 fields: [
                     { key: "block", required: true },
@@ -290,7 +291,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "blockTransforms",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "BLOCK_TRANSFORMS",
                 fields: [
                     { key: "block", required: true },
@@ -318,7 +319,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "patterns",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "PATTERNS",
                 fields: [
                     { key: "file", required: true },
@@ -343,7 +344,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "bindingSources",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "BINDING_SOURCES",
                 fields: [
                     { key: "attribute" },
@@ -371,7 +372,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "restResources",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "REST_RESOURCES",
                 fields: [
                     { key: "apiFile", required: true },
@@ -415,7 +416,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "abilities",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "ABILITIES",
                 fields: [
                     { key: "clientFile", required: true },
@@ -448,7 +449,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "aiFeatures",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "AI_FEATURES",
                 fields: [
                     { key: "aiSchemaFile", required: true },
@@ -481,7 +482,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "adminViews",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "ADMIN_VIEWS",
                 fields: [
                     { key: "file", required: true },
@@ -508,7 +509,7 @@ const INVENTORY_SECTIONS = [
         },
         parse: {
             entriesKey: "editorPlugins",
-            entry: defineInventoryEntryParser({
+            entry: defineInventoryEntryParser()({
                 entryName: "EDITOR_PLUGINS",
                 fields: [
                     { key: "file", required: true },
@@ -524,12 +525,6 @@ const INVENTORY_SECTIONS = [
         },
     },
 ];
-function getPropertyNameText(name) {
-    if (ts.isIdentifier(name) || ts.isStringLiteral(name)) {
-        return name.text;
-    }
-    return null;
-}
 function findExportedArrayLiteral(sourceFile, exportName) {
     for (const statement of sourceFile.statements) {
         if (!ts.isVariableStatement(statement)) {
@@ -575,14 +570,7 @@ function getOptionalStringProperty(entryName, elementIndex, objectLiteral, key)
     }
     return undefined;
 }
-function getRequiredStringProperty(entryName, elementIndex, objectLiteral, key) {
-    const value = getOptionalStringProperty(entryName, elementIndex, objectLiteral, key);
-    if (!value) {
-        throw new Error(`${entryName}[${elementIndex}] is missing required "${key}" in scripts/block-config.ts.`);
-    }
-    return value;
-}
-function getRequiredStringArrayProperty(entryName, elementIndex, objectLiteral, key) {
+function getOptionalStringArrayProperty(entryName, elementIndex, objectLiteral, key) {
     for (const property of objectLiteral.properties) {
         if (!ts.isPropertyAssignment(property)) {
             continue;
@@ -601,7 +589,24 @@ function getRequiredStringArrayProperty(entryName, elementIndex, objectLiteral,
             return element.text;
         });
     }
-    throw new Error(`${entryName}[${elementIndex}] is missing required "${key}" in scripts/block-config.ts.`);
+    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) => {
@@ -612,10 +617,8 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
         for (const field of descriptor.fields) {
             const kind = field.kind ?? "string";
             const value = kind === "stringArray"
-                ? getRequiredStringArrayProperty(descriptor.entryName, elementIndex, element, field.key)
-                : field.required
-                    ? getRequiredStringProperty(descriptor.entryName, elementIndex, element, field.key)
-                    : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
+                ? getOptionalStringArrayProperty(descriptor.entryName, elementIndex, element, field.key)
+                : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
             field.validate?.(value, {
                 elementIndex,
                 entryName: descriptor.entryName,
@@ -623,6 +626,7 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
             });
             entry[field.key] = value;
         }
+        assertParsedInventoryEntry(entry, descriptor, elementIndex);
         return entry;
     });
 }
@@ -705,7 +709,11 @@ export function parseWorkspaceInventorySource(source) {
     return parsedInventory;
 }
 /**
- * Read and parse the canonical workspace inventory file.
+ * 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`.
@@ -715,7 +723,7 @@ export function readWorkspaceInventory(projectDir) {
     const blockConfigPath = path.join(projectDir, "scripts", "block-config.ts");
     let source;
     try {
-        source = fs.readFileSync(blockConfigPath, "utf8");
+        source = readFileSync(blockConfigPath, "utf8");
     }
     catch (error) {
         if (typeof error === "object" &&
@@ -732,20 +740,65 @@ export function readWorkspaceInventory(projectDir) {
     };
 }
 /**
- * Return select options for the current workspace block inventory.
+ * 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 readWorkspaceInventory(projectDir).blocks.map((block) => ({
-        description: block.typesFile,
-        name: block.slug,
-        value: block.slug,
-    }));
+    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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.22.7",
+  "version": "0.22.9",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -47,6 +47,16 @@
       "import": "./dist/runtime/cli-scaffold.js",
       "default": "./dist/runtime/cli-scaffold.js"
     },
+    "./create-template-validation": {
+      "types": "./dist/runtime/create-template-validation.d.ts",
+      "import": "./dist/runtime/create-template-validation.js",
+      "default": "./dist/runtime/create-template-validation.js"
+    },
+    "./id-suggestions": {
+      "types": "./dist/runtime/id-suggestions.d.ts",
+      "import": "./dist/runtime/id-suggestions.js",
+      "default": "./dist/runtime/id-suggestions.js"
+    },
     "./ai-artifacts": {
       "types": "./dist/runtime/ai-artifacts.d.ts",
       "import": "./dist/runtime/ai-artifacts.js",