@puresnake/snake-ui 0.0.0-stage → 0.0.1

package/libs/util/calendar.ts

@@ -0,0 +1,6 @@
+// @ts-nocheck
+/**
+ * 农历/公历互转，内联自 jjonline/calendar.js，保持原样不修改。
+ * 提供 solar2lunar / lunar2solar 等换算能力，供日历组件展示农历使用。
+ */
+export default {lunarInfo:[19416,19168,42352,21717,53856,55632,91476,22176,39632,21970,19168,42422,42192,53840,119381,46400,54944,44450,38320,84343,18800,42160,46261,27216,27968,109396,11104,38256,21234,18800,25958,54432,59984,28309,23248,11104,100067,37600,116951,51536,54432,120998,46416,22176,107956,9680,37584,53938,43344,46423,27808,46416,86869,19872,42416,83315,21168,43432,59728,27296,44710,43856,19296,43748,42352,21088,62051,55632,23383,22176,38608,19925,19152,42192,54484,53840,54616,46400,46752,103846,38320,18864,43380,42160,45690,27216,27968,44870,43872,38256,19189,18800,25776,29859,59984,27480,23232,43872,38613,37600,51552,55636,54432,55888,30034,22176,43959,9680,37584,51893,43344,46240,47780,44368,21977,19360,42416,86390,21168,43312,31060,27296,44368,23378,19296,42726,42208,53856,60005,54576,23200,30371,38608,19195,19152,42192,118966,53840,54560,56645,46496,22224,21938,18864,42359,42160,43600,111189,27936,44448,84835,37744,18936,18800,25776,92326,59984,27424,108228,43744,41696,53987,51552,54615,54432,55888,23893,22176,42704,21972,21200,43448,43344,46240,46758,44368,21920,43940,42416,21168,45683,26928,29495,27296,44368,84821,19296,42352,21732,53600,59752,54560,55968,92838,22224,19168,43476,41680,53584,62034,54560],solarMonth:[31,28,31,30,31,30,31,31,30,31,30,31],Gan:["甲","乙","丙","丁","戊","己","庚","辛","壬","癸"],Zhi:["子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥"],Animals:["鼠","牛","虎","兔","龙","蛇","马","羊","猴","鸡","狗","猪"],solarTerm:["小寒","大寒","立春","雨水","惊蛰","春分","清明","谷雨","立夏","小满","芒种","夏至","小暑","大暑","立秋","处暑","白露","秋分","寒露","霜降","立冬","小雪","大雪","冬至"],sTermInfo:["9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c3598082c95f8c965cc920f","97bd0b06bdb0722c965ce1cfcc920f","b027097bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c359801ec95f8c965cc920f","97bd0b06bdb0722c965ce1cfcc920f","b027097bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c359801ec95f8c965cc920f","97bd0b06bdb0722c965ce1cfcc920f","b027097bd097c36b0b6fc9274c91aa","9778397bd19801ec9210c965cc920e","97b6b97bd19801ec95f8c965cc920f","97bd09801d98082c95f8e1cfcc920f","97bd097bd097c36b0b6fc9210c8dc2","9778397bd197c36c9210c9274c91aa","97b6b97bd19801ec95f8c965cc920e","97bd09801d98082c95f8e1cfcc920f","97bd097bd097c36b0b6fc9210c8dc2","9778397bd097c36c9210c9274c91aa","97b6b97bd19801ec95f8c965cc920e","97bcf97c3598082c95f8e1cfcc920f","97bd097bd097c36b0b6fc9210c8dc2","9778397bd097c36c9210c9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c3598082c95f8c965cc920f","97bd097bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c3598082c95f8c965cc920f","97bd097bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c359801ec95f8c965cc920f","97bd097bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c359801ec95f8c965cc920f","97bd097bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf97c359801ec95f8c965cc920f","97bd097bd07f595b0b6fc920fb0722","9778397bd097c36b0b6fc9210c8dc2","9778397bd19801ec9210c9274c920e","97b6b97bd19801ec95f8c965cc920f","97bd07f5307f595b0b0bc920fb0722","7f0e397bd097c36b0b6fc9210c8dc2","9778397bd097c36c9210c9274c920e","97b6b97bd19801ec95f8c965cc920f","97bd07f5307f595b0b0bc920fb0722","7f0e397bd097c36b0b6fc9210c8dc2","9778397bd097c36c9210c9274c91aa","97b6b97bd19801ec9210c965cc920e","97bd07f1487f595b0b0bc920fb0722","7f0e397bd097c36b0b6fc9210c8dc2","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf7f1487f595b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf7f1487f595b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf7f1487f531b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c965cc920e","97bcf7f1487f531b0b0bb0b6fb0722","7f0e397bd07f595b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b97bd19801ec9210c9274c920e","97bcf7f0e47f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","9778397bd097c36b0b6fc9210c91aa","97b6b97bd197c36c9210c9274c920e","97bcf7f0e47f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","9778397bd097c36b0b6fc9210c8dc2","9778397bd097c36c9210c9274c920e","97b6b7f0e47f531b0723b0b6fb0722","7f0e37f5307f595b0b0bc920fb0722","7f0e397bd097c36b0b6fc9210c8dc2","9778397bd097c36b0b70c9274c91aa","97b6b7f0e47f531b0723b0b6fb0721","7f0e37f1487f595b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc9210c8dc2","9778397bd097c36b0b6fc9274c91aa","97b6b7f0e47f531b0723b0b6fb0721","7f0e27f1487f595b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","9778397bd097c36b0b6fc9274c91aa","97b6b7f0e47f531b0723b0787b0721","7f0e27f0e47f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","9778397bd097c36b0b6fc9210c91aa","97b6b7f0e47f149b0723b0787b0721","7f0e27f0e47f531b0723b0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","9778397bd097c36b0b6fc9210c8dc2","977837f0e37f149b0723b0787b0721","7f07e7f0e47f531b0723b0b6fb0722","7f0e37f5307f595b0b0bc920fb0722","7f0e397bd097c35b0b6fc9210c8dc2","977837f0e37f14998082b0787b0721","7f07e7f0e47f531b0723b0b6fb0721","7f0e37f1487f595b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc9210c8dc2","977837f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","977837f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd097c35b0b6fc920fb0722","977837f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","977837f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","977837f0e37f14998082b0787b06bd","7f07e7f0e47f149b0723b0787b0721","7f0e27f0e47f531b0b0bb0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","977837f0e37f14998082b0723b06bd","7f07e7f0e37f149b0723b0787b0721","7f0e27f0e47f531b0723b0b6fb0722","7f0e397bd07f595b0b0bc920fb0722","977837f0e37f14898082b0723b02d5","7ec967f0e37f14998082b0787b0721","7f07e7f0e47f531b0723b0b6fb0722","7f0e37f1487f595b0b0bb0b6fb0722","7f0e37f0e37f14898082b0723b02d5","7ec967f0e37f14998082b0787b0721","7f07e7f0e47f531b0723b0b6fb0722","7f0e37f1487f531b0b0bb0b6fb0722","7f0e37f0e37f14898082b0723b02d5","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e37f1487f531b0b0bb0b6fb0722","7f0e37f0e37f14898082b072297c35","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e37f0e37f14898082b072297c35","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e37f0e366aa89801eb072297c35","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f149b0723b0787b0721","7f0e27f1487f531b0b0bb0b6fb0722","7f0e37f0e366aa89801eb072297c35","7ec967f0e37f14998082b0723b06bd","7f07e7f0e47f149b0723b0787b0721","7f0e27f0e47f531b0723b0b6fb0722","7f0e37f0e366aa89801eb072297c35","7ec967f0e37f14998082b0723b06bd","7f07e7f0e37f14998083b0787b0721","7f0e27f0e47f531b0723b0b6fb0722","7f0e37f0e366aa89801eb072297c35","7ec967f0e37f14898082b0723b02d5","7f07e7f0e37f14998082b0787b0721","7f07e7f0e47f531b0723b0b6fb0722","7f0e36665b66aa89801e9808297c35","665f67f0e37f14898082b0723b02d5","7ec967f0e37f14998082b0787b0721","7f07e7f0e47f531b0723b0b6fb0722","7f0e36665b66a449801e9808297c35","665f67f0e37f14898082b0723b02d5","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e36665b66a449801e9808297c35","665f67f0e37f14898082b072297c35","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e26665b66a449801e9808297c35","665f67f0e37f1489801eb072297c35","7ec967f0e37f14998082b0787b06bd","7f07e7f0e47f531b0723b0b6fb0721","7f0e27f1487f531b0b0bb0b6fb0722"],nStr1:["日","一","二","三","四","五","六","七","八","九","十"],nStr2:["初","十","廿","卅"],nStr3:["正","二","三","四","五","六","七","八","九","十","冬","腊"],lYearDays:function(b){for(var f=348,c=32768;8<c;c>>=1)f+=this.lunarInfo[b-1900]&c?1:0;return f+this.leapDays(b)},leapMonth:function(b){return 15&this.lunarInfo[b-1900]},leapDays:function(b){return this.leapMonth(b)?65536&this.lunarInfo[b-1900]?30:29:0},monthDays:function(b,f){return 12<f||f<1?-1:this.lunarInfo[b-1900]&65536>>f?30:29},solarDays:function(b,f){if(12<f||f<1)return-1;--f;return 1==f?b%4==0&&b%100!=0||b%400==0?29:28:this.solarMonth[f]},toGanZhiYear:function(b){var f=(b-3)%10,b=(b-3)%12;return 0==f&&(f=10),0==b&&(b=12),this.Gan[f-1]+this.Zhi[b-1]},toAstro:function(b,f){return"魔羯水瓶双鱼白羊金牛双子巨蟹狮子处女天秤天蝎射手魔羯".substr(2*b-(f<[20,19,21,21,21,22,23,23,23,23,22,22][b-1]?2:0),2)+"座"},toGanZhi:function(b){return this.Gan[b%10]+this.Zhi[b%12]},getTerm:function(b,f){if(b<1900||2100<b)return-1;if(f<1||24<f)return-1;b=this.sTermInfo[b-1900],b=[parseInt("0x"+b.substr(0,5)).toString(),parseInt("0x"+b.substr(5,5)).toString(),parseInt("0x"+b.substr(10,5)).toString(),parseInt("0x"+b.substr(15,5)).toString(),parseInt("0x"+b.substr(20,5)).toString(),parseInt("0x"+b.substr(25,5)).toString()],b=[b[0].substr(0,1),b[0].substr(1,2),b[0].substr(3,1),b[0].substr(4,2),b[1].substr(0,1),b[1].substr(1,2),b[1].substr(3,1),b[1].substr(4,2),b[2].substr(0,1),b[2].substr(1,2),b[2].substr(3,1),b[2].substr(4,2),b[3].substr(0,1),b[3].substr(1,2),b[3].substr(3,1),b[3].substr(4,2),b[4].substr(0,1),b[4].substr(1,2),b[4].substr(3,1),b[4].substr(4,2),b[5].substr(0,1),b[5].substr(1,2),b[5].substr(3,1),b[5].substr(4,2)];return parseInt(b[f-1])},toChinaMonth:function(b){if(12<b||b<1)return-1;b=this.nStr3[b-1];return b+="月"},toChinaDay:function(b){var f;switch(b){case 10:f="初十";break;case 20:f="二十";break;case 30:f="三十";break;default:f=this.nStr2[Math.floor(b/10)],f+=this.nStr1[b%10]}return f},getAnimal:function(b){return this.Animals[(b-4)%12]},solar2lunar:function(b,f,c){if(b<1900||2100<b)return-1;if(1900==b&&1==f&&c<31)return-1;for(var e=0,b=(M=b?new Date(b,parseInt(f)-1,c):new Date).getFullYear(),f=M.getMonth()+1,c=M.getDate(),t=(Date.UTC(M.getFullYear(),M.getMonth(),M.getDate())-Date.UTC(1900,0,31))/864e5,a=1900;a<2101&&0<t;a++)t-=e=this.lYearDays(a);t<0&&(t+=e,a--);var r=new Date,s=!1;r.getFullYear()==b&&r.getMonth()+1==f&&r.getDate()==c&&(s=!0);var d=M.getDay(),n=this.nStr1[d];0==d&&(d=7);var i=a,u=this.leapMonth(a),o=!1;for(a=1;a<13&&0<t;a++)e=0<u&&a==u+1&&0==o?(--a,o=!0,this.leapDays(i)):this.monthDays(i,a),1==o&&a==u+1&&(o=!1),t-=e;0==t&&0<u&&a==u+1&&(o?o=!1:(o=!0,--a)),t<0&&(t+=e,--a);var h=a,l=t+1,D=f-1,g=this.toGanZhiYear(i),y=this.getTerm(b,2*f-1),p=this.getTerm(b,2*f),m=this.toGanZhi(12*(b-1900)+f+11);y<=c&&(m=this.toGanZhi(12*(b-1900)+f+12));var r=!1,M=null;y==c&&(r=!0,M=this.solarTerm[2*f-2]),p==c&&(r=!0,M=this.solarTerm[2*f-1]);p=Date.UTC(b,D,1,0,0,0,0)/864e5+25567+10,D=this.toGanZhi(p+c-1),p=this.toAstro(f,c);return{lYear:i,lMonth:h,lDay:l,Animal:this.getAnimal(i),IMonthCn:(o?"闰":"")+this.toChinaMonth(h),IDayCn:this.toChinaDay(l),cYear:b,cMonth:f,cDay:c,gzYear:g,gzMonth:m,gzDay:D,isToday:s,isLeap:o,nWeek:d,ncWeek:"星期"+n,isTerm:r,Term:M,astro:p}},lunar2solar:function(b,f,c,e){var e=!!e,t=this.leapMonth(b);this.leapDays(b);if(e&&t!=f)return-1;if(2100==b&&12==f&&1<c||1900==b&&1==f&&c<31)return-1;var a=this.monthDays(b,f),t=a;if(e&&(t=this.leapDays(b,f)),b<1900||2100<b||t<c)return-1;for(var r=0,s=1900;s<b;s++)r+=this.lYearDays(s);for(var d,n=!1,s=1;s<f;s++)d=this.leapMonth(b),n||d<=s&&0<d&&(r+=this.leapDays(b),n=!0),r+=this.monthDays(b,s);e&&(r+=a);e=Date.UTC(1900,1,30,0,0,0),a=new Date(864e5*(r+c-31)+e),c=a.getUTCFullYear(),e=a.getUTCMonth()+1,a=a.getUTCDate();return this.solar2lunar(c,e,a)}};

