@oneteme/jquery-table 0.0.14 → 0.0.15

package/lib/component/table.component.d.ts

@@ -29,6 +29,11 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     view?: TableViewConfig;
     columnLabels?: Record<string, string>;
     isLoading: boolean;
+    /**
+     * À passer à `true` quand la requête relancée après `lazyColumnsRequested` échoue : les colonnes en attente affichent un bouton
+     * « Réessayer ». Repasser à `false` au nouvel essai.
+     */
+    lazyError: boolean;
     copyFeedback: VisualCopyFeedbackConfig;
     /** Paramètre de contrôle pour réinitialiser barre de recherche. */
     set clearSearchInput(value: boolean | null | undefined);
@@ -51,6 +56,11 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     /** Émis quand la liste des colonnes visibles change (clés dans l’ordre d’affichage). */
     readonly columnsChange: EventEmitter<string[]>;
     readonly visualCopied: EventEmitter<VisualSnapshot>;
+    /**
+     * Clés de toutes les colonnes `lazy` demandées jusqu'ici (cumul), émises quand l'une d'elles est activée pour la première fois.
+     * L'application relance sa requête complète en les incluant puis repasse les nouvelles `data`.
+     */
+    readonly lazyColumnsRequested: EventEmitter<string[]>;
     set paginator(value: MatPaginator | undefined);
     get paginator(): MatPaginator | undefined;
     private _paginator?;
@@ -120,12 +130,20 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     set groupPageSize(v: number);
     get groupSortOrder(): 'asc' | 'desc';
     set groupSortOrder(v: 'asc' | 'desc');
-    /** Gestionnaire du cycle de vie des colonnes lazy (fetch, annulation, statuts, données). */
-    private _lazy;
-    /** Compatibilité template : retourne la map de statuts lazy. */
-    get _lazyColumnStatus(): Map<string, "error" | "loaded" | "idle" | "loading">;
-    /** Compatibilité template : retourne la map de données lazy. */
-    get _lazyColumnData(): Map<string, Map<any, any>>;
+    /**
+     * Statut des colonnes `lazy` déjà demandées (absente = pas encore demandée).
+     * `loading` dure jusqu'à la réception de nouvelles `data` ; la référence change à chaque mise à jour (panneau de slices).
+     */
+    _lazyColumnStatus: Map<string, "error" | "loaded" | "idle" | "loading">;
+    private _lazyFlushQueued;
+    /** Lignes retournées par `config.lazyLoader` : elles remplacent `data` jusqu'au prochain `data`. */
+    private _loaderRows;
+    private _loaderSub?;
+    private _lazyWarned;
+    /** Colonnes de la dernière config résolue : évite de reconstruire le tableau (et d'agiter le panneau de slices) à chaque rafraîchissement. */
+    private _columnsSource?;
+    private _columnsNormalized?;
+    private readonly _optionalLazyColumns;
     private _cdr;
     private _el;
     private _ngZone;
@@ -141,7 +159,9 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     /** Retourne true si la ligne de groupe est une ligne normale (ni lazy, ni too-many). */
     isNormalGroupRow(row: any): boolean;
     isGroupRowLoading(row: any): boolean;
+    isGroupRowError(row: any): boolean;
     isGroupRowTooMany(row: any): boolean;
+    retryGroupByColumn(event?: Event): void;
     /** Gère le clic sur une ligne d'en-tête de groupe (no-op pour les états spéciaux). */
     onGroupHeaderClick(row: any): void;
     /** Gestionnaire export CSV. */
@@ -235,16 +255,38 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
         key: string;
         header?: string;
     }): string;
+    /** Traduit les options de la vue table vers celles de l'Organizer. */
+    private _organizerViewConfig;
+    /** Ne change la référence que si le contenu change : le panneau recalcule tout à chaque nouvelle référence. */
+    private _setSliceConfigs;
     onSearchChange(): void;
+    private _runSearch;
     private setGroupByAndEmit;
     onGroupByChange(key: string | null): void;
     onGroupPageSizeChange(size: number | string): void;
     onGroupSortToggle(dir: 'asc' | 'desc'): void;
     getLazyColumnStatus(key: string): 'idle' | 'loading' | 'loaded' | 'error';
     getLazyRenderType(rowValue: any): 'loading' | 'error' | 'value';
