@pega/sdk 0.0.3 → 0.0.4

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 (346) hide show
  1. package/LICENSE +183 -183
  2. package/README.md +6 -6
  3. package/SECURITY.md +2 -1
  4. package/dist/index.js +12 -55
  5. package/package.json +7 -6
  6. package/templates/angular-sdk-reference/package.json +15 -15
  7. package/templates/angular-sdk-reference/tsconfig.json +2 -2
  8. package/templates/react-native-sdk-reference/App.tsx +2 -4
  9. package/templates/react-native-sdk-reference/package.json +6 -6
  10. package/templates/react-native-sdk-reference/tsconfig.json +2 -1
  11. package/templates/react-sdk-reference/.claude/instructions/component-map.md +1 -1
  12. package/templates/react-sdk-reference/.claude/instructions/field-component.md +4 -0
  13. package/templates/react-sdk-reference/.claude/instructions/template-component.md +2 -1
  14. package/templates/react-sdk-reference/.claude/instructions/widget-component.md +1 -0
  15. package/templates/react-sdk-reference/.claude/prompts/add-component.md +18 -10
  16. package/templates/react-sdk-reference/.claude/prompts/component-manifest.json +165 -83
  17. package/templates/react-sdk-reference/.claude/prompts/generate-all-components.md +26 -17
  18. package/templates/react-sdk-reference/.claude/prompts/generate-dse-components.md +27 -13
  19. package/templates/react-sdk-reference/.claude/prompts/generate-field-components.md +42 -28
  20. package/templates/react-sdk-reference/.claude/prompts/generate-template-components.md +48 -34
  21. package/templates/react-sdk-reference/.claude/prompts/generate-widget-components.md +25 -11
  22. package/templates/react-sdk-reference/.claude/prompts/identify-components.md +65 -65
  23. package/templates/react-sdk-reference/.claude/skills/component-contracts.md +99 -99
  24. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/AlertBanner.md +40 -38
  25. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/Banner.md +54 -51
  26. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/CaseSummaryFields.md +51 -46
  27. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/DetailsFields.md +32 -28
  28. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/FieldGroup.md +38 -35
  29. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/FieldGroupList.md +25 -23
  30. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/FieldValueList.md +29 -26
  31. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/Operator.md +32 -26
  32. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/Pulse.md +17 -15
  33. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/RichTextEditor.md +85 -59
  34. package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/WssQuickCreate.md +49 -47
  35. package/templates/react-sdk-reference/.claude/skills/design-system-extension.md +13 -11
  36. package/templates/react-sdk-reference/.claude/skills/field-components.md +9 -8
  37. package/templates/react-sdk-reference/.claude/skills/field-skills/AutoComplete.md +27 -26
  38. package/templates/react-sdk-reference/.claude/skills/field-skills/CancelAlert.md +30 -22
  39. package/templates/react-sdk-reference/.claude/skills/field-skills/Checkbox.md +60 -43
  40. package/templates/react-sdk-reference/.claude/skills/field-skills/Currency.md +23 -20
  41. package/templates/react-sdk-reference/.claude/skills/field-skills/Date.md +19 -17
  42. package/templates/react-sdk-reference/.claude/skills/field-skills/DateTime.md +18 -15
  43. package/templates/react-sdk-reference/.claude/skills/field-skills/Decimal.md +22 -21
  44. package/templates/react-sdk-reference/.claude/skills/field-skills/Dropdown.md +50 -30
  45. package/templates/react-sdk-reference/.claude/skills/field-skills/Email.md +20 -18
  46. package/templates/react-sdk-reference/.claude/skills/field-skills/Group.md +21 -15
  47. package/templates/react-sdk-reference/.claude/skills/field-skills/Integer.md +17 -16
  48. package/templates/react-sdk-reference/.claude/skills/field-skills/Location.md +30 -21
  49. package/templates/react-sdk-reference/.claude/skills/field-skills/Multiselect.md +66 -42
  50. package/templates/react-sdk-reference/.claude/skills/field-skills/ObjectReference.md +27 -18
  51. package/templates/react-sdk-reference/.claude/skills/field-skills/Percentage.md +22 -21
  52. package/templates/react-sdk-reference/.claude/skills/field-skills/Phone.md +36 -17
  53. package/templates/react-sdk-reference/.claude/skills/field-skills/RadioButtons.md +56 -35
  54. package/templates/react-sdk-reference/.claude/skills/field-skills/RichText.md +23 -12
  55. package/templates/react-sdk-reference/.claude/skills/field-skills/ScalarList.md +41 -31
  56. package/templates/react-sdk-reference/.claude/skills/field-skills/SelectableCard.md +70 -55
  57. package/templates/react-sdk-reference/.claude/skills/field-skills/SemanticLink.md +34 -27
  58. package/templates/react-sdk-reference/.claude/skills/field-skills/TextArea.md +24 -22
  59. package/templates/react-sdk-reference/.claude/skills/field-skills/TextContent.md +38 -22
  60. package/templates/react-sdk-reference/.claude/skills/field-skills/TextInput.md +24 -21
  61. package/templates/react-sdk-reference/.claude/skills/field-skills/Time.md +16 -15
  62. package/templates/react-sdk-reference/.claude/skills/field-skills/URL.md +16 -15
  63. package/templates/react-sdk-reference/.claude/skills/field-skills/UserReference.md +57 -34
  64. package/templates/react-sdk-reference/.claude/skills/run-and-verify.md +10 -8
  65. package/templates/react-sdk-reference/.claude/skills/template-components.md +7 -8
  66. package/templates/react-sdk-reference/.claude/skills/template-skills/AdvancedSearch.md +27 -21
  67. package/templates/react-sdk-reference/.claude/skills/template-skills/AppShell.md +17 -15
  68. package/templates/react-sdk-reference/.claude/skills/template-skills/BannerPage.md +19 -16
  69. package/templates/react-sdk-reference/.claude/skills/template-skills/CaseSummary.md +19 -13
  70. package/templates/react-sdk-reference/.claude/skills/template-skills/CaseView.md +23 -17
  71. package/templates/react-sdk-reference/.claude/skills/template-skills/CaseViewActionsMenu.md +34 -29
  72. package/templates/react-sdk-reference/.claude/skills/template-skills/Confirmation.md +18 -16
  73. package/templates/react-sdk-reference/.claude/skills/template-skills/DataReference.md +36 -32
  74. package/templates/react-sdk-reference/.claude/skills/template-skills/DefaultForm.md +23 -21
  75. package/templates/react-sdk-reference/.claude/skills/template-skills/DefaultPage.md +31 -29
  76. package/templates/react-sdk-reference/.claude/skills/template-skills/Details.md +19 -17
  77. package/templates/react-sdk-reference/.claude/skills/template-skills/DetailsSubTabs.md +22 -20
  78. package/templates/react-sdk-reference/.claude/skills/template-skills/DetailsThreeColumn.md +19 -17
  79. package/templates/react-sdk-reference/.claude/skills/template-skills/DetailsTwoColumn.md +19 -17
  80. package/templates/react-sdk-reference/.claude/skills/template-skills/DynamicTabs.md +15 -10
  81. package/templates/react-sdk-reference/.claude/skills/template-skills/FieldGroupTemplate.md +19 -16
  82. package/templates/react-sdk-reference/.claude/skills/template-skills/HierarchicalForm.md +18 -15
  83. package/templates/react-sdk-reference/.claude/skills/template-skills/InlineDashboard.md +17 -13
  84. package/templates/react-sdk-reference/.claude/skills/template-skills/InlineDashboardPage.md +10 -13
  85. package/templates/react-sdk-reference/.claude/skills/template-skills/ListPage.md +9 -7
  86. package/templates/react-sdk-reference/.claude/skills/template-skills/ListView.md +33 -30
  87. package/templates/react-sdk-reference/.claude/skills/template-skills/MultiReferenceReadOnly.md +13 -11
  88. package/templates/react-sdk-reference/.claude/skills/template-skills/NarrowWide.md +42 -40
  89. package/templates/react-sdk-reference/.claude/skills/template-skills/OneColumn.md +25 -20
  90. package/templates/react-sdk-reference/.claude/skills/template-skills/PromotedFilters.md +25 -19
  91. package/templates/react-sdk-reference/.claude/skills/template-skills/SelfServiceCaseView.md +36 -29
  92. package/templates/react-sdk-reference/.claude/skills/template-skills/SimpleTable.md +31 -27
  93. package/templates/react-sdk-reference/.claude/skills/template-skills/SingleReferenceReadOnly.md +29 -24
  94. package/templates/react-sdk-reference/.claude/skills/template-skills/SubTabs.md +14 -11
  95. package/templates/react-sdk-reference/.claude/skills/template-skills/TwoColumn.md +34 -32
  96. package/templates/react-sdk-reference/.claude/skills/template-skills/WideNarrow.md +48 -46
  97. package/templates/react-sdk-reference/.claude/skills/template-skills/WssNavBar.md +23 -19
  98. package/templates/react-sdk-reference/.claude/skills/widget-components.md +11 -22
  99. package/templates/react-sdk-reference/.claude/skills/widget-skills/AppAnnouncement.md +22 -20
  100. package/templates/react-sdk-reference/.claude/skills/widget-skills/Attachment.md +33 -28
  101. package/templates/react-sdk-reference/.claude/skills/widget-skills/CaseHistory.md +18 -15
  102. package/templates/react-sdk-reference/.claude/skills/widget-skills/FileUtility.md +43 -37
  103. package/templates/react-sdk-reference/.claude/skills/widget-skills/Followers.md +23 -19
  104. package/templates/react-sdk-reference/.claude/skills/widget-skills/QuickCreate.md +20 -16
  105. package/templates/react-sdk-reference/.claude/skills/widget-skills/SummaryItem.md +26 -24
  106. package/templates/react-sdk-reference/.claude/skills/widget-skills/ToDo.md +43 -35
  107. package/templates/react-sdk-reference/.cursor/rules/prompts/component-manifest.json +165 -83
  108. package/templates/react-sdk-reference/.github/agents/implementation-expert.agent.md +135 -0
  109. package/templates/react-sdk-reference/.github/instructions/component-map.instructions.md +2 -2
  110. package/templates/react-sdk-reference/.github/instructions/dse-component.instructions.md +1 -1
  111. package/templates/react-sdk-reference/.github/instructions/field-component.instructions.md +5 -1
  112. package/templates/react-sdk-reference/.github/instructions/template-component.instructions.md +3 -2
  113. package/templates/react-sdk-reference/.github/instructions/widget-component.instructions.md +2 -1
  114. package/templates/react-sdk-reference/.github/prompts/add-component.prompt.md +58 -15
  115. package/templates/react-sdk-reference/.github/prompts/component-manifest.json +165 -83
  116. package/templates/react-sdk-reference/.github/prompts/generate-all-components.prompt.md +322 -65
  117. package/templates/react-sdk-reference/.github/prompts/generate-dse-components.prompt.md +124 -50
  118. package/templates/react-sdk-reference/.github/prompts/generate-field-components.prompt.md +145 -66
  119. package/templates/react-sdk-reference/.github/prompts/generate-template-components.prompt.md +146 -73
  120. package/templates/react-sdk-reference/.github/prompts/generate-widget-components.prompt.md +128 -49
  121. package/templates/react-sdk-reference/.github/prompts/identify-components.prompt.md +65 -65
  122. package/templates/react-sdk-reference/.github/skills/component-contracts.md +99 -99
  123. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/AlertBanner.md +40 -38
  124. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/Banner.md +54 -51
  125. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/CaseSummaryFields.md +51 -46
  126. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/DetailsFields.md +32 -28
  127. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/FieldGroup.md +38 -35
  128. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/FieldGroupList.md +25 -23
  129. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/FieldValueList.md +29 -26
  130. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/Operator.md +32 -26
  131. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/Pulse.md +17 -15
  132. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/RichTextEditor.md +85 -59
  133. package/templates/react-sdk-reference/.github/skills/design-system-extension-skills/WssQuickCreate.md +49 -47
  134. package/templates/react-sdk-reference/.github/skills/design-system-extension.md +13 -11
  135. package/templates/react-sdk-reference/.github/skills/field-components.md +9 -8
  136. package/templates/react-sdk-reference/.github/skills/field-skills/AutoComplete.md +27 -26
  137. package/templates/react-sdk-reference/.github/skills/field-skills/CancelAlert.md +30 -22
  138. package/templates/react-sdk-reference/.github/skills/field-skills/Checkbox.md +60 -43
  139. package/templates/react-sdk-reference/.github/skills/field-skills/Currency.md +23 -20
  140. package/templates/react-sdk-reference/.github/skills/field-skills/Date.md +19 -17
  141. package/templates/react-sdk-reference/.github/skills/field-skills/DateTime.md +18 -15
  142. package/templates/react-sdk-reference/.github/skills/field-skills/Decimal.md +22 -21
  143. package/templates/react-sdk-reference/.github/skills/field-skills/Dropdown.md +50 -30
  144. package/templates/react-sdk-reference/.github/skills/field-skills/Email.md +20 -18
  145. package/templates/react-sdk-reference/.github/skills/field-skills/Group.md +21 -15
  146. package/templates/react-sdk-reference/.github/skills/field-skills/Integer.md +17 -16
  147. package/templates/react-sdk-reference/.github/skills/field-skills/Location.md +30 -21
  148. package/templates/react-sdk-reference/.github/skills/field-skills/Multiselect.md +66 -42
  149. package/templates/react-sdk-reference/.github/skills/field-skills/ObjectReference.md +27 -18
  150. package/templates/react-sdk-reference/.github/skills/field-skills/Percentage.md +22 -21
  151. package/templates/react-sdk-reference/.github/skills/field-skills/Phone.md +36 -17
  152. package/templates/react-sdk-reference/.github/skills/field-skills/RadioButtons.md +56 -35
  153. package/templates/react-sdk-reference/.github/skills/field-skills/RichText.md +23 -12
  154. package/templates/react-sdk-reference/.github/skills/field-skills/ScalarList.md +41 -31
  155. package/templates/react-sdk-reference/.github/skills/field-skills/SelectableCard.md +70 -55
  156. package/templates/react-sdk-reference/.github/skills/field-skills/SemanticLink.md +34 -27
  157. package/templates/react-sdk-reference/.github/skills/field-skills/TextArea.md +24 -22
  158. package/templates/react-sdk-reference/.github/skills/field-skills/TextContent.md +38 -22
  159. package/templates/react-sdk-reference/.github/skills/field-skills/TextInput.md +24 -21
  160. package/templates/react-sdk-reference/.github/skills/field-skills/Time.md +16 -15
  161. package/templates/react-sdk-reference/.github/skills/field-skills/URL.md +16 -15
  162. package/templates/react-sdk-reference/.github/skills/field-skills/UserReference.md +57 -34
  163. package/templates/react-sdk-reference/.github/skills/run-and-verify.md +10 -8
  164. package/templates/react-sdk-reference/.github/skills/template-components.md +7 -8
  165. package/templates/react-sdk-reference/.github/skills/template-skills/AdvancedSearch.md +27 -21
  166. package/templates/react-sdk-reference/.github/skills/template-skills/AppShell.md +17 -15
  167. package/templates/react-sdk-reference/.github/skills/template-skills/BannerPage.md +19 -16
  168. package/templates/react-sdk-reference/.github/skills/template-skills/CaseSummary.md +19 -13
  169. package/templates/react-sdk-reference/.github/skills/template-skills/CaseView.md +23 -17
  170. package/templates/react-sdk-reference/.github/skills/template-skills/CaseViewActionsMenu.md +34 -29
  171. package/templates/react-sdk-reference/.github/skills/template-skills/Confirmation.md +18 -16
  172. package/templates/react-sdk-reference/.github/skills/template-skills/DataReference.md +36 -32
  173. package/templates/react-sdk-reference/.github/skills/template-skills/DefaultForm.md +23 -21
  174. package/templates/react-sdk-reference/.github/skills/template-skills/DefaultPage.md +31 -29
  175. package/templates/react-sdk-reference/.github/skills/template-skills/Details.md +19 -17
  176. package/templates/react-sdk-reference/.github/skills/template-skills/DetailsSubTabs.md +22 -20
  177. package/templates/react-sdk-reference/.github/skills/template-skills/DetailsThreeColumn.md +19 -17
  178. package/templates/react-sdk-reference/.github/skills/template-skills/DetailsTwoColumn.md +19 -17
  179. package/templates/react-sdk-reference/.github/skills/template-skills/DynamicTabs.md +15 -10
  180. package/templates/react-sdk-reference/.github/skills/template-skills/FieldGroupTemplate.md +19 -16
  181. package/templates/react-sdk-reference/.github/skills/template-skills/HierarchicalForm.md +18 -15
  182. package/templates/react-sdk-reference/.github/skills/template-skills/InlineDashboard.md +17 -13
  183. package/templates/react-sdk-reference/.github/skills/template-skills/InlineDashboardPage.md +10 -13
  184. package/templates/react-sdk-reference/.github/skills/template-skills/ListPage.md +9 -7
  185. package/templates/react-sdk-reference/.github/skills/template-skills/ListView.md +33 -30
  186. package/templates/react-sdk-reference/.github/skills/template-skills/MultiReferenceReadOnly.md +13 -11
  187. package/templates/react-sdk-reference/.github/skills/template-skills/NarrowWide.md +42 -40
  188. package/templates/react-sdk-reference/.github/skills/template-skills/OneColumn.md +25 -20
  189. package/templates/react-sdk-reference/.github/skills/template-skills/PromotedFilters.md +25 -19
  190. package/templates/react-sdk-reference/.github/skills/template-skills/SelfServiceCaseView.md +36 -29
  191. package/templates/react-sdk-reference/.github/skills/template-skills/SimpleTable.md +31 -27
  192. package/templates/react-sdk-reference/.github/skills/template-skills/SingleReferenceReadOnly.md +29 -24
  193. package/templates/react-sdk-reference/.github/skills/template-skills/SubTabs.md +14 -11
  194. package/templates/react-sdk-reference/.github/skills/template-skills/TwoColumn.md +34 -32
  195. package/templates/react-sdk-reference/.github/skills/template-skills/WideNarrow.md +48 -46
  196. package/templates/react-sdk-reference/.github/skills/template-skills/WssNavBar.md +23 -19
  197. package/templates/react-sdk-reference/.github/skills/widget-components.md +11 -22
  198. package/templates/react-sdk-reference/.github/skills/widget-skills/AppAnnouncement.md +22 -20
  199. package/templates/react-sdk-reference/.github/skills/widget-skills/Attachment.md +33 -28
  200. package/templates/react-sdk-reference/.github/skills/widget-skills/CaseHistory.md +18 -15
  201. package/templates/react-sdk-reference/.github/skills/widget-skills/FileUtility.md +43 -37
  202. package/templates/react-sdk-reference/.github/skills/widget-skills/Followers.md +23 -19
  203. package/templates/react-sdk-reference/.github/skills/widget-skills/QuickCreate.md +20 -16
  204. package/templates/react-sdk-reference/.github/skills/widget-skills/SummaryItem.md +26 -24
  205. package/templates/react-sdk-reference/.github/skills/widget-skills/ToDo.md +43 -35
  206. package/templates/react-sdk-reference/AGENTS.md +0 -1
  207. package/templates/react-sdk-reference/index.html +1 -4
  208. package/templates/react-sdk-reference/package.json +15 -15
  209. package/templates/react-sdk-reference/pega-sdk-react-0.1.0.tgz +0 -0
  210. package/templates/react-sdk-reference/src/AppSelector.tsx +6 -6
  211. package/templates/react-sdk-reference/src/FallbackComponent.tsx +2 -6
  212. package/templates/react-sdk-reference/src/MashupApp.styles.ts +269 -41
  213. package/templates/react-sdk-reference/src/MashupApp.tsx +186 -85
  214. package/templates/react-sdk-reference/src/PortalApp.tsx +10 -34
  215. package/templates/react-sdk-reference/src/components/component-map.ts +2 -7
  216. package/templates/react-sdk-reference/src/components/designSystemExtension/AlertBanner/AlertBanner.tsx +7 -28
  217. package/templates/react-sdk-reference/src/components/designSystemExtension/Banner/Banner.tsx +12 -7
  218. package/templates/react-sdk-reference/src/components/designSystemExtension/CaseSummaryFields/CaseSummaryFields.tsx +35 -33
  219. package/templates/react-sdk-reference/src/components/designSystemExtension/DetailsFields/DetailsFields.tsx +6 -27
  220. package/templates/react-sdk-reference/src/components/designSystemExtension/FieldGroup/FieldGroup.tsx +15 -11
  221. package/templates/react-sdk-reference/src/components/designSystemExtension/FieldGroupList/FieldGroupList.tsx +7 -7
  222. package/templates/react-sdk-reference/src/components/designSystemExtension/FieldValueList/FieldValueList.tsx +18 -12
  223. package/templates/react-sdk-reference/src/components/designSystemExtension/Operator/Operator.tsx +27 -25
  224. package/templates/react-sdk-reference/src/components/designSystemExtension/Pulse/Pulse.tsx +4 -4
  225. package/templates/react-sdk-reference/src/components/designSystemExtension/RichTextEditor/RichTextEditor.tsx +8 -40
  226. package/templates/react-sdk-reference/src/components/designSystemExtension/WssQuickCreate/WssQuickCreate.tsx +9 -9
  227. package/templates/react-sdk-reference/src/components/field/AutoComplete/AutoComplete.tsx +26 -20
  228. package/templates/react-sdk-reference/src/components/field/CancelAlert/CancelAlert.tsx +35 -17
  229. package/templates/react-sdk-reference/src/components/field/Checkbox/Checkbox.tsx +27 -25
  230. package/templates/react-sdk-reference/src/components/field/Currency/Currency.tsx +10 -6
  231. package/templates/react-sdk-reference/src/components/field/Currency/currency-utils.ts +1 -1
  232. package/templates/react-sdk-reference/src/components/field/Date/Date.tsx +20 -7
  233. package/templates/react-sdk-reference/src/components/field/DateTime/DateTime.tsx +23 -8
  234. package/templates/react-sdk-reference/src/components/field/Decimal/Decimal.tsx +5 -5
  235. package/templates/react-sdk-reference/src/components/field/Dropdown/Dropdown.tsx +45 -25
  236. package/templates/react-sdk-reference/src/components/field/Email/Email.tsx +8 -8
  237. package/templates/react-sdk-reference/src/components/field/Group/Group.tsx +1 -1
  238. package/templates/react-sdk-reference/src/components/field/Integer/Integer.tsx +5 -5
  239. package/templates/react-sdk-reference/src/components/field/Location/Location.tsx +21 -16
  240. package/templates/react-sdk-reference/src/components/field/Multiselect/Multiselect.tsx +42 -27
  241. package/templates/react-sdk-reference/src/components/field/Multiselect/utils.ts +43 -29
  242. package/templates/react-sdk-reference/src/components/field/ObjectReference/ObjectReference.tsx +53 -30
  243. package/templates/react-sdk-reference/src/components/field/ObjectReference/utils.ts +12 -11
  244. package/templates/react-sdk-reference/src/components/field/Percentage/Percentage.tsx +6 -6
  245. package/templates/react-sdk-reference/src/components/field/Phone/Phone.tsx +12 -12
  246. package/templates/react-sdk-reference/src/components/field/RadioButtons/RadioButtons.tsx +38 -16
  247. package/templates/react-sdk-reference/src/components/field/RichText/RichText.tsx +17 -4
  248. package/templates/react-sdk-reference/src/components/field/ScalarList/ScalarList.tsx +5 -5
  249. package/templates/react-sdk-reference/src/components/field/SelectableCard/SelectableCard.tsx +31 -18
  250. package/templates/react-sdk-reference/src/components/field/SelectableCard/utils.tsx +28 -20
  251. package/templates/react-sdk-reference/src/components/field/SemanticLink/SemanticLink.tsx +28 -19
  252. package/templates/react-sdk-reference/src/components/field/SemanticLink/utils.ts +3 -1
  253. package/templates/react-sdk-reference/src/components/field/TextArea/TextArea.tsx +4 -4
  254. package/templates/react-sdk-reference/src/components/field/TextInput/TextInput.tsx +4 -4
  255. package/templates/react-sdk-reference/src/components/field/Time/Time.tsx +20 -7
  256. package/templates/react-sdk-reference/src/components/field/URL/URL.tsx +7 -7
  257. package/templates/react-sdk-reference/src/components/field/UserReference/UserReference.tsx +14 -14
  258. package/templates/react-sdk-reference/src/components/field/UserReference/UserReferenceUtils.ts +2 -2
  259. package/templates/react-sdk-reference/src/components/helpers/case-utils.tsx +5 -5
  260. package/templates/react-sdk-reference/src/components/helpers/data_page.ts +3 -3
  261. package/templates/react-sdk-reference/src/components/helpers/date-format-utils.ts +5 -5
  262. package/templates/react-sdk-reference/src/components/helpers/field-group-utils.ts +2 -7
  263. package/templates/react-sdk-reference/src/components/helpers/formatters/Boolean.ts +9 -3
  264. package/templates/react-sdk-reference/src/components/helpers/formatters/Currency.ts +18 -6
  265. package/templates/react-sdk-reference/src/components/helpers/formatters/CurrencyMap.ts +168 -168
  266. package/templates/react-sdk-reference/src/components/helpers/formatters/Date.ts +5 -5
  267. package/templates/react-sdk-reference/src/components/helpers/formatters/index.ts +8 -5
  268. package/templates/react-sdk-reference/src/components/helpers/instructions-utils.ts +2 -2
  269. package/templates/react-sdk-reference/src/components/helpers/simpleTableHelpers.ts +54 -30
  270. package/templates/react-sdk-reference/src/components/helpers/state-utils.tsx +5 -2
  271. package/templates/react-sdk-reference/src/components/helpers/template-utils.ts +5 -4
  272. package/templates/react-sdk-reference/src/components/helpers/utils.ts +3 -3
  273. package/templates/react-sdk-reference/src/components/helpers/versionHelpers.ts +3 -1
  274. package/templates/react-sdk-reference/src/components/index.ts +1 -4
  275. package/templates/react-sdk-reference/src/components/template/AdvancedSearch/AdvancedSearch.tsx +18 -10
  276. package/templates/react-sdk-reference/src/components/template/AdvancedSearch/SearchGroup/persistUtils.ts +3 -3
  277. package/templates/react-sdk-reference/src/components/template/AdvancedSearch/SearchGroups/SearchGroups.tsx +26 -90
  278. package/templates/react-sdk-reference/src/components/template/AdvancedSearch/SearchGroups/hooks.ts +8 -5
  279. package/templates/react-sdk-reference/src/components/template/AdvancedSearch/SearchGroups/utils.ts +8 -4
  280. package/templates/react-sdk-reference/src/components/template/AdvancedSearch/TemplateContext.ts +1 -1
  281. package/templates/react-sdk-reference/src/components/template/AppShell/AppShell.tsx +28 -19
  282. package/templates/react-sdk-reference/src/components/template/BannerPage/BannerPage.tsx +2 -2
  283. package/templates/react-sdk-reference/src/components/template/CaseSummary/CaseSummary.tsx +5 -5
  284. package/templates/react-sdk-reference/src/components/template/CaseView/CaseView.tsx +35 -16
  285. package/templates/react-sdk-reference/src/components/template/CaseViewActionsMenu/CaseViewActionsMenu.tsx +10 -10
  286. package/templates/react-sdk-reference/src/components/template/Confirmation/Confirmation.tsx +12 -26
  287. package/templates/react-sdk-reference/src/components/template/DataReference/DataReference.tsx +41 -124
  288. package/templates/react-sdk-reference/src/components/template/DataReference/DataReferenceAdvancedSearchContext.ts +2 -2
  289. package/templates/react-sdk-reference/src/components/template/DataReference/SearchForm.tsx +18 -78
  290. package/templates/react-sdk-reference/src/components/template/DataReference/utils.ts +18 -12
  291. package/templates/react-sdk-reference/src/components/template/DefaultForm/DefaultForm.tsx +4 -12
  292. package/templates/react-sdk-reference/src/components/template/DefaultForm/utils/index.ts +3 -3
  293. package/templates/react-sdk-reference/src/components/template/DefaultPage/DefaultPage.tsx +3 -3
  294. package/templates/react-sdk-reference/src/components/template/Details/Details/Details.tsx +6 -8
  295. package/templates/react-sdk-reference/src/components/template/Details/DetailsThreeColumn/DetailsThreeColumn.tsx +7 -14
  296. package/templates/react-sdk-reference/src/components/template/Details/DetailsTwoColumn/DetailsTwoColumn.tsx +7 -14
  297. package/templates/react-sdk-reference/src/components/template/Details/DynamicTabs/DynamicTabs.tsx +16 -8
  298. package/templates/react-sdk-reference/src/components/template/FieldGroupTemplate/FieldGroupTemplate.tsx +7 -4
  299. package/templates/react-sdk-reference/src/components/template/HierarchicalForm/HierarchicalForm.tsx +20 -5
  300. package/templates/react-sdk-reference/src/components/template/HierarchicalForm/hooks.ts +35 -77
  301. package/templates/react-sdk-reference/src/components/template/InlineDashboard/InlineDashboard.tsx +10 -10
  302. package/templates/react-sdk-reference/src/components/template/ListView/DefaultViewMeta.ts +31 -31
  303. package/templates/react-sdk-reference/src/components/template/ListView/ListView.tsx +173 -133
  304. package/templates/react-sdk-reference/src/components/template/ListView/hooks.ts +17 -10
  305. package/templates/react-sdk-reference/src/components/template/ListView/utils.ts +64 -51
  306. package/templates/react-sdk-reference/src/components/template/MultiReferenceReadOnly/MultiReferenceReadOnly.tsx +6 -6
  307. package/templates/react-sdk-reference/src/components/template/NarrowWide/NarrowWide/NarrowWide.tsx +6 -6
  308. package/templates/react-sdk-reference/src/components/template/NarrowWide/NarrowWideDetails/NarrowWideDetails.tsx +8 -18
  309. package/templates/react-sdk-reference/src/components/template/NarrowWide/NarrowWideForm/NarrowWideForm.tsx +3 -3
  310. package/templates/react-sdk-reference/src/components/template/NarrowWide/NarrowWidePage/NarrowWidePage.tsx +7 -1
  311. package/templates/react-sdk-reference/src/components/template/OneColumn/OneColumn/OneColumn.tsx +3 -3
  312. package/templates/react-sdk-reference/src/components/template/OneColumn/OneColumnTab/OneColumnTab.tsx +1 -1
  313. package/templates/react-sdk-reference/src/components/template/PromotedFilters/PromotedFilters.tsx +13 -40
  314. package/templates/react-sdk-reference/src/components/template/SelfServiceCaseView/SelfServiceCaseView.tsx +19 -16
  315. package/templates/react-sdk-reference/src/components/template/SimpleTable/SimpleTable/SimpleTable.tsx +8 -7
  316. package/templates/react-sdk-reference/src/components/template/SimpleTable/SimpleTableManual/SimpleTableManual.tsx +84 -203
  317. package/templates/react-sdk-reference/src/components/template/SimpleTable/SimpleTableSelect/SimpleTableSelect.tsx +15 -5
  318. package/templates/react-sdk-reference/src/components/template/SimpleTable/SimpleTableSelectReadonly/SimpleTableSelectReadonly.tsx +15 -29
  319. package/templates/react-sdk-reference/src/components/template/SingleReferenceReadOnly/SingleReferenceReadOnly.tsx +7 -7
  320. package/templates/react-sdk-reference/src/components/template/SubTabs/SubTabs.tsx +1 -1
  321. package/templates/react-sdk-reference/src/components/template/SubTabs/tabUtils.ts +13 -11
  322. package/templates/react-sdk-reference/src/components/template/TwoColumn/TwoColumn/TwoColumn.tsx +3 -3
  323. package/templates/react-sdk-reference/src/components/template/TwoColumn/TwoColumnTab/TwoColumnTab.tsx +3 -3
  324. package/templates/react-sdk-reference/src/components/template/WideNarrow/WideNarrow/WideNarrow.tsx +6 -6
  325. package/templates/react-sdk-reference/src/components/template/WideNarrow/WideNarrowDetails/WideNarrowDetails.tsx +13 -24
  326. package/templates/react-sdk-reference/src/components/template/WideNarrow/WideNarrowForm/WideNarrowForm.tsx +3 -3
  327. package/templates/react-sdk-reference/src/components/template/WideNarrow/WideNarrowPage/WideNarrowPage.tsx +7 -1
  328. package/templates/react-sdk-reference/src/components/template/WssNavBar/WssNavBar.tsx +25 -25
  329. package/templates/react-sdk-reference/src/components/template/utils.tsx +6 -6
  330. package/templates/react-sdk-reference/src/components/widget/AppAnnouncement/AppAnnouncement.tsx +9 -9
  331. package/templates/react-sdk-reference/src/components/widget/Attachment/Attachment.tsx +125 -79
  332. package/templates/react-sdk-reference/src/components/widget/Attachment/AttachmentUtils.ts +58 -33
  333. package/templates/react-sdk-reference/src/components/widget/CaseHistory/CaseHistory.tsx +14 -12
  334. package/templates/react-sdk-reference/src/components/widget/FileUtility/ActionButtonsForFileUtil/ActionButtonsForFileUtil.tsx +19 -7
  335. package/templates/react-sdk-reference/src/components/widget/FileUtility/FileUtility/FileUtility.tsx +137 -107
  336. package/templates/react-sdk-reference/src/components/widget/Followers/Followers.tsx +4 -4
  337. package/templates/react-sdk-reference/src/components/widget/QuickCreate/QuickCreate.tsx +15 -11
  338. package/templates/react-sdk-reference/src/components/widget/SummaryItem/SummaryItem.tsx +25 -18
  339. package/templates/react-sdk-reference/src/components/widget/SummaryList/SummaryList.tsx +7 -2
  340. package/templates/react-sdk-reference/src/components/widget/ToDo/ToDo.tsx +30 -116
  341. package/templates/react-sdk-reference/src/main.tsx +1 -1
  342. package/templates/react-sdk-reference/tsconfig.json +2 -1
  343. package/templates/react-sdk-reference/vite.config.ts +51 -26
  344. package/templates/wc-sdk-reference/package.json +3 -3
  345. package/templates/wc-sdk-reference/src/index.ts +10 -10
  346. package/templates/wc-sdk-reference/tsconfig.json +1 -0
