@visulima/package 5.0.13 → 5.0.15

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## @visulima/package [5.0.15](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.14...%40visulima%2Fpackage%405.0.15) (2026-08-18)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 6.0.2
+
+## @visulima/package [5.0.14](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.13...%40visulima%2Fpackage%405.0.14) (2026-08-17)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 6.0.1
+
 ## @visulima/package [5.0.13](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.12...%40visulima%2Fpackage%405.0.13) (2026-08-17)
 
 ## @visulima/package [5.0.12](https://github.com/visulima/visulima/compare/%40visulima%2Fpackage%405.0.11...%40visulima%2Fpackage%405.0.12) (2026-08-08)

package/dist/index.d.ts

@@ -2,10 +2,11 @@ export { PackageNotFoundError } from "./error.js";
 export { type LockFileEntry, type LockFileIntegrity, type LockFileIntegrityAlgorithm, type LockFileParseResult, type LockFileType, decodeSriIntegrity, parseBunLockFile, parseLockFile, parseLockFileContent, parseLockFileSync, parseNpmLockFile, parsePnpmLockFile, parseYarnLockFile } from "./lockfile.js";
 export { type RootMonorepo, type Strategy, findMonorepoRoot, findMonorepoRootSync } from "./monorepo.js";
 export { findPackageRoot, findPackageRootSync } from "./package.js";
