wp-typia 0.22.8 → 0.22.10

package/dist-bunli/{cli-bbj0kn1e.js → cli-3fzqhpx9.js}

@@ -1,4 +1,7 @@
 // @bun
+import {
+  suggestCloseId
+} from "./cli-cvxvcw7c.js";
 import {
   CLI_DIAGNOSTIC_CODES,
   createCliDiagnosticCodeError
@@ -170943,6 +170946,11 @@ var ADD_BLOCK_TEMPLATE_IDS = [
   "persistence",
   "compound"
 ];
+function suggestAddBlockTemplateId(templateId) {
+  return suggestCloseId(templateId, ADD_BLOCK_TEMPLATE_IDS, {
+    maxDistance: 3
+  });
+}
 
 // ../wp-typia-project-tools/src/runtime/hooked-blocks.ts
 var HOOKED_BLOCK_POSITION_IDS = ["before", "after", "firstChild", "lastChild"];
@@ -171098,6 +171106,36 @@ function assertValidEditorPluginSlot(slot = "sidebar") {
   throw new Error(`Editor plugin slot must be one of: ${EDITOR_PLUGIN_SLOT_IDS.join(", ")}. Legacy aliases: PluginSidebar, PluginDocumentSettingPanel.`);
 }
 
+// ../wp-typia-project-tools/src/runtime/fs-async.ts
+import { promises as fsp } from "fs";
+async function pathExists(filePath) {
+  try {
+    await fsp.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readOptionalUtf8File(filePath) {
+  try {
+    return await fsp.readFile(filePath, "utf8");
+  } catch (error) {
+    if (isFileNotFoundError(error)) {
+      return null;
+    }
+    throw error;
+  }
+}
+function getNodeErrorCode(error) {
+  return getOptionalNodeErrorCode(error) ?? "";
+}
+function getOptionalNodeErrorCode(error) {
+  return typeof error === "object" && error !== null && "code" in error ? String(error.code) : undefined;
+}
+function isFileNotFoundError(error) {
+  return getOptionalNodeErrorCode(error) === "ENOENT";
+}
+
 // ../wp-typia-project-tools/src/runtime/cli-add-help.ts
 function formatAddHelpText() {
   return `Usage:
@@ -171213,36 +171251,29 @@ function resolveScaffoldIdentifiers({
   };
 }
 // ../wp-typia-project-tools/src/runtime/cli-add-filesystem.ts
-import { promises as fsp } from "fs";
+import { promises as fsp2 } from "fs";
 import path from "path";
 function getWorkspaceBootstrapPath(workspace) {
   const workspaceBaseName = workspace.packageName.split("/").pop() ?? workspace.packageName;
   return path.join(workspace.projectDir, `${workspaceBaseName}.php`);
 }
 async function patchFile(filePath, transform) {
-  const currentSource = await fsp.readFile(filePath, "utf8");
+  const currentSource = await fsp2.readFile(filePath, "utf8");
   const nextSource = transform(currentSource);
   if (nextSource !== currentSource) {
-    await fsp.writeFile(filePath, nextSource, "utf8");
+    await fsp2.writeFile(filePath, nextSource, "utf8");
   }
 }
 async function readOptionalFile(filePath) {
-  try {
-    return await fsp.readFile(filePath, "utf8");
-  } catch (error) {
-    if (isFileNotFoundError(error)) {
-      return null;
-    }
-    throw error;
-  }
+  return readOptionalUtf8File(filePath);
 }
 async function restoreOptionalFile(filePath, source) {
   if (source === null) {
-    await fsp.rm(filePath, { force: true });
+    await fsp2.rm(filePath, { force: true });
     return;
   }
-  await fsp.mkdir(path.dirname(filePath), { recursive: true });
-  await fsp.writeFile(filePath, source, "utf8");
+  await fsp2.mkdir(path.dirname(filePath), { recursive: true });
+  await fsp2.writeFile(filePath, source, "utf8");
 }
 async function snapshotWorkspaceFiles(filePaths) {
   const uniquePaths = Array.from(new Set(filePaths));
@@ -171253,50 +171284,18 @@ async function snapshotWorkspaceFiles(filePaths) {
 }
 async function rollbackWorkspaceMutation(snapshot) {
   for (const targetPath of snapshot.targetPaths) {
-    await fsp.rm(targetPath, { force: true, recursive: true });
+    await fsp2.rm(targetPath, { force: true, recursive: true });
   }
   for (const snapshotDir of snapshot.snapshotDirs) {
-    await fsp.rm(snapshotDir, { force: true, recursive: true });
+    await fsp2.rm(snapshotDir, { force: true, recursive: true });
   }
   for (const { filePath, source } of snapshot.fileSources) {
     await restoreOptionalFile(filePath, source);
   }
 }
-function isFileNotFoundError(error) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
-}
 // ../wp-typia-project-tools/src/runtime/cli-add-block-json.ts
 import path2 from "path";
 import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
-
-// ../wp-typia-project-tools/src/runtime/fs-async.ts
-import { promises as fsp2 } from "fs";
-async function pathExists(filePath) {
-  try {
-    await fsp2.access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function readOptionalUtf8File(filePath) {
-  try {
-    return await fsp2.readFile(filePath, "utf8");
-  } catch (error) {
-    if (isFileNotFoundError2(error)) {
-      return null;
-    }
-    throw error;
-  }
-}
-function getNodeErrorCode(error) {
-  return typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
-}
-function isFileNotFoundError2(error) {
-  return getNodeErrorCode(error) === "ENOENT";
-}
-
-// ../wp-typia-project-tools/src/runtime/cli-add-block-json.ts
 function resolveWorkspaceBlock(inventory, blockSlug) {
   const block = inventory.blocks.find((entry) => entry.slug === blockSlug);
   if (!block) {
@@ -171588,380 +171587,13 @@ function assertEditorPluginDoesNotExist(projectDir, editorPluginSlug, inventory)
     projectDir
   });
 }
-// ../wp-typia-project-tools/src/runtime/workspace-inventory.ts
-var import_typescript2 = __toESM(require_typescript(), 1);
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-read.ts
 import { readFileSync } from "fs";
 import path4 from "path";
-import { readFile, writeFile } from "fs/promises";
+import { readFile } from "fs/promises";
 
-// ../wp-typia-project-tools/src/runtime/php-utils.ts
-function escapeRegex(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
-function quotePhpString(value) {
-  return `'${value.replace(/\\/gu, "\\\\").replace(/'/gu, "\\'")}'`;
-}
-function hasPhpFunctionDefinition(source, functionName) {
-  return new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u").test(source);
-}
-function isPhpIdentifierStart(character) {
-  return /^[A-Za-z_]$/u.test(character ?? "");
-}
-function isPhpIdentifierPart(character) {
-  return /^[A-Za-z0-9_]$/u.test(character ?? "");
-}
-function isPhpLineStart(source, index) {
-  return index === 0 || source[index - 1] === `
-`;
-}
-function isPhpHorizontalWhitespace(character) {
-  return character === " " || character === "\t";
-}
-function isPhpWhitespace(character) {
-  return typeof character === "string" && /\s/u.test(character);
-}
-function findPhpLineBoundary(source, index) {
-  const newlineIndex = source.indexOf(`
-`, index);
-  if (newlineIndex === -1) {
-    return {
-      contentEnd: source.endsWith("\r") ? source.length - 1 : source.length,
-      nextStart: source.length
-    };
-  }
-  return {
-    contentEnd: source[newlineIndex - 1] === "\r" ? newlineIndex - 1 : newlineIndex,
-    nextStart: newlineIndex + 1
-  };
-}
-function parsePhpHeredocStart(source, index) {
-  if (!source.startsWith("<<<", index)) {
-    return null;
-  }
-  let cursor = index + 3;
-  while (isPhpHorizontalWhitespace(source[cursor])) {
-    cursor += 1;
-  }
-  const quote = source[cursor] === "'" || source[cursor] === '"' ? source[cursor] : "";
-  if (quote) {
-    cursor += 1;
-  }
-  if (!isPhpIdentifierStart(source[cursor])) {
-    return null;
-  }
-  const delimiterStart = cursor;
-  cursor += 1;
-  while (isPhpIdentifierPart(source[cursor])) {
-    cursor += 1;
-  }
-  const delimiter = source.slice(delimiterStart, cursor);
-  if (quote) {
-    if (source[cursor] !== quote) {
-      return null;
-    }
-    cursor += 1;
-  }
-  const lineBoundary = findPhpLineBoundary(source, cursor);
-  if (source.slice(cursor, lineBoundary.contentEnd).trim() !== "") {
-    return null;
-  }
-  return {
-    contentStart: lineBoundary.nextStart,
-    delimiter
-  };
-}
-function findPhpHeredocClosingEnd(source, index, delimiter) {
-  if (!isPhpLineStart(source, index)) {
-    return null;
-  }
-  let cursor = index;
-  while (isPhpHorizontalWhitespace(source[cursor])) {
-    cursor += 1;
-  }
-  if (!source.startsWith(delimiter, cursor)) {
-    return null;
-  }
-  cursor += delimiter.length;
-  if (isPhpIdentifierPart(source[cursor])) {
-    return null;
-  }
-  let continuationCursor = cursor;
-  while (isPhpHorizontalWhitespace(source[continuationCursor])) {
-    continuationCursor += 1;
-  }
-  const continuation = source[continuationCursor];
-  if (continuationCursor >= source.length || continuation === "\r" || continuation === `
-` || !isPhpIdentifierPart(continuation)) {
-    return cursor;
-  }
-  return null;
-}
-function skipPhpCallTrivia(source, index) {
-  let cursor = index;
-  while (cursor < source.length) {
-    while (isPhpWhitespace(source[cursor])) {
-      cursor += 1;
-    }
-    if (source[cursor] === "/" && source[cursor + 1] === "*") {
-      const commentEnd = source.indexOf("*/", cursor + 2);
-      if (commentEnd === -1) {
-        return null;
-      }
-      cursor = commentEnd + 2;
-      continue;
-    }
-    if (source[cursor] === "/" && source[cursor + 1] === "/") {
-      cursor = findPhpLineBoundary(source, cursor + 2).nextStart;
-      continue;
-    }
-    if (source[cursor] === "#" && source[cursor + 1] !== "[") {
-      cursor = findPhpLineBoundary(source, cursor + 1).nextStart;
-      continue;
-    }
-    return cursor;
-  }
-  return cursor;
-}
-function matchesPhpFunctionCallAt(source, index, functionName) {
-  if (!source.startsWith(functionName, index)) {
-    return false;
-  }
-  if (isPhpIdentifierPart(source[index - 1])) {
-    return false;
-  }
-  const cursor = index + functionName.length;
-  if (isPhpIdentifierPart(source[cursor])) {
-    return false;
-  }
-  const callStart = skipPhpCallTrivia(source, cursor);
-  return callStart !== null && source[callStart] === "(";
-}
-function createPhpScannerState() {
-  return {
-    heredocDelimiter: "",
-    interpolationComment: "",
-    interpolationDepth: 0,
-    interpolationQuote: "",
-    mode: "code"
-  };
-}
-function advancePhpScanner(source, index, state) {
-  const character = source[index];
-  if (state.mode === "heredoc") {
-    const closingEnd = findPhpHeredocClosingEnd(source, index, state.heredocDelimiter);
-    if (closingEnd !== null) {
-      state.mode = "code";
-      state.heredocDelimiter = "";
-      return { ambiguous: false, inCode: false, index: closingEnd };
-    }
-    const nextLineStart = findPhpLineBoundary(source, index).nextStart;
-    if (nextLineStart <= index) {
-      return { ambiguous: true, inCode: false, index };
-    }
-    return { ambiguous: false, inCode: false, index: nextLineStart };
-  }
-  if (state.mode === "single-quoted" || state.mode === "double-quoted") {
-    const quote = state.mode === "single-quoted" ? "'" : '"';
-    if (character === "\\") {
-      return { ambiguous: false, inCode: false, index: index + 2 };
-    }
-    if (state.mode === "double-quoted" && character === "{" && source[index + 1] === "$") {
-      state.mode = "double-quoted-interpolation";
-      state.interpolationComment = "";
-      state.interpolationDepth = 1;
-      state.interpolationQuote = "";
-      return { ambiguous: false, inCode: false, index: index + 2 };
-    }
-    if (character === quote) {
-      state.mode = "code";
-    }
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (state.mode === "double-quoted-interpolation") {
-    if (state.interpolationQuote) {
-      if (character === "\\") {
-        return { ambiguous: false, inCode: false, index: index + 2 };
-      }
-      if (character === state.interpolationQuote) {
-        state.interpolationQuote = "";
-      }
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    if (state.interpolationComment === "line") {
-      if (character === "\r" || character === `
-`) {
-        state.interpolationComment = "";
-      }
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    if (state.interpolationComment === "block") {
-      if (character === "*" && source[index + 1] === "/") {
-        state.interpolationComment = "";
-        return { ambiguous: false, inCode: false, index: index + 2 };
-      }
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    if (character === "/" && source[index + 1] === "/") {
-      state.interpolationComment = "line";
-      return { ambiguous: false, inCode: false, index: index + 2 };
-    }
-    if (character === "#" && source[index + 1] !== "[") {
-      state.interpolationComment = "line";
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    if (character === "/" && source[index + 1] === "*") {
-      state.interpolationComment = "block";
-      return { ambiguous: false, inCode: false, index: index + 2 };
-    }
-    if (character === "'" || character === '"') {
-      state.interpolationQuote = character;
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    if (character === "{") {
-      state.interpolationDepth += 1;
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    if (character === "}") {
-      state.interpolationDepth -= 1;
-      if (state.interpolationDepth <= 0) {
-        state.interpolationComment = "";
-        state.interpolationDepth = 0;
-        state.mode = "double-quoted";
-      }
-      return { ambiguous: false, inCode: false, index: index + 1 };
-    }
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (state.mode === "line-comment") {
-    if (character === "\r" || character === `
-`) {
-      state.mode = "code";
-    }
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (state.mode === "block-comment") {
-    if (character === "*" && source[index + 1] === "/") {
-      state.mode = "code";
-      return { ambiguous: false, inCode: false, index: index + 2 };
-    }
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (character === "'") {
-    state.mode = "single-quoted";
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (character === '"') {
-    state.mode = "double-quoted";
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (character === "/" && source[index + 1] === "/") {
-    state.mode = "line-comment";
-    return { ambiguous: false, inCode: false, index: index + 2 };
-  }
-  if (character === "#" && source[index + 1] !== "[") {
-    state.mode = "line-comment";
-    return { ambiguous: false, inCode: false, index: index + 1 };
-  }
-  if (character === "/" && source[index + 1] === "*") {
-    state.mode = "block-comment";
-    return { ambiguous: false, inCode: false, index: index + 2 };
-  }
-  if (character === "<") {
-    const heredocStart = parsePhpHeredocStart(source, index);
-    if (heredocStart) {
-      state.mode = "heredoc";
-      state.heredocDelimiter = heredocStart.delimiter;
-      return {
-        ambiguous: false,
-        inCode: false,
-        index: heredocStart.contentStart
-      };
-    }
-  }
-  return { ambiguous: false, inCode: true, index };
-}
-function hasPhpFunctionCall(source, functionName) {
-  const scanner = createPhpScannerState();
-  let index = 0;
-  while (index < source.length) {
-    const scan = advancePhpScanner(source, index, scanner);
-    if (scan.ambiguous) {
-      return false;
-    }
-    if (!scan.inCode) {
-      index = scan.index;
-      continue;
-    }
-    if (matchesPhpFunctionCallAt(source, index, functionName)) {
-      return true;
-    }
-    index += 1;
-  }
-  return false;
-}
-function findPhpFunctionRange(source, functionName, options = {}) {
-  const signaturePattern = new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\([^)]*\\)\\s*(?::\\s*[^{};]+)?\\s*\\{`, "u");
-  const signatureMatch = signaturePattern.exec(source);
-  if (!signatureMatch) {
-    return null;
-  }
-  const functionStart = signatureMatch.index;
-  const openBraceOffset = signatureMatch[0].lastIndexOf("{");
-  if (openBraceOffset === -1) {
-    return null;
-  }
-  const openBraceIndex = functionStart + openBraceOffset;
-  let depth = 0;
-  const scanner = createPhpScannerState();
-  let index = openBraceIndex;
-  while (index < source.length) {
-    const scan = advancePhpScanner(source, index, scanner);
-    if (scan.ambiguous) {
-      return null;
-    }
-    if (!scan.inCode) {
-      index = scan.index;
-      continue;
-    }
-    const character = source[index];
-    if (character === "{") {
-      depth += 1;
-      index += 1;
-      continue;
-    }
-    if (character !== "}") {
-      index += 1;
-      continue;
-    }
-    depth -= 1;
-    if (depth === 0) {
-      let end = index + 1;
-      if (options.includeTrailingNewlines ?? true) {
-        while (end < source.length && /[\r\n]/u.test(source[end] ?? "")) {
-          end += 1;
-        }
-      }
-      return {
-        end,
-        source: source.slice(functionStart, end),
-        start: functionStart
-      };
-    }
-    index += 1;
-  }
-  return null;
-}
-function replacePhpFunctionDefinition(source, functionName, replacement, options = {}) {
-  const functionRange = findPhpFunctionRange(source, functionName, options);
-  if (!functionRange) {
-    return null;
-  }
-  return [
-    source.slice(0, functionRange.start),
-    options.trimReplacementStart ? replacement.trimStart() : replacement,
-    source.slice(functionRange.end)
-  ].join("");
-}
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser.ts
+var import_typescript2 = __toESM(require_typescript(), 1);
 
 // ../wp-typia-project-tools/src/runtime/ts-property-names.ts
 var import_typescript = __toESM(require_typescript(), 1);
@@ -171972,10 +171604,7 @@ function getPropertyNameText(name) {
   return null;
 }
 
-// ../wp-typia-project-tools/src/runtime/workspace-inventory.ts
-function defineInventoryEntryParser(descriptor) {
-  return descriptor;
-}
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-templates.ts
 var BLOCK_CONFIG_ENTRY_MARKER = "\t// wp-typia add block entries";
 var VARIATION_CONFIG_ENTRY_MARKER = "\t// wp-typia add variation entries";
 var BLOCK_STYLE_CONFIG_ENTRY_MARKER = "\t// wp-typia add style entries";
@@ -172171,6 +171800,11 @@ export const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [
 	// wp-typia add editor-plugin entries
 ];
 `;
+
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser.ts
+function defineInventoryEntryParser() {
+  return (descriptor) => descriptor;
+}
 var BLOCK_INVENTORY_SECTION = {
   append: {
     marker: BLOCK_CONFIG_ENTRY_MARKER,
@@ -172178,7 +171812,7 @@ var BLOCK_INVENTORY_SECTION = {
   },
   parse: {
     entriesKey: "blocks",
-    entry: defineInventoryEntryParser({
+    entry: defineInventoryEntryParser()({
       entryName: "BLOCKS",
       fields: [
         { key: "apiTypesFile" },
@@ -172204,7 +171838,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "variations",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "VARIATIONS",
         fields: [
           { key: "block", required: true },
@@ -172230,7 +171864,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "blockStyles",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "BLOCK_STYLES",
         fields: [
           { key: "block", required: true },
@@ -172256,7 +171890,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "blockTransforms",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "BLOCK_TRANSFORMS",
         fields: [
           { key: "block", required: true },
@@ -172284,7 +171918,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "patterns",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "PATTERNS",
         fields: [
           { key: "file", required: true },
@@ -172309,7 +171943,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "bindingSources",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "BINDING_SOURCES",
         fields: [
           { key: "attribute" },
@@ -172337,7 +171971,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "restResources",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "REST_RESOURCES",
         fields: [
           { key: "apiFile", required: true },
@@ -172381,7 +172015,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "abilities",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "ABILITIES",
         fields: [
           { key: "clientFile", required: true },
@@ -172414,7 +172048,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "aiFeatures",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "AI_FEATURES",
         fields: [
           { key: "aiSchemaFile", required: true },
@@ -172447,7 +172081,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "adminViews",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "ADMIN_VIEWS",
         fields: [
           { key: "file", required: true },
@@ -172474,7 +172108,7 @@ var INVENTORY_SECTIONS = [
     },
     parse: {
       entriesKey: "editorPlugins",
-      entry: defineInventoryEntryParser({
+      entry: defineInventoryEntryParser()({
         entryName: "EDITOR_PLUGINS",
         fields: [
           { key: "file", required: true },
@@ -172535,14 +172169,7 @@ function getOptionalStringProperty(entryName, elementIndex, objectLiteral, key)
   }
   return;
 }
-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 (!import_typescript2.default.isPropertyAssignment(property)) {
       continue;
@@ -172561,7 +172188,19 @@ function getRequiredStringArrayProperty(entryName, elementIndex, objectLiteral,
       return element.text;
     });
   }
-  throw new Error(`${entryName}[${elementIndex}] is missing required "${key}" in scripts/block-config.ts.`);
+  return;
+}
+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) => {
@@ -172571,7 +172210,7 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
     const entry = {};
     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);
+      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,
@@ -172579,6 +172218,7 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
       });
       entry[field.key] = value;
     }
+    assertParsedInventoryEntry(entry, descriptor, elementIndex);
     return entry;
   });
 }
@@ -172653,13 +172293,15 @@ function parseWorkspaceInventorySource(source) {
   }
   return parsedInventory;
 }
+
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-read.ts
 function readWorkspaceInventory(projectDir) {
   const blockConfigPath = path4.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") {
+    if (isFileNotFoundError(error)) {
       throw new Error(`Workspace inventory file is missing at ${blockConfigPath}. Expected scripts/block-config.ts to exist.`);
     }
     throw error;
@@ -172675,7 +172317,7 @@ async function readWorkspaceInventoryAsync(projectDir) {
   try {
     source = await readFile(blockConfigPath, "utf8");
   } catch (error) {
-    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+    if (isFileNotFoundError(error)) {
       throw new Error(`Workspace inventory file is missing at ${blockConfigPath}. Expected scripts/block-config.ts to exist.`);
     }
     throw error;
@@ -172685,13 +172327,393 @@ async function readWorkspaceInventoryAsync(projectDir) {
     ...parseWorkspaceInventorySource(source)
   };
 }
-function getWorkspaceBlockSelectOptions(projectDir) {
-  return readWorkspaceInventory(projectDir).blocks.map((block) => ({
+function toWorkspaceBlockSelectOptions(blocks) {
+  return blocks.map((block) => ({
     description: block.typesFile,
     name: block.slug,
     value: block.slug
   }));
 }
+function getWorkspaceBlockSelectOptions(projectDir) {
+  return toWorkspaceBlockSelectOptions(readWorkspaceInventory(projectDir).blocks);
+}
+async function getWorkspaceBlockSelectOptionsAsync(projectDir) {
+  return toWorkspaceBlockSelectOptions((await readWorkspaceInventoryAsync(projectDir)).blocks);
+}
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-mutations.ts
+import path5 from "path";
+import { readFile as readFile2, writeFile } from "fs/promises";
+
+// ../wp-typia-project-tools/src/runtime/php-utils.ts
+function escapeRegex(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+function quotePhpString(value) {
+  return `'${value.replace(/\\/gu, "\\\\").replace(/'/gu, "\\'")}'`;
+}
+function hasPhpFunctionDefinition(source, functionName) {
+  return new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u").test(source);
+}
+function isPhpIdentifierStart(character) {
+  return /^[A-Za-z_]$/u.test(character ?? "");
+}
+function isPhpIdentifierPart(character) {
+  return /^[A-Za-z0-9_]$/u.test(character ?? "");
+}
+function isPhpLineStart(source, index) {
+  return index === 0 || source[index - 1] === `
+`;
+}
+function isPhpHorizontalWhitespace(character) {
+  return character === " " || character === "\t";
+}
+function isPhpWhitespace(character) {
+  return typeof character === "string" && /\s/u.test(character);
+}
+function findPhpLineBoundary(source, index) {
+  const newlineIndex = source.indexOf(`
+`, index);
+  if (newlineIndex === -1) {
+    return {
+      contentEnd: source.endsWith("\r") ? source.length - 1 : source.length,
+      nextStart: source.length
+    };
+  }
+  return {
+    contentEnd: source[newlineIndex - 1] === "\r" ? newlineIndex - 1 : newlineIndex,
+    nextStart: newlineIndex + 1
+  };
+}
+function parsePhpHeredocStart(source, index) {
+  if (!source.startsWith("<<<", index)) {
+    return null;
+  }
+  let cursor = index + 3;
+  while (isPhpHorizontalWhitespace(source[cursor])) {
+    cursor += 1;
+  }
+  const quote = source[cursor] === "'" || source[cursor] === '"' ? source[cursor] : "";
+  if (quote) {
+    cursor += 1;
+  }
+  if (!isPhpIdentifierStart(source[cursor])) {
+    return null;
+  }
+  const delimiterStart = cursor;
+  cursor += 1;
+  while (isPhpIdentifierPart(source[cursor])) {
+    cursor += 1;
+  }
+  const delimiter = source.slice(delimiterStart, cursor);
+  if (quote) {
+    if (source[cursor] !== quote) {
+      return null;
+    }
+    cursor += 1;
+  }
+  const lineBoundary = findPhpLineBoundary(source, cursor);
+  if (source.slice(cursor, lineBoundary.contentEnd).trim() !== "") {
+    return null;
+  }
+  return {
+    contentStart: lineBoundary.nextStart,
+    delimiter
+  };
+}
+function findPhpHeredocClosingEnd(source, index, delimiter) {
+  if (!isPhpLineStart(source, index)) {
+    return null;
+  }
+  let cursor = index;
+  while (isPhpHorizontalWhitespace(source[cursor])) {
+    cursor += 1;
+  }
+  if (!source.startsWith(delimiter, cursor)) {
+    return null;
+  }
+  cursor += delimiter.length;
+  if (isPhpIdentifierPart(source[cursor])) {
+    return null;
+  }
+  let continuationCursor = cursor;
+  while (isPhpHorizontalWhitespace(source[continuationCursor])) {
+    continuationCursor += 1;
+  }
+  const continuation = source[continuationCursor];
+  if (continuationCursor >= source.length || continuation === "\r" || continuation === `
+` || !isPhpIdentifierPart(continuation)) {
+    return cursor;
+  }
+  return null;
+}
+function skipPhpCallTrivia(source, index) {
+  let cursor = index;
+  while (cursor < source.length) {
+    while (isPhpWhitespace(source[cursor])) {
+      cursor += 1;
+    }
+    if (source[cursor] === "/" && source[cursor + 1] === "*") {
+      const commentEnd = source.indexOf("*/", cursor + 2);
+      if (commentEnd === -1) {
+        return null;
+      }
+      cursor = commentEnd + 2;
+      continue;
+    }
+    if (source[cursor] === "/" && source[cursor + 1] === "/") {
+      cursor = findPhpLineBoundary(source, cursor + 2).nextStart;
+      continue;
+    }
+    if (source[cursor] === "#" && source[cursor + 1] !== "[") {
+      cursor = findPhpLineBoundary(source, cursor + 1).nextStart;
+      continue;
+    }
+    return cursor;
+  }
+  return cursor;
+}
+function matchesPhpFunctionCallAt(source, index, functionName) {
+  if (!source.startsWith(functionName, index)) {
+    return false;
+  }
+  if (isPhpIdentifierPart(source[index - 1])) {
+    return false;
+  }
+  const cursor = index + functionName.length;
+  if (isPhpIdentifierPart(source[cursor])) {
+    return false;
+  }
+  const callStart = skipPhpCallTrivia(source, cursor);
+  return callStart !== null && source[callStart] === "(";
+}
+function createPhpScannerState() {
+  return {
+    heredocDelimiter: "",
+    interpolationComment: "",
+    interpolationDepth: 0,
+    interpolationQuote: "",
+    mode: "code"
+  };
+}
+function advancePhpScanner(source, index, state) {
+  const character = source[index];
+  if (state.mode === "heredoc") {
+    const closingEnd = findPhpHeredocClosingEnd(source, index, state.heredocDelimiter);
+    if (closingEnd !== null) {
+      state.mode = "code";
+      state.heredocDelimiter = "";
+      return { ambiguous: false, inCode: false, index: closingEnd };
+    }
+    const nextLineStart = findPhpLineBoundary(source, index).nextStart;
+    if (nextLineStart <= index) {
+      return { ambiguous: true, inCode: false, index };
+    }
+    return { ambiguous: false, inCode: false, index: nextLineStart };
+  }
+  if (state.mode === "single-quoted" || state.mode === "double-quoted") {
+    const quote = state.mode === "single-quoted" ? "'" : '"';
+    if (character === "\\") {
+      return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (state.mode === "double-quoted" && character === "{" && source[index + 1] === "$") {
+      state.mode = "double-quoted-interpolation";
+      state.interpolationComment = "";
+      state.interpolationDepth = 1;
+      state.interpolationQuote = "";
+      return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === quote) {
+      state.mode = "code";
+    }
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (state.mode === "double-quoted-interpolation") {
+    if (state.interpolationQuote) {
+      if (character === "\\") {
+        return { ambiguous: false, inCode: false, index: index + 2 };
+      }
+      if (character === state.interpolationQuote) {
+        state.interpolationQuote = "";
+      }
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.interpolationComment === "line") {
+      if (character === "\r" || character === `
+`) {
+        state.interpolationComment = "";
+      }
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.interpolationComment === "block") {
+      if (character === "*" && source[index + 1] === "/") {
+        state.interpolationComment = "";
+        return { ambiguous: false, inCode: false, index: index + 2 };
+      }
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "/" && source[index + 1] === "/") {
+      state.interpolationComment = "line";
+      return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === "#" && source[index + 1] !== "[") {
+      state.interpolationComment = "line";
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "/" && source[index + 1] === "*") {
+      state.interpolationComment = "block";
+      return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === "'" || character === '"') {
+      state.interpolationQuote = character;
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "{") {
+      state.interpolationDepth += 1;
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "}") {
+      state.interpolationDepth -= 1;
+      if (state.interpolationDepth <= 0) {
+        state.interpolationComment = "";
+        state.interpolationDepth = 0;
+        state.mode = "double-quoted";
+      }
+      return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (state.mode === "line-comment") {
+    if (character === "\r" || character === `
+`) {
+      state.mode = "code";
+    }
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (state.mode === "block-comment") {
+    if (character === "*" && source[index + 1] === "/") {
+      state.mode = "code";
+      return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (character === "'") {
+    state.mode = "single-quoted";
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (character === '"') {
+    state.mode = "double-quoted";
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (character === "/" && source[index + 1] === "/") {
+    state.mode = "line-comment";
+    return { ambiguous: false, inCode: false, index: index + 2 };
+  }
+  if (character === "#" && source[index + 1] !== "[") {
+    state.mode = "line-comment";
+    return { ambiguous: false, inCode: false, index: index + 1 };
+  }
+  if (character === "/" && source[index + 1] === "*") {
+    state.mode = "block-comment";
+    return { ambiguous: false, inCode: false, index: index + 2 };
+  }
+  if (character === "<") {
+    const heredocStart = parsePhpHeredocStart(source, index);
+    if (heredocStart) {
+      state.mode = "heredoc";
+      state.heredocDelimiter = heredocStart.delimiter;
+      return {
+        ambiguous: false,
+        inCode: false,
+        index: heredocStart.contentStart
+      };
+    }
+  }
+  return { ambiguous: false, inCode: true, index };
+}
+function hasPhpFunctionCall(source, functionName) {
+  const scanner = createPhpScannerState();
+  let index = 0;
+  while (index < source.length) {
+    const scan = advancePhpScanner(source, index, scanner);
+    if (scan.ambiguous) {
+      return false;
+    }
+    if (!scan.inCode) {
+      index = scan.index;
+      continue;
+    }
+    if (matchesPhpFunctionCallAt(source, index, functionName)) {
+      return true;
+    }
+    index += 1;
+  }
+  return false;
+}
+function findPhpFunctionRange(source, functionName, options = {}) {
+  const signaturePattern = new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\([^)]*\\)\\s*(?::\\s*[^{};]+)?\\s*\\{`, "u");
+  const signatureMatch = signaturePattern.exec(source);
+  if (!signatureMatch) {
+    return null;
+  }
+  const functionStart = signatureMatch.index;
+  const openBraceOffset = signatureMatch[0].lastIndexOf("{");
+  if (openBraceOffset === -1) {
+    return null;
+  }
+  const openBraceIndex = functionStart + openBraceOffset;
+  let depth = 0;
+  const scanner = createPhpScannerState();
+  let index = openBraceIndex;
+  while (index < source.length) {
+    const scan = advancePhpScanner(source, index, scanner);
+    if (scan.ambiguous) {
+      return null;
+    }
+    if (!scan.inCode) {
+      index = scan.index;
+      continue;
+    }
+    const character = source[index];
+    if (character === "{") {
+      depth += 1;
+      index += 1;
+      continue;
+    }
+    if (character !== "}") {
+      index += 1;
+      continue;
+    }
+    depth -= 1;
+    if (depth === 0) {
+      let end = index + 1;
+      if (options.includeTrailingNewlines ?? true) {
+        while (end < source.length && /[\r\n]/u.test(source[end] ?? "")) {
+          end += 1;
+        }
+      }
+      return {
+        end,
+        source: source.slice(functionStart, end),
+        start: functionStart
+      };
+    }
+    index += 1;
+  }
+  return null;
+}
+function replacePhpFunctionDefinition(source, functionName, replacement, options = {}) {
+  const functionRange = findPhpFunctionRange(source, functionName, options);
+  if (!functionRange) {
+    return null;
+  }
+  return [
+    source.slice(0, functionRange.start),
+    options.trimReplacementStart ? replacement.trimStart() : replacement,
+    source.slice(functionRange.end)
+  ].join("");
+}
+
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-mutations.ts
 function ensureWorkspaceInventorySections(source) {
   let nextSource = source.trimEnd();
   for (const section of INVENTORY_SECTIONS) {
@@ -172718,9 +172740,10 @@ function appendEntriesAtMarker(source, marker, entries) {
   if (!source.includes(marker)) {
     throw new Error(`Workspace inventory marker "${marker}" is missing in scripts/block-config.ts.`);
   }
-  return source.replace(marker, `${entries.join(`
+  const replacement = `${entries.join(`
 `)}
-${marker}`);
+${marker}`;
+  return source.replace(marker, () => replacement);
 }
 function appendInventorySectionEntries(source, options) {
   let nextSource = source;
@@ -172794,14 +172817,13 @@ function updateWorkspaceInventorySource(source, options = {}) {
   return nextSource;
 }
 async function appendWorkspaceInventoryEntries(projectDir, options) {
-  const blockConfigPath = path4.join(projectDir, "scripts", "block-config.ts");
-  const source = await readFile(blockConfigPath, "utf8");
+  const blockConfigPath = path5.join(projectDir, "scripts", "block-config.ts");
+  const source = await readFile2(blockConfigPath, "utf8");
   const nextSource = updateWorkspaceInventorySource(source, options);
   if (nextSource !== source) {
     await writeFile(blockConfigPath, nextSource, "utf8");
   }
 }
+export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, REST_RESOURCE_METHOD_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, resolveRestResourceNamespace, assertValidRestResourceMethods, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
 
-export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, REST_RESOURCE_METHOD_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, resolveRestResourceNamespace, assertValidRestResourceMethods, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, pathExists, readOptionalUtf8File, getNodeErrorCode, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
-
-//# debugId=282F6AFDCE13C26664756E2164756E21
+//# debugId=10B8DF3957EF445164756E2164756E21