@cteno/sdk-linux-x64 0.0.0-stage → 2.10.14

package/skills/pptx/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Cteno
+Portions Copyright (c) 2026 Nous Research (scripts/ and tests/ adapted from the Hermes Agent productivity skills)
+Portions Copyright (c) 2026 MiniMaxAI (references adapted from MiniMax-AI/skills)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/pptx/NOTICE.md

@@ -0,0 +1,8 @@
+# Sources for the office skills (docx, pptx, xlsx, pdf)
+
+- **Scripts and tests**: adapted from Nous Research Hermes Agent `skills/productivity/{docx,powerpoint,xlsx,pdf}` (MIT), upstream commit `bf0203a` (2026-10-22).
+- **Chinese typesetting, design and formatting references**: adapted from MiniMax-AI/skills `minimax-docx`, `pptx-generator`, `minimax-xlsx`, `minimax-pdf` (MIT); `xlsx/scripts/formula_check.py` from minimax-xlsx.
+- **Cteno additions**: `scripts/render.py` (isolated LibreOffice profile, macOS CJK font exposure and substitution), `scripts/cjk_fonts.py` (East Asian font slots), CJK handling in `docx_create.py` / `pptx_create.py` / `pdf_create.py`, 16:9 layout stretch in `pptx_create.py`, all `SKILL.md` texts.
+- Anthropic's document skills (proprietary licence) informed which pitfalls to cover; no text or code was copied from them.
+
+Not tracked live: to update, diff the upstream folders above against these copies and re-run each skill's `tests/` plus a render check.

package/skills/pptx/SKILL.md

