@pega/custom-dx-components 26.1.11 → 26.1.12-alpha-0.1

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 (323) hide show
  1. package/README.md +6 -2
  2. package/package.json +44 -61
  3. package/src/ai/README.md +44 -0
  4. package/src/ai/catalog/README.md +133 -0
  5. package/src/ai/catalog/best-practices/README.md +24 -0
  6. package/src/ai/catalog/best-practices/accessibility-for-async-components.md +53 -0
  7. package/src/ai/catalog/best-practices/error-handling-and-resiliency.md +116 -0
  8. package/src/ai/catalog/best-practices/genai-assistant-integration-patterns.md +49 -0
  9. package/src/ai/catalog/best-practices/performance-and-efficiency.md +109 -0
  10. package/src/ai/catalog/best-practices/security-considerations.md +93 -0
  11. package/src/ai/catalog/best-practices/testing-pconnect-components.md +245 -0
  12. package/src/ai/catalog/best-practices/troubleshooting-common-pitfalls.md +132 -0
  13. package/src/ai/catalog/pconnect-assignment-lifecycle/SKILL.md +44 -0
  14. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/README.md +39 -0
  15. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/approval-workflow-decision.md +47 -0
  16. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/attachment-upload.md +45 -0
  17. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/bulk-action-submit.md +50 -0
  18. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/confirm-before-destructive-action.md +43 -0
  19. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/create-and-stage-new-case.md +45 -0
  20. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/graceful-submit-failure.md +39 -0
  21. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/modal-assignment-submit.md +58 -0
  22. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/multi-step-wizard.md +44 -0
  23. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/resolve-or-ignore-duplicate.md +47 -0
  24. package/src/ai/catalog/pconnect-assignment-lifecycle/cookbooks/safe-case-deletion.md +36 -0
  25. package/src/ai/catalog/pconnect-case-collaboration/SKILL.md +42 -0
  26. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/README.md +36 -0
  27. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/look-up-user-details.md +43 -0
  28. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/manage-case-attachments.md +51 -0
  29. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/manage-case-participants.md +52 -0
  30. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/participant-and-follower.md +40 -0
  31. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/post-and-manage-feed.md +50 -0
  32. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/relate-cases.md +35 -0
  33. package/src/ai/catalog/pconnect-case-collaboration/cookbooks/tag-case-and-find-related.md +44 -0
  34. package/src/ai/catalog/pconnect-data-subscriptions/SKILL.md +42 -0
  35. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/README.md +35 -0
  36. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/data-page-subscription-cleanup.md +41 -0
  37. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/publish-and-subscribe-events.md +40 -0
  38. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/pubsub-cleanup.md +38 -0
  39. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/query-paginated-list-data.md +44 -0
  40. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/realtime-case-subscription.md +46 -0
  41. package/src/ai/catalog/pconnect-data-subscriptions/cookbooks/refresh-and-update-data.md +41 -0
  42. package/src/ai/catalog/pconnect-forms-and-fields/SKILL.md +44 -0
  43. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/README.md +36 -0
  44. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/autosave-tracking.md +45 -0
  45. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/cascading-dependent-fields.md +51 -0
  46. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/collect-form-changes-for-manual-save.md +45 -0
  47. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/custom-field-validators.md +44 -0
  48. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/discard-changes-and-reset-form.md +41 -0
  49. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/full-form-validation.md +38 -0
  50. package/src/ai/catalog/pconnect-forms-and-fields/cookbooks/persist-widget-ui-state.md +41 -0
  51. package/src/ai/catalog/pconnect-lists-and-views/SKILL.md +44 -0
  52. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/README.md +35 -0
  53. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/activate-and-switch-container-items.md +52 -0
  54. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/container-item-lifecycle.md +61 -0
  55. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/insert-delete-list-rows.md +40 -0
  56. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/reorder-list-rows.md +39 -0
  57. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/repeating-row-edit.md +39 -0
  58. package/src/ai/catalog/pconnect-lists-and-views/cookbooks/view-personalization.md +60 -0
  59. package/src/ai/catalog/pconnect-navigation-locale-genai/SKILL.md +45 -0
  60. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/README.md +35 -0
  61. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/agent-conversation-for-tasks.md +54 -0
  62. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/bookmarkable-filter-state.md +40 -0
  63. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/deep-link-semantic-url.md +39 -0
  64. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/genai-assistant-conversation.md +43 -0
  65. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/locale-switch-and-relocalize.md +38 -0
  66. package/src/ai/catalog/pconnect-navigation-locale-genai/cookbooks/persist-operator-preferences.md +40 -0
  67. package/src/ai/catalog/references/architecture-overview.md +52 -0
  68. package/src/ai/catalog/references/pconnect-actions-api.md +948 -0
  69. package/src/ai/catalog/references/pconnect-case-info-data-info-localization.md +618 -0
  70. package/src/ai/catalog/references/pconnect-case-validation-utilities.md +238 -0
  71. package/src/ai/catalog/references/pconnect-container-manager.md +215 -0
  72. package/src/ai/catalog/references/pconnect-list-actions.md +250 -0
  73. package/src/ai/catalog/references/pconnect-misc-suggestions-creation.md +231 -0
  74. package/src/ai/catalog/references/pconnect-reference-context-component.md +471 -0
  75. package/src/ai/catalog/references/pconnect-state-config.md +316 -0
  76. package/src/ai/catalog/references/pconnect-validation-api.md +45 -0
  77. package/src/ai/catalog/references/pcore-analytics-genai-details.md +50 -0
  78. package/src/ai/catalog/references/pcore-bootstrap-init-details.md +121 -0
  79. package/src/ai/catalog/references/pcore-bootstrap-registry-routing.md +253 -0
  80. package/src/ai/catalog/references/pcore-case-collaboration-details.md +191 -0
  81. package/src/ai/catalog/references/pcore-case-collaboration-genai.md +264 -0
  82. package/src/ai/catalog/references/pcore-environment-info-details.md +96 -0
  83. package/src/ai/catalog/references/pcore-environment-locale-namespace.md +175 -0
  84. package/src/ai/catalog/references/pcore-messaging-details.md +99 -0
  85. package/src/ai/catalog/references/pcore-misc-details.md +207 -0
  86. package/src/ai/catalog/references/pcore-misc-utilities.md +325 -0
  87. package/src/ai/catalog/references/pcore-rest-data-details.md +164 -0
  88. package/src/ai/catalog/references/pcore-rest-data-messaging.md +308 -0
  89. package/src/ai/catalog/references/pcore-store-context-details.md +40 -0
  90. package/src/ai/catalog/references/pcore-store-context-state.md +130 -0
  91. package/src/ai/index.js +154 -0
  92. package/src/ai/project/.claude/skills/boolean/SKILL.md +43 -0
  93. package/src/ai/project/.claude/skills/case/SKILL.md +58 -0
  94. package/src/ai/project/.claude/skills/create-dx-component/SKILL.md +98 -0
  95. package/src/ai/project/.claude/skills/create-dx-component/assets/PConnProps.d.ts +24 -0
  96. package/src/ai/project/.claude/skills/create-dx-component/assets/create-nonce.ts +5 -0
  97. package/src/ai/project/.claude/skills/create-dx-component/assets/event-utils.ts +18 -0
  98. package/src/ai/project/.claude/skills/create-dx-component/assets/styles.ts +7 -0
  99. package/src/ai/project/.claude/skills/create-dx-component/cookbooks/README.md +28 -0
  100. package/src/ai/project/.claude/skills/create-dx-component/cookbooks/build-a-data-widget.md +281 -0
  101. package/src/ai/project/.claude/skills/create-dx-component/cookbooks/field-with-limits-and-validation.md +156 -0
  102. package/src/ai/project/.claude/skills/create-dx-component/cookbooks/status-badge-field.md +97 -0
  103. package/src/ai/project/.claude/skills/create-dx-component/references/accessibility.md +71 -0
  104. package/src/ai/project/.claude/skills/create-dx-component/references/choosing-type-and-subtype.md +79 -0
  105. package/src/ai/project/.claude/skills/create-dx-component/references/cli-workflow.md +125 -0
  106. package/src/ai/project/.claude/skills/create-dx-component/references/component-patterns.md +241 -0
  107. package/src/ai/project/.claude/skills/create-dx-component/references/config-schema.md +296 -0
  108. package/src/ai/project/.claude/skills/create-dx-component/references/cosmos-components.md +137 -0
  109. package/src/ai/project/.claude/skills/create-dx-component/references/field-behavior.md +155 -0
  110. package/src/ai/project/.claude/skills/create-dx-component/references/field-essentials.md +90 -0
  111. package/src/ai/project/.claude/skills/create-dx-component/references/field-subtypes-extra.md +68 -0
  112. package/src/ai/project/.claude/skills/create-dx-component/references/localization.md +30 -0
  113. package/src/ai/project/.claude/skills/create-dx-component/references/pcore-pconnect-apis.md +77 -0
  114. package/src/ai/project/.claude/skills/create-dx-component/references/presentation-essentials.md +57 -0
  115. package/src/ai/project/.claude/skills/create-dx-component/references/props-contract.md +182 -0
  116. package/src/ai/project/.claude/skills/create-dx-component/references/state-matrix.md +102 -0
  117. package/src/ai/project/.claude/skills/create-dx-component/references/storybook-pattern.md +262 -0
  118. package/src/ai/project/.claude/skills/create-dx-component/references/styles-pattern.md +54 -0
  119. package/src/ai/project/.claude/skills/create-dx-component/references/template-essentials.md +87 -0
  120. package/src/ai/project/.claude/skills/create-dx-component/references/template-patterns.md +131 -0
  121. package/src/ai/project/.claude/skills/create-dx-component/references/test-pattern.md +215 -0
  122. package/src/ai/project/.claude/skills/create-dx-component/references/ui-gallery-reuse.md +93 -0
  123. package/src/ai/project/.claude/skills/create-dx-component/references/widget-essentials.md +84 -0
  124. package/src/ai/project/.claude/skills/create-dx-component/references/widget-patterns.md +164 -0
  125. package/src/ai/project/.claude/skills/currency/SKILL.md +46 -0
  126. package/src/ai/project/.claude/skills/date/SKILL.md +46 -0
  127. package/src/ai/project/.claude/skills/decimal/SKILL.md +49 -0
  128. package/src/ai/project/.claude/skills/details/SKILL.md +60 -0
  129. package/src/ai/project/.claude/skills/email/SKILL.md +42 -0
  130. package/src/ai/project/.claude/skills/field/SKILL.md +68 -0
  131. package/src/ai/project/.claude/skills/form/SKILL.md +51 -0
  132. package/src/ai/project/.claude/skills/generate-component-set/SKILL.md +80 -0
  133. package/src/ai/project/.claude/skills/generate-component-set/component-manifest.json +161 -0
  134. package/src/ai/project/.claude/skills/identify-components/SKILL.md +76 -0
  135. package/src/ai/project/.claude/skills/integer/SKILL.md +45 -0
  136. package/src/ai/project/.claude/skills/page/SKILL.md +60 -0
  137. package/src/ai/project/.claude/skills/page-widget/SKILL.md +55 -0
  138. package/src/ai/project/.claude/skills/percentage/SKILL.md +52 -0
  139. package/src/ai/project/.claude/skills/phone/SKILL.md +44 -0
  140. package/src/ai/project/.claude/skills/picklist/SKILL.md +50 -0
  141. package/src/ai/project/.claude/skills/plan-dx-component/SKILL.md +51 -0
  142. package/src/ai/project/.claude/skills/plan-dx-component/references/design-system-mapping.md +108 -0
  143. package/src/ai/project/.claude/skills/plan-dx-component/references/intake.md +146 -0
  144. package/src/ai/project/.claude/skills/plan-dx-component/references/plan-template.md +76 -0
  145. package/src/ai/project/.claude/skills/plan-dx-component/references/requirements-template.md +88 -0
  146. package/src/ai/project/.claude/skills/presentation/SKILL.md +61 -0
  147. package/src/ai/project/.claude/skills/publish-library/SKILL.md +106 -0
  148. package/src/ai/project/.claude/skills/radiobuttons/SKILL.md +51 -0
  149. package/src/ai/project/.claude/skills/review-component/SKILL.md +49 -0
  150. package/src/ai/project/.claude/skills/review-component/references/checklist.md +77 -0
  151. package/src/ai/project/.claude/skills/template/SKILL.md +60 -0
  152. package/src/ai/project/.claude/skills/text/SKILL.md +45 -0
  153. package/src/ai/project/.claude/skills/update-dx-component/SKILL.md +56 -0
  154. package/src/ai/project/.claude/skills/update-dx-component/references/maintenance.md +43 -0
  155. package/src/ai/project/.claude/skills/url/SKILL.md +46 -0
  156. package/src/ai/project/.claude/skills/validate-component/SKILL.md +78 -0
  157. package/src/ai/project/.claude/skills/validate-component/references/runtime-troubleshooting.md +56 -0
  158. package/src/ai/project/.claude/skills/validate-component/scripts/check-component.mjs +327 -0
  159. package/src/ai/project/.claude/skills/widget/SKILL.md +59 -0
  160. package/src/ai/project/.gemini/settings.json +5 -0
  161. package/src/ai/project/AGENTS.md +74 -0
  162. package/src/ai/readme-section.md +91 -0
  163. package/src/cli.js +48 -7
  164. package/src/constants.js +54 -53
  165. package/src/internal-tests.js +27 -0
  166. package/src/tasks/ai-toggle/index.js +46 -0
  167. package/src/tasks/authenticate/helper.js +38 -38
  168. package/src/tasks/authenticate/index.js +17 -15
  169. package/src/tasks/build-all/helper.js +4 -4
  170. package/src/tasks/build-all/index.js +7 -7
  171. package/src/tasks/build-comp/helper.js +17 -17
  172. package/src/tasks/build-comp/index.js +10 -10
  173. package/src/tasks/build-jest-assets/index.js +7 -9
  174. package/src/tasks/build-lib/helper.js +8 -8
  175. package/src/tasks/build-lib/index.js +8 -8
  176. package/src/tasks/bundle/builder/index.js +9 -12
  177. package/src/tasks/bundle/builder/modules.js +8 -9
  178. package/src/tasks/bundle/builder/paths.js +2 -19
  179. package/src/tasks/bundle/builder/webpack.config.js +60 -77
  180. package/src/tasks/bundle/index.js +8 -8
  181. package/src/tasks/create/index.js +35 -35
  182. package/src/tasks/create/templates/Constellation/Field/Boolean/index.tsx.mustache +1 -36
  183. package/src/tasks/create/templates/Constellation/Field/Date/date.ts.mustache +2 -2
  184. package/src/tasks/create/templates/Constellation/Field/Date/index.tsx.mustache +2 -27
  185. package/src/tasks/create/templates/Constellation/Field/DateTime/date-utils.ts.mustache +2 -2
  186. package/src/tasks/create/templates/Constellation/Field/DateTime/date.ts.mustache +2 -2
  187. package/src/tasks/create/templates/Constellation/Field/DateTime/index.tsx.mustache +2 -35
  188. package/src/tasks/create/templates/Constellation/Field/Decimal/index.tsx.mustache +3 -36
  189. package/src/tasks/create/templates/Constellation/Field/Decimal-Currency/index.tsx.mustache +4 -39
  190. package/src/tasks/create/templates/Constellation/Field/Decimal-Percentage/index.tsx.mustache +4 -53
  191. package/src/tasks/create/templates/Constellation/Field/Icon-Button-URL/index.tsx.mustache +5 -5
  192. package/src/tasks/create/templates/Constellation/Field/Integer/index.tsx.mustache +3 -36
  193. package/src/tasks/create/templates/Constellation/Field/Picklist/index.tsx.mustache +7 -42
  194. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/component-constants.ts +1 -1
  195. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/date.ts.mustache +0 -2
  196. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/embed-utils.ts.mustache +1 -1
  197. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/index.tsx.mustache +11 -11
  198. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/repeat-utils.ts.mustache +3 -13
  199. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/textformat-utils.tsx.mustache +2 -3
  200. package/src/tasks/create/templates/Constellation/Field/Picklist-Autocomplete/utils.ts.mustache +28 -28
  201. package/src/tasks/create/templates/Constellation/Field/Picklist-RadioButtons/index.tsx.mustache +2 -2
  202. package/src/tasks/create/templates/Constellation/Field/Picklist-RadioButtons/textformat-utils.tsx.mustache +2 -3
  203. package/src/tasks/create/templates/Constellation/Field/Text/index.tsx.mustache +4 -33
  204. package/src/tasks/create/templates/Constellation/Field/Text-Email/index.tsx.mustache +3 -33
  205. package/src/tasks/create/templates/Constellation/Field/Text-Input/index.tsx.mustache +3 -31
  206. package/src/tasks/create/templates/Constellation/Field/Text-Paragraph/index.tsx.mustache +3 -31
  207. package/src/tasks/create/templates/Constellation/Field/Text-Phone/index.tsx.mustache +3 -35
  208. package/src/tasks/create/templates/Constellation/Field/Text-URL/index.tsx.mustache +3 -33
  209. package/src/tasks/create/templates/Constellation/Field/Text-URL/text-url.tsx.mustache +2 -3
  210. package/src/tasks/create/templates/Constellation/Field/TimeofDay/index.tsx.mustache +2 -35
  211. package/src/tasks/create/templates/Constellation/Field/TimeofDay/time-of-day.ts.mustache +2 -2
  212. package/src/tasks/create/templates/Constellation/Template/DETAILS/Avatar.tsx.mustache +19 -15
  213. package/src/tasks/create/templates/Constellation/Template/DETAILS/Operator.tsx.mustache +6 -6
  214. package/src/tasks/create/templates/Constellation/Template/DETAILS/demo.stories.tsx.mustache +1 -1
  215. package/src/tasks/create/templates/Constellation/Template/DETAILS/index.tsx.mustache +4 -8
  216. package/src/tasks/create/templates/Constellation/Template/DETAILS/mock.ts.mustache +9 -9
  217. package/src/tasks/create/templates/Constellation/Template/DETAILS/utils.js.mustache +4 -8
  218. package/src/tasks/create/templates/Constellation/Template/DETAILS-region/Avatar.tsx.mustache +19 -15
  219. package/src/tasks/create/templates/Constellation/Template/DETAILS-region/Operator.tsx.mustache +6 -6
  220. package/src/tasks/create/templates/Constellation/Template/DETAILS-region/demo.stories.tsx.mustache +1 -1
  221. package/src/tasks/create/templates/Constellation/Template/DETAILS-region/index.tsx.mustache +1 -1
  222. package/src/tasks/create/templates/Constellation/Template/DETAILS-region/mock.ts.mustache +9 -9
  223. package/src/tasks/create/templates/Constellation/Template/DETAILS-region/utils.ts.mustache +4 -8
  224. package/src/tasks/create/templates/Constellation/Template/FORM/demo.stories.tsx.mustache +8 -8
  225. package/src/tasks/create/templates/Constellation/Template/FORM-region/demo.stories.tsx.mustache +8 -8
  226. package/src/tasks/create/templates/Constellation/Template/PAGE/utils.ts.mustache +4 -9
  227. package/src/tasks/create/templates/Constellation/Widget/CASE/demo.test.tsx.mustache +3 -3
  228. package/src/tasks/create/templates/Constellation/Widget/PAGE-CASE/Avatar.tsx.mustache +19 -14
  229. package/src/tasks/create/templates/Constellation/Widget/PAGE-CASE/Operator.tsx.mustache +6 -6
  230. package/src/tasks/create/templates/Constellation/Widget/PAGE-CASE/index.tsx.mustache +1 -1
  231. package/src/tasks/create/templates/Constellation/Widget/PAGE-CASE/mock.ts.mustache +1 -1
  232. package/src/tasks/create/templates/Launchpad/Field/Icon-Button-URL/index.tsx.mustache +5 -5
  233. package/src/tasks/create/templates/Launchpad/Field/Text-Phone/index.tsx.mustache +3 -35
  234. package/src/tasks/create/templates/Launchpad/Field/__components.md +1 -1
  235. package/src/tasks/create/templates/Launchpad/Template/FORM/demo.stories.tsx.mustache +8 -8
  236. package/src/tasks/create/templates/Launchpad/Template/FORM-region/demo.stories.tsx.mustache +8 -8
  237. package/src/tasks/create/templates/Launchpad/Widget/CASE/demo.test.tsx.mustache +3 -3
  238. package/src/tasks/create/templates/Launchpad/Widget/PAGE-CASE/index.tsx.mustache +1 -1
  239. package/src/tasks/create/templates/Launchpad/Widget/PAGE-CASE/mock.ts.mustache +1 -1
  240. package/src/tasks/create-all/index.js +42 -41
  241. package/src/tasks/create-lib/helper.js +13 -13
  242. package/src/tasks/create-lib/index.js +5 -5
  243. package/src/tasks/create-version/helper.js +10 -10
  244. package/src/tasks/create-version/index.js +3 -4
  245. package/src/tasks/delete/helper.js +20 -19
  246. package/src/tasks/delete/index.js +2 -2
  247. package/src/tasks/delete-all/helper.js +26 -25
  248. package/src/tasks/delete-all/index.js +2 -2
  249. package/src/tasks/delete-lib/helper.js +6 -6
  250. package/src/tasks/delete-lib/index.js +6 -6
  251. package/src/tasks/delete-pub/helper.js +18 -18
  252. package/src/tasks/delete-pub/index.js +8 -8
  253. package/src/tasks/delete-version/index.js +2 -2
  254. package/src/tasks/dev-server/index.js +1 -1
  255. package/src/tasks/export-archive/helper.js +21 -21
  256. package/src/tasks/export-archive/index.js +27 -40
  257. package/src/tasks/export-rc/helper.js +34 -34
  258. package/src/tasks/export-rc/index.js +21 -31
  259. package/src/tasks/import-archive/helper.js +39 -39
  260. package/src/tasks/import-archive/index.js +69 -89
  261. package/src/tasks/import-comp/helper.js +8 -8
  262. package/src/tasks/import-comp/index.js +30 -42
  263. package/src/tasks/index.js +5 -0
  264. package/src/tasks/init/Node.gitignore +149 -0
  265. package/src/tasks/init/helper.js +15 -8
  266. package/src/tasks/init/index.js +115 -35
  267. package/src/tasks/init/template/.prettierrc.json +4 -1
  268. package/src/tasks/init/template/.storybook/main.ts +1 -4
  269. package/src/tasks/init/template/.storybook/manager.ts +1 -1
  270. package/src/tasks/init/template/.storybook/preview.tsx +2 -2
  271. package/src/tasks/init/template/.storybook/theme.js +1 -1
  272. package/src/tasks/init/template/.vscode/extensions.json +0 -1
  273. package/src/tasks/init/template/README.md +2 -2
  274. package/src/tasks/init/template/eslint.config.mjs +13 -155
  275. package/src/tasks/init/template/jest.config.cjs +2 -0
  276. package/src/tasks/init/template/package-lock.json +26864 -0
  277. package/src/tasks/init/template/package.json.mustache +19 -74
  278. package/src/tasks/init/template/setupTests.ts +10 -4
  279. package/src/tasks/init/template/tsconfig.json +14 -6
  280. package/src/tasks/internal-test/index.js +21 -0
  281. package/src/tasks/internal-test-full/index.js +15 -0
  282. package/src/tasks/internal-test-functional/index.js +15 -0
  283. package/src/tasks/internal-test-unit/index.js +13 -0
  284. package/src/tasks/linter/index.js +2 -2
  285. package/src/tasks/list/helper.js +41 -40
  286. package/src/tasks/list/index.js +3 -3
  287. package/src/tasks/list-lib/helper.js +5 -5
  288. package/src/tasks/list-lib/index.js +8 -8
  289. package/src/tasks/list-pub/helper.js +23 -16
  290. package/src/tasks/list-pub/index.js +24 -21
  291. package/src/tasks/move/helper.js +8 -8
  292. package/src/tasks/move/index.js +19 -23
  293. package/src/tasks/promote-webpack/index.js +4 -4
  294. package/src/tasks/promote-webpack/webpack.config.js +62 -93
  295. package/src/tasks/publish/helper.js +21 -21
  296. package/src/tasks/publish/index.js +16 -16
  297. package/src/tasks/publish-all/helper.js +20 -20
  298. package/src/tasks/publish-all/index.js +11 -12
  299. package/src/tasks/publish-archive/helper.js +9 -9
  300. package/src/tasks/publish-archive/index.js +12 -14
  301. package/src/tasks/publish-lib/helper.js +3 -3
  302. package/src/tasks/publish-lib/index.js +28 -34
  303. package/src/tasks/quarantine/index.js +8 -8
  304. package/src/tasks/rename/index.js +26 -30
  305. package/src/tasks/rename-lib/index.js +21 -25
  306. package/src/tasks/restore/index.js +8 -8
  307. package/src/tasks/restore-config/index.js +3 -5
  308. package/src/tasks/set-perm/index.js +8 -8
  309. package/src/tasks/show-help/index.js +17 -9
  310. package/src/tasks/show-status/index.js +2 -2
  311. package/src/tasks/store/index.js +8 -8
  312. package/src/tasks/switch-lib/helper.js +7 -7
  313. package/src/tasks/switch-lib/index.js +7 -7
  314. package/src/tasks/switch-version/helper.js +6 -6
  315. package/src/tasks/switch-version/index.js +7 -7
  316. package/src/tasks/update/index.js +1 -1
  317. package/src/tasks/upgrade/index.js +7 -7
  318. package/src/tasks/validator/index.js +49 -203
  319. package/src/util.js +169 -186
  320. package/src/rules/no-pcore-pconnect-in-presentation.js +0 -103
  321. package/src/tasks/init/template/.stylelintrc.json +0 -4
  322. package/src/tasks/init/template/babel.config.cjs +0 -22
  323. package/src/tasks/init/template/cspell.json +0 -14
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: pconnect-assignment-lifecycle
3
+ description: 'Reference catalog and cookbook for PCore/PConnect APIs governing assignment and case submission lifecycle — ActionsApi, ContainerManager, ValidationApi, AttachmentUtils, ErrorHandler, and ConfirmDialogService — with recipes for opening an assignment in a modal, multi-step wizard navigation, bulk action submit, safe case deletion, custom destructive-action confirmation, attachment upload, graceful submit-failure handling, creating a case and jumping to a stage, approving/rejecting a case, and resolving/ignoring a duplicate case. Use when you need the exact signature for these APIs, or the correct order to call them to open, validate, submit, or delete an assignment/case.'
4
+ user-invocable: true
5
+ argument-hint: 'Use when opening, validating, submitting, or deleting an assignment/case, confirming a destructive action, or uploading an attachment — for the exact ActionsApi/ContainerManager/ValidationApi signature, or the correct call order.'
6
+ metadata:
7
+ verified-against: 'latest 26.x'
8
+ ---
9
+
10
+ # Assignment & Submission Lifecycle — PCore/PConnect Skill
11
+
12
+ This skill covers the PCore/PConnect APIs and recipes for the **assignment and case submission lifecycle**: opening an assignment, validating it, submitting it, deleting a case, confirming a destructive action, and handling attachments. It is one of the PCore/PConnect API skills — see the [skills index](../README.md) for the full method catalog, architecture primer, and the other five skills.
13
+
14
+ ## When to Use This Skill
15
+
16
+ Load this skill when:
17
+
18
+ - You need the exact parameters, return type, or purpose of an `ActionsApi`, `ContainerManager`, `ValidationApi`, `AttachmentUtils`, `ErrorHandler`, or `ConfirmDialogService` method.
19
+ - You're opening an assignment in a modal/container, submitting it, or deleting a case, and need the correct call order.
20
+ - You're building a custom confirmation dialog before a destructive action, or handling a failed submit without losing user edits.
21
+
22
+ If your task is about form/field validation state, cascading fields, or autosave rather than the submit/delete lifecycle itself, see [pconnect-forms-and-fields](../pconnect-forms-and-fields/SKILL.md) instead.
23
+
24
+ New to PCore/PConnect? Start with [Architecture at a Glance](../references/architecture-overview.md).
25
+
26
+ ## Key Reference Files
27
+
28
+ | File | Class(es) | Obtained via |
29
+ | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------- | ----------------------------- |
30
+ | [../references/pconnect-actions-api.md](../references/pconnect-actions-api.md) | `ActionsApi` | `pConn.getActionsApi()` |
31
+ | [../references/pconnect-container-manager.md](../references/pconnect-container-manager.md) | `ContainerManager` | `pConn.getContainerManager()` |
32
+ | [../references/pconnect-validation-api.md](../references/pconnect-validation-api.md) | `ValidationApi` | `pConn.getValidationApi()` |
33
+ | [../references/pcore-case-collaboration-details.md](../references/pcore-case-collaboration-details.md) | `AttachmentUtils` | `PCore.getAttachmentUtils()` |
34
+ | [../references/pcore-misc-details.md](../references/pcore-misc-details.md) | `ErrorHandler`, `FormUtils`, `ConfirmDialogService` | `PCore.get*()` |
35
+
36
+ See the [full reference index](../README.md) for every other PCore/PConnect method not directly related to this skill's topic.
37
+
38
+ ## Cookbooks
39
+
40
+ Multi-method, ordering/cleanup recipes for this skill's topic live in [cookbooks/README.md](./cookbooks/README.md): modal assignment submit, multi-step wizard navigation, bulk action submit, safe case deletion, custom destructive-action confirmation, attachment upload, graceful submit-failure handling, creating a case and jumping to a target stage, approving or rejecting a case, and resolving or ignoring a duplicate case.
41
+
42
+ Use the reference files above for a single method's signature. Use the cookbook index when you need the **order** multiple methods should be called in to complete a task.
43
+
44
+ For testing components that call these APIs, security considerations (attachment uploads, destructive-action confirmation), idempotent/resilient retry and cancellation handling for submits, accessible loading/error states during a submit, or troubleshooting a call that isn't behaving as documented, see [Cross-Cutting Best Practices](../best-practices/README.md).
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: Assignment & Submission Lifecycle Cookbook — Recipe Index
3
+ description: Multi-method recipes for opening, validating, submitting, and deleting assignments/cases, indexed by symptom/keyword and primary method for AI/RAG retrieval.
4
+ ---
5
+
6
+ # Cookbook: Assignment & Submission Lifecycle
7
+
8
+ > Part of the [Assignment & Submission Lifecycle skill](../SKILL.md).
9
+
10
+ Every file in [`../../references/`](../../references/) documents one method at a time. Each file in this folder shows how to **chain multiple documented methods together** to complete one common real-world task. Every recipe only uses methods already cataloged in `references/` — follow the links in each recipe for full signatures. Nothing here invents a new API; every call is a direct composition of already-documented methods.
11
+
12
+ Each recipe is a single, self-contained file with:
13
+
14
+ - YAML frontmatter (`keywords`, `primary_methods`, `related`) for structured/metadata search.
15
+ - A **Problem** statement — what you're trying to accomplish, in plain language.
16
+ - A **Solution** — the minimal correct code, linking to the individual reference files for each method used.
17
+ - A **Discussion** — the ordering/cleanup/gotcha pitfall that makes this worth documenting as a recipe instead of assembling from scratch.
18
+ - **Related recipes** — links to recipes that share a pattern (lifecycle, cleanup, error handling, etc.), including recipes in sibling skills.
19
+
20
+ ## Recipe Index
21
+
22
+ Search by symptom or keyword before assembling a sequence of calls from scratch — there is a good chance the ordering/cleanup pitfalls have already been worked out below.
23
+
24
+ | Recipe | Keywords | Primary methods |
25
+ | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | ------------------------------------------------- |
26
+ | [Modal assignment submit](./modal-assignment-submit.md) | modal, dialog, submit, close, validate before submit, containerItemID | `ContainerManager`, `ActionsApi`, `ValidationApi` |
27
+ | [Multi-step wizard](./multi-step-wizard.md) | stepper, process flow, next/previous, save between steps, finish on last step | `ActionsApi` |
28
+ | [Bulk action submit](./bulk-action-submit.md) | select all, checkbox, mass update, multiple cases | `ListActions`, `ActionsApi` |
29
+ | [Graceful submit failure handling](./graceful-submit-failure.md) | error handling, failed submit, generic error message, rollback | `ErrorHandler`, `FormUtils`, `ActionsApi` |
30
+ | [Custom confirm before a destructive action](./confirm-before-destructive-action.md) | confirm dialog, are you sure, destructive action, custom modal | `ConfirmDialogService` |
31
+ | [Safe case deletion](./safe-case-deletion.md) | delete case, cancel case, remove work object, create stage | `ActionsApi` |
32
+ | [Attachment upload](./attachment-upload.md) | file upload, attach, progress, cancel, category | `AttachmentUtils` |
33
+ | [Create a case and jump to a target stage](./create-and-stage-new-case.md) | create case, new case wizard, skip stage, jump to stage | `ActionsApi` |
34
+ | [Approve or reject a case](./approval-workflow-decision.md) | approval, reject, approve case, sign-off, decision step | `ActionsApi`, `ConfirmDialogService` |
35
+ | [Resolve or ignore a duplicate case](./resolve-or-ignore-duplicate.md) | duplicate case, duplicate detection, merge case, ignore duplicate | `ActionsApi`, `RelatedCasesApi` |
36
+
37
+ Use the individual reference files in [`../../references/`](../../references/) to look up a single method's exact signature. Use a recipe here when you need to know the **order** multiple methods should be called in to complete a task.
38
+
39
+ As more cookbooks are added, add one file per recipe (not more content to an existing recipe file) and a row here — see any existing recipe file for the expected frontmatter/structure.
@@ -0,0 +1,47 @@
1
+ ---
2
+ title: Approve or reject a case in an approval step
3
+ keywords: [approval, reject, approve case, sign-off, decision step]
4
+ primary_methods: [ActionsApi.approveCase, ActionsApi.rejectCase]
5
+ related: [confirm-before-destructive-action, graceful-submit-failure]
6
+ ---
7
+
8
+ # Recipe: Approve or reject a case in an approval step
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ An approval assignment presents two outcomes — approve or reject — and the reject path should ask for confirmation first since it is harder to walk back than an approval.
15
+
16
+ ## Solution
17
+
18
+ Uses [`ActionsApi`](../../references/pconnect-actions-api.md) and, for the confirmation step, [`ConfirmDialogService`](../../references/pcore-misc-details.md).
19
+
20
+ ```typescript
21
+ async function approve(containerItemID) {
22
+ // approveCase both records the decision and finishes the assignment — do not call finishAssignment afterward.
23
+ await pConn.getActionsApi().approveCase(containerItemID);
24
+ }
25
+
26
+ async function rejectWithConfirmation(containerItemID) {
27
+ const confirmed = await PCore.getConfirmDialogService().confirm(
28
+ 'This case will be sent back and cannot be re-approved from this step. Continue?'
29
+ );
30
+
31
+ if (!confirmed) return;
32
+
33
+ // rejectCase also finishes the assignment on its own.
34
+ await pConn.getActionsApi().rejectCase(containerItemID);
35
+ }
36
+ ```
37
+
38
+ ## Discussion
39
+
40
+ **MUST NOT** call `finishAssignment` after `approveCase`/`rejectCase` — both methods already finish the assignment as part of recording the decision; calling `finishAssignment` again submits an already-finished assignment.
41
+
42
+ **SHOULD** gate the reject path behind an explicit confirmation (see [Custom confirm before a destructive action](./confirm-before-destructive-action.md)) since rejection is typically harder to reverse than approval, but treat this as a UX choice, not a requirement of the API itself — the API applies no such distinction.
43
+
44
+ ## Related recipes
45
+
46
+ - [Custom confirm before a destructive action](./confirm-before-destructive-action.md)
47
+ - [Graceful submit failure handling](./graceful-submit-failure.md)
@@ -0,0 +1,45 @@
1
+ ---
2
+ title: Upload a file, attach it to a case, and handle a failed upload
3
+ keywords: [file upload, attach, progress, cancel, category]
4
+ primary_methods:
5
+ [AttachmentUtils.uploadAttachment, AttachmentUtils.linkAttachmentsToCase, AttachmentUtils.cancelRequest]
6
+ related: [graceful-submit-failure]
7
+ ---
8
+
9
+ # Recipe: Upload a file, attach it to a case, and handle a failed upload
10
+
11
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
12
+
13
+ ## Problem
14
+
15
+ A file must be uploaded and linked to a case, with the upload and link steps failing independently and needing different recovery.
16
+
17
+ ## Solution
18
+
19
+ Uses `PCore.getAttachmentUtils()` (see [pcore-case-collaboration-details.md](../../references/pcore-case-collaboration-details.md)).
20
+
21
+ ```typescript
22
+ const { uploadAttachment, linkAttachmentsToCase, cancelRequest } = PCore.getAttachmentUtils();
23
+
24
+ let uploadedFile;
25
+ try {
26
+ uploadedFile = await uploadAttachment(file, onUploadProgress, onUploadError, context);
27
+ } catch {
28
+ // The upload itself failed (network error, size/type rejection) — do not attempt to link.
29
+ return;
30
+ }
31
+
32
+ try {
33
+ await linkAttachmentsToCase(caseID, [uploadedFile], 'File', context);
34
+ } catch {
35
+ // The file uploaded but failed to link — offer a retry for linking only, don't re-upload.
36
+ }
37
+ ```
38
+
39
+ ## Discussion
40
+
41
+ **MUST** call `cancelRequest(fileID)` if the user navigates away or cancels mid-upload, to stop the in-flight request rather than letting it complete and silently discarding the result.
42
+
43
+ ## Related recipes
44
+
45
+ - [Handle a failed submit gracefully](./graceful-submit-failure.md)
@@ -0,0 +1,50 @@
1
+ ---
2
+ title: Bulk-submit selected rows from a list
3
+ keywords: [select all, checkbox, mass update, multiple cases, modal]
4
+ primary_methods: [ListActions.getSelectedRows, ActionsApi.openBulkAction, ListActions.clearSelectedRows]
5
+ related: [repeating-row-edit]
6
+ ---
7
+
8
+ # Recipe: Bulk-submit selected rows from a list
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ A user has selected several rows in a list and needs to submit a bulk action against exactly those rows, then clear the selection.
15
+
16
+ ## Solution
17
+
18
+ Uses [`ListActions`](../../references/pconnect-list-actions.md) and [`ActionsApi`](../../references/pconnect-actions-api.md).
19
+
20
+ ```typescript
21
+ // The typedefs type the result as a bare `object`; with `withPayload` false it is the array of selected row keys.
22
+ const selectedKeys = (await pConn.getListActions().getSelectedRows(false)) as string[];
23
+ // getCaseSummary() is typed `any`; its documented keys are caseID, ID (assignment ID), caseClass, name, urgency, routedTo.
24
+ // Confirm which keys your runtime returns for the bulk context before relying on these names.
25
+ const { ID: bulkContextID, caseTypeID: bulkContextType } = pConn.getCaseSummary();
26
+
27
+ await pConn.getActionsApi().openBulkAction(actionID, {
28
+ selectedList: selectedKeys,
29
+ containerName: 'modal',
30
+ bulkContextID,
31
+ bulkContextType,
32
+ callbacks: {
33
+ submit: async () => {
34
+ await pConn.getListActions().clearSelectedRows();
35
+ }
36
+ }
37
+ });
38
+ ```
39
+
40
+ ## Discussion
41
+
42
+ `getSelectedRows(false)` resolves to a `string[]` of selected row keys, not row objects — pass it straight through as `selectedList`.
43
+
44
+ **NEVER** call `submitBulkAction` directly with the selected keys — `openBulkAction` opens the bulk-action modal and registers `submitBulkAction`/`submitBulkActionAsync` on its own submit button internally, and `submitBulkAction` only accepts a single `containerItemID` string established by the opened bulk-action context.
45
+
46
+ **MUST** clear the selection inside the `submit` callback, which only fires once the platform confirms the bulk action was submitted.
47
+
48
+ ## Related recipes
49
+
50
+ - [Edit a repeating row with validation, then save](../../pconnect-lists-and-views/cookbooks/repeating-row-edit.md)
@@ -0,0 +1,43 @@
1
+ ---
2
+ title: Show a custom confirmation dialog before a destructive action
3
+ keywords: [confirm dialog, are you sure, destructive action, custom modal, delete attachment, remove participant]
4
+ primary_methods: [ConfirmDialogService.registerConfirmHandler, ConfirmDialogService.confirm]
5
+ related: [safe-case-deletion, graceful-submit-failure]
6
+ ---
7
+
8
+ # Recipe: Show a custom confirmation dialog before a destructive action
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ An action like deleting an attachment or removing a participant has no built-in confirmation prompt, and the app wants its own styled confirm dialog — not the native browser `confirm()` — shown consistently before that action runs.
15
+
16
+ ## Solution
17
+
18
+ Uses `ConfirmDialogService` (via `PCore.getConfirmDialogService()`, see [pcore-misc-details.md](../../references/pcore-misc-details.md)).
19
+
20
+ ```typescript
21
+ // Register once, near app bootstrap.
22
+ PCore.getConfirmDialogService().registerConfirmHandler((message) => showCustomConfirmModal(message));
23
+
24
+ // At the call site of the destructive action:
25
+ async function onRemoveAttachment(attachmentID: string, context: string) {
26
+ const confirmed = await PCore.getConfirmDialogService().confirm(
27
+ 'This attachment will be permanently removed. Continue?'
28
+ );
29
+ if (!confirmed) return;
30
+ await PCore.getAttachmentUtils().deleteAttachment(attachmentID, context);
31
+ }
32
+ ```
33
+
34
+ ## Discussion
35
+
36
+ `registerConfirmHandler` is global and last-write-wins. **NEVER** register it per-component — registering a second handler elsewhere in the app (for example, from another custom component) silently replaces the first. **ALWAYS** register it once during bootstrap instead.
37
+
38
+ If no handler is ever registered, `confirm()` falls back to the native browser `confirm()` dialog — a missing registration won't crash the destructive action, but it does surface an inconsistent, unstyled prompt instead of failing loudly.
39
+
40
+ ## Related recipes
41
+
42
+ - [Delete a case safely (create stage vs. an existing work object)](./safe-case-deletion.md)
43
+ - [Handle a failed submit gracefully](./graceful-submit-failure.md)
@@ -0,0 +1,45 @@
1
+ ---
2
+ title: Create a new case and jump directly to a target stage
3
+ keywords: [create case, new case wizard, skip stage, jump to stage, case creation]
4
+ primary_methods: [ActionsApi.createWork, ActionsApi.openStage, ActionsApi.finishAssignment]
5
+ related: [multi-step-wizard, modal-assignment-submit]
6
+ ---
7
+
8
+ # Recipe: Create a new case and jump directly to a target stage
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ A "create case" affordance needs to create the case with some starting field values already known (for example, a case created from a picklist selection), then skip straight to a later stage instead of showing the case's default first stage.
15
+
16
+ ## Solution
17
+
18
+ Uses [`ActionsApi`](../../references/pconnect-actions-api.md).
19
+
20
+ ```typescript
21
+ async function createCaseAtStage(className, startingFields, targetStageID) {
22
+ await pConn.getActionsApi().createWork(className, {
23
+ containerName: 'primary',
24
+ startingFields
25
+ });
26
+
27
+ // Only call openStage if the target stage differs from the case's default starting stage.
28
+ await pConn.getActionsApi().openStage(targetStageID);
29
+ }
30
+
31
+ async function finishCurrentStageAssignment(containerItemID) {
32
+ await pConn.getActionsApi().finishAssignment(containerItemID);
33
+ }
34
+ ```
35
+
36
+ ## Discussion
37
+
38
+ **MUST NOT** assume `createWork` alone lands the user on the desired stage — it always opens the case's configured first assignment. Call `openStage` afterward only when the target stage is known to differ from that default; calling it unconditionally on every creation adds a redundant navigation round trip.
39
+
40
+ **MUST** treat `openStage` as a navigation call only — it does not submit or skip validation for stages in between. Any stage-entry data still needs to be collected and submitted through its own assignment(s).
41
+
42
+ ## Related recipes
43
+
44
+ - [Multi-step wizard navigation with per-step save and final submit](./multi-step-wizard.md)
45
+ - [Open an assignment in a modal, edit, validate, submit, and close](./modal-assignment-submit.md)
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: Handle a failed submit gracefully
3
+ keywords: [error handling, failed submit, generic error message, rollback]
4
+ primary_methods: [ErrorHandler.setGenericFailedMessage, ActionsApi.finishAssignment, FormUtils.getChanges]
5
+ related: [modal-assignment-submit, attachment-upload]
6
+ ---
7
+
8
+ # Recipe: Handle a failed submit gracefully
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ A submit call can fail server-side, and the user's in-progress edits must not be lost or silently discarded when that happens.
15
+
16
+ ## Solution
17
+
18
+ Uses `ErrorHandler` and `FormUtils` (both via `PCore.get*()`, see [pcore-misc-details.md](../../references/pcore-misc-details.md)) together with [`ActionsApi`](../../references/pconnect-actions-api.md).
19
+
20
+ ```typescript
21
+ PCore.getErrorHandler().setGenericFailedMessage('We could not save your changes. Please try again.');
22
+
23
+ try {
24
+ await pConn.getActionsApi().finishAssignment(containerItemID);
25
+ } catch (error) {
26
+ // The assignment stays open and dirty — surface the changed fields so the user doesn't lose them.
27
+ const changedFields = PCore.getFormUtils().getChanges(context);
28
+ showRetryBanner(changedFields);
29
+ }
30
+ ```
31
+
32
+ ## Discussion
33
+
34
+ **NEVER** remove the container item or navigate away in the `catch` block — the whole point of leaving the assignment open is so the user's in-progress edits (tracked via `getChanges`) are not lost.
35
+
36
+ ## Related recipes
37
+
38
+ - [Open an assignment in a modal, edit, validate, submit, and close](./modal-assignment-submit.md)
39
+ - [Upload a file, attach it to a case, and handle a failed upload](./attachment-upload.md)
@@ -0,0 +1,58 @@
1
+ ---
2
+ title: Open an assignment in a modal, edit, validate, submit, and close
3
+ keywords: [modal, dialog, submit, close, validate before submit, containerItemID]
4
+ primary_methods:
5
+ [
6
+ ContainerManager.addContainerItem,
7
+ ActionsApi.openAssignment,
8
+ ValidationApi.validateEmail,
9
+ ActionsApi.finishAssignment,
10
+ ContainerManager.removeContainerItem
11
+ ]
12
+ related: [full-form-validation, multi-step-wizard, graceful-submit-failure, safe-case-deletion]
13
+ ---
14
+
15
+ # Recipe: Open an assignment in a modal, edit, validate, submit, and close
16
+
17
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
18
+
19
+ ## Problem
20
+
21
+ An assignment needs to open in a modal region, let the user edit a field, and only submit (and close the modal) once that field is valid.
22
+
23
+ ## Solution
24
+
25
+ Uses [`ContainerManager`](../../references/pconnect-container-manager.md), [`ValidationApi`](../../references/pconnect-validation-api.md), and [`ActionsApi`](../../references/pconnect-actions-api.md).
26
+
27
+ ```typescript
28
+ const containerManager = pConn.getContainerManager();
29
+
30
+ // 1. Add a container item to host the assignment in a modal region. addContainerItem's promise
31
+ // resolves with null, not the container item — pass an explicit ID so it can be reused below.
32
+ const containerItemID = `modalAssignment_${assignmentID}`;
33
+ await containerManager.addContainerItem({ containerItemID, context, semanticURL: '' });
34
+
35
+ // 2. Load the assignment into that container item.
36
+ await pConn.getActionsApi().openAssignment(assignmentID, className, { containerName: 'modal' });
37
+
38
+ // 3. Validate a field before allowing submission.
39
+ const emailCheck = pConn.getValidationApi().validateEmail(emailValue);
40
+ if (emailCheck.status === 'failure') {
41
+ // Surface emailCheck.message next to the field and stop here.
42
+ } else {
43
+ // 4. Submit and close the modal.
44
+ await pConn.getActionsApi().finishAssignment(containerItemID);
45
+ await containerManager.removeContainerItem({ containerItemID });
46
+ }
47
+ ```
48
+
49
+ ## Discussion
50
+
51
+ **MUST:** call `finishAssignment` before `removeContainerItem`. `finishAssignment` submits server-side; NEVER remove the container item first — doing so closes the modal before you know whether the submission succeeded.
52
+
53
+ ## Related recipes
54
+
55
+ - [Validate an entire form before allowing submit](../../pconnect-forms-and-fields/cookbooks/full-form-validation.md)
56
+ - [Multi-step wizard navigation with per-step save and final submit](./multi-step-wizard.md)
57
+ - [Handle a failed submit gracefully](./graceful-submit-failure.md)
58
+ - [Delete a case safely (create stage vs. an existing work object)](./safe-case-deletion.md)
@@ -0,0 +1,44 @@
1
+ ---
2
+ title: Multi-step wizard navigation with per-step save and final submit
3
+ keywords: [stepper, process flow, next/previous, save between steps, finish on last step]
4
+ primary_methods: [ActionsApi.saveAssignment, ActionsApi.finishAssignment, ActionsApi.navigateToStep]
5
+ related: [modal-assignment-submit, full-form-validation]
6
+ ---
7
+
8
+ # Recipe: Multi-step wizard navigation with per-step save and final submit
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ A multi-step process needs to persist each step's data as the user advances, but only actually submit the assignment on the final step.
15
+
16
+ ## Solution
17
+
18
+ Uses [`ActionsApi`](../../references/pconnect-actions-api.md).
19
+
20
+ ```typescript
21
+ async function goToNextStep(containerItemID, stepID, isLastStep) {
22
+ // Persist the current step's data before moving on, without submitting the assignment.
23
+ await pConn.getActionsApi().saveAssignment(containerItemID);
24
+
25
+ if (isLastStep) {
26
+ await pConn.getActionsApi().finishAssignment(containerItemID);
27
+ } else {
28
+ await pConn.getActionsApi().navigateToStep(stepID, containerItemID);
29
+ }
30
+ }
31
+
32
+ async function goToPreviousStep(containerItemID) {
33
+ await pConn.getActionsApi().navigateToStep('previous', containerItemID);
34
+ }
35
+ ```
36
+
37
+ ## Discussion
38
+
39
+ **NEVER** call `finishAssignment` on every step — it MUST only be called on the last step; intermediate steps MUST save (`saveAssignment`) without submitting.
40
+
41
+ ## Related recipes
42
+
43
+ - [Open an assignment in a modal, edit, validate, submit, and close](./modal-assignment-submit.md)
44
+ - [Validate an entire form before allowing submit](../../pconnect-forms-and-fields/cookbooks/full-form-validation.md)
@@ -0,0 +1,47 @@
1
+ ---
2
+ title: Resolve or ignore a detected duplicate case
3
+ keywords: [duplicate case, duplicate detection, merge case, ignore duplicate]
4
+ primary_methods: [ActionsApi.resolveDuplicateCase, ActionsApi.ignoreDuplicateCase]
5
+ related: [relate-cases]
6
+ ---
7
+
8
+ # Recipe: Resolve or ignore a detected duplicate case
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ During case creation, the application flags a possible duplicate and presents an assignment asking the user to either resolve it (treat the duplicate as handled) or ignore the warning and continue with the new case as-is.
15
+
16
+ ## Solution
17
+
18
+ Uses [`ActionsApi`](../../references/pconnect-actions-api.md).
19
+
20
+ ```typescript
21
+ async function resolveDuplicate(containerItemID) {
22
+ // Also finishes the assignment — do not call finishAssignment afterward.
23
+ await pConn.getActionsApi().resolveDuplicateCase(containerItemID);
24
+ }
25
+
26
+ async function ignoreDuplicateAndContinue(containerItemID) {
27
+ // Also finishes the assignment — do not call finishAssignment afterward.
28
+ await pConn.getActionsApi().ignoreDuplicateCase(containerItemID);
29
+ }
30
+ ```
31
+
32
+ If the user instead wants to keep both cases as distinct but linked records (rather than treating one as resolved), relate them explicitly instead of using either duplicate-decision method:
33
+
34
+ ```typescript
35
+ const { addRelatedCases } = PCore.getRelatedCasesApi();
36
+ await addRelatedCases(caseID, [{ caseID: duplicateCaseID }], context);
37
+ ```
38
+
39
+ ## Discussion
40
+
41
+ **MUST NOT** call `finishAssignment` after `resolveDuplicateCase`/`ignoreDuplicateCase` — both already finish the assignment as part of recording the decision.
42
+
43
+ **MUST** pick one path per duplicate warning — resolving/ignoring a duplicate is a distinct decision from relating two cases together via [`RelatedCasesApi`](../../pconnect-case-collaboration/cookbooks/relate-cases.md); do not call both for the same pair of cases unless the business process genuinely calls for the case to be both linked and marked resolved.
44
+
45
+ ## Related recipes
46
+
47
+ - [Relate two cases together and confirm the relationship](../../pconnect-case-collaboration/cookbooks/relate-cases.md)
@@ -0,0 +1,36 @@
1
+ ---
2
+ title: Delete a case safely (create stage vs. an existing work object)
3
+ keywords: [delete case, cancel case, remove work object, create stage]
4
+ primary_methods: [ActionsApi.deleteCaseInCreateStage, ActionsApi.deleteWork]
5
+ related: [modal-assignment-submit]
6
+ ---
7
+
8
+ # Recipe: Delete a case safely (create stage vs. an existing work object)
9
+
10
+ > Part of the [Assignment & Submission Lifecycle cookbook](./README.md) — [skill overview](../SKILL.md).
11
+
12
+ ## Problem
13
+
14
+ A case needs to be deleted, but which `ActionsApi` method to call depends on whether the case has already left its create stage.
15
+
16
+ ## Solution
17
+
18
+ Uses [`ActionsApi`](../../references/pconnect-actions-api.md).
19
+
20
+ ```typescript
21
+ if (isInCreateStage) {
22
+ // The case has no confirmed ID yet — use the create-stage-specific delete.
23
+ await pConn.getActionsApi().deleteCaseInCreateStage(containerItemID);
24
+ } else {
25
+ // The case is already persisted — use deleteWork, which shows a confirmation dialog by default.
26
+ await pConn.getActionsApi().deleteWork(workId, caseTypeID);
27
+ }
28
+ ```
29
+
30
+ ## Discussion
31
+
32
+ **NEVER** call `deleteWork` on a case still in its create stage, or `deleteCaseInCreateStage` on an already-persisted case — there is no single `deleteCase()` method that handles both, and calling the wrong one for the case's stage is a common mistake.
33
+
34
+ ## Related recipes
35
+
36
+ - [Open an assignment in a modal, edit, validate, submit, and close](./modal-assignment-submit.md)
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: pconnect-case-collaboration
3
+ description: 'Reference catalog and cookbook for PCore/PConnect APIs governing case collaboration and relationships — StakeholderUtils, CaseFollowerApi, RelatedCasesApi, TagUtils, FeedUtils, AttachmentUtils, and UserApi — with recipes for adding a participant and follower, relating two cases, tagging a case to find related cases, listing/updating participants, posting and managing feed messages, listing/editing/deleting attachments, and looking up operator details. Use when you need the exact signature for these APIs, or the correct order to call them to manage participants, relationships, feed messages, attachments, or tags on a case.'
4
+ user-invocable: true
5
+ argument-hint: 'Use when adding a participant/follower to a case, relating two cases, or tagging a case to find similar ones — for the exact StakeholderUtils/CaseFollowerApi/RelatedCasesApi/TagUtils signature, or the correct call order.'
6
+ metadata:
7
+ verified-against: 'latest 26.x'
8
+ ---
9
+
10
+ # Case Collaboration & Relationships — PCore/PConnect Skill
11
+
12
+ This skill covers the PCore/PConnect APIs and recipes for **case collaboration and relationships**: participants, followers, related cases, and tags. It is one of the PCore/PConnect API skills — see the [skills index](../README.md) for the full method catalog, architecture primer, and the other five skills.
13
+
14
+ ## When to Use This Skill
15
+
16
+ Load this skill when:
17
+
18
+ - You need the exact parameters, return type, or purpose of a `StakeholderUtils`, `CaseFollowerApi`, `RelatedCasesApi`, or `TagUtils` method.
19
+ - You're adding a user to a case in a role and/or as a follower.
20
+ - You're linking two cases together, or applying an informal tag/label and browsing other cases sharing it.
21
+
22
+ If your task is about the case's own submission/deletion lifecycle rather than its participants or relationships, see [pconnect-assignment-lifecycle](../pconnect-assignment-lifecycle/SKILL.md) instead.
23
+
24
+ New to PCore/PConnect? Start with [Architecture at a Glance](../references/architecture-overview.md).
25
+
26
+ ## Key Reference Files
27
+
28
+ | File | Class(es) | Obtained via |
29
+ | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- | --------------------- |
30
+ | [../references/pcore-case-collaboration-details.md](../references/pcore-case-collaboration-details.md) | `StakeholderUtils`, `CaseFollowerApi`, `RelatedCasesApi`, `TagUtils` | `PCore.get*()` |
31
+ | [../references/pcore-case-collaboration-genai.md](../references/pcore-case-collaboration-genai.md) | Stakeholders, tags, related cases (accessor-level) | `PCore.get*()` |
32
+ | [../references/pconnect-case-info-data-info-localization.md](../references/pconnect-case-info-data-info-localization.md) | `CaseInfo` | `pConn.getCaseInfo()` |
33
+
34
+ See the [full reference index](../README.md) for every other PCore/PConnect method not directly related to this skill's topic.
35
+
36
+ ## Cookbooks
37
+
38
+ Multi-method, ordering/cleanup recipes for this skill's topic live in [cookbooks/README.md](./cookbooks/README.md): adding a participant and follower, relating two cases, tagging a case to find related cases, listing/looking up/updating participants, posting and managing feed messages, listing/editing/deleting existing attachments, and looking up operator details.
39
+
40
+ Use the reference files above for a single method's signature. Use the cookbook index when you need the **order** multiple methods should be called in to complete a task.
41
+
42
+ For testing components that call these APIs, security considerations (sanitizing rendered feed/comment content), performance (avoiding redundant tag/related-case lookups), announcing feed/stakeholder updates accessibly, or troubleshooting a call that isn't behaving as documented, see [Cross-Cutting Best Practices](../best-practices/README.md).
@@ -0,0 +1,36 @@
1
+ ---
2
+ title: Case Collaboration & Relationships Cookbook — Recipe Index
3
+ description: Multi-method recipes for participants, followers, related cases, and tags, indexed by symptom/keyword and primary method for AI/RAG retrieval.
4
+ ---
5
+
6
+ # Cookbook: Case Collaboration & Relationships
7
+
8
+ > Part of the [Case Collaboration & Relationships skill](../SKILL.md).
9
+
10
+ Every file in [`../../references/`](../../references/) documents one method at a time. Each file in this folder shows how to **chain multiple documented methods together** to complete one common real-world task. Every recipe only uses methods already cataloged in `references/` — follow the links in each recipe for full signatures. Nothing here invents a new API; every call is a direct composition of already-documented methods.
11
+
12
+ Each recipe is a single, self-contained file with:
13
+
14
+ - YAML frontmatter (`keywords`, `primary_methods`, `related`) for structured/metadata search.
15
+ - A **Problem** statement — what you're trying to accomplish, in plain language.
16
+ - A **Solution** — the minimal correct code, linking to the individual reference files for each method used.
17
+ - A **Discussion** — the ordering/cleanup/gotcha pitfall that makes this worth documenting as a recipe instead of assembling from scratch.
18
+ - **Related recipes** — links to recipes that share a pattern (lifecycle, cleanup, error handling, etc.), including recipes in sibling skills.
19
+
20
+ ## Recipe Index
21
+
22
+ Search by symptom or keyword before assembling a sequence of calls from scratch — there is a good chance the ordering/cleanup pitfalls have already been worked out below.
23
+
24
+ | Recipe | Keywords | Primary methods |
25
+ | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------- |
26
+ | [Add a participant and follower](./participant-and-follower.md) | stakeholder, participant, role, follower, notify a user | `StakeholderUtils`, `CaseFollowerApi` |
27
+ | [Relate two cases](./relate-cases.md) | related case, link cases, case relationship | `RelatedCasesApi` |
28
+ | [Tag a case and find related cases](./tag-case-and-find-related.md) | tag, label, categorize case, find similar cases, tags landing page | `TagUtils` |
29
+ | [List, look up, and update participants](./manage-case-participants.md) | participants list, stakeholder list, team panel, participant roles, edit participant | `StakeholderUtils` |
30
+ | [Post, edit, and delete feed messages](./post-and-manage-feed.md) | feed, pulse, comment, post message, discussion, reply | `FeedUtils` |
31
+ | [List, edit, and delete existing attachments](./manage-case-attachments.md) | attachment list, attachment panel, edit attachment, delete attachment, attachment categories | `AttachmentUtils` |
32
+ | [Look up operator details](./look-up-user-details.md) | operator lookup, user profile, glimpse, avatar, display name | `UserApi` |
33
+
34
+ Use the individual reference files in [`../../references/`](../../references/) to look up a single method's exact signature. Use a recipe here when you need to know the **order** multiple methods should be called in to complete a task.
35
+
36
+ As more cookbooks are added, add one file per recipe (not more content to an existing recipe file) and a row here — see any existing recipe file for the expected frontmatter/structure.