@triggery/vite 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @triggery/vite
+
+## 0.1.0
+
+First public preview release.
+
+Vite plugin for Triggery — auto-import every *.trigger.ts file via a virtual module
+
+See the [repository-level CHANGELOG](../../CHANGELOG.md#010--2026-05-16) for the full set of packages and the umbrella feature list. Future entries on this file are appended automatically by changesets.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aleksey Skhomenko
+
+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,45 @@
+# @triggery/vite
+
+[Vite](https://vitejs.dev) plugin for [Triggery](https://github.com/triggeryjs/triggery) — auto-import every `*.trigger.ts` file via a virtual module.
+
+## Install
+
+```bash
+pnpm add -D @triggery/vite
+```
+
+## Use
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import triggery from '@triggery/vite';
+
+export default defineConfig({
+  plugins: [triggery({ glob: 'src/**/*.trigger.ts' })],
+});
+```
+
+Then once at the entry point of your app:
+
+```ts
+// src/main.tsx
+import 'virtual:triggery-registry';
+```
+
+That's it — every file matching the glob is auto-imported, so its top-level `createTrigger(...)` call registers with the default runtime.
+
+## Options
+
+| Option | Default | Description |
+|---|---|---|
+| `glob` | `'src/**/*.trigger.{ts,tsx,js,jsx}'` | One pattern or an array. Anything `tinyglobby` accepts. |
+
+## HMR
+
+* Editing an existing trigger file just re-runs its `createTrigger(...)` — the runtime's last-mount-wins replaces the old registration. No special handling needed.
+* Adding / removing / renaming a trigger file invalidates the virtual module so its import list is rebuilt on the next request.
+
+## License
+
+MIT © Aleksey Skhomenko

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import { Plugin } from 'vite';
+
+/**
+ * @triggery/vite — auto-discovery plugin.
+ *
+ * Add the plugin to `vite.config.ts`, then `import 'virtual:triggery-registry'`
+ * once at the entry point of your app. The plugin globs every `*.trigger.ts`
+ * file at build time and generates a virtual module that imports all of them,
+ * so triggers register themselves with the runtime without manual wiring.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import triggery from '@triggery/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [triggery({ glob: 'src/**\\/*.trigger.ts' })],
+ * });
+ *
+ * // src/main.tsx
+ * import 'virtual:triggery-registry';
+ * ```
+ *
+ * HMR: editing an existing trigger file just re-runs its `createTrigger(...)`
+ * call — the runtime's last-mount-wins replaces the old registration. Adding
+ * or removing a trigger file invalidates the virtual module so its imports
+ * list is rebuilt on the next request.
+ */
+
+type TriggeryViteOptions = {
+    /** Glob pattern(s) for trigger files. Default: `'src/**\\/*.trigger.{ts,tsx,js,jsx}'`. */
+    readonly glob?: string | readonly string[];
+};
+/**
+ * The plugin factory. Default-exported AND named-exported for convenience.
+ */
+declare function triggery(options?: TriggeryViteOptions): Plugin;
+
+export { type TriggeryViteOptions, triggery as default, triggery };

package/dist/index.js

@@ -0,0 +1,46 @@
+import { glob } from 'tinyglobby';
+
+// src/index.ts
+var VIRTUAL_ID = "virtual:triggery-registry";
+var RESOLVED_VIRTUAL_ID = `\0${VIRTUAL_ID}`;
+var DEFAULT_GLOB = "src/**/*.trigger.{ts,tsx,js,jsx}";
+var isTriggerFile = (file) => /\.trigger\.(ts|tsx|js|jsx)$/.test(file);
+function triggery(options = {}) {
+  const patterns = options.glob ?? DEFAULT_GLOB;
+  let projectRoot = process.cwd();
+  return {
+    name: "triggery-auto-discovery",
+    // Run before user imports so the virtual module is in place at resolution time.
+    enforce: "pre",
+    configResolved(cfg) {
+      projectRoot = cfg.root;
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID;
+      return null;
+    },
+    async load(id) {
+      if (id !== RESOLVED_VIRTUAL_ID) return null;
+      const files = await glob(patterns, {
+        cwd: projectRoot,
+        absolute: true,
+        onlyFiles: true
+      });
+      files.sort();
+      const body = files.length === 0 ? "/* @triggery/vite: no *.trigger.* files matched */\n" : `${files.map((f) => `import ${JSON.stringify(f)};`).join("\n")}
+`;
+      return `${body}export {};
+`;
+    },
+    handleHotUpdate(ctx) {
+      if (!isTriggerFile(ctx.file)) return;
+      const mod = ctx.server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);
+      if (mod) ctx.server.moduleGraph.invalidateModule(mod);
+    }
+  };
+}
+var index_default = triggery;
+
+export { index_default as default, triggery };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAoCA,IAAM,UAAA,GAAa,2BAAA;AACnB,IAAM,mBAAA,GAAsB,KAAK,UAAU,CAAA,CAAA;AAC3C,IAAM,YAAA,GAAe,kCAAA;AAErB,IAAM,aAAA,GAAgB,CAAC,IAAA,KAA0B,6BAAA,CAA8B,KAAK,IAAI,CAAA;AAKjF,SAAS,QAAA,CAAS,OAAA,GAA+B,EAAC,EAAW;AAClE,EAAA,MAAM,QAAA,GAAW,QAAQ,IAAA,IAAQ,YAAA;AACjC,EAAA,IAAI,WAAA,GAAc,QAAQ,GAAA,EAAI;AAE9B,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,yBAAA;AAAA;AAAA,IAEN,OAAA,EAAS,KAAA;AAAA,IACT,eAAe,GAAA,EAAK;AAClB,MAAA,WAAA,GAAc,GAAA,CAAI,IAAA;AAAA,IACpB,CAAA;AAAA,IACA,UAAU,EAAA,EAAI;AACZ,MAAA,IAAI,EAAA,KAAO,YAAY,OAAO,mBAAA;AAC9B,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,KAAK,EAAA,EAAI;AACb,MAAA,IAAI,EAAA,KAAO,qBAAqB,OAAO,IAAA;AACvC,MAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,QAAA,EAAU;AAAA,QACjC,GAAA,EAAK,WAAA;AAAA,QACL,QAAA,EAAU,IAAA;AAAA,QACV,SAAA,EAAW;AAAA,OACZ,CAAA;AAED,MAAA,KAAA,CAAM,IAAA,EAAK;AACX,MAAA,MAAM,OACJ,KAAA,CAAM,MAAA,KAAW,IACb,sDAAA,GACA,CAAA,EAAG,MAAM,GAAA,CAAI,CAAC,MAAM,CAAA,OAAA,EAAU,IAAA,CAAK,UAAU,CAAC,CAAC,GAAG,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC;AAAA,CAAA;AACpE,MAAA,OAAO,GAAG,IAAI,CAAA;AAAA,CAAA;AAAA,IAChB,CAAA;AAAA,IACA,gBAAgB,GAAA,EAAK;AAKnB,MAAA,IAAI,CAAC,aAAA,CAAc,GAAA,CAAI,IAAI,CAAA,EAAG;AAC9B,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,MAAA,CAAO,WAAA,CAAY,cAAc,mBAAmB,CAAA;AACpE,MAAA,IAAI,GAAA,EAAK,GAAA,CAAI,MAAA,CAAO,WAAA,CAAY,iBAAiB,GAAG,CAAA;AAAA,IACtD;AAAA,GACF;AACF;AAEA,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * @triggery/vite — auto-discovery plugin.\n *\n * Add the plugin to `vite.config.ts`, then `import 'virtual:triggery-registry'`\n * once at the entry point of your app. The plugin globs every `*.trigger.ts`\n * file at build time and generates a virtual module that imports all of them,\n * so triggers register themselves with the runtime without manual wiring.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { defineConfig } from 'vite';\n * import triggery from '@triggery/vite';\n *\n * export default defineConfig({\n *   plugins: [triggery({ glob: 'src/**\\\\/*.trigger.ts' })],\n * });\n *\n * // src/main.tsx\n * import 'virtual:triggery-registry';\n * ```\n *\n * HMR: editing an existing trigger file just re-runs its `createTrigger(...)`\n * call — the runtime's last-mount-wins replaces the old registration. Adding\n * or removing a trigger file invalidates the virtual module so its imports\n * list is rebuilt on the next request.\n */\n\nimport { glob } from 'tinyglobby';\nimport type { Plugin } from 'vite';\n\nexport type TriggeryViteOptions = {\n  /** Glob pattern(s) for trigger files. Default: `'src/**\\\\/*.trigger.{ts,tsx,js,jsx}'`. */\n  readonly glob?: string | readonly string[];\n};\n\nconst VIRTUAL_ID = 'virtual:triggery-registry';\nconst RESOLVED_VIRTUAL_ID = `\\0${VIRTUAL_ID}`;\nconst DEFAULT_GLOB = 'src/**/*.trigger.{ts,tsx,js,jsx}';\n\nconst isTriggerFile = (file: string): boolean => /\\.trigger\\.(ts|tsx|js|jsx)$/.test(file);\n\n/**\n * The plugin factory. Default-exported AND named-exported for convenience.\n */\nexport function triggery(options: TriggeryViteOptions = {}): Plugin {\n  const patterns = options.glob ?? DEFAULT_GLOB;\n  let projectRoot = process.cwd();\n\n  return {\n    name: 'triggery-auto-discovery',\n    // Run before user imports so the virtual module is in place at resolution time.\n    enforce: 'pre',\n    configResolved(cfg) {\n      projectRoot = cfg.root;\n    },\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID;\n      return null;\n    },\n    async load(id) {\n      if (id !== RESOLVED_VIRTUAL_ID) return null;\n      const files = await glob(patterns, {\n        cwd: projectRoot,\n        absolute: true,\n        onlyFiles: true,\n      });\n      // Sort for deterministic output (helps cache hits + diffability).\n      files.sort();\n      const body =\n        files.length === 0\n          ? '/* @triggery/vite: no *.trigger.* files matched */\\n'\n          : `${files.map((f) => `import ${JSON.stringify(f)};`).join('\\n')}\\n`;\n      return `${body}export {};\\n`;\n    },\n    handleHotUpdate(ctx) {\n      // For new / removed / renamed trigger files we have to rebuild the\n      // virtual module's import list. Edits to existing trigger files are\n      // already HMR'd by Vite directly — the file's createTrigger call runs\n      // again, last-mount-wins replaces the registration.\n      if (!isTriggerFile(ctx.file)) return;\n      const mod = ctx.server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);\n      if (mod) ctx.server.moduleGraph.invalidateModule(mod);\n    },\n  };\n}\n\nexport default triggery;\n"]}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@triggery/vite",
+  "version": "0.1.0",
+  "description": "Vite plugin for Triggery — auto-import every *.trigger.ts file via a virtual module",
+  "license": "MIT",
+  "author": "Aleksey Skhomenko",
+  "homepage": "https://triggeryjs.github.io/triggery",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triggeryjs/triggery.git",
+    "directory": "packages/vite"
+  },
+  "bugs": "https://github.com/triggeryjs/triggery/issues",
+  "funding": [
+    {
+      "type": "patreon",
+      "url": "https://www.patreon.com/triggery"
+    },
+    {
+      "type": "boosty",
+      "url": "https://boosty.to/triggery"
+    }
+  ],
+  "keywords": [
+    "triggery",
+    "vite-plugin",
+    "auto-discovery",
+    "virtual-module",
+    "hmr"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tinyglobby": "^0.2.10"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.13",
+    "vitest": "^4.1.6"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}