unplugin-gem 0.1.0

package/README.md

@@ -0,0 +1,100 @@
+# unplugin-gem
+
+Universal plugin for [Gem](https://github.com/mantou132/gem) element transformations.
+
+Supports **Vite**, **Webpack**, **Rollup**, **esbuild**, **Rspack**, **Farm**, and **Rolldown** through a single unified API.
+
+## Features
+
+- 🔄 **Auto Import** - Automatically import Gem APIs
+- 🎨 **CSS Minification** - Minify CSS in `css`` template literals
+- 🔍 **Selector Compatible** - Transform `&:hover` for Shadow DOM compatibility
+- 📦 **Resource Preload** - Preload resources with `?preload` query
+- 🔥 **HMR Support** - Hot module replacement (experimental)
+- 🛠️ **Universal** - Works with all major bundlers
+
+## Installation
+
+```bash
+npm install unplugin-gem
+# or
+pnpm add unplugin-gem
+# or
+yarn add unplugin-gem
+```
+
+## Usage
+
+### Vite
+
+```ts
+// vite.config.ts
+import gemPlugin from 'unplugin-gem/vite'
+
+export default {
+  plugins: [
+    gemPlugin({
+      autoImport: true,
+      selectorCompatible: true,
+      styleMinify: true,
+    }),
+  ],
+}
+```
+
+### Webpack
+
+```js
+// webpack.config.js
+const gemPlugin = require('unplugin-gem/webpack')
+
+module.exports = {
+  plugins: [
+    gemPlugin({
+      autoImport: true,
+      selectorCompatible: true,
+    }),
+  ],
+}
+```
+
+### Rollup
+
+```js
+// rollup.config.js
+import gemPlugin from 'unplugin-gem/rollup'
+
+export default {
+  plugins: [
+    gemPlugin({
+      autoImport: true,
+      selectorCompatible: true,
+    }),
+  ],
+}
+```
+
+### esbuild
+
+```js
+// esbuild.config.js
+import { build } from 'esbuild'
+import gemPlugin from 'unplugin-gem/esbuild'
+
+build({
+  plugins: [
+    gemPlugin({
+      autoImport: true,
+      selectorCompatible: true,
+    }),
+  ],
+})
+```
+
+## How It Works
+
+This plugin wraps [swc-plugin-gem](https://github.com/mantou132/gem/tree/main/crates/swc-plugin-gem) and uses [unplugin](https://github.com/unjs/unplugin) to provide universal bundler support.
+
+## License
+
+MIT

package/dist/esbuild.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => import("esbuild").Plugin;
+export default _default;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":";AAEA,wBAAmC"}

package/dist/esbuild.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.esbuild;
+//# sourceMappingURL=esbuild.js.map

package/dist/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,OAAO,CAAC"}

package/dist/farm.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => JsPlugin;
+export default _default;
+//# sourceMappingURL=farm.d.ts.map

package/dist/farm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm.d.ts","sourceRoot":"","sources":["../src/farm.ts"],"names":[],"mappings":";AAEA,wBAAgC"}

package/dist/farm.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.farm;
+//# sourceMappingURL=farm.js.map

package/dist/farm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm.js","sourceRoot":"","sources":["../src/farm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,IAAI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { UnpluginGemOptions } from './types';
+export type { UnpluginGemOptions } from './types';
+export declare const unpluginGem: import("unplugin").UnpluginInstance<UnpluginGemOptions | undefined, boolean>;
+export default unpluginGem;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,eAAO,MAAM,WAAW,8EAsDtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+import { transform } from '@swc/core';
+import { createUnplugin } from 'unplugin';
+const TRANSFORM_EXTENSIONS = /\.(tsx?|jsx?)$/;
+export const unpluginGem = createUnplugin((options = {}) => {
+    return {
+        name: 'unplugin-gem',
+        transformInclude(id) {
+            return TRANSFORM_EXTENSIONS.test(id);
+        },
+        async transform(code, id) {
+            try {
+                const result = await transform(code, {
+                    filename: id,
+                    sourceMaps: true,
+                    jsc: {
+                        parser: {
+                            syntax: id.endsWith('.tsx') || id.endsWith('.ts') ? 'typescript' : 'ecmascript',
+                            tsx: id.endsWith('.tsx'),
+                            jsx: id.endsWith('.jsx'),
+                            decorators: true,
+                        },
+                        transform: {
+                            decoratorVersion: '2022-03',
+                        },
+                        externalHelpers: true,
+                        target: 'es2022',
+                        experimental: {
+                            runPluginFirst: true,
+                            plugins: [
+                                [
+                                    'swc-plugin-gem',
+                                    {
+                                        styleMinify: options.styleMinify ?? false,
+                                        autoImport: options.autoImport ?? false,
+                                        autoImportDts: options.autoImportDts ?? false,
+                                        resolvePath: options.resolvePath ?? false,
+                                        preload: options.preload ?? false,
+                                        hmr: options.hmr ?? false,
+                                        selectorCompatible: options.selectorCompatible ?? false,
+                                    },
+                                ],
+                            ],
+                        },
+                    },
+                });
+                return {
+                    code: result.code,
+                    map: result.map,
+                };
+            }
+            catch (error) {
+                this.error(`Failed to transform ${id}: ${error}`);
+            }
+        },
+    };
+});
+export default unpluginGem;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM1C,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAiC,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE;IACzF,OAAO;QACL,IAAI,EAAE,cAAc;QAEpB,gBAAgB,CAAC,EAAE;YACjB,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE;oBACnC,QAAQ,EAAE,EAAE;oBACZ,UAAU,EAAE,IAAI;oBAChB,GAAG,EAAE;wBACH,MAAM,EAAE;4BACN,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;4BAC/E,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;4BACxB,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;4BACxB,UAAU,EAAE,IAAI;yBACjB;wBACD,SAAS,EAAE;4BACT,gBAAgB,EAAE,SAAS;yBAC5B;wBACD,eAAe,EAAE,IAAI;wBACrB,MAAM,EAAE,QAAQ;wBAChB,YAAY,EAAE;4BACZ,cAAc,EAAE,IAAI;4BACpB,OAAO,EAAE;gCACP;oCACE,gBAAgB;oCAChB;wCACE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;wCACzC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;wCACvC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,KAAK;wCAC7C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;wCACzC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;wCACjC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;wCACzB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,KAAK;qCACxD;iCACF;6BACF;yBACF;qBACF;iBACF,CAAC,CAAC;gBAEH,OAAO;oBACL,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,GAAG,EAAE,MAAM,CAAC,GAAG;iBAChB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/rolldown.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => any;
+export default _default;
+//# sourceMappingURL=rolldown.d.ts.map

package/dist/rolldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown.d.ts","sourceRoot":"","sources":["../src/rolldown.ts"],"names":[],"mappings":";AAEA,wBAAoC"}

package/dist/rolldown.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.rolldown;
+//# sourceMappingURL=rolldown.js.map

package/dist/rolldown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown.js","sourceRoot":"","sources":["../src/rolldown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,QAAQ,CAAC"}

package/dist/rollup.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
+export default _default;
+//# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":";AAEA,wBAAkC"}

package/dist/rollup.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.rollup;
+//# sourceMappingURL=rollup.js.map

package/dist/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,MAAM,CAAC"}

package/dist/rspack.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => import("unplugin").RspackPluginInstance;
+export default _default;
+//# sourceMappingURL=rspack.d.ts.map

package/dist/rspack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rspack.d.ts","sourceRoot":"","sources":["../src/rspack.ts"],"names":[],"mappings":";AAEA,wBAAkC"}

package/dist/rspack.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.rspack;
+//# sourceMappingURL=rspack.js.map

package/dist/rspack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rspack.js","sourceRoot":"","sources":["../src/rspack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,MAAM,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Auto import configuration
+ */
+export type AutoImportConfig = boolean | {
+    extends?: 'gem';
+    members?: Record<string, string[]>;
+};
+/**
+ * Auto import .d.ts generation
+ */
+export type AutoImportDts = boolean | string;
+/**
+ * Plugin options matching swc-plugin-gem configuration
+ */
+export interface UnpluginGemOptions {
+    /**
+     * Minify CSS in css`` template literals
+     * @default false
+     */
+    styleMinify?: boolean;
+    /**
+     * Auto import Gem APIs
+     * @default false
+     * @example
+     * ```ts
+     * {
+     *   autoImport: {
+     *     extends: 'gem',
+     *     members: {
+     *       'my-package': ['myFunction']
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    autoImport?: AutoImportConfig;
+    /**
+     * Generate .d.ts file for auto imports
+     * @default false
+     * @example
+     * ```ts
+     * // true -> src/auto-import.d.ts
+     * // string -> custom path
+     * autoImportDts: 'src/types/auto-import.d.ts'
+     * ```
+     */
+    autoImportDts?: AutoImportDts;
+    /**
+     * Resolve import paths to full ESM paths
+     * @default false
+     */
+    resolvePath?: boolean;
+    /**
+     * Enable resource preloading with ?preload query
+     * @default false
+     */
+    preload?: boolean;
+    /**
+     * Enable HMR support (experimental)
+     * @default false
+     */
+    hmr?: boolean;
+    /**
+     * Support `&:hover` in shadow DOM and light DOM
+     * Transform to `:is(&:hover,:host(:hover))`
+     * @default false
+     */
+    selectorCompatible?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP;IACE,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/vite.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => import("vite").Plugin<any> | import("vite").Plugin<any>[];
+export default _default;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":";AAEA,wBAAgC"}

package/dist/vite.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.vite;
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,IAAI,CAAC"}

package/dist/webpack.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (options?: import("./types").UnpluginGemOptions | undefined) => import("webpack").WebpackPluginInstance;
+export default _default;
+//# sourceMappingURL=webpack.d.ts.map

package/dist/webpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpack.d.ts","sourceRoot":"","sources":["../src/webpack.ts"],"names":[],"mappings":";AAEA,wBAAmC"}

package/dist/webpack.js

@@ -0,0 +1,3 @@
+import { unpluginGem } from './index';
+export default unpluginGem.webpack;
+//# sourceMappingURL=webpack.js.map

package/dist/webpack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpack.js","sourceRoot":"","sources":["../src/webpack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAe,WAAW,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "unplugin-gem",
+  "version": "0.1.0",
+  "description": "Universal plugin for Gem element transformations (Vite/Webpack/Rollup/esbuild)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    },
+    "./webpack": {
+      "types": "./dist/webpack.d.ts",
+      "import": "./dist/webpack.js"
+    },
+    "./rollup": {
+      "types": "./dist/rollup.d.ts",
+      "import": "./dist/rollup.js"
+    },
+    "./esbuild": {
+      "types": "./dist/esbuild.d.ts",
+      "import": "./dist/esbuild.js"
+    },
+    "./rspack": {
+      "types": "./dist/rspack.d.ts",
+      "import": "./dist/rspack.js"
+    },
+    "./farm": {
+      "types": "./dist/farm.d.ts",
+      "import": "./dist/farm.js"
+    },
+    "./rolldown": {
+      "types": "./dist/rolldown.d.ts",
+      "import": "./dist/rolldown.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "pnpm build --watch",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "unplugin",
+    "vite",
+    "webpack",
+    "rollup",
+    "esbuild",
+    "gem",
+    "web-components",
+    "swc"
+  ],
+  "author": "mantou132",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mantou132/gem.git",
+    "directory": "packages/unplugin-gem"
+  },
+  "bugs": {
+    "url": "https://github.com/mantou132/gem/issues"
+  },
+  "homepage": "https://github.com/mantou132/gem#readme",
+  "dependencies": {
+    "@swc/core": "^1.9.3",
+    "@swc/helpers": "^0.5.21",
+    "unplugin": "^3.0.0"
+  },
+  "devDependencies": {
+    "@gemjs/config": "^2.1.2",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.6.2"
+  },
+  "peerDependencies": {
+    "esbuild": ">=0.20.0",
+    "rollup": ">=3.0.0",
+    "vite": ">=4.0.0",
+    "webpack": ">=5.0.0",
+    "@rspack/core": ">=0.0.0",
+    "@farmfe/core": ">=0.0.0",
+    "rolldown": ">=0.0.0"
+  },
+  "peerDependenciesMeta": {
+    "esbuild": {
+      "optional": true
+    },
+    "rollup": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    },
+    "@rspack/core": {
+      "optional": true
+    },
+    "@farmfe/core": {
+      "optional": true
+    },
+    "rolldown": {
+      "optional": true
+    }
+  }
+}