@visulima/fs 5.0.0-alpha.9 → 5.0.1

package/dist/packem_shared/walk-OX4-6oCP.js

@@ -0,0 +1 @@
+import{createRequire as x}from"node:module";import{resolve as $,join as q,normalize as P,basename as z}from"@visulima/path";import{toPath as B}from"@visulima/path/utils";import D from"./WalkError-B8qTd-v-.js";import E from"./assertValidFileOrDirectoryPath-BTlt945W.js";import{a as S,s as m,l as p}from"./walk-include-BXhGSn6t.js";const F=x(import.meta.url),l=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,T=e=>{if(typeof l<"u"&&l.versions&&l.versions.node){const[t,o]=l.versions.node.split(".").map(Number);if(t>22||t===22&&o>=3||t===20&&o>=16)return l.getBuiltinModule(e)}return F(e)},{readdir:I,realpath:N,stat:j}=T("node:fs/promises"),M=async e=>{const t=P(e),o=z(t),r=await j(t);return p(r,o,t)};async function*R(e,t={}){const{extensions:o,followSymlinks:r=!1,includeDirs:y=!0,includeFiles:h=!0,includeSymlinks:_=!0,match:w,maxDepth:f=Number.POSITIVE_INFINITY,skip:v}=t;if(E(e),f<0)return;const u=t.visited??new Set,c=w?w.map(i=>typeof i=="string"?S(i):i):void 0,a=v?v.map(i=>typeof i=="string"?S(i):i):void 0;if(e=$(B(e)),y&&m(e,o,c,a)&&(yield await M(e)),!(f<1||!m(e,void 0,void 0,a)))try{const i=await I(e,{withFileTypes:!0});for(const s of i){let n=q(e,s.name),g=s.isDirectory(),k=s.isFile();if(s.isSymbolicLink())if(r){const d=await N(n);if(u.has(d))continue;n=d;const b=await j(d);g=b.isDirectory(),k=b.isFile()}else if(_&&m(n,o,c,a)){yield p(s,s.name,n);continue}else continue;g?(r&&u.add(n),yield*R(n,{extensions:o,followSymlinks:r,includeDirs:y,includeFiles:h,includeSymlinks:_,match:c,maxDepth:f-1,skip:a,visited:u})):k&&h&&m(n,o,c,a)&&(yield p(s,s.name,n))}}catch(i){throw i instanceof D?i:new D(i,e)}}export{R as default};

package/dist/packem_shared/walk-include-BXhGSn6t.js

