@awesomeness-js/utils 1.0.14 → 1.0.15

package/{build.js → build/build.js}

@@ -1,11 +1,11 @@
-import build from './src/build.js';
-
+import build from '../src/build.js';
 build({
     src: './src',
     dest: './index.js',
+    dts: false,
     ignore: [
         'ignoreMe.js',
         'ignoreFolder/*',
-        'namespaceExample/*',
+        //'namespaceExample/*',
     ],
 });

package/build/postBuild.js

@@ -0,0 +1,11 @@
+import build from '../src/build.js';
+build({ 
+    src: './src', 
+    dest: './types/index.d.ts', 
+    dts: true,
+    ignore: [
+        'ignoreMe.js',
+        'ignoreFolder/*',
+        //'namespaceExample/*',
+    ],
+});

package/index.js

@@ -13,6 +13,16 @@ import _isUUID from './src/isUUID.js';
 import _md5 from './src/md5.js';
 import _setLocalEnvs from './src/setLocalEnvs.js';
 import _toPennies from './src/toPennies.js';
+import _utils_buildExportsTree from './src/utils/buildExportsTree.js';
+import _utils_buildFileDataList from './src/utils/buildFileDataList.js';
+import _utils_extractJSDocComment from './src/utils/extractJSDocComment.js';
+import _utils_generateFile from './src/utils/generateFile.js';
+import _utils_generateFlatExportLines from './src/utils/generateFlatExportLines.js';
+import _utils_generateImportStatements from './src/utils/generateImportStatements.js';
+import _utils_generateNamedExports from './src/utils/generateNamedExports.js';
+import _utils_generateNamespaceCode from './src/utils/generateNamespaceCode.js';
+import _utils_generateNamespaceExportLines from './src/utils/generateNamespaceExportLines.js';
+import _utils_shouldIgnore from './src/utils/shouldIgnore.js';
 import _uuid from './src/uuid.js';
 
 export { _build as build };
