@isdk/util 0.3.1 → 0.3.2

package/dist/index.d.mts

@@ -73,6 +73,33 @@ declare class ConfigFile {
      * ```
      */
     static saveSync(filename: string, config: any, options?: LoadConfigFileOptions): string;
+    /**
+     * Checks if a configuration file exists at the specified path.
+     *
+     * This method normalizes the filename by removing the extension (if present) and then delegates
+     * to the underlying LoadConfigFile utility to perform the existence check. The normalization
+     * ensures consistent handling of files regardless of whether they include extensions in the
+     * provided filename.
+     *
+     * @param filename - The path to the configuration file to check for existence.
+     *                  This can include or omit the file extension.
+     * @param options - Optional configuration options that may affect how the file existence
+     *                 is checked, including extension level handling.
+     *
+     * @returns `true` if the configuration file exists, `false` otherwise.
+     *
+     * @example
+     * ```typescript
+     * // Check if a YAML config file exists
+     * const exists = ConfigFile.existsSync('config.yaml');
+     * console.log(exists); // true or false
+     *
+     * // Check with options
+     * const existsWithExt = ConfigFile.existsSync('config', { extLevel: 2 });
+     * console.log(existsWithExt); // true or false
+     * ```
+     */
+    static existsSync(filename: string, options?: LoadConfigFileOptions): boolean;
 }
 
 /**

package/dist/index.d.ts

@@ -73,6 +73,33 @@ declare class ConfigFile {
      * ```
      */
     static saveSync(filename: string, config: any, options?: LoadConfigFileOptions): string;
+    /**
+     * Checks if a configuration file exists at the specified path.
+     *
+     * This method normalizes the filename by removing the extension (if present) and then delegates
+     * to the underlying LoadConfigFile utility to perform the existence check. The normalization
+     * ensures consistent handling of files regardless of whether they include extensions in the
+     * provided filename.
+     *
+     * @param filename - The path to the configuration file to check for existence.
+     *                  This can include or omit the file extension.
+     * @param options - Optional configuration options that may affect how the file existence
+     *                 is checked, including extension level handling.
+     *
+     * @returns `true` if the configuration file exists, `false` otherwise.
+     *
+     * @example
+     * ```typescript
+     * // Check if a YAML config file exists
+     * const exists = ConfigFile.existsSync('config.yaml');
+     * console.log(exists); // true or false
+     *
+     * // Check with options
+     * const existsWithExt = ConfigFile.existsSync('config', { extLevel: 2 });
+     * console.log(existsWithExt); // true or false
+     * ```
+     */
+    static existsSync(filename: string, options?: LoadConfigFileOptions): boolean;
 }
 
 /**

package/dist/index.js

@@ -1 +1 @@
-"use strict";var e,t=Object.create,n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,i=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,a=(e,t,i,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let u of o(t))s.call(e,u)||u===i||n(e,u,{get:()=>t[u],enumerable:!(a=r(t,u))||a.enumerable});return e},u=(e,r,o)=>(o=null!=e?t(i(e)):{},a(!r&&e&&e.__esModule?o:n(o,"default",{value:e,enumerable:!0}),e)),c={};((e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})})(c,{ConfigFile:()=>j,DefaultAllTextFiles:()=>O,FilenameReservedRegex:()=>B,WindowsReservedNameRegex:()=>D,arrayHasAll:()=>X,extNameLevel:()=>U,filenameReservedRegex:()=>P,getMultiLevelExtname:()=>g,glob:()=>R,isStringIn:()=>E,isValidFilename:()=>Z,isValidFilepath:()=>G,normalizeIncludeFiles:()=>A,parseFrontMatter:()=>w,parseYaml:()=>h,reControlCharsRegex:()=>W,registerYamlTag:()=>v,removeLeadingEmptyLines:()=>b,sanitizeFilename:()=>K,sanitizeFilepath:()=>Q,stringifyYaml:()=>F,toCamelCase:()=>N,toCapitalCase:()=>M,toPascalCase:()=>T,traverseFolder:()=>k,traverseFolderSync:()=>L}),module.exports=(e=c,a(n({},"__esModule",{value:!0}),e));var f=require("fs"),l=u(require("path")),m=require("load-config-file"),p=u(require("path"));function g(e,t=1){let n="";for(;t--;){const t=p.default.extname(e);if(!t)break;n=t+n,e=p.default.basename(e,t)}return n}var y=require("yaml"),d=[];function v(e){Array.isArray(e)||(e=[e]);for(const t of e){-1===d.indexOf(t)&&d.push(t)}}function h(e,t){if(t)if(t.customTags){if(Array.isArray(t.customTags))t.customTags=d.concat(t.customTags);else if("function"==typeof t.customTags){const e=t.customTags;t.customTags=t=>e(d.concat(t))}}else t.customTags=d;else t={customTags:d};return(0,y.parse)(e,t)}function F(e,t){if(t)if(t.customTags){if(Array.isArray(t.customTags))t.customTags=d.concat(t.customTags);else if("function"==typeof t.customTags){const e=t.customTags;t.customTags=t=>e(d.concat(t))}}else t.customTags=d;else t={customTags:d};return(0,y.stringify)(e,t)}function b(e){const t=/^\s*(#[^\r\n]*)?[\r\n]+/;let n;for(;null!==(n=t.exec(e))&&((e=e.substring(n[0].length)).startsWith("\n")||e.startsWith("\r")||e.trimStart().startsWith("#")););return e}var x="---";function w(e,t=x){const n=t.length,r=b(e);if(r.startsWith(t)&&("\n"===r[t.length]||"\r"===r[t.length])){let e=r.indexOf("\n"+t,n);if(-1!==e){const o=r.slice(n,e);for(e+=t.length+1;"\n"===r[e]||"\r"===r[e];)e++;const i=r.slice(e);return{data:h(o)||{},content:i}}}return{data:{},content:e}}var j=class{static register(e,t,n){m.Config.register(e,t),"string"==typeof e&&(e=[e]);for(const t of e)this.stringifys[t]=n}static loadSync(e,t){return function(e,{extLevel:t=1,externalFile:n}={}){"."===e[0]&&t++;const r=g(e,t);r&&r.split(".").length>1&&(e=e.slice(0,-r.length));let o=m.Config.loadSync(e);if(!o&&n){if(!l.default.isAbsolute(n)){const t=l.default.dirname(e);n=l.default.join(t,n)}if((0,f.existsSync)(n)){const e=w((0,f.readFileSync)(n,"utf8")).data;Object.keys(e).length&&(o=e)}}return o}(e,t)}static saveSync(e,t,n){return function(e,t,{extLevel:n=1}={}){"."===e[0]&&n++;let r=g(e,n);(!r||r.split(".").length<=1)&&(e+=".yaml",r=".yaml");const o=j.stringifys[r];if(!o)throw new Error(`${e} unsupported mime type: ${r}`);t=o(t);const i=l.default.dirname(e);(0,f.existsSync)(i)||(0,f.mkdirSync)(i,{recursive:!0});return(0,f.writeFileSync)(e,t,{encoding:"utf8"}),e}(e,t,n)}};j.stringifys={},j.register([".yml",".yaml"],h,F),j.register([".json"],(function(e){return JSON.parse(e)}),(e=>JSON.stringify(e,null,2)));var q=require("@isdk/glob"),$=u(require("path"));function R(e,t,n){return n&&(e=$.default.relative(n,e)),(0,q.globMatch)(e,t)}function E(e,t){return"string"==typeof t&&(t=[t]),-1!==t.indexOf(e)}var O=["**/*.((j|t)s?(x)|m(j|t)s)?(x)","**/*.(md|markdown|txt|?(x)htm?(l)|yaml|yml|xml|json|bat|sh|bash|zsh|ini|css|scss|less|sass|py|rb|php|go|java|c|cpp|h|hpp|hxx|rust|zig)"];function A(e,t=[]){if(e)if(Array.isArray(e))e=[...e];else{const n=e.include||[],r=e.exclude||[];0===n.length&&n.push(...t),e=[...n];for(const t of r)e.push(`!${t}`)}else e=[...t];return 0===e.length&&e.push(...t),e}var C=require("fs/promises"),S=require("fs"),z=u(require("path"));async function k(e,t){const n=await(0,C.readdir)(e,{withFileTypes:!0});for(const r of n){const n=z.default.join(e,r.name);try{if(r.isDirectory()){await t(n,r)||await k(n,t)}else{if(!0===await t(n,r))break}}catch(e){console.error(`Error processing file: ${n}`),console.error(e)}}}function L(e,t){const n=(0,S.readdirSync)(e,{withFileTypes:!0});for(const r of n){const n=z.default.join(e,r.name);try{if(r.isDirectory()){t(n,r)||k(n,t)}else{if(!0===t(n,r))break}}catch(e){console.error(`Error processing file: ${n}`),console.error(e)}}}function T(e){if(!e)return"";return e.replace(/[-_ ]+/g," ").split(" ").filter(Boolean).map((e=>e.charAt(0).toUpperCase()+e.slice(1))).join("")}function N(e){return(e=T(e)).charAt(0).toLowerCase()+e.slice(1)}function M(e){if(!e)return"";return e.replace(/[-_ ]+/g," ").replace(/([a-z])([A-Z])/g,"$1 $2").split(" ").filter(Boolean).map((e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase())).join(" ")}var _=u(require("path")),Y=require("@isdk/common-error"),B=/[<>:"/\\|?*\u0000-\u001F]/,D=/^(con|prn|aux|nul|com\d|lpt\d)$/i,I=100,J=/^\.+(\\|\/)|^\.+$/,V=/\.+$/,H=/[\u0000-\u001F\u0080-\u009F\u200E\u200F\u202A-\u202E\u2066-\u2069]/;function P(){return new RegExp(B.source,"g")}function W(){return new RegExp(H.source,"g")}function Z(e){return e&&!(B.test(e)||W().test(e)||J.test(e)||V.test(e))}function G(e){const t=e.split(_.default.sep);return("/"===e[0]||t[0]&&_.default.dirname(t[0])===t[0])&&t.shift(),t.every(Z)}function K(e,t={}){const n=t.replacement||"!";if((B.test(n)||H.test(n))&&(0,Y.throwError)("Replacement string cannot contain reserved filename characters","sanitizeFilename",Y.ErrorCode.InvalidArgument),n.length>0){const t=/([<>:"/\\|?*\u0000-\u001F]){2,}/;e=e.replace(t,"$1")}if(e=(e=(e=(e=(e=e.normalize("NFD")).replace(J,n)).replace(P(),n)).replace(W(),n)).replace(V,""),n.length>0){"."===e[0]||"."!==e[0]||(e=n+e),"."===e[e.length-1]&&(e+=n)}e=D.test(e)?e+n:e;const r="number"==typeof t.maxLength?t.maxLength:I;if(e.length>r){const t=e.lastIndexOf(".");if(-1===t)e=e.slice(0,r);else{const n=e.slice(0,t),o=e.slice(t);e=n.slice(0,Math.max(1,r-o.length))+o}}return e}function Q(e,t={}){const n=e.split(_.default.sep);let r;("/"===e[0]||n[0]&&_.default.dirname(n[0])===n[0])&&(r=n.shift());const o=n.map((e=>K(e,t)));return void 0!==r&&o.unshift(r),o.join(_.default.sep)}function U(e){return e.split(".").length-1}function X(e,t){const n=new Set(t),r=new Set;for(const t of e)if(n.has(t)&&(r.add(t),r.size===n.size))return!0;return r.size===n.size}
+"use strict";var e,t=Object.create,n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,i=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,a=(e,t,i,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of o(t))s.call(e,c)||c===i||n(e,c,{get:()=>t[c],enumerable:!(a=r(t,c))||a.enumerable});return e},c=(e,r,o)=>(o=null!=e?t(i(e)):{},a(!r&&e&&e.__esModule?o:n(o,"default",{value:e,enumerable:!0}),e)),u={};((e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})})(u,{ConfigFile:()=>j,DefaultAllTextFiles:()=>O,FilenameReservedRegex:()=>D,WindowsReservedNameRegex:()=>I,arrayHasAll:()=>ee,extNameLevel:()=>X,filenameReservedRegex:()=>W,getMultiLevelExtname:()=>g,glob:()=>S,isStringIn:()=>E,isValidFilename:()=>G,isValidFilepath:()=>K,normalizeIncludeFiles:()=>A,parseFrontMatter:()=>w,parseYaml:()=>h,reControlCharsRegex:()=>Z,registerYamlTag:()=>v,removeLeadingEmptyLines:()=>F,sanitizeFilename:()=>Q,sanitizeFilepath:()=>U,stringifyYaml:()=>x,toCamelCase:()=>M,toCapitalCase:()=>_,toPascalCase:()=>N,traverseFolder:()=>L,traverseFolderSync:()=>T}),module.exports=(e=u,a(n({},"__esModule",{value:!0}),e));var f=require("fs"),l=c(require("path")),m=require("load-config-file"),p=c(require("path"));function g(e,t=1){let n="";for(;t--;){const t=p.default.extname(e);if(!t)break;n=t+n,e=p.default.basename(e,t)}return n}var y=require("yaml"),d=[];function v(e){Array.isArray(e)||(e=[e]);for(const t of e){-1===d.indexOf(t)&&d.push(t)}}function h(e,t){if(t)if(t.customTags){if(Array.isArray(t.customTags))t.customTags=d.concat(t.customTags);else if("function"==typeof t.customTags){const e=t.customTags;t.customTags=t=>e(d.concat(t))}}else t.customTags=d;else t={customTags:d};return(0,y.parse)(e,t)}function x(e,t){if(t)if(t.customTags){if(Array.isArray(t.customTags))t.customTags=d.concat(t.customTags);else if("function"==typeof t.customTags){const e=t.customTags;t.customTags=t=>e(d.concat(t))}}else t.customTags=d;else t={customTags:d};return(0,y.stringify)(e,t)}function F(e){const t=/^\s*(#[^\r\n]*)?[\r\n]+/;let n;for(;null!==(n=t.exec(e))&&((e=e.substring(n[0].length)).startsWith("\n")||e.startsWith("\r")||e.trimStart().startsWith("#")););return e}var b="---";function w(e,t=b){const n=t.length,r=F(e);if(r.startsWith(t)&&("\n"===r[t.length]||"\r"===r[t.length])){let e=r.indexOf("\n"+t,n);if(-1!==e){const o=r.slice(n,e);for(e+=t.length+1;"\n"===r[e]||"\r"===r[e];)e++;const i=r.slice(e);return{data:h(o)||{},content:i}}}return{data:{},content:e}}var j=class{static register(e,t,n){m.Config.register(e,t),"string"==typeof e&&(e=[e]);for(const t of e)this.stringifys[t]=n}static loadSync(e,t){return function(e,{extLevel:t=1,externalFile:n}={}){e=q(e,t);let r=m.Config.loadSync(e);if(!r&&n){if(!l.default.isAbsolute(n)){const t=l.default.dirname(e);n=l.default.join(t,n)}if((0,f.existsSync)(n)){const e=w((0,f.readFileSync)(n,"utf8")).data;Object.keys(e).length&&(r=e)}}return r}(e,t)}static saveSync(e,t,n){return function(e,t,{extLevel:n=1}={}){const r=function(e,t=1){"."===e[0]&&t++;let n=g(e,t);(!n||n.split(".").length<=1)&&(e+=".yaml",n=".yaml");const r=new String(e);return r.extname=n,r}(e,n),o=r.extname;e=r.toString();const i=j.stringifys[o];if(!i)throw new Error(`${e} unsupported mime type: ${o}`);t=i(t);const s=l.default.dirname(e);(0,f.existsSync)(s)||(0,f.mkdirSync)(s,{recursive:!0});return(0,f.writeFileSync)(e,t,{encoding:"utf8"}),e}(e,t,n)}static existsSync(e,t){return e=q(e,t?.extLevel),m.Config.existsSync(e,t)}};function q(e,t=1){"."===e[0]&&t++;const n=g(e,t);return n&&n.split(".").length>1&&(e=e.slice(0,-n.length)),e}j.stringifys={},j.register([".yml",".yaml"],h,x),j.register([".json"],(function(e){return JSON.parse(e)}),(e=>JSON.stringify(e,null,2)));var $=require("@isdk/glob"),R=c(require("path"));function S(e,t,n){return n&&(e=R.default.relative(n,e)),(0,$.globMatch)(e,t)}function E(e,t){return"string"==typeof t&&(t=[t]),-1!==t.indexOf(e)}var O=["**/*.((j|t)s?(x)|m(j|t)s)?(x)","**/*.(md|markdown|txt|?(x)htm?(l)|yaml|yml|xml|json|bat|sh|bash|zsh|ini|css|scss|less|sass|py|rb|php|go|java|c|cpp|h|hpp|hxx|rust|zig)"];function A(e,t=[]){if(e)if(Array.isArray(e))e=[...e];else{const n=e.include||[],r=e.exclude||[];0===n.length&&n.push(...t),e=[...n];for(const t of r)e.push(`!${t}`)}else e=[...t];return 0===e.length&&e.push(...t),e}var C=require("fs/promises"),z=require("fs"),k=c(require("path"));async function L(e,t){const n=await(0,C.readdir)(e,{withFileTypes:!0});for(const r of n){const n=k.default.join(e,r.name);try{if(r.isDirectory()){await t(n,r)||await L(n,t)}else{if(!0===await t(n,r))break}}catch(e){console.error(`Error processing file: ${n}`),console.error(e)}}}function T(e,t){const n=(0,z.readdirSync)(e,{withFileTypes:!0});for(const r of n){const n=k.default.join(e,r.name);try{if(r.isDirectory()){t(n,r)||L(n,t)}else{if(!0===t(n,r))break}}catch(e){console.error(`Error processing file: ${n}`),console.error(e)}}}function N(e){if(!e)return"";return e.replace(/[-_ ]+/g," ").split(" ").filter(Boolean).map((e=>e.charAt(0).toUpperCase()+e.slice(1))).join("")}function M(e){return(e=N(e)).charAt(0).toLowerCase()+e.slice(1)}function _(e){if(!e)return"";return e.replace(/[-_ ]+/g," ").replace(/([a-z])([A-Z])/g,"$1 $2").split(" ").filter(Boolean).map((e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase())).join(" ")}var Y=c(require("path")),B=require("@isdk/common-error"),D=/[<>:"/\\|?*\u0000-\u001F]/,I=/^(con|prn|aux|nul|com\d|lpt\d)$/i,J=100,V=/^\.+(\\|\/)|^\.+$/,H=/\.+$/,P=/[\u0000-\u001F\u0080-\u009F\u200E\u200F\u202A-\u202E\u2066-\u2069]/;function W(){return new RegExp(D.source,"g")}function Z(){return new RegExp(P.source,"g")}function G(e){return e&&!(D.test(e)||Z().test(e)||V.test(e)||H.test(e))}function K(e){const t=e.split(Y.default.sep);return("/"===e[0]||t[0]&&Y.default.dirname(t[0])===t[0])&&t.shift(),t.every(G)}function Q(e,t={}){const n=t.replacement||"!";if((D.test(n)||P.test(n))&&(0,B.throwError)("Replacement string cannot contain reserved filename characters","sanitizeFilename",B.ErrorCode.InvalidArgument),n.length>0){const t=/([<>:"/\\|?*\u0000-\u001F]){2,}/;e=e.replace(t,"$1")}if(e=(e=(e=(e=(e=e.normalize("NFD")).replace(V,n)).replace(W(),n)).replace(Z(),n)).replace(H,""),n.length>0){"."===e[0]||"."!==e[0]||(e=n+e),"."===e[e.length-1]&&(e+=n)}e=I.test(e)?e+n:e;const r="number"==typeof t.maxLength?t.maxLength:J;if(e.length>r){const t=e.lastIndexOf(".");if(-1===t)e=e.slice(0,r);else{const n=e.slice(0,t),o=e.slice(t);e=n.slice(0,Math.max(1,r-o.length))+o}}return e}function U(e,t={}){const n=e.split(Y.default.sep);let r;("/"===e[0]||n[0]&&Y.default.dirname(n[0])===n[0])&&(r=n.shift());const o=n.map((e=>Q(e,t)));return void 0!==r&&o.unshift(r),o.join(Y.default.sep)}function X(e){return e.split(".").length-1}function ee(e,t){const n=new Set(t),r=new Set;for(const t of e)if(n.has(t)&&(r.add(t),r.size===n.size))return!0;return r.size===n.size}

package/dist/index.mjs

@@ -1 +1 @@
-import{existsSync as t,mkdirSync as n,readFileSync as o,writeFileSync as r}from"fs";import e from"path";import{Config as i}from"load-config-file";import s from"path";function f(t,n=1){let o="";for(;n--;){const n=s.extname(t);if(!n)break;o=n+o,t=s.basename(t,n)}return o}import{parse as c,stringify as u}from"yaml";var a=[];function l(t){Array.isArray(t)||(t=[t]);for(const n of t){-1===a.indexOf(n)&&a.push(n)}}function m(t,n){if(n)if(n.customTags){if(Array.isArray(n.customTags))n.customTags=a.concat(n.customTags);else if("function"==typeof n.customTags){const t=n.customTags;n.customTags=n=>t(a.concat(n))}}else n.customTags=a;else n={customTags:a};return c(t,n)}function p(t,n){if(n)if(n.customTags){if(Array.isArray(n.customTags))n.customTags=a.concat(n.customTags);else if("function"==typeof n.customTags){const t=n.customTags;n.customTags=n=>t(a.concat(n))}}else n.customTags=a;else n={customTags:a};return u(t,n)}function y(t){const n=/^\s*(#[^\r\n]*)?[\r\n]+/;let o;for(;null!==(o=n.exec(t))&&((t=t.substring(o[0].length)).startsWith("\n")||t.startsWith("\r")||t.trimStart().startsWith("#")););return t}function g(t,n="---"){const o=n.length,r=y(t);if(r.startsWith(n)&&("\n"===r[n.length]||"\r"===r[n.length])){let t=r.indexOf("\n"+n,o);if(-1!==t){const e=r.slice(o,t);for(t+=n.length+1;"\n"===r[t]||"\r"===r[t];)t++;const i=r.slice(t);return{data:m(e)||{},content:i}}}return{data:{},content:t}}var h=class{static register(t,n,o){i.register(t,n),"string"==typeof t&&(t=[t]);for(const n of t)this.stringifys[n]=o}static loadSync(n,r){return function(n,{extLevel:r=1,externalFile:s}={}){"."===n[0]&&r++;const c=f(n,r);c&&c.split(".").length>1&&(n=n.slice(0,-c.length));let u=i.loadSync(n);if(!u&&s){if(!e.isAbsolute(s)){const t=e.dirname(n);s=e.join(t,s)}if(t(s)){const t=g(o(s,"utf8")).data;Object.keys(t).length&&(u=t)}}return u}(n,r)}static saveSync(o,i,s){return function(o,i,{extLevel:s=1}={}){"."===o[0]&&s++;let c=f(o,s);(!c||c.split(".").length<=1)&&(o+=".yaml",c=".yaml");const u=h.stringifys[c];if(!u)throw new Error(`${o} unsupported mime type: ${c}`);i=u(i);const a=e.dirname(o);t(a)||n(a,{recursive:!0});return r(o,i,{encoding:"utf8"}),o}(o,i,s)}};h.stringifys={},h.register([".yml",".yaml"],m,p),h.register([".json"],(function(t){return JSON.parse(t)}),(t=>JSON.stringify(t,null,2)));import{globMatch as d}from"@isdk/glob";import x from"path";function w(t,n,o){return o&&(t=x.relative(o,t)),d(t,n)}function v(t,n){return"string"==typeof n&&(n=[n]),-1!==n.indexOf(t)}var $=["**/*.((j|t)s?(x)|m(j|t)s)?(x)","**/*.(md|markdown|txt|?(x)htm?(l)|yaml|yml|xml|json|bat|sh|bash|zsh|ini|css|scss|less|sass|py|rb|php|go|java|c|cpp|h|hpp|hxx|rust|zig)"];function F(t,n=[]){if(t)if(Array.isArray(t))t=[...t];else{const o=t.include||[],r=t.exclude||[];0===o.length&&o.push(...n),t=[...o];for(const n of r)t.push(`!${n}`)}else t=[...n];return 0===t.length&&t.push(...n),t}import{readdir as b}from"fs/promises";import{readdirSync as E}from"fs";import j from"path";async function k(t,n){const o=await b(t,{withFileTypes:!0});for(const r of o){const o=j.join(t,r.name);try{if(r.isDirectory()){await n(o,r)||await k(o,n)}else{if(!0===await n(o,r))break}}catch(t){console.error(`Error processing file: ${o}`),console.error(t)}}}function A(t,n){const o=E(t,{withFileTypes:!0});for(const r of o){const o=j.join(t,r.name);try{if(r.isDirectory()){n(o,r)||k(o,n)}else{if(!0===n(o,r))break}}catch(t){console.error(`Error processing file: ${o}`),console.error(t)}}}function S(t){if(!t)return"";return t.replace(/[-_ ]+/g," ").split(" ").filter(Boolean).map((t=>t.charAt(0).toUpperCase()+t.slice(1))).join("")}function z(t){return(t=S(t)).charAt(0).toLowerCase()+t.slice(1)}function T(t){if(!t)return"";return t.replace(/[-_ ]+/g," ").replace(/([a-z])([A-Z])/g,"$1 $2").split(" ").filter(Boolean).map((t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase())).join(" ")}import N from"path";import{ErrorCode as O,throwError as R}from"@isdk/common-error";var B=/[<>:"/\\|?*\u0000-\u001F]/,J=/^(con|prn|aux|nul|com\d|lpt\d)$/i,L=/^\.+(\\|\/)|^\.+$/,_=/\.+$/,C=/[\u0000-\u001F\u0080-\u009F\u200E\u200F\u202A-\u202E\u2066-\u2069]/;function D(){return new RegExp(B.source,"g")}function M(){return new RegExp(C.source,"g")}function Z(t){return t&&!(B.test(t)||M().test(t)||L.test(t)||_.test(t))}function q(t){const n=t.split(N.sep);return("/"===t[0]||n[0]&&N.dirname(n[0])===n[0])&&n.shift(),n.every(Z)}function G(t,n={}){const o=n.replacement||"!";if((B.test(o)||C.test(o))&&R("Replacement string cannot contain reserved filename characters","sanitizeFilename",O.InvalidArgument),o.length>0){const n=/([<>:"/\\|?*\u0000-\u001F]){2,}/;t=t.replace(n,"$1")}if(t=(t=(t=(t=(t=t.normalize("NFD")).replace(L,o)).replace(D(),o)).replace(M(),o)).replace(_,""),o.length>0){"."===t[0]||"."!==t[0]||(t=o+t),"."===t[t.length-1]&&(t+=o)}t=J.test(t)?t+o:t;const r="number"==typeof n.maxLength?n.maxLength:100;if(t.length>r){const n=t.lastIndexOf(".");if(-1===n)t=t.slice(0,r);else{const o=t.slice(0,n),e=t.slice(n);t=o.slice(0,Math.max(1,r-e.length))+e}}return t}function H(t,n={}){const o=t.split(N.sep);let r;("/"===t[0]||o[0]&&N.dirname(o[0])===o[0])&&(r=o.shift());const e=o.map((t=>G(t,n)));return void 0!==r&&e.unshift(r),e.join(N.sep)}function I(t){return t.split(".").length-1}function K(t,n){const o=new Set(n),r=new Set;for(const n of t)if(o.has(n)&&(r.add(n),r.size===o.size))return!0;return r.size===o.size}export{h as ConfigFile,$ as DefaultAllTextFiles,B as FilenameReservedRegex,J as WindowsReservedNameRegex,K as arrayHasAll,I as extNameLevel,D as filenameReservedRegex,f as getMultiLevelExtname,w as glob,v as isStringIn,Z as isValidFilename,q as isValidFilepath,F as normalizeIncludeFiles,g as parseFrontMatter,m as parseYaml,M as reControlCharsRegex,l as registerYamlTag,y as removeLeadingEmptyLines,G as sanitizeFilename,H as sanitizeFilepath,p as stringifyYaml,z as toCamelCase,T as toCapitalCase,S as toPascalCase,k as traverseFolder,A as traverseFolderSync};
+import{existsSync as t,mkdirSync as n,readFileSync as r,writeFileSync as o}from"fs";import e from"path";import{Config as i}from"load-config-file";import s from"path";function c(t,n=1){let r="";for(;n--;){const n=s.extname(t);if(!n)break;r=n+r,t=s.basename(t,n)}return r}import{parse as f,stringify as u}from"yaml";var a=[];function l(t){Array.isArray(t)||(t=[t]);for(const n of t){-1===a.indexOf(n)&&a.push(n)}}function m(t,n){if(n)if(n.customTags){if(Array.isArray(n.customTags))n.customTags=a.concat(n.customTags);else if("function"==typeof n.customTags){const t=n.customTags;n.customTags=n=>t(a.concat(n))}}else n.customTags=a;else n={customTags:a};return f(t,n)}function p(t,n){if(n)if(n.customTags){if(Array.isArray(n.customTags))n.customTags=a.concat(n.customTags);else if("function"==typeof n.customTags){const t=n.customTags;n.customTags=n=>t(a.concat(n))}}else n.customTags=a;else n={customTags:a};return u(t,n)}function y(t){const n=/^\s*(#[^\r\n]*)?[\r\n]+/;let r;for(;null!==(r=n.exec(t))&&((t=t.substring(r[0].length)).startsWith("\n")||t.startsWith("\r")||t.trimStart().startsWith("#")););return t}function g(t,n="---"){const r=n.length,o=y(t);if(o.startsWith(n)&&("\n"===o[n.length]||"\r"===o[n.length])){let t=o.indexOf("\n"+n,r);if(-1!==t){const e=o.slice(r,t);for(t+=n.length+1;"\n"===o[t]||"\r"===o[t];)t++;const i=o.slice(t);return{data:m(e)||{},content:i}}}return{data:{},content:t}}var h=class{static register(t,n,r){i.register(t,n),"string"==typeof t&&(t=[t]);for(const n of t)this.stringifys[n]=r}static loadSync(n,o){return function(n,{extLevel:o=1,externalFile:s}={}){n=x(n,o);let c=i.loadSync(n);if(!c&&s){if(!e.isAbsolute(s)){const t=e.dirname(n);s=e.join(t,s)}if(t(s)){const t=g(r(s,"utf8")).data;Object.keys(t).length&&(c=t)}}return c}(n,o)}static saveSync(r,i,s){return function(r,i,{extLevel:s=1}={}){const f=function(t,n=1){"."===t[0]&&n++;let r=c(t,n);(!r||r.split(".").length<=1)&&(t+=".yaml",r=".yaml");const o=new String(t);return o.extname=r,o}(r,s),u=f.extname;r=f.toString();const a=h.stringifys[u];if(!a)throw new Error(`${r} unsupported mime type: ${u}`);i=a(i);const l=e.dirname(r);t(l)||n(l,{recursive:!0});return o(r,i,{encoding:"utf8"}),r}(r,i,s)}static existsSync(t,n){return t=x(t,n?.extLevel),i.existsSync(t,n)}};function x(t,n=1){"."===t[0]&&n++;const r=c(t,n);return r&&r.split(".").length>1&&(t=t.slice(0,-r.length)),t}h.stringifys={},h.register([".yml",".yaml"],m,p),h.register([".json"],(function(t){return JSON.parse(t)}),(t=>JSON.stringify(t,null,2)));import{globMatch as d}from"@isdk/glob";import w from"path";function v(t,n,r){return r&&(t=w.relative(r,t)),d(t,n)}function $(t,n){return"string"==typeof n&&(n=[n]),-1!==n.indexOf(t)}var F=["**/*.((j|t)s?(x)|m(j|t)s)?(x)","**/*.(md|markdown|txt|?(x)htm?(l)|yaml|yml|xml|json|bat|sh|bash|zsh|ini|css|scss|less|sass|py|rb|php|go|java|c|cpp|h|hpp|hxx|rust|zig)"];function b(t,n=[]){if(t)if(Array.isArray(t))t=[...t];else{const r=t.include||[],o=t.exclude||[];0===r.length&&r.push(...n),t=[...r];for(const n of o)t.push(`!${n}`)}else t=[...n];return 0===t.length&&t.push(...n),t}import{readdir as S}from"fs/promises";import{readdirSync as E}from"fs";import j from"path";async function k(t,n){const r=await S(t,{withFileTypes:!0});for(const o of r){const r=j.join(t,o.name);try{if(o.isDirectory()){await n(r,o)||await k(r,n)}else{if(!0===await n(r,o))break}}catch(t){console.error(`Error processing file: ${r}`),console.error(t)}}}function A(t,n){const r=E(t,{withFileTypes:!0});for(const o of r){const r=j.join(t,o.name);try{if(o.isDirectory()){n(r,o)||k(r,n)}else{if(!0===n(r,o))break}}catch(t){console.error(`Error processing file: ${r}`),console.error(t)}}}function z(t){if(!t)return"";return t.replace(/[-_ ]+/g," ").split(" ").filter(Boolean).map((t=>t.charAt(0).toUpperCase()+t.slice(1))).join("")}function T(t){return(t=z(t)).charAt(0).toLowerCase()+t.slice(1)}function N(t){if(!t)return"";return t.replace(/[-_ ]+/g," ").replace(/([a-z])([A-Z])/g,"$1 $2").split(" ").filter(Boolean).map((t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase())).join(" ")}import O from"path";import{ErrorCode as R,throwError as B}from"@isdk/common-error";var J=/[<>:"/\\|?*\u0000-\u001F]/,L=/^(con|prn|aux|nul|com\d|lpt\d)$/i,_=/^\.+(\\|\/)|^\.+$/,C=/\.+$/,D=/[\u0000-\u001F\u0080-\u009F\u200E\u200F\u202A-\u202E\u2066-\u2069]/;function M(){return new RegExp(J.source,"g")}function Z(){return new RegExp(D.source,"g")}function q(t){return t&&!(J.test(t)||Z().test(t)||_.test(t)||C.test(t))}function G(t){const n=t.split(O.sep);return("/"===t[0]||n[0]&&O.dirname(n[0])===n[0])&&n.shift(),n.every(q)}function H(t,n={}){const r=n.replacement||"!";if((J.test(r)||D.test(r))&&B("Replacement string cannot contain reserved filename characters","sanitizeFilename",R.InvalidArgument),r.length>0){const n=/([<>:"/\\|?*\u0000-\u001F]){2,}/;t=t.replace(n,"$1")}if(t=(t=(t=(t=(t=t.normalize("NFD")).replace(_,r)).replace(M(),r)).replace(Z(),r)).replace(C,""),r.length>0){"."===t[0]||"."!==t[0]||(t=r+t),"."===t[t.length-1]&&(t+=r)}t=L.test(t)?t+r:t;const o="number"==typeof n.maxLength?n.maxLength:100;if(t.length>o){const n=t.lastIndexOf(".");if(-1===n)t=t.slice(0,o);else{const r=t.slice(0,n),e=t.slice(n);t=r.slice(0,Math.max(1,o-e.length))+e}}return t}function I(t,n={}){const r=t.split(O.sep);let o;("/"===t[0]||r[0]&&O.dirname(r[0])===r[0])&&(o=r.shift());const e=r.map((t=>H(t,n)));return void 0!==o&&e.unshift(o),e.join(O.sep)}function K(t){return t.split(".").length-1}function P(t,n){const r=new Set(n),o=new Set;for(const n of t)if(r.has(n)&&(o.add(n),o.size===r.size))return!0;return o.size===r.size}export{h as ConfigFile,F as DefaultAllTextFiles,J as FilenameReservedRegex,L as WindowsReservedNameRegex,P as arrayHasAll,K as extNameLevel,M as filenameReservedRegex,c as getMultiLevelExtname,v as glob,$ as isStringIn,q as isValidFilename,G as isValidFilepath,b as normalizeIncludeFiles,g as parseFrontMatter,m as parseYaml,Z as reControlCharsRegex,l as registerYamlTag,y as removeLeadingEmptyLines,H as sanitizeFilename,I as sanitizeFilepath,p as stringifyYaml,T as toCamelCase,N as toCapitalCase,z as toPascalCase,k as traverseFolder,A as traverseFolderSync};

package/docs/classes/ConfigFile.md

@@ -6,7 +6,7 @@
 
 # Class: ConfigFile
 
-Defined in: [config-file.ts:46](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L46)
+Defined in: [config-file.ts:46](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L46)
 
 Represents a configuration file utility class that provides methods to load and save configuration files.
 It supports multiple file formats such as YAML, JSON, etc., by registering corresponding parsers and stringifiers.
@@ -45,17 +45,66 @@ console.log(config); // Output: { key: 'value' }
 
 > `static` **stringifys**: `Record`\<`string`, [`StringifyFunc`](../type-aliases/StringifyFunc.md)\> = `{}`
 
-Defined in: [config-file.ts:50](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L50)
+Defined in: [config-file.ts:50](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L50)
 
 A record of registered stringify functions for different file extensions.
 
 ## Methods
 
+### existsSync()
+
+> `static` **existsSync**(`filename`, `options`?): `boolean`
+
+Defined in: [config-file.ts:132](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L132)
+
+Checks if a configuration file exists at the specified path.
+
+This method normalizes the filename by removing the extension (if present) and then delegates
+to the underlying LoadConfigFile utility to perform the existence check. The normalization
+ensures consistent handling of files regardless of whether they include extensions in the
+provided filename.
+
+#### Parameters
+
+##### filename
+
+`string`
+
+The path to the configuration file to check for existence.
+                 This can include or omit the file extension.
+
+##### options?
+
+[`LoadConfigFileOptions`](../interfaces/LoadConfigFileOptions.md)
+
+Optional configuration options that may affect how the file existence
+                is checked, including extension level handling.
+
+#### Returns
+
+`boolean`
+
+`true` if the configuration file exists, `false` otherwise.
+
+#### Example
+
+```typescript
+// Check if a YAML config file exists
+const exists = ConfigFile.existsSync('config.yaml');
+console.log(exists); // true or false
+
+// Check with options
+const existsWithExt = ConfigFile.existsSync('config', { extLevel: 2 });
+console.log(existsWithExt); // true or false
+```
+
+***
+
 ### loadSync()
 
 > `static` **loadSync**(`filename`, `options`?): `any`
 
-Defined in: [config-file.ts:85](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L85)
+Defined in: [config-file.ts:85](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L85)
 
 Loads a configuration file based on the provided filename and options.
 
@@ -92,7 +141,7 @@ console.log(config); // Output: { key: 'value' }
 
 > `static` **register**(`extname`, `parser`, `stringify`): `void`
 
-Defined in: [config-file.ts:64](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L64)
+Defined in: [config-file.ts:64](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L64)
 
 Registers a parser and stringifier for specific file extensions.
 
@@ -132,7 +181,7 @@ ConfigFile.register(['.json'], JSON.parse, (obj) => JSON.stringify(obj, null, 2)
 
 > `static` **saveSync**(`filename`, `config`, `options`?): `string`
 
-Defined in: [config-file.ts:102](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L102)
+Defined in: [config-file.ts:102](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L102)
 
 Saves a configuration object to a file with the specified filename and options.
 

package/docs/functions/arrayHasAll.md

@@ -8,7 +8,7 @@
 
 > **arrayHasAll**\<`T`\>(`array`, `elements`): `boolean`
 
-Defined in: [array-has-all.ts:15](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/array-has-all.ts#L15)
+Defined in: [array-has-all.ts:15](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/array-has-all.ts#L15)
 
 Checks whether the provided array contains all of the specified elements.
 

package/docs/functions/extNameLevel.md

@@ -8,7 +8,7 @@
 
 > **extNameLevel**(`extName`): `number`
 
-Defined in: [filename.ts:189](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L189)
+Defined in: [filename.ts:189](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L189)
 
 Calculates the level of an extension name.
 

package/docs/functions/filenameReservedRegex.md

@@ -8,7 +8,7 @@
 
 > **filenameReservedRegex**(): `RegExp`
 
-Defined in: [filename.ts:42](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L42)
+Defined in: [filename.ts:42](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L42)
 
 Returns a new regular expression instance for reserved filename characters with the 'g' flag.
 use this to reset the with global option

package/docs/functions/getMultiLevelExtname.md

@@ -8,7 +8,7 @@
 
 > **getMultiLevelExtname**(`filename`, `level`): `string`
 
-Defined in: [get-multi-level-extname.ts:9](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/get-multi-level-extname.ts#L9)
+Defined in: [get-multi-level-extname.ts:9](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/get-multi-level-extname.ts#L9)
 
 Retrieves multi-level file extension
 

package/docs/functions/glob.md

@@ -8,7 +8,7 @@
 
 > **glob**(`filepath`, `pattern`, `rootDir`?): `undefined` \| `boolean`
 
-Defined in: [glob.ts:29](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/glob.ts#L29)
+Defined in: [glob.ts:29](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/glob.ts#L29)
 
 Matches a file path against a list of glob patterns.
 

package/docs/functions/isStringIn.md

@@ -8,7 +8,7 @@
 
 > **isStringIn**(`str`, `arr`): `boolean`
 
-Defined in: [is-string-in.ts:17](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/is-string-in.ts#L17)
+Defined in: [is-string-in.ts:17](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/is-string-in.ts#L17)
 
 Checks if a given string exists within an array of strings or a single string.
 

package/docs/functions/isValidFilename.md

@@ -8,7 +8,7 @@
 
 > **isValidFilename**(`filename`): `boolean` \| `""`
 
-Defined in: [filename.ts:63](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L63)
+Defined in: [filename.ts:63](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L63)
 
 Validates if a given string is a valid filename.
 

package/docs/functions/isValidFilepath.md

@@ -8,7 +8,7 @@
 
 > **isValidFilepath**(`filepath`): `boolean`
 
-Defined in: [filename.ts:72](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L72)
+Defined in: [filename.ts:72](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L72)
 
 Validates whether the given filepath is valid.
 

package/docs/functions/normalizeIncludeFiles.md

@@ -8,7 +8,7 @@
 
 > **normalizeIncludeFiles**(`files`?, `defaultFiles`?): `string`[]
 
-Defined in: [include-files.ts:34](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/include-files.ts#L34)
+Defined in: [include-files.ts:34](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/include-files.ts#L34)
 
 Normalizes a list of file patterns for glob matching.
 

package/docs/functions/parseFrontMatter.md

@@ -8,7 +8,7 @@
 
 > **parseFrontMatter**(`value`, `delimiter`): `object`
 
-Defined in: [front-matter.ts:6](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/front-matter.ts#L6)
+Defined in: [front-matter.ts:6](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/front-matter.ts#L6)
 
 ## Parameters
 

package/docs/functions/parseYaml.md

@@ -8,7 +8,7 @@
 
 > **parseYaml**(`content`, `options`?): `any`
 
-Defined in: [yaml.ts:51](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/yaml.ts#L51)
+Defined in: [yaml.ts:51](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/yaml.ts#L51)
 
 Parses a YAML string into a JavaScript object with optional custom tags.
 

package/docs/functions/reControlCharsRegex.md

@@ -8,7 +8,7 @@
 
 > **reControlCharsRegex**(): `RegExp`
 
-Defined in: [filename.ts:50](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L50)
+Defined in: [filename.ts:50](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L50)
 
 Returns a new regular expression instance for control characters in a filename with the 'g' flag.
 

package/docs/functions/registerYamlTag.md

@@ -8,7 +8,7 @@
 
 > **registerYamlTag**(`tags`): `void`
 
-Defined in: [yaml.ts:23](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/yaml.ts#L23)
+Defined in: [yaml.ts:23](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/yaml.ts#L23)
 
 Registers custom YAML tags to be used in parsing and stringifying YAML content.
 

package/docs/functions/removeLeadingEmptyLines.md

@@ -8,7 +8,7 @@
 
 > **removeLeadingEmptyLines**(`text`): `string`
 
-Defined in: [remove-leading-empty-lines.ts:16](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/remove-leading-empty-lines.ts#L16)
+Defined in: [remove-leading-empty-lines.ts:16](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/remove-leading-empty-lines.ts#L16)
 
 Removes all leading empty lines or "#" comments line from the given string.
 

package/docs/functions/sanitizeFilename.md

@@ -8,7 +8,7 @@
 
 > **sanitizeFilename**(`filename`, `options`): `string`
 
-Defined in: [filename.ts:97](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L97)
+Defined in: [filename.ts:97](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L97)
 
 Sanitizes a given filename by replacing invalid characters with a specified replacement character or a default.
 

package/docs/functions/sanitizeFilepath.md

@@ -8,7 +8,7 @@
 
 > **sanitizeFilepath**(`filepath`, `options`): `string`
 
-Defined in: [filename.ts:149](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L149)
+Defined in: [filename.ts:149](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L149)
 
 Sanitizes each part of a file path and reassembles it, ensuring the path is valid according to provided options.
 

package/docs/functions/stringifyYaml.md

@@ -8,7 +8,7 @@
 
 > **stringifyYaml**(`content`, `options`?): `string`
 
-Defined in: [yaml.ts:85](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/yaml.ts#L85)
+Defined in: [yaml.ts:85](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/yaml.ts#L85)
 
 Converts a JavaScript object into a YAML string with optional custom tags.
 

package/docs/functions/toCamelCase.md

@@ -8,7 +8,7 @@
 
 > **toCamelCase**(`str`): `string`
 
-Defined in: [to-camel-case.ts:17](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/to-camel-case.ts#L17)
+Defined in: [to-camel-case.ts:17](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/to-camel-case.ts#L17)
 
 Converts a string to camelCase.
 

package/docs/functions/toCapitalCase.md

@@ -8,7 +8,7 @@
 
 > **toCapitalCase**(`str`): `string`
 
-Defined in: [to-capital-case.ts:17](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/to-capital-case.ts#L17)
+Defined in: [to-capital-case.ts:17](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/to-capital-case.ts#L17)
 
 Converts a string to capital case, where the first letter of each word is capitalized
 and the rest are in lowercase. Words are separated by spaces, hyphens, or underscores.

package/docs/functions/toPascalCase.md

@@ -8,7 +8,7 @@
 
 > **toPascalCase**(`str`): `string`
 
-Defined in: [to-pascal-case.ts:16](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/to-pascal-case.ts#L16)
+Defined in: [to-pascal-case.ts:16](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/to-pascal-case.ts#L16)
 
 Converts a string to PascalCase.
 

package/docs/functions/traverseFolder.md

@@ -8,7 +8,7 @@
 
 > **traverseFolder**(`directoryPath`, `fileHandler`): `Promise`\<`void`\>
 
-Defined in: [traverse-folder.ts:38](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/traverse-folder.ts#L38)
+Defined in: [traverse-folder.ts:38](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/traverse-folder.ts#L38)
 
 Traverses a folder asynchronously and applies a handler to each file or directory.
 

package/docs/functions/traverseFolderSync.md

@@ -8,7 +8,7 @@
 
 > **traverseFolderSync**(`directoryPath`, `fileHandler`): `void`
 
-Defined in: [traverse-folder.ts:76](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/traverse-folder.ts#L76)
+Defined in: [traverse-folder.ts:76](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/traverse-folder.ts#L76)
 
 Traverses a folder synchronously and applies a handler to each file or directory.
 

package/docs/interfaces/IncludeFiles.md

@@ -6,7 +6,7 @@
 
 # Interface: IncludeFiles
 
-Defined in: [include-files.ts:6](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/include-files.ts#L6)
+Defined in: [include-files.ts:6](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/include-files.ts#L6)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [include-files.ts:6](https://github.com/isdk/util.js/blob/37cf8e647a
 
 > `optional` **exclude**: `string`[]
 
-Defined in: [include-files.ts:8](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/include-files.ts#L8)
+Defined in: [include-files.ts:8](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/include-files.ts#L8)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [include-files.ts:8](https://github.com/isdk/util.js/blob/37cf8e647a
 
 > `optional` **include**: `string`[]
 
-Defined in: [include-files.ts:7](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/include-files.ts#L7)
+Defined in: [include-files.ts:7](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/include-files.ts#L7)

package/docs/interfaces/LoadConfigFileOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: LoadConfigFileOptions
 
-Defined in: [config-file.ts:20](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L20)
+Defined in: [config-file.ts:20](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L20)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [config-file.ts:20](https://github.com/isdk/util.js/blob/37cf8e647af
 
 > `optional` **externalFile**: `string`
 
-Defined in: [config-file.ts:22](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L22)
+Defined in: [config-file.ts:22](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L22)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [config-file.ts:22](https://github.com/isdk/util.js/blob/37cf8e647af
 
 > `optional` **extLevel**: `number`
 
-Defined in: [config-file.ts:21](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L21)
+Defined in: [config-file.ts:21](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L21)

package/docs/interfaces/SanitizeFilenameOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: SanitizeFilenameOptions
 
-Defined in: [filename.ts:83](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L83)
+Defined in: [filename.ts:83](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L83)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [filename.ts:83](https://github.com/isdk/util.js/blob/37cf8e647afe11
 
 > `optional` **maxLength**: `number`
 
-Defined in: [filename.ts:85](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L85)
+Defined in: [filename.ts:85](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L85)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [filename.ts:85](https://github.com/isdk/util.js/blob/37cf8e647afe11
 
 > `optional` **replacement**: `string`
 
-Defined in: [filename.ts:84](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L84)
+Defined in: [filename.ts:84](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L84)

package/docs/type-aliases/StringifyFunc.md

@@ -8,7 +8,7 @@
 
 > **StringifyFunc** = (`content`) => `string`
 
-Defined in: [config-file.ts:18](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/config-file.ts#L18)
+Defined in: [config-file.ts:18](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/config-file.ts#L18)
 
 ## Parameters
 

package/docs/type-aliases/TraverseFolderHandler.md

@@ -8,7 +8,7 @@
 
 > **TraverseFolderHandler** = (`filePath`, `entry`) => `boolean` \| `void` \| `Promise`\<`boolean` \| `void`\>
 
-Defined in: [traverse-folder.ts:11](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/traverse-folder.ts#L11)
+Defined in: [traverse-folder.ts:11](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/traverse-folder.ts#L11)
 
 A handler function for asynchronous folder traversal.
 

package/docs/type-aliases/TraverseFolderSyncHandler.md

@@ -8,7 +8,7 @@
 
 > **TraverseFolderSyncHandler** = (`filePath`, `entry`) => `boolean` \| `void`
 
-Defined in: [traverse-folder.ts:18](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/traverse-folder.ts#L18)
+Defined in: [traverse-folder.ts:18](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/traverse-folder.ts#L18)
 
 A handler function for synchronous folder traversal.
 

package/docs/variables/DefaultAllTextFiles.md

@@ -8,4 +8,4 @@
 
 > `const` **DefaultAllTextFiles**: `string`[]
 
-Defined in: [include-files.ts:1](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/include-files.ts#L1)
+Defined in: [include-files.ts:1](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/include-files.ts#L1)

package/docs/variables/FilenameReservedRegex.md

@@ -8,7 +8,7 @@
 
 > `const` **FilenameReservedRegex**: `RegExp`
 
-Defined in: [filename.ts:8](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L8)
+Defined in: [filename.ts:8](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L8)
 
 Regular expression pattern for reserved characters in a filename.
 do not use /g global option here: when the regex is executed multiple times, it will always begin where it left off last time.

package/docs/variables/WindowsReservedNameRegex.md

@@ -8,6 +8,6 @@
 
 > `const` **WindowsReservedNameRegex**: `RegExp`
 
-Defined in: [filename.ts:13](https://github.com/isdk/util.js/blob/37cf8e647afe115375188dc281429b45345985c4/src/filename.ts#L13)
+Defined in: [filename.ts:13](https://github.com/isdk/util.js/blob/e52ad0627fc33dea09d8db6ef431d619770364c0/src/filename.ts#L13)
 
 Regular expression pattern for reserved names on Windows systems.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@isdk/util",
   "description": "a set of utility functions",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "author": "Riceball LEE @snowyu",
   "bugs": "https://github.com/isdk/util.js/issues",
   "dependencies": {
     "@isdk/common-error": "^0.1.4",
     "@isdk/glob": "^0.1.0",
-    "load-config-file": "2.0.0",
+    "load-config-file": "^2.1.0",
     "yaml": "^2.7.0"
   },
   "devDependencies": {