@vlian/framework 1.2.57 → 1.2.60

package/README.md

@@ -89,7 +89,7 @@ await startApp({
 
 ## 按需导入
 
-框架支持按需导入（Tree Shaking），可以显著减少打包体积。你可以使用子路径导入来只导入需要的模块：
+框架支持按需导入（Tree Shaking），可以显著减少打包体积。主入口 `@vlian/framework` 主要用于兼容和快速接入，生产环境优先使用子路径导入来减少最终应用体积：
 
 ```typescript
 // 只导入核心启动功能
@@ -121,6 +121,18 @@ import { setupI18n, $t } from '@vlian/framework/library';
 
 使用按需导入可以减少 30-50% 的打包体积，具体取决于你使用的功能。详细说明请查看 [按需导入使用指南](./docs/general/按需导入使用指南.md)。
 
+## 外部依赖说明
+
+为了减小包体积，框架会将宿主应用应自行提供的核心依赖保持为外部依赖。安装本包时，请同时根据使用场景安装对应依赖：
+
+- `react`
+- `react-dom`
+- `react-router-dom`
+- `i18next`
+- `react-i18next`
+- `react-error-boundary`
+- `zod`
+
 ## 核心模块
 
 ### Core 模块
@@ -151,8 +163,8 @@ import { setupI18n, $t } from '@vlian/framework/library';
 
 - React: ^18.0.0 || ^19.0.0
 - React DOM: ^18.0.0 || ^19.0.0
-- Ant Design: ^5.0.0
-- React Router DOM: ^6.0.0 || ^7.0.0
+- React Router DOM: ^7.0.0
+- react-error-boundary: ^6.0.0
 
 ## 许可证
 

package/dist/analytics/index.cjs

@@ -1,24 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get AnalyticsService () {
-        return _analytics.AnalyticsService;
-    },
-    get getAnalytics () {
-        return _analytics.getAnalytics;
-    },
-    get initAnalytics () {
-        return _analytics.initAnalytics;
-    }
-});
-const _analytics = require("../utils/analytics");
-
-//# sourceMappingURL=index.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get AnalyticsService(){return _analytics.AnalyticsService},get getAnalytics(){return _analytics.getAnalytics},get initAnalytics(){return _analytics.initAnalytics}});const _analytics=require("../utils/analytics");

package/dist/analytics/index.js

@@ -1,3 +1 @@
-export { AnalyticsService, initAnalytics, getAnalytics } from "../utils/analytics";
-
-//# sourceMappingURL=index.js.map
+export{AnalyticsService,initAnalytics,getAnalytics}from"../utils/analytics";

package/dist/analytics.umd.js

@@ -1,219 +1,19 @@
 /*!
- * @vlian/framework v1.2.56
+ * @vlian/framework v1.2.59
  * Secra Framework - 一个现代化的低代码框架
  * (c) 2026 Secra Framework Contributors
  * Licensed under Apache-2.0
  */
 (function (global, factory) {
-   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@vlian/utils'), require('@vlian/logger')) :
-   typeof define === 'function' && define.amd ? define(['exports', '@vlian/utils', '@vlian/logger'], factory) :
-   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.vlianFrameworkAnalytics = {}, global.utils, global.logger));
+	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@vlian/utils'), require('@vlian/logger')) :
+	typeof define === 'function' && define.amd ? define(['exports', '@vlian/utils', '@vlian/logger'], factory) :
+	(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.vlianFrameworkAnalytics = {}, global.VlianUtils, global.VlianLogger));
 })(this, (function (exports, utils, logger) { 'use strict';
 
-   function _define_property(obj, key, value) {
-       if (key in obj) {
-           Object.defineProperty(obj, key, {
-               value: value,
-               enumerable: true,
-               configurable: true,
-               writable: true
-           });
-       } else {
-           obj[key] = value;
-       }
-       return obj;
-   }
-   /**
-    * 分析服务类
-    */ class AnalyticsService {
-       /**
-      * 启动批量上报定时器
-      */ startBatchTimer() {
-           if (this.batchTimer) {
-               return;
-           }
-           this.batchTimer = setInterval(()=>{
-               this.flush();
-           }, this.config.batchInterval);
-       }
-       /**
-      * 停止批量上报定时器
-      */ stopBatchTimer() {
-           if (this.batchTimer) {
-               clearInterval(this.batchTimer);
-               this.batchTimer = null;
-           }
-       }
-       /**
-      * 记录事件
-      */ track(event) {
-           if (!this.config.enabled) {
-               return;
-           }
-           // 采样检查
-           if (Math.random() > this.config.sampleRate) {
-               return;
-           }
-           // 匿名化处理
-           const anonymizedEvent = {
-               ...event,
-               timestamp: Date.now(),
-               properties: this.anonymizeProperties(event.properties)
-           };
-           // 添加到队列
-           this.eventQueue.push(anonymizedEvent);
-           // 立即上报单个事件
-           if (this.config.onEvent) {
-               this.config.onEvent(anonymizedEvent);
-           }
-           // 检查是否需要批量上报
-           if (this.eventQueue.length >= this.config.batchSize) {
-               this.flush();
-           }
-       }
-       /**
-      * 记录页面浏览
-      */ trackPageView(page, properties) {
-           this.track({
-               type: 'pageview',
-               name: 'page_view',
-               properties: {
-                   page,
-                   ...properties
-               }
-           });
-       }
-       /**
-      * 记录点击事件
-      */ trackClick(element, properties) {
-           this.track({
-               type: 'click',
-               name: 'click',
-               properties: {
-                   element,
-                   ...properties
-               }
-           });
-       }
-       /**
-      * 记录自定义事件
-      */ trackCustom(name, properties) {
-           this.track({
-               type: 'custom',
-               name,
-               properties
-           });
-       }
-       /**
-      * 记录错误事件
-      */ trackError(error, properties) {
-           this.track({
-               type: 'error',
-               name: 'error',
-               properties: {
-                   errorName: error.name,
-                   errorMessage: error.message,
-                   errorStack: error.stack,
-                   ...properties
-               }
-           });
-       }
-       /**
-      * 记录性能事件
-      */ trackPerformance(metrics, properties) {
-           this.track({
-               type: 'performance',
-               name: 'performance',
-               properties: {
-                   ...metrics,
-                   ...properties
-               }
-           });
-       }
-       /**
-      * 匿名化属性（使用深度脱敏）
-      */ anonymizeProperties(properties) {
-           if (!this.config.anonymize || !properties) {
-               return properties;
-           }
-           // 使用深度脱敏处理
-           return utils.SecurityUtils.deepSanitize(properties);
-       }
-       /**
-      * 刷新队列（批量上报）
-      */ flush() {
-           if (this.eventQueue.length === 0) {
-               return;
-           }
-           const events = [
-               ...this.eventQueue
-           ];
-           this.eventQueue = [];
-           if (this.config.onBatch) {
-               this.config.onBatch(events);
-           }
-           logger.logger.debug(`分析服务批量上报 ${events.length} 个事件`);
-       }
-       /**
-      * 启用分析
-      */ enable() {
-           this.config.enabled = true;
-           this.startBatchTimer();
-       }
-       /**
-      * 禁用分析
-      */ disable() {
-           this.config.enabled = false;
-           this.stopBatchTimer();
-           this.flush();
-       }
-       /**
-      * 销毁服务
-      */ destroy() {
-           this.stopBatchTimer();
-           this.flush();
-       }
-       constructor(config = {}){
-           _define_property(this, "config", void 0);
-           _define_property(this, "eventQueue", []);
-           _define_property(this, "batchTimer", null);
-           this.config = {
-               enabled: config.enabled ?? true,
-               sampleRate: config.sampleRate ?? 1.0,
-               anonymize: config.anonymize ?? true,
-               onEvent: config.onEvent ?? (()=>{}),
-               onBatch: config.onBatch ?? (()=>{}),
-               batchSize: config.batchSize ?? 10,
-               batchInterval: config.batchInterval ?? 5000
-           };
-           if (this.config.enabled) {
-               this.startBatchTimer();
-           }
-       }
-   }
-   /**
-    * 默认分析服务实例
-    */ let defaultAnalyticsService = null;
-   /**
-    * 初始化默认分析服务
-    */ function initAnalytics(config) {
-       if (!defaultAnalyticsService) {
-           defaultAnalyticsService = new AnalyticsService(config);
-       }
-       return defaultAnalyticsService;
-   }
-   /**
-    * 获取默认分析服务
-    */ function getAnalytics() {
-       if (!defaultAnalyticsService) {
-           return initAnalytics();
-       }
-       return defaultAnalyticsService;
-   }
+	function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true});}else {obj[key]=value;}return obj}class AnalyticsService{startBatchTimer(){if(this.batchTimer){return}this.batchTimer=setInterval(()=>{this.flush();},this.config.batchInterval);}stopBatchTimer(){if(this.batchTimer){clearInterval(this.batchTimer);this.batchTimer=null;}}track(event){if(!this.config.enabled){return}if(Math.random()>this.config.sampleRate){return}const anonymizedEvent={...event,timestamp:Date.now(),properties:this.anonymizeProperties(event.properties)};this.eventQueue.push(anonymizedEvent);if(this.config.onEvent){this.config.onEvent(anonymizedEvent);}if(this.eventQueue.length>=this.config.batchSize){this.flush();}}trackPageView(page,properties){this.track({type:"pageview",name:"page_view",properties:{page,...properties}});}trackClick(element,properties){this.track({type:"click",name:"click",properties:{element,...properties}});}trackCustom(name,properties){this.track({type:"custom",name,properties});}trackError(error,properties){this.track({type:"error",name:"error",properties:{errorName:error.name,errorMessage:error.message,errorStack:error.stack,...properties}});}trackPerformance(metrics,properties){this.track({type:"performance",name:"performance",properties:{...metrics,...properties}});}anonymizeProperties(properties){if(!this.config.anonymize||!properties){return properties}return utils.SecurityUtils.deepSanitize(properties)}flush(){if(this.eventQueue.length===0){return}const events=[...this.eventQueue];this.eventQueue=[];if(this.config.onBatch){this.config.onBatch(events);}logger.logger.debug(`分析服务批量上报 ${events.length} 个事件`);}enable(){this.config.enabled=true;this.startBatchTimer();}disable(){this.config.enabled=false;this.stopBatchTimer();this.flush();}destroy(){this.stopBatchTimer();this.flush();}constructor(config={}){_define_property(this,"config",void 0);_define_property(this,"eventQueue",[]);_define_property(this,"batchTimer",null);this.config={enabled:config.enabled??true,sampleRate:config.sampleRate??1,anonymize:config.anonymize??true,onEvent:config.onEvent??(()=>{}),onBatch:config.onBatch??(()=>{}),batchSize:config.batchSize??10,batchInterval:config.batchInterval??5e3};if(this.config.enabled){this.startBatchTimer();}}}let defaultAnalyticsService=null;function initAnalytics(config){if(!defaultAnalyticsService){defaultAnalyticsService=new AnalyticsService(config);}return defaultAnalyticsService}function getAnalytics(){if(!defaultAnalyticsService){return initAnalytics()}return defaultAnalyticsService}
 
-   exports.AnalyticsService = AnalyticsService;
-   exports.getAnalytics = getAnalytics;
-   exports.initAnalytics = initAnalytics;
+	exports.AnalyticsService = AnalyticsService;
+	exports.getAnalytics = getAnalytics;
+	exports.initAnalytics = initAnalytics;
 
 }));
-//# sourceMappingURL=analytics.umd.js.map

package/dist/components/LocaleSwitch.cjs

@@ -1,118 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "LocaleSwitch", {
-    enumerable: true,
-    get: function() {
-        return LocaleSwitch;
-    }
-});
-const _jsxruntime = require("react/jsx-runtime");
-const _react = /*#__PURE__*/ _interop_require_default(require("react"));
-const _core = require("../core");
-const _persistence = require("./persistence");
-function _interop_require_default(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
-    };
-}
-const DEFAULT_LOCALE_STORAGE_KEY = 'vlian:locale';
-const DEFAULT_LOCALES = [
-    'zh-CN',
-    'en-US'
-];
-const DEFAULT_PERSISTENCE = {
-    enabled: true
-};
-const DEFAULT_LABELS = {
-    'zh-CN': '中文',
-    'en-US': 'English'
-};
-function isLocale(value) {
-    return value === 'zh-CN' || value === 'en-US';
-}
-const LocaleSwitch = ({ locales = DEFAULT_LOCALES, labels = DEFAULT_LABELS, persistence, className, style, onChange, render })=>{
-    const { locale, setLocale, isChanging } = (0, _core.useLocale)();
-    const persistenceOptions = persistence || DEFAULT_PERSISTENCE;
-    const hydratedRef = _react.default.useRef(false);
-    const lastWrittenLocaleRef = _react.default.useRef(undefined);
-    const mergedLabels = _react.default.useMemo(()=>({
-            ...DEFAULT_LABELS,
-            ...labels
-        }), [
-        labels
-    ]);
-    _react.default.useEffect(()=>{
-        if (hydratedRef.current) {
-            return;
-        }
-        hydratedRef.current = true;
-        const persistedLocale = (0, _persistence.readPersistedValue)(persistenceOptions, DEFAULT_LOCALE_STORAGE_KEY);
-        if (!persistedLocale || !isLocale(persistedLocale) || !locales.includes(persistedLocale)) {
-            return;
-        }
-        if (persistedLocale !== locale) {
-            setLocale(persistedLocale);
-        }
-    }, [
-        locale,
-        locales,
-        persistenceOptions,
-        setLocale
-    ]);
-    _react.default.useEffect(()=>{
-        if (lastWrittenLocaleRef.current === locale) {
-            return;
-        }
-        (0, _persistence.writePersistedValue)(locale, persistenceOptions, DEFAULT_LOCALE_STORAGE_KEY);
-        lastWrittenLocaleRef.current = locale;
-    }, [
-        locale,
-        persistenceOptions
-    ]);
-    const handleSetLocale = _react.default.useCallback((nextLocale)=>{
-        if (nextLocale === locale) {
-            return;
-        }
-        setLocale(nextLocale);
-        onChange?.(nextLocale);
-    }, [
-        locale,
-        onChange,
-        setLocale
-    ]);
-    if (render) {
-        return render({
-            locale,
-            isChanging: Boolean(isChanging),
-            setLocale: handleSetLocale,
-            locales,
-            labels: mergedLabels
-        });
-    }
-    return /*#__PURE__*/ (0, _jsxruntime.jsxs)("label", {
-        className: className,
-        style: style,
-        children: [
-            /*#__PURE__*/ (0, _jsxruntime.jsx)("span", {
-                style: {
-                    display: 'none'
-                },
-                children: "Language Switch"
-            }),
-            /*#__PURE__*/ (0, _jsxruntime.jsx)("select", {
-                "aria-label": "Language Switch",
-                value: locale,
-                onChange: (event)=>handleSetLocale(event.target.value),
-                disabled: Boolean(isChanging),
-                children: locales.map((item)=>/*#__PURE__*/ (0, _jsxruntime.jsx)("option", {
-                        value: item,
-                        children: mergedLabels[item]
-                    }, item))
-            })
-        ]
-    });
-};
-
-//# sourceMappingURL=LocaleSwitch.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"LocaleSwitch",{enumerable:true,get:function(){return LocaleSwitch}});const _jsxruntime=require("react/jsx-runtime");const _react=/*#__PURE__*/_interop_require_default(require("react"));const _core=require("../core");const _persistence=require("./persistence");function _interop_require_default(obj){return obj&&obj.__esModule?obj:{default:obj}}const DEFAULT_LOCALE_STORAGE_KEY="vlian:locale";const DEFAULT_LOCALES=["zh-CN","en-US"];const DEFAULT_PERSISTENCE={enabled:true};const DEFAULT_LABELS={"zh-CN":"中文","en-US":"English"};function isLocale(value){return value==="zh-CN"||value==="en-US"}const LocaleSwitch=({locales=DEFAULT_LOCALES,labels=DEFAULT_LABELS,persistence,className,style,onChange,render})=>{const{locale,setLocale,isChanging}=(0,_core.useLocale)();const persistenceOptions=persistence||DEFAULT_PERSISTENCE;const hydratedRef=_react.default.useRef(false);const lastWrittenLocaleRef=_react.default.useRef(undefined);const mergedLabels=_react.default.useMemo(()=>({...DEFAULT_LABELS,...labels}),[labels]);_react.default.useEffect(()=>{if(hydratedRef.current){return}hydratedRef.current=true;const persistedLocale=(0,_persistence.readPersistedValue)(persistenceOptions,DEFAULT_LOCALE_STORAGE_KEY);if(!persistedLocale||!isLocale(persistedLocale)||!locales.includes(persistedLocale)){return}if(persistedLocale!==locale){setLocale(persistedLocale)}},[locale,locales,persistenceOptions,setLocale]);_react.default.useEffect(()=>{if(lastWrittenLocaleRef.current===locale){return}(0,_persistence.writePersistedValue)(locale,persistenceOptions,DEFAULT_LOCALE_STORAGE_KEY);lastWrittenLocaleRef.current=locale},[locale,persistenceOptions]);const handleSetLocale=_react.default.useCallback(nextLocale=>{if(nextLocale===locale){return}setLocale(nextLocale);onChange?.(nextLocale)},[locale,onChange,setLocale]);if(render){return render({locale,isChanging:Boolean(isChanging),setLocale:handleSetLocale,locales,labels:mergedLabels})}return(0,_jsxruntime.jsxs)("label",{className:className,style:style,children:[(0,_jsxruntime.jsx)("span",{style:{display:"none"},children:"Language Switch"}),(0,_jsxruntime.jsx)("select",{"aria-label":"Language Switch",value:locale,onChange:event=>handleSetLocale(event.target.value),disabled:Boolean(isChanging),children:locales.map(item=>(0,_jsxruntime.jsx)("option",{value:item,children:mergedLabels[item]},item))})]})};

package/dist/components/LocaleSwitch.js

@@ -1,103 +1 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import React from "react";
-import { useLocale } from "../core";
-import { readPersistedValue, writePersistedValue } from "./persistence";
-const DEFAULT_LOCALE_STORAGE_KEY = 'vlian:locale';
-const DEFAULT_LOCALES = [
-    'zh-CN',
-    'en-US'
-];
-const DEFAULT_PERSISTENCE = {
-    enabled: true
-};
-const DEFAULT_LABELS = {
-    'zh-CN': '中文',
-    'en-US': 'English'
-};
-function isLocale(value) {
-    return value === 'zh-CN' || value === 'en-US';
-}
-export const LocaleSwitch = ({ locales = DEFAULT_LOCALES, labels = DEFAULT_LABELS, persistence, className, style, onChange, render })=>{
-    const { locale, setLocale, isChanging } = useLocale();
-    const persistenceOptions = persistence || DEFAULT_PERSISTENCE;
-    const hydratedRef = React.useRef(false);
-    const lastWrittenLocaleRef = React.useRef(undefined);
-    const mergedLabels = React.useMemo(()=>({
-            ...DEFAULT_LABELS,
-            ...labels
-        }), [
-        labels
-    ]);
-    React.useEffect(()=>{
-        if (hydratedRef.current) {
-            return;
-        }
-        hydratedRef.current = true;
-        const persistedLocale = readPersistedValue(persistenceOptions, DEFAULT_LOCALE_STORAGE_KEY);
-        if (!persistedLocale || !isLocale(persistedLocale) || !locales.includes(persistedLocale)) {
-            return;
-        }
-        if (persistedLocale !== locale) {
-            setLocale(persistedLocale);
-        }
-    }, [
-        locale,
-        locales,
-        persistenceOptions,
-        setLocale
-    ]);
-    React.useEffect(()=>{
-        if (lastWrittenLocaleRef.current === locale) {
-            return;
-        }
-        writePersistedValue(locale, persistenceOptions, DEFAULT_LOCALE_STORAGE_KEY);
-        lastWrittenLocaleRef.current = locale;
-    }, [
-        locale,
-        persistenceOptions
-    ]);
-    const handleSetLocale = React.useCallback((nextLocale)=>{
-        if (nextLocale === locale) {
-            return;
-        }
-        setLocale(nextLocale);
-        onChange?.(nextLocale);
-    }, [
-        locale,
-        onChange,
-        setLocale
-    ]);
-    if (render) {
-        return render({
-            locale,
-            isChanging: Boolean(isChanging),
-            setLocale: handleSetLocale,
-            locales,
-            labels: mergedLabels
-        });
-    }
-    return /*#__PURE__*/ _jsxs("label", {
-        className: className,
-        style: style,
-        children: [
-            /*#__PURE__*/ _jsx("span", {
-                style: {
-                    display: 'none'
-                },
-                children: "Language Switch"
-            }),
-            /*#__PURE__*/ _jsx("select", {
-                "aria-label": "Language Switch",
-                value: locale,
-                onChange: (event)=>handleSetLocale(event.target.value),
-                disabled: Boolean(isChanging),
-                children: locales.map((item)=>/*#__PURE__*/ _jsx("option", {
-                        value: item,
-                        children: mergedLabels[item]
-                    }, item))
-            })
-        ]
-    });
-};
-
-//# sourceMappingURL=LocaleSwitch.js.map
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React from"react";import{useLocale}from"../core";import{readPersistedValue,writePersistedValue}from"./persistence";const DEFAULT_LOCALE_STORAGE_KEY="vlian:locale";const DEFAULT_LOCALES=["zh-CN","en-US"];const DEFAULT_PERSISTENCE={enabled:true};const DEFAULT_LABELS={"zh-CN":"中文","en-US":"English"};function isLocale(value){return value==="zh-CN"||value==="en-US"}export const LocaleSwitch=({locales=DEFAULT_LOCALES,labels=DEFAULT_LABELS,persistence,className,style,onChange,render})=>{const{locale,setLocale,isChanging}=useLocale();const persistenceOptions=persistence||DEFAULT_PERSISTENCE;const hydratedRef=React.useRef(false);const lastWrittenLocaleRef=React.useRef(undefined);const mergedLabels=React.useMemo(()=>({...DEFAULT_LABELS,...labels}),[labels]);React.useEffect(()=>{if(hydratedRef.current){return}hydratedRef.current=true;const persistedLocale=readPersistedValue(persistenceOptions,DEFAULT_LOCALE_STORAGE_KEY);if(!persistedLocale||!isLocale(persistedLocale)||!locales.includes(persistedLocale)){return}if(persistedLocale!==locale){setLocale(persistedLocale)}},[locale,locales,persistenceOptions,setLocale]);React.useEffect(()=>{if(lastWrittenLocaleRef.current===locale){return}writePersistedValue(locale,persistenceOptions,DEFAULT_LOCALE_STORAGE_KEY);lastWrittenLocaleRef.current=locale},[locale,persistenceOptions]);const handleSetLocale=React.useCallback(nextLocale=>{if(nextLocale===locale){return}setLocale(nextLocale);onChange?.(nextLocale)},[locale,onChange,setLocale]);if(render){return render({locale,isChanging:Boolean(isChanging),setLocale:handleSetLocale,locales,labels:mergedLabels})}return _jsxs("label",{className:className,style:style,children:[_jsx("span",{style:{display:"none"},children:"Language Switch"}),_jsx("select",{"aria-label":"Language Switch",value:locale,onChange:event=>handleSetLocale(event.target.value),disabled:Boolean(isChanging),children:locales.map(item=>_jsx("option",{value:item,children:mergedLabels[item]},item))})]})};

package/dist/components/ThemeSwitch.cjs

@@ -1,117 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "ThemeSwitch", {
-    enumerable: true,
-    get: function() {
-        return ThemeSwitch;
-    }
-});
-const _jsxruntime = require("react/jsx-runtime");
-const _react = /*#__PURE__*/ _interop_require_default(require("react"));
-const _core = require("../core");
-const _persistence = require("./persistence");
-function _interop_require_default(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
-    };
-}
-const DEFAULT_THEME_STORAGE_KEY = 'vlian:theme-mode';
-const DEFAULT_MODES = [
-    'light',
-    'dark',
-    'system'
-];
-const DEFAULT_PERSISTENCE = {
-    enabled: true
-};
-const DEFAULT_LABELS = {
-    light: '浅色',
-    dark: '深色',
-    system: '跟随系统'
-};
-function isThemeMode(value) {
-    return value === 'light' || value === 'dark' || value === 'system';
-}
-const ThemeSwitch = ({ modes = DEFAULT_MODES, labels = DEFAULT_LABELS, persistence, className, style, onChange, render })=>{
-    const { theme, setTheme } = (0, _core.useTheme)();
-    const persistenceOptions = persistence || DEFAULT_PERSISTENCE;
-    const hydratedRef = _react.default.useRef(false);
-    const lastWrittenModeRef = _react.default.useRef(undefined);
-    const mergedLabels = _react.default.useMemo(()=>({
-            ...DEFAULT_LABELS,
-            ...labels
-        }), [
-        labels
-    ]);
-    _react.default.useEffect(()=>{
-        if (hydratedRef.current) {
-            return;
-        }
-        hydratedRef.current = true;
-        const persistedMode = (0, _persistence.readPersistedValue)(persistenceOptions, DEFAULT_THEME_STORAGE_KEY);
-        if (!persistedMode || !isThemeMode(persistedMode) || !modes.includes(persistedMode)) {
-            return;
-        }
-        if (persistedMode !== theme.mode) {
-            setTheme((prev)=>({
-                    ...prev,
-                    mode: persistedMode
-                }));
-        }
-    }, [
-        modes,
-        persistenceOptions,
-        setTheme,
-        theme.mode
-    ]);
-    _react.default.useEffect(()=>{
-        const mode = theme.mode;
-        if (!mode || lastWrittenModeRef.current === mode) {
-            return;
-        }
-        (0, _persistence.writePersistedValue)(mode, persistenceOptions, DEFAULT_THEME_STORAGE_KEY);
-        lastWrittenModeRef.current = mode;
-    }, [
-        persistenceOptions,
-        theme.mode
-    ]);
-    const currentMode = theme.mode || 'light';
-    const setMode = _react.default.useCallback((mode)=>{
-        if (mode === currentMode) {
-            return;
-        }
-        setTheme((prev)=>({
-                ...prev,
-                mode
-            }));
-        onChange?.(mode);
-    }, [
-        currentMode,
-        onChange,
-        setTheme
-    ]);
-    if (render) {
-        return render({
-            mode: currentMode,
-            setMode,
-            modes,
-            labels: mergedLabels
-        });
-    }
-    return /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
-        className: className,
-        style: style,
-        role: "group",
-        "aria-label": "Theme Switch",
-        children: modes.map((mode)=>/*#__PURE__*/ (0, _jsxruntime.jsx)("button", {
-                type: "button",
-                onClick: ()=>setMode(mode),
-                "aria-pressed": currentMode === mode,
-                children: mergedLabels[mode]
-            }, mode))
-    });
-};
-
-//# sourceMappingURL=ThemeSwitch.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"ThemeSwitch",{enumerable:true,get:function(){return ThemeSwitch}});const _jsxruntime=require("react/jsx-runtime");const _react=/*#__PURE__*/_interop_require_default(require("react"));const _core=require("../core");const _persistence=require("./persistence");function _interop_require_default(obj){return obj&&obj.__esModule?obj:{default:obj}}const DEFAULT_THEME_STORAGE_KEY="vlian:theme-mode";const DEFAULT_MODES=["light","dark","system"];const DEFAULT_PERSISTENCE={enabled:true};const DEFAULT_LABELS={light:"浅色",dark:"深色",system:"跟随系统"};function isThemeMode(value){return value==="light"||value==="dark"||value==="system"}const ThemeSwitch=({modes=DEFAULT_MODES,labels=DEFAULT_LABELS,persistence,className,style,onChange,render})=>{const{theme,setTheme}=(0,_core.useTheme)();const persistenceOptions=persistence||DEFAULT_PERSISTENCE;const hydratedRef=_react.default.useRef(false);const lastWrittenModeRef=_react.default.useRef(undefined);const mergedLabels=_react.default.useMemo(()=>({...DEFAULT_LABELS,...labels}),[labels]);_react.default.useEffect(()=>{if(hydratedRef.current){return}hydratedRef.current=true;const persistedMode=(0,_persistence.readPersistedValue)(persistenceOptions,DEFAULT_THEME_STORAGE_KEY);if(!persistedMode||!isThemeMode(persistedMode)||!modes.includes(persistedMode)){return}if(persistedMode!==theme.mode){setTheme(prev=>({...prev,mode:persistedMode}))}},[modes,persistenceOptions,setTheme,theme.mode]);_react.default.useEffect(()=>{const mode=theme.mode;if(!mode||lastWrittenModeRef.current===mode){return}(0,_persistence.writePersistedValue)(mode,persistenceOptions,DEFAULT_THEME_STORAGE_KEY);lastWrittenModeRef.current=mode},[persistenceOptions,theme.mode]);const currentMode=theme.mode||"light";const setMode=_react.default.useCallback(mode=>{if(mode===currentMode){return}setTheme(prev=>({...prev,mode}));onChange?.(mode)},[currentMode,onChange,setTheme]);if(render){return render({mode:currentMode,setMode,modes,labels:mergedLabels})}return(0,_jsxruntime.jsx)("div",{className:className,style:style,role:"group","aria-label":"Theme Switch",children:modes.map(mode=>(0,_jsxruntime.jsx)("button",{type:"button",onClick:()=>setMode(mode),"aria-pressed":currentMode===mode,children:mergedLabels[mode]},mode))})};