docs(data-widgets): document why resolveInitPageSize returns 0 for dynamic page size

Author: samuelreichert

packages/pluggableWidgets/datagrid-web/src/features/pagination/pagination.config.ts

@@ -37,6 +37,12 @@ export function paginationConfig(props: MainGateProps): PaginationConfig {
     return Object.freeze(config);
 }
 
+/**
+ * Resolves the initial page size for the first datasource fetch.
+ * Returns 0 when `dynamicPageSize` is configured so that no rows are fetched
+ * before the attribute value is available — the real limit is applied once
+ * `DynamicPaginationFeature` syncs the attribute on setup.
+ */
 export function resolveInitPageSize(props: MainGateProps): number {
     if (props.dynamicPageSize !== undefined) {
         return 0;

packages/pluggableWidgets/gallery-web/src/model/configs/GalleryPagination.config.ts

@@ -39,6 +39,12 @@ export function galleryPaginationConfig(props: GalleryGateProps): GalleryPaginat
     return Object.freeze(config);
 }
 
+/**
+ * Resolves the initial page size for the first datasource fetch.
+ * Returns 0 when `dynamicPageSize` is configured so that no rows are fetched
+ * before the attribute value is available — the real limit is applied once
+ * `DynamicPaginationFeature` syncs the attribute on setup.
+ */
 export function resolveInitPageSize(props: GalleryGateProps): number {
     if (props.dynamicPageSize !== undefined) {
         return 0;