package/locale/index.ts

@@ -0,0 +1,130 @@
+import { ref } from 'vue';
+import { isDebugMode, config } from '../libs/config/state';
+import type { Locale, LocaleOption } from '../libs/config/types';
+import enUS from './lang/en-US';
+import zhCN from './lang/zh-CN';
+
+const LOCALE_STORAGE_KEY = 'snake-ui-locale';
+
+export { enUS, zhCN };
+
+export const locales = ref<Locale[]>([zhCN, enUS]);
+export const currentLocale = ref<Locale>(zhCN);
+
+let initialized = false;
+
+function readLocale(): string | undefined {
+    try {
+        if (typeof uni !== 'undefined' && typeof uni.getStorageSync === 'function') {
+            return uni.getStorageSync(LOCALE_STORAGE_KEY) || undefined;
+        }
+    } catch (error) {
+        if (isDebugMode('warn')) console.warn('[Snake UI] failed to read locale', error);
+    }
+    return undefined;
+}
+
+function writeLocale(name: string): void {
+    try {
+        if (typeof uni !== 'undefined' && typeof uni.setStorageSync === 'function') {
+            uni.setStorageSync(LOCALE_STORAGE_KEY, name);
+        }
+    } catch (error) {
+        if (isDebugMode('warn')) console.warn('[Snake UI] failed to persist locale', error);
+    }
+}
+
+function deepMergeMessages(base: Record<string, unknown>, patch: Record<string, unknown>): Record<string, unknown> {
+    const result = { ...base };
+    Object.entries(patch).forEach(([key, value]) => {
+        const previous = result[key];
+        result[key] =
+            previous && value && typeof previous === 'object' && typeof value === 'object'
+                ? deepMergeMessages(previous as Record<string, unknown>, value as Record<string, unknown>)
+                : value;
+    });
+    return result;
+}
+
+function mergeLocales(custom: Locale[]): Locale[] {
+    const map = new Map<string, Locale>([
+        [zhCN.name, zhCN],
+        [enUS.name, enUS]
+    ]);
+    custom.forEach(locale => {
+        const base = map.get(locale.name);
+        map.set(locale.name, {
+            ...base,
+            ...locale,
+            messages: deepMergeMessages(base?.messages || {}, locale.messages || {})
+        });
+    });
+    return Array.from(map.values());
+}
+
+export function initLocale(option?: LocaleOption): void {
+    let localeEntries: Locale[] = [];
+    let defaultLocale = config.defaultLocale;
+    let force = false;
+    if (typeof option === 'string') {
+        defaultLocale = option;
+    } else if (Array.isArray(option)) {
+        localeEntries = option;
+    } else if (option) {
+        localeEntries = option.locales || [];
+        defaultLocale = option.defaultLocale || defaultLocale;
+        force = Boolean(option.force);
+    }
+    if (!initialized || force || localeEntries.length) locales.value = mergeLocales(localeEntries);
+    const initialName = (force ? undefined : readLocale()) || defaultLocale;
+    currentLocale.value =
+        locales.value.find(locale => locale.name === initialName) ||
+        locales.value.find(locale => locale.name === 'zh-CN') ||
+        locales.value[0];
+    initialized = true;
+}
+
+export function setLocale(name: string): boolean {
+    const locale = locales.value.find(item => item.name === name);
+    if (!locale) return false;
+    currentLocale.value = locale;
+    writeLocale(name);
+    return true;
+}
+
+function readMessage(locale: Locale | undefined, key: string): string | undefined {
+    let current: unknown = locale?.messages;
+    for (const part of key.split('.')) {
+        if (!current || typeof current !== 'object') return undefined;
+        current = (current as Record<string, unknown>)[part];
+    }
+    return typeof current === 'string' ? current : undefined;
+}
+
+export function translate(
+    key: string,
+    replacements?: Record<string, unknown> | unknown[],
+    localeName?: string
+): string {
+    const selected = localeName
+        ? locales.value.find(locale => locale.name === localeName)
+        : currentLocale.value;
+    const fallback = locales.value.find(locale => locale.name === 'zh-CN');
+    let result = readMessage(selected, key) || readMessage(fallback, key) || key;
+    if (Array.isArray(replacements)) {
+        replacements.forEach((value, index) => {
+            result = result.split(`{${index}}`).join(String(value));
+        });
+    } else if (replacements) {
+        Object.entries(replacements).forEach(([name, value]) => {
+            result = result.split(`{${name}}`).join(String(value));
+        });
+    }
+    return result;
+}
+
+export function resetLocale(): void {
+    initialized = false;
+    locales.value = [zhCN, enUS];
+    currentLocale.value = zhCN;
+}

