@smartbit4all/ng-client 3.3.244 → 3.4.0

package/lib/smart-form/services/smartform.service.d.ts

@@ -1,12 +1,15 @@
 import { FormGroup } from '@angular/forms';
 import { SmartFormWidget, SmartItem, SmartItems } from '../smartform.form-model';
 import { SmartForm, SmartValidator } from '../smartform.model';
+import { NamedValidatorService } from '../../smart-validation/named-validator.service';
 import * as i0 from "@angular/core";
 export declare class SmartFormService {
+    private validatorProvider?;
     private readonly emptyKey;
     group: any;
     formGroup?: FormGroup;
     smartForm?: SmartForm;
+    constructor(validatorProvider?: NamedValidatorService | undefined);
     getSmartFormWidgetByKey(key: string): SmartFormWidget<any> | undefined;
     private collectKeysFromSmartForm;
     private findSmartFormWidgetByKey;
@@ -41,6 +44,6 @@ export declare class SmartFormService {
     private getTranslationOfKey;
     translateWidgets(widgets: SmartFormWidget<any>[]): Promise<void>;
     translateWidgetItems(widgets: SmartItems<any>[]): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SmartFormService, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SmartFormService, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SmartFormService>;
 }

package/lib/smart-form/smartform.form-model.d.ts

@@ -91,7 +91,7 @@ export interface SmartTextFieldChips<T> {
     value?: T;
     placeholder?: string;
     originalPlaceholder?: string;
-    minWidth?: SmartFormWidgetWidth | number | number;
+    minWidth?: SmartFormWidgetWidth | number;
     isDisabled?: boolean;
     isReadonly?: boolean;
     validators?: SmartValidator[];
@@ -121,7 +121,7 @@ export interface SmartTextFieldLookup<T> {
     value?: T;
     placeholder?: string;
     originalPlaceholder?: string;
-    minWidth?: SmartFormWidgetWidth | number | number;
+    minWidth?: SmartFormWidgetWidth | number;
     isDisabled?: boolean;
     isReadonly?: boolean;
     validators?: SmartValidator[];

package/lib/smart-form/smartform.model.d.ts

@@ -2,6 +2,7 @@ import { ValidatorFn } from '@angular/forms';
 import { SmartFormWidget } from './smartform.form-model';
 import { SmartFormWidgetDirection } from './api';
 import { SmartTranslateService } from '../view-context/smart-view-context.model';
+import { NamedValidator } from '../view-context/api';
 export interface SophisticatedValueChange {
     key: string;
     value: any;
@@ -15,6 +16,11 @@ export interface SmartFormComponentConstraint {
     visible?: boolean;
     mandatory?: boolean;
     enabled?: boolean;
+    max?: number;
+    maxLength?: number;
+    min?: number;
+    minLength?: number;
+    namedValidators?: Array<NamedValidator>;
 }
 export declare enum SmartFormWidgetWidth {
     SMALL = 150,

package/lib/smart-form/validators/validator-provider.d.ts

@@ -0,0 +1,16 @@
+import { InjectionToken } from '@angular/core';
+import { SmartValidator } from '../smartform.model';
+import { SmartFormWidget } from '../smartform.form-model';
+import { ComponentConstraint } from '../../view-context/projects';
+import * as i0 from "@angular/core";
+export declare const SMART_VALIDATOR: InjectionToken<SmartValidator>;
+export declare class ValidatorProvider {
+    private readonly validatorsByName;
+    constructor(vs: Array<SmartValidator> | undefined);
+    provide(name: string): SmartValidator | undefined;
+    clearProvidedValidators(widget: SmartFormWidget<any>): void;
+    apply2(widget: SmartFormWidget<any>, constraints: ComponentConstraint[]): void;
+    apply(widget: SmartFormWidget<any>, validatorName: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidatorProvider, [{ optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ValidatorProvider>;
+}

package/lib/smart-validation/named-validator.service.d.ts

@@ -0,0 +1,17 @@
+import { SmartFormWidget } from '../smart-form/smartform.form-model';
+import { SmartFormComponentConstraint, SmartValidator } from '../smart-form/smartform.model';
+import { ValidatorFactory } from './smart-validation.types';
+import * as i0 from "@angular/core";
+export declare type ValidatedWidget<T> = SmartFormWidget<T> & {
+    validators: Array<SmartValidator>;
+};
+export declare class NamedValidatorService {
+    private readonly factories;
+    constructor(factories: Array<ValidatorFactory>);
+    applyConstraint(w: ValidatedWidget<any>, c: SmartFormComponentConstraint): void;
+    private applyBuiltInValidators;
+    private applyNamedValidators;
+    private applyNamedValidator;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NamedValidatorService, [{ optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NamedValidatorService>;
+}

package/lib/smart-validation/projects.d.ts

@@ -0,0 +1,3 @@
+export * from './smart-validation.types';
+export * from './smart-validation.module';
+export * from './named-validator.service';

package/lib/smart-validation/smart-validation.module.d.ts

@@ -0,0 +1,8 @@
+import { ModuleWithProviders, Provider } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class SmartValidationModule {
+    static forRoot(providers: Array<Provider>): ModuleWithProviders<SmartValidationModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SmartValidationModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SmartValidationModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SmartValidationModule>;
+}

package/lib/smart-validation/smart-validation.types.d.ts

@@ -0,0 +1,12 @@
+import { ValidatorFn } from '@angular/forms';
+import { InjectionToken } from '@angular/core';
+export interface ValidatorParameters {
+    [k: string]: any;
+}
+export declare const EMPTY_PARAMS: ValidatorParameters;
+export interface ValidatorFactory {
+    name: string;
+    params: Array<String>;
+    create(validatorParameters?: ValidatorParameters): ValidatorFn;
+}
+export declare const NAMED_VALIDATOR: InjectionToken<ValidatorFactory>;

package/lib/view-context/api/model/componentConstraint.d.ts

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { NamedValidator } from './namedValidator';
 import { ValueSetData } from '../../value-api';
 /**
  * The component constraint is responsible for the constraints belong to a given component (textfield, combobox etc.) on the view. The UI must identify the component by the dataName that is a path of the data name separated by dot like dataSheet.field.
@@ -22,4 +23,9 @@ export interface ComponentConstraint {
     mandatory?: boolean;
     enabled?: boolean;
     valueSet?: ValueSetData;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    namedValidators: Array<NamedValidator>;
 }

package/lib/view-context/api/model/models.d.ts

@@ -17,6 +17,7 @@ export * from './messageOptionType';
 export * from './messageResult';
 export * from './messageTextType';
 export * from './messageType';
+export * from './namedValidator';
 export * from './openPendingData';
 export * from './serverRequestExecutionStat';
 export * from './serverRequestTrack';

package/lib/view-context/api/model/namedValidator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * View API
+ * View API
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: info@it4all.hu
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export interface NamedValidator {
+    name: string;
+    params: {
+        [key: string]: object;
+    };
+    /**
+     * ADD:     REMOVE:  ALTER:  Do not explicitly add, but alter preexisting matching validator\'s parameters
+     */
+    operation: NamedValidatorOperationEnum;
+}
+export declare enum NamedValidatorOperationEnum {
+    ADD = "ADD",
+    REMOVE = "REMOVE",
+    ALTER = "ALTER"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbit4all/ng-client",
-  "version": "3.3.244",
+  "version": "3.4.0",
   "peerDependencies": {
     "@angular/animations": "^13.3.9",
     "@angular/common": "^13.2.0",

package/projects.d.ts

@@ -17,6 +17,7 @@ export * from './lib/smart-subject/projects';
 export * from './lib/smart-tab-group/projects';
 export * from './lib/smart-table/projects';
 export * from './lib/smart-tree/projects';
+export * from './lib/smart-validation/projects';
 export * from './lib/view-context/projects';
 export * from './lib/smart-filter-editor/project';
 export * from './lib/shared/projects';

package/src/lib/smart-component-layout/api/README.md

@@ -1,226 +1,226 @@
-## @
-
-### Building
-
-To install the required dependencies and to build the typescript sources run:
-```
-npm install
-npm run build
-```
-
-### publishing
-
-First build the package then run ```npm publish dist``` (don't forget to specify the `dist` folder!)
-
-### consuming
-
-Navigate to the folder of your consuming project and run one of next commands.
-
-_published:_
-
-```
-npm install @ --save
-```
-
-_without publishing (not recommended):_
-
-```
-npm install PATH_TO_GENERATED_PACKAGE/dist.tgz --save
-```
-
-_It's important to take the tgz file, otherwise you'll get trouble with links on windows_
-
-_using `npm link`:_
-
-In PATH_TO_GENERATED_PACKAGE/dist:
-```
-npm link
-```
-
-In your project:
-```
-npm link 
-```
-
-__Note for Windows users:__ The Angular CLI has troubles to use linked npm packages.
-Please refer to this issue https://github.com/angular/angular-cli/issues/8284 for a solution / workaround.
-Published packages are not effected by this issue.
-
-
-#### General usage
-
-In your Angular project:
-
-
-```
-// without configuring providers
-import { ApiModule } from '';
-import { HttpClientModule } from '@angular/common/http';
-
-@NgModule({
-    imports: [
-        ApiModule,
-        // make sure to import the HttpClientModule in the AppModule only,
-        // see https://github.com/angular/angular/issues/20575
-        HttpClientModule
-    ],
-    declarations: [ AppComponent ],
-    providers: [],
-    bootstrap: [ AppComponent ]
-})
-export class AppModule {}
-```
-
-```
-// configuring providers
-import { ApiModule, Configuration, ConfigurationParameters } from '';
-
-export function apiConfigFactory (): Configuration {
-  const params: ConfigurationParameters = {
-    // set configuration parameters here.
-  }
-  return new Configuration(params);
-}
-
-@NgModule({
-    imports: [ ApiModule.forRoot(apiConfigFactory) ],
-    declarations: [ AppComponent ],
-    providers: [],
-    bootstrap: [ AppComponent ]
-})
-export class AppModule {}
-```
-
-```
-// configuring providers with an authentication service that manages your access tokens
-import { ApiModule, Configuration } from '';
-
-@NgModule({
-    imports: [ ApiModule ],
-    declarations: [ AppComponent ],
-    providers: [
-      {
-        provide: Configuration,
-        useFactory: (authService: AuthService) => new Configuration(
-          {
-            basePath: environment.apiUrl,
-            accessToken: authService.getAccessToken.bind(authService)
-          }
-        ),
-        deps: [AuthService],
-        multi: false
-      }
-    ],
-    bootstrap: [ AppComponent ]
-})
-export class AppModule {}
-```
-
-```
-import { DefaultApi } from '';
-
-export class AppComponent {
-    constructor(private apiGateway: DefaultApi) { }
-}
-```
-
-Note: The ApiModule is restricted to being instantiated once app wide.
-This is to ensure that all services are treated as singletons.
-
-#### Using multiple OpenAPI files / APIs / ApiModules
-In order to use multiple `ApiModules` generated from different OpenAPI files,
-you can create an alias name when importing the modules
-in order to avoid naming conflicts:
-```
-import { ApiModule } from 'my-api-path';
-import { ApiModule as OtherApiModule } from 'my-other-api-path';
-import { HttpClientModule } from '@angular/common/http';
-
-@NgModule({
-  imports: [
-    ApiModule,
-    OtherApiModule,
-    // make sure to import the HttpClientModule in the AppModule only,
-    // see https://github.com/angular/angular/issues/20575
-    HttpClientModule
-  ]
-})
-export class AppModule {
-
-}
-```
-
-
-### Set service base path
-If different than the generated base path, during app bootstrap, you can provide the base path to your service.
-
-```
-import { BASE_PATH } from '';
-
-bootstrap(AppComponent, [
-    { provide: BASE_PATH, useValue: 'https://your-web-service.com' },
-]);
-```
-or
-
-```
-import { BASE_PATH } from '';
-
-@NgModule({
-    imports: [],
-    declarations: [ AppComponent ],
-    providers: [ provide: BASE_PATH, useValue: 'https://your-web-service.com' ],
-    bootstrap: [ AppComponent ]
-})
-export class AppModule {}
-```
-
-
-#### Using @angular/cli
-First extend your `src/environments/*.ts` files by adding the corresponding base path:
-
-```
-export const environment = {
-  production: false,
-  API_BASE_PATH: 'http://127.0.0.1:8080'
-};
-```
-
-In the src/app/app.module.ts:
-```
-import { BASE_PATH } from '';
-import { environment } from '../environments/environment';
-
-@NgModule({
-  declarations: [
-    AppComponent
-  ],
-  imports: [ ],
-  providers: [{ provide: BASE_PATH, useValue: environment.API_BASE_PATH }],
-  bootstrap: [ AppComponent ]
-})
-export class AppModule { }
-```
-
-### Customizing path parameter encoding
-
-Without further customization, only [path-parameters][parameter-locations-url] of [style][style-values-url] 'simple'
-and Dates for format 'date-time' are encoded correctly.
-
-Other styles (e.g. "matrix") are not that easy to encode
-and thus are best delegated to other libraries (e.g.: [@honoluluhenk/http-param-expander]).
-
-To implement your own parameter encoding (or call another library),
-pass an arrow-function or method-reference to the `encodeParam` property of the Configuration-object
-(see [General Usage](#general-usage) above).
-
-Example value for use in your Configuration-Provider:
-```typescript
-new Configuration({
-    encodeParam: (param: Param) => myFancyParamEncoder(param),
-})
-```
-
-[parameter-locations-url]: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-locations
-[style-values-url]: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#style-values
-[@honoluluhenk/http-param-expander]: https://www.npmjs.com/package/@honoluluhenk/http-param-expander
+## @
+
+### Building
+
+To install the required dependencies and to build the typescript sources run:
+```
+npm install
+npm run build
+```
+
+### publishing
+
+First build the package then run ```npm publish dist``` (don't forget to specify the `dist` folder!)
+
+### consuming
+
+Navigate to the folder of your consuming project and run one of next commands.
+
+_published:_
+
+```
+npm install @ --save
+```
+
+_without publishing (not recommended):_
+
+```
+npm install PATH_TO_GENERATED_PACKAGE/dist.tgz --save
+```
+
+_It's important to take the tgz file, otherwise you'll get trouble with links on windows_
+
+_using `npm link`:_
+
+In PATH_TO_GENERATED_PACKAGE/dist:
+```
+npm link
+```
+
+In your project:
+```
+npm link 
+```
+
+__Note for Windows users:__ The Angular CLI has troubles to use linked npm packages.
+Please refer to this issue https://github.com/angular/angular-cli/issues/8284 for a solution / workaround.
+Published packages are not effected by this issue.
+
+
+#### General usage
+
+In your Angular project:
+
+
+```
+// without configuring providers
+import { ApiModule } from '';
+import { HttpClientModule } from '@angular/common/http';
+
+@NgModule({
+    imports: [
+        ApiModule,
+        // make sure to import the HttpClientModule in the AppModule only,
+        // see https://github.com/angular/angular/issues/20575
+        HttpClientModule
+    ],
+    declarations: [ AppComponent ],
+    providers: [],
+    bootstrap: [ AppComponent ]
+})
+export class AppModule {}
+```
+
+```
+// configuring providers
+import { ApiModule, Configuration, ConfigurationParameters } from '';
+
+export function apiConfigFactory (): Configuration {
+  const params: ConfigurationParameters = {
+    // set configuration parameters here.
+  }
+  return new Configuration(params);
+}
+
+@NgModule({
+    imports: [ ApiModule.forRoot(apiConfigFactory) ],
+    declarations: [ AppComponent ],
+    providers: [],
+    bootstrap: [ AppComponent ]
+})
+export class AppModule {}
+```
+
+```
+// configuring providers with an authentication service that manages your access tokens
+import { ApiModule, Configuration } from '';
+
+@NgModule({
+    imports: [ ApiModule ],
+    declarations: [ AppComponent ],
+    providers: [
+      {
+        provide: Configuration,
+        useFactory: (authService: AuthService) => new Configuration(
+          {
+            basePath: environment.apiUrl,
+            accessToken: authService.getAccessToken.bind(authService)
+          }
+        ),
+        deps: [AuthService],
+        multi: false
+      }
+    ],
+    bootstrap: [ AppComponent ]
+})
+export class AppModule {}
+```
+
+```
+import { DefaultApi } from '';
+
+export class AppComponent {
+    constructor(private apiGateway: DefaultApi) { }
+}
+```
+
+Note: The ApiModule is restricted to being instantiated once app wide.
+This is to ensure that all services are treated as singletons.
+
+#### Using multiple OpenAPI files / APIs / ApiModules
+In order to use multiple `ApiModules` generated from different OpenAPI files,
+you can create an alias name when importing the modules
+in order to avoid naming conflicts:
+```
+import { ApiModule } from 'my-api-path';
+import { ApiModule as OtherApiModule } from 'my-other-api-path';
+import { HttpClientModule } from '@angular/common/http';
+
+@NgModule({
+  imports: [
+    ApiModule,
+    OtherApiModule,
+    // make sure to import the HttpClientModule in the AppModule only,
+    // see https://github.com/angular/angular/issues/20575
+    HttpClientModule
+  ]
+})
+export class AppModule {
+
+}
+```
+
+
+### Set service base path
+If different than the generated base path, during app bootstrap, you can provide the base path to your service.
+
+```
+import { BASE_PATH } from '';
+
+bootstrap(AppComponent, [
+    { provide: BASE_PATH, useValue: 'https://your-web-service.com' },
+]);
+```
+or
+
+```
+import { BASE_PATH } from '';
+
+@NgModule({
+    imports: [],
+    declarations: [ AppComponent ],
+    providers: [ provide: BASE_PATH, useValue: 'https://your-web-service.com' ],
+    bootstrap: [ AppComponent ]
+})
+export class AppModule {}
+```
+
+
+#### Using @angular/cli
+First extend your `src/environments/*.ts` files by adding the corresponding base path:
+
+```
+export const environment = {
+  production: false,
+  API_BASE_PATH: 'http://127.0.0.1:8080'
+};
+```
+
+In the src/app/app.module.ts:
+```
+import { BASE_PATH } from '';
+import { environment } from '../environments/environment';
+
+@NgModule({
+  declarations: [
+    AppComponent
+  ],
+  imports: [ ],
+  providers: [{ provide: BASE_PATH, useValue: environment.API_BASE_PATH }],
+  bootstrap: [ AppComponent ]
+})
+export class AppModule { }
+```
+
+### Customizing path parameter encoding
+
+Without further customization, only [path-parameters][parameter-locations-url] of [style][style-values-url] 'simple'
+and Dates for format 'date-time' are encoded correctly.
+
+Other styles (e.g. "matrix") are not that easy to encode
+and thus are best delegated to other libraries (e.g.: [@honoluluhenk/http-param-expander]).
+
+To implement your own parameter encoding (or call another library),
+pass an arrow-function or method-reference to the `encodeParam` property of the Configuration-object
+(see [General Usage](#general-usage) above).
+
+Example value for use in your Configuration-Provider:
+```typescript
+new Configuration({
+    encodeParam: (param: Param) => myFancyParamEncoder(param),
+})
+```
+
+[parameter-locations-url]: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-locations
+[style-values-url]: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#style-values
+[@honoluluhenk/http-param-expander]: https://www.npmjs.com/package/@honoluluhenk/http-param-expander