@meng-xi/vite-plugin 0.0.4 → 0.0.6

package/README.md

@@ -1,143 +1,343 @@
-**中文** | [English](./README-en.md)
-
-<div align="center">
-	<a href="https://github.com/MengXi-Studio/vite-plugin">
-		<img alt="梦曦工作室 Logo" width="215" src="https://github.com/MengXi-Studio/vite-plugin/blob/master/packages/docs/src/public/logo.svg">
-	</a>
-	<br>
-	<h1>@meng-xi/vite-plugin</h1>
-
-[![license](https://img.shields.io/github/license/MengXi-Studio/vite-plugin.svg)](LICENSE) [![npm](https://img.shields.io/npm/v/@meng-xi/vite-plugin?color=blue)](https://www.npmjs.com/package/@meng-xi/vite-plugin)
-![npm](https://img.shields.io/npm/dt/@meng-xi/vite-plugin?color=green)
-
-</div>
-
-## 简介
-
-`@meng-xi/vite-plugin` 是一个为 Vite 提供实用插件的工具包，也是一个**完整的插件开发框架**。该框架提供了常用功能的核心工具方法供扩展支持其他拓展工作开展快速开发。
-
-## 特性
-
-- **增强 Vite 构建流程**：提供实用插件集合，扩展 Vite 功能，简化构建过程中的常见任务，提高开发效率
-- **插件开发框架**：导出核心组件如 BasePlugin、Logger、Validator，允许开发者基于相同基础设施构建自定义插件
-- **高度可配置**：所有功能支持详细配置选项，可根据项目需求自定义行为，满足多样化场景
-- **单例日志系统**：统一的日志管理器，支持插件级别的日志控制，便于调试和问题排查
-- **类型安全验证**：强类型配置验证器，确保插件配置正确性，提供完整的 TypeScript 类型定义
-- **插件工厂模式**：支持选项标准化器，轻松处理异构输入，简化插件开发工作流
-- **无缝集成**：与 Vite 构建流程无缝集成，无需复杂配置即可快速启用
-- **优化开发体验**：简化常见构建任务，减少手动操作，让开发者专注于核心业务逻辑
-
-## 文档
-
-开始阅读[文档地址](https://mengxi-studio.github.io/vite-plugin/)。
-
-## 安装
-
-使用包管理器安装 `@meng-xi/vite-plugin`：
-
-```bash
-# 使用 npm
-npm install @meng-xi/vite-plugin --save-dev
-
-# 使用 yarn
-yarn add @meng-xi/vite-plugin --save-dev
-
-# 使用 pnpm
-pnpm add @meng-xi/vite-plugin --save-dev
-```
-
-## 基本使用
-
-### 使用内置插件
-
-```typescript
-import { defineConfig } from 'vite'
-import { copyFile, injectIco } from '@meng-xi/vite-plugin'
-
-export default defineConfig({
-	plugins: [
-		copyFile({
-			sourceDir: 'src/assets',
-			targetDir: 'dist/assets'
-		}),
-		injectIco({
-			base: '/assets'
-		})
-	]
-})
-```
-
-### 开发自定义插件
-
-```typescript
-import { BasePlugin, createPluginFactory, Validator } from '@meng-xi/vite-plugin'
-import type { Plugin } from 'vite'
-
-interface MyPluginOptions {
-	path: string
-	enabled?: boolean
-	verbose?: boolean
-	errorStrategy?: 'throw' | 'log' | 'ignore'
-}
-
-class MyPlugin extends BasePlugin<MyPluginOptions> {
-	protected getDefaultOptions() {
-		return {
-			path: './default'
-		}
-	}
-
-	protected validateOptions(): void {
-		this.validator.field('path').required().string().validate()
-	}
-
-	protected getPluginName(): string {
-		return 'my-plugin'
-	}
-
-	protected addPluginHooks(plugin: Plugin): void {
-		plugin.buildStart = () => {
-			this.logger.info(`Plugin started with path: ${this.options.path}`)
-		}
-	}
-}
-
-export const myPlugin = createPluginFactory(MyPlugin)
-```
-
-## 更新日志
-
-[CHANGELOG](https://github.com/MengXi-Studio/vite-plugin/releases)
-
-## 如何贡献
-
-欢迎为 `@meng-xi/vite-plugin` 贡献代码。以下是贡献代码的步骤：
-
-1. Fork 项目：在 GitHub 上 Fork 此项目。
-2. 克隆代码：将 Fork 后的项目克隆到您的本地机器。
-
-```bash
-git clone https://github.com/your-username/vite-plugin.git
-cd vite-plugin
-```
-
-3. 创建新分支：基于 `master` 分支创建一个新的功能分支。
-
-```bash
-git checkout -b feature/your-feature
-```
-
-4. 提交变更：确保您的代码通过了测试，并使用清晰的提交消息提交您的变更。
-
-```bash
-git add .
-git commit -m "feat: add your feature description"
-```
-
-5. Push 变更：将您的本地分支推送到 GitHub。
-
-```bash
-git push origin feature/your-feature
-```
-
-6. 创建 PR：在 GitHub 上创建一个 Pull Request，并等待审核。
+**中文** | [English](./README-en.md)
+
+<div align="center">
+	<a href="https://github.com/MengXi-Studio/vite-plugin">
+		<img alt="梦曦工作室 Logo" width="215" src="https://github.com/MengXi-Studio/vite-plugin/blob/master/packages/docs/src/public/logo.png">
+	</a>
+	<br>
+	<h1>@meng-xi/vite-plugin</h1>
+	<p>一个为 Vite 提供实用插件的工具包，同时也是一个完整的插件开发框架</p>
+
+[![license](https://img.shields.io/github/license/MengXi-Studio/vite-plugin.svg)](LICENSE) [![npm](https://img.shields.io/npm/v/@meng-xi/vite-plugin?color=blue)](https://www.npmjs.com/package/@meng-xi/vite-plugin)
+![npm](https://img.shields.io/npm/dt/@meng-xi/vite-plugin?color=green)
+
+</div>
+
+## 特性
+
+- **开箱即用** - 提供文件复制、路由生成、版本管理、图标注入等实用插件
+- **插件开发框架** - 导出 BasePlugin、Logger、Validator 等核心组件，快速构建自定义插件
+- **完整生命周期** - 支持初始化、配置解析、销毁等生命周期管理，自动组合钩子逻辑
+- **类型安全** - 完整的 TypeScript 类型定义，配置验证器确保参数正确性
+- **灵活配置** - 所有插件支持详细配置，满足多样化场景需求
+- **安全执行** - 内置错误处理策略（throw / log / ignore），统一异常管理
+
+## 文档
+
+查看完整文档：[https://mengxi-studio.github.io/vite-plugin/](https://mengxi-studio.github.io/vite-plugin/)
+
+## 安装
+
+```bash
+# npm
+npm install @meng-xi/vite-plugin -D
+
+# yarn
+yarn add @meng-xi/vite-plugin -D
+
+# pnpm
+pnpm add @meng-xi/vite-plugin -D
+```
+
+## 快速开始
+
+### 使用内置插件
+
+```typescript
+import { defineConfig } from 'vite'
+import { copyFile, generateRouter, generateVersion, injectIco } from '@meng-xi/vite-plugin'
+
+export default defineConfig({
+	plugins: [
+		// 复制文件
+		copyFile({
+			sourceDir: 'src/assets',
+			targetDir: 'dist/assets'
+		}),
+
+		// 生成路由配置（uni-app）
+		generateRouter({
+			pagesJsonPath: 'src/pages.json',
+			outputPath: 'src/router.config.ts'
+		}),
+
+		// 生成版本号
+		generateVersion({
+			format: 'datetime',
+			outputType: 'both'
+		}),
+
+		// 注入网站图标
+		injectIco({
+			base: '/assets'
+		})
+	]
+})
+```
+
+### 访问插件实例
+
+所有内置插件返回的对象包含 `pluginInstance` 属性，可访问插件内部状态：
+
+```typescript
+import type { PluginWithInstance } from '@meng-xi/vite-plugin/factory'
+import type { GenerateRouterOptions } from '@meng-xi/vite-plugin'
+
+const routerPlugin = generateRouter({ watch: true }) as PluginWithInstance<GenerateRouterOptions>
+
+// 通过 pluginInstance 访问插件内部
+console.log(routerPlugin.pluginInstance?.options)
+```
+
+### 开发自定义插件
+
+```typescript
+import { BasePlugin, createPluginFactory } from '@meng-xi/vite-plugin'
+import type { BasePluginOptions, PluginWithInstance } from '@meng-xi/vite-plugin/factory'
+import type { Plugin } from 'vite'
+
+interface MyPluginOptions extends BasePluginOptions {
+	path: string
+}
+
+class MyPlugin extends BasePlugin<MyPluginOptions> {
+	protected getDefaultOptions() {
+		return { path: './default' }
+	}
+
+	protected validateOptions(): void {
+		this.validator.field('path').required().string().validate()
+	}
+
+	protected getPluginName(): string {
+		return 'my-plugin'
+	}
+
+	protected addPluginHooks(plugin: Plugin): void {
+		plugin.buildStart = () => {
+			this.logger.info(`Plugin started with path: ${this.options.path}`)
+		}
+	}
+
+	protected destroy(): void {
+		super.destroy()
+		// 自定义清理逻辑，如关闭连接、停止监听等
+	}
+}
+
+export const myPlugin = createPluginFactory(MyPlugin)
+```
+
+## 插件开发框架
+
+### BasePlugin 核心概念
+
+`BasePlugin` 是所有插件的基类，提供了完整的生命周期管理和开发规范：
+
+#### 生命周期
+
+| 阶段     | 方法               | 说明                                   |
+| -------- | ------------------ | -------------------------------------- |
+| 初始化   | `constructor`      | 合并配置、初始化日志和验证器           |
+| 配置解析 | `onConfigResolved` | Vite 配置解析完成时调用                |
+| 钩子注册 | `addPluginHooks`   | 注册 Vite 插件钩子                     |
+| 销毁     | `destroy`          | `closeBundle` 时自动调用，用于清理资源 |
+
+#### 钩子自动组合
+
+`toPlugin()` 方法会自动组合以下钩子：
+
+- **configResolved** - 先执行基类的 `onConfigResolved`，再执行子类注册的钩子
+- **closeBundle** - 先执行子类注册的钩子，再执行基类的 `destroy`
+
+> 子类无需手动注册 `closeBundle` 钩子来清理资源，只需重写 `destroy()` 方法即可。
+
+#### 必须实现的方法
+
+| 方法                     | 说明               |
+| ------------------------ | ------------------ |
+| `getPluginName()`        | 返回插件名称       |
+| `addPluginHooks(plugin)` | 添加 Vite 插件钩子 |
+
+#### 可选重写的方法
+
+| 方法                       | 默认行为    | 说明                               |
+| -------------------------- | ----------- | ---------------------------------- |
+| `getDefaultOptions()`      | 返回 `{}`   | 提供插件默认配置                   |
+| `validateOptions()`        | 无验证      | 验证配置参数                       |
+| `getEnforce()`             | `undefined` | 插件执行时机（`'pre'` / `'post'`） |
+| `onConfigResolved(config)` | 存储配置    | 配置解析完成回调                   |
+| `destroy()`                | 注销日志    | 插件销毁时的清理逻辑               |
+
+#### 内置属性
+
+| 属性         | 类型                     | 说明              |
+| ------------ | ------------------------ | ----------------- |
+| `options`    | `Required<T>`            | 合并后的完整配置  |
+| `logger`     | `PluginLogger`           | 插件日志记录器    |
+| `validator`  | `Validator<T>`           | 配置验证器        |
+| `viteConfig` | `ResolvedConfig \| null` | Vite 解析后的配置 |
+
+#### 错误处理策略
+
+通过 `errorStrategy` 配置项控制错误行为：
+
+- `'throw'`（默认）- 记录错误并抛出异常，中断构建
+- `'log'` - 记录错误但不抛出，继续执行
+- `'ignore'` - 记录错误但不抛出，继续执行
+
+使用 `safeExecute` / `safeExecuteSync` 包裹可能出错的操作：
+
+```typescript
+const result = await this.safeExecute(async () => {
+	return await someAsyncOperation()
+}, '执行异步操作')
+```
+
+### createPluginFactory
+
+创建插件工厂函数，支持选项标准化：
+
+```typescript
+// 基本使用
+const myPlugin = createPluginFactory(MyPlugin)
+
+// 带标准化器（支持字符串简写配置）
+const myPlugin = createPluginFactory(MyPlugin, opt => (typeof opt === 'string' ? { path: opt } : opt))
+
+// 使用时支持简写
+myPlugin('./custom-path')
+```
+
+### Logger
+
+全局单例日志管理器，为每个插件提供独立的日志控制：
+
+```typescript
+import { Logger } from '@meng-xi/vite-plugin/logger'
+
+// 创建日志记录器（通常由 BasePlugin 自动调用）
+Logger.create({ name: 'my-plugin', enabled: true })
+
+// 注销插件日志配置（插件销毁时自动调用）
+Logger.unregister('my-plugin')
+
+// 销毁单例（测试场景使用）
+Logger.destroy()
+```
+
+日志输出格式：
+
+```
+ℹ️ [@meng-xi/vite-plugin:my-plugin] Info message
+✅ [@meng-xi/vite-plugin:my-plugin] Success message
+⚠️ [@meng-xi/vite-plugin:my-plugin] Warning message
+❌ [@meng-xi/vite-plugin:my-plugin] Error message
+```
+
+## 内置插件
+
+### copyFile
+
+在 Vite 构建完成后复制文件或目录到指定位置。
+
+| 选项        | 类型    | 默认值 | 描述                 |
+| ----------- | ------- | ------ | -------------------- |
+| sourceDir   | string  | -      | 源目录路径（必填）   |
+| targetDir   | string  | -      | 目标目录路径（必填） |
+| overwrite   | boolean | true   | 是否覆盖现有文件     |
+| recursive   | boolean | true   | 是否递归复制子目录   |
+| incremental | boolean | true   | 是否启用增量复制     |
+
+### generateRouter
+
+根据 uni-app 项目的 `pages.json` 自动生成路由配置文件。
+
+| 选项                 | 类型                                              | 默认值                 | 描述                          |
+| -------------------- | ------------------------------------------------- | ---------------------- | ----------------------------- |
+| pagesJsonPath        | string                                            | 'src/pages.json'       | pages.json 文件路径           |
+| outputPath           | string                                            | 'src/router.config.ts' | 输出文件路径                  |
+| outputFormat         | 'ts' \| 'js'                                      | 'ts'                   | 输出文件格式                  |
+| nameStrategy         | 'path' \| 'camelCase' \| 'pascalCase' \| 'custom' | 'camelCase'            | 路由名称策略                  |
+| customNameGenerator  | (path: string) => string                          | -                      | 自定义路由名称生成函数        |
+| includeSubPackages   | boolean                                           | true                   | 是否包含子包路由              |
+| watch                | boolean                                           | true                   | 是否监听变化自动重新生成      |
+| metaMapping          | Record\<string, string\>                          | -                      | 页面 style 字段到 meta 的映射 |
+| exportTypes          | boolean                                           | true                   | 是否导出类型定义              |
+| preserveRouteChanges | boolean                                           | true                   | 是否保留用户对 routes 的修改  |
+
+### generateVersion
+
+在 Vite 构建过程中自动生成版本号。
+
+| 选项         | 类型                                                                  | 默认值            | 描述                     |
+| ------------ | --------------------------------------------------------------------- | ----------------- | ------------------------ |
+| format       | 'timestamp' \| 'date' \| 'datetime' \| 'semver' \| 'hash' \| 'custom' | 'timestamp'       | 版本号格式               |
+| customFormat | string                                                                | -                 | 自定义格式模板           |
+| semverBase   | string                                                                | '1.0.0'           | 语义化版本基础值         |
+| outputType   | 'file' \| 'define' \| 'both'                                          | 'file'            | 输出类型                 |
+| outputFile   | string                                                                | 'version.json'    | 输出文件路径             |
+| defineName   | string                                                                | '**APP_VERSION**' | 注入的全局变量名         |
+| hashLength   | number                                                                | 8                 | 哈希长度（1-32）         |
+| prefix       | string                                                                | -                 | 版本号前缀               |
+| suffix       | string                                                                | -                 | 版本号后缀               |
+| extra        | Record\<string, unknown\>                                             | -                 | 附加信息（仅 JSON 文件） |
+
+### injectIco
+
+在 Vite 构建过程中将网站图标链接注入到 HTML 文件的 head 中。
+
+| 选项        | 类型   | 默认值 | 描述                        |
+| ----------- | ------ | ------ | --------------------------- |
+| base        | string | '/'    | 图标文件的基础路径          |
+| url         | string | -      | 图标的完整 URL              |
+| link        | string | -      | 自定义完整的 link 标签 HTML |
+| icons       | Icon[] | -      | 自定义图标数组              |
+| copyOptions | object | -      | 图标文件复制配置            |
+
+`Icon` 接口定义：
+
+| 属性  | 类型   | 必填 | 描述           |
+| ----- | ------ | ---- | -------------- |
+| rel   | string | 是   | 图标关系类型   |
+| href  | string | 是   | 图标 URL       |
+| sizes | string | 否   | 图标尺寸       |
+| type  | string | 否   | 图标 MIME 类型 |
+
+## 子路径导出
+
+支持按需导入模块，减少打包体积：
+
+```typescript
+// 完整导入
+import { copyFile, BasePlugin, Logger } from '@meng-xi/vite-plugin'
+
+// 按模块导入
+import { BasePlugin, createPluginFactory } from '@meng-xi/vite-plugin/factory'
+import { Logger } from '@meng-xi/vite-plugin/logger'
+import { copyFile, generateRouter } from '@meng-xi/vite-plugin/plugins'
+import { Validator, readFileContent, writeFileContent } from '@meng-xi/vite-plugin/common'
+
+// 类型导入（从子路径按需导入类型定义）
+import type { PluginWithInstance, PluginFactory, BasePluginOptions } from '@meng-xi/vite-plugin/factory'
+import type { GenerateVersionOptions, InjectIcoOptions, Icon } from '@meng-xi/vite-plugin/plugins'
+import type { DateFormatOptions } from '@meng-xi/vite-plugin/common'
+```
+
+## 更新日志
+
+查看 [GitHub Releases](https://github.com/MengXi-Studio/vite-plugin/releases)
+
+## 贡献指南
+
+欢迎贡献代码！请按以下步骤操作：
+
+1. Fork 本项目
+2. 创建功能分支：`git checkout -b feature/your-feature`
+3. 提交变更：`git commit -m "feat: your feature description"`
+4. 推送分支：`git push origin feature/your-feature`
+5. 创建 Pull Request
+
+## License
+
+[MIT](LICENSE)

package/dist/common/index.cjs

@@ -1 +1 @@
-"use strict";const format=require("../shared/vite-plugin.D6NYITpX.cjs"),validation=require("../shared/vite-plugin.IGZeStMa.cjs");require("fs"),require("path"),require("crypto"),exports.checkSourceExists=format.checkSourceExists,exports.copySourceToTarget=format.copySourceToTarget,exports.ensureTargetDir=format.ensureTargetDir,exports.formatDate=format.formatDate,exports.generateRandomHash=format.generateRandomHash,exports.getDateFormatParams=format.getDateFormatParams,exports.padNumber=format.padNumber,exports.parseTemplate=format.parseTemplate,exports.readDirRecursive=format.readDirRecursive,exports.readFileSync=format.readFileSync,exports.shouldUpdateFile=format.shouldUpdateFile,exports.writeFileContent=format.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge;
+"use strict";const format=require("../shared/vite-plugin.Ba9646wL.cjs"),validation=require("../shared/vite-plugin.IGZeStMa.cjs");require("fs"),require("path"),require("crypto"),exports.checkSourceExists=format.checkSourceExists,exports.copySourceToTarget=format.copySourceToTarget,exports.ensureTargetDir=format.ensureTargetDir,exports.fileExists=format.fileExists,exports.formatDate=format.formatDate,exports.generateRandomHash=format.generateRandomHash,exports.getDateFormatParams=format.getDateFormatParams,exports.padNumber=format.padNumber,exports.parseTemplate=format.parseTemplate,exports.readDirRecursive=format.readDirRecursive,exports.readFileContent=format.readFileContent,exports.readFileSync=format.readFileSync,exports.runWithConcurrency=format.runWithConcurrency,exports.shouldUpdateFile=format.shouldUpdateFile,exports.stripJsonComments=format.stripJsonComments,exports.toCamelCase=format.toCamelCase,exports.toPascalCase=format.toPascalCase,exports.writeFileContent=format.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge;

package/dist/common/index.d.cts

@@ -84,6 +84,38 @@ declare function readDirRecursive(dirPath: string, recursive: boolean): Promise<
  * @returns 是否需要更新
  */
 declare function shouldUpdateFile(sourceFile: string, targetFile: string): Promise<boolean>;
+/**
+ * 检查文件是否存在
+ * @param filePath 文件路径
+ * @returns 是否存在
+ *
+ * @example
+ * ```typescript
+ * if (await fileExists('/path/to/file')) {
+ *   console.log('文件存在')
+ * }
+ * ```
+ */
+declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * 带并发限制的批量执行
+ *
+ * @param items 待处理项
+ * @param handler 处理函数
+ * @param concurrency 并发数
+ * @returns 处理结果数组，顺序与输入项对应
+ *
+ * @example
+ * ```typescript
+ * const urls = ['url1', 'url2', 'url3', 'url4', 'url5']
+ * const results = await runWithConcurrency(
+ *   urls,
+ *   async (url) => fetch(url),
+ *   3 // 最多同时处理3个请求
+ * )
+ * ```
+ */
+declare function runWithConcurrency<T, R>(items: T[], handler: (item: T) => Promise<R>, concurrency: number): Promise<R[]>;
 /**
  * 执行文件复制操作（优化版：并行IO）
  * @param sourcePath 源文件或目录路径
@@ -100,11 +132,19 @@ declare function copySourceToTarget(sourcePath: string, targetPath: string, opti
  * @throws 当写入过程中出现错误时抛出异常
  */
 declare function writeFileContent(filePath: string, content: string): Promise<void>;
+/**
+ * 读取文件内容
+ * @param filePath 文件路径
+ * @returns 文件内容字符串
+ * @throws 当读取过程中出现错误时抛出异常
+ */
+declare function readFileContent(filePath: string): Promise<string>;
 /**
  * 同步读取文件内容
  * @param filePath 文件路径
  * @returns 文件内容字符串
  * @throws 当读取过程中出现错误时抛出异常
+ * @deprecated 请使用异步版本 readFileContent
  */
 declare function readFileSync(filePath: string): string;
 
@@ -201,6 +241,49 @@ declare function formatDate(date: Date, format: string): string;
  * ```
  */
 declare function parseTemplate(template: string, values: Record<string, string>): string;
+/**
+ * 将字符串转换为驼峰命名（camelCase）
+ *
+ * @param str 输入字符串
+ * @param separators 分隔符正则，默认为斜杠和横线
+ * @returns 驼峰命名字符串
+ *
+ * @example
+ * ```typescript
+ * toCamelCase('pages/user/profile')  // 'pagesUserProfile'
+ * toCamelCase('user-profile-page')   // 'userProfilePage'
+ * toCamelCase('/pages/index')        // 'pagesIndex'
+ * ```
+ */
+declare function toCamelCase(str: string, separators?: RegExp): string;
+/**
+ * 将字符串转换为帕斯卡命名（PascalCase）
+ *
+ * @param str 输入字符串
+ * @param separators 分隔符正则，默认为斜杠和横线
+ * @returns 帕斯卡命名字符串
+ *
+ * @example
+ * ```typescript
+ * toPascalCase('pages/user/profile')  // 'PagesUserProfile'
+ * toPascalCase('user-profile-page')   // 'UserProfilePage'
+ * toPascalCase('/pages/index')        // 'PagesIndex'
+ * ```
+ */
+declare function toPascalCase(str: string, separators?: RegExp): string;
+/**
+ * 移除 JSON 字符串中的注释
+ *
+ * @param jsonString 包含注释的 JSON 字符串
+ * @returns 移除注释后的 JSON 字符串
+ *
+ * @example
+ * ```typescript
+ * stripJsonComments('{\n  // comment\n  "name": "test"\n}')
+ * // '{\n  "name": "test"\n}'
+ * ```
+ */
+declare function stripJsonComments(jsonString: string): string;
 
 /**
  * 深度合并对象
@@ -231,5 +314,5 @@ declare function parseTemplate(template: string, values: Record<string, string>)
  */
 declare function deepMerge<T extends Record<string, any>>(...sources: Partial<T>[]): T;
 
-export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileSync, shouldUpdateFile, writeFileContent };
+export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent };
 export type { DateFormatOptions };