@genesislcap/grid-pro 14.323.0 → 14.324.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 (51) hide show
  1. package/README.md +1 -1
  2. package/dist/custom-elements.json +941 -349
  3. package/dist/dts/datasource/base.datasource.d.ts +64 -5
  4. package/dist/dts/datasource/base.datasource.d.ts.map +1 -1
  5. package/dist/dts/datasource/base.types.d.ts +5 -2
  6. package/dist/dts/datasource/base.types.d.ts.map +1 -1
  7. package/dist/dts/datasource/datasource.types.d.ts +8 -0
  8. package/dist/dts/datasource/datasource.types.d.ts.map +1 -1
  9. package/dist/dts/datasource/server-side.datasource.d.ts +9 -1
  10. package/dist/dts/datasource/server-side.datasource.d.ts.map +1 -1
  11. package/dist/dts/datasource/server-side.resource-base.d.ts +26 -2
  12. package/dist/dts/datasource/server-side.resource-base.d.ts.map +1 -1
  13. package/dist/dts/datasource/server-side.resource-dataserver.d.ts +5 -0
  14. package/dist/dts/datasource/server-side.resource-dataserver.d.ts.map +1 -1
  15. package/dist/dts/datasource/server-side.resource-reqrep.d.ts +9 -0
  16. package/dist/dts/datasource/server-side.resource-reqrep.d.ts.map +1 -1
  17. package/dist/dts/grid-pro-genesis-datasource/grid-pro-genesis-datasource.d.ts +2 -0
  18. package/dist/dts/grid-pro-genesis-datasource/grid-pro-genesis-datasource.d.ts.map +1 -1
  19. package/dist/dts/status-bar-components/pagination.status-bar.d.ts.map +1 -1
  20. package/dist/esm/datasource/base.datasource.js +61 -19
  21. package/dist/esm/datasource/server-side.datasource.js +32 -44
  22. package/dist/esm/datasource/server-side.resource-base.js +36 -38
  23. package/dist/esm/datasource/server-side.resource-dataserver.js +47 -1
  24. package/dist/esm/datasource/server-side.resource-reqrep.js +174 -39
  25. package/dist/esm/grid-pro-genesis-datasource/grid-pro-genesis-datasource.js +40 -2
  26. package/dist/esm/status-bar-components/pagination.status-bar.js +29 -4
  27. package/dist/grid-pro.api.json +82 -21
  28. package/dist/grid-pro.d.ts +83 -6
  29. package/docs/api/grid-pro.genesisgriddatasourceelement.criteria.md +2 -0
  30. package/docs/api/grid-pro.genesisgriddatasourceelement.disablepolling.md +7 -0
  31. package/docs/api/grid-pro.genesisgriddatasourceelement.fields.md +7 -0
  32. package/docs/api/grid-pro.genesisgriddatasourceelement.issnapshot.md +7 -0
  33. package/docs/api/grid-pro.genesisgriddatasourceelement.maxrows.md +7 -0
  34. package/docs/api/grid-pro.genesisgriddatasourceelement.maxview.md +7 -0
  35. package/docs/api/grid-pro.genesisgriddatasourceelement.md +47 -0
  36. package/docs/api/grid-pro.genesisgriddatasourceelement.movingview.md +7 -0
  37. package/docs/api/grid-pro.genesisgriddatasourceelement.offset.md +18 -0
  38. package/docs/api/grid-pro.genesisgriddatasourceelement.orderby.md +7 -0
  39. package/docs/api/grid-pro.genesisgriddatasourceelement.pollinginterval.md +7 -0
  40. package/docs/api/grid-pro.genesisgriddatasourceelement.polltriggerevents.md +7 -0
  41. package/docs/api/grid-pro.genesisgriddatasourceelement.request.md +7 -0
  42. package/docs/api/grid-pro.genesisgriddatasourceelement.resourcename.md +7 -0
  43. package/docs/api/grid-pro.genesisgriddatasourceelement.reverse.md +7 -0
  44. package/docs/api/grid-pro.genesisgriddatasourceelement.viewnumber.md +2 -0
  45. package/docs/api/grid-pro.gridproserversidedatasource.md +3 -5
  46. package/docs/api/grid-pro.gridproserversidedatasource.pagingmode.md +21 -0
  47. package/docs/api/grid-pro.md +11 -0
  48. package/docs/api/grid-pro.pagingmode.md +18 -0
  49. package/docs/api-report.md.api.md +5 -16
  50. package/package.json +13 -13
  51. package/docs/api/grid-pro.gridproserversidedatasource.params.md +0 -14
