@visulima/package 5.0.0-alpha.9 → 5.0.0

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export { default as PackageNotFoundError } from "./error/package-not-found-error.d.ts";
-export type { LockFileEntry, LockFileIntegrity, LockFileIntegrityAlgorithm, LockFileParseResult, LockFileType } from "./lockfile.d.ts";
-export { decodeSriIntegrity, parseBunLockFile, parseLockFile, parseLockFileContent, parseLockFileSync, parseNpmLockFile, parsePnpmLockFile, parseYarnLockFile, } from "./lockfile.d.ts";
-export type { RootMonorepo, Strategy } from "./monorepo.d.ts";
-export { findMonorepoRoot, findMonorepoRootSync } from "./monorepo.d.ts";
-export { findPackageRoot, findPackageRootSync } from "./package.d.ts";
-export type { FindPackageJsonCache, NormalizedReadResult } from "./package-json.d.ts";
-export { ensurePackages, findPackageJson, findPackageJsonSync, getPackageJsonProperty, hasPackageJsonAnyDependency, hasPackageJsonProperty, parsePackageJson, parsePackageJsonSync, writePackageJson, writePackageJsonSync, } from "./package-json.d.ts";
-export type { PackageManager, PackageManagerResult } from "./package-manager.d.ts";
-export { findLockFile, findLockFileSync, findPackageManager, findPackageManagerSync, generateMissingPackagesInstallMessage, getPackageManagerVersion, identifyInitiatingPackageManager, } from "./package-manager.d.ts";
-export type { PnpmCatalog, PnpmCatalogs } from "./pnpm.d.ts";
-export { isPackageInWorkspace, readPnpmCatalogs, readPnpmCatalogsSync, resolveCatalogReference, resolveCatalogReferences, resolveDependenciesCatalogReferences, } from "./pnpm.d.ts";
-export type { EnsurePackagesOptions, NormalizedPackageJson, PackageJson } from "./types.d.ts";
+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 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';
+import 'type-fest';
+import '@antfu/install-pkg';
+import '@inquirer/core';
+import '@inquirer/type';
+import 'normalize-package-data';

package/dist/index.js

@@ -1,7 +1 @@
-export { default as PackageNotFoundError } from './packem_shared/PackageNotFoundError-C0ltLzw7.js';
-export { decodeSriIntegrity, parseBunLockFile, parseLockFile, parseLockFileContent, parseLockFileSync, parseNpmLockFile, parsePnpmLockFile, parseYarnLockFile } from './lockfile.js';
-export { findMonorepoRoot, findMonorepoRootSync } from './monorepo.js';
-export { findPackageRoot, findPackageRootSync } from './package.js';
-export { ensurePackages, findPackageJson, findPackageJsonSync, getPackageJsonProperty, hasPackageJsonAnyDependency, hasPackageJsonProperty, parsePackageJson, parsePackageJsonSync, writePackageJson, writePackageJsonSync } from './package-json.js';
-export { findLockFile, findLockFileSync, findPackageManager, findPackageManagerSync, generateMissingPackagesInstallMessage, getPackageManagerVersion, identifyInitiatingPackageManager } from './package-manager.js';
-export { isPackageInWorkspace, readPnpmCatalogs, readPnpmCatalogsSync, resolveCatalogReference, resolveCatalogReferences, resolveDependenciesCatalogReferences } from './pnpm.js';
+import{default as o}from"./packem_shared/PackageNotFoundError-Bi41exhP.js";import{decodeSriIntegrity as r,parseBunLockFile as c,parseLockFile as s,parseLockFileContent as g,parseLockFileSync as i,parseNpmLockFile as t,parsePnpmLockFile as k,parseYarnLockFile as p}from"./lockfile.js";import{findMonorepoRoot as f,findMonorepoRootSync as l}from"./monorepo.js";import{findPackageRoot as y,findPackageRootSync as m}from"./package.js";import{clearPackageJsonCache as J,ensurePackages as S,findPackageJson as L,findPackageJsonSync as M,getPackageJsonProperty as x,hasPackageJsonAnyDependency as C,hasPackageJsonProperty as R,parsePackageJson as u,parsePackageJsonSync as I,writePackageJson as h,writePackageJsonSync as v}from"./package-json.js";import{findLockFile as D,findLockFileSync as N,findPackageManager as A,findPackageManagerSync as B,generateMissingPackagesInstallMessage as E,getPackageManagerVersion as V,identifyInitiatingPackageManager as W}from"./package-manager.js";import{isPackageInWorkspace as b,readPnpmCatalogs as j,readPnpmCatalogsSync as q,resolveCatalogReference as z,resolveCatalogReferences as G,resolveDependenciesCatalogReferences as H}from"./pnpm.js";export{o as PackageNotFoundError,J as clearPackageJsonCache,r as decodeSriIntegrity,S as ensurePackages,D as findLockFile,N as findLockFileSync,f as findMonorepoRoot,l as findMonorepoRootSync,L as findPackageJson,M as findPackageJsonSync,A as findPackageManager,B as findPackageManagerSync,y as findPackageRoot,m as findPackageRootSync,E as generateMissingPackagesInstallMessage,x as getPackageJsonProperty,V as getPackageManagerVersion,C as hasPackageJsonAnyDependency,R as hasPackageJsonProperty,W as identifyInitiatingPackageManager,b as isPackageInWorkspace,c as parseBunLockFile,s as parseLockFile,g as parseLockFileContent,i as parseLockFileSync,t as parseNpmLockFile,u as parsePackageJson,I as parsePackageJsonSync,k as parsePnpmLockFile,p as parseYarnLockFile,j as readPnpmCatalogs,q as readPnpmCatalogsSync,z as resolveCatalogReference,G as resolveCatalogReferences,H as resolveDependenciesCatalogReferences,h as writePackageJson,v as writePackageJsonSync};

