@visulima/package 5.0.0-alpha.2 → 5.0.0-alpha.20

package/dist/package-json.d.ts

@@ -1,138 +1,7 @@
-import type { WriteJsonOptions } from "@visulima/fs";
-import type { JsonObject, Paths } from "type-fest";
-import type { Cache, EnsurePackagesOptions, NormalizedPackageJson, PackageJson } from "./types.d.ts";
-type ReadOptions = {
-    cache?: FindPackageJsonCache | boolean;
-    ignoreWarnings?: (RegExp | string)[];
-    json5?: boolean;
-    resolveCatalogs?: boolean;
-    strict?: boolean;
-    yaml?: boolean;
-};
-export type FindPackageJsonCache = Cache<NormalizedReadResult>;
-export 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.
- */
-export 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.
- */
-export 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>`.
- */
-export declare const writePackageJson: <T = PackageJson>(data: T, options?: WriteJsonOptions & {
-    cwd?: URL | string;
-}) => Promise<void>;
-export declare const writePackageJsonSync: <T = PackageJson>(data: T, options?: WriteJsonOptions & {
-    cwd?: URL | string;
-}) => 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.
- */
-export 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.
- */
-export 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
- */
-export 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
- */
-export 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
- */
-export 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
- */
-export declare const ensurePackages: (packageJson: NormalizedPackageJson, packages: string[], installKey?: "dependencies" | "devDependencies", options?: EnsurePackagesOptions) => Promise<void>;
-export {};
+import '@visulima/fs';
+import 'type-fest';
+export { F as FindPackageJsonCache, a as NormalizedReadResult, 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";
+import '@antfu/install-pkg';
+import '@inquirer/core';
+import '@inquirer/type';
+import 'normalize-package-data';

package/dist/package-json.js

@@ -1,4 +1,4 @@
-var K=Object.defineProperty;var f=(e,r)=>K(e,"name",{value:r,configurable:!0});import{createRequire as V}from"node:module";import{installPackage as X}from"@antfu/install-pkg";import{readJsonSync as L,readFileSync as H,findUp as Q,findUpSync as Z,writeJson as ee,writeJsonSync as re,readJson as ne,readFile as te}from"@visulima/fs";import{NotFoundError as I}from"@visulima/fs/error";import{parseJson as T,toPath as A}from"@visulima/fs/utils";import{readYamlSync as oe,readYaml as se}from"@visulima/fs/yaml";import{join as _}from"@visulima/path";import F from"json5";import ae from"normalize-package-data";import{readPnpmCatalogsSync as D,resolveCatalogReferences as E,readPnpmCatalogs as C}from"./pnpm.js";const U=V(import.meta.url),w=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,J=f(e=>{if(typeof w<"u"&&w.versions&&w.versions.node){const[r,t]=w.versions.node.split(".").map(Number);if(r>22||r===22&&t>=3||r===20&&t>=16)return w.getBuiltinModule(e)}return U(e)},"__cjs_getBuiltinModule"),{existsSync:N}=J("node:fs"),{createInterface:ie}=J("node:readline"),{styleText:g}=J("node:util");var ce=Object.defineProperty,l=f((e,r)=>ce(e,"name",{value:r,configurable:!0}),"f");const h=l(e=>{const r=typeof e;return e!==null&&(r==="object"||r==="function")},"isObject"),fe=l(e=>{if(!h(e))return!1;for(const r in e)if(Object.hasOwn(e,r))return!1;return!0},"isEmptyObject"),O=new Set(["__proto__","prototype","constructor"]),W=1e6,pe=l(e=>e>="0"&&e<="9","isDigit");function b(e){if(e==="0")return!0;if(/^[1-9]\d*$/.test(e)){const r=Number.parseInt(e,10);return r<=Number.MAX_SAFE_INTEGER&&r<=W}return!1}f(b,"p$1");l(b,"shouldCoerceToNumber");function k(e,r){return O.has(e)?!1:(e&&b(e)?r.push(Number.parseInt(e,10)):r.push(e),!0)}f(k,"y");l(k,"processSegment");function B(e){if(typeof e!="string")throw new TypeError(`Expected a string, got ${typeof e}`);const r=[];let t="",n="start",o=!1,s=0;for(const a of e){if(s++,o){t+=a,o=!1;continue}if(a==="\\"){if(n==="index")throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd")throw new Error(`Invalid character '${a}' after an index at position ${s}`);o=!0,n=n==="start"?"property":n;continue}switch(a){case".":{if(n==="index")throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd"){n="property";break}if(!k(t,r))return[];t="",n="property";break}case"[":{if(n==="index")throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd"){n="index";break}if(n==="property"||n==="start"){if((t||n==="property")&&!k(t,r))return[];t=""}n="index";break}case"]":{if(n==="index"){if(t==="")t=(r.pop()||"")+"[]",n="property";else{const i=Number.parseInt(t,10);!Number.isNaN(i)&&Number.isFinite(i)&&i>=0&&i<=Number.MAX_SAFE_INTEGER&&i<=W&&t===String(i)?r.push(i):r.push(t),t="",n="indexEnd"}break}if(n==="indexEnd")throw new Error(`Invalid character '${a}' after an index at position ${s}`);t+=a;break}default:{if(n==="index"&&!pe(a))throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd")throw new Error(`Invalid character '${a}' after an index at position ${s}`);n==="start"&&(n="property"),t+=a}}}switch(o&&(t+="\\"),n){case"property":{if(!k(t,r))return[];break}case"index":throw new Error("Index was not closed");case"start":{r.push("");break}}return r}f(B,"parsePath");l(B,"parsePath");function $(e){if(typeof e=="string")return B(e);if(Array.isArray(e)){const r=[];for(const[t,n]of e.entries()){if(typeof n!="string"&&typeof n!="number")throw new TypeError(`Expected a string or number for path segment at index ${t}, got ${typeof n}`);if(typeof n=="number"&&!Number.isFinite(n))throw new TypeError(`Path segment at index ${t} must be a finite number, got ${n}`);if(O.has(n))return[];typeof n=="string"&&b(n)?r.push(Number.parseInt(n,10)):r.push(n)}return r}return[]}f($,"d");l($,"normalizePath");function d(e,r,t){if(!h(e)||typeof r!="string"&&!Array.isArray(r))return t===void 0?e:t;const n=$(r);if(n.length===0)return t;for(let o=0;o<n.length;o++){const s=n[o];if(e=e[s],e==null){if(o!==n.length-1)return t;break}}return e===void 0?t:e}f(d,"getProperty");l(d,"getProperty");function M(e,r,t){if(!h(e)||typeof r!="string"&&!Array.isArray(r))return e;const n=e,o=$(r);if(o.length===0)return e;for(let s=0;s<o.length;s++){const a=o[s];if(s===o.length-1)e[a]=t;else if(!h(e[a])){const i=typeof o[s+1]=="number";e[a]=i?[]:{}}e=e[a]}return n}f(M,"setProperty");l(M,"setProperty");function le(e,r){if(!h(e)||typeof r!="string"&&!Array.isArray(r))return!1;const t=$(r);if(t.length===0)return!1;for(let n=0;n<t.length;n++){const o=t[n];if(n===t.length-1)return Object.hasOwn(e,o)?(delete e[o],!0):!1;if(e=e[o],!h(e))return!1}}f(le,"deleteProperty");l(le,"deleteProperty");function y(e,r){if(!h(e)||typeof r!="string"&&!Array.isArray(r))return!1;const t=$(r);if(t.length===0)return!1;for(const n of t){if(!h(e)||!(n in e))return!1;e=e[n]}return!0}f(y,"hasProperty");l(y,"hasProperty");function x(e){if(typeof e!="string")throw new TypeError(`Expected a string, got ${typeof e}`);return e.replaceAll(/[\\.[]/g,String.raw`\$&`)}f(x,"escapePath");l(x,"escapePath");function R(e){const r=Object.entries(e);return Array.isArray(e)?r.map(([t,n])=>[b(t)?Number.parseInt(t,10):t,n]):r}f(R,"m$2");l(R,"normalizeEntries");function Y(e,r={}){if(!Array.isArray(e))throw new TypeError(`Expected an array, got ${typeof e}`);const{preferDotForIndices:t=!1}=r,n=[];for(const[o,s]of e.entries()){if(typeof s!="string"&&typeof s!="number")throw new TypeError(`Expected a string or number for path segment at index ${o}, got ${typeof s}`);if(typeof s=="number")if(!Number.isInteger(s)||s<0){const a=x(String(s));n.push(o===0?a:`.${a}`)}else t&&o>0?n.push(`.${s}`):n.push(`[${s}]`);else if(typeof s=="string")if(s==="")o===0||n.push(".");else if(b(s)){const a=Number.parseInt(s,10);t&&o>0?n.push(`.${a}`):n.push(`[${a}]`)}else{const a=x(s);n.push(o===0?a:`.${a}`)}}return n.join("")}f(Y,"stringifyPath");l(Y,"stringifyPath");function*S(e,r=[],t=new Set){if(!h(e)||fe(e)){r.length>0&&(yield Y(r));return}if(!t.has(e)){t.add(e);for(const[n,o]of R(e))r.push(n),yield*S(o,r,t),r.pop();t.delete(e)}}f(S,"x");l(S,"deepKeysIterator");function ue(e){return[...S(e)]}f(ue,"deepKeys");l(ue,"deepKeys");function ge(e){const r={};if(!h(e))return r;for(const[t,n]of Object.entries(e))M(r,t,n);return r}f(ge,"unflatten");l(ge,"unflatten");var he=Object.defineProperty,j=f((e,r)=>he(e,"name",{value:r,configurable:!0}),"i");const de=j(async e=>{const{default:r=!1,message:t,transformer:n}=e,o=j(a=>{const i=g(["cyan","bold"],"?"),c=g(["bold"],a),u=r?`${g(["greenBright"],"Y")}${g(["gray"],"/n")}`:`y/${g(["yellowBright"],"N")}`;return`${i} ${c} ${g(["gray"],`(${u})`)}`},"formatMessage"),s=j(a=>n?n(a):a?g(["greenBright"],"Yes"):g(["yellowBright"],"No"),"formatAnswer");return new Promise(a=>{const i=ie({input:process.stdin,output:process.stdout}),c=o(t);i.question(c,u=>{i.close();const m=u.trim().toLowerCase();if(m===""){a(r);return}if(m==="y"||m==="yes"){console.log(`${g(["greenBright"],"✓")} ${s(!0)}`),a(!0);return}if(m==="n"||m==="no"){console.log(`${g(["yellowBright"],"✗")} ${s(!1)}`),a(!1);return}console.log(`${g(["gray"],"→")} ${s(r)}`),a(r)}),i.on("SIGINT",()=>{i.close(),console.log(`
-${g(["gray"],"→")} ${s(r)}`),a(r)})})},"confirm"),ye=typeof process.stdout<"u"&&!process.versions.deno&&!globalThis.window;var me=Object.defineProperty,p=f((e,r)=>me(e,"name",{value:r,configurable:!0}),"l");const P=new Map,q=new Map;class we extends Error{static{f(this,"F")}static{p(this,"PackageJsonValidationError")}constructor(r){super(`The following warnings were encountered while normalizing package data:
+var V=Object.defineProperty;var f=(e,r)=>V(e,"name",{value:r,configurable:!0});import{createRequire as L}from"node:module";import{installPackage as X}from"@antfu/install-pkg";import{readJsonSync as H,readFileSync as Q,findUp as Z,findUpSync as ee,writeJson as re,writeJsonSync as ne,readJson as te,readFile as oe}from"@visulima/fs";import{NotFoundError as I}from"@visulima/fs/error";import{parseJson as T,toPath as A}from"@visulima/fs/utils";import{readYamlSync as se,readYaml as ae}from"@visulima/fs/yaml";import{join as _}from"@visulima/path";import F from"json5";import ie from"normalize-package-data";import{readPnpmCatalogsSync as D,resolveCatalogReferences as E,readPnpmCatalogs as C}from"./pnpm.js";const U=L(import.meta.url),w=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,J=f(e=>{if(typeof w<"u"&&w.versions&&w.versions.node){const[r,t]=w.versions.node.split(".").map(Number);if(r>22||r===22&&t>=3||r===20&&t>=16)return w.getBuiltinModule(e)}return U(e)},"__cjs_getBuiltinModule"),{existsSync:N}=J("node:fs"),{createInterface:ce}=J("node:readline"),{styleText:g}=J("node:util");var fe=Object.defineProperty,l=f((e,r)=>fe(e,"name",{value:r,configurable:!0}),"f");const d=l(e=>{const r=typeof e;return e!==null&&(r==="object"||r==="function")},"isObject"),pe=l(e=>{if(!d(e))return!1;for(const r in e)if(Object.hasOwn(e,r))return!1;return!0},"isEmptyObject"),O=new Set(["__proto__","prototype","constructor"]),W=1e6,le=l(e=>e>="0"&&e<="9","isDigit");function b(e){if(e==="0")return!0;if(/^[1-9]\d*$/.test(e)){const r=Number.parseInt(e,10);return r<=Number.MAX_SAFE_INTEGER&&r<=W}return!1}f(b,"p$1");l(b,"shouldCoerceToNumber");function P(e,r){return O.has(e)?!1:(e&&b(e)?r.push(Number.parseInt(e,10)):r.push(e),!0)}f(P,"y");l(P,"processSegment");function B(e){if(typeof e!="string")throw new TypeError(`Expected a string, got ${typeof e}`);const r=[];let t="",n="start",o=!1,s=0;for(const a of e){if(s++,o){t+=a,o=!1;continue}if(a==="\\"){if(n==="index")throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd")throw new Error(`Invalid character '${a}' after an index at position ${s}`);o=!0,n=n==="start"?"property":n;continue}switch(a){case".":{if(n==="index")throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd"){n="property";break}if(!P(t,r))return[];t="",n="property";break}case"[":{if(n==="index")throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd"){n="index";break}if(n==="property"||n==="start"){if((t||n==="property")&&!P(t,r))return[];t=""}n="index";break}case"]":{if(n==="index"){if(t==="")t=(r.pop()||"")+"[]",n="property";else{const i=Number.parseInt(t,10);!Number.isNaN(i)&&Number.isFinite(i)&&i>=0&&i<=Number.MAX_SAFE_INTEGER&&i<=W&&t===String(i)?r.push(i):r.push(t),t="",n="indexEnd"}break}if(n==="indexEnd")throw new Error(`Invalid character '${a}' after an index at position ${s}`);t+=a;break}default:{if(n==="index"&&!le(a))throw new Error(`Invalid character '${a}' in an index at position ${s}`);if(n==="indexEnd")throw new Error(`Invalid character '${a}' after an index at position ${s}`);n==="start"&&(n="property"),t+=a}}}switch(o&&(t+="\\"),n){case"property":{if(!P(t,r))return[];break}case"index":throw new Error("Index was not closed");case"start":{r.push("");break}}return r}f(B,"parsePath");l(B,"parsePath");function k(e){if(typeof e=="string")return B(e);if(Array.isArray(e)){const r=[];for(const[t,n]of e.entries()){if(typeof n!="string"&&typeof n!="number")throw new TypeError(`Expected a string or number for path segment at index ${t}, got ${typeof n}`);if(typeof n=="number"&&!Number.isFinite(n))throw new TypeError(`Path segment at index ${t} must be a finite number, got ${n}`);if(O.has(n))return[];typeof n=="string"&&b(n)?r.push(Number.parseInt(n,10)):r.push(n)}return r}return[]}f(k,"d");l(k,"normalizePath");function h(e,r,t){if(!d(e)||typeof r!="string"&&!Array.isArray(r))return t===void 0?e:t;const n=k(r);if(n.length===0)return t;for(let o=0;o<n.length;o++){const s=n[o];if(e=e[s],e==null){if(o!==n.length-1)return t;break}}return e===void 0?t:e}f(h,"getProperty");l(h,"getProperty");function M(e,r,t){if(!d(e)||typeof r!="string"&&!Array.isArray(r))return e;const n=e,o=k(r);if(o.length===0)return e;for(let s=0;s<o.length;s++){const a=o[s];if(s===o.length-1)e[a]=t;else if(!d(e[a])){const i=typeof o[s+1]=="number";e[a]=i?[]:{}}e=e[a]}return n}f(M,"setProperty");l(M,"setProperty");function ue(e,r){if(!d(e)||typeof r!="string"&&!Array.isArray(r))return!1;const t=k(r);if(t.length===0)return!1;for(let n=0;n<t.length;n++){const o=t[n];if(n===t.length-1)return Object.hasOwn(e,o)?(delete e[o],!0):!1;if(e=e[o],!d(e))return!1}}f(ue,"deleteProperty");l(ue,"deleteProperty");function y(e,r){if(!d(e)||typeof r!="string"&&!Array.isArray(r))return!1;const t=k(r);if(t.length===0)return!1;for(const n of t){if(!d(e)||!(n in e))return!1;e=e[n]}return!0}f(y,"hasProperty");l(y,"hasProperty");function x(e){if(typeof e!="string")throw new TypeError(`Expected a string, got ${typeof e}`);return e.replaceAll(/[\\.[]/g,String.raw`\$&`)}f(x,"escapePath");l(x,"escapePath");function R(e){const r=Object.entries(e);return Array.isArray(e)?r.map(([t,n])=>[b(t)?Number.parseInt(t,10):t,n]):r}f(R,"m$2");l(R,"normalizeEntries");function Y(e,r={}){if(!Array.isArray(e))throw new TypeError(`Expected an array, got ${typeof e}`);const{preferDotForIndices:t=!1}=r,n=[];for(const[o,s]of e.entries()){if(typeof s!="string"&&typeof s!="number")throw new TypeError(`Expected a string or number for path segment at index ${o}, got ${typeof s}`);if(typeof s=="number")if(!Number.isInteger(s)||s<0){const a=x(String(s));n.push(o===0?a:`.${a}`)}else t&&o>0?n.push(`.${s}`):n.push(`[${s}]`);else if(typeof s=="string")if(s==="")o===0||n.push(".");else if(b(s)){const a=Number.parseInt(s,10);t&&o>0?n.push(`.${a}`):n.push(`[${a}]`)}else{const a=x(s);n.push(o===0?a:`.${a}`)}}return n.join("")}f(Y,"stringifyPath");l(Y,"stringifyPath");function*S(e,r=[],t=new Set){if(!d(e)||pe(e)){r.length>0&&(yield Y(r));return}if(!t.has(e)){t.add(e);for(const[n,o]of R(e))r.push(n),yield*S(o,r,t),r.pop();t.delete(e)}}f(S,"x");l(S,"deepKeysIterator");function ge(e){return[...S(e)]}f(ge,"deepKeys");l(ge,"deepKeys");function de(e){const r={};if(!d(e))return r;for(const[t,n]of Object.entries(e))M(r,t,n);return r}f(de,"unflatten");l(de,"unflatten");var he=Object.defineProperty,j=f((e,r)=>he(e,"name",{value:r,configurable:!0}),"i");const ye=j(async e=>{const{default:r=!1,message:t,transformer:n}=e,o=j(a=>{const i=g(["cyan","bold"],"?"),c=g(["bold"],a),u=r?`${g(["greenBright"],"Y")}${g(["gray"],"/n")}`:`y/${g(["yellowBright"],"N")}`;return`${i} ${c} ${g(["gray"],`(${u})`)}`},"formatMessage"),s=j(a=>n?n(a):a?g(["greenBright"],"Yes"):g(["yellowBright"],"No"),"formatAnswer");return new Promise(a=>{const i=ce({input:process.stdin,output:process.stdout}),c=o(t);i.question(c,u=>{i.close();const m=u.trim().toLowerCase();if(m===""){a(r);return}if(m==="y"||m==="yes"){console.log(`${g(["greenBright"],"✓")} ${s(!0)}`),a(!0);return}if(m==="n"||m==="no"){console.log(`${g(["yellowBright"],"✗")} ${s(!1)}`),a(!1);return}console.log(`${g(["gray"],"→")} ${s(r)}`),a(r)}),i.on("SIGINT",()=>{i.close(),console.log(`
+${g(["gray"],"→")} ${s(r)}`),a(r)})})},"confirm"),me=typeof process.stdout<"u"&&!process.versions.deno&&!globalThis.window;var we=Object.defineProperty,p=f((e,r)=>we(e,"name",{value:r,configurable:!0}),"l");const q=/, ([^,]*)$/,$=new Map,z=new Map;class be extends Error{static{f(this,"M")}static{p(this,"PackageJsonValidationError")}constructor(r){super(`The following warnings were encountered while normalizing package data:
 - ${r.join(`
-- `)}`),this.name="PackageJsonValidationError"}}const v=p((e,r,t=[])=>{const n=[];if(ae(e,o=>{n.push(o)},r),r&&n.length>0){const o=n.filter(s=>!t.some(a=>a instanceof RegExp?a.test(s):a===s));if(o.length>0)throw new we(o)}return e},"normalizeInput"),be=p(async e=>await se(e),"parseYamlFile"),$e=p(e=>oe(e),"parseYamlFileSync"),ke=p(async e=>{const r=await te(e);return F.parse(r)},"parseJson5File"),Pe=p(e=>{const r=H(e);return F.parse(r)},"parseJson5FileSync"),z=p(async(e,r)=>r?.yaml!==!1&&(e.endsWith(".yaml")||e.endsWith(".yml"))?be(e):r?.json5!==!1&&e.endsWith(".json5")?ke(e):ne(e),"parsePackageFile"),G=p((e,r)=>r?.yaml!==!1&&(e.endsWith(".yaml")||e.endsWith(".yml"))?$e(e):r?.json5!==!1&&e.endsWith(".json5")?Pe(e):L(e),"parsePackageFileSync"),Fe=p(async(e,r={})=>{const t={type:"file"};e&&(t.cwd=e);const n=["package.json"];r.yaml!==!1&&n.push("package.yaml","package.yml"),r.json5!==!1&&n.push("package.json5");let o;for await(const c of n)if(o=await Q(c,t),o)break;if(!o)throw new I(`No such file or directory, for ${n.join(", ").replace(/, ([^,]*)$/," or $1")} found.`);const s=r.cache&&typeof r.cache!="boolean"?r.cache:q;if(r.cache&&s.has(o))return s.get(o);const a=await z(o,r);if(r.resolveCatalogs){const c=await C(o);c&&E(a,c)}v(a,r.strict??!1,r.ignoreWarnings);const i={packageJson:a,path:o};return r.cache&&s.set(o,i),i},"findPackageJson"),De=p((e,r={})=>{const t={type:"file"};e&&(t.cwd=e);const n=["package.json"];r.yaml!==!1&&n.push("package.yaml","package.yml"),r.json5!==!1&&n.push("package.json5");let o;for(const c of n)if(o=Z(c,t),o)break;if(!o)throw new I(`No such file or directory, for ${n.join(", ").replace(/, ([^,]*)$/," or $1")} found.`);const s=r.cache&&typeof r.cache!="boolean"?r.cache:q;if(r.cache&&s.has(o))return s.get(o);const a=G(o,r);if(r.resolveCatalogs){const c=D(o);c&&E(a,c)}v(a,r.strict??!1,r.ignoreWarnings);const i={packageJson:a,path:o};return r.cache&&s.set(o,i),i},"findPackageJsonSync"),Ce=p(async(e,r={})=>{const{cwd:t,...n}=r,o=A(t??process.cwd());await ee(_(o,"package.json"),e,n)},"writePackageJson"),Oe=p((e,r={})=>{const{cwd:t,...n}=r,o=A(t??process.cwd());re(_(o,"package.json"),e,n)},"writePackageJsonSync"),We=p((e,r)=>{const t=e!==null&&typeof e=="object"&&!Array.isArray(e);if(!t&&typeof e!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let n,o=!1,s;if(t)n=structuredClone(e);else if(N(e)){s=e;const i=r?.cache&&typeof r.cache!="boolean"?r.cache:P;if(r?.cache&&i.has(s))return i.get(s);n=G(s,r),o=!0}else n=T(e);if(r?.resolveCatalogs)if(o){const i=D(e);i&&E(n,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");v(n,r?.strict??!1,r?.ignoreWarnings);const a=n;return o&&s&&r?.cache&&(r.cache&&typeof r.cache!="boolean"?r.cache:P).set(s,a),a},"parsePackageJsonSync"),Be=p(async(e,r)=>{const t=e!==null&&typeof e=="object"&&!Array.isArray(e);if(!t&&typeof e!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let n,o=!1,s;if(t)n=structuredClone(e);else if(N(e)){s=e;const i=r?.cache&&typeof r.cache!="boolean"?r.cache:P;if(r?.cache&&i.has(s))return i.get(s);n=await z(s,r),o=!0}else n=T(e);if(r?.resolveCatalogs)if(o){const i=await C(e);i&&E(n,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");v(n,r?.strict??!1,r?.ignoreWarnings);const a=n;return o&&s&&r?.cache&&(r.cache&&typeof r.cache!="boolean"?r.cache:P).set(s,a),a},"parsePackageJson"),Me=p((e,r,t)=>d(e,r,t),"getPackageJsonProperty"),Re=p((e,r)=>y(e,r),"hasPackageJsonProperty"),Ye=p((e,r,t)=>{const n=d(e,"dependencies",{}),o=d(e,"devDependencies",{}),s=d(e,"peerDependencies",{}),a={...n,...o,...t?.peerDeps===!1?{}:s};for(const i of r)if(y(a,i))return!0;return!1},"hasPackageJsonAnyDependency"),qe=p(async(e,r,t="dependencies",n={})=>{const o=d(e,"dependencies",{}),s=d(e,"devDependencies",{}),a=d(e,"peerDependencies",{}),i=[],c={deps:!0,devDeps:!0,peerDeps:!1,...n};for(const u of r)c.deps&&y(o,u)||c.devDeps&&y(s,u)||c.peerDeps&&y(a,u)||i.push(u);if(i.length!==0){if(process.env.CI||ye&&!process.stdout?.isTTY){const u=`Skipping package installation for [${r.join(", ")}] because the process is not interactive.`;if(n.throwOnWarn)throw new Error(u);n.logger?.warn?n.logger.warn(u):console.warn(u);return}if(typeof c.confirm?.message=="function"&&(c.confirm.message=c.confirm.message(i)),c.confirm?.message===void 0){const u=`${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:u}:c.confirm.message=u}await de(c.confirm)&&await X(i,{...c.installPackage,cwd:c.cwd?A(c.cwd):void 0,dev:t==="devDependencies"})}},"ensurePackages");export{qe as ensurePackages,Fe as findPackageJson,De as findPackageJsonSync,Me as getPackageJsonProperty,Ye as hasPackageJsonAnyDependency,Re as hasPackageJsonProperty,Be as parsePackageJson,We as parsePackageJsonSync,Ce as writePackageJson,Oe as writePackageJsonSync};
+- `)}`),this.name="PackageJsonValidationError"}}const v=p((e,r,t=[])=>{const n=[];if(ie(e,o=>{n.push(o)},r),r&&n.length>0){const o=n.filter(s=>!t.some(a=>a instanceof RegExp?a.test(s):a===s));if(o.length>0)throw new be(o)}return e},"normalizeInput"),ke=p(async e=>await ae(e),"parseYamlFile"),Pe=p(e=>se(e),"parseYamlFileSync"),$e=p(async e=>{const r=await oe(e);return F.parse(r)},"parseJson5File"),Ee=p(e=>{const r=Q(e);return F.parse(r)},"parseJson5FileSync"),G=p(async(e,r)=>r?.yaml!==!1&&(e.endsWith(".yaml")||e.endsWith(".yml"))?ke(e):r?.json5!==!1&&e.endsWith(".json5")?$e(e):te(e),"parsePackageFile"),K=p((e,r)=>r?.yaml!==!1&&(e.endsWith(".yaml")||e.endsWith(".yml"))?Pe(e):r?.json5!==!1&&e.endsWith(".json5")?Ee(e):H(e),"parsePackageFileSync"),De=p(async(e,r={})=>{const t={type:"file"};e&&(t.cwd=e);const n=["package.json"];r.yaml!==!1&&n.push("package.yaml","package.yml"),r.json5!==!1&&n.push("package.json5");let o;for(const c of n)if(o=await Z(c,t),o)break;if(!o)throw new I(`No such file or directory, for ${n.join(", ").replace(q," or $1")} found.`);const s=r.cache&&typeof r.cache!="boolean"?r.cache:z;if(r.cache&&s.has(o))return s.get(o);const a=await G(o,r);if(r.resolveCatalogs){const c=await C(o);c&&E(a,c)}v(a,r.strict??!1,r.ignoreWarnings);const i={packageJson:a,path:o};return r.cache&&s.set(o,i),i},"findPackageJson"),Ce=p((e,r={})=>{const t={type:"file"};e&&(t.cwd=e);const n=["package.json"];r.yaml!==!1&&n.push("package.yaml","package.yml"),r.json5!==!1&&n.push("package.json5");let o;for(const c of n)if(o=ee(c,t),o)break;if(!o)throw new I(`No such file or directory, for ${n.join(", ").replace(q," or $1")} found.`);const s=r.cache&&typeof r.cache!="boolean"?r.cache:z;if(r.cache&&s.has(o))return s.get(o);const a=K(o,r);if(r.resolveCatalogs){const c=D(o);c&&E(a,c)}v(a,r.strict??!1,r.ignoreWarnings);const i={packageJson:a,path:o};return r.cache&&s.set(o,i),i},"findPackageJsonSync"),Oe=p(async(e,r={})=>{const{cwd:t,...n}=r,o=A(t??process.cwd());await re(_(o,"package.json"),e,n)},"writePackageJson"),We=p((e,r={})=>{const{cwd:t,...n}=r,o=A(t??process.cwd());ne(_(o,"package.json"),e,n)},"writePackageJsonSync"),Be=p((e,r)=>{const t=typeof e=="object"&&!Array.isArray(e);if(!t&&typeof e!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let n,o=!1,s;if(t)n=structuredClone(e);else if(N(e)){s=e;const i=r?.cache&&typeof r.cache!="boolean"?r.cache:$;if(r?.cache&&i.has(s))return i.get(s);n=K(s,r),o=!0}else n=T(e);if(r?.resolveCatalogs)if(o){const i=D(e);i&&E(n,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");v(n,r?.strict??!1,r?.ignoreWarnings);const a=n;return o&&r?.cache&&(typeof r.cache=="boolean"?$:r.cache).set(s,a),a},"parsePackageJsonSync"),Me=p(async(e,r)=>{const t=typeof e=="object"&&!Array.isArray(e);if(!t&&typeof e!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");let n,o=!1,s;if(t)n=structuredClone(e);else if(N(e)){s=e;const i=r?.cache&&typeof r.cache!="boolean"?r.cache:$;if(r?.cache&&i.has(s))return i.get(s);n=await G(s,r),o=!0}else n=T(e);if(r?.resolveCatalogs)if(o){const i=await C(e);i&&E(n,i)}else throw new Error("The 'resolveCatalogs' option can only be used on a file path.");v(n,r?.strict??!1,r?.ignoreWarnings);const a=n;return o&&r?.cache&&(typeof r.cache=="boolean"?$:r.cache).set(s,a),a},"parsePackageJson"),Re=p((e,r,t)=>h(e,r,t),"getPackageJsonProperty"),Ye=p((e,r)=>y(e,r),"hasPackageJsonProperty"),qe=p((e,r,t)=>{const n=h(e,"dependencies",{}),o=h(e,"devDependencies",{}),s=h(e,"peerDependencies",{}),a={...n,...o,...t?.peerDeps===!1?{}:s};for(const i of r)if(y(a,i))return!0;return!1},"hasPackageJsonAnyDependency"),ze=p(async(e,r,t="dependencies",n={})=>{const o=h(e,"dependencies",{}),s=h(e,"devDependencies",{}),a=h(e,"peerDependencies",{}),i=[],c={deps:!0,devDeps:!0,peerDeps:!1,...n};for(const u of r)c.deps&&y(o,u)||c.devDeps&&y(s,u)||c.peerDeps&&y(a,u)||i.push(u);if(i.length!==0){if(process.env.CI||me&&!process.stdout.isTTY){const u=`Skipping package installation for [${r.join(", ")}] because the process is not interactive.`;if(n.throwOnWarn)throw new Error(u);n.logger?.warn?n.logger.warn(u):console.warn(u);return}if(typeof c.confirm?.message=="function"&&(c.confirm.message=c.confirm.message(i)),c.confirm?.message===void 0){const u=`${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:u}:c.confirm.message=u}await ye(c.confirm)&&await X(i,{...c.installPackage,cwd:c.cwd?A(c.cwd):void 0,dev:t==="devDependencies"})}},"ensurePackages");export{ze as ensurePackages,De as findPackageJson,Ce as findPackageJsonSync,Re as getPackageJsonProperty,qe as hasPackageJsonAnyDependency,Ye as hasPackageJsonProperty,Me as parsePackageJson,Be as parsePackageJsonSync,Oe as writePackageJson,We as writePackageJsonSync};

package/dist/package-manager.d.ts

@@ -1,71 +1,71 @@
 /**
- * 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.
- */
-export declare const findLockFile: (cwd?: URL | string) => Promise<string>;
-export declare const findLockFileSync: (cwd?: URL | string) => string;
-export type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
-export type PackageManagerResult = {
-    packageManager: PackageManager;
-    path: string;
+* 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&lt;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";
+type PackageManagerResult = {
+  packageManager: PackageManager;
+  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.
- */
-export declare const findPackageManager: (cwd?: URL | string) => Promise<PackageManagerResult>;
+* 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.
- */
-export declare const findPackageManagerSync: (cwd?: URL | string) => 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.
+*/
+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. The type of `name` is `string`.
- * @returns The version of the package manager. The return type of the function is `string`.
- */
-export declare const getPackageManagerVersion: (name: string) => string;
+* Function that retrieves the version of the specified package manager.
+* @param name The name of the package manager. The type of `name` is `string`.
+* @returns The version of the package manager. The return type of the function is `string`.
+*/
+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 A `Promise` that resolves to an object containing the name and version of the package manager,
- * or undefined if the package manager information cannot be determined. The return type of the function
- * is `Promise&lt;{ name: PackageManager | "cnpm"; version: string } | undefined>`.
- */
-export declare const identifyInitiatingPackageManager: () => Promise<{
-    name: PackageManager | "cnpm";
-    version: string;
-} | undefined>;
+* 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";
+  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.
- */
-export declare const generateMissingPackagesInstallMessage: (packageName: string, missingPackages: string[], options: {
-    packageManagers?: PackageManager[];
-    postMessage?: string;
-    preMessage?: string;
+* 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;
+  preMessage?: string;
 }) => string;
+export { PackageManager, PackageManagerResult, findLockFile, findLockFileSync, findPackageManager, findPackageManagerSync, generateMissingPackagesInstallMessage, getPackageManagerVersion, identifyInitiatingPackageManager };

package/dist/package-manager.js

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

package/dist/package.d.ts

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

package/dist/packem_shared/PackageNotFoundError--qHnCLzN.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var a=(r,e)=>o(r,"name",{value:e,configurable:!0});import{findPackageManagerSync as n}from"../package-manager.js";var c=Object.defineProperty,s=a((r,e)=>c(r,"name",{value:e,configurable:!0}),"t");class g extends Error{static{a(this,"s")}static{s(this,"PackageNotFoundError")}constructor(e,t){if(typeof e=="string"&&(e=[e]),e.length===0){super("Package was not found.");return}if(t===void 0)try{t=n().packageManager}catch{}t??="npm",super(`Package '${e.join(" ")}' was not found. Please install it using '${t} 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/package-json.d-R9WIRfmM.d.ts

@@ -0,0 +1,173 @@
+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;
+/**
+* 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, hasPackageJsonProperty as c, parsePackageJsonSync as d, ensurePackages as e, findPackageJson as f, getPackageJsonProperty as g, hasPackageJsonAnyDependency as h, writePackageJsonSync as i, parsePackageJson as p, writePackageJson as w };