vite-plugin-meta-env-type 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ry
+
+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,2 @@
+# vite-plugin-meta-env-type
+读取.env文件自动补全vite ImportMetaEnv类型

package/dist/index.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var path = require('path');
+var fg = require('fast-glob');
+var fs = require('fs-extra');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+var fg__default = /*#__PURE__*/_interopDefault(fg);
+var fs__default = /*#__PURE__*/_interopDefault(fs);
+
+// src/vite-plugin-meta-env-type.ts
+function vitePluginMetaEnvType({
+  envFile = ["*.env", ".env.*", ".env"],
+  outFile = "vite-meta-env.d.ts"
+} = {}) {
+  return {
+    name: "meta-env-type-plugin",
+    configResolved(config) {
+      const root = config.root || process.cwd();
+      const envFiles = fg__default.default.globSync(envFile);
+      const envVars = {};
+      envFiles.forEach((file) => {
+        const filePath = path__default.default.resolve(root, file);
+        if (fs__default.default.existsSync(filePath)) {
+          const content = fs__default.default.readFileSync(filePath, "utf8");
+          const lines = content.split("\n");
+          lines.forEach((line) => {
+            const trimmedLine = line.trim();
+            if (trimmedLine && !trimmedLine.startsWith("#")) {
+              const [key, value] = trimmedLine.split("=");
+              if (key) {
+                envVars[key] = value || "";
+              }
+            }
+          });
+        }
+      });
+      const typeDefs = generateTypeDefs(envVars);
+      const outputPath = path__default.default.resolve(root, outFile);
+      fs__default.default.ensureFileSync(outputPath);
+      fs__default.default.writeFileSync(outputPath, typeDefs);
+    }
+  };
+}
+function generateTypeDefs(envVars) {
+  const envProperties = Object.entries(envVars).map(([key, value]) => {
+    return `      ${key}: string`;
+  }).join("\n");
+  return `// generated by meta-env-type-plugin
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+    env: {
+${envProperties}
+    }
+  }
+`;
+}
+
+exports.vitePluginMetaEnvType = vitePluginMetaEnvType;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin-meta-env-type.ts"],"names":["fg","path","fs"],"mappings":";;;;;;;;;;;;;AAUO,SAAS,qBAAA,CAAsB;AAAA,EACpC,OAAA,GAAU,CAAC,OAAA,EAAS,QAAA,EAAU,MAAM,CAAA;AAAA,EACpC,OAAA,GAAU;AACZ,CAAA,GAAkC,EAAC,EAAG;AACpC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,sBAAA;AAAA,IACN,eAAe,MAAA,EAAwB;AACrC,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,IAAQ,OAAA,CAAQ,GAAA,EAAI;AACxC,MAAA,MAAM,QAAA,GAAWA,mBAAA,CAAG,QAAA,CAAS,OAAO,CAAA;AAEpC,MAAA,MAAM,UAAkC,EAAC;AAEzC,MAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,IAAA,KAAS;AACzB,QAAA,MAAM,QAAA,GAAWC,qBAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAA;AACxC,QAAA,IAAIC,mBAAA,CAAG,UAAA,CAAW,QAAQ,CAAA,EAAG;AAC3B,UAAA,MAAM,OAAA,GAAUA,mBAAA,CAAG,YAAA,CAAa,QAAA,EAAU,MAAM,CAAA;AAChD,UAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA;AAEhC,UAAA,KAAA,CAAM,OAAA,CAAQ,CAAC,IAAA,KAAS;AACtB,YAAA,MAAM,WAAA,GAAc,KAAK,IAAA,EAAK;AAC9B,YAAA,IAAI,WAAA,IAAe,CAAC,WAAA,CAAY,UAAA,CAAW,GAAG,CAAA,EAAG;AAC/C,cAAA,MAAM,CAAC,GAAA,EAAK,KAAK,CAAA,GAAI,WAAA,CAAY,MAAM,GAAG,CAAA;AAC1C,cAAA,IAAI,GAAA,EAAK;AACP,gBAAA,OAAA,CAAQ,GAAG,IAAI,KAAA,IAAS,EAAA;AAAA,cAC1B;AAAA,YACF;AAAA,UACF,CAAC,CAAA;AAAA,QACH;AAAA,MACF,CAAC,CAAA;AAED,MAAA,MAAM,QAAA,GAAW,iBAAiB,OAAO,CAAA;AACzC,MAAA,MAAM,UAAA,GAAaD,qBAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAC7C,MAAAC,mBAAA,CAAG,eAAe,UAAU,CAAA;AAC5B,MAAAA,mBAAA,CAAG,aAAA,CAAc,YAAY,QAAQ,CAAA;AAAA,IACvC;AAAA,GACF;AACF;AAEA,SAAS,iBAAiB,OAAA,EAAyC;AACjE,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,CACzC,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AACrB,IAAA,OAAO,SAAS,GAAG,CAAA,QAAA,CAAA;AAAA,EACrB,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AAEZ,EAAA,OAAO,CAAA;AAAA;;AAAA;AAAA;AAAA,EAKP,aAAa;AAAA;AAAA;AAAA,CAAA;AAIf","file":"index.cjs","sourcesContent":["import path from 'node:path'\nimport type { ResolvedConfig } from 'vite'\nimport fg from 'fast-glob'\nimport fs from 'fs-extra'\n\nexport type VitePluginMetaEnvTypeOptions = {\n  envFile?: string[] | string\n  outFile?: string\n}\n\nexport function vitePluginMetaEnvType({\n  envFile = ['*.env', '.env.*', '.env'],\n  outFile = 'vite-meta-env.d.ts'\n}: VitePluginMetaEnvTypeOptions = {}) {\n  return {\n    name: 'meta-env-type-plugin',\n    configResolved(config: ResolvedConfig) {\n      const root = config.root || process.cwd()\n      const envFiles = fg.globSync(envFile)\n\n      const envVars: Record<string, string> = {}\n\n      envFiles.forEach((file) => {\n        const filePath = path.resolve(root, file)\n        if (fs.existsSync(filePath)) {\n          const content = fs.readFileSync(filePath, 'utf8')\n          const lines = content.split('\\n')\n\n          lines.forEach((line) => {\n            const trimmedLine = line.trim()\n            if (trimmedLine && !trimmedLine.startsWith('#')) {\n              const [key, value] = trimmedLine.split('=')\n              if (key) {\n                envVars[key] = value || ''\n              }\n            }\n          })\n        }\n      })\n\n      const typeDefs = generateTypeDefs(envVars)\n      const outputPath = path.resolve(root, outFile)\n      fs.ensureFileSync(outputPath)\n      fs.writeFileSync(outputPath, typeDefs)\n    }\n  }\n}\n\nfunction generateTypeDefs(envVars: Record<string, string>): string {\n  const envProperties = Object.entries(envVars)\n    .map(([key, value]) => {\n      return `      ${key}: string`\n    })\n    .join('\\n')\n\n  return `// generated by meta-env-type-plugin\n/// <reference types=\"vite/client\" />\n\ninterface ImportMetaEnv {\n    env: {\n${envProperties}\n    }\n  }\n`\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import { ResolvedConfig } from 'vite';
+
+type VitePluginMetaEnvTypeOptions = {
+    envFile?: string[] | string;
+    outFile?: string;
+};
+declare function vitePluginMetaEnvType({ envFile, outFile }?: VitePluginMetaEnvTypeOptions): {
+    name: string;
+    configResolved(config: ResolvedConfig): void;
+};
+
+export { type VitePluginMetaEnvTypeOptions, vitePluginMetaEnvType };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { ResolvedConfig } from 'vite';
+
+type VitePluginMetaEnvTypeOptions = {
+    envFile?: string[] | string;
+    outFile?: string;
+};
+declare function vitePluginMetaEnvType({ envFile, outFile }?: VitePluginMetaEnvTypeOptions): {
+    name: string;
+    configResolved(config: ResolvedConfig): void;
+};
+
+export { type VitePluginMetaEnvTypeOptions, vitePluginMetaEnvType };

package/dist/index.js

@@ -0,0 +1,56 @@
+import path from 'path';
+import fg from 'fast-glob';
+import fs from 'fs-extra';
+
+// src/vite-plugin-meta-env-type.ts
+function vitePluginMetaEnvType({
+  envFile = ["*.env", ".env.*", ".env"],
+  outFile = "vite-meta-env.d.ts"
+} = {}) {
+  return {
+    name: "meta-env-type-plugin",
+    configResolved(config) {
+      const root = config.root || process.cwd();
+      const envFiles = fg.globSync(envFile);
+      const envVars = {};
+      envFiles.forEach((file) => {
+        const filePath = path.resolve(root, file);
+        if (fs.existsSync(filePath)) {
+          const content = fs.readFileSync(filePath, "utf8");
+          const lines = content.split("\n");
+          lines.forEach((line) => {
+            const trimmedLine = line.trim();
+            if (trimmedLine && !trimmedLine.startsWith("#")) {
+              const [key, value] = trimmedLine.split("=");
+              if (key) {
+                envVars[key] = value || "";
+              }
+            }
+          });
+        }
+      });
+      const typeDefs = generateTypeDefs(envVars);
+      const outputPath = path.resolve(root, outFile);
+      fs.ensureFileSync(outputPath);
+      fs.writeFileSync(outputPath, typeDefs);
+    }
+  };
+}
+function generateTypeDefs(envVars) {
+  const envProperties = Object.entries(envVars).map(([key, value]) => {
+    return `      ${key}: string`;
+  }).join("\n");
+  return `// generated by meta-env-type-plugin
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+    env: {
+${envProperties}
+    }
+  }
+`;
+}
+
+export { vitePluginMetaEnvType };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin-meta-env-type.ts"],"names":[],"mappings":";;;;;AAUO,SAAS,qBAAA,CAAsB;AAAA,EACpC,OAAA,GAAU,CAAC,OAAA,EAAS,QAAA,EAAU,MAAM,CAAA;AAAA,EACpC,OAAA,GAAU;AACZ,CAAA,GAAkC,EAAC,EAAG;AACpC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,sBAAA;AAAA,IACN,eAAe,MAAA,EAAwB;AACrC,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,IAAQ,OAAA,CAAQ,GAAA,EAAI;AACxC,MAAA,MAAM,QAAA,GAAW,EAAA,CAAG,QAAA,CAAS,OAAO,CAAA;AAEpC,MAAA,MAAM,UAAkC,EAAC;AAEzC,MAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,IAAA,KAAS;AACzB,QAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAA;AACxC,QAAA,IAAI,EAAA,CAAG,UAAA,CAAW,QAAQ,CAAA,EAAG;AAC3B,UAAA,MAAM,OAAA,GAAU,EAAA,CAAG,YAAA,CAAa,QAAA,EAAU,MAAM,CAAA;AAChD,UAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,KAAA,CAAM,IAAI,CAAA;AAEhC,UAAA,KAAA,CAAM,OAAA,CAAQ,CAAC,IAAA,KAAS;AACtB,YAAA,MAAM,WAAA,GAAc,KAAK,IAAA,EAAK;AAC9B,YAAA,IAAI,WAAA,IAAe,CAAC,WAAA,CAAY,UAAA,CAAW,GAAG,CAAA,EAAG;AAC/C,cAAA,MAAM,CAAC,GAAA,EAAK,KAAK,CAAA,GAAI,WAAA,CAAY,MAAM,GAAG,CAAA;AAC1C,cAAA,IAAI,GAAA,EAAK;AACP,gBAAA,OAAA,CAAQ,GAAG,IAAI,KAAA,IAAS,EAAA;AAAA,cAC1B;AAAA,YACF;AAAA,UACF,CAAC,CAAA;AAAA,QACH;AAAA,MACF,CAAC,CAAA;AAED,MAAA,MAAM,QAAA,GAAW,iBAAiB,OAAO,CAAA;AACzC,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAC7C,MAAA,EAAA,CAAG,eAAe,UAAU,CAAA;AAC5B,MAAA,EAAA,CAAG,aAAA,CAAc,YAAY,QAAQ,CAAA;AAAA,IACvC;AAAA,GACF;AACF;AAEA,SAAS,iBAAiB,OAAA,EAAyC;AACjE,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,CACzC,IAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AACrB,IAAA,OAAO,SAAS,GAAG,CAAA,QAAA,CAAA;AAAA,EACrB,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AAEZ,EAAA,OAAO,CAAA;AAAA;;AAAA;AAAA;AAAA,EAKP,aAAa;AAAA;AAAA;AAAA,CAAA;AAIf","file":"index.js","sourcesContent":["import path from 'node:path'\nimport type { ResolvedConfig } from 'vite'\nimport fg from 'fast-glob'\nimport fs from 'fs-extra'\n\nexport type VitePluginMetaEnvTypeOptions = {\n  envFile?: string[] | string\n  outFile?: string\n}\n\nexport function vitePluginMetaEnvType({\n  envFile = ['*.env', '.env.*', '.env'],\n  outFile = 'vite-meta-env.d.ts'\n}: VitePluginMetaEnvTypeOptions = {}) {\n  return {\n    name: 'meta-env-type-plugin',\n    configResolved(config: ResolvedConfig) {\n      const root = config.root || process.cwd()\n      const envFiles = fg.globSync(envFile)\n\n      const envVars: Record<string, string> = {}\n\n      envFiles.forEach((file) => {\n        const filePath = path.resolve(root, file)\n        if (fs.existsSync(filePath)) {\n          const content = fs.readFileSync(filePath, 'utf8')\n          const lines = content.split('\\n')\n\n          lines.forEach((line) => {\n            const trimmedLine = line.trim()\n            if (trimmedLine && !trimmedLine.startsWith('#')) {\n              const [key, value] = trimmedLine.split('=')\n              if (key) {\n                envVars[key] = value || ''\n              }\n            }\n          })\n        }\n      })\n\n      const typeDefs = generateTypeDefs(envVars)\n      const outputPath = path.resolve(root, outFile)\n      fs.ensureFileSync(outputPath)\n      fs.writeFileSync(outputPath, typeDefs)\n    }\n  }\n}\n\nfunction generateTypeDefs(envVars: Record<string, string>): string {\n  const envProperties = Object.entries(envVars)\n    .map(([key, value]) => {\n      return `      ${key}: string`\n    })\n    .join('\\n')\n\n  return `// generated by meta-env-type-plugin\n/// <reference types=\"vite/client\" />\n\ninterface ImportMetaEnv {\n    env: {\n${envProperties}\n    }\n  }\n`\n}\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "vite-plugin-meta-env-type",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "scripts": {
+    "watch": "tsup --watch",
+    "build": "tsup",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:release:only": "changeset publish --registry=https://registry.npmjs.com/",
+    "changeset:release": "pnpm build && pnpm changeset:release:only"
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./*": "./dist/*"
+  },
+  "keywords": [
+    "vite",
+    "ImportMetaEnv",
+    "env",
+    "typescript"
+  ],
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "fast-glob": "^3.3.3",
+    "fs-extra": "^11.3.3",
+    "vite": "^7.3.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.2.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}