@visulima/package 5.0.8 → 5.0.10

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## @visulima/package [5.0.10](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.9...%40visulima%2Fpackage%405.0.10) (2026-07-27)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.11
+
+## @visulima/package [5.0.9](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.8...%40visulima%2Fpackage%405.0.9) (2026-07-27)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.10
+
 ## @visulima/package [5.0.8](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.7...%40visulima%2Fpackage%405.0.8) (2026-07-27)
 
 

package/MIGRATION-GUIDE.md

@@ -0,0 +1,287 @@
+# Migration Guide
+
+This guide documents breaking changes and migration steps for the `@visulima/package` package.
+
+## Version 4.0.0
+
+### `parsePackageJson` Function Now Asynchronous
+
+The `parsePackageJson` function has been updated to be asynchronous and returns a `Promise<NormalizedPackageJson>` instead of `NormalizedPackageJson` directly.
+
+#### Before (v3.x)
+
+```typescript
+import { parsePackageJson } from "@visulima/package";
+
+const packageJson = parsePackageJson("./package.json");
+
+// packageJson is immediately available
+console.log(packageJson.name);
+```
+
+#### After (v4.x)
+
+```typescript
+import { parsePackageJson } from "@visulima/package";
+
+const packageJson = await parsePackageJson("./package.json");
+
+// parsePackageJson now returns a Promise and must be awaited
+console.log(packageJson.name);
+```
+
+### CommonJS (CJS) Export Removed
+
+The CommonJS (CJS) export has been removed in favor of ECMAScript Modules (ESM) only. For CJS compatibility in Node.js 20.19+, use dynamic imports.
+
+#### Before (v3.x)
+
+```javascript
+// This no longer works
+const { parsePackageJson } = require("@visulima/package");
+```
+
+#### After (v4.x) - Node.js 20.19+
+
+```javascript
+// Use dynamic import for ESM modules from CJS
+const { parsePackageJson } = await import("@visulima/package");
+// parsePackageJson is async and must be awaited
+const packageJson = await parsePackageJson("./package.json");
+```
+
+#### Alternative: Convert to ESM
+
+For better compatibility and performance, convert your project to use ESM:
+
+```json
+// package.json
+{
+    "type": "module"
+}
+```
+
+```typescript
+// Your files can now use ESM imports
+import { parsePackageJson } from "@visulima/package";
+
+const packageJson = await parsePackageJson("./package.json");
+```
+
+### Why These Changes?
+
+#### Benefits of Asynchronous API
+
+- **Better Performance**: Non-blocking I/O operations
+- **Resource Efficiency**: Improved memory usage and responsiveness
+- **Modern JavaScript**: Aligns with async/await patterns
+- **Error Handling**: More predictable error propagation
+
+#### Benefits of ESM Only
+
+- **Standards Compliance**: Follows official JavaScript module specification
+- **Tree Shaking**: Better dead code elimination in bundlers
+- **Static Analysis**: Improved tooling and IDE support
+- **Future-Proof**: ESM is the standard for modern JavaScript
+
+### Migration Steps
+
+#### 1. Update Function Calls
+
+Replace all `parsePackageJson` calls to use `await`:
+
+```typescript
+// Before
+const packageJson = parsePackageJson("./package.json");
+
+// After
+const packageJson = await parsePackageJson("./package.json");
+```
+
+#### 2. Mark Functions as Async
+
+Ensure all functions calling `parsePackageJson` are marked as `async`:
+
+```typescript
+// Before
+function getPackageName() {
+    const packageJson = parsePackageJson("./package.json");
+    return packageJson.name;
+}
+
+// After
+async function getPackageName() {
+    const packageJson = await parsePackageJson("./package.json");
+    return packageJson.name;
+}
+```
+
+#### 3. Update Error Handling
+
+Error handling patterns remain the same but must account for async context:
+
+```typescript
+// Before
+function getPackageInfo() {
+    try {
+        const packageJson = parsePackageJson("./package.json");
+        return { name: packageJson.name, version: packageJson.version };
+    } catch (error) {
+        console.error("Failed to parse package.json:", error);
+        throw error;
+    }
+}
+
+// After
+async function getPackageInfo() {
+    try {
+        const packageJson = await parsePackageJson("./package.json");
+        return { name: packageJson.name, version: packageJson.version };
+    } catch (error) {
+        console.error("Failed to parse package.json:", error);
+        throw error;
+    }
+}
+```
+
+### New Features in v4.0.0
+
+#### Pnpm Catalog Resolution Support
+
+The new version adds support for pnpm catalog resolution:
+
+```typescript
+import { parsePackageJson } from "@visulima/package";
+
+// Enable catalog resolution for pnpm workspaces
+const packageJson = await parsePackageJson("./package.json", {
+    resolveCatalogs: true,
+});
+
+// Automatically resolves catalog references like "react": "catalog:"
+console.log(packageJson.dependencies.react); // "18.2.0" (resolved from catalog)
+```
+
+#### Enhanced Error Messages
+
+Better error reporting for common issues:
+
+- **File not found**: Clear path resolution errors
+- **Invalid JSON**: Detailed syntax error information
+- **Permission issues**: Helpful suggestions for file access problems
+
+### Migration Issues & Solutions
+
+#### 1. Missing await Keywords
+
+**Problem**: Forgetting to await `parsePackageJson` calls.
+
+**Solution**: Add `await` before all `parsePackageJson` calls and mark calling functions as `async`.
+
+#### 2. CJS require() Calls
+
+**Problem**: `require("@visulima/package")` no longer works.
+
+**Solution**: Use dynamic imports:
+
+```javascript
+// Dynamic import for ESM modules from CJS
+const { parsePackageJson } = await import("@visulima/package");
+```
+
+#### 3. Async Function Requirements
+
+**Problem**: Functions calling `parsePackageJson` must be async.
+
+**Solution**: Mark all calling functions as `async`:
+
+```typescript
+// Before
+function getPackageName() {
+    const packageJson = parsePackageJson("./package.json");
+    return packageJson.name;
+}
+
+// After
+async function getPackageName() {
+    const packageJson = await parsePackageJson("./package.json");
+    return packageJson.name;
+}
+```
+
+### Migration Script
+
+Use this script to identify files that need updating:
+
+```javascript
+// migration-helper.mjs
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { join, extname } from "node:path";
+
+/**
+ * @param {string} dir
+ * @param {string[]} files
+ * @returns {string[]}
+ */
+function findFilesWithParsePackageJson(dir, files = []) {
+    const items = readdirSync(dir);
+
+    for (const item of items) {
+        const fullPath = join(dir, item);
+        const stat = statSync(fullPath);
+
+        if (stat.isDirectory() && !item.startsWith(".") && item !== "node_modules") {
+            findFilesWithParsePackageJson(fullPath, files);
+        } else if (stat.isFile() && (extname(item) === ".ts" || extname(item) === ".js")) {
+            const content = readFileSync(fullPath, "utf8");
+
+            if (content.includes("parsePackageJson") && (!content.includes("await parsePackageJson") || content.includes('require("@visulima/package")'))) {
+                files.push(fullPath);
+            }
+        }
+    }
+
+    return files;
+}
+
+const files = findFilesWithParsePackageJson("./src");
+console.log("Files that may need updating:", files);
+```
+
+### Testing Migration
+
+After migration, verify that your code works correctly:
+
+```typescript
+import { parsePackageJson } from "@visulima/package";
+
+// Test basic functionality
+const packageJson = await parsePackageJson("./package.json");
+console.log(`Project: ${packageJson.name} v${packageJson.version}`);
+
+// Test with catalog resolution
+const packageJsonWithCatalogs = await parsePackageJson("./package.json", {
+    resolveCatalogs: true,
+});
+console.log("Catalog resolution working:", packageJsonWithCatalogs.dependencies);
+```
+
+### Migration Benefits
+
+- **Better Performance**: Non-blocking I/O operations
+- **Modern JavaScript**: Async/await patterns throughout
+- **ESM Compatibility**: Works with modern bundlers and tools
+- **Type Safety**: Better TypeScript integration
+- **Future-Proof**: Aligned with JavaScript ecosystem direction
+
+### Need Additional Help?
+
+If you encounter issues during migration:
+
+1. Ensure all `parsePackageJson` calls are properly awaited
+2. Mark all calling functions as `async`
+3. Use ESM imports instead of CJS require()
+4. Update error handling for async context
+5. Test with catalog resolution features
+
+For additional support, please file an issue on the GitHub repository.

package/dist/error.d.ts

