@agorapulse/ui-components 22.1.3 → 22.1.5

package/types/agorapulse-ui-components-dropdown-base.d.ts

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
 import { TemplateRef } from '@angular/core';
-import { OverlayRef } from '@angular/cdk/overlay';
+import * as _angular_cdk_overlay from '@angular/cdk/overlay';
+import { FloatingPlacement, FloatingAnchorMode } from '@agorapulse/ui-components/floating';
 
 interface DropdownOverlay {
     open(triggerElement?: HTMLElement): void;
@@ -27,23 +28,31 @@ declare class DropdownTriggerDirective {
 }
 
 interface DropdownOverlayConfig {
+    /** Defaults to `true` — the dropdown keeps its click catcher, unlike the primitive. */
     showBackdrop?: boolean;
-    defaultPosition?: 'right' | 'left';
+    /** Panel placement. Unset means derived from `anchor`, i.e. `bottom-start`. */
+    placement?: FloatingPlacement;
+    /** What the panel connects to. Defaults to `'trigger'`. */
+    anchor?: FloatingAnchorMode;
+    /** Opt-in, and not offered by any existing panel's public API. */
+    arrow?: boolean;
+    /** What the tip points at. Defaults to `'anchor'`. */
+    arrowTarget?: 'anchor' | 'pointer';
     /** Extra class(es) set on the overlay pane, so a consumer can scope global styles to its own dropdown. */
     panelClass?: string | string[];
-    /** Called when the overlay is closed via backdrop click or Escape key. Typically routes to the component's own close() method. */
+    /** Called when the overlay is closed via outside click or Escape key. Typically routes to the component's own close() method. */
     onClose?: () => void;
 }
 /**
- * Creates a composable dropdown overlay helper that manages CDK overlay creation,
- * positioning, and disposal. Must be called within an Angular injection context
- * (e.g., in a component constructor or field initializer).
+ * Thin adapter over `createFloatingOverlay()`. Keeps the dropdown's name, lifecycle and default
+ * backdrop; delegates all positioning to the shared floating primitive. Must be called within an
+ * Angular injection context (e.g., in a component constructor or field initializer).
  */
 declare function createDropdownOverlay(): {
-    readonly overlayRef: OverlayRef | null;
+    readonly overlayRef: _angular_cdk_overlay.OverlayRef | null;
     isOpen: i0.Signal<boolean>;
-    open: (template: TemplateRef<unknown>, triggerElement?: HTMLElement, config?: DropdownOverlayConfig) => void;
     close: () => void;
+    open(template: TemplateRef<unknown>, triggerElement?: HTMLElement, config?: DropdownOverlayConfig, event?: MouseEvent): void;
 };
 type DropdownOverlayInstance = ReturnType<typeof createDropdownOverlay>;
 

package/types/agorapulse-ui-components-filter-dropdown.d.ts

@@ -4,6 +4,7 @@ import { InfoboxType } from '@agorapulse/ui-components/infobox';
 import dayjs from 'dayjs';
 import { SelectLabelSingleDisplayType } from '@agorapulse/ui-components/select';
 import { TagColor } from '@agorapulse/ui-components/tag';
+import * as _floating_ui_utils from '@floating-ui/utils';
 import * as _angular_core from '@angular/core';
 import { TemplateRef } from '@angular/core';
 import { ActionDropdownItem } from '@agorapulse/ui-components/action-dropdown';
@@ -312,7 +313,8 @@ declare class FilterDropdownComponent implements DropdownOverlay {
     /** Whether to show a backdrop that closes the dropdown when clicked */
     showBackdrop: _angular_core.InputSignal<boolean>;
     /** Default position for the dropdown relative to the trigger element */
-    defaultPosition: _angular_core.InputSignal<"left" | "right">;
+    /** Panel placement. Unset means derived from the anchor mode, i.e. `bottom-start`. */
+    readonly placement: _angular_core.InputSignal<_floating_ui_utils.Placement | undefined>;
     /** Extra class(es) set on the body-appended overlay pane, so a consumer can scope global styles to this dropdown. */
     panelClass: _angular_core.InputSignal<string | string[]>;
     saveNewPresetsText: _angular_core.InputSignal<string>;
@@ -376,7 +378,7 @@ declare class FilterDropdownComponent implements DropdownOverlay {
     onUpdatePresets(): void;
     protected onActionDropdownItemClick(item: ActionDropdownItem): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterDropdownComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterDropdownComponent, "ap-filter-dropdown", never, { "infobox": { "alias": "infobox"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "savedValue": { "alias": "savedValue"; "required": false; "isSignal": true; }; "needApplyButton": { "alias": "needApplyButton"; "required": false; "isSignal": true; }; "needClearButton": { "alias": "needClearButton"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "expandOnOpen": { "alias": "expandOnOpen"; "required": false; "isSignal": true; }; "presetsFeatureLocked": { "alias": "presetsFeatureLocked"; "required": false; "isSignal": true; }; "savePresetsMode": { "alias": "savePresetsMode"; "required": false; "isSignal": true; }; "editingPresetsMode": { "alias": "editingPresetsMode"; "required": false; "isSignal": true; }; "showBackdrop": { "alias": "showBackdrop"; "required": false; "isSignal": true; }; "defaultPosition": { "alias": "defaultPosition"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "saveNewPresetsText": { "alias": "saveNewPresetsText"; "required": false; "isSignal": true; }; "saveAsNewPresetText": { "alias": "saveAsNewPresetText"; "required": false; "isSignal": true; }; "savePresetText": { "alias": "savePresetText"; "required": false; "isSignal": true; }; "updateExistingPresetText": { "alias": "updateExistingPresetText"; "required": false; "isSignal": true; }; "resetFilterText": { "alias": "resetFilterText"; "required": false; "isSignal": true; }; "applyFiltersText": { "alias": "applyFiltersText"; "required": false; "isSignal": true; }; "clearFilterText": { "alias": "clearFilterText"; "required": false; "isSignal": true; }; }, { "infoboxLinkClick": "infoboxLinkClick"; "opened": "opened"; "closed": "closed"; "presetsLockedClicked": "presetsLockedClicked"; "saveNewPresets": "saveNewPresets"; "updatePresets": "updatePresets"; "applyFilters": "applyFilters"; "clearFilters": "clearFilters"; "resetFilters": "resetFilters"; "lockedFeatureClicked": "lockedFeatureClicked"; "filterDropdownGroupLockedClicked": "filterDropdownGroupLockedClicked"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterDropdownComponent, "ap-filter-dropdown", never, { "infobox": { "alias": "infobox"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "savedValue": { "alias": "savedValue"; "required": false; "isSignal": true; }; "needApplyButton": { "alias": "needApplyButton"; "required": false; "isSignal": true; }; "needClearButton": { "alias": "needClearButton"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "expandOnOpen": { "alias": "expandOnOpen"; "required": false; "isSignal": true; }; "presetsFeatureLocked": { "alias": "presetsFeatureLocked"; "required": false; "isSignal": true; }; "savePresetsMode": { "alias": "savePresetsMode"; "required": false; "isSignal": true; }; "editingPresetsMode": { "alias": "editingPresetsMode"; "required": false; "isSignal": true; }; "showBackdrop": { "alias": "showBackdrop"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "saveNewPresetsText": { "alias": "saveNewPresetsText"; "required": false; "isSignal": true; }; "saveAsNewPresetText": { "alias": "saveAsNewPresetText"; "required": false; "isSignal": true; }; "savePresetText": { "alias": "savePresetText"; "required": false; "isSignal": true; }; "updateExistingPresetText": { "alias": "updateExistingPresetText"; "required": false; "isSignal": true; }; "resetFilterText": { "alias": "resetFilterText"; "required": false; "isSignal": true; }; "applyFiltersText": { "alias": "applyFiltersText"; "required": false; "isSignal": true; }; "clearFilterText": { "alias": "clearFilterText"; "required": false; "isSignal": true; }; }, { "infoboxLinkClick": "infoboxLinkClick"; "opened": "opened"; "closed": "closed"; "presetsLockedClicked": "presetsLockedClicked"; "saveNewPresets": "saveNewPresets"; "updatePresets": "updatePresets"; "applyFilters": "applyFilters"; "clearFilters": "clearFilters"; "resetFilters": "resetFilters"; "lockedFeatureClicked": "lockedFeatureClicked"; "filterDropdownGroupLockedClicked": "filterDropdownGroupLockedClicked"; }, never, never, true, never>;
 }
 
 declare class FilterDropdownButtonComponent {
@@ -385,6 +387,11 @@ declare class FilterDropdownButtonComponent {
     activeFilterCount: _angular_core.Signal<number>;
     /** text of the button, input specific to the button */
     buttonFilterText: _angular_core.InputSignal<string>;
+    /**
+     * Set in tight containers such as a side nav header: the trigger becomes a square `ap-icon-button`.
+     * `buttonFilterText` is then its accessible name, and the active-filter count is dropped — no counter slot.
+     */
+    iconOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** An optional infobox shown at the bottom of the popup content, above the footer (e.g. a link). */
     infobox: _angular_core.InputSignal<FilterDropdownInfobox | null>;
     /** input specific to the filter-dropdown */
@@ -413,7 +420,8 @@ declare class FilterDropdownButtonComponent {
     /** Whether the dropdown is disabled and cannot be opened */
     disabled: _angular_core.InputSignal<boolean>;
     /** Default position for the dropdown relative to the trigger element */
-    defaultPosition: _angular_core.InputSignal<"left" | "right">;
+    /** Panel placement. Unset means derived from the anchor mode, i.e. `bottom-start`. */
+    readonly placement: _angular_core.InputSignal<_floating_ui_utils.Placement | undefined>;
     /** Extra class(es) set on the body-appended overlay pane, so a consumer can scope global styles to this dropdown. */
     panelClass: _angular_core.InputSignal<string | string[]>;
     saveNewPresetsText: _angular_core.InputSignal<string>;
@@ -446,7 +454,7 @@ declare class FilterDropdownButtonComponent {
     /** Event emitted when a group with locked feature is clicked */
     filterDropdownGroupLockedClicked: _angular_core.OutputEmitterRef<FilterDropdownGroup>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterDropdownButtonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterDropdownButtonComponent, "ap-filter-dropdown-button", never, { "buttonFilterText": { "alias": "buttonFilterText"; "required": false; "isSignal": true; }; "infobox": { "alias": "infobox"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "savedValue": { "alias": "savedValue"; "required": false; "isSignal": true; }; "needApplyButton": { "alias": "needApplyButton"; "required": false; "isSignal": true; }; "needClearButton": { "alias": "needClearButton"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "expandOnOpen": { "alias": "expandOnOpen"; "required": false; "isSignal": true; }; "presetsFeatureLocked": { "alias": "presetsFeatureLocked"; "required": false; "isSignal": true; }; "savePresetsMode": { "alias": "savePresetsMode"; "required": false; "isSignal": true; }; "editingPresetsMode": { "alias": "editingPresetsMode"; "required": false; "isSignal": true; }; "showBackdrop": { "alias": "showBackdrop"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "defaultPosition": { "alias": "defaultPosition"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "saveNewPresetsText": { "alias": "saveNewPresetsText"; "required": false; "isSignal": true; }; "saveAsNewPresetText": { "alias": "saveAsNewPresetText"; "required": false; "isSignal": true; }; "savePresetText": { "alias": "savePresetText"; "required": false; "isSignal": true; }; "updateExistingPresetText": { "alias": "updateExistingPresetText"; "required": false; "isSignal": true; }; "resetFilterText": { "alias": "resetFilterText"; "required": false; "isSignal": true; }; "applyFiltersText": { "alias": "applyFiltersText"; "required": false; "isSignal": true; }; "clearFilterText": { "alias": "clearFilterText"; "required": false; "isSignal": true; }; }, { "infoboxLinkClick": "infoboxLinkClick"; "opened": "opened"; "closed": "closed"; "presetsLockedClicked": "presetsLockedClicked"; "saveNewPresets": "saveNewPresets"; "updatePresets": "updatePresets"; "applyFilters": "applyFilters"; "clearFilters": "clearFilters"; "resetFilters": "resetFilters"; "lockedFeatureClicked": "lockedFeatureClicked"; "filterDropdownGroupLockedClicked": "filterDropdownGroupLockedClicked"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterDropdownButtonComponent, "ap-filter-dropdown-button", never, { "buttonFilterText": { "alias": "buttonFilterText"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "infobox": { "alias": "infobox"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "savedValue": { "alias": "savedValue"; "required": false; "isSignal": true; }; "needApplyButton": { "alias": "needApplyButton"; "required": false; "isSignal": true; }; "needClearButton": { "alias": "needClearButton"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "expandOnOpen": { "alias": "expandOnOpen"; "required": false; "isSignal": true; }; "presetsFeatureLocked": { "alias": "presetsFeatureLocked"; "required": false; "isSignal": true; }; "savePresetsMode": { "alias": "savePresetsMode"; "required": false; "isSignal": true; }; "editingPresetsMode": { "alias": "editingPresetsMode"; "required": false; "isSignal": true; }; "showBackdrop": { "alias": "showBackdrop"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "saveNewPresetsText": { "alias": "saveNewPresetsText"; "required": false; "isSignal": true; }; "saveAsNewPresetText": { "alias": "saveAsNewPresetText"; "required": false; "isSignal": true; }; "savePresetText": { "alias": "savePresetText"; "required": false; "isSignal": true; }; "updateExistingPresetText": { "alias": "updateExistingPresetText"; "required": false; "isSignal": true; }; "resetFilterText": { "alias": "resetFilterText"; "required": false; "isSignal": true; }; "applyFiltersText": { "alias": "applyFiltersText"; "required": false; "isSignal": true; }; "clearFilterText": { "alias": "clearFilterText"; "required": false; "isSignal": true; }; }, { "infoboxLinkClick": "infoboxLinkClick"; "opened": "opened"; "closed": "closed"; "presetsLockedClicked": "presetsLockedClicked"; "saveNewPresets": "saveNewPresets"; "updatePresets": "updatePresets"; "applyFilters": "applyFilters"; "clearFilters": "clearFilters"; "resetFilters": "resetFilters"; "lockedFeatureClicked": "lockedFeatureClicked"; "filterDropdownGroupLockedClicked": "filterDropdownGroupLockedClicked"; }, never, never, true, never>;
 }
 
 export { FilterDropdownButtonComponent, FilterDropdownComponent };

package/types/agorapulse-ui-components-nav-selector.d.ts

@@ -42,7 +42,10 @@ interface NavSelectorTranslatedTexts {
     viewMore: string;
     /** Text of the button to show less details, it’s used when we limit the number of details displayed  */
     viewLess: string;
-    /** Text of the button opening the filter dropdown */
+    /**
+     * Accessible name of the button opening the filter dropdown. The button is icon-only, so this never appears on
+     * screen — screen readers still announce it, so keep it translated.
+     */
     filter: string;
     /** Text of the button clearing the filters inside the filter dropdown */
     clearFilters: string;

package/types/agorapulse-ui-components-selection-dropdown.d.ts

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { OnDestroy, TemplateRef } from '@angular/core';
+import * as _floating_ui_utils from '@floating-ui/utils';
 import { DropdownOverlay } from '@agorapulse/ui-components/dropdown-base';
 import { InputSearchComponent } from '@agorapulse/ui-components/input-search';
 
@@ -84,7 +85,8 @@ declare class SelectionDropdownComponent implements DropdownOverlay, OnDestroy {
     /** Whether the dropdown is disabled and cannot be opened */
     disabled: _angular_core.InputSignal<boolean>;
     /** Default position for the dropdown relative to the trigger element */
-    defaultPosition: _angular_core.InputSignal<"left" | "right">;
+    /** Panel placement. Unset means derived from the anchor mode, i.e. `bottom-start`. */
+    readonly placement: _angular_core.InputSignal<_floating_ui_utils.Placement | undefined>;
     /** Emits when the dropdown menu is opened */
     opened: _angular_core.OutputEmitterRef<void>;
     /** Emits when the dropdown menu is closed */
@@ -157,7 +159,7 @@ declare class SelectionDropdownComponent implements DropdownOverlay, OnDestroy {
     /** Updates the filtered items based on search term */
     private updateFilteredItems;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectionDropdownComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectionDropdownComponent, "ap-selection-dropdown", never, { "headerButtonId": { "alias": "headerButtonId"; "required": false; "isSignal": true; }; "footerButtonId": { "alias": "footerButtonId"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "searchEnabled": { "alias": "searchEnabled"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "footerButtonText": { "alias": "footerButtonText"; "required": false; "isSignal": true; }; "footerButtonSymbolId": { "alias": "footerButtonSymbolId"; "required": false; "isSignal": true; }; "headerButtonText": { "alias": "headerButtonText"; "required": false; "isSignal": true; }; "headerButtonSymbolId": { "alias": "headerButtonSymbolId"; "required": false; "isSignal": true; }; "searchPlaceholderText": { "alias": "searchPlaceholderText"; "required": false; "isSignal": true; }; "noSearchResultsText": { "alias": "noSearchResultsText"; "required": false; "isSignal": true; }; "showBackdrop": { "alias": "showBackdrop"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "defaultPosition": { "alias": "defaultPosition"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "opened": "opened"; "closed": "closed"; "selectionChange": "selectionChange"; "footerButtonClick": "footerButtonClick"; "headerButtonClick": "headerButtonClick"; "searchInputChange": "searchInputChange"; "searchTerm": "searchTermChange"; }, ["trigger"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectionDropdownComponent, "ap-selection-dropdown", never, { "headerButtonId": { "alias": "headerButtonId"; "required": false; "isSignal": true; }; "footerButtonId": { "alias": "footerButtonId"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "searchEnabled": { "alias": "searchEnabled"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "footerButtonText": { "alias": "footerButtonText"; "required": false; "isSignal": true; }; "footerButtonSymbolId": { "alias": "footerButtonSymbolId"; "required": false; "isSignal": true; }; "headerButtonText": { "alias": "headerButtonText"; "required": false; "isSignal": true; }; "headerButtonSymbolId": { "alias": "headerButtonSymbolId"; "required": false; "isSignal": true; }; "searchPlaceholderText": { "alias": "searchPlaceholderText"; "required": false; "isSignal": true; }; "noSearchResultsText": { "alias": "noSearchResultsText"; "required": false; "isSignal": true; }; "showBackdrop": { "alias": "showBackdrop"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "opened": "opened"; "closed": "closed"; "selectionChange": "selectionChange"; "footerButtonClick": "footerButtonClick"; "headerButtonClick": "headerButtonClick"; "searchInputChange": "searchInputChange"; "searchTerm": "searchTermChange"; }, ["trigger"], never, true, never>;
 }
 
 /**