@@ -9,6 +9,7 @@ Single field-value pair display component. Renders a label and value in either a
9
9
  ## Component Purpose
10
10
 
11
11
  Renders a single name/value pair in a compact read-only layout. Supports two layout variants:
12
+
12
13
  - **Inline:** Label and value are side by side (label 4/12 cols, value 8/12 cols).
13
14
  - **Stacked:** Label is on top, value is larger below (both 12/12 cols).
14
15
 
@@ -22,12 +23,12 @@ When no name is provided, only the value is rendered at full width. Used directl
22
23
 
23
24
  ## Props
24
25
 
25
- | Prop | Type | Required | Description |
26
- |------|------|----------|-------------|
27
- | `name` | `string` | No | Field label. If omitted, only the value is rendered |
28
- | `value` | `any` | Yes | Field value to display |
29
- | `variant` | `string` | No | Layout: `'inline'` (default) or `'stacked'` |
30
- | `isHtml` | `boolean` | No | If `true`, render value as raw HTML (default `false`) |
26
+ | Prop | Type | Required | Description |
27
+ | --------- | --------- | -------- | ----------------------------------------------------- |
28
+ | `name` | `string` | No | Field label. If omitted, only the value is rendered |
29
+ | `value` | `any` | Yes | Field value to display |
30
+ | `variant` | `string` | No | Layout: `'inline'` (default) or `'stacked'` |
31
+ | `isHtml` | `boolean` | No | If `true`, render value as raw HTML (default `false`) |
31
32
 
