@gipisistemas/ngx-core 1.0.20 → 1.0.21

package/index.d.ts

@@ -7,7 +7,7 @@ import { OnDestroy, OnInit, AfterViewInit, DestroyRef, TemplateRef, ElementRef,
 import { Observable, Subject, BehaviorSubject } from 'rxjs';
 import { HttpClient, HttpParams, HttpHeaders, HttpInterceptorFn } from '@angular/common/http';
 import * as _gipisistemas_ngx_core from '@gipisistemas/ngx-core';
-import { ActivatedRoute, Router, Params, QueryParamsHandling, OnSameUrlNavigation, CanActivateFn, CanActivateChildFn } from '@angular/router';
+import { ActivatedRoute, Router, Params, QueryParamsHandling, OnSameUrlNavigation, CanActivateFn, CanActivateChildFn, ParamMap } from '@angular/router';
 import { SelectionModel } from '@angular/cdk/collections';
 import { PageEvent, MatPaginator, MatPaginatorIntl } from '@angular/material/paginator';
 import { ControlValueAccessor, AbstractControl, ValidationErrors, NgControl } from '@angular/forms';
@@ -3352,14 +3352,9 @@ declare class ScrollFadeModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<ScrollFadeModule>;
 }
 
-type tSearchOptions<TValue> = WritableSignal<TValue> & {
-    /** O valor com debounce aplicado */
-    term: Signal<TValue>;
-};
-
 declare class SelectClientSide<TOption = any, TValue = any> extends BaseControlValueAccessor {
     protected _uniqueId: string;
-    protected search: tSearchOptions<string | null>;
+    protected search: _gipisistemas_ngx_core.tSearchOptions<string | null>;
     protected filteredOptions: _angular_core.Signal<TOption[]>;
     readonly label: _angular_core.InputSignal<string>;
     readonly placeholder: _angular_core.InputSignal<string>;
@@ -3395,7 +3390,7 @@ interface iInternalOptions {
 }
 declare class SelectEnum<TValue = string | number> extends BaseControlValueAccessor {
     protected _uniqueId: string;
-    protected search: tSearchOptions<string | null>;
+    protected search: _gipisistemas_ngx_core.tSearchOptions<string | null>;
     protected propertyLabel: () => string;
     protected propertyValue: () => string;
     protected filteredOptions: _angular_core.Signal<iInternalOptions[]>;
@@ -3433,7 +3428,7 @@ declare class SelectServerSide<TOption = any, TValue = any> extends BaseControlV
     private _hasLoadedOnce;
     private _isLoadingRequest;
     private _lastScrollLoadTime;
-    protected search: tSearchOptions<string | null>;
+    protected search: _gipisistemas_ngx_core.tSearchOptions<string | null>;
     protected options: _angular_core.WritableSignal<TOption[]>;
     protected loading: _angular_core.WritableSignal<boolean>;
     protected currentPage: _angular_core.WritableSignal<number>;
@@ -5159,6 +5154,68 @@ interface iLinkedFilterOptions<T, F> {
  */
 declare function useLinkedFilter<T = any, F = any>(initialValue: T, options: iLinkedFilterOptions<T, F>): WritableSignal<T>;
 
+/**
+ * Cria um signal que rastreia um parâmetro de rota específico.
+ * Atualiza de forma reativa quando o parâmetro muda.
+ *
+ * @param paramName Nome do parâmetro de rota a ser rastreado
+ * @returns Um signal contendo o valor do parâmetro ou null.
+ *
+ * @example
+ * ```typescript
+ * // Para a rota /users/:id
+ * const userId = useRouteParam('id');
+ * ```
+ */
+declare function useRouteParams<T = string | null>(paramName: string): Signal<T>;
+/**
+ * Cria um signal que rastreia todo o mapa de parâmetros da rota.
+ * Útil quando você precisa acessar vários parâmetros.
+ *
+ * @returns Um signal contendo o ParamMap completo
+ *
+ * @example
+ * ```typescript
+ * const params = useRouteParamsMap();
+ * const id = params().get('id');
+ * ```
+ */
+declare function useRouteParamsMap(): Signal<ParamMap>;
+
+/**
+ * Cria um signal que rastreia um parâmetro de consulta específico.
+ * Atualiza reativamente quando o parâmetro de consulta muda.
+ *
+ * @param paramName - Nome do parâmetro de consulta a ser rastreado
+ * @returns Um signal contendo o valor do parâmetro ou null
+ *
+ * @example
+ * ```typescript
+ * // Para URL: /search?q=angular
+ * const query = useRouteQueryParams('q');
+ * ```
+ */
+declare function useRouteQueryParams<T = string | null>(paramName: string): Signal<T>;
+/**
+ * Cria um signal que rastreia todo o mapa de parâmetros de consulta.
+ * Útil quando você precisa acessar vários parâmetros de consulta.
+ *
+ * @returns Um signal contendo o mapa completo de parâmetros de consulta (ParamMap)
+ *
+ * @example
+ * ```typescript
+ * const params = useRouteQueryParamsMap();
+ * const sort = params().get('sort');
+ * ```
+ */
+declare function useRouteQueryParamsMap(): Signal<ParamMap>;
+
+type tSearchOptions<TValue> = WritableSignal<TValue> & {
+    /** O valor com debounce aplicado */
+    term: Signal<TValue>;
+};
+declare function useSearch<TValue>(initialValue: TValue, delayMs?: number): tSearchOptions<TValue>;
+
 /**
  * Token de injeção para definir rotas públicas permitidas mesmo quando o usuário está autenticado.
  *
@@ -6093,5 +6150,5 @@ declare class UUIDUtil {
     static isEmpty(inp: unknown): inp is null | undefined;
 }
 
-export { ActionRow, ActionRowModule, AllowedPublicRoutesToken, AppMessagesToken, ArrayUtil, AutoFocusDirective, AutoFocusModule, Avatar, AvatarModule, BaseAppliedFilter, BaseAuthService, BaseAuthServiceToken, BaseAuthorityModel, BaseComponent, BaseControlValueAccessor, BaseCrudService, BaseFilterModel, BaseFormComponent, BaseFormDialogComponent, BaseFormDialogDataModel, BaseInput, BaseListComponent, BaseListDialogComponent, BaseListDialogDataModel, BaseMenuModel, BaseModel, BasePageModel, BaseQueryParams, BaseReportComponent, BaseService, BaseSortModel, BaseTokenModel, BaseUserModel, Button, ButtonGroup, ButtonGroupModule, ButtonModule, CAPITALIZE_ACRONYMS, CAPITALIZE_PREPOSITIONS, CURRENCY_OPTIONS_DEFAULT, CacheableService, Checkbox, CheckboxGroup, CheckboxModule, Chips, ChipsModule, ConfirmDialog, ConfirmDialogIcon, ConfirmDialogModel, ConfirmDialogModule, ConfirmDialogService, CssUtil, CurrencyDirective, CurrencyModule, CurrencyUtil, DEFAULT_MESSAGES, DatePicker, DatePickerModule, DateUtil, Debounce, DialogConfig, DialogService, DisableAutoFillDirective, DocumentPipe, DocumentUtil, EchartsConfigToken, EchartsDirective, EchartsModule, EmailUtil, Empty, EmptyModule, ExpansionPanel, ExpansionPanelModule, Fieldset, FieldsetModule, FileDragAndDrop, FileDragAndDropModule, FileSaverService, FilterListbox, FilterListboxModule, FilterPersistenceService, FilterService, FilterURLService, FlexLayoutDirective, FlexLayoutModule, FormField, FormFieldErrors, FormFieldInputDirective, FormFieldModule, FormFieldPrefixDirective, FormFieldSuffixDirective, FormWrapper, FormWrapperDialog, FormWrapperModule, HelpfulTip, HelpfulTipModule, Icon, IconModule, Input, InputCurrency, InputCurrencyModule, InputFile, InputFileModule, InputGroup, InputGroupAddon, InputGroupModule, InputModule, InputPhone, InputPhoneModule, Label, LabelModule, Loading, LoadingModule, LocalStorageToken, Lozenge, LozengeModule, MoneyPipe, NomalizeTextPipe, NumberToWordsUtil, NumberUtil, ObjectUtil, PAGINATOR_INTL_PT_BR, PageAdjustService, Paginator, PaginatorIntlToken, PaginatorModule, PaginatorPipe, PasswordRequirements, PasswordRequirementsModule, PasswordValidationUtil, PdfViewer, PdfViewerDialog, PdfViewerDialogModel, PdfViewerDialogModule, PdfViewerService, PhoneUtil, Popover, PopoverModule, PopoverTargetDirective, PopoverTriggerDirective, RadioGroup, RadioGroupModule, STATES_DATA, ScrollFadeDirective, ScrollFadeModule, SelectClientSide, SelectEnum, SelectModule, SelectServerSide, SessionStorageToken, Sidenav, SidenavContainer, SidenavContent, SidenavMenuItem, SidenavModule, Skeleton, SkeletonModule, SplitButton, SplitButtonModule, StateUtil, Step, Stepper, StepperModule, StringUtil, SvgRegisterService, Tab, TabGroup, Table, TableColumn, TableColumnBuilder, TableMenuItemContext, TableMenuItemContextBuilder, TableModule, TabsModule, Tag, TagModule, TextCapitalizeDirective, TextCapitalizeModule, TextEllipsisDirective, TextEllipsisModule, Textarea, TextareaModule, Toast, ToastIcon, ToastModel, ToastModule, ToastService, ToggleSwitch, ToggleSwitchModule, Toolbar, ToolbarModule, TooltipDirective, TooltipModule, TopNav, TopNavModule, TreeTable, TreeTableColumn, TreeTableColumnBuilder, TreeTableMenuItemContext, TreeTableMenuItemContextBuilder, TreeTableModule, UUIDUtil, UserProfile, UserProfileModule, animationFlyInOut, authChildGuard, authGuard, authInterceptor, eConfirmDialogTypes, eCurrencyInputMode, eMenuType, eSortDirection, eToastTypes, eTypeOperationCloseDialogEnum, eTypeOperationDialog, entityFilterSignal, errorInterceptor, filterSignal, provideAllowedPublicRoutes, provideAppMessages, provideBaseAuthService, provideEchartsCore, providePaginatorIntl, provideValueAccessor, publicChildGuard, publicGuard, rotateAnimation, rotateArrowTreeTableExpand, stateNamesMap, transformFilterSignal, useFilterPersistence, useLinkedFilter };
-export type { Booleanish, GIPIUuid, MixableObject, Nullable, Numberish, VoidListener, iAPIError, iAppMessages, iBaseReportType, iButtonGroup, iCurrencyConfig, iDatePreset, iDateRange, iEchartsConfig, iFileUploadEvent, iFilterListbox, iFilterPersistenceConfig, iFilterSignal, iFilterSignalConfig, iLinkedFilterOptions, iMonthRange, iMonthValue, iPageAdjust, iPaginatorArgs, iPasswordRequirement, iPermission, iSplitButtonMenuItem, iTimeValue, iToggleSwitchChange, iUseFilterPersistence, iYearRange, tCheckboxGroupOption, tCheckboxState, tConfirmDialogTypes, tDateFilterFn, tDatePickerMode, tDatePickerValue, tEchartsThemeOption, tFilterListboxMode, tIconFontSet, tIconGrade, tIconOptical, tIconVariation, tIconWeight, tImplicitTemplateRef, tLozengeFill, tLozengeVariant, tMenuType, tMonthsEnglish, tOptionRadioGroup, tPageEvent, tPermissionKey, tRotateState, tSortDirection, tStateName, tTableColumnActionType, tTableColumnAlignHorizontal, tTableColumnAlignText, tTableColumnAlignVertical, tTableColumnCondition, tTableColumnPartial, tTimeFormat, tToastTypes, tTreeTableColumnCondition, tTreeTableColumnPartial, tTypeOperationCloseDialog, tTypeOperationDialog, tUFState, tVariantType, tWeekdaysEnglish };
+export { ActionRow, ActionRowModule, AllowedPublicRoutesToken, AppMessagesToken, ArrayUtil, AutoFocusDirective, AutoFocusModule, Avatar, AvatarModule, BaseAppliedFilter, BaseAuthService, BaseAuthServiceToken, BaseAuthorityModel, BaseComponent, BaseControlValueAccessor, BaseCrudService, BaseFilterModel, BaseFormComponent, BaseFormDialogComponent, BaseFormDialogDataModel, BaseInput, BaseListComponent, BaseListDialogComponent, BaseListDialogDataModel, BaseMenuModel, BaseModel, BasePageModel, BaseQueryParams, BaseReportComponent, BaseService, BaseSortModel, BaseTokenModel, BaseUserModel, Button, ButtonGroup, ButtonGroupModule, ButtonModule, CAPITALIZE_ACRONYMS, CAPITALIZE_PREPOSITIONS, CURRENCY_OPTIONS_DEFAULT, CacheableService, Checkbox, CheckboxGroup, CheckboxModule, Chips, ChipsModule, ConfirmDialog, ConfirmDialogIcon, ConfirmDialogModel, ConfirmDialogModule, ConfirmDialogService, CssUtil, CurrencyDirective, CurrencyModule, CurrencyUtil, DEFAULT_MESSAGES, DatePicker, DatePickerModule, DateUtil, Debounce, DialogConfig, DialogService, DisableAutoFillDirective, DocumentPipe, DocumentUtil, EchartsConfigToken, EchartsDirective, EchartsModule, EmailUtil, Empty, EmptyModule, ExpansionPanel, ExpansionPanelModule, Fieldset, FieldsetModule, FileDragAndDrop, FileDragAndDropModule, FileSaverService, FilterListbox, FilterListboxModule, FilterPersistenceService, FilterService, FilterURLService, FlexLayoutDirective, FlexLayoutModule, FormField, FormFieldErrors, FormFieldInputDirective, FormFieldModule, FormFieldPrefixDirective, FormFieldSuffixDirective, FormWrapper, FormWrapperDialog, FormWrapperModule, HelpfulTip, HelpfulTipModule, Icon, IconModule, Input, InputCurrency, InputCurrencyModule, InputFile, InputFileModule, InputGroup, InputGroupAddon, InputGroupModule, InputModule, InputPhone, InputPhoneModule, Label, LabelModule, Loading, LoadingModule, LocalStorageToken, Lozenge, LozengeModule, MoneyPipe, NomalizeTextPipe, NumberToWordsUtil, NumberUtil, ObjectUtil, PAGINATOR_INTL_PT_BR, PageAdjustService, Paginator, PaginatorIntlToken, PaginatorModule, PaginatorPipe, PasswordRequirements, PasswordRequirementsModule, PasswordValidationUtil, PdfViewer, PdfViewerDialog, PdfViewerDialogModel, PdfViewerDialogModule, PdfViewerService, PhoneUtil, Popover, PopoverModule, PopoverTargetDirective, PopoverTriggerDirective, RadioGroup, RadioGroupModule, STATES_DATA, ScrollFadeDirective, ScrollFadeModule, SelectClientSide, SelectEnum, SelectModule, SelectServerSide, SessionStorageToken, Sidenav, SidenavContainer, SidenavContent, SidenavMenuItem, SidenavModule, Skeleton, SkeletonModule, SplitButton, SplitButtonModule, StateUtil, Step, Stepper, StepperModule, StringUtil, SvgRegisterService, Tab, TabGroup, Table, TableColumn, TableColumnBuilder, TableMenuItemContext, TableMenuItemContextBuilder, TableModule, TabsModule, Tag, TagModule, TextCapitalizeDirective, TextCapitalizeModule, TextEllipsisDirective, TextEllipsisModule, Textarea, TextareaModule, Toast, ToastIcon, ToastModel, ToastModule, ToastService, ToggleSwitch, ToggleSwitchModule, Toolbar, ToolbarModule, TooltipDirective, TooltipModule, TopNav, TopNavModule, TreeTable, TreeTableColumn, TreeTableColumnBuilder, TreeTableMenuItemContext, TreeTableMenuItemContextBuilder, TreeTableModule, UUIDUtil, UserProfile, UserProfileModule, animationFlyInOut, authChildGuard, authGuard, authInterceptor, eConfirmDialogTypes, eCurrencyInputMode, eMenuType, eSortDirection, eToastTypes, eTypeOperationCloseDialogEnum, eTypeOperationDialog, entityFilterSignal, errorInterceptor, filterSignal, provideAllowedPublicRoutes, provideAppMessages, provideBaseAuthService, provideEchartsCore, providePaginatorIntl, provideValueAccessor, publicChildGuard, publicGuard, rotateAnimation, rotateArrowTreeTableExpand, stateNamesMap, transformFilterSignal, useFilterPersistence, useLinkedFilter, useRouteParams, useRouteParamsMap, useRouteQueryParams, useRouteQueryParamsMap, useSearch };
+export type { Booleanish, GIPIUuid, MixableObject, Nullable, Numberish, VoidListener, iAPIError, iAppMessages, iBaseReportType, iButtonGroup, iCurrencyConfig, iDatePreset, iDateRange, iEchartsConfig, iFileUploadEvent, iFilterListbox, iFilterPersistenceConfig, iFilterSignal, iFilterSignalConfig, iLinkedFilterOptions, iMonthRange, iMonthValue, iPageAdjust, iPaginatorArgs, iPasswordRequirement, iPermission, iSplitButtonMenuItem, iTimeValue, iToggleSwitchChange, iUseFilterPersistence, iYearRange, tCheckboxGroupOption, tCheckboxState, tConfirmDialogTypes, tDateFilterFn, tDatePickerMode, tDatePickerValue, tEchartsThemeOption, tFilterListboxMode, tIconFontSet, tIconGrade, tIconOptical, tIconVariation, tIconWeight, tImplicitTemplateRef, tLozengeFill, tLozengeVariant, tMenuType, tMonthsEnglish, tOptionRadioGroup, tPageEvent, tPermissionKey, tRotateState, tSearchOptions, tSortDirection, tStateName, tTableColumnActionType, tTableColumnAlignHorizontal, tTableColumnAlignText, tTableColumnAlignVertical, tTableColumnCondition, tTableColumnPartial, tTimeFormat, tToastTypes, tTreeTableColumnCondition, tTreeTableColumnPartial, tTypeOperationCloseDialog, tTypeOperationDialog, tUFState, tVariantType, tWeekdaysEnglish };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gipisistemas/ngx-core",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "Componentes e utilitários para projetos da GIPI Sistemas.",
   "author": "GIPI Sistemas",
   "license": "MIT",