@@ -89,6 +89,8 @@ string
89
89
 
90
90
  </td><td>
91
91
 
92
+ Groovy expression to perform filters on the query server; these remain active for the life of the subscription.
93
+
92
94
 
93
95
  </td></tr>
94
96
  <tr><td>
@@ -197,6 +199,8 @@ boolean
197
199
 
198
200
  </td><td>
199
201
 
202
+ Disables polling if set to true (data updates for the grid will not be fetched automatically).
203
+
200
204
 
201
205
  </td></tr>
202
206
  <tr><td>
@@ -214,6 +218,8 @@ string
214
218
 
215
219
  </td><td>
216
220
 
221
+ Optional parameter that allows you to select a subset of fields from the query if the client is not interested in receiving all of them.
222
+
217
223
 
218
224
  </td></tr>
219
225
  <tr><td>
@@ -250,6 +256,8 @@ boolean
250
256
 
251
257
  </td><td>
252
258
 
259
+ Request a snapshot from the server.
260
+
253
261
 
254
262
  </td></tr>
255
263
  <tr><td>
@@ -267,6 +275,8 @@ number
267
275
 
268
276
  </td><td>
269
277
 
278
+ Maximum number of rows to be returned as part of the initial message, and as part of any additional MORE\_ROWS messages.
279
+
270
280
 
271
281
  </td></tr>
272
282
  <tr><td>
@@ -284,6 +294,8 @@ number
284
294
 
285
295
  </td><td>
286
296
 
297
+ Maximum number of rows to track as part of a client "view".
298
+
287
299
 
288
300
  </td></tr>
289
301
  <tr><td>
@@ -301,6 +313,27 @@ boolean
301
313
 
302
314
  </td><td>
303
315
 
316
+ If true, when the maximum number of rows defined in max-view is reached, the Data Server will start discarding the oldest rows (in terms of timestamp) and sending newer rows.
317
+
318
+
319
+ </td></tr>
320
+ <tr><td>
321
+
322
+ [offset](./grid-pro.genesisgriddatasourceelement.offset.md)
323
+
324
+
325
+ </td><td>
326
+
327
+
328
+ </td><td>
329
+
330
+ number
331
+
332
+
333
+ </td><td>
334
+
335
+ The offset for pagination in REQUEST\_SERVER scenarios.
336
+
304
337
 
305
338
  </td></tr>
306
339
  <tr><td>
@@ -318,6 +351,8 @@ string
318
351
 
319
352
  </td><td>
320
353
 
354
+ Option to select a Data Server index (defined in the Data Server query), which is especially useful if you want the data to be sorted in a specific way.
355
+
321
356
 
322
357
  </td></tr>
323
358
  <tr><td>
@@ -335,6 +370,8 @@ number
335
370
 
336
371
  </td><td>
337
372
 
373
+ Custom polling frequency (in milliseconds) for a Request Server resource.
374
+
338
375
 
339
376
  </td></tr>
340
377
  <tr><td>
@@ -352,6 +389,8 @@ string\[\]
352
389
 
353
390
  </td><td>
354
391
 
392
+ Array of event names that will trigger a poll when received as commit responses.
393
+
355
394
 
356
395
  </td></tr>
357
396
  <tr><td>
@@ -369,6 +408,8 @@ any
369
408
 
370
409
  </td><td>
371
410
 
411
+ Similar to fields but for Request Server scenarios. This optional parameter enables you to specify request fields, which can include wildcards.
412
+
372
413
 
373
414
  </td></tr>
374
415
  <tr><td>
@@ -405,6 +446,8 @@ string
405
446
 
406
447
  </td><td>
407
448
 
449
+ The name of the target Data Server query or Request Server requestReply.
450
+
408
451
 
409
452
  </td></tr>
