@elasticias/ui 1.0.39 → 1.0.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elasticias/ui",
-  "version": "1.0.39",
+  "version": "1.0.41",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",

package/types/elasticias-ui.d.ts

@@ -1600,6 +1600,7 @@ declare class EfAppShellComponent {
     readonly viewport: _angular_core.Signal<_elasticias_core.EfViewport>;
     readonly isMobile: _angular_core.Signal<boolean>;
     readonly showSide: _angular_core.Signal<boolean>;
+    private readonly prefs;
     readonly sideCollapsed: _angular_core.WritableSignal<boolean>;
     /** Shown in the toggle's tooltip: the button is far from the content, the shortcut is not. */
     readonly shortcutHint: string;
@@ -2612,6 +2613,13 @@ declare class EfFormGridComponent {
  * Custom actions can declare `permission` and `visible` like
  * `EfRowAction`. With `[context]` bound, the toolbar filters them
  * against `ScreenContext.isGranted()` automatically.
+ *
+ * Save and actions flagged `requiresWrite` follow `context.canWrite`,
+ * which `AbstractDetailScreenV2` sets from its own `canWrite()` (Edit on
+ * an existing record, Create on a new one or a duplicate). Binding
+ * `[context]="context"` is all a screen does; it does not pass
+ * `[showSaveAction]` for permissions. Without a context, or with one that
+ * carries no `canWrite`, Save behaves as `[showSaveAction]` alone says.
  */
 declare class EfDetailToolbarComponent {
     /** Custom screen-specific actions, rendered before the standard
@@ -2648,6 +2656,10 @@ declare class EfDetailToolbarComponent {
     readonly canPrint: _angular_core.Signal<boolean>;
     readonly canDuplicate: _angular_core.Signal<boolean>;
     readonly canDelete: _angular_core.Signal<boolean>;
+    /** The bound screen's write state; `true` when unknown (no context,
+     *  or a context no detail abstract has stamped), which keeps the
+     *  toolbar's behaviour for those callers what it always was. */
+    readonly canWrite: _angular_core.Signal<boolean>;
     readonly canSave: _angular_core.Signal<boolean>;
     readonly hasStandardActions: _angular_core.Signal<boolean>;
     readonly hasCustomActions: _angular_core.Signal<boolean>;
@@ -3142,7 +3154,7 @@ declare abstract class AbstractEfFormControl {
     readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The `[disabled]` input. The **effective** disabled (input OR
-     *  form-driven via CVA) is {@link isDisabled} — bind that in templates. */
+     *  form-driven via CVA, or an enclosing `[efReadOnly]` scope) is {@link isDisabled} — bind that in templates. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Form-driven disabled set by CVA `setDisabledState`, merged with the
      *  `[disabled]` input. Writable signal (the input itself is read-only). */
@@ -3150,6 +3162,8 @@ declare abstract class AbstractEfFormControl {
     /** Effective disabled state — the `[disabled]` input OR a reactive-form
      *  `disable()`. Templates/logic should use this, not `disabled()`. */
     readonly isDisabled: _angular_core.Signal<boolean>;
+    /** Optional enclosing `[efReadOnly]` scope — disables the control when set. */
+    private readonly readOnlyScope;
     /** CVA hook for subclasses: `setDisabledState(d) { this.updateDisabledState(d); }`. */
     protected updateDisabledState(disabled: boolean): void;
     /**
@@ -3613,6 +3627,10 @@ declare class EfDatepickerComponent implements ControlValueAccessor {
     showButtonBar: boolean;
     minDate?: Date;
     maxDate?: Date;
+    /** Optional enclosing `[efReadOnly]` scope. */
+    private readonly readOnlyScope;
+    /** Effective disabled: the input / CVA state OR a read-only scope. */
+    get isDisabled(): boolean;
     /**
      * Take focus on load. Bound explicitly rather than left unset: PrimeNG's
      * AutoFocus directive tests `autofocus === false`, and the control declares
@@ -3953,6 +3971,10 @@ declare class EfQuantityStepperComponent implements ControlValueAccessor {
      * When present, it specifies that the component should be disabled
      */
     disabled: boolean;
+    /** Optional enclosing `[efReadOnly]` scope. */
+    private readonly readOnlyScope;
+    /** Effective disabled: the input / CVA state OR a read-only scope. */
+    get isDisabled(): boolean;
     /**
      * Callback to invoke when the value changes
      */
@@ -4407,9 +4429,11 @@ interface EfRowAction {
     visible?: boolean;
     /**
      * If set, the item is hidden unless the bound `ScreenContext`
-     * grants this permission. Items with no `permission` always show.
+     * grants this permission, or every permission in the array (e.g.
+     * Duplicate needs `[Duplicate, Create]`, since a duplicate is saved
+     * through create). Items with no `permission` always show.
      */
-    permission?: Permissions;
+    permission?: Permissions | ReadonlyArray<Permissions>;
     /** Click handler. The container handles closing the popup. */
     command?: () => void;
 }
@@ -4464,6 +4488,7 @@ type EfTableDensity = 'compact' | 'default' | 'comfortable';
  */
 declare class EfDataCardComponent<TRow = any> implements AfterContentInit {
     private readonly viewport;
+    private readonly prefs;
     private readonly configuredMobileLayout;
     readonly isMobile: _angular_core.Signal<boolean>;
     /** Per-screen override of the app-wide default. */
@@ -5320,6 +5345,30 @@ declare class EfFilterPillComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfFilterPillComponent, "ef-filter-pill", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "hasClear": { "alias": "hasClear"; "required": false; "isSignal": true; }; "hasPopover": { "alias": "hasPopover"; "required": false; "isSignal": true; }; "popoverOpen": { "alias": "popoverOpen"; "required": false; "isSignal": true; }; "clearAriaKey": { "alias": "clearAriaKey"; "required": false; "isSignal": true; }; }, { "pillClick": "pillClick"; "clearClick": "clearClick"; }, never, ["[popover]"], true, never>;
 }
 
+/**
+ * Scopes a read-only state to every descendant `ef-*` form control.
+ *
+ * Drop it on the container that wraps a form and bind whether the current
+ * user lacks write access; descendant controls fold it into their effective
+ * disabled state, so no per-field `[disabled]` binding is needed:
+ *
+ * ```html
+ * <div class="detail-grid" [efReadOnly]="!canWrite()">
+ *   <ef-input-text name="companyName" ... />
+ *   <ef-select     name="clientType"  ... />
+ * </div>
+ * ```
+ *
+ * The input is a signal, so toggling it re-enables the controls under
+ * zoneless change detection (controls read it through `isDisabled`).
+ */
+declare class EfReadOnlyDirective {
+    /** When true, every descendant ef-* control renders disabled. */
+    readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<EfReadOnlyDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<EfReadOnlyDirective, "[efReadOnly]", never, { "readOnly": { "alias": "efReadOnly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Scopes a map of server/validation errors to its descendant `ef-*` form
  * controls, which auto-link by their `name` — no per-field `[errors]`
@@ -6090,5 +6139,5 @@ declare class EfEmailMetricsCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EfEmailMetricsCardComponent, "ef-email-metrics-card", never, { "metrics": { "alias": "metrics"; "required": false; "isSignal": true; }; "recentEvents": { "alias": "recentEvents"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "rangeChange": "rangeChange"; }, never, never, true, never>;
 }
 
-export { EF_BADGE_BG_COLORS, EF_BADGE_BG_LIGHT_COLORS, EF_BADGE_BORDER_COLORS, EF_BADGE_DEFAULTS, EF_BADGE_TEXT_COLORS, EF_CHART_PALETTE, EF_DATATABLE_ACTIONS_DEFAULTS, EF_DATATABLE_COLUMN_DEFAULTS, EF_DATATABLE_DEFAULTS, EF_DATA_CARD_MOBILE_LAYOUT, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfAboutDialogComponent, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChangePasswordComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfOverflowTooltipDirective, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfProfileMenuComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRadioComponent, EfRankListComponent, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfServerErrorsDirective, EfShortcutsDialogComponent, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
+export { EF_BADGE_BG_COLORS, EF_BADGE_BG_LIGHT_COLORS, EF_BADGE_BORDER_COLORS, EF_BADGE_DEFAULTS, EF_BADGE_TEXT_COLORS, EF_CHART_PALETTE, EF_DATATABLE_ACTIONS_DEFAULTS, EF_DATATABLE_COLUMN_DEFAULTS, EF_DATATABLE_DEFAULTS, EF_DATA_CARD_MOBILE_LAYOUT, EF_STATUS_COLORS, EF_STATUS_COLOR_ALIASES, EfAboutDialogComponent, EfActivationFilterComponent, EfAppMainComponent, EfAppShellComponent, EfAppShellMobileComponent, EfAppTopComponent, EfBadgeComponent, EfBlockUiComponent, EfBlockableDivComponent, EfBottomSheetComponent, EfBuildStampComponent, EfBulkBarComponent, EfButtonComponent, EfButtonGroupComponent, EfCardComponent, EfChangeHistoryComponent, EfChangePasswordComponent, EfChartComponent, EfCheckboxComponent, EfClearButtonComponent, EfColumnHeaderTemplateDirective, EfColumnTemplateDirective, EfCompactPipe, EfConfirmDialogComponent, EfCurrencyPipe, EfDataCardComponent, EfDatatableActionBarComponent, EfDatatableComponent, EfDatepickerAdvancedComponent, EfDatepickerComponent, EfDetailToolbarComponent, EfDialogComponent, EfEmailMetricsCardComponent, EfEmptyStateComponent, EfFabComponent, EfFieldsetComponent, EfFilterDrawerComponent, EfFilterPillComponent, EfFormGridComponent, EfInputNumberComponent, EfInputTextComponent, EfKpiCardComponent, EfLabelComponent, EfModuleRailComponent, EfModuleSideComponent, EfMultiSelectComponent, EfOrderBuilderComponent, EfOrderSummaryComponent, EfOverflowTooltipDirective, EfPagerComponent, EfPasswordComponent, EfPdfPreviewComponent, EfPillGroupComponent, EfPresetPillComponent, EfPriceDisplayComponent, EfProductCatalogueComponent, EfProductCatalogueFilterComponent, EfProductTypeaheadComponent, EfProfileChipComponent, EfProfileMenuComponent, EfPulseComponent, EfQuantitySelectorComponent, EfQuantityStepperComponent, EfRadioComponent, EfRankListComponent, EfReadOnlyDirective, EfRowActionsComponent, EfSearchToolbarComponent, EfSelectButtonComponent, EfSelectComponent, EfServerErrorsDirective, EfShortcutsDialogComponent, EfSkeletonComponent, EfSmartBarComponent, EfStatsComponent, EfStatusChipComponent, EfTabPanelDirective, EfTabsComponent, EfTextareaComponent, EfThemeConfiguratorComponent, EfThemeToggleComponent, EfTimelineComponent, EfToastRegionComponent, EfToggleSwitchComponent, EfToolbarComponent, EfTooltipDirective, EfTotalsComponent, OrderEntityHelper, OrderLineItemHelper, TruncatePipe, buildChartConfig, getColumnAlignment, mergeColumnDefaults, resolveEfStatusColor };
 export type { CatalogueProduct, CatalogueProductVariant, CategoryAssignment, CategoryGroup, CategoryItem, DatatableSearchEntity, DocumentConfig, EfAboutServer, EfBadgeColor, EfBadgeConfig, EfBadgeSize, EfBadgeVariant, EfButtonComptoirSeverity, EfButtonPrimeNGSeverity, EfButtonSeverity, EfChangeHistoryEntry, EfChangeHistoryFieldChange, EfChangePasswordSubmit, EfChartSeries, EfChartType, EfDataCardMobileLayout, EfDataCardRowAction, EfDatatableActions, EfDatatableColumn, EfDatatableColumnAlign, EfDatatableColumnType, EfDatatableConfig, EfDateFieldValue, EfDatePreset, EfDialogAction, EfDialogSeverity, EfDialogSize, EfFabPosition, EfKpiDeltaTone, EfKpiSparkline, EfPillItem, EfPresetItem, EfProfileMenuItem, EfRankRow, EfRowAction, EfSkeletonVariant, EfStatsRow, EfStatusColor, EfStatusReferenceItem, EfTabItem, EfTabsModule, EfTabsVariant, EfTimelineItem, EfTimelineState, EfToastRegionPosition, EfTotalsGrand, EfTotalsRow, HighlightSegment, OrderChangeInfo, OrderEntity, OrderLineItem, OrderProductsSummary, OrderSummaryItem, ProductCountGroup, ProductCountGroupLabel, ProductTypeaheadRow, ProductTypeaheadSelection, ProductWithCountGroup, SelectedFilter, ValidationResult };