Demonstrates the three ways a pivot field's item count is derived: a
fractional numeric range, a date grouping, and an ungrouped field taking
its items from the distinct source values.
The fractional interval (0..1 by 0.1) is the case worth showing, since
it is the one where computing bucket boundaries by index rather than by
repeated addition matters: repeated addition drifts past the last
boundary and emits a spurious zero-width "1-1" bucket, which leaves the
pivot field and cache item counts disagreeing.
SampleTest discovers and executes samples automatically, so this runs
as part of the suite.
Shorten @see references to unqualified class names and drop a stray blank
line after the sample header docblock, matching the project's php-cs-fixer
and phpcs rules.
Adds runnable samples under samples/PivotTable demonstrating the pivot table
feature, discovered automatically by the sample browser:
- 01_Create_PivotTable: build a basic pivot (row/column/value fields) from a
source range and save it as Xlsx.
- 02_PivotTable_Page_Filter: add a page (report filter) field.
- 03_PivotTable_Grouping: group a numeric field into ranges and a date field
by quarter.
- 04_Read_PivotTable: write a pivot, load it back, and inspect the pivot table
object model (source, row/column/page fields, value aggregation).
Directory is named PivotTable to match the PascalCase convention used by the
other sample categories (Table, Chart, ...).
saifulislamferoz