@@ -1,11 +1,11 @@
 /**
-* Error thrown when a package was not found.
-*/
+ * Error thrown when a package was not found.
+ */
 declare class PackageNotFoundError extends Error {
   /**
-  * @param packageName The name of the package that was not found.
-  * @param packageManager The package manager used to install the package.
-  */
+   * @param packageName The name of the package that was not found.
+   * @param packageManager The package manager used to install the package.
+   */
   constructor(packageName: string[] | string, packageManager?: string);
   get code(): string;
   set code(_name: string);

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { PackageNotFoundError } from "./error.js";
 export { type LockFileEntry, type LockFileIntegrity, type LockFileIntegrityAlgorithm, type LockFileParseResult, type LockFileType, decodeSriIntegrity, parseBunLockFile, parseLockFile, parseLockFileContent, parseLockFileSync, parseNpmLockFile, parsePnpmLockFile, parseYarnLockFile } from "./lockfile.js";
 export { type RootMonorepo, type Strategy, findMonorepoRoot, findMonorepoRootSync } from "./monorepo.js";
 export { findPackageRoot, findPackageRootSync } from "./package.js";
-export { type E as EnsurePackagesOptions, type F as FindPackageJsonCache, type N as NormalizedPackageJson, type a as NormalizedReadResult, type P as PackageJson, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-BHWsl_Em.js";
+export { type E as EnsurePackagesOptions, type F as FindPackageJsonCache, type N as NormalizedPackageJson, type a as NormalizedReadResult, type P as PackageJson, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-CuTm_EgE.js";
 export { type PackageManager, type PackageManagerResult, findLockFile, findLockFileSync, findPackageManager, findPackageManagerSync, generateMissingPackagesInstallMessage, getPackageManagerVersion, identifyInitiatingPackageManager } from "./package-manager.js";
 export { type PnpmCatalog, type PnpmCatalogs, isPackageInWorkspace, readPnpmCatalogs, readPnpmCatalogsSync, resolveCatalogReference, resolveCatalogReferences, resolveDependenciesCatalogReferences } from "./pnpm.js";
 import '@visulima/fs';

package/dist/lockfile.d.ts

@@ -1,8 +1,8 @@
 /**
-* Lockfiles the parser recognises. Both the modern text `bun.lock` and the
-* legacy binary `bun.lockb` map to the `bun` type, but only `bun.lock`
-* content is parseable — `bun.lockb` is a binary format and yields no entries.
-*/
+ * Lockfiles the parser recognises. Both the modern text `bun.lock` and the
+ * legacy binary `bun.lockb` map to the `bun` type, but only `bun.lock`
+ * content is parseable — `bun.lockb` is a binary format and yields no entries.
+ */
 type LockFileType = "bun" | "npm" | "pnpm" | "yarn";
 /** SRI algorithms the parser can decode into hex. */
 type LockFileIntegrityAlgorithm = "sha256" | "sha384" | "sha512";
@@ -14,19 +14,19 @@ interface LockFileIntegrity {
 /** A single resolved package extracted from a lockfile. */
 interface LockFileEntry {
   /**
-  * Declared runtime dependencies — `name → specifier[]` map. Values
-  * are arrays so pnpm v9+ peer-context variants (the same dep name
-  * resolved to different versions under different peer contexts)
-  * can all be preserved. npm, yarn v1, bun, and pnpm v6-v8 always
-  * produce single-element arrays; pnpm v9+ may produce multi-element
-  * arrays for peer-context-sensitive deps.
-  *
-  * Specifiers are whatever the lockfile recorded — a range
-  * (`^1.0.0`) for npm / yarn / bun, or an already-resolved exact
-  * version for pnpm. Callers resolve each specifier against
-  * {@link LockFileEntry.version} values elsewhere in the lockfile
-  * when they need a concrete edge.
-  */
+   * Declared runtime dependencies — `name → specifier[]` map. Values
+   * are arrays so pnpm v9+ peer-context variants (the same dep name
+   * resolved to different versions under different peer contexts)
+   * can all be preserved. npm, yarn v1, bun, and pnpm v6-v8 always
+   * produce single-element arrays; pnpm v9+ may produce multi-element
+   * arrays for peer-context-sensitive deps.
+   *
+   * Specifiers are whatever the lockfile recorded — a range
+   * (`^1.0.0`) for npm / yarn / bun, or an already-resolved exact
+   * version for pnpm. Callers resolve each specifier against
+   * {@link LockFileEntry.version} values elsewhere in the lockfile
+   * when they need a concrete edge.
+   */
   dependencies?: Record<string, string[]>;
   /** Decoded SRI digest, if the lockfile recorded one. */
   integrity?: LockFileIntegrity;
@@ -47,74 +47,74 @@ interface LockFileParseResult {
   type: LockFileType;
 }
 /**
-* Decodes a Subresource Integrity string (`sha512-&lt;base64>`) into a
-* `{ algorithm, hex }` pair. Returns `undefined` if the string is
-* malformed, oversized, or uses an unsupported algorithm.
-* @param sri Full SRI string, e.g. `sha512-&lt;base64>`.
-* @returns Decoded algorithm + hex digest, or `undefined` when the
-* input can't be parsed.
-*/
+ * Decodes a Subresource Integrity string (`sha512-&lt;base64>`) into a
+ * `{ algorithm, hex }` pair. Returns `undefined` if the string is
+ * malformed, oversized, or uses an unsupported algorithm.
+ * @param sri Full SRI string, e.g. `sha512-&lt;base64>`.
+ * @returns Decoded algorithm + hex digest, or `undefined` when the
+ * input can't be parsed.
+ */
 declare const decodeSriIntegrity: (sri: string) => LockFileIntegrity | undefined;
 /**
-* Parses `package-lock.json` (npm v2 / v3 format).
-* @param content Raw JSON text of the lockfile.
-* @returns One {@link LockFileEntry} per distinct `name@version`.
-*/
+ * Parses `package-lock.json` (npm v2 / v3 format).
+ * @param content Raw JSON text of the lockfile.
+ * @returns One {@link LockFileEntry} per distinct `name@version`.
+ */
 declare const parseNpmLockFile: (content: string) => LockFileEntry[];
 /**
-* Parses `pnpm-lock.yaml`. Regex-based; works for lockfile v6 through
-* v9. v9 moves concrete resolved dependency versions out of `packages:`
-* and into `snapshots:`; this parser reads both sections and unions
-* their dep-maps onto the final entry.
-* @param content Raw YAML text of the lockfile.
-* @returns One {@link LockFileEntry} per distinct `name@version`.
-*/
+ * Parses `pnpm-lock.yaml`. Regex-based; works for lockfile v6 through
+ * v9. v9 moves concrete resolved dependency versions out of `packages:`
+ * and into `snapshots:`; this parser reads both sections and unions
+ * their dep-maps onto the final entry.
+ * @param content Raw YAML text of the lockfile.
+ * @returns One {@link LockFileEntry} per distinct `name@version`.
+ */
 declare const parsePnpmLockFile: (content: string) => LockFileEntry[];
 /**
-* Parses `yarn.lock` for Yarn Classic (v1) and Berry (v2+). Berry's
-* XXH64 `checksum:` is not a cryptographic hash and is intentionally
-* dropped; only v1's SRI `integrity:` flows through to
-* {@link LockFileEntry.integrity}.
-* @param content Raw text of the lockfile.
-* @returns One {@link LockFileEntry} per distinct `name@version`.
-*/
+ * Parses `yarn.lock` for Yarn Classic (v1) and Berry (v2+). Berry's
+ * XXH64 `checksum:` is not a cryptographic hash and is intentionally
+ * dropped; only v1's SRI `integrity:` flows through to
+ * {@link LockFileEntry.integrity}.
+ * @param content Raw text of the lockfile.
+ * @returns One {@link LockFileEntry} per distinct `name@version`.
+ */
 declare const parseYarnLockFile: (content: string) => LockFileEntry[];
 /**
-* Parses `bun.lock` (Bun v1.1+, JSON-ish with trailing commas). The
-* legacy binary `bun.lockb` format is recognised by {@link inferLockFileType}
-* but cannot be decoded here — feeding its binary contents in returns an
-* empty array (the `JSON.parse` fails and is swallowed).
-*
-* Attribution: format + tuple layout verified against lockparse
-* (https://github.com/43081j/lockparse, MIT).
-* @param content Raw text of the lockfile.
-* @returns One {@link LockFileEntry} per distinct `name@version`.
-*/
+ * Parses `bun.lock` (Bun v1.1+, JSON-ish with trailing commas). The
+ * legacy binary `bun.lockb` format is recognised by {@link inferLockFileType}
+ * but cannot be decoded here — feeding its binary contents in returns an
+ * empty array (the `JSON.parse` fails and is swallowed).
+ *
+ * Attribution: format + tuple layout verified against lockparse
+ * (https://github.com/43081j/lockparse, MIT).
+ * @param content Raw text of the lockfile.
+ * @returns One {@link LockFileEntry} per distinct `name@version`.
+ */
 declare const parseBunLockFile: (content: string) => LockFileEntry[];
 /**
-* Parses raw lockfile content of the given type. Returns an empty
-* array if the content is malformed or doesn't contain any package
-* entries.
-* @param content Raw text of the lockfile.
-* @param type Which parser to dispatch to.
-* @returns One {@link LockFileEntry} per distinct `name@version`.
-*/
+ * Parses raw lockfile content of the given type. Returns an empty
+ * array if the content is malformed or doesn't contain any package
+ * entries.
+ * @param content Raw text of the lockfile.
+ * @param type Which parser to dispatch to.
+ * @returns One {@link LockFileEntry} per distinct `name@version`.
+ */
 declare const parseLockFileContent: (content: string, type: LockFileType) => LockFileEntry[];
 /**
-* Walks up from `cwd`, locates the nearest supported lockfile, reads
-* it, and returns the parsed entries alongside the lockfile type and
-* absolute path.
-* @param cwd Directory to start the search from. Defaults to
-* `process.cwd()` (delegated to `findUp`).
-* @returns The parsed result, keyed by the discovered lockfile path.
-* @throws If no supported lockfile can be found above `cwd`.
-*/
+ * Walks up from `cwd`, locates the nearest supported lockfile, reads
+ * it, and returns the parsed entries alongside the lockfile type and
+ * absolute path.
+ * @param cwd Directory to start the search from. Defaults to
+ * `process.cwd()` (delegated to `findUp`).
+ * @returns The parsed result, keyed by the discovered lockfile path.
+ * @throws If no supported lockfile can be found above `cwd`.
+ */
 declare const parseLockFile: (cwd?: URL | string) => Promise<LockFileParseResult>;
 /**
-* Synchronous counterpart to {@link parseLockFile}.
-* @param cwd Directory to start the search from.
-* @returns The parsed result, keyed by the discovered lockfile path.
-* @throws If no supported lockfile can be found above `cwd`.
-*/
+ * Synchronous counterpart to {@link parseLockFile}.
+ * @param cwd Directory to start the search from.
+ * @returns The parsed result, keyed by the discovered lockfile path.
+ * @throws If no supported lockfile can be found above `cwd`.
+ */
 declare const parseLockFileSync: (cwd?: URL | string) => LockFileParseResult;
 export { LockFileEntry, LockFileIntegrity, LockFileIntegrityAlgorithm, LockFileParseResult, LockFileType, decodeSriIntegrity, parseBunLockFile, parseLockFile, parseLockFileContent, parseLockFileSync, parseNpmLockFile, parsePnpmLockFile, parseYarnLockFile };

package/dist/lockfile.js

@@ -1 +1 @@
-import{createRequire as E}from"node:module";import{findUp as I,findUpSync as N}from"@visulima/fs";const R=E(import.meta.url),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,$=n=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[e,t]=h.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return h.getBuiltinModule(n)}return R(n)},{readFileSync:A}=$("node:fs"),{readFile:C}=$("node:fs/promises"),U={sha256:"sha256",sha384:"sha384",sha512:"sha512"},B=1024,M=/^[A-Z0-9+/]+={0,2}$/i,j="node_modules/",m=/^['"]/,k=/['"]$/,T=/^[a-z][a-zA-Z0-9]*:\s*$/m,q=/resolution:\s*\{[^}]*integrity:\s*([^,}\s]+)/,P=/^["']?((?:@[^/@"']+\/)?[^@"'\n]+)@[^\n]+\n((?:[\t ][^\n]*(?:\n|$))+)/gm,z=/^\s+version:?\s+"?([^"\n]+)"?/m,J=/^\s+integrity[\s:]+"?([^"\s]+)"?/m,v=n=>{if(n.length>B)return;const e=n.indexOf("-");if(e<=0)return;const t=U[n.slice(0,e).toLowerCase()];if(!t)return;const s=n.slice(e+1);if(M.test(s))try{const c=Buffer.from(s,"base64");return c.length===0?void 0:{algorithm:t,hex:c.toString("hex")}}catch{return}},w=(n,e,t)=>{const s=`${t.name}@${t.version}`;e.has(s)||(e.add(s),n.push(t))},u=(n,e,t)=>{t&&Object.keys(t).length>0&&(n[e]={...t})},g=n=>{if(!n)return;const e={};for(const[t,s]of Object.entries(n))e[t]=[s];return Object.keys(e).length>0?e:void 0},Z=n=>{const e=[],t=new Set;let s;try{s=JSON.parse(n)}catch{return e}if(!s.packages)return e;for(const[c,o]of Object.entries(s.packages)){if(!c||!o.version)continue;const p=c.lastIndexOf(j);if(p===-1)continue;const i=c.slice(p+j.length);if(i.length===0)continue;const r=i.split("/"),a=i.startsWith("@")?2:1;if(r.length!==a||r.some(f=>f.length===0))continue;const l=o.name??i;if(l.startsWith("."))continue;const d={name:l,version:o.version};if(o.integrity){const f=v(o.integrity);f&&(d.integrity=f)}u(d,"dependencies",g(o.dependencies)),u(d,"peerDependencies",g(o.peerDependencies)),u(d,"optionalDependencies",g(o.optionalDependencies)),w(e,t,d)}return e},O=n=>{let e=n.trim();e.startsWith("/")&&(e=e.slice(1)),e=e.replace(m,"").replace(k,"");const t=e.indexOf("(");t>0&&(e=e.slice(0,t));const s=e.lastIndexOf("@");if(s<=0)return;const c=e.slice(0,s),o=e.slice(s+1);if(!(!c||!o||o.startsWith("link:")||o.startsWith("workspace:")||o.startsWith("file:")))return{name:c,version:o}},S=(n,e)=>{const t=new RegExp(String.raw`^${e}:\s*$`,"m").exec(n);if(!t)return;const s=t.index+t[0].length,c=T.exec(n.slice(s));return n.slice(s,c?s+c.index:n.length)},Y=n=>{const e=new Map,t=S(n,"snapshots");if(!t)return e;const s=/^ {2}(['"]?[^\s:][^:\n]*?['"]?):\s*\n((?: {4}[^\n]*\n?)+)/gm;let c;for(;(c=s.exec(t)??void 0)!==void 0;){const o=O(c[1]);if(!o)continue;const p=`${o.name}@${o.version}`,i=c[2],r=e.get(p)??{};for(const a of["dependencies","peerDependencies","optionalDependencies"]){const l=y(i,a);if(!l)continue;const d=r[a]??{};for(const[f,L]of Object.entries(l)){const x=d[f]??[];for(const D of L)x.includes(D)||x.push(D);d[f]=x}r[a]=d}e.set(p,r)}return e},G=n=>{const e=[],t=new Set,s=S(n,"packages");if(!s)return e;const c=Y(n),o=/^ {2}(['"]?[^\s:][^:\n]*?['"]?):\s*\n((?: {4}[^\n]*\n?)+)/gm;let p;for(;(p=o.exec(s)??void 0)!==void 0;){const i=O(p[1]);if(!i)continue;const r=p[2],a=q.exec(r),l={name:i.name,version:i.version};if(a?.[1]){const f=v(a[1]);f&&(l.integrity=f)}const d=c.get(`${i.name}@${i.version}`);u(l,"dependencies",d?.dependencies??y(r,"dependencies")),u(l,"peerDependencies",d?.peerDependencies??y(r,"peerDependencies")),u(l,"optionalDependencies",d?.optionalDependencies??y(r,"optionalDependencies")),w(e,t,l)}return e},y=(n,e)=>{const t=new RegExp(String.raw`^ {4}${e}:\s*\n((?: {6,}[^\n]*\n?)+)`,"m").exec(n);if(!t?.[1])return;const s={},c=/^ {6}([^\s:]+):\s*([^\n]+)/gm;let o;for(;(o=c.exec(t[1])??void 0)!==void 0;){const p=o[1].replace(m,"").replace(k,"");let i=o[2].trim();i=i.replace(m,"").replace(k,"");const r=i.indexOf("(");if(r>0&&(i=i.slice(0,r).trim()),!p||!i)continue;const a=s[p]??[];a.includes(i)||a.push(i),s[p]=a}return Object.keys(s).length>0?s:void 0},H=n=>{const e=[],t=new Set,s=P;s.lastIndex=0;let c;for(;(c=s.exec(n)??void 0)!==void 0;){const o=c[1].replace(m,"").replace(k,"");if(!o)continue;const p=c[2],i=z.exec(p);if(!i?.[1])continue;const r={name:o,version:i[1].trim()},a=J.exec(p);if(a?.[1]){const l=v(a[1]);l&&(r.integrity=l)}u(r,"dependencies",b(p,"dependencies")),u(r,"peerDependencies",b(p,"peerDependencies")),u(r,"optionalDependencies",b(p,"optionalDependencies")),w(e,t,r)}return e},b=(n,e)=>{const t=new RegExp(String.raw`^ {2}${e}:\s*\n((?: {4,}[^\n]*\n?)+)`,"m").exec(n);if(!t?.[1])return;const s={},c=/^ {4}(['"]?[^\s:'"]+['"]?)\s*(?::\s*)?['"]([^'"\n]+)['"]/gm;let o;for(;(o=c.exec(t[1])??void 0)!==void 0;){const p=o[1].replace(m,"").replace(k,""),i=o[2];if(p&&i){const r=s[p]??[];r.includes(i)||r.push(i),s[p]=r}}return Object.keys(s).length>0?s:void 0},K=/,(?=\s*[}\]])/g,Q=n=>{const e=[],t=new Set;let s;try{s=JSON.parse(n.replaceAll(K,""))}catch{return e}if(!s.packages)return e;for(const c of Object.values(s.packages)){const o=c[0];if(typeof o!="string")continue;const p=o.indexOf("@",1);if(p<=0)continue;const i=o.slice(0,p),r=o.slice(p+1);if(!i||!r||r.startsWith("workspace:")||r.startsWith("link:")||r.startsWith("file:"))continue;const a={name:i,version:r},l=c[3];if(typeof l=="string"&&l.length>0){const f=v(l);f&&(a.integrity=f)}const d=c[2];if(d&&typeof d=="object"&&!Array.isArray(d)){const f=d;u(a,"dependencies",g(f.dependencies)),u(a,"peerDependencies",g(f.peerDependencies)),u(a,"optionalDependencies",g(f.optionalDependencies))}w(e,t,a)}return e},W=n=>{if(n.endsWith("pnpm-lock.yaml"))return"pnpm";if(n.endsWith("package-lock.json"))return"npm";if(n.endsWith("yarn.lock"))return"yarn";if(n.endsWith("bun.lockb")||n.endsWith("bun.lock"))return"bun"},_=(n,e)=>{switch(e){case"bun":return Q(n);case"npm":return Z(n);case"pnpm":return G(n);case"yarn":return H(n);default:return[]}},F=["pnpm-lock.yaml","package-lock.json","yarn.lock","bun.lock","bun.lockb"],ee=async n=>{const e=await I(F,{type:"file",...n&&{cwd:n}});if(!e)throw new Error("Could not find a supported lock file (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lock)");const t=W(e);if(!t)throw new Error(`Unsupported lock file: ${e}`);const s=await C(e,"utf8");return{entries:_(s,t),path:e,type:t}},ne=n=>{const e=N(F,{type:"file",...n&&{cwd:n}});if(!e)throw new Error("Could not find a supported lock file (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lock)");const t=W(e);if(!t)throw new Error(`Unsupported lock file: ${e}`);return{entries:_(A(e,"utf8"),t),path:e,type:t}};export{v as decodeSriIntegrity,Q as parseBunLockFile,ee as parseLockFile,_ as parseLockFileContent,ne as parseLockFileSync,Z as parseNpmLockFile,G as parsePnpmLockFile,H as parseYarnLockFile};
+import{createRequire as E}from"node:module";import{findUp as N,findUpSync as U}from"@visulima/fs";let R;const A=n=>(R??=E(import.meta.url))(n),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,_=n=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[e,t]=h.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return h.getBuiltinModule(n)}return A(n)},{readFileSync:C}=_("node:fs"),{readFile:I}=_("node:fs/promises"),q={sha256:"sha256",sha384:"sha384",sha512:"sha512"},B=1024,M=/^[A-Z0-9+/]+={0,2}$/i,j="node_modules/",m=/^['"]/,k=/['"]$/,T=/^[a-z][a-zA-Z0-9]*:\s*$/m,P=/resolution:\s*\{[^}]*integrity:\s*([^,}\s]+)/,z=/^["']?((?:@[^/@"']+\/)?[^@"'\n]+)@[^\n]+\n((?:[\t ][^\n]*(?:\n|$))+)/gm,J=/^\s+version:?\s+"?([^"\n]+)"?/m,Z=/^\s+integrity[\s:]+"?([^"\s]+)"?/m,v=n=>{if(n.length>B)return;const e=n.indexOf("-");if(e<=0)return;const t=q[n.slice(0,e).toLowerCase()];if(!t)return;const s=n.slice(e+1);if(M.test(s))try{const c=Buffer.from(s,"base64");return c.length===0?void 0:{algorithm:t,hex:c.toString("hex")}}catch{return}},w=(n,e,t)=>{const s=`${t.name}@${t.version}`;e.has(s)||(e.add(s),n.push(t))},u=(n,e,t)=>{t&&Object.keys(t).length>0&&(n[e]={...t})},g=n=>{if(!n)return;const e={};for(const[t,s]of Object.entries(n))e[t]=[s];return Object.keys(e).length>0?e:void 0},Y=n=>{const e=[],t=new Set;let s;try{s=JSON.parse(n)}catch{return e}if(!s.packages)return e;for(const[c,o]of Object.entries(s.packages)){if(!c||!o.version)continue;const p=c.lastIndexOf(j);if(p===-1)continue;const i=c.slice(p+j.length);if(i.length===0)continue;const r=i.split("/"),a=i.startsWith("@")?2:1;if(r.length!==a||r.some(f=>f.length===0))continue;const l=o.name??i;if(l.startsWith("."))continue;const d={name:l,version:o.version};if(o.integrity){const f=v(o.integrity);f&&(d.integrity=f)}u(d,"dependencies",g(o.dependencies)),u(d,"peerDependencies",g(o.peerDependencies)),u(d,"optionalDependencies",g(o.optionalDependencies)),w(e,t,d)}return e},$=n=>{let e=n.trim();e.startsWith("/")&&(e=e.slice(1)),e=e.replace(m,"").replace(k,"");const t=e.indexOf("(");t>0&&(e=e.slice(0,t));const s=e.lastIndexOf("@");if(s<=0)return;const c=e.slice(0,s),o=e.slice(s+1);if(!(!c||!o||o.startsWith("link:")||o.startsWith("workspace:")||o.startsWith("file:")))return{name:c,version:o}},O=(n,e)=>{const t=new RegExp(String.raw`^${e}:\s*$`,"m").exec(n);if(!t)return;const s=t.index+t[0].length,c=T.exec(n.slice(s));return n.slice(s,c?s+c.index:n.length)},G=n=>{const e=new Map,t=O(n,"snapshots");if(!t)return e;const s=/^ {2}(['"]?[^\s:][^:\n]*?['"]?):\s*\n((?: {4}[^\n]*\n?)+)/gm;let c;for(;(c=s.exec(t)??void 0)!==void 0;){const o=$(c[1]);if(!o)continue;const p=`${o.name}@${o.version}`,i=c[2],r=e.get(p)??{};for(const a of["dependencies","peerDependencies","optionalDependencies"]){const l=y(i,a);if(!l)continue;const d=r[a]??{};for(const[f,L]of Object.entries(l)){const x=d[f]??[];for(const D of L)x.includes(D)||x.push(D);d[f]=x}r[a]=d}e.set(p,r)}return e},H=n=>{const e=[],t=new Set,s=O(n,"packages");if(!s)return e;const c=G(n),o=/^ {2}(['"]?[^\s:][^:\n]*?['"]?):\s*\n((?: {4}[^\n]*\n?)+)/gm;let p;for(;(p=o.exec(s)??void 0)!==void 0;){const i=$(p[1]);if(!i)continue;const r=p[2],a=P.exec(r),l={name:i.name,version:i.version};if(a?.[1]){const f=v(a[1]);f&&(l.integrity=f)}const d=c.get(`${i.name}@${i.version}`);u(l,"dependencies",d?.dependencies??y(r,"dependencies")),u(l,"peerDependencies",d?.peerDependencies??y(r,"peerDependencies")),u(l,"optionalDependencies",d?.optionalDependencies??y(r,"optionalDependencies")),w(e,t,l)}return e},y=(n,e)=>{const t=new RegExp(String.raw`^ {4}${e}:\s*\n((?: {6,}[^\n]*\n?)+)`,"m").exec(n);if(!t?.[1])return;const s={},c=/^ {6}([^\s:]+):\s*([^\n]+)/gm;let o;for(;(o=c.exec(t[1])??void 0)!==void 0;){const p=o[1].replace(m,"").replace(k,"");let i=o[2].trim();i=i.replace(m,"").replace(k,"");const r=i.indexOf("(");if(r>0&&(i=i.slice(0,r).trim()),!p||!i)continue;const a=s[p]??[];a.includes(i)||a.push(i),s[p]=a}return Object.keys(s).length>0?s:void 0},K=n=>{const e=[],t=new Set,s=z;s.lastIndex=0;let c;for(;(c=s.exec(n)??void 0)!==void 0;){const o=c[1].replace(m,"").replace(k,"");if(!o)continue;const p=c[2],i=J.exec(p);if(!i?.[1])continue;const r={name:o,version:i[1].trim()},a=Z.exec(p);if(a?.[1]){const l=v(a[1]);l&&(r.integrity=l)}u(r,"dependencies",b(p,"dependencies")),u(r,"peerDependencies",b(p,"peerDependencies")),u(r,"optionalDependencies",b(p,"optionalDependencies")),w(e,t,r)}return e},b=(n,e)=>{const t=new RegExp(String.raw`^ {2}${e}:\s*\n((?: {4,}[^\n]*\n?)+)`,"m").exec(n);if(!t?.[1])return;const s={},c=/^ {4}(['"]?[^\s:'"]+['"]?)\s*(?::\s*)?['"]([^'"\n]+)['"]/gm;let o;for(;(o=c.exec(t[1])??void 0)!==void 0;){const p=o[1].replace(m,"").replace(k,""),i=o[2];if(p&&i){const r=s[p]??[];r.includes(i)||r.push(i),s[p]=r}}return Object.keys(s).length>0?s:void 0},Q=/,(?=\s*[}\]])/g,V=n=>{const e=[],t=new Set;let s;try{s=JSON.parse(n.replaceAll(Q,""))}catch{return e}if(!s.packages)return e;for(const c of Object.values(s.packages)){const o=c[0];if(typeof o!="string")continue;const p=o.indexOf("@",1);if(p<=0)continue;const i=o.slice(0,p),r=o.slice(p+1);if(!i||!r||r.startsWith("workspace:")||r.startsWith("link:")||r.startsWith("file:"))continue;const a={name:i,version:r},l=c[3];if(typeof l=="string"&&l.length>0){const f=v(l);f&&(a.integrity=f)}const d=c[2];if(d&&typeof d=="object"&&!Array.isArray(d)){const f=d;u(a,"dependencies",g(f.dependencies)),u(a,"peerDependencies",g(f.peerDependencies)),u(a,"optionalDependencies",g(f.optionalDependencies))}w(e,t,a)}return e},S=n=>{if(n.endsWith("pnpm-lock.yaml"))return"pnpm";if(n.endsWith("package-lock.json"))return"npm";if(n.endsWith("yarn.lock"))return"yarn";if(n.endsWith("bun.lockb")||n.endsWith("bun.lock"))return"bun"},W=(n,e)=>{switch(e){case"bun":return V(n);case"npm":return Y(n);case"pnpm":return H(n);case"yarn":return K(n);default:return[]}},F=["pnpm-lock.yaml","package-lock.json","yarn.lock","bun.lock","bun.lockb"],ne=async n=>{const e=await N(F,{type:"file",...n&&{cwd:n}});if(!e)throw new Error("Could not find a supported lock file (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lock)");const t=S(e);if(!t)throw new Error(`Unsupported lock file: ${e}`);const s=await I(e,"utf8");return{entries:W(s,t),path:e,type:t}},te=n=>{const e=U(F,{type:"file",...n&&{cwd:n}});if(!e)throw new Error("Could not find a supported lock file (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lock)");const t=S(e);if(!t)throw new Error(`Unsupported lock file: ${e}`);return{entries:W(C(e,"utf8"),t),path:e,type:t}};export{v as decodeSriIntegrity,V as parseBunLockFile,ne as parseLockFile,W as parseLockFileContent,te as parseLockFileSync,Y as parseNpmLockFile,H as parsePnpmLockFile,K as parseYarnLockFile};

