@wp-typia/project-tools 0.22.0 → 0.22.1

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

@@ -24,6 +24,21 @@ 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,12 +1,12 @@
-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.
  *
@@ -14,15 +14,15 @@ const DEFAULT_TYPIA_UNPLUGIN_PACKAGE_VERSION = "^12.0.1";
  * 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";
+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;
 }
@@ -31,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}`;
@@ -41,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);
@@ -61,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,
@@ -69,7 +69,7 @@ function resolvePackageManifestLocation(packageJsonPath) {
         };
     }
     catch (error) {
-        if (getErrorCode(error) === "ENOENT") {
+        if (getErrorCode(error) === 'ENOENT') {
             return {
                 cacheKey: `missing-file:${packageJsonPath}`,
                 packageJsonPath: null,
@@ -85,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,
@@ -101,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()`.
@@ -128,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,
@@ -171,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 ??
@@ -190,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",