codewave-openclaw-installer 1.0.1 → 2.1.0

package/skills/ppt-master/scripts/svg_to_pptx/pptx_dimensions.py

@@ -0,0 +1,148 @@
+"""Slide dimensions, format detection, EMU conversion, and constants."""
+
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+from xml.etree import ElementTree as ET
+
+# Import project utility modules
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+try:
+    from project_utils import get_project_info
+    from config import CANVAS_FORMATS
+except ImportError:
+    CANVAS_FORMATS = {
+        'ppt169': {'name': 'PPT 16:9', 'dimensions': '1280×720', 'viewbox': '0 0 1280 720'},
+    }
+
+    def get_project_info(path: str) -> dict:
+        return {'format': 'unknown', 'name': Path(path).name}
+
+# EMU conversion constants
+EMU_PER_INCH = 914400
+EMU_PER_PIXEL = EMU_PER_INCH / 96
+
+# XML namespaces
+NAMESPACES = {
+    'a': 'http://schemas.openxmlformats.org/drawingml/2006/main',
+    'r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
+    'p': 'http://schemas.openxmlformats.org/presentationml/2006/main',
+    'asvg': 'http://schemas.microsoft.com/office/drawing/2016/SVG/main',
+}
+
+# Register namespaces for ElementTree output
+for prefix, uri in NAMESPACES.items():
+    ET.register_namespace(prefix, uri)
+
+
+def get_slide_dimensions(
+    canvas_format: str,
+    custom_pixels: tuple[int, int] | None = None,
+) -> tuple[int, int]:
+    """Get slide dimensions in EMU units.
+
+    Args:
+        canvas_format: Canvas format key (e.g. 'ppt169').
+        custom_pixels: Optional custom pixel dimensions override.
+
+    Returns:
+        (width_emu, height_emu) tuple.
+    """
+    if custom_pixels:
+        width_px, height_px = custom_pixels
+    else:
+        if canvas_format not in CANVAS_FORMATS:
+            canvas_format = 'ppt169'
+
+        dimensions = CANVAS_FORMATS[canvas_format]['dimensions']
+        match = re.match(r'(\d+)[×x](\d+)', dimensions)
+        if match:
+            width_px = int(match.group(1))
+            height_px = int(match.group(2))
+        else:
+            width_px, height_px = 1280, 720
+
+    return int(width_px * EMU_PER_PIXEL), int(height_px * EMU_PER_PIXEL)
+
+
+def get_pixel_dimensions(
+    canvas_format: str,
+    custom_pixels: tuple[int, int] | None = None,
+) -> tuple[int, int]:
+    """Get canvas pixel dimensions.
+
+    Args:
+        canvas_format: Canvas format key.
+        custom_pixels: Optional custom pixel dimensions override.
+
+    Returns:
+        (width_px, height_px) tuple.
+    """
+    if custom_pixels:
+        return custom_pixels
+
+    if canvas_format not in CANVAS_FORMATS:
+        canvas_format = 'ppt169'
+
+    dimensions = CANVAS_FORMATS[canvas_format]['dimensions']
+    match = re.match(r'(\d+)[×x](\d+)', dimensions)
+    if match:
+        return int(match.group(1)), int(match.group(2))
+    return 1280, 720
+
+
+def get_viewbox_dimensions(svg_path: Path) -> tuple[int, int] | None:
+    """Extract pixel dimensions from SVG viewBox.
+
+    Args:
+        svg_path: Path to the SVG file.
+
+    Returns:
+        (width, height) as integers, or None if not found.
+    """
+    try:
+        with open(svg_path, 'r', encoding='utf-8') as f:
+            content = f.read(2000)
+
+        match = re.search(r'viewBox="([^"]+)"', content)
+        if not match:
+            return None
+
+        parts = re.split(r'[\s,]+', match.group(1).strip())
+        if len(parts) < 4:
+            return None
+
+        width = float(parts[2])
+        height = float(parts[3])
+        if width <= 0 or height <= 0:
+            return None
+
+        return int(round(width)), int(round(height))
+    except Exception:
+        return None
+
+
+def detect_format_from_svg(svg_path: Path) -> str | None:
+    """Detect canvas format from an SVG file's viewBox.
+
+    Args:
+        svg_path: Path to the SVG file.
+
+    Returns:
+        Canvas format key (e.g. 'ppt169'), or None if not detected.
+    """
+    try:
+        with open(svg_path, 'r', encoding='utf-8') as f:
+            content = f.read(2000)
+
+        match = re.search(r'viewBox="([^"]+)"', content)
+        if match:
+            viewbox = match.group(1)
+            for fmt_key, fmt_info in CANVAS_FORMATS.items():
+                if fmt_info['viewbox'] == viewbox:
+                    return fmt_key
+    except Exception:
+        pass
+    return None