32
33
  ## Behavioral Contract
33
34
 
@@ -52,28 +53,29 @@ Derived from `FieldValueList.tsx` makeStyles:
52
53
 
53
54
  ### Label
54
55
 
55
- | Property | Value |
56
- |----------|-------|
57
- | Font weight | 400 |
58
- | Color | `theme.palette.text.secondary` (muted/secondary text) |
59
- | Typography | `body2` (≈ 0.875rem / 14px) |
56
+ | Property | Value |
57
+ | ----------- | ----------------------------------------------------- |
58
+ | Font weight | 400 |
59
+ | Color | `theme.palette.text.secondary` (muted/secondary text) |
60
+ | Typography | `body2` (≈ 0.875rem / 14px) |
60
61
 
61
62
  ### Value
62
63
 
63
- | Property | Value |
64
- |----------|-------|
65
- | Color | `theme.palette.text.primary` (default text) |
66
- | Typography (inline) | `body2` (≈ 0.875rem / 14px) |
67
- | Typography (stacked) | `h6` (≈ 1.25rem / 20px, weight 500) |
64
+ | Property | Value |
65
+ | -------------------- | ------------------------------------------- |
66
+ | Color | `theme.palette.text.primary` (default text) |
67
+ | Typography (inline) | `body2` (≈ 0.875rem / 14px) |
68
+ | Typography (stacked) | `h6` (≈ 1.25rem / 20px, weight 500) |
68
69
 
