@elasticias/screens 1.0.48 → 1.0.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elasticias/screens",
-  "version": "1.0.48",
+  "version": "1.0.49",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",

package/types/elasticias-screens.d.ts

@@ -5,7 +5,7 @@ import { Subject, Observable } from 'rxjs';
 import { Permissions } from '@elasticias/types';
 import { Router, ActivatedRoute } from '@angular/router';
 import { NgForm } from '@angular/forms';
-import { CacheService, ToastService, ConfirmDialogService } from '@elasticias/core';
+import { CacheService, ToastService, ConfirmDialogService, EfConfirmOptions } from '@elasticias/core';
 import { Table, TableLazyLoadEvent } from 'primeng/table';
 import { Location } from '@angular/common';
 
@@ -538,12 +538,34 @@ interface EfDataCardColumn {
      * always excluded regardless.
      */
     hideable?: boolean;
+    /**
+     * Start the column hidden. The viewer can still show it from the
+     * Columns picker, and that choice is saved per `tableKey` through
+     * `EF_PREFERENCE_STORE` like any other hidden column, so it wins on
+     * the next visit. Use it for a column a wide table can do without at
+     * first sight (a sort position, an internal code).
+     *
+     * Ignored with `hideable: false` and on `select` / `actions`: a column
+     * the picker does not list could never be shown again.
+     *
+     * A table whose preferences were saved before the column became
+     * `defaultHidden` keeps the saved list, which shows it.
+     */
+    defaultHidden?: boolean;
     /**
      * Set `false` to keep this column out of a CSV export. Use it for
      * columns that only make sense on screen — a thumbnail, a rendered
      * badge with no underlying value. Defaults to exported.
      */
     exportable?: boolean;
+    /**
+     * The value this column writes to a CSV export, given the row. Use it
+     * where the screen shows a label composed from codes (a kind plus its
+     * rule), so the file says what the screen said. It wins over the
+     * built-in reference lookup and raw value; `null`/`undefined` become an
+     * empty cell.
+     */
+    exportValue?: (row: any) => unknown;
     /** Inline CSS width (e.g. `'40px'`, `'15%'`). */
     width?: string;
     /** Extra CSS classes to apply on the `<td>` (e.g. `'num'`). */
@@ -608,6 +630,13 @@ interface EfDataCardExportRequest {
     resolveCell: (row: unknown, col: EfDataCardColumn) => unknown;
 }
 
+/**
+ * What a search screen may add to its delete confirmation: the copy, the
+ * name, the params. `accept` and `reject` stay with the base, so the
+ * delete call, the `errors` handling, the new search and the toast are
+ * the same on every screen.
+ */
+type EfDeleteConfirmOptions = Partial<Omit<EfConfirmOptions, 'accept' | 'reject' | 'intent'>>;
 /**
  * Declarative definition of an advanced-search select filter rendered in
  * the filter drawer. One `<ef-select>` is rendered per entry; the screen
@@ -662,6 +691,15 @@ interface AdvancedSelectFilter {
 declare abstract class AbstractSearchScreenV2<TItem = any> extends AbstractScreenComponent implements OnInit {
     protected readonly screenState = ScreenStateEnum.SEARCH;
     protected readonly injector: Injector;
+    private readonly destroyRef;
+    /**
+     * A delete confirm is loading or open. A second click (or the row
+     * shortcut) meanwhile is ignored, so one gesture cannot start two impact
+     * reads or stack two confirms. Cleared when the confirm is answered
+     * (PrimeNG calls reject on close and Escape too) or when the read
+     * yields no confirm.
+     */
+    private deleteConfirmBusy;
     private serviceInstance;
     /**
      * Translate lazily, through the injector.
@@ -929,7 +967,33 @@ declare abstract class AbstractSearchScreenV2<TItem = any> extends AbstractScree
      * ```
      */
     protected getDeleteConfirmName(_id: any): string | undefined;
+    /**
+     * Async details for the delete confirmation, read before it opens. Use
+     * it when the confirm has to say what the delete will take with it, such
+     * as how many products lose a collection:
+     *
+     * ```ts
+     * protected override getDeleteConfirmOptions(id: any) {
+     *   return this.collectionsClient.deleteImpact(id).pipe(
+     *     map(impact => ({
+     *       messageKey: impact.onHome ? 'x_delete_message_home' : 'x_delete_message',
+     *       messageParams: { count: impact.productCount ?? 0 },
+     *     })),
+     *   );
+     * }
+     * ```
+     *
+     * The returned options are merged over `{ intent: 'delete', name:
+     * getDeleteConfirmName(id) }`. Only the first value of an Observable is
+     * used. If the read fails (the HTTP interceptor toasts it) or completes
+     * without a value, no confirm opens and nothing is deleted. Return
+     * `undefined`, the default, to open the confirm at once. While the read
+     * is in flight or the confirm is open, another delete is ignored, and a
+     * screen destroyed during the read opens nothing.
+     */
+    protected getDeleteConfirmOptions(_id: any): Observable<EfDeleteConfirmOptions> | Promise<EfDeleteConfirmOptions> | undefined;
     delete(id: any): void;
+    private openDeleteConfirm;
     duplicate(id: any): void;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AbstractSearchScreenV2<any>, never>;
@@ -977,6 +1041,9 @@ interface EfDetailToolbarAction {
     visible?: boolean;
     /** Disable without removing. */
     disabled?: boolean;
+    /** Translation key saying why the action is disabled; shown in the
+     *  phone overflow menu under the label and as its description. */
+    disabledReasonKey?: string;
     /**
      * If set, the action is hidden unless the bound `ScreenContext`
      * grants this permission. Actions with no `permission` always
@@ -1427,4 +1494,4 @@ declare class ViewModelEntity extends AbstractEntity {
 type EfSearchToolbarAction = EfDetailToolbarAction;
 
 export { AUDIT_HISTORY_SERVICE, AbstractComponent, AbstractDetailScreenComponent, AbstractDetailScreenV2, AbstractEntity, AbstractReportScreenV2, AbstractScreenComponent, AbstractSearchScreenComponent, AbstractSearchScreenV2, AbstractSubScreenComponent, AbstractSubScreenV2, PaginationEnum, SCREEN_REF_DATA_SERVICE, ScreenConfig, ScreenContext, ScreenStateEnum, SearchEntity, SortDirectionEnum, StateUtilsEnum, ViewModelEntity };
-export type { ActiveFilter, AdvancedSelectFilter, AuditHistoryService, DefaultSort, EfBoundedDateRange, EfDataCardColumn, EfDataCardColumnAlign, EfDataCardColumnMobileRole, EfDataCardColumnType, EfDataCardExportRequest, EfDataCardSort, EfDataCardSortDirection, EfDatePresetKey, EfDateRange, EfDetailToolbarAction, EfReferenceColumnOpts, EfSearchToolbarAction, LoadOptions, ReferenceDataProvider, ReportWidget, ReportWidgetStatus, ScreenDatatableColumn, ScreenReferenceDataService };
+export type { ActiveFilter, AdvancedSelectFilter, AuditHistoryService, DefaultSort, EfBoundedDateRange, EfDataCardColumn, EfDataCardColumnAlign, EfDataCardColumnMobileRole, EfDataCardColumnType, EfDataCardExportRequest, EfDataCardSort, EfDataCardSortDirection, EfDatePresetKey, EfDateRange, EfDeleteConfirmOptions, EfDetailToolbarAction, EfReferenceColumnOpts, EfSearchToolbarAction, LoadOptions, ReferenceDataProvider, ReportWidget, ReportWidgetStatus, ScreenDatatableColumn, ScreenReferenceDataService };