@ecolovo/uniapp-components 2.0.0 → 2.0.2

package/README.md

@@ -12,12 +12,6 @@ UniApp **Vue3** 组件库。
 npm install @ecolovo/uniapp-components
 ```
 
-同时需要使用 `uni-pages-hot-modules` 用来动态配置
-
-```bash
-npm install uni-pages-hot-modules --save-dev
-```
-
 ## 组件库的配置
 
 使用前，请按照以下步骤进行一些必要的配置。
@@ -27,7 +21,7 @@ npm install uni-pages-hot-modules --save-dev
 ```javascript
 // src/main.js
 
-import init from '@ecolovo/uniapp-components/init';
+import { init } from '@ecolovo/uniapp-components';
 
 init({
 	// 配置组件前缀
@@ -36,32 +30,146 @@ init({
 });
 ```
 
-### 2. 配置 `src/pages.js` 文件，
+### 2. 配置 `src/pages.js` 文件
 
 ```javascript
 // src/pages.js
 
 const mergeWith = require('lodash/mergeWith');
-const { hot } = require('uni-pages-hot-modules');
-const componentEasyCom = require('@ecolovo/uniapp-components/easyCom');
-
-module.exports = hot((pagesJson) => {
-	const pagesConfig = require('./pagesDef');
-
-	return mergeWith(
-		// pages.json 中的配置
-		pagesJson,
-		pagesConfig,
-		componentEasyCom('ui'), // 填入和步骤 2 中同样的前缀
-		function (objValue, srcValue) {
-			if (Array.isArray(objValue)) {
-				return objValue.concat(srcValue);
-			}
+const componentEasyCom = require('@ecolovo/uniapp-components/easyCom').default;
+const pageJson = require('./pages-config/index');
+
+module.exports = mergeWith(
+	pageJson,
+	componentEasyCom('ui'), // 填入和步骤 2 中同样的前缀
+	function (objValue, srcValue) {
+		if (Array.isArray(objValue)) {
+			return objValue.concat(srcValue);
 		}
-	);
-});
+	}
+);
 ```
 
+> `uni-pages-hot-modules` 库在 Vue3.x 版本中无法正常使用，可使用以下脚本进行 `pages.js` 的动态配置
+>
+> ```javascript
+> // scripts/build.js
+>
+> /* eslint-disable no-console, @typescript-eslint/no-require-imports */
+>
+> const fs = require('fs');
+> const path = require('path');
+> const srcDir = path.resolve(__dirname, '../src');
+> const pagesJsPath = path.join(srcDir, 'pages.js');
+> const pagesConfigDir = path.join(srcDir, 'pages-config');
+> const mainTsPath = path.join(srcDir, 'main.ts');
+>
+> // 1. Inject environment variables before pages.js is evaluated
+> const platformArgIndex = process.argv.indexOf('-p');
+> const platform = platformArgIndex !== -1 ? process.argv[platformArgIndex + 1] : 'h5';
+> process.env.UNI_PLATFORM = platform;
+>
+> const envPath = path.resolve(__dirname, '../.env');
+> if (fs.existsSync(envPath)) {
+> 	const envContent = fs.readFileSync(envPath, 'utf-8');
+> 	for (const line of envContent.split(/\r?\n/)) {
+> 		const trimmed = line.trim();
+> 		if (!trimmed || trimmed.startsWith('#')) continue;
+> 		const eqIndex = trimmed.indexOf('=');
+> 		if (eqIndex !== -1) {
+> 			const key = trimmed.slice(0, eqIndex).trim();
+> 			let value = trimmed.slice(eqIndex + 1).trim();
+> 			if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+> 				value = value.slice(1, -1);
+> 			}
+> 			process.env[key] = value;
+> 		}
+> 	}
+> }
+>
+> // 2. Evaluate pages.js to generate config in memory
+> Object.keys(require.cache).forEach((key) => {
+> 	if (key.includes('pages-config') || key.endsWith(path.join('src', 'pages.js'))) {
+> 		delete require.cache[key];
+> 	}
+> });
+> const pagesConfig = require(pagesJsPath);
+> let pagesJsonStr = JSON.stringify(pagesConfig);
+>
+> // 3. Patch fs.readFileSync to intercept pages.json reads
+> const originalReadFileSync = fs.readFileSync;
+> fs.readFileSync = function (...args) {
+> 	const filePath = typeof args[0] === 'string' ? path.resolve(args[0]) : '';
+> 	if (filePath.endsWith('pages.json')) {
+> 		const options = args[1];
+> 		const encoding = typeof options === 'string' ? options : options && options.encoding;
+> 		if (encoding === 'utf8' || encoding === 'utf-8') {
+> 			return pagesJsonStr;
+> 		}
+> 		return Buffer.from(pagesJsonStr, 'utf8');
+> 	}
+> 	return originalReadFileSync.apply(this, args);
+> };
+>
+> // 4. Replace parsePagesJsonOnce with non-cached version, so rebuilds pick up new config
+> const pagesModulePath = require.resolve('@dcloudio/uni-cli-shared/dist/json/pages');
+> delete require.cache[pagesModulePath];
+> const pagesModule = require(pagesModulePath);
+> const originalParsePagesJson = pagesModule.parsePagesJson;
+> pagesModule.parsePagesJsonOnce = function (inputDir, platform) {
+> 	return originalParsePagesJson(inputDir, platform);
+> };
+>
+> // 5. Set up file watcher for HMR (watch mode only)
+> const hasBuildCommand = process.argv.includes('build');
+> const hasWatch = process.argv.includes('-w') || process.argv.includes('--watch');
+> const isDevMode = !hasBuildCommand || hasWatch;
+>
+> if (isDevMode && fs.existsSync(pagesConfigDir)) {
+> 	try {
+> 		const chokidar = require('chokidar');
+> 		const watcher = chokidar.watch(pagesConfigDir, {
+> 			ignoreInitial: true,
+> 			awaitWriteFinish: { stabilityThreshold: 300 },
+> 		});
+> 		watcher.on('change', (file) => {
+> 			console.log(`[HMR] Pages config changed: ${path.relative(srcDir, file)}`);
+>
+> 			// Clear require cache for config modules
+> 			Object.keys(require.cache).forEach((key) => {
+> 				if (key.includes('pages-config') || key.endsWith(path.join('src', 'pages.js'))) {
+> 					delete require.cache[key];
+> 				}
+> 			});
+>
+> 			// Re-evaluate pages.js and update in-memory config
+> 			const newConfig = require(pagesJsPath);
+> 			pagesJsonStr = JSON.stringify(newConfig);
+>
+> 			// Touch main.ts to trigger Rollup rebuild
+> 			try {
+> 				const now = new Date();
+> 				fs.utimesSync(mainTsPath, now, now);
+> 			} catch (_) {
+> 				// Fallback: touch any .vue file
+> 				const fallback = path.join(srcDir, 'App.vue');
+> 				if (fs.existsSync(fallback)) {
+> 					const now = new Date();
+> 					fs.utimesSync(fallback, now, now);
+> 				}
+> 			}
+> 		});
+> 	} catch {
+> 		console.warn('[HMR] chokidar not available, pages hot reload disabled');
+> 	}
+> }
+>
+> // 6. Run the uni CLI
+> require('@dcloudio/vite-plugin-uni/bin/uni');
+> ```
+>
+> package.json 中的脚本需要替换，如 `dev:mp-weixin` 由原来的 `uni -p mp-weixin` 替换为 `node scripts/build.js -p mp-weixin` 。
+
 ### 3. 配置样式
 
 #### 全局样式
@@ -101,20 +209,16 @@ module.exports = hot((pagesJson) => {
 ```
 
 ```javascript
-// vue.config.js
-
-const sass = require('sass');
-
+// vite.config.ts
 module.exports = {
-	// configs...
+	// other configs...
 	css: {
-		loaderOptions: {
+		preprocessorOptions: {
 			scss: {
-				prependData: '@use "@/styles/prepend" as *;',
+				additionalData: '@use "@/styles/prepend.scss" as *;',
 			},
 		},
 	},
-	// other configs...
 };
 ```
 

package/components/button/button.vue

@@ -20,9 +20,18 @@
 			},
 			buttonSize,
 		]"
