@poveste/vendors 0.14.0 → 0.15.0

package/dist/client/node_modules/birpc/dist/index.d.mts

@@ -0,0 +1,215 @@
+type ArgumentsType<T> = T extends (...args: infer A) => any ? A : never;
+type ReturnType<T> = T extends (...args: any) => infer R ? R : never;
+type PromisifyFn<T> = ReturnType<T> extends Promise<any> ? T : (...args: ArgumentsType<T>) => Promise<Awaited<ReturnType<T>>>;
+type Thenable<T> = T | PromiseLike<T>;
+type BirpcResolver<This> = (this: This, name: string, resolved: (...args: unknown[]) => unknown) => Thenable<((...args: any[]) => any) | undefined>;
+interface ChannelOptions {
+    /**
+     * Function to post raw message
+     */
+    post: (data: any, ...extras: any[]) => any | Promise<any>;
+    /**
+     * Listener to receive raw message
+     */
+    on: (fn: (data: any, ...extras: any[]) => void) => any | Promise<any>;
+    /**
+     * Clear the listener when `$close` is called
+     */
+    off?: (fn: (data: any, ...extras: any[]) => void) => any | Promise<any>;
+    /**
+     * Custom function to serialize data
+     *
+     * by default it passes the data as-is
+     */
+    serialize?: (data: any) => any;
+    /**
+     * Custom function to deserialize data
+     *
+     * by default it passes the data as-is
+     */
+    deserialize?: (data: any) => any;
+    /**
+     * Call the methods with the RPC context or the original functions object
+     */
+    bind?: 'rpc' | 'functions';
+    /**
+     * Custom meta data to attached to the RPC instance's `$meta` property
+     */
+    meta?: any;
+}
+interface EventOptions<RemoteFunctions, LocalFunctions extends object = Record<string, never>> {
+    /**
+     * Names of remote functions that do not need response.
+     */
+    eventNames?: (keyof RemoteFunctions)[];
+    /**
+     * Maximum timeout for waiting for response, in milliseconds.
+     *
+     * @default 60_000
+     */
+    timeout?: number;
+    /**
+     * Custom resolver to resolve function to be called
+     *
+     * For advanced use cases only
+     */
+    resolver?: BirpcResolver<BirpcReturn<RemoteFunctions, LocalFunctions>>;
+    /**
+     * Hook triggered before an event is sent to the remote
+     *
+     * @param req - Request parameters
+     * @param next - Function to continue the request
+     * @param resolve - Function to resolve the response directly
+     */
+    onRequest?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, req: Request, next: (req?: Request) => Promise<any>, resolve: (res: any) => void) => void | Promise<void>;
+    /**
+     * Custom error handler
+     *
+     * @deprecated use `onFunctionError` and `onGeneralError` instead
+     */
+    onError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, error: Error, functionName: string, args: any[]) => boolean | void;
+    /**
+     * Custom error handler for errors occurred in local functions being called
+     *
+     * @returns `true` to prevent the error from being thrown
+     */
+    onFunctionError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, error: Error, functionName: string, args: any[]) => boolean | void;
+    /**
+     * Custom error handler for errors occurred during serialization or messsaging
+     *
+     * @returns `true` to prevent the error from being thrown
+     */
+    onGeneralError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, error: Error, functionName?: string, args?: any[]) => boolean | void;
+    /**
+     * Custom error handler for timeouts
+     *
+     * @returns `true` to prevent the error from being thrown
+     */
+    onTimeoutError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, functionName: string, args: any[]) => boolean | void;
+}
+type BirpcOptions<RemoteFunctions, LocalFunctions extends object = Record<string, never>> = EventOptions<RemoteFunctions, LocalFunctions> & ChannelOptions;
+type BirpcFn<T> = PromisifyFn<T> & {
+    /**
+     * Send event without asking for response
+     */
+    asEvent: (...args: ArgumentsType<T>) => Promise<void>;
+};
+interface BirpcGroupFn<T> {
+    /**
+     * Call the remote function and wait for the result.
+     */
+    (...args: ArgumentsType<T>): Promise<Awaited<ReturnType<T>>[]>;
+    /**
+     * Send event without asking for response
+     */
+    asEvent: (...args: ArgumentsType<T>) => Promise<void>;
+}
+interface BirpcReturnBuiltin<RemoteFunctions, LocalFunctions = Record<string, never>> {
+    /**
+     * Raw functions object
+     */
+    $functions: LocalFunctions;
+    /**
+     * Whether the RPC is closed
+     */
+    readonly $closed: boolean;
+    /**
+     * Custom meta data attached to the RPC instance
+     */
+    readonly $meta: any;
+    /**
+     * Close the RPC connection
+     */
+    $close: (error?: Error) => void;
+    /**
+     * Reject pending calls
+     */
+    $rejectPendingCalls: (handler?: PendingCallHandler) => Promise<void>[];
+    /**
+     * Call the remote function and wait for the result.
+     * An alternative to directly calling the function
+     */
+    $call: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]>>>;
+    /**
+     * Same as `$call`, but returns `undefined` if the function is not defined on the remote side.
+     */
+    $callOptional: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]> | undefined>>;
+    /**
+     * Send event without asking for response
+     */
+    $callEvent: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<void>;
+    /**
+     * Call the remote function with the raw options.
+     */
+    $callRaw: (options: {
+        method: string;
+        args: unknown[];
+        event?: boolean;
+        optional?: boolean;
+    }) => Promise<Awaited<ReturnType<any>>[]>;
+}
+type BirpcReturn<RemoteFunctions, LocalFunctions = Record<string, never>> = {
+    [K in keyof RemoteFunctions]: BirpcFn<RemoteFunctions[K]>;
+} & BirpcReturnBuiltin<RemoteFunctions, LocalFunctions>;
+type PendingCallHandler = (options: Pick<PromiseEntry, 'method' | 'reject'>) => void | Promise<void>;
+interface BirpcGroupReturnBuiltin<RemoteFunctions> {
+    /**
+     * Call the remote function and wait for the result.
+     * An alternative to directly calling the function
+     */
+    $call: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]>>>;
+    /**
+     * Same as `$call`, but returns `undefined` if the function is not defined on the remote side.
+     */
+    $callOptional: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]> | undefined>>;
+    /**
+     * Send event without asking for response
+     */
+    $callEvent: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<void>;
+}
+type BirpcGroupReturn<RemoteFunctions> = {
+    [K in keyof RemoteFunctions]: BirpcGroupFn<RemoteFunctions[K]>;
+} & BirpcGroupReturnBuiltin<RemoteFunctions>;
+interface BirpcGroup<RemoteFunctions, LocalFunctions = Record<string, never>> {
+    readonly clients: BirpcReturn<RemoteFunctions, LocalFunctions>[];
+    readonly functions: LocalFunctions;
+    readonly broadcast: BirpcGroupReturn<RemoteFunctions>;
+    updateChannels: (fn?: ((channels: ChannelOptions[]) => void)) => BirpcReturn<RemoteFunctions, LocalFunctions>[];
+}
+interface PromiseEntry {
+    resolve: (arg: any) => void;
+    reject: (error: any) => void;
+    method: string;
+    timeoutId?: ReturnType<typeof setTimeout>;
+}
+declare const TYPE_REQUEST: "q";
+interface Request {
+    /**
+     * Type
+     */
+    t: typeof TYPE_REQUEST;
+    /**
+     * ID
+     */
+    i?: string;
+    /**
+     * Method
+     */
+    m: string;
+    /**
+     * Arguments
+     */
+    a: any[];
+    /**
+     * Optional
+     */
+    o?: boolean;
+}
+declare const DEFAULT_TIMEOUT = 60000;
+declare const setTimeout: typeof globalThis.setTimeout;
+declare function createBirpc<RemoteFunctions = Record<string, never>, LocalFunctions extends object = Record<string, never>>($functions: LocalFunctions, options: BirpcOptions<RemoteFunctions, LocalFunctions>): BirpcReturn<RemoteFunctions, LocalFunctions>;
+declare function cachedMap<T, R>(items: T[], fn: ((i: T) => R)): R[];
+declare function createBirpcGroup<RemoteFunctions = Record<string, never>, LocalFunctions extends object = Record<string, never>>(functions: LocalFunctions, channels: ChannelOptions[] | (() => ChannelOptions[]), options?: EventOptions<RemoteFunctions, LocalFunctions>): BirpcGroup<RemoteFunctions, LocalFunctions>;
+
+export { DEFAULT_TIMEOUT, cachedMap, createBirpc, createBirpcGroup };
+export type { ArgumentsType, BirpcFn, BirpcGroup, BirpcGroupFn, BirpcGroupReturn, BirpcGroupReturnBuiltin, BirpcOptions, BirpcResolver, BirpcReturn, BirpcReturnBuiltin, ChannelOptions, EventOptions, PromisifyFn, ReturnType, Thenable };