package/dist/monorepo.d.ts

@@ -4,23 +4,23 @@ interface RootMonorepo<T extends Strategy = Strategy> {
   strategy: T;
 }
 /**
-* An asynchronous function to find the root directory path and strategy for a monorepo based on
-* the given current working directory (cwd).
-* @param cwd The current working directory. The type of `cwd` is part of an `Options` type, specifically `Options["cwd"]`.
-* Default is undefined.
-* @returns A `Promise` that resolves to the root directory path and strategy for the monorepo.
-* The type of the returned promise is `Promise&lt;RootMonorepo>`.
-* @throws An `Error` if no monorepo root can be found using lerna, yarn, pnpm, or npm as indicators.
-*/
+ * An asynchronous function to find the root directory path and strategy for a monorepo based on
+ * the given current working directory (cwd).
+ * @param cwd The current working directory. The type of `cwd` is part of an `Options` type, specifically `Options["cwd"]`.
+ * Default is undefined.
+ * @returns A `Promise` that resolves to the root directory path and strategy for the monorepo.
+ * The type of the returned promise is `Promise&lt;RootMonorepo>`.
+ * @throws An `Error` if no monorepo root can be found using lerna, yarn, pnpm, or npm as indicators.
+ */
 declare const findMonorepoRoot: (cwd?: URL | string) => Promise<RootMonorepo>;
 /**
-* An function to find the root directory path and strategy for a monorepo based on
-* the given current working directory (cwd).
-* @param cwd The current working directory. The type of `cwd` is part of an `Options` type, specifically `Options["cwd"]`.
-* Default is undefined.
-* @returns A `Promise` that resolves to the root directory path and strategy for the monorepo.
-* The type of the returned promise is `Promise&lt;RootMonorepo>`.
-* @throws An `Error` if no monorepo root can be found using lerna, yarn, pnpm, or npm as indicators.
-*/
+ * An function to find the root directory path and strategy for a monorepo based on
+ * the given current working directory (cwd).
+ * @param cwd The current working directory. The type of `cwd` is part of an `Options` type, specifically `Options["cwd"]`.
+ * Default is undefined.
+ * @returns A `Promise` that resolves to the root directory path and strategy for the monorepo.
+ * The type of the returned promise is `Promise&lt;RootMonorepo>`.
+ * @throws An `Error` if no monorepo root can be found using lerna, yarn, pnpm, or npm as indicators.
+ */
 declare const findMonorepoRootSync: (cwd?: URL | string) => RootMonorepo;
 export { RootMonorepo, Strategy, findMonorepoRoot, findMonorepoRootSync };

