@salesforce/afv-skills 1.14.0 → 1.15.0

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 (332) hide show
  1. package/package.json +1 -1
  2. package/skills/applying-slds/SKILL.md +322 -0
  3. package/skills/applying-slds/checklists.md +83 -0
  4. package/skills/applying-slds/examples.md +283 -0
  5. package/skills/applying-slds/guidance/README.md +83 -0
  6. package/skills/applying-slds/guidance/blueprints-index.md +213 -0
  7. package/skills/applying-slds/guidance/icons-guidance.md +186 -0
  8. package/skills/applying-slds/guidance/overviews/borders.md +236 -0
  9. package/skills/applying-slds/guidance/overviews/color.md +266 -0
  10. package/skills/applying-slds/guidance/overviews/display-density.md +366 -0
  11. package/skills/applying-slds/guidance/overviews/icons.md +240 -0
  12. package/skills/applying-slds/guidance/overviews/illustrations.md +235 -0
  13. package/skills/applying-slds/guidance/overviews/shadows.md +176 -0
  14. package/skills/applying-slds/guidance/overviews/spacing.md +216 -0
  15. package/skills/applying-slds/guidance/overviews/typography.md +323 -0
  16. package/skills/applying-slds/guidance/overviews/utilities.md +542 -0
  17. package/skills/applying-slds/guidance/slds-development-guide.md +288 -0
  18. package/skills/applying-slds/guidance/styling-hooks/borders.md +202 -0
  19. package/skills/applying-slds/guidance/styling-hooks/color/expressive-palette-hooks.md +153 -0
  20. package/skills/applying-slds/guidance/styling-hooks/color/index.md +171 -0
  21. package/skills/applying-slds/guidance/styling-hooks/color/semantic/accent-hooks.md +204 -0
  22. package/skills/applying-slds/guidance/styling-hooks/color/semantic/feedback-hooks.md +768 -0
  23. package/skills/applying-slds/guidance/styling-hooks/color/semantic/surface-hooks.md +337 -0
  24. package/skills/applying-slds/guidance/styling-hooks/color/system-hooks.md +132 -0
  25. package/skills/applying-slds/guidance/styling-hooks/index.md +327 -0
  26. package/skills/applying-slds/guidance/styling-hooks/shadows.md +238 -0
  27. package/skills/applying-slds/guidance/styling-hooks/spacing.md +254 -0
  28. package/skills/applying-slds/guidance/styling-hooks/typography.md +448 -0
  29. package/skills/applying-slds/guidance/utilities/alignment.md +119 -0
  30. package/skills/applying-slds/guidance/utilities/borders.md +131 -0
  31. package/skills/applying-slds/guidance/utilities/box.md +125 -0
  32. package/skills/applying-slds/guidance/utilities/color.md +165 -0
  33. package/skills/applying-slds/guidance/utilities/dark-mode.md +111 -0
  34. package/skills/applying-slds/guidance/utilities/description-list.md +168 -0
  35. package/skills/applying-slds/guidance/utilities/floats.md +117 -0
  36. package/skills/applying-slds/guidance/utilities/grid.md +264 -0
  37. package/skills/applying-slds/guidance/utilities/horizontal-list.md +110 -0
  38. package/skills/applying-slds/guidance/utilities/hyphenation.md +84 -0
  39. package/skills/applying-slds/guidance/utilities/index.md +205 -0
  40. package/skills/applying-slds/guidance/utilities/interactions.md +89 -0
  41. package/skills/applying-slds/guidance/utilities/layout.md +109 -0
  42. package/skills/applying-slds/guidance/utilities/line-clamp.md +131 -0
  43. package/skills/applying-slds/guidance/utilities/margin.md +155 -0
  44. package/skills/applying-slds/guidance/utilities/media-object.md +161 -0
  45. package/skills/applying-slds/guidance/utilities/name-value-list.md +152 -0
  46. package/skills/applying-slds/guidance/utilities/padding.md +155 -0
  47. package/skills/applying-slds/guidance/utilities/position.md +177 -0
  48. package/skills/applying-slds/guidance/utilities/print.md +114 -0
  49. package/skills/applying-slds/guidance/utilities/scrollable.md +126 -0
  50. package/skills/applying-slds/guidance/utilities/sizing.md +190 -0
  51. package/skills/applying-slds/guidance/utilities/themes.md +121 -0
  52. package/skills/applying-slds/guidance/utilities/truncate.md +127 -0
  53. package/skills/applying-slds/guidance/utilities/typography.md +166 -0
  54. package/skills/applying-slds/guidance/utilities/vertical-list.md +166 -0
  55. package/skills/applying-slds/guidance/utilities/visibility.md +228 -0
  56. package/skills/applying-slds/metadata/README.md +84 -0
  57. package/skills/applying-slds/metadata/blueprints/components/accordion.yaml +304 -0
  58. package/skills/applying-slds/metadata/blueprints/components/activity-timeline.yaml +92 -0
  59. package/skills/applying-slds/metadata/blueprints/components/alert.yaml +103 -0
  60. package/skills/applying-slds/metadata/blueprints/components/app-launcher.yaml +94 -0
  61. package/skills/applying-slds/metadata/blueprints/components/avatar-group.yaml +81 -0
  62. package/skills/applying-slds/metadata/blueprints/components/avatar.yaml +97 -0
  63. package/skills/applying-slds/metadata/blueprints/components/badges.yaml +102 -0
  64. package/skills/applying-slds/metadata/blueprints/components/brand-band.yaml +198 -0
  65. package/skills/applying-slds/metadata/blueprints/components/breadcrumbs.yaml +95 -0
  66. package/skills/applying-slds/metadata/blueprints/components/builder-header.yaml +192 -0
  67. package/skills/applying-slds/metadata/blueprints/components/button-groups.yaml +82 -0
  68. package/skills/applying-slds/metadata/blueprints/components/button-icons.yaml +295 -0
  69. package/skills/applying-slds/metadata/blueprints/components/buttons.yaml +230 -0
  70. package/skills/applying-slds/metadata/blueprints/components/cards.yaml +124 -0
  71. package/skills/applying-slds/metadata/blueprints/components/carousel.yaml +140 -0
  72. package/skills/applying-slds/metadata/blueprints/components/chat.yaml +179 -0
  73. package/skills/applying-slds/metadata/blueprints/components/checkbox-button-group.yaml +192 -0
  74. package/skills/applying-slds/metadata/blueprints/components/checkbox-button.yaml +204 -0
  75. package/skills/applying-slds/metadata/blueprints/components/checkbox-toggle.yaml +177 -0
  76. package/skills/applying-slds/metadata/blueprints/components/checkbox.yaml +108 -0
  77. package/skills/applying-slds/metadata/blueprints/components/color-picker.yaml +172 -0
  78. package/skills/applying-slds/metadata/blueprints/components/combobox.yaml +136 -0
  79. package/skills/applying-slds/metadata/blueprints/components/counter.yaml +147 -0
  80. package/skills/applying-slds/metadata/blueprints/components/data-tables.yaml +157 -0
  81. package/skills/applying-slds/metadata/blueprints/components/datepickers.yaml +130 -0
  82. package/skills/applying-slds/metadata/blueprints/components/datetime-picker.yaml +155 -0
  83. package/skills/applying-slds/metadata/blueprints/components/docked-composer.yaml +201 -0
  84. package/skills/applying-slds/metadata/blueprints/components/docked-form-footer.yaml +161 -0
  85. package/skills/applying-slds/metadata/blueprints/components/docked-utility-bar.yaml +175 -0
  86. package/skills/applying-slds/metadata/blueprints/components/drop-zone.yaml +115 -0
  87. package/skills/applying-slds/metadata/blueprints/components/dueling-picklist.yaml +196 -0
  88. package/skills/applying-slds/metadata/blueprints/components/dynamic-icons.yaml +128 -0
  89. package/skills/applying-slds/metadata/blueprints/components/dynamic-menu.yaml +141 -0
  90. package/skills/applying-slds/metadata/blueprints/components/expandable-section.yaml +115 -0
  91. package/skills/applying-slds/metadata/blueprints/components/expression.yaml +143 -0
  92. package/skills/applying-slds/metadata/blueprints/components/feeds.yaml +125 -0
  93. package/skills/applying-slds/metadata/blueprints/components/file-selector.yaml +154 -0
  94. package/skills/applying-slds/metadata/blueprints/components/files.yaml +119 -0
  95. package/skills/applying-slds/metadata/blueprints/components/form-element.yaml +145 -0
  96. package/skills/applying-slds/metadata/blueprints/components/global-header.yaml +120 -0
  97. package/skills/applying-slds/metadata/blueprints/components/global-navigation.yaml +100 -0
  98. package/skills/applying-slds/metadata/blueprints/components/icons.yaml +138 -0
  99. package/skills/applying-slds/metadata/blueprints/components/illustration.yaml +205 -0
  100. package/skills/applying-slds/metadata/blueprints/components/input.yaml +151 -0
  101. package/skills/applying-slds/metadata/blueprints/components/list-builder.yaml +127 -0
  102. package/skills/applying-slds/metadata/blueprints/components/lookups.yaml +132 -0
  103. package/skills/applying-slds/metadata/blueprints/components/map.yaml +118 -0
  104. package/skills/applying-slds/metadata/blueprints/components/menus.yaml +134 -0
  105. package/skills/applying-slds/metadata/blueprints/components/modals.yaml +152 -0
  106. package/skills/applying-slds/metadata/blueprints/components/notifications.yaml +88 -0
  107. package/skills/applying-slds/metadata/blueprints/components/page-headers.yaml +135 -0
  108. package/skills/applying-slds/metadata/blueprints/components/panels.yaml +149 -0
  109. package/skills/applying-slds/metadata/blueprints/components/path.yaml +154 -0
  110. package/skills/applying-slds/metadata/blueprints/components/picklist.yaml +125 -0
  111. package/skills/applying-slds/metadata/blueprints/components/pills.yaml +154 -0
  112. package/skills/applying-slds/metadata/blueprints/components/popovers.yaml +120 -0
  113. package/skills/applying-slds/metadata/blueprints/components/progress-bar.yaml +110 -0
  114. package/skills/applying-slds/metadata/blueprints/components/progress-indicator.yaml +133 -0
  115. package/skills/applying-slds/metadata/blueprints/components/progress-ring.yaml +102 -0
  116. package/skills/applying-slds/metadata/blueprints/components/prompt.yaml +126 -0
  117. package/skills/applying-slds/metadata/blueprints/components/publishers.yaml +178 -0
  118. package/skills/applying-slds/metadata/blueprints/components/radio-button-group.yaml +172 -0
  119. package/skills/applying-slds/metadata/blueprints/components/radio-group.yaml +112 -0
  120. package/skills/applying-slds/metadata/blueprints/components/rich-text-editor.yaml +135 -0
  121. package/skills/applying-slds/metadata/blueprints/components/scoped-notifications.yaml +188 -0
  122. package/skills/applying-slds/metadata/blueprints/components/scoped-tabs.yaml +97 -0
  123. package/skills/applying-slds/metadata/blueprints/components/select.yaml +127 -0
  124. package/skills/applying-slds/metadata/blueprints/components/setup-assistant.yaml +152 -0
  125. package/skills/applying-slds/metadata/blueprints/components/slider.yaml +111 -0
  126. package/skills/applying-slds/metadata/blueprints/components/spinners.yaml +135 -0
  127. package/skills/applying-slds/metadata/blueprints/components/split-view.yaml +112 -0
  128. package/skills/applying-slds/metadata/blueprints/components/summary-detail.yaml +103 -0
  129. package/skills/applying-slds/metadata/blueprints/components/tabs.yaml +138 -0
  130. package/skills/applying-slds/metadata/blueprints/components/textarea.yaml +116 -0
  131. package/skills/applying-slds/metadata/blueprints/components/tiles.yaml +108 -0
  132. package/skills/applying-slds/metadata/blueprints/components/timepicker.yaml +111 -0
  133. package/skills/applying-slds/metadata/blueprints/components/toast.yaml +154 -0
  134. package/skills/applying-slds/metadata/blueprints/components/tooltips.yaml +107 -0
  135. package/skills/applying-slds/metadata/blueprints/components/tree-grid.yaml +116 -0
  136. package/skills/applying-slds/metadata/blueprints/components/trees.yaml +116 -0
  137. package/skills/applying-slds/metadata/blueprints/components/trial-bar.yaml +112 -0
  138. package/skills/applying-slds/metadata/blueprints/components/vertical-navigation.yaml +130 -0
  139. package/skills/applying-slds/metadata/blueprints/components/vertical-tabs.yaml +140 -0
  140. package/skills/applying-slds/metadata/blueprints/components/visual-picker.yaml +150 -0
  141. package/skills/applying-slds/metadata/blueprints/components/welcome-mat.yaml +136 -0
  142. package/skills/applying-slds/metadata/hooks-index.json +6272 -0
  143. package/skills/applying-slds/metadata/icon-metadata.json +38466 -0
  144. package/skills/applying-slds/metadata/utilities-index.json +21912 -0
  145. package/skills/applying-slds/references/component-selection.md +112 -0
  146. package/skills/applying-slds/references/icons-decision-guide.md +124 -0
  147. package/skills/applying-slds/references/styling-decision-guide.md +228 -0
  148. package/skills/applying-slds/references/utilities-quick-ref.md +125 -0
  149. package/skills/applying-slds/scripts/search-blueprints.cjs +117 -0
  150. package/skills/applying-slds/scripts/search-hooks.cjs +139 -0
  151. package/skills/applying-slds/scripts/search-icons.cjs +174 -0
  152. package/skills/applying-slds/scripts/search-utilities.cjs +161 -0
  153. package/skills/generating-custom-lightning-type/SKILL.md +17 -39
  154. package/skills/generating-custom-lightning-type/assets/primitive-types-and-constraints.md +41 -0
  155. package/skills/generating-custom-lightning-type/references/widget-rendition.md +124 -0
  156. package/skills/investigating-agentforce-architecture/README.md +156 -0
  157. package/skills/investigating-agentforce-architecture/SKILL.md +230 -0
  158. package/skills/investigating-agentforce-architecture/assets/cli/describe_sobject.yaml +16 -0
  159. package/skills/investigating-agentforce-architecture/assets/cli/describe_tooling_sobject.yaml +17 -0
  160. package/skills/investigating-agentforce-architecture/assets/cli/list_metadata_genaiprompttemplate.yaml +17 -0
  161. package/skills/investigating-agentforce-architecture/assets/cli/org_display.yaml +15 -0
  162. package/skills/investigating-agentforce-architecture/assets/cli/retrieve_genai_plugin.yaml +18 -0
  163. package/skills/investigating-agentforce-architecture/assets/cli/show_access_token.yaml +27 -0
  164. package/skills/investigating-agentforce-architecture/assets/mermaid/action_tree.mmd +20 -0
  165. package/skills/investigating-agentforce-architecture/assets/mermaid/data_flow.mmd +19 -0
  166. package/skills/investigating-agentforce-architecture/assets/mermaid/dependency_graph.mmd +19 -0
  167. package/skills/investigating-agentforce-architecture/assets/mermaid/invocation_sequence.mmd +20 -0
  168. package/skills/investigating-agentforce-architecture/assets/mermaid/planner_state.mmd +18 -0
  169. package/skills/investigating-agentforce-architecture/assets/soql/apex_class_bodies_by_ids.soql +3 -0
  170. package/skills/investigating-agentforce-architecture/assets/soql/apex_class_bodies_by_names.soql +3 -0
  171. package/skills/investigating-agentforce-architecture/assets/soql/bot_definition_details.soql +3 -0
  172. package/skills/investigating-agentforce-architecture/assets/soql/bot_version_lookup.soql +4 -0
  173. package/skills/investigating-agentforce-architecture/assets/soql/flow_definition_by_ids.soql +3 -0
  174. package/skills/investigating-agentforce-architecture/assets/soql/flow_definition_ids_by_names.soql +3 -0
  175. package/skills/investigating-agentforce-architecture/assets/soql/flow_definition_view_by_durable_ids.soql +4 -0
  176. package/skills/investigating-agentforce-architecture/assets/soql/flow_metadata_by_id.soql +3 -0
  177. package/skills/investigating-agentforce-architecture/assets/soql/functions_by_plugins.soql +5 -0
  178. package/skills/investigating-agentforce-architecture/assets/soql/planner_attrs_by_parent_ids.soql +3 -0
  179. package/skills/investigating-agentforce-architecture/assets/soql/planner_bundle_functions.soql +3 -0
  180. package/skills/investigating-agentforce-architecture/assets/soql/planner_definition_by_agent_chain.soql +3 -0
  181. package/skills/investigating-agentforce-architecture/assets/soql/plugin_functions_by_plugin_ids.soql +3 -0
  182. package/skills/investigating-agentforce-architecture/assets/soql/plugin_instructions_by_plugin_ids.soql +3 -0
  183. package/skills/investigating-agentforce-architecture/assets/soql/plugins_by_planner.soql +4 -0
  184. package/skills/investigating-agentforce-architecture/references/architecture_sections.md +243 -0
  185. package/skills/investigating-agentforce-architecture/references/contract.json +244 -0
  186. package/skills/investigating-agentforce-architecture/references/soql_fields.md +512 -0
  187. package/skills/investigating-agentforce-architecture/scripts/_shared/__init__.py +1 -0
  188. package/skills/investigating-agentforce-architecture/scripts/_shared/fs_guard.py +329 -0
  189. package/skills/investigating-agentforce-architecture/scripts/_shared/paths.py +110 -0
  190. package/skills/investigating-agentforce-architecture/scripts/_shared/runtime.py +59 -0
  191. package/skills/investigating-agentforce-architecture/scripts/_shared/sql.py +10 -0
  192. package/skills/investigating-agentforce-architecture/scripts/cache_check.py +234 -0
  193. package/skills/investigating-agentforce-architecture/scripts/config.py +131 -0
  194. package/skills/investigating-agentforce-architecture/scripts/fetch_soql.py +689 -0
  195. package/skills/investigating-agentforce-architecture/scripts/finalize.py +295 -0
  196. package/skills/investigating-agentforce-architecture/scripts/main.py +2835 -0
  197. package/skills/investigating-agentforce-architecture/scripts/metadata_listing.py +265 -0
  198. package/skills/investigating-agentforce-architecture/scripts/parallel_retrieve.py +69 -0
  199. package/skills/investigating-agentforce-architecture/scripts/parse_bundle.py +215 -0
  200. package/skills/investigating-agentforce-architecture/scripts/parse_wave.py +845 -0
  201. package/skills/investigating-agentforce-architecture/scripts/probe_channels.py +302 -0
  202. package/skills/investigating-agentforce-architecture/scripts/render_architecture.py +1043 -0
  203. package/skills/investigating-agentforce-architecture/scripts/resolve_bot.py +255 -0
  204. package/skills/investigating-agentforce-architecture/scripts/resolve_invocation_target.py +130 -0
  205. package/skills/investigating-agentforce-architecture/scripts/rest_client.py +763 -0
  206. package/skills/investigating-agentforce-architecture/scripts/retrieve_planner.py +13 -0
  207. package/skills/investigating-agentforce-architecture/scripts/sf_cli.py +242 -0
  208. package/skills/investigating-agentforce-architecture/scripts/soql_loader.py +253 -0
  209. package/skills/investigating-agentforce-architecture/scripts/summarize_tree.py +143 -0
  210. package/skills/investigating-agentforce-architecture/scripts/tests/__init__.py +0 -0
  211. package/skills/investigating-agentforce-architecture/scripts/tests/_bootstrap.py +23 -0
  212. package/skills/investigating-agentforce-architecture/scripts/tests/fixtures/__init__.py +0 -0
  213. package/skills/investigating-agentforce-architecture/scripts/tests/fixtures/genai_payloads.py +400 -0
  214. package/skills/investigating-agentforce-architecture/scripts/tests/test_cache_check.py +307 -0
  215. package/skills/investigating-agentforce-architecture/scripts/tests/test_cache_check_main.py +283 -0
  216. package/skills/investigating-agentforce-architecture/scripts/tests/test_config.py +115 -0
  217. package/skills/investigating-agentforce-architecture/scripts/tests/test_end_to_end_fixture.py +651 -0
  218. package/skills/investigating-agentforce-architecture/scripts/tests/test_finalize.py +278 -0
  219. package/skills/investigating-agentforce-architecture/scripts/tests/test_flow_children_inflation.py +582 -0
  220. package/skills/investigating-agentforce-architecture/scripts/tests/test_fs_guard.py +113 -0
  221. package/skills/investigating-agentforce-architecture/scripts/tests/test_iterative_wave_b.py +478 -0
  222. package/skills/investigating-agentforce-architecture/scripts/tests/test_main_pipeline.py +3359 -0
  223. package/skills/investigating-agentforce-architecture/scripts/tests/test_parallel_retrieve.py +131 -0
  224. package/skills/investigating-agentforce-architecture/scripts/tests/test_parse_bundle.py +400 -0
  225. package/skills/investigating-agentforce-architecture/scripts/tests/test_parse_wave.py +644 -0
  226. package/skills/investigating-agentforce-architecture/scripts/tests/test_parse_wave_classifiers.py +224 -0
  227. package/skills/investigating-agentforce-architecture/scripts/tests/test_parse_wave_helpers.py +380 -0
  228. package/skills/investigating-agentforce-architecture/scripts/tests/test_parse_wave_main.py +397 -0
  229. package/skills/investigating-agentforce-architecture/scripts/tests/test_per_branch_visited.py +244 -0
  230. package/skills/investigating-agentforce-architecture/scripts/tests/test_probe_channels.py +359 -0
  231. package/skills/investigating-agentforce-architecture/scripts/tests/test_probe_cli_recipes.py +185 -0
  232. package/skills/investigating-agentforce-architecture/scripts/tests/test_render_architecture.py +810 -0
  233. package/skills/investigating-agentforce-architecture/scripts/tests/test_resolve_bot.py +203 -0
  234. package/skills/investigating-agentforce-architecture/scripts/tests/test_resolve_creds.py +157 -0
  235. package/skills/investigating-agentforce-architecture/scripts/tests/test_resolve_invocation_target.py +145 -0
  236. package/skills/investigating-agentforce-architecture/scripts/tests/test_rest_client.py +1253 -0
  237. package/skills/investigating-agentforce-architecture/scripts/tests/test_runtime_override.py +100 -0
  238. package/skills/investigating-agentforce-architecture/scripts/tests/test_sf_cli.py +261 -0
  239. package/skills/investigating-agentforce-architecture/scripts/tests/test_signature_stamping.py +466 -0
  240. package/skills/investigating-agentforce-architecture/scripts/tests/test_soql_loader.py +501 -0
  241. package/skills/investigating-agentforce-architecture/scripts/tests/test_summarize_tree.py +241 -0
  242. package/skills/investigating-agentforce-architecture/scripts/tests/test_write_emit_ctx.py +480 -0
  243. package/skills/investigating-agentforce-architecture/tools/emit_env.py +157 -0
  244. package/skills/investigating-agentforce-architecture/tools/emit_result.py +262 -0
  245. package/skills/investigating-agentforce-architecture/tools/sanitize.py +33 -0
  246. package/skills/investigating-agentforce-architecture/tools/write_emit_ctx.py +332 -0
  247. package/skills/investigating-agentforce-d360/README.md +123 -0
  248. package/skills/investigating-agentforce-d360/SKILL.md +163 -0
  249. package/skills/investigating-agentforce-d360/assets/dc/app_generation.sql +51 -0
  250. package/skills/investigating-agentforce-d360/assets/dc/content_category.sql +44 -0
  251. package/skills/investigating-agentforce-d360/assets/dc/content_quality.sql +41 -0
  252. package/skills/investigating-agentforce-d360/assets/dc/discover_sessions.sql +36 -0
  253. package/skills/investigating-agentforce-d360/assets/dc/feedback.sql +47 -0
  254. package/skills/investigating-agentforce-d360/assets/dc/feedback_details.sql +38 -0
  255. package/skills/investigating-agentforce-d360/assets/dc/gateway_records.sql +45 -0
  256. package/skills/investigating-agentforce-d360/assets/dc/gateway_request_llm.sql +50 -0
  257. package/skills/investigating-agentforce-d360/assets/dc/gateway_request_metadata.sql +44 -0
  258. package/skills/investigating-agentforce-d360/assets/dc/gateway_request_tags.sql +42 -0
  259. package/skills/investigating-agentforce-d360/assets/dc/gateway_requests.sql +89 -0
  260. package/skills/investigating-agentforce-d360/assets/dc/gateway_responses.sql +43 -0
  261. package/skills/investigating-agentforce-d360/assets/dc/generations.sql +52 -0
  262. package/skills/investigating-agentforce-d360/assets/dc/interactions.sql +53 -0
  263. package/skills/investigating-agentforce-d360/assets/dc/messages.sql +53 -0
  264. package/skills/investigating-agentforce-d360/assets/dc/messaging_session.sql +37 -0
  265. package/skills/investigating-agentforce-d360/assets/dc/moment_interactions.sql +34 -0
  266. package/skills/investigating-agentforce-d360/assets/dc/moments.sql +39 -0
  267. package/skills/investigating-agentforce-d360/assets/dc/participants.sql +48 -0
  268. package/skills/investigating-agentforce-d360/assets/dc/sessions.sql +78 -0
  269. package/skills/investigating-agentforce-d360/assets/dc/steps.sql +64 -0
  270. package/skills/investigating-agentforce-d360/assets/dc/tag_associations.sql +46 -0
  271. package/skills/investigating-agentforce-d360/assets/dc/tag_definition_associations.sql +37 -0
  272. package/skills/investigating-agentforce-d360/assets/dc/tag_definitions.sql +50 -0
  273. package/skills/investigating-agentforce-d360/assets/dc/tags.sql +37 -0
  274. package/skills/investigating-agentforce-d360/assets/dc/telemetry_spans.sql +55 -0
  275. package/skills/investigating-agentforce-d360/references/artifacts.md +50 -0
  276. package/skills/investigating-agentforce-d360/references/dc_dmo_fields.md +823 -0
  277. package/skills/investigating-agentforce-d360/references/dc_pipeline_contract.md +608 -0
  278. package/skills/investigating-agentforce-d360/scripts/_shared/__init__.py +2 -0
  279. package/skills/investigating-agentforce-d360/scripts/_shared/cli_override.py +98 -0
  280. package/skills/investigating-agentforce-d360/scripts/_shared/fs_guard.py +334 -0
  281. package/skills/investigating-agentforce-d360/scripts/_shared/paths.py +155 -0
  282. package/skills/investigating-agentforce-d360/scripts/_shared/runtime.py +59 -0
  283. package/skills/investigating-agentforce-d360/scripts/_shared/sql.py +14 -0
  284. package/skills/investigating-agentforce-d360/scripts/assemble_dc.py +1624 -0
  285. package/skills/investigating-agentforce-d360/scripts/config.py +45 -0
  286. package/skills/investigating-agentforce-d360/scripts/dc.py +188 -0
  287. package/skills/investigating-agentforce-d360/scripts/discover_sessions.py +556 -0
  288. package/skills/investigating-agentforce-d360/scripts/fetch_dc.py +1045 -0
  289. package/skills/investigating-agentforce-d360/scripts/render_dc.py +1750 -0
  290. package/skills/investigating-agentforce-d360/scripts/resolve_session.py +264 -0
  291. package/skills/investigating-agentforce-d360/scripts/storage.py +92 -0
  292. package/skills/investigating-agentforce-d360/scripts/tests/__init__.py +0 -0
  293. package/skills/investigating-agentforce-d360/scripts/tests/_bootstrap.py +15 -0
  294. package/skills/investigating-agentforce-d360/scripts/tests/fixtures/__init__.py +0 -0
  295. package/skills/investigating-agentforce-d360/scripts/tests/fixtures/synthetic_session.py +424 -0
  296. package/skills/investigating-agentforce-d360/scripts/tests/test_assemble_dc_bootstrap_and_mode.py +115 -0
  297. package/skills/investigating-agentforce-d360/scripts/tests/test_assemble_dc_gateway_direct.py +220 -0
  298. package/skills/investigating-agentforce-d360/scripts/tests/test_assemble_dc_gateway_direct_integration.py +158 -0
  299. package/skills/investigating-agentforce-d360/scripts/tests/test_assemble_dc_helpers.py +287 -0
  300. package/skills/investigating-agentforce-d360/scripts/tests/test_assemble_dc_integration.py +247 -0
  301. package/skills/investigating-agentforce-d360/scripts/tests/test_dc_and_resolve_session.py +433 -0
  302. package/skills/investigating-agentforce-d360/scripts/tests/test_discover_sessions.py +458 -0
  303. package/skills/investigating-agentforce-d360/scripts/tests/test_discover_sessions_grep_ci.py +193 -0
  304. package/skills/investigating-agentforce-d360/scripts/tests/test_fetch_dc_helpers.py +266 -0
  305. package/skills/investigating-agentforce-d360/scripts/tests/test_fetch_dc_identity.py +528 -0
  306. package/skills/investigating-agentforce-d360/scripts/tests/test_fetch_dc_main.py +251 -0
  307. package/skills/investigating-agentforce-d360/scripts/tests/test_fetch_dc_waterfall.py +229 -0
  308. package/skills/investigating-agentforce-d360/scripts/tests/test_fetch_dc_waterfall_full.py +283 -0
  309. package/skills/investigating-agentforce-d360/scripts/tests/test_identity_coherence.py +327 -0
  310. package/skills/investigating-agentforce-d360/scripts/tests/test_render_dc_branches.py +256 -0
  311. package/skills/investigating-agentforce-d360/scripts/tests/test_render_dc_gateway_direct.py +130 -0
  312. package/skills/investigating-agentforce-d360/scripts/tests/test_render_dc_helpers.py +291 -0
  313. package/skills/investigating-agentforce-d360/scripts/tests/test_render_dc_integration.py +220 -0
  314. package/skills/investigating-agentforce-d360/scripts/tests/test_render_dc_planner_llm_calls.py +284 -0
  315. package/skills/investigating-agentforce-d360/scripts/tests/test_render_dc_show_prompts_gating.py +215 -0
  316. package/skills/investigating-agentforce-d360/scripts/tests/test_resolve_from_disk.py +100 -0
  317. package/skills/investigating-agentforce-d360/scripts/tests/test_resolve_session_main.py +149 -0
  318. package/skills/investigating-agentforce-d360/scripts/tests/test_runtime_override.py +104 -0
  319. package/skills/investigating-agentforce-d360/scripts/tests/test_session_shape.py +95 -0
  320. package/skills/investigating-agentforce-d360/scripts/tests/test_session_shape_dropped_by_stdm.py +85 -0
  321. package/skills/managing-managed-event-subscription/SKILL.md +152 -0
  322. package/skills/managing-managed-event-subscription/assets/managed-event-subscription-template.xml +20 -0
  323. package/skills/managing-managed-event-subscription/references/delete-guide.md +57 -0
  324. package/skills/managing-managed-event-subscription/references/topic-name-formats.md +26 -0
  325. package/skills/managing-managed-event-subscription/references/update-constraints.md +30 -0
  326. package/skills/uplifting-components-to-slds2/SKILL.md +3 -2
  327. package/skills/uplifting-components-to-slds2/references/color-hooks-decision-guide.md +30 -9
  328. package/skills/uplifting-components-to-slds2/references/examples.md +24 -6
  329. package/skills/validating-slds/SKILL.md +262 -0
  330. package/skills/validating-slds/references/quality-checks.md +308 -0
  331. package/skills/validating-slds/references/report-format.md +302 -0
  332. package/skills/validating-slds/scripts/analyze-quality.cjs +521 -0
