pivotkit-react 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/CHANGELOG.md +267 -1
  2. package/README.md +5 -2
  3. package/dist/chunks/{chunk-YITKWZ4L.js → chunk-2RAVX4DO.js} +604 -505
  4. package/dist/chunks/{chunk-ZYEYZSYL.js → chunk-7LERNGUW.js} +36 -2
  5. package/dist/chunks/{chunk-EM23V5GH.js → chunk-E6M57YLL.js} +19 -8
  6. package/dist/chunks/{chunk-RWYHJRQO.js → chunk-JMRTIOX4.js} +17 -7
  7. package/dist/chunks/{chunk-XN55BQ4M.js → chunk-RIOSIYGC.js} +54 -7
  8. package/dist/chunks/{chunk-LEN5RPBM.js → chunk-TR2HROIK.js} +43 -7
  9. package/dist/chunks/chunk-W2KIPREL.js +36 -0
  10. package/dist/chunks/{chunk-6MDAL3IO.js → chunk-XN5HNKJ2.js} +88 -101
  11. package/dist/chunks/{chunk-WB4GKWFQ.js → chunk-YXLANLGL.js} +34 -6
  12. package/dist/chunks/report-run-BZBFOMPF.js +12 -0
  13. package/dist/chunks/{unused-texts-K3VFH65P.js → unused-texts-Y4R67XSN.js} +1 -1
  14. package/dist/chunks/{unused-texts-de-OW4TGIVX.js → unused-texts-de-6YVPTNVS.js} +1 -1
  15. package/dist/echarts.js +38 -156
  16. package/dist/import-ui.js +69 -168
  17. package/dist/index.js +160 -102
  18. package/dist/labels.js +6 -6
  19. package/dist/menu-texts-de.js +1 -1
  20. package/dist/menus.js +778 -277
  21. package/dist/styles.css +207 -93
  22. package/package.json +8 -4
  23. package/types/chart-decorate.d.ts +28 -4
  24. package/types/chart-types.d.ts +2 -4
  25. package/types/echarts.d.ts +1 -1
  26. package/types/export-run.d.ts +42 -4
  27. package/types/field-info.d.ts +3 -10
  28. package/types/filter.d.ts +1 -1
  29. package/types/icons.d.ts +1 -0
  30. package/types/import-host.d.ts +34 -8
  31. package/types/import-labels.d.ts +47 -0
  32. package/types/import-limits.d.ts +6 -0
  33. package/types/import-module.d.ts +1 -1
  34. package/types/import-steps.d.ts +8 -0
  35. package/types/import-ui.d.ts +18 -4
  36. package/types/index.d.ts +76 -17
  37. package/types/labels.d.ts +200 -24
  38. package/types/light-tokens.d.ts +16 -0
  39. package/types/menu-labels.d.ts +43 -14
  40. package/types/menu-ops.d.ts +166 -43
  41. package/types/menu-topics.d.ts +7 -4
  42. package/types/names.d.ts +47 -19
  43. package/types/place.d.ts +24 -0
  44. package/types/print-frame.d.ts +24 -0
  45. package/types/report-run.d.ts +14 -0
  46. package/types/share-actions.d.ts +17 -3
  47. package/types/share.d.ts +13 -17
  48. package/types/sheet-views.d.ts +60 -0
  49. package/types/templates.d.ts +21 -1
  50. package/types/theme.d.ts +2 -16
  51. package/types/tips.d.ts +5 -0
  52. package/types/toolbar-panels.d.ts +9 -6
  53. package/types/unused-texts.d.ts +13 -3
  54. package/types/use-export.d.ts +2 -2
  55. package/types/view-ops.d.ts +65 -6
  56. package/types/view-save.d.ts +10 -6
  57. package/types/view-store.d.ts +21 -11
  58. package/types/chart-layout.d.ts +0 -111
  59. package/types/import-source.d.ts +0 -32
