@ubean/integrations 0.2.0

package/dist/index.js

@@ -0,0 +1,148 @@
+import { C as getFontshareUrl, D as normalizeFontName, E as normalizeFontFamily, O as parseFontFamilyCSS, S as getBunnyFontsUrl, T as googleFontMetrics, _ as generateFontCSSVariable, a as generateFontCSS, b as generatePreconnectLink, c as getFontHash, d as defaultFontDisplay, f as defaultFontStyles, g as fallbackFonts, h as extractFontUrlsFromCSS, i as defineLocalFont, k as weightsToString, l as getFontsConfig, m as defaultFontWeights, n as defineFontFamily, o as generateFontLinks, p as defaultFontSubsets, r as defineGoogleFont, s as getFontFamilies, t as configureFontsRuntime, u as createFontHash, v as generateFontFace, w as getGoogleFontsUrl, x as generatePreloadLink, y as generateFontFallbackCSS } from "./runtime-C_0lCtWE.js";
+import { computed, onMounted, ref } from "vue";
+//#region src/pwa/runtime.ts
+let swRegistration = null;
+async function registerSWFn(swUrl, opts = {}) {
+	if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) return null;
+	const { immediate = true, onNeedRefresh, onOfflineReady, onRegistered, onRegisterError, onUpdateFound } = opts;
+	if (!immediate) return null;
+	try {
+		const registration = await navigator.serviceWorker.register(swUrl, { scope: "/" });
+		swRegistration = registration;
+		onRegistered?.(swUrl);
+		registration.addEventListener("updatefound", () => {
+			const newWorker = registration.installing;
+			onUpdateFound?.();
+			if (newWorker) newWorker.addEventListener("statechange", () => {
+				if (newWorker.state === "installed" && navigator.serviceWorker.controller) onNeedRefresh?.();
+			});
+		});
+		if (!navigator.serviceWorker.controller) onOfflineReady?.();
+		return registration;
+	} catch (error) {
+		onRegisterError?.(error instanceof Error ? error : new Error(String(error)));
+		return null;
+	}
+}
+function registerSW(swUrl = "/sw.js", options = {}) {
+	return registerSWFn(swUrl, options);
+}
+function updateSW() {
+	if (swRegistration?.waiting) swRegistration.waiting.postMessage({ type: "SKIP_WAITING" });
+}
+function getSWRegistration() {
+	return swRegistration;
+}
+function usePwa(options = {}) {
+	const { immediate = true, swUrl = "/sw.js", onNeedRefresh, onOfflineReady, onRegistered, onRegisterError, onUpdateFound } = options;
+	const isInstalled = ref(false);
+	const isUpdateAvailable = ref(false);
+	const isOfflineReady = ref(false);
+	const needRefresh = ref(false);
+	const registration = ref(null);
+	const state = computed(() => ({
+		isInstalled: isInstalled.value,
+		isUpdateAvailable: isUpdateAvailable.value,
+		isOfflineReady: isOfflineReady.value,
+		needRefresh: needRefresh.value,
+		registration: registration.value
+	}));
+	async function doRegister() {
+		if (typeof window === "undefined" || !("serviceWorker" in navigator)) return;
+		try {
+			const reg = await registerSWFn(swUrl, {
+				immediate,
+				onNeedRefresh: () => {
+					needRefresh.value = true;
+					isUpdateAvailable.value = true;
+					onNeedRefresh?.();
+				},
+				onOfflineReady: () => {
+					isOfflineReady.value = true;
+					isInstalled.value = true;
+					onOfflineReady?.();
+				},
+				onRegistered: (url) => {
+					registration.value = swRegistration;
+					onRegistered?.(url);
+				},
+				onRegisterError: (err) => {
+					onRegisterError?.(err);
+				},
+				onUpdateFound: () => {
+					onUpdateFound?.();
+				}
+			});
+			if (reg) registration.value = reg;
+		} catch {}
+	}
+	function skipWaitingAndRefresh() {
+		updateSW();
+	}
+	function closeNeedRefresh() {
+		needRefresh.value = false;
+		isUpdateAvailable.value = false;
+	}
+	onMounted(() => {
+		if (immediate) doRegister();
+	});
+	return {
+		state,
+		isInstalled,
+		isUpdateAvailable,
+		isOfflineReady,
+		needRefresh,
+		registration,
+		register: doRegister,
+		updateServiceWorker: skipWaitingAndRefresh,
+		skipWaiting: skipWaitingAndRefresh,
+		closePrompt: closeNeedRefresh
+	};
+}
+//#endregion
+//#region src/pinia/runtime.ts
+function getPiniaFromApp(app) {
+	return app.config.globalProperties.$pinia ?? null;
+}
+/**
+* SSR 序列化:从 Vue app 实例提取 Pinia 的 root state。
+*
+* 在服务端 `renderToString(app)` 完成后由 ubean SSR 渲染器调用。
+* 返回的 `{ pinia }` 会被序列化到 HTML 的 `__UBEAN_STATE__` script 标签中。
+*
+* 若 app 上未检测到 `$pinia`(未安装 pinia 插件),返回空对象,
+* 不会抛出错误(允许在部分页面不使用 pinia)。
+*
+* @param app Vue app 实例(SSR 渲染用的 app)
+* @returns 序列化后的状态对象,包含 `pinia.state.value`
+*/
+function serializePiniaState(app) {
+	const pinia = getPiniaFromApp(app);
+	if (!pinia) return {};
+	return { pinia: JSON.parse(JSON.stringify(pinia.state.value)) };
+}
+/**
+* 客户端水合:将 SSR 序列化的 state 注入到 Pinia 实例。
+*
+* 在 `applyAppConfig`(注册 `createPinia()` 插件)之后、`app.mount()` 之前调用。
+* 必须在 mount 前执行,否则 store 已用默认 state 初始化,水合无效。
+*
+* 若 `state` 为 `null` 或不含 `pinia` 字段,直接返回(no-op),
+* 允许在 CSR 模式或无 SSR state 时安全调用。
+*
+* @param app Vue app 实例(客户端 app,已 install pinia 插件)
+* @param state 从 `__UBEAN_STATE__` 反序列化的状态对象,或 null
+*/
+function hydratePiniaState(app, state) {
+	if (!state) return;
+	const piniaState = state.pinia;
+	if (!piniaState || typeof piniaState !== "object") return;
+	const pinia = getPiniaFromApp(app);
+	if (!pinia) {
+		console.warn("[ubean/pinia] hydrateState 被调用但 app 上未检测到 $pinia。请确保 defineApp({ plugins: [createPinia()] }) 已配置。");
+		return;
+	}
+	pinia.state.value = piniaState;
+}
+//#endregion
+export { configureFontsRuntime, createFontHash, defaultFontDisplay, defaultFontStyles, defaultFontSubsets, defaultFontWeights, defineFontFamily, defineGoogleFont, defineLocalFont, extractFontUrlsFromCSS, fallbackFonts, generateFontCSS, generateFontCSSVariable, generateFontFace, generateFontFallbackCSS, generateFontLinks, generatePreconnectLink, generatePreloadLink, getBunnyFontsUrl, getFontFamilies, getFontHash, getFontsConfig, getFontshareUrl, getGoogleFontsUrl, getSWRegistration, googleFontMetrics, hydratePiniaState, normalizeFontFamily, normalizeFontName, parseFontFamilyCSS, registerSW, serializePiniaState, updateSW, usePwa, weightsToString };

