commons-shared-web-ui 0.0.58 → 0.0.59

package/index.d.ts

@@ -3391,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;
@@ -3413,7 +3445,7 @@ interface TableActionItem {
         cancelLabel?: string;
     };
 }
-interface TableAction {
+interface TableAction extends ActionVisibility {
     label: string;
     type: 'api' | 'callback' | 'route' | 'edit' | 'dropdown';
     icon?: string;
@@ -4637,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;
@@ -4928,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.58",
+  "version": "0.0.59",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",