69
70
  ### Padding Adjustments (stacked only)
70
71
 
71
- | Property | Value |
72
- |----------|-------|
72
+ | Property | Value |
73
+ | -------------------- | -------------- |
73
74
  | Label bottom padding | `0 !important` |
74
- | Value top padding | `0 !important` |
75
+ | Value top padding | `0 !important` |
75
76
 
76
77
  **CSS-only implementation notes:**
78
+
77
79
  - Root row: `display: flex; justify-content: space-between; align-items: baseline; gap: 1rem`.
78
80
  - **Inline label:** `flex: 0 0 33%; font-weight: 400; font-size: 0.875rem; color: var(--text-secondary)`.
79
81
  - **Inline value:** `flex: 1; font-size: 0.875rem; color: var(--text-primary)`.
@@ -99,15 +101,16 @@ Derived from `FieldValueList.tsx` makeStyles:
99
101
 
100
102
  Listed design systems are examples only.
101
103
 
102
- | Design System | Recommended Component |
103
- |---|---|
104
- | Default (CSS only) | `<div class='field-value-inline'>` or `<div class='field-value-stacked'>` with CSS |
105
- | MUI | `<Grid container>` with `<Typography>` for label and value |
106
- | Ant Design | `<Descriptions>` item, or `<Typography.Text type='secondary'>` + `<Typography.Text>` |
107
- | Chakra UI | `<Stack direction='row'>` (inline) or `<Stack spacing={0}>` (stacked) |
108
- | Shadcn/ui | Custom label/value pair with Tailwind flex utilities |
104
+ | Design System | Recommended Component |
105
+ | ------------------ | ------------------------------------------------------------------------------------ |
106
+ | Default (CSS only) | `<div class='field-value-inline'>` or `<div class='field-value-stacked'>` with CSS |
107
+ | MUI | `<Grid container>` with `<Typography>` for label and value |
108
+ | Ant Design | `<Descriptions>` item, or `<Typography.Text type='secondary'>` + `<Typography.Text>` |
109
+ | Chakra UI | `<Stack direction='row'>` (inline) or `<Stack spacing={0}>` (stacked) |
110
+ | Shadcn/ui | Custom label/value pair with Tailwind flex utilities |
109
111
 
