@pisell/utils 1.0.70 → 1.0.71

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 (129) 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/componentStorage.d.ts +36 -36
  9. package/es/componentStorage.js +7 -7
  10. package/es/constants/index.d.ts +7 -7
  11. package/es/date.d.ts +28 -28
  12. package/es/date.js +22 -22
  13. package/es/document.d.ts +13 -13
  14. package/es/document.js +7 -7
  15. package/es/escPosPrinter/index.d.ts +9 -9
  16. package/es/firebase/config/index.d.ts +13 -13
  17. package/es/firebase/index.d.ts +28 -28
  18. package/es/format.d.ts +28 -28
  19. package/es/format.js +14 -14
  20. package/es/image.d.ts +11 -11
  21. package/es/image.js +5 -5
  22. package/es/index.d.ts +25 -25
  23. package/es/jsBridge/index.d.ts +22 -22
  24. package/es/jsBridge/index.js +15 -15
  25. package/es/jsBridge/regDeviceApi.d.ts +15 -15
  26. package/es/jsBridge/regDeviceApi.js +3 -3
  27. package/es/jsBridge/types.d.ts +149 -149
  28. package/es/locales.d.ts +9 -9
  29. package/es/locales.js +15 -15
  30. package/es/log.d.ts +10 -10
  31. package/es/miniRedux.d.ts +16 -16
  32. package/es/number-input/hooks/index.d.ts +4 -4
  33. package/es/number-input/hooks/index.js +2 -2
  34. package/es/number-input/hooks/useNumberInputState.d.ts +25 -25
  35. package/es/number-input/hooks/useNumberInputState.js +39 -39
  36. package/es/number-input/index.d.ts +14 -14
  37. package/es/number-input/index.js +8 -8
  38. package/es/number-input/types.d.ts +96 -96
  39. package/es/number-input/utils/formatter.d.ts +53 -53
  40. package/es/number-input/utils/formatter.js +37 -37
  41. package/es/number-input/utils/index.d.ts +7 -7
  42. package/es/number-input/utils/index.js +2 -2
  43. package/es/number-input/utils/validation.d.ts +27 -27
  44. package/es/number-input/utils/validation.js +24 -24
  45. package/es/otherUtils.d.ts +48 -48
  46. package/es/otherUtils.js +32 -32
  47. package/es/platform.d.ts +9 -9
  48. package/es/select/hooks/index.d.ts +5 -5
  49. package/es/select/hooks/index.js +2 -2
  50. package/es/select/hooks/useDebouncedSearch.d.ts +20 -20
  51. package/es/select/hooks/useDebouncedSearch.js +17 -17
  52. package/es/select/hooks/useSelectState.d.ts +19 -19
  53. package/es/select/hooks/useSelectState.js +13 -13
  54. package/es/select/index.d.ts +8 -8
  55. package/es/select/index.js +3 -3
  56. package/es/select/types.d.ts +256 -256
  57. package/es/select/utils/filterOptions.d.ts +22 -22
  58. package/es/select/utils/filterOptions.js +16 -16
  59. package/es/select/utils/helpers.d.ts +42 -42
  60. package/es/select/utils/helpers.js +30 -30
  61. package/es/select/utils/index.d.ts +7 -7
  62. package/es/select/utils/index.js +2 -2
  63. package/es/select/utils/sortOptions.d.ts +12 -12
  64. package/es/select/utils/sortOptions.js +8 -8
  65. package/es/select/utils/tagAggregation.d.ts +25 -25
  66. package/es/select/utils/tagAggregation.js +21 -21
  67. package/es/text-input/hooks/index.d.ts +4 -4
  68. package/es/text-input/hooks/index.js +2 -2
  69. package/es/text-input/hooks/useTextInputState.d.ts +24 -24
  70. package/es/text-input/hooks/useTextInputState.js +38 -38
  71. package/es/text-input/index.d.ts +14 -14
  72. package/es/text-input/index.js +9 -9
  73. package/es/text-input/types.d.ts +56 -56
  74. package/es/text-input/utils/index.d.ts +5 -5
  75. package/es/text-input/utils/index.js +2 -2
  76. package/es/text-input/utils/validation.d.ts +23 -23
  77. package/es/text-input/utils/validation.js +20 -20
  78. package/es/typeUtils.d.ts +42 -42
  79. package/es/typeUtils.js +26 -26
  80. package/es/walletValidity.d.ts +44 -44
  81. package/es/walletValidity.js +85 -85
  82. package/lib/arrayUtils.d.ts +1 -1
  83. package/lib/common/index.d.ts +5 -5
  84. package/lib/common/stateHelper.d.ts +18 -18
  85. package/lib/common/types.d.ts +28 -28
  86. package/lib/componentStorage.d.ts +36 -36
  87. package/lib/constants/index.d.ts +7 -7
  88. package/lib/date.d.ts +28 -28
  89. package/lib/document.d.ts +13 -13
  90. package/lib/escPosPrinter/index.d.ts +9 -9
  91. package/lib/firebase/config/index.d.ts +13 -13
  92. package/lib/firebase/index.d.ts +28 -28
  93. package/lib/format.d.ts +28 -28
  94. package/lib/image.d.ts +11 -11
  95. package/lib/index.d.ts +25 -25
  96. package/lib/jsBridge/index.d.ts +22 -22
  97. package/lib/jsBridge/regDeviceApi.d.ts +15 -15
  98. package/lib/jsBridge/types.d.ts +149 -149
  99. package/lib/locales.d.ts +9 -9
  100. package/lib/log.d.ts +10 -10
  101. package/lib/miniRedux.d.ts +16 -16
  102. package/lib/number-input/hooks/index.d.ts +4 -4
  103. package/lib/number-input/hooks/useNumberInputState.d.ts +25 -25
  104. package/lib/number-input/index.d.ts +14 -14
  105. package/lib/number-input/types.d.ts +96 -96
  106. package/lib/number-input/utils/formatter.d.ts +53 -53
  107. package/lib/number-input/utils/index.d.ts +7 -7
  108. package/lib/number-input/utils/validation.d.ts +27 -27
  109. package/lib/otherUtils.d.ts +48 -48
  110. package/lib/platform.d.ts +9 -9
  111. package/lib/select/hooks/index.d.ts +5 -5
  112. package/lib/select/hooks/useDebouncedSearch.d.ts +20 -20
  113. package/lib/select/hooks/useSelectState.d.ts +19 -19
  114. package/lib/select/index.d.ts +8 -8
  115. package/lib/select/types.d.ts +256 -256
  116. package/lib/select/utils/filterOptions.d.ts +22 -22
  117. package/lib/select/utils/helpers.d.ts +42 -42
  118. package/lib/select/utils/index.d.ts +7 -7
  119. package/lib/select/utils/sortOptions.d.ts +12 -12
  120. package/lib/select/utils/tagAggregation.d.ts +25 -25
  121. package/lib/text-input/hooks/index.d.ts +4 -4
  122. package/lib/text-input/hooks/useTextInputState.d.ts +24 -24
  123. package/lib/text-input/index.d.ts +14 -14
  124. package/lib/text-input/types.d.ts +56 -56
  125. package/lib/text-input/utils/index.d.ts +5 -5
  126. package/lib/text-input/utils/validation.d.ts +23 -23
  127. package/lib/typeUtils.d.ts +42 -42
  128. package/lib/walletValidity.d.ts +44 -44
  129. package/package.json +1 -1
