wp-typia 0.23.0 → 0.23.1

package/dist-bunli/{cli-2rqf6t0b.js → cli-e4bwd81c.js}

@@ -3,10 +3,10 @@ import {
   formatRunScript,
   inferPackageManagerId,
   parsePackageManagerField
-} from "./cli-52ke0ptp.js";
+} from "./cli-am5x7tb4.js";
 import {
-  __reExport
-} from "./cli-xnn9xjcy.js";
+  readJsonFileSync
+} from "./cli-ccax7s0s.js";
 
 // ../wp-typia-project-tools/src/runtime/migration-utils.ts
 import fs from "fs";
@@ -31,11 +31,6 @@ function stableJsonStringify(value) {
   return JSON.stringify(toStableJsonValue(value));
 }
 
-// ../wp-typia-project-tools/src/runtime/json-utils.ts
-var exports_json_utils = {};
-__reExport(exports_json_utils, json_utils);
-import"@wp-typia/block-runtime/json-utils";
-
 // ../wp-typia-project-tools/src/runtime/migration-utils.ts
 var MIGRATION_VERSION_LABEL_PATTERN = /^v([1-9]\d*)$/;
 var LEGACY_SEMVER_MIGRATION_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
@@ -97,7 +92,9 @@ function createTransformFixtureValue(attribute, pathLabel) {
   }
 }
 function readJson(filePath) {
-  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  return readJsonFileSync(filePath, {
+    context: "migration JSON file"
+  });
 }
 function renderPhpValue(value, indentLevel) {
   const indent = "\t".repeat(indentLevel);
@@ -1258,6 +1255,6 @@ ${blocksSource}
 export default migrationConfig;
 `, "utf8");
 }
-export { isPlainObject, stableJsonStringify, exports_json_utils, getValueAtPath, setValueAtPath, deleteValueAtPath, createFixtureScalarValue, createTransformFixtureValue, readJson, renderPhpValue, copyFile, sanitizeSaveSnapshotSource, sanitizeSnapshotBlockJson, runProjectScriptIfPresent, detectPackageManagerId, getLocalTsxBinary, isInteractiveTerminal, resolveTargetMigrationVersion, assertMigrationVersionLabel, compareMigrationVersionLabels, formatLegacyMigrationWorkspaceResetGuidance, escapeForCode, renderObjectKey, isNumber, parseMigrationConfig, ROOT_PHP_MIGRATION_REGISTRY, SNAPSHOT_DIR, MIGRATION_TODO_PREFIX, ensureAdvancedMigrationProject, discoverMigrationInitLayout, getProjectPaths, getSnapshotRoot, getSnapshotBlockJsonPath, getSnapshotManifestPath, getAvailableSnapshotVersionsForBlock, createMissingBlockSnapshotMessage, getSnapshotSavePath, getGeneratedDirForBlock, getRuleFilePath, getFixtureFilePath, ensureMigrationDirectories, discoverMigrationEntries, assertRuleHasNoTodos, readRuleMetadata, writeInitialMigrationScaffold, assertNoLegacySemverMigrationWorkspace, loadMigrationProject, writeMigrationConfig };
+export { isPlainObject, stableJsonStringify, getValueAtPath, setValueAtPath, deleteValueAtPath, createFixtureScalarValue, createTransformFixtureValue, readJson, renderPhpValue, copyFile, sanitizeSaveSnapshotSource, sanitizeSnapshotBlockJson, runProjectScriptIfPresent, detectPackageManagerId, getLocalTsxBinary, isInteractiveTerminal, resolveTargetMigrationVersion, assertMigrationVersionLabel, compareMigrationVersionLabels, formatLegacyMigrationWorkspaceResetGuidance, escapeForCode, renderObjectKey, isNumber, parseMigrationConfig, ROOT_PHP_MIGRATION_REGISTRY, SNAPSHOT_DIR, MIGRATION_TODO_PREFIX, ensureAdvancedMigrationProject, discoverMigrationInitLayout, getProjectPaths, getSnapshotRoot, getSnapshotBlockJsonPath, getSnapshotManifestPath, getAvailableSnapshotVersionsForBlock, createMissingBlockSnapshotMessage, getSnapshotSavePath, getGeneratedDirForBlock, getRuleFilePath, getFixtureFilePath, ensureMigrationDirectories, discoverMigrationEntries, assertRuleHasNoTodos, readRuleMetadata, writeInitialMigrationScaffold, assertNoLegacySemverMigrationWorkspace, loadMigrationProject, writeMigrationConfig };
 
-//# debugId=D28E1D6B4C0330A964756E2164756E21
+//# debugId=595C3CACBE984E6464756E2164756E21

package/dist-bunli/{cli-9npd9was.js → cli-epsczb1c.js}

@@ -18,7 +18,6 @@ import {
   ensureAdvancedMigrationProject,
   ensureMigrationDirectories,
   escapeForCode,
-  exports_json_utils,
   formatLegacyMigrationWorkspaceResetGuidance,
   getAvailableSnapshotVersionsForBlock,
   getFixtureFilePath,
@@ -45,20 +44,23 @@ import {
   setValueAtPath,
   writeInitialMigrationScaffold,
   writeMigrationConfig
-} from "./cli-2rqf6t0b.js";
+} from "./cli-e4bwd81c.js";
 import {
   readWorkspaceInventory
-} from "./cli-ts9thts5.js";
+} from "./cli-k5q5v8g6.js";
 import {
   getInvalidWorkspaceProjectReason,
   tryResolveWorkspaceProject
-} from "./cli-hhp1d348.js";
+} from "./cli-1170yyve.js";
 import {
   formatRunScript
-} from "./cli-52ke0ptp.js";
+} from "./cli-am5x7tb4.js";
+import {
+  cloneJsonValue
+} from "./cli-ccax7s0s.js";
 import {
   createReadlinePrompt
-} from "./cli-bq2v559b.js";
+} from "./cli-rdcga1bd.js";
 
 // ../wp-typia-project-tools/src/runtime/migrations.ts
 import fs8 from "fs";
@@ -895,7 +897,7 @@ function createEdgeFixtureDocument(projectDir, block, fromVersion, toVersion, di
 }
 function createRenameFixtureCases(baseAttributes, renameCandidates) {
   return renameCandidates.filter((candidate) => candidate.autoApply).map((candidate) => {
-    const nextInput = exports_json_utils.cloneJsonValue(baseAttributes);
+    const nextInput = cloneJsonValue(baseAttributes);
     const legacyValue = getValueAtPath(nextInput, candidate.legacyPath);
     deleteValueAtPath(nextInput, candidate.currentPath);
     if (legacyValue === undefined) {
@@ -909,7 +911,7 @@ function createRenameFixtureCases(baseAttributes, renameCandidates) {
 }
 function createTransformFixtureCases(baseAttributes, transformSuggestions) {
   return transformSuggestions.map((suggestion) => {
-    const nextInput = exports_json_utils.cloneJsonValue(baseAttributes);
+    const nextInput = cloneJsonValue(baseAttributes);
     const legacyPath = suggestion.legacyPath ?? suggestion.currentPath;
     setValueAtPath(nextInput, legacyPath, createTransformFixtureValue(suggestion.attribute, suggestion.currentPath));
     return {
@@ -925,7 +927,7 @@ function createUnionFixtureCases(baseAttributes, manifestAttributes, renameCandi
       continue;
     }
     for (const [branchKey, branch] of Object.entries(attribute.ts.union.branches ?? {})) {
-      const nextInput = exports_json_utils.cloneJsonValue(baseAttributes);
+      const nextInput = cloneJsonValue(baseAttributes);
       const legacyPath = renameCandidates.find((candidate) => candidate.autoApply && candidate.currentPath === key)?.legacyPath ?? key;
       setValueAtPath(nextInput, legacyPath, createUnionBranchFixtureValue(attribute.ts.union.discriminator, branchKey, branch));
       cases.push({
@@ -2607,4 +2609,4 @@ function seedProjectMigrations(projectDir, currentMigrationVersion, blocks, { re
 
 export { formatMigrationHelpText, parseMigrationArgs, formatDiffReport, verifyProjectMigrations, doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, runMigrationCommand, planProjectMigrations, wizardProjectMigrations, initProjectMigrations, snapshotProjectVersion, diffProjectMigrations, scaffoldProjectMigrations, seedProjectMigrations };
 
-//# debugId=3FFBD2D8A6265FAC64756E2164756E21
+//# debugId=A37691396E12D94E64756E2164756E21

package/dist-bunli/{cli-agywa5n6.js → cli-fp16mntv.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   PROJECT_TOOLS_PACKAGE_ROOT
-} from "./cli-qse6myha.js";
+} from "./cli-8hxf9qw6.js";
 import {
   getOptionalNodeErrorCode
-} from "./cli-ts9thts5.js";
+} from "./cli-k5q5v8g6.js";
 
 // ../wp-typia-project-tools/src/runtime/package-versions.ts
 import fs from "fs";
@@ -87,7 +87,11 @@ function readPackageManifest(location) {
   if (!location.packageJsonPath || location.source === null) {
     return null;
   }
-  return JSON.parse(location.source);
+  try {
+    return JSON.parse(location.source);
+  } catch (error) {
+    throw new Error(`Failed to parse package version manifest at ${location.packageJsonPath}: ${error instanceof Error ? error.message : String(error)}`);
+  }
 }
 function tryReadPackageManifest(location) {
   if (!location) {
@@ -184,4 +188,4 @@ function getPackageVersions() {
 
 export { DEFAULT_WORDPRESS_ABILITIES_VERSION, DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION, DEFAULT_WORDPRESS_CORE_DATA_VERSION, DEFAULT_WORDPRESS_DATA_VERSION, DEFAULT_WORDPRESS_DATAVIEWS_VERSION, DEFAULT_WP_TYPIA_DATAVIEWS_VERSION, resolveManagedPackageVersionRange, getPackageVersions };
 
-//# debugId=00D2485EFE2B66E864756E2164756E21
+//# debugId=807B1242BD906C4E64756E2164756E21

package/dist-bunli/{cli-init-xnsbxncv.js → cli-init-2b4yn2cc.js}

@@ -1,11 +1,11 @@
 // @bun
 import {
   getPackageVersions
-} from "./cli-agywa5n6.js";
-import"./cli-qse6myha.js";
+} from "./cli-fp16mntv.js";
+import"./cli-8hxf9qw6.js";
 import {
   discoverMigrationInitLayout
-} from "./cli-2rqf6t0b.js";
+} from "./cli-e4bwd81c.js";
 import {
   quoteTsString,
   require_typescript,
@@ -13,24 +13,27 @@ import {
   snapshotWorkspaceFiles,
   toPascalCase,
   updateWorkspaceInventorySource
-} from "./cli-ts9thts5.js";
+} from "./cli-k5q5v8g6.js";
 import"./cli-cvxvcw7c.js";
 import"./cli-43mx1vfb.js";
 import {
   CLI_DIAGNOSTIC_CODES,
   createCliDiagnosticCodeError
-} from "./cli-p95wr1q8.js";
+} from "./cli-tq730sqt.js";
 import {
   parseWorkspacePackageManagerId,
   tryResolveWorkspaceProject
-} from "./cli-hhp1d348.js";
+} from "./cli-1170yyve.js";
 import {
   formatAddDevDependenciesCommand,
   formatPackageExecCommand,
   formatRunScript,
   getPackageManager,
   transformPackageManagerText
-} from "./cli-52ke0ptp.js";
+} from "./cli-am5x7tb4.js";
+import {
+  readJsonFileSync
+} from "./cli-ccax7s0s.js";
 import {
   __toESM
 } from "./cli-xnn9xjcy.js";
@@ -61,9 +64,10 @@ function readProjectPackageJson(projectDir) {
   if (!fs.existsSync(packageJsonPath)) {
     return null;
   }
-  const source = fs.readFileSync(packageJsonPath, "utf8");
   try {
-    return JSON.parse(source);
+    return readJsonFileSync(packageJsonPath, {
+      context: "project package manifest"
+    });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
@@ -873,4 +877,4 @@ export {
   applyInitPlan
 };
 
-//# debugId=4702A433619DCEF464756E2164756E21
+//# debugId=DC4EACE5C620361164756E2164756E21

package/dist-bunli/{cli-ts9thts5.js → cli-k5q5v8g6.js}

@@ -5,10 +5,13 @@ import {
 import {
   CLI_DIAGNOSTIC_CODES,
   createCliDiagnosticCodeError
-} from "./cli-p95wr1q8.js";
+} from "./cli-tq730sqt.js";
 import {
   WORKSPACE_TEMPLATE_PACKAGE
-} from "./cli-hhp1d348.js";
+} from "./cli-1170yyve.js";
+import {
+  safeJsonParse
+} from "./cli-ccax7s0s.js";
 import {
   __commonJS,
   __require,
@@ -171284,6 +171287,9 @@ function isGeneratedRestResourceRoutePatternCompatible(routePattern) {
   const hasUnsupportedCapture = REST_ROUTE_UNSUPPORTED_CAPTURE_PATTERN.test(routePattern);
   return !hasUnsupportedCapture && (!hasRegexGroup || namedCaptures.length === 1 && namedCaptures[0] === "id");
 }
+function collectRestRouteNamedCaptureNames(routePattern) {
+  return Array.from(new Set(Array.from(routePattern.matchAll(REST_ROUTE_NAMED_CAPTURE_PATTERN), (match) => match[1])));
+}
 function resolveManualRestContractPathPattern(slug, pathPattern) {
   return resolveRestRoutePathPattern({
     defaultPath: `/${slug}`,
@@ -171380,7 +171386,7 @@ function formatAddHelpText() {
   return `Usage:
   wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>] [--dry-run]
   wp-typia add block <name> [--template <${ADD_BLOCK_TEMPLATE_IDS.join("|")}>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--dry-run]
