@hybridly/utils 0.10.0-beta.12 → 0.10.0-beta.13

package/dist/index.mjs

@@ -3,10 +3,17 @@ import { isPlainObject } from "is-plain-object";
 import { debounce, throttle } from "throttle-debounce";
 import clone from "lodash.clonedeep";
 import makeDebugger from "debug";
+//#region src/form-data.ts
+/**
+* Checks if the given object has a file.
+*/
 function hasFiles(data) {
 	if (!data) return false;
 	return data instanceof File || data instanceof Blob || data instanceof FileList && data.length > 0 || data instanceof FormData && Array.from(data.values()).some((value) => hasFiles(value)) || typeof data === "object" && data !== null && Object.values(data).some((value) => hasFiles(value));
 }
+/**
+* Converts an object literal to a `FormData` object.
+*/
 function objectToFormData(source, form, parentKey) {
 	source ??= {};
 	form ??= new FormData();
@@ -31,6 +38,8 @@ function append(form, key, value) {
 	else if (value === null || value === void 0) return form.append(key, "");
 	objectToFormData(value, form, key);
 }
+//#endregion
+//#region src/error-modal.ts
 const stack = [];
 var Modal = class Modal {
 	constructor(html, id) {
@@ -239,12 +248,15 @@ function style() {
 		}
 	`;
 }
+//#endregion
+//#region src/utils.ts
 function random(length = 10) {
 	const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
 	let str = "";
 	for (let i = 0; i < length; i++) str += chars.charAt(Math.floor(Math.random() * 62));
 	return str;
 }
+/** Simple pattern matching util. */
 function match(value, lookup, ...args) {
 	if (value in lookup || "default" in lookup) {
 		const returnValue = value in lookup ? lookup[value] : lookup.default;
@@ -270,6 +282,16 @@ function merge(x, y, options = {}) {
 function removeTrailingSlash(string) {
 	return string.replace(/\/+$/, "");
 }
+/**
+* Sets a value at a path in an object
+*
+* This function will set a value at a path in an object, creating any missing
+* objects along the way. The object is modified in place.
+*
+* @param obj the object to set the value in
+* @param path a dot-separated path to the property to set
+* @param value the value to set
+*/
 function setValueAtPath(obj, path, value) {
 	if (!path.includes(".")) {
 		obj[path] = value;
@@ -283,6 +305,15 @@ function setValueAtPath(obj, path, value) {
 	}
 	nestedObject[segments[segments.length - 1]] = value;
 }
+/**
+* Unsets a property at a path in an object
+*
+* This function will unset a property at a path in an object, deleting any
+* objects along the way that are empty. The object is modified in place.
+*
+* @param obj the object to unset the property in
+* @param path a dot-separated path to the property to unset
+*/
 function unsetPropertyAtPath(obj, path) {
 	if (!path.includes(".")) {
 		delete obj[path];
@@ -297,6 +328,8 @@ function unsetPropertyAtPath(obj, path) {
 	delete nestedObject[segments[segments.length - 1]];
 	if (Object.keys(nestedObject).length === 0) unsetPropertyAtPath(obj, segments.slice(0, -1).join("."));
 }
+//#endregion
+//#region src/debug.ts
 const debug = {
 	router: makeDebugger("hybridly:core:router"),
 	history: makeDebugger("hybridly:core:history"),
@@ -308,4 +341,5 @@ const debug = {
 	plugin: (name, ...args) => makeDebugger("hybridly:plugin").extend(name.replace("hybridly:", ""))(args.shift(), ...args),
 	adapter: (name, ...args) => makeDebugger("hybridly:adapter").extend(name)(args.shift(), ...args)
 };
+//#endregion
 export { clone, debounce, debug, hasFiles, match, merge, objectToFormData, random, removeTrailingSlash, setValueAtPath, showResponseErrorModal, showViewComponentErrorModal, throttle, unsetPropertyAtPath, value, when };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hybridly/utils",
   "type": "module",
-  "version": "0.10.0-beta.12",
+  "version": "0.10.0-beta.13",
   "description": "Utils used in Hybridly packages",
   "author": "Enzo Innocenzi <enzo@innocenzi.dev>",
   "license": "MIT",