# pom XML Reference A compact reference for the pom XML format, designed to be pasted into LLM prompts. ## Basics - Slide size: `{ w: 1280, h: 720 }` (px) - Colors: 6-digit hex (no `#` prefix) e.g. `FF0000` - Attribute values are written as strings. Numbers and booleans are auto-converted - Nested object attributes use dot notation (e.g. `fill.color="1D4ED8"`) - For shorthand + dot-notation attributes (e.g. `padding` + `padding.top`), both can be mixed on the same node. Shorthand sets defaults; dot-notation keys override per side/property. ## Top-Level Structure The top level of every pom XML document is one or more `` elements, optionally preceded by a single `` element (see "Theme (Design Tokens)"). Each `` wraps the content of a single slide. ```xml Slide 1 Slide 2 ``` - Top-level elements other than `` and `` are an error. - A `` must contain at least one child element. - `` does not currently take attributes; per-slide properties (background, notes, etc.) are tracked separately. ## Theme (Design Tokens) Declare a color palette once at the top level and reference each token from any color attribute as `$tokenName`. This keeps the palette in one place instead of repeating hex values on every node. ```xml Title ``` - Each `` attribute declares a token: the attribute name is the token name (letters, digits, `_`, `-`; must start with a letter), the value is a 6-digit hex color (`#` prefix optional). - At most one `` per document; it applies to all slides regardless of position. Child elements are not allowed. - `$tokenName` references are resolved in color attributes (attributes ending in `Color`/`Colors`, `color` keys in object/JSON attributes, `highlight`) and inside `backgroundGradient` / `textGradient` strings. Other attributes and text content are never substituted. - Referencing an unknown token (or using `$token` without a ``) is a validation error with a "did you mean" suggestion. ## Common Attributes (All Nodes) | Attribute | Type | Description | | ----------------- | ---------------------------------------------------------- | ------------------------------------------ | | `id` | string | Unique identifier within the slide (used by `Arrow` connectors) | | `w` | number / `"max"` / `"50%"` | Width | | `h` | number / `"max"` / `"50%"` | Height | | `grow` | positive number | Flex grow ratio among siblings (CSS `flex-grow`). `grow="2"` and `grow="1"` produce a 2:1 split. Along the parent's main axis `w="max"` / `h="max"` behave as `grow="1"`; when both are specified, `grow` takes precedence | | `minW` `maxW` | number | Min / max width | | `minH` `maxH` | number | Min / max height | | `padding` | number / `padding.top="8" padding.bottom="8"` | Padding (shorthand + dot notation can be mixed) | | `backgroundColor` | hex | Background color | | `backgroundGradient` | `linear-gradient(135deg, #667EEA 0%, #764BA2 100%)` or `radial-gradient(circle at center, #1D4ED8 0%, #38BDF8 100%)` | Gradient background. **linear**: angle (`deg` or `to right` etc., default `180deg`) + 2 or more stops. **radial**: optional `` (`circle` / `ellipse`, default `ellipse`) + optional `` (`closest-side` / `closest-corner` / `farthest-side` / `farthest-corner`, default `farthest-corner`) + optional `at ` (`at center` / `at top right` / `at 25% 75%`, default `center`) + 2 or more stops. PowerPoint's radial fill does not visually distinguish `circle` / `ellipse` or the size keyword (only the center position affects output). Takes precedence over `backgroundColor`. On the slide root node it becomes the slide background | | `backgroundImage` | `backgroundImage.src="url" backgroundImage.sizing="cover"` | Background image | | `border` | `border.color="333" border.width="1"` | Border (shorthand + dot notation can be mixed) | | `borderTop` `borderRight` `borderBottom` `borderLeft` | `borderLeft.color="1D4ED8" borderLeft.width="6"` | Per-side border with the same fields as `border`. Overrides `border` for that side (field-by-field). Useful for accent bars / underlined headings. Combinable with `borderRadius`: `borderTop` paints both upper corners in its color, `borderBottom` paints both lower corners. `borderLeft` / `borderRight` only draw the straight segment between the corners — they do not wrap into the arcs, so `borderLeft` + `borderRadius` reads as a clean left accent bar with neutral rounded corners | | `borderRadius` | number | Border radius (px) | | `opacity` | 0-1 | Background opacity | | `margin` | number / `margin.top="8" margin.bottom="8"` | Margin (shorthand + dot notation can be mixed) | | `zIndex` | number | Stacking order (higher = on top) | | `position` | `relative` / `absolute` | Positioning mode | | `top` | number | Top offset (when using position) | | `right` | number | Right offset (when using position) | | `bottom` | number | Bottom offset (when using position) | | `left` | number | Left offset (when using position) | | `alignSelf` | `auto` / `start` / `center` / `end` / `stretch` | Override parent's alignItems for this node | | `shadow` | `shadow.type="outer" shadow.blur="4" shadow.offset="2" shadow.color="000"` | Drop shadow (shorthand + dot notation can be mixed; not supported on Line) | ## Leaf Rotation `Text`, `Shape`, `Image`, and `Icon` support `rotate=""` in degrees clockwise. Rotation is applied only during PowerPoint rendering; yoga layout still uses the unrotated bounding box, so sibling placement and parent size are unchanged. ## Layout Nodes ### VStack / HStack Arranges children vertically (VStack) / horizontally (HStack). ```xml A B ``` | Attribute | Values | | ---------------- | --------------------------------------------------------------------------- | | `gap` | number (spacing between children) | | `alignItems` | `start` / `center` / `end` / `stretch` | | `justifyContent` | `start` / `center` / `end` / `spaceBetween` / `spaceAround` / `spaceEvenly` | | `flexWrap` | `nowrap` / `wrap` / `wrapReverse` | > **Note:** Children of VStack / HStack default to `flexShrink=1` (same behavior as CSS Flexbox). Even when combining `%` widths with `gap`, children automatically shrink to fit within the parent. > **Tip — empty container as transparent spacer:** An empty `` / `` renders nothing. Combined with `grow="1"`, it works like CSS `
` to push siblings apart without a visible rectangle. > > ```xml > > Top > > Bottom > > ``` ### Layer Positions children using absolute coordinates. Children require `x` and `y`. Source order determines stacking. ```xml ``` ## Content Nodes ### Text ```xml Title ``` | Attribute | Type / Values | | ------------------------------------------ | ---------------------------------------------------------- | | `fontSize` | number (default: 24) | | `color` | hex (text color) | | `textGradient` | `linear-gradient(90deg, #38BDF8 0%, #A78BFA 100%)` (native PPTX gradient text fill; overrides `color`; applies to all runs) | | `textAlign` | `left` / `center` / `right` | | `bold` `italic` `strike` | `true` / `false` | | `subscript` `superscript` | `true` / `false` | | `underline` | `true` / `underline.style="wavy" underline.color="FF0000"` | | `highlight` | hex (highlight color) | | `fontFamily` | string (default: `Noto Sans JP`) | | `lineHeight` | number (default: 1.3) | | `letterSpacing` | number in px (letter spacing, converted to pt on output) | | `glow` | `glow.size="8" glow.opacity="0.5" glow.color="FF3399"` | | `outline` | `outline.size="2" outline.color="0088CC"` | | `rotate` | number (degrees clockwise, render-only) | Font size guide: Title 28-40 / Heading 18-24 / Body 13-16 / Caption 10-12 `textGradient` accepts the same syntax as `backgroundGradient` (angle in `deg` or `to `, 2+ hex stops with optional `%` positions). Useful for cover-page titles, KPI numerals, and pull quotes. Exported as a native PowerPoint gradient text fill (editable, not rasterized). ```xml Gradient title ``` **Text effects (glow / outline):** `glow` adds a glow around the characters (`size` in px, `opacity` 0-1, `color` hex; defaults: 8 / 0.75 / FFFFFF). `outline` draws a border along the character edges (`size` in px, `color` hex; defaults: 1 / FFFFFF). Both export as native PowerPoint text effects (editable, not rasterized) and are useful for keeping titles legible on top of background images. They apply per text node; with inline formatting the node-level effect applies to all runs. Beyond titles, the same effects work well as **decorative accents**: - **Oversized quotation marks** — make a large `"` or `「` glow in the accent color and place it behind a quote block (use `Layer` + absolute coordinates). - **Headline numerals** — give big KPI digits a subtle accent glow so they pop above the rest of the slide without changing color. - **Outlined display titles on photos** — pair `outline` with a low-opacity `glow` of the same dark color to keep light-on-photo titles legible. ```xml Glowing title Outlined title " 真の差別化は機能ではなく、誰がどう使うかだ。 84.2 ``` **Inline formatting:** Use ``, ``, ``, ``, ``, ``, ``, ``, and `` child elements for partial bold/italic/underline/strikethrough/subscript/superscript/highlight/color and hyperlinks: ```xml Normal bold and italic text Visit our site Normal underline and strikethrough text H2O and x2 + y2 highlighted text Normal red text normal Default Arial part default Normal spaced out normal ¥84.2M ``` `` supports `color`, `fontFamily` (overrides the parent's `fontFamily` for that run), `fontSize` (overrides the font size for that run, e.g. KPI "big number + small unit" composition), and `letterSpacing` (adjusts letter spacing for that run; effective inside `` only). ``, ``, ``, ``, ``, ``, ``, ``, and `` also work inside `
  • ` and ``. **Number + small unit (KPI numerals):** Use `` inside a single `` so the digit and unit share one baseline automatically. The parent's `bold` / `color` are inherited unless overridden on the Span. ```xml ¥84.2M 118% $2,480 ``` - Layout measurement uses the largest run `fontSize`, so the Text container is sized for the biggest glyph (no clipping). - For leading symbols (`¥`, `$`), put the `` at the start. - The previous HStack-based workaround (`alignItems="end"` + per-leaf `margin.bottom`) is no longer needed for this case. ### Ul (Bullet List) ```xml
    • Item A
    • Item B
    • Item C (individual style)
    ``` | Attribute | Type / Values | | -------------------------- | -------------------------------- | | `fontSize` | number (default: 24) | | `color` | hex (text color) | | `textAlign` | `left` / `center` / `right` | | `bold` `italic` `strike` | `true` / `false` | | `subscript` `superscript` | `true` / `false` | | `fontFamily` | string (default: `Noto Sans JP`) | | `lineHeight` | number (default: 1.3) | Li attributes (override parent styles): `bold`, `italic`, `strike`, `subscript`, `superscript`, `underline`, `highlight`, `color`, `fontSize`, `fontFamily` ### Ol (Numbered List) All Ul attributes plus: ```xml
    1. Item A
    2. Item B
    ``` | Attribute | Type / Values | | --------------- | ------------------------------------------------------- | | `numberType` | `alphaLcPeriod` / `alphaUcPeriod` / `arabicParenR` etc. | | `numberStartAt` | number (start number, default: 1) | ### Image ```xml ``` | Attribute | Type / Values | | --------- | ------------------------------------------------------------------------------------------------------------------------ | | `src` | string (URL / path / base64) | | `sizing` | `'{"type":"contain"}' ` / `'{"type":"cover"}'` / `'{"type":"crop","x":0,"y":0,"w":100,"h":100}'` | | `rotate` | number (degrees clockwise, render-only) | ### Icon Displays an icon from the Lucide icon library (1,900+ icons available). ```xml ``` | Attribute | Type / Values | | --------- | ------------------------------------------------------------------------ | | `name` | Lucide icon name (required). See examples below | | `size` | number (default: 24, in px) | | `color` | hex color (`#` prefix optional, default: `#000000`) | | `rotate` | number (degrees clockwise, render-only) | | `variant` | `circle-filled`, `circle-outlined`, `square-filled`, `square-outlined` | | `bgColor` | hex color for background shape (`#` prefix optional, default: `#E0E0E0`) | | `glow` | `glow.size="8" glow.opacity="0.5" glow.color="FF3399"` — applied to the variant background shape (no-op without `variant`) | | `outline` | `outline.size="2" outline.color="0088CC"` — applied to the variant background shape; overrides the variant default line | **Icon effects (glow / outline):** Both apply only to the background shape produced by `variant`; they cannot adorn the PNG icon glyph itself (it is rasterized). Use the same defaults as Text glow / outline. Typical use is glowing badge dots and outlined chips paired with an icon glyph (`Icon name="star" size="16" variant="circle-filled" bgColor="3B82F6" glow.size="10" glow.color="3B82F6"`). ### Svg Renders an inline SVG as a rasterized PNG image. Use this node for custom SVG graphics. ```xml ``` | Attribute | Type / Values | | --------- | ------------------------------------------------------ | | `w` | number (default: 24, width in px) | | `h` | number (default: 24, height in px) | | `color` | hex color (`#` prefix optional) | A `` child element is required. When `color` is specified, it sets `stroke` and `fill="none"` on the root `` element; explicit `stroke`/`fill` on child elements take precedence. All Lucide v0.577.0 icons are available. Icon names use kebab-case. Common examples by category: - **Technology**: `cpu`, `database`, `cloud`, `server`, `code`, `terminal`, `wifi`, `globe`, `monitor`, `smartphone`, `laptop`, `hard-drive`, `circuit-board`, `microchip`, `binary`, `braces`, `git-branch`, `github`, `container` - **Business**: `briefcase`, `building`, `building-2`, `factory`, `landmark`, `wallet`, `credit-card`, `receipt`, `banknote`, `coins`, `piggy-bank`, `hand-coins`, `calculator`, `stamp` - **Charts & Data**: `bar-chart`, `bar-chart-2`, `bar-chart-3`, `line-chart`, `pie-chart`, `trending-up`, `trending-down`, `activity`, `gauge`, `presentation` - **Communication**: `mail`, `message-square`, `message-circle`, `phone`, `video`, `at-sign`, `send`, `inbox`, `megaphone`, `bell`, `rss` - **People**: `user`, `users`, `contact`, `user-plus`, `user-check`, `user-x`, `person-standing`, `baby`, `accessibility` - **Arrows & Navigation**: `arrow-right`, `arrow-left`, `arrow-up`, `arrow-down`, `chevron-right`, `chevron-left`, `chevron-up`, `chevron-down`, `move`, `corner-down-right`, `external-link`, `redo`, `undo` - **Actions**: `search`, `settings`, `filter`, `download`, `upload`, `share`, `copy`, `scissors`, `trash`, `edit`, `plus`, `minus`, `refresh-cw`, `rotate-cw`, `save`, `log-in`, `log-out`, `power` - **Status & Alerts**: `check`, `check-circle`, `x`, `x-circle`, `alert-triangle`, `alert-circle`, `info`, `help-circle`, `ban`, `thumbs-up`, `thumbs-down` - **Security**: `shield`, `shield-check`, `lock`, `unlock`, `key`, `fingerprint`, `scan`, `eye`, `eye-off` - **Files & Folders**: `file`, `file-text`, `file-code`, `file-spreadsheet`, `folder`, `folder-open`, `archive`, `paperclip`, `clipboard` - **Media**: `image`, `camera`, `film`, `music`, `volume-2`, `mic`, `play`, `pause`, `skip-forward`, `skip-back` - **Time**: `calendar`, `clock`, `timer`, `hourglass`, `alarm-clock`, `calendar-check`, `calendar-plus` - **Shapes & Symbols**: `star`, `heart`, `zap`, `target`, `lightbulb`, `flag`, `bookmark`, `award`, `crown`, `gem`, `flame`, `snowflake`, `sun`, `moon`, `cloud-rain` - **Layout & UI**: `layout`, `grid`, `list`, `table`, `columns`, `rows`, `sidebar`, `panel-left`, `panel-right`, `maximize`, `minimize`, `menu` - **Maps & Travel**: `map`, `map-pin`, `compass`, `navigation`, `plane`, `car`, `truck`, `train`, `ship`, `bike`, `bus` - **Health & Science**: `heart-pulse`, `thermometer`, `pill`, `syringe`, `microscope`, `dna`, `atom`, `flask-conical`, `beaker` - **Food & Nature**: `apple`, `cherry`, `grape`, `leaf`, `trees`, `flower`, `sprout`, `mountain`, `waves` For the full icon list, see https://lucide.dev/icons/ (use the icon name in kebab-case as the `name` attribute). ### Shape ```xml ``` | Attribute | Type / Values | | --------------- | --------------------------------------------------------------------------------------------------------- | | `shapeType` | Shape type (178 types total — see below) | | `text` | string (text inside shape) | | `fill` | `fill.color="hex" fill.transparency="0.5"` | | `line` | `line.color="hex" line.width="2" line.dashType="dash"` | | `outline` | `outline.size="2" outline.color="0088CC"` — Text-style alias for `line`; overrides `line.color`/`line.width` when both are set, `line.dashType` is preserved | | `glow` | `glow.size="8" glow.opacity="0.5" glow.color="FF3399"` — native shape glow (editable in PowerPoint, not rasterized) | | `rotate` | number (degrees clockwise, render-only) | | Text attributes | `fontSize` `color` `textAlign` `bold` `italic` `underline` `strike` `subscript` `superscript` `highlight` `fontFamily` `lineHeight` | `fill`, `line`, and other style objects also allow mixing shorthand + dot notation on the same node (dot notation overrides specific keys). **Shape effects (glow / outline):** `glow` adds a glow around the shape edge (`size` in px → converted to EMU, `opacity` 0-1, `color` hex; defaults: 8 / 0.75 / FFFFFF). `outline` is a Text-style alias for `line`; both produce native PowerPoint effects that stay editable. Typical use is glowing badge dots (`Shape shapeType="ellipse" w="20" h="20" fill.color="3B82F6" glow.size="12" glow.color="3B82F6"`), accent-glow KPI plates, and timeline markers. Do **not** wrap the shape with `Layer` purely to overlay a soft glow — `glow` on the shape itself is more compact and editable. **Full shapeType list:** Basic shapes: `arc`, `bevel`, `blockArc`, `can`, `chord`, `corner`, `cube`, `decagon`, `diagStripe`, `diamond`, `dodecagon`, `donut`, `ellipse`, `folderCorner`, `frame`, `funnel`, `halfFrame`, `heptagon`, `hexagon`, `homePlate`, `nonIsoscelesTrapezoid`, `octagon`, `parallelogram`, `pentagon`, `pie`, `pieWedge`, `plaque`, `plus`, `rect`, `roundRect`, `rtTriangle`, `trapezoid`, `triangle` Rounded / snipped rectangles: `round1Rect`, `round2DiagRect`, `round2SameRect`, `snip1Rect`, `snip2DiagRect`, `snip2SameRect`, `snipRoundRect` Arrows: `bentArrow`, `bentUpArrow`, `chevron`, `circularArrow`, `curvedDownArrow`, `curvedLeftArrow`, `curvedRightArrow`, `curvedUpArrow`, `downArrow`, `leftArrow`, `leftCircularArrow`, `leftRightArrow`, `leftRightCircularArrow`, `leftRightUpArrow`, `leftUpArrow`, `notchedRightArrow`, `quadArrow`, `rightArrow`, `stripedRightArrow`, `swooshArrow`, `upArrow`, `upDownArrow`, `uturnArrow` Arrow callouts: `downArrowCallout`, `leftArrowCallout`, `leftRightArrowCallout`, `quadArrowCallout`, `rightArrowCallout`, `upArrowCallout`, `upDownArrowCallout` Callouts: `accentBorderCallout1`, `accentBorderCallout2`, `accentBorderCallout3`, `accentCallout1`, `accentCallout2`, `accentCallout3`, `borderCallout1`, `borderCallout2`, `borderCallout3`, `callout1`, `callout2`, `callout3`, `cloudCallout`, `wedgeEllipseCallout`, `wedgeRectCallout`, `wedgeRoundRectCallout` Stars & banners: `doubleWave`, `ellipseRibbon`, `ellipseRibbon2`, `horizontalScroll`, `irregularSeal1`, `irregularSeal2`, `leftRightRibbon`, `ribbon`, `ribbon2`, `star4`, `star5`, `star6`, `star7`, `star8`, `star10`, `star12`, `star16`, `star24`, `star32`, `verticalScroll`, `wave` Flowchart: `flowChartAlternateProcess`, `flowChartCollate`, `flowChartConnector`, `flowChartDecision`, `flowChartDelay`, `flowChartDisplay`, `flowChartDocument`, `flowChartExtract`, `flowChartInputOutput`, `flowChartInternalStorage`, `flowChartMagneticDisk`, `flowChartMagneticDrum`, `flowChartMagneticTape`, `flowChartManualInput`, `flowChartManualOperation`, `flowChartMerge`, `flowChartMultidocument`, `flowChartOfflineStorage`, `flowChartOffpageConnector`, `flowChartOnlineStorage`, `flowChartOr`, `flowChartPredefinedProcess`, `flowChartPreparation`, `flowChartProcess`, `flowChartPunchedCard`, `flowChartPunchedTape`, `flowChartSort`, `flowChartSummingJunction`, `flowChartTerminator` Action buttons: `actionButtonBackPrevious`, `actionButtonBeginning`, `actionButtonBlank`, `actionButtonDocument`, `actionButtonEnd`, `actionButtonForwardNext`, `actionButtonHelp`, `actionButtonHome`, `actionButtonInformation`, `actionButtonMovie`, `actionButtonReturn`, `actionButtonSound` Brackets & braces: `bracePair`, `bracketPair`, `leftBrace`, `leftBracket`, `rightBrace`, `rightBracket` Math symbols: `mathDivide`, `mathEqual`, `mathMinus`, `mathMultiply`, `mathNotEqual`, `mathPlus` Others: `chartPlus`, `chartStar`, `chartX`, `cloud`, `cornerTabs`, `gear6`, `gear9`, `heart`, `lightningBolt`, `line`, `lineInv`, `moon`, `noSmoking`, `plaqueTabs`, `smileyFace`, `squareTabs`, `sun`, `teardrop` ### Line ```xml ``` | Attribute | Type / Values | | ------------------------- | ------------------------------------------------------------------------------------- | | `x1` `y1` `x2` `y2` | number (absolute coordinates, required) | | `color` | hex (default: `000000`) | | `lineWidth` | number (default: 1) | | `dashType` | `solid` / `dash` / `dashDot` / `lgDash` / `sysDash` etc. | | `beginArrow` / `endArrow` | `true` / `endArrow.type="triangle"` (types: none/arrow/triangle/diamond/oval/stealth) | ### Arrow Native PowerPoint straight connector between two nodes referenced by `id`. `Text` and `Shape` nodes with `shapeType="rect"`, `roundRect`, or `ellipse` are supported targets; the connector attaches to the nearest cardinal connection sites (including shape rotation) and follows the targets when they move. If an ID is not found, `ARROW_REF_NOT_FOUND` is emitted. If it identifies another node type or unsupported shape geometry, `ARROW_REF_NOT_CONNECTABLE` is emitted. ```xml A B ``` | Attribute | Type / Values | | ------------------------- | ------------------------------------------------------------------------------------- | | `from` | string (id of source node, required) | | `to` | string (id of destination node, required) | | `color` | hex (default: `000000`) | | `lineWidth` | number (default: 1) | | `dashType` | `solid` / `dash` / `dashDot` / `lgDash` / `sysDash` etc. | | `beginArrow` / `endArrow` | `true` / `endArrow.type="triangle"` (types: none/arrow/triangle/diamond/oval/stealth) | ## Data Visualization Nodes ### Table ```xml
    Name Score
    Alice 95
    ``` - ``: `defaultRowHeight` (default 32), `cellBorder` (`{color, width, dashType}` — cell border style) - ``: `width` (omit for equal distribution) - ``: `height` (omit to use `defaultRowHeight`, default 32) - `
    `: text content + `fontSize` `color` `bold` `italic` `underline` `strike` `subscript` `superscript` `highlight` `fontFamily` `textAlign` `backgroundColor` `colspan` `rowspan` ### Chart ```xml ``` | Attribute | Type / Values | | ------------- | ------------------------------------------------------------------------------------------------------------ | | `chartType` | `bar` / `line` / `pie` / `area` / `doughnut` / `radar` | | `showLegend` | boolean | | `showTitle` | boolean | | `title` | string | | `chartColors` | JSON array `'["hex1","hex2"]'` | | `radarStyle` | `standard` / `marker` / `filled` (radar only) | | `sparkline` | boolean — hides legend / axes / gridlines / margins for compact display (`bar` / `line` / `area`, e.g. h=40) | **Sparkline example** (KPI tile に inline 表示する用途): ```xml ``` ### Timeline ```xml ``` | Attribute | Values | | ------------------- | ----------------------------------------------------------------------------------------------------- | | `direction` | `horizontal` / `vertical` | | `dateColor` | hex (date text color, default: `64748B`) | | `titleColor` | hex (title text color, default: `1E293B`) | | `descriptionColor` | hex (description text color, default: `64748B`) | | `connectorColor` | hex (axis line color, default: `E2E8F0`) | | `connectorGradient` | `linear-gradient(deg, %, ...)` — applies a linear gradient to the connector line | | `useColorForDate` | `true` / `false` — when `true`, each item's `date` text uses that item's `color` (default: `false`) | | `fontFamily` | font family name applied to all text (date / title / description). default: `Noto Sans JP` | ``: `date` (required) `title` (required) `description` `color` `dateColor` - `dateColor` (per-item) overrides both `Timeline.dateColor` and `useColorForDate`. - `fontFamily` changes the rendered font face only. Internal layout measurement still assumes the default label sizes (the bundled Noto Sans JP metrics), so very wide / very tall fonts may overflow within the same `w` / `h`. Pick a larger `w` / `h` if labels clip. ### Matrix ```xml ``` - Coordinates: (0,0) = bottom-left, (1,1) = top-right (mathematical coordinate system) - ``: `axisLabelColor` (default `64748B`) `quadrantLabelColor` (default `94A3B8`) `itemLabelColor` (default `1E293B`) — text colors - ``: `x` `y` (axis labels, required) - ``: `topLeft` `topRight` `bottomLeft` `bottomRight` - ``: `label` `x` `y` (required) `color` `textColor` (overrides `itemLabelColor`) ### Tree ```xml ``` | Attribute | Type / Values | | ---------------- | ----------------------------------------------------- | | `layout` | `vertical` / `horizontal` | | `nodeShape` | `rect` / `roundRect` / `ellipse` | | `textColor` | hex (node label text color, default: `FFFFFF`) | | `nodeWidth` | number (default: 120) | | `nodeHeight` | number (default: 40) | | `levelGap` | number (default: 60) | | `siblingGap` | number (default: 20) | | `connectorStyle` | `connectorStyle.color="333" connectorStyle.width="2"` | `` can be recursively nested. Only one root allowed. Attributes: `label` (required) `color` `textColor` (overrides the Tree-level `textColor`) ### Flow ```xml ``` | Attribute | Type / Values | | ---------------- | -------------------------------------------------------------------------------------- | | `direction` | `horizontal` / `vertical` | | `nodeWidth` | number (default: 120) | | `nodeHeight` | number (default: 60) | | `nodeGap` | number (default: 80) | | `connectorStyle` | `connectorStyle.color="hex" connectorStyle.width="2" connectorStyle.arrowType="arrow" connectorStyle.labelColor="hex"` | `` attributes: | Attribute | Type / Values | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string (required) — Unique node identifier | | `shape` | `flowChartTerminator` / `flowChartProcess` / `flowChartDecision` / `flowChartInputOutput` / `flowChartDocument` / `flowChartPredefinedProcess` / `flowChartConnector` / `flowChartPreparation` / `flowChartManualInput` / `flowChartManualOperation` / `flowChartDelay` / `flowChartMagneticDisk` | | `text` | string (required) — Display text | | `color` | hex color (e.g. `"4CAF50"`) — Node fill color | | `textColor` | hex color (e.g. `"FFFFFF"`) — Text color | | `width` | number — Individual node width (overrides `nodeWidth`) | | `height` | number — Individual node height (overrides `nodeHeight`) | ``: `from` `to` (required) `label` `color` `labelColor` (label text color; overrides `connectorStyle.labelColor`, default: `64748B`) ### ProcessArrow ```xml ``` | Attribute | Type / Values | | ------------------------ | ---------------------------------------------------------- | | `direction` | `horizontal` / `vertical` | | `itemWidth` | number (default: 150) | | `itemHeight` | number (default: 80) | | `gap` | number (default: -(itemHeight×0.35), negative for overlap) | | `fontSize` | number (default: 14) | | `bold` `italic` `strike` | boolean | | `underline` | `true` / `underline.style="wavy" underline.color="FF0000"` | | `highlight` | hex (highlight color) | | `fontFamily` | string (default: `Noto Sans JP`) | ``: `label` (required) `color` (default: `4472C4`) `textColor` (default: `FFFFFF`) ### Pyramid ```xml ``` | Attribute | Type / Values | | ------------ | -------------------------------- | | `direction` | `up` (default) / `down` | | `fontSize` | number (default: 14) | | `bold` | boolean | | `fontFamily` | string (default: `Noto Sans JP`) | ``: `label` (required) `color` (default: `4472C4`) `textColor` (default: `FFFFFF`) - `direction="up"`: First PyramidLevel is the apex (narrowest), last is the base (widest) - `direction="down"`: First PyramidLevel is the top (widest), last is the bottom (narrowest) ## Child Element Tag Reference | Parent Node | Child Tags | Mapped Property | | ---------------- | --------------------------------------------------- | ---------------------------- | | `` | `` > `` | `data` | | `` | ``, `` > `
    ` | `columns`, `rows` | | `` | ``, ``, ``, ``, ``, ``, ``, ``, `` | `runs` (inline formatting) | | `
  • ` | ``, ``, ``, ``, ``, ``, ``, ``, `` | `runs` (inline formatting) | | `
  • ` | ``, ``, ``, ``, ``, ``, ``, ``, `` | `runs` (inline formatting) | | `` | `` | `items` | | `` | ``, ``, `` | `axes`, `quadrants`, `items` | | `` | `` (recursive) | `data` | | `` | ``, `` | `nodes`, `connections` | | `` | `` | `steps` | | `` | `` | `levels` | When the same property is specified via both attributes (JSON string) and child elements, child elements take precedence. ## Slide Patterns ### Basic Structure ```xml Title Body text ``` ### Two-Column Layout ```xml Title Left column Right column ``` ### KPI Tile with Dot Indicator (color-coded category) `borderTop` + `borderRadius` is now supported directly — `` produces a rounded tile whose top edge and both upper corners are painted in `borderTop.color`. The dot + uppercase label pattern below remains a useful alternative when you want the indicator inside the tile (e.g. to leave the corner radius uniform across mixed-color KPI rows). ```xml MRR 84.2 M QoQ +4.1% NRR 118 % QoQ +2.0pt ``` - The colored dot + matching uppercase label carries the category color without needing a top-edge stripe. - Keep the dot small (6–10 px) so it reads as a category indicator, not a bullet. - For a more prominent variant, thicken the dot to a short horizontal bar (`Shape shapeType="roundRect" w="24" h="3"` filled with the category color). To make the dot pop on dark backgrounds, attach a small `glow` to the `Shape` itself (`glow.size="10" glow.opacity="0.7" glow.color=""`) — it stays editable in PowerPoint as a native shape effect. ## Notes - Colors do not need `#` prefix (`FF0000`) - `alignItems` / `justifyContent` use `start` / `end` (not `left` / `right`) - Property names are `w` / `h` (not `width` / `height`) - Children of `Layer` require `x` and `y` - `Tree` must have exactly one root `` - For decorative agenda / section numbering, prefer `01.` or `#01` instead of pure numeric `01`. LibreOffice-based fallback PNG conversion can drop leading zeros from pure numeric text, while the PPTX itself remains correct in PowerPoint. ## Build Diagnostics Building emits warnings (`diagnostics`) for layout problems that can be detected from the computed coordinates — fix the XML when these appear: - `NODE_OUT_OF_BOUNDS` — a node's rectangle extends beyond the slide bounds. The message identifies the slide, the node (tag / `id` / path), and the overflowing edges. Shrink or move the node, reduce content, or split the slide. Nodes with `rotate` and `Line` / `Arrow` are not checked (their final bounds cannot be derived statically), so verify those visually. - `NODE_OVERLAP` — siblings inside `VStack` / `HStack` overlap unintentionally (e.g. via `top` / `left` offsets). Intentional overlaps are NOT reported: children of `Layer`, `position="absolute"` nodes, negative `margin` / `gap` (e.g. `ProcessArrow`'s default negative gap), and nodes with an explicit `zIndex`. To keep a deliberate overlap, express it with one of those mechanisms.