@awesomeness-js/utils 1.1.3 → 1.1.5

package/README.md

@@ -36,7 +36,7 @@ Webpack is a great bundler, but it’s not suited for building a structured expo
 ✔ **Simple and predictable**—You control how exports are structured.  
 ✔ **Namespace support**—Uses folder structure to organize functions logically.  
 ✔ **Minimal setup** — one line to generate your exports  
-✔ **Dev-friendly hot rebuild** — optional file watching with HMR-style rebuilds  
+
 
 > Uses `chokidar` under the hood for reliable cross-platform file watching.
 
@@ -75,7 +75,6 @@ await build({
   dest: './api.js',
   includeComments: true,
   useTabs: true,
-  hotModuleReload: true // Enable hot reload for dev
 });
 ```
 
@@ -171,5 +170,4 @@ If that makes you hard, you’re in the right place.
 ✱ disclaimer... *Kinda zero dependencies.*
 Zero **prod** dependencies.
 > dev dependencies:
-> `chokidar` for hot module reloading (HMR) 
 > `vitest` for testing

package/build/build.js

@@ -4,12 +4,6 @@ build({
 	src: './src',
 	dest: './index.js',
 	dts: false,
-	hotModuleReload: false,
-	hotCallback: (file) => {
-
-		console.log(`[build callback] processed ${file}`);
-
-	},
 	ignore: [
 		'ignoreMe.js',
 		'ignoreFolder/*',

package/index.js

@@ -1,97 +1,95 @@
-/**
- * This file is auto-generated by the build script.
- * It consolidates API functions for use in the application.
- * Do not edit manually.
- */
-import _build from './src/build.js';
-import _clean_array from './src/clean/array.js';
-import _clean_boolean from './src/clean/boolean.js';
-import _clean_integer from './src/clean/integer.js';
-import _clean_number from './src/clean/number.js';
-import _clean_object from './src/clean/object.js';
-import _clean_string from './src/clean/string.js';
-import _clean_timestamp from './src/clean/timestamp.js';
-import _clean_uuid from './src/clean/uuid.js';
-import _collectImports from './src/collectImports.js';
-import _combineFiles from './src/combineFiles.js';
-import _convertBytes from './src/convertBytes.js';
-import _decrypt from './src/decrypt.js';
-import _each from './src/each.js';
-import _eachAsync from './src/eachAsync.js';
-import _encrypt from './src/encrypt.js';
-import _getAllFiles from './src/getAllFiles.js';
-import _isUUID from './src/isUUID.js';
-import _md5 from './src/md5.js';
-import _password_check from './src/password/check.js';
-import _password_hash from './src/password/hash.js';
-import _setLocalEnvs from './src/setLocalEnvs.js';
-import _shouldIgnore from './src/shouldIgnore.js';
-import _thingType from './src/thingType.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_clean from './src/utils/clean.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_writeHotWrapper from './src/utils/writeHotWrapper.js';
-import _uuid from './src/uuid.js';
-import _validateSchema from './src/validateSchema.js';
-
-export { _build as build };
-export { _collectImports as collectImports };
-export { _combineFiles as combineFiles };
-export { _convertBytes as convertBytes };
-export { _decrypt as decrypt };
-export { _each as each };
-export { _eachAsync as eachAsync };
-export { _encrypt as encrypt };
-export { _getAllFiles as getAllFiles };
-export { _isUUID as isUUID };
-export { _md5 as md5 };
-export { _setLocalEnvs as setLocalEnvs };
-export { _shouldIgnore as shouldIgnore };
-export { _thingType as thingType };
-export { _toPennies as toPennies };
-export { _uuid as uuid };
-export { _validateSchema as validateSchema };
-
-export const clean = {
-	array: _clean_array,
-	boolean: _clean_boolean,
-	integer: _clean_integer,
-	number: _clean_number,
-	object: _clean_object,
-	string: _clean_string,
-	timestamp: _clean_timestamp,
-	uuid: _clean_uuid
-};
-
-export const password = {
-	check: _password_check,
-	hash: _password_hash
-};
-
-export const utils = {
-	buildExportsTree: _utils_buildExportsTree,
-	buildFileDataList: _utils_buildFileDataList,
-	clean: _utils_clean,
-	extractJSDocComment: _utils_extractJSDocComment,
-	generateFile: _utils_generateFile,
-	generateFlatExportLines: _utils_generateFlatExportLines,
-	generateImportStatements: _utils_generateImportStatements,
-	generateNamedExports: _utils_generateNamedExports,
-	generateNamespaceCode: _utils_generateNamespaceCode,
-	generateNamespaceExportLines: _utils_generateNamespaceExportLines,
-	writeHotWrapper: _utils_writeHotWrapper
-};
-
-
-export default {
+/**
+ * This file is auto-generated by the build script.
+ * It consolidates API functions for use in the application.
+ * Do not edit manually.
+ */
+import _build from './src/build.js';
+import _clean_array from './src/clean/array.js';
+import _clean_boolean from './src/clean/boolean.js';
+import _clean_integer from './src/clean/integer.js';
+import _clean_number from './src/clean/number.js';
+import _clean_object from './src/clean/object.js';
+import _clean_string from './src/clean/string.js';
+import _clean_timestamp from './src/clean/timestamp.js';
+import _clean_uuid from './src/clean/uuid.js';
+import _collectImports from './src/collectImports.js';
+import _combineFiles from './src/combineFiles.js';
+import _convertBytes from './src/convertBytes.js';
+import _decrypt from './src/decrypt.js';
+import _each from './src/each.js';
+import _eachAsync from './src/eachAsync.js';
+import _encrypt from './src/encrypt.js';
+import _getAllFiles from './src/getAllFiles.js';
+import _isUUID from './src/isUUID.js';
+import _md5 from './src/md5.js';
+import _password_check from './src/password/check.js';
+import _password_hash from './src/password/hash.js';
+import _setLocalEnvs from './src/setLocalEnvs.js';
+import _shouldIgnore from './src/shouldIgnore.js';
+import _thingType from './src/thingType.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_clean from './src/utils/clean.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 _uuid from './src/uuid.js';
+import _validateSchema from './src/validateSchema.js';
+
+export { _build as build };
+export { _collectImports as collectImports };
+export { _combineFiles as combineFiles };
+export { _convertBytes as convertBytes };
+export { _decrypt as decrypt };
+export { _each as each };
+export { _eachAsync as eachAsync };
+export { _encrypt as encrypt };
+export { _getAllFiles as getAllFiles };
+export { _isUUID as isUUID };
+export { _md5 as md5 };
+export { _setLocalEnvs as setLocalEnvs };
+export { _shouldIgnore as shouldIgnore };
+export { _thingType as thingType };
+export { _toPennies as toPennies };
+export { _uuid as uuid };
+export { _validateSchema as validateSchema };
+
+export const clean = {
+	array: _clean_array,
+	boolean: _clean_boolean,
+	integer: _clean_integer,
+	number: _clean_number,
+	object: _clean_object,
+	string: _clean_string,
+	timestamp: _clean_timestamp,
+	uuid: _clean_uuid
+};
+
+export const password = {
+	check: _password_check,
+	hash: _password_hash
+};
+
+export const utils = {
+	buildExportsTree: _utils_buildExportsTree,
+	buildFileDataList: _utils_buildFileDataList,
+	clean: _utils_clean,
+	extractJSDocComment: _utils_extractJSDocComment,
+	generateFile: _utils_generateFile,
+	generateFlatExportLines: _utils_generateFlatExportLines,
+	generateImportStatements: _utils_generateImportStatements,
+	generateNamedExports: _utils_generateNamedExports,
+	generateNamespaceCode: _utils_generateNamespaceCode,
+	generateNamespaceExportLines: _utils_generateNamespaceExportLines
+};
+
+
+export default {
 	/**
 	 * Builds a file from the specified source directory and writes it to the destination file.
 	 *
@@ -103,19 +101,19 @@ export default {
 	 * @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,
-	collectImports: _collectImports,
-	combineFiles: _combineFiles,
+	 */
+	build: _build,
+	collectImports: _collectImports,
+	combineFiles: _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: _convertBytes,
-	decrypt: _decrypt,
+	 */
+	convertBytes: _convertBytes,
+	decrypt: _decrypt,
 	/**
 	 * Iterates over elements of an array or properties of an object, invoking a callback for each element/property.
 	 * The iteration stops if the callback returns `false`.
@@ -124,44 +122,43 @@ export default {
 	 * @param {Object|Array} objectOrArray - The object or array to iterate over.
 	 * @param {Function} callback - The function to invoke per iteration. It is invoked with two arguments: (value, key/index).
 	 * @returns {void}
-	 */
-	each: _each,
-	eachAsync: _eachAsync,
-	encrypt: _encrypt,
-	getAllFiles: _getAllFiles,
-	isUUID: _isUUID,
-	md5: _md5,
-	setLocalEnvs: _setLocalEnvs,
-	shouldIgnore: _shouldIgnore,
-	thingType: _thingType,
-	toPennies: _toPennies,
-	uuid: _uuid,
-	validateSchema: _validateSchema,
-	clean: {
-		array: _clean_array,
-		boolean: _clean_boolean,
-		integer: _clean_integer,
-		number: _clean_number,
-		object: _clean_object,
-		string: _clean_string,
-		timestamp: _clean_timestamp,
-		uuid: _clean_uuid,
-	},
-	password: {
-		check: _password_check,
-		hash: _password_hash,
-	},
-	utils: {
-		buildExportsTree: _utils_buildExportsTree,
-		buildFileDataList: _utils_buildFileDataList,
-		clean: _utils_clean,
-		extractJSDocComment: _utils_extractJSDocComment,
-		generateFile: _utils_generateFile,
-		generateFlatExportLines: _utils_generateFlatExportLines,
-		generateImportStatements: _utils_generateImportStatements,
-		generateNamedExports: _utils_generateNamedExports,
-		generateNamespaceCode: _utils_generateNamespaceCode,
-		generateNamespaceExportLines: _utils_generateNamespaceExportLines,
-		writeHotWrapper: _utils_writeHotWrapper,
-	},
+	 */
+	each: _each,
+	eachAsync: _eachAsync,
+	encrypt: _encrypt,
+	getAllFiles: _getAllFiles,
+	isUUID: _isUUID,
+	md5: _md5,
+	setLocalEnvs: _setLocalEnvs,
+	shouldIgnore: _shouldIgnore,
+	thingType: _thingType,
+	toPennies: _toPennies,
+	uuid: _uuid,
+	validateSchema: _validateSchema,
+	clean: {
+		array: _clean_array,
+		boolean: _clean_boolean,
+		integer: _clean_integer,
+		number: _clean_number,
+		object: _clean_object,
+		string: _clean_string,
+		timestamp: _clean_timestamp,
+		uuid: _clean_uuid,
+	},
+	password: {
+		check: _password_check,
+		hash: _password_hash,
+	},
+	utils: {
+		buildExportsTree: _utils_buildExportsTree,
+		buildFileDataList: _utils_buildFileDataList,
+		clean: _utils_clean,
+		extractJSDocComment: _utils_extractJSDocComment,
+		generateFile: _utils_generateFile,
+		generateFlatExportLines: _utils_generateFlatExportLines,
+		generateImportStatements: _utils_generateImportStatements,
+		generateNamedExports: _utils_generateNamedExports,
+		generateNamespaceCode: _utils_generateNamespaceCode,
+		generateNamespaceExportLines: _utils_generateNamespaceExportLines,
+	},
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@awesomeness-js/utils",
-	"version": "1.1.3",
+	"version": "1.1.5",
 	"description": "Awesomeness - Utils",
 	"repository": {
 		"type": "git",

package/schemas.js

@@ -1,16 +1,16 @@
-/**
- * This file is auto-generated by the build script.
- * It consolidates API functions for use in the application.
- * Do not edit manually.
- */
-import _schema1 from './schemas/schema1.js';
-import _schema2 from './schemas/schema2.js';
-
-export { _schema1 as schema1 };
-export { _schema2 as schema2 };
-
-
-export default {
-	schema1: _schema1,
-	schema2: _schema2,
+/**
+ * This file is auto-generated by the build script.
+ * It consolidates API functions for use in the application.
+ * Do not edit manually.
+ */
+import _schema1 from './schemas/schema1.js';
+import _schema2 from './schemas/schema2.js';
+
+export { _schema1 as schema1 };
+export { _schema2 as schema2 };
+
+
+export default {
+	schema1: _schema1,
+	schema2: _schema2,
 };

package/src/build.js

@@ -12,7 +12,6 @@
  */
 import { writeFileSync } from 'fs';
 import generateFile from './utils/generateFile.js';
-import writeHotWrapper from './utils/writeHotWrapper.js';
 
 async function build({
 	src = './src',
@@ -22,9 +21,6 @@ async function build({
 	includeComments = true,
 	dts = false,
 	useTabs = true,
-	hotModuleReload = false,
-	hotCallback = null,
-	hotSource = './hot-source.js'   // generated only when hot is enabled
 } = {}) {
 
 	const gen = () => generateFile({
@@ -36,70 +32,10 @@ async function build({
 		useTabs 
 	});
 
-	const buildHot = () => {
 
-		// 1) write payload that the wrapper imports
-		writeFileSync(hotSource, gen());
-		console.log(`[build] wrote ${hotSource}`);
-		
-		// 2) ensure index.js is a hot wrapper
-		writeHotWrapper({
-			dest,
-			hotSource 
-		});
-
-		console.log(`[build] ensured hot wrapper ${dest}`);
-	
-	};
-
-	const buildCold = () => {
-
-		// single-file classic output (no second file)
-		writeFileSync(dest, gen());
-		console.log(`[build] wrote ${dest}`);
-	
-	};
-
-	if (hotModuleReload) {
-
-		buildHot();
-
-		// watch only src; each change regenerates hot-source.js (wrapper auto-reloads it)
-		const chokidar = (await import('chokidar')).default;
-
-		console.log(`[build] watching ${src} for changes...`);
-		const watcher = chokidar.watch(src, {
-			ignoreInitial: true,
-			ignored: ignore 
-		});
-
-		let timeout;
-
-		watcher.on('all', (_event, file) => {
-
-			clearTimeout(timeout);
-			timeout = setTimeout(() => {
-
-				console.log(`[build] change detected in ${file}, rebuilding payload...`);
-				writeFileSync(hotSource, gen());
-
-				if(typeof hotCallback === 'function') {
-
-					hotCallback(file);
-				
-				}
-
-				console.log(`[build] ready.`);
-			
-			}, 50);
-		
-		});
-	
-	} else {
-
-		buildCold();
-
-	}
+	// single-file classic output (no second file)
+	writeFileSync(dest, gen());
+	console.log(`[build] wrote ${dest}`);
 	
 	return true;
 

package/src/clean/string.js

@@ -4,7 +4,9 @@ export default function cleanString(x, {
 	maxLength = false,
 	allowHtml = false,
 	allowScripts = false,
-	validValues = false
+	validValues = false,
+	format = false,
+	pattern = false
 } = {}){
 
 	if(allowScripts && !allowHtml){
@@ -77,6 +79,53 @@ export default function cleanString(x, {
 		
 		}
 
+		if(format === 'email') {
+
+			const emailRegex = /^(?!@)(?!.*@.*@)(?!.*\.\.)(?!\.\.)(?!.*-$)(?!.*-$)(?!.*\.-)[A-Za-z0-9._%+-]+(?:@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,})$/;
+			
+			if(!emailRegex.test(x)) {
+
+				throw {
+					message: 'Invalid email format',
+					value: x
+				};
+
+			}
+
+		}
+
+		if(pattern) {
+
+			// make sure pattern is itself a regex
+			if(!(pattern instanceof RegExp)) {
+
+				try {
+
+					pattern = new RegExp(pattern);
+
+				} catch (e) {
+
+					throw {
+						message: 'Pattern is not a valid regular expression',
+						pattern,
+						value: x
+					};
+
+				}
+
+			}
+
+			if(!pattern.test(x)) {
+
+				throw {
+					message: 'Invalid format',
+					value: x
+				};
+
+			}
+
+		}
+
 		return x;
 
 	} catch (e) {

package/src/wait.js

@@ -0,0 +1,3 @@
+export default async function wait(ms) {
+	return new Promise(resolve => setTimeout(resolve, ms));
+}

package/types/build.d.ts

@@ -1,13 +1,10 @@
-export default build;
-declare function build({ src, dest, exportRoots, ignore, includeComments, dts, useTabs, hotModuleReload, hotCallback, hotSource }?: {
-    src?: string;
-    dest?: string;
-    exportRoots?: boolean;
-    ignore?: any[];
-    includeComments?: boolean;
-    dts?: boolean;
-    useTabs?: boolean;
-    hotModuleReload?: boolean;
-    hotCallback?: any;
-    hotSource?: string;
-}): Promise<boolean>;
+export default build;
+declare function build({ src, dest, exportRoots, ignore, includeComments, dts, useTabs, }?: {
+    src?: string;
+    dest?: string;
+    exportRoots?: boolean;
+    ignore?: any[];
+    includeComments?: boolean;
+    dts?: boolean;
+    useTabs?: boolean;
+}): Promise<boolean>;

package/types/clean/array.d.ts

@@ -1,2 +1,2 @@
-declare const _default: (arr: any, schema?: {}) => any[];
-export default _default;
+declare const _default: (arr: any, schema?: {}) => any[];
+export default _default;

package/types/clean/object.d.ts

@@ -1,2 +1,2 @@
-declare const _default: (obj: any, schema: any) => {};
-export default _default;
+declare const _default: (obj: any, schema: any) => {};
+export default _default;

package/types/clean/string.d.ts

@@ -1,8 +1,8 @@
-export default function cleanString(x: any, { required, minLength, maxLength, allowHtml, allowScripts, validValues }?: {
-    required?: boolean;
-    minLength?: boolean;
-    maxLength?: boolean;
-    allowHtml?: boolean;
-    allowScripts?: boolean;
-    validValues?: boolean;
-}): string;
+export default function cleanString(x: any, { required, minLength, maxLength, allowHtml, allowScripts, validValues }?: {
+    required?: boolean;
+    minLength?: boolean;
+    maxLength?: boolean;
+    allowHtml?: boolean;
+    allowScripts?: boolean;
+    validValues?: boolean;
+}): string;

package/types/collectImports.d.ts

@@ -1,6 +1,6 @@
-export default run;
-declare function run(filePath: any, { returnCode, jsMaps, cssMaps }?: {
-    returnCode?: boolean;
-    jsMaps?: {};
-    cssMaps?: {};
-}): any[];
+export default run;
+declare function run(filePath: any, { returnCode, jsMaps, cssMaps }?: {
+    returnCode?: boolean;
+    jsMaps?: {};
+    cssMaps?: {};
+}): any[];

package/types/combineFiles.d.ts

@@ -1,8 +1,8 @@
-export default combineFiles;
-declare function combineFiles(dir: any, fileType: any, { minify, processContent, }?: {
-    minify?: boolean;
-    processContent?: ({ content, path }: {
-        content: any;
-        path: any;
-    }) => any;
-}): string;
+export default combineFiles;
+declare function combineFiles(dir: any, fileType: any, { minify, processContent, }?: {
+    minify?: boolean;
+    processContent?: ({ content, path }: {
+        content: any;
+        path: any;
+    }) => any;
+}): string;

package/types/index.d.ts

@@ -1,97 +1,95 @@
-/**
- * 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 _clean_array from './clean/array';
-import type _clean_boolean from './clean/boolean';
-import type _clean_integer from './clean/integer';
-import type _clean_number from './clean/number';
-import type _clean_object from './clean/object';
-import type _clean_string from './clean/string';
-import type _clean_timestamp from './clean/timestamp';
-import type _clean_uuid from './clean/uuid';
-import type _collectImports from './collectImports';
-import type _combineFiles from './combineFiles';
-import type _convertBytes from './convertBytes';
-import type _decrypt from './decrypt';
-import type _each from './each';
-import type _eachAsync from './eachAsync';
-import type _encrypt from './encrypt';
-import type _getAllFiles from './getAllFiles';
-import type _isUUID from './isUUID';
-import type _md5 from './md5';
-import type _password_check from './password/check';
-import type _password_hash from './password/hash';
-import type _setLocalEnvs from './setLocalEnvs';
-import type _shouldIgnore from './shouldIgnore';
-import type _thingType from './thingType';
-import type _toPennies from './toPennies';
-import type _utils_buildExportsTree from './utils/buildExportsTree';
-import type _utils_buildFileDataList from './utils/buildFileDataList';
-import type _utils_clean from './utils/clean';
-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_writeHotWrapper from './utils/writeHotWrapper';
-import type _uuid from './uuid';
-import type _validateSchema from './validateSchema';
-
-export declare const build: typeof _build;
-export declare const collectImports: typeof _collectImports;
-export declare const combineFiles: typeof _combineFiles;
-export declare const convertBytes: typeof _convertBytes;
-export declare const decrypt: typeof _decrypt;
-export declare const each: typeof _each;
-export declare const eachAsync: typeof _eachAsync;
-export declare const encrypt: typeof _encrypt;
-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 shouldIgnore: typeof _shouldIgnore;
-export declare const thingType: typeof _thingType;
-export declare const toPennies: typeof _toPennies;
-export declare const uuid: typeof _uuid;
-export declare const validateSchema: typeof _validateSchema;
-
-export declare const clean: {
-	array: typeof _clean_array;
-	boolean: typeof _clean_boolean;
-	integer: typeof _clean_integer;
-	number: typeof _clean_number;
-	object: typeof _clean_object;
-	string: typeof _clean_string;
-	timestamp: typeof _clean_timestamp;
-	uuid: typeof _clean_uuid;
-};
-
-export declare const password: {
-	check: typeof _password_check;
-	hash: typeof _password_hash;
-};
-
-export declare const utils: {
-	buildExportsTree: typeof _utils_buildExportsTree;
-	buildFileDataList: typeof _utils_buildFileDataList;
-	clean: typeof _utils_clean;
-	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;
-	writeHotWrapper: typeof _utils_writeHotWrapper;
-};
-
-
-declare const _default: {
+/**
+ * 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 _clean_array from './clean/array';
+import type _clean_boolean from './clean/boolean';
+import type _clean_integer from './clean/integer';
+import type _clean_number from './clean/number';
+import type _clean_object from './clean/object';
+import type _clean_string from './clean/string';
+import type _clean_timestamp from './clean/timestamp';
+import type _clean_uuid from './clean/uuid';
+import type _collectImports from './collectImports';
+import type _combineFiles from './combineFiles';
+import type _convertBytes from './convertBytes';
+import type _decrypt from './decrypt';
+import type _each from './each';
+import type _eachAsync from './eachAsync';
+import type _encrypt from './encrypt';
+import type _getAllFiles from './getAllFiles';
+import type _isUUID from './isUUID';
+import type _md5 from './md5';
+import type _password_check from './password/check';
+import type _password_hash from './password/hash';
+import type _setLocalEnvs from './setLocalEnvs';
+import type _shouldIgnore from './shouldIgnore';
+import type _thingType from './thingType';
+import type _toPennies from './toPennies';
+import type _utils_buildExportsTree from './utils/buildExportsTree';
+import type _utils_buildFileDataList from './utils/buildFileDataList';
+import type _utils_clean from './utils/clean';
+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 _uuid from './uuid';
+import type _validateSchema from './validateSchema';
+
+export declare const build: typeof _build;
+export declare const collectImports: typeof _collectImports;
+export declare const combineFiles: typeof _combineFiles;
+export declare const convertBytes: typeof _convertBytes;
+export declare const decrypt: typeof _decrypt;
+export declare const each: typeof _each;
+export declare const eachAsync: typeof _eachAsync;
+export declare const encrypt: typeof _encrypt;
+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 shouldIgnore: typeof _shouldIgnore;
+export declare const thingType: typeof _thingType;
+export declare const toPennies: typeof _toPennies;
+export declare const uuid: typeof _uuid;
+export declare const validateSchema: typeof _validateSchema;
+
+export declare const clean: {
+	array: typeof _clean_array;
+	boolean: typeof _clean_boolean;
+	integer: typeof _clean_integer;
+	number: typeof _clean_number;
+	object: typeof _clean_object;
+	string: typeof _clean_string;
+	timestamp: typeof _clean_timestamp;
+	uuid: typeof _clean_uuid;
+};
+
+export declare const password: {
+	check: typeof _password_check;
+	hash: typeof _password_hash;
+};
+
+export declare const utils: {
+	buildExportsTree: typeof _utils_buildExportsTree;
+	buildFileDataList: typeof _utils_buildFileDataList;
+	clean: typeof _utils_clean;
+	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;
+};
+
+
+declare const _default: {
 	/**
 	 * Builds a file from the specified source directory and writes it to the destination file.
 	 *
@@ -103,19 +101,19 @@ declare const _default: {
 	 * @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;
-	collectImports: typeof _collectImports;
-	combineFiles: typeof _combineFiles;
+	 */
+	build: typeof _build;
+	collectImports: typeof _collectImports;
+	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;
-	decrypt: typeof _decrypt;
+	 */
+	convertBytes: typeof _convertBytes;
+	decrypt: typeof _decrypt;
 	/**
 	 * Iterates over elements of an array or properties of an object, invoking a callback for each element/property.
 	 * The iteration stops if the callback returns `false`.
@@ -124,46 +122,45 @@ declare const _default: {
 	 * @param {Object|Array} objectOrArray - The object or array to iterate over.
 	 * @param {Function} callback - The function to invoke per iteration. It is invoked with two arguments: (value, key/index).
 	 * @returns {void}
-	 */
-	each: typeof _each;
-	eachAsync: typeof _eachAsync;
-	encrypt: typeof _encrypt;
-	getAllFiles: typeof _getAllFiles;
-	isUUID: typeof _isUUID;
-	md5: typeof _md5;
-	setLocalEnvs: typeof _setLocalEnvs;
-	shouldIgnore: typeof _shouldIgnore;
-	thingType: typeof _thingType;
-	toPennies: typeof _toPennies;
-	uuid: typeof _uuid;
-	validateSchema: typeof _validateSchema;
-	clean: {
-		array: typeof _clean_array,
-		boolean: typeof _clean_boolean,
-		integer: typeof _clean_integer,
-		number: typeof _clean_number,
-		object: typeof _clean_object,
-		string: typeof _clean_string,
-		timestamp: typeof _clean_timestamp,
-		uuid: typeof _clean_uuid,
-	},
-	password: {
-		check: typeof _password_check,
-		hash: typeof _password_hash,
-	},
-	utils: {
-		buildExportsTree: typeof _utils_buildExportsTree,
-		buildFileDataList: typeof _utils_buildFileDataList,
-		clean: typeof _utils_clean,
-		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,
-		writeHotWrapper: typeof _utils_writeHotWrapper,
-	},
-};
-
-export default _default;
+	 */
+	each: typeof _each;
+	eachAsync: typeof _eachAsync;
+	encrypt: typeof _encrypt;
+	getAllFiles: typeof _getAllFiles;
+	isUUID: typeof _isUUID;
+	md5: typeof _md5;
+	setLocalEnvs: typeof _setLocalEnvs;
+	shouldIgnore: typeof _shouldIgnore;
+	thingType: typeof _thingType;
+	toPennies: typeof _toPennies;
+	uuid: typeof _uuid;
+	validateSchema: typeof _validateSchema;
+	clean: {
+		array: typeof _clean_array,
+		boolean: typeof _clean_boolean,
+		integer: typeof _clean_integer,
+		number: typeof _clean_number,
+		object: typeof _clean_object,
+		string: typeof _clean_string,
+		timestamp: typeof _clean_timestamp,
+		uuid: typeof _clean_uuid,
+	},
+	password: {
+		check: typeof _password_check,
+		hash: typeof _password_hash,
+	},
+	utils: {
+		buildExportsTree: typeof _utils_buildExportsTree,
+		buildFileDataList: typeof _utils_buildFileDataList,
+		clean: typeof _utils_clean,
+		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,
+	},
+};
+
+export default _default;

package/types/shouldIgnore.d.ts

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

package/types/utils/buildFileDataList.d.ts

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

package/types/utils/clean.d.ts

@@ -1,19 +1,19 @@
-declare namespace _default {
-    export { cleanArray as array };
-    export { cleanObject as object };
-    export { cleanBoolean as boolean };
-    export { cleanInteger as integer };
-    export { cleanNumber as number };
-    export { cleanString as string };
-    export { cleanTimestamp as timestamp };
-    export { cleanUUID as uuid };
-}
-export default _default;
-declare function cleanArray(arr: any, schema?: {}): any[];
-declare function cleanObject(obj: any, schema: any): {};
-import cleanBoolean from '../clean/boolean.js';
-import cleanInteger from '../clean/integer.js';
-import cleanNumber from '../clean/number.js';
-import cleanString from '../clean/string.js';
-import cleanTimestamp from '../clean/timestamp.js';
-import cleanUUID from '../clean/uuid.js';
+declare namespace _default {
+    export { cleanArray as array };
+    export { cleanObject as object };
+    export { cleanBoolean as boolean };
+    export { cleanInteger as integer };
+    export { cleanNumber as number };
+    export { cleanString as string };
+    export { cleanTimestamp as timestamp };
+    export { cleanUUID as uuid };
+}
+export default _default;
+declare function cleanArray(arr: any, schema?: {}): any[];
+declare function cleanObject(obj: any, schema: any): {};
+import cleanBoolean from '../clean/boolean.js';
+import cleanInteger from '../clean/integer.js';
+import cleanNumber from '../clean/number.js';
+import cleanString from '../clean/string.js';
+import cleanTimestamp from '../clean/timestamp.js';
+import cleanUUID from '../clean/uuid.js';

package/types/utils/generateFile.d.ts

@@ -1,8 +1,8 @@
-export default function generateFile({ src, exportRoots, ignore, includeComments, dts, useTabs }: {
-    src: any;
-    exportRoots: any;
-    ignore: any;
-    includeComments: any;
-    dts: any;
-    useTabs?: boolean;
-}): string;
+export default function generateFile({ src, exportRoots, ignore, includeComments, dts, useTabs }: {
+    src: any;
+    exportRoots: any;
+    ignore: any;
+    includeComments: any;
+    dts: any;
+    useTabs?: boolean;
+}): string;

package/types/utils/generateFlatExportLines.d.ts

@@ -1,7 +1,7 @@
-export default function generateFlatExportLines({ flatExports, exportRoots, includeComments, dts, useTabs }: {
-    flatExports: any;
-    exportRoots: any;
-    includeComments: any;
-    dts: any;
-    useTabs?: boolean;
-}): string;
+export default function generateFlatExportLines({ flatExports, exportRoots, includeComments, dts, useTabs }: {
+    flatExports: any;
+    exportRoots: any;
+    includeComments: any;
+    dts: any;
+    useTabs?: boolean;
+}): string;

package/types/utils/generateImportStatements.d.ts

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

package/types/utils/generateNamedExports.d.ts

@@ -1,7 +1,7 @@
-export default function generateNamedExports({ flatExports, exportRoots, nestedExports, dts, useTabs }: {
-    flatExports: any;
-    exportRoots: any;
-    nestedExports: any;
-    dts: any;
-    useTabs?: boolean;
-}): string;
+export default function generateNamedExports({ flatExports, exportRoots, nestedExports, dts, useTabs }: {
+    flatExports: any;
+    exportRoots: any;
+    nestedExports: any;
+    dts: any;
+    useTabs?: boolean;
+}): string;

package/types/utils/generateNamespaceCode.d.ts

@@ -1,7 +1,7 @@
-export default function generateNamespaceCode({ nsObj, indentLevel, includeComments, dts, useTabs }: {
-    nsObj: any;
-    indentLevel: any;
-    includeComments: any;
-    dts: any;
-    useTabs?: boolean;
-}): string;
+export default function generateNamespaceCode({ nsObj, indentLevel, includeComments, dts, useTabs }: {
+    nsObj: any;
+    indentLevel: any;
+    includeComments: any;
+    dts: any;
+    useTabs?: boolean;
+}): string;

package/types/utils/generateNamespaceExportLines.d.ts

@@ -1,6 +1,6 @@
-export default function generateNamespaceExportLines({ nestedExports, includeComments, dts, useTabs }: {
-    nestedExports: any;
-    includeComments: any;
-    dts: any;
-    useTabs?: boolean;
-}): string;
+export default function generateNamespaceExportLines({ nestedExports, includeComments, dts, useTabs }: {
+    nestedExports: any;
+    includeComments: any;
+    dts: any;
+    useTabs?: boolean;
+}): string;

package/src/utils/writeHotWrapper.js

@@ -1,42 +0,0 @@
-import { writeFileSync } from 'node:fs';
-
-export default function writeHotWrapper({
-	dest, 
-	hotSource 
-}) {
-
-	const wrapper = `// auto-generated wrapper
-import chokidar from 'chokidar';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-
-let _default;
-
-export { _default as default };
-
-const target = path.resolve(${JSON.stringify(hotSource)});
-
-async function reload() {
-
-	const mod = await import(\`\${pathToFileURL(target)}?t=\${Date.now()}\`);
-
-	_default = mod.default;
-	console.log('[hot] reloaded', target);
-
-}
-
-await reload();
-
-let t;
-
-chokidar.watch(target, { ignoreInitial: true }).on('all', () => {
-
-	clearTimeout(t);
-	t = setTimeout(() => reload().catch(err => console.error('[hot] failed:', err)), 50);
-
-});
-`;
-
-	writeFileSync(dest, wrapper);
-
-}

package/types/clean/thing.d.ts

@@ -1,2 +0,0 @@
-declare function _default(thing: any, schema: any): any;
-export default _default;

package/types/hashPassword.d.ts

@@ -1 +0,0 @@
-export default function hashPassword(password: any): string;

package/types/utils/shouldIgnore.d.ts

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

package/types/utils/writeHotWrapper.d.ts

@@ -1,4 +0,0 @@
-export default function writeHotWrapper({ dest, hotSource }: {
-    dest: any;
-    hotSource: any;
-}): void;

package/types/validatePassword.d.ts

@@ -1 +0,0 @@
-export default function validatePassword(password: any, storedHash: any): boolean;