@@ -0,0 +1 @@
+const i=e=>{const r=e.replace(/[$()+\\^]/g,String.raw`\$&`).replace(/\.\*/g,".([^/]*)").replace(/\*\*/g,"(.*)").replace(/(?<!\.)\*(?!\*)/g,"([^/]*)").replace(/\?/g,"[^/]").replace(/\.(?!\*)/g,String.raw`\.`).replace(/\{/g,"(").replace(/\}/g,")").replace(/,/g,"|").replace(/\[!(.*?)\]/g,"[^$1]");try{return new RegExp(`^${r}$`)}catch(t){throw new Error(`Invalid glob pattern: ${e}`,{cause:t})}};class c{name;path;#e;constructor(r,t,n){this.#e=r,this.name=t,this.path=n}isDirectory(){return this.#e.isDirectory()}isFile(){return this.#e.isFile()}isSymbolicLink(){return this.#e.isSymbolicLink()}}const l=(e,r,t)=>new c(e,r,t),o=(e,r,t,n)=>{if(Array.isArray(r)&&r.length>0&&!r.some(s=>e.endsWith(s)))return!1;const a=e.includes("\\")?e.replaceAll("\\","/"):e;return t&&!t.some(s=>s.test(a))?!1:!n?.some(s=>s.test(a))};export{i as a,l,o as s};

package/dist/packem_shared/walkSync-BPs6czIM.js

@@ -0,0 +1 @@
+import{createRequire as T}from"node:module";import{resolve as P,join as $,normalize as p,basename as z}from"@visulima/path";import{toPath as B}from"@visulima/path/utils";import F from"./WalkError-B8qTd-v-.js";import E from"./assertValidFileOrDirectoryPath-BTlt945W.js";import{a as j,s as m,l as y}from"./walk-include-BXhGSn6t.js";const x=T(import.meta.url),c=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,I=e=>{if(typeof c<"u"&&c.versions&&c.versions.node){const[o,t]=c.versions.node.split(".").map(Number);if(o>22||o===22&&t>=3||o===20&&t>=16)return c.getBuiltinModule(e)}return x(e)},{readdirSync:N,realpathSync:q,statSync:w}=I("node:fs"),M=e=>{const o=p(e),t=w(o);return y(t,z(o),o)};function*R(e,o={}){const{extensions:t,followSymlinks:a=!1,includeDirs:h=!0,includeFiles:_=!0,includeSymlinks:S=!0,match:v,maxDepth:f=Number.POSITIVE_INFINITY,skip:g}=o;if(E(e),f<0)return;const d=o.visited??new Set,l=v?v.map(i=>typeof i=="string"?j(i):i):void 0,r=g?g.map(i=>typeof i=="string"?j(i):i):void 0;if(e=P(B(e)),h&&m(e,t,l,r)&&(yield M(e)),!(f<1||!m(e,void 0,void 0,r)))try{const i=N(e,{withFileTypes:!0});for(const n of i){let s=$(e,n.name),k=n.isDirectory(),b=n.isFile();if(n.isSymbolicLink())if(a){const u=q(s);if(d.has(u))continue;s=u;const D=w(u);k=D.isDirectory(),b=D.isFile()}else if(S&&m(s,t,l,r)){yield y(n,n.name,p(s));continue}else continue;k?(a&&d.add(s),yield*R(s,{extensions:t,followSymlinks:a,includeDirs:h,includeFiles:_,includeSymlinks:S,match:l,maxDepth:f-1,skip:r,visited:d})):b&&_&&m(s,t,l,r)&&(yield y(n,n.name,p(s)))}}catch(i){throw i instanceof F?i:new F(i,e)}}export{R as default};

package/dist/packem_shared/writeFile-BrMtsJY7.js

@@ -0,0 +1 @@
+import{createRequire as f}from"node:module";import{dirname as _}from"@visulima/path";import{toPath as y}from"@visulima/path/utils";import{F_OK as v}from"./FIND_UP_STOP-CAwY1qU7.js";import b from"./AlreadyExistsError-DEb3UWja.js";import c from"./isAccessible-PmWJhV6I.js";import j from"./assertValidFileContents-CbIN7sy7.js";import k from"./assertValidFileOrDirectoryPath-BTlt945W.js";import{o as q,i as x}from"./to-uint-8-array-BImOQNXm.js";const m=f(import.meta.url),a=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,u=i=>{if(typeof a<"u"&&a.versions&&a.versions.node){const[e,o]=a.versions.node.split(".").map(Number);if(e>22||e===22&&o>=3||e===20&&o>=16)return a.getBuiltinModule(i)}return m(i)},{mkdir:d,writeFile:w,stat:l,rename:n,chown:p,chmod:g,unlink:h}=u("node:fs/promises"),O=async(i,e,o)=>{o={backup:!1,encoding:"utf8",flag:"w",overwrite:!0,recursive:!0,...o},k(i),j(e),i=y(i);const s=await c(i,v);if(s&&!o.overwrite)throw new b(`file already exists, open '${i}'`);const r=q(i);try{!s&&o.recursive&&await d(_(i),{recursive:!0});let t;if(await w(r,typeof e=="string"?Buffer.from(e,o.encoding??"utf8"):x(e),{flag:"wx"}),s&&o.backup&&(t=await l(i),o.chown??={gid:t.gid,uid:t.uid},await n(i,`${i}.bak`)),o.chown)try{await p(r,o.chown.uid,o.chown.gid)}catch{}await g(r,t&&!o.mode?t.mode:o.mode??438),await n(r,i)}catch(t){throw new Error(`Failed to write file at: ${i} - ${t.message}`,{cause:t})}finally{await c(r)&&await h(r)}};export{O as default};

package/dist/packem_shared/writeFileSync-W7Mf4BNy.js

@@ -0,0 +1 @@
+import{createRequire as m}from"node:module";import{dirname as h}from"@visulima/path";import{toPath as _}from"@visulima/path/utils";import{F_OK as v}from"./FIND_UP_STOP-CAwY1qU7.js";import b from"./AlreadyExistsError-DEb3UWja.js";import f from"./isAccessibleSync-BrbOtwdr.js";import S from"./assertValidFileContents-CbIN7sy7.js";import j from"./assertValidFileOrDirectoryPath-BTlt945W.js";import{o as k,i as q}from"./to-uint-8-array-BImOQNXm.js";const a=m(import.meta.url),n=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,u=e=>{if(typeof n<"u"&&n.versions&&n.versions.node){const[i,o]=n.versions.node.split(".").map(Number);if(i>22||i===22&&o>=3||i===20&&o>=16)return n.getBuiltinModule(e)}return a(e)},{mkdirSync:d,writeFileSync:l,statSync:p,renameSync:s,chownSync:g,chmodSync:w,unlinkSync:y}=u("node:fs"),K=(e,i,o)=>{o={backup:!1,encoding:"utf8",flag:"w",overwrite:!0,recursive:!0,...o},j(e),S(i),e=_(e);const c=f(e,v);if(c&&!o.overwrite)throw new b(`file already exists, open '${e}'`);const r=k(e);try{!c&&o.recursive&&d(h(e),{recursive:!0});let t;if(l(r,typeof i=="string"?Buffer.from(i,o.encoding??"utf8"):q(i),{flag:"wx"}),c&&o.backup&&(t=p(e),o.chown??={gid:t.gid,uid:t.uid},s(e,`${e}.bak`)),o.chown)try{g(r,o.chown.uid,o.chown.gid)}catch{}w(r,t&&!o.mode?t.mode:o.mode??438),s(r,e)}catch(t){throw new Error(`Failed to write file at: ${e} - ${t.message}`,{cause:t})}finally{f(r)&&y(r)}};export{K as default};

package/dist/packem_shared/writeIni-BWX3cP1K.js

@@ -0,0 +1,4 @@
+import{createRequire as A}from"node:module";import{parse as I,stringify as N}from"ini";import{R_OK as O}from"./FIND_UP_STOP-CAwY1qU7.js";import R from"./isAccessible-PmWJhV6I.js";import{d as B,m as L}from"./ini-preserve-D1DopDLd.js";import M from"./writeFile-BrMtsJY7.js";const E=A(import.meta.url),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,T=r=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[t,n]=i.versions.node.split(".").map(Number);if(t>22||t===22&&n>=3||t===20&&n>=16)return i.getBuiltinModule(r)}return E(r)},{readFile:q}=T("node:fs/promises"),C=async(r,t,n={})=>{const{eol:g,preserveStyle:_=!0,whitespace:y,...w}=n,{align:h,bracketedArray:l,newline:b,platform:v,section:p,sort:j,...k}=w;let a=g,f=y,o,c;if(_&&await R(r,O))try{o=await q(r,"utf8"),c=I(o,{bracketedArray:l??!0});const e=B(o);a??=e.eol,f??=e.whitespace}catch(e){if(e.code!=="ENOENT")throw e}const m={align:h,bracketedArray:l,newline:b,platform:v,section:p,sort:j,whitespace:f},d=(e,u)=>N(e,u===void 0?m:{...m,section:u});let s;o!==void 0&&c?s=L(o,c,t,d,{eol:a??`
+`}):(s=d(t,p),a===`\r
+`&&(s=s.replaceAll(/\r?\n/g,`\r
+`))),await M(r,s,k)};export{C as default};

