@elasticias/screens 1.0.40 → 1.0.42

package/package.json

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

package/types/elasticias-screens.d.ts

@@ -123,18 +123,19 @@ declare class SearchEntity extends AbstractEntity {
  * automatically; consumers can also pass a `string` for custom keys
  * paired with a compute callback in the picker's preset list.
  */
-type EfDatePresetKey = 'today' | 'this_week' | 'this_month' | 'last_30_days' | 'last_90_days' | 'this_quarter' | 'this_year' | 'custom' | string;
+type EfDatePresetKey = 'all_time' | 'today' | 'this_week' | 'this_month' | 'last_30_days' | 'last_90_days' | 'this_quarter' | 'this_year' | 'custom' | string;
 /**
  * Active date-range filter, owned by `AbstractSearchScreenV2.dateRange`
  * and round-tripped through `ef-datepicker-advanced`. `start`/`end` are
- * inclusive day boundaries (both at 00:00 local time).
+ * inclusive day boundaries (both at 00:00 local time), or both `null`
+ * for the open `'all_time'` range, which filters nothing.
  */
 interface EfDateRange {
-    /** Inclusive start. */
-    start: Date;
-    /** Inclusive end — 00:00 local on the last day. Strict comparisons
-     *  should treat this as `< end + 1 day`. */
-    end: Date;
+    /** Inclusive start. `null` means no lower bound (`'all_time'`). */
+    start: Date | null;
+    /** Inclusive end, 00:00 local on the last day. Strict comparisons
+     *  should treat this as `< end + 1 day`. `null` means no upper bound. */
+    end: Date | null;
     /** Which preset is active (`'custom'` for a manually picked range). */
     presetKey: EfDatePresetKey;
     /** Resolved literal label — formatted date range for `'custom'`,
@@ -146,6 +147,14 @@ interface EfDateRange {
      *  translations finish loading or the language changes. */
     labelKey?: string;
 }
+/**
+ * A range that always has both bounds. Report screens need one: every
+ * widget query is a period, so an open range has no meaning there.
+ */
+type EfBoundedDateRange = EfDateRange & {
+    start: Date;
+    end: Date;
+};
 
 interface DefaultSort {
     field: string;
@@ -543,6 +552,14 @@ interface EfDataCardColumn {
     sortable?: boolean;
     /** Backend sort field — defaults to `field` then `id`. */
     sortField?: string;
+    /**
+     * Direction of the first click on this column's header, when it is
+     * not already the active sort (later clicks toggle). Default `'desc'`,
+     * which suits dates and amounts; a name column usually wants `'asc'`.
+     * Check how the backend orders missing values first: Mongo sorts
+     * null and missing fields ahead of everything else in `asc`.
+     */
+    firstSortDirection?: 'asc' | 'desc';
     /** Date / datetime: pipe format string (default: `'shortDate'` / `'short'`). */
     dateFormat?: string;
     /** Money: ISO currency code (default: `'EUR'`). */
@@ -670,14 +687,27 @@ declare abstract class AbstractSearchScreenV2<TItem = any> extends AbstractScree
     readonly criteria: _angular_core.WritableSignal<SearchEntity>;
     /**
      * Active date-range filter shown in `ef-datepicker-advanced`'s
-     * trigger. Display-only at construction time — actually filters
-     * the search once `onDateRangeChange()` fires (or a screen wires
-     * one in `ngOnInit`).
+     * trigger, and the single source of the criteria's `start`/`end`.
+     * The first search, `clear()` and a picked range all send exactly
+     * what this holds, and a cache restore rebuilds it from the restored
+     * dates, so the chip never reads one period while the list shows
+     * another.
      *
-     * Override `buildDefaultDateRange()` per screen to ship a
-     * different starting preset.
+     * Defaults to `'all_time'` (no dates sent). Override
+     * `buildDefaultDateRange()` per screen to open on a window instead.
      */
     readonly dateRange: _angular_core.WritableSignal<EfDateRange>;
+    /**
+     * Whether this screen offers the date chip at all. Set it to `false`
+     * (`override readonly showDateFilter = false;`) on a screen whose
+     * backend query has no date field, and guard the template's
+     * `<ef-datepicker-advanced>` with `@if (showDateFilter)` (or drop it).
+     * The base then never sends `start`/`end`: not on first load, not
+     * after `clear()`, not from criteria cached by an older session, and
+     * not from `onDateRangeChange()` / `setDateRange()`, which become
+     * no-ops, so a picker left in the template cannot filter either.
+     */
+    readonly showDateFilter: boolean;
     /** Free-text search input value — bound `[(searchText)]` on
      *  ef-smart-bar; drives `runSearch()`. */
     readonly searchQuery: _angular_core.WritableSignal<string>;
@@ -743,11 +773,22 @@ declare abstract class AbstractSearchScreenV2<TItem = any> extends AbstractScree
      */
     protected resetDateRange(): void;
     /**
-     * Build the default `EfDateRange`. Override per screen to ship a
-     * different default — e.g., a 90-day window for low-velocity
-     * catalogues. Default: last 30 days.
+     * Build the default `EfDateRange`. Default: `all_time`, no bounds,
+     * so a typed search finds an old record instead of silently missing
+     * it behind a window nobody chose. Override per screen to open on a
+     * window (e.g. `daysAgo(89)` to `startOfToday()` for `last_90_days`);
+     * the first search and `clear()` then send that window.
      */
     protected buildDefaultDateRange(): EfDateRange;
+    /** Copy the chip's range onto fresh criteria, so what is shown is
+     *  what is sent. Sends nothing when the screen has no date chip. */
+    private seedDateCriteria;
+    /** Rebuild the chip from restored criteria: both dates are shown as
+     *  the custom range they filter on; anything less is `all_time`, and
+     *  `bootstrapInitialSearch()` drops a lone bound so nothing is sent.
+     *  No literal label: the picker formats a custom range itself. */
+    private dateRangeFromCriteria;
+    private toDateOrNull;
     /** Today at 00:00 local time. */
     protected startOfToday(): Date;
     /** N days before today, at 00:00 local time. */
@@ -814,8 +855,9 @@ declare abstract class AbstractSearchScreenV2<TItem = any> extends AbstractScree
      * what the drawer / search box displays matches what the search will
      * actually send (otherwise a stale criteria filter keeps applying
      * while every control reads "Tous"). Base handles the free-text
-     * input and the declared advanced filters; override (calling super)
-     * to sync screen-specific state — status pill, custom switches, ….
+     * input, the date chip and the declared advanced filters; override
+     * (calling super) to sync screen-specific state, such as a status pill
+     * or custom switches.
      */
     protected restoreFilterUiFromCriteria(cached: Record<string, any>): void;
     /**
@@ -999,6 +1041,12 @@ declare abstract class AbstractDetailScreenV2<TItem extends object = any> extend
     private readonly destroyRef;
     private readonly auditHistoryService;
     private readonly shortcuts;
+    /** The in-flight entity / history requests. A newer load drops the
+     *  older one, so a slow response for an id the screen has moved off
+     *  can never overwrite the record it now shows, and destroying the
+     *  screen drops both. */
+    private loadSub?;
+    private auditSub?;
     /** Distinguishes this instance's registration from any other detail
      *  screen alive at once (the outgoing and incoming routed component
      *  can briefly coexist), the same convention ef-row-actions uses:
@@ -1235,18 +1283,25 @@ declare abstract class AbstractReportScreenV2 extends AbstractScreenComponent im
     private readonly registeredWidgets;
     /** Active period. Bound to `ef-datepicker-advanced`; every widget loader
      *  receives its UTC-normalized start/end. */
-    readonly dateRange: _angular_core.WritableSignal<EfDateRange>;
+    readonly dateRange: _angular_core.WritableSignal<EfBoundedDateRange>;
     ngOnInit(): void;
     /** Wired to `<ef-datepicker-advanced (rangeChange)>`. */
     onDateRangeChange(range: EfDateRange): void;
+    /**
+     * Every widget query is a period, so an open range (`all_time`) has no
+     * meaning here. The picker only offers it with `allowAllTime`, which a
+     * report should not set; if one arrives anyway, fall back to the
+     * default period rather than send a null bound.
+     */
+    private boundedOrDefault;
     /** Default period from the config's `DEFAULT_PERIOD` preset. */
-    protected buildDefaultDateRange(): EfDateRange;
+    protected buildDefaultDateRange(): EfBoundedDateRange;
     /**
      * Resolve a built-in {@link EfDatePresetKey} to an inclusive day range
      * (both boundaries at 00:00 local). Unknown keys normalize to
      * `last_30_days`. Weeks start Monday (matches `$dateTrunc`, ADR-015).
      */
-    protected rangeFromPreset(key: EfDatePresetKey): EfDateRange;
+    protected rangeFromPreset(key: EfDatePresetKey): EfBoundedDateRange;
     private startOfToday;
     /**
      * Re-anchor a local-midnight Date to UTC midnight of the same calendar
@@ -1372,4 +1427,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, 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, EfDetailToolbarAction, EfReferenceColumnOpts, EfSearchToolbarAction, LoadOptions, ReferenceDataProvider, ReportWidget, ReportWidgetStatus, ScreenDatatableColumn, ScreenReferenceDataService };