elit 2.0.1 → 3.0.1

package/dist/fs.d.mts

@@ -0,0 +1,255 @@
+/**
+ * File System module with unified API across runtimes
+ * Compatible with Node.js 'fs' module API
+ * - Node.js: uses 'fs' module
+ * - Bun: uses Bun.file() and native APIs
+ * - Deno: uses Deno.readFile(), etc.
+ */
+/**
+ * File encoding types
+ */
+type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
+/**
+ * Read file options
+ */
+interface ReadFileOptions {
+    encoding?: BufferEncoding | null;
+    flag?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Write file options
+ */
+interface WriteFileOptions {
+    encoding?: BufferEncoding | null;
+    mode?: number;
+    flag?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Mkdir options
+ */
+interface MkdirOptions {
+    recursive?: boolean;
+    mode?: number;
+}
+/**
+ * Readdir options
+ */
+interface ReaddirOptions {
+    encoding?: BufferEncoding | null;
+    withFileTypes?: boolean;
+    recursive?: boolean;
+}
+/**
+ * File stats
+ */
+interface Stats {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isSymbolicLink(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+    dev: number;
+    ino: number;
+    mode: number;
+    nlink: number;
+    uid: number;
+    gid: number;
+    rdev: number;
+    size: number;
+    blksize: number;
+    blocks: number;
+    atimeMs: number;
+    mtimeMs: number;
+    ctimeMs: number;
+    birthtimeMs: number;
+    atime: Date;
+    mtime: Date;
+    ctime: Date;
+    birthtime: Date;
+}
+/**
+ * Directory entry
+ */
+interface Dirent {
+    name: string;
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isSymbolicLink(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+}
+/**
+ * Read file (async)
+ */
+declare function readFile(path: string, options?: ReadFileOptions | BufferEncoding): Promise<string | Buffer>;
+/**
+ * Read file (sync)
+ */
+declare function readFileSync(path: string, options?: ReadFileOptions | BufferEncoding): string | Buffer;
+/**
+ * Write file (async)
+ */
+declare function writeFile(path: string, data: string | Buffer | Uint8Array, options?: WriteFileOptions | BufferEncoding): Promise<void>;
+/**
+ * Write file (sync)
+ */
+declare function writeFileSync(path: string, data: string | Buffer | Uint8Array, options?: WriteFileOptions | BufferEncoding): void;
+/**
+ * Append file (async)
+ */
+declare function appendFile(path: string, data: string | Buffer, options?: WriteFileOptions | BufferEncoding): Promise<void>;
+/**
+ * Append file (sync)
+ */
+declare function appendFileSync(path: string, data: string | Buffer, options?: WriteFileOptions | BufferEncoding): void;
+/**
+ * Check if file/directory exists (async)
+ */
+declare function exists(path: string): Promise<boolean>;
+/**
+ * Check if file/directory exists (sync)
+ */
+declare function existsSync(path: string): boolean;
+/**
+ * Get file stats (async)
+ */
+declare function stat(path: string): Promise<Stats>;
+/**
+ * Get file stats (sync)
+ */
+declare function statSync(path: string): Stats;
+/**
+ * Create directory (async)
+ */
+declare function mkdir(path: string, options?: MkdirOptions | number): Promise<void>;
+/**
+ * Create directory (sync)
+ */
+declare function mkdirSync(path: string, options?: MkdirOptions | number): void;
+/**
+ * Read directory (async)
+ */
+declare function readdir(path: string, options?: ReaddirOptions | BufferEncoding): Promise<string[] | Dirent[]>;
+/**
+ * Read directory (sync)
+ */
+declare function readdirSync(path: string, options?: ReaddirOptions | BufferEncoding): string[] | Dirent[];
+/**
+ * Remove file (async)
+ */
+declare function unlink(path: string): Promise<void>;
+/**
+ * Remove file (sync)
+ */
+declare function unlinkSync(path: string): void;
+/**
+ * Remove directory (async)
+ */
+declare function rmdir(path: string, options?: {
+    recursive?: boolean;
+}): Promise<void>;
+/**
+ * Remove directory (sync)
+ */
+declare function rmdirSync(path: string, options?: {
+    recursive?: boolean;
+}): void;
+/**
+ * Rename/move file (async)
+ */
+declare function rename(oldPath: string, newPath: string): Promise<void>;
+/**
+ * Rename/move file (sync)
+ */
+declare function renameSync(oldPath: string, newPath: string): void;
+/**
+ * Copy file (async)
+ */
+declare function copyFile(src: string, dest: string, flags?: number): Promise<void>;
+/**
+ * Copy file (sync)
+ */
+declare function copyFileSync(src: string, dest: string, flags?: number): void;
+/**
+ * Resolve pathname to absolute path (async)
+ */
+declare function realpath(path: string, options?: {
+    encoding?: BufferEncoding;
+}): Promise<string>;
+/**
+ * Resolve pathname to absolute path (sync)
+ */
+declare function realpathSync(path: string, options?: {
+    encoding?: BufferEncoding;
+}): string;
+/**
+ * Get current runtime
+ */
+declare function getRuntime(): 'node' | 'bun' | 'deno';
+/**
+ * Promises API (re-export for compatibility)
+ */
+declare const promises: {
+    readFile: typeof readFile;
+    writeFile: typeof writeFile;
+    appendFile: typeof appendFile;
+    stat: typeof stat;
+    mkdir: typeof mkdir;
+    readdir: typeof readdir;
+    unlink: typeof unlink;
+    rmdir: typeof rmdir;
+    rename: typeof rename;
+    copyFile: typeof copyFile;
+    realpath: typeof realpath;
+};
+/**
+ * Default export
+ */
+declare const _default: {
+    readFile: typeof readFile;
+    readFileSync: typeof readFileSync;
+    writeFile: typeof writeFile;
+    writeFileSync: typeof writeFileSync;
+    appendFile: typeof appendFile;
+    appendFileSync: typeof appendFileSync;
+    exists: typeof exists;
+    existsSync: typeof existsSync;
+    stat: typeof stat;
+    statSync: typeof statSync;
+    mkdir: typeof mkdir;
+    mkdirSync: typeof mkdirSync;
+    readdir: typeof readdir;
+    readdirSync: typeof readdirSync;
+    unlink: typeof unlink;
+    unlinkSync: typeof unlinkSync;
+    rmdir: typeof rmdir;
+    rmdirSync: typeof rmdirSync;
+    rename: typeof rename;
+    renameSync: typeof renameSync;
+    copyFile: typeof copyFile;
+    copyFileSync: typeof copyFileSync;
+    realpath: typeof realpath;
+    realpathSync: typeof realpathSync;
+    promises: {
+        readFile: typeof readFile;
+        writeFile: typeof writeFile;
+        appendFile: typeof appendFile;
+        stat: typeof stat;
+        mkdir: typeof mkdir;
+        readdir: typeof readdir;
+        unlink: typeof unlink;
+        rmdir: typeof rmdir;
+        rename: typeof rename;
+        copyFile: typeof copyFile;
+        realpath: typeof realpath;
+    };
+    getRuntime: typeof getRuntime;
+};
+
+export { type BufferEncoding, type Dirent, type MkdirOptions, type ReadFileOptions, type ReaddirOptions, type Stats, type WriteFileOptions, appendFile, appendFileSync, copyFile, copyFileSync, _default as default, exists, existsSync, getRuntime, mkdir, mkdirSync, promises, readFile, readFileSync, readdir, readdirSync, realpath, realpathSync, rename, renameSync, rmdir, rmdirSync, stat, statSync, unlink, unlinkSync, writeFile, writeFileSync };

package/dist/fs.d.ts

@@ -0,0 +1,255 @@
+/**
+ * File System module with unified API across runtimes
+ * Compatible with Node.js 'fs' module API
+ * - Node.js: uses 'fs' module
+ * - Bun: uses Bun.file() and native APIs
+ * - Deno: uses Deno.readFile(), etc.
+ */
+/**
+ * File encoding types
+ */
+type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
+/**
+ * Read file options
+ */
+interface ReadFileOptions {
+    encoding?: BufferEncoding | null;
+    flag?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Write file options
+ */
+interface WriteFileOptions {
+    encoding?: BufferEncoding | null;
+    mode?: number;
+    flag?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Mkdir options
+ */
+interface MkdirOptions {
+    recursive?: boolean;
+    mode?: number;
+}
+/**
+ * Readdir options
+ */
+interface ReaddirOptions {
+    encoding?: BufferEncoding | null;
+    withFileTypes?: boolean;
+    recursive?: boolean;
+}
+/**
+ * File stats
+ */
+interface Stats {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isSymbolicLink(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+    dev: number;
+    ino: number;
+    mode: number;
+    nlink: number;
+    uid: number;
+    gid: number;
+    rdev: number;
+    size: number;
+    blksize: number;
+    blocks: number;
+    atimeMs: number;
+    mtimeMs: number;
+    ctimeMs: number;
+    birthtimeMs: number;
+    atime: Date;
+    mtime: Date;
+    ctime: Date;
+    birthtime: Date;
+}
+/**
+ * Directory entry
+ */
+interface Dirent {
+    name: string;
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isSymbolicLink(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+}
+/**
+ * Read file (async)
+ */
+declare function readFile(path: string, options?: ReadFileOptions | BufferEncoding): Promise<string | Buffer>;
+/**
+ * Read file (sync)
+ */
+declare function readFileSync(path: string, options?: ReadFileOptions | BufferEncoding): string | Buffer;
+/**
+ * Write file (async)
+ */
+declare function writeFile(path: string, data: string | Buffer | Uint8Array, options?: WriteFileOptions | BufferEncoding): Promise<void>;
+/**
+ * Write file (sync)
+ */
+declare function writeFileSync(path: string, data: string | Buffer | Uint8Array, options?: WriteFileOptions | BufferEncoding): void;
+/**
+ * Append file (async)
+ */
+declare function appendFile(path: string, data: string | Buffer, options?: WriteFileOptions | BufferEncoding): Promise<void>;
+/**
+ * Append file (sync)
+ */
+declare function appendFileSync(path: string, data: string | Buffer, options?: WriteFileOptions | BufferEncoding): void;
+/**
+ * Check if file/directory exists (async)
+ */
+declare function exists(path: string): Promise<boolean>;
+/**
+ * Check if file/directory exists (sync)
+ */
+declare function existsSync(path: string): boolean;
+/**
+ * Get file stats (async)
+ */
+declare function stat(path: string): Promise<Stats>;
+/**
+ * Get file stats (sync)
+ */
+declare function statSync(path: string): Stats;
+/**
+ * Create directory (async)
+ */
+declare function mkdir(path: string, options?: MkdirOptions | number): Promise<void>;
+/**
+ * Create directory (sync)
+ */
+declare function mkdirSync(path: string, options?: MkdirOptions | number): void;
+/**
+ * Read directory (async)
+ */
+declare function readdir(path: string, options?: ReaddirOptions | BufferEncoding): Promise<string[] | Dirent[]>;
+/**
+ * Read directory (sync)
+ */
+declare function readdirSync(path: string, options?: ReaddirOptions | BufferEncoding): string[] | Dirent[];
+/**
+ * Remove file (async)
+ */
+declare function unlink(path: string): Promise<void>;
+/**
+ * Remove file (sync)
+ */
+declare function unlinkSync(path: string): void;
+/**
+ * Remove directory (async)
+ */
+declare function rmdir(path: string, options?: {
+    recursive?: boolean;
+}): Promise<void>;
+/**
+ * Remove directory (sync)
+ */
+declare function rmdirSync(path: string, options?: {
+    recursive?: boolean;
+}): void;
+/**
+ * Rename/move file (async)
+ */
+declare function rename(oldPath: string, newPath: string): Promise<void>;
+/**
+ * Rename/move file (sync)
+ */
+declare function renameSync(oldPath: string, newPath: string): void;
+/**
+ * Copy file (async)
+ */
+declare function copyFile(src: string, dest: string, flags?: number): Promise<void>;
+/**
+ * Copy file (sync)
+ */
+declare function copyFileSync(src: string, dest: string, flags?: number): void;
+/**
+ * Resolve pathname to absolute path (async)
+ */
+declare function realpath(path: string, options?: {
+    encoding?: BufferEncoding;
+}): Promise<string>;
+/**
+ * Resolve pathname to absolute path (sync)
+ */
+declare function realpathSync(path: string, options?: {
+    encoding?: BufferEncoding;
+}): string;
+/**
+ * Get current runtime
+ */
+declare function getRuntime(): 'node' | 'bun' | 'deno';
+/**
+ * Promises API (re-export for compatibility)
+ */
+declare const promises: {
+    readFile: typeof readFile;
+    writeFile: typeof writeFile;
+    appendFile: typeof appendFile;
+    stat: typeof stat;
+    mkdir: typeof mkdir;
+    readdir: typeof readdir;
+    unlink: typeof unlink;
+    rmdir: typeof rmdir;
+    rename: typeof rename;
+    copyFile: typeof copyFile;
+    realpath: typeof realpath;
+};
+/**
+ * Default export
+ */
+declare const _default: {
+    readFile: typeof readFile;
+    readFileSync: typeof readFileSync;
+    writeFile: typeof writeFile;
+    writeFileSync: typeof writeFileSync;
+    appendFile: typeof appendFile;
+    appendFileSync: typeof appendFileSync;
+    exists: typeof exists;
+    existsSync: typeof existsSync;
+    stat: typeof stat;
+    statSync: typeof statSync;
+    mkdir: typeof mkdir;
+    mkdirSync: typeof mkdirSync;
+    readdir: typeof readdir;
+    readdirSync: typeof readdirSync;
+    unlink: typeof unlink;
+    unlinkSync: typeof unlinkSync;
+    rmdir: typeof rmdir;
+    rmdirSync: typeof rmdirSync;
+    rename: typeof rename;
+    renameSync: typeof renameSync;
+    copyFile: typeof copyFile;
+    copyFileSync: typeof copyFileSync;
+    realpath: typeof realpath;
+    realpathSync: typeof realpathSync;
+    promises: {
+        readFile: typeof readFile;
+        writeFile: typeof writeFile;
+        appendFile: typeof appendFile;
+        stat: typeof stat;
+        mkdir: typeof mkdir;
+        readdir: typeof readdir;
+        unlink: typeof unlink;
+        rmdir: typeof rmdir;
+        rename: typeof rename;
+        copyFile: typeof copyFile;
+        realpath: typeof realpath;
+    };
+    getRuntime: typeof getRuntime;
+};
+
+export { type BufferEncoding, type Dirent, type MkdirOptions, type ReadFileOptions, type ReaddirOptions, type Stats, type WriteFileOptions, appendFile, appendFileSync, copyFile, copyFileSync, _default as default, exists, existsSync, getRuntime, mkdir, mkdirSync, promises, readFile, readFileSync, readdir, readdirSync, realpath, realpathSync, rename, renameSync, rmdir, rmdirSync, stat, statSync, unlink, unlinkSync, writeFile, writeFileSync };