package/locale/lang/en-US.ts

@@ -0,0 +1,67 @@
+import type { Locale } from '../../libs/config/types';
+
+const enUS: Locale = {
+    name: 'en-US',
+    label: 'English',
+    messages: {
+        common: {
+            confirm: 'Confirm',
+            cancel: 'Cancel',
+            close: 'Close',
+            loading: 'Loading',
+            loadMore: 'Load more',
+            noMore: 'No more data',
+            empty: 'No data',
+            retry: 'Retry'
+        },
+        image: { loading: 'Loading image', error: 'Image failed to load' },
+        modal: { title: 'Prompt', confirmText: 'Confirm', cancelText: 'Cancel' },
+        network: { error: 'Network request failed', canceled: 'Request canceled' },
+        search: { placeholder: 'Please enter keywords', actionText: 'Search' },
+        select: { cancelText: 'Cancel', confirmText: 'Confirm' },
+        noNetwork: {
+            tips: 'Ooops, network disconnected',
+            retry: 'Retry',
+            noConnection: 'No network connection',
+            connected: 'Network connected'
+        },
+        readMore: { openText: 'Collapse', closeText: 'Read More' },
+        link: { mpTips: 'Link copied, please open it in browser' },
+        calendar: {
+            startText: 'Start',
+            endText: 'End',
+            toolTip: 'Select date',
+            outOfRange: 'Date out of range',
+            year: '/',
+            month: '',
+            sun: 'Sun',
+            mon: 'Mon',
+            tue: 'Tue',
+            wed: 'Wed',
+            thu: 'Thu',
+            fri: 'Fri',
+            sat: 'Sat',
+            confirmText: 'Confirm',
+            to: ' to ',
+            holiday: '休',
+            workday: '班'
+        },
+        countDown: {
+            day: 'd',
+            hour: 'h',
+            minute: 'm',
+            second: 's'
+        },
+        upload: {
+            uploadImage: 'Upload image', uploadVideo: 'Upload video', uploadFile: 'Upload file', uploadMedia: 'Upload media',
+            retry: 'Retry', reUpload: 'Uploading again', fileNotSupported: 'File selection is not supported on this platform',
+            overSize: 'File size exceeds the limit', overMaxCount: 'File count exceeds the limit',
+            noAction: 'Configure an upload action or uploadRequest', uploadFailed: 'Upload failed',
+            modalTitle: 'Prompt', deleteConfirm: 'Delete this file?', modalCancelText: 'Cancel', modalConfirmText: 'Confirm',
+            terminatedRemove: 'Removal canceled', removeSuccess: 'Removed', previewFailed: 'Preview failed',
+            openFailed: 'Unable to open this file', notAllowedExt: 'Unsupported file type: {ext}'
+        }
+    }
+};
+
+export default enUS;