package/skills/ppt-master/scripts/svg_to_pptx/pptx_discovery.py

@@ -0,0 +1,101 @@
+"""Find SVG and notes files in a project directory."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+
+def find_svg_files(
+    project_path: Path,
+    source: str = 'output',
+) -> tuple[list[Path], str]:
+    """Find SVG files in the project.
+
+    Args:
+        project_path: Project directory path.
+        source: SVG source directory alias or name.
+            - 'output': svg_output (original version)
+            - 'final': svg_final (post-processed, recommended)
+            - or any subdirectory name
+
+    Returns:
+        (list_of_svg_files, actual_directory_name) tuple.
+    """
+    dir_map = {
+        'output': 'svg_output',
+        'final': 'svg_final',
+    }
+
+    dir_name = dir_map.get(source, source)
+    svg_dir = project_path / dir_name
+
+    if not svg_dir.exists():
+        print(f"  Warning: {dir_name} directory does not exist, trying svg_output")
+        dir_name = 'svg_output'
+        svg_dir = project_path / dir_name
+
+    if not svg_dir.exists():
+        if project_path.is_dir():
+            svg_dir = project_path
+            dir_name = project_path.name
+        else:
+            return [], ''
+
+    return sorted(svg_dir.glob('*.svg')), dir_name
+
+
+def find_notes_files(
+    project_path: Path,
+    svg_files: list[Path] | None = None,
+) -> dict[str, str]:
+    """Find notes files and map them to SVG files.
+
+    Supports two matching modes (mixed matching supported):
+    1. Match by filename (priority): notes/01_cover.md -> 01_cover.svg
+    2. Match by index (backward compatible): notes/slide01.md -> 1st SVG
+
+    Args:
+        project_path: Project directory path.
+        svg_files: SVG file list (for filename matching).
+
+    Returns:
+        Dict mapping SVG filename stem to notes content.
+    """
+    notes_dir = project_path / 'notes'
+    notes: dict[str, str] = {}
+
+    if not notes_dir.exists():
+        return notes
+
+    svg_stems_mapping: dict[str, int] = {}
+    svg_index_mapping: dict[int, str] = {}
+    if svg_files:
+        for i, svg_path in enumerate(svg_files, 1):
+            svg_stems_mapping[svg_path.stem] = i
+            svg_index_mapping[i] = svg_path.stem
+
+    for notes_file in notes_dir.glob('*.md'):
+        try:
+            with open(notes_file, 'r', encoding='utf-8') as f:
+                content = f.read().strip()
+            if not content:
+                continue
+
+            stem = notes_file.stem
+
+            # Try index-based matching (backward compat with slide01.md format)
+            match = re.search(r'slide[_]?(\d+)', stem)
+            if match:
+                index = int(match.group(1))
+                mapped_stem = svg_index_mapping.get(index)
+                if mapped_stem:
+                    notes[mapped_stem] = content
+
+            # Filename-based matching (overrides index-based)
+            if stem in svg_stems_mapping:
+                notes[stem] = content
+        except Exception:
+            pass
+
+    return notes

package/skills/ppt-master/scripts/svg_to_pptx/pptx_media.py

@@ -0,0 +1,86 @@
+"""SVG to PNG conversion for Office compatibility mode."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+# SVG to PNG library detection
+# Prefer CairoSVG (better quality), fall back to svglib
+PNG_RENDERER: str | None = None
+
+try:
+    import cairosvg
+    PNG_RENDERER = 'cairosvg'
+except (ImportError, OSError):
+    try:
+        from svglib.svglib import svg2rlg
+        from reportlab.graphics import renderPM
+        PNG_RENDERER = 'svglib'
+    except (ImportError, OSError):
+        pass
+
+
+def get_png_renderer_info() -> tuple[str | None, str, str | None]:
+    """Get PNG renderer status information.
+
+    Returns:
+        (renderer_name, status_text, install_hint) tuple.
+    """
+    if PNG_RENDERER == 'cairosvg':
+        return ('cairosvg', '(full gradient/filter support)', None)
+    elif PNG_RENDERER == 'svglib':
+        return ('svglib', '(some gradients may be lost)',
+                'Install cairosvg for better results: pip install cairosvg')
+    else:
+        return (None, '(not installed)',
+                'Install via: pip install cairosvg or pip install svglib reportlab')
+
+
+def convert_svg_to_png(
+    svg_path: Path,
+    png_path: Path,
+    width: int | None = None,
+    height: int | None = None,
+) -> bool:
+    """Convert SVG to PNG using the available renderer.
+
+    Args:
+        svg_path: SVG file path.
+        png_path: Output PNG file path.
+        width: Output width in pixels.
+        height: Output height in pixels.
+
+    Returns:
+        Whether the conversion was successful.
+    """
+    if PNG_RENDERER is None:
+        return False
+
+    try:
+        if PNG_RENDERER == 'cairosvg':
+            cairosvg.svg2png(
+                url=str(svg_path),
+                write_to=str(png_path),
+                output_width=width,
+                output_height=height,
+            )
+            return True
+
+        elif PNG_RENDERER == 'svglib':
+            drawing = svg2rlg(str(svg_path))
+            if drawing is None:
+                print(f"  Warning: Unable to parse SVG ({svg_path.name})")
+                return False
+            renderPM.drawToFile(
+                drawing,
+                str(png_path),
+                fmt="PNG",
+                configPIL={'quality': 95},
+            )
+            return True
+
+    except Exception as e:
+        print(f"  Warning: SVG to PNG conversion failed ({svg_path.name}): {e}")
+        return False
+
+    return False

