[serpentblade]

Summary

Word export on php-docx 1.18 (sections and floating pictures landed upstream in php-docx#10):

• Sections. Each run of pages with the same size, margins, header, footer and layer pictures becomes its own Word section, so a later page keeps its own setup and header instead of taking the first page's. Pages that look alike stay one section joined by page breaks, so the existing examples come out the same. No blank page at a section break, and a section without a header no longer shows the previous one's.
• Layer pictures. An image, QR code or SVG in a page background (before anything else in it), or alone in an overlay place, becomes a floating picture at the position the PDF draws it, repeated on every page through the section's header. Other layer content and PDF templates are still dropped and reported.
• Caveat: Word draws header content behind the body, so an overlay picture sits behind body text rather than over it. Documented in the README and the Word export guide.
• Removed the page-size patch: php-docx now writes any page size.

0.3.0 release prep:

• Core's branch alias is 0.3.x-dev; Laravel and DOCX require papercut/core ^0.3.
• CHANGELOG section renamed to [0.3.0] - unreleased, noting 0.1 and 0.2 were never published.
• READMEs and the site say 0.3 and drop "not yet published"; the Laravel README's path-repository install steps become composer require.
• The papercut vendor name is free on Packagist.

How it was checked

• Core, Laravel and DOCX suites and PHPStan pass; new tests cover sections and layer pictures.
• Positions of layer pictures were compared with core's Paginator output (the PDF's own layout) across 20+ cases (widths, percentages, margins, padding, borders, alignment, anchors, height-only, max-width). All match.
• A review pass found six issues (padding/border, alignment in a sized place, unsized-place widths, percentage plus margin, a leading page break at a section break, empty places); all fixed in the second commit, with tests.
• The examples and a three-section document with both layers pass the OOXML schema check. LibreOffice lays the latter out on the same four pages as the PDF.
• One behaviour change outside layers: a percentage width with margins in the body is now a share of the space after the margins, as the PDF does it.

After merging

1. Put the date on ## [0.3.0] in CHANGELOG.md and add a fresh ## [Unreleased].
2. git tag -s v0.3.0 -m "Papercut 0.3.0" && git push origin main v0.3.0 — release.yml runs every suite, splits and tags the three packages, and creates the GitHub release.
3. Submit papercut-core, then papercut-laravel and papercut-docx, at https://packagist.org/packages/submit.
4. Check in a scratch project: composer require papercut/core papercut/laravel papercut/docx.

🤖 Generated with Claude Code