@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,668 @@
|
|
|
1
|
+
# Generator Reference — JSON Format, Themes & Data Formats
|
|
2
|
+
|
|
3
|
+
This file contains detailed format specifications for the PowerPoint Generator.
|
|
4
|
+
**Loaded on demand from SKILL.md when building the generator JSON payload.**
|
|
5
|
+
|
|
6
|
+
**Endpoint:** call `ExecuteSkillApi` with `endpoint: "/ppt-gen/generate"` and the JSON below as `body`. Related endpoints: `/ppt-gen/list-themes`, `/diagram/render-mermaid`. Do NOT use `/ppt/*` — those drive an already-open PowerPoint window for editing, not creation.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## STOP — Read These 5 Rules Before Generating ANY Presentation
|
|
11
|
+
|
|
12
|
+
**These are non-negotiable. Violating any of them produces an amateur presentation.**
|
|
13
|
+
|
|
14
|
+
1. **ACTION TITLES on every slide.** Title = complete sentence stating the conclusion. "Revenue grew 18% driven by APAC" NOT "Revenue Overview". Read your titles in sequence — they must tell the story alone.
|
|
15
|
+
2. **NEVER repeat the same layout consecutively.** If slide 3 is `content`, slide 4 MUST be different (stats, comparison, chart, imageRight, timeline). Count your layouts — if any type appears 3+ times, replace one.
|
|
16
|
+
3. **SEARCH/GENERATE images BEFORE building JSON.** At least 2 slides must use `imageRight` or `imageLeft`. No excuses. Do the image search first.
|
|
17
|
+
4. **Max 30 words per slide body** (18 for image slides). If more, split into 2 slides.
|
|
18
|
+
5. **Visual variety (default, not override):** When the user hasn't specified exact slide content, aim for at least 1 `chart` + 1 `stats` + 1 image slide + 1 `comparison` or `table`. Plain bullet slides limited to 1 per deck. **But always respect user requirements first** — if they ask for 3 text slides, don't force charts into it. Charts work in ALL theme paths (built-in, custom .thmx, classic PPT themes).
|
|
19
|
+
6. **Timeline: max 4 phases per slide.** If you have 5+ phases with descriptions, split into 2 `timeline` slides. Never cram 5+ phases into one slide.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
### Presentation JSON Format
|
|
24
|
+
|
|
25
|
+
**Standard format (built-in themes):**
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"options": {
|
|
29
|
+
"title": "Presentation Title",
|
|
30
|
+
"theme": "dark-professional",
|
|
31
|
+
"outputPath": "/path/to/output.pptx",
|
|
32
|
+
"author": "Your Name",
|
|
33
|
+
"subject": "tech"
|
|
34
|
+
},
|
|
35
|
+
"slides": [
|
|
36
|
+
{
|
|
37
|
+
"layout": "title",
|
|
38
|
+
"title": "Welcome",
|
|
39
|
+
"subtitle": "A stunning presentation"
|
|
40
|
+
}
|
|
41
|
+
]
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**With custom .thmx theme file (REPLACES theme option):**
|
|
46
|
+
```json
|
|
47
|
+
{
|
|
48
|
+
"options": {
|
|
49
|
+
"title": "Presentation Title",
|
|
50
|
+
"themePath": "C:/path/to/custom-theme.thmx",
|
|
51
|
+
"outputPath": "/path/to/output.pptx",
|
|
52
|
+
"author": "Your Name"
|
|
53
|
+
},
|
|
54
|
+
"slides": [...]
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**🚨 IMPORTANT:** When using `themePath`, do NOT also specify `theme`.
|
|
59
|
+
|
|
60
|
+
**Other `options` fields:**
|
|
61
|
+
- `aspectRatio` (`'16:9'`/`'4:3'`/`'16:10'`, default `'16:9'`) — slide dimensions.
|
|
62
|
+
- `templatePath` — path to an existing `.pptx` to build slides on top of (requires PowerPoint; different from `themePath`, which extracts a theme rather than reusing a template file).
|
|
63
|
+
- `company` — shown in slide/document metadata.
|
|
64
|
+
- Per-slide `speakerNotes` (string) — set on any individual slide object, not in `options`, to attach notes to that slide.
|
|
65
|
+
|
|
66
|
+
### ⚠️ Detecting Custom Theme Requests
|
|
67
|
+
|
|
68
|
+
**Triggers for custom theme workflow → READ `custom_themes.md`:**
|
|
69
|
+
- User mentions `.thmx` or `.pptx` file path
|
|
70
|
+
- "use my theme", "corporate template", "custom theme"
|
|
71
|
+
- Any theme file reference
|
|
72
|
+
|
|
73
|
+
**Then use `themePath` with ALL slides in the `slides` array — the Generator creates everything in ONE call.** Never use an empty `slides` array.
|
|
74
|
+
|
|
75
|
+
### Themed Presentations — Visual Requirements
|
|
76
|
+
|
|
77
|
+
When using `themePath` (custom .thmx) or a classic PowerPoint theme (Ion, Retrospect, Facet, etc.), **the same visual richness rules apply**. The theme provides colors, fonts, and slide masters. You must still add charts, images, and visual layouts.
|
|
78
|
+
|
|
79
|
+
**Required minimum for ANY themed presentation:**
|
|
80
|
+
- 1+ `chart` slides with real data (bar, column, line, or pie)
|
|
81
|
+
- 1+ `stats` slides with key metrics
|
|
82
|
+
- 1+ `comparison` slides for options/contrast
|
|
83
|
+
- 1+ image slides (`imageRight` or `imageLeft`) with searched/generated images
|
|
84
|
+
- 1+ `timeline` or `features` slide for roadmaps/pillars
|
|
85
|
+
|
|
86
|
+
**Themed presentations where 4+ out of 7 slides are plain `content` layout will score LOW. Force yourself to use chart, stats, comparison, and image layouts.**
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
// GOOD themed presentation structure (7 slides):
|
|
90
|
+
{ "layout": "title" }
|
|
91
|
+
{ "layout": "stats", ... } // key metrics upfront
|
|
92
|
+
{ "layout": "imageRight", ... } // context with visual
|
|
93
|
+
{ "layout": "comparison", ... } // analysis/options
|
|
94
|
+
{ "layout": "chart", ... } // data evidence
|
|
95
|
+
{ "layout": "timeline", ... } // roadmap
|
|
96
|
+
{ "layout": "closing", ... } // action
|
|
97
|
+
|
|
98
|
+
// BAD themed presentation (avoid this):
|
|
99
|
+
{ "layout": "title" }
|
|
100
|
+
{ "layout": "content" } // TEXT DUMP
|
|
101
|
+
{ "layout": "content" } // TEXT DUMP
|
|
102
|
+
{ "layout": "content" } // TEXT DUMP
|
|
103
|
+
{ "layout": "content" } // TEXT DUMP
|
|
104
|
+
{ "layout": "content" } // TEXT DUMP
|
|
105
|
+
{ "layout": "closing" }
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
### Slide Design Guidelines
|
|
109
|
+
|
|
110
|
+
#### Content Density (The 3-Second Rule)
|
|
111
|
+
|
|
112
|
+
The audience should grasp the slide's point in 3 seconds. These limits enforce that:
|
|
113
|
+
|
|
114
|
+
| Layout | Max items | Max words (body) | Words per item |
|
|
115
|
+
|--------|-----------|-------------------|----------------|
|
|
116
|
+
| `content` | 4-5 bullets | 30 | 6-8 |
|
|
117
|
+
| `imageRight` / `imageLeft` | 3 phrases | 18 | 5-6 |
|
|
118
|
+
| `stats` | 4 metrics | N/A (labels only) | 3-4 per label |
|
|
119
|
+
| `comparison` | 3-4 per side | 25 | 6-8 |
|
|
120
|
+
| `timeline` | **max 4 phases** | 25 | 5-6 per phase |
|
|
121
|
+
|
|
122
|
+
**If content exceeds these limits, SPLIT across 2 slides.** Slides are cheap, readability is not.
|
|
123
|
+
|
|
124
|
+
**Timeline overflow prevention:** With a `themePath`, the content placeholder has limited height. For timelines with 4+ phases that each have descriptions, either (a) split into 2 slides (2 phases each) or (b) use very short descriptions (5 words max). Never put 5+ phases with descriptions in a single `timeline` slide.
|
|
125
|
+
|
|
126
|
+
#### Visual-to-Text Ratio
|
|
127
|
+
|
|
128
|
+
**70%+ of each slide should be visual content or white space.** Text should fill no more than 30% of the slide area. This means:
|
|
129
|
+
- Use `stats`, `comparison`, `timeline`, `imageRight` layouts over plain `content`
|
|
130
|
+
- Max 2 plain `content` slides per deck — convert the rest to visual layouts
|
|
131
|
+
- When in doubt, use fewer words and more white space
|
|
132
|
+
|
|
133
|
+
**Example — TOO MUCH text (will look like a Word doc):**
|
|
134
|
+
```json
|
|
135
|
+
{ "layout": "content", "title": "Analysis", "body": [
|
|
136
|
+
"Legacy systems are creating significant barriers to innovation and agility across the organization",
|
|
137
|
+
"Customer data is fragmented across multiple platforms creating inconsistent experiences",
|
|
138
|
+
"Manual processes are causing operational inefficiencies and increased error rates",
|
|
139
|
+
"Real-time inventory visibility is lacking across all retail channels",
|
|
140
|
+
"Omnichannel experience is inconsistent between online and in-store"
|
|
141
|
+
]}
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
**CORRECT — short phrases, not sentences:**
|
|
145
|
+
```json
|
|
146
|
+
{ "layout": "content", "title": "Current Challenges", "body": [
|
|
147
|
+
"Fragmented customer data across 5 platforms",
|
|
148
|
+
"Manual processes causing 23% error rate",
|
|
149
|
+
"No real-time inventory visibility"
|
|
150
|
+
]}
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
Or better — use a visual layout:
|
|
154
|
+
```json
|
|
155
|
+
{ "layout": "stats", "title": "Digital transformation addresses four critical gaps", "stats": [
|
|
156
|
+
{ "value": "$2.3M", "label": "Annual inefficiency cost" },
|
|
157
|
+
{ "value": "5", "label": "Disconnected platforms" },
|
|
158
|
+
{ "value": "23%", "label": "Process error rate" },
|
|
159
|
+
{ "value": "0%", "label": "Real-time visibility" }
|
|
160
|
+
]}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
#### Chart and Data Storytelling
|
|
164
|
+
|
|
165
|
+
- **One chart per slide** with a clear title
|
|
166
|
+
- **Label data directly** on the chart, not in a separate legend
|
|
167
|
+
- Include source citation in a caption
|
|
168
|
+
|
|
169
|
+
#### Layout Diversity (Never Repeat)
|
|
170
|
+
|
|
171
|
+
**Never use the same layout type on consecutive slides.** Vary layouts to keep the audience engaged:
|
|
172
|
+
|
|
173
|
+
**Recommended layout sequence for an 8-slide consulting deck:**
|
|
174
|
+
```
|
|
175
|
+
1. title — branded opening
|
|
176
|
+
2. stats — executive summary with 3-4 key metrics
|
|
177
|
+
3. imageRight — context/background with visual
|
|
178
|
+
4. comparison — analysis (before/after, options, or categories)
|
|
179
|
+
5. content — key findings (the ONE text-heavy slide allowed)
|
|
180
|
+
6. chart (column/line) — data evidence
|
|
181
|
+
7. stats or timeline — recommendations or roadmap
|
|
182
|
+
8. closing — call to action
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
**Layout selection rules:**
|
|
186
|
+
- Max **2 plain `content` slides** per deck (replace others with stats, comparison, timeline, imageRight)
|
|
187
|
+
- Every **3 slides**, include a "visual break" (stats, full image, chart, or big number)
|
|
188
|
+
- **Alternate image sides**: if slide 3 is `imageRight`, slide 6 should be `imageLeft`
|
|
189
|
+
- Use `stats` for metrics/KPIs, `comparison` for options/categories, `timeline` for phases/roadmap
|
|
190
|
+
- The `comparison` layout is underused — use it for before/after, pros/cons, or side-by-side options
|
|
191
|
+
|
|
192
|
+
#### Visual Richness (Defaults, Not Overrides)
|
|
193
|
+
|
|
194
|
+
**These are sensible defaults for when the user hasn't specified exact slide content.** Always prioritize what the user asked for. If they want 3 bullet slides, give them 3 bullet slides.
|
|
195
|
+
|
|
196
|
+
**When the user gives a general request** (e.g., "create a pitch deck about X"), apply these defaults:
|
|
197
|
+
- **At least 2 slides** with `imageRight` or `imageLeft` with a searched/generated image
|
|
198
|
+
- **At least 1 slide** with a chart (column, bar, line, or pie)
|
|
199
|
+
- **At least 1 slide** with `stats` layout for key metrics
|
|
200
|
+
- **No more than 1 plain `content` text-only slide**
|
|
201
|
+
- **Closing slide** should use `closing` layout
|
|
202
|
+
|
|
203
|
+
**When the user specifies exact content** (e.g., "slide 1: intro, slide 2: features list, slide 3: pricing table"), follow their structure exactly. Do not inject charts or stats they didn't ask for.
|
|
204
|
+
|
|
205
|
+
### Complete 8-Slide JSON Example (Follow This Pattern)
|
|
206
|
+
|
|
207
|
+
```json
|
|
208
|
+
{
|
|
209
|
+
"options": { "title": "Digital Transformation", "theme": "corporate-elegant", "outputPath": "...", "subject": "business" },
|
|
210
|
+
"slides": [
|
|
211
|
+
{ "layout": "title", "title": "Digital Transformation", "subtitle": "Strategic Roadmap for Retail Industry" },
|
|
212
|
+
{ "layout": "stats", "title": "Q4 Growth Highlights", "stats": [
|
|
213
|
+
{ "value": "$1.2B", "label": "Total Revenue", "change": { "direction": "up", "value": 18 } },
|
|
214
|
+
{ "value": "28.5", "suffix": "%", "label": "Profit Margin" },
|
|
215
|
+
{ "value": "342+", "label": "Active Customers" },
|
|
216
|
+
{ "value": "90", "suffix": " days", "label": "First Results" }
|
|
217
|
+
]},
|
|
218
|
+
{ "layout": "imageRight", "title": "Current Challenges", "body": ["Fragmented customer data", "Manual inventory processes", "No real-time visibility"], "image": { "path": "/searched-image.png" } },
|
|
219
|
+
{ "layout": "comparison", "title": "Traditional vs Digital-First", "comparison": { "left": { "title": "Traditional", "points": ["Siloed data", "Manual inventory", "Reactive decisions"] }, "right": { "title": "Digital-First", "points": ["Unified platform", "AI forecasting", "Predictive analytics"] } } },
|
|
220
|
+
{ "layout": "chart", "title": "Revenue by Region", "chart": { "type": "column", "data": [{ "name": "Q4 2024", "labels": ["Americas", "EMEA", "APAC"], "values": [520, 320, 395] }, { "name": "Q4 2023", "labels": ["Americas", "EMEA", "APAC"], "values": [450, 295, 310] }] } },
|
|
221
|
+
{ "layout": "features", "title": "Strategic Pillars", "columns": [
|
|
222
|
+
{ "title": "Customer", "body": ["Personalized journeys", "Omnichannel support"], "icon": "users" },
|
|
223
|
+
{ "title": "Operations", "body": ["Automated inventory", "Smart logistics"], "icon": "settings" },
|
|
224
|
+
{ "title": "Data", "body": ["Real-time dashboards", "Demand forecasting"], "icon": "bar-chart" },
|
|
225
|
+
{ "title": "Technology", "body": ["Cloud infrastructure", "API ecosystem"], "icon": "server" }
|
|
226
|
+
]},
|
|
227
|
+
{ "layout": "timeline", "title": "Implementation Roadmap", "timeline": [
|
|
228
|
+
{ "date": "Q1 2026", "title": "Foundation", "description": "Cloud migration, data platform" },
|
|
229
|
+
{ "date": "Q2 2026", "title": "Core Systems", "description": "ERP modernization, POS integration" },
|
|
230
|
+
{ "date": "Q3 2026", "title": "Intelligence", "description": "AI analytics, personalization" }
|
|
231
|
+
]},
|
|
232
|
+
{ "layout": "closing", "title": "Ready to Transform Your Business?", "subtitle": "Contact us to begin your digital journey" }
|
|
233
|
+
]
|
|
234
|
+
}
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
**Key points about this example:**
|
|
238
|
+
- Every slide uses a DIFFERENT layout (title, stats, imageRight, comparison, chart, features, timeline, closing)
|
|
239
|
+
- Titles are clear and concise (not full sentences restating the content)
|
|
240
|
+
- Stats have numeric values with labels and change indicators
|
|
241
|
+
- Image is searched/generated BEFORE building the JSON
|
|
242
|
+
- Chart uses data arrays with named series
|
|
243
|
+
- Features uses 4 columns with icons
|
|
244
|
+
- Body text is concise (under 30 words per slide)
|
|
245
|
+
|
|
246
|
+
**📖 See `windows/examples/10-slide-presentation.md` for another full example with images.**
|
|
247
|
+
|
|
248
|
+
**Key workflow (MANDATORY):**
|
|
249
|
+
1. **SELECT layouts** — vary every slide, avoid repeating the same layout
|
|
250
|
+
2. **SEARCH/GENERATE images** for 2-3 slides BEFORE building the JSON
|
|
251
|
+
3. **BUILD the JSON** with image paths, clear titles, and short body text
|
|
252
|
+
4. **CHECK** each slide body stays under 30 words (18 for image slides) — split if over
|
|
253
|
+
|
|
254
|
+
### Available Themes
|
|
255
|
+
|
|
256
|
+
**See "Strategy & Outline → 5. Theme Selection" in SKILL.md for the full theme guide.** Set the `subject` explicitly and use `theme: "auto"` (the generator rotates themes across runs for variety); set an explicit `theme` only when the user names one or for a custom `themePath`.
|
|
257
|
+
|
|
258
|
+
**Built-in themes (18):** dark-professional, ocean-blue, midnight-executive, steel-gray, corporate-elegant, minimal-clean, gradient-modern, nature-inspired, bold-impact, plain-neutral, warm-sunset, arctic-frost, forest-deep, royal-purple, coral-reef, charcoal-ink, sand-stone, electric-neon.
|
|
259
|
+
|
|
260
|
+
#### Classic PowerPoint Themes (Requires Microsoft Office)
|
|
261
|
+
|
|
262
|
+
You can also use **classic PowerPoint themes** by name! These are the themes that come pre-installed with Microsoft Office.
|
|
263
|
+
|
|
264
|
+
| Theme | Theme | Theme | Theme |
|
|
265
|
+
|-------|-------|-------|-------|
|
|
266
|
+
| `ion` | `facet` | `gallery` | `integral` |
|
|
267
|
+
| `slice` | `retrospect` | `organic` | `badge` |
|
|
268
|
+
| `parallax` | `quotable` | `savon` | `wisp` |
|
|
269
|
+
| `banded` | `dividend` | `frame` | `metropolitan` |
|
|
270
|
+
| `berlin` | `celestial` | `circuit` | `damask` |
|
|
271
|
+
| `depth` | `droplet` | `madison` | `main-event` |
|
|
272
|
+
| `mesh` | `parcel` | `view` | `vapor-trail` |
|
|
273
|
+
| `wood-type` | `ion-boardroom` | `feathered` | `basis` |
|
|
274
|
+
|
|
275
|
+
**Usage:** Simply use the theme name with ALL slides in the `slides` array:
|
|
276
|
+
```json
|
|
277
|
+
{
|
|
278
|
+
"options": {
|
|
279
|
+
"theme": "ion",
|
|
280
|
+
"outputPath": "/path/to/output.pptx"
|
|
281
|
+
},
|
|
282
|
+
"slides": [
|
|
283
|
+
{ "layout": "title", "title": "Welcome", "subtitle": "Presentation" },
|
|
284
|
+
{ "layout": "content", "title": "Overview", "body": ["Point 1", "Point 2"] }
|
|
285
|
+
]
|
|
286
|
+
}
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
**Note:** Classic themes require Microsoft Office to be installed (to locate the `.thmx` files). If not found, you'll get an error with suggestions for built-in themes.
|
|
290
|
+
|
|
291
|
+
**Default behavior:** Classic themes use `full` mode by default, which applies the **actual theme visual design** (triangular patterns, gradients, slide layouts, etc.) - not just colors. The generator creates the themed presentation AND adds all slides via PowerPoint automation in one call.
|
|
292
|
+
|
|
293
|
+
**For colors-only (fast, no visual design):**
|
|
294
|
+
```json
|
|
295
|
+
{
|
|
296
|
+
"options": {
|
|
297
|
+
"theme": "ion",
|
|
298
|
+
"themeMode": "extract",
|
|
299
|
+
"outputPath": "/path/to/output.pptx"
|
|
300
|
+
},
|
|
301
|
+
"slides": [...]
|
|
302
|
+
}
|
|
303
|
+
```
|
|
304
|
+
⚠️ `extract` mode only extracts colors/fonts - you won't get the actual Ion visual design.
|
|
305
|
+
|
|
306
|
+
---
|
|
307
|
+
|
|
308
|
+
#### Custom Theme from .thmx or .pptx Files
|
|
309
|
+
|
|
310
|
+
You can use your own custom theme from a `.thmx` theme file or extract the theme from an existing `.pptx` presentation.
|
|
311
|
+
|
|
312
|
+
**Two modes available via `themeMode` option:**
|
|
313
|
+
|
|
314
|
+
| Mode | Description | Requires Office? | Slide Layouts |
|
|
315
|
+
|------|-------------|------------------|---------------|
|
|
316
|
+
| `full` (default) | Uses PowerPoint to apply complete theme | ✅ Yes | ✅ Preserved |
|
|
317
|
+
| `extract` | Extracts colors/fonts only, generates directly | ❌ No | ❌ Uses built-in |
|
|
318
|
+
|
|
319
|
+
**Example - Extract mode (fast, no Office needed):**
|
|
320
|
+
```json
|
|
321
|
+
{
|
|
322
|
+
"options": {
|
|
323
|
+
"themePath": "C:/path/to/custom-theme.thmx",
|
|
324
|
+
"themeMode": "extract",
|
|
325
|
+
"outputPath": "/path/to/output.pptx"
|
|
326
|
+
},
|
|
327
|
+
"slides": [...]
|
|
328
|
+
}
|
|
329
|
+
```
|
|
330
|
+
|
|
331
|
+
**Example - Full mode with slides (one-step, recommended):**
|
|
332
|
+
```json
|
|
333
|
+
{
|
|
334
|
+
"options": {
|
|
335
|
+
"themePath": "C:/path/to/custom-theme.thmx",
|
|
336
|
+
"themeMode": "full",
|
|
337
|
+
"outputPath": "/path/to/output.pptx"
|
|
338
|
+
},
|
|
339
|
+
"slides": [
|
|
340
|
+
{ "layout": "title", "title": "Welcome", "subtitle": "Presentation" },
|
|
341
|
+
{ "layout": "content", "title": "Overview", "body": ["Point 1", "Point 2"] },
|
|
342
|
+
{ "layout": "closing", "title": "Thank You" }
|
|
343
|
+
]
|
|
344
|
+
}
|
|
345
|
+
```
|
|
346
|
+
Include ALL slides in the `slides` array — the generator creates the themed presentation with all content in one call.
|
|
347
|
+
|
|
348
|
+
**Extracting theme from existing presentations:**
|
|
349
|
+
```json
|
|
350
|
+
{
|
|
351
|
+
"options": {
|
|
352
|
+
"themePath": "C:/path/to/existing-presentation.pptx",
|
|
353
|
+
"themeMode": "extract",
|
|
354
|
+
"outputPath": "/path/to/new-presentation.pptx"
|
|
355
|
+
},
|
|
356
|
+
"slides": [...]
|
|
357
|
+
}
|
|
358
|
+
```
|
|
359
|
+
|
|
360
|
+
**What the theme parser extracts:**
|
|
361
|
+
- **Colors:** Primary, secondary, background, text, accent colors (1-4)
|
|
362
|
+
- **Fonts:** Title font (major), body font (minor)
|
|
363
|
+
- **Mode detection:** Automatically detects light/dark mode based on background luminance
|
|
364
|
+
|
|
365
|
+
|
|
366
|
+
---
|
|
367
|
+
|
|
368
|
+
#### Stats Object Format
|
|
369
|
+
|
|
370
|
+
Each stat in the `stats[]` array:
|
|
371
|
+
```json
|
|
372
|
+
{ "value": 75, "label": "Customer Satisfaction", "suffix": "%" }
|
|
373
|
+
```
|
|
374
|
+
|
|
375
|
+
| Field | Required | Description |
|
|
376
|
+
|-------|----------|-------------|
|
|
377
|
+
| `value` | Yes | Number or string (e.g., `75`, `"1.2"`) |
|
|
378
|
+
| `label` | Yes | Short description below the number |
|
|
379
|
+
| `prefix` | No | Text before value (e.g., `"$"`) |
|
|
380
|
+
| `suffix` | No | Text after value (e.g., `"%"`, `"M"`, `"+"`) |
|
|
381
|
+
| `change` | No | `{ "value": 12, "direction": "up" }` — shows trend arrow |
|
|
382
|
+
|
|
383
|
+
**Percentage circles:** Stats with `suffix: "%"` automatically render as visual progress rings (colored arc showing the proportion filled). Use this for data that genuinely represents a percentage (0-100) like satisfaction rates, completion rates, market share, growth percentages.
|
|
384
|
+
|
|
385
|
+
**When NOT to use `suffix: "%"`:**
|
|
386
|
+
- Counts or quantities (use no suffix or `"+"`)
|
|
387
|
+
- Currency (use `prefix: "$"`)
|
|
388
|
+
- Large numbers (use `suffix: "M"` or `"K"`)
|
|
389
|
+
- Don't force `%` on non-percentage data just for visual effect — mix plain text stats with percentage circles for the best-looking slides
|
|
390
|
+
|
|
391
|
+
### Icons in Slides (Optional Enhancement)
|
|
392
|
+
|
|
393
|
+
The generator supports **react-icons** for visual richness. Icons render as images embedded directly in the slide — no fonts or plugins required.
|
|
394
|
+
|
|
395
|
+
**Supported icon sets:** `Fa`/`Fa6` (Font Awesome), `Md` (Material Design), `Io`/`Io5` (Ionicons), `Fi` (Feather), `Bs` (Bootstrap), `Hi`/`Hi2` (Heroicons), `Ri` (Remix), `Lu` (Lucide), `Tb` (Tabler), `Bi` (BoxIcons), `Ai` (Ant Design), `Gi` (Game Icons), `Wi` (Weather Icons), `Pi` (Phosphor), `Ci`, `Go` (Octicons), `Gr` (Grommet), `Im` (IcoMoon), `Si` (Simple Icons), `Sl` (Simple Line), `Ti` (Typicons), `Vsc` (VS Code), `Cg` (css.gg), `Tfi` (Themify), `Lia` (Line Awesome).
|
|
396
|
+
|
|
397
|
+
**Where icons work:**
|
|
398
|
+
|
|
399
|
+
| Layout | Field | Effect |
|
|
400
|
+
|--------|-------|--------|
|
|
401
|
+
| `content` | `body` as `BulletItem[]` | Icon replaces bullet character |
|
|
402
|
+
| `twoColumn` | `columns[].icon` | Icon centered above column title |
|
|
403
|
+
| `stats` | `stats[].icon` | Icon above the stat value |
|
|
404
|
+
| `timeline` | `timeline.items[].icon` | Icon replaces timeline dot |
|
|
405
|
+
| `features` | `columns[].icon` | Icon in colored circle on each feature card |
|
|
406
|
+
|
|
407
|
+
**Content slide with icon bullets:**
|
|
408
|
+
```json
|
|
409
|
+
{
|
|
410
|
+
"layout": "content",
|
|
411
|
+
"title": "Our Services",
|
|
412
|
+
"body": [
|
|
413
|
+
{ "text": "Cloud Infrastructure", "icon": "FaCloud" },
|
|
414
|
+
{ "text": "Security & Compliance", "icon": "FaShieldAlt" },
|
|
415
|
+
{ "text": "24/7 Support", "icon": "FaHeadset" }
|
|
416
|
+
]
|
|
417
|
+
}
|
|
418
|
+
```
|
|
419
|
+
|
|
420
|
+
**Features slide with icon cards:**
|
|
421
|
+
```json
|
|
422
|
+
{
|
|
423
|
+
"layout": "features",
|
|
424
|
+
"title": "Why Choose Us",
|
|
425
|
+
"columns": [
|
|
426
|
+
{ "title": "Fast Deployment", "body": "Get up and running in minutes with our streamlined setup process", "icon": "FaRocket" },
|
|
427
|
+
{ "title": "Enterprise Security", "body": "Bank-grade encryption and compliance with SOC2 and ISO 27001", "icon": "FaShieldAlt" },
|
|
428
|
+
{ "title": "24/7 Support", "body": "Round-the-clock expert support with guaranteed response times", "icon": "FaHeadset" },
|
|
429
|
+
{ "title": "Scalability", "body": "Seamlessly scale from startup to enterprise with zero downtime", "icon": "FaExpand" }
|
|
430
|
+
]
|
|
431
|
+
}
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
**Stats with icons:**
|
|
435
|
+
```json
|
|
436
|
+
{
|
|
437
|
+
"layout": "stats",
|
|
438
|
+
"title": "Key Metrics",
|
|
439
|
+
"stats": [
|
|
440
|
+
{ "value": 99.9, "label": "Uptime", "suffix": "%", "icon": "FaServer" },
|
|
441
|
+
{ "value": 50, "label": "Countries", "suffix": "+", "icon": "FaGlobe" }
|
|
442
|
+
]
|
|
443
|
+
}
|
|
444
|
+
```
|
|
445
|
+
|
|
446
|
+
**Timeline with icons:**
|
|
447
|
+
```json
|
|
448
|
+
{
|
|
449
|
+
"layout": "timeline",
|
|
450
|
+
"title": "Our Journey",
|
|
451
|
+
"timeline": {
|
|
452
|
+
"items": [
|
|
453
|
+
{ "date": "2020", "title": "Founded", "icon": "FaRocket" },
|
|
454
|
+
{ "date": "2022", "title": "Series A", "icon": "FaChartLine" },
|
|
455
|
+
{ "date": "2024", "title": "Global Launch", "icon": "FaGlobeAmericas" }
|
|
456
|
+
]
|
|
457
|
+
}
|
|
458
|
+
}
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
**Guidelines:**
|
|
462
|
+
- **Prefer icons over plain bullets/dots** on `timeline`, `features`, `stats`, and `content` slides — they add visual polish and make slides more engaging. Only omit icons when no suitable icon exists for the concept.
|
|
463
|
+
- Pick icons from the same set (e.g., all `Fa*`) for consistency
|
|
464
|
+
- Plain `body: ["Point 1", "Point 2"]` still works as a fallback when icons don't fit the content
|
|
465
|
+
- If an icon name is invalid, the slide falls back to default bullets/dots gracefully
|
|
466
|
+
|
|
467
|
+
---
|
|
468
|
+
|
|
469
|
+
### Chart Data Format
|
|
470
|
+
|
|
471
|
+
For `chart` layout slides, use this format:
|
|
472
|
+
|
|
473
|
+
```json
|
|
474
|
+
{
|
|
475
|
+
"layout": "chart",
|
|
476
|
+
"title": "Sales Performance",
|
|
477
|
+
"chart": {
|
|
478
|
+
"type": "bar",
|
|
479
|
+
"title": "Monthly Sales",
|
|
480
|
+
"data": [
|
|
481
|
+
{
|
|
482
|
+
"name": "2024 Sales",
|
|
483
|
+
"labels": ["Jan", "Feb", "Mar", "Apr"],
|
|
484
|
+
"values": [100, 150, 200, 175]
|
|
485
|
+
},
|
|
486
|
+
{
|
|
487
|
+
"name": "2023 Sales",
|
|
488
|
+
"labels": ["Jan", "Feb", "Mar", "Apr"],
|
|
489
|
+
"values": [80, 120, 160, 140]
|
|
490
|
+
}
|
|
491
|
+
],
|
|
492
|
+
"showLegend": true,
|
|
493
|
+
"showValues": false,
|
|
494
|
+
"showGrid": true
|
|
495
|
+
}
|
|
496
|
+
}
|
|
497
|
+
```
|
|
498
|
+
|
|
499
|
+
**Chart Types:** `bar`, `column`, `line`, `pie`, `doughnut`, `area`, `scatter`
|
|
500
|
+
|
|
501
|
+
**Chart Fields:** `type` (required), `data[]` or `categories`+`series` (required), `title`, `showLegend`, `showValues`, `showGrid` (all optional booleans/string).
|
|
502
|
+
|
|
503
|
+
**Alternative Format (also supported):**
|
|
504
|
+
```json
|
|
505
|
+
{
|
|
506
|
+
"layout": "chart",
|
|
507
|
+
"title": "Market Share",
|
|
508
|
+
"chart": {
|
|
509
|
+
"type": "pie",
|
|
510
|
+
"title": "Market Distribution",
|
|
511
|
+
"categories": ["Company A", "Company B", "Others"],
|
|
512
|
+
"series": [
|
|
513
|
+
{ "name": "Market Share", "values": [45, 35, 20] }
|
|
514
|
+
]
|
|
515
|
+
}
|
|
516
|
+
}
|
|
517
|
+
```
|
|
518
|
+
|
|
519
|
+
### Table Data Format
|
|
520
|
+
|
|
521
|
+
For `table` layout slides, use this format:
|
|
522
|
+
|
|
523
|
+
```json
|
|
524
|
+
{
|
|
525
|
+
"layout": "table",
|
|
526
|
+
"title": "Regional Performance",
|
|
527
|
+
"table": {
|
|
528
|
+
"headers": ["Region", "Revenue", "Growth %", "Target Achievement"],
|
|
529
|
+
"rows": [
|
|
530
|
+
["North", "$2.5M", "+12%", "105%"],
|
|
531
|
+
["South", "$1.8M", "+8%", "98%"],
|
|
532
|
+
["East", "$3.1M", "+15%", "112%"],
|
|
533
|
+
["West", "$2.2M", "+10%", "101%"]
|
|
534
|
+
],
|
|
535
|
+
"columnWidths": [2, 1.5, 1, 1.5]
|
|
536
|
+
}
|
|
537
|
+
}
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
**Table Fields:**
|
|
541
|
+
- `headers` (optional): Array of column header strings - displayed in bold with primary color background
|
|
542
|
+
- `rows` (required): 2D array of cell values (strings or numbers)
|
|
543
|
+
- `columnWidths` (optional): Array of relative column widths in inches
|
|
544
|
+
- **Long tables:** a table with more than 9 rows plus headers still goes on one slide: it spans the full content width (your `columnWidths` are scaled to it), its rows share the slide height (15 rows ≈ 0.35" each) and its font shrinks, down to 9 pt. Each cell must then fit in about 2 lines, roughly 14 characters per inch of column width per line. If the text still does not fit, the generation result gives each column's character limit: shorten those cells in your one corrective rebuild, or split the table across slides.
|
|
545
|
+
|
|
546
|
+
**Example with numeric data:**
|
|
547
|
+
```json
|
|
548
|
+
{
|
|
549
|
+
"layout": "table",
|
|
550
|
+
"title": "Q4 Sales by Product",
|
|
551
|
+
"table": {
|
|
552
|
+
"headers": ["Product", "Units Sold", "Revenue ($M)", "Margin %"],
|
|
553
|
+
"rows": [
|
|
554
|
+
["Product A", 15000, 4.5, 32],
|
|
555
|
+
["Product B", 12000, 3.2, 28],
|
|
556
|
+
["Product C", 8500, 2.1, 35],
|
|
557
|
+
["Product D", 6000, 1.8, 40]
|
|
558
|
+
]
|
|
559
|
+
}
|
|
560
|
+
}
|
|
561
|
+
```
|
|
562
|
+
|
|
563
|
+
---
|
|
564
|
+
|
|
565
|
+
### Diagram Format
|
|
566
|
+
|
|
567
|
+
Renders a diagram as a high-resolution image on the slide. Uses diagram definition syntax (flowcharts, sequences, state machines, ER diagrams, etc.).
|
|
568
|
+
|
|
569
|
+
```json
|
|
570
|
+
{
|
|
571
|
+
"layout": "diagram",
|
|
572
|
+
"title": "System Architecture",
|
|
573
|
+
"diagram": {
|
|
574
|
+
"code": "graph TD\n A[Web Client] --> B[API Gateway]\n B --> C[Auth Service]\n B --> D[Core Service]\n D --> E[(Database)]",
|
|
575
|
+
"caption": "High-level system architecture"
|
|
576
|
+
}
|
|
577
|
+
}
|
|
578
|
+
```
|
|
579
|
+
|
|
580
|
+
**DiagramContent fields:**
|
|
581
|
+
|
|
582
|
+
| Field | Type | Required | Description |
|
|
583
|
+
|-------|------|----------|-------------|
|
|
584
|
+
| `code` | string | Yes | Diagram definition (flowchart, sequence, etc.) |
|
|
585
|
+
| `caption` | string | No | Caption text below the diagram |
|
|
586
|
+
|
|
587
|
+
**Supported diagram types:** `graph`/`flowchart`, `sequenceDiagram`, `stateDiagram-v2`, `classDiagram`, `erDiagram`, `gantt`, `mindmap`, `timeline`
|
|
588
|
+
|
|
589
|
+
**Tips:** Keep labels short (3-5 words), limit to 8-12 nodes, use subgraphs to group components. Colors inherit from the presentation theme.
|
|
590
|
+
|
|
591
|
+
---
|
|
592
|
+
|
|
593
|
+
### Comparison Format
|
|
594
|
+
|
|
595
|
+
```json
|
|
596
|
+
{
|
|
597
|
+
"layout": "comparison",
|
|
598
|
+
"title": "Fairy Friends & Enemies",
|
|
599
|
+
"comparison": {
|
|
600
|
+
"left": {
|
|
601
|
+
"title": "Fairy Friends",
|
|
602
|
+
"points": ["Butterflies and ladybugs", "Fireflies", "Rabbits and deer", "Singing birds", "Friendly gnomes"]
|
|
603
|
+
},
|
|
604
|
+
"right": {
|
|
605
|
+
"title": "Fairy Foes",
|
|
606
|
+
"points": ["Grumpy trolls", "Mischievous goblins", "Forest litterers", "Shadow sprites"]
|
|
607
|
+
}
|
|
608
|
+
}
|
|
609
|
+
}
|
|
610
|
+
```
|
|
611
|
+
|
|
612
|
+
**Each `points` array MUST have 3-6 short, distinct items.** Never collapse a list into one long sentence — each point should be a separate array element.
|
|
613
|
+
|
|
614
|
+
**Comparison Fields:** `left`/`right` (required), each `{ title, points[], highlight? }` — set `highlight: true` on the winning/recommended side to accent it visually. `vsLabel` (optional, top-level, default `"VS"`) — the label shown between the two sides, e.g. `"OR"`, `"THEN"`.
|
|
615
|
+
|
|
616
|
+
---
|
|
617
|
+
|
|
618
|
+
### Timeline Format
|
|
619
|
+
|
|
620
|
+
`timeline` accepts either a bare array of items, or the nested `{ items, orientation }` form — both are equivalent:
|
|
621
|
+
|
|
622
|
+
```json
|
|
623
|
+
// Bare array (orientation defaults to horizontal)
|
|
624
|
+
{ "layout": "timeline", "title": "Rollout Plan", "timeline": [
|
|
625
|
+
{ "date": "Q1", "title": "Discovery", "description": "Requirements gathering", "icon": "FaSearch" },
|
|
626
|
+
{ "date": "Q2", "title": "Build", "description": "Core implementation", "icon": "FaHammer" }
|
|
627
|
+
]}
|
|
628
|
+
|
|
629
|
+
// Nested form (explicit orientation)
|
|
630
|
+
{ "layout": "timeline", "title": "Rollout Plan", "timeline": {
|
|
631
|
+
"items": [
|
|
632
|
+
{ "date": "Q1", "title": "Discovery", "icon": "FaSearch" },
|
|
633
|
+
{ "date": "Q2", "title": "Build", "icon": "FaHammer" }
|
|
634
|
+
],
|
|
635
|
+
"orientation": "vertical"
|
|
636
|
+
}}
|
|
637
|
+
```
|
|
638
|
+
|
|
639
|
+
**Timeline Fields:** each item needs `date`, `title` (required), `description`/`icon` (optional). `orientation` (`'horizontal'`/`'vertical'`, default horizontal) only applies in the nested form. Max 4 phases per slide (see rule 6 above).
|
|
640
|
+
|
|
641
|
+
---
|
|
642
|
+
|
|
643
|
+
### Team Format
|
|
644
|
+
|
|
645
|
+
```json
|
|
646
|
+
{
|
|
647
|
+
"layout": "team",
|
|
648
|
+
"title": "Meet the Team",
|
|
649
|
+
"team": [
|
|
650
|
+
{ "name": "Alex Rivera", "role": "Engineering Lead", "bio": "10 years in distributed systems", "image": { "path": "/alex.png" } },
|
|
651
|
+
{ "name": "Priya Shah", "role": "Product Manager" }
|
|
652
|
+
]
|
|
653
|
+
}
|
|
654
|
+
```
|
|
655
|
+
|
|
656
|
+
**TeamMember Fields:** `name` (required), `role`/`bio`/`image` (optional). `image` uses the same `path`/`url`/`base64` format as any other image (see "Image Format" below).
|
|
657
|
+
|
|
658
|
+
---
|
|
659
|
+
|
|
660
|
+
### Image Format
|
|
661
|
+
|
|
662
|
+
Every `image`/`images[]` field (on `imageLeft`/`imageRight`/`imageFull`, `quote.image`, `team[].image`) accepts:
|
|
663
|
+
|
|
664
|
+
```json
|
|
665
|
+
{ "path": "/local/searched-image.png", "sizing": "cover", "position": "right", "alt": "Team collaborating", "caption": "Our team in action" }
|
|
666
|
+
```
|
|
667
|
+
|
|
668
|
+
**Image Fields:** exactly one of `path` (local file, preferred), `url`, or `base64` (required); `sizing` (`'contain'`/`'cover'`/`'stretch'`), `position` (`'left'`/`'right'`/`'center'`/`'full'`/`'background'`), `alt`, `caption` — all optional. `imageFull` and `blank` slides commonly use `position: "full"` or `"background"`.
|