@adcops/autocore-react 3.3.8 → 3.3.10

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 (215) hide show
  1. package/LICENSE +58 -58
  2. package/additional-docs/AutoCoreTagContext.md +441 -441
  3. package/additional-docs/ButtonApiSpecs.md +48 -48
  4. package/additional-docs/GlobalEventEmitter.md +243 -243
  5. package/additional-docs/general_recommendations.md +22 -22
  6. package/additional-docs/react_performance_notes.md +94 -94
  7. package/dist/assets/svg/blockly_logo.svg +82 -82
  8. package/dist/assets/svg/distance.svg +40 -40
  9. package/dist/assets/svg/python_logo.svg +246 -246
  10. package/dist/assets/svg/rotation_ccw.svg +50 -50
  11. package/dist/assets/svg/rotation_ccw_a.svg +57 -57
  12. package/dist/assets/svg/rotation_ccw_b.svg +57 -57
  13. package/dist/assets/svg/rotation_ccw_c.svg +57 -57
  14. package/dist/assets/svg/rotation_cw.svg +49 -49
  15. package/dist/assets/svg/rotation_cw_a.svg +30 -30
  16. package/dist/assets/svg/rotation_cw_b.svg +30 -30
  17. package/dist/assets/svg/rotation_cw_c.svg +30 -30
  18. package/dist/assets/svg/speed.svg +39 -39
  19. package/dist/components/BlocklyEditor.css +93 -93
  20. package/dist/components/JogPanel.css +41 -41
  21. package/dist/components/ProgressBarWithValue.css +27 -27
  22. package/dist/components/ValueIndicator.css +31 -31
  23. package/dist/components/osk.css +123 -123
  24. package/dist/core/AutoCoreTagContext.d.ts.map +1 -1
  25. package/dist/core/AutoCoreTagContext.js +1 -1
  26. package/dist/hub/HubBase.d.ts +3 -3
  27. package/dist/hub/HubBase.d.ts.map +1 -1
  28. package/dist/hub/HubBase.js +1 -1
  29. package/package.json +104 -104
  30. package/readme.md +343 -343
  31. package/src/assets/BlocklyLogo.tsx +27 -27
  32. package/src/assets/Distance.tsx +18 -18
  33. package/src/assets/JogLong.tsx +13 -13
  34. package/src/assets/JogMedium.tsx +13 -13
  35. package/src/assets/JogShort.tsx +13 -13
  36. package/src/assets/PythonLogo.tsx +83 -83
  37. package/src/assets/Rotation3D.tsx +13 -13
  38. package/src/assets/RotationCcw.tsx +33 -33
  39. package/src/assets/RotationCcwA.tsx +45 -45
  40. package/src/assets/RotationCcwB.tsx +45 -45
  41. package/src/assets/RotationCcwC.tsx +45 -45
  42. package/src/assets/RotationCw.tsx +31 -31
  43. package/src/assets/RotationCwA.tsx +42 -42
  44. package/src/assets/RotationCwB.tsx +42 -42
  45. package/src/assets/RotationCwC.tsx +42 -42
  46. package/src/assets/Run.tsx +13 -13
  47. package/src/assets/Speed.tsx +18 -18
  48. package/src/assets/SpeedFast.tsx +13 -13
  49. package/src/assets/SpeedMedium.tsx +13 -13
  50. package/src/assets/SpeedNone.tsx +13 -13
  51. package/src/assets/SpeedSlow.tsx +13 -13
  52. package/src/assets/Walk.tsx +13 -13
  53. package/src/assets/index.ts +22 -22
  54. package/src/assets/svg/blockly_logo.svg +82 -82
  55. package/src/assets/svg/distance.svg +40 -40
  56. package/src/assets/svg/python_logo.svg +246 -246
  57. package/src/assets/svg/rotation_ccw.svg +50 -50
  58. package/src/assets/svg/rotation_ccw_a.svg +57 -57
  59. package/src/assets/svg/rotation_ccw_b.svg +57 -57
  60. package/src/assets/svg/rotation_ccw_c.svg +57 -57
  61. package/src/assets/svg/rotation_cw.svg +49 -49
  62. package/src/assets/svg/rotation_cw_a.svg +30 -30
  63. package/src/assets/svg/rotation_cw_b.svg +30 -30
  64. package/src/assets/svg/rotation_cw_c.svg +30 -30
  65. package/src/assets/svg/speed.svg +39 -39
  66. package/src/components/AutoCoreDevPanel.tsx +414 -414
  67. package/src/components/BlocklyEditor.css +93 -93
  68. package/src/components/BlocklyEditor.tsx +609 -609
  69. package/src/components/CodeEditor.tsx +155 -155
  70. package/src/components/FileList.tsx +390 -390
  71. package/src/components/FileSelect.tsx +128 -128
  72. package/src/components/FitText.tsx +35 -35
  73. package/src/components/Indicator.tsx +188 -188
  74. package/src/components/IndicatorButton.tsx +214 -214
  75. package/src/components/IndicatorRect.tsx +172 -172
  76. package/src/components/JogPanel.css +41 -41
  77. package/src/components/JogPanel.tsx +461 -461
  78. package/src/components/Lamp.tsx +243 -243
  79. package/src/components/Osk.tsx +192 -192
  80. package/src/components/OskDialog.tsx +164 -164
  81. package/src/components/ProgressBarWithValue.css +27 -27
  82. package/src/components/ProgressBarWithValue.tsx +48 -48
  83. package/src/components/TextInput.tsx +195 -195
  84. package/src/components/ToggleGroup.tsx +322 -322
  85. package/src/components/ValueDisplay.tsx +236 -236
  86. package/src/components/ValueIndicator.css +31 -31
  87. package/src/components/ValueIndicator.tsx +135 -135
  88. package/src/components/ValueInput.tsx +368 -368
  89. package/src/components/osk.css +123 -123
  90. package/src/core/ActionMode.ts +19 -19
  91. package/src/core/AutoCoreTagContext.tsx +625 -614
  92. package/src/core/AutoCoreTagTypes.ts +334 -334
  93. package/src/core/CoreStreamTypes.ts +512 -512
  94. package/src/core/EventEmitterContext.tsx +434 -434
  95. package/src/core/IndicatorButtonState.ts +34 -34
  96. package/src/core/IndicatorColor.ts +35 -35
  97. package/src/core/MaskPatterns.ts +87 -87
  98. package/src/core/NumerableTypes.ts +80 -80
  99. package/src/core/PositionContext.ts +59 -59
  100. package/src/core/UniqueId.ts +41 -41
  101. package/src/core/ValueSimulator.ts +166 -166
  102. package/src/core/hoc.tsx +65 -65
  103. package/src/hooks/adsHooks.tsx +287 -287
  104. package/src/hooks/commandHooks.tsx +300 -300
  105. package/src/hooks/index.ts +12 -12
  106. package/src/hooks/useAutoCoreTag.ts +103 -103
  107. package/src/hooks/useScaledValue.tsx +99 -99
  108. package/src/hub/CommandMessage.ts +89 -89
  109. package/src/hub/DebugPanel.ts +307 -307
  110. package/src/hub/HubBase.ts +249 -236
  111. package/src/hub/HubSimulate.ts +124 -124
  112. package/src/hub/HubTauri.ts +140 -140
  113. package/src/hub/HubWebSocket.ts +250 -250
  114. package/src/hub/debug.ts +211 -211
  115. package/src/hub/index.ts +81 -81
  116. package/src/themes/adc-dark/_extensions.scss +166 -166
  117. package/src/themes/adc-dark/_variables.scss +913 -913
  118. package/src/themes/adc-dark/blue/_fonts.scss +23 -23
  119. package/src/themes/adc-dark/blue/adc_theme.scss +31 -31
  120. package/src/themes/adc-dark/blue/theme.scss +14 -14
  121. package/src/themes/theme-base/_colors.scss +17 -17
  122. package/src/themes/theme-base/_common.scss +74 -74
  123. package/src/themes/theme-base/_components.scss +111 -111
  124. package/src/themes/theme-base/_mixins.scss +243 -243
  125. package/src/themes/theme-base/components/button/_button.scss +644 -644
  126. package/src/themes/theme-base/components/button/_speeddial.scss +91 -91
  127. package/src/themes/theme-base/components/button/_splitbutton.scss +358 -358
  128. package/src/themes/theme-base/components/data/_carousel.scss +39 -39
  129. package/src/themes/theme-base/components/data/_datascroller.scss +47 -47
  130. package/src/themes/theme-base/components/data/_datatable.scss +388 -388
  131. package/src/themes/theme-base/components/data/_dataview.scss +47 -47
  132. package/src/themes/theme-base/components/data/_filter.scss +137 -137
  133. package/src/themes/theme-base/components/data/_orderlist.scss +86 -86
  134. package/src/themes/theme-base/components/data/_organizationchart.scss +50 -50
  135. package/src/themes/theme-base/components/data/_paginator.scss +91 -91
  136. package/src/themes/theme-base/components/data/_picklist.scss +73 -73
  137. package/src/themes/theme-base/components/data/_timeline.scss +38 -38
  138. package/src/themes/theme-base/components/data/_tree.scss +184 -184
  139. package/src/themes/theme-base/components/data/_treetable.scss +431 -431
  140. package/src/themes/theme-base/components/file/_fileupload.scss +41 -41
  141. package/src/themes/theme-base/components/input/_autocomplete.scss +94 -94
  142. package/src/themes/theme-base/components/input/_calendar.scss +251 -251
  143. package/src/themes/theme-base/components/input/_cascadeselect.scss +107 -107
  144. package/src/themes/theme-base/components/input/_checkbox.scss +181 -181
  145. package/src/themes/theme-base/components/input/_chips.scss +102 -102
  146. package/src/themes/theme-base/components/input/_colorpicker.scss +17 -17
  147. package/src/themes/theme-base/components/input/_dropdown.scss +252 -252
  148. package/src/themes/theme-base/components/input/_editor.scss +122 -122
  149. package/src/themes/theme-base/components/input/_iconfield.scss +9 -9
  150. package/src/themes/theme-base/components/input/_inputgroup.scss +74 -74
  151. package/src/themes/theme-base/components/input/_inputicon.scss +14 -14
  152. package/src/themes/theme-base/components/input/_inputnumber.scss +4 -4
  153. package/src/themes/theme-base/components/input/_inputotp.scss +10 -10
  154. package/src/themes/theme-base/components/input/_inputswitch.scss +99 -99
  155. package/src/themes/theme-base/components/input/_inputtext.scss +101 -101
  156. package/src/themes/theme-base/components/input/_listbox.scss +138 -138
  157. package/src/themes/theme-base/components/input/_mention.scss +30 -30
  158. package/src/themes/theme-base/components/input/_multiselect.scss +278 -278
  159. package/src/themes/theme-base/components/input/_password.scss +32 -32
  160. package/src/themes/theme-base/components/input/_radiobutton.scss +169 -169
  161. package/src/themes/theme-base/components/input/_rating.scss +80 -80
  162. package/src/themes/theme-base/components/input/_selectbutton.scss +49 -49
  163. package/src/themes/theme-base/components/input/_slider.scss +49 -49
  164. package/src/themes/theme-base/components/input/_togglebutton.scss +99 -99
  165. package/src/themes/theme-base/components/input/_treeselect.scss +151 -151
  166. package/src/themes/theme-base/components/input/_tristatecheckbox.scss +46 -46
  167. package/src/themes/theme-base/components/menu/_breadcrumb.scss +42 -42
  168. package/src/themes/theme-base/components/menu/_contextmenu.scss +39 -39
  169. package/src/themes/theme-base/components/menu/_dock.scss +109 -109
  170. package/src/themes/theme-base/components/menu/_megamenu.scss +141 -141
  171. package/src/themes/theme-base/components/menu/_menu.scss +33 -33
  172. package/src/themes/theme-base/components/menu/_menubar.scss +216 -216
  173. package/src/themes/theme-base/components/menu/_panelmenu.scss +153 -153
  174. package/src/themes/theme-base/components/menu/_slidemenu.scss +60 -60
  175. package/src/themes/theme-base/components/menu/_steps.scss +57 -57
  176. package/src/themes/theme-base/components/menu/_tabmenu.scss +50 -50
  177. package/src/themes/theme-base/components/menu/_tieredmenu.scss +43 -43
  178. package/src/themes/theme-base/components/messages/_inlinemessage.scss +69 -69
  179. package/src/themes/theme-base/components/messages/_message.scss +107 -107
  180. package/src/themes/theme-base/components/messages/_toast.scss +100 -100
  181. package/src/themes/theme-base/components/misc/_avatar.scss +33 -33
  182. package/src/themes/theme-base/components/misc/_badge.scss +76 -76
  183. package/src/themes/theme-base/components/misc/_chip.scss +38 -38
  184. package/src/themes/theme-base/components/misc/_inplace.scss +17 -17
  185. package/src/themes/theme-base/components/misc/_metergroup.scss +80 -80
  186. package/src/themes/theme-base/components/misc/_progressbar.scss +17 -17
  187. package/src/themes/theme-base/components/misc/_scrolltop.scss +24 -24
  188. package/src/themes/theme-base/components/misc/_skeleton.scss +7 -7
  189. package/src/themes/theme-base/components/misc/_tag.scss +39 -39
  190. package/src/themes/theme-base/components/misc/_terminal.scss +12 -12
  191. package/src/themes/theme-base/components/multimedia/_galleria.scss +153 -153
  192. package/src/themes/theme-base/components/multimedia/_image.scss +53 -53
  193. package/src/themes/theme-base/components/overlay/_confirmpopup.scss +72 -72
  194. package/src/themes/theme-base/components/overlay/_dialog.scss +78 -78
  195. package/src/themes/theme-base/components/overlay/_overlaypanel.scss +64 -64
  196. package/src/themes/theme-base/components/overlay/_sidebar.scss +23 -23
  197. package/src/themes/theme-base/components/overlay/_tooltip.scss +33 -33
  198. package/src/themes/theme-base/components/panel/_accordion.scss +118 -118
  199. package/src/themes/theme-base/components/panel/_card.scss +30 -30
  200. package/src/themes/theme-base/components/panel/_divider.scss +30 -30
  201. package/src/themes/theme-base/components/panel/_fieldset.scss +47 -47
  202. package/src/themes/theme-base/components/panel/_panel.scss +47 -47
  203. package/src/themes/theme-base/components/panel/_scrollpanel.scss +10 -10
  204. package/src/themes/theme-base/components/panel/_splitter.scss +23 -23
  205. package/src/themes/theme-base/components/panel/_stepper.scss +136 -136
  206. package/src/themes/theme-base/components/panel/_tabview.scss +147 -147
  207. package/src/themes/theme-base/components/panel/_toolbar.scss +11 -11
  208. package/terser.config.cjs +25 -25
  209. package/todo.md +18 -18
  210. package/tools/build-themes.cjs +65 -65
  211. package/tools/copy-distribution-files.cjs +77 -77
  212. package/tools/minify.cjs +55 -55
  213. package/tsconfig.json +48 -48
  214. package/typedoc.json +12 -12
  215. package/.claude/settings.local.json +0 -7
