@ecodev/natural 64.0.2 → 65.0.1

package/index.d.ts

@@ -1678,8 +1678,8 @@ declare function validateAllFormControls(control: AbstractControl<unknown>): voi
 /**
  * Emits exactly 0 or 1 time:
  *
- * - if the form is VALID, emits immediately
- * - if the form is PENDING emits if it changes from PENDING to VALID
+ * - if the form is `VALID`, emits immediately
+ * - if the form is `PENDING` emits if it changes from `PENDING` to `VALID`
  * - any other cases will **never** emit
  */
 declare function ifValid(control: AbstractControl): Observable<'VALID'>;
@@ -1689,23 +1689,21 @@ declare function ifValid(control: AbstractControl): Observable<'VALID'>;
  * This is meant to replace **all** usages of Angular too permissive `Validators.email`
  */
 declare function deliverableEmail(control: AbstractControl): ValidationErrors | null;
+declare const urlPattern: string;
 /**
  * Naive URL validator for "normal" web links, that is a bit too permissive
  *
- * It enforces:
- *
+ * - It enforces:
  *     - http/https protocol
  *     - one domain
  *     - one tld
- *
- * It allows:
- *
+ * - It allows:
  *     - any number of subdomains
  *     - any parameters
  *     - any fragments
  *     - any characters for any parts (does not conform to rfc1738)
  */
-declare const urlValidator: ValidatorFn;
+declare const url: ValidatorFn;
 /**
  * Validates that the value is an integer (non-float)
  */
@@ -1721,6 +1719,26 @@ declare function decimal(scale: number): ValidatorFn;
  * Validate that the value is an amount of money, meaning a number with at most 2 decimals
  */
 declare function money(control: AbstractControl): ValidationErrors | null;
+/**
+ * Validate that the number is strictly greater than given one.
+ *
+ * `Validators.min()` is "greater than or equal", but this one is strictly
+ * "greater than".
+ *
+ * **SHOULD NOT USE IT**, instead consider using Angular's native `Validators.min()`.
+ * Because you should also apply `[attr.min]="123"` in the template to have the browser
+ * help the user. And that attribute spec defines that it is "greater or equal", which
+ * contradicts this validator. So we cannot use this validator and have the best UX.
+ */
+declare function greaterThan(min: number): ValidatorFn;
+/**
+ * Validate a 32 bits MiFare hexadecimal CSN
+ */
+declare function nfcCardHex(control: AbstractControl): ValidationErrors | null;
+/**
+ * Validate a time similar to "14h35", "14:35" or "14h".
+ */
+declare function time(control: AbstractControl): ValidationErrors | null;
 
 type ProgressBar = {
     start: () => void;
@@ -1926,6 +1944,64 @@ declare class NaturalEnumPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<NaturalEnumPipe, "enum", true>;
 }
 