package/dist/pinia/index.d.ts

@@ -0,0 +1,16 @@
+import { n as UbeanPiniaOptions, t as PiniaSerializedState } from "../types-Qd7x9Fbj.js";
+import { Plugin } from "vite";
+//#region src/pinia/index.d.ts
+/**
+ * ubean Pinia Vite 插件
+ *
+ * @param options 配置选项(`pinia: true` 时传入 `{}`,`pinia: { ... }` 时传入该对象)
+ * @returns Vite 插件数组
+ */
+declare function ubeanPiniaPlugin(options?: UbeanPiniaOptions): Plugin[];
+/**
+ * 类型安全的 Pinia 配置定义辅助函数(透传)
+ */
+declare function definePiniaConfig(options: UbeanPiniaOptions): UbeanPiniaOptions;
+//#endregion
+export { type PiniaSerializedState, type UbeanPiniaOptions, ubeanPiniaPlugin as default, ubeanPiniaPlugin, definePiniaConfig };

package/dist/pinia/index.js

@@ -0,0 +1,30 @@
+//#region src/pinia/index.ts
+/**
+* ubean Pinia Vite 插件
+*
+* @param options 配置选项(`pinia: true` 时传入 `{}`,`pinia: { ... }` 时传入该对象)
+* @returns Vite 插件数组
+*/
+function ubeanPiniaPlugin(options = {}) {
+	if (options.enabled === false) return [{
+		name: "ubean:pinia:noop",
+		enforce: "post"
+	}];
+	const optimizeDeps = options.optimizeDeps !== false;
+	return [{
+		name: "ubean:pinia",
+		enforce: "pre",
+		config() {
+			if (!optimizeDeps) return void 0;
+			return { optimizeDeps: { include: ["pinia"] } };
+		}
+	}];
+}
+/**
+* 类型安全的 Pinia 配置定义辅助函数(透传)
+*/
+function definePiniaConfig(options) {
+	return options;
+}
+//#endregion
+export { ubeanPiniaPlugin as default, ubeanPiniaPlugin, definePiniaConfig };