@@ -0,0 +1,62 @@
+---
+id: pptx
+name: pptx
+version: "2.0.0"
+description: "Create, read, edit and template PowerPoint .pptx decks (native charts, tables, notes), with slide-design rules, Chinese font handling and a mandatory render-every-slide check."
+when_to_use: "Use whenever a .pptx/.potx is input or output: slide decks, pitch/汇报/培训 PPT, presentations, reading or summarizing a deck, replacing text or chart data, filling a brand template, reordering/duplicating slides, speaker notes."
+license: MIT (see LICENSE; scripts adapted from Nous Research and MiniMax, MIT)
+tags: [pptx, powerpoint, slides, deck, presentation, 汇报]
+---
+
+# PowerPoint decks (.pptx)
+
+| Task | Route |
+|---|---|
+| New deck, standard layouts | JSON spec → `${SKILL_DIR}/scripts/pptx_create.py spec.json out.pptx` |
+| New deck, designed/custom layout | Write a `pptxgenjs` (Node) or `python-pptx` script; see `${SKILL_DIR}/references/pptxgenjs.md`, `${SKILL_DIR}/references/design-system.md`, `${SKILL_DIR}/references/slide-types.md` |
+| Brand template | `${SKILL_DIR}/scripts/pptx_from_template.py tpl.pptx out.pptx --values v.json [--add-slides spec.json]` (inherits the template's masters, fonts, colors) |
+| Edit existing | `${SKILL_DIR}/scripts/pptx_edit.py deck.pptx --replace-text OLD NEW / --chart-data spec.json / --duplicate-slide N / --remove-slide N / --move-slide A B / --set-notes N TEXT …` (`--output` keeps the original) |
+| Read | `${SKILL_DIR}/scripts/pptx_read.py deck.pptx --outline / --notes / --images DIR` |
+| Look at it | `${SKILL_DIR}/scripts/render.py deck.pptx` → one PNG per slide |
+| `.ppt` / `.key`-exported in | `soffice --headless --convert-to pptx FILE` first |
+
+Scripts take `--help`, print JSON, exit non-zero on failure. Always call scripts by the absolute paths shown here (not a copy found elsewhere on disk).
+Dependencies: `python3 -m pip install python-pptx lxml` (pptxgenjs route: `npm install pptxgenjs`). Rendering: LibreOffice + poppler.
+
+## Plan the deck before generating
+
+1. **Audience, purpose, length.** 汇报 to leadership: conclusion first, 8–15 slides. Training: one idea per slide. Pitch: problem → solution → evidence → ask.
+2. **One message per slide, written as the title** — a sentence that states the point ("Q4 营收同比增长 54%"), not a topic label ("营收情况").
+3. **Outline as a table first** (slide #, title-message, visual, data source), then build. Every number from the user or a cited source; unknowns marked `【待确认】`.
+4. Use the user's template/brand when given — it overrides every design rule below.
+
+## Design rules (for decks you design)
+
+- **Pick a palette for THIS topic** (see `${SKILL_DIR}/references/design-system.md`): one dominant color (60–70%), one or two supporting tones, one sharp accent. If the colors would fit any other deck, choose again. Don't default to blue or to beige backgrounds.
+- **Every slide has a visual** — chart, table, diagram, icon row, big number, or image. A title plus bullets only is the exception, not the default.
+- **Vary layouts**: two-column, big-stat callout (60–72 pt number + small label), comparison columns, timeline/process, 2×2 grid. Don't repeat the same layout on consecutive slides.
+- **Type scale**: title 36–44 pt, section header 20–24 pt, body 16–20 pt (never below 14), captions 10–12 pt. Left-align body text; center only titles.
+- **Spacing**: ≥ 0.5″ from slide edges, consistent 0.3″ or 0.5″ gaps, leave breathing room.
+- **Avoid AI tells**: accent lines under titles, decorative color bars/stripes along an edge, text-only slides, gradients everywhere, clip-art icons in mismatched styles, more than ~6 bullets.
+- **Charts stay native** (editable in PowerPoint): give them a title, data labels where values matter, colors from the palette, light gridlines, legend only for multiple series. Images only for chart types PowerPoint lacks.
+- Speaker notes go in notes, never in a text box on the slide.
+
+## Chinese decks
+
+- PowerPoint picks CJK glyphs from the East Asian font slot (`<a:ea>`). `pptx_create.py` sets it automatically (Microsoft YaHei) when the spec has CJK; for decks built any other way run `python3 ${SKILL_DIR}/scripts/cjk_fonts.py deck.pptx` (`--heading`/`--body` to choose fonts) before delivery.
+- Chinese needs ~15% more line height and fewer characters per line: ≤ 20 字 per bullet, ≤ 5 bullets.
+- Full-width punctuation in Chinese text; numbers and units half-width (`54%`, `3.2 亿元`).
+
+## Gotchas
+
+- **Slide size**: `pptx_create.py` makes 16:9 (13.333″ × 7.5″) and stretches the default layouts to fit; pptxgenjs `LAYOUT_16x9` is 10″ × 5.625″ — coordinates beyond the edge are silently off-slide.
+- **pptxgenjs**: hex colors without `#` and never 8 digits (both corrupt the file); one `new pptxgen()` per file; option objects are mutated in place — build a fresh one per call; shadow offset must be ≥ 0; use `bullet: true`, never a literal `•`; `rectRadius` only on `ROUNDED_RECTANGLE`; on stacked bar charts `dataLabelPosition: "outEnd"` corrupts the file; text boxes have internal padding (`margin: 0` to align with shapes).
+- **python-pptx**: `text_frame.text = …` collapses formatting — set `run.text`; it can't duplicate slides (use `pptx_edit.py --duplicate-slide`), and chart slides can't be duplicated at all.
+- **Template filling**: if the template has 4 slots and you have 3 items, delete the 4th group entirely (image + text), not just its text. Remove leftover placeholder text.
+- **Fonts in preview**: rendering uses LibreOffice with substitute fonts; widths can differ slightly from real Office. Leave ~10% slack in text boxes; Arial/Calibri/YaHei are the most faithful.
+
+## Verify before delivery (required)
+
+1. `python3 ${SKILL_DIR}/scripts/pptx_read.py out.pptx --outline` — slide count, titles, chart values and notes match the outline; no `{{`, `xxx`, `lorem`, `TODO`, `点击此处添加`.
+2. `python3 ${SKILL_DIR}/scripts/render.py out.pptx`, then **open every slide image** with fresh eyes (you will otherwise see what you meant, not what rendered). Check, in this order: text overflowing or cut off; overlapping elements; CJK in a fallback font or boxes; < 0.5″ margins or cramped/uneven gaps; low-contrast text or icons; misaligned columns; charts without labels; leftover template content.
+3. Fix in the generator, re-render the changed slides, repeat until clean. If rendering tools are missing, say the visual check was not done.

package/skills/pptx/references/design-system.md

@@ -0,0 +1,392 @@
+# Design System
+
+## Color Palette Reference
+
+| # | Name | Colors | Style | Use Cases | Tips |
+|---|------|--------|-------|-----------|------|
+| 1 | Modern & Wellness | `#006d77` `#83c5be` `#edf6f9` `#ffddd2` `#e29578` | Fresh, soothing | Healthcare, counseling, skincare, yoga/spa | Deep teal for titles, light pink for background |
+| 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 |
+| 3 | Nature & Outdoors | `#606c38` `#283618` `#fefae0` `#dda15e` `#bc6c25` | Grounded, earthy | Outdoor gear, environmental, agriculture, historical culture | Dark green base, cream text |
+| 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 |
+| 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 |
+| 6 | Bohemian | `#ccd5ae` `#e9edc9` `#fefae0` `#faedcd` `#d4a373` | Gentle, muted | Wedding planning, home decor, organic food, slow living | Cream background, green-brown accents |
+| 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 |
+| 8 | Craft & Artisan | `#7f5539` `#a68a64` `#ede0d4` `#656d4a` `#414833` | Rustic, coffee-toned | Coffee shops, handicrafts, traditional culture, bakery | Suited for paper/leather textures |
+| 9 | Tech & Night | `#000814` `#001d3d` `#003566` `#ffc300` `#ffd60a` | Deep, luminous | Tech launches, astronomy, night economy, luxury automobiles | Must use dark mode |
+| 10 | Education & Charts | `#264653` `#2a9d8f` `#e9c46a` `#f4a261` `#e76f51` | Clear, logical | Statistical reports, education, market analysis, general business | Perfect chart color scheme |
+| 11 | Forest & Eco | `#dad7cd` `#a3b18a` `#588157` `#3a5a40` `#344e41` | Monochrome gradient, forest | Landscape design, ESG reports, environmental causes, botanical | Monochrome palette is safe and cohesive |
+| 12 | Elegant & Fashion | `#edafb8` `#f7e1d7` `#dedbd2` `#b0c4b1` `#4a5759` | Muted, Morandi tones | Haute couture, art galleries, beauty brands, magazine style | Negative space is key |
+| 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 |
+| 14 | Luxury & Mysterious | `#22223b` `#4a4e69` `#9a8c98` `#c9ada7` `#f2e9e4` | Cool, purple-toned | Jewelry showcases, hotel management, high-end consulting, psychology | Purple evokes premium atmosphere |
+| 15 | Pure Tech Blue | `#03045e` `#0077b6` `#00b4d8` `#90e0ef` `#caf0f8` | Futuristic, clean | Cloud/AI, water/ocean, hospitals, clean energy | Deep ocean to sky gradient |
+| 16 | Coastal Coral | `#0081a7` `#00afb9` `#fdfcdc` `#fed9b7` `#f07167` | Refreshing, summery | Travel, summer events, beverage brands, ocean themes | Teal and coral as complementary focal colors |
+| 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 |
+| 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 |
+
+---
+
+### Agent Design System — Full Color Scale
+
+Based on the Platinum White-Gold Theme design tokens. Provides complete color scales for fine-grained design work.
+
+#### White Scale (Backgrounds & Light Surfaces)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| white-0 | `#ffffff` | Primary background |
+| white-50 | `#fefefe` | Slightly warm white |
+| white-75 | `#fcfcfc` | Near-white |
+| white-100 | `#fafafa` | Secondary background |
+| white-200 | `#f7f7f7` | Card background |
+| white-300 | `#f5f5f5` | Tertiary background |
+| white-400 | `#f0f0f0` | Separator zones |
+| white-500 | `#ebebeb` | Light border |
+| white-600 | `#e5e5e5` | Disabled background |
+| white-700 | `#e0e0e0` | Deep white-gray |
+| white-800 | `#d9d9d9` | Placeholder |
+| white-900 | `#d4d4d4` | Divider lines |
+| white-1000 | `#cccccc` | Deepest white |
+
+#### Gold Scale (Platinum Business Accent)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| gold-25 | `#FFFDF5` | Extremely light gold background |
+| gold-50 | `#FEF9E7` | Light gold background |
+| gold-75 | `#FCF3D0` | Pale gold highlight |
+| gold-100 | `#FAECB8` | Gold hover state |
+| gold-200 | `#F5DC8A` | Bright gold accent |
+| gold-300 | `#E8C860` | Gold hover |
+| gold-400 | `#D4AF37` | **Primary gold (core)** |
+| gold-500 | `#B8972E` | Gold text |
+| gold-600 | `#9A7E26` | Deep gold accent |
+| gold-700 | `#7C651E` | Dark gold border |
+| gold-800 | `#5E4C16` | Deep gold background |
+| gold-900 | `#40330F` | Very deep gold |
+| gold-1000 | `#221A08` | Black gold |
+
+#### Blue Scale (Primary Action Color)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| blue-25 | `#F0F7FF` | Extremely light blue background |
+| blue-50 | `#E0EFFF` | Info alert background |
+| blue-75 | `#C2DFFF` | Light blue highlight |
+| blue-100 | `#A3CFFF` | Disabled blue |
+| blue-200 | `#66AFFF` | Bright blue |
+| blue-300 | `#338FFF` | Blue hover |
+| blue-400 | `#0070F3` | **Primary blue (core)** |
+| blue-500 | `#005FCC` | Blue text |
+| blue-600 | `#004FA6` | Deep blue accent |
+| blue-700 | `#003F80` | Dark blue border |
+| blue-800 | `#002F5A` | Deep blue background |
+| blue-900 | `#001F3D` | Very deep blue |
+| blue-1000 | `#001026` | Black blue |
+
+#### Gray Scale (Text & Neutral Colors)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| gray-0 | `#ffffff` | White |
+| gray-50 | `#fafafa` | Extremely light gray |
+| gray-75 | `#f5f5f5` | Light gray background |
+| gray-100 | `#ededed` | Light divider |
+| gray-200 | `#d4d4d4` | Light border |
+| gray-300 | `#a3a3a3` | Quaternary text |
+| gray-400 | `#737373` | Tertiary text |
+| gray-500 | `#525252` | Secondary text |
+| gray-600 | `#404040` | Dark gray |
+| gray-700 | `#2e2e2e` | Dark background |
+| gray-800 | `#1f1f1f` | Deep background |
+| gray-900 | `#141414` | Very deep background |
+| gray-1000 | `#0a0a0a` | **Primary text (core)** |
+
+#### Opacity Values
+
+##### Opacity Black
+
+| Opacity | Value | Usage |
+|---------|-------|-------|
+| 0% | `#0a0a0a00` | Fully transparent |
+| 2% | `#0a0a0a05` | Subtle overlay |
+| 4% | `#0a0a0a0a` | Secondary interactive background |
+| 8% | `#0a0a0a14` | Border / divider |
+| 15% | `#0a0a0a26` | Pressed state |
+| 20% | `#0a0a0a33` | Light overlay |
+| 25% | `#0a0a0a40` | Medium overlay |
+| 50% | `#0a0a0a80` | Semi-transparent |
+| 70% | `#0a0a0ab2` | Deep overlay |
+| 80% | `#0a0a0acc` | Hover state |
+| 90% | `#0a0a0ae5` | Tooltip |
+| 95% | `#0a0a0af2` | Modal |
+
+##### Opacity White
+
+| Opacity | Value | Usage |
+|---------|-------|-------|
+| 0% | `#ffffff00` | Fully transparent |
+| 2% | `#ffffff05` | Subtle overlay |
+| 4% | `#ffffff0a` | Secondary interactive background |
+| 8% | `#ffffff12` | Border / divider |
+| 15% | `#ffffff26` | Pressed state |
+| 20% | `#ffffff33` | Light overlay |
+| 25% | `#ffffff40` | Medium overlay |
+| 50% | `#ffffff80` | Semi-transparent |
+| 70% | `#ffffffb2` | Deep overlay |
+| 80% | `#ffffffcc` | Hover state |
+| 90% | `#ffffffe5` | Tooltip |
+| 95% | `#fffffff2` | Modal |
+
+---
+
+## Color Palette Rules (MANDATORY)
+
+### Strict Palette Adherence
+
+**Use ONLY the provided color palette. Do NOT create or modify colors.**
+
+- All colors must come from the user-provided palette
+- Do NOT use colors outside the palette
+- Do NOT modify palette colors (brightness, saturation, mixing)
+- **Only exception**: Add transparency using the `transparency` property (0-100)
+
+```javascript
+// Correct: Using palette colors
+slide.addShape(pres.shapes.RECTANGLE, { fill: { color: theme.primary } });
+slide.addText("Title", { color: theme.accent });
+
+// Wrong: Colors outside palette
+slide.addShape(pres.shapes.RECTANGLE, { fill: { color: "1a1a2e" } });
+```
+
+### No Gradients
+
+**Gradients are prohibited. Use solid colors only.**
+
+### No Animations
+
+**Animations and transitions are prohibited.** All slides must be static.
+
+---
+
+## Font Reference
+
+### Recommended Fonts
+
+| Language | Default Font | Alternatives |
+|----------|-------------|--------------|
+| **Chinese** | Microsoft YaHei | — |
+| **English** | Arial | Georgia, Calibri, Cambria, Trebuchet MS |
+
+- For mixed Chinese-English content: use Microsoft YaHei for Chinese, the chosen font for English
+- Prefer system fonts for cross-platform compatibility
+- Titles and body text can use different font pairings (e.g. Georgia + Calibri)
+
+### Recommended Font Pairings
+
+| Header Font | Body Font |
+|-------------|-----------|
+| Georgia | Calibri |
+| Arial Black | Arial |
+| Calibri | Calibri Light |
+| Cambria | Calibri |
+| Trebuchet MS | Calibri |
+| Impact | Arial |
+| Palatino | Garamond |
+| Consolas | Calibri |
+
+**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.
+
+### No Bold for Body Text
+
+**Plain body text and caption/legend text must NOT use bold.**
+
+- Body paragraphs, descriptions → normal weight
+- Captions, legends, footnotes → normal weight
+- Reserve bold for titles and headings only
+
+```javascript
+// Correct
+slide.addText("Main Title", { bold: true, fontSize: 36, fontFace: "Arial" });
+slide.addText("Body text here.", { bold: false, fontSize: 14, fontFace: "Arial" });
+
+// Wrong
+slide.addText("Body text here.", { bold: true, fontSize: 14 });
+```
+
+---
+
+## Style Recipes
+
+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.
+
+> **Unit note**: PptxGenJS uses inches. Slide dimensions are 10" x 5.625" (LAYOUT_16x9).
+
+### Style Overview
+
+| Style | Corner Radius | Spacing | Best For |
+|-------|--------------|---------|----------|
+| **Sharp & Compact** | 0 ~ 0.05" | Tight | Data-dense, tables, professional reports |
+| **Soft & Balanced** | 0.08" ~ 0.12" | Moderate | Corporate, business presentations, general use |
+| **Rounded & Spacious** | 0.15" ~ 0.25" | Relaxed | Product intros, marketing, creative showcases |
+| **Pill & Airy** | 0.3" ~ 0.5" | Open | Brand showcases, launch events, premium presentations |
+
+### Sharp & Compact
+
+**Visual character**: Geometric, high information density, formal and serious.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0" | Full right angle |
+| Corner radius — medium | 0.03" | Micro-rounded |
+| Corner radius — large | 0.05" | Slight rounding |
+| Element padding | 0.1" ~ 0.15" | Compact |
+| Element gap | 0.1" ~ 0.2" | Compact |
+| Page margin | 0.3" | Narrow |
+| Block gap | 0.25" ~ 0.35" | Compact |
+
+### Soft & Balanced
+
+**Visual character**: Moderate rounding, comfortable whitespace, professional yet approachable.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0.05" | Slight rounding |
+| Corner radius — medium | 0.08" | Medium rounding |
+| Corner radius — large | 0.12" | Larger rounding |
+| Element padding | 0.15" ~ 0.2" | Moderate |
+| Element gap | 0.15" ~ 0.25" | Moderate |
+| Page margin | 0.4" | Standard |
+| Block gap | 0.35" ~ 0.5" | Moderate |
+
+### Rounded & Spacious
+
+**Visual character**: Large corners, generous whitespace, friendly and modern.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0.1" | Medium rounding |
+| Corner radius — medium | 0.15" | Large rounding |
+| Corner radius — large | 0.25" | Very large rounding |
+| Element padding | 0.2" ~ 0.3" | Relaxed |
+| Element gap | 0.25" ~ 0.4" | Relaxed |
+| Page margin | 0.5" | Wide |
+| Block gap | 0.5" ~ 0.7" | Relaxed |
+
+### Pill & Airy
+
+**Visual character**: Full pill-shaped corners, abundant whitespace, light and open feel, strong brand presence.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0.2" | Large rounding |
+| Corner radius — medium | 0.3" | Pill shape |
+| Corner radius — large | 0.5" | Full pill |
+| Element padding | 0.25" ~ 0.4" | Open |
+| Element gap | 0.3" ~ 0.5" | Open |
+| Page margin | 0.6" | Wide |
+| Block gap | 0.6" ~ 0.9" | Open |
+
+### Component Style Mapping
+
+| Component | Sharp | Soft | Rounded | Pill |
+|-----------|-------|------|---------|------|
+| **Button / Tag** | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
+| **Card / Container** | rectRadius: 0.03 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.3 |
+| **Image Container** | rectRadius: 0 | rectRadius: 0.08 | rectRadius: 0.15 | rectRadius: 0.25 |
+| **Input Field** | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
+| **Badge** | rectRadius: 0.02 | rectRadius: 0.05 | rectRadius: 0.08 | rectRadius: 0.15 |
+| **Avatar Frame** | rectRadius: 0 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.5 (circle) |
+
+#### PptxGenJS Corner Radius Examples
+
+```javascript
+// Sharp style card
+slide.addShape("rect", {
+  x: 0.5, y: 1, w: 4, h: 2.5,
+  fill: { color: "F5F5F5" },
+  rectRadius: 0.03
+});
+
+// Rounded style card
+slide.addShape("rect", {
+  x: 0.5, y: 1, w: 4, h: 2.5,
+  fill: { color: "F5F5F5" },
+  rectRadius: 0.2
+});
+
+// Pill style button (height 0.4", rectRadius 0.2" = perfect pill)
+slide.addShape("rect", {
+  x: 3, y: 4, w: 2, h: 0.4,
+  fill: { color: "4A90D9" },
+  rectRadius: 0.2
+});
+```
+
+### Mixing Rules
+
+#### 1. Outer container corner >= inner element corner
+
+```javascript
+// Correct: outer > inner
+card:   rectRadius: 0.2
+button: rectRadius: 0.1
+
+// Wrong: inner > outer → visual overflow effect
+card:   rectRadius: 0.1
+button: rectRadius: 0.2
+```
+
+#### 2. Information density drives spacing
+
+| Zone Type | Recommended Style |
+|-----------|------------------|
+| Data display zone | Sharp / Soft (compact spacing) |
+| Content browsing zone | Rounded / Pill (relaxed spacing) |
+| Title zone | Soft / Rounded (moderate spacing) |
+
+#### 3. Corner radius vs element height
+
+| Element Height | Sharp | Soft | Rounded | Pill |
+|---------------|-------|------|---------|------|
+| Small (< 0.3") | 0" | 0.03" | 0.08" | height/2 |
+| Medium (0.3" ~ 0.6") | 0.02" | 0.05" | 0.12" | height/2 |
+| Large (0.6" ~ 1.2") | 0.03" | 0.08" | 0.2" | 0.3" |
+| Extra large (> 1.2") | 0.05" | 0.12" | 0.25" | 0.4" |
+
+> **Pill tip**: For a perfect pill shape, set `rectRadius = element height / 2`
+
+### Typography Scale (PPT)
+
+| Usage | Size (pt) | Notes |
+|-------|-----------|-------|
+| Annotations / Sources | 10 ~ 12 | Minimum readable size |
+| Body / Description | 14 ~ 16 | Standard body |
+| Subtitle | 18 ~ 22 | Secondary heading |
+| Title | 28 ~ 36 | Page title |
+| Large Title | 44 ~ 60 | Cover / section title |
+| Data Callout | 60 ~ 96 | Key number display |
+
+### Spacing Scale (PPT)
+
+Based on 10" x 5.625" slide dimensions:
+
+| Usage | Recommended (inches) |
+|-------|---------------------|
+| Icon-to-text gap | 0.08" ~ 0.15" |
+| List item spacing | 0.15" ~ 0.25" |
+| Card inner padding | 0.2" ~ 0.4" |
+| Element group gap | 0.3" ~ 0.5" |
+| Page safe margin | 0.4" ~ 0.6" |
+| Major block gap | 0.5" ~ 0.8" |
+
+### Quick Selection Guide
+
+| Presentation Type | Recommended Style | Reason |
+|------------------|------------------|--------|
+| Finance / Data reports | Sharp & Compact | High density, serious and precise |
+| Corporate / Business | Soft & Balanced | Balances professionalism and approachability |
+| Product intro / Marketing | Rounded & Spacious | Modern feel, friendly |
+| Launch events / Brand | Pill & Airy | Premium feel, visual impact |
+| Training / Education | Soft / Rounded | Clear, readable, friendly |
+| Tech sharing | Sharp / Soft | Professional, information-dense |