@@ -1,149 +1,149 @@
1
- declare type LanguageNumber = {
2
- en: number;
3
- zh_CN: number;
4
- zh_HK: number;
5
- };
6
- declare type LanguageString = {
7
- en: string;
8
- zh_CN: string;
9
- zh_HK: string;
10
- } | string;
11
- /**
12
- * 打印小票
13
- */
14
- export declare type WebPrint0 = {
15
- /**
16
- * 打印类型
17
- * 0: 小票
18
- * 1:ITS备货单/划菜单
19
- * 2:手环
20
- */
21
- type: '0';
22
- data: {
23
- /** 订单ID */
24
- order_id: string;
25
- };
26
- /** 打印语言对应的数量 */
27
- language: LanguageNumber;
28
- };
29
- /**
30
- * 打印ITS备货单/划菜单
31
- */
32
- export declare type WebPrint1 = {
33
- /**
34
- * 打印类型
35
- * 0: 小票
36
- * 1:ITS备货单/划菜单
37
- * 2:手环
38
- */
39
- type: '1';
40
- data: {
41
- /** 0:备货 1:划单 */
42
- mode: '0' | '1';
43
- resource: LanguageString;
44
- /** 订单备注 */
45
- order_note: string;
46
- /** 订单时间或商品下单时间 */
47
- time: string;
48
- /** 订单编号 */
49
- order_number?: string;
50
- /** 商品 */
51
- products: {
52
- /** 商品名称 */
53
- product_title: LanguageString;
54
- /** 商品规格 */
55
- product_option_string: LanguageString;
56
- /** 商品备注 */
57
- product_note: string;
58
- /** 商品数量 */
59
- product_quantity: number;
60
- /** 加菜标识 待定 */
61
- is_append?: boolean;
62
- /** 退菜标识 待定 */
63
- is_removed?: boolean;
64
- }[];
65
- };
66
- /** 打印语言对应的数量 */
67
- language: LanguageNumber;
68
- };
69
- /**
70
- * 打印手环
71
- */
72
- export declare type WebPrint2 = {
73
- /**
74
- * 打印类型
75
- * 0: 小票
76
- * 1:ITS备货单/划菜单
77
- * 2:手环
78
- */
79
- type: '2';
80
- data: {
81
- /** 0: 普通票 1:成人票 2:免费成人票 */
82
- type: '0' | '1' | '2';
83
- /** 发行编码 */
84
- encoded: string;
85
- /** 编码 */
86
- code: string;
87
- /** 到期时间 */
88
- expire_date: string;
89
- areas: {
90
- /** 区域名字 */
91
- area_name: string;
92
- /** 区域代码 */
93
- area_code: string;
94
- /** 可用次数 */
95
- limit_num: number;
96
- /** 已用次数 */
97
- used_num: number;
98
- }[];
99
- };
100
- };
101
- /**
102
- * 打印充值卡
103
- */
104
- export declare type WebPrint4 = {
105
- type: '4';
106
- data: {
107
- order_id: string;
108
- };
109
- };
110
- /**
111
- * 打印订单中所有
112
- */
113
- export declare type WebPrint99 = {
114
- type: '99';
115
- data: {
116
- order_id: string;
117
- machine_code_print_info: {
118
- [key: string]: any;
119
- }[];
120
- small_ticket_data: {
121
- [key: string]: any;
122
- };
123
- };
124
- };
125
- /**
126
- * 打印
127
- */
128
- export declare type WebPrintParams = WebPrint0 | WebPrint1 | WebPrint2 | WebPrint4 | WebPrint99;
129
- /**
130
- * 数据管理
131
- */
132
- export declare type DataManagerParams = {
133
- module: 'set' | 'get';
134
- key: string;
135
- data?: any;
136
- };
137
- /**
138
- * 支付
139
- */
140
- export declare type WebPaymentParams = {
141
- module: 'payment' | 'refund' | string;
142
- key: 'mx51' | string;
143
- data?: {
144
- order_id: string | number;
145
- amount: string | number;
146
- surcharge?: string | number;
147
- };
148
- };
149
- export {};
1
+ declare type LanguageNumber = {
2
+ en: number;
3
+ zh_CN: number;
4
+ zh_HK: number;
5
+ };
6
+ declare type LanguageString = {
7
+ en: string;
8
+ zh_CN: string;
9
+ zh_HK: string;
10
+ } | string;
11
+ /**
12
+ * 打印小票
13
+ */
14
+ export declare type WebPrint0 = {
15
+ /**
16
+ * 打印类型
17
+ * 0: 小票
18
+ * 1:ITS备货单/划菜单
19
+ * 2:手环
20
+ */
21
+ type: '0';
22
+ data: {
23
+ /** 订单ID */
24
+ order_id: string;
25
+ };
26
+ /** 打印语言对应的数量 */
27
+ language: LanguageNumber;
28
+ };
29
+ /**
30
+ * 打印ITS备货单/划菜单
31
+ */
32
+ export declare type WebPrint1 = {
33
+ /**
34
+ * 打印类型
35
+ * 0: 小票
36
+ * 1:ITS备货单/划菜单
37
+ * 2:手环
38
+ */
39
+ type: '1';
40
+ data: {
41
+ /** 0:备货 1:划单 */
42
+ mode: '0' | '1';
43
+ resource: LanguageString;
44
+ /** 订单备注 */
45
+ order_note: string;
46
+ /** 订单时间或商品下单时间 */
47
+ time: string;
48
+ /** 订单编号 */
49
+ order_number?: string;
50
+ /** 商品 */
51
+ products: {
52
+ /** 商品名称 */
53
+ product_title: LanguageString;
54
+ /** 商品规格 */
55
+ product_option_string: LanguageString;
56
+ /** 商品备注 */
57
+ product_note: string;
58
+ /** 商品数量 */
59
+ product_quantity: number;
60
+ /** 加菜标识 待定 */
61
+ is_append?: boolean;
62
+ /** 退菜标识 待定 */
63
+ is_removed?: boolean;
64
+ }[];
65
+ };
66
+ /** 打印语言对应的数量 */
67
+ language: LanguageNumber;
68
+ };
69
+ /**
70
+ * 打印手环
71
+ */
72
+ export declare type WebPrint2 = {
73
+ /**
74
+ * 打印类型
75
+ * 0: 小票
76
+ * 1:ITS备货单/划菜单
77
+ * 2:手环
78
+ */
79
+ type: '2';
80
+ data: {
81
+ /** 0: 普通票 1:成人票 2:免费成人票 */
82
+ type: '0' | '1' | '2';
83
+ /** 发行编码 */
84
+ encoded: string;
85
+ /** 编码 */
86
+ code: string;
87
+ /** 到期时间 */
88
+ expire_date: string;
89
+ areas: {
90
+ /** 区域名字 */
91
+ area_name: string;
92
+ /** 区域代码 */
93
+ area_code: string;
94
+ /** 可用次数 */
95
+ limit_num: number;
96
+ /** 已用次数 */
97
+ used_num: number;
98
+ }[];
99
+ };
100
+ };
101
+ /**
102
+ * 打印充值卡
103
+ */
104
+ export declare type WebPrint4 = {
105
+ type: '4';
106
+ data: {
107
+ order_id: string;
108
+ };
109
+ };
110
+ /**
111
+ * 打印订单中所有
112
+ */
113
+ export declare type WebPrint99 = {
114
+ type: '99';
115
+ data: {
116
+ order_id: string;
117
+ machine_code_print_info: {
118
+ [key: string]: any;
119
+ }[];
120
+ small_ticket_data: {
121
+ [key: string]: any;
122
+ };
123
+ };
124
+ };
125
+ /**
126
+ * 打印
127
+ */
128
+ export declare type WebPrintParams = WebPrint0 | WebPrint1 | WebPrint2 | WebPrint4 | WebPrint99;
129
+ /**
130
+ * 数据管理
131
+ */
132
+ export declare type DataManagerParams = {
133
+ module: 'set' | 'get';
134
+ key: string;
135
+ data?: any;
136
+ };
137
+ /**
138
+ * 支付
139
+ */
140
+ export declare type WebPaymentParams = {
141
+ module: 'payment' | 'refund' | string;
142
+ key: 'mx51' | string;
143
+ data?: {
144
+ order_id: string | number;
145
+ amount: string | number;
146
+ surcharge?: string | number;
147
+ };
148
+ };
149
+ export {};
package/lib/locales.d.ts CHANGED
@@ -1,9 +1,9 @@
1
- export declare const locales: {
2
- init: (_localeMaps: any, _locale: string) => void;
3
- getText: (id: string) => any;
4
- getLocale: () => string;
5
- locale: string;
6
- localeMap: any;
7
- localeMaps: any;
8
- formatLocale: (_locale: string) => string;
9
- };
1
+ export declare const locales: {
2
+ init: (_localeMaps: any, _locale: string) => void;
3
+ getText: (id: string) => any;
4
+ getLocale: () => string;
5
+ locale: string;
6
+ localeMap: any;
7
+ localeMaps: any;
8
+ formatLocale: (_locale: string) => string;
9
+ };
package/lib/log.d.ts CHANGED
@@ -1,10 +1,10 @@
1
- interface contentItem {
2
- key: string;
3
- value: string;
4
- }
5
- interface sendWebhookProps {
6
- title: string;
7
- content: contentItem[];
8
- }
9
- export declare const sendWarningLog: ({ title, content }: sendWebhookProps) => Promise<any>;
10
- export {};
1
+ interface contentItem {
2
+ key: string;
3
+ value: string;
4
+ }
5
+ interface sendWebhookProps {
6
+ title: string;
7
+ content: contentItem[];
8
+ }
9
+ export declare const sendWarningLog: ({ title, content }: sendWebhookProps) => Promise<any>;
10
+ export {};
@@ -1,16 +1,16 @@
1
- interface MiniReduxProps<State, Namespace> {
2
- namespace?: Namespace;
3
- state?: State;
4
- reducers?: any;
5
- effects?: any;
6
- }
7
- export declare const miniRedux: <State extends Record<string, any>, Namespace extends string>({ namespace, state, reducers, effects, }: MiniReduxProps<State, Namespace>) => {
8
- Context: React.Context<{ [K in Namespace]: State; } & {
9
- dispatch: (params: {
10
- type: string;
11
- payload: any;
12
- }) => void;
13
- }>;
14
- Provider: (ComponentUi: any) => any;
15
- };
16
- export {};
1
+ interface MiniReduxProps<State, Namespace> {
2
+ namespace?: Namespace;
3
+ state?: State;
4
+ reducers?: any;
5
+ effects?: any;
6
+ }
7
+ export declare const miniRedux: <State extends Record<string, any>, Namespace extends string>({ namespace, state, reducers, effects, }: MiniReduxProps<State, Namespace>) => {
8
+ Context: React.Context<{ [K in Namespace]: State; } & {
9
+ dispatch: (params: {
10
+ type: string;
11
+ payload: any;
12
+ }) => void;
13
+ }>;
14
+ Provider: (ComponentUi: any) => any;
15
+ };
16
+ export {};
@@ -1,4 +1,4 @@
1
- /**
2
- * 数值输入 Hooks 导出
3
- */
4
- export { useNumberInputState } from './useNumberInputState';
1
+ /**
2
+ * 数值输入 Hooks 导出
3
+ */
4
+ export { useNumberInputState } from './useNumberInputState';
@@ -1,25 +1,25 @@
1
- import type { BaseNumberInputProps, NumberInputState } 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 = useNumberInputState({ value: 10, onChange: (v) => console.log(v) });
20
- *
21
- * @example
22
- * // 非受控模式
23
- * const state = useNumberInputState({ defaultValue: 10, min: 0, max: 100 });
24
- */
25
- export declare function useNumberInputState(props: BaseNumberInputProps): NumberInputState;
1
+ import type { BaseNumberInputProps, NumberInputState } 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 = useNumberInputState({ value: 10, onChange: (v) => console.log(v) });
20
+ *
21
+ * @example
22
+ * // 非受控模式
23
+ * const state = useNumberInputState({ defaultValue: 10, min: 0, max: 100 });
24
+ */
25
+ export declare function useNumberInputState(props: BaseNumberInputProps): NumberInputState;
@@ -1,14 +1,14 @@
1
- /**
2
- * 数值输入组件公共逻辑导出
3
- *
4
- * 供以下组件使用:
5
- * - PisellNumber
6
- * - PisellCurrency
7
- * - PisellPercent
8
- * - 其他数值输入组件
9
- */
10
- export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps, } from './types';
11
- export { useNumberInputState } from './hooks';
12
- export { getDisplayState, formatNumber, addThousandsSeparator, formatPrecision, } from './utils';
13
- export { validateValue as validateNumberValue } from './utils';
14
- export type { NumberFormatOptions } from './utils';
1
+ /**
2
+ * 数值输入组件公共逻辑导出
3
+ *
4
+ * 供以下组件使用:
5
+ * - PisellNumber
6
+ * - PisellCurrency
7
+ * - PisellPercent
8
+ * - 其他数值输入组件
9
+ */
10
+ export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps, } from './types';
11
+ export { useNumberInputState } from './hooks';
12
+ export { getDisplayState, formatNumber, addThousandsSeparator, formatPrecision, } from './utils';
13
+ export { validateValue as validateNumberValue } from './utils';
14
+ export type { NumberFormatOptions } from './utils';
@@ -1,96 +1,96 @@
1
- /**
2
- * 数值输入组件公共类型定义
3
- * 供 PisellNumber、PisellCurrency、PisellPercent 等组件使用
4
- */
5
- export type { DisplayState, ValidationResult } from '../common';
6
- /**
7
- * 数值输入状态 Hook 返回值
8
- */
9
- export interface NumberInputState {
10
- /**
11
- * 当前值
12
- */
13
- value: number | null | 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: number | null) => void;
30
- /**
31
- * 失焦处理函数
32
- */
33
- handleBlur: () => void;
34
- /**
35
- * 聚焦处理函数
36
- */
37
- handleFocus: () => void;
38
- }
39
- /**
40
- * 基础数值输入 Props(供校验和状态管理使用)
41
- */
42
- export interface BaseNumberInputProps {
43
- /**
44
- * 当前值(受控)
45
- */
46
- value?: number | null;
47
- /**
48
- * 默认值(非受控)
49
- */
50
- defaultValue?: number | null;
51
- /**
52
- * 是否必填
53
- */
54
- required?: boolean;
55
- /**
56
- * 最小值
57
- */
58
- min?: number;
59
- /**
60
- * 最大值
61
- */
62
- max?: number;
63
- /**
64
- * 自定义校验函数
65
- * @param value 当前值
66
- * @returns true 表示通过,false 或错误信息字符串表示不通过
67
- */
68
- validator?: (value: number | null) => boolean | string;
69
- /**
70
- * 校验触发时机
71
- * - onChange: 输入时即时校验
72
- * - onBlur: 失焦时校验
73
- * - both: 输入和失焦时都校验
74
- */
75
- validateTrigger?: 'onChange' | 'onBlur' | 'both';
76
- /**
77
- * 自定义错误提示信息
78
- */
79
- errorMessage?: string;
80
- /**
81
- * 值变更回调
82
- */
83
- onChange?: (value: number | null) => void;
84
- /**
85
- * 失焦回调
86
- */
87
- onBlur?: (value: number | null) => void;
88
- /**
89
- * 聚焦回调
90
- */
91
- onFocus?: () => void;
92
- /**
93
- * 校验回调
94
- */
95
- onValidate?: (isValid: boolean, errors: string[]) => void;
96
- }
1
+ /**
2
+ * 数值输入组件公共类型定义
3
+ * 供 PisellNumber、PisellCurrency、PisellPercent 等组件使用
4
+ */
5
+ export type { DisplayState, ValidationResult } from '../common';
6
+ /**
7
+ * 数值输入状态 Hook 返回值
8
+ */
9
+ export interface NumberInputState {
10
+ /**
11
+ * 当前值
12
+ */
13
+ value: number | null | 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: number | null) => void;
30
+ /**
31
+ * 失焦处理函数
32
+ */
33
+ handleBlur: () => void;
34
+ /**
35
+ * 聚焦处理函数
36
+ */
37
+ handleFocus: () => void;
38
+ }
39
+ /**
40
+ * 基础数值输入 Props(供校验和状态管理使用)
41
+ */
42
+ export interface BaseNumberInputProps {
43
+ /**
44
+ * 当前值(受控)
45
+ */
46
+ value?: number | null;
47
+ /**
48
+ * 默认值(非受控)
49
+ */
50
+ defaultValue?: number | null;
51
+ /**
52
+ * 是否必填
53
+ */
54
+ required?: boolean;
55
+ /**
56
+ * 最小值
57
+ */
58
+ min?: number;
59
+ /**
60
+ * 最大值
61
+ */
62
+ max?: number;
63
+ /**
64
+ * 自定义校验函数
65
+ * @param value 当前值
66
+ * @returns true 表示通过,false 或错误信息字符串表示不通过
67
+ */
68
+ validator?: (value: number | null) => boolean | string;
69
+ /**
70
+ * 校验触发时机
71
+ * - onChange: 输入时即时校验
72
+ * - onBlur: 失焦时校验
73
+ * - both: 输入和失焦时都校验
74
+ */
75
+ validateTrigger?: 'onChange' | 'onBlur' | 'both';
76
+ /**
77
+ * 自定义错误提示信息
78
+ */
79
+ errorMessage?: string;
80
+ /**
81
+ * 值变更回调
82
+ */
83
+ onChange?: (value: number | null) => void;
84
+ /**
85
+ * 失焦回调
86
+ */
87
+ onBlur?: (value: number | null) => void;
88
+ /**
89
+ * 聚焦回调
90
+ */
91
+ onFocus?: () => void;
92
+ /**
93
+ * 校验回调
94
+ */
95
+ onValidate?: (isValid: boolean, errors: string[]) => void;
96
+ }