@@ -28,7 +38,18 @@ export { _toPennies as toPennies };
 export { _uuid as uuid };
 
 export default {
-    /**${match[1]}*/
+    /**
+     * Builds a file from the specified source directory and writes it to the destination file.
+     *
+     * @param {Object} options - The options for the build process.
+     * @param {string} [options.src='./src'] - The source directory to build from.
+     * @param {string} [options.dest='./index.js'] - The destination file to write the built content to.
+     * @param {boolean} [options.exportRoots=true] - Whether to export root files.
+     * @param {string[]} [options.ignore=[]] - An array of file patterns to ignore.
+     * @param {boolean} [options.includeComments=true] - Whether to include comments in the generated file.
+     * @param {boolean} [options.dts=false] - Whether to generate TypeScript declaration files.
+     * @returns {Promise<boolean>} A promise that resolves to true when the build is complete.
+     */
     build: _build,
     combineFiles: _combineFiles,
     /**
@@ -47,4 +68,16 @@ export default {
     setLocalEnvs: _setLocalEnvs,
     toPennies: _toPennies,
     uuid: _uuid,
+    utils: {
+        buildExportsTree: _utils_buildExportsTree,
+        buildFileDataList: _utils_buildFileDataList,
+        extractJSDocComment: _utils_extractJSDocComment,
+        generateFile: _utils_generateFile,
+        generateFlatExportLines: _utils_generateFlatExportLines,
+        generateImportStatements: _utils_generateImportStatements,
+        generateNamedExports: _utils_generateNamedExports,
+        generateNamespaceCode: _utils_generateNamespaceCode,
+        generateNamespaceExportLines: _utils_generateNamespaceExportLines,
+        shouldIgnore: _utils_shouldIgnore,
+    },
 };

package/package.json

@@ -1,11 +1,16 @@
 {
     "name": "@awesomeness-js/utils",
-    "version": "1.0.14",
+    "version": "1.0.15",
     "description": "Awesomeness - Utils",
     "repository": {
       "type": "git",
       "url": "git+https://github.com/awesomeness-js/utils.git"
     },
+    "scripts": {
+      "prebuild": "node ./build/build.js",
+      "build": "tsc && npm run postBuild",
+      "postBuild": "node ./build/postBuild.js"
+    },    
     "type": "module",
     "main": "index.js",
     "author": "Scott Forte",

package/src/build.js

@@ -1,184 +1,27 @@
-import { readdirSync, statSync, writeFileSync, readFileSync } from 'fs';
-import { join, sep } from 'path';
-
-function shouldIgnore(filePath, ignorePatterns) {
-    const ignore = ignorePatterns.some(pattern => {
-        const normalizedPath = filePath.replace(/\\/g, '/');
-        const normalizedPattern = pattern.replace(/\\/g, '/');
-        if (normalizedPath === normalizedPattern) return true;
-        if (normalizedPattern.endsWith('/*')) {
-            const baseDir = normalizedPattern.slice(0, -2);
-            return normalizedPath.startsWith(baseDir + '/');
-        }
-        if (normalizedPattern.endsWith('/')) {
-            return normalizedPath === normalizedPattern.slice(0, -1) ||
-                   normalizedPath.startsWith(normalizedPattern);
-        }
-        return false;
-    });
-    //console.log('shouldIgnore', filePath, ignore);
-    return ignore;
-}
-
-function getAllFiles(base, dir, files = [], ignore = []) {
-    const directory = join(base, dir);
-    const normalizedDir = dir.replace(/\\/g, '/');
-    if (ignore.some(pattern => normalizedDir.startsWith(pattern.replace(/\/\*$/, '')))) {
-        //.log('Ignoring folder:', normalizedDir);
-        return files;
-    }
-    let sortedFiles = readdirSync(directory).sort();
-    sortedFiles.forEach(file => {
-        const fullPath = join(directory, file);
-        const relativePath = join(dir, file).replace(/\\/g, '/');
-        if (shouldIgnore(relativePath, ignore)) {
-            //console.log('Ignoring file:', relativePath);
-            return;
-        }
-        if (statSync(fullPath).isDirectory() && file !== '_template') {
-            getAllFiles(base, join(dir, file), files, ignore);
-        } else if (file.endsWith('.js') && !file.match(/\..*\./)) {
-            files.push(relativePath);
-        }
-    });
-    return files;
-}
-
-function extractJSDocComment(filePath) {
-    const fileContent = readFileSync(filePath, 'utf8');
-    const match = fileContent.match(/\/\*\*([\s\S]*?)\*\//);
-    return match ? `/**${match[1]}*/` : '';
-}
-
 /**
- * Generates the export file contents.
+ * Builds a file from the specified source directory and writes it to the destination file.
  *
- * For each file, if includeComments is true, its JSDoc comment is placed
- * immediately above its key in the default export object.
+ * @param {Object} options - The options for the build process.
+ * @param {string} [options.src='./src'] - The source directory to build from.
+ * @param {string} [options.dest='./index.js'] - The destination file to write the built content to.
+ * @param {boolean} [options.exportRoots=true] - Whether to export root files.
+ * @param {string[]} [options.ignore=[]] - An array of file patterns to ignore.
+ * @param {boolean} [options.includeComments=true] - Whether to include comments in the generated file.
+ * @param {boolean} [options.dts=false] - Whether to generate TypeScript declaration files.
+ * @returns {Promise<boolean>} A promise that resolves to true when the build is complete.
  */
-function generateExports(src, exportRoots, ignore, includeComments = false) {
-    const allFiles = getAllFiles(src, '.', [], ignore);
-    let importStatements = '';
-    let flatExports = [];
-    let nestedExports = {}; // Build a tree for nested exports
-
-    // Create file info objects
-    const fileDataList = allFiles.map(file => {
-        const normalizedFile = file.replace(/\\/g, '/');
-        const parts = normalizedFile.split('/');
-        const fileName = parts.pop();
-        const functionName = fileName.replace(/\.js$/, '');
-        const namespaceParts = parts;
-        const importVarName = namespaceParts.length > 0
-            ? '_' + [...namespaceParts, functionName].join('_')
-            : '_' + functionName;
-        const importPath = src + '/' + normalizedFile.replace(/\.js$/, '');
-        const jsDocComment = includeComments ? extractJSDocComment(join(src, normalizedFile)) : '';
-        return { normalizedFile, parts: namespaceParts, functionName, importVarName, importPath, jsDocComment };
-    });
-
-    // Generate import statements (without comments)
-    fileDataList.forEach(({ importVarName, importPath }) => {
-        importStatements += `import ${importVarName} from '${importPath}.js';\n`;
-    });
-
-    // Build flat exports and nested export tree.
-    fileDataList.forEach(({ parts, functionName, importVarName, jsDocComment }) => {
-        if (parts.length === 0) {
-            flatExports.push({ functionName, importVarName, jsDocComment });
-        } else {
-            let current = nestedExports;
-            parts.forEach(part => {
-                if (!current[part]) {
-                    current[part] = {};
-                }
-                current = current[part];
-            });
-            // Store the leaf export along with its JSDoc comment.
-            current[functionName] = { importVarName, jsDocComment };
-        }
-    });
-
-    // Generate flat export statements for default export object.
-    let flatExportLines = '';
-    flatExports.forEach(({ functionName, importVarName, jsDocComment }) => {
-        if (exportRoots) {
-            if (includeComments && jsDocComment) {
-                // Indent each comment line by 4 spaces.
-                const indentedComment = jsDocComment.split('\n').map(line => '    ' + line).join('\n');
-                flatExportLines += indentedComment + '\n';
-            }
-            flatExportLines += `    ${functionName}: ${importVarName},\n`;
-        }
-    });
-
-    // Recursively generate code for nested namespaces,
-    // placing JSDoc comments above each leaf key.
-    function generateNamespaceCode(nsObj, indentLevel) {
-        const indent = '    '.repeat(indentLevel);
-        let lines = ['{'];
-        for (const key in nsObj) {
-            const value = nsObj[key];
-            if (typeof value === 'object' && value.hasOwnProperty('importVarName')) {
-                // Leaf node.
-                if (includeComments && value.jsDocComment) {
-                    const indentedComment = value.jsDocComment.split('\n').map(line => indent + '    ' + line).join('\n');
-                    lines.push(indentedComment);
-                }
-                lines.push(`${indent}    ${key}: ${value.importVarName},`);
-            } else {
-                // Nested namespace.
-                const nestedCode = generateNamespaceCode(value, indentLevel + 1);
-                lines.push(`${indent}    ${key}: ${nestedCode},`);
-            }
-        }
-        lines.push(indent + '}');
-        return lines.join('\n');
-    }
-
-    // Generate the default export object.
-    let namespaceExportLines = '';
-    for (const ns in nestedExports) {
-        const nsCode = generateNamespaceCode(nestedExports[ns], 1);
-        namespaceExportLines += `    ${ns}: ${nsCode},\n`;
-    }
-
-    const defaultExportCode = 'export default {\n' +
-        flatExportLines +
-        namespaceExportLines +
-        '};';
-
-    // Generate individual flat export statements.
-    let flatExportStatements = '';
-    flatExports.forEach(({ functionName, importVarName }) => {
-        if (exportRoots) {
-            flatExportStatements += `export { ${importVarName} as ${functionName} };\n`;
-        }
-    });
-
-    const headerComment = `/**
- * This file is auto-generated by the build script.
- * It consolidates API functions for use in the application.
- * Do not edit manually.
- */
-`;
-
-    return headerComment +
-           importStatements + '\n' +
-           flatExportStatements +
-           '\n' +
-           defaultExportCode;
-}
+import { writeFileSync } from 'fs';
+import generateFile from './utils/generateFile.js';
 
 async function build({
     src = './src',
     dest = './index.js',
     exportRoots = true,
     ignore = [],
-    includeComments = true
+    includeComments = true,
+    dts = false
 } = {}) {
-    const indexContent = generateExports(src, exportRoots, ignore, includeComments);
-    writeFileSync(dest, indexContent);
+    writeFileSync(dest, generateFile(src, exportRoots, ignore, includeComments, dts));
     return true;
 }
 

package/src/getAllFiles.js

@@ -1,24 +1,25 @@
-import fs from 'fs';
-import path from 'path';
+import { readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import shouldIgnore from './utils/shouldIgnore.js';
 
-function getAllFiles(dirPath = './', arrayOfFiles = []){
-
-  const items = fs.readdirSync(dirPath);
-
-  items.forEach((item) => {
-    const fullPath = path.resolve(dirPath, item);
-
-    if (fs.statSync(fullPath).isDirectory()) {
-      // Recurse into the directory
-      getAllFiles(fullPath, arrayOfFiles);
-    } else {
-      // Add only files
-      arrayOfFiles.push(fullPath);
-    }
+export default function getAllFiles(base, dir, files = [], ignore = []) {
+  const directory = join(base, dir);
+  const normalizedDir = dir.replace(/\\/g, '/');
+  if (ignore.some(pattern => normalizedDir.startsWith(pattern.replace(/\/\*$/, '')))) {
+      return files;
+  }
+  const sortedFiles = readdirSync(directory).sort();
+  sortedFiles.forEach(file => {
+      const fullPath = join(directory, file);
+      const relativePath = join(dir, file).replace(/\\/g, '/');
+      if (shouldIgnore(relativePath, ignore)) {
+          return;
+      }
+      if (statSync(fullPath).isDirectory()) {
+          getAllFiles(base, join(dir, file), files, ignore);
+      } else if (file.endsWith('.js') && !file.match(/\..*\./)) {
+          files.push(relativePath);
+      }
   });
-
-  return arrayOfFiles;
-
-};
-
-export default getAllFiles;
+  return files;
+}

package/src/utils/buildExportsTree.js

@@ -0,0 +1,19 @@
+export default function buildExportsTree(fileDataList) {
+    const flatExports = [];
+    const nestedExports = {};
+    fileDataList.forEach(({ parts, functionName, importVarName, jsDocComment }) => {
+        if (parts.length === 0) {
+            flatExports.push({ functionName, importVarName, jsDocComment });
+        } else {
+            let current = nestedExports;
+            parts.forEach(part => {
+                if (!current[part]) {
+                    current[part] = {};
+                }
+                current = current[part];
+            });
+            current[functionName] = { importVarName, jsDocComment };
+        }
+    });
+    return { flatExports, nestedExports };
+}

package/src/utils/buildFileDataList.js

@@ -0,0 +1,20 @@
+import getAllFiles from '../getAllFiles.js';
+import extractJSDocComment from './extractJSDocComment.js';
+import { join } from 'path';
+
+export default function buildFileDataList(src, ignore, includeComments) {
+    const allFiles = getAllFiles(src, '.', [], ignore);
+    return allFiles.map(file => {
+        const normalizedFile = file.replace(/\\/g, '/');
+        const parts = normalizedFile.split('/');
+        const fileName = parts.pop();
+        const functionName = fileName.replace(/\.js$/, '');
+        const namespaceParts = parts;
+        const importVarName = namespaceParts.length > 0
+            ? '_' + [...namespaceParts, functionName].join('_')
+            : '_' + functionName;
+        const importPath = src + '/' + normalizedFile.replace(/\.js$/, '');
+        const jsDocComment = includeComments ? extractJSDocComment(join(src, normalizedFile)) : '';
+        return { normalizedFile, parts: namespaceParts, functionName, importVarName, importPath, jsDocComment };
+    });
+}

package/src/utils/extractJSDocComment.js

@@ -0,0 +1,11 @@
+import { readFileSync } from 'fs';
+
+export default function extractJSDocComment(filePath) {
+    const fileContent = readFileSync(filePath, 'utf8');
+    const match = fileContent.match(/\/\*\*([\s\S]*?)\*\//);
+    // If the match exists and doesn't contain an unresolved template placeholder, return it.
+    if (match && match[1] && !match[1].includes('${')) {
+        return `/**${match[1]}*/`;
+    }
+    return '';
+}

package/src/utils/generateFile.js

@@ -0,0 +1,34 @@
+import buildFileDataList from './buildFileDataList.js';
+import buildExportsTree from './buildExportsTree.js';
+import generateImportStatements from './generateImportStatements.js';
+import generateFlatExportLines from './generateFlatExportLines.js';
+import generateNamespaceExportLines from './generateNamespaceExportLines.js';
+import generateNamedExports from './generateNamedExports.js';
+
+export default function generateFile(src, exportRoots, ignore, includeComments, dts) {
+    const fileDataList = buildFileDataList(src, ignore, includeComments);
+    const { flatExports, nestedExports } = buildExportsTree(fileDataList);
+    const headerComment = `/**
+ * This file is auto-generated by the build script.
+ * It consolidates API ${dts ? 'type declarations' : 'functions'} for use in the application.
+ * Do not edit manually.
+ */
+`;
+    const importStatements = generateImportStatements(fileDataList, dts, src);
+    const flatExportLines = generateFlatExportLines(flatExports, exportRoots, includeComments, dts);
+    const namespaceExportLines = generateNamespaceExportLines(nestedExports, includeComments, dts);
+    const defaultExportCode = dts
+        ? 'declare const _default: {\n' +
+          flatExportLines +
+          namespaceExportLines +
+          '};\n\nexport default _default;\n'
+        : 'export default {\n' +
+          flatExportLines +
+          namespaceExportLines +
+          '};';
+    const namedExports = generateNamedExports(flatExports, exportRoots, dts);
+    return headerComment +
+           importStatements + '\n' +
+           namedExports + '\n' +
+           defaultExportCode;
+}

package/src/utils/generateFlatExportLines.js

@@ -0,0 +1,18 @@
+export default function generateFlatExportLines(flatExports, exportRoots, includeComments, dts) {
+    let lines = '';
+    if (exportRoots) {
+        flatExports.forEach(({ functionName, importVarName, jsDocComment }) => {
+            if (includeComments && jsDocComment) {
+                const indentedComment = jsDocComment
+                    .split('\n')
+                    .map(line => '    ' + line)
+                    .join('\n');
+                lines += indentedComment + '\n';
+            }
+            lines += dts
+                ? `    ${functionName}: typeof ${importVarName};\n`
+                : `    ${functionName}: ${importVarName},\n`;
+        });
+    }
+    return lines;
+}

package/src/utils/generateImportStatements.js

@@ -0,0 +1,9 @@
+export default function generateImportStatements(fileDataList, dts, src) {
+    let statements = '';
+    fileDataList.forEach(({ importVarName, importPath }) => {
+        statements += dts
+            ? `import type ${importVarName} from '.${importPath.replace(src,'')}';\n`
+            : `import ${importVarName} from '${importPath}.js';\n`;
+    });
+    return statements;
+}

package/src/utils/generateNamedExports.js

@@ -0,0 +1,11 @@
+export default function generateNamedExports(flatExports, exportRoots, dts) {
+    let lines = '';
+    if (exportRoots) {
+        flatExports.forEach(({ functionName, importVarName }) => {
+            lines += dts
+                ? `export declare const ${functionName}: typeof ${importVarName};\n`
+                : `export { ${importVarName} as ${functionName} };\n`;
+        });
+    }
+    return lines;
+}

package/src/utils/generateNamespaceCode.js

@@ -0,0 +1,25 @@
+export default function generateNamespaceCode(nsObj, indentLevel, includeComments, dts) {
+    const indent = '    '.repeat(indentLevel);
+    let lines = ['{'];
+    for (const key in nsObj) {
+        const value = nsObj[key];
+        if (typeof value === 'object' && value.hasOwnProperty('importVarName')) {
+            if (includeComments && value.jsDocComment) {
+                const indentedComment = value.jsDocComment
+                    .split('\n')
+                    .map(line => indent + '    ' + line)
+                    .join('\n');
+                lines.push(indentedComment);
+            }
+            lines.push(dts
+                ? `${indent}    ${key}: typeof ${value.importVarName},`
+                : `${indent}    ${key}: ${value.importVarName},`
+            );
+        } else {
+            const nestedCode = generateNamespaceCode(value, indentLevel + 1, includeComments, dts);
+            lines.push(`${indent}    ${key}: ${nestedCode},`);
+        }
+    }
+    lines.push(indent + '}');
+    return lines.join('\n');
+}

package/src/utils/generateNamespaceExportLines.js

@@ -0,0 +1,10 @@
+import generateNamespaceCode from './generateNamespaceCode.js';
+
+export default function generateNamespaceExportLines(nestedExports, includeComments, dts) {
+    let lines = '';
+    for (const ns in nestedExports) {
+        const nsCode = generateNamespaceCode(nestedExports[ns], 1, includeComments, dts);
+        lines += `    ${ns}: ${nsCode},\n`;
+    }
+    return lines;
+}

package/src/utils/shouldIgnore.js

@@ -0,0 +1,17 @@
+export default function shouldIgnore(filePath, ignorePatterns) {
+    const ignore = ignorePatterns.some(pattern => {
+        const normalizedPath = filePath.replace(/\\/g, '/');
+        const normalizedPattern = pattern.replace(/\\/g, '/');
+        if (normalizedPath === normalizedPattern) return true;
+        if (normalizedPattern.endsWith('/*')) {
+            const baseDir = normalizedPattern.slice(0, -2);
+            return normalizedPath.startsWith(baseDir + '/');
+        }
+        if (normalizedPattern.endsWith('/')) {
+            return normalizedPath === normalizedPattern.slice(0, -1) ||
+                   normalizedPath.startsWith(normalizedPattern);
+        }
+        return false;
+    });
+    return ignore;
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "declaration": true,        // Generates .d.ts files
+    "emitDeclarationOnly": true, // Only output .d.ts files
+    "allowJs": true,            // Allows JS files
+    "outDir": "types",          // Output directory for type files
+    "moduleResolution": "node",
+    "skipLibCheck": true,
+    "esModuleInterop": true
+  },
+  "include": ["src/**/*"],
+  "exclude": [
+    "./src/ignoreFolder/**/*", 
+    "./src/ignoreMe.js"
+  ]
+}

package/types/build.d.ts

@@ -0,0 +1,9 @@
+export default build;
+declare function build({ src, dest, exportRoots, ignore, includeComments, dts }?: {
+    src?: string;
+    dest?: string;
+    exportRoots?: boolean;
+    ignore?: any[];
+    includeComments?: boolean;
+    dts?: boolean;
+}): Promise<boolean>;

package/types/combineFiles.d.ts

@@ -0,0 +1,5 @@
+export default combineFiles;
+declare function combineFiles(dir: any, fileType: any, { minify, moduleToBrowser, }?: {
+    minify?: boolean;
+    moduleToBrowser?: boolean;
+}): string;

package/types/convertBytes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts a given number of bytes into a more readable string format with appropriate units.
+ *
+ * @param {number} bytes - The number of bytes to convert.
+ * @param {number} [precision=2] - The number of decimal places to include in the result.
+ * @returns {string} The converted bytes in a string format with appropriate units.
+ */
+export default function convertBytes(bytes: number, precision?: number): string;

package/types/each.d.ts

@@ -0,0 +1 @@
+export default function each(objectOrArray: any, callback: any): void;

package/types/eachAsync.d.ts

@@ -0,0 +1 @@
+export default function eachAsync(objectOrArray: any, callback: any): Promise<void>;

package/types/getAllFiles.d.ts

@@ -0,0 +1 @@
+export default function getAllFiles(base: any, dir: any, files?: any[], ignore?: any[]): any[];

package/types/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * This file is auto-generated by the build script.
+ * It consolidates API type declarations for use in the application.
+ * Do not edit manually.
+ */
+import type _build from './build';
+import type _combineFiles from './combineFiles';
+import type _convertBytes from './convertBytes';
+import type _each from './each';
+import type _eachAsync from './eachAsync';
+import type _getAllFiles from './getAllFiles';
+import type _isUUID from './isUUID';
+import type _md5 from './md5';
+import type _setLocalEnvs from './setLocalEnvs';
+import type _toPennies from './toPennies';
+import type _utils_buildExportsTree from './utils/buildExportsTree';
+import type _utils_buildFileDataList from './utils/buildFileDataList';
+import type _utils_extractJSDocComment from './utils/extractJSDocComment';
+import type _utils_generateFile from './utils/generateFile';
+import type _utils_generateFlatExportLines from './utils/generateFlatExportLines';
+import type _utils_generateImportStatements from './utils/generateImportStatements';
+import type _utils_generateNamedExports from './utils/generateNamedExports';
+import type _utils_generateNamespaceCode from './utils/generateNamespaceCode';
+import type _utils_generateNamespaceExportLines from './utils/generateNamespaceExportLines';
+import type _utils_shouldIgnore from './utils/shouldIgnore';
+import type _uuid from './uuid';
+
+export declare const build: typeof _build;
+export declare const combineFiles: typeof _combineFiles;
+export declare const convertBytes: typeof _convertBytes;
+export declare const each: typeof _each;
+export declare const eachAsync: typeof _eachAsync;
+export declare const getAllFiles: typeof _getAllFiles;
+export declare const isUUID: typeof _isUUID;
+export declare const md5: typeof _md5;
+export declare const setLocalEnvs: typeof _setLocalEnvs;
+export declare const toPennies: typeof _toPennies;
+export declare const uuid: typeof _uuid;
+
+declare const _default: {
+    /**
+     * Builds a file from the specified source directory and writes it to the destination file.
+     *
+     * @param {Object} options - The options for the build process.
+     * @param {string} [options.src='./src'] - The source directory to build from.
+     * @param {string} [options.dest='./index.js'] - The destination file to write the built content to.
+     * @param {boolean} [options.exportRoots=true] - Whether to export root files.
+     * @param {string[]} [options.ignore=[]] - An array of file patterns to ignore.
+     * @param {boolean} [options.includeComments=true] - Whether to include comments in the generated file.
+     * @param {boolean} [options.dts=false] - Whether to generate TypeScript declaration files.
+     * @returns {Promise<boolean>} A promise that resolves to true when the build is complete.
+     */
+    build: typeof _build;
+    combineFiles: typeof _combineFiles;
+    /**
+     * Converts a given number of bytes into a more readable string format with appropriate units.
+     *
+     * @param {number} bytes - The number of bytes to convert.
+     * @param {number} [precision=2] - The number of decimal places to include in the result.
+     * @returns {string} The converted bytes in a string format with appropriate units.
+     */
+    convertBytes: typeof _convertBytes;
+    each: typeof _each;
+    eachAsync: typeof _eachAsync;
+    getAllFiles: typeof _getAllFiles;
+    isUUID: typeof _isUUID;
+    md5: typeof _md5;
+    setLocalEnvs: typeof _setLocalEnvs;
+    toPennies: typeof _toPennies;
+    uuid: typeof _uuid;
+    utils: {
+        buildExportsTree: typeof _utils_buildExportsTree,
+        buildFileDataList: typeof _utils_buildFileDataList,
+        extractJSDocComment: typeof _utils_extractJSDocComment,
+        generateFile: typeof _utils_generateFile,
+        generateFlatExportLines: typeof _utils_generateFlatExportLines,
+        generateImportStatements: typeof _utils_generateImportStatements,
+        generateNamedExports: typeof _utils_generateNamedExports,
+        generateNamespaceCode: typeof _utils_generateNamespaceCode,
+        generateNamespaceExportLines: typeof _utils_generateNamespaceExportLines,
+        shouldIgnore: typeof _utils_shouldIgnore,
+    },
+};
+
+export default _default;

package/types/isUUID.d.ts

@@ -0,0 +1 @@
+export default function isUUID(uuid: any): boolean;

package/types/md5.d.ts

@@ -0,0 +1,2 @@
+export default md5;
+declare function md5(data: any): any;

package/types/setLocalEnvs.d.ts

@@ -0,0 +1,2 @@
+declare function _default(localSecretsPath?: string): Promise<void>;
+export default _default;

package/types/toPennies.d.ts

@@ -0,0 +1 @@
+export default function toPennies(uglyMoney: any): number;

package/types/utils/buildExportsTree.d.ts

@@ -0,0 +1,4 @@
+export default function buildExportsTree(fileDataList: any): {
+    flatExports: any[];
+    nestedExports: {};
+};

package/types/utils/buildFileDataList.d.ts

@@ -0,0 +1,8 @@
+export default function buildFileDataList(src: any, ignore: any, includeComments: any): {
+    normalizedFile: any;
+    parts: any;
+    functionName: any;
+    importVarName: string;
+    importPath: string;
+    jsDocComment: string;
+}[];

package/types/utils/extractJSDocComment.d.ts

@@ -0,0 +1 @@
+export default function extractJSDocComment(filePath: any): string;

package/types/utils/generateFile.d.ts

@@ -0,0 +1 @@
+export default function generateFile(src: any, exportRoots: any, ignore: any, includeComments: any, dts: any): string;

package/types/utils/generateFlatExportLines.d.ts

@@ -0,0 +1 @@
+export default function generateFlatExportLines(flatExports: any, exportRoots: any, includeComments: any, dts: any): string;

package/types/utils/generateImportStatements.d.ts

@@ -0,0 +1 @@
+export default function generateImportStatements(fileDataList: any, dts: any, src: any): string;

package/types/utils/generateNamedExports.d.ts

@@ -0,0 +1 @@
+export default function generateNamedExports(flatExports: any, exportRoots: any, dts: any): string;

package/types/utils/generateNamespaceCode.d.ts

@@ -0,0 +1 @@
+export default function generateNamespaceCode(nsObj: any, indentLevel: any, includeComments: any, dts: any): string;

package/types/utils/generateNamespaceExportLines.d.ts

@@ -0,0 +1 @@
+export default function generateNamespaceExportLines(nestedExports: any, includeComments: any, dts: any): string;

package/types/utils/shouldIgnore.d.ts

@@ -0,0 +1 @@
+export default function shouldIgnore(filePath: any, ignorePatterns: any): any;

package/types/uuid.d.ts

@@ -0,0 +1,2 @@
+export default uuid;
+declare function uuid(): string;

package/src/namespaceExample/deep/deep.js

@@ -1,10 +0,0 @@
-
-/**
- * A function that returns the input value.
- *
- * @param {*} something - The input value to be returned.
- * @returns {*} The same value that was passed as input.
- */
-export default function deep(something) {
-    return something;
-}

package/src/namespaceExample/example.js

@@ -1,3 +0,0 @@
-export default function example() {
-    return true
-}