-    retryLazyColumn(column: TableColumnProvider<T>): void;
-    triggerLazyFetch(column: TableColumnProvider<T>): void;
-    private _lazyCallbacks;
+    /** Relance la demande des colonnes en erreur : le chargeur est rappelé, ou l'application refait sa requête complète. */
+    retryLazyColumns(): void;
+    /** Colonnes lazy dont la valeur est nécessaire : affichées, utilisées en Group by ou en Slice by dynamique. */
+    private _usedLazyColumns;
+    /**
+     * Quel que soit le chemin d'activation (Organizer, Group by, Slice by, préférences...), les colonnes lazy utilisées et pas encore
+     * demandées sont réclamées en un seul événement. Hors cycle de détection, et seulement une fois des lignes affichées :
+     * la première réponse de l'application ne doit pas être prise pour celle qui contient les colonnes.
+     */
+    private _requestLazyColumns;
+    /** Appelle `config.lazyLoader` avec toutes les colonnes lazy demandées ; sa réponse remplace `data`. */
+    private _runLazyLoader;
+    /** Nouveau `data` : il l'emporte sur les lignes du chargeur. Avec un chargeur, les colonnes déjà demandées sont rechargées. */
+    private _onNewData;
+    /** Sans chargeur ni écouteur, la colonne demandée resterait en skeleton sans que rien ne l'explique. */
+    private _warnIfNoLazySource;
+    /** De nouvelles `data` sont arrivées : toutes les colonnes demandées sont considérées comme prêtes. */
+    private _settleLazyColumns;
+    private _applyLazyError;
+    private _setLazyStatus;
     toggleGroupCollapse(groupKey: string): void;
     private scrollToGroupHeader;
     isGroupCollapsed(groupKey: string): boolean;
@@ -290,6 +332,7 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     getCellTemplate(key: string): TemplateRef<{
         $implicit: any;
         index: number;
+        value: any;
     }> | null;
     get hasCustomCellDefs(): boolean;
     get hasRowClickHandler(): boolean;
@@ -352,6 +395,9 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     private _executeRender;
     private _projectCurrentPage;
     private buildEffectiveConfig;
+    /** Une colonne lazy est forcément optionnelle : `optional` est implicite, et `optional: false` est refusé. */
+    private _normalizeColumns;
+    private _withImpliedOptional;
     private applyConfigSearchReset;
     private applyInitialSearchQuery;
     private static _hashColumns;
@@ -359,8 +405,10 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     private resolveColumnsFromCompat;
     private getCategoryFilteredData;
     private projectRows;
+    /** Comparateur dont les valeurs de tri sont calculées une seule fois par ligne. */
     private _buildSortComparator;
     private _buildCachedSortComparator;
+    private static readonly _collator;
     private _compareSortValues;
     private _normalizeSortValue;
     private _applySortDirection;
@@ -371,6 +419,10 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
      */
     private getDisplayValueForSearch;
     private getLazyAwareValue;
+    /** Les nombres et les dates gardent leur type pour un tri correct ; le reste est normalisé en texte. */
+    private _toSortInput;
+    /** Les statuts de chargement lazy ne doivent jamais apparaître dans un fichier exporté. */
+    private _resolveExportValue;
     private resolveCellValue;
     private resolvePageSize;
     private resolvePageSizeOptions;
