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

refactor(svg_to_pptx): group drawingml and package modules into subpackages

hugohe35511ab62b9ff
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index de05231f..39fcfbe3 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -222,7 +222,7 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre
| Tech / developer | `Arial, "Microsoft YaHei", sans-serif` | same | `Consolas, "Courier New", monospace` |
| Concord (single family — pick the family by subject + `visual_style`) | `<family by subject>, …, sans-serif / serif` | same | — |
-> **Stack length discipline (soft rule).** ≤4 fonts per stack. The exported CJK / Latin typefaces MUST be pre-installed after converter resolution ([`drawingml_utils.py parse_font_family`](../scripts/svg_to_pptx/drawingml_utils.py)). Choose those exported faces from the safe set **by the locked style's character**: `Microsoft YaHei` / `Arial` are the *neutral* members — perfect as the tail fallback and as the lead only when the style is plain-sans, but **not the automatic lead for every deck**. For a styled title, lead with `SimHei` / `KaiTi` / `FangSong` / `SimSun` / `Georgia` / `Cambria` / `Impact` / `Consolas` as the character asks. Keep at most **one** macOS-exclusive family (typically `"PingFang SC"`); macOS→Windows fallback is auto-mapped via `FONT_FALLBACK_WIN`.
+> **Stack length discipline (soft rule).** ≤4 fonts per stack. The exported CJK / Latin typefaces MUST be pre-installed after converter resolution ([`drawingml/utils.py parse_font_family`](../scripts/svg_to_pptx/drawingml/utils.py)). Choose those exported faces from the safe set **by the locked style's character**: `Microsoft YaHei` / `Arial` are the *neutral* members — perfect as the tail fallback and as the lead only when the style is plain-sans, but **not the automatic lead for every deck**. For a styled title, lead with `SimHei` / `KaiTi` / `FangSong` / `SimSun` / `Georgia` / `Cambria` / `Impact` / `Consolas` as the character asks. Keep at most **one** macOS-exclusive family (typically `"PingFang SC"`); macOS→Windows fallback is auto-mapped via `FONT_FALLBACK_WIN`.
> **Non-pre-installed directions** (require install or PPTX embed; note the constraint in Design Spec):
> - **Retro / pixel** — Press Start 2P / VT323 / Silkscreen
diff --git a/skills/ppt-master/scripts/native_narration_pptx.py b/skills/ppt-master/scripts/native_narration_pptx.py
index 047030e6..691397eb 100644
--- a/skills/ppt-master/scripts/native_narration_pptx.py
+++ b/skills/ppt-master/scripts/native_narration_pptx.py
@@ -43,12 +43,12 @@ if str(_SCRIPTS_DIR) not in sys.path:
from console_encoding import configure_utf8_stdio # noqa: E402
from pptx_animations import TRANSITIONS, create_transition_xml # noqa: E402
-from svg_to_pptx.pptx_builder import ( # noqa: E402
+from svg_to_pptx.pptx_package.builder import ( # noqa: E402
_add_default_content_type,
_append_relationship,
_ensure_notes_master,
)
-from svg_to_pptx.pptx_narration import ( # noqa: E402
+from svg_to_pptx.pptx_package.narration import ( # noqa: E402
AUDIO_CONTENT_TYPES,
AUDIO_MARKER_PNG_BYTES,
AUDIO_REL_TYPE,
@@ -60,7 +60,7 @@ from svg_to_pptx.pptx_narration import ( # noqa: E402
next_shape_id,
probe_audio_duration,
)
-from svg_to_pptx.pptx_notes import ( # noqa: E402
+from svg_to_pptx.pptx_package.notes import ( # noqa: E402
create_notes_slide_rels_xml,
create_notes_slide_xml,
markdown_to_plain_text,
diff --git a/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py
index efc2855f..ce3635c9 100644
--- a/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py
+++ b/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py
@@ -1,6 +1,6 @@
"""DrawingML <a:custGeom> -> SVG <path d="..."> conversion.
-Reverse of svg_to_pptx/drawingml_paths.path_commands_to_drawingml.
+Reverse of svg_to_pptx/drawingml/paths.py path_commands_to_drawingml.
Path command mapping:
<a:moveTo> -> M
diff --git a/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py
index 79c7ac50..2749db6b 100644
--- a/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py
+++ b/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py
@@ -1,6 +1,6 @@
"""DrawingML <a:effectLst> -> SVG <filter> conversion.
-Reverse of svg_to_pptx/drawingml_styles.build_effect_xml.
+Reverse of svg_to_pptx/drawingml/styles.py build_effect_xml.
Covers the most common DrawingML effects:
- <a:outerShdw> -> feDropShadow (or feGaussianBlur+feOffset+feFlood)
diff --git a/skills/ppt-master/scripts/pptx_to_svg/emu_units.py b/skills/ppt-master/scripts/pptx_to_svg/emu_units.py
index 155a2060..dd146181 100644
--- a/skills/ppt-master/scripts/pptx_to_svg/emu_units.py
+++ b/skills/ppt-master/scripts/pptx_to_svg/emu_units.py
@@ -1,6 +1,6 @@
"""EMU <-> pixel conversion and DrawingML unit constants.
-Mirrors svg_to_pptx/drawingml_utils.py and pptx_dimensions.py, in reverse.
+Mirrors svg_to_pptx/drawingml/utils.py and pptx_package/dimensions.py, in reverse.
DrawingML unit conventions:
- Coordinates / sizes: EMU (English Metric Unit). 914400 EMU = 1 inch = 96 px.
diff --git a/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py
index e570f6b5..a0b740bc 100644
--- a/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py
+++ b/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py
@@ -1,6 +1,6 @@
"""DrawingML <a:ln> -> SVG stroke conversion.
-Reverse of svg_to_pptx/drawingml_styles.build_stroke_xml.
+Reverse of svg_to_pptx/drawingml/styles.py build_stroke_xml.
Produces an SVG attribute dict with stroke / stroke-width / stroke-opacity /
stroke-dasharray / stroke-linecap / stroke-linejoin / marker-start /
diff --git a/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py
index 642409ab..511b2466 100644
--- a/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py
+++ b/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py
@@ -1,6 +1,6 @@
"""DrawingML <p:txBody> -> SVG <text> conversion.
-Reverse of svg_to_pptx/drawingml_elements.convert_text.
+Reverse of svg_to_pptx/drawingml/elements.py convert_text.
Strategy (v1):
- Each <a:p> paragraph emits one <text> element (one line of baseline).
@@ -803,7 +803,7 @@ def _is_cjk(ch: str) -> bool:
def _char_width(ch: str, font_size: float, bold: bool) -> float:
"""Estimate a single character's rendered width in pixels.
- Mirrors svg_to_pptx/drawingml_utils.estimate_text_width so wrapping breaks
+ Mirrors svg_to_pptx/drawingml/utils.py estimate_text_width so wrapping breaks
align with the same heuristic used to estimate text-box sizes elsewhere.
"""
if _is_cjk(ch):
diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.py
index 6fd5ba0b..74196dd2 100644
--- a/skills/ppt-master/scripts/svg_quality_checker.py
+++ b/skills/ppt-master/scripts/svg_quality_checker.py
@@ -46,7 +46,7 @@ except ImportError:
_validate_animation_config = None
try:
- from svg_to_pptx.drawingml_utils import (
+ from svg_to_pptx.drawingml.utils import (
parse_font_family as _parse_export_font_family,
)
except ImportError:
@@ -102,7 +102,7 @@ XLINK_NS = "http://www.w3.org/1999/xlink"
# Fonts that survive direct PPTX typeface assignment on a typical Windows /
# macOS viewer without requiring a custom install. Keep this aligned with
-# strategist.md §g and drawingml_utils.FONT_FALLBACK_WIN.
+# strategist.md §g and drawingml/utils.py FONT_FALLBACK_WIN.
PPT_SAFE_FONTS = {
'microsoft yahei', 'simhei', 'simsun', 'kaiti', 'fangsong',
'dengxian', 'microsoft jhenghei',
diff --git a/skills/ppt-master/scripts/svg_to_pptx/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/__init__.py
index 4cc803bf..5ae582f0 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/__init__.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/__init__.py
@@ -6,9 +6,9 @@ Public API:
- create_pptx_with_native_svg(): Build PPTX from SVG files
"""
-from .pptx_cli import main
-from .drawingml_converter import convert_svg_to_slide_shapes
-from .pptx_builder import create_pptx_with_native_svg
+from .pptx_package.cli import main
+from .drawingml.converter import convert_svg_to_slide_shapes
+from .pptx_package.builder import create_pptx_with_native_svg
__all__ = [
'main',
diff --git a/skills/ppt-master/scripts/svg_to_pptx/animation_config.py b/skills/ppt-master/scripts/svg_to_pptx/animation_config.py
index a3cdbe42..ebb6af78 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/animation_config.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/animation_config.py
@@ -9,7 +9,7 @@ from pathlib import Path
from typing import Any
from xml.etree import ElementTree as ET
-from .drawingml_utils import SVG_NS
+from .drawingml.utils import SVG_NS
try:
from pptx_animations import ANIMATIONS, TRANSITIONS
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/__init__.py
new file mode 100644
index 00000000..a892d4d5
--- /dev/null
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/__init__.py
@@ -0,0 +1 @@
+"""DrawingML conversion helpers for SVG-to-PPTX export."""
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_context.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/context.py
similarity index 100%
rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_context.py
rename to skills/ppt-master/scripts/svg_to_pptx/drawingml/context.py
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_converter.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/converter.py
similarity index 98%
rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_converter.py
rename to skills/ppt-master/scripts/svg_to_pptx/drawingml/converter.py
index 045cde9f..e80da566 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_converter.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/converter.py
@@ -10,20 +10,20 @@ from xml.etree import ElementTree as ET
from resource_paths import icon_search_dirs_for_svg
-from .drawingml_context import ConvertContext, ShapeResult
-from .drawingml_utils import (
+from .context import ConvertContext, ShapeResult
+from .utils import (
SVG_NS, EMU_PER_PX,
_extract_inheritable_styles, parse_transform_matrix, resolve_url_id,
parse_svg_length,
)
-from .drawingml_styles import build_effect_xml
-from .drawingml_elements import (
+from .styles import build_effect_xml
+from .elements import (
convert_rect, convert_circle, convert_ellipse,
convert_line, convert_path,
convert_polygon, convert_polyline,
convert_text, convert_image, convert_nested_svg,
)
-from .native_objects import convert_native_object
+from ..native_objects import convert_native_object
class SvgNativeConversionError(RuntimeError):
@@ -515,7 +515,7 @@ def convert_svg_to_slide_shapes(
# running this here makes the two pipelines behaviourally aligned.
icons_dir, icons_fallback_dir = icon_search_dirs_for_svg(svg_path)
if icons_dir.exists():
- from .use_expander import expand_use_data_icons
+ from ..use_expander import expand_use_data_icons
expanded = expand_use_data_icons(root, icons_dir, icons_fallback_dir)
if expanded:
trace_steps.append({'action': 'expand-use-data-icons', 'count': expanded})
@@ -530,7 +530,7 @@ def convert_svg_to_slide_shapes(
# correct when reading raw svg_output/.
# merge_paragraphs additionally folds mergeable paragraph blocks into a
# single annotated <text> for downstream multi-<a:p> conversion.
- from .tspan_flattener import flatten_positional_tspans
+ from ..tspan_flattener import flatten_positional_tspans
flattened = flatten_positional_tspans(tree, merge_paragraphs=merge_paragraphs)
if flattened:
trace_steps.append({
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/elements.py
similarity index 99%
rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.py
rename to skills/ppt-master/scripts/svg_to_pptx/drawingml/elements.py
index ef9013d7..9d0d03f9 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/elements.py
@@ -13,8 +13,8 @@ from xml.etree import ElementTree as ET
from resource_paths import resolve_external_image_reference
-from .drawingml_context import ConvertContext, ShapeResult
-from .drawingml_utils import (
+from .context import ConvertContext, ShapeResult
+from .utils import (
SVG_NS, XLINK_NS, ANGLE_UNIT, FONT_PX_TO_HUNDREDTHS_PT, DASH_PRESETS,
px_to_emu, _f, _get_attr, parse_svg_length,
svg_length_x, svg_length_y, svg_length_size,
@@ -25,12 +25,12 @@ from .drawingml_utils import (
detect_text_lang, resolve_text_run_fonts,
matrix_multiply, parse_transform_matrix, transform_point, _xml_escape,
)
-from .drawingml_styles import (
+from .styles import (
build_solid_fill, build_gradient_fill,
build_fill_xml, build_stroke_xml, build_effect_xml, classify_filter_effect,
get_fill_opacity, get_stroke_opacity,
)
-from .drawingml_paths import (
+from .paths import (
PathCommand, parse_svg_path, svg_path_to_absolute,
normalize_path_commands, path_commands_to_drawingml,
)
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_paths.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/paths.py
similarity index 99%
rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_paths.py
rename to skills/ppt-master/scripts/svg_to_pptx/drawingml/paths.py
index ec2d1036..04b115e3 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_paths.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/paths.py
@@ -6,7 +6,7 @@ import math
import re
from dataclasses import dataclass, field
-from .drawingml_utils import px_to_emu
+from .utils import px_to_emu
@dataclass
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_styles.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/styles.py
similarity index 99%
rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_styles.py
rename to skills/ppt-master/scripts/svg_to_pptx/drawingml/styles.py
index 7d34f2fb..f6280c36 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_styles.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/styles.py
@@ -6,8 +6,8 @@ import math
import re
from xml.etree import ElementTree as ET
-from .drawingml_context import ConvertContext
-from .drawingml_utils import (
+from .context import ConvertContext
+from .utils import (
SVG_NS, ANGLE_UNIT, DASH_PRESETS,
px_to_emu, _f, _get_attr, parse_svg_length,
parse_hex_color, parse_stop_style, resolve_url_id,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py
similarity index 99%
rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py
rename to skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py
index 213b8f6e..9065a2d1 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py
@@ -6,7 +6,7 @@ import re
import math
from xml.etree import ElementTree as ET
-from .drawingml_context import AffineMatrix, ConvertContext, IDENTITY_MATRIX
+from .context import AffineMatrix, ConvertContext, IDENTITY_MATRIX
# ---------------------------------------------------------------------------
# Constants
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py
index d24a1fd2..fc0a37c8 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py
@@ -5,8 +5,8 @@ from __future__ import annotations
from typing import Any
from xml.etree import ElementTree as ET
-from ..drawingml_context import ConvertContext, ShapeResult
-from ..drawingml_utils import _xml_escape
+from ..drawingml.context import ConvertContext, ShapeResult
+from ..drawingml.utils import _xml_escape
from .chart_data import _chart_data
from .chart_style import (
_axis_titles,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py
index 0b08a0a5..5cf85e9d 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py
@@ -5,8 +5,8 @@ from __future__ import annotations
from typing import Any
from xml.etree import ElementTree as ET
-from ..drawingml_context import ConvertContext
-from ..drawingml_utils import detect_text_lang, _xml_escape
+from ..drawingml.context import ConvertContext
+from ..drawingml.utils import detect_text_lang, _xml_escape
from .chart_data import _DEFAULT_CHART_COLORS
from .marker_common import (
_bool_attr,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py
index 4e907033..b11cf7b9 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py
@@ -5,7 +5,7 @@ from __future__ import annotations
from typing import Any
from xml.etree import ElementTree as ET
-from ..drawingml_utils import detect_text_lang, px_to_emu, _xml_escape
+from ..drawingml.utils import detect_text_lang, px_to_emu, _xml_escape
from .chart_data import _chart_list, _data_labels_config
from .chart_style import (
_alpha_xml,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py
index 61d081e4..09234c88 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py
@@ -4,7 +4,7 @@ from __future__ import annotations
from typing import Any
-from ..drawingml_utils import _xml_escape
+from ..drawingml.utils import _xml_escape
from .marker_common import (
CHARTEX_URI,
CHART_COLOR_STYLE_REL_TYPE,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py
index 05bd2baf..ca2f9658 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py
@@ -7,8 +7,8 @@ import re
from typing import Any
from xml.etree import ElementTree as ET
-from ..drawingml_context import ConvertContext, IDENTITY_MATRIX
-from ..drawingml_utils import (
+from ..drawingml.context import ConvertContext, IDENTITY_MATRIX
+from ..drawingml.utils import (
FONT_PX_TO_HUNDREDTHS_PT,
ctx_h,
ctx_w,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py
index 01e7584c..d71c11aa 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py
@@ -6,8 +6,8 @@ import re
from typing import Any
from xml.etree import ElementTree as ET
-from ..drawingml_context import ConvertContext, ShapeResult
-from ..drawingml_utils import px_to_emu, _xml_escape
+from ..drawingml.context import ConvertContext, ShapeResult
+from ..drawingml.utils import px_to_emu, _xml_escape
from .chart_style import _font_face_xml
from .marker_common import (
TABLE_URI,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py
index c2c2abb0..d0af5206 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py
@@ -11,7 +11,7 @@ try:
except ImportError: # pragma: no cover - optional compatibility enhancement
Workbook = None
-from ..drawingml_utils import _xml_escape
+from ..drawingml.utils import _xml_escape
from .marker_common import _excel_col
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/__init__.py
new file mode 100644
index 00000000..b677487d
--- /dev/null
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/__init__.py
@@ -0,0 +1 @@
+"""PPTX package assembly helpers for SVG-to-PPTX export."""
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py
similarity index 99%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py
index 68b90130..759a288a 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py
@@ -23,24 +23,24 @@ from xml.sax.saxutils import escape
from pptx import Presentation
from pptx.util import Emu
-from .drawingml_converter import convert_svg_to_slide_shapes
-from .pptx_dimensions import (
+from ..drawingml.converter import convert_svg_to_slide_shapes
+from .dimensions import (
CANVAS_FORMATS,
get_slide_dimensions, get_pixel_dimensions,
get_viewbox_dimensions, detect_format_from_svg,
)
-from .pptx_media import (
+from .media import (
PNG_RENDERER,
get_png_renderer_info, convert_svg_to_png, convert_svg_to_png_cached,
)
-from .pptx_notes import (
+from .notes import (
markdown_to_plain_text,
create_notes_master_rels_xml,
create_notes_master_xml,
create_notes_slide_xml,
create_notes_slide_rels_xml,
)
-from .pptx_narration import (
+from .narration import (
AUDIO_CONTENT_TYPES,
AUDIO_REL_TYPE,
AUDIO_MARKER_PNG_BYTES,
@@ -51,7 +51,7 @@ from .pptx_narration import (
next_shape_id,
probe_audio_duration,
)
-from .pptx_slide_xml import (
+from .slide_xml import (
ANIMATIONS_AVAILABLE, TRANSITIONS,
create_slide_xml_with_svg, create_slide_rels_xml,
)
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
similarity index 98%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
index 25fbd7a3..ef4d3a7e 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
@@ -25,12 +25,12 @@ if __package__ in {None, ''}:
sys.modules.setdefault('svg_to_pptx', package)
__package__ = 'svg_to_pptx'
-from .pptx_dimensions import CANVAS_FORMATS, get_project_info, get_viewbox_dimensions
-from .pptx_discovery import find_svg_files, find_notes_files
-from .pptx_builder import create_pptx_with_native_svg
-from .pptx_narration import NARRATION_EXTENSIONS, find_narration_files, probe_audio_duration
-from .pptx_slide_xml import TRANSITIONS
-from .animation_config import load_animation_config, validate_animation_config
+from .dimensions import CANVAS_FORMATS, get_project_info, get_viewbox_dimensions
+from .discovery import find_svg_files, find_notes_files
+from .builder import create_pptx_with_native_svg
+from .narration import NARRATION_EXTENSIONS, find_narration_files, probe_audio_duration
+from .slide_xml import TRANSITIONS
+from ..animation_config import load_animation_config, validate_animation_config
try:
from pptx_animations import ANIMATIONS as _ANIMATIONS
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_dimensions.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/dimensions.py
similarity index 100%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_dimensions.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/dimensions.py
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_discovery.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/discovery.py
similarity index 100%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_discovery.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/discovery.py
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_media.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/media.py
similarity index 100%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_media.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/media.py
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_narration.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/narration.py
similarity index 100%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_narration.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/narration.py
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_notes.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/notes.py
similarity index 99%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_notes.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/notes.py
index 5d04e073..4533e3ee 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_notes.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/notes.py
@@ -4,7 +4,7 @@ from __future__ import annotations
import re
-from .drawingml_utils import detect_text_lang
+from ..drawingml.utils import detect_text_lang
def markdown_to_plain_text(md_content: str) -> str:
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_slide_xml.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/slide_xml.py
similarity index 100%
rename from skills/ppt-master/scripts/svg_to_pptx/pptx_slide_xml.py
rename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/slide_xml.py
diff --git a/skills/ppt-master/scripts/template_fill_pptx/notes.py b/skills/ppt-master/scripts/template_fill_pptx/notes.py
index d34cadba..80705407 100644
--- a/skills/ppt-master/scripts/template_fill_pptx/notes.py
+++ b/skills/ppt-master/scripts/template_fill_pptx/notes.py
@@ -10,7 +10,7 @@ from __future__ import annotations
import posixpath
from xml.etree import ElementTree as ET
-from svg_to_pptx.pptx_notes import create_notes_slide_xml, markdown_to_plain_text
+from svg_to_pptx.pptx_package.notes import create_notes_slide_xml, markdown_to_plain_text
from .ooxml import NOTES_SLIDE_REL_TYPE, REL_NS, SLIDE_REL_TYPE, _qn, _xml_bytes
from .package import _empty_relationships_root, _max_numeric_rid
diff --git a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md
index 1d175140..4ff534f9 100644
--- a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md
+++ b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md
@@ -162,7 +162,7 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr
- `<feComponentTransfer>` + `<feFuncA slope=...>` → 用 `<feFlood flood-color flood-opacity>` 替代
- `flood-opacity > 0.20` → 阴影过重,最大 0.15-0.20
-> **被禁的是 sub-element,不是 `<filter>` 本身。** `<filter>` 是 PPT Master 允许的、官方推荐的阴影/发光路径(见 [`shared-standards.md`](../../references/shared-standards.md) §1 黑名单不含 filter、§6 把 filter shadow 列为 drop-shadow 的官方实现),转换器 [`svg_to_pptx/drawingml_styles.py`](../../scripts/svg_to_pptx/drawingml_styles.py) 也主动把 `feGaussianBlur` + `feOffset` + `feFlood` + `feComposite` + `feMerge`(以及 `feDropShadow` 简写)映射成 DrawingML `<a:outerShdw>`。
+> **被禁的是 sub-element,不是 `<filter>` 本身。** `<filter>` 是 PPT Master 允许的、官方推荐的阴影/发光路径(见 [`shared-standards.md`](../../references/shared-standards.md) §1 黑名单不含 filter、§6 把 filter shadow 列为 drop-shadow 的官方实现),转换器 [`svg_to_pptx/drawingml/styles.py`](../../scripts/svg_to_pptx/drawingml/styles.py) 也主动把 `feGaussianBlur` + `feOffset` + `feFlood` + `feComposite` + `feMerge`(以及 `feDropShadow` 简写)映射成 DrawingML `<a:outerShdw>`。
>
> 单独禁 `feComponentTransfer/feFuncA(slope)` 的原因:**它物理上只能调透明度、无法携带颜色**。转换器读到 `feFuncA slope` 时只把它当作 alpha,颜色字段保持默认 `'000000'`——SVG 端看起来阴影颜色正常(因为 SourceAlpha 本身是黑),但导出到 PPTX 后阴影颜色会被定死成纯黑 `#000000`,与同页其他用 `feFlood flood-color="#0F172A"` 的卡片产生肉眼可见的冷暖色差。
>
diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.md
index 673c5b9a..86c8067a 100644
--- a/skills/ppt-master/templates/design_spec_reference.md
+++ b/skills/ppt-master/templates/design_spec_reference.md
@@ -124,7 +124,7 @@ Two views on the same font decisions — fill both, keep them consistent:
> - `Georgia, "Microsoft YaHei", serif` → Latin in Georgia (elegant serif), CJK falls through to Microsoft YaHei. **Use when Latin typography is the primary design statement** (academic / editorial / Latin-heavy covers).
> - `"Microsoft YaHei", Georgia, serif` → Everything in Microsoft YaHei (Latin uses YaHei's Latin glyphs — a different design tone). **Use when the deck is CJK-primary and Latin is incidental**.
>
-> The converter (`drawingml_utils.py parse_font_family`) maps these to PPTX `<a:latin>` / `<a:ea>` regardless of order — but browser preview and SVG native rendering reflect stack order. Pick the order matching your design intent.
+> The converter (`drawingml/utils.py parse_font_family`) maps these to PPTX `<a:latin>` / `<a:ea>` regardless of order — but browser preview and SVG native rendering reflect stack order. Pick the order matching your design intent.
> **Why two views**: the breakdown shows role assignment at a glance; stacks carry the ordering info the breakdown can't encode. Keep both consistent — table cells should be exactly the fonts in the stacks (any order).
diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.md
index e1e5a7cd..e282ab40 100644
--- a/skills/ppt-master/templates/spec_lock_reference.md
+++ b/skills/ppt-master/templates/spec_lock_reference.md
@@ -75,7 +75,7 @@
>
> **⚠️ PPT-safe stack discipline (HARD rule).** PPTX stores concrete exported Latin / EA typefaces per run with no runtime fallback. Every stack's exported Latin / EA typefaces MUST resolve to cross-platform pre-installed fonts: `"Microsoft YaHei"` / `SimSun` / `Arial` / `"Times New Roman"` / `Consolas`. Stacks that export non-preinstalled typefaces (Inter / Google Fonts / brand typefaces) may be used only when the Design Spec notes the font-install or embedding requirement.
>
-> **Stack length discipline.** 3-4 fonts per stack is the sweet spot. Converter only writes the **first** Latin and **first** CJK font into PPTX — everything after is silently dropped. macOS-only families (`Songti SC`, `Menlo`, `Monaco`, `Helvetica`) are auto-mapped to Windows equivalents via `FONT_FALLBACK_WIN` (see `scripts/svg_to_pptx/drawingml_utils.py`); stacking both is redundant. Lead with Windows-preinstalled fonts (`Microsoft YaHei` / `SimSun` / `Arial` / `Georgia` / `Consolas`); keep at most **one** macOS-exclusive family (typically `"PingFang SC"`) as a browser-preview nicety.
+> **Stack length discipline.** 3-4 fonts per stack is the sweet spot. Converter only writes the **first** Latin and **first** CJK font into PPTX — everything after is silently dropped. macOS-only families (`Songti SC`, `Menlo`, `Monaco`, `Helvetica`) are auto-mapped to Windows equivalents via `FONT_FALLBACK_WIN` (see `scripts/svg_to_pptx/drawingml/utils.py`); stacking both is redundant. Lead with Windows-preinstalled fonts (`Microsoft YaHei` / `SimSun` / `Arial` / `Georgia` / `Consolas`); keep at most **one** macOS-exclusive family (typically `"PingFang SC"`) as a browser-preview nicety.
## icons
- library: chunk-filled