package/locale/lang/zh-CN.ts

@@ -0,0 +1,67 @@
+import type { Locale } from '../../libs/config/types';
+
+const zhCN: Locale = {
+    name: 'zh-CN',
+    label: '简体中文',
+    messages: {
+        common: {
+            confirm: '确定',
+            cancel: '取消',
+            close: '关闭',
+            loading: '加载中',
+            loadMore: '加载更多',
+            noMore: '没有更多了',
+            empty: '暂无数据',
+            retry: '重试'
+        },
+        image: { loading: '图片加载中', error: '图片加载失败' },
+        modal: { title: '提示', confirmText: '确认', cancelText: '取消' },
+        network: { error: '网络请求失败', canceled: '请求已取消' },
+        search: { placeholder: '请输入关键字', actionText: '搜索' },
+        select: { cancelText: '取消', confirmText: '确认' },
+        noNetwork: {
+            tips: '哎呀，网络信号丢失',
+            retry: '重试',
+            noConnection: '无网络连接',
+            connected: '网络已连接'
+        },
+        readMore: { openText: '收起', closeText: '展开阅读全文' },
+        link: { mpTips: '链接已复制，请在浏览器打开' },
+        calendar: {
+            startText: '开始',
+            endText: '结束',
+            toolTip: '选择日期',
+            outOfRange: '日期超出范围啦~',
+            year: '年',
+            month: '月',
+            sun: '日',
+            mon: '一',
+            tue: '二',
+            wed: '三',
+            thu: '四',
+            fri: '五',
+            sat: '六',
+            confirmText: '确定',
+            to: '至',
+            holiday: '休',
+            workday: '班'
+        },
+        countDown: {
+            day: '天',
+            hour: '时',
+            minute: '分',
+            second: '秒'
+        },
+        upload: {
+            uploadImage: '上传图片', uploadVideo: '上传视频', uploadFile: '上传文件', uploadMedia: '上传媒体',
+            retry: '重试', reUpload: '重新上传', fileNotSupported: '当前平台暂不支持文件选择',
+            overSize: '文件大小超出限制', overMaxCount: '文件数量超出限制',
+            noAction: '请配置上传地址或自定义上传函数', uploadFailed: '上传失败',
+            modalTitle: '提示', deleteConfirm: '确认删除该文件吗？', modalCancelText: '取消', modalConfirmText: '确认',
+            terminatedRemove: '已取消删除', removeSuccess: '删除成功', previewFailed: '预览失败',
+            openFailed: '无法打开此文件', notAllowedExt: '不支持该文件类型：{ext}'
+        }
+    }
+};
+
+export default zhCN;

