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(pptx-objects): document P2 reconstruction boundaries

hugohe3be0985935717
diff --git a/docs/technical-design.md b/docs/technical-design.md
index f4cef9c3..ac965b71 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -466,7 +466,7 @@ These direct routes share some analysis primitives with the main pipeline, espec
**Why each template SVG stays complete while still compiling to a Layout.** A generated SVG is a complete standalone preview, so it repeats inherited Master/Layout visuals together with its selectable Slide content. `page_layouts` names the input reference and `pptx_layouts` names the output Layout; both exist for every template page. Strict keeps the selected contract, while adaptive may lock a new Layout key under the same Master. Export removes repeated inherited copies and emits real Master/Layout parts, leaving actual content on the Slide.
-**Why native-object reconstruction uses markers, not automatic object replacement.** The standalone `pptx_to_svg.py` importer can emit SVG fallback content plus `data-pptx-native` metadata for supported unmerged tables and conservative classic-chart caches. The normalized fallback for table style `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}` resolves `wholeTbl`, `firstRow`, horizontal banding, theme colors/fonts, and direct overrides; this does not imply a full built-in/custom style registry. For supported parsed column/bar/line/area, pie/doughnut, scatter, and bubble charts, a missing baked preview is replaced by a deterministic readable SVG fallback with `visual=normalized`. Common solid/no-fill/line/marker forms and scheme colors are accepted conservatively; unknown style XML still fails closed. Native replacement may normalize style details absent from the payload, which remains part of the explicit editable-first warning. The importer also retains chart title/legend/axis titles and supported plot-level data-label flags. The default export consumes fallback children as regular DrawingML shapes; only `--native-objects` activates editable PowerPoint tables/charts. Unsupported table cases — including merged cells, direct borders, non-solid fills, and mixed rich text — keep the rendered SVG table. Unsupported chart cases — including ChartEx import, rotated/flipped/3D/combo charts, unsupported data-label scopes/types, custom axis semantics, trendlines/error bars, unsupported subtype options, sparse or non-finite caches, and date/formatted category axes — keep a baked preview when one exists. Active types outside the current renderer, including `of_pie`, retain `visual=placeholder` / `route=reconstruction-only`; native opt-in may still reconstruct their valid payload. Every active imported marker is stamped with `data-pptx-fallback-sha256`: stale visible edits, reachable SVG fragment-definition changes, marker-local reference-target changes, or marker transforms are reported by the mandatory checker; default export keeps the SVG, while native replacement hard-fails. Hashless legacy markers remain compatible with a checker/native-route warning. ChartEx emission consumes valid payload colors in the color-style part, without claiming full source-style fidelity. Invalid status declarations remain errors. This importer/exporter pairing is a reconstruction aid, not a preservation-route substitute for `template-fill-pptx` or `native-enhance-pptx`.
+**Why native-object reconstruction uses markers, not automatic object replacement.** The standalone `pptx_to_svg.py` importer can emit SVG fallback content plus `data-pptx-native` metadata for verified text-grid tables and conservative classic-chart caches. The table subset now includes unmerged grids, canonical rectangular merge topology with empty slaves, safe solid/no-fill per-side borders, and plain multi-paragraph cells whose run styling is uniform. Noncanonical or overlapping merges, nonblank slaves, unsafe border XML, non-solid fills, and mixed run-level rich text still fail closed. The normalized fallback for table style `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}` resolves `wholeTbl`, `firstRow`, horizontal banding, theme colors/fonts, and direct overrides; this does not imply a full built-in/custom style registry. For supported parsed column/bar/line/area, pie/doughnut, scatter, and bubble charts, a missing baked preview is replaced by a deterministic readable SVG fallback with `visual=normalized`. The importer additionally covers the verified column/line/area combo subset, canonical four-series OHLC stock charts, and area charts with numeric date axes. Combo plots may retain independent primary/secondary category caches and workbook ranges. Axis preservation is a closed category/value role contract for kind, position, visibility, label position, number format, min/max/major unit, reversal, and major gridlines — not a full `AxisSpec`. Common solid/no-fill/line/marker forms and scheme colors are accepted conservatively; unknown series paint/style XML outside the explicit normalization boundaries still fails closed. Safe stock series style may pass the structural gate, but stock series, `hiLowLines`, and up-down bar local styling can still normalize under the editable-first contract. Native replacement may normalize style details absent from the payload, which remains part of the explicit editable-first warning. The importer also retains chart title/legend/axis titles and supported plot-level data-label flags. The default export consumes fallback children as regular DrawingML shapes; only `--native-objects` activates editable PowerPoint tables/charts. Unsupported chart cases — including ChartEx import, rotated/flipped/3D charts, combo or stock variants outside the verified subset, unsupported date-axis families, unmodeled axis semantics, unsupported data-label scopes/types, trendlines/error bars, unsupported subtype options, and sparse or non-finite caches — keep a baked preview when one exists. Active types outside the current renderer, including `of_pie`, combo, and stock, retain `visual=placeholder` / `route=reconstruction-only` when no source preview exists; native opt-in may still reconstruct their valid payload. Every active imported marker is stamped with `data-pptx-fallback-sha256`: stale visible edits, reachable SVG fragment-definition changes, marker-local reference-target changes, or marker transforms are reported by the mandatory checker; default export keeps the SVG, while native replacement hard-fails. Hashless legacy markers remain compatible with a checker/native-route warning. ChartEx emission consumes valid payload colors in the color-style part, without claiming ChartEx import or full source-style fidelity. Invalid status declarations remain errors. This importer/exporter pairing is a reconstruction aid, not a preservation-route substitute for `template-fill-pptx` or `native-enhance-pptx`.
---
diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.md
index d266af71..59cd103c 100644
--- a/docs/zh/technical-design.md
+++ b/docs/zh/technical-design.md
@@ -466,7 +466,7 @@ PowerPoint 的 DrawingML 是 SVG 表达力的严格子集。在转换器已实
**为什么模板 SVG 保持完整却仍能编译成版式。** 每张生成 SVG 都是可独立预览的完整 slide,因此会重复携带继承的 Master/Layout 视觉和可选择的 Slide 内容。`page_layouts` 指定输入参考,`pptx_layouts` 指定输出版式,两者在模板路线中逐页齐全。严格模式保持所选契约;自适应模式可在同一 Master 下锁定新 Layout。导出器移除重复继承层并生成真实 Master/Layout,实际内容仍留在 Slide。
-**为什么原生对象重建使用 marker,而不是自动替换对象。** 独立的 `pptx_to_svg.py` 导入器会为受支持的未合并表格和保守 classic-chart cache 输出 SVG fallback,并附加 `data-pptx-native` 元数据。表格样式 `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}` 的规范化 fallback 会解析 `wholeTbl`、`firstRow`、横向带状行、主题颜色 / 字体和直接格式覆盖;这不代表已经实现完整 built-in/custom style registry。受支持的柱 / 条 / 折线 / 面积、饼 / 圆环、散点 / 气泡图在没有 baked preview 时会生成确定性、可读的 SVG fallback,并标记 `visual=normalized`。常见 solid/no-fill/line/marker 写法和 scheme color 会被保守解析,未知 style XML 仍 fail closed;payload 未建模的样式细节在 native 替换时仍可能归一化,并由 editable-first warning 明示。图表标题、图例、坐标轴标题和受支持的数据标签语义继续保留。默认导出把 fallback 子元素当普通 DrawingML shape 处理;只有 `--native-objects` 才启用可编辑的 PowerPoint 表格 / 图表。合并单元格、直接边框、非纯色填充、混合富文本等不支持的表格场景继续保留 SVG table。ChartEx 导入、旋转 / 翻转 / 3D / 组合图表、不受支持的数据标签、自定义坐标轴、趋势线 / 误差线、不受支持的子类型、稀疏或非有限 cache、日期 / 格式化类别轴等场景在有 baked preview 时保留预览。当前 renderer 范围之外但 payload 仍有效的类型(包括 `of_pie`)继续使用 `visual=placeholder` / `route=reconstruction-only`,native opt-in 仍可重建。每个 active imported marker 都写入 `data-pptx-fallback-sha256`:可见 fallback、可达的 SVG fragment definition、marker 内部引用目标或 marker transform 后续被改动时,强制质量检查器会报告 stale;默认导出继续保留 SVG,native replacement hard fail。无 hash 的旧 marker 仍兼容,只在 checker/native 路线提示无法检测 stale。ChartEx emitter 现在把有效 payload colors 写入 color-style part,但不承诺完整源样式保真。非法状态声明继续作为 error。这对 importer/exporter 是重建辅助能力,不能替代 `template-fill-pptx` 或 `native-enhance-pptx` 的保留型路线。
+**为什么原生对象重建使用 marker,而不是自动替换对象。** 独立的 `pptx_to_svg.py` 导入器会为已验证的纯文本表格和保守 classic-chart cache 输出 SVG fallback,并附加 `data-pptx-native` 元数据。表格子集现已覆盖未合并网格、slave 为空的规范矩形 merge topology、安全的 solid/no-fill 逐边 border,以及 run 样式一致的纯文本多段落单元格;非规范或重叠 merge、非空 slave、不安全 border XML、非纯色填充和混合 run-level 富文本仍 fail closed。表格样式 `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}` 的规范化 fallback 会解析 `wholeTbl`、`firstRow`、横向带状行、主题颜色 / 字体和直接格式覆盖;这不代表已经实现完整 built-in/custom style registry。受支持的柱 / 条 / 折线 / 面积、饼 / 圆环、散点 / 气泡图在没有 baked preview 时会生成确定性、可读的 SVG fallback,并标记 `visual=normalized`。导入器还覆盖已验证的柱 / 折线 / 面积组合图子集、规范四系列 OHLC stock,以及使用数值日期轴的面积图;组合图的主 / 次 plot 可保留独立 category cache 和 workbook range。坐标轴保留只采用封闭的 category/value 角色与 kind、position、visibility、label position、number format、min/max/major unit、reverse、major_gridlines 字段,不是完整 `AxisSpec`。常见 solid/no-fill/line/marker 写法和 scheme color 会被保守解析,显式归一化边界之外的未知 series paint/style XML 仍 fail closed。安全的 stock series style 可通过结构门禁,但 stock series、`hiLowLines` 与 up-down bar 的局部样式仍可能按 editable-first 合同归一化。payload 未建模的样式细节在 native 替换时仍可能归一化,并由 editable-first warning 明示。图表标题、图例、坐标轴标题和受支持的数据标签语义继续保留。默认导出把 fallback 子元素当普通 DrawingML shape 处理;只有 `--native-objects` 才启用可编辑的 PowerPoint 表格 / 图表。ChartEx 导入、旋转 / 翻转 / 3D 图表、已验证子集之外的 combo/stock 变体、其他日期轴图表族、未建模坐标轴语义、不受支持的数据标签、趋势线 / 误差线、不受支持的子类型、稀疏或非有限 cache 等场景在有 baked preview 时继续保留预览。当前 renderer 范围之外但 payload 仍有效的类型(包括 `of_pie`、combo 和 stock)在没有源 preview 时继续使用 `visual=placeholder` / `route=reconstruction-only`,native opt-in 仍可重建。每个 active imported marker 都写入 `data-pptx-fallback-sha256`:可见 fallback、可达的 SVG fragment definition、marker 内部引用目标或 marker transform 后续被改动时,强制质量检查器会报告 stale;默认导出继续保留 SVG,native replacement hard fail。无 hash 的旧 marker 仍兼容,只在 checker/native 路线提示无法检测 stale。ChartEx emitter 现在把有效 payload colors 写入 color-style part,但不承诺 ChartEx 导入或完整源样式保真。非法状态声明继续作为 error。这对 importer/exporter 是重建辅助能力,不能替代 `template-fill-pptx` 或 `native-enhance-pptx` 的保留型路线。
---
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.md
index 49c30e1d..5e979b96 100644
--- a/skills/ppt-master/SKILL.md
+++ b/skills/ppt-master/SKILL.md
@@ -869,6 +869,17 @@ python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>
> `--native-objects` fails rather than discard the edit. Legacy markers
> without a baseline remain native-compatible and only warn that stale detection
> is unavailable.
+> Imported table markers may also cover the verified narrow P2 subset:
+> canonical rectangular merges with blank covered cells, safe per-side borders,
+> and plain multi-paragraph cells. Run-level table rich text, noncanonical merge
+> topology, and unsafe direct formatting remain fallback-only. Imported classic
+> charts additionally cover verified column/line/area combos, canonical OHLC
+> stock, and area date-axis cases with a closed category/value axis field set.
+> This is not full `AxisSpec` or ChartEx import support; unmodeled chart/axis
+> semantics continue to fail closed without reducing existing active-marker
+> SVG-to-native conversion. Safe stock series style may pass the structural
+> gate, but stock series / high-low / up-down local styling may still normalize
+> under the documented editable-first contract.
**Optional animation flags** (page transitions are on by default; per-element entrance is off by default — turn it on only when the user asks for it):
- `-t <effect>` — page transition. Default `fade`. Options: `fade` / `push` / `wipe` / `split` / `strips` / `cover` / `random` / `none`. `none` removes only the visual transition; an explicit automatic advance remains valid.
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 441a94d1..1dc87187 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -311,7 +311,7 @@ grep "chart-plot-area" <project_path>/svg_output/<current_page>.svg
**Hard rule**: every data chart whose type appears in the **Supported chart types** list of [shared-standards.md](shared-standards.md) "Native PPTX Table / Chart Markers" (the single authority for the eligible set, marker contract, and JSON schemas) gets `data-pptx-native="chart"` plus a `<metadata data-pptx-native="chart">` JSON child on its top-level `<g>`, transcribing the same data just plotted. Every pure text-grid data table gets `data-pptx-native="table"` the same way, transcribing all visible cell text into `columns` / `rows`.
- Chart types absent from that list and conceptual/diagrammatic graphics (process flows, cycles, quadrant cards, timelines, KPI cards) get **no marker** — `svg_quality_checker.py` rejects unsupported marker types.
-- Tables with merged, spanning, or graphical cells (icons, harvey balls, rating dots) get **no table marker** — the exporter rejects merged-cell metadata; they stay on the SVG fallback route.
+- Canonical rectangular merged text cells may carry a table marker by putting anchor-only `row_span` / `col_span` in metadata and leaving covered cells blank. Nonrectangular/overlapping merges, nonblank covered cells, and graphical cells (icons, harvey balls, rating dots) get **no table marker** and stay on the SVG fallback route.
- Transcribe, don't restyle: `categories` / `series[].values` are the numbers just plotted; `style.colors` carries the series HEX values already used on the page (from `spec_lock.colors`).
- Data-point color: when a single column/bar series uses data-point colors in the fallback, copy those fills into `series[].point_colors` in category order.
- Data labels: when visible point values are part of the fallback chart, write `data_labels` instead of companion text; use `data_labels.points` for selected labels, and use `number_format`, `font_size`, `font_family`, and per-point `colors` / `color` when the fallback labels carry suffixes or color-coded text.
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index ccb0c198..dd307de7 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -977,7 +977,7 @@ the preset is outside this enum.
Native PowerPoint tables and Excel-backed charts activate at export time only. The default chart/table route remains hand-authored SVG geometry so the deck stays pixel-stable across PowerPoint / Keynote / LibreOffice / WPS.
-**Authoring — markers are standard on supported data charts and text-grid tables**: Executor writes the marker at draw time on every data chart whose type falls in the supported set and on every pure text-grid data table ([executor-base.md §3.2](executor-base.md)), so any deck can later form native objects without regeneration. Tables with merged or graphical cells stay unmarked on the SVG fallback route. The marker group supplies both: visible SVG fallback children for browser/live-preview rendering, and JSON metadata for `svg_to_pptx` native export.
+**Authoring — markers are standard on supported data charts and text-grid tables**: Executor writes the marker at draw time on every data chart whose type falls in the supported set and on every pure text-grid data table ([executor-base.md §3.2](executor-base.md)), so any deck can later form native objects without regeneration. Canonical rectangular merged text cells may use the narrow `row_span` / `col_span` contract below; graphical cells stay unmarked on the SVG fallback route. The marker group supplies both: visible SVG fallback children for browser/live-preview rendering, and JSON metadata for `svg_to_pptx` native export.
**Hard rule — activation is the opt-in, dormant unless exported with `--native-objects`**: A marker only declares that a group is eligible for native export. Normal `svg_to_pptx.py` runs keep the fallback SVG children. Pass `--native-objects` only when editability in PowerPoint matters more than cross-renderer layout fidelity: it emits the PowerPoint object and skips the fallback children to avoid duplicates. Native styling preserves the core palette, text, axis, grid, and background colors where possible, but it is still a PowerPoint chart/table object rather than a pixel-identical SVG drawing.
@@ -1066,6 +1066,15 @@ Cell objects accept `text`, `fill`, `color`,
`align`, `valign`, `bold`, `font_size`, `padding`, `border_color`, and
`border_width`, plus optional `lang`; the same `padding`, `border_color`,
`border_width`, and `lang` keys may also live under `style` as table defaults.
+For plain multi-paragraph text, replace `text` with a non-empty `paragraphs`
+list. Each entry is either a string or `{ "text": "...", "align": "l|ctr|r" }`;
+empty paragraph strings are preserved, and `text` / `paragraphs` are mutually
+exclusive. This is paragraph-level plain text, not run-level rich text.
+Per-side cell borders use `borders.left|right|top|bottom`, where each value is
+either `{ "style": "none" }` or
+`{ "style": "solid", "color": "#RRGGBB", "width": <positive-px> }`.
+Per-side borders are cell-only; legacy uniform `border_color` / `border_width`
+remain supported as defaults that an individual side may override.
When `lang` is absent, export derives `zh-CN` for CJK text and `en-US`
otherwise. `style.band_row: false` disables both `<a:tblPr bandRow>` and
materialized alternating row fills. Native table typography mirrors the
@@ -1083,12 +1092,16 @@ fallback `<text>` inside a native table marker does not appear in metadata.
For numeric or currency columns, use cell objects with `align: "r"`; SVG
`text-anchor="end"` does not carry into the native table.
-**Forbidden — native merged table cells**: Do not use `rowSpan`, `colSpan`,
-`gridSpan`, `hMerge`, `vMerge`, or top-level merge lists in native table
-metadata. `svg_to_pptx.py --native-objects` rejects them so merged-cell tables
-do not silently degrade into incorrect grids. Keep merged-cell tables on the
-default SVG fallback route, or merge cells manually in PowerPoint after native
-export.
+**Merged table cells — canonical rectangular contract only**: Put positive JSON
+integer `row_span` / `col_span` values on the merge anchor and keep every
+covered grid cell blank. Spans must stay within the resolved rectangular grid
+and may not overlap. The exporter emits the canonical DrawingML topology
+(`rowSpan` on the top edge, `gridSpan` on the left edge, `hMerge` / `vMerge` on
+covered cells). CamelCase aliases, raw OOXML merge fields, top-level merge lists,
+nonblank covered cells, invalid spans, and overlaps fail fast. The PPTX importer
+activates native reconstruction only for that same explicit rectangular topology
+with empty merge-slave text bodies; other merge encodings remain fallback-only
+with `unsupported-merge-topology`.
**Category chart schema**: `column`, `bar`, `line`, `area`, `pie`,
`doughnut`, `pieOfPie`, `barOfPie`, and `radar` use `categories` plus
@@ -1112,6 +1125,16 @@ zero-based `idx` plus optional per-point `position`, `number_format`,
**Combo chart schema**: `combo` uses shared `categories` plus either `plots[]`
or typed `series[]`. Each plot supports `type: "column" | "line" | "area"`,
its own `series`, and optional `axis: "secondary"` for a right-side value axis.
+When primary and secondary plots genuinely use different category caches,
+`plots[]` may also carry its own `categories` and `category_numeric`; the
+workbook writer allocates independent category/value ranges. Typed `series[]`
+continues to require the shared top-level categories.
+Imported `plots[]` may carry `series_indices` so the verified source identity
+where each `c:idx` equals its `c:order` survives when physical plot order differs
+from legend order. If one plot supplies it, every plot must supply a same-length
+list of unique non-negative JSON integers, and the combined values must form one
+contiguous `0..N-1` range. Sources whose `idx` and `order` differ stay
+fallback-only; typed `series[]` does not accept this plot-scoped field.
Typed `series[]` accepts the same `type` and `axis` fields per series, and
adjacent compatible series are grouped into the same PowerPoint plot. Area
series may set `fill_opacity` / `fillOpacity` as a `0..1` SVG opacity value
@@ -1122,6 +1145,18 @@ area plots below columns and lines while preserving the original series indices.
Line and area series may set `line_width` / `lineWidth` in SVG px units to
match fallback `stroke-width`.
+**Narrow classic-axis schema**: `axes` is a closed object with the roles
+`category`, `value`, `secondary_category`, and `secondary_value`. Each role may
+set only `kind` (`text`, `date`, or `value`, as appropriate), `position`,
+`visible`, `label_position` (`next_to`, `none`, `low`, or `high`),
+`number_format`, `minimum`, `maximum`, `major_unit`, `reverse`, and
+`major_gridlines`. `major_unit` applies to value axes only. PPTX date-axis
+**import** is deliberately narrow: numeric Excel date serials are accepted for
+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.
+
**XY chart schema**: `scatter` and `bubble` use `series[].x` + `series[].y`; `bubble` also requires one `series[].size` / `series[].sizes` value per point. `series[].points` is also accepted as `[x, y]` / `[x, y, size]` tuples or `{x, y, size}` objects.
**Chart typography**: Metadata sizes use the same px-style unit as SVG text
@@ -1200,7 +1235,20 @@ these input shapes:
**Stock chart schema**: `stock` uses numeric Excel date serials in
`categories` or `dates`, plus exactly four series in open / high / low / close
order. Use either `series` with four entries, or top-level `open`, `high`,
-`low`, and `close` arrays.
+`low`, and `close` arrays. PPTX import currently recognizes only canonical OHLC
+stock charts with shared numeric date caches, `hiLowLines`, and `upDownBars`.
+Safe stock series style may pass the structural gate, but stock series,
+`hiLowLines`, and up-down bar local styling can still normalize under the
+editable-first contract. HLC, volume, noncanonical structure, and style XML
+outside the safe parsing boundary stay fallback-only.
+
+**PPTX chart-import boundary**: The importer recognizes conservative classic
+single-plot charts plus the verified column/line/area combo, area date-axis, and
+canonical OHLC stock subsets above. ChartEx output can be authored from marker
+metadata, but ChartEx **import** is still unsupported. Full `AxisSpec`, radar
+import, arbitrary stock variants, and combo/date-axis semantics outside the
+closed fields above remain fallback-only; this does not reduce the existing
+SVG-marker-to-native writer support.
**Deferred chart types**: Exploded pie / doughnut variants, `map`, `heatmap`,
`bullet`, and `gantt` are intentionally outside the current native-object
diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.md
index edc34cfd..daae98ad 100644
--- a/skills/ppt-master/scripts/README.md
+++ b/skills/ppt-master/scripts/README.md
@@ -138,7 +138,9 @@ Deck/layout template routes use explicit template structure. Each complete SVG n
Current `create-template` output always rebuilds explicit SVG structure and does not package `native_structure.json` or `source_template.pptx`. `preserve` remains available only for existing projects that already carry the legacy pair.
-`pptx_to_svg.py` annotates supported unmerged tables and conservative classic-chart caches with `data-pptx-native` metadata. For table style `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}`, its normalized SVG fallback resolves `wholeTbl`, `firstRow`, horizontal banding, theme colors/fonts, and direct cell/run overrides; other built-in/custom style families are not implied. Supported parsed column/bar/line/area, pie/doughnut, scatter, and bubble charts without a baked preview receive a deterministic readable fallback marked `data-pptx-visual-status="normalized"`. Safe common series paint forms and theme scheme colors are resolved, while unknown style XML still fails closed. The editable native replacement remains allowed to normalize unmodeled no-fill/alpha/line/marker details and reports the route-level loss risk. Chart title/legend/axis titles and supported data-label flags are retained when the current schema can represent them. Tables with direct borders, non-solid fills, mixed rich-text formatting, or merges remain fallback-only, as do charts with unsupported label scopes/types, custom axis semantics, trendlines/error bars, or subtype options. Fallback-only objects keep rendered SVG content or a baked chart preview and carry `data-pptx-native-status`, which validation and `--native-objects` export report as a warning. A supported active marker without a renderer, such as current `of_pie`, keeps `data-pptx-visual-status="placeholder"` plus `data-pptx-route-status="reconstruction-only"`; default export keeps the placeholder and native opt-in may still reconstruct it.
+`pptx_to_svg.py` annotates verified text-grid tables and conservative classic-chart caches with `data-pptx-native` metadata. Table import now covers unmerged grids plus canonical rectangular merges, safe solid/no-fill per-side borders, and plain multi-paragraph cells. A merge must use the exact `rowSpan` / `gridSpan` / `hMerge` / `vMerge` physical topology with empty merge slaves; unsafe border XML, mixed run formatting, non-solid fills, and other merge encodings remain fallback-only. For table style `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}`, the normalized SVG fallback resolves `wholeTbl`, `firstRow`, horizontal banding, theme colors/fonts, and direct cell/run overrides; other built-in/custom style families are not implied.
+
+Supported parsed column/bar/line/area, pie/doughnut, scatter, and bubble charts without a baked preview receive a deterministic readable fallback marked `data-pptx-visual-status="normalized"`. The importer additionally activates verified column/line/area combo charts, canonical OHLC stock charts, and area charts with numeric date axes. Combo plots may retain independent primary/secondary category caches and workbook ranges. Axis preservation uses a closed role/field subset (`category`, `value`, optional secondary roles; kind/position/visibility/label position/number format/min/max/major unit/reverse/major gridlines), not a full `AxisSpec`. ChartEx import, arbitrary stock variants, other date-axis families, and unlisted axis semantics remain fallback-only. Safe common series paint forms and theme scheme colors are resolved; unknown series paint/style XML outside the explicit normalization boundaries still fails closed. Safe stock series style may pass the structural gate, but stock series, `hiLowLines`, and up-down bar local styling can still normalize under the editable-first contract. The editable native replacement remains allowed to normalize unmodeled no-fill/alpha/line/marker details and reports the route-level loss risk. Chart title/legend/axis titles and supported data-label flags are retained when the current schema can represent them. Fallback-only objects keep rendered SVG content or a baked chart preview and carry `data-pptx-native-status`, which validation and `--native-objects` export report as a warning. A supported active marker without a renderer, such as current `of_pie`, keeps `data-pptx-visual-status="placeholder"` plus `data-pptx-route-status="reconstruction-only"`; default export keeps the placeholder and native opt-in may still reconstruct it.
Active imported table/chart markers carry `data-pptx-fallback-sha256`. Visible fallback edits, reachable SVG fragment-definition changes, marker-local reference-target changes, and marker transforms make the baseline stale: the mandatory quality checker warns, default export remains available, and `--native-objects` fails instead of discarding the SVG edit. Legacy markers without a baseline remain convertible with a checker/native-route warning. ChartEx export now writes valid payload palette entries into its color-style part; it still does not promise full source ChartEx styling.
diff --git a/skills/ppt-master/scripts/docs/conversion.md b/skills/ppt-master/scripts/docs/conversion.md
index 24043f85..7aa1162f 100644
--- a/skills/ppt-master/scripts/docs/conversion.md
+++ b/skills/ppt-master/scripts/docs/conversion.md
@@ -246,8 +246,12 @@ python3 scripts/pptx_to_svg.py deck.pptx --inheritance-mode flat
| `layered` | Only the layered `svg/` view and inheritance metadata |
| `flat` | One self-contained slide SVG per page under `svg/` |
-Supported unmerged tables and conservative classic-chart caches carry
-`data-pptx-native` metadata beside their SVG fallback. Markers remain dormant
+Supported text-grid tables and conservative classic-chart caches carry
+`data-pptx-native` metadata beside their SVG fallback. Table import accepts
+unmerged grids plus canonical rectangular merges, safe solid/no-fill per-side
+borders, and plain multi-paragraph cells. Noncanonical/overlapping merges,
+nonblank merge slaves, unsafe border XML, non-solid fills, and mixed run-level
+rich text remain fallback-only. Markers remain dormant
unless a later export uses `--native-objects`. That opt-in is editable-first:
it may normalize styling or omit marker-local details not represented by the
payload, and export reports that risk without disabling an otherwise supported
@@ -289,8 +293,21 @@ checker/native route that stale detection is unavailable.
For table style `{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}`, the importer resolves
the normalized `wholeTbl`, `firstRow`, `band1H`/`band2H`, theme color/font, and
direct-format override subset. Other built-in/custom style families remain
-outside this guarantee. ChartEx native output consumes valid payload colors in
-its color-style part; other ChartEx style details remain normalized.
+outside this guarantee.
+
+The chart importer also accepts the verified column/line/area combo subset,
+canonical four-series OHLC stock charts with shared numeric date caches, and
+area charts with numeric date axes. Combo primary/secondary plots may retain
+independent category caches and workbook ranges. Axis read-back is limited to
+the closed category/value roles and the supported kind/position/visibility,
+label-position, number-format, min/max/major-unit, reverse, and major-gridline
+fields. This is not a full `AxisSpec`: ChartEx import, arbitrary stock variants,
+other date-axis chart families, and unlisted axis semantics remain fallback-only.
+Safe stock series style may pass the structural gate, while stock series,
+`hiLowLines`, and up-down bar local styling can still normalize under the
+editable-first contract.
+ChartEx native **output** still consumes valid payload colors in its color-style
+part; other ChartEx style details remain normalized.
Exporter-canonical charts recover canonical solid series/slice colors and exact
one- or two-paragraph title styling; two paragraphs retain their `title` /
diff --git a/skills/ppt-master/templates/charts/README.md b/skills/ppt-master/templates/charts/README.md
index 1a1f7456..1bdf546e 100644
--- a/skills/ppt-master/templates/charts/README.md
+++ b/skills/ppt-master/templates/charts/README.md
@@ -29,7 +29,7 @@ Native marker authoring remains active for all 23 currently supported data-chart
| Specialty business charts | `waterfall_chart`, `funnel_chart`, `stock_chart`, `radar_chart` | ChartEx or classic specialty charts |
| Text-grid tables | `basic_table`, `financial_statement_table` | Native DrawingML tables |
-Markers must include explicit `name`, `x`, `y`, `width`, and `height` fields so the editable frame aligns with the fallback drawing. Keep legends, explanatory cards, source notes, center KPIs, and custom callouts outside the marker when they must remain as separate editable shapes; otherwise accept and review the native-export warning. Tables with merged, spanning, or graphical cells (harvey balls, rating dots, avatars) stay unmarked on the SVG fallback route.
+Markers must include explicit `name`, `x`, `y`, `width`, and `height` fields so the editable frame aligns with the fallback drawing. Keep legends, explanatory cards, source notes, center KPIs, and custom callouts outside the marker when they must remain as separate editable shapes; otherwise accept and review the native-export warning. Canonical rectangular merged text cells may use anchor-only `row_span` / `col_span` metadata with blank covered cells; nonrectangular merges and graphical cells (harvey balls, rating dots, avatars) stay unmarked on the SVG fallback route. Per-side borders and plain multi-paragraph cells use the closed contracts in [`shared-standards.md`](../../references/shared-standards.md#native-pptx-table--chart-markers-opt-in); run-level table rich text remains outside native marker support.
## Usage