dimcode-darwin-arm64 0.2.19 → 0.2.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/bin/dimcode +0 -0
  2. package/bin/skills-assets/chrome-control/SKILL.md +96 -0
  3. package/bin/skills-assets/dim-workflow/SKILL.md +78 -30
  4. package/bin/skills-assets/officecli/SKILL.md +423 -0
  5. package/package.json +1 -1
  6. package/bin/skills-assets/docx/SKILL.md +0 -273
  7. package/bin/skills-assets/docx/assets/styles/academic_styles.xml +0 -250
  8. package/bin/skills-assets/docx/assets/styles/corporate_styles.xml +0 -284
  9. package/bin/skills-assets/docx/assets/styles/default_styles.xml +0 -449
  10. package/bin/skills-assets/docx/assets/xsd/aesthetic-rules.xsd +0 -470
  11. package/bin/skills-assets/docx/assets/xsd/business-rules.xsd +0 -130
  12. package/bin/skills-assets/docx/assets/xsd/common-types.xsd +0 -159
  13. package/bin/skills-assets/docx/assets/xsd/wml-subset.xsd +0 -589
  14. package/bin/skills-assets/docx/references/cjk_typography.md +0 -357
  15. package/bin/skills-assets/docx/references/cjk_university_template_guide.md +0 -184
  16. package/bin/skills-assets/docx/references/comments_guide.md +0 -191
  17. package/bin/skills-assets/docx/references/design_good_bad_examples.md +0 -829
  18. package/bin/skills-assets/docx/references/design_principles.md +0 -819
  19. package/bin/skills-assets/docx/references/openxml_element_order.md +0 -308
  20. package/bin/skills-assets/docx/references/openxml_encyclopedia_part1.md +0 -4061
  21. package/bin/skills-assets/docx/references/openxml_encyclopedia_part2.md +0 -2820
  22. package/bin/skills-assets/docx/references/openxml_encyclopedia_part3.md +0 -3381
  23. package/bin/skills-assets/docx/references/openxml_namespaces.md +0 -82
  24. package/bin/skills-assets/docx/references/openxml_units.md +0 -72
  25. package/bin/skills-assets/docx/references/scenario_a_create.md +0 -284
  26. package/bin/skills-assets/docx/references/scenario_b_edit_content.md +0 -295
  27. package/bin/skills-assets/docx/references/scenario_c_apply_template.md +0 -456
  28. package/bin/skills-assets/docx/references/track_changes_guide.md +0 -200
  29. package/bin/skills-assets/docx/references/troubleshooting.md +0 -506
  30. package/bin/skills-assets/docx/references/typography_guide.md +0 -294
  31. package/bin/skills-assets/docx/references/xsd_validation_guide.md +0 -158
  32. package/bin/skills-assets/docx/scripts/doc_to_docx.sh +0 -40
  33. package/bin/skills-assets/docx/scripts/docx_preview.sh +0 -37
  34. package/bin/skills-assets/docx/scripts/dotnet/Docx.Cli/Docx.Cli.csproj +0 -19
  35. package/bin/skills-assets/docx/scripts/dotnet/Docx.Cli/Program.cs +0 -18
  36. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/AnalyzeCommand.cs +0 -147
  37. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/ApplyTemplateCommand.cs +0 -322
  38. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/CreateCommand.cs +0 -324
  39. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/DiffCommand.cs +0 -155
  40. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/EditContentCommand.cs +0 -487
  41. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/FixOrderCommand.cs +0 -108
  42. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/MergeRunsCommand.cs +0 -122
  43. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Commands/ValidateCommand.cs +0 -107
  44. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Docx.Core.csproj +0 -15
  45. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/CommentSynchronizer.cs +0 -169
  46. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/ElementOrder.cs +0 -80
  47. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/NamespaceConstants.cs +0 -42
  48. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/RunMerger.cs +0 -81
  49. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/StyleAnalyzer.cs +0 -81
  50. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/TrackChangesHelper.cs +0 -99
  51. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/OpenXml/UnitConverter.cs +0 -23
  52. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/AestheticRecipeSamples.cs +0 -1832
  53. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/AestheticRecipeSamples_Batch1.cs +0 -910
  54. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/AestheticRecipeSamples_Batch2.cs +0 -999
  55. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/AestheticRecipeSamples_Batch3.cs +0 -1048
  56. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/AestheticRecipeSamples_Batch4.cs +0 -1038
  57. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/CharacterFormattingSamples.cs +0 -1020
  58. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/DocumentCreationSamples.cs +0 -1121
  59. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/FieldAndTocSamples.cs +0 -624
  60. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/FootnoteAndCommentSamples.cs +0 -675
  61. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/HeaderFooterSamples.cs +0 -838
  62. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/ImageSamples.cs +0 -917
  63. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/ListAndNumberingSamples.cs +0 -826
  64. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/ParagraphFormattingSamples.cs +0 -1199
  65. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/StyleSystemSamples.cs +0 -1487
  66. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/TableSamples.cs +0 -1163
  67. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Samples/TrackChangesSamples.cs +0 -595
  68. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Typography/CjkHelper.cs +0 -39
  69. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Typography/FontDefaults.cs +0 -24
  70. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Typography/PageSizes.cs +0 -20
  71. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Validation/BusinessRuleValidator.cs +0 -224
  72. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Validation/GateCheckValidator.cs +0 -148
  73. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Validation/ValidationResult.cs +0 -23
  74. package/bin/skills-assets/docx/scripts/dotnet/Docx.Core/Validation/XsdValidator.cs +0 -69
  75. package/bin/skills-assets/docx/scripts/dotnet/Docx.slnx +0 -4
  76. package/bin/skills-assets/docx/scripts/env_check.sh +0 -196
  77. package/bin/skills-assets/docx/scripts/setup.ps1 +0 -274
  78. package/bin/skills-assets/docx/scripts/setup.sh +0 -504
  79. package/bin/skills-assets/pptx-generator/SKILL.md +0 -248
  80. package/bin/skills-assets/pptx-generator/references/design-system.md +0 -392
  81. package/bin/skills-assets/pptx-generator/references/editing.md +0 -162
  82. package/bin/skills-assets/pptx-generator/references/pitfalls.md +0 -112
  83. package/bin/skills-assets/pptx-generator/references/pptxgenjs.md +0 -420
  84. package/bin/skills-assets/pptx-generator/references/slide-types.md +0 -413
  85. package/bin/skills-assets/xlsx/SKILL.md +0 -137
  86. package/bin/skills-assets/xlsx/references/create.md +0 -691
  87. package/bin/skills-assets/xlsx/references/edit.md +0 -684
  88. package/bin/skills-assets/xlsx/references/fix.md +0 -37
  89. package/bin/skills-assets/xlsx/references/format.md +0 -768
  90. package/bin/skills-assets/xlsx/references/ooxml-cheatsheet.md +0 -231
  91. package/bin/skills-assets/xlsx/references/read-analyze.md +0 -97
  92. package/bin/skills-assets/xlsx/references/validate.md +0 -772
  93. package/bin/skills-assets/xlsx/scripts/formula_check.py +0 -422
  94. package/bin/skills-assets/xlsx/scripts/libreoffice_recalc.py +0 -248
  95. package/bin/skills-assets/xlsx/scripts/shared_strings_builder.py +0 -163
  96. package/bin/skills-assets/xlsx/scripts/style_audit.py +0 -575
  97. package/bin/skills-assets/xlsx/scripts/xlsx_add_column.py +0 -395
  98. package/bin/skills-assets/xlsx/scripts/xlsx_insert_row.py +0 -274
  99. package/bin/skills-assets/xlsx/scripts/xlsx_pack.py +0 -87
  100. package/bin/skills-assets/xlsx/scripts/xlsx_reader.py +0 -362
  101. package/bin/skills-assets/xlsx/scripts/xlsx_shift_rows.py +0 -396
  102. package/bin/skills-assets/xlsx/scripts/xlsx_unpack.py +0 -130
  103. package/bin/skills-assets/xlsx/templates/minimal_xlsx/[Content_Types].xml +0 -9
  104. package/bin/skills-assets/xlsx/templates/minimal_xlsx/_rels/.rels +0 -6
  105. package/bin/skills-assets/xlsx/templates/minimal_xlsx/xl/_rels/workbook.xml.rels +0 -19
  106. package/bin/skills-assets/xlsx/templates/minimal_xlsx/xl/sharedStrings.xml +0 -33
  107. package/bin/skills-assets/xlsx/templates/minimal_xlsx/xl/styles.xml +0 -160
  108. package/bin/skills-assets/xlsx/templates/minimal_xlsx/xl/workbook.xml +0 -30
  109. package/bin/skills-assets/xlsx/templates/minimal_xlsx/xl/worksheets/sheet1.xml +0 -70
