Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(native-charts): define explicit layout metadata

hugohe306c1c0936fed
diff --git a/skills/ppt-master/references/executor-chart.md b/skills/ppt-master/references/executor-chart.md
index 54c870f6..630da694 100644
--- a/skills/ppt-master/references/executor-chart.md
+++ b/skills/ppt-master/references/executor-chart.md
@@ -118,6 +118,12 @@ The number of markers must equal the number of promoted chart objects, and each
marker must sit under its matching object wrapper. One marker somewhere on a
multi-chart page is insufficient.
+**Native layout handoff**: for a native-ready classic chart whose authored plot
+rectangle must remain fixed, copy that final absolute slide rectangle into
+metadata `plot_area`; omit it only for PowerPoint automatic layout. The marker
+comment alone does not affect export; the closed schema stays in
+[`native-data-interface.md`](./native-data-interface.md) §2.
+
Technical SVG/PPT constraints remain in [`shared-standards-core.md`](./shared-standards-core.md).
---
diff --git a/skills/ppt-master/references/native-data-interface.md b/skills/ppt-master/references/native-data-interface.md
index 5ffdecbd..2536ba11 100644
--- a/skills/ppt-master/references/native-data-interface.md
+++ b/skills/ppt-master/references/native-data-interface.md
@@ -92,6 +92,11 @@ inside PowerPoint's 32-bit DrawingML coordinate range; `width` and `height`
must resolve to at least one EMU. Native table frames must additionally resolve
to at least one EMU per resolved row and column.
+**Classic plot-area layout**: supported classic charts accept root `plot_area`;
+ChartEx rejects it. It contains only finite `x`, `y`, `width`, `height` in
+absolute slide px and forms a positive rectangle inside the chart frame. Export
+writes `c:manualLayout`; omission keeps automatic layout.
+
**Validation**: `svg_quality_checker.py` validates replacement marker kind, JSON
metadata, bounds/fallback availability, table rows/columns, supported chart
type, chart data shape, and any imported fallback baseline before export.
@@ -211,6 +216,8 @@ with `unsupported-merge-topology`.
`series[].values`. Pie-family charts (`pie`, `doughnut`, `pieOfPie`, and
`barOfPie`) must have exactly one series; the exporter assigns per-category
slice colors so single-series charts do not collapse into one solid color.
+Root `hole_size` is doughnut-only, integer `10..90`, default `75`;
+no pie-family rotation or angle field exists.
Column and bar charts may set per-point colors with `series[].point_colors`
or `series[].pointColors`; the list must match `series[].values` length.
Classic category charts may set native PowerPoint data labels with
@@ -259,6 +266,8 @@ area charts and OHLC stock charts; arbitrary date-axis source families are not.
This contract is not a full `AxisSpec`: logarithmic scales, minor units/gridlines,
crossing values, display units, tick skipping, and other unlisted OOXML semantics
remain unsupported and fail closed on import.
+Single-plot `bar` accepts `category` at left/right and `value` at bottom/top;
+`pie`, `doughnut`, and `pieOfPie` / `barOfPie` reject `axes`.
**Narrow XY-axis schema**: `scatter` and `bubble` may use a closed `axes` object
with only `x` and `y` roles. Both roles have `kind: "value"`; `x.position`
@@ -285,19 +294,15 @@ imply full visual-axis parity.
required only when the native object must preserve typography that cannot be
inferred unambiguously from the visible fallback.
-**Chart chrome metadata**: Text that is visually part of the chart must be in
-metadata, not only in SVG fallback children; metadata MUST still match visible
-fallback chrome. `title` becomes the native chart title on classic charts; it
-is not an object name, so use `name` for semantic object naming. `subtitle`
-becomes the second rich-text line of that classic chart title. `title`,
-`subtitle`, and axis-title values may be strings or objects with `text`,
-`font_size`, `font_family`, and `color` when the fallback uses local role
-typography. `svg_quality_checker.py` rejects `title`, `subtitle`, or axis-title
-metadata whose text is not visible inside the replacement marker's fallback. Direct
-`--native-charts-and-tables` export keeps the chart native but omits that inconsistent
-chrome with a warning. chartEx keeps PowerPoint's empty `<cx:title>` and emits
-the title / subtitle as companion editable text boxes until chartEx rich titles
-are validated. Axis
+**Chart chrome metadata**: Metadata MUST match fallback chrome. For classic
+charts, a string or unbounded-object `title` becomes native `c:title`;
+`subtitle` is line two. A title object with complete `x`, `y`,
+`width`, and `height` becomes a companion editable text box at those absolute
+slide-px bounds; partial bounds or `subtitle` fail. Use `name`, not
+`title`, for object naming. `title`, `subtitle`, and axis-title objects may set
+`text`, `font_size`, `font_family`, and `color`. The checker rejects title/axis
+text absent from the fallback; export omits it with a warning. ChartEx keeps an empty `<cx:title>` and
+emits title/subtitle as companion editable text boxes. Axis
titles are optional and explicit: use `axis_titles` with
`category`, `value`, `x`, `y`, or `secondary_value` keys, or the root aliases
`category_axis_title`, `value_axis_title`, `x_axis_title`, `y_axis_title`, and