@flex-development/pathe/dist/lib/remove-ext.d.mts

Universal drop-in replacement for node:path

/**
 * @file removeExt
 * @module pathe/lib/removeExt
 */
export default removeExt;
/**
 * Remove the file extension of `input`.
 *
 * Does nothing if `input` does not end with the provided file extension,
 * or if a file extension is not provided.
 *
 * @category
 *  utils
 *
 * @param {string} input
 *  The path or URL string to handle
 * @param {string | null | undefined} ext
 *  The file extension to remove
 * @return {string}
 *  `input` unmodified or with `ext` removed
 */
declare function removeExt(input: string, ext: string | null | undefined): string;
/**
 * Remove the file extension of `url`.
 *
 * Does nothing if `url` does not end with the provided file extension, or if a
 * file extension is not provided.
 *
 * @category
 *  utils
 *
 * @param {URL} url
 *  The {@linkcode URL} to handle
 * @param {string | null | undefined} ext
 *  The file extension to remove
 * @return {URL}
 *  `url` unmodified or with `ext` removed
 */
declare function removeExt(url: URL, ext: string | null | undefined): URL;
/**
 * Remove the file extension of `input`.
 *
 * Does nothing if `input` does not end with the provided file extension, or if
 * a file extension is not provided.
 *
 * @example
 *  removeExt('file') // 'file'
 * @example
 *  removeExt('file.mjs', 'mjs') // 'file'
 * @example
 *  removeExt('file.mjs', '.mjs') // 'file'
 * @example
 *  removeExt('file.d.mts', '.mjs') // 'file.d.mts'
 *
 * @category
 *  utils
 *
 * @param {URL | string} input
 *  The {@linkcode URL}, URL string, or path to handle
 * @param {string | null | undefined} ext
 *  The file extension to remove
 * @return {URL | string}
 *  `input` unmodified or with `ext` removed
 */
declare function removeExt(input: URL | string, ext: string | null | undefined): URL | string;