yukit-web 0.1.5 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yukit-web",
   "description": "Angular UI component library for Yurest web applications.",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "author": {
     "name": "Yurest Solutions",
     "email": "develop@yurest.com"

package/types/yukit-web.d.ts

@@ -1,6 +1,6 @@
 import { ClassValue } from 'clsx';
 import * as _angular_core from '@angular/core';
-import { ModelSignal, Type, Provider, InputSignal, InputSignalWithTransform, TemplateRef, WritableSignal, Signal, OnInit } from '@angular/core';
+import { ModelSignal, Type, Provider, InputSignal, InputSignalWithTransform, TemplateRef, WritableSignal, Signal, OnInit, ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { SortingState, PaginationState, columnFilteringFeature, columnVisibilityFeature, rowPaginationFeature, rowSelectionFeature, rowSortingFeature, RowData, ColumnDef, ColumnFiltersState, ColumnVisibilityState, RowSelectionState } from '@tanstack/table-core';
 import { ButtonVariants } from 'yukit-web/helm/button';
@@ -316,6 +316,7 @@ declare class YuwComboboxComponent<TData = unknown> extends YuwValueAccessorBase
     protected readonly _selectedValues: _angular_core.Signal<Set<string>>;
     protected readonly _singleValue: _angular_core.Signal<string | undefined>;
     protected readonly _triggerClass: _angular_core.Signal<string>;
+    close(): void;
     constructor();
     /**
      * Focuses the field and opens its option list. For a combobox living inside a popover or sheet:
@@ -483,6 +484,7 @@ interface YuwButtonGroupItemDto {
     target?: string;
     type?: 'button' | 'submit' | 'reset';
     ariaLabel?: string;
+    tooltip?: string;
     yuwDropdownMenuTrigger?: TemplateRef<unknown>;
 }
 /** What `<yuw-button-group>` emits from `buttonClicked`. */
@@ -574,6 +576,7 @@ declare class YuwButtonGroupComponent {
         href?: string;
         target?: string;
         ariaLabel?: string;
+        tooltip?: string;
         yuwDropdownMenuTrigger?: _angular_core.TemplateRef<unknown>;
     }[]>;
     protected onClick(entry: YuwButtonGroupItemDto, event: MouseEvent): void;
@@ -1912,6 +1915,38 @@ interface YuwFilterGroupDto {
 }
 /** Selection keyed by `YuwFilterGroupDto.id`: a string for `single` groups, an array for `multiple`. */
 type YuwFilterSelection = Readonly<Record<string, string | readonly string[]>>;
+/** A named selection the user saved; `id` is assigned by the consumer that persists it. */
+interface YuwFilterSetDto {
+    readonly id: string;
+    readonly name: string;
+    readonly selection: YuwFilterSelection;
+}
+/** Payload of `setSaved`: the name the user typed and the selection applied at that moment. */
+interface YuwFilterSetSaveDto {
+    readonly name: string;
+    readonly selection: YuwFilterSelection;
+}
+/** Payload of `setRenamed`. */
+interface YuwFilterSetRenameDto {
+    readonly id: string;
+    readonly name: string;
+}
+/** Texts of the saved-sets control and its dialog; the consumer translates them. */
+interface YuwFilterSetLabels {
+    readonly save: string;
+    readonly select: string;
+    readonly none: string;
+    readonly edit: string;
+    readonly delete: string;
+    readonly saveTitle: string;
+    readonly renameTitle: string;
+    readonly deleteTitle: string;
+    readonly deleteMessage: (name: string) => string;
+    readonly nameLabel: string;
+    readonly confirm: string;
+    readonly cancel: string;
+    readonly close: string;
+}
 interface YuwListToolbarFilterLabels {
     readonly title: string;
     readonly clearAll: string;
@@ -1920,6 +1955,7 @@ interface YuwListToolbarFilterLabels {
     readonly clear: string;
     readonly pending: string;
     readonly selected: (count: number) => string;
+    readonly sets?: YuwFilterSetLabels;
 }
 interface YuwListToolbarSearchLabels {
     readonly expand: string;
@@ -1944,12 +1980,14 @@ interface YuwListToolbarLabels {
  * trailing one, and projected content after them.
  *
  * Each control renders only when its input is set: `filterGroups`, `searchPlaceholder`,
- * `showExport`, `hideableColumns`. `labels` holds every text and the consumer translates it;
+ * `showExport`, `hideableColumns`. Saved filter sets need `filterSets` and `labels.filters.sets`;
+ * the toolbar emits `setSaved`, `setRenamed` and `setDeleted` and the consumer persists them. `labels` holds every text and the consumer translates it;
  * `idleColor` is the filter trigger tone while nothing is applied.
  */
 declare class YuwListToolbarComponent {
     readonly filterGroups: _angular_core.InputSignal<readonly YuwFilterGroupDto[] | undefined>;
     readonly filtersDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly filterSets: _angular_core.InputSignal<readonly YuwFilterSetDto[] | undefined>;
     readonly hiddenColumns: _angular_core.ModelSignal<string[]>;
     readonly hideableColumns: _angular_core.InputSignal<YuwComboboxOptionDto<unknown>[] | undefined>;
     readonly idleColor: _angular_core.InputSignal<YuwColorDto>;
@@ -1960,9 +1998,12 @@ declare class YuwListToolbarComponent {
     readonly showExport: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly exported: _angular_core.OutputEmitterRef<MouseEvent>;
     readonly searched: _angular_core.OutputEmitterRef<string>;
+    readonly setDeleted: _angular_core.OutputEmitterRef<string>;
+    readonly setRenamed: _angular_core.OutputEmitterRef<YuwFilterSetRenameDto>;
+    readonly setSaved: _angular_core.OutputEmitterRef<YuwFilterSetSaveDto>;
     protected readonly isMobile: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwListToolbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwListToolbarComponent, "yuw-list-toolbar", never, { "filterGroups": { "alias": "filterGroups"; "required": false; "isSignal": true; }; "filtersDisabled": { "alias": "filtersDisabled"; "required": false; "isSignal": true; }; "hiddenColumns": { "alias": "hiddenColumns"; "required": false; "isSignal": true; }; "hideableColumns": { "alias": "hideableColumns"; "required": false; "isSignal": true; }; "idleColor": { "alias": "idleColor"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": true; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "showExport": { "alias": "showExport"; "required": false; "isSignal": true; }; }, { "hiddenColumns": "hiddenColumnsChange"; "search": "searchChange"; "selection": "selectionChange"; "exported": "exported"; "searched": "searched"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwListToolbarComponent, "yuw-list-toolbar", never, { "filterGroups": { "alias": "filterGroups"; "required": false; "isSignal": true; }; "filtersDisabled": { "alias": "filtersDisabled"; "required": false; "isSignal": true; }; "filterSets": { "alias": "filterSets"; "required": false; "isSignal": true; }; "hiddenColumns": { "alias": "hiddenColumns"; "required": false; "isSignal": true; }; "hideableColumns": { "alias": "hideableColumns"; "required": false; "isSignal": true; }; "idleColor": { "alias": "idleColor"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": true; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "showExport": { "alias": "showExport"; "required": false; "isSignal": true; }; }, { "hiddenColumns": "hiddenColumnsChange"; "search": "searchChange"; "selection": "selectionChange"; "exported": "exported"; "searched": "searched"; "setDeleted": "setDeleted"; "setRenamed": "setRenamed"; "setSaved": "setSaved"; }, never, ["*"], true, never>;
 }
 
 type YuwDatatableAlign = 'start' | 'center' | 'end';
@@ -2525,6 +2566,9 @@ type YuwPopoverAlignDto = 'start' | 'center' | 'end';
  * - `triggerClass`: Extra classes merged onto the trigger button, last, so they beat both the
  *   variant classes and `triggerTransparent` (e.g. `h-auto p-0` to drop the button's own box).
  *
+ * The panel is always anchored to the trigger, including when `open` is set from code without a
+ * click on it; the brain trigger only records its element on click.
+ *
  * The trigger is a `<yuw-button>`; `YuwPopoverTriggerDirective` composes the brain trigger onto it,
  * so the popover reuses our button component instead of applying `[hlmBtn]` directly.
  *
@@ -2538,6 +2582,7 @@ type YuwPopoverAlignDto = 'start' | 'center' | 'end';
  * ```
  */
 declare class YuwPopoverComponent {
+    protected readonly _trigger: _angular_core.Signal<ElementRef<any> | undefined>;
     readonly align: _angular_core.InputSignal<YuwPopoverAlignDto>;
     readonly description: _angular_core.InputSignal<string | undefined>;
     readonly offsetX: _angular_core.InputSignal<number>;
@@ -3889,4 +3934,4 @@ declare class YuwCommandDialogComponent {
 }
 
 export { DATATABLE_ALIGN_CLASS, DATATABLE_LAYOUT_CLASS, DATATABLE_WRAP_CONTENT_CLASS, YUW_DATATABLE_FEATURES, YUW_DATATABLE_WRAP_MIN_WIDTH, YUW_PASSWORD_REVEAL_STATES, YUW_SIDEBAR_RAIL_ICON_SIZE, YUW_SIDEBAR_RAIL_PADDING, YUW_SIDEBAR_RAIL_WIDTH, YuwAccordion, YuwAccordionContentComponent, YuwAccordionImports, YuwAccordionItem, YuwAccordionTriggerComponent, YuwActionsCellComponent, YuwAlertActionDirective, YuwAlertComponent, YuwAlertDescriptionDirective, YuwAlertDialogComponent, YuwAlertDialogMediaDirective, YuwAlertDialogTriggerDirective, YuwAlertImports, YuwAlertTitleDirective, YuwAttachmentActionDirective, YuwAttachmentActionsDirective, YuwAttachmentContentDirective, YuwAttachmentDescriptionDirective, YuwAttachmentDirective, YuwAttachmentGroupDirective, YuwAttachmentMediaDirective, YuwAttachmentTitleDirective, YuwAttachmentTriggerDirective, YuwAvatarComponent, YuwBadgeComponent, YuwBreadcrumbComponent, YuwBreadcrumbTrailService, YuwButtonComponent, YuwButtonGroupComponent, YuwButtonGroupContentDirective, YuwCaptionDirective, YuwCardActionDirective, YuwCardContentDirective, YuwCardDescriptionDirective, YuwCardDirective, YuwCardFooterDirective, YuwCardGridComponent, YuwCardGridItemComponent, YuwCardHeaderDirective, YuwCardImports, YuwCardTitleDirective, YuwCheckboxComponent, YuwClassDirective, YuwComboboxComponent, YuwComboboxItemDirective, YuwCommandComponent, YuwCommandDialogComponent, YuwContextMenuCheckboxDirective, YuwContextMenuCheckboxIndicatorComponent, YuwContextMenuDirective, YuwContextMenuGroupDirective, YuwContextMenuImports, YuwContextMenuItemDirective, YuwContextMenuLabelDirective, YuwContextMenuRadioDirective, YuwContextMenuRadioIndicatorComponent, YuwContextMenuSeparatorDirective, YuwContextMenuShortcutDirective, YuwContextMenuSubDirective, YuwContextMenuSubIndicatorComponent, YuwContextMenuSubTriggerDirective, YuwContextMenuTriggerDirective, YuwDatatableComponent, YuwDatatablePaginationDirective, YuwDatatableRowSelect, YuwDatepickerComponent, YuwDialogCloseDirective, YuwDialogComponent, YuwDialogFooterDirective, YuwDialogImports, YuwDialogTriggerDirective, YuwEmptyContentDirective, YuwEmptyDescriptionDirective, YuwEmptyDirective, YuwEmptyHeaderDirective, YuwEmptyImports, YuwEmptyMediaDirective, YuwEmptyTitleDirective, YuwFieldBase, YuwInputAddonImports, YuwInputComponent, YuwInputOtpComponent, YuwItemActionsDirective, YuwItemContentDirective, YuwItemDescriptionDirective, YuwItemDirective, YuwItemFooterDirective, YuwItemGroupDirective, YuwItemHeaderDirective, YuwItemImports, YuwItemMediaDirective, YuwItemSeparatorDirective, YuwItemTitleDirective, YuwLabel, YuwLeftAddonDirective, YuwListPaginationComponent, YuwListToolbarComponent, YuwPageHeaderComponent, YuwPageSizeComponent, YuwPaginationComponent, YuwPasswordInputComponent, YuwPopoverComponent, YuwPopoverTriggerDirective, YuwRadioGroupComponent, YuwRightAddonDirective, YuwSearchInputComponent, YuwSheetCloseDirective, YuwSheetComponent, YuwSheetFooterDirective, YuwSheetImports, YuwSheetTriggerDirective, YuwSidebarComponent, YuwSidebarContentDirective, YuwSidebarContentExtraDirective, YuwSidebarFooterDirective, YuwSidebarFooterExtraDirective, YuwSidebarGroupContentDirective, YuwSidebarGroupDirective, YuwSidebarGroupLabelDirective, YuwSidebarHeaderDirective, YuwSidebarInsetDirective, YuwSidebarMenuAvatarButtonDirective, YuwSidebarMenuBadgeDirective, YuwSidebarMenuButtonDirective, YuwSidebarMenuDirective, YuwSidebarMenuItemDirective, YuwSidebarMenuSubButtonDirective, YuwSidebarMenuSubDirective, YuwSidebarMenuSubItemDirective, YuwSidebarRailDirective, YuwSidebarRailService, YuwSidebarSeparatorDirective, YuwSidebarSubmenuService, YuwSidebarTriggerComponent, YuwSidebarWrapperDirective, YuwSkeletonDirective, YuwSpinnerComponent, YuwSwitchComponent, YuwTBodyDirective, YuwTFootDirective, YuwTHeadDirective, YuwTabContentDirective, YuwTabPanelDirective, YuwTableContainerDirective, YuwTableDirective, YuwTableImports, YuwTabsComponent, YuwTdDirective, YuwTextFieldBase, YuwTextareaComponent, YuwThDirective, YuwToasterComponent, YuwTooltipDirective, YuwTrDirective, YuwValueAccessorBase, buildInputOtpGroups, buildYuwActionsColumn, cn, createPagedList, datatableCellVariants, datatableContainerVariants, datatableHeadVariants, datatableHeaderCellVariants, datatableRowVariants, getPaginationRange, provideValueAccessor, totalInputOtpLength, yuwCommandDefaultFilter };
-export type { YuwAlertDialogSizeDto, YuwAlertVariantDto, YuwAvatarGroupItemDto, YuwAvatarSizeDto, YuwBreadcrumbCrumb, YuwBreadcrumbItemDto, YuwBreadcrumbRouteData, YuwButtonGroupClickDto, YuwButtonGroupItemDto, YuwColorDto, YuwComboboxItemContext, YuwComboboxOptionDto, YuwComboboxValue, YuwCommandGroupDto, YuwCommandItemDto, YuwDatatableAlign, YuwDatatableAppearanceDto, YuwDatatableColumnDef, YuwDatatableColumnMeta, YuwDatatableFeatures, YuwDatatableRowClass, YuwDatepickerModeDto, YuwDatepickerValue, YuwFieldSizeDto, YuwFilterGroupDto, YuwFilterGroupMode, YuwFilterOptionDto, YuwFilterSelection, YuwInputModeDto, YuwInputOtpGroupDto, YuwInputOtpModeDto, YuwInputTypeDto, YuwListPaginationLabels, YuwListToolbarColumnsLabels, YuwListToolbarFilterLabels, YuwListToolbarLabels, YuwListToolbarSearchLabels, YuwPageQuery, YuwPageRange, YuwPageSizeLabels, YuwPageSort, YuwPagedList, YuwPagedListOptions, YuwPaginationRangeItem, YuwPaginationSizeDto, YuwPasswordRevealStateDto, YuwPopoverAlignDto, YuwRadioOptionDto, YuwSearchInputCollapseFromDto, YuwSheetScrollStrategyDto, YuwSheetSideDto, YuwSidebarAvatarDto, YuwSidebarCollapsibleDto, YuwSidebarContentDto, YuwSidebarGroupDto, YuwSidebarItemClickDto, YuwSidebarItemDto, YuwSidebarSideDto, YuwSidebarSubItemDto, YuwSidebarVariantDto, YuwSwitchSizeDto, YuwTabItemDto, YuwTabsActivationModeDto, YuwTabsOrientationDto, YuwTabsVariantDto, YuwTextFieldContract, YuwToasterPositionDto, YuwToasterThemeDto, YuwTooltipPositionDto };
+export type { YuwAlertDialogSizeDto, YuwAlertVariantDto, YuwAvatarGroupItemDto, YuwAvatarSizeDto, YuwBreadcrumbCrumb, YuwBreadcrumbItemDto, YuwBreadcrumbRouteData, YuwButtonGroupClickDto, YuwButtonGroupItemDto, YuwColorDto, YuwComboboxItemContext, YuwComboboxOptionDto, YuwComboboxValue, YuwCommandGroupDto, YuwCommandItemDto, YuwDatatableAlign, YuwDatatableAppearanceDto, YuwDatatableColumnDef, YuwDatatableColumnMeta, YuwDatatableFeatures, YuwDatatableRowClass, YuwDatepickerModeDto, YuwDatepickerValue, YuwFieldSizeDto, YuwFilterGroupDto, YuwFilterGroupMode, YuwFilterOptionDto, YuwFilterSelection, YuwFilterSetDto, YuwFilterSetLabels, YuwFilterSetRenameDto, YuwFilterSetSaveDto, YuwInputModeDto, YuwInputOtpGroupDto, YuwInputOtpModeDto, YuwInputTypeDto, YuwListPaginationLabels, YuwListToolbarColumnsLabels, YuwListToolbarFilterLabels, YuwListToolbarLabels, YuwListToolbarSearchLabels, YuwPageQuery, YuwPageRange, YuwPageSizeLabels, YuwPageSort, YuwPagedList, YuwPagedListOptions, YuwPaginationRangeItem, YuwPaginationSizeDto, YuwPasswordRevealStateDto, YuwPopoverAlignDto, YuwRadioOptionDto, YuwSearchInputCollapseFromDto, YuwSheetScrollStrategyDto, YuwSheetSideDto, YuwSidebarAvatarDto, YuwSidebarCollapsibleDto, YuwSidebarContentDto, YuwSidebarGroupDto, YuwSidebarItemClickDto, YuwSidebarItemDto, YuwSidebarSideDto, YuwSidebarSubItemDto, YuwSidebarVariantDto, YuwSwitchSizeDto, YuwTabItemDto, YuwTabsActivationModeDto, YuwTabsOrientationDto, YuwTabsVariantDto, YuwTextFieldContract, YuwToasterPositionDto, YuwToasterThemeDto, YuwTooltipPositionDto };