package/dist/client/node_modules/birpc/dist/index.d.ts

@@ -0,0 +1,215 @@
+type ArgumentsType<T> = T extends (...args: infer A) => any ? A : never;
+type ReturnType<T> = T extends (...args: any) => infer R ? R : never;
+type PromisifyFn<T> = ReturnType<T> extends Promise<any> ? T : (...args: ArgumentsType<T>) => Promise<Awaited<ReturnType<T>>>;
+type Thenable<T> = T | PromiseLike<T>;
+type BirpcResolver<This> = (this: This, name: string, resolved: (...args: unknown[]) => unknown) => Thenable<((...args: any[]) => any) | undefined>;
+interface ChannelOptions {
+    /**
+     * Function to post raw message
+     */
+    post: (data: any, ...extras: any[]) => any | Promise<any>;
+    /**
+     * Listener to receive raw message
+     */
+    on: (fn: (data: any, ...extras: any[]) => void) => any | Promise<any>;
+    /**
+     * Clear the listener when `$close` is called
+     */
+    off?: (fn: (data: any, ...extras: any[]) => void) => any | Promise<any>;
+    /**
+     * Custom function to serialize data
+     *
+     * by default it passes the data as-is
+     */
+    serialize?: (data: any) => any;
+    /**
+     * Custom function to deserialize data
+     *
+     * by default it passes the data as-is
+     */
+    deserialize?: (data: any) => any;
+    /**
+     * Call the methods with the RPC context or the original functions object
+     */
+    bind?: 'rpc' | 'functions';
+    /**
+     * Custom meta data to attached to the RPC instance's `$meta` property
+     */
+    meta?: any;
+}
+interface EventOptions<RemoteFunctions, LocalFunctions extends object = Record<string, never>> {
+    /**
+     * Names of remote functions that do not need response.
+     */
+    eventNames?: (keyof RemoteFunctions)[];
+    /**
+     * Maximum timeout for waiting for response, in milliseconds.
+     *
+     * @default 60_000
+     */
+    timeout?: number;
+    /**
+     * Custom resolver to resolve function to be called
+     *
+     * For advanced use cases only
+     */
+    resolver?: BirpcResolver<BirpcReturn<RemoteFunctions, LocalFunctions>>;
+    /**
+     * Hook triggered before an event is sent to the remote
+     *
+     * @param req - Request parameters
+     * @param next - Function to continue the request
+     * @param resolve - Function to resolve the response directly
+     */
+    onRequest?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, req: Request, next: (req?: Request) => Promise<any>, resolve: (res: any) => void) => void | Promise<void>;
+    /**
+     * Custom error handler
+     *
+     * @deprecated use `onFunctionError` and `onGeneralError` instead
+     */
+    onError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, error: Error, functionName: string, args: any[]) => boolean | void;
+    /**
+     * Custom error handler for errors occurred in local functions being called
+     *
+     * @returns `true` to prevent the error from being thrown
+     */
+    onFunctionError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, error: Error, functionName: string, args: any[]) => boolean | void;
+    /**
+     * Custom error handler for errors occurred during serialization or messsaging
+     *
+     * @returns `true` to prevent the error from being thrown
+     */
+    onGeneralError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, error: Error, functionName?: string, args?: any[]) => boolean | void;
+    /**
+     * Custom error handler for timeouts
+     *
+     * @returns `true` to prevent the error from being thrown
+     */
+    onTimeoutError?: (this: BirpcReturn<RemoteFunctions, LocalFunctions>, functionName: string, args: any[]) => boolean | void;
+}
+type BirpcOptions<RemoteFunctions, LocalFunctions extends object = Record<string, never>> = EventOptions<RemoteFunctions, LocalFunctions> & ChannelOptions;
+type BirpcFn<T> = PromisifyFn<T> & {
+    /**
+     * Send event without asking for response
+     */
+    asEvent: (...args: ArgumentsType<T>) => Promise<void>;
+};
+interface BirpcGroupFn<T> {
+    /**
+     * Call the remote function and wait for the result.
+     */
+    (...args: ArgumentsType<T>): Promise<Awaited<ReturnType<T>>[]>;
+    /**
+     * Send event without asking for response
+     */
+    asEvent: (...args: ArgumentsType<T>) => Promise<void>;
+}
+interface BirpcReturnBuiltin<RemoteFunctions, LocalFunctions = Record<string, never>> {
+    /**
+     * Raw functions object
+     */
+    $functions: LocalFunctions;
+    /**
+     * Whether the RPC is closed
+     */
+    readonly $closed: boolean;
+    /**
+     * Custom meta data attached to the RPC instance
+     */
+    readonly $meta: any;
+    /**
+     * Close the RPC connection
+     */
+    $close: (error?: Error) => void;
+    /**
+     * Reject pending calls
+     */
+    $rejectPendingCalls: (handler?: PendingCallHandler) => Promise<void>[];
+    /**
+     * Call the remote function and wait for the result.
+     * An alternative to directly calling the function
+     */
+    $call: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]>>>;
+    /**
+     * Same as `$call`, but returns `undefined` if the function is not defined on the remote side.
+     */
+    $callOptional: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]> | undefined>>;
+    /**
+     * Send event without asking for response
+     */
+    $callEvent: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<void>;
+    /**
+     * Call the remote function with the raw options.
+     */
+    $callRaw: (options: {
+        method: string;
+        args: unknown[];
+        event?: boolean;
+        optional?: boolean;
+    }) => Promise<Awaited<ReturnType<any>>[]>;
+}
+type BirpcReturn<RemoteFunctions, LocalFunctions = Record<string, never>> = {
+    [K in keyof RemoteFunctions]: BirpcFn<RemoteFunctions[K]>;
+} & BirpcReturnBuiltin<RemoteFunctions, LocalFunctions>;
+type PendingCallHandler = (options: Pick<PromiseEntry, 'method' | 'reject'>) => void | Promise<void>;
+interface BirpcGroupReturnBuiltin<RemoteFunctions> {
+    /**
+     * Call the remote function and wait for the result.
+     * An alternative to directly calling the function
+     */
+    $call: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]>>>;
+    /**
+     * Same as `$call`, but returns `undefined` if the function is not defined on the remote side.
+     */
+    $callOptional: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<Awaited<ReturnType<RemoteFunctions[K]> | undefined>>;
+    /**
+     * Send event without asking for response
+     */
+    $callEvent: <K extends keyof RemoteFunctions>(method: K, ...args: ArgumentsType<RemoteFunctions[K]>) => Promise<void>;
+}
+type BirpcGroupReturn<RemoteFunctions> = {
+    [K in keyof RemoteFunctions]: BirpcGroupFn<RemoteFunctions[K]>;
+} & BirpcGroupReturnBuiltin<RemoteFunctions>;
+interface BirpcGroup<RemoteFunctions, LocalFunctions = Record<string, never>> {
+    readonly clients: BirpcReturn<RemoteFunctions, LocalFunctions>[];
+    readonly functions: LocalFunctions;
+    readonly broadcast: BirpcGroupReturn<RemoteFunctions>;
+    updateChannels: (fn?: ((channels: ChannelOptions[]) => void)) => BirpcReturn<RemoteFunctions, LocalFunctions>[];
+}
+interface PromiseEntry {
+    resolve: (arg: any) => void;
+    reject: (error: any) => void;
+    method: string;
+    timeoutId?: ReturnType<typeof setTimeout>;
+}
+declare const TYPE_REQUEST: "q";
+interface Request {
+    /**
+     * Type
+     */
+    t: typeof TYPE_REQUEST;
+    /**
+     * ID
+     */
+    i?: string;
+    /**
+     * Method
+     */
+    m: string;
+    /**
+     * Arguments
+     */
+    a: any[];
+    /**
+     * Optional
+     */
+    o?: boolean;
+}
+declare const DEFAULT_TIMEOUT = 60000;
+declare const setTimeout: typeof globalThis.setTimeout;
+declare function createBirpc<RemoteFunctions = Record<string, never>, LocalFunctions extends object = Record<string, never>>($functions: LocalFunctions, options: BirpcOptions<RemoteFunctions, LocalFunctions>): BirpcReturn<RemoteFunctions, LocalFunctions>;
+declare function cachedMap<T, R>(items: T[], fn: ((i: T) => R)): R[];
+declare function createBirpcGroup<RemoteFunctions = Record<string, never>, LocalFunctions extends object = Record<string, never>>(functions: LocalFunctions, channels: ChannelOptions[] | (() => ChannelOptions[]), options?: EventOptions<RemoteFunctions, LocalFunctions>): BirpcGroup<RemoteFunctions, LocalFunctions>;
+
+export { DEFAULT_TIMEOUT, cachedMap, createBirpc, createBirpcGroup };
+export type { ArgumentsType, BirpcFn, BirpcGroup, BirpcGroupFn, BirpcGroupReturn, BirpcGroupReturnBuiltin, BirpcOptions, BirpcResolver, BirpcReturn, BirpcReturnBuiltin, ChannelOptions, EventOptions, PromisifyFn, ReturnType, Thenable };