410
453
  <tr><td>
@@ -441,6 +484,8 @@ boolean
441
484
 
442
485
  </td><td>
443
486
 
487
+ Option that changes the Data Server index iteration.
488
+
444
489
 
445
490
  </td></tr>
446
491
  <tr><td>
@@ -517,6 +562,8 @@ number
517
562
 
518
563
  </td><td>
519
564
 
565
+ The desired view/page you want data from.
566
+
520
567
 
521
568
  </td></tr>
522
569
  </tbody></table>
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.movingView property
6
6
 
7
+ If true, when the maximum number of rows defined in max-view is reached, the Data Server will start discarding the oldest rows (in terms of timestamp) and sending newer rows.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  movingView: boolean;
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ DATASERVER only. If false, the updates in the server will be sent to the front end regardless of order. Note that this will only update the UI; no changes will be performed in the database. Defaults to false.
18
+
@@ -0,0 +1,18 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [GenesisGridDatasourceElement](./grid-pro.genesisgriddatasourceelement.md) &gt; [offset](./grid-pro.genesisgriddatasourceelement.offset.md)
4
+
5
+ ## GenesisGridDatasourceElement.offset property
6
+
7
+ The offset for pagination in REQUEST\_SERVER scenarios.
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ offset: number;
13
+ ```
14
+
15
+ ## Remarks
16
+
17
+ REQUEST\_SERVER only.
18
+
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.orderBy property
6
6
 
7
+ Option to select a Data Server index (defined in the Data Server query), which is especially useful if you want the data to be sorted in a specific way.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  orderBy: string;
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ By default, rows are returned in order of creation (from oldest database record to newest).
18
+
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.pollingInterval property
6
6
 
7
+ Custom polling frequency (in milliseconds) for a Request Server resource.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  pollingInterval: number;
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ REQUEST\_SERVER only. Note that this option only works with Request Server resources; if your resource is a Data Server query, your grid is updated in real time. Defaults to 5000ms.
18
+
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.pollTriggerEvents property
6
6
 
7
+ Array of event names that will trigger a poll when received as commit responses.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  pollTriggerEvents: string[];
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ REQUEST\_SERVER only.
18
+
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.request property
6
6
 
7
+ Similar to fields but for Request Server scenarios. This optional parameter enables you to specify request fields, which can include wildcards.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  request: any;
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ REQUEST\_SERVER only.
18
+
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.resourceName property
6
6
 
7
+ The name of the target Data Server query or Request Server requestReply.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  resourceName: string;
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ Required attribute.
18
+
@@ -4,8 +4,15 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.reverse property
6
6
 
7
+ Option that changes the Data Server index iteration.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
12
  reverse: boolean;
11
13
  ```
14
+
15
+ ## Remarks
16
+
17
+ DATASERVER only. For example, if you are using the default index, the query will return rows in order from the newest database records to the oldest. Defaults to false.
18
+
@@ -4,6 +4,8 @@
4
4
 
5
5
  ## GenesisGridDatasourceElement.viewNumber property
6
6
 
7
+ The desired view/page you want data from.
8
+
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
@@ -104,22 +104,20 @@ boolean
104
104
  </td></tr>
105
105
  <tr><td>
106
106
 
107
- [params](./grid-pro.gridproserversidedatasource.params.md)
107
+ [pagingMode](./grid-pro.gridproserversidedatasource.pagingmode.md)
108
108
 
109
109
 
110
110
  </td><td>
111
111
 
112
- `readonly`
113
-
114
112
 
115
113
  </td><td>
116
114
 
117
- any
115
+ [PagingMode](./grid-pro.pagingmode.md) \| undefined
118
116
 
119
117
 
120
118
  </td><td>
121
119
 
122
- **_(BETA)_**
120
+ **_(BETA)_** The paging mode to use for data fetching.
123
121
 
124
122
 
125
123
  </td></tr>
