@uipath/delegate-sdk 1.203.0 → 1.203.2

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 (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,531 @@
1
+ #!/usr/bin/osascript
2
+ (*
3
+ * Create Chart from Selection
4
+ * Creates a chart from the currently selected data range.
5
+ *
6
+ * Usage: osascript create-chart.applescript [chartType] [title] [targetSheet] [sourceSheet] [sourceRange]
7
+ *
8
+ * Parameters:
9
+ * chartType - Chart type (default: "column")
10
+ * column, bar, line, pie, area, scatter
11
+ * title - Optional: Chart title text (pass "" to skip)
12
+ * targetSheet - Optional: Place chart on this sheet (data stays on source).
13
+ * sourceSheet - Optional: Sheet containing the data.
14
+ * sourceRange - Optional: Data range (e.g. "A1:E5").
15
+ *
16
+ * Cross-sheet mode (sourceSheet + sourceRange + targetSheet all provided):
17
+ * Uses pure AppleScript API , make new chart object on target sheet,
18
+ * set source data from source sheet, set chart type. No UI automation needed.
19
+ *
20
+ * Same-sheet mode (no targetSheet, or targetSheet == sourceSheet):
21
+ * Uses Insert menu via System Events (more reliable for auto-formatting).
22
+ *
23
+ * Examples:
24
+ * osascript create-chart.applescript
25
+ * osascript create-chart.applescript column "Sales by Quarter"
26
+ * osascript create-chart.applescript bar "" "Dashboard" "Sheet1" "A1:E5"
27
+ * osascript create-chart.applescript pie "Market Share" "Dashboard" "Data" "A1:B10"
28
+ *)
29
+
30
+ on run argv
31
+ set chartType to "column"
32
+ set chartTitle to ""
33
+ set targetSheet to ""
34
+ set sourceSheet to ""
35
+ set sourceRange to ""
36
+ -- Documented options (advanced.md:160-168) wired through round 11:
37
+ -- item 6: topLeftCell ("F2" — where chart is placed)
38
+ -- item 7: chartWidth ("500", "" = default)
39
+ -- item 8: chartHeight ("300", "" = default)
40
+ -- item 9: legendRange (header row/col for series names)
41
+ -- item 10: autoPosition ("true"/"false")
42
+ set topLeftCell to ""
43
+ set chartWidthArg to ""
44
+ set chartHeightArg to ""
45
+ set legendRange to ""
46
+ set autoPositionArg to "true"
47
+
48
+ if (count of argv) > 0 then
49
+ set chartType to item 1 of argv
50
+ end if
51
+ if (count of argv) > 1 then
52
+ set chartTitle to item 2 of argv as string
53
+ end if
54
+ if (count of argv) > 2 then
55
+ set targetSheet to item 3 of argv as string
56
+ end if
57
+ if (count of argv) > 3 then
58
+ set sourceSheet to item 4 of argv as string
59
+ end if
60
+ if (count of argv) > 4 then
61
+ set sourceRange to item 5 of argv as string
62
+ end if
63
+ if (count of argv) > 5 then
64
+ set topLeftCell to item 6 of argv as string
65
+ end if
66
+ if (count of argv) > 6 then
67
+ set chartWidthArg to item 7 of argv as string
68
+ end if
69
+ if (count of argv) > 7 then
70
+ set chartHeightArg to item 8 of argv as string
71
+ end if
72
+ if (count of argv) > 8 then
73
+ set legendRange to item 9 of argv as string
74
+ end if
75
+ if (count of argv) > 9 then
76
+ set autoPositionArg to item 10 of argv as string
77
+ end if
78
+
79
+ tell application "Microsoft Excel"
80
+ if not (exists active workbook) then
81
+ return "Error: No workbook is open in Excel."
82
+ end if
83
+ end tell
84
+
85
+ -- Determine if this is a cross-sheet chart
86
+ set isCrossSheet to false
87
+ if targetSheet is not "" and sourceSheet is not "" and sourceRange is not "" then
88
+ if targetSheet is not sourceSheet then
89
+ set isCrossSheet to true
90
+ end if
91
+ end if
92
+
93
+ if isCrossSheet then
94
+ -- ============================================================
95
+ -- CROSS-SHEET MODE: Pure AppleScript API (no UI automation)
96
+ -- Create chart directly on target sheet, bind data from source.
97
+ -- ============================================================
98
+ return my createCrossSheetChart(sourceSheet, sourceRange, targetSheet, chartType, chartTitle, topLeftCell, chartWidthArg, chartHeightArg, legendRange, autoPositionArg)
99
+ else
100
+ -- ============================================================
101
+ -- SAME-SHEET MODE: Use Insert menu via System Events
102
+ -- More reliable for auto-formatting and default chart styles.
103
+ -- ============================================================
104
+ return my createSameSheetChart(chartType, chartTitle, sourceSheet, sourceRange, topLeftCell, chartWidthArg, chartHeightArg, legendRange, autoPositionArg)
105
+ end if
106
+ end run
107
+
108
+ -- Cross-sheet chart: create on target, bind data from source
109
+ on createCrossSheetChart(sourceSheet, sourceRange, targetSheet, chartTypeName, chartTitle, topLeftCell, widthArg, heightArg, legendRange, autoPositionArg)
110
+ tell application "Microsoft Excel"
111
+ try
112
+ set srcWs to worksheet sourceSheet of active workbook
113
+ set tgtWs to worksheet targetSheet of active workbook
114
+ set srcDataRange to range sourceRange of srcWs
115
+
116
+ -- Determined chart dimensions: caller-overrides win, else default.
117
+ -- Apply documented bounds: width 100-1000, height 100-800
118
+ -- (advanced.md:166-167). parseDimension itself can't see which
119
+ -- dimension it's parsing, so the clamp happens here.
120
+ set chartW to my clampDim((my parseDimension(widthArg, 480)), 100, 1000)
121
+ set chartH to my clampDim((my parseDimension(heightArg, 300)), 100, 800)
122
+
123
+ -- Position resolution:
124
+ -- 1. Explicit topLeftCell (e.g. "F2") wins regardless of autoPosition.
125
+ -- 2. autoPosition=true -> compute non-overlapping rect from existing charts/data.
126
+ -- 3. autoPosition=false -> default to (30, 30) on the target sheet.
127
+ set newLeft to 30
128
+ set newTop to 30
129
+ set havePos to false
130
+ if topLeftCell is not "" then
131
+ try
132
+ set posRange to range topLeftCell of tgtWs
133
+ set newLeft to (left position of posRange)
134
+ set newTop to (top of posRange)
135
+ set havePos to true
136
+ end try
137
+ end if
138
+
139
+ if not havePos and autoPositionArg is "true" then
140
+ set occupiedRects to {}
141
+ set existingCount to count of chart objects of tgtWs
142
+ repeat with i from 1 to existingCount
143
+ set co to chart object i of tgtWs
144
+ set cL to left position of co
145
+ set cT to top of co
146
+ set cW to width of co
147
+ set cH to height of co
148
+ set end of occupiedRects to {cL, cT, cL + cW, cT + cH}
149
+ end repeat
150
+ try
151
+ set usedRng to used range of tgtWs
152
+ set dataLeft to left position of usedRng
153
+ set dataTop to top of usedRng
154
+ set dataWidth to width of usedRng
155
+ set dataHeight to height of usedRng
156
+ set end of occupiedRects to {dataLeft, dataTop, dataLeft + dataWidth, dataTop + dataHeight}
157
+ end try
158
+ set safePos to my findSafePosition(occupiedRects, chartW, chartH)
159
+ set newLeft to item 1 of safePos
160
+ set newTop to item 2 of safePos
161
+ end if
162
+
163
+ -- Create a new chart object on the target sheet
164
+ set newChartObj to make new chart object at tgtWs with properties {width:chartW, height:chartH, left position:newLeft, top:newTop}
165
+ set newChart to chart of newChartObj
166
+
167
+ -- Bind data from source sheet
168
+ set source data newChart source srcDataRange
169
+
170
+ -- Apply legend/series names from the legendRange. Excel reads
171
+ -- the header row/column when the source range INCLUDES it, so
172
+ -- expand sourceRange to include legendRange when both are on
173
+ -- the same sheet. Best-effort; chart still works without.
174
+ if legendRange is not "" then
175
+ try
176
+ set combinedAddr to my unionRanges(sourceRange, legendRange)
177
+ if combinedAddr is not "" then
178
+ set newDataRange to range combinedAddr of srcWs
179
+ set source data newChart source newDataRange
180
+ end if
181
+ end try
182
+ end if
183
+
184
+ -- Map chart type string to AppleScript constant (must be inside tell block)
185
+ my applyChartTypeName(newChart, chartTypeName)
186
+
187
+ -- Set title if provided
188
+ if chartTitle is not "" then
189
+ set has title of newChart to true
190
+ set caption of chart title of newChart to chartTitle
191
+ end if
192
+
193
+ -- The chart was created directly on tgtWs, so there is no need
194
+ -- to make tgtWs the active sheet. Excel for Mac's
195
+ -- `set active sheet to ...` is a silent no-op anyway (verified;
196
+ -- see merge-cells / select-sheet comments). Callers should
197
+ -- reference the worksheet by name on subsequent operations.
198
+
199
+ set actualType to chart type of newChart as text
200
+ set escapedTitle to my escapeJSONString(chartTitle)
201
+ return "{\"success\":true,\"chartType\":\"" & actualType & "\",\"dataRange\":\"" & sourceRange & "\",\"title\":\"" & escapedTitle & "\",\"movedTo\":\"" & targetSheet & "\"}"
202
+ on error errMsg
203
+ return "Error: Cross-sheet chart creation failed: " & errMsg
204
+ end try
205
+ end tell
206
+ end createCrossSheetChart
207
+
208
+ -- Same-sheet chart: use Insert menu (auto-formatting, default styles)
209
+ on createSameSheetChart(chartType, chartTitle, sourceSheet, sourceRange, topLeftCell, widthArg, heightArg, legendRange, autoPositionArg)
210
+ tell application "Microsoft Excel"
211
+ -- Resolve the source range as a direct range object , never via
212
+ -- `select` + `selection`, which is fragile and depends on which
213
+ -- workbook/sheet was last active in the UI.
214
+ if sourceSheet is not "" and sourceRange is not "" then
215
+ try
216
+ set ws to worksheet sourceSheet of active workbook
217
+ set sel to range sourceRange of ws
218
+ on error errMsg
219
+ return "Error: Could not resolve source range: " & errMsg
220
+ end try
221
+ else
222
+ set sel to selection
223
+ if sel is missing value then
224
+ return "Error: Please select a data range first."
225
+ end if
226
+ set ws to active sheet
227
+ end if
228
+
229
+ set selAddress to get address of sel
230
+ set wsName to name of ws
231
+
232
+ set chartW to my parseDimension(widthArg, 480)
233
+ set chartH to my parseDimension(heightArg, 300)
234
+
235
+ set newLeft to 30
236
+ set newTop to 30
237
+ set havePos to false
238
+ if topLeftCell is not "" then
239
+ try
240
+ set posRange to range topLeftCell of ws
241
+ set newLeft to (left position of posRange)
242
+ set newTop to (top of posRange)
243
+ set havePos to true
244
+ end try
245
+ end if
246
+
247
+ if not havePos and autoPositionArg is "true" then
248
+ set occupiedRects to {}
249
+ set initialChartCount to count of chart objects of ws
250
+ repeat with i from 1 to initialChartCount
251
+ try
252
+ set co to chart object i of ws
253
+ set cL to left position of co
254
+ set cT to top of co
255
+ set cW to width of co
256
+ set cH to height of co
257
+ set end of occupiedRects to {cL, cT, cL + cW, cT + cH}
258
+ end try
259
+ end repeat
260
+ try
261
+ set usedRng to used range of ws
262
+ set dataLeft to left position of usedRng
263
+ set dataTop to top of usedRng
264
+ set dataWidth to width of usedRng
265
+ set dataHeight to height of usedRng
266
+ set end of occupiedRects to {dataLeft, dataTop, dataLeft + dataWidth, dataTop + dataHeight}
267
+ end try
268
+ set safePos to my findSafePosition(occupiedRects, chartW, chartH)
269
+ set newLeft to item 1 of safePos
270
+ set newTop to item 2 of safePos
271
+ end if
272
+
273
+ try
274
+ -- Pure Apple Event: `make new chart object` does NOT raise Excel.
275
+ -- The previous UIA path (`activate` + Insert menu click via System
276
+ -- Events) was the dominant cause of Excel popping over Delegate
277
+ -- during chart creation.
278
+ set newChartObj to make new chart object at ws with properties {width:chartW, height:chartH, left position:newLeft, top:newTop}
279
+ set newChart to chart of newChartObj
280
+ set source data newChart source sel
281
+
282
+ -- Expand to include legend headers when caller passed legendRange.
283
+ if legendRange is not "" then
284
+ try
285
+ set combinedAddr to my unionRanges(selAddress, legendRange)
286
+ if combinedAddr is not "" then
287
+ set newDataRange to range combinedAddr of ws
288
+ set source data newChart source newDataRange
289
+ end if
290
+ end try
291
+ end if
292
+
293
+ my applyChartTypeName(newChart, chartType)
294
+
295
+ if chartTitle is not "" then
296
+ set has title of newChart to true
297
+ set caption of chart title of newChart to chartTitle
298
+ end if
299
+
300
+ set actualType to chart type of newChart as text
301
+ set escapedTitle to my escapeJSONString(chartTitle)
302
+ return "{\"success\":true,\"chartType\":\"" & actualType & "\",\"dataRange\":\"" & selAddress & "\",\"title\":\"" & escapedTitle & "\",\"movedTo\":\"\"}"
303
+ on error errMsg
304
+ return "Error: Chart creation failed: " & errMsg
305
+ end try
306
+ end tell
307
+ end createSameSheetChart
308
+
309
+ -- Pure helper: given a list of occupied rectangles {left, top, right, bottom},
310
+ -- return a {left, top} position for a new chart of size chartW x chartH
311
+ -- that does not overlap any of them.
312
+ -- Strategy: place to the right of the rightmost content; if that would exceed
313
+ -- 2000 pts wide (~27 in), stack below all content instead.
314
+ on findSafePosition(occupiedRects, chartW, chartH)
315
+ if (count of occupiedRects) = 0 then
316
+ return {30, 30}
317
+ end if
318
+
319
+ set maxRight to 0
320
+ set maxBottom to 0
321
+ repeat with r in occupiedRects
322
+ if item 3 of r > maxRight then set maxRight to item 3 of r
323
+ if item 4 of r > maxBottom then set maxBottom to item 4 of r
324
+ end repeat
325
+
326
+ set gap to 40
327
+ set candidateLeft to maxRight + gap
328
+ if candidateLeft + chartW < 2000 then
329
+ -- Place to the right, aligned to the top of the sheet
330
+ return {candidateLeft, 30}
331
+ end if
332
+ -- Fallback: stack below all existing content
333
+ return {30, maxBottom + gap}
334
+ end findSafePosition
335
+
336
+ -- Helper function to escape special characters for JSON strings
337
+ on escapeJSONString(theText)
338
+ set theText to my replaceText(theText, "\\", "\\\\")
339
+ set theText to my replaceText(theText, "\"", "\\\"")
340
+ set theText to my replaceText(theText, return, "\\n")
341
+ set theText to my replaceText(theText, linefeed, "\\n")
342
+ set theText to my replaceText(theText, tab, "\\t")
343
+ return theText
344
+ end escapeJSONString
345
+
346
+ -- Helper function to replace text
347
+ on replaceText(theText, searchStr, replaceStr)
348
+ set AppleScript's text item delimiters to searchStr
349
+ set theItems to text items of theText
350
+ set AppleScript's text item delimiters to replaceStr
351
+ set theText to theItems as string
352
+ set AppleScript's text item delimiters to ""
353
+ return theText
354
+ end replaceText
355
+
356
+ -- Parse a stringified pixel dimension ("500", "", "0") into an integer.
357
+ -- Falls back to `defaultV` when the arg is empty, non-numeric, or <= 0.
358
+ -- Clamps documented bounds (advanced.md:166-167): width 100-1000, height 100-800.
359
+ -- Clamp a parsed dimension to the documented bounds. Returns lo when n<lo,
360
+ -- hi when n>hi, n otherwise. Codex review on PR #3880 round 14 flagged
361
+ -- that parseDimension returned any positive int despite the doc comment
362
+ -- claiming clamping happened.
363
+ on clampDim(n, lo, hi)
364
+ if n < lo then return lo
365
+ if n > hi then return hi
366
+ return n
367
+ end clampDim
368
+
369
+ on parseDimension(dimStr, defaultV)
370
+ if dimStr is "" then return defaultV
371
+ try
372
+ set n to dimStr as integer
373
+ if n <= 0 then return defaultV
374
+ return n
375
+ on error
376
+ return defaultV
377
+ end try
378
+ end parseDimension
379
+
380
+ -- Map the TS-side short chart-type token onto the matching Excel
381
+ -- AppleScript chart-type constant. Centralised so cross-sheet and
382
+ -- same-sheet paths stay in sync. Codex review round 11 flagged that
383
+ -- only 5 of the 24 documented chart types had branches.
384
+ -- Map the TS-side short chart-type token onto the matching Excel
385
+ -- AppleScript chart-type constant. Codex review round 11 + 14 expanded
386
+ -- this from 5 types to the documented set. NOTE: only the constants
387
+ -- that the Excel-for-Mac AS dictionary actually defines as keywords
388
+ -- are mapped here. Exotic types (3D variants, stock, surface, bubble,
389
+ -- radar) need «class ...» raw four-char codes which differ across
390
+ -- Excel versions and trigger -2741 parse errors when used as keywords.
391
+ -- Those unsupported tokens are rejected up front by the executor
392
+ -- (chartTypesUnsupportedOnMacOs), so they never reach this dispatch.
393
+ -- Every token in the executor's chartTypeMap MUST have a branch below:
394
+ -- a missing branch silently yields a column-clustered chart.
395
+ on applyChartTypeName(theChart, chartTypeName)
396
+ tell application "Microsoft Excel"
397
+ if chartTypeName is "column" then
398
+ -- Explicit branch even though the fallback below assigns the
399
+ -- same constant: it keeps the fallback a pure drift detector
400
+ -- rather than the happy path for the default chart type.
401
+ set chart type of theChart to column clustered
402
+ else if chartTypeName is "bar" then
403
+ set chart type of theChart to bar clustered
404
+ else if chartTypeName is "barStacked" then
405
+ set chart type of theChart to bar stacked
406
+ else if chartTypeName is "columnStacked" then
407
+ set chart type of theChart to column stacked
408
+ else if chartTypeName is "columnStacked100" then
409
+ set chart type of theChart to column stacked 100
410
+ else if chartTypeName is "line" then
411
+ set chart type of theChart to line chart
412
+ else if chartTypeName is "lineStacked" then
413
+ set chart type of theChart to line stacked
414
+ else if chartTypeName is "lineStacked100" then
415
+ set chart type of theChart to line stacked 100
416
+ else if chartTypeName is "lineMarkers" then
417
+ set chart type of theChart to line markers
418
+ else if chartTypeName is "pie" then
419
+ set chart type of theChart to pie chart
420
+ else if chartTypeName is "pieExploded" then
421
+ set chart type of theChart to pie exploded
422
+ else if chartTypeName is "area" then
423
+ set chart type of theChart to area chart
424
+ else if chartTypeName is "areaStacked" then
425
+ set chart type of theChart to area stacked
426
+ else if chartTypeName is "scatter" then
427
+ -- Markers-only scatter. The Excel-for-Mac dictionary spells this
428
+ -- enumerator as one word, `xyscatter` — `xy scatter` is not a
429
+ -- keyword and raises -2741. Both tokens used to collapse onto
430
+ -- `xy scatter lines`, so a requested xlXYScatter silently came
431
+ -- back with connecting lines drawn between the points.
432
+ set chart type of theChart to xyscatter
433
+ else if chartTypeName is "scatterLines" then
434
+ set chart type of theChart to xy scatter lines
435
+ else
436
+ -- Fallback for 3D / stock / surface / bubble / radar / doughnut /
437
+ -- 3dPie / lineMarkersStacked / scatterSmooth: use column clustered.
438
+ -- Most of these require raw-code constants that don't parse as
439
+ -- keywords on Excel for Mac. Caller should pick a supported type;
440
+ -- the executor rejects them before reaching this branch, so
441
+ -- landing here means the token map and this dispatch drifted.
442
+ set chart type of theChart to column clustered
443
+ end if
444
+ end tell
445
+ end applyChartTypeName
446
+
447
+ -- Bounding-box union of two A1-style ranges (possibly on the same
448
+ -- sheet). Returns the smallest enclosing A1 range or "" on failure.
449
+ -- Used to fold a `legendRange` (header row/col) into a `sourceRange`
450
+ -- so Excel reads the series names from the chart data binding.
451
+ on unionRanges(rangeA, rangeB)
452
+ try
453
+ set aBounds to my rangeBounds(rangeA)
454
+ set bBounds to my rangeBounds(rangeB)
455
+ set minCol to item 1 of aBounds
456
+ set minRow to item 2 of aBounds
457
+ set maxCol to item 3 of aBounds
458
+ set maxRow to item 4 of aBounds
459
+ if item 1 of bBounds < minCol then set minCol to item 1 of bBounds
460
+ if item 2 of bBounds < minRow then set minRow to item 2 of bBounds
461
+ if item 3 of bBounds > maxCol then set maxCol to item 3 of bBounds
462
+ if item 4 of bBounds > maxRow then set maxRow to item 4 of bBounds
463
+ return (my colNumToLetter(minCol)) & minRow & ":" & (my colNumToLetter(maxCol)) & maxRow
464
+ on error
465
+ return ""
466
+ end try
467
+ end unionRanges
468
+
469
+ -- Strip "Sheet!" prefix and parse an A1 range into {minCol, minRow, maxCol, maxRow}.
470
+ on rangeBounds(rangeStr)
471
+ set s to rangeStr as string
472
+ -- Strip any "Sheet!" prefix.
473
+ if s contains "!" then
474
+ set AppleScript's text item delimiters to "!"
475
+ set s to last text item of s
476
+ set AppleScript's text item delimiters to ""
477
+ end if
478
+ -- Strip $ absolute markers.
479
+ set s to my replaceText(s, "$", "")
480
+ set AppleScript's text item delimiters to ":"
481
+ set parts to text items of s
482
+ set AppleScript's text item delimiters to ""
483
+ if (count of parts) = 1 then
484
+ set cellA to item 1 of parts
485
+ set cellB to cellA
486
+ else
487
+ set cellA to item 1 of parts
488
+ set cellB to item 2 of parts
489
+ end if
490
+ set aBox to my parseCellAddr(cellA)
491
+ set bBox to my parseCellAddr(cellB)
492
+ set minCol to item 1 of aBox
493
+ set minRow to item 2 of aBox
494
+ set maxCol to item 1 of bBox
495
+ set maxRow to item 2 of bBox
496
+ if item 1 of bBox < minCol then set minCol to item 1 of bBox
497
+ if item 2 of bBox < minRow then set minRow to item 2 of bBox
498
+ if item 1 of aBox > maxCol then set maxCol to item 1 of aBox
499
+ if item 2 of aBox > maxRow then set maxRow to item 2 of aBox
500
+ return {minCol, minRow, maxCol, maxRow}
501
+ end rangeBounds
502
+
503
+ on parseCellAddr(cellStr)
504
+ set colPart to ""
505
+ set rowPart to ""
506
+ repeat with i from 1 to (count of characters of cellStr)
507
+ set ch to character i of cellStr
508
+ if (ASCII number ch) >= 48 and (ASCII number ch) <= 57 then
509
+ set rowPart to rowPart & ch
510
+ else
511
+ set colPart to colPart & ch
512
+ end if
513
+ end repeat
514
+ set colNum to 0
515
+ repeat with i from 1 to (count of characters of colPart)
516
+ set ch to character i of colPart
517
+ set colNum to colNum * 26 + (ASCII number ch) - (ASCII number "A") + 1
518
+ end repeat
519
+ return {colNum, rowPart as integer}
520
+ end parseCellAddr
521
+
522
+ on colNumToLetter(n)
523
+ set result to ""
524
+ set num to n
525
+ repeat while num > 0
526
+ set remainder to ((num - 1) mod 26)
527
+ set result to (character (remainder + 1) of "ABCDEFGHIJKLMNOPQRSTUVWXYZ") & result
528
+ set num to ((num - 1) div 26)
529
+ end repeat
530
+ return result
531
+ end colNumToLetter