vite-plugin-keywords 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 cueaz
+
+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,194 @@
+# vite-plugin-keywords
+
+[![NPM][npm-badge]][npm-url]
+[![Github CI][ci-badge]][ci-url]
+[![MIT licensed][license-badge]][license-url]
+
+[npm-badge]: https://img.shields.io/npm/v/vite-plugin-keywords.svg
+[npm-url]: https://www.npmjs.com/package/vite-plugin-keywords
+[ci-badge]: https://github.com/cueaz/vite-plugin-keywords/actions/workflows/ci.yaml/badge.svg
+[ci-url]: https://github.com/cueaz/vite-plugin-keywords/actions/workflows/ci.yaml
+[license-badge]: https://img.shields.io/badge/license-MIT-blue.svg
+[license-url]: https://github.com/cueaz/vite-plugine-keywords/blob/main/LICENSE
+
+> [!NOTE]
+> A Rollup version of this plugin, `rollup-plugin-keywords`, is also available. The primary difference is that the Vite plugin utilizes the `hotUpdate` hook to incrementally collect keywords and update modules and types during development. While this documentation is written primarily for the Vite plugin, the setup is almost identical—just add `rollup-plugin-keywords` to your Rollup configuration.
+
+A Vite plugin that provides a way to use minifiable `Symbols` (keywords) in place of string literals and object keys, offering a potential strategy for aggressive minification.
+
+This approach introduces a trade-off between a small reduction in bundle size and an increase in code complexity. It is best suited for ~~applications where every byte counts~~ minification nerds.
+
+## Rationale
+
+A common pattern in JavaScript applications, particularly in state management, involves using string literals as unique identifiers.
+
+```ts
+// A typical action in a state management system
+function setUser(name: string) {
+  return {
+    type: 'SET_USER',
+    payload: { name },
+  };
+}
+```
+
+While minifiers can shorten variable and function names, they cannot alter the string literals. When an application defines dozens of these identifiers, they accumulate as unminifiable overhead in the final bundle.
+
+This plugin addresses this by enabling the use of `Symbol` primitives, which, when assigned to variables, can be safely minified.
+
+**Standard Approach:**
+
+In this standard pattern, both the property key `type` and `payload`, and the type value `'SET_USER'` are strings that resist minification.
+
+```ts
+interface SetUserAction {
+  type: 'SET_USER';
+  payload: { name: string };
+}
+const setUser = (payload: { name: string }): SetUserAction => ({
+  type: 'SET_USER',
+  payload,
+});
+
+function reducer(state: any, action: SetUserAction) {
+  if (action.type === 'SET_USER') {
+    // use action.payload
+  }
+}
+
+// Minified Output: The strings 'type', 'payload', and 'SET_USER' persist.
+// prettier-ignore
+const a=p=>({type:'SET_USER',payload:p});
+// prettier-ignore
+function b(s,c){if(c.type==='SET_USER'){/*...*/}}
+```
+
+**With `vite-plugin-keywords`:**
+
+By importing from the `virtual:keywords` module, you can replace internal, structural strings with minifiable `Symbol` variables, while leaving the data model intact.
+
+```ts
+import * as K from 'virtual:keywords';
+
+interface SetUserAction {
+  [K.type]: typeof K.SET_USER;
+  // The payload's structure remains unchanged for compatibility with external data sources.
+  [K.payload]: { name: string };
+}
+const setUser = (payload: { name: string }): SetUserAction => ({
+  [K.type]: K.SET_USER,
+  [K.payload]: payload,
+});
+
+function reducer(state: any, action: SetUserAction) {
+  if (action[K.type] === K.SET_USER) {
+    // use action[K.payload]
+  }
+}
+
+// Minified Output: All structural identifiers become single-character variables.
+// prettier-ignore
+const k=Symbol,a=k(),b=k(),c=k(),d=p=>({[a]:b,[c]:p});
+// prettier-ignore
+function e(s,f){if(f[a]===b){/*...*/}}
+```
+
+This transforms static string overhead into minifiable variables, allowing the minifier to do what it does best.
+
+## Comparison to Property Mangling
+
+Property mangling lacks the semantic context to know which keys are safe to alter, often relying on fragile regex or naming conventions. This plugin takes a different approach by operating on explicit developer intent. Rather than asking a minifier to guess, you refactor a string literal into a minifiable variable (`K.myKeyword`) that holds a unique `Symbol`. This provides an unambiguous, structural hint to the build process, enabling safe and predictable minification of identifiers without the risks associated with global property renaming.
+
+## How It Works
+
+The plugin works by scanning your code for usages of the `virtual:keywords` module and generating the corresponding `Symbol` exports and types on the fly.
+
+```ts
+// virtual:keywords
+const __SYMBOL__ = Symbol;
+const _type = /* @__PURE__ */ __SYMBOL__(); // __SYMBOL__('type') in dev mode
+const _payload = /* @__PURE__ */ __SYMBOL__(); // __SYMBOL__('payload') in dev mode
+const _SET_USER = /* @__PURE__ */ __SYMBOL__(); // __SYMBOL__('SET_USER') in dev mode
+// ... and so on for all other keywords found.
+export {
+  _type as type,
+  _payload as payload,
+  _SET_USER as SET_USER,
+  // ... and so on
+};
+```
+
+## Installation
+
+```bash
+npm install -D vite-plugin-keywords
+# or
+yarn add -D vite-plugin-keywords
+# or
+pnpm add -D vite-plugin-keywords
+```
+
+## Setup
+
+1.  Add the plugin to your `vite.config.ts`.
+
+    ```ts
+    // vite.config.ts
+    import { defineConfig } from 'vite';
+    import keywords from 'vite-plugin-keywords';
+
+    export default defineConfig({
+      plugins: [keywords()],
+    });
+    ```
+
+2.  Include the generated types file in your `tsconfig.json` or `src/env.d.ts`.
+
+    ```jsonc
+    // tsconfig.json
+    {
+      // ...
+      "include": [
+        "src",
+        ".keywords/types.d.ts", // Add this line
+      ],
+    }
+    ```
+
+    ```ts
+    // src/env.d.ts
+    /// <reference path="../.keywords/types.d.ts" />
+    ```
+
+3.  Exclude the generated types file from your version control system (e.g., Git).
+
+    ```gitignore
+    # .gitignore
+    .keywords/
+    ```
+
+4.  Ensure that your type-checking script in `package.json` is updated to run the plugin first:
+
+    ```jsonc
+    // package.json
+    {
+      "scripts": {
+        "typecheck": "keywords && tsc --noEmit",
+      },
+    }
+    ```
+
+5.  The `.keywords/types.d.ts` type file is created automatically on `vite dev/build`, or manually via the `keywords` script.
+
+## Options
+
+None
+
+## Limitations
+
+- **(TODO) Frameworks**: The plugin uses Babel to parse JavaScript and TypeScript files. It cannot parse keywords from Vue, Svelte, or Astro files yet.
+- **Dynamic Access**: Only static property access (e.g., `K.myKeyword`) is detected. Dynamic, computed access (e.g., `K['myKeyword']`) will not be identified by the plugin.
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,21 @@
+// src/cli.ts
+import {
+  collectKeywordsAndGenerateTypes,
+  createPrefixedLogger
+} from "minifiable-keywords";
+import { resolveConfig } from "vite";
+
+// src/shared.ts
+var PLUGIN_NAME = "vite-plugin-keywords";
+
+// src/cli.ts
+var main = async () => {
+  const config = await resolveConfig({}, "build");
+  const logger = createPrefixedLogger(config.logger, PLUGIN_NAME);
+  await collectKeywordsAndGenerateTypes(config.root, logger, [
+    config.build.outDir,
+    config.cacheDir
+  ]);
+};
+await main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/shared.ts"],"sourcesContent":["import {\n  collectKeywordsAndGenerateTypes,\n  createPrefixedLogger,\n} from 'minifiable-keywords';\nimport { resolveConfig } from 'vite';\nimport { PLUGIN_NAME } from './shared';\n\nconst main = async () => {\n  const config = await resolveConfig({}, 'build');\n  const logger = createPrefixedLogger(config.logger, PLUGIN_NAME);\n\n  // const keywordsPlugin = config.plugins.find(\n  //   (plugin) => plugin.name === PLUGIN_NAME,\n  // );\n  // if (!keywordsPlugin) {\n  //   logger.error('Keywords plugin not found in Vite configuration.');\n  //   process.exit(1);\n  // }\n\n  await collectKeywordsAndGenerateTypes(config.root, logger, [\n    config.build.outDir,\n    config.cacheDir,\n  ]);\n};\n\nawait main();\n","export const PLUGIN_NAME = 'vite-plugin-keywords';\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB;;;ACJvB,IAAM,cAAc;;;ADO3B,IAAM,OAAO,YAAY;AACvB,QAAM,SAAS,MAAM,cAAc,CAAC,GAAG,OAAO;AAC9C,QAAM,SAAS,qBAAqB,OAAO,QAAQ,WAAW;AAU9D,QAAM,gCAAgC,OAAO,MAAM,QAAQ;AAAA,IACzD,OAAO,MAAM;AAAA,IACb,OAAO;AAAA,EACT,CAAC;AACH;AAEA,MAAM,KAAK;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,113 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  keywordsPlugin: () => keywordsPlugin
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_path = __toESM(require("path"), 1);
+var import_minifiable_keywords = require("minifiable-keywords");
+
+// src/shared.ts
+var PLUGIN_NAME = "vite-plugin-keywords";
+
+// src/index.ts
+var keywordsPlugin = () => {
+  let collectedKeywords;
+  let config;
+  let logger;
+  const invalidateModule = (absoluteId, moduleGraph) => {
+    const module2 = moduleGraph.getModuleById(absoluteId);
+    if (module2) {
+      moduleGraph.invalidateModule(module2);
+      module2.lastHMRTimestamp = module2.lastInvalidationTimestamp || Date.now();
+    }
+  };
+  return {
+    name: PLUGIN_NAME,
+    configResolved(resolvedConfig) {
+      config = resolvedConfig;
+      logger = (0, import_minifiable_keywords.createPrefixedLogger)(config.logger, PLUGIN_NAME);
+    },
+    async buildStart() {
+      collectedKeywords = await (0, import_minifiable_keywords.collectKeywordsAndGenerateTypes)(
+        config.root,
+        logger,
+        [config.build.outDir, config.cacheDir]
+      );
+    },
+    resolveId(source, importer) {
+      if (!importer) {
+        return;
+      }
+      const [validSource] = (0, import_minifiable_keywords.splitQuery)(source);
+      if (validSource === import_minifiable_keywords.VIRTUAL_MODULE_ID) {
+        return import_minifiable_keywords.RESOLVED_VIRTUAL_MODULE_ID;
+      }
+    },
+    load(id) {
+      const [validId] = (0, import_minifiable_keywords.splitQuery)(id);
+      if (validId === import_minifiable_keywords.RESOLVED_VIRTUAL_MODULE_ID) {
+        const isDev = config.mode === "development";
+        return (0, import_minifiable_keywords.generateModuleCode)(collectedKeywords, isDev);
+      }
+    },
+    async hotUpdate({ type, file, read }) {
+      if (type === "delete") return;
+      const fileExt = import_node_path.default.extname(file);
+      if (![".js", ".ts", ".jsx", ".tsx"].includes(fileExt) || file.includes("/.")) {
+        return;
+      }
+      const code = await read();
+      const keywordsInFile = (0, import_minifiable_keywords.extractKeywords)(code);
+      if (keywordsInFile.size === 0) return;
+      const initialSize = collectedKeywords.size;
+      for (const key of keywordsInFile) {
+        collectedKeywords.add(key);
+      }
+      const newKeywordsAdded = collectedKeywords.size > initialSize;
+      if (newKeywordsAdded) {
+        invalidateModule(
+          import_minifiable_keywords.RESOLVED_VIRTUAL_MODULE_ID,
+          this.environment.moduleGraph
+        );
+        await (0, import_minifiable_keywords.generateTypesFile)(collectedKeywords, config.root);
+      }
+    }
+  };
+};
+var index_default = keywordsPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  keywordsPlugin
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/shared.ts"],"sourcesContent":["import path from 'node:path';\nimport {\n  collectKeywordsAndGenerateTypes,\n  createPrefixedLogger,\n  extractKeywords,\n  generateModuleCode,\n  generateTypesFile,\n  RESOLVED_VIRTUAL_MODULE_ID,\n  splitQuery,\n  VIRTUAL_MODULE_ID,\n  type PrefixedLogger,\n} from 'minifiable-keywords';\nimport type { EnvironmentModuleGraph, Plugin, ResolvedConfig } from 'vite';\nimport { PLUGIN_NAME } from './shared';\n\nexport const keywordsPlugin = (): Plugin => {\n  let collectedKeywords: Set<string>;\n  let config: ResolvedConfig;\n  let logger: PrefixedLogger;\n\n  const invalidateModule = (\n    absoluteId: string,\n    moduleGraph: EnvironmentModuleGraph,\n  ): void => {\n    const module = moduleGraph.getModuleById(absoluteId);\n    if (module) {\n      moduleGraph.invalidateModule(module);\n      module.lastHMRTimestamp = module.lastInvalidationTimestamp || Date.now();\n    }\n  };\n\n  return {\n    name: PLUGIN_NAME,\n\n    configResolved(resolvedConfig) {\n      config = resolvedConfig;\n      logger = createPrefixedLogger(config.logger, PLUGIN_NAME);\n    },\n\n    async buildStart() {\n      collectedKeywords = await collectKeywordsAndGenerateTypes(\n        config.root,\n        logger,\n        [config.build.outDir, config.cacheDir],\n      );\n    },\n\n    resolveId(source, importer) {\n      if (!importer) {\n        return;\n      }\n      const [validSource] = splitQuery(source);\n      if (validSource === VIRTUAL_MODULE_ID) {\n        return RESOLVED_VIRTUAL_MODULE_ID;\n      }\n    },\n\n    load(id) {\n      const [validId] = splitQuery(id);\n      if (validId === RESOLVED_VIRTUAL_MODULE_ID) {\n        const isDev = config.mode === 'development';\n        return generateModuleCode(collectedKeywords, isDev);\n      }\n    },\n\n    async hotUpdate({ type, file, read }) {\n      if (type === 'delete') return;\n\n      const fileExt = path.extname(file);\n      if (\n        !['.js', '.ts', '.jsx', '.tsx'].includes(fileExt) ||\n        file.includes('/.')\n      ) {\n        return;\n      }\n\n      const code = await read();\n      const keywordsInFile = extractKeywords(code);\n      if (keywordsInFile.size === 0) return;\n\n      const initialSize = collectedKeywords.size;\n      for (const key of keywordsInFile) {\n        collectedKeywords.add(key);\n      }\n\n      const newKeywordsAdded = collectedKeywords.size > initialSize;\n      if (newKeywordsAdded) {\n        invalidateModule(\n          RESOLVED_VIRTUAL_MODULE_ID,\n          this.environment.moduleGraph,\n        );\n        await generateTypesFile(collectedKeywords, config.root);\n      }\n    },\n  };\n};\n\nexport default keywordsPlugin;\n","export const PLUGIN_NAME = 'vite-plugin-keywords';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAiB;AACjB,iCAUO;;;ACXA,IAAM,cAAc;;;ADepB,IAAM,iBAAiB,MAAc;AAC1C,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,QAAM,mBAAmB,CACvB,YACA,gBACS;AACT,UAAMA,UAAS,YAAY,cAAc,UAAU;AACnD,QAAIA,SAAQ;AACV,kBAAY,iBAAiBA,OAAM;AACnC,MAAAA,QAAO,mBAAmBA,QAAO,6BAA6B,KAAK,IAAI;AAAA,IACzE;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,eAAe,gBAAgB;AAC7B,eAAS;AACT,mBAAS,iDAAqB,OAAO,QAAQ,WAAW;AAAA,IAC1D;AAAA,IAEA,MAAM,aAAa;AACjB,0BAAoB,UAAM;AAAA,QACxB,OAAO;AAAA,QACP;AAAA,QACA,CAAC,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAAA,MACvC;AAAA,IACF;AAAA,IAEA,UAAU,QAAQ,UAAU;AAC1B,UAAI,CAAC,UAAU;AACb;AAAA,MACF;AACA,YAAM,CAAC,WAAW,QAAI,uCAAW,MAAM;AACvC,UAAI,gBAAgB,8CAAmB;AACrC,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,KAAK,IAAI;AACP,YAAM,CAAC,OAAO,QAAI,uCAAW,EAAE;AAC/B,UAAI,YAAY,uDAA4B;AAC1C,cAAM,QAAQ,OAAO,SAAS;AAC9B,mBAAO,+CAAmB,mBAAmB,KAAK;AAAA,MACpD;AAAA,IACF;AAAA,IAEA,MAAM,UAAU,EAAE,MAAM,MAAM,KAAK,GAAG;AACpC,UAAI,SAAS,SAAU;AAEvB,YAAM,UAAU,iBAAAC,QAAK,QAAQ,IAAI;AACjC,UACE,CAAC,CAAC,OAAO,OAAO,QAAQ,MAAM,EAAE,SAAS,OAAO,KAChD,KAAK,SAAS,IAAI,GAClB;AACA;AAAA,MACF;AAEA,YAAM,OAAO,MAAM,KAAK;AACxB,YAAM,qBAAiB,4CAAgB,IAAI;AAC3C,UAAI,eAAe,SAAS,EAAG;AAE/B,YAAM,cAAc,kBAAkB;AACtC,iBAAW,OAAO,gBAAgB;AAChC,0BAAkB,IAAI,GAAG;AAAA,MAC3B;AAEA,YAAM,mBAAmB,kBAAkB,OAAO;AAClD,UAAI,kBAAkB;AACpB;AAAA,UACE;AAAA,UACA,KAAK,YAAY;AAAA,QACnB;AACA,kBAAM,8CAAkB,mBAAmB,OAAO,IAAI;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;","names":["module","path"]}

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+import { Plugin } from 'vite';
+
+declare const keywordsPlugin: () => Plugin;
+
+export { keywordsPlugin as default, keywordsPlugin };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { Plugin } from 'vite';
+
+declare const keywordsPlugin: () => Plugin;
+
+export { keywordsPlugin as default, keywordsPlugin };

package/dist/index.js

@@ -0,0 +1,87 @@
+// src/index.ts
+import path from "path";
+import {
+  collectKeywordsAndGenerateTypes,
+  createPrefixedLogger,
+  extractKeywords,
+  generateModuleCode,
+  generateTypesFile,
+  RESOLVED_VIRTUAL_MODULE_ID,
+  splitQuery,
+  VIRTUAL_MODULE_ID
+} from "minifiable-keywords";
+
+// src/shared.ts
+var PLUGIN_NAME = "vite-plugin-keywords";
+
+// src/index.ts
+var keywordsPlugin = () => {
+  let collectedKeywords;
+  let config;
+  let logger;
+  const invalidateModule = (absoluteId, moduleGraph) => {
+    const module = moduleGraph.getModuleById(absoluteId);
+    if (module) {
+      moduleGraph.invalidateModule(module);
+      module.lastHMRTimestamp = module.lastInvalidationTimestamp || Date.now();
+    }
+  };
+  return {
+    name: PLUGIN_NAME,
+    configResolved(resolvedConfig) {
+      config = resolvedConfig;
+      logger = createPrefixedLogger(config.logger, PLUGIN_NAME);
+    },
+    async buildStart() {
+      collectedKeywords = await collectKeywordsAndGenerateTypes(
+        config.root,
+        logger,
+        [config.build.outDir, config.cacheDir]
+      );
+    },
+    resolveId(source, importer) {
+      if (!importer) {
+        return;
+      }
+      const [validSource] = splitQuery(source);
+      if (validSource === VIRTUAL_MODULE_ID) {
+        return RESOLVED_VIRTUAL_MODULE_ID;
+      }
+    },
+    load(id) {
+      const [validId] = splitQuery(id);
+      if (validId === RESOLVED_VIRTUAL_MODULE_ID) {
+        const isDev = config.mode === "development";
+        return generateModuleCode(collectedKeywords, isDev);
+      }
+    },
+    async hotUpdate({ type, file, read }) {
+      if (type === "delete") return;
+      const fileExt = path.extname(file);
+      if (![".js", ".ts", ".jsx", ".tsx"].includes(fileExt) || file.includes("/.")) {
+        return;
+      }
+      const code = await read();
+      const keywordsInFile = extractKeywords(code);
+      if (keywordsInFile.size === 0) return;
+      const initialSize = collectedKeywords.size;
+      for (const key of keywordsInFile) {
+        collectedKeywords.add(key);
+      }
+      const newKeywordsAdded = collectedKeywords.size > initialSize;
+      if (newKeywordsAdded) {
+        invalidateModule(
+          RESOLVED_VIRTUAL_MODULE_ID,
+          this.environment.moduleGraph
+        );
+        await generateTypesFile(collectedKeywords, config.root);
+      }
+    }
+  };
+};
+var index_default = keywordsPlugin;
+export {
+  index_default as default,
+  keywordsPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/shared.ts"],"sourcesContent":["import path from 'node:path';\nimport {\n  collectKeywordsAndGenerateTypes,\n  createPrefixedLogger,\n  extractKeywords,\n  generateModuleCode,\n  generateTypesFile,\n  RESOLVED_VIRTUAL_MODULE_ID,\n  splitQuery,\n  VIRTUAL_MODULE_ID,\n  type PrefixedLogger,\n} from 'minifiable-keywords';\nimport type { EnvironmentModuleGraph, Plugin, ResolvedConfig } from 'vite';\nimport { PLUGIN_NAME } from './shared';\n\nexport const keywordsPlugin = (): Plugin => {\n  let collectedKeywords: Set<string>;\n  let config: ResolvedConfig;\n  let logger: PrefixedLogger;\n\n  const invalidateModule = (\n    absoluteId: string,\n    moduleGraph: EnvironmentModuleGraph,\n  ): void => {\n    const module = moduleGraph.getModuleById(absoluteId);\n    if (module) {\n      moduleGraph.invalidateModule(module);\n      module.lastHMRTimestamp = module.lastInvalidationTimestamp || Date.now();\n    }\n  };\n\n  return {\n    name: PLUGIN_NAME,\n\n    configResolved(resolvedConfig) {\n      config = resolvedConfig;\n      logger = createPrefixedLogger(config.logger, PLUGIN_NAME);\n    },\n\n    async buildStart() {\n      collectedKeywords = await collectKeywordsAndGenerateTypes(\n        config.root,\n        logger,\n        [config.build.outDir, config.cacheDir],\n      );\n    },\n\n    resolveId(source, importer) {\n      if (!importer) {\n        return;\n      }\n      const [validSource] = splitQuery(source);\n      if (validSource === VIRTUAL_MODULE_ID) {\n        return RESOLVED_VIRTUAL_MODULE_ID;\n      }\n    },\n\n    load(id) {\n      const [validId] = splitQuery(id);\n      if (validId === RESOLVED_VIRTUAL_MODULE_ID) {\n        const isDev = config.mode === 'development';\n        return generateModuleCode(collectedKeywords, isDev);\n      }\n    },\n\n    async hotUpdate({ type, file, read }) {\n      if (type === 'delete') return;\n\n      const fileExt = path.extname(file);\n      if (\n        !['.js', '.ts', '.jsx', '.tsx'].includes(fileExt) ||\n        file.includes('/.')\n      ) {\n        return;\n      }\n\n      const code = await read();\n      const keywordsInFile = extractKeywords(code);\n      if (keywordsInFile.size === 0) return;\n\n      const initialSize = collectedKeywords.size;\n      for (const key of keywordsInFile) {\n        collectedKeywords.add(key);\n      }\n\n      const newKeywordsAdded = collectedKeywords.size > initialSize;\n      if (newKeywordsAdded) {\n        invalidateModule(\n          RESOLVED_VIRTUAL_MODULE_ID,\n          this.environment.moduleGraph,\n        );\n        await generateTypesFile(collectedKeywords, config.root);\n      }\n    },\n  };\n};\n\nexport default keywordsPlugin;\n","export const PLUGIN_NAME = 'vite-plugin-keywords';\n"],"mappings":";AAAA,OAAO,UAAU;AACjB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;;;ACXA,IAAM,cAAc;;;ADepB,IAAM,iBAAiB,MAAc;AAC1C,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,QAAM,mBAAmB,CACvB,YACA,gBACS;AACT,UAAM,SAAS,YAAY,cAAc,UAAU;AACnD,QAAI,QAAQ;AACV,kBAAY,iBAAiB,MAAM;AACnC,aAAO,mBAAmB,OAAO,6BAA6B,KAAK,IAAI;AAAA,IACzE;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,eAAe,gBAAgB;AAC7B,eAAS;AACT,eAAS,qBAAqB,OAAO,QAAQ,WAAW;AAAA,IAC1D;AAAA,IAEA,MAAM,aAAa;AACjB,0BAAoB,MAAM;AAAA,QACxB,OAAO;AAAA,QACP;AAAA,QACA,CAAC,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAAA,MACvC;AAAA,IACF;AAAA,IAEA,UAAU,QAAQ,UAAU;AAC1B,UAAI,CAAC,UAAU;AACb;AAAA,MACF;AACA,YAAM,CAAC,WAAW,IAAI,WAAW,MAAM;AACvC,UAAI,gBAAgB,mBAAmB;AACrC,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,KAAK,IAAI;AACP,YAAM,CAAC,OAAO,IAAI,WAAW,EAAE;AAC/B,UAAI,YAAY,4BAA4B;AAC1C,cAAM,QAAQ,OAAO,SAAS;AAC9B,eAAO,mBAAmB,mBAAmB,KAAK;AAAA,MACpD;AAAA,IACF;AAAA,IAEA,MAAM,UAAU,EAAE,MAAM,MAAM,KAAK,GAAG;AACpC,UAAI,SAAS,SAAU;AAEvB,YAAM,UAAU,KAAK,QAAQ,IAAI;AACjC,UACE,CAAC,CAAC,OAAO,OAAO,QAAQ,MAAM,EAAE,SAAS,OAAO,KAChD,KAAK,SAAS,IAAI,GAClB;AACA;AAAA,MACF;AAEA,YAAM,OAAO,MAAM,KAAK;AACxB,YAAM,iBAAiB,gBAAgB,IAAI;AAC3C,UAAI,eAAe,SAAS,EAAG;AAE/B,YAAM,cAAc,kBAAkB;AACtC,iBAAW,OAAO,gBAAgB;AAChC,0BAAkB,IAAI,GAAG;AAAA,MAC3B;AAEA,YAAM,mBAAmB,kBAAkB,OAAO;AAClD,UAAI,kBAAkB;AACpB;AAAA,UACE;AAAA,UACA,KAAK,YAAY;AAAA,QACnB;AACA,cAAM,kBAAkB,mBAAmB,OAAO,IAAI;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "vite-plugin-keywords",
+  "version": "1.0.0",
+  "description": "A Vite plugin that provides minifiable Symbols (keywords) to use in place of string literals for aggressive minification.",
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "minification"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cueaz/vite-plugin-keywords.git"
+  },
+  "license": "MIT",
+  "author": "cueaz",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "keywords": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "minifiable-keywords": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.1.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0 || ^7.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "test": "vitest"
+  }
+}