package/dist/packem_shared/writeIniSync-fOdgPFfL.js

@@ -0,0 +1,4 @@
+import{createRequire as S}from"node:module";import{parse as E,stringify as I}from"ini";import{R_OK as N}from"./FIND_UP_STOP-CAwY1qU7.js";import O from"./isAccessibleSync-BrbOtwdr.js";import{d as R,m as B}from"./ini-preserve-D1DopDLd.js";import L from"./writeFileSync-W7Mf4BNy.js";const T=S(import.meta.url),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,k=r=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[t,n]=i.versions.node.split(".").map(Number);if(t>22||t===22&&n>=3||t===20&&n>=16)return i.getBuiltinModule(r)}return T(r)},{readFileSync:q}=k("node:fs"),C=(r,t,n={})=>{const{eol:_,preserveStyle:g=!0,whitespace:y,...h}=n,{align:b,bracketedArray:a,newline:v,platform:w,section:p,sort:j,...A}=h;let c=_,f=y,o,l;if(g&&O(r,N))try{o=q(r,"utf8"),l=E(o,{bracketedArray:a??!0});const e=R(o);c??=e.eol,f??=e.whitespace}catch(e){if(e.code!=="ENOENT")throw e}const m={align:b,bracketedArray:a,newline:v,platform:w,section:p,sort:j,whitespace:f},d=(e,u)=>I(e,u===void 0?m:{...m,section:u});let s;o!==void 0&&l?s=B(o,l,t,d,{eol:c??`
+`}):(s=d(t,p),c===`\r
+`&&(s=s.replaceAll(/\r?\n/g,`\r
+`))),L(r,s,A)};export{C as default};

package/dist/packem_shared/writeJson-bEVi25gX.js

@@ -0,0 +1,4 @@
+import{createRequire as u}from"node:module";import{k as h}from"./index-B2MhYg3r.js";import{R_OK as j}from"./FIND_UP_STOP-CAwY1qU7.js";import N from"./isAccessible-PmWJhV6I.js";import b from"./writeFile-BrMtsJY7.js";const _=u(import.meta.url),i=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof i<"u"&&i.versions&&i.versions.node){const[t,s]=i.versions.node.split(".").map(Number);if(t>22||t===22&&s>=3||t===20&&s>=16)return i.getBuiltinModule(e)}return _(e)},{readFile:y}=g("node:fs/promises"),O=async(e,t,s={})=>{const{detectIndent:c,indent:a,replacer:f,stringify:d=JSON.stringify,...p}={indent:"	",...s};let r=a,n=`
+`;if(await N(e,j))try{const o=await y(e,"utf8");if(c){const{indent:l}=h(o);r=l}n=o.endsWith(`
+`)?`
+`:""}catch(o){if(o.code!=="ENOENT")throw o}const m=d(t,f,r);await b(e,`${m}${n}`,p)};export{O as default};

package/dist/packem_shared/writeJson5-Ch8TpNPI.js

@@ -0,0 +1,4 @@
+import{createRequire as l}from"node:module";import{k as y}from"./index-B2MhYg3r.js";import j from"json5";import{R_OK as q}from"./FIND_UP_STOP-CAwY1qU7.js";import b from"./isAccessible-PmWJhV6I.js";import w from"./writeFile-BrMtsJY7.js";const _=l(import.meta.url),r=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof r<"u"&&r.versions&&r.versions.node){const[t,i]=r.versions.node.split(".").map(Number);if(t>22||t===22&&i>=3||t===20&&i>=16)return r.getBuiltinModule(e)}return _(e)},{readFile:h}=g("node:fs/promises"),M=async(e,t,i={})=>{const{detectIndent:a,indent:f,quote:p,replacer:d,...m}={indent:"	",...i};let s=f,n=`
+`;if(await b(e,q))try{const o=await h(e,"utf8");if(a){const{indent:c}=y(o);c&&(s=c)}n=o.endsWith(`
+`)?`
+`:""}catch(o){if(o.code!=="ENOENT")throw o}const u=j.stringify(t,{quote:p,replacer:d,space:s});await w(e,`${u}${n}`,m)};export{M as default};

package/dist/packem_shared/writeJson5Sync-BrctV_Mk.js

@@ -0,0 +1,4 @@
+import{createRequire as a}from"node:module";import{k as y}from"./index-B2MhYg3r.js";import j from"json5";import{R_OK as q}from"./FIND_UP_STOP-CAwY1qU7.js";import b from"./isAccessibleSync-BrbOtwdr.js";import T from"./writeFileSync-W7Mf4BNy.js";const _=a(import.meta.url),r=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof r<"u"&&r.versions&&r.versions.node){const[t,s]=r.versions.node.split(".").map(Number);if(t>22||t===22&&s>=3||t===20&&s>=16)return r.getBuiltinModule(e)}return _(e)},{readFileSync:h}=g("node:fs"),O=(e,t,s={})=>{const{detectIndent:f,indent:d,quote:p,replacer:m,...u}={indent:"	",...s};let i=d,n=`
+`;if(b(e,q))try{const o=h(e,"utf8");if(f){const{indent:c}=y(o);c&&(i=c)}n=o.endsWith(`
+`)?`
+`:""}catch(o){if(o.code!=="ENOENT")throw o}const l=j.stringify(t,{quote:p,replacer:m,space:i});T(e,`${l}${n}`,u)};export{O as default};

