@pikacss/unplugin-pikacss 0.0.46 → 0.0.48

package/README.md

@@ -0,0 +1,43 @@
+# @pikacss/unplugin-pikacss
+
+Universal bundler plugin for PikaCSS. Supports Vite, Webpack, Rspack, Rollup, Rolldown, and esbuild.
+
+The Vite entry supports Vite 7 and 8 only.
+
+## Installation
+
+```bash
+pnpm add -D @pikacss/unplugin-pikacss
+```
+
+When using the `@pikacss/unplugin-pikacss/vite` entry, install Vite 7 or 8.
+
+## Usage
+
+### Vite
+
+```ts
+// vite.config.ts
+import pikacss from '@pikacss/unplugin-pikacss/vite'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [pikacss()],
+})
+```
+
+### Other bundlers
+
+```ts
+import pikacss from '@pikacss/unplugin-pikacss/rollup'
+import pikacss from '@pikacss/unplugin-pikacss/rspack'
+import pikacss from '@pikacss/unplugin-pikacss/webpack'
+```
+
+## Documentation
+
+See the [full documentation](https://pikacss.com/guide/integrations/vite).
+
+## License
+
+MIT

package/dist/esbuild.d.mts

@@ -1,8 +1,24 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-Cjx5DuB2.mjs";
-import * as unplugin from "unplugin";
+import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-237J7YdE.mjs";
+import * as _$unplugin from "unplugin";
 export * from "@pikacss/integration";
 
 //#region src/esbuild.d.ts
-declare const _default: (options?: PluginOptions | undefined) => unplugin.EsbuildPlugin;
+/**
+ * PikaCSS plugin factory for esbuild.
+ *
+ * Wraps the shared PikaCSS unplugin factory into an esbuild-compatible
+ * plugin. Accepts optional {@link PluginOptions} to configure scanning,
+ * code generation, and engine settings.
+ *
+ * @example
+ * ```ts
+ * import pikacss from '@pikacss/unplugin-pikacss/esbuild'
+ *
+ * await esbuild.build({
+ *   plugins: [pikacss()],
+ * })
+ * ```
+ */
+declare const _default: (options?: PluginOptions | undefined) => _$unplugin.EsbuildPlugin;
 //#endregion
 export { PluginOptions, ResolvedPluginOptions, _default as default };

package/dist/esbuild.mjs

@@ -1,10 +1,23 @@
 import { unpluginFactory } from "./index.mjs";
 import { createEsbuildPlugin } from "unplugin";
-
-export * from "@pikacss/integration"
-
+export * from "@pikacss/integration";
 //#region src/esbuild.ts
+/**
+* PikaCSS plugin factory for esbuild.
+*
+* Wraps the shared PikaCSS unplugin factory into an esbuild-compatible
+* plugin. Accepts optional {@link PluginOptions} to configure scanning,
+* code generation, and engine settings.
+*
+* @example
+* ```ts
+* import pikacss from '@pikacss/unplugin-pikacss/esbuild'
+*
+* await esbuild.build({
+*   plugins: [pikacss()],
+* })
+* ```
+*/
 var esbuild_default = createEsbuildPlugin(unpluginFactory);
-
 //#endregion
-export { esbuild_default as default };
+export { esbuild_default as default };

package/dist/index.d.mts

@@ -1,10 +1,47 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-Cjx5DuB2.mjs";
-import * as unplugin from "unplugin";
+import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-237J7YdE.mjs";
+import * as _$unplugin from "unplugin";
 import { UnpluginFactory } from "unplugin";
 export * from "@pikacss/integration";
 
 //#region src/index.d.ts
+/**
+ * Factory function that produces the bundler-agnostic PikaCSS plugin hooks.
+ *
+ * @param options - User-supplied plugin configuration. When `undefined`, all defaults apply.
+ * @param meta - Unplugin metadata providing the target bundler framework name.
+ * @returns An unplugin hooks object consumed by Vite, webpack, Rollup, esbuild, and Rspack.
+ *
+ * @remarks
+ * This is the core entry-point called by `createUnplugin`. It resolves user options,
+ * creates an integration context via `createCtx`, and wires bundler-specific lifecycle
+ * hooks (config resolution, dev-server HMR, build transforms, and config file watching).
+ *
+ * @example
+ * ```ts
+ * import { unpluginFactory } from '@pikacss/unplugin-pikacss'
+ * import { createUnplugin } from 'unplugin'
+ *
+ * const plugin = createUnplugin(unpluginFactory)
+ * ```
+ */
 declare const unpluginFactory: UnpluginFactory<PluginOptions | undefined>;
-declare const unpluginPika: unplugin.UnpluginInstance<PluginOptions | undefined, boolean>;
+/**
+ * Pre-built universal bundler plugin for PikaCSS.
+ *
+ * @remarks
+ * Created by passing `unpluginFactory` to `createUnplugin`. Import the bundler-specific
+ * sub-path (e.g., `@pikacss/unplugin-pikacss/vite`) for a ready-to-use plugin instance.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import pika from '@pikacss/unplugin-pikacss/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [pika()],
+ * })
+ * ```
+ */
+declare const unpluginPika: _$unplugin.UnpluginInstance<PluginOptions | undefined, boolean>;
 //#endregion
 export { PluginOptions, ResolvedPluginOptions, unpluginPika as default, unpluginPika, unpluginFactory };

package/dist/index.mjs

@@ -4,14 +4,32 @@ import { createCtx, log } from "@pikacss/integration";
 import { resolve } from "pathe";
 import { debounce } from "perfect-debounce";
 import { createUnplugin } from "unplugin";
-
-export * from "@pikacss/integration"
-
+export * from "@pikacss/integration";
 //#region src/index.ts
 const RE_VIRTUAL_PIKA_CSS_ID = /^pika\.css$/;
 const PLUGIN_NAME = "unplugin-pikacss";
+/**
+* Factory function that produces the bundler-agnostic PikaCSS plugin hooks.
+*
+* @param options - User-supplied plugin configuration. When `undefined`, all defaults apply.
+* @param meta - Unplugin metadata providing the target bundler framework name.
+* @returns An unplugin hooks object consumed by Vite, webpack, Rollup, esbuild, and Rspack.
+*
+* @remarks
+* This is the core entry-point called by `createUnplugin`. It resolves user options,
+* creates an integration context via `createCtx`, and wires bundler-specific lifecycle
+* hooks (config resolution, dev-server HMR, build transforms, and config file watching).
+*
+* @example
+* ```ts
+* import { unpluginFactory } from '@pikacss/unplugin-pikacss'
+* import { createUnplugin } from 'unplugin'
+*
+* const plugin = createUnplugin(unpluginFactory)
+* ```
+*/
 const unpluginFactory = (options, meta) => {
-	const { currentPackageName = "@pikacss/unplugin-pikacss", config: configOrPath, tsCodegen = true, cssCodegen = true, scan = {}, fnName = "pika", transformedFormat = "string", autoCreateConfig = true } = options ?? {};
+	const { cwd: userCwd, currentPackageName = "@pikacss/unplugin-pikacss", config: configOrPath, tsCodegen = true, cssCodegen = true, scan = {}, fnName = "pika", transformedFormat = "string", autoCreateConfig = true } = options ?? {};
 	log.debug("Creating unplugin factory with options:", options);
 	const resolvedOptions = {
 		currentPackageName,
@@ -27,22 +45,27 @@ const unpluginFactory = (options, meta) => {
 		autoCreateConfig
 	};
 	log.debug("Resolved plugin options:", resolvedOptions);
-	let cwd = resolve(process.cwd());
 	let mode = "build";
 	const viteServers = [];
 	const rspackCompilers = [];
-	const farmServers = [];
 	const ctx = createCtx({
-		cwd,
+		cwd: resolve(userCwd ?? process.cwd()),
 		...resolvedOptions
 	});
+	function applyRuntimeContext(nextCwd, nextMode) {
+		if (userCwd == null) ctx.cwd = resolve(nextCwd);
+		mode = nextMode;
+	}
 	const debouncedWriteCssCodegenFile = debounce(async () => {
 		await ctx.writeCssCodegenFile();
 	}, 300);
 	const debouncedWriteTsCodegenFile = debounce(async () => {
 		await ctx.writeTsCodegenFile();
 	}, 300);
+	let hooksBound = false;
 	function bindHooks() {
+		if (hooksBound) return;
+		hooksBound = true;
 		ctx.hooks.styleUpdated.on(() => {
 			log.debug(`Style updated, ${ctx.engine.store.atomicStyleIds.size} atomic styles generated`);
 			debouncedWriteCssCodegenFile();
@@ -53,17 +76,17 @@ const unpluginFactory = (options, meta) => {
 		});
 	}
 	let setupPromise = Promise.resolve();
-	let setupCounter = 0;
+	let lastSetupCwd = null;
+	let pendingSetupCwd = null;
 	function setup(reload = false) {
+		pendingSetupCwd = ctx.cwd;
 		setupPromise = setupPromise.then(async () => {
 			log.debug("Setting up integration context...");
-			const currentSetup = ++setupCounter;
 			const moduleIds = Array.from(ctx.usages.keys());
+			hooksBound = false;
 			await ctx.setup();
-			if (currentSetup !== setupCounter) {
-				log.debug("Setup outdated, skipping...");
-				return;
-			}
+			lastSetupCwd = ctx.cwd;
+			pendingSetupCwd = null;
 			await debouncedWriteCssCodegenFile();
 			await debouncedWriteTsCodegenFile();
 			bindHooks();
@@ -87,49 +110,34 @@ const unpluginFactory = (options, meta) => {
 					compiler.watching.invalidateWithChangesAndRemovals(new Set(moduleIds));
 					compiler.watching.invalidate();
 				});
-				else if (meta.framework === "farm") {
-					const promises = [];
-					farmServers.forEach((server) => {
-						if (server.hmrEngine == null) return;
-						promises.push(server.hmrEngine.recompileAndSendResult());
-					});
-					await Promise.all(promises);
-				}
 			}
 		});
+		return setupPromise;
+	}
+	function ensureSetup(reload = false) {
+		if (!reload && (lastSetupCwd === ctx.cwd || pendingSetupCwd === ctx.cwd)) return setupPromise;
+		return setup(reload);
 	}
 	const debouncedSetup = debounce(setup);
-	setup();
 	return {
 		name: PLUGIN_NAME,
 		vite: {
 			configResolved: (config) => {
-				cwd = resolve(config.root);
-				mode = config.command === "serve" ? "serve" : "build";
+				applyRuntimeContext(config.root, config.command === "serve" ? "serve" : "build");
 			},
 			configureServer(server) {
 				viteServers.push(server);
 			}
 		},
 		webpack: (compiler) => {
-			cwd = resolve(compiler.options.context || process.cwd());
-			mode = compiler.options.mode === "development" ? "serve" : "build";
+			applyRuntimeContext(compiler.options.context || process.cwd(), compiler.options.mode === "development" ? "serve" : "build");
 		},
 		rspack: (compiler) => {
-			cwd = resolve(compiler.options.context || process.cwd());
-			mode = compiler.options.mode === "development" ? "serve" : "build";
-		},
-		farm: {
-			configResolved: (config) => {
-				cwd = resolve(config.root || process.cwd());
-				mode = config.envMode === "development" ? "serve" : "build";
-			},
-			configureDevServer(server) {
-				farmServers.push(server);
-			}
+			rspackCompilers.push(compiler);
+			applyRuntimeContext(compiler.options.context || process.cwd(), compiler.options.mode === "development" ? "serve" : "build");
 		},
 		esbuild: { async setup(build) {
-			cwd = resolve(build.initialOptions.absWorkingDir || process.cwd());
+			applyRuntimeContext(build.initialOptions.absWorkingDir || process.cwd(), mode);
 			build.onResolve({ filter: RE_VIRTUAL_PIKA_CSS_ID }, (args) => {
 				log.debug(`Resolved virtual CSS module: ${args.path} -> ${ctx.cssCodegenFilepath}`);
 				return {
@@ -140,8 +148,8 @@ const unpluginFactory = (options, meta) => {
 		} },
 		async buildStart() {
 			log.debug("Plugin buildStart hook triggered");
-			log.debug(`Current mode: ${mode}, cwd: ${cwd}`);
-			await setupPromise;
+			log.debug(`Current mode: ${mode}, cwd: ${ctx.cwd}`);
+			await ensureSetup();
 			if (mode === "build") {
 				log.debug("Running full CSS code generation in build mode");
 				await ctx.fullyCssCodegen();
@@ -153,7 +161,7 @@ const unpluginFactory = (options, meta) => {
 		},
 		resolveId: meta.framework === "esbuild" ? void 0 : async function(id) {
 			if (RE_VIRTUAL_PIKA_CSS_ID.test(id)) {
-				await setupPromise;
+				await ensureSetup();
 				log.debug(`Resolved virtual CSS module: ${id} -> ${ctx.cssCodegenFilepath}`);
 				return ctx.cssCodegenFilepath;
 			}
@@ -163,7 +171,8 @@ const unpluginFactory = (options, meta) => {
 			filter: { get id() {
 				return ctx.transformFilter;
 			} },
-			handler(code, id) {
+			async handler(code, id) {
+				await ensureSetup();
 				if (meta.framework === "webpack" && ctx.resolvedConfigPath != null) {
 					this.addWatchFile(ctx.resolvedConfigPath);
 					log.debug(`Added watch file: ${ctx.resolvedConfigPath}`);
@@ -179,7 +188,23 @@ const unpluginFactory = (options, meta) => {
 		}
 	};
 };
+/**
+* Pre-built universal bundler plugin for PikaCSS.
+*
+* @remarks
+* Created by passing `unpluginFactory` to `createUnplugin`. Import the bundler-specific
+* sub-path (e.g., `@pikacss/unplugin-pikacss/vite`) for a ready-to-use plugin instance.
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import pika from '@pikacss/unplugin-pikacss/vite'
+*
+* export default defineConfig({
+*   plugins: [pika()],
+* })
+* ```
+*/
 const unpluginPika = /* @__PURE__ */ createUnplugin(unpluginFactory);
-
 //#endregion
-export { unpluginPika as default, unpluginPika, unpluginFactory };
+export { unpluginPika as default, unpluginPika, unpluginFactory };