@wp-typia/project-tools 0.21.0 → 0.22.1

package/dist/runtime/cli-doctor-workspace.js

@@ -814,15 +814,16 @@ function checkWorkspaceAdminViewConfig(adminView, inventory) {
         return createDoctorCheck(`Admin view config ${adminView.slug}`, "pass", "Admin view uses a replaceable local fetcher");
     }
     const source = adminView.source.trim();
-    const sourceMatch = /^rest-resource:([a-z][a-z0-9-]*)$/u.exec(source);
-    const restResourceSlug = sourceMatch?.[1];
+    const restSourceMatch = /^rest-resource:([a-z][a-z0-9-]*)$/u.exec(source);
+    const coreDataSourceMatch = /^core-data:(postType|taxonomy)\/([a-z0-9][a-z0-9_-]*)$/u.exec(source);
+    const restResourceSlug = restSourceMatch?.[1];
     const restResource = restResourceSlug
         ? inventory.restResources.find((entry) => entry.slug === restResourceSlug)
         : undefined;
-    const isValid = Boolean(restResource?.methods.includes("list"));
+    const isValid = Boolean(restResource?.methods.includes("list")) || Boolean(coreDataSourceMatch);
     return createDoctorCheck(`Admin view config ${adminView.slug}`, isValid ? "pass" : "fail", isValid
         ? `Admin view source ${source} is list-capable`
-        : "Admin view source must use rest-resource:<slug> and reference a list-capable REST resource");
+        : "Admin view source must use rest-resource:<slug> with a list-capable REST resource or core-data:<postType|taxonomy>/<name>");
 }
 function checkWorkspaceAdminViewBootstrap(projectDir, packageName, phpPrefix) {
     const packageBaseName = packageName.split("/").pop() ?? packageName;

package/dist/runtime/cli-help.js

@@ -18,7 +18,7 @@ export function formatHelpText() {
   wp-typia create <project-dir> [--template compound] [--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>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
   wp-typia <project-dir> [create flags...]
   wp-typia init [project-dir] [--apply] [--package-manager <id>]
-  wp-typia add admin-view <name> [--source <rest-resource:slug>]
+  wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]
   wp-typia add block <name> [--template <basic|interactivity|persistence|compound>] [--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>]
   wp-typia add variation <name> --block <block-slug>
   wp-typia add style <name> --block <block-slug>
@@ -49,7 +49,10 @@ Notes:
   \`wp-typia init\` previews the minimum retrofit sync surface by default; rerun with \`--apply\` to write package.json updates and generated helper scripts.
   Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
   Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
-  \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`; pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
+  \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
+  Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
+  Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
+  Public installs currently gate this workflow until \`@wp-typia/dataviews\` is published to npm.
   \`query-loop\` is create-only. Use \`wp-typia create <project-dir> --template query-loop\`; \`wp-typia add block\` accepts only basic, interactivity, persistence, and compound families.
   \`add variation\` uses an existing workspace block from \`scripts/block-config.ts\`.
   \`add style\` registers a Block Styles option for an existing generated block.

package/dist/runtime/external-layer-selection.d.ts

@@ -1,4 +1,5 @@
-import { type SelectableExternalTemplateLayer } from "./template-layers.js";
+import { resolveTemplateSeed } from "./template-source.js";
+import { listSelectableExternalTemplateLayers, type SelectableExternalTemplateLayer } from "./template-layers.js";
 export interface ExternalLayerSelectionOption extends SelectableExternalTemplateLayer {
 }
 export interface ResolvedExternalLayerSelection {
@@ -6,9 +7,14 @@ export interface ResolvedExternalLayerSelection {
     externalLayerId?: string;
     externalLayerSource?: string;
 }
-export declare function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, selectExternalLayerId, }: {
+type ResolveExternalTemplateSeed = typeof resolveTemplateSeed;
+type ListExternalTemplateLayers = typeof listSelectableExternalTemplateLayers;
+export declare function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, listExternalTemplateLayers, resolveExternalTemplateSeed, selectExternalLayerId, }: {
     callerCwd: string;
     externalLayerId?: string;
     externalLayerSource?: string;
+    listExternalTemplateLayers?: ListExternalTemplateLayers;
+    resolveExternalTemplateSeed?: ResolveExternalTemplateSeed;
     selectExternalLayerId?: (options: ExternalLayerSelectionOption[]) => Promise<string>;
 }): Promise<ResolvedExternalLayerSelection>;
+export {};

package/dist/runtime/external-layer-selection.js

@@ -1,15 +1,15 @@
 import { parseTemplateLocator, resolveTemplateSeed, } from "./template-source.js";
 import { listSelectableExternalTemplateLayers, } from "./template-layers.js";
-export async function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, selectExternalLayerId, }) {
+export async function resolveOptionalInteractiveExternalLayerId({ callerCwd, externalLayerId, externalLayerSource, listExternalTemplateLayers = listSelectableExternalTemplateLayers, resolveExternalTemplateSeed = resolveTemplateSeed, selectExternalLayerId, }) {
     if (!externalLayerSource || externalLayerId || !selectExternalLayerId) {
         return {
             externalLayerId,
             externalLayerSource,
         };
     }
-    const layerSeed = await resolveTemplateSeed(parseTemplateLocator(externalLayerSource), callerCwd);
+    const layerSeed = await resolveExternalTemplateSeed(parseTemplateLocator(externalLayerSource), callerCwd);
     try {
-        const selectableLayers = await listSelectableExternalTemplateLayers(layerSeed.rootDir);
+        const selectableLayers = await listExternalTemplateLayers(layerSeed.rootDir);
         if (selectableLayers.length <= 1) {
             await layerSeed.cleanup?.();
             return {
@@ -25,7 +25,6 @@ export async function resolveOptionalInteractiveExternalLayerId({ callerCwd, ext
                 externalLayerSource: layerSeed.rootDir,
             };
         }
-        await layerSeed.cleanup?.();
         throw new Error(`Unknown external layer "${selectedLayerId}". Expected one of: ${selectableLayers.map((layer) => layer.id).join(", ")}`);
     }
     catch (error) {

package/dist/runtime/package-versions.d.ts

@@ -11,6 +11,34 @@ export interface PackageVersions {
     wpTypiaPackageExactVersion: string;
     wpTypiaPackageVersion: string;
 }
+/**
+ * Explicit fallback ranges for managed WordPress-facing workspace dependencies.
+ *
+ * These remain centralized here even when individual scaffold flows resolve a
+ * fresher local or installed manifest version first, so add-command defaults do
+ * not drift across runtime modules.
+ */
+export declare const DEFAULT_WORDPRESS_ABILITIES_VERSION = "^0.10.0";
+export declare const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0";
+export declare const DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0";
+export declare const DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0";
+export declare const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
+export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.0";
+/**
+ * Resolve a managed package version range from linked workspace packages first,
+ * then installed package manifests, while preserving the shared normalization
+ * and manifest fingerprinting rules used by `getPackageVersions()`.
+ *
+ * @param packageName npm package whose manifest version should be consulted.
+ * @param fallback Canonical range to use when no usable manifest version exists.
+ * @param workspacePackageDirName Optional sibling monorepo package directory name.
+ * @returns A normalized semver range suitable for generated dependency entries.
+ */
+export declare function resolveManagedPackageVersionRange(options: {
+    fallback: string;
+    packageName: string;
+    workspacePackageDirName?: string;
+}): string;
 /**
  * Clears the in-memory cache used by `getPackageVersions()`.
  *

package/dist/runtime/package-versions.js

@@ -1,15 +1,28 @@
-import fs from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { PROJECT_TOOLS_PACKAGE_ROOT } from "./template-registry.js";
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { PROJECT_TOOLS_PACKAGE_ROOT } from './template-registry.js';
 const require = createRequire(import.meta.url);
-const DEFAULT_VERSION_RANGE = "^0.0.0";
-const DEFAULT_EXACT_VERSION = "0.0.0";
-const DEFAULT_TSX_PACKAGE_VERSION = "^4.20.5";
-const DEFAULT_TYPIA_UNPLUGIN_PACKAGE_VERSION = "^12.0.1";
+const DEFAULT_VERSION_RANGE = '^0.0.0';
+const DEFAULT_EXACT_VERSION = '0.0.0';
+const DEFAULT_TSX_PACKAGE_VERSION = '^4.20.5';
+const DEFAULT_TYPIA_UNPLUGIN_PACKAGE_VERSION = '^12.0.1';
+/**
+ * Explicit fallback ranges for managed WordPress-facing workspace dependencies.
+ *
+ * These remain centralized here even when individual scaffold flows resolve a
+ * fresher local or installed manifest version first, so add-command defaults do
+ * not drift across runtime modules.
+ */
+export const DEFAULT_WORDPRESS_ABILITIES_VERSION = '^0.10.0';
+export const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = '^0.9.0';
+export const DEFAULT_WORDPRESS_CORE_DATA_VERSION = '^7.44.0';
+export const DEFAULT_WORDPRESS_DATA_VERSION = '^9.28.0';
+export const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = '^14.1.0';
+export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = '^0.1.0';
 let cachedPackageVersions = null;
 function getErrorCode(error) {
-    return typeof error === "object" && error !== null && "code" in error
+    return typeof error === 'object' && error !== null && 'code' in error
         ? String(error.code)
         : undefined;
 }
@@ -18,7 +31,7 @@ function normalizeVersionRange(value) {
     if (!trimmed) {
         return DEFAULT_VERSION_RANGE;
     }
-    if (trimmed.startsWith("workspace:")) {
+    if (trimmed.startsWith('workspace:')) {
         return DEFAULT_VERSION_RANGE;
     }
     return /^[~^<>=]/.test(trimmed) ? trimmed : `^${trimmed}`;
@@ -28,10 +41,10 @@ function normalizeExactVersion(value) {
     if (!trimmed) {
         return DEFAULT_EXACT_VERSION;
     }
-    if (trimmed.startsWith("workspace:")) {
+    if (trimmed.startsWith('workspace:')) {
         return DEFAULT_EXACT_VERSION;
     }
-    return trimmed.replace(/^[~^<>=]+/, "");
+    return trimmed.replace(/^[~^<>=]+/, '');
 }
 function normalizeVersionRangeWithFallback(value, fallback) {
     const normalized = normalizeVersionRange(value);
@@ -48,7 +61,7 @@ function createContentFingerprint(source) {
 function resolvePackageManifestLocation(packageJsonPath) {
     try {
         const stats = fs.statSync(packageJsonPath);
-        const source = fs.readFileSync(packageJsonPath, "utf8");
+        const source = fs.readFileSync(packageJsonPath, 'utf8');
         return {
             cacheKey: `file:${packageJsonPath}:${stats.ino}:${stats.mtimeMs}:${stats.ctimeMs}:${stats.size}:${createContentFingerprint(source)}`,
             packageJsonPath,
@@ -56,7 +69,7 @@ function resolvePackageManifestLocation(packageJsonPath) {
         };
     }
     catch (error) {
-        if (getErrorCode(error) === "ENOENT") {
+        if (getErrorCode(error) === 'ENOENT') {
             return {
                 cacheKey: `missing-file:${packageJsonPath}`,
                 packageJsonPath: null,
@@ -72,12 +85,23 @@ function readPackageManifest(location) {
     }
     return JSON.parse(location.source);
 }
+function tryReadPackageManifest(location) {
+    if (!location) {
+        return null;
+    }
+    try {
+        return readPackageManifest(location);
+    }
+    catch {
+        return null;
+    }
+}
 function resolveInstalledPackageManifestLocation(packageName) {
     try {
         return resolvePackageManifestLocation(require.resolve(`${packageName}/package.json`));
     }
     catch (error) {
-        if (getErrorCode(error) === "MODULE_NOT_FOUND") {
+        if (getErrorCode(error) === 'MODULE_NOT_FOUND') {
             return {
                 cacheKey: `missing-module:${packageName}`,
                 packageJsonPath: null,
@@ -88,7 +112,26 @@ function resolveInstalledPackageManifestLocation(packageName) {
     }
 }
 function composePackageVersionsCacheKey(locations) {
-    return locations.map((location) => location.cacheKey).join("|");
+    return locations.map((location) => location.cacheKey).join('|');
+}
+/**
+ * Resolve a managed package version range from linked workspace packages first,
+ * then installed package manifests, while preserving the shared normalization
+ * and manifest fingerprinting rules used by `getPackageVersions()`.
+ *
+ * @param packageName npm package whose manifest version should be consulted.
+ * @param fallback Canonical range to use when no usable manifest version exists.
+ * @param workspacePackageDirName Optional sibling monorepo package directory name.
+ * @returns A normalized semver range suitable for generated dependency entries.
+ */
+export function resolveManagedPackageVersionRange(options) {
+    const workspaceManifestLocation = options.workspacePackageDirName
+        ? resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', options.workspacePackageDirName, 'package.json'))
+        : null;
+    const installedManifestLocation = resolveInstalledPackageManifestLocation(options.packageName);
+    const workspaceManifest = tryReadPackageManifest(workspaceManifestLocation);
+    const installedManifest = tryReadPackageManifest(installedManifestLocation);
+    return normalizeVersionRangeWithFallback(workspaceManifest?.version ?? installedManifest?.version, options.fallback);
 }
 /**
  * Clears the in-memory cache used by `getPackageVersions()`.
@@ -115,20 +158,20 @@ export function invalidatePackageVersionsCache() {
  * disk, the cache key changes and the returned version object is refreshed.
  */
 export function getPackageVersions() {
-    const createManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, "package.json"));
-    const monorepoManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, "..", "..", "package.json"));
-    const blockRuntimeManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, "..", "wp-typia-block-runtime", "package.json"));
-    const wpTypiaManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, "..", "wp-typia", "package.json"));
-    const installedProjectToolsManifestLocation = resolveInstalledPackageManifestLocation("@wp-typia/project-tools");
-    const installedApiClientManifestLocation = resolveInstalledPackageManifestLocation("@wp-typia/api-client");
-    const installedBlockRuntimeManifestLocation = resolveInstalledPackageManifestLocation("@wp-typia/block-runtime");
-    const installedBlockTypesManifestLocation = resolveInstalledPackageManifestLocation("@wp-typia/block-types");
-    const installedRestManifestLocation = resolveInstalledPackageManifestLocation("@wp-typia/rest");
-    const installedTsxManifestLocation = resolveInstalledPackageManifestLocation("tsx");
-    const installedTypiaManifestLocation = resolveInstalledPackageManifestLocation("typia");
-    const installedTypiaUnpluginManifestLocation = resolveInstalledPackageManifestLocation("@typia/unplugin");
-    const installedTypescriptManifestLocation = resolveInstalledPackageManifestLocation("typescript");
-    const installedWpTypiaManifestLocation = resolveInstalledPackageManifestLocation("wp-typia");
+    const createManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, 'package.json'));
+    const monorepoManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', '..', 'package.json'));
+    const blockRuntimeManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', 'wp-typia-block-runtime', 'package.json'));
+    const wpTypiaManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', 'wp-typia', 'package.json'));
+    const installedProjectToolsManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/project-tools');
+    const installedApiClientManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/api-client');
+    const installedBlockRuntimeManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/block-runtime');
+    const installedBlockTypesManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/block-types');
+    const installedRestManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/rest');
+    const installedTsxManifestLocation = resolveInstalledPackageManifestLocation('tsx');
+    const installedTypiaManifestLocation = resolveInstalledPackageManifestLocation('typia');
+    const installedTypiaUnpluginManifestLocation = resolveInstalledPackageManifestLocation('@typia/unplugin');
+    const installedTypescriptManifestLocation = resolveInstalledPackageManifestLocation('typescript');
+    const installedWpTypiaManifestLocation = resolveInstalledPackageManifestLocation('wp-typia');
     const cacheKey = composePackageVersionsCacheKey([
         createManifestLocation,
         monorepoManifestLocation,
@@ -158,17 +201,17 @@ export function getPackageVersions() {
     const wpTypiaManifest = readPackageManifest(wpTypiaManifestLocation) ??
         readPackageManifest(installedWpTypiaManifestLocation) ??
         {};
-    const blockRuntimeDependencyVersion = normalizeVersionRange(createManifest.dependencies?.["@wp-typia/block-runtime"]);
+    const blockRuntimeDependencyVersion = normalizeVersionRange(createManifest.dependencies?.['@wp-typia/block-runtime']);
     const versions = {
-        apiClientPackageVersion: normalizeVersionRange(createManifest.dependencies?.["@wp-typia/api-client"] ??
+        apiClientPackageVersion: normalizeVersionRange(createManifest.dependencies?.['@wp-typia/api-client'] ??
             readPackageManifest(installedApiClientManifestLocation)?.version),
         blockRuntimePackageVersion: blockRuntimeDependencyVersion !== DEFAULT_VERSION_RANGE
             ? blockRuntimeDependencyVersion
             : normalizeVersionRange(blockRuntimeManifest.version),
-        blockTypesPackageVersion: normalizeVersionRange(createManifest.dependencies?.["@wp-typia/block-types"] ??
+        blockTypesPackageVersion: normalizeVersionRange(createManifest.dependencies?.['@wp-typia/block-types'] ??
             readPackageManifest(installedBlockTypesManifestLocation)?.version),
         projectToolsPackageVersion: normalizeVersionRange(createManifest.version),
-        restPackageVersion: normalizeVersionRange(createManifest.dependencies?.["@wp-typia/rest"] ??
+        restPackageVersion: normalizeVersionRange(createManifest.dependencies?.['@wp-typia/rest'] ??
             readPackageManifest(installedRestManifestLocation)?.version),
         tsxPackageVersion: normalizeVersionRangeWithFallback(monorepoManifest.dependencies?.tsx ??
             monorepoManifest.devDependencies?.tsx ??
@@ -177,8 +220,8 @@ export function getPackageVersions() {
             monorepoManifest.devDependencies?.typia ??
             createManifest.dependencies?.typia ??
             readPackageManifest(installedTypiaManifestLocation)?.version, DEFAULT_VERSION_RANGE),
-        typiaUnpluginPackageVersion: normalizeVersionRangeWithFallback(monorepoManifest.dependencies?.["@typia/unplugin"] ??
-            monorepoManifest.devDependencies?.["@typia/unplugin"] ??
+        typiaUnpluginPackageVersion: normalizeVersionRangeWithFallback(monorepoManifest.dependencies?.['@typia/unplugin'] ??
+            monorepoManifest.devDependencies?.['@typia/unplugin'] ??
             readPackageManifest(installedTypiaUnpluginManifestLocation)?.version, DEFAULT_TYPIA_UNPLUGIN_PACKAGE_VERSION),
         typescriptPackageVersion: normalizeVersionRangeWithFallback(monorepoManifest.dependencies?.typescript ??
             monorepoManifest.devDependencies?.typescript ??

package/dist/runtime/scaffold-compatibility.d.ts

@@ -4,7 +4,7 @@
  * The policy keeps plugin headers, runtime gates, and workspace inventory
  * metadata aligned when optional or required AI-capable features are added.
  */
-import { type AiFeatureCapabilitySelection, type AiFeatureCompatibilityFloor, type ResolvedAiFeatureCapabilityPlan } from "./ai-feature-capability.js";
+import { type AiFeatureCapabilitySelection, type AiFeatureCompatibilityFloor, type ResolvedAiFeatureCapabilityPlan } from './ai-feature-capability.js';
 /**
  * WordPress plugin header version floors emitted by scaffold templates.
  */
@@ -25,7 +25,7 @@ export interface ScaffoldCompatibilityPolicy {
  */
 export interface ScaffoldCompatibilityConfig {
     hardMinimums: AiFeatureCompatibilityFloor;
-    mode: "baseline" | "optional" | "required";
+    mode: 'baseline' | 'optional' | 'required';
     optionalFeatures: string[];
     requiredFeatures: string[];
     runtimeGates: string[];

package/dist/runtime/scaffold-compatibility.js

@@ -4,14 +4,15 @@
  * The policy keeps plugin headers, runtime gates, and workspace inventory
  * metadata aligned when optional or required AI-capable features are added.
  */
-import { AI_FEATURE_DEFINITIONS, resolveAiFeatureCapabilityPlan, } from "./ai-feature-capability.js";
+import { AI_FEATURE_DEFINITIONS, resolveAiFeatureCapabilityPlan, } from './ai-feature-capability.js';
+import { pickHigherVersionFloor } from './version-floor.js';
 /**
  * Baseline headers used by scaffold output before optional features are added.
  */
 export const DEFAULT_SCAFFOLD_COMPATIBILITY = {
-    requiresAtLeast: "6.7",
-    requiresPhp: "8.0",
-    testedUpTo: "6.9",
+    requiresAtLeast: '6.7',
+    requiresPhp: '8.0',
+    testedUpTo: '6.9',
 };
 /**
  * Optional WordPress AI Client surface used by server-only AI feature scaffold.
@@ -19,7 +20,7 @@ export const DEFAULT_SCAFFOLD_COMPATIBILITY = {
 export const OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY = [
     {
         featureId: AI_FEATURE_DEFINITIONS.wordpressAiClient.id,
-        mode: "optional",
+        mode: 'optional',
     },
 ];
 /**
@@ -28,42 +29,15 @@ export const OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY = [
 export const REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY = [
     {
         featureId: AI_FEATURE_DEFINITIONS.wordpressServerAbilities.id,
-        mode: "required",
+        mode: 'required',
     },
     {
         featureId: AI_FEATURE_DEFINITIONS.wordpressCoreAbilities.id,
-        mode: "required",
+        mode: 'required',
     },
 ];
-function parseVersionFloorParts(value) {
-    return value.split(".").map((part, index) => {
-        if (!/^\d+$/u.test(part)) {
-            throw new Error(`parseVersionFloorParts received an invalid version floor "${value}" at segment ${index + 1}.`);
-        }
-        return Number.parseInt(part, 10);
-    });
-}
-function compareVersionFloors(left, right) {
-    const leftParts = parseVersionFloorParts(left);
-    const rightParts = parseVersionFloorParts(right);
-    const length = Math.max(leftParts.length, rightParts.length);
-    for (let index = 0; index < length; index += 1) {
-        const leftValue = leftParts[index] ?? 0;
-        const rightValue = rightParts[index] ?? 0;
-        if (leftValue > rightValue) {
-            return 1;
-        }
-        if (leftValue < rightValue) {
-            return -1;
-        }
-    }
-    return 0;
-}
-function pickHigherVersionFloor(current, candidate) {
-    if (!candidate) {
-        return current;
-    }
-    return compareVersionFloors(current, candidate) >= 0 ? current : candidate;
+function pickHigherScaffoldVersionFloor(current, candidate) {
+    return pickHigherVersionFloor(current, candidate) ?? current;
 }
 function pickHigherHeaderVersionFloor(policyValue, currentValue) {
     const normalizedCurrentValue = currentValue.trim();
@@ -71,7 +45,7 @@ function pickHigherHeaderVersionFloor(policyValue, currentValue) {
         return policyValue;
     }
     try {
-        return pickHigherVersionFloor(policyValue, normalizedCurrentValue);
+        return pickHigherScaffoldVersionFloor(policyValue, normalizedCurrentValue);
     }
     catch {
         return policyValue;
@@ -82,21 +56,21 @@ function formatRuntimeGate(feature) {
 }
 function getPolicyMode(capabilityPlan) {
     if (capabilityPlan.requiredFeatures.length > 0) {
-        return "required";
+        return 'required';
     }
     if (capabilityPlan.optionalFeatures.length > 0) {
-        return "optional";
+        return 'optional';
     }
-    return "baseline";
+    return 'baseline';
 }
 /**
  * Resolve plugin header floors and capability gates for scaffold selections.
  */
 export function resolveScaffoldCompatibilityPolicy(selections, { baseline = DEFAULT_SCAFFOLD_COMPATIBILITY, } = {}) {
     const capabilityPlan = resolveAiFeatureCapabilityPlan(selections);
-    const requiresAtLeast = pickHigherVersionFloor(baseline.requiresAtLeast, capabilityPlan.hardMinimums.wordpress);
-    const requiresPhp = pickHigherVersionFloor(baseline.requiresPhp, capabilityPlan.hardMinimums.php);
-    const testedUpTo = pickHigherVersionFloor(baseline.testedUpTo, requiresAtLeast);
+    const requiresAtLeast = pickHigherScaffoldVersionFloor(baseline.requiresAtLeast, capabilityPlan.hardMinimums.wordpress);
+    const requiresPhp = pickHigherScaffoldVersionFloor(baseline.requiresPhp, capabilityPlan.hardMinimums.php);
+    const testedUpTo = pickHigherScaffoldVersionFloor(baseline.testedUpTo, requiresAtLeast);
     return {
         capabilityPlan,
         pluginHeader: {
@@ -125,16 +99,16 @@ export function createScaffoldCompatibilityConfig(policy) {
 /**
  * Render compatibility metadata as formatted TypeScript object literal JSON.
  */
-export function renderScaffoldCompatibilityConfig(policy, indent = "\t\t") {
+export function renderScaffoldCompatibilityConfig(policy, indent = '\t\t') {
     const config = createScaffoldCompatibilityConfig(policy);
-    return JSON.stringify(config, null, "\t")
-        .split("\n")
+    return JSON.stringify(config, null, '\t')
+        .split('\n')
         .map((line, index) => (index === 0 ? line : `${indent}${line}`))
-        .join("\n");
+        .join('\n');
 }
 function replacePluginHeaderVersionFloor(source, pattern, policyValue) {
     return source.replace(pattern, (_match, prefix, currentValue, lineEnding) => {
-        const versionPrefix = prefix.endsWith(":") ? `${prefix} ` : prefix;
+        const versionPrefix = prefix.endsWith(':') ? `${prefix} ` : prefix;
         return `${versionPrefix}${pickHigherHeaderVersionFloor(policyValue, currentValue)}${lineEnding}`;
     });
 }

package/dist/runtime/string-case.d.ts

@@ -19,6 +19,13 @@ export declare function toSnakeCase(input: string): string;
  * @returns A PascalCase string derived from the normalized kebab-case form.
  */
 export declare function toPascalCase(input: string): string;
+/**
+ * Normalize arbitrary text into a camelCase identifier.
+ *
+ * @param input Raw text that may contain spaces, punctuation, or camelCase.
+ * @returns A camelCase string derived from the normalized PascalCase form.
+ */
+export declare function toCamelCase(input: string): string;
 /**
  * Convert delimited text to PascalCase while preserving each segment's
  * existing internal casing.

package/dist/runtime/string-case.js

@@ -10,10 +10,10 @@ function capitalizeSegment(segment) {
 export function toKebabCase(input) {
     return input
         .trim()
-        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
-        .replace(/[^A-Za-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .replace(/-{2,}/g, "-")
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-{2,}/g, '-')
         .toLowerCase();
 }
 /**
@@ -23,7 +23,7 @@ export function toKebabCase(input) {
  * @returns A lowercase snake_case string derived from the kebab-case form.
  */
 export function toSnakeCase(input) {
-    return toKebabCase(input).replace(/-/g, "_");
+    return toKebabCase(input).replace(/-/g, '_');
 }
 /**
  * Normalize arbitrary text into a PascalCase identifier.
@@ -33,10 +33,20 @@ export function toSnakeCase(input) {
  */
 export function toPascalCase(input) {
     return toKebabCase(input)
-        .split("-")
+        .split('-')
         .filter(Boolean)
         .map(capitalizeSegment)
-        .join("");
+        .join('');
+}
+/**
+ * Normalize arbitrary text into a camelCase identifier.
+ *
+ * @param input Raw text that may contain spaces, punctuation, or camelCase.
+ * @returns A camelCase string derived from the normalized PascalCase form.
+ */
+export function toCamelCase(input) {
+    const pascalCase = toPascalCase(input);
+    return `${pascalCase.charAt(0).toLowerCase()}${pascalCase.slice(1)}`;
 }
 /**
  * Convert delimited text to PascalCase while preserving each segment's
@@ -47,12 +57,12 @@ export function toPascalCase(input) {
  */
 export function toSegmentPascalCase(input) {
     return input
-        .replace(/[^A-Za-z0-9]+/g, " ")
+        .replace(/[^A-Za-z0-9]+/g, ' ')
         .trim()
         .split(/\s+/)
         .filter(Boolean)
         .map(capitalizeSegment)
-        .join("");
+        .join('');
 }
 /**
  * Normalize arbitrary text into a human-readable title.
@@ -62,8 +72,8 @@ export function toSegmentPascalCase(input) {
  */
 export function toTitleCase(input) {
     return toKebabCase(input)
-        .split("-")
+        .split('-')
         .filter(Boolean)
         .map(capitalizeSegment)
-        .join(" ");
+        .join(' ');
 }

package/dist/runtime/version-floor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parse a dotted version floor into numeric parts for stable comparisons.
+ *
+ * @param value Human-authored version floor such as `7.0` or `8.1.2`.
+ * @returns Numeric version segments suitable for ordered comparison.
+ * @throws When any segment contains non-digit characters.
+ */
+export declare function parseVersionFloorParts(value: string): number[];
+/**
+ * Compare two dotted version floors.
+ *
+ * Missing trailing segments are treated as zero so `7.0` equals `7.0.0`.
+ *
+ * @param left Left-hand version floor.
+ * @param right Right-hand version floor.
+ * @returns `1` when left is higher, `-1` when right is higher, or `0` when equal.
+ */
+export declare function compareVersionFloors(left: string, right: string): number;
+/**
+ * Pick the higher version floor while tolerating undefined values.
+ *
+ * @param current Current resolved floor, when present.
+ * @param candidate Candidate floor to compare against the current floor.
+ * @returns The higher defined floor, or undefined when neither value exists.
+ */
+export declare function pickHigherVersionFloor(current: string | undefined, candidate: string | undefined): string | undefined;