package/dist/packem_shared/writeJsonSync-DkGnd416.js

@@ -0,0 +1,4 @@
+import{createRequire as a}from"node:module";import{k as h}from"./index-B2MhYg3r.js";import{R_OK as j}from"./FIND_UP_STOP-CAwY1qU7.js";import N from"./isAccessibleSync-BrbOtwdr.js";import b from"./writeFileSync-W7Mf4BNy.js";const _=a(import.meta.url),n=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof n<"u"&&n.versions&&n.versions.node){const[t,r]=n.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return n.getBuiltinModule(e)}return _(e)},{readFileSync:y}=g("node:fs"),$=(e,t,r={})=>{const{detectIndent:c,indent:f,replacer:d,stringify:p=JSON.stringify,...l}={indent:"	",...r};let i=f,s=`
+`;if(N(e,j))try{const o=y(e,"utf8");if(c){const{indent:u}=h(o);i=u}s=o.endsWith(`
+`)?`
+`:""}catch(o){if(o.code!=="ENOENT")throw o}const m=p(t,d,i);b(e,`${m}${s}`,l)};export{$ as default};

package/dist/packem_shared/writeJsonc-CefrwsOc.js

@@ -0,0 +1,4 @@
+import{createRequire as u}from"node:module";import{k as b}from"./index-B2MhYg3r.js";import{R_OK as N}from"./FIND_UP_STOP-CAwY1qU7.js";import h from"./isAccessible-PmWJhV6I.js";import{b as y}from"./jsonc-merge-Bkw73TLW.js";import T from"./writeFile-BrMtsJY7.js";const _=u(import.meta.url),a=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof a<"u"&&a.versions&&a.versions.node){const[t,n]=a.versions.node.split(".").map(Number);if(t>22||t===22&&n>=3||t===20&&n>=16)return a.getBuiltinModule(e)}return _(e)},{readFile:w}=g("node:fs/promises"),j=async(e,t,n)=>{let r,o=n,s=`
+`;if(!await h(e,N))return{indent:o,trailingNewline:s};try{if(r=await w(e,"utf8"),t){const{indent:i}=b(r);i&&(o=i)}s=r.endsWith(`
+`)?`
+`:""}catch(i){if(i.code!=="ENOENT")throw i}return{existingText:r,indent:o,trailingNewline:s}},B=async(e,t,n={})=>{const{detectIndent:r,formattingOptions:o,indent:s,preserveComments:i=!0,replacer:c,...d}={indent:"	",...n},{existingText:l,indent:m,trailingNewline:p}=await j(e,r,s),f=y(l,t,i,m,p,o,c);await T(e,f,d)};export{B as default};

package/dist/packem_shared/writeJsoncSync-BskDjn8o.js

@@ -0,0 +1,4 @@
+import{createRequire as a}from"node:module";import{k as b}from"./index-B2MhYg3r.js";import{R_OK as h}from"./FIND_UP_STOP-CAwY1qU7.js";import T from"./isAccessibleSync-BrbOtwdr.js";import{b as j}from"./jsonc-merge-Bkw73TLW.js";import x from"./writeFileSync-W7Mf4BNy.js";const _=a(import.meta.url),c=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof c<"u"&&c.versions&&c.versions.node){const[t,i]=c.versions.node.split(".").map(Number);if(t>22||t===22&&i>=3||t===20&&i>=16)return c.getBuiltinModule(e)}return _(e)},{readFileSync:N}=g("node:fs"),y=(e,t,i)=>{let r,o=i,s=`
+`;if(!T(e,h))return{indent:o,trailingNewline:s};try{if(r=N(e,"utf8"),t){const{indent:n}=b(r);n&&(o=n)}s=r.endsWith(`
+`)?`
+`:""}catch(n){if(n.code!=="ENOENT")throw n}return{existingText:r,indent:o,trailingNewline:s}},E=(e,t,i={})=>{const{detectIndent:r,formattingOptions:o,indent:s,preserveComments:n=!0,replacer:d,...l}={indent:"	",...i},{existingText:f,indent:m,trailingNewline:p}=y(e,r,s),u=j(f,t,n,m,p,o,d);x(e,u,l)};export{E as default};

package/dist/packem_shared/writeToml-IuMO-yDu.js

@@ -0,0 +1 @@
+import{stringify as a}from"smol-toml";import i from"./writeFile-BrMtsJY7.js";const s=async(t,o,r)=>{await i(t,a(o),r)};export{s as default};

package/dist/packem_shared/writeTomlSync-DhL7hHzB.js

@@ -0,0 +1 @@
+import{stringify as f}from"smol-toml";import i from"./writeFileSync-W7Mf4BNy.js";const p=(o,r,t)=>{i(o,f(r),t)};export{p as default};

package/dist/packem_shared/writeYaml-ClQgvQID.js

@@ -0,0 +1 @@
+import{stringify as p}from"yaml";import t from"./writeFile-BrMtsJY7.js";async function l(c,i,e,f){let r,a,o;typeof e=="object"&&e!==null&&!Array.isArray(e)&&typeof e!="function"?(r=e,a=r.replacer,o=r.space):typeof f=="object"?(r=f,a=e,o=r.space):(a=e,o=f);const n=p(i,a,o??r);await t(c,n,r)}export{l as default};

