@luxass/utils 2.5.1 → 2.6.0

package/dist/guards.d.ts

@@ -1,2 +1,2 @@
-import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards-x9QZDUSt.js";
+import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards-SWdmRZ5e.js";
 export { isNotNull, isNotNullish, isNotUndefined, isTruthy };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards-x9QZDUSt.js";
-import { clamp } from "./number-DzUC7V5F.js";
-import { getChangedKeys, getOwnProperty, hasOwnProperty, omit } from "./object-BT3S70pM.js";
-import { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash } from "./string-DDSo2EBf.js";
-import { ElementOf, InferArguments, MaybeArray, MaybePromise, Nullable, Nullish, Prettify, RemoveIndexSignature } from "./types-DCrM3M9i.js";
+import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards-SWdmRZ5e.js";
+import { clamp } from "./number-Culbli-Y.js";
+import { getChangedKeys, getOwnProperty, hasOwnProperty, omit } from "./object-BtzfqVfB.js";
+import { appendTrailingSlash, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash } from "./path-DqJkV3NT.js";
+import { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-Cwp8CD7H.js";
+import { ElementOf, InferArguments, MaybeArray, MaybePromise, Nullable, Nullish, Prettify, RemoveIndexSignature } from "./types-BtiMC8Uf.js";
 import pRetry from "p-retry";
 
 //#region src/common.d.ts

package/dist/index.js

@@ -1,7 +1,8 @@
 import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards-O1HGJraI.js";
-import { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash } from "./string-DCBui1sH.js";
+import { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-pQApOGKP.js";
 import { clamp } from "./number-BS9T5WGO.js";
 import { getChangedKeys, getOwnProperty, hasOwnProperty, omit } from "./object-CyGLe77G.js";
+import { appendTrailingSlash, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash } from "./path-BS-_BQ_d.js";
 import pRetry from "p-retry";
 
 //#region src/common.ts

package/dist/number.d.ts

@@ -1,2 +1,2 @@
-import { clamp } from "./number-DzUC7V5F.js";
+import { clamp } from "./number-Culbli-Y.js";
 export { clamp };

package/dist/object.d.ts

@@ -1,2 +1,2 @@
-import { getChangedKeys, getOwnProperty, hasOwnProperty, omit } from "./object-BT3S70pM.js";
+import { getChangedKeys, getOwnProperty, hasOwnProperty, omit } from "./object-BtzfqVfB.js";
 export { getChangedKeys, getOwnProperty, hasOwnProperty, omit };

package/dist/path-BS-_BQ_d.js

@@ -0,0 +1,128 @@
+//#region src/path.ts
+/**
+* Removes trailing slashes from a string
+* @param {string} path - The string to remove trailing slashes from
+* @returns {string} The string with trailing slashes removed
+*
+* @example
+* ```ts
+* import { trimTrailingSlash } from "@luxass/utils/path";
+*
+* trimTrailingSlash("path/to/file/") // "path/to/file"
+* trimTrailingSlash("path/to/file///") // "path/to/file"
+* trimTrailingSlash("path/to/file") // "path/to/file"
+* trimTrailingSlash("") // ""
+* ```
+*/
+function trimTrailingSlash(path) {
+	if (!path || path === "/") return "/";
+	return path.replace(/\/+$/, "");
+}
+/**
+* Removes leading slashes from a string
+* @param {string} path - The string to remove leading slashes from
+* @returns {string} The string with leading slashes removed
+*
+* @example
+* ```ts
+* import { trimLeadingSlash } from "@luxass/utils/path";
+*
+* trimLeadingSlash("/path/to/file") // "path/to/file"
+* trimLeadingSlash("///path/to/file") // "path/to/file"
+* trimLeadingSlash("path/to/file") // "path/to/file"
+* trimLeadingSlash("") // ""
+* ```
+*/
+function trimLeadingSlash(path) {
+	if (!path || path === "/") return "/";
+	return path.replace(/^\/+/, "");
+}
+/**
+* Ensures a string ends with a trailing slash
+* @param {string} path - The string to append a trailing slash to
+* @returns {string} The string with a trailing slash appended if not already present
+*
+* @example
+* ```ts
+* import { appendTrailingSlash } from "@luxass/utils/path";
+*
+* appendTrailingSlash("path/to/file") // "path/to/file/"
+* appendTrailingSlash("path/to/file/") // "path/to/file/"
+* appendTrailingSlash("") // ""
+* ```
+*/
+function appendTrailingSlash(path) {
+	if (!path || path === "/") return "/";
+	return path.endsWith("/") ? path : `${path}/`;
+}
+/**
+* Ensures a string starts with a leading slash
+* @param {string} path - The string to prepend a leading slash to
+* @returns {string} The string with a leading slash prepended if not already present
+*
+* @example
+* ```ts
+* import { prependLeadingSlash } from "@luxass/utils/path";
+*
+* prependLeadingSlash("path/to/file") // "/path/to/file"
+* prependLeadingSlash("/path/to/file") // "/path/to/file"
+* prependLeadingSlash("") // ""
+* ```
+*/
+function prependLeadingSlash(path) {
+	if (!path || path === "/") return "/";
+	return path[0] === "/" ? path : `/${path}`;
+}
+/**
+* Joins two URL paths together, handling trailing and leading slashes appropriately
+* @param {string | undefined} base - The base URL path
+* @param {string | undefined} path - The path to append to the base
+* @returns {string} The joined URL path
+*
+* @example
+* ```ts
+* import { joinURL } from "@luxass/utils/path";
+*
+* // Basic path joining
+* joinURL("api", "users") // "api/users"
+* joinURL("api/", "users") // "api/users"
+* joinURL("api", "/users") // "api/users"
+* joinURL("api/", "/users") // "api/users"
+*
+* // URL joining with protocol
+* joinURL("https://api.example.com", "v1/users") // "https://api.example.com/v1/users"
+* joinURL("https://api.example.com/", "/v1/users") // "https://api.example.com/v1/users"
+*
+* // Multiple slash normalization (POSIX-like)
+* joinURL("api//v1/", "//users///") // "api/v1/users/"
+* joinURL("base///", "///path") // "base/path"
+*
+* // Empty and undefined handling
+* joinURL("", "users") // "users"
+* joinURL("api", "") // "api"
+* joinURL(undefined, undefined) // "/"
+* ```
+*/
+function joinURL(base, path) {
+	if (!base && !path) return "/";
+	if (!base || base === "/") return path || "/";
+	if (!path || path === "/") return base;
+	const normalize = (s) => s.replace(/\/+/g, "/");
+	const joinPaths = (b, p) => {
+		b = normalize(b);
+		p = normalize(p);
+		if (b.endsWith("/") && b !== "/") b = b.slice(0, -1);
+		if (p.startsWith("/")) p = p.slice(1);
+		return p ? `${b}/${p}` : b;
+	};
+	try {
+		const url = new URL(base);
+		url.pathname = trimLeadingSlash(joinPaths(url.pathname, path));
+		return url.toString();
+	} catch {
+		return joinPaths(base, path);
+	}
+}
+
+//#endregion
+export { appendTrailingSlash, joinURL, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash };

package/dist/path-DqJkV3NT.d.ts

@@ -0,0 +1,96 @@
+//#region src/path.d.ts
+/**
+ * Removes trailing slashes from a string
+ * @param {string} path - The string to remove trailing slashes from
+ * @returns {string} The string with trailing slashes removed
+ *
+ * @example
+ * ```ts
+ * import { trimTrailingSlash } from "@luxass/utils/path";
+ *
+ * trimTrailingSlash("path/to/file/") // "path/to/file"
+ * trimTrailingSlash("path/to/file///") // "path/to/file"
+ * trimTrailingSlash("path/to/file") // "path/to/file"
+ * trimTrailingSlash("") // ""
+ * ```
+ */
+declare function trimTrailingSlash(path: string | undefined): string;
+/**
+ * Removes leading slashes from a string
+ * @param {string} path - The string to remove leading slashes from
+ * @returns {string} The string with leading slashes removed
+ *
+ * @example
+ * ```ts
+ * import { trimLeadingSlash } from "@luxass/utils/path";
+ *
+ * trimLeadingSlash("/path/to/file") // "path/to/file"
+ * trimLeadingSlash("///path/to/file") // "path/to/file"
+ * trimLeadingSlash("path/to/file") // "path/to/file"
+ * trimLeadingSlash("") // ""
+ * ```
+ */
+declare function trimLeadingSlash(path: string | undefined): string;
+/**
+ * Ensures a string ends with a trailing slash
+ * @param {string} path - The string to append a trailing slash to
+ * @returns {string} The string with a trailing slash appended if not already present
+ *
+ * @example
+ * ```ts
+ * import { appendTrailingSlash } from "@luxass/utils/path";
+ *
+ * appendTrailingSlash("path/to/file") // "path/to/file/"
+ * appendTrailingSlash("path/to/file/") // "path/to/file/"
+ * appendTrailingSlash("") // ""
+ * ```
+ */
+declare function appendTrailingSlash(path: string | undefined): string;
+/**
+ * Ensures a string starts with a leading slash
+ * @param {string} path - The string to prepend a leading slash to
+ * @returns {string} The string with a leading slash prepended if not already present
+ *
+ * @example
+ * ```ts
+ * import { prependLeadingSlash } from "@luxass/utils/path";
+ *
+ * prependLeadingSlash("path/to/file") // "/path/to/file"
+ * prependLeadingSlash("/path/to/file") // "/path/to/file"
+ * prependLeadingSlash("") // ""
+ * ```
+ */
+declare function prependLeadingSlash(path: string | undefined): string;
+/**
+ * Joins two URL paths together, handling trailing and leading slashes appropriately
+ * @param {string | undefined} base - The base URL path
+ * @param {string | undefined} path - The path to append to the base
+ * @returns {string} The joined URL path
+ *
+ * @example
+ * ```ts
+ * import { joinURL } from "@luxass/utils/path";
+ *
+ * // Basic path joining
+ * joinURL("api", "users") // "api/users"
+ * joinURL("api/", "users") // "api/users"
+ * joinURL("api", "/users") // "api/users"
+ * joinURL("api/", "/users") // "api/users"
+ *
+ * // URL joining with protocol
+ * joinURL("https://api.example.com", "v1/users") // "https://api.example.com/v1/users"
+ * joinURL("https://api.example.com/", "/v1/users") // "https://api.example.com/v1/users"
+ *
+ * // Multiple slash normalization (POSIX-like)
+ * joinURL("api//v1/", "//users///") // "api/v1/users/"
+ * joinURL("base///", "///path") // "base/path"
+ *
+ * // Empty and undefined handling
+ * joinURL("", "users") // "users"
+ * joinURL("api", "") // "api"
+ * joinURL(undefined, undefined) // "/"
+ * ```
+ */
+declare function joinURL(base: string | undefined, path: string | undefined): string;
+//#endregion
+export { appendTrailingSlash, joinURL, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash };

package/dist/path.d.ts

@@ -0,0 +1,2 @@
+import { appendTrailingSlash, joinURL, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash } from "./path-DqJkV3NT.js";
+export { appendTrailingSlash, joinURL, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash };

package/dist/path.js

@@ -0,0 +1,3 @@
+import { appendTrailingSlash, joinURL, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash } from "./path-BS-_BQ_d.js";
+
+export { appendTrailingSlash, joinURL, prependLeadingSlash, trimLeadingSlash, trimTrailingSlash };

package/dist/{string-DDSo2EBf.d.ts → string-Cwp8CD7H.d.ts}

@@ -128,67 +128,5 @@ declare function sanitizeIdentifier(str: string): string;
  * ```
  */
 declare function formatStr(message: string, ...positionals: unknown[]): string;
-/**
- * Removes trailing slashes from a string
- * @param {string} str - The string to remove trailing slashes from
- * @returns {string} The string with trailing slashes removed
- *
- * @example
- * ```ts
- * import { trimTrailingSlash } from "@luxass/utils/string";
- *
- * trimTrailingSlash("path/to/file/") // "path/to/file"
- * trimTrailingSlash("path/to/file///") // "path/to/file"
- * trimTrailingSlash("path/to/file") // "path/to/file"
- * trimTrailingSlash("") // ""
- * ```
- */
-declare function trimTrailingSlash(str: string): string;
-/**
- * Removes leading slashes from a string
- * @param {string} str - The string to remove leading slashes from
- * @returns {string} The string with leading slashes removed
- *
- * @example
- * ```ts
- * import { trimLeadingSlash } from "@luxass/utils/string";
- *
- * trimLeadingSlash("/path/to/file") // "path/to/file"
- * trimLeadingSlash("///path/to/file") // "path/to/file"
- * trimLeadingSlash("path/to/file") // "path/to/file"
- * trimLeadingSlash("") // ""
- * ```
- */
-declare function trimLeadingSlash(str: string): string;
-/**
- * Ensures a string ends with a trailing slash
- * @param {string} str - The string to append a trailing slash to
- * @returns {string} The string with a trailing slash appended if not already present
- *
- * @example
- * ```ts
- * import { appendTrailingSlash } from "@luxass/utils/string";
- *
- * appendTrailingSlash("path/to/file") // "path/to/file/"
- * appendTrailingSlash("path/to/file/") // "path/to/file/"
- * appendTrailingSlash("") // ""
- * ```
- */
-declare function appendTrailingSlash(str: string): string;
-/**
- * Ensures a string starts with a leading slash
- * @param {string} str - The string to prepend a leading slash to
- * @returns {string} The string with a leading slash prepended if not already present
- *
- * @example
- * ```ts
- * import { prependLeadingSlash } from "@luxass/utils/string";
- *
- * prependLeadingSlash("path/to/file") // "/path/to/file"
- * prependLeadingSlash("/path/to/file") // "/path/to/file"
- * prependLeadingSlash("") // ""
- * ```
- */
-declare function prependLeadingSlash(str: string): string;
 //#endregion
-export { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash };
+export { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/{string-DCBui1sH.js → string-pQApOGKP.js}

@@ -181,80 +181,6 @@ function formatStr(message, ...positionals) {
 	formattedMessage = formattedMessage.replace(/%{2}/g, "%");
 	return formattedMessage;
 }
-/**
-* Removes trailing slashes from a string
-* @param {string} str - The string to remove trailing slashes from
-* @returns {string} The string with trailing slashes removed
-*
-* @example
-* ```ts
-* import { trimTrailingSlash } from "@luxass/utils/string";
-*
-* trimTrailingSlash("path/to/file/") // "path/to/file"
-* trimTrailingSlash("path/to/file///") // "path/to/file"
-* trimTrailingSlash("path/to/file") // "path/to/file"
-* trimTrailingSlash("") // ""
-* ```
-*/
-function trimTrailingSlash(str) {
-	if (!str) return str;
-	return str.replace(/\/+$/, "");
-}
-/**
-* Removes leading slashes from a string
-* @param {string} str - The string to remove leading slashes from
-* @returns {string} The string with leading slashes removed
-*
-* @example
-* ```ts
-* import { trimLeadingSlash } from "@luxass/utils/string";
-*
-* trimLeadingSlash("/path/to/file") // "path/to/file"
-* trimLeadingSlash("///path/to/file") // "path/to/file"
-* trimLeadingSlash("path/to/file") // "path/to/file"
-* trimLeadingSlash("") // ""
-* ```
-*/
-function trimLeadingSlash(str) {
-	if (!str) return str;
-	return str.replace(/^\/+/, "");
-}
-/**
-* Ensures a string ends with a trailing slash
-* @param {string} str - The string to append a trailing slash to
-* @returns {string} The string with a trailing slash appended if not already present
-*
-* @example
-* ```ts
-* import { appendTrailingSlash } from "@luxass/utils/string";
-*
-* appendTrailingSlash("path/to/file") // "path/to/file/"
-* appendTrailingSlash("path/to/file/") // "path/to/file/"
-* appendTrailingSlash("") // ""
-* ```
-*/
-function appendTrailingSlash(str) {
-	if (!str) return str;
-	return str.endsWith("/") ? str : `${str}/`;
-}
-/**
-* Ensures a string starts with a leading slash
-* @param {string} str - The string to prepend a leading slash to
-* @returns {string} The string with a leading slash prepended if not already present
-*
-* @example
-* ```ts
-* import { prependLeadingSlash } from "@luxass/utils/string";
-*
-* prependLeadingSlash("path/to/file") // "/path/to/file"
-* prependLeadingSlash("/path/to/file") // "/path/to/file"
-* prependLeadingSlash("") // ""
-* ```
-*/
-function prependLeadingSlash(str) {
-	if (!str) return str;
-	return str.startsWith("/") ? str : `/${str}`;
-}
 
 //#endregion
-export { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash };
+export { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/string.d.ts

@@ -1,2 +1,2 @@
-import { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash } from "./string-DDSo2EBf.js";
-export { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash };
+import { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-Cwp8CD7H.js";
+export { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/string.js

@@ -1,3 +1,3 @@
-import { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash } from "./string-DCBui1sH.js";
+import { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-pQApOGKP.js";
 
-export { appendTrailingSlash, capitalize, dedent, dedentRaw, formatStr, prependLeadingSlash, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, trimLeadingSlash, trimTrailingSlash };
+export { capitalize, dedent, dedentRaw, formatStr, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { ElementOf, InferArguments, MaybeArray, MaybePromise, Nullable, Nullish, Prettify, RemoveIndexSignature } from "./types-DCrM3M9i.js";
+import { ElementOf, InferArguments, MaybeArray, MaybePromise, Nullable, Nullish, Prettify, RemoveIndexSignature } from "./types-BtiMC8Uf.js";
 export { ElementOf, InferArguments, MaybeArray, MaybePromise, Nullable, Nullish, Prettify, RemoveIndexSignature };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxass/utils",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "description": "A collection of utilities for JavaScript/TypeScript",
   "type": "module",
   "author": {
@@ -26,6 +26,7 @@
     "./guards": "./dist/guards.js",
     "./number": "./dist/number.js",
     "./object": "./dist/object.js",
+    "./path": "./dist/path.js",
     "./string": "./dist/string.js",
     "./types": "./dist/types.js",
     "./package.json": "./package.json"