invoice-pro:0.4.2

[leonieziechmann]

I am submitting

• a new package
• an update for a package

Description:

Release v0.4.2: Hierarchical Groups, Prepayment & Delivery Addresses 🚀

🏷️ Components & Document Structure

• Hierarchical Item Groups (group): Added a first-class #group() component to structure complex line-items into hierarchical sections with dedicated title headings, item blocks, and automatically calculated subtotals.
• Prepayments (prepayment & PR #38, Issue #37): Introduced #prepayment() to account for customer deposits, advance retainers, and down payments deducted post-tax. Automatically integrates with downstream components (bank-details, payment-goal, and total balances).
• Customizable Modifier Labels (PR #38): Modifiers now support customizable label overrides (auto, none, or custom text/content) with scoped locale fallback resolution.
• Line Item Row Styling (PR #36): Exposed row coloring options (color-header, color-row-odd, color-row-even) in the DIN-5008 theme for fine-grained table stripe styling.
• Cascading input-gross in Inclusive Mode: Resolved effective tax-mode across context hierarchies (line-items, bundle, item, and modifier) so that input-gross defaults to true automatically when invoicing in inclusive/B2C mode.

---

🚚 Shipping & References

• Delivery Address Support (delivery-address): Added support for specifying a distinct delivery address (delivery-address) in invoice(...), complete with DIN-5008 layout integration and ZUGFeRD ram:ShipToTradeParty e-invoicing export.
• Smart References Fallback & B2C Suppression: Invoice reference fields now default to auto, automatically populating supplier tax numbers and VAT IDs in B2B contexts while cleanly suppressing them in B2C transactions.
• Preset References Cleanliness: Presets now include supplier tax identifiers and safely omit any fields resolving to empty/none.

---

📄 Tax & E-Invoicing

• Omit 0% Taxes from Totals Breakdown & Section Collapsing (Issue #39): Taxes with 0% rate (such as tax-exempt-small-biz: true under § 19 UStG, zero-rated goods, or tax exemptions) are now completely omitted from the summary breakdown table to prevent confusing indications of a zero/reduced tax rate on personal and B2C invoices. If no taxable amounts remain, the entire tax breakdown section collapses cleanly.
• Visual Exemption Grounds & Linked Markers: Tax exemption explanations and statutory justifications (e.g. § 19 UStG or reverse charge) are visually rendered in the global information section at the bottom of the invoice without orphan footnote markers.
• ZUGFeRD Monetary Summation & Prepayment Alignment: Enhanced ZUGFeRD XML generation to accurately represent prepaid amounts within ram:SpecifiedTradeSettlementMonetarySummation/ram:PrepaidAmount.

---

🌐 Localization & Compliance

• Statutory German Terminology: Replaced colloquial Mehrwertsteuer with statutory Umsatzsteuer, standardized summary labels to Gesamtbetrag, and expanded gender-inclusive forms.
• Italian Financial & Tax Standards: Replaced Numero fiscale with official Codice Fiscale, updated VAT identifier to Partita IVA, and refined invoice totals to Totale fattura.
• French & Spanish Terminology Updates: Aligned terms with national invoicing guidelines (e.g., Numéro fiscal, Total TTC, updated NIF / NIF-IVA).
• English Summary Clarification: Changed summary balance label to Total to avoid semantic confusion with Amount Due when prepayments or deposits apply.

• ensured that my package is licensed such that users can use and distribute the contents of its template directory without restriction, after modifying them through normal use.