package/CHANGELOG.md CHANGED
@@ -6,6 +6,270 @@ All notable changes to `pivotkit-react` are documented in this file. The format
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.6.0] - 2026-11-14
10
+
11
+ ### Upgrading from 0.5
12
+
13
+ What a host checks; the [upgrade page](https://pivotkit.eize.dev/getting-started/upgrading/#from-0-5) has the details.
14
+
15
+ - Export → **CSV file (.csv)** is called **Table as CSV (.csv)** (German **Tabelle als CSV (.csv)**);
16
+ its label key `exportCsv` and its `onExport` kind `"csv"` stay. Tests or screenshots that look for
17
+ the old text take the new one.
18
+ - `exportData` (Export → Source data) is new and off by default.
19
+ - pivotkit-core moves to `^0.6.0` with it.
20
+
21
+ ### Added
22
+
23
+ - `onSaveTemplate(name, view, { scope, source })` and `onPublishTemplate(name, view, { source })`
24
+ get the data shown as a view file names it (`{ id, name, params }`, `null` without a source id),
25
+ so a host that keeps views can keep a workbook's sheet with them; Publish of a view file or of a
26
+ view of the browser store made for other data gives that data ([#252](https://github.com/eizedev/pivotkit/issues/252)).
27
+ - `exportData` (default `false`): the Export menu's last group **Source data** with **All rows as CSV
28
+ (.csv)** and **All rows as JSON (.json)**: every row of the data shown, every column except derived
29
+ fields, under the fields' own names, values not formatted (`<fileName>-data.csv`,
30
+ `<fileName>-data.json`; `onExport` kinds `"data-csv"`, `"data-json"`). With the view file of
31
+ Download view, `pivotkit render` makes the report again. It holds what the report holds, also
32
+ columns no view places, so it is off unless the host turns it on (docs/security.md, "Source data").
33
+
34
+ ### Changed
35
+
36
+ - The identifier rule of the field list (`isIdentifierName`), the names of groupings and a loaded
37
+ file's source id come from pivotkit-core; nothing changes in the report ([#253](https://github.com/eizedev/pivotkit/issues/253)).
38
+ - Export → **CSV file (.csv)** is called **Table as CSV (.csv)** (German **Tabelle als CSV (.csv)**),
39
+ and its "i" says it is the table, not the rows behind it; its `kind` stays `"csv"`.
40
+ - Depends on `pivotkit-core` `^0.6.0` (was `^0.5.0`) and `pivotkit-report` `^0.2.0` (was `^0.1.0`): a host
41
+ that also lists pivotkit-core updates both together, or it gets two copies.
42
+
43
+ ### Fixed
44
+
45
+ - A view made on a sheet of a loaded workbook other than the first opens on that sheet again after
46
+ the same workbook is loaded anew: views saved, downloaded and linked from a workbook's sheet name it
47
+ in `source.params.sheet`; while a workbook is shown, Views lists the views of its other sheets with
48
+ "Sheet “…”" next to them, and opening one (or such a view file) reads that sheet of the file again
49
+ (a step Undo takes back) before the view is shown. The browser store keeps a view of a name per
50
+ sheet. A view whose sheet the workbook does not have says so ([#252](https://github.com/eizedev/pivotkit/issues/252)).
51
+ - A rule on the name whose text is emptied (select all and delete, the field's ×, or only spaces)
52
+ no longer keeps filtering by its last text while the field looks empty: the rule leaves the view
53
+ a moment later, its row stays as a rule not yet complete, and a new text applies it again in its
54
+ place among the rules, with its blank items kept as before ([#159](https://github.com/eizedev/pivotkit/issues/159)).
55
+
56
+ ## [0.5.0] - 2026-11-13
57
+
58
+ ### Upgrading from 0.4
59
+
60
+ What a host checks; the [upgrade page](https://pivotkit.eize.dev/getting-started/upgrading/#from-0-4) has the details.
61
+
62
+ - **Breaking:** views, view files and links are written in format version 2; pivotkit 0.4 refuses
63
+ them as newer. Version 1 loads with the same result.
64
+ - **Breaking:** dark colours of a host go on `.pk-root[data-pk-theme="dark"]`, not on an attribute of
65
+ the page (`html[data-theme="dark"] .pk-root`): the Excel export and the HTML report read the light
66
+ theme by showing it on the report for a moment, and a rule on the page's attribute would put the
67
+ dark colours into the file.
68
+ - **Breaking:** a page with an import map maps `pivotkit-report` and `pivotkit-core/chart`.
69
+ - The colour scale's default is blue; red, yellow, green come back with `--pk-scale-low: #f8696b`,
70
+ `--pk-scale-mid: #ffeb84`, `--pk-scale-high: #63be7b` (dark: `#c2413f`, `#b39a2e`, `#3f9a5c`).
71
+ `--pk-scale-mid` is no longer set.
72
+ - The label key `filter` is removed (a host's text for it is ignored).
73
+ - The font weights 550 and 650 are 600 (`--pk-weight-strong`).
74
+ - The chart's text is 14 px, not 12 px.
75
+ - Column subtotals are off by default: a start view or template without `totals.colSubtotals` adds
76
+ `totals: { colSubtotals: true }` to keep them.
77
+
78
+ ### Changed
79
+
80
+ - Depends on `pivotkit-core` `^0.5.0` (was `^0.4.0`): a host updates both together, or it gets
81
+ two copies of pivotkit-core.
82
+ - The chart's axes, legend and labels are 14 px or more (`--pk-chart-text-size`, by default
83
+ `var(--pk-small)`), not ECharts' 12 px; the labels are laid out for that size ([#221](https://github.com/eizedev/pivotkit/issues/221)).
84
+ - Export → HTML report takes the report's font size (`--pk-font-size` and `--pk-small` in px, so a
85
+ report on a 16 px page writes a 16 px file) and a host's `--pk-report-title-size`,
86
+ `--pk-print-size` and `--pk-print-small` ([#220](https://github.com/eizedev/pivotkit/issues/220)).
87
+ - A colour scale in the theme's colours runs from light to strong blue (`--pk-scale-low` and
88
+ `--pk-scale-high` are `var(--pk-heat-low)` and `var(--pk-heat-high)`, the heatmap's colours), not
89
+ from red over yellow to green: it says "more", not "good" or "bad". `--pk-scale-mid` is no longer
90
+ set; a host that sets it gets a three-colour scale ([#212](https://github.com/eizedev/pivotkit/issues/212)).
91
+ - The chart's plan, its colours from the tokens and its marks are pivotkit-core's (`chartPlan`,
92
+ `chartThemeFrom`, `pivotkit-core/chart`), so an SVG and a printed report of pivotkit-report draw
93
+ the same chart; the report looks the same. A host page with an import map adds
94
+ `pivotkit-core/chart` next to `pivotkit-core/export`, and `pivotkit-report` (a dependency, loaded on
95
+ the first HTML report, SVG or print of the Export menu) ([#165](https://github.com/eizedev/pivotkit/issues/165)).
96
+ - The table follows pivotkit-core's totals ([#155](https://github.com/eizedev/pivotkit/issues/155), [#156](https://github.com/eizedev/pivotkit/issues/156)): column subtotals off in a new report,
97
+ no empty column and no total rows for fields in Rows without a value, no subtotal for a group of
98
+ one item (its arrow stays). Labels without a value column next to them take up to 85 % of the
99
+ report's width instead of 40 %, so a name on a phone is not broken inside a word.
100
+ - A subtotal column is set apart from its group: a line before it (`--pk-border-strong`) and a
101
+ slightly darker `--pk-total` (light `#eef1f5`, dark `#21252d`; text on it 14.9:1 and 12.8:1, the
102
+ muted header text 5.4:1 and 6.6:1), and its header's tooltip says what it adds up ([#156](https://github.com/eizedev/pivotkit/issues/156)).
103
+ - Options: a total switch that changes nothing is disabled without a tick; every total also needs a
104
+ field in Values ("Needs a field in Values.", `needsValue`). The explanations of the subtotals say
105
+ "subtotal", name a subtotal's label ("North Total") and say that a group of one item has none ([#156](https://github.com/eizedev/pivotkit/issues/156)).
106
+ - The npm description names views as JSON files, as the README and the docs do, instead of templates
107
+ ([#191](https://github.com/eizedev/pivotkit/issues/191)).
108
+ - npm keywords `pivot-grid`, `pivottable` and `excel-export`, the terms people search for ([#172](https://github.com/eizedev/pivotkit/issues/172)).
109
+ - The report reads and writes pivotkit-core's view version 2 ([#165](https://github.com/eizedev/pivotkit/issues/165)):
110
+ the picks of a field are an `in` filter with `not: true` and `blanks`, a rule on the names a `text`
111
+ filter (case and runs of whitespace ignored, `on: "label"` for a field that is not text), "is not",
112
+ "does not contain" and "is not between" the positive operator with `not: true`. Views of version 1
113
+ (stored, shared, the host's) load with the same result. A rule the menus have no word for (a
114
+ loaded view's "is not greater than") is said as "not (…)".
115
+ - A relative range the quick choices do not write (a loaded view's hours, or a second range of a
116
+ field) says what it keeps in words, in English and German, and stays as it is: its row in the
117
+ Filter level can only be removed.
118
+ - A comparison of dates by another precision (a loaded view's) says its unit ("Feb 2026", "from Q2
119
+ 2026") and stays as it is.
120
+ - The view files and links the report writes are of format version 2, with the `$schema`
121
+ `https://pivotkit.eize.dev/schema/view-file-2.json` by default; files and links of version 1 load as
122
+ before. The link's place in the fragment is pivotkit-core's (`linkFragment`, `withLinkFragment`).
123
+ - A view read from a link, a file, pasted JSON or the tab's storage keeps at most 50 filters and is
124
+ at most 1,000,000 characters long (pivotkit-core's `outsideLimits`), or the host's lower limits.
125
+ - The field list's menu has one entry for filtering, **Add to Filters**, instead of two that did almost
126
+ the same ([#157](https://github.com/eizedev/pivotkit/issues/157)): it opens the field's filter at
127
+ once, **Apply** puts the field into Filters with the choice, **Cancel** places nothing. A field on
128
+ Rows or Columns moves to Filters on Apply; a field in Filters opens its filter. "Filter…" is gone,
129
+ and with it the label `filter` (a host's text for it is ignored).
130
+
131
+ ### Added
132
+
133
+ - The token `--pk-chart-text-size`: the chart's text but the title, resolved to px like
134
+ `--pk-chart-title-size`; it reaches the PNG, the SVG and the HTML report too ([#221](https://github.com/eizedev/pivotkit/issues/221)).
135
+ - Corners, the code font, the focus ring and the chart's title and marks as tokens ([#216](https://github.com/eizedev/pivotkit/issues/216)):
136
+ `--pk-radius-xs`, `--pk-radius-mark` and `--pk-radius-icon` (4, 5 and 6 px, four, five and six
137
+ sevenths of `--pk-radius-sm`, so a host that sets `--pk-radius-sm` changes them too),
138
+ `--pk-radius-card` (8 px, the chart's tooltip), `--pk-radius-chart` (the chart's bars and slices,
139
+ `var(--pk-radius-xs)`), `--pk-font-mono` (the JSON text field), `--pk-chart-title-size`
140
+ (`max(16px, var(--pk-font-size))`: 16 px as before up to a 16 px font, as large as the report's text
141
+ above it), `--pk-focus-width` and `--pk-focus-offset` (2 px), `--pk-glow-width` (3 px, the soft ring
142
+ of a focused text field and of a zone a field is dragged over) and `--pk-ring-width` (2 px, the
143
+ inset rings). The report looks the same with the defaults. The chart resolves its title size and
144
+ corners to px, so a host may write them in `em` or `calc()`. A test fails on a corner radius, a
145
+ font family or a ring width written outside the token blocks, and on a radius or a title size set
146
+ from code.
147
+ - Font weights as tokens ([#201](https://github.com/eizedev/pivotkit/issues/201)):
148
+ `--pk-weight-normal` (400), `--pk-weight-medium` (500), `--pk-weight-strong` (600) and
149
+ `--pk-weight-bold` (700), documented in Theming. Every rule uses them, the chart's tooltip, title
150
+ and group labels too, so a host whose font looks too heavy or too light sets four tokens instead of
151
+ overriding selectors. The weights 550 (field chips, the drill-down's path) and 650 (titles, table
152
+ headers) are now 600, to keep the scale at four steps; a font without those faces drew them as 600
153
+ or 700 anyway. The HTML report and print take the report's weights along, in the dark theme too
154
+ (its colours only in the light theme, as before). A test fails on a colour or font weight written
155
+ outside the token blocks.
156
+ - Export → "HTML report (.html)", "Chart image (.svg)" and a group "Print" with "Print or save as
157
+ PDF…": the table as it is shown (and the chart when it is shown) as a page that opens anywhere and
158
+ prints well, the chart as SVG, and the same report in the browser's print dialog, from a sandboxed
159
+ frame a strict Content-Security-Policy allows. `onExport` gets the kinds `html`, `svg` and `print`
160
+ (with the report's HTML; `false` prints nothing). pivotkit-report is a new dependency, loaded on the
161
+ first of these exports ([#165](https://github.com/eizedev/pivotkit/issues/165)).
162
+ - The tip `colSubtotals`: while a Total column shows (column subtotals on, two or more fields in
163
+ Columns, a value, an open column group of two or more items), it says that a Total column adds up the group before it, with the button **Hide column subtotals** ([#156](https://github.com/eizedev/pivotkit/issues/156)).
164
+ - The prop `importLimits` ([#169](https://github.com/eizedev/pivotkit/issues/169)): the limits a file
165
+ loaded with `allowImport` is read and shown with, merged key by key over `limits`. The host's data
166
+ keeps `limits`, so a host can keep uploads small (`importLimits={{ rows: 1000 }}`) without capping
167
+ its own data. Without it a file has `limits`, as before. A key of `importLimits` is not capped by
168
+ `limits`, so a file may also get more. Compared by value, as `limits`.
169
+ - The Filter level edits what view version 2 can say:
170
+ - A rule on the name offers "does not begin with" and "does not end with".
171
+ - **Also keep items without a value (N rows)** under the rules, for a field with blank items and a
172
+ rule on its items or a quick choice: every such rule keeps the blank items (`blanks: "include"`),
173
+ a new rule too; off, none does. Only the blanks stay a pick: Select none, then "(blank)".
174
+ - A date's quick choices count in a unit: **This [unit]** (the units whose current period has
175
+ data) and **Last [N] [unit]**, with **Include the current <unit>** under it while it is set;
176
+ **More choices**, folded: **Next [N] [unit]**, **Before the last [N] [unit]** and **Rolling
177
+ instead of whole calendar periods**. No unit is finer than the grouping (by month: months,
178
+ quarters, years; a date or by day: days and weeks too). Last keeps its count when the unit
179
+ changes while it reaches the data. **Counted back from** offers the first record and a date of
180
+ your own as well; it stands under the choices when the data end before the current period or it
181
+ is not today, else among More choices. A date being typed keeps the last whole date for the
182
+ ranges and says so; left incomplete, the field shows that date again. When Last's current period
183
+ has no data, **Count back from the latest record (date) instead** under it does that in one
184
+ click. A loaded view's next, this, before, rolling, quarter or week range is its quick choice,
185
+ editable there.
186
+ - **Top items**: **Also show items with the same value as the last one** while a top is set
187
+ (`ties: "all"`); another count or measure keeps it. Under it the level says how many items
188
+ show ("7 items shown"), or, for a field below another on its axis, that a group can show more.
189
+ - The menu's search finds the rule on the name by its operators ("does not begin with").
190
+ Texts in English and German. The chip says a range of quarters, weeks or this period by its
191
+ periods ("this quarter (Q4 2026)", "last 3 months, current period excluded (Aug–Oct 2026)"); a
192
+ rolling range counted from a date says its days, not midnight as a time. The unit selects of the
193
+ quick choices are named after their choice ("Unit of “Last …”") and as high as the count beside
194
+ them. In German, a range counted from the latest or first record says "Datensatz", as the menu
195
+ does.
196
+ - The warning about a view's unused parts says when a filter's item is in the data in another case
197
+ (“north”, but “North”), and names a key inside a part of the view by itself. It says when an item
198
+ is longer than 10,000 characters, and how many more problems it does not list.
199
+
200
+ ### Fixed
201
+
202
+ - The warning about unused view parts keeps the view's or host's locale when the pivot fails
203
+ (including the work and group limits), and falls back to English for an invalid locale
204
+ ([#162](https://github.com/eizedev/pivotkit/pull/162)).
205
+ - A workbook and an HTML report exported from the dark theme carry the host's light colours
206
+ (`--pk-scale-*`, `--pk-heat-*`, `--pk-chart-1` and the rest of the light theme): the report reads
207
+ its light theme for the export, without a transition or a frame in between, also inside
208
+ pivotkit-element. Before, they got pivotkit-core's and pivotkit-report's defaults. The HTML report
209
+ takes a host's `--pk-scale-mid` too ([#217](https://github.com/eizedev/pivotkit/issues/217)).
210
+ - A change made while a controlled host is still passing back an earlier view (a host whose view
211
+ goes through its server) builds on the report's own history, also when some of the earlier views
212
+ have come back in between: Undo takes back the user's steps one by one and records no "change
213
+ from outside" ([#141](https://github.com/eizedev/pivotkit/issues/141)).
214
+ - The Excel export writes a colour scale and data bars in the theme's colours the report resolves
215
+ from its tokens (`--pk-scale-low`, `--pk-scale-mid`, `--pk-scale-high`, `--pk-chart-1`), so a
216
+ theme of the host's carries over; a dark report writes the light theme's colours. Before, the
217
+ workbook always had Excel's red, yellow, green ([#212](https://github.com/eizedev/pivotkit/issues/212)).
218
+ - The explanation of an "i" inside a menu (Copy table in Export, a total in Options) is drawn above
219
+ the menu; at the window's right edge the menu in the browser's top layer covered it ([#213](https://github.com/eizedev/pivotkit/issues/213)).
220
+ - A description shown on hover of an "i" stays while the pointer is on its way from the "i" to it
221
+ (beside the "i" towards a description moved aside to stay in the window, or in the gap between
222
+ them) for up to one and a half seconds, so a slow move gets there; a pointer that took more than a
223
+ quarter of a second there closed it ([#213](https://github.com/eizedev/pivotkit/issues/213)).
224
+ - A choice clicked in a field's Top items level keeps the focus, also in Safari, where a click does
225
+ not focus a radio button ([#119](https://github.com/eizedev/pivotkit/issues/119)).
226
+ - The rule between a menu's groups had 1.3:1 contrast in the light theme and 1.2:1 in the dark one,
227
+ and in More, whose groups have no titles, it is the only thing that tells them apart. It is drawn
228
+ in the new token `--pk-rule`, 3:1 against the menu in both themes
229
+ ([#128](https://github.com/eizedev/pivotkit/issues/128)).
230
+ - An open menu or popover follows its anchor when the anchor moves or changes size while it is open
231
+ (the zones' open animation, a transition of the host page)
232
+ ([#120](https://github.com/eizedev/pivotkit/issues/120)).
233
+ - A delayed popover autofocus frame no longer steals focus from a control already in use
234
+ ([#139](https://github.com/eizedev/pivotkit/issues/139)).
235
+ - Outside pie and donut labels appear on the first draw, including their chosen values
236
+ ([#103](https://github.com/eizedev/pivotkit/issues/103)).
237
+ - The menus' text actions drew as plain text in the text colour, so they did not look clickable:
238
+ **Back**, **Reset filter**, **Clear**, **Remove**, **change it above**, **Select all**, **Select
239
+ none**, **Only** and **Swap rows and columns** are in the accent colour and semibold (Back at the
240
+ size of the text around it, the others at the small size); Reset filter, Clear, Remove and Swap
241
+ are greyed out while they would change nothing. A status note's **Undo** is semibold in a tint of
242
+ the accent that reads on the note. The reset that gives buttons and fields the report's font and
243
+ colour had outranked these styles; it no longer does, so the other controls look as designed too:
244
+ the icon buttons (×, "i", a field's menu, a tip's ×, a table row's expand arrow) and the folding
245
+ lines of the Filter level (More choices, the items left out by the rules) are muted until hovered,
246
+ a chip's name is semibold, the folded field list's **Fields** button is bold, the link **Skip to
247
+ the toolbar** (shown only while it has the keyboard focus) is in the accent colour and semibold,
248
+ and the folded layout line is at the small size. A field's menu button is
249
+ no longer faded on top of that, so it keeps 3:1. Text fields and selects keep the report's font
250
+ ([#193](https://github.com/eizedev/pivotkit/issues/193)).
251
+ - The Filter level's **Count back from the latest record (…) instead** looked like a note, not like
252
+ something to click: it is a small button as the level's **Compare** buttons (a border, an icon
253
+ before its words, at least 24 px high, its text wrapping inside it at a narrow width)
254
+ ([#179](https://github.com/eizedev/pivotkit/issues/179)).
255
+ - The note of a file over a limit named the file twice (`big.csv could not be loaded: "big.csv" has
256
+ more than …`) and only `limits.*` as what a host raises, although `importLimits` may set the limit.
257
+ It says the limit in the report's language (English, German), with its key in brackets, and that a
258
+ host can raise this limit: "big.csv could not be loaded: it has more than 1,000 rows (limits.rows):
259
+ load a smaller extract of it, or a host can raise this limit"; other errors of a reader lose the
260
+ file's name in front in both of its forms ([#185](https://github.com/eizedev/pivotkit/issues/185)).
261
+ - A workbook over pivotkit-xlsx's limits `archiveEntries` or `unpackedBytes` is said in the report's
262
+ language too ("book.xlsx could not be loaded: it has more than 524,288,000 bytes unpacked
263
+ (limits.unpackedBytes): …"), with the words in `labels.dataImport.limitWhat`; it showed
264
+ pivotkit-xlsx's English message ([#239](https://github.com/eizedev/pivotkit/issues/239)).
265
+ - A rule on the names ("begins with “ACTIVE DIRECTORY”") keeps the items whose names hold a no-break
266
+ space or other whitespace, and a space typed at the end does not matter
267
+ ([#159](https://github.com/eizedev/pivotkit/issues/159)).
268
+ - The search of a field's item list and of a grouping's item picker finds an item whose label holds
269
+ a no-break space or another run of whitespace when a plain space is typed, and ignores spaces
270
+ typed at the ends ([#159](https://github.com/eizedev/pivotkit/issues/159)). Both searches fold
271
+ text with pivotkit-core's `foldText`.
272
+
9
273
  ## [0.4.0] - 2026-11-11
10
274
 
11
275
  ### Added
@@ -718,7 +982,9 @@ First release.
718
982
  weather (Open-Meteo), countries (World Bank), earthquakes (USGS), Nobel laureates and the release
719
983
  cycles of software products (endoflife.date).
720
984
 
721
- [Unreleased]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.4.0...HEAD
985
+ [Unreleased]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.6.0...HEAD
986
+ [0.6.0]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.5.0...pivotkit-react@0.6.0
987
+ [0.5.0]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.4.0...pivotkit-react@0.5.0
722
988
  [0.4.0]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.3.0...pivotkit-react@0.4.0
723
989
  [0.3.0]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.2.0...pivotkit-react@0.3.0
724
990
  [0.2.0]: https://github.com/eizedev/pivotkit/compare/pivotkit-react@0.1.0...pivotkit-react@0.2.0
package/README.md CHANGED
@@ -4,7 +4,9 @@ The pivot report builder of [pivotkit](https://pivotkit.eize.dev/) as a React 18
4
4
  `<PivotReport>`: a searchable field list, four drop zones (Rows, Columns, Values, Filters) with drag
5
5
  and drop and a menu on every field, table and chart (Apache ECharts), filters with value counts,
6
6
  drill-down to the rows behind a value, undo and redo, saved and shared views as JSON files, and
7
- Excel, CSV and PNG export. Excel's PivotTable is the reference; the engine is
7
+ Excel, CSV, HTML report, PNG and SVG export and printing. Where the host turns them on, people load
8
+ their own CSV, JSON or Excel file with a preview (`allowImport`) and download the rows behind the
9
+ report for the command line (`exportData`). Excel's PivotTable is the reference; the engine is
8
10
  [pivotkit-core](https://www.npmjs.com/package/pivotkit-core).
9
11
 
10
12
  ![The pivot report with real weather data: field list, the Filters, Columns, Rows and Values zones, and the average temperature of 14 cities by month as a colour scale](https://pivotkit.eize.dev/assets/screenshots/report-light.png)
@@ -26,7 +28,7 @@ npm install pivotkit-react react react-dom echarts
26
28
 
27
29
  TypeScript declarations are included. pivotkit-core (a caret range) and @dnd-kit come with the
28
30
  package. In 0.x a caret range spans patch
29
- versions only (`^0.4.0` is 0.4.x): an app that also imports pivotkit-core itself must use a version
31
+ versions only (`^0.y.z` is 0.y.z and later 0.y patches): an app that also imports pivotkit-core itself must use a version
30
32
  inside that range, since npm shares one copy only when the ranges overlap.
31
33
 
32
34
  ## Example
@@ -54,6 +56,7 @@ the data; it cannot run code.
54
56
  | Topic | Page |
55
57
  | --- | --- |
56
58
  | Getting started: install, first report, saved views, clicks | [Getting started with React](https://pivotkit.eize.dev/getting-started/react/) |
59
+ | Loading files and the source data | [Load your own data](https://pivotkit.eize.dev/use/load-data/), [the table or the rows](https://pivotkit.eize.dev/use/export/#the-table-or-the-rows-behind-it) |
57
60
  | Bundlers, import maps, PowerShell Universal | [Bundlers and import maps](https://pivotkit.eize.dev/getting-started/react/#bundlers-and-import-maps), [PowerShell Universal](https://pivotkit.eize.dev/getting-started/react/#powershell-universal) |
58
61
  | Every prop | [Props](https://pivotkit.eize.dev/reference/react/#props), [props in detail](https://pivotkit.eize.dev/reference/react/#props-in-detail) |
59
62
  | Controlled and uncontrolled | [Controlled and uncontrolled](https://pivotkit.eize.dev/reference/react/#controlled-and-uncontrolled) |