proje-react-panel 1.11.1 → 1.12.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 This file starts at 1.11.0; earlier releases are only in the git history.
 
+## 1.12.0
+
+### Added
+
+- **Lists size their own pages.** `ListPage` now asks for as many rows as the datagrid can show
+  instead of leaving the page size to the server, which on a tall screen meant ten rows and a large
+  empty area below them. The grid element is measured — not assumed — because a consumer styling its
+  own shell has no fixed `100vh - chrome` height, and any constant here would be silently wrong for
+  them. The row height is the other half of the sum and is *declared* rather than measured:
+  measuring a row would require rendering one first, so the correct page size would always cost a
+  second request. `@List({ rowHeight })` overrides it for taller rows, `@List({ autoCalculate: false })`
+  restores the previous behaviour, and the computed value travels as the existing `limit` query
+  parameter, so no backend change is needed.
+- The declared `rowHeight` is applied to the row inline, and image cells are capped to it. A
+  declaration the library does not enforce is a guess: an `image` cell alone used to make its row
+  roughly three times taller than the rest, which is exactly the case that would break the
+  calculation. A development-only warning names any list that carries an image cell without
+  declaring a row height.
+
+### Fixed
+
+- **The last page of a list is reachable again.** Page count used `Math.floor(total / limit)`, so a
+  final partial page was never drawn: 2151 records at 10 per page offered 215 pages and the last
+  record could not be opened from anywhere. Worse, any list with fewer than two full pages
+  (`total < 2 * limit`) computed a single page and hid the pagination entirely, stranding every
+  record after the first page. It also renders nothing while `limit` is still 0 rather than drawing
+  `NaN` pages.
+- The loading state now fills the datagrid instead of replacing the whole page, so the list header
+  and footer no longer disappear on every page change.
+
 ## 1.11.1
 
 ### Fixed

package/dist/__tests__/build/svgoViewBox.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/components/list/Pagination.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/components/list/listMetrics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/list/Datagrid.d.ts

@@ -4,7 +4,16 @@ import { AnyClass } from '../../types/AnyClass';
 interface DatagridProps<T extends AnyClass> {
     data: T[];
     listPageMeta: ListPageMeta<T>;
+    loading?: boolean;
+    /**
+     * Satir yuksekligi satira UYGULANIR, sadece bildirilmez: otomatik sayfa
+     * boyutu bu sayiya gore hesaplandigi icin gercekle ayrismasina izin
+     * verilemez. Inline veriliyor ki tuketicinin kendi tablo CSS'i olsa da
+     * gecerli olsun.
+     */
+    rowHeight?: number;
+    containerRef?: React.RefObject<HTMLDivElement | null>;
     onRemoveItem?: (item: T) => Promise<void>;
 }
-export declare function Datagrid<T extends AnyClass>({ data, listPageMeta, onRemoveItem, }: DatagridProps<T>): React.JSX.Element;
+export declare function Datagrid<T extends AnyClass>({ data, listPageMeta, loading, rowHeight, containerRef, onRemoveItem, }: DatagridProps<T>): React.JSX.Element;
 export {};

package/dist/components/list/listMetrics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Otomatik sayfa boyutunun iki girdisi var ve ikisi ayri yollardan geliyor:
+ *
+ * - Datagrid'in yuksekligi OLCULUR. Tuketici kutuphanenin liste CSS'ini
+ *   kullanmak zorunda degil (kendi kabugunu yazan bir panelde datagrid ne
+ *   `100vh - 120px`'tir ne de baska bir sabit), dolayisiyla buraya px yazmak
+ *   sessizce yanlislanacak bir varsayim olurdu.
+ * - Satir yuksekligi BEYAN EDILIR ve tabloya dayatilir (`@List({ rowHeight })`).
+ *   Olculmuyor: olcmek icin once satirin render olmasi, yani bir istek atilmis
+ *   olmasi gerekirdi; dogru limit ikinci bir istek demek olurdu.
+ */
+/** Olcum yapilamadiginda (SSR, jsdom, yukseklik 0) kullanilan sayfa boyutu. */
+export declare const LIST_FALLBACK_LIMIT = 10;
+/**
+ * Satirin varsayilan yuksekligi (px): hucre dolgusu + satir kutusu + alt cizgi.
+ * Satirini kendi CSS'iyle degistiren ya da `image` gibi yuksek hucre tasiyan
+ * tuketici `@List({ rowHeight })` ile kendi olcusunu verir.
+ */
+export declare const LIST_ROW_HEIGHT = 44;
+/**
+ * Otomatik hesabin tabani ve tavani: cok kisa ekranda kullanilamaz bir liste,
+ * cok uzun ekranda sunucuyu doven bir sorgu cikmasin.
+ */
+export declare const LIST_MIN_LIMIT = 5;
+export declare const LIST_MAX_LIMIT = 100;
+/**
+ * Datagrid'e kac satir sigiyorsa o kadar kayit iste. Tablo basligi da o alanin
+ * icinde duruyor, o yuzden bir satir dusuluyor; dusulmezse hesap tam bir satir
+ * tasar ve otomatik boyut kendi amacinin tersine scroll uretir.
+ */
+export declare function calculateListLimit(containerHeight: number, rowHeight?: number): number;

package/dist/decorators/list/List.d.ts

@@ -44,6 +44,21 @@ export interface ListOptions<T> {
     actions?: ((item: T) => ListActionOptions<T>) | ListActionOptions<T>;
     primaryId?: string;
     key?: string;
+    /**
+     * Sayfa boyutunu ekrana sigan satir sayisindan hesapla. Varsayilan acik:
+     * sabit bir sayfa boyutu (ornegin 10) buyuk ekranda tablonun altinda kocaman
+     * bir bosluk birakiyordu — datagrid yuksekligi viewport'a civili.
+     * Kapatirsan `getData` limit'i eskisi gibi kendi belirler.
+     */
+    autoCalculate?: boolean;
+    /**
+     * Satir yuksekligi (px). Sadece bir bilgi degil, tabloya UYGULANIR: satira
+     * bu yukseklik verilir ve hucre icerigi (ornegin gorsel) buna kirpilir.
+     * Boylece beyan ile gercek asla ayrisamaz. Yalnizca satirini kendi CSS'iyle
+     * degistiren ya da `image` gibi yuksek hucre tasiyan listelerde gerekir;
+     * verilmezse kutuphanenin kendi olcusu (`LIST_ROW_HEIGHT`) kullanilir.
+     */
+    rowHeight?: number;
 }
 export type ListConfiguration<T> = ListOptions<T> & {
     key: string;