@visulima/package 3.6.0 → 4.0.0

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## @visulima/package [4.0.0](https://github.com/visulima/visulima/compare/@visulima/package@3.6.1...@visulima/package@4.0.0) (2025-10-02)
+
+### ⚠ BREAKING CHANGES
+
+* **package:** - parsePackageJson is now async and returns Promise<NormalizedPackageJson>
+- Removed CommonJS exports - package is now ESM-only
+- All functions must be awaited when upgrading from v3.x
+
+### Features
+
+* **package:** add pnpm catalog protocol support with breaking changes ([#529](https://github.com/visulima/visulima/issues/529)) ([76e72bd](https://github.com/visulima/visulima/commit/76e72bdb40192f271837e90acca026ef1eb79907))
+
+## @visulima/package [3.6.1](https://github.com/visulima/visulima/compare/@visulima/package@3.6.0...@visulima/package@3.6.1) (2025-10-01)
+
+### Bug Fixes
+
+* update package dependencies and remove ESLint configuration files ([f964ad7](https://github.com/visulima/visulima/commit/f964ad7d7e6e27da19b8b9b283552336192fd596))
+
+### Miscellaneous Chores
+
+* update LICENSE and package.json for consistency ([c2d6ad4](https://github.com/visulima/visulima/commit/c2d6ad41322581639f37c6c648919fba2986211e))
+
 ## @visulima/package [3.6.0](https://github.com/visulima/visulima/compare/@visulima/package@3.5.12...@visulima/package@3.6.0) (2025-09-30)
 
 ### Features

package/LICENSE.md

@@ -27,35 +27,6 @@ The published @visulima/package artifact additionally contains code with the fol
 MIT
 
 # Bundled dependencies:
-## @antfu/install-pkg
-License: MIT
-By: Anthony Fu
-Repository: git+https://github.com/antfu/install-pkg.git
-
-> MIT License
->
-> Copyright (c) 2021 Anthony Fu <https://github.com/antfu>
->
-> Permission is hereby granted, free of charge, to any person obtaining a copy
-> of this software and associated documentation files (the "Software"), to deal
-> in the Software without restriction, including without limitation the rights
-> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> copies of the Software, and to permit persons to whom the Software is
-> furnished to do so, subject to the following conditions:
->
-> The above copyright notice and this permission notice shall be included in all
-> copies or substantial portions of the Software.
->
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-> SOFTWARE.
-
----------------------------------------
-
 ## dot-prop
 License: MIT
 By: Sindre Sorhus
@@ -71,64 +42,6 @@ Repository: sindresorhus/dot-prop
 >
 > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
----------------------------------------
-
-## package-manager-detector
-License: MIT
-By: Anthony Fu
-Repository: git+https://github.com/antfu-collective/package-manager-detector.git
-
-> MIT License
->
-> Copyright (c) 2020-PRESENT Anthony Fu <https://github.com/antfu>
->
-> Permission is hereby granted, free of charge, to any person obtaining a copy
-> of this software and associated documentation files (the "Software"), to deal
-> in the Software without restriction, including without limitation the rights
-> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> copies of the Software, and to permit persons to whom the Software is
-> furnished to do so, subject to the following conditions:
->
-> The above copyright notice and this permission notice shall be included in all
-> copies or substantial portions of the Software.
->
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-> SOFTWARE.
-
----------------------------------------
-
-## tinyexec
-License: MIT
-By: James Garbutt
-Repository: git+https://github.com/tinylibs/tinyexec.git
-
-> MIT License
->
-> Copyright (c) 2024 Tinylibs
->
-> Permission is hereby granted, free of charge, to any person obtaining a copy
-> of this software and associated documentation files (the "Software"), to deal
-> in the Software without restriction, including without limitation the rights
-> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> copies of the Software, and to permit persons to whom the Software is
-> furnished to do so, subject to the following conditions:
->
-> The above copyright notice and this permission notice shall be included in all
-> copies or substantial portions of the Software.
->
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-> SOFTWARE.
-
 <!-- /DEPENDENCIES -->
 
 <!-- TYPE_DEPENDENCIES -->
@@ -138,35 +51,6 @@ The published @visulima/package artifact additionally contains code with the fol
 MIT, (MIT OR CC0-1.0)
 
 # Bundled types:
-## @antfu/install-pkg
-License: MIT
-By: Anthony Fu
-Repository: git+https://github.com/antfu/install-pkg.git
-
-> MIT License
->
-> Copyright (c) 2021 Anthony Fu <https://github.com/antfu>
->
-> Permission is hereby granted, free of charge, to any person obtaining a copy
-> of this software and associated documentation files (the "Software"), to deal
-> in the Software without restriction, including without limitation the rights
-> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-> copies of the Software, and to permit persons to whom the Software is
-> furnished to do so, subject to the following conditions:
->
-> The above copyright notice and this permission notice shall be included in all
-> copies or substantial portions of the Software.
->
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-> SOFTWARE.
-
----------------------------------------
-
 ## @inquirer/core
 License: MIT
 By: Simon Boudrias

package/README.md

@@ -1,12 +1,14 @@
 <div align="center">
   <h3>Visulima package</h3>
   <p>
-  One Package to rule them all, finds your root-dir, monorepo or package manager is built on top of
+  A comprehensive package management utility that helps you find root directories, monorepos, package managers, and parse package.json files with advanced features like catalog resolution.
+
+Built on top of
 
 [@visulima/fs](https://github.com/visulima/visulima/tree/main/packages/fs),
 [@visulima/path](https://github.com/visulima/visulima/tree/main/packages/path),
 [normalize-package-data](https://github.com/npm/normalize-package-data),
-[pathe](https://github.com/unjs/pathe),and
+[pathe](https://github.com/unjs/pathe), and
 [type-fest](https://github.com/sindresorhus/type-fest)
 
   </p>
@@ -34,109 +36,209 @@
 
 ## Install
 
-```sh
+```bash
 npm install @visulima/package
 ```
 
-```sh
+```bash
 yarn add @visulima/package
 ```
 
-```sh
+```bash
 pnpm add @visulima/package
 ```
 
-## Usage
+## API
+
+### Monorepo Detection
 
-### findMonorepoRoot
+#### findMonorepoRoot
 
-Find the root directory path and strategy for a monorepo based on the given current working directory (cwd).
+Finds the root directory and strategy for a monorepo by searching for workspace configuration files.
 
-```ts
+```typescript
 import { findMonorepoRoot } from "@visulima/package";
-// or import { findMonorepoRoot } from '@visulima/package/monorepo';
 
-const root = findMonorepoRoot(); // => /Users/../Projects/visulima
+const result = await findMonorepoRoot();
+// => { path: '/path/to/monorepo', strategy: 'pnpm' }
 ```
 
-### findPackageRoot
+Supports detection of:
+
+- pnpm workspaces (pnpm-workspace.yaml)
+- npm/yarn workspaces (package.json workspaces field)
+- Lerna (lerna.json)
+- Turborepo (turbo.json)
 
-Find the root directory path and strategy for a package based on the given current working directory (cwd).
+### Package Detection
 
-```ts
+#### findPackageRoot
+
+Finds the root directory of a package by locating its package.json file.
+
+```typescript
 import { findPackageRoot } from "@visulima/package";
-// or import { findPackageRoot } from '@visulima/package/package';
 
-const root = findPackageRoot(); // => /Users/../Projects/visulima/packages/package
+const result = await findPackageRoot();
+// => { path: '/path/to/package', strategy: 'package' }
 ```
 
-### findPackageJson
+#### findPackageJson
 
-Find the package.json file in the specified directory or its parent directories.
+Finds and parses a package.json file, searching parent directories if needed.
 
-```ts
+```typescript
 import { findPackageJson } from "@visulima/package";
-// or import { findPackageJson } from '@visulima/package/package-json';
 
-const root = findPackageJson(); // => /Users/../Projects/visulima/packages/package/package.json
+const result = await findPackageJson();
+// => { packageJson: { name: 'my-package', ... }, path: '/path/to/package.json' }
 ```
 
-### writePackageJson
+### Package Manager Detection
 
-Writes the package.json file with the given data.
+#### findPackageManager
 
-```ts
-import { writePackageJson } from "@visulima/package";
-// or import { writePackageJson } from '@visulima/package/package-json';
+Detects the package manager used in a project by examining lock files and package.json.
 
-writePackageJson({ name: "visulima" } /* ,{ cwd: "./" }*/);
+```typescript
+import { findPackageManager } from "@visulima/package";
+
+const result = await findPackageManager();
+// => { packageManager: 'pnpm', path: '/path/to/project' }
 ```
 
-### parsePackageJson
+#### findLockFile
+
+Finds the lock file for the current project.
+
+```typescript
+import { findLockFile } from "@visulima/package";
+
+const lockFile = await findLockFile();
+// => '/path/to/pnpm-lock.yaml'
+```
+
+#### getPackageManagerVersion
+
+Retrieves the version of a specific package manager.
+
+```typescript
+import { getPackageManagerVersion } from "@visulima/package";
+
+const version = await getPackageManagerVersion("pnpm");
+// => '8.15.0'
+```
+
+### Package.json Operations
+
+#### parsePackageJson
 
-Parse the package.json file.
+Parses and normalizes package.json data with optional catalog resolution support.
 
-```ts
+```typescript
 import { parsePackageJson } from "@visulima/package";
 
-const packageJson = parsePackageJson(/* object or package.json as string */);
+// Basic parsing
+const packageJson = await parsePackageJson("./package.json");
+
+// With catalog resolution (pnpm workspaces only)
+const packageJson = await parsePackageJson("./package.json", {
+    resolveCatalogs: true,
+});
+
+// Synchronous version
+import { parsePackageJsonSync } from "@visulima/package";
+
+const packageJson = parsePackageJsonSync("./package.json", {
+    resolveCatalogs: true,
+});
 ```
 
-### findLockFile
+**Catalog Resolution**: When `resolveCatalogs: true` is set, the function will:
 
-Asynchronously finds a lock file in the specified directory or any of its parent directories.
+1. Search for `pnpm-workspace.yaml` in parent directories
+2. Verify the package.json is part of the workspace
+3. Resolve catalog references like `"react": "catalog:"` to actual versions
 
-```ts
-import { findLockFile } from "@visulima/package";
-// or import { findLockFile } from '@visulima/package/package-manager';
+Example with pnpm catalogs:
+
+```yaml
+# pnpm-workspace.yaml
+catalog:
+    react: ^18.0.0
+    typescript: ^5.0.0
 
-const lockFile = await findLockFile(); // => /Users/../Projects/visulima/packages/package/package-lock.json
+catalogs:
+    next:
+        react: ^19.0.0
+
+packages:
+    - packages/*
 ```
 
-### findPackageManager
+```json
+// package.json
+{
+    "dependencies": {
+        "react": "catalog:",
+        "typescript": "catalog:",
+        "next": "catalog:next"
+    }
+}
+```
 
-Finds the package manager used in a project based on the presence of lock files or package.json configuration.
+After resolution:
 
-If found, returns the package manager and the path to the lock file or package.json.
+```json
+{
+    "dependencies": {
+        "react": "^18.0.0",
+        "typescript": "^5.0.0",
+        "next": "^19.0.0"
+    }
+}
+```
 
-Throws an error if no lock file or package.json is found.
+#### writePackageJson
 
-```ts
-import { findPackageManager } from "@visulima/package";
-// or import { findPackageManager } from '@visulima/package/package-manager';
+Writes normalized package.json data to a file.
+
+```typescript
+import { writePackageJson } from "@visulima/package";
 
-const { packageManager, path } = findPackageManager(); // => { packageManager: 'npm', path: '/Users/../Projects/visulima/packages/package' }
+await writePackageJson({
+    name: "my-package",
+    version: "1.0.0",
+});
 ```
 
-### getPackageManagerVersion
+#### Package.json Utilities
 
-Retrieves the version of the specified package manager.
+```typescript
+import { getPackageJsonProperty, hasPackageJsonProperty, hasPackageJsonAnyDependency } from "@visulima/package";
 
-```ts
-import { getPackageManagerVersion } from "@visulima/package";
-// or import { getPackageManagerVersion } from '@visulima/package/package-manager';
+const packageJson = await parsePackageJson("./package.json");
+
+// Get a property value
+const name = getPackageJsonProperty(packageJson, "name");
+
+// Check if property exists
+const hasScripts = hasPackageJsonProperty(packageJson, "scripts");
+
+// Check for dependencies
+const hasReact = hasPackageJsonAnyDependency(packageJson, ["react", "preact"]);
+```
+
+### Package Installation
+
+#### ensurePackages
+
+Ensures specified packages are installed, prompting the user if needed.
+
+```typescript
+import { ensurePackages } from "@visulima/package";
 
-const version = await getPackageManagerVersion("npm"); // => 7.5.4
+await ensurePackages(packageJson, ["typescript", "@types/node"], "devDependencies");
 ```
 
 ## Supported Node.js Versions

package/dist/error.js

@@ -0,0 +1 @@
+import{default as a}from"./packem_shared/PackageNotFoundError-BictYTIA.js";export{a as PackageNotFoundError};

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export { PackageNotFoundError } from './error.js';
 export { RootMonorepo, Strategy, findMonorepoRoot, findMonorepoRootSync } from './monorepo.js';
 export { findPackageRoot, findPackageRootSync } from './package.js';
-export { E as EnsurePackagesOptions, F as FindPackageJsonCache, d as NormalizedPackageJson, N as NormalizedReadResult, P as PackageJson, e as ensurePackages, f as findPackageJson, a as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, b as hasPackageJsonProperty, p as parsePackageJson, w as writePackageJson, c as writePackageJsonSync } from './packem_shared/package-json-KA2fTML0.js';
+export { E as EnsurePackagesOptions, F as FindPackageJsonCache, d as NormalizedPackageJson, N as NormalizedReadResult, P as PackageJson, e as ensurePackages, f as findPackageJson, a as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, b as hasPackageJsonProperty, p as parsePackageJson, w as writePackageJson, c as writePackageJsonSync } from './packem_shared/package-json-k3TJ_oy7.js';
 export { PackageManager, PackageManagerResult, findLockFile, findLockFileSync, findPackageManager, findPackageManagerSync, generateMissingPackagesInstallMessage, getPackageManagerVersion, identifyInitiatingPackageManager } from './package-manager.js';
 import '@visulima/fs';
+import './packem_shared/json-value.d-DU4PzU4Z.js';
+import '@antfu/install-pkg';
 import 'normalize-package-data';

package/dist/index.js

@@ -0,0 +1 @@
+import{default as n}from"./packem_shared/PackageNotFoundError-BictYTIA.js";import{findMonorepoRoot as r,findMonorepoRootSync as g}from"./monorepo.js";import{findPackageRoot as i,findPackageRootSync as t}from"./package.js";import{ensurePackages as k,findPackageJson as P,findPackageJsonSync as f,getPackageJsonProperty as d,hasPackageJsonAnyDependency as p,hasPackageJsonProperty as y,parsePackageJson as J,writePackageJson as M,writePackageJsonSync as S}from"./package-json.js";import{findLockFile as m,findLockFileSync as x,findPackageManager as R,findPackageManagerSync as u,generateMissingPackagesInstallMessage as F,getPackageManagerVersion as h,identifyInitiatingPackageManager as w}from"./package-manager.js";export{n as PackageNotFoundError,k as ensurePackages,m as findLockFile,x as findLockFileSync,r as findMonorepoRoot,g as findMonorepoRootSync,P as findPackageJson,f as findPackageJsonSync,R as findPackageManager,u as findPackageManagerSync,i as findPackageRoot,t as findPackageRootSync,F as generateMissingPackagesInstallMessage,d as getPackageJsonProperty,h as getPackageManagerVersion,p as hasPackageJsonAnyDependency,y as hasPackageJsonProperty,w as identifyInitiatingPackageManager,J as parsePackageJson,M as writePackageJson,S as writePackageJsonSync};

package/dist/monorepo.js

@@ -0,0 +1 @@
+var m=Object.defineProperty;var c=(n,r)=>m(n,"name",{value:r,configurable:!0});import{findUp as l,readJson as y,findUpSync as g,readJsonSync as h}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{existsSync:p,readFileSync:i}=globalThis.process.getBuiltinModule("node:fs");var j=Object.defineProperty,d=c((n,r)=>j(n,"name",{value:r,configurable:!0}),"i");const v=d(async n=>{const r=await l(["lerna.json","turbo.json"],{type:"file",...n&&{cwd:n}});if(r?.endsWith("lerna.json")){const o=await y(r);if(o.useWorkspaces||o.packages)return{path:u(r),strategy:"lerna"}}const s=r?.endsWith("turbo.json");try{const{packageManager:o,path:e}=await w(n);if(["npm","yarn"].includes(o)){const t=a(e,"package.json");if(p(t)&&i(a(e,"package.json"),"utf8").includes("workspaces"))return{path:e,strategy:s?"turbo":o}}else if(o==="pnpm"){const t=a(e,"pnpm-workspace.yaml");if(p(t))return{path:e,strategy:s?"turbo":"pnpm"}}}catch(o){if(!(o instanceof f))throw o}throw new Error(`No monorepo root could be found upwards from the directory ${n} using lerna, yarn, pnpm, or npm as indicators.`)},"findMonorepoRoot"),E=d(n=>{const r=g(["lerna.json","turbo.json"],{type:"file",...n&&{cwd:n}});if(r?.endsWith("lerna.json")){const o=h(r);if(o.useWorkspaces||o.packages)return{path:u(r),strategy:"lerna"}}const s=r?.endsWith("turbo.json");try{const{packageManager:o,path:e}=k(n);if(["npm","yarn"].includes(o)){const t=a(e,"package.json");if(p(t)&&i(a(e,"package.json"),"utf8").includes("workspaces"))return{path:e,strategy:s?"turbo":o}}else if(o==="pnpm"){const t=a(e,"pnpm-workspace.yaml");if(p(t))return{path:e,strategy:s?"turbo":"pnpm"}}}catch(o){if(!(o instanceof f))throw o}throw new Error(`No monorepo root could be found upwards from the directory ${n} using lerna, yarn, pnpm, or npm as indicators.`)},"findMonorepoRootSync");export{v as findMonorepoRoot,E as findMonorepoRootSync};

package/dist/package-json.d.ts

@@ -1,3 +1,5 @@
 import '@visulima/fs';
-export { F as FindPackageJsonCache, N as NormalizedReadResult, e as ensurePackages, f as findPackageJson, a as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, b as hasPackageJsonProperty, p as parsePackageJson, w as writePackageJson, c as writePackageJsonSync } from './packem_shared/package-json-KA2fTML0.js';
+import './packem_shared/json-value.d-DU4PzU4Z.js';
+export { F as FindPackageJsonCache, N as NormalizedReadResult, e as ensurePackages, f as findPackageJson, a as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, b as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, c as writePackageJsonSync } from './packem_shared/package-json-k3TJ_oy7.js';
+import '@antfu/install-pkg';
 import 'normalize-package-data';

package/dist/package-json.js

@@ -0,0 +1,3 @@
+var _=Object.defineProperty;var i=(e,n)=>_(e,"name",{value:n,configurable:!0});import{installPackage as K}from"@antfu/install-pkg";import R from"@inquirer/confirm";import{readJsonSync as I,findUp as q,readJson as S,findUpSync as F,writeJson as M,writeJsonSync as V}from"@visulima/fs";import{NotFoundError as A}from"@visulima/fs/error";import{parseJson as D,toPath as x}from"@visulima/fs/utils";import{join as N}from"@visulima/path";import{readPnpmCatalogsSync as U,resolveCatalogReferences as O,readPnpmCatalogs as Y}from"./pnpm.js";const z=globalThis.process.getBuiltinModule("module").createRequire(import.meta.url),{existsSync:m}=globalThis.process.getBuiltinModule("node:fs"),B=z("normalize-package-data");var G=Object.defineProperty,f=i((e,n)=>G(e,"name",{value:n,configurable:!0}),"f");const u=f(e=>{const n=typeof e;return e!==null&&(n==="object"||n==="function")},"isObject"),H=f(e=>u(e)&&Object.keys(e).length===0,"isEmptyObject"),b=new Set(["__proto__","prototype","constructor"]),L=new Set("0123456789");function v(e){return typeof e=="string"&&/^\d+$/.test(e)&&Number.parseInt(e,10)>=0&&(e==="0"||!e.startsWith("0"))}i(v,"h");f(v,"isValidArrayIndex");function y(e,n,r){return r>0&&typeof e=="string"&&Array.isArray(n)&&v(e)?Number.parseInt(e,10):e}i(y,"u");f(y,"normalizeKey");function w(e){const n=[];let r="",t="start",o=!1;for(const a of e)switch(a){case"\\":{if(t==="index")throw new Error("Invalid character in an index");if(t==="indexEnd")throw new Error("Invalid character after an index");o&&(r+=a),t="property",o=!o;break}case".":{if(t==="index")throw new Error("Invalid character in an index");if(t==="indexEnd"){t="property";break}if(o){o=!1,r+=a;break}if(b.has(r))return[];n.push(r),r="",t="property";break}case"[":{if(t==="index")throw new Error("Invalid character in an index");if(t==="indexEnd"){t="index";break}if(o){o=!1,r+=a;break}if(t==="property"){if(b.has(r))return[];n.push(r),r=""}t="index";break}case"]":{if(t==="index"){n.push(Number.parseInt(r,10)),r="",t="indexEnd";break}if(t==="indexEnd")throw new Error("Invalid character after an index")}default:{if(t==="index"&&!L.has(a))throw new Error("Invalid character in an index");if(t==="indexEnd")throw new Error("Invalid character after an index");t==="start"&&(t="property"),o&&(o=!1,r+="\\"),r+=a}}switch(o&&(r+="\\"),t){case"property":{if(b.has(r))return[];n.push(r);break}case"index":throw new Error("Index was not closed");case"start":{n.push("");break}}return n}i(w,"l");f(w,"getPathSegments");function k(e,n){if(!Array.isArray(e)||typeof n=="number")return!1;const r=Number.parseInt(n,10);return Number.isInteger(r)&&String(r)===n}i(k,"c$1");f(k,"isStringIndex");function E(e,n){if(k(e,n))throw new Error("Cannot use string index")}i(E,"x");f(E,"assertNotStringIndex");function g(e,n,r){if(!u(e)||typeof n!="string")return r===void 0?e:r;const t=w(n);if(t.length===0)return r;for(let o=0;o<t.length;o++){const a=t[o],s=y(a,e,o);if(s===a&&k(e,a)?e=o===t.length-1?void 0:null:e=e[s],e==null){if(o!==t.length-1)return r;break}}return e===void 0?r:e}i(g,"getProperty");f(g,"getProperty");function $(e,n,r){if(!u(e)||typeof n!="string")return e;const t=e,o=w(n);for(let a=0;a<o.length;a++){const s=o[a],p=y(s,e,a);if(p===s&&E(e,s),a===o.length-1)e[p]=r;else if(!u(e[p])){const c=o[a+1],l=typeof c=="number"||typeof c=="string"&&v(c);e[p]=l?[]:{}}e=e[p]}return t}i($,"setProperty");f($,"setProperty");function Q(e,n){if(!u(e)||typeof n!="string")return!1;const r=w(n);for(let t=0;t<r.length;t++){const o=r[t],a=y(o,e,t);if(a===o&&E(e,o),t===r.length-1)return Object.hasOwn(e,a)?(delete e[a],!0):!1;if(e=e[a],!u(e))return!1}}i(Q,"deleteProperty");f(Q,"deleteProperty");function h(e,n){if(!u(e)||typeof n!="string")return!1;const r=w(n);if(r.length===0)return!1;for(const[t,o]of r.entries()){const a=y(o,e,t),s=a===o&&k(e,o);if(!u(e)||!(a in e)||s)return!1;e=e[a]}return!0}i(h,"hasProperty");f(h,"hasProperty");function C(e){if(typeof e!="string")throw new TypeError("Expected a string");return e.replaceAll(/[\\.[]/g,String.raw`\$&`)}i(C,"escapePath");f(C,"escapePath");function J(e){const n=Object.entries(e);return Array.isArray(e)?n.map(([r,t])=>[Number(r),t]):n}i(J,"g");f(J,"entries");function T(e){let n="";for(let[r,t]of J(e))typeof t=="number"?n+=`[${t}]`:(t=C(t),n+=r===0?t:`.${t}`);return n}i(T,"A");f(T,"stringifyPath");function*j(e,n=[]){if(!u(e)||H(e)){n.length>0&&(yield T(n));return}for(const[r,t]of J(e))yield*j(t,[...n,r])}i(j,"w");f(j,"deepKeysIterator");function X(e){return[...j(e)]}i(X,"deepKeys");f(X,"deepKeys");function Z(e){const n={};if(!u(e))return n;for(const[r,t]of Object.entries(e))$(n,r,t);return n}i(Z,"unflatten");f(Z,"unflatten");const ee=typeof process.stdout<"u"&&!process.versions.deno&&!globalThis.window;var ne=Object.defineProperty,d=i((e,n)=>ne(e,"name",{value:n,configurable:!0}),"c");const W=new Map;class te extends Error{static{i(this,"W")}static{d(this,"PackageJsonValidationError")}constructor(n){super(`The following warnings were encountered while normalizing package data:
+- ${n.join(`
+- `)}`),this.name="PackageJsonValidationError"}}const P=d((e,n,r=[])=>{const t=[];if(B(e,o=>{t.push(o)},n),n&&t.length>0){const o=t.filter(a=>!r.some(s=>s instanceof RegExp?s.test(a):s===a));if(o.length>0)throw new te(o)}return e},"normalizeInput"),le=d(async(e,n={})=>{const r={type:"file"};e&&(r.cwd=e);const t=await q("package.json",r);if(!t)throw new A("No such file or directory, for package.json found.");const o=n.cache&&typeof n.cache!="boolean"?n.cache:W;if(n.cache&&o.has(t))return o.get(t);const a=await S(t);P(a,n.strict??!1,n.ignoreWarnings);const s={packageJson:a,path:t};return o.set(t,s),s},"findPackageJson"),de=d((e,n={})=>{const r={type:"file"};e&&(r.cwd=e);const t=F("package.json",r);if(!t)throw new A("No such file or directory, for package.json found.");const o=n.cache&&typeof n.cache!="boolean"?n.cache:W;if(n.cache&&o.has(t))return o.get(t);const a=I(t);P(a,n.strict??!1,n.ignoreWarnings);const s={packageJson:a,path:t};return o.set(t,s),s},"findPackageJsonSync"),ue=d(async(e,n={})=>{const{cwd:r,...t}=n,o=x(n.cwd??process.cwd());await M(N(o,"package.json"),e,t)},"writePackageJson"),ge=d((e,n={})=>{const{cwd:r,...t}=n,o=x(n.cwd??process.cwd());V(N(o,"package.json"),e,t)},"writePackageJsonSync"),he=d((e,n)=>{const r=e!==null&&typeof e=="object"&&!Array.isArray(e),t=typeof e=="string";if(!r&&!t)throw new TypeError("`packageFile` should be either an `object` or a `string`.");let o;if(r?o=structuredClone(e):m(e)?o=I(e):o=D(e),n?.resolveCatalogs&&t&&m(e)){const a=U(e);a&&O(o,a)}return P(o,n?.strict??!1,n?.ignoreWarnings),o},"parsePackageJsonSync"),ye=d(async(e,n)=>{const r=e!==null&&typeof e=="object"&&!Array.isArray(e),t=typeof e=="string";if(!r&&!t)throw new TypeError("`packageFile` should be either an `object` or a `string`.");let o;if(r?o=structuredClone(e):m(e)?o=await S(e):o=D(e),n?.resolveCatalogs&&t&&m(e)){const a=await Y(e);a&&O(o,a)}return P(o,n?.strict??!1,n?.ignoreWarnings),o},"parsePackageJson"),we=d((e,n,r)=>g(e,n,r),"getPackageJsonProperty"),me=d((e,n)=>h(e,n),"hasPackageJsonProperty"),ke=d((e,n,r)=>{const t=g(e,"dependencies",{}),o=g(e,"devDependencies",{}),a=g(e,"peerDependencies",{}),s={...t,...o,...r?.peerDeps===!1?{}:a};for(const p of n)if(h(s,p))return!0;return!1},"hasPackageJsonAnyDependency"),Pe=d(async(e,n,r="dependencies",t={})=>{const o=g(e,"dependencies",{}),a=g(e,"devDependencies",{}),s=g(e,"peerDependencies",{}),p=[],c={deps:!0,devDeps:!0,peerDeps:!1,...t};for(const l of n)c.deps&&h(o,l)||c.devDeps&&h(a,l)||c.peerDeps&&h(s,l)||p.push(l);if(p.length!==0){if(process.env.CI||ee&&!process.stdout?.isTTY){const l=`Skipping package installation for [${n.join(", ")}] because the process is not interactive.`;if(t.throwOnWarn)throw new Error(l);t.logger?.warn?t.logger.warn(l):console.warn(l);return}if(typeof c.confirm?.message=="function"&&(c.confirm.message=c.confirm.message(p)),c.confirm?.message===void 0){const l=`${p.length===1?"Package is":"Packages are"} required for this config: ${p.join(", ")}. Do you want to install them?`;c.confirm===void 0?c.confirm={message:l}:c.confirm.message=l}await R(c.confirm)&&await K(p,{...c.installPackage,cwd:c.cwd?x(c.cwd):void 0,dev:r==="devDependencies"})}},"ensurePackages");export{Pe as ensurePackages,le as findPackageJson,de as findPackageJsonSync,we as getPackageJsonProperty,ke as hasPackageJsonAnyDependency,me as hasPackageJsonProperty,ye as parsePackageJson,he as parsePackageJsonSync,ue as writePackageJson,ge as writePackageJsonSync};

package/dist/package-manager.js

@@ -0,0 +1,13 @@
+var b=Object.defineProperty;var d=(n,a)=>b(n,"name",{value:a,configurable:!0});import{findUpSync as f,findUp as m}from"@visulima/fs";import{NotFoundError as c}from"@visulima/fs/error";import{join as p,dirname as t}from"@visulima/path";import{parsePackageJsonSync as u,parsePackageJson as j}from"./package-json.js";const{execSync:v}=globalThis.process.getBuiltinModule("node:child_process"),{existsSync:k,readFileSync:P}=globalThis.process.getBuiltinModule("node:fs");var W=Object.defineProperty,r=d((n,a)=>W(n,"name",{value:a,configurable:!0}),"t");const l=["yarn.lock","package-lock.json","pnpm-lock.yaml","npm-shrinkwrap.json","bun.lockb"],h=r(n=>{let a;if(l.forEach(i=>{!a&&k(p(n,i))&&(a=p(n,i))}),a)return a;const e=p(n,"package.json");if(k(e)&&u(P(e,"utf8")).packageManager!==void 0)return e},"packageMangerFindUpMatcher"),S=r(async n=>{if(!n)throw new c("Could not find a package manager");if(n.endsWith("package.json")){const a=await j(n);if(a.packageManager){const e=["npm","yarn","pnpm","bun"].find(i=>a.packageManager.startsWith(i));if(e)return{packageManager:e,path:t(n)}}}if(n.endsWith("yarn.lock"))return{packageManager:"yarn",path:t(n)};if(n.endsWith("package-lock.json")||n.endsWith("npm-shrinkwrap.json"))return{packageManager:"npm",path:t(n)};if(n.endsWith("pnpm-lock.yaml"))return{packageManager:"pnpm",path:t(n)};if(n.endsWith("bun.lockb"))return{packageManager:"bun",path:t(n)};throw new c("Could not find a package manager")},"findPackageManagerOnFile"),$=r(n=>{if(!n)throw new c("Could not find a package manager");if(n.endsWith("package.json")){const a=u(n);if(a.packageManager){const e=["npm","yarn","pnpm","bun"].find(i=>a.packageManager.startsWith(i));if(e)return{packageManager:e,path:t(n)}}}if(n.endsWith("yarn.lock"))return{packageManager:"yarn",path:t(n)};if(n.endsWith("package-lock.json")||n.endsWith("npm-shrinkwrap.json"))return{packageManager:"npm",path:t(n)};if(n.endsWith("pnpm-lock.yaml"))return{packageManager:"pnpm",path:t(n)};if(n.endsWith("bun.lockb"))return{packageManager:"bun",path:t(n)};throw new c("Could not find a package manager")},"findPackageManagerOnFileSync"),I=r(async n=>{const a=await m(l,{type:"file",...n&&{cwd:n}});if(!a)throw new Error("Could not find lock file");return a},"findLockFile"),L=r(n=>{const a=f(l,{type:"file",...n&&{cwd:n}});if(!a)throw new Error("Could not find lock file");return a},"findLockFileSync"),O=r(async n=>{const a=await m(h,{...n&&{cwd:n}});return S(a)},"findPackageManager"),U=r(n=>{const a=f(h,{...n&&{cwd:n}});return $(a)},"findPackageManagerSync"),N=r(n=>v(`${n} --version`).toString("utf8").trim(),"getPackageManagerVersion"),T=r(async()=>{if(!process.env.npm_config_user_agent)return;const n=process.env.npm_config_user_agent.split(" ")[0],a=n.lastIndexOf("/"),e=n.slice(0,Math.max(0,a));return{name:e==="npminstall"?"cnpm":e,version:n.slice(Math.max(0,a+1))}},"identifyInitiatingPackageManager"),B=r((n,a,e)=>{const i=a.length===1?"":"s";if(e.packageManagers===void 0&&(e.packageManagers=["npm","pnpm","yarn"]),e.packageManagers.length===0)throw new Error("No package managers provided, please provide at least one package manager");if(a.length===0)throw new Error("No missing packages provided, please provide at least one missing package");let g=`
+${e.preMessage??""}
+${n} could not find the following package${i}
+
+  ${a.join(`
+  `)}
+
+To install the missing package${i}, please run the following command:
+`;const M=r(o=>o.split("@").includes("@")?o:`${o}@latest`,"atLatest"),w=e.packageManagers.map(o=>{const s=a.map(y=>M(y)).join(" ");switch(o){case"bun":return`  bun add ${s} -D`;case"npm":return`  npm install ${s} --save-dev`;case"pnpm":return`  pnpm add ${s} -D`;case"yarn":return`  yarn add ${s} --dev`;default:throw new Error("Unknown package manager")}});return g+=w.join(`
+
+or
+
+`),e.postMessage&&(g+=e.postMessage),g},"generateMissingPackagesInstallMessage");export{I as findLockFile,L as findLockFileSync,O as findPackageManager,U as findPackageManagerSync,B as generateMissingPackagesInstallMessage,N as getPackageManagerVersion,T as identifyInitiatingPackageManager};

package/dist/package.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var c=(n,o)=>p(n,"name",{value:o,configurable:!0});import{findUp as a,findUpSync as f,readJsonSync as y}from"@visulima/fs";import{dirname as e,join as d}from"@visulima/path";import{findLockFile as u,findLockFileSync as l}from"./package-manager.js";const{existsSync:g}=globalThis.process.getBuiltinModule("node:fs");var w=Object.defineProperty,i=c((n,o)=>w(n,"name",{value:o,configurable:!0}),"i");const s=i(n=>{if(g(d(n,"package.json"))){const o=y(d(n,"package.json"));if(o.name&&o.private!==!0)return"package.json"}},"packageJsonMatcher"),j=i(async n=>{try{const t=await u(n);return e(t)}catch{}const o=await a(".git/config",{...n&&{cwd:n},type:"file"});if(o)return e(e(o));const r=await a(s,{...n&&{cwd:n},type:"file"});if(r)return e(r);throw new Error("Could not find root directory")},"findPackageRoot"),P=i(n=>{try{const t=l(n);return e(t)}catch{}const o=f(".git/config",{...n&&{cwd:n},type:"file"});if(o)return e(e(o));const r=f(s,{...n&&{cwd:n},type:"file"});if(r)return e(r);throw new Error("Could not find root directory")},"findPackageRootSync");export{j as findPackageRoot,P as findPackageRootSync};

package/dist/packem_shared/PackageNotFoundError-BictYTIA.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var a=(t,e)=>o(t,"name",{value:e,configurable:!0});import{findPackageManagerSync as n}from"../package-manager.js";var c=Object.defineProperty,i=a((t,e)=>c(t,"name",{value:e,configurable:!0}),"t");class g extends Error{static{a(this,"u")}static{i(this,"PackageNotFoundError")}constructor(e,r){if(typeof e=="string"&&(e=[e]),e.length===0){super("Package was not found.");return}if(r===void 0)try{r=n().packageManager}catch{}r===void 0&&(r="npm"),super(`Package '${e.join(" ")}' was not found. Please install it using '${r} install ${e.join(" ")}'`)}get code(){return"PACKAGE_NOT_FOUND"}set code(e){throw new Error("Cannot overwrite code PACKAGE_NOT_FOUND")}get name(){return"PackageNotFoundError"}set name(e){throw new Error("Cannot overwrite name of PackageNotFoundError")}}export{g as default};

package/dist/packem_shared/json-value.d-DU4PzU4Z.d.ts

@@ -0,0 +1,33 @@
+/**
+Matches a JSON object.
+
+This type can be useful to enforce some input to be JSON-compatible or as a super-type to be extended from. Don't use this as a direct return type as the user would have to double-cast it: `jsonObject as unknown as CustomResponse`. Instead, you could extend your CustomResponse type from it to ensure your type only uses JSON-compatible types: `interface CustomResponse extends JsonObject { … }`.
+
+@category JSON
+*/
+type JsonObject = {[Key in string]: JsonValue} & {[Key in string]?: JsonValue | undefined};
+
+/**
+Matches a JSON array.
+
+@category JSON
+*/
+type JsonArray = JsonValue[] | readonly JsonValue[];
+
+/**
+Matches any valid JSON primitive value.
+
+@category JSON
+*/
+type JsonPrimitive = string | number | boolean | null;
+
+/**
+Matches any valid JSON value.
+
+@see `Jsonify` if you need to transform a type to one that is assignable to `JsonValue`.
+
+@category JSON
+*/
+type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+
+export type { JsonObject as J, JsonValue as a };