amis 1.9.0 → 1.9.1-beta.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (269) hide show
  1. package/lib/RootRenderer.js +10 -2
  2. package/lib/RootRenderer.js.map +2 -2
  3. package/lib/Schema.d.ts +3 -2
  4. package/lib/Schema.js.map +1 -1
  5. package/lib/actions/Action.d.ts +1 -0
  6. package/lib/actions/Action.js +7 -6
  7. package/lib/actions/Action.js.map +2 -2
  8. package/lib/components/Button.d.ts +11 -10
  9. package/lib/components/Button.js +2 -2
  10. package/lib/components/Button.js.map +2 -2
  11. package/lib/components/CalendarMobile.d.ts +40 -40
  12. package/lib/components/Checkbox.js +1 -1
  13. package/lib/components/Checkbox.js.map +2 -2
  14. package/lib/components/ContextMenu.d.ts +4 -0
  15. package/lib/components/ContextMenu.js +23 -7
  16. package/lib/components/ContextMenu.js.map +2 -2
  17. package/lib/components/DatePicker.d.ts +40 -40
  18. package/lib/components/DateRangePicker.d.ts +40 -40
  19. package/lib/components/Form.d.ts +22 -0
  20. package/lib/components/Form.js +44 -0
  21. package/lib/components/Form.js.map +13 -0
  22. package/lib/components/FormField.d.ts +65 -0
  23. package/lib/components/FormField.js +48 -0
  24. package/lib/components/FormField.js.map +13 -0
  25. package/lib/components/InputBox.d.ts +10 -10
  26. package/lib/components/InputBox.js +4 -3
  27. package/lib/components/InputBox.js.map +2 -2
  28. package/lib/components/InputBoxWithSuggestion.d.ts +280 -0
  29. package/lib/components/InputBoxWithSuggestion.js +65 -0
  30. package/lib/components/InputBoxWithSuggestion.js.map +13 -0
  31. package/lib/components/ListGroup.d.ts +10 -10
  32. package/lib/components/PickerContainer.d.ts +4 -2
  33. package/lib/components/PickerContainer.js +28 -5
  34. package/lib/components/PickerContainer.js.map +2 -2
  35. package/lib/components/Radios.d.ts +10 -10
  36. package/lib/components/ResultBox.d.ts +40 -40
  37. package/lib/components/Select.d.ts +195 -202
  38. package/lib/components/Select.js +7 -3
  39. package/lib/components/Select.js.map +2 -2
  40. package/lib/components/Textarea.d.ts +568 -2
  41. package/lib/components/Textarea.js +129 -1
  42. package/lib/components/Textarea.js.map +2 -2
  43. package/lib/components/Toast.js +11 -9
  44. package/lib/components/Toast.js.map +2 -2
  45. package/lib/components/UserSelect.d.ts +500 -0
  46. package/lib/components/UserSelect.js +559 -0
  47. package/lib/components/UserSelect.js.map +13 -0
  48. package/lib/components/UserTabSelect.d.ts +320 -0
  49. package/lib/components/UserTabSelect.js +163 -0
  50. package/lib/components/UserTabSelect.js.map +13 -0
  51. package/lib/components/WithRemoteConfig.d.ts +7 -0
  52. package/lib/components/WithRemoteConfig.js +17 -11
  53. package/lib/components/WithRemoteConfig.js.map +2 -2
  54. package/lib/components/calendar/DaysView.d.ts +26 -1
  55. package/lib/components/calendar/DaysView.js +60 -19
  56. package/lib/components/calendar/DaysView.js.map +2 -2
  57. package/lib/components/calendar/TimeView.d.ts +1 -1
  58. package/lib/components/calendar/TimeView.js +10 -3
  59. package/lib/components/calendar/TimeView.js.map +2 -2
  60. package/lib/components/formula/Picker.js +4 -4
  61. package/lib/components/formula/Picker.js.map +2 -2
  62. package/lib/components/icons.d.ts +7 -1
  63. package/lib/components/icons.js +17 -1
  64. package/lib/components/icons.js.map +2 -2
  65. package/lib/components/index.d.ts +2 -1
  66. package/lib/components/index.js +3 -1
  67. package/lib/components/index.js.map +2 -2
  68. package/lib/components/json-schema/Array.d.ts +3 -0
  69. package/lib/components/json-schema/Array.js +125 -0
  70. package/lib/components/json-schema/Array.js.map +13 -0
  71. package/lib/components/json-schema/Item.d.ts +3 -0
  72. package/lib/components/json-schema/Item.js +34 -0
  73. package/lib/components/json-schema/Item.js.map +13 -0
  74. package/lib/components/json-schema/Object.d.ts +3 -0
  75. package/lib/components/json-schema/Object.js +178 -0
  76. package/lib/components/json-schema/Object.js.map +13 -0
  77. package/lib/components/json-schema/index.d.ts +279 -0
  78. package/lib/components/json-schema/index.js +16 -0
  79. package/lib/components/json-schema/index.js.map +13 -0
  80. package/lib/components/schema-editor/Array.js +2 -2
  81. package/lib/components/schema-editor/Array.js.map +2 -2
  82. package/lib/components/schema-editor/Common.d.ts +2 -0
  83. package/lib/components/schema-editor/Common.js +39 -3
  84. package/lib/components/schema-editor/Common.js.map +2 -2
  85. package/lib/components/schema-editor/Object.js +2 -2
  86. package/lib/components/schema-editor/Object.js.map +2 -2
  87. package/lib/components/schema-editor/index.d.ts +45 -41
  88. package/lib/components/schema-editor/index.js +5 -5
  89. package/lib/components/schema-editor/index.js.map +2 -2
  90. package/lib/helper.css +125 -124
  91. package/lib/helper.css.map +1 -1
  92. package/lib/hooks/use-validation-resolver.d.ts +1 -0
  93. package/lib/hooks/use-validation-resolver.js +49 -0
  94. package/lib/hooks/use-validation-resolver.js.map +13 -0
  95. package/lib/icons/department.js +17 -0
  96. package/lib/icons/menu.js +9 -0
  97. package/lib/icons/post.js +15 -0
  98. package/lib/icons/role.js +14 -0
  99. package/lib/icons/user-remove.js +12 -0
  100. package/lib/index.d.ts +2 -0
  101. package/lib/index.js +3 -1
  102. package/lib/index.js.map +2 -2
  103. package/lib/locale/de-DE.js +11 -1
  104. package/lib/locale/de-DE.js.map +2 -2
  105. package/lib/locale/en-US.js +12 -1
  106. package/lib/locale/en-US.js.map +2 -2
  107. package/lib/locale/zh-CN.js +14 -3
  108. package/lib/locale/zh-CN.js.map +2 -2
  109. package/lib/renderers/Action.js +25 -11
  110. package/lib/renderers/Action.js.map +2 -2
  111. package/lib/renderers/CRUD.js +5 -1
  112. package/lib/renderers/CRUD.js.map +2 -2
  113. package/lib/renderers/Dialog.js +9 -3
  114. package/lib/renderers/Dialog.js.map +2 -2
  115. package/lib/renderers/Drawer.js +5 -1
  116. package/lib/renderers/Drawer.js.map +2 -2
  117. package/lib/renderers/Form/InputDate.d.ts +2 -2
  118. package/lib/renderers/Form/InputDate.js.map +2 -2
  119. package/lib/renderers/Form/InputFile.js +5 -12
  120. package/lib/renderers/Form/InputFile.js.map +2 -2
  121. package/lib/renderers/Form/InputText.d.ts +1 -1
  122. package/lib/renderers/Form/InputText.js.map +1 -1
  123. package/lib/renderers/Form/JSONSchema.d.ts +23 -0
  124. package/lib/renderers/Form/JSONSchema.js +44 -0
  125. package/lib/renderers/Form/JSONSchema.js.map +13 -0
  126. package/lib/renderers/Form/JSONSchemaEditor.d.ts +2 -3
  127. package/lib/renderers/Form/JSONSchemaEditor.js +9 -24
  128. package/lib/renderers/Form/JSONSchemaEditor.js.map +2 -2
  129. package/lib/renderers/Form/Textarea.d.ts +1 -8
  130. package/lib/renderers/Form/Textarea.js +11 -75
  131. package/lib/renderers/Form/Textarea.js.map +2 -2
  132. package/lib/renderers/Form/UserSelect.d.ts +54 -0
  133. package/lib/renderers/Form/UserSelect.js +197 -0
  134. package/lib/renderers/Form/UserSelect.js.map +13 -0
  135. package/lib/renderers/Form/index.d.ts +1 -1
  136. package/lib/renderers/Form/index.js +88 -42
  137. package/lib/renderers/Form/index.js.map +2 -2
  138. package/lib/renderers/Link.d.ts +1 -1
  139. package/lib/renderers/Link.js +15 -29
  140. package/lib/renderers/Link.js.map +2 -2
  141. package/lib/renderers/Log.d.ts +28 -0
  142. package/lib/renderers/Log.js +110 -20
  143. package/lib/renderers/Log.js.map +2 -2
  144. package/lib/renderers/Page.js +5 -1
  145. package/lib/renderers/Page.js.map +2 -2
  146. package/lib/renderers/Service.js +5 -1
  147. package/lib/renderers/Service.js.map +2 -2
  148. package/lib/renderers/Wizard.js +37 -14
  149. package/lib/renderers/Wizard.js.map +2 -2
  150. package/lib/store/form.js +65 -45
  151. package/lib/store/form.js.map +2 -2
  152. package/lib/themes/ang-ie11.css +576 -24
  153. package/lib/themes/ang.css +553 -12
  154. package/lib/themes/ang.css.map +1 -1
  155. package/lib/themes/antd-ie11.css +576 -24
  156. package/lib/themes/antd.css +553 -12
  157. package/lib/themes/antd.css.map +1 -1
  158. package/lib/themes/cxd-ie11.css +576 -24
  159. package/lib/themes/cxd.css +553 -12
  160. package/lib/themes/cxd.css.map +1 -1
  161. package/lib/themes/dark-ie11.css +576 -24
  162. package/lib/themes/dark.css +553 -12
  163. package/lib/themes/dark.css.map +1 -1
  164. package/lib/themes/default-ie11.css +576 -24
  165. package/lib/themes/default.css +553 -12
  166. package/lib/themes/default.css.map +1 -1
  167. package/lib/utils/api.js +1 -1
  168. package/lib/utils/api.js.map +2 -2
  169. package/lib/utils/renderer-event.js.map +2 -2
  170. package/package.json +2 -1
  171. package/schema.json +542 -4
  172. package/scss/_properties.scss +20 -8
  173. package/scss/components/_input-box.scss +22 -1
  174. package/scss/components/_json-schema.scss +124 -0
  175. package/scss/components/_log.scss +37 -5
  176. package/scss/components/form/_date-range.scss +1 -0
  177. package/scss/components/form/_select.scss +9 -0
  178. package/scss/components/form/_transfer.scss +19 -3
  179. package/scss/components/form/_user-select.scss +422 -0
  180. package/scss/helper/background/_background-color.scss +125 -124
  181. package/scss/themes/_common.scss +2 -0
  182. package/sdk/ang-ie11.css +670 -24
  183. package/sdk/ang.css +647 -12
  184. package/sdk/antd-ie11.css +670 -24
  185. package/sdk/antd.css +647 -12
  186. package/sdk/barcode.js +51 -51
  187. package/sdk/charts.js +14 -14
  188. package/sdk/codemirror.js +7 -7
  189. package/sdk/color-picker.js +65 -65
  190. package/sdk/cropperjs.js +2 -2
  191. package/sdk/cxd-ie11.css +670 -24
  192. package/sdk/cxd.css +647 -12
  193. package/sdk/dark-ie11.css +670 -24
  194. package/sdk/dark.css +647 -12
  195. package/sdk/exceljs.js +1 -1
  196. package/sdk/helper.css +125 -124
  197. package/sdk/helper.css.map +1 -1
  198. package/sdk/locale/de-DE.js +11 -1
  199. package/sdk/markdown.js +69 -69
  200. package/sdk/papaparse.js +1 -1
  201. package/sdk/renderers/Form/CityDB.js +1 -1
  202. package/sdk/rest.js +16 -16
  203. package/sdk/rich-text.js +62 -62
  204. package/sdk/sdk-ie11.css +670 -24
  205. package/sdk/sdk.css +647 -12
  206. package/sdk/sdk.js +1651 -1637
  207. package/sdk/thirds/hls.js/hls.js +1 -1
  208. package/sdk/thirds/mpegts.js/mpegts.js +1 -1
  209. package/sdk/tinymce.js +57 -57
  210. package/src/RootRenderer.tsx +27 -15
  211. package/src/Schema.ts +5 -1
  212. package/src/actions/Action.ts +5 -4
  213. package/src/components/Button.tsx +3 -0
  214. package/src/components/Checkbox.tsx +2 -1
  215. package/src/components/ContextMenu.tsx +25 -7
  216. package/src/components/Form.tsx +70 -0
  217. package/src/components/FormField.tsx +127 -0
  218. package/src/components/InputBox.tsx +4 -1
  219. package/src/components/InputBoxWithSuggestion.tsx +113 -0
  220. package/src/components/PickerContainer.tsx +20 -5
  221. package/src/components/Select.tsx +18 -10
  222. package/src/components/Textarea.tsx +234 -2
  223. package/src/components/Toast.tsx +19 -18
  224. package/src/components/UserSelect.tsx +850 -0
  225. package/src/components/UserTabSelect.tsx +261 -0
  226. package/src/components/WithRemoteConfig.tsx +22 -7
  227. package/src/components/calendar/DaysView.tsx +117 -49
  228. package/src/components/calendar/TimeView.tsx +11 -6
  229. package/src/components/formula/Picker.tsx +2 -1
  230. package/src/components/icons.tsx +17 -1
  231. package/src/components/index.tsx +3 -1
  232. package/src/components/json-schema/Array.tsx +216 -0
  233. package/src/components/json-schema/Item.tsx +47 -0
  234. package/src/components/json-schema/Object.tsx +339 -0
  235. package/src/components/json-schema/index.tsx +44 -0
  236. package/src/components/schema-editor/Array.tsx +3 -1
  237. package/src/components/schema-editor/Common.tsx +61 -4
  238. package/src/components/schema-editor/Object.tsx +3 -1
  239. package/src/components/schema-editor/index.tsx +12 -5
  240. package/src/hooks/use-validation-resolver.ts +45 -0
  241. package/src/icons/department.svg +17 -0
  242. package/src/icons/menu.svg +2 -0
  243. package/src/icons/post.svg +15 -0
  244. package/src/icons/role.svg +14 -0
  245. package/src/icons/user-remove.svg +12 -0
  246. package/src/index.tsx +2 -0
  247. package/src/locale/de-DE.ts +11 -1
  248. package/src/locale/en-US.ts +12 -1
  249. package/src/locale/zh-CN.ts +14 -3
  250. package/src/renderers/Action.tsx +10 -9
  251. package/src/renderers/CRUD.tsx +5 -1
  252. package/src/renderers/Dialog.tsx +9 -3
  253. package/src/renderers/Drawer.tsx +5 -1
  254. package/src/renderers/Form/InputDate.tsx +9 -4
  255. package/src/renderers/Form/InputFile.tsx +5 -15
  256. package/src/renderers/Form/InputText.tsx +1 -1
  257. package/src/renderers/Form/JSONSchema.tsx +56 -0
  258. package/src/renderers/Form/JSONSchemaEditor.tsx +8 -27
  259. package/src/renderers/Form/Textarea.tsx +7 -117
  260. package/src/renderers/Form/UserSelect.tsx +263 -0
  261. package/src/renderers/Form/index.tsx +28 -18
  262. package/src/renderers/Link.tsx +5 -17
  263. package/src/renderers/Log.tsx +213 -19
  264. package/src/renderers/Page.tsx +6 -1
  265. package/src/renderers/Service.tsx +5 -1
  266. package/src/renderers/Wizard.tsx +24 -10
  267. package/src/store/form.ts +24 -17
  268. package/src/utils/api.ts +1 -1
  269. package/src/utils/renderer-event.ts +0 -2
