Files
ospab.host/node_modules/empathic/find.d.ts
2025-09-15 18:10:26 +03:00

42 lines
1.3 KiB
TypeScript

import type { Options } from "empathic/walk";
export type { Options };
/**
* Find an item by name, walking parent directories until found.
*
* @param name The item name to find.
* @returns The absolute path to the item, if found.
*/
export declare function up(name: string, options?: Options): string | undefined;
/**
* Get the first path that matches any of the names provided.
*
* > [NOTE]
* > The order of {@link names} is respected.
*
* @param names The item names to find.
* @returns The absolute path of the first item found, if any.
*/
export declare function any(names: string[], options?: Options): string | undefined;
/**
* Find a file by name, walking parent directories until found.
*
* > [NOTE]
* > This function only returns a value for file matches.
* > A directory match with the same name will be ignored.
*
* @param name The file name to find.
* @returns The absolute path to the file, if found.
*/
export declare function file(name: string, options?: Options): string | undefined;
/**
* Find a directory by name, walking parent directories until found.
*
* > [NOTE]
* > This function only returns a value for directory matches.
* > A file match with the same name will be ignored.
*
* @param name The directory name to find.
* @returns The absolute path to the file, if found.
*/
export declare function dir(name: string, options?: Options): string | undefined;