package/dist/pwa/index.d.ts

@@ -0,0 +1,47 @@
+import { a as ManifestScreenshot, c as RuntimeCachingRule, i as ManifestOrientation, l as UsePwaOptions, n as DisplayMode, o as PwaOptions, r as ManifestIcon, s as PwaState, t as CachingStrategy, u as WebAppManifest } from "../types-D94CeRo-.js";
+import { VitePWAOptions } from "vite-plugin-pwa";
+import { Plugin } from "vite";
+//#region src/pwa/index.d.ts
+/**
+ * 将 ubean PwaOptions 转换为 vite-plugin-pwa 的 VitePluginPWOptions。
+ *
+ * 映射关系:
+ * - manifest           → manifest
+ * - registerType       → registerType
+ * - injectRegister     → injectRegister
+ * - devOptions         → devOptions
+ * - skipWaiting        → workbox.skipWaiting
+ * - clientsClaim       → workbox.clientsClaim
+ * - cleanupOutdatedCaches → workbox.cleanupOutdatedCaches
+ * - strategies + runtimeCaching → workbox.runtimeCaching
+ * - injectManifest + swSrc → strategies: 'injectManifest' + injectManifest.swSrc
+ */
+declare function toVitePwaOptions(options?: PwaOptions): VitePWAOptions;
+/**
+ * ubean PWA Vite 插件(基于 vite-plugin-pwa)
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { ubeanPwaPlugin } from '@ubean/integrations/pwa';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     ubeanPwaPlugin({
+ *       manifest: { name: 'My App', theme_color: '#ff0000' },
+ *       registerType: 'prompt'
+ *     })
+ *   ]
+ * });
+ * ```
+ *
+ * 通常由 ubean module 系统在 `ubean.config.ts` 中 `pwa: true | PwaOptions` 自动加载,
+ * 无需在 vite.config.ts 中手动调用。
+ */
+declare function ubeanPwaPlugin(options?: PwaOptions): Plugin;
+/**
+ * 类型安全的 PWA 配置定义辅助函数(透传)
+ */
+declare function definePwaConfig(options: PwaOptions): PwaOptions;
+//#endregion
+export { type CachingStrategy, type DisplayMode, type ManifestIcon, type ManifestOrientation, type ManifestScreenshot, type PwaOptions, type PwaState, type RuntimeCachingRule, type UsePwaOptions, type WebAppManifest, ubeanPwaPlugin as default, ubeanPwaPlugin, definePwaConfig, toVitePwaOptions };

package/dist/pwa/index.js

