commons-shared-web-ui 0.0.57 → 0.0.59

package/index.d.ts

@@ -9,6 +9,8 @@ import { HttpClient, HttpHeaders } from '@angular/common/http';
 import * as i3$2 from '@angular/router';
 import { Router, ActivatedRoute } from '@angular/router';
 import { BehaviorSubject, Subject, Observable } from 'rxjs';
+import * as i8$1 from '@angular/cdk/overlay';
+import { ConnectedPosition } from '@angular/cdk/overlay';
 import { DomSanitizer, SafeResourceUrl, SafeHtml } from '@angular/platform-browser';
 import * as i1 from '@angular/material/card';
 import * as i3 from '@angular/material/checkbox';
@@ -39,7 +41,7 @@ import * as i26 from '@angular/material/paginator';
 import * as i27 from '@angular/material/table';
 import * as i28 from '@angular/material/expansion';
 import * as i29 from '@angular/cdk/accordion';
-import * as i10$1 from 'ngx-quill';
+import * as i11$2 from 'ngx-quill';
 import * as i11$1 from '@angular/cdk/scrolling';
 import { CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
 
@@ -1635,6 +1637,19 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
      * expected toolbar shape.
      */
     get richTextModules(): any;
+    /**
+     * Preferred positions for the custom dropdown panels, rendered in a CDK
+     * connected overlay so they escape a scrollable modal body (cc-confirmation-modal)
+     * instead of being clipped behind its footer. Opens below the trigger, flipping
+     * above when there isn't room.
+     */
+    readonly dropdownOverlayPositions: ConnectedPosition[];
+    /**
+     * Close the dropdown when the CDK overlay reports a click outside the panel.
+     * Clicks on the trigger itself are ignored here so the trigger's own toggle
+     * handler can close it (otherwise the two would fight and re-open it).
+     */
+    onDropdownOverlayOutsideClick(event: MouseEvent, triggerEl: HTMLElement): void;
     toggleMultiDropdown(event: MouseEvent): void;
     toggleSingleDropdown(event: MouseEvent): void;
     selectSingleOption(option: any): void;
@@ -3047,7 +3062,7 @@ declare class TimePickerModule {
 
 declare class SmartFormModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<SmartFormModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<SmartFormModule, [typeof SmartFormComponent, typeof FormSectionComponent, typeof FormFieldComponent, typeof TrustedUrlPipe], [typeof i2$1.CommonModule, typeof i3$1.ReactiveFormsModule, typeof i3$1.FormsModule, typeof MaterialModule, typeof ButtonModule, typeof AlertModule, typeof i10$1.QuillModule, typeof TimePickerModule], [typeof SmartFormComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SmartFormModule, [typeof SmartFormComponent, typeof FormSectionComponent, typeof FormFieldComponent, typeof TrustedUrlPipe], [typeof i2$1.CommonModule, typeof i3$1.ReactiveFormsModule, typeof i3$1.FormsModule, typeof MaterialModule, typeof i8$1.OverlayModule, typeof ButtonModule, typeof AlertModule, typeof i11$2.QuillModule, typeof TimePickerModule], [typeof SmartFormComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<SmartFormModule>;
 }
 
@@ -3376,7 +3391,39 @@ interface TableFilter {
     handling?: 'standard' | 'nested_string';
     nestedStringConfig?: NestedStringConfig;
 }
-interface TableActionItem {
+/**
+ * A single condition evaluated against a row to decide action visibility.
+ *
+ * `field` is a path into the row (supports nesting + array index, e.g.
+ * 'status.code', 'subStatus.code', 'name[0].text'). When the resolved value is
+ * an object (e.g. `{ code, name, value }`), it is normalized to its `code`
+ * (then `name`, then `value`) so the SAME rule works whether the API returns
+ * `status: { code: 'ACTIVE' }` or `status: 'ACTIVE'`.
+ *
+ * String comparisons are case-insensitive.
+ */
+interface VisibilityRule {
+    /** Path into the row, e.g. 'status.code' or just 'status'. */
+    field: string;
+    /** Comparison operator. Default: 'eq'. */
+    operator?: 'eq' | 'neq' | 'in' | 'nin' | 'truthy' | 'falsy';
+    /** Comparison value for 'eq' / 'neq'. */
+    value?: any;
+    /** Comparison list for 'in' / 'nin'. */
+    values?: any[];
+}
+/**
+ * Row-aware visibility config shared by actions and action items.
+ * - `visibleWhen`: ALL rules must pass (AND) for the action to show.
+ * - `hiddenWhen`: if ANY rule passes (OR), the action is hidden.
+ * `hiddenWhen` takes precedence over `visibleWhen`. Either may be a single
+ * rule or an array of rules.
+ */
+interface ActionVisibility {
+    visibleWhen?: VisibilityRule | VisibilityRule[];
+    hiddenWhen?: VisibilityRule | VisibilityRule[];
+}
+interface TableActionItem extends ActionVisibility {
     label: string;
     type: 'api' | 'callback' | 'route' | 'delete';
     icon?: string;
@@ -3398,7 +3445,7 @@ interface TableActionItem {
         cancelLabel?: string;
     };
 }
-interface TableAction {
+interface TableAction extends ActionVisibility {
     label: string;
     type: 'api' | 'callback' | 'route' | 'edit' | 'dropdown';
     icon?: string;
@@ -4622,10 +4669,30 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
     private calculateStickyPositions;
     private toTitleCase;
     get columnCount(): number;
-    /** Filters out actions/action-items explicitly disabled via `isEnabled: false`. */
+    /**
+     * Filters out actions/action-items that are either explicitly disabled via
+     * `isEnabled: false` or hidden for the given row by their `visibleWhen` /
+     * `hiddenWhen` rules. Pass `row` to enable the row-aware rule evaluation;
+     * omit it (e.g. for header/colspan calculations) to evaluate `isEnabled` only.
+     */
     getVisibleActions<T extends {
         isEnabled?: boolean;
-    }>(actions?: T[] | null): T[];
+    } & ActionVisibility>(actions?: T[] | null, row?: any): T[];
+    /**
+     * Evaluates an action's `visibleWhen` / `hiddenWhen` rules against a row.
+     * `hiddenWhen` wins over `visibleWhen`. With no row or no rules, returns true.
+     */
+    private isActionVisibleForRow;
+    /** Evaluates a single visibility rule against a row. */
+    private evaluateRule;
+    /**
+     * Normalizes a value for comparison. Objects shaped like `{ code, name, value }`
+     * collapse to their `code` (then `name`, then `value`) so a rule targeting
+     * `status` works whether the API returns an object or a plain string.
+     */
+    private normalizeRuleValue;
+    /** Case-insensitive comparison for strings; strict-ish equality otherwise. */
+    private ruleValuesEqual;
     get showPagination(): boolean;
     private applyPaginationDefaults;
     onColumnClick(row: any, col: TableColumn): void;
@@ -4913,4 +4980,4 @@ declare class SnackbarModule {
 }
 
 export { AlertComponent, AlertModule, ButtonComponent, ButtonDropdownComponent, ButtonDropdownModule, ButtonModule, CheckboxComponent, ClickOutsideDirective, ConfigColumnNodeComponent, ConfigFieldNodeComponent, ConfigSchemaTreeService, ConfigSectionNodeComponent, ConfigurableFormComponent, configurableForm_examples_d as ConfigurableFormExamples, ConfigurableFormModule, ConfirmationModalComponent, ConfirmationModalModule, DEFAULT_ITEMS_PER_PAGE, DEFAULT_PAGE_SIZE_OPTIONS, DEFAULT_SIDE_NAV_TOOLTIP_POSITION, DatepickerComponent, DropdownComponent, ExpressionService, FieldConfigurationService, FieldConfiguratorComponent, FieldSelectionComponent, FilterComponent, FilterModule, FilterSidebarComponent, FilterSidebarModule, FilterTableSelectorComponent, FilterTableSelectorModule, FormBuilderModule, FormComponentsModule, FormFieldConfigurationComponent, FormFieldConfigurationModule, InputComponent, MaterialModule, NAV_ORIENTATION_DEFAULT, NAV_VARIANT_DEFAULT, NavComponent, NavModule, PAGINATION_THEME_DARK, PAGINATION_THEME_DEFAULT, PaginationComponent, PaginationModule, RadioComponent, SearchComponent, SharedUiModule, SideNavComponent, SideNavModule, SmartFormComponent, SmartFormController, smartForm_examples_d as SmartFormExamples, SmartFormModule, SmartTableComponent, SmartTableModule, SnackbarComponent, SnackbarModule, SnackbarService, StringUtils, SummaryCardComponent, SummaryCardModule, TableColumnConfigurationComponent, TableColumnConfigurationModule, TableColumnConfigurationService, TimePickerComponent, TimePickerModule, TimeWheelPanelComponent, ToggleComponent, ValidationUtils, appendBaseUrlRecursively, clearLocalStorage, clearSessionStorage, getLocalStorageItem, getSessionStorageItem, removeLocalStorageItem, removeSessionStorageItem, setLocalStorageItem, setSessionStorageItem, translateConfig };
-export type { AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ConfigColumnNode, ConfigFieldNode, ConfigSectionNode, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldConfig, FieldEventPayload, FieldType, FilterChangeEvent, FilterConfig, FilterItem, FilterItemType, FilterOutput, FilterPanelConfig, FilterParamMap, FilterSearchConfig, FilterSidebarChangeEvent, FilterSidebarConfig, FilterSidebarOutput, FilterTableConfig, FilterTableSelectorConfig, FormConfig, FormField, FormOption, FormSchema, FormSection, GeneratedConfig, HierarchyCfg, IconInput, InputConfig, InputLabels, InputType, JsonFieldConfig, JsonFormConfig, KeyType, LengthConstraint, LocationConfig, NavItem, NavStyleConfig, NestedStringConfig, NumberConfig, OptionConfig, OptionDTO, OptionItem, PaginationConfig, PaginationLabels, PhoneConfig, QueryParamsConfig, RadioConfig, RadioLabels, RadioOption, RangeConfig, RatingConfig, SearchConfig, SearchLabels, SectionConfig, SelectionConfig, SideNavItem, SideNavSection, SideNavStyleConfig, SnackbarConfig, SnackbarVariant, StepperConfig, SubmitConfig, SuffixActionIcon, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, TimeMode, TimePickerConfig, TimePickerLabels, TimePickerVariant, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules };
+export type { ActionVisibility, AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ConfigColumnNode, ConfigFieldNode, ConfigSectionNode, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldConfig, FieldEventPayload, FieldType, FilterChangeEvent, FilterConfig, FilterItem, FilterItemType, FilterOutput, FilterPanelConfig, FilterParamMap, FilterSearchConfig, FilterSidebarChangeEvent, FilterSidebarConfig, FilterSidebarOutput, FilterTableConfig, FilterTableSelectorConfig, FormConfig, FormField, FormOption, FormSchema, FormSection, GeneratedConfig, HierarchyCfg, IconInput, InputConfig, InputLabels, InputType, JsonFieldConfig, JsonFormConfig, KeyType, LengthConstraint, LocationConfig, NavItem, NavStyleConfig, NestedStringConfig, NumberConfig, OptionConfig, OptionDTO, OptionItem, PaginationConfig, PaginationLabels, PhoneConfig, QueryParamsConfig, RadioConfig, RadioLabels, RadioOption, RangeConfig, RatingConfig, SearchConfig, SearchLabels, SectionConfig, SelectionConfig, SideNavItem, SideNavSection, SideNavStyleConfig, SnackbarConfig, SnackbarVariant, StepperConfig, SubmitConfig, SuffixActionIcon, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, TimeMode, TimePickerConfig, TimePickerLabels, TimePickerVariant, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules, VisibilityRule };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.57",
+  "version": "0.0.59",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",