@pikacss/unplugin-pikacss 0.0.46 → 0.0.48

package/dist/rolldown.mjs

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

package/dist/rollup.d.mts

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

package/dist/rollup.mjs

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

package/dist/rspack.d.mts

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

package/dist/rspack.mjs

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

package/dist/types-237J7YdE.d.mts

@@ -0,0 +1,130 @@
+import { EngineConfig, IntegrationContextOptions, Nullish } from "@pikacss/integration";
+
+//#region src/types.d.ts
+/**
+ * User-facing configuration options for the PikaCSS bundler plugin.
+ *
+ * @remarks
+ * Passed to the unplugin factory when creating a Vite, webpack, Rollup, or esbuild plugin.
+ * All properties are optional — sensible defaults are applied for zero-config setups.
+ *
+ * @example
+ * ```ts
+ * import pika from '@pikacss/unplugin-pikacss/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     pika({
+ *       config: './pika.config.ts',
+ *       fnName: 'css',
+ *       transformedFormat: 'array',
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+interface PluginOptions {
+  /**
+   * Explicit working directory for resolving config files, codegen output paths, and source
+   * scanning globs. When set, overrides the bundler-detected project root.
+   *
+   * @remarks
+   * Resolution priority: `cwd` option → bundler root (e.g., Vite `root`, webpack `context`) → `process.cwd()`.
+   *
+   * @default `undefined` (use bundler-detected root)
+   */
+  cwd?: string;
+  /**
+   * Glob patterns controlling which source files are scanned for `pika()` calls.
+   *
+   * @default `{ include: ['**\/*.{js,ts,jsx,tsx,vue}'], exclude: ['node_modules/**', 'dist/**'] }`
+   */
+  scan?: {
+    /**
+     * File glob patterns to scan. Supports a single string or array of strings.
+     * @default ['**\/*.{js,ts,jsx,tsx,vue}']
+     */
+    include?: string | string[];
+    /**
+     * File glob patterns to exclude. Supports a single string or array of strings.
+     * @default ['node_modules/**', 'dist/**']
+     */
+    exclude?: string | string[];
+  };
+  /**
+   * Engine configuration object or a path to a `pika.config.*` file. When omitted, the plugin
+   * auto-discovers a config file in the project root.
+   *
+   * @default `undefined` (auto-discover)
+   */
+  config?: EngineConfig | string;
+  /**
+   * When `true`, automatically scaffolds a default `pika.config.js` file if no existing config is found.
+   *
+   * @default `true`
+   */
+  autoCreateConfig?: boolean;
+  /**
+   * Base function name to recognize in source code. All variants (`.str`, `.arr`, preview) are
+   * derived from this name.
+   *
+   * @default `'pika'`
+   */
+  fnName?: string;
+  /**
+   * Default output format for normal `pika()` calls. `'string'` produces a space-joined class string;
+   * `'array'` produces a string array of class names.
+   *
+   * @default `'string'`
+   */
+  transformedFormat?: 'string' | 'array';
+  /**
+   * Controls TypeScript declaration codegen. `true` writes to `'pika.gen.ts'`, a string sets a custom
+   * output path, and `false` disables codegen entirely.
+   *
+   * @default `true`
+   */
+  tsCodegen?: boolean | string;
+  /**
+   * Controls CSS output file generation. `true` writes to `'pika.gen.css'`; a string sets a custom
+   * output path.
+   *
+   * @default `true`
+   */
+  cssCodegen?: true | string;
+  /**
+   * npm package name of the plugin consumer, embedded in generated file headers and import paths.
+   * Override when wrapping the unplugin in a framework-specific package (e.g., `@pikacss/nuxt`).
+   *
+   * @default `'@pikacss/unplugin-pikacss'`
+   */
+  currentPackageName?: string;
+}
+/**
+ * Normalized plugin configuration with all defaults applied and boolean shorthands expanded.
+ *
+ * @remarks
+ * Produced internally by the unplugin factory from `PluginOptions`. Consumers should not
+ * construct this type directly — it exists so that internal helpers receive fully resolved,
+ * non-optional values.
+ */
+interface ResolvedPluginOptions {
+  /** npm package name of the integration consumer, used in generated file headers and import paths. */
+  currentPackageName: string;
+  /** Engine configuration object, a path to a config file, or `null`/`undefined` for auto-discovery. */
+  configOrPath: EngineConfig | string | Nullish;
+  /** Resolved TypeScript codegen output path, or `false` when codegen is disabled. */
+  tsCodegen: false | string;
+  /** Resolved CSS output file path (always a string after defaults are applied). */
+  cssCodegen: string;
+  /** Normalized include/exclude glob arrays controlling source file scanning. */
+  scan: IntegrationContextOptions['scan'];
+  /** Base function name to recognize in source transforms (e.g., `'pika'`). */
+  fnName: string;
+  /** Default output format for normal `pika()` calls: `'string'` or `'array'`. */
+  transformedFormat: 'string' | 'array';
+  /** Whether to scaffold a default config file when none is found. */
+  autoCreateConfig: boolean;
+}
+//#endregion
+export { ResolvedPluginOptions as n, PluginOptions as t };