@@ -0,0 +1,159 @@
+import { VitePWA } from "vite-plugin-pwa";
+import { defu } from "defu";
+//#region src/pwa/index.ts
+const DEFAULT_MANIFEST = {
+	name: "Ubean App",
+	short_name: "Ubean",
+	start_url: "/",
+	scope: "/",
+	display: "standalone",
+	background_color: "#ffffff",
+	theme_color: "#000000",
+	icons: [],
+	lang: "en"
+};
+const DEFAULT_STRATEGIES = {
+	assets: "cache-first",
+	pages: "network-first",
+	images: "stale-while-revalidate",
+	fonts: "cache-first",
+	crossOrigin: "network-first"
+};
+/**
+* 将 ubean 的 strategies(按资源类型)转换为 workbox runtimeCaching 规则。
+* 这些规则作为默认值,放在用户自定义 runtimeCaching 之前。
+*/
+function strategiesToRuntimeCaching(strategies) {
+	const rules = [];
+	if (strategies.assets) rules.push({
+		urlPattern: /\.(?:js|css|woff2?|ttf|eot)$/,
+		handler: strategies.assets,
+		options: { cacheName: "assets" }
+	});
+	if (strategies.pages) rules.push({
+		urlPattern: /\/$/,
+		handler: strategies.pages,
+		options: { cacheName: "pages" }
+	});
+	if (strategies.images) rules.push({
+		urlPattern: /\.(?:png|jpg|jpeg|gif|webp|svg|avif)$/,
+		handler: strategies.images,
+		options: {
+			cacheName: "images",
+			expiration: {
+				maxEntries: 60,
+				maxAgeSeconds: 2592e3
+			}
+		}
+	});
+	if (strategies.fonts) rules.push({
+		urlPattern: /\.(?:woff2?|ttf|eot|otf)$/,
+		handler: strategies.fonts,
+		options: {
+			cacheName: "fonts",
+			expiration: {
+				maxEntries: 10,
+				maxAgeSeconds: 31536e3
+			}
+		}
+	});
+	if (strategies.crossOrigin) rules.push({
+		urlPattern: /^https?:\/\/(?!localhost).*/,
+		handler: strategies.crossOrigin,
+		options: { cacheName: "cross-origin" }
+	});
+	return rules;
+}
+/**
+* 将 ubean PwaOptions 转换为 vite-plugin-pwa 的 VitePluginPWOptions。
+*
+* 映射关系:
+* - manifest           → manifest
+* - registerType       → registerType
+* - injectRegister     → injectRegister
+* - devOptions         → devOptions
+* - skipWaiting        → workbox.skipWaiting
+* - clientsClaim       → workbox.clientsClaim
+* - cleanupOutdatedCaches → workbox.cleanupOutdatedCaches
+* - strategies + runtimeCaching → workbox.runtimeCaching
+* - injectManifest + swSrc → strategies: 'injectManifest' + injectManifest.swSrc
+*/
+function toVitePwaOptions(options = {}) {
+	const { enabled = true, manifest, registerType = "autoUpdate", injectRegister = "auto", devOptions, strategies, runtimeCaching = [], skipWaiting = true, clientsClaim = true, cleanupOutdatedCaches = true, injectManifest = false, swSrc } = options;
+	if (!enabled) return { disable: true };
+	const resolvedManifest = defu(manifest ?? {}, DEFAULT_MANIFEST);
+	const allRuntimeCaching = [...strategiesToRuntimeCaching(defu(strategies ?? {}, DEFAULT_STRATEGIES)), ...runtimeCaching];
+	if (injectManifest) return {
+		strategies: "injectManifest",
+		registerType,
+		injectRegister: injectRegister ?? void 0,
+		manifest: resolvedManifest,
+		devOptions,
+		injectManifest: {
+			swSrc: swSrc ?? "src/sw.ts",
+			skipWaiting,
+			clientsClaim,
+			cleanupOutdatedCaches,
+			runtimeCaching: allRuntimeCaching
+		}
+	};
+	return {
+		strategies: "generateSW",
+		registerType,
+		injectRegister: injectRegister ?? void 0,
+		manifest: resolvedManifest,
+		devOptions,
+		workbox: {
+			skipWaiting,
+			clientsClaim,
+			cleanupOutdatedCaches,
+			runtimeCaching: allRuntimeCaching
+		}
+	};
+}
+/**
+* ubean PWA Vite 插件(基于 vite-plugin-pwa)
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import { ubeanPwaPlugin } from '@ubean/integrations/pwa';
+*
+* export default defineConfig({
+*   plugins: [
+*     ubeanPwaPlugin({
+*       manifest: { name: 'My App', theme_color: '#ff0000' },
+*       registerType: 'prompt'
+*     })
+*   ]
+* });
+* ```
+*
+* 通常由 ubean module 系统在 `ubean.config.ts` 中 `pwa: true | PwaOptions` 自动加载,
+* 无需在 vite.config.ts 中手动调用。
+*/
+function ubeanPwaPlugin(options = {}) {
+	if (options.enabled === false) return {
+		name: "ubean:pwa:noop",
+		enforce: "post"
+	};
+	const vitePwaOptions = toVitePwaOptions(options);
+	const plugins = VitePWA(vitePwaOptions);
+	const plugin = Array.isArray(plugins) ? plugins[0] : plugins;
+	if (!plugin) return {
+		name: "ubean:pwa:noop",
+		enforce: "post"
+	};
+	return {
+		...plugin,
+		name: `ubean:pwa(${plugin.name})`
+	};
+}
+/**
+* 类型安全的 PWA 配置定义辅助函数(透传)
+*/
+function definePwaConfig(options) {
+	return options;
+}
+//#endregion
+export { ubeanPwaPlugin as default, ubeanPwaPlugin, definePwaConfig, toVitePwaOptions };