@pikacss/unplugin-pikacss 0.0.57 → 0.0.59

package/README.md

@@ -2,7 +2,7 @@
 
 Universal bundler plugin for PikaCSS. Supports Vite, Webpack, Rspack, Rollup, Rolldown, and esbuild.
 
-The Vite entry supports Vite 7 and 8 only.
+PikaCSS requires Node.js 22 or later (package engine range: `>=22`). The Vite entry supports Vite 7 and 8 only.
 
 ## Installation
 
@@ -28,12 +28,29 @@ export default defineConfig({
 
 ### Other bundlers
 
+Use the entry point matching your bundler:
+
+| Bundler | Entry point |
+|---|---|
+| Rollup | `@pikacss/unplugin-pikacss/rollup` |
+| Rolldown | `@pikacss/unplugin-pikacss/rolldown` |
+| Webpack | `@pikacss/unplugin-pikacss/webpack` |
+| Rspack | `@pikacss/unplugin-pikacss/rspack` |
+| esbuild | `@pikacss/unplugin-pikacss/esbuild` |
+
+For example:
+
 ```ts
+// rollup.config.ts
 import pikacss from '@pikacss/unplugin-pikacss/rollup'
-import pikacss from '@pikacss/unplugin-pikacss/rspack'
-import pikacss from '@pikacss/unplugin-pikacss/webpack'
+
+export default {
+  plugins: [pikacss()],
+}
 ```
 
+See the integration guide for bundler-specific configuration details.
+
 ## Documentation
 
 See the [full documentation](https://pikacss.github.io/integrations/unplugin).

package/dist/esbuild.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 import * as _$unplugin from "unplugin";
 export * from "@pikacss/integration";
 
@@ -21,4 +21,4 @@ export * from "@pikacss/integration";
  */
 declare const _default: (options?: PluginOptions | undefined) => _$unplugin.EsbuildPlugin;
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, _default as default };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, _default as default };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 import * as _$unplugin from "unplugin";
 import { UnpluginFactory } from "unplugin";
 export * from "@pikacss/integration";
@@ -9,7 +9,7 @@ export * from "@pikacss/integration";
  *
  * @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.
+ * @returns An unplugin hooks object consumed by the exported bundler adapters.
  *
  * @remarks
  * This is the core entry-point called by `createUnplugin`. It resolves user options,
@@ -47,4 +47,4 @@ declare const unpluginFactory: UnpluginFactory<PluginOptions | undefined>;
  */
 declare const unpluginPika: _$unplugin.UnpluginInstance<PluginOptions | undefined, boolean>;
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, unpluginPika as default, unpluginPika, unpluginFactory };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, unpluginPika as default, unpluginPika, unpluginFactory };

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
 import process from "node:process";
-import { createCtx, log } from "@pikacss/integration";
+import { consoleDiagnosticHandler, createCtx, log } from "@pikacss/integration";
 import { resolve } from "pathe";
 import { debounce } from "perfect-debounce";
 import { createUnplugin } from "unplugin";
@@ -13,7 +14,7 @@ const PLUGIN_NAME = "unplugin-pikacss";
 *
 * @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.
+* @returns An unplugin hooks object consumed by the exported bundler adapters.
 *
 * @remarks
 * This is the core entry-point called by `createUnplugin`. It resolves user options,
