@mediusinc/mng-commons-data-api 5.2.0-rc.0 → 5.2.0-rc.2

package/tableview/schema/fields-from-schema.d.ts

@@ -0,0 +1,321 @@
+import { SchemaEnum, SchemaModel, SchemaProperty } from '@mediusinc/mng-commons-data-api';
+import { ArrayItemType, KeyofAndOfType } from '@mediusinc/mng-commons/core';
+import { EnumDescriptor, TypeDescriptor } from '@mediusinc/mng-commons/model';
+import { ITableDataProvider, TableDescriptorInst } from '@mediusinc/mng-commons/table/api';
+import { AFieldDescriptor, EditorDescriptorInst, FieldInputDescriptor, FieldLookupDescriptor, FieldLookupEnumDescriptor, FieldLookupProviderType, FieldManyEditorDescriptor, FieldManyToManyEditorDescriptor, TableviewDescriptorInst } from '@mediusinc/mng-commons/tableview/api';
+import { FromSchemaCurrencyOptsType } from './internal/common-from-schema';
+type FieldInputType = 'number' | 'currency' | 'boolean' | 'string' | 'text' | 'textarea' | 'date' | 'date-time' | 'enum' | 'hidden';
+type FieldsFromSchemaOptsType<Model = any> = {
+    fieldTypes?: Partial<Record<keyof Model, FieldInputType>>;
+    enumModels?: Partial<Record<keyof Model, EnumDescriptor<any>>>;
+    enumSchemas?: Partial<Record<keyof Model, SchemaEnum<any>>>;
+    dateFormat?: string;
+    dateTimeFormat?: string;
+};
+type FieldInputFromSchemaOptsType<Model = any, Enum = any> = {
+    fieldType?: FieldInputType;
+    enumSchema?: SchemaEnum<Enum>;
+    enumModel?: EnumDescriptor<Enum>;
+    currency?: FromSchemaCurrencyOptsType<Model>;
+    dateFormat?: string;
+    dateTimeFormat?: string;
+};
+/**
+ * <em>Experimental:</em> Builder for adding fields to editor.
+ *
+ * @experimental
+ */
+export declare class SchemaFieldsBuilder<Model, Parent = unknown, SchModel = Model> {
+    private readonly descriptor;
+    private readonly schema;
+    private opts?;
+    constructor(descriptor: TableviewDescriptorInst<Model, any, any, Parent> | EditorDescriptorInst<Model>, schema: SchemaModel<SchModel>, opts?: FieldsFromSchemaOptsType<SchModel> | undefined);
+    private mergeFieldsInputOpts;
+    private mergeFieldInputOpts;
+    /**
+     * <em>Experimental:</em> Adds a single input field via {addFieldInputFromSchema}.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to add the field for.
+     * @param {FieldInputFromSchemaOptsType<SchModel>} opts - Additional options.
+     *
+     * @return {FieldInputDescriptor<Model, NonNullable<Model[Property]>, Model[Property], Parent>} The added field descriptor.
+     */
+    add<Property extends Extract<keyof Model, keyof SchModel>>(property: Property, opts?: FieldInputFromSchemaOptsType<SchModel>): FieldInputDescriptor<Model, NonNullable<Model[Property]>, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds all input fields for the non-array properties via {addFieldInputFromSchema}.
+     *
+     * @experimental
+     *
+     * @param {FieldsFromSchemaOptsType<SchModel>} opts - Additional options.
+     *
+     * @return {this} - The current instance of the builder.
+     */
+    withAddAll(opts?: FieldsFromSchemaOptsType<SchModel>): this;
+    /**
+     * <em>Experimental:</em> Adds input fields for properties via {addFieldInputFromSchema}.
+     *
+     * @experimental
+     *
+     * @param {FieldsFromSchemaOptsType<SchModel>} opts - Additional options.
+     * @param {...Property[]} properties - Properties to add fields for. If non provided, all non-array properties from schema will be added.
+     *
+     * @return {this} - The current instance of the builder.
+     */
+    withAdd<PropertyKey extends Extract<keyof Model, keyof SchModel>>(opts: FieldsFromSchemaOptsType<SchModel>, ...properties: PropertyKey[]): this;
+    /**
+     * <em>Experimental:</em> Adds fields for properties via {addFieldInputFromSchema}.
+     *
+     * @experimental
+     *
+     * @param {...Property[]} properties - Properties to add fields for. If non provided, all non-array properties from schema will be added.
+     *
+     * @return {this} - The current instance of the builder.
+     */
+    withAdd<PropertyKey extends Extract<keyof Model, keyof SchModel>>(...properties: PropertyKey[]): this;
+    private addFields;
+    /**
+     * <em>Experimental:</em> Adds a single input field via {addFieldInputFromSchema} where property schema is manually provided.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to add the field for.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     * @param {FieldInputFromSchemaOptsType<Model>} opts - Additional options.
+     *
+     * @return {FieldInputDescriptor<Model, NonNullable<Model[Property]>, Model[Property], Parent>} The added field descriptor.
+     */
+    addFromSchema<Property extends keyof Model>(property: Property, schemaProperty: SchemaProperty, opts?: FieldInputFromSchemaOptsType<Model>): FieldInputDescriptor<Model, NonNullable<Model[Property]>, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds an enum lookup field via {addFieldEnumLookupFromSchema}.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to add the enum lookup field for.
+     * @param {SchemaEnum<Enum> | EnumDescriptor<Enum>} [enumOpt] - The enum schema or the enum model descriptor. If non provided, builder opts will be checked.
+     *
+     * @returns {FieldLookupEnumDescriptor<Enum, Model, Parent>} - The added field descriptor.
+     *
+     * @throws {CommonsInternalError} - If no enum metadata is found for the property either from parameter or from builder's opts.
+     */
+    addEnum<Property extends Extract<keyof Model, keyof SchModel>, Enum>(property: Property, enumOpt?: SchemaEnum<Enum> | EnumDescriptor<Enum>): FieldLookupEnumDescriptor<Enum, Model, Parent>;
+    /**
+     * <em>Experimental:</em> Adds an enum lookup field via {addFieldEnumLookupFromSchema} where property schema is manually provided.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to add the enum lookup field for.
+     * @param {SchemaEnum<Enum> | EnumDescriptor<Enum>} [enumOpt] - The enum schema or the enum model descriptor. If non provided, builder opts will be checked.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @returns {FieldLookupEnumDescriptor<Enum, Model, Parent>} - The added field descriptor.
+     *
+     * @throws {CommonsInternalError} - If no enum metadata is found for the property either from parameter or from builder's opts.
+     */
+    addEnumFromSchema<Property extends keyof Model, Enum>(property: Property, enumOpt: SchemaEnum<Enum> | EnumDescriptor<Enum> | undefined, schemaProperty: SchemaProperty): FieldLookupEnumDescriptor<Enum, Model, Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field.
+     * {EditorDescriptorInt.addFieldLookup} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     *
+     * @return The created lookup field.
+     */
+    addLookup<Property extends Extract<keyof Model, keyof SchModel>, LookupModel = NonNullable<Model[Property]>, FieldValue = Model[Property]>(property: Property): FieldLookupDescriptor<LookupModel, Model, undefined, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field where property schema is manually provided.
+     * {EditorDescriptorInt.addFieldLookup} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @return The created lookup field.
+     */
+    addLookupFromSchema<Property extends keyof Model, LookupModel = NonNullable<Model[Property]>, FieldValue = Model[Property]>(property: Property, schemaProperty: SchemaProperty): FieldLookupDescriptor<NonNullable<Model[Property]>, Model, undefined, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field.
+     * {EditorDescriptorInt.addFieldLookupWithOptionsValueProperty} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {TypeDescriptor<LookupModel>} type - Type of lookup model.
+     * @param {LookupValueProperty} lookupOptionsValueProperty - Value property from lookup model.
+     *
+     * @return The created lookup field.
+     */
+    addLookupWithOptionsValueProperty<Property extends Extract<keyof Model, keyof SchModel>, LookupModel, LookupValueProperty extends KeyofAndOfType<LookupModel, Model[Property]>, FieldValue = Model[Property]>(property: Property, type: TypeDescriptor<LookupModel>, lookupOptionsValueProperty: LookupValueProperty): FieldLookupDescriptor<LookupModel, Model, undefined, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field where property schema is manually provided.
+     * {EditorDescriptorInt.addFieldLookupWithOptionsValueProperty} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {TypeDescriptor<LookupModel>} type - Type of lookup model.
+     * @param {LookupValueProperty} lookupOptionsValueProperty - Value property from lookup model.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @return The created lookup field.
+     */
+    addLookupWithOptionsValuePropertyFromSchema<Property extends keyof Model, LookupModel, LookupValueProperty extends KeyofAndOfType<LookupModel, Model[Property]>, FieldValue = Model[Property]>(property: Property, type: TypeDescriptor<LookupModel>, lookupOptionsValueProperty: LookupValueProperty, schemaProperty: SchemaProperty): FieldLookupDescriptor<LookupModel, Model, undefined, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field.
+     * {EditorDescriptorInt.addFieldLookupWithProvider} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {FieldLookupProviderType<LookupModel, Service>} provider - Lookup provider.
+     *
+     * @return The created lookup field.
+     */
+    addLookupWithProvider<Property extends Extract<keyof Model, keyof SchModel>, Service, LookupModel = NonNullable<Model[Property]>, FieldValue = Model[Property]>(property: Property, provider: FieldLookupProviderType<LookupModel, Service>): FieldLookupDescriptor<LookupModel, Model, Service, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field where property schema is manually provided.
+     * {EditorDescriptorInt.addFieldLookupWithProvider} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {FieldLookupProviderType<LookupModel, Service>} provider - Lookup provider.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @return The created lookup field.
+     */
+    addLookupWithProviderFromSchema<Property extends keyof Model, Service, LookupModel = NonNullable<Model[Property]>, FieldValue = Model[Property]>(property: Property, provider: FieldLookupProviderType<LookupModel, Service>, schemaProperty: SchemaProperty): FieldLookupDescriptor<LookupModel, Model, Service, Model[Property], Parent>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field.
+     * {EditorDescriptorInt.addFieldLookupWithProviderAndOptionsValueProperty} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {FieldLookupProviderType<LookupModel, Service>} provider - Lookup provider.
+     * @param {TypeDescriptor<LookupModel>} type - Type of lookup model.
+     * @param {LookupValueProperty} lookupOptionsValueProperty - Value property from lookup model.
+     *
+     * @return The created lookup field.
+     */
+    addLookupWithProviderAndOptionsValueProperty<Property extends Extract<keyof Model, keyof SchModel>, Service, LookupModel, LookupValueProperty extends KeyofAndOfType<LookupModel, Model[Property]>, FieldValue = Model[Property]>(property: Property, provider: FieldLookupProviderType<LookupModel, Service>, type: TypeDescriptor<LookupModel>, lookupOptionsValueProperty: LookupValueProperty): FieldLookupDescriptor<LookupModel, Model, Service, FieldValue>;
+    /**
+     * <em>Experimental:</em> Adds a lookup field where property schema is manually provided.
+     * {EditorDescriptorInt.addFieldLookupWithProviderAndOptionsValueProperty} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the lookup field for.
+     * @param {FieldLookupProviderType<LookupModel, Service>} provider - Lookup provider.
+     * @param {TypeDescriptor<LookupModel>} type - Type of lookup model.
+     * @param {LookupValueProperty} lookupOptionsValueProperty - Value property from lookup model.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @return The created lookup field.
+     */
+    addLookupWithProviderAndOptionsValuePropertyFromSchema<Property extends keyof Model, Service, LookupModel, LookupValueProperty extends KeyofAndOfType<LookupModel, Model[Property]>, FieldValue = Model[Property]>(property: Property, provider: FieldLookupProviderType<LookupModel, Service>, type: TypeDescriptor<LookupModel>, lookupOptionsValueProperty: LookupValueProperty, schemaProperty: SchemaProperty): FieldLookupDescriptor<LookupModel, Model, Service, FieldValue>;
+    /**
+     * <em>Experimental:</em> Adds a one-to-many editor field.
+     * {EditorDescriptorInt.addFieldManyEditor} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the many editor field for.
+     * @param {TableviewDescriptorInst<FieldModel, any, any, Model>} tableviewDescriptor - Tableview descriptor.
+     *
+     * @return The created one-to-many editor field.
+     */
+    addManyEditor<Property extends Extract<keyof Model, keyof SchModel>, FieldModel = ArrayItemType<Model[Property]>, FieldValue = Model[Property]>(property: Property, tableviewDescriptor: TableviewDescriptorInst<FieldModel, any, any, Model>): FieldManyEditorDescriptor<FieldModel, Model, FieldValue>;
+    /**
+     * <em>Experimental:</em> Adds an one-to-many editor field where property schema is manually provided.
+     * {EditorDescriptorInt.addFieldManyEditor} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the many editor field for.
+     * @param {TableviewDescriptorInst<FieldModel, any, any, Model>} tableviewDescriptor - Tableview descriptor.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @return The created one-to-many editor field.
+     */
+    addManyEditorFromSchema<Property extends keyof Model, FieldModel = ArrayItemType<Model[Property]>, FieldValue = Model[Property]>(property: Property, tableviewDescriptor: TableviewDescriptorInst<FieldModel, any, any, Model>, schemaProperty: SchemaProperty): FieldManyEditorDescriptor<FieldModel, Model, FieldValue>;
+    /**
+     * <em>Experimental:</em> Adds a many-to-many editor field.
+     * {EditorDescriptorInt.addFieldManyToManyEditor} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the many editor field for.
+     * @param {TableDescriptorInst<FieldModel>} mainTableDescriptor - Main table descriptor.
+     * @param {TableDescriptorInst<FieldModel>} lookupTableDescriptor - Lookup table descriptor.
+     * @param {ITableDataProvider<FieldModel, ServiceType>} lookupDataProvider - Lookup data provider.
+     *
+     * @return The created many-to-many editor field.
+     */
+    addManyToManyEditor<Property extends Extract<keyof Model, keyof SchModel>, ServiceType, FieldModel = ArrayItemType<Model[Property]>, FieldValue = Model[Property]>(property: Property, mainTableDescriptor: TableDescriptorInst<FieldModel>, lookupTableDescriptor: TableDescriptorInst<FieldModel>, lookupDataProvider: ITableDataProvider<FieldModel, ServiceType>): FieldManyToManyEditorDescriptor<FieldModel, Model, ServiceType, FieldValue>;
+    /**
+     * <em>Experimental:</em> Adds a many-to-many editor field where property schema is manually provided.
+     * {EditorDescriptorInt.addFieldManyToManyEditor} is used to create field and ${setFieldBasicOptionsFromSchema} to add basic field's options from schema.
+     *
+     * @experimental
+     *
+     * @param {Property} property - The property to create the many editor field for.
+     * @param {TableDescriptorInst<FieldModel>} mainTableDescriptor - Main table descriptor.
+     * @param {TableDescriptorInst<FieldModel>} lookupTableDescriptor - Lookup table descriptor.
+     * @param {ITableDataProvider<FieldModel, ServiceType>} lookupDataProvider - Lookup data provider.
+     * @param {SchemaProperty} schemaProperty - Manually provided schema property.
+     *
+     * @return The created many-to-many editor field.
+     */
+    addManyToManyEditorFromSchema<Property extends keyof Model, ServiceType, FieldModel = ArrayItemType<Model[Property]>, FieldValue = Model[Property]>(property: Property, mainTableDescriptor: TableDescriptorInst<FieldModel>, lookupTableDescriptor: TableDescriptorInst<FieldModel>, lookupDataProvider: ITableDataProvider<FieldModel, ServiceType>, schemaProperty: SchemaProperty): FieldManyToManyEditorDescriptor<FieldModel, Model, ServiceType, FieldValue>;
+}
+/**
+ * <em>Experimental:</em> Creates builder for adding fields to descriptor based on provided model schema.
+ *
+ * @experimental
+ *
+ * @param {TableviewDescriptorInst<Model, any, any, Parent> | EditorDescriptorInst<Model>} descriptor - Descriptor to add fields to.
+ * @param {SchemaModel<SchModel>} schema - The schema with metadata about properties for fields.
+ * @param {FieldsFromSchemaOptsType<SchModel>} [opts] - Additional options.
+ *
+ * @return {SchemaFieldsBuilder<Model, Parent, SchModel>} - The SchemaFieldsBuilder object containing the extracted fields.
+ */
+export declare function fieldsFromSchema<Model, Parent = unknown, SchModel = Model>(descriptor: TableviewDescriptorInst<Model, any, any, Parent> | EditorDescriptorInst<Model>, schema: SchemaModel<SchModel>, opts?: FieldsFromSchemaOptsType<SchModel>): SchemaFieldsBuilder<Model, Parent, SchModel>;
+/**
+ * <em>Experimental:</em> Adds a field input to editor descriptor based on the given schema property and options.
+ *
+ * @experimental
+ *
+ * @param {TableviewDescriptorInst | EditorDescriptorInst} descriptor - Descriptor to add field to.
+ * @param {keyof Model} property - The property of the model.
+ * @param {SchemaProperty} propertySchema - The property's schema for the field.
+ * @param {FieldInputFromSchemaOptsType<Model>} [opts] - Additional options.
+ *
+ * @return {FieldInputDescriptor<Model, NonNullable<Model[Property]>, Model[Property], Parent>} - The generated field input descriptor.
+ */
+export declare function addFieldInputFromSchema<Property extends keyof Model, Model, Parent = unknown>(descriptor: TableviewDescriptorInst<Model, any, any, Parent> | EditorDescriptorInst<Model>, property: Property, propertySchema: SchemaProperty, opts?: FieldInputFromSchemaOptsType<Model>): FieldInputDescriptor<Model, NonNullable<Model[Property]>, Model[Property], Parent>;
+/**
+ * <em>Experimental:</em> Adds a field enum lookup to editor descriptor based on the given schema property and options.
+ *
+ * @experimental
+ *
+ * @param {TableviewDescriptorInst<Model, any, any, Parent> | EditorDescriptorInst<Model>} descriptor - Descriptor to add field to.
+ * @param {keyof Model} property - The property of the model.
+ * @param {SchemaEnum<Enum> | EnumDescriptor<Enum>} enumOpt - The enum schema or enum model descriptor.
+ * @param {SchemaProperty} propertySchema - The property's schema for the field.
+ *
+ * @returns {FieldLookupEnum<Enum>} - The field with enumeration values.
+ */
+export declare function addFieldEnumLookupFromSchema<Model, Parent = unknown, Enum = any>(descriptor: TableviewDescriptorInst<Model, any, any, Parent> | EditorDescriptorInst<Model>, property: keyof Model, enumOpt: SchemaEnum<Enum> | EnumDescriptor<Enum>, propertySchema: SchemaProperty): FieldLookupEnumDescriptor<Enum, Model, Parent>;
+/**
+ * <em>Experimental:</em> Sets basic options for a field based on a given property schema.
+ *
+ * @param {AFieldDescriptor<FieldModel, EditorModel, FieldValue, ParentEditorModel>} field - The field to set options for.
+ * @param {SchemaProperty} propertySchema - The property schema to base the options on.
+ */
+export declare function setFieldBasicOptionsFromSchema<FieldModel = any, EditorModel = any, FieldValue = FieldModel, ParentEditorModel = undefined>(field: AFieldDescriptor<FieldModel, EditorModel, FieldValue, ParentEditorModel>, propertySchema: SchemaProperty): void;
+export {};