+		:disabled="isNotClickable"
 		:hover-class="disabled ? 'none' : $style['Button--active']"
 		:style="inlineCssVar"
 		@click="onClick"
+		@getphonenumber="$emit('getphonenumber', $event)"
+		@getuserinfo="$emit('getuserinfo', $event)"
+		@error="$emit('error', $event)"
+		@opensetting="$emit('opensetting', $event)"
+		@launchapp="$emit('launchapp', $event)"
+		@contact="$emit('contact', $event)"
+		@chooseavatar="$emit('chooseavatar', $event)"
+		@agreeprivacyauthorization="$emit('agreeprivacyauthorization', $event)"
 	>
 		<!-- 线性按钮边框：仅在线性按钮且不是禁用态时显示 -->
 		<view v-if="!disabled && !text && plain" :class="$style['Button--plain-border']"></view>
@@ -116,6 +125,14 @@ const props = withDefaults(defineProps<_Props>(), {
 
 const emit = defineEmits<{
 	(event: 'click', payload?: Omit<PromiseWithResolvers<unknown>, 'promise'>): void;
+	(event: 'getphonenumber', payload?: unknown): void;
+	(event: 'getuserinfo', payload?: unknown): void;
+	(event: 'error', payload?: unknown): void;
+	(event: 'opensetting', payload?: unknown): void;
+	(event: 'launchapp', payload?: unknown): void;
+	(event: 'contact', payload?: unknown): void;
+	(event: 'chooseavatar', payload?: unknown): void;
+	(event: 'agreeprivacyauthorization', payload?: unknown): void;
 }>();
 
 /** 按钮是否冷却中 */
@@ -228,6 +245,22 @@ $button-sizes: (
 .Button {
 	@extend %external-vars;
 	@extend %button-themes;
+	--button-color: #{UTILS__LOCAL_VAR(text-color)};
+	--button-background: #{UTILS__LOCAL_VAR(theme)};
+	color: var(--button-color);
+	background: var(--button-background);
+}
+
+.Button[disabled]:not([type]),
+.Button[disabled][type='default'] {
+	color: var(--button-color);
+	background: var(--button-background);
+}
+
+.Button--plain,
+.Button-text {
+	--button-color: var(var(#{__DO_NOT_USE__local-var-name(text-color)}), #{UTILS__LOCAL_VAR(theme)});
+	--button-background: transparent;
 }
 
 .Button--block {
@@ -241,8 +274,6 @@ $button-sizes: (
 	text-decoration: none;
 	text-align: center;
 	overflow: hidden;
-	color: UTILS__LOCAL_VAR(text-color);
-	background: UTILS__LOCAL_VAR(theme);
 	border: none;
 
 	@include button-size('block', 'normal');
@@ -309,9 +340,6 @@ $button-sizes: (
 }
 
 .Button--plain {
-	color: UTILS__LOCAL_VAR(theme);
-	background: transparent;
-
 	.Button--plain-border {
 		position: absolute;
 		top: 0;
@@ -329,9 +357,7 @@ $button-sizes: (
 	@extend %button-reset;
 	display: inline-block;
 	padding: 0;
-	color: UTILS__LOCAL_VAR(theme);
 	line-height: inherit;
-	background: transparent;
 	font-weight: inherit;
 	will-change: color;
 

package/composable/component-name.d.ts

@@ -0,0 +1,2 @@
+declare const useClassNames: (componentName: string) => [string, string];
+export default useClassNames;

package/composable/component-name.js

@@ -0,0 +1,8 @@
+import { kebabCase, pascalCase } from 'case-anything';
+import { componentPrefix } from '../configs';
+const useClassNames = (componentName) => {
+	const pascalCaseClass = pascalCase(componentPrefix) + pascalCase(componentName);
+	const kebabCaseClass = kebabCase(pascalCaseClass);
+	return [pascalCaseClass, kebabCaseClass];
+};
+export default useClassNames;

package/composable/component-name.ts

@@ -1,7 +1,7 @@
 import { kebabCase, pascalCase } from 'case-anything';
 import { componentPrefix } from '../configs';
 
-const useClassNames = (componentName: string) => {
+const useClassNames = (componentName: string): [string, string] => {
 	const pascalCaseClass = pascalCase(componentPrefix) + pascalCase(componentName);
 	const kebabCaseClass = kebabCase(pascalCaseClass);
 	return [pascalCaseClass, kebabCaseClass];

package/configs/index.d.ts

@@ -0,0 +1,37 @@
+/** 组件前缀 */
+declare let componentPrefix: string;
+/** 首页路径 */
+declare let homePath: string;
+/**
+ * 设置组件前缀
+ * @param prefix 组件前缀
+ */
+declare function setComponentPrefix(prefix?: string): void;
+/**
+ * 设置首页路径
+ * @param path 首页路径
+ */
+declare function setHomePath(path?: string): void;
+interface IconInfo {
+	/** 字体文件名 */
+	fontFamily: string;
+	/** 图标前缀 */
+	prefix: string;
+	/** 图标名称 */
+	name: string;
+}
+/** iconfont 图标 map */
+declare const iconMap: Map<string, IconInfo>;
+export interface IconFontJson {
+	font_family: string;
+	css_prefix_text: string;
+	glyphs: {
+		font_class: string;
+	}[];
+}
+/**
+ * 添加一组图标，传入 iconfont.json 文件内容
+ * @param iconJson iconfont.json 文件内容
+ */
+declare function addIcons(iconJson: IconFontJson): void;
+export { componentPrefix, homePath, setComponentPrefix, setHomePath, iconMap, addIcons };

package/configs/index.js

@@ -0,0 +1,59 @@
+import defaultIconfonts from '../resources/iconfont/uniapp_ui_icon/iconfont.json';
+/** 组件前缀 */
+let componentPrefix = 'app';
+/** 首页路径 */
+let homePath = '/pages/index/index';
+/**
+ * 设置组件前缀
+ * @param prefix 组件前缀
+ */
+function setComponentPrefix(prefix = 'app') {
+	if (!prefix) throw new Error('组件前缀不能为空');
+	componentPrefix = prefix;
+}
+/**
+ * 设置首页路径
+ * @param path 首页路径
+ */
+function setHomePath(path = '/pages/index/index') {
+	if (!path) throw new Error('app 首页不能为空');
+	homePath = path;
+}
+/** iconfont 图标 map */
+const iconMap = new Map();
+/**
+ * 添加单个图标
+ * @param fontFamily 字体文件名
+ * @param prefix 图标前缀
+ * @param name 图标名称
+ */
+function addIconToMap(fontFamily, prefix, name) {
+	if (iconMap.has(name)) {
+		// eslint-disable-next-line no-console
+		console.warn(
+			`图标库 "${fontFamily}" 中的图标 "${name}" 在图标库 "${
+				iconMap.get(name).fontFamily
+			}" 中已存在，新的图标将会覆盖已存在的同名图标`
+		);
+	}
+	iconMap.set(name, {
+		fontFamily,
+		prefix,
+		name,
+	});
+}
+/**
+ * 添加一组图标，传入 iconfont.json 文件内容
+ * @param iconJson iconfont.json 文件内容
+ */
+function addIcons(iconJson) {
+	const fontFamily = iconJson.font_family;
+	const prefix = iconJson.css_prefix_text;
+	const glyphs = iconJson.glyphs;
+	glyphs.forEach((glyph) => {
+		addIconToMap(fontFamily, prefix, glyph.font_class);
+	});
+}
+// 添加内部图标库
+addIcons(defaultIconfonts);
+export { componentPrefix, homePath, setComponentPrefix, setHomePath, iconMap, addIcons };

package/easyCom.d.ts

@@ -0,0 +1,9 @@
+declare function componentEasyCom(componentPrefix?: string): {
+	easycom: {
+		autoscan: boolean;
+		custom: {
+			[x: string]: string;
+		};
+	};
+};
+export default componentEasyCom;

package/easyCom.js

@@ -0,0 +1,30 @@
+function componentEasyCom(componentPrefix = 'app') {
+	return {
+		easycom: {
+			autoscan: true,
+			custom: {
+				[`^${componentPrefix}-date-picker-view`]:
+					'@ecolovo/uniapp-components/components/date-picker/date-picker-view.vue',
+				[`^${componentPrefix}-dialog-content`]:
+					'@ecolovo/uniapp-components/components/dialog/dialog-content.vue',
+				[`^${componentPrefix}-loading-animation(.*)`]:
+					'@ecolovo/uniapp-components/components/loading/animations/loading-animation$1.vue',
+				[`^${componentPrefix}-page-(.*)`]: '@ecolovo/uniapp-components/components/page/page-$1.vue',
+				[`^${componentPrefix}-password-input`]:
+					'@ecolovo/uniapp-components/components/input/password-input.vue',
+				[`^${componentPrefix}-picker-popup`]: '@ecolovo/uniapp-components/components/picker/picker-popup.vue',
+				[`^${componentPrefix}-popover-content`]:
+					'@ecolovo/uniapp-components/components/popover/popover-content.vue',
+				[`^${componentPrefix}-popover-mask`]: '@ecolovo/uniapp-components/components/popover/popover-mask.vue',
+				[`^${componentPrefix}-popup-content`]: '@ecolovo/uniapp-components/components/popup/popup-content.vue',
+				[`^${componentPrefix}-media-uploader`]:
+					'@ecolovo/uniapp-components/components/uploader/media-uploader.vue',
+				[`^${componentPrefix}-file-uploader`]:
+					'@ecolovo/uniapp-components/components/uploader/file-uploader.vue',
+				[`^${componentPrefix}-(.*)`]: '@ecolovo/uniapp-components/components/$1/$1.vue',
+			},
+		},
+	};
+}
+// 导出 easycom 配置
+export default componentEasyCom;

package/index.d.ts

@@ -0,0 +1 @@
+export { default as init } from './init';

package/index.js

@@ -0,0 +1 @@
+export { default as init } from './init';

package/init.d.ts

@@ -0,0 +1,16 @@
+import type { IconFontJson } from './configs';
+/** 组件库初始化配置 */
+interface InitOptions {
+	/** 组件前缀 */
+	componentPrefix?: string;
+	/** 首页路径 */
+	homePath?: string;
+	/** iconfont 图标 json 文件 */
+	iconfont?: IconFontJson | IconFontJson[];
+}
+/**
+ * 组件库初始化方法，在使用组件库前调用
+ * @param options 组件库初始化配置
+ */
+declare function init(options?: InitOptions): void;
+export default init;

package/init.js

@@ -0,0 +1,21 @@
+import { setComponentPrefix, setHomePath, addIcons } from './configs';
+/**
+ * 组件库初始化方法，在使用组件库前调用
+ * @param options 组件库初始化配置
+ */
+function init(options = {}) {
+	if (options.componentPrefix) {
+		setComponentPrefix(options.componentPrefix);
+	}
+	if (options.homePath) {
+		setHomePath(options.homePath);
+	}
+	if (options.iconfont) {
+		if (Array.isArray(options.iconfont)) {
+			options.iconfont.forEach(addIcons);
+		} else {
+			addIcons(options.iconfont);
+		}
+	}
+}
+export default init;

package/package.json

@@ -1,9 +1,11 @@
 {
 	"name": "@ecolovo/uniapp-components",
-	"version": "2.0.0",
+	"version": "2.0.2",
 	"description": "Ecolovo UniApp Vue3 组件库",
 	"scripts": {
-		"lint": "eslint --fix"
+		"lint": "eslint",
+		"lint:fix": "eslint --fix",
+		"build": "tsc"
 	},
 	"keywords": [
 		"uniapp",

package/utils/date.d.ts

@@ -0,0 +1,47 @@
+type ValidDateValue = Date | number | string;
+/**
+ * 将Date 对象、时间戳或时间格式字符串转为 Date 对象
+ * @param   dateValue Date 对象、时间戳或时间格式字符串
+ * @returns Date 对象
+ */
+export declare function toDate(dateValue: ValidDateValue | null | undefined): Date | null;
+type FormatFn = {
+	(date: Date | null | undefined, format?: string): string;
+	DATE: string;
+	DATE_WITH_YEAR: string;
+	TIME: string;
+	TIME_MS: string;
+	TIME_MINUTE: string;
+	DATE_TIME: string;
+	DATE_TIME_MS: string;
+	DATE_TIME_WITH_YEAR: string;
+	DATE_TIME_MS_WITH_YEAR: string;
+	DATE_MINUTE: string;
+	DATE_MINUTE_WITH_YEAR: string;
+};
+/**
+ * 格式化日期
+ *
+ * format 参数说明：
+ * - Y: 年
+ * - M: 月
+ * - D: 日
+ * - H: 时
+ * - m: 分
+ * - s: 秒
+ * - S: 毫秒
+ * - w: 星期
+ * - W: 星期（中文）
+ * @param   date 要格式化的日期对象
+ * @param   format 格式化参数 默认值 YYYY-MM-DD
+ * @returns 格式化后的日期
+ */
+export declare const formatDate: FormatFn;
+/**
+ * 获取两个时间的天数差
+ * @param   day1 时间1
+ * @param   day2 时间2
+ * @returns 天数差，负数: day1 < day2
+ */
+export declare function daysDiff(day1: ValidDateValue, day2: ValidDateValue): number;
+export {};

package/utils/date.js

@@ -0,0 +1,131 @@
+/**
+ * 将Date 对象、时间戳或时间格式字符串转为 Date 对象
+ * @param   dateValue Date 对象、时间戳或时间格式字符串
+ * @returns Date 对象
+ */
+export function toDate(dateValue) {
+	if (dateValue instanceof Date) return new Date(dateValue);
+	if (typeof dateValue === 'number') return new Date(dateValue);
+	if (!dateValue) return null;
+	if (typeof dateValue !== 'string') throw new Error("dateValue's type is invalid");
+	// 兼容 iOS 日期格式
+	const result = new Date(dateValue.replace(/-/g, '/'));
+	if (isNaN(result.getTime())) throw new Error('dateValue cannot be parsed to Date object');
+	return result;
+}
+/**
+ * 格式化日期
+ *
+ * format 参数说明：
+ * - Y: 年
+ * - M: 月
+ * - D: 日
+ * - H: 时
+ * - m: 分
+ * - s: 秒
+ * - S: 毫秒
+ * - w: 星期
+ * - W: 星期（中文）
+ * @param   date 要格式化的日期对象
+ * @param   format 格式化参数 默认值 YYYY-MM-DD
+ * @returns 格式化后的日期
+ */
+export const formatDate = (date, format = formatDate.DATE_WITH_YEAR) => {
+	if (!date) return '';
+	const fullYear = date.getFullYear().toString();
+	const year = fullYear.substring(fullYear.length - 2);
+	const month = (date.getMonth() + 1).toString();
+	const day = date.getDate().toString();
+	const hour = date.getHours().toString();
+	const min = date.getMinutes().toString();
+	const sec = date.getSeconds().toString();
+	const ms = date.getMilliseconds().toString();
+	const week = date.getDay().toString();
+	let weekCN = '';
+	switch (week) {
+		case '0':
+			weekCN = '日';
+			break;
+		case '1':
+			weekCN = '一';
+			break;
+		case '2':
+			weekCN = '二';
+			break;
+		case '3':
+			weekCN = '三';
+			break;
+		case '4':
+			weekCN = '四';
+			break;
+		case '5':
+			weekCN = '五';
+			break;
+		case '6':
+			weekCN = '六';
+			break;
+	}
+	const replacement = [
+		{ reg: 'Y{3,4}', val: fullYear, pad: 0 },
+		{ reg: 'Y{1,2}', val: year, pad: 0 },
+		{ reg: 'M{1,2}', val: month, pad: 2 },
+		{ reg: 'D{1,2}', val: day, pad: 2 },
+		{ reg: 'H{1,2}', val: hour, pad: 2 },
+		{ reg: 'm{1,2}', val: min, pad: 2 },
+		{ reg: 's{1,2}', val: sec, pad: 2 },
+		{ reg: 'S{1,3}', val: ms, pad: 3 },
+		{ reg: 'w', val: week, pad: 0 },
+		{ reg: 'W', val: weekCN, pad: 0 },
+	];
+	for (let i = 0; i < replacement.length; i++) {
+		const r = replacement[i];
+		format = format.replace(new RegExp(r.reg, 'g'), (m) =>
+			r.pad > 0 ? r.val.padStart(Math.min(r.pad, m.length), '0') : r.val
+		);
+	}
+	return format;
+};
+/** 月日 */
+formatDate.DATE = 'MM-DD';
+/** 年月日 */
+formatDate.DATE_WITH_YEAR = 'YYYY-MM-DD';
+/** 时分秒 */
+formatDate.TIME = 'HH:mm:ss';
+/** 时分秒.毫秒 */
+formatDate.TIME_MS = 'HH:mm:ss.SSS';
+/** 时分 */
+formatDate.TIME_MINUTE = 'HH:mm';
+/** 月日 时分秒 */
+formatDate.DATE_TIME = 'MM-DD HH:mm:ss';
+/** 月日 时分秒.毫秒 */
+formatDate.DATE_TIME_MS = 'MM-DD HH:mm:ss.SSS';
+/** 年月日 时分秒 */
+formatDate.DATE_TIME_WITH_YEAR = 'YYYY-MM-DD HH:mm:ss';
+/** 年月日 时分秒.毫秒 */
+formatDate.DATE_TIME_MS_WITH_YEAR = 'YYYY-MM-DD HH:mm:ss.SSS';
+/** 月日 时分 */
+formatDate.DATE_MINUTE = 'MM-DD HH:mm';
+/** 年月日 时分 */
+formatDate.DATE_MINUTE_WITH_YEAR = 'YYYY-MM-DD HH:mm';
+/** 时区差 */
+const TIMEZONE_OFFSET = new Date().getTimezoneOffset() * 60 * 1000;
+/**
+ * 获取时间的UTC相对时间戳
+ * @param   date 时间
+ * @returns 毫秒数
+ */
+function toDayTimestamp(date) {
+	if (typeof date === 'number') return date - TIMEZONE_OFFSET;
+	if (typeof date === 'string') return toDate(date).getTime() - TIMEZONE_OFFSET;
+	if (date instanceof Date) return date.getTime() - TIMEZONE_OFFSET;
+	return Date.now() - TIMEZONE_OFFSET;
+}
+/**
+ * 获取两个时间的天数差
+ * @param   day1 时间1
+ * @param   day2 时间2
+ * @returns 天数差，负数: day1 < day2
+ */
+export function daysDiff(day1, day2) {
+	return Math.floor(toDayTimestamp(day1) / 8.64e7) - Math.floor(toDayTimestamp(day2) / 8.64e7);
+}

package/utils/freezeDeep.d.ts

@@ -0,0 +1 @@
+export declare function freezeDeep<T>(obj: T): Readonly<T>;

package/utils/freezeDeep.js

@@ -0,0 +1,9 @@
+export function freezeDeep(obj) {
+	if (!(typeof obj === 'object' && obj)) {
+		return obj;
+	}
+	for (const key in obj) {
+		freezeDeep(obj[key]);
+	}
+	return Object.freeze(obj);
+}

package/utils/price.d.ts

@@ -0,0 +1,24 @@
+interface FormatPriceOption {
+	/** 精度，默认为 2 */
+	precision: number;
+	/** 是否补齐小数部分 0 */
+	padDecimal: boolean;
+}
+interface FormatPriceResult {
+	/** 格式化的价格字符串 */
+	price: string;
+	/** 是否负值 */
+	negative: boolean;
+	/** 整数部分价格 */
+	integer: string;
+	/** 小数部分价格 */
+	decimal: string;
+	/** 价格对应数值 */
+	number: number;
+}
+/**
+ * 格式化价格
+ * @param price 价格
+ */
+export declare function formatPrice(price: number | string, option?: FormatPriceOption): FormatPriceResult;
+export {};

package/utils/price.js

@@ -0,0 +1,38 @@
+/**
+ * 格式化价格
+ * @param price 价格
+ */
+export function formatPrice(price, option) {
+	if (isNaN(Number(price))) {
+		return {
+			price: '',
+			negative: false,
+			integer: '',
+			decimal: '',
+			number: NaN,
+		};
+	}
+	price = Number(price);
+	let negative = false;
+	if (price < 0) {
+		negative = true;
+		price = -price;
+	}
+	const integer = Math.floor(price).toString();
+	const decimalNum = Math.round(Number(price + 'e' + (option?.precision ?? 2))) % 100;
+	let decimal;
+	if (option?.padDecimal ?? true) {
+		decimal = '.' + decimalNum.toString().padStart(option?.precision ?? 2, '0');
+	} else {
+		if (decimalNum === 0) decimal = '';
+		else decimal = decimalNum.toString().slice(1);
+	}
+	const formattedPrice = `${negative ? '-' : ''}${integer}.${decimal}`;
+	return {
+		price: formattedPrice,
+		negative,
+		integer,
+		decimal,
+		number: Number(formattedPrice),
+	};
+}

package/utils/round.d.ts

@@ -0,0 +1,2 @@
+export declare function round(val: number, precision?: number): number;
+export declare function round2(val: number): number;

package/utils/round.js

@@ -0,0 +1,10 @@
+export function round(val, precision = 0) {
+	if (val.toString().indexOf('e') >= 0) {
+		const exponential = val.toString().split('e');
+		return Math.round(+`${exponential[0]}e${+exponential[1] + precision}`) / 10 ** precision;
+	}
+	return Math.round(+`${val}e${precision}`) / 10 ** precision;
+}
+export function round2(val) {
+	return round(val, 2);
+}

package/utils/windowInfo.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="@dcloudio/types" />
+/** 胶囊按钮位置信息 */
+declare let menuButton: UniApp.GetMenuButtonBoundingClientRectRes | null;
+/** 胶囊按钮宽度，仅在 css 中使用，当有胶囊按钮时，表示胶囊按钮左边缘到屏幕右侧的宽度，否则为 `0px` */
+declare let menuButtonWidthInCss: string;
+/** 系统信息 */
+declare let windowInfo: UniApp.GetWindowInfoResult | null;
+/** 导航栏高度 */
+declare let navBarHeight: number;
+/** 导航栏顶部距离 */
+declare let navBarTopOffset: number;
+/** 导航栏底部距离 */
+declare let navBarBottomOffset: number;
+/** 底部安全区域高度 */
+declare let safeAreaInsetBottom: number;
+export {
+	menuButton,
+	menuButtonWidthInCss,
+	windowInfo,
+	navBarHeight,
+	navBarTopOffset,
+	navBarBottomOffset,
+	safeAreaInsetBottom,
+};

package/utils/windowInfo.js

@@ -0,0 +1,45 @@
+/** 默认导航栏高度 */
+const NAV_TITLE_HEIGHT = 44;
+/** 胶囊按钮位置信息 */
+let menuButton = null;
+/** 胶囊按钮宽度，仅在 css 中使用，当有胶囊按钮时，表示胶囊按钮左边缘到屏幕右侧的宽度，否则为 `0px` */
+let menuButtonWidthInCss = '0px';
+/** 系统信息 */
+let windowInfo = null;
+/** 导航栏高度 */
+let navBarHeight = NAV_TITLE_HEIGHT;
+/** 导航栏顶部距离 */
+let navBarTopOffset = 0;
+/** 导航栏底部距离 */
+let navBarBottomOffset = NAV_TITLE_HEIGHT;
+/** 底部安全区域高度 */
+let safeAreaInsetBottom = uni.upx2px(50);
+/* #ifdef MP-WEIXIN || MP-ALIPAY */
+menuButton = uni.getMenuButtonBoundingClientRect();
+/* #endif */
+windowInfo = uni.getWindowInfo();
+// eslint-disable-next-line no-console
+console.log('windowInfo:', windowInfo);
+if (menuButton) {
+	if (navBarHeight < menuButton.height) {
+		navBarHeight = menuButton.height + 12;
+	}
+	navBarTopOffset = menuButton.top - (navBarHeight - menuButton.height) / 2;
+	menuButtonWidthInCss = 'calc(100vw - ' + menuButton.left + 'px)';
+} else {
+	navBarTopOffset = windowInfo.safeArea.top || windowInfo.statusBarHeight;
+}
+navBarBottomOffset = navBarTopOffset + navBarHeight;
+const _safeAreaBottom = windowInfo.screenHeight - windowInfo.safeArea.bottom;
+if (_safeAreaBottom) {
+	safeAreaInsetBottom = _safeAreaBottom;
+}
+export {
+	menuButton,
+	menuButtonWidthInCss,
+	windowInfo,
+	navBarHeight,
+	navBarTopOffset,
+	navBarBottomOffset,
+	safeAreaInsetBottom,
+};