package/dist/lockfile.d.ts

@@ -1,113 +1,120 @@
-/** Lockfiles the parser recognises. Legacy binary `bun.lockb` is unsupported. */
-export type LockFileType = "bun" | "npm" | "pnpm" | "yarn";
+/**
+* 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. */
-export type LockFileIntegrityAlgorithm = "sha256" | "sha384" | "sha512";
+type LockFileIntegrityAlgorithm = "sha256" | "sha384" | "sha512";
 /** Decoded integrity digest: algorithm + lowercase hex string. */
-export interface LockFileIntegrity {
-    algorithm: LockFileIntegrityAlgorithm;
-    hex: string;
+interface LockFileIntegrity {
+  algorithm: LockFileIntegrityAlgorithm;
+  hex: string;
 }
 /** A single resolved package extracted from a lockfile. */
-export 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.
-     */
-    dependencies?: Record<string, string[]>;
-    /** Decoded SRI digest, if the lockfile recorded one. */
-    integrity?: LockFileIntegrity;
-    /** Package name — `lodash` or `@scope/name`. */
-    name: string;
-    /** Declared optional dependencies, same shape as `dependencies`. */
-    optionalDependencies?: Record<string, string[]>;
-    /** Declared peer dependencies, same shape as `dependencies`. */
-    peerDependencies?: Record<string, string[]>;
-    /** Resolved exact version — e.g. `4.17.21`. */
-    version: string;
+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.
+  */
+  dependencies?: Record<string, string[]>;
+  /** Decoded SRI digest, if the lockfile recorded one. */
+  integrity?: LockFileIntegrity;
+  /** Package name — `lodash` or `@scope/name`. */
+  name: string;
+  /** Declared optional dependencies, same shape as `dependencies`. */
+  optionalDependencies?: Record<string, string[]>;
+  /** Declared peer dependencies, same shape as `dependencies`. */
+  peerDependencies?: Record<string, string[]>;
+  /** Resolved exact version — e.g. `4.17.21`. */
+  version: string;
 }
 /** Result of locating + parsing a lockfile on disk. */
-export interface LockFileParseResult {
-    entries: LockFileEntry[];
-    /** Absolute path of the lockfile that was parsed. */
-    path: string;
-    type: LockFileType;
+interface LockFileParseResult {
+  entries: LockFileEntry[];
+  /** Absolute path of the lockfile that was parsed. */
+  path: string;
+  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.
- */
-export declare const decodeSriIntegrity: (sri: string) => LockFileIntegrity | undefined;
+* 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`.
- */
-export declare const parseNpmLockFile: (content: string) => LockFileEntry[];
+* 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`.
- */
-export declare const parsePnpmLockFile: (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`.
+*/
+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`.
- */
-export declare const parseYarnLockFile: (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`.
+*/
+declare const parseYarnLockFile: (content: string) => LockFileEntry[];
 /**
- * Parses `bun.lock` (Bun v1.1+, JSON-ish with trailing commas). The
- * binary `bun.lockb` format is not supported.
- *
- * 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`.
- */
-export declare const parseBunLockFile: (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`.
+*/
+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`.
- */
-export declare const parseLockFileContent: (content: string, type: LockFileType) => 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`.
+*/
+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`.
- */
-export declare const parseLockFile: (cwd?: URL | string) => Promise<LockFileParseResult>;
+* 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`.
- */
-export declare const parseLockFileSync: (cwd?: URL | string) => 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`.
+*/
+declare const parseLockFileSync: (cwd?: URL | string) => LockFileParseResult;
+export { LockFileEntry, LockFileIntegrity, LockFileIntegrityAlgorithm, LockFileParseResult, LockFileType, decodeSriIntegrity, parseBunLockFile, parseLockFile, parseLockFileContent, parseLockFileSync, parseNpmLockFile, parsePnpmLockFile, parseYarnLockFile };