-  wp-typia add integration-env <name> [--wp-env] [--service <none|docker-compose>] [--dry-run]
+  wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>] [--dry-run]
   wp-typia add variation <name> --block <block-slug> [--dry-run]
   wp-typia add style <name> --block <block-slug> [--dry-run]
   wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug> [--dry-run]
@@ -171388,7 +171394,7 @@ function formatAddHelpText() {
   wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--dry-run]
   wp-typia add contract <name> [--type <ExportedTypeName>] [--dry-run]
   wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <${REST_RESOURCE_METHOD_IDS.join(",")}>] [--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--dry-run]
-  wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--dry-run]
+  wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>] [--dry-run]
   wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>] [--hide-from-rest] [--dry-run]
   wp-typia add ability <name> [--dry-run]
   wp-typia add ai-feature <name> [--namespace <vendor/v1>] [--dry-run]
@@ -171404,6 +171410,7 @@ Notes:
   Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
   Generated admin-view workspaces add \`@wp-typia/dataviews\` and the needed WordPress DataViews packages as opt-in dependencies.
   \`add integration-env\` generates an opt-in local smoke starter under \`scripts/integration-smoke/\`, updates \`.env.example\`, and can add \`@wordpress/env\` plus \`.wp-env.json\` when \`--wp-env\` is passed.
+  Pass \`--release-zip\` to add \`release:zip\`, \`release:zip:check\`, and \`qa:check\` scripts for plugin QA packaging.
   Pass \`--service docker-compose\` to include a placeholder local service stack that can be adapted to project-specific dependencies.
   \`query-loop\` is a create-time scaffold family. Use \`wp-typia create <project-dir> --template query-loop\` instead of \`wp-typia add block\`.
   \`add variation\` targets an existing block slug from \`scripts/block-config.ts\`.
@@ -171413,7 +171420,7 @@ Notes:
   \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare an end-to-end bindable attribute on an existing generated block.
   \`add contract\` registers a standalone TypeScript wire contract under \`src/contracts/\` and generates a stable JSON Schema artifact without creating PHP route glue.
   \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`. Use \`--route-pattern\`, \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` when an existing WordPress controller or permission model needs to own part of the generated route surface.
