unplugin-auto-git-log 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2025-PRESENT Drswith (https://github.com/Drswith)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,285 @@
+# unplugin-auto-git-log
+
+[![Unit Test][unit-test-src]][unit-test-href]
+
+Unplugin for automatically generating Git information (repo, branch, commit, etc.) in multiple output formats.
+
+## Features
+
+- 📦 Automatically extract Git repository information
+- 🎯 Support multiple output formats:
+  - JSON file
+  - Window global variable
+  - Environment variables (.env)
+  - TypeScript type definitions
+- 🔧 Works with all major build tools (Vite, Webpack, Rollup, esbuild, Rspack, etc.)
+- ⚙️ Configurable fields and output options
+
+## Installation
+
+```bash
+npm i -D unplugin-auto-git-log
+```
+
+## Usage
+
+<details>
+<summary>Vite</summary><br>
+
+```ts
+// vite.config.ts
+import AutoGitLog from 'unplugin-auto-git-log/vite'
+
+export default defineConfig({
+  plugins: [AutoGitLog()],
+})
+```
+
+<br></details>
+
+<details>
+<summary>Rollup</summary><br>
+
+```ts
+// rollup.config.js
+import AutoGitLog from 'unplugin-auto-git-log/rollup'
+
+export default {
+  plugins: [AutoGitLog()],
+}
+```
+
+<br></details>
+
+<details>
+<summary>Rolldown / tsdown</summary><br>
+
+```ts
+// rolldown.config.ts / tsdown.config.ts
+import AutoGitLog from 'unplugin-auto-git-log/rolldown'
+
+export default {
+  plugins: [AutoGitLog()],
+}
+```
+
+<br></details>
+
+<details>
+<summary>esbuild</summary><br>
+
+```ts
+import { build } from 'esbuild'
+import AutoGitLog from 'unplugin-auto-git-log/esbuild'
+
+build({
+  plugins: [AutoGitLog()],
+})
+```
+
+<br></details>
+
+<details>
+<summary>Webpack</summary><br>
+
+```js
+// webpack.config.js
+import AutoGitLog from 'unplugin-auto-git-log/webpack'
+
+export default {
+  /* ... */
+  plugins: [AutoGitLog()],
+}
+```
+
+<br></details>
+
+<details>
+<summary>Rspack</summary><br>
+
+```ts
+// rspack.config.js
+import AutoGitLog from 'unplugin-auto-git-log/rspack'
+
+export default {
+  /* ... */
+  plugins: [AutoGitLog()],
+}
+```
+
+<br></details>
+
+## Configuration
+
+### Default Behavior
+
+By default, the plugin will:
+
+- **Be enabled** (`enable: true`)
+- Extract all available Git fields (repo, branch, commit, commitShort, author, authorEmail, commitTime, commitMessage, isDirty)
+- Generate a JSON file at your build output directory (e.g., `dist/git-log.json` for Vite)
+- Automatically detect the output directory from your build tool configuration
+- Run after build (`enforce: 'post'`)
+
+You can use the plugin without any configuration:
+
+```ts
+// vite.config.ts
+import AutoGitLog from 'unplugin-auto-git-log/vite'
+
+export default defineConfig({
+  plugins: [AutoGitLog()], // That's it!
+})
+```
+
+### Advanced Configuration
+
+```ts
+AutoGitLog({
+  // Enable/disable the plugin (default: true)
+  enable: true,
+
+  // Git fields to include (default: all)
+  fields: ['repo', 'branch', 'commit', 'commitShort', 'author', 'authorEmail', 'commitTime', 'commitMessage', 'isDirty'],
+
+  // Output options
+  outputs: {
+    // Generate JSON file (default: 'git-log.json' in output directory)
+    json: {
+      fileName: 'git-log.json', // Relative to build output directory
+    },
+
+    // Generate window global variable file (default: '__GIT_LOG__')
+    window: {
+      varName: '__GIT_LOG__',
+      console: true, // Log Git log to browser console
+    },
+
+    // Generate environment variables file (default: '.env.git')
+    env: {
+      prefix: '__GIT_',
+      file: '.env.git',
+    },
+
+    // Generate TypeScript type definitions (default: 'git-log.d.ts' in output directory)
+    types: {
+      fileName: 'git-log.d.ts', // Relative to build output directory
+    },
+  },
+
+  // Working directory (optional, defaults to process.cwd())
+  // cwd: './custom-path',
+
+  // Plugin execution timing
+  enforce: 'post', // 'pre' | 'post'
+})
+```
+
+### Disable the Plugin
+
+You can conditionally disable the plugin based on environment:
+
+```ts
+import AutoGitLog from 'unplugin-auto-git-log/vite'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    AutoGitLog({
+      enable: process.env.NODE_ENV === 'production', // Only enable in production
+    }),
+  ],
+})
+```
+
+Or completely disable it:
+
+```ts
+AutoGitLog({
+  enable: false, // Plugin will not generate any files
+})
+```
+
+## Git Fields
+
+The following Git information can be extracted:
+
+- `repo` - Repository URL
+- `branch` - Current branch name
+- `commit` - Full commit hash
+- `commitShort` - Short commit hash (7 characters)
+- `author` - Author name
+- `authorEmail` - Author email
+- `commitTime` - Commit timestamp
+- `commitMessage` - Commit message
+- `isDirty` - Whether the working directory has uncommitted changes
+
+## Output Examples
+
+### JSON Output
+
+By default, the JSON file is generated at your build output directory (e.g., `dist/git-log.json`):
+
+```json
+{
+  "repo": "https://github.com/user/repo.git",
+  "branch": "main",
+  "commit": "abc123def456...",
+  "commitShort": "abc123d",
+  "author": "John Doe",
+  "authorEmail": "john@example.com",
+  "commitTime": "2025-01-08T12:00:00.000Z",
+  "commitMessage": "feat: add new feature",
+  "isDirty": false
+}
+```
+
+### Window Variable Output
+
+When window output is enabled, the plugin will:
+
+1. Generate a JavaScript file (e.g., `dist/__GIT_LOG__.js`)
+2. Automatically inject a `<script>` tag into your HTML (Vite only)
+3. Optionally log Git log to browser console (with `console: true`)
+
+You can then access the Git log anywhere in your code:
+
+```typescript
+// In your browser code
+console.log(window.__GIT_LOG__)
+console.log(window.__GIT_LOG__.branch)
+console.log(window.__GIT_LOG__.commit)
+```
+
+The generated file (`__GIT_LOG__.js`) contains:
+
+```js
+;(function () {
+  if (typeof window !== 'undefined') {
+    window.__GIT_LOG__ = { /* git log */ }
+  }
+})()
+```
+
+### Environment Variables (`.env.git`)
+
+```bash
+__GIT_REPO=https://github.com/user/repo.git
+__GIT_BRANCH=main
+__GIT_COMMIT=abc123def456...
+__GIT_COMMIT_SHORT=abc123d
+__GIT_AUTHOR=John Doe
+__GIT_AUTHOR_EMAIL=john@example.com
+__GIT_COMMIT_TIME=2025-01-08T12:00:00.000Z
+__GIT_COMMIT_MESSAGE=feat: add new feature
+__GIT_IS_DIRTY=false
+```
+
+## License
+
+[MIT](./LICENSE) License © 2025-PRESENT [Drswith](https://github.com/Drswith)
+
+<!-- Badges -->
+
+[unit-test-src]: https://github.com/Drswith/unplugin-auto-git-log/actions/workflows/unit-test.yml/badge.svg
+[unit-test-href]: https://github.com/Drswith/unplugin-auto-git-log/actions/workflows/unit-test.yml

package/dist/api.d.mts

@@ -0,0 +1,2 @@
+import { a as OutputOptions, c as generateEnvVars, d as generateTypeDefinitions, f as generateWindowVar, g as getGitLog, h as getAvailableFields, i as JsonOutputOptions, l as generateJson, m as GitLog, n as OptionsResolved, o as TypesOutputOptions, p as GitField, r as EnvOutputOptions, s as WindowOutputOptions, t as Options, u as generateOutputs } from "./options-B7zpW-6U.mjs";
+export { type EnvOutputOptions, type GitField, type GitLog, type JsonOutputOptions, type Options, type OptionsResolved, type OutputOptions, type TypesOutputOptions, type WindowOutputOptions, generateEnvVars, generateJson, generateOutputs, generateTypeDefinitions, generateWindowVar, getAvailableFields, getGitLog };

package/dist/api.mjs

@@ -0,0 +1,3 @@
+import { a as generateWindowVar, i as generateTypeDefinitions, n as generateJson, o as getAvailableFields, r as generateOutputs, s as getGitLog, t as generateEnvVars } from "./outputs-CbT7SkvQ.mjs";
+
+export { generateEnvVars, generateJson, generateOutputs, generateTypeDefinitions, generateWindowVar, getAvailableFields, getGitLog };

package/dist/cli.d.mts

@@ -0,0 +1,7 @@
+//#region src/cli.d.ts
+/**
+* CLI 主函数
+*/
+declare function runCLI(): void;
+//#endregion
+export { runCLI };

package/dist/cli.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import { r as generateOutputs, s as getGitLog } from "./outputs-CbT7SkvQ.mjs";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import process from "node:process";
+
+//#region src/cli.ts
+/**
+* 解析命令行参数
+*/
+function parseArgs() {
+	const args = process.argv.slice(2);
+	const options = {};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		const nextArg = args[i + 1];
+		switch (arg) {
+			case "--fields":
+			case "-f":
+				if (nextArg) {
+					options.fields = nextArg.split(",").map((f) => f.trim());
+					i++;
+				}
+				break;
+			case "--cwd":
+			case "-C":
+				if (nextArg) {
+					options.cwd = nextArg;
+					i++;
+				}
+				break;
+			case "--config":
+			case "-c":
+				if (nextArg) {
+					try {
+						const configContent = readFileSync(resolve(nextArg), "utf8");
+						const config = JSON.parse(configContent);
+						Object.assign(options, config);
+					} catch (error) {
+						console.error(`无法读取配置文件: ${nextArg}`, error);
+						process.exit(1);
+					}
+					i++;
+				}
+				break;
+			case "--help":
+			case "-h":
+				console.log(`
+用法: unplugin-auto-git-log [选项]
+
+选项:
+  -f, --fields <fields>      Git 字段列表，用逗号分隔 (例如: repo,branch,commit)
+  -C, --cwd <path>           工作目录路径
+  -c, --config <path>        配置文件路径 (JSON 格式)
+  -h, --help                  显示帮助信息
+
+示例:
+  unplugin-auto-git-log --fields repo,branch,commit
+  unplugin-auto-git-log --config ./git-log.config.json
+  unplugin-auto-git-log --cwd ./src --fields repo,branch
+        `);
+				process.exit(0);
+				break;
+			default:
+				if (arg.startsWith("-")) console.warn(`未知选项: ${arg}`);
+				break;
+		}
+	}
+	return options;
+}
+/**
+* CLI 主函数
+*/
+function runCLI() {
+	const args = parseArgs();
+	const options = {
+		fields: args.fields || [
+			"repo",
+			"branch",
+			"commit",
+			"commitShort",
+			"author",
+			"authorEmail",
+			"commitTime",
+			"commitMessage",
+			"isDirty"
+		],
+		outputs: args.outputs || { json: { fileName: "git-log.json" } },
+		cwd: args.cwd
+	};
+	try {
+		const gitLog = getGitLog(options.fields, options.cwd);
+		if (Object.keys(gitLog).length === 0) {
+			console.warn("警告: 未检测到 Git 仓库或无法获取 Git 日志");
+			process.exit(0);
+		}
+		if (options.outputs) {
+			generateOutputs(gitLog, options.outputs, options.cwd);
+			console.log("✓ Git 日志已生成");
+		} else console.log(JSON.stringify(gitLog, null, 2));
+	} catch (error) {
+		console.error("错误:", error);
+		process.exit(1);
+	}
+}
+if (import.meta.url !== void 0 && (import.meta.url.endsWith(process.argv[1]) || process.argv[1]?.includes("cli"))) runCLI();
+
+//#endregion
+export { runCLI };

package/dist/esbuild.d.mts

@@ -0,0 +1,19 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/esbuild.d.ts
+
+/**
+* Esbuild plugin
+*
+* @example
+* ```ts
+* import { build } from 'esbuild'
+* import AutoGitLog from 'unplugin-auto-git-log/esbuild'
+*
+* build({ plugins: [AutoGitLog()] })
+```
+*/
+declare const esbuild: typeof AutoGitLog.esbuild;
+//#endregion
+export { esbuild as default, esbuild as "module.exports" };

package/dist/esbuild.mjs

@@ -0,0 +1,24 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/esbuild.ts
+/**
+* This entry file is for esbuild plugin.
+*
+* @module
+*/
+/**
+* Esbuild plugin
+*
+* @example
+* ```ts
+* import { build } from 'esbuild'
+* import AutoGitLog from 'unplugin-auto-git-log/esbuild'
+*
+* build({ plugins: [AutoGitLog()] })
+```
+*/
+const esbuild = AutoGitLog.esbuild;
+var esbuild_default = esbuild;
+
+//#endregion
+export { esbuild_default as default, esbuild as "module.exports" };

package/dist/farm.d.mts

@@ -0,0 +1,21 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/farm.d.ts
+
+/**
+* Farm plugin
+*
+* @example
+* ```ts
+* // farm.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/farm'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+declare const farm: typeof AutoGitLog.farm;
+//#endregion
+export { farm as default, farm as "module.exports" };

package/dist/farm.mjs

@@ -0,0 +1,26 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/farm.ts
+/**
+* This entry file is for Farm plugin.
+*
+* @module
+*/
+/**
+* Farm plugin
+*
+* @example
+* ```ts
+* // farm.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/farm'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+const farm = AutoGitLog.farm;
+var farm_default = farm;
+
+//#endregion
+export { farm_default as default, farm as "module.exports" };

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { t as Options } from "./options-B7zpW-6U.mjs";
+import { UnpluginInstance } from "unplugin";
+
+//#region src/index.d.ts
+declare const AutoGitLog: UnpluginInstance<Options | undefined, false>;
+//#endregion
+export { AutoGitLog };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+export { AutoGitLog };

package/dist/options-B7zpW-6U.d.mts

@@ -0,0 +1,72 @@
+import { FilterPattern } from "unplugin";
+
+//#region src/core/git.d.ts
+type GitField = "repo" | "branch" | "commit" | "commitShort" | "author" | "authorEmail" | "commitTime" | "commitMessage" | "tag" | "isDirty" | "remoteUrl" | "root";
+type GitLog = Record<string, string | boolean>;
+/**
+* 获取 Git 日志
+*/
+declare function getGitLog(fields?: string[], cwd?: string): GitLog;
+/**
+* 获取所有可用的 Git 字段
+*/
+declare function getAvailableFields(): GitField[];
+//#endregion
+//#region src/core/outputs.d.ts
+interface JsonOutputOptions {
+  fileName?: string;
+}
+interface WindowOutputOptions {
+  varName?: string;
+  console?: boolean;
+}
+interface EnvOutputOptions {
+  prefix?: string;
+  file?: string;
+}
+interface TypesOutputOptions {
+  fileName?: string;
+}
+interface OutputOptions {
+  json?: JsonOutputOptions;
+  window?: WindowOutputOptions;
+  env?: EnvOutputOptions;
+  types?: TypesOutputOptions;
+}
+/**
+* 生成 JSON 文件
+*/
+declare function generateJson(gitLog: GitLog, options?: JsonOutputOptions, outputDir?: string): void;
+/**
+* 生成 window 全局变量文件
+*/
+declare function generateWindowVar(gitLog: GitLog, options?: WindowOutputOptions, outputDir?: string): string;
+/**
+* 生成环境变量文件
+*/
+declare function generateEnvVars(gitLog: GitLog, options?: EnvOutputOptions, outputDir?: string): void;
+/**
+* 生成 TypeScript 类型定义文件
+*/
+declare function generateTypeDefinitions(gitLog: GitLog, options?: TypesOutputOptions, outputDir?: string): void;
+/**
+* 根据配置生成所有输出
+*/
+declare function generateOutputs(gitLog: GitLog, outputOptions: OutputOptions, outputDir?: string): string | undefined;
+//#endregion
+//#region src/core/options.d.ts
+interface Options {
+  include?: FilterPattern;
+  exclude?: FilterPattern;
+  enforce?: "pre" | "post" | undefined;
+  enable?: boolean;
+  fields?: GitField[] | string[];
+  outputs?: OutputOptions;
+  cwd?: string;
+}
+type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
+type OptionsResolved = Overwrite<Required<Pick<Options, "include" | "exclude">>, Omit<Pick<Options, "enforce" | "enable" | "fields" | "outputs" | "cwd">, "outputs"> & {
+  outputs: OutputOptions;
+}>;
+//#endregion
+export { OutputOptions as a, generateEnvVars as c, generateTypeDefinitions as d, generateWindowVar as f, getGitLog as g, getAvailableFields as h, JsonOutputOptions as i, generateJson as l, GitLog as m, OptionsResolved as n, TypesOutputOptions as o, GitField as p, EnvOutputOptions as r, WindowOutputOptions as s, Options as t, generateOutputs as u };

package/dist/outputs-CbT7SkvQ.mjs

@@ -0,0 +1,209 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, resolve } from "node:path";
+
+//#region src/core/git.ts
+/**
+* 检查当前目录是否是 Git 仓库
+*/
+function isGitRepository(cwd) {
+	try {
+		return existsSync(cwd ? resolve(cwd, ".git") : ".git") || execSync("git rev-parse --git-dir", {
+			cwd,
+			encoding: "utf8",
+			stdio: "pipe"
+		}).trim() !== "";
+	} catch {
+		return false;
+	}
+}
+/**
+* 安全执行 Git 命令
+*/
+function execGitCommand(command, cwd) {
+	try {
+		return execSync(command, {
+			cwd,
+			encoding: "utf8",
+			stdio: "pipe"
+		}).trim();
+	} catch {
+		return "";
+	}
+}
+/**
+* 获取 Git 仓库根目录
+*/
+function getGitRoot(cwd) {
+	return execGitCommand("git rev-parse --show-toplevel", cwd);
+}
+/**
+* 获取 Git 日志
+*/
+function getGitLog(fields = [], cwd) {
+	const result = {};
+	if (!isGitRepository(cwd)) return result;
+	const gitRoot = getGitRoot(cwd);
+	for (const field of fields) switch (field) {
+		case "repo": {
+			const remoteUrl = execGitCommand("git config --get remote.origin.url", cwd);
+			if (remoteUrl) {
+				const match = remoteUrl.match(/(?:git@|https?:\/\/)(?:.*\/)?([^/]+?)(?:\.git)?$/);
+				result.repo = match ? match[1] : remoteUrl;
+			} else result.repo = gitRoot ? basename(gitRoot) : "";
+			break;
+		}
+		case "branch":
+			result.branch = execGitCommand("git rev-parse --abbrev-ref HEAD", cwd) || "";
+			break;
+		case "commit":
+			result.commit = execGitCommand("git rev-parse HEAD", cwd) || "";
+			break;
+		case "commitShort":
+			result.commitShort = execGitCommand("git rev-parse --short HEAD", cwd) || "";
+			break;
+		case "author":
+			result.author = execGitCommand("git log -1 --pretty=format:\"%an\"", cwd) || "";
+			break;
+		case "authorEmail":
+			result.authorEmail = execGitCommand("git log -1 --pretty=format:\"%ae\"", cwd) || "";
+			break;
+		case "commitTime":
+			result.commitTime = execGitCommand("git log -1 --pretty=format:\"%ci\"", cwd) || "";
+			break;
+		case "commitMessage":
+			result.commitMessage = execGitCommand("git log -1 --pretty=format:\"%s\"", cwd) || "";
+			break;
+		case "tag":
+			result.tag = execGitCommand("git describe --tags --exact-match HEAD 2>/dev/null", cwd) || "";
+			break;
+		case "isDirty":
+			result.isDirty = execGitCommand("git status --porcelain", cwd).length > 0;
+			break;
+		case "remoteUrl":
+			result.remoteUrl = execGitCommand("git config --get remote.origin.url", cwd) || "";
+			break;
+		case "root":
+			result.root = gitRoot || "";
+			break;
+		default:
+			if (field.startsWith("custom:")) result[field] = execGitCommand(field.replace(/^custom:/, ""), cwd) || "";
+			break;
+	}
+	return result;
+}
+/**
+* 获取所有可用的 Git 字段
+*/
+function getAvailableFields() {
+	return [
+		"repo",
+		"branch",
+		"commit",
+		"commitShort",
+		"author",
+		"authorEmail",
+		"commitTime",
+		"commitMessage",
+		"tag",
+		"isDirty",
+		"remoteUrl",
+		"root"
+	];
+}
+
+//#endregion
+//#region src/core/outputs.ts
+/**
+* 生成 JSON 文件内容
+*/
+function generateJsonContent(gitLog) {
+	return JSON.stringify(gitLog, null, 2);
+}
+/**
+* 生成 JSON 文件
+*/
+function generateJson(gitLog, options = {}, outputDir) {
+	const fileName = options.fileName || "git-log.json";
+	const fullPath = outputDir && !isAbsolute(fileName) ? resolve(outputDir, fileName) : fileName;
+	mkdirSync(dirname(fullPath), { recursive: true });
+	writeFileSync(fullPath, generateJsonContent(gitLog), "utf8");
+}
+/**
+* 生成 window 全局变量代码
+*/
+function generateWindowVarContent(gitLog, options = {}) {
+	const varName = options.varName || "__GIT_LOG__";
+	return `(function() {
+  if (typeof window !== 'undefined') {
+    window.${varName} = ${JSON.stringify(gitLog, null, 2)};
+    ${options.console ? `console.log('[Git Log]', window.${varName});` : ""}
+  }
+})();`;
+}
+/**
+* 生成 window 全局变量文件
+*/
+function generateWindowVar(gitLog, options = {}, outputDir) {
+	const fileName = `${options.varName || "__GIT_LOG__"}.js`;
+	const fullPath = outputDir ? resolve(outputDir, fileName) : fileName;
+	mkdirSync(dirname(fullPath), { recursive: true });
+	writeFileSync(fullPath, generateWindowVarContent(gitLog, options), "utf8");
+	return fileName;
+}
+/**
+* 生成环境变量文件内容
+*/
+function generateEnvVarsContent(gitLog, options = {}) {
+	const prefix = options.prefix || "__GIT_";
+	const lines = [];
+	for (const [key, value] of Object.entries(gitLog)) {
+		const envKey = `${prefix}${key.toUpperCase()}`;
+		const escapedValue = (typeof value === "string" ? value : String(value)).replaceAll("\"", String.raw`\"`);
+		lines.push(`${envKey}="${escapedValue}"`);
+	}
+	return lines.join("\n");
+}
+/**
+* 生成环境变量文件
+*/
+function generateEnvVars(gitLog, options = {}, outputDir) {
+	const filePath = options.file || ".env.git";
+	const fullPath = outputDir ? resolve(outputDir, filePath) : filePath;
+	mkdirSync(dirname(fullPath), { recursive: true });
+	writeFileSync(fullPath, generateEnvVarsContent(gitLog, options), "utf8");
+}
+/**
+* 生成 TypeScript 类型定义文件内容
+*/
+function generateTypeDefinitionsContent(gitLog) {
+	return `export interface GitLog {
+${Object.entries(gitLog).map(([key, value]) => {
+		return `  ${key}: ${typeof value === "boolean" ? "boolean" : "string"}`;
+	}).join("\n")}
+}
+`;
+}
+/**
+* 生成 TypeScript 类型定义文件
+*/
+function generateTypeDefinitions(gitLog, options = {}, outputDir) {
+	const fileName = options.fileName || "git-log.d.ts";
+	const fullPath = outputDir && !isAbsolute(fileName) ? resolve(outputDir, fileName) : fileName;
+	mkdirSync(dirname(fullPath), { recursive: true });
+	writeFileSync(fullPath, generateTypeDefinitionsContent(gitLog), "utf8");
+}
+/**
+* 根据配置生成所有输出
+*/
+function generateOutputs(gitLog, outputOptions, outputDir) {
+	let windowVarFileName;
+	if (outputOptions.json) generateJson(gitLog, outputOptions.json, outputDir);
+	if (outputOptions.window) windowVarFileName = generateWindowVar(gitLog, outputOptions.window, outputDir);
+	if (outputOptions.env) generateEnvVars(gitLog, outputOptions.env, outputDir);
+	if (outputOptions.types) generateTypeDefinitions(gitLog, outputOptions.types, outputDir);
+	return windowVarFileName;
+}
+
+//#endregion
+export { generateWindowVar as a, generateTypeDefinitions as i, generateJson as n, getAvailableFields as o, generateOutputs as r, getGitLog as s, generateEnvVars as t };

