@svgrid/enterprise 2.6.4 → 3.0.0

package/dist/designer/assets/validate-h-aslRV9.js

@@ -0,0 +1 @@
+var e=`https://svgrid.com/docs/getting-started/3-data-and-columns/`;function t(e,n=[]){for(let r of e)r.columns?.length?t(r.columns,n):n.push(r);return n}function n(n){let i=[],a=t(n.columns??[]),o=(n.data??[]).slice(0,10);if(o.length){let t=new Set;for(let e of o)if(e&&typeof e==`object`)for(let n of Object.keys(e))t.add(n);for(let n of a){let a=n.field;if(!a||n.fieldFn||t.has(a))continue;let o=r(a,[...t]);i.push(`[svgrid] Column field "${a}" does not exist on your row data, so that column renders empty.${o?` Did you mean "${o}"?`:``} Available keys: ${[...t].slice(0,12).join(`, `)}. See ${e}`)}}let s=new Map;for(let e of a){let t=e.id??e.field;t&&s.set(t,(s.get(t)??0)+1)}for(let[t,n]of s)n>1&&i.push(`[svgrid] ${n} columns share the id "${t}". Column state (sorting, filtering, pinning, width) is keyed by id, so they will act as one. Give each an explicit \`id\`. See ${e}`);let c=n.pageable===void 0&&n.showPagination===void 0;n.pageSize!==void 0&&c&&i.push("[svgrid] `pageSize` is set but pagination was never turned on, so it has no effect and every row renders. Add `pageable` to switch the pager on."),!(n.sortable===!0||n.features?.rowSortingFeature)&&a.some(e=>e.sortable===!0)&&i.push("[svgrid] A column sets `sortable: true`, but sorting is not enabled on the grid, so its header does nothing. Add `sortable` to <SvGrid> (it registers the sorting feature for you).");let l=new Set;for(let e of a){let t=e.id??e.field;t&&l.add(t)}for(let e of n.groupBy??[]){if(l.has(e))continue;let t=r(e,[...l]);i.push(`[svgrid] \`groupBy\` refers to column "${e}", which does not exist, so that grouping level is ignored.${t?` Did you mean "${t}"?`:``} Column ids: ${[...l].slice(0,12).join(`, `)}`)}let u=n.treeData?.column;if(u&&!l.has(u)&&i.push(`[svgrid] \`treeData.column\` refers to column "${u}", which does not exist, so the expander falls back to the first visible column.`),o.length&&n.treeData){let e=new Set;for(let t of o)if(t&&typeof t==`object`)for(let n of Object.keys(t))e.add(n);let t=n.treeData.parentField;if(t&&!e.has(t)){let n=r(t,[...e]);i.push(`[svgrid] \`treeData.parentField\` is "${t}", which is not on your row data, so every row becomes a root and no hierarchy appears.${n?` Did you mean "${n}"?`:``}`)}let a=n.treeData.idField;a&&!e.has(a)&&i.push(`[svgrid] \`treeData.idField\` is "${a}", which is not on your row data, so parent lookups cannot match and the tree stays flat.`)}return(n.initialColumnPinning?.left?.length??0)+(n.initialColumnPinning?.right?.length??0)>0&&n.columnVirtualization!==!1&&i.push("[svgrid] `initialColumnPinning` is set while column virtualization is on (its default), so the pinned columns will not stick - the virtualizer recycles column nodes. Add `columnVirtualization={false}`."),n.externalPagination===!0&&n.rowCount===void 0&&i.push("[svgrid] `externalPagination` is on but `rowCount` is not set, so the pager cannot know how many pages exist. Pass the server total as `rowCount`."),n.externalSort===!0&&!n.onSortingChange&&i.push("[svgrid] `externalSort` is on but there is no `onSortingChange` handler, so clicking a header changes nothing - the grid stopped sorting and nobody is listening. Add `onSortingChange` and re-fetch in your handler."),n.externalFilter===!0&&!n.onFiltersChange&&i.push("[svgrid] `externalFilter` is on but there is no `onFiltersChange` handler, so filtering the grid changes nothing. Add `onFiltersChange` and re-fetch in your handler."),i}function r(e,t){let n,r=1/0;for(let a of t){let t=i(e.toLowerCase(),a.toLowerCase());t<r&&(r=t,n=a)}let a=Math.min(3,Math.floor(e.length/3)+1);return r<=a?n:void 0}function i(e,t){if(e===t)return 0;let n=Array(t.length+1);for(let e=0;e<=t.length;e++)n[e]=e;for(let r=1;r<=e.length;r++){let i=n[0];n[0]=r;for(let a=1;a<=t.length;a++){let o=Math.min(n[a]+1,n[a-1]+1,i+(e[r-1]===t[a-1]?0:1));i=n[a],n[a]=o}}return n[t.length]}export{n as validateGridConfig};

package/dist/designer/index.html

@@ -4,29 +4,34 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>SvGrid Studio - Designer</title>
-    <script type="module" crossorigin src="./assets/index-DxBZuosR.js"></script>
+    <script type="module" crossorigin src="./assets/index-zUBix-JQ.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/rolldown-runtime-Dd_uD5pT.js">
     <link rel="modulepreload" crossorigin href="./assets/disclose-version-CIm4S9xS.js">
     <link rel="modulepreload" crossorigin href="./assets/export-format-DwjuTfrQ.js">
