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.mdindex 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 eachmarker must sit under its matching object wrapper. One marker somewhere on amulti-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.mdindex 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 resolveto 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, JSONmetadata, bounds/fallback availability, table rows/columns, supported charttype, 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-categoryslice 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 semanticsremain 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` objectwith 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 beinferred 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. Axistitles 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