package/tableview/schema/internal/common-from-schema.d.ts

@@ -0,0 +1,11 @@
+export type FromSchemaCurrencyOptsType<Model> = string | {
+    currencyProperty?: keyof Model;
+    currency?: string;
+    currencyDisplay?: 'symbol' | 'code' | 'name';
+};
+export declare function fromSchemaCurrencyOptsToCurrency<Model>(opts: FromSchemaCurrencyOptsType<Model>): {
+    currency: string | undefined;
+    currencyDisplay: "symbol" | "name" | "code" | undefined;
+    currencyProperty: keyof Model | undefined;
+};
+export declare function fromSchemaFilterNonArrayProperties<Model>(propertySchemas: Record<keyof Model, any>): (keyof Model)[];

package/version-info.json

@@ -1,11 +1,11 @@
 {
     "name": "@mediusinc/mng-commons-data-api",
-    "version": "5.2.0-rc.0",
-    "tag": "v5.1.0-rc.1",
-    "distance": 11,
-    "hash": "1fe015b8",
+    "version": "5.2.0-rc.2",
+    "tag": "v5.2.0-rc.2",
+    "distance": 0,
+    "hash": "41eee2dc",
     "dirty": true,
-    "semver": "5.1.0-rc.1+11.g1fe015b8.dirty",
+    "semver": "5.2.0-rc.2+0.g41eee2dc.dirty",
     "buildTimestamp": null,
-    "raw": "v5.1.0-rc.1-11-1fe015b8-dirty"
+    "raw": "v5.2.0-rc.2-41eee2dc-dirty"
 }

package/openapi/custom/schema.mustache

@@ -1,18 +0,0 @@
-export interface Schema {
-    name: string;
-    properties?: Record<string, SchemaProperty>;
-}
-
-export interface SchemaProperty {
-    type: string;
-    isReadOnly?: boolean;
-    required?: boolean;
-    isNullable?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    minimum?: number;
-    maximum?: number;
-    exclusiveMinimum?: boolean;
-    exclusiveMaximum?: boolean;
-    pattern?: string;
-}