package/dist/packem_shared/writeYamlSync-DrXtHQQq.js

@@ -0,0 +1 @@
+import{stringify as n}from"yaml";import t from"./writeFileSync-W7Mf4BNy.js";function y(a,c,e,p){let r,o,f;typeof e=="object"&&e!==null&&!Array.isArray(e)&&typeof e!="function"?(r=e,o=r.replacer,f=r.space):typeof p=="object"?(r=p,o=e,f=r.space):(o=e,f=p);const i=n(c,o,f??r);t(a,i,r)}export{y as default};

package/dist/size.d.ts

@@ -1,12 +1,256 @@
 import { Readable } from 'node:stream';
 import { URL } from 'node:url';
 import { BrotliOptions, ZlibOptions } from 'node:zlib';
+/**
+* Input type for size calculation functions.
+* Can be a Buffer, Readable stream, URL object, or string (file path or content).
+*/
 type SizeInput = Buffer | Readable | URL | string;
+/**
+* Input type for synchronous size calculation functions.
+* Can be a Buffer, URL object, or string (file path or content).
+*/
 type SizeInputSync = Buffer | URL | string;
+/**
+* Asynchronously calculates the gzipped size of the given input.
+* The input can be a Buffer, a Readable stream, a URL object pointing to a file, or a string (file path or content).
+* Uses memory-efficient streaming for files and streams to avoid loading entire contents into memory.
+* @param input The input data to gzip and measure.
+* @param [options] Optional Zlib options for gzip compression.
+* @returns A promise that resolves with the gzipped size in bytes.
+* @example
+* ```javascript
+* import { gzipSize } from "@visulima/fs";
+* import { Readable } from "node:stream";
+* import { writeFile, unlink } from "node:fs/promises";
+* import { join } from "node:path";
+*
+* const text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
+* const filePath = join("temp-file.txt");
+*
+* async function main() {
+*   // From Buffer
+*   const buffer = Buffer.from(text);
+*   console.log(`Gzip size of buffer: ${await gzipSize(buffer)} bytes`);
+*
+*   // From string (content)
+*   console.log(`Gzip size of string content: ${await gzipSize(text)} bytes`);
+*
+*   // From file path
+*   await writeFile(filePath, text);
+*   console.log(`Gzip size of file: ${await gzipSize(filePath)} bytes`);
+*
+*   // From URL
+*   const fileUrl = new URL(`file://${filePath}`);
+*   console.log(`Gzip size of URL: ${await gzipSize(fileUrl)} bytes`);
+*
+*   // From Readable stream
+*   const stream = Readable.from(text);
+*   console.log(`Gzip size of stream: ${await gzipSize(stream)} bytes`);
+*
+*   await unlink(filePath); // Clean up temp file
+* }
+*
+* main().catch(console.error);
+* ```
+*/
 declare const gzipSize: (input: SizeInput, options?: ZlibOptions) => Promise<number>;
+/**
+* Asynchronously calculates the Brotli compressed size of the given input.
+* The input can be a Buffer, a Readable stream, a URL object pointing to a file, or a string (file path or content).
+* Uses memory-efficient streaming for files and streams to avoid loading entire contents into memory.
+* @param input The input data to compress with Brotli and measure.
+* @param [options] Optional Zlib options for Brotli compression.
+* @returns A promise that resolves with the Brotli compressed size in bytes.
+* @example
+* ```javascript
+* import { brotliSize } from "@visulima/fs";
+* import { Readable } from "node:stream";
+* import { writeFile, unlink } from "node:fs/promises";
+* import { join } from "node:path";
+*
+* const text = "This is a test string for Brotli compression efficiency.";
+* const filePath = join("temp-brotli-file.txt");
+*
+* async function main() {
+*   // From Buffer
+*   const buffer = Buffer.from(text);
+*   console.log(`Brotli size of buffer: ${await brotliSize(buffer)} bytes`);
+*
+*   // From string (content)
+*   console.log(`Brotli size of string content: ${await brotliSize(text)} bytes`);
+*
+*   // From file path
+*   await writeFile(filePath, text);
+*   console.log(`Brotli size of file: ${await brotliSize(filePath)} bytes`);
+*
+*   // From URL
+*   const fileUrl = new URL(`file://${filePath}`);
+*   console.log(`Brotli size of URL: ${await brotliSize(fileUrl)} bytes`);
+*
+*   // From Readable stream
+*   const stream = Readable.from(text);
+*   console.log(`Brotli size of stream: ${await brotliSize(stream)} bytes`);
+*
+*   await unlink(filePath); // Clean up temp file
+* }
+*
+* main().catch(console.error);
+* ```
+*/
 declare const brotliSize: (input: SizeInput, options?: BrotliOptions) => Promise<number>;