package/dist/rolldown.d.mts

@@ -0,0 +1,21 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/rolldown.d.ts
+
+/**
+* Rolldown plugin
+*
+* @example
+* ```ts
+* // rolldown.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/rolldown'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+declare const rolldown: typeof AutoGitLog.rolldown;
+//#endregion
+export { rolldown as default, rolldown as "module.exports" };

package/dist/rolldown.mjs

@@ -0,0 +1,26 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/rolldown.ts
+/**
+* This entry file is for Rolldown plugin.
+*
+* @module
+*/
+/**
+* Rolldown plugin
+*
+* @example
+* ```ts
+* // rolldown.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/rolldown'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+const rolldown = AutoGitLog.rolldown;
+var rolldown_default = rolldown;
+
+//#endregion
+export { rolldown_default as default, rolldown as "module.exports" };

package/dist/rollup.d.mts

@@ -0,0 +1,21 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/rollup.d.ts
+
+/**
+* Rollup plugin
+*
+* @example
+* ```ts
+* // rollup.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/rollup'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+declare const rollup: typeof AutoGitLog.rollup;
+//#endregion
+export { rollup as default, rollup as "module.exports" };

package/dist/rollup.mjs

@@ -0,0 +1,26 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/rollup.ts
+/**
+* This entry file is for Rollup plugin.
+*
+* @module
+*/
+/**
+* Rollup plugin
+*
+* @example
+* ```ts
+* // rollup.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/rollup'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+const rollup = AutoGitLog.rollup;
+var rollup_default = rollup;
+
+//#endregion
+export { rollup_default as default, rollup as "module.exports" };

package/dist/rspack.d.mts

@@ -0,0 +1,21 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/rspack.d.ts
+
+/**
+* Rspack plugin
+*
+* @example
+* ```js
+* // rspack.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/rspack'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+declare const rspack: typeof AutoGitLog.rspack;
+//#endregion
+export { rspack as default, rspack as "module.exports" };

package/dist/rspack.mjs

@@ -0,0 +1,26 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/rspack.ts
+/**
+* This entry file is for Rspack plugin.
+*
+* @module
+*/
+/**
+* Rspack plugin
+*
+* @example
+* ```js
+* // rspack.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/rspack'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+const rspack = AutoGitLog.rspack;
+var rspack_default = rspack;
+
+//#endregion
+export { rspack_default as default, rspack as "module.exports" };

package/dist/src-Bbcs1xDg.mjs

@@ -0,0 +1,65 @@
+import { r as generateOutputs, s as getGitLog } from "./outputs-CbT7SkvQ.mjs";
+import { createUnplugin } from "unplugin";
+
+//#region src/core/options.ts
+const DEFAULT_FIELDS = [
+	"repo",
+	"branch",
+	"commit",
+	"commitShort",
+	"author",
+	"authorEmail",
+	"commitTime",
+	"commitMessage",
+	"isDirty"
+];
+function resolveOptions(options = {}) {
+	return {
+		include: options.include || [/\.[cm]?[jt]sx?$/],
+		exclude: options.exclude || [/node_modules/],
+		enforce: "enforce" in options ? options.enforce : "post",
+		enable: options.enable !== void 0 ? options.enable : true,
+		fields: options.fields || DEFAULT_FIELDS,
+		outputs: options.outputs || {},
+		cwd: options.cwd
+	};
+}
+
+//#endregion
+//#region src/index.ts
+const AutoGitLog = createUnplugin((rawOptions = {}) => {
+	const options = resolveOptions(rawOptions);
+	let outputDir;
+	let windowVarFileName;
+	return {
+		name: "unplugin-auto-git-log",
+		enforce: options.enforce,
+		configResolved(config) {
+			if ("vite" in config) {
+				const viteConfig = config;
+				outputDir = viteConfig.build?.outDir || viteConfig.vite?.config?.build?.outDir;
+			} else if ("webpack" in config) outputDir = config.output?.path;
+			else if ("output" in config && typeof config.output === "object") outputDir = config.output?.dir;
+			if (!outputDir) outputDir = "dist";
+		},
+		buildEnd() {
+			if (!options.enable) return;
+			const gitLog = getGitLog(options.fields, options.cwd);
+			if (options.outputs && (options.outputs.json || options.outputs.window || options.outputs.env || options.outputs.types)) windowVarFileName = generateOutputs(gitLog, options.outputs, outputDir);
+			else generateOutputs(gitLog, { json: {} }, outputDir);
+		},
+		vite: { transformIndexHtml(html) {
+			if (options.outputs?.window && windowVarFileName) return {
+				html,
+				tags: [{
+					tag: "script",
+					attrs: { src: `/${windowVarFileName}` },
+					injectTo: "head"
+				}]
+			};
+		} }
+	};
+});
+
+//#endregion
+export { AutoGitLog as t };

package/dist/vite.d.mts

@@ -0,0 +1,21 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/vite.d.ts
+
+/**
+* Vite plugin
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import AutoGitLog from 'unplugin-auto-git-log/vite'
+*
+* export default defineConfig({
+*   plugins: [AutoGitLog()],
+* })
+* ```
+*/
+declare const vite: typeof AutoGitLog.vite;
+//#endregion
+export { vite as default, vite as "module.exports" };