package/dist/monorepo.js

@@ -1 +1 @@
-import{createRequire as d}from"node:module";import{findUp as y,readJson as g,findUpSync as h,readJsonSync as j}from"@visulima/fs";import{NotFoundError as f}from"@visulima/fs/error";import{dirname as u,join as a}from"@visulima/path";import{findPackageManager as w,findPackageManagerSync as k}from"./package-manager.js";const m=d(import.meta.url),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,l=r=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[e,t]=i.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return i.getBuiltinModule(r)}return m(r)},{existsSync:c,readFileSync:p}=l("node:fs"),N=async r=>{const e=await y(["lerna.json","turbo.json"],{type:"file",...r&&{cwd:r}});if(e?.endsWith("lerna.json")){const n=await g(e);if(n&&typeof n=="object"&&!Array.isArray(n)){const o=n;if(o.useWorkspaces||o.packages)return{path:u(e),strategy:"lerna"}}}const t=e?.endsWith("turbo.json");try{const{packageManager:n,path:o}=await w(r);if(["npm","yarn"].includes(n)){const s=a(o,"package.json");if(c(s)&&p(a(o,"package.json"),"utf8").includes("workspaces"))return{path:o,strategy:t?"turbo":n}}else if(n==="pnpm"){const s=a(o,"pnpm-workspace.yaml");if(c(s))return{path:o,strategy:t?"turbo":"pnpm"}}}catch(n){if(!(n instanceof f))throw n}throw new Error(`No monorepo root could be found upwards from the directory ${String(r??process.cwd())} using lerna, yarn, pnpm, or npm as indicators.`)},R=r=>{const e=h(["lerna.json","turbo.json"],{type:"file",...r&&{cwd:r}});if(e?.endsWith("lerna.json")){const n=j(e);if(n.useWorkspaces||n.packages)return{path:u(e),strategy:"lerna"}}const t=e?.endsWith("turbo.json");try{const{packageManager:n,path:o}=k(r);if(["npm","yarn"].includes(n)){const s=a(o,"package.json");if(c(s)&&p(a(o,"package.json"),"utf8").includes("workspaces"))return{path:o,strategy:t?"turbo":n}}else if(n==="pnpm"){const s=a(o,"pnpm-workspace.yaml");if(c(s))return{path:o,strategy:t?"turbo":"pnpm"}}}catch(n){if(!(n instanceof f))throw n}throw new Error(`No monorepo root could be found upwards from the directory ${String(r??process.cwd())} using lerna, yarn, pnpm, or npm as indicators.`)};export{N as findMonorepoRoot,R as findMonorepoRootSync};
+import{createRequire as d}from"node:module";import{findUp as g,readJson as h,findUpSync as j,readJsonSync as w}from"@visulima/fs";import{NotFoundError as f}from"@visulima/fs/error";import{dirname as u,join as a}from"@visulima/path";import{findPackageManager as k,findPackageManagerSync as b}from"./package-manager.js";let m;const l=o=>(m??=d(import.meta.url))(o),c=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,y=o=>{if(typeof c<"u"&&c.versions&&c.versions.node){const[r,t]=c.versions.node.split(".").map(Number);if(r>22||r===22&&t>=3||r===20&&t>=16)return c.getBuiltinModule(o)}return l(o)},{existsSync:i,readFileSync:p}=y("node:fs"),q=async o=>{const r=await g(["lerna.json","turbo.json"],{type:"file",...o&&{cwd:o}});if(r?.endsWith("lerna.json")){const n=await h(r);if(n&&typeof n=="object"&&!Array.isArray(n)){const e=n;if(e.useWorkspaces||e.packages)return{path:u(r),strategy:"lerna"}}}const t=r?.endsWith("turbo.json");try{const{packageManager:n,path:e}=await k(o);if(["npm","yarn"].includes(n)){const s=a(e,"package.json");if(i(s)&&p(a(e,"package.json"),"utf8").includes("workspaces"))return{path:e,strategy:t?"turbo":n}}else if(n==="pnpm"){const s=a(e,"pnpm-workspace.yaml");if(i(s))return{path:e,strategy:t?"turbo":"pnpm"}}}catch(n){if(!(n instanceof f))throw n}throw new Error(`No monorepo root could be found upwards from the directory ${String(o??process.cwd())} using lerna, yarn, pnpm, or npm as indicators.`)},N=o=>{const r=j(["lerna.json","turbo.json"],{type:"file",...o&&{cwd:o}});if(r?.endsWith("lerna.json")){const n=w(r);if(n.useWorkspaces||n.packages)return{path:u(r),strategy:"lerna"}}const t=r?.endsWith("turbo.json");try{const{packageManager:n,path:e}=b(o);if(["npm","yarn"].includes(n)){const s=a(e,"package.json");if(i(s)&&p(a(e,"package.json"),"utf8").includes("workspaces"))return{path:e,strategy:t?"turbo":n}}else if(n==="pnpm"){const s=a(e,"pnpm-workspace.yaml");if(i(s))return{path:e,strategy:t?"turbo":"pnpm"}}}catch(n){if(!(n instanceof f))throw n}throw new Error(`No monorepo root could be found upwards from the directory ${String(o??process.cwd())} using lerna, yarn, pnpm, or npm as indicators.`)};export{q as findMonorepoRoot,N as findMonorepoRootSync};

package/dist/package-json.d.ts

@@ -1,6 +1,6 @@
 import '@visulima/fs';
 import 'type-fest';
