@visulima/package 3.4.2 → 3.4.4

package/dist/package-json.cjs

@@ -1 +1,430 @@
-"use strict";var A=Object.defineProperty;var s=(e,n)=>A(e,"name",{value:n,configurable:!0});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("node:fs"),q=require("@antfu/install-pkg"),$=require("@inquirer/confirm"),h=require("@visulima/fs"),E=require("@visulima/fs/error"),k=require("@visulima/fs/utils"),j=require("@visulima/path"),O=require("normalize-package-data"),S=s(e=>e&&typeof e=="object"&&"default"in e?e.default:e,"_interopDefaultCompat"),T=S($),J=S(O);var C=Object.defineProperty,f=s((e,n)=>C(e,"name",{value:n,configurable:!0}),"s");const p=f(e=>{const n=typeof e;return e!==null&&(n==="object"||n==="function")},"isObject"),F=f(e=>p(e)&&Object.keys(e).length===0,"isEmptyObject"),b=new Set(["__proto__","prototype","constructor"]),K=new Set("0123456789");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"&&!K.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}s(w,"d");f(w,"getPathSegments");function P(e,n){if(typeof n!="number"&&Array.isArray(e)){const r=Number.parseInt(n,10);return Number.isInteger(r)&&e[r]===e[n]}return!1}s(P,"l");f(P,"isStringIndex");function m(e,n){if(P(e,n))throw new Error("Cannot use string index")}s(m,"p");f(m,"assertNotStringIndex");function u(e,n,r){if(!p(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];if(P(e,a)?e=o===t.length-1?void 0:null:e=e[a],e==null){if(o!==t.length-1)return r;break}}return e===void 0?r:e}s(u,"getProperty");f(u,"getProperty");function M(e,n,r){if(!p(e)||typeof n!="string")return e;const t=e,o=w(n);for(let a=0;a<o.length;a++){const c=o[a];m(e,c),a===o.length-1?e[c]=r:p(e[c])||(e[c]=typeof o[a+1]=="number"?[]:{}),e=e[c]}return t}s(M,"setProperty");f(M,"setProperty");function U(e,n){if(!p(e)||typeof n!="string")return!1;const r=w(n);for(let t=0;t<r.length;t++){const o=r[t];if(m(e,o),t===r.length-1)return delete e[o],!0;if(e=e[o],!p(e))return!1}}s(U,"deleteProperty");f(U,"deleteProperty");function l(e,n){if(!p(e)||typeof n!="string")return!1;const r=w(n);if(r.length===0)return!1;for(const t of r){if(!p(e)||!(t in e)||P(e,t))return!1;e=e[t]}return!0}s(l,"hasProperty");f(l,"hasProperty");function D(e){if(typeof e!="string")throw new TypeError("Expected a string");return e.replaceAll(/[\\.[]/g,"\\$&")}s(D,"escapePath");f(D,"escapePath");function v(e){const n=Object.entries(e);return Array.isArray(e)?n.map(([r,t])=>[Number(r),t]):n}s(v,"h");f(v,"entries");function I(e){let n="";for(let[r,t]of v(e))typeof t=="number"?n+=`[${t}]`:(t=D(t),n+=r===0?t:`.${t}`);return n}s(I,"w");f(I,"stringifyPath");function*x(e,n=[]){if(!p(e)||F(e)){n.length>0&&(yield I(n));return}for(const[r,t]of v(e))yield*x(t,[...n,r])}s(x,"y$1");f(x,"deepKeysIterator");function Y(e){return[...x(e)]}s(Y,"deepKeys");f(Y,"deepKeys");const z=typeof process.stdout<"u"&&!process.versions?.deno&&!globalThis.window;var B=Object.defineProperty,d=s((e,n)=>B(e,"name",{value:n,configurable:!0}),"r");const N=new Map,G=d(async(e,n={})=>{const r={type:"file"};e&&(r.cwd=e);const t=await h.findUp("package.json",r);if(!t)throw new E.NotFoundError("No such file or directory, for package.json found.");const o=n.cache&&typeof n.cache!="boolean"?n.cache:N;if(n.cache&&o.has(t))return o.get(t);const a=await h.readJson(t);J(a);const c={packageJson:a,path:t};return o.set(t,c),c},"findPackageJson"),H=d((e,n={})=>{const r={type:"file"};e&&(r.cwd=e);const t=h.findUpSync("package.json",r);if(!t)throw new E.NotFoundError("No such file or directory, for package.json found.");const o=n.cache&&typeof n.cache!="boolean"?n.cache:N;if(n.cache&&o.has(t))return o.get(t);const a=h.readJsonSync(t);J(a);const c={packageJson:a,path:t};return o.set(t,c),c},"findPackageJsonSync"),L=d(async(e,n={})=>{const{cwd:r,...t}=n,o=k.toPath(n.cwd??process.cwd());await h.writeJson(j.join(o,"package.json"),e,t)},"writePackageJson"),Q=d((e,n={})=>{const{cwd:r,...t}=n,o=k.toPath(n.cwd??process.cwd());h.writeJsonSync(j.join(o,"package.json"),e,t)},"writePackageJsonSync"),R=d(e=>{const n=e!==null&&typeof e=="object"&&!Array.isArray(e);if(!n&&typeof e!="string")throw new TypeError("`packageFile` should be either an `object` or a `string`.");const r=n?structuredClone(e):_.existsSync(e)?h.readJsonSync(e):k.parseJson(e);return J(r),r},"parsePackageJson"),V=d((e,n,r)=>u(e,n,r),"getPackageJsonProperty"),W=d((e,n)=>l(e,n),"hasPackageJsonProperty"),X=d((e,n,r)=>{const t=u(e,"dependencies",{}),o=u(e,"devDependencies",{}),a=u(e,"peerDependencies",{}),c={...t,...o,...r?.peerDeps===!1?{}:a};for(const g of n)if(l(c,g))return!0;return!1},"hasPackageJsonAnyDependency"),Z=d(async(e,n,r="dependencies",t={})=>{if(process.env.CI||z&&!process.stdout?.isTTY){console.warn("Skipping package installation because the process is not interactive.");return}const o=u(e,"dependencies",{}),a=u(e,"devDependencies",{}),c=u(e,"peerDependencies",{}),g=[],i={deps:!0,devDeps:!0,peerDeps:!1,...t};for(const y of n)i.deps&&l(o,y)||i.devDeps&&l(a,y)||i.peerDeps&&l(c,y)||g.push(y);if(typeof i.confirm?.message=="function"&&(i.confirm.message=i.confirm.message(g)),i.confirm?.message===void 0){const y=`${g.length===1?"Package is":"Packages are"} required for this config: ${g.join(", ")}. Do you want to install them?`;i.confirm===void 0?i.confirm={message:y}:i.confirm.message=y}await T(i.confirm)&&await q.installPackage(g,{...i.installPackage,cwd:i.cwd?k.toPath(i.cwd):void 0,dev:r==="devDependencies"})},"ensurePackages");exports.ensurePackages=Z;exports.findPackageJson=G;exports.findPackageJsonSync=H;exports.getPackageJsonProperty=V;exports.hasPackageJsonAnyDependency=X;exports.hasPackageJsonProperty=W;exports.parsePackageJson=R;exports.writePackageJson=L;exports.writePackageJsonSync=Q;
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const node_fs = require('node:fs');
+const installPkg = require('@antfu/install-pkg');
+const confirm = require('@inquirer/confirm');
+const fs = require('@visulima/fs');
+const error = require('@visulima/fs/error');
+const utils = require('@visulima/fs/utils');
+const path = require('@visulima/path');
+const normalizeData = require('normalize-package-data');
+
+const _interopDefaultCompat = e => e && typeof e === 'object' && 'default' in e ? e.default : e;
+
+const confirm__default = /*#__PURE__*/_interopDefaultCompat(confirm);
+const normalizeData__default = /*#__PURE__*/_interopDefaultCompat(normalizeData);
+
+var __defProp$1 = Object.defineProperty;
+var __name$1 = (target, value) => __defProp$1(target, "name", { value, configurable: true });
+const isObject = /* @__PURE__ */ __name$1((value) => {
+  const type = typeof value;
+  return value !== null && (type === "object" || type === "function");
+}, "isObject");
+const isEmptyObject = /* @__PURE__ */ __name$1((value) => isObject(value) && Object.keys(value).length === 0, "isEmptyObject");
+const disallowedKeys = /* @__PURE__ */ new Set([
+  "__proto__",
+  "prototype",
+  "constructor"
+]);
+const digits = new Set("0123456789");
+function getPathSegments(path) {
+  const parts = [];
+  let currentSegment = "";
+  let currentPart = "start";
+  let isIgnoring = false;
+  for (const character of path) {
+    switch (character) {
+      case "\\": {
+        if (currentPart === "index") {
+          throw new Error("Invalid character in an index");
+        }
+        if (currentPart === "indexEnd") {
+          throw new Error("Invalid character after an index");
+        }
+        if (isIgnoring) {
+          currentSegment += character;
+        }
+        currentPart = "property";
+        isIgnoring = !isIgnoring;
+        break;
+      }
+      case ".": {
+        if (currentPart === "index") {
+          throw new Error("Invalid character in an index");
+        }
+        if (currentPart === "indexEnd") {
+          currentPart = "property";
+          break;
+        }
+        if (isIgnoring) {
+          isIgnoring = false;
+          currentSegment += character;
+          break;
+        }
+        if (disallowedKeys.has(currentSegment)) {
+          return [];
+        }
+        parts.push(currentSegment);
+        currentSegment = "";
+        currentPart = "property";
+        break;
+      }
+      case "[": {
+        if (currentPart === "index") {
+          throw new Error("Invalid character in an index");
+        }
+        if (currentPart === "indexEnd") {
+          currentPart = "index";
+          break;
+        }
+        if (isIgnoring) {
+          isIgnoring = false;
+          currentSegment += character;
+          break;
+        }
+        if (currentPart === "property") {
+          if (disallowedKeys.has(currentSegment)) {
+            return [];
+          }
+          parts.push(currentSegment);
+          currentSegment = "";
+        }
+        currentPart = "index";
+        break;
+      }
+      case "]": {
+        if (currentPart === "index") {
+          parts.push(Number.parseInt(currentSegment, 10));
+          currentSegment = "";
+          currentPart = "indexEnd";
+          break;
+        }
+        if (currentPart === "indexEnd") {
+          throw new Error("Invalid character after an index");
+        }
+      }
+      default: {
+        if (currentPart === "index" && !digits.has(character)) {
+          throw new Error("Invalid character in an index");
+        }
+        if (currentPart === "indexEnd") {
+          throw new Error("Invalid character after an index");
+        }
+        if (currentPart === "start") {
+          currentPart = "property";
+        }
+        if (isIgnoring) {
+          isIgnoring = false;
+          currentSegment += "\\";
+        }
+        currentSegment += character;
+      }
+    }
+  }
+  if (isIgnoring) {
+    currentSegment += "\\";
+  }
+  switch (currentPart) {
+    case "property": {
+      if (disallowedKeys.has(currentSegment)) {
+        return [];
+      }
+      parts.push(currentSegment);
+      break;
+    }
+    case "index": {
+      throw new Error("Index was not closed");
+    }
+    case "start": {
+      parts.push("");
+      break;
+    }
+  }
+  return parts;
+}
+__name$1(getPathSegments, "getPathSegments");
+function isStringIndex(object, key) {
+  if (typeof key !== "number" && Array.isArray(object)) {
+    const index = Number.parseInt(key, 10);
+    return Number.isInteger(index) && object[index] === object[key];
+  }
+  return false;
+}
+__name$1(isStringIndex, "isStringIndex");
+function assertNotStringIndex(object, key) {
+  if (isStringIndex(object, key)) {
+    throw new Error("Cannot use string index");
+  }
+}
+__name$1(assertNotStringIndex, "assertNotStringIndex");
+function getProperty(object, path, value) {
+  if (!isObject(object) || typeof path !== "string") {
+    return value === undefined ? object : value;
+  }
+  const pathArray = getPathSegments(path);
+  if (pathArray.length === 0) {
+    return value;
+  }
+  for (let index = 0; index < pathArray.length; index++) {
+    const key = pathArray[index];
+    if (isStringIndex(object, key)) {
+      object = index === pathArray.length - 1 ? undefined : null;
+    } else {
+      object = object[key];
+    }
+    if (object === undefined || object === null) {
+      if (index !== pathArray.length - 1) {
+        return value;
+      }
+      break;
+    }
+  }
+  return object === undefined ? value : object;
+}
+__name$1(getProperty, "getProperty");
+function setProperty(object, path, value) {
+  if (!isObject(object) || typeof path !== "string") {
+    return object;
+  }
+  const root = object;
+  const pathArray = getPathSegments(path);
+  for (let index = 0; index < pathArray.length; index++) {
+    const key = pathArray[index];
+    assertNotStringIndex(object, key);
+    if (index === pathArray.length - 1) {
+      object[key] = value;
+    } else if (!isObject(object[key])) {
+      object[key] = typeof pathArray[index + 1] === "number" ? [] : {};
+    }
+    object = object[key];
+  }
+  return root;
+}
+__name$1(setProperty, "setProperty");
+function deleteProperty(object, path) {
+  if (!isObject(object) || typeof path !== "string") {
+    return false;
+  }
+  const pathArray = getPathSegments(path);
+  for (let index = 0; index < pathArray.length; index++) {
+    const key = pathArray[index];
+    assertNotStringIndex(object, key);
+    if (index === pathArray.length - 1) {
+      delete object[key];
+      return true;
+    }
+    object = object[key];
+    if (!isObject(object)) {
+      return false;
+    }
+  }
+}
+__name$1(deleteProperty, "deleteProperty");
+function hasProperty(object, path) {
+  if (!isObject(object) || typeof path !== "string") {
+    return false;
+  }
+  const pathArray = getPathSegments(path);
+  if (pathArray.length === 0) {
+    return false;
+  }
+  for (const key of pathArray) {
+    if (!isObject(object) || !(key in object) || isStringIndex(object, key)) {
+      return false;
+    }
+    object = object[key];
+  }
+  return true;
+}
+__name$1(hasProperty, "hasProperty");
+function escapePath(path) {
+  if (typeof path !== "string") {
+    throw new TypeError("Expected a string");
+  }
+  return path.replaceAll(/[\\.[]/g, "\\$&");
+}
+__name$1(escapePath, "escapePath");
+function entries(value) {
+  const result = Object.entries(value);
+  if (Array.isArray(value)) {
+    return result.map(([key, value2]) => [Number(key), value2]);
+  }
+  return result;
+}
+__name$1(entries, "entries");
+function stringifyPath(pathSegments) {
+  let result = "";
+  for (let [index, segment] of entries(pathSegments)) {
+    if (typeof segment === "number") {
+      result += `[${segment}]`;
+    } else {
+      segment = escapePath(segment);
+      result += index === 0 ? segment : `.${segment}`;
+    }
+  }
+  return result;
+}
+__name$1(stringifyPath, "stringifyPath");
+function* deepKeysIterator(object, currentPath = []) {
+  if (!isObject(object) || isEmptyObject(object)) {
+    if (currentPath.length > 0) {
+      yield stringifyPath(currentPath);
+    }
+    return;
+  }
+  for (const [key, value] of entries(object)) {
+    yield* deepKeysIterator(value, [...currentPath, key]);
+  }
+}
+__name$1(deepKeysIterator, "deepKeysIterator");
+function deepKeys(object) {
+  return [...deepKeysIterator(object)];
+}
+__name$1(deepKeys, "deepKeys");
+
+const isNode = typeof process.stdout < "u" && !process.versions?.deno && !globalThis.window;
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const PackageJsonFileCache = /* @__PURE__ */ new Map();
+const findPackageJson = /* @__PURE__ */ __name(async (cwd, options = {}) => {
+  const findUpConfig = {
+    type: "file"
+  };
+  if (cwd) {
+    findUpConfig.cwd = cwd;
+  }
+  const filePath = await fs.findUp("package.json", findUpConfig);
+  if (!filePath) {
+    throw new error.NotFoundError("No such file or directory, for package.json found.");
+  }
+  const cache = options.cache && typeof options.cache !== "boolean" ? options.cache : PackageJsonFileCache;
+  if (options.cache && cache.has(filePath)) {
+    return cache.get(filePath);
+  }
+  const packageJson = await fs.readJson(filePath);
+  normalizeData__default(packageJson);
+  const output = {
+    packageJson,
+    path: filePath
+  };
+  cache.set(filePath, output);
+  return output;
+}, "findPackageJson");
+const findPackageJsonSync = /* @__PURE__ */ __name((cwd, options = {}) => {
+  const findUpConfig = {
+    type: "file"
+  };
+  if (cwd) {
+    findUpConfig.cwd = cwd;
+  }
+  const filePath = fs.findUpSync("package.json", findUpConfig);
+  if (!filePath) {
+    throw new error.NotFoundError("No such file or directory, for package.json found.");
+  }
+  const cache = options.cache && typeof options.cache !== "boolean" ? options.cache : PackageJsonFileCache;
+  if (options.cache && cache.has(filePath)) {
+    return cache.get(filePath);
+  }
+  const packageJson = fs.readJsonSync(filePath);
+  normalizeData__default(packageJson);
+  const output = {
+    packageJson,
+    path: filePath
+  };
+  cache.set(filePath, output);
+  return output;
+}, "findPackageJsonSync");
+const writePackageJson = /* @__PURE__ */ __name(async (data, options = {}) => {
+  const { cwd, ...writeOptions } = options;
+  const directory = utils.toPath(options.cwd ?? process.cwd());
+  await fs.writeJson(path.join(directory, "package.json"), data, writeOptions);
+}, "writePackageJson");
+const writePackageJsonSync = /* @__PURE__ */ __name((data, options = {}) => {
+  const { cwd, ...writeOptions } = options;
+  const directory = utils.toPath(options.cwd ?? process.cwd());
+  fs.writeJsonSync(path.join(directory, "package.json"), data, writeOptions);
+}, "writePackageJsonSync");
+const parsePackageJson = /* @__PURE__ */ __name((packageFile) => {
+  const isObject = packageFile !== null && typeof packageFile === "object" && !Array.isArray(packageFile);
+  const isString = typeof packageFile === "string";
+  if (!isObject && !isString) {
+    throw new TypeError("`packageFile` should be either an `object` or a `string`.");
+  }
+  const json = isObject ? structuredClone(packageFile) : (
+    // eslint-disable-next-line security/detect-non-literal-fs-filename
+    node_fs.existsSync(packageFile) ? fs.readJsonSync(packageFile) : utils.parseJson(packageFile)
+  );
+  normalizeData__default(json);
+  return json;
+}, "parsePackageJson");
+const getPackageJsonProperty = /* @__PURE__ */ __name((packageJson, property, defaultValue) => getProperty(packageJson, property, defaultValue), "getPackageJsonProperty");
+const hasPackageJsonProperty = /* @__PURE__ */ __name((packageJson, property) => hasProperty(packageJson, property), "hasPackageJsonProperty");
+const hasPackageJsonAnyDependency = /* @__PURE__ */ __name((packageJson, arguments_, options) => {
+  const dependencies = getProperty(packageJson, "dependencies", {});
+  const devDependencies = getProperty(packageJson, "devDependencies", {});
+  const peerDependencies = getProperty(packageJson, "peerDependencies", {});
+  const allDependencies = { ...dependencies, ...devDependencies, ...options?.peerDeps === false ? {} : peerDependencies };
+  for (const argument of arguments_) {
+    if (hasProperty(allDependencies, argument)) {
+      return true;
+    }
+  }
+  return false;
+}, "hasPackageJsonAnyDependency");
+const ensurePackages = /* @__PURE__ */ __name(async (packageJson, packages, installKey = "dependencies", options = {}) => {
+  if (process.env.CI || isNode && !process.stdout?.isTTY) {
+    console.warn("Skipping package installation because the process is not interactive.");
+    return;
+  }
+  const dependencies = getProperty(packageJson, "dependencies", {});
+  const devDependencies = getProperty(packageJson, "devDependencies", {});
+  const peerDependencies = getProperty(packageJson, "peerDependencies", {});
+  const nonExistingPackages = [];
+  const config = {
+    deps: true,
+    devDeps: true,
+    peerDeps: false,
+    ...options
+  };
+  for (const packageName of packages) {
+    if (config.deps && hasProperty(dependencies, packageName) || config.devDeps && hasProperty(devDependencies, packageName) || config.peerDeps && hasProperty(peerDependencies, packageName)) {
+      continue;
+    }
+    nonExistingPackages.push(packageName);
+  }
+  if (typeof config.confirm?.message === "function") {
+    config.confirm.message = config.confirm.message(nonExistingPackages);
+  }
+  if (config.confirm?.message === undefined) {
+    const message = `${nonExistingPackages.length === 1 ? "Package is" : "Packages are"} required for this config: ${nonExistingPackages.join(", ")}. Do you want to install them?`;
+    if (config.confirm === undefined) {
+      config.confirm = {
+        message
+      };
+    } else {
+      config.confirm.message = message;
+    }
+  }
+  const answer = await confirm__default(config.confirm);
+  if (!answer) {
+    return;
+  }
+  await installPkg.installPackage(nonExistingPackages, {
+    ...config.installPackage,
+    cwd: config.cwd ? utils.toPath(config.cwd) : undefined,
+    dev: installKey === "devDependencies"
+  });
+}, "ensurePackages");
+
+exports.ensurePackages = ensurePackages;
+exports.findPackageJson = findPackageJson;
+exports.findPackageJsonSync = findPackageJsonSync;
+exports.getPackageJsonProperty = getPackageJsonProperty;
+exports.hasPackageJsonAnyDependency = hasPackageJsonAnyDependency;
+exports.hasPackageJsonProperty = hasPackageJsonProperty;
+exports.parsePackageJson = parsePackageJson;
+exports.writePackageJson = writePackageJson;
+exports.writePackageJsonSync = writePackageJsonSync;