@pisell/utils 1.0.57 → 1.0.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/README.md +2 -2
  2. package/es/arrayUtils.d.ts +1 -1
  3. package/es/common/index.d.ts +5 -5
  4. package/es/common/index.js +2 -2
  5. package/es/common/stateHelper.d.ts +18 -18
  6. package/es/common/stateHelper.js +15 -15
  7. package/es/common/types.d.ts +28 -28
  8. package/es/constants/index.d.ts +7 -0
  9. package/es/date.d.ts +28 -28
  10. package/es/date.js +22 -22
  11. package/es/document.d.ts +13 -13
  12. package/es/document.js +7 -7
  13. package/es/escPosPrinter/index.d.ts +9 -9
  14. package/es/firebase/config/index.d.ts +13 -13
  15. package/es/firebase/index.d.ts +28 -28
  16. package/es/format.d.ts +28 -0
  17. package/es/format.js +14 -14
  18. package/es/image.d.ts +11 -11
  19. package/es/image.js +5 -5
  20. package/es/index.d.ts +24 -24
  21. package/es/jsBridge/index.d.ts +22 -0
  22. package/es/jsBridge/index.js +15 -15
  23. package/es/jsBridge/regDeviceApi.d.ts +15 -15
  24. package/es/jsBridge/regDeviceApi.js +3 -3
  25. package/es/jsBridge/types.d.ts +149 -0
  26. package/es/locales.d.ts +12 -0
  27. package/es/locales.js +15 -15
  28. package/es/log.d.ts +10 -10
  29. package/es/miniRedux.d.ts +16 -0
  30. package/es/number-input/hooks/index.d.ts +4 -4
  31. package/es/number-input/hooks/index.js +2 -2
  32. package/es/number-input/hooks/useNumberInputState.d.ts +25 -25
  33. package/es/number-input/hooks/useNumberInputState.js +39 -39
  34. package/es/number-input/index.d.ts +14 -14
  35. package/es/number-input/index.js +8 -8
  36. package/es/number-input/types.d.ts +96 -96
  37. package/es/number-input/utils/formatter.d.ts +53 -53
  38. package/es/number-input/utils/formatter.js +37 -37
  39. package/es/number-input/utils/index.d.ts +7 -7
  40. package/es/number-input/utils/index.js +2 -2
  41. package/es/number-input/utils/validation.d.ts +27 -27
  42. package/es/number-input/utils/validation.js +24 -24
  43. package/es/otherUtils.d.ts +48 -0
  44. package/es/otherUtils.js +32 -32
  45. package/es/platform.d.ts +9 -9
  46. package/es/select/hooks/index.d.ts +5 -5
  47. package/es/select/hooks/index.js +2 -2
  48. package/es/select/hooks/useDebouncedSearch.d.ts +20 -20
  49. package/es/select/hooks/useDebouncedSearch.js +17 -17
  50. package/es/select/hooks/useSelectState.d.ts +19 -19
  51. package/es/select/hooks/useSelectState.js +13 -13
  52. package/es/select/index.d.ts +8 -8
  53. package/es/select/index.js +3 -3
  54. package/es/select/types.d.ts +256 -256
  55. package/es/select/utils/filterOptions.d.ts +22 -22
  56. package/es/select/utils/filterOptions.js +16 -16
  57. package/es/select/utils/helpers.d.ts +42 -42
  58. package/es/select/utils/helpers.js +30 -30
  59. package/es/select/utils/index.d.ts +7 -7
  60. package/es/select/utils/index.js +2 -2
  61. package/es/select/utils/sortOptions.d.ts +12 -12
  62. package/es/select/utils/sortOptions.js +8 -8
  63. package/es/select/utils/tagAggregation.d.ts +25 -25
  64. package/es/select/utils/tagAggregation.js +21 -21
  65. package/es/text-input/hooks/index.d.ts +4 -4
  66. package/es/text-input/hooks/index.js +2 -2
  67. package/es/text-input/hooks/useTextInputState.d.ts +24 -24
  68. package/es/text-input/hooks/useTextInputState.js +38 -38
  69. package/es/text-input/index.d.ts +14 -14
  70. package/es/text-input/index.js +9 -9
  71. package/es/text-input/types.d.ts +56 -56
  72. package/es/text-input/utils/index.d.ts +5 -5
  73. package/es/text-input/utils/index.js +2 -2
  74. package/es/text-input/utils/validation.d.ts +23 -23
  75. package/es/text-input/utils/validation.js +20 -20
  76. package/es/typeUtils.d.ts +42 -42
  77. package/es/typeUtils.js +26 -26
  78. package/es/walletValidity.d.ts +44 -0
  79. package/es/walletValidity.js +85 -85
  80. package/lib/arrayUtils.d.ts +1 -1
  81. package/lib/common/index.d.ts +5 -5
  82. package/lib/common/stateHelper.d.ts +18 -18
  83. package/lib/common/types.d.ts +28 -28
  84. package/lib/constants/index.d.ts +7 -0
  85. package/lib/date.d.ts +28 -28
  86. package/lib/document.d.ts +13 -13
  87. package/lib/escPosPrinter/index.d.ts +9 -9
  88. package/lib/firebase/config/index.d.ts +13 -13
  89. package/lib/firebase/index.d.ts +28 -28
  90. package/lib/format.d.ts +28 -0
  91. package/lib/image.d.ts +11 -11
  92. package/lib/index.d.ts +24 -24
  93. package/lib/jsBridge/index.d.ts +22 -0
  94. package/lib/jsBridge/regDeviceApi.d.ts +15 -15
  95. package/lib/jsBridge/types.d.ts +149 -0
  96. package/lib/locales.d.ts +12 -0
  97. package/lib/log.d.ts +10 -10
  98. package/lib/miniRedux.d.ts +16 -0
  99. package/lib/number-input/hooks/index.d.ts +4 -4
  100. package/lib/number-input/hooks/useNumberInputState.d.ts +25 -25
  101. package/lib/number-input/index.d.ts +14 -14
  102. package/lib/number-input/types.d.ts +96 -96
  103. package/lib/number-input/utils/formatter.d.ts +53 -53
  104. package/lib/number-input/utils/index.d.ts +7 -7
  105. package/lib/number-input/utils/validation.d.ts +27 -27
  106. package/lib/otherUtils.d.ts +48 -0
  107. package/lib/platform.d.ts +9 -9
  108. package/lib/select/hooks/index.d.ts +5 -5
  109. package/lib/select/hooks/useDebouncedSearch.d.ts +20 -20
  110. package/lib/select/hooks/useSelectState.d.ts +19 -19
  111. package/lib/select/index.d.ts +8 -8
  112. package/lib/select/types.d.ts +256 -256
  113. package/lib/select/utils/filterOptions.d.ts +22 -22
  114. package/lib/select/utils/helpers.d.ts +42 -42
  115. package/lib/select/utils/index.d.ts +7 -7
  116. package/lib/select/utils/sortOptions.d.ts +12 -12
  117. package/lib/select/utils/tagAggregation.d.ts +25 -25
  118. package/lib/text-input/hooks/index.d.ts +4 -4
  119. package/lib/text-input/hooks/useTextInputState.d.ts +24 -24
  120. package/lib/text-input/index.d.ts +14 -14
  121. package/lib/text-input/types.d.ts +56 -56
  122. package/lib/text-input/utils/index.d.ts +5 -5
  123. package/lib/text-input/utils/validation.d.ts +23 -23
  124. package/lib/typeUtils.d.ts +42 -42
  125. package/lib/walletValidity.d.ts +44 -0
  126. package/package.json +1 -1
