fs

File system utilities.

import { checkSourceExists, ensureTargetDir, fileExists, shouldUpdateFile, copySourceToTarget, writeFileContent, readFileSync, runWithConcurrency } from '@meng-xi/vite-plugin/common'

checkSourceExists

Check if source file exists, throws if not.

async function checkSourceExists(sourcePath: string): Promise<void>

---

ensureTargetDir

Ensure target directory exists, create recursively if not.

async function ensureTargetDir(targetPath: string): Promise<void>

---

fileExists

Check if file exists.

async function fileExists(filePath: string): Promise<boolean>

---

shouldUpdateFile

Check if file needs update (compare mtime and size).

async function shouldUpdateFile(sourceFile: string, targetFile: string): Promise<boolean>

---

copySourceToTarget

Copy files or directories to target location.

async function copySourceToTarget(sourcePath: string, targetPath: string, options: CopyOptions): Promise<CopyResult>

CopyOptions

Property	Type	Default	Description
recursive	boolean	-	Recursively copy
overwrite	boolean	-	Overwrite existing
incremental	boolean	false	Only copy modified
parallelLimit	number	10	Concurrency limit

CopyResult

Property	Type	Description
copiedFiles	number	Files copied
skippedFiles	number	Files skipped
copiedDirs	number	Directories copied
executionTime	number	Execution time (ms)

---

writeFileContent

Write content to file.

async function writeFileContent(filePath: string, content: string): Promise<void>

---

readFileSync

Synchronously read file content.

function readFileSync(filePath: string): string

---

runWithConcurrency

Execute tasks with concurrency limit.

async function runWithConcurrency<T, R>(items: T[], handler: (item: T) => Promise<R>, concurrency: number): Promise<R[]>