package/skills/ppt-master/scripts/svg_to_pptx/pptx_notes.py

@@ -0,0 +1,157 @@
+"""Markdown to plain text conversion and notes slide XML generation."""
+
+from __future__ import annotations
+
+import re
+
+
+def markdown_to_plain_text(md_content: str) -> str:
+    """Convert Markdown notes to plain text for PPTX notes.
+
+    Args:
+        md_content: Markdown formatted notes content.
+
+    Returns:
+        Plain text content.
+    """
+    def strip_inline_bold(text: str) -> str:
+        text = re.sub(r'\*\*(.+?)\*\*', r'\1', text)
+        text = re.sub(r'__(.+?)__', r'\1', text)
+        return text
+
+    lines: list[str] = []
+    for line in md_content.split('\n'):
+        if line.startswith('#'):
+            text = re.sub(r'^#+\s*', '', line).strip()
+            text = strip_inline_bold(text)
+            if text:
+                lines.append(text)
+                lines.append('')
+        elif line.strip().startswith('- '):
+            item_text = line.strip()[2:]
+            item_text = strip_inline_bold(item_text)
+            lines.append('• ' + item_text)
+        elif line.strip():
+            text = strip_inline_bold(line.strip())
+            lines.append(text)
+        else:
+            lines.append('')
+
+    # Merge consecutive empty lines
+    result: list[str] = []
+    is_prev_empty = False
+    for line in lines:
+        if line == '':
+            if not is_prev_empty:
+                result.append(line)
+            is_prev_empty = True
+        else:
+            result.append(line)
+            is_prev_empty = False
+
+    return '\n'.join(result).strip()
+
+
+def create_notes_slide_xml(slide_num: int, notes_text: str) -> str:
+    """Create notes slide XML.
+
+    Args:
+        slide_num: Slide number.
+        notes_text: Notes text in plain text format.
+
+    Returns:
+        Notes slide XML string.
+    """
+    notes_text = (notes_text
+                  .replace('&', '&')
+                  .replace('<', '&lt;')
+                  .replace('>', '&gt;'))
+
+    paragraphs: list[str] = []
+    for para in notes_text.split('\n'):
+        if para.strip():
+            paragraphs.append(f'''<a:p>
+              <a:r>
+                <a:rPr lang="zh-CN" dirty="0"/>
+                <a:t>{para}</a:t>
+              </a:r>
+            </a:p>''')
+        else:
+            paragraphs.append('<a:p><a:endParaRPr lang="zh-CN" dirty="0"/></a:p>')
+
+    paragraphs_xml = (
+        '\n            '.join(paragraphs)
+        if paragraphs
+        else '<a:p><a:endParaRPr lang="zh-CN" dirty="0"/></a:p>'
+    )
+
+    return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<p:notes xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
+         xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+         xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
+  <p:cSld>
+    <p:spTree>
+      <p:nvGrpSpPr>
+        <p:cNvPr id="1" name=""/>
+        <p:cNvGrpSpPr/>
+        <p:nvPr/>
+      </p:nvGrpSpPr>
+      <p:grpSpPr>
+        <a:xfrm>
+          <a:off x="0" y="0"/>
+          <a:ext cx="0" cy="0"/>
+          <a:chOff x="0" y="0"/>
+          <a:chExt cx="0" cy="0"/>
+        </a:xfrm>
+      </p:grpSpPr>
+      <p:sp>
+        <p:nvSpPr>
+          <p:cNvPr id="2" name="Slide Image Placeholder 1"/>
+          <p:cNvSpPr>
+            <a:spLocks noGrp="1" noRot="1" noChangeAspect="1"/>
+          </p:cNvSpPr>
+          <p:nvPr>
+            <p:ph type="sldImg"/>
+          </p:nvPr>
+        </p:nvSpPr>
+        <p:spPr/>
+      </p:sp>
+      <p:sp>
+        <p:nvSpPr>
+          <p:cNvPr id="3" name="Notes Placeholder 2"/>
+          <p:cNvSpPr>
+            <a:spLocks noGrp="1"/>
+          </p:cNvSpPr>
+          <p:nvPr>
+            <p:ph type="body" idx="1"/>
+          </p:nvPr>
+        </p:nvSpPr>
+        <p:spPr/>
+        <p:txBody>
+          <a:bodyPr/>
+          <a:lstStyle/>
+          {paragraphs_xml}
+        </p:txBody>
+      </p:sp>
+    </p:spTree>
+  </p:cSld>
+  <p:clrMapOvr>
+    <a:masterClrMapping/>
+  </p:clrMapOvr>
+</p:notes>'''
+
+
+def create_notes_slide_rels_xml(slide_num: int) -> str:
+    """Create notes slide relationship file XML.
+
+    Args:
+        slide_num: Slide number.
+
+    Returns:
+        Relationship file XML string.
+    """
+    return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" Target="../notesMasters/notesMaster1.xml"/>
+  <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="../slides/slide{slide_num}.xml"/>
+</Relationships>'''

