@openmfp/ngx 0.14.1 → 0.14.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmfp/ngx",
-  "version": "0.14.1",
+  "version": "0.14.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openmfp/webcomponents.git"

package/types/openmfp-ngx.d.ts

@@ -5,7 +5,6 @@ import * as _openmfp_ngx from '@openmfp/ngx';
 import { Input } from '@fundamental-ngx/ui5-webcomponents/input';
 import { SafeHtml } from '@angular/platform-browser';
 import { GridStackOptions } from 'gridstack';
-import { nodesCB } from 'gridstack/dist/angular';
 
 /** Subset of fields of a generic resource that the table/form components rely on. */
 interface GenericResource extends Record<string, unknown> {
@@ -249,6 +248,27 @@ interface DeleteResourceConfirmationConfig {
     /** Label for the cancel button. */
     cancelLabel?: string;
 }
+/**
+ * One entry in the {@link TableCardConfig.filterTabs} strip rendered above the
+ * table. Clicking a tab activates that filter; the host receives the selected
+ * definition via the `filterTabChanged` output and is responsible for applying
+ * the filter to its data set.
+ *
+ * The strip renders exactly the array of `FieldFilterDefinition` it receives
+ * — no extra "All" / no-filter tab is auto-added. If the host wants such an
+ * option it must author it as a regular filter entry (e.g.
+ * `{ label: 'All', property: '<some-field>', value: '*' }`).
+ */
+interface FieldFilterDefinition {
+    /** Visible label rendered as the tab text. */
+    label: string;
+    /** Name of the property the value applies to. Passed through to the host. */
+    property: string;
+    /** Value compared against `property` when the host applies the filter. */
+    value: string;
+    /** When `true`, this tab is selected on initial render; otherwise the first tab is. */
+    default?: boolean;
+}
 /** Configuration for the inner `mfp-declarative-table`. */
 interface TableConfig {
     /** Column definitions. */
@@ -292,6 +312,11 @@ interface TableCardConfig {
     editResourceFormConfig?: ResourceFormConfig;
     /** When set, enables per-row "Delete" button and confirmation dialog. */
     deleteResourceConfirmationConfig?: DeleteResourceConfirmationConfig;
+    /**
+     * Predefined filters rendered as a horizontal tab strip above the table.
+     * Omit (or pass an empty array) to hide the strip entirely.
+     */
+    filterTabs?: FieldFilterDefinition[];
 }
 
 type SearchState = 'collapsed' | 'expanded' | 'collapsing';
@@ -316,6 +341,7 @@ declare class DeclarativeTableCard<T extends GenericResource> {
         value: Record<string, unknown>;
     }>;
     readonly deleteSubmit: _angular_core.OutputEmitterRef<T>;
+    readonly filterTabChanged: _angular_core.OutputEmitterRef<FieldFilterDefinition | undefined>;
     protected searchState: _angular_core.WritableSignal<SearchState>;
     protected searchExpanded: _angular_core.Signal<boolean>;
     protected searchCollapsing: _angular_core.Signal<boolean>;
@@ -335,8 +361,13 @@ declare class DeclarativeTableCard<T extends GenericResource> {
     protected searchButtonConfig: _angular_core.Signal<Partial<_openmfp_ngx.ButtonSettings> | undefined>;
     protected effectiveColumns: _angular_core.Signal<TableFieldDefinition[]>;
     protected editInitialValue: _angular_core.Signal<Record<string, unknown>>;
+    /** Filter-tab definitions for the strip rendered above the table. */
+    protected filterTabs: _angular_core.Signal<FieldFilterDefinition[]>;
+    /** Whether the tab strip should render at all. */
+    protected hasFilterTabs: _angular_core.Signal<boolean>;
     private readonly injector;
     constructor();
+    protected onFilterTabChanged(tab: FieldFilterDefinition | undefined): void;
     toggleSearch(): void;
     onSearchBlur(): void;
     onSearchAnimationEnd(): void;
@@ -354,7 +385,7 @@ declare class DeclarativeTableCard<T extends GenericResource> {
     private addActionsColumn;
     private buildInitialValues;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DeclarativeTableCard<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DeclarativeTableCard<any>, "mfp-declarative-table-card", never, { "resources": { "alias": "resources"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": true; "isSignal": true; }; "createFormState": { "alias": "createFormState"; "required": false; "isSignal": true; }; "editFormState": { "alias": "editFormState"; "required": false; "isSignal": true; }; }, { "actionButtonClick": "actionButtonClick"; "tableRowClicked": "tableRowClicked"; "loadMoreResources": "loadMoreResources"; "paginationLimitChanged": "paginationLimitChanged"; "searchChanged": "searchChanged"; "createFieldChange": "createFieldChange"; "editFieldChange": "editFieldChange"; "createSubmit": "createSubmit"; "editSubmit": "editSubmit"; "deleteSubmit": "deleteSubmit"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DeclarativeTableCard<any>, "mfp-declarative-table-card", never, { "resources": { "alias": "resources"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": true; "isSignal": true; }; "createFormState": { "alias": "createFormState"; "required": false; "isSignal": true; }; "editFormState": { "alias": "editFormState"; "required": false; "isSignal": true; }; }, { "actionButtonClick": "actionButtonClick"; "tableRowClicked": "tableRowClicked"; "loadMoreResources": "loadMoreResources"; "paginationLimitChanged": "paginationLimitChanged"; "searchChanged": "searchChanged"; "createFieldChange": "createFieldChange"; "editFieldChange": "editFieldChange"; "createSubmit": "createSubmit"; "editSubmit": "editSubmit"; "deleteSubmit": "deleteSubmit"; "filterTabChanged": "filterTabChanged"; }, never, never, true, never>;
 }
 
 type DashboardLanguage = 'en' | 'de';
@@ -436,6 +467,7 @@ interface CardConfig {
     /** Human-readable label shown in the "Add Card" dialog. */
     label?: string;
 }
+type MountCfg = Pick<CardConfig, 'type' | 'component' | 'componentInputs'>;
 /** Configuration for a named horizontal section that groups cards. */
 interface SectionConfig {
     /** Unique identifier for this section. */
@@ -493,6 +525,7 @@ declare class Dashboard implements OnInit, OnDestroy {
     toolbarMenuOpen: _angular_core.WritableSignal<boolean>;
     /** True once the user has dragged/resized any grid item while in edit mode. */
     private gridDirty;
+    protected backgroundImageHeight: _angular_core.WritableSignal<number | null>;
     /** JSON snapshots of sections/cards taken on entering edit mode, used to detect changes. */
     private sectionsSnapshotJson;
     private cardsSnapshotJson;
@@ -573,15 +606,7 @@ declare class Dashboard implements OnInit, OnDestroy {
     enterEditMode(): void;
     saveEdit(): void;
     cancelEdit(): void;
-    /**
-     * Confirms abandoning unsaved edit-mode changes: closes the discard popup
-     * and reverts sections/cards to the snapshot taken on entering edit mode.
-     */
     confirmDiscard(): void;
-    /**
-     * Cancels the discard popup and keeps the user in edit mode with their
-     * pending changes intact.
-     */
     cancelDiscard(): void;
     /**
      * Public framework-agnostic navigation guard. Consumer apps (Angular Router
@@ -623,8 +648,9 @@ declare class Dashboard implements OnInit, OnDestroy {
         added: CardConfig[];
         removed: string[];
     }): void;
-    onGridChange(event: nodesCB): void;
+    onGridChange(): void;
     private saveCardsPosition;
+    private updateCardsPositions;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Dashboard, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<Dashboard, "mfp-dashboard", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "sections": { "alias": "sections"; "required": false; "isSignal": true; }; "cards": { "alias": "cards"; "required": false; "isSignal": true; }; "availableCards": { "alias": "availableCards"; "required": false; "isSignal": true; }; "language": { "alias": "language"; "required": false; "isSignal": true; }; }, { "sections": "sectionsChange"; "cards": "cardsChange"; "saved": "saved"; "actionButtonClick": "actionButtonClick"; "unsavedChangesChange": "unsavedChangesChange"; }, never, ["[slot=dashboard-subheader]"], true, never>;
 }
@@ -1270,4 +1296,4 @@ declare class WhatsNew {
 }
 
 export { BooleanValue, CARD_TYPES, Dashboard, DeclarativeForm, DeclarativeTable, DeclarativeTableCard, Favorites, LinkValue, ResourceField, SecretValue, ServiceStatusCard, TagListValue, VisitedServiceCard, WhatsNew };
-export type { ButtonSettings, CardConfig, CardsType, CssRule, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, RuleCondition, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableConfig, TableFieldDefinition, TransformType, UiSettings, ValueRule };
+export type { ButtonSettings, CardConfig, CardsType, CssRule, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FieldFilterDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, MountCfg, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, RuleCondition, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableConfig, TableFieldDefinition, TransformType, UiSettings, ValueRule };