package/dist/client/node_modules/birpc/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "birpc",
+  "type": "module",
+  "version": "2.9.0",
+  "description": "Message based Two-way remote procedure call",
+  "author": "Anthony Fu <anthonyfu117@hotmail.com>",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/antfu",
+  "homepage": "https://github.com/antfu-collective/birpc#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/antfu-collective/birpc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/antfu-collective/birpc/issues"
+  },
+  "keywords": [
+    "rpc",
+    "messages"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.3.0",
+    "@antfu/ni": "^28.0.0",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "3.0.9",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "unbuild": "^3.6.1",
+    "vite": "^7.2.6",
+    "vitest": "^4.0.15"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "lint": "eslint .",
+    "release": "bumpp",
+    "start": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest"
+  }
+}

package/dist/client/node_modules/chokidar/handler.d.ts

@@ -0,0 +1,90 @@
+import type { FSWatcher as NativeFsWatcher, Stats, WatchEventType } from 'node:fs';
+import type { EntryInfo } from 'readdirp';
+import type { FSWatcher, Throttler, WatchHelper } from './index.js';
+export type Path = string;
+export declare const STR_DATA = "data";
+export declare const STR_END = "end";
+export declare const STR_CLOSE = "close";
+export declare const EMPTY_FN: () => void;
+export declare const IDENTITY_FN: (val: unknown) => unknown;
+export declare const isWindows: boolean;
+export declare const isMacos: boolean;
+export declare const isLinux: boolean;
+export declare const isFreeBSD: boolean;
+export declare const isIBMi: boolean;
+export declare const EVENTS: {
+    readonly ALL: "all";
+    readonly READY: "ready";
+    readonly ADD: "add";
+    readonly CHANGE: "change";
+    readonly ADD_DIR: "addDir";
+    readonly UNLINK: "unlink";
+    readonly UNLINK_DIR: "unlinkDir";
+    readonly RAW: "raw";
+    readonly ERROR: "error";
+};
+export type EventName = (typeof EVENTS)[keyof typeof EVENTS];
+export type FsWatchContainer = {
+    listeners: (path: string) => void | Set<any>;
+    errHandlers: (err: unknown) => void | Set<any>;
+    rawEmitters: (ev: WatchEventType, path: string, opts: unknown) => void | Set<any>;
+    watcher: NativeFsWatcher;
+    watcherUnusable?: boolean;
+};
+export interface WatchHandlers {
+    listener: (path: string) => void;
+    errHandler: (err: unknown) => void;
+    rawEmitter: (ev: WatchEventType, path: string, opts: unknown) => void;
+}
+/**
+ * @mixin
+ */
+export declare class NodeFsHandler {
+    fsw: FSWatcher;
+    _boundHandleError: (error: unknown) => void;
+    constructor(fsW: FSWatcher);
+    /**
+     * Watch file for changes with fs_watchFile or fs_watch.
+     * @param path to file or dir
+     * @param listener on fs change
+     * @returns closer for the watcher instance
+     */
+    _watchWithNodeFs(path: string, listener: (path: string, newStats?: any) => void | Promise<void>): (() => void) | undefined;
+    /**
+     * Watch a file and emit add event if warranted.
+     * @returns closer for the watcher instance
+     */
+    _handleFile(file: Path, stats: Stats, initialAdd: boolean): (() => void) | undefined;
+    /**
+     * Handle symlinks encountered while reading a dir.
+     * @param entry returned by readdirp
+     * @param directory path of dir being read
+     * @param path of this item
+     * @param item basename of this item
+     * @returns true if no more processing is needed for this entry.
+     */
+    _handleSymlink(entry: EntryInfo, directory: string, path: Path, item: string): Promise<boolean | undefined>;
+    _handleRead(directory: string, initialAdd: boolean, wh: WatchHelper, target: Path | undefined, dir: Path, depth: number, throttler: Throttler): Promise<unknown> | undefined;
+    /**
+     * Read directory to add / remove files from `@watched` list and re-read it on change.
+     * @param dir fs path
+     * @param stats
+     * @param initialAdd
+     * @param depth relative to user-supplied path
+     * @param target child path targeted for watch
+     * @param wh Common watch helpers for this path
+     * @param realpath
+     * @returns closer for the watcher instance.
+     */
+    _handleDir(dir: string, stats: Stats, initialAdd: boolean, depth: number, target: string | undefined, wh: WatchHelper, realpath: string): Promise<(() => void) | undefined>;
+    /**
+     * Handle added file, directory, or glob pattern.
+     * Delegates call to _handleFile / _handleDir after checks.
+     * @param path to file or ir
+     * @param initialAdd was the file added at watch instantiation?
+     * @param priorWh depth relative to user-supplied path
+     * @param depth Child path actually targeted for watch
+     * @param target Child path actually targeted for watch
+     */
+    _addToNodeFs(path: string, initialAdd: boolean, priorWh: WatchHelper | undefined, depth: number, target?: string): Promise<string | false | undefined>;
+}