package/dist/vite.d.mts

@@ -1,9 +1,24 @@
-import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-Cjx5DuB2.mjs";
-import "./index.mjs";
+import { n as ResolvedPluginOptions, t as PluginOptions } from "./types-237J7YdE.mjs";
 import { Plugin } from "vite";
 export * from "@pikacss/integration";
 
 //#region src/vite.d.ts
+/**
+ * PikaCSS plugin factory for Vite.
+ *
+ * Wraps the shared PikaCSS unplugin factory into a Vite-compatible plugin.
+ * Accepts optional {@link PluginOptions} to configure scanning, code
+ * generation, and engine settings. Returns a standard Vite `Plugin`.
+ *
+ * @example
+ * ```ts
+ * import pikacss from '@pikacss/unplugin-pikacss/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [pikacss()],
+ * })
+ * ```
+ */
 declare const _default: (options?: PluginOptions) => Plugin;
 //#endregion
 export { PluginOptions, ResolvedPluginOptions, _default as default };

package/dist/vite.mjs

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

package/dist/webpack.d.mts

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

package/dist/webpack.mjs

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@pikacss/unplugin-pikacss",
   "type": "module",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "author": "DevilTea <ch19980814@gmail.com>",
   "license": "MIT",
+  "homepage": "https://pikacss.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pikacss/pikacss.git",
+    "url": "git+https://github.com/pikacss/pikacss.git",
     "directory": "packages/unplugin"
   },
   "bugs": {
@@ -25,6 +26,7 @@
     "rspack-plugin",
     "rolldown-plugin"
   ],