-export { type E as EnsurePackagesOptions, type F as FindPackageJsonCache, type N as NormalizedPackageJson, type a as NormalizedReadResult, type P as PackageJson, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-Ba7sjsO5.js";
+export { type E as EnsurePackagesOptions, type F as FindPackageJsonCache, type N as NormalizedPackageJson, type a as NormalizedReadResult, type P as PackageJson, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-XOvCk6yp.js";
 export { type PackageManager, type PackageManagerResult, findLockFile, findLockFileSync, findPackageManager, findPackageManagerSync, generateMissingPackagesInstallMessage, getPackageManagerVersion, identifyInitiatingPackageManager } from "./package-manager.js";
 export { type PnpmCatalog, type PnpmCatalogs, isPackageInWorkspace, readPnpmCatalogs, readPnpmCatalogsSync, resolveCatalogReference, resolveCatalogReferences, resolveDependenciesCatalogReferences } from "./pnpm.js";
 import '@visulima/fs';
 import '@antfu/install-pkg';
 import 'normalize-package-data';
 import "./packem_shared/json-value.d-AIF0oxA6.js";
+import 'tagged-tag';

package/dist/package-json.d.ts

@@ -1,5 +1,6 @@
 import '@visulima/fs';
-export { F as FindPackageJsonCache, a as NormalizedReadResult, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-Ba7sjsO5.js";
+export { F as FindPackageJsonCache, a as NormalizedReadResult, c as clearPackageJsonCache, e as ensurePackages, f as findPackageJson, b as findPackageJsonSync, g as getPackageJsonProperty, h as hasPackageJsonAnyDependency, d as hasPackageJsonProperty, p as parsePackageJson, i as parsePackageJsonSync, w as writePackageJson, j as writePackageJsonSync } from "./packem_shared/package-json.d-XOvCk6yp.js";
 import "./packem_shared/json-value.d-AIF0oxA6.js";
 import '@antfu/install-pkg';
 import 'normalize-package-data';
+import 'tagged-tag';

package/dist/package-json.js

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

package/dist/packem_shared/{package-json.d-Ba7sjsO5.d.ts → package-json.d-XOvCk6yp.d.ts}

@@ -2,6 +2,7 @@ import { WriteJsonOptions } from '@visulima/fs';
 import { InstallPackageOptions } from '@antfu/install-pkg';
 import { Package } from 'normalize-package-data';
 import { a as JsonValue, J as JsonObject } from "./json-value.d-AIF0oxA6.js";
+import tag from 'tagged-tag';
 /**
 Matches any [primitive value](https://developer.mozilla.org/en-US/docs/Glossary/Primitive).
 
@@ -363,16 +364,16 @@ An if-else-like type that resolves depending on whether the given type is `any`
 
 @example
 ```
-// When `T` is a NOT `any` or `never` (like `string`) => Returns `IfNotAnyOrNever` branch
-type A = IfNotAnyOrNever<string, 'VALID', 'IS_ANY', 'IS_NEVER'>;
+// When `T` is neither `any` nor `never` (like `string`) => Returns `IfNot` branch
+type A = IfNotAnyOrNever<string, {ifNot: 'VALID'; ifAny: 'IS_ANY'; ifNever: 'IS_NEVER'}>;
 //=> 'VALID'
 
 // When `T` is `any` => Returns `IfAny` branch
-type B = IfNotAnyOrNever<any, 'VALID', 'IS_ANY', 'IS_NEVER'>;
+type B = IfNotAnyOrNever<any, {ifNot: 'VALID'; ifAny: 'IS_ANY'; ifNever: 'IS_NEVER'}>;
 //=> 'IS_ANY'
 
 // When `T` is `never` => Returns `IfNever` branch
-type C = IfNotAnyOrNever<never, 'VALID', 'IS_ANY', 'IS_NEVER'>;
+type C = IfNotAnyOrNever<never, {ifNot: 'VALID'; ifAny: 'IS_ANY'; ifNever: 'IS_NEVER'}>;
 //=> 'IS_NEVER'
 ```
 
@@ -385,7 +386,7 @@ import type {StringRepeat} from 'type-fest';
 type NineHundredNinetyNineSpaces = StringRepeat<' ', 999>;
 
 // The following implementation is not tail recursive
-type TrimLeft<S extends string> = IfNotAnyOrNever<S, S extends ` ${infer R}` ? TrimLeft<R> : S>;
+type TrimLeft<S extends string> = IfNotAnyOrNever<S, {ifNot: S extends ` ${infer R}` ? TrimLeft<R> : S}>;
 
 // Hence, instantiations with long strings will fail
 // @ts-expect-error
@@ -394,7 +395,7 @@ type T1 = TrimLeft<NineHundredNinetyNineSpaces>;
 // Error: Type instantiation is excessively deep and possibly infinite.
 
 // To fix this, move the recursion into a helper type
-type TrimLeftOptimised<S extends string> = IfNotAnyOrNever<S, _TrimLeftOptimised<S>>;
+type TrimLeftOptimised<S extends string> = IfNotAnyOrNever<S, {ifNot: _TrimLeftOptimised<S>}>;
 
 type _TrimLeftOptimised<S extends string> = S extends ` ${infer R}` ? _TrimLeftOptimised<R> : S;
 
@@ -402,7 +403,11 @@ type T2 = TrimLeftOptimised<NineHundredNinetyNineSpaces>;
 //=> ''
 ```
 */
-type IfNotAnyOrNever<T, IfNotAnyOrNever, IfAny = any, IfNever = never> = If<IsAny<T>, IfAny, If<IsNever<T>, IfNever, IfNotAnyOrNever>>;
+type IfNotAnyOrNever<T, Cases extends {
+  ifNot: unknown;
+  ifAny?: unknown;
+  ifNever?: unknown;
+}> = IsAny<T> extends true ? 'ifAny' extends keyof Cases ? Cases['ifAny'] : any : IsNever<T> extends true ? 'ifNever' extends keyof Cases ? Cases['ifNever'] : never : Cases['ifNot'];
 /**
 Indicates the value of `exactOptionalPropertyTypes` compiler option.
 */
@@ -438,7 +443,9 @@ type B = CollapseRestElement<[string?, string?, ...number[]]>;
 //=> [string | undefined, string | undefined, number]
 ```
 */
-type CollapseRestElement<TArray extends UnknownArray> = IfNotAnyOrNever<TArray, _CollapseRestElement<TArray>>;
+type CollapseRestElement<TArray extends UnknownArray> = IfNotAnyOrNever<TArray, {
+  ifNot: _CollapseRestElement<TArray>;
+}>;
 type _CollapseRestElement<TArray extends UnknownArray, ForwardAccumulator extends UnknownArray = [], BackwardAccumulator extends UnknownArray = []> = TArray extends UnknownArray // For distributing `TArray`
  ? keyof TArray & `${number}` extends never ?
 // Enters this branch, if `TArray` is empty (e.g., []),
@@ -501,242 +508,250 @@ type ShouldBeTrue = IsNegative<-1>;
 @category Numeric
 */
 type IsNegative<T extends _Numeric> = T extends Negative<T> ? true : false;
+// eslint-disable-next-line type-fest/require-exported-types
+type TagContainer<Token> = {
+  readonly [tag]: Token;
+};
+type Tag<Token extends PropertyKey, TagMetadata> = TagContainer<{ [K in Token]: TagMetadata; }>;
 /**
-Create a tuple type of the specified length with elements of the specified type.
+Create a [tagged type](https://medium.com/@KevinBGreene/surviving-the-typescript-ecosystem-branding-and-type-tagging-6cf6e516523d) that can support [multiple tags](https://github.com/sindresorhus/type-fest/issues/665) and [per-tag metadata](https://medium.com/@ethanresnick/advanced-typescript-tagged-types-improved-with-type-level-metadata-5072fc125fcf).
 
-@example
-```
-import type {TupleOf} from 'type-fest';
+A type returned by `Tagged` can be passed to `Tagged` again, to create a type with multiple tags.
 
-type RGB = TupleOf<3, number>;
-//=> [number, number, number]
+A tag's name is usually a string (and must be a string, number, or symbol), but each application of a tag can also contain an arbitrary type as its "metadata". See {@link GetTagMetadata} for examples and explanation.
 
-type Line = TupleOf<2, {x: number; y: number}>;
-//=> [{x: number; y: number}, {x: number; y: number}]
+A type `A` returned by `Tagged` is assignable to another type `B` returned by `Tagged` if and only if:
+  - the underlying (untagged) type of `A` is assignable to the underlying type of `B`;
+	- `A` contains at least all the tags `B` has;
+	- and the metadata type for each of `A`'s tags is assignable to the metadata type of `B`'s corresponding tag.
 
-type TicTacToeBoard = TupleOf<3, TupleOf<3, 'X' | 'O' | null>>;
-//=> [['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null], ['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null], ['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null]]
-```
+There have been several discussions about adding similar features to TypeScript. Unfortunately, nothing has (yet) moved forward:
+	- [Microsoft/TypeScript#202](https://github.com/microsoft/TypeScript/issues/202)
+	- [Microsoft/TypeScript#4895](https://github.com/microsoft/TypeScript/issues/4895)
+	- [Microsoft/TypeScript#33290](https://github.com/microsoft/TypeScript/pull/33290)
 
 @example
 ```
-import type {TupleOf} from 'type-fest';
+import type {Tagged} from 'type-fest';
 
-type Range<Start extends number, End extends number> = Exclude<keyof TupleOf<End>, keyof TupleOf<Start>>;
+type AccountNumber = Tagged<number, 'AccountNumber'>;
+type AccountBalance = Tagged<number, 'AccountBalance'>;
 
-type ZeroToFour = Range<0, 5>;
-//=> '0' | '1' | '2' | '3' | '4'
+function createAccountNumber(): AccountNumber {
+	// As you can see, casting from a `number` (the underlying type being tagged) is allowed.
+	return 2 as AccountNumber;
+}
 
-type ThreeToEight = Range<3, 9>;
-//=> '3' | '4' | '5' | '6' | '7' | '8'
-```
+declare function getMoneyForAccount(accountNumber: AccountNumber): AccountBalance;
 
-Note: If the specified length is the non-literal `number` type, the result will not be a tuple but a regular array.
+// This will compile successfully.
+getMoneyForAccount(createAccountNumber());
 
-@example
-```
-import type {TupleOf} from 'type-fest';
+// But this won't, because it has to be explicitly passed as an `AccountNumber` type!
+// Critically, you could not accidentally use an `AccountBalance` as an `AccountNumber`.
+// @ts-expect-error
+getMoneyForAccount(2);
 
-type StringArray = TupleOf<number, string>;
-//=> string[]
+// You can also use tagged values like their underlying, untagged type.
+// I.e., this will compile successfully because an `AccountNumber` can be used as a regular `number`.
+// In this sense, the underlying base type is not hidden, which differentiates tagged types from opaque types in other languages.
+const accountNumber = createAccountNumber() + 2;
 ```
 
-Note: If the type for elements is not specified, it will default to `unknown`.
-
 @example
 ```
-import type {TupleOf} from 'type-fest';
+import type {Tagged} from 'type-fest';
 
-type UnknownTriplet = TupleOf<3>;
-//=> [unknown, unknown, unknown]
+// You can apply multiple tags to a type by using `Tagged` repeatedly.
+type Url = Tagged<string, 'URL'>;
+type SpecialCacheKey = Tagged<Url, 'SpecialCacheKey'>;
+
+// You can also pass a union of tag names, so this is equivalent to the above, although it doesn't give you the ability to assign distinct metadata to each tag.
+type SpecialCacheKey2 = Tagged<string, 'URL' | 'SpecialCacheKey'>;
 ```
 
-Note: If the specified length is negative, the result will be an empty tuple.
+@category Type
+*/
+type Tagged<Type, TagName extends PropertyKey, TagMetadata = never> = Type & Tag<TagName, TagMetadata>;
+/**
+Get the untagged portion of a tagged type created with `Tagged`.
+
+Why is this necessary?
+
+1. Use a `Tagged` type as object keys
+2. Prevent TS4058 error: "Return type of exported function has or is using name X from external module Y but cannot be named"
 
 @example
 ```
-import type {TupleOf} from 'type-fest';
+import type {Tagged, UnwrapTagged} from 'type-fest';
 
-type EmptyTuple = TupleOf<-3, string>;
-//=> []
-```
+type AccountType = Tagged<'SAVINGS' | 'CHECKING', 'AccountType'>;
 
-Note: If the specified length has a decimal part, the decimal part will be ignored.
+const moneyByAccountType: Record<UnwrapTagged<AccountType>, number> = {
+	SAVINGS: 99,
+	CHECKING: 0.1,
+};
 
-@example
-```
-import type {TupleOf} from 'type-fest';
+// Without UnwrapTagged, the following expression would throw a type error.
+const money = moneyByAccountType.SAVINGS; // TS error: Property 'SAVINGS' does not exist
 
-type DecimalLength = TupleOf<3.5, string>;
-//=> [string, string, string]
+// Attempting to pass a non-Tagged type to UnwrapTagged will raise a type error.
+// @ts-expect-error
+type WontWork = UnwrapTagged<string>;
 ```
 
-Note: If you need a readonly tuple, simply wrap this type with `Readonly`, for example, to create `readonly [number, number, number]` use `Readonly<TupleOf<3, number>>`.
-
-@category Array
+@category Type
 */
-type TupleOf<Length extends number, Fill = unknown> = IfNotAnyOrNever<Length, _TupleOf<If<IsNegative<Length>, 0, Length>, Fill>, Fill[], []>;
-type _TupleOf<Length extends number, Fill> = number extends Length ? Fill[] : BuildTupleDigitByDigit<`${Length}`, Fill>;
-type BuildTupleDigitByDigit<Length extends string, Fill, Accumulator extends UnknownArray = []> = Length extends `${infer First extends DigitCharacter}${infer Rest}` ? BuildTupleDigitByDigit<Rest, Fill, [...RepeatTupleTenTimes<Accumulator>, ...DigitTupleOf<First, Fill>]> : Accumulator;
-type RepeatTupleTenTimes<Tuple extends UnknownArray> = [...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple];
-type DigitTupleOf<Digit extends DigitCharacter, Fill> = [[], [Fill], [Fill, Fill], [Fill, Fill, Fill], [Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill]][Digit];
+type UnwrapTagged<TaggedType extends Tag<PropertyKey, any>> = RemoveAllTags<TaggedType>;
+type RemoveAllTags<T> = T extends Tag<PropertyKey, any> ? { [ThisTag in keyof T[typeof tag]]: T extends Tagged<infer Type, ThisTag, T[typeof tag][ThisTag]> ? RemoveAllTags<Type> : never; }[keyof T[typeof tag]] : T;
 /**
-Return a string representation of the given string or number.
+Returns a boolean for whether the given type is a `string` [literal type](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types).
 
-Note: This type is not the return type of the `.toString()` function.
-*/
-type ToString<T> = T extends string | number ? `${T}` : never;
-/**
-Converts a numeric string to a number.
+Useful for:
+	- providing strongly-typed string manipulation functions
+	- constraining strings to be a string literal
+	- type utilities, such as when constructing parsers and ASTs
+
+The implementation of this type is inspired by the trick mentioned in this [StackOverflow answer](https://stackoverflow.com/a/68261113/420747).
 
 @example
 ```
-type PositiveInt = StringToNumber<'1234'>;
-//=> 1234
+import type {IsStringLiteral} from 'type-fest';
 
-type NegativeInt = StringToNumber<'-1234'>;
-//=> -1234
+type CapitalizedString<T extends string> = IsStringLiteral<T> extends true ? Capitalize<T> : string;
 
-type PositiveFloat = StringToNumber<'1234.56'>;
-//=> 1234.56
-
-type NegativeFloat = StringToNumber<'-1234.56'>;
-//=> -1234.56
-
-type PositiveInfinity = StringToNumber<'Infinity'>;
-//=> Infinity
+// https://github.com/yankeeinlondon/native-dash/blob/master/src/capitalize.ts
+function capitalize<T extends Readonly<string>>(input: T): CapitalizedString<T> {
+	return (input.slice(0, 1).toUpperCase() + input.slice(1)) as CapitalizedString<T>;
+}
 
-type NegativeInfinity = StringToNumber<'-Infinity'>;
-//=> -Infinity
+const output = capitalize('hello, world!');
+//=> 'Hello, world!'
 ```
 
-@category String
-@category Numeric
-@category Template literal
-*/
-type StringToNumber<S extends string> = S extends `${infer N extends number}` ? N : S extends 'Infinity' ? PositiveInfinity : S extends '-Infinity' ? NegativeInfinity : never;
-/**
-Returns an array of the characters of the string.
-
 @example
 ```
-type A = StringToArray<'abcde'>;
-//=> ['a', 'b', 'c', 'd', 'e']
+// String types with infinite set of possible values return `false`.
 
-type B = StringToArray<string>;
-//=> never
-```
+import type {IsStringLiteral} from 'type-fest';
 
-@category String
-*/
-type StringToArray<S extends string, Result extends string[] = []> = string extends S ? never : S extends `${infer F}${infer R}` ? StringToArray<R, [...Result, F]> : Result;
-/**
-Returns the length of the given string.
+type AllUppercaseStrings = IsStringLiteral<Uppercase<string>>;
+//=> false
 
-@example
-```
-type A = StringLength<'abcde'>;
-//=> 5
+type StringsStartingWithOn = IsStringLiteral<`on${string}`>;
+//=> false
 
-type B = StringLength<string>;
-//=> never
+// This behaviour is particularly useful in string manipulation utilities, as infinite string types often require separate handling.
+
+type Length<S extends string, Counter extends never[] = []> =
+	IsStringLiteral<S> extends false
+		? number // return `number` for infinite string types
+		: S extends `${string}${infer Tail}`
+			? Length<Tail, [...Counter, never]>
+			: Counter['length'];
+
+type L1 = Length<Lowercase<string>>;
+//=> number
+
+type L2 = Length<`${number}`>;
+//=> number
 ```
 
-@category String
-@category Template literal
+@category Type Guard
+@category Utilities
 */
-type StringLength<S extends string> = string extends S ? never : StringToArray<S>['length'];
+type IsStringLiteral<S> = IfNotAnyOrNever<S, {
+  ifNot: _IsStringLiteral<CollapseLiterals<S extends TagContainer<any> ? UnwrapTagged<S> : S>>;
+  ifAny: false;
+  ifNever: false;
+}>;
+type _IsStringLiteral<S> =
+// If `T` is an infinite string type (e.g., `on${string}`), `Record<T, never>` produces an index signature,
+// and since `{}` extends index signatures, the result becomes `false`.
+S extends string ? {} extends Record<S, never> ? false : true : false;
 /**
-Returns a boolean for whether `A` represents a number greater than `B`, where `A` and `B` are both numeric strings and have the same length.
+Create a tuple type of the specified length with elements of the specified type.
 
 @example
 ```
-type A = SameLengthPositiveNumericStringGt<'50', '10'>;
-//=> true
+import type {TupleOf} from 'type-fest';
 
-type B = SameLengthPositiveNumericStringGt<'10', '10'>;
-//=> false
+type RGB = TupleOf<3, number>;
+//=> [number, number, number]
+
+type Line = TupleOf<2, {x: number; y: number}>;
+//=> [{x: number; y: number}, {x: number; y: number}]
+
+type TicTacToeBoard = TupleOf<3, TupleOf<3, 'X' | 'O' | null>>;
+//=> [['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null], ['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null], ['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null]]
 ```
-*/
-type SameLengthPositiveNumericStringGt<A extends string, B extends string> = A extends `${infer FirstA}${infer RestA}` ? B extends `${infer FirstB}${infer RestB}` ? FirstA extends FirstB ? SameLengthPositiveNumericStringGt<RestA, RestB> : PositiveNumericCharacterGt<FirstA, FirstB> : never : false;
-type NumericString = '0123456789';
-/**
-Returns a boolean for whether `A` is greater than `B`, where `A` and `B` are both positive numeric strings.
 
 @example
 ```
-type A = PositiveNumericStringGt<'500', '1'>;
-//=> true
+import type {TupleOf} from 'type-fest';
 
-type B = PositiveNumericStringGt<'1', '1'>;
-//=> false
+type Range<Start extends number, End extends number> = Exclude<keyof TupleOf<End>, keyof TupleOf<Start>>;
 
-type C = PositiveNumericStringGt<'1', '500'>;
-//=> false
+type ZeroToFour = Range<0, 5>;
+//=> '0' | '1' | '2' | '3' | '4'
+
+type ThreeToEight = Range<3, 9>;
+//=> '3' | '4' | '5' | '6' | '7' | '8'
 ```
-*/
-type PositiveNumericStringGt<A extends string, B extends string> = A extends B ? false : [TupleOf<StringLength<A>, 0>, TupleOf<StringLength<B>, 0>] extends (infer R extends [readonly unknown[], readonly unknown[]]) ? R[0] extends [...R[1], ...infer Remain extends readonly unknown[]] ? 0 extends Remain['length'] ? SameLengthPositiveNumericStringGt<A, B> : true : false : never;
-/**
-Returns a boolean for whether `A` represents a number greater than `B`, where `A` and `B` are both positive numeric characters.
+
+Note: If the specified length is the non-literal `number` type, the result will not be a tuple but a regular array.
 
 @example
 ```
-type A = PositiveNumericCharacterGt<'5', '1'>;
-//=> true
+import type {TupleOf} from 'type-fest';
 
-type B = PositiveNumericCharacterGt<'1', '1'>;
-//=> false
+type StringArray = TupleOf<number, string>;
+//=> string[]
 ```
-*/
-type PositiveNumericCharacterGt<A extends string, B extends string> = NumericString extends `${infer HeadA}${A}${infer TailA}` ? NumericString extends `${infer HeadB}${B}${infer TailB}` ? HeadA extends `${HeadB}${infer _}${infer __}` ? true : false : never : never;
-/**
-Check whether the given type is a number or a number string.
 
-Supports floating-point as a string.
+Note: If the type for elements is not specified, it will default to `unknown`.
 
 @example
 ```
-type A = IsNumberLike<'1'>;
-//=> true
+import type {TupleOf} from 'type-fest';
 
-type B = IsNumberLike<'-1.1'>;
-//=> true
+type UnknownTriplet = TupleOf<3>;
+//=> [unknown, unknown, unknown]
+```
 
-type C = IsNumberLike<'5e-20'>;
-//=> true
+Note: If the specified length is negative, the result will be an empty tuple.
 
-type D = IsNumberLike<1>;
-//=> true
+@example
+```
+import type {TupleOf} from 'type-fest';
 
-type E = IsNumberLike<'a'>;
-//=> false
-*/
-type IsNumberLike<N> = IfNotAnyOrNever<N, N extends number | `${number}` ? true : false, boolean, false>;
-/**
-Returns the number with reversed sign.
+type EmptyTuple = TupleOf<-3, string>;
+//=> []
+```
+
+Note: If the specified length has a decimal part, the decimal part will be ignored.
 
 @example
 ```
-type A = ReverseSign<-1>;
-//=> 1
+import type {TupleOf} from 'type-fest';
 
-type B = ReverseSign<1>;
-//=> -1
+type DecimalLength = TupleOf<3.5, string>;
+//=> [string, string, string]
+```
 
-type C = ReverseSign<NegativeInfinity>;
-//=> PositiveInfinity
+Note: If you need a readonly tuple, simply wrap this type with `Readonly`, for example, to create `readonly [number, number, number]` use `Readonly<TupleOf<3, number>>`.
 
-type D = ReverseSign<PositiveInfinity>;
-//=> NegativeInfinity
-```
+@category Array
 */
-type ReverseSign<N extends number> =
-// Handle edge cases
-N extends 0 ? 0 : N extends PositiveInfinity ? NegativeInfinity : N extends NegativeInfinity ? PositiveInfinity :
-// Handle negative numbers
-`${N}` extends `-${infer P extends number}` ? P :
-// Handle positive numbers
-`-${N}` extends `${infer R extends number}` ? R : never;
+type TupleOf<Length extends number, Fill = unknown> = IfNotAnyOrNever<Length, {
+  ifNot: _TupleOf<If<IsNegative<Length>, 0, Length>, Fill>;
+  ifAny: Fill[];
+  ifNever: [];
+}>;
+type _TupleOf<Length extends number, Fill> = number extends Length ? Fill[] : BuildTupleDigitByDigit<`${Length}`, Fill>;
+type BuildTupleDigitByDigit<Length extends string, Fill, Accumulator extends UnknownArray = []> = Length extends `${infer First extends DigitCharacter}${infer Rest}` ? BuildTupleDigitByDigit<Rest, Fill, [...RepeatTupleTenTimes<Accumulator>, ...DigitTupleOf<First, Fill>]> : Accumulator;
+type RepeatTupleTenTimes<Tuple extends UnknownArray> = [...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple];
+type DigitTupleOf<Digit extends DigitCharacter, Fill> = [[], [Fill], [Fill, Fill], [Fill, Fill, Fill], [Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill]][Digit];
 /**
 Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.
 
@@ -1033,6 +1048,57 @@ type Merge<Destination, Source> = Destination extends unknown // For distributin
  : never; // Should never happen
 type _Merge<Destination, Source> = Simplify<SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>> & SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>>;
 /**
+Converts a numeric string to a number.
+
+@example
+```
+import type {StringToNumber} from 'type-fest';
+
+type PositiveInteger = StringToNumber<'1234'>;
+//=> 1234
+
+type NegativeInteger = StringToNumber<'-1234'>;
+//=> -1234
+
+type PositiveFloat = StringToNumber<'1234.56'>;
+//=> 1234.56
+
+type NegativeFloat = StringToNumber<'-1234.56'>;
+//=> -1234.56
+
+type PositiveInfinity = StringToNumber<'Infinity'>;
+//=> Infinity
+
+type NegativeInfinity = StringToNumber<'-Infinity'>;
+//=> -Infinity
+```
+
+Note: Some strings, such as `'1.50'`, `'0b10'`, or `'12_345'`, may look like they can be converted to numbers, but they don't actually have corresponding numeric literals. So, in such cases, this type produces `never`. See [type-fest#1446](https://github.com/sindresorhus/type-fest/pull/1446) for more details.
+
+@example
+```
+import type {StringToNumber} from 'type-fest';
+
+type FractionalsEndingInZero = StringToNumber<'1.50'>;
+//=> never
+
+type NonDecimalBases = StringToNumber<'0b10' | '0o10' | '0x10'>;
+//=> never
+
+type NumericSeparators = StringToNumber<'12_345'>;
+//=> never
+```
+
+@category String
+@category Numeric
+@category Template literal
+*/
+type StringToNumber<S extends string> = IfNotAnyOrNever<S, {
+  ifNot: _StringToNumber<S>;
+  ifAny: number;
+}>;
+type _StringToNumber<S extends string> = S extends `${infer N extends number}` ? number extends N ? `${number}` extends S ? N : never : N : string extends S ? number : S extends 'Infinity' ? PositiveInfinity : S extends '-Infinity' ? NegativeInfinity : never;
+/**
 Merges user specified options with default options.
 
 @example
@@ -1088,6 +1154,34 @@ type ApplyDefaultOptions<Options extends object, Defaults extends Simplify<Omit<
 ) ? Result : never;
 type _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> = If<IsAny<SpecifiedOptions>, Defaults, If<IsNever<SpecifiedOptions>, Defaults, Merge<Defaults, { [Key in keyof SpecifiedOptions as undefined extends Required<Options>[Key & keyof Options] ? Key : undefined extends SpecifiedOptions[Key] ? never : Key]: SpecifiedOptions[Key]; }>>>;
 /**
+Collapses literal types in a union into their corresponding primitive types, when possible. For example, `CollapseLiterals<'foo' | 'bar' | (string & {})>` returns `string`.
+
+Note: This doesn't collapse literals within tagged types. For example, `CollapseLiterals<Tagged<'foo' | (string & {}), 'Tag'>>` returns `("foo" & Tag<"Tag", never>) | (string & Tag<"Tag", never>)` and not `string & Tag<"Tag", never>`.
+
+Use-case: For collapsing unions created using {@link LiteralUnion}.
+
+@example
+```
+import type {LiteralUnion} from 'type-fest';
+
+type A = CollapseLiterals<'foo' | 'bar' | (string & {})>;
+//=> string
+
+type B = CollapseLiterals<LiteralUnion<1 | 2 | 3, number>>;
+//=> number
+
+type C = CollapseLiterals<LiteralUnion<'onClick' | 'onChange', `on${string}`>>;
+//=> `on${string}`
+
+type D = CollapseLiterals<'click' | 'change' | (`on${string}` & {})>;
+//=> 'click' | 'change' | `on${string}`
+
+type E = CollapseLiterals<LiteralUnion<'foo' | 'bar', string> | null | undefined>;
+//=> string | null | undefined
+```
+*/
+type CollapseLiterals<T> = {} extends T ? T : T extends (infer U) & {} ? U : T;
+/**
 @see {@link SomeExtend}
 */
 type SomeExtendOptions = {
@@ -1174,9 +1268,13 @@ type B = SomeExtend<[1?, 2?, '3'?], string | undefined>;
 @category Array
 */
 type SomeExtend<TArray extends UnknownArray, Type, Options extends SomeExtendOptions = {}> = _SomeExtend<CollapseRestElement<TArray>, Type, ApplyDefaultOptions<SomeExtendOptions, DefaultSomeExtendOptions, Options>>;
-type _SomeExtend<TArray extends UnknownArray, Type, Options extends Required<SomeExtendOptions>> = IfNotAnyOrNever<TArray, TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true ?
-// If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, return `true`.
-true : _SomeExtend<Rest, Type, Options> : First extends Type ? true : _SomeExtend<Rest, Type, Options> : false, false, false>;
+type _SomeExtend<TArray extends UnknownArray, Type, Options extends Required<SomeExtendOptions>> = IfNotAnyOrNever<TArray, {
+  ifNot: TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true ?
+  // If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, return `true`.
+  true : _SomeExtend<Rest, Type, Options> : First extends Type ? true : _SomeExtend<Rest, Type, Options> : false;
+  ifAny: false;
+  ifNever: false;
+}>;
 /**
 Returns a boolean for whether any of the given elements is `true`.
 
@@ -1325,6 +1423,215 @@ type G = Or<never, never>;
 */
 type Or<A extends boolean, B extends boolean> = OrAll<[A, B]>;
 /**
+@see {@link StringToArray}
+*/
+type StringToArrayOptions = {
+  /**
+	When enabled, non-literal parts of the string (e.g., `string`, `Uppercase<string>`) are mapped as single elements instead of being mapped as a rest element.
+
+	Note: Enabling this option can produce misleading results that might not reflect the actual runtime behavior.
+	For example, `StringToArray<string, {mapNonLiteralsDirectly: true}>` returns `[string]`, but at runtime, the string could be `'abc'` (which satisfies `string`), and converting it to an array would result in `['a', 'b', 'c']`, which doesn't satisfy `[string]`.
+
+	So, it is recommended to not enable this option unless you are aware of the implications.
+
+	@default false
+
+	@example
+	```
+	import type {StringToArray} from 'type-fest';
+
+	type A = StringToArray<string, {mapNonLiteralsDirectly: false}>;
+	//=> string[]
+
+	type B = StringToArray<string, {mapNonLiteralsDirectly: true}>;
+	//=> [string]
+
+	type C = StringToArray<`on${string}`, {mapNonLiteralsDirectly: false}>;
+	//=> ['o', 'n', ...string[]]
+
+	type D = StringToArray<`on${string}`, {mapNonLiteralsDirectly: true}>;
+	//=> ['o', 'n', string]
+
+	type E = StringToArray<`${string}xyz`, {mapNonLiteralsDirectly: false}>;
+	//=> [...string[], 'x', 'y', 'z']
+
+	type F = StringToArray<`${string}xyz`, {mapNonLiteralsDirectly: true}>;
+	//=> [string, 'x', 'y', 'z']
+	```
+	*/
+  mapNonLiteralsDirectly?: boolean;
+};
+type DefaultStringToArrayOptions = {
+  mapNonLiteralsDirectly: false;
+};
+/**
+Returns an array of the characters of the specified string.
+
+@example
+```
+import type {StringToArray} from 'type-fest';
+
+type A = StringToArray<'abcde'>;
+//=> ['a', 'b', 'c', 'd', 'e']
+
+type B = StringToArray<''>;
+//=> []
+
+type C = StringToArray<string>;
+//=> string[]
+
+type D = StringToArray<`foo${string}bar`>;
+//=> ['f', 'o', 'o', ...string[], 'b', 'a', 'r']
+
+type E = StringToArray<`foo${string}bar`, {mapNonLiteralsDirectly: true}>;
+//=> ['f', 'o', 'o', string, 'b', 'a', 'r']
+```
+
+@see {@link StringToArrayOptions}
+
+@category String
+*/
+type StringToArray<S extends string, Options extends StringToArrayOptions = {}> = IfNotAnyOrNever<S, {
+  ifNot: _StringToArray<S, ApplyDefaultOptions<StringToArrayOptions, DefaultStringToArrayOptions, Options>>;
+  ifAny: unknown[];
+}>;
+type _StringToArray<S extends string, Options extends Required<StringToArrayOptions>, Accumulator extends string[] = []> = S extends `${infer First}${infer Rest}` ? Or<IsStringLiteral<First>, Options['mapNonLiteralsDirectly']> extends true ? _StringToArray<Rest, Options, [...Accumulator, First]> : _StringToArray<Rest, Options, [...Accumulator, ...First[]]> : S extends '' ? Accumulator : Options['mapNonLiteralsDirectly'] extends true ? [...Accumulator, S] : [...Accumulator, ...S[]];
+/**
+Returns the length of the given string.
+
+@example
+```
+import type {StringLength} from 'type-fest';
+
+type A = StringLength<'abcde'>;
+//=> 5
+
+type B = StringLength<'abcde' | 'fgh'>;
+//=> 3 | 5
+```
+
+For non-literal strings, the result is `number` because the length of a non-literal string can be any number.
+
+@example
+```
+import type {StringLength} from 'type-fest';
+
+type A = StringLength<string>;
+//=> number
+
+type B = StringLength<Uppercase<string>>;
+//=> number
+
+type C = StringLength<`${string}abc`>;
+//=> number
+```
+
+@category String
+@category Template literal
+*/
+type StringLength<S extends string> = StringToArray<S>['length'];
+/**
+Return a string representation of the given string or number.
+
+Note: This type is not the return type of the `.toString()` function.
+*/
+type ToString<T> = T extends string | number ? `${T}` : never;
+/**
+Returns a boolean for whether `A` represents a number greater than `B`, where `A` and `B` are both numeric strings and have the same length.
+
+@example
+```
+type A = SameLengthPositiveNumericStringGt<'50', '10'>;
+//=> true
+
+type B = SameLengthPositiveNumericStringGt<'10', '10'>;
+//=> false
+```
+*/
+type SameLengthPositiveNumericStringGt<A extends string, B extends string> = A extends `${infer FirstA}${infer RestA}` ? B extends `${infer FirstB}${infer RestB}` ? FirstA extends FirstB ? SameLengthPositiveNumericStringGt<RestA, RestB> : PositiveNumericCharacterGt<FirstA, FirstB> : never : false;
+type NumericString = '0123456789';
+/**
+Returns a boolean for whether `A` is greater than `B`, where `A` and `B` are both positive numeric strings.
+
+@example
+```
+type A = PositiveNumericStringGt<'500', '1'>;
+//=> true
+
+type B = PositiveNumericStringGt<'1', '1'>;
+//=> false
+
+type C = PositiveNumericStringGt<'1', '500'>;
+//=> false
+```
+*/
+type PositiveNumericStringGt<A extends string, B extends string> = A extends B ? false : [TupleOf<StringLength<A>, 0>, TupleOf<StringLength<B>, 0>] extends (infer R extends [readonly unknown[], readonly unknown[]]) ? R[0] extends [...R[1], ...infer Remain extends readonly unknown[]] ? 0 extends Remain['length'] ? SameLengthPositiveNumericStringGt<A, B> : true : false : never;
+/**
+Returns a boolean for whether `A` represents a number greater than `B`, where `A` and `B` are both positive numeric characters.
+
+@example
+```
+type A = PositiveNumericCharacterGt<'5', '1'>;
+//=> true
+
+type B = PositiveNumericCharacterGt<'1', '1'>;
+//=> false
+```
+*/
+type PositiveNumericCharacterGt<A extends string, B extends string> = NumericString extends `${infer HeadA}${A}${infer TailA}` ? NumericString extends `${infer HeadB}${B}${infer TailB}` ? HeadA extends `${HeadB}${infer _}${infer __}` ? true : false : never : never;
+/**
+Check whether the given type is a number or a number string.
+
+Supports floating-point as a string.
+
+@example
+```
+type A = IsNumberLike<'1'>;
+//=> true
+
+type B = IsNumberLike<'-1.1'>;
+//=> true
+
+type C = IsNumberLike<'5e-20'>;
+//=> true
+
+type D = IsNumberLike<1>;
+//=> true
+
+type E = IsNumberLike<'a'>;
+//=> false
+*/
+type IsNumberLike<N> = IfNotAnyOrNever<N, {
+  ifNot: N extends number | `${number}` ? true : false;
+  ifAny: boolean;
+  ifNever: false;
+}>;
+/**
+Returns the number with reversed sign.
+
+@example
+```
+type A = ReverseSign<-1>;
+//=> 1
+
+type B = ReverseSign<1>;
+//=> -1
+
+type C = ReverseSign<NegativeInfinity>;
+//=> PositiveInfinity
+
+type D = ReverseSign<PositiveInfinity>;
+//=> NegativeInfinity
+```
+*/
+type ReverseSign<N extends number> =
+// Handle edge cases
+N extends 0 ? 0 : N extends PositiveInfinity ? NegativeInfinity : N extends NegativeInfinity ? PositiveInfinity :
+// Handle negative numbers
+`${N}` extends `-${infer P extends number}` ? P :
+// Handle positive numbers
+`-${N}` extends `${infer R extends number}` ? R : never;
+/**
 @see {@link AllExtend}
 */
 type AllExtendOptions = {
@@ -1417,9 +1724,13 @@ type B = AllExtend<[1?, 2?, 3?], number | undefined>;
 @category Array
 */
 type AllExtend<TArray extends UnknownArray, Type, Options extends AllExtendOptions = {}> = _AllExtend<CollapseRestElement<TArray>, Type, ApplyDefaultOptions<AllExtendOptions, DefaultAllExtendOptions, Options>>;
-type _AllExtend<TArray extends UnknownArray, Type, Options extends Required<AllExtendOptions>> = IfNotAnyOrNever<TArray, TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true ?
-// If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, recurse further.
-_AllExtend<Rest, Type, Options> : false : First extends Type ? _AllExtend<Rest, Type, Options> : false : true, false, false>;
+type _AllExtend<TArray extends UnknownArray, Type, Options extends Required<AllExtendOptions>> = IfNotAnyOrNever<TArray, {
+  ifNot: TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true ?
+  // If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, recurse further.
+  _AllExtend<Rest, Type, Options> : false : First extends Type ? _AllExtend<Rest, Type, Options> : false : true;
+  ifAny: false;
+  ifNever: false;
+}>;
 /**
 Returns a boolean for whether all of the given elements are `true`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/package",
-  "version": "5.0.13",
+  "version": "5.0.15",
   "description": "A comprehensive package management utility that helps you find root directories, monorepos, package managers, and parse package.json, package.yaml, and package.json5 files with advanced features like catalog resolution.",
   "keywords": [
     "anolilab",
@@ -99,8 +99,8 @@
     "MIGRATION-GUIDE.md"
   ],
   "dependencies": {
-    "@antfu/install-pkg": "^1.1.0",
-    "@visulima/fs": "6.0.0",
+    "@antfu/install-pkg": "^2.0.1",
+    "@visulima/fs": "6.0.2",
     "@visulima/path": "4.0.0",
     "json5": "^2.2.3",
     "normalize-package-data": "^9.0.0",