package/package.json

@@ -1,6 +1,131 @@
 {
-  "name": "@puresnake/snake-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "id": "snake-ui",
+    "name": "@puresnake/snake-ui",
+    "displayName": "Snake UI",
+    "version": "0.0.1",
+    "description": "面向 uni-app 商城与 CMS 场景的 Vue 组件库",
+    "license": "MIT",
+    "author": "PURESNAKE",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/zwbcode/snake-ui.git",
+        "directory": "src/uni_modules/snake-ui"
+    },
+    "bugs": {
+        "url": "https://github.com/zwbcode/snake-ui/issues"
+    },
+    "homepage": "https://github.com/zwbcode/snake-ui#readme",
+    "publishConfig": {
+        "access": "public"
+    },
+    "type": "module",
+    "main": "index.ts",
+    "module": "index.ts",
+    "browser": "index.ts",
+    "types": "index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./index.d.ts",
+            "import": "./index.ts",
+            "default": "./index.ts"
+        },
+        "./components/*": "./components/*",
+        "./libs": {
+            "types": "./libs/index.ts",
+            "import": "./libs/index.ts",
+            "default": "./libs/index.ts"
+        },
+        "./request": {
+            "types": "./libs/request/index.ts",
+            "import": "./libs/request/index.ts",
+            "default": "./libs/request/index.ts"
+        },
+        "./types": "./types/index.d.ts",
+        "./types/*": "./types/*.d.ts",
+        "./plugins": {
+            "types": "./plugins/index.ts",
+            "import": "./plugins/index.ts",
+            "default": "./plugins/index.ts"
+        },
+        "./locale": "./locale/index.ts",
+        "./index.scss": "./index.scss",
+        "./theme.scss": "./theme.scss",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "components",
+        "libs",
+        "locale",
+        "plugins",
+        "types",
+        "index.ts",
+        "index.d.ts",
+        "index.scss",
+        "theme.scss",
+        "iconfont.css",
+        "LICENSE",
+        "readme.md",
+        "changelog.md"
+    ],
+    "keywords": [
+        "snake-ui",
+        "uni-app",
+        "vue3",
+        "cms"
+    ],
+    "engines": {
+        "uni-app": "*"
+    },
+    "dcloudext": {
+        "type": "component-vue"
+    },
+    "peerDependencies": {
+        "@dcloudio/uni-app": ">=3.0.0",
+        "vue": ">=3.4.0"
+    },
+    "uni_modules": {
+        "dependencies": [],
+        "encrypt": [],
+        "platforms": {
+            "cloud": {
+                "tcb": "-",
+                "aliyun": "-",
+                "alipay": "-"
+            },
+            "client": {
+                "uni-app": {
+                    "vue": {
+                        "vue2": "x",
+                        "vue3": "√"
+                    },
+                    "web": {
+                        "safari": "-",
+                        "chrome": "-"
+                    },
+                    "app": {
+                        "vue": "-",
+                        "nvue": "x",
+                        "android": "-",
+                        "ios": "-",
+                        "harmony": "-"
+                    },
+                    "mp": {
+                        "weixin": "-",
+                        "alipay": "-",
+                        "toutiao": "-",
+                        "baidu": "-",
+                        "kuaishou": "-",
+                        "jd": "-",
+                        "harmony": "-",
+                        "qq": "-",
+                        "lark": "-"
+                    },
+                    "quickapp": {
+                        "huawei": "-",
+                        "union": "-"
+                    }
+                }
+            }
+        }
+    }
+}

