feat(pptx): add homePlate shape, fillRef/fontRef style fallback, and non-rectangular text box rendering

- Add homePlate preset geometry (pentagon arrow tab) to shape parser
- Parse <a:fillRef> from <p:style> as fallback fill color when no
  explicit solidFill/noFill is set on the shape
- Parse <a:fontRef> from <p:style> as fallback text color, overriding
  inherited layout/master defaults
- Handle <a:noFill/> explicitly to prevent style fill fallback
- Split text boxes with non-rectangular shapes (roundRect, homePlate,
  ellipse, polygon) into Shape background + transparent TextBox overlay
  so geometry is rendered by the proven shape renderer
- Add shape_kind field to TextBoxData for future use
- Add write_text_box_shape_background() for custom shape rendering

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: Yonghye Kwon <developer.0hye@gmail.com>

Author: developer0hye

crates/office2pdf/src/ir/elements.rs

@@ -146,6 +146,9 @@ pub struct TextBoxData {
     pub opacity: Option<f64>,
     /// Border stroke for the text box.
     pub stroke: Option<BorderSide>,
+    /// Shape geometry when the text box originates from a non-rectangular shape
+    /// (e.g., `roundRect`, `homePlate`). `None` means default rectangle.
+    pub shape_kind: Option<ShapeKind>,
 }
 
 /// The kind of list: ordered (numbered) or unordered (bulleted).

crates/office2pdf/src/lib_render_tests.rs

@@ -583,6 +583,7 @@ fn test_render_pptx_style_document_size() {
                     fill: None,
                     opacity: None,
                     stroke: None,
+                    shape_kind: None,
                 }),
             }],
         }));
@@ -640,6 +641,7 @@ fn test_render_document_with_centered_fixed_text_box() {
                     fill: None,
                     opacity: None,
                     stroke: None,
+                    shape_kind: None,
                 }),
             }],
         })],

crates/office2pdf/src/parser/pptx.rs

@@ -355,6 +355,16 @@ impl PptxTextBodyStyleDefaults {
         bullet
     }
 
+    /// Apply a default text color from `<p:style><a:fontRef>`.
+    /// This overrides inherited layout/master defaults because `fontRef` is
+    /// a shape-level style with higher precedence.
+    fn apply_default_color(&mut self, color: Color) {
+        self.default_run.color = Some(color);
+        for level_style in self.levels.values_mut() {
+            level_style.run.color = Some(color);
+        }
+    }
+
     fn merge_from(&mut self, overlay: &PptxTextBodyStyleDefaults) {
         self.default_paragraph
             .merge_from(&overlay.default_paragraph);

crates/office2pdf/src/parser/pptx_preset_shape_tests.rs

@@ -306,6 +306,78 @@ fn test_shape_star6() {
     }
 }
 
