@oneteme/jquery-table 0.0.1 → 0.0.3

package/lib/jqt-i18n.token.d.ts

@@ -0,0 +1,87 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Labels de l'interface utilisateur de jquery-table.
+ *
+ * Fournir ce token au niveau du module ou du composant racine pour localiser
+ * ou personnaliser tous les textes de la bibliothèque en un seul endroit :
+ *
+ * ```ts
+ * providers: [
+ *   { provide: JQT_I18N, useValue: { searchPlaceholder: 'Search…', emptyState: 'No data' } }
+ * ]
+ * ```
+ *
+ * Tous les champs sont optionnels : seul ce que vous fournissez écrase les
+ * valeurs par défaut françaises.
+ */
+export interface JqtI18n {
+    /** Placeholder de la barre de recherche. */
+    searchPlaceholder: string;
+    /** Titre du bouton pour déplier le panneau de filtres. */
+    expandFilterTitle: string;
+    /** Titre du bouton pour replier le panneau de filtres. */
+    collapseFilterTitle: string;
+    /** Label du sous-menu "Champs" dans View. */
+    viewMenuFields: string;
+    /** Label du sous-menu "Group by" dans View. */
+    viewMenuGroupBy: string;
+    /** Label du sous-menu "Slice by" dans View. */
+    viewMenuSliceBy: string;
+    /** Label affiché quand aucune option n'est sélectionnée (groupe, slice). */
+    viewNoneSelected: string;
+    /** Bouton "Retirer le groupe" dans la barre de groupe. */
+    groupRemove: string;
+    /** Label "Trier :" dans la barre de groupe. */
+    groupSortLabel: string;
+    /** Tooltip tri ascendant. */
+    groupSortAsc: string;
+    /** Tooltip tri descendant. */
+    groupSortDesc: string;
+    /** Label "Lignes par groupe" dans le sélecteur de taille de groupe. */
+    groupRowsPerGroup: string;
+    /** Option "Toutes" (afficher toutes les lignes sans pagination de groupe). */
+    groupShowAll: string;
+    /** Message quand le groupe dépasse le nombre maximal autorisé. Reçoit le nombre de groupes. */
+    groupTooMany: (count: number) => string;
+    /** Label du bouton de réessai pour une colonne lazy en erreur. */
+    lazyRetry: string;
+    /** Tooltip du bouton de réessai. */
+    lazyErrorTitle: string;
+    /** Tooltip de l'icône d'erreur dans le menu View > Champs. */
+    lazyErrorMenuTitle: string;
+    /** Valeur affichée dans une cellule vide (null / undefined / ''). */
+    cellEmpty: string;
+    /** Message quand le tableau est vide. */
+    emptyState: string;
+    /** Message pendant le chargement (`[isLoading]="true"`). */
+    loadingState: string;
+    /** Titre du panneau de filtres latéral. Reçoit le nombre de blocs de filtres actifs. */
+    filterPanelTitle: (count: number) => string;
+    /** Titre par défaut d'un bloc de filtre sans `title` configuré. */
+    filterBlockDefaultTitle: string;
+    /** Message dans un bloc de filtre sans catégories correspondantes. */
+    filterEmptyState: string;
+    /** Label du bouton d'export CSV. */
+    exportButtonLabel: string;
+    /** Label du menu Préférences dans View. */
+    preferencesMenuLabel: string;
+    /** Sous-item : activer le mode édition. */
+    preferencesEdit: string;
+    /** Sous-item : enregistrer la config. */
+    preferencesSave: string;
+    /** Sous-item : effacer la config. */
+    preferencesClear: string;
+    /** Message de confirmation après enregistrement. */
+    preferencesSavedMessage: string;
+    /** Message de confirmation après effacement. */
+    preferencesClearedMessage: string;
+    /** Tooltip du bouton de validation du mode édition. */
+    preferencesConfirmEdit: string;
+}
+/** Valeurs par défaut (français). Toutes les propriétés sont garanties non nulles. */
+export declare const JQT_I18N_DEFAULTS: JqtI18n;
+/**
+ * Token d'injection pour surcharger tout ou partie des labels de jquery-table.
+ * Accepte un `Partial<JqtI18n>` — seules les clés fournies écrasent les défauts.
+ */
+export declare const JQT_I18N: InjectionToken<Partial<JqtI18n>>;

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