-  Pass \`--manual\` with \`add rest-resource\` to track an external REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files.
+  Pass \`--manual\` with \`add rest-resource\` to track an external/provider REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files. Manual routes may still declare \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` as metadata for the route owner. Settings contracts can add \`--secret-field\` with \`--secret-preserve-on-empty\` metadata so generated schemas, clients, and admin forms treat blank secret submissions as preserve-by-default.
   \`add post-meta\` scaffolds a typed post meta contract under \`src/post-meta/\`, generates a schema artifact, and wires \`register_post_meta()\` helpers under \`inc/post-meta/\`.
   \`add ability\` scaffolds typed workflow abilities under \`src/abilities/\` and server registration under \`inc/abilities/\`.
   \`add ai-feature\` scaffolds server-owned AI feature endpoints under \`src/ai-features/\` and PHP route glue under \`inc/ai-features/\`.
@@ -171559,7 +171566,10 @@ async function readWorkspaceBlockJson(projectDir, blockSlug) {
   }
   let blockJson;
   try {
-    blockJson = parseScaffoldBlockMetadata(JSON.parse(source));
+    blockJson = parseScaffoldBlockMetadata(safeJsonParse(source, {
+      context: "workspace block metadata",
+      filePath: blockJsonPath
+    }));
   } catch (error) {
     throw new Error(error instanceof Error ? `Failed to parse ${path2.relative(projectDir, blockJsonPath)}: ${error.message}` : `Failed to parse ${path2.relative(projectDir, blockJsonPath)}.`);
   }
@@ -171894,6 +171904,9 @@ import path4 from "path";
 import { readFile } from "fs/promises";
 
 // ../wp-typia-project-tools/src/runtime/workspace-inventory-parser.ts
+var import_typescript3 = __toESM(require_typescript(), 1);
+
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser-entries.ts
 var import_typescript2 = __toESM(require_typescript(), 1);
 
 // ../wp-typia-project-tools/src/runtime/ts-property-names.ts
@@ -171905,6 +171918,162 @@ function getPropertyNameText(name) {
   return null;
 }
 
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser-validation.ts
+function defineInventoryEntryParser() {
+  return (descriptor) => descriptor;
+}
+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.`);
+  }
+}
+
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser-entries.ts
+function findExportedArrayLiteral(sourceFile, exportName) {
+  for (const statement of sourceFile.statements) {
+    if (!import_typescript2.default.isVariableStatement(statement)) {
+      continue;
+    }
+    if (!statement.modifiers?.some((modifier) => modifier.kind === import_typescript2.default.SyntaxKind.ExportKeyword)) {
+      continue;
+    }
+    for (const declaration of statement.declarationList.declarations) {
+      if (!import_typescript2.default.isIdentifier(declaration.name) || declaration.name.text !== exportName) {
+        continue;
+      }
+      if (declaration.initializer && import_typescript2.default.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 (!import_typescript2.default.isPropertyAssignment(property)) {
+      continue;
+    }
+    const propertyName = getPropertyNameText(property.name);
+    if (propertyName !== key) {
+      continue;
+    }
+    if (import_typescript2.default.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;
+}
+function getOptionalStringArrayProperty(entryName, elementIndex, objectLiteral, key) {
+  for (const property of objectLiteral.properties) {
+    if (!import_typescript2.default.isPropertyAssignment(property)) {
+      continue;
+    }
+    const propertyName = getPropertyNameText(property.name);
+    if (propertyName !== key) {
+      continue;
+    }
+    if (!import_typescript2.default.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 (!import_typescript2.default.isStringLiteralLike(element)) {
+        throw new Error(`${entryName}[${elementIndex}].${key}[${itemIndex}] must use a string literal in scripts/block-config.ts.`);
+      }
+      return element.text;
+    });
+  }
+  return;
+}
+function getOptionalBooleanProperty(entryName, elementIndex, objectLiteral, key) {
+  for (const property of objectLiteral.properties) {
+    if (!import_typescript2.default.isPropertyAssignment(property)) {
+      continue;
+    }
+    const propertyName = getPropertyNameText(property.name);
+    if (propertyName !== key) {
+      continue;
+    }
+    if (property.initializer.kind === import_typescript2.default.SyntaxKind.TrueKeyword) {
+      return true;
+    }
+    if (property.initializer.kind === import_typescript2.default.SyntaxKind.FalseKeyword) {
+      return false;
+    }
+    throw new Error(`${entryName}[${elementIndex}] must use a boolean literal for "${key}" in scripts/block-config.ts.`);
+  }
+  return;
+}
+function parseInventoryEntries(arrayLiteral, descriptor) {
+  return arrayLiteral.elements.map((element, elementIndex) => {
+    if (!import_typescript2.default.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) : kind === "boolean" ? getOptionalBooleanProperty(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
+  };
+}
+
 // ../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";
@@ -172023,6 +172192,7 @@ export interface WorkspaceRestResourceBaseConfig {
 		typeof import( '@wp-typia/block-runtime/metadata-core' ).defineEndpointManifest
 	>;
 	secretFieldName?: string;
+	secretPreserveOnEmpty?: boolean;
 	secretStateFieldName?: string;
 	slug: string;
 	typesFile: string;
@@ -172163,10 +172333,7 @@ export const EDITOR_PLUGINS: WorkspaceEditorPluginConfig[] = [
 ];
 `;
 
-// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser.ts
-function defineInventoryEntryParser() {
-  return (descriptor) => descriptor;
-}
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-section-descriptors.ts
 var BLOCK_INVENTORY_SECTION = {
   append: {
     marker: BLOCK_CONFIG_ENTRY_MARKER,
@@ -172414,6 +172581,7 @@ var INVENTORY_SECTIONS = [
           { key: "responseTypeName" },
           { key: "routePattern" },
           { key: "secretFieldName" },
+          { key: "secretPreserveOnEmpty", kind: "boolean" },
           { key: "secretStateFieldName" },
           { key: "slug", required: true },
           { key: "typesFile", required: true },
@@ -172578,157 +172746,10 @@ var INVENTORY_SECTIONS = [
     }
   }
 ];
-function findExportedArrayLiteral(sourceFile, exportName) {
-  for (const statement of sourceFile.statements) {
-    if (!import_typescript2.default.isVariableStatement(statement)) {
-      continue;
-    }
-    if (!statement.modifiers?.some((modifier) => modifier.kind === import_typescript2.default.SyntaxKind.ExportKeyword)) {
-      continue;
-    }
-    for (const declaration of statement.declarationList.declarations) {
-      if (!import_typescript2.default.isIdentifier(declaration.name) || declaration.name.text !== exportName) {
-        continue;
-      }
-      if (declaration.initializer && import_typescript2.default.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 (!import_typescript2.default.isPropertyAssignment(property)) {
-      continue;
-    }
-    const propertyName = getPropertyNameText(property.name);
-    if (propertyName !== key) {
-      continue;
-    }
-    if (import_typescript2.default.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;
-}
-function getOptionalStringArrayProperty(entryName, elementIndex, objectLiteral, key) {
-  for (const property of objectLiteral.properties) {
-    if (!import_typescript2.default.isPropertyAssignment(property)) {
-      continue;
-    }
-    const propertyName = getPropertyNameText(property.name);
-    if (propertyName !== key) {
-      continue;
-    }
-    if (!import_typescript2.default.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 (!import_typescript2.default.isStringLiteralLike(element)) {
-        throw new Error(`${entryName}[${elementIndex}].${key}[${itemIndex}] must use a string literal in scripts/block-config.ts.`);
-      }
-      return element.text;
-    });
-  }
-  return;
-}
-function getOptionalBooleanProperty(entryName, elementIndex, objectLiteral, key) {
-  for (const property of objectLiteral.properties) {
-    if (!import_typescript2.default.isPropertyAssignment(property)) {
-      continue;
-    }
-    const propertyName = getPropertyNameText(property.name);
-    if (propertyName !== key) {
-      continue;
-    }
-    if (property.initializer.kind === import_typescript2.default.SyntaxKind.TrueKeyword) {
-      return true;
-    }
-    if (property.initializer.kind === import_typescript2.default.SyntaxKind.FalseKeyword) {
-      return false;
-    }
-    throw new Error(`${entryName}[${elementIndex}] must use a boolean literal for "${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) => {
-    if (!import_typescript2.default.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) : kind === "boolean" ? getOptionalBooleanProperty(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
-  };
-}
+
+// ../wp-typia-project-tools/src/runtime/workspace-inventory-parser.ts
 function parseWorkspaceInventorySource(source) {
-  const sourceFile = import_typescript2.default.createSourceFile("block-config.ts", source, import_typescript2.default.ScriptTarget.Latest, true, import_typescript2.default.ScriptKind.TS);
+  const sourceFile = import_typescript3.default.createSourceFile("block-config.ts", source, import_typescript3.default.ScriptTarget.Latest, true, import_typescript3.default.ScriptKind.TS);
   const parsedInventory = {
     abilities: [],
     adminViews: [],
@@ -173337,6 +173358,7 @@ function updateWorkspaceInventorySource(source, options = {}) {
     ["responseTypeName", "\tresponseTypeName?: string;"],
     ["routePattern", "\troutePattern?: string;"],
     ["secretFieldName", "\tsecretFieldName?: string;"],
+    ["secretPreserveOnEmpty", "\tsecretPreserveOnEmpty?: boolean;"],
     ["secretStateFieldName", "\tsecretStateFieldName?: string;"]
   ]) {
     nextSource = upsertInterfaceField(nextSource, "WorkspaceRestResourceConfig", fieldName, fieldSource);
@@ -173351,6 +173373,6 @@ async function appendWorkspaceInventoryEntries(projectDir, options) {
     await writeFile(blockConfigPath, nextSource, "utf8");
   }
 }
-export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, REST_RESOURCE_METHOD_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, MANUAL_REST_CONTRACT_AUTH_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, assertValidTypeScriptIdentifier, resolveRestResourceNamespace, assertValidPostMetaPostType, resolvePostMetaKey, assertValidRestResourceMethods, resolveOptionalPhpCallbackReference, resolveOptionalPhpClassReference, assertValidManualRestContractHttpMethod, assertValidManualRestContractAuth, isGeneratedRestResourceRoutePatternCompatible, resolveManualRestContractPathPattern, resolveGeneratedRestResourceRoutePattern, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, assertValidIntegrationEnvService, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertPostMetaDoesNotExist, assertContractDoesNotExist, 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, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, MANUAL_REST_CONTRACT_AUTH_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, assertValidTypeScriptIdentifier, resolveRestResourceNamespace, assertValidPostMetaPostType, resolvePostMetaKey, assertValidRestResourceMethods, resolveOptionalPhpCallbackReference, resolveOptionalPhpClassReference, assertValidManualRestContractHttpMethod, assertValidManualRestContractAuth, isGeneratedRestResourceRoutePatternCompatible, collectRestRouteNamedCaptureNames, resolveManualRestContractPathPattern, resolveGeneratedRestResourceRoutePattern, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, assertValidIntegrationEnvService, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertPostMetaDoesNotExist, assertContractDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
 
-//# debugId=E79B1182F12A2D7664756E2164756E21
+//# debugId=8DE6D8AE337ABB4664756E2164756E21