@@ -0,0 +1,132 @@
1
+ name: Lookups
2
+ description: Search and selection components that allow users to find and select records from large datasets, with autocomplete
3
+ functionality and result filtering.
4
+ category: Input
5
+ slds_classes:
6
+ root: slds-lookup
7
+ elements:
8
+ - class: slds-lookup__menu
9
+ description: Results dropdown container
10
+ purpose: Contains search results and options
11
+ - class: slds-lookup__item
12
+ description: Individual result item
13
+ purpose: Represents a single search result
14
+ - class: slds-lookup__result-text
15
+ description: Primary result text
16
+ purpose: Main label for the search result
17
+ - class: slds-lookup__result-meta
18
+ description: Secondary result information
19
+ purpose: Additional context for the search result
20
+ modifiers: []
21
+ states:
22
+ - class: slds-has-focus
23
+ description: Focus state for lookup
24
+ trigger: When lookup has keyboard focus
25
+ - class: slds-is-open
26
+ description: Open state for dropdown
27
+ trigger: When results dropdown is visible
28
+ - class: slds-has-selection
29
+ description: Selection state
30
+ trigger: When a result has been selected
31
+ variants:
32
+ - name: Base
33
+ description: Standard lookup with search and results
34
+ classes:
35
+ - slds-lookup
36
+ usage_context: Default lookup for record selection
37
+ differences: Search input with dropdown results list
38
+ lightning_component:
39
+ name: No direct component
40
+ url: https://developer.salesforce.com/docs/component-library/overview/components
41
+ mapping_notes: No direct Lightning Base Component - typically implemented through custom components or third-party libraries
42
+ accessibility:
43
+ keyboard_support:
44
+ - Tab to focus search input
45
+ - Type to search and filter results
46
+ - Arrow keys to navigate results
47
+ - Enter to select highlighted result
48
+ - Escape to close results dropdown
49
+ screen_reader:
50
+ - Search purpose and current value announced
51
+ - Result count and filtering status communicated
52
+ - Selected result clearly identified
53
+ - Loading and empty states announced
54
+ aria_attributes:
55
+ - role='combobox' for search input
56
+ - aria-expanded for dropdown state
57
+ - aria-activedescendant for current result
58
+ - role='listbox' for results container
59
+ - role='option' for individual results
60
+ - aria-autocomplete='list' for search behavior
61
+ usage_guidelines:
62
+ when_to_use:
63
+ - For selecting records from large datasets
64
+ - When search and filtering capabilities are needed
65
+ - For relationship fields and record associations
66
+ - When autocomplete functionality improves usability
67
+ when_not_to_use:
68
+ - For small, fixed option lists (use select instead)
69
+ - When all options should be visible (use radio group)
70
+ - For simple text input without search
71
+ best_practices:
72
+ - Provide meaningful search result formatting
73
+ - Show loading states during search
74
+ - Handle empty search results gracefully
75
+ - Implement debounced search for performance
76
+ - Display relevant result metadata
77
+ common_mistakes:
78
+ - Poor search result formatting
79
+ - Missing loading and empty states
80
+ - Inadequate keyboard navigation
81
+ - Poor search performance optimization
82
+ code_examples:
83
+ - title: Account Lookup
84
+ code: "<div class=\"slds-lookup\" data-select=\"single\" data-scope=\"single\">\n <div class=\"\">\n <div class=\"\
85
+ slds-form-element\">\n <label class=\"slds-form-element__label\" for=\"lookup-search\">\n Search Accounts\n\
86
+ \ </label>\n <div class=\"slds-form-element__control slds-input-has-icon slds-input-has-icon_right\"\
87
+ >\n <input type=\"text\" class=\"slds-input\" id=\"lookup-search\" role=\"combobox\" aria-expanded=\"true\"\
88
+ \ aria-haspopup=\"listbox\" placeholder=\"Search Accounts...\" />\n <span class=\"slds-icon_container slds-icon-utility-search\
89
+ \ slds-input__icon slds-input__icon_right\">\n <svg class=\"slds-icon slds-icon_x-small\" aria-hidden=\"\
90
+ true\">\n <use xlink:href=\"/assets/icons/utility-sprite/svg/symbols.svg#search\"></use>\n \
91
+ \ </svg>\n </span>\n </div>\n </div>\n </div>\n <div class=\"slds-lookup__menu\"\
92
+ \ role=\"listbox\">\n <ul class=\"slds-lookup__list\" role=\"presentation\">\n <li class=\"slds-lookup__item\"\
93
+ \ role=\"option\">\n <div class=\"slds-media\">\n <div class=\"slds-media__figure\">\n \
94
+ \ <span class=\"slds-icon_container slds-icon-standard-account\">\n <svg class=\"slds-icon slds-icon_small\"\
95
+ \ aria-hidden=\"true\">\n <use xlink:href=\"/assets/icons/standard-sprite/svg/symbols.svg#account\"\
96
+ ></use>\n </svg>\n </span>\n </div>\n <div class=\"slds-media__body\"\
97
+ >\n <div class=\"slds-lookup__result-text\">Acme Corporation</div>\n <div class=\"slds-lookup__result-meta\
98
+ \ slds-text-body_small\">Account • San Francisco</div>\n </div>\n </div>\n </li>\n \
99
+ \ </ul>\n </div>\n </div>\n"
100
+ styling_hooks: []
101
+ dependencies:
102
+ css_files:
103
+ - lookup.css
104
+ - combobox.css
105
+ - media-objects.css
106
+ javascript:
107
+ - lookup.js
108
+ icons:
109
+ - utility-sprite.svg
110
+ - standard-sprite.svg
111
+ other_components:
112
+ - combobox
113
+ - media-objects
114
+ - input
115
+ - icons
116
+ related_components:
117
+ - name: Combobox
118
+ relationship: similar
119
+ description: Similar search and select pattern
120
+ - name: Select
121
+ relationship: alternative
122
+ description: Alternative for smaller, fixed option sets
123
+ - name: Pills
124
+ relationship: depends-on
125
+ description: Often used to display selected lookup results
126
+ references:
127
+ official_docs: https://v1.lightningdesignsystem.com/components/lookups/
128
+ metadata:
129
+ version: 1.0.0
130
+ last_updated: '2025-11-12'
131
+ review_status: complete
132
+ notes: ' Cleaned invalid classes and CSS variables on 2025-11-12 using slds-plus.css as source of truth.'
@@ -0,0 +1,118 @@
1
+ name: Map
2
+ description: A component for displaying interactive maps with coordinates and location information. Provides a container for
3
+ third-party map libraries with a coordinates panel for displaying location details.
4
+ category: Complex Components
5
+ slds_classes:
6
+ root: slds-map
7
+ elements:
8
+ - class: slds-map_container
9
+ description: Container for the map component
10
+ purpose: Wraps the map and coordinates panel
11
+ - class: slds-coordinates
12
+ description: Coordinates panel element
13
+ purpose: Displays location coordinates and details
14
+ - class: slds-coordinates__header
15
+ description: Header of coordinates panel
16
+ purpose: Contains title for coordinates panel
17
+ modifiers:
18
+ - class: slds-has-coordinates
19
+ description: Modifier indicating coordinates panel is active
20
+ purpose: Applied to parent container when panel is visible
21
+ states: []
22
+ variants:
23
+ - name: Base
24
+ description: Standard map with optional coordinates panel
25
+ classes:
26
+ - slds-map_container
27
+ usage_context: Default map implementation
28
+ differences: Container for third-party map with SLDS styling
29
+ lightning_component:
30
+ name: lightning-map
31
+ url: https://developer.salesforce.com/docs/component-library/bundle/lightning-map
32
+ mapping_notes: lightning-map provides interactive map with markers and location display
33
+ accessibility:
34
+ keyboard_support:
35
+ - Tab to focus on map controls
36
+ - Arrow keys to pan map (when supported by map library)
37
+ - Enter to activate map markers
38
+ - +/- keys to zoom (when supported)
39
+ screen_reader:
40
+ - Map region announced
41
+ - Location information announced
42
+ - Marker details announced when focused
43
+ - Coordinates read when displayed
44
+ aria_attributes:
45
+ - role='application' or 'region' on map container
46
+ - aria-label describing map purpose
47
+ - aria-live for coordinate updates
48
+ - Accessible labels for map controls
49
+ usage_guidelines:
50
+ when_to_use:
51
+ - For displaying geographic locations
52
+ - When showing multiple locations on a map
53
+ - For route or area visualization
54
+ - In location-based applications
55
+ when_not_to_use:
56
+ - For simple address display (use text)
57
+ - When location context isn't important
58
+ - For very small screens with limited space
59
+ - When map interaction adds unnecessary complexity
60
+ best_practices:
61
+ - Use reputable map library (Google Maps, Mapbox, Leaflet)
62
+ - Provide zoom and pan controls
63
+ - Show location coordinates when relevant
64
+ - Support keyboard navigation
65
+ - Handle loading states gracefully
66
+ - Respect user location privacy
67
+ common_mistakes:
68
+ - Missing keyboard support
69
+ - Poor performance with many markers
70
+ - Not handling map library load failures
71
+ - Inadequate mobile/touch support
72
+ - Missing accessible labels
73
+ code_examples:
74
+ - title: Basic Map Container
75
+ code: "<div class=\"slds-map_container\">\n <div class=\"slds-map\" aria-label=\"Map showing office location\">\n <!--\
76
+ \ Third-party map library rendered here -->\n <div id=\"map-canvas\"></div>\n </div>\n</div>\n"
77
+ description: Basic map container for third-party map library
78
+ - title: Map with Coordinates Panel
79
+ code: "<div class=\"slds-grid slds-map_container slds-has-coordinates\">\n <div class=\"slds-col slds-size_2-of-3\">\n\
80
+ \ <div class=\"slds-map\" aria-label=\"Interactive map\">\n <!-- Third-party map library rendered here -->\n \
81
+ \ <div id=\"map-canvas\"></div>\n </div>\n </div>\n <div class=\"slds-col slds-size_1-of-3\">\n <div class=\"\
82
+ slds-coordinates\">\n <div class=\"slds-coordinates__header\">\n <h2 class=\"slds-text-heading_medium\">Location\
83
+ \ Details</h2>\n </div>\n <div class=\"\">\n <dl class=\"slds-list_horizontal slds-wrap\">\n \
84
+ \ <dt class=\"slds-item_label slds-text-color_weak slds-truncate\">Latitude:</dt>\n <dd class=\"slds-item_detail\
85
+ \ slds-truncate\">37.7749</dd>\n <dt class=\"slds-item_label slds-text-color_weak slds-truncate\">Longitude:</dt>\n\
86
+ \ <dd class=\"slds-item_detail slds-truncate\">-122.4194</dd>\n <dt class=\"slds-item_label slds-text-color_weak\
87
+ \ slds-truncate\">Address:</dt>\n <dd class=\"slds-item_detail\">San Francisco, CA</dd>\n </dl>\n \
88
+ \ </div>\n </div>\n </div>\n</div>\n"
89
+ description: Map with coordinates panel showing location details
90
+ styling_hooks: []
91
+ dependencies:
92
+ css_files:
93
+ - map.css
94
+ javascript:
95
+ - Third-party map library integration
96
+ - Map initialization
97
+ - Marker management
98
+ - Coordinates panel updates
99
+ icons: []
100
+ other_components:
101
+ - grid
102
+ related_components:
103
+ - name: Formatted Address
104
+ relationship: complementary
105
+ description: Displays formatted address alongside map
106
+ - name: Formatted Location
107
+ relationship: complementary
108
+ description: Displays location information
109
+ references:
110
+ official_docs: https://v1.lightningdesignsystem.com/components/map/
111
+ metadata:
112
+ version: 1.0.0
113
+ last_updated: '2025-11-11'
114
+ author: SLDS Documentation Team
115
+ slds_version: 2.27.2
116
+ review_status: complete
117
+ source: official-slds
118
+ notes: Created from official SLDS documentation and design-system-internal source code
@@ -0,0 +1,134 @@
1
+ name: Menus
2
+ description: Contextual navigation components that present a list of actions or options, typically triggered by user interaction
3
+ with a button or other control.
4
+ category: Navigation
5
+ slds_classes:
6
+ root: slds-dropdown
7
+ elements:
8
+ - class: slds-dropdown__item
9
+ description: Individual menu item wrapper
10
+ purpose: Contains a single menu option
11
+ - class: slds-dropdown__header
12
+ description: Menu section header
13
+ purpose: Groups related menu items with a heading
14
+ modifiers:
15
+ - class: slds-dropdown_left
16
+ description: Left-aligned dropdown menu
17
+ usage: Menu aligned to the left edge of trigger
18
+ - class: slds-dropdown_right
19
+ description: Right-aligned dropdown menu
20
+ usage: Menu aligned to the right edge of trigger
21
+ - class: slds-dropdown_bottom
22
+ description: Bottom-positioned dropdown menu
23
+ usage: Menu appears below the trigger element
24
+ - class: slds-dropdown_length-5
25
+ description: Menu height for 5 items
26
+ usage: Constrains menu height for scrolling
27
+ - class: slds-dropdown_length-7
28
+ description: Menu height for 7 items
29
+ usage: Constrains menu height for scrolling
30
+ - class: slds-dropdown_length-10
31
+ description: Menu height for 10 items
32
+ usage: Constrains menu height for scrolling
33
+ states:
34
+ - class: slds-is-open
35
+ description: Open menu state
36
+ trigger: When menu is visible
37
+ - class: slds-is-selected
38
+ description: Selected menu item state
39
+ trigger: Currently selected menu option
40
+ variants:
41
+ - name: Base
42
+ description: Standard dropdown menu
43
+ classes:
44
+ - slds-dropdown
45
+ usage_context: Default menu implementation for actions and options
46
+ differences: Basic dropdown menu with list of actionable items
47
+ lightning_component:
48
+ name: lightning-menu-item
49
+ url: https://developer.salesforce.com/docs/component-library/bundle/lightning-menu-item
50
+ mapping_notes: Mapped through lightning-menu-item and lightning-button-menu components
51
+ accessibility:
52
+ keyboard_support:
53
+ - Tab to focus menu trigger
54
+ - Enter/Space to open menu
55
+ - Arrow keys to navigate menu items
56
+ - Enter/Space to select menu items
57
+ - Escape to close menu
58
+ screen_reader:
59
+ - Menu structure and purpose announced
60
+ - Menu items and their actions described
61
+ - Current selection communicated
62
+ - Menu state changes announced
63
+ aria_attributes:
64
+ - role='menu' for menu container
65
+ - role='menuitem' for menu options
66
+ - aria-expanded on menu trigger
67
+ - aria-haspopup on menu trigger
68
+ - aria-labelledby for menu identification
69
+ usage_guidelines:
70
+ when_to_use:
71
+ - For contextual actions related to specific content
72
+ - To group related actions in a compact interface
73
+ - For overflow actions when space is limited
74
+ - To provide secondary or advanced options
75
+ when_not_to_use:
76
+ - For primary navigation (use navigation components)
77
+ - For form inputs (use select or combobox)
78
+ - When all actions should be immediately visible
79
+ best_practices:
80
+ - Use clear, action-oriented menu item labels
81
+ - Group related actions with headers and dividers
82
+ - Order items by frequency of use or importance
83
+ - Limit menu length to avoid overwhelming users
84
+ - Provide keyboard navigation support
85
+ common_mistakes:
86
+ - Too many menu items without organization
87
+ - Unclear or vague menu item labels
88
+ - Poor menu positioning that gets cut off
89
+ - Missing keyboard navigation support
90
+ code_examples:
91
+ - title: Basic Dropdown Menu
92
+ code: "<div class=\"slds-dropdown-trigger slds-dropdown-trigger_click slds-is-open\">\n <button class=\"slds-button\
93
+ \ slds-button_neutral\" aria-haspopup=\"true\" aria-expanded=\"true\">\n Show Menu\n <svg class=\"slds-button__icon\
94
+ \ slds-button__icon_right\" aria-hidden=\"true\">\n <use xlink:href=\"/assets/icons/utility-sprite/svg/symbols.svg#down\"\
95
+ ></use>\n </svg>\n </button>\n <div class=\"slds-dropdown slds-dropdown_right\">\n <ul class=\"\
96
+ \" role=\"menu\">\n <li class=\"slds-dropdown__item\" role=\"presentation\">\n <a href=\"#\" role=\"\
97
+ menuitem\" tabindex=\"0\">\n <span class=\"slds-truncate\" title=\"Menu Item One\">Menu Item One</span>\n\
98
+ \ </a>\n </li>\n <li class=\"slds-dropdown__item\" role=\"presentation\">\n <a\
99
+ \ href=\"#\" role=\"menuitem\" tabindex=\"-1\">\n <span class=\"slds-truncate\" title=\"Menu Item Two\">Menu\
100
+ \ Item Two</span>\n </a>\n </li>\n <li class=\"slds-dropdown__item\" role=\"presentation\"\
101
+ >\n <a href=\"#\" role=\"menuitem\" tabindex=\"-1\">\n <span class=\"slds-truncate\" title=\"\
102
+ Menu Item Three\">Menu Item Three</span>\n </a>\n </li>\n </ul>\n </div>\n </div>\n"
103
+ styling_hooks: []
104
+ dependencies:
105
+ css_files:
106
+ - dropdown.css
107
+ - menu.css
108
+ - button.css
109
+ javascript:
110
+ - dropdown.js
111
+ - menu.js
112
+ icons:
113
+ - utility-sprite.svg
114
+ other_components:
115
+ - button
116
+ - dropdown
117
+ - truncate
118
+ related_components:
119
+ - name: Button Menu
120
+ relationship: container
121
+ description: Button that triggers menu dropdown
122
+ - name: Popover
123
+ relationship: similar
124
+ description: Alternative overlay for contextual content
125
+ - name: Navigation
126
+ relationship: alternative
127
+ description: Alternative for primary navigation
128
+ references:
129
+ official_docs: https://v1.lightningdesignsystem.com/components/menus/
130
+ metadata:
131
+ version: 1.0.0
132
+ last_updated: '2025-11-12'
133
+ review_status: complete
134
+ notes: ' Cleaned invalid classes and CSS variables on 2025-11-12 using slds-plus.css as source of truth.'
@@ -0,0 +1,152 @@
1
+ name: "Modals"
2
+ description: "Dialog overlays that display content above the main interface, requiring user interaction to continue with the underlying workflow."
3
+ category: "Overlay"
4
+ slds_classes:
5
+ root: "slds-modal"
6
+ elements:
7
+ - class: "slds-modal__container"
8
+ description: "Container for modal content"
9
+ purpose: "Centers and constrains modal dialog"
10
+ - class: "slds-modal__header"
11
+ description: "Header section of the modal"
12
+ purpose: "Contains title and close action"
13
+ - class: "slds-modal__content"
14
+ description: "Main content area of the modal"
15
+ purpose: "Contains the primary modal content"
16
+ - class: "slds-modal__footer"
17
+ description: "Footer section of the modal"
18
+ purpose: "Contains action buttons and controls"
19
+ - class: "slds-backdrop"
20
+ description: "Background overlay"
21
+ purpose: "Dims background and captures clicks"
22
+ modifiers:
23
+ - class: "slds-modal_small"
24
+ description: "Small modal size"
25
+ usage: "For simple confirmations or minimal content"
26
+ - class: "slds-modal_medium"
27
+ description: "Medium modal size (default)"
28
+ usage: "Standard modal size for most use cases"
29
+ - class: "slds-modal_large"
30
+ description: "Large modal size"
31
+ usage: "For complex forms or detailed content"
32
+ - class: "slds-modal_full"
33
+ description: "Full-screen modal"
34
+ usage: "For complex workflows or mobile experiences"
35
+ - class: "slds-fade-in-open"
36
+ description: "Animation for opening modal"
37
+ usage: "Smooth fade-in transition"
38
+ states:
39
+ - class: "slds-backdrop_open"
40
+ description: "Open state for backdrop"
41
+ trigger: "When modal is visible"
42
+ variants:
43
+ - name: "Base"
44
+ description: "Standard modal dialog"
45
+ classes:
46
+ - "slds-modal"
47
+ usage_context: "Default modal implementation"
48
+ differences: "Centered dialog with header, content, and footer"
49
+ lightning_component:
50
+ name: "Various (lightning-modal-*)"
51
+ url: "https://developer.salesforce.com/docs/component-library/bundle/lightning-modal-header"
52
+ mapping_notes: "Mapped through lightning-modal-header, lightning-modal-body, lightning-modal-footer components"
53
+ accessibility:
54
+ keyboard_support:
55
+ - "Tab to cycle through interactive elements within modal"
56
+ - "Escape to close modal"
57
+ - "Focus trapped within modal while open"
58
+ - "Focus returned to trigger element on close"
59
+ screen_reader:
60
+ - "Modal purpose announced when opened"
61
+ - "Content structure conveyed through proper markup"
62
+ - "Close action clearly identified"
63
+ aria_attributes:
64
+ - "role='dialog' for modal container"
65
+ - "aria-labelledby pointing to modal title"
66
+ - "aria-describedby for modal content when appropriate"
67
+ - "aria-modal='true' to indicate modal state"
68
+ - "aria-hidden='true' on background content"
69
+ usage_guidelines:
70
+ when_to_use:
71
+ - "For critical information that requires user attention"
72
+ - "For complex forms or workflows"
73
+ - "When you need to interrupt the current workflow"
74
+ - "For confirmations of destructive actions"
75
+ when_not_to_use:
76
+ - "For simple notifications (use toast instead)"
77
+ - "For non-critical information"
78
+ - "When users need to reference background content"
79
+ - "For progressive enhancement (use inline expansion)"
80
+ best_practices:
81
+ - "Provide clear modal title and purpose"
82
+ - "Include obvious way to close or cancel"
83
+ - "Keep modal content focused and concise"
84
+ - "Use appropriate modal size for content"
85
+ - "Implement proper focus management"
86
+ - "Avoid stacking multiple modals"
87
+ common_mistakes:
88
+ - "Making modals too large or complex"
89
+ - "Poor focus management implementation"
90
+ - "Missing or unclear close options"
91
+ - "Overusing modals for non-critical content"
92
+ code_examples:
93
+ - title: "Basic Modal"
94
+ code: |
95
+ <section role="dialog" tabindex="-1" aria-labelledby="modal-heading-01" aria-modal="true" aria-describedby="modal-content-id-1" class="slds-modal slds-fade-in-open">
96
+ <div class="slds-modal__container">
97
+ <header class="slds-modal__header">
98
+ <button class="slds-button slds-button_icon slds-modal__close slds-button_icon-inverse" title="Close">
99
+ <svg class="slds-button__icon slds-button__icon_large" aria-hidden="true">
100
+ <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#close"></use>
101
+ </svg>
102
+ <span class="slds-assistive-text">Close</span>
103
+ </button>
104
+ <h2 id="modal-heading-01" class="slds-modal__title slds-hyphenate">Modal Header</h2>
105
+ </header>
106
+ <div class="slds-modal__content slds-var-p-around_medium" id="modal-content-id-1">
107
+ <p>Modal body content goes here...</p>
108
+ </div>
109
+ <footer class="slds-modal__footer">
110
+ <button class="slds-button slds-button_neutral">Cancel</button>
111
+ <button class="slds-button slds-button_brand">Save</button>
112
+ </footer>
113
+ </div>
114
+ </section>
115
+ <div class="slds-backdrop slds-backdrop_open"></div>
116
+ styling_hooks:
117
+ - name: "--slds-c-modal-color-background"
118
+ description: "Background color for modal"
119
+ category: "color"
120
+ - name: "--slds-c-modal-radius-border"
121
+ description: "Border radius for modal"
122
+ category: "border"
123
+ dependencies:
124
+ css_files:
125
+ - "modal.css"
126
+ - "backdrop.css"
127
+ - "button.css"
128
+ javascript:
129
+ - "modal.js"
130
+ icons:
131
+ - "utility-sprite.svg"
132
+ other_components:
133
+ - "button"
134
+ - "button-icon"
135
+ - "backdrop"
136
+ related_components:
137
+ - name: "Prompt"
138
+ relationship: "variant"
139
+ description: "Simplified modal for confirmations"
140
+ - name: "Popovers"
141
+ relationship: "alternative"
142
+ description: "Alternative overlay for contextual content"
143
+ - name: "Toast"
144
+ relationship: "alternative"
145
+ description: "Alternative for simple notifications"
146
+ references:
147
+ official_docs: "https://v1.lightningdesignsystem.com/components/modals/"
148
+ metadata:
149
+ version: "1.0.0"
150
+ last_updated: "2025-11-12"
151
+ review_status: "complete"
152
+ notes: " Cleaned invalid classes and CSS variables on 2025-11-12 using slds-plus.css as source of truth."
@@ -0,0 +1,88 @@
1
+ name: Notifications
2
+ description: System-generated messages that inform users about important events, updates, or required actions in a non-intrusive
3
+ manner.
4
+ category: Feedback
5
+ slds_classes:
6
+ root: slds-notification
7
+ elements:
8
+ - class: slds-notification__target
9
+ description: Link or action target within notification
10
+ purpose: Provides actionable element for user interaction
11
+ modifiers: []
12
+ states: []
13
+ variants:
14
+ - name: Base
15
+ description: Standard notification message
16
+ classes:
17
+ - slds-notification
18
+ usage_context: Default notification implementation
19
+ differences: Basic notification with message content
20
+ lightning_component:
21
+ name: lightning-toast
22
+ url: https://developer.salesforce.com/docs/component-library/bundle/lightning-toast
23
+ mapping_notes: Primarily mapped through lightning-toast for temporary notifications
24
+ accessibility:
25
+ keyboard_support:
26
+ - Tab navigation through interactive elements
27
+ - Escape to dismiss dismissible notifications
28
+ - Focus management for embedded actions
29
+ screen_reader:
30
+ - Notification content announced when displayed
31
+ - Importance level conveyed through ARIA
32
+ - Action elements properly labeled
33
+ aria_attributes:
34
+ - role='alert' for important notifications
35
+ - role='status' for informational updates
36
+ - aria-live='polite' or 'assertive' based on importance
37
+ - aria-label for close buttons
38
+ usage_guidelines:
39
+ when_to_use:
40
+ - To inform users of system events or status changes
41
+ - For feedback on user actions
42
+ - To communicate important updates
43
+ - For error or success confirmations
44
+ when_not_to_use:
45
+ - For critical errors requiring immediate action (use modals)
46
+ - For instructional content (use help text)
47
+ - For persistent information (use banners or alerts)
48
+ best_practices:
49
+ - Keep notification messages concise and clear
50
+ - Use appropriate urgency levels
51
+ - Provide actionable information when possible
52
+ - Consider auto-dismissal timing carefully
53
+ - Group related notifications when appropriate
54
+ common_mistakes:
55
+ - Overusing notifications for non-essential information
56
+ - Making notification text too long or complex
57
+ - Poor timing for auto-dismissal
58
+ - Not providing adequate contrast or visibility
59
+ code_examples:
60
+ - title: Basic Toast Notification
61
+ code: "<div class=\"slds-notification\" role=\"alert\">\n <div class=\"\">\n <p>Your changes have been saved\
62
+ \ successfully.</p>\n </div>\n </div>\n"
63
+ styling_hooks: []
64
+ dependencies:
65
+ css_files:
66
+ - notification.css
67
+ - toast.css
68
+ javascript:
69
+ - notification.js
70
+ icons: []
71
+ other_components: []
72
+ related_components:
73
+ - name: Toast
74
+ relationship: variant
75
+ description: Specific type of temporary notification
76
+ - name: Alert
77
+ relationship: similar
78
+ description: Similar feedback mechanism for system-wide messages
79
+ - name: Banner
80
+ relationship: alternative
81
+ description: Alternative for persistent messaging
82
+ references:
83
+ official_docs: https://v1.lightningdesignsystem.com/components/notifications/
84
+ metadata:
85
+ version: 1.0.0
86
+ last_updated: '2025-11-12'
87
+ review_status: complete
88
+ notes: ' Cleaned invalid classes and CSS variables on 2025-11-12 using slds-plus.css as source of truth.'