import { HashAlgorithm } from "../hash.mjs";
import { CopyOptions, FileStats, MergeJsonOptions, MoveOptions, ReadJsonOptions, ReadOptions, WriteJsonOptions, WriteOptions } from "./options.mjs";
import { Directory } from "./directory.mjs";

//#region ../@warlock.js/fs/src/facade/file.d.ts
/**
 * A lazy, **immutable** handle to a file path. The constructor does zero IO;
 * path helpers (`name`/`extension`/`basename`/`parent`) are pure `node:path`.
 * `copy`/`move`/`copyTo`/`moveTo`/`rename` return a NEW handle to the
 * destination and never mutate `this.path`.
 *
 * @example
 * const pkg = fs.file("package.json");
 * await pkg.editJson<Pkg>((p) => ({ ...p, version: "4.7.0" }));
 * pkg.extension; // ".json"
 */
declare class File {
  readonly path: string;
  constructor(path: string);
  /** Basename including extension (`"user.model.ts"`). */
  get name(): string;
  /** Basename without extension (`"user.model"`). */
  get basename(): string;
  /** Extension including the dot (`".ts"`), or `""` when there is none. */
  get extension(): string;
  /** Handle to the parent directory (pure path — no IO). */
  parent(): Directory;
  get(): Promise<string>;
  get(options: ReadOptions & {
    encoding: null;
  }): Promise<Buffer>;
  get(options: ReadOptions): Promise<string | Buffer>;
  getJson<T = unknown>(options?: ReadJsonOptions<T>): Promise<T>;
  put(content: string | Buffer, options?: WriteOptions): Promise<void>;
  putJson(value: unknown, options?: WriteJsonOptions): Promise<void>;
  append(content: string | Buffer, options?: WriteOptions): Promise<void>;
  prepend(content: string | Buffer, options?: WriteOptions): Promise<void>;
  appendJsonLine(value: unknown): Promise<void>;
  edit(editor: (content: string) => string | Promise<string>): Promise<void>;
  editJson<T = unknown>(editor: (value: T) => T | Promise<T>, options?: WriteJsonOptions): Promise<void>;
  mergeJson<T = Record<string, unknown>>(partial: Partial<T>, options?: MergeJsonOptions): Promise<void>;
  exists(): Promise<boolean>;
  isEmpty(): Promise<boolean>;
  ensure(): Promise<void>;
  touch(): Promise<void>;
  remove(): Promise<void>;
  copy(to: string, options?: CopyOptions): Promise<File>;
  /** Copy into a directory, keeping this file's name. */
  copyTo(dir: string | Directory, options?: CopyOptions): Promise<File>;
  move(to: string, options?: MoveOptions): Promise<File>;
  /** Move into a directory, keeping this file's name. */
  moveTo(dir: string | Directory, options?: MoveOptions): Promise<File>;
  /** Rename within the same parent directory. */
  rename(newName: string, options?: MoveOptions): Promise<File>;
  stats(): Promise<FileStats>;
  size(): Promise<number>;
  lastModified(): Promise<Date>;
  hash(algorithm?: HashAlgorithm): Promise<string>;
  readLines(): AsyncIterable<string>;
}
//#endregion
export { File };
//# sourceMappingURL=file.d.mts.map