package/skills/ppt-master/scripts/svg_to_pptx/pptx_slide_xml.py

@@ -0,0 +1,136 @@
+"""Slide XML and slide relationship XML generation."""
+
+from __future__ import annotations
+
+# Import animation module (optional)
+try:
+    from pptx_animations import create_transition_xml, TRANSITIONS
+    ANIMATIONS_AVAILABLE = True
+except ImportError:
+    ANIMATIONS_AVAILABLE = False
+    TRANSITIONS = {}
+
+
+def create_slide_xml_with_svg(
+    slide_num: int,
+    png_rid: str,
+    svg_rid: str,
+    width_emu: int,
+    height_emu: int,
+    transition: str | None = 'fade',
+    transition_duration: float = 0.5,
+    auto_advance: float | None = None,
+    use_compat_mode: bool = True,
+) -> str:
+    """Create slide XML containing an SVG image.
+
+    Args:
+        slide_num: Slide number.
+        png_rid: PNG fallback image relationship ID.
+        svg_rid: SVG relationship ID.
+        width_emu: Width in EMU.
+        height_emu: Height in EMU.
+        transition: Transition effect name.
+        transition_duration: Transition duration in seconds.
+        auto_advance: Auto-advance interval in seconds.
+        use_compat_mode: Whether to use compatibility mode (PNG + SVG dual format).
+    """
+    transition_xml = ''
+    if transition and ANIMATIONS_AVAILABLE:
+        transition_xml = '\n' + create_transition_xml(
+            effect=transition,
+            duration=transition_duration,
+            advance_after=auto_advance,
+        )
+
+    if use_compat_mode:
+        blip_xml = f'''<a:blip r:embed="{png_rid}">
+            <a:extLst>
+              <a:ext uri="{{96DAC541-7B7A-43D3-8B79-37D633B846F1}}">
+                <asvg:svgBlip xmlns:asvg="http://schemas.microsoft.com/office/drawing/2016/SVG/main" r:embed="{svg_rid}"/>
+              </a:ext>
+            </a:extLst>
+          </a:blip>'''
+    else:
+        blip_xml = f'<a:blip r:embed="{svg_rid}"/>'
+
+    return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
+       xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+       xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
+  <p:cSld>
+    <p:spTree>
+      <p:nvGrpSpPr>
+        <p:cNvPr id="1" name=""/>
+        <p:cNvGrpSpPr/>
+        <p:nvPr/>
+      </p:nvGrpSpPr>
+      <p:grpSpPr>
+        <a:xfrm>
+          <a:off x="0" y="0"/>
+          <a:ext cx="0" cy="0"/>
+          <a:chOff x="0" y="0"/>
+          <a:chExt cx="0" cy="0"/>
+        </a:xfrm>
+      </p:grpSpPr>
+      <p:pic>
+        <p:nvPicPr>
+          <p:cNvPr id="2" name="SVG Image {slide_num}"/>
+          <p:cNvPicPr>
+            <a:picLocks noChangeAspect="1"/>
+          </p:cNvPicPr>
+          <p:nvPr/>
+        </p:nvPicPr>
+        <p:blipFill>
+          {blip_xml}
+          <a:stretch>
+            <a:fillRect/>
+          </a:stretch>
+        </p:blipFill>
+        <p:spPr>
+          <a:xfrm>
+            <a:off x="0" y="0"/>
+            <a:ext cx="{width_emu}" cy="{height_emu}"/>
+          </a:xfrm>
+          <a:prstGeom prst="rect">
+            <a:avLst/>
+          </a:prstGeom>
+        </p:spPr>
+      </p:pic>
+    </p:spTree>
+  </p:cSld>
+  <p:clrMapOvr>
+    <a:masterClrMapping/>
+  </p:clrMapOvr>{transition_xml}
+</p:sld>'''
+
+
+def create_slide_rels_xml(
+    png_rid: str,
+    png_filename: str,
+    svg_rid: str,
+    svg_filename: str,
+    use_compat_mode: bool = True,
+) -> str:
+    """Create slide relationship file XML.
+
+    Args:
+        png_rid: PNG image relationship ID.
+        png_filename: PNG filename.
+        svg_rid: SVG relationship ID.
+        svg_filename: SVG filename.
+        use_compat_mode: Whether to use compatibility mode.
+    """
+    if use_compat_mode:
+        return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>
+  <Relationship Id="{png_rid}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/{png_filename}"/>
+  <Relationship Id="{svg_rid}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/{svg_filename}"/>
+</Relationships>'''
+    else:
+        return f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>
+  <Relationship Id="{svg_rid}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/{svg_filename}"/>
+</Relationships>'''

package/skills/ppt-master/scripts/svg_to_pptx.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+"""PPT Master - SVG to PPTX Tool (thin wrapper).
+
+Delegates to the svg_to_pptx package. Kept for CLI backward compatibility:
+    python3 scripts/svg_to_pptx.py <project_path> -s final
+"""
+
+import sys
+from pathlib import Path
+
+# Ensure the scripts directory is on sys.path so the package can be found
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from svg_to_pptx import main
+
+if __name__ == '__main__':
+    main()