+/**
+* Asynchronously calculates the raw (uncompressed) size of the given input.
+* The input can be a Buffer, a Readable stream, a URL object pointing to a file, or a string (file path or content).
+* Uses memory-efficient streaming for files and streams to avoid loading entire contents into memory.
+* @param input The input data to measure.
+* @returns A promise that resolves with the raw size in bytes.
+* @example
+* ```javascript
+* import { rawSize } from "@visulima/fs";
+* import { Readable } from "node:stream";
+* import { writeFile, unlink } from "node:fs/promises";
+* import { join } from "node:path";
+*
+* const text = "Hello, World!";
+* const filePath = join("temp-raw-file.txt");
+*
+* async function main() {
+*   // From Buffer
+*   const buffer = Buffer.from(text);
+*   console.log(`Raw size of buffer: ${await rawSize(buffer)} bytes`);
+*
+*   // From string (content)
+*   console.log(`Raw size of string content: ${await rawSize(text)} bytes`);
+*
+*   // From file path
+*   await writeFile(filePath, text);
+*   console.log(`Raw size of file: ${await rawSize(filePath)} bytes`);
+*
+*   // From URL
+*   const fileUrl = new URL(`file://${filePath}`);
+*   console.log(`Raw size of URL: ${await rawSize(fileUrl)} bytes`);
+*
+*   // From Readable stream
+*   const stream = Readable.from(text);
+*   console.log(`Raw size of stream: ${await rawSize(stream)} bytes`);
+*
+*   await unlink(filePath); // Clean up temp file
+* }
+*
+* main().catch(console.error);
+* ```
+*/
 declare const rawSize: (input: SizeInput) => Promise<number>;
+/**
+* Synchronously calculates the gzipped size of the given input.
+* The input can be a Buffer, a URL object pointing to a file, or a string (file path or content).
+* Note: For Readable streams or very large files, consider using the asynchronous `gzipSize` function for better performance and to avoid blocking.
+* @param input The input data to gzip and measure.
+* @param [options] Optional Zlib options for gzip compression.
+* @returns The gzipped size in bytes.
+* @example
+* ```javascript
+* import { gzipSizeSync } from "@visulima/fs";
+* import { writeFileSync, unlinkSync } from "node:fs";
+* import { join } from "node:path";
+*
+* const text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
+* const filePath = join("temp-sync-file.txt");
+*
+* // From Buffer
+* const buffer = Buffer.from(text);
+* console.log(`Sync Gzip size of buffer: ${gzipSizeSync(buffer)} bytes`);
+*
+* // From string (content)
+* console.log(`Sync Gzip size of string content: ${gzipSizeSync(text)} bytes`);
+*
+* // From file path
+* try {
+*   writeFileSync(filePath, text);
+*   console.log(`Sync Gzip size of file: ${gzipSizeSync(filePath)} bytes`);
+*
+*   // From URL
+*   const fileUrl = new URL(`file://${filePath}`);
+*   console.log(`Sync Gzip size of URL: ${gzipSizeSync(fileUrl)} bytes`);
+* } finally {
+*   try { unlinkSync(filePath); } catch {} // Clean up temp file
+* }
+* ```
+*/
 declare const gzipSizeSync: (input: SizeInputSync, options?: ZlibOptions) => number;
+/**
+* Synchronously calculates the Brotli compressed size of the given input.
+* The input can be a Buffer, a URL object pointing to a file, or a string (file path or content).
+* Note: For Readable streams or very large files, consider using the asynchronous `brotliSize` function for better performance and to avoid blocking.
+* @param input The input data to compress with Brotli and measure.
+* @param [options] Optional Zlib options for Brotli compression.
+* @returns The Brotli compressed size in bytes.
+* @example
+* ```javascript
+* import { brotliSizeSync } from "@visulima/fs";
+* import { writeFileSync, unlinkSync } from "node:fs";
+* import { join } from "node:path";
+*
+* const text = "This is a test string for Brotli compression efficiency, synchronously.";
+* const filePath = join("temp-brotli-sync-file.txt");
+*
+* // From Buffer
+* const buffer = Buffer.from(text);
+* console.log(`Sync Brotli size of buffer: ${brotliSizeSync(buffer)} bytes`);
+*
+* // From string (content)
+* console.log(`Sync Brotli size of string content: ${brotliSizeSync(text)} bytes`);
+*
+* // From file path
+* try {
+*   writeFileSync(filePath, text);
+*   console.log(`Sync Brotli size of file: ${brotliSizeSync(filePath)} bytes`);
+*
+*   // From URL
+*   const fileUrl = new URL(`file://${filePath}`);
+*   console.log(`Sync Brotli size of URL: ${brotliSizeSync(fileUrl)} bytes`);
+* } finally {
+*   try { unlinkSync(filePath); } catch {} // Clean up temp file
+* }
+* ```
+*/
 declare const brotliSizeSync: (input: SizeInputSync, options?: BrotliOptions) => number;
+/**
+* Synchronously calculates the raw (uncompressed) size of the given input.
+* The input can be a Buffer, a URL object pointing to a file, or a string (file path or content).
+* For file paths, it uses `statSync` to get the file size.
+* Note: For Readable streams or very large files, consider using the asynchronous `rawSize` function for better performance and to avoid blocking.
+* @param input The input data to measure.
+* @returns The raw size in bytes.
+* @example
+* ```javascript
+* import { rawSizeSync } from "@visulima/fs";
+* import { writeFileSync, unlinkSync } from "node:fs";
+* import { join } from "node:path";
+*
+* const text = "Hello, Synchronous World!";
+* const filePath = join("temp-raw-sync-file.txt");
+*
+* // From Buffer
+* const buffer = Buffer.from(text);
+* console.log(`Sync Raw size of buffer: ${rawSizeSync(buffer)} bytes`);
+*
+* // From string (content)
+* console.log(`Sync Raw size of string content: ${rawSizeSync(text)} bytes`);
+*
+* // From file path
+* try {
+*   writeFileSync(filePath, text);
+*   console.log(`Sync Raw size of file: ${rawSizeSync(filePath)} bytes`);
+*
+*   // From URL
+*   const fileUrl = new URL(`file://${filePath}`);
+*   console.log(`Sync Raw size of URL: ${rawSizeSync(fileUrl)} bytes`);
+* } finally {
+*   try { unlinkSync(filePath); } catch {} // Clean up temp file
+* }
+* ```
+*/
 declare const rawSizeSync: (input: SizeInputSync) => number;
 export { brotliSize, brotliSizeSync, gzipSize, gzipSizeSync, rawSize, rawSizeSync };