@@ -1,248 +0,0 @@
1
- ---
2
- name: pptx-generator
3
- description: "Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides."
4
- metadata:
5
- version: "1.0"
6
- category: productivity
7
- sources:
8
- - https://gitbrent.github.io/PptxGenJS/
9
- - https://github.com/microsoft/markitdown
10
- ---
11
-
12
- # PPTX Generator & Editor
13
-
14
- ## Overview
15
-
16
- This skill handles all PowerPoint tasks: reading/analyzing existing presentations, editing template-based decks via XML manipulation, and creating presentations from scratch using PptxGenJS. It includes a complete design system (color palettes, fonts, style recipes) and detailed guidance for every slide type.
17
-
18
- ## Quick Reference
19
-
20
- | Task | Approach |
21
- |------|----------|
22
- | Read/analyze content | `python -m markitdown presentation.pptx` |
23
- | Edit or create from template | See [Editing Presentations](references/editing.md) |
24
- | Create from scratch | See [Creating from Scratch](#creating-from-scratch-workflow) below |
25
-
26
- | Item | Value |
27
- |------|-------|
28
- | **Dimensions** | 10" x 5.625" (LAYOUT_16x9) |
29
- | **Colors** | 6-char hex without # (e.g., `"FF0000"`) |
30
- | **English font** | Arial (default), or approved alternatives |
31
- | **Chinese font** | Microsoft YaHei |
32
- | **Page badge position** | x: 9.3", y: 5.1" |
33
- | **Theme keys** | `primary`, `secondary`, `accent`, `light`, `bg` |
34
- | **Shapes** | RECTANGLE, OVAL, LINE, ROUNDED_RECTANGLE |
35
- | **Charts** | BAR, LINE, PIE, DOUGHNUT, SCATTER, BUBBLE, RADAR |
36
-
37
- ## Reference Files
38
-
39
- | File | Contents |
40
- |------|----------|
41
- | [slide-types.md](references/slide-types.md) | 5 slide page types (Cover, TOC, Section Divider, Content, Summary) + additional layout patterns |
42
- | [design-system.md](references/design-system.md) | Color palettes, font reference, style recipes (Sharp/Soft/Rounded/Pill), typography & spacing |
43
- | [editing.md](references/editing.md) | Template-based editing workflow, XML manipulation, formatting rules, common pitfalls |
44
- | [pitfalls.md](references/pitfalls.md) | QA process, common mistakes, critical PptxGenJS pitfalls |
45
- | [pptxgenjs.md](references/pptxgenjs.md) | Complete PptxGenJS API reference |
46
-
47
- ---
48
-
49
- ## Reading Content
50
-
51
- ```bash
52
- # Text extraction
53
- python -m markitdown presentation.pptx
54
- ```
55
-
56
- ---
57
-
58
- ## Creating from Scratch — Workflow
59
-
60
- **Use when no template or reference presentation is available.**
61
-
62
- ### Step 1: Research & Requirements
63
-
64
- Search to understand user requirements — topic, audience, purpose, tone, content depth.
65
-
66
- ### Step 2: Select Color Palette & Fonts
67
-
68
- Use the [Color Palette Reference](references/design-system.md#color-palette-reference) to select a palette matching the topic and audience. Use the [Font Reference](references/design-system.md#font-reference) to choose a font pairing.
69
-
70
- ### Step 3: Select Design Style
71
-
72
- Use the [Style Recipes](references/design-system.md#style-recipes) to choose a visual style (Sharp, Soft, Rounded, or Pill) matching the presentation tone.
73
-
74
- ### Step 4: Plan Slide Outline
75
-
76
- Classify **every slide** as exactly one of the [5 page types](references/slide-types.md). Plan the content and layout for each slide. Ensure visual variety — do NOT repeat the same layout across slides.
77
-
78
- ### Step 5: Generate Slide JS Files
79
-
80
- Create one JS file per slide in `slides/` directory. Each file must export a synchronous `createSlide(pres, theme)` function. Follow the [Slide Output Format](#slide-output-format) and the type-specific guidance in [slide-types.md](references/slide-types.md). Generate up to 5 slides concurrently using subagents if available.
81
-
82
- **Tell each subagent:**
83
- 1. File naming: `slides/slide-01.js`, `slides/slide-02.js`, etc.
84
- 2. Images go in: `slides/imgs/`
85
- 3. Final PPTX goes in: `slides/output/`
86
- 4. Dimensions: 10" x 5.625" (LAYOUT_16x9)
87
- 5. Fonts: Chinese = Microsoft YaHei, English = Arial (or approved alternative)
88
- 6. Colors: 6-char hex without # (e.g. `"FF0000"`)
89
- 7. Must use the theme object contract (see [Theme Object Contract](#theme-object-contract))
90
- 8. Must follow the [PptxGenJS API reference](references/pptxgenjs.md)
91
-
92
- ### Step 6: Compile into Final PPTX
93
-
94
- Create `slides/compile.js` to combine all slide modules:
95
-
96
- ```javascript
97
- // slides/compile.js
98
- const pptxgen = require('pptxgenjs');
99
- const pres = new pptxgen();
100
- pres.layout = 'LAYOUT_16x9';
101
-
102
- const theme = {
103
- primary: "22223b", // dark color for backgrounds/text
104
- secondary: "4a4e69", // secondary accent
105
- accent: "9a8c98", // highlight color
106
- light: "c9ada7", // light accent
107
- bg: "f2e9e4" // background color
108
- };
109
-
110
- for (let i = 1; i <= 12; i++) { // adjust count as needed
111
- const num = String(i).padStart(2, '0');
112
- const slideModule = require(`./slide-${num}.js`);
113
- slideModule.createSlide(pres, theme);
114
- }
115
-
116
- pres.writeFile({ fileName: './output/presentation.pptx' });
117
- ```
118
-
119
- Run with: `cd slides && node compile.js`
120
-
121
- ### Step 7: QA (Required)
122
-
123
- See [QA Process](references/pitfalls.md#qa-process).
124
-
125
- ### Output Structure
126
-
127
- ```
128
- slides/
129
- ├── slide-01.js # Slide modules
130
- ├── slide-02.js
131
- ├── ...
132
- ├── imgs/ # Images used in slides
133
- └── output/ # Final artifacts
134
- └── presentation.pptx
135
- ```
136
-
137
- ---
138
-
139
- ## Slide Output Format
140
-
141
- Each slide is a **complete, runnable JS file**:
142
-
143
- ```javascript
144
- // slide-01.js
145
- const pptxgen = require("pptxgenjs");
146
-
147
- const slideConfig = {
148
- type: 'cover',
149
- index: 1,
150
- title: 'Presentation Title'
151
- };
152
-
153
- // MUST be synchronous (not async)
154
- function createSlide(pres, theme) {
155
- const slide = pres.addSlide();
156
- slide.background = { color: theme.bg };
157
-
158
- slide.addText(slideConfig.title, {
159
- x: 0.5, y: 2, w: 9, h: 1.2,
160
- fontSize: 48, fontFace: "Arial",
161
- color: theme.primary, bold: true, align: "center"
162
- });
163
-
164
- return slide;
165
- }
166
-
167
- // Standalone preview - use slide-specific filename
168
- if (require.main === module) {
169
- const pres = new pptxgen();
170
- pres.layout = 'LAYOUT_16x9';
171
- const theme = {
172
- primary: "22223b",
173
- secondary: "4a4e69",
174
- accent: "9a8c98",
175
- light: "c9ada7",
176
- bg: "f2e9e4"
177
- };
178
- createSlide(pres, theme);
179
- pres.writeFile({ fileName: "slide-01-preview.pptx" });
180
- }
181
-
182
- module.exports = { createSlide, slideConfig };
183
- ```
184
-
185
- ---
186
-
187
- ## Theme Object Contract (MANDATORY)
188
-
189
- The compile script passes a theme object with these **exact keys**:
190
-
191
- | Key | Purpose | Example |
192
- |-----|---------|---------|
193
- | `theme.primary` | Darkest color, titles | `"22223b"` |
194
- | `theme.secondary` | Dark accent, body text | `"4a4e69"` |
195
- | `theme.accent` | Mid-tone accent | `"9a8c98"` |
196
- | `theme.light` | Light accent | `"c9ada7"` |
197
- | `theme.bg` | Background color | `"f2e9e4"` |
198
-
199
- **NEVER use other key names** like `background`, `text`, `muted`, `darkest`, `lightest`.
200
-
201
- ---
202
-
203
- ## Page Number Badge (REQUIRED)
204
-
205
- All slides **except Cover Page** MUST include a page number badge in the bottom-right corner.
206
-
207
- - **Position**: x: 9.3", y: 5.1"
208
- - Show current number only (e.g. `3` or `03`), NOT "3/12"
209
- - Use palette colors, keep subtle
210
-
211
- ### Circle Badge (Default)
212
-
213
- ```javascript
214
- slide.addShape(pres.shapes.OVAL, {
215
- x: 9.3, y: 5.1, w: 0.4, h: 0.4,
216
- fill: { color: theme.accent }
217
- });
218
- slide.addText("3", {
219
- x: 9.3, y: 5.1, w: 0.4, h: 0.4,
220
- fontSize: 12, fontFace: "Arial",
221
- color: "FFFFFF", bold: true,
222
- align: "center", valign: "middle"
223
- });
224
- ```
225
-
226
- ### Pill Badge
227
-
228
- ```javascript
229
- slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
230
- x: 9.1, y: 5.15, w: 0.6, h: 0.35,
231
- fill: { color: theme.accent },
232
- rectRadius: 0.15
233
- });
234
- slide.addText("03", {
235
- x: 9.1, y: 5.15, w: 0.6, h: 0.35,
236
- fontSize: 11, fontFace: "Arial",
237
- color: "FFFFFF", bold: true,
238
- align: "center", valign: "middle"
239
- });
240
- ```
241
-
242
- ---
243
-
244
- ## Dependencies
245
-
246
- - `pip install "markitdown[pptx]"` — text extraction
247
- - `npm install -g pptxgenjs` — creating from scratch
248
- - `npm install -g react-icons react react-dom sharp` — icons (optional)
@@ -1,392 +0,0 @@
1
- # Design System
2
-
3
- ## Color Palette Reference
4
-
5
- | # | Name | Colors | Style | Use Cases | Tips |
6
- |---|------|--------|-------|-----------|------|
7
- | 1 | Modern & Wellness | `#006d77` `#83c5be` `#edf6f9` `#ffddd2` `#e29578` | Fresh, soothing | Healthcare, counseling, skincare, yoga/spa | Deep teal for titles, light pink for background |
8
- | 2 | Business & Authority | `#2b2d42` `#8d99ae` `#edf2f4` `#ef233c` `#d90429` | Formal, classic | Annual reports, financial analysis, corporate intro, government | Deep blue for professionalism, bright red to highlight data |
9
- | 3 | Nature & Outdoors | `#606c38` `#283618` `#fefae0` `#dda15e` `#bc6c25` | Grounded, earthy | Outdoor gear, environmental, agriculture, historical culture | Dark green base, cream text |
10
- | 4 | Vintage & Academic | `#780000` `#c1121f` `#fdf0d5` `#003049` `#669bbc` | Classic, scholarly | Academic lectures, history reviews, museums, heritage brands | Strong contrast between deep red and deep blue |
11
- | 5 | Soft & Creative | `#cdb4db` `#ffc8dd` `#ffafcc` `#bde0fe` `#a2d2ff` | Dreamy, candy-toned | Mother & baby, desserts, women's fashion, kindergarten | Use dark gray or black for text |
12
- | 6 | Bohemian | `#ccd5ae` `#e9edc9` `#fefae0` `#faedcd` `#d4a373` | Gentle, muted | Wedding planning, home decor, organic food, slow living | Cream background, green-brown accents |
13
- | 7 | Vibrant & Tech | `#8ecae6` `#219ebc` `#023047` `#ffb703` `#fb8500` | High energy, sporty | Sports events, gyms, startup pitches, youth education | Deep blue for stability, orange as focal accent |
14
- | 8 | Craft & Artisan | `#7f5539` `#a68a64` `#ede0d4` `#656d4a` `#414833` | Rustic, coffee-toned | Coffee shops, handicrafts, traditional culture, bakery | Suited for paper/leather textures |
15
- | 9 | Tech & Night | `#000814` `#001d3d` `#003566` `#ffc300` `#ffd60a` | Deep, luminous | Tech launches, astronomy, night economy, luxury automobiles | Must use dark mode |
16
- | 10 | Education & Charts | `#264653` `#2a9d8f` `#e9c46a` `#f4a261` `#e76f51` | Clear, logical | Statistical reports, education, market analysis, general business | Perfect chart color scheme |
17
- | 11 | Forest & Eco | `#dad7cd` `#a3b18a` `#588157` `#3a5a40` `#344e41` | Monochrome gradient, forest | Landscape design, ESG reports, environmental causes, botanical | Monochrome palette is safe and cohesive |
18
- | 12 | Elegant & Fashion | `#edafb8` `#f7e1d7` `#dedbd2` `#b0c4b1` `#4a5759` | Muted, Morandi tones | Haute couture, art galleries, beauty brands, magazine style | Negative space is key |
19
- | 13 | Art & Food | `#335c67` `#fff3b0` `#e09f3e` `#9e2a2b` `#540b0e` | Rich, vintage-poster | Food documentaries, art exhibitions, ethnic themes, vintage restaurants | Works well with large color blocks |
20
- | 14 | Luxury & Mysterious | `#22223b` `#4a4e69` `#9a8c98` `#c9ada7` `#f2e9e4` | Cool, purple-toned | Jewelry showcases, hotel management, high-end consulting, psychology | Purple evokes premium atmosphere |
21
- | 15 | Pure Tech Blue | `#03045e` `#0077b6` `#00b4d8` `#90e0ef` `#caf0f8` | Futuristic, clean | Cloud/AI, water/ocean, hospitals, clean energy | Deep ocean to sky gradient |
22
- | 16 | Coastal Coral | `#0081a7` `#00afb9` `#fdfcdc` `#fed9b7` `#f07167` | Refreshing, summery | Travel, summer events, beverage brands, ocean themes | Teal and coral as complementary focal colors |
23
- | 17 | Vibrant Orange Mint | `#ff9f1c` `#ffbf69` `#ffffff` `#cbf3f0` `#2ec4b6` | Bright, cheerful | Children's events, promotional posters, FMCG, social media | Orange grabs attention, mint feels fresh |
24
- | 18 | Platinum White Gold | `#0a0a0a` `#0070F3` `#D4AF37` `#f5f5f5` `#ffffff` | Premium, professional | Agent products, corporate websites, fintech, luxury brands | White-gold base, blue for action, gold for emphasis |
25
-
26
- ---
27
-
28
- ### Agent Design System — Full Color Scale
29
-
30
- Based on the Platinum White-Gold Theme design tokens. Provides complete color scales for fine-grained design work.
31
-
32
- #### White Scale (Backgrounds & Light Surfaces)
33
-
34
- | Token | Value | Usage |
35
- |-------|-------|-------|
36
- | white-0 | `#ffffff` | Primary background |
37
- | white-50 | `#fefefe` | Slightly warm white |
38
- | white-75 | `#fcfcfc` | Near-white |
39
- | white-100 | `#fafafa` | Secondary background |
40
- | white-200 | `#f7f7f7` | Card background |
41
- | white-300 | `#f5f5f5` | Tertiary background |
42
- | white-400 | `#f0f0f0` | Separator zones |
43
- | white-500 | `#ebebeb` | Light border |
44
- | white-600 | `#e5e5e5` | Disabled background |
45
- | white-700 | `#e0e0e0` | Deep white-gray |
46
- | white-800 | `#d9d9d9` | Placeholder |
47
- | white-900 | `#d4d4d4` | Divider lines |
48
- | white-1000 | `#cccccc` | Deepest white |
49
-
50
- #### Gold Scale (Platinum Business Accent)
51
-
52
- | Token | Value | Usage |
53
- |-------|-------|-------|
54
- | gold-25 | `#FFFDF5` | Extremely light gold background |
55
- | gold-50 | `#FEF9E7` | Light gold background |
56
- | gold-75 | `#FCF3D0` | Pale gold highlight |
57
- | gold-100 | `#FAECB8` | Gold hover state |
58
- | gold-200 | `#F5DC8A` | Bright gold accent |
59
- | gold-300 | `#E8C860` | Gold hover |
60
- | gold-400 | `#D4AF37` | **Primary gold (core)** |
61
- | gold-500 | `#B8972E` | Gold text |
62
- | gold-600 | `#9A7E26` | Deep gold accent |
63
- | gold-700 | `#7C651E` | Dark gold border |
64
- | gold-800 | `#5E4C16` | Deep gold background |
65
- | gold-900 | `#40330F` | Very deep gold |
66
- | gold-1000 | `#221A08` | Black gold |
67
-
68
- #### Blue Scale (Primary Action Color)
69
-
70
- | Token | Value | Usage |
71
- |-------|-------|-------|
72
- | blue-25 | `#F0F7FF` | Extremely light blue background |
73
- | blue-50 | `#E0EFFF` | Info alert background |
74
- | blue-75 | `#C2DFFF` | Light blue highlight |
75
- | blue-100 | `#A3CFFF` | Disabled blue |
76
- | blue-200 | `#66AFFF` | Bright blue |
77
- | blue-300 | `#338FFF` | Blue hover |
78
- | blue-400 | `#0070F3` | **Primary blue (core)** |
79
- | blue-500 | `#005FCC` | Blue text |
80
- | blue-600 | `#004FA6` | Deep blue accent |
81
- | blue-700 | `#003F80` | Dark blue border |
82
- | blue-800 | `#002F5A` | Deep blue background |
83
- | blue-900 | `#001F3D` | Very deep blue |
84
- | blue-1000 | `#001026` | Black blue |
85
-
86
- #### Gray Scale (Text & Neutral Colors)
87
-
88
- | Token | Value | Usage |
89
- |-------|-------|-------|
90
- | gray-0 | `#ffffff` | White |
91
- | gray-50 | `#fafafa` | Extremely light gray |
92
- | gray-75 | `#f5f5f5` | Light gray background |
93
- | gray-100 | `#ededed` | Light divider |
94
- | gray-200 | `#d4d4d4` | Light border |
95
- | gray-300 | `#a3a3a3` | Quaternary text |
96
- | gray-400 | `#737373` | Tertiary text |
97
- | gray-500 | `#525252` | Secondary text |
98
- | gray-600 | `#404040` | Dark gray |
99
- | gray-700 | `#2e2e2e` | Dark background |
100
- | gray-800 | `#1f1f1f` | Deep background |
101
- | gray-900 | `#141414` | Very deep background |
102
- | gray-1000 | `#0a0a0a` | **Primary text (core)** |
103
-
104
- #### Opacity Values
105
-
106
- ##### Opacity Black
107
-
108
- | Opacity | Value | Usage |
109
- |---------|-------|-------|
110
- | 0% | `#0a0a0a00` | Fully transparent |
111
- | 2% | `#0a0a0a05` | Subtle overlay |
112
- | 4% | `#0a0a0a0a` | Secondary interactive background |
113
- | 8% | `#0a0a0a14` | Border / divider |
114
- | 15% | `#0a0a0a26` | Pressed state |
115
- | 20% | `#0a0a0a33` | Light overlay |
116
- | 25% | `#0a0a0a40` | Medium overlay |
117
- | 50% | `#0a0a0a80` | Semi-transparent |
118
- | 70% | `#0a0a0ab2` | Deep overlay |
119
- | 80% | `#0a0a0acc` | Hover state |
120
- | 90% | `#0a0a0ae5` | Tooltip |
121
- | 95% | `#0a0a0af2` | Modal |
122
-
123
- ##### Opacity White
124
-
125
- | Opacity | Value | Usage |
126
- |---------|-------|-------|
127
- | 0% | `#ffffff00` | Fully transparent |
128
- | 2% | `#ffffff05` | Subtle overlay |
129
- | 4% | `#ffffff0a` | Secondary interactive background |
130
- | 8% | `#ffffff12` | Border / divider |
131
- | 15% | `#ffffff26` | Pressed state |
132
- | 20% | `#ffffff33` | Light overlay |
133
- | 25% | `#ffffff40` | Medium overlay |
134
- | 50% | `#ffffff80` | Semi-transparent |
135
- | 70% | `#ffffffb2` | Deep overlay |
136
- | 80% | `#ffffffcc` | Hover state |
137
- | 90% | `#ffffffe5` | Tooltip |
138
- | 95% | `#fffffff2` | Modal |
139
-
140
- ---
141
-
142
- ## Color Palette Rules (MANDATORY)
143
-
144
- ### Strict Palette Adherence
145
-
146
- **Use ONLY the provided color palette. Do NOT create or modify colors.**
147
-
148
- - All colors must come from the user-provided palette
149
- - Do NOT use colors outside the palette
150
- - Do NOT modify palette colors (brightness, saturation, mixing)
151
- - **Only exception**: Add transparency using the `transparency` property (0-100)
152
-
153
- ```javascript
154
- // Correct: Using palette colors
155
- slide.addShape(pres.shapes.RECTANGLE, { fill: { color: theme.primary } });
156
- slide.addText("Title", { color: theme.accent });
157
-
158
- // Wrong: Colors outside palette
159
- slide.addShape(pres.shapes.RECTANGLE, { fill: { color: "1a1a2e" } });
160
- ```
161
-
162
- ### No Gradients
163
-
164
- **Gradients are prohibited. Use solid colors only.**
165
-
166
- ### No Animations
167
-
168
- **Animations and transitions are prohibited.** All slides must be static.
169
-
170
- ---
171
-
172
- ## Font Reference
173
-
174
- ### Recommended Fonts
175
-
176
- | Language | Default Font | Alternatives |
177
- |----------|-------------|--------------|
178
- | **Chinese** | Microsoft YaHei | — |
179
- | **English** | Arial | Georgia, Calibri, Cambria, Trebuchet MS |
180
-
181
- - For mixed Chinese-English content: use Microsoft YaHei for Chinese, the chosen font for English
182
- - Prefer system fonts for cross-platform compatibility
183
- - Titles and body text can use different font pairings (e.g. Georgia + Calibri)
184
-
185
- ### Recommended Font Pairings
186
-
187
- | Header Font | Body Font |
188
- |-------------|-----------|
189
- | Georgia | Calibri |
190
- | Arial Black | Arial |
191
- | Calibri | Calibri Light |
192
- | Cambria | Calibri |
193
- | Trebuchet MS | Calibri |
194
- | Impact | Arial |
195
- | Palatino | Garamond |
196
- | Consolas | Calibri |
197
-
198
- **Choose an interesting font pairing** — don't default to Arial for everything. Pick a header font with personality and pair it with a clean body font.
199
-
200
- ### No Bold for Body Text
201
-
202
- **Plain body text and caption/legend text must NOT use bold.**
203
-
204
- - Body paragraphs, descriptions → normal weight
205
- - Captions, legends, footnotes → normal weight
206
- - Reserve bold for titles and headings only
207
-
208
- ```javascript
209
- // Correct
210
- slide.addText("Main Title", { bold: true, fontSize: 36, fontFace: "Arial" });
211
- slide.addText("Body text here.", { bold: false, fontSize: 14, fontFace: "Arial" });
212
-
213
- // Wrong
214
- slide.addText("Body text here.", { bold: true, fontSize: 14 });
215
- ```
216
-
217
- ---
218
-
219
- ## Style Recipes
220
-
221
- The same design can be rendered in 4 distinct visual styles by adjusting corner radius (`rectRadius`) and spacing. Choose the style recipe that fits the presentation tone.
222
-
223
- > **Unit note**: PptxGenJS uses inches. Slide dimensions are 10" x 5.625" (LAYOUT_16x9).
224
-
225
- ### Style Overview
226
-
227
- | Style | Corner Radius | Spacing | Best For |
228
- |-------|--------------|---------|----------|
229
- | **Sharp & Compact** | 0 ~ 0.05" | Tight | Data-dense, tables, professional reports |
230
- | **Soft & Balanced** | 0.08" ~ 0.12" | Moderate | Corporate, business presentations, general use |
231
- | **Rounded & Spacious** | 0.15" ~ 0.25" | Relaxed | Product intros, marketing, creative showcases |
232
- | **Pill & Airy** | 0.3" ~ 0.5" | Open | Brand showcases, launch events, premium presentations |
233
-
234
- ### Sharp & Compact
235
-
236
- **Visual character**: Geometric, high information density, formal and serious.
237
-
238
- | Category | Value (inches) | Notes |
239
- |----------|---------------|-------|
240
- | Corner radius — small | 0" | Full right angle |
241
- | Corner radius — medium | 0.03" | Micro-rounded |
242
- | Corner radius — large | 0.05" | Slight rounding |
243
- | Element padding | 0.1" ~ 0.15" | Compact |
244
- | Element gap | 0.1" ~ 0.2" | Compact |
245
- | Page margin | 0.3" | Narrow |
246
- | Block gap | 0.25" ~ 0.35" | Compact |
247
-
248
- ### Soft & Balanced
249
-
250
- **Visual character**: Moderate rounding, comfortable whitespace, professional yet approachable.
251
-
252
- | Category | Value (inches) | Notes |
253
- |----------|---------------|-------|
254
- | Corner radius — small | 0.05" | Slight rounding |
255
- | Corner radius — medium | 0.08" | Medium rounding |
256
- | Corner radius — large | 0.12" | Larger rounding |
257
- | Element padding | 0.15" ~ 0.2" | Moderate |
258
- | Element gap | 0.15" ~ 0.25" | Moderate |
259
- | Page margin | 0.4" | Standard |
260
- | Block gap | 0.35" ~ 0.5" | Moderate |
261
-
262
- ### Rounded & Spacious
263
-
264
- **Visual character**: Large corners, generous whitespace, friendly and modern.
265
-
266
- | Category | Value (inches) | Notes |
267
- |----------|---------------|-------|
268
- | Corner radius — small | 0.1" | Medium rounding |
269
- | Corner radius — medium | 0.15" | Large rounding |
270
- | Corner radius — large | 0.25" | Very large rounding |
271
- | Element padding | 0.2" ~ 0.3" | Relaxed |
272
- | Element gap | 0.25" ~ 0.4" | Relaxed |
273
- | Page margin | 0.5" | Wide |
274
- | Block gap | 0.5" ~ 0.7" | Relaxed |
275
-
276
- ### Pill & Airy
277
-
278
- **Visual character**: Full pill-shaped corners, abundant whitespace, light and open feel, strong brand presence.
279
-
280
- | Category | Value (inches) | Notes |
281
- |----------|---------------|-------|
282
- | Corner radius — small | 0.2" | Large rounding |
283
- | Corner radius — medium | 0.3" | Pill shape |
284
- | Corner radius — large | 0.5" | Full pill |
285
- | Element padding | 0.25" ~ 0.4" | Open |
286
- | Element gap | 0.3" ~ 0.5" | Open |
287
- | Page margin | 0.6" | Wide |
288
- | Block gap | 0.6" ~ 0.9" | Open |
289
-
290
- ### Component Style Mapping
291
-
292
- | Component | Sharp | Soft | Rounded | Pill |
293
- |-----------|-------|------|---------|------|
294
- | **Button / Tag** | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
295
- | **Card / Container** | rectRadius: 0.03 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.3 |
296
- | **Image Container** | rectRadius: 0 | rectRadius: 0.08 | rectRadius: 0.15 | rectRadius: 0.25 |
297
- | **Input Field** | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
298
- | **Badge** | rectRadius: 0.02 | rectRadius: 0.05 | rectRadius: 0.08 | rectRadius: 0.15 |
299
- | **Avatar Frame** | rectRadius: 0 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.5 (circle) |
300
-
301
- #### PptxGenJS Corner Radius Examples
302
-
303
- ```javascript
304
- // Sharp style card
305
- slide.addShape("rect", {
306
- x: 0.5, y: 1, w: 4, h: 2.5,
307
- fill: { color: "F5F5F5" },
308
- rectRadius: 0.03
309
- });
310
-
311
- // Rounded style card
312
- slide.addShape("rect", {
313
- x: 0.5, y: 1, w: 4, h: 2.5,
314
- fill: { color: "F5F5F5" },
315
- rectRadius: 0.2
316
- });
317
-
318
- // Pill style button (height 0.4", rectRadius 0.2" = perfect pill)
319
- slide.addShape("rect", {
320
- x: 3, y: 4, w: 2, h: 0.4,
321
- fill: { color: "4A90D9" },
322
- rectRadius: 0.2
323
- });
324
- ```
325
-
326
- ### Mixing Rules
327
-
328
- #### 1. Outer container corner >= inner element corner
329
-
330
- ```javascript
331
- // Correct: outer > inner
332
- card: rectRadius: 0.2
333
- button: rectRadius: 0.1
334
-
335
- // Wrong: inner > outer → visual overflow effect
336
- card: rectRadius: 0.1
337
- button: rectRadius: 0.2
338
- ```
339
-
340
- #### 2. Information density drives spacing
341
-
342
- | Zone Type | Recommended Style |
343
- |-----------|------------------|
344
- | Data display zone | Sharp / Soft (compact spacing) |
345
- | Content browsing zone | Rounded / Pill (relaxed spacing) |
346
- | Title zone | Soft / Rounded (moderate spacing) |
347
-
348
- #### 3. Corner radius vs element height
349
-
350
- | Element Height | Sharp | Soft | Rounded | Pill |
351
- |---------------|-------|------|---------|------|
352
- | Small (< 0.3") | 0" | 0.03" | 0.08" | height/2 |
353
- | Medium (0.3" ~ 0.6") | 0.02" | 0.05" | 0.12" | height/2 |
354
- | Large (0.6" ~ 1.2") | 0.03" | 0.08" | 0.2" | 0.3" |
355
- | Extra large (> 1.2") | 0.05" | 0.12" | 0.25" | 0.4" |
356
-
357
- > **Pill tip**: For a perfect pill shape, set `rectRadius = element height / 2`
358
-
359
- ### Typography Scale (PPT)
360
-
361
- | Usage | Size (pt) | Notes |
362
- |-------|-----------|-------|
363
- | Annotations / Sources | 10 ~ 12 | Minimum readable size |
364
- | Body / Description | 14 ~ 16 | Standard body |
365
- | Subtitle | 18 ~ 22 | Secondary heading |
366
- | Title | 28 ~ 36 | Page title |
367
- | Large Title | 44 ~ 60 | Cover / section title |
368
- | Data Callout | 60 ~ 96 | Key number display |
369
-
370
- ### Spacing Scale (PPT)
371
-
372
- Based on 10" x 5.625" slide dimensions:
373
-
374
- | Usage | Recommended (inches) |
375
- |-------|---------------------|
376
- | Icon-to-text gap | 0.08" ~ 0.15" |
377
- | List item spacing | 0.15" ~ 0.25" |
378
- | Card inner padding | 0.2" ~ 0.4" |
379
- | Element group gap | 0.3" ~ 0.5" |
380
- | Page safe margin | 0.4" ~ 0.6" |
381
- | Major block gap | 0.5" ~ 0.8" |
382
-
383
- ### Quick Selection Guide
384
-
385
- | Presentation Type | Recommended Style | Reason |
386
- |------------------|------------------|--------|
387
- | Finance / Data reports | Sharp & Compact | High density, serious and precise |
388
- | Corporate / Business | Soft & Balanced | Balances professionalism and approachability |
389
- | Product intro / Marketing | Rounded & Spacious | Modern feel, friendly |
390
- | Launch events / Brand | Pill & Airy | Premium feel, visual impact |
391
- | Training / Education | Soft / Rounded | Clear, readable, friendly |
392
- | Tech sharing | Sharp / Soft | Professional, information-dense |