@@ -380,6 +432,6 @@ export declare class TableComponent<T = any> implements OnChanges, AfterContentI
     private attachPaginator;
     private attachSort;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TableComponent<any>, "jquery-table", never, { "config": { "alias": "config"; "required": false; }; "dataSource": { "alias": "dataSource"; "required": false; }; "data": { "alias": "data"; "required": false; }; "displayedColumns": { "alias": "displayedColumns"; "required": false; }; "columnsConfig": { "alias": "columnsConfig"; "required": false; }; "view": { "alias": "view"; "required": false; }; "columnLabels": { "alias": "columnLabels"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; }; "copyFeedback": { "alias": "copyFeedback"; "required": false; }; "clearSearchInput": { "alias": "clearSearchInput"; "required": false; }; }, { "addRequested": "addRequested"; "columnAdded": "columnAdded"; "columnRemoved": "columnRemoved"; "categorySelected": "categorySelected"; "rowSelected": "rowSelected"; "sortChange": "sortChange"; "pageChange": "pageChange"; "searchChange": "searchChange"; "groupByChange": "groupByChange"; "columnsChange": "columnsChange"; "visualCopied": "visualCopied"; }, ["_cellDefs"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TableComponent<any>, "jquery-table", never, { "config": { "alias": "config"; "required": false; }; "dataSource": { "alias": "dataSource"; "required": false; }; "data": { "alias": "data"; "required": false; }; "displayedColumns": { "alias": "displayedColumns"; "required": false; }; "columnsConfig": { "alias": "columnsConfig"; "required": false; }; "view": { "alias": "view"; "required": false; }; "columnLabels": { "alias": "columnLabels"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; }; "lazyError": { "alias": "lazyError"; "required": false; }; "copyFeedback": { "alias": "copyFeedback"; "required": false; }; "clearSearchInput": { "alias": "clearSearchInput"; "required": false; }; }, { "addRequested": "addRequested"; "columnAdded": "columnAdded"; "columnRemoved": "columnRemoved"; "categorySelected": "categorySelected"; "rowSelected": "rowSelected"; "sortChange": "sortChange"; "pageChange": "pageChange"; "searchChange": "searchChange"; "groupByChange": "groupByChange"; "columnsChange": "columnsChange"; "visualCopied": "visualCopied"; "lazyColumnsRequested": "lazyColumnsRequested"; }, ["_cellDefs"], never, true, never>;
 }
 export {};

package/lib/component/table.constants.d.ts

@@ -10,6 +10,8 @@ export declare const GROUP_ROW_COLUMN = "__group_row";
 export declare const GROUP_HEADER_MARKER = "__groupHeader";
 /** Clé du groupe spéciale « chargement lazy en cours ». */
 export declare const GROUP_KEY_LAZY_LOADING = "__lazy_loading__";
+/** Clé du groupe spéciale « chargement lazy en erreur ». */
+export declare const GROUP_KEY_LAZY_ERROR = "__lazy_error__";
 /** Clé du groupe spéciale « trop de groupes ». */
 export declare const GROUP_KEY_TOO_MANY = "__too_many_groups__";
 /** Propriété injectée dans chaque ligne projetée : référence vers la ligne brute d'origine. */

package/lib/directive/jqt-cell-def.directive.d.ts

