pict-section-form 1.1.8 → 1.2.0

package/README.md

@@ -291,7 +291,7 @@ Live, runnable example applications - click to open one in your browser:
 | Example | Description |
 |---------|-------------|
 | [Simple Table](https://fable-retold.github.io/pict-section-form/examples/simple_table/) | Tabular layout, reference manifests, and dot-notation access into nested data |
-| [Gradebook](https://fable-retold.github.io/pict-section-form/examples/gradebook/) | Stacked headers, row labels, dynamic columns, row/column selection, and sorting |
+| [Gradebook](https://fable-retold.github.io/pict-section-form/examples/gradebook/) | Stacked headers, row labels, dynamic columns, row/column selection, sorting, and the persistent column chooser |
 | [Scope Mathematics](https://fable-retold.github.io/pict-section-form/examples/scope_mathematics/) | Solvers that reach across sections and the global form scope |
 | [Change Tracking](https://fable-retold.github.io/pict-section-form/examples/change_tracking/) | A change-detecting solver state machine with bidirectional recompute |
 | [NDT Field Test](https://fable-retold.github.io/pict-section-form/examples/ndt_field_test/) | Offline persistence, pick lists, pass/fail row solvers, and charts |

package/docs/Configuration.md

@@ -101,6 +101,7 @@ See [Layouts](Layouts.md) for full details and examples.
 | `RowSelection` | boolean/object | Add row checkboxes; selection persists in form data |
 | `ColumnSelection` | boolean/object | Add column checkboxes; selection persists in form data |
 | `ColumnSorting` | boolean | Add clickable sort controls to the prime header cells (default off) |
+| `ColumnChooser` | boolean/object | Opt-in "Columns" menu to hide/show columns; the hidden set persists in form data |
 
 ### Layout Types
 

package/docs/Layouts.md

@@ -330,6 +330,66 @@ works for both static and dynamic columns (dynamic columns sort by their
 `InformaryDataAddress` value). Values that parse as numbers sort numerically;
 others sort lexically.
 
+### Column Chooser
+
+`ColumnChooser` (off by default - the feature is strictly **opt-in**) puts a
+right-aligned **Columns** button above the table. Clicking it opens a menu of
+checkboxes, one per column; unchecking a column hides it, checking it brings
+it back. When columns are hidden the button reads `Columns (n hidden)` so the
+user always knows part of the table is tucked away.
+
+The hidden set is **stored in the form data** as an array of column hashes
+(default address `<GroupHash>_HiddenColumns`), so - exactly like
+`RowSelection` state - it round-trips with save / load: reload the saved form
+data and the table comes back with the same columns hidden. When a host loads
+form data carrying a different hidden set than the table was rendered with,
+the layout detects the difference on marshal and rebuilds automatically.
+
+Set it to `true` for defaults, or to an object:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `Enabled` | boolean | Set `false` to disable (same as omitting) |
+| `DataAddress` | string | Where the hidden-column-hash array is stored (default `<GroupHash>_HiddenColumns`) |
+| `ButtonLabel` | string | Trigger button text (default `"Columns"`) |
+| `DefaultHiddenColumns` | array | Column hashes hidden until the user changes visibility |
+
+```json
+{
+  "Layout": "Tabular",
+  "RecordSetAddress": "Assignments",
+  "ColumnChooser": true
+}
+```
+
+A column can also start hidden via its descriptor: set
+`PictForm.TabularDefaultHidden: true` and the column renders hidden until the
+user shows it through the menu. Defaults (both forms) apply only while the
+user has made **no** choice - they never write to the form data on their own.
+The first checkbox the user toggles persists the full hidden set explicitly,
+and the menu's **Reset to defaults** button writes the configured default set
+back.
+
+Behavioral guarantees:
+
+- **Hiding never touches record data.** A hidden column's values stay in the
+  record set (same non-destructive invariant as `DynamicColumns`) and reappear
+  when the column is shown again.
+- **The last visible column cannot be hidden** - the checkbox snaps back.
+- **Stacked headers stay aligned.** User-supplied `Headers` rows shrink their
+  `ColumnSpan` past hidden columns (cells covering only hidden columns drop
+  out), and `HeaderGroupTemplate` super-headers re-cluster over the visible
+  columns.
+- **Dynamic columns are choosable too** and persist by their generated hash,
+  so a hidden dynamic column stays hidden across data reloads that regenerate
+  it.
+- **Statically hidden columns** (`PictForm.TabularHidden`) never appear in the
+  menu - they are configuration, not user preference.
+
+The chooser composes with `ColumnSorting`, `RowSelection` / `ColumnSelection`,
+`Headers`, `RowLabels`, and `DynamicColumns`; the gradebook example
+application exercises all of them together.
+
 ## RecordSet Layout
 
 Similar to tabular but renders each record as a full form section rather

package/docs/_version.json

@@ -1,7 +1,7 @@
 {
 	"Name": "pict-section-form",
-	"Version": "1.1.3",
+	"Version": "1.2.0",
 	"Description": "Pict dynamic form sections",
-	"GeneratedAt": "2026-06-05T01:24:25.804Z",
-	"GitCommit": "14a5854"
+	"GeneratedAt": "2026-06-12T03:16:33.010Z",
+	"GitCommit": "877094e"
 }

package/docs/examples/README.md

@@ -101,7 +101,7 @@ node ServeExamples.js
 | [Change Tracking](change%5Ftracking/README.md) | Intermediate | Demonstrates the multi-input evaluate-on-change solver pattern for reacting to several fields at once. | [Launch](examples/change%5Ftracking/index.html) |
 | [Diagram Form Input](diagram%5Fform/README.md) | Intermediate | A pict-section-form field whose InputType is Diagram — boots in view mode (inline SVG, theme-recolorable), toggles into edit mode (Excalidraw) on demand. Demonstrates the themeify pipeline: change the --diagram-* CSS variables and the view-mode SVG visibly re-colors without a re-render. | [Launch](examples/diagram%5Fform/index.html) |
 | [Dynamic Analysis](dynamic%5Fanalysis/README.md) | Advanced | A fruit-nutrition analysis lab with dynamic section injection, solver rewriting, charts, and histograms. | [Launch](examples/dynamic%5Fanalysis/index.html) |
-| [Gradebook](gradebook/README.md) | Intermediate | An advanced tabular recordset with stacked headers, row labels, dynamic columns, row/column selection, and column sorting — built purely from manifest configuration. | [Launch](examples/gradebook/index.html) |
+| [Gradebook](gradebook/README.md) | Intermediate | An advanced tabular recordset with stacked headers, row labels, dynamic columns, row/column selection, column sorting, and a persistent column chooser — built purely from manifest configuration. | [Launch](examples/gradebook/index.html) |
 | [NDT Field Test](ndt%5Ffield%5Ftest/README.md) | Advanced | A nuclear-density-testing field data-collection form with offline persistence and charted results. | [Launch](examples/ndt%5Ffield%5Ftest/index.html) |
 | [RichText Form Input](richtext%5Fform/README.md) | Intermediate | A pict-section-form field whose InputType is RichText — boots in view mode (rendered markdown), toggles into edit mode (CodeMirror) on demand. Demonstrates the AllowImages knob and the pluggable ImageUploader override. | [Launch](examples/richtext%5Fform/index.html) |
 | [Scope Mathematics](scope%5Fmathematics/README.md) | Intermediate | Shows solvers reaching across scopes to read and combine data from other sections of the form. | [Launch](examples/scope%5Fmathematics/index.html) |