@@ -0,0 +1,21 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [GridProServerSideDatasource](./grid-pro.gridproserversidedatasource.md) &gt; [pagingMode](./grid-pro.gridproserversidedatasource.pagingmode.md)
4
+
5
+ ## GridProServerSideDatasource.pagingMode property
6
+
7
+ > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
+ >
9
+
10
+ The paging mode to use for data fetching.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ pagingMode: PagingMode | undefined;
16
+ ```
17
+
18
+ ## Remarks
19
+
20
+ - "viewBased": Uses VIEW\_NUMBER and NEXT\_VIEW (1 by 1 increment) - "offsetBased": Uses OFFSET and NEXT\_OFFSET (based on maxRows increment) - undefined: Auto-determines based on criteriaOnlyRequest availability
21
+
@@ -1656,6 +1656,17 @@ The parameters for the load more status bar component.
1656
1656
  The Genesis Datasource event payload types.
1657
1657
 
1658
1658
 
1659
+ </td></tr>
1660
+ <tr><td>
1661
+
1662
+ [PagingMode](./grid-pro.pagingmode.md)
1663
+
1664
+
1665
+ </td><td>
1666
+
1667
+ Available paging modes for server-side datasources
1668
+
1669
+
1659
1670
  </td></tr>
1660
1671
  <tr><td>
1661
1672
 
@@ -0,0 +1,18 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [PagingMode](./grid-pro.pagingmode.md)
4
+
5
+ ## PagingMode type
6
+
7
+ Available paging modes for server-side datasources
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ export type PagingMode = 'viewBased' | 'offsetBased';
13
+ ```
14
+
15
+ ## Remarks
16
+
17
+ - This type defines the paging approach used for server-side data fetching - 'viewBased': Uses VIEW\_NUMBER and NEXT\_VIEW (1 by 1 increment) - 'offsetBased': Uses OFFSET and NEXT\_OFFSET (based on maxRows increment)
18
+
@@ -787,7 +787,6 @@ export class GenesisGridDatasourceElement extends GenesisGridDatasourceElement_b
787
787
  clearErrors(): void;
788
788
  // (undocumented)
789
789
  connect: Connect;
790
- // (undocumented)
791
790
  criteria: string;
792
791
  // (undocumented)
793
792
  protected criteriaFromFilters: Map<string, string>;
@@ -803,9 +802,7 @@ export class GenesisGridDatasourceElement extends GenesisGridDatasourceElement_b
803
802
  deferredColumnStates: ColumnState[];
804
803
  // (undocumented)
805
804
  deferredGridOptions: GridOptions;
806
- // (undocumented)
807
805
  disablePolling: boolean;
808
- // (undocumented)
809
806
  fields: string;
810
807
  // Warning: (ae-forgotten-export) The symbol "BaseDatasourceErrorEventDetail" needs to be exported by the entry point index.d.ts
811
808
  handleErrors(errors: string | any[], type?: BaseDatasourceErrorEventDetail['type']): void;
@@ -815,29 +812,20 @@ export class GenesisGridDatasourceElement extends GenesisGridDatasourceElement_b
815
812
  protected initializeDatasource(options: DatasourceOptions, fetchMeta?: boolean, startStream?: boolean): Promise<boolean>;
816
813
  // (undocumented)
817
814
  get isRequestServer(): boolean;
818
- // (undocumented)
819
815
  isSnapshot: boolean;
820
- // (undocumented)
821
816
  maxRows: number;
822
- // (undocumented)
823
817
  maxView: number;
824
- // (undocumented)
825
818
  movingView: boolean;
826
- // (undocumented)
819
+ offset: number;
827
820
  orderBy: string;
828
- // (undocumented)
829
821
  pollingInterval: number;
830
- // (undocumented)
831
822
  pollTriggerEvents: string[];
832
823
  // (undocumented)
833
824
  removeFilter(fieldName: string): void;
834
- // (undocumented)
835
825
  request: any;
836
826
  requestAutoSetup: boolean;
837
- // (undocumented)
838
827
  resourceName: string;
839
828
  restartOnReconnection: boolean;
840
- // (undocumented)
841
829
  reverse: boolean;
842
830
  rowDataMapper: Function;
843
831
  // @internal
@@ -847,7 +835,6 @@ export class GenesisGridDatasourceElement extends GenesisGridDatasourceElement_b
847
835
  setFilter(fieldName: string, newFilter: string): void;
848
836
  // (undocumented)
849
837
  protected update: BehaviorSubject<Map<string, string>>;
