@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.
- package/README.md +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +722 -0
- package/dist/skills/business-analysis/as-is-capture.md +440 -0
- package/dist/skills/business-analysis/assets/progress.yaml +19 -0
- package/dist/skills/business-analysis/assets/task-list.md +34 -0
- package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
- package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
- package/dist/skills/business-analysis/case-to-be-design.md +223 -0
- package/dist/skills/business-analysis/diagram-authoring.md +215 -0
- package/dist/skills/business-analysis/industry-gaps.md +134 -0
- package/dist/skills/business-analysis/interview-spine.md +297 -0
- package/dist/skills/business-analysis/locales/de.json +54 -0
- package/dist/skills/business-analysis/locales/en.json +54 -0
- package/dist/skills/business-analysis/locales/es-MX.json +54 -0
- package/dist/skills/business-analysis/locales/es.json +54 -0
- package/dist/skills/business-analysis/locales/fr.json +54 -0
- package/dist/skills/business-analysis/locales/ja.json +54 -0
- package/dist/skills/business-analysis/locales/ko.json +54 -0
- package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
- package/dist/skills/business-analysis/locales/pt.json +54 -0
- package/dist/skills/business-analysis/locales/ro.json +54 -0
- package/dist/skills/business-analysis/locales/tr.json +54 -0
- package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
- package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
- package/dist/skills/business-analysis/pdd-generation.md +204 -0
- package/dist/skills/business-analysis/pdd-template.md +562 -0
- package/dist/skills/business-analysis/progress-presentation.json +13 -0
- package/dist/skills/business-analysis/recording-first.md +19 -0
- package/dist/skills/business-analysis/recording-processing.md +152 -0
- package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
- package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
- package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
- package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
- package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
- package/dist/skills/business-analysis/research-offer.md +104 -0
- package/dist/skills/business-analysis/research-pass.md +149 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
- package/dist/skills/business-analysis/to-be-design.md +199 -0
- package/dist/skills/confluence/SKILL.md +386 -0
- package/dist/skills/doc-coauthoring/SKILL.md +295 -0
- package/dist/skills/excel-architect/SKILL.macos.md +161 -0
- package/dist/skills/excel-architect/SKILL.md +180 -0
- package/dist/skills/excel-architect/SKILL.windows.md +61 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
- package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
- package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
- package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
- package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
- package/dist/skills/excel-architect/building.md +279 -0
- package/dist/skills/excel-architect/create.md +64 -0
- package/dist/skills/excel-architect/data-and-formulas.md +186 -0
- package/dist/skills/excel-architect/generator.md +272 -0
- package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
- package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
- package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
- package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
- package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
- package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
- package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
- package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
- package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
- package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
- package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
- package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
- package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
- package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
- package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
- package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
- package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
- package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
- package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
- package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
- package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
- package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
- package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
- package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
- package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
- package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
- package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
- package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
- package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
- package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
- package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
- package/dist/skills/excel-architect/reference/api/basic.md +747 -0
- package/dist/skills/excel-architect/reference/guides.md +348 -0
- package/dist/skills/excel-architect/reference/repair.md +174 -0
- package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
- package/dist/skills/excel-architect/scripting.md +266 -0
- package/dist/skills/excel-architect/styling-and-features.md +433 -0
- package/dist/skills/excel-architect/windows/api/composites.md +337 -0
- package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
- package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
- package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
- package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
- package/dist/skills/github/SKILL.md +446 -0
- package/dist/skills/github/recipes/add-comment.md +85 -0
- package/dist/skills/github/recipes/check-pr-status.md +122 -0
- package/dist/skills/github/recipes/compare-branches.md +79 -0
- package/dist/skills/github/recipes/create-issue.md +103 -0
- package/dist/skills/github/recipes/create-pr.md +97 -0
- package/dist/skills/github/recipes/get-file-contents.md +76 -0
- package/dist/skills/github/recipes/get-last-commit.md +128 -0
- package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
- package/dist/skills/github/recipes/list-recent-commits.md +84 -0
- package/dist/skills/github/recipes/search-issues.md +115 -0
- package/dist/skills/google-workspace/SKILL.md +217 -0
- package/dist/skills/google-workspace/services/calendar.md +311 -0
- package/dist/skills/google-workspace/services/docs.md +426 -0
- package/dist/skills/google-workspace/services/drive.md +504 -0
- package/dist/skills/google-workspace/services/gmail.md +466 -0
- package/dist/skills/google-workspace/services/sheets.md +370 -0
- package/dist/skills/internal-comms/SKILL.md +35 -0
- package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
- package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
- package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
- package/dist/skills/internal-comms/examples/general-comms.md +15 -0
- package/dist/skills/jira/SKILL.md +397 -0
- package/dist/skills/jira/recipes/add-comment.md +123 -0
- package/dist/skills/jira/recipes/assign-issue.md +157 -0
- package/dist/skills/jira/recipes/create-issue.md +274 -0
- package/dist/skills/jira/recipes/get-issue-details.md +154 -0
- package/dist/skills/jira/recipes/list-projects.md +151 -0
- package/dist/skills/jira/recipes/my-issues.md +180 -0
- package/dist/skills/jira/recipes/search-issues.md +215 -0
- package/dist/skills/jira/recipes/transition-issue.md +154 -0
- package/dist/skills/jira/recipes/troubleshooting.md +387 -0
- package/dist/skills/knowledge-base/SKILL.md +289 -0
- package/dist/skills/media-tools/SKILL.md +204 -0
- package/dist/skills/media-tools/references/encode-runbook.md +24 -0
- package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
- package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
- package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
- package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
- package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
- package/dist/skills/office-download/SKILL.md +161 -0
- package/dist/skills/outlook-365/SKILL.macos.md +331 -0
- package/dist/skills/outlook-365/SKILL.md +171 -0
- package/dist/skills/outlook-365/SKILL.windows.md +124 -0
- package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
- package/dist/skills/outlook-365/api/check-availability.md +87 -0
- package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
- package/dist/skills/outlook-365/api/download-attachments.md +149 -0
- package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
- package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
- package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
- package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
- package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
- package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
- package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
- package/dist/skills/outlook-365/api/send-email.md +396 -0
- package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
- package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
- package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
- package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
- package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
- package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
- package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
- package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
- package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
- package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
- package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
- package/dist/skills/outlook-365/uia/README.md +75 -0
- package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
- package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
- package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
- package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
- package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
- package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
- package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
- package/dist/skills/pdf-architect/SKILL.md +640 -0
- package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
- package/dist/skills/powerpoint-architect/SKILL.md +853 -0
- package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
- package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
- package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
- package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
- package/dist/skills/powerpoint-architect/images-guide.md +207 -0
- package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
- package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
- package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
- package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
- package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
- package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
- package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
- package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
- package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
- package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
- package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
- package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
- package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
- package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
- package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
- package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
- package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
- package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
- package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
- package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
- package/dist/skills/project-task-list/SKILL.md +174 -0
- package/dist/skills/slack-operation/SKILL.md +97 -0
- package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
- package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
- package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
- package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
- package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
- package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
- package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
- package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
- package/dist/skills/system-diagnostics/SKILL.md +263 -0
- package/dist/skills/teams-operation/SKILL.md +79 -0
- package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
- package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
- package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
- package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
- package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
- package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
- package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
- package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
- package/dist/skills/transcribe-media/SKILL.md +142 -0
- package/dist/skills/uipath-integrations/SKILL.md +370 -0
- package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
- package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
- package/dist/skills/uipath-integrations/reference/errors.md +211 -0
- package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
- package/dist/skills/uipath-integrations/reference/operations.md +297 -0
- package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
- package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
- package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
- package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
- package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
- package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
- package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
- package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
- package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
- package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
- package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
- package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
- package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
- package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
- package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
- package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
- package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
- package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
- package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
- package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
- package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
- package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
- package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
- package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
- package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
- package/dist/skills/word-architect/SKILL.macos.md +147 -0
- package/dist/skills/word-architect/SKILL.md +502 -0
- package/dist/skills/word-architect/SKILL.windows.md +55 -0
- package/dist/skills/word-architect/api/advanced.md +522 -0
- package/dist/skills/word-architect/api/basic.md +378 -0
- package/dist/skills/word-architect/api/expert.md +302 -0
- package/dist/skills/word-architect/generation.md +308 -0
- package/dist/skills/word-architect/layouts/01-professional.md +168 -0
- package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
- package/dist/skills/word-architect/layouts/03-academic.md +83 -0
- package/dist/skills/word-architect/layouts/04-creative.md +242 -0
- package/dist/skills/word-architect/layouts/05-operational.md +94 -0
- package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
- package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
- package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
- package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
- package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
- package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
- package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
- package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
- package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
- package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
- package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
- package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
- package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
- package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
- package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
- package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
- package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
- package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
- package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
- package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
- package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
- package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
- package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
- package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
- package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
- package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
- package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
- package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
- package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
- package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
- package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
- package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
- package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
- package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
- package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
- package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
- package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
- package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
- package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
- package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
- package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
- package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
- package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
- package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
- package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
- package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
- package/dist/skills/word-architect/reference/formatting.md +119 -0
- package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
- package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
- package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
- package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
- package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
- package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
- package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
- package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
- package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
- package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
- package/dist/skills/word-architect/reference/tables.md +62 -0
- package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
- package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
- package/dist/skills/word-architect/reference/visual-elements.md +82 -0
- package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
- package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
- package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
- package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
- package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
- package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
- package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
- package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
- package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
- package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
- package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
- package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
- package/package.json +5 -4
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
# Excel Generator Reference — Schemas & Theme Colors
|
|
2
|
+
|
|
3
|
+
> **Platform:** macOS only. On Windows, use Live Excel (`/excel/*`) endpoints via C# Interop instead.
|
|
4
|
+
|
|
5
|
+
This file contains the generator call format, sheet type schemas, formal/creative theme behavior, and the full theme color reference table for follow-up edits. **Do not skip this file** — it is required for producing valid generator JSON and for matching theme styles when editing generated workbooks.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## When to use the Generator
|
|
10
|
+
|
|
11
|
+
New workbook from scratch → ALWAYS use the Generator (`/excel-gen/generate`). Faster, more reliable, no Excel install required. Do NOT use openpyxl, Python, or bash workarounds to create `.xlsx`.
|
|
12
|
+
|
|
13
|
+
### Capabilities (complete in one call)
|
|
14
|
+
- Multiple sheets (dataTable, summary, dashboard, formatted)
|
|
15
|
+
- Formulas (any Excel formula incl. cross-sheet)
|
|
16
|
+
- Column/row formatting (widths, heights, number formats)
|
|
17
|
+
- Conditional formatting (color scales, data bars, icon sets, cell rules, top10, duplicateValues, containsText, expressions)
|
|
18
|
+
- Auto-filter, freeze panes (header or custom row/column position)
|
|
19
|
+
- Merged cells, cell styling (fonts, colors, borders, alignment)
|
|
20
|
+
- Named ranges, data validation / dropdowns
|
|
21
|
+
- Sheet protection, print settings
|
|
22
|
+
- Hyperlinks, cell comments, embedded images
|
|
23
|
+
- Total rows with per-column formula control
|
|
24
|
+
- Professional themes (consulting, modern, corporate, academic, minimal, financial)
|
|
25
|
+
|
|
26
|
+
Not produced by the Generator — add afterward via Live Excel: charts → `/excel/add-chart-from-range`; pivot tables → `/excel/create-pivot-table`. Slicers and VBA macros are unsupported.
|
|
27
|
+
|
|
28
|
+
### Call format
|
|
29
|
+
|
|
30
|
+
Call via `ExecuteSkillApi` with the `operations` array:
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"operations": [
|
|
35
|
+
{
|
|
36
|
+
"endpoint": "/excel-gen/generate",
|
|
37
|
+
"body": {
|
|
38
|
+
"options": {
|
|
39
|
+
"title": "Q4 Financial Report", "theme": "consulting", "outputPath": "/Users/me/Documents/report.xlsx",
|
|
40
|
+
"namedRanges": [{ "name": "TotalSales", "range": "Revenue!$D$2:$D$25" }],
|
|
41
|
+
"printSettings": { "orientation": "landscape", "fitToPage": true }
|
|
42
|
+
},
|
|
43
|
+
"sheets": [
|
|
44
|
+
{ "name": "Revenue", "type": "dataTable", "headers": ["Region", "Q1", "Q2", "Total"], "rows": [["APAC", 3500000, 3800000, "=SUM(B2:C2)"]], "autoFilter": true, "freezeHeader": true }
|
|
45
|
+
]
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"toolName": "Generate Workbook",
|
|
50
|
+
"description": "Creating Q4 Financial Report with revenue data"
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**Workbook `options`:**
|
|
55
|
+
|
|
56
|
+
| Field | Required | Description |
|
|
57
|
+
|-------|----------|-------------|
|
|
58
|
+
| title | **Yes** | Workbook title (call fails without it) |
|
|
59
|
+
| outputPath | **Yes** | Absolute path for the `.xlsx` |
|
|
60
|
+
| theme | No | Theme name (default `consulting`) |
|
|
61
|
+
| author, company | No | Document metadata |
|
|
62
|
+
| defaultColumnWidth, defaultRowHeight | No | Workbook-wide defaults |
|
|
63
|
+
| namedRanges | No | `[{name, range}]` — range must be fully qualified and absolute (`Sheet!$A$1:$A$9`) |
|
|
64
|
+
| printSettings | No | Workbook-wide print setup (see schema below); can also be set per sheet |
|
|
65
|
+
|
|
66
|
+
**Limits:** max 100 sheets per workbook, max 100,000 rows per sheet — the call errors above these.
|
|
67
|
+
|
|
68
|
+
**printSettings schema** (workbook-level or per-sheet): `orientation` ("portrait"/"landscape"), `paperSize` (number), `fitToPage` (boolean), `fitToWidth`/`fitToHeight` (pages), `margins` ({top, bottom, left, right, header, footer}), `printArea` ("A1:H40"), `repeatRows` ({from, to}), `headerFooter` ({oddHeader, oddFooter}).
|
|
69
|
+
|
|
70
|
+
List themes: `{ "operations": [{ "endpoint": "/excel-gen/list-themes", "body": {} }], "toolName": "List Themes", "description": "..." }`
|
|
71
|
+
|
|
72
|
+
**Themes:** `consulting` (navy, Calibri), `modern` (teal, Aptos), `corporate` (dark blue, Cambria), `academic` (black, Times New Roman), `minimal` (gray, Helvetica Neue), `financial` (navy, Calibri 10pt, parentheses for negatives).
|
|
73
|
+
|
|
74
|
+
### Large payloads → `bodyFromFile`
|
|
75
|
+
|
|
76
|
+
`/excel-gen/generate` accepts `bodyFromFile` (absolute path to a JSON file) instead of inline `body`. Apply when the spec hits the SKILL.md threshold (≥ 5 sheets OR any sheet ≥ 50 rows). See SKILL.md "Read once, build once" for the static (`WriteFile`) vs repetitive (Node script) recipe.
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{ "operations": [{ "endpoint": "/excel-gen/generate", "bodyFromFile": "/tmp/workbook-<tag>.json" }], "toolName": "Generate Workbook", "description": "..." }
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Don't inline a 200-line generator spec, don't pre-draft it in `<thinking>`. Path is faster and survives the output budget.
|
|
83
|
+
|
|
84
|
+
### Generate-Then-Enhance Workflow
|
|
85
|
+
|
|
86
|
+
For workbooks needing charts or pivot tables:
|
|
87
|
+
1. `/excel-gen/generate` — create the complete workbook (data, formulas, formatting, themes)
|
|
88
|
+
2. `/excel/open-or-attach-workbook` — open the generated `.xlsx`
|
|
89
|
+
3. `/excel/add-chart-from-range` — add charts
|
|
90
|
+
4. `/excel/create-pivot-table` — add pivot tables
|
|
91
|
+
5. `/excel/save-workbook` — save
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## Formal vs Creative Themes
|
|
96
|
+
|
|
97
|
+
All current themes are `formal: true` — they use sober, professional colors. Because every shipped theme is formal, the generator **never** colors sheet tabs; generated workbooks always get Excel's default tab appearance. This keeps colorful sheet tabs off professional financial reports and dashboards.
|
|
98
|
+
|
|
99
|
+
The generator therefore has no `tabColor` field. Tab color is an **editing** operation and **macOS only**: on macOS, generate the workbook first, then set tab colors with `/excel/set-tab-color` on the sheets that need them. On Windows there is no tab-color endpoint, so tab colors cannot be set at all — do not promise them there.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Generator Sheet Type Schemas
|
|
104
|
+
|
|
105
|
+
**All sheets share:** `name` (string), `type` (string), `freezeHeader?` (boolean), `freezeRow?`, `freezeColumn?`, `columnWidths?` (Record<string, number>), `printSettings?` (per-sheet, same schema as workbook-level), `sheetProtection?`
|
|
106
|
+
|
|
107
|
+
- `columnWidths` keys are a single column letter (`"A"`) or a column range (`"B:H"`); values are widths in characters — e.g. `{"A": 16, "B:H": 15}`.
|
|
108
|
+
- `sheetProtection`: `{ "password?": string, "sheet?": boolean, "formatCells?": boolean, "formatColumns?": boolean, "insertRows?": boolean, "deleteRows?": boolean }`.
|
|
109
|
+
- `rowHeights?` (dataTable and formatted sheets): keys are a row number (`"3"`) or row range (`"2:5"`), values are heights in points — e.g. `{"3": 110}`.
|
|
110
|
+
|
|
111
|
+
### `dataTable` — Traditional data table
|
|
112
|
+
```json
|
|
113
|
+
{
|
|
114
|
+
"name": "Revenue", "type": "dataTable",
|
|
115
|
+
"headers": ["Region", "Q1", "Q2", "Total"],
|
|
116
|
+
"rows": [["APAC", 3500000, 3800000, "=SUM(B2:C2)"]],
|
|
117
|
+
"autoFilter": true, "freezeHeader": true,
|
|
118
|
+
"columnFormats": {"B": "$#,##0", "C": "$#,##0"},
|
|
119
|
+
"totalRow": {"label": "TOTAL", "formula": "SUM", "labelColumns": 1,
|
|
120
|
+
"columnOverrides": {"2": "AVERAGE", "3": "NONE"}},
|
|
121
|
+
"conditionalFormatting": [{"range": "B2:C10", "type": "colorScale"}],
|
|
122
|
+
"dataValidation": [{"range": "A2:A100", "type": "list", "formulae": ["APAC,EMEA,NA"]}]
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
**`conditionalFormatting` rule schema** (dataTable sheets) — `range` + `type` plus type-specific fields:
|
|
127
|
+
|
|
128
|
+
| type | Fields |
|
|
129
|
+
|------|--------|
|
|
130
|
+
| colorScale | `min`, `mid`, `max` (hex colors, e.g. `"#F8696B"`, `"#FFEB84"`, `"#63BE7B"`) |
|
|
131
|
+
| dataBar | `color` (hex) |
|
|
132
|
+
| cellIs | `operator` ("greaterThan"/"lessThan"/"equal"/"between"), `formulae` (values), `style` |
|
|
133
|
+
| expression | `formulae` (formula string), `style` |
|
|
134
|
+
| iconSet | `iconSet` ("3Arrows", "3TrafficLights", "4Arrows", "5Arrows", "3Symbols", "4Rating", "5Rating") |
|
|
135
|
+
| top10 | `rank` (N), `percent` (true = top N%) |
|
|
136
|
+
| duplicateValues | `style` |
|
|
137
|
+
| containsText | `text`, `style` |
|
|
138
|
+
|
|
139
|
+
`style` shape: `{"font": {"color": "#RRGGBB", "bold": true}, "fill": {"bgColor": "#RRGGBB"}}`.
|
|
140
|
+
|
|
141
|
+
**`dataValidation` rule schema** (dataTable AND formatted sheets): `range`, `type` ("list"/"whole"/"decimal"/"date"/"textLength"/"custom"), `formulae`, plus optional `operator` ("between"/"greaterThan"/"lessThan"/"equal"), `allowBlank`, `showErrorMessage`, `errorTitle`, `error`, `showInputMessage`, `promptTitle`, `prompt`.
|
|
142
|
+
|
|
143
|
+
### `summary` — Label-value pairs
|
|
144
|
+
```json
|
|
145
|
+
{
|
|
146
|
+
"name": "Summary", "type": "summary",
|
|
147
|
+
"title": "Q4 Financial Summary",
|
|
148
|
+
"items": [
|
|
149
|
+
{"label": "Total Revenue", "value": 15000000, "format": "$#,##0"},
|
|
150
|
+
{"label": "Growth Rate", "value": 0.12, "format": "0.0%"}
|
|
151
|
+
]
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### `dashboard` — Multiple sections (KPI or table). REQUIRES `sections` array, NOT `rows`.
|
|
156
|
+
```json
|
|
157
|
+
{
|
|
158
|
+
"name": "Dashboard", "type": "dashboard",
|
|
159
|
+
"sections": [
|
|
160
|
+
{
|
|
161
|
+
"title": "Key Metrics",
|
|
162
|
+
"items": [
|
|
163
|
+
{"label": "Revenue", "value": 15000000, "format": "$#,##0"},
|
|
164
|
+
{"label": "Margin", "value": 0.23, "format": "0.0%"}
|
|
165
|
+
]
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
"title": "Top Products",
|
|
169
|
+
"headers": ["Product", "Revenue", "Units"],
|
|
170
|
+
"rows": [["Widget A", 5000000, 12000], ["Widget B", 3500000, 8500]]
|
|
171
|
+
}
|
|
172
|
+
]
|
|
173
|
+
}
|
|
174
|
+
```
|
|
175
|
+
- Section with `items` = KPI section (label-value pairs like summary)
|
|
176
|
+
- Section with `headers` + `rows` = table section (data table within dashboard)
|
|
177
|
+
|
|
178
|
+
### `formatted` — Freeform cells with styles and merges
|
|
179
|
+
```json
|
|
180
|
+
{
|
|
181
|
+
"name": "Cover", "type": "formatted",
|
|
182
|
+
"cells": [
|
|
183
|
+
{"cell": "A1", "value": "Q4 Report", "style": {"bold": true, "fontSize": 24, "fontColor": "#1F4E79"}},
|
|
184
|
+
{"cell": "A3", "value": "Long explanation text...", "style": {"wrapText": true, "verticalAlignment": "top"},
|
|
185
|
+
"comment": "Cell note text — renders as an Excel comment on the cell"},
|
|
186
|
+
{"cell": "A5", "value": "=SUM(Data!F2:F25)", "style": {"numberFormat": "$#,##0.00", "bold": true}},
|
|
187
|
+
{"cell": "B5", "value": {"hyperlink": "https://example.com", "text": "example.com"}, "style": {"fontColor": "#0563C1"}}
|
|
188
|
+
],
|
|
189
|
+
"mergedRegions": [
|
|
190
|
+
{"range": "A1:F1", "value": "Q4 Report", "style": {"bold": true, "fontSize": 24, "bgColor": "#1F4E79", "fontColor": "#FFFFFF", "horizontalAlignment": "center"}}
|
|
191
|
+
],
|
|
192
|
+
"images": [{"base64": "...", "type": "png", "position": {"tl": {"col": 0, "row": 5}}, "width": 400, "height": 200}],
|
|
193
|
+
"rowHeights": {"3": 110},
|
|
194
|
+
"dataValidation": [{"range": "C2:C20", "type": "list", "formulae": ["Yes,No"]}]
|
|
195
|
+
}
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
- Cell `value` forms: string (a leading `=` makes it a live formula), number, boolean, or `{hyperlink, text}` for links.
|
|
199
|
+
- `comment?` (string) attaches an Excel cell note.
|
|
200
|
+
- **`style` (CellStyle) fields:** `bold?`, `italic?`, `fontSize?`, `fontName?`, `fontColor?` (hex), `bgColor?` (hex), `horizontalAlignment?` ("left"/"center"/"right"), `verticalAlignment?` ("top"/"middle"/"bottom"), `wrapText?` (boolean), `numberFormat?` (Excel format string), `border?` (boolean, theme borders). Nothing else — there is no underline or font-strike field.
|
|
201
|
+
- `images` entries: `type` ("png"/"jpeg"/"gif"), one of `base64` or `path` (absolute file path), `position.tl` `{col, row}` (0-based) with optional `position.br`, or `width`+`height` in pixels.
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
## totalRow & Cross-Sheet Formula Guide
|
|
206
|
+
|
|
207
|
+
**`columnOverrides` uses 0-based column indices** counting from the first header. With `labelColumns: 1`, column 0 is the label — override keys start at 1:
|
|
208
|
+
|
|
209
|
+
```
|
|
210
|
+
Headers: [Region, Q1, Q2, Total, Growth%]
|
|
211
|
+
Index: 0 1 2 3 4
|
|
212
|
+
```
|
|
213
|
+
- `"formula": "SUM"` applies SUM to all columns after `labelColumns`
|
|
214
|
+
- `"columnOverrides": {"3": "NONE", "4": "AVERAGE"}` skips Total, averages Growth%
|
|
215
|
+
- Custom formula: `"3": "=C{end}/C{start}"` — `{start}` and `{end}` resolve to first/last data row numbers
|
|
216
|
+
|
|
217
|
+
**Cross-sheet formulas in row data** — pass as strings starting with `=`:
|
|
218
|
+
```json
|
|
219
|
+
"rows": [
|
|
220
|
+
["Engineering", "=COUNTIF(Employees!B2:B13,\"Engineering\")",
|
|
221
|
+
"=SUMIF(Employees!B2:B13,\"Engineering\",Employees!D2:D13)", "=C2/B2"]
|
|
222
|
+
]
|
|
223
|
+
```
|
|
224
|
+
Escape inner quotes with `\"`. The generator preserves these as-is in the .xlsx output.
|
|
225
|
+
|
|
226
|
+
**Avoid these functions** — they cause `#NAME?` errors in Excel after file open:
|
|
227
|
+
- `MAXIFS` / `MINIFS` → use `=MAX(IF(range=criteria,values))` instead
|
|
228
|
+
- `MATCH(TRUE, range>value, 0)` → use `=MATCH(1,INDEX((range>value)*1,0),0)` instead
|
|
229
|
+
- Array formulas with nested `COUNTIF` inside `MAX` → pre-compute in helper cells
|
|
230
|
+
|
|
231
|
+
These newer functions are written correctly by the generator but Excel re-saves them with `_xludf.` prefix, breaking the formula.
|
|
232
|
+
|
|
233
|
+
---
|
|
234
|
+
|
|
235
|
+
## Theme Color Reference for Follow-Up Edits
|
|
236
|
+
|
|
237
|
+
**CRITICAL:** When editing a workbook after generation, you MUST match the theme used during generation. Use the exact colors and fonts below for any new sheets, tables, headers, or formatting added via `/excel/format-range`.
|
|
238
|
+
|
|
239
|
+
**How to determine the theme:** Check the conversation history for the `/excel-gen/generate` call — the `theme` field in the JSON spec tells you which theme was used. If not specified, the default is `consulting`.
|
|
240
|
+
|
|
241
|
+
| Theme | Header BG | Header Text | Alt Row | Border | Accent | Title/Body Text | Font (Header) | Font (Body) | Size |
|
|
242
|
+
|-------|-----------|-------------|---------|--------|--------|-----------------|---------------|-------------|------|
|
|
243
|
+
| `consulting` | `#2F5496` | `#FFFFFF` | `#D6E4F0` | `#B4C6E7` | `#4472C4` | `#2F5496` / `#333333` | Calibri Bold | Calibri | 11 |
|
|
244
|
+
| `modern` | `#0F7B6C` | `#FFFFFF` | `#E2F0ED` | `#A7D8D0` | `#0F7B6C` | `#0F7B6C` / `#374151` | Aptos Bold | Aptos | 11 |
|
|
245
|
+
| `corporate` | `#1B3A5C` | `#FFFFFF` | `#F2F2F2` | `#8FAABE` | `#C9A227` | `#1B3A5C` / `#2D2D2D` | Cambria Bold | Calibri | 11 |
|
|
246
|
+
| `academic` | `#1A1A1A` | `#FFFFFF` | `#F5F5F5` | `#AAAAAA` | `#8B0000` | `#1A1A1A` / `#1A1A1A` | Times New Roman Bold | Georgia | 11 |
|
|
247
|
+
| `minimal` | `#2D2D2D` | `#FFFFFF` | `#FAFAFA` | `#CCCCCC` | `#666666` | `#2D2D2D` / `#4A4A4A` | Helvetica Neue Bold | Helvetica Neue | 11 |
|
|
248
|
+
| `financial` | `#2F5496` | `#FFFFFF` | `#F2F2F2` | `#B4C6E7` | `#FFFF00` | `#2F5496` / `#000000` | Calibri Bold | Calibri | 10 |
|
|
249
|
+
|
|
250
|
+
**Applying theme formatting in follow-up edits:**
|
|
251
|
+
```json
|
|
252
|
+
{
|
|
253
|
+
"endpoint": "/excel/format-range",
|
|
254
|
+
"body": {
|
|
255
|
+
"sheetName": "New Sheet",
|
|
256
|
+
"range": "A1:F1",
|
|
257
|
+
"bold": true,
|
|
258
|
+
"fontName": "Calibri",
|
|
259
|
+
"fontSize": 11,
|
|
260
|
+
"fontColorHtml": "#FFFFFF",
|
|
261
|
+
"interiorColorHtml": "#2F5496",
|
|
262
|
+
"applyThinBorders": true
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
**Rules for follow-up edits:**
|
|
268
|
+
- New headers → use Header BG + Header Text from the theme
|
|
269
|
+
- New data rows → use Body Font at theme size, alternate rows with Alt Row color
|
|
270
|
+
- Borders → use Border color with thin style
|
|
271
|
+
- Titles → use Title Text color with Bold at size 16 (14 for `financial`)
|
|
272
|
+
- `financial` theme: also apply parentheses for negatives, dash for zeros (see Number Formatting Standards in `<skill-path>/styling-and-features.md`)
|
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
#!/usr/bin/osascript
|
|
2
|
+
(*
|
|
3
|
+
* Add Data Validation to Excel Range
|
|
4
|
+
* Applies data validation rules using JXA (JavaScript for Automation) for reliable API access.
|
|
5
|
+
*
|
|
6
|
+
* Usage: osascript add-data-validation.applescript <range> <validationType> [criteria] [sheetName]
|
|
7
|
+
*
|
|
8
|
+
* Parameters:
|
|
9
|
+
* range - The cell range to apply validation to (e.g., "B2:B100")
|
|
10
|
+
* validationType - Type of validation:
|
|
11
|
+
* "list" - Dropdown list from comma-separated values
|
|
12
|
+
* "whole_number" - Integer validation
|
|
13
|
+
* "decimal" - Decimal number validation
|
|
14
|
+
* criteria - Validation criteria:
|
|
15
|
+
* For "list": comma-separated values (e.g., "Yes,No,Maybe")
|
|
16
|
+
* For numeric: "between:min:max" or "greater_than:value" or "less_than:value"
|
|
17
|
+
* sheetName - Optional: Sheet name (default: active sheet)
|
|
18
|
+
*
|
|
19
|
+
* Examples:
|
|
20
|
+
* osascript add-data-validation.applescript "B2:B100" "list" "Yes,No,Maybe"
|
|
21
|
+
* osascript add-data-validation.applescript "C2:C50" "whole_number" "between:1:100"
|
|
22
|
+
* osascript add-data-validation.applescript "D2:D50" "decimal" "greater_than:0"
|
|
23
|
+
*
|
|
24
|
+
* Output:
|
|
25
|
+
* {"success":true,"range":"B2:B100","validationType":"list"}
|
|
26
|
+
*
|
|
27
|
+
* Note: Excel must be open with an active workbook.
|
|
28
|
+
*)
|
|
29
|
+
|
|
30
|
+
on run argv
|
|
31
|
+
if (count of argv) < 2 then
|
|
32
|
+
return "Error: Missing arguments. Usage: osascript add-data-validation.applescript <range> <validationType> [criteria] [sheetName]"
|
|
33
|
+
end if
|
|
34
|
+
|
|
35
|
+
set rangeAddress to item 1 of argv as string
|
|
36
|
+
set validationType to item 2 of argv as string
|
|
37
|
+
set criteria to ""
|
|
38
|
+
set sheetName to ""
|
|
39
|
+
-- Documented (advanced.md:108) errorMessage: shown by Excel on
|
|
40
|
+
-- invalid input. Round 12 wired through. Optional; "" means none.
|
|
41
|
+
set errorMessage to ""
|
|
42
|
+
|
|
43
|
+
if (count of argv) >= 3 then
|
|
44
|
+
set criteria to item 3 of argv as string
|
|
45
|
+
end if
|
|
46
|
+
|
|
47
|
+
if (count of argv) >= 4 then
|
|
48
|
+
set sheetName to item 4 of argv as string
|
|
49
|
+
end if
|
|
50
|
+
|
|
51
|
+
if (count of argv) >= 5 then
|
|
52
|
+
set errorMessage to item 5 of argv as string
|
|
53
|
+
end if
|
|
54
|
+
|
|
55
|
+
-- Validate inputs
|
|
56
|
+
if validationType is "list" and criteria is "" then
|
|
57
|
+
return "Error: List validation requires comma-separated values as criteria."
|
|
58
|
+
end if
|
|
59
|
+
|
|
60
|
+
if validationType is not "list" and validationType is not "whole_number" and validationType is not "decimal" and validationType is not "date" and validationType is not "time" and validationType is not "text_length" and validationType is not "custom" then
|
|
61
|
+
return "Error: Unsupported validationType: \"" & validationType & "\". Use: list, whole_number, decimal, date, time, text_length, custom"
|
|
62
|
+
end if
|
|
63
|
+
|
|
64
|
+
-- Parse numeric criteria
|
|
65
|
+
set opCode to 1
|
|
66
|
+
set val1 to "0"
|
|
67
|
+
set val2 to "100"
|
|
68
|
+
set opType to "between"
|
|
69
|
+
if validationType is "custom" then
|
|
70
|
+
-- Custom validation: criteria IS the formula (e.g.
|
|
71
|
+
-- "=AND(A1>0,A1<100)"). Do NOT run parseCriteria because the
|
|
72
|
+
-- formula may contain colons or commas the splitter would
|
|
73
|
+
-- mis-tokenise. Codex review on PR #3880 round 11 flagged this.
|
|
74
|
+
set val1 to criteria
|
|
75
|
+
set opType to "custom"
|
|
76
|
+
set opCode to 1
|
|
77
|
+
else if validationType is not "list" then
|
|
78
|
+
set parsedCriteria to my parseCriteria(criteria)
|
|
79
|
+
set opType to item 1 of parsedCriteria
|
|
80
|
+
set val1 to item 2 of parsedCriteria
|
|
81
|
+
set val2 to item 3 of parsedCriteria
|
|
82
|
+
|
|
83
|
+
-- Map operator names to VBA/JXA numeric codes
|
|
84
|
+
-- 1=Between, 2=NotBetween, 3=Equal, 4=NotEqual, 5=Greater, 6=Less, 7=GreaterEqual, 8=LessEqual
|
|
85
|
+
if opType is "between" then
|
|
86
|
+
set opCode to 1
|
|
87
|
+
else if opType is "not_between" then
|
|
88
|
+
set opCode to 2
|
|
89
|
+
else if opType is "equal" then
|
|
90
|
+
set opCode to 3
|
|
91
|
+
else if opType is "not_equal" then
|
|
92
|
+
set opCode to 4
|
|
93
|
+
else if opType is "greater_than" then
|
|
94
|
+
set opCode to 5
|
|
95
|
+
else if opType is "less_than" then
|
|
96
|
+
set opCode to 6
|
|
97
|
+
else if opType is "greater_equal" then
|
|
98
|
+
set opCode to 7
|
|
99
|
+
else if opType is "less_equal" then
|
|
100
|
+
set opCode to 8
|
|
101
|
+
else if opType is "custom" then
|
|
102
|
+
-- Custom validation passes the formula as formula1; opCode is
|
|
103
|
+
-- ignored by Excel for type 7, but xlValidateCustom expects the
|
|
104
|
+
-- operator field set to something valid (1 = between).
|
|
105
|
+
set opCode to 1
|
|
106
|
+
else
|
|
107
|
+
set opCode to 1
|
|
108
|
+
end if
|
|
109
|
+
end if
|
|
110
|
+
|
|
111
|
+
-- Map validation type to numeric code
|
|
112
|
+
-- 1=WholeNumber, 2=Decimal, 3=List, 4=Date, 5=Time, 6=TextLength, 7=Custom
|
|
113
|
+
set typeCode to 3
|
|
114
|
+
if validationType is "whole_number" then
|
|
115
|
+
set typeCode to 1
|
|
116
|
+
else if validationType is "decimal" then
|
|
117
|
+
set typeCode to 2
|
|
118
|
+
else if validationType is "list" then
|
|
119
|
+
set typeCode to 3
|
|
120
|
+
else if validationType is "date" then
|
|
121
|
+
set typeCode to 4
|
|
122
|
+
else if validationType is "time" then
|
|
123
|
+
set typeCode to 5
|
|
124
|
+
else if validationType is "text_length" then
|
|
125
|
+
set typeCode to 6
|
|
126
|
+
else if validationType is "custom" then
|
|
127
|
+
set typeCode to 7
|
|
128
|
+
end if
|
|
129
|
+
|
|
130
|
+
-- Build JXA code to apply validation. JXA literals embed user input
|
|
131
|
+
-- (sheet name, range, formula values, error message), so each value
|
|
132
|
+
-- MUST be a properly-escaped JS string literal. Codex review round
|
|
133
|
+
-- 12 flagged that the prior implementation only escaped single
|
|
134
|
+
-- quotes; backslashes (e.g. `C:\\temp\\new` in a list value) were
|
|
135
|
+
-- interpreted as JS escape sequences (`\t` becomes a tab). Use
|
|
136
|
+
-- jsLiteral() which escapes \\, ', \n, \r, \t, and the embedded
|
|
137
|
+
-- single-quote delimiter.
|
|
138
|
+
set jxaCode to "var excel = Application('Microsoft Excel');"
|
|
139
|
+
|
|
140
|
+
-- Resolve the target worksheet by NAME directly. The earlier path
|
|
141
|
+
-- did `activateObject(worksheet) ; sheet = activeWorkbook.activeSheet`
|
|
142
|
+
-- which depends on Excel's `activate` Apple Event actually flipping
|
|
143
|
+
-- the active sheet. macOS Excel routinely no-ops that activation,
|
|
144
|
+
-- so the rng below would target the wrong sheet. Codex review on
|
|
145
|
+
-- PR #3880 round 14 flagged the gap. Use the worksheet object
|
|
146
|
+
-- directly: `sheet.ranges[X]` works on any worksheet ref.
|
|
147
|
+
if sheetName is not "" then
|
|
148
|
+
set sheetLit to my jsLiteral(sheetName)
|
|
149
|
+
set jxaCode to jxaCode & "var sheet; try { sheet = excel.activeWorkbook.worksheets[" & sheetLit & "]; sheet.name(); } catch(e) { throw new Error('Sheet not found: ' + " & sheetLit & "); }"
|
|
150
|
+
else
|
|
151
|
+
set jxaCode to jxaCode & "var sheet = excel.activeWorkbook.activeSheet;"
|
|
152
|
+
end if
|
|
153
|
+
|
|
154
|
+
set rangeLit to my jsLiteral(rangeAddress)
|
|
155
|
+
set jxaCode to jxaCode & "var rng = sheet.ranges[" & rangeLit & "];"
|
|
156
|
+
set jxaCode to jxaCode & "try { rng.validation.delete(); } catch(e) {}"
|
|
157
|
+
|
|
158
|
+
-- Build the validation.add({...}) object, including the optional
|
|
159
|
+
-- errorMessage (`errorMessage`/`errorTitle`) when provided.
|
|
160
|
+
set errBlock to ""
|
|
161
|
+
if errorMessage is not "" then
|
|
162
|
+
set errLit to my jsLiteral(errorMessage)
|
|
163
|
+
set errBlock to ", showError: true, errorMessage: " & errLit
|
|
164
|
+
end if
|
|
165
|
+
|
|
166
|
+
if validationType is "list" then
|
|
167
|
+
set critLit to my jsLiteral(criteria)
|
|
168
|
+
set jxaCode to jxaCode & "rng.validation.add({type: " & typeCode & ", alertStyle: 1, formula1: " & critLit & errBlock & "});"
|
|
169
|
+
else
|
|
170
|
+
set val1Lit to my jsLiteral(val1)
|
|
171
|
+
set val2Lit to my jsLiteral(val2)
|
|
172
|
+
if opType is "between" or opType is "not_between" then
|
|
173
|
+
set jxaCode to jxaCode & "rng.validation.add({type: " & typeCode & ", alertStyle: 1, operator: " & opCode & ", formula1: " & val1Lit & ", formula2: " & val2Lit & errBlock & "});"
|
|
174
|
+
else
|
|
175
|
+
set jxaCode to jxaCode & "rng.validation.add({type: " & typeCode & ", alertStyle: 1, operator: " & opCode & ", formula1: " & val1Lit & errBlock & "});"
|
|
176
|
+
end if
|
|
177
|
+
end if
|
|
178
|
+
|
|
179
|
+
set rangeLit2 to my jsLiteral(rangeAddress)
|
|
180
|
+
set typeLit to my jsLiteral(validationType)
|
|
181
|
+
set jxaCode to jxaCode & "JSON.stringify({success:true,range:" & rangeLit2 & ",validationType:" & typeLit & "});"
|
|
182
|
+
|
|
183
|
+
-- Execute JXA
|
|
184
|
+
try
|
|
185
|
+
set jxaResult to do shell script "osascript -l JavaScript -e " & quoted form of jxaCode
|
|
186
|
+
return jxaResult
|
|
187
|
+
on error errMsg
|
|
188
|
+
return "Error: " & errMsg
|
|
189
|
+
end try
|
|
190
|
+
end run
|
|
191
|
+
|
|
192
|
+
-- Parse criteria string into {operator, value1, value2}
|
|
193
|
+
on parseCriteria(criteriaStr)
|
|
194
|
+
if criteriaStr is "" then
|
|
195
|
+
return {"between", "0", "100"}
|
|
196
|
+
end if
|
|
197
|
+
|
|
198
|
+
set AppleScript's text item delimiters to ":"
|
|
199
|
+
set parts to text items of criteriaStr
|
|
200
|
+
set AppleScript's text item delimiters to ""
|
|
201
|
+
|
|
202
|
+
set partCount to count of parts
|
|
203
|
+
|
|
204
|
+
if partCount is 1 then
|
|
205
|
+
return {"greater_than", item 1 of parts, ""}
|
|
206
|
+
else if partCount is 2 then
|
|
207
|
+
return {item 1 of parts, item 2 of parts, ""}
|
|
208
|
+
else if partCount >= 3 then
|
|
209
|
+
return {item 1 of parts, item 2 of parts, item 3 of parts}
|
|
210
|
+
end if
|
|
211
|
+
|
|
212
|
+
return {"between", "0", "100"}
|
|
213
|
+
end parseCriteria
|
|
214
|
+
|
|
215
|
+
-- Helper function to replace text
|
|
216
|
+
on replaceText(theText, searchStr, replaceStr)
|
|
217
|
+
set AppleScript's text item delimiters to searchStr
|
|
218
|
+
set theItems to text items of theText
|
|
219
|
+
set AppleScript's text item delimiters to replaceStr
|
|
220
|
+
set theText to theItems as string
|
|
221
|
+
set AppleScript's text item delimiters to ""
|
|
222
|
+
return theText
|
|
223
|
+
end replaceText
|
|
224
|
+
|
|
225
|
+
-- Produce a JS-source string literal (single-quoted) safe to embed in
|
|
226
|
+
-- the JXA `do shell script "osascript -l JavaScript -e <code>"` payload.
|
|
227
|
+
-- Escapes backslash (FIRST), single quote, newline, carriage return,
|
|
228
|
+
-- and tab. Without this, user input containing backslashes (Windows
|
|
229
|
+
-- paths in list values, formulas) gets interpreted as JS escape
|
|
230
|
+
-- sequences and silently corrupts the validation rule. Codex review on
|
|
231
|
+
-- PR #3880 round 12 flagged the gap.
|
|
232
|
+
on jsLiteral(s)
|
|
233
|
+
set t to s as string
|
|
234
|
+
-- Order matters: escape backslashes FIRST so the escapes we add for
|
|
235
|
+
-- other chars don't get double-escaped.
|
|
236
|
+
set t to my replaceText(t, "\\", "\\\\")
|
|
237
|
+
set t to my replaceText(t, "'", "\\'")
|
|
238
|
+
set t to my replaceText(t, return, "\\n")
|
|
239
|
+
set t to my replaceText(t, linefeed, "\\n")
|
|
240
|
+
set t to my replaceText(t, tab, "\\t")
|
|
241
|
+
return "'" & t & "'"
|
|
242
|
+
end jsLiteral
|