-export { F as FindPackageJsonCache, a as NormalizedReadResult, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-BHWsl_Em.js";
+export { F as FindPackageJsonCache, a as NormalizedReadResult, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-CuTm_EgE.js";
 import '@antfu/install-pkg';
 import '@inquirer/core';
 import '@inquirer/type';

package/dist/package-json.js

@@ -1,4 +1,4 @@
-import{createRequire as q}from"node:module";import{installPackage as Y}from"@antfu/install-pkg";import{findUp as G,findUpSync as X,writeJson as z,writeJsonSync as U,readJson as V,readJsonSync as L,readFile as O,readFileSync as H}from"@visulima/fs";import{NotFoundError as x}from"@visulima/fs/error";import{toPath as v,parseJson as P}from"@visulima/fs/utils";import{readYaml as K,readYamlSync as Q}from"@visulima/fs/yaml";import{join as S}from"@visulima/path";import _ from"json5";import Z from"normalize-package-data";import{readPnpmCatalogs as N,resolveCatalogReferences as m,readPnpmCatalogsSync as I}from"./pnpm.js";const M=q(import.meta.url),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,E=r=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[e,o]=h.versions.node.split(".").map(Number);if(e>22||e===22&&o>=3||e===20&&o>=16)return h.getBuiltinModule(r)}return M(r)},{existsSync:j}=E("node:fs"),{createInterface:ee}=E("node:readline"),{styleText:l}=E("node:util"),k=r=>{const e=typeof r;return r!==null&&(e==="object"||e==="function")},J=new Set(["__proto__","prototype","constructor"]),T=1e6,re=r=>r>="0"&&r<="9";function C(r){if(r==="0")return!0;if(/^[1-9]\d*$/.test(r)){const e=Number.parseInt(r,10);return e<=Number.MAX_SAFE_INTEGER&&e<=T}return!1}function b(r,e){return J.has(r)?!1:(r&&C(r)?e.push(Number.parseInt(r,10)):e.push(r),!0)}function te(r){if(typeof r!="string")throw new TypeError(`Expected a string, got ${typeof r}`);const e=[];let o="",t="start",a=!1,n=0;for(const s of r){if(n++,a){o+=s,a=!1;continue}if(s==="\\"){if(t==="index")throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd")throw new Error(`Invalid character '${s}' after an index at position ${n}`);a=!0,t=t==="start"?"property":t;continue}switch(s){case".":{if(t==="index")throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd"){t="property";break}if(!b(o,e))return[];o="",t="property";break}case"[":{if(t==="index")throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd"){t="index";break}if(t==="property"||t==="start"){if((o||t==="property")&&!b(o,e))return[];o=""}t="index";break}case"]":{if(t==="index"){if(o==="")o=(e.pop()||"")+"[]",t="property";else{const i=Number.parseInt(o,10);!Number.isNaN(i)&&Number.isFinite(i)&&i>=0&&i<=Number.MAX_SAFE_INTEGER&&i<=T&&o===String(i)?e.push(i):e.push(o),o="",t="indexEnd"}break}if(t==="indexEnd")throw new Error(`Invalid character '${s}' after an index at position ${n}`);o+=s;break}default:{if(t==="index"&&!re(s))throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd")throw new Error(`Invalid character '${s}' after an index at position ${n}`);t==="start"&&(t="property"),o+=s}}}switch(a&&(o+="\\"),t){case"property":{if(!b(o,e))return[];break}case"index":throw new Error("Index was not closed");case"start":{e.push("");break}}return e}function A(r){if(typeof r=="string")return te(r);if(Array.isArray(r)){const e=[];for(const[o,t]of r.entries()){if(typeof t!="string"&&typeof t!="number")throw new TypeError(`Expected a string or number for path segment at index ${o}, got ${typeof t}`);if(typeof t=="number"&&!Number.isFinite(t))throw new TypeError(`Path segment at index ${o} must be a finite number, got ${t}`);if(J.has(t))return[];typeof t=="string"&&C(t)?e.push(Number.parseInt(t,10)):e.push(t)}return e}return[]}function p(r,e,o){if(!k(r)||typeof e!="string"&&!Array.isArray(e))return o===void 0?r:o;const t=A(e);if(t.length===0)return o;for(let a=0;a<t.length;a++){const n=t[a];if(r=r[n],r==null){if(a!==t.length-1)return o;break}}return r===void 0?o:r}function y(r,e){if(!k(r)||typeof e!="string"&&!Array.isArray(e))return!1;const o=A(e);if(o.length===0)return!1;for(const t of o){if(!k(r)||!(t in r))return!1;r=r[t]}return!0}const oe=async r=>{const{default:e=!1,message:o,transformer:t}=r,a=s=>{const i=l(["cyan","bold"],"?"),c=l(["bold"],s),f=e?`${l(["greenBright"],"Y")}${l(["gray"],"/n")}`:`y/${l(["yellowBright"],"N")}`;return`${i} ${c} ${l(["gray"],`(${f})`)}`},n=s=>t?t(s):s?l(["greenBright"],"Yes"):l(["yellowBright"],"No");return new Promise(s=>{const i=ee({input:process.stdin,output:process.stdout}),c=a(o);i.question(c,f=>{i.close();const g=f.trim().toLowerCase();if(g===""){s(e);return}if(g==="y"||g==="yes"){console.log(`${l(["greenBright"],"✓")} ${n(!0)}`),s(!0);return}if(g==="n"||g==="no"){console.log(`${l(["yellowBright"],"✗")} ${n(!1)}`),s(!1);return}console.log(`${l(["gray"],"→")} ${n(e)}`),s(e)}),i.on("SIGINT",()=>{i.close(),console.log(`
-${l(["gray"],"→")} ${n(e)}`),s(e)})})},ne=typeof process.stdout<"u"&&!process.versions.deno&&!globalThis.window,W=/, ([^,]*)$/,u=new Map,w=new Map,d=(r,e={})=>`${r}|s${String(e.strict?1:0)}|c${String(e.resolveCatalogs?1:0)}|j${String(e.json5===!1?0:1)}|y${String(e.yaml===!1?0:1)}|w${String(e.ignoreWarnings?1:0)}`,D=r=>r.trimStart().startsWith("{"),F=r=>{const e=`${r}|`;for(const o of[w,u])for(const t of o.keys())t.startsWith(e)&&o.delete(t)};class se extends Error{constructor(e){super(`The following warnings were encountered while normalizing package data:
+import{createRequire as q}from"node:module";import{installPackage as G}from"@antfu/install-pkg";import{findUp as X,findUpSync as z,writeJson as U,writeJsonSync as V,readJson as L,readJsonSync as O,readFile as H,readFileSync as K}from"@visulima/fs";import{NotFoundError as x}from"@visulima/fs/error";import{toPath as v,parseJson as P}from"@visulima/fs/utils";import{readYaml as Q,readYamlSync as Z}from"@visulima/fs/yaml";import{join as _}from"@visulima/path";import S from"json5";import ee from"normalize-package-data";import{readPnpmCatalogs as N,resolveCatalogReferences as m,readPnpmCatalogsSync as I}from"./pnpm.js";let M;const Y=r=>(M??=q(import.meta.url))(r),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,E=r=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[e,o]=h.versions.node.split(".").map(Number);if(e>22||e===22&&o>=3||e===20&&o>=16)return h.getBuiltinModule(r)}return Y(r)},{existsSync:j}=E("node:fs"),{createInterface:re}=E("node:readline"),{styleText:l}=E("node:util"),k=r=>{const e=typeof r;return r!==null&&(e==="object"||e==="function")},J=new Set(["__proto__","prototype","constructor"]),T=1e6,te=r=>r>="0"&&r<="9";function C(r){if(r==="0")return!0;if(/^[1-9]\d*$/.test(r)){const e=Number.parseInt(r,10);return e<=Number.MAX_SAFE_INTEGER&&e<=T}return!1}function b(r,e){return J.has(r)?!1:(r&&C(r)?e.push(Number.parseInt(r,10)):e.push(r),!0)}function oe(r){if(typeof r!="string")throw new TypeError(`Expected a string, got ${typeof r}`);const e=[];let o="",t="start",a=!1,n=0;for(const s of r){if(n++,a){o+=s,a=!1;continue}if(s==="\\"){if(t==="index")throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd")throw new Error(`Invalid character '${s}' after an index at position ${n}`);a=!0,t=t==="start"?"property":t;continue}switch(s){case".":{if(t==="index")throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd"){t="property";break}if(!b(o,e))return[];o="",t="property";break}case"[":{if(t==="index")throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd"){t="index";break}if(t==="property"||t==="start"){if((o||t==="property")&&!b(o,e))return[];o=""}t="index";break}case"]":{if(t==="index"){if(o==="")o=(e.pop()||"")+"[]",t="property";else{const i=Number.parseInt(o,10);!Number.isNaN(i)&&Number.isFinite(i)&&i>=0&&i<=Number.MAX_SAFE_INTEGER&&i<=T&&o===String(i)?e.push(i):e.push(o),o="",t="indexEnd"}break}if(t==="indexEnd")throw new Error(`Invalid character '${s}' after an index at position ${n}`);o+=s;break}default:{if(t==="index"&&!te(s))throw new Error(`Invalid character '${s}' in an index at position ${n}`);if(t==="indexEnd")throw new Error(`Invalid character '${s}' after an index at position ${n}`);t==="start"&&(t="property"),o+=s}}}switch(a&&(o+="\\"),t){case"property":{if(!b(o,e))return[];break}case"index":throw new Error("Index was not closed");case"start":{e.push("");break}}return e}function A(r){if(typeof r=="string")return oe(r);if(Array.isArray(r)){const e=[];for(const[o,t]of r.entries()){if(typeof t!="string"&&typeof t!="number")throw new TypeError(`Expected a string or number for path segment at index ${o}, got ${typeof t}`);if(typeof t=="number"&&!Number.isFinite(t))throw new TypeError(`Path segment at index ${o} must be a finite number, got ${t}`);if(J.has(t))return[];typeof t=="string"&&C(t)?e.push(Number.parseInt(t,10)):e.push(t)}return e}return[]}function p(r,e,o){if(!k(r)||typeof e!="string"&&!Array.isArray(e))return o===void 0?r:o;const t=A(e);if(t.length===0)return o;for(let a=0;a<t.length;a++){const n=t[a];if(r=r[n],r==null){if(a!==t.length-1)return o;break}}return r===void 0?o:r}function y(r,e){if(!k(r)||typeof e!="string"&&!Array.isArray(e))return!1;const o=A(e);if(o.length===0)return!1;for(const t of o){if(!k(r)||!(t in r))return!1;r=r[t]}return!0}const ne=async r=>{const{default:e=!1,message:o,transformer:t}=r,a=s=>{const i=l(["cyan","bold"],"?"),c=l(["bold"],s),f=e?`${l(["greenBright"],"Y")}${l(["gray"],"/n")}`:`y/${l(["yellowBright"],"N")}`;return`${i} ${c} ${l(["gray"],`(${f})`)}`},n=s=>t?t(s):s?l(["greenBright"],"Yes"):l(["yellowBright"],"No");return new Promise(s=>{const i=re({input:process.stdin,output:process.stdout}),c=a(o);i.question(c,f=>{i.close();const g=f.trim().toLowerCase();if(g===""){s(e);return}if(g==="y"||g==="yes"){console.log(`${l(["greenBright"],"✓")} ${n(!0)}`),s(!0);return}if(g==="n"||g==="no"){console.log(`${l(["yellowBright"],"✗")} ${n(!1)}`),s(!1);return}console.log(`${l(["gray"],"→")} ${n(e)}`),s(e)}),i.on("SIGINT",()=>{i.close(),console.log(`
+${l(["gray"],"→")} ${n(e)}`),s(e)})})},se=typeof process.stdout<"u"&&!process.versions.deno&&!globalThis.window,W=/, ([^,]*)$/,u=new Map,w=new Map,d=(r,e={})=>`${r}|s${String(e.strict?1:0)}|c${String(e.resolveCatalogs?1:0)}|j${String(e.json5===!1?0:1)}|y${String(e.yaml===!1?0:1)}|w${String(e.ignoreWarnings?1:0)}`,D=r=>r.trimStart().startsWith("{"),F=r=>{const e=`${r}|`;for(const o of[w,u])for(const t of o.keys())t.startsWith(e)&&o.delete(t)};class ae extends Error{constructor(e){super(`The following warnings were encountered while normalizing package data:
 - ${e.join(`
-- `)}`),this.name="PackageJsonValidationError"}}const $=(r,e,o=[])=>{const t=[];if(Z(r,a=>{t.push(a)},e),e&&t.length>0){const a=t.filter(n=>!o.some(s=>s instanceof RegExp?s.test(n):s===n));if(a.length>0)throw new se(a)}return r},ae=async r=>await K(r),ie=r=>Q(r),ce=async r=>{const e=await O(r);return _.parse(e)},fe=r=>{const e=H(r);return _.parse(e)},B=async(r,e)=>e?.yaml!==!1&&(r.endsWith(".yaml")||r.endsWith(".yml"))?ae(r):e?.json5!==!1&&r.endsWith(".json5")?ce(r):V(r),R=(r,e)=>e?.yaml!==!1&&(r.endsWith(".yaml")||r.endsWith(".yml"))?ie(r):e?.json5!==!1&&r.endsWith(".json5")?fe(r):L(r),be=async(r,e={})=>{const o={type:"file"};r&&(o.cwd=r);const t=["package.json"];e.yaml!==!1&&t.push("package.yaml","package.yml"),e.json5!==!1&&t.push("package.json5");const a=await G(t,o);if(!a)throw new x(`No such file or directory, for ${t.join(", ").replace(W," or $1")} found.`);const n=e.cache&&typeof e.cache!="boolean"?e.cache:w,s=d(a,e);if(e.cache&&n.has(s))return n.get(s);const i=await B(a,e);if(e.resolveCatalogs){const f=await N(a);f&&m(i,f)}$(i,e.strict??!1,e.ignoreWarnings);const c={packageJson:i,path:a};return e.cache&&n.set(s,c),c},ke=(r,e={})=>{const o={type:"file"};r&&(o.cwd=r);const t=["package.json"];e.yaml!==!1&&t.push("package.yaml","package.yml"),e.json5!==!1&&t.push("package.json5");const a=X(t,o);if(!a)throw new x(`No such file or directory, for ${t.join(", ").replace(W," or $1")} found.`);const n=e.cache&&typeof e.cache!="boolean"?e.cache:w,s=d(a,e);if(e.cache&&n.has(s))return n.get(s);const i=R(a,e);if(e.resolveCatalogs){const f=I(a);f&&m(i,f)}$(i,e.strict??!1,e.ignoreWarnings);const c={packageJson:i,path:a};return e.cache&&n.set(s,c),c},Ee=async(r,e={})=>{const{cwd:o,...t}=e,a=v(o??process.cwd()),n=S(a,"package.json");await z(n,r,t),F(n)},ve=(r,e={})=>{const{cwd:o,...t}=e,a=v(o??process.cwd()),n=S(a,"package.json");U(n,r,t),F(n)},je=()=>{w.clear(),u.clear()},xe=(r,e)=>{const o=typeof r=="object"&&!Array.isArray(r);if(!o&&typeof r!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let t,a=!1,n;if(o)t=structuredClone(r);else if(!D(r)&&j(r)){n=r;const i=e?.cache&&typeof e.cache!="boolean"?e.cache:u,c=d(n,e);if(e?.cache&&i.has(c))return i.get(c);t=R(n,e),a=!0}else t=P(r);if(e?.resolveCatalogs)if(a){const i=I(r);i&&m(t,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");$(t,e?.strict??!1,e?.ignoreWarnings);const s=t;return a&&e?.cache&&(typeof e.cache=="boolean"?u:e.cache).set(d(n,e),s),s},Pe=async(r,e)=>{const o=typeof r=="object"&&!Array.isArray(r);if(!o&&typeof r!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let t,a=!1,n;if(o)t=structuredClone(r);else if(!D(r)&&j(r)){n=r;const i=e?.cache&&typeof e.cache!="boolean"?e.cache:u,c=d(n,e);if(e?.cache&&i.has(c))return i.get(c);t=await B(n,e),a=!0}else t=P(r);if(e?.resolveCatalogs)if(a){const i=await N(r);i&&m(t,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");$(t,e?.strict??!1,e?.ignoreWarnings);const s=t;return a&&e?.cache&&(typeof e.cache=="boolean"?u:e.cache).set(d(n,e),s),s},Se=(r,e,o)=>p(r,e,o),_e=(r,e)=>y(r,e),Ne=(r,e,o)=>{const t=p(r,"dependencies",{}),a=p(r,"devDependencies",{}),n=p(r,"peerDependencies",{}),s={...t,...a,...o?.peerDeps===!1?{}:n};for(const i of e)if(y(s,i))return!0;return!1},Ie=async(r,e,o="dependencies",t={})=>{const a=p(r,"dependencies",{}),n=p(r,"devDependencies",{}),s=p(r,"peerDependencies",{}),i=[],c={deps:!0,devDeps:!0,peerDeps:!1,...t,...t.confirm?{confirm:{...t.confirm}}:{}};for(const f of e)c.deps&&y(a,f)||c.devDeps&&y(n,f)||c.peerDeps&&y(s,f)||i.push(f);if(i.length!==0){if(process.env.CI||ne&&!process.stdout.isTTY){const f=`Skipping package installation for [${e.join(", ")}] because the process is not interactive.`;if(t.throwOnWarn)throw new Error(f);t.logger?.warn?t.logger.warn(f):console.warn(f);return}if(typeof c.confirm?.message=="function"&&(c.confirm.message=c.confirm.message(i)),c.confirm?.message===void 0){const f=`${i.length===1?"Package is":"Packages are"} required for this config: ${i.join(", ")}. Do you want to install them?`;c.confirm===void 0?c.confirm={message:f}:c.confirm.message=f}await oe(c.confirm)&&await Y(i,{...c.installPackage,cwd:c.cwd?v(c.cwd):void 0,dev:o==="devDependencies"})}};export{je as clearPackageJsonCache,Ie as ensurePackages,be as findPackageJson,ke as findPackageJsonSync,Se as getPackageJsonProperty,Ne as hasPackageJsonAnyDependency,_e as hasPackageJsonProperty,Pe as parsePackageJson,xe as parsePackageJsonSync,Ee as writePackageJson,ve as writePackageJsonSync};
+- `)}`),this.name="PackageJsonValidationError"}}const $=(r,e,o=[])=>{const t=[];if(ee(r,a=>{t.push(a)},e),e&&t.length>0){const a=t.filter(n=>!o.some(s=>s instanceof RegExp?s.test(n):s===n));if(a.length>0)throw new ae(a)}return r},ie=async r=>await Q(r),ce=r=>Z(r),fe=async r=>{const e=await H(r);return S.parse(e)},le=r=>{const e=K(r);return S.parse(e)},B=async(r,e)=>e?.yaml!==!1&&(r.endsWith(".yaml")||r.endsWith(".yml"))?ie(r):e?.json5!==!1&&r.endsWith(".json5")?fe(r):L(r),R=(r,e)=>e?.yaml!==!1&&(r.endsWith(".yaml")||r.endsWith(".yml"))?ce(r):e?.json5!==!1&&r.endsWith(".json5")?le(r):O(r),ke=async(r,e={})=>{const o={type:"file"};r&&(o.cwd=r);const t=["package.json"];e.yaml!==!1&&t.push("package.yaml","package.yml"),e.json5!==!1&&t.push("package.json5");const a=await X(t,o);if(!a)throw new x(`No such file or directory, for ${t.join(", ").replace(W," or $1")} found.`);const n=e.cache&&typeof e.cache!="boolean"?e.cache:w,s=d(a,e);if(e.cache&&n.has(s))return n.get(s);const i=await B(a,e);if(e.resolveCatalogs){const f=await N(a);f&&m(i,f)}$(i,e.strict??!1,e.ignoreWarnings);const c={packageJson:i,path:a};return e.cache&&n.set(s,c),c},Ee=(r,e={})=>{const o={type:"file"};r&&(o.cwd=r);const t=["package.json"];e.yaml!==!1&&t.push("package.yaml","package.yml"),e.json5!==!1&&t.push("package.json5");const a=z(t,o);if(!a)throw new x(`No such file or directory, for ${t.join(", ").replace(W," or $1")} found.`);const n=e.cache&&typeof e.cache!="boolean"?e.cache:w,s=d(a,e);if(e.cache&&n.has(s))return n.get(s);const i=R(a,e);if(e.resolveCatalogs){const f=I(a);f&&m(i,f)}$(i,e.strict??!1,e.ignoreWarnings);const c={packageJson:i,path:a};return e.cache&&n.set(s,c),c},ve=async(r,e={})=>{const{cwd:o,...t}=e,a=v(o??process.cwd()),n=_(a,"package.json");await U(n,r,t),F(n)},je=(r,e={})=>{const{cwd:o,...t}=e,a=v(o??process.cwd()),n=_(a,"package.json");V(n,r,t),F(n)},xe=()=>{w.clear(),u.clear()},Pe=(r,e)=>{const o=typeof r=="object"&&!Array.isArray(r);if(!o&&typeof r!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let t,a=!1,n;if(o)t=structuredClone(r);else if(!D(r)&&j(r)){n=r;const i=e?.cache&&typeof e.cache!="boolean"?e.cache:u,c=d(n,e);if(e?.cache&&i.has(c))return i.get(c);t=R(n,e),a=!0}else t=P(r);if(e?.resolveCatalogs)if(a){const i=I(r);i&&m(t,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");$(t,e?.strict??!1,e?.ignoreWarnings);const s=t;return a&&e?.cache&&(typeof e.cache=="boolean"?u:e.cache).set(d(n,e),s),s},_e=async(r,e)=>{const o=typeof r=="object"&&!Array.isArray(r);if(!o&&typeof r!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let t,a=!1,n;if(o)t=structuredClone(r);else if(!D(r)&&j(r)){n=r;const i=e?.cache&&typeof e.cache!="boolean"?e.cache:u,c=d(n,e);if(e?.cache&&i.has(c))return i.get(c);t=await B(n,e),a=!0}else t=P(r);if(e?.resolveCatalogs)if(a){const i=await N(r);i&&m(t,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");$(t,e?.strict??!1,e?.ignoreWarnings);const s=t;return a&&e?.cache&&(typeof e.cache=="boolean"?u:e.cache).set(d(n,e),s),s},Se=(r,e,o)=>p(r,e,o),Ne=(r,e)=>y(r,e),Ie=(r,e,o)=>{const t=p(r,"dependencies",{}),a=p(r,"devDependencies",{}),n=p(r,"peerDependencies",{}),s={...t,...a,...o?.peerDeps===!1?{}:n};for(const i of e)if(y(s,i))return!0;return!1},Je=async(r,e,o="dependencies",t={})=>{const a=p(r,"dependencies",{}),n=p(r,"devDependencies",{}),s=p(r,"peerDependencies",{}),i=[],c={deps:!0,devDeps:!0,peerDeps:!1,...t,...t.confirm?{confirm:{...t.confirm}}:{}};for(const f of e)c.deps&&y(a,f)||c.devDeps&&y(n,f)||c.peerDeps&&y(s,f)||i.push(f);if(i.length!==0){if(process.env.CI||se&&!process.stdout.isTTY){const f=`Skipping package installation for [${e.join(", ")}] because the process is not interactive.`;if(t.throwOnWarn)throw new Error(f);t.logger?.warn?t.logger.warn(f):console.warn(f);return}if(typeof c.confirm?.message=="function"&&(c.confirm.message=c.confirm.message(i)),c.confirm?.message===void 0){const f=`${i.length===1?"Package is":"Packages are"} required for this config: ${i.join(", ")}. Do you want to install them?`;c.confirm===void 0?c.confirm={message:f}:c.confirm.message=f}await ne(c.confirm)&&await G(i,{...c.installPackage,cwd:c.cwd?v(c.cwd):void 0,dev:o==="devDependencies"})}};export{xe as clearPackageJsonCache,Je as ensurePackages,ke as findPackageJson,Ee as findPackageJsonSync,Se as getPackageJsonProperty,Ie as hasPackageJsonAnyDependency,Ne as hasPackageJsonProperty,_e as parsePackageJson,Pe as parsePackageJsonSync,ve as writePackageJson,je as writePackageJsonSync};

package/dist/package-manager.d.ts

@@ -1,11 +1,11 @@
 /**
-* An asynchronous function that finds a lock file in the specified directory or any of its parent directories.
-* @param cwd Optional. The directory path to start the search from. The type of `cwd` is part of an `Options` type,
-* specifically `URL | string`. Defaults to the current working directory.
-* @returns A `Promise` that resolves with the path of the found lock file.
-* The type of the returned promise is `Promise<string>`.
-* @throws An `Error` if no lock file is found.
-*/
+ * An asynchronous function that finds a lock file in the specified directory or any of its parent directories.
+ * @param cwd Optional. The directory path to start the search from. The type of `cwd` is part of an `Options` type,
+ * specifically `URL | string`. Defaults to the current working directory.
+ * @returns A `Promise` that resolves with the path of the found lock file.
+ * The type of the returned promise is `Promise<string>`.
+ * @throws An `Error` if no lock file is found.
+ */
 declare const findLockFile: (cwd?: URL | string) => Promise<string>;
 declare const findLockFileSync: (cwd?: URL | string) => string;
 type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
@@ -14,57 +14,57 @@ type PackageManagerResult = {
   path: string;
 };
 /**
-* An asynchronous function that finds the package manager used in a project based on the presence of lock files
-* or package.json configuration. If found, it returns the package manager and the path to the lock file or package.json.
-* Throws an error if no lock file or package.json is found.
-* @param cwd Optional. The current working directory to start the search from. The type of `cwd` is part of an `Options`
-* type, specifically `URL | string`.
-* @returns A `Promise` that resolves to an object containing the package manager and path.
-* The return type of the function is `Promise&lt;PackageManagerResult>`.
-* @throws An `Error` if no lock file or package.json is found.
-*/
+ * An asynchronous function that finds the package manager used in a project based on the presence of lock files
+ * or package.json configuration. If found, it returns the package manager and the path to the lock file or package.json.
+ * Throws an error if no lock file or package.json is found.
+ * @param cwd Optional. The current working directory to start the search from. The type of `cwd` is part of an `Options`
+ * type, specifically `URL | string`.
+ * @returns A `Promise` that resolves to an object containing the package manager and path.
+ * The return type of the function is `Promise&lt;PackageManagerResult>`.
+ * @throws An `Error` if no lock file or package.json is found.
+ */
 declare const findPackageManager: (cwd?: URL | string) => Promise<PackageManagerResult>;
 /**
-* An function that finds the package manager used in a project based on the presence of lock files
-* or package.json configuration. If found, it returns the package manager and the path to the lock file or package.json.
-* Throws an error if no lock file or package.json is found.
-* @param cwd Optional. The current working directory to start the search from. The type of `cwd` is part of an `Options`
-* type, specifically `URL | string`.
-* @returns A `Promise` that resolves to an object containing the package manager and path.
-* The return type of the function is `Promise&lt;PackageManagerResult>`.
-* @throws An `Error` if no lock file or package.json is found.
-*/
+ * An function that finds the package manager used in a project based on the presence of lock files
+ * or package.json configuration. If found, it returns the package manager and the path to the lock file or package.json.
+ * Throws an error if no lock file or package.json is found.
+ * @param cwd Optional. The current working directory to start the search from. The type of `cwd` is part of an `Options`
+ * type, specifically `URL | string`.
+ * @returns A `Promise` that resolves to an object containing the package manager and path.
+ * The return type of the function is `Promise&lt;PackageManagerResult>`.
+ * @throws An `Error` if no lock file or package.json is found.
+ */
 declare const findPackageManagerSync: (cwd?: URL | string) => PackageManagerResult;
 /**
-* Function that retrieves the version of the specified package manager.
-* @param name The name of the package manager. Must be one of the known managers (`npm`, `pnpm`, `yarn`, `bun`).
-* @returns The version of the package manager. The return type of the function is `string`.
-* @throws An `Error` if `name` is not a recognized package manager. This guards against executing an
-* arbitrary or relative-path binary derived from untrusted input.
-*/
+ * Function that retrieves the version of the specified package manager.
+ * @param name The name of the package manager. Must be one of the known managers (`npm`, `pnpm`, `yarn`, `bun`).
+ * @returns The version of the package manager. The return type of the function is `string`.
+ * @throws An `Error` if `name` is not a recognized package manager. This guards against executing an
+ * arbitrary or relative-path binary derived from untrusted input.
+ */
 declare const getPackageManagerVersion: (name: string) => string;
 /**
-* An asynchronous function that detects what package manager executes the process.
-*
-* Supports npm, pnpm, Yarn, cnpm, and bun. And also any other package manager that sets the npm_config_user_agent env variable.
-* @returns An object containing the name and version of the package manager,
-* or undefined if the package manager information cannot be determined.
-*/
+ * An asynchronous function that detects what package manager executes the process.
+ *
+ * Supports npm, pnpm, Yarn, cnpm, and bun. And also any other package manager that sets the npm_config_user_agent env variable.
+ * @returns An object containing the name and version of the package manager,
+ * or undefined if the package manager information cannot be determined.
+ */
 declare const identifyInitiatingPackageManager: () => {
   name: PackageManager | "cnpm" | (string & {});
   version: string;
 } | undefined;
 /**
-* Function that generates a message to install missing packages.
-* @param packageName The name of the package that requires the missing packages.
-* @param missingPackages An array of missing package names.
-* @param options An object containing optional parameters:
-* @param options.packageManagers An array of package managers to include in the message. Defaults to \["npm", "pnpm", "yarn"\].
-* @param options.postMessage A string to append to the end of the message.
-* @param options.preMessage A string to prepend to the beginning of the message.
-* @returns A string message with instructions to install the missing packages using the specified package managers.
-* @throws An `Error` if no package managers are provided in the options.
-*/
+ * Function that generates a message to install missing packages.
+ * @param packageName The name of the package that requires the missing packages.
+ * @param missingPackages An array of missing package names.
+ * @param options An object containing optional parameters:
+ * @param options.packageManagers An array of package managers to include in the message. Defaults to \["npm", "pnpm", "yarn"\].
+ * @param options.postMessage A string to append to the end of the message.
+ * @param options.preMessage A string to prepend to the beginning of the message.
+ * @returns A string message with instructions to install the missing packages using the specified package managers.
+ * @throws An `Error` if no package managers are provided in the options.
+ */
 declare const generateMissingPackagesInstallMessage: (packageName: string, missingPackages: string[], options: {
   packageManagers?: PackageManager[];
   postMessage?: string;

package/dist/package-manager.js

@@ -1,4 +1,4 @@
-import{createRequire as b}from"node:module";import{findUp as k,findUpSync as h}from"@visulima/fs";import{NotFoundError as f}from"@visulima/fs/error";import{parseJson as S}from"@visulima/fs/utils";import{join as p,dirname as s}from"@visulima/path";const $=b(import.meta.url),t=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,u=e=>{if(typeof t<"u"&&t.versions&&t.versions.node){const[n,a]=t.versions.node.split(".").map(Number);if(n>22||n===22&&a>=3||n===20&&a>=16)return t.getBuiltinModule(e)}return $(e)},{execFileSync:E}=u("node:child_process"),{existsSync:d,readFileSync:x}=u("node:fs"),g=["yarn.lock","package-lock.json","pnpm-lock.yaml","npm-shrinkwrap.json","bun.lock","bun.lockb"],m=new Set(["bun","npm","pnpm","yarn"]),w=e=>{const n=S(x(e,"utf8"));return typeof n?.packageManager=="string"?n.packageManager:void 0},y=e=>{let n;if(g.forEach(r=>{!n&&d(p(e,r))&&(n=p(e,r))}),n)return n;const a=p(e,"package.json");if(d(a)&&w(a)!==void 0)return a},M=e=>{if(!e)throw new f("Could not find a package manager");if(e.endsWith("package.json")){const n=w(e);if(n){const a=["npm","yarn","pnpm","bun"].find(r=>n.startsWith(r));if(a)return{packageManager:a,path:s(e)}}}if(e.endsWith("yarn.lock"))return{packageManager:"yarn",path:s(e)};if(e.endsWith("package-lock.json")||e.endsWith("npm-shrinkwrap.json"))return{packageManager:"npm",path:s(e)};if(e.endsWith("pnpm-lock.yaml"))return{packageManager:"pnpm",path:s(e)};if(e.endsWith("bun.lock")||e.endsWith("bun.lockb"))return{packageManager:"bun",path:s(e)};throw new f("Could not find a package manager")},N=async e=>{const n=await k(g,{type:"file",...e&&{cwd:e}});if(!n)throw new Error("Could not find lock file");return n},T=e=>{const n=h(g,{type:"file",...e&&{cwd:e}});if(!n)throw new Error("Could not find lock file");return n},U=async e=>{const n=await k(y,{...e&&{cwd:e}});return M(n)},q=e=>{const n=h(y,{...e&&{cwd:e}});return M(n)},B=e=>{if(!m.has(e))throw new Error(`Unsupported package manager "${e}". Expected one of: ${[...m].join(", ")}.`);return E(e,["--version"]).toString("utf8").trim()},D=()=>{if(!process.env.npm_config_user_agent)return;const e=process.env.npm_config_user_agent.split(" ")[0],n=e.lastIndexOf("/"),a=e.slice(0,Math.max(0,n));return{name:a==="npminstall"?"cnpm":a,version:e.slice(Math.max(0,n+1))}},L=(e,n,a)=>{const r=n.length===1?"":"s",l=a.packageManagers??["npm","pnpm","yarn"];if(l.length===0)throw new Error("No package managers provided, please provide at least one package manager");if(n.length===0)throw new Error("No missing packages provided, please provide at least one missing package");let c=`
+import{createRequire as b}from"node:module";import{findUp as k,findUpSync as h}from"@visulima/fs";import{NotFoundError as f}from"@visulima/fs/error";import{parseJson as W}from"@visulima/fs/utils";import{join as p,dirname as s}from"@visulima/path";let $;const E=e=>($??=b(import.meta.url))(e),t=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,m=e=>{if(typeof t<"u"&&t.versions&&t.versions.node){const[n,a]=t.versions.node.split(".").map(Number);if(n>22||n===22&&a>=3||n===20&&a>=16)return t.getBuiltinModule(e)}return E(e)},{execFileSync:x}=m("node:child_process"),{existsSync:d,readFileSync:S}=m("node:fs"),g=["yarn.lock","package-lock.json","pnpm-lock.yaml","npm-shrinkwrap.json","bun.lock","bun.lockb"],u=new Set(["bun","npm","pnpm","yarn"]),w=e=>{const n=W(S(e,"utf8"));return typeof n?.packageManager=="string"?n.packageManager:void 0},y=e=>{let n;if(g.forEach(r=>{!n&&d(p(e,r))&&(n=p(e,r))}),n)return n;const a=p(e,"package.json");if(d(a)&&w(a)!==void 0)return a},M=e=>{if(!e)throw new f("Could not find a package manager");if(e.endsWith("package.json")){const n=w(e);if(n){const a=["npm","yarn","pnpm","bun"].find(r=>n.startsWith(r));if(a)return{packageManager:a,path:s(e)}}}if(e.endsWith("yarn.lock"))return{packageManager:"yarn",path:s(e)};if(e.endsWith("package-lock.json")||e.endsWith("npm-shrinkwrap.json"))return{packageManager:"npm",path:s(e)};if(e.endsWith("pnpm-lock.yaml"))return{packageManager:"pnpm",path:s(e)};if(e.endsWith("bun.lock")||e.endsWith("bun.lockb"))return{packageManager:"bun",path:s(e)};throw new f("Could not find a package manager")},N=async e=>{const n=await k(g,{type:"file",...e&&{cwd:e}});if(!n)throw new Error("Could not find lock file");return n},T=e=>{const n=h(g,{type:"file",...e&&{cwd:e}});if(!n)throw new Error("Could not find lock file");return n},U=async e=>{const n=await k(y,{...e&&{cwd:e}});return M(n)},R=e=>{const n=h(y,{...e&&{cwd:e}});return M(n)},B=e=>{if(!u.has(e))throw new Error(`Unsupported package manager "${e}". Expected one of: ${[...u].join(", ")}.`);return x(e,["--version"]).toString("utf8").trim()},D=()=>{if(!process.env.npm_config_user_agent)return;const e=process.env.npm_config_user_agent.split(" ")[0],n=e.lastIndexOf("/"),a=e.slice(0,Math.max(0,n));return{name:a==="npminstall"?"cnpm":a,version:e.slice(Math.max(0,n+1))}},L=(e,n,a)=>{const r=n.length===1?"":"s",l=a.packageManagers??["npm","pnpm","yarn"];if(l.length===0)throw new Error("No package managers provided, please provide at least one package manager");if(n.length===0)throw new Error("No missing packages provided, please provide at least one missing package");let c=`
 ${a.preMessage??""}
 ${e} could not find the following package${r}
 
@@ -10,4 +10,4 @@ To install the missing package${r}, please run the following command:
 
 or
 
-`),a.postMessage&&(c+=a.postMessage),c};export{N as findLockFile,T as findLockFileSync,U as findPackageManager,q as findPackageManagerSync,L as generateMissingPackagesInstallMessage,B as getPackageManagerVersion,D as identifyInitiatingPackageManager};
+`),a.postMessage&&(c+=a.postMessage),c};export{N as findLockFile,T as findLockFileSync,U as findPackageManager,R as findPackageManagerSync,L as generateMissingPackagesInstallMessage,B as getPackageManagerVersion,D as identifyInitiatingPackageManager};

package/dist/package.d.ts

@@ -1,12 +1,12 @@
 /**
-* An asynchronous function that finds the root directory of a project based on certain lookup criteria.
-* @param cwd Optional. The current working directory to start the search from. The type of `cwd` is `string`.
-* @returns A `Promise` that resolves to the path of the root directory. The type of the returned promise is `Promise<string>`.
-* @throws An `Error` if the root directory could not be found.
-* @example
-* const rootDirectory = await findPackageRoot();
-* console.log(rootDirectory); // '/path/to/project'
-*/
+ * An asynchronous function that finds the root directory of a project based on certain lookup criteria.
+ * @param cwd Optional. The current working directory to start the search from. The type of `cwd` is `string`.
+ * @returns A `Promise` that resolves to the path of the root directory. The type of the returned promise is `Promise<string>`.
+ * @throws An `Error` if the root directory could not be found.
+ * @example
+ * const rootDirectory = await findPackageRoot();
+ * console.log(rootDirectory); // '/path/to/project'
+ */
 declare const findPackageRoot: (cwd?: URL | string) => Promise<string>;
 declare const findPackageRootSync: (cwd?: URL | string) => string;
 export { findPackageRoot, findPackageRootSync };

package/dist/package.js

@@ -1 +1 @@
-import{createRequire as d}from"node:module";import{findUp as c,findUpSync as s,readJsonSync as y}from"@visulima/fs";import{dirname as r,join as f}from"@visulima/path";import{findLockFile as g,findLockFileSync as m}from"./package-manager.js";const p=d(import.meta.url),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,u=e=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[o,t]=i.versions.node.split(".").map(Number);if(o>22||o===22&&t>=3||o===20&&t>=16)return i.getBuiltinModule(e)}return p(e)},{existsSync:l}=u("node:fs"),a=e=>{if(l(f(e,"package.json"))){const o=y(f(e,"package.json"));if(o.name&&o.private!==!0)return"package.json"}},k=async e=>{try{const n=await g(e);return r(n)}catch{}const o=await c(".git/config",{...e&&{cwd:e},type:"file"});if(o)return r(r(o));const t=await c(a,{...e&&{cwd:e},type:"file"});if(t)return r(t);throw new Error("Could not find root directory")},S=e=>{try{const n=m(e);return r(n)}catch{}const o=s(".git/config",{...e&&{cwd:e},type:"file"});if(o)return r(r(o));const t=s(a,{...e&&{cwd:e},type:"file"});if(t)return r(t);throw new Error("Could not find root directory")};export{k as findPackageRoot,S as findPackageRootSync};
+import{createRequire as d}from"node:module";import{findUp as c,findUpSync as s,readJsonSync as g}from"@visulima/fs";import{dirname as r,join as a}from"@visulima/path";import{findLockFile as m,findLockFileSync as _}from"./package-manager.js";let u;const p=e=>(u??=d(import.meta.url))(e),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,l=e=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[t,o]=i.versions.node.split(".").map(Number);if(t>22||t===22&&o>=3||t===20&&o>=16)return i.getBuiltinModule(e)}return p(e)},{existsSync:y}=l("node:fs"),f=e=>{if(y(a(e,"package.json"))){const t=g(a(e,"package.json"));if(t.name&&t.private!==!0)return"package.json"}},R=async e=>{try{const n=await m(e);return r(n)}catch{}const t=await c(".git/config",{...e&&{cwd:e},type:"file"});if(t)return r(r(t));const o=await c(f,{...e&&{cwd:e},type:"file"});if(o)return r(o);throw new Error("Could not find root directory")},S=e=>{try{const n=_(e);return r(n)}catch{}const t=s(".git/config",{...e&&{cwd:e},type:"file"});if(t)return r(r(t));const o=s(f,{...e&&{cwd:e},type:"file"});if(o)return r(o);throw new Error("Could not find root directory")};export{R as findPackageRoot,S as findPackageRootSync};

package/dist/packem_shared/package-json.d-CuTm_EgE.d.ts

@@ -0,0 +1,182 @@
+import { WriteJsonOptions } from '@visulima/fs';
+import { PackageJson as PackageJson$1, Paths, JsonObject } from 'type-fest';
+import { InstallPackageOptions } from '@antfu/install-pkg';
+import { Theme } from '@inquirer/core';
+import { PartialDeep } from '@inquirer/type';
+import { Package } from 'normalize-package-data';
+type NormalizedPackageJson = Package & PackageJson;
+type PackageJson = PackageJson$1;
+type Cache<T = unknown> = Map<string, T>;
+type EnsurePackagesOptions = {
+  /** Configuration for user confirmation prompts when installing packages */
+  confirm?: {
+    /** Default value for the confirmation prompt */
+    default?: boolean;
+    /** Message to display in the confirmation prompt, or a function that receives packages array */
+    message: string | ((packages: string[]) => string);
+    /** Theme configuration for the prompt interface */
+    theme?: PartialDeep<Theme>;
+    /** Function to transform the boolean value for display */
+    transformer?: (value: boolean) => string;
+  };
+  /** Current working directory for package operations */
+  cwd?: URL | string;
+  /** Whether to include regular dependencies in the operation */
+  deps?: boolean;
+  /** Whether to include development dependencies in the operation */
+  devDeps?: boolean;
+  /** Additional options for package installation (excluding cwd and dev which are handled separately) */
+  installPackage?: Omit<InstallPackageOptions, "cwd" | "dev">;
+  /** Custom logger interface for warning messages */
+  logger?: {
+    warn: (message: string) => void;
+  };
+  /** Whether to include peer dependencies in the operation */
+  peerDeps?: boolean;
+  /** Whether to throw an error when warnings are logged instead of just logging them */
+  throwOnWarn?: boolean;
+};
+type ReadOptions = {
+  cache?: FindPackageJsonCache | boolean;
+  ignoreWarnings?: (RegExp | string)[];
+  json5?: boolean;
+  resolveCatalogs?: boolean;
+  strict?: boolean;
+  yaml?: boolean;
+};
+type FindPackageJsonCache = Cache<NormalizedReadResult>;
+type NormalizedReadResult = {
+  packageJson: NormalizedPackageJson;
+  path: string;
+};
+/**
+ * An asynchronous function to find the package.json, package.yaml, or package.json5 file in the specified directory or its parent directories.
+ * @param cwd The current working directory.
+ * @param options Configuration options including yaml, json5, and resolveCatalogs flags.
+ * @returns A `Promise` that resolves to an object containing the parsed package data and the file path.
+ * The type of the returned promise is `Promise&lt;NormalizedReadResult>`.
+ * @throws {Error} If no package file can be found or if strict mode is enabled and normalize warnings are thrown.
+ */
+declare const findPackageJson: (cwd?: URL | string, options?: ReadOptions) => Promise<NormalizedReadResult>;
+/**
+ * A synchronous function to find the package.json, package.yaml, or package.json5 file in the specified directory or its parent directories.
+ * @param cwd The current working directory.
+ * @param options Configuration options including yaml, json5, and resolveCatalogs flags.
+ * @returns An object containing the parsed package data and the file path.
+ * @throws {Error} If no package file can be found or if strict mode is enabled and normalize warnings are thrown.
+ */
+declare const findPackageJsonSync: (cwd?: URL | string, options?: ReadOptions) => NormalizedReadResult;
+/**
+ * An asynchronous function to write the package.json file with the given data.
+ * @param data The package.json data to write. The data is an intersection type of `PackageJson` and a record where keys are `string` and values can be any type.
+ * @param options Optional. The options for writing the package.json. If not provided, an empty object will be used `{}`.
+ * This is an intersection type of `WriteJsonOptions` and a record with an optional `cwd` key which type is `Options["cwd"]`.
+ * `cwd` represents the current working directory. If not specified, the default working directory will be used.
+ * @returns A `Promise` that resolves once the package.json file has been written. The type of the returned promise is `Promise&lt;void>`.
+ */
+declare const writePackageJson: (data: PackageJson, options?: WriteJsonOptions & {
+  cwd?: URL | string;
+}) => Promise<void>;
+declare const writePackageJsonSync: (data: PackageJson, options?: WriteJsonOptions & {
+  cwd?: URL | string;
+}) => void;
+/**
+ * Clears the module-level package.json file and parse caches.
+ *
+ * The caches populated by `findPackageJson[Sync]` / `parsePackageJson[Sync]` when
+ * `cache: true` (and no custom cache is supplied) never expire on their own. Call this
+ * to drop all cached reads — for example in long-running processes or tests that mutate
+ * package files out of band.
+ */
+declare const clearPackageJsonCache: () => void;
+/**
+ * A synchronous function to parse the package.json, package.yaml, or package.json5 file/object/string and return normalize the data.
+ * @param packageFile
+ * @param options
+ * @param options.cache Cache for parsed results (only applies to file paths)
+ * @param options.ignoreWarnings List of warning messages or patterns to skip in strict mode
+ * @param options.resolveCatalogs Whether to resolve pnpm catalog references
+ * @param options.strict Whether to throw errors on normalization warnings
+ * @param options.yaml Whether to enable package.yaml parsing (default: true)
+ * @param options.json5 Whether to enable package.json5 parsing (default: true)
+ * @returns
+ * @throws {Error} If the packageFile parameter is not an object or a string or if strict mode is enabled and normalize warnings are thrown.
+ */
+declare const parsePackageJsonSync: (packageFile: JsonObject | string, options?: {
+  cache?: Cache<NormalizedPackageJson> | boolean;
+  ignoreWarnings?: (RegExp | string)[];
+  json5?: boolean;
+  resolveCatalogs?: boolean;
+  strict?: boolean;
+  yaml?: boolean;
+}) => NormalizedPackageJson;
+/**
+ * An asynchronous function to parse the package.json, package.yaml, or package.json5 file/object/string and return normalize the data.
+ * @param packageFile
+ * @param options
+ * @param options.cache Cache for parsed results (only applies to file paths)
+ * @param options.ignoreWarnings List of warning messages or patterns to skip in strict mode
+ * @param options.strict Whether to throw errors on normalization warnings
+ * @param options.resolveCatalogs Whether to resolve pnpm catalog references
+ * @param options.yaml Whether to enable package.yaml parsing (default: true)
+ * @param options.json5 Whether to enable package.json5 parsing (default: true)
+ * @returns
+ * @throws {Error} If the packageFile parameter is not an object or a string or if strict mode is enabled and normalize warnings are thrown.
+ */
+declare const parsePackageJson: (packageFile: JsonObject | string, options?: {
+  cache?: Cache<NormalizedPackageJson> | boolean;
+  ignoreWarnings?: (RegExp | string)[];
+  json5?: boolean;
+  resolveCatalogs?: boolean;
+  strict?: boolean;
+  yaml?: boolean;
+}) => Promise<NormalizedPackageJson>;
+/**
+ * An asynchronous function to get the value of a property from the package.json file.
+ * @param packageJson
+ * @param property
+ * @param defaultValue
+ * @returns
+ */
+declare const getPackageJsonProperty: <T = unknown>(packageJson: NormalizedPackageJson, property: Paths<NormalizedPackageJson>, defaultValue?: T) => T;
+/**
+ * An asynchronous function to check if a property exists in the package.json file.
+ * @param packageJson
+ * @param property
+ * @returns
+ */
+declare const hasPackageJsonProperty: (packageJson: NormalizedPackageJson, property: Paths<NormalizedPackageJson>) => boolean;
+/**
+ * An asynchronous function to check if any of the specified dependencies exist in the package.json file.
+ * @param packageJson
+ * @param arguments_
+ * @param options
+ * @param options.peerDeps Whether to include peer dependencies
+ * @returns
+ */
+declare const hasPackageJsonAnyDependency: (packageJson: NormalizedPackageJson, arguments_: string[], options?: {
+  peerDeps?: boolean;
+}) => boolean;
+/**
+ * An asynchronous function to ensure that the specified packages are installed in the package.json file.
+ * If the packages are not installed, the user will be prompted to install them.
+ * If the user agrees, the packages will be installed.
+ * If the user declines, the function will return without installing the packages.
+ * If the user does not respond, the function will return without installing the packages.
+ * @param packageJson
+ * @param packages
+ * @param installKey
+ * @param options
+ * @param options.deps Whether to include regular dependencies
+ * @param options.devDeps Whether to include development dependencies
+ * @param options.peerDeps Whether to include peer dependencies
+ * @param options.throwOnWarn Whether to throw an error when warnings are logged instead of just logging them
+ * @param options.logger Whether to use a custom logger
+ * @param options.confirm Whether to use a custom confirmation prompt
+ * @param options.installPackage Whether to use a custom installation package
+ * @param options.cwd Whether to use a custom current working directory
+ * @param options.dev Whether to use a custom installation key
+ * @returns
+ */
+declare const ensurePackages: (packageJson: NormalizedPackageJson, packages: string[], installKey?: "dependencies" | "devDependencies", options?: EnsurePackagesOptions) => Promise<void>;
+export { EnsurePackagesOptions as E, FindPackageJsonCache as F, NormalizedPackageJson as N, PackageJson as P, NormalizedReadResult as a, findPackageJsonSync as b, clearPackageJsonCache as c, hasPackageJsonProperty as d, ensurePackages as e, findPackageJson as f, getPackageJsonProperty as g, hasPackageJsonAnyDependency as h, parsePackageJsonSync as i, writePackageJsonSync as j, parsePackageJson as p, writePackageJson as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/package",
-  "version": "5.0.8",
+  "version": "5.0.10",
   "description": "A comprehensive package management utility that helps you find root directories, monorepos, package managers, and parse package.json, package.yaml, and package.json5 files with advanced features like catalog resolution.",
   "keywords": [
     "anolilab",
@@ -58,7 +58,8 @@
     "dist/**",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE.md"
+    "LICENSE.md",
+    "MIGRATION-GUIDE.md"
   ],
   "os": [
     "darwin",
@@ -108,7 +109,7 @@
   },
   "dependencies": {
     "@antfu/install-pkg": "^1.1.0",
-    "@visulima/fs": "5.0.8",
+    "@visulima/fs": "5.0.11",
     "@visulima/path": "3.0.0",
     "json5": "^2.2.3",
     "normalize-package-data": "^9.0.0",

package/dist/packem_shared/package-json.d-BHWsl_Em.d.ts

@@ -1,182 +0,0 @@
-import { WriteJsonOptions } from '@visulima/fs';
-import { PackageJson as PackageJson$1, Paths, JsonObject } from 'type-fest';
-import { InstallPackageOptions } from '@antfu/install-pkg';
-import { Theme } from '@inquirer/core';
-import { PartialDeep } from '@inquirer/type';
-import { Package } from 'normalize-package-data';
-type NormalizedPackageJson = Package & PackageJson;
-type PackageJson = PackageJson$1;
-type Cache<T = unknown> = Map<string, T>;
-type EnsurePackagesOptions = {
-  /** Configuration for user confirmation prompts when installing packages */
-  confirm?: {
-    /** Default value for the confirmation prompt */
-    default?: boolean;
-    /** Message to display in the confirmation prompt, or a function that receives packages array */
-    message: string | ((packages: string[]) => string);
-    /** Theme configuration for the prompt interface */
-    theme?: PartialDeep<Theme>;
-    /** Function to transform the boolean value for display */
-    transformer?: (value: boolean) => string;
-  };
-  /** Current working directory for package operations */
-  cwd?: URL | string;
-  /** Whether to include regular dependencies in the operation */
-  deps?: boolean;
-  /** Whether to include development dependencies in the operation */
-  devDeps?: boolean;
-  /** Additional options for package installation (excluding cwd and dev which are handled separately) */
-  installPackage?: Omit<InstallPackageOptions, "cwd" | "dev">;
-  /** Custom logger interface for warning messages */
-  logger?: {
-    warn: (message: string) => void;
-  };
-  /** Whether to include peer dependencies in the operation */
-  peerDeps?: boolean;
-  /** Whether to throw an error when warnings are logged instead of just logging them */
-  throwOnWarn?: boolean;
-};
-type ReadOptions = {
-  cache?: FindPackageJsonCache | boolean;
-  ignoreWarnings?: (RegExp | string)[];
-  json5?: boolean;
-  resolveCatalogs?: boolean;
-  strict?: boolean;
-  yaml?: boolean;
-};
-type FindPackageJsonCache = Cache<NormalizedReadResult>;
-type NormalizedReadResult = {
-  packageJson: NormalizedPackageJson;
-  path: string;
-};
-/**
-* An asynchronous function to find the package.json, package.yaml, or package.json5 file in the specified directory or its parent directories.
-* @param cwd The current working directory.
-* @param options Configuration options including yaml, json5, and resolveCatalogs flags.
-* @returns A `Promise` that resolves to an object containing the parsed package data and the file path.
-* The type of the returned promise is `Promise&lt;NormalizedReadResult>`.
-* @throws {Error} If no package file can be found or if strict mode is enabled and normalize warnings are thrown.
-*/
-declare const findPackageJson: (cwd?: URL | string, options?: ReadOptions) => Promise<NormalizedReadResult>;
-/**
-* A synchronous function to find the package.json, package.yaml, or package.json5 file in the specified directory or its parent directories.
-* @param cwd The current working directory.
-* @param options Configuration options including yaml, json5, and resolveCatalogs flags.
-* @returns An object containing the parsed package data and the file path.
-* @throws {Error} If no package file can be found or if strict mode is enabled and normalize warnings are thrown.
-*/
-declare const findPackageJsonSync: (cwd?: URL | string, options?: ReadOptions) => NormalizedReadResult;
-/**
-* An asynchronous function to write the package.json file with the given data.
-* @param data The package.json data to write. The data is an intersection type of `PackageJson` and a record where keys are `string` and values can be any type.
-* @param options Optional. The options for writing the package.json. If not provided, an empty object will be used `{}`.
-* This is an intersection type of `WriteJsonOptions` and a record with an optional `cwd` key which type is `Options["cwd"]`.
-* `cwd` represents the current working directory. If not specified, the default working directory will be used.
-* @returns A `Promise` that resolves once the package.json file has been written. The type of the returned promise is `Promise&lt;void>`.
-*/
-declare const writePackageJson: (data: PackageJson, options?: WriteJsonOptions & {
-  cwd?: URL | string;
-}) => Promise<void>;
-declare const writePackageJsonSync: (data: PackageJson, options?: WriteJsonOptions & {
-  cwd?: URL | string;
-}) => void;
-/**
-* Clears the module-level package.json file and parse caches.
-*
-* The caches populated by `findPackageJson[Sync]` / `parsePackageJson[Sync]` when
-* `cache: true` (and no custom cache is supplied) never expire on their own. Call this
-* to drop all cached reads — for example in long-running processes or tests that mutate
-* package files out of band.
-*/
-declare const clearPackageJsonCache: () => void;
-/**
-* A synchronous function to parse the package.json, package.yaml, or package.json5 file/object/string and return normalize the data.
-* @param packageFile
-* @param options
-* @param options.cache Cache for parsed results (only applies to file paths)
-* @param options.ignoreWarnings List of warning messages or patterns to skip in strict mode
-* @param options.resolveCatalogs Whether to resolve pnpm catalog references
-* @param options.strict Whether to throw errors on normalization warnings
-* @param options.yaml Whether to enable package.yaml parsing (default: true)
-* @param options.json5 Whether to enable package.json5 parsing (default: true)
-* @returns
-* @throws {Error} If the packageFile parameter is not an object or a string or if strict mode is enabled and normalize warnings are thrown.
-*/
-declare const parsePackageJsonSync: (packageFile: JsonObject | string, options?: {
-  cache?: Cache<NormalizedPackageJson> | boolean;
-  ignoreWarnings?: (RegExp | string)[];
-  json5?: boolean;
-  resolveCatalogs?: boolean;
-  strict?: boolean;
-  yaml?: boolean;
-}) => NormalizedPackageJson;
-/**
-* An asynchronous function to parse the package.json, package.yaml, or package.json5 file/object/string and return normalize the data.
-* @param packageFile
-* @param options
-* @param options.cache Cache for parsed results (only applies to file paths)
-* @param options.ignoreWarnings List of warning messages or patterns to skip in strict mode
-* @param options.strict Whether to throw errors on normalization warnings
-* @param options.resolveCatalogs Whether to resolve pnpm catalog references
-* @param options.yaml Whether to enable package.yaml parsing (default: true)
-* @param options.json5 Whether to enable package.json5 parsing (default: true)
-* @returns
-* @throws {Error} If the packageFile parameter is not an object or a string or if strict mode is enabled and normalize warnings are thrown.
-*/
-declare const parsePackageJson: (packageFile: JsonObject | string, options?: {
-  cache?: Cache<NormalizedPackageJson> | boolean;
-  ignoreWarnings?: (RegExp | string)[];
-  json5?: boolean;
-  resolveCatalogs?: boolean;
-  strict?: boolean;
-  yaml?: boolean;
-}) => Promise<NormalizedPackageJson>;
-/**
-* An asynchronous function to get the value of a property from the package.json file.
-* @param packageJson
-* @param property
-* @param defaultValue
-* @returns
-*/
-declare const getPackageJsonProperty: <T = unknown>(packageJson: NormalizedPackageJson, property: Paths<NormalizedPackageJson>, defaultValue?: T) => T;
-/**
-* An asynchronous function to check if a property exists in the package.json file.
-* @param packageJson
-* @param property
-* @returns
-*/
-declare const hasPackageJsonProperty: (packageJson: NormalizedPackageJson, property: Paths<NormalizedPackageJson>) => boolean;
-/**
-* An asynchronous function to check if any of the specified dependencies exist in the package.json file.
-* @param packageJson
-* @param arguments_
-* @param options
-* @param options.peerDeps Whether to include peer dependencies
-* @returns
-*/
-declare const hasPackageJsonAnyDependency: (packageJson: NormalizedPackageJson, arguments_: string[], options?: {
-  peerDeps?: boolean;
-}) => boolean;
-/**
-* An asynchronous function to ensure that the specified packages are installed in the package.json file.
-* If the packages are not installed, the user will be prompted to install them.
-* If the user agrees, the packages will be installed.
-* If the user declines, the function will return without installing the packages.
-* If the user does not respond, the function will return without installing the packages.
-* @param packageJson
-* @param packages
-* @param installKey
-* @param options
-* @param options.deps Whether to include regular dependencies
-* @param options.devDeps Whether to include development dependencies
-* @param options.peerDeps Whether to include peer dependencies
-* @param options.throwOnWarn Whether to throw an error when warnings are logged instead of just logging them
-* @param options.logger Whether to use a custom logger
-* @param options.confirm Whether to use a custom confirmation prompt
-* @param options.installPackage Whether to use a custom installation package
-* @param options.cwd Whether to use a custom current working directory
-* @param options.dev Whether to use a custom installation key
-* @returns
-*/
-declare const ensurePackages: (packageJson: NormalizedPackageJson, packages: string[], installKey?: "dependencies" | "devDependencies", options?: EnsurePackagesOptions) => Promise<void>;
-export { EnsurePackagesOptions as E, FindPackageJsonCache as F, NormalizedPackageJson as N, PackageJson as P, NormalizedReadResult as a, findPackageJsonSync as b, clearPackageJsonCache as c, hasPackageJsonProperty as d, ensurePackages as e, findPackageJson as f, getPackageJsonProperty as g, hasPackageJsonAnyDependency as h, parsePackageJsonSync as i, writePackageJsonSync as j, parsePackageJson as p, writePackageJson as w };