@halo-dev/ui-plugin-bundler-kit 2.24.0 → 2.25.0

package/README.md

@@ -1,17 +1,17 @@
 # @halo-dev/ui-plugin-bundler-kit
 
-A frontend build toolkit for Halo plugin development, supporting both Vite and Rsbuild build systems.
+A frontend build toolkit for Halo UI plugin development, supporting both Vite and Rsbuild build systems.
 
 ## Introduction
 
-`@halo-dev/ui-plugin-bundler-kit` is a frontend build configuration toolkit specifically designed for Halo plugin development. It provides pre-configured build settings to help developers quickly set up and build frontend interfaces for Halo plugins.
+`@halo-dev/ui-plugin-bundler-kit` is a frontend build configuration toolkit specifically designed for Halo UI plugin development. It provides pre-configured build settings to help developers quickly set up and build frontend interfaces for Halo plugins and theme-provided UI plugins.
 
 ### Key Features
 
 - 🚀 **Ready to Use** - Provides pre-configured Vite and Rsbuild build settings
 - 📦 **Multi-Build Tool Support** - Supports both Vite and Rsbuild
 - 🔧 **Flexible Configuration** - Supports custom build configurations
-- 🎯 **Halo Optimized** - External dependencies and global variables optimized for Halo plugin development
+- 🎯 **Halo Optimized** - External dependencies and global variables optimized for Halo UI plugin development
 - 📁 **Smart Output** - Automatically selects output directory based on environment
 
 ## Installation
@@ -45,12 +45,13 @@ npm install @rsbuild/core
 
 ### Vite Configuration
 