package/dist/size.js

@@ -1,146 +1 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  readFileSync,
-  statSync,
-  existsSync
-} = __cjs_getBuiltinModule("node:fs");
-const {
-  readFile
-} = __cjs_getBuiltinModule("node:fs/promises");
-const {
-  isAbsolute,
-  resolve
-} = __cjs_getBuiltinModule("node:path");
-const {
-  Readable
-} = __cjs_getBuiltinModule("node:stream");
-const {
-  URL
-} = __cjs_getBuiltinModule("node:url");
-const {
-  brotliCompressSync,
-  gzipSync,
-  createGzip,
-  createBrotliCompress
-} = __cjs_getBuiltinModule("node:zlib");
-import { toPath } from '@visulima/path/utils';
-
-const fileExists = (input) => {
-  if (isAbsolute(input)) {
-    return existsSync(input);
-  }
-  try {
-    return existsSync(resolve(input));
-  } catch {
-    return false;
-  }
-};
-const getStreamSizeEfficient = async (stream) => {
-  let totalSize = 0;
-  for await (const chunk of stream) {
-    totalSize += Buffer.from(chunk).length;
-  }
-  return totalSize;
-};
-const getCompressedStreamSizeEfficient = async (stream, createCompressor) => {
-  let totalSize = 0;
-  const compressor = createCompressor();
-  return await new Promise((resolve2, reject) => {
-    compressor.on("data", (chunk) => {
-      totalSize += chunk.length;
-    });
-    compressor.on("end", () => {
-      resolve2(totalSize);
-    });
-    compressor.on("error", reject);
-    stream.on("error", reject);
-    stream.pipe(compressor);
-  });
-};
-const processInputEfficiently = async (input, processor, streamProcessor) => {
-  if (input instanceof URL || typeof input === "string") {
-    const path = toPath(input);
-    if (fileExists(path)) {
-      const fileStream = Readable.from(await readFile(path));
-      return await streamProcessor(fileStream);
-    }
-    if (typeof input === "string") {
-      return processor(Buffer.from(input));
-    }
-  }
-  if (input instanceof Readable) {
-    return await streamProcessor(input);
-  }
-  return processor(input);
-};
-const gzipSize = async (input, options) => {
-  const streamProcessor = async (stream) => await getCompressedStreamSizeEfficient(stream, () => createGzip(options));
-  const bufferProcessor = (data) => gzipSync(data, options).length;
-  return await processInputEfficiently(input, bufferProcessor, streamProcessor);
-};
-const brotliSize = async (input, options) => {
-  const streamProcessor = async (stream) => await getCompressedStreamSizeEfficient(stream, () => createBrotliCompress(options));
-  const bufferProcessor = (data) => brotliCompressSync(data, options).length;
-  return await processInputEfficiently(input, bufferProcessor, streamProcessor);
-};
-const rawSize = async (input) => {
-  const streamProcessor = async (stream) => await getStreamSizeEfficient(stream);
-  const bufferProcessor = (data) => data.length;
-  return await processInputEfficiently(input, bufferProcessor, streamProcessor);
-};
-const gzipSizeSync = (input, options) => {
-  if (input instanceof URL || typeof input === "string") {
-    const path = toPath(input);
-    if (fileExists(path)) {
-      return gzipSync(readFileSync(path), options).length;
-    }
-    if (typeof input === "string") {
-      return gzipSync(Buffer.from(input), options).length;
-    }
-  }
-  return gzipSync(input, options).length;
-};
-const brotliSizeSync = (input, options) => {
-  if (input instanceof URL || typeof input === "string") {
-    const path = toPath(input);
-    if (fileExists(path)) {
-      return brotliCompressSync(readFileSync(path), options).length;
-    }
-    if (typeof input === "string") {
-      return brotliCompressSync(Buffer.from(input), options).length;
-    }
-  }
-  return brotliCompressSync(input, options).length;
-};
-const rawSizeSync = (input) => {
-  if (input instanceof URL || typeof input === "string") {
-    const path = toPath(input);
-    if (fileExists(path)) {
-      return statSync(path).size;
-    }
-    if (typeof input === "string") {
-      return Buffer.from(input).length;
-    }
-  }
-  return input.length;
-};
-
-export { brotliSize, brotliSizeSync, gzipSize, gzipSizeSync, rawSize, rawSizeSync };
+import{createRequire as S}from"node:module";import{toPath as f}from"@visulima/path/utils";const w=S(import.meta.url),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,i=t=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[n,e]=o.versions.node.split(".").map(Number);if(n>22||n===22&&e>=3||n===20&&e>=16)return o.getBuiltinModule(t)}return w(t)},{readFileSync:m,statSync:z,createReadStream:_,existsSync:y}=i("node:fs"),{isAbsolute:b,resolve:B}=i("node:path"),{Readable:j}=i("node:stream"),{URL:c}=i("node:url"),{brotliCompressSync:s,gzipSync:a,createGzip:R,createBrotliCompress:v}=i("node:zlib"),l=t=>{if(b(t))return y(t);try{return y(B(t))}catch{return!1}},q=async t=>{let n=0;for await(const e of t)n+=Buffer.from(e).length;return n},d=async(t,n)=>{let e=0;const r=n();return await new Promise((u,p)=>{r.on("data",h=>{e+=h.length}),r.on("end",()=>{u(e)}),r.on("error",p),t.on("error",p),t.pipe(r)})},g=async(t,n,e)=>{if(t instanceof c||typeof t=="string"){const r=f(t);if(l(r)){const u=_(r);return await e(u)}if(typeof t=="string")return n(Buffer.from(t))}return t instanceof j?await e(t):n(t)},x=async(t,n)=>await g(t,e=>a(e,n).length,async e=>await d(e,()=>R(n))),C=async(t,n)=>await g(t,e=>s(e,n).length,async e=>await d(e,()=>v(n))),M=async t=>await g(t,n=>n.length,async n=>await q(n)),A=(t,n)=>{if(t instanceof c||typeof t=="string"){const e=f(t);if(l(e))return a(m(e),n).length;if(typeof t=="string")return a(Buffer.from(t),n).length}return a(t,n).length},F=(t,n)=>{if(t instanceof c||typeof t=="string"){const e=f(t);if(l(e))return s(m(e),n).length;if(typeof t=="string")return s(Buffer.from(t),n).length}return s(t,n).length},G=t=>{if(t instanceof c||typeof t=="string"){const n=f(t);if(l(n))return z(n).size;if(typeof t=="string")return Buffer.from(t).length}return t.length};export{C as brotliSize,F as brotliSizeSync,x as gzipSize,A as gzipSizeSync,M as rawSize,G as rawSizeSync};

