@visulima/package 5.0.0-alpha.11 → 5.0.0-alpha.13

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+## @visulima/package [5.0.0-alpha.13](https://github.com/visulima/visulima/compare/@visulima/package@5.0.0-alpha.12...@visulima/package@5.0.0-alpha.13) (2026-05-06)
+
+### Miscellaneous Chores
+
+* **package:** apply prettier and eslint quote-style auto-fix ([0316bca](https://github.com/visulima/visulima/commit/0316bca0deca444ff12675bc760c7091ce243d31))
+* **package:** housekeeping cleanup ([113978b](https://github.com/visulima/visulima/commit/113978b0babcfc7879514aec076f6e2d5e7afab0))
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.0-alpha.14
+
+## @visulima/package [5.0.0-alpha.12](https://github.com/visulima/visulima/compare/@visulima/package@5.0.0-alpha.11...@visulima/package@5.0.0-alpha.12) (2026-05-04)
+
+### Miscellaneous Chores
+
+* **package:** upgrade packem to 2.0.0-alpha.76 ([b2ef62b](https://github.com/visulima/visulima/commit/b2ef62b72a84545cb025a250cbe7e3e36b34330d))
+* re-sort workspace package.json files via vis sort-package-json ([f625696](https://github.com/visulima/visulima/commit/f625696cfac974325774b3243e1a83c3d23acbd7))
+* simplify pnpm-workspace packages list ([7cab221](https://github.com/visulima/visulima/commit/7cab221163632d9b7aa044a6f88c49083103a869))
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.0-alpha.13
+
 ## @visulima/package [5.0.0-alpha.11](https://github.com/visulima/visulima/compare/@visulima/package@5.0.0-alpha.10...@visulima/package@5.0.0-alpha.11) (2026-04-22)
 
 ### Bug Fixes

package/dist/error.d.ts

@@ -1 +1,15 @@
-export { default as PackageNotFoundError } from "./error/package-not-found-error.d.ts";
+/**
+* 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.
+  */
+  constructor(packageName: string[] | string, packageManager?: string);
+  get code(): string;
+  set code(_name: string);
+  override get name(): string;
+  override set name(_name: string);
+}
+export { PackageNotFoundError };

package/dist/error.js

@@ -1 +1 @@
-export { default as PackageNotFoundError } from './packem_shared/PackageNotFoundError-C0ltLzw7.js';
+import{default as a}from"./packem_shared/PackageNotFoundError--qHnCLzN.js";export{a as PackageNotFoundError};

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, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, c as hasPackageJsonProperty, p as parsePackageJson, d as parsePackageJsonSync, w as writePackageJson, i as writePackageJsonSync } from "./packem_shared/package-json.d-R9WIRfmM.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--qHnCLzN.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{ensurePackages as S,findPackageJson as J,findPackageJsonSync as L,getPackageJsonProperty as M,hasPackageJsonAnyDependency as x,hasPackageJsonProperty as R,parsePackageJson as C,parsePackageJsonSync as u,writePackageJson as I,writePackageJsonSync as v}from"./package-json.js";import{findLockFile as w,findLockFileSync as D,findPackageManager as N,findPackageManagerSync as A,generateMissingPackagesInstallMessage as B,getPackageManagerVersion as E,identifyInitiatingPackageManager as V}from"./package-manager.js";import{isPackageInWorkspace as Y,readPnpmCatalogs as b,readPnpmCatalogsSync as j,resolveCatalogReference as q,resolveCatalogReferences as z,resolveDependenciesCatalogReferences as G}from"./pnpm.js";export{o as PackageNotFoundError,r as decodeSriIntegrity,S as ensurePackages,w as findLockFile,D as findLockFileSync,f as findMonorepoRoot,l as findMonorepoRootSync,J as findPackageJson,L as findPackageJsonSync,N as findPackageManager,A as findPackageManagerSync,y as findPackageRoot,m as findPackageRootSync,B as generateMissingPackagesInstallMessage,M as getPackageJsonProperty,E as getPackageManagerVersion,x as hasPackageJsonAnyDependency,R as hasPackageJsonProperty,V as identifyInitiatingPackageManager,Y as isPackageInWorkspace,c as parseBunLockFile,s as parseLockFile,g as parseLockFileContent,i as parseLockFileSync,t as parseNpmLockFile,C as parsePackageJson,u as parsePackageJsonSync,k as parsePnpmLockFile,p as parseYarnLockFile,b as readPnpmCatalogs,j as readPnpmCatalogsSync,q as resolveCatalogReference,z as resolveCatalogReferences,G as resolveDependenciesCatalogReferences,I as writePackageJson,v as writePackageJsonSync};

package/dist/lockfile.d.ts

@@ -1,113 +1,114 @@
 /** Lockfiles the parser recognises. Legacy binary `bun.lockb` is unsupported. */
-export type LockFileType = "bun" | "npm" | "pnpm" | "yarn";
+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
+* 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`.
+*/
+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 };