@@ -11,18 +11,22 @@ import * as i0 from "@angular/core";
  *   </ng-template>
  * </jquery-table>
  * ```
- * Le contexte expose `$implicit` (ligne brute `T`) et `index` (index global).
+ * Le contexte expose `$implicit` (ligne brute `T`), `index` (index global) et `value` (valeur affichée de la cellule,
+ * y compris pour une colonne `lazy` dont la valeur n'est pas présente dans la ligne brute).
+ * Pour une colonne `lazy`, le template n'est rendu qu'une fois la valeur chargée ; le chargement et l'erreur sont gérés par le tableau.
  */
 export declare class JqtCellDefDirective {
     readonly template: TemplateRef<{
         $implicit: any;
         index: number;
+        value: any;
     }>;
     /** Clé de la colonne à laquelle ce template s'applique. */
     columnKey: string;
     constructor(template: TemplateRef<{
         $implicit: any;
         index: number;
+        value: any;
     }>);
     static ɵfac: i0.ɵɵFactoryDeclaration<JqtCellDefDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<JqtCellDefDirective, "[jqtCellDef]", never, { "columnKey": { "alias": "jqtCellDef"; "required": false; }; }, {}, never, never, true, never>;

package/lib/jquery-table.model.d.ts

@@ -2,7 +2,8 @@ import { DataProvider } from '@oneteme/jquery-core';
 import { Observable } from 'rxjs';
 import { OrganizerConfig, SliceConfig } from '@oneteme/jquery-organizer';
 export { SliceConfig } from '@oneteme/jquery-organizer';
-export interface TableColumnProvider<T = any> {
+/** Propriétés communes à toutes les colonnes ; voir `TableColumnProvider`. */
+export interface TableColumnBase<T = any> {
     key: string;
     /** Libellé affiché dans l'en-tête de colonne. Optionnel si la colonne utilise un template custom. */
     header?: string;
@@ -20,18 +21,36 @@ export interface TableColumnProvider<T = any> {
     /** Active le tri ; `true` par défaut. */
     sortable?: boolean;
     removable?: boolean;
-    optional?: boolean;
     width?: string;
     /** Rend la colonne disponible dans Group by ; `true` par défaut si `header` est défini. */
     groupable?: boolean;
     /** Rend la colonne disponible comme Slice by dynamique ; `true` par défaut si `header` est défini. */
     sliceable?: boolean;
-    /** Chargement différé : la présence de cet objet active le mode lazy. */
-    lazy?: {
-        /** Fonction appelée pour charger les valeurs de la colonne. Retourne un tableau dans le même ordre que les lignes. */
-        fetchFn: () => Observable<any[]>;
-    };
 }
+/**
+ * Colonne du tableau.
+ *
+ * - `optional: true` : masquée par défaut, ajoutable depuis le menu View.
+ * - `lazy: true` : absente de la requête de base, demandée à sa première activation (Organizer, Group by, Slice by).
+ *   Une colonne lazy est forcément optionnelle : `optional: true` est implicite et `optional: false` est refusé
+ *   (la colonne serait demandée dès le premier rendu, soit une requête de plus pour rien).
+ *   Le chargement passe par `TableProvider.lazyLoader`, ou par l'événement `lazyColumnsRequested` si l'application
+ *   préfère relancer elle-même sa requête. La cellule affiche un skeleton jusqu'à la réception des lignes complètes ;
+ *   la colonne supporte ensuite tri, recherche, Group by et Slice by.
+ */
+export type TableColumnMode = {
+    lazy?: undefined;
+    optional?: boolean;
+} | {
+    lazy: true;
+    optional?: true;
+};
+export type TableColumnProvider<T = any> = TableColumnBase<T> & TableColumnMode;
+/**
+ * Charge les colonnes `lazy` : reçoit les clés des colonnes lazy demandées jusqu'ici (cumul) et retourne les lignes complètes,
+ * qui remplacent `data` ; la requête est celle de l'application, la table ne connaît pas la source.
+ */
+export type TableLazyLoader<T = any> = (lazyColumns: string[]) => Observable<T[]>;
 /** Configuration de la barre de recherche. */
 export interface TableSearchConfig {
     enabled?: boolean;
@@ -86,7 +105,7 @@ export interface TableOrganizerConfig {
  * ]
  * ```
  */
-export declare function col<T = any>(key: string, header: string, overrides?: Partial<TableColumnProvider<T>>): TableColumnProvider<T>;
+export declare function col<T = any>(key: string, header: string, overrides?: Partial<TableColumnBase<T>> & TableColumnMode): TableColumnProvider<T>;
 /** Configuration de l’export CSV déclenché depuis la toolbar. */
 export interface TableExportConfig<T = any> {
     /** Affiche le bouton Export dans la toolbar. Par défaut : `true`. */
@@ -175,6 +194,11 @@ export interface TableProvider<T = any> {
     onRowSelected?: (row: T, event: MouseEvent | null) => void;
     /** Configuration de l'export CSV. */
     export?: TableExportConfig<T>;
+    /**
+     * Chargeur des colonnes `lazy` : appelé à l'activation d'une colonne lazy (et après chaque nouveau `data` si des colonnes
+     * ont déjà été demandées). Sans chargeur, la table émet seulement `lazyColumnsRequested`.
+     */
+    lazyLoader?: TableLazyLoader<T>;
     /** Configuration de la fonctionnalité Préférences (édition + persistance localStorage). */
     preferences?: TablePreferencesConfig;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneteme/jquery-table",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "jquery table lib",
   "homepage": "https://github.com/oneteme/jquery-charts",
   "bugs": "https://github.com/oneteme/jquery-charts/issues",
@@ -13,8 +13,8 @@
     "@angular/core": ">=16.1.0",
     "@angular/material": "^16.1.0",
     "@angular/cdk": "^16.1.0",
-    "@oneteme/jquery-core": "^0.0.37",
-    "@oneteme/jquery-organizer": "^0.0.6"
+    "@oneteme/jquery-core": "^0.0.38",
+    "@oneteme/jquery-organizer": "^0.0.7"
   },
   "dependencies": {
     "tslib": "^2.3.0"