-Create or update `vite.config.ts` file in your project root:
+Create or update `vite.config.ts` file in your UI plugin project root:
 
 ```typescript
 import { viteConfig } from "@halo-dev/ui-plugin-bundler-kit";
 
 export default viteConfig({
+  // provider defaults to "plugin"
   vite: {
     // Your custom Vite configuration
     plugins: [
@@ -65,12 +66,13 @@ export default viteConfig({
 
 ### Rsbuild Configuration
 
-Create or update `rsbuild.config.ts` file in your project root:
+Create or update `rsbuild.config.ts` file in your UI plugin project root:
 
 ```typescript
 import { rsbuildConfig } from "@halo-dev/ui-plugin-bundler-kit";
 
 export default rsbuildConfig({
+  // provider defaults to "plugin"
   rsbuild: {
     // Your custom Rsbuild configuration
     plugins: [
@@ -83,9 +85,46 @@ export default rsbuildConfig({
 
 > **Note**: Vue plugin is pre-configured, no need to add it manually.
 
+### Theme UI Plugin Configuration
+
+For theme-provided Console/User Center UI plugins, place the frontend project under the theme's `ui-plugin/` directory:
+
+```text
+theme-root/
+├── theme.yaml
+└── ui-plugin/
+    ├── package.json
+    ├── src/index.ts
+    └── vite.config.ts
+```
+
+Vite:
+
+```typescript
+import { viteConfig } from "@halo-dev/ui-plugin-bundler-kit";
+
+export default viteConfig({
+  provider: "theme",
+  vite: {},
+});
+```
+
+Rsbuild:
+
+```typescript
+import { rsbuildConfig } from "@halo-dev/ui-plugin-bundler-kit";
+
+export default rsbuildConfig({
+  provider: "theme",
+  rsbuild: {},
+});
+```
+
+The theme provider reads `../theme.yaml`, outputs to `dist`, registers the module as `theme:{metadata.name}`, and configures assets for `/themes/{metadata.name}/ui-plugin/assets/`. Halo reads only `ui-plugin/dist/**` from the theme package.
+
 ### Legacy Configuration (Deprecated)
 
-> ⚠️ **Note**: The `HaloUIPluginBundlerKit` function is deprecated. Please use `viteConfig` or `rsbuildConfig` instead.
+> ⚠️ **Note**: The `HaloUIPluginBundlerKit` function is deprecated. Please use `viteConfig` or `rsbuildConfig` instead. It does not support `provider: "theme"`.
 
 ```typescript
 import { HaloUIPluginBundlerKit } from "@halo-dev/ui-plugin-bundler-kit";
@@ -106,8 +145,14 @@ export default {
 ```typescript
 interface ViteUserConfig {
   /**
-   * Halo plugin manifest file path
-   * @default "../src/main/resources/plugin.yaml"
+   * UI plugin provider type
+   * @default "plugin"
+   */
+  provider?: "plugin" | "theme";
+
+  /**
+   * Halo plugin or theme manifest file path
+   * @default "../src/main/resources/plugin.yaml" for plugins, "../theme.yaml" for themes
    */
   manifestPath?: string;
 
@@ -123,8 +168,14 @@ interface ViteUserConfig {
 ```typescript
 interface RsBuildUserConfig {
   /**
-   * Halo plugin manifest file path
-   * @default "../src/main/resources/plugin.yaml"
+   * UI plugin provider type
+   * @default "plugin"
+   */
+  provider?: "plugin" | "theme";
+
+  /**
+   * Halo plugin or theme manifest file path
+   * @default "../src/main/resources/plugin.yaml" for plugins, "../theme.yaml" for themes
    */
   manifestPath?: string;
 
@@ -216,6 +267,20 @@ export default viteConfig({
 });
 ```
 
+### Custom Theme Manifest Path
+
+```typescript
+import { viteConfig } from "@halo-dev/ui-plugin-bundler-kit";
+
+export default viteConfig({
+  provider: "theme",
+  manifestPath: "../custom-theme.yaml",
+  vite: {
+    // Other configurations...
+  },
+});
+```
+
 ## Development Scripts
 
 Recommended scripts to add to your `package.json`:
@@ -242,10 +307,17 @@ For Rsbuild:
 
 ## Build Output
 
-> Relative to the root directory of the Halo plugin project
+> Relative to the UI plugin project root
+
+Plugin provider:
+
+- **Development**: `../build/resources/main/ui` or `../build/resources/main/console`
+- **Production**: `./build/dist`
+
+Theme provider:
 
-- **Development**: `build/resources/main/console`
-- **Production**: `ui/build/dist`
+- **Development**: `dist`
+- **Production**: `dist`
 
 > **Note**: The production build output directory of `HaloUIPluginBundlerKit` is still `src/main/resources/console` to ensure compatibility.
 

package/dist/index.d.mts

@@ -17,9 +17,15 @@ declare function HaloUIPluginBundlerKit(options?: HaloUIPluginBundlerKitOptions)
 //#region src/rsbuild.d.ts
 interface RsBuildUserConfig {
   /**
-   * Halo plugin manifest path.
+   * UI plugin provider type.
    *
-   * @default "../src/main/resources/plugin.yaml"
+   * @default "plugin"
+   */
+  provider?: "plugin" | "theme";
+  /**
+   * Halo plugin or theme manifest path.
+   *
+   * @default "../src/main/resources/plugin.yaml" for plugins, "../theme.yaml" for themes
    */
   manifestPath?: string;
   /**
@@ -48,9 +54,15 @@ declare function rsbuildConfig(config?: RsBuildUserConfig): (env: ConfigParams)
 //#region src/vite.d.ts
 interface ViteUserConfig {
   /**
-   * Halo plugin manifest path.
+   * UI plugin provider type.
+   *
+   * @default "plugin"
+   */
+  provider?: "plugin" | "theme";
+  /**
+   * Halo plugin or theme manifest path.
    *
-   * @default "../src/main/resources/plugin.yaml"
+   * @default "../src/main/resources/plugin.yaml" for plugins, "../theme.yaml" for themes
    */
   manifestPath?: string;
   /**

package/dist/index.mjs

@@ -1,12 +1,18 @@
 import fs from "node:fs";
 import yaml from "js-yaml";
+import { gte, minVersion } from "semver";
 import { defineConfig, mergeRsbuildConfig } from "@rsbuild/core";
 import { pluginVue } from "@rsbuild/plugin-vue";
 import Vue from "@vitejs/plugin-vue";
 import { defineConfig as defineConfig$1, mergeConfig } from "vite";
 //#region src/constants/build.ts
 const DEFAULT_OUT_DIR_DEV = "../build/resources/main/console";
+const DEFAULT_OUT_DIR_DEV_BASE = "../build/resources/main";
 const DEFAULT_OUT_DIR_PROD = "./build/dist";
+const DEFAULT_THEME_OUT_DIR = "dist";
+function getDefaultOutDirDev(bundleLocation) {
+	return `${DEFAULT_OUT_DIR_DEV_BASE}/${bundleLocation}`;
+}
 //#endregion
 //#region src/constants/externals.ts
 const GLOBALS = {
@@ -20,12 +26,50 @@ const GLOBALS = {
 	"@halo-dev/components": "HaloComponents",
 	"@halo-dev/api-client": "HaloApiClient",
 	"@halo-dev/richtext-editor": "RichTextEditor",
+	"@formkit/vue": "FormKitVue",
 	axios: "axios"
 };
 const EXTERNALS = Object.keys(GLOBALS);
 //#endregion
+//#region src/constants/halo-plugin.ts
+const DEFAULT_PLUGIN_MANIFEST_PATH = "../src/main/resources/plugin.yaml";
+const DEFAULT_THEME_MANIFEST_PATH = "../theme.yaml";
+//#endregion
 //#region src/utils/halo-plugin.ts
+const UI_BUNDLE_MIN_HALO_VERSION = "2.25.0";
+const UI_BUNDLE_LOCATION = "ui";
+const CONSOLE_BUNDLE_LOCATION = "console";
+const THEME_MODULE_NAME_PREFIX = "theme:";
 function getHaloPluginManifest(manifestPath) {
+	return readManifest(manifestPath);
+}
+function getHaloThemeManifest(manifestPath) {
+	return readManifest(manifestPath);
+}
+function getManifestName(manifest) {
+	return manifest.metadata.name;
+}
+function getHaloThemeModuleName(manifest) {
+	return `${THEME_MODULE_NAME_PREFIX}${getManifestName(manifest)}`;
+}
+function getHaloThemeAssetPublicPath(manifest) {
+	return `/themes/${getManifestName(manifest)}/ui-plugin/assets/`;
+}
+function getHaloPluginBundleLocation(manifest) {
+	const requiresMinVersion = getRequiresMinVersion(manifest.spec.requires);
+	return requiresMinVersion && gte(requiresMinVersion, UI_BUNDLE_MIN_HALO_VERSION) ? UI_BUNDLE_LOCATION : CONSOLE_BUNDLE_LOCATION;
+}
+function getRequiresMinVersion(requires) {
+	const normalizedRequires = requires?.trim();
+	if (!normalizedRequires) return;
+	try {
+		return minVersion(normalizedRequires);
+	} catch {
+		console.warn(`[ui-plugin-bundler-kit] Invalid semver range in plugin manifest "spec.requires": "${requires}". Falling back to "${CONSOLE_BUNDLE_LOCATION}" bundle location.`);
+		return;
+	}
+}
+function readManifest(manifestPath) {
 	return yaml.load(fs.readFileSync(manifestPath, "utf8"));
 }
 //#endregion
@@ -69,10 +113,10 @@ function HaloUIPluginBundlerKit(options = {}) {
 }
 //#endregion
 //#region src/rsbuild.ts
-function createRsbuildPresetsConfig(manifestPath) {
-	const manifest = getHaloPluginManifest(manifestPath);
+function createRsbuildPresetsConfig(provider, manifestPath) {
+	const defaults = provider === "theme" ? getThemeProviderDefaults$1(manifestPath) : getPluginProviderDefaults$1(manifestPath);
 	return defineConfig(({ envMode }) => {
-		const outDir = envMode === "production" ? DEFAULT_OUT_DIR_PROD : DEFAULT_OUT_DIR_DEV;
+		const outDir = envMode === "production" ? defaults.outDir.prod : defaults.outDir.dev;
 		return {
 			mode: envMode || "production",
 			plugins: [pluginVue()],
@@ -88,11 +132,11 @@ function createRsbuildPresetsConfig(manifestPath) {
 					experiments: { rspackFuture: { bundlerInfo: { force: false } } },
 					module: { parser: { javascript: { importMeta: false } } },
 					output: {
-						publicPath: `/plugins/${manifest.metadata.name}/assets/console/`,
+						publicPath: defaults.publicPath,
 						library: {
 							type: "window",
 							export: "default",
-							name: manifest.metadata.name
+							name: defaults.moduleName
 						},
 						globalObject: "window",
 						iife: true
@@ -124,6 +168,36 @@ function createRsbuildPresetsConfig(manifestPath) {
 		};
 	});
 }
+function getPluginProviderDefaults$1(manifestPath) {
+	const manifest = getHaloPluginManifest(manifestPath);
+	const bundleLocation = getHaloPluginBundleLocation(manifest);
+	return {
+		moduleName: getManifestName(manifest),
+		outDir: {
+			prod: DEFAULT_OUT_DIR_PROD,
+			dev: getDefaultOutDirDev(bundleLocation)
+		},
+		publicPath: `/plugins/${getManifestName(manifest)}/assets/${bundleLocation}/`
+	};
+}
+function getThemeProviderDefaults$1(manifestPath) {
+	const manifest = getHaloThemeManifest(manifestPath);
+	return {
+		moduleName: getHaloThemeModuleName(manifest),
+		outDir: {
+			prod: DEFAULT_THEME_OUT_DIR,
+			dev: DEFAULT_THEME_OUT_DIR
+		},
+		publicPath: getHaloThemeAssetPublicPath(manifest)
+	};
+}
+function getProvider$1(config) {
+	return config?.provider || "plugin";
+}
+function getManifestPath$1(provider, config) {
+	if (config?.manifestPath) return config.manifestPath;
+	return provider === "theme" ? DEFAULT_THEME_MANIFEST_PATH : DEFAULT_PLUGIN_MANIFEST_PATH;
+}
 /**
 * Rsbuild config for Halo UI Plugin.
 *
@@ -141,27 +215,29 @@ function createRsbuildPresetsConfig(manifestPath) {
 * @returns
 */
 function rsbuildConfig(config) {
-	const presetsConfigFn = createRsbuildPresetsConfig(config?.manifestPath || "../src/main/resources/plugin.yaml");
+	const provider = getProvider$1(config);
+	const presetsConfigFn = createRsbuildPresetsConfig(provider, getManifestPath$1(provider, config));
 	return defineConfig((env) => {
 		return mergeRsbuildConfig(presetsConfigFn(env), typeof config?.rsbuild === "function" ? config.rsbuild(env) : config?.rsbuild || {});
 	});
 }
 //#endregion
 //#region src/vite.ts
-function createVitePresetsConfig(manifestPath) {
-	const manifest = getHaloPluginManifest(manifestPath);
+function createVitePresetsConfig(provider, manifestPath) {
+	const defaults = provider === "theme" ? getThemeProviderDefaults(manifestPath) : getPluginProviderDefaults(manifestPath);
 	return defineConfig$1(({ mode }) => {
 		const isProduction = mode === "production";
 		return {
 			mode: mode || "production",
+			base: defaults.base,
 			plugins: [Vue()],
 			define: { "process.env.NODE_ENV": "'production'" },
 			build: {
-				outDir: isProduction ? DEFAULT_OUT_DIR_PROD : DEFAULT_OUT_DIR_DEV,
+				outDir: isProduction ? defaults.outDir.prod : defaults.outDir.dev,
 				emptyOutDir: true,
 				lib: {
 					entry: "src/index.ts",
-					name: manifest.metadata.name,
+					name: defaults.moduleName,
 					formats: ["iife"],
 					fileName: () => "main.js",
 					cssFileName: "style"
@@ -177,6 +253,36 @@ function createVitePresetsConfig(manifestPath) {
 		};
 	});
 }
+function getPluginProviderDefaults(manifestPath) {
+	const manifest = getHaloPluginManifest(manifestPath);
+	const bundleLocation = getHaloPluginBundleLocation(manifest);
+	return {
+		moduleName: getManifestName(manifest),
+		outDir: {
+			prod: DEFAULT_OUT_DIR_PROD,
+			dev: getDefaultOutDirDev(bundleLocation)
+		},
+		base: void 0
+	};
+}
+function getThemeProviderDefaults(manifestPath) {
+	const manifest = getHaloThemeManifest(manifestPath);
+	return {
+		moduleName: getHaloThemeModuleName(manifest),
+		outDir: {
+			prod: DEFAULT_THEME_OUT_DIR,
+			dev: DEFAULT_THEME_OUT_DIR
+		},
+		base: getHaloThemeAssetPublicPath(manifest)
+	};
+}
+function getProvider(config) {
+	return config?.provider || "plugin";
+}
+function getManifestPath(provider, config) {
+	if (config?.manifestPath) return config.manifestPath;
+	return provider === "theme" ? DEFAULT_THEME_MANIFEST_PATH : DEFAULT_PLUGIN_MANIFEST_PATH;
+}
 /**
 * Vite config for Halo UI Plugin.
 *
@@ -192,7 +298,8 @@ function createVitePresetsConfig(manifestPath) {
 * ```
 */
 function viteConfig(config) {
-	const presetsConfigFn = createVitePresetsConfig(config?.manifestPath || "../src/main/resources/plugin.yaml");
+	const provider = getProvider(config);
+	const presetsConfigFn = createVitePresetsConfig(provider, getManifestPath(provider, config));
 	return defineConfig$1((env) => {
 		return mergeConfig(presetsConfigFn(env), typeof config?.vite === "function" ? config.vite(env) : config?.vite || {});
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halo-dev/ui-plugin-bundler-kit",
-  "version": "2.24.0",
+  "version": "2.25.0",
   "homepage": "https://github.com/halo-dev/halo/tree/main/ui/packages/ui-plugin-bundler-kit#readme",
   "bugs": {
     "url": "https://github.com/halo-dev/halo/issues"
@@ -18,12 +18,20 @@
     ".": "./dist/index.mjs",
     "./package.json": "./package.json"
   },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test:unit": "vp test --run",
+    "prepublishOnly": "vp run build"
+  },
   "dependencies": {
+    "@halo-dev/api-client": "workspace:*",
     "js-yaml": "^4.1.1",
-    "@halo-dev/api-client": "2.24.0"
+    "semver": "^7.7.4"
   },
   "devDependencies": {
-    "@types/js-yaml": "^4.0.9"
+    "@types/js-yaml": "^4.0.9",
+    "@types/semver": "^7.7.1"
   },
   "peerDependencies": {
     "@rsbuild/core": "^1.0.0 || ^2.0.0",
@@ -33,9 +41,5 @@
   },
   "engines": {
     "node": "^18.0.0 || >=20.0.0"
-  },
-  "scripts": {
-    "build": "vp pack",
-    "dev": "vp pack --watch"
   }
-}
+}

package/src/__tests__/halo-plugin.spec.ts

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  getHaloPluginBundleLocation,
+  getHaloPluginManifest,
+  getHaloThemeAssetPublicPath,
+  getHaloThemeManifest,
+  getHaloThemeModuleName,
+  getManifestName,
+} from "../utils/halo-plugin";
+
+const tempDirs: string[] = [];
+
+afterEach(() => {
+  vi.restoreAllMocks();
+  while (tempDirs.length > 0) {
+    const tempDir = tempDirs.pop();
+    if (tempDir) {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+  }
+});
+
+describe("halo manifest utilities", () => {
+  it("reads plugin manifests", () => {
+    const manifestPath = writeManifest([
+      "metadata:",
+      "  name: plugin-a",
+      "spec:",
+      "  requires: '>=2.25.0'",
+      "",
+    ]);
+
+    const manifest = getHaloPluginManifest(manifestPath);
+
+    expect(getManifestName(manifest)).toBe("plugin-a");
+    expect(manifest.spec.requires).toBe(">=2.25.0");
+  });
+
+  it("reads theme manifests and derives theme bundle values", () => {
+    const manifestPath = writeManifest(["metadata:", "  name: theme-a", ""]);
+
+    const manifest = getHaloThemeManifest(manifestPath);
+
+    expect(getManifestName(manifest)).toBe("theme-a");
+    expect(getHaloThemeModuleName(manifest)).toBe("theme:theme-a");
+    expect(getHaloThemeAssetPublicPath(manifest)).toBe(
+      "/themes/theme-a/ui-plugin/assets/"
+    );
+  });
+
+  it("selects ui bundle location for plugins requiring Halo 2.25 or newer", () => {
+    expect(
+      getHaloPluginBundleLocation({
+        metadata: { name: "plugin-a" },
+        spec: { requires: ">=2.25.0" },
+      } as never)
+    ).toBe("ui");
+  });
+
+  it("falls back to console bundle location for older or missing requirements", () => {
+    expect(
+      getHaloPluginBundleLocation({
+        metadata: { name: "plugin-a" },
+        spec: { requires: ">=2.24.0" },
+      } as never)
+    ).toBe("console");
+    expect(
+      getHaloPluginBundleLocation({
+        metadata: { name: "plugin-a" },
+        spec: {},
+      } as never)
+    ).toBe("console");
+  });
+
+  it("warns and falls back to console bundle location for invalid requirements", () => {
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+
+    expect(
+      getHaloPluginBundleLocation({
+        metadata: { name: "plugin-a" },
+        spec: { requires: "not semver" },
+      } as never)
+    ).toBe("console");
+    expect(warn).toHaveBeenCalledWith(
+      '[ui-plugin-bundler-kit] Invalid semver range in plugin manifest "spec.requires": "not semver". ' +
+        'Falling back to "console" bundle location.'
+    );
+  });
+});
+
+function writeManifest(lines: string[]) {
+  const tempDir = fs.mkdtempSync(
+    path.join(os.tmpdir(), "halo-ui-plugin-manifest-")
+  );
+  tempDirs.push(tempDir);
+  const manifestPath = path.join(tempDir, "manifest.yaml");
+  fs.writeFileSync(manifestPath, lines.join("\n"));
+  return manifestPath;
+}

package/src/__tests__/legacy.spec.ts

@@ -0,0 +1,128 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import type { Plugin } from "vite";
+import { afterEach, describe, expect, it } from "vitest";
+import { HaloUIPluginBundlerKit } from "../legacy";
+
+const originalCwd = process.cwd();
+const tempDirs: string[] = [];
+
+afterEach(() => {
+  process.chdir(originalCwd);
+  while (tempDirs.length > 0) {
+    const tempDir = tempDirs.pop();
+    if (tempDir) {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+  }
+});
+
+describe("HaloUIPluginBundlerKit", () => {
+  it("keeps legacy default output directories", () => {
+    const uiDir = setupPluginProject("legacy-plugin");
+    process.chdir(uiDir);
+
+    const plugin = HaloUIPluginBundlerKit();
+
+    expect(resolveLegacyConfig(plugin, "development").build).toMatchObject({
+      outDir: "../build/resources/main/console",
+      emptyOutDir: true,
+      lib: {
+        entry: "src/index.ts",
+        name: "legacy-plugin",
+        formats: ["iife"],
+      },
+    });
+    expect(resolveLegacyConfig(plugin, "production").build).toMatchObject({
+      outDir: "../src/main/resources/console",
+    });
+  });
+
+  it("applies string outDir override for every mode", () => {
+    const uiDir = setupPluginProject("legacy-plugin");
+    process.chdir(uiDir);
+
+    const plugin = HaloUIPluginBundlerKit({ outDir: "custom" });
+
+    expect(resolveLegacyConfig(plugin, "development").build).toMatchObject({
+      outDir: "custom",
+    });
+    expect(resolveLegacyConfig(plugin, "production").build).toMatchObject({
+      outDir: "custom",
+    });
+  });
+
+  it("applies mode-specific outDir overrides", () => {
+    const uiDir = setupPluginProject("legacy-plugin");
+    process.chdir(uiDir);
+
+    const plugin = HaloUIPluginBundlerKit({
+      outDir: {
+        dev: "dev-dist",
+        prod: "prod-dist",
+      },
+    });
+
+    expect(resolveLegacyConfig(plugin, "development").build).toMatchObject({
+      outDir: "dev-dist",
+    });
+    expect(resolveLegacyConfig(plugin, "production").build).toMatchObject({
+      outDir: "prod-dist",
+    });
+  });
+
+  it("uses custom manifest path", () => {
+    const projectRoot = createTempDir();
+    const manifestPath = path.join(projectRoot, "plugin.yaml");
+    fs.writeFileSync(
+      manifestPath,
+      ["metadata:", "  name: custom-legacy-plugin", "spec:", ""].join("\n")
+    );
+
+    const plugin = HaloUIPluginBundlerKit({ manifestPath });
+
+    expect(resolveLegacyConfig(plugin, "production").build).toMatchObject({
+      lib: {
+        name: "custom-legacy-plugin",
+      },
+    });
+  });
+});
+
+function resolveLegacyConfig(plugin: Plugin, mode: string) {
+  if (typeof plugin.config !== "function") {
+    throw new Error("Expected plugin config hook");
+  }
+  return plugin.config(
+    {},
+    {
+      command: "build",
+      mode,
+      isSsrBuild: false,
+      isPreview: false,
+    }
+  );
+}
+
+function setupPluginProject(name: string) {
+  const projectRoot = createTempDir();
+  const uiDir = path.join(projectRoot, "ui");
+  fs.mkdirSync(path.join(projectRoot, "src/main/resources"), {
+    recursive: true,
+  });
+  fs.mkdirSync(uiDir, { recursive: true });
+  fs.writeFileSync(
+    path.join(projectRoot, "src/main/resources/plugin.yaml"),
+    ["metadata:", `  name: ${name}`, "spec:", ""].join("\n")
+  );
+  return uiDir;
+}
+
+function createTempDir() {
+  const tempDir = fs.mkdtempSync(
+    path.join(os.tmpdir(), "halo-ui-plugin-legacy-")
+  );
+  tempDirs.push(tempDir);
+  return tempDir;
+}

package/src/__tests__/provider.spec.ts

@@ -0,0 +1,301 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import type { ConfigParams, RsbuildConfig } from "@rsbuild/core";
+import type { ConfigEnv, UserConfig } from "vite";
+import { afterEach, describe, expect, it } from "vitest";
+import { rsbuildConfig } from "../rsbuild";
+import { viteConfig } from "../vite";
+
+const originalCwd = process.cwd();
+const tempDirs: string[] = [];
+
+afterEach(() => {
+  process.chdir(originalCwd);
+  while (tempDirs.length > 0) {
+    const tempDir = tempDirs.pop();
+    if (tempDir) {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+  }
+});
+
+describe("provider defaults", () => {
+  it("keeps plugin provider defaults when provider is omitted", () => {
+    const uiDir = setupPluginProject();
+    process.chdir(uiDir);
+
+    const vite = resolveViteConfig(viteConfig({ vite: {} }), "development");
+    expect(vite.base).toBeUndefined();
+    expect(vite.build?.outDir).toBe("../build/resources/main/ui");
+    expect(vite.build?.lib).toMatchObject({
+      entry: "src/index.ts",
+      name: "fake-plugin",
+      formats: ["iife"],
+      cssFileName: "style",
+    });
+
+    const rsbuild = resolveRsbuildConfig(
+      rsbuildConfig({ rsbuild: {} }),
+      "development"
+    );
+    expect(rsbuild.output?.distPath?.root).toBe("../build/resources/main/ui");
+    expect(rsbuild.tools?.rspack?.output?.publicPath).toBe(
+      "/plugins/fake-plugin/assets/ui/"
+    );
+    expect(rsbuild.tools?.rspack?.output?.library).toMatchObject({
+      type: "window",
+      export: "default",
+      name: "fake-plugin",
+    });
+
+    const productionVite = resolveViteConfig(viteConfig({ vite: {} }));
+    expect(productionVite.build?.outDir).toBe("./build/dist");
+
+    const productionRsbuild = resolveRsbuildConfig(
+      rsbuildConfig({ rsbuild: {} })
+    );
+    expect(productionRsbuild.output?.distPath?.root).toBe("./build/dist");
+  });
+
+  it("keeps plugin provider defaults when provider is explicit", () => {
+    const uiDir = setupPluginProject();
+    process.chdir(uiDir);
+
+    const vite = resolveViteConfig(
+      viteConfig({ provider: "plugin", vite: {} }),
+      "development"
+    );
+    expect(vite.build?.outDir).toBe("../build/resources/main/ui");
+
+    const rsbuild = resolveRsbuildConfig(
+      rsbuildConfig({ provider: "plugin", rsbuild: {} }),
+      "development"
+    );
+    expect(rsbuild.tools?.rspack?.output?.publicPath).toBe(
+      "/plugins/fake-plugin/assets/ui/"
+    );
+  });
+
+  it("uses custom manifest paths for plugin and theme providers", () => {
+    const projectRoot = createTempDir();
+    const pluginManifestPath = path.join(projectRoot, "custom-plugin.yaml");
+    const themeManifestPath = path.join(projectRoot, "custom-theme.yaml");
+    fs.writeFileSync(
+      pluginManifestPath,
+      [
+        "metadata:",
+        "  name: custom-plugin",
+        "spec:",
+        "  requires: '>=2.25.0'",
+        "",
+      ].join("\n")
+    );
+    fs.writeFileSync(
+      themeManifestPath,
+      ["metadata:", "  name: custom-theme", ""].join("\n")
+    );
+
+    const pluginConfig = resolveViteConfig(
+      viteConfig({
+        manifestPath: pluginManifestPath,
+        vite: {},
+      })
+    );
+    expect(pluginConfig.build?.lib).toMatchObject({
+      name: "custom-plugin",
+    });
+
+    const themeConfig = resolveRsbuildConfig(
+      rsbuildConfig({
+        provider: "theme",
+        manifestPath: themeManifestPath,
+        rsbuild: {},
+      })
+    );
+    expect(themeConfig.tools?.rspack?.output?.publicPath).toBe(
+      "/themes/custom-theme/ui-plugin/assets/"
+    );
+    expect(themeConfig.tools?.rspack?.output?.library).toMatchObject({
+      name: "theme:custom-theme",
+    });
+  });
+
+  it("generates Vite theme provider defaults", () => {
+    const uiPluginDir = setupThemeProject();
+    process.chdir(uiPluginDir);
+
+    const config = resolveViteConfig(
+      viteConfig({ provider: "theme", vite: {} })
+    );
+
+    expect(config.base).toBe("/themes/earth/ui-plugin/assets/");
+    expect(config.build?.outDir).toBe("dist");
+    expect(config.build?.lib).toMatchObject({
+      entry: "src/index.ts",
+      name: "theme:earth",
+      formats: ["iife"],
+      cssFileName: "style",
+    });
+    expect(config.build?.rollupOptions?.external).toContain("vue");
+    expect(config.build?.rollupOptions?.output).toMatchObject({
+      globals: expect.objectContaining({
+        vue: "Vue",
+      }),
+      extend: true,
+    });
+  });
+
+  it("generates Rsbuild theme provider defaults", () => {
+    const uiPluginDir = setupThemeProject();
+    process.chdir(uiPluginDir);
+
+    const config = resolveRsbuildConfig(
+      rsbuildConfig({ provider: "theme", rsbuild: {} })
+    );
+
+    expect(config.output?.distPath?.root).toBe("dist");
+    expect(config.output?.filename?.js).toBeDefined();
+    expect(config.output?.filename?.css).toBeDefined();
+    expect(config.output?.externals).toMatchObject({
+      vue: "Vue",
+    });
+    expect(config.tools?.rspack?.output?.publicPath).toBe(
+      "/themes/earth/ui-plugin/assets/"
+    );
+    expect(config.tools?.rspack?.output?.library).toMatchObject({
+      type: "window",
+      export: "default",
+      name: "theme:earth",
+    });
+  });
+
+  it("merges user config after provider defaults", () => {
+    const uiPluginDir = setupThemeProject();
+    process.chdir(uiPluginDir);
+
+    const vite = resolveViteConfig(
+      viteConfig({
+        provider: "theme",
+        vite: {
+          base: "/custom/",
+          build: {
+            outDir: "custom-dist",
+          },
+        },
+      })
+    );
+    expect(vite.base).toBe("/custom/");
+    expect(vite.build?.outDir).toBe("custom-dist");
+
+    const rsbuild = resolveRsbuildConfig(
+      rsbuildConfig({
+        provider: "theme",
+        rsbuild: {
+          output: {
+            distPath: {
+              root: "custom-dist",
+            },
+          },
+          tools: {
+            rspack: {
+              output: {
+                publicPath: "/custom/",
+              },
+            },
+          },
+        },
+      })
+    );
+    expect(rsbuild.output?.distPath?.root).toBe("custom-dist");
+    expect(rsbuild.tools?.rspack?.output?.publicPath).toBe("/custom/");
+  });
+
+  it("merges function user config after provider defaults", () => {
+    const uiPluginDir = setupThemeProject();
+    process.chdir(uiPluginDir);
+
+    const vite = resolveViteConfig(
+      viteConfig({
+        provider: "theme",
+        vite: ({ mode }) => ({
+          define: {
+            __MODE__: JSON.stringify(mode),
+          },
+        }),
+      })
+    );
+    expect(vite.define).toMatchObject({
+      "process.env.NODE_ENV": "'production'",
+      __MODE__: '"production"',
+    });
+
+    const rsbuild = resolveRsbuildConfig(
+      rsbuildConfig({
+        provider: "theme",
+        rsbuild: ({ envMode }) => ({
+          output: {
+            filename: {
+              js: `custom-${envMode}.js`,
+            },
+          },
+        }),
+      })
+    );
+    expect(rsbuild.output?.filename?.js).toBe("custom-production.js");
+  });
+});
+
+function setupPluginProject() {
+  const projectRoot = createTempDir();
+  const uiDir = path.join(projectRoot, "ui");
+  fs.mkdirSync(path.join(projectRoot, "src/main/resources"), {
+    recursive: true,
+  });
+  fs.mkdirSync(uiDir, { recursive: true });
+  fs.writeFileSync(
+    path.join(projectRoot, "src/main/resources/plugin.yaml"),
+    [
+      "metadata:",
+      "  name: fake-plugin",
+      "spec:",
+      "  requires: '>=2.25.0'",
+      "",
+    ].join("\n")
+  );
+  return uiDir;
+}
+
+function setupThemeProject() {
+  const projectRoot = createTempDir();
+  const uiPluginDir = path.join(projectRoot, "ui-plugin");
+  fs.mkdirSync(uiPluginDir, { recursive: true });
+  fs.writeFileSync(
+    path.join(projectRoot, "theme.yaml"),
+    ["metadata:", "  name: earth", ""].join("\n")
+  );
+  return uiPluginDir;
+}
+
+function createTempDir() {
+  const tempDir = fs.mkdtempSync(
+    path.join(os.tmpdir(), "halo-ui-plugin-bundler-kit-")
+  );
+  tempDirs.push(tempDir);
+  return tempDir;
+}
+
+function resolveViteConfig(config: unknown, mode = "production") {
+  return (config as (env: ConfigEnv) => UserConfig)({
+    command: "build",
+    mode,
+    isSsrBuild: false,
+    isPreview: false,
+  });
+}
+
+function resolveRsbuildConfig(config: unknown, envMode = "production") {
+  return (config as (env: ConfigParams) => RsbuildConfig)({
+    envMode,
+  } as ConfigParams);
+}

package/src/constants/build.ts

@@ -1,4 +1,15 @@
 const DEFAULT_OUT_DIR_DEV = "../build/resources/main/console";
+const DEFAULT_OUT_DIR_DEV_BASE = "../build/resources/main";
 const DEFAULT_OUT_DIR_PROD = "./build/dist";
+const DEFAULT_THEME_OUT_DIR = "dist";
 
-export { DEFAULT_OUT_DIR_DEV, DEFAULT_OUT_DIR_PROD };
+function getDefaultOutDirDev(bundleLocation: string) {
+  return `${DEFAULT_OUT_DIR_DEV_BASE}/${bundleLocation}`;
+}
+
+export {
+  DEFAULT_OUT_DIR_DEV,
+  DEFAULT_OUT_DIR_PROD,
+  DEFAULT_THEME_OUT_DIR,
+  getDefaultOutDirDev,
+};

package/src/constants/externals.ts

@@ -9,6 +9,7 @@ const GLOBALS = {
   "@halo-dev/components": "HaloComponents",
   "@halo-dev/api-client": "HaloApiClient",
   "@halo-dev/richtext-editor": "RichTextEditor",
+  "@formkit/vue": "FormKitVue",
   axios: "axios",
 };
 

package/src/constants/halo-plugin.ts

@@ -1,3 +1,9 @@
-const DEFAULT_MANIFEST_PATH = "../src/main/resources/plugin.yaml";
+const DEFAULT_PLUGIN_MANIFEST_PATH = "../src/main/resources/plugin.yaml";
+const DEFAULT_THEME_MANIFEST_PATH = "../theme.yaml";
+const DEFAULT_MANIFEST_PATH = DEFAULT_PLUGIN_MANIFEST_PATH;
 
-export { DEFAULT_MANIFEST_PATH };
+export {
+  DEFAULT_MANIFEST_PATH,
+  DEFAULT_PLUGIN_MANIFEST_PATH,
+  DEFAULT_THEME_MANIFEST_PATH,
+};

package/src/rsbuild.ts

@@ -6,16 +6,39 @@ import {
   type RsbuildMode,
 } from "@rsbuild/core";
 import { pluginVue } from "@rsbuild/plugin-vue";
-import { DEFAULT_OUT_DIR_DEV, DEFAULT_OUT_DIR_PROD } from "./constants/build";
+import {
+  DEFAULT_OUT_DIR_PROD,
+  DEFAULT_THEME_OUT_DIR,
+  getDefaultOutDirDev,
+} from "./constants/build";
 import { GLOBALS } from "./constants/externals";
-import { DEFAULT_MANIFEST_PATH } from "./constants/halo-plugin";
-import { getHaloPluginManifest } from "./utils/halo-plugin";
+import {
+  DEFAULT_PLUGIN_MANIFEST_PATH,
+  DEFAULT_THEME_MANIFEST_PATH,
+} from "./constants/halo-plugin";
+import {
+  getHaloPluginBundleLocation,
+  getHaloPluginManifest,
+  getHaloThemeAssetPublicPath,
+  getHaloThemeManifest,
+  getHaloThemeModuleName,
+  getManifestName,
+} from "./utils/halo-plugin";
+
+type Provider = "plugin" | "theme";
 
 export interface RsBuildUserConfig {
   /**
-   * Halo plugin manifest path.
+   * UI plugin provider type.
+   *
+   * @default "plugin"
+   */
+  provider?: "plugin" | "theme";
+
+  /**
+   * Halo plugin or theme manifest path.
    *
-   * @default "../src/main/resources/plugin.yaml"
+   * @default "../src/main/resources/plugin.yaml" for plugins, "../theme.yaml" for themes
    */
   manifestPath?: string;
 
@@ -25,13 +48,16 @@ export interface RsBuildUserConfig {
   rsbuild: RsbuildConfig | ((env: ConfigParams) => RsbuildConfig);
 }
 
-function createRsbuildPresetsConfig(manifestPath: string) {
-  const manifest = getHaloPluginManifest(manifestPath);
+function createRsbuildPresetsConfig(provider: Provider, manifestPath: string) {
+  const defaults =
+    provider === "theme"
+      ? getThemeProviderDefaults(manifestPath)
+      : getPluginProviderDefaults(manifestPath);
 
   return defineConfig(({ envMode }) => {
     const isProduction = envMode === "production";
 
-    const outDir = isProduction ? DEFAULT_OUT_DIR_PROD : DEFAULT_OUT_DIR_DEV;
+    const outDir = isProduction ? defaults.outDir.prod : defaults.outDir.dev;
 
     return {
       mode: (envMode as RsbuildMode) || "production",
@@ -72,11 +98,11 @@ function createRsbuildPresetsConfig(manifestPath: string) {
             },
           },
           output: {
-            publicPath: `/plugins/${manifest.metadata.name}/assets/console/`,
+            publicPath: defaults.publicPath,
             library: {
               type: "window",
               export: "default",
-              name: manifest.metadata.name,
+              name: defaults.moduleName,
             },
             globalObject: "window",
             iife: true,
@@ -113,6 +139,46 @@ function createRsbuildPresetsConfig(manifestPath: string) {
   });
 }
 
+function getPluginProviderDefaults(manifestPath: string) {
+  const manifest = getHaloPluginManifest(manifestPath);
+  const bundleLocation = getHaloPluginBundleLocation(manifest);
+
+  return {
+    moduleName: getManifestName(manifest),
+    outDir: {
+      prod: DEFAULT_OUT_DIR_PROD,
+      dev: getDefaultOutDirDev(bundleLocation),
+    },
+    publicPath: `/plugins/${getManifestName(manifest)}/assets/${bundleLocation}/`,
+  };
+}
+
+function getThemeProviderDefaults(manifestPath: string) {
+  const manifest = getHaloThemeManifest(manifestPath);
+
+  return {
+    moduleName: getHaloThemeModuleName(manifest),
+    outDir: {
+      prod: DEFAULT_THEME_OUT_DIR,
+      dev: DEFAULT_THEME_OUT_DIR,
+    },
+    publicPath: getHaloThemeAssetPublicPath(manifest),
+  };
+}
+
+function getProvider(config?: RsBuildUserConfig): Provider {
+  return config?.provider || "plugin";
+}
+
+function getManifestPath(provider: Provider, config?: RsBuildUserConfig) {
+  if (config?.manifestPath) {
+    return config.manifestPath;
+  }
+  return provider === "theme"
+    ? DEFAULT_THEME_MANIFEST_PATH
+    : DEFAULT_PLUGIN_MANIFEST_PATH;
+}
+
 /**
  * Rsbuild config for Halo UI Plugin.
  *
@@ -132,8 +198,10 @@ function createRsbuildPresetsConfig(manifestPath: string) {
 export function rsbuildConfig(
   config?: RsBuildUserConfig
 ): (env: ConfigParams) => RsbuildConfig {
+  const provider = getProvider(config);
   const presetsConfigFn = createRsbuildPresetsConfig(
-    config?.manifestPath || DEFAULT_MANIFEST_PATH
+    provider,
+    getManifestPath(provider, config)
   );
   return defineConfig((env) => {
     const presetsConfig = presetsConfigFn(env);

package/src/utils/halo-plugin.ts

@@ -1,11 +1,67 @@
 import fs from "node:fs";
 import type { Plugin as HaloPlugin } from "@halo-dev/api-client";
 import yaml from "js-yaml";
+import { gte, minVersion } from "semver";
+
+const UI_BUNDLE_MIN_HALO_VERSION = "2.25.0";
+const UI_BUNDLE_LOCATION = "ui";
+const CONSOLE_BUNDLE_LOCATION = "console";
+const THEME_MODULE_NAME_PREFIX = "theme:";
+
+interface HaloThemeManifest {
+  metadata: {
+    name: string;
+  };
+}
 
 export function getHaloPluginManifest(manifestPath: string) {
-  const manifest = yaml.load(
-    fs.readFileSync(manifestPath, "utf8")
-  ) as HaloPlugin;
+  return readManifest<HaloPlugin>(manifestPath);
+}
+
+export function getHaloThemeManifest(manifestPath: string) {
+  return readManifest<HaloThemeManifest>(manifestPath);
+}
+
+export function getManifestName(
+  manifest: Pick<HaloPlugin, "metadata"> | HaloThemeManifest
+) {
+  return manifest.metadata.name;
+}
+
+export function getHaloThemeModuleName(manifest: HaloThemeManifest) {
+  return `${THEME_MODULE_NAME_PREFIX}${getManifestName(manifest)}`;
+}
+
+export function getHaloThemeAssetPublicPath(manifest: HaloThemeManifest) {
+  return `/themes/${getManifestName(manifest)}/ui-plugin/assets/`;
+}
+
+export function getHaloPluginBundleLocation(manifest: HaloPlugin) {
+  const requiresMinVersion = getRequiresMinVersion(manifest.spec.requires);
+  return requiresMinVersion &&
+    gte(requiresMinVersion, UI_BUNDLE_MIN_HALO_VERSION)
+    ? UI_BUNDLE_LOCATION
+    : CONSOLE_BUNDLE_LOCATION;
+}
+
+function getRequiresMinVersion(requires: string | undefined) {
+  const normalizedRequires = requires?.trim();
+
+  if (!normalizedRequires) {
+    return;
+  }
+
+  try {
+    return minVersion(normalizedRequires);
+  } catch {
+    console.warn(
+      `[ui-plugin-bundler-kit] Invalid semver range in plugin manifest "spec.requires": "${requires}". ` +
+        `Falling back to "${CONSOLE_BUNDLE_LOCATION}" bundle location.`
+    );
+    return;
+  }
+}
 
-  return manifest;
+function readManifest<T>(manifestPath: string) {
+  return yaml.load(fs.readFileSync(manifestPath, "utf8")) as T;
 }

package/src/vite.ts

@@ -5,16 +5,39 @@ import {
   UserConfig,
   UserConfigFnObject,
 } from "vite";
-import { DEFAULT_OUT_DIR_DEV, DEFAULT_OUT_DIR_PROD } from "./constants/build";
+import {
+  DEFAULT_OUT_DIR_PROD,
+  DEFAULT_THEME_OUT_DIR,
+  getDefaultOutDirDev,
+} from "./constants/build";
 import { EXTERNALS, GLOBALS } from "./constants/externals";
-import { DEFAULT_MANIFEST_PATH } from "./constants/halo-plugin";
-import { getHaloPluginManifest } from "./utils/halo-plugin";
+import {
+  DEFAULT_PLUGIN_MANIFEST_PATH,
+  DEFAULT_THEME_MANIFEST_PATH,
+} from "./constants/halo-plugin";
+import {
+  getHaloPluginBundleLocation,
+  getHaloPluginManifest,
+  getHaloThemeAssetPublicPath,
+  getHaloThemeManifest,
+  getHaloThemeModuleName,
+  getManifestName,
+} from "./utils/halo-plugin";
+
+type Provider = "plugin" | "theme";
 
 export interface ViteUserConfig {
   /**
-   * Halo plugin manifest path.
+   * UI plugin provider type.
+   *
+   * @default "plugin"
+   */
+  provider?: "plugin" | "theme";
+
+  /**
+   * Halo plugin or theme manifest path.
    *
-   * @default "../src/main/resources/plugin.yaml"
+   * @default "../src/main/resources/plugin.yaml" for plugins, "../theme.yaml" for themes
    */
   manifestPath?: string;
 
@@ -24,22 +47,26 @@ export interface ViteUserConfig {
   vite: UserConfig | UserConfigFnObject;
 }
 
-function createVitePresetsConfig(manifestPath: string) {
-  const manifest = getHaloPluginManifest(manifestPath);
+function createVitePresetsConfig(provider: Provider, manifestPath: string) {
+  const defaults =
+    provider === "theme"
+      ? getThemeProviderDefaults(manifestPath)
+      : getPluginProviderDefaults(manifestPath);
 
   return defineConfig(({ mode }) => {
     const isProduction = mode === "production";
 
     return {
       mode: mode || "production",
+      base: defaults.base,
       plugins: [Vue()],
       define: { "process.env.NODE_ENV": "'production'" },
       build: {
-        outDir: isProduction ? DEFAULT_OUT_DIR_PROD : DEFAULT_OUT_DIR_DEV,
+        outDir: isProduction ? defaults.outDir.prod : defaults.outDir.dev,
         emptyOutDir: true,
         lib: {
           entry: "src/index.ts",
-          name: manifest.metadata.name,
+          name: defaults.moduleName,
           formats: ["iife"],
           fileName: () => "main.js",
           cssFileName: "style",
@@ -56,6 +83,46 @@ function createVitePresetsConfig(manifestPath: string) {
   });
 }
 
+function getPluginProviderDefaults(manifestPath: string) {
+  const manifest = getHaloPluginManifest(manifestPath);
+  const bundleLocation = getHaloPluginBundleLocation(manifest);
+
+  return {
+    moduleName: getManifestName(manifest),
+    outDir: {
+      prod: DEFAULT_OUT_DIR_PROD,
+      dev: getDefaultOutDirDev(bundleLocation),
+    },
+    base: undefined,
+  };
+}
+
+function getThemeProviderDefaults(manifestPath: string) {
+  const manifest = getHaloThemeManifest(manifestPath);
+
+  return {
+    moduleName: getHaloThemeModuleName(manifest),
+    outDir: {
+      prod: DEFAULT_THEME_OUT_DIR,
+      dev: DEFAULT_THEME_OUT_DIR,
+    },
+    base: getHaloThemeAssetPublicPath(manifest),
+  };
+}
+
+function getProvider(config?: ViteUserConfig): Provider {
+  return config?.provider || "plugin";
+}
+
+function getManifestPath(provider: Provider, config?: ViteUserConfig) {
+  if (config?.manifestPath) {
+    return config.manifestPath;
+  }
+  return provider === "theme"
+    ? DEFAULT_THEME_MANIFEST_PATH
+    : DEFAULT_PLUGIN_MANIFEST_PATH;
+}
+
 /**
  * Vite config for Halo UI Plugin.
  *
@@ -71,8 +138,10 @@ function createVitePresetsConfig(manifestPath: string) {
  * ```
  */
 export function viteConfig(config?: ViteUserConfig) {
+  const provider = getProvider(config);
   const presetsConfigFn = createVitePresetsConfig(
-    config?.manifestPath || DEFAULT_MANIFEST_PATH
+    provider,
+    getManifestPath(provider, config)
   );
   return defineConfig((env) => {
     const presetsConfig = presetsConfigFn(env);