+/**
+ * Return a single error message for the first found error, if any.
+ *
+ * Typical usage is without `@if`:
+ *
+ * ```html
+ * <mat-form-field>
+ *     <input matInput formControlName="name" />
+ *     <mat-label i18n>Nom</mat-label>
+ *     <mat-error>{{ form.get('name')?.errors | errorMessage }}</mat-error>
+ * </mat-form-field>
+ * ```
+ *
+ * If you need custom error messages, you can override, or defined new ones like that:
+ *
+ * ```html
+ * <mat-form-field>
+ *     <input matInput formControlName="name" />
+ *     <mat-label i18n>Nom</mat-label>
+ *     @if (form.get('name')?.hasError('required')) {
+ *         <mat-error>Ce champ est requis parce qu'il est vraiment très important</mat-error>
+ *     } @else {
+ *         <mat-error>{{ form.get('name')?.errors | errorMessage }}</mat-error>
+ *     }
+ * </mat-form-field>
+ * ```
+ *
+ * Supported validators are:
+ *
+ * - Angular
+ *     - `Validators.max`
+ *     - `Validators.maxlength`
+ *     - `Validators.min`
+ *     - `Validators.minlength`
+ *     - `Validators.required`
+ * - Natural
+ *     - `available`
+ *     - `decimal`
+ *     - `deliverableEmail`
+ *     - `greaterThan`
+ *     - `integer`
+ *     - `money`
+ *     - `nfcCardHex`
+ *     - `time`
+ *     - `unique`
+ *     - `url`
+ * - Others, that live in individual projects, but we exceptionally support here
+ *     - `iban`
+ *     - `validateCity`
+ *
+ * @param unit is used to build the message for the following validators: `min`, `max`, `greaterThan`
+ */
+declare class NaturalErrorMessagePipe implements PipeTransform {
+    transform(errors: ValidationErrors | null | undefined, unit?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NaturalErrorMessagePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<NaturalErrorMessagePipe, "errorMessage", true>;
+}
+
 /**
  * Returns a string to approximately describe the date.
  *
@@ -2672,13 +2748,6 @@ declare class TypeDateRangeComponent<D = any> implements DropdownComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<TypeDateRangeComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-type NaturalDropdownData<C = any> = {
-    condition: FilterGroupConditionField | null;
-    configuration: C;
-    title?: string;
-};
-declare const NATURAL_DROPDOWN_DATA: InjectionToken<NaturalDropdownData<any>>;
-
 type TypeOption = {
     display: string;
     condition: Literal;
@@ -2687,13 +2756,12 @@ type TypeOptionsConfiguration = {
     options: TypeOption[];
 };
 declare class TypeOptionsComponent implements DropdownComponent {
-    readonly data: NaturalDropdownData<TypeOptionsConfiguration>;
     readonly renderedValue: BehaviorSubject<string>;
     readonly formControl: FormControl<TypeOption>;
     readonly configuration: Required<TypeOptionsConfiguration>;
     private readonly defaults;
     protected readonly dropdownRef: NaturalDropdownRef;
-    constructor(data: NaturalDropdownData<TypeOptionsConfiguration>);
+    constructor();
     getCondition(): FilterGroupConditionField;
     isValid(): boolean;
     isDirty(): boolean;
@@ -2706,7 +2774,6 @@ type TypeBooleanConfiguration = {
     displayWhenInactive: string;
 };
 declare class TypeBooleanComponent extends TypeOptionsComponent implements DropdownComponent {
-    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<TypeBooleanComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TypeBooleanComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
@@ -3298,6 +3365,13 @@ declare class NaturalRelationsComponent<TService extends NaturalAbstractModelSer
     static ɵcmp: i0.ɵɵComponentDeclaration<NaturalRelationsComponent<any>, "natural-relations", never, { "service": { "alias": "service"; "required": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "autocompleteSelectorFilter": { "alias": "autocompleteSelectorFilter"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; }; "main": { "alias": "main"; "required": true; }; "hierarchicSelectorFilters": { "alias": "hierarchicSelectorFilters"; "required": false; "isSignal": true; }; "hierarchicSelectorConfig": { "alias": "hierarchicSelectorConfig"; "required": false; "isSignal": true; }; "otherName": { "alias": "otherName"; "required": false; }; "filter": { "alias": "filter"; "required": false; }; "sorting": { "alias": "sorting"; "required": false; }; }, { "selectionChange": "selectionChange"; }, ["itemTemplate"], never, true, never>;
 }
 
+type NaturalDropdownData<C = any> = {
+    condition: FilterGroupConditionField | null;
+    configuration: C;
+    title?: string;
+};
+declare const NATURAL_DROPDOWN_DATA: InjectionToken<NaturalDropdownData<any>>;
+
 declare function toGraphQLDoctrineFilter(facets: NaturalSearchFacets | null, selections: NaturalSearchSelections | null): Filter;
 
 /**
@@ -4194,5 +4268,5 @@ declare const naturalProviders: ApplicationConfig['providers'];
  */
 declare function graphqlQuerySigner(key: string): HttpInterceptorFn;
 
-export { AvatarService, InvalidWithValueStateMatcher$1 as InvalidWithValueStateMatcher, LOCAL_STORAGE, NATURAL_DROPDOWN_DATA, NATURAL_ICONS_CONFIG, NATURAL_PERSISTENCE_VALIDATOR, NATURAL_SEO_CONFIG, NaturalAbstractDetail, NaturalAbstractEditableList, NaturalAbstractList, NaturalAbstractModelService, NaturalAbstractNavigableList, NaturalAbstractPanel, NaturalAlertService, NaturalAvatarComponent, NaturalBackgroundDensityDirective, NaturalCapitalizePipe, NaturalColumnsPickerComponent, NaturalConfirmComponent, NaturalDataSource, NaturalDebounceService, NaturalDetailHeaderComponent, NaturalDialogTriggerComponent, NaturalDropdownRef, NaturalEllipsisPipe, NaturalEnumPipe, NaturalEnumService, NaturalErrorHandler, NaturalFileComponent, NaturalFileDropDirective, NaturalFileSelectDirective, NaturalFileService, NaturalFixedButtonComponent, NaturalFixedButtonDetailComponent, NaturalHierarchicSelectorComponent, NaturalHierarchicSelectorDialogComponent, NaturalHierarchicSelectorDialogService, NaturalHierarchicSelectorService, NaturalHttpPrefixDirective, NaturalIconDirective, NaturalLinkMutationService, NaturalLinkableTabDirective, NaturalLoggerConfigExtra, NaturalLoggerConfigUrl, NaturalMatomoService, NaturalMemoryStorage, NaturalPanelsComponent, NaturalPanelsService, NaturalPersistenceService, NaturalQueryVariablesManager, NaturalRelationsComponent, NaturalSearchComponent, NaturalSelectComponent, NaturalSelectEnumComponent, NaturalSelectHierarchicComponent, NaturalSeoService, NaturalSidenavComponent, NaturalSidenavContainerComponent, NaturalSidenavContentComponent, NaturalSidenavService, NaturalSidenavStackService, NaturalSrcDensityDirective, NaturalStampComponent, NaturalSwissParsingDateAdapter, NaturalTableButtonComponent, NaturalTimeAgoPipe, NetworkActivityService, PanelsHooksConfig, SESSION_STORAGE, SortingOrder, TypeBooleanComponent, TypeDateComponent, TypeDateRangeComponent, TypeHierarchicSelectorComponent, TypeNaturalSelectComponent, TypeNumberComponent, TypeOptionsComponent, TypeSelectComponent, TypeTextComponent, activityInterceptor, available, cancellableTimeout, cloneDeepButSkipFile, collectErrors, commonImageMimeTypes, copyToClipboard, createHttpLink, debug, decimal, deepFreeze, deliverableEmail, ensureHttpPrefix, fallbackIfNoOpenedPanels, formatIsoDate, formatIsoDateTime, fromUrl, getForegroundColor, graphqlQuerySigner, hasFilesAndProcessDate, ifValid, integer, isFile, localStorageFactory, localStorageProvider, makePlural, memoryLocalStorageProvider, memorySessionStorageProvider, mergeOverrideArray, money, naturalPanelsUrlMatcher, naturalProviders, onHistoryEvent, possibleComparableOperators, provideErrorHandler, provideIcons, providePanels, provideSeo, relationsToIds, replaceObjectKeepingReference, replaceOperatorByField, replaceOperatorByName, rgbToHex, sessionStorageFactory, sessionStorageProvider, toGraphQLDoctrineFilter, toNavigationParameters, toUrl, unique, upperCaseFirstLetter, urlValidator, validTlds, validateAllFormControls, validateColumns, validatePagination, validateSorting, wrapLike, wrapPrefix, wrapSuffix };
+export { AvatarService, InvalidWithValueStateMatcher$1 as InvalidWithValueStateMatcher, LOCAL_STORAGE, NATURAL_DROPDOWN_DATA, NATURAL_ICONS_CONFIG, NATURAL_PERSISTENCE_VALIDATOR, NATURAL_SEO_CONFIG, NaturalAbstractDetail, NaturalAbstractEditableList, NaturalAbstractList, NaturalAbstractModelService, NaturalAbstractNavigableList, NaturalAbstractPanel, NaturalAlertService, NaturalAvatarComponent, NaturalBackgroundDensityDirective, NaturalCapitalizePipe, NaturalColumnsPickerComponent, NaturalConfirmComponent, NaturalDataSource, NaturalDebounceService, NaturalDetailHeaderComponent, NaturalDialogTriggerComponent, NaturalDropdownRef, NaturalEllipsisPipe, NaturalEnumPipe, NaturalEnumService, NaturalErrorHandler, NaturalErrorMessagePipe, NaturalFileComponent, NaturalFileDropDirective, NaturalFileSelectDirective, NaturalFileService, NaturalFixedButtonComponent, NaturalFixedButtonDetailComponent, NaturalHierarchicSelectorComponent, NaturalHierarchicSelectorDialogComponent, NaturalHierarchicSelectorDialogService, NaturalHierarchicSelectorService, NaturalHttpPrefixDirective, NaturalIconDirective, NaturalLinkMutationService, NaturalLinkableTabDirective, NaturalLoggerConfigExtra, NaturalLoggerConfigUrl, NaturalMatomoService, NaturalMemoryStorage, NaturalPanelsComponent, NaturalPanelsService, NaturalPersistenceService, NaturalQueryVariablesManager, NaturalRelationsComponent, NaturalSearchComponent, NaturalSelectComponent, NaturalSelectEnumComponent, NaturalSelectHierarchicComponent, NaturalSeoService, NaturalSidenavComponent, NaturalSidenavContainerComponent, NaturalSidenavContentComponent, NaturalSidenavService, NaturalSidenavStackService, NaturalSrcDensityDirective, NaturalStampComponent, NaturalSwissParsingDateAdapter, NaturalTableButtonComponent, NaturalTimeAgoPipe, NetworkActivityService, PanelsHooksConfig, SESSION_STORAGE, SortingOrder, TypeBooleanComponent, TypeDateComponent, TypeDateRangeComponent, TypeHierarchicSelectorComponent, TypeNaturalSelectComponent, TypeNumberComponent, TypeOptionsComponent, TypeSelectComponent, TypeTextComponent, activityInterceptor, available, cancellableTimeout, cloneDeepButSkipFile, collectErrors, commonImageMimeTypes, copyToClipboard, createHttpLink, debug, decimal, deepFreeze, deliverableEmail, ensureHttpPrefix, fallbackIfNoOpenedPanels, formatIsoDate, formatIsoDateTime, fromUrl, getForegroundColor, graphqlQuerySigner, greaterThan, hasFilesAndProcessDate, ifValid, integer, isFile, localStorageFactory, localStorageProvider, makePlural, memoryLocalStorageProvider, memorySessionStorageProvider, mergeOverrideArray, money, naturalPanelsUrlMatcher, naturalProviders, nfcCardHex, onHistoryEvent, possibleComparableOperators, provideErrorHandler, provideIcons, providePanels, provideSeo, relationsToIds, replaceObjectKeepingReference, replaceOperatorByField, replaceOperatorByName, rgbToHex, sessionStorageFactory, sessionStorageProvider, time, toGraphQLDoctrineFilter, toNavigationParameters, toUrl, unique, upperCaseFirstLetter, url, urlPattern, validTlds, validateAllFormControls, validateColumns, validatePagination, validateSorting, wrapLike, wrapPrefix, wrapSuffix };
 export type { AvailableColumn, Button, DropdownComponent, DropdownFacet, ExtractResolve, ExtractTall, ExtractTallOne, ExtractTcreate, ExtractTdelete, ExtractTone, ExtractTupdate, ExtractVall, ExtractVcreate, ExtractVdelete, ExtractVone, ExtractVupdate, Facet, FileModel, FileSelection, Filter, FilterGroupConditionField, FlagFacet, FormAsyncValidators, FormControls, FormValidators, HierarchicDialogConfig, HierarchicDialogResult, HierarchicFilterConfiguration$1 as HierarchicFilterConfiguration, HierarchicFiltersConfiguration$1 as HierarchicFiltersConfiguration, IEnum, InvalidFile, LinkableObject, Literal, NameOrFullName, NaturalConfirmData, NaturalDialogTriggerProvidedData, NaturalDialogTriggerRedirectionValues, NaturalDialogTriggerRoutingData, NaturalDropdownData, NaturalHierarchicConfiguration, NaturalIconConfig, NaturalIconsConfig, NaturalLoggerExtra, NaturalLoggerType, NaturalPanelConfig, NaturalPanelData, NaturalPanelResolves, NaturalPanelsBeforeOpenPanel, NaturalPanelsHooksConfig, NaturalPanelsRouteConfig, NaturalPanelsRouterRule, NaturalPanelsRoutesConfig, NaturalSearchFacets, NaturalSearchSelection, NaturalSearchSelections, NaturalSeo, NaturalSeoBasic, NaturalSeoCallback, NaturalSeoConfig, NaturalSeoResolve, NaturalSeoResolveData, NaturalStorage, NavigableItem, OrganizedModelSelection, PaginatedData, PaginationInput, PersistenceValidator, PossibleComparableOpertorKeys, QueryVariables, ResolvedData, Sorting, SubButton, TypeBooleanConfiguration, TypeDateConfiguration, TypeDateRangeConfiguration, TypeHierarchicSelectorConfiguration, TypeNumberConfiguration, TypeOption, TypeOptionsConfiguration, TypeSelectConfiguration, TypeSelectItem, TypeSelectNaturalConfiguration, VariablesWithInput, WithId };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecodev/natural",
-  "version": "64.0.2",
+  "version": "65.0.1",
   "license": "MIT",
   "repository": "github:Ecodev/natural",
   "sideEffects": false,
@@ -12,10 +12,6 @@
     },
     "./package.json": {
       "default": "./package.json"
-    },
-    "./vanilla": {
-      "types": "./vanilla/index.d.ts",
-      "default": "./fesm2022/ecodev-natural-vanilla.mjs"
     }
   },
   "dependencies": {