850
- // (undocumented)
851
838
  viewNumber: number;
852
839
  }
853
840
 
@@ -1316,8 +1303,7 @@ export class GridProServerSideDatasource extends GridProServerSideDatasource_bas
1316
1303
  loadMore(): void;
1317
1304
  // (undocumented)
1318
1305
  onPaginationChanged(event: PaginationChangedEvent): void;
1319
- // (undocumented)
1320
- get params(): any;
1306
+ pagingMode: PagingMode | undefined;
1321
1307
  reloadResourceData(params?: DatasourceOptions): Promise<void>;
1322
1308
  // (undocumented)
1323
1309
  request: any;
@@ -1572,6 +1558,9 @@ export class PaginationStatusBarComponent implements IStatusPanelComp {
1572
1558
  init(params: IStatusPanelParams): void;
1573
1559
  }
1574
1560
 
1561
+ // @public
1562
+ export type PagingMode = 'viewBased' | 'offsetBased';
1563
+
1575
1564
  // @public
1576
1565
  export class ReloadStatusBarComponent implements IStatusPanelComp {
1577
1566
  // (undocumented)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@genesislcap/grid-pro",
3
3
  "description": "Genesis Foundation AG Grid",
4
- "version": "14.323.0",
4
+ "version": "14.324.0",
5
5
  "sideEffects": false,
6
6
  "license": "SEE LICENSE IN license.txt",
7
7
  "main": "dist/esm/index.js",
@@ -38,19 +38,19 @@
38
38
  }
39
39
  },
40
40
  "devDependencies": {
41
- "@genesislcap/foundation-testing": "14.323.0",
42
- "@genesislcap/genx": "14.323.0",
43
- "@genesislcap/rollup-builder": "14.323.0",
44
- "@genesislcap/ts-builder": "14.323.0",
45
- "@genesislcap/uvu-playwright-builder": "14.323.0",
46
- "@genesislcap/vite-builder": "14.323.0",
47
- "@genesislcap/webpack-builder": "14.323.0"
41
+ "@genesislcap/foundation-testing": "14.324.0",
42
+ "@genesislcap/genx": "14.324.0",
43
+ "@genesislcap/rollup-builder": "14.324.0",
44
+ "@genesislcap/ts-builder": "14.324.0",
45
+ "@genesislcap/uvu-playwright-builder": "14.324.0",
46
+ "@genesislcap/vite-builder": "14.324.0",
47
+ "@genesislcap/webpack-builder": "14.324.0"
48
48
  },
49
49
  "dependencies": {
50
- "@genesislcap/foundation-comms": "14.323.0",
51
- "@genesislcap/foundation-logger": "14.323.0",
52
- "@genesislcap/foundation-ui": "14.323.0",
53
- "@genesislcap/foundation-utils": "14.323.0",
50
+ "@genesislcap/foundation-comms": "14.324.0",
51
+ "@genesislcap/foundation-logger": "14.324.0",
52
+ "@genesislcap/foundation-ui": "14.324.0",
53
+ "@genesislcap/foundation-utils": "14.324.0",
54
54
  "@microsoft/fast-colors": "5.3.1",
55
55
  "@microsoft/fast-components": "2.30.6",
56
56
  "@microsoft/fast-element": "1.14.0",
@@ -75,5 +75,5 @@
75
75
  "access": "public"
76
76
  },
77
77
  "customElements": "dist/custom-elements.json",
78
- "gitHead": "08b2db7efcbbcc6498844c18a39c03187afa7cca"
78
+ "gitHead": "22f4afeb8817fd66d92f27f60408eaa2331ad070"
79
79
  }
@@ -1,14 +0,0 @@
1
- <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
-
3
- [Home](./index.md) &gt; [@genesislcap/grid-pro](./grid-pro.md) &gt; [GridProServerSideDatasource](./grid-pro.gridproserversidedatasource.md) &gt; [params](./grid-pro.gridproserversidedatasource.params.md)
4
-
5
- ## GridProServerSideDatasource.params property
6
-
7
- > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
- >
9
-
10
- **Signature:**
11
-
12
- ```typescript
13
- get params(): any;
14
- ```