@@ -1,322 +1,322 @@
1
- /*
2
- * Copyright (C) 2024 Automated Design Corp.. All Rights Reserved.
3
- * Created Date: 2024-03-12 10:14:48
4
- * -----
5
- * Last Modified: 2025-09-05 14:51:30
6
- * -----
7
- *
8
- */
9
-
10
- import React, { useState, useEffect, useContext } from 'react';
11
- import { SelectButton, type SelectButtonProps } from 'primereact/selectbutton';
12
- import type {SelectItemOptionsType} from "primereact/selectitem";
13
-
14
- import { EventEmitterContext} from '../core/EventEmitterContext';
15
- import {IndicatorColor} from "../core/IndicatorColor";
16
- export {IndicatorColor}
17
- import { ActionMode } from '../core/ActionMode';
18
- export {ActionMode};
19
-
20
- import clsx from 'clsx';
21
-
22
-
23
-
24
- export interface ToggleGroupProps extends SelectButtonProps {
25
- label?: React.ReactNode;
26
- topic?: string;
27
- onColor?: IndicatorColor | IndicatorColor[];
28
- offColor?: IndicatorColor;
29
- command?: string;
30
- commandTopic?: string;
31
- commandArgs?: any;
32
- disableTopic?: string;
33
- invisibleTopic?: string;
34
- actionMode?: ActionMode;
35
- invert?: boolean;
36
- onValueChanged? : (value: boolean | number) => void;
37
- }
38
-
39
- export const ToggleGroup: React.FC<ToggleGroupProps> = ({
40
- label,
41
- topic,
42
- onColor,
43
- offColor,
44
- command,
45
- commandTopic,
46
- commandArgs,
47
- disableTopic,
48
- invisibleTopic,
49
- actionMode,
50
- invert,
51
- onValueChanged: onValueChange,
52
- ...restProps
53
- }) => {
54
-
55
- const [uniqueId] = useState(() => `toggleGroup-${Math.random().toString(36).substr(2, 9)}`);
56
-
57
- const [currentValue, setCurrentValue] = useState<any>(undefined);
58
- const [isDisabled, setIsDisabled] = useState<boolean>(false);
59
- const [isInvisible, setIsInvisible] = useState<boolean>(false);
60
- const [isPressed, setIsPressed] = useState<boolean>(false);
61
- const context = useContext(EventEmitterContext);
62
-
63
- useEffect(() => {
64
- const setupSubscriptions = () => {
65
- if (topic) {
66
- context.subscribe(topic, handleTopicUpdate);
67
- }
68
- if (disableTopic) {
69
- context.subscribe(disableTopic, handleDisableTopicUpdate);
70
- }
71
- if (invisibleTopic) {
72
- context.subscribe(invisibleTopic, handleInvisibleTopicUpdate);
73
- }
74
- };
75
-
76
- setupSubscriptions();
77
-
78
- return () => {
79
- // Unsubscribe logic here
80
- };
81
- }, [topic, disableTopic, invisibleTopic]);
82
-
83
- const handleTopicUpdate = (value: boolean) => {
84
- setCurrentValue(value);
85
- };
86
-
87
- const handleDisableTopicUpdate = (value: boolean) => {
88
- setIsDisabled(value);
89
- };
90
-
91
- const handleInvisibleTopicUpdate = (value: boolean) => {
92
- setIsInvisible(value);
93
- };
94
-
95
- const handleOnPressed = () => {
96
- if (!isPressed) {
97
- setIsPressed(true);
98
- if (actionMode === ActionMode.Tap || actionMode === ActionMode.Pressed) {
99
- dispatchCommand(true);
100
- }
101
- }
102
- };
103
-
104
- const handleOnReleased = () => {
105
- if (isPressed) {
106
- setIsPressed(false);
107
- if (actionMode === ActionMode.Tap) {
108
- dispatchCommand(false);
109
- } else if (actionMode === ActionMode.Released) {
110
- dispatchCommand(true);
111
- }
112
- }
113
- };
114
-
115
- const dispatchCommand = (value: any) => {
116
- if (command && command.length > 0) {
117
- const payload = {
118
- topic: commandTopic,
119
- value: value,
120
- ...commandArgs
121
- };
122
-
123
- context.dispatch({
124
- topic: command,
125
- payload: payload
126
- });
127
- }
128
- };
129
-
130
-
131
- let displayValue = currentValue;
132
- if (restProps.value !== undefined) {
133
- displayValue = restProps.value;
134
- }
135
-
136
-
137
- /**
138
- *
139
- * @param currentValue
140
- * @param options
141
- * @returns
142
- */
143
-
144
- const selectOnColor = (
145
- currentValue: any,
146
- options: SelectItemOptionsType | undefined,
147
- onColorProp: IndicatorColor | IndicatorColor[] | undefined
148
- ): IndicatorColor => {
149
-
150
- if (!options || options.length === 0)
151
- return IndicatorColor.IndicatorInvalid;
152
-
153
- let colorArray =
154
- Array.isArray(onColorProp) ? onColorProp :
155
- onColorProp !== undefined ? [onColorProp] : [IndicatorColor.IndicatorInvalid];
156
-
157
- let t = typeof (currentValue);
158
- if (t === "boolean") {
159
- return currentValue ? colorArray[0] : colorArray.length > 1 ? colorArray[1] : colorArray[0];
160
- }
161
- else if (t === "number" && options.length > currentValue) {
162
- if (colorArray.length > currentValue) {
163
- let index = currentValue as number;
164
- return colorArray[index];
165
- }
166
- else {
167
- return colorArray[0];
168
- }
169
- }
170
- else if (t === "string") {
171
- let index = options.indexOf(currentValue);
172
- if (index !== -1 && index < colorArray.length)
173
- return colorArray[index];
174
- else
175
- return colorArray[0];
176
- }
177
-
178
- if (onColorProp !== undefined && onColorProp !== null) {
179
- return Array.isArray(onColorProp) ? onColorProp[0] : onColorProp as IndicatorColor;
180
- }
181
- else {
182
- return IndicatorColor.IndicatorInvalid;
183
- }
184
-
185
- }
186
-
187
-
188
- /**
189
- *
190
- * @param currentValue
191
- * @param options
192
- * @returns
193
- */
194
- const matchCurrentValue = (currentValue: any, options: SelectItemOptionsType | undefined): any => {
195
-
196
- if (options === undefined || options === null || options.length === 0)
197
- return undefined;
198
-
199
- let t = typeof (currentValue);
200
- if (t == "boolean") {
201
- let b = currentValue as boolean;
202
- if (b) {
203
- if (options.length > 1)
204
- return options[1];
205
- else
206
- return options[0];
207
- }
208
- else {
209
- return options[0];
210
- }
211
- }
212
- else if (t == "number") {
213
- let n = currentValue as number;
214
- if (n !== undefined && n < options.length) {
215
- return options[n];
216
- }
217
- }
218
- else if (t == "string") {
219
- // The SelectButton should match to this value automatically, if it's in the
220
- // options array. No reason to search twice.
221
- return currentValue;
222
- }
223
-
224
-
225
- return undefined;
226
- }
227
-
228
-
229
- let color = selectOnColor(displayValue, restProps.options, onColor);
230
-
231
- if (displayValue === undefined) {
232
- color = IndicatorColor.IndicatorInvalid;
233
- }
234
-
235
- const isMultiple = restProps.options !== undefined
236
- && restProps.options !== null
237
- && restProps.options.length !== undefined
238
- && restProps.options.length > 2
239
- ;
240
-
241
-
242
- const toggleGroupName = `${uniqueId}-togglegroup-selectbutton-container`;
243
-
244
-
245
- const handleValueChange = (label : string) => {
246
-
247
- if (onValueChange !== undefined && onValueChange !== null) {
248
-
249
-
250
- if (restProps.options === undefined || restProps.options === null || restProps.options.length === 0) {
251
- if (isMultiple)
252
- onValueChange(0);
253
- else
254
- onValueChange(false);
255
- }
256
- else {
257
- let index = 0;
258
- for (let i=0;i<restProps.options.length;++i) {
259
- if (label === restProps.options[i] ) {
260
- index = i;
261
- break;
262
- }
263
- }
264
-
265
- if (isMultiple)
266
- onValueChange(index);
267
- else
268
- onValueChange(index > 0);
269
-
270
- }
271
-
272
-
273
- }
274
-
275
-
276
- }
277
-
278
- return (
279
- <div className="flex">
280
- {
281
- <style>{`
282
- ${offColor !== undefined ? `
283
- .${toggleGroupName} .p-selectbutton .p-button {
284
- background-color: ${offColor};
285
- }
286
- ` : ''}
287
- .${toggleGroupName} .p-selectbutton .p-button.p-highlight {
288
- background-color: ${color} !important;
289
- border-color: ${color} !important;
290
- }
291
- `}
292
- </style>
293
- }
294
-
295
- <div className={toggleGroupName}>
296
-
297
- <div className="p-inputgroup">
298
-
299
- <span className="p-inputgroup-addon" style={{ flexGrow: 1 }}>
300
- {label}
301
- </span>
302
- <SelectButton {...restProps}
303
- options={restProps.options}
304
- disabled={isDisabled || restProps.disabled}
305
- multiple={isMultiple}
306
- className={clsx(uniqueId, restProps.className, { 'p-invalid': restProps.value === undefined })}
307
- style={isInvisible ? { display: 'none' } : {}}
308
- value={matchCurrentValue(displayValue, restProps.options)}
309
- allowEmpty={false}
310
- onMouseDown={handleOnPressed}
311
- onTouchStart={handleOnPressed}
312
- onMouseUp={handleOnReleased}
313
- onTouchEnd={handleOnReleased}
314
- onChange={(e) => handleValueChange(e.value)}
315
- />
316
- </div>
317
- </div>
318
- </div>
319
- );
320
- };
321
-
322
- export default ToggleGroup;
1
+ /*
2
+ * Copyright (C) 2024 Automated Design Corp.. All Rights Reserved.
3
+ * Created Date: 2024-03-12 10:14:48
4
+ * -----
5
+ * Last Modified: 2025-09-05 14:51:30
6
+ * -----
7
+ *
8
+ */
9
+
10
+ import React, { useState, useEffect, useContext } from 'react';
11
+ import { SelectButton, type SelectButtonProps } from 'primereact/selectbutton';
12
+ import type {SelectItemOptionsType} from "primereact/selectitem";
13
+
14
+ import { EventEmitterContext} from '../core/EventEmitterContext';
15
+ import {IndicatorColor} from "../core/IndicatorColor";
16
+ export {IndicatorColor}
17
+ import { ActionMode } from '../core/ActionMode';
18
+ export {ActionMode};
19
+
20
+ import clsx from 'clsx';
21
+
22
+
23
+
24
+ export interface ToggleGroupProps extends SelectButtonProps {
25
+ label?: React.ReactNode;
26
+ topic?: string;
27
+ onColor?: IndicatorColor | IndicatorColor[];
28
+ offColor?: IndicatorColor;
29
+ command?: string;
30
+ commandTopic?: string;
31
+ commandArgs?: any;
32
+ disableTopic?: string;
33
+ invisibleTopic?: string;
34
+ actionMode?: ActionMode;
35
+ invert?: boolean;
36
+ onValueChanged? : (value: boolean | number) => void;
37
+ }
38
+
39
+ export const ToggleGroup: React.FC<ToggleGroupProps> = ({
40
+ label,
41
+ topic,
42
+ onColor,
43
+ offColor,
44
+ command,
45
+ commandTopic,
46
+ commandArgs,
47
+ disableTopic,
48
+ invisibleTopic,
49
+ actionMode,
50
+ invert,
51
+ onValueChanged: onValueChange,
52
+ ...restProps
53
+ }) => {
54
+
55
+ const [uniqueId] = useState(() => `toggleGroup-${Math.random().toString(36).substr(2, 9)}`);
56
+
57
+ const [currentValue, setCurrentValue] = useState<any>(undefined);
58
+ const [isDisabled, setIsDisabled] = useState<boolean>(false);
59
+ const [isInvisible, setIsInvisible] = useState<boolean>(false);
60
+ const [isPressed, setIsPressed] = useState<boolean>(false);
61
+ const context = useContext(EventEmitterContext);
62
+
63
+ useEffect(() => {
64
+ const setupSubscriptions = () => {
65
+ if (topic) {
66
+ context.subscribe(topic, handleTopicUpdate);
67
+ }
68
+ if (disableTopic) {
69
+ context.subscribe(disableTopic, handleDisableTopicUpdate);
70
+ }
71
+ if (invisibleTopic) {
72
+ context.subscribe(invisibleTopic, handleInvisibleTopicUpdate);
73
+ }
74
+ };
75
+
76
+ setupSubscriptions();
77
+
78
+ return () => {
79
+ // Unsubscribe logic here
80
+ };
81
+ }, [topic, disableTopic, invisibleTopic]);
82
+
83
+ const handleTopicUpdate = (value: boolean) => {
84
+ setCurrentValue(value);
85
+ };
86
+
87
+ const handleDisableTopicUpdate = (value: boolean) => {
88
+ setIsDisabled(value);
89
+ };
90
+
91
+ const handleInvisibleTopicUpdate = (value: boolean) => {
92
+ setIsInvisible(value);
93
+ };
94
+
95
+ const handleOnPressed = () => {
96
+ if (!isPressed) {
97
+ setIsPressed(true);
98
+ if (actionMode === ActionMode.Tap || actionMode === ActionMode.Pressed) {
99
+ dispatchCommand(true);
100
+ }
101
+ }
102
+ };
103
+
104
+ const handleOnReleased = () => {
105
+ if (isPressed) {
106
+ setIsPressed(false);
107
+ if (actionMode === ActionMode.Tap) {
108
+ dispatchCommand(false);
109
+ } else if (actionMode === ActionMode.Released) {
110
+ dispatchCommand(true);
111
+ }
112
+ }
113
+ };
114
+
115
+ const dispatchCommand = (value: any) => {
116
+ if (command && command.length > 0) {
117
+ const payload = {
118
+ topic: commandTopic,
119
+ value: value,
120
+ ...commandArgs
121
+ };
122
+
123
+ context.dispatch({
124
+ topic: command,
125
+ payload: payload
126
+ });
127
+ }
128
+ };
129
+
130
+
131
+ let displayValue = currentValue;
132
+ if (restProps.value !== undefined) {
133
+ displayValue = restProps.value;
134
+ }
135
+
136
+
137
+ /**
138
+ *
139
+ * @param currentValue
140
+ * @param options
141
+ * @returns
142
+ */
143
+
144
+ const selectOnColor = (
145
+ currentValue: any,
146
+ options: SelectItemOptionsType | undefined,
147
+ onColorProp: IndicatorColor | IndicatorColor[] | undefined
148
+ ): IndicatorColor => {
149
+
150
+ if (!options || options.length === 0)
151
+ return IndicatorColor.IndicatorInvalid;
152
+
153
+ let colorArray =
154
+ Array.isArray(onColorProp) ? onColorProp :
155
+ onColorProp !== undefined ? [onColorProp] : [IndicatorColor.IndicatorInvalid];
156
+
157
+ let t = typeof (currentValue);
158
+ if (t === "boolean") {
159
+ return currentValue ? colorArray[0] : colorArray.length > 1 ? colorArray[1] : colorArray[0];
160
+ }
161
+ else if (t === "number" && options.length > currentValue) {
162
+ if (colorArray.length > currentValue) {
163
+ let index = currentValue as number;
164
+ return colorArray[index];
165
+ }
166
+ else {
167
+ return colorArray[0];
168
+ }
169
+ }
170
+ else if (t === "string") {
171
+ let index = options.indexOf(currentValue);
172
+ if (index !== -1 && index < colorArray.length)
173
+ return colorArray[index];
174
+ else
175
+ return colorArray[0];
176
+ }
177
+
178
+ if (onColorProp !== undefined && onColorProp !== null) {
179
+ return Array.isArray(onColorProp) ? onColorProp[0] : onColorProp as IndicatorColor;
180
+ }
181
+ else {
182
+ return IndicatorColor.IndicatorInvalid;
183
+ }
184
+
185
+ }
186
+
187
+
188
+ /**
189
+ *
190
+ * @param currentValue
191
+ * @param options
192
+ * @returns
193
+ */
194
+ const matchCurrentValue = (currentValue: any, options: SelectItemOptionsType | undefined): any => {
195
+
196
+ if (options === undefined || options === null || options.length === 0)
197
+ return undefined;
198
+
199
+ let t = typeof (currentValue);
200
+ if (t == "boolean") {
201
+ let b = currentValue as boolean;
202
+ if (b) {
203
+ if (options.length > 1)
204
+ return options[1];
205
+ else
206
+ return options[0];
207
+ }
208
+ else {
209
+ return options[0];
210
+ }
211
+ }
212
+ else if (t == "number") {
213
+ let n = currentValue as number;
214
+ if (n !== undefined && n < options.length) {
215
+ return options[n];
216
+ }
217
+ }
218
+ else if (t == "string") {
219
+ // The SelectButton should match to this value automatically, if it's in the
220
+ // options array. No reason to search twice.
221
+ return currentValue;
222
+ }
223
+
224
+
225
+ return undefined;
226
+ }
227
+
228
+
229
+ let color = selectOnColor(displayValue, restProps.options, onColor);
230
+
231
+ if (displayValue === undefined) {
232
+ color = IndicatorColor.IndicatorInvalid;
233
+ }
234
+
235
+ const isMultiple = restProps.options !== undefined
236
+ && restProps.options !== null
237
+ && restProps.options.length !== undefined
238
+ && restProps.options.length > 2
239
+ ;
240
+
241
+
242
+ const toggleGroupName = `${uniqueId}-togglegroup-selectbutton-container`;
243
+
244
+
245
+ const handleValueChange = (label : string) => {
246
+
247
+ if (onValueChange !== undefined && onValueChange !== null) {
248
+
249
+
250
+ if (restProps.options === undefined || restProps.options === null || restProps.options.length === 0) {
251
+ if (isMultiple)
252
+ onValueChange(0);
253
+ else
254
+ onValueChange(false);
255
+ }
256
+ else {
257
+ let index = 0;
258
+ for (let i=0;i<restProps.options.length;++i) {
259
+ if (label === restProps.options[i] ) {
260
+ index = i;
261
+ break;
262
+ }
263
+ }
264
+
265
+ if (isMultiple)
266
+ onValueChange(index);
267
+ else
268
+ onValueChange(index > 0);
269
+
270
+ }
271
+
272
+
273
+ }
274
+
275
+
276
+ }
277
+
278
+ return (
279
+ <div className="flex">
280
+ {
281
+ <style>{`
282
+ ${offColor !== undefined ? `
283
+ .${toggleGroupName} .p-selectbutton .p-button {
284
+ background-color: ${offColor};
285
+ }
286
+ ` : ''}
287
+ .${toggleGroupName} .p-selectbutton .p-button.p-highlight {
288
+ background-color: ${color} !important;
289
+ border-color: ${color} !important;
290
+ }
291
+ `}
292
+ </style>
293
+ }
294
+
295
+ <div className={toggleGroupName}>
296
+
297
+ <div className="p-inputgroup">
298
+
299
+ <span className="p-inputgroup-addon" style={{ flexGrow: 1 }}>
300
+ {label}
301
+ </span>
302
+ <SelectButton {...restProps}
303
+ options={restProps.options}
304
+ disabled={isDisabled || restProps.disabled}
305
+ multiple={isMultiple}
306
+ className={clsx(uniqueId, restProps.className, { 'p-invalid': restProps.value === undefined })}
307
+ style={isInvisible ? { display: 'none' } : {}}
308
+ value={matchCurrentValue(displayValue, restProps.options)}
309
+ allowEmpty={false}
310
+ onMouseDown={handleOnPressed}
311
+ onTouchStart={handleOnPressed}
312
+ onMouseUp={handleOnReleased}
313
+ onTouchEnd={handleOnReleased}
314
+ onChange={(e) => handleValueChange(e.value)}
315
+ />
316
+ </div>
317
+ </div>
318
+ </div>
319
+ );
320
+ };
321
+
322
+ export default ToggleGroup;