@@ -32,7 +33,9 @@ const PLUGIN_NAME = "unplugin-pikacss";
 * ```
 */
 const unpluginFactory = (options, meta) => {
-	const { cwd: userCwd, currentPackageName = "@pikacss/unplugin-pikacss", config: configOrPath, tsCodegen = true, cssCodegen = true, scan = {}, fnName = "pika", transformedFormat = "string", autoCreateConfig = false } = options ?? {};
+	const { cwd: userCwd, currentPackageName = "@pikacss/unplugin-pikacss", config: configOrPath, tsCodegen = true, cssCodegen = true, scan = {}, fnName = "pika", transformedFormat = "string", autoCreateConfig = false, report = false } = options ?? {};
+	const reportEnabled = report === true || typeof report === "object" && report != null;
+	const reportOutputPath = typeof report === "object" && report != null ? report.output : void 0;
 	log.debug("Creating unplugin factory with options:", options);
 	const resolvedOptions = {
 		currentPackageName,
@@ -58,10 +61,35 @@ const unpluginFactory = (options, meta) => {
 	let mode = "build";
 	const viteServers = [];
 	const rspackCompilers = [];
+	const collectedErrors = [];
+	let currentModuleId = null;
+	const onDiagnostic = (diagnostic) => {
+		consoleDiagnosticHandler(diagnostic);
+		if (diagnostic.level === "error") collectedErrors.push({
+			diagnostic,
+			moduleId: currentModuleId
+		});
+	};
 	const ctx = createCtx({
 		cwd: resolve(userCwd ?? process.cwd()),
-		...resolvedOptions
+		...resolvedOptions,
+		onDiagnostic
 	});
+	async function emitTokenReport() {
+		const reportFn = ctx.engine.designTokens?.report;
+		if (typeof reportFn !== "function") {
+			log.debug("Design-token report requested, but no design-tokens plugin surface is present.");
+			return;
+		}
+		const result = reportFn();
+		log.info(`[design-tokens] ${result.totalTokens} tokens, ${result.used.length} used, ${result.unused.length} unused`);
+		log.info(`[design-tokens] ${result.deprecatedInUse.length} deprecated in use, ${result.strictViolations.error} strict error(s), ${result.strictViolations.warning} strict warning(s)`);
+		if (reportOutputPath != null) {
+			const outPath = resolve(ctx.cwd, reportOutputPath);
+			await writeFile(outPath, `${JSON.stringify(result, null, 2)}\n`, "utf-8");
+			log.info(`[design-tokens] report written to ${outPath}`);
+		}
+	}
 	function applyRuntimeContext(nextCwd, nextMode) {
 		if (userCwd == null) ctx.cwd = resolve(nextCwd);
 		mode = nextMode;
@@ -243,9 +271,11 @@ const unpluginFactory = (options, meta) => {
 					this.addWatchFile(ctx.resolvedConfigPath);
 					log.debug(`Added watch file: ${ctx.resolvedConfigPath}`);
 				}
+				currentModuleId = id;
 				try {
 					return await ctx.transform(code, id);
 				} finally {
+					currentModuleId = null;
 					if (ctx.isIdle) await flushPendingGeneratedWrites();
 				}
 			}
@@ -254,6 +284,14 @@ const unpluginFactory = (options, meta) => {
 			if (mode !== "build") return;
 			await ctx.waitForIdle();
 			for (const file of ctx.getScannedButNotTransformedFiles()) log.warn(`Styles from ${file} were included in the generated CSS but the file was never reached by the bundler — dead file or missing import?`);
+			if (reportEnabled) await emitTokenReport();
+			if (collectedErrors.length > 0) {
+				const details = collectedErrors.map(({ diagnostic, moduleId }) => {
+					const where = moduleId != null ? ` (${moduleId})` : "";
+					return `  - ${diagnostic.plugin != null ? `[${diagnostic.plugin}] ` : ""}${diagnostic.code}${where}: ${diagnostic.message}`;
+				}).join("\n");
+				throw new Error(`PikaCSS reported ${collectedErrors.length} error diagnostic(s):\n${details}`);
+			}
 		},
 		watchChange(id, change) {
 			if (change?.event === "delete") {

package/dist/rolldown.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 export * from "@pikacss/integration";
 
 //#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.12_@emnapi+core@1.11.1_@emnapi+runtime@1.11.1/node_modules/rolldown/dist/shared/logging-C6h4g8dA.d.mts
@@ -5745,4 +5745,4 @@ interface InputOptions {
  */
 declare const _default: (options?: PluginOptions | undefined) => Plugin<any> | Plugin<any>[];
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, _default as default };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, _default as default };

package/dist/rollup.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 import * as _$unplugin from "unplugin";
 export * from "@pikacss/integration";
 
@@ -21,4 +21,4 @@ export * from "@pikacss/integration";
  */
 declare const _default: (options?: PluginOptions | undefined) => _$unplugin.RollupPlugin<any> | _$unplugin.RollupPlugin<any>[];
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, _default as default };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, _default as default };

package/dist/rspack.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 export * from "@pikacss/integration";
 
 //#region src/rspack.d.ts
@@ -20,4 +20,4 @@ export * from "@pikacss/integration";
  */
 declare const _default: (options?: PluginOptions | undefined) => RspackPluginInstance;
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, _default as default };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, _default as default };

package/dist/{types-ekE7tO8H.d.mts → types-CBBDRP-6.d.mts}

@@ -1,6 +1,31 @@
 import { EngineConfig, IntegrationContextOptions, Nullish } from "@pikacss/integration";
 
 //#region src/types.d.ts
+/**
+ * Glob patterns controlling which source files are scanned for `pika()` calls.
+ *
+ * @remarks
+ * Explicit `include` or `exclude` values replace the corresponding defaults verbatim;
+ * they are not merged with the default patterns.
+ */
+interface ScanOptions {
+  /**
+   * File glob patterns to scan. Supports a single string or array of strings.
+   * When omitted, the default covers every extension the AST compiler
+   * supports: the full JS family plus Vue SFCs.
+   *
+   * @default ['**\/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue}']
+   */
+  include?: string | string[];
+  /**
+   * File glob patterns to exclude. Supports a single string or array of strings.
+   * The default skips dependencies, build outputs, coverage, VCS metadata, and
+   * framework build dirs (`.nuxt`/`.output`).
+   *
+   * @default ['node_modules/**', 'dist/**', '.git/**', '.nuxt/**', '.output/**', 'coverage/**']
+   */
+  exclude?: string | string[];
+}
 /**
  * User-facing configuration options for the PikaCSS bundler plugin.
  *
@@ -39,22 +64,7 @@ interface PluginOptions {
    *
    * @default `{ include: ['**\/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue}'], exclude: ['node_modules/**', 'dist/**', '.git/**', '.nuxt/**', '.output/**', 'coverage/**'] }`
    */
-  scan?: {
-    /**
-     * File glob patterns to scan. Supports a single string or array of strings.
-     * When omitted, the default covers every extension the AST compiler
-     * supports: the full JS family plus Vue SFCs. An explicit value wins verbatim.
-     * @default ['**\/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue}']
-     */
-    include?: string | string[];
-    /**
-     * File glob patterns to exclude. Supports a single string or array of strings.
-     * The default skips dependencies, build outputs, coverage, VCS metadata, and
-     * framework build dirs (`.nuxt`/`.output`). An explicit value wins verbatim.
-     * @default ['node_modules/**', 'dist/**', '.git/**', '.nuxt/**', '.output/**', 'coverage/**']
-     */
-    exclude?: string | string[];
-  };
+  scan?: ScanOptions;
   /**
    * Engine configuration object or a path to a `pika.config.*` file. When omitted, the plugin
    * auto-discovers a config file in the project root.
@@ -108,6 +118,22 @@ interface PluginOptions {
    * @default `'@pikacss/unplugin-pikacss'`
    */
   currentPackageName?: string;
+  /**
+   * Emit a design-token usage report at the end of a production build. Requires
+   * `@pikacss/plugin-design-tokens` to be registered; a no-op otherwise.
+   *
+   * @remarks
+   * `true` logs a concise summary (total tokens, used/unused counts, deprecated
+   * tokens in use, and strict-violation counts) once per build. Passing
+   * `{ output }` additionally writes the full report as JSON to that path,
+   * resolved against the project root. The report is emitted only in build mode,
+   * so a dev server never spams it per HMR update.
+   *
+   * @default `false` (no report)
+   */
+  report?: boolean | {
+    /** File path (resolved against the project root) to write the full report JSON to. */output?: string;
+  };
 }
 /**
  * Normalized plugin configuration with all defaults applied and boolean shorthands expanded.
@@ -136,4 +162,4 @@ interface ResolvedPluginOptions {
   autoCreateConfig: boolean;
 }
 //#endregion
-export { ResolvedPluginOptions as n, PluginOptions as t };
+export { ResolvedPluginOptions as n, ScanOptions as r, PluginOptions as t };

package/dist/vite.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 import { Plugin } from "vite";
 export * from "@pikacss/integration";
 
@@ -23,4 +23,4 @@ export * from "@pikacss/integration";
  */
 declare const _default: (options?: PluginOptions) => Plugin;
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, _default as default };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, _default as default };

package/dist/webpack.d.mts

@@ -1,4 +1,4 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-ekE7tO8H.mjs";
+import { n as ResolvedPluginOptions, r as ScanOptions, t as PluginOptions } from "./types-CBBDRP-6.mjs";
 export * from "@pikacss/integration";
 
 //#region src/webpack.d.ts
@@ -20,4 +20,4 @@ export * from "@pikacss/integration";
  */
 declare const _default: (options?: PluginOptions | undefined) => WebpackPluginInstance;
 //#endregion
-export { PluginOptions, ResolvedPluginOptions, _default as default };
+export { PluginOptions, ResolvedPluginOptions, ScanOptions, _default as default };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pikacss/unplugin-pikacss",
   "type": "module",
-  "version": "0.0.57",
+  "version": "0.0.59",
   "author": "DevilTea <ch19980814@gmail.com>",
   "license": "MIT",
   "homepage": "https://pikacss.github.io",
@@ -94,7 +94,7 @@
     "pathe": "^2.0.3",
     "perfect-debounce": "^2.1.0",
     "unplugin": "^3.3.0",
-    "@pikacss/integration": "0.0.57"
+    "@pikacss/integration": "0.0.59"
   },
   "devDependencies": {
     "esbuild": "^0.28.1",