@@ -1,25 +1,25 @@
1
- /**
2
- * 标签聚合工具函数
3
- * 用于多选下拉组件的标签显示逻辑
4
- */
5
- import type { SelectOption, TagDisplayInfo } from '../types';
6
- /**
7
- * 计算需要显示的标签和聚合信息
8
- * @template T 选项值的类型
9
- * @param selectedValues 当前选中的值数组
10
- * @param options 所有选项列表
11
- * @param maxTagCount 最多显示的标签数量
12
- * @returns 标签显示信息
13
- *
14
- * @example
15
- * ```tsx
16
- * const tagInfo = calculateTagDisplay(['a', 'b', 'c', 'd'], options, 2);
17
- * // 返回:
18
- * // {
19
- * // visibleTags: [option_a, option_b],
20
- * // hiddenTags: [option_c, option_d],
21
- * // hiddenCount: 2
22
- * // }
23
- * ```
24
- */
25
- export declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
1
+ /**
2
+ * 标签聚合工具函数
3
+ * 用于多选下拉组件的标签显示逻辑
4
+ */
5
+ import type { SelectOption, TagDisplayInfo } from '../types';
6
+ /**
7
+ * 计算需要显示的标签和聚合信息
8
+ * @template T 选项值的类型
9
+ * @param selectedValues 当前选中的值数组
10
+ * @param options 所有选项列表
11
+ * @param maxTagCount 最多显示的标签数量
12
+ * @returns 标签显示信息
13
+ *
14
+ * @example
15
+ * ```tsx
16
+ * const tagInfo = calculateTagDisplay(['a', 'b', 'c', 'd'], options, 2);
17
+ * // 返回:
18
+ * // {
19
+ * // visibleTags: [option_a, option_b],
20
+ * // hiddenTags: [option_c, option_d],
21
+ * // hiddenCount: 2
22
+ * // }
23
+ * ```
24
+ */
25
+ export declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
@@ -1,4 +1,4 @@
1
- /**
2
- * 文本输入 Hooks 导出
3
- */
4
- export { useTextInputState } from './useTextInputState';
1
+ /**
2
+ * 文本输入 Hooks 导出
3
+ */
4
+ export { useTextInputState } from './useTextInputState';
@@ -1,24 +1,24 @@
1
- import type { BaseTextInputProps, TextInputState } from '../types';
2
- /**
3
- * 文本输入状态管理 Hook
4
- *
5
- * 管理组件的内部状态,包括:
6
- * - 值管理(受控/非受控模式)
7
- * - 校验状态管理
8
- * - 事件处理函数封装
9
- *
10
- * 支持受控和非受控两种模式:
11
- * - 受控模式:value 由外部传入,组件不维护内部状态
12
- * - 非受控模式:使用 defaultValue,组件维护内部状态
13
- *
14
- * @param props 组件 Props(包含校验配置)
15
- * @returns 文本输入状态对象
16
- *
17
- * @example
18
- * // 受控模式
19
- * const state = useTextInputState({ value: 'hello', onChange: (v) => console.log(v) });
20
- *
21
- * // 非受控模式
22
- * const state = useTextInputState({ defaultValue: 'hello' });
23
- */
24
- export declare function useTextInputState(props: BaseTextInputProps): TextInputState;
1
+ import type { BaseTextInputProps, TextInputState } from '../types';
2
+ /**
3
+ * 文本输入状态管理 Hook
4
+ *
5
+ * 管理组件的内部状态,包括:
6
+ * - 值管理(受控/非受控模式)
7
+ * - 校验状态管理
8
+ * - 事件处理函数封装
9
+ *
10
+ * 支持受控和非受控两种模式:
11
+ * - 受控模式:value 由外部传入,组件不维护内部状态
12
+ * - 非受控模式:使用 defaultValue,组件维护内部状态
13
+ *
14
+ * @param props 组件 Props(包含校验配置)
15
+ * @returns 文本输入状态对象
16
+ *
17
+ * @example
18
+ * // 受控模式
19
+ * const state = useTextInputState({ value: 'hello', onChange: (v) => console.log(v) });
20
+ *
21
+ * // 非受控模式
22
+ * const state = useTextInputState({ defaultValue: 'hello' });
23
+ */
24
+ export declare function useTextInputState(props: BaseTextInputProps): TextInputState;
@@ -1,14 +1,14 @@
1
- /**
2
- * 文本输入组件公共逻辑导出
3
- *
4
- * 供以下组件使用:
5
- * - PisellSingleLineText
6
- * - PisellLongText
7
- * - PisellPhone
8
- * - PisellEmail
9
- * - PisellUrl
10
- */
11
- export type { DisplayState, ValidationResult, TextInputState, BaseTextInputProps, } from './types';
12
- export { useTextInputState } from './hooks';
13
- export { getDisplayState } from './utils';
14
- export { validateValue as validateTextValue } from './utils';
1
+ /**
2
+ * 文本输入组件公共逻辑导出
3
+ *
4
+ * 供以下组件使用:
5
+ * - PisellSingleLineText
6
+ * - PisellLongText
7
+ * - PisellPhone
8
+ * - PisellEmail
9
+ * - PisellUrl
10
+ */
11
+ export type { DisplayState, ValidationResult, TextInputState, BaseTextInputProps, } from './types';
12
+ export { useTextInputState } from './hooks';
13
+ export { getDisplayState } from './utils';
14
+ export { validateValue as validateTextValue } from './utils';
@@ -1,56 +1,56 @@
1
- /**
2
- * 文本输入组件公共类型定义
3
- * 供 PisellSingleLineText、PisellLongText、PisellPhone、PisellEmail、PisellUrl 等组件使用
4
- */
5
- export type { DisplayState, ValidationResult } from '../common';
6
- /**
7
- * 文本输入状态 Hook 返回值
8
- */
9
- export interface TextInputState {
10
- /**
11
- * 当前值
12
- */
13
- value: string | undefined;
14
- /**
15
- * 是否已被触摸(交互过)
16
- */
17
- isTouched: boolean;
18
- /**
19
- * 是否校验通过
20
- */
21
- isValid: boolean;
22
- /**
23
- * 错误信息数组
24
- */
25
- errors: string[];
26
- /**
27
- * 值变更处理函数
28
- */
29
- handleChange: (value: string) => void;
30
- /**
31
- * 失焦处理函数
32
- */
33
- handleBlur: () => void;
34
- /**
35
- * 聚焦处理函数
36
- */
37
- handleFocus: () => void;
38
- }
39
- /**
40
- * 基础文本输入 Props(供校验和状态管理使用)
41
- */
42
- export interface BaseTextInputProps {
43
- value?: string;
44
- defaultValue?: string;
45
- required?: boolean;
46
- minLength?: number;
47
- maxLength?: number;
48
- pattern?: string | RegExp;
49
- validator?: (value: string) => boolean | string;
50
- validateTrigger?: 'onChange' | 'onBlur' | 'both';
51
- errorMessage?: string;
52
- onChange?: (value: string) => void;
53
- onBlur?: (value: string) => void;
54
- onFocus?: () => void;
55
- onValidate?: (isValid: boolean, errors: string[]) => void;
56
- }
1
+ /**
2
+ * 文本输入组件公共类型定义
3
+ * 供 PisellSingleLineText、PisellLongText、PisellPhone、PisellEmail、PisellUrl 等组件使用
4
+ */
5
+ export type { DisplayState, ValidationResult } from '../common';
6
+ /**
7
+ * 文本输入状态 Hook 返回值
8
+ */
9
+ export interface TextInputState {
10
+ /**
11
+ * 当前值
12
+ */
13
+ value: string | undefined;
14
+ /**
15
+ * 是否已被触摸(交互过)
16
+ */
17
+ isTouched: boolean;
18
+ /**
19
+ * 是否校验通过
20
+ */
21
+ isValid: boolean;
22
+ /**
23
+ * 错误信息数组
24
+ */
25
+ errors: string[];
26
+ /**
27
+ * 值变更处理函数
28
+ */
29
+ handleChange: (value: string) => void;
30
+ /**
31
+ * 失焦处理函数
32
+ */
33
+ handleBlur: () => void;
34
+ /**
35
+ * 聚焦处理函数
36
+ */
37
+ handleFocus: () => void;
38
+ }
39
+ /**
40
+ * 基础文本输入 Props(供校验和状态管理使用)
41
+ */
42
+ export interface BaseTextInputProps {
43
+ value?: string;
44
+ defaultValue?: string;
45
+ required?: boolean;
46
+ minLength?: number;
47
+ maxLength?: number;
48
+ pattern?: string | RegExp;
49
+ validator?: (value: string) => boolean | string;
50
+ validateTrigger?: 'onChange' | 'onBlur' | 'both';
51
+ errorMessage?: string;
52
+ onChange?: (value: string) => void;
53
+ onBlur?: (value: string) => void;
54
+ onFocus?: () => void;
55
+ onValidate?: (isValid: boolean, errors: string[]) => void;
56
+ }
@@ -1,5 +1,5 @@
1
- /**
2
- * 文本输入工具函数导出
3
- */
4
- export { getDisplayState } from '../../common';
5
- export { validateValue } from './validation';
1
+ /**
2
+ * 文本输入工具函数导出
3
+ */
4
+ export { getDisplayState } from '../../common';
5
+ export { validateValue } from './validation';
@@ -1,23 +1,23 @@
1
- import type { BaseTextInputProps, ValidationResult } from '../types';
2
- /**
3
- * 校验文本输入值
4
- *
5
- * 按照优先级执行校验规则:
6
- * 1. 必填校验(required)
7
- * 2. 最小长度校验(minLength)
8
- * 3. 最大长度校验(maxLength)
9
- * 4. 正则校验(pattern)
10
- * 5. 自定义校验函数(validator)
11
- *
12
- * @param value 待校验的值
13
- * @param props 校验配置
14
- * @returns 校验结果对象,包含 isValid 和 errors
15
- *
16
- * @example
17
- * validateValue('hello', { required: true, minLength: 3 })
18
- * // { isValid: true, errors: [] }
19
- *
20
- * validateValue('', { required: true })
21
- * // { isValid: false, errors: ['此字段为必填项'] }
22
- */
23
- export declare function validateValue(value: string, props: BaseTextInputProps): ValidationResult;
1
+ import type { BaseTextInputProps, ValidationResult } from '../types';
2
+ /**
3
+ * 校验文本输入值
4
+ *
5
+ * 按照优先级执行校验规则:
6
+ * 1. 必填校验(required)
7
+ * 2. 最小长度校验(minLength)
8
+ * 3. 最大长度校验(maxLength)
9
+ * 4. 正则校验(pattern)
10
+ * 5. 自定义校验函数(validator)
11
+ *
12
+ * @param value 待校验的值
13
+ * @param props 校验配置
14
+ * @returns 校验结果对象,包含 isValid 和 errors
15
+ *
16
+ * @example
17
+ * validateValue('hello', { required: true, minLength: 3 })
18
+ * // { isValid: true, errors: [] }
19
+ *
20
+ * validateValue('', { required: true })
21
+ * // { isValid: false, errors: ['此字段为必填项'] }
22
+ */
23
+ export declare function validateValue(value: string, props: BaseTextInputProps): ValidationResult;
@@ -1,42 +1,42 @@
1
- /**
2
- * 判断是否是函数
3
- * @param obj
4
- */
5
- export declare const isFunction: (obj: any) => obj is Function;
6
- /**
7
- * 判断是否是数组
8
- * @param obj
9
- */
10
- export declare const isArr: (obj: any) => obj is any[];
11
- /**
12
- * 判断是否是字符串
13
- * @param obj
14
- */
15
- export declare const isString: (obj: any) => obj is string;
16
- /**
17
- * 判断是否是数字
18
- * @param obj
19
- */
20
- export declare const isNumber: (obj: any) => obj is number;
21
- /**
22
- * 判断是否是undefined
23
- * @param obj
24
- */
25
- export declare const isUndefined: (obj: any) => obj is undefined;
26
- /**
27
- * 判断是否是boolean
28
- * @param obj
29
- */
30
- export declare const isBoolean: (obj: any) => obj is boolean;
31
- /**
32
- * 判断是否是json字符串
33
- * @param v
34
- */
35
- export declare const isJson: (v: any) => boolean;
36
- /**
37
- * @Title: 判断是否为对象
38
- * @Describe:
39
- * @Author: Wzw
40
- * @param {any} obj
41
- */
42
- export declare const isPlainObject: (obj: any) => boolean;
1
+ /**
2
+ * 判断是否是函数
3
+ * @param obj
4
+ */
5
+ export declare const isFunction: (obj: any) => obj is Function;
6
+ /**
7
+ * 判断是否是数组
8
+ * @param obj
9
+ */
10
+ export declare const isArr: (obj: any) => obj is any[];
11
+ /**
12
+ * 判断是否是字符串
13
+ * @param obj
14
+ */
15
+ export declare const isString: (obj: any) => obj is string;
16
+ /**
17
+ * 判断是否是数字
18
+ * @param obj
19
+ */
20
+ export declare const isNumber: (obj: any) => obj is number;
21
+ /**
22
+ * 判断是否是undefined
23
+ * @param obj
24
+ */
25
+ export declare const isUndefined: (obj: any) => obj is undefined;
26
+ /**
27
+ * 判断是否是boolean
28
+ * @param obj
29
+ */
30
+ export declare const isBoolean: (obj: any) => obj is boolean;
31
+ /**
32
+ * 判断是否是json字符串
33
+ * @param v
34
+ */
35
+ export declare const isJson: (v: any) => boolean;
36
+ /**
37
+ * @Title: 判断是否为对象
38
+ * @Describe:
39
+ * @Author: Wzw
40
+ * @param {any} obj
41
+ */
42
+ export declare const isPlainObject: (obj: any) => boolean;
@@ -0,0 +1,44 @@
1
+ export declare type Locale = 'en' | 'zh-CN' | 'zh-HK';
2
+ interface ScheduleItem {
3
+ id: number;
4
+ name: string | {
5
+ [key: string]: string;
6
+ };
7
+ type: 'standard' | 'time-slots' | 'designation';
8
+ start_time: string | null;
9
+ end_time: string | null;
10
+ repeat_type: 'none' | 'daily' | 'weekly' | 'monthly' | 'yearly';
11
+ repeat_rule: {
12
+ end: {
13
+ type: 'never' | 'date' | 'occurrence';
14
+ end_date: string | null;
15
+ occurrence: number | null;
16
+ };
17
+ frequency: number;
18
+ excluded_date: Array<{
19
+ start: string;
20
+ end: string;
21
+ }>;
22
+ included_date: any[];
23
+ frequency_date: number[];
24
+ } | null;
25
+ designation: Array<{
26
+ start_date: string;
27
+ start_time: string;
28
+ end_date: string;
29
+ end_time: string;
30
+ }> | null;
31
+ is_all: number;
32
+ time_slot: Array<{
33
+ start_time: string;
34
+ end_time: string;
35
+ }>;
36
+ }
37
+ /**
38
+ * 获取schedule摘要信息
39
+ * @param scheduleList 日程列表
40
+ * @param locale 语言设置
41
+ * @returns 摘要文本
42
+ */
43
+ export declare function getScheduleSummary(scheduleList: ScheduleItem[], locale?: Locale): string;
44
+ export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pisell/utils",
3
- "version": "1.0.57",
3
+ "version": "1.0.58",
4
4
  "sideEffects": false,
5
5
  "main": "./lib/index.js",
6
6
  "module": "./es/index.js",