-    <link rel="modulepreload" crossorigin href="./assets/js-scroller.svelte-03aI6ovu.js">
-    <link rel="modulepreload" crossorigin href="./assets/SvGrid.helpers-C6wxF55r.js">
-    <link rel="modulepreload" crossorigin href="./assets/editor-registry-BB1Qb5mp.js">
-    <link rel="modulepreload" crossorigin href="./assets/dismissable-2EZKoens.js">
+    <link rel="modulepreload" crossorigin href="./assets/js-scroller.svelte-Bhxqb3-c.js">
+    <link rel="modulepreload" crossorigin href="./assets/preload-helper-CG0n22O7.js">
+    <link rel="modulepreload" crossorigin href="./assets/SvField-BsqiA5me.js">
+    <link rel="modulepreload" crossorigin href="./assets/date-format-4DJvNtG2.js">
     <link rel="modulepreload" crossorigin href="./assets/popover-CUkLsvRX.js">
-    <link rel="modulepreload" crossorigin href="./assets/SvDateTimePicker-DOBYyLeN.js">
     <link rel="modulepreload" crossorigin href="./assets/SvGridDropdown-CAYG7Y-O.js">
+    <link rel="modulepreload" crossorigin href="./assets/dismissable-BO547MH9.js">
+    <link rel="modulepreload" crossorigin href="./assets/SvDateTimePicker-BdioTrJQ.js">
+    <link rel="modulepreload" crossorigin href="./assets/editor-registry-BjP16H0v.js">
     <link rel="modulepreload" crossorigin href="./assets/easing-zaypKrr0.js">
     <link rel="modulepreload" crossorigin href="./assets/chart-DHEgt4lN.js">
     <link rel="modulepreload" crossorigin href="./assets/SvGridChart-BEDNTdc5.js">
-    <link rel="modulepreload" crossorigin href="./assets/src-Dn1Axx6T.js">
-    <link rel="modulepreload" crossorigin href="./assets/SvListBox-D-_I_Aff.js">
-    <link rel="stylesheet" crossorigin href="./assets/dismissable-BF-9TJSd.css">
-    <link rel="stylesheet" crossorigin href="./assets/SvDateTimePicker-Cygij-dr.css">
+    <link rel="modulepreload" crossorigin href="./assets/src-BoYyigAC.js">
+    <link rel="modulepreload" crossorigin href="./assets/SvDateRangeInput-CVn-yqrQ.js">
+    <link rel="modulepreload" crossorigin href="./assets/SvListBox-CVYQcLX9.js">
+    <link rel="stylesheet" crossorigin href="./assets/SvField-BF-9TJSd.css">
+    <link rel="stylesheet" crossorigin href="./assets/date-format-Dzy4mTGh.css">
     <link rel="stylesheet" crossorigin href="./assets/SvGridDropdown-Crwb2P3Q.css">
+    <link rel="stylesheet" crossorigin href="./assets/SvDateTimePicker-CY8TK4BT.css">
     <link rel="stylesheet" crossorigin href="./assets/SvGridChart-Vu4Nvjiv.css">
-    <link rel="stylesheet" crossorigin href="./assets/src-D8qr49rE.css">
-    <link rel="stylesheet" crossorigin href="./assets/SvListBox-BMSfFJJT.css">
-    <link rel="stylesheet" crossorigin href="./assets/index-BfzoL904.css">
+    <link rel="stylesheet" crossorigin href="./assets/src-B7DNcoQK.css">
+    <link rel="stylesheet" crossorigin href="./assets/SvDateRangeInput-BV5OXYQ2.css">
+    <link rel="stylesheet" crossorigin href="./assets/SvListBox-DgN8kvjt.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-Cp7fDJ3b.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/export.d.ts

@@ -11,6 +11,7 @@ import type { ConditionalFormat } from '@svgrid/grid/format';
  *   - `csv` / `tsv` / `html` / `json` / `xml` / `md` native, no peer deps.
  */
 export type ExportFormat = 'xlsx' | 'xls' | 'pdf' | 'csv' | 'tsv' | 'html' | 'json' | 'xml' | 'md';
