Add PivotFormat.style and enable PivotTable.formats - #53
Merged
Conversation
PivotFormat and PivotArea have existed since 2.4.0, but PivotTable.formats stayed commented out pending a representation for the differential (dxf) styles the format records carry. Carry the differential style INLINE on each PivotFormat as `style?: Style` instead of introducing a JSF dxf table: the JSF Style type is already sparse (every property optional), which is exactly the differential-format semantics, and converters can dedupe inline styles into an OOXML dxfs table at write time. Documents the area-tracking contract on PivotFormat: formats are the durable representation of user formatting on pivot output, re-resolved against the layout on every repaint so formatting follows regions (not cell coordinates) across reshapes. conditionalFormats stays deferred (its model is not finalized). Bump to 2.5.0 (additive).
The version bump belongs in the release flow, not in this PR.
borgar
approved these changes
Jun 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Enable
PivotTable.formatsand addstyle?: StyletoPivotFormat, with each format's differential style inline.JSF
Styleis already sparse (every property optional), which matches the differential-format semantics, so no separate dxf table is introduced; writers can dedupe inline styles into an OOXMLdxfstable.Document the area-tracking contract on
PivotFormat: formats are re-resolved against the current layout, so formatting follows the targeted region rather than cell coordinates when the pivot reshapes.Still defer
conditionalFormats.