@helpers4/url 2.0.0-alpha.7 → 2.0.0-alpha.9

package/lib/index.d.ts

@@ -17,6 +17,7 @@
  * cleanPath(undefined) // => undefined
  * cleanPath(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function cleanPath(url: string | undefined | null): string | undefined | null;
 
@@ -30,6 +31,7 @@ declare function cleanPath(url: string | undefined | null): string | undefined |
  *
  * @param url - The URL string to process
  * @returns The URI without query parameters and fragments, or the original value if undefined/null
+ * @since 1.9.0
  */
 declare function extractPureURI(url: string): string;
 declare function extractPureURI(url: undefined): undefined;
@@ -61,6 +63,7 @@ declare function extractPureURI(url: null): null;
  * onlyPath(undefined) // => undefined
  * onlyPath(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function onlyPath(url: string): string;
 /**
@@ -84,6 +87,7 @@ declare function onlyPath(url: string): string;
  * onlyPath(undefined) // => undefined
  * onlyPath(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function onlyPath(url: null): null;
 /**
@@ -107,6 +111,7 @@ declare function onlyPath(url: null): null;
  * onlyPath(undefined) // => undefined
  * onlyPath(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function onlyPath(url: undefined): undefined;
 
@@ -115,6 +120,12 @@ declare function onlyPath(url: undefined): undefined;
  * Copyright (C) 2025 baxyz
  * SPDX-License-Identifier: LGPL-3.0-or-later
  */
+/**
+ * Converts a relative URL to an absolute URL using the current document base URI.
+ * @param relativeUrl - The relative URL to convert
+ * @returns The absolute URL
+ * @since 1.0.0
+ */
 declare function relativeURLToAbsolute(relativeUrl: string): string;
 
 /**
@@ -142,6 +153,7 @@ declare function relativeURLToAbsolute(relativeUrl: string): string;
  * withLeadingSlash(undefined) // => undefined
  * withLeadingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withLeadingSlash(url: string): string;
 /**
@@ -164,6 +176,7 @@ declare function withLeadingSlash(url: string): string;
  * withLeadingSlash(undefined) // => undefined
  * withLeadingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withLeadingSlash(url: undefined): undefined;
 /**
@@ -186,6 +199,7 @@ declare function withLeadingSlash(url: undefined): undefined;
  * withLeadingSlash(undefined) // => undefined
  * withLeadingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withLeadingSlash(url: null): null;
 
@@ -214,6 +228,7 @@ declare function withLeadingSlash(url: null): null;
  * withTrailingSlash(undefined) // => undefined
  * withTrailingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withTrailingSlash(url: string): string;
 /**
@@ -236,6 +251,7 @@ declare function withTrailingSlash(url: string): string;
  * withTrailingSlash(undefined) // => undefined
  * withTrailingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withTrailingSlash(url: undefined): undefined;
 /**
@@ -258,6 +274,7 @@ declare function withTrailingSlash(url: undefined): undefined;
  * withTrailingSlash(undefined) // => undefined
  * withTrailingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withTrailingSlash(url: null): null;
 
@@ -287,6 +304,7 @@ declare function withTrailingSlash(url: null): null;
  * withoutLeadingSlash(undefined) // => undefined
  * withoutLeadingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withoutLeadingSlash(url: string): string;
 /**
@@ -310,6 +328,7 @@ declare function withoutLeadingSlash(url: string): string;
  * withoutLeadingSlash(undefined) // => undefined
  * withoutLeadingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withoutLeadingSlash(url: undefined): undefined;
 /**
@@ -333,6 +352,7 @@ declare function withoutLeadingSlash(url: undefined): undefined;
  * withoutLeadingSlash(undefined) // => undefined
  * withoutLeadingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withoutLeadingSlash(url: null): null;
 
@@ -362,6 +382,7 @@ declare function withoutLeadingSlash(url: null): null;
  * withoutTrailingSlash(undefined) // => undefined
  * withoutTrailingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withoutTrailingSlash(url: string): string;
 /**
@@ -385,6 +406,7 @@ declare function withoutTrailingSlash(url: string): string;
  * withoutTrailingSlash(undefined) // => undefined
  * withoutTrailingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withoutTrailingSlash(url: undefined): undefined;
 /**
@@ -408,6 +430,7 @@ declare function withoutTrailingSlash(url: undefined): undefined;
  * withoutTrailingSlash(undefined) // => undefined
  * withoutTrailingSlash(null) // => null
  * ```
+ * @since 1.0.0
  */
 declare function withoutTrailingSlash(url: null): null;
 

package/lib/index.js

@@ -18,6 +18,7 @@
 * cleanPath(undefined) // => undefined
 * cleanPath(null) // => null
 * ```
+* @since 1.0.0
 */
 function cleanPath(url) {
 	if (url === void 0 || url === null) return url;
@@ -59,6 +60,7 @@ function extractPureURI(url) {
 * onlyPath(undefined) // => undefined
 * onlyPath(null) // => null
 * ```
+* @since 1.0.0
 */
 function onlyPath(url) {
 	if (url === void 0 || url === null) return url;
@@ -88,6 +90,7 @@ function onlyPath(url) {
 * withoutTrailingSlash(undefined) // => undefined
 * withoutTrailingSlash(null) // => null
 * ```
+* @since 1.0.0
 */
 function withoutTrailingSlash(url) {
 	if (url === void 0 || url === null) return url;
@@ -115,6 +118,7 @@ function withoutTrailingSlash(url) {
 * withLeadingSlash(undefined) // => undefined
 * withLeadingSlash(null) // => null
 * ```
+* @since 1.0.0
 */
 function withLeadingSlash(url) {
 	if (url === void 0 || url === null) return url;
@@ -127,6 +131,12 @@ function withLeadingSlash(url) {
 * Copyright (C) 2025 baxyz
 * SPDX-License-Identifier: LGPL-3.0-or-later
 */
+/**
+* Converts a relative URL to an absolute URL using the current document base URI.
+* @param relativeUrl - The relative URL to convert
+* @returns The absolute URL
+* @since 1.0.0
+*/
 function relativeURLToAbsolute(relativeUrl) {
 	return withoutTrailingSlash(document.baseURI ?? window.location.origin) + cleanPath(withLeadingSlash(relativeUrl));
 }
@@ -152,6 +162,7 @@ function relativeURLToAbsolute(relativeUrl) {
 * withTrailingSlash(undefined) // => undefined
 * withTrailingSlash(null) // => null
 * ```
+* @since 1.0.0
 */
 function withTrailingSlash(url) {
 	if (url === void 0 || url === null) return url;
@@ -180,6 +191,7 @@ function withTrailingSlash(url) {
 * withoutLeadingSlash(undefined) // => undefined
 * withoutLeadingSlash(null) // => null
 * ```
+* @since 1.0.0
 */
 function withoutLeadingSlash(url) {
 	if (url === void 0 || url === null) return url;

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../helpers/url/cleanPath.ts","../../../helpers/url/extractPureURI.ts","../../../helpers/url/onlyPath.ts","../../../helpers/url/withoutTrailingSlash.ts","../../../helpers/url/withLeadingSlash.ts","../../../helpers/url/relativeURLToAbsolute.ts","../../../helpers/url/withTrailingSlash.ts","../../../helpers/url/withoutLeadingSlash.ts"],"sourcesContent":["/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Clean an URL by removing duplicate slashes.\n * The protocol part of the URL is not modified.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The cleaned URL string, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * cleanPath('/path//to///resource') // => '/path/to/resource'\n * cleanPath('http://example.com//path//to///resource') // => 'http://example.com/path/to/resource'\n * cleanPath(undefined) // => undefined\n * cleanPath(null) // => null\n * ```\n */\nexport function cleanPath(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url.replace(/([^:]\\/)\\/+/g, '$1')\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/*\n * This program is under the terms of the GNU Lesser General Public License version 3\n * The full license information can be found in LICENSE in the root directory of this project.\n */\n\n/**\n * Extracts the pure URI from a URL by removing query parameters and fragments.\n *\n * @param url - The URL string to process\n * @returns The URI without query parameters and fragments, or the original value if undefined/null\n */\nexport function extractPureURI(url: string): string;\nexport function extractPureURI(url: undefined): undefined;\nexport function extractPureURI(url: null): null;\nexport function extractPureURI(url: string | undefined | null): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url;\n  }\n\n  // Find the first occurrence of ? or #\n  const queryIndex = url.indexOf('?');\n  const fragmentIndex = url.indexOf('#');\n\n  let cutIndex = -1;\n\n  if (queryIndex !== -1 && fragmentIndex !== -1) {\n    // Both exist, take the earliest one\n    cutIndex = Math.min(queryIndex, fragmentIndex);\n  } else if (queryIndex !== -1) {\n    // Only query exists\n    cutIndex = queryIndex;\n  } else if (fragmentIndex !== -1) {\n    // Only fragment exists\n    cutIndex = fragmentIndex;\n  }\n\n  // If no query or fragment found, return the original string\n  if (cutIndex === -1) {\n    return url;\n  }\n\n  // Return the substring up to the first ? or #\n  return url.substring(0, cutIndex);\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n */\nexport function onlyPath(url: string): string\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n */\nexport function onlyPath(url: null): null\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n */\nexport function onlyPath(url: undefined): undefined\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n */\nexport function onlyPath(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  const [path] = url.split(/[?#]/)\n  return path\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n */\nexport function withoutTrailingSlash(url: string): string\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n */\nexport function withoutTrailingSlash(url: undefined): undefined\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n */\nexport function withoutTrailingSlash(url: null): null\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n */\nexport function withoutTrailingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[url.length - 1] === '/' ? url.slice(0, -1) : url\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n */\nexport function withLeadingSlash(url: string): string\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n */\nexport function withLeadingSlash(url: undefined): undefined\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n */\nexport function withLeadingSlash(url: null): null\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n */\nexport function withLeadingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[0] === '/' ? url : '/' + url\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/*\n * This program is under the terms of the GNU Lesser General Public License version 3\n * The full license information can be found in LICENSE in the root directory of this project.\n */\n\nimport { withoutTrailingSlash } from \"./withoutTrailingSlash\";\nimport { withLeadingSlash } from \"./withLeadingSlash\";\nimport { cleanPath } from \"./cleanPath\";\n\nexport function relativeURLToAbsolute(relativeUrl: string): string {\n    return (\n        withoutTrailingSlash(document.baseURI ?? window.location.origin) +\n        cleanPath(withLeadingSlash(relativeUrl))\n    );\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n */\nexport function withTrailingSlash(url: string): string\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n */\nexport function withTrailingSlash(url: undefined): undefined\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n */\nexport function withTrailingSlash(url: null): null\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n */\nexport function withTrailingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[url.length - 1] === '/' ? url : url + '/'\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n */\nexport function withoutLeadingSlash(url: string): string\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n */\nexport function withoutLeadingSlash(url: undefined): undefined\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n */\nexport function withoutLeadingSlash(url: null): null\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n */\nexport function withoutLeadingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[0] === '/' ? url.slice(1) : url\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,UACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,QAAQ,gBAAgB,KAAK;;;;ACP1C,SAAgB,eAAe,KAA2D;AACxF,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;CAIT,MAAM,aAAa,IAAI,QAAQ,IAAI;CACnC,MAAM,gBAAgB,IAAI,QAAQ,IAAI;CAEtC,IAAI,WAAW;AAEf,KAAI,eAAe,MAAM,kBAAkB,GAEzC,YAAW,KAAK,IAAI,YAAY,cAAc;UACrC,eAAe,GAExB,YAAW;UACF,kBAAkB,GAE3B,YAAW;AAIb,KAAI,aAAa,GACf,QAAO;AAIT,QAAO,IAAI,UAAU,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;ACoDnC,SAAgB,SACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;CAET,MAAM,CAAC,QAAQ,IAAI,MAAM,OAAO;AAChC,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;ACPT,SAAgB,qBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,IAAI,SAAS,OAAO,MAAM,IAAI,MAAM,GAAG,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;ACV1D,SAAgB,iBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,OAAO,MAAM,MAAM,MAAM;;;;;;;;;ACvFtC,SAAgB,sBAAsB,aAA6B;AAC/D,QACI,qBAAqB,SAAS,WAAW,OAAO,SAAS,OAAO,GAChE,UAAU,iBAAiB,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AC8EhD,SAAgB,kBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,IAAI,SAAS,OAAO,MAAM,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;ACFnD,SAAgB,oBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,OAAO,MAAM,IAAI,MAAM,EAAE,GAAG"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../helpers/url/cleanPath.ts","../../../helpers/url/extractPureURI.ts","../../../helpers/url/onlyPath.ts","../../../helpers/url/withoutTrailingSlash.ts","../../../helpers/url/withLeadingSlash.ts","../../../helpers/url/relativeURLToAbsolute.ts","../../../helpers/url/withTrailingSlash.ts","../../../helpers/url/withoutLeadingSlash.ts"],"sourcesContent":["/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Clean an URL by removing duplicate slashes.\n * The protocol part of the URL is not modified.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The cleaned URL string, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * cleanPath('/path//to///resource') // => '/path/to/resource'\n * cleanPath('http://example.com//path//to///resource') // => 'http://example.com/path/to/resource'\n * cleanPath(undefined) // => undefined\n * cleanPath(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function cleanPath(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url.replace(/([^:]\\/)\\/+/g, '$1')\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/*\n * This program is under the terms of the GNU Lesser General Public License version 3\n * The full license information can be found in LICENSE in the root directory of this project.\n */\n\n/**\n * Extracts the pure URI from a URL by removing query parameters and fragments.\n *\n * @param url - The URL string to process\n * @returns The URI without query parameters and fragments, or the original value if undefined/null\n * @since 1.9.0\n */\nexport function extractPureURI(url: string): string;\nexport function extractPureURI(url: undefined): undefined;\nexport function extractPureURI(url: null): null;\nexport function extractPureURI(url: string | undefined | null): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url;\n  }\n\n  // Find the first occurrence of ? or #\n  const queryIndex = url.indexOf('?');\n  const fragmentIndex = url.indexOf('#');\n\n  let cutIndex = -1;\n\n  if (queryIndex !== -1 && fragmentIndex !== -1) {\n    // Both exist, take the earliest one\n    cutIndex = Math.min(queryIndex, fragmentIndex);\n  } else if (queryIndex !== -1) {\n    // Only query exists\n    cutIndex = queryIndex;\n  } else if (fragmentIndex !== -1) {\n    // Only fragment exists\n    cutIndex = fragmentIndex;\n  }\n\n  // If no query or fragment found, return the original string\n  if (cutIndex === -1) {\n    return url;\n  }\n\n  // Return the substring up to the first ? or #\n  return url.substring(0, cutIndex);\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function onlyPath(url: string): string\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function onlyPath(url: null): null\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function onlyPath(url: undefined): undefined\n\n/**\n * Extract only the path from an URI with optional query and fragments.\n *\n * For example, all these parameters will return `/path`:\n *  - `/path`\n *  - `/path?query=thing`\n *  - `/path#fragment`\n *  - `/path?query=thing#fragment`\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @example\n * ```ts\n * onlyPath('/path') // => '/path'\n * onlyPath('/path?query=thing') // => '/path'\n * onlyPath('/path#fragment') // => '/path'\n * onlyPath('/path?query=thing#fragment') // => '/path'\n * onlyPath(undefined) // => undefined\n * onlyPath(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function onlyPath(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  const [path] = url.split(/[?#]/)\n  return path\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutTrailingSlash(url: string): string\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutTrailingSlash(url: undefined): undefined\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutTrailingSlash(url: null): null\n\n/**\n * Removes the trailing slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutTrailingSlash\n *\n * @example\n * ```ts\n * withoutTrailingSlash('') // => ''\n * withoutTrailingSlash('/') // => ''\n * withoutTrailingSlash('no/slash/') // => 'no/slash'\n * withoutTrailingSlash('already/has/slash') // => 'already/has/slash'\n * withoutTrailingSlash(undefined) // => undefined\n * withoutTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutTrailingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[url.length - 1] === '/' ? url.slice(0, -1) : url\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withLeadingSlash(url: string): string\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withLeadingSlash(url: undefined): undefined\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withLeadingSlash(url: null): null\n\n/**\n * Adds a leading slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withLeadingSlash\n *\n * @example\n * ```ts\n * withLeadingSlash('') // => '/'\n * withLeadingSlash('no/slash') // => '/no/slash'\n * withLeadingSlash('/already/has/slash') // => '/already/has/slash'\n * withLeadingSlash(undefined) // => undefined\n * withLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withLeadingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[0] === '/' ? url : '/' + url\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/*\n * This program is under the terms of the GNU Lesser General Public License version 3\n * The full license information can be found in LICENSE in the root directory of this project.\n */\n\nimport { withoutTrailingSlash } from \"./withoutTrailingSlash\";\nimport { withLeadingSlash } from \"./withLeadingSlash\";\nimport { cleanPath } from \"./cleanPath\";\n\n/**\n * Converts a relative URL to an absolute URL using the current document base URI.\n * @param relativeUrl - The relative URL to convert\n * @returns The absolute URL\n * @since 1.0.0\n */\nexport function relativeURLToAbsolute(relativeUrl: string): string {\n    return (\n        withoutTrailingSlash(document.baseURI ?? window.location.origin) +\n        cleanPath(withLeadingSlash(relativeUrl))\n    );\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withTrailingSlash(url: string): string\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withTrailingSlash(url: undefined): undefined\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withTrailingSlash(url: null): null\n\n/**\n * Adds a trailing slash `/` to the given URL if it is not already present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * with a trailing slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withTrailingSlash\n *\n * @example\n * ```ts\n * withTrailingSlash('') // => '/'\n * withTrailingSlash('no/slash') // => 'no/slash/'\n * withTrailingSlash('already/has/slash/') // => 'already/has/slash/'\n * withTrailingSlash(undefined) // => undefined\n * withTrailingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withTrailingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[url.length - 1] === '/' ? url : url + '/'\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutLeadingSlash(url: string): string\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutLeadingSlash(url: undefined): undefined\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutLeadingSlash(url: null): null\n\n/**\n * Removes the leading slash `/` from the given URL if it is present.\n *\n * This function is useful for ensuring that URLs are properly formatted\n * without a leading slash, which is often required in web development for\n * consistency and to avoid issues with relative paths.\n *\n * @param url - The URL string to be processed. Can be `string`, `undefined`, or `null`.\n * @returns The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`.\n *\n * @see https://radashi.js.org/reference/url/withoutLeadingSlash\n *\n * @example\n * ```ts\n * withoutLeadingSlash('') // => ''\n * withoutLeadingSlash('/') // => ''\n * withoutLeadingSlash('/no/slash') // => 'no/slash'\n * withoutLeadingSlash('already/has/slash') // => 'already/has/slash'\n * withoutLeadingSlash(undefined) // => undefined\n * withoutLeadingSlash(null) // => null\n * ```\n * @since 1.0.0\n */\nexport function withoutLeadingSlash(\n  url: string | undefined | null,\n): string | undefined | null {\n  if (url === undefined || url === null) {\n    return url\n  }\n  return url[0] === '/' ? url.slice(1) : url\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,QAAQ,gBAAgB,KAAK;;;;ACP1C,SAAgB,eAAe,KAA2D;AACxF,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;CAIT,MAAM,aAAa,IAAI,QAAQ,IAAI;CACnC,MAAM,gBAAgB,IAAI,QAAQ,IAAI;CAEtC,IAAI,WAAW;AAEf,KAAI,eAAe,MAAM,kBAAkB,GAEzC,YAAW,KAAK,IAAI,YAAY,cAAc;UACrC,eAAe,GAExB,YAAW;UACF,kBAAkB,GAE3B,YAAW;AAIb,KAAI,aAAa,GACf,QAAO;AAIT,QAAO,IAAI,UAAU,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;ACuDnC,SAAgB,SACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;CAET,MAAM,CAAC,QAAQ,IAAI,MAAM,OAAO;AAChC,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;ACPT,SAAgB,qBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,IAAI,SAAS,OAAO,MAAM,IAAI,MAAM,GAAG,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;ACV1D,SAAgB,iBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,OAAO,MAAM,MAAM,MAAM;;;;;;;;;;;;;;;ACrFtC,SAAgB,sBAAsB,aAA6B;AAC/D,QACI,qBAAqB,SAAS,WAAW,OAAO,SAAS,OAAO,GAChE,UAAU,iBAAiB,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AC4EhD,SAAgB,kBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,IAAI,SAAS,OAAO,MAAM,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;ACFnD,SAAgB,oBACd,KAC2B;AAC3B,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAC/B,QAAO;AAET,QAAO,IAAI,OAAO,MAAM,IAAI,MAAM,EAAE,GAAG"}

package/meta/api.json

@@ -0,0 +1,449 @@
+{
+  "category": "url",
+  "version": "2.0.0-alpha.9",
+  "functions": [
+    {
+      "name": "cleanPath",
+      "kind": "function",
+      "description": "Clean an URL by removing duplicate slashes.\nThe protocol part of the URL is not modified.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "cleanPath(url: string | null | undefined): string | null | undefined",
+          "description": "Clean an URL by removing duplicate slashes.\nThe protocol part of the URL is not modified.",
+          "params": [
+            {
+              "name": "url",
+              "type": "string | null | undefined",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "string | null | undefined",
+            "description": "The cleaned URL string, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Remove duplicate slashes",
+          "description": "Cleans an URL by removing duplicate slashes while preserving the protocol.",
+          "code": "cleanPath('/path//to///resource')\n// => '/path/to/resource'"
+        },
+        {
+          "title": "Preserve protocol",
+          "description": "The double slash after the protocol (http://) is not modified.",
+          "code": "cleanPath('http://example.com//path')\n// => 'http://example.com/path'"
+        },
+        {
+          "title": "Handle null and undefined",
+          "description": "Returns null for null input and undefined for undefined input.",
+          "code": "cleanPath(null)      // => null\ncleanPath(undefined) // => undefined"
+        }
+      ],
+      "sourceFile": "cleanPath.ts"
+    },
+    {
+      "name": "extractPureURI",
+      "kind": "function",
+      "description": "Extracts the pure URI from a URL by removing query parameters and fragments.",
+      "since": "1.9.0",
+      "signatures": [
+        {
+          "signature": "extractPureURI(url: string): string",
+          "description": "Extracts the pure URI from a URL by removing query parameters and fragments.",
+          "params": [
+            {
+              "name": "url",
+              "type": "string",
+              "description": "The URL string to process"
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The URI without query parameters and fragments, or the original value if undefined/null"
+          }
+        },
+        {
+          "signature": "extractPureURI(url: undefined): undefined",
+          "description": "Extracts the pure URI from a URL by removing query parameters and fragments.",
+          "params": [
+            {
+              "name": "url",
+              "type": "undefined",
+              "description": "The URL string to process"
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The URI without query parameters and fragments, or the original value if undefined/null"
+          }
+        },
+        {
+          "signature": "extractPureURI(url: null): null",
+          "description": "Extracts the pure URI from a URL by removing query parameters and fragments.",
+          "params": [
+            {
+              "name": "url",
+              "type": "null",
+              "description": "The URL string to process"
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The URI without query parameters and fragments, or the original value if undefined/null"
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Remove query parameters and fragments",
+          "description": "Strips everything after ? or # from the URL.",
+          "code": "extractPureURI('https://example.com/path?query=1#section')\n// => 'https://example.com/path'"
+        }
+      ],
+      "sourceFile": "extractPureURI.ts"
+    },
+    {
+      "name": "onlyPath",
+      "kind": "function",
+      "description": "Extract only the path from an URI with optional query and fragments.\n\nFor example, all these parameters will return `/path`:\n - `/path`\n - `/path?query=thing`\n - `/path#fragment`\n - `/path?query=thing#fragment`",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "onlyPath(url: string): string",
+          "description": "Extract only the path from an URI with optional query and fragments.\n\nFor example, all these parameters will return `/path`:\n - `/path`\n - `/path?query=thing`\n - `/path#fragment`\n - `/path?query=thing#fragment`",
+          "params": [
+            {
+              "name": "url",
+              "type": "string",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "onlyPath(url: null): null",
+          "description": "Extract only the path from an URI with optional query and fragments.\n\nFor example, all these parameters will return `/path`:\n - `/path`\n - `/path?query=thing`\n - `/path#fragment`\n - `/path?query=thing#fragment`",
+          "params": [
+            {
+              "name": "url",
+              "type": "null",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "onlyPath(url: undefined): undefined",
+          "description": "Extract only the path from an URI with optional query and fragments.\n\nFor example, all these parameters will return `/path`:\n - `/path`\n - `/path?query=thing`\n - `/path#fragment`\n - `/path?query=thing#fragment`",
+          "params": [
+            {
+              "name": "url",
+              "type": "undefined",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The URL string without query and fragment, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Extract the path from a URL",
+          "description": "Strips query parameters and fragments from a URL path.",
+          "code": "onlyPath('/path?query=thing#fragment')\n// => '/path'"
+        }
+      ],
+      "sourceFile": "onlyPath.ts"
+    },
+    {
+      "name": "relativeURLToAbsolute",
+      "kind": "function",
+      "description": "Converts a relative URL to an absolute URL using the current document base URI.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "relativeURLToAbsolute(relativeUrl: string): string",
+          "description": "Converts a relative URL to an absolute URL using the current document base URI.",
+          "params": [
+            {
+              "name": "relativeUrl",
+              "type": "string",
+              "description": "The relative URL to convert"
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The absolute URL"
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Convert a relative URL to absolute",
+          "description": "Prepends the base URI to a relative path, cleaning duplicate slashes.",
+          "code": "relativeURLToAbsolute('/api/data')\n// => 'http://localhost/api/data' (depends on document.baseURI)"
+        }
+      ],
+      "sourceFile": "relativeURLToAbsolute.ts"
+    },
+    {
+      "name": "withLeadingSlash",
+      "kind": "function",
+      "description": "Adds a leading slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "withLeadingSlash(url: string): string",
+          "description": "Adds a leading slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "string",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withLeadingSlash(url: undefined): undefined",
+          "description": "Adds a leading slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "undefined",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withLeadingSlash(url: null): null",
+          "description": "Adds a leading slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "null",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The URL string with a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Add a leading slash",
+          "description": "Ensures the URL starts with a forward slash.",
+          "code": "withLeadingSlash('path/to/resource')\n// => '/path/to/resource'"
+        },
+        {
+          "title": "Already has leading slash",
+          "description": "Does not add a duplicate slash.",
+          "code": "withLeadingSlash('/already/has/slash')\n// => '/already/has/slash'"
+        }
+      ],
+      "sourceFile": "withLeadingSlash.ts"
+    },
+    {
+      "name": "withoutLeadingSlash",
+      "kind": "function",
+      "description": "Removes the leading slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "withoutLeadingSlash(url: string): string",
+          "description": "Removes the leading slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "string",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withoutLeadingSlash(url: undefined): undefined",
+          "description": "Removes the leading slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "undefined",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withoutLeadingSlash(url: null): null",
+          "description": "Removes the leading slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "null",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The URL string without a leading slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Remove leading slash",
+          "description": "Strips the leading slash from a URL path.",
+          "code": "withoutLeadingSlash('/path/to/resource')\n// => 'path/to/resource'"
+        }
+      ],
+      "sourceFile": "withoutLeadingSlash.ts"
+    },
+    {
+      "name": "withoutTrailingSlash",
+      "kind": "function",
+      "description": "Removes the trailing slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "withoutTrailingSlash(url: string): string",
+          "description": "Removes the trailing slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "string",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withoutTrailingSlash(url: undefined): undefined",
+          "description": "Removes the trailing slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "undefined",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withoutTrailingSlash(url: null): null",
+          "description": "Removes the trailing slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "null",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The URL string without a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Remove trailing slash",
+          "description": "Strips the trailing slash from a URL path.",
+          "code": "withoutTrailingSlash('path/to/resource/')\n// => 'path/to/resource'"
+        }
+      ],
+      "sourceFile": "withoutTrailingSlash.ts"
+    },
+    {
+      "name": "withTrailingSlash",
+      "kind": "function",
+      "description": "Adds a trailing slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "withTrailingSlash(url: string): string",
+          "description": "Adds a trailing slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "string",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "string",
+            "description": "The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withTrailingSlash(url: undefined): undefined",
+          "description": "Adds a trailing slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "undefined",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "undefined",
+            "description": "The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        },
+        {
+          "signature": "withTrailingSlash(url: null): null",
+          "description": "Adds a trailing slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
+          "params": [
+            {
+              "name": "url",
+              "type": "null",
+              "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
+            }
+          ],
+          "returns": {
+            "type": "null",
+            "description": "The URL string with a trailing slash, or `undefined` if the input is `undefined`, or `null` if the input is `null`."
+          }
+        }
+      ],
+      "examples": [
+        {
+          "title": "Add a trailing slash",
+          "description": "Ensures the URL ends with a forward slash.",
+          "code": "withTrailingSlash('path/to/resource')\n// => 'path/to/resource/'"
+        }
+      ],
+      "sourceFile": "withTrailingSlash.ts"
+    }
+  ]
+}

package/{examples.json → meta/examples.json}

@@ -1,8 +1,8 @@
 {
   "category": "url",
-  "helpers": [
+  "functions": [
     {
-      "helper": "cleanPath",
+      "name": "cleanPath",
       "examples": [
         {
           "title": "Remove duplicate slashes",
@@ -22,7 +22,7 @@
       ]
     },
     {
-      "helper": "extractPureURI",
+      "name": "extractPureURI",
       "examples": [
         {
           "title": "Remove query parameters and fragments",
@@ -32,7 +32,7 @@
       ]
     },
     {
-      "helper": "onlyPath",
+      "name": "onlyPath",
       "examples": [
         {
           "title": "Extract the path from a URL",
@@ -42,7 +42,7 @@
       ]
     },
     {
-      "helper": "relativeURLToAbsolute",
+      "name": "relativeURLToAbsolute",
       "examples": [
         {
           "title": "Convert a relative URL to absolute",
@@ -52,7 +52,7 @@
       ]
     },
     {
-      "helper": "withLeadingSlash",
+      "name": "withLeadingSlash",
       "examples": [
         {
           "title": "Add a leading slash",
@@ -67,17 +67,7 @@
       ]
     },
     {
-      "helper": "withTrailingSlash",
-      "examples": [
-        {
-          "title": "Add a trailing slash",
-          "description": "Ensures the URL ends with a forward slash.",
-          "code": "withTrailingSlash('path/to/resource')\n// => 'path/to/resource/'"
-        }
-      ]
-    },
-    {
-      "helper": "withoutLeadingSlash",
+      "name": "withoutLeadingSlash",
       "examples": [
         {
           "title": "Remove leading slash",
@@ -87,7 +77,7 @@
       ]
     },
     {
-      "helper": "withoutTrailingSlash",
+      "name": "withoutTrailingSlash",
       "examples": [
         {
           "title": "Remove trailing slash",
@@ -95,6 +85,16 @@
           "code": "withoutTrailingSlash('path/to/resource/')\n// => 'path/to/resource'"
         }
       ]
+    },
+    {
+      "name": "withTrailingSlash",
+      "examples": [
+        {
+          "title": "Add a trailing slash",
+          "description": "Ensures the URL ends with a forward slash.",
+          "code": "withTrailingSlash('path/to/resource')\n// => 'path/to/resource/'"
+        }
+      ]
     }
   ]
 }

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@helpers4/url",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.0-alpha.9",
   "description": "A set of helpers in TS/JS, compatible with tree-shaking, for url.",
   "author": "baxyz <baxy@etik.com>",
   "license": "LGPL-3.0",
+  "homepage": "https://helpers4.dev/typescript/categories/url/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/helpers4/typescript.git"
@@ -17,9 +18,9 @@
       "types": "./lib/index.d.ts",
       "import": "./lib/index.js"
     },
-    "./examples.json": "./examples.json",
-    "./api.json": "./api.json",
-    "./licenses.json": "./licenses.json",
+    "./meta/api.json": "./meta/api.json",
+    "./meta/examples.json": "./meta/examples.json",
+    "./meta/licenses.json": "./meta/licenses.json",
     "./package.json": "./package.json"
   },
   "keywords": [
@@ -38,9 +39,7 @@
     "lib/index.js",
     "lib/index.d.ts",
     "lib/index.js.map",
-    "examples.json",
-    "api.json",
-    "licenses.json",
+    "meta/",
     "LICENSE.md",
     "package.json",
     "README.md"
@@ -48,4 +47,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/api.json

@@ -1,135 +0,0 @@
-{
-  "category": "url",
-  "members": [
-    {
-      "name": "cleanPath",
-      "kind": "function",
-      "description": "Clean an URL by removing duplicate slashes.\nThe protocol part of the URL is not modified.",
-      "signature": "cleanPath(url: string | null | undefined): string | null | undefined",
-      "params": [
-        {
-          "name": "url",
-          "type": "string | null | undefined",
-          "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
-        }
-      ],
-      "returns": "string | null | undefined",
-      "examples": [
-        "```ts\ncleanPath('/path//to///resource') // => '/path/to/resource'\ncleanPath('http://example.com//path//to///resource') // => 'http://example.com/path/to/resource'\ncleanPath(undefined) // => undefined\ncleanPath(null) // => null\n```"
-      ]
-    },
-    {
-      "name": "extractPureURI",
-      "kind": "function",
-      "description": "Extracts the pure URI from a URL by removing query parameters and fragments.",
-      "signature": "extractPureURI(url: string): string",
-      "params": [
-        {
-          "name": "url",
-          "type": "string",
-          "description": "The URL string to process"
-        }
-      ],
-      "returns": "string"
-    },
-    {
-      "name": "onlyPath",
-      "kind": "function",
-      "description": "Extract only the path from an URI with optional query and fragments.\n\nFor example, all these parameters will return `/path`:\n - `/path`\n - `/path?query=thing`\n - `/path#fragment`\n - `/path?query=thing#fragment`",
-      "signature": "onlyPath(url: string): string",
-      "params": [
-        {
-          "name": "url",
-          "type": "string",
-          "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
-        }
-      ],
-      "returns": "string",
-      "examples": [
-        "```ts\nonlyPath('/path') // => '/path'\nonlyPath('/path?query=thing') // => '/path'\nonlyPath('/path#fragment') // => '/path'\nonlyPath('/path?query=thing#fragment') // => '/path'\nonlyPath(undefined) // => undefined\nonlyPath(null) // => null\n```"
-      ]
-    },
-    {
-      "name": "relativeURLToAbsolute",
-      "kind": "function",
-      "description": "",
-      "signature": "relativeURLToAbsolute(relativeUrl: string): string",
-      "params": [
-        {
-          "name": "relativeUrl",
-          "type": "string",
-          "description": ""
-        }
-      ],
-      "returns": "string"
-    },
-    {
-      "name": "withLeadingSlash",
-      "kind": "function",
-      "description": "Adds a leading slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
-      "signature": "withLeadingSlash(url: string): string",
-      "params": [
-        {
-          "name": "url",
-          "type": "string",
-          "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
-        }
-      ],
-      "returns": "string",
-      "examples": [
-        "```ts\nwithLeadingSlash('') // => '/'\nwithLeadingSlash('no/slash') // => '/no/slash'\nwithLeadingSlash('/already/has/slash') // => '/already/has/slash'\nwithLeadingSlash(undefined) // => undefined\nwithLeadingSlash(null) // => null\n```"
-      ]
-    },
-    {
-      "name": "withoutLeadingSlash",
-      "kind": "function",
-      "description": "Removes the leading slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a leading slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
-      "signature": "withoutLeadingSlash(url: string): string",
-      "params": [
-        {
-          "name": "url",
-          "type": "string",
-          "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
-        }
-      ],
-      "returns": "string",
-      "examples": [
-        "```ts\nwithoutLeadingSlash('') // => ''\nwithoutLeadingSlash('/') // => ''\nwithoutLeadingSlash('/no/slash') // => 'no/slash'\nwithoutLeadingSlash('already/has/slash') // => 'already/has/slash'\nwithoutLeadingSlash(undefined) // => undefined\nwithoutLeadingSlash(null) // => null\n```"
-      ]
-    },
-    {
-      "name": "withoutTrailingSlash",
-      "kind": "function",
-      "description": "Removes the trailing slash `/` from the given URL if it is present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwithout a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
-      "signature": "withoutTrailingSlash(url: string): string",
-      "params": [
-        {
-          "name": "url",
-          "type": "string",
-          "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
-        }
-      ],
-      "returns": "string",
-      "examples": [
-        "```ts\nwithoutTrailingSlash('') // => ''\nwithoutTrailingSlash('/') // => ''\nwithoutTrailingSlash('no/slash/') // => 'no/slash'\nwithoutTrailingSlash('already/has/slash') // => 'already/has/slash'\nwithoutTrailingSlash(undefined) // => undefined\nwithoutTrailingSlash(null) // => null\n```"
-      ]
-    },
-    {
-      "name": "withTrailingSlash",
-      "kind": "function",
-      "description": "Adds a trailing slash `/` to the given URL if it is not already present.\n\nThis function is useful for ensuring that URLs are properly formatted\nwith a trailing slash, which is often required in web development for\nconsistency and to avoid issues with relative paths.",
-      "signature": "withTrailingSlash(url: string): string",
-      "params": [
-        {
-          "name": "url",
-          "type": "string",
-          "description": "The URL string to be processed. Can be `string`, `undefined`, or `null`."
-        }
-      ],
-      "returns": "string",
-      "examples": [
-        "```ts\nwithTrailingSlash('') // => '/'\nwithTrailingSlash('no/slash') // => 'no/slash/'\nwithTrailingSlash('already/has/slash/') // => 'already/has/slash/'\nwithTrailingSlash(undefined) // => undefined\nwithTrailingSlash(null) // => null\n```"
-      ]
-    }
-  ]
-}