+/** One column in an export: which field to read, and how to label and format it. */
 export type ExportColumn<TData = RowData> = {
     /** Data field name on the row object. */
     field: string;
@@ -111,6 +112,7 @@ export type ExportHeaderFooterLine = {
     center?: string;
     right?: string;
 };
+/** One tab of a multi-sheet workbook. Only formats with sheets (xlsx, xls) use these. */
 export type ExportSheet<TData> = {
     /** Sheet/tab label. Required. */
     label: string;
@@ -129,6 +131,7 @@ export type ExportSheet<TData> = {
  *   an explicit array - export exactly these.
  */
 export type ExportRowSource<TData> = ReadonlyArray<TData> | 'displayed' | 'selected' | 'all';
+/** Everything `exportGrid` accepts: the format, the filename, which rows and columns, and per-format tuning. */
 export type ExportOptions<TData> = {
     format: ExportFormat;
     /** Base filename (extension is appended if missing). Defaults to "grid". */
@@ -304,6 +307,7 @@ export declare function buildGroupedPdfBody<TData extends RowData>(cols: Readonl
 export declare function exportGrid<TFeatures extends TableFeatures, TData extends RowData>(api: SvGridApi<TFeatures, TData>, opts: ExportOptions<TData>): Promise<ExportResult | undefined>;
 /** Native formats that can be placed on the clipboard. */
 export type ClipboardFormat = 'csv' | 'tsv' | 'html' | 'json' | 'xml' | 'md';
+/** Options for copying a range to the clipboard, as opposed to writing a file. */
 export type ClipboardExportOptions<TData> = {
     /** Clipboard payload format. Default 'tsv' (pastes cleanly into Excel / Sheets). */
     format?: ClipboardFormat;

package/dist/import.d.ts

@@ -24,7 +24,9 @@
  * `print`, so unlicensed evaluation works but emits a one-time nudge.
  */
 import type { RowData, SvGridApi, TableFeatures } from '@svgrid/grid';
+/** Source formats `importGrid` reads. `'auto'` picks one from the file extension. */
 export type ImportFormat = 'xlsx' | 'csv' | 'tsv' | 'json' | 'auto';
+/** Maps a source header to the row field it populates, for files whose columns do not match your data. */
 export type ImportColumnMap = Record<string, string>;
 /**
  * Declared data type per target field. When `columnTypes` is set on
@@ -33,6 +35,7 @@ export type ImportColumnMap = Record<string, string>;
  * stricter than the ad-hoc "looks like a number" fallback.
  */
 export type ImportFieldType = 'string' | 'number' | 'integer' | 'boolean' | 'date' | 'datetime' | 'json';
+/** Per-field coercion, so a column of `"42"` strings arrives as numbers. */
 export type ImportColumnTypes = Record<string, ImportFieldType>;
 /**
  * The slice of a grid column the auto-mapper needs: its target `field`,
@@ -58,6 +61,7 @@ export type ImportProgress = {
     /** Total rows this phase will process (0 when unknown, e.g. mid-parse). */
     total: number;
 };
+/** One row that failed validation, with the reason and where it came from. */
 export type ImportRowError = {
     /** 0-based row index in the SOURCE file (excluding the header). */
     rowIndex: number;
@@ -65,10 +69,12 @@ export type ImportRowError = {
     field: string;
     message: string;
 };
+/** Per-row check run during import. Return an error message to reject the row, or nothing to accept it. */
 export type ImportValidator<TData> = (row: TData, rowIndex: number) => Array<{
     field: string;
     message: string;
 }>;
+/** Everything `importGrid` accepts: the format, the column mapping and types, and the validator. */
 export type ImportOptions<TData> = {
     /** The file to read. A `File`/`Blob` works for xlsx; a string is treated as
      *  inline CSV/TSV/JSON text. */
@@ -140,6 +146,7 @@ export type ImportOptions<TData> = {
     /** Progress callback for large files (parse + map phases). */
     onProgress?: (progress: ImportProgress) => void;
 };
+/** The outcome of an import: the rows that parsed, and the ones that did not with their errors. */
 export type ImportResult<TData> = {
     /** Source headers as found in the file, in their original order. */
     headers: string[];

package/dist/index.d.ts

@@ -9,6 +9,9 @@ export { default as SvImportDialog } from './SvImportDialog.svelte';
 export { installEnterprise, type EnterpriseGridApi, type EnterpriseAIApi, type EnterprisePivotApi } from './install';
 export { enableSchedulerView, SvGridScheduler } from './scheduler';
 export { enableBoardView, SvGridBoard } from './board';
+export { enableSelectionBar, SvGridSelectionBar } from './selection-bar';
+export { applyBulkEdit, bulkEditableFields, bulkEditInitialValues, coerceBulkValue, type BulkEditField, type BulkEditResult } from './bulk-edit';
+export { default as SvGridBulkEditDrawer } from './SvGridBulkEditDrawer.svelte';
 export { enablePivot } from './pivot-enable';
 export { enableAdvancedFilter } from './advanced-filter-enable';
 export { default as SvAdvancedFilter } from './SvAdvancedFilter.svelte';

package/dist/index.js

@@ -17,6 +17,14 @@ export { enableSchedulerView, SvGridScheduler } from './scheduler';
 // Kanban board view (Pro). `enableBoardView()` registers the renderer so
 // `<SvGrid board={...}>` shows lanes of cards. Config types live in @svgrid/grid.
 export { enableBoardView, SvGridBoard } from './board';
+// Bulk-action bar over the row selection (Pro). `enableSelectionBar()` registers
+// the renderer so `<SvGrid selectionBar={...}>` floats a bar over the grid while
+// rows are selected. The prop + its config types live in @svgrid/grid.
+export { enableSelectionBar, SvGridSelectionBar } from './selection-bar';
+// Bulk edit engine behind the bar's `editFields` button - exported so an app
+// can drive the same write from its own UI.
+export { applyBulkEdit, bulkEditableFields, bulkEditInitialValues, coerceBulkValue } from './bulk-edit';
+export { default as SvGridBulkEditDrawer } from './SvGridBulkEditDrawer.svelte';
 // In-grid pivot mode (Pro). `enablePivot()` registers the pivot engine so
 // `<SvGrid pivot={...}>` renders a pivot table in place of the flat table.
 export { enablePivot } from './pivot-enable';

package/dist/install.d.ts

@@ -4,6 +4,7 @@ import { type PrintOptions } from './print';
 import { type ImportOptions, type ImportResult } from './import';
 import { type AIChartOptions, type AIChartPlan, type AIFilterOptions, type AIFilterResult, type AISmartFillOptions, type AISmartFillResult, type AISummarizeOptions, type AISummary, type AIClassifyOptions, type AIClassifyResult, type AIExportOptions, type AIExportPlan, type AIAnomalyOptions, type AIAnomalyResult } from '@svgrid/grid';
 import { type PivotConfig, type PivotResult } from './pivot';
+/** The `api.ai.*` namespace added by the enterprise install. */
 export type EnterpriseAIApi<TData extends RowData> = {
     /** Natural-language -> filter + sort plan (and optionally apply it). */
     filter(query: string, opts?: AIFilterOptions): Promise<AIFilterResult>;
@@ -21,6 +22,7 @@ export type EnterpriseAIApi<TData extends RowData> = {
     chart(query: string, opts?: AIChartOptions): Promise<AIChartPlan>;
     readonly _rowType?: TData;
 };
+/** The `api.pivot.*` namespace added by the enterprise install. */
 export type EnterprisePivotApi<TFeatures extends TableFeatures, TData extends RowData> = {
     /**
      * Build a pivot row/column model from the grid's current data. Returns
@@ -36,6 +38,7 @@ export type EnterprisePivotApi<TFeatures extends TableFeatures, TData extends Ro
      */
     buildFrom<TIn extends RowData>(data: ReadonlyArray<TIn>, config: PivotConfig<TIn>): PivotResult<TFeatures>;
 };
+/** The grid API plus everything enterprise adds - what `installEnterprise` hands back. */
 export type EnterpriseGridApi<TFeatures extends TableFeatures, TData extends RowData> = SvGridApi<TFeatures, TData> & {
     /** Export the current visible rows to the chosen format. Returns the built
      *  file ({@link ExportResult}) for the dependency-free paths (undefined for

package/dist/install.js

@@ -9,6 +9,7 @@ import { aiFilter, aiSmartFill, aiSummarize, aiClassify, aiExport, aiFindAnomali
 import { createPivotModel, } from './pivot';
 import { enableSchedulerView } from './scheduler';
 import { enableBoardView } from './board';
+import { enableSelectionBar } from './selection-bar';
 import { enableAdvancedFilter } from './advanced-filter-enable';
 import { enablePivot } from './pivot-enable';
 /**
@@ -42,6 +43,7 @@ export function installEnterprise(api) {
     enableSchedulerView();
     // Register the Kanban board view (no-op without the `board` prop).
     enableBoardView();
+    enableSelectionBar();
     // Register the export engine so built-in AI exports (aiExport) can write the
     // enterprise formats (xlsx / pdf / ...); free grids without it get the plan only.
     registerExportProvider(exportGrid);

package/dist/node/studio.js

@@ -3169,6 +3169,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "block",
 				"label": "Block",
 				"type": "boolean",
+				"default": false,
 				"description": "Fill the container instead of the control's own default width. A default width is right for a control sitting on its own; in a form grid a row of inputs each stopping at a different width reads as broken.",
 				"group": "appearance"
 			},
@@ -6138,6 +6139,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "block",
 				"label": "Block",
 				"type": "boolean",
+				"default": false,
 				"description": "Fill the container instead of the control's own default width. A default width is right for a control sitting on its own; in a form grid a row of inputs each stopping at a different width reads as broken.",
 				"group": "appearance"
 			},
@@ -6326,6 +6328,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "block",
 				"label": "Block",
 				"type": "boolean",
+				"default": false,
 				"description": "Fill the container instead of the control's own default width. A default width is right for a control sitting on its own; in a form grid a row of inputs each stopping at a different width reads as broken.",
 				"group": "appearance"
 			},
@@ -6520,6 +6523,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "block",
 				"label": "Block",
 				"type": "boolean",
+				"default": false,
 				"description": "Fill the container instead of the control's own default width. A default width is right for a control sitting on its own; in a form grid a row of inputs each stopping at a different width reads as broken.",
 				"group": "appearance"
 			},
@@ -8179,6 +8183,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "block",
 				"label": "Block",
 				"type": "boolean",
+				"default": false,
 				"description": "Fill the container instead of the control's own default width. A default width is right for a control sitting on its own; in a form grid a row of inputs each stopping at a different width reads as broken.",
 				"group": "appearance"
 			},
@@ -8663,6 +8668,13 @@ var GENERATED_UI_SURFACE = {
 				"description": "Right-click context menu. `true` shows the default item set (copy, cut, paste, clear, insert row above/below, remove row, remove column). Pass an array to customize: strings are built-in keys, `\"separator\"` is a divider, and objects are custom items. Omitted/`false` disables the menu (native browser menu shows instead).",
 				"group": "common"
 			},
+			{
+				"key": "selectionBar",
+				"label": "Selection Bar",
+				"type": "boolean",
+				"description": "Floating bar that appears over the grid while rows are selected, showing the count and the actions that apply to the whole selection - the pattern an issue tracker uses for bulk edit. `true` gives the count and a Clear button. An array is the shorthand for `{ actions }`. Pass to also set `position` (`'bottom'` default, or `'top'`), `maxVisible` and `hideClear`. Omitted / `false` is off. Default **off**. This is chrome that floats over your content, not a gesture: it overlaps a row, and what belongs on it is specific to the app. **The prop and its types are free; the bar itself is an Enterprise feature.** Install `@svgrid/enterprise` and call `enableSelectionBar()` (or `installEnterprise`, which does it for you) to render it - without that the grid shows a short upsell note in its place, the same way the scheduler and board views do.",
+				"group": "common"
+			},
 			{
 				"key": "features",
 				"label": "Features",
@@ -8681,12 +8693,14 @@ var GENERATED_UI_SURFACE = {
 				"key": "filterable",
 				"label": "Filterable",
 				"type": "boolean",
+				"description": "Click a header to filter that column. Injects `columnFilteringFeature`, so you do not import it yourself. Which filter surface appears is a separate question - see `filterMode` (default `'menu'`). <SvGrid {data} {columns} filterable />",
 				"group": "common"
 			},
 			{
 				"key": "editable",
 				"label": "Editable",
 				"type": "boolean",
+				"description": "Inline cell editing. Alias of `enableInlineEditing`, and wins over it when both are set. A column also needs an `editorType` to be editable; without one it falls back to a text editor. <SvGrid {data} {columns} editable />",
 				"group": "common"
 			},
 			{
@@ -8707,6 +8721,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "groupable",
 				"label": "Groupable",
 				"type": "boolean",
+				"description": "Show the grouping controls: \"Group by this column\" in the column menu, and the group panel when `showGroupPanel` is on. Alias of `showGroupingControls`, and also injects `columnGroupingFeature`. This turns on the UI for grouping. To group without asking the user, set `groupBy` instead. <SvGrid {data} {columns} groupable />",
 				"group": "common"
 			},
 			{
@@ -8762,12 +8777,14 @@ var GENERATED_UI_SURFACE = {
 				"key": "pageable",
 				"label": "Pageable",
 				"type": "boolean",
+				"description": "Show the pagination footer. Alias of `showPagination`, and wins over it when both are set. Page size starts at `pageSize` (default 10). <SvGrid {data} {columns} pageable pageSize={25} />",
 				"group": "common"
 			},
 			{
 				"key": "loading",
 				"label": "Loading",
 				"type": "boolean",
+				"description": "Show the loading state instead of the rows. By default this replaces the grid body with \"Loading...\"; set `loadingOverlay` to keep the current rows visible under a dimmed overlay instead, which is what you usually want for a server-paged grid.",
 				"group": "behavior"
 			},
 			{
@@ -8788,12 +8805,14 @@ var GENERATED_UI_SURFACE = {
 				"key": "error",
 				"label": "Error",
 				"type": "string",
+				"description": "Render an error message in place of the rows. `null` or omitted means no error. Takes precedence over `loading` and over the empty state.",
 				"group": "common"
 			},
 			{
 				"key": "emptyMessage",
 				"label": "Empty Message",
 				"type": "string",
+				"description": "Text shown when there are no rows to display - either the data is empty or a filter matched nothing. Defaults to the localized `noRows` string, so prefer `localization.text.noRows` when you are translating the whole grid.",
 				"group": "common"
 			},
 			{
@@ -8807,12 +8826,14 @@ var GENERATED_UI_SURFACE = {
 				"key": "showGlobalFilter",
 				"label": "Show Global Filter",
 				"type": "boolean",
+				"description": "Show the single search box that filters across every column. Explicitly setting this wins over `filterMode`; leaving it unset means it appears only when `filterMode` is `'global'`.",
 				"group": "common"
 			},
 			{
 				"key": "showColumnFilters",
 				"label": "Show Column Filters",
 				"type": "boolean",
+				"description": "Show the filter section inside each column's menu. Explicitly setting this wins over `filterMode`; unset, it follows `filterMode` (default `'menu'`, so this is normally on). Setting it `true` also adds the inline \"floating filter\" input under each header - that surface requires the explicit opt-in, since it otherwise duplicates the menu's own filter popover.",
 				"group": "common"
 			},
 			{
@@ -8832,18 +8853,21 @@ var GENERATED_UI_SURFACE = {
 				"key": "showGroupingControls",
 				"label": "Show Grouping Controls",
 				"type": "boolean",
+				"description": "Show the grouping affordances (the column menu's \"Group by this column\", and the group panel). The `groupable` shortcut sets this and registers the grouping feature in one go; prefer that unless you have already registered `columnGroupingFeature` yourself.",
 				"group": "common"
 			},
 			{
 				"key": "showRowSelection",
 				"label": "Show Row Selection",
 				"type": "boolean",
+				"description": "Show the row-selection checkbox column, including the select-all checkbox in the header. Unset, it follows `selectionMode` (default `'both'`, so row selection is on).",
 				"group": "common"
 			},
 			{
 				"key": "showPagination",
 				"label": "Show Pagination",
 				"type": "boolean",
+				"description": "Show the pagination footer. Off by default. `pageable` is the shortcut alias and wins when both are set.",
 				"group": "common"
 			},
 			{
@@ -8897,6 +8921,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "virtualization",
 				"label": "Virtualization",
 				"type": "boolean",
+				"description": "Render only the rows in view instead of all of them. **On by default** - this is what keeps a 100,000-row grid responsive. Turn it off when a row's height cannot be known up front and must not be clipped, such as a variable-height master-detail panel. Expect the DOM to hold every row when you do.",
 				"group": "common"
 			},
 			{
@@ -8913,6 +8938,13 @@ var GENERATED_UI_SURFACE = {
 				"description": "Size each row to its own content instead of a fixed height: cell text wraps and the row grows to fit the tallest cell. Rows are measured after they render, so this works with virtualization - `rowHeight` (or 30) is the estimate used before a row has been measured, which keeps the scrollbar stable while you scroll into new rows. Costs a measurement pass per row, so prefer a fixed `rowHeight` when your content is uniform. Ignored when `rowHeight` is a function (you are already supplying per-row heights).",
 				"group": "common"
 			},
+			{
+				"key": "rowResize",
+				"label": "Row Resize",
+				"type": "boolean",
+				"description": "Let the user drag a row's bottom edge to change its height. **Off by default**, because a resizable row needs somewhere to grab and most grids do not want a drag target on every row. The grid remembers the heights itself, so this works as a bare boolean - no `rowHeight` function required. Drag, or focus the grip and use Up/Down (Shift for 1px steps). Turning this on also turns on the **row header column** (* showRowNumbers), because that is where the grip lives and where a spreadsheet puts it - a drag target on the edge of a data cell works but reads as an accident. An explicit `showRowNumbers={false}` still wins; the grip then falls back to the row's first cell, and a column of your own carrying `cellClass: 'sv-row-gutter'` is used ahead of either. Ignored under `autoRowHeight`, where the content decides the height and a manual one would immediately be overwritten. For full control of the heights - persisting them, sharing them between grids - pass a function-valued and use the `rowResize` action directly.",
+				"group": "common"
+			},
 			{
 				"key": "headerHeight",
 				"label": "Header Height",
@@ -8924,6 +8956,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "overscan",
 				"label": "Overscan",
 				"type": "number",
+				"description": "Extra rows rendered above and below the viewport, so fast scrolling does not reach empty space before the next batch renders. Defaults to 8. Raise it for very tall rows, lower it to trim DOM work.",
 				"group": "common"
 			},
 			{
@@ -8937,18 +8970,21 @@ var GENERATED_UI_SURFACE = {
 				"key": "columnVirtualization",
 				"label": "Column Virtualization",
 				"type": "boolean",
+				"description": "Render only the columns in view, the horizontal counterpart of `virtualization`. **On by default**, which is what makes a 100-column grid scroll smoothly. It recycles column DOM nodes, so it cannot coexist with sticky pinned columns - turn it off if you need pinning to survive horizontal scrolling.",
 				"group": "common"
 			},
 			{
 				"key": "columnOverscan",
 				"label": "Column Overscan",
 				"type": "number",
+				"description": "Extra columns rendered either side of the viewport when `columnVirtualization` is on. Defaults to 3.",
 				"group": "common"
 			},
 			{
 				"key": "columnWidth",
 				"label": "Column Width",
 				"type": "number",
+				"description": "Fallback width in pixels for columns whose `ColumnDef` sets no `width`. Defaults to 140.",
 				"group": "common"
 			},
 			{
@@ -8965,6 +9001,13 @@ var GENERATED_UI_SURFACE = {
 				"description": "When `true`, columns are scaled proportionally so their total width fills the viewport (no empty space on the right). Disabled by default - explicit `width` values are used as-is. User resizes still win once they happen.",
 				"group": "common"
 			},
+			{
+				"key": "columnResize",
+				"label": "Column Resize",
+				"type": "boolean",
+				"description": "Let the user drag a column's edge to change its width. **Off by default**, so `width` means the width you asked for until you say otherwise. Turn it on for grids the reader is meant to arrange - a spreadsheet, a dense report, anything with columns whose content varies in length. Leave it off for layouts you control, and for columns that must keep their size: a row-number gutter, a checkbox column, an icon column. It is grid-wide rather than per-column: there is no `resizable: false` on a single column definition. `api.autosizeColumn()`, `fitColumns` and programmatic width changes work either way - this only governs the drag handle. The handles come from the `columnResize` action, loaded on demand: a grid that leaves this off never fetches that code.",
+				"group": "common"
+			},
 			{
 				"key": "responsive",
 				"label": "Responsive",
@@ -8982,12 +9025,21 @@ var GENERATED_UI_SURFACE = {
 				"key": "showFilterRow",
 				"label": "Show Filter Row",
 				"type": "boolean",
+				"description": "Show the always-visible filter row under the header. Explicitly setting this wins over `filterMode`; unset, it appears only when `filterMode` is `'row'`.",
 				"group": "common"
 			},
 			{
 				"key": "enableCellSelection",
 				"label": "Enable Cell Selection",
 				"type": "boolean",
+				"description": "Cell selection - click to select, drag or shift-click to extend to a range, which is what clipboard copy and the range fill handle operate on. Unset, it follows `selectionMode` (default `'both'`, so this is on). `selectable` is the shortcut alias and wins over it.",
+				"group": "common"
+			},
+			{
+				"key": "moveCells",
+				"label": "Move Cells",
+				"type": "boolean",
+				"description": "Excel-style drag-and-drop of a selected cell range: grab the range's border and drag it somewhere else to MOVE the values there, or hold Ctrl (Cmd on macOS) to COPY them instead. The modifier is read at drop time, so it can be pressed or released mid-drag. On by default whenever cell selection is on, matching the fill handle. Set `false` to keep a border pointerdown starting a fresh selection, which is what it did before this existed. The grab strip is the outer 4px of the range border, so a pointerdown anywhere further inside still starts a new selection. A drop is refused outright - nothing changes - when the destination would fall outside the grid, or when any source or destination cell is read-only. It does not move the part that fits and silently drop the rest.",
 				"group": "common"
 			},
 			{
@@ -9016,6 +9068,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "enableInlineEditing",
 				"label": "Enable Inline Editing",
 				"type": "boolean",
+				"description": "Inline cell editing: F2 or double-click opens an editor in the active cell, Enter commits, Esc cancels. Off by default. A column still needs an `editorType` to pick its editor (text, number, date, checkbox, list, ...); without one it gets a plain text editor. `editable` is the shortcut alias and wins over this.",
 				"group": "common"
 			},
 			{
@@ -9029,6 +9082,14 @@ var GENERATED_UI_SURFACE = {
 				"key": "enableRowSummaries",
 				"label": "Enable Row Summaries",
 				"type": "boolean",
+				"description": "Append a sticky footer row aggregating every filtered row: the sum of a numeric column, `Count: N` otherwise. Choose a different aggregate per column with that column's own `summary` option, or set it to `false` there to leave the cell blank. Off by default. `summary` is the shortcut alias and wins when both are set. <SvGrid {data} {columns} summary />",
+				"group": "common"
+			},
+			{
+				"key": "summary",
+				"label": "Summary",
+				"type": "boolean",
+				"description": "Shortcut alias for . Wins over it when both are set, the same precedence `selectable` has over `enableCellSelection`.",
 				"group": "common"
 			},
 			{
@@ -9056,7 +9117,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "columnMenuTabs",
 				"label": "Column Menu Tabs",
 				"type": "boolean",
-				"description": "Render the header column menu (⋮) as a tabbed popover - **General**, **Filter**, and **Columns** tabs (the AG-Grid layout). Defaults to `false`, which keeps the flat menu (actions list + \"Choose columns\" submenu).",
+				"description": "Render the header column menu (⋮) as a tabbed popover - **General**, **Filter**, and **Columns** tabs (the tabbed layout). Defaults to `false`, which keeps the flat menu (actions list + \"Choose columns\" submenu).",
 				"group": "common"
 			},
 			{
@@ -9336,7 +9397,8 @@ var GENERATED_UI_SURFACE = {
 			{
 				"key": "cellValueChange",
 				"label": "Cell Value Change",
-				"prop": "onCellValueChange"
+				"prop": "onCellValueChange",
+				"description": "Fires after an inline edit commits, with the cell's old and new value and the row it belongs to. This is where you persist the change. The grid has already applied the edit to its own state by the time this runs, so it is a notification, not a veto - reject a value with the column's `valueParser` or a validation rule instead."
 			},
 			{
 				"key": "activeCellChange",
@@ -15818,7 +15880,7 @@ function hasFieldConditions(schema) {
 *
 * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
 */
-var SVGRID_VERSION = "2.6.4";
+var SVGRID_VERSION = "3.0.0";
 //#endregion
 //#region src/studio/emit-project.ts
 var has = (blocks, kind) => blocks.some((b) => b.config.kind === kind);

package/dist/pivot.d.ts

@@ -30,8 +30,11 @@
  * ```
  */
 import type { ColumnDef, CellFormatConfig, RowData, TableFeatures } from '@svgrid/grid';
+/** Built-in pivot measures, named in {@link PivotValueConfig}. */
 export type PivotAggregatorId = 'sum' | 'avg' | 'min' | 'max' | 'count' | 'countDistinct' | 'first' | 'last';
+/** A custom measure: reduce the values under one cell to the number to display. */
 export type PivotAggregator = (values: ReadonlyArray<unknown>) => unknown;
+/** One measure: the field to aggregate and how to aggregate it. */
 export type PivotValueConfig<TData> = {
     /** Row field whose values get aggregated. */
     field: keyof TData & string;
@@ -42,6 +45,7 @@ export type PivotValueConfig<TData> = {
     /** Optional cell formatter. */
     format?: CellFormatConfig;
 };
+/** A pivot definition: the row axis, the column axis, and the measures at their intersections. */
 export type PivotConfig<TData> = {
     /** Outer-most first. Each entry becomes one level of row grouping. */
     rows: ReadonlyArray<keyof TData & string>;
@@ -60,6 +64,7 @@ export type PivotConfig<TData> = {
     /** Optional sort for row-axis values per dim level (defaults to alpha). */
     rowSort?: (a: unknown, b: unknown, level: number) => number;
 };
+/** What a pivot row represents - a group header, a subtotal, a leaf, or the grand total. */
 export type PivotRowKind = 'group' | 'subtotal' | 'leaf' | 'grandTotal';
 /**
  * Shape of one entry in `result.rows`. The first-column label lives at
@@ -87,10 +92,16 @@ export type PivotRow = {
     /** Aggregated value cells - keyed by leaf column id. */
     [columnId: string]: unknown;
 };
+/** A built pivot: the rows to display, and the generated column definitions for its column axis. */
 export type PivotResult<TFeatures extends TableFeatures> = {
     rows: PivotRow[];
     columns: Array<ColumnDef<TFeatures, PivotRow>>;
 };
+/**
+ * Build a pivot table from flat rows: cross the row axis with the column axis,
+ * aggregate each intersection, and return rows plus generated columns ready to
+ * hand to `<SvGrid>`.
+ */
 export declare function createPivotModel<TFeatures extends TableFeatures, TData extends RowData>(data: ReadonlyArray<TData>, config: PivotConfig<TData>): PivotResult<TFeatures>;
 /**
  * Public registry of built-in aggregators. Useful for surfacing the

package/dist/pivot.js

@@ -233,7 +233,7 @@ parentId) {
     // regardless of `rowSubtotals` so the grouping hierarchy and the
     // expand/collapse parent chain stay intact; the flag only controls whether
     // the header carries its aggregate (subtotal) values or renders as a
-    // label-only row. This matches Excel / AG Grid, where hiding subtotals never
+    // label-only row. This matches Excel, where hiding subtotals never
     // removes a grouping level from the row axis.
     const isRealGroup = node.level > 0 && node.level < rowFields.length;
     let nextParentId = parentId;
@@ -259,6 +259,11 @@ parentId) {
     }
 }
 // ------------------------------------------------------------ public API
+/**
+ * Build a pivot table from flat rows: cross the row axis with the column axis,
+ * aggregate each intersection, and return rows plus generated columns ready to
+ * hand to `<SvGrid>`.
+ */
 export function createPivotModel(data, config) {
     if (config.values.length === 0) {
         throw new Error('pivot: at least one value config is required');

package/dist/selection-bar.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Register the Enterprise selection bar. Idempotent - safe to call from every
+ * component that uses `selectionBar`, or once at app start. Also invoked by
+ * {@link installEnterprise} so wiring the Pro API turns the bar on too.
+ */
+export declare function enableSelectionBar(): void;
+export { default as SvGridSelectionBar } from './SvGridSelectionBar.svelte';

package/dist/selection-bar.js

@@ -0,0 +1,42 @@
+/**
+ * selection bar - registers the Enterprise bulk-action bar with the grid, so
+ * `<SvGrid selectionBar={...}>` floats a bar over the rows while any are
+ * selected: the count, the actions that apply to the whole selection, an
+ * overflow menu once there are more than a handful, and a clear button.
+ *
+ * The grid ships the `selectionBar` prop and its config types for free; the
+ * *renderer* (SvGridSelectionBar) is Pro and plugs in through the grid's
+ * `registerSelectionBarView` seam. Without it the grid shows a short upsell
+ * note where the bar would be.
+ *
+ * Soft-gated like the rest of Enterprise: it works without a license key but
+ * the grid shows the "unlicensed" watermark + a one-time console nudge.
+ *
+ * ```ts
+ * import { setLicenseKey, enableSelectionBar } from '@svgrid/enterprise'
+ * setLicenseKey('YOUR-KEY')
+ * enableSelectionBar()
+ * // then:
+ * // <SvGrid {data} {columns} showRowSelection
+ * //   selectionBar={{ position: 'bottom', actions: [...] }} />
+ * ```
+ */
+import { registerSelectionBarView } from '@svgrid/grid';
+import { isLicenseKeySet } from './license';
+import { emitUnlicensedNudge } from './watermark';
+import SvGridSelectionBar from './SvGridSelectionBar.svelte';
+let enabled = false;
+/**
+ * Register the Enterprise selection bar. Idempotent - safe to call from every
+ * component that uses `selectionBar`, or once at app start. Also invoked by
+ * {@link installEnterprise} so wiring the Pro API turns the bar on too.
+ */
+export function enableSelectionBar() {
+    if (enabled)
+        return;
+    enabled = true;
+    registerSelectionBarView(SvGridSelectionBar);
+    if (!isLicenseKeySet())
+        emitUnlicensedNudge();
+}
+export { default as SvGridSelectionBar } from './SvGridSelectionBar.svelte';

package/dist/studio/emit-project.js

@@ -195,6 +195,12 @@ function blockMarkup(entity, schemaVar, typeName, block, resolve, ctx = { hasRec
                 return fire ? `(${param}) => { ${base}${fire} }` : `(${param}) => ${base}`;
             };
             const lines = [`data={${dataExpr}}`, `columns={${colVar}}`, `loading={${tree || grouped ? '!allRowsReady' : 'view.loading'}}`, `loadingOverlay`, `emptyMessage=${JSON.stringify(emptyMsg)}`, `fitColumns`];
+            // Emitted explicitly in BOTH directions on purpose. The grid now defaults
+            // this off and takes `summary` as a shortcut, but generated apps install
+            // the PUBLISHED @svgrid/grid, where the default is still on and `summary`
+            // does not exist yet. Switching to `summary` (or dropping the `false`)
+            // before that release would silently give every generated screen the
+            // wrong footer. Revisit once the grid carrying the flip is published.
             lines.push(`enableRowSummaries={${cfg.rowSummaries ? 'true' : 'false'}}`);
             if (cfg.striped)
                 lines.push(`zebraRows`);