package/dist/vite.mjs

@@ -0,0 +1,26 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/vite.ts
+/**
+* This entry file is for Vite plugin.
+*
+* @module
+*/
+/**
+* Vite plugin
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import AutoGitLog from 'unplugin-auto-git-log/vite'
+*
+* export default defineConfig({
+*   plugins: [AutoGitLog()],
+* })
+* ```
+*/
+const vite = AutoGitLog.vite;
+var vite_default = vite;
+
+//#endregion
+export { vite_default as default, vite as "module.exports" };

package/dist/webpack.d.mts

@@ -0,0 +1,21 @@
+import "./options-B7zpW-6U.mjs";
+import { AutoGitLog } from "./index.mjs";
+
+//#region src/webpack.d.ts
+
+/**
+* Webpack plugin
+*
+* @example
+* ```js
+* // webpack.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/webpack'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+declare const webpack: typeof AutoGitLog.webpack;
+//#endregion
+export { webpack as default, webpack as "module.exports" };

package/dist/webpack.mjs

@@ -0,0 +1,26 @@
+import { t as AutoGitLog } from "./src-Bbcs1xDg.mjs";
+
+//#region src/webpack.ts
+/**
+* This entry file is for webpack plugin.
+*
+* @module
+*/
+/**
+* Webpack plugin
+*
+* @example
+* ```js
+* // webpack.config.js
+* import AutoGitLog from 'unplugin-auto-git-log/webpack'
+*
+* export default {
+*   plugins: [AutoGitLog()],
+* }
+* ```
+*/
+const webpack = AutoGitLog.webpack;
+var webpack_default = webpack;
+
+//#endregion
+export { webpack_default as default, webpack as "module.exports" };

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "unplugin-auto-git-log",
+  "type": "module",
+  "version": "0.0.1",
+  "packageManager": "pnpm@10.27.0",
+  "description": "Unplugin for automatically generating Git information (repo, branch, commit, etc.) in multiple output formats.",
+  "author": "Drswith",
+  "license": "MIT",
+  "homepage": "https://github.com/Drswith/unplugin-auto-git-log#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Drswith/unplugin-auto-git-log.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Drswith/unplugin-auto-git-log/issues"
+  },
+  "keywords": [
+    "unplugin",
+    "vite",
+    "webpack",
+    "rspack",
+    "rollup",
+    "rolldown",
+    "esbuild",
+    "farm",
+    "git",
+    "git-log",
+    "build-log",
+    "version-log"
+  ],
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./api": "./dist/api.mjs",
+    "./cli": "./dist/cli.mjs",
+    "./esbuild": "./dist/esbuild.mjs",
+    "./farm": "./dist/farm.mjs",
+    "./rolldown": "./dist/rolldown.mjs",
+    "./rollup": "./dist/rollup.mjs",
+    "./rspack": "./dist/rspack.mjs",
+    "./vite": "./dist/vite.mjs",
+    "./webpack": "./dist/webpack.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*.d.mts",
+        "./*"
+      ]
+    }
+  },
+  "bin": {
+    "unplugin-auto-git-log": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "release": "bumpp",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "unplugin": "^2.3.11"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^4.11.0",
+    "@sxzz/test-utils": "^0.5.15",
+    "@types/node": "^24.10.4",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.2",
+    "eslint-plugin-format": "^1.0.1",
+    "lint-staged": "^15.5.0",
+    "simple-git-hooks": "^2.13.0",
+    "tsdown": "^0.18.4",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.16"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  }
+}