@office-kit/pptx 0.17.0 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # @office-kit/pptx
 
+## 0.18.1
+
+### Patch Changes
+
+- c8bf75d: fix: `getParagraphAlignment` and `getTableCellAlignment` returned an invalid `algn` value from a file as if it were a valid alignment
+
+  Both getters cast the attribute straight to `ParagraphAlignment`, so a hand-edited or third-party deck with `algn="bogus"` handed `'bogus'` to typed code. They now parse the value, and anything outside `ST_TextAlignType` reads as `null` (unset), like the other alignment readers already did.
+
+  Their return type is now the new `ParagraphAlignmentToken` (`'l' | 'ctr' | 'r' | 'just' | 'dist' | 'justLow' | 'thaiDist'`) instead of the wider `ParagraphAlignment`. Runtime values are unchanged — these two getters have always returned the spec token, so `setParagraphAlignment(shape, 0, 'center')` reads back as `'ctr'` — but the old type also listed `'center'`, which let `getParagraphAlignment(…) === 'center'` compile although it can never be true. That comparison is now a type error; compare with `'ctr'`, or read the plain-English name from `getParagraphPropertiesEffective` / `getTableCellParagraphs`.
+
+## 0.18.0
+
+### Minor Changes
+
+- 7e89e62: Validate enum inputs at authoring boundaries and throw a descriptive `RangeError`
+  instead of writing invalid PowerPoint XML or silently selecting another mode.
+
+  Affected APIs:
+
+  - Shapes: `addSlideShape` preset and text anchor, including calls through the TSX DSL.
+  - Strokes and fills: `setShapeStrokeDash`, `setShapeStrokeCap`, `setShapeStrokeJoin`,
+    `setShapeStrokeCompound`, `setShapeStrokeArrow` (end, type, width, length), and
+    `setShapeGradientFill` path.
+  - Text: `setShapeAlignment`, `setParagraphAlignment`, `setShapeTextAnchor`,
+    `setShapeTextAutoFit`, `setShapeTextWrap`, `setShapeTextDirection`, `setShapeBullets`,
+    `setParagraphBullet`, and `setShapeText` bullets; `setShapeTextFormat`,
+    `setShapeRunFormat`, and `setShapeParagraphs` formatting and alignment.
+  - Tables: `setTableCellAlignment`, `setTableCellTextFormat`, `setTableCellParagraphs`,
+    `setTableCellTextDirection`, `setTableCellAnchor`, and `setTableCellBorders` dash.
+  - Charts: `addSlideChart` and `setChartSpec` kind, grouping, axes, legend, layout,
+    data labels, series markers, line dash, trendlines, error bars, and chart styles.
+  - Slides: `setSlideSize` type, `setSlideTransition` speed and split orientation,
+    and `setShapeAnimation` effect.
+
+  Previously accepted inputs such as preset `'rounded-rect'`, alignment `'middle'`,
+  stroke dash `'dotted'`, text auto-fit `'shrink'`, and auto-numbering `'bogus'` now
+  throw `RangeError`. Underline and strike strings must be exact XSD tokens:
+  use `'sng'` / `'sngStrike'` (or `true`), not `'single'`. Existing JavaScript
+  `null` values for underline, strike, and cap still remove the corresponding
+  attributes; their TypeScript types are unchanged.
+
+  Unknown chart kinds now throw `RangeError: addSlideChart: kind: … is not one of: …`
+  instead of `Error: unsupported chart kind: …`; `setChartSpec` uses its own API name
+  in the new message. Code that checks the exception class or message should adapt.
+
+  Valid ECMA-376 shape presets remain supported, including presets outside the
+  TypeScript autocomplete list. Rejected bullets and transitions preserve existing
+  content, and rejected table-cell alignment or text-format enums do not create a
+  text body.
+
+### Patch Changes
+
+- 7e89e62: fix: Preserve valid table XML when setting alignment on a covered merged cell whose text was dropped. Recreated text bodies now include the required paragraph, so the alignment is applied and survives saving and reloading.
+- 64fa3c7: Fix nested list indentation when changing a paragraph's level after applying bullets or numbering, including after copying or reloading a presentation. Indentation that differs from the previous level's default pair is preserved.
+
 ## 0.17.0
 
 ### Minor Changes