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

//#region ../@warlock.js/fs/src/facade/fs.d.ts
/**
 * The `fs` shorthand facade — an async, ergonomic surface over
 * `@warlock.js/fs`'s primitives:
 *
 * - `fs.files.*` — file operations
 * - `fs.dirs.*` — directory operations
 * - `fs.file(path)` / `fs.dir(path)` — lazy `File` / `Directory` handles
 * - `fs.exists(path)` — type-agnostic existence (file OR directory)
 *
 * Async-only by design: synchronous callers use the bare primitives
 * (`getFile` / `putFile` / …), which keep the package's `bare = sync`,
 * `*Async = async` charter. `fs.*` never sandboxes paths — path containment is
 * the storage layer's job.
 *
 * @example
 * import { fs } from "@warlock.js/fs";
 *
 * await fs.files.put("cache/data.json", "{}", { atomic: true });
 * const cfg = await fs.files.getJson("config.json", { schema, default: {} });
 * const dir = fs.dir("uploads");
 * if (await dir.isEmpty()) { ... }
 */
declare const fs: {
  files: {
    get: {
      (path: string): Promise<string>;
      (path: string, options: ReadOptions & {
        encoding: null;
      }): Promise<Buffer>;
      (path: string, options: ReadOptions): Promise<string | Buffer>;
    };
    getJson: <T = unknown>(path: string, options?: ReadJsonOptions<T>) => Promise<T>;
    put: (path: string, content: string | Buffer, options?: WriteOptions) => Promise<void>;
    putJson: (path: string, value: unknown, options?: WriteJsonOptions) => Promise<void>;
    create: (path: string, content: string | Buffer, options?: WriteOptions) => Promise<void>;
    createJson: (path: string, value: unknown, options?: WriteJsonOptions) => Promise<void>;
    exists: (path: string) => Promise<boolean>;
    remove: (path: string) => Promise<void>;
    copy: (from: string, to: string, options?: CopyOptions) => Promise<void>;
    move: (from: string, to: string, options?: MoveOptions) => Promise<void>;
    stats: (path: string) => Promise<FileStats>;
    lastModified: (path: string) => Promise<Date>;
    hash: (path: string, algorithm?: HashAlgorithm) => Promise<string>;
    append: (path: string, content: string | Buffer, options?: WriteOptions) => Promise<void>;
    prepend: (path: string, content: string | Buffer, options?: WriteOptions) => Promise<void>;
    appendLine: (path: string, line: string) => Promise<void>;
    appendJsonLine: (path: string, value: unknown) => Promise<void>;
    size: (path: string) => Promise<number>;
    isEmpty: (path: string) => Promise<boolean>;
    ensure: (path: string) => Promise<void>;
    touch: (path: string) => Promise<void>;
    edit: (path: string, editor: (content: string) => string | Promise<string>) => Promise<void>;
    editJson: <T = unknown>(path: string, editor: (value: T) => T | Promise<T>, options?: WriteJsonOptions) => Promise<void>;
    mergeJson: <T = Record<string, unknown>>(path: string, partial: Partial<T>, options?: MergeJsonOptions) => Promise<void>;
    ensureJson: <T = unknown>(path: string, fallback: T, options?: WriteJsonOptions) => Promise<T>;
    checksumMatches: (path: string, expected: string, algorithm?: HashAlgorithm) => Promise<boolean>;
    readLines: (path: string) => AsyncIterable<string>;
  };
  dirs: {
    ensure: (path: string) => Promise<void>;
    remove: (path: string) => Promise<void>;
    empty: (path: string) => Promise<void>;
    exists: (path: string) => Promise<boolean>;
    copy: (from: string, to: string, options?: CopyOptions) => Promise<void>;
    move: (from: string, to: string, options?: MoveOptions) => Promise<void>;
    stats: (path: string) => Promise<FileStats>;
    size: (path: string) => Promise<number>;
    count: (path: string) => Promise<number>;
    isEmpty: (path: string) => Promise<boolean>;
    list: (path: string, options?: ListOptions) => Promise<string[]>;
    listFiles: (path: string, options?: ListOptions) => Promise<string[]>;
    listDirs: (path: string, options?: ListOptions) => Promise<string[]>;
    walk: (root: string, options?: WalkOptions) => AsyncGenerator<WalkEntry>;
    hash: (path: string, algorithm?: HashAlgorithm) => Promise<string>;
  };
  /**
   * Hashing — `file`/`dir` are async (they read from disk); `string`/`buffer`
   * are sync (pure, in-memory — no IO to await). Defaults to SHA-256.
   */
  hash: {
    file: (path: string, algorithm?: HashAlgorithm) => Promise<string>;
    dir: (path: string, algorithm?: HashAlgorithm) => Promise<string>;
    string: (content: string, algorithm?: HashAlgorithm) => string;
    buffer: (content: Buffer | Uint8Array, algorithm?: HashAlgorithm) => string;
  }; /** Does anything exist at this path (file OR directory)? */
  exists(path: string): Promise<boolean>; /** A lazy handle to a file path (no IO until a method is called). */
  file(path: string): File; /** A lazy handle to a directory path (no IO until a method is called). */
  dir(path: string): Directory;
};
//#endregion
export { fs };
//# sourceMappingURL=fs.d.mts.map