package/plugins/index.ts

@@ -0,0 +1 @@
+export * from './root';

package/plugins/root/README.md

@@ -0,0 +1,86 @@
+# vite-plugin-snake-root
+
+Snake UI 虚拟根组件 Vite 插件,零额外依赖,纯字符串操作实现。
+
+## 解决的问题
+
+UniApp 不支持原生的根组件包裹机制,无法在全局统一注入 `snake-config-provider`、toast、modal 等需要在每个页面根部存在的组件。传统方案需要在每个页面手动添加,维护成本高。
+
+本插件通过 Vite 构建时注入,自动为每个页面包裹 `<global-root-view>` 根组件,无需修改任何页面代码本身。
+
+## 技术方案
+
+```
+App.root.vue(源码)        → 在 main.ts 中导入并注册为全局组件 global-root-view
+                              → 页面模板被包裹 <global-root-view> 页面内容 </global-root-view>
+                              → 渲染时页面内容填入 <slot />
+```
+
+三步实现:
+
+1. **main.ts 注入**(`root.ts -> registerRootApp`)
+   - 注入 `import GlobalRootView from "./App.root.vue"` 与 `app.component("global-root-view", GlobalRootView)`
+2. **页面模板包裹**(`page.ts -> transformPage`)
+   - 解析 SFC,提取 PageMeta 节点(如有则放到包裹层外部),模板内容包裹 `<global-root-view>`
+3. **App.root.vue 加载**(`index.ts -> load`)
+   - 拦截 `App.root.vue` 的模块请求,从文件读取并返回;模板中的 `<slot />` 接收页面内容
+
+## 使用方式
+
+### 1. 创建 App.root.vue(应用级,放在 src/ 下)
+
+```vue
+<script setup lang="ts">
+import ConfigProvider from './uni_modules/snake-ui/components/snake-config-provider/snake-config-provider.vue';
+</script>
+
+<template>
+    <ConfigProvider>
+        <slot />
+    </ConfigProvider>
+</template>
+```
+
+关键点:`<slot />` 是页面内容的渲染位置,必须保留。
+
+### 2. 配置 vite.config.ts
+
+```ts
+import { Root } from './src/uni_modules/snake-ui/plugins';
+
+export default defineConfig({
+    plugins: [Root(), uni()]
+});
+```
+
+### 3. 运行
+
+不需要修改任何页面代码,所有页面自动被 `<global-root-view>` 包裹。
+
+## 配置项
+
+```ts
+Root({
+    rootFileName: 'App.root' // 根组件文件名(不含扩展名),默认 App.root
+});
+```
+
+## 跨端兼容
+
+纯 Vite 构建时插件,在 UniApp 编译之前完成源代码转换,不依赖任何平台特定 API:
+
+H5 / 微信小程序 / 支付宝小程序 / 头条抖音小程序 / Android App / iOS App / 鸿蒙 App 均支持。
+
+## HMR 支持
+
+修改 `pages.json` 后自动重载页面列表,无需手动重启开发服务器。
+
+## 注意事项
+
+- Vue 版本需 >= 3.2.13(使用 `vue/compiler-sfc` 的 `parse` API,HBuilderX 环境下自动降级为正则匹配)
+- 页面模板中如有 `<page-meta>` 组件,会被提取到包裹层外部,确保微信小程序兼容
+- 页面模板中如有嵌套 `<template #slot>` 具名插槽,不影响根模板的正确识别
+
+## 致谢
+
+- 实现参考了 [@uni-ku/root](https://github.com/uni-ku/root)(MIT License,作者 skiyee),核心思路受其启发并进行了重新实现。

package/plugins/root/index.ts

@@ -0,0 +1,123 @@
+import type { Plugin } from 'vite';
+import { resolve, join } from 'node:path';
+import process from 'node:process';
+import { watch, readFileSync } from 'node:fs';
+import { normalizePath } from 'vite';
+import { registerRootApp, rebuildRootApp } from './root';
+import { transformPage } from './page';
+import { loadPagesJson, normalizePlatformPath, debounce } from './utils';
+
+interface RootOptions {
+    /** 根组件文件名（不含扩展名），默认 App.root */
+    rootFileName?: string;
+}
+
+/**
+ * 规范化模块 ID：统一路径分隔符，统一 Windows 盘符为小写
+ */
+function normalizeId(id: string) {
+    return normalizePath(id).replace(/^[A-Z]:/, match => match.toLowerCase());
+}
+
+/**
+ * Snake UI 虚拟根组件 Vite 插件（uni-root 实现）
+ *
+ * ## 解决的问题
+ * UniApp 不支持原生的根组件包裹机制，导致无法在全局统一注入
+ * snake-config-provider、toast、modal 等需要在每个页面根部存在的组件。
+ *
+ * ## 工作原理
+ * 1. 在 main.ts 中注入 App.root.vue 的导入，并注册为全局组件 global-root-view
+ * 2. 在每个页面的 <template> 中包裹 <global-root-view> 标签
+ * 3. App.root.vue 中的 <slot /> 渲染页面内容
+ *
+ * ## 支持 HMR
+ * pages.json 变更时自动重载页面列表，无需手动重启
+ *
+ * ## 跨端兼容
+ * 纯 Vite 构建时插件，在所有 UniApp 支持的平台（H5、微信小程序、支付宝小程序、
+ * 头条小程序、Android App、iOS App、鸿蒙 App）均可正常工作
+ */
+export function Root(options?: RootOptions): Plugin {
+    const resolvedOptions: Required<RootOptions> = {
+        rootFileName: 'App.root',
+        ...options
+    };
+
+    const rootPath = process.env.UNI_INPUT_DIR || join(process.cwd(), 'src');
+    const appRootPath = resolve(rootPath, `${resolvedOptions.rootFileName}.vue`);
+    const pagesPath = resolve(rootPath, 'pages.json');
+
+    let pagesJson = loadPagesJson(pagesPath, rootPath);
+    let watcher: ReturnType<typeof watch> | null = null;
+    let hasPlatformPlugin = false;
+
+    const normalizedAppRoot = normalizeId(appRootPath);
+
+    return {
+        name: 'vite-plugin-snake-root',
+        enforce: 'pre', // 在其他插件之前执行，确保页面模板先被包裹
+
+        configResolved({ plugins }) {
+            // 检测是否有 uni-platform 插件，用于处理平台特定页面路径（如 .mp-weixin.vue）
+            hasPlatformPlugin = plugins.some(v => v.name === 'vite-plugin-uni-platform');
+        },
+
+        configureServer(server) {
+            // 监听 pages.json 变更，HMR 热重载页面列表
+            const reload = debounce(() => {
+                try {
+                    pagesJson = loadPagesJson(pagesPath, rootPath);
+                    server.ws.send({ type: 'full-reload' });
+                } catch (e) {
+                    console.error('[vite-plugin-snake-root] pages.json reload failed:', e);
+                }
+            }, 100);
+
+            watcher = watch(pagesPath, eventType => {
+                if (eventType === 'change') reload();
+            });
+        },
+
+        load(id) {
+            const normalizedId = normalizeId(id);
+            // 只拦截根 SFC 请求，不拦截 Vue 子模块请求（如 ?vue&type=script）
+            if (normalizedId === normalizedAppRoot) {
+                const code = readFileSync(appRootPath, 'utf-8');
+                return rebuildRootApp(code).code;
+            }
+        },
+
+        async transform(code, id) {
+            const normalizedId = normalizeId(id);
+            const normalizedRootPath = normalizeId(rootPath);
+
+            // 注入 App.root.vue 的导入，并注册为全局组件 global-root-view
+            if (normalizedId === `${normalizedRootPath}/main.ts` || normalizedId === `${normalizedRootPath}/main.js`) {
+                return registerRootApp(code, resolvedOptions.rootFileName);
+            }
+
+            // App.root.vue 兜底处理（已在 load 中处理，此处只处理根 SFC）
+            if (normalizedId === normalizedAppRoot) {
+                return rebuildRootApp(code);
+            }
+
+            // 页面模板包裹 <global-root-view>
+            const pageId = hasPlatformPlugin ? normalizePlatformPath(normalizedId) : normalizedId;
+            const isPage = pagesJson.some(p => pageId === p || pageId.startsWith(`${p}?`));
+            if (isPage) {
+                return transformPage(code);
+            }
+        },
+
+        buildEnd() {
+            if (watcher) {
+                watcher.close();
+                watcher = null;
+            }
+        }
+    };
+}
+
+export default Root;
+export type { RootOptions };