@pptx-studio/model 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @pptx-studio/model
 
+## 0.3.0
+
+### Minor Changes
+
+- ae2e566: A table's style is the one PowerPoint draws. `BUILTIN_TABLE_STYLES` is PowerPoint's own Table
+  Styles gallery: 74 styles, each with its GUID, its name and the `a:tblStyle` PowerPoint writes for
+  it. `tableStyleOf(table)` returns the built-in a table's GUID names, in any case, or `null` for
+  PowerPoint's default 1-pt black grid; nothing in `ppt/tableStyles.xml` changes which. `builtinTableStyle`
+  and `parseTableStyle` read a `CT_TableStyle` into its thirteen parts. An inline `TableStyleRef` now
+  carries its `id`, a style GUID without braces or with padding throws `MODEL_TABLE_ATTR`, and
+  `MODEL_ERROR_CODES` lists every code, including the new `MODEL_TABLE_STYLE`.
+
+  validate adds `V032`, a warning on a table that names no built-in style, and `V033`, refusing the
+  table-style forms PowerPoint repairs.
+
+## 0.2.1
+
+### Patch Changes
+
+- b58dd19: Built with tsdown 0.23. The declarations take a new shape, and the API is unchanged.
+
+  - Every value is exported where it is declared (`export declare function …`), not in a trailing
+    `export { … }`.
+  - The types are exported in one `export type { … }`.
+  - The JavaScript is byte-for-byte what 0.22 emitted.
+  - In geometry, opc, validate and xml, the source maps name fewer symbols.
+
+- Updated dependencies [b58dd19]
+  - @pptx-studio/opc@0.1.3
+  - @pptx-studio/xml@0.1.2
+  - @pptx-studio/geometry@0.1.2
+  - @pptx-studio/paint@0.4.1
+
 ## 0.2.0
 
 ### Minor Changes

package/NOTICE

@@ -27,14 +27,24 @@ Entries are added here at the moment the material lands, not at release time.
       presetShapeDefinitions.xml, 538970 bytes
       sha256 4a762444d8d85876881c02a5b1dedf6f73006fcd8acb7b4e393435615b37c780
 
+  * Microsoft PowerPoint output
+      Written by Microsoft PowerPoint, driven by this project's own scripts.
+
+    @pptx-studio/model contains PowerPoint's 74 built-in table styles: each is
+    the a:tblStyle element PowerPoint writes into ppt/tableStyles.xml, byte for
+    byte, enumerated through PowerPoint's Table Styles gallery and saved by
+    PowerPoint (LEGAL.md, ADR 0063). corpus/ground-truth/table-styles.json holds
+    the same 74.
+
+    The decks in corpus/authored are PowerPoint Blank Presentations, so each
+    carries the Microsoft-generated ppt/theme/theme1.xml and default layouts
+    PowerPoint writes into a new deck (ADR 0009).
+
 --------------------------------------------------------------------------------
 Attributions the plan commits us to, listed so the obligation is visible before
 the code arrives
 --------------------------------------------------------------------------------
 
-  * Pattern fill tiles (sub-phase 2.7) are generated from Mono libgdiplus.
-      libgdiplus - Copyright Novell, Inc. and contributors - MIT
-
   * Metric-compatible substitute fonts ship in a separate package,
     @pptx-studio/fonts-metric-compat, under SIL OFL 1.1 with its own
     OFL.txt and reserved-font-name handling. They are deliberately kept out

package/README.md

@@ -171,15 +171,36 @@ built to disagree with themselves:
   a column is never narrower than its cells' side margins plus 2 pt; and the frame's `a:ext` says
   nothing about the drawn size, which is the grid's sums (76/76 against 62/76).
 
-Cell text is a `TextBody` like any other. The table style a `tableStyleId` names is 4.2; the
-thirteen-part cascade is 4.3; drawing the grid is 4.4.
+Cell text is a `TextBody` like any other.
+
+## A table draws the built-in its GUID names, or none
+
+`BUILTIN_TABLE_STYLES` is PowerPoint's own Table Styles gallery: the 74 styles, in gallery order,
+each with its GUID, its name and the `a:tblStyle` PowerPoint writes for it, byte for byte. They were
+enumerated by driving the gallery itself and read back as PowerPoint serialised them (C8,
+`corpus/ground-truth/table-styles.json`); nothing was transcribed from another implementation.
+
+`tableStyleOf(table)` is the style PowerPoint draws a table with, and C8 found one rule for it
+across 84 packages in three themes:
+
+- The `a:tableStyleId` - or an inline `a:tableStyle`'s `@styleId` - names one of the 74, in any
+  case, and that built-in is drawn (230/230 across every style in two themes).
+- Nothing in `ppt/tableStyles.xml` changes the drawing: a redefined built-in draws PowerPoint's own
+  (7/7), a custom style defined there draws nothing of itself, and `@def` is never applied.
+- Any other id, or none, returns `null`: PowerPoint draws a 1-pt black grid with no fill, whatever
+  the theme (3/3 against the theme's `dk1` and `tx1`).
+
+`builtinTableStyle(id)` parses one of the 74 afresh; `parseTableStyle` reads any `CT_TableStyle`,
+defaulting nothing the file did not say. A GUID without braces or with padding, an edge with neither
+`a:ln` nor `a:lnRef`, and an empty `a:fill` throw: PowerPoint repairs each. The thirteen-part
+cascade is 4.3; drawing the grid is 4.4.
 
 ## What is not here
 
 - Nothing is painted. The renderers are 2.10.
 - The ten-source **text** cascade is 3.1. `Origin` already declares the five members only that
   cascade can produce, so 3.1 adds cases rather than widening a type every consumer has switched on.
-- Table styles, their cascade and their drawing are 4.2 to 4.4; SmartArt is 4.5.
+- The table-style cascade and table drawing are 4.3 and 4.4; SmartArt is 4.5.
 - Commands, undo and history are Phase 5; Change Layout is 7.4. What PowerPoint rewrites when a
   layout changes is recorded in the fixture and not acted on.
 - `a:effectDag` is not modelled — a directed graph of effect primitives PowerPoint has never been
@@ -190,6 +211,7 @@ thirteen-part cascade is 4.3; drawing the grid is 4.4.
 
 `corpus/ground-truth/sheets.json` — 114 probes in 37 packages, sub-phase 2.9.
 `corpus/ground-truth/tables.json` — 82 tables, one package each, and 21 slides PowerPoint authored, sub-phase 4.1.
+`corpus/ground-truth/table-styles.json` — the 74 built-in table styles and 84 probe packages, sub-phase 4.2.
 
 The measurement is a **position**, and PowerPoint reports it directly. C3 and C4 sampled bitmaps
 because a fill and a stroke are pictures; an inheritance is not. A placeholder with no `a:xfrm` of
@@ -205,4 +227,5 @@ against a summary of them, so a rule that drifts fails on the measurements.
 
 See `docs/adr/phase-0-foundation/0007-ground-truth.md`, `docs/adr/phase-2-geometry-and-paint/0021-colour.md`, `docs/adr/phase-2-geometry-and-paint/0022-fills.md`,
 `docs/adr/phase-2-geometry-and-paint/0023-lines.md`, `docs/adr/phase-2-geometry-and-paint/0024-model-parse-and-resolve.md`
-and `docs/adr/phase-4-tables-and-smartart/0056-the-spans-are-the-merge.md`.
+`docs/adr/phase-4-tables-and-smartart/0056-the-spans-are-the-merge.md` and
+`docs/adr/phase-4-tables-and-smartart/0063-a-table-draws-the-built-in-its-guid-names.md`.