preact-alchemy 1.0.0 → 1.2.0

package/dist/vite.d.ts

@@ -1,5 +1,16 @@
-import { Plugin } from 'vite';
+import * as magic_string from 'magic-string';
 
-declare function preactAlchemy(): Plugin;
+type PreactAlchemyOptions = {
+    include?: RegExp;
+    exclude?: RegExp;
+};
+declare function preactAlchemy(options?: PreactAlchemyOptions): {
+    name: string;
+    enforce: "post";
+    transform(this: unknown, code: string, id: string): {
+        code: string;
+        map: magic_string.SourceMap | null;
+    } | null;
+};
 
-export { preactAlchemy as default };
+export { type PreactAlchemyOptions, preactAlchemy as default };

package/dist/vite.js

@@ -3,16 +3,19 @@ import {
 } from "./chunk-JSNOUUYJ.js";
 
 // src/vite.ts
-var defaultInclude = /\.(?:mjs|cjs|js|jsx|mts|cts|ts|tsx)$/;
-function preactAlchemy() {
+function preactAlchemy(options = {}) {
+  const {
+    include = /\.(?:mjs|cjs|js|jsx|mts|cts|ts|tsx)$/,
+    exclude = /node_modules/
+  } = options;
   return {
     name: "preact-alchemy",
     enforce: "post",
     transform(code, id) {
       if (id.startsWith("\0")) return null;
       const cleanId = id.split("?")[0];
-      if (!defaultInclude.test(cleanId)) return null;
-      if (cleanId.includes("node_modules")) return null;
+      if (!include.test(cleanId)) return null;
+      if (exclude.test(cleanId)) return null;
       if (!code.includes("use alchemy")) return null;
       const result = transform(code, cleanId);
       if (result.code === code) return null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "preact-alchemy",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",

package/readme.md

@@ -100,7 +100,7 @@ b = __alchemy_signal(b)
 
 ## Vite plugin
 
-Use the built-in Vite plugin for zero-config integration:
+Our Vite plugin should work with Vite, Rolldown, and Rollup. You don't need Vite installed to use it.
 
 ```ts
 // vite.config.ts
@@ -119,6 +119,45 @@ The plugin:
 - Skips files in `node_modules`.
 - Only transforms files that include the `"use alchemy"` directive.
 
+## Esbuild plugin
+
+Use the built-in esbuild plugin when you want to integrate with esbuild or tools
+built on top of it:
+
+```sh
+pnpm add @preact-alchemy/esbuild-plugin
+```
+
+```ts
+import { build } from 'esbuild'
+import preactAlchemy from '@preact-alchemy/esbuild-plugin'
+
+await build({
+  entryPoints: ['src/index.tsx'],
+  bundle: true,
+  plugins: [preactAlchemy()],
+})
+```
+
+The plugin:
+
+- Runs after TypeScript/JSX are compiled to JavaScript (via `onTransform`).
+- Applies to `.js/.jsx/.mjs/.cjs/.ts/.tsx/.mts/.cts` files.
+- Skips files in `node_modules` by default.
+- Only transforms files that include the `"use alchemy"` directive.
+
+### Options
+
+```ts
+type PreactAlchemyEsbuildOptions = {
+  include?: RegExp
+  exclude?: RegExp
+}
+```
+
+- `include`: RegExp to opt into files (defaults to common JS/TS extensions).
+- `exclude`: RegExp to skip files (defaults to `/node_modules/`).
+
 ## Programmatic API
 
 ```ts