+#[test]
+fn test_shape_home_plate() {
+    // homePlate: pentagon arrow shape (rect with pointed right edge)
+    // Wide shape: cx=1980000 (wider than tall), cy=584391
+    let shape = make_shape(
+        0,
+        0,
+        1_980_000,
+        584_391,
+        "homePlate",
+        Some("00259A"),
+        None,
+        None,
+    );
+    let slide = make_slide_xml(&[shape]);
+    let data = build_test_pptx(SLIDE_CX, SLIDE_CY, &[slide]);
+    let parser = PptxParser;
+    let (doc, _warnings) = parser.parse(&data, &ConvertOptions::default()).unwrap();
+
+    let page = first_fixed_page(&doc);
+    let shape = get_shape(&page.elements[0]);
+    match &shape.kind {
+        ShapeKind::Polygon { vertices } => {
+            assert_eq!(vertices.len(), 5, "homePlate should have 5 vertices");
+            // First vertex is top-left (0, 0)
+            assert!(vertices[0].0.abs() < 0.01);
+            assert!(vertices[0].1.abs() < 0.01);
+            // Last vertex is bottom-left (0, 1)
+            assert!(vertices[4].0.abs() < 0.01);
+            assert!((vertices[4].1 - 1.0).abs() < 0.01);
+            // Middle vertex is the rightmost point at (1.0, 0.5)
+            assert!((vertices[2].0 - 1.0).abs() < 0.01);
+            assert!((vertices[2].1 - 0.5).abs() < 0.01);
+            // Arrow notch vertices should be between 0 and 1 on x
+            assert!(vertices[1].0 > 0.5 && vertices[1].0 < 1.0);
+            assert!(vertices[3].0 > 0.5 && vertices[3].0 < 1.0);
+        }
+        other => panic!("Expected Polygon for homePlate, got {other:?}"),
+    }
+    assert_eq!(shape.fill, Some(Color::new(0, 37, 154)));
+}
+
+#[test]
+fn test_shape_home_plate_square() {
+    // Square bounding box: the notch should be at x = 0.5
+    let shape = make_shape(
+        0,
+        0,
+        1_000_000,
+        1_000_000,
+        "homePlate",
+        None,
+        None,
+        None,
+    );
+    let slide = make_slide_xml(&[shape]);
+    let data = build_test_pptx(SLIDE_CX, SLIDE_CY, &[slide]);
+    let parser = PptxParser;
+    let (doc, _warnings) = parser.parse(&data, &ConvertOptions::default()).unwrap();
+
+    let page = first_fixed_page(&doc);
+    let shape = get_shape(&page.elements[0]);
+    match &shape.kind {
+        ShapeKind::Polygon { vertices } => {
+            assert_eq!(vertices.len(), 5);
+            // For square with default adj=50000: notch_x = 1.0 - 0.5 = 0.5
+            assert!((vertices[1].0 - 0.5).abs() < 0.01);
+        }
+        other => panic!("Expected Polygon for homePlate square, got {other:?}"),
+    }
+}
+
 #[test]
 fn test_unsupported_preset_falls_back_to_rectangle() {
     let shape = make_shape(

crates/office2pdf/src/parser/pptx_shape_style_tests.rs

@@ -376,3 +376,95 @@ fn test_shape_shadow_default_opacity() {
         shadow.opacity
     );
 }
+
+// ── fillRef style fallback tests ─────────────────────────────────
+
+#[test]
+fn test_shape_fill_from_style_fill_ref() {
+    // Shape with no explicit fill, but <p:style><a:fillRef> referencing accent1.
+    // accent1 = #4472C4 in standard theme.
+    let shape_xml = r#"<p:sp><p:nvSpPr><p:cNvPr id="2" name="Rect"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr><p:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="914400" cy="914400"/></a:xfrm><a:prstGeom prst="roundRect"><a:avLst/></a:prstGeom><a:ln><a:solidFill><a:srgbClr val="000000"/></a:solidFill></a:ln></p:spPr><p:style><a:lnRef idx="2"><a:schemeClr val="accent1"/></a:lnRef><a:fillRef idx="1"><a:schemeClr val="accent1"/></a:fillRef><a:effectRef idx="0"><a:schemeClr val="accent1"/></a:effectRef><a:fontRef idx="minor"><a:schemeClr val="lt1"/></a:fontRef></p:style></p:sp>"#.to_string();
+    let slide_xml = make_slide_xml(&[shape_xml]);
+
+    let theme_xml = make_theme_xml(&standard_theme_colors(), "Calibri", "Calibri");
+    let data = build_test_pptx_with_theme(SLIDE_CX, SLIDE_CY, &[slide_xml], &theme_xml);
+    let parser = PptxParser;
+    let (doc, _warnings) = parser.parse(&data, &ConvertOptions::default()).unwrap();
+
+    let page = first_fixed_page(&doc);
+    let shape = get_shape(&page.elements[0]);
+    // accent1 = #4472C4
+    assert_eq!(
+        shape.fill,
+        Some(Color::new(0x44, 0x72, 0xC4)),
+        "Shape should get fill from fillRef accent1"
+    );
+}
+
+#[test]
+fn test_shape_explicit_fill_overrides_fill_ref() {
+    // Shape with explicit solidFill AND <p:style><a:fillRef>.
+    // Explicit fill should win.
+    let shape_xml = r#"<p:sp><p:nvSpPr><p:cNvPr id="2" name="Rect"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr><p:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="914400" cy="914400"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom><a:solidFill><a:srgbClr val="FF0000"/></a:solidFill></p:spPr><p:style><a:lnRef idx="2"><a:schemeClr val="accent1"/></a:lnRef><a:fillRef idx="1"><a:schemeClr val="accent1"/></a:fillRef><a:effectRef idx="0"><a:schemeClr val="accent1"/></a:effectRef><a:fontRef idx="minor"><a:schemeClr val="lt1"/></a:fontRef></p:style></p:sp>"#.to_string();
+    let slide_xml = make_slide_xml(&[shape_xml]);
+
+    let theme_xml = make_theme_xml(&standard_theme_colors(), "Calibri", "Calibri");
+    let data = build_test_pptx_with_theme(SLIDE_CX, SLIDE_CY, &[slide_xml], &theme_xml);
+    let parser = PptxParser;
+    let (doc, _warnings) = parser.parse(&data, &ConvertOptions::default()).unwrap();
+
+    let page = first_fixed_page(&doc);
+    let shape = get_shape(&page.elements[0]);
+    assert_eq!(
+        shape.fill,
+        Some(Color::new(255, 0, 0)),
+        "Explicit solidFill should override fillRef"
+    );
+}
+
+#[test]
+fn test_shape_no_fill_overrides_fill_ref() {
+    // Shape with explicit <a:noFill/> AND <p:style><a:fillRef>.
+    // noFill should prevent style fallback.
+    let shape_xml = r#"<p:sp><p:nvSpPr><p:cNvPr id="2" name="Rect"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr><p:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="914400" cy="914400"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom><a:noFill/></p:spPr><p:style><a:lnRef idx="2"><a:schemeClr val="accent1"/></a:lnRef><a:fillRef idx="1"><a:schemeClr val="accent1"/></a:fillRef><a:effectRef idx="0"><a:schemeClr val="accent1"/></a:effectRef><a:fontRef idx="minor"><a:schemeClr val="lt1"/></a:fontRef></p:style></p:sp>"#.to_string();
+    let slide_xml = make_slide_xml(&[shape_xml]);
+
+    let theme_xml = make_theme_xml(&standard_theme_colors(), "Calibri", "Calibri");
+    let data = build_test_pptx_with_theme(SLIDE_CX, SLIDE_CY, &[slide_xml], &theme_xml);
+    let parser = PptxParser;
+    let (doc, _warnings) = parser.parse(&data, &ConvertOptions::default()).unwrap();
+
+    let page = first_fixed_page(&doc);
+    let shape = get_shape(&page.elements[0]);
+    assert_eq!(
+        shape.fill, None,
+        "noFill should prevent style fillRef fallback"
+    );
+}
+
+#[test]
+fn test_textbox_fill_from_style_fill_ref() {
+    // TextBox with roundRect (non-rectangular shape) and text gets split into
+    // two elements: Shape background (with fill) + transparent TextBox overlay.
+    let shape_xml = r#"<p:sp><p:nvSpPr><p:cNvPr id="2" name="TextBox"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr><p:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="914400" cy="914400"/></a:xfrm><a:prstGeom prst="roundRect"><a:avLst/></a:prstGeom><a:ln><a:solidFill><a:srgbClr val="000000"/></a:solidFill></a:ln></p:spPr><p:style><a:lnRef idx="2"><a:schemeClr val="accent1"/></a:lnRef><a:fillRef idx="1"><a:schemeClr val="accent1"/></a:fillRef><a:effectRef idx="0"><a:schemeClr val="accent1"/></a:effectRef><a:fontRef idx="minor"><a:schemeClr val="lt1"/></a:fontRef></p:style><p:txBody><a:bodyPr/><a:p><a:r><a:rPr lang="en-US"/><a:t>Hello</a:t></a:r></a:p></p:txBody></p:sp>"#.to_string();
+    let slide_xml = make_slide_xml(&[shape_xml]);
+
+    let theme_xml = make_theme_xml(&standard_theme_colors(), "Calibri", "Calibri");
+    let data = build_test_pptx_with_theme(SLIDE_CX, SLIDE_CY, &[slide_xml], &theme_xml);
+    let parser = PptxParser;
+    let (doc, _warnings) = parser.parse(&data, &ConvertOptions::default()).unwrap();
+
+    let page = first_fixed_page(&doc);
+    // First element: Shape background with geometry and fill
+    assert_eq!(page.elements.len(), 2, "Expected Shape + TextBox pair");
+    let shape = get_shape(&page.elements[0]);
+    assert_eq!(
+        shape.fill,
+        Some(Color::new(0x44, 0x72, 0xC4)),
+        "Shape background should get fill from fillRef accent1"
+    );
+    assert!(matches!(shape.kind, ShapeKind::RoundedRectangle { .. }));
+    // Second element: Transparent text overlay
+    let tb = text_box_data(&page.elements[1]);
+    assert_eq!(tb.fill, None, "Text overlay should have no fill");
+}

crates/office2pdf/src/parser/pptx_shapes.rs

@@ -282,6 +282,22 @@ pub(super) fn prst_to_shape_kind(
         "roundRect" => ShapeKind::RoundedRectangle {
             radius_fraction: 0.1,
         },
+        // homePlate: pentagon arrow tab (rect with pointed right edge)
+        "homePlate" => {
+            let adj: f64 = adj_values.first().copied().unwrap_or(50_000.0);
+            let ss: f64 = width.min(height);
+            let dx: f64 = (adj / 100_000.0 * ss).min(width);
+            let notch_x: f64 = (width - dx) / width;
+            ShapeKind::Polygon {
+                vertices: vec![
+                    (0.0, 0.0),
+                    (notch_x, 0.0),
+                    (1.0, 0.5),
+                    (notch_x, 1.0),
+                    (0.0, 1.0),
+                ],
+            }
+        }
         "triangle" => ShapeKind::Polygon {
             vertices: vec![(0.5, 0.0), (1.0, 1.0), (0.0, 1.0)],
         },