+  "sideEffects": false,
   "exports": {
     ".": {
       "import": {
@@ -74,11 +76,14 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=22"
+  },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "vite": "^5.0.0 || ^6.0.0"
+    "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
     "vite": {
@@ -89,12 +94,11 @@
     "pathe": "^2.0.3",
     "perfect-debounce": "^2.1.0",
     "unplugin": "^3.0.0",
-    "@pikacss/integration": "0.0.46"
+    "@pikacss/integration": "0.0.48"
   },
   "devDependencies": {
-    "@farmfe/core": "^1.7.11",
-    "esbuild": "^0.27.3",
-    "vite": "^7.3.1"
+    "esbuild": "^0.27.4",
+    "vite": "^8.0.3"
   },
   "scripts": {
     "build": "tsdown",
@@ -102,7 +106,7 @@
     "typecheck": "pnpm typecheck:package && pnpm typecheck:test",
     "typecheck:package": "tsc --project ./tsconfig.package.json --noEmit",
     "typecheck:test": "tsc --project ./tsconfig.tests.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:watch": "vitest --config ./vitest.config.ts"
   }
 }

package/dist/types-Cjx5DuB2.d.mts

@@ -1,102 +0,0 @@
-import { EngineConfig, IntegrationContextOptions, Nullish } from "@pikacss/integration";
-
-//#region src/types.d.ts
-interface PluginOptions {
-  /**
-   * Specify file patterns to scan for detecting pika() function calls and generating atomic styles.
-   *
-   * Default values:
-   * - `include`: `['**\/*.{js,ts,jsx,tsx,vue}']` - Scans all JS/TS/Vue files by default
-   * - `exclude`: `['node_modules/**']` - Excludes node_modules by default
-   * @example
-   * scan: {
-   *   include: ['src/**\/{*.ts,*.tsx,*.vue}'],
-   *   exclude: ['node_modules/**', 'dist/**']
-   * }
-   */
-  scan?: {
-    /**
-     * File glob patterns to scan. Supports a single string or array of strings.
-     * @default ['**\/*.{js,ts,jsx,tsx,vue}']
-     */
-    include?: string | string[];
-    /**
-     * File glob patterns to exclude. Supports a single string or array of strings.
-     * @default ['node_modules/**', 'dist/**']
-     */
-    exclude?: string | string[];
-  };
-  /**
-   * Configuration object or path to a configuration file for the PikaCSS engine.
-   * Can pass a config object directly to define engine options, or a config file path (e.g., 'pika.config.ts').
-   *
-   * Behavior:
-   * - If a file path is specified but the file doesn't exist and autoCreateConfig is true, a config file will be generated at the specified path.
-   * - If an inline config object is passed, autoCreateConfig will be ignored.
-   * - If not provided and autoCreateConfig is true, a default config file will be created.
-   * @example
-   * config: { prefix: 'pika-', defaultSelector: '.%' }
-   * // or
-   * config: './pika.config.ts'
-   */
-  config?: EngineConfig | string;
-  /**
-   * Whether to automatically create a configuration file when needed.
-   *
-   * Behavior:
-   * - If config is not provided: Creates a default 'pika.config.ts' in the project root.
-   * - If config is a file path that doesn't exist: Creates a config file at the specified path.
-   * - If config is an inline config object: This option is ignored (no file will be created).
-   * @default true
-   */
-  autoCreateConfig?: boolean;
-  /**
-   * The name of the PikaCSS function in source code. Used to identify function calls that need to be transformed.
-   * @default 'pika'
-   * @example
-   * fnName: 'classname' // Transform classname() function calls to atomic styles
-   */
-  fnName?: string;
-  /**
-   * The format of the generated atomic style class names.
-   * - `'string'`: Returns a space-separated string of class names (e.g., "a b c")
-   * - `'array'`: Returns an array of class names (e.g., ['a', 'b', 'c'])
-   * @default 'string'
-   */
-  transformedFormat?: 'string' | 'array';
-  /**
-   * Configuration for TypeScript code generation file.
-   * - `true`: Auto-generate as 'pika.gen.ts'
-   * - string: Use the specified file path
-   * - `false`: Disable TypeScript code generation
-   * The generated TypeScript file provides type hints and auto-completion support.
-   * @default true
-   * @example
-   * tsCodegen: 'src/pika.gen.ts' // Generate to a custom location
-   */
-  tsCodegen?: boolean | string;
-  /**
-   * Configuration for CSS code generation file.
-   * - `true`: Auto-generate as 'pika.gen.css'
-   * - string: Use the specified file path
-   * The generated CSS file contains all scanned atomic styles.
-   * @default true
-   * @example
-   * cssCodegen: 'src/styles/generated.css' // Generate to a custom location
-   */
-  cssCodegen?: true | string;
-  /** @internal */
-  currentPackageName?: string;
-}
-interface ResolvedPluginOptions {
-  currentPackageName: string;
-  configOrPath: EngineConfig | string | Nullish;
-  tsCodegen: false | string;
-  cssCodegen: string;
-  scan: IntegrationContextOptions['scan'];
-  fnName: string;
-  transformedFormat: 'string' | 'array';
-  autoCreateConfig: boolean;
-}
-//#endregion
-export { ResolvedPluginOptions as n, PluginOptions as t };