@@ -10,6 +10,13 @@ export interface TableColumnProvider<T = any> {
     value?: DataProvider<any>;
     /** Valeur utilisée pour le tri si différente de `value`. Utile quand `value` retourne une chaîne formatée (date, durée...). */
     sortValue?: DataProvider<any>;
+    /**
+     * Valeur utilisée pour la recherche plein-texte.
+     * À définir quand la colonne utilise un `jqt-cell-def` template personnalisé et qu'aucun `value` provider n'est déclaré.
+     * Si absent, la recherche utilise `value` en priorité, puis la valeur brute de la ligne.
+     * Exemple : `searchValue: (row) => durationPipe.transform((today - row.start) / 1000)`
+     */
+    searchValue?: DataProvider<string>;
     sortable?: boolean;
     removable?: boolean;
     optional?: boolean;
@@ -27,6 +34,8 @@ export interface TableSearchConfig {
     enabled?: boolean;
     /** Valeur initiale au chargement. */
     initialQuery?: string;
+    /** Restreint la recherche texte aux colonnes dont la `key` est dans ce tableau. Si absent, toutes les colonnes sont cherchées. */
+    searchColumns?: string[];
 }
 /** Configuration de la pagination. */
 export interface TablePaginationConfig {
@@ -52,6 +61,72 @@ export interface TableLabelsConfig {
     /** Affiché pendant le chargement. Par défaut : `'Chargement des données...'`. */
     loading?: string;
 }
+/**
+ * Raccourci pour déclarer une colonne de base.
+ *
+ * ```ts
+ * columns: [
+ *   col('name', 'Nom'),
+ *   col('status', 'Statut', { sortable: false }),
+ * ]
+ * ```
+ */
+export declare function col<T = any>(key: string, header: string, overrides?: Partial<TableColumnProvider<T>>): 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`. */
+    enabled?: boolean;
+    /** Nom du fichier généré. Par défaut : `'export.csv'`. */
+    filename?: string;
+    /**
+     * Transforme chaque ligne avant export.
+     * Si absent, les valeurs affichées (après `normalizeCellValue`) sont utilisées.
+     * Seules les colonnes visibles sont exportées.
+     */
+    transform?: (row: T) => Record<string, string>;
+}
+/**
+ * Configuration de la fonctionnalité Préférences.
+ *
+ * Ajoute un menu "Préférences" dans View qui permet :
+ * - Le **mode édition** (redimensionner / réordonner les colonnes à la souris)
+ * - L'**enregistrement** de la configuration courante dans le localStorage
+ * - L'**effacement** de la configuration sauvegardée
+ *
+ * Chaque tableau est identifié par `tableId` (clé localStorage unique).
+ */
+export interface TablePreferencesConfig {
+    /** Active la fonctionnalité. Par défaut : `true`. */
+    enabled?: boolean;
+    /**
+     * Identifiant unique du tableau, utilisé comme clé localStorage.
+     * Doit être stable entre les rechargements de page.
+     * Si absent, un identifiant est dérivé automatiquement des clés de colonnes.
+     * Exemple : `'user-table'`, `'invoice-list'`.
+     */
+    tableId?: string;
+}
+/** Snapshot de configuration persisté dans le localStorage. */
+export interface SavedTableConfig {
+    /** Valeur de la searchbar. */
+    search?: string;
+    /** Clé de la colonne utilisée pour le group by. `null` = aucun. */
+    groupBy?: string | null;
+    /** Ordre des clés de colonnes (position). */
+    columnOrder?: string[];
+    /** Clés des colonnes visibles. */
+    visibleColumns?: string[];
+    /** Largeurs de colonnes en pixels, indexées par clé. */
+    columnWidths?: Record<string, number>;
+    /** Panneau slice replié ou non. */
+    slicePanelCollapsed?: boolean;
+    /** Clés des slices statiques cachées par l'utilisateur (via toggle dans le menu View). */
+    hiddenSliceKeys?: string[];
+    /** Clés des colonnes utilisées comme slices dynamiques. */
+    dynamicSliceKeys?: string[];
+    /** Filtres actifs du slice panel : map sliceIndex → tableau de clés actives. */
+    sliceFilters?: Record<number, string[]>;
+}
 export interface TableProvider<T = any> {
     columns?: TableColumnProvider<T>[];
     title?: string;
@@ -67,6 +142,13 @@ export interface TableProvider<T = any> {
         active: string;
         direction: 'asc' | 'desc';
     };
+    /** Clé de colonne à utiliser comme group-by par défaut au chargement. N'est pas écrasé par les changements de données ni par un reset explicite de l'utilisateur. */
+    defaultGroupBy?: string | null;
     rowClass?: (row: T, index: number) => string | string[] | Record<string, boolean>;
+    /** Callback déclenché quand l'utilisateur clique sur une ligne. Alternative au `(rowSelected)` Output. */
     onRowSelected?: (row: T, event: MouseEvent | null) => void;
+    /** Configuration de l'export CSV. */
+    export?: TableExportConfig<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.1",
+  "version": "0.0.3",
   "description": "jquery table lib",
   "homepage": "https://github.com/oneteme/jquery-charts",
   "bugs": "https://github.com/oneteme/jquery-charts/issues",
@@ -13,7 +13,7 @@
     "@angular/core": ">=16.1.0",
     "@angular/material": "^16.1.0",
     "@angular/cdk": "^16.1.0",
-    "@oneteme/jquery-core": "^0.0.27"
+    "@oneteme/jquery-core": "^0.0.28"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/public-api.d.ts

@@ -1,4 +1,5 @@
 export * from './lib/jquery-table.model';
+export * from './lib/jqt-i18n.token';
 export * from './lib/component/table.component';
 export * from './lib/component/slice-panel/slice-panel.model';
 export * from './lib/component/slice-panel/slice-panel.component';