110
112
  When implementing in a specific design system, map the following:
113
+
111
114
  - Label → secondary/muted text style
112
115
  - Value inline → same size as label
113
116
  - Value stacked → larger typography (h6 equivalent)
@@ -20,22 +20,23 @@ Renders a clickable read-only field displaying a case operator's name and the re
20
20
 
21
21
  The component interface extends `PConnProps` but all rendering data is passed as explicit props:
22
22
 
23
- | Prop | Type | Required | Description |
24
- |------|------|----------|-------------|
25
- | `label` | `string` | Yes | The field label used to identify which operator to display. Must be `'create operator'` or `'update operator'` (case-insensitive). |
26
- | `displayLabel` | `any` | No | Alternative label (used if `label` doesn't match). Also compared case-insensitively. |
27
- | `createDateTime` | `string` | Yes | ISO datetime string of when the case was created |
28
- | `createLabel` | `string` | Yes | Display label for the create operator field |
29
- | `createOperator` | `{ userName: string; userId: string }` | Yes | Creator's name and ID |
30
- | `updateDateTime` | `string` | Yes | ISO datetime string of last update |
31
- | `updateLabel` | `string` | Yes | Display label for the update operator field |
32
- | `updateOperator` | `{ userName: string; userId: string }` | Yes | Updater's name and ID |
23
+ | Prop | Type | Required | Description |
24
+ | ---------------- | -------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
25
+ | `label` | `string` | Yes | The field label used to identify which operator to display. Must be `'create operator'` or `'update operator'` (case-insensitive). |
26
+ | `displayLabel` | `any` | No | Alternative label (used if `label` doesn't match). Also compared case-insensitively. |
27
+ | `createDateTime` | `string` | Yes | ISO datetime string of when the case was created |
28
+ | `createLabel` | `string` | Yes | Display label for the create operator field |
29
+ | `createOperator` | `{ userName: string; userId: string }` | Yes | Creator's name and ID |
30
+ | `updateDateTime` | `string` | Yes | ISO datetime string of last update |
31
+ | `updateLabel` | `string` | Yes | Display label for the update operator field |
32
+ | `updateOperator` | `{ userName: string; userId: string }` | Yes | Updater's name and ID |
33
33
 
34
34
  ## Behavioral Contract
35
35
 
36
36
  ### 1. Operator Selection
37
37
 
38
38
  Determine which operator to display based on `label.toLowerCase()` or `displayLabel?.toLowerCase()`:
39
+
39
40
  - If either is `'create operator'`:
40
41
  - `caseOpLabel = createLabel`
41
42
  - `caseOpName = createOperator.userName`
@@ -51,6 +52,7 @@ Determine which operator to display based on `label.toLowerCase()` or `displayLa
51
52
  ### 2. Main Display
52
53
 
53
54
  Render a read-only TextField (standard variant, no underline, pointer cursor) with:
55
+
54
56
  - `defaultValue={caseOpName}`
55
57
  - `label={caseOpLabel}`
56
58
  - `onClick={showOperatorDetails}`
@@ -61,6 +63,7 @@ Below the TextField, render the relative time: `Utils.generateDateTime(caseTime,
61
63
  ### 3. Popover on Click (`showOperatorDetails`)
62
64
 
63
65
  When the TextField is clicked:
66
+
64
67
  1. Call `PCore.getUserApi().getOperatorDetails(caseOpId)` — returns a Promise.
65
68
  2. Use `PCore.getLocaleUtils().getLocaleValue(key, 'Operator')` to localize field labels.
66
69
  3. On resolution, build a fields array with these entries (using `'---'` as fallback for missing values):
@@ -76,6 +79,7 @@ When the TextField is clicked:
76
79
  ### 4. Popover Layout
77
80
 
78
81
  The popover renders when `popoverAnchorEl` is set:
82
+
79
83
  - Anchor origin: `{ vertical: 'bottom', horizontal: 'center' }`
80
84
  - Transform origin: `{ vertical: 'top', horizontal: 'center' }`
81
85
  - Max width: `45ch`
@@ -91,20 +95,21 @@ Derived from `Operator.tsx` makeStyles:
91
95
 
92
96
  ### Root Container
93
97
 
94
- | Property | Value |
95
- |----------|-------|
96
- | Padding | `theme.spacing(1)` (≈ 8px) |
97
- | Margin | `theme.spacing(1)` |
98
+ | Property | Value |
99
+ | -------- | -------------------------- |
100
+ | Padding | `theme.spacing(1)` (≈ 8px) |
101
+ | Margin | `theme.spacing(1)` |
98
102
 
99
103
  ### Popover Container
100
104
 
101
- | Property | Value |
102
- |----------|-------|
103
- | Padding | `theme.spacing(1)` |
104
- | Margin | `theme.spacing(1)` |
105
- | Max width | 45ch |
105
+ | Property | Value |
106
+ | --------- | ------------------ |
107
+ | Padding | `theme.spacing(1)` |
108
+ | Margin | `theme.spacing(1)` |
109
+ | Max width | 45ch |
106
110
 
107
111
  **CSS-only implementation notes:**
112
+
108
113
  - Main display: read-only text field with label above, value below, pointer cursor on the value element.
109
114
  - Time display: secondary muted text below the operator name (e.g., `font-size: 0.75rem; color: var(--text-secondary)`).
110
115
  - Popover: `position: absolute; background: var(--bg-paper); border: 1px solid var(--divider); border-radius: 4px; padding: 8px; max-width: 45ch; box-shadow: 0 4px 12px rgba(0,0,0,0.15)`.
@@ -133,15 +138,16 @@ Derived from `Operator.tsx` makeStyles:
133
138
 
134
139
  Listed design systems are examples only.
135
140
 
136
- | Design System | Recommended Component |
137
- |---|---|
138
- | Default (CSS only) | `<div>` with click handler, custom CSS popover/tooltip panel |
139
- | MUI | Read-only `<TextField>` + `<Popover>` with `<Grid>` detail rows |
140
- | Ant Design | `<Input readOnly>` + `<Popover>` with `<Descriptions>` |
141
- | Chakra UI | `<Input isReadOnly>` + `<Popover>` with custom content |
142
- | Shadcn/ui | `<Input readOnly>` + `<Popover>` + `<PopoverContent>` |
141
+ | Design System | Recommended Component |
142
+ | ------------------ | --------------------------------------------------------------- |
143
+ | Default (CSS only) | `<div>` with click handler, custom CSS popover/tooltip panel |
144
+ | MUI | Read-only `<TextField>` + `<Popover>` with `<Grid>` detail rows |
145
+ | Ant Design | `<Input readOnly>` + `<Popover>` with `<Descriptions>` |
146
+ | Chakra UI | `<Input isReadOnly>` + `<Popover>` with custom content |
147
+ | Shadcn/ui | `<Input readOnly>` + `<Popover>` + `<PopoverContent>` |
143
148
 
144
149
  When implementing in a specific design system, map the following:
150
+
145
151
  - `onClick` on read-only input → trigger async fetch + open popover
146
152
  - `PCore.getUserApi().getOperatorDetails()` → call this before showing the popover
147
153
  - Popover anchor → position relative to the clicked element
@@ -18,9 +18,9 @@ Renders a card container intended to display an activity feed or comments stream
18
18
 
19
19
  ## Props
20
20
 
21
- | Prop | Type | Required | Description |
22
- |------|------|----------|-------------|
23
- | `children` | `ReactNode` | No | Child components (activity stream content) — currently unused in the stub |
21
+ | Prop | Type | Required | Description |
22
+ | ---------- | ----------- | -------- | ------------------------------------------------------------------------- |
23
+ | `children` | `ReactNode` | No | Child components (activity stream content) — currently unused in the stub |
24
24
 
25
25
  > **Note:** The current reference implementation ignores `children` and renders placeholder content. A full implementation would render `children` inside the card body.
26
26
 
@@ -40,14 +40,15 @@ Derived from `Pulse.tsx` makeStyles:
40
40
 
41
41
  ### Card Container
42
42
 
43
- | Property | Value |
44
- |----------|-------|
45
- | Margin top | `theme.spacing(1)` (≈ 8px in MUI default) |
46
- | Margin bottom | `theme.spacing(1)` (≈ 8px) |
47
- | Border left | `6px solid` |
43
+ | Property | Value |
44
+ | ----------------- | ------------------------------------------------------------------------ |
45
+ | Margin top | `theme.spacing(1)` (≈ 8px in MUI default) |
46
+ | Margin bottom | `theme.spacing(1)` (≈ 8px) |
47
+ | Border left | `6px solid` |
48
48
  | Border left color | `theme.palette.primary.light` (light variant of the primary brand color) |
49
49
 
50
50
  **CSS-only implementation notes:**
51
+
51
52
  - Card wrapper: `margin-top: 8px; margin-bottom: 8px; border-left: 6px solid var(--app-primary-light-color); border-radius: 4px; box-shadow: 0 1px 3px rgba(0,0,0,0.12)`.
52
53
  - Card header: `padding: 16px; font-size: 1.25rem; font-weight: 500`.
53
54
  - Card body: `padding: 0 16px 16px`.
@@ -69,15 +70,16 @@ Derived from `Pulse.tsx` makeStyles:
69
70
 
70
71
  Listed design systems are examples only.
71
72
 
72
- | Design System | Recommended Component |
73
- |---|---|
74
- | Default (CSS only) | `<div>` with `border-left: 6px solid` + inner header/body divs |
75
- | MUI | `<Card><CardHeader title={<Typography variant='h6'>Pulse</Typography>} /><CardContent>` |
76
- | Ant Design | `<Card title='Pulse'>` with left border via `style` prop |
77
- | Chakra UI | `<Card>` with `borderLeft='6px solid' borderColor='blue.300'` |
78
- | Shadcn/ui | `<Card><CardHeader><CardTitle>` |
73
+ | Design System | Recommended Component |
74
+ | ------------------ | --------------------------------------------------------------------------------------- |
75
+ | Default (CSS only) | `<div>` with `border-left: 6px solid` + inner header/body divs |
76
+ | MUI | `<Card><CardHeader title={<Typography variant='h6'>Pulse</Typography>} /><CardContent>` |
77
+ | Ant Design | `<Card title='Pulse'>` with left border via `style` prop |
78
+ | Chakra UI | `<Card>` with `borderLeft='6px solid' borderColor='blue.300'` |
79
+ | Shadcn/ui | `<Card><CardHeader><CardTitle>` |
79
80
 
80
81
  When implementing in a specific design system, map the following:
82
+
81
83
  - Left border accent → `borderLeft` / `border-left` on the card root
82
84
  - Left border color → primary light color from the design system's palette
83
85
  - Card header title typography → design system's heading variant (h6 or equivalent)
@@ -22,21 +22,21 @@ The editor is a `forwardRef` component — the ref is connected to the underlyin
22
22
 
23
23
  ## Props
24
24
 
25
- | Prop | Type | Required | Description |
26
- |------|------|----------|-------------|
27
- | `id` | `string` | No | DOM id for the editor element. Defaults to a generated UID |
28
- | `defaultValue` | `string` | Yes | Initial HTML content of the editor |
29
- | `label` | `string` | Yes | Field label displayed above the editor |
30
- | `labelHidden` | `boolean` | Yes | If `true`, hide the label |
31
- | `info` | `string` | No | Helper text displayed below the editor |
32
- | `testId` | `string` | No | Value for `data-test-id` attribute on the FormControl wrapper |
33
- | `placeholder` | `string` | No | Placeholder text shown in empty editor |
34
- | `disabled` | `boolean` | Yes | If `true`, editor is in read-only/disabled mode with no toolbar |
35
- | `required` | `boolean` | Yes | If `true`, marks the field as required |
36
- | `readOnly` | `boolean` | Yes | If `true`, render as static HTML display (not interactive editor) |
37
- | `error` | `boolean` | Yes | If `true`, applies error styling to the FormControl |
38
- | `onBlur` | `React.EventHandler<any>` | Yes | Called when the editor loses focus |
39
- | `onChange` | `React.EventHandler<any>` | Yes | Called when the editor content changes |
25
+ | Prop | Type | Required | Description |
26
+ | -------------- | ------------------------- | -------- | ----------------------------------------------------------------- |
27
+ | `id` | `string` | No | DOM id for the editor element. Defaults to a generated UID |
28
+ | `defaultValue` | `string` | Yes | Initial HTML content of the editor |
29
+ | `label` | `string` | Yes | Field label displayed above the editor |
30
+ | `labelHidden` | `boolean` | Yes | If `true`, hide the label |
31
+ | `info` | `string` | No | Helper text displayed below the editor |
32
+ | `testId` | `string` | No | Value for `data-test-id` attribute on the FormControl wrapper |
33
+ | `placeholder` | `string` | No | Placeholder text shown in empty editor |
34
+ | `disabled` | `boolean` | Yes | If `true`, editor is in read-only/disabled mode with no toolbar |
35
+ | `required` | `boolean` | Yes | If `true`, marks the field as required |
36
+ | `readOnly` | `boolean` | Yes | If `true`, render as static HTML display (not interactive editor) |
37
+ | `error` | `boolean` | Yes | If `true`, applies error styling to the FormControl |
38
+ | `onBlur` | `React.EventHandler<any>` | Yes | Called when the editor loses focus |
39
+ | `onChange` | `React.EventHandler<any>` | Yes | Called when the editor content changes |
40
40
 
41
41
  ## Behavioral Contract
42
42
 
@@ -51,6 +51,7 @@ If `id` is not provided, generate one using `useUID()` from `@pega/sdk-react`.
51
51
  ### 3. Read-Only Mode
52
52
 
53
53
  If `readOnly` is `true`, render:
54
+
54
55
  ```
55
56
  <div
56
57
  key={id}
@@ -59,44 +60,46 @@ If `readOnly` is `true`, render:
59
60
  dangerouslySetInnerHTML={{ __html: defaultValue || '--' }}
60
61
  />
61
62
  ```
63
+
62
64
  Skip the TinyMCE Editor entirely in this case.
63
65
 
64
66
  ### 4. Edit Mode (TinyMCE)
65
67
 
66
68
  When `readOnly` is `false`, render `<Editor>` from `@tinymce/tinymce-react` with:
67
69
 
68
- | Config | Value |
69
- |--------|-------|
70
+ | Config | Value |
71
+ | ------------------ | ----------------------------------------- |
70
72
  | `tinymceScriptSrc` | `'tinymce/tinymce.min.js'` (local script) |
71
- | `id` | The resolved `id` |
72
- | `initialValue` | `defaultValue` |
73
- | `disabled` | `disabled` prop |
74
- | `onBlur` | `onBlur` prop |
75
- | `onEditorChange` | `onChange` prop |
76
- | `onInit` | Store editor in `editorRef.current` |
73
+ | `id` | The resolved `id` |
74
+ | `initialValue` | `defaultValue` |
75
+ | `disabled` | `disabled` prop |
76
+ | `onBlur` | `onBlur` prop |
77
+ | `onEditorChange` | `onChange` prop |
78
+ | `onInit` | Store editor in `editorRef.current` |
77
79
 
78
80
  ### 5. TinyMCE `init` Configuration
79
81
 
80
- | Option | Value |
81
- |--------|-------|
82
- | `skin` | `'oxide-dark'` (dark mode) / `'oxide'` (light mode) — detect from theme |
83
- | `menubar` | `false` |
84
- | `statusbar` | `false` |
85
- | `branding` | `false` |
86
- | `min_height` | `130` |
87
- | `toolbar_location` | `'bottom'` |
88
- | `plugins` | `['lists', 'advlist', 'autolink', 'image', 'link', 'autoresize']` |
89
- | `autoresize_bottom_margin` | `0` |
90
- | `toolbar` | `'blocks \| bold italic strikethrough \| bullist numlist outdent indent \| link image'` (or `false` when `disabled`) |
91
- | `paste_data_images` | `true` |
92
- | `file_picker_types` | `'image'` |
93
- | `file_picker_callback` | See file picker section below |
94
- | `content_style` | Theme-aware CSS string (see below) |
95
- | `placeholder` | `placeholder` prop |
82
+ | Option | Value |
83
+ | -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
84
+ | `skin` | `'oxide-dark'` (dark mode) / `'oxide'` (light mode) — detect from theme |
85
+ | `menubar` | `false` |
86
+ | `statusbar` | `false` |
87
+ | `branding` | `false` |
88
+ | `min_height` | `130` |
89
+ | `toolbar_location` | `'bottom'` |
90
+ | `plugins` | `['lists', 'advlist', 'autolink', 'image', 'link', 'autoresize']` |
91
+ | `autoresize_bottom_margin` | `0` |
92
+ | `toolbar` | `'blocks \| bold italic strikethrough \| bullist numlist outdent indent \| link image'` (or `false` when `disabled`) |
93
+ | `paste_data_images` | `true` |
94
+ | `file_picker_types` | `'image'` |
95
+ | `file_picker_callback` | See file picker section below |
96
+ | `content_style` | Theme-aware CSS string (see below) |
97
+ | `placeholder` | `placeholder` prop |
96
98
 
97
99
  ### 6. Theme-Aware Content Style
98
100
 
99
101
  Inject a `content_style` string that uses theme values for the editor body:
102
+
100
103
  ```css
101
104
  body {
102
105
  font-family: <theme.typography.fontFamily>;
@@ -104,24 +107,43 @@ body {
104
107
  color: <theme.palette.text.primary>;
105
108
  background: <theme.palette.background.paper>;
106
109
  }
107
- a { color: <theme.palette.primary.main>; }
108
- h1-h6 { color: <theme.palette.text.primary>; font-family: <theme.typography.fontFamily>; }
109
- blockquote { color: <theme.palette.text.secondary>; border-left: 4px solid <theme.palette.primary.light>; padding-left: 8px; }
110
- ul, ol { color: <theme.palette.text.primary>; }
111
- input, textarea, select {
110
+ a {
111
+ color: <theme.palette.primary.main>;
112
+ }
113
+ h1-h6 {
114
+ color: <theme.palette.text.primary>;
115
+ font-family: <theme.typography.fontFamily>;
116
+ }
117
+ blockquote {
118
+ color: <theme.palette.text.secondary>;
119
+ border-left: 4px solid <theme.palette.primary.light>;
120
+ padding-left: 8px;
121
+ }
122
+ ul,
123
+ ol {
124
+ color: <theme.palette.text.primary>;
125
+ }
126
+ input,
127
+ textarea,
128
+ select {
112
129
  background: <theme.palette.background.paper>;
113
130
  color: <theme.palette.text.primary>;
114
131
  border: 1px solid <theme.palette.divider>;
115
- border-radius: 4px; padding: 6px 10px; font-size: 1em; font-family: inherit;
132
+ border-radius: 4px;
133
+ padding: 6px 10px;
134
+ font-size: 1em;
135
+ font-family: inherit;
116
136
  }
117
137
  .mce-content-body[data-mce-placeholder]:not(.mce-visualblocks)::before {
118
- color: <theme.palette.text.secondary>; opacity: 0.7;
138
+ color: <theme.palette.text.secondary>;
139
+ opacity: 0.7;
119
140
  }
120
141
  ```
121
142
 
122
143
  ### 7. File Picker Callback
123
144
 
124
145
  When a user clicks the image upload in the toolbar:
146
+
125
147
  1. Create a hidden `<input type='file' accept='image/*'>`.
126
148
  2. On file selected: read as DataURL using `FileReader`.
127
149
  3. On `FileReader.load`: create a blob in TinyMCE's blob cache (`editorRef.current.editorUpload.blobCache`), then call `cb(blobInfo.blobUri(), { title: file.name })`.
@@ -130,9 +152,11 @@ When a user clicks the image upload in the toolbar:
130
152
  ### 8. readOnly/disabled Transition (after initial mount)
131
153
 
132
154
  Use `useAfterInitialEffect([readOnly, disabled])` from `@pega/sdk-react`:
155
+
133
156
  ```
134
157
  editorRef?.current.mode.set(readOnly || disabled ? 'readonly' : 'design')
135
158
  ```
159
+
136
160
  This switches the TinyMCE mode without re-mounting the editor.
137
161
 
138
162
  ### 9. Wrapper Structure
@@ -151,14 +175,15 @@ Derived from `RichTextEditor.tsx` makeStyles:
151
175
 
152
176
  ### Label
153
177
 
154
- | Property | Value |
155
- |----------|-------|
156
- | Position | relative |
157
- | Transform | `translate(0, 0px) scale(1)` (non-floating — stays at top) |
158
- | Margin bottom | 5px |
159
- | Color | `theme.palette.text.secondary` |
178
+ | Property | Value |
179
+ | ------------- | ---------------------------------------------------------- |
180
+ | Position | relative |
181
+ | Transform | `translate(0, 0px) scale(1)` (non-floating — stays at top) |
182
+ | Margin bottom | 5px |
183
+ | Color | `theme.palette.text.secondary` |
160
184
 
161
185
  **CSS-only implementation notes:**
186
+
162
187
  - Label: `display: block; font-size: 0.875rem; color: var(--text-secondary); margin-bottom: 5px`.
163
188
  - Editor container: `min-height: 130px; border: 1px solid var(--divider); border-radius: 4px`.
164
189
  - Toolbar (if CSS-only): render buttons at bottom of the editor area.
@@ -188,15 +213,16 @@ Derived from `RichTextEditor.tsx` makeStyles:
188
213
 
189
214
  Listed design systems are examples only.
190
215
 
191
- | Design System | Rich Text Library |
192
- |---|---|
193
- | Default (CSS only) | `contenteditable` div with custom toolbar, or `<textarea>` |
194
- | MUI | TinyMCE (`@tinymce/tinymce-react`) wrapped in `<FormControl>` |
195
- | Ant Design | Quill (`react-quill`) or TinyMCE inside an `<AntForm.Item>` |
196
- | Chakra UI | Quill or Slate.js inside a `<FormControl>` |
197
- | Shadcn/ui | Tiptap (`@tiptap/react`) inside a field wrapper |
216
+ | Design System | Rich Text Library |
217
+ | ------------------ | ------------------------------------------------------------- |
218
+ | Default (CSS only) | `contenteditable` div with custom toolbar, or `<textarea>` |
219
+ | MUI | TinyMCE (`@tinymce/tinymce-react`) wrapped in `<FormControl>` |
220
+ | Ant Design | Quill (`react-quill`) or TinyMCE inside an `<AntForm.Item>` |
221
+ | Chakra UI | Quill or Slate.js inside a `<FormControl>` |
222
+ | Shadcn/ui | Tiptap (`@tiptap/react`) inside a field wrapper |
198
223
 
199
224
  When implementing in a specific design system, map the following:
225
+
200
226
  - `defaultValue` → initial HTML content
201
227
  - `readOnly={true}` → always render as static HTML `<div>` (no editor instance)
202
228
  - `disabled={true}` → editor mounted but read-only (toolbar hidden)
@@ -18,10 +18,10 @@ Renders a titled section of clickable action cards arranged in a responsive CSS
18
18
 
19
19
  ## Props
20
20
 
21
- | Prop | Type | Required | Description |
22
- |------|------|----------|-------------|
23
- | `heading` | `string` | Yes | Section title rendered as an `<h1>` |
24
- | `actions` | `Array<{ label: string; onClick: () => void; icon?: string }>` | No | List of action items; each has a label, click handler, and optional icon URL |
21
+ | Prop | Type | Required | Description |
22
+ | --------- | -------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------- |
23
+ | `heading` | `string` | Yes | Section title rendered as an `<h1>` |
24
+ | `actions` | `Array<{ label: string; onClick: () => void; icon?: string }>` | No | List of action items; each has a label, click handler, and optional icon URL |
25
25
 
26
26
  ## Behavioral Contract
27
27
 
@@ -41,61 +41,62 @@ Derived from `WssQuickCreate.css` and component makeStyles:
41
41
 
42
42
  ### Section Heading
43
43
 
44
- | Property | Value |
45
- |----------|-------|
46
- | Tag | `<h1>` |
47
- | Margin top | 8px |
44
+ | Property | Value |
45
+ | ---------- | ------ |
46
+ | Tag | `<h1>` |
47
+ | Margin top | 8px |
48
48
 
49
49
  ### Action List
50
50
 
51
- | Property | Value |
52
- |----------|-------|
53
- | List style | none |
54
- | Padding | 0 |
55
- | Display | grid |
51
+ | Property | Value |
52
+ | --------------------- | --------------------------------------------------------------------- |
53
+ | List style | none |
54
+ | Padding | 0 |
55
+ | Display | grid |
56
56
  | Grid template columns | `repeat(auto-fit, minmax(min(20ch, 100%), 1fr))` (responsive columns) |
57
- | Gap | 1rem |
57
+ | Gap | 1rem |
58
58
 
59
59
  ### Action Card (`<li>`)
60
60
 
61
- | Property | Value |
62
- |----------|-------|
63
- | Background (light mode) | `var(--link-button-color)` |
64
- | Background (dark mode) | `var(--app-background-color)` |
65
- | Text color | `var(--app-text-color)` |
66
- | Border radius | 16px |
67
- | Border | `1px solid var(--app-primary-color)` |
61
+ | Property | Value |
62
+ | ----------------------- | ------------------------------------ |
63
+ | Background (light mode) | `var(--link-button-color)` |
64
+ | Background (dark mode) | `var(--app-background-color)` |
65
+ | Text color | `var(--app-text-color)` |
66
+ | Border radius | 16px |
67
+ | Border | `1px solid var(--app-primary-color)` |
68
68
 
69
69
  ### Action Button
70
70
 
71
- | Property | Value |
72
- |----------|-------|
73
- | Text transform | capitalize |
74
- | Font size | 16px |
75
- | Color | `var(--app-text-color)` |
76
- | Height | 10rem |
77
- | Width | 100% |
78
- | Background | transparent (inherits card) |
71
+ | Property | Value |
72
+ | -------------- | --------------------------- |
73
+ | Text transform | capitalize |
74
+ | Font size | 16px |
75
+ | Color | `var(--app-text-color)` |
76
+ | Height | 10rem |
77
+ | Width | 100% |
78
+ | Background | transparent (inherits card) |
79
79
 
80
80
  ### Button Inner Span
81
81
 
82
- | Property | Value |
83
- |----------|-------|
84
- | Display | flex |
82
+ | Property | Value |
83
+ | -------------- | ------ |
84
+ | Display | flex |
85
85
  | Flex direction | column |
86
- | Align items | center |
87
- | Gap | 0.5rem |
86
+ | Align items | center |
87
+ | Gap | 0.5rem |
88
88
 
89
89
  ### Icon
90
90
 
91
- | Property | Value |
92
- |----------|-------|
93
- | Flex shrink | 0 |
94
- | Object fit | contain |
95
- | Width | 3rem |
96
- | Height | 3rem |
91
+ | Property | Value |
92
+ | ----------- | ------- |
93
+ | Flex shrink | 0 |
94
+ | Object fit | contain |
95
+ | Width | 3rem |
96
+ | Height | 3rem |
97
97
 
98
98
  **CSS-only implementation notes:**
99
+
99
100
  - Action list: `list-style: none; padding: 0; display: grid; grid-template-columns: repeat(auto-fit, minmax(min(20ch, 100%), 1fr)); gap: 1rem`.
100
101
  - Action card: `background: var(--link-button-color); border-radius: 16px; border: 1px solid var(--app-primary-color); color: var(--app-text-color)`.
101
102
  - Button: `width: 100%; height: 10rem; background: transparent; border: none; cursor: pointer; text-transform: capitalize; font-size: 16px; color: inherit`.
@@ -120,15 +121,16 @@ Derived from `WssQuickCreate.css` and component makeStyles:
120
121
 
121
122
  Listed design systems are examples only.
122
123
 
123
- | Design System | Recommended Component |
124
- |---|---|
125
- | Default (CSS only) | CSS grid `<ul>` + `<button>` cards with flex icon/label layout |
126
- | MUI | `<Button>` inside Grid items; use `makeStyles` or `sx` for card styling |
127
- | Ant Design | `<List>` with `<Card>` items or `<Button>` blocks inside a CSS grid |
128
- | Chakra UI | `<SimpleGrid>` with `<Button>` children; `flexDir='column'` |
129
- | Shadcn/ui | Grid of custom `<Button variant='outline'>` cards |
124
+ | Design System | Recommended Component |
125
+ | ------------------ | ----------------------------------------------------------------------- |
126
+ | Default (CSS only) | CSS grid `<ul>` + `<button>` cards with flex icon/label layout |
127
+ | MUI | `<Button>` inside Grid items; use `makeStyles` or `sx` for card styling |
128
+ | Ant Design | `<List>` with `<Card>` items or `<Button>` blocks inside a CSS grid |
129
+ | Chakra UI | `<SimpleGrid>` with `<Button>` children; `flexDir='column'` |
130
+ | Shadcn/ui | Grid of custom `<Button variant='outline'>` cards |
130
131
 
131
132
  When implementing in a specific design system, map the following:
133
+
132
134
  - Card border/background → design system's card or outlined button variant
133
135
  - Button `onClick` → standard click handler prop
134
136
  - Icon + label stacked layout → `flexDirection: 'column'` button content