@geovi/the-datagrid 0.0.13 → 0.1.0

package/dist/toolbar/RDGToolbar.d.ts

@@ -1,5 +1,6 @@
-import { RDGToolbarExportFormat, RDGToolbarExportScope } from './export.js';
+import { RDGToolbarExportFormat, RDGToolbarExportInfo, RDGToolbarExportResult, RDGToolbarExportScope } from './export.js';
 import * as React from "react";
+export type { RDGToolbarExportInfo, RDGToolbarExportResult };
 /**
  * Every string the toolbar renders itself. Values are `ReactNode`, so a
  * translation helper that returns an element works as well as one that returns
@@ -33,20 +34,6 @@ export type RDGToolbarLabels = {
      */
     filteringControlledHint?: string;
 };
-/** Describes one export, for `exportFileName` callbacks. */
-export type RDGToolbarExportInfo = {
-    format: RDGToolbarExportFormat;
-    scope: RDGToolbarExportScope;
-    rowCount: number;
-    columnCount: number;
-};
-/** Describes a finished export, for `onExportSuccess`. */
-export type RDGToolbarExportResult = RDGToolbarExportInfo & {
-    /** File name the browser was given, including the extension. */
-    fileName: string;
-    /** Size of the written file in bytes. */
-    byteLength: number;
-};
 export type RDGToolbarProps = {
     children?: React.ReactNode;
     ariaLabel?: string;

package/dist/toolbar/RDGToolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RDGToolbar.d.ts","sourceRoot":"","sources":["../../src/toolbar/RDGToolbar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAML,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACzE;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8FAA8F;IAC9F,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAClD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,oBAAoB,KAAK,MAAM,CAAC,CAAC;IACnE,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC3D,uEAAuE;IACvE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAkDF,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAqPrE"}
+{"version":3,"file":"RDGToolbar.d.ts","sourceRoot":"","sources":["../../src/toolbar/RDGToolbar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,EAML,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,UAAU,CAAC;AAIlB,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACzE;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8FAA8F;IAC9F,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAClD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,oBAAoB,KAAK,MAAM,CAAC,CAAC;IACnE,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC3D,uEAAuE;IACvE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAuBF,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAuOrE"}

package/dist/toolbar/RDGToolbarProvider.d.ts

@@ -1,6 +1,18 @@
+import { RDGToolbarApi } from './api.js';
+import { RDGToolbarExportSettings } from './export.js';
 import * as React from "react";
 export type RDGToolbarProviderProps = {
     children: React.ReactNode;
+    /**
+     * Receives the imperative toolbar API, so a component above this provider can
+     * export the grid, toggle columns or clear filters without a hook.
+     */
+    apiRef?: React.Ref<RDGToolbarApi>;
+    /**
+     * Export settings both `RDGToolbar`'s button and `apiRef` fall back to. The
+     * matching toolbar prop and one export's own settings outrank these.
+     */
+    exportDefaults?: RDGToolbarExportSettings;
 };
 export declare function RDGToolbarProvider(props: RDGToolbarProviderProps): React.ReactElement;
 //# sourceMappingURL=RDGToolbarProvider.d.ts.map

package/dist/toolbar/RDGToolbarProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RDGToolbarProvider.d.ts","sourceRoot":"","sources":["../../src/toolbar/RDGToolbarProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,KAAK,CAAC,YAAY,CAyBpB"}
+{"version":3,"file":"RDGToolbarProvider.d.ts","sourceRoot":"","sources":["../../src/toolbar/RDGToolbarProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAKzD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,wBAAwB,CAAC;CAC3C,CAAC;AAOF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,KAAK,CAAC,YAAY,CA+BpB"}

package/dist/toolbar/api.d.ts

@@ -0,0 +1,65 @@
+import { TypeColumn } from '../types.js';
+import { RDGToolbarPublishedSnapshot } from './controller.js';
+import { RDGToolbarExportFormat, RDGToolbarExportResult, RDGToolbarExportSettings } from './export.js';
+/** The grid state the API publishes; the actions live on the API itself. */
+export type RDGToolbarState = {
+    /** False until a grid mounts inside the provider, and again once it unmounts. */
+    attached: boolean;
+    /** Columns in the grid's current column order. */
+    columns: readonly TypeColumn[];
+    /** Visibility per column id. A column the map omits is visible. */
+    columnVisibilityMap: Readonly<Record<string, boolean>>;
+    theme: string;
+    filteringEnabled: boolean;
+    /** False while the grid owns `enableFiltering`, which makes the setter a no-op. */
+    canToggleFiltering: boolean;
+    filtered: boolean;
+};
+/**
+ * The toolbar's surface, callable from outside React's tree. Comes from
+ * `RDGToolbarProvider`'s `apiRef`, or from `useRDGToolbarApi()` inside it.
+ *
+ * Methods, never properties: a ref does not re-render its holder, so a
+ * `columns` property would go stale as soon as a column was hidden.
+ */
+export type RDGToolbarApi = {
+    /**
+     * Writes one export, exactly as the toolbar's own button does. Settings win
+     * over the provider's `exportDefaults`, which win over the library defaults.
+     *
+     * Resolves `null` when there is nothing to export, and rejects when a writer
+     * fails - a missing `xlsx` peer dependency, say.
+     */
+    exportGrid(format: RDGToolbarExportFormat, settings?: RDGToolbarExportSettings): Promise<RDGToolbarExportResult | null>;
+    /** Every format `exportGrid` accepts, whatever a rendered toolbar offers. */
+    getExportFormats(): readonly RDGToolbarExportFormat[];
+    /** Columns in the grid's current column order. */
+    getColumns(): readonly TypeColumn[];
+    /** False for a hidden column, and for a column id the grid does not have. */
+    isColumnVisible(columnId: string): boolean;
+    setColumnVisible(columnId: string, visible: boolean): void;
+    isFilteringEnabled(): boolean;
+    /** False while the grid owns `enableFiltering` as its own prop. */
+    canToggleFiltering(): boolean;
+    setFilteringEnabled(enabled: boolean): void;
+    /** Whether at least one column filter holds a non-empty value. */
+    isFiltered(): boolean;
+    clearAllFilters(): void;
+    /** Rows the grid currently renders: filtered, searched and sorted. */
+    getViewRows(): readonly unknown[];
+    /** Every row of the local data source, before filtering and searching. */
+    getAllRows(): readonly unknown[];
+    /** The current state as plain data. Stable while the grid state is. */
+    getState(): RDGToolbarState;
+    /** Notifies on every grid state change. Returns an unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+};
+/** Taking these from the store is what keeps the runtime dependency one-way. */
+export type RDGToolbarApiSource = {
+    getSnapshot: () => RDGToolbarPublishedSnapshot;
+    subscribe: (listener: () => void) => () => void;
+    getExportDefaults: () => RDGToolbarExportSettings | undefined;
+    isAttached: () => boolean;
+};
+export declare function createRDGToolbarApi(source: RDGToolbarApiSource): RDGToolbarApi;
+//# sourceMappingURL=api.d.ts.map

package/dist/toolbar/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/toolbar/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,UAAU,CAAC;AAElB,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG;IAC5B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,mEAAmE;IACnE,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mFAAmF;IACnF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC1C,6EAA6E;IAC7E,gBAAgB,IAAI,SAAS,sBAAsB,EAAE,CAAC;IAEtD,kDAAkD;IAClD,UAAU,IAAI,SAAS,UAAU,EAAE,CAAC;IACpC,6EAA6E;IAC7E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAE3D,kBAAkB,IAAI,OAAO,CAAC;IAC9B,mEAAmE;IACnE,kBAAkB,IAAI,OAAO,CAAC;IAC9B,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,kEAAkE;IAClE,UAAU,IAAI,OAAO,CAAC;IACtB,eAAe,IAAI,IAAI,CAAC;IAExB,sEAAsE;IACtE,WAAW,IAAI,SAAS,OAAO,EAAE,CAAC;IAClC,0EAA0E;IAC1E,UAAU,IAAI,SAAS,OAAO,EAAE,CAAC;IAEjC,uEAAuE;IACvE,QAAQ,IAAI,eAAe,CAAC;IAC5B,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,2BAA2B,CAAC;IAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,iBAAiB,EAAE,MAAM,wBAAwB,GAAG,SAAS,CAAC;IAC9D,UAAU,EAAE,MAAM,OAAO,CAAC;CAC3B,CAAC;AAMF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CA6Df"}

package/dist/toolbar/columns.d.ts

@@ -0,0 +1,12 @@
+import { TypeColumn } from '../types.js';
+/**
+ * Deliberately not core's `getColumnId`, which throws on a column with no id:
+ * right for rendering a grid, wrong for a toolbar that should skip that column.
+ */
+export declare function getColumnId(column: TypeColumn): string;
+/**
+ * Sorts columns into the grid's column order. Columns the order does not
+ * mention keep their declared order and follow the ones it does.
+ */
+export declare function orderColumns(columns: readonly TypeColumn[], columnOrder: readonly string[]): TypeColumn[];
+//# sourceMappingURL=columns.d.ts.map

package/dist/toolbar/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/toolbar/columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,UAAU,EAAE,CAkBd"}

package/dist/toolbar/export.d.ts

@@ -10,6 +10,49 @@ import { TypeColumn } from '../types.js';
 export type RDGToolbarExportFormat = "csv" | "json" | "xlsx";
 /** Rows the export reads: the current grid view, or the whole data source. */
 export type RDGToolbarExportScope = "view" | "all";
+/** Describes one export, for `exportFileName` callbacks. */
+export type RDGToolbarExportInfo = {
+    format: RDGToolbarExportFormat;
+    scope: RDGToolbarExportScope;
+    rowCount: number;
+    columnCount: number;
+};
+/** Describes a finished export, for `onExportSuccess`. */
+export type RDGToolbarExportResult = RDGToolbarExportInfo & {
+    /** File name the browser was given, including the extension. */
+    fileName: string;
+    /** Size of the written file in bytes. */
+    byteLength: number;
+};
+/**
+ * Everything an export needs beyond the format. Wherever the export is
+ * triggered from, the layers resolve most specific first: one export's own
+ * settings, then the `RDGToolbar` prop, then the provider's `exportDefaults`,
+ * then the fallbacks below.
+ */
+export type RDGToolbarExportSettings = {
+    /** `"view"` exports the filtered, searched and sorted rows; `"all"` the whole data source. */
+    scope?: RDGToolbarExportScope;
+    /**
+     * Downloaded file name without extension. A function is called per export, so
+     * a name that embeds the date or the chosen format stays accurate.
+     */
+    fileName?: string | ((info: RDGToolbarExportInfo) => string);
+    /** Excel number format for date cells in spreadsheet exports. */
+    dateFormat?: string;
+    /** Worksheet name for spreadsheet exports. Defaults to the file name. */
+    sheetName?: string;
+};
+export declare const DEFAULT_EXPORT_FILE_NAME = "grid-export";
+export declare const DEFAULT_EXPORT_SCOPE: RDGToolbarExportScope;
+/** The subset of the toolbar snapshot an export reads. */
+export type RDGToolbarExportSource = {
+    columns: readonly TypeColumn[];
+    columnOrder: readonly string[];
+    columnVisibilityMap: Readonly<Record<string, boolean>>;
+    getViewRows: () => readonly unknown[];
+    getAllRows: () => readonly unknown[];
+};
 export type RDGToolbarExportTable = {
     /** Header labels, in export order. */
     headers: string[];
@@ -67,4 +110,18 @@ export declare const RDG_TOOLBAR_EXPORT_FORMATS: Record<RDGToolbarExportFormat,
 export declare const DEFAULT_TOOLBAR_EXPORT_FORMATS: readonly RDGToolbarExportFormat[];
 /** Returns the written size in bytes, or 0 when there is no document. */
 export declare function downloadExportFile(filename: string, content: BlobPart, mimeType: string): number;
+/**
+ * Folds the settings layers into one, most specific first. A layer that omits a
+ * field defers to the next, per field rather than wholesale.
+ */
+export declare function mergeExportSettings(...layers: readonly (RDGToolbarExportSettings | undefined)[]): RDGToolbarExportSettings;
+/**
+ * Writes one export and hands it to the browser. The single path behind both
+ * the toolbar's button and the imperative API.
+ *
+ * Returns `null` when there is nothing to write: an unknown format, or no
+ * exportable column - which is also a snapshot with no grid attached. A failing
+ * writer rejects rather than no-opping, so the caller can report it.
+ */
+export declare function performExport(source: RDGToolbarExportSource, format: RDGToolbarExportFormat, settings?: RDGToolbarExportSettings): Promise<RDGToolbarExportResult | null>;
 //# sourceMappingURL=export.d.ts.map

package/dist/toolbar/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/toolbar/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnD,MAAM,MAAM,qBAAqB,GAAG;IAClC,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;CACnB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,uBAAuB,GAAG;IACpC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,EAAE,CACb,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,uBAAuB,KAC7B,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnC,CAAC;AAsBF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD,GAAG,UAAU,EAAE,CAyBf;AAOD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAS5E;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,SAAS,OAAO,EAAE,GACvB,qBAAqB,CAQvB;AAiBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAMvE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAUxE;AAED,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,sBAAsB,EACtB,gCAAgC,CAoBjC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,SAAS,sBAAsB,EAC3D,CAAC;AAElB,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAeR"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/toolbar/export.ts"],"names":[],"mappings":"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"}

package/dist/toolbar/index.d.ts

@@ -1,8 +1,10 @@
 export { RDGToolbar } from './RDGToolbar.js';
 export { RDGToolbarProvider } from './RDGToolbarProvider.js';
 export { RDGToolbarTarget } from './RDGToolbarTarget.js';
-export type { RDGToolbarExportInfo, RDGToolbarExportResult, RDGToolbarLabels, RDGToolbarProps, } from './RDGToolbar.js';
+export { useRDGToolbarApi, useRDGToolbarApiState } from './store.js';
+export type { RDGToolbarLabels, RDGToolbarProps } from './RDGToolbar.js';
 export type { RDGToolbarProviderProps } from './RDGToolbarProvider.js';
 export type { RDGToolbarTargetProps } from './RDGToolbarTarget.js';
-export type { RDGToolbarExportFormat, RDGToolbarExportScope } from './export.js';
+export type { RDGToolbarApi, RDGToolbarState } from './api.js';
+export type { RDGToolbarExportFormat, RDGToolbarExportInfo, RDGToolbarExportResult, RDGToolbarExportScope, RDGToolbarExportSettings, } from './export.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/toolbar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toolbar/index.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toolbar/index.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC5D,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/dist/toolbar/store.d.ts

@@ -1,4 +1,6 @@
+import { RDGToolbarApi, RDGToolbarState } from './api.js';
 import { RDGToolbarController, RDGToolbarPublishedSnapshot } from './controller.js';
+import { RDGToolbarExportSettings } from './export.js';
 import * as React from "react";
 export declare const EMPTY_TOOLBAR_SNAPSHOT: RDGToolbarPublishedSnapshot;
 type TargetRegistration = {
@@ -6,15 +8,27 @@ type TargetRegistration = {
     controller: RDGToolbarController;
 };
 export type RDGToolbarStore = {
+    /** One instance per store, so `apiRef` and `useRDGToolbarApi()` agree. */
+    api: RDGToolbarApi;
     createTargetRegistration: () => TargetRegistration;
     dispose: () => void;
+    /** Export settings the provider configured for every export of this grid. */
+    getExportDefaults: () => RDGToolbarExportSettings | undefined;
     getServerSnapshot: () => RDGToolbarPublishedSnapshot;
     getSnapshot: () => RDGToolbarPublishedSnapshot;
+    setExportDefaults: (settings: RDGToolbarExportSettings | undefined) => void;
     subscribe: (listener: () => void) => () => void;
 };
 export declare function createRDGToolbarStore(): RDGToolbarStore;
 export declare const RDGToolbarContext: React.Context<RDGToolbarStore | null>;
 export declare function useRDGToolbarStore(): RDGToolbarStore;
 export declare function useRDGToolbarSnapshot(): RDGToolbarPublishedSnapshot;
+/**
+ * The provider's imperative API. Stable, and does not re-render on grid
+ * changes: pass it to `useRDGToolbarApiState` to render grid state.
+ */
+export declare function useRDGToolbarApi(): RDGToolbarApi;
+/** Subscribes to `api.getState()`, re-rendering when the grid state changes. */
+export declare function useRDGToolbarApiState(api: RDGToolbarApi): RDGToolbarState;
 export {};
 //# sourceMappingURL=store.d.ts.map

package/dist/toolbar/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/toolbar/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAYtB,eAAO,MAAM,sBAAsB,EAAE,2BAapC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,MAAM,IAAI,CAAC;IACzB,UAAU,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;IACnD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;IACrD,WAAW,EAAE,MAAM,2BAA2B,CAAC;IAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD,CAAC;AAgDF,wBAAgB,qBAAqB,IAAI,eAAe,CA4DvD;AAED,eAAO,MAAM,iBAAiB,uCAE7B,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,eAAe,CAQpD;AAED,wBAAgB,qBAAqB,IAAI,2BAA2B,CAOnE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/toolbar/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAYzD,eAAO,MAAM,sBAAsB,EAAE,2BAapC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,MAAM,MAAM,IAAI,CAAC;IACzB,UAAU,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,0EAA0E;IAC1E,GAAG,EAAE,aAAa,CAAC;IACnB,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;IACnD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,wBAAwB,GAAG,SAAS,CAAC;IAC9D,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;IACrD,WAAW,EAAE,MAAM,2BAA2B,CAAC;IAC/C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,wBAAwB,GAAG,SAAS,KAAK,IAAI,CAAC;IAC5E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD,CAAC;AAgDF,wBAAgB,qBAAqB,IAAI,eAAe,CA8EvD;AAED,eAAO,MAAM,iBAAiB,uCAE7B,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,eAAe,CAQpD;AAED,wBAAgB,qBAAqB,IAAI,2BAA2B,CAOnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAEzE"}