@@ -1,2 +1,234 @@
1
- import Textarea from 'react-textarea-autosize';
2
- export default Textarea;
1
+ import React from 'react';
2
+ import {findDOMNode} from 'react-dom';
3
+ import BaseTextArea from 'react-textarea-autosize';
4
+ import {localeable, LocaleProps} from '../locale';
5
+ import {themeable, ThemeProps} from '../theme';
6
+ import {autobind, ucFirst} from '../utils/helper';
7
+ import {Icon} from './icons';
8
+
9
+ export interface TextAreaProps extends ThemeProps, LocaleProps {
10
+ /**
11
+ * 最大行数
12
+ */
13
+ maxRows?: number;
14
+
15
+ /**
16
+ * 最小行数
17
+ */
18
+ minRows?: number;
19
+
20
+ /**
21
+ * 是否只读
22
+ */
23
+ readOnly?: boolean;
24
+
25
+ /**
26
+ * 边框模式,全边框,还是半边框,或者没边框。
27
+ */
28
+ borderMode?: 'full' | 'half' | 'none';
29
+
30
+ /**
31
+ * 限制文字个数
32
+ */
33
+ maxLength?: number;
34
+
35
+ /**
36
+ * 是否显示计数
37
+ */
38
+ showCounter?: boolean;
39
+
40
+ /**
41
+ * 输入内容是否可清除
42
+ */
43
+ clearable?: boolean;
44
+
45
+ /**
46
+ * 重置值
47
+ */
48
+ resetValue?: string;
49
+
50
+ trimContents?: boolean;
51
+
52
+ value?: any;
53
+ onChange?: (value: any) => void;
54
+
55
+ onFocus?: (e: any) => void;
56
+ onBlur?: (e: any) => void;
57
+
58
+ placeholder?: string;
59
+ name?: string;
60
+ disabled?: boolean;
61
+ }
62
+
63
+ export interface TextAreaState {
64
+ focused: boolean;
65
+ }
66
+
67
+ export class Textarea extends React.Component<TextAreaProps, TextAreaState> {
68
+ static defaultProps = {
69
+ minRows: 3,
70
+ maxRows: 20,
71
+ trimContents: true,
72
+ resetValue: '',
73
+ clearable: false
74
+ };
75
+
76
+ state = {
77
+ focused: false
78
+ };
79
+
80
+ input?: HTMLInputElement;
81
+ inputRef = (ref: any) => (this.input = findDOMNode(ref) as HTMLInputElement);
82
+
83
+ valueToString(value: any) {
84
+ return typeof value === 'undefined' || value === null
85
+ ? ''
86
+ : typeof value === 'string'
87
+ ? value
88
+ : JSON.stringify(value);
89
+ }
90
+
91
+ focus() {
92
+ if (!this.input) {
93
+ return;
94
+ }
95
+
96
+ this.setState(
97
+ {
98
+ focused: true
99
+ },
100
+ () => {
101
+ if (!this.input) {
102
+ return;
103
+ }
104
+
105
+ this.input.focus();
106
+
107
+ // 光标放到最后
108
+ const len = this.input.value.length;
109
+ len && this.input.setSelectionRange(len, len);
110
+ }
111
+ );
112
+ }
113
+
114
+ @autobind
115
+ handleChange(e: React.ChangeEvent<HTMLTextAreaElement>) {
116
+ const {onChange} = this.props;
117
+ let value = e.currentTarget.value;
118
+
119
+ onChange?.(value);
120
+ }
121
+
122
+ @autobind
123
+ handleFocus(e: React.FocusEvent<HTMLTextAreaElement>) {
124
+ const {onFocus} = this.props;
125
+
126
+ this.setState(
127
+ {
128
+ focused: true
129
+ },
130
+ () => {
131
+ onFocus?.(e);
132
+ }
133
+ );
134
+ }
135
+
136
+ @autobind
137
+ handleBlur(e: React.FocusEvent<HTMLTextAreaElement>) {
138
+ const {onBlur, trimContents, value, onChange} = this.props;
139
+
140
+ this.setState(
141
+ {
142
+ focused: false
143
+ },
144
+ () => {
145
+ if (trimContents && value && typeof value === 'string') {
146
+ onChange?.(value.trim());
147
+ }
148
+
149
+ onBlur && onBlur(e);
150
+ }
151
+ );
152
+ }
153
+
154
+ @autobind
155
+ async handleClear() {
156
+ const {onChange, resetValue} = this.props;
157
+
158
+ onChange?.(resetValue);
159
+ this.focus();
160
+ }
161
+
162
+ render() {
163
+ const {
164
+ className,
165
+ classPrefix: ns,
166
+ value,
167
+ placeholder,
168
+ disabled,
169
+ minRows,
170
+ maxRows,
171
+ readOnly,
172
+ name,
173
+ borderMode,
174
+ classnames: cx,
175
+ maxLength,
176
+ showCounter,
177
+ clearable
178
+ } = this.props;
179
+ const counter = showCounter ? this.valueToString(value).length : 0;
180
+
181
+ return (
182
+ <div
183
+ className={cx(
184
+ `TextareaControl`,
185
+ {
186
+ [`TextareaControl--border${ucFirst(borderMode)}`]: borderMode,
187
+ 'is-focused': this.state.focused,
188
+ 'is-disabled': disabled
189
+ },
190
+ className
191
+ )}
192
+ >
193
+ <BaseTextArea
194
+ className={cx(`TextareaControl-input`)}
195
+ autoComplete="off"
196
+ ref={this.inputRef}
197
+ name={name}
198
+ disabled={disabled}
199
+ value={this.valueToString(value)}
200
+ placeholder={placeholder}
201
+ autoCorrect="off"
202
+ spellCheck="false"
203
+ readOnly={readOnly}
204
+ minRows={minRows || undefined}
205
+ maxRows={maxRows || undefined}
206
+ onChange={this.handleChange}
207
+ onFocus={this.handleFocus}
208
+ onBlur={this.handleBlur}
209
+ />
210
+
211
+ {clearable && !disabled && value ? (
212
+ <a onClick={this.handleClear} className={cx('TextareaControl-clear')}>
213
+ <Icon icon="input-clear" className="icon" />
214
+ </a>
215
+ ) : null}
216
+
217
+ {showCounter ? (
218
+ <span
219
+ className={cx('TextareaControl-counter', {
220
+ 'is-empty': counter === 0,
221
+ 'is-clearable': clearable && !disabled && value
222
+ })}
223
+ >
224
+ {`${counter}${
225
+ typeof maxLength === 'number' && maxLength ? `/${maxLength}` : ''
226
+ }`}
227
+ </span>
228
+ ) : null}
229
+ </div>
230
+ );
231
+ }
232
+ }
233
+
234
+ export default themeable(localeable(Textarea));
@@ -13,7 +13,7 @@ import Transition, {
13
13
  import React from 'react';
14
14
  import cx from 'classnames';
15
15
  import Html from './Html';
16
- import {uuid, autobind, noop, isMobile} from '../utils/helper';
16
+ import {guid, autobind, noop, isMobile} from '../utils/helper';
17
17
  import {ClassNamesFn, themeable, classnames, ThemeProps} from '../theme';
18
18
  import {Icon} from './icons';
19
19
  import {LocaleProps, localeable, TranslateFn} from '../locale';
@@ -115,23 +115,25 @@ export class ToastComponent extends React.Component<
115
115
  }
