@nguyenphp/antigravity-marketing 1.0.16 → 1.0.19

package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples.cs

@@ -0,0 +1,1832 @@
+// ============================================================================
+// AestheticRecipeSamples.cs — Complete aesthetic recipes for document styling
+// ============================================================================
+// Each recipe is a self-contained, coordinated design system where fonts,
+// sizes, spacing, colors, margins, and table styles all work in harmony.
+//
+// DESIGN PHILOSOPHY: Beauty comes from harmony, not individual choices.
+// A 14pt heading is not inherently good or bad — it depends on body size,
+// line spacing, margins, and color all working together.
+//
+// UNIT REFERENCE:
+//   Font size: half-points (22 = 11pt, 24 = 12pt, 32 = 16pt)
+//   Spacing:   DXA = twentieths of a point (1440 DXA = 1 inch)
+//   Borders:   eighth-points (4 = 0.5pt, 8 = 1pt, 12 = 1.5pt)
+//   Line spacing "line": 240ths of single spacing (240 = 1.0x, 276 = 1.15x)
+// ============================================================================
+
+using DocumentFormat.OpenXml;
+using DocumentFormat.OpenXml.Packaging;
+using DocumentFormat.OpenXml.Wordprocessing;
+
+using WpPageSize = DocumentFormat.OpenXml.Wordprocessing.PageSize;
+
+namespace MiniMaxAIDocx.Core.Samples;
+
+/// <summary>
+/// Complete aesthetic recipes — coordinated design systems where all parameters
+/// work together. Each recipe is a full document style that can be applied as-is.
+///
+/// DESIGN PHILOSOPHY: Beauty comes from harmony, not individual choices.
+/// A 14pt heading is not inherently good or bad — it depends on body size,
+/// line spacing, margins, and color all working together.
+///
+/// These recipes encode tested, harmonious combinations.
+/// </summary>
+public static partial class AestheticRecipeSamples
+{
+    // ════════════════════════════════════════════════════════════════════════
+    // RECIPE 1: MODERN CORPORATE
+    // ════════════════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Recipe: Modern Corporate
+    /// Feel: Clean, confident, contemporary.
+    /// Best for: Business reports, proposals, internal documents.
+    ///
+    /// Design rationale:
+    /// - 1.25x modular scale creates clear but not aggressive hierarchy
+    ///   (body 11pt → H3 13pt → H2 16pt → H1 20pt, each step ~1.25x)
+    /// - Dark navy headings (#1F3864) convey authority without being harsh
+    /// - 1.15 line spacing is the sweet spot for sans-serif readability:
+    ///   tight enough to look professional, open enough for comfortable scanning
+    /// - 8pt paragraph spacing creates rhythm without wasting vertical space
+    /// - Body text #333333 (not pure black) reduces eye strain on screens
+    /// - Sans-serif font family (Aptos/Calibri) signals modernity and clarity
+    /// - Light banded table rows (#F2F2F2) aid scanning without visual noise
+    /// </summary>
+    public static void CreateModernCorporateDocument(string outputPath)
+    {
+        using var doc = WordprocessingDocument.Create(outputPath, WordprocessingDocumentType.Document);
+
+        var mainPart = doc.AddMainDocumentPart();
+        mainPart.Document = new Document(new Body());
+        var body = mainPart.Document.Body!;
+
+        // ── Styles ──
+        var stylesPart = mainPart.AddNewPart<StyleDefinitionsPart>();
+        stylesPart.Styles = new Styles();
+        var styles = stylesPart.Styles;
+
+        // DocDefaults: the foundation everything inherits from.
+        // Aptos is Word's new default (2023+); Calibri is the fallback for older systems.
+        styles.Append(new DocDefaults(
+            new RunPropertiesDefault(
+                new RunPropertiesBaseStyle(
+                    new RunFonts
+                    {
+                        Ascii = "Aptos",
+                        HighAnsi = "Aptos",
+                        EastAsia = "SimSun",
+                        ComplexScript = "Calibri"
+                    },
+                    new FontSize { Val = "22" },              // 11pt body default
+                    new FontSizeComplexScript { Val = "22" },
+                    new Color { Val = "333333" },             // Soft black — easier on eyes than #000000
+                    new Languages { Val = "en-US", EastAsia = "zh-CN" }
+                )
+            ),
+            new ParagraphPropertiesDefault(
+                new ParagraphPropertiesBaseStyle(
+                    new SpacingBetweenLines
+                    {
+                        // 1.15x line spacing: the modern standard for sans-serif.
+                        // 240 = single, so 276 = 1.15x. Word's default since 2013.
+                        Line = "276",
+                        LineRule = LineSpacingRuleValues.Auto,
+                        After = "160"   // 8pt after — enough rhythm, not too airy
+                    }
+                )
+            )
+        ));
+
+        // ── Normal style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "Normal",
+            styleName: "Normal",
+            isDefault: true,
+            uiPriority: 0
+        ));
+
+        // ── Heading 1: 20pt Aptos Display, dark navy ──
+        // 20pt = 40 half-points. The 1.25x scale from 11pt body gives:
+        //   11 → 13.75 → 17.2 → 21.5. We round to 13, 16, 20 for clean numbers.
+        styles.Append(CreateHeadingStyle(
+            level: 1,
+            fontAscii: "Aptos Display",
+            fontHAnsi: "Aptos Display",
+            sizeHalfPts: "40",            // 20pt
+            color: "1F3864",              // Dark navy — authority without aggression
+            bold: false,                  // Large Display font doesn't need bold
+            spaceBefore: "480",           // 24pt before — creates a clear section break
+            spaceAfter: "120",            // 6pt after — tight coupling to content below
+            uiPriority: 9
+        ));
+
+        // ── Heading 2: 16pt, dark navy, semi-bold ──
+        styles.Append(CreateHeadingStyle(
+            level: 2,
+            fontAscii: "Aptos Display",
+            fontHAnsi: "Aptos Display",
+            sizeHalfPts: "32",            // 16pt
+            color: "1F3864",
+            bold: false,
+            spaceBefore: "360",           // 18pt before
+            spaceAfter: "80",             // 4pt after
+            uiPriority: 9
+        ));
+
+        // ── Heading 3: 13pt, dark navy, bold ──
+        styles.Append(CreateHeadingStyle(
+            level: 3,
+            fontAscii: "Aptos",
+            fontHAnsi: "Aptos",
+            sizeHalfPts: "26",            // 13pt
+            color: "1F3864",
+            bold: true,                   // Bold compensates for smaller size
+            spaceBefore: "240",           // 12pt before
+            spaceAfter: "80",             // 4pt after
+            uiPriority: 9
+        ));
+
+        // ── ListBullet style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "ListBullet",
+            styleName: "List Bullet",
+            basedOn: "Normal",
+            uiPriority: 36
+        ));
+
+        // ── Caption style: 9pt italic gray ──
+        styles.Append(CreateCaptionStyle(
+            fontSizeHalfPts: "18",        // 9pt
+            color: "595959",
+            italic: true
+        ));
+
+        // ── Page setup: Letter, 1in margins ──
+        // 1 inch = 1440 DXA. Letter = 8.5" x 11" = 12240 x 15840 DXA.
+        var sectPr = new SectionProperties(
+            new WpPageSize { Width = 12240U, Height = 15840U },
+            new PageMargin
+            {
+                Top = 1440, Bottom = 1440,
+                Left = 1440U, Right = 1440U,
+                Header = 720U, Footer = 720U, Gutter = 0U
+            }
+        );
+
+        // ── Page numbers: bottom right, 9pt gray ──
+        AddPageNumberFooter(mainPart, sectPr,
+            alignment: JustificationValues.Right,
+            fontSizeHalfPts: "18",        // 9pt — subordinate to body text
+            color: "808080",              // Gray — page numbers are reference, not content
+            format: PageNumberFormat.Plain
+        );
+
+        // ── Sample content ──
+        AddSampleParagraph(body, "Modern Corporate Report", "Heading1");
+
+        AddSampleParagraph(body, "This document demonstrates the Modern Corporate aesthetic. "
+            + "The clean sans-serif typography, dark navy headings, and generous but not "
+            + "excessive spacing create a professional appearance suitable for business contexts.",
+            "Normal");
+
+        AddSampleParagraph(body, "Executive Summary", "Heading2");
+
+        AddSampleParagraph(body, "Key findings from our analysis indicate strong performance "
+            + "across all divisions. Revenue grew 12% year-over-year while maintaining healthy "
+            + "margins. The integration of new systems has improved operational efficiency.",
+            "Normal");
+
+        AddSampleParagraph(body, "Detailed Findings", "Heading2");
+
+        AddSampleParagraph(body, "Revenue Analysis", "Heading3");
+
+        AddSampleParagraph(body, "Quarter-over-quarter growth remained consistent, with Q3 "
+            + "showing particularly strong performance in the enterprise segment.",
+            "Normal");
+
+        // ── Table: light top/bottom borders, banded rows, no vertical lines ──
+        body.Append(CreateModernCorporateTable(
+            new[] { "Division", "Revenue", "Growth", "Margin" },
+            new[]
+            {
+                new[] { "Enterprise", "$45.2M", "+15%", "42%" },
+                new[] { "Mid-Market", "$28.7M", "+11%", "38%" },
+                new[] { "SMB", "$12.1M", "+8%", "35%" }
+            }
+        ));
+
+        AddSampleParagraph(body, "Table 1: Division Performance Summary", "Caption");
+
+        // Section properties must be last child of body
+        body.Append(sectPr);
+    }
+
+    /// <summary>
+    /// Modern Corporate table aesthetic: horizontal lines only, banded rows.
+    /// Design: top and bottom borders frame the data. Header has a bottom border.
+    /// No vertical lines — the eye follows horizontal rows naturally.
+    /// Subtle #F2F2F2 banding on alternate rows aids scanning without adding noise.
+    /// </summary>
+    private static Table CreateModernCorporateTable(string[] headers, string[][] data)
+    {
+        var table = new Table();
+
+        // Table properties: full width, horizontal-only borders
+        var tblPr = new TableProperties(
+            new TableWidth { Width = "5000", Type = TableWidthUnitValues.Pct },
+            new TableBorders(
+                new TopBorder { Val = BorderValues.Single, Size = 8, Space = 0, Color = "BFBFBF" },
+                new BottomBorder { Val = BorderValues.Single, Size = 8, Space = 0, Color = "BFBFBF" },
+                new LeftBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new RightBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                // Horizontal inside borders for row separation
+                new InsideHorizontalBorder { Val = BorderValues.Single, Size = 4, Space = 0, Color = "D9D9D9" },
+                // No vertical inside borders — cleaner look
+                new InsideVerticalBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" }
+            ),
+            // Cell padding: 28 DXA minimum each side for breathing room
+            new TableCellMarginDefault(
+                new TopMargin { Width = "28", Type = TableWidthUnitValues.Dxa },
+                new StartMargin { Width = "57", Type = TableWidthUnitValues.Dxa },
+                new BottomMargin { Width = "28", Type = TableWidthUnitValues.Dxa },
+                new EndMargin { Width = "57", Type = TableWidthUnitValues.Dxa }
+            )
+        );
+        table.Append(tblPr);
+
+        // Grid columns
+        var grid = new TableGrid();
+        int colWidth = 9360 / headers.Length;
+        foreach (var _ in headers)
+            grid.Append(new GridColumn { Width = colWidth.ToString() });
+        table.Append(grid);
+
+        // Header row
+        var headerRow = new TableRow();
+        foreach (var h in headers)
+        {
+            headerRow.Append(new TableCell(
+                new TableCellProperties(
+                    new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto },
+                    // Header bottom border slightly heavier to separate from data
+                    new TableCellBorders(
+                        new BottomBorder { Val = BorderValues.Single, Size = 8, Space = 0, Color = "999999" }
+                    )
+                ),
+                new Paragraph(
+                    new ParagraphProperties(
+                        new SpacingBetweenLines { After = "0" }
+                    ),
+                    new Run(
+                        new RunProperties(new Bold()),
+                        new Text(h)
+                    )
+                )
+            ));
+        }
+        table.Append(headerRow);
+
+        // Data rows with subtle banding
+        for (int i = 0; i < data.Length; i++)
+        {
+            var row = new TableRow();
+            foreach (var cell in data[i])
+            {
+                var tcPr = new TableCellProperties(
+                    new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto }
+                );
+                // Banded rows: every other row gets a very light gray background
+                // #F2F2F2 is subtle enough to not compete with content
+                if (i % 2 == 1)
+                {
+                    tcPr.Append(new Shading
+                    {
+                        Val = ShadingPatternValues.Clear,
+                        Color = "auto",
+                        Fill = "F2F2F2"
+                    });
+                }
+
+                row.Append(new TableCell(
+                    tcPr,
+                    new Paragraph(
+                        new ParagraphProperties(
+                            new SpacingBetweenLines { After = "0" }
+                        ),
+                        new Run(new Text(cell))
+                    )
+                ));
+            }
+            table.Append(row);
+        }
+
+        return table;
+    }
+
+
+    // ════════════════════════════════════════════════════════════════════════
+    // RECIPE 2: ACADEMIC THESIS
+    // ════════════════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Recipe: Academic Thesis (APA-style)
+    /// Feel: Traditional, scholarly, readable for sustained long-form reading.
+    /// Best for: Dissertations, research papers, academic reports.
+    ///
+    /// Design rationale:
+    /// - Times New Roman 12pt: the universal academic standard, optimized for
+    ///   print legibility at reading distance. Serif fonts aid reading flow in
+    ///   long-form text by creating horizontal "rails" for the eye.
+    /// - APA-style headings: size is UNIFORM (all 12pt) — hierarchy is expressed
+    ///   through bold, italic, centering, and indentation rather than size change.
+    ///   This is intentional: in academic writing, the text IS the content, and
+    ///   headings are navigational aids, not visual statements.
+    /// - Double spacing (480 line units): required by most style guides for
+    ///   annotation/editing room. Also improves readability for dense content.
+    /// - 0.5in first-line indent, no paragraph spacing: the classical paragraph
+    ///   separator. Space-after is a modern convention; indent is the scholarly one.
+    /// - Left margin 1.5in for binding: physical theses are bound on the left.
+    /// - Three-line table (三线表): the academic standard — top rule, header rule,
+    ///   bottom rule. No vertical lines. Clean and information-focused.
+    /// </summary>
+    public static void CreateAcademicThesisDocument(string outputPath)
+    {
+        using var doc = WordprocessingDocument.Create(outputPath, WordprocessingDocumentType.Document);
+
+        var mainPart = doc.AddMainDocumentPart();
+        mainPart.Document = new Document(new Body());
+        var body = mainPart.Document.Body!;
+
+        // ── Styles ──
+        var stylesPart = mainPart.AddNewPart<StyleDefinitionsPart>();
+        stylesPart.Styles = new Styles();
+        var styles = stylesPart.Styles;
+
+        // DocDefaults: Times New Roman 12pt, double spacing
+        styles.Append(new DocDefaults(
+            new RunPropertiesDefault(
+                new RunPropertiesBaseStyle(
+                    new RunFonts
+                    {
+                        Ascii = "Times New Roman",
+                        HighAnsi = "Times New Roman",
+                        EastAsia = "SimSun",
+                        ComplexScript = "Times New Roman"
+                    },
+                    new FontSize { Val = "24" },              // 12pt (in half-points)
+                    new FontSizeComplexScript { Val = "24" },
+                    new Color { Val = "000000" },             // Pure black — academic standard
+                    new Languages { Val = "en-US", EastAsia = "zh-CN" }
+                )
+            ),
+            new ParagraphPropertiesDefault(
+                new ParagraphPropertiesBaseStyle(
+                    new SpacingBetweenLines
+                    {
+                        // Double spacing: 480 = 2.0x (240 = single)
+                        // This is the fundamental academic formatting requirement
+                        Line = "480",
+                        LineRule = LineSpacingRuleValues.Auto,
+                        After = "0"     // No space after — use first-line indent instead
+                    },
+                    // First-line indent: 0.5in = 720 DXA
+                    // The traditional paragraph separator in academic writing
+                    new Indentation { FirstLine = "720" }
+                )
+            )
+        ));
+
+        // ── Normal style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "Normal",
+            styleName: "Normal",
+            isDefault: true,
+            uiPriority: 0
+        ));
+
+        // ── APA Heading 1: 12pt bold, centered ──
+        // APA Level 1: Centered, Bold, Title Case
+        // Note: ALL headings are 12pt — hierarchy through formatting, not size.
+        styles.Append(CreateAcademicHeadingStyle(
+            level: 1,
+            sizeHalfPts: "24",           // 12pt — same as body
+            bold: true,
+            italic: false,
+            centered: true,
+            spaceBefore: "480",          // One blank double-spaced line before
+            spaceAfter: "0"
+        ));
+
+        // ── APA Heading 2: 12pt bold, left-aligned ──
+        // APA Level 2: Flush Left, Bold, Title Case
+        styles.Append(CreateAcademicHeadingStyle(
+            level: 2,
+            sizeHalfPts: "24",           // 12pt — same as body
+            bold: true,
+            italic: false,
+            centered: false,
+            spaceBefore: "480",
+            spaceAfter: "0"
+        ));
+
+        // ── APA Heading 3: 12pt bold italic, left-aligned ──
+        // APA Level 3: Flush Left, Bold Italic, Title Case
+        styles.Append(CreateAcademicHeadingStyle(
+            level: 3,
+            sizeHalfPts: "24",           // 12pt — same as body
+            bold: true,
+            italic: true,
+            centered: false,
+            spaceBefore: "480",
+            spaceAfter: "0"
+        ));
+
+        // ── ListBullet style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "ListBullet",
+            styleName: "List Bullet",
+            basedOn: "Normal",
+            uiPriority: 36
+        ));
+
+        // ── Caption style ──
+        styles.Append(CreateCaptionStyle(
+            fontSizeHalfPts: "24",        // 12pt — same as body (APA requirement)
+            color: "000000",
+            italic: true
+        ));
+
+        // ── Page setup: Letter, 1in margins, 1.5in left for binding ──
+        var sectPr = new SectionProperties(
+            new WpPageSize { Width = 12240U, Height = 15840U },
+            new PageMargin
+            {
+                Top = 1440, Bottom = 1440,
+                Left = 2160U,             // 1.5in for binding margin
+                Right = 1440U,
+                Header = 720U, Footer = 720U, Gutter = 0U
+            }
+        );
+
+        // ── Page numbers: top right (APA style) ──
+        AddPageNumberFooter(mainPart, sectPr,
+            alignment: JustificationValues.Right,
+            fontSizeHalfPts: "24",        // 12pt — APA requires same size
+            color: "000000",
+            format: PageNumberFormat.Plain,
+            isHeader: true                // APA puts page numbers in header
+        );
+
+        // ── Sample content ──
+        // Title page heading — no first-line indent
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Heading1" },
+                new Indentation { FirstLine = "0" }           // Override indent for headings
+            ),
+            new Run(new Text("The Effects of Typography on Reading Comprehension"))
+        ));
+
+        AddAcademicParagraph(body, "This study examines the relationship between typographic "
+            + "choices and reading comprehension in academic documents. Previous research has "
+            + "established that serif fonts facilitate sustained reading in printed materials, "
+            + "though recent evidence suggests this advantage diminishes on high-resolution screens.");
+
+        AddAcademicParagraph(body, "The present investigation extends this work by examining "
+            + "how the interaction of font choice, line spacing, and margin width affects both "
+            + "comprehension accuracy and reading speed across different document lengths.");
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Heading2" },
+                new Indentation { FirstLine = "0" }
+            ),
+            new Run(new Text("Method"))
+        ));
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Heading3" },
+                new Indentation { FirstLine = "0" }
+            ),
+            new Run(new Text("Participants"))
+        ));
+
+        AddAcademicParagraph(body, "A total of 120 undergraduate students (M age = 21.3, "
+            + "SD = 2.1) participated in exchange for course credit. All participants reported "
+            + "normal or corrected-to-normal vision.");
+
+        // ── Three-line table (三线表) ──
+        body.Append(CreateThreeLineTable(
+            new[] { "Condition", "n", "M (RT)", "SD", "Accuracy %" },
+            new[]
+            {
+                new[] { "Serif / Double", "30", "142.3", "18.7", "94.2" },
+                new[] { "Serif / Single", "30", "156.8", "21.3", "91.8" },
+                new[] { "Sans / Double", "30", "148.1", "19.4", "92.7" },
+                new[] { "Sans / Single", "30", "161.2", "23.1", "89.4" }
+            }
+        ));
+
+        body.Append(sectPr);
+    }
+
+    /// <summary>
+    /// Three-line table (三线表): the gold standard for academic data presentation.
+    /// Only three horizontal lines: top rule (1.5pt), header-bottom rule (0.75pt),
+    /// bottom rule (1.5pt). No vertical lines whatsoever.
+    /// This style focuses the reader on the data, not the grid.
+    /// </summary>
+    private static Table CreateThreeLineTable(string[] headers, string[][] data)
+    {
+        var table = new Table();
+
+        // Table properties: three horizontal rules only
+        var tblPr = new TableProperties(
+            new TableWidth { Width = "5000", Type = TableWidthUnitValues.Pct },
+            new TableBorders(
+                // Top rule: 1.5pt (Size=12 in eighth-points)
+                new TopBorder { Val = BorderValues.Single, Size = 12, Space = 0, Color = "000000" },
+                // Bottom rule: 1.5pt
+                new BottomBorder { Val = BorderValues.Single, Size = 12, Space = 0, Color = "000000" },
+                // No left, right, or inside borders
+                new LeftBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new RightBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new InsideHorizontalBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new InsideVerticalBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" }
+            ),
+            new TableCellMarginDefault(
+                new TopMargin { Width = "28", Type = TableWidthUnitValues.Dxa },
+                new StartMargin { Width = "57", Type = TableWidthUnitValues.Dxa },
+                new BottomMargin { Width = "28", Type = TableWidthUnitValues.Dxa },
+                new EndMargin { Width = "57", Type = TableWidthUnitValues.Dxa }
+            )
+        );
+        table.Append(tblPr);
+
+        // Grid
+        var grid = new TableGrid();
+        int colWidth = 9360 / headers.Length;
+        foreach (var _ in headers)
+            grid.Append(new GridColumn { Width = colWidth.ToString() });
+        table.Append(grid);
+
+        // Header row: bottom border is the header rule (0.75pt = Size 6)
+        var headerRow = new TableRow();
+        foreach (var h in headers)
+        {
+            headerRow.Append(new TableCell(
+                new TableCellProperties(
+                    new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto },
+                    new TableCellBorders(
+                        new BottomBorder { Val = BorderValues.Single, Size = 6, Space = 0, Color = "000000" }
+                    )
+                ),
+                new Paragraph(
+                    new ParagraphProperties(
+                        new SpacingBetweenLines { After = "0", Line = "240", LineRule = LineSpacingRuleValues.Auto },
+                        new Indentation { FirstLine = "0" },
+                        new Justification { Val = JustificationValues.Center }
+                    ),
+                    new Run(
+                        new RunProperties(new Bold()),
+                        new Text(h)
+                    )
+                )
+            ));
+        }
+        table.Append(headerRow);
+
+        // Data rows: no borders (only the table-level top/bottom apply)
+        foreach (var rowData in data)
+        {
+            var row = new TableRow();
+            foreach (var cell in rowData)
+            {
+                row.Append(new TableCell(
+                    new TableCellProperties(
+                        new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto }
+                    ),
+                    new Paragraph(
+                        new ParagraphProperties(
+                            new SpacingBetweenLines { After = "0", Line = "240", LineRule = LineSpacingRuleValues.Auto },
+                            new Indentation { FirstLine = "0" },
+                            new Justification { Val = JustificationValues.Center }
+                        ),
+                        new Run(new Text(cell))
+                    )
+                ));
+            }
+            table.Append(row);
+        }
+
+        return table;
+    }
+
+    /// <summary>Helper to add a body paragraph with first-line indent (academic style).</summary>
+    private static void AddAcademicParagraph(Body body, string text)
+    {
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Normal" }
+            ),
+            new Run(new Text(text))
+        ));
+    }
+
+
+    // ════════════════════════════════════════════════════════════════════════
+    // RECIPE 3: EXECUTIVE BRIEF
+    // ════════════════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Recipe: Executive Brief
+    /// Feel: Premium, minimal, high white-space.
+    /// Best for: Board summaries, investor updates, C-suite communications.
+    ///
+    /// Design rationale:
+    /// - Georgia (serif) body with Helvetica Neue/Arial headings: the serif/sans
+    ///   contrast creates natural visual hierarchy. Georgia was designed specifically
+    ///   for screen readability while maintaining elegance.
+    /// - 1.4x line spacing (336 line units): more generous than corporate, reflecting
+    ///   the premium feel. Executives scan quickly; more air helps their eyes jump.
+    /// - 10pt generous paragraph spacing: creates distinct "thought blocks" that
+    ///   support quick scanning without deep reading.
+    /// - 1.25in margins: extra breathing room signals "we can afford to waste paper."
+    ///   White space IS the luxury. Content-to-margin ratio conveys status.
+    /// - #2C3E50 (dark blue-gray) for all text: sophisticated alternative to black.
+    ///   Warm enough to not feel clinical, dark enough for print legibility.
+    /// - #E74C3C accent red: used sparingly for table headers, creates a single
+    ///   focal point. The contrast draws the eye to data.
+    /// - Dark header table style: inverted header row makes the table structure
+    ///   immediately scannable even in peripheral vision.
+    /// </summary>
+    public static void CreateExecutiveBriefDocument(string outputPath)
+    {
+        using var doc = WordprocessingDocument.Create(outputPath, WordprocessingDocumentType.Document);
+
+        var mainPart = doc.AddMainDocumentPart();
+        mainPart.Document = new Document(new Body());
+        var body = mainPart.Document.Body!;
+
+        // ── Styles ──
+        var stylesPart = mainPart.AddNewPart<StyleDefinitionsPart>();
+        stylesPart.Styles = new Styles();
+        var styles = stylesPart.Styles;
+
+        // DocDefaults: Georgia 11pt, generous spacing
+        styles.Append(new DocDefaults(
+            new RunPropertiesDefault(
+                new RunPropertiesBaseStyle(
+                    new RunFonts
+                    {
+                        // Georgia: designed by Matthew Carter for Microsoft.
+                        // Optimized for screen clarity while retaining serif elegance.
+                        Ascii = "Georgia",
+                        HighAnsi = "Georgia",
+                        EastAsia = "SimSun",
+                        ComplexScript = "Arial"
+                    },
+                    new FontSize { Val = "22" },              // 11pt
+                    new FontSizeComplexScript { Val = "22" },
+                    new Color { Val = "2C3E50" },             // Dark blue-gray — sophisticated
+                    new Languages { Val = "en-US", EastAsia = "zh-CN" }
+                )
+            ),
+            new ParagraphPropertiesDefault(
+                new ParagraphPropertiesBaseStyle(
+                    new SpacingBetweenLines
+                    {
+                        // 1.4x line spacing: the "executive reading" sweet spot.
+                        // More air than corporate (1.15), less than academic (2.0).
+                        // Facilitates scanning behavior common in executive reading.
+                        Line = "336",
+                        LineRule = LineSpacingRuleValues.Auto,
+                        After = "200"   // 10pt after — generous blocks
+                    }
+                )
+            )
+        ));
+
+        // ── Normal style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "Normal",
+            styleName: "Normal",
+            isDefault: true,
+            uiPriority: 0
+        ));
+
+        // ── Heading 1: 22pt Helvetica Neue/Arial, bold ──
+        // Serif body + sans heading = natural hierarchy through font contrast
+        styles.Append(CreateHeadingStyle(
+            level: 1,
+            fontAscii: "Helvetica Neue",
+            fontHAnsi: "Helvetica Neue",
+            sizeHalfPts: "44",            // 22pt
+            color: "2C3E50",
+            bold: false,                  // Large size is enough; bold would be heavy
+            spaceBefore: "480",
+            spaceAfter: "120",
+            uiPriority: 9
+        ));
+
+        // ── Heading 2: 16pt Helvetica Neue/Arial ──
+        styles.Append(CreateHeadingStyle(
+            level: 2,
+            fontAscii: "Helvetica Neue",
+            fontHAnsi: "Helvetica Neue",
+            sizeHalfPts: "32",            // 16pt
+            color: "2C3E50",
+            bold: false,
+            spaceBefore: "360",
+            spaceAfter: "80",
+            uiPriority: 9
+        ));
+
+        // ── Heading 3: 12pt Helvetica Neue/Arial, bold ──
+        styles.Append(CreateHeadingStyle(
+            level: 3,
+            fontAscii: "Helvetica Neue",
+            fontHAnsi: "Helvetica Neue",
+            sizeHalfPts: "24",            // 12pt
+            color: "2C3E50",
+            bold: true,
+            spaceBefore: "240",
+            spaceAfter: "80",
+            uiPriority: 9
+        ));
+
+        // ── ListBullet style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "ListBullet",
+            styleName: "List Bullet",
+            basedOn: "Normal",
+            uiPriority: 36
+        ));
+
+        // ── Caption style ──
+        styles.Append(CreateCaptionStyle(
+            fontSizeHalfPts: "18",        // 9pt
+            color: "7F8C8D",
+            italic: true
+        ));
+
+        // ── Page setup: Letter, 1.25in margins ──
+        // Extra-wide margins = premium feel. The white space says "confidence."
+        var sectPr = new SectionProperties(
+            new WpPageSize { Width = 12240U, Height = 15840U },
+            new PageMargin
+            {
+                Top = 1800, Bottom = 1800,       // 1.25in
+                Left = 1800U, Right = 1800U,     // 1.25in
+                Header = 720U, Footer = 720U, Gutter = 0U
+            }
+        );
+
+        // ── Page numbers: bottom center, 8pt ──
+        AddPageNumberFooter(mainPart, sectPr,
+            alignment: JustificationValues.Center,
+            fontSizeHalfPts: "16",        // 8pt — nearly invisible, as intended
+            color: "BFBFBF",             // Very light gray — page numbers are utility
+            format: PageNumberFormat.Plain
+        );
+
+        // ── Sample content ──
+        AddSampleParagraph(body, "Q3 Performance Summary", "Heading1");
+
+        AddSampleParagraph(body, "Revenue exceeded targets across all segments. The strategic "
+            + "realignment initiated in Q1 is now delivering measurable results. Key metrics "
+            + "are trending positively with strong forward indicators.",
+            "Normal");
+
+        AddSampleParagraph(body, "Key Metrics", "Heading2");
+
+        AddSampleParagraph(body, "The following table summarizes performance against targets. "
+            + "All figures are in millions USD unless otherwise noted.",
+            "Normal");
+
+        // ── Executive table: dark header row (#2C3E50 + white text), no other borders ──
+        body.Append(CreateExecutiveTable(
+            new[] { "Metric", "Target", "Actual", "Variance" },
+            new[]
+            {
+                new[] { "Revenue", "$52.0M", "$54.8M", "+5.4%" },
+                new[] { "EBITDA", "$12.5M", "$13.1M", "+4.8%" },
+                new[] { "Net Margin", "24%", "23.9%", "-0.1pp" }
+            }
+        ));
+
+        AddSampleParagraph(body, "Strategic Outlook", "Heading2");
+
+        AddSampleParagraph(body, "Market conditions remain favorable heading into Q4. "
+            + "The pipeline is robust with several high-value opportunities expected to close "
+            + "before year-end.",
+            "Normal");
+
+        AddSampleParagraph(body, "Risk Factors", "Heading3");
+
+        AddSampleParagraph(body, "Currency headwinds and supply chain constraints represent "
+            + "the primary downside risks. Mitigation strategies are in place for both scenarios.",
+            "Normal");
+
+        body.Append(sectPr);
+    }
+
+    /// <summary>
+    /// Executive table style: dark header row with white text, no other borders.
+    /// The inverted header creates immediate scanability. The borderless body
+    /// lets data breathe. This is the "less is more" school of data presentation.
+    /// </summary>
+    private static Table CreateExecutiveTable(string[] headers, string[][] data)
+    {
+        var table = new Table();
+
+        var tblPr = new TableProperties(
+            new TableWidth { Width = "5000", Type = TableWidthUnitValues.Pct },
+            // No table-level borders at all — the header shading does the work
+            new TableBorders(
+                new TopBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new BottomBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new LeftBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new RightBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new InsideHorizontalBorder { Val = BorderValues.Single, Size = 4, Space = 0, Color = "E0E0E0" },
+                new InsideVerticalBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" }
+            ),
+            new TableCellMarginDefault(
+                new TopMargin { Width = "57", Type = TableWidthUnitValues.Dxa },
+                new StartMargin { Width = "85", Type = TableWidthUnitValues.Dxa },
+                new BottomMargin { Width = "57", Type = TableWidthUnitValues.Dxa },
+                new EndMargin { Width = "85", Type = TableWidthUnitValues.Dxa }
+            )
+        );
+        table.Append(tblPr);
+
+        // Grid
+        var grid = new TableGrid();
+        int colWidth = 9360 / headers.Length;
+        foreach (var _ in headers)
+            grid.Append(new GridColumn { Width = colWidth.ToString() });
+        table.Append(grid);
+
+        // Header row: dark background (#2C3E50) + white text
+        var headerRow = new TableRow();
+        foreach (var h in headers)
+        {
+            headerRow.Append(new TableCell(
+                new TableCellProperties(
+                    new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto },
+                    new Shading
+                    {
+                        Val = ShadingPatternValues.Clear,
+                        Color = "auto",
+                        Fill = "2C3E50"   // Dark blue-gray header
+                    },
+                    // Override borders for header cells
+                    new TableCellBorders(
+                        new TopBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                        new BottomBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                        new LeftBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                        new RightBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" }
+                    )
+                ),
+                new Paragraph(
+                    new ParagraphProperties(
+                        new SpacingBetweenLines { After = "0" }
+                    ),
+                    new Run(
+                        new RunProperties(
+                            new Bold(),
+                            new Color { Val = "FFFFFF" },     // White text on dark header
+                            new RunFonts { Ascii = "Helvetica Neue", HighAnsi = "Helvetica Neue" }
+                        ),
+                        new Text(h)
+                    )
+                )
+            ));
+        }
+        table.Append(headerRow);
+
+        // Data rows: clean, no borders (only inside-H from table properties)
+        foreach (var rowData in data)
+        {
+            var row = new TableRow();
+            foreach (var cell in rowData)
+            {
+                row.Append(new TableCell(
+                    new TableCellProperties(
+                        new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto }
+                    ),
+                    new Paragraph(
+                        new ParagraphProperties(
+                            new SpacingBetweenLines { After = "0" }
+                        ),
+                        new Run(new Text(cell))
+                    )
+                ));
+            }
+            table.Append(row);
+        }
+
+        return table;
+    }
+
+
+    // ════════════════════════════════════════════════════════════════════════
+    // RECIPE 4: CHINESE GOVERNMENT (公文 GB/T 9704)
+    // ════════════════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Recipe: Chinese Government Document (公文)
+    /// Feel: Formal, standardized, authoritative.
+    /// Best for: Government announcements, official communications, regulatory documents.
+    ///
+    /// Design rationale (based on GB/T 9704-2012 standard):
+    /// - 仿宋_GB2312 三号 (16pt): the mandated body font. FangSong is a calligraphic
+    ///   style that balances formality with readability in Chinese typography.
+    /// - 小标宋 二号 (22pt): the mandated title font. 小标宋体 is a specialized display
+    ///   serif used exclusively in government documents for titles.
+    /// - Fixed 28pt line spacing (line="560"): government standard ensures uniform
+    ///   page density of 22 lines per page. Every page looks identical.
+    /// - Margins T:37mm B:35mm L:28mm R:26mm: per GB/T 9704 specification.
+    ///   Asymmetric left-right margins account for binding.
+    /// - Page size A4: Chinese government standard (unlike US Letter).
+    /// - All black text, no decorative elements: government documents derive
+    ///   authority from standardization, not from visual design.
+    /// - Page numbers: bottom center, "-X-" format (e.g., "-3-") per standard.
+    /// - 28 chars per line, 22 lines per page: the density specification.
+    /// </summary>
+    public static void CreateChineseGovernmentDocument(string outputPath)
+    {
+        using var doc = WordprocessingDocument.Create(outputPath, WordprocessingDocumentType.Document);
+
+        var mainPart = doc.AddMainDocumentPart();
+        mainPart.Document = new Document(new Body());
+        var body = mainPart.Document.Body!;
+
+        // ── Styles ──
+        var stylesPart = mainPart.AddNewPart<StyleDefinitionsPart>();
+        stylesPart.Styles = new Styles();
+        var styles = stylesPart.Styles;
+
+        // DocDefaults: 仿宋 16pt (三号), fixed 28pt line spacing
+        styles.Append(new DocDefaults(
+            new RunPropertiesDefault(
+                new RunPropertiesBaseStyle(
+                    new RunFonts
+                    {
+                        // 仿宋_GB2312 is the standard; 仿宋 is the fallback on modern systems
+                        Ascii = "FangSong",
+                        HighAnsi = "FangSong",
+                        EastAsia = "FangSong_GB2312",
+                        ComplexScript = "FangSong"
+                    },
+                    new FontSize { Val = "32" },              // 16pt = 三号 (in half-points)
+                    new FontSizeComplexScript { Val = "32" },
+                    new Color { Val = "000000" },
+                    new Languages { Val = "en-US", EastAsia = "zh-CN" }
+                )
+            ),
+            new ParagraphPropertiesDefault(
+                new ParagraphPropertiesBaseStyle(
+                    new SpacingBetweenLines
+                    {
+                        // Fixed 28pt line spacing per GB/T 9704
+                        // 28pt * 20 = 560 DXA (line units in exact mode)
+                        Line = "560",
+                        LineRule = LineSpacingRuleValues.Exact,
+                        After = "0",
+                        Before = "0"
+                    }
+                )
+            )
+        ));
+
+        // ── Normal style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "Normal",
+            styleName: "Normal",
+            isDefault: true,
+            uiPriority: 0
+        ));
+
+        // ── Title style (小标宋 二号 22pt) ──
+        // Government document title uses a specialized display serif font.
+        // 二号 = 22pt = 44 half-points.
+        var titleStyle = new Style(
+            new StyleName { Val = "heading 1" },
+            new BasedOn { Val = "Normal" },
+            new NextParagraphStyle { Val = "Normal" },
+            new UIPriority { Val = 9 },
+            new PrimaryStyle(),
+            new StyleParagraphProperties(
+                new KeepNext(),
+                new KeepLines(),
+                new Justification { Val = JustificationValues.Center },
+                new SpacingBetweenLines
+                {
+                    Line = "560", LineRule = LineSpacingRuleValues.Exact,
+                    Before = "0", After = "0"
+                },
+                new OutlineLevel { Val = 0 }
+            ),
+            new StyleRunProperties(
+                new RunFonts
+                {
+                    // 小标宋体 is the government standard for titles.
+                    // Falls back to 华文中宋 or SimSun on systems without it.
+                    Ascii = "SimSun",
+                    HighAnsi = "SimSun",
+                    EastAsia = "FZXiaoBiaoSong-B05S",
+                    ComplexScript = "SimSun"
+                },
+                new FontSize { Val = "44" },              // 22pt = 二号
+                new FontSizeComplexScript { Val = "44" },
+                new Color { Val = "000000" }
+            )
+        )
+        { Type = StyleValues.Paragraph, StyleId = "Heading1", Default = false };
+        styles.Append(titleStyle);
+
+        // ── Heading 2: 黑体 三号 (16pt) ──
+        // 黑体 (SimHei) is the standard sans-serif for first-level section headings.
+        var h2Style = new Style(
+            new StyleName { Val = "heading 2" },
+            new BasedOn { Val = "Normal" },
+            new NextParagraphStyle { Val = "Normal" },
+            new UIPriority { Val = 9 },
+            new PrimaryStyle(),
+            new StyleParagraphProperties(
+                new KeepNext(),
+                new KeepLines(),
+                new SpacingBetweenLines
+                {
+                    Line = "560", LineRule = LineSpacingRuleValues.Exact,
+                    Before = "0", After = "0"
+                },
+                new OutlineLevel { Val = 1 }
+            ),
+            new StyleRunProperties(
+                new RunFonts
+                {
+                    Ascii = "SimHei",
+                    HighAnsi = "SimHei",
+                    EastAsia = "SimHei",
+                    ComplexScript = "SimHei"
+                },
+                new FontSize { Val = "32" },              // 16pt = 三号
+                new FontSizeComplexScript { Val = "32" },
+                new Color { Val = "000000" }
+            )
+        )
+        { Type = StyleValues.Paragraph, StyleId = "Heading2", Default = false };
+        styles.Append(h2Style);
+
+        // ── Heading 3: 楷体 三号 (16pt) ──
+        // 楷体 (KaiTi) for second-level section headings.
+        var h3Style = new Style(
+            new StyleName { Val = "heading 3" },
+            new BasedOn { Val = "Normal" },
+            new NextParagraphStyle { Val = "Normal" },
+            new UIPriority { Val = 9 },
+            new PrimaryStyle(),
+            new StyleParagraphProperties(
+                new KeepNext(),
+                new KeepLines(),
+                new SpacingBetweenLines
+                {
+                    Line = "560", LineRule = LineSpacingRuleValues.Exact,
+                    Before = "0", After = "0"
+                },
+                new OutlineLevel { Val = 2 }
+            ),
+            new StyleRunProperties(
+                new RunFonts
+                {
+                    Ascii = "KaiTi",
+                    HighAnsi = "KaiTi",
+                    EastAsia = "KaiTi_GB2312",
+                    ComplexScript = "KaiTi"
+                },
+                new FontSize { Val = "32" },              // 16pt = 三号
+                new FontSizeComplexScript { Val = "32" },
+                new Color { Val = "000000" }
+            )
+        )
+        { Type = StyleValues.Paragraph, StyleId = "Heading3", Default = false };
+        styles.Append(h3Style);
+
+        // ── ListBullet style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "ListBullet",
+            styleName: "List Bullet",
+            basedOn: "Normal",
+            uiPriority: 36
+        ));
+
+        // ── Caption style ──
+        styles.Append(CreateCaptionStyle(
+            fontSizeHalfPts: "32",        // 三号 per standard
+            color: "000000",
+            italic: false                 // Chinese government docs do not use italic
+        ));
+
+        // ── Page setup: A4, GB/T 9704 margins ──
+        // A4 = 210mm x 297mm = 11906 x 16838 DXA
+        // Margins per GB/T 9704: T:37mm B:35mm L:28mm R:26mm
+        //   T: 37mm = 37 * 56.7 ≈ 2098 DXA
+        //   B: 35mm = 35 * 56.7 ≈ 1984 DXA
+        //   L: 28mm = 28 * 56.7 ≈ 1588 DXA
+        //   R: 26mm = 26 * 56.7 ≈ 1474 DXA
+        var sectPr = new SectionProperties(
+            new WpPageSize { Width = 11906U, Height = 16838U },
+            new PageMargin
+            {
+                Top = 2098, Bottom = 1984,
+                Left = 1588U, Right = 1474U,
+                Header = 720U, Footer = 720U, Gutter = 0U
+            }
+        );
+
+        // ── Page numbers: bottom center, "-X-" format, 宋体 四号 (14pt) ──
+        AddPageNumberFooter(mainPart, sectPr,
+            alignment: JustificationValues.Center,
+            fontSizeHalfPts: "28",        // 14pt = 四号
+            color: "000000",
+            format: PageNumberFormat.DashSurrounded,  // -X- format
+            fontName: "SimSun"            // 宋体 for page numbers
+        );
+
+        // ── Sample content ──
+        // Government document title
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Heading1" }
+            ),
+            new Run(new Text("关于加强文档排版规范化管理的通知"))
+        ));
+
+        // Body text
+        body.Append(new Paragraph(
+            new Run(new Text("各有关单位：") { Space = SpaceProcessingModeValues.Preserve })
+        ));
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new Indentation { FirstLine = "640" }   // 2 Chinese characters = 640 DXA at 16pt
+            ),
+            new Run(new Text("为进一步规范公文格式，提高公文质量，根据《党政机关公文格式》"
+                + "（GB/T 9704-2012）的有关规定，现就加强文档排版规范化管理有关事项通知如下。"))
+        ));
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Heading2" }
+            ),
+            new Run(new Text("一、总体要求"))
+        ));
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new Indentation { FirstLine = "640" }
+            ),
+            new Run(new Text("各单位应严格按照国家标准规定的格式要求制作公文，"
+                + "确保公文格式统一、规范、美观。公文用纸统一采用A4型纸，"
+                + "正文使用仿宋体三号字，行间距为固定值28磅。"))
+        ));
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = "Heading3" }
+            ),
+            new Run(new Text("（一）字体要求"))
+        ));
+
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new Indentation { FirstLine = "640" }
+            ),
+            new Run(new Text("标题使用小标宋体二号字，一级标题使用黑体三号字，"
+                + "二级标题使用楷体三号字，正文使用仿宋体三号字。"))
+        ));
+
+        // ── Three-line table (三线表 is also used in Chinese government documents) ──
+        body.Append(CreateThreeLineTable(
+            new[] { "项目", "要求", "字体", "字号" },
+            new[]
+            {
+                new[] { "标题", "居中", "小标宋体", "二号" },
+                new[] { "一级标题", "左对齐", "黑体", "三号" },
+                new[] { "二级标题", "左对齐", "楷体", "三号" },
+                new[] { "正文", "两端对齐", "仿宋体", "三号" }
+            }
+        ));
+
+        body.Append(sectPr);
+    }
+
+
+    // ════════════════════════════════════════════════════════════════════════
+    // RECIPE 5: MINIMAL MODERN
+    // ════════════════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Recipe: Minimal Modern
+    /// Feel: Scandinavian-inspired, lots of white space, geometric.
+    /// Best for: Design documents, creative briefs, tech company communications.
+    ///
+    /// Design rationale:
+    /// - Inter/Segoe UI 10.5pt body: a geometric sans-serif designed for screens.
+    ///   10.5pt is slightly smaller than standard, creating a more designed, intentional
+    ///   feel. The precision of geometric sans-serifs communicates clarity of thought.
+    /// - H1 24pt light weight: large but thin creates a "whisper, don't shout" hierarchy.
+    ///   The size difference does the work; bold weight would be crude.
+    /// - 1.5x line spacing (360 line units): very generous. Combined with 10.5pt body,
+    ///   this creates the characteristic "Scandinavian" feel of lots of air.
+    /// - 12pt paragraph spacing: each paragraph is a distinct visual block separated
+    ///   by substantial white space. This supports the "one idea per paragraph" pattern.
+    /// - 1.5in left/right margins: extreme horizontal compression creates a narrow
+    ///   text column (~5.5in wide, ~65 characters per line). This is the optimal
+    ///   line length for comfortable reading (60-75 chars).
+    /// - #111111 headings, #444444 body: very slight differentiation. The hierarchy
+    ///   comes from size and weight, not color. This is the "less contrast, more
+    ///   sophistication" school.
+    /// - #0066CC accent blue: a single accent color for interactive elements or emphasis.
+    /// - Tables: header-only bottom border, nothing else. Maximum minimalism.
+    /// </summary>
+    public static void CreateMinimalModernDocument(string outputPath)
+    {
+        using var doc = WordprocessingDocument.Create(outputPath, WordprocessingDocumentType.Document);
+
+        var mainPart = doc.AddMainDocumentPart();
+        mainPart.Document = new Document(new Body());
+        var body = mainPart.Document.Body!;
+
+        // ── Styles ──
+        var stylesPart = mainPart.AddNewPart<StyleDefinitionsPart>();
+        stylesPart.Styles = new Styles();
+        var styles = stylesPart.Styles;
+
+        // DocDefaults: Inter/Segoe UI 10.5pt, very generous spacing
+        styles.Append(new DocDefaults(
+            new RunPropertiesDefault(
+                new RunPropertiesBaseStyle(
+                    new RunFonts
+                    {
+                        // Inter is a Google Fonts geometric sans-serif designed for screens.
+                        // Segoe UI is the Windows system font fallback.
+                        Ascii = "Inter",
+                        HighAnsi = "Inter",
+                        EastAsia = "Microsoft YaHei",
+                        ComplexScript = "Segoe UI"
+                    },
+                    new FontSize { Val = "21" },              // 10.5pt — intentionally precise
+                    new FontSizeComplexScript { Val = "21" },
+                    new Color { Val = "444444" },             // Medium gray body — soft and modern
+                    new Languages { Val = "en-US", EastAsia = "zh-CN" }
+                )
+            ),
+            new ParagraphPropertiesDefault(
+                new ParagraphPropertiesBaseStyle(
+                    new SpacingBetweenLines
+                    {
+                        // 1.5x line spacing: generous air for the minimal aesthetic.
+                        // Combined with narrow column width, this creates comfortable reading.
+                        Line = "360",
+                        LineRule = LineSpacingRuleValues.Auto,
+                        After = "240"   // 12pt after — very generous paragraph separation
+                    }
+                )
+            )
+        ));
+
+        // ── Normal style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "Normal",
+            styleName: "Normal",
+            isDefault: true,
+            uiPriority: 0
+        ));
+
+        // ── Heading 1: 24pt light ──
+        // "Light" weight creates elegant, airy hierarchy. The size alone does the work.
+        // Since OpenXML doesn't have a "light" weight, we achieve this by not using bold.
+        // On systems with Inter, the regular weight already appears relatively light.
+        styles.Append(CreateHeadingStyle(
+            level: 1,
+            fontAscii: "Inter",
+            fontHAnsi: "Inter",
+            sizeHalfPts: "48",            // 24pt — large but not bold = "whispering loudly"
+            color: "111111",              // Near-black — just barely softened
+            bold: false,                  // NO bold: the key to the minimal aesthetic
+            spaceBefore: "480",
+            spaceAfter: "120",
+            uiPriority: 9
+        ));
+
+        // ── Heading 2: 16pt regular ──
+        styles.Append(CreateHeadingStyle(
+            level: 2,
+            fontAscii: "Inter",
+            fontHAnsi: "Inter",
+            sizeHalfPts: "32",            // 16pt
+            color: "111111",
+            bold: false,
+            spaceBefore: "360",
+            spaceAfter: "80",
+            uiPriority: 9
+        ));
+
+        // ── Heading 3: 12pt medium ──
+        // "Medium" is between regular and bold. We use bold here as the closest
+        // approximation in OpenXML (true medium weight requires theme fonts).
+        styles.Append(CreateHeadingStyle(
+            level: 3,
+            fontAscii: "Inter",
+            fontHAnsi: "Inter",
+            sizeHalfPts: "24",            // 12pt
+            color: "111111",
+            bold: true,                   // Approximates "medium" weight
+            spaceBefore: "240",
+            spaceAfter: "80",
+            uiPriority: 9
+        ));
+
+        // ── ListBullet style ──
+        styles.Append(CreateParagraphStyle(
+            styleId: "ListBullet",
+            styleName: "List Bullet",
+            basedOn: "Normal",
+            uiPriority: 36
+        ));
+
+        // ── Caption style ──
+        styles.Append(CreateCaptionStyle(
+            fontSizeHalfPts: "18",        // 9pt
+            color: "999999",
+            italic: false                 // Minimal style avoids italic
+        ));
+
+        // ── Page setup: Letter, wide left/right margins, normal top/bottom ──
+        // Wide L/R margins create a narrow text column (~5.5in = ~65 chars per line).
+        // This is the optimal line length for comfortable reading.
+        var sectPr = new SectionProperties(
+            new WpPageSize { Width = 12240U, Height = 15840U },
+            new PageMargin
+            {
+                Top = 1440, Bottom = 1440,       // 1in top/bottom
+                Left = 2160U, Right = 2160U,     // 1.5in left/right — narrow column
+                Header = 720U, Footer = 720U, Gutter = 0U
+            }
+        );
+
+        // ── No page numbers for the minimal aesthetic ──
+        // In production, add page numbers only if document exceeds 5 pages.
+        // For this sample, we omit them entirely — the cleanest look.
+
+        // ── Sample content ──
+        AddSampleParagraph(body, "Design System", "Heading1");
+
+        AddSampleParagraph(body, "A design system is a collection of reusable components "
+            + "and clear standards that can be assembled to build any number of applications. "
+            + "It reduces redundancy, creates consistency, and enables teams to build faster.",
+            "Normal");
+
+        AddSampleParagraph(body, "Typography", "Heading2");
+
+        AddSampleParagraph(body, "Typography is the foundation of any design system. "
+            + "The type scale, spacing, and color choices establish the visual rhythm "
+            + "that all other elements follow.",
+            "Normal");
+
+        AddSampleParagraph(body, "Type Scale", "Heading3");
+
+        AddSampleParagraph(body, "Our type scale uses a 1.5x ratio, creating clear "
+            + "hierarchy without excessive size variation. Each level is visually distinct "
+            + "yet feels part of a cohesive family.",
+            "Normal");
+
+        // ── Minimal table: header bottom border only ──
+        body.Append(CreateMinimalTable(
+            new[] { "Token", "Value", "Usage" },
+            new[]
+            {
+                new[] { "font-size-xs", "10.5pt", "Captions, metadata" },
+                new[] { "font-size-sm", "12pt", "Secondary text" },
+                new[] { "font-size-base", "10.5pt", "Body text" },
+                new[] { "font-size-lg", "16pt", "Section headings" },
+                new[] { "font-size-xl", "24pt", "Page titles" }
+            }
+        ));
+
+        AddSampleParagraph(body, "Table 1 — Type scale tokens", "Caption");
+
+        AddSampleParagraph(body, "Color", "Heading2");
+
+        AddSampleParagraph(body, "Our palette is intentionally restrained. Two grays "
+            + "for text hierarchy, one accent blue for interactive elements, and generous "
+            + "white space as the primary design element.",
+            "Normal");
+
+        body.Append(sectPr);
+    }
+
+    /// <summary>
+    /// Minimal table: only the header row gets a bottom border.
+    /// Everything else is borderless. Maximum restraint.
+    /// The alignment and spacing do all the structural work.
+    /// </summary>
+    private static Table CreateMinimalTable(string[] headers, string[][] data)
+    {
+        var table = new Table();
+
+        var tblPr = new TableProperties(
+            new TableWidth { Width = "5000", Type = TableWidthUnitValues.Pct },
+            // No borders at all at the table level
+            new TableBorders(
+                new TopBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new BottomBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new LeftBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new RightBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new InsideHorizontalBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" },
+                new InsideVerticalBorder { Val = BorderValues.None, Size = 0, Space = 0, Color = "auto" }
+            ),
+            new TableCellMarginDefault(
+                new TopMargin { Width = "40", Type = TableWidthUnitValues.Dxa },
+                new StartMargin { Width = "57", Type = TableWidthUnitValues.Dxa },
+                new BottomMargin { Width = "40", Type = TableWidthUnitValues.Dxa },
+                new EndMargin { Width = "57", Type = TableWidthUnitValues.Dxa }
+            )
+        );
+        table.Append(tblPr);
+
+        // Grid
+        var grid = new TableGrid();
+        int colWidth = 7920 / headers.Length;   // narrower text area due to wide margins
+        foreach (var _ in headers)
+            grid.Append(new GridColumn { Width = colWidth.ToString() });
+        table.Append(grid);
+
+        // Header row: only element with a visible border (bottom only)
+        var headerRow = new TableRow();
+        foreach (var h in headers)
+        {
+            headerRow.Append(new TableCell(
+                new TableCellProperties(
+                    new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto },
+                    new TableCellBorders(
+                        // Single thin bottom border — the only line in the entire table
+                        new BottomBorder { Val = BorderValues.Single, Size = 4, Space = 0, Color = "CCCCCC" }
+                    )
+                ),
+                new Paragraph(
+                    new ParagraphProperties(
+                        new SpacingBetweenLines { After = "0" }
+                    ),
+                    new Run(
+                        new RunProperties(
+                            new Color { Val = "111111" }      // Slightly darker than body
+                        ),
+                        new Text(h)
+                    )
+                )
+            ));
+        }
+        table.Append(headerRow);
+
+        // Data rows: completely borderless
+        foreach (var rowData in data)
+        {
+            var row = new TableRow();
+            foreach (var cell in rowData)
+            {
+                row.Append(new TableCell(
+                    new TableCellProperties(
+                        new TableCellWidth { Width = "0", Type = TableWidthUnitValues.Auto }
+                    ),
+                    new Paragraph(
+                        new ParagraphProperties(
+                            new SpacingBetweenLines { After = "0" }
+                        ),
+                        new Run(new Text(cell))
+                    )
+                ));
+            }
+            table.Append(row);
+        }
+
+        return table;
+    }
+
+
+    // ════════════════════════════════════════════════════════════════════════
+    // SHARED HELPER METHODS
+    // ════════════════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Creates a basic paragraph style with minimal configuration.
+    /// Used for Normal, ListBullet, and other simple styles.
+    /// </summary>
+    private static Style CreateParagraphStyle(
+        string styleId,
+        string styleName,
+        bool isDefault = false,
+        string? basedOn = null,
+        int uiPriority = 0)
+    {
+        var style = new Style(
+            new StyleName { Val = styleName },
+            new UIPriority { Val = uiPriority },
+            new PrimaryStyle()
+        )
+        {
+            Type = StyleValues.Paragraph,
+            StyleId = styleId,
+            Default = isDefault ? true : false
+        };
+
+        if (basedOn != null)
+            style.Append(new BasedOn { Val = basedOn });
+
+        return style;
+    }
+
+    /// <summary>
+    /// Creates a heading style with full formatting configuration.
+    /// All heading styles are based on "Normal" (not chained H2→H1)
+    /// because each heading level has completely different formatting.
+    /// </summary>
+    private static Style CreateHeadingStyle(
+        int level,
+        string fontAscii,
+        string fontHAnsi,
+        string sizeHalfPts,
+        string color,
+        bool bold,
+        string spaceBefore,
+        string spaceAfter,
+        int uiPriority)
+    {
+        var rPr = new StyleRunProperties(
+            new RunFonts
+            {
+                Ascii = fontAscii,
+                HighAnsi = fontHAnsi,
+                EastAsia = "SimSun",
+                ComplexScript = fontAscii
+            },
+            new FontSize { Val = sizeHalfPts },
+            new FontSizeComplexScript { Val = sizeHalfPts },
+            new Color { Val = color }
+        );
+
+        if (bold)
+            rPr.Append(new Bold());
+
+        var style = new Style(
+            new StyleName { Val = $"heading {level}" },
+            new BasedOn { Val = "Normal" },
+            new NextParagraphStyle { Val = "Normal" },
+            new UIPriority { Val = uiPriority },
+            new PrimaryStyle(),
+            new StyleParagraphProperties(
+                new KeepNext(),               // Don't orphan a heading at page bottom
+                new KeepLines(),              // Don't split a heading across pages
+                new SpacingBetweenLines
+                {
+                    Before = spaceBefore,
+                    After = spaceAfter
+                },
+                new OutlineLevel { Val = level - 1 }  // OutlineLevel is 0-based
+            ),
+            rPr
+        )
+        {
+            Type = StyleValues.Paragraph,
+            StyleId = $"Heading{level}",
+            Default = false
+        };
+
+        return style;
+    }
+
+    /// <summary>
+    /// Creates an APA-style heading where hierarchy is expressed through
+    /// bold/italic/centering rather than font size changes.
+    /// All headings remain 12pt — the same as body text.
+    /// </summary>
+    private static Style CreateAcademicHeadingStyle(
+        int level,
+        string sizeHalfPts,
+        bool bold,
+        bool italic,
+        bool centered,
+        string spaceBefore,
+        string spaceAfter)
+    {
+        var rPr = new StyleRunProperties(
+            new RunFonts
+            {
+                Ascii = "Times New Roman",
+                HighAnsi = "Times New Roman",
+                EastAsia = "SimSun",
+                ComplexScript = "Times New Roman"
+            },
+            new FontSize { Val = sizeHalfPts },
+            new FontSizeComplexScript { Val = sizeHalfPts },
+            new Color { Val = "000000" }
+        );
+
+        if (bold)
+            rPr.Append(new Bold());
+        if (italic)
+            rPr.Append(new Italic());
+
+        var pPr = new StyleParagraphProperties(
+            new KeepNext(),
+            new KeepLines(),
+            new SpacingBetweenLines
+            {
+                Before = spaceBefore,
+                After = spaceAfter,
+                Line = "480",
+                LineRule = LineSpacingRuleValues.Auto
+            },
+            // No first-line indent for headings
+            new Indentation { FirstLine = "0" },
+            new OutlineLevel { Val = level - 1 }
+        );
+
+        if (centered)
+            pPr.Append(new Justification { Val = JustificationValues.Center });
+
+        var style = new Style(
+            new StyleName { Val = $"heading {level}" },
+            new BasedOn { Val = "Normal" },
+            new NextParagraphStyle { Val = "Normal" },
+            new UIPriority { Val = 9 },
+            new PrimaryStyle(),
+            pPr,
+            rPr
+        )
+        {
+            Type = StyleValues.Paragraph,
+            StyleId = $"Heading{level}",
+            Default = false
+        };
+
+        return style;
+    }
+
+    /// <summary>
+    /// Creates a Caption style used below tables and figures.
+    /// Captions are typically smaller and/or italic to visually subordinate them.
+    /// </summary>
+    private static Style CreateCaptionStyle(
+        string fontSizeHalfPts,
+        string color,
+        bool italic)
+    {
+        var rPr = new StyleRunProperties(
+            new FontSize { Val = fontSizeHalfPts },
+            new FontSizeComplexScript { Val = fontSizeHalfPts },
+            new Color { Val = color }
+        );
+
+        if (italic)
+            rPr.Append(new Italic());
+
+        return new Style(
+            new StyleName { Val = "caption" },
+            new BasedOn { Val = "Normal" },
+            new UIPriority { Val = 35 },
+            new PrimaryStyle(),
+            new StyleParagraphProperties(
+                new SpacingBetweenLines { After = "120" }
+            ),
+            rPr
+        )
+        {
+            Type = StyleValues.Paragraph,
+            StyleId = "Caption",
+            Default = false
+        };
+    }
+
+    /// <summary>
+    /// Page number format options.
+    /// </summary>
+    private enum PageNumberFormat
+    {
+        /// <summary>Plain number: "1", "2", "3"</summary>
+        Plain,
+        /// <summary>Dash-surrounded: "-1-", "-2-", "-3-" (Chinese government standard)</summary>
+        DashSurrounded
+    }
+
+    /// <summary>
+    /// Adds a footer (or header) with page numbers to the document.
+    ///
+    /// Page numbers use the PAGE simple field code. The footer/header is linked
+    /// to the section via a FooterReference/HeaderReference in SectionProperties.
+    ///
+    /// Architecture:
+    ///   1. Create a FooterPart (or HeaderPart) on the MainDocumentPart
+    ///   2. Add the page number content (Paragraph with SimpleField)
+    ///   3. Get the relationship ID
+    ///   4. Add FooterReference (or HeaderReference) to SectionProperties
+    /// </summary>
+    private static void AddPageNumberFooter(
+        MainDocumentPart mainPart,
+        SectionProperties sectPr,
+        JustificationValues alignment,
+        string fontSizeHalfPts,
+        string color,
+        PageNumberFormat format,
+        bool isHeader = false,
+        string? fontName = null)
+    {
+        var runProps = new RunProperties(
+            new FontSize { Val = fontSizeHalfPts },
+            new FontSizeComplexScript { Val = fontSizeHalfPts },
+            new Color { Val = color }
+        );
+
+        if (fontName != null)
+            runProps.Append(new RunFonts { Ascii = fontName, HighAnsi = fontName, EastAsia = fontName });
+
+        // Build the paragraph content based on format
+        var paragraph = new Paragraph(
+            new ParagraphProperties(
+                new Justification { Val = alignment }
+            )
+        );
+
+        if (format == PageNumberFormat.DashSurrounded)
+        {
+            // "-X-" format: literal dash + PAGE field + literal dash
+            paragraph.Append(new Run(
+                (RunProperties)runProps.CloneNode(true),
+                new Text("-") { Space = SpaceProcessingModeValues.Preserve }
+            ));
+        }
+
+        // PAGE field — inserts the current page number
+        paragraph.Append(new SimpleField(
+            new Run((RunProperties)runProps.CloneNode(true), new Text("1"))
+        )
+        { Instruction = " PAGE " });
+
+        if (format == PageNumberFormat.DashSurrounded)
+        {
+            paragraph.Append(new Run(
+                (RunProperties)runProps.CloneNode(true),
+                new Text("-") { Space = SpaceProcessingModeValues.Preserve }
+            ));
+        }
+
+        if (isHeader)
+        {
+            // Add as header
+            var headerPart = mainPart.AddNewPart<HeaderPart>();
+            headerPart.Header = new Header(paragraph);
+            headerPart.Header.Save();
+
+            string headerPartId = mainPart.GetIdOfPart(headerPart);
+            sectPr.Append(new HeaderReference
+            {
+                Type = HeaderFooterValues.Default,
+                Id = headerPartId
+            });
+        }
+        else
+        {
+            // Add as footer
+            var footerPart = mainPart.AddNewPart<FooterPart>();
+            footerPart.Footer = new Footer(paragraph);
+            footerPart.Footer.Save();
+
+            string footerPartId = mainPart.GetIdOfPart(footerPart);
+            sectPr.Append(new FooterReference
+            {
+                Type = HeaderFooterValues.Default,
+                Id = footerPartId
+            });
+        }
+    }
+
+    /// <summary>
+    /// Helper to add a paragraph with a specific style.
+    /// </summary>
+    private static void AddSampleParagraph(Body body, string text, string styleId)
+    {
+        body.Append(new Paragraph(
+            new ParagraphProperties(
+                new ParagraphStyleId { Val = styleId }
+            ),
+            new Run(new Text(text))
+        ));
+    }
+}