package/dist/toml.d.ts

@@ -1,9 +1,63 @@
-import { C as CompressionType, R as ReadTomlOptions, W as WriteTomlOptions } from "./packem_shared/types.d-dP-lAGNn.js";
+import { C as CompressionType, i as ReadTomlOptions, j as WriteTomlOptions } from "./packem_shared/types.d-BMdL_ygj.js";
 import 'node:fs';
-import 'tinyglobby';
-import './options';
+import 'fdir';
+/**
+* Asynchronously reads a TOML file and parses it into an object.
+* @template R The expected type of the parsed TOML object. Defaults to `Record<string, unknown>`.
+* @param path The path to the TOML file to read. Can be a file URL or a string path.
+* @param options Optional configuration for reading the file. See {@link ReadTomlOptions}.
+* @returns A promise that resolves with the parsed TOML object of type `R`.
+* @example
+* ```javascript
+* import { readToml } from "@visulima/fs/toml";
+* import { join } from "node:path";
+*
+* const config = await readToml(join("path", "to", "config.toml"));
+* ```
+*/
 declare const readToml: <R = Record<string, unknown>>(path: URL | string, options?: ReadTomlOptions<CompressionType>) => Promise<R>;
+/**
+* Synchronously reads a TOML file and parses it into an object.
+* @template R The expected type of the parsed TOML object. Defaults to `Record&lt;string, unknown>`.
+* @param path The path to the TOML file to read. Can be a file URL or a string path.
+* @param options Optional configuration for reading the file. See {@link ReadTomlOptions}.
+* @returns The parsed TOML object of type `R`.
+* @example
+* ```javascript
+* import { readTomlSync } from "@visulima/fs/toml";
+* import { join } from "node:path";
+*
+* const config = readTomlSync(join("path", "to", "config.toml"));
+* ```
+*/
 declare const readTomlSync: (path: URL | string, options?: ReadTomlOptions<CompressionType>) => Record<string, unknown>;
+/**
+* Asynchronously writes an object to a TOML file.
+* @param path The path to the TOML file to write. Can be a file URL or a string path.
+* @param data The data to serialize. Must be a plain object compatible with `smol-toml.stringify`.
+* @param options Optional configuration for writing the TOML file. See {@link WriteTomlOptions}.
+* @returns A promise that resolves when the TOML file has been written.
+* @example
+* ```javascript
+* import { writeToml } from "@visulima/fs/toml";
+* import { join } from "node:path";
+*
+* await writeToml(join("/tmp", "config.toml"), { name: "app", version: 1 });
+* ```
+*/
 declare const writeToml: (path: URL | string, data: Record<string, unknown>, options?: WriteTomlOptions) => Promise<void>;
+/**
+* Synchronously writes an object to a TOML file.
+* @param path The path to the TOML file to write. Can be a file URL or a string path.
+* @param data The data to serialize. Must be a plain object compatible with `smol-toml.stringify`.
+* @param options Optional configuration for writing the TOML file. See {@link WriteTomlOptions}.
+* @example
+* ```javascript
+* import { writeTomlSync } from "@visulima/fs/toml";
+* import { join } from "node:path";
+*
+* writeTomlSync(join("/tmp", "config.toml"), { name: "app", version: 1 });
+* ```
+*/
 declare const writeTomlSync: (path: URL | string, data: Record<string, unknown>, options?: WriteTomlOptions) => void;
 export { type ReadTomlOptions, type WriteTomlOptions, readToml, readTomlSync, writeToml, writeTomlSync };

package/dist/toml.js

@@ -1,4 +1 @@
-export { default as readToml } from './packem_shared/readToml-B2MHaSes.js';
-export { default as readTomlSync } from './packem_shared/readTomlSync-DNbK8NEb.js';
-export { default as writeToml } from './packem_shared/writeToml-DgTW_-7F.js';
-export { default as writeTomlSync } from './packem_shared/writeTomlSync-DiBiE9ja.js';
+import{default as r}from"./packem_shared/readToml-D4jpe9q_.js";import{default as t}from"./packem_shared/readTomlSync-B5PIYT9z.js";import{default as l}from"./packem_shared/writeToml-IuMO-yDu.js";import{default as d}from"./packem_shared/writeTomlSync-DhL7hHzB.js";export{r as readToml,t as readTomlSync,l as writeToml,d as writeTomlSync};