116
116
 
117
117
  notifiy(level: string, content: any, config?: any) {
118
- let items = this.state.items.concat();
119
118
  const useMobileUI = (config.useMobileUI || this.props.useMobileUI) && isMobile();
120
- if (useMobileUI) {
121
- // 移动端只能存在一个
122
- items = [];
123
- }
124
- items.push({
125
- body: content,
126
- level,
127
- ...config,
128
- id: uuid(),
129
- position: config.position || (useMobileUI ? 'center' : config.position),
130
- timeout: config.timeout || (useMobileUI ? 3000 : undefined),
131
- });
132
- this.setState({
133
- items,
134
- useMobileUI
119
+ this.setState((state) => {
120
+ let items = state.items.concat();
121
+ if (useMobileUI) {
122
+ // 移动端只能存在一个
123
+ items = [];
124
+ }
125
+ items.push({
126
+ body: content,
127
+ level,
128
+ ...config,
129
+ id: guid(),
130
+ position: config.position || (useMobileUI ? 'center' : config.position),
131
+ timeout: config.timeout || (useMobileUI ? 3000 : undefined),
132
+ });
133
+ return {
134
+ items,
135
+ useMobileUI
136
+ }
135
137
  });
136
138
  }
137
139
 
@@ -184,7 +186,6 @@ export class ToastComponent extends React.Component<
184
186
  const items = this.state.items;
185
187
  const mobileUI = (useMobileUI || this.state.useMobileUI) && isMobile();
186
188
  const groupedItems = groupBy(items, item => item.position || position);
187
-
188
189
  return Object.keys(groupedItems).map(position => {
189
190
  const toasts = groupedItems[position];
190
191
  return (